@node-cli/comments 0.1.0

package/dist/lib.js

@@ -0,0 +1,444 @@
+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_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+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 { Logger } from "@node-cli/logger";
+export var logger = new Logger({
+    boring: process.env.NODE_ENV === "test"
+});
+// Safety guards / limits (defense-in-depth vs pathological or malicious input)
+// Large indentation sequences (e.g. thousands of tabs) aren't meaningful for real
+// source formatting and could be used to inflate processing time if a regex
+// exhibited super-linear behavior. Our pattern is already linear (tempered), but
+// we still cap accepted indentation length to keep work bounded.
+var MAX_JSDOC_INDENT = 256; // characters (tabs + spaces)
+// JSDoc block extraction:
+// Previous pattern used a lazy dot-all: ([\s\S]*?) which could, under
+// pathological inputs, produce excessive backtracking. We replaced it with a
+// tempered pattern that advances linearly by never letting the inner part
+// consume a closing '*/'. This avoids catastrophic behavior while keeping
+// correctness.
+//
+// Reviewer (PR) concern: potential ReDoS on crafted inputs containing many
+// leading tabs then '/**'. Analysis: The inner quantified group
+//   (?:[^*]|\*(?!/))*
+// is unambiguous: on each iteration it consumes exactly one character and can
+// never match the closing sentinel '*/' because of the negative lookahead. This
+// means the engine proceeds in O(n) time relative to the block body size.
+// There is no nested ambiguous quantifier (e.g. (a+)*, (.*)+, etc.). The only
+// other quantified part ^[\t ]* is a simple character class that is consumed
+// once per line start with no backtracking explosion potential.
+//
+// Defense-in-depth: we still (1) cap processed body length (see below) and
+// (2) cap accepted indentation length (MAX_JSDOC_INDENT) after match to ensure
+// we skip absurdly indented constructs.
+//
+// Pattern explanation:
+//  (^ [\t ]* )    -> capture indentation at start of line (multiline mode)
+//  /\*\*          -> opening delimiter
+//  (              -> capture group 2 body
+//    (?:[^*]      -> any non-* char
+//      |\*(?!/)   -> or a * not followed by /
+//    )*           -> repeated greedily (cannot cross closing */)
+//  )
+//  \n?[\t ]*\*/   -> optional newline + trailing indent + closing */
+// Complexity: linear in length of the matched block.
+var JSDOC_REGEX = /(^[\t ]*)\/\*\*((?:[^*]|\*(?!\/))*)\n?[\t ]*\*\//gm;
+export function diffLines(a, b) {
+    if (a === b) {
+        return "";
+    }
+    var A = a.split(/\n/);
+    var B = b.split(/\n/);
+    var out = [];
+    var m = Math.max(A.length, B.length);
+    for(var i = 0; i < m; i++){
+        if (A[i] === B[i]) {
+            continue;
+        }
+        if (A[i] !== undefined) {
+            out.push("- ".concat(A[i]));
+        }
+        if (B[i] !== undefined) {
+            out.push("+ ".concat(B[i]));
+        }
+    }
+    return out.join("\n");
+}
+function endsSentence(line) {
+    return /[.!?](?:['")\]]*)$/.test(line.trim());
+}
+function needsTerminalPunctuation(line) {
+    return /[A-Za-z0-9")\]']$/.test(line) && !endsSentence(line);
+}
+function maybeAddPeriod(line) {
+    return needsTerminalPunctuation(line) ? line + "." : line;
+}
+function normalizeNote(line) {
+    return line.replace(/^note:/i, "NOTE:");
+}
+function isListLike(line) {
+    return /^(?:[-*+] |\d+\. )/.test(line.trim());
+}
+function isTagLine(line) {
+    return /^@/.test(line.trim());
+}
+function isHeadingLike(line) {
+    var t = line.trim();
+    return /:$/.test(t) && !isTagLine(t);
+}
+function isCodeFence(line) {
+    return /^```/.test(line.trim());
+}
+function isVisuallyIndentedCode(line) {
+    return /^\s{2,}\S/.test(line);
+}
+function wrapWords(text, width) {
+    var words = text.split(/\s+/).filter(Boolean);
+    var lines = [];
+    var cur = "";
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = words[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var w = _step.value;
+            if (!cur.length) {
+                cur = w;
+                continue;
+            }
+            if (cur.length + 1 + w.length <= width) {
+                cur += " " + w;
+            } else {
+                lines.push(cur);
+                cur = w;
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    if (cur) {
+        lines.push(cur);
+    }
+    return lines.length ? lines : [
+        ""
+    ];
+}
+function buildJsDoc(indent, rawBody, width) {
+    var lines = rawBody.split(/\n/).map(function(l) {
+        return l.replace(/^\s*\*? ?/, "");
+    });
+    var out = [];
+    var para = [];
+    var inFence = false;
+    var prefix = indent + " * ";
+    var avail = Math.max(10, width - prefix.length);
+    function flush() {
+        if (!para.length) {
+            return;
+        }
+        var text = para.join(" ").replace(/\s+/g, " ").trim();
+        text = normalizeNote(text);
+        text = maybeAddPeriod(text);
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = wrapWords(text, avail)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var l = _step.value;
+                out.push(prefix + l);
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+        para = [];
+    }
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = lines[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var raw = _step.value;
+            var trimmed = raw.trimEnd();
+            if (isCodeFence(trimmed)) {
+                flush();
+                inFence = !inFence;
+                out.push(prefix + trimmed);
+                continue;
+            }
+            if (inFence) {
+                out.push(prefix + trimmed);
+                continue;
+            }
+            if (trimmed === "" || isListLike(trimmed) || isTagLine(trimmed) || isHeadingLike(trimmed) || isVisuallyIndentedCode(raw)) {
+                flush();
+                if (trimmed === "") {
+                    if (out.length === 0 || /^(?:\s*\*\s*)$/.test(out[out.length - 1]) === false) {
+                        out.push(prefix.trimEnd());
+                    }
+                } else {
+                    out.push(prefix + normalizeNote(trimmed));
+                }
+                continue;
+            }
+            para.push(trimmed);
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    flush();
+    return "".concat(indent, "/**\n").concat(out.join("\n"), "\n").concat(indent, "*/");
+}
+function reflowJsDocBlocks(content, width) {
+    JSDOC_REGEX.lastIndex = 0;
+    var blocks = [];
+    var m = JSDOC_REGEX.exec(content);
+    while(m){
+        var indent = m[1] || "";
+        var body = m[2] || "";
+        // Body length guard protects against extremely large comment blocks.
+        if (body.length <= 500000 && indent.length <= MAX_JSDOC_INDENT) {
+            blocks.push({
+                indent: indent,
+                body: body,
+                start: m.index,
+                end: m.index + m[0].length
+            });
+        }
+        m = JSDOC_REGEX.exec(content);
+    }
+    if (!blocks.length) {
+        return {
+            content: content,
+            blocks: 0
+        };
+    }
+    var delta = 0;
+    var out = content;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = blocks[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var b = _step.value;
+            var original = out.slice(b.start + delta, b.end + delta);
+            var built = buildJsDoc(b.indent, b.body, width);
+            if (original !== built) {
+                out = out.slice(0, b.start + delta) + built + out.slice(b.end + delta);
+                delta += built.length - original.length;
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return {
+        content: out,
+        blocks: blocks.length
+    };
+}
+function wrapLineComments(content, width) {
+    var _loop = function(i) {
+        var _out;
+        var line = lines[i];
+        var m = /^(\s*)\/\/( ?)(.*)$/.exec(line);
+        if (!m || /^\/\/\//.test(line)) {
+            out.push(line);
+            return "continue";
+        }
+        var indent = m[1];
+        var body = m[3];
+        if (/^(@|eslint|ts-ignore)/.test(body) || /https?:\/\//.test(body)) {
+            out.push(line);
+            return "continue";
+        }
+        var prefix = indent + "// ";
+        var avail = Math.max(10, width - prefix.length);
+        var text = body.replace(/\s+/g, " ").trim();
+        text = normalizeNote(text);
+        text = maybeAddPeriod(text);
+        var wrapped = wrapWords(text, avail).map(function(w) {
+            return prefix + w;
+        });
+        if (wrapped.join("\n") !== line) {
+            changed = true;
+        }
+        (_out = out).push.apply(_out, _to_consumable_array(wrapped));
+    };
+    var lines = content.split(/\n/);
+    var changed = false;
+    var out = [];
+    for(var i = 0; i < lines.length; i++)_loop(i);
+    return {
+        content: out.join("\n"),
+        applied: changed
+    };
+}
+function mergeLineCommentGroups(content) {
+    var lines = content.split(/\n/);
+    var out = [];
+    var i = 0;
+    var merged = false;
+    while(i < lines.length){
+        if (/^\s*\/\//.test(lines[i]) && !/^\s*\/\/\//.test(lines[i])) {
+            var prev = i > 0 ? lines[i - 1] : "";
+            var prevTrim = prev.trim();
+            var contextEligible = prevTrim === "" || /[{}]$/.test(prevTrim);
+            if (!contextEligible) {
+                out.push(lines[i]);
+                i++;
+                continue;
+            }
+            var group = [];
+            var j = i;
+            while(j < lines.length){
+                var lm = /^(\s*)\/\/ ?(.*)$/.exec(lines[j]);
+                if (!lm || /^\s*\/\/\//.test(lines[j])) {
+                    break;
+                }
+                var txt = lm[2];
+                if (/license|copyright/i.test(txt) || /https?:\/\//.test(txt) || /eslint|ts-ignore/.test(txt)) {
+                    break; // do not merge directive / license groups
+                }
+                group.push({
+                    indent: lm[1],
+                    text: txt
+                });
+                j++;
+            }
+            if (group.length >= 2) {
+                // Structured explanatory blocks: now we CONVERT them into a multi-line JSDoc block
+                // while preserving each original line (instead of merging into a single paragraph).
+                // We must escape any raw '*/' inside the body to avoid premature termination.
+                // Definition of structured: presence of arrows (->), regex tokens (?:, */), or the phrase 'Pattern explanation:'.
+                var structured = group.some(function(g) {
+                    return /->/.test(g.text) || /(\(\?:|\*\/)/.test(g.text) || /Pattern explanation:/i.test(g.text);
+                });
+                if (structured) {
+                    var indent = group[0].indent;
+                    out.push("".concat(indent, "/**"));
+                    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                    try {
+                        for(var _iterator = group[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                            var ln = _step.value;
+                            // Escape closing sentinel inside content
+                            var safe = ln.text.replace(/\*\//g, "*\\/");
+                            out.push("".concat(indent, " * ").concat(safe));
+                        }
+                    } catch (err) {
+                        _didIteratorError = true;
+                        _iteratorError = err;
+                    } finally{
+                        try {
+                            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                _iterator.return();
+                            }
+                        } finally{
+                            if (_didIteratorError) {
+                                throw _iteratorError;
+                            }
+                        }
+                    }
+                    out.push("".concat(indent, " */"));
+                    merged = true;
+                    i = j;
+                    continue;
+                }
+                var indent1 = group[0].indent;
+                merged = true;
+                var para = group.map(function(g) {
+                    return normalizeNote(g.text.trim());
+                }).map(function(g) {
+                    return maybeAddPeriod(g);
+                }).join(" ");
+                out.push("".concat(indent1, "/**"));
+                out.push("".concat(indent1, " * ").concat(para));
+                out.push("".concat(indent1, " */"));
+                i = j;
+                continue;
+            }
+        }
+        out.push(lines[i]);
+        i++;
+    }
+    return {
+        content: out.join("\n"),
+        merged: merged
+    };
+}
+export function parseAndTransformComments(input, options) {
+    var working = input;
+    if (options.mergeLineComments) {
+        var m = mergeLineCommentGroups(working);
+        working = m.content;
+    }
+    var js = reflowJsDocBlocks(working, options.width);
+    working = js.content;
+    if (options.wrapLineComments) {
+        var w = wrapLineComments(working, options.width);
+        working = w.content;
+    }
+    return {
+        original: input,
+        transformed: working,
+        changed: working !== input
+    };
+}
+
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib.ts"],"sourcesContent":["import { Logger } from \"@node-cli/logger\";\n\nexport const logger = new Logger({ boring: process.env.NODE_ENV === \"test\" });\n\nexport interface ProcessOptions {\n\twidth: number;\n\twrapLineComments: boolean;\n\tmergeLineComments: boolean;\n}\n\nexport interface FileResult {\n\toriginal: string;\n\ttransformed: string;\n\tchanged: boolean;\n}\n\ninterface JsDocMatch {\n\tindent: string;\n\tbody: string;\n\tstart: number;\n\tend: number;\n}\n\n// Safety guards / limits (defense-in-depth vs pathological or malicious input)\n// Large indentation sequences (e.g. thousands of tabs) aren't meaningful for real\n// source formatting and could be used to inflate processing time if a regex\n// exhibited super-linear behavior. Our pattern is already linear (tempered), but\n// we still cap accepted indentation length to keep work bounded.\nconst MAX_JSDOC_INDENT = 256; // characters (tabs + spaces)\n\n// JSDoc block extraction:\n// Previous pattern used a lazy dot-all: ([\\s\\S]*?) which could, under\n// pathological inputs, produce excessive backtracking. We replaced it with a\n// tempered pattern that advances linearly by never letting the inner part\n// consume a closing '*/'. This avoids catastrophic behavior while keeping\n// correctness.\n//\n// Reviewer (PR) concern: potential ReDoS on crafted inputs containing many\n// leading tabs then '/**'. Analysis: The inner quantified group\n//   (?:[^*]|\\*(?!/))*\n// is unambiguous: on each iteration it consumes exactly one character and can\n// never match the closing sentinel '*/' because of the negative lookahead. This\n// means the engine proceeds in O(n) time relative to the block body size.\n// There is no nested ambiguous quantifier (e.g. (a+)*, (.*)+, etc.). The only\n// other quantified part ^[\\t ]* is a simple character class that is consumed\n// once per line start with no backtracking explosion potential.\n//\n// Defense-in-depth: we still (1) cap processed body length (see below) and\n// (2) cap accepted indentation length (MAX_JSDOC_INDENT) after match to ensure\n// we skip absurdly indented constructs.\n//\n// Pattern explanation:\n//  (^ [\\t ]* )    -> capture indentation at start of line (multiline mode)\n//  /\\*\\*          -> opening delimiter\n//  (              -> capture group 2 body\n//    (?:[^*]      -> any non-* char\n//      |\\*(?!/)   -> or a * not followed by /\n//    )*           -> repeated greedily (cannot cross closing */)\n//  )\n//  \\n?[\\t ]*\\*/   -> optional newline + trailing indent + closing */\n// Complexity: linear in length of the matched block.\nconst JSDOC_REGEX = /(^[\\t ]*)\\/\\*\\*((?:[^*]|\\*(?!\\/))*)\\n?[\\t ]*\\*\\//gm;\n\nexport function diffLines(a: string, b: string): string {\n\tif (a === b) {\n\t\treturn \"\";\n\t}\n\tconst A = a.split(/\\n/);\n\tconst B = b.split(/\\n/);\n\tconst out: string[] = [];\n\tconst m = Math.max(A.length, B.length);\n\tfor (let i = 0; i < m; i++) {\n\t\tif (A[i] === B[i]) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (A[i] !== undefined) {\n\t\t\tout.push(`- ${A[i]}`);\n\t\t}\n\t\tif (B[i] !== undefined) {\n\t\t\tout.push(`+ ${B[i]}`);\n\t\t}\n\t}\n\treturn out.join(\"\\n\");\n}\n\nfunction endsSentence(line: string): boolean {\n\treturn /[.!?](?:['\")\\]]*)$/.test(line.trim());\n}\n\nfunction needsTerminalPunctuation(line: string): boolean {\n\treturn /[A-Za-z0-9\")\\]']$/.test(line) && !endsSentence(line);\n}\n\nfunction maybeAddPeriod(line: string): string {\n\treturn needsTerminalPunctuation(line) ? line + \".\" : line;\n}\n\nfunction normalizeNote(line: string): string {\n\treturn line.replace(/^note:/i, \"NOTE:\");\n}\n\nfunction isListLike(line: string): boolean {\n\treturn /^(?:[-*+] |\\d+\\. )/.test(line.trim());\n}\n\nfunction isTagLine(line: string): boolean {\n\treturn /^@/.test(line.trim());\n}\n\nfunction isHeadingLike(line: string): boolean {\n\tconst t = line.trim();\n\treturn /:$/.test(t) && !isTagLine(t);\n}\n\nfunction isCodeFence(line: string): boolean {\n\treturn /^```/.test(line.trim());\n}\n\nfunction isVisuallyIndentedCode(line: string): boolean {\n\treturn /^\\s{2,}\\S/.test(line);\n}\n\nfunction wrapWords(text: string, width: number): string[] {\n\tconst words = text.split(/\\s+/).filter(Boolean);\n\tconst lines: string[] = [];\n\tlet cur = \"\";\n\tfor (const w of words) {\n\t\tif (!cur.length) {\n\t\t\tcur = w;\n\t\t\tcontinue;\n\t\t}\n\t\tif (cur.length + 1 + w.length <= width) {\n\t\t\tcur += \" \" + w;\n\t\t} else {\n\t\t\tlines.push(cur);\n\t\t\tcur = w;\n\t\t}\n\t}\n\tif (cur) {\n\t\tlines.push(cur);\n\t}\n\treturn lines.length ? lines : [\"\"];\n}\n\nfunction buildJsDoc(indent: string, rawBody: string, width: number): string {\n\tconst lines = rawBody.split(/\\n/).map((l) => l.replace(/^\\s*\\*? ?/, \"\"));\n\tconst out: string[] = [];\n\tlet para: string[] = [];\n\tlet inFence = false;\n\tconst prefix = indent + \" * \";\n\tconst avail = Math.max(10, width - prefix.length);\n\n\tfunction flush(): void {\n\t\tif (!para.length) {\n\t\t\treturn;\n\t\t}\n\t\tlet text = para.join(\" \").replace(/\\s+/g, \" \").trim();\n\t\ttext = normalizeNote(text);\n\t\ttext = maybeAddPeriod(text);\n\t\tfor (const l of wrapWords(text, avail)) {\n\t\t\tout.push(prefix + l);\n\t\t}\n\t\tpara = [];\n\t}\n\n\tfor (const raw of lines) {\n\t\tconst trimmed = raw.trimEnd();\n\t\tif (isCodeFence(trimmed)) {\n\t\t\tflush();\n\t\t\tinFence = !inFence;\n\t\t\tout.push(prefix + trimmed);\n\t\t\tcontinue;\n\t\t}\n\t\tif (inFence) {\n\t\t\tout.push(prefix + trimmed);\n\t\t\tcontinue;\n\t\t}\n\t\tif (\n\t\t\ttrimmed === \"\" ||\n\t\t\tisListLike(trimmed) ||\n\t\t\tisTagLine(trimmed) ||\n\t\t\tisHeadingLike(trimmed) ||\n\t\t\tisVisuallyIndentedCode(raw)\n\t\t) {\n\t\t\tflush();\n\t\t\tif (trimmed === \"\") {\n\t\t\t\tif (\n\t\t\t\t\tout.length === 0 ||\n\t\t\t\t\t/^(?:\\s*\\*\\s*)$/.test(out[out.length - 1]) === false\n\t\t\t\t) {\n\t\t\t\t\tout.push(prefix.trimEnd());\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tout.push(prefix + normalizeNote(trimmed));\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tpara.push(trimmed);\n\t}\n\tflush();\n\treturn `${indent}/**\\n${out.join(\"\\n\")}\\n${indent}*/`;\n}\n\nfunction reflowJsDocBlocks(\n\tcontent: string,\n\twidth: number,\n): { content: string; blocks: number } {\n\tJSDOC_REGEX.lastIndex = 0;\n\tconst blocks: JsDocMatch[] = [];\n\tlet m: RegExpExecArray | null = JSDOC_REGEX.exec(content);\n\twhile (m) {\n\t\tconst indent = m[1] || \"\";\n\t\tconst body = m[2] || \"\";\n\t\t// Body length guard protects against extremely large comment blocks.\n\t\tif (body.length <= 500_000 && indent.length <= MAX_JSDOC_INDENT) {\n\t\t\tblocks.push({\n\t\t\t\tindent,\n\t\t\t\tbody,\n\t\t\t\tstart: m.index,\n\t\t\t\tend: m.index + m[0].length,\n\t\t\t});\n\t\t}\n\t\tm = JSDOC_REGEX.exec(content);\n\t}\n\tif (!blocks.length) {\n\t\treturn { content, blocks: 0 };\n\t}\n\tlet delta = 0;\n\tlet out = content;\n\tfor (const b of blocks) {\n\t\tconst original = out.slice(b.start + delta, b.end + delta);\n\t\tconst built = buildJsDoc(b.indent, b.body, width);\n\t\tif (original !== built) {\n\t\t\tout = out.slice(0, b.start + delta) + built + out.slice(b.end + delta);\n\t\t\tdelta += built.length - original.length;\n\t\t}\n\t}\n\treturn { content: out, blocks: blocks.length };\n}\n\nfunction wrapLineComments(\n\tcontent: string,\n\twidth: number,\n): { content: string; applied: boolean } {\n\tconst lines = content.split(/\\n/);\n\tlet changed = false;\n\tconst out: string[] = [];\n\tfor (let i = 0; i < lines.length; i++) {\n\t\tconst line = lines[i];\n\t\tconst m = /^(\\s*)\\/\\/( ?)(.*)$/.exec(line);\n\t\tif (!m || /^\\/\\/\\//.test(line)) {\n\t\t\tout.push(line);\n\t\t\tcontinue;\n\t\t}\n\t\tconst indent = m[1];\n\t\tconst body = m[3];\n\t\tif (/^(@|eslint|ts-ignore)/.test(body) || /https?:\\/\\//.test(body)) {\n\t\t\tout.push(line);\n\t\t\tcontinue;\n\t\t}\n\t\tconst prefix = indent + \"// \";\n\t\tconst avail = Math.max(10, width - prefix.length);\n\t\tlet text = body.replace(/\\s+/g, \" \").trim();\n\t\ttext = normalizeNote(text);\n\t\ttext = maybeAddPeriod(text);\n\t\tconst wrapped = wrapWords(text, avail).map((w) => prefix + w);\n\t\tif (wrapped.join(\"\\n\") !== line) {\n\t\t\tchanged = true;\n\t\t}\n\t\tout.push(...wrapped);\n\t}\n\treturn { content: out.join(\"\\n\"), applied: changed };\n}\n\nfunction mergeLineCommentGroups(content: string): {\n\tcontent: string;\n\tmerged: boolean;\n} {\n\tconst lines = content.split(/\\n/);\n\tconst out: string[] = [];\n\tlet i = 0;\n\tlet merged = false;\n\twhile (i < lines.length) {\n\t\tif (/^\\s*\\/\\//.test(lines[i]) && !/^\\s*\\/\\/\\//.test(lines[i])) {\n\t\t\tconst prev = i > 0 ? lines[i - 1] : \"\";\n\t\t\tconst prevTrim = prev.trim();\n\t\t\tconst contextEligible = prevTrim === \"\" || /[{}]$/.test(prevTrim);\n\t\t\tif (!contextEligible) {\n\t\t\t\tout.push(lines[i]);\n\t\t\t\ti++;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst group: { indent: string; text: string }[] = [];\n\t\t\tlet j = i;\n\t\t\twhile (j < lines.length) {\n\t\t\t\tconst lm = /^(\\s*)\\/\\/ ?(.*)$/.exec(lines[j]);\n\t\t\t\tif (!lm || /^\\s*\\/\\/\\//.test(lines[j])) {\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tconst txt = lm[2];\n\t\t\t\tif (\n\t\t\t\t\t/license|copyright/i.test(txt) ||\n\t\t\t\t\t/https?:\\/\\//.test(txt) ||\n\t\t\t\t\t/eslint|ts-ignore/.test(txt)\n\t\t\t\t) {\n\t\t\t\t\tbreak; // do not merge directive / license groups\n\t\t\t\t}\n\t\t\t\tgroup.push({ indent: lm[1], text: txt });\n\t\t\t\tj++;\n\t\t\t}\n\t\t\tif (group.length >= 2) {\n\t\t\t\t// Structured explanatory blocks: now we CONVERT them into a multi-line JSDoc block\n\t\t\t\t// while preserving each original line (instead of merging into a single paragraph).\n\t\t\t\t// We must escape any raw '*/' inside the body to avoid premature termination.\n\t\t\t\t// Definition of structured: presence of arrows (->), regex tokens (?:, */), or the phrase 'Pattern explanation:'.\n\t\t\t\tconst structured = group.some(\n\t\t\t\t\t(g) =>\n\t\t\t\t\t\t/->/.test(g.text) ||\n\t\t\t\t\t\t/(\\(\\?:|\\*\\/)/.test(g.text) ||\n\t\t\t\t\t\t/Pattern explanation:/i.test(g.text),\n\t\t\t\t);\n\t\t\t\tif (structured) {\n\t\t\t\t\tconst indent = group[0].indent;\n\t\t\t\t\tout.push(`${indent}/**`);\n\t\t\t\t\tfor (const ln of group) {\n\t\t\t\t\t\t// Escape closing sentinel inside content\n\t\t\t\t\t\tconst safe = ln.text.replace(/\\*\\//g, \"*\\\\/\");\n\t\t\t\t\t\tout.push(`${indent} * ${safe}`);\n\t\t\t\t\t}\n\t\t\t\t\tout.push(`${indent} */`);\n\t\t\t\t\tmerged = true;\n\t\t\t\t\ti = j;\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tconst indent = group[0].indent;\n\t\t\t\tmerged = true;\n\t\t\t\tconst para = group\n\t\t\t\t\t.map((g) => normalizeNote(g.text.trim()))\n\t\t\t\t\t.map((g) => maybeAddPeriod(g))\n\t\t\t\t\t.join(\" \");\n\t\t\t\tout.push(`${indent}/**`);\n\t\t\t\tout.push(`${indent} * ${para}`);\n\t\t\t\tout.push(`${indent} */`);\n\t\t\t\ti = j;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\t\tout.push(lines[i]);\n\t\ti++;\n\t}\n\treturn { content: out.join(\"\\n\"), merged };\n}\n\nexport function parseAndTransformComments(\n\tinput: string,\n\toptions: ProcessOptions,\n): FileResult {\n\tlet working = input;\n\tif (options.mergeLineComments) {\n\t\tconst m = mergeLineCommentGroups(working);\n\t\tworking = m.content;\n\t}\n\tconst js = reflowJsDocBlocks(working, options.width);\n\tworking = js.content;\n\tif (options.wrapLineComments) {\n\t\tconst w = wrapLineComments(working, options.width);\n\t\tworking = w.content;\n\t}\n\treturn { original: input, transformed: working, changed: working !== input };\n}\n"],"names":["Logger","logger","boring","process","env","NODE_ENV","MAX_JSDOC_INDENT","JSDOC_REGEX","diffLines","a","b","A","split","B","out","m","Math","max","length","i","undefined","push","join","endsSentence","line","test","trim","needsTerminalPunctuation","maybeAddPeriod","normalizeNote","replace","isListLike","isTagLine","isHeadingLike","t","isCodeFence","isVisuallyIndentedCode","wrapWords","text","width","words","filter","Boolean","lines","cur","w","buildJsDoc","indent","rawBody","map","l","para","inFence","prefix","avail","flush","raw","trimmed","trimEnd","reflowJsDocBlocks","content","lastIndex","blocks","exec","body","start","index","end","delta","original","slice","built","wrapLineComments","wrapped","changed","applied","mergeLineCommentGroups","merged","prev","prevTrim","contextEligible","group","j","lm","txt","structured","some","g","ln","safe","parseAndTransformComments","input","options","working","mergeLineComments","js","transformed"],"mappings":"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"}

package/dist/parse.d.ts

@@ -0,0 +1,19 @@
+export type Flags = {
+    width?: number;
+    dryRun?: boolean;
+    stdout?: boolean;
+    noLineWrap?: boolean;
+    mergeLineComments?: boolean;
+    boring?: boolean;
+    help?: boolean;
+    version?: boolean;
+};
+export type Parameters = {
+    files?: string;
+};
+export type Configuration = {
+    flags?: Flags;
+    parameters?: Parameters;
+    showHelp?: () => void;
+};
+export declare const config: Configuration;

package/dist/parse.js

@@ -0,0 +1,87 @@
+/* v8 ignore start */ import { parser } from "@node-cli/parser";
+import { defaultFlags } from "./defaults.js";
+/* v8 ignore next 120 */ export var config = parser({
+    meta: import.meta,
+    examples: [
+        {
+            command: "comments src/**/*.ts",
+            comment: "## Reflow comments in all TS source files"
+        },
+        {
+            command: "comments --dry-run src/index.ts",
+            comment: "## Show diff for a single file without writing"
+        },
+        {
+            command: "comments --width 100 --merge-line-comments 'src/**/*.ts'",
+            comment: "## Use width 100 and merge groups of line comments"
+        },
+        {
+            command: "comments --no-line-wrap src/file.ts",
+            comment: "## Disable wrapping of // comments"
+        }
+    ],
+    flags: {
+        width: {
+            description: "Max output line width (default 80)",
+            type: "number",
+            default: defaultFlags.width
+        },
+        dryRun: {
+            shortFlag: "D",
+            description: "Show diff, don't write files (exit 1 if changes)",
+            type: "boolean"
+        },
+        stdout: {
+            description: "Print transformed output of a single file to STDOUT",
+            type: "boolean"
+        },
+        noLineWrap: {
+            description: "Disable wrapping of // single-line comments",
+            type: "boolean"
+        },
+        mergeLineComments: {
+            description: "Merge consecutive // lines into JSDoc blocks",
+            type: "boolean",
+            default: defaultFlags.mergeLineComments
+        },
+        boring: {
+            shortFlag: "b",
+            description: "Do not use color output",
+            type: "boolean"
+        },
+        help: {
+            shortFlag: "h",
+            description: "Display help instructions",
+            type: "boolean"
+        },
+        version: {
+            shortFlag: "v",
+            description: "Output the current version",
+            type: "boolean"
+        }
+    },
+    parameters: {
+        files: {
+            description: "File paths and/or glob patterns to process"
+        }
+    },
+    restrictions: [
+        {
+            exit: 1,
+            message: "You must provide at least one file path or glob pattern",
+            test: function(_flags, parameters) {
+                return Object.keys(parameters || {}).length === 0;
+            }
+        },
+        {
+            exit: 1,
+            message: "--stdout can only be used with a single file",
+            test: function(flags, parameters) {
+                return flags.stdout === true && parameters && Object.keys(parameters).length > 1;
+            }
+        }
+    ],
+    usage: "comments [options] <files...>"
+}); /* v8 ignore stop */ 
+
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parse.ts"],"sourcesContent":["/* v8 ignore start */\nimport { parser } from \"@node-cli/parser\";\nimport { defaultFlags } from \"./defaults.js\";\n\nexport type Flags = {\n\twidth?: number;\n\tdryRun?: boolean;\n\tstdout?: boolean;\n\tnoLineWrap?: boolean;\n\tmergeLineComments?: boolean;\n\tboring?: boolean;\n\thelp?: boolean;\n\tversion?: boolean;\n};\nexport type Parameters = {\n\tfiles?: string;\n};\nexport type Configuration = {\n\tflags?: Flags;\n\tparameters?: Parameters;\n\tshowHelp?: () => void;\n};\n\n/* v8 ignore next 120 */\nexport const config: Configuration = parser({\n\tmeta: import.meta,\n\texamples: [\n\t\t{\n\t\t\tcommand: \"comments src/**/*.ts\",\n\t\t\tcomment: \"## Reflow comments in all TS source files\",\n\t\t},\n\t\t{\n\t\t\tcommand: \"comments --dry-run src/index.ts\",\n\t\t\tcomment: \"## Show diff for a single file without writing\",\n\t\t},\n\t\t{\n\t\t\tcommand: \"comments --width 100 --merge-line-comments 'src/**/*.ts'\",\n\t\t\tcomment: \"## Use width 100 and merge groups of line comments\",\n\t\t},\n\t\t{\n\t\t\tcommand: \"comments --no-line-wrap src/file.ts\",\n\t\t\tcomment: \"## Disable wrapping of // comments\",\n\t\t},\n\t],\n\tflags: {\n\t\twidth: {\n\t\t\tdescription: \"Max output line width (default 80)\",\n\t\t\ttype: \"number\",\n\t\t\tdefault: defaultFlags.width,\n\t\t},\n\t\tdryRun: {\n\t\t\tshortFlag: \"D\",\n\t\t\tdescription: \"Show diff, don't write files (exit 1 if changes)\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t\tstdout: {\n\t\t\tdescription: \"Print transformed output of a single file to STDOUT\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t\tnoLineWrap: {\n\t\t\tdescription: \"Disable wrapping of // single-line comments\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t\tmergeLineComments: {\n\t\t\tdescription: \"Merge consecutive // lines into JSDoc blocks\",\n\t\t\ttype: \"boolean\",\n\t\t\tdefault: defaultFlags.mergeLineComments,\n\t\t},\n\t\tboring: {\n\t\t\tshortFlag: \"b\",\n\t\t\tdescription: \"Do not use color output\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t\thelp: {\n\t\t\tshortFlag: \"h\",\n\t\t\tdescription: \"Display help instructions\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t\tversion: {\n\t\t\tshortFlag: \"v\",\n\t\t\tdescription: \"Output the current version\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t},\n\tparameters: {\n\t\tfiles: {\n\t\t\tdescription: \"File paths and/or glob patterns to process\",\n\t\t},\n\t},\n\trestrictions: [\n\t\t{\n\t\t\texit: 1,\n\t\t\tmessage: \"You must provide at least one file path or glob pattern\",\n\t\t\ttest: (_flags: Flags, parameters: Record<string, string>) =>\n\t\t\t\tObject.keys(parameters || {}).length === 0,\n\t\t},\n\t\t{\n\t\t\texit: 1,\n\t\t\tmessage: \"--stdout can only be used with a single file\",\n\t\t\ttest: (flags: Flags, parameters: Record<string, string>) =>\n\t\t\t\tflags.stdout === true &&\n\t\t\t\tparameters &&\n\t\t\t\tObject.keys(parameters).length > 1,\n\t\t},\n\t],\n\tusage: \"comments [options] <files...>\",\n});\n/* v8 ignore stop */\n"],"names":["parser","defaultFlags","config","meta","examples","command","comment","flags","width","description","type","default","dryRun","shortFlag","stdout","noLineWrap","mergeLineComments","boring","help","version","parameters","files","restrictions","exit","message","test","_flags","Object","keys","length","usage"],"mappings":"AAAA,mBAAmB,GACnB,SAASA,MAAM,QAAQ,mBAAmB;AAC1C,SAASC,YAAY,QAAQ,gBAAgB;AAqB7C,sBAAsB,GACtB,OAAO,IAAMC,SAAwBF,OAAO;IAC3CG,MAAM;IACNC,UAAU;QACT;YACCC,SAAS;YACTC,SAAS;QACV;QACA;YACCD,SAAS;YACTC,SAAS;QACV;QACA;YACCD,SAAS;YACTC,SAAS;QACV;QACA;YACCD,SAAS;YACTC,SAAS;QACV;KACA;IACDC,OAAO;QACNC,OAAO;YACNC,aAAa;YACbC,MAAM;YACNC,SAASV,aAAaO,KAAK;QAC5B;QACAI,QAAQ;YACPC,WAAW;YACXJ,aAAa;YACbC,MAAM;QACP;QACAI,QAAQ;YACPL,aAAa;YACbC,MAAM;QACP;QACAK,YAAY;YACXN,aAAa;YACbC,MAAM;QACP;QACAM,mBAAmB;YAClBP,aAAa;YACbC,MAAM;YACNC,SAASV,aAAae,iBAAiB;QACxC;QACAC,QAAQ;YACPJ,WAAW;YACXJ,aAAa;YACbC,MAAM;QACP;QACAQ,MAAM;YACLL,WAAW;YACXJ,aAAa;YACbC,MAAM;QACP;QACAS,SAAS;YACRN,WAAW;YACXJ,aAAa;YACbC,MAAM;QACP;IACD;IACAU,YAAY;QACXC,OAAO;YACNZ,aAAa;QACd;IACD;IACAa,cAAc;QACb;YACCC,MAAM;YACNC,SAAS;YACTC,MAAM,SAACC,QAAeN;uBACrBO,OAAOC,IAAI,CAACR,cAAc,CAAC,GAAGS,MAAM,KAAK;;QAC3C;QACA;YACCN,MAAM;YACNC,SAAS;YACTC,MAAM,SAAClB,OAAca;uBACpBb,MAAMO,MAAM,KAAK,QACjBM,cACAO,OAAOC,IAAI,CAACR,YAAYS,MAAM,GAAG;;QACnC;KACA;IACDC,OAAO;AACR,GAAG,CACH,kBAAkB"}

package/package.json

@@ -0,0 +1,41 @@
+{
+	"name": "@node-cli/comments",
+	"version": "0.1.0",
+	"license": "MIT",
+	"author": "Arno Versini",
+	"description": "CLI tool to reflow and normalize JSDoc and line comments in source files",
+	"type": "module",
+	"types": "./dist/index.d.ts",
+	"exports": "./dist/lib.js",
+	"bin": "dist/comments.js",
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"node": ">=18",
+	"scripts": {
+		"build": "npm-run-all --serial clean build:types build:js build:barrel",
+		"build:barrel": "barrelsby --delete --directory dist --pattern \"**/*.d.ts\" --name \"index.d\"",
+		"build:js": "swc --strip-leading-paths --source-maps --out-dir dist src",
+		"build:types": "tsc",
+		"clean": "rimraf dist types coverage",
+		"lint": "biome lint src",
+		"test": "vitest run --globals",
+		"test:coverage": "vitest run --coverage --globals",
+		"test:watch": "vitest --globals",
+		"watch": "swc --strip-leading-paths --watch --out-dir dist src"
+	},
+	"dependencies": {
+		"@node-cli/logger": "../logger",
+		"@node-cli/parser": "../parser",
+		"@node-cli/utilities": "../utilities"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"devDependencies": {
+		"@vitest/coverage-v8": "3.2.4",
+		"vitest": "3.2.4"
+	},
+	"gitHead": "8fa2b0048fd24b0278b446a9291fb78506041c05"
+}