Unable to set `x-displayName` via preprocessors/decorators

[mstade]

Describe the bug

It doesn't seem possible to set x-displayName fully via preprocessors/decorators. The title as rendered on the page is correct, however the title in the menu still uses what's inferred from the tag name.

To Reproduce
Steps to reproduce the behavior:

1. Clone this repo: https://github.com/mstade/apidocs-starter
2. Check out the repro branch:

   git checkout bug/x-displayName-not-settable-via-plugin

3. Install dependencies:

   npm install

4. Run the preview:

   npm run dev

5. Notice how the tag x-displayName and description is overridden on the page, but the menu still displays the inferred tag name:
   

Expected behavior

I expect the menu to pick up the value of x-displayName as it was defined by the preprocessor/decorator.

OpenAPI description

https://github.com/mstade/apidocs-starter/blob/bug/x-displayName-not-settable-via-plugin/apis/%40v1_0/openapi.yaml
https://github.com/mstade/apidocs-starter/blob/bug/x-displayName-not-settable-via-plugin/apis/%40v1_1/openapi.yaml

Redocly Version(s)

❯ npm pkg get dependencies.@redocly/cli
"^1.30.0"

Node.js Version(s)

❯ node --version                       
v20.17.0

OS, environment

❯ system_profiler SPSoftwareDataType
Software:

    System Software Overview:

      System Version: macOS 14.6.1 (23G93)
      Kernel Version: Darwin 23.6.0

[mstade]

While not entirely related to the bug per-se, I'm also wondering if it's possible to somehow signal to Redocly when running the preview command that files have changed and that things need to be re-rendered. Currently I have to cancel the process and start it again. This is true also for the built-in decorators like info-override and info-description-override.

Happy to break this question out into a separate ticket if that's prefferrable.

[mstade]

This is all sorts of wrong – turns out I was mistaken about how decorators/preprocessors work, they can't run async at all. Solution: do everything synchronously.

My apologies for the noise, will close this.