@mokly/mokly 0.8.0

package/dist/server/child_lifecycle.d.ts

@@ -0,0 +1,37 @@
+/** One child owns readiness, terminal observation and an idempotent cleanup operation. */
+import { MoklyError } from "../errors.js";
+import type { ChildHandle } from "./child_process.js";
+import type { ChildCommand } from "./update_messages.js";
+/** Time allowed for each watched-child shutdown stage. */
+export interface ChildShutdownTimings {
+    gracefulMilliseconds: number;
+    terminateMilliseconds: number;
+}
+/** Retain a child until its terminal event, even when readiness or IPC fails. */
+export declare class ManagedChild {
+    #private;
+    private readonly handle;
+    private readonly onUnexpectedFailure;
+    private readonly timings;
+    readonly ready: Promise<number>;
+    constructor(handle: ChildHandle, onUnexpectedFailure: (error: Error) => void, timings?: ChildShutdownTimings);
+    /** Confirmed terminal state, never inferred from sending a signal. */
+    get exited(): boolean;
+    /** Cleanup has started and updates/readiness must no longer be accepted. */
+    get stopping(): boolean;
+    /** First failure, retained through subsequent shutdown errors. */
+    get failure(): MoklyError | undefined;
+    /** Observe messages while this lifecycle still owns a starting or ready child. */
+    onMessage(callback: (message: unknown) => void): void;
+    /** Deliver the startup graph before readiness; other updates require a ready child. */
+    send(message: ChildCommand): void;
+    /** Every caller waits on the same terminal promise and escalation timers. */
+    close(): Promise<void>;
+    /** Expected shutdown may close IPC before the process finishes; keep awaiting exit. */
+    private didDisconnect;
+    private fail;
+    private didExit;
+    /** Broken IPC or a failed signal cannot skip later cleanup stages or release ownership. */
+    private attemptShutdown;
+}
+//# sourceMappingURL=child_lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"child_lifecycle.d.ts","sourceRoot":"","sources":["../../src/server/child_lifecycle.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAQD,iFAAiF;AACjF,qBAAa,YAAY;;IAerB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhB1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBAcb,MAAM,EAAE,WAAW,EACnB,mBAAmB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAC3C,OAAO,GAAE,oBAAsC;IA2BlE,sEAAsE;IACtE,IAAI,MAAM,IAAI,OAAO,CAEpB;IACD,4EAA4E;IAC5E,IAAI,QAAQ,IAAI,OAAO,CAEtB;IACD,kEAAkE;IAClE,IAAI,OAAO,IAAI,UAAU,GAAG,SAAS,CAEpC;IAED,kFAAkF;IAClF,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAIrD,uFAAuF;IACvF,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAiBjC,6EAA6E;IAC7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBtB,uFAAuF;IACvF,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,OAAO;IAkBf,2FAA2F;IAC3F,OAAO,CAAC,eAAe;CAOxB"}

package/dist/server/child_lifecycle.js

@@ -0,0 +1,167 @@
+/** One child owns readiness, terminal observation and an idempotent cleanup operation. */
+import { MoklyError, errorMessage } from "../errors.js";
+const DEFAULT_TIMINGS = {
+    gracefulMilliseconds: 2_000,
+    terminateMilliseconds: 2_000,
+};
+const READINESS_TIMEOUT_MILLISECONDS = 300_000;
+/** Retain a child until its terminal event, even when readiness or IPC fails. */
+export class ManagedChild {
+    handle;
+    onUnexpectedFailure;
+    timings;
+    ready;
+    #exit;
+    #resolveReady = () => undefined;
+    #rejectReady = () => undefined;
+    #resolveExit = () => undefined;
+    #state = "waiting";
+    #failure;
+    #messages = [];
+    #cleanup;
+    #readinessTimer;
+    #terminateTimer;
+    #forceTimer;
+    constructor(handle, onUnexpectedFailure, timings = DEFAULT_TIMINGS) {
+        this.handle = handle;
+        this.onUnexpectedFailure = onUnexpectedFailure;
+        this.timings = timings;
+        this.ready = new Promise((resolve, reject) => {
+            this.#resolveReady = resolve;
+            this.#rejectReady = reject;
+        });
+        this.#exit = new Promise((resolve) => {
+            this.#resolveExit = resolve;
+        });
+        this.#readinessTimer = setTimeout(() => {
+            this.fail(new Error("server child readiness timed out"));
+        }, READINESS_TIMEOUT_MILLISECONDS);
+        this.#readinessTimer.unref();
+        handle.onExit((code) => this.didExit(code));
+        handle.onError((error) => this.fail(error));
+        handle.onDisconnect(() => this.didDisconnect());
+        handle.onMessage((message) => {
+            if (this.#state === "waiting" && isReady(message)) {
+                this.#state = "ready";
+                clearTimeout(this.#readinessTimer);
+                this.#resolveReady(message.port);
+            }
+            if (this.#state === "waiting" || this.#state === "ready")
+                for (const callback of this.#messages)
+                    callback(message);
+        });
+    }
+    /** Confirmed terminal state, never inferred from sending a signal. */
+    get exited() {
+        return this.#state === "exited";
+    }
+    /** Cleanup has started and updates/readiness must no longer be accepted. */
+    get stopping() {
+        return this.#cleanup !== undefined;
+    }
+    /** First failure, retained through subsequent shutdown errors. */
+    get failure() {
+        return this.#failure;
+    }
+    /** Observe messages while this lifecycle still owns a starting or ready child. */
+    onMessage(callback) {
+        this.#messages.push(callback);
+    }
+    /** Deliver the startup graph before readiness; other updates require a ready child. */
+    send(message) {
+        if (this.#state !== "ready" &&
+            !(this.#state === "waiting" &&
+                (message.type === "component-runtime-startup" ||
+                    message.type === "component-runtime")))
+            return;
+        try {
+            this.handle.send(message);
+        }
+        catch (error) {
+            this.fail(error);
+        }
+    }
+    /** Every caller waits on the same terminal promise and escalation timers. */
+    close() {
+        if (this.#cleanup)
+            return this.#cleanup;
+        this.#cleanup = this.#exit;
+        if (this.exited)
+            return this.#cleanup;
+        if (this.#state === "waiting") {
+            this.#failure ??= serverFailure(new Error("server child closed before readiness"));
+            this.#rejectReady(this.#failure);
+        }
+        this.#state = "stopping";
+        clearTimeout(this.#readinessTimer);
+        this.#terminateTimer = setTimeout(() => {
+            this.attemptShutdown(() => this.handle.terminate());
+            if (this.exited)
+                return;
+            this.#forceTimer = setTimeout(() => {
+                if (!this.exited)
+                    this.attemptShutdown(() => this.handle.forceKill());
+            }, this.timings.terminateMilliseconds);
+            this.#forceTimer.unref();
+        }, this.timings.gracefulMilliseconds);
+        this.#terminateTimer.unref();
+        this.attemptShutdown(() => this.handle.send({ type: "shutdown" }));
+        return this.#cleanup;
+    }
+    /** Expected shutdown may close IPC before the process finishes; keep awaiting exit. */
+    didDisconnect() {
+        if (this.#state === "waiting" || this.#state === "ready")
+            this.fail(new Error("server child IPC disconnected"));
+    }
+    fail(error) {
+        if (this.exited)
+            return;
+        this.#failure ??= serverFailure(error);
+        const state = this.#state;
+        if (state === "stopping")
+            return;
+        if (state === "waiting")
+            this.#rejectReady(this.#failure);
+        void this.close();
+        if (state === "ready")
+            this.onUnexpectedFailure(this.#failure);
+    }
+    didExit(code) {
+        if (this.exited)
+            return;
+        const state = this.#state;
+        this.#state = "exited";
+        clearTimeout(this.#readinessTimer);
+        clearTimeout(this.#terminateTimer);
+        clearTimeout(this.#forceTimer);
+        this.#resolveExit();
+        if (state === "stopping")
+            return;
+        this.#failure ??= serverFailure(new Error(`server child exited ${state === "waiting" ? "before readiness" : "unexpectedly"} (${String(code)})`));
+        if (state === "waiting")
+            this.#rejectReady(this.#failure);
+        else
+            this.onUnexpectedFailure(this.#failure);
+    }
+    /** Broken IPC or a failed signal cannot skip later cleanup stages or release ownership. */
+    attemptShutdown(action) {
+        try {
+            action();
+        }
+        catch (error) {
+            this.#failure ??= serverFailure(error);
+        }
+    }
+}
+function serverFailure(error) {
+    return new MoklyError("server-failed", errorMessage(error), {
+        cause: error,
+    });
+}
+function isReady(message) {
+    return (typeof message === "object" &&
+        message !== null &&
+        message.type === "ready" &&
+        Number.isInteger(message.port));
+}
+//# sourceMappingURL=child_lifecycle.js.map

package/dist/server/child_lifecycle.js.map

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

package/dist/server/child_process.d.ts

@@ -0,0 +1,25 @@
+/** Native child handles retain terminal state, including failed process creation. */
+import type { ChildCommand } from "./update_messages.js";
+/** Process boundary used by the watched-child lifecycle. */
+export interface ChildHandle {
+    forceKill(): void;
+    /** Replay IPC disconnection to late subscribers; it does not confirm process exit. */
+    onDisconnect(callback: () => void): void;
+    onError(callback: (error: Error) => void): void;
+    /** Replay a terminal result to late subscribers; failed spawning is terminal too. */
+    onExit(callback: (code: number | null) => void): void;
+    onMessage(callback: (message: unknown) => void): void;
+    send(message: ChildCommand): void;
+    terminate(): void;
+}
+/** Factory seam for child lifecycle ordering and process creation. */
+export interface ChildFactory {
+    spawn(arguments_: readonly string[]): ChildHandle;
+}
+/** Node IPC child factory. */
+export declare class NodeChildFactory implements ChildFactory {
+    private readonly binPath;
+    constructor(binPath: string);
+    spawn(arguments_: readonly string[]): ChildHandle;
+}
+//# sourceMappingURL=child_process.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"child_process.d.ts","sourceRoot":"","sources":["../../src/server/child_process.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAIrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,SAAS,IAAI,IAAI,CAAC;IAClB,sFAAsF;IACtF,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACzC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IAChD,qFAAqF;IACrF,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;IACtD,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACtD,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAAC;CACnD;AAED,8BAA8B;AAC9B,qBAAa,gBAAiB,YAAW,YAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAE5C,KAAK,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW;CAOlD"}

package/dist/server/child_process.js

@@ -0,0 +1,65 @@
+/** Native child handles retain terminal state, including failed process creation. */
+import { fork } from "node:child_process";
+/** Node IPC child factory. */
+export class NodeChildFactory {
+    binPath;
+    constructor(binPath) {
+        this.binPath = binPath;
+    }
+    spawn(arguments_) {
+        return new NodeChildHandle(fork(this.binPath, [...arguments_], {
+            stdio: ["inherit", "inherit", "inherit", "ipc"],
+        }));
+    }
+}
+class NodeChildHandle {
+    child;
+    #disconnected = false;
+    #terminal;
+    #disconnects = [];
+    #exits = [];
+    constructor(child) {
+        this.child = child;
+        child.once("disconnect", () => {
+            this.#disconnected = true;
+            for (const callback of this.#disconnects.splice(0))
+                callback();
+        });
+        child.once("close", (code) => {
+            this.#terminal = { code };
+            for (const callback of this.#exits.splice(0))
+                callback(code);
+        });
+    }
+    forceKill() {
+        if (this.child.exitCode === null && this.child.signalCode === null)
+            this.child.kill("SIGKILL");
+    }
+    onDisconnect(callback) {
+        if (this.#disconnected)
+            callback();
+        else
+            this.#disconnects.push(callback);
+    }
+    onError(callback) {
+        this.child.on("error", callback);
+    }
+    onExit(callback) {
+        if (this.#terminal)
+            callback(this.#terminal.code);
+        else
+            this.#exits.push(callback);
+    }
+    onMessage(callback) {
+        this.child.on("message", callback);
+    }
+    send(message) {
+        if (this.child.connected)
+            this.child.send(message);
+    }
+    terminate() {
+        if (this.child.exitCode === null && this.child.signalCode === null)
+            this.child.kill("SIGTERM");
+    }
+}
+//# sourceMappingURL=child_process.js.map

package/dist/server/child_process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child_process.js","sourceRoot":"","sources":["../../src/server/child_process.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,EAAE,IAAI,EAAqB,MAAM,oBAAoB,CAAC;AAsB7D,8BAA8B;AAC9B,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEhD,KAAK,CAAC,UAA6B;QACjC,OAAO,IAAI,eAAe,CACxB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE;YAClC,KAAK,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC;SAChD,CAAC,CACH,CAAC;IACJ,CAAC;CACF;AAED,MAAM,eAAe;IAMU;IAL7B,aAAa,GAAG,KAAK,CAAC;IACtB,SAAS,CAAsC;IACtC,YAAY,GAAsB,EAAE,CAAC;IACrC,MAAM,GAAyC,EAAE,CAAC;IAE3D,YAA6B,KAAmB;QAAnB,UAAK,GAAL,KAAK,CAAc;QAC9C,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE;YAC5B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;gBAAE,QAAQ,EAAE,CAAC;QACjE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAC3B,IAAI,CAAC,SAAS,GAAG,EAAE,IAAI,EAAE,CAAC;YAC1B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS;QACP,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI;YAChE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAED,YAAY,CAAC,QAAoB;QAC/B,IAAI,IAAI,CAAC,aAAa;YAAE,QAAQ,EAAE,CAAC;;YAC9B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,CAAC,QAAgC;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,QAAuC;QAC5C,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;;YAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,SAAS,CAAC,QAAoC;QAC5C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,OAAqB;QACxB,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,SAAS;QACP,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI;YAChE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/server/client_modules.d.ts

@@ -0,0 +1,9 @@
+/** Loading of the package-owned assets the shell serves: the allowlisted
+ * browser client modules and the packaged shell font files. */
+/** Load the allowlisted browser modules before the HTTP server binds. */
+export declare function loadBrowserClientModules(): ReadonlyMap<string, Buffer>;
+/** Load shared pure navigation modules imported by the browser client. */
+export declare function loadBrowserNavigationModules(): ReadonlyMap<string, Buffer>;
+/** Load the packaged shell fonts before the HTTP server binds. */
+export declare function loadShellFontAssets(): ReadonlyMap<string, Buffer>;
+//# sourceMappingURL=client_modules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client_modules.d.ts","sourceRoot":"","sources":["../../src/server/client_modules.ts"],"names":[],"mappings":"AAAA;+DAC+D;AAO/D,yEAAyE;AACzE,wBAAgB,wBAAwB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CA+DtE;AAED,0EAA0E;AAC1E,wBAAgB,4BAA4B,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAM1E;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBjE"}

package/dist/server/client_modules.js

@@ -0,0 +1,101 @@
+/** Loading of the package-owned assets the shell serves: the allowlisted
+ * browser client modules and the packaged shell font files. */
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+import { MoklyError, errorMessage } from "../errors.js";
+/** Load the allowlisted browser modules before the HTTP server binds. */
+export function loadBrowserClientModules() {
+    const modules = new Map();
+    for (const filename of [
+        "browse.js",
+        "browse_controls.js",
+        "browse_update_state.js",
+        "browse_evidence.js",
+        "browse_fetch.js",
+        "browse_refresh.js",
+        "workspace_updates.js",
+        "diffs.js",
+        "diff_views.js",
+        "workspace.js",
+        "workspace_loading.js",
+        "component_controls.js",
+        "control_fields.js",
+        "control_transport.js",
+        "control_surface.js",
+        "workspace_events.js",
+        "workspace_variants.js",
+        "workspace_preview.js",
+        "workspace_evidence.js",
+        "prop_display.js",
+        "inspector_resize.js",
+        "inspector_tabs.js",
+        "inspector_panels.js",
+        "component_geometry.js",
+        "component_range_nodes.js",
+        "component_occlusion.js",
+        "component_overlay.js",
+        "component_highlight.js",
+        "browse_details.js",
+        "browse_links.js",
+        "browse_frames.js",
+        "browse_navigation.js",
+        "browse_navigation_state.js",
+        "frame_navigation.js",
+        "browse_state.js",
+        "browse_recovery.js",
+        "browser.js",
+        "clipboard.js",
+        "live_updates.js",
+        "navigation.js",
+        "navigation-resize.js",
+        "preview_fragment.js",
+        "search_query.js",
+        "static_delivery.js",
+        "tag_filter.js",
+    ]) {
+        const candidate = fileURLToPath(new URL(`../browser/${filename}`, import.meta.url));
+        try {
+            modules.set(filename, fs.readFileSync(candidate));
+        }
+        catch (error) {
+            throw new MoklyError("server-failed", `could not load browser client ${filename}: ${errorMessage(error)}`, { cause: error });
+        }
+    }
+    return modules;
+}
+/** Load shared pure navigation modules imported by the browser client. */
+export function loadBrowserNavigationModules() {
+    return loadModules("../navigation", [
+        "logical.js",
+        "target.js",
+        "delivery.js",
+    ]);
+}
+/** Load the packaged shell fonts before the HTTP server binds. */
+export function loadShellFontAssets() {
+    const fonts = new Map();
+    for (const filename of ["InterVariable.woff2", "Inter-OFL.txt"]) {
+        const candidate = fileURLToPath(new URL(`./shell/assets/fonts/${filename}`, import.meta.url));
+        try {
+            fonts.set(filename, fs.readFileSync(candidate));
+        }
+        catch (error) {
+            throw new MoklyError("server-failed", `could not load shell font ${filename}: ${errorMessage(error)}`, { cause: error });
+        }
+    }
+    return fonts;
+}
+function loadModules(relativeDirectory, filenames) {
+    const modules = new Map();
+    for (const filename of filenames) {
+        const candidate = fileURLToPath(new URL(`${relativeDirectory}/${filename}`, import.meta.url));
+        try {
+            modules.set(filename, fs.readFileSync(candidate));
+        }
+        catch (error) {
+            throw new MoklyError("server-failed", `could not load browser module ${filename}: ${errorMessage(error)}`, { cause: error });
+        }
+    }
+    return modules;
+}
+//# sourceMappingURL=client_modules.js.map

package/dist/server/client_modules.js.map

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

package/dist/server/component_changes.d.ts

@@ -0,0 +1,49 @@
+import type { ReviewEvidence } from "../review/selection_types.js";
+import type { ResolvedConfig } from "../config/types.js";
+import type { Manifest } from "../registry/types.js";
+import type { ReviewResultV3 } from "../review/component_types.js";
+import { type GitClient, type GitCommandRunner } from "../review/git.js";
+export interface ComponentChangeSnapshot {
+    baseline: Manifest;
+    changedRoutes?: readonly string[];
+    result?: ReviewResultV3;
+    comparison?: ReviewEvidence;
+}
+export interface ComponentChangeSource {
+    baseline(): Promise<string>;
+    read(commit: string): Promise<ComponentChangeSnapshot | undefined>;
+}
+/** Read-only catalogue classification boundary used outside the HTTP child. */
+export interface CatalogueChangeClassifier {
+    read(config: ResolvedConfig, manifest: Manifest, base: string, signal?: AbortSignal): Promise<ComponentChangeSnapshot | undefined>;
+}
+/** Classify one generated catalogue against its repository branch point. */
+export declare class RepositoryCatalogueChangeClassifier implements CatalogueChangeClassifier {
+    private readonly commands?;
+    constructor(commands?: GitCommandRunner | undefined);
+    read(config: ResolvedConfig, manifest: Manifest, base: string, signal?: AbortSignal): Promise<ComponentChangeSnapshot | undefined>;
+}
+/** Retain one immutable classification; resolving the baseline never creates Review artifacts. */
+export declare class ComponentChangeCache {
+    private readonly source;
+    private cached;
+    private epoch;
+    private sequence;
+    constructor(source: ComponentChangeSource);
+    invalidate(): void;
+    read(generation: number): Promise<ComponentChangeSnapshot | undefined>;
+}
+/** Production read boundary for a last-good catalogue and its current Git branch point. */
+export declare class RepositoryComponentChanges implements ComponentChangeSource {
+    private readonly config;
+    private readonly manifest;
+    private readonly base;
+    private readonly runner;
+    private readonly git;
+    constructor(config: ResolvedConfig, manifest: Manifest, base: string, signal?: AbortSignal, commands?: GitCommandRunner);
+    baseline(): Promise<string>;
+    read(commit: string): Promise<ComponentChangeSnapshot | undefined>;
+}
+/** Classify pages and ownership-aware component views against one pinned baseline. */
+export declare function readCatalogueChanges(config: ResolvedConfig, manifest: Manifest, base: string, git: GitClient, commit: string): Promise<ComponentChangeSnapshot>;
+//# sourceMappingURL=component_changes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component_changes.d.ts","sourceRoot":"","sources":["../../src/server/component_changes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AACD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAC;CACpE;AAED,+EAA+E;AAC/E,MAAM,WAAW,yBAAyB;IACxC,IAAI,CACF,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAC;CACjD;AAED,4EAA4E;AAC5E,qBAAa,mCAAoC,YAAW,yBAAyB;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAT,QAAQ,CAAC,EAAE,gBAAgB,YAAA;IAElD,IAAI,CACR,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;CAiBhD;AAED,kGAAkG;AAClG,qBAAa,oBAAoB;IAUnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IATnC,OAAO,CAAC,MAAM,CAMA;IACd,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAK;gBACQ,MAAM,EAAE,qBAAqB;IAC1D,UAAU,IAAI,IAAI;IAIZ,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;CAe7E;AAED,2FAA2F;AAC3F,qBAAa,0BAA2B,YAAW,qBAAqB;IAIpE,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;gBAEvB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EAC7B,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,gBAAgB;IAKvB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAS3B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;CASzE;AAED,sFAAsF;AACtF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,CAAC,CAuElC"}

package/dist/server/component_changes.js

@@ -0,0 +1,129 @@
+import { changedManifestRoutes } from "../registry/changed_routes.js";
+import { hasRegisteredComponents } from "../registry/manifest_capabilities.js";
+import { changedContentPaths } from "./changed_content.js";
+import { generatedViews } from "../components/views.js";
+import { EvidenceAssetReader } from "../review/evidence_assets.js";
+import path from "node:path";
+import { projectRealPath, toPosixPath } from "../config/paths.js";
+import { GitReviewAssetReader } from "../review/assets.js";
+import { baselineResourceConfig, readBaseManifest, } from "../review/base_manifest.js";
+import { reviewChangedPaths } from "../review/changed_paths.js";
+import { classifyComponents } from "../review/component_classification.js";
+import { NodeGitCommandRunner, RepositoryGitClient, } from "../review/git.js";
+/** Classify one generated catalogue against its repository branch point. */
+export class RepositoryCatalogueChangeClassifier {
+    commands;
+    constructor(commands) {
+        this.commands = commands;
+    }
+    async read(config, manifest, base, signal) {
+        try {
+            const source = new RepositoryComponentChanges(config, manifest, base, signal, this.commands);
+            signal?.throwIfAborted();
+            const baseline = await source.baseline();
+            signal?.throwIfAborted();
+            return await source.read(baseline);
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+/** Retain one immutable classification; resolving the baseline never creates Review artifacts. */
+export class ComponentChangeCache {
+    source;
+    cached;
+    epoch = 0;
+    sequence = 0;
+    constructor(source) {
+        this.source = source;
+    }
+    invalidate() {
+        this.epoch++;
+        this.cached = undefined;
+    }
+    async read(generation) {
+        const epoch = this.epoch;
+        const sequence = ++this.sequence;
+        try {
+            const baseline = await this.source.baseline();
+            const key = `${epoch}:${generation}:${baseline}`;
+            if (this.cached?.key === key)
+                return this.cached.result;
+            const result = this.source.read(baseline).catch(() => undefined);
+            if (epoch === this.epoch && sequence >= (this.cached?.sequence ?? 0))
+                this.cached = { sequence, key, result };
+            return result;
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+/** Production read boundary for a last-good catalogue and its current Git branch point. */
+export class RepositoryComponentChanges {
+    config;
+    manifest;
+    base;
+    runner;
+    git;
+    constructor(config, manifest, base, signal, commands) {
+        this.config = config;
+        this.manifest = manifest;
+        this.base = base;
+        this.runner = commands ?? new NodeGitCommandRunner(config.repoRoot, signal);
+        this.git = new RepositoryGitClient(this.runner);
+    }
+    async baseline() {
+        if (projectRealPath((await this.runner.run(["rev-parse", "--show-toplevel"])).trim()) !== projectRealPath(this.config.repoRoot))
+            throw new Error("Comparison requires the configured repository root");
+        return this.git.mergeBase(this.base, "HEAD");
+    }
+    async read(commit) {
+        return readCatalogueChanges(this.config, this.manifest, this.base, this.git, commit);
+    }
+}
+/** Classify pages and ownership-aware component views against one pinned baseline. */
+export async function readCatalogueChanges(config, manifest, base, git, commit) {
+    const baseline = await readBaseManifest(git, commit, config);
+    const changedPaths = await reviewChangedPaths(git, commit, config, config.review.outDir);
+    const components = hasRegisteredComponents(baseline) || hasRegisteredComponents(manifest);
+    const prefix = toPosixPath(path.relative(config.repoRoot, config.mockupsDir));
+    const reader = new EvidenceAssetReader(config);
+    const result = components
+        ? await classifyComponents({
+            before: baseline,
+            after: manifest,
+            config,
+            baseCommit: commit,
+            baseRef: base,
+            changedPaths,
+            beforeReader: new GitReviewAssetReader(baselineResourceConfig(config, baseline), git, commit, prefix),
+            afterReader: reader,
+        })
+        : undefined;
+    const content = await changedContentPaths(manifest, baseline, config, git, commit, changedPaths, reader, components ? "pages" : "all");
+    const pageRoutes = new Set(manifest.entries.flatMap((entry) => entry.kind === "page" ? [entry.route] : []));
+    const routes = changedManifestRoutes(manifest, baseline, config, content).filter((route) => !components || pageRoutes.has(route));
+    for (const entry of manifest.entries)
+        for (const view of generatedViews(entry))
+            if (!reader.digests[view.path])
+                await reader.read(view.path);
+    return {
+        baseline,
+        comparison: {
+            baseCommit: commit,
+            baseRef: base,
+            changedPaths,
+            headDigests: reader.digests,
+        },
+        ...(result ? { result } : {}),
+        changedRoutes: [
+            ...new Set([
+                ...routes,
+                ...(result?.changes.map((entry) => (entry.after ?? entry.before).route) ?? []),
+            ]),
+        ].sort(),
+    };
+}
+//# sourceMappingURL=component_changes.js.map

package/dist/server/component_changes.js.map

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

package/dist/server/confined_file.d.ts

@@ -0,0 +1,2 @@
+export declare function readConfinedFile(directory: string, relative: string): Buffer | undefined;
+//# sourceMappingURL=confined_file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confined_file.d.ts","sourceRoot":"","sources":["../../src/server/confined_file.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CA6CpB"}