@nifrajs/web 5.5.1 → 5.7.0

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

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"}