ilha 0.14.4 → 0.14.6

package/README.md

@@ -60,7 +60,7 @@ const total = atom(
 );
 ```
 
-Wrap multiple writes in `batch()`. Derived and mutation atoms use Effect's `Atom.map`, `Atom.transform`, and `Atom.fn` — pass `handle.atom`, then wrap in `atom()`. Use `watch(source, fn)` for side effects on atom changes.
+Wrap multiple writes in `batch()`. Derived and mutation atoms use Effect's `Atom.map`, `Atom.transform`, and `Atom.fn` — pass `handle.atom`, then wrap in `atom()`. Use `watch(source, fn)` for side effects on atom changes. Use `watch.once(fn)` for mount-only work; return a cleanup function to run on unmount. Use `untrack(() => …)` to read without subscribing. Share values with `createContext` / `context()`. Catch subtree failures with `ErrorBoundary`.
 
 Use `atom.lazy(() => …)` for one-time initialization or to store a function value.
 

package/dist/define.d.ts

@@ -1,4 +1,4 @@
-import { n as Component } from "./types-DQVTD0ts.js";
+import { n as Component } from "./types-CyoYWhJf.js";
 //#region src/define.d.ts
 declare const define: (name: string, component: Component) => void;
 //#endregion

package/dist/define.js

@@ -1,4 +1,4 @@
-import { t as mount } from "./mount-hD-OyLIo.js";
+import { t as mount } from "./mount-DiIEX8s7.js";
 
 //#region src/define.ts
 const define = (name, component) => {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as Instruction, c as View, i as Fragment, l as Yielded, n as Component, t as AtomHandle } from "./types-DQVTD0ts.js";
-import { t as h } from "./vnode-DHBqDHtZ.js";
+import { a as Instruction, c as UnsafeHtml, d as Yielded, i as Fragment, n as Component, t as AtomHandle, u as View } from "./types-CyoYWhJf.js";
+import { t as h } from "./vnode-C_BdUnIA.js";
 import * as Effect from "effect/Effect";
 import * as Stream from "effect/Stream";
 import * as Atom from "effect/unstable/reactivity/Atom";
@@ -11,10 +11,17 @@ type WatchValue = string | number | boolean | bigint | null | undefined | readon
 interface WatchRecord {
   readonly [key: string]: WatchValue | undefined;
 }
-/** Run `fn` when `source` changes — and once on mount. Sync, async, and generator components. */
-declare const watch: <A extends WatchValue>(source: AtomHandle<A> | Atom.Atom<A> | Stream.Stream<A, unknown, unknown>, fn: (value: A) => void) => Instruction<undefined>;
+/** Optional disposer returned from `watch.once`. */
+type WatchOnceCleanup = () => void;
+interface WatchFn {
+  <A extends WatchValue>(source: AtomHandle<A> | Atom.Atom<A> | Stream.Stream<A, unknown, unknown>, fn: (value: A) => void): Instruction<undefined>;
+  once: (fn: () => WatchOnceCleanup | undefined) => Instruction<undefined>;
+}
+declare const watch: WatchFn;
 //#endregion
 //#region src/atom.d.ts
+/** Read atoms inside `fn` without subscribing the active render. Sync only. */
+declare const untrack: <A>(fn: () => A) => A;
 interface AtomFn {
   <A>(init: A | Atom.Atom<A> | Effect.Effect<A, unknown, AtomRegistry> | Stream.Stream<A, unknown, AtomRegistry>): AtomHandle<A>;
   lazy: <A>(init: () => A) => AtomHandle<A>;
@@ -22,6 +29,34 @@ interface AtomFn {
 declare const atom: AtomFn;
 declare const batch: (f: () => void) => void;
 //#endregion
+//#region src/context.d.ts
+interface ContextProviderProps<A> {
+  value: A;
+  children?: View;
+}
+interface IlhaContext<A> {
+  readonly id: symbol;
+  readonly defaultValue: A;
+  readonly Provider: (props: ContextProviderProps<A>) => View;
+}
+declare const createContext: <A>(defaultValue: A) => IlhaContext<A>;
+/** Read a context value as an atom handle. Subscribes the active fiber on read. */
+declare const context: <A>(ctx: IlhaContext<A>) => AtomHandle<A>;
+//#endregion
+//#region src/error-boundary.d.ts
+interface ErrorFallbackProps {
+  error: Error;
+  reset: () => void;
+}
+type ErrorFallback = (props: ErrorFallbackProps) => View;
+interface ErrorBoundaryProps {
+  fallback?: ErrorFallback;
+  onError?: (error: Error) => void;
+  children?: View;
+}
+/** Catch subtree failures and paint a fallback. Supports reset(). */
+declare const ErrorBoundary: (props: ErrorBoundaryProps) => View;
+//#endregion
 //#region src/when.d.ts
 declare const when: <A, E = never, R = never>(stream: Stream.Stream<A, E, R>, body: (value: A) => Generator<Yielded, View | undefined, View>) => Instruction<undefined, E>;
 //#endregion
@@ -39,4 +74,15 @@ interface MountOptions {
 declare const mount: (el: Element, fn: Component, opts?: MountOptions) => (() => void);
 declare const renderToString: (fn: Component, opts?: RenderToStringOptions) => Promise<string>;
 //#endregion
-export { type AtomHandle, type Component, Fragment, type MountOptions, type RenderToStringOptions, type View, atom, batch, h, mount, renderToString, watch, when };
+//#region src/unsafe.d.ts
+/**
+ * Mark a string as pre-rendered HTML and paint it without escaping.
+ * Use it for markup you built or sanitized yourself — SVG from an external
+ * library, Markdown rendered to HTML, embed codes. Never pass untrusted
+ * user input: unlike interpolated strings, this content is not escaped and
+ * scripts inserted this way do not run, but event attributes and other
+ * markup still apply.
+ */
+declare const unsafe: (html: string) => UnsafeHtml;
+//#endregion
+export { type AtomHandle, type Component, type ContextProviderProps, ErrorBoundary, type ErrorBoundaryProps, type ErrorFallback, type ErrorFallbackProps, Fragment, type IlhaContext, type MountOptions, type RenderToStringOptions, type UnsafeHtml, type View, type WatchOnceCleanup, atom, batch, context, createContext, h, mount, renderToString, unsafe, untrack, watch, when };

package/dist/index.js

@@ -1,13 +1,82 @@
-import { a as batch, c as isAtomHandle, d as makeFiber, i as atom, l as closeFiber, n as renderToString, o as handleOwner, r as interpret, s as instr, t as mount, u as getFiber } from "./mount-hD-OyLIo.js";
-import { i as Fragment, t as h } from "./vnode-DP76Gn-b.js";
+import { a as interpret, c as handleOwner, d as untrack, f as wrapHandle, g as makeFiber, h as getFiber, i as runSetup, l as instr, m as closeFiber, n as renderToString, o as atom, p as clearFiberView, r as unsafe, s as batch, t as mount, u as isAtomHandle } from "./mount-DiIEX8s7.js";
+import { d as errorView, i as Fragment, p as isFunction, t as h } from "./vnode-DEMDQ0eA.js";
 import * as Effect from "effect/Effect";
 import * as Stream from "effect/Stream";
+import * as Atom from "effect/unstable/reactivity/Atom";
 import * as Exit from "effect/Exit";
 import * as Fiber from "effect/Fiber";
 import * as Scope from "effect/Scope";
 import * as Registry from "effect/unstable/reactivity/AtomRegistry";
 
+//#region src/context.ts
+const defaults = /* @__PURE__ */ new WeakMap();
+const getDefaultAtom = (ctx) => {
+	const existing = defaults.get(ctx);
+	if (existing) return existing;
+	const made = Atom.make(ctx.defaultValue);
+	defaults.set(ctx, made);
+	return made;
+};
+const createContext = (defaultValue) => {
+	const id = Symbol("ilha.context");
+	const Provider = (props) => {
+		const fiber = getFiber();
+		const { value: next, children } = props;
+		const handle = atom(next);
+		if (!Object.is(untrack(() => handle()), next)) handle.set(next);
+		fiber.contexts ??= /* @__PURE__ */ new Map();
+		fiber.contexts.set(id, handle.atom);
+		return children;
+	};
+	return {
+		Provider,
+		defaultValue,
+		id
+	};
+};
+/** Read a context value as an atom handle. Subscribes the active fiber on read. */
+const context = (ctx) => {
+	const fiber = getFiber();
+	let current = fiber;
+	while (current) {
+		const found = current.contexts?.get(ctx.id);
+		if (found) return wrapHandle(found, fiber);
+		current = current.parent;
+	}
+	return wrapHandle(getDefaultAtom(ctx), fiber);
+};
+
+//#endregion
+//#region src/error-boundary.ts
+/** Catch subtree failures and paint a fallback. Supports reset(). */
+const ErrorBoundary = (props) => {
+	const fiber = getFiber();
+	const remount = () => {
+		if (fiber.closed) return;
+		clearFiberView(fiber);
+		const current = fiber.propsBox?.current ?? props;
+		runSetup(fiber, () => ErrorBoundary(current));
+	};
+	fiber.handleError = (error) => {
+		if (fiber.closed) return;
+		clearFiberView(fiber);
+		const { onError, fallback } = fiber.propsBox?.current ?? props;
+		if (isFunction(onError)) onError(error);
+		if (isFunction(fallback)) {
+			fiber.paint(fallback({
+				error,
+				reset: remount
+			}));
+			return;
+		}
+		fiber.paint(errorView(error));
+	};
+	return props.children;
+};
+
+//#endregion
 //#region src/watch.ts
+const WATCH_ONCE = Symbol("ilha.watch.once");
 const runStreamWatch = (fiber, effect) => {
 	const scope = Scope.forkUnsafe(fiber.scope);
 	const provided = effect.pipe(Effect.provideService(Registry.AtomRegistry, fiber.registry));
@@ -24,7 +93,7 @@ const useWatchSlot = (fiber, key, mount, fn) => {
 	const existing = fiber.watchSlots[i];
 	if (existing) {
 		if (existing.key === key) {
-			existing.fnRef.current = fn;
+			if (existing.fnRef) existing.fnRef.current = fn;
 			return;
 		}
 		existing.dispose();
@@ -58,12 +127,36 @@ const registerWatch = (fiber, source, fn) => {
 	const atom = isAtomHandle(source) ? source.atom : source;
 	useWatchSlot(fiber, atom, (run) => fiber.registry.subscribe(atom, run, { immediate: true }), fn);
 };
+/** Run `fn` once on mount. Return a function to clean up on unmount. */
+const watchOnce = (fn) => {
+	const fiber = getFiber();
+	const i = fiber.watchI ?? 0;
+	fiber.watchI = i + 1;
+	fiber.watchSlots ??= [];
+	const existing = fiber.watchSlots[i];
+	if (existing) {
+		if (existing.key === WATCH_ONCE) return instr(Effect.void);
+		existing.dispose();
+		fiber.watchSlots[i] = void 0;
+	}
+	let cleanup = fn();
+	fiber.watchSlots[i] = {
+		dispose: () => {
+			const run = cleanup;
+			cleanup = void 0;
+			run?.();
+		},
+		key: WATCH_ONCE
+	};
+	return instr(Effect.void);
+};
 /** Run `fn` when `source` changes — and once on mount. Sync, async, and generator components. */
-const watch = (source, fn) => {
+const watchSource = (source, fn) => {
 	const fiber = (isAtomHandle(source) ? handleOwner.get(source) : void 0) ?? getFiber();
 	registerWatch(fiber, source, fn);
 	return instr(Effect.void);
 };
+const watch = Object.assign(watchSource, { once: watchOnce });
 
 //#endregion
 //#region src/when.ts
@@ -78,10 +171,13 @@ const when = (stream, body) => instr(Effect.gen(function* whenBody() {
 	const src = parent.runtime.ssr ? base.pipe(Stream.take(1)) : base;
 	yield* Stream.runForEach(src, (value) => Effect.sync(() => {
 		if (child) closeFiber(child);
-		child = makeFiber(parent.runtime, parent.root, parent.paintFn, { onFail: parent.fail });
+		child = makeFiber(parent.runtime, parent.root, parent.paintFn, {
+			onFail: parent.fail,
+			parent
+		});
 		interpret((() => body(value)), child);
 	}));
 }));
 
 //#endregion
-export { Fragment, atom, batch, h, mount, renderToString, watch, when };
+export { ErrorBoundary, Fragment, atom, batch, context, createContext, h, mount, renderToString, unsafe, untrack, watch, when };

package/dist/jsx-dev-runtime.d.ts

@@ -1,4 +1,4 @@
-import { i as Fragment } from "./types-DQVTD0ts.js";
-import { n as JSX } from "./vnode-DHBqDHtZ.js";
+import { i as Fragment } from "./types-CyoYWhJf.js";
+import { n as JSX } from "./vnode-C_BdUnIA.js";
 import { jsx, jsxDEV, jsxs } from "./jsx-runtime.js";
 export { Fragment, type JSX, jsx, jsxDEV, jsxs };

package/dist/jsx-dev-runtime.js

@@ -1,4 +1,4 @@
-import { i as Fragment } from "./vnode-DP76Gn-b.js";
+import { i as Fragment } from "./vnode-DEMDQ0eA.js";
 import { jsx, jsxDEV, jsxs } from "./jsx-runtime.js";
 
 export { Fragment, jsx, jsxDEV, jsxs };

package/dist/jsx-runtime.d.ts

@@ -1,8 +1,8 @@
-import { c as View, i as Fragment, o as PropBag, r as ComponentFn } from "./types-DQVTD0ts.js";
-import { n as JSX, t as h } from "./vnode-DHBqDHtZ.js";
+import { i as Fragment, o as JsxComponent, r as ComponentFn, s as PropBag, u as View } from "./types-CyoYWhJf.js";
+import { n as JSX, t as h } from "./vnode-C_BdUnIA.js";
 //#region src/jsx-runtime.d.ts
-declare const jsx: (type: string | Fragment | ComponentFn, props: PropBag | null, key?: string | number) => ReturnType<typeof h>;
-declare const jsxs: (type: string | Fragment | ComponentFn, props: PropBag | null, key?: string | number) => ReturnType<typeof h>;
-declare const jsxDEV: (type: string | Fragment | ComponentFn, props: PropBag | null, key?: string | number) => ReturnType<typeof h>;
+declare const jsx: (type: string | Fragment | ComponentFn | JsxComponent, props: PropBag | null, key?: string | number) => ReturnType<typeof h>;
+declare const jsxs: (type: string | Fragment | ComponentFn | JsxComponent, props: PropBag | null, key?: string | number) => ReturnType<typeof h>;
+declare const jsxDEV: (type: string | Fragment | ComponentFn | JsxComponent, props: PropBag | null, key?: string | number) => ReturnType<typeof h>;
 //#endregion
 export { Fragment, type JSX, type View, h, jsx, jsxDEV, jsxs };

package/dist/jsx-runtime.js

@@ -1,4 +1,4 @@
-import { i as Fragment, t as h } from "./vnode-DP76Gn-b.js";
+import { i as Fragment, t as h } from "./vnode-DEMDQ0eA.js";
 
 //#region src/jsx-runtime.ts
 const jsx = (type, props, key) => h(type, key === void 0 ? props : {

package/dist/{mount-hD-OyLIo.js → mount-DiIEX8s7.js}

@@ -1,4 +1,4 @@
-import { _ as skip, a as ISLAND, b as failureMessage, c as KEEP, d as errorView, f as isBigInt, g as isString, h as isObject, i as Fragment, l as KEY_ATTR, m as isNumber, n as isSetupFn, o as ISLAND_MOUNT_INTERNAL, p as isFunction, r as isVNode, s as ISLAND_SLOT_TAG, u as SLOT_ATTR, v as unwrap, y as asFailure } from "./vnode-DP76Gn-b.js";
+import { _ as skip, a as ISLAND, b as failureMessage, c as KEEP, d as errorView, f as isBigInt, g as isString, h as isObject, i as Fragment, l as KEY_ATTR, m as isNumber, n as isSetupFn, o as ISLAND_MOUNT_INTERNAL, p as isFunction, r as isVNode, s as ISLAND_SLOT_TAG, u as SLOT_ATTR, v as unwrap, x as toError, y as asFailure } from "./vnode-DEMDQ0eA.js";
 import * as Effect from "effect/Effect";
 import * as Stream from "effect/Stream";
 import * as Atom from "effect/unstable/reactivity/Atom";
@@ -34,17 +34,27 @@ const runInScope = (effect, registry, scope, onOk, onErr, onDone) => {
 	}))) : provided);
 	Effect.runSync(Scope.addFinalizer(scope, Fiber.interrupt(f)));
 };
-const closeFiber = (fiber) => {
-	if (fiber.closed) return;
-	fiber.closed = true;
-	fiber.trackRestore?.();
-	fiber.trackRestore = void 0;
+/** Clear render subscriptions and child holes without closing the fiber scope. */
+const clearFiberView = (fiber) => {
 	fiber.renderSub?.();
 	fiber.renderSub = void 0;
 	for (const slot of fiber.watchSlots ?? []) slot?.dispose();
 	fiber.watchSlots = [];
+	fiber.watchI = 0;
+	fiber.primitives = void 0;
+	fiber.primitiveI = 0;
+	fiber.islandFrame = void 0;
+	fiber.keyedHoles = void 0;
 	for (const h of fiber.holes) h.dispose();
 	fiber.holes = [];
+};
+const closeFiber = (fiber) => {
+	if (fiber.closed) return;
+	fiber.closed = true;
+	fiber.trackRestore?.();
+	fiber.trackRestore = void 0;
+	fiber.handleError = void 0;
+	clearFiberView(fiber);
 	Effect.runFork(Scope.close(fiber.scope, Exit.void));
 };
 const makeRuntime = (opts) => {
@@ -107,6 +117,7 @@ const makeFiber = (runtime, root, paint, opts) => {
 		inFlight: false,
 		paint: (view) => paint(fiber, view),
 		paintFn: paint,
+		parent: opts?.parent,
 		registry: runtime.registry,
 		root,
 		run: (effect, onOk, onErr) => {
@@ -123,6 +134,19 @@ const makeFiber = (runtime, root, paint, opts) => {
 	};
 	return fiber;
 };
+/** Walk this fiber and ancestors for an error boundary handler. */
+const reportFiberError = (fiber, error) => {
+	let current = fiber;
+	while (current) {
+		const { handleError } = current;
+		if (handleError) {
+			handleError(error);
+			return true;
+		}
+		current = current.parent;
+	}
+	return false;
+};
 
 //#endregion
 //#region src/atom.ts
@@ -161,6 +185,16 @@ const instr = (effect) => {
 const isAtomHandle = (x) => isFunction(x) && x.$$atom === 1;
 let trackGet;
 const trackStack = [];
+/** Read atoms inside `fn` without subscribing the active render. Sync only. */
+const untrack = (fn) => {
+	const prev = trackGet;
+	trackGet = void 0;
+	try {
+		return fn();
+	} finally {
+		trackGet = prev;
+	}
+};
 const beginPrimitiveFrame = (fiber) => {
 	const used = fiber.primitiveI ?? 0;
 	const slots = fiber.primitives?.length ?? 0;
@@ -377,6 +411,60 @@ const interpret = (gen, fiber) => {
 	resume();
 };
 
+//#endregion
+//#region src/start.ts
+const isGen = (x) => {
+	if (x === null || x === void 0) return false;
+	const g = x;
+	return isFunction(g.next) && isFunction(g.throw);
+};
+const finish = (fiber, view) => {
+	if (fiber.closed) return;
+	if (view !== void 0) fiber.paint(view);
+};
+const runSetup = (fiber, fn) => {
+	const disposeRenderSub = () => {
+		fiber.renderSub?.();
+		fiber.renderSub = void 0;
+	};
+	const api = {
+		commit: (out, deps) => {
+			if (isGen(out)) {
+				disposeRenderSub();
+				interpret((() => out), fiber);
+				return;
+			}
+			disposeRenderSub();
+			if (!fiber.runtime.ssr) fiber.renderSub = subscribeRenderDeps(fiber, deps, () => api.render());
+			withFiber(fiber, () => {
+				finish(fiber, out);
+			});
+		},
+		render: () => {
+			if (fiber.closed) return;
+			fiber.runtime.begin();
+			beginPrimitiveFrame(fiber);
+			withTrackGetRun(fiber, () => fn(), ({ value: out, deps }) => {
+				try {
+					api.commit(out, deps);
+				} catch (error) {
+					withFiber(fiber, () => fiber.fail(asFailure(error)));
+				} finally {
+					fiber.runtime.end();
+				}
+			}, (e) => {
+				withFiber(fiber, () => fiber.fail(asFailure(e)));
+				fiber.runtime.end();
+			});
+		}
+	};
+	try {
+		api.render();
+	} catch (error) {
+		fiber.fail(asFailure(error));
+	}
+};
+
 //#endregion
 //#region src/events.ts
 const ACTION_CALL$1 = Symbol.for("ilha.actionCall");
@@ -538,8 +626,13 @@ const morphElementPair = (fromEl, toEl, api) => {
 		fromEl.replaceWith(toEl);
 		return;
 	}
-	const slotId = toEl.getAttribute(SLOT_ATTR);
-	if (slotId !== null && fromEl.getAttribute("data-ilha-slot") === slotId) return;
+	const toSlot = toEl.getAttribute(SLOT_ATTR);
+	const fromSlot = fromEl.getAttribute(SLOT_ATTR);
+	if (toSlot !== null && fromSlot === toSlot) return;
+	if (toSlot !== null) {
+		fromEl.replaceWith(toEl);
+		return;
+	}
 	if (fromEl.localName === "input") {
 		morphInput(fromEl, toEl);
 		return;
@@ -692,57 +785,22 @@ const serializeStyleAttr = (value) => {
 };
 
 //#endregion
-//#region src/start.ts
-const isGen = (x) => {
-	if (x === null || x === void 0) return false;
-	const g = x;
-	return isFunction(g.next) && isFunction(g.throw);
-};
-const finish = (fiber, view) => {
-	if (fiber.closed) return;
-	if (view !== void 0) fiber.paint(view);
-};
-const runSetup = (fiber, fn) => {
-	const disposeRenderSub = () => {
-		fiber.renderSub?.();
-		fiber.renderSub = void 0;
-	};
-	const api = {
-		commit: (out, deps) => {
-			if (isGen(out)) {
-				disposeRenderSub();
-				interpret((() => out), fiber);
-				return;
-			}
-			disposeRenderSub();
-			if (!fiber.runtime.ssr) fiber.renderSub = subscribeRenderDeps(fiber, deps, () => api.render());
-			withFiber(fiber, () => {
-				finish(fiber, out);
-			});
-		},
-		render: () => {
-			if (fiber.closed) return;
-			fiber.runtime.begin();
-			beginPrimitiveFrame(fiber);
-			withTrackGetRun(fiber, () => fn(), ({ value: out, deps }) => {
-				try {
-					api.commit(out, deps);
-				} catch (error) {
-					withFiber(fiber, () => fiber.fail(asFailure(error)));
-				} finally {
-					fiber.runtime.end();
-				}
-			}, (e) => {
-				withFiber(fiber, () => fiber.fail(asFailure(e)));
-				fiber.runtime.end();
-			});
-		}
-	};
-	try {
-		api.render();
-	} catch (error) {
-		fiber.fail(asFailure(error));
-	}
+//#region src/unsafe.ts
+/**
+* Mark a string as pre-rendered HTML and paint it without escaping.
+* Use it for markup you built or sanitized yourself — SVG from an external
+* library, Markdown rendered to HTML, embed codes. Never pass untrusted
+* user input: unlike interpolated strings, this content is not escaped and
+* scripts inserted this way do not run, but event attributes and other
+* markup still apply.
+*/
+const unsafe = (html) => ({
+	$$ilhaUnsafe: 1,
+	html
+});
+const isUnsafeHtml = (x) => {
+	if (!isObject(x)) return false;
+	return x.$$ilhaUnsafe === 1;
 };
 
 //#endregion
@@ -862,10 +920,15 @@ const createPainter = (ops) => {
 		openHole: (parent) => {
 			const id = parent.runtime.nextHole();
 			const host = ops.createSlotHost(String(id));
-			const child = makeFiber(parent.runtime, ops.asRoot(host), (f, v) => api.paintHole(f, v), { onFail: (e) => {
-				console.error(e);
-				api.paintHole(child, errorView(e));
-			} });
+			const child = makeFiber(parent.runtime, ops.asRoot(host), (f, v) => api.paintHole(f, v), {
+				onFail: (e) => {
+					const error = toError(e);
+					if (reportFiberError(child, error)) return;
+					console.error(error);
+					api.paintHole(child, errorView(error));
+				},
+				parent
+			});
 			return {
 				fiber: child,
 				nodes: [host]
@@ -979,9 +1042,10 @@ const createPainter = (ops) => {
 		if (branded[ISLAND] === true) return materializeIsland(branded, props, fiber);
 		const k = view.key === null || view.key === void 0 ? void 0 : String(view.key);
 		const reuse = k ? fiber.keyedHoles?.get(k) : void 0;
+		const run = type;
 		if (reuse && !reuse.closed) {
 			if (reuse.propsBox) reuse.propsBox.current = props;
-			const next = withFiber(fiber, () => type(reuse.propsBox?.current ?? props));
+			const next = withFiber(fiber, () => run(reuse.propsBox?.current ?? props));
 			if (next && !isThenable(next) && !isSetupFn(next)) reuse.paint(next);
 			return [ops.asNode(reuse.root)];
 		}
@@ -995,7 +1059,7 @@ const createPainter = (ops) => {
 			if (hole.closed) return;
 			const box = hole.propsBox;
 			if (!box) return;
-			runSetup(hole, () => type(box.current));
+			runSetup(hole, () => run(box.current));
 		});
 		trackHole(fiber, hole, void 0, k ? { keyed: true } : void 0);
 		return nodes;
@@ -1021,6 +1085,7 @@ const createPainter = (ops) => {
 	};
 	paintFns.materialize = (view, fiber) => {
 		if (skip(view)) return [];
+		if (isUnsafeHtml(view)) return ops.createRaw(view.html, fiber.root);
 		if (isTextish(view)) return [ops.createText(String(view))];
 		if (isAtomHandle(view)) return materializeAtom(view, fiber);
 		if (Stream.isStream(view)) return materializeStream(view, fiber);
@@ -1081,6 +1146,11 @@ const core$1 = createPainter({
 		if (root instanceof Element) root.replaceChildren();
 	},
 	createElement: (tag) => document.createElement(tag),
+	createRaw: (html, parent) => {
+		const range = document.createRange();
+		range.selectNodeContents(parent);
+		return [...range.createContextualFragment(html).childNodes];
+	},
 	createSlotHost: (slotId) => {
 		const host = document.createElement("span");
 		if (slotId !== null) host.setAttribute(SLOT_ATTR, slotId);
@@ -1253,6 +1323,10 @@ const VOID = /* @__PURE__ */ new Set([
 const RAW_TEXT = /* @__PURE__ */ new Set(["script", "style"]);
 const escapeText = (s) => s.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 const escapeAttr = (s) => escapeText(s).replaceAll("\"", "&quot;");
+const createSsrRaw = (html) => ({
+	html,
+	kind: "raw"
+});
 const createSsrText = (text) => ({
 	kind: "text",
 	text
@@ -1263,6 +1337,7 @@ const serializeRawText = (tag, text) => {
 };
 const serializeNode = (node) => {
 	if (node.kind === "text") return escapeText(node.text);
+	if (node.kind === "raw") return node.html;
 	const parts = [];
 	for (const [name, value] of node.attrs) parts.push(`${name}="${escapeAttr(value)}"`);
 	const attr = parts.length > 0 ? ` ${parts.join(" ")}` : "";
@@ -1319,7 +1394,11 @@ const createSsrElement = (tag) => {
 		tag: lower,
 		tagName: lower.toUpperCase(),
 		get textContent() {
-			return children.map((n) => n.kind === "text" ? n.text : n.textContent).join("");
+			return children.map((n) => {
+				if (n.kind === "text") return n.text;
+				if (n.kind === "raw") return n.html;
+				return n.textContent;
+			}).join("");
 		},
 		set textContent(value) {
 			children.length = 0;
@@ -1390,6 +1469,7 @@ const ssrOps = {
 	bindEvents: bindSsrEvents,
 	clearRoot: (root) => ssrAs(root).replaceChildren(),
 	createElement: createSsrElement,
+	createRaw: (html, _parent) => [createSsrRaw(html)],
 	createSlotHost: (slotId) => {
 		const host = createSsrElement("span");
 		if (slotId !== null) host.setAttribute(SLOT_ATTR, slotId);
@@ -1516,4 +1596,4 @@ const renderToString = async (fn, opts) => {
 };
 
 //#endregion
-export { batch as a, isAtomHandle as c, makeFiber as d, atom as i, closeFiber as l, renderToString as n, handleOwner as o, interpret as r, instr as s, mount as t, getFiber as u };
+export { interpret as a, handleOwner as c, untrack as d, wrapHandle as f, makeFiber as g, getFiber as h, runSetup as i, instr as l, closeFiber as m, renderToString as n, atom as o, clearFiberView as p, unsafe as r, batch as s, mount as t, isAtomHandle as u };

package/dist/{types-DQVTD0ts.d.ts → types-CyoYWhJf.d.ts}

@@ -12,13 +12,20 @@ type EventHandler = (event: Event) => void;
 interface PropBag {
   readonly [key: string]: PropValue | undefined;
 }
-type View = VNode | JsonText | AtomHandle<unknown> | Stream.Stream<View, unknown, unknown> | GeneratorFn | Component | View[] | Iterable<View>;
+type View = VNode | UnsafeHtml | JsonText | AtomHandle<unknown> | Stream.Stream<View, unknown, unknown> | GeneratorFn | Component | View[] | Iterable<View>;
 declare const Fragment: unique symbol;
 type Fragment = typeof Fragment;
 type ComponentFn = (props: PropBag) => View | Promise<View | undefined> | undefined;
+/** JSX/tag component with its own props shape (Provider, ErrorBoundary, …). */
+type JsxComponent = (props: never) => View | Promise<View | undefined> | Generator<View, View | undefined, View> | undefined;
+/** Raw HTML view produced by `unsafe()` — painted without escaping. */
+interface UnsafeHtml {
+  readonly $$ilhaUnsafe: 1;
+  readonly html: string;
+}
 interface VNode {
   readonly $$ilha: 1;
-  readonly type: string | Fragment | ComponentFn;
+  readonly type: string | Fragment | ComponentFn | JsxComponent;
   readonly props: PropBag;
   readonly children: View[];
   readonly key?: string | number;
@@ -38,4 +45,4 @@ interface AtomHandle<A> {
   update: (f: (current: A) => A) => void;
 }
 //#endregion
-export { Instruction as a, View as c, Fragment as i, Yielded as l, Component as n, PropBag as o, ComponentFn as r, VNode as s, AtomHandle as t };
+export { Instruction as a, UnsafeHtml as c, Yielded as d, Fragment as i, VNode as l, Component as n, JsxComponent as o, ComponentFn as r, PropBag as s, AtomHandle as t, View as u };

package/dist/{vnode-DHBqDHtZ.d.ts → vnode-C_BdUnIA.d.ts}

@@ -1,8 +1,8 @@
-import { c as View, i as Fragment, o as PropBag, r as ComponentFn, s as VNode, t as AtomHandle } from "./types-DQVTD0ts.js";
+import { i as Fragment, l as VNode, o as JsxComponent, r as ComponentFn, s as PropBag, t as AtomHandle, u as View } from "./types-CyoYWhJf.js";
 //#region src/jsx-types.d.ts
 declare namespace JSX {
   export type Element = View;
-  export type ElementType = string | ((props: PropBag) => View | Promise<View | undefined> | Generator<View, View | undefined, View>);
+  export type ElementType = string | ((props: never) => View | Promise<View | undefined> | Generator<View, View | undefined, View> | undefined);
   export interface ElementChildrenAttribute {
     children: View;
   }
@@ -580,6 +580,6 @@ declare namespace JSX {
 }
 //#endregion
 //#region src/vnode.d.ts
-declare const h: (type: string | Fragment | ComponentFn, props: PropBag | null | undefined, ...rest: View[]) => VNode;
+declare const h: (type: string | Fragment | ComponentFn | JsxComponent, props: PropBag | null | undefined, ...rest: View[]) => VNode;
 //#endregion
 export { JSX as n, h as t };

package/dist/{vnode-DP76Gn-b.js → vnode-DEMDQ0eA.js}

@@ -10,10 +10,12 @@ const asFailure = (e) => {
 	}
 	return Result.fail(e instanceof Error ? e : new Error(String(e)));
 };
-const failureMessage = (e) => asFailure(e).pipe(Result.match({
-	onFailure: (err) => err.message,
-	onSuccess: () => "error"
+/** Normalize any thrown failure into an `Error` instance. */
+const toError = (e) => asFailure(e).pipe(Result.match({
+	onFailure: (err) => err,
+	onSuccess: () => /* @__PURE__ */ new Error("error")
 }));
+const failureMessage = (e) => toError(e).message;
 
 //#endregion
 //#region src/shared.ts
@@ -86,4 +88,4 @@ const isSetupFn = (x) => {
 };
 
 //#endregion
-export { skip as _, ISLAND as a, failureMessage as b, KEEP as c, errorView as d, isBigInt as f, isString as g, isObject as h, Fragment as i, KEY_ATTR as l, isNumber as m, isSetupFn as n, ISLAND_MOUNT_INTERNAL as o, isFunction as p, isVNode as r, ISLAND_SLOT_TAG as s, h as t, SLOT_ATTR as u, unwrap as v, asFailure as y };
+export { skip as _, ISLAND as a, failureMessage as b, KEEP as c, errorView as d, isBigInt as f, isString as g, isObject as h, Fragment as i, KEY_ATTR as l, isNumber as m, isSetupFn as n, ISLAND_MOUNT_INTERNAL as o, isFunction as p, isVNode as r, ISLAND_SLOT_TAG as s, h as t, SLOT_ATTR as u, unwrap as v, toError as x, asFailure as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ilha",
-  "version": "0.14.4",
+  "version": "0.14.6",
   "description": "Generator-first island UI on Effect",
   "keywords": [
     "effect",