Support serialization of object examples on unions

[RichardCPoint]

This PR fixes this issue:

• [OpenAPI3] @example decorator not supported for unions #4869

Currently, the @typespec/openapi3 emitter supports @examples for models, but outputs incorrect examples for unions.

For example (playground link):

@example(#{ a: 1 })
union U {
  number: {
    a: integer,
  },
  text: {
    s: string,
  },
}

should output with { a: 1 } as the example, but instead it is {}.

The issue manifests in the serializeValueAsJson function in packages/compiler/src/lib/examples.ts, and occurs because the resolveUnions function in the same file fails to detect the appropriate union variant.

With this PR, the example is emitted correctly. I've added a unit test to confirm this.

[RichardCPoint]

@RichardCPoint please read the following Contributor License Agreement(CLA). If you agree with the CLA, please reply with the following information.

@microsoft-github-policy-service agree [company="{your company}"]

Options:

• (default - no company specified) I have sole ownership of intellectual property rights to my Submissions and I am not making Submissions in the course of work for my employer.

@microsoft-github-policy-service agree

• (when company given) I am making Submissions in the course of work for my employer (or my employer has intellectual property rights in my Submissions by contract or applicable law). I have permission from my employer to make Submissions and enter into this Agreement on behalf of my employer. By signing below, the defined term “You” includes me and my employer.

@microsoft-github-policy-service agree company="Microsoft"

Contributor License Agreement

@microsoft-github-policy-service agree

[chrisradek]

@RichardCPoint Thank you opening this pull request!

This fix looks great! Do you mind running npx chronus add from the repo root to create a changelog entry for this change? I'm also happy to run and push to your branch to add the changelog.

[RichardCPoint]

Do you mind running npx chronus add from the repo root to create a changelog entry for this change?

Thanks for the review! I've run the command above and committed the result – please let me know if there's anything else I should do.

[microsoft-github-policy-service]

Hi @RichardCPoint. Your PR has had no update for 30 days and it is marked as a stale PR. If it is not updated within 30 days, the PR will automatically be closed. If you want to refresh the PR, please remove the stale label.

[RichardCPoint]

@chrisradek, thanks for taking a look at this PR!

Are there any further changes that you'd like to see, or is there any other way that I can help get this expedited?

[chrisradek]

@RichardCPoint Thanks for the ping! Sorry for the radio silence - many of us just came back this week from holidays!

I'm just running the CI now - assuming it still passes we'll get this merged right away!

[RichardCPoint]

@chrisradek, awesome, thank you so much!