@mokly/mokly 0.8.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource_graph.d.ts","sourceRoot":"","sources":["../../src/review/resource_graph.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,iFAAiF;AACjF,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CAC3D;AAED,oFAAoF;AACpF,qBAAa,aAAa;;IAGZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,uBAAuB;IAEtD,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;CAgBtE"}

package/dist/review/resource_graph.js

@@ -0,0 +1,27 @@
+/** Shared traversal of portable local resource references. */
+/** Cache shared edges while visiting every reachable resource, including cycles. */
+export class ResourceGraph {
+    reader;
+    #references = new Map();
+    constructor(reader) {
+        this.reader = reader;
+    }
+    async collect(seeds) {
+        const pending = [...seeds];
+        const seen = new Set();
+        for (let index = 0; index < pending.length; index += 1) {
+            const route = pending[index];
+            if (route === undefined || seen.has(route))
+                continue;
+            seen.add(route);
+            let references = this.#references.get(route);
+            if (!references) {
+                references = this.reader.readReferences(route);
+                this.#references.set(route, references);
+            }
+            pending.push(...(await references));
+        }
+        return seen;
+    }
+}
+//# sourceMappingURL=resource_graph.js.map

package/dist/review/resource_graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource_graph.js","sourceRoot":"","sources":["../../src/review/resource_graph.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAO9D,oFAAoF;AACpF,MAAM,OAAO,aAAa;IAGK;IAFpB,WAAW,GAAG,IAAI,GAAG,EAAsC,CAAC;IAErE,YAA6B,MAA+B;QAA/B,WAAM,GAAN,MAAM,CAAyB;IAAG,CAAC;IAEhE,KAAK,CAAC,OAAO,CAAC,KAAwB;QACpC,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YACrD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChB,IAAI,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC/C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,UAAU,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/review/result_helpers.d.ts

@@ -0,0 +1,15 @@
+export declare const compareText: (a: string, b: string) => number;
+export declare function reviewInvalid(message: string): never;
+export declare function reviewObject(value: unknown, required: readonly string[], optional?: readonly string[]): Record<string, unknown>;
+export declare function reviewArray(value: unknown): unknown[];
+export declare function reviewString(value: unknown): string;
+export declare function reviewId(value: unknown): string;
+export declare function reviewPath(value: unknown): string;
+export declare function reviewRoute(value: unknown): string;
+export declare function reviewStrings(value: unknown, validate?: typeof reviewString): string[];
+export declare function requireOrdered<T>(items: readonly T[], key: (value: T) => string): void;
+export declare function requireEqual(a: unknown, b: unknown): void;
+export declare function reviewAddress(value: unknown): Record<string, unknown>;
+export declare function reviewSides(record: Record<string, unknown>): void;
+export declare function reviewState(value: unknown): void;
+//# sourceMappingURL=result_helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result_helpers.d.ts","sourceRoot":"","sources":["../../src/review/result_helpers.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MACvB,CAAC;AAC7B,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAEpD;AACD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,GAAE,SAAS,MAAM,EAAO,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAGrD;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAInD;AACD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI/C;AACD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUjD;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASlD;AACD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,QAAQ,sBAAe,GACtB,MAAM,EAAE,CAIV;AACD,wBAAgB,cAAc,CAAC,CAAC,EAC9B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GACxB,IAAI,CAIN;AACD,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,IAAI,CAGzD;AACD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMrE;AACD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKjE;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAOhD"}

package/dist/review/result_helpers.js

@@ -0,0 +1,85 @@
+import { canonicalJson } from "../components/data.js";
+export const compareText = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+export function reviewInvalid(message) {
+    throw new Error(`[mokly/review] ${message}`);
+}
+export function reviewObject(value, required, optional = []) {
+    if (!value ||
+        typeof value !== "object" ||
+        Array.isArray(value) ||
+        ![null, Object.prototype].includes(Object.getPrototypeOf(value)))
+        reviewInvalid("expected an object");
+    const record = value;
+    const descriptors = Object.getOwnPropertyDescriptors(record);
+    if (Reflect.ownKeys(descriptors).some((key) => typeof key !== "string" ||
+        ![...required, ...optional].includes(key) ||
+        !("value" in descriptors[key])))
+        reviewInvalid("unknown or unsafe field");
+    if (required.some((key) => !Object.hasOwn(record, key) || record[key] === undefined))
+        reviewInvalid("required field is missing");
+    return record;
+}
+export function reviewArray(value) {
+    if (!Array.isArray(value))
+        reviewInvalid("expected an array");
+    return value;
+}
+export function reviewString(value) {
+    if (typeof value !== "string" || !value.trim())
+        reviewInvalid("expected a nonempty string");
+    return value;
+}
+export function reviewId(value) {
+    const id = reviewString(value);
+    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(id))
+        reviewInvalid("invalid entry id");
+    return id;
+}
+export function reviewPath(value) {
+    const path = reviewString(value);
+    if (path.startsWith("/") ||
+        path.includes("\\") ||
+        path.includes("\0") ||
+        path.split("/").some((part) => !part || part === "." || part === ".."))
+        reviewInvalid("unsafe path");
+    return path;
+}
+export function reviewRoute(value) {
+    const route = reviewPath(value);
+    if (!/^(?:[A-Za-z0-9][A-Za-z0-9._~-]*\/)*[A-Za-z0-9][A-Za-z0-9._~-]*\.html$/.test(route))
+        reviewInvalid("unsafe route");
+    return route;
+}
+export function reviewStrings(value, validate = reviewString) {
+    const strings = reviewArray(value).map(validate);
+    requireOrdered(strings, (value) => value);
+    return strings;
+}
+export function requireOrdered(items, key) {
+    for (let index = 1; index < items.length; index++)
+        if (key(items[index - 1]) >= key(items[index]))
+            reviewInvalid("records must be sorted and unique");
+}
+export function requireEqual(a, b) {
+    if (canonicalJson(a) !== canonicalJson(b))
+        reviewInvalid("inconsistent sides or references");
+}
+export function reviewAddress(value) {
+    const entry = reviewObject(value, ["id", "route", "title"]);
+    reviewId(entry.id);
+    reviewRoute(entry.route);
+    reviewString(entry.title);
+    return entry;
+}
+export function reviewSides(record) {
+    if (!record.before && !record.after)
+        reviewInvalid("at least one side is required");
+    for (const side of ["before", "after"])
+        if (record[side] !== undefined)
+            reviewAddress(record[side]);
+}
+export function reviewState(value) {
+    if (!["added", "changed", "removed", "ignored-only", "unchanged"].includes(String(value)))
+        reviewInvalid("unknown review state");
+}
+//# sourceMappingURL=result_helpers.js.map

package/dist/review/result_helpers.js.map

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

package/dist/review/result_records.d.ts

@@ -0,0 +1,5 @@
+export declare function validateReviewScreen(value: unknown, version: 2 | 3, component?: boolean): Record<string, unknown>;
+export declare function validateReviewViews(value: unknown, sides?: Record<string, unknown>): void;
+export declare function validateChangedEntry(value: unknown, changedPaths: readonly string[]): Record<string, unknown>;
+export declare function validateAffected(value: unknown): Record<string, unknown>;
+//# sourceMappingURL=result_records.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result_records.d.ts","sourceRoot":"","sources":["../../src/review/result_records.ts"],"names":[],"mappings":"AA0BA,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,CAAC,GAAG,CAAC,EACd,SAAS,UAAQ,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+DzB;AACD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CA0CN;AACD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,SAAS,MAAM,EAAE,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmDzB;AACD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2DxE"}

package/dist/review/result_records.js

@@ -0,0 +1,191 @@
+import { decodeProps } from "../components/codec.js";
+import { canonicalJson } from "../components/data.js";
+import { requireEqual, requireOrdered, reviewAddress, reviewArray, reviewId, reviewInvalid, reviewObject, reviewPath, reviewRoute, reviewSides, reviewState, reviewString, reviewStrings, } from "./result_helpers.js";
+const screenKeys = [
+    "dependencies",
+    "id",
+    "route",
+    "sharedImpact",
+    "state",
+    "title",
+];
+export function validateReviewScreen(value, version, component = false) {
+    const record = reviewObject(value, [...screenKeys, component ? "variants" : "views"], version === 3 ? ["before", "after"] : []);
+    reviewId(record.id);
+    reviewRoute(record.route);
+    reviewString(record.title);
+    reviewStrings(record.dependencies, reviewPath);
+    reviewStrings(record.sharedImpact, reviewPath);
+    reviewState(record.state);
+    if (version === 3) {
+        reviewSides(record);
+        requireEqual(record.after ?? record.before, {
+            id: record.id,
+            route: record.route,
+            title: record.title,
+        });
+    }
+    if (!component)
+        validateReviewViews(record.views, version === 3 ? record : undefined);
+    else {
+        const variants = reviewArray(record.variants);
+        if (!variants.length)
+            reviewInvalid("component variants are missing");
+        const ids = new Set();
+        for (const item of variants) {
+            const variant = reviewObject(item, ["id", "title", "state", "views"], ["before", "after"]);
+            reviewId(variant.id);
+            reviewString(variant.title);
+            reviewState(variant.state);
+            if (ids.has(variant.id) || (!variant.before && !variant.after))
+                reviewInvalid("invalid variant sides or identity");
+            ids.add(variant.id);
+            for (const side of ["before", "after"]) {
+                if (!variant[side])
+                    continue;
+                if (!record[side])
+                    reviewInvalid("variant has no entry side");
+                const address = reviewObject(variant[side], ["id", "title", "props", "suppliedSlots"], ["description"]);
+                requireEqual(address.id, variant.id);
+                reviewString(address.title);
+                if (address.description !== undefined)
+                    reviewString(address.description);
+                reviewStrings(address.suppliedSlots);
+                decodeProps(address.props);
+            }
+            const preferred = reviewObject(variant.after ?? variant.before, ["id", "title", "props", "suppliedSlots"], ["description"]);
+            requireEqual(preferred.title, variant.title);
+            validateReviewViews(variant.views, variant);
+        }
+    }
+    return record;
+}
+export function validateReviewViews(value, sides) {
+    const views = reviewArray(value);
+    if (!views.length)
+        reviewInvalid("view evidence is missing");
+    const keys = [];
+    for (const item of views) {
+        const view = reviewObject(item, ["viewport", "colorScheme", "ignoredIds", "state"], ["beforePath", "afterPath"]);
+        if (!["mobile", "desktop"].includes(String(view.viewport)) ||
+            !["light", "dark"].includes(String(view.colorScheme)))
+            reviewInvalid("invalid view context");
+        keys.push(`${view.viewport === "mobile" ? 0 : 1}:${view.colorScheme === "light" ? 0 : 1}`);
+        reviewStrings(view.ignoredIds, reviewId);
+        reviewState(view.state);
+        if (!view.beforePath && !view.afterPath)
+            reviewInvalid("view sides are missing");
+        if ((!view.beforePath && view.state !== "added") ||
+            (!view.afterPath && view.state !== "removed"))
+            reviewInvalid("missing view side has the wrong state");
+        if (view.beforePath &&
+            view.afterPath &&
+            (view.state === "added" || view.state === "removed"))
+            reviewInvalid("paired view has a missing-side state");
+        for (const side of ["before", "after"]) {
+            const path = view[`${side}Path`];
+            if (path === undefined)
+                continue;
+            if (sides && !sides[side])
+                reviewInvalid("view has no entry side");
+            if (!reviewRoute(path).startsWith(`snapshots/${side}/`))
+                reviewInvalid("snapshot belongs to the wrong side");
+        }
+    }
+    requireOrdered(keys, (key) => key);
+}
+export function validateChangedEntry(value, changedPaths) {
+    const record = reviewObject(value, ["kind", "reasons"], ["before", "after"]);
+    if (!["screen", "component", "use-case"].includes(String(record.kind)))
+        reviewInvalid("unknown changed entry kind");
+    reviewSides(record);
+    const reasons = reviewArray(record.reasons);
+    if (!reasons.length)
+        reviewInvalid("change reasons are empty");
+    const keys = [];
+    for (const raw of reasons) {
+        if (!raw || typeof raw !== "object" || !("kind" in raw))
+            reviewInvalid("invalid reason");
+        const reason = reviewObject(raw, raw.kind === "dependency"
+            ? ["kind", "path"]
+            : raw.kind === "screen"
+                ? ["kind", "route"]
+                : ["kind"]);
+        if (![
+            "added",
+            "removed",
+            "metadata",
+            "material",
+            "inputs",
+            "structure",
+            "dependency",
+            "screen",
+        ].includes(String(reason.kind)))
+            reviewInvalid("unknown reason");
+        if ((reason.kind === "added" && record.before) ||
+            (reason.kind === "removed" && record.after))
+            reviewInvalid("reason conflicts with available sides");
+        if (reason.kind === "dependency" &&
+            !changedPaths.includes(reviewPath(reason.path)))
+            reviewInvalid("dependency did not change");
+        if (reason.kind === "screen" &&
+            (record.kind !== "use-case" || !reviewRoute(reason.route)))
+            reviewInvalid("screen propagation requires a use case");
+        keys.push(`${reason.kind}:${reason.path ?? reason.route ?? ""}`);
+    }
+    requireOrdered(keys, (key) => key);
+    return record;
+}
+export function validateAffected(value) {
+    const record = reviewObject(value, [
+        "changedComponentId",
+        "consumer",
+        "evidence",
+    ]);
+    reviewId(record.changedComponentId);
+    const consumer = reviewObject(record.consumer, record.consumer &&
+        typeof record.consumer === "object" &&
+        "kind" in record.consumer &&
+        record.consumer.kind === "screen"
+        ? ["kind", "route"]
+        : ["kind", "id"]);
+    if (consumer.kind === "screen")
+        reviewRoute(consumer.route);
+    else if (consumer.kind === "component")
+        reviewId(consumer.id);
+    else
+        reviewInvalid("invalid affected consumer");
+    const evidence = reviewArray(record.evidence);
+    if (!evidence.length)
+        reviewInvalid("affected evidence is empty");
+    const keys = [];
+    for (const raw of evidence) {
+        const item = reviewObject(raw, ["side", "context", "via"]);
+        if (item.side !== "before" && item.side !== "after")
+            reviewInvalid("invalid evidence side");
+        const context = reviewObject(item.context, ["kind", "entry", "viewport", "colorScheme"], ["variantId"]);
+        const entry = reviewAddress(context.entry);
+        if (context.kind === "component")
+            reviewId(context.variantId);
+        else if (context.kind !== "screen" || context.variantId !== undefined)
+            reviewInvalid("invalid usage context");
+        if (!["mobile", "desktop"].includes(String(context.viewport)) ||
+            !["light", "dark"].includes(String(context.colorScheme)))
+            reviewInvalid("invalid usage view");
+        const chain = reviewArray(item.via).map((raw) => {
+            const edge = reviewObject(raw, ["componentId", "instanceKey"]);
+            reviewId(edge.componentId);
+            if (!/^[a-f0-9]{64}$/.test(reviewString(edge.instanceKey)))
+                reviewInvalid("invalid instance key");
+            return edge;
+        });
+        if (!chain.length ||
+            chain.at(-1).componentId !== record.changedComponentId ||
+            new Set(chain.map((edge) => edge.instanceKey)).size !== chain.length)
+            reviewInvalid("invalid ownership chain");
+        keys.push(`${item.side === "before" ? 0 : 1}:${entry.route}:${context.variantId ?? ""}:${context.viewport === "mobile" ? 0 : 1}:${context.colorScheme === "light" ? 0 : 1}:${canonicalJson(chain)}`);
+    }
+    requireOrdered(keys, (key) => key);
+    return record;
+}
+//# sourceMappingURL=result_records.js.map

package/dist/review/result_records.js.map

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

package/dist/review/result_validation.d.ts

@@ -0,0 +1,4 @@
+import type { ReviewResult } from "./types.js";
+/** Decode both published result versions; malformed new records never grant suppression. */
+export declare function parseReviewResult(value: unknown): ReviewResult;
+//# sourceMappingURL=result_validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result_validation.d.ts","sourceRoot":"","sources":["../../src/review/result_validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmB/C,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAQ9D"}

package/dist/review/result_validation.js

@@ -0,0 +1,142 @@
+import { canonicalJson } from "../components/data.js";
+import { requireEqual, requireOrdered, reviewArray, reviewId, reviewInvalid, reviewObject, reviewPath, reviewString, reviewStrings, } from "./result_helpers.js";
+import { validateAffected, validateChangedEntry, validateReviewScreen, } from "./result_records.js";
+/** Decode both published result versions; malformed new records never grant suppression. */
+export function parseReviewResult(value) {
+    try {
+        return validateResult(value);
+    }
+    catch (error) {
+        reviewInvalid(error instanceof Error ? error.message : "invalid comparison");
+    }
+}
+function validateResult(value) {
+    if (!value ||
+        typeof value !== "object" ||
+        !("schemaVersion" in value) ||
+        (value.schemaVersion !== 2 && value.schemaVersion !== 3))
+        reviewInvalid("unsupported result version");
+    const version = value.schemaVersion;
+    const result = reviewObject(value, [
+        "schemaVersion",
+        "baseCommit",
+        "baseRef",
+        "changedPaths",
+        "ignoredImpact",
+        "screens",
+        "sharedImpact",
+        ...(version === 3 ? ["components", "changes", "affectedConsumers"] : []),
+    ]);
+    if (!/^[a-f0-9]{40,64}$/.test(reviewString(result.baseCommit)))
+        reviewInvalid("invalid base commit");
+    reviewString(result.baseRef);
+    const changed = reviewStrings(result.changedPaths, reviewPath);
+    reviewStrings(result.sharedImpact, reviewPath);
+    const screens = reviewArray(result.screens).map((screen) => validateReviewScreen(screen, version));
+    requireOrdered(screens, (screen) => String(screen.route));
+    const ignoredKeys = [];
+    for (const raw of reviewArray(result.ignoredImpact)) {
+        const impact = reviewObject(raw, [
+            "viewport",
+            "colorScheme",
+            "id",
+            "count",
+        ]);
+        reviewId(impact.id);
+        if (!["mobile", "desktop"].includes(String(impact.viewport)) ||
+            !["light", "dark"].includes(String(impact.colorScheme)) ||
+            !Number.isSafeInteger(impact.count) ||
+            Number(impact.count) < 1)
+            reviewInvalid("invalid ignored impact");
+        ignoredKeys.push(`${impact.viewport === "mobile" ? 0 : 1}:${impact.colorScheme === "light" ? 0 : 1}:${impact.id}`);
+    }
+    requireOrdered(ignoredKeys, (key) => key);
+    if (version === 3) {
+        const components = reviewArray(result.components).map((component) => validateReviewScreen(component, 3, true));
+        requireOrdered(components, (component) => String(component.id));
+        const changes = reviewArray(result.changes).map((entry) => validateChangedEntry(entry, changed));
+        requireOrdered(changes, (entry) => {
+            const preferred = (entry.after ?? entry.before);
+            return `${preferred.route}:${entry.kind}:${preferred.id}`;
+        });
+        const routes = new Set();
+        for (const change of changes) {
+            const preferred = (change.after ?? change.before);
+            if (routes.has(String(preferred.route)))
+                reviewInvalid("duplicate routed Changes entry");
+            routes.add(String(preferred.route));
+            if (change.kind === "use-case")
+                continue;
+            const record = change.kind === "screen"
+                ? screens.find((screen) => screen.route === preferred.route)
+                : components.find((component) => component.id === preferred.id);
+            if (!record)
+                reviewInvalid("changed entry has no result record");
+            requireEqual({ before: record.before, after: record.after }, { before: change.before, after: change.after });
+        }
+        const affected = reviewArray(result.affectedConsumers).map(validateAffected);
+        requireOrdered(affected, (item) => {
+            const consumer = item.consumer;
+            return `${item.changedComponentId}:${consumer.kind}:${consumer.route ?? consumer.id}`;
+        });
+        validateResultReferences(value);
+    }
+    return value;
+}
+function validateResultReferences(result) {
+    const changed = new Set(result.changes
+        .filter((entry) => entry.kind === "component")
+        .map((entry) => (entry.after ?? entry.before).id));
+    for (const affected of result.affectedConsumers) {
+        if (!changed.has(affected.changedComponentId))
+            reviewInvalid("affected evidence has no directly changed component");
+        for (const evidence of affected.evidence) {
+            const context = evidence.context;
+            const owner = context.kind === "screen"
+                ? result.screens.find((screen) => screen.route === context.entry.route)
+                : result.components.find((component) => component.id === context.entry.id);
+            if (!owner?.[evidence.side])
+                reviewInvalid("affected context side is missing");
+            requireEqual(owner[evidence.side], context.entry);
+            const views = context.kind === "screen" && "views" in owner
+                ? owner.views
+                : "variants" in owner && context.kind === "component"
+                    ? owner.variants.find((variant) => variant.id === context.variantId)
+                        ?.views
+                    : undefined;
+            if (!views?.some((view) => view.viewport === context.viewport &&
+                view.colorScheme === context.colorScheme &&
+                view[`${evidence.side}Path`]))
+                reviewInvalid("affected context view is missing");
+            if (evidence.via.some((edge) => !result.components.some((component) => component.id === edge.componentId)))
+                reviewInvalid("unknown component in ownership chain");
+            if (affected.consumer.kind === "screen"
+                ? context.kind !== "screen" ||
+                    affected.consumer.route !== context.entry.route
+                : affected.consumer.id === affected.changedComponentId ||
+                    (affected.consumer.id !== context.entry.id &&
+                        !evidence.via
+                            .slice(0, -1)
+                            .some((edge) => edge.componentId ===
+                            affected.consumer.id)))
+                reviewInvalid("affected consumer does not own this chain");
+        }
+    }
+    for (const entry of result.changes)
+        for (const reason of entry.reasons)
+            if (reason.kind === "screen" &&
+                !result.changes.some((screen) => screen.kind === "screen" &&
+                    [screen.before?.route, screen.after?.route].includes(reason.route)))
+                reviewInvalid("use-case reason names a screen without a direct change");
+    const ignored = new Map();
+    for (const screen of result.screens)
+        for (const view of screen.views)
+            for (const id of view.ignoredIds) {
+                const key = canonicalJson([view.viewport, view.colorScheme, id]);
+                ignored.set(key, (ignored.get(key) ?? 0) + 1);
+            }
+    if (result.ignoredImpact.length !== ignored.size ||
+        result.ignoredImpact.some((item) => ignored.get(canonicalJson([item.viewport, item.colorScheme, item.id])) !== item.count))
+        reviewInvalid("ignored impact does not match view evidence");
+}
+//# sourceMappingURL=result_validation.js.map

package/dist/review/result_validation.js.map

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

package/dist/review/run.d.ts

@@ -0,0 +1,7 @@
+import { type GeneratedOutputStore } from "../build/output_store.js";
+import type { ResolvedConfig } from "../config/types.js";
+import { type GitClient } from "./git.js";
+import type { ReviewResult } from "./types.js";
+/** Build a Git comparison after proving head output is current. */
+export declare function runReview(config: ResolvedConfig, baseRef: string, outDir: string, git?: GitClient, outputStore?: GeneratedOutputStore, changedPathExclusions?: readonly string[]): Promise<ReviewResult>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/review/run.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,mEAAmE;AACnE,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,SAEJ,EACD,WAAW,GAAE,oBAA2D,EACxE,qBAAqB,GAAE,SAAS,MAAM,EAAO,GAC5C,OAAO,CAAC,YAAY,CAAC,CAevB"}

package/dist/review/run.js

@@ -0,0 +1,17 @@
+import { compileCatalogue } from "../build/compile.js";
+import { FileSystemGeneratedOutputStore, } from "../build/output_store.js";
+import { validateReviewOut } from "../config/path_validation.js";
+import { renderReviewArtifact } from "./artifact.js";
+import { compareReview } from "./compare.js";
+import { NodeGitCommandRunner, RepositoryGitClient, } from "./git.js";
+import { writeReviewArtifact } from "./write.js";
+/** Build a Git comparison after proving head output is current. */
+export async function runReview(config, baseRef, outDir, git = new RepositoryGitClient(new NodeGitCommandRunner(config.repoRoot)), outputStore = new FileSystemGeneratedOutputStore(), changedPathExclusions = []) {
+    validateReviewOut(outDir, config, "Review output", "review-invalid");
+    const compilation = await compileCatalogue(config);
+    outputStore.check(compilation, config);
+    const artifact = await compareReview(compilation, config, git, baseRef, outDir, undefined, changedPathExclusions);
+    await writeReviewArtifact(renderReviewArtifact(artifact), outDir, config);
+    return artifact.result;
+}
+//# sourceMappingURL=run.js.map

package/dist/review/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/review/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,8BAA8B,GAE/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GAEpB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAsB,EACtB,OAAe,EACf,MAAc,EACd,MAAiB,IAAI,mBAAmB,CACtC,IAAI,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAC1C,EACD,cAAoC,IAAI,8BAA8B,EAAE,EACxE,wBAA2C,EAAE;IAE7C,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC;IACrE,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACnD,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,MAAM,aAAa,CAClC,WAAW,EACX,MAAM,EACN,GAAG,EACH,OAAO,EACP,MAAM,EACN,SAAS,EACT,qBAAqB,CACtB,CAAC;IACF,MAAM,mBAAmB,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1E,OAAO,QAAQ,CAAC,MAAM,CAAC;AACzB,CAAC"}

package/dist/review/screen_compare.d.ts

@@ -0,0 +1,6 @@
+import type { Compilation } from "../build/compile.js";
+import type { ManifestScreen } from "../registry/types.js";
+import type { ReviewArtifactContent, ScreenReview } from "./types.js";
+/** Compare every viewport/scheme of one route, preserving its original documents. */
+export declare function compareScreen(base: ManifestScreen | undefined, head: ManifestScreen | undefined, baseDocuments: ReadonlyMap<string, Uint8Array>, compilation: Pick<Compilation, "outputs">, changedPaths: readonly string[], sharedImpact: readonly string[], files: Map<string, ReviewArtifactContent>, baseSeeds: Set<string>, headSeeds: Set<string>): Promise<ScreenReview>;
+//# sourceMappingURL=screen_compare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screen_compare.d.ts","sourceRoot":"","sources":["../../src/review/screen_compare.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAa3D,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB,qFAAqF;AACrF,wBAAsB,aAAa,CACjC,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,EAC9C,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,EACzC,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACzC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,OAAO,CAAC,YAAY,CAAC,CA8EvB"}