{"full_name":"microsoft/typespec","owner":"microsoft","name":"typespec","shard":"1","url":"https://github.com/microsoft/typespec","description":null,"homepage":"https://typespec.io/","topics":["openapi3","json-schema","protobuf","typespec"],"tag_pages":["json-schema","openapi3","protobuf"],"language":"Java","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/6154722?v=4","created_at":"2021-06-30T23:29:49Z","pushed_at":"2026-11-13T22:59:49Z","metrics":{"stars":5947,"forks":424,"watchers":44,"issues":4959,"prs":7395,"releases":620,"issues_open":991,"issues_closed":3968,"prs_open":73,"prs_closed":1329,"prs_merged":5993,"discussions":211},"growth":{"day":{"stars":-1,"forks":1,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[5942,5946,5946,5947,5948,5948,5947],"forks":[421,422,422,421,422,423,424],"watchers":[null,44,44,44,44,44,44],"issues_open":[null,994,990,990,991,991,991],"prs_open":[null,65,68,71,72,73,73]},"boards":{},"same_owner":[{"full_name":"microsoft/markitdown","name":"markitdown","shard":"1","boards":{"daily":151,"weekly":176,"monthly":103,"total":36}},{"full_name":"microsoft/vscode","name":"vscode","shard":"1","boards":{"daily_watchers":21,"total":37}},{"full_name":"microsoft/PowerToys","name":"PowerToys","shard":"1","boards":{"daily_watchers":111,"total":81}},{"full_name":"microsoft/generative-ai-for-beginners","name":"generative-ai-for-beginners","shard":"1","boards":{"daily_forks":40,"total":98}},{"full_name":"microsoft/TypeScript","name":"TypeScript","shard":"1","boards":{"daily_watchers":120,"total":120}},{"full_name":"microsoft/terminal","name":"terminal","shard":"1","boards":{"total":133}},{"full_name":"microsoft/playwright","name":"playwright","shard":"1","boards":{"total":143}},{"full_name":"microsoft/Web-Dev-For-Beginners","name":"Web-Dev-For-Beginners","shard":"1","boards":{"total":155}},{"full_name":"microsoft/ML-For-Beginners","name":"ML-For-Beginners","shard":"1","boards":{"total":173}},{"full_name":"microsoft/AI-For-Beginners","name":"AI-For-Beginners","shard":"1","boards":{}},{"full_name":"microsoft/AirSim","name":"AirSim","shard":"1","boards":{}},{"full_name":"microsoft/BitNet","name":"BitNet","shard":"1","boards":{}},{"full_name":"microsoft/Bringing-Old-Photos-Back-to-Life","name":"Bringing-Old-Photos-Back-to-Life","shard":"1","boards":{}},{"full_name":"microsoft/CNTK","name":"CNTK","shard":"1","boards":{}},{"full_name":"microsoft/Data-Science-For-Beginners","name":"Data-Science-For-Beginners","shard":"1","boards":{}},{"full_name":"microsoft/FluidFramework","name":"FluidFramework","shard":"1","boards":{}},{"full_name":"microsoft/IoT-For-Beginners","name":"IoT-For-Beginners","shard":"1","boards":{}},{"full_name":"microsoft/MMdnn","name":"MMdnn","shard":"1","boards":{}},{"full_name":"microsoft/Ontology-Playground","name":"Ontology-Playground","shard":"1","boards":{}},{"full_name":"microsoft/Procexp-Mac","name":"Procexp-Mac","shard":"1","boards":{"daily_rate":96,"weekly_rate":32,"monthly_rate":87}}],"issues":[{"number":2463,"title":"POC TypeSpec to AsyncAPI","comments":33,"created_at":"2023-09-21T19:35:30Z"},{"number":12454,"title":"[http-client-csharp] Replace general Roslyn simplification with bounded provider-driven reduction","comments":20,"created_at":"2026-10-31T11:17:46Z"},{"number":4903,"title":".NET Client Patterns: Simple service description should generate client following unbranded .NET client patterns","comments":20,"created_at":"2024-10-29T18:28:36Z"},{"number":826,"title":"Invalid OA3 for unions","comments":19,"created_at":"2022-08-08T23:20:32Z"},{"number":2819,"title":"Have an explicit way of defining the api version parameter","comments":17,"created_at":"2024-01-24T19:13:03Z"},{"number":3314,"title":"Type of model property/enum member when it is defined as constant number","comments":14,"created_at":"2024-05-10T09:21:50Z"},{"number":2459,"title":"OpenAPI and JSON Schema don't support tuple declarations","comments":14,"created_at":"2023-09-21T15:35:25Z"},{"number":5419,"title":"[Bug]: When main.tsp only contain minimal import, emitter fails","comments":11,"created_at":"2024-12-20T04:28:34Z"}],"discussions":[{"number":12553,"title":"Should linter diagnostics for library-defined query parameters appear at their usage site?","comments":0,"category":"Q&A","created_at":"2026-11-12T02:41:11Z"},{"number":12451,"title":"\"Model name must be alphanumeric\" with namespaced models","comments":1,"category":"OpenAPI3","created_at":"2026-10-31T00:25:14Z"},{"number":11868,"title":"[@typespec/http-server-csharp] 1.15.0 : generated Program.cs is a MVC one not a WebAPI?","comments":2,"category":"General","created_at":"2026-09-06T03:00:06Z"},{"number":11634,"title":"Able to perform routine task in decorator?","comments":1,"category":"Q&A","created_at":"2026-08-12T10:39:37Z"},{"number":11037,"title":"Help with @friendlyName","comments":1,"category":"Q&A","created_at":"2026-06-22T17:25:49Z"},{"number":11034,"title":"FilterVisibility","comments":2,"category":"Q&A","created_at":"2026-06-22T07:59:00Z"},{"number":10304,"title":"CodeGen based on OpenApi/Swagger Spec","comments":1,"category":"Q&A","created_at":"2026-04-08T12:25:33Z"},{"number":9866,"title":"OpenAPI spec generated for union type with discriminator, generate default value instead of enum to allow using openapi-generator-maven-plugin","comments":2,"category":"OpenAPI3","created_at":"2026-03-02T15:37:57Z"}],"latest_release":{"name":"typespec-stable@1.18.0","tag":"typespec-stable@1.18.0","published_at":"2026-11-11T03:39:13Z","body":"## @typespec/compiler\n\n\n### Deprecations\n\n- [#11980](https://github.com/microsoft/typespec/pull/11980) `getDiscriminatedUnionFromInheritance(type, discriminator)` is deprecated. Pass the program as the first argument so enum member discriminator values use their `@encodedName`.\n  \n  ```ts\n  const [union, diagnostics] = getDiscriminatedUnionFromInheritance(program, type, discriminator);\n  ```\n\n### Features\n\n- [#12095](https://github.com/microsoft/typespec/pull/12095) Inspect inline suppressions and local linter disables without compiling a project. Inline results include declaration context and source locations; config results include rule-key locations and diagnostics. For compiled programs, inspect whether each project suppression matched a diagnostic using `getSuppressions`.\n  \n  ```ts\n  import { collectLinterDisables } from \"@typespec/compiler\";\n  import { collectSuppressions, getSuppressions, parse } from \"@typespec/compiler/ast\";\n  \n  const script = parse(source);\n  const suppressions = collectSuppressions(script);\n  const [disables, diagnostics] = collectLinterDisables(configText);\n  const observedSuppressions = getSuppressions(program); // Includes a `used` flag.\n  ```\n  \n  Usage is a snapshot of diagnostics matched so far in that compilation, including rejected attempts to suppress errors. An unmatched suppression may be needed under other settings: its rule could be disabled, its diagnostic source unavailable, its emitter skipped, or compilation could stop before the relevant stage runs.\n- [#12195](https://github.com/microsoft/typespec/pull/12195) Override linter configuration for a single compilation without editing `tspconfig.yaml`. Select rulesets with `--linter-ruleset`, enable, disable, or configure individual rules with `--linter-rule`, and skip linting with `--no-linter`.\n  \n  ```bash\n  tsp compile . --linter-ruleset @typespec/http/all\n  tsp compile . --linter-rule @typespec/compiler/unused-using=true\n  tsp compile . --no-linter\n  ```\n- [#12166](https://github.com/microsoft/typespec/pull/12166) Expose `skipTrivia` through `@typespec/compiler/ast` so codefixes can reuse the compiler whitespace and comment handling.\n  \n  ```ts\n  import { skipTrivia } from \"@typespec/compiler/ast\";\n  \n  const cursor = skipTrivia(sourceText, property.end, property.parent?.end);\n  ```\n- [#12461](https://github.com/microsoft/typespec/pull/12461) Add `typeref(Type)` for referencing types from metadata values. Enable the `typeref` compiler feature in the calling project or library's `tspconfig.yaml`. Its result has type `TypeRef<T>`, where `T` is the referenced type. Use `TypeRef` to accept any type reference, or `TypeRef<T>` to constrain its target. JavaScript implementations and generated signatures use `TypeRefValue` from `@typespec/compiler`, whose `target` is the referenced compiler type. Type references are compilation metadata and cannot be represented as JSON values.\n  \n  ```typespec\n  model Item { id: string; }\n  model Registration { name: string; type: TypeRef; }\n  const entry: Registration = #{ name: \"item\", type: typeref(Item) };\n  ```\n- [#12399](https://github.com/microsoft/typespec/pull/12399) [API] Widen `isTemplateDeclaration` and `isTemplateDeclarationOrInstance` to accept any `Type`.\n\n### Bug Fixes\n\n- [#12314](https://github.com/microsoft/typespec/pull/12314) Suppress deprecated type warnings in deprecated operations, including parameter and response types nested in inline models and template arguments.\n- [#12225](https://github.com/microsoft/typespec/pull/12225) Preserve source model and property documentation in generated extern signatures.\n- [#11980](https://github.com/microsoft/typespec/pull/11980) `@encodedName` on an enum member now sets the value the member is serialized as, including when it has an explicit value. Emitters can resolve it with `resolveEncodedEnumMemberValue`. A spec that relied on the encoded name being ignored can now report errors, such as an encoded name equal to another member's value, or a","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}