Emit intrinsic @TypeSpec.example for model properties in autorest (OpenAPI2)

[Copilot]

@example on model properties was being dropped by the autorest (Swagger 2.0) emitter, causing schema-level example metadata loss during conversion. OpenAPI3 already preserved this, so OpenAPI2 behavior was inconsistent.

• Emitter behavior update

  • In typespec-autorest OpenAPI2 emission, property-level intrinsic examples are now applied when present.
  • applyIntrinsicDecorators(...) now reads intrinsic TypeSpec examples and writes example on property schemas.

• Type surface alignment

  • Extended OpenAPI2Schema to include example?: unknown so emitted property examples are modeled in the document types.

• Regression coverage

  • Added a focused model test asserting that @TypeSpec.example(...) on a property emits definitions.<Model>.properties.<prop>.example.

model Test {
  @TypeSpec.example("core.windows.net")
  abcd: string;
}

Expected emitted schema fragment:

"abcd": {
  "type": "string",
  "example": "core.windows.net"
}

[timotheeguerin]

@copilot add changelog

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@azure-tools/typespec-autorest@4393

commit: 5ac0162

[Copilot]

@copilot add changelog

Added the changelog entry in .chronus/changes/fix-autorest-property-example-2026-05-07-15-04-16.md in commit 7142e34.

[timotheeguerin]

@copilot run formatter

[Copilot]

@copilot run formatter

Ran formatter and pushed the formatting update in commit f3d3e2d.

[azure-sdk]

All changed packages have been documented.

• ✅ @azure-tools/typespec-autorest

Show changes

@azure-tools/typespec-autorest - fix ✏️

Emit intrinsic @TypeSpec.example(...) on model properties in the autorest OpenAPI2 emitter so property example values are preserved in generated definitions.

[azure-sdk]

You can try these changes here

🛝 Playground	🌐 Website

[markcowl]

Looks good. Want to see the impact on azure-specs (if any) , so added the label.