@kgdiff/cli 0.0.0-stage → 0.1.0

package/dist/inputs.js

@@ -0,0 +1,204 @@
+/**
+ * Reading inputs: files or stdin, gzip-compressed or not, UTF-8 / UTF-16 text, parsed with
+ * `@kgdiff/formats`. Failures become `CliError`s that name the file and suggest a fix.
+ */
+import { basename, resolve } from 'node:path';
+import { parseGraph } from '@kgdiff/formats';
+import { FORMATS, STDIO } from './args.js';
+import { CliError, isKgdiffError, systemErrorCode, systemReason } from './errors.js';
+import { sanitize } from './width.js';
+export const FORMAT_NAMES = {
+    json: 'JSON',
+    jsonld: 'JSON-LD',
+    turtle: 'Turtle',
+    ntriples: 'N-Triples',
+    nquads: 'N-Quads',
+    trig: 'TriG',
+    rdfxml: 'RDF/XML',
+    obo: 'OBO',
+};
+const READ_HINTS = {
+    ENOENT: 'Check the path. Use - to read from stdin.',
+    EISDIR: 'Pass a file, not a directory.',
+    EACCES: 'Check the file permissions.',
+};
+/** Resolve a user-supplied path against the IO's working directory. */
+export function resolvePath(io, path) {
+    return resolve(io.cwd, path);
+}
+/** Default input size limit (bytes, after decompression): 1 GiB. */
+export const DEFAULT_MAX_INPUT = 1024 ** 3;
+const SIZE_UNITS = { '': 1, k: 1024, m: 1024 ** 2, g: 1024 ** 3 };
+/**
+ * Input size limit: `KGDIFF_MAX_INPUT` (bytes, or with a binary `K` / `M` / `G` suffix, e.g.
+ * `4G`), else `DEFAULT_MAX_INPUT`. Applies to files, stdin and decompressed gzip data.
+ *
+ * @throws CliError `usage` for an unreadable value.
+ */
+export function maxInputBytes(env) {
+    const raw = env.KGDIFF_MAX_INPUT?.trim();
+    if (!raw)
+        return DEFAULT_MAX_INPUT;
+    const match = /^(\d+(?:\.\d+)?)\s*([kmg]?)i?b?$/i.exec(raw);
+    const value = match ? Number(match[1]) * (SIZE_UNITS[(match[2] ?? '').toLowerCase()] ?? 1) : NaN;
+    if (!Number.isFinite(value) || value < 1) {
+        throw new CliError('usage', `Invalid KGDIFF_MAX_INPUT "${sanitize(raw)}".`, 'Use a byte count such as 2147483648, or 512M / 2G.');
+    }
+    return Math.floor(value);
+}
+function formatBytes(bytes) {
+    for (const [unit, size] of [
+        ['GiB', 1024 ** 3],
+        ['MiB', 1024 ** 2],
+        ['KiB', 1024],
+    ]) {
+        if (bytes >= size)
+            return `${Number((bytes / size).toFixed(1))} ${unit}`;
+    }
+    return `${bytes} B`;
+}
+function tooLarge(where, limit, cause) {
+    return new CliError('input', `${where} is too large: the input limit is ${formatBytes(limit)}.`, 'If the input is genuine, raise the limit with KGDIFF_MAX_INPUT (e.g. KGDIFF_MAX_INPUT=4G).', cause === undefined ? undefined : { cause });
+}
+function isTooLarge(error) {
+    const code = error?.code;
+    return (error instanceof RangeError ||
+        code === 'ERR_BUFFER_TOO_LARGE' ||
+        code === 'ERR_FS_FILE_TOO_LARGE' ||
+        code === 'ERR_STRING_TOO_LONG');
+}
+/**
+ * Decode input bytes: gunzip when gzip-compressed (output capped at `limit`, so a gzip bomb is
+ * an error, not an out-of-memory crash), UTF-16 by BOM, else strict UTF-8.
+ */
+export async function decodeText(bytes, where, limit) {
+    let data = bytes;
+    if (data[0] === 0x1f && data[1] === 0x8b) {
+        const { gunzipSync } = await import('node:zlib');
+        try {
+            data = gunzipSync(data, { maxOutputLength: limit });
+        }
+        catch (error) {
+            if (isTooLarge(error))
+                throw tooLarge(`${where} (decompressed)`, limit, error);
+            throw new CliError('input', `Cannot decompress ${where}: ${systemReason(error)}.`, undefined, {
+                cause: error,
+            });
+        }
+    }
+    const encoding = data[0] === 0xff && data[1] === 0xfe
+        ? 'utf-16le'
+        : data[0] === 0xfe && data[1] === 0xff
+            ? 'utf-16be'
+            : 'utf-8';
+    try {
+        return new TextDecoder(encoding, { fatal: true }).decode(data);
+    }
+    catch (error) {
+        if (isTooLarge(error))
+            throw tooLarge(where, limit, error);
+        throw new CliError('input', `${where} is not valid ${encoding.toUpperCase()} text.`, `kgdiff reads text formats (${Object.values(FORMAT_NAMES).join(', ')}). Convert binary formats first.`, { cause: error });
+    }
+}
+/**
+ * Read a file (or stdin for `-`) as text. `role` names the argument in messages. Inputs above
+ * the size limit, and empty inputs unless `allowEmpty`, are errors.
+ */
+export async function readInput(io, path, role, options = {}) {
+    const limit = maxInputBytes(io.env);
+    let raw;
+    if (path === STDIO) {
+        if (io.stdinIsTTY) {
+            io.stderr.write(`Reading ${role} from stdin… (end with Ctrl-D)\n`);
+        }
+        let bytes;
+        try {
+            bytes = await io.readStdin(limit);
+        }
+        catch (error) {
+            if (isTooLarge(error))
+                throw tooLarge(`${role} (stdin)`, limit, error);
+            throw error;
+        }
+        raw = { display: 'stdin', where: `${role} (stdin)`, bytes };
+    }
+    else {
+        const display = sanitize(path);
+        const where = `${role} "${display}"`;
+        const absolute = resolvePath(io, path);
+        let bytes;
+        try {
+            const size = (await io.fs.stat(absolute))?.size;
+            if (size !== undefined && size > limit)
+                throw tooLarge(where, limit);
+            bytes = await io.fs.readFile(absolute);
+        }
+        catch (error) {
+            if (error instanceof CliError)
+                throw error;
+            if (isTooLarge(error))
+                throw tooLarge(where, limit, error);
+            const code = systemErrorCode(error);
+            throw new CliError('input', `Cannot read ${where}: ${systemReason(error)}.`, (code && READ_HINTS[code]) || undefined, { cause: error });
+        }
+        raw = { display, where, filename: basename(path).replace(/\.gz$/i, ''), bytes };
+    }
+    const text = await decodeText(raw.bytes, raw.where, limit);
+    const empty = text.trim() === '';
+    if (empty && !options.allowEmpty) {
+        throw new CliError('input', `${raw.where} is empty.`, options.emptyHint ??
+            (path === STDIO
+                ? 'Did the command before the pipe fail? Pass --allow-empty if an empty graph is intended.'
+                : 'Pass --allow-empty to compare with an empty graph (e.g. before a first release).'));
+    }
+    return {
+        display: raw.display,
+        ...(raw.filename !== undefined ? { filename: raw.filename } : {}),
+        text,
+        empty,
+    };
+}
+/**
+ * Read two inputs concurrently; when both fail, the first one's error is reported (so the
+ * message does not depend on which read finished first).
+ */
+export async function readPair(first, second) {
+    const [a, b] = await Promise.allSettled([first, second]);
+    if (a.status === 'rejected')
+        throw a.reason;
+    if (b.status === 'rejected')
+        throw b.reason;
+    return [a.value, b.value];
+}
+/** Parse a graph, turning parser errors into messages that name the input. */
+export function parseInput(input, options) {
+    const parseOptions = {
+        format: options.format,
+        ...(input.filename !== undefined ? { filename: input.filename } : {}),
+        ...(options.languages ? { rdf: { languages: options.languages } } : {}),
+    };
+    if (input.empty) {
+        // --allow-empty: an empty graph, without asking a parser to guess the format of nothing.
+        return parseGraph('{"nodes":[],"edges":[]}', { ...parseOptions, format: 'json' });
+    }
+    try {
+        return parseGraph(input.text, parseOptions);
+    }
+    catch (error) {
+        if (!isKgdiffError(error))
+            throw error;
+        const where = input.display === 'stdin' ? 'stdin' : `"${input.display}"`;
+        const undetected = /could not detect the format/i.test(error.message);
+        const message = undetected
+            ? `Cannot tell the format of ${where}.`
+            : `${where}: ${error.message.replace(/\.$/, '')}.`;
+        const formats = FORMATS.filter((format) => format !== 'auto').join(', ');
+        const hint = undetected
+            ? `Pass ${options.formatFlag} <fmt> (${formats}) or use a known file extension.`
+            : options.format === 'auto'
+                ? `If the format was detected wrongly, pass ${options.formatFlag} <fmt> (${formats}).`
+                : undefined;
+        throw new CliError('input', message, hint, { cause: error });
+    }
+}
+//# sourceMappingURL=inputs.js.map

package/dist/inputs.js.map

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

package/dist/io.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Everything the CLI needs from the outside world, injected so that `main` runs in-process in
+ * tests (fake streams, in-memory files, fixed clock) and for real in `bin.ts` (`nodeIO`).
+ */
+import type { Env } from './style.js';
+/** The standalone viewer bundles an HTML report can inline. */
+export type ViewerBundle = 'main' | 'compute';
+/** A writable text stream (stdout / stderr). */
+export interface OutputStream {
+    write(chunk: string): void;
+}
+/** What overwrite checks need to know about an existing file. */
+export interface FileStat {
+    /** Device and inode: equal for the same file under any name (case variant, link). */
+    readonly dev: number;
+    readonly ino: number;
+    readonly size: number;
+}
+export interface CliFileSystem {
+    /** Read a whole file. Rejects with a Node-style error (`code`: ENOENT, EISDIR, EACCES…). */
+    readFile(path: string): Promise<Uint8Array>;
+    /**
+     * Create or replace a file atomically: write a temporary file in the same directory, then
+     * rename it over `path` (readers never see a half-written file; a symlink at `path` is
+     * replaced, not written through).
+     */
+    writeFile(path: string, data: string | Uint8Array): Promise<void>;
+    /** Stat following symlinks; `undefined` when nothing exists at `path`. */
+    stat(path: string): Promise<FileStat | undefined>;
+    /** Canonical absolute path (symlinks resolved). Rejects when `path` does not exist. */
+    realpath(path: string): Promise<string>;
+}
+export interface CliIO {
+    readonly stdout: OutputStream;
+    readonly stderr: OutputStream;
+    /** Read all of stdin; rejects with a `RangeError` beyond `maxBytes`. */
+    readStdin(maxBytes: number): Promise<Uint8Array>;
+    readonly fs: CliFileSystem;
+    readonly env: Env;
+    /** Directory relative paths are resolved against. */
+    readonly cwd: string;
+    /** Whether stdout is a terminal. */
+    readonly isTTY: boolean;
+    /** Whether stderr is a terminal (colors of errors and notices). */
+    readonly stderrIsTTY: boolean;
+    /** Whether stdin is a terminal (nothing piped in). */
+    readonly stdinIsTTY: boolean;
+    /** Terminal width of stdout, when known. */
+    readonly columns: number | undefined;
+    /** Clock for `generatedAt` in HTML reports. */
+    now(): Date;
+    /** Create a fresh private directory (`mkdtemp`) for reports opened with `--open` and no `-o`. */
+    makeTempDir(): Promise<string>;
+    /** Open a file with the platform's default application (the browser, for HTML). */
+    openFile(path: string): Promise<void>;
+    /**
+     * Source of a standalone viewer bundle: `main` (`@kgdiff/viewer/standalone`, the
+     * `<kgdiff-viewer>` element) or `compute` (`@kgdiff/viewer/standalone/compute`, the optional
+     * diff / layout add-on). Rejects with a `CliError` (`viewer-missing`) when it is not built or
+     * not installed.
+     */
+    loadViewerBundle(part: ViewerBundle): Promise<string>;
+}
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;AAE9C,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,iEAAiE;AACjE,MAAM,WAAW,QAAQ;IACvB,qFAAqF;IACrF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,4FAA4F;IAC5F,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IAClD,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,wEAAwE;IACxE,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,qDAAqD;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,+CAA+C;IAC/C,GAAG,IAAI,IAAI,CAAC;IACZ,iGAAiG;IACjG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvD"}

package/dist/io.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":""}

package/dist/locale.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Locale selection and the CLI's own strings (summary, stat, Markdown). Hunk titles come from
+ * `@kgdiff/core`'s `formatHunk`; errors and notices on stderr stay in English so they can be
+ * searched for.
+ */
+import type { Locale, ReplayPhase } from '@kgdiff/core';
+import type { ChangeFamily } from './model.js';
+import type { Env } from './style.js';
+export declare const LOCALES: readonly Locale[];
+/**
+ * Map a locale tag or POSIX locale (`zh_CN.UTF-8`, `zh-Hant`, `en_US`, `C`) to a supported
+ * locale: any Chinese tag → `zh-CN`, any English or POSIX tag → `en`, anything else `undefined`.
+ */
+export declare function matchLocale(tag: string): Locale | undefined;
+/**
+ * The locale to use: `--locale` when given, else the first non-empty of `LC_ALL`, `LC_MESSAGES`,
+ * `LANG` (POSIX precedence), mapped with `matchLocale`; `en` when nothing matches.
+ */
+export declare function resolveLocale(flag: Locale | undefined, env: Env): Locale;
+/** Thousands separators without `Intl`, so output never depends on the runtime's ICU data. */
+export declare function formatInt(n: number): string;
+export interface Messages {
+    /** Group headings, by replay phase. */
+    readonly phase: Readonly<Record<ReplayPhase, string>>;
+    /** Counter labels (`+3 added`), by replay phase. */
+    readonly counter: Readonly<Record<ReplayPhase, string>>;
+    readonly family: Readonly<Record<ChangeFamily, string>>;
+    /** `179 → 184 nodes · 351 → 353 edges`; one number when a count did not change. */
+    readonly totals: (nodes: Count, edges: Count) => string;
+    readonly changes: (changes: number, hunks: number) => string;
+    readonly more: (n: number) => string;
+    readonly moreHint: string;
+    readonly identical: string;
+    readonly identicalDetail: (nodes: number, edges: number) => string;
+    readonly table: {
+        readonly nodes: string;
+        readonly edges: string;
+        readonly added: string;
+        readonly removed: string;
+        readonly modified: string;
+        readonly unchanged: string;
+        readonly total: string;
+    };
+    readonly byType: string;
+    readonly untyped: string;
+    readonly moreTypes: (n: number) => string;
+    readonly markdown: {
+        readonly legend: string;
+        readonly more: (n: number) => string;
+        readonly generatedBy: (generator: string) => string;
+    };
+}
+/** A count before and after the change. */
+export type Count = readonly [before: number, after: number];
+/** `179 → 184`, or `74` when unchanged. */
+export declare function formatCount([before, after]: Count): string;
+export declare function messages(locale: Locale): Messages;
+//# sourceMappingURL=locale.d.ts.map

package/dist/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../src/locale.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,OAAO,EAAE,SAAS,MAAM,EAAoB,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS3D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,CAOxE;AAED,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,MAAM,WAAW,QAAQ;IACvB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACnE,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;QACrC,QAAQ,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;KACrD,CAAC;CACH;AAED,2CAA2C;AAC3C,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAK7D,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAE1D;AAyFD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEjD"}

package/dist/locale.js

@@ -0,0 +1,121 @@
+export const LOCALES = ['en', 'zh-CN'];
+/**
+ * Map a locale tag or POSIX locale (`zh_CN.UTF-8`, `zh-Hant`, `en_US`, `C`) to a supported
+ * locale: any Chinese tag → `zh-CN`, any English or POSIX tag → `en`, anything else `undefined`.
+ */
+export function matchLocale(tag) {
+    const t = tag
+        .trim()
+        .toLowerCase()
+        .replace(/[.@].*$/, '')
+        .replace(/_/g, '-');
+    if (t === 'zh' || t.startsWith('zh-') || t === 'cn')
+        return 'zh-CN';
+    if (t === 'en' || t.startsWith('en-') || t === 'c' || t === 'posix')
+        return 'en';
+    return undefined;
+}
+/**
+ * The locale to use: `--locale` when given, else the first non-empty of `LC_ALL`, `LC_MESSAGES`,
+ * `LANG` (POSIX precedence), mapped with `matchLocale`; `en` when nothing matches.
+ */
+export function resolveLocale(flag, env) {
+    if (flag)
+        return flag;
+    for (const name of ['LC_ALL', 'LC_MESSAGES', 'LANG']) {
+        const value = env[name];
+        if (value)
+            return matchLocale(value) ?? 'en';
+    }
+    return 'en';
+}
+/** Thousands separators without `Intl`, so output never depends on the runtime's ICU data. */
+export function formatInt(n) {
+    return String(Math.trunc(n)).replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+}
+const plural = (n, one, many) => `${formatInt(n)} ${n === 1 ? one : many}`;
+/** `179 → 184`, or `74` when unchanged. */
+export function formatCount([before, after]) {
+    return before === after ? formatInt(after) : `${formatInt(before)} → ${formatInt(after)}`;
+}
+const en = {
+    phase: {
+        restructure: 'Restructured',
+        modify: 'Modified',
+        add: 'Added',
+        remove: 'Removed',
+    },
+    counter: { add: 'added', remove: 'removed', modify: 'modified', restructure: 'restructured' },
+    family: {
+        added: 'added',
+        removed: 'removed',
+        content: 'content',
+        structure: 'structure',
+        identity: 'identity',
+    },
+    // The noun agrees with the number next to it (the after count): `1 node`, `2 → 1 node`.
+    totals: (nodes, edges) => `${formatCount(nodes)} ${nodes[1] === 1 ? 'node' : 'nodes'} · ` +
+        `${formatCount(edges)} ${edges[1] === 1 ? 'edge' : 'edges'}`,
+    changes: (changes, hunks) => `${plural(changes, 'change', 'changes')} in ${plural(hunks, 'hunk', 'hunks')}`,
+    more: (n) => `… and ${formatInt(n)} more`,
+    moreHint: '--limit 0 lists all',
+    identical: 'No differences',
+    identicalDetail: (nodes, edges) => `Both versions have ${plural(nodes, 'node', 'nodes')} and ${plural(edges, 'edge', 'edges')}.`,
+    table: {
+        nodes: 'nodes',
+        edges: 'edges',
+        added: 'added',
+        removed: 'removed',
+        modified: 'modified',
+        unchanged: 'unchanged',
+        total: 'before → after',
+    },
+    byType: 'By type',
+    untyped: '(untyped)',
+    moreTypes: (n) => `… and ${plural(n, 'more type', 'more types')}`,
+    markdown: {
+        legend: '🟩 added · 🟥 removed · 🟨 content (renames, attributes, types, synonyms) · ' +
+            '🟦 structure (moves, relations) · 🟪 identity (merges, splits)',
+        more: (n) => `…and ${plural(n, 'more hunk', 'more hunks')}. Open the HTML report for the full list.`,
+        generatedBy: (generator) => `Generated by ${generator}`,
+    },
+};
+const zh = {
+    phase: { restructure: '结构调整', modify: '修改', add: '新增', remove: '删除' },
+    counter: { add: '新增', remove: '删除', modify: '修改', restructure: '结构调整' },
+    family: {
+        added: '新增',
+        removed: '删除',
+        content: '内容',
+        structure: '结构',
+        identity: '身份',
+    },
+    totals: (nodes, edges) => `节点 ${formatCount(nodes)} · 关系 ${formatCount(edges)}`,
+    changes: (changes, hunks) => `${formatInt(hunks)} 组共 ${formatInt(changes)} 处变化`,
+    more: (n) => `… 另有 ${formatInt(n)} 组`,
+    moreHint: '--limit 0 显示全部',
+    identical: '没有差异',
+    identicalDetail: (nodes, edges) => `两个版本均有 ${formatInt(nodes)} 个节点、${formatInt(edges)} 条关系。`,
+    table: {
+        nodes: '节点',
+        edges: '关系',
+        added: '新增',
+        removed: '删除',
+        modified: '修改',
+        unchanged: '未变',
+        total: '变更前 → 变更后',
+    },
+    byType: '按类型',
+    untyped: '（无类型）',
+    moreTypes: (n) => `… 另有 ${formatInt(n)} 个类型`,
+    markdown: {
+        legend: '🟩 新增 · 🟥 删除 · 🟨 内容（改名、属性、类型、别名） · 🟦 结构（移动、关系） · 🟪 身份（合并、拆分、换 ID）',
+        more: (n) => `……另有 ${formatInt(n)} 组变更未列出，完整列表请查看 HTML 报告。`,
+        generatedBy: (generator) => `由 ${generator} 生成`,
+    },
+};
+const MESSAGES = { en, 'zh-CN': zh };
+export function messages(locale) {
+    return MESSAGES[locale];
+}
+//# sourceMappingURL=locale.js.map

package/dist/locale.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,10 @@
+import type { CliIO } from './io.js';
+/**
+ * Run the CLI with `argv` (without `node` and the script path).
+ *
+ * Exit codes: 0 success (and no differences with `--exit-code`), 1 differences with
+ * `--exit-code`, 2 usage or input error (message on stderr; stack trace only with
+ * `DEBUG=kgdiff`). Never throws.
+ */
+export declare function main(argv: readonly string[], io: CliIO): Promise<number>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAIrC;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC9E"}

package/dist/main.js

@@ -0,0 +1,51 @@
+/**
+ * Entry point logic: parse the command line, dispatch, map every failure to a friendly message
+ * on stderr and an exit code. Commands are loaded on demand so `--help` and `--version` never
+ * load the diff engine.
+ */
+import { parseCommandLine, peekColorMode } from './args.js';
+import { debugEnabled, formatError } from './errors.js';
+import { renderHelp } from './help.js';
+import { createPainter, isLightBackground, resolveColorLevel } from './style.js';
+import { cliVersion } from './version.js';
+/**
+ * Run the CLI with `argv` (without `node` and the script path).
+ *
+ * Exit codes: 0 success (and no differences with `--exit-code`), 1 differences with
+ * `--exit-code`, 2 usage or input error (message on stderr; stack trace only with
+ * `DEBUG=kgdiff`). Never throws.
+ */
+export async function main(argv, io) {
+    const light = isLightBackground(io.env);
+    try {
+        const command = parseCommandLine(argv);
+        switch (command.kind) {
+            case 'help': {
+                const paint = createPainter(resolveColorLevel(command.color, io.env, io.isTTY), light);
+                io.stdout.write(renderHelp(command.topic, cliVersion(), paint, io.isTTY && io.columns ? io.columns : 80));
+                return 0;
+            }
+            case 'version':
+                io.stdout.write(`kgdiff ${cliVersion()}\n`);
+                return 0;
+            case 'diff': {
+                const { runDiff } = await import('./diff-command.js');
+                return await runDiff(command.options, io);
+            }
+            case 'apply': {
+                const { runApply } = await import('./apply-command.js');
+                return await runApply(command.options, io);
+            }
+            default: {
+                const exhaustive = command;
+                throw new Error(`Unknown command ${JSON.stringify(exhaustive)}`);
+            }
+        }
+    }
+    catch (error) {
+        const paint = createPainter(resolveColorLevel(peekColorMode(argv), io.env, io.stderrIsTTY), light);
+        io.stderr.write(formatError(error, paint, debugEnabled(io.env.DEBUG)));
+        return 2;
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAuB,EAAE,EAAS;IAC3D,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,MAAM,EAAE,CAAC;gBACZ,MAAM,KAAK,GAAG,aAAa,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;gBACvF,EAAE,CAAC,MAAM,CAAC,KAAK,CACb,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CACzF,CAAC;gBACF,OAAO,CAAC,CAAC;YACX,CAAC;YACD,KAAK,SAAS;gBACZ,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,UAAU,EAAE,IAAI,CAAC,CAAC;gBAC5C,OAAO,CAAC,CAAC;YACX,KAAK,MAAM,EAAE,CAAC;gBACZ,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;gBACtD,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,KAAK,OAAO,EAAE,CAAC;gBACb,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;gBACxD,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC7C,CAAC;YACD,SAAS,CAAC;gBACR,MAAM,UAAU,GAAU,OAAO,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,aAAa,CACzB,iBAAiB,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,EAC9D,KAAK,CACN,CAAC;QACF,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvE,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/markdown.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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 { type DiffResult, type Locale } from '@kgdiff/core';
+/** Hunks listed before "…and N more". */
+export declare const MARKDOWN_HUNK_LIMIT = 100;
+/**
+ * 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 declare function escapeMarkdown(text: string): string;
+export interface MarkdownOptions {
+    readonly locale: Locale;
+    readonly title: string;
+    /** e.g. `kgdiff 0.1.0`. */
+    readonly generator: string;
+}
+/** Render the Markdown summary. Deterministic: no timestamps. */
+export declare function renderMarkdown(diff: DiffResult, options: MarkdownOptions): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,UAAU,EAAc,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAMxE,yCAAyC;AACzC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAevC;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBnD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAoDjF"}