@macrulez/devtoolz 0.1.0

package/dist/commands/readme-check/tsconfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig.js","sourceRoot":"","sources":["../../../src/commands/readme-check/tsconfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAC3B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAS5C,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,gBAAyB;IAEzB,MAAM,UAAU,GAAG,gBAAgB;QACjC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,gBAAgB,CAAC;QACvC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,eAAe,CAAC,CAAA;IAErE,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAClD,OAAO;YACL,KAAK,EAAE,gCAAgC,UAAU,oDAAoD;SACtG,CAAA;IACH,CAAC;IAED,MAAM,IAAI,GAAG,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC3D,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAA;IACjF,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;IACtF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM;iBACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,4BAA4B,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;iBAChE,IAAI,CAAC,IAAI,CAAC;SACd,CAAA;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,CAAA;AAChD,CAAC"}

package/dist/commands/readme-check/typecheck.d.ts

@@ -0,0 +1,31 @@
+import ts from 'typescript';
+export interface BlockDiagnostic {
+    /** 0-based line WITHIN the block's own code, matches ts.LineAndCharacter */
+    line: number;
+    character: number;
+    message: string;
+    category: 'error' | 'warning';
+    /** TS diagnostic code, e.g. 2304 for "Cannot find name" — lets a caller filter by known-noisy codes */
+    code: number;
+}
+/**
+ * Typechecks one code block in complete isolation against the target
+ * package's real types — no code is ever executed, only compiled. The
+ * block is presented to the compiler as a virtual file sitting AT THE
+ * PACKAGE ROOT (same directory as package.json), which is what lets both
+ * relative imports (`./dist/foo`) and self-referencing package-name
+ * imports (`import { x } from '@scope/this-same-package'`) resolve
+ * exactly as they would for a real consumer — Node/TS's self-reference
+ * resolution walks up from the importing FILE's real directory looking
+ * for the nearest package.json, and that lookup hits the real one on
+ * disk since only `getSourceFile`/`fileExists`/`readFile` are overridden
+ * for the single virtual path; everything else delegates to the real
+ * filesystem via `ts.createCompilerHost`.
+ *
+ * Returns null when `lang` isn't a checkable language (block is skipped
+ * upstream), otherwise the list of diagnostics raised for THIS file only
+ * — diagnostics whose `file` is some OTHER file pulled into the module
+ * graph (e.g. a real type error inside the package's own .d.ts) are not
+ * this block's fault and are filtered out.
+ */
+export declare function typecheckBlock(code: string, lang: string, packageDir: string, baseOptions: ts.CompilerOptions): BlockDiagnostic[] | null;

package/dist/commands/readme-check/typecheck.js

@@ -0,0 +1,82 @@
+import ts from 'typescript';
+import { join } from 'node:path';
+import { resolveLangInfo } from './lang.js';
+/**
+ * Typechecks one code block in complete isolation against the target
+ * package's real types — no code is ever executed, only compiled. The
+ * block is presented to the compiler as a virtual file sitting AT THE
+ * PACKAGE ROOT (same directory as package.json), which is what lets both
+ * relative imports (`./dist/foo`) and self-referencing package-name
+ * imports (`import { x } from '@scope/this-same-package'`) resolve
+ * exactly as they would for a real consumer — Node/TS's self-reference
+ * resolution walks up from the importing FILE's real directory looking
+ * for the nearest package.json, and that lookup hits the real one on
+ * disk since only `getSourceFile`/`fileExists`/`readFile` are overridden
+ * for the single virtual path; everything else delegates to the real
+ * filesystem via `ts.createCompilerHost`.
+ *
+ * Returns null when `lang` isn't a checkable language (block is skipped
+ * upstream), otherwise the list of diagnostics raised for THIS file only
+ * — diagnostics whose `file` is some OTHER file pulled into the module
+ * graph (e.g. a real type error inside the package's own .d.ts) are not
+ * this block's fault and are filtered out.
+ */
+export function typecheckBlock(code, lang, packageDir, baseOptions) {
+    const langInfo = resolveLangInfo(lang);
+    if (!langInfo)
+        return null;
+    // TypeScript normalizes every file path it works with to forward
+    // slashes internally, even on Windows — comparing against a
+    // `path.join`-built name (backslashes on win32) would never match what
+    // the compiler actually passes back into `getSourceFile`/`fileExists`,
+    // silently turning every block into a false "file not found", 0
+    // diagnostics ever produced. Caught by an isolated repro against a real
+    // package before writing tests, not by the tests themselves.
+    const virtualFileName = join(packageDir, `__devtoolz_readme_check__${langInfo.extension}`).replace(/\\/g, '/');
+    const options = {
+        ...baseOptions,
+        noEmit: true,
+        skipLibCheck: true,
+        ...(langInfo.needsAllowJs ? { allowJs: true, checkJs: true } : {}),
+    };
+    const baseHost = ts.createCompilerHost(options);
+    const virtualSourceFile = ts.createSourceFile(virtualFileName, code, ts.ScriptTarget.Latest, true, langInfo.scriptKind);
+    const host = {
+        ...baseHost,
+        getSourceFile(fileName, languageVersionOrOptions, onError, shouldCreateNewSourceFile) {
+            if (fileName === virtualFileName)
+                return virtualSourceFile;
+            return baseHost.getSourceFile(fileName, languageVersionOrOptions, onError, shouldCreateNewSourceFile);
+        },
+        fileExists(fileName) {
+            if (fileName === virtualFileName)
+                return true;
+            return baseHost.fileExists(fileName);
+        },
+        readFile(fileName) {
+            if (fileName === virtualFileName)
+                return code;
+            return baseHost.readFile(fileName);
+        },
+        writeFile() {
+            // noEmit is always forced above — never actually called, kept as a safe no-op
+        },
+    };
+    const program = ts.createProgram({ rootNames: [virtualFileName], options, host });
+    const diagnostics = ts
+        .getPreEmitDiagnostics(program)
+        .filter((d) => d.file?.fileName === virtualFileName);
+    return diagnostics.map((d) => {
+        const pos = d.file && d.start !== undefined
+            ? d.file.getLineAndCharacterOfPosition(d.start)
+            : { line: 0, character: 0 };
+        return {
+            line: pos.line,
+            character: pos.character,
+            message: ts.flattenDiagnosticMessageText(d.messageText, '\n'),
+            category: d.category === ts.DiagnosticCategory.Error ? 'error' : 'warning',
+            code: d.code,
+        };
+    });
+}
+//# sourceMappingURL=typecheck.js.map

package/dist/commands/readme-check/typecheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typecheck.js","sourceRoot":"","sources":["../../../src/commands/readme-check/typecheck.ts"],"names":[],"mappings":"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"}

package/dist/commands/strip-comments/apply-deletions.d.ts

@@ -0,0 +1,17 @@
+export type Range = [start: number, end: number];
+export declare function lineBoundsAllWhitespace(text: string, start: number, end: number): {
+    lineStart: number;
+    lineEnd: number;
+    beforeIsWs: boolean;
+    afterIsWs: boolean;
+};
+/**
+ * Deletes `ranges` from `text`. A range that has nothing but whitespace
+ * before and after it on its own line is treated as a whole-line
+ * comment — its entire line, including the trailing newline, is removed,
+ * so no blank line is left behind. Otherwise, only the range itself plus
+ * the run of spaces/tabs immediately before it is removed, keeping real
+ * code that shares its line intact.
+ */
+export declare function applyDeletions(text: string, ranges: Range[]): string;
+export declare function collapseBlankLineRuns(text: string): string;

package/dist/commands/strip-comments/apply-deletions.js

@@ -0,0 +1,74 @@
+// Shared "delete these ranges, but a whole-line comment takes its newline
+// with it" logic — used by core.ts (real TS comment tokens) and vue.ts
+// (regex-matched `<!-- -->` in a <template> block). Checking whole-line-
+// ness against the SURROUNDING TEXT (not just the matched substring in
+// isolation) matters: a substring-only check misclassifies a trailing
+// inline comment as "whole line" whenever the comment itself, in
+// isolation, happens to look like one (leading/trailing whitespace) even
+// though real content precedes it on the same source line — a real bug
+// found via testing in the original draft this package is based on.
+export function lineBoundsAllWhitespace(text, start, end) {
+    let lineStart = start;
+    while (lineStart > 0 && text[lineStart - 1] !== '\n')
+        lineStart--;
+    const beforeIsWs = /^[ \t]*$/.test(text.slice(lineStart, start));
+    let lineEnd = end;
+    while (lineEnd < text.length && text[lineEnd] !== '\n')
+        lineEnd++;
+    const afterIsWs = /^[ \t\r]*$/.test(text.slice(end, lineEnd));
+    return { lineStart, lineEnd, beforeIsWs, afterIsWs };
+}
+/**
+ * Deletes `ranges` from `text`. A range that has nothing but whitespace
+ * before and after it on its own line is treated as a whole-line
+ * comment — its entire line, including the trailing newline, is removed,
+ * so no blank line is left behind. Otherwise, only the range itself plus
+ * the run of spaces/tabs immediately before it is removed, keeping real
+ * code that shares its line intact.
+ */
+export function applyDeletions(text, ranges) {
+    if (ranges.length === 0)
+        return text;
+    const deletions = [];
+    for (const [start, end] of ranges) {
+        const { lineStart, lineEnd, beforeIsWs, afterIsWs } = lineBoundsAllWhitespace(text, start, end);
+        if (beforeIsWs && afterIsWs) {
+            const delEnd = lineEnd < text.length && text[lineEnd] === '\n' ? lineEnd + 1 : lineEnd;
+            deletions.push([lineStart, delEnd]);
+        }
+        else {
+            let s = start;
+            while (s > 0 && (text[s - 1] === ' ' || text[s - 1] === '\t'))
+                s--;
+            deletions.push([s, end]);
+        }
+    }
+    deletions.sort((a, b) => a[0] - b[0]);
+    const merged = [];
+    for (const d of deletions) {
+        const last = merged[merged.length - 1];
+        if (last && d[0] <= last[1]) {
+            last[1] = Math.max(last[1], d[1]);
+        }
+        else {
+            merged.push(d);
+        }
+    }
+    let out = '';
+    let cursor = 0;
+    for (const [s, e] of merged) {
+        out += text.slice(cursor, s);
+        cursor = e;
+    }
+    out += text.slice(cursor);
+    return out;
+}
+// Collapses 3+ consecutive blank lines to one — `\r?` around each `\n` so
+// a stray `\r` (CRLF files) doesn't survive between the newlines and
+// defeat the collapse, and the replacement matches whichever line ending
+// the matched stretch itself used, so a CRLF file doesn't end up with
+// LF-only gaps mixed in.
+export function collapseBlankLineRuns(text) {
+    return text.replace(/(?:\r?\n){3,}/g, (match) => (match.includes('\r') ? '\r\n\r\n' : '\n\n'));
+}
+//# sourceMappingURL=apply-deletions.js.map

package/dist/commands/strip-comments/apply-deletions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-deletions.js","sourceRoot":"","sources":["../../../src/commands/strip-comments/apply-deletions.ts"],"names":[],"mappings":"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"}

package/dist/commands/strip-comments/core.d.ts

@@ -0,0 +1,15 @@
+import ts from 'typescript';
+export interface StripCommentsOptions {
+    /** ts.ScriptKind.TS (default) or ts.ScriptKind.JS — pass JS for plain .js/.cjs/.mjs files */
+    scriptKind?: ts.ScriptKind;
+    /** don't delete a /** *\/ comment immediately above an exported declaration. default false */
+    keepJsdoc?: boolean;
+}
+export interface StripCommentsResult {
+    text: string;
+    /** true if anything was actually deleted — lets callers skip a no-op write */
+    changed: boolean;
+    /** how many individual comments were removed (before adjacent ones get merged into one deletion) */
+    count: number;
+}
+export declare function stripComments(text: string, options?: StripCommentsOptions): StripCommentsResult;

package/dist/commands/strip-comments/core.js

@@ -0,0 +1,111 @@
+// Core comment-stripping logic for a single TS/JS source string. Ported
+// from the working draft at C:\work\Наработки\strip-comments — same
+// approach, same guarantees, now with `keepJsdoc` added on top (the draft
+// didn't have it — see features.md's strip-comments edge cases).
+//
+// Why not a naive regex or a plain `ts.createScanner` loop: without full
+// parser context, a raw scanner can't tell a regex literal's `/` from a
+// comment-start `/` (e.g. `/^\/([^/]+)\//`), and can't tell `//` inside a
+// template literal (e.g. `` `${url.protocol}//${url.hostname}` ``) from a
+// real line comment either — both cases silently corrupt the file. This
+// fully parses the source first to find every string/template/regex/JSX
+// text span, masks their contents (same length, so positions don't
+// shift), then scans the masked copy for comments and deletes those exact
+// byte ranges from the ORIGINAL text. No re-printing/reformatting —
+// everything outside a comment is byte-identical to the input.
+import ts from 'typescript';
+import { applyDeletions, collapseBlankLineRuns } from './apply-deletions.js';
+const LITERAL_KINDS = new Set([
+    ts.SyntaxKind.StringLiteral,
+    ts.SyntaxKind.NoSubstitutionTemplateLiteral,
+    ts.SyntaxKind.TemplateHead,
+    ts.SyntaxKind.TemplateMiddle,
+    ts.SyntaxKind.TemplateTail,
+    ts.SyntaxKind.RegularExpressionLiteral,
+    ts.SyntaxKind.JsxText,
+]);
+function findLiteralRanges(sf) {
+    const ranges = [];
+    function visit(node) {
+        if (LITERAL_KINDS.has(node.kind)) {
+            ranges.push([node.getStart(sf), node.getEnd()]);
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sf);
+    return ranges;
+}
+function maskLiterals(text, ranges) {
+    // `ts.SourceFile` positions are UTF-16 CODE UNIT offsets (same as
+    // `string.length`/`charAt`) — `[...text]`/`Array.from(text)` iterate by
+    // CODE POINT instead, collapsing any surrogate pair (an emoji, or any
+    // character outside the BMP) into a single array element. The moment a
+    // literal masked earlier in the file contains one, every position after
+    // it drifts by one (or more) index, and later deletions land on the
+    // wrong bytes entirely. `split('')` is UTF-16-code-unit based — it
+    // splits a surrogate pair into its two halves instead of merging them,
+    // which is exactly what keeps this array's indices aligned with the
+    // parser's.
+    const chars = text.split('');
+    for (const [s, e] of ranges) {
+        for (let i = s; i < e; i++) {
+            if (chars[i] !== '\n')
+                chars[i] = 'x';
+        }
+    }
+    return chars.join('');
+}
+function findCommentRanges(maskedText) {
+    const ranges = [];
+    const scanner = ts.createScanner(ts.ScriptTarget.Latest, false, ts.LanguageVariant.Standard, maskedText);
+    let tok = scanner.scan();
+    while (tok !== ts.SyntaxKind.EndOfFileToken) {
+        if (tok === ts.SyntaxKind.SingleLineCommentTrivia ||
+            tok === ts.SyntaxKind.MultiLineCommentTrivia) {
+            ranges.push([scanner.getTokenStart(), scanner.getTokenEnd()]);
+        }
+        tok = scanner.scan();
+    }
+    return ranges;
+}
+// Every `/** ... */` immediately leading an `export`-modified declaration
+// — these are what `keepJsdoc` protects from deletion. Only JSDoc-style
+// (`/**`, not a plain `/*`) counts, matching the convention IDEs actually
+// read tooltips from.
+function findExportedJsdocRanges(sf, text) {
+    const ranges = [];
+    function visit(node) {
+        const hasExportModifier = ts.canHaveModifiers(node) &&
+            ts.getModifiers(node)?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+        if (hasExportModifier) {
+            const leading = ts.getLeadingCommentRanges(text, node.getFullStart()) ?? [];
+            for (const c of leading) {
+                if (c.kind === ts.SyntaxKind.MultiLineCommentTrivia &&
+                    text.slice(c.pos, c.pos + 3) === '/**') {
+                    ranges.push([c.pos, c.end]);
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sf);
+    return ranges;
+}
+export function stripComments(text, options = {}) {
+    const scriptKind = options.scriptKind ?? ts.ScriptKind.TS;
+    const sf = ts.createSourceFile('f.ts', text, ts.ScriptTarget.Latest, true, scriptKind);
+    const literalRanges = findLiteralRanges(sf);
+    const masked = maskLiterals(text, literalRanges);
+    let comments = findCommentRanges(masked);
+    if (comments.length === 0)
+        return { text, changed: false, count: 0 };
+    if (options.keepJsdoc) {
+        const protectedRanges = new Set(findExportedJsdocRanges(sf, text).map(([s, e]) => `${s}:${e}`));
+        comments = comments.filter(([s, e]) => !protectedRanges.has(`${s}:${e}`));
+        if (comments.length === 0)
+            return { text, changed: false, count: 0 };
+    }
+    const out = collapseBlankLineRuns(applyDeletions(text, comments));
+    return { text: out, changed: true, count: comments.length };
+}
+//# sourceMappingURL=core.js.map

package/dist/commands/strip-comments/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/commands/strip-comments/core.ts"],"names":[],"mappings":"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"}

package/dist/commands/strip-comments/report.d.ts

@@ -0,0 +1,6 @@
+import { type VibesOptions } from '../../format/vibes.js';
+import type { StripCommentsReport } from './run.js';
+export interface RenderOptions extends VibesOptions {
+    dryRun?: boolean;
+}
+export declare function renderStripCommentsReport(report: StripCommentsReport, options?: RenderOptions): string;

package/dist/commands/strip-comments/report.js

@@ -0,0 +1,30 @@
+import { banner, cleanCelebration } from '../../format/vibes.js';
+import { formatFileCountRows } from '../../format/file-list.js';
+import { renderDiffForHumans } from '../../format/diff-render.js';
+export function renderStripCommentsReport(report, options = {}) {
+    if (options.quiet && report.changes.length === 0)
+        return '';
+    const lines = [];
+    if (!options.quiet && !options.plain)
+        lines.push(banner(), '');
+    lines.push(`Scanned ${report.filesScanned} file${report.filesScanned === 1 ? '' : 's'}.`, '');
+    if (report.changes.length === 0) {
+        lines.push(cleanCelebration(options));
+        return lines.join('\n');
+    }
+    const verb = report.applied ? 'Stripped comments in' : 'Would strip comments in';
+    lines.push(`${verb} ${report.changes.length} file(s):`);
+    lines.push(...formatFileCountRows(report.changes, (n) => `comment${n === 1 ? '' : 's'}`, options));
+    if (!report.applied) {
+        const diffHint = report.changes.some((c) => c.diff) ? '' : ', or --diff to see exactly what';
+        lines.push('', `(nothing written — pass -y to apply${diffHint}, or --dry-run to keep previewing)`);
+    }
+    for (const change of report.changes) {
+        if (!change.diff)
+            continue;
+        const unit = `comment${change.count === 1 ? '' : 's'}`;
+        lines.push('', renderDiffForHumans(change.file, change.count, unit, change.diff, options));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/commands/strip-comments/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/commands/strip-comments/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAqB,MAAM,uBAAuB,CAAA;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAOjE,MAAM,UAAU,yBAAyB,CACvC,MAA2B,EAC3B,UAAyB,EAAE;IAE3B,IAAI,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAE3D,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;IAE9D,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,YAAY,QAAQ,MAAM,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAA;IAE7F,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,yBAAyB,CAAA;IAChF,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,WAAW,CAAC,CAAA;IACvD,KAAK,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;IAElG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iCAAiC,CAAA;QAC5F,KAAK,CAAC,IAAI,CACR,EAAE,EACF,sCAAsC,QAAQ,oCAAoC,CACnF,CAAA;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,SAAQ;QAC1B,MAAM,IAAI,GAAG,UAAU,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;QACtD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAC5F,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/commands/strip-comments/run.d.ts

@@ -0,0 +1,28 @@
+export interface StripCommentsRunOptions {
+    paths: string[];
+    cwd: string;
+    extensions?: string[];
+    ignoreGlobs?: string[];
+    respectGitignore?: boolean;
+    keepJsdoc?: boolean;
+    /** show what would change, write nothing */
+    dryRun?: boolean;
+    /** actually write changes to disk — without this OR dryRun, behaves as a preview (nothing written) */
+    yes?: boolean;
+    /** include a unified diff per changed file in the report */
+    diff?: boolean;
+}
+export interface StripCommentsFileChange {
+    file: string;
+    /** how many individual comments were removed from this file */
+    count: number;
+    diff?: string;
+}
+export interface StripCommentsReport {
+    filesScanned: number;
+    changes: StripCommentsFileChange[];
+    /** true if changes were actually written to disk */
+    applied: boolean;
+    exitCode: number;
+}
+export declare function runStripComments(options: StripCommentsRunOptions): StripCommentsReport;

package/dist/commands/strip-comments/run.js

@@ -0,0 +1,50 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { relative } from 'node:path';
+import ts from 'typescript';
+import { walk } from '../../utils/walk.js';
+import { unifiedDiff } from '../../utils/diff.js';
+import { stripComments } from './core.js';
+import { stripVueComments } from './vue.js';
+const DEFAULT_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.cjs', '.mjs', '.vue'];
+function scriptKindFor(file) {
+    return file.endsWith('.ts') || file.endsWith('.tsx') ? ts.ScriptKind.TS : ts.ScriptKind.JS;
+}
+export function runStripComments(options) {
+    const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+    const files = walk(options.paths, {
+        cwd: options.cwd,
+        extensions,
+        ...(options.ignoreGlobs ? { ignoreGlobs: options.ignoreGlobs } : {}),
+        ...(options.respectGitignore !== undefined
+            ? { respectGitignore: options.respectGitignore }
+            : {}),
+    });
+    const willApply = options.yes === true && options.dryRun !== true;
+    const changes = [];
+    for (const file of files) {
+        const before = readFileSync(file, 'utf8');
+        const result = file.endsWith('.vue')
+            ? stripVueComments(before, { keepJsdoc: options.keepJsdoc ?? false })
+            : stripComments(before, {
+                scriptKind: scriptKindFor(file),
+                keepJsdoc: options.keepJsdoc ?? false,
+            });
+        if (!result.changed)
+            continue;
+        const relFile = relative(options.cwd, file).split('\\').join('/');
+        const change = { file: relFile, count: result.count };
+        if (options.diff)
+            change.diff = unifiedDiff(relFile, before, result.text);
+        changes.push(change);
+        if (willApply)
+            writeFileSync(file, result.text);
+    }
+    const exitCode = !willApply && changes.length > 0 ? 1 : 0;
+    return {
+        filesScanned: files.length,
+        changes,
+        applied: willApply,
+        exitCode,
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/strip-comments/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/strip-comments/run.ts"],"names":[],"mappings":"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"}

package/dist/commands/strip-comments/vue.d.ts

@@ -0,0 +1,6 @@
+import { type StripCommentsOptions } from './core.js';
+export declare function stripVueComments(text: string, options?: StripCommentsOptions): {
+    text: string;
+    changed: boolean;
+    count: number;
+};

package/dist/commands/strip-comments/vue.js

@@ -0,0 +1,65 @@
+// `.vue` handling: the `<script>` block goes through the real TS-parser
+// path in core.ts (safe against strings/templates/regex inside it); the
+// `<template>` block's `<!-- -->` comments go through the same
+// line-aware deletion helper as core.ts, just fed regex-matched comment
+// ranges instead of TS scanner tokens — there's no full Vue SFC template
+// parser here, so a `<!-- -->`-looking sequence INSIDE a bound attribute
+// string (e.g. `:title="'<!-- x -->'"`) would still be misread as a real
+// comment. Known limitation, documented in features.md — not something
+// fixable without a real template parser, which is out of scope here.
+import ts from 'typescript';
+import { stripComments } from './core.js';
+import { applyDeletions, collapseBlankLineRuns } from './apply-deletions.js';
+const SCRIPT_RE = /(<script[^>]*>)([\s\S]*?)(<\/script>)/;
+const TEMPLATE_RE = /(<template[^>]*>)([\s\S]*?)(<\/template>)/;
+const TEMPLATE_COMMENT_RE = /<!--[\s\S]*?-->/g;
+function stripTemplateComments(body) {
+    const ranges = [];
+    for (const match of body.matchAll(TEMPLATE_COMMENT_RE)) {
+        const start = match.index;
+        ranges.push([start, start + match[0].length]);
+    }
+    if (ranges.length === 0)
+        return { text: body, changed: false, count: 0 };
+    return {
+        text: collapseBlankLineRuns(applyDeletions(body, ranges)),
+        changed: true,
+        count: ranges.length,
+    };
+}
+export function stripVueComments(text, options = {}) {
+    let changed = false;
+    let count = 0;
+    const scriptMatch = text.match(SCRIPT_RE);
+    if (scriptMatch) {
+        const [whole, open, body, close] = scriptMatch;
+        const result = stripComments(body, { ...options, scriptKind: ts.ScriptKind.TS });
+        if (result.changed) {
+            changed = true;
+            count += result.count;
+            text =
+                text.slice(0, scriptMatch.index) +
+                    open +
+                    result.text +
+                    close +
+                    text.slice(scriptMatch.index + whole.length);
+        }
+    }
+    const templateMatch = text.match(TEMPLATE_RE);
+    if (templateMatch) {
+        const [whole, open, body, close] = templateMatch;
+        const result = stripTemplateComments(body);
+        if (result.changed) {
+            changed = true;
+            count += result.count;
+            text =
+                text.slice(0, templateMatch.index) +
+                    open +
+                    result.text +
+                    close +
+                    text.slice(templateMatch.index + whole.length);
+        }
+    }
+    return { text, changed, count };
+}
+//# sourceMappingURL=vue.js.map

package/dist/commands/strip-comments/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","sourceRoot":"","sources":["../../../src/commands/strip-comments/vue.ts"],"names":[],"mappings":"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"}

package/dist/format/colors.d.ts

@@ -0,0 +1,8 @@
+export declare const RESET = "\u001B[0m";
+export declare const BOLD = "\u001B[1m";
+export declare const DIM = "\u001B[2m";
+export declare const RED = "\u001B[31m";
+export declare const GREEN = "\u001B[32m";
+export declare const CYAN = "\u001B[36m";
+export declare const WHITE = "\u001B[97m";
+export declare function colorize(color: string, text: string): string;

package/dist/format/colors.js

@@ -0,0 +1,14 @@
+// Minimal ANSI palette — no chalk/picocolors dependency for a handful of
+// escape codes. Every caller gates these behind `isFancyOutputEnabled()`
+// from vibes.ts, never applied unconditionally.
+export const RESET = '\x1b[0m';
+export const BOLD = '\x1b[1m';
+export const DIM = '\x1b[2m';
+export const RED = '\x1b[31m';
+export const GREEN = '\x1b[32m';
+export const CYAN = '\x1b[36m';
+export const WHITE = '\x1b[97m';
+export function colorize(color, text) {
+    return `${color}${text}${RESET}`;
+}
+//# sourceMappingURL=colors.js.map

package/dist/format/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/format/colors.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,yEAAyE;AACzE,gDAAgD;AAChD,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAA;AAC9B,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAA;AAC7B,MAAM,CAAC,MAAM,GAAG,GAAG,SAAS,CAAA;AAC5B,MAAM,CAAC,MAAM,GAAG,GAAG,UAAU,CAAA;AAC7B,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAAA;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,CAAA;AAC9B,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAAA;AAE/B,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,IAAY;IAClD,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,EAAE,CAAA;AAClC,CAAC"}

package/dist/format/diff-render.d.ts

@@ -0,0 +1,2 @@
+import { type VibesOptions } from './vibes.js';
+export declare function renderDiffForHumans(file: string, count: number, unit: string, patch: string, options?: VibesOptions): string;