Add summary and kind fields to @tagMetadata decorator

[Copilot]

@tagMetadata lacked summary and kind fields introduced in OpenAPI 3.2 tag objects. These fields needed version-aware handling since they don't exist in OpenAPI 3.0/3.1.

Changes

• TagMetadata model (packages/openapi/lib/decorators.tsp, generated-defs): Added summary and kind optional fields.

• Emitter (packages/openapi3/src/openapi.ts): Version-aware emission in resolveDocumentTags:

  • OpenAPI 3.2 → native summary / kind fields
  • OpenAPI 3.0/3.1 → x-oai-summary / x-oai-kind extensions

• Converter (transform-tags.ts, generate-tags.ts, interfaces.ts): Bidirectional support — reads both native 3.2 fields and x-oai- extensions from 3.0/3.1 documents, and generates the corresponding TypeSpec decorator properties.

Usage

@service
@tagMetadata("foo", #{ summary: "all operations that allow doing Foo", kind: "FooGroup" })
namespace PetStore {}

OpenAPI 3.2 output:

tags:
  - name: foo
    summary: "all operations that allow doing Foo"
    kind: FooGroup

OpenAPI 3.0/3.1 output:

tags:
  - name: foo
    x-oai-summary: "all operations that allow doing Foo"
    x-oai-kind: FooGroup

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@typespec/openapi@10769

npm i https://pkg.pr.new/@typespec/openapi3@10769

commit: 2e7c91e