From dec504364c90ff0769e2733326681e717c06f589 Mon Sep 17 00:00:00 2001 From: Timothee Guerin Date: Tue, 7 May 2024 17:34:05 -0700 Subject: [PATCH] Bump versions for 0.56.0 release (#3298) --- .../actual-std-lib-2024-3-15-15-53-0.md | 8 - .../actual-std-lib-2024-3-15-15-55-33.md | 8 - .../azhang_fixTestUtil-2024-3-24-13-29-34.md | 6 - .../body-consitency-2024-2-27-18-35-44-1.md | 23 - .../body-consitency-2024-2-27-18-35-44-2.md | 18 - .../body-consitency-2024-2-27-18-35-44.md | 22 - .../body-consitency-2024-3-2-15-21-10.md | 9 - .../body-consitency-2024-3-2-15-21-9.md | 18 - ...it-libraries-emitters-2024-4-2-16-20-50.md | 8 - .../eslint-flat-config-2024-3-5-19-46-26.md | 25 - .../extern-dec-type-2024-3-29-19-9-6.md | 16 - .../feature-numeric-2024-3-4-23-14-45.md | 8 - .../changes/feature-xml-2024-2-20-16-48-57.md | 8 - .../changes/feature-xml-2024-3-8-20-40-16.md | 8 - ...orator-template-decl-2024-3-23-15-44-27.md | 8 - .../changes/fix-blob-2024-3-26-0-22-15.md | 6 - ...ler-crash-alias-union-2024-3-18-2-39-55.md | 8 - ...lude-op-template-args-2024-3-16-17-19-2.md | 7 - ...ix-init-never-ending-2024-3-17-20-24-14.md | 8 - ...-keyword-completions-2024-3-10-22-29-31.md | 8 - ...x-keyword-completions-2024-3-11-0-17-59.md | 8 - ...nish-cloned-unfinished-2024-4-6-20-0-24.md | 8 - .../fix-numeric-exp-2024-3-11-19-8-28.md | 6 - .../fix-numeric-neg-2024-3-11-16-15-51.md | 8 - ...optional-prop-required-2024-4-6-21-39-1.md | 8 - ...arser-test-multi-run-2024-3-15-21-34-43.md | 8 - .../fix-password-flow-2024-3-19-16-22-3.md | 8 - ...-param-mapping-record-2024-3-18-16-17-3.md | 8 - ...ix-spread-assignment-2024-3-12-18-23-17.md | 8 - ...finished-partial-ops-2024-3-24-16-10-25.md | 8 - ...rechable-models-path-2024-3-23-19-55-13.md | 8 - ...rechable-models-path-2024-3-23-19-55-14.md | 8 - ...sioning-sub-namespace-2024-4-2-22-46-51.md | 8 - .../changes/fix-wrong-cp-2024-3-6-0-10-22.md | 6 - .../fixDirectiveParsing-2024-3-16-17-9-37.md | 8 - .chronus/changes/main-2024-3-26-15-49-18.md | 8 - .../pr-performance-2024-3-3-21-39-32.md | 22 - .../recover-bad-op-is-2024-3-23-17-46-20.md | 8 - ...mple-compiler-options-2024-3-5-20-58-20.md | 8 - .../spread-source-2024-3-18-18-19-45.md | 8 - .../spread-source-2024-3-18-18-49-3.md | 8 - ...rade-deps-april-2024-2024-3-13-20-10-53.md | 25 - ...e-node-fetch-builtin-2024-3-26-17-50-57.md | 8 - .../xml-wrong-version-2024-3-15-21-40-57.md | 8 - .github/workflows/consistency.yml | 6 +- packages/bundler/CHANGELOG.md | 7 + packages/bundler/package.json | 2 +- packages/compiler/CHANGELOG.md | 29 + packages/compiler/package.json | 2 +- packages/compiler/templates/scaffolding.json | 8 +- packages/eslint-plugin-typespec/CHANGELOG.md | 7 + packages/eslint-plugin-typespec/package.json | 2 +- packages/html-program-viewer/CHANGELOG.md | 11 + packages/html-program-viewer/package.json | 2 +- packages/http/CHANGELOG.md | 68 ++ packages/http/package.json | 2 +- packages/internal-build-utils/CHANGELOG.md | 7 + packages/internal-build-utils/package.json | 2 +- packages/json-schema/CHANGELOG.md | 7 + packages/json-schema/package.json | 2 +- packages/library-linter/CHANGELOG.md | 7 + packages/library-linter/package.json | 2 +- packages/openapi/CHANGELOG.md | 7 + packages/openapi/package.json | 2 +- packages/openapi3/CHANGELOG.md | 15 + packages/openapi3/package.json | 2 +- packages/playground/CHANGELOG.md | 12 + packages/playground/package.json | 2 +- .../prettier-plugin-typespec/CHANGELOG.md | 7 + .../prettier-plugin-typespec/package.json | 2 +- packages/protobuf/CHANGELOG.md | 7 + packages/protobuf/package.json | 2 +- packages/rest/CHANGELOG.md | 11 + packages/rest/package.json | 2 +- packages/tmlanguage-generator/CHANGELOG.md | 7 + packages/tmlanguage-generator/package.json | 2 +- packages/typespec-vs/CHANGELOG.md | 4 + packages/typespec-vs/package.json | 2 +- packages/typespec-vscode/CHANGELOG.md | 7 + packages/typespec-vscode/package.json | 2 +- packages/versioning/CHANGELOG.md | 11 + packages/versioning/package.json | 2 +- packages/website/playground-versions.json | 1 + .../json-schema/reference/data-types.md | 0 .../json-schema/reference/decorators.md | 0 .../json-schema/reference/emitter.md | 0 .../json-schema/reference/index.mdx | 0 .../reference/js-api/_category_.json | 0 .../js-api/classes/JsonSchemaEmitter.md | 0 .../reference/js-api/functions/$baseUri.md | 0 .../reference/js-api/functions/$contains.md | 0 .../js-api/functions/$contentEncoding.md | 0 .../js-api/functions/$contentMediaType.md | 0 .../js-api/functions/$contentSchema.md | 0 .../reference/js-api/functions/$extension.md | 0 .../reference/js-api/functions/$id.md | 0 .../reference/js-api/functions/$jsonSchema.md | 0 .../js-api/functions/$maxContains.md | 0 .../js-api/functions/$maxProperties.md | 0 .../js-api/functions/$minContains.md | 0 .../js-api/functions/$minProperties.md | 0 .../reference/js-api/functions/$multipleOf.md | 0 .../reference/js-api/functions/$onEmit.md | 0 .../js-api/functions/$prefixItems.md | 0 .../js-api/functions/$uniqueItems.md | 0 .../js-api/functions/$validatesRawJson.md | 0 .../reference/js-api/functions/findBaseUri.md | 0 .../reference/js-api/functions/getBaseUri.md | 0 .../reference/js-api/functions/getContains.md | 0 .../js-api/functions/getContentEncoding.md | 0 .../js-api/functions/getContentMediaType.md | 0 .../js-api/functions/getContentSchema.md | 0 .../js-api/functions/getExtensions.md | 0 .../reference/js-api/functions/getId.md | 0 .../js-api/functions/getJsonSchema.md | 0 .../js-api/functions/getJsonSchemaTypes.md | 0 .../js-api/functions/getMaxContains.md | 0 .../js-api/functions/getMaxProperties.md | 0 .../js-api/functions/getMinContains.md | 0 .../js-api/functions/getMinProperties.md | 0 .../js-api/functions/getMultipleOf.md | 0 .../js-api/functions/getPrefixItems.md | 0 .../js-api/functions/getUniqueItems.md | 0 .../functions/isJsonSchemaDeclaration.md | 0 .../json-schema/reference/js-api/index.md | 0 .../js-api/interfaces/ExtensionRecord.md | 0 .../interfaces/JSONSchemaEmitterOptions.md | 0 .../type-aliases/JsonSchemaDeclaration.md | 0 .../reference/js-api/variables/$lib.md | 0 .../js-api/variables/EmitterOptionsSchema.md | 0 .../reference/js-api/variables/namespace.md | 0 .../openapi3/diagnostics.md | 0 .../openapi3/openapi.md | 22 +- .../openapi3/reference/decorators.md | 0 .../openapi3/reference/emitter.md | 0 .../openapi3/reference/index.mdx | 0 .../openapi3/reference/js-api/_category_.json | 0 .../reference/js-api/functions/$onEmit.md | 0 .../reference/js-api/functions/$oneOf.md | 0 .../reference/js-api/functions/$useRef.md | 0 .../reference/js-api/functions/getOneOf.md | 0 .../reference/js-api/functions/getOpenAPI3.md | 0 .../reference/js-api/functions/getRef.md | 0 .../js-api/functions/resolveOptions.md | 0 .../openapi3/reference/js-api/index.md | 0 .../ResolvedOpenAPI3EmitterOptions.md | 0 .../reference/js-api/variables/$lib.md | 2 - .../reference/js-api/variables/namespace.md | 0 .../{libraries => emitters}/protobuf/guide.md | 0 .../protobuf/reference/data-types.md | 0 .../protobuf/reference/decorators.md | 0 .../protobuf/reference/emitter.md | 0 .../protobuf/reference/index.mdx | 0 .../protobuf/reference/js-api/_category_.json | 0 .../reference/js-api/functions/$externRef.md | 0 .../reference/js-api/functions/$field.md | 0 .../reference/js-api/functions/$message.md | 0 .../reference/js-api/functions/$onEmit.md | 0 .../reference/js-api/functions/$onValidate.md | 0 .../reference/js-api/functions/$package.md | 0 .../reference/js-api/functions/$reserve.md | 0 .../reference/js-api/functions/$service.md | 0 .../reference/js-api/functions/$stream.md | 0 .../reference/js-api/functions/isMap.md | 0 .../protobuf/reference/js-api/index.md | 0 .../js-api/interfaces/PackageDetails.md | 0 .../js-api/type-aliases/Reservation.md | 0 .../reference/js-api/variables/$lib.md | 0 .../js-api/variables/PROTO_FULL_IDENT.md | 0 .../reference/js-api/variables/namespace.md | 0 .../getting-started/getting-started-http.md | 2 +- .../language-basics/namespaces.md | 2 +- .../libraries/http/reference/data-types.md | 12 +- .../libraries/http/reference/decorators.md | 68 +- .../libraries/http/reference/index.mdx | 2 + .../reference/js-api/functions/$bodyIgnore.md | 19 + .../reference/js-api/functions/$bodyRoot.md | 19 + .../js-api/functions/isBodyIgnore.md | 19 + .../reference/js-api/functions/isBodyRoot.md | 19 + .../libraries/http/reference/js-api/index.md | 5 + .../js-api/interfaces/HttpOperationBody.md | 11 +- .../interfaces/HttpOperationRequestBody.md | 12 +- .../interfaces/HttpOperationResponseBody.md | 18 + .../HttpOperationResponseContent.md | 2 +- .../js-api/interfaces/MetadataInfo.md | 12 +- .../http/reference/js-api/variables/$lib.md | 4 + .../js-api/functions/resolveVersions.md | 4 +- .../version-latest/libraries/xml/guide.md | 948 ++++++++++++++++++ .../libraries/xml/reference/decorators.md | 247 +++++ .../libraries/xml/reference/index.mdx | 42 + .../xml/reference/js-api/_category_.json | 1 + .../reference/js-api/functions/$attribute.md | 19 + .../xml/reference/js-api/functions/$name.md | 23 + .../xml/reference/js-api/functions/$ns.md | 25 + .../js-api/functions/$nsDeclarations.md | 19 + .../reference/js-api/functions/$unwrapped.md | 19 + .../xml/reference/js-api/functions/getNs.md | 21 + .../js-api/functions/getXmlEncoding.md | 22 + .../reference/js-api/functions/isAttribute.md | 21 + .../reference/js-api/functions/isUnwrapped.md | 21 + .../libraries/xml/reference/js-api/index.md | 25 + .../js-api/interfaces/XmlEncodeData.md | 15 + .../js-api/interfaces/XmlNamespace.md | 11 + .../js-api/type-aliases/XmlEncoding.md | 15 + .../release-notes/release-2024-05-07.md | 157 +++ .../js-api/classes/ProjectionError.md | 1 + .../js-api/classes/ResolveModuleError.md | 1 + .../reference/js-api/functions/$indexer.md | 25 - .../reference/js-api/functions/getIndexer.md | 19 - .../reference/js-api/index.md | 3 +- .../js-api/interfaces/ArrayModelType.md | 1 + .../reference/js-api/interfaces/Model.md | 1 + .../js-api/interfaces/RecordModelType.md | 1 + .../js-api/interfaces/SourceModel.md | 11 + .../version-latest-sidebars.json | 75 +- packages/xml/CHANGELOG.md | 10 + packages/xml/package.json | 2 +- 217 files changed, 2204 insertions(+), 582 deletions(-) delete mode 100644 .chronus/changes/actual-std-lib-2024-3-15-15-53-0.md delete mode 100644 .chronus/changes/actual-std-lib-2024-3-15-15-55-33.md delete mode 100644 .chronus/changes/azhang_fixTestUtil-2024-3-24-13-29-34.md delete mode 100644 .chronus/changes/body-consitency-2024-2-27-18-35-44-1.md delete mode 100644 .chronus/changes/body-consitency-2024-2-27-18-35-44-2.md delete mode 100644 .chronus/changes/body-consitency-2024-2-27-18-35-44.md delete mode 100644 .chronus/changes/body-consitency-2024-3-2-15-21-10.md delete mode 100644 .chronus/changes/body-consitency-2024-3-2-15-21-9.md delete mode 100644 .chronus/changes/docs-split-libraries-emitters-2024-4-2-16-20-50.md delete mode 100644 .chronus/changes/eslint-flat-config-2024-3-5-19-46-26.md delete mode 100644 .chronus/changes/extern-dec-type-2024-3-29-19-9-6.md delete mode 100644 .chronus/changes/feature-numeric-2024-3-4-23-14-45.md delete mode 100644 .chronus/changes/feature-xml-2024-2-20-16-48-57.md delete mode 100644 .chronus/changes/feature-xml-2024-3-8-20-40-16.md delete mode 100644 .chronus/changes/fix-augment-decorator-template-decl-2024-3-23-15-44-27.md delete mode 100644 .chronus/changes/fix-blob-2024-3-26-0-22-15.md delete mode 100644 .chronus/changes/fix-compiler-crash-alias-union-2024-3-18-2-39-55.md delete mode 100644 .chronus/changes/fix-include-op-template-args-2024-3-16-17-19-2.md delete mode 100644 .chronus/changes/fix-init-never-ending-2024-3-17-20-24-14.md delete mode 100644 .chronus/changes/fix-keyword-completions-2024-3-10-22-29-31.md delete mode 100644 .chronus/changes/fix-keyword-completions-2024-3-11-0-17-59.md delete mode 100644 .chronus/changes/fix-no-finish-cloned-unfinished-2024-4-6-20-0-24.md delete mode 100644 .chronus/changes/fix-numeric-exp-2024-3-11-19-8-28.md delete mode 100644 .chronus/changes/fix-numeric-neg-2024-3-11-16-15-51.md delete mode 100644 .chronus/changes/fix-optional-prop-required-2024-4-6-21-39-1.md delete mode 100644 .chronus/changes/fix-parser-test-multi-run-2024-3-15-21-34-43.md delete mode 100644 .chronus/changes/fix-password-flow-2024-3-19-16-22-3.md delete mode 100644 .chronus/changes/fix-path-param-mapping-record-2024-3-18-16-17-3.md delete mode 100644 .chronus/changes/fix-spread-assignment-2024-3-12-18-23-17.md delete mode 100644 .chronus/changes/fix-unfinished-partial-ops-2024-3-24-16-10-25.md delete mode 100644 .chronus/changes/fix-unrechable-models-path-2024-3-23-19-55-13.md delete mode 100644 .chronus/changes/fix-unrechable-models-path-2024-3-23-19-55-14.md delete mode 100644 .chronus/changes/fix-versioning-sub-namespace-2024-4-2-22-46-51.md delete mode 100644 .chronus/changes/fix-wrong-cp-2024-3-6-0-10-22.md delete mode 100644 .chronus/changes/fixDirectiveParsing-2024-3-16-17-9-37.md delete mode 100644 .chronus/changes/main-2024-3-26-15-49-18.md delete mode 100644 .chronus/changes/pr-performance-2024-3-3-21-39-32.md delete mode 100644 .chronus/changes/recover-bad-op-is-2024-3-23-17-46-20.md delete mode 100644 .chronus/changes/sample-compiler-options-2024-3-5-20-58-20.md delete mode 100644 .chronus/changes/spread-source-2024-3-18-18-19-45.md delete mode 100644 .chronus/changes/spread-source-2024-3-18-18-49-3.md delete mode 100644 .chronus/changes/upgrade-deps-april-2024-2024-3-13-20-10-53.md delete mode 100644 .chronus/changes/use-node-fetch-builtin-2024-3-26-17-50-57.md delete mode 100644 .chronus/changes/xml-wrong-version-2024-3-15-21-40-57.md rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/data-types.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/decorators.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/emitter.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/index.mdx (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/_category_.json (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/classes/JsonSchemaEmitter.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$baseUri.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$contains.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$contentEncoding.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$contentMediaType.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$contentSchema.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$extension.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$id.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$jsonSchema.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$maxContains.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$maxProperties.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$minContains.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$minProperties.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$multipleOf.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$onEmit.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$prefixItems.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$uniqueItems.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/$validatesRawJson.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/findBaseUri.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getBaseUri.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getContains.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getContentEncoding.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getContentMediaType.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getContentSchema.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getExtensions.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getId.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getJsonSchema.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getJsonSchemaTypes.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getMaxContains.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getMaxProperties.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getMinContains.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getMinProperties.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getMultipleOf.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getPrefixItems.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/getUniqueItems.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/functions/isJsonSchemaDeclaration.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/index.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/interfaces/ExtensionRecord.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/interfaces/JSONSchemaEmitterOptions.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/type-aliases/JsonSchemaDeclaration.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/variables/$lib.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/variables/EmitterOptionsSchema.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/json-schema/reference/js-api/variables/namespace.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/diagnostics.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/openapi.md (92%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/decorators.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/emitter.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/index.mdx (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/js-api/_category_.json (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/js-api/functions/$onEmit.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/js-api/functions/$oneOf.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/js-api/functions/$useRef.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/js-api/functions/getOneOf.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/js-api/functions/getOpenAPI3.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/js-api/functions/getRef.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/js-api/functions/resolveOptions.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/js-api/index.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/js-api/interfaces/ResolvedOpenAPI3EmitterOptions.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/js-api/variables/$lib.md (94%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/openapi3/reference/js-api/variables/namespace.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/guide.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/data-types.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/decorators.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/emitter.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/index.mdx (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/_category_.json (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/functions/$externRef.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/functions/$field.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/functions/$message.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/functions/$onEmit.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/functions/$onValidate.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/functions/$package.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/functions/$reserve.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/functions/$service.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/functions/$stream.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/functions/isMap.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/index.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/interfaces/PackageDetails.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/type-aliases/Reservation.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/variables/$lib.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/variables/PROTO_FULL_IDENT.md (100%) rename packages/website/versioned_docs/version-latest/{libraries => emitters}/protobuf/reference/js-api/variables/namespace.md (100%) create mode 100644 packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/$bodyIgnore.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/$bodyRoot.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/isBodyIgnore.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/isBodyRoot.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationResponseBody.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/guide.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/decorators.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/index.mdx create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/_category_.json create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$attribute.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$name.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$ns.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$nsDeclarations.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$unwrapped.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/getNs.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/getXmlEncoding.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/isAttribute.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/isUnwrapped.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/index.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/interfaces/XmlEncodeData.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/interfaces/XmlNamespace.md create mode 100644 packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/type-aliases/XmlEncoding.md create mode 100644 packages/website/versioned_docs/version-latest/release-notes/release-2024-05-07.md delete mode 100644 packages/website/versioned_docs/version-latest/standard-library/reference/js-api/functions/$indexer.md delete mode 100644 packages/website/versioned_docs/version-latest/standard-library/reference/js-api/functions/getIndexer.md create mode 100644 packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/SourceModel.md create mode 100644 packages/xml/CHANGELOG.md diff --git a/.chronus/changes/actual-std-lib-2024-3-15-15-53-0.md b/.chronus/changes/actual-std-lib-2024-3-15-15-53-0.md deleted file mode 100644 index 84a7efd3ad..0000000000 --- a/.chronus/changes/actual-std-lib-2024-3-15-15-53-0.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -`--nostdlib` flag will now work by only applying to optional standard library types diff --git a/.chronus/changes/actual-std-lib-2024-3-15-15-55-33.md b/.chronus/changes/actual-std-lib-2024-3-15-15-55-33.md deleted file mode 100644 index 3325f2f0b9..0000000000 --- a/.chronus/changes/actual-std-lib-2024-3-15-15-55-33.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/playground" ---- - -Add support for new intrinsic vs std lib split in the compiler. diff --git a/.chronus/changes/azhang_fixTestUtil-2024-3-24-13-29-34.md b/.chronus/changes/azhang_fixTestUtil-2024-3-24-13-29-34.md deleted file mode 100644 index f441bba5f0..0000000000 --- a/.chronus/changes/azhang_fixTestUtil-2024-3-24-13-29-34.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -changeKind: internal -packages: - - "@typespec/compiler" ---- - diff --git a/.chronus/changes/body-consitency-2024-2-27-18-35-44-1.md b/.chronus/changes/body-consitency-2024-2-27-18-35-44-1.md deleted file mode 100644 index 7f49a711d3..0000000000 --- a/.chronus/changes/body-consitency-2024-2-27-18-35-44-1.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: breaking -packages: - - "@typespec/http" ---- - -Empty model after removing metadata and applying visibility always results in "void" - This means the following case have changed from returning `{}` to no body - - ```tsp - op b1(): {}; - op b2(): {@visibility("none") prop: string}; - op b3(): {@added(Versions.v2) prop: string}; - ``` - - Workaround: Use explicit `@body` - - ```tsp - op b1(): {@body _: {}}; - op b2(): {@body _: {@visibility("none") prop: string}}; - op b3(): {@body _: {@added(Versions.v2) prop: string}}; - ``` diff --git a/.chronus/changes/body-consitency-2024-2-27-18-35-44-2.md b/.chronus/changes/body-consitency-2024-2-27-18-35-44-2.md deleted file mode 100644 index aa980aab9e..0000000000 --- a/.chronus/changes/body-consitency-2024-2-27-18-35-44-2.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: breaking -packages: - - "@typespec/http" ---- - -Implicit status code always 200 except if response is explicitly `void` - - ```tsp - op c1(): {@header foo: string}; // status code 200 (used to be 204) - ``` - - Solution: Add explicit `@statusCode` - ```tsp - op c1(): {@header foo: string, @statusCode _: 204}; - op c1(): {@header foo: string, ...NoContent}; // or spread common model - ``` diff --git a/.chronus/changes/body-consitency-2024-2-27-18-35-44.md b/.chronus/changes/body-consitency-2024-2-27-18-35-44.md deleted file mode 100644 index 8d0b25789b..0000000000 --- a/.chronus/changes/body-consitency-2024-2-27-18-35-44.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: breaking -packages: - - "@typespec/http" ---- - -`@body` means this is the body - - This change makes using `@body` mean this is the exact body and everything underneath will be included, including metadata properties. If metadata properties are present on the body, a warning will be logged. - - ```tsp - op a1(): {@body _: {@header foo: string, other: string} }; - ^ warning header in a body, it will not be included as a header. - ``` - - Use `@bodyRoot` if you want to only change where to resolve the body from. - - ```tsp - op a1(): {@bodyRoot _: {@header foo: string, other: string} }; - ``` - diff --git a/.chronus/changes/body-consitency-2024-3-2-15-21-10.md b/.chronus/changes/body-consitency-2024-3-2-15-21-10.md deleted file mode 100644 index 44a01c2b40..0000000000 --- a/.chronus/changes/body-consitency-2024-3-2-15-21-10.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: feature -packages: - - "@typespec/openapi3" - - "@typespec/rest" ---- - -Add support for new `@bodyRoot` and `@body` distinction diff --git a/.chronus/changes/body-consitency-2024-3-2-15-21-9.md b/.chronus/changes/body-consitency-2024-3-2-15-21-9.md deleted file mode 100644 index 9d8ffa9114..0000000000 --- a/.chronus/changes/body-consitency-2024-3-2-15-21-9.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: breaking -packages: - - "@typespec/http" ---- - -Properties are not automatically omitted if everything was removed from metadata or visibility - - ```tsp - op d1(): {headers: {@header foo: string}}; // body will be {headers: {}} - ``` - - Solution: use `@bodyIgnore` - - ```tsp - op d1(): {@bodyIgnore headers: {@header foo: string}}; // body will be {headers: {}} - ``` diff --git a/.chronus/changes/docs-split-libraries-emitters-2024-4-2-16-20-50.md b/.chronus/changes/docs-split-libraries-emitters-2024-4-2-16-20-50.md deleted file mode 100644 index 7b910cc239..0000000000 --- a/.chronus/changes/docs-split-libraries-emitters-2024-4-2-16-20-50.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: internal -packages: - - "@typespec/json-schema" - - "@typespec/openapi3" - - "@typespec/protobuf" ---- diff --git a/.chronus/changes/eslint-flat-config-2024-3-5-19-46-26.md b/.chronus/changes/eslint-flat-config-2024-3-5-19-46-26.md deleted file mode 100644 index 1a682ff4d9..0000000000 --- a/.chronus/changes/eslint-flat-config-2024-3-5-19-46-26.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: internal -packages: - - "@typespec/bundler" - - "@typespec/compiler" - - "@typespec/eslint-plugin" - - "@typespec/html-program-viewer" - - "@typespec/http" - - "@typespec/internal-build-utils" - - "@typespec/json-schema" - - "@typespec/library-linter" - - "@typespec/openapi" - - "@typespec/openapi3" - - "@typespec/playground" - - "@typespec/prettier-plugin-typespec" - - "@typespec/protobuf" - - "@typespec/rest" - - tmlanguage-generator - - typespec-vscode - - "@typespec/versioning" - - "typespec-vs" ---- - -Migrate to eslint flat config diff --git a/.chronus/changes/extern-dec-type-2024-3-29-19-9-6.md b/.chronus/changes/extern-dec-type-2024-3-29-19-9-6.md deleted file mode 100644 index c644f781bf..0000000000 --- a/.chronus/changes/extern-dec-type-2024-3-29-19-9-6.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: internal -packages: - - "@typespec/compiler" - - "@typespec/http" - - "@typespec/json-schema" - - "@typespec/openapi" - - "@typespec/openapi3" - - "@typespec/protobuf" - - "@typespec/rest" - - "@typespec/versioning" - - "@typespec/xml" ---- - -Include `type` in generated extern dec diff --git a/.chronus/changes/feature-numeric-2024-3-4-23-14-45.md b/.chronus/changes/feature-numeric-2024-3-4-23-14-45.md deleted file mode 100644 index 840bf8d06e..0000000000 --- a/.chronus/changes/feature-numeric-2024-3-4-23-14-45.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: internal -packages: - - "@typespec/compiler" ---- - -Add new `Numeric` data structure diff --git a/.chronus/changes/feature-xml-2024-2-20-16-48-57.md b/.chronus/changes/feature-xml-2024-2-20-16-48-57.md deleted file mode 100644 index a5a0085727..0000000000 --- a/.chronus/changes/feature-xml-2024-2-20-16-48-57.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: internal -packages: - - "@typespec/xml" ---- - -Initial release of xml library diff --git a/.chronus/changes/feature-xml-2024-3-8-20-40-16.md b/.chronus/changes/feature-xml-2024-3-8-20-40-16.md deleted file mode 100644 index 56ad53512a..0000000000 --- a/.chronus/changes/feature-xml-2024-3-8-20-40-16.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: feature -packages: - - "@typespec/compiler" ---- - -`getEncode` returns the fully qualified enum member name if using a custom enum. diff --git a/.chronus/changes/fix-augment-decorator-template-decl-2024-3-23-15-44-27.md b/.chronus/changes/fix-augment-decorator-template-decl-2024-3-23-15-44-27.md deleted file mode 100644 index 64221aa06e..0000000000 --- a/.chronus/changes/fix-augment-decorator-template-decl-2024-3-23-15-44-27.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -Fix: augmenting template model property could result in sending invalid argument to decorator diff --git a/.chronus/changes/fix-blob-2024-3-26-0-22-15.md b/.chronus/changes/fix-blob-2024-3-26-0-22-15.md deleted file mode 100644 index d64a80d474..0000000000 --- a/.chronus/changes/fix-blob-2024-3-26-0-22-15.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: internal -packages: - - "@typespec/playground" ---- diff --git a/.chronus/changes/fix-compiler-crash-alias-union-2024-3-18-2-39-55.md b/.chronus/changes/fix-compiler-crash-alias-union-2024-3-18-2-39-55.md deleted file mode 100644 index e727e7e96f..0000000000 --- a/.chronus/changes/fix-compiler-crash-alias-union-2024-3-18-2-39-55.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -Fix: Do not crash when trying to access member of aliased expressions diff --git a/.chronus/changes/fix-include-op-template-args-2024-3-16-17-19-2.md b/.chronus/changes/fix-include-op-template-args-2024-3-16-17-19-2.md deleted file mode 100644 index 8b19e6fb8b..0000000000 --- a/.chronus/changes/fix-include-op-template-args-2024-3-16-17-19-2.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -changeKind: feature -packages: - - "@typespec/compiler" ---- - -Show template parameters when hovering on an operation template \ No newline at end of file diff --git a/.chronus/changes/fix-init-never-ending-2024-3-17-20-24-14.md b/.chronus/changes/fix-init-never-ending-2024-3-17-20-24-14.md deleted file mode 100644 index 649ce5c4c7..0000000000 --- a/.chronus/changes/fix-init-never-ending-2024-3-17-20-24-14.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -Fix tsp init hanging when done due to unclosed connection diff --git a/.chronus/changes/fix-keyword-completions-2024-3-10-22-29-31.md b/.chronus/changes/fix-keyword-completions-2024-3-10-22-29-31.md deleted file mode 100644 index 12bac6294c..0000000000 --- a/.chronus/changes/fix-keyword-completions-2024-3-10-22-29-31.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -IDE: Fix completion of statement keywords diff --git a/.chronus/changes/fix-keyword-completions-2024-3-11-0-17-59.md b/.chronus/changes/fix-keyword-completions-2024-3-11-0-17-59.md deleted file mode 100644 index 5a76dc6612..0000000000 --- a/.chronus/changes/fix-keyword-completions-2024-3-11-0-17-59.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/playground" ---- - -Fix completion of keywords diff --git a/.chronus/changes/fix-no-finish-cloned-unfinished-2024-4-6-20-0-24.md b/.chronus/changes/fix-no-finish-cloned-unfinished-2024-4-6-20-0-24.md deleted file mode 100644 index 20038ff610..0000000000 --- a/.chronus/changes/fix-no-finish-cloned-unfinished-2024-4-6-20-0-24.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -Templated interface extending another templated interface shouldn't run decorator on their operations diff --git a/.chronus/changes/fix-numeric-exp-2024-3-11-19-8-28.md b/.chronus/changes/fix-numeric-exp-2024-3-11-19-8-28.md deleted file mode 100644 index f441bba5f0..0000000000 --- a/.chronus/changes/fix-numeric-exp-2024-3-11-19-8-28.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -changeKind: internal -packages: - - "@typespec/compiler" ---- - diff --git a/.chronus/changes/fix-numeric-neg-2024-3-11-16-15-51.md b/.chronus/changes/fix-numeric-neg-2024-3-11-16-15-51.md deleted file mode 100644 index 67f9d4071d..0000000000 --- a/.chronus/changes/fix-numeric-neg-2024-3-11-16-15-51.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: internal -packages: - - "@typespec/compiler" ---- - -Fix compare of negative numbers in `Numeric` type diff --git a/.chronus/changes/fix-optional-prop-required-2024-4-6-21-39-1.md b/.chronus/changes/fix-optional-prop-required-2024-4-6-21-39-1.md deleted file mode 100644 index c9459dac5b..0000000000 --- a/.chronus/changes/fix-optional-prop-required-2024-4-6-21-39-1.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -Model with an optional property should not satisfy a constraint with that property required. (`{foo?: string}` cannot be assigned to a constraint of `{foo: string}`) diff --git a/.chronus/changes/fix-parser-test-multi-run-2024-3-15-21-34-43.md b/.chronus/changes/fix-parser-test-multi-run-2024-3-15-21-34-43.md deleted file mode 100644 index 061659221c..0000000000 --- a/.chronus/changes/fix-parser-test-multi-run-2024-3-15-21-34-43.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: internal -packages: - - "@typespec/compiler" ---- - -Fix parser test running 1-4 times diff --git a/.chronus/changes/fix-password-flow-2024-3-19-16-22-3.md b/.chronus/changes/fix-password-flow-2024-3-19-16-22-3.md deleted file mode 100644 index 435e17e523..0000000000 --- a/.chronus/changes/fix-password-flow-2024-3-19-16-22-3.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/http" ---- - -Fix password flow defining `authorizationUrl` instead of `tokenUrl` diff --git a/.chronus/changes/fix-path-param-mapping-record-2024-3-18-16-17-3.md b/.chronus/changes/fix-path-param-mapping-record-2024-3-18-16-17-3.md deleted file mode 100644 index 288304c562..0000000000 --- a/.chronus/changes/fix-path-param-mapping-record-2024-3-18-16-17-3.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/http" ---- - -Fix `@path` param mapping when spreading a record in operation parameters diff --git a/.chronus/changes/fix-spread-assignment-2024-3-12-18-23-17.md b/.chronus/changes/fix-spread-assignment-2024-3-12-18-23-17.md deleted file mode 100644 index 5518c10b39..0000000000 --- a/.chronus/changes/fix-spread-assignment-2024-3-12-18-23-17.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -Fix: Model with spread indexer shouldn't validate explicit properties diff --git a/.chronus/changes/fix-unfinished-partial-ops-2024-3-24-16-10-25.md b/.chronus/changes/fix-unfinished-partial-ops-2024-3-24-16-10-25.md deleted file mode 100644 index fa9e1307e6..0000000000 --- a/.chronus/changes/fix-unfinished-partial-ops-2024-3-24-16-10-25.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -Stop running decorators on partially instantiated operations(When interface is instantiated but not the operation) diff --git a/.chronus/changes/fix-unrechable-models-path-2024-3-23-19-55-13.md b/.chronus/changes/fix-unrechable-models-path-2024-3-23-19-55-13.md deleted file mode 100644 index 5bdd9caa5a..0000000000 --- a/.chronus/changes/fix-unrechable-models-path-2024-3-23-19-55-13.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/openapi3" ---- - -Fix: `@path` property should be included in unreachable models diff --git a/.chronus/changes/fix-unrechable-models-path-2024-3-23-19-55-14.md b/.chronus/changes/fix-unrechable-models-path-2024-3-23-19-55-14.md deleted file mode 100644 index f2b4e34128..0000000000 --- a/.chronus/changes/fix-unrechable-models-path-2024-3-23-19-55-14.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/http" ---- - -Fix: `@path` property shouldn't be applicableMetadata if the visibility contains `Read` diff --git a/.chronus/changes/fix-versioning-sub-namespace-2024-4-2-22-46-51.md b/.chronus/changes/fix-versioning-sub-namespace-2024-4-2-22-46-51.md deleted file mode 100644 index 72503fdfa4..0000000000 --- a/.chronus/changes/fix-versioning-sub-namespace-2024-4-2-22-46-51.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/versioning" ---- - -Fix crash when `@service` appears inside a versioned namespace diff --git a/.chronus/changes/fix-wrong-cp-2024-3-6-0-10-22.md b/.chronus/changes/fix-wrong-cp-2024-3-6-0-10-22.md deleted file mode 100644 index d64a80d474..0000000000 --- a/.chronus/changes/fix-wrong-cp-2024-3-6-0-10-22.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: internal -packages: - - "@typespec/playground" ---- diff --git a/.chronus/changes/fixDirectiveParsing-2024-3-16-17-9-37.md b/.chronus/changes/fixDirectiveParsing-2024-3-16-17-9-37.md deleted file mode 100644 index 9afb07bcb5..0000000000 --- a/.chronus/changes/fixDirectiveParsing-2024-3-16-17-9-37.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -Fix issue where directives were not parsed to the leaf node in multi-segment Namespace segments. diff --git a/.chronus/changes/main-2024-3-26-15-49-18.md b/.chronus/changes/main-2024-3-26-15-49-18.md deleted file mode 100644 index 8292e442f0..0000000000 --- a/.chronus/changes/main-2024-3-26-15-49-18.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -Fix calling `tsp install` on windows due to recent NodeJS breaking change to fix vulnerability. diff --git a/.chronus/changes/pr-performance-2024-3-3-21-39-32.md b/.chronus/changes/pr-performance-2024-3-3-21-39-32.md deleted file mode 100644 index 6822cf9376..0000000000 --- a/.chronus/changes/pr-performance-2024-3-3-21-39-32.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: internal -packages: - - "@typespec/bundler" - - "@typespec/compiler" - - "@typespec/eslint-plugin" - - "@typespec/html-program-viewer" - - "@typespec/http" - - "@typespec/internal-build-utils" - - "@typespec/json-schema" - - "@typespec/library-linter" - - "@typespec/openapi" - - "@typespec/openapi3" - - "@typespec/playground" - - "@typespec/prettier-plugin-typespec" - - "@typespec/protobuf" - - "@typespec/rest" - - "@typespec/versioning" ---- - -Ci improvements diff --git a/.chronus/changes/recover-bad-op-is-2024-3-23-17-46-20.md b/.chronus/changes/recover-bad-op-is-2024-3-23-17-46-20.md deleted file mode 100644 index 553de9ab5d..0000000000 --- a/.chronus/changes/recover-bad-op-is-2024-3-23-17-46-20.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -Fix compiler crash when using an invalid `is` target in an interface operation template diff --git a/.chronus/changes/sample-compiler-options-2024-3-5-20-58-20.md b/.chronus/changes/sample-compiler-options-2024-3-5-20-58-20.md deleted file mode 100644 index 5b71504176..0000000000 --- a/.chronus/changes/sample-compiler-options-2024-3-5-20-58-20.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: internal -packages: - - "@typespec/playground" ---- - -Pass compiler options for samples diff --git a/.chronus/changes/spread-source-2024-3-18-18-19-45.md b/.chronus/changes/spread-source-2024-3-18-18-19-45.md deleted file mode 100644 index 6615ff953e..0000000000 --- a/.chronus/changes/spread-source-2024-3-18-18-19-45.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: feature -packages: - - "@typespec/compiler" ---- - -[API] Add new `sourceModels` property to model diff --git a/.chronus/changes/spread-source-2024-3-18-18-49-3.md b/.chronus/changes/spread-source-2024-3-18-18-49-3.md deleted file mode 100644 index bdb2d888ea..0000000000 --- a/.chronus/changes/spread-source-2024-3-18-18-49-3.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: feature -packages: - - "@typespec/html-program-viewer" ---- - -Add `sourceModels` property to model view diff --git a/.chronus/changes/upgrade-deps-april-2024-2024-3-13-20-10-53.md b/.chronus/changes/upgrade-deps-april-2024-2024-3-13-20-10-53.md deleted file mode 100644 index d8943ccaf2..0000000000 --- a/.chronus/changes/upgrade-deps-april-2024-2024-3-13-20-10-53.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: dependencies -packages: - - "@typespec/bundler" - - "@typespec/compiler" - - "@typespec/eslint-plugin" - - "@typespec/html-program-viewer" - - "@typespec/http" - - "@typespec/internal-build-utils" - - "@typespec/json-schema" - - "@typespec/library-linter" - - "@typespec/openapi" - - "@typespec/openapi3" - - "@typespec/playground" - - "@typespec/prettier-plugin-typespec" - - "@typespec/protobuf" - - "@typespec/rest" - - tmlanguage-generator - - typespec-vscode - - "@typespec/versioning" - - "@typespec/xml" ---- - -Update dependencies diff --git a/.chronus/changes/use-node-fetch-builtin-2024-3-26-17-50-57.md b/.chronus/changes/use-node-fetch-builtin-2024-3-26-17-50-57.md deleted file mode 100644 index 628ffc4f73..0000000000 --- a/.chronus/changes/use-node-fetch-builtin-2024-3-26-17-50-57.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: fix -packages: - - "@typespec/compiler" ---- - -Internals: Use node built-in `fetch` API that is now stable since node `18.13.0` diff --git a/.chronus/changes/xml-wrong-version-2024-3-15-21-40-57.md b/.chronus/changes/xml-wrong-version-2024-3-15-21-40-57.md deleted file mode 100644 index 5a37c59e6c..0000000000 --- a/.chronus/changes/xml-wrong-version-2024-3-15-21-40-57.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking -changeKind: internal -packages: - - "@typespec/xml" ---- - -Fix xml version diff --git a/.github/workflows/consistency.yml b/.github/workflows/consistency.yml index 689826a52d..822073a100 100644 --- a/.github/workflows/consistency.yml +++ b/.github/workflows/consistency.yml @@ -15,6 +15,7 @@ jobs: check-changes: name: Check Changes runs-on: ubuntu-latest + if: github.event_name == 'pull_request' steps: - uses: actions/checkout@v4 with: @@ -31,7 +32,10 @@ jobs: - run: npx chronus verify name: Check changelog - if: ${{ !startsWith(github.head_ref, 'publish/') && !startsWith(github.head_ref, 'dependabot/') && !startsWith(github.head_ref, 'backmerge/') }} + if: | + !startsWith(github.head_ref, 'publish/') && + !startsWith(github.head_ref, 'dependabot/') && + !startsWith(github.head_ref, 'backmerge/') # Validate spell check spellcheck: diff --git a/packages/bundler/CHANGELOG.md b/packages/bundler/CHANGELOG.md index 3ce88c99b5..224a3e5499 100644 --- a/packages/bundler/CHANGELOG.md +++ b/packages/bundler/CHANGELOG.md @@ -1,5 +1,12 @@ # Change Log - @typespec/bundler +## 0.1.3 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + + ## 0.1.2 ### Bump dependencies diff --git a/packages/bundler/package.json b/packages/bundler/package.json index 3add764572..7d5ad4eef9 100644 --- a/packages/bundler/package.json +++ b/packages/bundler/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/bundler", - "version": "0.1.2", + "version": "0.1.3", "author": "Microsoft Corporation", "description": "Package to bundle a TypeSpec library.", "homepage": "https://typespec.io", diff --git a/packages/compiler/CHANGELOG.md b/packages/compiler/CHANGELOG.md index c640e810ea..4c6cd01c3a 100644 --- a/packages/compiler/CHANGELOG.md +++ b/packages/compiler/CHANGELOG.md @@ -1,5 +1,34 @@ # Change Log - @typespec/compiler +## 0.56.0 + +### Bug Fixes + +- [#3170](https://github.com/microsoft/typespec/pull/3170) `--nostdlib` flag will now work by only applying to optional standard library types +- [#3212](https://github.com/microsoft/typespec/pull/3212) Fix: augmenting template model property could result in sending invalid argument to decorator +- [#3188](https://github.com/microsoft/typespec/pull/3188) Fix: Do not crash when trying to access member of aliased expressions +- [#3185](https://github.com/microsoft/typespec/pull/3185) Fix tsp init hanging when done due to unclosed connection +- [#3151](https://github.com/microsoft/typespec/pull/3151) IDE: Fix completion of statement keywords +- [#3287](https://github.com/microsoft/typespec/pull/3287) Templated interface extending another templated interface shouldn't run decorator on their operations +- [#3290](https://github.com/microsoft/typespec/pull/3290) Model with an optional property should not satisfy a constraint with that property required. (`{foo?: string}` cannot be assigned to a constraint of `{foo: string}`) +- [#3163](https://github.com/microsoft/typespec/pull/3163) Fix: Model with spread indexer shouldn't validate explicit properties +- [#3227](https://github.com/microsoft/typespec/pull/3227) Stop running decorators on partially instantiated operations(When interface is instantiated but not the operation) +- [#3180](https://github.com/microsoft/typespec/pull/3180) Fix issue where directives were not parsed to the leaf node in multi-segment Namespace segments. +- [#3243](https://github.com/microsoft/typespec/pull/3243) Fix calling `tsp install` on windows due to recent NodeJS breaking change to fix vulnerability. +- [#3216](https://github.com/microsoft/typespec/pull/3216) Fix compiler crash when using an invalid `is` target in an interface operation template +- [#3246](https://github.com/microsoft/typespec/pull/3246) Internals: Use node built-in `fetch` API that is now stable since node `18.13.0` + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + +### Features + +- [#3035](https://github.com/microsoft/typespec/pull/3035) `getEncode` returns the fully qualified enum member name if using a custom enum. +- [#3183](https://github.com/microsoft/typespec/pull/3183) Show template parameters when hovering on an operation template +- [#3191](https://github.com/microsoft/typespec/pull/3191) [API] Add new `sourceModels` property to model + + ## 0.55.0 ### Bug Fixes diff --git a/packages/compiler/package.json b/packages/compiler/package.json index ebcabd7de7..6b83683803 100644 --- a/packages/compiler/package.json +++ b/packages/compiler/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/compiler", - "version": "0.55.0", + "version": "0.56.0", "description": "TypeSpec Compiler Preview", "author": "Microsoft Corporation", "license": "MIT", diff --git a/packages/compiler/templates/scaffolding.json b/packages/compiler/templates/scaffolding.json index 1d27965c1d..3c277e14fa 100644 --- a/packages/compiler/templates/scaffolding.json +++ b/packages/compiler/templates/scaffolding.json @@ -3,12 +3,12 @@ "title": "Empty project", "description": "Create an empty project.", "libraries": [], - "compilerVersion": "0.55.0" + "compilerVersion": "0.56.0" }, "rest": { "title": "Generic REST API", "description": "Create a project representing a generic REST API", - "compilerVersion": "0.55.0", + "compilerVersion": "0.56.0", "libraries": [ "@typespec/http", "@typespec/rest", @@ -23,7 +23,7 @@ "library-ts": { "title": "TypeSpec Library (With TypeScript)", "description": "Create a new package to add decorators or linters to typespec.", - "compilerVersion": "0.55.0", + "compilerVersion": "0.56.0", "libraries": [], "files": [ { @@ -99,7 +99,7 @@ "emitter-ts": { "title": "TypeSpec Emitter (With TypeScript)", "description": "Create a new package that will be emitting typespec", - "compilerVersion": "0.55.0", + "compilerVersion": "0.56.0", "libraries": [], "files": [ { diff --git a/packages/eslint-plugin-typespec/CHANGELOG.md b/packages/eslint-plugin-typespec/CHANGELOG.md index cc7daf0144..0724012f37 100644 --- a/packages/eslint-plugin-typespec/CHANGELOG.md +++ b/packages/eslint-plugin-typespec/CHANGELOG.md @@ -1,5 +1,12 @@ # Change Log - @typespec/eslint-plugin +## 0.56.0 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + + ## 0.55.0 ### Bump dependencies diff --git a/packages/eslint-plugin-typespec/package.json b/packages/eslint-plugin-typespec/package.json index 28e259ba11..9d6fe2cc90 100644 --- a/packages/eslint-plugin-typespec/package.json +++ b/packages/eslint-plugin-typespec/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/eslint-plugin", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "Eslint plugin providing set of rules to be used in the JS/TS code of TypeSpec libraries", "homepage": "https://typespec.io", diff --git a/packages/html-program-viewer/CHANGELOG.md b/packages/html-program-viewer/CHANGELOG.md index 570f10f38f..2c4209915b 100644 --- a/packages/html-program-viewer/CHANGELOG.md +++ b/packages/html-program-viewer/CHANGELOG.md @@ -1,5 +1,16 @@ # Change Log - @typespec/html-program-viewer +## 0.56.0 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + +### Features + +- [#3191](https://github.com/microsoft/typespec/pull/3191) Add `sourceModels` property to model view + + ## 0.55.0 ### Bump dependencies diff --git a/packages/html-program-viewer/package.json b/packages/html-program-viewer/package.json index 0e41c8bfa7..00a4499389 100644 --- a/packages/html-program-viewer/package.json +++ b/packages/html-program-viewer/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/html-program-viewer", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "TypeSpec library for emitting an html view of the program.", "homepage": "https://typespec.io", diff --git a/packages/http/CHANGELOG.md b/packages/http/CHANGELOG.md index cdc1709e1d..960139e7f0 100644 --- a/packages/http/CHANGELOG.md +++ b/packages/http/CHANGELOG.md @@ -1,5 +1,73 @@ # Change Log - @typespec/http +## 0.56.0 + +### Bug Fixes + +- [#3196](https://github.com/microsoft/typespec/pull/3196) Fix password flow defining `authorizationUrl` instead of `tokenUrl` +- [#3190](https://github.com/microsoft/typespec/pull/3190) Fix `@path` param mapping when spreading a record in operation parameters +- [#3218](https://github.com/microsoft/typespec/pull/3218) Fix: `@path` property shouldn't be applicableMetadata if the visibility contains `Read` + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + +### Breaking Changes + +- [#2945](https://github.com/microsoft/typespec/pull/2945) Empty model after removing metadata and applying visibility always results in "void" + This means the following case have changed from returning `{}` to no body + + ```tsp + op b1(): {}; + op b2(): {@visibility("none") prop: string}; + op b3(): {@added(Versions.v2) prop: string}; + ``` + + Workaround: Use explicit `@body` + + ```tsp + op b1(): {@body _: {}}; + op b2(): {@body _: {@visibility("none") prop: string}}; + op b3(): {@body _: {@added(Versions.v2) prop: string}}; + ``` +- [#2945](https://github.com/microsoft/typespec/pull/2945) Implicit status code always 200 except if response is explicitly `void` + + ```tsp + op c1(): {@header foo: string}; // status code 200 (used to be 204) + ``` + + Solution: Add explicit `@statusCode` + ```tsp + op c1(): {@header foo: string, @statusCode _: 204}; + op c1(): {@header foo: string, ...NoContent}; // or spread common model + ``` +- [#2945](https://github.com/microsoft/typespec/pull/2945) `@body` means this is the body + + This change makes using `@body` mean this is the exact body and everything underneath will be included, including metadata properties. If metadata properties are present on the body, a warning will be logged. + + ```tsp + op a1(): {@body _: {@header foo: string, other: string} }; + ^ warning header in a body, it will not be included as a header. + ``` + + Use `@bodyRoot` if you want to only change where to resolve the body from. + + ```tsp + op a1(): {@bodyRoot _: {@header foo: string, other: string} }; + ``` +- [#2945](https://github.com/microsoft/typespec/pull/2945) Properties are not automatically omitted if everything was removed from metadata or visibility + + ```tsp + op d1(): {headers: {@header foo: string}}; // body will be {headers: {}} + ``` + + Solution: use `@bodyIgnore` + + ```tsp + op d1(): {@bodyIgnore headers: {@header foo: string}}; // body will be {headers: {}} + ``` + + ## 0.55.0 ### Bump dependencies diff --git a/packages/http/package.json b/packages/http/package.json index ab4ace75f0..2374a19257 100644 --- a/packages/http/package.json +++ b/packages/http/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/http", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "TypeSpec HTTP protocol binding", "homepage": "https://github.com/microsoft/typespec", diff --git a/packages/internal-build-utils/CHANGELOG.md b/packages/internal-build-utils/CHANGELOG.md index e129494609..61f39a556b 100644 --- a/packages/internal-build-utils/CHANGELOG.md +++ b/packages/internal-build-utils/CHANGELOG.md @@ -1,5 +1,12 @@ # Change Log - @typespec/internal-build-utils +## 0.56.0 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + + ## 0.55.0 ### Bump dependencies diff --git a/packages/internal-build-utils/package.json b/packages/internal-build-utils/package.json index b31d74ab99..d756edb90b 100644 --- a/packages/internal-build-utils/package.json +++ b/packages/internal-build-utils/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/internal-build-utils", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "Internal library to TypeSpec providing helpers to build.", "homepage": "https://typespec.io", diff --git a/packages/json-schema/CHANGELOG.md b/packages/json-schema/CHANGELOG.md index 06feb2f0ed..4257dc4cbd 100644 --- a/packages/json-schema/CHANGELOG.md +++ b/packages/json-schema/CHANGELOG.md @@ -1,5 +1,12 @@ # Change Log - @typespec/json-schema +## 0.56.0 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + + ## 0.55.0 ### Bump dependencies diff --git a/packages/json-schema/package.json b/packages/json-schema/package.json index 3379e96506..c4ad8cfab6 100644 --- a/packages/json-schema/package.json +++ b/packages/json-schema/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/json-schema", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "TypeSpec library for emitting TypeSpec to JSON Schema and converting JSON Schema to TypeSpec", "homepage": "https://github.com/microsoft/typespec", diff --git a/packages/library-linter/CHANGELOG.md b/packages/library-linter/CHANGELOG.md index c57ef78ad2..b7b9aa3c38 100644 --- a/packages/library-linter/CHANGELOG.md +++ b/packages/library-linter/CHANGELOG.md @@ -1,5 +1,12 @@ # Change Log - @typespec/library-linter +## 0.56.0 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + + ## 0.55.0 ### Bump dependencies diff --git a/packages/library-linter/package.json b/packages/library-linter/package.json index 04b620b932..9ebe225b4d 100644 --- a/packages/library-linter/package.json +++ b/packages/library-linter/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/library-linter", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "TypeSpec library for linting another library.", "homepage": "https://typespec.io", diff --git a/packages/openapi/CHANGELOG.md b/packages/openapi/CHANGELOG.md index 13de8511cc..4f571b03c8 100644 --- a/packages/openapi/CHANGELOG.md +++ b/packages/openapi/CHANGELOG.md @@ -1,5 +1,12 @@ # Change Log - @typespec/openapi +## 0.56.0 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + + ## 0.55.0 ### Bump dependencies diff --git a/packages/openapi/package.json b/packages/openapi/package.json index f4d1e3ebf4..c3afdd5052 100644 --- a/packages/openapi/package.json +++ b/packages/openapi/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/openapi", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "TypeSpec library providing OpenAPI concepts", "homepage": "https://typespec.io", diff --git a/packages/openapi3/CHANGELOG.md b/packages/openapi3/CHANGELOG.md index d599c35acc..7f11a5d073 100644 --- a/packages/openapi3/CHANGELOG.md +++ b/packages/openapi3/CHANGELOG.md @@ -1,5 +1,20 @@ # Change Log - @typespec/openapi3 +## 0.56.0 + +### Bug Fixes + +- [#3218](https://github.com/microsoft/typespec/pull/3218) Fix: `@path` property should be included in unreachable models + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + +### Features + +- [#2945](https://github.com/microsoft/typespec/pull/2945) Add support for new `@bodyRoot` and `@body` distinction + + ## 0.55.0 ### Bug Fixes diff --git a/packages/openapi3/package.json b/packages/openapi3/package.json index 041d6a40d7..a3e1092e45 100644 --- a/packages/openapi3/package.json +++ b/packages/openapi3/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/openapi3", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "TypeSpec library for emitting OpenAPI 3.0 from the TypeSpec REST protocol binding", "homepage": "https://typespec.io", diff --git a/packages/playground/CHANGELOG.md b/packages/playground/CHANGELOG.md index 80dac82f21..954079fd49 100644 --- a/packages/playground/CHANGELOG.md +++ b/packages/playground/CHANGELOG.md @@ -1,5 +1,17 @@ # Change Log - @typespec/playground +## 0.2.2 + +### Bug Fixes + +- [#3170](https://github.com/microsoft/typespec/pull/3170) Add support for new intrinsic vs std lib split in the compiler. +- [#3151](https://github.com/microsoft/typespec/pull/3151) Fix completion of keywords + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + + ## 0.2.1 ### Bug Fixes diff --git a/packages/playground/package.json b/packages/playground/package.json index 59907bb468..f0711337d9 100644 --- a/packages/playground/package.json +++ b/packages/playground/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/playground", - "version": "0.2.1", + "version": "0.2.2", "author": "Microsoft Corporation", "description": "TypeSpec playground UI components.", "homepage": "https://typespec.io", diff --git a/packages/prettier-plugin-typespec/CHANGELOG.md b/packages/prettier-plugin-typespec/CHANGELOG.md index 47d05e7930..f79328c452 100644 --- a/packages/prettier-plugin-typespec/CHANGELOG.md +++ b/packages/prettier-plugin-typespec/CHANGELOG.md @@ -1,5 +1,12 @@ # Change Log - @typespec/prettier-plugin-typespec +## 0.56.0 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + + ## 0.55.0 ### Bump dependencies diff --git a/packages/prettier-plugin-typespec/package.json b/packages/prettier-plugin-typespec/package.json index 3f5453616d..7a20a3a203 100644 --- a/packages/prettier-plugin-typespec/package.json +++ b/packages/prettier-plugin-typespec/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/prettier-plugin-typespec", - "version": "0.55.0", + "version": "0.56.0", "description": "", "main": "dist/index.js", "scripts": { diff --git a/packages/protobuf/CHANGELOG.md b/packages/protobuf/CHANGELOG.md index c90500ca76..000dd63c33 100644 --- a/packages/protobuf/CHANGELOG.md +++ b/packages/protobuf/CHANGELOG.md @@ -1,5 +1,12 @@ # Change Log - @typespec/protobuf +## 0.56.0 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + + ## 0.55.0 ### Bump dependencies diff --git a/packages/protobuf/package.json b/packages/protobuf/package.json index 8b7d78f13e..4d0f870f88 100644 --- a/packages/protobuf/package.json +++ b/packages/protobuf/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/protobuf", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "TypeSpec library and emitter for Protobuf (gRPC)", "homepage": "https://github.com/microsoft/typespec", diff --git a/packages/rest/CHANGELOG.md b/packages/rest/CHANGELOG.md index a72e4d15d7..875ee27ce7 100644 --- a/packages/rest/CHANGELOG.md +++ b/packages/rest/CHANGELOG.md @@ -1,5 +1,16 @@ # Change Log - @typespec/rest +## 0.56.0 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + +### Features + +- [#2945](https://github.com/microsoft/typespec/pull/2945) Add support for new `@bodyRoot` and `@body` distinction + + ## 0.55.0 ### Bump dependencies diff --git a/packages/rest/package.json b/packages/rest/package.json index fa939ff48a..17499ef95f 100644 --- a/packages/rest/package.json +++ b/packages/rest/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/rest", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "TypeSpec REST protocol binding", "homepage": "https://typespec.io", diff --git a/packages/tmlanguage-generator/CHANGELOG.md b/packages/tmlanguage-generator/CHANGELOG.md index 39273bf20a..e7315a6736 100644 --- a/packages/tmlanguage-generator/CHANGELOG.md +++ b/packages/tmlanguage-generator/CHANGELOG.md @@ -1,5 +1,12 @@ # Change Log - tmlanguage-generator +## 0.5.5 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + + ## 0.5.4 ### Bump dependencies diff --git a/packages/tmlanguage-generator/package.json b/packages/tmlanguage-generator/package.json index 049ea01e1f..5898f6bf76 100644 --- a/packages/tmlanguage-generator/package.json +++ b/packages/tmlanguage-generator/package.json @@ -1,6 +1,6 @@ { "name": "tmlanguage-generator", - "version": "0.5.4", + "version": "0.5.5", "author": "Microsoft Corporation", "description": "Helper library to generate TextMate syntax highlighting tmLanguage files.", "homepage": "https://github.com/microsoft/typespec/tree/main/packages/tmlanguage-generator", diff --git a/packages/typespec-vs/CHANGELOG.md b/packages/typespec-vs/CHANGELOG.md index 9fd8c84a5a..f86f34e477 100644 --- a/packages/typespec-vs/CHANGELOG.md +++ b/packages/typespec-vs/CHANGELOG.md @@ -1,5 +1,9 @@ # Change Log - typespec-vs +## 0.56.0 + +No changes, version bump only. + ## 0.55.0 No changes, version bump only. diff --git a/packages/typespec-vs/package.json b/packages/typespec-vs/package.json index b786e811e9..dad8d1449b 100644 --- a/packages/typespec-vs/package.json +++ b/packages/typespec-vs/package.json @@ -1,7 +1,7 @@ { "name": "typespec-vs", "author": "Microsoft Corporation", - "version": "0.55.0", + "version": "0.56.0", "description": "TypeSpec Language Support for Visual Studio", "homepage": "https://typespec.io", "readme": "https://github.com/microsoft/typespec/blob/main/README.md", diff --git a/packages/typespec-vscode/CHANGELOG.md b/packages/typespec-vscode/CHANGELOG.md index e35a28540c..a83e84ea3b 100644 --- a/packages/typespec-vscode/CHANGELOG.md +++ b/packages/typespec-vscode/CHANGELOG.md @@ -1,5 +1,12 @@ # Change Log - typespec-vscode +## 0.56.0 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + + ## 0.55.0 ### Bump dependencies diff --git a/packages/typespec-vscode/package.json b/packages/typespec-vscode/package.json index 4adbd889bd..87031c3f1e 100644 --- a/packages/typespec-vscode/package.json +++ b/packages/typespec-vscode/package.json @@ -1,6 +1,6 @@ { "name": "typespec-vscode", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "TypeSpec language support for VS Code", "homepage": "https://typespec.io", diff --git a/packages/versioning/CHANGELOG.md b/packages/versioning/CHANGELOG.md index 105e2a1d9a..7474646caf 100644 --- a/packages/versioning/CHANGELOG.md +++ b/packages/versioning/CHANGELOG.md @@ -1,5 +1,16 @@ # Change Log - @typespec/versioning +## 0.56.0 + +### Bug Fixes + +- [#3264](https://github.com/microsoft/typespec/pull/3264) Fix crash when `@service` appears inside a versioned namespace + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + + ## 0.55.0 ### Bump dependencies diff --git a/packages/versioning/package.json b/packages/versioning/package.json index 75bcf6a8a3..af0d95eb06 100644 --- a/packages/versioning/package.json +++ b/packages/versioning/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/versioning", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "TypeSpec library for declaring and emitting versioned APIs", "homepage": "https://typespec.io", diff --git a/packages/website/playground-versions.json b/packages/website/playground-versions.json index d2445f1649..2c0d89df86 100644 --- a/packages/website/playground-versions.json +++ b/packages/website/playground-versions.json @@ -1,4 +1,5 @@ [ + "0.56.x", "0.55.x", "0.54.x", "0.53.x", diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/data-types.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/data-types.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/data-types.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/data-types.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/decorators.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/decorators.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/decorators.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/decorators.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/emitter.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/emitter.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/emitter.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/emitter.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/index.mdx b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/index.mdx similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/index.mdx rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/index.mdx diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/_category_.json b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/_category_.json similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/_category_.json rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/_category_.json diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/classes/JsonSchemaEmitter.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/classes/JsonSchemaEmitter.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/classes/JsonSchemaEmitter.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/classes/JsonSchemaEmitter.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$baseUri.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$baseUri.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$baseUri.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$baseUri.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$contains.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$contains.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$contains.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$contains.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$contentEncoding.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$contentEncoding.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$contentEncoding.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$contentEncoding.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$contentMediaType.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$contentMediaType.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$contentMediaType.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$contentMediaType.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$contentSchema.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$contentSchema.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$contentSchema.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$contentSchema.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$extension.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$extension.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$extension.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$extension.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$id.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$id.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$id.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$id.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$jsonSchema.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$jsonSchema.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$jsonSchema.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$jsonSchema.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$maxContains.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$maxContains.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$maxContains.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$maxContains.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$maxProperties.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$maxProperties.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$maxProperties.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$maxProperties.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$minContains.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$minContains.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$minContains.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$minContains.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$minProperties.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$minProperties.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$minProperties.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$minProperties.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$multipleOf.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$multipleOf.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$multipleOf.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$multipleOf.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$onEmit.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$onEmit.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$onEmit.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$onEmit.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$prefixItems.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$prefixItems.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$prefixItems.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$prefixItems.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$uniqueItems.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$uniqueItems.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$uniqueItems.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$uniqueItems.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$validatesRawJson.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$validatesRawJson.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/$validatesRawJson.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/$validatesRawJson.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/findBaseUri.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/findBaseUri.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/findBaseUri.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/findBaseUri.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getBaseUri.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getBaseUri.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getBaseUri.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getBaseUri.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getContains.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getContains.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getContains.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getContains.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getContentEncoding.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getContentEncoding.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getContentEncoding.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getContentEncoding.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getContentMediaType.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getContentMediaType.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getContentMediaType.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getContentMediaType.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getContentSchema.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getContentSchema.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getContentSchema.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getContentSchema.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getExtensions.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getExtensions.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getExtensions.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getExtensions.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getId.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getId.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getId.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getId.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getJsonSchema.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getJsonSchema.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getJsonSchema.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getJsonSchema.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getJsonSchemaTypes.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getJsonSchemaTypes.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getJsonSchemaTypes.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getJsonSchemaTypes.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getMaxContains.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getMaxContains.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getMaxContains.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getMaxContains.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getMaxProperties.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getMaxProperties.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getMaxProperties.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getMaxProperties.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getMinContains.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getMinContains.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getMinContains.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getMinContains.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getMinProperties.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getMinProperties.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getMinProperties.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getMinProperties.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getMultipleOf.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getMultipleOf.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getMultipleOf.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getMultipleOf.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getPrefixItems.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getPrefixItems.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getPrefixItems.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getPrefixItems.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getUniqueItems.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getUniqueItems.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/getUniqueItems.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/getUniqueItems.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/isJsonSchemaDeclaration.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/isJsonSchemaDeclaration.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/functions/isJsonSchemaDeclaration.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/functions/isJsonSchemaDeclaration.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/index.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/index.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/index.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/index.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/interfaces/ExtensionRecord.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/interfaces/ExtensionRecord.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/interfaces/ExtensionRecord.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/interfaces/ExtensionRecord.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/interfaces/JSONSchemaEmitterOptions.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/interfaces/JSONSchemaEmitterOptions.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/interfaces/JSONSchemaEmitterOptions.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/interfaces/JSONSchemaEmitterOptions.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/type-aliases/JsonSchemaDeclaration.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/type-aliases/JsonSchemaDeclaration.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/type-aliases/JsonSchemaDeclaration.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/type-aliases/JsonSchemaDeclaration.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/variables/$lib.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/variables/$lib.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/variables/$lib.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/variables/$lib.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/variables/EmitterOptionsSchema.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/variables/EmitterOptionsSchema.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/variables/EmitterOptionsSchema.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/variables/EmitterOptionsSchema.md diff --git a/packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/variables/namespace.md b/packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/variables/namespace.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/json-schema/reference/js-api/variables/namespace.md rename to packages/website/versioned_docs/version-latest/emitters/json-schema/reference/js-api/variables/namespace.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/diagnostics.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/diagnostics.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/diagnostics.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/diagnostics.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/openapi.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/openapi.md similarity index 92% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/openapi.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/openapi.md index 1c87f0fec7..1a04c8b798 100644 --- a/packages/website/versioned_docs/version-latest/libraries/openapi3/openapi.md +++ b/packages/website/versioned_docs/version-latest/emitters/openapi3/openapi.md @@ -8,7 +8,7 @@ The OpenAPI emitter is designed to translate TypeSpec language elements into the ## Server Details -If the TypeSpec file includes an [(Http) `@server` decorator](../http/reference/decorators.md#@TypeSpec.Http.server), the OpenAPI emitter will create a `servers` object. This object will contain the server URL, description, and variables as defined in the decorator. +If the TypeSpec file includes an [(Http) `@server` decorator](../../libraries/http/reference/decorators.md#@TypeSpec.Http.server), the OpenAPI emitter will create a `servers` object. This object will contain the server URL, description, and variables as defined in the decorator. You can use multiple `@server` decorators to generate multiple entries in the `servers` object. @@ -20,8 +20,8 @@ The HTTP method for the operation can be explicitly defined using an [(Http) `@g The operation's path is derived from the [(Http) `@route` decorator][http-route-decorator] on the operation. The `@route` decorator can also be applied to a namespace and/or an interface (a group of operations). If specified, the route for the enclosing namespace(s) and interface are prefixed to the operation route. -[http-verb-decorators]: ../http/reference/decorators.md -[http-route-decorator]: ../http/reference/decorators.md#@TypeSpec.Http.route +[http-verb-decorators]: ../../libraries/http/reference/decorators.md +[http-route-decorator]: ../../libraries/http/reference/decorators.md#@TypeSpec.Http.route The [OpenAPI Operation object][] fields are set as described below. @@ -51,8 +51,8 @@ The `in` field of a parameter is defined using an [(Http) `@query`, `@header`, o The request body parameter can also be explicitly defined with an [(Http) `@body` decorator][http-body-decorator]. If `@body` is not explicitly defined, the set of parameters that are not marked `@header`, `@query`, or `@path` form the request body, which is defined as required. If the request body should be optional, it must be declared as an optional property with the `@body` decorator. -[http-parameter-decorators]: ../http/reference/decorators.md -[http-body-decorator]: ../http/reference/decorators.md#@TypeSpec.Http.body +[http-parameter-decorators]: ../../libraries/http/reference/decorators.md +[http-body-decorator]: ../../libraries/http/reference/decorators.md#@TypeSpec.Http.body The content of a (built-in) `@doc` decorator on a parameter will be set in the description. @@ -60,7 +60,7 @@ The TypeSpec parameter type will be translated into an appropriate OpenAPI schem Similarly, the type of the body parameter(s) will be translated into an appropriate OpenAPI schema for the request body. The request body will use the "application/json" media type unless the body model includes an explicit `content-type` header. -For more advanced details, see [metadata](../http/operations.md#metadata). +For more advanced details, see [metadata](../../libraries/http/operations.md#metadata). ### Responses @@ -68,10 +68,10 @@ The return type(s) of the TypeSpec operation are translated into responses for t When a return type model has a property explicitly decorated with an [(Http) `@body` decorator][http-body-decorator], this is considered as the response body. In the absence of an explicit `@body`, the properties that are not marked `@statusCode` or `@header` form the response body. -[http-statuscode-decorator]: ../http/reference/decorators.md#@TypeSpec.Http.statusCode +[http-statuscode-decorator]: ../../libraries/http/reference/decorators.md#@TypeSpec.Http.statusCode [error-decorator]: ../../standard-library/built-in-decorators.md#@error -For more advanced details, see [metadata](../http/operations.md#metadata). +For more advanced details, see [metadata](../../libraries/http/operations.md#metadata). ### Tags @@ -87,11 +87,11 @@ If the [(built-in) `#deprecated` directive][deprecated-decorator] is specified o ### External Documentation -If the TypeSpec operation has an [(OpenAPI) `@externalDocs` decorator](../openapi/reference/decorators.md#@TypeSpec.OpenAPI.externalDocs), this will generate an externalDocs field in the OpenAPI operation. +If the TypeSpec operation has an [(OpenAPI) `@externalDocs` decorator](../../libraries/openapi/reference/decorators.md#@TypeSpec.OpenAPI.externalDocs), this will generate an externalDocs field in the OpenAPI operation. ### Specification Extensions -Any extensions specified on the TypeSpec operation with the [(OpenAPI) `@extension` decorator](../openapi/reference/decorators.md#@TypeSpec.OpenAPI.extension) are included in the emitted OpenAPI operation. +Any extensions specified on the TypeSpec operation with the [(OpenAPI) `@extension` decorator](../../libraries/openapi/reference/decorators.md#@TypeSpec.OpenAPI.extension) are included in the emitted OpenAPI operation. ## Models and Enums @@ -251,7 +251,7 @@ When working with the `@encode` decorator, the rule is as follows. Given the 3 v ## Security Definitions -The OpenAPI emitter uses the [(http) `@useAuth` decorator](../http/reference/decorators.md#@TypeSpec.Http.useAuth) to handle security definitions. +The OpenAPI emitter uses the [(http) `@useAuth` decorator](../../libraries/http/reference/decorators.md#@TypeSpec.Http.useAuth) to handle security definitions. ### Examples diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/decorators.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/decorators.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/decorators.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/decorators.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/emitter.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/emitter.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/emitter.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/emitter.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/index.mdx b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/index.mdx similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/index.mdx rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/index.mdx diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/_category_.json b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/_category_.json similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/_category_.json rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/_category_.json diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/$onEmit.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/$onEmit.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/$onEmit.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/$onEmit.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/$oneOf.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/$oneOf.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/$oneOf.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/$oneOf.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/$useRef.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/$useRef.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/$useRef.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/$useRef.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/getOneOf.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/getOneOf.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/getOneOf.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/getOneOf.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/getOpenAPI3.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/getOpenAPI3.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/getOpenAPI3.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/getOpenAPI3.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/getRef.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/getRef.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/getRef.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/getRef.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/resolveOptions.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/resolveOptions.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/functions/resolveOptions.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/functions/resolveOptions.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/index.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/index.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/index.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/index.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/interfaces/ResolvedOpenAPI3EmitterOptions.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/interfaces/ResolvedOpenAPI3EmitterOptions.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/interfaces/ResolvedOpenAPI3EmitterOptions.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/interfaces/ResolvedOpenAPI3EmitterOptions.md diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/variables/$lib.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/variables/$lib.md similarity index 94% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/variables/$lib.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/variables/$lib.md index cd4f8dca4b..5b54375a74 100644 --- a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/variables/$lib.md +++ b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/variables/$lib.md @@ -11,8 +11,6 @@ const $lib: TypeSpecLibrary; | Member | Type | Value | | :------ | :------ | :------ | -| `duplicate-body` | `Object` | - | -| `duplicate-body.default` | `"Duplicate @body declarations on response type"` | "Duplicate @body declarations on response type" | | `duplicate-header` | `Object` | - | | `duplicate-header.default` | `CallableMessage`<[`"header"`]\> | - | | `empty-enum` | `Object` | - | diff --git a/packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/variables/namespace.md b/packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/variables/namespace.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/openapi3/reference/js-api/variables/namespace.md rename to packages/website/versioned_docs/version-latest/emitters/openapi3/reference/js-api/variables/namespace.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/guide.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/guide.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/guide.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/guide.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/data-types.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/data-types.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/data-types.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/data-types.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/decorators.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/decorators.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/decorators.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/decorators.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/emitter.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/emitter.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/emitter.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/emitter.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/index.mdx b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/index.mdx similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/index.mdx rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/index.mdx diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/_category_.json b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/_category_.json similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/_category_.json rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/_category_.json diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$externRef.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$externRef.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$externRef.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$externRef.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$field.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$field.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$field.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$field.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$message.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$message.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$message.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$message.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$onEmit.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$onEmit.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$onEmit.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$onEmit.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$onValidate.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$onValidate.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$onValidate.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$onValidate.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$package.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$package.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$package.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$package.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$reserve.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$reserve.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$reserve.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$reserve.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$service.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$service.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$service.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$service.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$stream.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$stream.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/$stream.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/$stream.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/isMap.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/isMap.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/functions/isMap.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/functions/isMap.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/index.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/index.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/index.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/index.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/interfaces/PackageDetails.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/interfaces/PackageDetails.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/interfaces/PackageDetails.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/interfaces/PackageDetails.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/type-aliases/Reservation.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/type-aliases/Reservation.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/type-aliases/Reservation.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/type-aliases/Reservation.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/variables/$lib.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/variables/$lib.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/variables/$lib.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/variables/$lib.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/variables/PROTO_FULL_IDENT.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/variables/PROTO_FULL_IDENT.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/variables/PROTO_FULL_IDENT.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/variables/PROTO_FULL_IDENT.md diff --git a/packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/variables/namespace.md b/packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/variables/namespace.md similarity index 100% rename from packages/website/versioned_docs/version-latest/libraries/protobuf/reference/js-api/variables/namespace.md rename to packages/website/versioned_docs/version-latest/emitters/protobuf/reference/js-api/variables/namespace.md diff --git a/packages/website/versioned_docs/version-latest/getting-started/getting-started-http.md b/packages/website/versioned_docs/version-latest/getting-started/getting-started-http.md index d665ce43c2..72de51b7a2 100644 --- a/packages/website/versioned_docs/version-latest/getting-started/getting-started-http.md +++ b/packages/website/versioned_docs/version-latest/getting-started/getting-started-http.md @@ -11,7 +11,7 @@ References: - [HTTP library](../libraries/http/reference) - [REST library](../libraries/rest/reference) -- [OpenAPI 3 emitter](../libraries/openapi3/reference) +- [OpenAPI 3 emitter](../emitters/openapi3/reference) ## Setup diff --git a/packages/website/versioned_docs/version-latest/language-basics/namespaces.md b/packages/website/versioned_docs/version-latest/language-basics/namespaces.md index 112f35a45d..5ac0a71022 100644 --- a/packages/website/versioned_docs/version-latest/language-basics/namespaces.md +++ b/packages/website/versioned_docs/version-latest/language-basics/namespaces.md @@ -93,6 +93,6 @@ namespace Two { alias B = A; // This is valid } -alias C = One.A; // This is not valid +alias C = Two.A; // This is not valid alias C = Two.B; // This is valid ``` diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/data-types.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/data-types.md index 35dfc10b30..109a8f8373 100644 --- a/packages/website/versioned_docs/version-latest/libraries/http/reference/data-types.md +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/data-types.md @@ -416,12 +416,12 @@ model TypeSpec.Http.PasswordFlow #### Properties -| Name | Type | Description | -| ---------------- | --------------------------------------- | --------------------------------- | -| type | `TypeSpec.Http.OAuth2FlowType.password` | password flow | -| authorizationUrl | `string` | the authorization URL | -| refreshUrl? | `string` | the refresh URL | -| scopes? | `string[]` | list of scopes for the credential | +| Name | Type | Description | +| ----------- | --------------------------------------- | --------------------------------- | +| type | `TypeSpec.Http.OAuth2FlowType.password` | password flow | +| tokenUrl | `string` | the token URL | +| refreshUrl? | `string` | the refresh URL | +| scopes? | `string[]` | list of scopes for the credential | ### `PlainData` {#TypeSpec.Http.PlainData} diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/decorators.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/decorators.md index f9025ae3ba..2996c91707 100644 --- a/packages/website/versioned_docs/version-latest/libraries/http/reference/decorators.md +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/decorators.md @@ -10,7 +10,10 @@ toc_max_heading_level: 3 ### `@body` {#@TypeSpec.Http.body} -Explicitly specify that this property is to be set as the body +Explicitly specify that this property type will be exactly the HTTP body. + +This means that any properties under `@body` cannot be marked as headers, query parameters, or path parameters. +If wanting to change the resolution of the body but still mix parameters, use `@bodyRoot`. ```typespec @TypeSpec.Http.body @@ -33,6 +36,69 @@ op download(): { }; ``` +### `@bodyIgnore` {#@TypeSpec.Http.bodyIgnore} + +Specify that this property shouldn't be included in the HTTP body. +This can be useful when bundling metadata together that would result in an empty property to be included in the body. + +```typespec +@TypeSpec.Http.bodyIgnore +``` + +#### Target + +`ModelProperty` + +#### Parameters + +None + +#### Examples + +```typespec +op upload( + name: string, + @bodyIgnore headers: { + @header id: string; + }, +): void; +``` + +### `@bodyRoot` {#@TypeSpec.Http.bodyRoot} + +Specify that the body resolution should be resolved from that property. +By default the body is resolved by including all properties in the operation request/response that are not metadata. +This allows to nest the body in a property while still allowing to use headers, query parameters, and path parameters in the same model. + +```typespec +@TypeSpec.Http.bodyRoot +``` + +#### Target + +`ModelProperty` + +#### Parameters + +None + +#### Examples + +```typespec +op upload( + @bodyRoot user: { + name: string; + @header id: string; + }, +): void; +op download(): { + @bodyRoot user: { + name: string; + @header id: string; + }; +}; +``` + ### `@delete` {#@TypeSpec.Http.delete} Specify the HTTP verb for the target operation to be `DELETE`. diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/index.mdx b/packages/website/versioned_docs/version-latest/libraries/http/reference/index.mdx index 035944359b..ec9a88f52e 100644 --- a/packages/website/versioned_docs/version-latest/libraries/http/reference/index.mdx +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/index.mdx @@ -36,6 +36,8 @@ npm install --save-peer @typespec/http ### Decorators - [`@body`](./decorators.md#@TypeSpec.Http.body) +- [`@bodyIgnore`](./decorators.md#@TypeSpec.Http.bodyIgnore) +- [`@bodyRoot`](./decorators.md#@TypeSpec.Http.bodyRoot) - [`@delete`](./decorators.md#@TypeSpec.Http.delete) - [`@get`](./decorators.md#@TypeSpec.Http.get) - [`@head`](./decorators.md#@TypeSpec.Http.head) diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/$bodyIgnore.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/$bodyIgnore.md new file mode 100644 index 0000000000..2260d9400e --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/$bodyIgnore.md @@ -0,0 +1,19 @@ +--- +jsApi: true +title: "[F] $bodyIgnore" + +--- +```ts +$bodyIgnore(context, target): void +``` + +## Parameters + +| Parameter | Type | +| :------ | :------ | +| `context` | `DecoratorContext` | +| `target` | `ModelProperty` | + +## Returns + +`void` diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/$bodyRoot.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/$bodyRoot.md new file mode 100644 index 0000000000..4910da0e7b --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/$bodyRoot.md @@ -0,0 +1,19 @@ +--- +jsApi: true +title: "[F] $bodyRoot" + +--- +```ts +$bodyRoot(context, target): void +``` + +## Parameters + +| Parameter | Type | +| :------ | :------ | +| `context` | `DecoratorContext` | +| `target` | `ModelProperty` | + +## Returns + +`void` diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/isBodyIgnore.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/isBodyIgnore.md new file mode 100644 index 0000000000..b0b5551c10 --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/isBodyIgnore.md @@ -0,0 +1,19 @@ +--- +jsApi: true +title: "[F] isBodyIgnore" + +--- +```ts +isBodyIgnore(program, entity): boolean +``` + +## Parameters + +| Parameter | Type | +| :------ | :------ | +| `program` | `Program` | +| `entity` | `ModelProperty` | + +## Returns + +`boolean` diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/isBodyRoot.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/isBodyRoot.md new file mode 100644 index 0000000000..66394bdd05 --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/functions/isBodyRoot.md @@ -0,0 +1,19 @@ +--- +jsApi: true +title: "[F] isBodyRoot" + +--- +```ts +isBodyRoot(program, entity): boolean +``` + +## Parameters + +| Parameter | Type | +| :------ | :------ | +| `program` | `Program` | +| `entity` | `ModelProperty` | + +## Returns + +`boolean` diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/index.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/index.md index f379ce4c07..f543db785e 100644 --- a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/index.md +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/index.md @@ -26,6 +26,7 @@ title: "[P] JS API" - [HttpOperationParameters](interfaces/HttpOperationParameters.md) - [HttpOperationRequestBody](interfaces/HttpOperationRequestBody.md) - [HttpOperationResponse](interfaces/HttpOperationResponse.md) +- [HttpOperationResponseBody](interfaces/HttpOperationResponseBody.md) - [HttpOperationResponseContent](interfaces/HttpOperationResponseContent.md) - [HttpServer](interfaces/HttpServer.md) - [HttpService](interfaces/HttpService.md) @@ -75,6 +76,8 @@ title: "[P] JS API" ## Functions - [$body](functions/$body.md) +- [$bodyIgnore](functions/$bodyIgnore.md) +- [$bodyRoot](functions/$bodyRoot.md) - [$delete](functions/$delete.md) - [$get](functions/$get.md) - [$head](functions/$head.md) @@ -125,6 +128,8 @@ title: "[P] JS API" - [isApplicableMetadata](functions/isApplicableMetadata.md) - [isApplicableMetadataOrBody](functions/isApplicableMetadataOrBody.md) - [isBody](functions/isBody.md) +- [isBodyIgnore](functions/isBodyIgnore.md) +- [isBodyRoot](functions/isBodyRoot.md) - [isContentTypeHeader](functions/isContentTypeHeader.md) - [isHeader](functions/isHeader.md) - [isMetadata](functions/isMetadata.md) diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationBody.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationBody.md index d510e34ce1..8af6a3298d 100644 --- a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationBody.md +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationBody.md @@ -6,10 +6,13 @@ title: "[I] HttpOperationBody" ## Extended by - [`HttpOperationRequestBody`](HttpOperationRequestBody.md) +- [`HttpOperationResponseBody`](HttpOperationResponseBody.md) ## Properties -| Property | Type | Description | -| :------ | :------ | :------ | -| `contentTypes` | `string`[] | Content types. | -| `type` | `Type` | Type of the operation body. | +| Property | Modifier | Type | Description | +| :------ | :------ | :------ | :------ | +| `containsMetadataAnnotations` | `readonly` | `boolean` | If the body contains metadata annotations to ignore. For example `@header`. | +| `contentTypes` | `public` | `string`[] | Content types. | +| `isExplicit` | `readonly` | `boolean` | If the body was explicitly set with `@body`. | +| `type` | `public` | `Type` | Type of the operation body. | diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationRequestBody.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationRequestBody.md index bf571d1107..6523a4bafa 100644 --- a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationRequestBody.md +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationRequestBody.md @@ -15,8 +15,10 @@ the `type` must be a `Model` if the content type is multipart. ## Properties -| Property | Type | Description | Inherited from | -| :------ | :------ | :------ | :------ | -| `contentTypes` | `string`[] | Content types. | [`HttpOperationBody`](HttpOperationBody.md).`contentTypes` | -| `parameter?` | `ModelProperty` | If the body was explicitly set as a property. Correspond to the property with `@body` | - | -| `type` | `Type` | Type of the operation body. | [`HttpOperationBody`](HttpOperationBody.md).`type` | +| Property | Modifier | Type | Description | Inherited from | +| :------ | :------ | :------ | :------ | :------ | +| `containsMetadataAnnotations` | `readonly` | `boolean` | If the body contains metadata annotations to ignore. For example `@header`. | [`HttpOperationBody`](HttpOperationBody.md).`containsMetadataAnnotations` | +| `contentTypes` | `public` | `string`[] | Content types. | [`HttpOperationBody`](HttpOperationBody.md).`contentTypes` | +| `isExplicit` | `readonly` | `boolean` | If the body was explicitly set with `@body`. | [`HttpOperationBody`](HttpOperationBody.md).`isExplicit` | +| `parameter?` | `public` | `ModelProperty` | If the body was explicitly set as a property. Correspond to the property with `@body` or `@bodyRoot` | - | +| `type` | `public` | `Type` | Type of the operation body. | [`HttpOperationBody`](HttpOperationBody.md).`type` | diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationResponseBody.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationResponseBody.md new file mode 100644 index 0000000000..a72c350b0c --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationResponseBody.md @@ -0,0 +1,18 @@ +--- +jsApi: true +title: "[I] HttpOperationResponseBody" + +--- +## Extends + +- [`HttpOperationBody`](HttpOperationBody.md) + +## Properties + +| Property | Modifier | Type | Description | Inherited from | +| :------ | :------ | :------ | :------ | :------ | +| `containsMetadataAnnotations` | `readonly` | `boolean` | If the body contains metadata annotations to ignore. For example `@header`. | [`HttpOperationBody`](HttpOperationBody.md).`containsMetadataAnnotations` | +| `contentTypes` | `public` | `string`[] | Content types. | [`HttpOperationBody`](HttpOperationBody.md).`contentTypes` | +| `isExplicit` | `readonly` | `boolean` | If the body was explicitly set with `@body`. | [`HttpOperationBody`](HttpOperationBody.md).`isExplicit` | +| `property?` | `readonly` | `ModelProperty` | If the body was explicitly set as a property. Correspond to the property with `@body` or `@bodyRoot` | - | +| `type` | `public` | `Type` | Type of the operation body. | [`HttpOperationBody`](HttpOperationBody.md).`type` | diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationResponseContent.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationResponseContent.md index 076955dcc3..f995cae603 100644 --- a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationResponseContent.md +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/HttpOperationResponseContent.md @@ -7,5 +7,5 @@ title: "[I] HttpOperationResponseContent" | Property | Type | | :------ | :------ | -| `body?` | [`HttpOperationBody`](HttpOperationBody.md) | +| `body?` | [`HttpOperationResponseBody`](HttpOperationResponseBody.md) | | `headers?` | `Record`<`string`, `ModelProperty`\> | diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/MetadataInfo.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/MetadataInfo.md index d7b0b49ae5..82336e1937 100644 --- a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/MetadataInfo.md +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/interfaces/MetadataInfo.md @@ -32,7 +32,7 @@ same set of properties when non-payload properties are excluded. *** -### isEmptied() +### ~~isEmptied()~~ ```ts isEmptied(type, visibility): boolean @@ -58,6 +58,10 @@ itself is also removed. `boolean` +#### Deprecated + +This produces inconsistent behaviors and should be avoided. + *** ### isOptional() @@ -85,7 +89,10 @@ response payload for the given visibility. ### isPayloadProperty() ```ts -isPayloadProperty(property, visibility): boolean +isPayloadProperty( + property, + visibility, + inExplicitBody?): boolean ``` Determines if the given property is part of the request or response @@ -98,6 +105,7 @@ filtered out by the given visibility. | :------ | :------ | | `property` | `ModelProperty` | | `visibility` | [`Visibility`](../enumerations/Visibility.md) | +| `inExplicitBody`? | `boolean` | #### Returns diff --git a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/variables/$lib.md b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/variables/$lib.md index 29faf395a0..58ef9ddd5a 100644 --- a/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/variables/$lib.md +++ b/packages/website/versioned_docs/version-latest/libraries/http/reference/js-api/variables/$lib.md @@ -11,6 +11,8 @@ const $lib: TypeSpecLibrary, | "path" | "query" | "authentication" + | "bodyRoot" + | "bodyIgnore" | "verbs" | "servers" | "includeInapplicableMetadataInPayload" @@ -45,6 +47,8 @@ const $lib: TypeSpecLibrary, | `http-verb-wrong-type.default` | `CallableMessage`<[`string`, `string`]\> | - | | `invalid-type-for-auth` | `Object` | - | | `invalid-type-for-auth.default` | `CallableMessage`<[`string`]\> | - | +| `metadata-ignored` | `Object` | - | +| `metadata-ignored.default` | `CallableMessage`<[`string`]\> | - | | `missing-path-param` | `Object` | - | | `missing-path-param.default` | `CallableMessage`<[`string`]\> | - | | `missing-server-param` | `Object` | - | diff --git a/packages/website/versioned_docs/version-latest/libraries/versioning/reference/js-api/functions/resolveVersions.md b/packages/website/versioned_docs/version-latest/libraries/versioning/reference/js-api/functions/resolveVersions.md index 7d2a52fb75..517dd64bf3 100644 --- a/packages/website/versioned_docs/version-latest/libraries/versioning/reference/js-api/functions/resolveVersions.md +++ b/packages/website/versioned_docs/version-latest/libraries/versioning/reference/js-api/functions/resolveVersions.md @@ -4,7 +4,7 @@ title: "[F] resolveVersions" --- ```ts -resolveVersions(program, rootNs): VersionResolution[] +resolveVersions(program, namespace): VersionResolution[] ``` Resolve the version to use for all namespace for each of the root namespace versions. @@ -14,7 +14,7 @@ Resolve the version to use for all namespace for each of the root namespace vers | Parameter | Type | Description | | :------ | :------ | :------ | | `program` | `Program` | | -| `rootNs` | `Namespace` | Root namespace. | +| `namespace` | `Namespace` | - | ## Returns diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/guide.md b/packages/website/versioned_docs/version-latest/libraries/xml/guide.md new file mode 100644 index 0000000000..f7860abe97 --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/guide.md @@ -0,0 +1,948 @@ +--- +title: Guide +--- + +# Xml Library + +## Default encoding of scalars + +As in Json we have some [default handling](https://typespec.io/docs/libraries/http/encoding#bytes) of the common scalars like `utcDateTime` + +| Scalar Type | Default Encoding | Encoding name | +| ---------------- | ----------------- | --------------------------------------- | +| `utcDateTime` | `xs:dateTime` | `TypeSpec.Xml.Encoding.xmlDateTime` | +| `offsetDateTime` | `xs:dateTime` | `TypeSpec.Xml.Encoding.xmlDateTime` | +| `plainDate` | `xs:date` | `TypeSpec.Xml.Encoding.xmlDate` | +| `plainTime` | `xs:time` | `TypeSpec.Xml.Encoding.xmlTime` | +| `duration` | `xs:duration` | `TypeSpec.Xml.Encoding.xmlDuration` | +| `bytes` | `xs:base64Binary` | `TypeSpec.Xml.Encoding.xmlBase64Binary` | + +## Examples + +### 1. Array of primitive types + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
TypeSpecXmlOpenAPI3
+ +```tsp +@encodedName("application/xml", "XmlPet") +model Pet { + @xml.unwrapped + tags: string[]; +} +``` + + + +```xml + + abc + def + +``` + + + +```yaml +Pet: + type: "object" + properties: + tags: + type: "array" + items: + type: string + xml: + name: "XmlPet" +``` + +
+ +```tsp +@encodedName("application/xml", "XmlPet") +model Pet { + @encodedName("application/xml", "ItemsTags") + tags: string[]; +} +``` + + + +```xml + + + abc + def + + +``` + + + +```yaml +Pet: + type: "object" + properties: + tags: + type: "array" + xml: + name: "ItemsTags" + wrapped: true + items: + type: string + xml: + name: "XmlPet" +``` + +
+ +```tsp +@encodedName("application/xml", "ItemsName") +scalar tag extends string; + +@encodedName("application/xml", "XmlPet") +model Pet { + @xml.unwrapped + tags: tag[]; +} +``` + + + +```xml + + abc + def + +``` + + + +```yaml +Pet: + type: "object" + properties: + tags: + type: "array" + xml: + name: "ItemsTags" + items: + type: string + xml: + name: ItemsName + xml: + name: "XmlPet" +``` + +
+ +```tsp +@encodedName("application/xml", "ItemsName") +scalar tag extends string; + +@encodedName("application/xml", "XmlPet") +model Pet { + @encodedName("application/xml", "ItemsTags") + tags: tag[]; +} +``` + + + +```xml + + + abc + def + + +``` + + + +```yaml +Pet: + type: "object" + properties: + tags: + type: "array" + xml: + name: "ItemsTags" + wrapped: true + items: + type: string + xml: + name: ItemsName + xml: + name: "XmlPet" +``` + +
+ +### 2. Complex array types + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
TypeSpecXmlOpenAPI3
+ +```tsp +@encodedName("application/xml", "XmlPet") +model Pet { + @xml.unwrapped + tags: Tag[]; +} + +@encodedName("application/xml", "XmlTag") +model Tag { + name: string; +} +``` + + + +```xml + + + string + + +``` + + + +```yaml +Tag: + type: "object" + properties: + name: + type: "string" + xml: + name: "XmlTag" +Pet: + type: "object" + properties: + tags: + type: "array" + items: + $ref: "#/definitions/Tag" + xml: + name: "XmlPet" +``` + +
+ +```tsp +@encodedName("application/xml", "XmlPet") +model Pet { + tags: Tag[]; +} + +@encodedName("application/xml", "XmlTag") +model Tag { + name: string; +} +``` + + + +```xml + + + + string + + + +``` + + + +```yaml +Tag: + type: "object" + properties: + name: + type: "string" + xml: + name: "XmlTag" +Pet: + type: "object" + properties: + tags: + type: "array" + xml: + name: "ItemsTags" + wrapped: true + items: + $ref: "#/definitions/Tag" + xml: + name: "XmlPet" +``` + +
+ +```tsp +@encodedName("application/xml", "XmlPet") +model Pet { + @encodedName("application/xml", "ItemsTags") + @xml.unwrapped + tags: Tag[]; +} + +@encodedName("application/xml", "XmlTag") +model Tag { + name: string; +} +``` + + + +```xml + + + string + + +``` + + + +```yaml +Tag: + type: "object" + properties: + name: + type: "string" + xml: + name: "XmlTag" + Pet: + type: "object" + properties: + tags: + type: "array" + xml: + name: "ItemsTags" + items: + $ref: "#/definitions/Tag" + xml: + name: ItemsXMLName + xml: + name: "XmlPet" +``` + +
+ +```tsp +@encodedName("application/xml", "XmlPet") +model Pet { + @encodedName("application/xml", "ItemsTags") + tags: Tag[]; +} + +@encodedName("application/xml", "XmlTag") +model Tag { + name: string; +} +``` + + + +```xml + + + + string + + + +``` + + + +```yaml +Tag: + type: "object" + properties: + name: + type: "string" +Pet: + type: "object" + properties: + tags: + type: "array" + xml: + name: "ItemsTags" + wrapped: true + items: + $ref: "#/definitions/Tag" + xml: + name: "XmlPet" +``` + +
+ +### 3. Nested models + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
TypeSpecXmlOpenAPI3
+ +```tsp +model Book { + author: Author; +} + +model Author { + name: string; +} +``` + + + +```xml + + + string + + +``` + + + +```yaml +Book: + type: object + properties: + author: + $ref: "#/components/schemas/Author" +Author: + type: object + properties: + name: + type: string +``` + +
+ +```tsp +model Book { + author: Author; +} + +@encodedName("application/xml", "XmlAuthor") +model Author { + name: string; +} +``` + + + +```xml + + + string + + +``` + + + +```yaml +Book: + type: object + properties: + author: + allOf: + - $ref: "#/components/schemas/Author" + xml: + name: "author" # Here we have to redefine this name otherwise in OpenAPI semantic the `XmlAuthor` name would be used +Author: + type: object + properties: + name: + type: string + xml: + name: "XmlAuthor" +``` + +
+ +```tsp +model Book { + @encodedName("application/xml", "xml-author") + author: Author; +} + +model Author { + name: string; +} +``` + + + +```xml + + + string + + +``` + + + +```yaml +Book: + type: object + properties: + author: + allOf: + - $ref: "#/components/schemas/Author" + xml: + name: "xml-author" +Author: + type: object + properties: + name: + type: string +``` + +
+ +### 4. Attributes + + + + + + + + + + + + + + + + + +
TypeSpecXmlOpenAPI3
+ +```tsp +model Book { + @Xml.attribute + id: string; + + title: string; + author: string; +} +``` + + + +```xml + + string + string + +``` + + + +```yaml +Book: + type: object + properties: + id: + type: integer + title: + type: string + xml: + name: "xml-title" + author: + type: string +``` + +
+ +### 5. Namespace and prefix (inline form) + + + + + + + + + + + + + + + + + + + + + + + + +
TypeSpecXmlOpenAPI3
+ +```tsp +@Xml.ns("smp", "http://example.com/schema") +model Book { + id: string; + title: string; + author: string; +} +``` + + + +```xml + + 0 + string + string + +``` + + + +```yaml +Book: + type: object + properties: + id: + type: integer + title: + type: string + author: + type: string + xml: + prefix: "smp" + namespace: "http://example.com/schema" +``` + +
+ +```tsp +@Xml.ns("smp", "http://example.com/schema") +model Book { + id: string; + + @Xml.ns("smp", "http://example.com/schema") + title: string; + + @Xml.ns("ns2", "http://example.com/ns2") + author: string; +} +``` + + + +```xml + + 0 + string + string + +``` + + + +```yaml +Book: + type: object + properties: + id: + type: integer + title: + type: string + xml: + prefix: "smp" + namespace: "http://example.com/schema" + author: + type: string + xml: + prefix: "ns2" + namespace: "http://example.com/ns2" + xml: + prefix: "smp" + namespace: "http://example.com/schema" +``` + +
+ +### 6. Namespace and prefix (normalized form) + + + + + + + + + + + + + + + + + + + + + + + + +
TypeSpecXmlOpenAPI3
+ +```tsp +@Xml.nsDeclarations +enum Namespaces { + smp: "http://example.com/schema", +} + +@Xml.ns(Namespaces.smp) +model Book { + id: string; + title: string; + author: string; +} +``` + + + +```xml + + 0 + string + string + +``` + + + +```yaml +Book: + type: object + properties: + id: + type: integer + title: + type: string + author: + type: string + xml: + prefix: "smp" + namespace: "http://example.com/schema" +``` + +
+ +```tsp +@Xml.nsDeclarations +enum Namespaces { + smp: "http://example.com/schema", + ns2: "http://example.com/ns2", +} + +@Xml.ns(Namespaces.smp) +model Book { + id: string; + + @Xml.ns(Namespaces.smp) + title: string; + + @Xml.ns(Namespaces.ns2) + author: string; +} +``` + + + +```xml + + 0 + string + string + +``` + + + +```yaml +Book: + type: object + properties: + id: + type: integer + title: + type: string + xml: + prefix: "smp" + namespace: "http://example.com/schema" + author: + type: string + xml: + prefix: "ns2" + namespace: "http://example.com/ns2" + xml: + prefix: "smp" + namespace: "http://example.com/schema" +``` + +
+ +### 6. Property setting the text of the node + + + + + + + + + + + + + + + + + +
TypeSpecXmlOpenAPI3
+ +```tsp +model BlobName { + @Xml.attribute language: string; + @Xml.unwrapped content: string; +} +``` + + + +```xml + + ...content... + +``` + + + +```yaml +Book: + type: object + properties: + language: + type: string + content: + type: string + xml: + x-ms-text: true # on autorest emitter +``` + +
diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/decorators.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/decorators.md new file mode 100644 index 0000000000..0f384c07cb --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/decorators.md @@ -0,0 +1,247 @@ +--- +title: "Decorators" +toc_min_heading_level: 2 +toc_max_heading_level: 3 +--- + +# Decorators + +## TypeSpec.Xml + +### `@attribute` {#@TypeSpec.Xml.attribute} + +Specify that the target property should be encoded as an XML attribute instead of node. + +```typespec +@TypeSpec.Xml.attribute +``` + +#### Target + +`ModelProperty` + +#### Parameters + +None + +#### Examples + +##### Default + +```tsp +model Blob { + id: string; +} +``` + +```xml + +abcdef + +``` + +##### With `@attribute` + +```tsp +model Blob { + @attribute id: string; +} +``` + +```xml + + +``` + +### `@name` {#@TypeSpec.Xml.name} + +Provide the name of the XML element or attribute. This means the same thing as +`@encodedName("application/xml", value)` + +```typespec +@TypeSpec.Xml.name(name: valueof string) +``` + +#### Target + +`unknown` + +#### Parameters + +| Name | Type | Description | +| ---- | ---------------- | ---------------------------------------- | +| name | `valueof string` | The name of the XML element or attribute | + +#### Examples + +```tsp +@name("XmlBook") +model Book { + @name("XmlId") id: string; + @encodedName("application/xml", "XmlName") name: string; + content: string; +} +``` + +```xml + +string +string +string + +``` + +### `@ns` {#@TypeSpec.Xml.ns} + +Specify the XML namespace for this element. It can be used in 2 different ways: + +1. `@ns("http://www.example.com/namespace", "ns1")` - specify both namespace and prefix +2. `@Xml.ns(Namespaces.ns1)` - pass a member of an enum decorated with `@nsDeclaration` + +```typespec +@TypeSpec.Xml.ns(ns: string | EnumMember, prefix?: valueof string) +``` + +#### Target + +`unknown` + +#### Parameters + +| Name | Type | Description | +| ------ | ---------------------- | --------------------------------------------------------------------------------- | +| ns | `string \| EnumMember` | The namespace URI or a member of an enum decorated with `@nsDeclaration`. | +| prefix | `valueof string` | The namespace prefix. Required if the namespace parameter was passed as a string. | + +#### Examples + +##### With strings + +```tsp +@ns("https://example.com/ns1", "ns1") +model Foo { + @ns("https://example.com/ns1", "ns1") + bar: string; + + @ns("https://example.com/ns2", "ns2") + bar: string; +} +``` + +##### With enum + +```tsp +@Xml.nsDeclarations +enum Namespaces { + ns1: "https://example.com/ns1", + ns2: "https://example.com/ns2", +} + +@Xml.ns(Namespaces.ns1) +model Foo { + @Xml.ns(Namespaces.ns1) + bar: string; + + @Xml.ns(Namespaces.ns2) + bar: string; +} +``` + +### `@nsDeclarations` {#@TypeSpec.Xml.nsDeclarations} + +Mark an enum as declaring XML namespaces. See `@ns` + +```typespec +@TypeSpec.Xml.nsDeclarations +``` + +#### Target + +`Enum` + +#### Parameters + +None + +### `@unwrapped` {#@TypeSpec.Xml.unwrapped} + +Specify that the target property shouldn't create a wrapper node. This can be used to flatten list nodes into the model node or to include raw text in the model node. +It cannot be used with `@attribute`. + +```typespec +@TypeSpec.Xml.unwrapped +``` + +#### Target + +`ModelProperty` + +#### Parameters + +None + +#### Examples + +##### Array property default + +```tsp +model Pet { + tags: Tag[]; +} +``` + +```xml + + + +string + + + +``` + +##### Array property with `@unwrapped` + +```tsp +model Pet { + @unwrapped tags: Tag[]; +} +``` + +```xml + + +string + + +``` + +##### String property default + +```tsp +model BlobName { + content: string; +} +``` + +```xml + + +abcdef + + +``` + +##### Array property with `@unwrapped` + +```tsp +model BlobName { + @unwrapped content: string; +} +``` + +```xml + +abcdef + +``` diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/index.mdx b/packages/website/versioned_docs/version-latest/libraries/xml/reference/index.mdx new file mode 100644 index 0000000000..6b1f7600a9 --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/index.mdx @@ -0,0 +1,42 @@ +--- +title: Overview +sidebar_position: 0 +toc_min_heading_level: 2 +toc_max_heading_level: 3 +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Overview + +TypeSpec library providing xml bindings + +## Install + + + + +```bash +npm install @typespec/xml +``` + + + + +```bash +npm install --save-peer @typespec/xml +``` + + + + +## TypeSpec.Xml + +### Decorators + +- [`@attribute`](./decorators.md#@TypeSpec.Xml.attribute) +- [`@name`](./decorators.md#@TypeSpec.Xml.name) +- [`@ns`](./decorators.md#@TypeSpec.Xml.ns) +- [`@nsDeclarations`](./decorators.md#@TypeSpec.Xml.nsDeclarations) +- [`@unwrapped`](./decorators.md#@TypeSpec.Xml.unwrapped) diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/_category_.json b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/_category_.json new file mode 100644 index 0000000000..bc91d15cee --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/_category_.json @@ -0,0 +1 @@ +{"label":"JS API","link":{"type":"doc","id":"index"}} \ No newline at end of file diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$attribute.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$attribute.md new file mode 100644 index 0000000000..eec07dbbbf --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$attribute.md @@ -0,0 +1,19 @@ +--- +jsApi: true +title: "[F] $attribute" + +--- +```ts +$attribute(context, target): void +``` + +## Parameters + +| Parameter | Type | +| :------ | :------ | +| `context` | `DecoratorContext` | +| `target` | `ModelProperty` | + +## Returns + +`void` diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$name.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$name.md new file mode 100644 index 0000000000..1004aa3aec --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$name.md @@ -0,0 +1,23 @@ +--- +jsApi: true +title: "[F] $name" + +--- +```ts +$name( + context, + target, + name): void +``` + +## Parameters + +| Parameter | Type | +| :------ | :------ | +| `context` | `DecoratorContext` | +| `target` | `Type` | +| `name` | `string` | + +## Returns + +`void` diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$ns.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$ns.md new file mode 100644 index 0000000000..8fdcdd8e77 --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$ns.md @@ -0,0 +1,25 @@ +--- +jsApi: true +title: "[F] $ns" + +--- +```ts +$ns( + context, + target, + ns, + prefix?): void +``` + +## Parameters + +| Parameter | Type | +| :------ | :------ | +| `context` | `DecoratorContext` | +| `target` | `Type` | +| `ns` | `Type` | +| `prefix`? | `string` | + +## Returns + +`void` diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$nsDeclarations.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$nsDeclarations.md new file mode 100644 index 0000000000..cfae36e7ce --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$nsDeclarations.md @@ -0,0 +1,19 @@ +--- +jsApi: true +title: "[F] $nsDeclarations" + +--- +```ts +$nsDeclarations(context, target): void +``` + +## Parameters + +| Parameter | Type | +| :------ | :------ | +| `context` | `DecoratorContext` | +| `target` | `Enum` | + +## Returns + +`void` diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$unwrapped.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$unwrapped.md new file mode 100644 index 0000000000..f905329db2 --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/$unwrapped.md @@ -0,0 +1,19 @@ +--- +jsApi: true +title: "[F] $unwrapped" + +--- +```ts +$unwrapped(context, target): void +``` + +## Parameters + +| Parameter | Type | +| :------ | :------ | +| `context` | `DecoratorContext` | +| `target` | `ModelProperty` | + +## Returns + +`void` diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/getNs.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/getNs.md new file mode 100644 index 0000000000..a06ac7f745 --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/getNs.md @@ -0,0 +1,21 @@ +--- +jsApi: true +title: "[F] getNs" + +--- +```ts +getNs(program, target): XmlNamespace | undefined +``` + +Get the namespace and prefix for the given type. + +## Parameters + +| Parameter | Type | +| :------ | :------ | +| `program` | `Program` | +| `target` | `Type` | + +## Returns + +[`XmlNamespace`](../interfaces/XmlNamespace.md) \| `undefined` diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/getXmlEncoding.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/getXmlEncoding.md new file mode 100644 index 0000000000..bdc160dc16 --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/getXmlEncoding.md @@ -0,0 +1,22 @@ +--- +jsApi: true +title: "[F] getXmlEncoding" + +--- +```ts +getXmlEncoding(program, type): XmlEncodeData | undefined +``` + +Resolve how the given type should be encoded in XML. +This will return the default encoding for each types.(e.g. TypeSpec.Xml.Encoding.xmlDateTime for a utcDatetime) + +## Parameters + +| Parameter | Type | Description | +| :------ | :------ | :------ | +| `program` | `Program` | | +| `type` | `Scalar` \| `ModelProperty` | | + +## Returns + +[`XmlEncodeData`](../interfaces/XmlEncodeData.md) \| `undefined` diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/isAttribute.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/isAttribute.md new file mode 100644 index 0000000000..8bd7968a00 --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/isAttribute.md @@ -0,0 +1,21 @@ +--- +jsApi: true +title: "[F] isAttribute" + +--- +```ts +isAttribute(program, target): boolean +``` + +Check if the given property should be serialized as an attribute instead of a node. + +## Parameters + +| Parameter | Type | +| :------ | :------ | +| `program` | `Program` | +| `target` | `ModelProperty` | + +## Returns + +`boolean` diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/isUnwrapped.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/isUnwrapped.md new file mode 100644 index 0000000000..38981cfabd --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/functions/isUnwrapped.md @@ -0,0 +1,21 @@ +--- +jsApi: true +title: "[F] isUnwrapped" + +--- +```ts +isUnwrapped(program, target): boolean +``` + +Check if the given property should be unwrapped in the XML containing node. + +## Parameters + +| Parameter | Type | +| :------ | :------ | +| `program` | `Program` | +| `target` | `ModelProperty` | + +## Returns + +`boolean` diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/index.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/index.md new file mode 100644 index 0000000000..f445ed290b --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/index.md @@ -0,0 +1,25 @@ +--- +jsApi: true +title: "[P] JS API" + +--- +## Interfaces + +- [XmlEncodeData](interfaces/XmlEncodeData.md) +- [XmlNamespace](interfaces/XmlNamespace.md) + +## Type Aliases + +- [XmlEncoding](type-aliases/XmlEncoding.md) + +## Functions + +- [$attribute](functions/$attribute.md) +- [$name](functions/$name.md) +- [$ns](functions/$ns.md) +- [$nsDeclarations](functions/$nsDeclarations.md) +- [$unwrapped](functions/$unwrapped.md) +- [getNs](functions/getNs.md) +- [getXmlEncoding](functions/getXmlEncoding.md) +- [isAttribute](functions/isAttribute.md) +- [isUnwrapped](functions/isUnwrapped.md) diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/interfaces/XmlEncodeData.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/interfaces/XmlEncodeData.md new file mode 100644 index 0000000000..d0bad15deb --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/interfaces/XmlEncodeData.md @@ -0,0 +1,15 @@ +--- +jsApi: true +title: "[I] XmlEncodeData" + +--- +## Extends + +- `EncodeData` + +## Properties + +| Property | Type | Overrides | +| :------ | :------ | :------ | +| `encoding` | `string` | `EncodeData.encoding` | +| `type` | `Scalar` | `EncodeData.type` | diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/interfaces/XmlNamespace.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/interfaces/XmlNamespace.md new file mode 100644 index 0000000000..e5be646e10 --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/interfaces/XmlNamespace.md @@ -0,0 +1,11 @@ +--- +jsApi: true +title: "[I] XmlNamespace" + +--- +## Properties + +| Property | Modifier | Type | +| :------ | :------ | :------ | +| `namespace` | `readonly` | `string` | +| `prefix` | `readonly` | `string` | diff --git a/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/type-aliases/XmlEncoding.md b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/type-aliases/XmlEncoding.md new file mode 100644 index 0000000000..f8a0642c20 --- /dev/null +++ b/packages/website/versioned_docs/version-latest/libraries/xml/reference/js-api/type-aliases/XmlEncoding.md @@ -0,0 +1,15 @@ +--- +jsApi: true +title: "[T] XmlEncoding" + +--- +```ts +type XmlEncoding: + | "TypeSpec.Xml.Encoding.xmlDateTime" + | "TypeSpec.Xml.Encoding.xmlDate" + | "TypeSpec.Xml.Encoding.xmlTime" + | "TypeSpec.Xml.Encoding.xmlDuration" + | "TypeSpec.Xml.Encoding.xmlBase64Binary"; +``` + +Known Xml encodings diff --git a/packages/website/versioned_docs/version-latest/release-notes/release-2024-05-07.md b/packages/website/versioned_docs/version-latest/release-notes/release-2024-05-07.md new file mode 100644 index 0000000000..0fcec11b0b --- /dev/null +++ b/packages/website/versioned_docs/version-latest/release-notes/release-2024-05-07.md @@ -0,0 +1,157 @@ +--- +title: 0.56 - May 2024 +--- + +# Release Notes Version 0.56 - May 2024 + +:::warning +This release contains breaking changes +::: + +## Breaking Changes + +### @typespec/http + +- [#2945](https://github.com/microsoft/typespec/pull/2945) Empty model after removing metadata and applying visibility always results in "void" + This means the following case have changed from returning `{}` to no body + + ```tsp + op b1(): {}; + op b2(): { + @visibility("none") prop: string; + }; + op b3(): { + @added(Versions.v2) prop: string; + }; + ``` + + Workaround: Use explicit `@body` + + ```tsp + op b1(): { + @body _: {}; + }; + op b2(): { + @body _: { + @visibility("none") prop: string; + }; + }; + op b3(): { + @body _: { + @added(Versions.v2) prop: string; + }; + }; + ``` + +- [#2945](https://github.com/microsoft/typespec/pull/2945) Implicit status code always 200 except if response is explicitly `void` + + ```tsp + op c1(): { + @header foo: string; + }; // status code 200 (used to be 204) + ``` + + Solution: Add explicit `@statusCode` + + ```tsp + op c1(): { + @header foo: string; + @statusCode _: 204; + }; + op c1(): { + @header foo: string; + ...NoContent; + }; // or spread common model + ``` + +- [#2945](https://github.com/microsoft/typespec/pull/2945) `@body` means this is the body + + This change makes using `@body` mean this is the exact body and everything underneath will be included, including metadata properties. If metadata properties are present on the body, a warning will be logged. + + ```tsp + op a1(): {@body _: {@header foo: string, other: string} }; + ^ warning header in a body, it will not be included as a header. + ``` + + Use `@bodyRoot` if you want to only change where to resolve the body from. + + ```tsp + op a1(): { + @bodyRoot _: { + @header foo: string; + other: string; + }; + }; + ``` + +- [#2945](https://github.com/microsoft/typespec/pull/2945) Properties are not automatically omitted if everything was removed from metadata or visibility + + ```tsp + op d1(): { + headers: { + @header foo: string; + }; + }; // body will be {headers: {}} + ``` + + Solution: use `@bodyIgnore` + + ```tsp + op d1(): { + @bodyIgnore headers: { + @header foo: string; + }; + }; // body will be {headers: {}} + ``` + +## Features + +### @typespec/compiler + +- [#3035](https://github.com/microsoft/typespec/pull/3035) `getEncode` returns the fully qualified enum member name if using a custom enum. +- [#3183](https://github.com/microsoft/typespec/pull/3183) Show template parameters when hovering on an operation template +- [#3191](https://github.com/microsoft/typespec/pull/3191) [API] Add new `sourceModels` property to model + +### @typespec/rest + +- [#2945](https://github.com/microsoft/typespec/pull/2945) Add support for new `@bodyRoot` and `@body` distinction + +### @typespec/openapi3 + +- [#2945](https://github.com/microsoft/typespec/pull/2945) Add support for new `@bodyRoot` and `@body` distinction + +### @typespec/html-program-viewer + +- [#3191](https://github.com/microsoft/typespec/pull/3191) Add `sourceModels` property to model view + +## Bug Fixes + +### @typespec/compiler + +- [#3170](https://github.com/microsoft/typespec/pull/3170) `--nostdlib` flag will now work by only applying to optional standard library types +- [#3212](https://github.com/microsoft/typespec/pull/3212) Fix: augmenting template model property could result in sending invalid argument to decorator +- [#3188](https://github.com/microsoft/typespec/pull/3188) Fix: Do not crash when trying to access member of aliased expressions +- [#3185](https://github.com/microsoft/typespec/pull/3185) Fix tsp init hanging when done due to unclosed connection +- [#3151](https://github.com/microsoft/typespec/pull/3151) IDE: Fix completion of statement keywords +- [#3287](https://github.com/microsoft/typespec/pull/3287) Templated interface extending another templated interface shouldn't run decorator on their operations +- [#3290](https://github.com/microsoft/typespec/pull/3290) Model with an optional property should not satisfy a constraint with that property required. (`{foo?: string}` cannot be assigned to a constraint of `{foo: string}`) +- [#3163](https://github.com/microsoft/typespec/pull/3163) Fix: Model with spread indexer shouldn't validate explicit properties +- [#3227](https://github.com/microsoft/typespec/pull/3227) Stop running decorators on partially instantiated operations(When interface is instantiated but not the operation) +- [#3180](https://github.com/microsoft/typespec/pull/3180) Fix issue where directives were not parsed to the leaf node in multi-segment Namespace segments. +- [#3243](https://github.com/microsoft/typespec/pull/3243) Fix calling `tsp install` on windows due to recent NodeJS breaking change to fix vulnerability. +- [#3216](https://github.com/microsoft/typespec/pull/3216) Fix compiler crash when using an invalid `is` target in an interface operation template +- [#3246](https://github.com/microsoft/typespec/pull/3246) Internals: Use node built-in `fetch` API that is now stable since node `18.13.0` + +### @typespec/http + +- [#3196](https://github.com/microsoft/typespec/pull/3196) Fix password flow defining `authorizationUrl` instead of `tokenUrl` +- [#3190](https://github.com/microsoft/typespec/pull/3190) Fix `@path` param mapping when spreading a record in operation parameters +- [#3218](https://github.com/microsoft/typespec/pull/3218) Fix: `@path` property shouldn't be applicableMetadata if the visibility contains `Read` + +### @typespec/versioning + +- [#3264](https://github.com/microsoft/typespec/pull/3264) Fix crash when `@service` appears inside a versioned namespace + +### @typespec/openapi3 + +- [#3218](https://github.com/microsoft/typespec/pull/3218) Fix: `@path` property should be included in unreachable models diff --git a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/classes/ProjectionError.md b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/classes/ProjectionError.md index 2a2bb4dd31..d4ff2cb67d 100644 --- a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/classes/ProjectionError.md +++ b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/classes/ProjectionError.md @@ -35,6 +35,7 @@ new ProjectionError(message): ProjectionError | Property | Modifier | Type | Description | Inherited from | | :------ | :------ | :------ | :------ | :------ | +| `cause?` | `public` | `unknown` | - | `Error.cause` | | `message` | `public` | `string` | - | `Error.message` | | `name` | `public` | `string` | - | `Error.name` | | `stack?` | `public` | `string` | - | `Error.stack` | diff --git a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/classes/ResolveModuleError.md b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/classes/ResolveModuleError.md index e62fe6b079..8e4583342d 100644 --- a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/classes/ResolveModuleError.md +++ b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/classes/ResolveModuleError.md @@ -34,6 +34,7 @@ new ResolveModuleError(code, message): ResolveModuleError | Property | Modifier | Type | Description | Inherited from | | :------ | :------ | :------ | :------ | :------ | +| `cause?` | `public` | `unknown` | - | `Error.cause` | | `code` | `public` | `ResolveModuleErrorCode` | - | - | | `message` | `public` | `string` | - | `Error.message` | | `name` | `public` | `string` | - | `Error.name` | diff --git a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/functions/$indexer.md b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/functions/$indexer.md deleted file mode 100644 index 9b29c8712e..0000000000 --- a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/functions/$indexer.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -jsApi: true -title: "[F] $indexer" - ---- -```ts -$indexer( - context, - target, - key, - value): void -``` - -## Parameters - -| Parameter | Type | -| :------ | :------ | -| `context` | [`DecoratorContext`](../interfaces/DecoratorContext.md) | -| `target` | [`Type`](../type-aliases/Type.md) | -| `key` | [`Scalar`](../interfaces/Scalar.md) | -| `value` | [`Type`](../type-aliases/Type.md) | - -## Returns - -`void` diff --git a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/functions/getIndexer.md b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/functions/getIndexer.md deleted file mode 100644 index 3ebdf4e871..0000000000 --- a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/functions/getIndexer.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -jsApi: true -title: "[F] getIndexer" - ---- -```ts -getIndexer(program, target): ModelIndexer | undefined -``` - -## Parameters - -| Parameter | Type | -| :------ | :------ | -| `program` | [`Program`](../interfaces/Program.md) | -| `target` | [`Type`](../type-aliases/Type.md) | - -## Returns - -[`ModelIndexer`](../type-aliases/ModelIndexer.md) \| `undefined` diff --git a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/index.md b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/index.md index 0fc5fd3f4f..30f9e05fdb 100644 --- a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/index.md +++ b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/index.md @@ -204,6 +204,7 @@ title: "[P] JS API" - [SourceFile](interfaces/SourceFile.md) - [SourceLocation](interfaces/SourceLocation.md) - [SourceLocationOptions](interfaces/SourceLocationOptions.md) +- [SourceModel](interfaces/SourceModel.md) - [StateDef](interfaces/StateDef.md) - [StringLiteral](interfaces/StringLiteral.md) - [StringLiteralNode](interfaces/StringLiteralNode.md) @@ -358,7 +359,6 @@ title: "[P] JS API" - [$errorsDoc](functions/$errorsDoc.md) - [$format](functions/$format.md) - [$friendlyName](functions/$friendlyName.md) -- [$indexer](functions/$indexer.md) - [$inspectType](functions/$inspectType.md) - [$inspectTypeName](functions/$inspectTypeName.md) - [$key](functions/$key.md) @@ -439,7 +439,6 @@ title: "[P] JS API" - [getFriendlyName](functions/getFriendlyName.md) - [getFullyQualifiedSymbolName](functions/getFullyQualifiedSymbolName.md) - [getIdentifierContext](functions/getIdentifierContext.md) -- [getIndexer](functions/getIndexer.md) - [getKeyName](functions/getKeyName.md) - [getKnownValues](functions/getKnownValues.md) - [getListOperationType](functions/getListOperationType.md) diff --git a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/ArrayModelType.md b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/ArrayModelType.md index adce28f435..46cff03c48 100644 --- a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/ArrayModelType.md +++ b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/ArrayModelType.md @@ -28,6 +28,7 @@ title: "[I] ArrayModelType" | `projector?` | [`Projector`](Projector.md) | - | [`Model`](Model.md).`projector` | [`Model`](Model.md).`projector` | | `properties` | `RekeyableMap`<`string`, [`ModelProperty`](ModelProperty.md)\> | The properties of the model.

Properties are ordered in the order that they appear in source.
Properties obtained via `model is` appear before properties defined in
the model body. Properties obtained via `...` are inserted where the
spread appears in source.

Properties inherited via `model extends` are not included. Use
[walkPropertiesInherited](../functions/walkPropertiesInherited.md) to enumerate all properties in the
inheritance hierarchy. | [`Model`](Model.md).`properties` | [`Model`](Model.md).`properties` | | `sourceModel?` | [`Model`](Model.md) | The model that is referenced via `model is`. | [`Model`](Model.md).`sourceModel` | [`Model`](Model.md).`sourceModel` | +| `sourceModels` | [`SourceModel`](SourceModel.md)[] | Models that were used to build this model. This include any model referenced in `model is`, `...` or when intersecting models. | [`Model`](Model.md).`sourceModels` | [`Model`](Model.md).`sourceModels` | | ~~`templateArguments?`~~ | [`Type`](../type-aliases/Type.md)[] | **Deprecated**
use templateMapper instead. | [`Model`](Model.md).`templateArguments` | [`Model`](Model.md).`templateArguments` | | `templateMapper?` | [`TypeMapper`](TypeMapper.md) | - | [`Model`](Model.md).`templateMapper` | [`Model`](Model.md).`templateMapper` | | `templateNode?` | [`Node`](../type-aliases/Node.md) | - | [`Model`](Model.md).`templateNode` | [`Model`](Model.md).`templateNode` | diff --git a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/Model.md b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/Model.md index 0e23c9c09c..694e434aec 100644 --- a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/Model.md +++ b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/Model.md @@ -26,6 +26,7 @@ title: "[I] Model" | `projector?` | [`Projector`](Projector.md) | - | [`BaseType`](BaseType.md).`projector` | [`BaseType`](BaseType.md).`projector` | | `properties` | `RekeyableMap`<`string`, [`ModelProperty`](ModelProperty.md)\> | The properties of the model.

Properties are ordered in the order that they appear in source.
Properties obtained via `model is` appear before properties defined in
the model body. Properties obtained via `...` are inserted where the
spread appears in source.

Properties inherited via `model extends` are not included. Use
[walkPropertiesInherited](../functions/walkPropertiesInherited.md) to enumerate all properties in the
inheritance hierarchy. | - | - | | `sourceModel?` | [`Model`](Model.md) | The model that is referenced via `model is`. | - | - | +| `sourceModels` | [`SourceModel`](SourceModel.md)[] | Models that were used to build this model. This include any model referenced in `model is`, `...` or when intersecting models. | - | - | | ~~`templateArguments?`~~ | [`Type`](../type-aliases/Type.md)[] | **Deprecated**
use templateMapper instead. | [`TemplatedTypeBase`](TemplatedTypeBase.md).`templateArguments` | [`TemplatedTypeBase`](TemplatedTypeBase.md).`templateArguments` | | `templateMapper?` | [`TypeMapper`](TypeMapper.md) | - | [`TemplatedTypeBase`](TemplatedTypeBase.md).`templateMapper` | [`TemplatedTypeBase`](TemplatedTypeBase.md).`templateMapper` | | `templateNode?` | [`Node`](../type-aliases/Node.md) | - | [`TemplatedTypeBase`](TemplatedTypeBase.md).`templateNode` | [`TemplatedTypeBase`](TemplatedTypeBase.md).`templateNode` | diff --git a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/RecordModelType.md b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/RecordModelType.md index b79dc3fa26..00c4902600 100644 --- a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/RecordModelType.md +++ b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/RecordModelType.md @@ -28,6 +28,7 @@ title: "[I] RecordModelType" | `projector?` | [`Projector`](Projector.md) | - | [`Model`](Model.md).`projector` | [`Model`](Model.md).`projector` | | `properties` | `RekeyableMap`<`string`, [`ModelProperty`](ModelProperty.md)\> | The properties of the model.

Properties are ordered in the order that they appear in source.
Properties obtained via `model is` appear before properties defined in
the model body. Properties obtained via `...` are inserted where the
spread appears in source.

Properties inherited via `model extends` are not included. Use
[walkPropertiesInherited](../functions/walkPropertiesInherited.md) to enumerate all properties in the
inheritance hierarchy. | [`Model`](Model.md).`properties` | [`Model`](Model.md).`properties` | | `sourceModel?` | [`Model`](Model.md) | The model that is referenced via `model is`. | [`Model`](Model.md).`sourceModel` | [`Model`](Model.md).`sourceModel` | +| `sourceModels` | [`SourceModel`](SourceModel.md)[] | Models that were used to build this model. This include any model referenced in `model is`, `...` or when intersecting models. | [`Model`](Model.md).`sourceModels` | [`Model`](Model.md).`sourceModels` | | ~~`templateArguments?`~~ | [`Type`](../type-aliases/Type.md)[] | **Deprecated**
use templateMapper instead. | [`Model`](Model.md).`templateArguments` | [`Model`](Model.md).`templateArguments` | | `templateMapper?` | [`TypeMapper`](TypeMapper.md) | - | [`Model`](Model.md).`templateMapper` | [`Model`](Model.md).`templateMapper` | | `templateNode?` | [`Node`](../type-aliases/Node.md) | - | [`Model`](Model.md).`templateNode` | [`Model`](Model.md).`templateNode` | diff --git a/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/SourceModel.md b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/SourceModel.md new file mode 100644 index 0000000000..0a256f9e44 --- /dev/null +++ b/packages/website/versioned_docs/version-latest/standard-library/reference/js-api/interfaces/SourceModel.md @@ -0,0 +1,11 @@ +--- +jsApi: true +title: "[I] SourceModel" + +--- +## Properties + +| Property | Modifier | Type | Description | +| :------ | :------ | :------ | :------ | +| `model` | `readonly` | [`Model`](Model.md) | Source model | +| `usage` | `readonly` | `"is"` \| `"intersection"` \| `"spread"` | How was this model used.
- is: `model A is B`
- spread: `model A {...B}`
- intersection: `alias A = B & C` | diff --git a/packages/website/versioned_sidebars/version-latest-sidebars.json b/packages/website/versioned_sidebars/version-latest-sidebars.json index af3a11e5da..eebcfbea73 100644 --- a/packages/website/versioned_sidebars/version-latest-sidebars.json +++ b/packages/website/versioned_sidebars/version-latest-sidebars.json @@ -115,20 +115,6 @@ "libraries/http/encoding" ] }, - { - "type": "category", - "label": "JSON Schema", - "link": { - "type": "doc", - "id": "libraries/json-schema/reference/index" - }, - "items": [ - { - "type": "autogenerated", - "dirName": "libraries/json-schema/reference" - } - ] - }, { "type": "category", "label": "Rest", @@ -161,48 +147,83 @@ }, { "type": "category", - "label": "OpenAPI3", + "label": "Versioning", "link": { "type": "doc", - "id": "libraries/openapi3/reference/index" + "id": "libraries/versioning/reference/index" }, "items": [ { "type": "autogenerated", - "dirName": "libraries/openapi3/reference" + "dirName": "libraries/versioning/reference" }, - "libraries/openapi3/openapi", - "libraries/openapi3/diagnostics" + "libraries/versioning/guide" ] }, { "type": "category", - "label": "Protobuf", + "label": "Xml", + "link": { + "type": "doc", + "id": "libraries/xml/reference/index" + }, + "items": [ + { + "type": "autogenerated", + "dirName": "libraries/xml/reference" + }, + "libraries/xml/guide" + ] + } + ] + }, + { + "type": "category", + "label": "🖨️ Emitters", + "items": [ + { + "type": "category", + "label": "JSON Schema", + "link": { + "type": "doc", + "id": "emitters/json-schema/reference/index" + }, + "items": [ + { + "type": "autogenerated", + "dirName": "emitters/json-schema/reference" + } + ] + }, + { + "type": "category", + "label": "OpenAPI3", "link": { "type": "doc", - "id": "libraries/protobuf/reference/index" + "id": "emitters/openapi3/reference/index" }, "items": [ { "type": "autogenerated", - "dirName": "libraries/protobuf/reference" + "dirName": "emitters/openapi3/reference" }, - "libraries/protobuf/guide" + "emitters/openapi3/openapi", + "emitters/openapi3/diagnostics" ] }, { "type": "category", - "label": "Versioning", + "label": "Protobuf", "link": { "type": "doc", - "id": "libraries/versioning/reference/index" + "id": "emitters/protobuf/reference/index" }, "items": [ { "type": "autogenerated", - "dirName": "libraries/versioning/reference" + "dirName": "emitters/protobuf/reference" }, - "libraries/versioning/guide" + "emitters/protobuf/guide" ] } ] diff --git a/packages/xml/CHANGELOG.md b/packages/xml/CHANGELOG.md new file mode 100644 index 0000000000..a130841955 --- /dev/null +++ b/packages/xml/CHANGELOG.md @@ -0,0 +1,10 @@ +# Changelog - @typespec/xml + + + +## 0.56.0 + +### Bump dependencies + +- [#3169](https://github.com/microsoft/typespec/pull/3169) Update dependencies + diff --git a/packages/xml/package.json b/packages/xml/package.json index a6b461079a..be812da68f 100644 --- a/packages/xml/package.json +++ b/packages/xml/package.json @@ -1,6 +1,6 @@ { "name": "@typespec/xml", - "version": "0.55.0", + "version": "0.56.0", "author": "Microsoft Corporation", "description": "TypeSpec library providing xml bindings", "homepage": "https://typespec.io",