@kgdiff/cli 0.0.0-stage → 0.2.0

package/dist/markdown.js

@@ -0,0 +1,93 @@
+/**
+ * GitHub-flavoured Markdown summary for PR comments and `$GITHUB_STEP_SUMMARY`
+ * (docs/cli.md §Markdown summary): title, diffstat table, family legend and the hunk list
+ * grouped by phase in `<details>` blocks. No HTML beyond `<details>` / `<summary>`.
+ */
+import { formatHunk } from '@kgdiff/core';
+import { formatInt, messages } from './locale.js';
+import { groupByPhase, hunkFamily, hunkGlyph, overview } from './model.js';
+import { totalsText } from './summary.js';
+import { revealInvisible } from './width.js';
+/** Hunks listed before "…and N more". */
+export const MARKDOWN_HUNK_LIMIT = 100;
+/** Groups start expanded when the whole list is at most this long. */
+const OPEN_THRESHOLD = 30;
+const FAMILY_SQUARE = {
+    added: '🟩',
+    removed: '🟥',
+    content: '🟨',
+    structure: '🟦',
+    identity: '🟪',
+};
+/** Zero-width space: invisible, but enough to stop GitHub's autolinkers and filters. */
+const ZWSP = '\u200B';
+/**
+ * Escape untrusted text for inline GFM.
+ *
+ * 1. Invisible and bidirectional controls become a visible `⟨U+202E⟩`; C0 controls and line
+ *    breaks become spaces; C1 controls are dropped.
+ * 2. GitHub's post-Markdown filters are defused first (they act on the rendered text, so
+ *    escaping alone does not stop them): a zero-width space breaks `:shortcode:` emoji,
+ *    `@mentions`, `#123` / `org/repo#123` / `GH-123` references, bare `scheme://` URLs and
+ *    `www.` autolinks.
+ * 3. Markdown punctuation (backslash, backtick, `*`, `_`, brackets, `|`, `~`, `#`, `$` for math)
+ *    is backslash-escaped; `<`, `>` and `&` become entities, so no raw HTML gets through.
+ */
+export function escapeMarkdown(text) {
+    return (revealInvisible(text)
+        // biome-ignore lint/suspicious/noControlCharactersInRegex: control characters are replaced on purpose.
+        .replace(/[\u0000-\u001f\u2028\u2029]+/g, ' ')
+        .replace(/[\u007f-\u009f]/g, '')
+        .replace(/:([a-z0-9_+-]+):/gi, `:${ZWSP}$1:`)
+        .replace(/\b(GH)-(?=\d)/gi, `$1${ZWSP}-`)
+        .replace(/([@#])(?=[\p{L}\p{N}_])/gu, `$1${ZWSP}`)
+        .replace(/:\/\//g, `://${ZWSP}`)
+        .replace(/\b(www)\./gi, `$1${ZWSP}.`)
+        .replace(/[\\`*_[\]|~#$]/g, '\\$&')
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .trim());
+}
+/** Render the Markdown summary. Deterministic: no timestamps. */
+export function renderMarkdown(diff, options) {
+    const m = messages(options.locale);
+    const ov = overview(diff);
+    const out = [`## kgdiff · ${escapeMarkdown(options.title)}`, ''];
+    const totals = escapeMarkdown(totalsText(diff, m));
+    if (ov.hunks === 0) {
+        const detail = m.identicalDetail(diff.stats.after.nodes, diff.stats.after.edges);
+        out.push(`✅ **${m.identical}.** ${escapeMarkdown(detail)}`, '');
+    }
+    else {
+        out.push(`**${escapeMarkdown(m.changes(ov.changes, ov.hunks))}** · ${totals}`, '');
+        // Table cells are sentence-cased (a no-op for Chinese).
+        const t = Object.fromEntries(Object.entries(m.table).map(([k, v]) => [k, v.charAt(0).toUpperCase() + v.slice(1)]));
+        const { nodes, edges, before, after } = diff.stats;
+        const pair = (b, a) => `${formatInt(b)} → ${formatInt(a)}`;
+        out.push(`| | ${t.added} | ${t.removed} | ${t.modified} | ${t.unchanged} | ${t.total} |`, '| :-- | --: | --: | --: | --: | --: |', `| **${t.nodes}** | ${formatInt(nodes.added)} | ${formatInt(nodes.removed)} | ${formatInt(nodes.modified)} | ${formatInt(nodes.unchanged)} | ${pair(before.nodes, after.nodes)} |`, `| **${t.edges}** | ${formatInt(edges.added)} | ${formatInt(edges.removed)} | ${formatInt(edges.modified)} | ${formatInt(edges.unchanged)} | ${pair(before.edges, after.edges)} |`, '', m.markdown.legend, '');
+        let budget = MARKDOWN_HUNK_LIMIT;
+        const open = ov.hunks <= OPEN_THRESHOLD ? ' open' : '';
+        for (const group of groupByPhase(diff.hunks)) {
+            if (budget <= 0)
+                break;
+            const listed = group.hunks.slice(0, budget);
+            budget -= listed.length;
+            out.push(`<details${open}>`, `<summary>${m.phase[group.phase]} (${formatInt(group.hunks.length)})</summary>`, '');
+            for (const hunk of listed) {
+                const { title, subtitle } = formatHunk(hunk, diff, options.locale);
+                const family = hunkFamily(hunk);
+                const glyph = hunkGlyph(hunk) === '~' ? '\\~' : hunkGlyph(hunk);
+                const note = subtitle ? ` — *${escapeMarkdown(subtitle)}*` : '';
+                out.push(`- ${FAMILY_SQUARE[family]} ${glyph} ${escapeMarkdown(title)}${note}`);
+            }
+            out.push('', '</details>', '');
+        }
+        if (ov.hunks > MARKDOWN_HUNK_LIMIT) {
+            out.push(`*${escapeMarkdown(m.markdown.more(ov.hunks - MARKDOWN_HUNK_LIMIT))}*`, '');
+        }
+    }
+    out.push(`*${escapeMarkdown(m.markdown.generatedBy(options.generator))}*`);
+    return `${out.join('\n')}\n`;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAmB,UAAU,EAAe,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAqB,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,yCAAyC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,sEAAsE;AACtE,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B,MAAM,aAAa,GAA2C;IAC5D,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,IAAI;CACf,CAAC;AAEF,wFAAwF;AACxF,MAAM,IAAI,GAAG,QAAQ,CAAC;AAEtB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,CACL,eAAe,CAAC,IAAI,CAAC;QACnB,uGAAuG;SACtG,OAAO,CAAC,+BAA+B,EAAE,GAAG,CAAC;SAC7C,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,OAAO,CAAC,oBAAoB,EAAE,IAAI,IAAI,KAAK,CAAC;SAC5C,OAAO,CAAC,iBAAiB,EAAE,KAAK,IAAI,GAAG,CAAC;SACxC,OAAO,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE,CAAC;SACjD,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;SAC/B,OAAO,CAAC,aAAa,EAAE,KAAK,IAAI,GAAG,CAAC;SACpC,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC;SAClC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,IAAI,EAAE,CACV,CAAC;AACJ,CAAC;AASD,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,OAAwB;IACvE,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,GAAG,GAAa,CAAC,eAAe,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEnD,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjF,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,OAAO,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACnF,wDAAwD;QACxD,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAC1B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CACnE,CAAC;QACpB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACnD,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,GAAG,CAAC,IAAI,CACN,OAAO,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,KAAK,IAAI,EAC/E,uCAAuC,EACvC,OAAO,CAAC,CAAC,KAAK,QAAQ,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAClL,OAAO,CAAC,CAAC,KAAK,QAAQ,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAClL,EAAE,EACF,CAAC,CAAC,QAAQ,CAAC,MAAM,EACjB,EAAE,CACH,CAAC;QACF,IAAI,MAAM,GAAG,mBAAmB,CAAC;QACjC,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,IAAI,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,IAAI,MAAM,IAAI,CAAC;gBAAE,MAAM;YACvB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC;YACxB,GAAG,CAAC,IAAI,CACN,WAAW,IAAI,GAAG,EAClB,YAAY,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,EAC/E,EAAE,CACH,CAAC;YACF,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAC1B,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACnE,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;gBAChC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;YAClF,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,EAAE,CAAC,KAAK,GAAG,mBAAmB,EAAE,CAAC;YACnC,GAAG,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,GAAG,mBAAmB,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3E,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAC/B,CAAC"}

package/dist/model.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Presentation model shared by every text output: hunk families, glyphs, name-status letters,
+ * phase grouping and the per-phase counts behind the counters and the diffstat bar.
+ */
+import type { DiffResult, Hunk, HunkKind, ReplayPhase } from '@kgdiff/core';
+/** The five meaning families of docs/visual-language.md (mirrors `@kgdiff/scene`). */
+export type ChangeFamily = 'added' | 'removed' | 'content' | 'structure' | 'identity';
+/**
+ * Family of each hunk kind. Identical to `hunkFamily` in `@kgdiff/scene` (a test enforces it);
+ * duplicated so text outputs do not load the scene and layout modules.
+ */
+export declare const KIND_FAMILY: Readonly<Record<HunkKind, ChangeFamily>>;
+/**
+ * Family a hunk is shown with: its kind's family, except that a `modify` hunk made only of
+ * hierarchy moves (phase `restructure`) is `structure`, as its node is drawn
+ * (docs/visual-language.md: move → structure).
+ */
+export declare function hunkFamily(hunk: Hunk): ChangeFamily;
+/** One-character glyph of a hunk: `+ − ~ ⇄ ⊕ ⑂`. */
+export declare function hunkGlyph(hunk: Hunk): string;
+export type NameStatus = 'A' | 'D' | 'M' | 'R' | 'V' | 'G' | 'S' | 'E';
+/**
+ * `--name-status` letter: `A` added, `D` removed, `M` modified, `R` renamed, `V` moved,
+ * `G` merged, `S` split, `E` relations. A modify hunk is `R` when its node was renamed, else `V`
+ * when it moved in the hierarchy, else `M`.
+ */
+export declare function nameStatus(hunk: Hunk, diff: DiffResult): NameStatus;
+/**
+ * Order of the phase groups in hunk lists: the replay order ("clean up, restructure, refine,
+ * grow"), shared with the viewer's change list and the Markdown summary.
+ */
+export declare const LIST_PHASES: readonly ReplayPhase[];
+/** Order of the counters and the diffstat bar segments. */
+export declare const COUNTER_PHASES: readonly ReplayPhase[];
+/** Counter glyph and family of each phase. */
+export declare const PHASE_GLYPH: Readonly<Record<ReplayPhase, string>>;
+export declare const PHASE_FAMILY: Readonly<Record<ReplayPhase, ChangeFamily>>;
+export interface PhaseCount {
+    /** Hunks in the phase. */
+    readonly hunks: number;
+    /** Changed elements (nodes + edges) owned by those hunks. */
+    readonly changes: number;
+}
+export interface Overview {
+    readonly phases: Readonly<Record<ReplayPhase, PhaseCount>>;
+    /** Changed elements (every changed node and edge belongs to exactly one hunk). */
+    readonly changes: number;
+    readonly hunks: number;
+}
+/** Per-phase hunk and change counts. O(hunks). */
+export declare function overview(diff: DiffResult): Overview;
+/** Hunks in list order: grouped by `LIST_PHASES`, each group in review order. */
+export declare function groupByPhase(hunks: readonly Hunk[]): {
+    phase: ReplayPhase;
+    hunks: Hunk[];
+}[];
+/**
+ * Split `total` cells among `weights` proportionally (largest remainder); every positive weight
+ * gets at least one cell when `total` allows. Deterministic; ties go to the earlier entry.
+ */
+export declare function apportion(weights: readonly number[], total: number): number[];
+export declare function assertNever(value: never): never;
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5E,sFAAsF;AACtF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAEtF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAOhE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,YAAY,CAGnD;AAED,oDAAoD;AACpD,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAiB5C;AAED,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAqBnE;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,WAAW,EAA+C,CAAC;AAE9F,2DAA2D;AAC3D,eAAO,MAAM,cAAc,EAAE,SAAS,WAAW,EAA+C,CAAC;AAEjG,8CAA8C;AAC9C,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAK7D,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CAKpE,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;IAC3D,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,CAenD;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,EAAE,CAK5F;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA0B7E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAE/C"}

package/dist/model.js

@@ -0,0 +1,151 @@
+/**
+ * Family of each hunk kind. Identical to `hunkFamily` in `@kgdiff/scene` (a test enforces it);
+ * duplicated so text outputs do not load the scene and layout modules.
+ */
+export const KIND_FAMILY = {
+    add: 'added',
+    remove: 'removed',
+    merge: 'identity',
+    split: 'identity',
+    relations: 'structure',
+    modify: 'content',
+};
+/**
+ * Family a hunk is shown with: its kind's family, except that a `modify` hunk made only of
+ * hierarchy moves (phase `restructure`) is `structure`, as its node is drawn
+ * (docs/visual-language.md: move → structure).
+ */
+export function hunkFamily(hunk) {
+    if (hunk.kind === 'modify' && hunk.phase === 'restructure')
+        return 'structure';
+    return KIND_FAMILY[hunk.kind];
+}
+/** One-character glyph of a hunk: `+ − ~ ⇄ ⊕ ⑂`. */
+export function hunkGlyph(hunk) {
+    switch (hunk.kind) {
+        case 'add':
+            return '+';
+        case 'remove':
+            return '−';
+        case 'merge':
+            return '⊕';
+        case 'split':
+            return '⑂';
+        case 'relations':
+            return '⇄';
+        case 'modify':
+            return hunk.phase === 'restructure' ? '⇄' : '~';
+        default:
+            return assertNever(hunk.kind);
+    }
+}
+/**
+ * `--name-status` letter: `A` added, `D` removed, `M` modified, `R` renamed, `V` moved,
+ * `G` merged, `S` split, `E` relations. A modify hunk is `R` when its node was renamed, else `V`
+ * when it moved in the hierarchy, else `M`.
+ */
+export function nameStatus(hunk, diff) {
+    switch (hunk.kind) {
+        case 'add':
+            return 'A';
+        case 'remove':
+            return 'D';
+        case 'merge':
+            return 'G';
+        case 'split':
+            return 'S';
+        case 'relations':
+            return 'E';
+        case 'modify': {
+            const facets = diff.index.node(hunk.anchor)?.facets ?? [];
+            if (facets.some((f) => f.kind === 'rename'))
+                return 'R';
+            if (facets.some((f) => f.kind === 'move'))
+                return 'V';
+            return 'M';
+        }
+        default:
+            return assertNever(hunk.kind);
+    }
+}
+/**
+ * Order of the phase groups in hunk lists: the replay order ("clean up, restructure, refine,
+ * grow"), shared with the viewer's change list and the Markdown summary.
+ */
+export const LIST_PHASES = ['remove', 'restructure', 'modify', 'add'];
+/** Order of the counters and the diffstat bar segments. */
+export const COUNTER_PHASES = ['add', 'remove', 'modify', 'restructure'];
+/** Counter glyph and family of each phase. */
+export const PHASE_GLYPH = {
+    add: '+',
+    remove: '−',
+    modify: '~',
+    restructure: '⇄',
+};
+export const PHASE_FAMILY = {
+    add: 'added',
+    remove: 'removed',
+    modify: 'content',
+    restructure: 'structure',
+};
+/** Per-phase hunk and change counts. O(hunks). */
+export function overview(diff) {
+    const phases = {
+        add: { hunks: 0, changes: 0 },
+        remove: { hunks: 0, changes: 0 },
+        modify: { hunks: 0, changes: 0 },
+        restructure: { hunks: 0, changes: 0 },
+    };
+    let changes = 0;
+    for (const h of diff.hunks) {
+        const n = h.nodes.length + h.edges.length;
+        phases[h.phase].hunks++;
+        phases[h.phase].changes += n;
+        changes += n;
+    }
+    return { phases, changes, hunks: diff.hunks.length };
+}
+/** Hunks in list order: grouped by `LIST_PHASES`, each group in review order. */
+export function groupByPhase(hunks) {
+    return LIST_PHASES.map((phase) => ({
+        phase,
+        hunks: hunks.filter((h) => h.phase === phase).sort((a, b) => a.order - b.order),
+    })).filter((g) => g.hunks.length > 0);
+}
+/**
+ * Split `total` cells among `weights` proportionally (largest remainder); every positive weight
+ * gets at least one cell when `total` allows. Deterministic; ties go to the earlier entry.
+ */
+export function apportion(weights, total) {
+    const sum = weights.reduce((a, b) => a + b, 0);
+    if (sum <= 0 || total <= 0)
+        return weights.map(() => 0);
+    const exact = weights.map((w) => (w / sum) * total);
+    const cells = exact.map((x, i) => (weights[i] > 0 ? Math.max(1, Math.floor(x)) : 0));
+    let used = cells.reduce((a, b) => a + b, 0);
+    const byRemainder = exact
+        .map((x, i) => ({ i, r: x - Math.floor(x) }))
+        .sort((a, b) => b.r - a.r || a.i - b.i);
+    for (let k = 0; used < total && k < byRemainder.length * 2; k++) {
+        const { i } = byRemainder[k % byRemainder.length];
+        if (weights[i] > 0) {
+            cells[i] = cells[i] + 1;
+            used++;
+        }
+    }
+    // Minimum cells may overshoot a tiny total: take back from the largest segments.
+    while (used > total) {
+        let largest = 0;
+        for (let i = 1; i < cells.length; i++) {
+            if (cells[i] > cells[largest])
+                largest = i;
+        }
+        cells[largest] = cells[largest] - 1;
+        used--;
+    }
+    return cells;
+}
+export function assertNever(value) {
+    throw new Error(`Unexpected value: ${String(value)}`);
+}
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

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

package/dist/node-io.d.ts

@@ -0,0 +1,12 @@
+import type { CliFileSystem, CliIO } from './io.js';
+/** The real file system (exported for tests that exercise links and case variants). */
+export declare function nodeFileSystem(): CliFileSystem;
+/** Command that opens a file with the default application on this platform. */
+export declare function openCommand(platform: NodeJS.Platform, path: string): {
+    command: string;
+    args: string[];
+    verbatim: boolean;
+};
+/** `CliIO` bound to the current process. */
+export declare function nodeIO(): CliIO;
+//# sourceMappingURL=node-io.d.ts.map

package/dist/node-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-io.d.ts","sourceRoot":"","sources":["../src/node-io.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAgB,MAAM,SAAS,CAAC;AAmClE,uFAAuF;AACvF,wBAAgB,cAAc,IAAI,aAAa,CAiB9C;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,IAAI,EAAE,MAAM,GACX;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAQxD;AAiDD,4CAA4C;AAC5C,wBAAgB,MAAM,IAAI,KAAK,CAiB9B"}

package/dist/node-io.js

@@ -0,0 +1,135 @@
+/**
+ * The real `CliIO`: process streams, the file system, the platform opener and the viewer
+ * bundles resolved from `@kgdiff/viewer/standalone` and `@kgdiff/viewer/standalone/compute`.
+ */
+import { spawn } from 'node:child_process';
+import { randomBytes } from 'node:crypto';
+import { chmod, mkdtemp, readFile, realpath, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { tmpdir } from 'node:os';
+import { basename, dirname, join } from 'node:path';
+import { CliError, systemErrorCode } from './errors.js';
+async function readStdin(maxBytes) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of process.stdin) {
+        const buffer = typeof chunk === 'string' ? Buffer.from(chunk) : chunk;
+        size += buffer.byteLength;
+        if (size > maxBytes) {
+            process.stdin.destroy();
+            throw new RangeError(`stdin is larger than ${maxBytes} bytes`);
+        }
+        chunks.push(buffer);
+    }
+    return Buffer.concat(chunks);
+}
+/**
+ * Atomic replace: write `.<name>.<random>.tmp` next to `path` (exclusive create), copy the
+ * permissions of an existing file, then rename over `path`. The temporary file is removed on
+ * failure.
+ */
+async function writeFileAtomic(path, data) {
+    const temp = join(dirname(path), `.${basename(path)}.${randomBytes(6).toString('hex')}.tmp`);
+    try {
+        await writeFile(temp, data, { flag: 'wx', mode: 0o666 });
+        const existing = await stat(path).catch(() => undefined);
+        if (existing)
+            await chmod(temp, existing.mode & 0o7777);
+        await rename(temp, path);
+    }
+    catch (error) {
+        await rm(temp, { force: true }).catch(() => undefined);
+        throw error;
+    }
+}
+/** The real file system (exported for tests that exercise links and case variants). */
+export function nodeFileSystem() {
+    return {
+        readFile: (path) => readFile(path),
+        writeFile: writeFileAtomic,
+        stat: async (path) => {
+            try {
+                const s = await stat(path);
+                return { dev: s.dev, ino: s.ino, size: s.size };
+            }
+            catch (error) {
+                if (systemErrorCode(error) === 'ENOENT' || systemErrorCode(error) === 'ENOTDIR') {
+                    return undefined;
+                }
+                throw error;
+            }
+        },
+        realpath: (path) => realpath(path),
+    };
+}
+/** Command that opens a file with the default application on this platform. */
+export function openCommand(platform, path) {
+    if (platform === 'darwin')
+        return { command: 'open', args: [path], verbatim: false };
+    if (platform === 'win32') {
+        // `start` takes its first quoted argument as a window title, hence the empty "". With /s,
+        // cmd strips the outer quotes and runs the rest verbatim.
+        return { command: 'cmd', args: ['/d', '/s', '/c', `"start "" "${path}""`], verbatim: true };
+    }
+    return { command: 'xdg-open', args: [path], verbatim: false };
+}
+function openFile(path) {
+    const { command, args, verbatim } = openCommand(process.platform, path);
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: 'ignore',
+            detached: true,
+            windowsHide: true,
+            windowsVerbatimArguments: verbatim,
+        });
+        child.once('error', reject);
+        child.once('spawn', () => {
+            child.unref();
+            resolve();
+        });
+    });
+}
+const VIEWER_SPECIFIERS = {
+    main: '@kgdiff/viewer/standalone',
+    compute: '@kgdiff/viewer/standalone/compute',
+};
+async function loadViewerBundle(part) {
+    const specifier = VIEWER_SPECIFIERS[part];
+    const what = part === 'main' ? 'standalone viewer bundle' : 'viewer compute add-on';
+    const hint = 'Build it with `pnpm --filter @kgdiff/viewer build` (development) or reinstall kgdiff.';
+    let path;
+    try {
+        path = createRequire(import.meta.url).resolve(specifier);
+    }
+    catch (error) {
+        throw new CliError('viewer-missing', `The HTML report needs the ${what} (${specifier}), which was not found.`, hint, { cause: error });
+    }
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch (error) {
+        throw new CliError('viewer-missing', `Cannot read the ${what} at ${path}.`, hint, {
+            cause: error,
+        });
+    }
+}
+/** `CliIO` bound to the current process. */
+export function nodeIO() {
+    return {
+        stdout: process.stdout,
+        stderr: process.stderr,
+        readStdin,
+        fs: nodeFileSystem(),
+        env: process.env,
+        cwd: process.cwd(),
+        isTTY: process.stdout.isTTY === true,
+        stderrIsTTY: process.stderr.isTTY === true,
+        stdinIsTTY: process.stdin.isTTY === true,
+        columns: process.stdout.isTTY ? process.stdout.columns : undefined,
+        now: () => new Date(),
+        makeTempDir: () => mkdtemp(join(tmpdir(), 'kgdiff-')),
+        openFile,
+        loadViewerBundle,
+    };
+}
+//# sourceMappingURL=node-io.js.map

package/dist/node-io.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared output plumbing of the commands: painters for stdout / stderr, the resolved locale,
+ * `--quiet`, and writing output files with a short notice on stderr.
+ */
+import type { Locale } from '@kgdiff/core';
+import type { CommonOptions } from './args.js';
+import type { CliIO } from './io.js';
+import { type Painter } from './style.js';
+export interface OutputContext {
+    readonly io: CliIO;
+    readonly locale: Locale;
+    /** Painter for stdout. */
+    readonly paint: Painter;
+    /** Painter for stderr. */
+    readonly errPaint: Painter;
+    readonly quiet: boolean;
+    /** Write to stdout unless `--quiet`. */
+    stdout(text: string): void;
+    /** Write a notice or warning to stderr unless `--quiet`. */
+    notice(text: string): void;
+}
+export declare function outputContext(io: CliIO, options: CommonOptions): OutputContext;
+/** `1.2 MB`, `512 kB`, `90 B` (decimal units, like most file managers). */
+export declare function formatSize(bytes: number): string;
+/** Write an output file and report it on stderr (`✓ Wrote report.html (1.2 MB)`). */
+export declare function writeOutputFile(ctx: OutputContext, path: string, content: string, label: string): Promise<void>;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAoC,KAAK,OAAO,EAAqB,MAAM,YAAY,CAAC;AAG/F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,wCAAwC;IACxC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4DAA4D;IAC5D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,GAAG,aAAa,CAe9E;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAQD,qFAAqF;AACrF,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/output.js

@@ -0,0 +1,50 @@
+import { CliError, systemErrorCode, systemReason } from './errors.js';
+import { resolvePath } from './inputs.js';
+import { resolveLocale } from './locale.js';
+import { createPainter, isLightBackground, resolveColorLevel } from './style.js';
+import { sanitize } from './width.js';
+export function outputContext(io, options) {
+    const light = isLightBackground(io.env);
+    return {
+        io,
+        locale: resolveLocale(options.locale, io.env),
+        paint: createPainter(resolveColorLevel(options.color, io.env, io.isTTY), light),
+        errPaint: createPainter(resolveColorLevel(options.color, io.env, io.stderrIsTTY), light),
+        quiet: options.quiet,
+        stdout: (text) => {
+            if (!options.quiet && text)
+                io.stdout.write(text);
+        },
+        notice: (text) => {
+            if (!options.quiet)
+                io.stderr.write(text);
+        },
+    };
+}
+/** `1.2 MB`, `512 kB`, `90 B` (decimal units, like most file managers). */
+export function formatSize(bytes) {
+    if (bytes < 1000)
+        return `${bytes} B`;
+    if (bytes < 1_000_000)
+        return `${(bytes / 1000).toFixed(bytes < 10_000 ? 1 : 0)} kB`;
+    return `${(bytes / 1_000_000).toFixed(1)} MB`;
+}
+const WRITE_HINTS = {
+    ENOENT: 'Create the directory first.',
+    EISDIR: 'Pass a file name, not a directory.',
+    EACCES: 'Check the permissions of the directory.',
+};
+/** Write an output file and report it on stderr (`✓ Wrote report.html (1.2 MB)`). */
+export async function writeOutputFile(ctx, path, content, label) {
+    const data = new TextEncoder().encode(content);
+    try {
+        await ctx.io.fs.writeFile(resolvePath(ctx.io, path), data);
+    }
+    catch (error) {
+        const code = systemErrorCode(error);
+        throw new CliError('output', `Cannot write ${label} to "${sanitize(path)}": ${systemReason(error)}.`, (code && WRITE_HINTS[code]) || undefined, { cause: error });
+    }
+    const p = ctx.errPaint;
+    ctx.notice(`${p.tone('added', '✓')} Wrote ${label} ${p.bold(sanitize(path))} ${p.dim(`(${formatSize(data.byteLength)})`)}\n`);
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/overwrite.d.ts

@@ -0,0 +1,14 @@
+import type { CliIO } from './io.js';
+export interface PathRole {
+    /** How the path was given, for messages (`<before>`, `--json`, `-o`). */
+    readonly role: string;
+    /** Path as given; `-` (stdin / stdout) and `undefined` are ignored. */
+    readonly path: string | undefined;
+}
+/** Identity of the file at `path`: `inode:dev:ino` when it exists, else a canonical path. */
+export declare function fileIdentity(io: CliIO, path: string): Promise<string>;
+/**
+ * @throws CliError `usage` when an output is one of the inputs or two outputs are one file.
+ */
+export declare function checkNoOverwrite(io: CliIO, inputs: readonly PathRole[], outputs: readonly PathRole[]): Promise<void>;
+//# sourceMappingURL=overwrite.d.ts.map

package/dist/overwrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overwrite.d.ts","sourceRoot":"","sources":["../src/overwrite.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,MAAM,WAAW,QAAQ;IACvB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,6FAA6F;AAC7F,wBAAsB,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa3E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,KAAK,EACT,MAAM,EAAE,SAAS,QAAQ,EAAE,EAC3B,OAAO,EAAE,SAAS,QAAQ,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CA+Bf"}