@mokly/mokly 0.8.0

package/dist/review/assets.d.ts

@@ -0,0 +1,45 @@
+import type { FileLocation } from "../config/file_locations.js";
+import type { ResolvedConfig } from "../config/types.js";
+import type { GitClient } from "./git.js";
+import type { ReviewArtifactContent } from "./types.js";
+/** Filesystem boundary for current-worktree Review assets. */
+export interface ReviewAssetReader {
+    read(route: string): Promise<Uint8Array>;
+    /** Optional bounded bulk read; every requested route must be present or reject. */
+    readMany?(routes: readonly string[]): Promise<ReadonlyMap<string, Uint8Array>>;
+}
+/** A worktree reader that distinguishes absent files from invalid resources. */
+export interface OptionalReviewAssetReader extends ReviewAssetReader {
+    /** Missing paths still require a confined, existing public ancestor. */
+    readIfExists(route: string): Promise<Uint8Array | undefined>;
+    /** Expose the validated logical and physical resource identities. */
+    readLocated(route: string): Promise<LocatedReviewAsset>;
+}
+/** Validated public location, including a confined location for a missing file. */
+export interface LocatedReviewAsset {
+    content?: Uint8Array;
+    location: FileLocation;
+}
+/** Confined filesystem implementation for current-worktree Review assets. */
+export declare class FileSystemReviewAssetReader implements OptionalReviewAssetReader {
+    private readonly config;
+    constructor(config: ResolvedConfig);
+    read(route: string): Promise<Uint8Array>;
+    readIfExists(route: string): Promise<Uint8Array | undefined>;
+    /** Retain the validated physical location so watchers can observe local aliases. */
+    readLocated(route: string): Promise<LocatedReviewAsset>;
+}
+/** Confined Git implementation for base-commit Review assets. */
+export declare class GitReviewAssetReader implements ReviewAssetReader {
+    private readonly config;
+    private readonly git;
+    private readonly commit;
+    private readonly mockupsPrefix;
+    constructor(config: ResolvedConfig, git: GitClient, commit: string, mockupsPrefix: string);
+    read(route: string): Promise<Uint8Array>;
+    /** Read and validate many base-snapshot assets in one bounded Git batch. */
+    readMany(routes: readonly string[]): Promise<ReadonlyMap<string, Uint8Array>>;
+}
+/** Copy a pane and every transitively referenced local CSS/static dependency. */
+export declare function copySnapshotDependencies(files: Map<string, ReviewArtifactContent>, side: "after" | "before", seedRoutes: ReadonlySet<string>, read: (route: string) => Promise<ReviewArtifactContent>, readMany?: (routes: readonly string[]) => Promise<ReadonlyMap<string, ReviewArtifactContent>>): Promise<void>;
+//# sourceMappingURL=assets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/review/assets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAMhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,UAAU,CAAC;AAEnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,mFAAmF;IACnF,QAAQ,CAAC,CACP,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;CAC7C;AAED,gFAAgF;AAChF,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,wEAAwE;IACxE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAC7D,qEAAqE;IACrE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACzD;AAED,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,6EAA6E;AAC7E,qBAAa,2BAA4B,YAAW,yBAAyB;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE7C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAMxC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIlE,oFAAoF;IAC9E,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA0B9D;AAED,iEAAiE;AACjE,qBAAa,oBAAqB,YAAW,iBAAiB;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAHb,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM;IAGlC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAO9C,4EAA4E;IACtE,QAAQ,CACZ,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAqC5C;AAED,iFAAiF;AACjF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACzC,IAAI,EAAE,OAAO,GAAG,QAAQ,EACxB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/B,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,EACvD,QAAQ,CAAC,EAAE,CACT,MAAM,EAAE,SAAS,MAAM,EAAE,KACtB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,GACvD,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/review/assets.js

@@ -0,0 +1,171 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isPrivateStaticPath, publicPathLocation, } from "../config/public_files.js";
+import { isInside, isSafeRepositoryPath } from "../config/paths.js";
+import { MoklyError, errorMessage } from "../errors.js";
+import { referencedRoutes } from "./asset_references.js";
+import { addArtifactFile, snapshotPath } from "./paths.js";
+/** Confined filesystem implementation for current-worktree Review assets. */
+export class FileSystemReviewAssetReader {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async read(route) {
+        const content = await this.readIfExists(route);
+        if (content === undefined)
+            throw assetError(route, "file is missing");
+        return content;
+    }
+    async readIfExists(route) {
+        return (await this.readLocated(route)).content;
+    }
+    /** Retain the validated physical location so watchers can observe local aliases. */
+    async readLocated(route) {
+        if (!isSafeRepositoryPath(route))
+            throw assetError(route, "unsafe path");
+        const candidate = path.resolve(this.config.mockupsDir, route);
+        try {
+            const location = publicPathLocation(candidate, this.config);
+            if (!location) {
+                throw assetError(route, "not a public static file");
+            }
+            let stat;
+            try {
+                stat = await fs.promises.stat(location.physicalPath);
+            }
+            catch (error) {
+                if (error.code === "ENOENT")
+                    return { location };
+                throw error;
+            }
+            if (!stat.isFile())
+                throw assetError(route, "not a public static file");
+            return {
+                content: await fs.promises.readFile(location.physicalPath),
+                location,
+            };
+        }
+        catch (error) {
+            if (error instanceof MoklyError)
+                throw error;
+            throw assetError(route, errorMessage(error), error);
+        }
+    }
+}
+/** Confined Git implementation for base-commit Review assets. */
+export class GitReviewAssetReader {
+    config;
+    git;
+    commit;
+    mockupsPrefix;
+    constructor(config, git, commit, mockupsPrefix) {
+        this.config = config;
+        this.git = git;
+        this.commit = commit;
+        this.mockupsPrefix = mockupsPrefix;
+    }
+    async read(route) {
+        const files = await this.readMany([route]);
+        const content = files.get(route);
+        if (!content)
+            throw assetError(route, "Git batch omitted the file");
+        return content;
+    }
+    /** Read and validate many base-snapshot assets in one bounded Git batch. */
+    async readMany(routes) {
+        const requested = [...new Set(routes)].sort().map((route) => {
+            assertPublicStaticRoute(route, this.config);
+            return {
+                repoPath: this.mockupsPrefix === "" ? route : `${this.mockupsPrefix}/${route}`,
+                route,
+            };
+        });
+        try {
+            const repoPaths = requested.map(({ repoPath }) => repoPath);
+            const gitFiles = this.git.readFiles
+                ? await this.git.readFiles(this.commit, repoPaths)
+                : await readGitFilesIndividually(this.git, this.commit, repoPaths);
+            const files = new Map();
+            for (const { repoPath, route } of requested) {
+                const file = gitFiles.get(repoPath);
+                if (!file || file.kind !== "regular") {
+                    throw assetError(route, `not a regular Git file (${file?.kind ?? "missing"})`);
+                }
+                files.set(route, file.bytes);
+            }
+            return files;
+        }
+        catch (error) {
+            if (error instanceof MoklyError && error.code === "review-invalid") {
+                throw error;
+            }
+            throw assetError(requested[0]?.route ?? "base snapshot", errorMessage(error), error);
+        }
+    }
+}
+/** Copy a pane and every transitively referenced local CSS/static dependency. */
+export async function copySnapshotDependencies(files, side, seedRoutes, read, readMany) {
+    let queued = [...seedRoutes].sort();
+    const seen = new Set();
+    while (queued.length > 0) {
+        const batch = queued.filter((route) => !seen.has(route));
+        for (const route of batch)
+            seen.add(route);
+        const missing = batch.filter((route) => files.get(snapshotPath(side, route)) === undefined);
+        if (missing.length > 0) {
+            const loaded = readMany
+                ? await readMany(missing)
+                : await readIndividually(missing, read);
+            for (const route of missing) {
+                const content = loaded.get(route);
+                if (content === undefined) {
+                    throw assetError(route, "batch reader omitted the file");
+                }
+                addArtifactFile(files, snapshotPath(side, route), content);
+            }
+        }
+        const discovered = new Set();
+        for (const route of batch) {
+            const content = files.get(snapshotPath(side, route));
+            if (content === undefined) {
+                throw assetError(route, "snapshot dependency is unavailable");
+            }
+            for (const dependency of referencedRoutes(route, content)) {
+                if (!seen.has(dependency))
+                    discovered.add(dependency);
+            }
+        }
+        queued = [...discovered].sort();
+    }
+}
+async function readIndividually(routes, read) {
+    const files = new Map();
+    for (const route of routes)
+        files.set(route, await read(route));
+    return files;
+}
+async function readGitFilesIndividually(git, commit, repoPaths) {
+    const files = new Map();
+    for (const repoPath of repoPaths) {
+        const kind = await git.fileKind(commit, repoPath);
+        files.set(repoPath, kind === "regular"
+            ? { bytes: await git.readFileBytes(commit, repoPath), kind }
+            : { kind });
+    }
+    return files;
+}
+function assertPublicStaticRoute(route, config) {
+    if (!isSafeRepositoryPath(route))
+        throw assetError(route, "unsafe path");
+    const candidate = path.resolve(config.mockupsDir, route);
+    if (!isInside(config.mockupsDir, candidate) ||
+        isPrivateStaticPath(candidate, config)) {
+        throw assetError(route, "not a public static file");
+    }
+    return candidate;
+}
+function assetError(route, detail, cause) {
+    return new MoklyError("review-invalid", `could not retain Review asset ${route}: ${detail}`, cause === undefined ? undefined : { cause });
+}
+//# sourceMappingURL=assets.js.map

package/dist/review/assets.js.map

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

package/dist/review/base_manifest.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedConfig } from "../config/types.js";
+import type { HistoricalManifest } from "../registry/types.js";
+import type { GitClient } from "./git.js";
+/** Read the canonical base manifest, falling back only when it is absent. */
+export declare function readBaseManifest(git: GitClient, commit: string, config: ResolvedConfig): Promise<HistoricalManifest>;
+/** Apply the baseline's own source policy without executing historical consumer code. */
+export declare function baselineResourceConfig(config: ResolvedConfig, manifest: HistoricalManifest): ResolvedConfig;
+//# sourceMappingURL=base_manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base_manifest.d.ts","sourceRoot":"","sources":["../../src/review/base_manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,6EAA6E;AAC7E,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAY7B;AAED,yFAAyF;AACzF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,kBAAkB,GAC3B,cAAc,CAWhB"}

package/dist/review/base_manifest.js

@@ -0,0 +1,26 @@
+import path from "node:path";
+import { toPosixPath } from "../config/paths.js";
+import { FORMER_MANIFEST_NAME, MANIFEST_NAME, parseHistoricalManifest, selectManifestInput, } from "../registry/manifest.js";
+/** Read the canonical base manifest, falling back only when it is absent. */
+export async function readBaseManifest(git, commit, config) {
+    const prefix = toPosixPath(path.relative(config.repoRoot, config.mockupsDir));
+    const canonicalPath = joinGit(prefix, MANIFEST_NAME);
+    const selection = selectManifestInput(await git.fileExists(commit, canonicalPath), await git.fileExists(commit, joinGit(prefix, FORMER_MANIFEST_NAME)), config.compatibility.readManifestV2);
+    return parseHistoricalManifest(JSON.parse(await git.readFile(commit, joinGit(prefix, selection.filename))), selection.allowV2);
+}
+/** Apply the baseline's own source policy without executing historical consumer code. */
+export function baselineResourceConfig(config, manifest) {
+    return {
+        ...config,
+        sourceFiles: "sourceFiles" in manifest
+            ? manifest.sourceFiles
+            : [
+                ...manifest.entries.map((entry) => entry.sourcePath),
+                ...manifest.legacyPages.map((page) => page.sourcePath),
+            ],
+    };
+}
+function joinGit(prefix, route) {
+    return prefix === "" ? route : `${prefix}/${route}`;
+}
+//# sourceMappingURL=base_manifest.js.map

package/dist/review/base_manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base_manifest.js","sourceRoot":"","sources":["../../src/review/base_manifest.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAIjC,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAc,EACd,MAAc,EACd,MAAsB;IAEtB,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9E,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,mBAAmB,CACnC,MAAM,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,EAC3C,MAAM,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,EACnE,MAAM,CAAC,aAAa,CAAC,cAAc,CACpC,CAAC;IACF,OAAO,uBAAuB,CAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAC3E,SAAS,CAAC,OAAO,CAClB,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,sBAAsB,CACpC,MAAsB,EACtB,QAA4B;IAE5B,OAAO;QACL,GAAG,MAAM;QACT,WAAW,EACT,aAAa,IAAI,QAAQ;YACvB,CAAC,CAAC,QAAQ,CAAC,WAAW;YACtB,CAAC,CAAC;gBACE,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;gBACpD,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC;aACvD;KACR,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,MAAc,EAAE,KAAa;IAC5C,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;AACtD,CAAC"}

package/dist/review/changed_paths.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedConfig } from "../config/types.js";
+import type { GitClient } from "./git.js";
+/** Collect deterministic changes while excluding active and retained output. */
+export declare function reviewChangedPaths(git: GitClient, commit: string, config: ResolvedConfig, outDir: string, additionalOutputDirectories?: readonly string[]): Promise<readonly string[]>;
+//# sourceMappingURL=changed_paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"changed_paths.d.ts","sourceRoot":"","sources":["../../src/review/changed_paths.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,gFAAgF;AAChF,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,2BAA2B,GAAE,SAAS,MAAM,EAAO,GAClD,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAe5B"}

package/dist/review/changed_paths.js

@@ -0,0 +1,32 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isInside, isSafeRepositoryPath, projectRealPath, toPosixPath, } from "../config/paths.js";
+import { MoklyError } from "../errors.js";
+/** Collect deterministic changes while excluding active and retained output. */
+export async function reviewChangedPaths(git, commit, config, outDir, additionalOutputDirectories = []) {
+    const excludedPaths = [
+        ...new Set([outDir, ...additionalOutputDirectories].flatMap((directory) => outputPaths(config.repoRoot, directory))),
+    ].sort();
+    const changed = await git.changedPaths(commit, excludedPaths);
+    return [...new Set(changed)]
+        .filter((candidate) => !excludedPaths.some((excluded) => pathBelongsTo(candidate, excluded)))
+        .sort();
+}
+function outputPaths(repoRoot, outDir) {
+    const realRepoRoot = fs.realpathSync(repoRoot);
+    const lexicalRoot = isInside(repoRoot, outDir) ? repoRoot : realRepoRoot;
+    const paths = [
+        toPosixPath(path.relative(lexicalRoot, outDir)),
+        toPosixPath(path.relative(realRepoRoot, projectRealPath(outDir))),
+    ];
+    for (const candidate of paths) {
+        if (!isSafeRepositoryPath(candidate)) {
+            throw new MoklyError("review-invalid", `Review output is not repository-relative: ${candidate}`);
+        }
+    }
+    return [...new Set(paths)].sort();
+}
+function pathBelongsTo(candidate, root) {
+    return candidate === root || candidate.startsWith(`${root}/`);
+}
+//# sourceMappingURL=changed_paths.js.map

package/dist/review/changed_paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changed_paths.js","sourceRoot":"","sources":["../../src/review/changed_paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAc,EACd,MAAc,EACd,MAAsB,EACtB,MAAc,EACd,8BAAiD,EAAE;IAEnD,MAAM,aAAa,GAAG;QACpB,GAAG,IAAI,GAAG,CACR,CAAC,MAAM,EAAE,GAAG,2BAA2B,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAC7D,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CACxC,CACF;KACF,CAAC,IAAI,EAAE,CAAC;IACT,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;SACzB,MAAM,CACL,CAAC,SAAS,EAAE,EAAE,CACZ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CACxE;SACA,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB,EAAE,MAAc;IACnD,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;IACzE,MAAM,KAAK,GAAG;QACZ,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC/C,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;KAClE,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,UAAU,CAClB,gBAAgB,EAChB,6CAA6C,SAAS,EAAE,CACzD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,aAAa,CAAC,SAAiB,EAAE,IAAY;IACpD,OAAO,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;AAChE,CAAC"}

package/dist/review/compare.d.ts

@@ -0,0 +1,8 @@
+import type { Compilation } from "../build/compile.js";
+import type { ResolvedConfig } from "../config/types.js";
+import { type ReviewAssetReader } from "./assets.js";
+import type { GitClient } from "./git.js";
+import type { ReviewArtifact } from "./types.js";
+/** Compare checked head output to its Git branch point and retain pane artifacts. */
+export declare function compareReview(compilation: Compilation, config: ResolvedConfig, git: GitClient, baseRef: string, outDir?: string, assetReader?: ReviewAssetReader, changedPathExclusions?: readonly string[]): Promise<ReviewArtifact>;
+//# sourceMappingURL=compare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/review/compare.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,YAAY,CAAC;AAEpB,qFAAqF;AACrF,wBAAsB,aAAa,CACjC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,EACf,MAAM,SAAuB,EAC7B,WAAW,GAAE,iBAA2D,EACxE,qBAAqB,GAAE,SAAS,MAAM,EAAO,GAC5C,OAAO,CAAC,cAAc,CAAC,CAwFzB"}

package/dist/review/compare.js

@@ -0,0 +1,58 @@
+import { compareScreen } from "./screen_compare.js";
+import { hasRegisteredComponents } from "../registry/manifest_capabilities.js";
+import path from "node:path";
+import { minimatch } from "minimatch";
+import { toPosixPath } from "../config/paths.js";
+import { copySnapshotDependencies, FileSystemReviewAssetReader, GitReviewAssetReader, } from "./assets.js";
+import { baselineResourceConfig, readBaseManifest } from "./base_manifest.js";
+import { compareComponentCatalogue } from "./component_compare.js";
+import { reviewChangedPaths } from "./changed_paths.js";
+import { aggregateIgnored, fragmentRoutes } from "./screen_views.js";
+/** Compare checked head output to its Git branch point and retain pane artifacts. */
+export async function compareReview(compilation, config, git, baseRef, outDir = config.review.outDir, assetReader = new FileSystemReviewAssetReader(config), changedPathExclusions = []) {
+    const baseCommit = await git.mergeBase(baseRef, "HEAD");
+    const baseManifest = await readBaseManifest(git, baseCommit, config);
+    const changedPaths = await reviewChangedPaths(git, baseCommit, config, outDir, changedPathExclusions);
+    const mockupsPrefix = toPosixPath(path.relative(config.repoRoot, config.mockupsDir));
+    const baseAssetReader = new GitReviewAssetReader(baselineResourceConfig(config, baseManifest), git, baseCommit, mockupsPrefix);
+    if (hasRegisteredComponents(baseManifest) ||
+        hasRegisteredComponents(compilation.manifest))
+        return compareComponentCatalogue(compilation, baseManifest, config, baseAssetReader, assetReader, changedPaths, baseCommit, baseRef);
+    const files = new Map();
+    const baseSeeds = new Set();
+    const headSeeds = new Set();
+    const baseByRoute = screenMap(baseManifest);
+    const headByRoute = screenMap(compilation.manifest);
+    const baseDocuments = await baseAssetReader.readMany([...baseByRoute.values()].flatMap((screen) => fragmentRoutes(screen)));
+    const routes = [
+        ...new Set([...baseByRoute.keys(), ...headByRoute.keys()]),
+    ].sort();
+    const sharedImpact = changedPaths.filter((changed) => config.review.sharedImpact.some((glob) => minimatch(changed, glob, { dot: true })));
+    const screens = [];
+    for (const route of routes) {
+        const base = baseByRoute.get(route);
+        const head = headByRoute.get(route);
+        screens.push(await compareScreen(base, head, baseDocuments, compilation, changedPaths, sharedImpact, files, baseSeeds, headSeeds));
+    }
+    await copySnapshotDependencies(files, "before", baseSeeds, (route) => baseAssetReader.read(route), (routes) => baseAssetReader.readMany(routes));
+    await copySnapshotDependencies(files, "after", headSeeds, async (route) => {
+        const generated = compilation.outputs.get(route);
+        return generated ?? assetReader.read(route);
+    });
+    const result = {
+        baseCommit,
+        baseRef,
+        changedPaths,
+        ignoredImpact: aggregateIgnored(screens),
+        schemaVersion: 2,
+        screens,
+        sharedImpact,
+    };
+    return { files, result };
+}
+function screenMap(manifest) {
+    return new Map(manifest.entries
+        .filter((entry) => entry.kind === "screen")
+        .map((entry) => [entry.route, entry]));
+}
+//# sourceMappingURL=compare.js.map

package/dist/review/compare.js.map

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

package/dist/review/component_affected.d.ts

@@ -0,0 +1,6 @@
+import type { Manifest } from "../registry/types.js";
+import type { AffectedConsumer, AffectedUsageEvidence } from "./component_types.js";
+/** Derive consumer chains from input ownership, including slots and removed occurrences. */
+export declare function affectedConsumers(before: Manifest, after: Manifest, changed: ReadonlySet<string>): AffectedConsumer[];
+export declare function compareEvidence(a: AffectedUsageEvidence, b: AffectedUsageEvidence): number;
+//# sourceMappingURL=component_affected.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component_affected.d.ts","sourceRoot":"","sources":["../../src/review/component_affected.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EAEtB,MAAM,sBAAsB,CAAC;AAE9B,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B,gBAAgB,EAAE,CAoFpB;AACD,wBAAgB,eAAe,CAC7B,CAAC,EAAE,qBAAqB,EACxB,CAAC,EAAE,qBAAqB,GACvB,MAAM,CAaR"}

package/dist/review/component_affected.js

@@ -0,0 +1,96 @@
+import { canonicalJson } from "../components/data.js";
+import { generatedViews } from "../components/views.js";
+import { address, lexical } from "./component_metadata.js";
+/** Derive consumer chains from input ownership, including slots and removed occurrences. */
+export function affectedConsumers(before, after, changed) {
+    const groups = new Map();
+    for (const side of ["before", "after"]) {
+        const manifest = side === "before" ? before : after;
+        for (const entry of manifest.entries) {
+            if (entry.kind !== "screen" && entry.kind !== "component")
+                continue;
+            for (const view of generatedViews(entry)) {
+                if (!view.usage)
+                    continue;
+                const context = entry.kind === "screen"
+                    ? {
+                        kind: "screen",
+                        entry: address(entry),
+                        viewport: view.viewport,
+                        colorScheme: view.colorScheme,
+                    }
+                    : {
+                        kind: "component",
+                        entry: address(entry),
+                        variantId: view.variantId,
+                        viewport: view.viewport,
+                        colorScheme: view.colorScheme,
+                    };
+                const instances = new Map(view.usage.instances.map((instance) => [instance.key, instance]));
+                for (const instance of view.usage.instances) {
+                    if (!changed.has(instance.componentId))
+                        continue;
+                    const via = [];
+                    let next = instance;
+                    while (next) {
+                        via.unshift({
+                            componentId: next.componentId,
+                            instanceKey: next.key,
+                        });
+                        next =
+                            next.owner.kind === "instance"
+                                ? instances.get(next.owner.instanceKey)
+                                : undefined;
+                    }
+                    const consumers = [
+                        entry.kind === "screen"
+                            ? { kind: "screen", route: entry.route }
+                            : { kind: "component", id: entry.id },
+                        ...via.slice(0, -1).map((ancestor) => ({
+                            kind: "component",
+                            id: ancestor.componentId,
+                        })),
+                    ];
+                    const evidence = { side, context, via };
+                    for (const consumer of consumers) {
+                        if (consumer.kind === "component" &&
+                            consumer.id === instance.componentId)
+                            continue;
+                        const key = `${instance.componentId}:${consumer.kind}:${consumer.kind === "screen" ? consumer.route : consumer.id}`;
+                        let group = groups.get(key);
+                        if (!group) {
+                            group = {
+                                record: {
+                                    changedComponentId: instance.componentId,
+                                    consumer,
+                                    evidence: [],
+                                },
+                                evidence: new Map(),
+                            };
+                            groups.set(key, group);
+                        }
+                        group.evidence.set(canonicalJson(evidence), evidence);
+                    }
+                }
+            }
+        }
+    }
+    return [...groups]
+        .sort(([a], [b]) => lexical(a, b))
+        .map(([, group]) => ({
+        ...group.record,
+        evidence: [...group.evidence.values()].sort(compareEvidence),
+    }));
+}
+export function compareEvidence(a, b) {
+    const variant = (item) => item.context.kind === "component" ? item.context.variantId : "";
+    return ((a.side === "before" ? 0 : 1) - (b.side === "before" ? 0 : 1) ||
+        lexical(a.context.entry.route, b.context.entry.route) ||
+        lexical(variant(a), variant(b)) ||
+        (a.context.viewport === "mobile" ? 0 : 1) -
+            (b.context.viewport === "mobile" ? 0 : 1) ||
+        (a.context.colorScheme === "light" ? 0 : 1) -
+            (b.context.colorScheme === "light" ? 0 : 1) ||
+        lexical(canonicalJson(a.via), canonicalJson(b.via)));
+}
+//# sourceMappingURL=component_affected.js.map

package/dist/review/component_affected.js.map

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

package/dist/review/component_classification.d.ts

@@ -0,0 +1,17 @@
+import type { ResolvedConfig } from "../config/types.js";
+import type { Manifest } from "../registry/types.js";
+import type { ReviewAssetReader } from "./assets.js";
+import type { ReviewResultV3 } from "./component_types.js";
+export interface ComponentClassificationInput {
+    before: Manifest;
+    after: Manifest;
+    beforeReader: ReviewAssetReader;
+    afterReader: ReviewAssetReader;
+    config: ResolvedConfig;
+    changedPaths: readonly string[];
+    baseCommit: string;
+    baseRef: string;
+}
+/** The sole component-aware membership policy, shared by Browse, Review, and publishing. */
+export declare function classifyComponents(input: ComponentClassificationInput): Promise<ReviewResultV3>;
+//# sourceMappingURL=component_classification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component_classification.d.ts","sourceRoot":"","sources":["../../src/review/component_classification.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAYrD,OAAO,KAAK,EAKV,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAO9B,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4FAA4F;AAC5F,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,cAAc,CAAC,CA4PzB"}