@typespec/tspd 0.70.0-dev.2 → 0.70.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/dist/src/cli.js +85 -103
  2. package/dist/src/gen-extern-signatures/components/decorator-signature-tests.d.ts +8 -0
  3. package/dist/src/gen-extern-signatures/components/decorator-signature-tests.d.ts.map +1 -0
  4. package/dist/src/gen-extern-signatures/components/decorator-signature-tests.js +16 -0
  5. package/dist/src/gen-extern-signatures/components/decorator-signature-tests.jsx +12 -0
  6. package/dist/src/gen-extern-signatures/components/decorator-signature-tests.jsx.map +1 -0
  7. package/dist/src/gen-extern-signatures/components/decorator-signature-type.d.ts +16 -0
  8. package/dist/src/gen-extern-signatures/components/decorator-signature-type.d.ts.map +1 -0
  9. package/dist/src/gen-extern-signatures/components/decorator-signature-type.js +404 -0
  10. package/dist/src/gen-extern-signatures/components/decorator-signature-type.jsx +316 -0
  11. package/dist/src/gen-extern-signatures/components/decorator-signature-type.jsx.map +1 -0
  12. package/dist/src/gen-extern-signatures/components/decorators-signatures.d.ts +12 -0
  13. package/dist/src/gen-extern-signatures/components/decorators-signatures.d.ts.map +1 -0
  14. package/dist/src/gen-extern-signatures/components/decorators-signatures.js +107 -0
  15. package/dist/src/gen-extern-signatures/components/decorators-signatures.jsx +60 -0
  16. package/dist/src/gen-extern-signatures/components/decorators-signatures.jsx.map +1 -0
  17. package/dist/src/gen-extern-signatures/components/dollar-decorators-type.d.ts +10 -0
  18. package/dist/src/gen-extern-signatures/components/dollar-decorators-type.d.ts.map +1 -0
  19. package/dist/src/gen-extern-signatures/components/dollar-decorators-type.js +39 -0
  20. package/dist/src/gen-extern-signatures/components/dollar-decorators-type.jsx +18 -0
  21. package/dist/src/gen-extern-signatures/components/dollar-decorators-type.jsx.map +1 -0
  22. package/dist/src/gen-extern-signatures/components/tspd-context.d.ts +10 -0
  23. package/dist/src/gen-extern-signatures/components/tspd-context.d.ts.map +1 -0
  24. package/dist/src/gen-extern-signatures/components/tspd-context.js +22 -0
  25. package/dist/src/gen-extern-signatures/components/tspd-context.js.map +1 -0
  26. package/dist/src/gen-extern-signatures/doc-builder.js +10 -12
  27. package/dist/src/gen-extern-signatures/external-packages/compiler.d.ts +17 -0
  28. package/dist/src/gen-extern-signatures/external-packages/compiler.d.ts.map +1 -0
  29. package/dist/src/gen-extern-signatures/external-packages/compiler.js +10 -0
  30. package/dist/src/gen-extern-signatures/external-packages/compiler.js.map +1 -0
  31. package/dist/src/gen-extern-signatures/gen-extern-signatures.d.ts.map +1 -1
  32. package/dist/src/gen-extern-signatures/gen-extern-signatures.js +109 -102
  33. package/dist/src/gen-extern-signatures/gen-extern-signatures.js.map +1 -1
  34. package/dist/src/gen-extern-signatures/types.js +1 -2
  35. package/dist/src/ref-doc/api-docs.js +56 -56
  36. package/dist/src/ref-doc/emitters/docusaurus.js +156 -209
  37. package/dist/src/ref-doc/emitters/markdown.js +278 -327
  38. package/dist/src/ref-doc/emitters/starlight.js +154 -190
  39. package/dist/src/ref-doc/experimental.js +48 -45
  40. package/dist/src/ref-doc/extractor.js +486 -449
  41. package/dist/src/ref-doc/index.js +1 -2
  42. package/dist/src/ref-doc/lib.js +29 -26
  43. package/dist/src/ref-doc/types.js +1 -2
  44. package/dist/src/ref-doc/utils/markdown.js +37 -44
  45. package/dist/src/ref-doc/utils/type-signature.js +89 -98
  46. package/package.json +12 -9
  47. package/dist/src/gen-extern-signatures/decorators-signatures.d.ts +0 -5
  48. package/dist/src/gen-extern-signatures/decorators-signatures.d.ts.map +0 -1
  49. package/dist/src/gen-extern-signatures/decorators-signatures.js +0 -338
  50. package/dist/src/gen-extern-signatures/decorators-signatures.js.map +0 -1
@@ -1,14 +1,12 @@
1
1
  export function renderDoc(doc) {
2
- const flattened = [];
3
- function render(doc) {
4
- if (typeof doc === "string") {
5
- flattened.push(doc);
6
- }
7
- else {
8
- doc.forEach(render);
9
- }
2
+ const flattened = [];
3
+ function render(doc) {
4
+ if (typeof doc === "string") {
5
+ flattened.push(doc);
6
+ } else {
7
+ doc.forEach(render);
10
8
  }
11
- render(doc);
12
- return flattened.join("");
13
- }
14
- //# sourceMappingURL=doc-builder.js.map
9
+ }
10
+ render(doc);
11
+ return flattened.join("");
12
+ }
@@ -0,0 +1,17 @@
1
+ export declare const typespecCompiler: {} & {
2
+ DecoratorContext: import("@alloy-js/core").Refkey;
3
+ Type: import("@alloy-js/core").Refkey;
4
+ Namespace: import("@alloy-js/core").Refkey;
5
+ Model: import("@alloy-js/core").Refkey;
6
+ ModelProperty: import("@alloy-js/core").Refkey;
7
+ Enum: import("@alloy-js/core").Refkey;
8
+ EnumMember: import("@alloy-js/core").Refkey;
9
+ Operation: import("@alloy-js/core").Refkey;
10
+ Interface: import("@alloy-js/core").Refkey;
11
+ Union: import("@alloy-js/core").Refkey;
12
+ UnionVariant: import("@alloy-js/core").Refkey;
13
+ Scalar: import("@alloy-js/core").Refkey;
14
+ EnumValue: import("@alloy-js/core").Refkey;
15
+ Numeric: import("@alloy-js/core").Refkey;
16
+ } & import("@alloy-js/core").SymbolCreator;
17
+ //# sourceMappingURL=compiler.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../../src/gen-extern-signatures/external-packages/compiler.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;0CAuB3B,CAAC"}
@@ -0,0 +1,10 @@
1
+ import { createPackage } from "@alloy-js/typescript";
2
+ export const typespecCompiler = createPackage({
3
+ name: "@typespec/compiler",
4
+ version: "^1.0.0",
5
+ descriptor: {
6
+ ".": {
7
+ named: ["DecoratorContext", "Type", "Namespace", "Model", "ModelProperty", "Enum", "EnumMember", "Operation", "Interface", "Union", "UnionVariant", "Scalar", "EnumValue", "Numeric"]
8
+ }
9
+ }
10
+ });
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compiler.js","sourceRoot":"","sources":["../../../../src/gen-extern-signatures/external-packages/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE;QACV,GAAG,EAAE;YACH,KAAK,EAAE;gBACL,kBAAkB;gBAClB,MAAM;gBACN,WAAW;gBACX,OAAO;gBACP,eAAe;gBACf,MAAM;gBACN,YAAY;gBACZ,WAAW;gBACX,WAAW;gBACX,OAAO;gBACP,cAAc;gBACd,QAAQ;gBACR,WAAW;gBACX,SAAS;aACV;SACF;KACF;CACF,CAAC,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"gen-extern-signatures.d.ts","sourceRoot":"","sources":["../../../src/gen-extern-signatures/gen-extern-signatures.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,UAAU,EACV,SAAS,EACT,KAAK,WAAW,EAChB,OAAO,EAYR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAQhC,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAiChC;AAED,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,CAAC,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC,CAAC,CAsB7C;AAOD,MAAM,WAAW,8BAA8B;IAC7C,+GAA+G;IAC/G,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC;CAC5C;AACD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsDjC"}
1
+ {"version":3,"file":"gen-extern-signatures.d.ts","sourceRoot":"","sources":["../../../src/gen-extern-signatures/gen-extern-signatures.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EAEZ,UAAU,EACV,SAAS,EACT,KAAK,WAAW,EAChB,OAAO,EAYR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAQhC,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAiChC;AAED,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,CAAC,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC,CAAC,CAsB7C;AAOD,MAAM,WAAW,8BAA8B;IAC7C,+GAA+G;IAC/G,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC;CAC5C;AACD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAwDjC"}
@@ -1,122 +1,129 @@
1
- import { compile, createDiagnosticCollector, createSourceFile, getLocationContext, getTypeName, joinPaths, navigateProgram, navigateTypesInNamespace, resolvePath, } from "@typespec/compiler";
1
+ import { traverseOutput } from "@alloy-js/core";
2
+ import { compile, createDiagnosticCollector, createSourceFile, getLocationContext, getTypeName, joinPaths, navigateProgram, navigateTypesInNamespace, resolvePath } from "@typespec/compiler";
2
3
  import prettier from "prettier";
3
4
  import { createDiagnostic } from "../ref-doc/lib.js";
4
- import { generateSignatureTests, generateSignatures } from "./decorators-signatures.js";
5
+ import { generateSignatures } from "./components/decorators-signatures.js";
5
6
  function createSourceLocation(path) {
6
- return { file: createSourceFile("", path), pos: 0, end: 0 };
7
+ return {
8
+ file: createSourceFile("", path),
9
+ pos: 0,
10
+ end: 0
11
+ };
7
12
  }
8
13
  export async function generateExternSignatures(host, libraryPath) {
9
- const diagnostics = createDiagnosticCollector();
10
- const pkgJson = await readPackageJson(host, libraryPath);
11
- if (!pkgJson.exports) {
12
- return [
13
- createDiagnostic({
14
- code: "exports-missing",
15
- target: createSourceLocation(resolvePath(libraryPath, "package.json")),
16
- }),
17
- ];
14
+ const diagnostics = createDiagnosticCollector();
15
+ const pkgJson = await readPackageJson(host, libraryPath);
16
+ if (!pkgJson.exports) {
17
+ return [createDiagnostic({
18
+ code: "exports-missing",
19
+ target: createSourceLocation(resolvePath(libraryPath, "package.json"))
20
+ })];
21
+ }
22
+ const exportsMap = {};
23
+ for (const [key, value] of Object.entries(pkgJson.exports)) {
24
+ if (typeof value === "object" && "typespec" in value && typeof value.typespec === "string") {
25
+ exportsMap[key] = resolvePath(libraryPath, value.typespec);
18
26
  }
19
- const exportsMap = {};
20
- for (const [key, value] of Object.entries(pkgJson.exports)) {
21
- if (typeof value === "object" && "typespec" in value && typeof value.typespec === "string") {
22
- exportsMap[key] = resolvePath(libraryPath, value.typespec);
23
- }
24
- }
25
- const exports = Object.values(exportsMap);
26
- if (exports.length > 0) {
27
- diagnostics.pipe(await generateExternSignatureForExports(host, libraryPath, pkgJson, exports));
28
- }
29
- else {
30
- diagnostics.add(createDiagnostic({
31
- code: "exports-missing",
32
- messageId: "missingCondition",
33
- target: createSourceLocation(resolvePath(libraryPath, "package.json")),
34
- }));
35
- }
36
- return diagnostics.diagnostics;
27
+ }
28
+ const exports = Object.values(exportsMap);
29
+ if (exports.length > 0) {
30
+ diagnostics.pipe(await generateExternSignatureForExports(host, libraryPath, pkgJson, exports));
31
+ } else {
32
+ diagnostics.add(createDiagnostic({
33
+ code: "exports-missing",
34
+ messageId: "missingCondition",
35
+ target: createSourceLocation(resolvePath(libraryPath, "package.json"))
36
+ }));
37
+ }
38
+ return diagnostics.diagnostics;
37
39
  }
38
40
  export async function generateExternSignatureForExports(host, libraryPath, pkgJson, exports) {
39
- const [main, ...additionalImports] = exports;
40
- const diagnostics = createDiagnosticCollector();
41
- const program = await compile(host, main, {
42
- additionalImports,
43
- parseOptions: { comments: true, docs: true },
44
- });
45
- const prettierConfig = await prettier.resolveConfig(libraryPath);
46
- const outDir = resolvePath(libraryPath, "generated-defs");
47
- try {
48
- await host.rm(outDir, { recursive: true });
41
+ const [main, ...additionalImports] = exports;
42
+ const diagnostics = createDiagnosticCollector();
43
+ const program = await compile(host, main, {
44
+ additionalImports,
45
+ parseOptions: {
46
+ comments: true,
47
+ docs: true
49
48
  }
50
- catch (e) { }
51
- await host.mkdirp(outDir);
52
- const files = await generateExternDecorators(program, pkgJson.name, {
53
- prettierConfig: prettierConfig ?? undefined,
49
+ });
50
+ const prettierConfig = await prettier.resolveConfig(libraryPath);
51
+ const outDir = resolvePath(libraryPath, "generated-defs");
52
+ try {
53
+ await host.rm(outDir, {
54
+ recursive: true
54
55
  });
55
- for (const [name, content] of Object.entries(files)) {
56
- await host.writeFile(resolvePath(outDir, name), content);
57
- }
58
- return [undefined, diagnostics.diagnostics];
56
+ } catch (e) {}
57
+ await host.mkdirp(outDir);
58
+ const files = await generateExternDecorators(program, pkgJson.name, {
59
+ prettierConfig: prettierConfig ?? undefined
60
+ });
61
+ for (const [name, content] of Object.entries(files)) {
62
+ await host.writeFile(resolvePath(outDir, name), content);
63
+ }
64
+ return [undefined, diagnostics.diagnostics];
59
65
  }
60
66
  async function readPackageJson(host, libraryPath) {
61
- const file = await host.readFile(joinPaths(libraryPath, "package.json"));
62
- return JSON.parse(file.text);
67
+ const file = await host.readFile(joinPaths(libraryPath, "package.json"));
68
+ return JSON.parse(file.text);
63
69
  }
64
70
  export async function generateExternDecorators(program, packageName, options) {
65
- const decorators = new Map();
66
- const listener = {
67
- decorator(dec) {
68
- if (packageName !== "@typespec/compiler" &&
69
- getLocationContext(program, dec).type !== "project") {
70
- return;
71
- }
72
- const namespaceName = getTypeName(dec.namespace);
73
- let decoratorForNamespace = decorators.get(namespaceName);
74
- if (!decoratorForNamespace) {
75
- decoratorForNamespace = [];
76
- decorators.set(namespaceName, decoratorForNamespace);
77
- }
78
- decoratorForNamespace.push(resolveDecoratorSignature(dec));
79
- },
80
- };
81
- if (options?.namespaces) {
82
- for (const namespace of options.namespaces) {
83
- navigateTypesInNamespace(namespace, listener, { skipSubNamespaces: true });
84
- }
71
+ const decorators = new Map();
72
+ const listener = {
73
+ decorator(dec) {
74
+ if (packageName !== "@typespec/compiler" && getLocationContext(program, dec).type !== "project") {
75
+ return;
76
+ }
77
+ const namespaceName = getTypeName(dec.namespace);
78
+ let decoratorForNamespace = decorators.get(namespaceName);
79
+ if (!decoratorForNamespace) {
80
+ decoratorForNamespace = [];
81
+ decorators.set(namespaceName, decoratorForNamespace);
82
+ }
83
+ decoratorForNamespace.push(resolveDecoratorSignature(dec));
85
84
  }
86
- else {
87
- navigateProgram(program, listener);
85
+ };
86
+ if (options?.namespaces) {
87
+ for (const namespace of options.namespaces) {
88
+ navigateTypesInNamespace(namespace, listener, {
89
+ skipSubNamespaces: true
90
+ });
88
91
  }
89
- function format(value) {
90
- try {
91
- const formatted = prettier.format(value, {
92
- ...options?.prettierConfig,
93
- parser: "typescript",
94
- });
95
- return formatted;
96
- }
97
- catch (e) {
98
- // eslint-disable-next-line no-console
99
- console.error("Error formatting", e);
100
- return value;
101
- }
92
+ } else {
93
+ navigateProgram(program, listener);
94
+ }
95
+ function format(value) {
96
+ try {
97
+ const formatted = prettier.format(value, {
98
+ ...options?.prettierConfig,
99
+ parser: "typescript"
100
+ });
101
+ return formatted;
102
+ } catch (e) {
103
+ // eslint-disable-next-line no-console
104
+ console.error("Error formatting", e);
105
+ return value;
102
106
  }
103
- const files = {};
104
- for (const [ns, nsDecorators] of decorators.entries()) {
105
- const base = ns === "" ? "__global__" : ns;
106
- const file = `${base}.ts`;
107
- files[file] = await format(generateSignatures(program, nsDecorators, ns));
108
- if (!ns.includes(".Private")) {
109
- files[`${base}.ts-test.ts`] = await format(generateSignatureTests(ns, packageName, `./${base}.js`, nsDecorators));
110
- }
107
+ }
108
+ const files = {};
109
+ for (const [ns, nsDecorators] of decorators.entries()) {
110
+ const output = generateSignatures(program, nsDecorators, packageName, ns);
111
+ const rawFiles = [];
112
+ traverseOutput(output, {
113
+ visitDirectory: () => {},
114
+ visitFile: file => rawFiles.push(file)
115
+ });
116
+ for (const file of rawFiles) {
117
+ files[file.path] = await format(file.contents);
111
118
  }
112
- return files;
119
+ }
120
+ return files;
113
121
  }
114
122
  function resolveDecoratorSignature(decorator) {
115
- return {
116
- decorator,
117
- name: decorator.name,
118
- jsName: "$" + decorator.name.slice(1),
119
- typeName: decorator.name[1].toUpperCase() + decorator.name.slice(2) + "Decorator",
120
- };
121
- }
122
- //# sourceMappingURL=gen-extern-signatures.js.map
123
+ return {
124
+ decorator,
125
+ name: decorator.name,
126
+ jsName: "$" + decorator.name.slice(1),
127
+ typeName: decorator.name[1].toUpperCase() + decorator.name.slice(2) + "Decorator"
128
+ };
129
+ }
@@ -1 +1 @@
1
- {"version":3,"file":"gen-extern-signatures.js","sourceRoot":"","sources":["../../../src/gen-extern-signatures/gen-extern-signatures.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"gen-extern-signatures.js","sourceRoot":"","sources":["../../../src/gen-extern-signatures/gen-extern-signatures.ts"],"names":[],"mappings":"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"}
@@ -1,2 +1 @@
1
- export {};
2
- //# sourceMappingURL=types.js.map
1
+ export {};
@@ -4,68 +4,68 @@ import { Application, PageEvent, ReflectionKind } from "typedoc";
4
4
  import { load } from "typedoc-plugin-markdown";
5
5
  import { stringify } from "yaml";
6
6
  export async function generateJsApiDocs(libraryPath, outputDir) {
7
- const markdownPluginOptions = {
8
- entryFileName: "index.md",
9
- propertiesFormat: "table",
10
- parametersFormat: "table",
11
- enumMembersFormat: "table",
12
- typeDeclarationFormat: "table",
13
- hidePageTitle: true,
14
- hideBreadcrumbs: true,
15
- hidePageHeader: true,
16
- useCodeBlocks: true,
17
- };
18
- const app = await Application.bootstrapWithPlugins({
19
- entryPoints: [joinPaths(libraryPath, "src/index.ts")],
20
- tsconfig: joinPaths(libraryPath, "tsconfig.json"),
21
- entryPointStrategy: "resolve",
22
- });
23
- loadRenderer(app);
24
- load(app);
25
- setOptions(app, {
26
- name: "JS API",
27
- githubPages: false,
28
- readme: "none",
29
- hideGenerator: true,
30
- disableSources: true,
31
- out: outputDir,
32
- ...markdownPluginOptions,
33
- });
34
- const project = await app.convert();
35
- // if project is undefined typedoc has a problem - error logging will be supplied by typedoc.
36
- if (!project) {
37
- return;
7
+ const markdownPluginOptions = {
8
+ entryFileName: "index.md",
9
+ propertiesFormat: "table",
10
+ parametersFormat: "table",
11
+ enumMembersFormat: "table",
12
+ typeDeclarationFormat: "table",
13
+ hidePageTitle: true,
14
+ hideBreadcrumbs: true,
15
+ hidePageHeader: true,
16
+ useCodeBlocks: true
17
+ };
18
+ const app = await Application.bootstrapWithPlugins({
19
+ entryPoints: [joinPaths(libraryPath, "src/index.ts")],
20
+ tsconfig: joinPaths(libraryPath, "tsconfig.json"),
21
+ entryPointStrategy: "resolve"
22
+ });
23
+ loadRenderer(app);
24
+ load(app);
25
+ setOptions(app, {
26
+ name: "JS API",
27
+ githubPages: false,
28
+ readme: "none",
29
+ hideGenerator: true,
30
+ disableSources: true,
31
+ out: outputDir,
32
+ ...markdownPluginOptions
33
+ });
34
+ const project = await app.convert();
35
+
36
+ // if project is undefined typedoc has a problem - error logging will be supplied by typedoc.
37
+ if (!project) {
38
+ return;
39
+ }
40
+ await app.generateOutputs(project);
41
+ await writeFile(joinPaths(outputDir, "_category_.json"), JSON.stringify({
42
+ label: "JS API",
43
+ link: {
44
+ type: "doc",
45
+ id: "index"
38
46
  }
39
- await app.generateOutputs(project);
40
- await writeFile(joinPaths(outputDir, "_category_.json"), JSON.stringify({
41
- label: "JS API",
42
- link: {
43
- type: "doc",
44
- id: "index",
45
- },
46
- }));
47
+ }));
47
48
  }
48
49
  function setOptions(app, options, reportErrors = true) {
49
- for (const [key, val] of Object.entries(options)) {
50
- app.options.setValue(key, val);
51
- }
50
+ for (const [key, val] of Object.entries(options)) {
51
+ app.options.setValue(key, val);
52
+ }
52
53
  }
53
54
  export function loadRenderer(app) {
54
- app.renderer.on(PageEvent.END, (page) => {
55
- if (page.contents && page) {
56
- const frontMatter = createFrontMatter(page.model);
57
- page.contents = frontMatter + page.contents.replace(/\\</g, "<");
58
- }
59
- });
55
+ app.renderer.on(PageEvent.END, page => {
56
+ if (page.contents && page) {
57
+ const frontMatter = createFrontMatter(page.model);
58
+ page.contents = frontMatter + page.contents.replace(/\\</g, "<");
59
+ }
60
+ });
60
61
  }
61
62
  function createFrontMatter(model) {
62
- return ["---", stringify(createFrontMatterData(model)), "---", ""].join("\n");
63
+ return ["---", stringify(createFrontMatterData(model)), "---", ""].join("\n");
63
64
  }
64
65
  function createFrontMatterData(model) {
65
- const kind = ReflectionKind.singularString(model.kind)[0];
66
- return {
67
- jsApi: true,
68
- title: `[${kind}] ${model.name}`,
69
- };
70
- }
71
- //# sourceMappingURL=api-docs.js.map
66
+ const kind = ReflectionKind.singularString(model.kind)[0];
67
+ return {
68
+ jsApi: true,
69
+ title: `[${kind}] ${model.name}`
70
+ };
71
+ }