Website perf improvements (microsoft#2507)

Progress in microsoft#2480

## `Swc-loader`
Some minor perf improviement. Using `swc-loader` is much faster at
loading the js in the compile stage. This make the timed build nearly
50% faster but it **still gets stuck at** `cache (99%) shutdown
IdleFileCachePlugin` for the vast majority of the time. So this is a
little win but nearly negligable

## Updateing `typedoc-markdown` 

This has changed the file structure to group by folder and has basically
brought back the perf from before the migration to the new doc format.
Not sure why but it works great now.

Author: timotheeguerin

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/config/rush/pnpm-lock.yaml

@@ -23,16 +23,16 @@ However, if your emitter does want to split types as OpenAPI does, then it will
 
 These are the main API involved in handling these features. See the linked API reference documentation for more details.
 
-- [`getRequestVisibility(HttpVerb): Visibility`](../standard-library/http/reference/js-api/index.md#getrequestvisibility) - Use this to determine the visibility implied for data in the request parameters or body. Also note that [`Visibility.Read`](../standard-library/http/reference/js-api/Enumeration.Visibility.md#item) is always applied for response data and therefore there is no corresponding API for the response.
+- [`getRequestVisibility(HttpVerb): Visibility`](../standard-library/http/reference/js-api/index.md#getrequestvisibility) - Use this to determine the visibility implied for data in the request parameters or body. Also note that [`Visibility.Read`](../standard-library/http/reference/js-api/enumerations/Visibility.md#item) is always applied for response data and therefore there is no corresponding API for the response.
 
-- [`MetadataInfo`](../standard-library/http/reference/js-api/Interface.MetadataInfo.md) - Create this once for each program using [`createMetadataInfo(Program, MetadataInfoOptions)`](../standard-library/http/reference/js-api/index.md#createmetadatainfo) then use it to reason about metadata and visibility implications with the API below.
+- [`MetadataInfo`](../standard-library/http/reference/js-api/interfaces/MetadataInfo.md) - Create this once for each program using [`createMetadataInfo(Program, MetadataInfoOptions)`](../standard-library/http/reference/js-api/index.md#createmetadatainfo) then use it to reason about metadata and visibility implications with the API below.
 
-- [`MetadataInfo.getEffectivePayloadType(Type, Visibility): Type`](../standard-library/http/reference/js-api/Interface.MetadataInfo.md#geteffectivepayloadtype) - Use this recursively on every type that is referenced. When given an anonymous model sourced entirely from a single named model after metadata is moved elsewhere or invisible properties are removed, it will recover the named model. This handles the commonly discussed case of seeing that `op something(...Thing)` receives a `Thing` in its request body, but also many other cases..
+- [`MetadataInfo.getEffectivePayloadType(Type, Visibility): Type`](../standard-library/http/reference/js-api/interfaces/MetadataInfo.md#geteffectivepayloadtype) - Use this recursively on every type that is referenced. When given an anonymous model sourced entirely from a single named model after metadata is moved elsewhere or invisible properties are removed, it will recover the named model. This handles the commonly discussed case of seeing that `op something(...Thing)` receives a `Thing` in its request body, but also many other cases..
 
-- [`MetadataInfo.isTransformed(Model, Visibility)`](../standard-library/http/reference/js-api/Interface.MetadataInfo.md#istransformed) - Use this to check if a type undergoes any changes in shape due to visibility or metadata. If not, this can allow for simplifications in emit.
+- [`MetadataInfo.isTransformed(Model, Visibility)`](../standard-library/http/reference/js-api/interfaces/MetadataInfo.md#istransformed) - Use this to check if a type undergoes any changes in shape due to visibility or metadata. If not, this can allow for simplifications in emit.
 
-- [`MetadataInfo.isPayloadProperty(ModelProperty, Visibility): boolean`](../standard-library/http/reference/js-api/Interface.MetadataInfo.md#ispayloadproperty) - Use this to check if a property is transmitted as an object property in the payload and is not invisible or metadata sent elsewhere.
+- [`MetadataInfo.isPayloadProperty(ModelProperty, Visibility): boolean`](../standard-library/http/reference/js-api/interfaces/MetadataInfo.md#ispayloadproperty) - Use this to check if a property is transmitted as an object property in the payload and is not invisible or metadata sent elsewhere.
 
-- [`MetadataInfo.isOptional(ModelProperty, Visibility): boolean`](../standard-library/http/reference/js-api/Interface.MetadataInfo.md#isoptional) - Use this to determine if a property is optional for the given visibility. This will differ from `ModelProperty.isOptional` when the Visibility is Update in which case the property is always considered optional.
+- [`MetadataInfo.isOptional(ModelProperty, Visibility): boolean`](../standard-library/http/reference/js-api/interfaces/MetadataInfo.md#isoptional) - Use this to determine if a property is optional for the given visibility. This will differ from `ModelProperty.isOptional` when the Visibility is Update in which case the property is always considered optional.
 
-- [`Visibility.Item`](../standard-library/http/reference/js-api/Enumeration.Visibility#item) - Add this flag when recursing into an array. This moves all metadata into the payload, which can be useful in scenarios like batching API calls.
+- [`Visibility.Item`](../standard-library/http/reference/js-api/enumerations/Visibility.md#item) - Add this flag when recursing into an array. This moves all metadata into the payload, which can be useful in scenarios like batching API calls.

docs/extending-typespec/emitter-metadata-handling.md

@@ -1,7 +1,6 @@
 export { ResolveCompilerOptionsOptions, resolveCompilerOptions } from "./config/index.js";
 export * from "./core/index.js";
 export * from "./lib/decorators.js";
-export * as decorators from "./lib/decorators.js";
 export * from "./server/index.js";
 import * as formatter from "./formatter/index.js";
 export const TypeSpecPrettierPlugin = formatter;

packages/compiler/src/index.ts

@@ -73,7 +73,7 @@
     "mocha": "~10.2.0",
     "source-map-support": "~0.5.21",
     "rimraf": "~5.0.1",
-    "typedoc-plugin-markdown": "~4.0.0-next.20",
+    "typedoc-plugin-markdown": "~4.0.0-next.22",
     "typedoc": "~0.25.1",
     "typescript": "~5.2.2"
   }

packages/tspd/package.json

@@ -7,17 +7,15 @@ export async function generateJsApiDocs(libraryPath: string, outputDir: string)
   const markdownPluginOptions: Partial<PluginOptions> = {
     entryFileName: "index.md",
     propertiesFormat: "table",
+    parametersFormat: "table",
     enumMembersFormat: "table",
     typeDeclarationFormat: "table",
     hidePageTitle: true,
     hideBreadcrumbs: true,
     titleTemplate: "{name}",
     hideInPageTOC: true,
     hidePageHeader: true,
-
-    tocFormat: "list",
-    flattenOutputFiles: true,
-    identifiersAsCodeBlocks: true,
+    useCodeBlocks: true,
   };
 
   const app = await Application.bootstrapWithPlugins({

packages/tspd/src/ref-doc/api-docs.ts

@@ -85,6 +85,28 @@ const config = {
   ],
   staticDirectories: [resolve(__dirname, "./node_modules/@typespec/spec/dist")],
 
+  webpack: {
+    jsLoader: (isServer) => ({
+      loader: require.resolve("swc-loader"),
+      options: {
+        jsc: {
+          parser: {
+            syntax: "typescript",
+            tsx: true,
+          },
+          target: "es2019",
+          transform: {
+            react: {
+              runtime: "automatic",
+            },
+          },
+        },
+        module: {
+          type: isServer ? "commonjs" : "es6",
+        },
+      },
+    }),
+  },
   themeConfig:
     /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
     ({

packages/website/docusaurus.config.js

@@ -32,6 +32,7 @@
     "react-dom": "^17.0.2"
   },
   "devDependencies": {
+    "@swc/core": "^1.3.62",
     "@typespec/compiler": "workspace:~0.48.1",
     "@typespec/tspd": "workspace:~0.46.0",
     "@typespec/spec": "workspace:*",
@@ -54,7 +55,8 @@
     "@typespec/eslint-config-typespec": "workspace:~0.48.0",
     "eslint": "^8.49.0",
     "rimraf": "~5.0.1",
-    "dotenv": "~16.3.1"
+    "dotenv": "~16.3.1",
+    "swc-loader": "^0.2.3"
   },
   "browserslist": {
     "production": [