@nzyme/cli 0.13.0 → 0.15.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 (143) hide show
  1. package/bin/cli.js +3 -0
  2. package/dist/Command.d.ts +59 -0
  3. package/dist/Command.js +87 -0
  4. package/dist/Command.js.map +1 -0
  5. package/dist/Command.test.d.ts +1 -0
  6. package/dist/Command.test.js +77 -0
  7. package/dist/Command.test.js.map +1 -0
  8. package/dist/cli.d.ts +1 -1
  9. package/dist/cli.js +27 -15
  10. package/dist/cli.js.map +1 -1
  11. package/dist/codeIndex/IndexSettings.d.ts +60 -0
  12. package/dist/codeIndex/IndexSettings.js +59 -0
  13. package/dist/codeIndex/IndexSettings.js.map +1 -0
  14. package/dist/codeIndex/IndexSymbol.d.ts +32 -0
  15. package/dist/codeIndex/IndexSymbol.js +2 -0
  16. package/dist/codeIndex/IndexSymbol.js.map +1 -0
  17. package/dist/codeIndex/NzymeIndexConfig.d.ts +72 -0
  18. package/dist/codeIndex/NzymeIndexConfig.js +101 -0
  19. package/dist/codeIndex/NzymeIndexConfig.js.map +1 -0
  20. package/dist/codeIndex/NzymeIndexConfig.test.d.ts +1 -0
  21. package/dist/codeIndex/NzymeIndexConfig.test.js +56 -0
  22. package/dist/codeIndex/NzymeIndexConfig.test.js.map +1 -0
  23. package/dist/codeIndex/collectIndexSourceFiles.d.ts +8 -0
  24. package/dist/codeIndex/collectIndexSourceFiles.js +57 -0
  25. package/dist/codeIndex/collectIndexSourceFiles.js.map +1 -0
  26. package/dist/codeIndex/collectSymbols.d.ts +27 -0
  27. package/dist/codeIndex/collectSymbols.js +151 -0
  28. package/dist/codeIndex/collectSymbols.js.map +1 -0
  29. package/dist/codeIndex/collectSymbols.test.d.ts +1 -0
  30. package/dist/codeIndex/collectSymbols.test.js +204 -0
  31. package/dist/codeIndex/collectSymbols.test.js.map +1 -0
  32. package/dist/codeIndex/extractComponent.d.ts +25 -0
  33. package/dist/codeIndex/extractComponent.js +38 -0
  34. package/dist/codeIndex/extractComponent.js.map +1 -0
  35. package/dist/codeIndex/extractComponent.test.d.ts +1 -0
  36. package/dist/codeIndex/extractComponent.test.js +65 -0
  37. package/dist/codeIndex/extractComponent.test.js.map +1 -0
  38. package/dist/codeIndex/extractDefineSymbol.d.ts +30 -0
  39. package/dist/codeIndex/extractDefineSymbol.js +86 -0
  40. package/dist/codeIndex/extractDefineSymbol.js.map +1 -0
  41. package/dist/codeIndex/extractDefineSymbol.test.d.ts +1 -0
  42. package/dist/codeIndex/extractDefineSymbol.test.js +142 -0
  43. package/dist/codeIndex/extractDefineSymbol.test.js.map +1 -0
  44. package/dist/codeIndex/extractEntity.d.ts +29 -0
  45. package/dist/codeIndex/extractEntity.js +63 -0
  46. package/dist/codeIndex/extractEntity.js.map +1 -0
  47. package/dist/codeIndex/extractEntity.test.d.ts +1 -0
  48. package/dist/codeIndex/extractEntity.test.js +79 -0
  49. package/dist/codeIndex/extractEntity.test.js.map +1 -0
  50. package/dist/codeIndex/extractUtil.d.ts +27 -0
  51. package/dist/codeIndex/extractUtil.js +98 -0
  52. package/dist/codeIndex/extractUtil.js.map +1 -0
  53. package/dist/codeIndex/extractUtil.test.d.ts +1 -0
  54. package/dist/codeIndex/extractUtil.test.js +111 -0
  55. package/dist/codeIndex/extractUtil.test.js.map +1 -0
  56. package/dist/codeIndex/importPathOf.d.ts +18 -0
  57. package/dist/codeIndex/importPathOf.js +17 -0
  58. package/dist/codeIndex/importPathOf.js.map +1 -0
  59. package/dist/codeIndex/importPathOf.test.d.ts +1 -0
  60. package/dist/codeIndex/importPathOf.test.js +40 -0
  61. package/dist/codeIndex/importPathOf.test.js.map +1 -0
  62. package/dist/codeIndex/jsdocSummary.d.ts +9 -0
  63. package/dist/codeIndex/jsdocSummary.js +18 -0
  64. package/dist/codeIndex/jsdocSummary.js.map +1 -0
  65. package/dist/codeIndex/jsdocSummary.test.d.ts +1 -0
  66. package/dist/codeIndex/jsdocSummary.test.js +33 -0
  67. package/dist/codeIndex/jsdocSummary.test.js.map +1 -0
  68. package/dist/codeIndex/renderMarkdown.d.ts +27 -0
  69. package/dist/codeIndex/renderMarkdown.js +171 -0
  70. package/dist/codeIndex/renderMarkdown.js.map +1 -0
  71. package/dist/codeIndex/renderMarkdown.test.d.ts +1 -0
  72. package/dist/codeIndex/renderMarkdown.test.js +291 -0
  73. package/dist/codeIndex/renderMarkdown.test.js.map +1 -0
  74. package/dist/commands/DepcheckCommand.d.ts +25 -2
  75. package/dist/commands/DepcheckCommand.js +296 -107
  76. package/dist/commands/DepcheckCommand.js.map +1 -1
  77. package/dist/commands/FormatMarkdownCommand.d.ts +22 -0
  78. package/dist/commands/FormatMarkdownCommand.js +256 -0
  79. package/dist/commands/FormatMarkdownCommand.js.map +1 -0
  80. package/dist/commands/FormatMarkdownCommand.test.d.ts +1 -0
  81. package/dist/commands/FormatMarkdownCommand.test.js +82 -0
  82. package/dist/commands/FormatMarkdownCommand.test.js.map +1 -0
  83. package/dist/commands/IndexCommand.d.ts +20 -0
  84. package/dist/commands/IndexCommand.js +81 -0
  85. package/dist/commands/IndexCommand.js.map +1 -0
  86. package/dist/commands/IndexCommand.test.d.ts +1 -0
  87. package/dist/commands/IndexCommand.test.js +126 -0
  88. package/dist/commands/IndexCommand.test.js.map +1 -0
  89. package/dist/commands/LocaliseCommand.d.ts +23 -0
  90. package/dist/commands/LocaliseCommand.js +125 -0
  91. package/dist/commands/LocaliseCommand.js.map +1 -0
  92. package/dist/commands/MonorepoCommand.d.ts +23 -1
  93. package/dist/commands/MonorepoCommand.js +255 -149
  94. package/dist/commands/MonorepoCommand.js.map +1 -1
  95. package/dist/commands/QuietRunCommand.d.ts +27 -0
  96. package/dist/commands/QuietRunCommand.js +140 -0
  97. package/dist/commands/QuietRunCommand.js.map +1 -0
  98. package/dist/commands/QuietRunCommand.test.d.ts +1 -0
  99. package/dist/commands/QuietRunCommand.test.js +48 -0
  100. package/dist/commands/QuietRunCommand.test.js.map +1 -0
  101. package/dist/commands/SubmoduleBumpCommand.d.ts +27 -0
  102. package/dist/commands/SubmoduleBumpCommand.js +77 -0
  103. package/dist/commands/SubmoduleBumpCommand.js.map +1 -0
  104. package/dist/execute.d.ts +25 -0
  105. package/dist/execute.js +22 -0
  106. package/dist/execute.js.map +1 -0
  107. package/dist/index.d.ts +3 -2
  108. package/dist/index.js +3 -2
  109. package/dist/index.js.map +1 -1
  110. package/dist/initialize.d.ts +1 -15
  111. package/dist/initialize.js +4 -8
  112. package/dist/initialize.js.map +1 -1
  113. package/dist/quietRun/quietRunReport.d.ts +70 -0
  114. package/dist/quietRun/quietRunReport.js +128 -0
  115. package/dist/quietRun/quietRunReport.js.map +1 -0
  116. package/dist/quietRun/quietRunReport.test.d.ts +1 -0
  117. package/dist/quietRun/quietRunReport.test.js +87 -0
  118. package/dist/quietRun/quietRunReport.test.js.map +1 -0
  119. package/dist/submodule/GitRepository.d.ts +70 -0
  120. package/dist/submodule/GitRepository.js +129 -0
  121. package/dist/submodule/GitRepository.js.map +1 -0
  122. package/dist/submodule/bumpSubmodule.d.ts +45 -0
  123. package/dist/submodule/bumpSubmodule.js +52 -0
  124. package/dist/submodule/bumpSubmodule.js.map +1 -0
  125. package/dist/submodule/renderBumpSummary.d.ts +12 -0
  126. package/dist/submodule/renderBumpSummary.js +50 -0
  127. package/dist/submodule/renderBumpSummary.js.map +1 -0
  128. package/dist/submodule/renderBumpSummary.test.d.ts +1 -0
  129. package/dist/submodule/renderBumpSummary.test.js +55 -0
  130. package/dist/submodule/renderBumpSummary.test.js.map +1 -0
  131. package/dist/submodule/submodule.test.d.ts +1 -0
  132. package/dist/submodule/submodule.test.js +155 -0
  133. package/dist/submodule/submodule.test.js.map +1 -0
  134. package/package.json +55 -50
  135. package/dist/commands/BuildCommand.d.ts +0 -4
  136. package/dist/commands/BuildCommand.js +0 -47
  137. package/dist/commands/BuildCommand.js.map +0 -1
  138. package/dist/defineCommand.d.ts +0 -48
  139. package/dist/defineCommand.js +0 -11
  140. package/dist/defineCommand.js.map +0 -1
  141. package/dist/defineProgram.d.ts +0 -30
  142. package/dist/defineProgram.js +0 -53
  143. package/dist/defineProgram.js.map +0 -1
@@ -0,0 +1,98 @@
1
+ import * as ts from 'typescript';
2
+ import { jsdocSummary } from './jsdocSummary.js';
3
+ /**
4
+ * Extracts every exported helper function tagged with a `@util` JSDoc tag from a source file's
5
+ * top-level statements. Two forms are recognized: an `export function foo(...)` declaration (the
6
+ * dominant form) and an `export const foo = (...) => ...` / `= function (...)` whose initializer
7
+ * is an arrow function or function expression. The `@util` tag is detected structurally via
8
+ * `ts.getJSDocTags` — a bare `@util` appearing in prose (not as a tag) does not qualify.
9
+ *
10
+ * The rendered `signature` is reconstructed from source text as `name(paramText, ...): returnText`
11
+ * (each parameter's and the return type's `.getText`), with the return part omitted when there is
12
+ * no explicit return type; the body and JSDoc are never included. Syntax-only — it never
13
+ * type-checks and never throws on unexpected AST: non-matching statements are simply skipped.
14
+ * @__NO_SIDE_EFFECTS__
15
+ */
16
+ export function extractUtil(options) {
17
+ const { sourceFile, packageName, relPath, importPath } = options;
18
+ const symbols = [];
19
+ for (const statement of sourceFile.statements) {
20
+ const symbol = matchStatement(statement);
21
+ if (symbol) {
22
+ symbols.push(symbol);
23
+ }
24
+ }
25
+ return symbols;
26
+ function matchStatement(statement) {
27
+ const match = matchFunction(statement);
28
+ if (!match || !hasUtilTag(match.tagHost, sourceFile)) {
29
+ return null;
30
+ }
31
+ return {
32
+ kind: 'util',
33
+ packageName,
34
+ exportName: match.name,
35
+ importPath,
36
+ internalName: null,
37
+ description: jsdocSummary(match.tagHost),
38
+ signature: buildSignature(match.name, match.func),
39
+ relPath,
40
+ };
41
+ }
42
+ /**
43
+ * Resolves an exported function statement into its name, the function-like node (for the
44
+ * signature), and the node whose JSDoc/tags carry the `@util` tag. Returns null for anything
45
+ * that isn't an exported function declaration or an exported const arrow/function expression.
46
+ */
47
+ function matchFunction(statement) {
48
+ if (ts.isFunctionDeclaration(statement)) {
49
+ if (!hasExportModifier(statement.modifiers) || !statement.name) {
50
+ return null;
51
+ }
52
+ return { name: statement.name.text, func: statement, tagHost: statement };
53
+ }
54
+ if (!ts.isVariableStatement(statement) || !hasExportModifier(statement.modifiers)) {
55
+ return null;
56
+ }
57
+ const declaration = statement.declarationList.declarations[0];
58
+ if (!declaration || !ts.isIdentifier(declaration.name) || !declaration.initializer) {
59
+ return null;
60
+ }
61
+ const initializer = declaration.initializer;
62
+ if (!ts.isArrowFunction(initializer) && !ts.isFunctionExpression(initializer)) {
63
+ return null;
64
+ }
65
+ // Tags live on the VariableStatement's JSDoc for `export const x = () => ...`.
66
+ return { name: declaration.name.text, func: initializer, tagHost: statement };
67
+ }
68
+ /** Builds `name(param1, param2): returnType`, omitting the return part when absent. */
69
+ function buildSignature(name, func) {
70
+ const paramsText = func.parameters.map(parameter => parameter.getText(sourceFile)).join(', ');
71
+ const returnText = func.type ? `: ${func.type.getText(sourceFile)}` : '';
72
+ return `${name}(${paramsText})${returnText}`;
73
+ }
74
+ }
75
+ /**
76
+ * True when a genuine `@util` JSDoc tag is present on the node. The TypeScript JSDoc parser
77
+ * turns any `@word` — even one appearing mid-sentence in prose — into a tag node, so a name match
78
+ * alone is not enough. A real tag begins its own JSDoc line, so we additionally require that the
79
+ * text between the line start and the tag's `@` be only JSDoc framing (whitespace / `*` / `/`).
80
+ */
81
+ function hasUtilTag(node, sourceFile) {
82
+ return ts.getJSDocTags(node).some(tag => tag.tagName.text === 'util' && startsJSDocLine(tag, sourceFile));
83
+ }
84
+ /** True when the tag's `@` is preceded on its line only by JSDoc framing (whitespace, `*`, `/`). */
85
+ function startsJSDocLine(tag, sourceFile) {
86
+ const fullText = sourceFile.getFullText();
87
+ const tagStart = tag.getStart(sourceFile);
88
+ let lineStart = tagStart;
89
+ while (lineStart > 0 && fullText[lineStart - 1] !== '\n') {
90
+ lineStart--;
91
+ }
92
+ return /^[\s*/]*$/.test(fullText.slice(lineStart, tagStart));
93
+ }
94
+ /** True when the modifier list carries the `export` keyword. */
95
+ function hasExportModifier(modifiers) {
96
+ return modifiers?.some(modifier => modifier.kind === ts.SyntaxKind.ExportKeyword) ?? false;
97
+ }
98
+ //# sourceMappingURL=extractUtil.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extractUtil.js","sourceRoot":"","sources":["../../src/codeIndex/extractUtil.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,111 @@
1
+ import { describe, expect, it } from 'bun:test';
2
+ import * as ts from 'typescript';
3
+ import { extractUtil } from './extractUtil.js';
4
+ function extract(source) {
5
+ const sourceFile = ts.createSourceFile('x.ts', source, ts.ScriptTarget.Latest, true);
6
+ return extractUtil({
7
+ sourceFile,
8
+ packageName: '@acme/test',
9
+ relPath: 'packages/test/src/x.ts',
10
+ importPath: '@acme/test/x.js',
11
+ });
12
+ }
13
+ describe('extractUtil', () => {
14
+ it('extracts an exported function tagged @util with signature and description', () => {
15
+ const symbols = extract(`
16
+ /**
17
+ * Formats a date relative to now.
18
+ * @util
19
+ */
20
+ export function formatRelativeDate(date: Date, now: Date): string {
21
+ return '';
22
+ }
23
+ `);
24
+ expect(symbols).toEqual([
25
+ {
26
+ kind: 'util',
27
+ packageName: '@acme/test',
28
+ exportName: 'formatRelativeDate',
29
+ importPath: '@acme/test/x.js',
30
+ internalName: null,
31
+ description: 'Formats a date relative to now.',
32
+ signature: 'formatRelativeDate(date: Date, now: Date): string',
33
+ relPath: 'packages/test/src/x.ts',
34
+ },
35
+ ]);
36
+ });
37
+ it('does not extract an exported function without the @util tag', () => {
38
+ const symbols = extract(`
39
+ /** Formats a date relative to now. */
40
+ export function formatRelativeDate(date: Date): string {
41
+ return '';
42
+ }
43
+ `);
44
+ expect(symbols).toEqual([]);
45
+ });
46
+ it('does not treat @util mentioned only in prose as a tag', () => {
47
+ const symbols = extract(`
48
+ /** Companion to the @util helpers but not itself tagged. */
49
+ export function notTagged(x: number): number {
50
+ return x;
51
+ }
52
+ `);
53
+ expect(symbols).toEqual([]);
54
+ });
55
+ it('extracts a const arrow function tagged @util', () => {
56
+ const symbols = extract(`
57
+ /**
58
+ * Clamps a number.
59
+ * @util
60
+ */
61
+ export const clamp = (value: number, min: number, max: number): number => value;
62
+ `);
63
+ expect(symbols).toMatchObject([
64
+ {
65
+ kind: 'util',
66
+ exportName: 'clamp',
67
+ description: 'Clamps a number.',
68
+ signature: 'clamp(value: number, min: number, max: number): number',
69
+ },
70
+ ]);
71
+ });
72
+ it('extracts a const function expression tagged @util', () => {
73
+ const symbols = extract(`
74
+ /** @util */
75
+ export const identity = function (value: number): number {
76
+ return value;
77
+ };
78
+ `);
79
+ expect(symbols).toMatchObject([
80
+ { kind: 'util', exportName: 'identity', signature: 'identity(value: number): number' },
81
+ ]);
82
+ });
83
+ it('omits the return type from the signature when there is no explicit return type', () => {
84
+ const symbols = extract(`
85
+ /** @util */
86
+ export function noReturn(x: number) {}
87
+ `);
88
+ expect(symbols[0]?.signature).toBe('noReturn(x: number)');
89
+ });
90
+ it('does not extract a non-exported function even when tagged @util', () => {
91
+ const symbols = extract(`
92
+ /** @util */
93
+ function internalHelper(x: number): number {
94
+ return x;
95
+ }
96
+ `);
97
+ expect(symbols).toEqual([]);
98
+ });
99
+ it('does not extract a const whose initializer is not a function', () => {
100
+ const symbols = extract(`
101
+ /** @util */
102
+ export const notAFunction = 42;
103
+ `);
104
+ expect(symbols).toEqual([]);
105
+ });
106
+ it('does not throw on truncated/malformed source', () => {
107
+ expect(() => extract(`export function broken(`)).not.toThrow();
108
+ expect(() => extract(`/** @util */\nexport const x = (`)).not.toThrow();
109
+ });
110
+ });
111
+ //# sourceMappingURL=extractUtil.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extractUtil.test.js","sourceRoot":"","sources":["../../src/codeIndex/extractUtil.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /** Inputs for {@link importPathOf}. */
2
+ export interface ImportPathOfOptions {
3
+ /** Owning workspace package name, e.g. '@acme/payments'. */
4
+ packageName: string;
5
+ /** Absolute path to the package root (the dir containing its package.json). */
6
+ packageDir: string;
7
+ /** Absolute path to the source file inside the package. */
8
+ filePath: string;
9
+ }
10
+ /**
11
+ * Produces the deep import specifier a consumer would write for a source file:
12
+ * `<packageName>/<path-under-src>.js`. A leading `src/` segment is stripped (packages
13
+ * export from their compiled `dist` mirror of `src`), `.ts`/`.tsx` becomes `.js` to match
14
+ * the emitted module, and `.vue` is left as-is. Path separators are normalized to `/`
15
+ * so the result is valid regardless of the host OS.
16
+ * @__NO_SIDE_EFFECTS__
17
+ */
18
+ export declare function importPathOf(options: ImportPathOfOptions): string;
@@ -0,0 +1,17 @@
1
+ import { relative, sep } from 'node:path';
2
+ /**
3
+ * Produces the deep import specifier a consumer would write for a source file:
4
+ * `<packageName>/<path-under-src>.js`. A leading `src/` segment is stripped (packages
5
+ * export from their compiled `dist` mirror of `src`), `.ts`/`.tsx` becomes `.js` to match
6
+ * the emitted module, and `.vue` is left as-is. Path separators are normalized to `/`
7
+ * so the result is valid regardless of the host OS.
8
+ * @__NO_SIDE_EFFECTS__
9
+ */
10
+ export function importPathOf(options) {
11
+ const { packageName, packageDir, filePath } = options;
12
+ const rel = relative(packageDir, filePath).split(sep).join('/');
13
+ const withoutSrc = rel.startsWith('src/') ? rel.slice('src/'.length) : rel;
14
+ const withJsExt = withoutSrc.replace(/\.tsx?$/, '.js');
15
+ return `${packageName}/${withJsExt}`;
16
+ }
17
+ //# sourceMappingURL=importPathOf.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"importPathOf.js","sourceRoot":"","sources":["../../src/codeIndex/importPathOf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAY1C;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B;IACrD,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAEtD,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3E,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAEvD,OAAO,GAAG,WAAW,IAAI,SAAS,EAAE,CAAC;AACzC,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,40 @@
1
+ import { describe, expect, it } from 'bun:test';
2
+ import { importPathOf } from './importPathOf.js';
3
+ describe('importPathOf', () => {
4
+ it('strips a leading src/ and turns .ts into .js', () => {
5
+ expect(importPathOf({
6
+ packageName: '@acme/payments',
7
+ packageDir: '/repo/packages/payments',
8
+ filePath: '/repo/packages/payments/src/PaymentClient.ts',
9
+ })).toBe('@acme/payments/PaymentClient.js');
10
+ });
11
+ it('turns .tsx into .js', () => {
12
+ expect(importPathOf({
13
+ packageName: '@acme/ui',
14
+ packageDir: '/repo/packages/ui',
15
+ filePath: '/repo/packages/ui/src/Button.tsx',
16
+ })).toBe('@acme/ui/Button.js');
17
+ });
18
+ it('preserves a .vue extension', () => {
19
+ expect(importPathOf({
20
+ packageName: '@acme/ui',
21
+ packageDir: '/repo/packages/ui',
22
+ filePath: '/repo/packages/ui/src/Button.vue',
23
+ })).toBe('@acme/ui/Button.vue');
24
+ });
25
+ it('keeps nested paths under src', () => {
26
+ expect(importPathOf({
27
+ packageName: '@acme/backend',
28
+ packageDir: '/repo/packages/backend',
29
+ filePath: '/repo/packages/backend/src/chat/ChatStartCommand.ts',
30
+ })).toBe('@acme/backend/chat/ChatStartCommand.js');
31
+ });
32
+ it('leaves a path without a leading src/ untouched', () => {
33
+ expect(importPathOf({
34
+ packageName: '@acme/backend',
35
+ packageDir: '/repo/packages/backend',
36
+ filePath: '/repo/packages/backend/chat/Loose.ts',
37
+ })).toBe('@acme/backend/chat/Loose.js');
38
+ });
39
+ });
40
+ //# sourceMappingURL=importPathOf.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"importPathOf.test.js","sourceRoot":"","sources":["../../src/codeIndex/importPathOf.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,MAAM,CACF,YAAY,CAAC;YACT,WAAW,EAAE,gBAAgB;YAC7B,UAAU,EAAE,yBAAyB;YACrC,QAAQ,EAAE,8CAA8C;SAC3D,CAAC,CACL,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC3B,MAAM,CACF,YAAY,CAAC;YACT,WAAW,EAAE,UAAU;YACvB,UAAU,EAAE,mBAAmB;YAC/B,QAAQ,EAAE,kCAAkC;SAC/C,CAAC,CACL,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAClC,MAAM,CACF,YAAY,CAAC;YACT,WAAW,EAAE,UAAU;YACvB,UAAU,EAAE,mBAAmB;YAC/B,QAAQ,EAAE,kCAAkC;SAC/C,CAAC,CACL,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACpC,MAAM,CACF,YAAY,CAAC;YACT,WAAW,EAAE,eAAe;YAC5B,UAAU,EAAE,wBAAwB;YACpC,QAAQ,EAAE,qDAAqD;SAClE,CAAC,CACL,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACtD,MAAM,CACF,YAAY,CAAC;YACT,WAAW,EAAE,eAAe;YAC5B,UAAU,EAAE,wBAAwB;YACpC,QAAQ,EAAE,sCAAsC;SACnD,CAAC,CACL,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}
@@ -0,0 +1,9 @@
1
+ import * as ts from 'typescript';
2
+ /**
3
+ * Extracts a one-line summary from a node's leading JSDoc comment, for rendering into
4
+ * generated index files. Multi-line summaries are joined and internal whitespace is
5
+ * collapsed; the summary is the text before the first `@tag`, so a JSDoc carrying only
6
+ * `@param`/`@returns` (no free-text summary) yields null, same as no JSDoc at all.
7
+ * @__NO_SIDE_EFFECTS__
8
+ */
9
+ export declare function jsdocSummary(node: ts.Node): string | null;
@@ -0,0 +1,18 @@
1
+ import * as ts from 'typescript';
2
+ /**
3
+ * Extracts a one-line summary from a node's leading JSDoc comment, for rendering into
4
+ * generated index files. Multi-line summaries are joined and internal whitespace is
5
+ * collapsed; the summary is the text before the first `@tag`, so a JSDoc carrying only
6
+ * `@param`/`@returns` (no free-text summary) yields null, same as no JSDoc at all.
7
+ * @__NO_SIDE_EFFECTS__
8
+ */
9
+ export function jsdocSummary(node) {
10
+ const jsDoc = ts.getJSDocCommentsAndTags(node).find((tag) => ts.isJSDoc(tag));
11
+ const text = jsDoc && ts.getTextOfJSDocComment(jsDoc.comment);
12
+ if (!text) {
13
+ return null;
14
+ }
15
+ const collapsed = text.replace(/\s+/g, ' ').trim();
16
+ return collapsed || null;
17
+ }
18
+ //# sourceMappingURL=jsdocSummary.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jsdocSummary.js","sourceRoot":"","sources":["../../src/codeIndex/jsdocSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa;IACtC,MAAM,KAAK,GAAG,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAmB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/F,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,OAAO,SAAS,IAAI,IAAI,CAAC;AAC7B,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,33 @@
1
+ import { expect, test } from 'bun:test';
2
+ import * as ts from 'typescript';
3
+ import { jsdocSummary } from './jsdocSummary.js';
4
+ /** Parses a single-statement source snippet and returns its first statement node. */
5
+ function firstStatement(src) {
6
+ const sourceFile = ts.createSourceFile('x.ts', src, ts.ScriptTarget.Latest, true);
7
+ return sourceFile.statements[0];
8
+ }
9
+ test('collapses a multi-line JSDoc summary into a single line', () => {
10
+ const node = firstStatement(`
11
+ /**
12
+ * Formats a date
13
+ * relative to now.
14
+ */
15
+ export function formatRelativeDate() {}
16
+ `);
17
+ expect(jsdocSummary(node)).toBe('Formats a date relative to now.');
18
+ });
19
+ test('returns null for a node with no JSDoc', () => {
20
+ const node = firstStatement(`export function formatRelativeDate() {}`);
21
+ expect(jsdocSummary(node)).toBeNull();
22
+ });
23
+ test('returns null for a JSDoc with only @param/@returns and no summary text', () => {
24
+ const node = firstStatement(`
25
+ /**
26
+ * @param date the date to format
27
+ * @returns the formatted string
28
+ */
29
+ export function formatRelativeDate(date: Date) {}
30
+ `);
31
+ expect(jsdocSummary(node)).toBeNull();
32
+ });
33
+ //# sourceMappingURL=jsdocSummary.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jsdocSummary.test.js","sourceRoot":"","sources":["../../src/codeIndex/jsdocSummary.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,qFAAqF;AACrF,SAAS,cAAc,CAAC,GAAW;IAC/B,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAClF,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;AACrC,CAAC;AAED,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACjE,MAAM,IAAI,GAAG,cAAc,CAAC;;;;;;KAM3B,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;AACvE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;IAC/C,MAAM,IAAI,GAAG,cAAc,CAAC,yCAAyC,CAAC,CAAC;IAEvE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wEAAwE,EAAE,GAAG,EAAE;IAChF,MAAM,IAAI,GAAG,cAAc,CAAC;;;;;;KAM3B,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC1C,CAAC,CAAC,CAAC"}
@@ -0,0 +1,27 @@
1
+ import type { Package } from '@nzyme/project-utils/getPackages.js';
2
+ import type { IndexSettings } from './IndexSettings.js';
3
+ import type { IndexSymbol } from './IndexSymbol.js';
4
+ /** Inputs for {@link renderMarkdown}. */
5
+ export interface RenderMarkdownOptions {
6
+ /** Repo root — file paths in the returned map are absolute, rooted here. */
7
+ root: string;
8
+ /** All workspace packages (from `getPackages`); rendered sorted by name regardless of input order. */
9
+ packages: readonly Package[];
10
+ /** All collected symbols; grouped/sorted by section then export name regardless of input order. */
11
+ symbols: readonly IndexSymbol[];
12
+ /** The settings the symbols were collected with — sections, labels and the `UTILS.md` packages. */
13
+ settings: IndexSettings;
14
+ }
15
+ /**
16
+ * Renders every collected symbol into a fixed set of deterministic Markdown files: a root
17
+ * `INDEX.md` (package hub), a root `UTILS.md` (curated global subset of `@util` helpers from the
18
+ * configured foundational packages — omitted when none are configured), and one `INDEX.md` per
19
+ * package that has at least one symbol of any kind (including `util` — every package's own `@util`
20
+ * helpers render in its `INDEX.md` Utils section regardless of whether the package is
21
+ * foundational). Pure — same inputs always produce a byte-identical result regardless of
22
+ * `packages`/`symbols` input order, since every list is sorted before rendering (never relies on
23
+ * Map/object iteration of unsorted data, never reads the clock or filesystem).
24
+ * @returns Absolute file path → file contents, ready to be written as-is.
25
+ * @__NO_SIDE_EFFECTS__
26
+ */
27
+ export declare function renderMarkdown(options: RenderMarkdownOptions): Map<string, string>;
@@ -0,0 +1,171 @@
1
+ import { join, relative } from 'node:path';
2
+ import { groupByToMap } from '@nzyme/utils/array/groupByToMap.js';
3
+ import { EXTRA_SECTIONS } from './IndexSettings.js';
4
+ /** First line of every generated file — marks it as generated and gitignore-able. */
5
+ const HEADER = '<!-- AUTOGENERATED by `bun index` — do not edit. Run `bun index` to regenerate. -->';
6
+ /**
7
+ * Renders every collected symbol into a fixed set of deterministic Markdown files: a root
8
+ * `INDEX.md` (package hub), a root `UTILS.md` (curated global subset of `@util` helpers from the
9
+ * configured foundational packages — omitted when none are configured), and one `INDEX.md` per
10
+ * package that has at least one symbol of any kind (including `util` — every package's own `@util`
11
+ * helpers render in its `INDEX.md` Utils section regardless of whether the package is
12
+ * foundational). Pure — same inputs always produce a byte-identical result regardless of
13
+ * `packages`/`symbols` input order, since every list is sorted before rendering (never relies on
14
+ * Map/object iteration of unsorted data, never reads the clock or filesystem).
15
+ * @returns Absolute file path → file contents, ready to be written as-is.
16
+ * @__NO_SIDE_EFFECTS__
17
+ */
18
+ export function renderMarkdown(options) {
19
+ const { root, packages, symbols, settings } = options;
20
+ const sections = getSections(settings);
21
+ const hasUtilsFile = settings.globalUtilPackages.size > 0;
22
+ const sortedPackages = [];
23
+ for (const pkg of packages) {
24
+ if (pkg.packageJson.name) {
25
+ sortedPackages.push({ name: pkg.packageJson.name, pkg });
26
+ }
27
+ }
28
+ sortedPackages.sort((a, b) => a.name.localeCompare(b.name));
29
+ const symbolsByPackage = groupByToMap(symbols, symbol => symbol.packageName);
30
+ const files = new Map([[join(root, 'INDEX.md'), renderRootIndex()]]);
31
+ if (hasUtilsFile) {
32
+ files.set(join(root, 'UTILS.md'), renderUtils());
33
+ }
34
+ for (const { name, pkg } of sortedPackages) {
35
+ const packageSymbols = symbolsByPackage.get(name);
36
+ if (packageSymbols) {
37
+ files.set(join(pkg.path, 'INDEX.md'), renderPackageIndex(name, pkg, packageSymbols));
38
+ }
39
+ }
40
+ return files;
41
+ /** Renders the root `INDEX.md`: preamble + a sorted list of every named package. */
42
+ function renderRootIndex() {
43
+ const kinds = describeIndexedKinds(sections);
44
+ const preamble = hasUtilsFile
45
+ ? 'Two kinds of generated index live in this repo: each package has its own `INDEX.md` listing its' +
46
+ ` ${kinds} under section headers; the global [\`UTILS.md\`](./UTILS.md) lists the context-agnostic` +
47
+ ' subset of `@util` helpers from the foundational util packages — check both before writing a new' +
48
+ ' utility.'
49
+ : `Each package with indexed symbols has its own \`INDEX.md\` listing its ${kinds} under section` +
50
+ ' headers — check them before writing a new utility.';
51
+ const lines = [HEADER, '', '# Project Index', '', preamble, '', '## Packages', ''];
52
+ for (const { name, pkg } of sortedPackages) {
53
+ const packagePath = toPosixPath(relative(root, pkg.path));
54
+ const description = pkg.packageJson.description || '_(no description)_';
55
+ const link = symbolsByPackage.has(name)
56
+ ? ` — [INDEX.md](./${toPosixPath(relative(root, join(pkg.path, 'INDEX.md')))})`
57
+ : '';
58
+ lines.push(`- **${name}** (\`${packagePath}\`): ${description}${link}`);
59
+ }
60
+ lines.push('');
61
+ if (hasUtilsFile) {
62
+ lines.push('See [`UTILS.md`](./UTILS.md) for reusable helpers.', '');
63
+ }
64
+ return lines.join('\n');
65
+ }
66
+ /**
67
+ * Renders the root `UTILS.md`: `util` symbols from the configured foundational packages only,
68
+ * grouped by package and sorted within each group. Every package's own `@util` helpers
69
+ * (foundational or not) also render in that package's `INDEX.md` Utils section via {@link renderUtilRow}.
70
+ */
71
+ function renderUtils() {
72
+ const utilSymbols = symbols.filter(symbol => symbol.kind === 'util' && settings.globalUtilPackages.has(symbol.packageName));
73
+ const groups = groupByToMap(utilSymbols, symbol => symbol.packageName);
74
+ const packageNames = [...groups.keys()].toSorted((a, b) => a.localeCompare(b));
75
+ const lines = [
76
+ HEADER,
77
+ '',
78
+ '# Utilities',
79
+ '',
80
+ 'Context-agnostic helpers from the foundational util packages, reusable across the whole repo — ' +
81
+ 'reuse before writing your own. Every package additionally lists its own `@util` helpers under ' +
82
+ "a Utils section in that package's `INDEX.md`.",
83
+ '',
84
+ ];
85
+ for (const packageName of packageNames) {
86
+ lines.push(`## ${packageName}`, '');
87
+ const rows = (groups.get(packageName) ?? []).toSorted(compareSymbols);
88
+ for (const row of rows) {
89
+ lines.push(renderUtilRow(row));
90
+ }
91
+ lines.push('');
92
+ }
93
+ return lines.join('\n');
94
+ }
95
+ /** Renders one package's `INDEX.md`: header + fixed-order sections, each with sorted rows. */
96
+ function renderPackageIndex(packageName, pkg, packageSymbols) {
97
+ const packagePath = toPosixPath(relative(root, pkg.path));
98
+ const description = pkg.packageJson.description || '_(no description)_';
99
+ const lines = [HEADER, '', `# ${packageName}`, '', description, '', `Path: \`${packagePath}\``, ''];
100
+ const byKind = groupByToMap(packageSymbols, symbol => symbol.kind);
101
+ const kinds = [...byKind.keys()].toSorted((a, b) => (sections.get(a)?.order ?? 0) - (sections.get(b)?.order ?? 0));
102
+ for (const kind of kinds) {
103
+ const section = sections.get(kind);
104
+ const rows = (byKind.get(kind) ?? []).toSorted(compareSymbols);
105
+ lines.push(`## ${section?.section ?? kind}`, '');
106
+ for (const row of rows) {
107
+ lines.push(kind === 'util' ? renderUtilRow(row) : renderRow(row, section?.nameLabel ?? null));
108
+ }
109
+ lines.push('');
110
+ }
111
+ return lines.join('\n');
112
+ }
113
+ }
114
+ /**
115
+ * How every kind the settings produce renders, keyed by kind: the `defineX` kinds labelled by their
116
+ * name key, then components, entities (only when configured, labelled `table`) and utils — Utils last.
117
+ */
118
+ function getSections(settings) {
119
+ const sections = new Map();
120
+ for (const kind of settings.defineKinds) {
121
+ sections.set(kind.kind, { section: kind.section, order: kind.order, nameLabel: kind.nameKey });
122
+ }
123
+ sections.set('component', { ...EXTRA_SECTIONS.component, nameLabel: null });
124
+ if (settings.entities) {
125
+ sections.set('entity', { ...EXTRA_SECTIONS.entity, nameLabel: 'table' });
126
+ }
127
+ sections.set('util', { ...EXTRA_SECTIONS.util, nameLabel: null });
128
+ return sections;
129
+ }
130
+ /** Lists the sections a package `INDEX.md` can have, in order, e.g. "services, commands, and `@util` helpers". */
131
+ function describeIndexedKinds(sections) {
132
+ const names = [];
133
+ for (const [kind, info] of [...sections].toSorted(([, a], [, b]) => a.order - b.order)) {
134
+ names.push(kind === 'util' ? '`@util` helpers' : info.section.toLowerCase());
135
+ }
136
+ const last = names.pop();
137
+ return names.length > 0 ? `${names.join(', ')}, and ${last}` : String(last);
138
+ }
139
+ /** Renders a single symbol as one Markdown list row: bold export name, importPath, label, description. */
140
+ function renderRow(row, nameLabel) {
141
+ const parts = [`**${row.exportName}**`, `\`${row.importPath}\``];
142
+ if (nameLabel && row.internalName) {
143
+ parts.push(`${nameLabel}: \`${row.internalName}\``);
144
+ }
145
+ if (row.description) {
146
+ parts.push(row.description);
147
+ }
148
+ return `- ${parts.join(' — ')}`;
149
+ }
150
+ /**
151
+ * Renders a `util`-kind symbol as one signature-first Markdown list row — shared by the global
152
+ * `UTILS.md` and every package's own `INDEX.md` Utils section, so a helper reads identically in both.
153
+ */
154
+ function renderUtilRow(row) {
155
+ const signature = row.signature ? `\`${row.signature}\`` : `**${row.exportName}**`;
156
+ const description = row.description ? ` — ${row.description}` : '';
157
+ return `- ${signature}${description} (\`${row.importPath}\`)`;
158
+ }
159
+ /**
160
+ * Orders rows by export name, then import path — the tie-break matters for same-named variants
161
+ * (`randomInt` in `.node.ts` and `.browser.ts`), which would otherwise keep their discovery order,
162
+ * and discovery runs concurrently.
163
+ */
164
+ function compareSymbols(a, b) {
165
+ return a.exportName.localeCompare(b.exportName) || a.importPath.localeCompare(b.importPath);
166
+ }
167
+ /** Normalizes a path to forward slashes so generated Markdown links are OS-independent. */
168
+ function toPosixPath(path) {
169
+ return path.replaceAll('\\', '/');
170
+ }
171
+ //# sourceMappingURL=renderMarkdown.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"renderMarkdown.js","sourceRoot":"","sources":["../../src/codeIndex/renderMarkdown.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};