@node-cli/comments 0.1.0 → 0.2.1

package/dist/__tests__/glob.test.js

@@ -2,21 +2,29 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
-import { augmentPatterns, expandGlobs } from "../glob.js";
+import { expandGlobs } from "../glob.js";
 import { parseAndTransformComments } from "../lib.js";
 describe("glob utilities & additional lib branches", function() {
-    it("augmentPatterns adds deep variant only when needed", function() {
-        var input = [
-            "/tmp/dir/*.ts",
-            "/tmp/dir/**/a.ts",
-            "/tmp/file.txt"
-        ]; // second already deep, third no wildcard folder/file split
-        var out = augmentPatterns(input);
-        // Should add one deep variant for first pattern
-        var additions = out.filter(function(p) {
-            return p.includes("**/*.ts");
-        });
-        expect(additions.length).toBe(1);
+    it("explicit globstar required for deep matches (no implicit augmentation)", function() {
+        // create temp structure.
+        var root = fs.mkdtempSync(path.join(os.tmpdir(), "comments-glob-simplify-"));
+        fs.mkdirSync(path.join(root, "nested"));
+        var a = path.join(root, "a.ts");
+        var b = path.join(root, "nested", "b.ts");
+        fs.writeFileSync(a, "// a", "utf8");
+        fs.writeFileSync(b, "// b", "utf8");
+        var shallow = expandGlobs([
+            "".concat(root, "/*.ts")
+        ]);
+        expect(shallow).toContain(a);
+        expect(shallow).not.toContain(b); // no implicit deep variant
+        var deep = expandGlobs([
+            "".concat(root, "/**/*.ts")
+        ]);
+        expect(deep).toEqual(expect.arrayContaining([
+            a,
+            b
+        ]));
     });
     it("expandGlobs matches literals and wildcards including ?", function() {
         var root = fs.mkdtempSync(path.join(os.tmpdir(), "comments-glob2-"));
@@ -92,7 +100,7 @@ describe("glob utilities & additional lib branches", function() {
         var root = fs.mkdtempSync(path.join(os.tmpdir(), "comments-glob-lit-"));
         var file = path.join(root, "only.ts");
         fs.writeFileSync(file, "// only", "utf8");
-        // duplicate patterns plus a nonexistent literal
+        // duplicate patterns plus a nonexistent literal.
         var patterns = [
             file,
             file,
@@ -120,14 +128,14 @@ describe("glob utilities & additional lib branches", function() {
             wrapLineComments: true,
             mergeLineComments: false
         }).transformed;
-        // At least one blank line (line with only '*') preserved around fence
+        // At least one blank line (line with only '*') preserved around fence.
         var starBlankCount = out.split(/\n/).filter(function(l) {
             return /^\s*\*\s*$/.test(l);
         }).length;
         expect(starBlankCount).toBeGreaterThanOrEqual(1);
-        // Fenced code block retained
+        // Fenced code block retained.
         expect(out).toContain("```sh");
-        // Second paragraph ended with period added
+        // Second paragraph ended with period added.
         expect(/Second paragraph without period\./.test(out)).toBe(true);
     });
 });

package/dist/__tests__/glob.test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/__tests__/glob.test.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { describe, expect, it } from \"vitest\";\nimport { augmentPatterns, expandGlobs } from \"../glob.js\";\nimport { parseAndTransformComments } from \"../lib.js\";\n\ndescribe(\"glob utilities & additional lib branches\", () => {\n\tit(\"augmentPatterns adds deep variant only when needed\", () => {\n\t\tconst input = [\"/tmp/dir/*.ts\", \"/tmp/dir/**/a.ts\", \"/tmp/file.txt\"]; // second already deep, third no wildcard folder/file split\n\t\tconst out = augmentPatterns(input);\n\t\t// Should add one deep variant for first pattern\n\t\tconst additions = out.filter((p) => p.includes(\"**/*.ts\"));\n\t\texpect(additions.length).toBe(1);\n\t});\n\n\tit(\"expandGlobs matches literals and wildcards including ?\", () => {\n\t\tconst root = fs.mkdtempSync(path.join(os.tmpdir(), \"comments-glob2-\"));\n\t\tconst files = [\"a.ts\", \"ab.ts\", \"abc.ts\", \"note.md\"]; // to test ? wildcard and *\n\t\tfor (const f of files) {\n\t\t\tfs.writeFileSync(path.join(root, f), \"// x\", \"utf8\");\n\t\t}\n\t\tconst patterns = [\n\t\t\tpath.join(root, \"a?.ts\"), // should match ab.ts only\n\t\t\tpath.join(root, \"a*.ts\"), // matches a.ts, ab.ts, abc.ts\n\t\t\tpath.join(root, \"note.md\"), // literal\n\t\t];\n\t\tconst expanded = expandGlobs(patterns)\n\t\t\t.map((p) => path.basename(p))\n\t\t\t.sort();\n\t\texpect(expanded).toEqual([\"a.ts\", \"ab.ts\", \"abc.ts\", \"note.md\"].sort());\n\t});\n\n\tit(\"expandGlobs handles symlinks when followSymlinks true\", () => {\n\t\tconst root = fs.mkdtempSync(path.join(os.tmpdir(), \"comments-glob-sym-\"));\n\t\tconst target = path.join(root, \"target.ts\");\n\t\tfs.writeFileSync(target, \"// target\", \"utf8\");\n\t\tconst link = path.join(root, \"link.ts\");\n\t\ttry {\n\t\t\tfs.symlinkSync(target, link);\n\t\t} catch {\n\t\t\t// Some file systems may not allow symlinks (CI on Windows); skip gracefully.\n\t\t\treturn;\n\t\t}\n\t\tconst pattern = path.join(root, \"*.ts\");\n\t\tconst noFollow = expandGlobs([pattern], { followSymlinks: false });\n\t\texpect(noFollow).toContain(target);\n\t\texpect(noFollow).not.toContain(link);\n\t\tconst withFollow = expandGlobs([pattern], { followSymlinks: true });\n\t\texpect(withFollow).toContain(target);\n\t\texpect(withFollow).toContain(link);\n\t});\n\n\tit(\"expandGlobs handles file literals, duplicate patterns and nonexistent paths\", () => {\n\t\tconst root = fs.mkdtempSync(path.join(os.tmpdir(), \"comments-glob-lit-\"));\n\t\tconst file = path.join(root, \"only.ts\");\n\t\tfs.writeFileSync(file, \"// only\", \"utf8\");\n\t\t// duplicate patterns plus a nonexistent literal\n\t\tconst patterns = [file, file, path.join(root, \"missing.ts\")];\n\t\tconst out = expandGlobs(patterns);\n\t\texpect(out).toEqual([file]); // only once\n\t});\n\n\tit(\"lib buildJsDoc preserves blank line separation and fences (edge branch)\", () => {\n\t\tconst input = [\n\t\t\t\"/**\",\n\t\t\t\" * First paragraph line\",\n\t\t\t\" *\",\n\t\t\t\" * ```sh\",\n\t\t\t\" * echo hi\",\n\t\t\t\" * ```\",\n\t\t\t\" *\",\n\t\t\t\" * Second paragraph without period\",\n\t\t\t\" */\",\n\t\t].join(\"\\n\");\n\t\tconst out = parseAndTransformComments(input, {\n\t\t\twidth: 60,\n\t\t\twrapLineComments: true,\n\t\t\tmergeLineComments: false,\n\t\t}).transformed;\n\t\t// At least one blank line (line with only '*') preserved around fence\n\t\tconst starBlankCount = out\n\t\t\t.split(/\\n/)\n\t\t\t.filter((l) => /^\\s*\\*\\s*$/.test(l)).length;\n\t\texpect(starBlankCount).toBeGreaterThanOrEqual(1);\n\t\t// Fenced code block retained\n\t\texpect(out).toContain(\"```sh\");\n\t\t// Second paragraph ended with period added\n\t\texpect(/Second paragraph without period\\./.test(out)).toBe(true);\n\t});\n});\n"],"names":["fs","os","path","describe","expect","it","augmentPatterns","expandGlobs","parseAndTransformComments","input","out","additions","filter","p","includes","length","toBe","root","mkdtempSync","join","tmpdir","files","f","writeFileSync","patterns","expanded","map","basename","sort","toEqual","target","link","symlinkSync","pattern","noFollow","followSymlinks","toContain","not","withFollow","file","width","wrapLineComments","mergeLineComments","transformed","starBlankCount","split","l","test","toBeGreaterThanOrEqual"],"mappings":"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"}
+{"version":3,"sources":["../../src/__tests__/glob.test.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { describe, expect, it } from \"vitest\";\nimport { expandGlobs } from \"../glob.js\";\nimport { parseAndTransformComments } from \"../lib.js\";\n\ndescribe(\"glob utilities & additional lib branches\", () => {\n\tit(\"explicit globstar required for deep matches (no implicit augmentation)\", () => {\n\t\t// create temp structure.\n\t\tconst root = fs.mkdtempSync(\n\t\t\tpath.join(os.tmpdir(), \"comments-glob-simplify-\"),\n\t\t);\n\t\tfs.mkdirSync(path.join(root, \"nested\"));\n\t\tconst a = path.join(root, \"a.ts\");\n\t\tconst b = path.join(root, \"nested\", \"b.ts\");\n\t\tfs.writeFileSync(a, \"// a\", \"utf8\");\n\t\tfs.writeFileSync(b, \"// b\", \"utf8\");\n\t\tconst shallow = expandGlobs([`${root}/*.ts`]);\n\t\texpect(shallow).toContain(a);\n\t\texpect(shallow).not.toContain(b); // no implicit deep variant\n\t\tconst deep = expandGlobs([`${root}/**/*.ts`]);\n\t\texpect(deep).toEqual(expect.arrayContaining([a, b]));\n\t});\n\n\tit(\"expandGlobs matches literals and wildcards including ?\", () => {\n\t\tconst root = fs.mkdtempSync(path.join(os.tmpdir(), \"comments-glob2-\"));\n\t\tconst files = [\"a.ts\", \"ab.ts\", \"abc.ts\", \"note.md\"]; // to test ? wildcard and *\n\t\tfor (const f of files) {\n\t\t\tfs.writeFileSync(path.join(root, f), \"// x\", \"utf8\");\n\t\t}\n\t\tconst patterns = [\n\t\t\tpath.join(root, \"a?.ts\"), // should match ab.ts only\n\t\t\tpath.join(root, \"a*.ts\"), // matches a.ts, ab.ts, abc.ts\n\t\t\tpath.join(root, \"note.md\"), // literal\n\t\t];\n\t\tconst expanded = expandGlobs(patterns)\n\t\t\t.map((p) => path.basename(p))\n\t\t\t.sort();\n\t\texpect(expanded).toEqual([\"a.ts\", \"ab.ts\", \"abc.ts\", \"note.md\"].sort());\n\t});\n\n\tit(\"expandGlobs handles symlinks when followSymlinks true\", () => {\n\t\tconst root = fs.mkdtempSync(path.join(os.tmpdir(), \"comments-glob-sym-\"));\n\t\tconst target = path.join(root, \"target.ts\");\n\t\tfs.writeFileSync(target, \"// target\", \"utf8\");\n\t\tconst link = path.join(root, \"link.ts\");\n\t\ttry {\n\t\t\tfs.symlinkSync(target, link);\n\t\t} catch {\n\t\t\t// Some file systems may not allow symlinks (CI on Windows); skip gracefully.\n\t\t\treturn;\n\t\t}\n\t\tconst pattern = path.join(root, \"*.ts\");\n\t\tconst noFollow = expandGlobs([pattern], { followSymlinks: false });\n\t\texpect(noFollow).toContain(target);\n\t\texpect(noFollow).not.toContain(link);\n\t\tconst withFollow = expandGlobs([pattern], { followSymlinks: true });\n\t\texpect(withFollow).toContain(target);\n\t\texpect(withFollow).toContain(link);\n\t});\n\n\tit(\"expandGlobs handles file literals, duplicate patterns and nonexistent paths\", () => {\n\t\tconst root = fs.mkdtempSync(path.join(os.tmpdir(), \"comments-glob-lit-\"));\n\t\tconst file = path.join(root, \"only.ts\");\n\t\tfs.writeFileSync(file, \"// only\", \"utf8\");\n\t\t// duplicate patterns plus a nonexistent literal.\n\t\tconst patterns = [file, file, path.join(root, \"missing.ts\")];\n\t\tconst out = expandGlobs(patterns);\n\t\texpect(out).toEqual([file]); // only once\n\t});\n\n\tit(\"lib buildJsDoc preserves blank line separation and fences (edge branch)\", () => {\n\t\tconst input = [\n\t\t\t\"/**\",\n\t\t\t\" * First paragraph line\",\n\t\t\t\" *\",\n\t\t\t\" * ```sh\",\n\t\t\t\" * echo hi\",\n\t\t\t\" * ```\",\n\t\t\t\" *\",\n\t\t\t\" * Second paragraph without period\",\n\t\t\t\" */\",\n\t\t].join(\"\\n\");\n\t\tconst out = parseAndTransformComments(input, {\n\t\t\twidth: 60,\n\t\t\twrapLineComments: true,\n\t\t\tmergeLineComments: false,\n\t\t}).transformed;\n\t\t// At least one blank line (line with only '*') preserved around fence.\n\t\tconst starBlankCount = out\n\t\t\t.split(/\\n/)\n\t\t\t.filter((l) => /^\\s*\\*\\s*$/.test(l)).length;\n\t\texpect(starBlankCount).toBeGreaterThanOrEqual(1);\n\t\t// Fenced code block retained.\n\t\texpect(out).toContain(\"```sh\");\n\t\t// Second paragraph ended with period added.\n\t\texpect(/Second paragraph without period\\./.test(out)).toBe(true);\n\t});\n});\n"],"names":["fs","os","path","describe","expect","it","expandGlobs","parseAndTransformComments","root","mkdtempSync","join","tmpdir","mkdirSync","a","b","writeFileSync","shallow","toContain","not","deep","toEqual","arrayContaining","files","f","patterns","expanded","map","p","basename","sort","target","link","symlinkSync","pattern","noFollow","followSymlinks","withFollow","file","out","input","width","wrapLineComments","mergeLineComments","transformed","starBlankCount","split","filter","l","test","length","toBeGreaterThanOrEqual","toBe"],"mappings":"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"}

package/dist/__tests__/lib.test.js

@@ -54,7 +54,7 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
-import { augmentPatterns, expandGlobs } from "../glob.js";
+import { expandGlobs } from "../glob.js";
 import { diffLines, parseAndTransformComments } from "../lib.js";
 var baseOpts = {
     width: 60,
@@ -99,7 +99,7 @@ describe("parseAndTransformComments", function() {
         var input = "/**\n * Before\n * ```js\n * const  x=  1;   \n * ```\n * After\n */";
         var res = parseAndTransformComments(input, baseOpts).transformed;
         expect(/```js/.test(res)).toBe(true);
-        // ensure spacing inside fence not normalized
+        // ensure spacing inside fence not normalized.
         expect(/const {2}x= {2}1;/.test(res)).toBe(true);
     });
     it("does not merge directive or license groups", function() {
@@ -114,13 +114,13 @@ describe("parseAndTransformComments", function() {
             mergeLineComments: true
         }));
         expect(/eslint-disable/.test(res.transformed)).toBe(true);
-        // Should not have merged into a jsdoc (no /** directly before const)
+        // Should not have merged into a jsdoc (no /** directly before const).
         expect(/\/\*\*/.test(res.transformed)).toBe(false);
     });
     it("list items are not reflowed into a paragraph", function() {
         var input = "/**\n * First line explaining.\n * - item one more words here\n * - item two\n */";
         var res = parseAndTransformComments(input, baseOpts).transformed;
-        // each list item remains on its own line with leading dash
+        // each list item remains on its own line with leading dash.
         var lines = res.split(/\n/).filter(function(l) {
             return /- item/.test(l);
         });
@@ -144,21 +144,23 @@ describe("parseAndTransformComments", function() {
             " */"
         ].join("\n");
         var out = parseAndTransformComments(input, baseOpts).transformed;
-        // Heading preserved, not merged into previous paragraph
+        // Heading preserved, not merged into previous paragraph.
         expect(out).toMatch(/Overview:/);
-        // Visually indented code line kept as-is (no extra wrapping collapse)
+        // Visually indented code line kept as-is (no extra wrapping collapse).
         expect(out).toMatch(/const\s{3}x = 1;/);
-        // Ensure final blank line before closing preserved (one line ending with ' *')
-        var trailingBlank = /\n \*\n\*\/$/.test(out.replace(/\r/g, ""));
-        expect(trailingBlank).toBe(true);
-        // Numeric list lines preserved
+        /**
+		 * Trailing blank before closing is optional after recent trimming change. (we
+		 * only keep it when multiple paragraphs exist). Assert closing exists.
+		 * Closing delimiter should be on its own line; allow optional leading
+		 * space(s).
+		 */ expect(/\n\s*\*\/$/.test(out)).toBe(true);
+        // Numeric list lines preserved.
         expect(out).toMatch(/1\. first/);
         expect(out).toMatch(/2\. second/);
-        // Trailing paragraph got terminal period
+        // Trailing paragraph got terminal period.
         expect(out).toMatch(/Another paragraph without period\./);
     });
-    it("glob expansion matches created files", function() {
-        // Create a truly temporary isolated directory outside source tree
+    it("glob expansion matches deep files only with explicit globstar", function() {
         var tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "comments-glob-"));
         var a = path.join(tmpRoot, "a.ts");
         var nestedDir = path.join(tmpRoot, "nested");
@@ -168,21 +170,26 @@ describe("parseAndTransformComments", function() {
         var b = path.join(nestedDir, "b.ts");
         fs.writeFileSync(a, "// file a", "utf8");
         fs.writeFileSync(b, "// file b", "utf8");
-        var patterns = [
+        // Shallow pattern should only see top-level a.ts.
+        var shallow = expandGlobs([
             "".concat(tmpRoot, "/*.ts")
-        ];
-        var augmented = augmentPatterns(patterns);
-        expect(augmented.some(function(p) {
-            return p.includes("**/*.ts");
-        })).toBe(true);
-        var expanded = expandGlobs(patterns);
-        expect(expanded.sort()).toEqual([
+        ]).sort();
+        expect(shallow).toEqual([
+            a
+        ]);
+        // Deep pattern matches both.
+        var deep = expandGlobs([
+            "".concat(tmpRoot, "/**/*.ts")
+        ]).sort();
+        expect(deep).toEqual([
             a,
             b
         ].sort());
     });
-    // Added test for preserving multi-line // comment groups that should NOT merge when preceded by code.
-    it("does not merge an inline explanatory multi-line // comment group following code", function() {
+    /**
+	 * Added test for preserving multi-line // comment groups that should NOT merge
+	 * when preceded by code.
+	 */ it("does not merge an inline explanatory multi-line // comment group following code", function() {
         var src = [
             "function demo() {",
             "  const x = 1; // keep",
@@ -229,19 +236,93 @@ describe("parseAndTransformComments", function() {
             wrapLineComments: true,
             mergeLineComments: true
         }).transformed;
-        // Should be converted to a JSDoc (first and last lines delimiters)
+        // Should be converted to a JSDoc (first and last lines delimiters).
         var lines = out.split(/\n/);
         expect(lines[0].trim()).toBe("/**");
         expect(lines[lines.length - 1].trim()).toBe("*/");
-        // Ensure representative internal lines are present (now without leading //)
+        // Ensure representative internal lines are present (now without leading //).
         expect(out).toContain("* JSDoc block extraction:");
         expect(out).toContain("* Pattern explanation:");
-        // Arrow lines preserved
+        // Arrow lines preserved.
         var arrowLineCount = lines.filter(function(l) {
             return /->/.test(l);
         }).length;
         expect(arrowLineCount).toBeGreaterThanOrEqual(5);
     });
+    it("does not insert period before list introduced by single lowercase word + colon", function() {
+        var input = [
+            "/**",
+            " * Some utilities have logging capabilities that needs to be",
+            " * tested a little bit differently:",
+            " * - mocking process.exit",
+            " * - console.log",
+            " * - inquirer.prompt",
+            " */"
+        ].join("\n");
+        var out = parseAndTransformComments(input, baseOpts).transformed;
+        // Ensure no stray period after 'be'.
+        expect(out).not.toMatch(/needs to be\./);
+        // Ensure list items unchanged.
+        expect(out).toMatch(/- mocking process\.exit/);
+    });
+    it("does not add stray period before lowercase colon line inside jsdoc", function() {
+        var input = [
+            "/**",
+            " * Some utilities have logging capabilities that needs to be",
+            " * tested a little bit differently:",
+            " * - one",
+            " * - two",
+            " */"
+        ].join("\n");
+        var out = parseAndTransformComments(input, baseOpts).transformed;
+        expect(out).not.toMatch(/needs to be\./);
+    });
+    it("does not append periods to every line of a merged // comment group", function() {
+        var original = [
+            "// We only want to add terminal punctuation once at the end of the merged",
+            "// paragraph, not after every original line (which can create spurious",
+            "// periods mid-sentence when lines were simple wraps). We also avoid",
+            "// appending a period if the final line ends with a colon introducing a",
+            "// list."
+        ].join("\n");
+        var out = parseAndTransformComments(original, {
+            width: 160,
+            wrapLineComments: true,
+            mergeLineComments: true
+        }).transformed;
+        // Ensure it became a JSDoc block.
+        expect(out.startsWith("/**")).toBe(true);
+        // Should not contain stray periods after former line breaks.
+        expect(out).not.toMatch(/merged\./);
+        expect(out).not.toMatch(/spurious\./);
+        expect(out).not.toMatch(/introducing a\./);
+        // Should still retain existing legitimate period after 'wraps).' and final
+        // 'list.'
+        expect(out).toMatch(/wraps\)\./);
+        expect(out).toMatch(/list\./);
+    });
+    it("merges a large explanatory // group after a statement into JSDoc", function() {
+        var src = [
+            "const value = compute();",
+            "// We only want to add terminal punctuation once at the end of the merged",
+            "// paragraph, not after every original line (which can create spurious",
+            "// periods mid-sentence when lines were simple wraps). We also avoid",
+            "// appending a period if the final line ends with a colon introducing a",
+            "// list.",
+            "function next() {}"
+        ].join("\n");
+        var out = parseAndTransformComments(src, {
+            width: 160,
+            wrapLineComments: true,
+            mergeLineComments: true
+        }).transformed;
+        // Expect merged into a JSDoc immediately after the statement.
+        var re = /compute\(\);\n\/\*\*[\s\S]*?\n\s*\*\//;
+        expect(re.test(out)).toBe(true);
+        // Ensure only one sentence-final period appended (present on final 'list.'
+        // already).
+        expect(out.match(/merged\./)).toBeNull();
+    });
 });
 
 //# sourceMappingURL=lib.test.js.map

package/dist/__tests__/lib.test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/__tests__/lib.test.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { describe, expect, it } from \"vitest\";\nimport { augmentPatterns, expandGlobs } from \"../glob.js\";\nimport { diffLines, parseAndTransformComments } from \"../lib.js\";\n\nconst baseOpts = {\n\twidth: 60,\n\twrapLineComments: true,\n\tmergeLineComments: false,\n};\n\ndescribe(\"parseAndTransformComments\", () => {\n\tit(\"reflows a simple jsdoc and adds period\", () => {\n\t\tconst input = \"/**\\n * This function does something\\n * important\\n */\";\n\t\tconst res = parseAndTransformComments(input, baseOpts);\n\t\texpect(res.transformed).toContain(\"does something important.\");\n\t});\n\n\tit(\"normalizes NOTE capitalization\", () => {\n\t\tconst input = \"/**\\n * note: edge case\\n */\";\n\t\tconst res = parseAndTransformComments(input, baseOpts);\n\t\texpect(/NOTE: edge case/.test(res.transformed)).toBe(true);\n\t});\n\n\tit(\"wraps single line comments\", () => {\n\t\tconst input =\n\t\t\t\"// this is a very long comment that should be wrapped across multiple lines to satisfy width\";\n\t\tconst res = parseAndTransformComments(input, baseOpts);\n\t\texpect(res.transformed.split(/\\n/).length).toBeGreaterThan(1);\n\t});\n\n\tit(\"merges groups of line comments into jsdoc\", () => {\n\t\tconst input = [\n\t\t\t\"// first line\",\n\t\t\t\"// second line\",\n\t\t\t\"// third line\",\n\t\t\t\"const x = 1;\",\n\t\t].join(\"\\n\");\n\t\tconst res = parseAndTransformComments(input, {\n\t\t\t...baseOpts,\n\t\t\tmergeLineComments: true,\n\t\t});\n\t\texpect(/\\/\\*\\*/.test(res.transformed)).toBe(true);\n\t});\n\n\tit(\"is idempotent (second pass unchanged)\", () => {\n\t\tconst input = \"/**\\n * Example doc that will be normalized\\n */\";\n\t\tconst first = parseAndTransformComments(input, baseOpts).transformed;\n\t\tconst second = parseAndTransformComments(first, baseOpts).transformed;\n\t\texpect(diffLines(first, second)).toBe(\"\");\n\t});\n\n\tit(\"preserves code fence blocks\", () => {\n\t\tconst input =\n\t\t\t\"/**\\n * Before\\n * ```js\\n * const  x=  1;   \\n * ```\\n * After\\n */\";\n\t\tconst res = parseAndTransformComments(input, baseOpts).transformed;\n\t\texpect(/```js/.test(res)).toBe(true);\n\t\t// ensure spacing inside fence not normalized\n\t\texpect(/const {2}x= {2}1;/.test(res)).toBe(true);\n\t});\n\n\tit(\"does not merge directive or license groups\", () => {\n\t\tconst input = [\n\t\t\t\"// eslint-disable-next-line\",\n\t\t\t\"// second line should prevent merge due to directive\",\n\t\t\t\"const y = 2;\",\n\t\t\t\"// Copyright 2024 Example\",\n\t\t\t\"// another line\",\n\t\t].join(\"\\n\");\n\t\tconst res = parseAndTransformComments(input, {\n\t\t\t...baseOpts,\n\t\t\tmergeLineComments: true,\n\t\t});\n\t\texpect(/eslint-disable/.test(res.transformed)).toBe(true);\n\t\t// Should not have merged into a jsdoc (no /** directly before const)\n\t\texpect(/\\/\\*\\*/.test(res.transformed)).toBe(false);\n\t});\n\n\tit(\"list items are not reflowed into a paragraph\", () => {\n\t\tconst input =\n\t\t\t\"/**\\n * First line explaining.\\n * - item one more words here\\n * - item two\\n */\";\n\t\tconst res = parseAndTransformComments(input, baseOpts).transformed;\n\t\t// each list item remains on its own line with leading dash\n\t\tconst lines = res.split(/\\n/).filter((l) => /- item/.test(l));\n\t\texpect(lines.length).toBe(2);\n\t});\n\n\tit(\"tag lines are preserved\", () => {\n\t\tconst input =\n\t\t\t\"/**\\n * short description\\n * @param x value\\n * @returns something\\n */\";\n\t\tconst res = parseAndTransformComments(input, baseOpts).transformed;\n\t\texpect(/@param x value/.test(res)).toBe(true);\n\t\texpect(/@returns something/.test(res)).toBe(true);\n\t});\n\n\tit(\"handles heading-like lines with colon and visually indented code & numeric lists\", () => {\n\t\tconst input = [\n\t\t\t\"/**\",\n\t\t\t\" * Overview:\",\n\t\t\t\" *   const   x = 1;\",\n\t\t\t\" * 1. first\",\n\t\t\t\" * 2. second\",\n\t\t\t\" *\", // blank separation\n\t\t\t\" * Another paragraph without period\",\n\t\t\t\" */\",\n\t\t].join(\"\\n\");\n\t\tconst out = parseAndTransformComments(input, baseOpts).transformed;\n\t\t// Heading preserved, not merged into previous paragraph\n\t\texpect(out).toMatch(/Overview:/);\n\t\t// Visually indented code line kept as-is (no extra wrapping collapse)\n\t\texpect(out).toMatch(/const\\s{3}x = 1;/);\n\t\t// Ensure final blank line before closing preserved (one line ending with ' *')\n\t\tconst trailingBlank = /\\n \\*\\n\\*\\/$/.test(out.replace(/\\r/g, \"\"));\n\t\texpect(trailingBlank).toBe(true);\n\t\t// Numeric list lines preserved\n\t\texpect(out).toMatch(/1\\. first/);\n\t\texpect(out).toMatch(/2\\. second/);\n\t\t// Trailing paragraph got terminal period\n\t\texpect(out).toMatch(/Another paragraph without period\\./);\n\t});\n\n\tit(\"glob expansion matches created files\", () => {\n\t\t// Create a truly temporary isolated directory outside source tree\n\t\tconst tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), \"comments-glob-\"));\n\t\tconst a = path.join(tmpRoot, \"a.ts\");\n\t\tconst nestedDir = path.join(tmpRoot, \"nested\");\n\t\tfs.mkdirSync(nestedDir, { recursive: true });\n\t\tconst b = path.join(nestedDir, \"b.ts\");\n\t\tfs.writeFileSync(a, \"// file a\", \"utf8\");\n\t\tfs.writeFileSync(b, \"// file b\", \"utf8\");\n\t\tconst patterns = [`${tmpRoot}/*.ts`];\n\t\tconst augmented = augmentPatterns(patterns);\n\t\texpect(augmented.some((p) => p.includes(\"**/*.ts\"))).toBe(true);\n\t\tconst expanded = expandGlobs(patterns);\n\t\texpect(expanded.sort()).toEqual([a, b].sort());\n\t});\n\n\t// Added test for preserving multi-line // comment groups that should NOT merge when preceded by code.\n\tit(\"does not merge an inline explanatory multi-line // comment group following code\", () => {\n\t\tconst src = [\n\t\t\t\"function demo() {\",\n\t\t\t\"  const x = 1; // keep\",\n\t\t\t\"  // first line explains next block\",\n\t\t\t\"  // still explaining\",\n\t\t\t\"  // final line\",\n\t\t\t\"  return x; // done\",\n\t\t\t\"}\",\n\t\t\t\"\",\n\t\t].join(\"\\n\");\n\t\tconst out = parseAndTransformComments(src, {\n\t\t\tmergeLineComments: true,\n\t\t\twrapLineComments: true,\n\t\t\twidth: 80,\n\t\t}).transformed;\n\t\texpect(out).toContain(\"  // first line explains next block\");\n\t\texpect(out).toContain(\"  // still explaining\");\n\t\texpect(out).toContain(\"  // final line\");\n\t\texpect(out).not.toContain(\"/**\");\n\t});\n\n\tit(\"converts the multi-line explanatory block from lib.ts into a multi-line JSDoc, preserving lines\", () => {\n\t\tconst snippet = [\n\t\t\t\"// JSDoc block extraction:\",\n\t\t\t\"// Previous pattern used a lazy dot-all: ([\\\\s\\\\S]*?) which could, under\",\n\t\t\t\"// pathological inputs, produce excessive backtracking. We replace it with a\",\n\t\t\t\"// tempered pattern that advances linearly by never letting the inner part\",\n\t\t\t\"// consume a closing '*/'. This avoids catastrophic behavior while keeping\",\n\t\t\t\"// correctness.\",\n\t\t\t\"// Pattern explanation:\",\n\t\t\t\"//  (^ [\\\\t ]* )    -> capture indentation at start of line (multiline mode)\",\n\t\t\t\"//  /\\\\*\\\\*          -> opening delimiter\",\n\t\t\t\"//  (              -> capture group 2 body\",\n\t\t\t\"//    (?:[^*]      -> any non-* char\",\n\t\t\t\"//      |\\\\*(?!/)   -> or a * not followed by /\",\n\t\t\t\"//    )*           -> repeated greedily (cannot cross closing */)\",\n\t\t\t\"//  )\",\n\t\t\t\"//  \\\\n?[\\\\t ]*\\\\*/   -> optional newline + trailing indent + closing */\",\n\t\t\t\"// The greedy repetition is safe because the inner alternatives are mutually\",\n\t\t\t\"// exclusive and each consumes at least one char without overlapping on the\",\n\t\t\t\"// closing sentinel.\",\n\t\t].join(\"\\n\");\n\t\tconst out = parseAndTransformComments(snippet, {\n\t\t\twidth: 100,\n\t\t\twrapLineComments: true,\n\t\t\tmergeLineComments: true,\n\t\t}).transformed;\n\t\t// Should be converted to a JSDoc (first and last lines delimiters)\n\t\tconst lines = out.split(/\\n/);\n\t\texpect(lines[0].trim()).toBe(\"/**\");\n\t\texpect(lines[lines.length - 1].trim()).toBe(\"*/\");\n\t\t// Ensure representative internal lines are present (now without leading //)\n\t\texpect(out).toContain(\"* JSDoc block extraction:\");\n\t\texpect(out).toContain(\"* Pattern explanation:\");\n\t\t// Arrow lines preserved\n\t\tconst arrowLineCount = lines.filter((l) => /->/.test(l)).length;\n\t\texpect(arrowLineCount).toBeGreaterThanOrEqual(5);\n\t});\n});\n"],"names":["fs","os","path","describe","expect","it","augmentPatterns","expandGlobs","diffLines","parseAndTransformComments","baseOpts","width","wrapLineComments","mergeLineComments","input","res","transformed","toContain","test","toBe","split","length","toBeGreaterThan","join","first","second","lines","filter","l","out","toMatch","trailingBlank","replace","tmpRoot","mkdtempSync","tmpdir","a","nestedDir","mkdirSync","recursive","b","writeFileSync","patterns","augmented","some","p","includes","expanded","sort","toEqual","src","not","snippet","trim","arrowLineCount","toBeGreaterThanOrEqual"],"mappings":"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"}
+{"version":3,"sources":["../../src/__tests__/lib.test.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { describe, expect, it } from \"vitest\";\nimport { expandGlobs } from \"../glob.js\";\nimport { diffLines, parseAndTransformComments } from \"../lib.js\";\n\nconst baseOpts = {\n\twidth: 60,\n\twrapLineComments: true,\n\tmergeLineComments: false,\n};\n\ndescribe(\"parseAndTransformComments\", () => {\n\tit(\"reflows a simple jsdoc and adds period\", () => {\n\t\tconst input = \"/**\\n * This function does something\\n * important\\n */\";\n\t\tconst res = parseAndTransformComments(input, baseOpts);\n\t\texpect(res.transformed).toContain(\"does something important.\");\n\t});\n\n\tit(\"normalizes NOTE capitalization\", () => {\n\t\tconst input = \"/**\\n * note: edge case\\n */\";\n\t\tconst res = parseAndTransformComments(input, baseOpts);\n\t\texpect(/NOTE: edge case/.test(res.transformed)).toBe(true);\n\t});\n\n\tit(\"wraps single line comments\", () => {\n\t\tconst input =\n\t\t\t\"// this is a very long comment that should be wrapped across multiple lines to satisfy width\";\n\t\tconst res = parseAndTransformComments(input, baseOpts);\n\t\texpect(res.transformed.split(/\\n/).length).toBeGreaterThan(1);\n\t});\n\n\tit(\"merges groups of line comments into jsdoc\", () => {\n\t\tconst input = [\n\t\t\t\"// first line\",\n\t\t\t\"// second line\",\n\t\t\t\"// third line\",\n\t\t\t\"const x = 1;\",\n\t\t].join(\"\\n\");\n\t\tconst res = parseAndTransformComments(input, {\n\t\t\t...baseOpts,\n\t\t\tmergeLineComments: true,\n\t\t});\n\t\texpect(/\\/\\*\\*/.test(res.transformed)).toBe(true);\n\t});\n\n\tit(\"is idempotent (second pass unchanged)\", () => {\n\t\tconst input = \"/**\\n * Example doc that will be normalized\\n */\";\n\t\tconst first = parseAndTransformComments(input, baseOpts).transformed;\n\t\tconst second = parseAndTransformComments(first, baseOpts).transformed;\n\t\texpect(diffLines(first, second)).toBe(\"\");\n\t});\n\n\tit(\"preserves code fence blocks\", () => {\n\t\tconst input =\n\t\t\t\"/**\\n * Before\\n * ```js\\n * const  x=  1;   \\n * ```\\n * After\\n */\";\n\t\tconst res = parseAndTransformComments(input, baseOpts).transformed;\n\t\texpect(/```js/.test(res)).toBe(true);\n\t\t// ensure spacing inside fence not normalized.\n\t\texpect(/const {2}x= {2}1;/.test(res)).toBe(true);\n\t});\n\n\tit(\"does not merge directive or license groups\", () => {\n\t\tconst input = [\n\t\t\t\"// eslint-disable-next-line\",\n\t\t\t\"// second line should prevent merge due to directive\",\n\t\t\t\"const y = 2;\",\n\t\t\t\"// Copyright 2024 Example\",\n\t\t\t\"// another line\",\n\t\t].join(\"\\n\");\n\t\tconst res = parseAndTransformComments(input, {\n\t\t\t...baseOpts,\n\t\t\tmergeLineComments: true,\n\t\t});\n\t\texpect(/eslint-disable/.test(res.transformed)).toBe(true);\n\t\t// Should not have merged into a jsdoc (no /** directly before const).\n\t\texpect(/\\/\\*\\*/.test(res.transformed)).toBe(false);\n\t});\n\n\tit(\"list items are not reflowed into a paragraph\", () => {\n\t\tconst input =\n\t\t\t\"/**\\n * First line explaining.\\n * - item one more words here\\n * - item two\\n */\";\n\t\tconst res = parseAndTransformComments(input, baseOpts).transformed;\n\t\t// each list item remains on its own line with leading dash.\n\t\tconst lines = res.split(/\\n/).filter((l) => /- item/.test(l));\n\t\texpect(lines.length).toBe(2);\n\t});\n\n\tit(\"tag lines are preserved\", () => {\n\t\tconst input =\n\t\t\t\"/**\\n * short description\\n * @param x value\\n * @returns something\\n */\";\n\t\tconst res = parseAndTransformComments(input, baseOpts).transformed;\n\t\texpect(/@param x value/.test(res)).toBe(true);\n\t\texpect(/@returns something/.test(res)).toBe(true);\n\t});\n\n\tit(\"handles heading-like lines with colon and visually indented code & numeric lists\", () => {\n\t\tconst input = [\n\t\t\t\"/**\",\n\t\t\t\" * Overview:\",\n\t\t\t\" *   const   x = 1;\",\n\t\t\t\" * 1. first\",\n\t\t\t\" * 2. second\",\n\t\t\t\" *\", // blank separation\n\t\t\t\" * Another paragraph without period\",\n\t\t\t\" */\",\n\t\t].join(\"\\n\");\n\t\tconst out = parseAndTransformComments(input, baseOpts).transformed;\n\t\t// Heading preserved, not merged into previous paragraph.\n\t\texpect(out).toMatch(/Overview:/);\n\t\t// Visually indented code line kept as-is (no extra wrapping collapse).\n\t\texpect(out).toMatch(/const\\s{3}x = 1;/);\n\t\t/**\n\t\t * Trailing blank before closing is optional after recent trimming change. (we\n\t\t * only keep it when multiple paragraphs exist). Assert closing exists.\n\t\t * Closing delimiter should be on its own line; allow optional leading\n\t\t * space(s).\n\t\t */\n\t\texpect(/\\n\\s*\\*\\/$/.test(out)).toBe(true);\n\t\t// Numeric list lines preserved.\n\t\texpect(out).toMatch(/1\\. first/);\n\t\texpect(out).toMatch(/2\\. second/);\n\t\t// Trailing paragraph got terminal period.\n\t\texpect(out).toMatch(/Another paragraph without period\\./);\n\t});\n\n\tit(\"glob expansion matches deep files only with explicit globstar\", () => {\n\t\tconst tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), \"comments-glob-\"));\n\t\tconst a = path.join(tmpRoot, \"a.ts\");\n\t\tconst nestedDir = path.join(tmpRoot, \"nested\");\n\t\tfs.mkdirSync(nestedDir, { recursive: true });\n\t\tconst b = path.join(nestedDir, \"b.ts\");\n\t\tfs.writeFileSync(a, \"// file a\", \"utf8\");\n\t\tfs.writeFileSync(b, \"// file b\", \"utf8\");\n\t\t// Shallow pattern should only see top-level a.ts.\n\t\tconst shallow = expandGlobs([`${tmpRoot}/*.ts`]).sort();\n\t\texpect(shallow).toEqual([a]);\n\t\t// Deep pattern matches both.\n\t\tconst deep = expandGlobs([`${tmpRoot}/**/*.ts`]).sort();\n\t\texpect(deep).toEqual([a, b].sort());\n\t});\n\n\t/**\n\t * Added test for preserving multi-line // comment groups that should NOT merge\n\t * when preceded by code.\n\t */\n\tit(\"does not merge an inline explanatory multi-line // comment group following code\", () => {\n\t\tconst src = [\n\t\t\t\"function demo() {\",\n\t\t\t\"  const x = 1; // keep\",\n\t\t\t\"  // first line explains next block\",\n\t\t\t\"  // still explaining\",\n\t\t\t\"  // final line\",\n\t\t\t\"  return x; // done\",\n\t\t\t\"}\",\n\t\t\t\"\",\n\t\t].join(\"\\n\");\n\t\tconst out = parseAndTransformComments(src, {\n\t\t\tmergeLineComments: true,\n\t\t\twrapLineComments: true,\n\t\t\twidth: 80,\n\t\t}).transformed;\n\t\texpect(out).toContain(\"  // first line explains next block\");\n\t\texpect(out).toContain(\"  // still explaining\");\n\t\texpect(out).toContain(\"  // final line\");\n\t\texpect(out).not.toContain(\"/**\");\n\t});\n\n\tit(\"converts the multi-line explanatory block from lib.ts into a multi-line JSDoc, preserving lines\", () => {\n\t\tconst snippet = [\n\t\t\t\"// JSDoc block extraction:\",\n\t\t\t\"// Previous pattern used a lazy dot-all: ([\\\\s\\\\S]*?) which could, under\",\n\t\t\t\"// pathological inputs, produce excessive backtracking. We replace it with a\",\n\t\t\t\"// tempered pattern that advances linearly by never letting the inner part\",\n\t\t\t\"// consume a closing '*/'. This avoids catastrophic behavior while keeping\",\n\t\t\t\"// correctness.\",\n\t\t\t\"// Pattern explanation:\",\n\t\t\t\"//  (^ [\\\\t ]* )    -> capture indentation at start of line (multiline mode)\",\n\t\t\t\"//  /\\\\*\\\\*          -> opening delimiter\",\n\t\t\t\"//  (              -> capture group 2 body\",\n\t\t\t\"//    (?:[^*]      -> any non-* char\",\n\t\t\t\"//      |\\\\*(?!/)   -> or a * not followed by /\",\n\t\t\t\"//    )*           -> repeated greedily (cannot cross closing */)\",\n\t\t\t\"//  )\",\n\t\t\t\"//  \\\\n?[\\\\t ]*\\\\*/   -> optional newline + trailing indent + closing */\",\n\t\t\t\"// The greedy repetition is safe because the inner alternatives are mutually\",\n\t\t\t\"// exclusive and each consumes at least one char without overlapping on the\",\n\t\t\t\"// closing sentinel.\",\n\t\t].join(\"\\n\");\n\t\tconst out = parseAndTransformComments(snippet, {\n\t\t\twidth: 100,\n\t\t\twrapLineComments: true,\n\t\t\tmergeLineComments: true,\n\t\t}).transformed;\n\t\t// Should be converted to a JSDoc (first and last lines delimiters).\n\t\tconst lines = out.split(/\\n/);\n\t\texpect(lines[0].trim()).toBe(\"/**\");\n\t\texpect(lines[lines.length - 1].trim()).toBe(\"*/\");\n\t\t// Ensure representative internal lines are present (now without leading //).\n\t\texpect(out).toContain(\"* JSDoc block extraction:\");\n\t\texpect(out).toContain(\"* Pattern explanation:\");\n\t\t// Arrow lines preserved.\n\t\tconst arrowLineCount = lines.filter((l) => /->/.test(l)).length;\n\t\texpect(arrowLineCount).toBeGreaterThanOrEqual(5);\n\t});\n\n\tit(\"does not insert period before list introduced by single lowercase word + colon\", () => {\n\t\tconst input = [\n\t\t\t\"/**\",\n\t\t\t\" * Some utilities have logging capabilities that needs to be\",\n\t\t\t\" * tested a little bit differently:\",\n\t\t\t\" * - mocking process.exit\",\n\t\t\t\" * - console.log\",\n\t\t\t\" * - inquirer.prompt\",\n\t\t\t\" */\",\n\t\t].join(\"\\n\");\n\t\tconst out = parseAndTransformComments(input, baseOpts).transformed;\n\t\t// Ensure no stray period after 'be'.\n\t\texpect(out).not.toMatch(/needs to be\\./);\n\t\t// Ensure list items unchanged.\n\t\texpect(out).toMatch(/- mocking process\\.exit/);\n\t});\n\n\tit(\"does not add stray period before lowercase colon line inside jsdoc\", () => {\n\t\tconst input = [\n\t\t\t\"/**\",\n\t\t\t\" * Some utilities have logging capabilities that needs to be\",\n\t\t\t\" * tested a little bit differently:\",\n\t\t\t\" * - one\",\n\t\t\t\" * - two\",\n\t\t\t\" */\",\n\t\t].join(\"\\n\");\n\t\tconst out = parseAndTransformComments(input, baseOpts).transformed;\n\t\texpect(out).not.toMatch(/needs to be\\./);\n\t});\n\n\tit(\"does not append periods to every line of a merged // comment group\", () => {\n\t\tconst original = [\n\t\t\t\"// We only want to add terminal punctuation once at the end of the merged\",\n\t\t\t\"// paragraph, not after every original line (which can create spurious\",\n\t\t\t\"// periods mid-sentence when lines were simple wraps). We also avoid\",\n\t\t\t\"// appending a period if the final line ends with a colon introducing a\",\n\t\t\t\"// list.\",\n\t\t].join(\"\\n\");\n\t\tconst out = parseAndTransformComments(original, {\n\t\t\twidth: 160, // keep wide to avoid secondary wrapping noise\n\t\t\twrapLineComments: true,\n\t\t\tmergeLineComments: true,\n\t\t}).transformed;\n\t\t// Ensure it became a JSDoc block.\n\t\texpect(out.startsWith(\"/**\")).toBe(true);\n\t\t// Should not contain stray periods after former line breaks.\n\t\texpect(out).not.toMatch(/merged\\./);\n\t\texpect(out).not.toMatch(/spurious\\./);\n\t\texpect(out).not.toMatch(/introducing a\\./);\n\t\t// Should still retain existing legitimate period after 'wraps).' and final\n\t\t// 'list.'\n\t\texpect(out).toMatch(/wraps\\)\\./);\n\t\texpect(out).toMatch(/list\\./);\n\t});\n\n\tit(\"merges a large explanatory // group after a statement into JSDoc\", () => {\n\t\tconst src = [\n\t\t\t\"const value = compute();\",\n\t\t\t\"// We only want to add terminal punctuation once at the end of the merged\",\n\t\t\t\"// paragraph, not after every original line (which can create spurious\",\n\t\t\t\"// periods mid-sentence when lines were simple wraps). We also avoid\",\n\t\t\t\"// appending a period if the final line ends with a colon introducing a\",\n\t\t\t\"// list.\",\n\t\t\t\"function next() {}\",\n\t\t].join(\"\\n\");\n\t\tconst out = parseAndTransformComments(src, {\n\t\t\twidth: 160,\n\t\t\twrapLineComments: true,\n\t\t\tmergeLineComments: true,\n\t\t}).transformed;\n\t\t// Expect merged into a JSDoc immediately after the statement.\n\t\tconst re = /compute\\(\\);\\n\\/\\*\\*[\\s\\S]*?\\n\\s*\\*\\//;\n\t\texpect(re.test(out)).toBe(true);\n\t\t// Ensure only one sentence-final period appended (present on final 'list.'\n\t\t// already).\n\t\texpect(out.match(/merged\\./)).toBeNull();\n\t});\n});\n"],"names":["fs","os","path","describe","expect","it","expandGlobs","diffLines","parseAndTransformComments","baseOpts","width","wrapLineComments","mergeLineComments","input","res","transformed","toContain","test","toBe","split","length","toBeGreaterThan","join","first","second","lines","filter","l","out","toMatch","tmpRoot","mkdtempSync","tmpdir","a","nestedDir","mkdirSync","recursive","b","writeFileSync","shallow","sort","toEqual","deep","src","not","snippet","trim","arrowLineCount","toBeGreaterThanOrEqual","original","startsWith","re","match","toBeNull"],"mappings":"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"}

package/dist/glob.d.ts

@@ -1,5 +1,4 @@
 export interface GlobOptions {
     followSymlinks?: boolean;
 }
-export declare function augmentPatterns(patterns: string[]): string[];
 export declare function expandGlobs(patterns: string[], options?: GlobOptions): string[];

package/dist/glob.js

@@ -1,143 +1,20 @@
-function _array_like_to_array(arr, len) {
-    if (len == null || len > arr.length) len = arr.length;
-    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
-    return arr2;
-}
-function _array_with_holes(arr) {
-    if (Array.isArray(arr)) return arr;
-}
-function _iterable_to_array_limit(arr, i) {
-    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
-    if (_i == null) return;
-    var _arr = [];
-    var _n = true;
-    var _d = false;
-    var _s, _e;
-    try {
-        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
-            _arr.push(_s.value);
-            if (i && _arr.length === i) break;
-        }
-    } catch (err) {
-        _d = true;
-        _e = err;
-    } finally{
-        try {
-            if (!_n && _i["return"] != null) _i["return"]();
-        } finally{
-            if (_d) throw _e;
-        }
-    }
-    return _arr;
-}
-function _non_iterable_rest() {
-    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
-function _sliced_to_array(arr, i) {
-    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
-}
-function _unsupported_iterable_to_array(o, minLen) {
-    if (!o) return;
-    if (typeof o === "string") return _array_like_to_array(o, minLen);
-    var n = Object.prototype.toString.call(o).slice(8, -1);
-    if (n === "Object" && o.constructor) n = o.constructor.name;
-    if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
-}
 import fs from "node:fs";
 import path from "node:path";
-var WILDCARD_CHARS = /[!*?]/;
-export function augmentPatterns(patterns) {
-    // Add dir/**/*.ext for each dir/*.ext simple pattern.
-    var extra = [];
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = patterns[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var p = _step.value;
-            if (p.includes("**")) {
-                continue;
-            }
-            var m = /^(.*)\/([^/]+)$/.exec(p);
-            if (!m) {
-                continue;
-            }
-            var _m = _sliced_to_array(m, 3), _ = _m[0], dir = _m[1], file = _m[2];
-            if (file.includes("*")) {
-                // if pattern is like dir/*.ts add deep variant.
-                if (!patterns.includes("".concat(dir, "/**/").concat(file))) {
-                    extra.push("".concat(dir, "/**/").concat(file));
-                }
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return patterns.concat(extra);
-}
-function escapeRegex(str) {
-    return str.replace(/[.+^${}()|[\]\\]/g, "\\$&");
-}
-function toRegex(pattern) {
+import micromatch from "micromatch";
+var WILDCARD_CHARS = /[!*?]/; // Detects basic glob characters
+function patternRoot(pattern) {
     if (!WILDCARD_CHARS.test(pattern)) {
-        return {
-            regex: null,
-            root: path.dirname(pattern) || "."
-        };
+        return path.dirname(pattern) || ".";
     }
-    // Determine walk root: substring up to first wildcard then dirname.
     var firstWildcard = pattern.search(/[*!?]/);
     var rootPart = firstWildcard === -1 ? pattern : pattern.slice(0, firstWildcard);
     if (!rootPart.endsWith("/")) {
         rootPart = path.dirname(rootPart);
     }
     if (!rootPart.length) {
-        rootPart = ".";
-    }
-    // Build regex: convert pattern path separators to '/'.
-    var norm = pattern.replace(/\\/g, "/");
-    var rx = "";
-    for(var i = 0; i < norm.length;){
-        if (norm[i] === "*") {
-            if (norm[i + 1] === "*") {
-                // '**'.
-                i += 2;
-                // collapse subsequent /** or trailing /
-                if (norm[i] === "/") {
-                    // match zero or more directories.
-                    rx += "(?:.*?/)?";
-                    i++;
-                } else {
-                    rx += ".*";
-                }
-                continue;
-            }
-            rx += "[^/]*";
-            i++;
-            continue;
-        }
-        if (norm[i] === "?") {
-            rx += "[^/]";
-            i++;
-            continue;
-        }
-        rx += escapeRegex(norm[i]);
-        i++;
+        return ".";
     }
-    return {
-        regex: new RegExp("^".concat(rx, "$")),
-        root: rootPart
-    };
+    return rootPart;
 }
 function walk(root, followSymlinks) {
     var results = [];
@@ -208,37 +85,29 @@ function walk(root, followSymlinks) {
 }
 export function expandGlobs(patterns) {
     var options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
-    var augmented = augmentPatterns(patterns);
-    var compiled = augmented.map(function(p) {
-        var _toRegex = toRegex(p), regex = _toRegex.regex, root = _toRegex.root;
-        return {
-            pattern: p,
-            regex: regex,
-            root: root
-        };
-    });
     var seen = new Set();
     var out = [];
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
-        for(var _iterator = compiled[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var p = _step.value;
-            if (p.regex === null) {
-                if (fs.existsSync(p.pattern) && fs.statSync(p.pattern).isFile()) {
-                    if (!seen.has(p.pattern)) {
-                        seen.add(p.pattern);
-                        out.push(p.pattern);
-                    }
+        for(var _iterator = patterns[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var pattern = _step.value;
+            // Literal file (no metachars).
+            if (!WILDCARD_CHARS.test(pattern)) {
+                if (fs.existsSync(pattern) && fs.statSync(pattern).isFile() && !seen.has(pattern)) {
+                    seen.add(pattern);
+                    out.push(pattern);
                 }
                 continue;
             }
-            var files = walk(p.root, options.followSymlinks || false);
+            var root = patternRoot(pattern);
+            var files = walk(root, options.followSymlinks || false);
+            var mmPattern = pattern.replace(/\\/g, "/");
             var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
             try {
                 for(var _iterator1 = files[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
                     var f = _step1.value;
-                    var rel = f.replace(/\\/g, "/");
-                    if (p.regex.test(rel)) {
+                    var normalized = f.replace(/\\/g, "/");
+                    if (micromatch.isMatch(normalized, mmPattern)) {
                         if (!seen.has(f)) {
                             seen.add(f);
                             out.push(f);