@mokly/mokly 0.8.0

package/dist/review/screen_compare.js

@@ -0,0 +1,111 @@
+/** Shared screen comparison policy for complete artifacts and selected live panes. */
+import crypto from "node:crypto";
+import { MoklyError } from "../errors.js";
+import { dependencyContainsChangedPath } from "../registry/dependency_paths.js";
+import { VIEWPORTS } from "../registry/views.js";
+import { normalizeHistoricalDocument, normalizeReviewPair, normalizeSingleDocument, } from "./ignore.js";
+import { addArtifactFile, snapshotPath } from "./paths.js";
+import { aggregateState, fragmentForView, unionColorSchemes, } from "./screen_views.js";
+/** Compare every viewport/scheme of one route, preserving its original documents. */
+export async function compareScreen(base, head, baseDocuments, compilation, changedPaths, sharedImpact, files, baseSeeds, headSeeds) {
+    const entry = head ?? base;
+    if (!entry)
+        throw new MoklyError("review-invalid", "comparison route has no screen");
+    const views = [];
+    for (const viewport of VIEWPORTS) {
+        for (const colorScheme of unionColorSchemes(base, head)) {
+            const baseFragment = base
+                ? fragmentForView(base, viewport, colorScheme)
+                : undefined;
+            const headFragment = head
+                ? fragmentForView(head, viewport, colorScheme)
+                : undefined;
+            const baseDocument = baseFragment
+                ? baseDocuments.get(baseFragment)
+                : undefined;
+            if (baseFragment && !baseDocument) {
+                throw new MoklyError("review-invalid", `base fragment is missing: ${baseFragment}`);
+            }
+            const before = baseDocument
+                ? Buffer.from(baseDocument).toString("utf8")
+                : undefined;
+            const after = headFragment
+                ? compilation.outputs.get(headFragment)
+                : undefined;
+            if (headFragment && after === undefined) {
+                throw new MoklyError("review-invalid", `head fragment is missing: ${headFragment}`);
+            }
+            const beforePath = baseFragment
+                ? snapshotPath("before", baseFragment)
+                : undefined;
+            const afterPath = headFragment
+                ? snapshotPath("after", headFragment)
+                : undefined;
+            if (before !== undefined && beforePath && baseFragment) {
+                addArtifactFile(files, beforePath, before);
+                baseSeeds.add(baseFragment);
+            }
+            if (after !== undefined && afterPath && headFragment) {
+                addArtifactFile(files, afterPath, after);
+                headSeeds.add(headFragment);
+            }
+            views.push(compareView(before, after, entry.route, viewport, colorScheme, beforePath, afterPath));
+        }
+    }
+    const dependencies = [
+        ...new Set([...(base?.dependencies ?? []), ...(head?.dependencies ?? [])]),
+    ].sort();
+    const dependencyImpact = changedPaths.filter((changedPath) => dependencies.some((dependency) => dependencyContainsChangedPath(dependency, changedPath)));
+    return {
+        dependencies,
+        id: entry.id,
+        route: entry.route,
+        sharedImpact: [...new Set([...sharedImpact, ...dependencyImpact])].sort(),
+        state: aggregateState(views.map((view) => view.state)),
+        title: entry.title,
+        views,
+    };
+}
+function compareView(before, after, route, viewport, colorScheme, beforePath, afterPath) {
+    const context = `${route} (${viewport}, ${colorScheme})`;
+    const historicalBefore = before === undefined ? undefined : normalizeHistoricalDocument(before);
+    const normalizedBefore = historicalBefore === undefined
+        ? undefined
+        : normalizeSingleDocument(historicalBefore, context);
+    const normalizedAfter = after === undefined ? undefined : normalizeSingleDocument(after, context);
+    if (before === undefined)
+        return {
+            ...(afterPath ? { afterPath } : {}),
+            colorScheme,
+            ignoredIds: [],
+            state: "added",
+            viewport,
+        };
+    if (after === undefined)
+        return {
+            ...(beforePath ? { beforePath } : {}),
+            colorScheme,
+            ignoredIds: [],
+            state: "removed",
+            viewport,
+        };
+    const normalized = normalizeReviewPair(normalizeHistoricalDocument(before), after, context);
+    const normalizedEqual = digest(normalized.base) === digest(normalized.head);
+    const rawEqual = digest(normalizedBefore ?? "") === digest(normalizedAfter ?? "");
+    return {
+        ...(afterPath ? { afterPath } : {}),
+        ...(beforePath ? { beforePath } : {}),
+        colorScheme,
+        ignoredIds: normalized.ignoredIds,
+        state: rawEqual
+            ? "unchanged"
+            : normalizedEqual
+                ? "ignored-only"
+                : "changed",
+        viewport,
+    };
+}
+function digest(content) {
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+//# sourceMappingURL=screen_compare.js.map

package/dist/review/screen_compare.js.map

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

package/dist/review/screen_views.d.ts

@@ -0,0 +1,16 @@
+/** View enumeration and aggregation helpers for Review screen comparisons. */
+import type { ColorScheme, Viewport } from "../authoring/types.js";
+import type { ManifestScreen } from "../registry/types.js";
+import type { ReviewResult, ReviewState, ScreenReview } from "./types.js";
+/** List every generated fragment route declared by a manifest screen. */
+export declare function fragmentRoutes(screen: ManifestScreen): string[];
+/** Resolve the manifest fragment for one viewport and color scheme. */
+export declare function fragmentForView(screen: ManifestScreen, viewport: Viewport, colorScheme: ColorScheme): string | undefined;
+/** Return the canonical color-scheme union for a base/head screen pair. */
+export declare function unionColorSchemes(base: ManifestScreen | undefined, head: ManifestScreen | undefined): readonly ColorScheme[];
+/** Return the color schemes represented by one manifest screen. */
+export declare function screenColorSchemes(screen: ManifestScreen | undefined): readonly ColorScheme[];
+/** Aggregate ignored regions in canonical viewport, scheme, then id order. */
+export declare function aggregateIgnored(screens: readonly ScreenReview[]): ReviewResult["ignoredImpact"];
+export declare function aggregateState(states: readonly ReviewState[]): ReviewState;
+//# sourceMappingURL=screen_views.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screen_views.d.ts","sourceRoot":"","sources":["../../src/review/screen_views.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAY1E,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAM/D;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,GACvB,MAAM,GAAG,SAAS,CAIpB;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,IAAI,EAAE,cAAc,GAAG,SAAS,GAC/B,SAAS,WAAW,EAAE,CAMxB;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC,SAAS,WAAW,EAAE,CAExB;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,YAAY,CAAC,eAAe,CAAC,CA2B/B;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,CAW1E"}

package/dist/review/screen_views.js

@@ -0,0 +1,73 @@
+/** View enumeration and aggregation helpers for Review screen comparisons. */
+import { VIEWPORTS } from "../registry/views.js";
+const COLOR_SCHEMES = ["light", "dark"];
+const COLOR_SCHEME_RANK = {
+    dark: 1,
+    light: 0,
+};
+const VIEWPORT_RANK = {
+    desktop: 1,
+    mobile: 0,
+};
+/** List every generated fragment route declared by a manifest screen. */
+export function fragmentRoutes(screen) {
+    return VIEWPORTS.flatMap((viewport) => COLOR_SCHEMES.flatMap((colorScheme) => fragmentForView(screen, viewport, colorScheme) ?? []));
+}
+/** Resolve the manifest fragment for one viewport and color scheme. */
+export function fragmentForView(screen, viewport, colorScheme) {
+    return colorScheme === "light"
+        ? screen.fragments[viewport]
+        : screen.darkFragments?.[viewport];
+}
+/** Return the canonical color-scheme union for a base/head screen pair. */
+export function unionColorSchemes(base, head) {
+    const schemes = new Set([
+        ...screenColorSchemes(base),
+        ...screenColorSchemes(head),
+    ]);
+    return COLOR_SCHEMES.filter((colorScheme) => schemes.has(colorScheme));
+}
+/** Return the color schemes represented by one manifest screen. */
+export function screenColorSchemes(screen) {
+    return screen?.darkFragments ? ["light", "dark"] : ["light"];
+}
+/** Aggregate ignored regions in canonical viewport, scheme, then id order. */
+export function aggregateIgnored(screens) {
+    const counts = new Map();
+    for (const screen of screens) {
+        for (const view of screen.views) {
+            for (const id of view.ignoredIds) {
+                const key = `${view.viewport}:${view.colorScheme}:${id}`;
+                counts.set(key, (counts.get(key) ?? 0) + 1);
+            }
+        }
+    }
+    return [...counts]
+        .map(([key, count]) => {
+        const [viewport, colorScheme, ...id] = key.split(":");
+        return {
+            colorScheme: colorScheme,
+            count,
+            id: id.join(":"),
+            viewport: viewport,
+        };
+    })
+        .sort((left, right) => VIEWPORT_RANK[left.viewport] - VIEWPORT_RANK[right.viewport] ||
+        COLOR_SCHEME_RANK[left.colorScheme] -
+            COLOR_SCHEME_RANK[right.colorScheme] ||
+        left.id.localeCompare(right.id));
+}
+export function aggregateState(states) {
+    for (const state of [
+        "changed",
+        "added",
+        "removed",
+        "ignored-only",
+        "unchanged",
+    ]) {
+        if (states.includes(state))
+            return state;
+    }
+    return "unchanged";
+}
+//# sourceMappingURL=screen_views.js.map

package/dist/review/screen_views.js.map

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

package/dist/review/selected.d.ts

@@ -0,0 +1,12 @@
+import type { ResolvedConfig } from "../config/types.js";
+import { type GitClient } from "./git.js";
+import type { ReviewSelection, SelectedReviewProvider, SelectedReviewSource } from "./selection_types.js";
+import type { ReviewArtifact } from "./types.js";
+export declare class RepositorySelectedReview implements SelectedReviewProvider {
+    private readonly config;
+    private readonly git?;
+    constructor(config: ResolvedConfig, git?: GitClient | undefined);
+    generate(source: SelectedReviewSource, selection: ReviewSelection, signal: AbortSignal): Promise<ReviewArtifact>;
+    private screenResult;
+}
+//# sourceMappingURL=selected.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selected.d.ts","sourceRoot":"","sources":["../../src/review/selected.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAUzD,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,UAAU,CAAC;AAQlB,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,YAAY,CAAC;AAEpB,qBAAa,wBAAyB,YAAW,sBAAsB;IAEnE,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;gBADJ,MAAM,EAAE,cAAc,EACtB,GAAG,CAAC,EAAE,SAAS,YAAA;IAG5B,QAAQ,CACZ,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,cAAc,CAAC;YAuDZ,YAAY;CAsD3B"}

package/dist/review/selected.js

@@ -0,0 +1,78 @@
+/** Capture one selection from the accepted catalogue without another exhaustive build. */
+import path from "node:path";
+import { minimatch } from "minimatch";
+import { toPosixPath } from "../config/paths.js";
+import { MoklyError } from "../errors.js";
+import { copySnapshotDependencies, FileSystemReviewAssetReader, GitReviewAssetReader, } from "./assets.js";
+import { baselineResourceConfig } from "./base_manifest.js";
+import { SelectedAssetReader } from "./evidence_assets.js";
+import { NodeGitCommandRunner, RepositoryGitClient, } from "./git.js";
+import { parseReviewResult } from "./result_validation.js";
+import { compareScreen } from "./screen_compare.js";
+import { aggregateIgnored, fragmentRoutes } from "./screen_views.js";
+import { missingSelection, selectedComponentResult, } from "./selection_result.js";
+export class RepositorySelectedReview {
+    config;
+    git;
+    constructor(config, git) {
+        this.config = config;
+        this.git = git;
+    }
+    async generate(source, selection, signal) {
+        const git = this.git ??
+            new RepositoryGitClient(new NodeGitCommandRunner(this.config.repoRoot, signal));
+        const before = new SelectedAssetReader(new GitReviewAssetReader(baselineResourceConfig(this.config, source.before), git, source.baseCommit, toPosixPath(path.relative(this.config.repoRoot, this.config.mockupsDir))), signal);
+        const after = new SelectedAssetReader(new FileSystemReviewAssetReader(this.config), signal, source.headDigests);
+        const result = source.result
+            ? selectedComponentResult(source.result, selection)
+            : await this.screenResult(source, selection, before, after);
+        parseReviewResult(result);
+        const views = result.schemaVersion === 3 && result.components.length
+            ? result.components.flatMap((entry) => entry.variants.flatMap((variant) => variant.views))
+            : result.screens.flatMap((screen) => screen.views);
+        const files = new Map();
+        for (const side of ["before", "after"]) {
+            const routes = snapshotRoutes(views, side);
+            if (side === "after")
+                for (const route of routes)
+                    if (!Object.hasOwn(source.headDigests, route))
+                        throw new MoklyError("review-invalid", `Selected document has not been checked: ${route}`);
+            const reader = side === "before" ? before : after;
+            await copySnapshotDependencies(files, side, routes, (route) => reader.read(route), (routes) => reader.readMany(routes));
+        }
+        signal.throwIfAborted();
+        return { result, files };
+    }
+    async screenResult(source, selection, beforeReader, afterReader) {
+        if (selection.variantId !== undefined)
+            throw missingSelection();
+        const before = source.before.entries.find((entry) => entry.kind === "screen" && entry.route === selection.route);
+        const after = source.after.entries.find((entry) => entry.kind === "screen" && entry.route === selection.route);
+        if (!before && !after)
+            throw missingSelection();
+        const sharedImpact = source.changedPaths.filter((changed) => this.config.review.sharedImpact.some((glob) => minimatch(changed, glob, { dot: true })));
+        const baseDocuments = await beforeReader.readMany(before ? fragmentRoutes(before) : []);
+        const headDocuments = await afterReader.readMany(after ? fragmentRoutes(after) : []);
+        const outputs = new Map([...headDocuments].map(([route, bytes]) => [
+            route,
+            Buffer.from(bytes).toString("utf8"),
+        ]));
+        const screen = await compareScreen(before, after, baseDocuments, { outputs }, source.changedPaths, sharedImpact, new Map(), new Set(), new Set());
+        return {
+            baseCommit: source.baseCommit,
+            baseRef: source.baseRef,
+            changedPaths: source.changedPaths,
+            ignoredImpact: aggregateIgnored([screen]),
+            schemaVersion: 2,
+            screens: [screen],
+            sharedImpact,
+        };
+    }
+}
+function snapshotRoutes(views, side) {
+    return new Set(views.flatMap((view) => {
+        const route = view[`${side}Path`];
+        return route ? [route.slice(`snapshots/${side}/`.length)] : [];
+    }));
+}
+//# sourceMappingURL=selected.js.map

package/dist/review/selected.js.map

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

package/dist/review/selection_result.d.ts

@@ -0,0 +1,7 @@
+/** Project completed ownership evidence onto the one comparison being displayed. */
+import { MoklyError } from "../errors.js";
+import type { ReviewResultV3 } from "./component_types.js";
+import type { ReviewSelection } from "./selection_types.js";
+export declare function selectedComponentResult(result: ReviewResultV3, selection: ReviewSelection): ReviewResultV3;
+export declare function missingSelection(): MoklyError;
+//# sourceMappingURL=selection_result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selection_result.d.ts","sourceRoot":"","sources":["../../src/review/selection_result.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,eAAe,GACzB,cAAc,CA4BhB;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CAK7C"}

package/dist/review/selection_result.js

@@ -0,0 +1,28 @@
+/** Project completed ownership evidence onto the one comparison being displayed. */
+import { MoklyError } from "../errors.js";
+import { aggregateIgnored } from "./screen_views.js";
+export function selectedComponentResult(result, selection) {
+    const screens = selection.variantId === undefined
+        ? result.screens.filter((screen) => screen.route === selection.route)
+        : [];
+    const component = result.components.find((entry) => entry.route === selection.route);
+    const variant = component?.variants.find((entry) => entry.id === selection.variantId);
+    if (!screens.length && (!component || !variant))
+        throw missingSelection();
+    const components = component && variant
+        ? [{ ...component, state: variant.state, variants: [variant] }]
+        : [];
+    return {
+        ...result,
+        screens,
+        components,
+        changes: result.changes.filter((entry) => entry.kind === (components.length ? "component" : "screen") &&
+            (entry.after ?? entry.before)?.route === selection.route),
+        affectedConsumers: [],
+        ignoredImpact: aggregateIgnored(screens),
+    };
+}
+export function missingSelection() {
+    return new MoklyError("review-invalid", "The selected view has no comparison");
+}
+//# sourceMappingURL=selection_result.js.map

package/dist/review/selection_result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection_result.js","sourceRoot":"","sources":["../../src/review/selection_result.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,UAAU,uBAAuB,CACrC,MAAsB,EACtB,SAA0B;IAE1B,MAAM,OAAO,GACX,SAAS,CAAC,SAAS,KAAK,SAAS;QAC/B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK,CAAC;QACrE,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CACtC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK,CAC3C,CAAC;IACF,MAAM,OAAO,GAAG,SAAS,EAAE,QAAQ,CAAC,IAAI,CACtC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,SAAS,CAC5C,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC;QAAE,MAAM,gBAAgB,EAAE,CAAC;IAC1E,MAAM,UAAU,GACd,SAAS,IAAI,OAAO;QAClB,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,CAAC,CAAC,EAAE,CAAC;IACT,OAAO;QACL,GAAG,MAAM;QACT,OAAO;QACP,UAAU;QACV,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAC5B,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC3D,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,SAAS,CAAC,KAAK,CAC3D;QACD,iBAAiB,EAAE,EAAE;QACrB,aAAa,EAAE,gBAAgB,CAAC,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,UAAU,CACnB,gBAAgB,EAChB,qCAAqC,CACtC,CAAC;AACJ,CAAC"}

package/dist/review/selection_types.d.ts

@@ -0,0 +1,25 @@
+/** Inputs for a comparison of one screen or one saved component variant. */
+import type { Manifest } from "../registry/types.js";
+import type { ReviewResultV3 } from "./component_types.js";
+import type { ReviewArtifact } from "./types.js";
+export interface ReviewSelection {
+    readonly route: string;
+    readonly variantId?: string;
+}
+/** Private evidence retained by background classification, never published as JSON. */
+export interface ReviewEvidence {
+    readonly baseCommit: string;
+    readonly baseRef: string;
+    readonly changedPaths: readonly string[];
+    readonly headDigests: Readonly<Record<string, string>>;
+}
+export interface SelectedReviewSource extends ReviewEvidence {
+    readonly before: Manifest;
+    readonly after: Manifest;
+    readonly result?: ReviewResultV3;
+}
+/** Capture validated, immutable pane bytes without compiling the consumer again. */
+export interface SelectedReviewProvider {
+    generate(source: SelectedReviewSource, selection: ReviewSelection, signal: AbortSignal): Promise<ReviewArtifact>;
+}
+//# sourceMappingURL=selection_types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selection_types.d.ts","sourceRoot":"","sources":["../../src/review/selection_types.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;CAClC;AAED,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CACN,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B"}

package/dist/review/selection_types.js

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

package/dist/review/selection_types.js.map

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

package/dist/review/types.d.ts

@@ -0,0 +1,50 @@
+import type { ReviewResultV3 } from "./component_types.js";
+import type { ColorScheme, Viewport } from "../authoring/types.js";
+/** Text or binary bytes retained in one static Review artifact. */
+export type ReviewArtifactContent = string | Uint8Array;
+/** Classification for one view or aggregate screen. */
+export type ReviewState = "added" | "changed" | "ignored-only" | "removed" | "unchanged";
+/** One view comparison and its retained artifact paths. */
+export interface ViewReview {
+    afterPath?: string;
+    beforePath?: string;
+    colorScheme: ColorScheme;
+    ignoredIds: readonly string[];
+    state: ReviewState;
+    viewport: Viewport;
+}
+/** One stable screen route comparison. */
+export interface ScreenReview {
+    dependencies: readonly string[];
+    id: string;
+    route: string;
+    sharedImpact: readonly string[];
+    state: ReviewState;
+    title: string;
+    views: readonly ViewReview[];
+}
+/** Deterministic machine-readable Review result. */
+export interface ReviewResultV2 {
+    /** Common ancestor shared by HEAD and the configured base ref. */
+    baseCommit: string;
+    /** Configured ref used to resolve the comparison branch point. */
+    baseRef: string;
+    changedPaths: readonly string[];
+    ignoredImpact: readonly {
+        colorScheme: ColorScheme;
+        count: number;
+        id: string;
+        viewport: Viewport;
+    }[];
+    screens: readonly ScreenReview[];
+    schemaVersion: 2;
+    sharedImpact: readonly string[];
+}
+/** Complete artifact file map plus summary model. */
+export interface ReviewArtifact {
+    files: ReadonlyMap<string, ReviewArtifactContent>;
+    result: ReviewResult;
+}
+/** Versioned comparison payload; legacy consumers retain schema v2. */
+export type ReviewResult = ReviewResultV2 | ReviewResultV3;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/review/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEnE,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,UAAU,CAAC;AAExD,uDAAuD;AACvD,MAAM,MAAM,WAAW,GACrB,OAAO,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,GAAG,WAAW,CAAC;AAEjE,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CAC9B;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE,SAAS;QACtB,WAAW,EAAE,WAAW,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,QAAQ,CAAC;KACpB,EAAE,CAAC;IACJ,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,aAAa,EAAE,CAAC,CAAC;IACjB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAClD,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,cAAc,CAAC"}

package/dist/review/types.js

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

package/dist/review/types.js.map

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

package/dist/review/write.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedConfig } from "../config/types.js";
+import type { ReviewArtifactContent } from "./types.js";
+/** Replace an owned Review artifact directory as one filesystem transaction. */
+export declare function writeReviewArtifact(files: ReadonlyMap<string, ReviewArtifactContent>, outDir: string, config: ResolvedConfig): Promise<void>;
+//# sourceMappingURL=write.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/review/write.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,gFAAgF;AAChF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACjD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAoDf"}

package/dist/review/write.js

@@ -0,0 +1,60 @@
+import fs from "node:fs";
+import path from "node:path";
+import { validateReviewOut } from "../config/path_validation.js";
+import { MoklyError, errorMessage } from "../errors.js";
+/** Replace an owned Review artifact directory as one filesystem transaction. */
+export async function writeReviewArtifact(files, outDir, config) {
+    validateReviewOut(outDir, config, "Review output", "review-invalid");
+    if (fs.existsSync(outDir) &&
+        !fs.existsSync(path.join(outDir, ".mokly-review-artifact"))) {
+        throw new MoklyError("review-invalid", `refusing to replace unowned Review directory: ${outDir}`);
+    }
+    await fs.promises.mkdir(path.dirname(outDir), { recursive: true });
+    const temporary = await fs.promises.mkdtemp(path.join(path.dirname(outDir), ".mokly-review-"));
+    const stage = path.join(temporary, "stage");
+    const backup = path.join(temporary, "backup");
+    let backedUp = false;
+    let installed = false;
+    try {
+        for (const [relative, content] of [...files].sort(([left], [right]) => left.localeCompare(right))) {
+            validateArtifactPath(relative);
+            const target = path.join(stage, relative);
+            await fs.promises.mkdir(path.dirname(target), { recursive: true });
+            if (typeof content === "string") {
+                await fs.promises.writeFile(target, content, "utf8");
+            }
+            else {
+                await fs.promises.writeFile(target, Buffer.from(content));
+            }
+        }
+        if (fs.existsSync(outDir)) {
+            await fs.promises.rename(outDir, backup);
+            backedUp = true;
+        }
+        await fs.promises.rename(stage, outDir);
+        installed = true;
+    }
+    catch (error) {
+        if (installed)
+            await fs.promises.rm(outDir, { force: true, recursive: true });
+        if (backedUp)
+            await fs.promises.rename(backup, outDir);
+        throw new MoklyError("review-invalid", `could not write Review artifact: ${errorMessage(error)}`, {
+            cause: error,
+        });
+    }
+    finally {
+        await fs.promises.rm(temporary, { force: true, recursive: true });
+    }
+}
+function validateArtifactPath(relative) {
+    if (relative === "" ||
+        relative.startsWith("/") ||
+        relative.includes("\\") ||
+        relative
+            .split("/")
+            .some((part) => part === "" || part === "." || part === "..")) {
+        throw new MoklyError("review-invalid", `unsafe Review artifact path: ${relative}`);
+    }
+}
+//# sourceMappingURL=write.js.map

package/dist/review/write.js.map

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

package/dist/server/browser_assets.d.ts

@@ -0,0 +1,15 @@
+/** Package-owned browser modules, font responses, and live-update streams. */
+import type { ServerResponse } from "node:http";
+/** In-memory package assets served by one Browse child. */
+export interface ServedAssets {
+    clientModules: ReadonlyMap<string, Buffer>;
+    fontAssets: ReadonlyMap<string, Buffer>;
+    navigationModules: ReadonlyMap<string, Buffer>;
+}
+/** Serve one allowlisted JavaScript module. */
+export declare function serveClientModule(response: ServerResponse, filename: string, modules: ReadonlyMap<string, Buffer>, method: string): void;
+/** Serve one allowlisted packaged font asset. */
+export declare function serveFontAsset(response: ServerResponse, filename: string, fonts: ReadonlyMap<string, Buffer>, method: string): void;
+/** Open the versioned server-sent event stream used by watched Browse. */
+export declare function openEventStream(response: ServerResponse, streams: Set<ServerResponse>, version: number, method: string): void;
+//# sourceMappingURL=browser_assets.d.ts.map

package/dist/server/browser_assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser_assets.d.ts","sourceRoot":"","sources":["../../src/server/browser_assets.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,MAAM,EAAE,MAAM,GACb,IAAI,CASN;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,MAAM,EAAE,MAAM,GACb,IAAI,CAWN;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,GAAG,CAAC,cAAc,CAAC,EAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,IAAI,CAaN"}

package/dist/server/browser_assets.js

@@ -0,0 +1,44 @@
+/** Package-owned browser modules, font responses, and live-update streams. */
+import { send } from "./respond.js";
+/** Serve one allowlisted JavaScript module. */
+export function serveClientModule(response, filename, modules, method) {
+    const content = modules.get(filename);
+    if (!content)
+        return send(response, 404, "text/plain", "Not found", method);
+    response.writeHead(200, {
+        "cache-control": "no-cache",
+        "content-type": "text/javascript; charset=utf-8",
+        "x-content-type-options": "nosniff",
+    });
+    response.end(method === "HEAD" ? undefined : content);
+}
+/** Serve one allowlisted packaged font asset. */
+export function serveFontAsset(response, filename, fonts, method) {
+    const content = fonts.get(filename);
+    if (!content)
+        return send(response, 404, "text/plain", "Not found", method);
+    response.writeHead(200, {
+        "cache-control": "no-cache",
+        "content-type": filename.endsWith(".woff2")
+            ? "font/woff2"
+            : "text/plain; charset=utf-8",
+        "x-content-type-options": "nosniff",
+    });
+    response.end(method === "HEAD" ? undefined : content);
+}
+/** Open the versioned server-sent event stream used by watched Browse. */
+export function openEventStream(response, streams, version, method) {
+    response.writeHead(200, {
+        "cache-control": "no-cache",
+        connection: "keep-alive",
+        "content-type": "text/event-stream",
+    });
+    if (method === "HEAD") {
+        response.end();
+        return;
+    }
+    response.write(`event: ready\ndata: ${version}\n\n`);
+    streams.add(response);
+    response.on("close", () => streams.delete(response));
+}
+//# sourceMappingURL=browser_assets.js.map