@mokly/mokly 0.8.0

package/dist/review/component_classification.js

@@ -0,0 +1,202 @@
+import { variantAddress, viewPairs } from "./component_pairing.js";
+import path from "node:path";
+import { minimatch } from "minimatch";
+import { canonicalJson } from "../components/data.js";
+import { generatedViews } from "../components/views.js";
+import { toPosixPath } from "../config/paths.js";
+import { analyzeHierarchy } from "../registry/hierarchy.js";
+import { affectedConsumers } from "./component_affected.js";
+import { validateComponentReviewSources } from "./component_result_sources.js";
+import { address, ComponentDependencyPolicy, entryPairs, lexical, metadata, uniqueReasons, } from "./component_metadata.js";
+import { ComponentMaterialReader } from "./component_resources.js";
+import { compareComponentView, } from "./component_view.js";
+import { aggregateIgnored, aggregateState } from "./screen_views.js";
+/** The sole component-aware membership policy, shared by Browse, Review, and publishing. */
+export async function classifyComponents(input) {
+    const { before, after, changedPaths, config } = input;
+    const dependencies = new ComponentDependencyPolicy(before, after, config.review.sharedImpact);
+    const context = {
+        beforeReader: new ComponentMaterialReader(input.beforeReader),
+        afterReader: new ComponentMaterialReader(input.afterReader),
+        dependencies,
+        changed: new Set(changedPaths),
+        prefix: toPosixPath(path.relative(config.repoRoot, config.mockupsDir)),
+    };
+    await Promise.all([
+        context.beforeReader.prefetch(before.entries.flatMap((entry) => generatedViews(entry).map((view) => view.path))),
+        context.afterReader.prefetch(after.entries.flatMap((entry) => generatedViews(entry).map((view) => view.path))),
+    ]);
+    const sharedImpact = changedPaths.filter((path) => config.review.sharedImpact.some((glob) => minimatch(path, glob, { dot: true })));
+    const screens = [];
+    const components = [];
+    const changes = [];
+    const impacting = new Set();
+    const actualImplementations = new Set();
+    const pairs = entryPairs(before, after);
+    const beforeHierarchy = analyzeHierarchy(before.entries).hierarchy;
+    const afterHierarchy = analyzeHierarchy(after.entries).hierarchy;
+    for (const pair of pairs) {
+        const entry = (pair.after ?? pair.before);
+        const sides = {
+            ...(pair.before ? { before: address(pair.before) } : {}),
+            ...(pair.after ? { after: address(pair.after) } : {}),
+        };
+        const reasons = [];
+        if (!pair.before)
+            reasons.push({ kind: "added" });
+        if (!pair.after)
+            reasons.push({ kind: "removed" });
+        if (pair.before &&
+            pair.after &&
+            metadata(pair.before, before, beforeHierarchy) !==
+                metadata(pair.after, after, afterHierarchy))
+            reasons.push({ kind: "metadata" });
+        reasons.push(...dependencies.reasons(pair.before, pair.after, changedPaths));
+        const common = {
+            ...address(entry),
+            ...sides,
+            dependencies: [
+                ...new Set([
+                    ...(pair.before?.dependencies ?? []),
+                    ...(pair.after?.dependencies ?? []),
+                ]),
+            ].sort(),
+            sharedImpact: [
+                ...new Set([
+                    ...sharedImpact,
+                    ...reasons.flatMap((reason) => reason.kind === "dependency" ? [reason.path] : []),
+                ]),
+            ].sort(),
+        };
+        const baseViews = pair.before ? generatedViews(pair.before) : [];
+        const headViews = pair.after ? generatedViews(pair.after) : [];
+        const pairedViews = viewPairs(baseViews, headViews);
+        const compared = await Promise.all(pairedViews.map((view) => compareComponentView(context, view.before, view.after, entry.kind === "component" ? entry.id : undefined)));
+        reasons.push(...compared.flatMap((result) => result.reasons));
+        for (const comparison of compared)
+            for (const id of comparison.changedImplementations)
+                actualImplementations.add(id);
+        if (entry.kind === "screen")
+            screens.push({
+                ...common,
+                state: aggregateState(compared.map((result) => result.view.state)),
+                views: compared.map((result) => result.view),
+            });
+        if (entry.kind === "component") {
+            const bases = pair.before?.kind === "component" ? pair.before.variants : [];
+            const heads = pair.after?.kind === "component" ? pair.after.variants : [];
+            const variants = [];
+            for (const id of [
+                ...new Set([
+                    ...heads.map((variant) => variant.id),
+                    ...bases.map((variant) => variant.id),
+                ]),
+            ]) {
+                const base = bases.find((variant) => variant.id === id);
+                const head = heads.find((variant) => variant.id === id);
+                const selected = (head ?? base);
+                const variantComparisons = compared.filter((_result, index) => (pairedViews[index].after ?? pairedViews[index].before)
+                    ?.variantId === id);
+                const views = variantComparisons.map((result) => result.view);
+                variants.push({
+                    id,
+                    title: selected.title,
+                    ...(base ? { before: variantAddress(base) } : {}),
+                    ...(head ? { after: variantAddress(head) } : {}),
+                    state: aggregateState(views.map((view) => view.state)),
+                    views,
+                });
+                if (base &&
+                    head &&
+                    canonicalJson(base.props) === canonicalJson(head.props) &&
+                    variantComparisons.some((comparison) => comparison.reasons.length > 0) &&
+                    !reasons.some((reason) => reason.kind === "metadata"))
+                    impacting.add(entry.id);
+            }
+            if (reasons.some((reason) => reason.kind === "added" ||
+                reason.kind === "removed" ||
+                reason.kind === "dependency"))
+                impacting.add(entry.id);
+            components.push({
+                ...common,
+                state: aggregateState(variants.map((variant) => variant.state)),
+                variants,
+            });
+        }
+        if (reasons.length)
+            changes.push({
+                kind: entry.kind,
+                ...sides,
+                reasons: uniqueReasons(reasons),
+            });
+    }
+    for (const id of actualImplementations) {
+        impacting.add(id);
+        const component = components.find((entry) => entry.id === id);
+        const existing = changes.find((entry) => entry.kind === "component" && (entry.after ?? entry.before).id === id);
+        if (existing)
+            existing.reasons = uniqueReasons([
+                ...existing.reasons,
+                { kind: "material" },
+            ]);
+        else
+            changes.push({
+                kind: "component",
+                ...(component.before ? { before: component.before } : {}),
+                ...(component.after ? { after: component.after } : {}),
+                reasons: [{ kind: "material" }],
+            });
+    }
+    const changedScreens = new Set(changes
+        .filter((entry) => entry.kind === "screen")
+        .flatMap((entry) => [entry.before?.route, entry.after?.route].filter((route) => route !== undefined)));
+    for (const pair of pairs) {
+        const entry = (pair.after ?? pair.before);
+        if (entry.kind !== "use-case")
+            continue;
+        const routes = new Set([pair.before, pair.after].flatMap((item, index) => item?.kind === "use-case"
+            ? item.steps.flatMap((step) => (index === 0 ? before : after).entries.flatMap((screen) => screen.kind === "screen" &&
+                screen.id === step.screenId &&
+                changedScreens.has(screen.route)
+                ? [screen.route]
+                : []))
+            : []));
+        if (!routes.size)
+            continue;
+        const existing = changes.find((change) => change.kind === "use-case" &&
+            (change.after ?? change.before)?.route === entry.route);
+        const reasons = uniqueReasons([
+            ...(existing?.reasons ?? []),
+            ...[...routes].map((route) => ({ kind: "screen", route })),
+        ]);
+        if (existing)
+            existing.reasons = reasons;
+        else
+            changes.push({
+                kind: "use-case",
+                ...(pair.before ? { before: address(pair.before) } : {}),
+                ...(pair.after ? { after: address(pair.after) } : {}),
+                reasons,
+            });
+    }
+    screens.sort((a, b) => lexical(a.route, b.route));
+    components.sort((a, b) => lexical(a.id, b.id));
+    changes.sort((a, b) => lexical((a.after ?? a.before).route, (b.after ?? b.before).route) ||
+        lexical(a.kind, b.kind) ||
+        lexical((a.after ?? a.before).id, (b.after ?? b.before).id));
+    const result = {
+        schemaVersion: 3,
+        baseCommit: input.baseCommit,
+        baseRef: input.baseRef,
+        changedPaths: [...changedPaths].sort(),
+        sharedImpact,
+        screens,
+        components,
+        changes,
+        affectedConsumers: affectedConsumers(before, after, impacting),
+        ignoredImpact: aggregateIgnored(screens),
+    };
+    validateComponentReviewSources(result, before, after, impacting);
+    return result;
+}
+//# sourceMappingURL=component_classification.js.map

package/dist/review/component_classification.js.map

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

package/dist/review/component_compare.d.ts

@@ -0,0 +1,8 @@
+import type { Compilation } from "../build/compile.js";
+import type { ResolvedConfig } from "../config/types.js";
+import type { Manifest } from "../registry/types.js";
+import { type GitReviewAssetReader, type ReviewAssetReader } from "./assets.js";
+import type { ReviewArtifact } from "./types.js";
+/** Retain every component variant and affected screen, then classify the same immutable bytes. */
+export declare function compareComponentCatalogue(compilation: Compilation, baseline: Manifest, config: ResolvedConfig, baseReader: GitReviewAssetReader, headReader: ReviewAssetReader, changedPaths: readonly string[], baseCommit: string, baseRef: string): Promise<ReviewArtifact>;
+//# sourceMappingURL=component_compare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component_compare.d.ts","sourceRoot":"","sources":["../../src/review/component_compare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,YAAY,CAAC;AAExE,kGAAkG;AAClG,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,oBAAoB,EAChC,UAAU,EAAE,iBAAiB,EAC7B,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC,CAqDzB"}

package/dist/review/component_compare.js

@@ -0,0 +1,40 @@
+import { generatedViews } from "../components/views.js";
+import { copySnapshotDependencies, } from "./assets.js";
+import { classifyComponents } from "./component_classification.js";
+import { addArtifactFile, snapshotPath } from "./paths.js";
+/** Retain every component variant and affected screen, then classify the same immutable bytes. */
+export async function compareComponentCatalogue(compilation, baseline, config, baseReader, headReader, changedPaths, baseCommit, baseRef) {
+    const basePaths = baseline.entries.flatMap((entry) => generatedViews(entry).map((view) => view.path));
+    const headPaths = compilation.manifest.entries.flatMap((entry) => generatedViews(entry).map((view) => view.path));
+    const baseFiles = await baseReader.readMany(basePaths);
+    const beforeReader = {
+        read: async (route) => baseFiles.get(route) ?? baseReader.read(route),
+    };
+    const afterReader = {
+        read: async (route) => {
+            const generated = compilation.outputs.get(route);
+            return generated === undefined
+                ? headReader.read(route)
+                : Buffer.from(generated);
+        },
+    };
+    const result = await classifyComponents({
+        before: baseline,
+        after: compilation.manifest,
+        beforeReader,
+        afterReader,
+        config,
+        changedPaths,
+        baseCommit,
+        baseRef,
+    });
+    const files = new Map();
+    for (const route of basePaths)
+        addArtifactFile(files, snapshotPath("before", route), Buffer.from(await beforeReader.read(route)).toString("utf8"));
+    for (const route of headPaths)
+        addArtifactFile(files, snapshotPath("after", route), Buffer.from(await afterReader.read(route)).toString("utf8"));
+    await copySnapshotDependencies(files, "before", new Set(basePaths), (route) => beforeReader.read(route), (routes) => baseReader.readMany(routes));
+    await copySnapshotDependencies(files, "after", new Set(headPaths), (route) => afterReader.read(route));
+    return { result, files };
+}
+//# sourceMappingURL=component_compare.js.map

package/dist/review/component_compare.js.map

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

package/dist/review/component_metadata.d.ts

@@ -0,0 +1,29 @@
+import type { ComponentViewRecord } from "../components/manifest_types.js";
+import { type CatalogueHierarchy } from "../registry/hierarchy.js";
+import type { Manifest, ManifestEntry } from "../registry/types.js";
+import type { EntryChangeReason, ReviewEntryAddress } from "./component_types.js";
+export type RoutedEntry = Exclude<ManifestEntry, {
+    kind: "collection" | "page";
+}>;
+export declare const address: (entry: RoutedEntry) => ReviewEntryAddress;
+export declare const lexical: (a: string, b: string) => number;
+export declare function entryPairs(before: Manifest, after: Manifest): {
+    before: RoutedEntry | undefined;
+    after: RoutedEntry | undefined;
+}[];
+export declare function metadata(entry: RoutedEntry, manifest: Manifest, hierarchy?: CatalogueHierarchy<ManifestEntry>): string;
+/** Explicit owners override broad consumer declarations, retaining exact screen evidence. */
+export declare class ComponentDependencyPolicy {
+    private readonly shared;
+    private readonly components;
+    private readonly ownersByPath;
+    private readonly sharedByPath;
+    constructor(before: Manifest, after: Manifest, shared: readonly string[]);
+    owners(changed: string): ReadonlySet<string>;
+    independent(entry: RoutedEntry, changed: string): boolean;
+    reasons(before: RoutedEntry | undefined, after: RoutedEntry | undefined, changed: readonly string[]): EntryChangeReason[];
+    private sharedPath;
+    suppressResource(repoPath: string, publicPath: string, paired: ReadonlySet<string>, before?: ComponentViewRecord, after?: ComponentViewRecord, root?: string): boolean;
+}
+export declare function uniqueReasons(reasons: readonly EntryChangeReason[]): EntryChangeReason[];
+//# sourceMappingURL=component_metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component_metadata.d.ts","sourceRoot":"","sources":["../../src/review/component_metadata.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,WAAW,GAAG,OAAO,CAC/B,aAAa,EACb;IAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAAA;CAAE,CAChC,CAAC;AACF,eAAO,MAAM,OAAO,GAAI,OAAO,WAAW,KAAG,kBAI3C,CAAC;AACH,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MACnB,CAAC;AAC7B,wBAAgB,UAAU,CACxB,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,QAAQ,GACd;IAAE,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,EAAE,CAoBvE;AACD,wBAAgB,QAAQ,CACtB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,QAAQ,EAClB,SAAS,GAAE,kBAAkB,CAAC,aAAa,CAEhC,GACV,MAAM,CA0BR;AAED,6FAA6F;AAC7F,qBAAa,yBAAyB;IAUlC,OAAO,CAAC,QAAQ,CAAC,MAAM;IATzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGvB;IACJ,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0C;IACvE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8B;gBAEzD,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,QAAQ,EACE,MAAM,EAAE,SAAS,MAAM,EAAE;IAO5C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAgB5C,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAWzD,OAAO,CACL,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,KAAK,EAAE,WAAW,GAAG,SAAS,EAC9B,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,iBAAiB,EAAE;IAOtB,OAAO,CAAC,UAAU;IAUlB,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAC3B,MAAM,CAAC,EAAE,mBAAmB,EAC5B,KAAK,CAAC,EAAE,mBAAmB,EAC3B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO;CAcX;AACD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,iBAAiB,EAAE,GACpC,iBAAiB,EAAE,CAWrB"}

package/dist/review/component_metadata.js

@@ -0,0 +1,107 @@
+import { minimatch } from "minimatch";
+import { canonicalJson } from "../components/data.js";
+import { dependencyContainsChangedPath } from "../registry/dependency_paths.js";
+import { analyzeHierarchy, } from "../registry/hierarchy.js";
+export const address = (entry) => ({
+    id: entry.id,
+    route: entry.route,
+    title: entry.title,
+});
+export const lexical = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+export function entryPairs(before, after) {
+    const key = (entry) => `${entry.kind}:${entry.kind === "component" ? entry.id : entry.route}`;
+    const bases = new Map(before.entries.flatMap((entry) => entry.kind === "collection" || entry.kind === "page"
+        ? []
+        : [[key(entry), entry]]));
+    const heads = new Map(after.entries.flatMap((entry) => entry.kind === "collection" || entry.kind === "page"
+        ? []
+        : [[key(entry), entry]]));
+    return [...new Set([...bases.keys(), ...heads.keys()])]
+        .sort()
+        .map((id) => ({ before: bases.get(id), after: heads.get(id) }));
+}
+export function metadata(entry, manifest, hierarchy = analyzeHierarchy(manifest.entries).hierarchy) {
+    const ancestors = hierarchy.ancestorsById
+        .get(entry.id)
+        ?.map(({ id, title }) => ({ id, title }));
+    const { dependencies: _dependencies, declaredDependencies: _declaredDependencies, sourcePath: _source, navPath: _navPath, ...common } = entry;
+    if (entry.kind === "component") {
+        const { variants: _variants, ...component } = common;
+        return canonicalJson({
+            ...component,
+            ancestors,
+            variants: entry.variants.map(({ componentViews: _views, ...variant }) => variant),
+        });
+    }
+    if (entry.kind === "screen") {
+        const { componentViews: _views, ...screen } = common;
+        return canonicalJson({ ...screen, ancestors });
+    }
+    return canonicalJson({ ...common, ancestors });
+}
+/** Explicit owners override broad consumer declarations, retaining exact screen evidence. */
+export class ComponentDependencyPolicy {
+    shared;
+    components;
+    ownersByPath = new Map();
+    sharedByPath = new Map();
+    constructor(before, after, shared) {
+        this.shared = shared;
+        this.components = [...before.entries, ...after.entries].filter((entry) => entry.kind === "component");
+    }
+    owners(changed) {
+        let owners = this.ownersByPath.get(changed);
+        if (!owners) {
+            owners = new Set(this.components.flatMap((entry) => entry.ownedDependencies.some((root) => dependencyContainsChangedPath(root, changed))
+                ? [entry.id]
+                : []));
+            this.ownersByPath.set(changed, owners);
+        }
+        return owners;
+    }
+    independent(entry, changed) {
+        const owners = this.owners(changed);
+        if (owners.has(entry.id) && entry.kind === "component")
+            return true;
+        const declared = entry.declaredDependencies ?? [];
+        if (entry.kind === "screen" && declared.includes(changed))
+            return true;
+        if (owners.size)
+            return false;
+        return (declared.some((root) => dependencyContainsChangedPath(root, changed)) ||
+            this.sharedPath(changed));
+    }
+    reasons(before, after, changed) {
+        return changed
+            .filter((item) => [before, after].some((entry) => entry && this.independent(entry, item)))
+            .map((path) => ({ kind: "dependency", path }));
+    }
+    sharedPath(changed) {
+        let matches = this.sharedByPath.get(changed);
+        if (matches === undefined) {
+            matches = this.shared.some((glob) => minimatch(changed, glob, { dot: true }));
+            this.sharedByPath.set(changed, matches);
+        }
+        return matches;
+    }
+    suppressResource(repoPath, publicPath, paired, before, after, root) {
+        if (!before || !after)
+            return false;
+        const owners = this.owners(repoPath);
+        if (owners.size && [...owners].every((id) => id !== root && paired.has(id)))
+            return true;
+        const left = before.resources.find((item) => item.path === publicPath);
+        const right = after.resources.find((item) => item.path === publicPath);
+        return Boolean(left &&
+            right &&
+            canonicalJson(left.componentIds) === canonicalJson(right.componentIds) &&
+            left.componentIds.every((id) => id !== root && paired.has(id)));
+    }
+}
+export function uniqueReasons(reasons) {
+    return [
+        ...new Map(reasons.map((item) => [canonicalJson(item), item])).values(),
+    ].sort((a, b) => lexical(a.kind, b.kind) ||
+        lexical("path" in a ? a.path : "route" in a ? a.route : "", "path" in b ? b.path : "route" in b ? b.route : ""));
+}
+//# sourceMappingURL=component_metadata.js.map

package/dist/review/component_metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component_metadata.js","sourceRoot":"","sources":["../../src/review/component_metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EACL,gBAAgB,GAEjB,MAAM,0BAA0B,CAAC;AAWlC,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAkB,EAAsB,EAAE,CAAC,CAAC;IAClE,EAAE,EAAE,KAAK,CAAC,EAAE;IACZ,KAAK,EAAE,KAAK,CAAC,KAAK;IAClB,KAAK,EAAE,KAAK,CAAC,KAAK;CACnB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CACtD,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7B,MAAM,UAAU,UAAU,CACxB,MAAgB,EAChB,KAAe;IAEf,MAAM,GAAG,GAAG,CAAC,KAAkB,EAAE,EAAE,CACjC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACzE,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC/B,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAClD,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,CAAU,CAAC,CACnC,CACF,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9B,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAClD,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,CAAU,CAAC,CACnC,CACF,CAAC;IACF,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;SACpD,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACpE,CAAC;AACD,MAAM,UAAU,QAAQ,CACtB,KAAkB,EAClB,QAAkB,EAClB,YAA+C,gBAAgB,CAC7D,QAAQ,CAAC,OAAO,CACjB,CAAC,SAAS;IAEX,MAAM,SAAS,GAAG,SAAS,CAAC,aAAa;SACtC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACd,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,EACJ,YAAY,EAAE,aAAa,EAC3B,oBAAoB,EAAE,qBAAqB,EAC3C,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,QAAQ,EACjB,GAAG,MAAM,EACV,GAAG,KAAK,CAAC;IACV,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC/B,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,MAAsB,CAAC;QACrE,OAAO,aAAa,CAAC;YACnB,GAAG,SAAS;YACZ,SAAS;YACT,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAC1B,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CACpD;SACF,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAsB,CAAC;QACrE,OAAO,aAAa,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,aAAa,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,6FAA6F;AAC7F,MAAM,OAAO,yBAAyB;IAUjB;IATF,UAAU,CAGvB;IACa,YAAY,GAAG,IAAI,GAAG,EAA+B,CAAC;IACtD,YAAY,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC3D,YACE,MAAgB,EAChB,KAAe,EACE,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;QAE1C,IAAI,CAAC,UAAU,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAC5D,CAAC,KAAK,EAA0D,EAAE,CAChE,KAAK,CAAC,IAAI,KAAK,WAAW,CAC7B,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,OAAe;QACpB,IAAI,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,GAAG,CACd,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAChC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACpC,6BAA6B,CAAC,IAAI,EAAE,OAAO,CAAC,CAC7C;gBACC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACZ,CAAC,CAAC,EAAE,CACP,CACF,CAAC;YACF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,WAAW,CAAC,KAAkB,EAAE,OAAe;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QACpE,MAAM,QAAQ,GAAG,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACvE,IAAI,MAAM,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9B,OAAO,CACL,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,6BAA6B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACrE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CACzB,CAAC;IACJ,CAAC;IACD,OAAO,CACL,MAA+B,EAC/B,KAA8B,EAC9B,OAA0B;QAE1B,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACf,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CACxE;aACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;IACO,UAAU,CAAC,OAAe;QAChC,IAAI,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAClC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CACxC,CAAC;YACF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,gBAAgB,CACd,QAAgB,EAChB,UAAkB,EAClB,MAA2B,EAC3B,MAA4B,EAC5B,KAA2B,EAC3B,IAAa;QAEb,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzE,OAAO,IAAI,CAAC;QACd,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QACvE,OAAO,OAAO,CACZ,IAAI;YACJ,KAAK;YACL,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC;YACtE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAC/D,CAAC;IACJ,CAAC;CACF;AACD,MAAM,UAAU,aAAa,CAC3B,OAAqC;IAErC,OAAO;QACL,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;KACxE,CAAC,IAAI,CACJ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QACvB,OAAO,CACL,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAClD,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CACnD,CACJ,CAAC;AACJ,CAAC"}

package/dist/review/component_pairing.d.ts

@@ -0,0 +1,9 @@
+import type { ManifestComponentVariant } from "../components/manifest_types.js";
+import type { GeneratedComponentView } from "../components/views.js";
+import type { ReviewVariantAddress } from "./component_types.js";
+export declare function variantAddress(variant: ManifestComponentVariant): ReviewVariantAddress;
+export declare function viewPairs(before: readonly GeneratedComponentView[], after: readonly GeneratedComponentView[]): {
+    before: GeneratedComponentView | undefined;
+    after: GeneratedComponentView | undefined;
+}[];
+//# sourceMappingURL=component_pairing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component_pairing.d.ts","sourceRoot":"","sources":["../../src/review/component_pairing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,wBAAgB,cAAc,CAC5B,OAAO,EAAE,wBAAwB,GAChC,oBAAoB,CAQtB;AACD,wBAAgB,SAAS,CACvB,MAAM,EAAE,SAAS,sBAAsB,EAAE,EACzC,KAAK,EAAE,SAAS,sBAAsB,EAAE;;;IASzC"}

package/dist/review/component_pairing.js

@@ -0,0 +1,18 @@
+export function variantAddress(variant) {
+    return {
+        id: variant.id,
+        title: variant.title,
+        ...(variant.description ? { description: variant.description } : {}),
+        props: variant.props,
+        suppliedSlots: variant.suppliedSlots,
+    };
+}
+export function viewPairs(before, after) {
+    const key = (view) => `${view.variantId ?? ""}:${view.viewport === "mobile" ? 0 : 1}:${view.colorScheme === "light" ? 0 : 1}`;
+    const bases = new Map(before.map((view) => [key(view), view]));
+    const heads = new Map(after.map((view) => [key(view), view]));
+    return [...new Set([...bases.keys(), ...heads.keys()])]
+        .sort()
+        .map((key) => ({ before: bases.get(key), after: heads.get(key) }));
+}
+//# sourceMappingURL=component_pairing.js.map

package/dist/review/component_pairing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component_pairing.js","sourceRoot":"","sources":["../../src/review/component_pairing.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,cAAc,CAC5B,OAAiC;IAEjC,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,SAAS,CACvB,MAAyC,EACzC,KAAwC;IAExC,MAAM,GAAG,GAAG,CAAC,IAA4B,EAAE,EAAE,CAC3C,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1G,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;SACpD,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/review/component_resources.d.ts

@@ -0,0 +1,14 @@
+import type { ReviewAssetReader } from "./assets.js";
+/** One immutable read cache per source side; it never copies or writes snapshots. */
+export declare class ComponentMaterialReader {
+    private readonly reader;
+    private readonly files;
+    private readonly graph;
+    constructor(reader: ReviewAssetReader);
+    /** Load known view documents together without changing lazy resource discovery. */
+    prefetch(routes: readonly string[]): Promise<void>;
+    read(route: string): Promise<Uint8Array>;
+    text(route: string): Promise<string>;
+    resources(route: string, html: string, excluded: (route: string) => boolean): Promise<ReadonlySet<string>>;
+}
+//# sourceMappingURL=component_resources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component_resources.d.ts","sourceRoot":"","sources":["../../src/review/component_resources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,qFAAqF;AACrF,qBAAa,uBAAuB;IAGtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;gBACT,MAAM,EAAE,iBAAiB;IAQtD,mFAAmF;IAC7E,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQlC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGpC,SAAS,CACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GACnC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;CAMhC"}

package/dist/review/component_resources.js

@@ -0,0 +1,50 @@
+import { MoklyError } from "../errors.js";
+import { referencedRoutes } from "./asset_references.js";
+import { ResourceGraph } from "./resource_graph.js";
+/** One immutable read cache per source side; it never copies or writes snapshots. */
+export class ComponentMaterialReader {
+    reader;
+    files = new Map();
+    graph;
+    constructor(reader) {
+        this.reader = reader;
+        this.graph = new ResourceGraph({
+            readReferences: async (route) => referencedRoutes(route, await this.read(route), {
+                resourceHints: false,
+            }),
+        });
+    }
+    /** Load known view documents together without changing lazy resource discovery. */
+    async prefetch(routes) {
+        if (!this.reader.readMany)
+            return;
+        const missing = [...new Set(routes)].filter((route) => !this.files.has(route));
+        if (missing.length === 0)
+            return;
+        const loaded = await this.reader.readMany(missing);
+        for (const route of missing) {
+            const content = loaded.get(route);
+            if (content === undefined)
+                throw new MoklyError("review-invalid", `could not retain Review asset ${route}: batch reader omitted the file`);
+            this.files.set(route, Promise.resolve(content));
+        }
+    }
+    read(route) {
+        let result = this.files.get(route);
+        if (!result) {
+            result = this.reader.read(route);
+            this.files.set(route, result);
+        }
+        return result;
+    }
+    async text(route) {
+        return Buffer.from(await this.read(route)).toString("utf8");
+    }
+    async resources(route, html, excluded) {
+        const seeds = referencedRoutes(route, html, {
+            resourceHints: false,
+        }).filter((path) => !excluded(path));
+        return this.graph.collect(seeds);
+    }
+}
+//# sourceMappingURL=component_resources.js.map

package/dist/review/component_resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component_resources.js","sourceRoot":"","sources":["../../src/review/component_resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,qFAAqF;AACrF,MAAM,OAAO,uBAAuB;IAGL;IAFZ,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC/C,KAAK,CAAgB;IACtC,YAA6B,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;QACpD,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC;YAC7B,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAC9B,gBAAgB,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;gBAC9C,aAAa,EAAE,KAAK;aACrB,CAAC;SACL,CAAC,CAAC;IACL,CAAC;IACD,mFAAmF;IACnF,KAAK,CAAC,QAAQ,CAAC,MAAyB;QACtC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,OAAO;QAClC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CACzC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAClC,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,OAAO,KAAK,SAAS;gBACvB,MAAM,IAAI,UAAU,CAClB,gBAAgB,EAChB,iCAAiC,KAAK,iCAAiC,CACxE,CAAC;YACJ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,IAAI,CAAC,KAAa;QAChB,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IACD,KAAK,CAAC,SAAS,CACb,KAAa,EACb,IAAY,EACZ,QAAoC;QAEpC,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE;YAC1C,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/review/component_result_sources.d.ts

@@ -0,0 +1,5 @@
+import type { Manifest } from "../registry/types.js";
+import type { ReviewResultV3 } from "./component_types.js";
+/** Validate result coverage, addresses, data, dependency and usage references against both manifests. */
+export declare function validateComponentReviewSources(result: ReviewResultV3, before: Manifest, after: Manifest, implementationImpact: ReadonlySet<string>): void;
+//# sourceMappingURL=component_result_sources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component_result_sources.d.ts","sourceRoot":"","sources":["../../src/review/component_result_sources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D,yGAAyG;AACzG,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,QAAQ,EACf,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,GACxC,IAAI,CA4GN"}