@typespec/tspd 0.71.0-dev.0 → 0.71.0-dev.1

package/dist/src/cli.js

@@ -52,15 +52,19 @@ async function main() {
       demandOption: true
     }).option("output-dir", {
       type: "string"
-    }).positional("skip-js", {
+    }).option("skip-js", {
       description: "Skip generating JS API docs.",
       type: "boolean"
+    }).option("typekits", {
+      description: "Generate typekit docs. Currently targeted for use with Astro Starlight.",
+      type: "boolean"
     });
   }, async args => {
     const resolvedRoot = resolvePath(process.cwd(), args.entrypoint);
     const host = NodeHost;
     const diagnostics = await generateLibraryDocs(resolvedRoot, args["output-dir"] ?? resolvePath(resolvedRoot, "docs"), {
-      skipJSApi: args["skip-js"]
+      skipJSApi: args["skip-js"],
+      typekits: args["typekits"]
     });
     // const diagnostics = await generateExternSignatures(host, resolvedRoot);
     if (diagnostics.length > 0) {

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/src/ref-doc/api-extractor.d.ts

@@ -0,0 +1,5 @@
+import { ApiModel } from "@microsoft/api-extractor-model";
+import { type PackageJson } from "@typespec/compiler";
+export declare function createApiModel(libraryPath: string, pkgJson: PackageJson): Promise<ApiModel | undefined>;
+export declare function createApiModelFileForExport(libraryPath: string, pkgJson: PackageJson, exportName: string): string;
+//# sourceMappingURL=api-extractor.d.ts.map

package/dist/src/ref-doc/api-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-extractor.d.ts","sourceRoot":"","sources":["../../../src/ref-doc/api-extractor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjE,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,iCAc7E;AA+BD,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,CAgCR"}

package/dist/src/ref-doc/api-extractor.js

@@ -0,0 +1,69 @@
+import { Extractor, ExtractorConfig } from "@microsoft/api-extractor";
+import { ApiModel } from "@microsoft/api-extractor-model";
+import { TSDocConfigFile } from "@microsoft/tsdoc-config";
+import { joinPaths } from "@typespec/compiler";
+export async function createApiModel(libraryPath, pkgJson) {
+  const apiModel = new ApiModel();
+  const typekitexports = Object.keys(pkgJson.exports).filter(x => x.includes("typekit"));
+  if (typekitexports.length === 0) {
+    return undefined;
+  }
+  for (const exportName of [typekitexports[0]]) {
+    const modelFilePath = createApiModelFileForExport(libraryPath, pkgJson, exportName);
+    apiModel.loadPackage(joinPaths(modelFilePath));
+  }
+  return apiModel;
+}
+const knownConditions = ["import", "default"];
+function resolveDefinitionFilePath(libraryPath, pkgJson, exportName) {
+  const obj = pkgJson.exports?.[exportName];
+  if (!obj) {
+    throw new Error(`Cannot resolve definition file path for export ${exportName}`);
+  }
+  if (typeof obj === "string") {
+    return joinPaths(libraryPath, obj).replace(/\.js$/, ".d.ts");
+  }
+  if (typeof obj === "object" && "types" in obj) {
+    return joinPaths(libraryPath, obj.types);
+  }
+  for (const condition of knownConditions) {
+    if (condition in obj) {
+      const conditionObj = obj[condition];
+      if (typeof conditionObj === "object" && "types" in conditionObj) {
+        return joinPaths(libraryPath, conditionObj.types).replace(/\.js$/, ".d.ts");
+      }
+    }
+  }
+  throw new Error(`Cannot resolve definition file path for export ${exportName}`);
+}
+export function createApiModelFileForExport(libraryPath, pkgJson, exportName) {
+  const entrypoint = resolveDefinitionFilePath(libraryPath, pkgJson, exportName);
+  const modelFilePath = joinPaths(libraryPath, "temp", `${exportName.slice(2)}.api.json`);
+  const config = ExtractorConfig.prepare({
+    configObject: {
+      mainEntryPointFilePath: entrypoint,
+      compiler: {
+        tsconfigFilePath: joinPaths(libraryPath, "tsconfig.json")
+      },
+      docModel: {
+        enabled: true,
+        apiJsonFilePath: modelFilePath
+      },
+      projectFolder: libraryPath
+    },
+    configObjectFullPath: undefined,
+    tsdocConfigFile: TSDocConfigFile.loadFromObject({
+      $schema: "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json",
+      tagDefinitions: [{
+        tagName: "@typekit",
+        syntaxKind: "block"
+      }]
+    }),
+    packageJsonFullPath: joinPaths(libraryPath, "package.json")
+  });
+  const extractorResult = Extractor.invoke(config);
+  if (!extractorResult.succeeded) {
+    throw new Error("API Extractor failed to generate the API model");
+  }
+  return modelFilePath;
+}

package/dist/src/ref-doc/api-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-extractor.js","sourceRoot":"","sources":["../../../src/ref-doc/api-extractor.ts"],"names":[],"mappings":"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"}

package/dist/src/ref-doc/components/diagnosable-typekit-function.d.ts

@@ -0,0 +1,7 @@
+import * as ay from "@alloy-js/core";
+import { TypekitFunctionDoc } from "../typekit-docs.js";
+export interface DiagnosableTypekitFunctionProps {
+    readonly typekit: TypekitFunctionDoc;
+}
+export declare function DiagnosableTypekitFunction(props: DiagnosableTypekitFunctionProps): ay.Children;
+//# sourceMappingURL=diagnosable-typekit-function.d.ts.map

package/dist/src/ref-doc/components/diagnosable-typekit-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosable-typekit-function.d.ts","sourceRoot":"","sources":["../../../../src/ref-doc/components/diagnosable-typekit-function.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,+BAA+B,eAoChF"}

package/dist/src/ref-doc/components/diagnosable-typekit-function.js

@@ -0,0 +1,75 @@
+import { createComponent as _$createComponent, memo as _$memo } from "@alloy-js/core/jsx-runtime";
+import * as ay from "@alloy-js/core";
+import * as md from "@alloy-js/markdown";
+import * as ts from "@alloy-js/typescript";
+import { ExcerptToken } from "@microsoft/api-extractor-model";
+export function DiagnosableTypekitFunction(props) {
+  const path = [`$(program)`, ...props.typekit.path];
+  const {
+    parameters,
+    returnType
+  } = parseDiagnosableExcerpt(props.typekit.excerpt);
+  const accessorParts = path.map(x => _$createComponent(ts.MemberExpression.Part, {
+    id: x
+  }));
+  const fnSig = [_$createComponent(ts.MemberExpression, {
+    get children() {
+      return [accessorParts, _$createComponent(ts.MemberExpression.Part, {
+        get args() {
+          return [renderTokens(parameters)];
+        }
+      })];
+    }
+  }), _$memo(() => `: ${renderTokens(returnType)};`)];
+  const fnDiagSig = [_$createComponent(ts.MemberExpression, {
+    get children() {
+      return [accessorParts, _$createComponent(ts.MemberExpression.Part, {
+        id: "withDiagnostics"
+      }), _$createComponent(ts.MemberExpression.Part, {
+        get args() {
+          return [renderTokens(parameters)];
+        }
+      })];
+    }
+  }), _$memo(() => `: [${renderTokens(returnType)}, readonly Diagnostic[]];`)];
+  return _$createComponent(md.Section, {
+    get heading() {
+      return `${props.typekit.name} <Badge variant="note" text="Diagnosable" />`;
+    },
+    get children() {
+      return _$createComponent(ay.List, {
+        get children() {
+          return ["```ts", _$memo(() => props.typekit.docComment?.emitAsTsdoc().trimEnd()), fnSig, fnDiagSig, "```"];
+        }
+      });
+    }
+  });
+}
+function renderTokens(tokens) {
+  return tokens.map(x => x.text).join("");
+}
+const ARROW_FN_SEPARATOR = ") => ";
+function parseDiagnosableExcerpt(excerpt) {
+  const tokens = excerpt.spannedTokens.slice(1); // remove the function name Diagnosable
+  tokens[0] = new ExcerptToken(tokens[0].kind, tokens[0].text.slice(2)); // remove <(
+  tokens[tokens.length - 1] = new ExcerptToken(tokens[tokens.length - 1].kind, tokens[tokens.length - 1].text.slice(0, -1)); // remove >
+  const splitIndex = tokens.findIndex(x => x.text.includes(ARROW_FN_SEPARATOR));
+  if (splitIndex !== -1) {
+    if (tokens[splitIndex].text === ARROW_FN_SEPARATOR) {
+      const paramsTokens = tokens.slice(0, splitIndex);
+      const returnTypeTokens = tokens.slice(splitIndex + 1);
+      return {
+        parameters: paramsTokens,
+        returnType: returnTypeTokens
+      };
+    } else {
+      tokens[splitIndex] = new ExcerptToken(tokens[splitIndex].kind, tokens[splitIndex].text.replace(ARROW_FN_SEPARATOR, ""));
+      return {
+        parameters: tokens.slice(0, splitIndex),
+        returnType: tokens.slice(splitIndex)
+      };
+    }
+  } else {
+    throw new Error(`Cannot parse Diagnosable function signature: ${excerpt.text}.`);
+  }
+}

package/dist/src/ref-doc/components/diagnosable-typekit-function.jsx

@@ -0,0 +1,64 @@
+import * as ay from "@alloy-js/core";
+import * as md from "@alloy-js/markdown";
+import * as ts from "@alloy-js/typescript";
+import { ExcerptToken } from "@microsoft/api-extractor-model";
+export function DiagnosableTypekitFunction(props) {
+    const path = [`$(program)`, ...props.typekit.path];
+    const { parameters, returnType } = parseDiagnosableExcerpt(props.typekit.excerpt);
+    const accessorParts = path.map((x) => <ts.MemberExpression.Part id={x}/>);
+    const fnSig = (<>
+      <ts.MemberExpression>
+        {accessorParts}
+        <ts.MemberExpression.Part args={[renderTokens(parameters)]}/>
+      </ts.MemberExpression>
+      {`: ${renderTokens(returnType)};`}
+    </>);
+    const fnDiagSig = (<>
+      <ts.MemberExpression>
+        {accessorParts}
+        <ts.MemberExpression.Part id="withDiagnostics"/>
+        <ts.MemberExpression.Part args={[renderTokens(parameters)]}/>
+      </ts.MemberExpression>
+      {`: [${renderTokens(returnType)}, readonly Diagnostic[]];`}
+    </>);
+    return (<md.Section heading={`${props.typekit.name} <Badge variant="note" text="Diagnosable" />`}>
+      <ay.List>
+        {"```ts"}
+        {props.typekit.docComment?.emitAsTsdoc().trimEnd()}
+        {fnSig}
+        {fnDiagSig}
+        {"```"}
+      </ay.List>
+    </md.Section>);
+}
+function renderTokens(tokens) {
+    return tokens.map((x) => x.text).join("");
+}
+const ARROW_FN_SEPARATOR = ") => ";
+function parseDiagnosableExcerpt(excerpt) {
+    const tokens = excerpt.spannedTokens.slice(1); // remove the function name Diagnosable
+    tokens[0] = new ExcerptToken(tokens[0].kind, tokens[0].text.slice(2)); // remove <(
+    tokens[tokens.length - 1] = new ExcerptToken(tokens[tokens.length - 1].kind, tokens[tokens.length - 1].text.slice(0, -1)); // remove >
+    const splitIndex = tokens.findIndex((x) => x.text.includes(ARROW_FN_SEPARATOR));
+    if (splitIndex !== -1) {
+        if (tokens[splitIndex].text === ARROW_FN_SEPARATOR) {
+            const paramsTokens = tokens.slice(0, splitIndex);
+            const returnTypeTokens = tokens.slice(splitIndex + 1);
+            return {
+                parameters: paramsTokens,
+                returnType: returnTypeTokens,
+            };
+        }
+        else {
+            tokens[splitIndex] = new ExcerptToken(tokens[splitIndex].kind, tokens[splitIndex].text.replace(ARROW_FN_SEPARATOR, ""));
+            return {
+                parameters: tokens.slice(0, splitIndex),
+                returnType: tokens.slice(splitIndex),
+            };
+        }
+    }
+    else {
+        throw new Error(`Cannot parse Diagnosable function signature: ${excerpt.text}.`);
+    }
+}
+//# sourceMappingURL=diagnosable-typekit-function.jsx.map

package/dist/src/ref-doc/components/diagnosable-typekit-function.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosable-typekit-function.jsx","sourceRoot":"","sources":["../../../../src/ref-doc/components/diagnosable-typekit-function.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAW,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAOvE,MAAM,UAAU,0BAA0B,CAAC,KAAsC;IAC/E,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,uBAAuB,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAElF,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAG,CAAC,CAAC;IAE3E,MAAM,KAAK,GAAG,CACZ,EACE;MAAA,CAAC,EAAE,CAAC,gBAAgB,CAClB;QAAA,CAAC,aAAa,CACd;QAAA,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,EAC7D;MAAA,EAAE,EAAE,CAAC,gBAAgB,CACrB;MAAA,CAAC,KAAK,YAAY,CAAC,UAAU,CAAC,GAAG,CACnC;IAAA,GAAG,CACJ,CAAC;IACF,MAAM,SAAS,GAAG,CAChB,EACE;MAAA,CAAC,EAAE,CAAC,gBAAgB,CAClB;QAAA,CAAC,aAAa,CACd;QAAA,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,iBAAiB,EAC9C;QAAA,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,EAC7D;MAAA,EAAE,EAAE,CAAC,gBAAgB,CACrB;MAAA,CAAC,MAAM,YAAY,CAAC,UAAU,CAAC,2BAA2B,CAC5D;IAAA,GAAG,CACJ,CAAC;IACF,OAAO,CACL,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,8CAA8C,CAAC,CACvF;MAAA,CAAC,EAAE,CAAC,IAAI,CACN;QAAA,CAAC,OAAO,CACR;QAAA,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC,OAAO,EAAE,CAClD;QAAA,CAAC,KAAK,CACN;QAAA,CAAC,SAAS,CACV;QAAA,CAAC,KAAK,CACR;MAAA,EAAE,EAAE,CAAC,IAAI,CACX;IAAA,EAAE,EAAE,CAAC,OAAO,CAAC,CACd,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAAsB;IAC1C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,kBAAkB,GAAG,OAAO,CAAC;AACnC,SAAS,uBAAuB,CAAC,OAAgB;IAI/C,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,uCAAuC;IACtF,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY;IACnF,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,YAAY,CAC1C,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAC9B,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAC5C,CAAC,CAAC,WAAW;IACd,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAChF,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YACnD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACjD,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;YACtD,OAAO;gBACL,UAAU,EAAE,YAAY;gBACxB,UAAU,EAAE,gBAAgB;aAC7B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,YAAY,CACnC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,EACvB,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CACxD,CAAC;YACF,OAAO;gBACL,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;gBACvC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;aACrC,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,gDAAgD,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IACnF,CAAC;AACH,CAAC"}

package/dist/src/ref-doc/components/tsdoc.d.ts

@@ -0,0 +1,18 @@
+import { DocPlainText, DocSection, type DocNode, type DocParagraph } from "@microsoft/tsdoc";
+export interface TSDocProps {
+    readonly node: DocNode;
+}
+export declare function TsDoc(props: TSDocProps): import("@alloy-js/core").Children;
+export interface TsDocParagraphProps {
+    node: DocParagraph;
+}
+export declare function TsDocParagraph(props: TsDocParagraphProps): import("@alloy-js/core").Children[];
+export interface TsDocPlainTextProps {
+    node: DocPlainText;
+}
+export declare function TsDocPlainText(props: TsDocPlainTextProps): string;
+export interface TsDocSectionProps {
+    node: DocSection;
+}
+export declare function TsDocSection(props: TsDocSectionProps): () => import("@alloy-js/core").Children[];
+//# sourceMappingURL=tsdoc.d.ts.map

package/dist/src/ref-doc/components/tsdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsdoc.d.ts","sourceRoot":"","sources":["../../../../src/ref-doc/components/tsdoc.tsx"],"names":[],"mappings":"AACA,OAAO,EAGL,YAAY,EACZ,UAAU,EACV,KAAK,OAAO,EACZ,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,qCAWtC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAC;CACpB;AACD,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,uCAWxD;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAC;CACpB;AACD,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,UAExD;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;CAClB;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,6CAQpD"}

package/dist/src/ref-doc/components/tsdoc.js

@@ -0,0 +1,47 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { mapJoin } from "@alloy-js/core";
+import { DocNodeKind, DocNodeTransforms } from "@microsoft/tsdoc";
+export function TsDoc(props) {
+  switch (props.node.kind) {
+    case DocNodeKind.Paragraph:
+      return _$createComponent(TsDocParagraph, {
+        get node() {
+          return props.node;
+        }
+      });
+    case DocNodeKind.Section:
+      return _$createComponent(TsDocSection, {
+        get node() {
+          return props.node;
+        }
+      });
+    case DocNodeKind.PlainText:
+      return _$createComponent(TsDocPlainText, {
+        get node() {
+          return props.node;
+        }
+      });
+    default:
+      return props.node.kind;
+  }
+}
+export function TsDocParagraph(props) {
+  const trimmed = DocNodeTransforms.trimSpacesInParagraph(props.node);
+  let contentStartIndex = 0;
+  while (contentStartIndex < trimmed.nodes.length && trimmed.nodes[contentStartIndex].kind === DocNodeKind.SoftBreak) {
+    contentStartIndex++;
+  }
+  return trimmed.nodes.slice(contentStartIndex).map(node => TsDoc({
+    node
+  }));
+}
+export function TsDocPlainText(props) {
+  return props.node.text;
+}
+export function TsDocSection(props) {
+  return mapJoin(() => props.node.nodes, node => _$createComponent(TsDoc, {
+    node: node
+  }), {
+    joiner: "\n\n"
+  });
+}

package/dist/src/ref-doc/components/tsdoc.jsx

@@ -0,0 +1,32 @@
+import { mapJoin } from "@alloy-js/core";
+import { DocNodeKind, DocNodeTransforms, } from "@microsoft/tsdoc";
+export function TsDoc(props) {
+    switch (props.node.kind) {
+        case DocNodeKind.Paragraph:
+            return <TsDocParagraph node={props.node}/>;
+        case DocNodeKind.Section:
+            return <TsDocSection node={props.node}/>;
+        case DocNodeKind.PlainText:
+            return <TsDocPlainText node={props.node}/>;
+        default:
+            return props.node.kind;
+    }
+}
+export function TsDocParagraph(props) {
+    const trimmed = DocNodeTransforms.trimSpacesInParagraph(props.node);
+    let contentStartIndex = 0;
+    while (contentStartIndex < trimmed.nodes.length &&
+        trimmed.nodes[contentStartIndex].kind === DocNodeKind.SoftBreak) {
+        contentStartIndex++;
+    }
+    return trimmed.nodes.slice(contentStartIndex).map((node) => TsDoc({ node }));
+}
+export function TsDocPlainText(props) {
+    return props.node.text;
+}
+export function TsDocSection(props) {
+    return mapJoin(() => props.node.nodes, (node) => <TsDoc node={node}/>, {
+        joiner: "\n\n",
+    });
+}
+//# sourceMappingURL=tsdoc.jsx.map

package/dist/src/ref-doc/components/tsdoc.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsdoc.jsx","sourceRoot":"","sources":["../../../../src/ref-doc/components/tsdoc.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EACL,WAAW,EACX,iBAAiB,GAKlB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,WAAW,CAAC,SAAS;YACxB,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAoB,CAAC,EAAG,CAAC;QAC9D,KAAK,WAAW,CAAC,OAAO;YACtB,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAkB,CAAC,EAAG,CAAC;QAC1D,KAAK,WAAW,CAAC,SAAS;YACxB,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAoB,CAAC,EAAG,CAAC;QAC9D;YACE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAC3B,CAAC;AACH,CAAC;AAKD,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,OAAO,GAAG,iBAAiB,CAAC,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpE,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,OACE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM;QACxC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,SAAS,EAC/D,CAAC;QACD,iBAAiB,EAAE,CAAC;IACtB,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC/E,CAAC;AAKD,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;AACzB,CAAC;AAKD,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAkB,EACnC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAG,EAC/B;QACE,MAAM,EAAE,MAAM;KACf,CACF,CAAC;AACJ,CAAC"}

package/dist/src/ref-doc/components/typekit-function.d.ts

@@ -0,0 +1,7 @@
+import * as ay from "@alloy-js/core";
+import { TypekitFunctionDoc } from "../typekit-docs.js";
+export interface TypekitFunctionProps {
+    readonly typekit: TypekitFunctionDoc;
+}
+export declare function TypekitFunction(props: TypekitFunctionProps): ay.Children;
+//# sourceMappingURL=typekit-function.d.ts.map

package/dist/src/ref-doc/components/typekit-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typekit-function.d.ts","sourceRoot":"","sources":["../../../../src/ref-doc/components/typekit-function.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,eA+B1D"}

package/dist/src/ref-doc/components/typekit-function.js

@@ -0,0 +1,38 @@
+import { createComponent as _$createComponent, memo as _$memo } from "@alloy-js/core/jsx-runtime";
+import * as ay from "@alloy-js/core";
+import * as md from "@alloy-js/markdown";
+import * as ts from "@alloy-js/typescript";
+import { DiagnosableTypekitFunction } from "./diagnosable-typekit-function.js";
+export function TypekitFunction(props) {
+  if (props.typekit.kind === "diagnosable") {
+    return _$createComponent(DiagnosableTypekitFunction, {
+      get typekit() {
+        return props.typekit;
+      }
+    });
+  }
+  const path = [`$(program)`, ...props.typekit.path];
+  const sig = props.typekit.kind === "getter" ? [] : _$createComponent(ts.MemberExpression.Part, {
+    get args() {
+      return props.typekit.parameters.map(x => `${x.name}: ${x.typeExcerpt.text}`);
+    }
+  });
+  return _$createComponent(md.Section, {
+    get heading() {
+      return props.typekit.name;
+    },
+    get children() {
+      return _$createComponent(ay.List, {
+        get children() {
+          return ["```ts", _$memo(() => props.typekit.docComment?.emitAsTsdoc().trimEnd()), [_$createComponent(ts.MemberExpression, {
+            get children() {
+              return [_$memo(() => path.map(x => _$createComponent(ts.MemberExpression.Part, {
+                id: x
+              }))), sig];
+            }
+          }), [": ", _$memo(() => props.typekit.returnTypeExcerpt.text), ";"]], "```"];
+        }
+      });
+    }
+  });
+}

package/dist/src/ref-doc/components/typekit-function.jsx

@@ -0,0 +1,26 @@
+import * as ay from "@alloy-js/core";
+import * as md from "@alloy-js/markdown";
+import * as ts from "@alloy-js/typescript";
+import { DiagnosableTypekitFunction } from "./diagnosable-typekit-function.jsx";
+export function TypekitFunction(props) {
+    if (props.typekit.kind === "diagnosable") {
+        return <DiagnosableTypekitFunction typekit={props.typekit}/>;
+    }
+    const path = [`$(program)`, ...props.typekit.path];
+    const sig = props.typekit.kind === "getter" ? (<></>) : (<ts.MemberExpression.Part args={props.typekit.parameters.map((x) => `${x.name}: ${x.typeExcerpt.text}`)}/>);
+    return (<md.Section heading={props.typekit.name}>
+      <ay.List>
+        {"```ts"}
+        {props.typekit.docComment?.emitAsTsdoc().trimEnd()}
+        <>
+          <ts.MemberExpression>
+            {path.map((x) => (<ts.MemberExpression.Part id={x}/>))}
+            {sig}
+          </ts.MemberExpression>
+          <>: {props.typekit.returnTypeExcerpt.text};</>
+        </>
+        {"```"}
+      </ay.List>
+    </md.Section>);
+}
+//# sourceMappingURL=typekit-function.jsx.map

package/dist/src/ref-doc/components/typekit-function.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"typekit-function.jsx","sourceRoot":"","sources":["../../../../src/ref-doc/components/typekit-function.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE3C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAMhF,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACzC,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAG,CAAC;IAChE,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,GAAG,GACP,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAChC,EAAE,GAAG,CACN,CAAC,CAAC,CAAC,CACF,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CACvB,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,EAC/E,CACH,CAAC;IACJ,OAAO,CACL,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CACtC;MAAA,CAAC,EAAE,CAAC,IAAI,CACN;QAAA,CAAC,OAAO,CACR;QAAA,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC,OAAO,EAAE,CAClD;QAAA,EACE;UAAA,CAAC,EAAE,CAAC,gBAAgB,CAClB;YAAA,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CACf,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAG,CACpC,CAAC,CACF;YAAA,CAAC,GAAG,CACN;UAAA,EAAE,EAAE,CAAC,gBAAgB,CACrB;UAAA,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAC7C;QAAA,GACA;QAAA,CAAC,KAAK,CACR;MAAA,EAAE,EAAE,CAAC,IAAI,CACX;IAAA,EAAE,EAAE,CAAC,OAAO,CAAC,CACd,CAAC;AACJ,CAAC"}

package/dist/src/ref-doc/components/typekit-section.d.ts

@@ -0,0 +1,7 @@
+import * as ay from "@alloy-js/core";
+import { TypekitNamespace } from "../typekit-docs.js";
+export interface TypekitSectionProps {
+    readonly typekit: TypekitNamespace;
+}
+export declare function TypekitSection(props: TypekitSectionProps): ay.Children;
+//# sourceMappingURL=typekit-section.d.ts.map

package/dist/src/ref-doc/components/typekit-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typekit-section.d.ts","sourceRoot":"","sources":["../../../../src/ref-doc/components/typekit-section.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAItD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,eASxD"}

package/dist/src/ref-doc/components/typekit-section.js

@@ -0,0 +1,30 @@
+import { memo as _$memo, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import * as ay from "@alloy-js/core";
+import * as md from "@alloy-js/markdown";
+import { TsDoc } from "./tsdoc.js";
+import { TypekitFunction } from "./typekit-function.js";
+export function TypekitSection(props) {
+  return _$createComponent(md.Section, {
+    get heading() {
+      return props.typekit.name;
+    },
+    get children() {
+      return [_$createComponent(ay.Prose, {
+        get children() {
+          return _$memo(() => !!props.typekit.doc)() && _$createComponent(TsDoc, {
+            get node() {
+              return props.typekit.doc;
+            }
+          });
+        }
+      }), _$createComponent(ay.For, {
+        get each() {
+          return Object.values(props.typekit.entries);
+        },
+        children: x => _$createComponent(TypekitFunction, {
+          typekit: x
+        })
+      })];
+    }
+  });
+}

package/dist/src/ref-doc/components/typekit-section.jsx

@@ -0,0 +1,13 @@
+import * as ay from "@alloy-js/core";
+import * as md from "@alloy-js/markdown";
+import { TsDoc } from "./tsdoc.jsx";
+import { TypekitFunction } from "./typekit-function.jsx";
+export function TypekitSection(props) {
+    return (<md.Section heading={props.typekit.name}>
+      <ay.Prose>{props.typekit.doc && <TsDoc node={props.typekit.doc}/>}</ay.Prose>
+      <ay.For each={Object.values(props.typekit.entries)}>
+        {(x) => <TypekitFunction typekit={x}/>}
+      </ay.For>
+    </md.Section>);
+}
+//# sourceMappingURL=typekit-section.jsx.map

package/dist/src/ref-doc/components/typekit-section.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"typekit-section.jsx","sourceRoot":"","sources":["../../../../src/ref-doc/components/typekit-section.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEzC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAMzD,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,OAAO,CACL,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CACtC;MAAA,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAG,CAAC,EAAE,EAAE,CAAC,KAAK,CAC7E;MAAA,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CACjD;QAAA,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAQ,CAAC,EAAG,CAChD;MAAA,EAAE,EAAE,CAAC,GAAG,CACV;IAAA,EAAE,EAAE,CAAC,OAAO,CAAC,CACd,CAAC;AACJ,CAAC"}

package/dist/src/ref-doc/components/typekits-file.d.ts

@@ -0,0 +1,3 @@
+import { TypekitCollection } from "../typekit-docs.js";
+export declare function createTypekitDocs(typekit: TypekitCollection): Promise<Record<string, string>>;
+//# sourceMappingURL=typekits-file.d.ts.map

package/dist/src/ref-doc/components/typekits-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typekits-file.d.ts","sourceRoot":"","sources":["../../../../src/ref-doc/components/typekits-file.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,mCAsB3D"}

package/dist/src/ref-doc/components/typekits-file.js

@@ -0,0 +1,58 @@
+import { memo as _$memo, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import * as ay from "@alloy-js/core";
+import * as md from "@alloy-js/markdown";
+import { format as prettierFormat } from "prettier";
+import { TypekitSection } from "./typekit-section.js";
+export function createTypekitDocs(typekit) {
+  const jsxContent = _$createComponent(ay.Output, {
+    get children() {
+      return _$createComponent(md.SourceFile, {
+        path: `typekits.mdx`,
+        get children() {
+          return [[_$memo(() => ay.code`
+        ---
+        title: "[API] Typekits"
+        ---
+        import { Badge } from '@astrojs/starlight/components';
+        `)], _$createComponent(md.Section, {
+            get children() {
+              return _$createComponent(ay.For, {
+                get each() {
+                  return Object.values(typekit.namespaces);
+                },
+                children: x => _$createComponent(TypekitSection, {
+                  typekit: x
+                })
+              });
+            }
+          })];
+        }
+      });
+    }
+  });
+  return flattenOutput(ay.render(jsxContent));
+}
+async function flattenOutput(output) {
+  const files = {};
+  const rawFiles = [];
+  ay.traverseOutput(output, {
+    visitDirectory: () => {},
+    visitFile: file => rawFiles.push(file)
+  });
+  for (const file of rawFiles) {
+    files[file.path] = await format(file.contents);
+  }
+  return files;
+}
+function format(value) {
+  try {
+    const formatted = prettierFormat(value, {
+      parser: "markdown"
+    });
+    return formatted;
+  } catch (e) {
+    // eslint-disable-next-line no-console
+    console.error("Error formatting", e);
+    return value;
+  }
+}

package/dist/src/ref-doc/components/typekits-file.jsx

@@ -0,0 +1,50 @@
+import * as ay from "@alloy-js/core";
+import * as md from "@alloy-js/markdown";
+import { format as prettierFormat } from "prettier";
+import { TypekitSection } from "./typekit-section.js";
+export function createTypekitDocs(typekit) {
+    const jsxContent = (<ay.Output>
+      <md.SourceFile path={`typekits.mdx`}>
+        <>
+          {ay.code `
+        ---
+        title: "[API] Typekits"
+        ---
+        import { Badge } from '@astrojs/starlight/components';
+        `}
+        </>
+        <md.Section>
+          <ay.For each={Object.values(typekit.namespaces)}>
+            {(x) => <TypekitSection typekit={x}/>}
+          </ay.For>
+        </md.Section>
+      </md.SourceFile>
+    </ay.Output>);
+    return flattenOutput(ay.render(jsxContent));
+}
+async function flattenOutput(output) {
+    const files = {};
+    const rawFiles = [];
+    ay.traverseOutput(output, {
+        visitDirectory: () => { },
+        visitFile: (file) => rawFiles.push(file),
+    });
+    for (const file of rawFiles) {
+        files[file.path] = await format(file.contents);
+    }
+    return files;
+}
+function format(value) {
+    try {
+        const formatted = prettierFormat(value, {
+            parser: "markdown",
+        });
+        return formatted;
+    }
+    catch (e) {
+        // eslint-disable-next-line no-console
+        console.error("Error formatting", e);
+        return value;
+    }
+}
+//# sourceMappingURL=typekits-file.jsx.map

package/dist/src/ref-doc/components/typekits-file.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"typekits-file.jsx","sourceRoot":"","sources":["../../../../src/ref-doc/components/typekits-file.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,UAAU,iBAAiB,CAAC,OAA0B;IAC1D,MAAM,UAAU,GAAG,CACjB,CAAC,EAAE,CAAC,MAAM,CACR;MAAA,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,CAClC;QAAA,EACE;UAAA,CAAC,EAAE,CAAC,IAAI,CAAA;;;;;SAKT,CACD;QAAA,GACA;QAAA,CAAC,EAAE,CAAC,OAAO,CACT;UAAA,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAC9C;YAAA,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAG,CACxC;UAAA,EAAE,EAAE,CAAC,GAAG,CACV;QAAA,EAAE,EAAE,CAAC,OAAO,CACd;MAAA,EAAE,EAAE,CAAC,UAAU,CACjB;IAAA,EAAE,EAAE,CAAC,MAAM,CAAC,CACb,CAAC;IAEF,OAAO,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAA0B;IACrD,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE;QACxB,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;QACxB,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;KACzC,CAAC,CAAC;IAEH,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE;YACtC,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/src/ref-doc/experimental.d.ts

@@ -2,6 +2,7 @@ import { Diagnostic } from "@typespec/compiler";
 import { ExtractRefDocOptions } from "./extractor.js";
 import { TypeSpecRefDocBase } from "./types.js";
 export interface GenerateLibraryDocsOptions {
+    typekits?: boolean;
     skipJSApi?: boolean;
 }
 /**

package/dist/src/ref-doc/experimental.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../../../src/ref-doc/experimental.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EAIX,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAyB,oBAAoB,EAAkB,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AACD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAqBhC;AAED,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,CAAC,kBAAkB,EAAE,SAAS,UAAU,EAAE,CAAC,GAAG,SAAS,CAAC,CAelE"}
+{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../../../src/ref-doc/experimental.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EAGX,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAyB,oBAAoB,EAAkB,MAAM,gBAAgB,CAAC;AAE7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AACD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CA0BhC;AAED,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,CAAC,kBAAkB,EAAE,SAAS,UAAU,EAAE,CAAC,GAAG,SAAS,CAAC,CAelE"}

package/dist/src/ref-doc/experimental.js

@@ -1,10 +1,12 @@
 import { compile, createDiagnosticCollector, joinPaths, NodeHost } from "@typespec/compiler";
-import { mkdir, readFile, writeFile } from "fs/promises";
+import { mkdir, writeFile } from "fs/promises";
 import prettier from "prettier";
 import { generateJsApiDocs } from "./api-docs.js";
 import { renderReadme } from "./emitters/markdown.js";
 import { renderToAstroStarlightMarkdown } from "./emitters/starlight.js";
 import { extractLibraryRefDocs, extractRefDocs } from "./extractor.js";
+import { writeTypekitDocs } from "./typekit-docs.js";
+import { readPackageJson } from "./utils/misc.js";
 /**
  * @experimental this is for experimental and is for internal use only. Breaking change to this API can happen at anytime.
  */
@@ -23,8 +25,13 @@ export async function generateLibraryDocs(libraryPath, outputDir, options = {})
   }
   const readme = await formatMarkdown(joinPaths(libraryPath, "README.md"), await renderReadme(refDoc, libraryPath), config ?? {});
   await writeFile(joinPaths(libraryPath, "README.md"), readme);
-  if (pkgJson.main && !options.skipJSApi) {
-    await generateJsApiDocs(libraryPath, joinPaths(outputDir, "js-api"));
+  if (!options.skipJSApi) {
+    if (options.typekits) {
+      await writeTypekitDocs(libraryPath, outputDir);
+    }
+    if (pkgJson.main) {
+      await generateJsApiDocs(libraryPath, joinPaths(outputDir, "js-api"));
+    }
   }
   return diagnostics.diagnostics;
 }
@@ -47,10 +54,6 @@ export async function resolveLibraryRefDocsBase(libraryPath, options = {}) {
   }
   return undefined;
 }
-async function readPackageJson(libraryPath) {
-  const buffer = await readFile(joinPaths(libraryPath, "package.json"));
-  return JSON.parse(buffer.toString());
-}
 async function formatMarkdown(filename, content, options) {
   try {
     return await prettier.format(content, {

package/dist/src/ref-doc/experimental.js.map

@@ -1 +1 @@
-{"version":3,"file":"experimental.js","sourceRoot":"","sources":["../../../src/ref-doc/experimental.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"experimental.js","sourceRoot":"","sources":["../../../src/ref-doc/experimental.ts"],"names":[],"mappings":"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"}

package/dist/src/ref-doc/index.d.ts

@@ -2,4 +2,5 @@ export * from "./api-docs.js";
 export * from "./experimental.js";
 export * from "./extractor.js";
 export * from "./lib.js";
+export { writeTypekitDocs } from "./typekit-docs.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/ref-doc/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ref-doc/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ref-doc/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/ref-doc/index.js

@@ -1,4 +1,5 @@
 export * from "./api-docs.js";
 export * from "./experimental.js";
 export * from "./extractor.js";
-export * from "./lib.js";
+export * from "./lib.js";
+export { writeTypekitDocs } from "./typekit-docs.js";

package/dist/src/ref-doc/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ref-doc/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ref-doc/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/ref-doc/typekit-docs.d.ts

@@ -0,0 +1,50 @@
+import { Excerpt } from "@microsoft/api-extractor-model";
+import { type DocComment, type DocSection } from "@microsoft/tsdoc";
+export interface TypekitCollection {
+    namespaces: Record<string, TypekitNamespace>;
+}
+export interface TypekitNamespace {
+    name: string;
+    typeName: string;
+    doc?: DocSection;
+    entries: Record<string, TypekitEntryDoc>;
+}
+type TypekitEntryDoc = TypekitNamespace | TypekitFunctionDoc;
+export interface TypekitFunctionDoc {
+    kind: "getter" | "method" | "diagnosable";
+    /**
+     * Name of the function(Last part of the path)
+     * @example For `$(program).foo.bar.baz()` the name is `baz`
+     */
+    name: string;
+    /**
+     * Full typekit path under $
+     * @example For `$(program).foo.bar.baz()` the path is `["foo", "bar", "baz"]`
+     */
+    path: string[];
+    /**
+     * Parameters of the function. Undefined for getters.
+     */
+    parameters?: TsFunctionParameter[];
+    /**
+     * Doc comment
+     */
+    docComment?: DocComment;
+    /**
+     * The excerpt of the function
+     */
+    excerpt: Excerpt;
+    /**
+     * The excerpt of the return type
+     */
+    returnTypeExcerpt: Excerpt;
+}
+export interface TsFunctionParameter {
+    name: string;
+    doc: string;
+    optional: boolean;
+    typeExcerpt: Excerpt;
+}
+export declare function writeTypekitDocs(libraryPath: string, outputDir: string): Promise<void>;
+export {};
+//# sourceMappingURL=typekit-docs.d.ts.map

package/dist/src/ref-doc/typekit-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typekit-docs.d.ts","sourceRoot":"","sources":["../../../src/ref-doc/typekit-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,OAAO,EACR,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAW,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAO7E,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C;AAED,KAAK,eAAe,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC1C;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;OAEG;IACH,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAEnC;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5F"}

package/dist/src/ref-doc/typekit-docs.js

@@ -0,0 +1,99 @@
+import { ApiInterface, ApiMethodSignature, ApiProperty, ApiPropertySignature } from "@microsoft/api-extractor-model";
+import { joinPaths } from "@typespec/compiler";
+import { writeFile } from "fs/promises";
+import { createApiModel } from "./api-extractor.js";
+import { createTypekitDocs } from "./components/typekits-file.js";
+import { readPackageJson } from "./utils/misc.js";
+export async function writeTypekitDocs(libraryPath, outputDir) {
+  const pkgJson = await readPackageJson(libraryPath);
+  const typekits = await getTypekitApi(libraryPath, pkgJson);
+  if (!typekits) {
+    return;
+  }
+  const output = await createTypekitDocs(typekits);
+  for (const [file, content] of Object.entries(output)) {
+    await writeFile(joinPaths(outputDir, file), content);
+  }
+}
+async function getTypekitApi(libraryPath, pkgJson) {
+  const api = await createApiModel(libraryPath, pkgJson);
+  if (!api) {
+    return undefined;
+  }
+  const namespaces = {};
+  for (const pkgMember of api.packages[0].members) {
+    for (const member of pkgMember.members) {
+      if (member instanceof ApiInterface) {
+        const docComment = member.tsdocComment;
+        const typekitTag = docComment?.customBlocks.find(x => x.blockTag.tagName === "@typekit");
+        if (typekitTag) {
+          const name = typekitTag.content.nodes[0].nodes.filter(x => x.kind === "PlainText")[0].text;
+          const typekit = resolveTypekit(member, [name]);
+          namespaces[name] = typekit;
+        }
+      }
+    }
+  }
+  function resolveTypekit(iface, path) {
+    const typekit = {
+      name: path[0],
+      typeName: iface.displayName,
+      doc: iface.tsdocComment?.summarySection,
+      entries: {}
+    };
+    for (const member of iface.members) {
+      if (member instanceof ApiPropertySignature) {
+        const propertyReference = member.propertyTypeExcerpt.spannedTokens[0].canonicalReference;
+        if (propertyReference) {
+          const subkit = api.resolveDeclarationReference(propertyReference, member);
+          if (subkit.resolvedApiItem instanceof ApiInterface) {
+            typekit.entries[member.displayName] = resolveTypekit(subkit.resolvedApiItem, [...path, member.displayName]);
+          } else if (propertyReference.toString() === "@typespec/compiler!Diagnosable:type") {
+            typekit.entries[member.displayName] = {
+              kind: "diagnosable",
+              name: member.displayName,
+              docComment: member.tsdocComment,
+              path: [...path, member.displayName],
+              excerpt: member.propertyTypeExcerpt,
+              returnTypeExcerpt: member.propertyTypeExcerpt
+            };
+          } else {
+            throw new Error(`All typekits properties should be sub kits but got a ${subkit.resolvedApiItem?.kind} for ${path.join(".")}.${member.displayName}: ${subkit.errorMessage}`);
+          }
+        }
+      } else if (member instanceof ApiMethodSignature) {
+        typekit.entries[member.displayName] = {
+          kind: "method",
+          name: member.displayName,
+          docComment: member.tsdocComment,
+          path: [...path, member.displayName],
+          parameters: member.parameters.map(param => ({
+            doc: "TODO doc",
+            name: param.name,
+            optional: param.isOptional,
+            typeExcerpt: param.parameterTypeExcerpt
+          })),
+          excerpt: member.excerpt,
+          returnTypeExcerpt: member.returnTypeExcerpt
+        };
+      } else if (member instanceof ApiProperty) {
+        typekit.entries[member.displayName] = {
+          kind: "getter",
+          name: member.displayName,
+          docComment: member.tsdocComment,
+          path: [...path, member.displayName],
+          parameters: [],
+          excerpt: member.excerpt,
+          returnTypeExcerpt: member.propertyTypeExcerpt
+        };
+      } else {
+        // eslint-disable-next-line no-console
+        console.warn(`Unknown member: ${member.displayName} of kind ${member.kind}`);
+      }
+    }
+    return typekit;
+  }
+  return {
+    namespaces
+  };
+}

package/dist/src/ref-doc/typekit-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typekit-docs.js","sourceRoot":"","sources":["../../../src/ref-doc/typekit-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,oBAAoB,GAErB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,SAAS,EAAe,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAsDlD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,SAAiB;IAC3E,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IAEnD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,WAAmB,EACnB,OAAoB;IAEpB,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,UAAU,GAAqC,EAAE,CAAC;IACxD,KAAK,MAAM,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAChD,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACvC,IAAI,MAAM,YAAY,YAAY,EAAE,CAAC;gBACnC,MAAM,UAAU,GAA4B,MAA4B,CAAC,YAAY,CAAC;gBACtF,MAAM,UAAU,GAAG,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC;gBAC3F,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,IAAI,GAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAS,CAAC,KAAK,CAAC,MAAM,CAC5D,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CACvC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;oBACV,MAAM,OAAO,GAAqB,cAAc,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;oBACjE,UAAU,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,cAAc,CAAC,KAAmB,EAAE,IAAc;QACzD,MAAM,OAAO,GAAqB;YAChC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACb,QAAQ,EAAE,KAAK,CAAC,WAAW;YAC3B,GAAG,EAAE,KAAK,CAAC,YAAY,EAAE,cAAc;YACvC,OAAO,EAAE,EAAE;SACZ,CAAC;QACF,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,MAAM,YAAY,oBAAoB,EAAE,CAAC;gBAC3C,MAAM,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC;gBACzF,IAAI,iBAAiB,EAAE,CAAC;oBACtB,MAAM,MAAM,GAAG,GAAI,CAAC,2BAA2B,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;oBAC3E,IAAI,MAAM,CAAC,eAAe,YAAY,YAAY,EAAE,CAAC;wBACnD,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,cAAc,CAClD,MAAM,CAAC,eAA+B,EACtC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,CAC9B,CAAC;oBACJ,CAAC;yBAAM,IAAI,iBAAiB,CAAC,QAAQ,EAAE,KAAK,qCAAqC,EAAE,CAAC;wBAClF,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG;4BACpC,IAAI,EAAE,aAAa;4BACnB,IAAI,EAAE,MAAM,CAAC,WAAW;4BACxB,UAAU,EAAE,MAAM,CAAC,YAAY;4BAC/B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC;4BACnC,OAAO,EAAE,MAAM,CAAC,mBAAmB;4BACnC,iBAAiB,EAAE,MAAM,CAAC,mBAAmB;yBAC9C,CAAC;oBACJ,CAAC;yBAAM,CAAC;wBACN,MAAM,IAAI,KAAK,CACb,wDAAwD,MAAM,CAAC,eAAe,EAAE,IAAI,QAAQ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,YAAY,EAAE,CAC3J,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,MAAM,YAAY,kBAAkB,EAAE,CAAC;gBAChD,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG;oBACpC,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,MAAM,CAAC,WAAW;oBACxB,UAAU,EAAE,MAAM,CAAC,YAAY;oBAC/B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC;oBACnC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBAC5C,GAAG,EAAE,UAAU;wBACf,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,QAAQ,EAAE,KAAK,CAAC,UAAU;wBAC1B,WAAW,EAAE,KAAK,CAAC,oBAAoB;qBACxC,CAAC,CAAC;oBACH,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;iBAC5C,CAAC;YACJ,CAAC;iBAAM,IAAI,MAAM,YAAY,WAAW,EAAE,CAAC;gBACzC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG;oBACpC,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,MAAM,CAAC,WAAW;oBACxB,UAAU,EAAE,MAAM,CAAC,YAAY;oBAC/B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC;oBACnC,UAAU,EAAE,EAAE;oBACd,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,iBAAiB,EAAE,MAAM,CAAC,mBAAmB;iBAC9C,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,sCAAsC;gBACtC,OAAO,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,WAAW,YAAY,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/src/ref-doc/utils/misc.d.ts

@@ -0,0 +1,3 @@
+import { type PackageJson } from "@typespec/compiler";
+export declare function readPackageJson(libraryPath: string): Promise<PackageJson>;
+//# sourceMappingURL=misc.d.ts.map

package/dist/src/ref-doc/utils/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../../src/ref-doc/utils/misc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAa,MAAM,oBAAoB,CAAC;AAGjE,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAG/E"}

package/dist/src/ref-doc/utils/misc.js

@@ -0,0 +1,6 @@
+import { joinPaths } from "@typespec/compiler";
+import { readFile } from "fs/promises";
+export async function readPackageJson(libraryPath) {
+  const buffer = await readFile(joinPaths(libraryPath, "package.json"));
+  return JSON.parse(buffer.toString());
+}

package/dist/src/ref-doc/utils/misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../../../src/ref-doc/utils/misc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB;IACvD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;AACvC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typespec/tspd",
-  "version": "0.71.0-dev.0",
+  "version": "0.71.0-dev.1",
   "author": "Microsoft Corporation",
   "description": "TypeSpec library for generating TypeSpec docs",
   "homepage": "https://typespec.io",
@@ -45,14 +45,18 @@
   ],
   "dependencies": {
     "@alloy-js/core": "^0.15.0",
+    "@alloy-js/markdown": "^0.15.1",
     "@alloy-js/typescript": "^0.15.0",
+    "@microsoft/api-extractor-model": "^7.30.6",
+    "@microsoft/tsdoc": "^0.15.1",
+    "@microsoft/tsdoc-config": "^0.17.1",
     "@typespec/compiler": "^1.0.0",
     "picocolors": "~1.1.1",
     "prettier": "~3.5.3",
-    "yaml": "~2.7.0",
-    "yargs": "~17.7.2",
     "typedoc": "^0.28.1",
-    "typedoc-plugin-markdown": "^4.5.2"
+    "typedoc-plugin-markdown": "^4.5.2",
+    "yaml": "~2.7.0",
+    "yargs": "~17.7.2"
   },
   "devDependencies": {
     "@alloy-js/cli": "^0.15.0",