Merge branch 'main' of https://github.com/Microsoft/typespec into fea…

…ture/website-design

.github/workflows/tryit-comment.yml

@@ -30,7 +30,7 @@ jobs:
                 `Changes in this PR will be published to the following url to try(check status of TypeSpec Pull Request Try It pipeline for publish status):`,
                 `Playground: https://cadlplayground.z22.web.core.windows.net/prs/${prNumber}/`,
                 "",
-                `Website: https://tspwebsitepr.z5.web.core.windows.net/prs/${prNumber}/`,
+                `Website: https://tspwebsitepr.z22.web.core.windows.net/prs/${prNumber}/`,
 
               ].join("\n")
             })

.prettierignore

@@ -34,8 +34,10 @@ spec.emu.html
 # Auto generated reference docs.
 docs/**/reference/
 docs/standard-library/built-in-decorators.md
+docs/standard-library/built-in-data-types.md
 packages/website/versioned_docs/**/reference/
 packages/website/versioned_docs/**/standard-library/built-in-decorators.md
+packages/website/versioned_docs/**/standard-library/built-in-data-types.md
 
 #.tsp init template
 eng/feeds/

.vscode/settings.json

@@ -10,7 +10,8 @@
     "docs/spec.html": true,
     "common/config/rush/pnpm-lock.yaml": true,
     "**/node_modules/**": true,
-    "packages/website/versioned_docs/**": true
+    "packages/website/versioned_docs/**": true,
+    "packages/samples/scratch/**": false // Those files are in gitignore but we still want to search for them
   },
   "files.exclude": {
     "**/common/temp/**": true,
@@ -87,6 +88,7 @@
     "rush.json": "jsonc",
     "common-versions.json": "jsonc",
     "command-line.json": "jsonc",
+    "pnpm-config.json": "jsonc",
     "version-policies.json": "jsonc"
   },
   "typescript.tsdk": "./packages/compiler/node_modules/typescript/lib",

common/changes/@typespec/bundler/prepare-playground-release_2023-09-25-17-57.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/bundler",
+      "comment": "",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/bundler"
+}

common/changes/@typespec/compiler/2390-param-hyphen_2023-09-10-15-37.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "Handle hyphen in @param doc comment",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/compiler"
+}

common/changes/@typespec/compiler/constraint-allow-null_2023-09-12-15-51.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "Allow nullable types for constraint decorators(min/max value, length, etc)",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/compiler"
+}

common/changes/@typespec/compiler/feature-op-returns-docs_2023-09-19-16-32.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "Add support for `@returns` and `@errors` doc comment tags. `@returns`(or `@returnsDoc` decorator) can be used to describe the success return types of an operation. `@errors`(or `@errorsDoc` decorator) can be used to describe the error return types of an operation.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/compiler"
+}

common/changes/@typespec/compiler/fix-comment-tmlanguage_2023-09-25-20-36.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "Fix: Colorization of line comment was bleeding over to the next line(s).",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/compiler"
+}

common/changes/@typespec/compiler/fix-format-exit-code_2023-09-20-15-44.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "`tsp format` now returns a non-zero exit code when it fails to format a file",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/compiler"
+}

common/changes/@typespec/compiler/fix-init-config_2023-09-28-18-02.json

@@ -0,0 +1,15 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "Fix: `tsp init` was not creating the `tspconfig.yaml` file for templates that specified it",
+      "type": "none"
+    },
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "Fix: `tsp init` will create a placeholder `tspconfig.yaml` file for templates that don't specify an explicit one.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/compiler"
+}

common/changes/@typespec/compiler/fix-lsp-not-reading-whole-config_2023-10-02-19-28.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "Fix: Language Server wasn't loading the `tspconfig.yaml` correctly resulting in some options being dropped like the linter configuration.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/compiler"
+}

common/changes/@typespec/compiler/fix-playground-lsp_2023-10-03-15-56.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/compiler"
+}

common/changes/@typespec/compiler/fix-using-typespec-implicit_2023-09-28-21-17.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "Fix: Using `TypeSpec.Xyz` namespace shouldn't require the `TypeSpec Prefix`",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/compiler"
+}

common/changes/@typespec/compiler/no-double-deprecation_2023-09-25-12-54.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "Skip emit of `deprecated` diagnostic for a type reference that is used in a deprecated declaration statement",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/compiler"
+}

common/changes/@typespec/compiler/website-perf-improvements_2023-09-28-20-21.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "Remove `decorators` export, import decorators individually",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/compiler"
+}

common/changes/@typespec/http/feature-op-returns-docs_2023-09-19-16-32.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/http",
+      "comment": "Add support for `@returns` and `@errors` doc comment tags.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/http"
+}

common/changes/@typespec/http/openapi3-DuplicateRefs_2023-09-27-19-57.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/http",
+      "comment": "Emit error when multiple properties on a response model have the `@statusCode` decorator.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/http"
+}

common/changes/@typespec/internal-build-utils/prepare-playground-release_2023-09-25-17-57.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/internal-build-utils",
+      "comment": "Handle bumping version of prerelease packages",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/internal-build-utils"
+}

common/changes/@typespec/json-schema/constraint-allow-null_2023-09-22-22-38.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/json-schema",
+      "comment": "",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/json-schema"
+}

common/changes/@typespec/openapi3/constraint-allow-null_2023-09-22-22-38.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/openapi3",
+      "comment": "Add support for constraints on unions",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/openapi3"
+}

common/changes/@typespec/openapi3/feature-op-returns-docs_2023-09-19-16-32.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/openapi3",
+      "comment": "Add support for `@returns` and `@errors` doc comment tags.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/openapi3"
+}

common/changes/@typespec/openapi3/fix-openapi3-header-format_2023-09-20-17-20.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/openapi3",
+      "comment": "Fix: Using format `ssv` or `pipes` in `@header` produced an invalid OpenAPI3 schema. It will now change the type to string and ignore the format as well as logging a warning.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/openapi3"
+}

common/changes/@typespec/openapi3/oneof-model-prop_2023-09-22-20-29.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/openapi3",
+      "comment": "Allow use of `@oneOf` on model properties",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/openapi3"
+}

common/changes/@typespec/openapi3/openapi3-DuplicateRefs_2023-09-27-19-57.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/openapi3",
+      "comment": "",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/openapi3"
+}

common/changes/@typespec/playground/prepare-playground-release_2023-09-25-17-57.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/playground",
+      "comment": "",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/playground"
+}

common/changes/@typespec/playground/upgrade-deps-swagger-ui_2023-09-26-19-19.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/playground",
+      "comment": "Upgrade swagger-ui",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/playground"
+}

common/changes/@typespec/protobuf/protobuf-emit-doc-comments_2023-08-10-18-18.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/protobuf",
+      "comment": "Added support for emitting documentation comments in protobuf specifications.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/protobuf"
+}

common/changes/@typespec/rest/fixResourceLogic_2023-09-29-18-58.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/rest",
+      "comment": "Fix: `@key` can now appear on the base model of a resource.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/rest"
+}

common/changes/@typespec/versioning/versioning-RenamedFromBug_2023-09-27-22-20.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/versioning",
+      "comment": "Ensure that use of `@renamedFrom` does not result in duplicate properties on a model.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/versioning"
+}

common/config/rush/.pnpmfile.cjs

@@ -0,0 +1,37 @@
+"use strict";
+
+/**
+ * When using the PNPM package manager, you can use pnpmfile.js to workaround
+ * dependencies that have mistakes in their package.json file.  (This feature is
+ * functionally similar to Yarn's "resolutions".)
+ *
+ * For details, see the PNPM documentation:
+ * https://pnpm.js.org/docs/en/hooks.html
+ *
+ * IMPORTANT: SINCE THIS FILE CONTAINS EXECUTABLE CODE, MODIFYING IT IS LIKELY TO INVALIDATE
+ * ANY CACHED DEPENDENCY ANALYSIS.  After any modification to pnpmfile.js, it's recommended to run
+ * "rush update --full" so that PNPM will recalculate all version selections.
+ */
+module.exports = {
+  hooks: {
+    readPackage,
+  },
+};
+
+/**
+ * This hook is invoked during installation before a package's dependencies
+ * are selected.
+ * The `packageJson` parameter is the deserialized package.json
+ * contents for the package that is about to be installed.
+ * The `context` parameter provides a log() function.
+ * The return value is the updated object.
+ */
+function readPackage(packageJson, context) {
+  // // The karma types have a missing dependency on typings from the log4js package.
+  // if (packageJson.name === '@types/karma') {
+  //  context.log('Fixed up dependencies for @types/karma');
+  //  packageJson.dependencies['log4js'] = '0.6.38';
+  // }
+
+  return packageJson;
+}