ilha 0.11.0 → 0.11.1

package/README.md

@@ -331,7 +331,7 @@ Both the user-supplied cleanup function (if any) and the signal abort fire when
 
 ### `.onMount(fn)`
 
-Runs once after the island is mounted into the DOM. Receives `{ state, derived, input, host, hydrated }` where `hydrated` is `true` when the island was mounted over existing SSR content. Optionally returns a cleanup function called on unmount.
+Runs once after the island is mounted into the DOM. **Client-only** — SSR never invokes it (matching `.on()` and `.effect()`), so server-rendered markup must not depend on onMount side effects. Receives `{ state, derived, input, host, hydrated }` where `hydrated` is `true` when the island was mounted over existing SSR content. Optionally returns a cleanup function called on unmount.
 
 ```ts
 ilha
@@ -538,7 +538,8 @@ Use `await island(props)` instead when asynchronous derived values must settle b
 ```ts
 MyIsland.toString(); // always sync
 MyIsland.toString({ name: "Ilha" }); // with props
-await MyIsland({ name: "Ilha" }); // async — awaits derived
+await MyIsland.toStringAsync({ name: "Ilha" }); // async SSR — awaits async derived values
+await MyIsland({ name: "Ilha" }); // callable async form (also used for JSX/html slot composition)
 ```
 
 ---
@@ -666,6 +667,8 @@ theme("dark"); // → sets to "dark"
 Safe to call in both SSR and browser environments.
 
 > **`signal()` vs `context()`** — both return the same accessor shape and can be used with `bind:` template syntax. Use `signal()` for one-off shared state where you'd hold the reference yourself; use `context()` when you want a name-keyed registry so the same signal can be looked up from anywhere by string key.
+>
+> **SSR caveat** — `context()` is process-global, not request-scoped. It is safe to read in SSR **only for app-wide singletons** (theme, locale, feature flags). Per-request state (current user, session) must not live in `context()`: concurrent SSR requests would leak it across requests. Pass per-request data through island props / loaders or use `@ilha/router`'s request-scope instead.
 
 ---
 

package/dist/{index-Cx35Xugv.d.ts → index-DnoM0M8S.d.ts}

@@ -178,6 +178,12 @@ interface HydratableOptions {
 interface Island<TInput = Record<string, unknown>, _TStateMap extends Record<string, unknown> = Record<string, unknown>> {
   (props?: Partial<TInput>): string | Promise<string>;
   toString(props?: Partial<TInput>): string;
+  /**
+   * Async SSR: renders the island and awaits async `.derived()` values before
+   * returning the HTML string. Always returns a Promise — prefer this over
+   * `await island(props)` when you need the async SSR form by name.
+   */
+  toStringAsync(props?: Partial<TInput>): Promise<string>;
   mount(host: Element, props?: Partial<TInput>): () => void;
   hydratable(props: Partial<TInput>, options: HydratableOptions): Promise<string>;
   key(key: string): KeyedIsland<TInput>;
@@ -408,6 +414,7 @@ declare const ilha: RootBuilder & DirectIslandFactory & {
   };
   signal: typeof ilhaSignal;
   computed: typeof ilhaComputed;
+  morph: typeof morph;
   batch: typeof batch;
   untrack: typeof untrack;
   onUncaughtError: typeof onUncaughtError;

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { A as StreamFnContext, B as ilhaEffect, C as NativeEventModifier, D as SignalSetter, E as SignalAccessor, F as css, G as raw, H as morph, I as from, K as untrack, L as html, M as __ilhaJsxSlot, N as batch, O as SignalWriter, P as context, R as ilha, S as NativeEventHandler, T as RawHtml, U as mount, V as ilhaSignal, W as onUncaughtError, _ as IslandState, a as EffectContext, b as MountResult, c as ExternalSignal, d as HydratableOptions, f as ISLAND_MOUNT_HANDLES, g as IslandDerived, h as IslandActions, i as DerivedValue, j as __ilhaJsxEvent, k as StreamFn, l as HandlerContext, m as Island, n as ActionContext, o as ErrorContext, p as ISLAND_MOUNT_INTERNAL, r as DerivedAccessor, s as ErrorSource, t as ActionAccessor, u as HandlerContextFor, v as KeyedIsland, w as OnMountContext, x as NativeEventContext, y as MountOptions, z as ilhaComputed } from "./index-Cx35Xugv.js";
-export { ActionAccessor, ActionContext, DerivedAccessor, DerivedValue, EffectContext, ErrorContext, ErrorSource, ExternalSignal, HandlerContext, HandlerContextFor, HydratableOptions, ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, Island, IslandActions, IslandDerived, IslandState, KeyedIsland, MountOptions, MountResult, NativeEventContext, NativeEventHandler, NativeEventModifier, OnMountContext, RawHtml, SignalAccessor, SignalSetter, SignalWriter, StreamFn, StreamFnContext, __ilhaJsxEvent, __ilhaJsxSlot, batch, ilhaComputed as computed, context, css, ilha as default, ilhaEffect as effect, from, html, ilhaSignal, ilhaSignal as signal, morph, mount, onUncaughtError, raw, untrack };
+import { A as StreamFnContext, B as ilhaEffect, C as NativeEventModifier, D as SignalSetter, E as SignalAccessor, F as css, G as raw, H as morph, I as from, K as untrack, L as html, M as __ilhaJsxSlot, N as batch, O as SignalWriter, P as context, R as ilha, S as NativeEventHandler, T as RawHtml, U as mount, V as ilhaSignal, W as onUncaughtError, _ as IslandState, a as EffectContext, b as MountResult, c as ExternalSignal, d as HydratableOptions, f as ISLAND_MOUNT_HANDLES, g as IslandDerived, h as IslandActions, i as DerivedValue, j as __ilhaJsxEvent, k as StreamFn, l as HandlerContext, m as Island, n as ActionContext, o as ErrorContext, p as ISLAND_MOUNT_INTERNAL, r as DerivedAccessor, s as ErrorSource, t as ActionAccessor, u as HandlerContextFor, v as KeyedIsland, w as OnMountContext, x as NativeEventContext, y as MountOptions, z as ilhaComputed } from "./index-DnoM0M8S.js";
+export { ActionAccessor, ActionContext, DerivedAccessor, DerivedValue, EffectContext, ErrorContext, ErrorSource, ExternalSignal, HandlerContext, HandlerContextFor, HydratableOptions, ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, Island, IslandActions, IslandDerived, IslandState, KeyedIsland, MountOptions, MountResult, NativeEventContext, NativeEventHandler, NativeEventModifier, OnMountContext, RawHtml, SignalAccessor, SignalSetter, SignalWriter, StreamFn, StreamFnContext, __ilhaJsxEvent, __ilhaJsxSlot, batch, ilhaComputed as computed, context, css, ilhaEffect as effect, from, html, ilha, ilhaSignal, ilhaSignal as signal, morph, mount, onUncaughtError, raw, untrack };

package/dist/index.js

@@ -1690,8 +1690,10 @@ var IlhaBuilder = class IlhaBuilder {
 	input(initialOrSchema) {
 		let schema = null;
 		let defaultInput = null;
-		if (initialOrSchema !== void 0) if (isStandardSchema(initialOrSchema)) schema = initialOrSchema;
-		else defaultInput = initialOrSchema;
+		if (initialOrSchema !== void 0) {
+			if (isStandardSchema(initialOrSchema)) schema = initialOrSchema;
+			else defaultInput = initialOrSchema;
+		}
 		return new IlhaBuilder({
 			schema,
 			defaultInput,
@@ -1912,72 +1914,6 @@ var IlhaBuilder = class IlhaBuilder {
 				lookup
 			};
 		}
-		/** Detached host for SSR setup hooks; must not be `{}` (Areia/components call host.matches). */
-		function createSsrOnMountHost() {
-			if (typeof document !== "undefined") return document.createElement("div");
-			const stub = {
-				matches: () => false,
-				querySelector: () => null,
-				querySelectorAll: () => [],
-				setAttribute: () => {},
-				getAttribute: () => null,
-				removeAttribute: () => {},
-				appendChild: () => stub
-			};
-			return stub;
-		}
-		/** Run .onMount() before top-level SSR only (seed module/external state from `input`). */
-		function runOnMountForRender({ input, state, derived, action }) {
-			if (onMounts.length === 0) return;
-			if (currentRenderCtx()) return;
-			const host = createSsrOnMountHost();
-			const controller = new AbortController();
-			const ssrCleanups = [];
-			for (const entry of onMounts) {
-				const prevSub = setActiveSub(void 0);
-				let userCleanup;
-				try {
-					userCleanup = entry.fn({
-						state,
-						derived,
-						action,
-						input,
-						host,
-						hydrated: false,
-						signal: controller.signal
-					});
-				} catch (err) {
-					const error = err instanceof Error ? err : new Error(String(err));
-					if (onErrors.length === 0) {
-						if (!reportToGlobal(error, "mount")) console.error(error);
-					} else for (const oe of onErrors) try {
-						oe.fn({
-							error,
-							source: "mount",
-							state,
-							derived,
-							action,
-							input,
-							host
-						});
-					} catch (handlerErr) {
-						console.error(handlerErr);
-					}
-				} finally {
-					setActiveSub(prevSub);
-				}
-				if (typeof userCleanup === "function") ssrCleanups.push(userCleanup);
-			}
-			controller.abort();
-			for (const teardown of ssrCleanups.reverse()) try {
-				teardown();
-			} catch (err) {
-				const error = err instanceof Error ? err : new Error(String(err));
-				if (onErrors.length === 0) {
-					if (!reportToGlobal(error, "mount")) console.error(error);
-				}
-			}
-		}
 		function renderToString(props, sync = false, streamOut, eventsOut, stateOverride, forceAsyncChildren = false) {
 			const input = resolveInput(props);
 			const state = buildSignalState(input, stateOverride);
@@ -2053,12 +1989,6 @@ var IlhaBuilder = class IlhaBuilder {
 						error: void 0
 					};
 					const derived = buildDerivedAccessors(envelopes);
-					if (!currentRenderCtx()) runOnMountForRender({
-						input,
-						state,
-						derived,
-						action
-					});
 					const prevSub = setActiveSub(void 0);
 					try {
 						const { html, events } = renderWithCtx({
@@ -2100,12 +2030,6 @@ var IlhaBuilder = class IlhaBuilder {
 					const envelopes = {};
 					for (const r of resolved) envelopes[r.key] = r.envelope;
 					const derived = buildDerivedAccessors(envelopes);
-					if (!currentRenderCtx()) runOnMountForRender({
-						input,
-						state,
-						derived,
-						action
-					});
 					const prevSub = setActiveSub(void 0);
 					try {
 						const { html, events } = await renderWithCtx({
@@ -2803,6 +2727,7 @@ var IlhaBuilder = class IlhaBuilder {
 			return renderToString(props);
 		});
 		island.toString = (props) => renderToString(props, true);
+		island.toStringAsync = (props) => Promise.resolve(renderToString(props, false));
 		island.mount = (host, props) => mountIsland(host, props);
 		island[ISLAND_MOUNT_INTERNAL] = (host, props) => mountIslandInternal(host, props);
 		island[ISLAND_SLOT_TAG] = configuredSlotTag;
@@ -3067,6 +2992,7 @@ const ilha = Object.assign(callableRoot, {
 	context: ilhaContext,
 	signal: ilhaSignal,
 	computed: ilhaComputed,
+	morph,
 	batch,
 	untrack,
 	onUncaughtError
@@ -3123,4 +3049,4 @@ const from = ilhaFrom;
 const context = ilhaContext;
 
 //#endregion
-export { ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, __ilhaJsxEvent, __ilhaJsxSlot, batch, ilhaComputed as computed, context, css, ilha as default, ilhaEffect as effect, from, html, ilhaSignal, ilhaSignal as signal, morph, mount, onUncaughtError, raw, untrack };
+export { ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, __ilhaJsxEvent, __ilhaJsxSlot, batch, ilhaComputed as computed, context, css, ilhaEffect as effect, from, html, ilha, ilhaSignal, ilhaSignal as signal, morph, mount, onUncaughtError, raw, untrack };

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

@@ -1,2 +1,2 @@
-import { a as JSX, r as jsxDEV, t as Fragment } from "./jsx-runtime-B-viVOB1.js";
+import { a as JSX, r as jsxDEV, t as Fragment } from "./jsx-runtime-DMkplizR.js";
 export { Fragment, type JSX, jsxDEV };

package/dist/{jsx-runtime-B-viVOB1.d.ts → jsx-runtime-DMkplizR.d.ts}

@@ -1,4 +1,4 @@
-import { C as NativeEventModifier, E as SignalAccessor, O as SignalWriter, S as NativeEventHandler, T as RawHtml } from "./index-Cx35Xugv.js";
+import { C as NativeEventModifier, E as SignalAccessor, O as SignalWriter, S as NativeEventHandler, T as RawHtml } from "./index-DnoM0M8S.js";
 //#region src/jsx-types.d.ts
 declare namespace JSX {
   export type Child = unknown;

package/dist/jsx-runtime.d.ts

@@ -1,2 +1,2 @@
-import { a as JSX, i as jsxs, n as jsx, r as jsxDEV, t as Fragment } from "./jsx-runtime-B-viVOB1.js";
+import { a as JSX, i as jsxs, n as jsx, r as jsxDEV, t as Fragment } from "./jsx-runtime-DMkplizR.js";
 export { Fragment, type JSX, jsx, jsxDEV, jsxs };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ilha",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "A tiny, framework-free island architecture library",
   "keywords": [
     "framework-free",