@nifrajs/web 5.5.1 → 5.6.0

package/dist/internal/island-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"island-resource.d.ts","sourceRoot":"","sources":["../../src/internal/island-resource.ts"],"names":[],"mappings":"AAGA,iGAAiG;AACjG,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACpF;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAEpF,mEAAmE;AACnE,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IACxB,IAAI,aAAa,CAAC,CAAC,CAAC,CAAA;IACpB,2DAA2D;IAC3D,OAAO,IAAI,IAAI,CAAA;IACf,8EAA8E;IAC9E,OAAO,IAAI,IAAI,CAAA;CAChB,CAAA;AAID;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,MAAM,EAAE,MAAM,CAAC,EACf,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAClD,QAAQ,CAAC,CAAC,CAAC,CA8Cb"}

package/dist/internal/island-resource.js

@@ -0,0 +1,57 @@
+import { adopt } from "./island-owner.js";
+import { effect, signal, untrack } from "./island-signals.js";
+const PENDING = { status: "pending", value: undefined, error: undefined };
+/**
+ * An async value keyed by `source`. `source` runs tracked, so a write to any signal it reads starts a
+ * new fetch; `fetcher` runs untracked with that key, so nothing it reads (before or after an `await`)
+ * is a dependency. A newer fetch aborts the older one and only the newest result lands. Inside an
+ * island, unmounting disposes it: the request in flight is aborted and its late result dropped.
+ */
+export function resource(source, fetcher) {
+    const state = signal(PENDING);
+    let generation = 0;
+    let live = true;
+    let controller;
+    let key;
+    const run = () => {
+        const mine = ++generation;
+        controller?.abort();
+        const active = new AbortController();
+        controller = active;
+        state.set(PENDING);
+        let pending;
+        try {
+            pending = fetcher(key, active.signal);
+        }
+        catch (error) {
+            pending = Promise.reject(error);
+        }
+        pending.then((value) => {
+            if (mine === generation)
+                state.set({ status: "ready", value, error: undefined });
+        }, (error) => {
+            // A superseded or aborted fetch is not an error the reader should see.
+            if (mine === generation && !active.signal.aborted)
+                state.set({ status: "error", value: undefined, error });
+        });
+    };
+    const stop = effect(() => {
+        key = source();
+        untrack(run);
+    });
+    // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: `refetch` and `dispose` are assigned below
+    const read = (() => state());
+    read.refetch = () => {
+        if (live)
+            untrack(run);
+    };
+    read.dispose = () => {
+        live = false;
+        stop();
+        generation++;
+        controller?.abort();
+    };
+    adopt(read.dispose);
+    return read;
+}
+//# sourceMappingURL=island-resource.js.map

package/dist/internal/island-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"island-resource.js","sourceRoot":"","sources":["../../src/internal/island-resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAiB7D,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAW,CAAA;AAElF;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAe,EACf,OAAmD;IAEnD,MAAM,KAAK,GAAG,MAAM,CAAmB,OAAO,CAAC,CAAA;IAC/C,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,IAAI,GAAG,IAAI,CAAA;IACf,IAAI,UAAuC,CAAA;IAC3C,IAAI,GAAM,CAAA;IACV,MAAM,GAAG,GAAG,GAAS,EAAE;QACrB,MAAM,IAAI,GAAG,EAAE,UAAU,CAAA;QACzB,UAAU,EAAE,KAAK,EAAE,CAAA;QACnB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QACpC,UAAU,GAAG,MAAM,CAAA;QACnB,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAClB,IAAI,OAAmB,CAAA;QACvB,IAAI,CAAC;YACH,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACjC,CAAC;QACD,OAAO,CAAC,IAAI,CACV,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,IAAI,KAAK,UAAU;gBAAE,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;QAClF,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,uEAAuE;YACvE,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO;gBAC/C,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;QAC3D,CAAC,CACF,CAAA;IACH,CAAC,CAAA;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE;QACvB,GAAG,GAAG,MAAM,EAAE,CAAA;QACd,OAAO,CAAC,GAAG,CAAC,CAAA;IACd,CAAC,CAAC,CAAA;IACF,4GAA4G;IAC5G,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAgB,CAAA;IAC3C,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE;QAClB,IAAI,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC,CAAA;IACD,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE;QAClB,IAAI,GAAG,KAAK,CAAA;QACZ,IAAI,EAAE,CAAA;QACN,UAAU,EAAE,CAAA;QACZ,UAAU,EAAE,KAAK,EAAE,CAAA;IACrB,CAAC,CAAA;IACD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACnB,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/internal/island-signals.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Fine-grained signals - the reactive core of `@nifrajs/web/islands`. Pull-based auto-tracking with
+ * per-run re-tracking (a branch switch drops the stale branch's subscriptions), `Object.is`
+ * equality skips, and an explicit synchronous {@link batch} that coalesces effect re-runs.
+ *
+ * Deliberately tiny and synchronous: a write recomputes the computeds it feeds at once and runs its
+ * effects before `set` returns, each once, after every computed has settled - predictable for
+ * island-scale code (a counter, a filter drawer), and the whole core stays well under a kilobyte.
+ * This is NOT a general app framework - just island-scale reactivity.
+ */
+/** Run `fn` without subscribing the running effect or computed to the signals it reads. */
+export declare function untrack<T>(fn: () => T): T;
+/** A readable/writable reactive value: call it to read (tracking), `.set` to write. */
+export type Signal<T> = {
+    (): T;
+    set(next: T | ((prev: T) => T)): void;
+};
+/**
+ * Batch writes: effects triggered inside `fn` run ONCE after it returns, deduplicated - so
+ * `setA(); setB()` updates the DOM once, not twice. Re-entrant; an effect re-queued during the
+ * flush runs in the same flush.
+ */
+export declare function batch<T>(fn: () => T): T;
+/** Create a signal. Reads inside an {@link effect} (or {@link computed}) subscribe automatically. */
+export declare function signal<T>(initial: T): Signal<T>;
+/**
+ * Call `fn` with `source`'s value now and after each change, queued and batched like an effect but
+ * subscribed once instead of tracking reads. Any other getter (a computed, a derived function) is
+ * tracked as an effect. Either way `fn` runs untracked. Internal to the binding walker, whose bindings each read one named signal,
+ * and to `bindList`; not exported from `@nifrajs/web/islands`.
+ */
+export declare function watch<T>(source: () => T, fn: (value: T) => void): () => void;
+/** A derived value: call it to read (tracking), `.dispose()` to stop recomputing it. */
+export type Computed<T> = {
+    (): T;
+    dispose(): void;
+};
+/**
+ * Derived value, cached into a signal and computed on first read. While an effect (or another
+ * computed) reads it, it recomputes when its tracked inputs change. Once nothing reads it, the next
+ * input change stops it instead of recomputing, so a dropped computed costs nothing; reading it
+ * again starts it afresh. `dispose()` stops it at once.
+ */
+export declare function computed<T>(fn: () => T): Computed<T>;
+/**
+ * Run `fn` now and again whenever any signal it read changes. Returns a disposer. Dependencies
+ * re-track on every run, so conditional reads subscribe to exactly the live branch. Every run,
+ * the first included, finishes before the effects its writes trigger run, itself among them.
+ */
+export declare function effect(fn: () => void): () => void;
+//# sourceMappingURL=island-signals.d.ts.map

package/dist/internal/island-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"island-signals.d.ts","sourceRoot":"","sources":["../../src/internal/island-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqBH,2FAA2F;AAC3F,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQzC;AAKD,uFAAuF;AACvF,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IACtB,IAAI,CAAC,CAAA;IACL,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAA;CACtC,CAAA;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAOvC;AAyBD,qGAAqG;AACrG,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAK/C;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CA6B5E;AA0CD,wFAAwF;AACxF,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IACxB,IAAI,CAAC,CAAA;IACL,OAAO,IAAI,IAAI,CAAA;CAChB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAmBpD;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA"}

package/dist/internal/island-signals.js

@@ -0,0 +1,220 @@
+/**
+ * Fine-grained signals - the reactive core of `@nifrajs/web/islands`. Pull-based auto-tracking with
+ * per-run re-tracking (a branch switch drops the stale branch's subscriptions), `Object.is`
+ * equality skips, and an explicit synchronous {@link batch} that coalesces effect re-runs.
+ *
+ * Deliberately tiny and synchronous: a write recomputes the computeds it feeds at once and runs its
+ * effects before `set` returns, each once, after every computed has settled - predictable for
+ * island-scale code (a counter, a filter drawer), and the whole core stays well under a kilobyte.
+ * This is NOT a general app framework - just island-scale reactivity.
+ */
+import { adopt } from "./island-owner.js";
+let currentEffect;
+/** Run `fn` without subscribing the running effect or computed to the signals it reads. */
+export function untrack(fn) {
+    const prev = currentEffect;
+    currentEffect = undefined;
+    try {
+        return fn();
+    }
+    finally {
+        currentEffect = prev;
+    }
+}
+let batchDepth = 0;
+const queue = [];
+/**
+ * Batch writes: effects triggered inside `fn` run ONCE after it returns, deduplicated - so
+ * `setA(); setB()` updates the DOM once, not twice. Re-entrant; an effect re-queued during the
+ * flush runs in the same flush.
+ */
+export function batch(fn) {
+    batchDepth++;
+    try {
+        return fn();
+    }
+    finally {
+        flush();
+    }
+}
+// Closes one batch level; the outermost runs the queue.
+function flush() {
+    let i = 0;
+    try {
+        // The flush still counts as a batch: a write an effect makes here queues, so none runs twice.
+        while (batchDepth === 1 && i < queue.length) {
+            const next = queue[i++];
+            if (next?.q) {
+                next.q = false;
+                next.run();
+            }
+        }
+    }
+    finally {
+        // A throwing effect leaves the rest queued for the next flush.
+        if (i === queue.length)
+            queue.length = 0;
+        else
+            queue.splice(0, i);
+        batchDepth--;
+    }
+}
+// Each plain signal's reader set, so `watch` can subscribe without tracking.
+const readers = new WeakMap();
+/** Create a signal. Reads inside an {@link effect} (or {@link computed}) subscribe automatically. */
+export function signal(initial) {
+    const subs = new Set();
+    const s = readable(initial, subs);
+    readers.set(s, subs);
+    return s;
+}
+/**
+ * Call `fn` with `source`'s value now and after each change, queued and batched like an effect but
+ * subscribed once instead of tracking reads. Any other getter (a computed, a derived function) is
+ * tracked as an effect. Either way `fn` runs untracked. Internal to the binding walker, whose bindings each read one named signal,
+ * and to `bindList`; not exported from `@nifrajs/web/islands`.
+ */
+export function watch(source, fn) {
+    const subs = readers.get(source);
+    if (!subs)
+        return effect(() => {
+            const value = source();
+            untrack(() => fn(value));
+        });
+    const e = {
+        deps: new Map([[subs, 0]]),
+        v: 0,
+        n: 1,
+        run: () => {
+            const prev = currentEffect;
+            currentEffect = undefined;
+            try {
+                fn(source());
+            }
+            finally {
+                currentEffect = prev;
+            }
+        },
+    };
+    const stop = () => {
+        subs.delete(e);
+        e.q = false;
+    };
+    subs.add(e);
+    adopt(stop);
+    batch(e.run);
+    return stop;
+}
+// A signal whose readers are `subs`, so a computed can see whether anything still reads it.
+function readable(initial, subs) {
+    let value = initial;
+    // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: `set` is assigned below, before the signal is returned
+    const read = (() => {
+        const e = currentEffect;
+        if (e) {
+            const seen = e.deps.get(subs);
+            if (seen !== e.v) {
+                if (seen === undefined)
+                    subs.add(e);
+                e.deps.set(subs, e.v);
+                e.n++;
+            }
+        }
+        return value;
+    });
+    read.set = (next) => {
+        // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: a function passed to `set` is always the updater form
+        const resolved = typeof next === "function" ? next(value) : next;
+        if (Object.is(resolved, value))
+            return;
+        value = resolved;
+        // Snapshot: an effect created while this write flushes must not run in it.
+        batchDepth++;
+        try {
+            for (const e of [...subs]) {
+                // A running effect is requeued only by a source its current run has already read.
+                if (e.r && e.deps.get(subs) !== e.v)
+                    continue;
+                if (e.c)
+                    e.run();
+                else if (!e.q) {
+                    e.q = true;
+                    queue.push(e);
+                }
+            }
+        }
+        finally {
+            flush();
+        }
+    };
+    return read;
+}
+/**
+ * Derived value, cached into a signal and computed on first read. While an effect (or another
+ * computed) reads it, it recomputes when its tracked inputs change. Once nothing reads it, the next
+ * input change stops it instead of recomputing, so a dropped computed costs nothing; reading it
+ * again starts it afresh. `dispose()` stops it at once.
+ */
+export function computed(fn) {
+    const subs = new Set();
+    // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: the first read computes it before returning
+    const out = readable(undefined, subs);
+    let stop;
+    // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: `dispose` is assigned below
+    const read = (() => {
+        // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: the implementation takes the computed flag its public overload hides
+        stop ??= effect(() => {
+            if (!stop || subs.size)
+                out.set(fn());
+            else
+                read.dispose();
+        }, true);
+        return out();
+    });
+    read.dispose = () => {
+        stop?.();
+        stop = undefined;
+    };
+    return read;
+}
+export function effect(fn, c) {
+    const stop = () => {
+        for (const subs of e.deps.keys())
+            subs.delete(e);
+        e.deps.clear();
+        e.q = false;
+    };
+    const e = {
+        c,
+        deps: new Map(),
+        v: 0,
+        n: 0,
+        // Subscriptions persist across runs; a source this run did not read is dropped afterwards.
+        run: () => {
+            ++e.v;
+            e.n = 0;
+            e.q = false;
+            e.r = true;
+            const prev = currentEffect;
+            currentEffect = e;
+            try {
+                fn();
+            }
+            finally {
+                currentEffect = prev;
+                e.r = false;
+                if (e.n < e.deps.size)
+                    for (const [subs, seen] of e.deps)
+                        if (seen !== e.v) {
+                            subs.delete(e);
+                            e.deps.delete(subs);
+                        }
+            }
+        },
+    };
+    adopt(stop);
+    // Batched, so a write in the first run cannot re-enter it before it finishes.
+    batch(e.run);
+    return stop;
+}
+//# sourceMappingURL=island-signals.js.map

package/dist/internal/island-signals.js.map

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

package/dist/internal/keep-alive-table.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Where the slot wrappers of kept pages go, decided once from the route table so that the server's
+ * markup and every client render agree: a wrapper that appeared or vanished with what is kept would
+ * remount the page inside it, and one the server did not render fails hydration.
+ */
+import type { Manifest } from "../manifest.js";
+/** What the server and the browser both read to place the slot wrappers. */
+export interface KeepAliveTable {
+    /** Routes whose page renders inside the slot wrappers: the build found a `keepAlive` export. */
+    readonly routes: readonly string[];
+    /** Layouts rendered inside the slot wrappers, because another chain the browser can render shares
+     * the layouts above one of them and not that one: a kept page then sits there beside the page on
+     * screen. A layout every chain shares is never wrapped. */
+    readonly layouts: readonly string[];
+}
+/** The table for `manifest`, or `undefined` when no route keeps its page alive. */
+export declare function keepAliveTable(manifest: Manifest): KeepAliveTable | undefined;
+/**
+ * The chain indices to render inside slot wrappers for a chain of `layoutIds` and then the page of
+ * `routeId`: each wrapped layout, and the page when its route keeps alive.
+ */
+export declare function slotDepths(table: KeepAliveTable, layoutIds: readonly string[], routeId: string | undefined): readonly number[];
+//# sourceMappingURL=keep-alive-table.d.ts.map

package/dist/internal/keep-alive-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-alive-table.d.ts","sourceRoot":"","sources":["../../src/internal/keep-alive-table.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,gGAAgG;IAChG,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC;;+DAE2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAOD,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CA+B7E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,SAAS,MAAM,EAAE,CAOnB"}

package/dist/internal/keep-alive-table.js

@@ -0,0 +1,53 @@
+const sharesAbove = (a, b, depth) => {
+    for (let i = 0; i < depth; i++)
+        if (a[i] !== b[i])
+            return false;
+    return true;
+};
+/** The table for `manifest`, or `undefined` when no route keeps its page alive. */
+export function keepAliveTable(manifest) {
+    const kept = manifest.routes.filter((route) => route.keepAlive === true);
+    if (kept.length === 0)
+        return undefined;
+    // Every layout chain the browser renders: each route's, a root status page's (inside the root
+    // layout unless the page opts out, which only its module says), and a `_loading` page's, which takes
+    // the layouts the two pages of a navigation share, so any prefix of a route under it.
+    const chains = manifest.routes.map((route) => route.layoutIds);
+    if (manifest.notFound !== undefined || Object.keys(manifest.statusPages ?? {}).length > 0) {
+        chains.push(manifest.layouts._layout === undefined ? [] : ["_layout"]);
+    }
+    for (const [id, loading] of Object.entries(manifest.loadings ?? {})) {
+        for (const route of manifest.routes) {
+            if (!route.loadingIds?.includes(id))
+                continue;
+            for (let n = loading.layoutIds.length; n <= route.layoutIds.length; n++) {
+                chains.push(route.layoutIds.slice(0, n));
+            }
+        }
+    }
+    const layouts = new Set();
+    for (const route of kept) {
+        route.layoutIds.forEach((layout, depth) => {
+            if (layouts.has(layout))
+                return;
+            if (chains.some((chain) => chain[depth] !== layout && sharesAbove(chain, route.layoutIds, depth)))
+                layouts.add(layout);
+        });
+    }
+    return { routes: [...new Set(kept.map((route) => route.id))], layouts: [...layouts] };
+}
+/**
+ * The chain indices to render inside slot wrappers for a chain of `layoutIds` and then the page of
+ * `routeId`: each wrapped layout, and the page when its route keeps alive.
+ */
+export function slotDepths(table, layoutIds, routeId) {
+    const depths = [];
+    layoutIds.forEach((layout, depth) => {
+        if (table.layouts.includes(layout))
+            depths.push(depth);
+    });
+    if (routeId !== undefined && table.routes.includes(routeId))
+        depths.push(layoutIds.length);
+    return depths;
+}
+//# sourceMappingURL=keep-alive-table.js.map

package/dist/internal/keep-alive-table.js.map

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

package/dist/internal/live-contract.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The seam between page execution and a configured live runtime (`@nifrajs/web/live`): types and one
+ * symbol. An app without `live` imports nothing from the live module itself.
+ */
+import type { IdentityPlugin, WebSocketHandler } from "@nifrajs/core/server";
+import type { LoaderContext } from "../manifest.js";
+import type { LiveClientEntry } from "./codegen.js";
+/** What `createWebApp` tells the runtime about its routes. */
+export interface LiveRouteMatch {
+    readonly routeId: string;
+    readonly layoutIds: readonly string[];
+}
+/** The app the live socket registers on. */
+export interface LiveHostApp {
+    use(plugin: IdentityPlugin): unknown;
+    ws<Data>(path: string, handler: WebSocketHandler<Data>): unknown;
+    publish(topic: string, data: string): void;
+}
+export interface LiveAttachInput {
+    /** The route a canonical `pathname + search` renders, or `null`. */
+    readonly matchRoute: (path: string) => LiveRouteMatch | null;
+    readonly app: LiveHostApp;
+}
+export interface LiveAttachment {
+    /** Admission and dispatch for the live load endpoint; `undefined` for every other request. */
+    readonly onRequest: (req: Request) => Promise<Request | Response> | undefined;
+    /** The live load a page request belongs to, or `undefined` for every request that is not one. */
+    readonly loadOf: (req: Request) => LiveLoad | undefined;
+}
+/** One live load, from the page handler's side. */
+export interface LiveLoad {
+    /** The route the endpoint mapped the retain list against. */
+    readonly routeId: string;
+    /** `undefined` when admitted; else the 503 to answer with. An admitted load is released once. */
+    admit(): Response | undefined;
+    /** Release the admission slot once the response is complete: at once, or when its stream ends. */
+    settle(response: Response): Response;
+    release(): void;
+    /**
+     * After middleware: resolve the viewer's subject. `false` when the presented grant's retention no
+     * longer applies (another subject), so every owner loads fresh.
+     */
+    bind(ctx: LoaderContext): Promise<boolean>;
+    /** Skip the page loader: the page owner is retained. Read after {@link bind}. */
+    readonly retainPage: boolean;
+    /** `ctx.live` for one owner. */
+    collector(owner: string): (...keys: string[]) => void;
+    /** Close an owner's collector once its loader has settled. */
+    seal(owner: string): void;
+    /** The envelope's `live` member, built after every loader settled without a throw or status. */
+    finish(input: LiveFinish): Promise<LiveEnvelope>;
+}
+export interface LiveFinish {
+    /** Owners whose loaders ran and resolved. */
+    readonly fresh: readonly string[];
+    /** Owners whose loaders were skipped: their keys come from the presented grant. */
+    readonly retained: readonly string[];
+    readonly ctx: LoaderContext;
+}
+export interface LiveEnvelope {
+    /**
+     * Opaque and stable per viewer, one per listed secret, newest first. A load sharing none with the
+     * last one is another user, so client caches are cleared; a rotation always leaves one in common.
+     */
+    readonly subjects: readonly string[];
+    /** Absent when no grant could be issued; the client then polls. */
+    readonly grant?: string;
+    /** Wire tag to the frame's owners that watch its key. */
+    readonly tags?: Readonly<Record<string, readonly string[]>>;
+    /** The page loader did not run: the client keeps its page data. */
+    readonly page?: "retained";
+    /** Seconds the grant stays valid from now; the client renews a minute before. */
+    readonly ttl?: number;
+    /** For query hooks: with `queryKeys`, and in development so the page can warn. */
+    readonly query?: LiveQueryKeys;
+}
+export interface LiveQueryKeys {
+    /** Fresh per load; absent when `queryKeys` is off. */
+    readonly salt?: string;
+    /** Wire tag to its key's digest under `salt`. */
+    readonly keys?: Readonly<Record<string, string>>;
+    /** The app runs in development: the page warns about query keys no grant holds. */
+    readonly dev?: true;
+}
+/** The owner a hole of a partially prerendered page is in its page's live frame. */
+export declare const holeOwner: (hole: string, routeId: string) => string;
+/** `createWebApp` reads the runtime through this symbol, so it is not public API on the object. */
+export declare const LIVE_ATTACH: unique symbol;
+export interface LiveRuntimeHandle {
+    readonly [LIVE_ATTACH]: (input: LiveAttachInput) => LiveAttachment;
+    /** The client entry's `live` option for this runtime: the endpoints it serves, where not the default. */
+    readonly clientEntry: LiveClientEntry;
+    /** Announce changed keys; resolves once this process applied the change. */
+    publish(...keys: string[]): Promise<void>;
+}
+//# sourceMappingURL=live-contract.d.ts.map

package/dist/internal/live-contract.d.ts.map

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

package/dist/internal/live-contract.js

@@ -0,0 +1,5 @@
+/** The owner a hole of a partially prerendered page is in its page's live frame. */
+export const holeOwner = (hole, routeId) => `B:${hole}:${routeId}`;
+/** `createWebApp` reads the runtime through this symbol, so it is not public API on the object. */
+export const LIVE_ATTACH = Symbol.for("nifra.web.live.attach");
+//# sourceMappingURL=live-contract.js.map

package/dist/internal/live-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-contract.js","sourceRoot":"","sources":["../../src/internal/live-contract.ts"],"names":[],"mappings":"AA6FA,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,OAAe,EAAU,EAAE,CAAC,KAAK,IAAI,IAAI,OAAO,EAAE,CAAA;AAE1F,mGAAmG;AACnG,MAAM,CAAC,MAAM,WAAW,GAAkB,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA"}

package/dist/internal/live-queries.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The live client's side of the query seam. A mounted query with live keys registers here, and the
+ * live client matches its keys to the tags each live load grants. Importing this module installs the
+ * seam.
+ */
+import { type LiveQuery } from "./query-seam.js";
+export type { LiveQuery };
+/** Read by a query as each fetch starts. */
+export declare const liveTick: () => number;
+/**
+ * Advanced as each live load's response arrives, and as each query registers. A query whose fetch
+ * started after a load arrived read the server after that load took its watermark.
+ */
+export declare const advanceLiveTick: () => number;
+export declare function liveQueries(): Iterable<LiveQuery>;
+/** The live tick `query` registered at, or `undefined` once it left. */
+export declare function registeredAt(query: LiveQuery): number | undefined;
+/** Returns the function that stops watching. */
+export declare function watchLiveQueries(watcher: () => void): () => void;
+/** Another viewer: no query client keeps data loaded for the last one. */
+export declare function clearQueryClients(): void;
+//# sourceMappingURL=live-queries.d.ts.map

package/dist/internal/live-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-queries.d.ts","sourceRoot":"","sources":["../../src/internal/live-queries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAoB,KAAK,SAAS,EAAgB,MAAM,iBAAiB,CAAA;AAEhF,YAAY,EAAE,SAAS,EAAE,CAAA;AAIzB,4CAA4C;AAC5C,eAAO,MAAM,QAAQ,QAAO,MAAc,CAAA;AAE1C;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,MAAgB,CAAA;AAUnD,wBAAgB,WAAW,IAAI,QAAQ,CAAC,SAAS,CAAC,CAEjD;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAEjE;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKhE;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/internal/live-queries.js

@@ -0,0 +1,54 @@
+/**
+ * The live client's side of the query seam. A mounted query with live keys registers here, and the
+ * live client matches its keys to the tags each live load grants. Importing this module installs the
+ * seam.
+ */
+import { installQuerySeam, queryClients } from "./query-seam.js";
+let tick = 0;
+/** Read by a query as each fetch starts. */
+export const liveTick = () => tick;
+/**
+ * Advanced as each live load's response arrives, and as each query registers. A query whose fetch
+ * started after a load arrived read the server after that load took its watermark.
+ */
+export const advanceLiveTick = () => ++tick;
+// Query to the live tick it registered at: a change before that never reached it.
+const queries = new Map();
+const watchers = new Set();
+function changed() {
+    for (const watcher of watchers)
+        watcher();
+}
+export function liveQueries() {
+    return queries.keys();
+}
+/** The live tick `query` registered at, or `undefined` once it left. */
+export function registeredAt(query) {
+    return queries.get(query);
+}
+/** Returns the function that stops watching. */
+export function watchLiveQueries(watcher) {
+    watchers.add(watcher);
+    return () => {
+        watchers.delete(watcher);
+    };
+}
+/** Another viewer: no query client keeps data loaded for the last one. */
+export function clearQueryClients() {
+    for (const ref of queryClients())
+        ref.deref()?.clear();
+}
+installQuerySeam({
+    tick: liveTick,
+    track(query, mounted) {
+        if (mounted && query.keys().length > 0) {
+            if (queries.has(query))
+                return;
+            queries.set(query, advanceLiveTick());
+            changed();
+        }
+        else if (queries.delete(query))
+            changed();
+    },
+});
+//# sourceMappingURL=live-queries.js.map

package/dist/internal/live-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-queries.js","sourceRoot":"","sources":["../../src/internal/live-queries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAkB,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAIhF,IAAI,IAAI,GAAG,CAAC,CAAA;AAEZ,4CAA4C;AAC5C,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAW,EAAE,CAAC,IAAI,CAAA;AAE1C;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAW,EAAE,CAAC,EAAE,IAAI,CAAA;AAEnD,kFAAkF;AAClF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAA;AAC5C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAc,CAAA;AAEtC,SAAS,OAAO;IACd,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,OAAO,EAAE,CAAA;AAC3C,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,IAAI,EAAE,CAAA;AACvB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAC3B,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,gBAAgB,CAAC,OAAmB;IAClD,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACrB,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC,CAAA;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB;IAC/B,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE;QAAE,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAA;AACxD,CAAC;AAED,gBAAgB,CAAC;IACf,IAAI,EAAE,QAAQ;IACd,KAAK,CAAC,KAAK,EAAE,OAAO;QAClB,IAAI,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,OAAM;YAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,CAAC,CAAA;YACrC,OAAO,EAAE,CAAA;QACX,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAA;IAC7C,CAAC;CACF,CAAC,CAAA"}