@mokly/mokly 0.8.0

package/dist/server/supervisor.js

@@ -0,0 +1,162 @@
+/** Restart supervision retains ownership until each child's cleanup completes. */
+import { MoklyError } from "../errors.js";
+import { bindTimings, timeSync } from "../diagnostics/timings.js";
+import { ManagedChild } from "./child_lifecycle.js";
+import { NodeChildFactory } from "./child_process.js";
+import { componentRuntimeMessage } from "./controls/runtime_ipc.js";
+import { childUpdateMessage, } from "./update_messages.js";
+import { parsePreviewObservation, } from "./demand/observation.js";
+/** Node child-process supervisor factory. */
+export class NodeProcessSupervisorFactory {
+    create(binPath, baseArguments, requestedPort) {
+        return new ReadyProcessSupervisor(new NodeChildFactory(binPath), baseArguments, requestedPort);
+    }
+}
+/** Child supervisor that waits for readiness and retains a resolved port. */
+export class ReadyProcessSupervisor {
+    factory;
+    baseArguments;
+    requestedPort;
+    shutdownTimings;
+    #child;
+    #unexpectedExit;
+    #resolvedPort;
+    #updateVersion = 0;
+    #runtime;
+    #foreground;
+    #previewResources;
+    constructor(factory, baseArguments, requestedPort, shutdownTimings) {
+        this.factory = factory;
+        this.baseArguments = baseArguments;
+        this.requestedPort = requestedPort;
+        this.shutdownTimings = shutdownTimings;
+    }
+    async start() {
+        if (this.#child)
+            throw new MoklyError("server-failed", "server child is already running");
+        const resolvedPort = this.#resolvedPort;
+        this.#updateVersion++;
+        const runtime = this.#runtime;
+        const handle = this.factory.spawn([
+            ...this.baseArguments,
+            ...(runtime ? ["--retained-runtime"] : []),
+            "--port",
+            String(resolvedPort ?? this.requestedPort),
+            ...(resolvedPort === undefined ? [] : ["--strict-port"]),
+            "--update-version",
+            String(this.#updateVersion),
+        ]);
+        let started = false;
+        const child = new ManagedChild(handle, (error) => {
+            if (!started || this.#child !== child)
+                return;
+            this.#foreground?.(false);
+            if (child.exited)
+                this.#child = undefined;
+            else
+                void this.stop(child);
+            this.#unexpectedExit?.(error);
+        }, this.shutdownTimings);
+        this.#child = child;
+        child.onMessage(bindTimings((message) => {
+            if (message &&
+                typeof message === "object" &&
+                "type" in message &&
+                message.type === "preview-resources" &&
+                this.#child === child) {
+                const observation = parsePreviewObservation(message);
+                if (observation?.generation === this.#runtime?.generation)
+                    this.#previewResources?.(observation);
+            }
+            if (message &&
+                typeof message === "object" &&
+                "type" in message &&
+                message.type === "foreground" &&
+                "active" in message &&
+                typeof message.active === "boolean" &&
+                this.#child === child)
+                this.#foreground?.(message.active);
+            if (message &&
+                typeof message === "object" &&
+                "type" in message &&
+                message.type === "component-runtime-startup-request" &&
+                runtime)
+                timeSync("child.send-startup", () => child.send({
+                    type: "component-runtime-startup",
+                    config: runtime.config,
+                    manifest: runtime.manifest,
+                }));
+            if (message &&
+                typeof message === "object" &&
+                "type" in message &&
+                message.type === "component-runtime-request" &&
+                runtime) {
+                this.#updateVersion++;
+                timeSync("child.send-runtime", () => child.send(componentRuntimeMessage(runtime, this.#updateVersion)));
+            }
+        }));
+        try {
+            const readyPort = await child.ready;
+            if (child.failure)
+                throw child.failure;
+            if (child.stopping || child.exited)
+                throw new MoklyError("server-failed", "server child stopped during startup");
+            this.#resolvedPort = readyPort;
+            started = true;
+            return readyPort;
+        }
+        catch (error) {
+            await this.stop(child);
+            throw error;
+        }
+    }
+    async restart() {
+        await this.close();
+        return this.start();
+    }
+    replaceComponentRuntime(runtime, delivery) {
+        this.#runtime = runtime;
+        if (delivery === "live")
+            this.#child?.send(componentRuntimeMessage(runtime));
+    }
+    notifyUpdate(changedRoutes, componentChanges, changesStatus, kind) {
+        const child = this.#child;
+        if (!child || child.stopping || child.exited)
+            return;
+        this.#updateVersion++;
+        child.send(childUpdateMessage(this.#updateVersion, changedRoutes, componentChanges, changesStatus, kind));
+    }
+    completeCatalogue(manifest, generation) {
+        if (this.#runtime?.generation !== generation ||
+            !this.#child ||
+            this.#child.stopping)
+            return;
+        this.#child.send({
+            type: "catalogue-complete",
+            manifest,
+            generation,
+            version: ++this.#updateVersion,
+        });
+    }
+    onForeground(callback) {
+        this.#foreground = callback;
+    }
+    onPreviewResources(callback) {
+        this.#previewResources = callback;
+    }
+    onUnexpectedExit(callback) {
+        this.#unexpectedExit = callback;
+    }
+    async close() {
+        if (this.#child)
+            await this.stop(this.#child);
+    }
+    async stop(child) {
+        await child.close();
+        if (this.#child === child) {
+            this.#child = undefined;
+            this.#foreground?.(false);
+        }
+    }
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/server/supervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.js","sourceRoot":"","sources":["../../src/server/supervisor.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAKlF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,YAAY,EAA6B,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAqB,MAAM,oBAAoB,CAAC;AAEzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EACL,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,uBAAuB,GAExB,MAAM,yBAAyB,CAAC;AAoCjC,6CAA6C;AAC7C,MAAM,OAAO,4BAA4B;IACvC,MAAM,CACJ,OAAe,EACf,aAAgC,EAChC,aAAqB;QAErB,OAAO,IAAI,sBAAsB,CAC/B,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAC7B,aAAa,EACb,aAAa,CACd,CAAC;IACJ,CAAC;CACF;AAED,6EAA6E;AAC7E,MAAM,OAAO,sBAAsB;IAUd;IACA;IACA;IACA;IAZnB,MAAM,CAA2B;IACjC,eAAe,CAAuC;IACtD,aAAa,CAAqB;IAClC,cAAc,GAAG,CAAC,CAAC;IACnB,QAAQ,CAA+B;IACvC,WAAW,CAA0C;IACrD,iBAAiB,CAA0D;IAE3E,YACmB,OAAqB,EACrB,aAAgC,EAChC,aAAqB,EACrB,eAAsC;QAHtC,YAAO,GAAP,OAAO,CAAc;QACrB,kBAAa,GAAb,aAAa,CAAmB;QAChC,kBAAa,GAAb,aAAa,CAAQ;QACrB,oBAAe,GAAf,eAAe,CAAuB;IACtD,CAAC;IAEJ,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM;YACb,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,iCAAiC,CAAC,CAAC;QAC3E,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;YAChC,GAAG,IAAI,CAAC,aAAa;YACrB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,QAAQ;YACR,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,aAAa,CAAC;YAC1C,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YACxD,kBAAkB;YAClB,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;SAC5B,CAAC,CAAC;QACH,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,YAAY,CAC5B,MAAM,EACN,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;gBAAE,OAAO;YAC9C,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,KAAK,CAAC,MAAM;gBAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;;gBACrC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,IAAI,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC,EACD,IAAI,CAAC,eAAe,CACrB,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,KAAK,CAAC,SAAS,CACb,WAAW,CAAC,CAAC,OAAgB,EAAE,EAAE;YAC/B,IACE,OAAO;gBACP,OAAO,OAAO,KAAK,QAAQ;gBAC3B,MAAM,IAAI,OAAO;gBACjB,OAAO,CAAC,IAAI,KAAK,mBAAmB;gBACpC,IAAI,CAAC,MAAM,KAAK,KAAK,EACrB,CAAC;gBACD,MAAM,WAAW,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;gBACrD,IAAI,WAAW,EAAE,UAAU,KAAK,IAAI,CAAC,QAAQ,EAAE,UAAU;oBACvD,IAAI,CAAC,iBAAiB,EAAE,CAAC,WAAY,CAAC,CAAC;YAC3C,CAAC;YACD,IACE,OAAO;gBACP,OAAO,OAAO,KAAK,QAAQ;gBAC3B,MAAM,IAAI,OAAO;gBACjB,OAAO,CAAC,IAAI,KAAK,YAAY;gBAC7B,QAAQ,IAAI,OAAO;gBACnB,OAAO,OAAO,CAAC,MAAM,KAAK,SAAS;gBACnC,IAAI,CAAC,MAAM,KAAK,KAAK;gBAErB,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACrC,IACE,OAAO;gBACP,OAAO,OAAO,KAAK,QAAQ;gBAC3B,MAAM,IAAI,OAAO;gBACjB,OAAO,CAAC,IAAI,KAAK,mCAAmC;gBACpD,OAAO;gBAEP,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAClC,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,2BAA2B;oBACjC,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;iBAC3B,CAAC,CACH,CAAC;YACJ,IACE,OAAO;gBACP,OAAO,OAAO,KAAK,QAAQ;gBAC3B,MAAM,IAAI,OAAO;gBACjB,OAAO,CAAC,IAAI,KAAK,2BAA2B;gBAC5C,OAAO,EACP,CAAC;gBACD,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAClC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAClE,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QACF,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC;YACpC,IAAI,KAAK,CAAC,OAAO;gBAAE,MAAM,KAAK,CAAC,OAAO,CAAC;YACvC,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM;gBAChC,MAAM,IAAI,UAAU,CAClB,eAAe,EACf,qCAAqC,CACtC,CAAC;YACJ,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YAC/B,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,uBAAuB,CACrB,OAAyB,EACzB,QAA0B;QAE1B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,QAAQ,KAAK,MAAM;YACrB,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,YAAY,CACV,aAA4C,EAC5C,gBAA0C,EAC1C,aAA6B,EAC7B,IAA0B;QAE1B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM;YAAE,OAAO;QACrD,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CACR,kBAAkB,CAChB,IAAI,CAAC,cAAc,EACnB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,IAAI,CACL,CACF,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,QAAoB,EAAE,UAAkB;QACxD,IACE,IAAI,CAAC,QAAQ,EAAE,UAAU,KAAK,UAAU;YACxC,CAAC,IAAI,CAAC,MAAM;YACZ,IAAI,CAAC,MAAM,CAAC,QAAQ;YAEpB,OAAO;QACT,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,oBAAoB;YAC1B,QAAQ;YACR,UAAU;YACV,OAAO,EAAE,EAAE,IAAI,CAAC,cAAc;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,YAAY,CAAC,QAAmC;QAC9C,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC;IAC9B,CAAC;IACD,kBAAkB,CAChB,QAAmD;QAEnD,IAAI,CAAC,iBAAiB,GAAG,QAAQ,CAAC;IACpC,CAAC;IAED,gBAAgB,CAAC,QAAgC;QAC/C,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,KAAmB;QACpC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

package/dist/server/update_messages.d.ts

@@ -0,0 +1,46 @@
+import type { RuntimeMessage, RuntimeStartupMessage } from "./controls/runtime_ipc.js";
+import type { ComponentChangeSnapshot } from "./component_changes.js";
+import type { ManifestV5 } from "../registry/types.js";
+/** Whether live change detection is running, complete, or could not finish. */
+export type ChangesStatus = "pending" | "ready" | "unavailable";
+/** Evidence updates retain the current rendered content and user interactions. */
+export type CatalogueUpdateKind = "content" | "evidence";
+/** Mutable running-server state published before clients refresh. */
+export interface CatalogueUpdate {
+    /** Defaults to content, requiring clients to refresh their rendered documents. */
+    kind?: CatalogueUpdateKind;
+    /** Omit to retain status unless the update replaces change evidence. */
+    changesStatus?: ChangesStatus;
+    /** Omit to retain state, use `null` when changed-route detection is unavailable. */
+    changedRoutes?: readonly string[] | null;
+    /** Omit to retain evidence, use `null` while fresh classification is unavailable. */
+    componentChanges?: ComponentChangeSnapshot | null;
+    /** Omit to allocate the next monotonically increasing update version. */
+    version?: number;
+}
+/** Parent-to-child update command with an explicit changed-route snapshot. */
+export interface ChildUpdateMessage {
+    kind?: CatalogueUpdateKind;
+    changesStatus?: ChangesStatus;
+    changedRoutes: readonly string[] | null;
+    componentChanges: ComponentChangeSnapshot | null;
+    type: "update";
+    version: number;
+}
+export interface CatalogueCompleteMessage {
+    type: "catalogue-complete";
+    manifest: ManifestV5;
+    generation: string;
+    version: number;
+}
+/** Validate the envelope here; the active server validates matching manifest contents. */
+export declare function parseCatalogueCompleteMessage(value: unknown): CatalogueCompleteMessage | undefined;
+/** Commands accepted by the watched server child. */
+export type ChildCommand = CatalogueCompleteMessage | ChildUpdateMessage | RuntimeMessage | RuntimeStartupMessage | {
+    type: "shutdown";
+};
+/** Create an immutable IPC update payload from the latest route computation. */
+export declare function childUpdateMessage(version: number, changedRoutes: readonly string[] | undefined, componentChanges?: ComponentChangeSnapshot, changesStatus?: ChangesStatus, kind?: CatalogueUpdateKind): ChildUpdateMessage;
+/** Parse an untrusted IPC value as one complete watched-server update. */
+export declare function parseChildUpdateMessage(value: unknown): ChildUpdateMessage | undefined;
+//# sourceMappingURL=update_messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update_messages.d.ts","sourceRoot":"","sources":["../../src/server/update_messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKvD,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAEhE,kFAAkF;AAClF,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzD,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,wEAAwE;IACxE,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,oFAAoF;IACpF,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACzC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAClD,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACxC,gBAAgB,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACjD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0FAA0F;AAC1F,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,wBAAwB,GAAG,SAAS,CAoBtC;AAED,qDAAqD;AACrD,MAAM,MAAM,YAAY,GACpB,wBAAwB,GACxB,kBAAkB,GAClB,cAAc,GACd,qBAAqB,GACrB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAC5C,gBAAgB,CAAC,EAAE,uBAAuB,EAC1C,aAAa,CAAC,EAAE,aAAa,EAC7B,IAAI,CAAC,EAAE,mBAAmB,GACzB,kBAAkB,CASpB;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,kBAAkB,GAAG,SAAS,CAsChC"}

package/dist/server/update_messages.js

@@ -0,0 +1,84 @@
+/** Typed watched-server updates crossing the parent/child IPC boundary. */
+import { isSafeCatalogueRoute } from "../config/paths.js";
+/** Validate the envelope here; the active server validates matching manifest contents. */
+export function parseCatalogueCompleteMessage(value) {
+    if (!value ||
+        typeof value !== "object" ||
+        !("type" in value) ||
+        value.type !== "catalogue-complete")
+        return;
+    const candidate = value;
+    if (typeof candidate.generation !== "string" ||
+        !/^[a-f0-9]{32}$/.test(candidate.generation) ||
+        !Number.isSafeInteger(candidate.version) ||
+        (candidate.version ?? 0) <= 0 ||
+        !candidate.manifest ||
+        typeof candidate.manifest !== "object" ||
+        candidate.manifest.schemaVersion !== 5)
+        return;
+    return candidate;
+}
+/** Create an immutable IPC update payload from the latest route computation. */
+export function childUpdateMessage(version, changedRoutes, componentChanges, changesStatus, kind) {
+    return {
+        ...(kind ? { kind } : {}),
+        ...(changesStatus ? { changesStatus } : {}),
+        changedRoutes: changedRoutes ? [...changedRoutes] : null,
+        componentChanges: componentChanges ?? null,
+        type: "update",
+        version,
+    };
+}
+/** Parse an untrusted IPC value as one complete watched-server update. */
+export function parseChildUpdateMessage(value) {
+    if (typeof value !== "object" ||
+        value === null ||
+        value.type !== "update") {
+        return undefined;
+    }
+    const candidate = value;
+    if (!Number.isSafeInteger(candidate.version) ||
+        candidate.version <= 0 ||
+        !isChangedRoutes(candidate.changedRoutes) ||
+        !isComponentChanges(candidate.componentChanges) ||
+        (candidate.kind !== undefined &&
+            candidate.kind !== "content" &&
+            candidate.kind !== "evidence") ||
+        (candidate.changesStatus !== undefined &&
+            !isChangesStatus(candidate.changesStatus))) {
+        return undefined;
+    }
+    return {
+        ...(candidate.kind ? { kind: candidate.kind } : {}),
+        ...(candidate.changesStatus
+            ? { changesStatus: candidate.changesStatus }
+            : {}),
+        changedRoutes: candidate.changedRoutes,
+        componentChanges: candidate.componentChanges,
+        type: "update",
+        version: candidate.version,
+    };
+}
+function isChangesStatus(value) {
+    return value === "pending" || value === "ready" || value === "unavailable";
+}
+function isComponentChanges(value) {
+    if (value === null)
+        return true;
+    if (typeof value !== "object" || value === null || !("baseline" in value))
+        return false;
+    const snapshot = value;
+    return (typeof snapshot.baseline === "object" &&
+        snapshot.baseline !== null &&
+        (snapshot.changedRoutes === undefined ||
+            (isChangedRoutes(snapshot.changedRoutes) &&
+                snapshot.changedRoutes !== null)) &&
+        (snapshot.result === undefined ||
+            (typeof snapshot.result === "object" && snapshot.result !== null)));
+}
+function isChangedRoutes(value) {
+    return (value === null ||
+        (Array.isArray(value) &&
+            value.every((route) => typeof route === "string" && isSafeCatalogueRoute(route))));
+}
+//# sourceMappingURL=update_messages.js.map

package/dist/server/update_messages.js.map

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

package/dist/server/versioned_document.d.ts

@@ -0,0 +1,4 @@
+/** Update-version stamping for served HTML documents. */
+/** Set the server snapshot version on one complete HTML document. */
+export declare function stampDocumentUpdateVersion(document: string, updateVersion: number): string;
+//# sourceMappingURL=versioned_document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"versioned_document.d.ts","sourceRoot":"","sources":["../../src/server/versioned_document.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAMzD,qEAAqE;AACrE,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,MAAM,CAOR"}

package/dist/server/versioned_document.js

@@ -0,0 +1,13 @@
+/** Update-version stamping for served HTML documents. */
+const HTML_ELEMENT = /<html(?=[\s>])[^>]*>/i;
+const UPDATE_VERSION_ATTRIBUTE = /\sdata-mokly-update-version=(?:"[^"]*"|'[^']*'|[^\s>]*)/i;
+/** Set the server snapshot version on one complete HTML document. */
+export function stampDocumentUpdateVersion(document, updateVersion) {
+    return document.replace(HTML_ELEMENT, (element) => {
+        const attribute = ` data-mokly-update-version="${updateVersion}"`;
+        if (UPDATE_VERSION_ATTRIBUTE.test(element))
+            return element.replace(UPDATE_VERSION_ATTRIBUTE, attribute);
+        return element.replace(/^<html/i, `<html${attribute}`);
+    });
+}
+//# sourceMappingURL=versioned_document.js.map

package/dist/server/versioned_document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioned_document.js","sourceRoot":"","sources":["../../src/server/versioned_document.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAC7C,MAAM,wBAAwB,GAC5B,0DAA0D,CAAC;AAE7D,qEAAqE;AACrE,MAAM,UAAU,0BAA0B,CACxC,QAAgB,EAChB,aAAqB;IAErB,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE;QAChD,MAAM,SAAS,GAAG,+BAA+B,aAAa,GAAG,CAAC;QAClE,IAAI,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC;YACxC,OAAO,OAAO,CAAC,OAAO,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;QAC9D,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server/view_routes.d.ts

@@ -0,0 +1,8 @@
+import type { ServerResponse } from "node:http";
+import type { ResolvedConfig } from "../config/types.js";
+import type { Catalogue } from "./catalogue.js";
+import type { ShellContext } from "./shell/context.js";
+import type { DocumentService } from "./demand/service.js";
+export declare function redirectId(response: ServerResponse, url: URL, encodedId: string, catalogue: Catalogue, config: ResolvedConfig, context: ShellContext, method: string, documents?: DocumentService): Promise<void>;
+export declare function renderView(response: ServerResponse, url: URL, encodedRoute: string, catalogue: Catalogue, config: ResolvedConfig, context: ShellContext, method: string, documents?: DocumentService): Promise<void>;
+//# sourceMappingURL=view_routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view_routes.d.ts","sourceRoot":"","sources":["../../src/server/view_routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,GAAG,EACR,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/server/view_routes.js

@@ -0,0 +1,44 @@
+import { encodeUrlPath } from "../config/paths.js";
+import { requestedFragment, withFragmentQuery } from "./fragments.js";
+import { notFoundPage, viewPage } from "./pages.js";
+import { safeDecode, safeDecodePath, send } from "./respond.js";
+export async function redirectId(response, url, encodedId, catalogue, config, context, method, documents) {
+    const entry = catalogue.byId.get(safeDecode(encodedId));
+    if (!entry || entry.kind === "collection")
+        return send(response, 404, "text/html", notFoundPage(encodedId, catalogue, context), method);
+    const fragment = await requestedFragment(url, entry, catalogue, config, documents);
+    if (fragment === null) {
+        return send(response, 400, "text/plain", "Invalid fragment query", method);
+    }
+    response.writeHead(302, {
+        location: withFragmentQuery(`/view/${encodeUrlPath(entry.route)}`, fragment),
+    });
+    response.end();
+}
+export async function renderView(response, url, encodedRoute, catalogue, config, context, method, documents) {
+    const route = safeDecodePath(encodedRoute);
+    const entry = route
+        ? (catalogue.byRoute.get(route) ??
+            catalogue.removedEntries.find(({ entry }) => entry.route === route)
+                ?.entry)
+        : undefined;
+    if (!entry)
+        return send(response, 404, "text/html", notFoundPage(encodedRoute, catalogue, context), method);
+    const manifestEntry = "kind" in entry ? entry : undefined;
+    const removed = catalogue.removedEntries.some(({ entry }) => entry.route === route);
+    const fragment = removed
+        ? url.searchParams.has("fragment")
+            ? null
+            : undefined
+        : await requestedFragment(url, manifestEntry, catalogue, config, documents);
+    if (fragment === null) {
+        return send(response, 400, "text/plain", "Invalid fragment query", method);
+    }
+    const viewContext = {
+        ...context,
+        ...(route ? { activeRoute: route } : {}),
+        ...(fragment ? { fragment } : {}),
+    };
+    return send(response, 200, "text/html", viewPage(entry, catalogue, viewContext), method);
+}
+//# sourceMappingURL=view_routes.js.map

package/dist/server/view_routes.js.map

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

package/dist/server/watch_classification.d.ts

@@ -0,0 +1,18 @@
+/** Latest-wins repository classification for a watched catalogue. */
+import type { ResolvedConfig } from "../config/types.js";
+import type { Manifest } from "../registry/types.js";
+import type { CatalogueChangeClassifier, ComponentChangeSnapshot } from "./component_changes.js";
+/** Own cancellation and publication ordering for background Changes evidence. */
+export declare class WatchClassification {
+    private readonly classifier;
+    private readonly publish;
+    private active;
+    private closed;
+    private sequence;
+    constructor(classifier: CatalogueChangeClassifier, publish: (snapshot: ComponentChangeSnapshot) => void);
+    /** Replace any active calculation with the current immutable generation. */
+    schedule(config: ResolvedConfig, manifest: Manifest, base: string): void;
+    /** Prevent publication and abort any Git subprocess still in flight. */
+    close(): void;
+}
+//# sourceMappingURL=watch_classification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch_classification.d.ts","sourceRoot":"","sources":["../../src/server/watch_classification.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAGrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EACV,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAEhC,iFAAiF;AACjF,qBAAa,mBAAmB;IAM5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAK;gBAGF,UAAU,EAAE,yBAAyB,EACrC,OAAO,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,IAAI;IAGvE,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAsBxE,wEAAwE;IACxE,KAAK,IAAI,IAAI;CAOd"}

package/dist/server/watch_classification.js

@@ -0,0 +1,47 @@
+/** Latest-wins repository classification for a watched catalogue. */
+import { timeAsync, timingCounts } from "../diagnostics/timings.js";
+/** Own cancellation and publication ordering for background Changes evidence. */
+export class WatchClassification {
+    classifier;
+    publish;
+    active;
+    closed = false;
+    sequence = 0;
+    constructor(classifier, publish) {
+        this.classifier = classifier;
+        this.publish = publish;
+    }
+    /** Replace any active calculation with the current immutable generation. */
+    schedule(config, manifest, base) {
+        if (this.closed)
+            return;
+        this.active?.abort();
+        const controller = new AbortController();
+        this.active = controller;
+        const sequence = ++this.sequence;
+        void timeAsync("changes.classify", () => this.classifier.read(config, manifest, base, controller.signal))
+            .then((snapshot) => {
+            if (this.closed || sequence !== this.sequence || !snapshot)
+                return;
+            timingCounts("changes.publish", () => ({
+                changedRoutes: snapshot.changedRoutes?.length ?? 0,
+            }));
+            this.publish(snapshot);
+        })
+            .catch(() => undefined)
+            .finally(() => {
+            if (this.active === controller)
+                this.active = undefined;
+        });
+    }
+    /** Prevent publication and abort any Git subprocess still in flight. */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.sequence += 1;
+        this.active?.abort();
+        this.active = undefined;
+    }
+}
+//# sourceMappingURL=watch_classification.js.map

package/dist/server/watch_classification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch_classification.js","sourceRoot":"","sources":["../../src/server/watch_classification.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAQpE,iFAAiF;AACjF,MAAM,OAAO,mBAAmB;IAMX;IACA;IANX,MAAM,CAA8B;IACpC,MAAM,GAAG,KAAK,CAAC;IACf,QAAQ,GAAG,CAAC,CAAC;IAErB,YACmB,UAAqC,EACrC,OAAoD;QADpD,eAAU,GAAV,UAAU,CAA2B;QACrC,YAAO,GAAP,OAAO,CAA6C;IACpE,CAAC;IAEJ,4EAA4E;IAC5E,QAAQ,CAAC,MAAsB,EAAE,QAAkB,EAAE,IAAY;QAC/D,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QACzB,MAAM,QAAQ,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC;QACjC,KAAK,SAAS,CAAC,kBAAkB,EAAE,GAAG,EAAE,CACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAChE;aACE,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACjB,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,KAAK,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACnE,YAAY,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;gBACrC,aAAa,EAAE,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;aACnD,CAAC,CAAC,CAAC;YACJ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;aACtB,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU;gBAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAC1D,CAAC,CAAC,CAAC;IACP,CAAC;IAED,wEAAwE;IACxE,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACnB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;CACF"}

package/dist/server/watch_events.d.ts

@@ -0,0 +1,54 @@
+import type { ResolvedConfig, WatchAction } from "../config/types.js";
+/** Internal watch work, including package-owned configuration reloads. */
+export type RuntimeWatchAction = "reconfigure" | "evidence" | WatchAction;
+/** Buffer notifications until startup is ready to process them. */
+export declare class NotificationGate<Value> {
+    #private;
+    /** Queue or immediately deliver one notification. */
+    notify(value: Value): void;
+    /** Open the gate and flush startup notifications in arrival order. */
+    open(consumer: (value: Value) => void): void;
+}
+/** Minimal clock seam for deterministic debounce tests. */
+export interface DebounceClock {
+    clear(handle: ReturnType<typeof setTimeout>): void;
+    schedule(callback: () => void, milliseconds: number): ReturnType<typeof setTimeout>;
+}
+/** Runtime clock backed by Node timers. */
+export declare const systemDebounceClock: DebounceClock;
+/** Coalesce filesystem notifications into one highest-impact action. */
+export declare class WatchDebouncer {
+    #private;
+    private readonly delay;
+    private readonly callback;
+    private readonly clock;
+    constructor(delay: number, callback: (action: RuntimeWatchAction) => void, clock?: DebounceClock);
+    /** Add one classified notification to the current burst. */
+    notify(action: RuntimeWatchAction): void;
+    /** Cancel pending work. */
+    close(): void;
+    private flush;
+}
+/** Serialize watch work and coalesce changes received during active work. */
+export declare class WatchActionQueue {
+    #private;
+    private readonly process;
+    private readonly reportError;
+    constructor(process: (action: RuntimeWatchAction) => Promise<void>, reportError: (error: unknown) => void);
+    /** Queue one action; a stronger pending action subsumes weaker actions. */
+    notify(action: RuntimeWatchAction): void;
+    /** Wait until all currently queued work has completed. */
+    settled(): Promise<void>;
+    /** Discard pending work and wait for the active operation to finish. */
+    close(): Promise<void>;
+    private drain;
+}
+/** Classify one consumer path using configured inputs and reachable resources. */
+export declare function classifyWatchPath(candidate: string, config: ResolvedConfig, resources?: ReadonlySet<string>): RuntimeWatchAction;
+/** Return whether package-owned output should be pruned from a broad watch. */
+export declare function isPackageOwnedIgnoredWatchPath(candidate: string, config: ResolvedConfig, mode?: "traverse" | "event"): boolean;
+/** Resolve the finite roots/globs watched for this consumer. */
+export declare function watchTargets(config: ResolvedConfig): string[];
+/** Configured stylesheet roots whose imports are also consumer resources. */
+export declare function configuredStylesheetPaths(config: ResolvedConfig): string[];
+//# sourceMappingURL=watch_events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch_events.d.ts","sourceRoot":"","sources":["../../src/server/watch_events.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgBtE,0EAA0E;AAC1E,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,CAAC;AAE1E,mEAAmE;AACnE,qBAAa,gBAAgB,CAAC,KAAK;;IAIjC,qDAAqD;IACrD,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAK1B,sEAAsE;IACtE,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;CAI7C;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IACnD,QAAQ,CACN,QAAQ,EAAE,MAAM,IAAI,EACpB,YAAY,EAAE,MAAM,GACnB,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CAClC;AAED,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB,EAAE,aAGjC,CAAC;AAWF,wEAAwE;AACxE,qBAAa,cAAc;;IAKvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFL,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,EAC9C,KAAK,GAAE,aAAmC;IAG7D,4DAA4D;IAC5D,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAMxC,2BAA2B;IAC3B,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,KAAK;CAQd;AAED,6EAA6E;AAC7E,qBAAa,gBAAgB;;IAMzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,OAAO,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,EACtD,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAGxD,2EAA2E;IAC3E,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAMxC,0DAA0D;IACpD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAMd,KAAK;CAqBpB;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,EACtB,SAAS,GAAE,WAAW,CAAC,MAAM,CAAa,GACzC,kBAAkB,CAqCpB;AAED,+EAA+E;AAC/E,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,UAAU,GAAG,OAAoB,GACtC,OAAO,CAaT;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAkB7D;AAwCD,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAM1E"}