@mokly/mokly 0.8.0

package/dist/review/git_batch.js

@@ -0,0 +1,207 @@
+import { MoklyError, errorMessage } from "../errors.js";
+const MAX_BATCH_OUTPUT_BYTES = 48 * 1024 * 1024;
+const MAX_BLOBS_PER_BATCH = 4_096;
+const MAX_TREE_PATHS_PER_BATCH = 256;
+const MAX_TREE_PATHSPEC_BYTES = 24 * 1024;
+/** Read many regular files from one Git tree with bounded batch processes. */
+export async function readGitFiles(runner, commit, repoRelativePaths) {
+    const paths = [...new Set(repoRelativePaths)].sort();
+    if (paths.length === 0)
+        return new Map();
+    const tree = await readTree(runner, commit, paths);
+    const blobs = uniqueBlobs(tree);
+    const contents = new Map();
+    for (const batch of contentBatches(blobs)) {
+        const batchContents = await readBlobBatch(runner, batch);
+        for (const [objectId, bytes] of batchContents) {
+            contents.set(objectId, bytes);
+        }
+    }
+    const files = new Map();
+    for (const repoPath of paths) {
+        const record = tree.get(repoPath) ?? { kind: "missing" };
+        if (record.kind !== "regular") {
+            files.set(repoPath, { kind: record.kind });
+            continue;
+        }
+        const bytes = record.objectId ? contents.get(record.objectId) : undefined;
+        if (!bytes) {
+            throw new MoklyError("git-failed", `Git omitted regular file content for ${repoPath}`);
+        }
+        files.set(repoPath, { bytes, kind: "regular" });
+    }
+    return files;
+}
+async function readTree(runner, commit, paths) {
+    const requested = new Set(paths);
+    const records = new Map();
+    for (const batch of treePathBatches(paths)) {
+        let output;
+        try {
+            output = await runner.run([
+                "ls-tree",
+                "-zl",
+                "--full-tree",
+                commit,
+                "--",
+                ...batch.map((repoPath) => `:(literal)${repoPath}`),
+            ]);
+        }
+        catch (error) {
+            throw gitBatchError(`inspect files at ${commit}`, error);
+        }
+        for (const rawRecord of output.split("\0")) {
+            if (rawRecord === "")
+                continue;
+            const separator = rawRecord.indexOf("\t");
+            if (separator < 0) {
+                throw new MoklyError("git-failed", `Git returned invalid tree metadata at ${commit}`);
+            }
+            const repoPath = rawRecord.slice(separator + 1);
+            if (!requested.has(repoPath))
+                continue;
+            if (records.has(repoPath)) {
+                throw new MoklyError("git-failed", `Git returned multiple entries for ${repoPath}`);
+            }
+            records.set(repoPath, parseTreeRecord(rawRecord.slice(0, separator)));
+        }
+    }
+    return records;
+}
+function parseTreeRecord(metadata) {
+    const [mode = "", type = "", objectId = "", rawSize = ""] = metadata
+        .trim()
+        .split(/\s+/);
+    const kind = fileKind(mode);
+    if (kind !== "regular")
+        return { kind };
+    const size = Number(rawSize);
+    if (type !== "blob" ||
+        !/^[a-f0-9]{40,64}$/.test(objectId) ||
+        !Number.isSafeInteger(size) ||
+        size < 0) {
+        throw new MoklyError("git-failed", "Git returned invalid regular-file metadata");
+    }
+    return { kind, objectId, size };
+}
+function uniqueBlobs(tree) {
+    const blobs = new Map();
+    for (const [repoPath, record] of tree) {
+        if (record.kind === "regular" &&
+            record.objectId !== undefined &&
+            record.size !== undefined) {
+            blobs.set(record.objectId, {
+                objectId: record.objectId,
+                repoPath,
+                size: record.size,
+            });
+        }
+    }
+    return [...blobs.values()].sort((left, right) => left.objectId.localeCompare(right.objectId));
+}
+function contentBatches(blobs) {
+    const batches = [];
+    let current = [];
+    let currentOutputBytes = 0;
+    for (const blob of blobs) {
+        const outputBytes = blobOutputBytes(blob);
+        if (outputBytes > MAX_BATCH_OUTPUT_BYTES) {
+            throw new MoklyError("git-failed", `Git file ${blob.repoPath} is too large for a bounded Git batch ` +
+                `(${blob.size} bytes)`);
+        }
+        if (current.length > 0 &&
+            (current.length >= MAX_BLOBS_PER_BATCH ||
+                currentOutputBytes + outputBytes > MAX_BATCH_OUTPUT_BYTES)) {
+            batches.push(current);
+            current = [];
+            currentOutputBytes = 0;
+        }
+        current.push(blob);
+        currentOutputBytes += outputBytes;
+    }
+    if (current.length > 0)
+        batches.push(current);
+    return batches;
+}
+function blobOutputBytes(blob) {
+    return (Buffer.byteLength(`${blob.objectId} blob ${blob.size}\n`, "utf8") +
+        blob.size +
+        1);
+}
+async function readBlobBatch(runner, blobs) {
+    if (!runner.runBytesWithInput) {
+        throw new MoklyError("git-failed", "Git batch input is unavailable");
+    }
+    let output;
+    try {
+        output = await runner.runBytesWithInput(["cat-file", "--batch"], Buffer.from(`${blobs.map((blob) => blob.objectId).join("\n")}\n`));
+    }
+    catch (error) {
+        throw gitBatchError("read base snapshot batch", error);
+    }
+    return parseBlobBatch(output, blobs);
+}
+function parseBlobBatch(output, blobs) {
+    const contents = new Map();
+    let cursor = 0;
+    for (const blob of blobs) {
+        const headerEnd = output.indexOf(10, cursor);
+        if (headerEnd < 0)
+            throw invalidBatchOutput();
+        const header = Buffer.from(output.subarray(cursor, headerEnd)).toString("utf8");
+        const [objectId = "", type = "", rawSize = ""] = header.split(" ");
+        const size = Number(rawSize);
+        if (objectId !== blob.objectId ||
+            type !== "blob" ||
+            size !== blob.size ||
+            !Number.isSafeInteger(size)) {
+            throw invalidBatchOutput();
+        }
+        const contentStart = headerEnd + 1;
+        const contentEnd = contentStart + size;
+        if (contentEnd >= output.length || output[contentEnd] !== 10) {
+            throw invalidBatchOutput();
+        }
+        contents.set(objectId, output.slice(contentStart, contentEnd));
+        cursor = contentEnd + 1;
+    }
+    if (cursor !== output.length)
+        throw invalidBatchOutput();
+    return contents;
+}
+function treePathBatches(paths) {
+    const batches = [];
+    let current = [];
+    let currentBytes = 0;
+    for (const repoPath of paths) {
+        const pathspecBytes = Buffer.byteLength(`:(literal)${repoPath}`, "utf8") + 1;
+        if (current.length > 0 &&
+            (current.length >= MAX_TREE_PATHS_PER_BATCH ||
+                currentBytes + pathspecBytes > MAX_TREE_PATHSPEC_BYTES)) {
+            batches.push(current);
+            current = [];
+            currentBytes = 0;
+        }
+        current.push(repoPath);
+        currentBytes += pathspecBytes;
+    }
+    if (current.length > 0)
+        batches.push(current);
+    return batches;
+}
+function fileKind(mode) {
+    if (/^100[0-7]{3}$/.test(mode))
+        return "regular";
+    if (mode === "120000")
+        return "symlink";
+    return "other";
+}
+function invalidBatchOutput() {
+    return new MoklyError("git-failed", "Git returned invalid base snapshot batch output");
+}
+function gitBatchError(context, error) {
+    return new MoklyError("git-failed", `${context}: ${errorMessage(error)}`, {
+        cause: error,
+    });
+}
+//# sourceMappingURL=git_batch.js.map

package/dist/review/git_batch.js.map

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

package/dist/review/git_process.d.ts

@@ -0,0 +1,2 @@
+export declare function executeGit(cwd: string, arguments_: readonly string[], signal?: AbortSignal, input?: Uint8Array): Promise<Uint8Array>;
+//# sourceMappingURL=git_process.d.ts.map

package/dist/review/git_process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git_process.d.ts","sourceRoot":"","sources":["../../src/review/git_process.ts"],"names":[],"mappings":"AAMA,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,CAAC,EAAE,WAAW,EACpB,KAAK,CAAC,EAAE,UAAU,GACjB,OAAO,CAAC,UAAU,CAAC,CA2DrB"}

package/dist/review/git_process.js

@@ -0,0 +1,79 @@
+/** Cancellable Git commands settle only after the process and its pipes close. */
+import { spawn } from "node:child_process";
+const TERMINATION_GRACE_MS = 1000;
+const MAX_OUTPUT_BYTES = 64 * 1024 * 1024;
+export async function executeGit(cwd, arguments_, signal, input) {
+    signal?.throwIfAborted();
+    return new Promise((resolve, reject) => {
+        let failure;
+        const stdout = [];
+        const stderr = [];
+        let timer;
+        const grouped = signal !== undefined && process.platform !== "win32";
+        const child = spawn("git", [...arguments_], { cwd, detached: grouped });
+        const stop = () => {
+            if (timer)
+                return;
+            terminate(child, grouped, "SIGTERM");
+            timer = setTimeout(() => terminate(child, grouped, "SIGKILL"), TERMINATION_GRACE_MS);
+        };
+        const aborted = () => {
+            failure = new Error("The operation was aborted", {
+                cause: signal?.reason,
+            });
+            failure.name = "AbortError";
+            stop();
+        };
+        const capture = (buffers, name) => {
+            let bytes = 0;
+            return (chunk) => {
+                if (failure)
+                    return;
+                bytes += chunk.byteLength;
+                if (bytes > MAX_OUTPUT_BYTES) {
+                    failure = new Error(`${name} maxBuffer length exceeded`);
+                    stop();
+                }
+                else
+                    buffers.push(chunk);
+            };
+        };
+        child.stdout.on("data", capture(stdout, "stdout"));
+        child.stderr.on("data", capture(stderr, "stderr"));
+        child.once("error", (error) => {
+            failure ??= error;
+        });
+        child.once("close", (code, signalName) => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", aborted);
+            if (failure)
+                reject(failure);
+            else if (code !== 0)
+                reject(new Error(`Git exited with ${code ?? signalName}: ${Buffer.concat(stderr).toString("utf8")}`));
+            else
+                resolve(Buffer.concat(stdout));
+        });
+        child.stdin?.on("error", (error) => {
+            failure ??= error;
+            stop();
+        });
+        if (input !== undefined)
+            child.stdin?.end(Buffer.from(input));
+        signal?.addEventListener("abort", aborted, { once: true });
+    });
+}
+function terminate(child, grouped, signal) {
+    if (grouped && child.pid !== undefined) {
+        try {
+            process.kill(-child.pid, signal);
+            return;
+        }
+        catch (error) {
+            if (error.code !== "ESRCH")
+                child.kill(signal);
+        }
+    }
+    if (child.exitCode === null && child.signalCode === null)
+        child.kill(signal);
+}
+//# sourceMappingURL=git_process.js.map

package/dist/review/git_process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git_process.js","sourceRoot":"","sources":["../../src/review/git_process.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAE9D,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAClC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,UAA6B,EAC7B,MAAoB,EACpB,KAAkB;IAElB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,OAA0B,CAAC;QAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAgD,CAAC;QACrD,MAAM,OAAO,GAAG,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;QACrE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACxE,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,IAAI,KAAK;gBAAE,OAAO;YAClB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;YACrC,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAC1C,oBAAoB,CACrB,CAAC;QACJ,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,OAAO,GAAG,IAAI,KAAK,CAAC,2BAA2B,EAAE;gBAC/C,KAAK,EAAE,MAAM,EAAE,MAAM;aACtB,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC;YAC5B,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,CAAC,OAAiB,EAAE,IAAY,EAAE,EAAE;YAClD,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,KAAa,EAAE,EAAE;gBACvB,IAAI,OAAO;oBAAE,OAAO;gBACpB,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;gBAC1B,IAAI,KAAK,GAAG,gBAAgB,EAAE,CAAC;oBAC7B,OAAO,GAAG,IAAI,KAAK,CAAC,GAAG,IAAI,4BAA4B,CAAC,CAAC;oBACzD,IAAI,EAAE,CAAC;gBACT,CAAC;;oBAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC,CAAC;QACF,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnD,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5B,OAAO,KAAK,KAAK,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE;YACvC,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,IAAI,OAAO;gBAAE,MAAM,CAAC,OAAO,CAAC,CAAC;iBACxB,IAAI,IAAI,KAAK,CAAC;gBACjB,MAAM,CACJ,IAAI,KAAK,CACP,mBAAmB,IAAI,IAAI,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CACnF,CACF,CAAC;;gBACC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjC,OAAO,KAAK,KAAK,CAAC;YAClB,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;QACH,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9D,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAChB,KAAmB,EACnB,OAAgB,EAChB,MAAsB;IAEtB,IAAI,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/E,CAAC"}

package/dist/review/ignore.d.ts

@@ -0,0 +1,13 @@
+/** Pair-normalized documents and ignore evidence for one viewport. */
+export interface NormalizedReviewPair {
+    base: string;
+    head: string;
+    ignoredIds: readonly string[];
+}
+/** Normalize historical comparison material, never HTML with unconsumed offsets. */
+export declare function normalizeHistoricalDocument(content: string): string;
+/** Normalize only well-formed ignored regions present on both sides. */
+export declare function normalizeReviewPair(baseHtml: string, headHtml: string, route: string): NormalizedReviewPair;
+/** Validate and strip markers while retaining real child content. */
+export declare function normalizeSingleDocument(html: string, route: string): string;
+//# sourceMappingURL=ignore.d.ts.map

package/dist/review/ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.d.ts","sourceRoot":"","sources":["../../src/review/ignore.ts"],"names":[],"mappings":"AAiCA,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,oFAAoF;AACpF,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAInE;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,oBAAoB,CAkCtB;AAED,qEAAqE;AACrE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/review/ignore.js

@@ -0,0 +1,148 @@
+import { generatedSource } from "../build/ownership.js";
+const ID = "[a-z0-9]+(?:-[a-z0-9]+)*";
+const KEY = "[a-f0-9]{64}";
+const MARKER_SCAN = /<!--mokly-review-ignore:[\s\S]*?-->/g;
+const MARKER = new RegExp(`^<!--mokly-review-ignore:(start|end):(${ID})-->$`);
+const MATERIAL_SCAN = /<!--mokly-review-material:[\s\S]*?-->/g;
+const MATERIAL = new RegExp(`^<!--mokly-review-material:(${ID}):(${KEY})-->$`);
+const FORMER_MARKERS = [
+    ["<!--mokabook-component:", "<!--mokly-component:"],
+    ["<!--mokabook-review-ignore:", "<!--mokly-review-ignore:"],
+    ["<!--mokabook-review-material:", "<!--mokly-review-material:"],
+];
+/** Normalize historical comparison material, never HTML with unconsumed offsets. */
+export function normalizeHistoricalDocument(content) {
+    for (const [former, current] of FORMER_MARKERS)
+        content = content.replaceAll(former, current);
+    return content;
+}
+/** Normalize only well-formed ignored regions present on both sides. */
+export function normalizeReviewPair(baseHtml, headHtml, route) {
+    const base = parseDocument(baseHtml, route);
+    const head = parseDocument(headHtml, route);
+    const paired = new Set([...base.regions.keys()].filter((id) => head.regions.has(id)));
+    const materialIds = new Set([
+        ...base.materials.keys(),
+        ...head.materials.keys(),
+    ]);
+    const oneSidedMaterial = new Set([...materialIds].filter((id) => base.materials.has(id) !== head.materials.has(id)));
+    for (const id of oneSidedMaterial)
+        paired.delete(id);
+    const baseOnly = [...base.regions.keys()]
+        .filter((id) => !head.regions.has(id))
+        .sort();
+    const headOnly = [...head.regions.keys()]
+        .filter((id) => !base.regions.has(id))
+        .sort();
+    let normalizedBase = render(base, paired, oneSidedMaterial);
+    let normalizedHead = render(head, paired, oneSidedMaterial);
+    if (baseOnly.length > 0 && headOnly.length > 0) {
+        normalizedBase += contractToken(baseOnly);
+        normalizedHead += contractToken(headOnly);
+    }
+    const ignoredIds = [...paired]
+        .filter((id) => base.regions.get(id)?.content !== head.regions.get(id)?.content)
+        .sort();
+    return { base: normalizedBase, head: normalizedHead, ignoredIds };
+}
+/** Validate and strip markers while retaining real child content. */
+export function normalizeSingleDocument(html, route) {
+    return render(parseDocument(html, route), new Set());
+}
+function parseDocument(content, route) {
+    if (generatedSource(content))
+        content = content.slice(content.indexOf("\n") + 1);
+    const materials = parseMaterials(content, route);
+    const matches = [...content.matchAll(MARKER_SCAN)];
+    if (content.replace(MARKER_SCAN, "").includes("<!--mokly-review-ignore:")) {
+        throw ignoreError(route, "malformed or unterminated marker");
+    }
+    const segments = [];
+    const regions = new Map();
+    let cursor = 0;
+    let open;
+    for (const match of matches) {
+        const exact = match[0].match(MARKER);
+        if (!exact || match.index === undefined)
+            throw ignoreError(route, `invalid marker ${match[0]}`);
+        const boundary = exact[1];
+        const id = exact[2];
+        if (!id)
+            throw ignoreError(route, "marker id is missing");
+        if (boundary === "start") {
+            if (open)
+                throw ignoreError(route, `nested region ${id} inside ${open.id}`);
+            if (regions.has(id))
+                throw ignoreError(route, `duplicate region id ${id}`);
+            segments.push({
+                content: content.slice(cursor, match.index),
+                kind: "text",
+            });
+            open = { contentStart: match.index + match[0].length, id };
+        }
+        else {
+            if (!open)
+                throw ignoreError(route, `end marker for ${id} has no start`);
+            if (open.id !== id)
+                throw ignoreError(route, `end marker for ${id} does not match ${open.id}`);
+            const region = {
+                content: content.slice(open.contentStart, match.index),
+                id,
+                kind: "region",
+            };
+            regions.set(id, region);
+            segments.push(region);
+            cursor = match.index + match[0].length;
+            open = undefined;
+        }
+    }
+    if (open)
+        throw ignoreError(route, `region ${open.id} has no end marker`);
+    segments.push({ content: content.slice(cursor), kind: "text" });
+    for (const id of materials.keys()) {
+        if (!regions.has(id))
+            throw ignoreError(route, `material signal for ${id} has no region`);
+    }
+    for (const region of regions.values()) {
+        if (region.content.includes("<!--mokly-review-material:")) {
+            throw ignoreError(route, "material signals must be outside ignored regions");
+        }
+    }
+    return { materials, regions, segments };
+}
+function parseMaterials(content, route) {
+    const matches = [...content.matchAll(MATERIAL_SCAN)];
+    if (content.replace(MATERIAL_SCAN, "").includes("<!--mokly-review-material:")) {
+        throw ignoreError(route, "malformed or unterminated material signal");
+    }
+    const materials = new Map();
+    for (const match of matches) {
+        const exact = match[0].match(MATERIAL);
+        const id = exact?.[1];
+        const key = exact?.[2];
+        if (!id || !key)
+            throw ignoreError(route, `invalid material signal ${match[0]}`);
+        if (materials.has(id))
+            throw ignoreError(route, `duplicate material signal for ${id}`);
+        materials.set(id, key);
+    }
+    return materials;
+}
+function render(document, ignored, strippedMaterial = new Set()) {
+    const rendered = document.segments
+        .map((segment) => segment.kind === "region" && ignored.has(segment.id)
+        ? `<!--mokly-review-ignore:${segment.id}-->`
+        : segment.content)
+        .join("");
+    return rendered.replace(MATERIAL_SCAN, (candidate) => {
+        const id = candidate.match(MATERIAL)?.[1];
+        return id && strippedMaterial.has(id) ? "" : candidate;
+    });
+}
+function contractToken(ids) {
+    return `<!--mokly-review-ignore-contract:${ids.join(",")}-->`;
+}
+function ignoreError(route, detail) {
+    return new Error(`[mokly/review-ignore] ${route}: ${detail}`);
+}
+//# sourceMappingURL=ignore.js.map

package/dist/review/ignore.js.map

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

package/dist/review/markdown.d.ts

@@ -0,0 +1,5 @@
+/** Keep authored report text on one line without allowing Markdown markup. */
+export declare function markdownText(value: string): string;
+/** A code span whose delimiter cannot be closed by an authored value. */
+export declare function markdownCode(value: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/review/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/review/markdown.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQlD"}

package/dist/review/markdown.js

@@ -0,0 +1,17 @@
+/** Keep authored report text on one line without allowing Markdown markup. */
+export function markdownText(value) {
+    return value
+        .replace(/\s+/gu, " ")
+        .trim()
+        .replace(/&/g, "&")
+        .replace(/[\\`*_{}[\]()<>#+.!|~-]/g, "\\$&");
+}
+/** A code span whose delimiter cannot be closed by an authored value. */
+export function markdownCode(value) {
+    const text = value.replace(/\s+/gu, " ").trim();
+    const fence = "`".repeat(Math.max(0, ...[...text.matchAll(/`+/g)].map(([run]) => run.length)) + 1);
+    return text.includes("`")
+        ? `${fence} ${text} ${fence}`
+        : `${fence}${text}${fence}`;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/review/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/review/markdown.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK;SACT,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,IAAI,EAAE;SACN,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CACtB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CACzE,CAAC;IACF,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QACvB,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,IAAI,KAAK,EAAE;QAC7B,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AAChC,CAAC"}

package/dist/review/materiality.d.ts

@@ -0,0 +1,7 @@
+/** Separate comparison output changes from diagnostic impact evidence. */
+import type { ScreenReview } from "./types.js";
+/** Return whether a screen has impact evidence without a material output change. */
+export declare function isImpactOnly(screen: ScreenReview): boolean;
+/** Added, removed, or changed fragments are output changes; ignored-only is not. */
+export declare function hasOutputChange(screen: ScreenReview): boolean;
+//# sourceMappingURL=materiality.d.ts.map

package/dist/review/materiality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materiality.d.ts","sourceRoot":"","sources":["../../src/review/materiality.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE1D;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE7D"}

package/dist/review/materiality.js

@@ -0,0 +1,10 @@
+/** Separate comparison output changes from diagnostic impact evidence. */
+/** Return whether a screen has impact evidence without a material output change. */
+export function isImpactOnly(screen) {
+    return !hasOutputChange(screen) && screen.sharedImpact.length > 0;
+}
+/** Added, removed, or changed fragments are output changes; ignored-only is not. */
+export function hasOutputChange(screen) {
+    return ["added", "removed", "changed"].includes(screen.state);
+}
+//# sourceMappingURL=materiality.js.map

package/dist/review/materiality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materiality.js","sourceRoot":"","sources":["../../src/review/materiality.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAI1E,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;AACpE,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/review/page_baselines.d.ts

@@ -0,0 +1,7 @@
+import type { HistoricalManifest, ManifestPage } from "../registry/types.js";
+/** Historical document identity; sourcePath stays subject to baseline source protection. */
+type PageBaseline = Pick<ManifestPage, "route" | "sourcePath">;
+/** Attribute historical page artifacts to current IDs without synthesizing current metadata. */
+export declare function pageBaselines(current: HistoricalManifest, baseline: HistoricalManifest): ReadonlyMap<string, PageBaseline>;
+export {};
+//# sourceMappingURL=page_baselines.d.ts.map

package/dist/review/page_baselines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page_baselines.d.ts","sourceRoot":"","sources":["../../src/review/page_baselines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE7E,4FAA4F;AAC5F,KAAK,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,YAAY,CAAC,CAAC;AAE/D,gGAAgG;AAChG,wBAAgB,aAAa,CAC3B,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,kBAAkB,GAC3B,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAkBnC"}

package/dist/review/page_baselines.js

@@ -0,0 +1,16 @@
+/** Attribute historical page artifacts to current IDs without synthesizing current metadata. */
+export function pageBaselines(current, baseline) {
+    const historical = "sourceFiles" in baseline
+        ? new Map(baseline.entries.flatMap((entry) => entry.kind === "page" ? [[entry.id, entry]] : []))
+        : new Map(baseline.legacyPages.map((page) => [page.route, page]));
+    const matches = new Map();
+    for (const entry of current.entries) {
+        if (entry.kind !== "page")
+            continue;
+        const match = historical.get("sourceFiles" in baseline ? entry.id : entry.route);
+        if (match)
+            matches.set(entry.id, match);
+    }
+    return matches;
+}
+//# sourceMappingURL=page_baselines.js.map

package/dist/review/page_baselines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page_baselines.js","sourceRoot":"","sources":["../../src/review/page_baselines.ts"],"names":[],"mappings":"AAKA,gGAAgG;AAChG,MAAM,UAAU,aAAa,CAC3B,OAA2B,EAC3B,QAA4B;IAE5B,MAAM,UAAU,GACd,aAAa,IAAI,QAAQ;QACvB,CAAC,CAAC,IAAI,GAAG,CACL,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACjC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CACjD,CACF;QACH,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAChD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS;QACpC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAC1B,aAAa,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CACnD,CAAC;QACF,IAAI,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/review/paths.d.ts

@@ -0,0 +1,6 @@
+import type { ReviewArtifactContent } from "./types.js";
+/** Preserve a source route beneath one isolated Review snapshot. */
+export declare function snapshotPath(side: "after" | "before", route: string): string;
+/** Add one artifact file and fail instead of silently overwriting a collision. */
+export declare function addArtifactFile(files: Map<string, ReviewArtifactContent>, relative: string, content: ReviewArtifactContent): void;
+//# sourceMappingURL=paths.d.ts.map

package/dist/review/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/review/paths.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAQN"}

package/dist/review/paths.js

@@ -0,0 +1,13 @@
+import { MoklyError } from "../errors.js";
+/** Preserve a source route beneath one isolated Review snapshot. */
+export function snapshotPath(side, route) {
+    return `snapshots/${side}/${route}`;
+}
+/** Add one artifact file and fail instead of silently overwriting a collision. */
+export function addArtifactFile(files, relative, content) {
+    if (files.has(relative)) {
+        throw new MoklyError("review-invalid", `Review artifact path collision: ${relative}`);
+    }
+    files.set(relative, content);
+}
+//# sourceMappingURL=paths.js.map

package/dist/review/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/review/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,IAAwB,EAAE,KAAa;IAClE,OAAO,aAAa,IAAI,IAAI,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAC7B,KAAyC,EACzC,QAAgB,EAChB,OAA8B;IAE9B,IAAI,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAClB,gBAAgB,EAChB,mCAAmC,QAAQ,EAAE,CAC9C,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/review/resource_graph.d.ts

@@ -0,0 +1,13 @@
+/** Shared traversal of portable local resource references. */
+/** Resource edges supplied by a caller's validation and normalization policy. */
+export interface ResourceReferenceReader {
+    readReferences(route: string): Promise<readonly string[]>;
+}
+/** Cache shared edges while visiting every reachable resource, including cycles. */
+export declare class ResourceGraph {
+    #private;
+    private readonly reader;
+    constructor(reader: ResourceReferenceReader);
+    collect(seeds: readonly string[]): Promise<ReadonlySet<string>>;
+}
+//# sourceMappingURL=resource_graph.d.ts.map