Add diagnostic metadata to @experimental

[JoshLove-msft]

Summary

• add optional diagnosticId and dependsOn metadata to @experimental
• expose full lifecycle details through the HTTP client typekit while preserving the existing lifecycle API
• document that dependency graduation does not automatically remove experimental status

@experimental(#{ diagnosticId: "C", dependsOn: #["A", "B"] })
op bar(): void;

Validation

• @typespec/http-client build and full test suite
• affected-package lint and formatting checks

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/microsoft/typespec/@typespec/http-client@11684

commit: d301a81

[github-actions]

All changed packages have been documented.

• ✅ @typespec/http-client

Show changes

@typespec/http-client - feature ✏️

Add diagnostic and dependency metadata to @experimental.,> ,> typespec,> @experimental(#{ diagnosticId: "C", dependsOn: #["A", "B"] }),> op bar(): void;,>

[azure-sdk-automation]

You can try these changes here

🛝 Playground	🌐 Website	🛝 VSCode Extension