fuzor 0.4.0 → 0.5.0

package/dist/runtime/memory-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-navigation.d.ts","sourceRoot":"","sources":["../../src/runtime/memory-navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAc,eAAe,EAAE,KAAK,iBAAiB,EAAkG,MAAM,iBAAiB,CAAC;AAEtL,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC7F,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAmF7H;AAED,eAAO,MAAM,oBAAoB,GAAI,UAAS,uBAA4B,2DACjB,CAAC"}

package/dist/runtime/memory-navigation.js

@@ -0,0 +1,98 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { Navigation, NavigationError } from "./navigation.js";
+/** No DOM globals, route matching, or rendering; this adapter models committed navigation. */
+export function makeMemoryNavigation(options = {}) {
+    return Effect.gen(function* () {
+        const parseUrl = (href, base) => Effect.try({
+            try: () => {
+                const url = new URL(href, base);
+                const origin = new URL(base).origin;
+                if (!['http:', 'https:'].includes(url.protocol) || url.origin !== origin)
+                    throw new Error("Use a same-origin HTTP(S) URL");
+                return url;
+            },
+            catch: (error) => new NavigationError("InvalidUrl", `Invalid navigation URL ${href}: ${String(error)}`)
+        });
+        const cloneState = (state) => Effect.try({
+            try: () => structuredClone(state ?? null),
+            catch: (error) => new NavigationError("InvalidState", `Navigation state cannot be cloned: ${String(error)}`)
+        });
+        const base = yield* Effect.try({
+            try: () => {
+                const url = new URL(options.baseUrl ?? "http://fuzor.local/");
+                if (!['http:', 'https:'].includes(url.protocol))
+                    throw new Error("Use an HTTP(S) base URL");
+                return url;
+            },
+            catch: (error) => new NavigationError("InvalidUrl", `Invalid base URL: ${String(error)}`)
+        });
+        const initial = options.initialEntries ?? [{ href: "/" }];
+        const initialIndex = options.initialIndex ?? initial.length - 1;
+        if (!initial.length || !Number.isInteger(initialIndex) || initialIndex < 0 || initialIndex >= initial.length) {
+            return yield* Effect.fail(new NavigationError("InvalidEntries", "Memory navigation needs entries and a valid initial index"));
+        }
+        let nextKey = 0;
+        const snapshot = (url, state, index) => Object.freeze({
+            url: url.href, pathname: url.pathname, search: url.search, hash: url.hash,
+            key: `memory-${nextKey++}`, index, state
+        });
+        const entries = yield* Effect.forEach(initial, (entry, index) => Effect.gen(function* () {
+            return snapshot(yield* parseUrl(entry.href, base.href), yield* cloneState(entry.state), index);
+        }));
+        let index = initialIndex;
+        const listeners = new Set();
+        const copy = (entry) => Object.freeze({ ...entry, state: structuredClone(entry.state) });
+        const complete = (kind, from, delta) => {
+            const change = Object.freeze({ kind, from: copy(from), destination: copy(entries[index]), delta });
+            for (const listener of listeners) {
+                try {
+                    listener({ ...change, from: copy(change.from), destination: copy(change.destination) });
+                }
+                catch (error) {
+                    try {
+                        (options.onError ?? console.error)(error);
+                    }
+                    catch { }
+                }
+            }
+            return {
+                change,
+                committed: Effect.sync(() => copy(change.destination)),
+                finished: Effect.sync(() => copy(change.destination))
+            };
+        };
+        return {
+            capabilities: { interception: false, precommit: false, entries: true, documentNavigation: false, nativeScroll: false },
+            current: Effect.sync(() => copy(entries[index])),
+            entries: Effect.sync(() => entries.map(copy)),
+            navigate: (intent) => Effect.gen(function* () {
+                const url = yield* parseUrl(intent.href, entries[index].url);
+                const state = yield* cloneState(intent.state);
+                const from = entries[index];
+                const kind = intent.history === "auto" ? (url.href === from.url ? "replace" : "push") : intent.history ?? "push";
+                if (kind === "push") {
+                    index++;
+                    entries.splice(index, entries.length, snapshot(url, state, index));
+                }
+                else
+                    entries[index] = snapshot(url, state, index);
+                return complete(kind, from, kind === "push" ? 1 : 0);
+            }),
+            traverse: (delta) => Effect.gen(function* () {
+                const destination = index + delta;
+                if (!Number.isInteger(delta) || delta === 0 || destination < 0 || destination >= entries.length) {
+                    return yield* Effect.fail(new NavigationError("TraversalUnavailable", `Cannot traverse ${delta} entries`));
+                }
+                const from = entries[index];
+                index = destination;
+                return complete("traverse", from, delta);
+            }),
+            canTraverse: (delta) => Effect.sync(() => Number.isInteger(delta) && delta !== 0 && index + delta >= 0 && index + delta < entries.length),
+            reload: () => Effect.sync(() => complete("reload", entries[index], 0)),
+            subscribe: (listener) => Effect.acquireRelease(Effect.sync(() => { listeners.add(listener); }), () => Effect.sync(() => { listeners.delete(listener); }))
+        };
+    });
+}
+export const MemoryNavigationLive = (options = {}) => Layer.effect(Navigation, makeMemoryNavigation(options));
+//# sourceMappingURL=memory-navigation.js.map

package/dist/runtime/memory-navigation.js.map

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

package/dist/runtime/native.d.ts

@@ -0,0 +1,108 @@
+import { type Json, type Values } from "../server-components/protocol.js";
+import type { PageScriptContext } from "./page-scripts.js";
+export type NativeEventSnapshot = {
+    readonly type: string;
+    readonly value?: string;
+    readonly checked?: boolean;
+    readonly key?: string;
+    readonly code?: string;
+    readonly repeat?: boolean;
+    readonly button?: number;
+    readonly buttons?: number;
+    readonly clientX?: number;
+    readonly clientY?: number;
+    readonly pointerId?: number;
+    readonly pointerType?: string;
+    readonly altKey?: boolean;
+    readonly ctrlKey?: boolean;
+    readonly metaKey?: boolean;
+    readonly shiftKey?: boolean;
+};
+export type NativeHandlerContext = {
+    readonly element: HTMLElement;
+    readonly event: NativeEventSnapshot;
+    readonly signal: AbortSignal;
+    readonly props: Values;
+    get(name: string): Json;
+    set(name: string, value: Json): void;
+};
+export type NativeHandler = (context: NativeHandlerContext) => void | Promise<void>;
+export type NativeBinding = {
+    readonly selector: string;
+    readonly state: string;
+    readonly kind: "text" | "value" | "checked" | "attribute";
+    readonly attribute?: string;
+    readonly prefix?: string;
+    readonly suffix?: string;
+};
+export type NativeEvent = {
+    readonly selector: string;
+    readonly type: string;
+    readonly preventDefault?: boolean;
+    readonly handler?: NativeHandler;
+    readonly load?: () => Promise<{
+        default: NativeHandler;
+    }>;
+};
+export type NativeDefinition = {
+    readonly id: string;
+    readonly version: number;
+    readonly state: Values;
+    readonly bindings: readonly NativeBinding[];
+    readonly events: readonly NativeEvent[];
+    readonly activation?: "interaction" | "load" | "idle" | "visible";
+};
+export type NativeCheckpointEntry = {
+    readonly key: string;
+    readonly definition: string;
+    readonly version: number;
+    readonly state: Values;
+};
+export type NativeCheckpoint = {
+    readonly version: 1;
+    readonly entries: readonly NativeCheckpointEntry[];
+};
+export type NativeInstance = {
+    readonly host: HTMLElement;
+    readonly key: string;
+    update(props: Values): void;
+    snapshot(): NativeCheckpointEntry;
+    validateRestore(entry: NativeCheckpointEntry): void;
+    restore(entry: NativeCheckpointEntry): void;
+    dispose(): void;
+};
+export type NativeCheckpointStore = ReturnType<typeof createNativeCheckpointStore>;
+/** Explicit persistence: no automatic storage of application state in the browser. */
+export declare function createNativeCheckpointStore(checkpoint?: NativeCheckpoint): {
+    read(key: string): NativeCheckpointEntry | undefined;
+    claim(instance: NativeInstance): void;
+    release(instance: NativeInstance): void;
+    dehydrate(): NativeCheckpoint;
+};
+/** Recognized by the HTML compiler; ordinary scripts stay imperative. */
+export declare function defineNative<T extends NativeDefinition>(definition: T): T;
+export declare function snapshotNative(scope: ParentNode): NativeCheckpoint;
+/** Explicit restoration into live native instances; it never mounts or replays setup. */
+export declare function restoreNative(scope: ParentNode, checkpoint: NativeCheckpoint): void;
+export declare function mountNative(host: HTMLElement, definition: NativeDefinition, context: PageScriptContext, options?: {
+    readonly key?: string;
+    readonly store?: NativeCheckpointStore;
+    readonly props?: Values;
+    readonly initialState?: Values;
+    readonly onError?: (error: unknown) => void;
+    readonly timeoutMs?: number;
+}): NativeInstance;
+/** Explicit native adapter for persistent server-component client boundaries. */
+export declare function nativeClient(definition: NativeDefinition, options?: {
+    readonly store?: NativeCheckpointStore;
+    readonly initialState?: (props: Values) => Values;
+}): {
+    mountPersistent(host: HTMLElement, props: Values, operation?: {
+        signal: AbortSignal;
+        scope?: string;
+    }): {
+        update: (next: Values) => void;
+        dispose(): void;
+    };
+};
+//# sourceMappingURL=native.d.ts.map

package/dist/runtime/native.d.ts.map

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

package/dist/runtime/native.js

@@ -0,0 +1,378 @@
+import * as Atom from "effect/reactivity/Atom";
+import * as AtomRegistry from "effect/reactivity/AtomRegistry";
+import { assertJson, assertName, scalar } from "../server-components/protocol.js";
+const bindingOwners = new WeakMap();
+const instances = new WeakMap();
+const eventTypes = new Set(["click", "input", "change", "keydown", "keyup", "submit", "focusin", "focusout", "pointerdown", "pointerup"]);
+const foreignRoot = (element) => element.hasAttribute("data-fuzor-ui") || element.localName.startsWith("fuzor-") && !["fuzor-client", "fuzor-router"].includes(element.localName);
+function assertNativeKey(value) { if (typeof value !== "string" || !value || value.length > 4096)
+    throw new Error("Invalid native instance key"); }
+const jsonCopy = (value) => { assertJson(value); const json = JSON.stringify(value); if (new TextEncoder().encode(json).byteLength > 2 * 1024 * 1024)
+    throw new Error("Native state payload limit exceeded"); return JSON.parse(json); };
+/** Explicit persistence: no automatic storage of application state in the browser. */
+export function createNativeCheckpointStore(checkpoint) {
+    const saved = new Map();
+    const live = new Map();
+    if (checkpoint) {
+        assertJson(checkpoint);
+        if (checkpoint.version !== 1 || !Array.isArray(checkpoint.entries) || checkpoint.entries.length > 2048 || JSON.stringify(checkpoint).length > 2 * 1024 * 1024)
+            throw new Error("Invalid native checkpoint");
+        for (const entry of checkpoint.entries) {
+            assertNativeKey(entry.key);
+            assertName(entry.definition);
+            if (!Number.isSafeInteger(entry.version) || entry.version < 1 || !entry.state || Array.isArray(entry.state) || typeof entry.state !== "object" || saved.has(entry.key))
+                throw new Error("Invalid native checkpoint entry");
+            saved.set(entry.key, jsonCopy(entry));
+        }
+    }
+    return {
+        read(key) { return saved.get(key); },
+        claim(instance) { if (live.has(instance.key))
+            throw new Error("Duplicate native instance key"); if (new Set([...saved.keys(), ...live.keys(), instance.key]).size > 2048)
+            throw new Error("Native checkpoint instance limit exceeded"); live.set(instance.key, instance); },
+        release(instance) { if (live.get(instance.key) === instance) {
+            saved.set(instance.key, instance.snapshot());
+            live.delete(instance.key);
+        } },
+        dehydrate() {
+            const result = new Map(saved);
+            for (const [key, instance] of live)
+                result.set(key, instance.snapshot());
+            return jsonCopy({ version: 1, entries: [...result.values()] });
+        }
+    };
+}
+/** Recognized by the HTML compiler; ordinary scripts stay imperative. */
+export function defineNative(definition) { return definition; }
+export function snapshotNative(scope) {
+    const roots = [...scope.querySelectorAll("*")];
+    if ("tagName" in scope)
+        roots.unshift(scope);
+    return jsonCopy({ version: 1, entries: roots.flatMap(root => { const instance = instances.get(root); return instance ? [instance.snapshot()] : []; }) });
+}
+/** Explicit restoration into live native instances; it never mounts or replays setup. */
+export function restoreNative(scope, checkpoint) {
+    const validated = createNativeCheckpointStore(checkpoint).dehydrate();
+    const roots = [...scope.querySelectorAll("*")];
+    if ("tagName" in scope)
+        roots.unshift(scope);
+    const live = new Map(roots.flatMap(root => { const instance = instances.get(root); return instance ? [[instance.key, instance]] : []; }));
+    const updates = validated.entries.map(entry => {
+        const instance = live.get(entry.key);
+        if (!instance)
+            throw new Error(`Native checkpoint instance is missing: ${entry.key}`);
+        instance.validateRestore(entry);
+        return { instance, entry };
+    });
+    for (const { instance, entry } of updates)
+        instance.restore(entry);
+}
+export function mountNative(host, definition, context, options = {}) {
+    assertName(definition.id);
+    if (!Number.isSafeInteger(definition.version) || definition.version < 1)
+        throw new Error("Native state requires a positive schema version");
+    const key = options.key ?? host.getAttribute("data-fuzor-key") ?? host.id;
+    assertNativeKey(key);
+    if (instances.has(host))
+        throw new Error("Native host already has an owner");
+    if (foreignRoot(host))
+        throw new Error("Native behavior cannot own a UI component, server fragment or Framework Island");
+    const defaults = jsonCopy(definition.state);
+    if (!defaults || typeof defaults !== "object" || Array.isArray(defaults))
+        throw new Error("Native state must be a JSON object");
+    const schema = Object.keys(defaults).sort();
+    schema.forEach(assertName);
+    const saved = options.store?.read(key);
+    if (saved && (saved.definition !== definition.id || saved.version !== definition.version || JSON.stringify(Object.keys(saved.state).sort()) !== JSON.stringify(schema)))
+        throw new Error("Incompatible native checkpoint; explicitly migrate or reset it");
+    const overrides = options.initialState ? jsonCopy(options.initialState) : {};
+    if (Object.keys(overrides).some(name => !schema.includes(name)))
+        throw new Error("Native initial state cannot introduce undeclared cells");
+    const initial = saved ? jsonCopy(saved.state) : { ...defaults, ...overrides };
+    const registry = AtomRegistry.make();
+    const cells = new Map(schema.map(name => [name, Atom.make(initial[name]).pipe(Atom.keepAlive)]));
+    const token = {};
+    const claims = [];
+    const abort = new AbortController();
+    const signal = AbortSignal.any([context.signal, abort.signal]);
+    const timeout = options.timeoutMs ?? 10_000;
+    if (!Number.isFinite(timeout) || timeout <= 0) {
+        registry.dispose();
+        throw new Error("Native timeout must be positive");
+    }
+    let props = jsonCopy(options.props ?? {});
+    let disposed = false;
+    if (definition.activation && !["interaction", "load", "idle", "visible"].includes(definition.activation)) {
+        registry.dispose();
+        throw new Error("Unknown native activation policy");
+    }
+    const cleanups = [];
+    const report = (error) => { try {
+        (options.onError ?? console.error)(error);
+    }
+    catch (error) {
+        console.error(error);
+    } };
+    const elements = (selector) => {
+        const found = [...(host.matches(selector) ? [host] : []), ...host.querySelectorAll(selector)];
+        if (!found.length)
+            throw new Error(`Native binding selector has no match: ${selector}`);
+        for (const element of found) {
+            const boundary = element.closest('[data-fuzor-ui],fuzor-island,fuzor-client,fuzor-fragment,fuzor-boundary');
+            if (boundary && boundary !== host && host.contains(boundary))
+                throw new Error("Native binding crosses another UI owner");
+            for (let parent = element; parent && parent !== host; parent = parent.parentElement)
+                if (instances.has(parent) || context.childHosts?.includes(parent) || foreignRoot(parent))
+                    throw new Error("Native binding crosses a child instance or UI owner");
+        }
+        return found;
+    };
+    const get = (name) => { const cell = cells.get(name); if (!cell)
+        throw new Error(`Unknown native state: ${name}`); return jsonCopy(registry.get(cell)); };
+    const set = (name, value) => {
+        if (signal.aborted)
+            return;
+        const cell = cells.get(name);
+        if (!cell)
+            throw new Error(`Unknown native state: ${name}`);
+        const next = jsonCopy(value);
+        for (const binding of definition.bindings)
+            if (binding.state === name) {
+                if (binding.kind === "checked" && typeof next !== "boolean")
+                    throw new Error("Checked state must be boolean");
+                if (binding.kind !== "checked")
+                    scalar(next);
+            }
+        registry.set(cell, next);
+        apply();
+    };
+    let bound = [];
+    const apply = () => {
+        for (const { binding, elements } of bound) {
+            const value = get(binding.state);
+            for (const element of elements) {
+                if (binding.kind === "checked")
+                    element.checked = value === true;
+                else if (binding.kind === "value") {
+                    const field = element;
+                    const text = scalar(value);
+                    if (field.value !== text)
+                        field.value = text;
+                }
+                else if (binding.kind === "attribute") {
+                    if (value === null || value === false && ["hidden", "disabled"].includes(binding.attribute))
+                        element.removeAttribute(binding.attribute);
+                    else
+                        element.setAttribute(binding.attribute, scalar(value));
+                }
+                else
+                    element.textContent = (binding.prefix ?? "") + scalar(value) + (binding.suffix ?? "");
+            }
+        }
+    };
+    const snapshot = () => ({ key, definition: definition.id, version: definition.version, state: jsonCopy(Object.fromEntries([...cells].map(([name, cell]) => [name, registry.get(cell)]))) });
+    const validateRestore = (entry) => {
+        if (disposed || entry.key !== key || entry.definition !== definition.id || entry.version !== definition.version || JSON.stringify(Object.keys(entry.state).sort()) !== JSON.stringify(schema))
+            throw new Error("Incompatible native checkpoint");
+        const state = jsonCopy(entry.state);
+        for (const binding of definition.bindings) {
+            if (binding.kind === "checked" && typeof state[binding.state] !== "boolean")
+                throw new Error("Checked state must be boolean");
+            if (binding.kind !== "checked")
+                scalar(state[binding.state]);
+        }
+    };
+    const instance = { host, key, snapshot, validateRestore, update(next) { if (disposed)
+            throw new Error("Native instance disposed"); props = jsonCopy(next); apply(); }, restore(entry) {
+            validateRestore(entry);
+            const state = jsonCopy(entry.state);
+            for (const [name, cell] of cells)
+                registry.set(cell, state[name]);
+            apply();
+        }, dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            options.store?.release(instance);
+            abort.abort();
+            for (const cleanup of cleanups)
+                cleanup();
+            for (const [element, binding] of claims) {
+                const owners = bindingOwners.get(element);
+                if (owners?.get(binding) === token)
+                    owners.delete(binding);
+            }
+            if (instances.get(host) === instance)
+                instances.delete(host);
+            registry.dispose();
+        } };
+    try {
+        if (signal.aborted)
+            throw new Error("Native instance canceled");
+        bound = definition.bindings.map(binding => {
+            if (!cells.has(binding.state))
+                throw new Error(`Unknown native binding state: ${binding.state}`);
+            if (!["text", "value", "checked", "attribute"].includes(binding.kind))
+                throw new Error("Unknown native binding kind");
+            if (binding.prefix !== undefined && typeof binding.prefix !== "string" || binding.suffix !== undefined && typeof binding.suffix !== "string")
+                throw new Error("Native binding prefixes and suffixes must be strings");
+            if (binding.kind === "checked" && typeof initial[binding.state] !== "boolean")
+                throw new Error("Checked state must be boolean");
+            if (binding.kind !== "checked")
+                scalar(initial[binding.state]);
+            if (binding.kind === "attribute" && (!binding.attribute || !/^(?:aria-[a-z-]+|data-[a-z-]+|title|hidden|disabled)$/.test(binding.attribute)))
+                throw new Error("Unsupported native attribute binding");
+            const found = elements(binding.selector);
+            for (const element of found) {
+                if (binding.kind === "value" && element.hasAttribute("data-fuzor-state") || binding.kind === "checked" && element.hasAttribute("data-fuzor-checked") || binding.kind === "text" && (element.hasAttribute("data-fuzor-state") || element.hasAttribute("data-fuzor-text") || element.hasAttribute("data-fuzor-slot")))
+                    throw new Error("Native binding conflicts with a server fragment binding");
+                if (binding.kind === "value" && !element.matches('input,textarea,select'))
+                    throw new Error("Value bindings require form fields");
+                if (binding.kind === "checked" && !element.matches('input[type=checkbox]'))
+                    throw new Error("Checked bindings require checkboxes");
+                if (binding.kind === "text" && element.children.length)
+                    throw new Error("Native text bindings must not replace child elements");
+                const name = binding.kind === "attribute" ? `attribute:${binding.attribute}` : binding.kind;
+                const owners = bindingOwners.get(element) ?? new Map();
+                if (owners.has(name))
+                    throw new Error("Native binding already has an owner");
+                owners.set(name, token);
+                bindingOwners.set(element, owners);
+                claims.push([element, name]);
+                if (binding.kind === "value") {
+                    const field = element;
+                    if ("defaultValue" in field && field.value !== field.defaultValue)
+                        registry.set(cells.get(binding.state), field.value);
+                    if (element.localName === "select") {
+                        const select = element;
+                        if (select.multiple)
+                            throw new Error("Native value bindings require single-value fields");
+                        const original = [...select.options].find(option => option.defaultSelected)?.value ?? select.options[0]?.value ?? "";
+                        if (select.value !== original)
+                            registry.set(cells.get(binding.state), select.value);
+                    }
+                }
+                if (binding.kind === "checked") {
+                    const field = element;
+                    if (field.checked !== field.defaultChecked)
+                        registry.set(cells.get(binding.state), field.checked);
+                }
+            }
+            return { binding, elements: found };
+        });
+        let queue = Promise.resolve();
+        for (const event of definition.events) {
+            if (!eventTypes.has(event.type) || (event.load ? typeof event.load !== "function" : typeof event.handler !== "function") || event.preventDefault !== undefined && typeof event.preventDefault !== "boolean")
+                throw new Error("Unsupported native event or missing handler");
+            const targets = new Set(elements(event.selector));
+            let pending;
+            const listener = (original) => {
+                let element = original.target;
+                while (element && element !== host && !targets.has(element))
+                    element = element.parentElement;
+                if (!element || !targets.has(element) || signal.aborted)
+                    return;
+                const eventElement = element;
+                if (event.preventDefault)
+                    original.preventDefault();
+                const field = original.target;
+                const details = {};
+                for (const name of ["key", "code", "repeat", "button", "buttons", "clientX", "clientY", "pointerId", "pointerType", "altKey", "ctrlKey", "metaKey", "shiftKey"]) {
+                    const value = original[name];
+                    if (typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value))
+                        details[name] = value;
+                }
+                const snapshot = { type: original.type, ...("value" in field ? { value: field.value } : {}), ...("checked" in field ? { checked: field.checked } : {}), ...details };
+                queue = queue.then(async () => {
+                    if (signal.aborted)
+                        return;
+                    const operation = new AbortController();
+                    const operationSignal = AbortSignal.any([signal, operation.signal]);
+                    let timer;
+                    let canceled = () => { };
+                    try {
+                        const work = async () => {
+                            pending ??= event.load ? event.load().then(module => module.default) : Promise.resolve(event.handler);
+                            const handler = await pending;
+                            if (!operationSignal.aborted)
+                                await handler({ element: eventElement, event: snapshot, signal: operationSignal, props, get, set: (name, value) => { if (!operationSignal.aborted)
+                                        set(name, value); } });
+                        };
+                        await Promise.race([work(), new Promise((_, reject) => {
+                                canceled = () => reject(new Error("Native handler canceled"));
+                                operationSignal.addEventListener("abort", canceled, { once: true });
+                                timer = setTimeout(() => reject(new Error("Native handler deadline exceeded")), timeout);
+                            })]);
+                    }
+                    catch (error) {
+                        pending = undefined;
+                        if (!signal.aborted)
+                            report(error);
+                    }
+                    finally {
+                        clearTimeout(timer);
+                        operationSignal.removeEventListener("abort", canceled);
+                        operation.abort();
+                    }
+                });
+            };
+            host.addEventListener(event.type, listener);
+            cleanups.push(() => host.removeEventListener(event.type, listener));
+            const preload = () => { pending ??= event.load ? Promise.resolve().then(event.load).then(module => module.default) : Promise.resolve(event.handler); void pending.catch(error => { pending = undefined; report(error); }); };
+            if (definition.activation === "load")
+                preload();
+            if (definition.activation === "idle") {
+                const window = host.ownerDocument.defaultView;
+                if (window?.requestIdleCallback) {
+                    const id = window.requestIdleCallback(() => { if (!signal.aborted)
+                        preload(); });
+                    cleanups.push(() => window.cancelIdleCallback(id));
+                }
+                else {
+                    const timer = setTimeout(() => { if (!signal.aborted)
+                        preload(); }, 50);
+                    cleanups.push(() => clearTimeout(timer));
+                }
+            }
+            if (definition.activation === "visible") {
+                const Observer = host.ownerDocument.defaultView?.IntersectionObserver;
+                if (Observer) {
+                    const observer = new Observer(entries => { if (entries.some(entry => entry.isIntersecting)) {
+                        observer.disconnect();
+                        if (!signal.aborted)
+                            preload();
+                    } });
+                    observer.observe(host);
+                    cleanups.push(() => observer.disconnect());
+                }
+            }
+        }
+        options.store?.claim(instance);
+        instances.set(host, instance);
+        apply();
+        signal.addEventListener("abort", instance.dispose, { once: true });
+        cleanups.push(() => signal.removeEventListener("abort", instance.dispose));
+        context.onCleanup(instance.dispose);
+        return instance;
+    }
+    catch (error) {
+        instance.dispose();
+        throw error;
+    }
+}
+/** Explicit native adapter for persistent server-component client boundaries. */
+export function nativeClient(definition, options = {}) {
+    return { mountPersistent(host, props, operation) {
+            const controller = new AbortController();
+            // Operation signals bound mounting; the client's lifetime ends on dispose,
+            // not when the initial renderer commit is superseded by a later update.
+            if (operation?.signal.aborted)
+                throw new Error("Native client mount canceled");
+            const key = host.getAttribute("data-fuzor-key") ?? host.id;
+            const scopedKey = operation?.scope ? operation.scope + ":" + key : key;
+            const initialState = options.store?.read(scopedKey) ? undefined : options.initialState?.(jsonCopy(props));
+            const instance = mountNative(host, definition, { signal: controller.signal, onCleanup: () => { } }, { ...(options.store ? { store: options.store } : {}), ...(initialState ? { initialState } : {}), props, key: scopedKey });
+            return { update: (next) => instance.update(next), dispose() { controller.abort(); instance.dispose(); } };
+        } };
+}
+//# sourceMappingURL=native.js.map