[OpenAPI] Lift enum member descriptions in property descriptions

[swallez]

The OpenAPI spec doesn't support adding descriptions to enumeration members. This PR fixes that by having the OpenAPI converter lift enum member descriptions in the descriptions of properties of an enum type.

It also handles aliases, enum arrays and lenient arrays (e.g. Foo | Foo[]).

Rendering in bump.sh

Enumerations with no descriptions are left unchanged

Caveat: for unary values (i.e. not an array or lenient array), bump.sh will still render its list below the descriptions added by this PR. This could be avoided by removing the enumeration values from the OpenAPI spec (and keep them only in the docs), but this would remove some information from that OpenAPI spec.

Example

[Anaethelion]

Is this double line expected?

[swallez]

@lcawl should we go ahead with this update?

[timto-elastic]

If @lcawl is ok with the update, I would love to see this go live so we can have enum descriptions in our API docs.

[lcawl]

I committed two suggested changes to the text (from "Values are" to "Supported values include:") and ran make compiler-wasm-lib locally to see the impact. I haven't checked in the regenerated output since my local tests also affected compiler-rs files that I'm unfamiliar with. If you regenerate the output and are happy with my text changes, it LGTM.

[github-actions]

The backport to 9.0 failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-9.0 9.0
# Navigate to the new working tree
cd .worktrees/backport-9.0
# Create a new branch
git switch --create backport-4313-to-9.0
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 4fb0647c90c2e8aa4979a035a7833170b1035d2f
# Push it to GitHub
git push --set-upstream origin backport-4313-to-9.0
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-9.0

Then, create a pull request where the base branch is 9.0 and the compare/head branch is backport-4313-to-9.0.

[lcawl]

💚 All backports created successfully

Status	Branch	Result
✅	9.0

Questions ?

Please refer to the Backport tool documentation

[lcawl]

💚 All backports created successfully

Status	Branch	Result
✅	8.19

Questions ?

Please refer to the Backport tool documentation

[lcawl]

💚 All backports created successfully

Status	Branch	Result
✅	8.18

Questions ?

Please refer to the Backport tool documentation