@nifrajs/web 5.5.1 → 5.6.0

package/dist/internal/invalidation.js

@@ -0,0 +1,149 @@
+const ORDER = ["data", "pages", "publish", "cdn"];
+/** Retry delays after a retryable failure; inline retries stop at {@link INLINE_DEADLINE_MS}. */
+const RETRY_MS = [200, 600, 1800];
+export const INLINE_DEADLINE_MS = 2000;
+/** Run the stages from `from` once. */
+export async function runInvalidation(op, targets, req, platform, from = "data") {
+    const stages = [];
+    for (const stage of ORDER.slice(ORDER.indexOf(from))) {
+        // Decided before any await: a stage with nothing to do costs no turn of the event loop.
+        const running = startStage(stage, op, targets, req, platform);
+        if (running === undefined)
+            continue;
+        const report = await running;
+        stages.push(report);
+        // A cache stage that failed leaves data a reload would read: nothing after it may run.
+        if (!report.ok && (stage === "data" || stage === "pages"))
+            break;
+    }
+    return { id: op.id, ok: stages.every((report) => report.ok), stages };
+}
+/** Start a stage's work for this operation; `undefined` when it has none. Never rejects. */
+function startStage(stage, op, targets, req, platform) {
+    const done = { stage, ok: true, retryable: false };
+    let work;
+    switch (stage) {
+        case "data": {
+            const caches = targets.dataCaches;
+            if (op.tags.length === 0 || caches === undefined)
+                return undefined;
+            work = (async () => {
+                for (const cache of caches) {
+                    for (const tag of op.tags)
+                        await cache.invalidateTag(tag);
+                }
+                return done;
+            })();
+            break;
+        }
+        case "pages": {
+            const store = targets.store;
+            if (store === undefined || op.paths.length + op.tags.length === 0)
+                return undefined;
+            work = (async () => {
+                if (op.tags.length > 0 && store.invalidateTag === undefined) {
+                    return { stage, ok: false, retryable: false, error: "tag_invalidation_not_supported" };
+                }
+                for (const path of op.paths) {
+                    const key = targets.keyOf?.(path, req) ?? null;
+                    if (key !== null)
+                        await store.delete(key);
+                }
+                for (const tag of op.tags)
+                    await store.invalidateTag?.(tag);
+                return done;
+            })();
+            break;
+        }
+        case "publish": {
+            const publish = targets.publish;
+            if (publish === undefined || op.keys.length + op.tags.length === 0)
+                return undefined;
+            work = (async () => {
+                await publish([...new Set([...op.keys, ...op.tags])]);
+                return done;
+            })();
+            break;
+        }
+        case "cdn": {
+            const cdn = targets.cdn;
+            if (cdn === undefined || op.paths.length + op.tags.length === 0)
+                return undefined;
+            work = (async () => {
+                const outcome = await cdn.purge({ tags: op.tags, paths: op.paths }, platform);
+                return outcome.cdn === "failed"
+                    ? {
+                        stage,
+                        ok: false,
+                        retryable: outcome.retryable,
+                        error: outcome.error ?? "cdn_purge_failed",
+                    }
+                    : outcome.cdn === "queued"
+                        ? { stage, ok: true, retryable: false, queued: true }
+                        : done;
+            })();
+            break;
+        }
+    }
+    return work.catch(() => ({ stage, ok: false, retryable: true, error: `${stage}_failed` }));
+}
+const realClock = {
+    now: () => Date.now(),
+    sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+};
+/**
+ * Run the pipeline for a write; never throws and never changes the response. A retryable failure
+ * retries from the failed stage, under `waitUntil` when the platform has it, else inline until
+ * {@link INLINE_DEADLINE_MS}. A failure that remains is reported once.
+ */
+export async function settleInvalidation(op, targets, req, platform, options = {}) {
+    const onError = options.onError ?? logInvalidation;
+    const clock = options.clock ?? realClock;
+    const started = clock.now();
+    const first = await runInvalidation(op, targets, req, platform);
+    if (first.ok)
+        return first;
+    const failed = first.stages.find((report) => !report.ok);
+    if (failed === undefined || !failed.retryable) {
+        report(onError, first);
+        return first;
+    }
+    const background = typeof platform?.waitUntil === "function";
+    const retry = async () => {
+        let last = first;
+        let stage = failed.stage;
+        for (const delay of RETRY_MS) {
+            if (!background && clock.now() - started + delay >= INLINE_DEADLINE_MS)
+                break;
+            await clock.sleep(delay);
+            last = await runInvalidation(op, targets, req, platform, stage);
+            const next = last.stages.find((report) => !report.ok);
+            if (next === undefined)
+                return last;
+            if (!next.retryable)
+                break;
+            stage = next.stage;
+        }
+        report(onError, last);
+        return last;
+    };
+    if (background) {
+        platform?.waitUntil?.(retry());
+        return first;
+    }
+    return retry();
+}
+function report(onError, value) {
+    try {
+        onError(value);
+    }
+    catch {
+        // A failing reporter must not reach the response.
+    }
+}
+/** The default report: the operation id and the stage, never a path, tag or key. */
+export function logInvalidation(report) {
+    const failed = report.stages.find((stage) => !stage.ok);
+    console.error(`[nifra/web] invalidation ${report.id} gave up at the ${failed?.stage ?? "unknown"} stage (${failed?.error ?? "failed"})`);
+}
+//# sourceMappingURL=invalidation.js.map

package/dist/internal/invalidation.js.map

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

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

@@ -0,0 +1,51 @@
+/**
+ * The declarative binding walker - attaches signal-driven behavior to SERVER-RENDERED markup.
+ * No VDOM, no hydration re-render: the HTML the server sent (e.g. via `@nifrajs/web-vanilla`) is
+ * already the initial state; bindings update it surgically when signals change. `bindIsland` runs it.
+ *
+ * The attribute set is CLOSED and documented - six bindings, no expression language. Values are
+ * signal/handler NAMES looked up in the island's scope, never evaluated code, so markup can't
+ * inject behavior:
+ *
+ *   data-bind-text="count"                  textContent ← String(signal())
+ *   data-bind-show="isOpen"                 hidden ← !signal()
+ *   data-bind-class="active:isOpen,b:sigB"  classList.toggle per pair
+ *   data-bind-attr="aria-expanded:isOpen"   setAttribute / removeAttribute (false/null remove);
+ *                                           never an `on*` handler or `srcdoc`, and a URL attribute
+ *                                           takes only an http(s)/mailto/tel or relative URL
+ *   data-bind-value="query"                 two-way <input>/<select>/<textarea> (input and change)
+ *   data-bind-on="click:inc,submit:save"    addEventListener per pair
+ *
+ * Nothing inside a `data-island-ignore` element binds or mounts: render user HTML there, so its
+ * markup cannot reach the island's handlers or signals.
+ *
+ * A binding belongs to its nearest island: an island never binds inside a nested island's host. The
+ * nested host element itself is still the outer island's markup, so the outer island may bind it.
+ */
+import { type Signal } from "./island-signals.js";
+export type IslandScope = {
+    readonly signals: Readonly<Record<string, Signal<unknown>>>;
+    readonly handlers: Readonly<Record<string, (event: Event) => void>>;
+};
+/** The element surface the walker needs - structural, so tests can drive it without a real DOM. */
+export interface BindableElement {
+    getAttribute(name: string): string | null;
+    setAttribute(name: string, value: string): void;
+    removeAttribute(name: string): void;
+    textContent: string | null;
+    hidden: boolean;
+    value?: string;
+    readonly classList: {
+        toggle(name: string, force?: boolean): unknown;
+    };
+    addEventListener(type: string, listener: (event: Event) => void): void;
+    removeEventListener(type: string, listener: (event: Event) => void): void;
+}
+export interface BindableRoot {
+    querySelectorAll(selector: string): Iterable<BindableElement>;
+}
+/** Walk `root` and attach every `data-bind-*` binding against `scope`. Each binding's disposer
+ * (reactive effect or event listener) goes onto `stops` as it attaches, so a binding that throws
+ * midway leaves the earlier ones disposable; `stops` is returned. */
+export declare function bindScope(root: BindableRoot, scope: IslandScope, stops?: Array<() => void>): Array<() => void>;
+//# sourceMappingURL=island-bindings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"island-bindings.d.ts","sourceRoot":"","sources":["../../src/internal/island-bindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAS,MAAM,qBAAqB,CAAA;AAExD,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAC3D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAA;CACpE,CAAA;AAuCD,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACzC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/C,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,SAAS,EAAE;QAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;KAAE,CAAA;IACtE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAA;IACtE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAA;CAC1E;AAED,MAAM,WAAW,YAAY;IAC3B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAA;CAC9D;AAED;;qEAEqE;AACrE,wBAAgB,SAAS,CACvB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,WAAW,EAClB,KAAK,GAAE,KAAK,CAAC,MAAM,IAAI,CAAM,GAC5B,KAAK,CAAC,MAAM,IAAI,CAAC,CAiGnB"}

package/dist/internal/island-bindings.js

@@ -0,0 +1,147 @@
+/**
+ * The declarative binding walker - attaches signal-driven behavior to SERVER-RENDERED markup.
+ * No VDOM, no hydration re-render: the HTML the server sent (e.g. via `@nifrajs/web-vanilla`) is
+ * already the initial state; bindings update it surgically when signals change. `bindIsland` runs it.
+ *
+ * The attribute set is CLOSED and documented - six bindings, no expression language. Values are
+ * signal/handler NAMES looked up in the island's scope, never evaluated code, so markup can't
+ * inject behavior:
+ *
+ *   data-bind-text="count"                  textContent ← String(signal())
+ *   data-bind-show="isOpen"                 hidden ← !signal()
+ *   data-bind-class="active:isOpen,b:sigB"  classList.toggle per pair
+ *   data-bind-attr="aria-expanded:isOpen"   setAttribute / removeAttribute (false/null remove);
+ *                                           never an `on*` handler or `srcdoc`, and a URL attribute
+ *                                           takes only an http(s)/mailto/tel or relative URL
+ *   data-bind-value="query"                 two-way <input>/<select>/<textarea> (input and change)
+ *   data-bind-on="click:inc,submit:save"    addEventListener per pair
+ *
+ * Nothing inside a `data-island-ignore` element binds or mounts: render user HTML there, so its
+ * markup cannot reach the island's handlers or signals.
+ *
+ * A binding belongs to its nearest island: an island never binds inside a nested island's host. The
+ * nested host element itself is still the outer island's markup, so the outer island may bind it.
+ */
+import { watch } from "./island-signals.js";
+const warned = new Set();
+/** Unknown names warn once (loud in dev, resilient in prod - progressive enhancement must not
+ * throw over a typo'd attribute) and the binding is skipped. */
+function warnOnce(kind, name) {
+    const key = `${kind}:${name}`;
+    if (warned.has(key))
+        return;
+    warned.add(key);
+    console.warn(`[nifra/islands] unknown ${kind} ${JSON.stringify(name)} - binding skipped`);
+}
+// Own keys only: a name such as `constructor` must not resolve to what a plain object inherits.
+function named(kind, record, name) {
+    if (Object.hasOwn(record, name))
+        return record[name];
+    warnOnce(kind, name);
+    return undefined;
+}
+/** Parse a `"key:name,key2:name2"` pair list (whitespace-tolerant). Malformed entries skip. */
+function pairs(spec) {
+    const out = [];
+    for (const part of spec.split(",")) {
+        const sep = part.indexOf(":");
+        if (sep <= 0)
+            continue;
+        const key = part.slice(0, sep).trim();
+        const name = part.slice(sep + 1).trim();
+        if (key && name)
+            out.push([key, name]);
+    }
+    return out;
+}
+// A bound value is data (often from island state the markup carries), so an attribute that would run
+// it as code, or navigate to it as a script URL, is refused.
+const CODE_ATTRIBUTE = /^(?:on|srcdoc$)/i;
+const URL_ATTRIBUTE = /^(?:href|src|action|formaction|xlink:href|poster|data|background|cite|ping)$/i;
+const SAFE_URL = /^(?:(?:https?|mailto|tel):|[^:/?#]*(?:[/?#]|$))/i;
+/** Walk `root` and attach every `data-bind-*` binding against `scope`. Each binding's disposer
+ * (reactive effect or event listener) goes onto `stops` as it attaches, so a binding that throws
+ * midway leaves the earlier ones disposable; `stops` is returned. */
+export function bindScope(root, scope, stops = []) {
+    // Each element carrying `data-bind-<kind>` outside any ignored subtree and any nested island, with
+    // that attribute's value.
+    const each = (kind) => {
+        const attribute = `data-bind-${kind}`;
+        return [
+            ...root.querySelectorAll(`[${attribute}]:not([data-island-ignore],[data-island-ignore] *,:scope [data-island] *)`),
+        ].map((el) => [el, el.getAttribute(attribute) ?? ""]);
+    };
+    for (const [el, name] of each("text")) {
+        const s = named("signal", scope.signals, name);
+        if (s) {
+            stops.push(watch(s, (v) => {
+                el.textContent = String(v);
+            }));
+        }
+    }
+    for (const [el, name] of each("show")) {
+        const s = named("signal", scope.signals, name);
+        if (s) {
+            stops.push(watch(s, (v) => {
+                el.hidden = !v;
+            }));
+        }
+    }
+    for (const [el, spec] of each("class")) {
+        for (const [className, name] of pairs(spec)) {
+            const s = named("signal", scope.signals, name);
+            if (s) {
+                stops.push(watch(s, (v) => {
+                    el.classList.toggle(className, !!v);
+                }));
+            }
+        }
+    }
+    for (const [el, spec] of each("attr")) {
+        for (const [attr, name] of pairs(spec)) {
+            if (CODE_ATTRIBUTE.test(attr)) {
+                warnOnce("attribute", attr);
+                continue;
+            }
+            const s = named("signal", scope.signals, name);
+            if (s) {
+                const isUrl = URL_ATTRIBUTE.test(attr);
+                stops.push(watch(s, (v) => {
+                    if (v === false || v == null || (isUrl && !SAFE_URL.test(String(v).trim())))
+                        el.removeAttribute(attr);
+                    else
+                        el.setAttribute(attr, String(v));
+                }));
+            }
+        }
+    }
+    for (const [el, name] of each("value")) {
+        const s = named("signal", scope.signals, name);
+        if (s) {
+            stops.push(watch(s, (v) => {
+                const next = String(v);
+                // Skip same-value writes: resetting an input's value mid-typing moves the caret.
+                if (el.value !== next)
+                    el.value = next;
+            }));
+            const input = () => s.set(el.value ?? "");
+            // A <select> commits on `change`, and browsers disagree on whether `input` comes first. The
+            // second event of a pair writes the same value, which the signal skips.
+            for (const type of ["input", "change"]) {
+                el.addEventListener(type, input);
+                stops.push(() => el.removeEventListener(type, input));
+            }
+        }
+    }
+    for (const [el, spec] of each("on")) {
+        for (const [event, name] of pairs(spec)) {
+            const handler = named("handler", scope.handlers, name);
+            if (handler === undefined)
+                continue;
+            el.addEventListener(event, handler);
+            stops.push(() => el.removeEventListener(event, handler));
+        }
+    }
+    return stops;
+}
+//# sourceMappingURL=island-bindings.js.map

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

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

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

@@ -0,0 +1,26 @@
+/** The node surface `bindList` uses; an `Element` has it. */
+export interface ListNode {
+    remove(): void;
+}
+/** The container surface `bindList` uses; an `Element` has it. */
+export interface ListContainer<E extends ListNode> {
+    replaceChildren(...nodes: E[]): void;
+    insertBefore(node: E, before: E | null): unknown;
+}
+/** How `bindList` turns items into keyed DOM. */
+export interface BindListOptions<T, E extends ListNode = HTMLElement> {
+    /** Stable and unique per item - never the array index, or a removal reuses the wrong node. */
+    key(item: T): string | number;
+    create(item: T): E;
+    /** Brings a node in line with its item: runs after `create` and on every later change. */
+    update?(el: E, item: T): void;
+}
+/**
+ * Render a list signal (or any getter) into `container` with keyed reconciliation. A surviving item
+ * keeps its node, so focus, selection and input state survive a reorder. A render with no earlier
+ * nodes replaces the container's children; later renders move only the nodes outside the longest
+ * run already in order. `key`, `create` and `update` run untracked: a signal they read does not
+ * re-render the list. Returns the disposer; inside an island the binding also stops on unmount.
+ */
+export declare function bindList<T, E extends ListNode = HTMLElement>(source: () => readonly T[], container: ListContainer<NoInfer<E>>, options: BindListOptions<T, E>): () => void;
+//# sourceMappingURL=island-list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"island-list.d.ts","sourceRoot":"","sources":["../../src/internal/island-list.ts"],"names":[],"mappings":"AAEA,6DAA6D;AAC7D,MAAM,WAAW,QAAQ;IACvB,MAAM,IAAI,IAAI,CAAA;CACf;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,QAAQ;IAC/C,eAAe,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAAA;IACpC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,OAAO,CAAA;CACjD;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,WAAW;IAClE,8FAA8F;IAC9F,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,GAAG,MAAM,CAAA;IAC7B,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;IAClB,0FAA0F;IAC1F,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GAAG,WAAW,EAC1D,MAAM,EAAE,MAAM,SAAS,CAAC,EAAE,EAE1B,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EACpC,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,MAAM,IAAI,CAkCZ"}

package/dist/internal/island-list.js

@@ -0,0 +1,78 @@
+import { effect, untrack } from "./island-signals.js";
+/**
+ * Render a list signal (or any getter) into `container` with keyed reconciliation. A surviving item
+ * keeps its node, so focus, selection and input state survive a reorder. A render with no earlier
+ * nodes replaces the container's children; later renders move only the nodes outside the longest
+ * run already in order. `key`, `create` and `update` run untracked: a signal they read does not
+ * re-render the list. Returns the disposer; inside an island the binding also stops on unmount.
+ */
+export function bindList(source, 
+// A DOM container's generic methods would drive E to `ListNode`; the row type comes from `create`.
+container, options) {
+    let nodes = new Map();
+    // Each node's position in the last render; empty until a render leaves nodes to keep.
+    let at = new Map();
+    return effect(() => {
+        const items = source();
+        untrack(() => {
+            const next = new Map();
+            for (const item of items) {
+                const key = options.key(item);
+                if (next.has(key))
+                    console.warn("[nifra/islands] bindList: duplicate key skipped", key);
+                else {
+                    const el = nodes.get(key) ?? options.create(item);
+                    options.update?.(el, item);
+                    next.set(key, el);
+                }
+            }
+            const els = [...next.values()];
+            if (at.size === 0)
+                container.replaceChildren(...els);
+            else {
+                for (const [key, el] of nodes)
+                    if (!next.has(key))
+                        el.remove();
+                const stays = inOrder(els.map((el) => at.get(el) ?? -1));
+                let anchor = null;
+                for (let i = els.length - 1; i >= 0; i--) {
+                    const el = els[i];
+                    if (el === undefined)
+                        continue;
+                    if (!stays.has(i))
+                        container.insertBefore(el, anchor);
+                    anchor = el;
+                }
+            }
+            at = new Map(els.map((el, i) => [el, i]));
+            nodes = next;
+        });
+    });
+}
+// The indexes of `old` (each node's previous position, -1 for a new node) on a longest increasing
+// run: those nodes already sit in order, and every other node is moved.
+function inOrder(old) {
+    // tails[n] is the index ending the best run of length n + 1; back links each run.
+    const tails = [];
+    const back = [];
+    old.forEach((o, i) => {
+        if (o < 0)
+            return;
+        let lo = 0;
+        let hi = tails.length;
+        while (lo < hi) {
+            const mid = (lo + hi) >> 1;
+            if ((old[tails[mid] ?? 0] ?? 0) < o)
+                lo = mid + 1;
+            else
+                hi = mid;
+        }
+        back[i] = tails[lo - 1] ?? -1;
+        tails[lo] = i;
+    });
+    const stays = new Set();
+    for (let i = tails.at(-1) ?? -1; i >= 0; i = back[i] ?? -1)
+        stays.add(i);
+    return stays;
+}
+//# sourceMappingURL=island-list.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { IslandCleanup, IslandEnhancer } from "../islands.js";
+/** Own one host so removing a subtree can stop its islands without disturbing retained siblings. */
+export declare function mountIsland(el: HTMLElement, enhancers: Readonly<Record<string, IslandEnhancer<never>>>): IslandCleanup | undefined;
+//# sourceMappingURL=island-mount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"island-mount.d.ts","sourceRoot":"","sources":["../../src/internal/island-mount.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAalE,oGAAoG;AACpG,wBAAgB,WAAW,CACzB,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,GACzD,aAAa,GAAG,SAAS,CA6C3B"}

package/dist/internal/island-mount.js

@@ -0,0 +1,66 @@
+import { MAX_MEDIA_QUERY_LENGTH, scheduleTrigger, } from "@nifrajs/island-trigger";
+import { owned } from "./island-owner.js";
+function readProps(el) {
+    const raw = el.dataset.islandProps;
+    if (raw === undefined || raw === "")
+        return undefined;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Own one host so removing a subtree can stop its islands without disturbing retained siblings. */
+export function mountIsland(el, enhancers) {
+    const id = el.dataset.island;
+    if (id === undefined || el.dataset.islandMounted !== undefined)
+        return undefined;
+    const enhancer = Object.hasOwn(enhancers, id) ? enhancers[id] : undefined;
+    if (enhancer === undefined)
+        return undefined;
+    const strategyAttr = el.dataset.islandStrategy;
+    const media = el.dataset.islandMedia;
+    const strategy = strategyAttr === "idle" || strategyAttr === "visible" || strategyAttr === "load"
+        ? strategyAttr
+        : strategyAttr === "media" &&
+            media !== undefined &&
+            media.length > 0 &&
+            media.length <= MAX_MEDIA_QUERY_LENGTH
+            ? { media }
+            : strategyAttr === undefined
+                ? "load"
+                : undefined;
+    // Invalid markers must stay inert, including untrusted oversized media queries.
+    if (strategy === undefined)
+        return undefined;
+    const disposers = [];
+    el.dataset.islandMounted = "";
+    disposers.push(() => {
+        delete el.dataset.islandMounted;
+    });
+    const props = readProps(el);
+    const run = () => {
+        try {
+            // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: enhancer props are the authored SSR contract, as in defineIsland
+            const cleanup = owned(disposers, () => enhancer(el, props));
+            if (typeof cleanup === "function")
+                disposers.push(cleanup);
+        }
+        catch (err) {
+            console.error(`[nifra/islands] enhancer "${id}" failed:`, err);
+        }
+    };
+    disposers.push(scheduleTrigger(strategy, run, { target: el }));
+    return () => {
+        for (const dispose of disposers.splice(0)) {
+            try {
+                dispose();
+            }
+            catch {
+                // Best-effort teardown: one failing cleanup must not block the rest.
+            }
+        }
+    };
+}
+//# sourceMappingURL=island-mount.js.map

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

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

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

@@ -0,0 +1,5 @@
+/** Run `fn` with every disposer it registers pushed onto `kids`. */
+export declare function owned<T>(kids: Array<() => void>, fn: () => T): T;
+/** Register `stop` with the running island, if any. Outside an enhancer it stays the caller's. */
+export declare function adopt(stop: () => void): void;
+//# sourceMappingURL=island-owner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"island-owner.d.ts","sourceRoot":"","sources":["../../src/internal/island-owner.ts"],"names":[],"mappings":"AAKA,oEAAoE;AACpE,wBAAgB,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQhE;AAED,kGAAkG;AAClG,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAE5C"}

package/dist/internal/island-owner.js

@@ -0,0 +1,20 @@
+// The disposer list of the island whose enhancer is running, so every effect, computed, list binding
+// and resource it creates stops when the island unmounts. A separate module so an imperative-only
+// island bundle carries no signal code.
+let owner;
+/** Run `fn` with every disposer it registers pushed onto `kids`. */
+export function owned(kids, fn) {
+    const prev = owner;
+    owner = kids;
+    try {
+        return fn();
+    }
+    finally {
+        owner = prev;
+    }
+}
+/** Register `stop` with the running island, if any. Outside an enhancer it stays the caller's. */
+export function adopt(stop) {
+    owner?.push(stop);
+}
+//# sourceMappingURL=island-owner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"island-owner.js","sourceRoot":"","sources":["../../src/internal/island-owner.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,kGAAkG;AAClG,wCAAwC;AACxC,IAAI,KAAoC,CAAA;AAExC,oEAAoE;AACpE,MAAM,UAAU,KAAK,CAAI,IAAuB,EAAE,EAAW;IAC3D,MAAM,IAAI,GAAG,KAAK,CAAA;IAClB,KAAK,GAAG,IAAI,CAAA;IACZ,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,CAAA;IACb,CAAC;YAAS,CAAC;QACT,KAAK,GAAG,IAAI,CAAA;IACd,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,KAAK,CAAC,IAAgB;IACpC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;AACnB,CAAC"}

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

@@ -0,0 +1,30 @@
+/** An async value's state. `status` narrows `value` and `error`, so no branch can be skipped. */
+export type ResourceState<T> = {
+    readonly status: "pending";
+    readonly value: undefined;
+    readonly error: undefined;
+} | {
+    readonly status: "ready";
+    readonly value: T;
+    readonly error: undefined;
+} | {
+    readonly status: "error";
+    readonly value: undefined;
+    readonly error: unknown;
+};
+/** Call it to read the current state (tracking, like a signal). */
+export type Resource<T> = {
+    (): ResourceState<T>;
+    /** Fetch the current key again; once disposed, nothing. */
+    refetch(): void;
+    /** Stop refetching and abort the request in flight; its result is dropped. */
+    dispose(): void;
+};
+/**
+ * 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 declare function resource<K, T>(source: () => K, fetcher: (key: K, abort: AbortSignal) => Promise<T>): Resource<T>;
+//# sourceMappingURL=island-resource.d.ts.map