@mnaoumov/typescript-dev-toolkit 1.3.1 → 2.0.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 (172) hide show
  1. package/assets/docs-site/components/ConstructorBlock.astro +16 -0
  2. package/assets/docs-site/components/ImportStatement.astro +12 -0
  3. package/assets/docs-site/components/MemberDetail.astro +101 -0
  4. package/assets/docs-site/components/MethodTable.astro +45 -0
  5. package/assets/docs-site/components/PropertyTable.astro +45 -0
  6. package/assets/docs-site/components/SiteTitle.astro +43 -0
  7. package/assets/docs-site/components/TypeSignature.astro +20 -0
  8. package/assets/docs-site/fonts/inter-latin-400-normal.ttf +0 -0
  9. package/assets/docs-site/fonts/inter-latin-700-normal.ttf +0 -0
  10. package/assets/docs-site/styles/global.css +221 -0
  11. package/dist/lib/cjs/build.cjs +1 -1
  12. package/dist/lib/cjs/build.d.cts +1 -1
  13. package/dist/lib/cjs/commitlint-forbidden-patterns.cjs +2 -2
  14. package/dist/lib/cjs/commitlint-forbidden-patterns.d.cts +1 -1
  15. package/dist/lib/cjs/commitlint-spellcheck-header.cjs +2 -2
  16. package/dist/lib/cjs/commitlint-spellcheck-header.d.cts +1 -1
  17. package/dist/lib/cjs/docs-site/api-doc-constants.cjs +171 -0
  18. package/dist/lib/cjs/docs-site/api-doc-constants.d.cts +18 -0
  19. package/dist/lib/cjs/docs-site/api-doc-jsdoc.cjs +414 -0
  20. package/dist/lib/cjs/docs-site/api-doc-jsdoc.d.cts +149 -0
  21. package/dist/lib/cjs/docs-site/api-doc-link-rendering.cjs +377 -0
  22. package/dist/lib/cjs/docs-site/api-doc-link-rendering.d.cts +185 -0
  23. package/dist/lib/cjs/docs-site/api-doc-package-sites.cjs +118 -0
  24. package/dist/lib/cjs/docs-site/api-doc-package-sites.d.cts +36 -0
  25. package/dist/lib/cjs/docs-site/api-doc-page-generation.cjs +561 -0
  26. package/dist/lib/cjs/docs-site/api-doc-page-generation.d.cts +159 -0
  27. package/dist/lib/cjs/docs-site/api-doc-route-segments.cjs +42 -0
  28. package/dist/lib/cjs/docs-site/api-doc-route-segments.d.cts +25 -0
  29. package/dist/lib/cjs/docs-site/api-doc-settings.cjs +47 -0
  30. package/dist/lib/cjs/docs-site/api-doc-settings.d.cts +53 -0
  31. package/dist/lib/cjs/docs-site/api-doc-source-processing.cjs +288 -0
  32. package/dist/lib/cjs/docs-site/api-doc-source-processing.d.cts +75 -0
  33. package/dist/lib/cjs/docs-site/api-doc-text-utils.cjs +281 -0
  34. package/dist/lib/cjs/docs-site/api-doc-text-utils.d.cts +178 -0
  35. package/dist/lib/cjs/docs-site/api-doc-type-merging.cjs +157 -0
  36. package/dist/lib/cjs/docs-site/api-doc-type-merging.d.cts +51 -0
  37. package/dist/lib/cjs/docs-site/api-doc-types.cjs +22 -0
  38. package/dist/lib/cjs/docs-site/api-doc-types.d.cts +157 -0
  39. package/dist/lib/cjs/docs-site/api-docs.cjs +143 -0
  40. package/dist/lib/cjs/docs-site/api-docs.d.cts +34 -0
  41. package/dist/lib/cjs/docs-site/astro-config.cjs +169 -0
  42. package/dist/lib/cjs/docs-site/astro-config.d.cts +23 -0
  43. package/dist/lib/cjs/docs-site/docs-links.cjs +123 -0
  44. package/dist/lib/cjs/docs-site/docs-links.d.cts +32 -0
  45. package/dist/lib/cjs/docs-site/docs-site-assets.cjs +64 -0
  46. package/dist/lib/cjs/docs-site/docs-site-assets.d.cts +23 -0
  47. package/dist/lib/cjs/docs-site/docs-site-commands.cjs +72 -0
  48. package/dist/lib/cjs/docs-site/docs-site-commands.d.cts +29 -0
  49. package/dist/lib/cjs/docs-site/docs-site-config.cjs +122 -0
  50. package/dist/lib/cjs/docs-site/docs-site-config.d.cts +162 -0
  51. package/dist/lib/cjs/docs-site/index.cjs +116 -0
  52. package/dist/lib/cjs/docs-site/index.d.cts +26 -0
  53. package/dist/lib/cjs/docs-site/link-check.cjs +197 -0
  54. package/dist/lib/cjs/docs-site/link-check.d.cts +163 -0
  55. package/dist/lib/cjs/docs-site/og-image-page.cjs +45 -0
  56. package/dist/lib/cjs/docs-site/og-image-page.d.cts +15 -0
  57. package/dist/lib/cjs/docs-site/og-image.cjs +326 -0
  58. package/dist/lib/cjs/docs-site/og-image.d.cts +70 -0
  59. package/dist/lib/cjs/docs-site/og-images.cjs +170 -0
  60. package/dist/lib/cjs/docs-site/og-images.d.cts +41 -0
  61. package/dist/lib/cjs/docs-site/route-data.cjs +47 -0
  62. package/dist/lib/cjs/docs-site/route-data.d.cts +14 -0
  63. package/dist/lib/cjs/docs-site/satteri-github-alerts.cjs +97 -0
  64. package/dist/lib/cjs/docs-site/satteri-github-alerts.d.cts +31 -0
  65. package/dist/lib/cjs/docs-site/satteri-relative-links.cjs +87 -0
  66. package/dist/lib/cjs/docs-site/satteri-relative-links.d.cts +29 -0
  67. package/dist/lib/cjs/docs-site/unrendered-alerts.cjs +51 -0
  68. package/dist/lib/cjs/docs-site/unrendered-alerts.d.cts +38 -0
  69. package/dist/lib/cjs/index.cjs +4 -1
  70. package/dist/lib/cjs/index.d.cts +1 -0
  71. package/dist/lib/cjs/library-build.cjs +1 -1
  72. package/dist/lib/cjs/library-build.d.cts +2 -2
  73. package/dist/lib/cjs/linters/eslint-config.cjs +17 -17
  74. package/dist/lib/cjs/linters/eslint-config.d.cts +1 -7
  75. package/dist/lib/cjs/linters/eslint-rules/in-house-plugin.cjs +2 -2
  76. package/dist/lib/cjs/linters/eslint-rules/in-house-plugin.d.cts +5 -8
  77. package/dist/lib/cjs/package-manager.cjs +2 -2
  78. package/dist/lib/esm/build.d.mts +1 -1
  79. package/dist/lib/esm/build.mjs +1 -1
  80. package/dist/lib/esm/commitlint-forbidden-patterns.d.mts +1 -1
  81. package/dist/lib/esm/commitlint-forbidden-patterns.mjs +2 -2
  82. package/dist/lib/esm/commitlint-spellcheck-header.d.mts +1 -1
  83. package/dist/lib/esm/commitlint-spellcheck-header.mjs +2 -2
  84. package/dist/lib/esm/docs-site/api-doc-constants.d.mts +18 -0
  85. package/dist/lib/esm/docs-site/api-doc-constants.mjs +143 -0
  86. package/dist/lib/esm/docs-site/api-doc-jsdoc.d.mts +149 -0
  87. package/dist/lib/esm/docs-site/api-doc-jsdoc.mjs +377 -0
  88. package/dist/lib/esm/docs-site/api-doc-link-rendering.d.mts +185 -0
  89. package/dist/lib/esm/docs-site/api-doc-link-rendering.mjs +356 -0
  90. package/dist/lib/esm/docs-site/api-doc-package-sites.d.mts +36 -0
  91. package/dist/lib/esm/docs-site/api-doc-package-sites.mjs +91 -0
  92. package/dist/lib/esm/docs-site/api-doc-page-generation.d.mts +159 -0
  93. package/dist/lib/esm/docs-site/api-doc-page-generation.mjs +548 -0
  94. package/dist/lib/esm/docs-site/api-doc-route-segments.d.mts +25 -0
  95. package/dist/lib/esm/docs-site/api-doc-route-segments.mjs +17 -0
  96. package/dist/lib/esm/docs-site/api-doc-settings.d.mts +53 -0
  97. package/dist/lib/esm/docs-site/api-doc-settings.mjs +22 -0
  98. package/dist/lib/esm/docs-site/api-doc-source-processing.d.mts +75 -0
  99. package/dist/lib/esm/docs-site/api-doc-source-processing.mjs +274 -0
  100. package/dist/lib/esm/docs-site/api-doc-text-utils.d.mts +178 -0
  101. package/dist/lib/esm/docs-site/api-doc-text-utils.mjs +239 -0
  102. package/dist/lib/esm/docs-site/api-doc-type-merging.d.mts +51 -0
  103. package/dist/lib/esm/docs-site/api-doc-type-merging.mjs +129 -0
  104. package/dist/lib/esm/docs-site/api-doc-types.d.mts +157 -0
  105. package/dist/lib/esm/docs-site/api-doc-types.mjs +6 -0
  106. package/dist/lib/esm/docs-site/api-docs.d.mts +34 -0
  107. package/dist/lib/esm/docs-site/api-docs.mjs +139 -0
  108. package/dist/lib/esm/docs-site/astro-config.d.mts +23 -0
  109. package/dist/lib/esm/docs-site/astro-config.mjs +135 -0
  110. package/dist/lib/esm/docs-site/docs-links.d.mts +32 -0
  111. package/dist/lib/esm/docs-site/docs-links.mjs +113 -0
  112. package/dist/lib/esm/docs-site/docs-site-assets.d.mts +23 -0
  113. package/dist/lib/esm/docs-site/docs-site-assets.mjs +32 -0
  114. package/dist/lib/esm/docs-site/docs-site-commands.d.mts +29 -0
  115. package/dist/lib/esm/docs-site/docs-site-commands.mjs +46 -0
  116. package/dist/lib/esm/docs-site/docs-site-config.d.mts +162 -0
  117. package/dist/lib/esm/docs-site/docs-site-config.mjs +98 -0
  118. package/dist/lib/esm/docs-site/index.d.mts +26 -0
  119. package/dist/lib/esm/docs-site/index.mjs +58 -0
  120. package/dist/lib/esm/docs-site/link-check.d.mts +163 -0
  121. package/dist/lib/esm/docs-site/link-check.mjs +166 -0
  122. package/dist/lib/esm/docs-site/og-image-page.d.mts +15 -0
  123. package/dist/lib/esm/docs-site/og-image-page.mjs +21 -0
  124. package/dist/lib/esm/docs-site/og-image.d.mts +70 -0
  125. package/dist/lib/esm/docs-site/og-image.mjs +292 -0
  126. package/dist/lib/esm/docs-site/og-images.d.mts +41 -0
  127. package/dist/lib/esm/docs-site/og-images.mjs +156 -0
  128. package/dist/lib/esm/docs-site/route-data.d.mts +14 -0
  129. package/dist/lib/esm/docs-site/route-data.mjs +23 -0
  130. package/dist/lib/esm/docs-site/satteri-github-alerts.d.mts +31 -0
  131. package/dist/lib/esm/docs-site/satteri-github-alerts.mjs +72 -0
  132. package/dist/lib/esm/docs-site/satteri-relative-links.d.mts +29 -0
  133. package/dist/lib/esm/docs-site/satteri-relative-links.mjs +63 -0
  134. package/dist/lib/esm/docs-site/unrendered-alerts.d.mts +38 -0
  135. package/dist/lib/esm/docs-site/unrendered-alerts.mjs +26 -0
  136. package/dist/lib/esm/index.d.mts +1 -0
  137. package/dist/lib/esm/index.mjs +3 -1
  138. package/dist/lib/esm/library-build.d.mts +2 -2
  139. package/dist/lib/esm/library-build.mjs +1 -1
  140. package/dist/lib/esm/linters/eslint-config.d.mts +1 -7
  141. package/dist/lib/esm/linters/eslint-config.mjs +17 -17
  142. package/dist/lib/esm/linters/eslint-rules/in-house-plugin.d.mts +5 -8
  143. package/dist/lib/esm/linters/eslint-rules/in-house-plugin.mjs +2 -2
  144. package/dist/lib/esm/package-manager.mjs +2 -2
  145. package/docs-site/api-doc-constants/package.json +6 -0
  146. package/docs-site/api-doc-jsdoc/package.json +6 -0
  147. package/docs-site/api-doc-link-rendering/package.json +6 -0
  148. package/docs-site/api-doc-package-sites/package.json +6 -0
  149. package/docs-site/api-doc-page-generation/package.json +6 -0
  150. package/docs-site/api-doc-route-segments/package.json +6 -0
  151. package/docs-site/api-doc-settings/package.json +6 -0
  152. package/docs-site/api-doc-source-processing/package.json +6 -0
  153. package/docs-site/api-doc-text-utils/package.json +6 -0
  154. package/docs-site/api-doc-type-merging/package.json +6 -0
  155. package/docs-site/api-doc-types/package.json +6 -0
  156. package/docs-site/api-docs/package.json +6 -0
  157. package/docs-site/astro-config/package.json +6 -0
  158. package/docs-site/docs-links/package.json +6 -0
  159. package/docs-site/docs-site-assets/package.json +6 -0
  160. package/docs-site/docs-site-commands/package.json +6 -0
  161. package/docs-site/docs-site-config/package.json +6 -0
  162. package/docs-site/index/package.json +6 -0
  163. package/docs-site/link-check/package.json +6 -0
  164. package/docs-site/og-image/package.json +6 -0
  165. package/docs-site/og-image-page/package.json +6 -0
  166. package/docs-site/og-images/package.json +6 -0
  167. package/docs-site/package.json +6 -0
  168. package/docs-site/route-data/package.json +6 -0
  169. package/docs-site/satteri-github-alerts/package.json +6 -0
  170. package/docs-site/satteri-relative-links/package.json +6 -0
  171. package/docs-site/unrendered-alerts/package.json +6 -0
  172. package/package.json +74 -4
@@ -0,0 +1,75 @@
1
+ /// <reference path="../library-references.d.cts" />
2
+ /**
3
+ * @file
4
+ *
5
+ * Source discovery + extraction: walks `src`, filters to documentable entry files, and turns each
6
+ * file's exported declarations into `TypeInfo` entries keyed by a qualified `${namespace}#${name}`.
7
+ */
8
+ import type { SourceFile } from 'ts-morph' with { 'resolution-mode': 'import' };
9
+ import type { TypeInfo } from './api-doc-types.cjs';
10
+ /**
11
+ * Collect top-level exported functions.
12
+ *
13
+ * @param src - The source file.
14
+ * @param types - The documented types, keyed by qualified id.
15
+ * @param namespace - The type's namespace.
16
+ */
17
+ export declare function collectFunctions(src: SourceFile, types: Map<string, TypeInfo>, namespace: string): void;
18
+ /**
19
+ * Records where every symbol a source file imports is declared, so a type another documented package declares
20
+ * links to that package's site.
21
+ *
22
+ * @param src - The source file.
23
+ */
24
+ export declare function collectPackageDeclarations(src: SourceFile): void;
25
+ /**
26
+ * Collect top-level exported variable declarations (e.g. `export const EMPTY = ''`).
27
+ *
28
+ * @param src - The source file.
29
+ * @param types - The documented types, keyed by qualified id.
30
+ * @param namespace - The type's namespace.
31
+ */
32
+ export declare function collectVariables(src: SourceFile, types: Map<string, TypeInfo>, namespace: string): void;
33
+ /**
34
+ * Compute a hash of every input that decides the generated pages: the generator's own modules, the settings and
35
+ * the entry source files. An unchanged hash lets a run skip the generation.
36
+ *
37
+ * @param entryFiles - The entry source files.
38
+ * @param generatorDirectory - The folder holding the generator's modules.
39
+ * @returns The hash, as hex.
40
+ */
41
+ export declare function computeCacheHash(entryFiles: string[], generatorDirectory: string): string;
42
+ /**
43
+ * Compute the namespace (POSIX path relative to `src`, no extension) for a source file.
44
+ *
45
+ * @param srcDirectory - The source folder the namespace is relative to.
46
+ * @param filePath - The file's path.
47
+ * @returns The namespace.
48
+ */
49
+ export declare function computeNamespace(srcDirectory: string, filePath: string): string;
50
+ /**
51
+ * Recursively find all documentable `*.ts` entry files under `src`.
52
+ *
53
+ * Excludes: `*.test.ts` (incl. `*.browser.test.ts` / `*.integration.test.ts`), `*.d.ts`,
54
+ * `index.ts`, `__merged.ts`, `setup.ts`, `*-setup.ts`, and any subtree under a `@types`,
55
+ * `styles`, or `test-helpers` directory.
56
+ *
57
+ * @param directory - The folder to search.
58
+ * @returns The entry files' paths.
59
+ */
60
+ export declare function findEntryFiles(directory: string): string[];
61
+ /**
62
+ * Collects a source file's exported type aliases, enums, interfaces and classes.
63
+ *
64
+ * @param src - The source file.
65
+ * @param types - The documented types, keyed by qualified id.
66
+ * @param namespace - The type's namespace.
67
+ */
68
+ export declare function processSourceFile(src: SourceFile, types: Map<string, TypeInfo>, namespace: string): void;
69
+ /**
70
+ * Register all type parameter names so renderTypeWithLinks won't hyperlink them.
71
+ * Skip names that are also known types — those should still be linkable.
72
+ *
73
+ * @param types - The documented types, keyed by qualified id.
74
+ */
75
+ export declare function registerGenericTypeParams(types: Map<string, TypeInfo>): void;
@@ -0,0 +1,281 @@
1
+ /*
2
+ THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
3
+ if you want to view the source, please visit the github repository of this plugin
4
+ */
5
+ (function () {
6
+ function ensureBrowserProcess() {
7
+ const browserProcess = {
8
+ browser: true,
9
+ cwd() {
10
+ return '/';
11
+ },
12
+ env: {},
13
+ platform: 'android'
14
+ };
15
+
16
+ const existingProcess = globalThis.process;
17
+
18
+ if (!existingProcess) {
19
+ globalThis.process = browserProcess;
20
+ return;
21
+ }
22
+
23
+ if (existingProcess.versions?.node) {
24
+ return;
25
+ }
26
+
27
+ const existingProcessRecord = existingProcess;
28
+
29
+ for (const [key, value] of Object.entries(browserProcess)) {
30
+ existingProcessRecord[key] ??= value;
31
+ }
32
+
33
+ existingProcessRecord['browser'] = true;
34
+ }
35
+
36
+ ensureBrowserProcess();
37
+ })();
38
+
39
+ "use strict";
40
+ var __defProp = Object.defineProperty;
41
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
42
+ var __getOwnPropNames = Object.getOwnPropertyNames;
43
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
44
+ var __export = (target, all) => {
45
+ for (var name in all)
46
+ __defProp(target, name, { get: all[name], enumerable: true });
47
+ };
48
+ var __copyProps = (to, from, except, desc) => {
49
+ if (from && typeof from === "object" || typeof from === "function") {
50
+ for (let key of __getOwnPropNames(from))
51
+ if (!__hasOwnProp.call(to, key) && key !== except)
52
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
53
+ }
54
+ return to;
55
+ };
56
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
57
+ var api_doc_text_utils_exports = {};
58
+ __export(api_doc_text_utils_exports, {
59
+ computeOverloadKey: () => computeOverloadKey,
60
+ ensureDirectory: () => ensureDirectory,
61
+ escapeJsString: () => escapeJsString,
62
+ escapeJsxAttribute: () => escapeJsxAttribute,
63
+ escapeMarkdown: () => escapeMarkdown,
64
+ escapeMdxAngleBrackets: () => escapeMdxAngleBrackets,
65
+ escapeMdxBraces: () => escapeMdxBraces,
66
+ escapeMdxProse: () => escapeMdxProse,
67
+ escapeYaml: () => escapeYaml,
68
+ foldTsDocParagraphs: () => foldTsDocParagraphs,
69
+ getDisplayName: () => getDisplayName,
70
+ getImportStatement: () => getImportStatement,
71
+ getNamespaceDirectory: () => getNamespaceDirectory,
72
+ memberRouteSegment: () => memberRouteSegment,
73
+ memberSlug: () => memberSlug,
74
+ overloadRouteSegment: () => overloadRouteSegment,
75
+ overloadSlug: () => overloadSlug,
76
+ replaceRegExpMatches: () => replaceRegExpMatches,
77
+ segmentMarkdown: () => segmentMarkdown,
78
+ simplifyType: () => simplifyType,
79
+ stripMarkdown: () => stripMarkdown,
80
+ truncateSignature: () => truncateSignature
81
+ });
82
+ module.exports = __toCommonJS(api_doc_text_utils_exports);
83
+ var import_reg_exp = require('@mnaoumov/typescript-lib/reg-exp');
84
+ var import_promises = require('node:fs/promises');
85
+ var import_node_path = require('node:path');
86
+ var import_api_doc_constants = require('./api-doc-constants.cjs');
87
+ var import_api_doc_package_sites = require('./api-doc-package-sites.cjs');
88
+ var import_api_doc_route_segments = require('./api-doc-route-segments.cjs');
89
+ var import_api_doc_settings = require('./api-doc-settings.cjs');
90
+ function computeOverloadKey(method) {
91
+ if (import_api_doc_constants.EVENT_METHODS.has(method.name) && method.parameters.length > 0) {
92
+ const firstParameter = method.parameters[0];
93
+ if (firstParameter?.type.startsWith('"') || firstParameter?.type.startsWith("'")) {
94
+ const normalizedType = firstParameter.type.replaceAll('"', "'");
95
+ return `${method.name}(${normalizedType})`;
96
+ }
97
+ }
98
+ return method.name;
99
+ }
100
+ async function ensureDirectory(filePath) {
101
+ await (0, import_promises.mkdir)((0, import_node_path.dirname)(filePath), { recursive: true });
102
+ }
103
+ function escapeJsString(text) {
104
+ return text.replaceAll("\\", "\\\\").replaceAll('"', String.raw`\"`).replaceAll("\n", " ");
105
+ }
106
+ function escapeJsxAttribute(text) {
107
+ return text.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("\n", " ");
108
+ }
109
+ function escapeMarkdown(text) {
110
+ return text.replaceAll("|", String.raw`\|`).replaceAll("\n", " ").replaceAll("{", String.raw`\{`).replaceAll("}", String.raw`\}`);
111
+ }
112
+ function escapeMdxAngleBrackets(text) {
113
+ return text.replaceAll("<", String.raw`\<`).replaceAll(">", String.raw`\>`);
114
+ }
115
+ function escapeMdxBraces(text) {
116
+ return text.replaceAll("{", String.raw`\{`).replaceAll("}", String.raw`\}`);
117
+ }
118
+ function escapeYaml(text) {
119
+ return text.replaceAll('"', String.raw`\"`);
120
+ }
121
+ const SIGNATURE_MAX_LENGTH = 160;
122
+ const IMPORT_QUALIFIER_REG_EXP = /import\((?<Quote>["'])[^"']+\k<Quote>\)\./g;
123
+ const IMPORT_TYPE_REG_EXP = /import\((?<Quote>["'])(?<Path>[^"']+)\k<Quote>\)\.(?<Name>[A-Za-z_$][\w$]*)/g;
124
+ function escapeMdxProse(text) {
125
+ const protectedPattern = /`[^`]*`|\[[^\]]*\]\([^)]*\)/g;
126
+ let result = "";
127
+ let lastIndex = 0;
128
+ for (const match of text.matchAll(protectedPattern)) {
129
+ const index = match.index;
130
+ result += escapeMdxProseChars(text.slice(lastIndex, index));
131
+ result += match[0];
132
+ lastIndex = index + match[0].length;
133
+ }
134
+ result += escapeMdxProseChars(text.slice(lastIndex));
135
+ return result;
136
+ }
137
+ function foldTsDocParagraphs(text) {
138
+ const segments = segmentMarkdown(text);
139
+ return segments.map((seg) => {
140
+ return seg.type === "code" ? `\`\`\`${seg.lang}
141
+ ${seg.text}
142
+ \`\`\`` : seg.text.split(/\n{2,}/).map((paragraph) => paragraph.replaceAll("\n", " ")).join("\n\n");
143
+ }).map((segment) => segment.trim()).filter(Boolean).join("\n\n");
144
+ }
145
+ function getDisplayName(name, info) {
146
+ if (info.typeParameters.length === 0) {
147
+ return name;
148
+ }
149
+ const bareParams = info.typeParameters.map((tp) => tp.replace(/\s+extends\s+.*$/, ""));
150
+ return `${name}<${bareParams.join(", ")}>`;
151
+ }
152
+ function getImportStatement(info) {
153
+ const isTypeOnly = ["enum", "interface", "type"].includes(info.kind);
154
+ const importKeyword = isTypeOnly ? "import type" : "import";
155
+ return `${importKeyword} { ${info.name} } from '${(0, import_api_doc_settings.getApiDocSettings)().packageName}/${info.namespace}';`;
156
+ }
157
+ function getNamespaceDirectory(namespace) {
158
+ return namespace;
159
+ }
160
+ function memberRouteSegment(name) {
161
+ return slugifyMemberName(name);
162
+ }
163
+ function memberSlug(name) {
164
+ return (0, import_api_doc_route_segments.toRouteSegment)(slugifyMemberName(name));
165
+ }
166
+ function overloadRouteSegment(overloadKey) {
167
+ return slugifyOverloadKey(overloadKey);
168
+ }
169
+ function overloadSlug(overloadKey) {
170
+ return (0, import_api_doc_route_segments.toRouteSegment)(slugifyOverloadKey(overloadKey));
171
+ }
172
+ function replaceRegExpMatches(text, regExp, replacer) {
173
+ let result = "";
174
+ let lastIndex = 0;
175
+ for (const match of text.matchAll(regExp)) {
176
+ result += text.slice(lastIndex, match.index) + replacer(match);
177
+ lastIndex = match.index + match[0].length;
178
+ }
179
+ return result + text.slice(lastIndex);
180
+ }
181
+ function segmentMarkdown(text) {
182
+ const lines = text.split("\n");
183
+ const segments = [];
184
+ let proseBuffer = [];
185
+ let codeLines = [];
186
+ let openFence = null;
187
+ for (const line of lines) {
188
+ if (openFence) {
189
+ if (openFence.closeRe.test(line)) {
190
+ segments.push({ lang: openFence.lang, text: codeLines.join("\n"), type: "code" });
191
+ openFence = null;
192
+ } else {
193
+ codeLines.push(line);
194
+ }
195
+ continue;
196
+ }
197
+ const openMatch = /^\s*(?<fence>(?<fenceChar>[`~])\k<fenceChar>{2,})(?<lang>.*)$/.exec(line);
198
+ if (openMatch) {
199
+ const fenceChars = (0, import_reg_exp.getMandatoryNamedGroup)(openMatch, "fence");
200
+ const fenceChar = (0, import_reg_exp.getMandatoryNamedGroup)(openMatch, "fenceChar");
201
+ flushProse();
202
+ codeLines = [];
203
+ openFence = {
204
+ closeRe: new RegExp(`^\\s*\\${fenceChar}{${String(fenceChars.length)},}\\s*$`),
205
+ lang: (0, import_reg_exp.getMandatoryNamedGroup)(openMatch, "lang").trim()
206
+ };
207
+ continue;
208
+ }
209
+ proseBuffer.push(line);
210
+ }
211
+ if (openFence) {
212
+ segments.push({ lang: openFence.lang, text: codeLines.join("\n"), type: "code" });
213
+ }
214
+ flushProse();
215
+ return segments;
216
+ function flushProse() {
217
+ if (proseBuffer.length === 0) {
218
+ return;
219
+ }
220
+ segments.push({ text: proseBuffer.join("\n"), type: "prose" });
221
+ proseBuffer = [];
222
+ }
223
+ }
224
+ function simplifyType(typeText) {
225
+ for (const match of typeText.matchAll(IMPORT_TYPE_REG_EXP)) {
226
+ (0, import_api_doc_package_sites.registerPackageDeclaration)((0, import_reg_exp.getMandatoryNamedGroup)(match, "Name"), (0, import_reg_exp.getMandatoryNamedGroup)(match, "Path"));
227
+ }
228
+ return typeText.replaceAll(IMPORT_QUALIFIER_REG_EXP, "");
229
+ }
230
+ function truncateSignature(signature) {
231
+ const collapsed = signature.replaceAll(/\s+/g, " ").trim();
232
+ return collapsed.length <= SIGNATURE_MAX_LENGTH ? collapsed : `${collapsed.slice(0, SIGNATURE_MAX_LENGTH - 1).trimEnd()}\u2026`;
233
+ }
234
+ function slugifyMemberName(name) {
235
+ const cleaned = name.replaceAll(/^["']|["']$/g, "").replaceAll(/[^a-zA-Z0-9]/g, "-").replaceAll(/-+/g, "-").replaceAll(/^-|-$/g, "");
236
+ return cleaned === "index" ? "index-member" : cleaned || "unnamed";
237
+ }
238
+ function slugifyOverloadKey(overloadKey) {
239
+ const slug = overloadKey.replaceAll(/["'()]/g, " ").replaceAll(/[^a-zA-Z0-9\s]/g, "").trim().replaceAll(/\s+/g, "-");
240
+ return slug === "index" ? "index-member" : slug;
241
+ }
242
+ const OG_DESCRIPTION_MAX_LENGTH = 160;
243
+ function stripMarkdown(text) {
244
+ const plain = replaceRegExpMatches(text, /\{@link\s+(?:[^|}]+?)(?:\s*\|\s*(?<display>[^}]+?))?\}/g, (match) => (0, import_reg_exp.getOptionalNamedGroup)(match, "display") ?? "").replaceAll(/\[(?<text>[^\]]+)\]\([^)]+\)/g, "$<text>").replaceAll(/[`*_~]/g, "").replaceAll(/\s+/g, " ").trim();
245
+ if (plain.length <= OG_DESCRIPTION_MAX_LENGTH) {
246
+ return plain;
247
+ }
248
+ const clipped = plain.slice(0, OG_DESCRIPTION_MAX_LENGTH - 1);
249
+ const lastSpaceIndex = clipped.lastIndexOf(" ");
250
+ const truncated = lastSpaceIndex > 0 ? clipped.slice(0, lastSpaceIndex) : clipped;
251
+ return `${truncated.replace(/[,;:.\s]+$/, "")}\u2026`;
252
+ }
253
+ function escapeMdxProseChars(chunk) {
254
+ return chunk.replaceAll(/[<{}]/g, (char) => `\\${char}`);
255
+ }
256
+ // Annotate the CommonJS export names for ESM import in node:
257
+ 0 && (module.exports = {
258
+ computeOverloadKey,
259
+ ensureDirectory,
260
+ escapeJsString,
261
+ escapeJsxAttribute,
262
+ escapeMarkdown,
263
+ escapeMdxAngleBrackets,
264
+ escapeMdxBraces,
265
+ escapeMdxProse,
266
+ escapeYaml,
267
+ foldTsDocParagraphs,
268
+ getDisplayName,
269
+ getImportStatement,
270
+ getNamespaceDirectory,
271
+ memberRouteSegment,
272
+ memberSlug,
273
+ overloadRouteSegment,
274
+ overloadSlug,
275
+ replaceRegExpMatches,
276
+ segmentMarkdown,
277
+ simplifyType,
278
+ stripMarkdown,
279
+ truncateSignature
280
+ });
281
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9kb2NzLXNpdGUvYXBpLWRvYy10ZXh0LXV0aWxzLnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBUZXh0L21hcmtkb3duL2VzY2FwaW5nIHV0aWxpdGllcyBhbmQgaWRlbnRpZmllciBoZWxwZXJzIGZvciB0aGUgQVBJIGRvY3VtZW50YXRpb24gZ2VuZXJhdG9yLlxuICovXG5cbmltcG9ydCB7XG4gIGdldE1hbmRhdG9yeU5hbWVkR3JvdXAsXG4gIGdldE9wdGlvbmFsTmFtZWRHcm91cFxufSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvcmVnLWV4cCc7XG5pbXBvcnQgeyBta2RpciB9IGZyb20gJ25vZGU6ZnMvcHJvbWlzZXMnO1xuaW1wb3J0IHsgZGlybmFtZSB9IGZyb20gJ25vZGU6cGF0aCc7XG5cbmltcG9ydCB0eXBlIHtcbiAgTWFya2Rvd25TZWdtZW50LFxuICBNZW1iZXJJbmZvLFxuICBUeXBlSW5mb1xufSBmcm9tICcuL2FwaS1kb2MtdHlwZXMudHMnO1xuXG5pbXBvcnQgeyBFVkVOVF9NRVRIT0RTIH0gZnJvbSAnLi9hcGktZG9jLWNvbnN0YW50cy50cyc7XG5pbXBvcnQgeyByZWdpc3RlclBhY2thZ2VEZWNsYXJhdGlvbiB9IGZyb20gJy4vYXBpLWRvYy1wYWNrYWdlLXNpdGVzLnRzJztcbmltcG9ydCB7IHRvUm91dGVTZWdtZW50IH0gZnJvbSAnLi9hcGktZG9jLXJvdXRlLXNlZ21lbnRzLnRzJztcbmltcG9ydCB7IGdldEFwaURvY1NldHRpbmdzIH0gZnJvbSAnLi9hcGktZG9jLXNldHRpbmdzLnRzJztcblxuaW50ZXJmYWNlIE9wZW5GZW5jZSB7XG4gIHJlYWRvbmx5IGNsb3NlUmU6IFJlZ0V4cDtcbiAgcmVhZG9ubHkgbGFuZzogc3RyaW5nO1xufVxuXG4vKipcbiAqIENvbXB1dGUgYW4gb3ZlcmxvYWQga2V5IGZvciBtZXRob2RzIHdpdGggZGlzdGluZ3Vpc2hpbmcgZmlyc3QgcGFyYW0gKGUuZy4gb24oJ2NoYW5nZWQnLC4uLikpXG4gKlxuICogQHBhcmFtIG1ldGhvZCAtIFRoZSBtZXRob2QuXG4gKiBAcmV0dXJucyBUaGUgb3ZlcmxvYWQga2V5LlxuICovXG5leHBvcnQgZnVuY3Rpb24gY29tcHV0ZU92ZXJsb2FkS2V5KG1ldGhvZDogTWVtYmVySW5mbyk6IHN0cmluZyB7XG4gIGlmIChFVkVOVF9NRVRIT0RTLmhhcyhtZXRob2QubmFtZSkgJiYgbWV0aG9kLnBhcmFtZXRlcnMubGVuZ3RoID4gMCkge1xuICAgIGNvbnN0IGZpcnN0UGFyYW1ldGVyID0gbWV0aG9kLnBhcmFtZXRlcnNbMF07XG4gICAgaWYgKGZpcnN0UGFyYW1ldGVyPy50eXBlLnN0YXJ0c1dpdGgoJ1wiJykgfHwgZmlyc3RQYXJhbWV0ZXI/LnR5cGUuc3RhcnRzV2l0aCgnXFwnJykpIHtcbiAgICAgIGNvbnN0IG5vcm1hbGl6ZWRUeXBlID0gZmlyc3RQYXJhbWV0ZXIudHlwZS5yZXBsYWNlQWxsKCdcIicsICdcXCcnKTtcbiAgICAgIHJldHVybiBgJHttZXRob2QubmFtZX0oJHtub3JtYWxpemVkVHlwZX0pYDtcbiAgICB9XG4gIH1cbiAgcmV0dXJuIG1ldGhvZC5uYW1lO1xufVxuXG4vKipcbiAqIENyZWF0ZXMgdGhlIGZvbGRlciBhIGZpbGUgaXMgYWJvdXQgdG8gYmUgd3JpdHRlbiB0by5cbiAqXG4gKiBAcGFyYW0gZmlsZVBhdGggLSBUaGUgcGF0aCBvZiB0aGUgZmlsZSBhYm91dCB0byBiZSB3cml0dGVuLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gZW5zdXJlRGlyZWN0b3J5KGZpbGVQYXRoOiBzdHJpbmcpOiBQcm9taXNlPHZvaWQ+IHtcbiAgYXdhaXQgbWtkaXIoZGlybmFtZShmaWxlUGF0aCksIHsgcmVjdXJzaXZlOiB0cnVlIH0pO1xufVxuXG4vKipcbiAqIEVzY2FwZSB0ZXh0IGZvciB1c2UgaW5zaWRlIGEgSlMgc3RyaW5nIHdpdGhpbiBhIEpTWCBleHByZXNzaW9uOiB7Li4ue2tleTogXCIuLi5cIn19XG4gKlxuICogQHBhcmFtIHRleHQgLSBUaGUgdGV4dCB0byBlc2NhcGUuXG4gKiBAcmV0dXJucyBUaGUgZXNjYXBlZCB0ZXh0LlxuICovXG5leHBvcnQgZnVuY3Rpb24gZXNjYXBlSnNTdHJpbmcodGV4dDogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIHRleHQucmVwbGFjZUFsbCgnXFxcXCcsICdcXFxcXFxcXCcpLnJlcGxhY2VBbGwoJ1wiJywgU3RyaW5nLnJhd2BcXFwiYCkucmVwbGFjZUFsbCgnXFxuJywgJyAnKTtcbn1cblxuLyoqXG4gKiBFc2NhcGUgdGV4dCBmb3IgdXNlIGluc2lkZSBhIEpTWCBhdHRyaWJ1dGU6IGF0dHI9XCIuLi5cIiAoTURYIHVzZXMgSFRNTC1zdHlsZSBwYXJzaW5nKVxuICpcbiAqIEBwYXJhbSB0ZXh0IC0gVGhlIHRleHQgdG8gZXNjYXBlLlxuICogQHJldHVybnMgVGhlIGVzY2FwZWQgdGV4dC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGVzY2FwZUpzeEF0dHJpYnV0ZSh0ZXh0OiBzdHJpbmcpOiBzdHJpbmcge1xuICByZXR1cm4gdGV4dC5yZXBsYWNlQWxsKCcmJywgJyZhbXA7JykucmVwbGFjZUFsbCgnXCInLCAnJnF1b3Q7JykucmVwbGFjZUFsbCgnXFxuJywgJyAnKTtcbn1cblxuLyoqXG4gKiBFc2NhcGUgdGV4dCBmb3IgYSBtYXJrZG93biB0YWJsZSBjZWxsLlxuICpcbiAqIEBwYXJhbSB0ZXh0IC0gVGhlIHRleHQgdG8gZXNjYXBlLlxuICogQHJldHVybnMgVGhlIGVzY2FwZWQgdGV4dC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGVzY2FwZU1hcmtkb3duKHRleHQ6IHN0cmluZyk6IHN0cmluZyB7XG4gIHJldHVybiB0ZXh0LnJlcGxhY2VBbGwoJ3wnLCBTdHJpbmcucmF3YFxcfGApLnJlcGxhY2VBbGwoJ1xcbicsICcgJykucmVwbGFjZUFsbCgneycsIFN0cmluZy5yYXdgXFx7YCkucmVwbGFjZUFsbCgnfScsIFN0cmluZy5yYXdgXFx9YCk7XG59XG5cbi8qKlxuICogRXNjYXBlIGFuZ2xlIGJyYWNrZXRzIHNvIE1EWCBkb2VzIG5vdCByZWFkIHRoZW0gYXMgSlNYLlxuICpcbiAqIEBwYXJhbSB0ZXh0IC0gVGhlIHRleHQgdG8gZXNjYXBlLlxuICogQHJldHVybnMgVGhlIGVzY2FwZWQgdGV4dC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGVzY2FwZU1keEFuZ2xlQnJhY2tldHModGV4dDogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIHRleHQucmVwbGFjZUFsbCgnPCcsIFN0cmluZy5yYXdgXFw8YCkucmVwbGFjZUFsbCgnPicsIFN0cmluZy5yYXdgXFw+YCk7XG59XG5cbi8qKlxuICogRXNjYXBlIGN1cmx5IGJyYWNlcyBpbiBNRFggbWFya2Rvd24gY29udGVudCB0byBwcmV2ZW50IEpTWCBleHByZXNzaW9uIHBhcnNpbmdcbiAqXG4gKiBAcGFyYW0gdGV4dCAtIFRoZSB0ZXh0IHRvIGVzY2FwZS5cbiAqIEByZXR1cm5zIFRoZSBlc2NhcGVkIHRleHQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBlc2NhcGVNZHhCcmFjZXModGV4dDogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIHRleHQucmVwbGFjZUFsbCgneycsIFN0cmluZy5yYXdgXFx7YCkucmVwbGFjZUFsbCgnfScsIFN0cmluZy5yYXdgXFx9YCk7XG59XG5cbi8qKlxuICogRXNjYXBlIHRleHQgZm9yIGEgZG91YmxlLXF1b3RlZCBZQU1MIHZhbHVlLlxuICpcbiAqIEBwYXJhbSB0ZXh0IC0gVGhlIHRleHQgdG8gZXNjYXBlLlxuICogQHJldHVybnMgVGhlIGVzY2FwZWQgdGV4dC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGVzY2FwZVlhbWwodGV4dDogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIHRleHQucmVwbGFjZUFsbCgnXCInLCBTdHJpbmcucmF3YFxcXCJgKTtcbn1cblxuY29uc3QgU0lHTkFUVVJFX01BWF9MRU5HVEggPSAxNjA7XG5jb25zdCBJTVBPUlRfUVVBTElGSUVSX1JFR19FWFAgPSAvaW1wb3J0XFwoKD88UXVvdGU+W1wiJ10pW15cIiddK1xcazxRdW90ZT5cXClcXC4vZztcbmNvbnN0IElNUE9SVF9UWVBFX1JFR19FWFAgPSAvaW1wb3J0XFwoKD88UXVvdGU+W1wiJ10pKD88UGF0aD5bXlwiJ10rKVxcazxRdW90ZT5cXClcXC4oPzxOYW1lPltBLVphLXpfJF1bXFx3JF0qKS9nO1xuXG4vKipcbiAqIEVzY2FwZSBNRFgtdW5zYWZlIGNoYXJhY3RlcnMgKGA8YCwgYHtgLCBgfWApIGluIHByb3NlIHRleHQsIHdoaWxlIGxlYXZpbmcgaW5saW5lIGNvZGUgc3BhbnNcbiAqIChgYCBgY29kZWAgYGApIGFuZCBtYXJrZG93biBsaW5rcyAoYFt0ZXh0XSh1cmwpYCkgdW50b3VjaGVkLiBNRFggcGFyc2VzIGJhcmUgYDxgL2B7YCBpbiBwcm9zZSBhc1xuICogSlNYL2V4cHJlc3Npb25zLCBzbyB0aGV5IG11c3QgYmUgYmFja3NsYXNoLWVzY2FwZWQgdG8gcmVuZGVyIGFzIGxpdGVyYWwgdGV4dC5cbiAqXG4gKiBAcGFyYW0gdGV4dCAtIFRoZSBwcm9zZSB0byBlc2NhcGUuXG4gKiBAcmV0dXJucyBUaGUgZXNjYXBlZCBwcm9zZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGVzY2FwZU1keFByb3NlKHRleHQ6IHN0cmluZyk6IHN0cmluZyB7XG4gIGNvbnN0IHByb3RlY3RlZFBhdHRlcm4gPSAvYFteYF0qYHxcXFtbXlxcXV0qXFxdXFwoW14pXSpcXCkvZztcbiAgbGV0IHJlc3VsdCA9ICcnO1xuICBsZXQgbGFzdEluZGV4ID0gMDtcbiAgZm9yIChjb25zdCBtYXRjaCBvZiB0ZXh0Lm1hdGNoQWxsKHByb3RlY3RlZFBhdHRlcm4pKSB7XG4gICAgY29uc3QgaW5kZXggPSBtYXRjaC5pbmRleDtcbiAgICByZXN1bHQgKz0gZXNjYXBlTWR4UHJvc2VDaGFycyh0ZXh0LnNsaWNlKGxhc3RJbmRleCwgaW5kZXgpKTtcbiAgICByZXN1bHQgKz0gbWF0Y2hbMF07XG4gICAgbGFzdEluZGV4ID0gaW5kZXggKyBtYXRjaFswXS5sZW5ndGg7XG4gIH1cbiAgcmVzdWx0ICs9IGVzY2FwZU1keFByb3NlQ2hhcnModGV4dC5zbGljZShsYXN0SW5kZXgpKTtcbiAgcmV0dXJuIHJlc3VsdDtcbn1cblxuLyoqXG4gKiBDb2xsYXBzZSBzaW5nbGUgbmV3bGluZXMgd2l0aGluIHBhcmFncmFwaHMgdG8gc3BhY2VzLCBwcmVzZXJ2ZSBkb3VibGUgbmV3bGluZXMgYXMgcGFyYWdyYXBoIGJyZWFrcy5cbiAqIEZlbmNlZCBjb2RlIGJsb2NrcyAoYmFja3RpY2sgb3IgdGlsZGUgZmVuY2VzKSBhcmUgcHJlc2VydmVkIHZlcmJhdGltIOKAlCB0aGVpciBpbnRlcm5hbCBuZXdsaW5lcyBhcmUgTk9UIGZvbGRlZCxcbiAqIHNvIGVtYmVkZGVkIGNvZGUgc3Vydml2ZXMgdG8gYmUgcmUtZW1pdHRlZCBhcyBhIHJlYWwgY29kZSBmZW5jZSBkb3duc3RyZWFtLlxuICpcbiAqIEBwYXJhbSB0ZXh0IC0gVGhlIHRleHQuXG4gKiBAcmV0dXJucyBUaGUgZm9sZGVkIHRleHQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBmb2xkVHNEb2NQYXJhZ3JhcGhzKHRleHQ6IHN0cmluZyk6IHN0cmluZyB7XG4gIGNvbnN0IHNlZ21lbnRzID0gc2VnbWVudE1hcmtkb3duKHRleHQpO1xuICByZXR1cm4gc2VnbWVudHNcbiAgICAubWFwKChzZWcpID0+IHtcbiAgICAgIHJldHVybiBzZWcudHlwZSA9PT0gJ2NvZGUnXG4gICAgICAgID8gYFxcYFxcYFxcYCR7c2VnLmxhbmd9XFxuJHtzZWcudGV4dH1cXG5cXGBcXGBcXGBgXG4gICAgICAgIDogc2VnLnRleHRcbiAgICAgICAgICAuc3BsaXQoL1xcbnsyLH0vKVxuICAgICAgICAgIC5tYXAoKHBhcmFncmFwaCkgPT4gcGFyYWdyYXBoLnJlcGxhY2VBbGwoJ1xcbicsICcgJykpXG4gICAgICAgICAgLmpvaW4oJ1xcblxcbicpO1xuICAgIH0pXG4gICAgLm1hcCgoc2VnbWVudCkgPT4gc2VnbWVudC50cmltKCkpXG4gICAgLmZpbHRlcihCb29sZWFuKVxuICAgIC5qb2luKCdcXG5cXG4nKTtcbn1cblxuLyoqXG4gKiBUaGUgdHlwZSdzIG5hbWUgd2l0aCBpdHMgdHlwZSBwYXJhbWV0ZXJzLCB3aXRob3V0IHRoZWlyIGNvbnN0cmFpbnRzLlxuICpcbiAqIEBwYXJhbSBuYW1lIC0gVGhlIHR5cGUncyBuYW1lLlxuICogQHBhcmFtIGluZm8gLSBUaGUgZG9jdW1lbnRlZCB0eXBlLlxuICogQHJldHVybnMgVGhlIG5hbWUgd2l0aCBpdHMgYmFyZSB0eXBlIHBhcmFtZXRlcnMuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXREaXNwbGF5TmFtZShuYW1lOiBzdHJpbmcsIGluZm86IFR5cGVJbmZvKTogc3RyaW5nIHtcbiAgaWYgKGluZm8udHlwZVBhcmFtZXRlcnMubGVuZ3RoID09PSAwKSB7XG4gICAgcmV0dXJuIG5hbWU7XG4gIH1cbiAgY29uc3QgYmFyZVBhcmFtcyA9IGluZm8udHlwZVBhcmFtZXRlcnMubWFwKCh0cCkgPT4gdHAucmVwbGFjZSgvXFxzK2V4dGVuZHNcXHMrLiokLywgJycpKTtcbiAgcmV0dXJuIGAke25hbWV9PCR7YmFyZVBhcmFtcy5qb2luKCcsICcpfT5gO1xufVxuXG4vKipcbiAqIEVtaXQgdGhlIGltcG9ydCBzdGF0ZW1lbnQgZm9yIGEgZG9jdW1lbnRlZCBleHBvcnQuXG4gKlxuICogVGhlIHN1YnBhdGggZXF1YWxzIHRoZSB0eXBlJ3MgbmFtZXNwYWNlIChpdHMgc291cmNlIHBhdGggcmVsYXRpdmUgdG8gYHNyY2ApLCBzbyBgc3JjL3N0cmluZy50c2Agb2ZcbiAqIGBAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWJgIGlzIGBAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvc3RyaW5nYC5cbiAqXG4gKiBJbnRlcmZhY2VzIC8gdHlwZSBhbGlhc2VzIC8gZW51bXMgYXJlIGltcG9ydGVkIHdpdGggYGltcG9ydCB0eXBlYDsgY2xhc3NlcyAvIGZ1bmN0aW9ucyAvXG4gKiB2YXJpYWJsZXMgd2l0aCBhIHZhbHVlIGBpbXBvcnRgLlxuICpcbiAqIEBwYXJhbSBpbmZvIC0gVGhlIGRvY3VtZW50ZWQgdHlwZS5cbiAqIEByZXR1cm5zIFRoZSBpbXBvcnQgc3RhdGVtZW50LlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0SW1wb3J0U3RhdGVtZW50KGluZm86IFR5cGVJbmZvKTogc3RyaW5nIHtcbiAgY29uc3QgaXNUeXBlT25seSA9IFsnZW51bScsICdpbnRlcmZhY2UnLCAndHlwZSddLmluY2x1ZGVzKGluZm8ua2luZCk7XG4gIGNvbnN0IGltcG9ydEtleXdvcmQgPSBpc1R5cGVPbmx5ID8gJ2ltcG9ydCB0eXBlJyA6ICdpbXBvcnQnO1xuICByZXR1cm4gYCR7aW1wb3J0S2V5d29yZH0geyAke2luZm8ubmFtZX0gfSBmcm9tICcke2dldEFwaURvY1NldHRpbmdzKCkucGFja2FnZU5hbWV9LyR7aW5mby5uYW1lc3BhY2V9JztgO1xufVxuXG4vKipcbiAqIFRoZSBmb2xkZXIgYSBuYW1lc3BhY2UncyBwYWdlcyBhcmUgd3JpdHRlbiB0by5cbiAqXG4gKiBAcGFyYW0gbmFtZXNwYWNlIC0gVGhlIHR5cGUncyBuYW1lc3BhY2UuXG4gKiBAcmV0dXJucyBUaGUgZm9sZGVyLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0TmFtZXNwYWNlRGlyZWN0b3J5KG5hbWVzcGFjZTogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIG5hbWVzcGFjZTtcbn1cblxuLyoqXG4gKiBTYW5pdGl6ZSBhIG1lbWJlciBuYW1lIGZvciB1c2UgaW4gYSBjYXNlLVBSRVNFUlZFRCBVUkwvcm91dGUgc2VnbWVudCAoZS5nLiBgc2hvd05vdGljZWApLlxuICpcbiAqIEBwYXJhbSBuYW1lIC0gVGhlIG1lbWJlcidzIG5hbWUuXG4gKiBAcmV0dXJucyBUaGUgY2FzZS1wcmVzZXJ2ZWQgc2VnbWVudC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG1lbWJlclJvdXRlU2VnbWVudChuYW1lOiBzdHJpbmcpOiBzdHJpbmcge1xuICByZXR1cm4gc2x1Z2lmeU1lbWJlck5hbWUobmFtZSk7XG59XG5cbi8qKlxuICogU2FuaXRpemUgYSBtZW1iZXIgbmFtZSBmb3IgdXNlIGFzIGFuIG9uLWRpc2sgRklMRU5BTUUgKGxvd2VyY2FzZWQsIGNvbGxpc2lvbi1zYWZlKS5cbiAqXG4gKiBAcGFyYW0gbmFtZSAtIFRoZSBtZW1iZXIncyBuYW1lLlxuICogQHJldHVybnMgVGhlIGxvd2VyY2FzZWQgZmlsZSBuYW1lIHNlZ21lbnQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBtZW1iZXJTbHVnKG5hbWU6IHN0cmluZyk6IHN0cmluZyB7XG4gIHJldHVybiB0b1JvdXRlU2VnbWVudChzbHVnaWZ5TWVtYmVyTmFtZShuYW1lKSk7XG59XG5cbi8qKlxuICogU2x1Z2lmeSBhbiBvdmVybG9hZCBrZXkgZm9yIGEgY2FzZS1QUkVTRVJWRUQgVVJML3JvdXRlIHNlZ21lbnQ6IG9uKFwiY2hhbmdlZFwiKSAtPiBvbi1jaGFuZ2VkLlxuICpcbiAqIEBwYXJhbSBvdmVybG9hZEtleSAtIFRoZSBvdmVybG9hZCBrZXksIGUuZy4gYG9uKCdjaGFuZ2VkJylgLlxuICogQHJldHVybnMgVGhlIGNhc2UtcHJlc2VydmVkIHNlZ21lbnQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBvdmVybG9hZFJvdXRlU2VnbWVudChvdmVybG9hZEtleTogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIHNsdWdpZnlPdmVybG9hZEtleShvdmVybG9hZEtleSk7XG59XG5cbi8qKlxuICogU2x1Z2lmeSBhbiBvdmVybG9hZCBrZXkgZm9yIGFuIG9uLWRpc2sgRklMRU5BTUU6IG9uKFwiY2hhbmdlZFwiKSAtPiBvbi1jaGFuZ2VkIChsb3dlcmNhc2VkKS5cbiAqXG4gKiBAcGFyYW0gb3ZlcmxvYWRLZXkgLSBUaGUgb3ZlcmxvYWQga2V5LCBlLmcuIGBvbignY2hhbmdlZCcpYC5cbiAqIEByZXR1cm5zIFRoZSBsb3dlcmNhc2VkIGZpbGUgbmFtZSBzZWdtZW50LlxuICovXG5leHBvcnQgZnVuY3Rpb24gb3ZlcmxvYWRTbHVnKG92ZXJsb2FkS2V5OiBzdHJpbmcpOiBzdHJpbmcge1xuICByZXR1cm4gdG9Sb3V0ZVNlZ21lbnQoc2x1Z2lmeU92ZXJsb2FkS2V5KG92ZXJsb2FkS2V5KSk7XG59XG5cbi8qKlxuICogUmVwbGFjZSBldmVyeSBtYXRjaCBvZiBhIGdsb2JhbCByZWd1bGFyIGV4cHJlc3Npb24gd2l0aCB3aGF0IGEgcmVwbGFjZXIgYnVpbGRzIGZyb20gdGhlIG1hdGNoLiBUaGUgdHlwZWRcbiAqIGNvdW50ZXJwYXJ0IG9mIGBTdHJpbmcucHJvdG90eXBlLnJlcGxhY2VBbGxgIHdpdGggYSBjYWxsYmFjaywgd2hvc2UgYXJndW1lbnRzIGFyZSB0eXBlZCBvbmx5IHBvc2l0aW9uYWxseS5cbiAqXG4gKiBAcGFyYW0gdGV4dCAtIFRoZSB0ZXh0LlxuICogQHBhcmFtIHJlZ0V4cCAtIFRoZSByZWd1bGFyIGV4cHJlc3Npb247IGl0IG11c3QgY2FycnkgdGhlIGBnYCBmbGFnLlxuICogQHBhcmFtIHJlcGxhY2VyIC0gQnVpbGRzIHRoZSByZXBsYWNlbWVudCBvZiBvbmUgbWF0Y2guXG4gKiBAcmV0dXJucyBUaGUgdGV4dCB3aXRoIGV2ZXJ5IG1hdGNoIHJlcGxhY2VkLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVwbGFjZVJlZ0V4cE1hdGNoZXModGV4dDogc3RyaW5nLCByZWdFeHA6IFJlZ0V4cCwgcmVwbGFjZXI6IChtYXRjaDogUmVnRXhwTWF0Y2hBcnJheSkgPT4gc3RyaW5nKTogc3RyaW5nIHtcbiAgbGV0IHJlc3VsdCA9ICcnO1xuICBsZXQgbGFzdEluZGV4ID0gMDtcbiAgZm9yIChjb25zdCBtYXRjaCBvZiB0ZXh0Lm1hdGNoQWxsKHJlZ0V4cCkpIHtcbiAgICByZXN1bHQgKz0gdGV4dC5zbGljZShsYXN0SW5kZXgsIG1hdGNoLmluZGV4KSArIHJlcGxhY2VyKG1hdGNoKTtcbiAgICBsYXN0SW5kZXggPSBtYXRjaC5pbmRleCArIG1hdGNoWzBdLmxlbmd0aDtcbiAgfVxuICByZXR1cm4gcmVzdWx0ICsgdGV4dC5zbGljZShsYXN0SW5kZXgpO1xufVxuXG4vKipcbiAqIFNwbGl0IG1hcmtkb3duIHRleHQgaW50byBhbiBvcmRlcmVkIGxpc3Qgb2YgcHJvc2UgYW5kIGZlbmNlZC1jb2RlIHNlZ21lbnRzLlxuICogQSBmZW5jZWQtY29kZSBzZWdtZW50IGlzIGRlbGltaXRlZCBieSBhIGxpbmUgb2YgMysgYmFja3RpY2tzIG9yIHRpbGRlczsgaXRzIGNvbnRlbnQgaXMgY2FwdHVyZWRcbiAqIHJhdyAobmV2ZXIgZXNjYXBlZCkgc28gaXQgY2FuIGJlIHJlLWVtaXR0ZWQgYXMgYSBsaXRlcmFsIE1EWCBjb2RlIGZlbmNlLlxuICpcbiAqIEBwYXJhbSB0ZXh0IC0gVGhlIHRleHQuXG4gKiBAcmV0dXJucyBUaGUgc2VnbWVudHMsIGluIG9yZGVyLlxuICovXG5leHBvcnQgZnVuY3Rpb24gc2VnbWVudE1hcmtkb3duKHRleHQ6IHN0cmluZyk6IE1hcmtkb3duU2VnbWVudFtdIHtcbiAgY29uc3QgbGluZXMgPSB0ZXh0LnNwbGl0KCdcXG4nKTtcbiAgY29uc3Qgc2VnbWVudHM6IE1hcmtkb3duU2VnbWVudFtdID0gW107XG4gIGxldCBwcm9zZUJ1ZmZlcjogc3RyaW5nW10gPSBbXTtcbiAgbGV0IGNvZGVMaW5lczogc3RyaW5nW10gPSBbXTtcbiAgbGV0IG9wZW5GZW5jZTogbnVsbCB8IE9wZW5GZW5jZSA9IG51bGw7XG4gIGZvciAoY29uc3QgbGluZSBvZiBsaW5lcykge1xuICAgIGlmIChvcGVuRmVuY2UpIHtcbiAgICAgIGlmIChvcGVuRmVuY2UuY2xvc2VSZS50ZXN0KGxpbmUpKSB7XG4gICAgICAgIHNlZ21lbnRzLnB1c2goeyBsYW5nOiBvcGVuRmVuY2UubGFuZywgdGV4dDogY29kZUxpbmVzLmpvaW4oJ1xcbicpLCB0eXBlOiAnY29kZScgfSk7XG4gICAgICAgIG9wZW5GZW5jZSA9IG51bGw7XG4gICAgICB9IGVsc2Uge1xuICAgICAgICBjb2RlTGluZXMucHVzaChsaW5lKTtcbiAgICAgIH1cbiAgICAgIGNvbnRpbnVlO1xuICAgIH1cblxuICAgIGNvbnN0IG9wZW5NYXRjaCA9IC9eXFxzKig/PGZlbmNlPig/PGZlbmNlQ2hhcj5bYH5dKVxcazxmZW5jZUNoYXI+ezIsfSkoPzxsYW5nPi4qKSQvLmV4ZWMobGluZSk7XG4gICAgaWYgKG9wZW5NYXRjaCkge1xuICAgICAgY29uc3QgZmVuY2VDaGFycyA9IGdldE1hbmRhdG9yeU5hbWVkR3JvdXAob3Blbk1hdGNoLCAnZmVuY2UnKTtcbiAgICAgIGNvbnN0IGZlbmNlQ2hhciA9IGdldE1hbmRhdG9yeU5hbWVkR3JvdXAob3Blbk1hdGNoLCAnZmVuY2VDaGFyJyk7XG4gICAgICBmbHVzaFByb3NlKCk7XG4gICAgICBjb2RlTGluZXMgPSBbXTtcbiAgICAgIG9wZW5GZW5jZSA9IHtcbiAgICAgICAgY2xvc2VSZTogbmV3IFJlZ0V4cChgXlxcXFxzKlxcXFwke2ZlbmNlQ2hhcn17JHtTdHJpbmcoZmVuY2VDaGFycy5sZW5ndGgpfSx9XFxcXHMqJGApLFxuICAgICAgICBsYW5nOiBnZXRNYW5kYXRvcnlOYW1lZEdyb3VwKG9wZW5NYXRjaCwgJ2xhbmcnKS50cmltKClcbiAgICAgIH07XG4gICAgICBjb250aW51ZTtcbiAgICB9XG4gICAgcHJvc2VCdWZmZXIucHVzaChsaW5lKTtcbiAgfVxuICAvLyBBbiB1bmNsb3NlZCBmZW5jZSBydW5zIHRvIHRoZSBlbmQgb2YgdGhlIHRleHQuXG4gIGlmIChvcGVuRmVuY2UpIHtcbiAgICBzZWdtZW50cy5wdXNoKHsgbGFuZzogb3BlbkZlbmNlLmxhbmcsIHRleHQ6IGNvZGVMaW5lcy5qb2luKCdcXG4nKSwgdHlwZTogJ2NvZGUnIH0pO1xuICB9XG4gIGZsdXNoUHJvc2UoKTtcbiAgcmV0dXJuIHNlZ21lbnRzO1xuXG4gIGZ1bmN0aW9uIGZsdXNoUHJvc2UoKTogdm9pZCB7XG4gICAgaWYgKHByb3NlQnVmZmVyLmxlbmd0aCA9PT0gMCkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIHNlZ21lbnRzLnB1c2goeyB0ZXh0OiBwcm9zZUJ1ZmZlci5qb2luKCdcXG4nKSwgdHlwZTogJ3Byb3NlJyB9KTtcbiAgICBwcm9zZUJ1ZmZlciA9IFtdO1xuICB9XG59XG5cbi8qKlxuICogU3RyaXAgdGhlIGBpbXBvcnQoXCLigKZcIilgIHF1YWxpZmllcnMgdHMtbW9ycGggcHJpbnRzIGJlZm9yZSBhIHR5cGUgdGhhdCBpcyBub3QgaW4gc2NvcGUsIHJlY29yZGluZyBlYWNoIG9uZSdzXG4gKiBkZWNsYXJhdGlvbiBmaWxlIGZpcnN0LCBzaW5jZSBpdCBpcyB0aGUgb25lIHBsYWNlIGEgcHJpbnRlZCB0eXBlIG5hbWVzIHdoZXJlIGl0IHdhcyBkZWNsYXJlZC5cbiAqXG4gKiBAcGFyYW0gdHlwZVRleHQgLSBUaGUgcHJpbnRlZCB0eXBlLlxuICogQHJldHVybnMgVGhlIHR5cGUgd2l0aG91dCBpdHMgaW1wb3J0IHF1YWxpZmllcnMuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzaW1wbGlmeVR5cGUodHlwZVRleHQ6IHN0cmluZyk6IHN0cmluZyB7XG4gIGZvciAoY29uc3QgbWF0Y2ggb2YgdHlwZVRleHQubWF0Y2hBbGwoSU1QT1JUX1RZUEVfUkVHX0VYUCkpIHtcbiAgICByZWdpc3RlclBhY2thZ2VEZWNsYXJhdGlvbihnZXRNYW5kYXRvcnlOYW1lZEdyb3VwKG1hdGNoLCAnTmFtZScpLCBnZXRNYW5kYXRvcnlOYW1lZEdyb3VwKG1hdGNoLCAnUGF0aCcpKTtcbiAgfVxuXG4gIHJldHVybiB0eXBlVGV4dC5yZXBsYWNlQWxsKElNUE9SVF9RVUFMSUZJRVJfUkVHX0VYUCwgJycpO1xufVxuXG4vKipcbiAqIE5vcm1hbGl6ZSBhIGNvZGUgc2lnbmF0dXJlIGZvciB0aGUgYHNpZ25hdHVyZTpgIGZyb250bWF0dGVyIC8gT0cgY2FyZDogY29sbGFwc2Ugd2hpdGVzcGFjZSB0b1xuICogc2luZ2xlIHNwYWNlcyBhbmQgdHJ1bmNhdGUgdG8gYSBjYXJkLWZyaWVuZGx5IGxlbmd0aCB3aXRoIGFuIGVsbGlwc2lzLlxuICpcbiAqIEBwYXJhbSBzaWduYXR1cmUgLSBUaGUgc2lnbmF0dXJlLlxuICogQHJldHVybnMgVGhlIG5vcm1hbGl6ZWQgc2lnbmF0dXJlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gdHJ1bmNhdGVTaWduYXR1cmUoc2lnbmF0dXJlOiBzdHJpbmcpOiBzdHJpbmcge1xuICBjb25zdCBjb2xsYXBzZWQgPSBzaWduYXR1cmUucmVwbGFjZUFsbCgvXFxzKy9nLCAnICcpLnRyaW0oKTtcbiAgcmV0dXJuIGNvbGxhcHNlZC5sZW5ndGggPD0gU0lHTkFUVVJFX01BWF9MRU5HVEggPyBjb2xsYXBzZWQgOiBgJHtjb2xsYXBzZWQuc2xpY2UoMCwgU0lHTkFUVVJFX01BWF9MRU5HVEggLSAxKS50cmltRW5kKCl94oCmYDtcbn1cblxuZnVuY3Rpb24gc2x1Z2lmeU1lbWJlck5hbWUobmFtZTogc3RyaW5nKTogc3RyaW5nIHtcbiAgY29uc3QgY2xlYW5lZCA9IG5hbWVcbiAgICAucmVwbGFjZUFsbCgvXltcIiddfFtcIiddJC9nLCAnJylcbiAgICAucmVwbGFjZUFsbCgvW15hLXpBLVowLTldL2csICctJylcbiAgICAucmVwbGFjZUFsbCgvLSsvZywgJy0nKVxuICAgIC5yZXBsYWNlQWxsKC9eLXwtJC9nLCAnJyk7XG4gIC8vIEEgbWVtYmVyIGxpdGVyYWxseSBuYW1lZCBgaW5kZXhgIHdvdWxkIHdyaXRlIGBpbmRleC5tZHhgLCBjb2xsaWRpbmcgd2l0aCB0aGUgdHlwZS1vdmVydmlld1xuICAvLyBgaW5kZXgubWR4YCBpbiB0aGUgc2FtZSBkaXJlY3RvcnkgKG9uZSBzaWxlbnRseSBvdmVyd3JpdGVzIHRoZSBvdGhlciwgNDA0LWluZyB0aGUgbG9zZXIpLlxuICByZXR1cm4gY2xlYW5lZCA9PT0gJ2luZGV4JyA/ICdpbmRleC1tZW1iZXInIDogKGNsZWFuZWQgfHwgJ3VubmFtZWQnKTtcbn1cblxuZnVuY3Rpb24gc2x1Z2lmeU92ZXJsb2FkS2V5KG92ZXJsb2FkS2V5OiBzdHJpbmcpOiBzdHJpbmcge1xuICBjb25zdCBzbHVnID0gb3ZlcmxvYWRLZXlcbiAgICAucmVwbGFjZUFsbCgvW1wiJygpXS9nLCAnICcpXG4gICAgLnJlcGxhY2VBbGwoL1teYS16QS1aMC05XFxzXS9nLCAnJylcbiAgICAudHJpbSgpXG4gICAgLnJlcGxhY2VBbGwoL1xccysvZywgJy0nKTtcbiAgLy8gQSBtZXRob2QgbmFtZWQgYGluZGV4YCB3b3VsZCB3cml0ZSBgaW5kZXgubWR4YCBvdmVyIHRoZSB0eXBlLW92ZXJ2aWV3IHBhZ2UsIGV4YWN0bHkgYXMgYSBwcm9wZXJ0eSB3b3VsZC5cbiAgcmV0dXJuIHNsdWcgPT09ICdpbmRleCcgPyAnaW5kZXgtbWVtYmVyJyA6IHNsdWc7XG59XG5cbmNvbnN0IE9HX0RFU0NSSVBUSU9OX01BWF9MRU5HVEggPSAxNjA7XG5cbi8qKlxuICogU3RyaXAgbWFya2Rvd24gZm9ybWF0dGluZyB0byBwbGFpbiB0ZXh0IGZvciB1c2UgaW4gbWV0YSBkZXNjcmlwdGlvbnNcbiAqXG4gKiBAcGFyYW0gdGV4dCAtIFRoZSB0ZXh0LlxuICogQHJldHVybnMgVGhlIHBsYWluIHRleHQsIGF0IG1vc3QgMTYwIGNoYXJhY3RlcnMuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzdHJpcE1hcmtkb3duKHRleHQ6IHN0cmluZyk6IHN0cmluZyB7XG4gIGNvbnN0IHBsYWluID0gcmVwbGFjZVJlZ0V4cE1hdGNoZXModGV4dCwgL1xce0BsaW5rXFxzKyg/OltefH1dKz8pKD86XFxzKlxcfFxccyooPzxkaXNwbGF5PltefV0rPykpP1xcfS9nLCAobWF0Y2gpID0+IGdldE9wdGlvbmFsTmFtZWRHcm91cChtYXRjaCwgJ2Rpc3BsYXknKSA/PyAnJylcbiAgICAucmVwbGFjZUFsbCgvXFxbKD88dGV4dD5bXlxcXV0rKVxcXVxcKFteKV0rXFwpL2csICckPHRleHQ+JylcbiAgICAucmVwbGFjZUFsbCgvW2AqX35dL2csICcnKVxuICAgIC5yZXBsYWNlQWxsKC9cXHMrL2csICcgJylcbiAgICAudHJpbSgpO1xuXG4gIGlmIChwbGFpbi5sZW5ndGggPD0gT0dfREVTQ1JJUFRJT05fTUFYX0xFTkdUSCkge1xuICAgIHJldHVybiBwbGFpbjtcbiAgfVxuXG4gIC8vIEN1dCBiYWNrIHRvIGEgd29yZCBib3VuZGFyeTogYSByYXcgc2xpY2UgZW5kcyBkZXNjcmlwdGlvbnMgbWlkLXdvcmQgKGDigKYgdGhlIHN0cmluZyBtb2R1bGUgaXMgb2JgKS5cbiAgLy8gVGhhdCBmcmFnbWVudCBpcyB3aGF0IHJlYWRlcnMgc2VlIG9uIHRoZSBPRyBjYXJkIGFuZCBpbiBzZWFyY2ggcmVzdWx0cy5cbiAgY29uc3QgY2xpcHBlZCA9IHBsYWluLnNsaWNlKDAsIE9HX0RFU0NSSVBUSU9OX01BWF9MRU5HVEggLSAxKTtcbiAgY29uc3QgbGFzdFNwYWNlSW5kZXggPSBjbGlwcGVkLmxhc3RJbmRleE9mKCcgJyk7XG4gIGNvbnN0IHRydW5jYXRlZCA9IGxhc3RTcGFjZUluZGV4ID4gMCA/IGNsaXBwZWQuc2xpY2UoMCwgbGFzdFNwYWNlSW5kZXgpIDogY2xpcHBlZDtcbiAgcmV0dXJuIGAke3RydW5jYXRlZC5yZXBsYWNlKC9bLDs6Llxcc10rJC8sICcnKX3igKZgO1xufVxuXG5mdW5jdGlvbiBlc2NhcGVNZHhQcm9zZUNoYXJzKGNodW5rOiBzdHJpbmcpOiBzdHJpbmcge1xuICByZXR1cm4gY2h1bmsucmVwbGFjZUFsbCgvWzx7fV0vZywgKGNoYXIpID0+IGBcXFxcJHtjaGFyfWApO1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFNQSxxQkFHTztBQUNQLHNCQUFzQjtBQUN0Qix1QkFBd0I7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
@@ -0,0 +1,178 @@
1
+ /// <reference path="../library-references.d.cts" />
2
+ /**
3
+ * @file
4
+ *
5
+ * Text/markdown/escaping utilities and identifier helpers for the API documentation generator.
6
+ */
7
+ import type { MarkdownSegment, MemberInfo, TypeInfo } from './api-doc-types.cjs';
8
+ /**
9
+ * Compute an overload key for methods with distinguishing first param (e.g. on('changed',...))
10
+ *
11
+ * @param method - The method.
12
+ * @returns The overload key.
13
+ */
14
+ export declare function computeOverloadKey(method: MemberInfo): string;
15
+ /**
16
+ * Creates the folder a file is about to be written to.
17
+ *
18
+ * @param filePath - The path of the file about to be written.
19
+ */
20
+ export declare function ensureDirectory(filePath: string): Promise<void>;
21
+ /**
22
+ * Escape text for use inside a JS string within a JSX expression: {...{key: "..."}}
23
+ *
24
+ * @param text - The text to escape.
25
+ * @returns The escaped text.
26
+ */
27
+ export declare function escapeJsString(text: string): string;
28
+ /**
29
+ * Escape text for use inside a JSX attribute: attr="..." (MDX uses HTML-style parsing)
30
+ *
31
+ * @param text - The text to escape.
32
+ * @returns The escaped text.
33
+ */
34
+ export declare function escapeJsxAttribute(text: string): string;
35
+ /**
36
+ * Escape text for a markdown table cell.
37
+ *
38
+ * @param text - The text to escape.
39
+ * @returns The escaped text.
40
+ */
41
+ export declare function escapeMarkdown(text: string): string;
42
+ /**
43
+ * Escape angle brackets so MDX does not read them as JSX.
44
+ *
45
+ * @param text - The text to escape.
46
+ * @returns The escaped text.
47
+ */
48
+ export declare function escapeMdxAngleBrackets(text: string): string;
49
+ /**
50
+ * Escape curly braces in MDX markdown content to prevent JSX expression parsing
51
+ *
52
+ * @param text - The text to escape.
53
+ * @returns The escaped text.
54
+ */
55
+ export declare function escapeMdxBraces(text: string): string;
56
+ /**
57
+ * Escape text for a double-quoted YAML value.
58
+ *
59
+ * @param text - The text to escape.
60
+ * @returns The escaped text.
61
+ */
62
+ export declare function escapeYaml(text: string): string;
63
+ /**
64
+ * Escape MDX-unsafe characters (`<`, `{`, `}`) in prose text, while leaving inline code spans
65
+ * (`` `code` ``) and markdown links (`[text](url)`) untouched. MDX parses bare `<`/`{` in prose as
66
+ * JSX/expressions, so they must be backslash-escaped to render as literal text.
67
+ *
68
+ * @param text - The prose to escape.
69
+ * @returns The escaped prose.
70
+ */
71
+ export declare function escapeMdxProse(text: string): string;
72
+ /**
73
+ * Collapse single newlines within paragraphs to spaces, preserve double newlines as paragraph breaks.
74
+ * Fenced code blocks (backtick or tilde fences) are preserved verbatim — their internal newlines are NOT folded,
75
+ * so embedded code survives to be re-emitted as a real code fence downstream.
76
+ *
77
+ * @param text - The text.
78
+ * @returns The folded text.
79
+ */
80
+ export declare function foldTsDocParagraphs(text: string): string;
81
+ /**
82
+ * The type's name with its type parameters, without their constraints.
83
+ *
84
+ * @param name - The type's name.
85
+ * @param info - The documented type.
86
+ * @returns The name with its bare type parameters.
87
+ */
88
+ export declare function getDisplayName(name: string, info: TypeInfo): string;
89
+ /**
90
+ * Emit the import statement for a documented export.
91
+ *
92
+ * The subpath equals the type's namespace (its source path relative to `src`), so `src/string.ts` of
93
+ * `@mnaoumov/typescript-lib` is `@mnaoumov/typescript-lib/string`.
94
+ *
95
+ * Interfaces / type aliases / enums are imported with `import type`; classes / functions /
96
+ * variables with a value `import`.
97
+ *
98
+ * @param info - The documented type.
99
+ * @returns The import statement.
100
+ */
101
+ export declare function getImportStatement(info: TypeInfo): string;
102
+ /**
103
+ * The folder a namespace's pages are written to.
104
+ *
105
+ * @param namespace - The type's namespace.
106
+ * @returns The folder.
107
+ */
108
+ export declare function getNamespaceDirectory(namespace: string): string;
109
+ /**
110
+ * Sanitize a member name for use in a case-PRESERVED URL/route segment (e.g. `showNotice`).
111
+ *
112
+ * @param name - The member's name.
113
+ * @returns The case-preserved segment.
114
+ */
115
+ export declare function memberRouteSegment(name: string): string;
116
+ /**
117
+ * Sanitize a member name for use as an on-disk FILENAME (lowercased, collision-safe).
118
+ *
119
+ * @param name - The member's name.
120
+ * @returns The lowercased file name segment.
121
+ */
122
+ export declare function memberSlug(name: string): string;
123
+ /**
124
+ * Slugify an overload key for a case-PRESERVED URL/route segment: on("changed") -> on-changed.
125
+ *
126
+ * @param overloadKey - The overload key, e.g. `on('changed')`.
127
+ * @returns The case-preserved segment.
128
+ */
129
+ export declare function overloadRouteSegment(overloadKey: string): string;
130
+ /**
131
+ * Slugify an overload key for an on-disk FILENAME: on("changed") -> on-changed (lowercased).
132
+ *
133
+ * @param overloadKey - The overload key, e.g. `on('changed')`.
134
+ * @returns The lowercased file name segment.
135
+ */
136
+ export declare function overloadSlug(overloadKey: string): string;
137
+ /**
138
+ * Replace every match of a global regular expression with what a replacer builds from the match. The typed
139
+ * counterpart of `String.prototype.replaceAll` with a callback, whose arguments are typed only positionally.
140
+ *
141
+ * @param text - The text.
142
+ * @param regExp - The regular expression; it must carry the `g` flag.
143
+ * @param replacer - Builds the replacement of one match.
144
+ * @returns The text with every match replaced.
145
+ */
146
+ export declare function replaceRegExpMatches(text: string, regExp: RegExp, replacer: (match: RegExpMatchArray) => string): string;
147
+ /**
148
+ * Split markdown text into an ordered list of prose and fenced-code segments.
149
+ * A fenced-code segment is delimited by a line of 3+ backticks or tildes; its content is captured
150
+ * raw (never escaped) so it can be re-emitted as a literal MDX code fence.
151
+ *
152
+ * @param text - The text.
153
+ * @returns The segments, in order.
154
+ */
155
+ export declare function segmentMarkdown(text: string): MarkdownSegment[];
156
+ /**
157
+ * Strip the `import("…", { with: { 'resolution-mode': 'import' } })` qualifiers ts-morph prints before a type that is not in scope, recording each one's
158
+ * declaration file first, since it is the one place a printed type names where it was declared.
159
+ *
160
+ * @param typeText - The printed type.
161
+ * @returns The type without its import qualifiers.
162
+ */
163
+ export declare function simplifyType(typeText: string): string;
164
+ /**
165
+ * Normalize a code signature for the `signature:` frontmatter / OG card: collapse whitespace to
166
+ * single spaces and truncate to a card-friendly length with an ellipsis.
167
+ *
168
+ * @param signature - The signature.
169
+ * @returns The normalized signature.
170
+ */
171
+ export declare function truncateSignature(signature: string): string;
172
+ /**
173
+ * Strip markdown formatting to plain text for use in meta descriptions
174
+ *
175
+ * @param text - The text.
176
+ * @returns The plain text, at most 160 characters.
177
+ */
178
+ export declare function stripMarkdown(text: string): string;