@mokly/mokly 0.8.0

package/dist/registry/prepare.js

@@ -0,0 +1,90 @@
+import path from "node:path";
+import { toPosixPath } from "../config/paths.js";
+import { MoklyError } from "../errors.js";
+import { ComponentValidationError } from "../components/data.js";
+import { validateComponentDefinition } from "../components/definition.js";
+import { problem, validateEntry } from "./entry_validation.js";
+import { crossReferenceViolations, duplicateViolations, } from "./relationships.js";
+/** Validate loaded values and prepare stable source-attributed entries. */
+export function prepareRegistry(values, config) {
+    const violations = [];
+    const entries = [];
+    values.forEach((value, index) => {
+        if (!isDefinition(value)) {
+            violations.push({
+                code: "invalid-definition",
+                message: `exported definition #${index + 1} is not a registry definition`,
+                sourceRelativePath: toPosixPath(path.relative(config.repoRoot, config.entriesDir)),
+            });
+            return;
+        }
+        const sourceRelativePath = value.definedIn ?? "<unattributed>";
+        const sourcePath = path.resolve(config.repoRoot, sourceRelativePath);
+        const entry = {
+            ...value,
+            sourcePath,
+            sourceRelativePath,
+        };
+        const metadataViolations = validateEntry(entry, config);
+        violations.push(...metadataViolations);
+        if (entry.kind === "component") {
+            if (metadataViolations.length)
+                return;
+            try {
+                entries.push({
+                    ...validateComponentDefinition(entry),
+                    sourcePath,
+                    sourceRelativePath,
+                });
+            }
+            catch (error) {
+                if (!(error instanceof ComponentValidationError))
+                    throw error;
+                violations.push(problem(entry, "invalid-component", error.message));
+            }
+        }
+        else
+            entries.push(entry);
+    });
+    entries.sort(compareEntries);
+    violations.push(...duplicateViolations(entries, "id"), ...duplicateViolations(entries, "route"), ...crossReferenceViolations(entries));
+    if (entries.length === 0) {
+        violations.push({
+            code: "empty-registry",
+            message: "no registry definitions were exported",
+            sourceRelativePath: toPosixPath(path.relative(config.repoRoot, config.entriesDir)),
+        });
+    }
+    if (violations.length > 0)
+        throw invalidRegistry(violations);
+    return { byId: new Map(entries.map((entry) => [entry.id, entry])), entries };
+}
+function isDefinition(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const kind = value.kind;
+    return (kind === "page" ||
+        kind === "screen" ||
+        kind === "collection" ||
+        kind === "use-case" ||
+        kind === "component");
+}
+function compareEntries(left, right) {
+    const leftRoute = left.kind === "collection" ? "" : left.route;
+    const rightRoute = right.kind === "collection" ? "" : right.route;
+    return leftRoute < rightRoute
+        ? -1
+        : leftRoute > rightRoute
+            ? 1
+            : left.id < right.id
+                ? -1
+                : left.id > right.id
+                    ? 1
+                    : 0;
+}
+function invalidRegistry(violations) {
+    const ordered = [...violations].sort((left, right) => `${left.code}:${left.sourceRelativePath}:${left.message}`.localeCompare(`${right.code}:${right.sourceRelativePath}:${right.message}`));
+    return new MoklyError("build-invalid", `catalogue is invalid:\n${ordered.map((item) => `- [${item.code}] ${item.sourceRelativePath}${item.id ? ` (${item.id})` : ""}: ${item.message}`).join("\n")}`);
+}
+//# sourceMappingURL=prepare.js.map

package/dist/registry/prepare.js.map

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

package/dist/registry/relationships.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedRegistryEntry } from "../authoring/types.js";
+import type { RegistryViolation } from "./types.js";
+/** Validate collection and reciprocal use-case references. */
+export declare function crossReferenceViolations(entries: readonly ResolvedRegistryEntry[]): RegistryViolation[];
+/** Find duplicate ids or routed values. */
+export declare function duplicateViolations(entries: readonly ResolvedRegistryEntry[], field: "id" | "route"): RegistryViolation[];
+//# sourceMappingURL=relationships.d.ts.map

package/dist/registry/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/registry/relationships.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,8DAA8D;AAC9D,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,iBAAiB,EAAE,CAerB;AAED,2CAA2C;AAC3C,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,EAAE,IAAI,GAAG,OAAO,GACpB,iBAAiB,EAAE,CAsBrB"}

package/dist/registry/relationships.js

@@ -0,0 +1,64 @@
+import { problem } from "./entry_validation.js";
+import { analyzeHierarchy } from "./hierarchy.js";
+/** Validate collection and reciprocal use-case references. */
+export function crossReferenceViolations(entries) {
+    const byId = new Map(entries.map((entry) => [entry.id, entry]));
+    const violations = analyzeHierarchy(entries).issues.map((issue) => problem(issue.entry, issue.code, issue.message));
+    for (const entry of entries) {
+        if (entry.kind === "use-case") {
+            if (!Array.isArray(entry.steps))
+                continue;
+            validateUseCase(entry, byId, violations);
+        }
+        else if (entry.kind === "screen") {
+            if (!Array.isArray(entry.useCaseIds))
+                continue;
+            validateScreen(entry, byId, violations);
+        }
+    }
+    return violations;
+}
+/** Find duplicate ids or routed values. */
+export function duplicateViolations(entries, field) {
+    const groups = new Map();
+    for (const entry of entries) {
+        const value = field === "id"
+            ? entry.id
+            : entry.kind === "collection"
+                ? undefined
+                : entry.route;
+        if (value)
+            groups.set(value, [...(groups.get(value) ?? []), entry]);
+    }
+    return [...groups.entries()].flatMap(([value, group]) => group.length > 1
+        ? group.map((entry) => problem(entry, `duplicate-${field}`, `${field} "${value}" is defined more than once`))
+        : []);
+}
+function validateUseCase(entry, byId, violations) {
+    for (const [index, step] of entry.steps.entries()) {
+        if (!record(step) || typeof step.screenId !== "string")
+            continue;
+        const target = byId.get(step.screenId);
+        if (target?.kind !== "screen") {
+            violations.push(problem(entry, "missing-step-screen", `step #${index + 1} is not a screen: ${step.screenId}`));
+        }
+        else if (!target.useCaseIds.includes(entry.id)) {
+            violations.push(problem(entry, "missing-membership", `screen ${target.id} must list use case ${entry.id}`));
+        }
+    }
+}
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validateScreen(entry, byId, violations) {
+    for (const useCaseId of entry.useCaseIds) {
+        const target = byId.get(useCaseId);
+        if (target?.kind !== "use-case") {
+            violations.push(problem(entry, "missing-use-case", `unknown use-case id: ${useCaseId}`));
+        }
+        else if (!target.steps.some((step) => step.screenId === entry.id)) {
+            violations.push(problem(entry, "missing-step", `use case ${useCaseId} must reference screen ${entry.id}`));
+        }
+    }
+}
+//# sourceMappingURL=relationships.js.map

package/dist/registry/relationships.js.map

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

package/dist/registry/types.d.ts

@@ -0,0 +1,113 @@
+import type { ManifestComponent, ComponentViewRecord } from "../components/manifest_types.js";
+import type { ResolvedRegistryEntry, Viewport } from "../authoring/types.js";
+/** One actionable catalogue validation failure. */
+export interface RegistryViolation {
+    code: string;
+    id?: string;
+    message: string;
+    sourceRelativePath: string;
+}
+/** A prepared and cross-reference-validated registry. */
+export interface PreparedRegistry {
+    entries: readonly ResolvedRegistryEntry[];
+    byId: ReadonlyMap<string, ResolvedRegistryEntry>;
+}
+/** Serializable common metadata for a manifest entry. */
+export interface ManifestEntryBase {
+    dependencies: readonly string[];
+    /** Explicit author declarations in component v4 and current v5 manifests. */
+    declaredDependencies?: readonly string[];
+    description: string;
+    id: string;
+    kind: "collection" | "screen" | "page" | "use-case";
+    navPath: readonly string[];
+    rationale?: string;
+    relatedDocs: readonly string[];
+    sourcePath: string;
+    title: string;
+}
+/** Serializable screen manifest entry. */
+export interface ManifestScreen extends ManifestEntryBase {
+    address?: string;
+    componentViews?: readonly ComponentViewRecord[];
+    darkFragments?: Record<Viewport, string>;
+    fragments: Record<Viewport, string>;
+    kind: "screen";
+    route: string;
+    /** Declared classification tags, present only when the entry has them. */
+    tags?: readonly string[];
+    useCaseIds: readonly string[];
+    viewports: readonly Viewport[];
+}
+/** Serializable whole-document page. */
+export interface ManifestPage extends ManifestEntryBase {
+    kind: "page";
+    route: string;
+    tags?: readonly string[];
+}
+/** Serializable collection manifest entry. */
+export interface ManifestCollection extends ManifestEntryBase {
+    childIds: readonly string[];
+    kind: "collection";
+}
+/** Serializable use-case manifest entry. */
+export interface ManifestUseCase extends ManifestEntryBase {
+    kind: "use-case";
+    route: string;
+    steps: readonly {
+        description?: string;
+        screenId: string;
+        title?: string;
+    }[];
+    /** Declared classification tags, present only when the entry has them. */
+    tags?: readonly string[];
+}
+/** Any supported registry entry, including current whole-document pages. */
+export type ManifestEntry = ManifestScreen | ManifestPage | ManifestCollection | ManifestUseCase | ManifestComponent;
+/** One generated legacy page. */
+export interface ManifestLegacyPage {
+    route: string;
+    sourcePath: string;
+}
+/** Canonical generated catalogue schema. */
+export interface ManifestV3 {
+    entries: readonly Exclude<ManifestEntry, ManifestComponent | ManifestPage>[];
+    generatedBy: "mokly";
+    legacyPages: readonly ManifestLegacyPage[];
+    schemaVersion: 3;
+}
+/** Historical whole-document format from the page migration branch. */
+export interface ManifestPagesV4 {
+    entries: readonly Exclude<ManifestEntry, ManifestComponent>[];
+    generatedBy: "mokly";
+    schemaVersion: 4;
+    sourceFiles: readonly string[];
+}
+/** Component-aware manifests require complete usage on every screen view. */
+export interface ManifestScreenV4 extends ManifestScreen {
+    declaredDependencies: readonly string[];
+    componentViews: readonly ComponentViewRecord[];
+}
+export interface ManifestV4 {
+    entries: readonly ManifestEntryV4[];
+    generatedBy: "mokly";
+    legacyPages: readonly ManifestLegacyPage[];
+    schemaVersion: 4;
+}
+export type ManifestEntryV4 = (ManifestScreenV4 | ManifestComponent | ManifestCollection | ManifestUseCase) & {
+    declaredDependencies: readonly string[];
+};
+/** Current catalogue combining pages, components, and complete source protection. */
+export interface ManifestV5 {
+    entries: readonly (ManifestEntry & {
+        declaredDependencies: readonly string[];
+    })[];
+    generatedBy: "mokly";
+    schemaVersion: 5;
+    sourceFiles: readonly string[];
+}
+/** All validated formats accepted at the historical Git boundary. */
+export type Manifest = ManifestV3 | ManifestV4 | ManifestPagesV4 | ManifestV5;
+/** Historical comparisons accept older formats without weakening current loading. */
+export type HistoricalManifest = Manifest;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/registry/types.js

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

package/dist/registry/types.js.map

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

package/dist/registry/views.d.ts

@@ -0,0 +1,14 @@
+/** Shared view-axis helpers for generated screen artifacts. */
+import type { ColorScheme, Viewport } from "../authoring/types.js";
+/** Recorded view axes for one generated screen artifact route. */
+export interface ArtifactView {
+    colorScheme: ColorScheme;
+    viewport: Viewport;
+}
+/** Ordered viewports shared by every generated screen. */
+export declare const VIEWPORTS: readonly Viewport[];
+/** Resolve a screen's effective schemes against the catalogue default. */
+export declare function effectiveColorSchemes(entry: {
+    colorSchemes?: readonly ColorScheme[];
+}, catalogueSchemes: readonly ColorScheme[]): readonly ColorScheme[];
+//# sourceMappingURL=views.d.ts.map

package/dist/registry/views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../src/registry/views.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEnE,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,0DAA0D;AAC1D,eAAO,MAAM,SAAS,EAAE,SAAS,QAAQ,EAA0B,CAAC;AAEpE,0EAA0E;AAC1E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE;IAAE,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,EAChD,gBAAgB,EAAE,SAAS,WAAW,EAAE,GACvC,SAAS,WAAW,EAAE,CAExB"}

package/dist/registry/views.js

@@ -0,0 +1,8 @@
+/** Shared view-axis helpers for generated screen artifacts. */
+/** Ordered viewports shared by every generated screen. */
+export const VIEWPORTS = ["mobile", "desktop"];
+/** Resolve a screen's effective schemes against the catalogue default. */
+export function effectiveColorSchemes(entry, catalogueSchemes) {
+    return entry.colorSchemes ?? catalogueSchemes;
+}
+//# sourceMappingURL=views.js.map

package/dist/registry/views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.js","sourceRoot":"","sources":["../../src/registry/views.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAU/D,0DAA0D;AAC1D,MAAM,CAAC,MAAM,SAAS,GAAwB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEpE,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CACnC,KAAgD,EAChD,gBAAwC;IAExC,OAAO,KAAK,CAAC,YAAY,IAAI,gBAAgB,CAAC;AAChD,CAAC"}

package/dist/renderer/default.d.ts

@@ -0,0 +1,4 @@
+import type { RenderInput } from "./types.js";
+/** Render a screen as a neutral, complete static HTML document. */
+export default function render(input: RenderInput): string;
+//# sourceMappingURL=default.d.ts.map

package/dist/renderer/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/renderer/default.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,mEAAmE;AACnE,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAYzD"}

package/dist/renderer/default.js

@@ -0,0 +1,23 @@
+import { renderToStaticMarkup } from "react-dom/server";
+import { serializeReviewSentinels } from "./sentinels.js";
+/** Render a screen as a neutral, complete static HTML document. */
+export default function render(input) {
+    const links = input.stylesheets
+        .map((href) => `<link rel="stylesheet" href="${escapeAttribute(href)}">`)
+        .join("");
+    const body = serializeReviewSentinels(renderToStaticMarkup(input.node));
+    return [
+        "<!doctype html>",
+        `<html lang="en"><head><meta charset="utf-8">`,
+        `<meta name="viewport" content="width=device-width, initial-scale=1">`,
+        `<title>${escapeText(input.entry.title)}</title>${links}</head>`,
+        `<body data-mokly-viewport="${input.viewport}">${body}</body></html>\n`,
+    ].join("");
+}
+function escapeAttribute(value) {
+    return value.replaceAll("&", "&amp;").replaceAll('"', "&quot;");
+}
+function escapeText(value) {
+    return escapeAttribute(value).replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+//# sourceMappingURL=default.js.map

package/dist/renderer/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../src/renderer/default.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,mEAAmE;AACnE,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,KAAkB;IAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW;SAC5B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gCAAgC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;SACxE,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,MAAM,IAAI,GAAG,wBAAwB,CAAC,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACxE,OAAO;QACL,iBAAiB;QACjB,8CAA8C;QAC9C,sEAAsE;QACtE,UAAU,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS;QAChE,8BAA8B,KAAK,CAAC,QAAQ,KAAK,IAAI,kBAAkB;KACxE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAChF,CAAC"}

package/dist/renderer/sentinels.d.ts

@@ -0,0 +1,3 @@
+/** Convert React's inert templates into layout-neutral Review comments. */
+export declare function serializeReviewSentinels(html: string): string;
+//# sourceMappingURL=sentinels.d.ts.map

package/dist/renderer/sentinels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinels.d.ts","sourceRoot":"","sources":["../../src/renderer/sentinels.ts"],"names":[],"mappings":"AAMA,2EAA2E;AAC3E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmB7D"}

package/dist/renderer/sentinels.js

@@ -0,0 +1,22 @@
+import { assertReviewIgnoreId } from "../authoring/review_ignore.js";
+const BOUNDARY = /<template data-mokly-review-ignore-(start|end)="([^"]*)"><\/template>/g;
+const MATERIAL = /<template data-mokly-review-material="([^"]*)"><\/template>/g;
+/** Convert React's inert templates into layout-neutral Review comments. */
+export function serializeReviewSentinels(html) {
+    const boundaries = html.replace(BOUNDARY, (_all, boundary, id) => {
+        assertReviewIgnoreId(id);
+        return `<!--mokly-review-ignore:${boundary}:${id}-->`;
+    });
+    const serialized = boundaries.replace(MATERIAL, (_all, value) => {
+        const split = value.indexOf(":");
+        const id = value.slice(0, split);
+        const key = value.slice(split + 1);
+        assertReviewIgnoreId(id, key);
+        return `<!--mokly-review-material:${id}:${key}-->`;
+    });
+    if (serialized.includes("data-mokly-review-")) {
+        throw new Error("[mokly/review-ignore] could not serialize a sentinel");
+    }
+    return serialized;
+}
+//# sourceMappingURL=sentinels.js.map

package/dist/renderer/sentinels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinels.js","sourceRoot":"","sources":["../../src/renderer/sentinels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,QAAQ,GACZ,wEAAwE,CAAC;AAC3E,MAAM,QAAQ,GAAG,8DAA8D,CAAC;AAEhF,2EAA2E;AAC3E,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAC7B,QAAQ,EACR,CAAC,IAAI,EAAE,QAAgB,EAAE,EAAU,EAAE,EAAE;QACrC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QACzB,OAAO,2BAA2B,QAAQ,IAAI,EAAE,KAAK,CAAC;IACxD,CAAC,CACF,CAAC;IACF,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAa,EAAE,EAAE;QACtE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACnC,oBAAoB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC9B,OAAO,6BAA6B,EAAE,IAAI,GAAG,KAAK,CAAC;IACrD,CAAC,CAAC,CAAC;IACH,IAAI,UAAU,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/renderer/types.d.ts

@@ -0,0 +1,23 @@
+import type { ReactNode } from "react";
+import type { ColorScheme, ScreenDefinition, Viewport } from "../authoring/types.js";
+import type { ComponentDefinition } from "../components/types.js";
+import type { ComponentResourceOwnership, ComponentStyleOwnership } from "../components/manifest_types.js";
+/** Context passed by the builder to a consumer renderer. */
+export interface RenderInput {
+    colorScheme: ColorScheme;
+    entry: ScreenDefinition | ComponentDefinition;
+    variantId?: string;
+    componentProps?: Readonly<Record<string, unknown>>;
+    node: ReactNode;
+    stylesheets: readonly string[];
+    viewport: Viewport;
+}
+/** Optional exact ownership of component-generated style/resource material. */
+export interface RenderResult {
+    html: string;
+    styles?: readonly ComponentStyleOwnership[];
+    resources?: readonly ComponentResourceOwnership[];
+}
+/** Synchronous complete-document renderer contract. */
+export type Renderer = (input: RenderInput) => string | RenderResult;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/renderer/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACT,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,iCAAiC,CAAC;AAEzC,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,gBAAgB,GAAG,mBAAmB,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;CACnD;AAED,uDAAuD;AACvD,MAAM,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,MAAM,GAAG,YAAY,CAAC"}

package/dist/renderer/types.js

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

package/dist/renderer/types.js.map

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

package/dist/review/artifact.d.ts

@@ -0,0 +1,7 @@
+/** Retain comparison JSON, snapshots, and a diagnostic summary. */
+import type { ReviewArtifact, ReviewArtifactContent, ReviewResult } from "./types.js";
+/** Add comparison metadata to isolated snapshot files. */
+export declare function renderReviewArtifact(artifact: ReviewArtifact): ReadonlyMap<string, ReviewArtifactContent>;
+/** Create a concise deterministic CI summary. */
+export declare function summaryMarkdown(result: ReviewResult): string;
+//# sourceMappingURL=artifact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../src/review/artifact.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAMnE,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,YAAY,EACb,MAAM,YAAY,CAAC;AAIpB,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,GACvB,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAe5C;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAmC5D"}

package/dist/review/artifact.js

@@ -0,0 +1,48 @@
+/** Retain comparison JSON, snapshots, and a diagnostic summary. */
+import { parseReviewResult } from "./result_validation.js";
+import { canonicalJson } from "../components/data.js";
+import { markdownCode, markdownText } from "./markdown.js";
+import { hasOutputChange, isImpactOnly } from "./materiality.js";
+import { addArtifactFile } from "./paths.js";
+/** Add comparison metadata to isolated snapshot files. */
+export function renderReviewArtifact(artifact) {
+    if (artifact.result.schemaVersion === 3)
+        parseReviewResult(artifact.result);
+    const files = new Map(artifact.files);
+    addArtifactFile(files, "review.json", `${artifact.result.schemaVersion === 3 ? canonicalJson(artifact.result, 2) : JSON.stringify(artifact.result, null, 2)}\n`);
+    addArtifactFile(files, "summary.md", summaryMarkdown(artifact.result));
+    addArtifactFile(files, ".mokly-review-artifact", `schemaVersion=${artifact.result.schemaVersion}\n`);
+    return files;
+}
+/** Create a concise deterministic CI summary. */
+export function summaryMarkdown(result) {
+    if (result.schemaVersion === 3)
+        return `## Mokly Review
+
+Base: ${markdownCode(result.baseRef)} (${markdownCode(result.baseCommit.slice(0, 12))})
+
+Changes: ${result.changes.length}; screens: ${result.screens.length}; components: ${result.components.length}; affected consumers: ${result.affectedConsumers.length}.
+
+${result.changes.map((change) => `- ${change.kind}: ${markdownText((change.after ?? change.before).title)} (${change.reasons.map((reason) => reason.kind).join(", ")})`).join("\n")}
+`;
+    const outputChanges = result.screens.filter(hasOutputChange).length;
+    const impactEvidence = result.screens.filter((screen) => screen.sharedImpact.length > 0).length;
+    const impactOnly = result.screens.filter(isImpactOnly).length;
+    const counts = new Map();
+    for (const screen of result.screens)
+        counts.set(screen.state, (counts.get(screen.state) ?? 0) + 1);
+    const lines = [
+        "## Mokly Review",
+        "",
+        `Base: ${markdownCode(result.baseRef)} (${markdownCode(result.baseCommit.slice(0, 12))})`,
+        "",
+        `Screens: ${result.screens.length}; output changes: ${outputChanges}; changed: ${counts.get("changed") ?? 0}; added: ${counts.get("added") ?? 0}; removed: ${counts.get("removed") ?? 0}; ignored-only: ${counts.get("ignored-only") ?? 0}; impact evidence: ${impactEvidence}; impact-only: ${impactOnly}.`,
+        "",
+        "Output changes count screens with output changes, once per screen across all viewports and color schemes; catalogue Changes also considers rendered resources, metadata, and flows. Impact evidence is counted independently; impact-only screens have no output change and can also be ignored-only.",
+    ];
+    if (result.sharedImpact.length > 0) {
+        lines.push("", "Shared-impact paths:", ...result.sharedImpact.map((item) => `- ${markdownCode(item)}`));
+    }
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=artifact.js.map

package/dist/review/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../src/review/artifact.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAO3D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,0DAA0D;AAC1D,MAAM,UAAU,oBAAoB,CAClC,QAAwB;IAExB,IAAI,QAAQ,CAAC,MAAM,CAAC,aAAa,KAAK,CAAC;QAAE,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtC,eAAe,CACb,KAAK,EACL,aAAa,EACb,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAC1H,CAAC;IACF,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACvE,eAAe,CACb,KAAK,EACL,wBAAwB,EACxB,iBAAiB,QAAQ,CAAC,MAAM,CAAC,aAAa,IAAI,CACnD,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,IAAI,MAAM,CAAC,aAAa,KAAK,CAAC;QAC5B,OAAO;;QAEH,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;;WAE1E,MAAM,CAAC,OAAO,CAAC,MAAM,cAAc,MAAM,CAAC,OAAO,CAAC,MAAM,iBAAiB,MAAM,CAAC,UAAU,CAAC,MAAM,yBAAyB,MAAM,CAAC,iBAAiB,CAAC,MAAM;;EAElK,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAE,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;CACnL,CAAC;IACA,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC;IACpE,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAC1C,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAC3C,CAAC,MAAM,CAAC;IACT,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO;QACjC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG;QACZ,iBAAiB;QACjB,EAAE;QACF,SAAS,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG;QACzF,EAAE;QACF,YAAY,MAAM,CAAC,OAAO,CAAC,MAAM,qBAAqB,aAAa,cAAc,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,sBAAsB,cAAc,kBAAkB,UAAU,GAAG;QAC5S,EAAE;QACF,uSAAuS;KACxS,CAAC;IACF,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CACR,EAAE,EACF,sBAAsB,EACtB,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAChE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC"}

package/dist/review/asset_references.d.ts

@@ -0,0 +1,5 @@
+import { type HtmlReferenceOptions } from "../html_references.js";
+import type { ReviewArtifactContent } from "./types.js";
+/** Resolve portable local resource references using the snapshot URL rules. */
+export declare function referencedRoutes(sourceRoute: string, content: ReviewArtifactContent, options?: HtmlReferenceOptions): string[];
+//# sourceMappingURL=asset_references.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asset_references.d.ts","sourceRoot":"","sources":["../../src/review/asset_references.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,EAAE,CAoBV"}

package/dist/review/asset_references.js

@@ -0,0 +1,56 @@
+import path from "node:path";
+import { isSafeRepositoryPath } from "../config/paths.js";
+import { MoklyError } from "../errors.js";
+import { extractCssReferences, extractHtmlReferences, } from "../html_references.js";
+/** Resolve portable local resource references using the snapshot URL rules. */
+export function referencedRoutes(sourceRoute, content, options) {
+    const extension = path.posix.extname(sourceRoute).toLowerCase();
+    const text = typeof content === "string"
+        ? content
+        : Buffer.from(content).toString("utf8");
+    const references = extension === ".css"
+        ? extractCssReferences(text)
+        : extension === ".html" || extension === ".htm"
+            ? extractHtmlReferences(text, options).resources
+            : [];
+    return [
+        ...new Set(references.flatMap((reference) => {
+            const resolved = resolveReference(sourceRoute, reference);
+            return resolved ? [resolved] : [];
+        })),
+    ].sort();
+}
+function resolveReference(sourceRoute, rawReference) {
+    const reference = rawReference.trim();
+    if (reference.startsWith("//")) {
+        throw assetError(sourceRoute, `non-portable asset URL ${reference} (protocol-relative)`);
+    }
+    if (reference.startsWith("/")) {
+        throw assetError(sourceRoute, `non-portable asset URL ${reference} (root-absolute)`);
+    }
+    if (reference === "" ||
+        reference.startsWith("#") ||
+        /^(?:https?:|data:)/i.test(reference)) {
+        return undefined;
+    }
+    if (/^[a-z][a-z0-9+.-]*:/i.test(reference)) {
+        throw assetError(sourceRoute, `non-portable asset URL ${reference} (unsupported scheme)`);
+    }
+    const encodedPath = reference.split(/[?#]/, 1)[0] ?? "";
+    let decodedPath;
+    try {
+        decodedPath = decodeURIComponent(encodedPath);
+    }
+    catch (error) {
+        throw assetError(sourceRoute, `invalid asset URL ${reference}`, error);
+    }
+    const resolved = path.posix.normalize(path.posix.join(path.posix.dirname(sourceRoute), decodedPath));
+    if (!isSafeRepositoryPath(resolved)) {
+        throw assetError(sourceRoute, `asset URL escapes mockupsDir: ${reference}`);
+    }
+    return resolved;
+}
+function assetError(route, detail, cause) {
+    return new MoklyError("review-invalid", `could not retain Review asset ${route}: ${detail}`, cause === undefined ? undefined : { cause });
+}
+//# sourceMappingURL=asset_references.js.map

package/dist/review/asset_references.js.map

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