Add enum value descriptions to generated docs

[stephentoub]

The runtime schemas are adding per-enum-value descriptions, and the SDK generators should preserve that information in the generated public APIs instead of falling back to generic value comments.

This updates the shared codegen utilities to read x-enumDescriptions and threads that metadata through the C#, Go, Python, Rust, and TypeScript generators. C# enum-like value members now use XML docs from the schema when available and retain the existing boilerplate fallback when not. Other SDKs emit the closest language-appropriate doc/comment surface for enum values.

A small schema-sharing adjustment treats x-enumDescriptions as documentation-only metadata, matching existing handling for schema descriptions, so shared definitions with documentation-only differences do not produce duplicate generated types.

Validation:

• npm test -- --run test\shared-codegen.test.ts test\python-codegen.test.ts test\typescript-codegen.test.ts
• npx prettier --check test\python-codegen.test.ts test\shared-codegen.test.ts test\typescript-codegen.test.ts
• npm run typecheck
• Ran all generators against the runtime PR schemas to confirm enum-value docs are consumed across SDKs.

[Copilot]

Pull request overview

This PR updates the SDK code generators to preserve per-enum-value documentation coming from runtime schemas via the x-enumDescriptions extension, so generated public APIs can surface value-level docs instead of generic boilerplate.

Changes:

• Added a shared getEnumValueDescriptions() helper and treated x-enumDescriptions as documentation-only metadata for schema sharing/deduping.
• Threaded enum-value descriptions through the C#, Go, Python, Rust, and TypeScript generators to emit value-level docs/comments where supported.
• Adjusted generators to be safely imported by tests (guard CLI entrypoints) and added unit tests covering enum-value doc emission and schema sharing behavior.

Show a summary per file

File	Description
scripts/codegen/utils.ts	Adds getEnumValueDescriptions() and excludes x-enumDescriptions from definition equality checks to avoid doc-only duplicate types.
scripts/codegen/typescript.ts	Emits per-enum-value JSDoc via tsType override during schema normalization; adds import-safe CLI entrypoint guard.
scripts/codegen/rust.ts	Threads enum-value descriptions into Rust string-enum variant docs; adds import-safe CLI entrypoint guard and exports for tests.
scripts/codegen/python.ts	Emits per-enum-value comments for Python enums; adds import-safe CLI entrypoint guard.
scripts/codegen/go.ts	Emits per-enum-value comments for Go enum constants; adds import-safe CLI entrypoint guard and exports for tests.
scripts/codegen/csharp.ts	Uses schema-provided value docs for enum-like members while retaining fallback XML docs; adds import-safe CLI entrypoint guard and exports for tests.
nodejs/test/typescript-codegen.test.ts	Adds coverage ensuring enum-value descriptions are emitted into TypeScript output.
nodejs/test/shared-codegen.test.ts	Adds coverage for extracting descriptions and for shared-definition deduping behavior with x-enumDescriptions.
nodejs/test/python-codegen.test.ts	Adds cross-generator assertions (Python/C#/Go/Rust) for enum-value description emission and fallback behavior.

Copilot's findings

• Files reviewed: 9/9 changed files
• Comments generated: 0

[github-actions]

Cross-SDK Consistency Review ✅

This PR updates all five SDK code generators simultaneously — TypeScript, Python, Go, C#, and Rust — with the same x-enumDescriptions feature. No consistency gaps were found.

What was checked:

• All five language generators are updated in this PR
• A shared getEnumValueDescriptions utility in utils.ts ensures consistent schema parsing across all generators
• Each generator uses idiomatically appropriate doc comment syntax:
  • TypeScript: inline JSDoc /** Use alpha mode. */ on union members
  • C#: XML doc <summary> on struct members, with fallback to Gets the <c>value</c> value.
  • Go: // comment preceding each const in the const (...) block
  • Python: # comment preceding each enum member
  • Rust: /// doc comment preceding each enum variant
• normalizeDefinitionForComparison correctly treats x-enumDescriptions as documentation-only metadata (consistent with how description is already handled)
• Tests cover all five generators
• pushRustDoc safely handles undefined (no-ops when no description)

The entry-point guard pattern (fileURLToPath / process.argv[1] check) applied to csharp, go, rust, and typescript generators is consistent and correctly enables safe importing for tests.

Generated by SDK Consistency Review Agent for issue #1336 · ● 455.4K · ◷