ilha 0.12.0 → 0.12.1

package/dist/{index-DZI0fEmR.d.ts → index-BETRqz-0.d.ts}

@@ -246,6 +246,9 @@ interface KeyedIsland<TInput> {
 }
 type AnyIsland = Island<any>;
 type ActionCall<P> = [P] extends [undefined] ? () => void : unknown extends P ? () => void : (payload: P) => void;
+/** A bound action can back native events or component callback props.
+ * Runtime arguments are ignored when `.with()` binds a payload. */
+type BoundActionHandler = (...runtimeArgs: unknown[]) => unknown;
 /**
  * Reactive operation with execution state. `pending`, `data`, and `error`
  * are reactive: reading them during render subscribes the island render.
@@ -255,10 +258,10 @@ type ActionAccessor<P = undefined, R = void> = ActionCall<P> & {
   readonly data: Awaited<R> | undefined;
   readonly error: Error | undefined;
   /** Bind an explicit serializable payload into an RPC-replayable action
-   * reference for server-owned islands (`onclick={remove.withArgs(id)}`).
+   * reference for server-owned islands (`onclick={remove.with(id)}`).
    * Arguments are validated JSON-safe (≤ 8 KiB serialized) at bind time and
    * stored in the hydration manifest — never extracted by executing code. */
-  withArgs: (...args: unknown[]) => NativeEventHandler;
+  with: (...args: unknown[]) => BoundActionHandler;
 };
 interface EffectContext {
   /**

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { A as action, B as isSafeUrl, C as PersistOptions, D as SignalSetter, E as SignalAccessor, F as each, G as mount, H as isUrlAttributeName, I as effect, J as persist, K as onError, L as html, M as context, N as css, O as SignalWriter, P as derived, Q as untrack, R as ilha, S as NativeEventModifier, T as RawHtml, U as json, V as isSafeUrlAttrValue, W as morph, X as serializeStyle, Y as raw, Z as state, _ as KeyedIsland, a as EachKeyedBuilder, b as NativeEventContext, c as EffectFn, d as ErrorContext, f as ErrorSource, g as IslandComponent, h as Island, i as EachBuilder, j as batch, k as StateAccessor, l as EffectOnceContext, m as HydratableOptions, n as DerivedAccessor, o as EachResult, p as ExternalSignal, q as onUncaughtError, r as DerivedValue, s as EffectContext, t as ActionAccessor, u as EffectOnceFn, v as MountOptions, w as PersistStorage, x as NativeEventHandler, y as MountResult, z as ilhaSignal } from "./index-DZI0fEmR.js";
+import { A as action, B as isSafeUrl, C as PersistOptions, D as SignalSetter, E as SignalAccessor, F as each, G as mount, H as isUrlAttributeName, I as effect, J as persist, K as onError, L as html, M as context, N as css, O as SignalWriter, P as derived, Q as untrack, R as ilha, S as NativeEventModifier, T as RawHtml, U as json, V as isSafeUrlAttrValue, W as morph, X as serializeStyle, Y as raw, Z as state, _ as KeyedIsland, a as EachKeyedBuilder, b as NativeEventContext, c as EffectFn, d as ErrorContext, f as ErrorSource, g as IslandComponent, h as Island, i as EachBuilder, j as batch, k as StateAccessor, l as EffectOnceContext, m as HydratableOptions, n as DerivedAccessor, o as EachResult, p as ExternalSignal, q as onUncaughtError, r as DerivedValue, s as EffectContext, t as ActionAccessor, u as EffectOnceFn, v as MountOptions, w as PersistStorage, x as NativeEventHandler, y as MountResult, z as ilhaSignal } from "./index-BETRqz-0.js";
 export { ActionAccessor, DerivedAccessor, DerivedValue, EachBuilder, EachKeyedBuilder, EachResult, EffectContext, EffectFn, EffectOnceContext, EffectOnceFn, ErrorContext, ErrorSource, ExternalSignal, HydratableOptions, Island, IslandComponent, KeyedIsland, MountOptions, MountResult, NativeEventContext, NativeEventHandler, NativeEventModifier, PersistOptions, PersistStorage, RawHtml, SignalAccessor, SignalSetter, SignalWriter, StateAccessor, action, batch, context, css, derived, each, effect, html, ilha, ilhaSignal, isSafeUrl, isSafeUrlAttrValue, isUrlAttributeName, json, morph, mount, onError, onUncaughtError, persist, raw, serializeStyle, state, untrack };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, serializeServerManifest, setJsxRuntimeBridge } from "./internal.js";
+import { ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, serializeServerManifest, setJsxRuntimeBridge, setServerActionBinder } from "./internal.js";
 import { effect as effect$1, endBatch, setActiveSub, signal, startBatch } from "alien-signals";
 
 //#region src/index.ts
@@ -592,7 +592,7 @@ function each(items) {
 const SSR_ACTION_STUB = Symbol.for("ilha.ssrActionStub");
 const ACTION_MANIFEST_ID = Symbol.for("ilha.actionManifestId");
 const ACTION_BOUND_ARGS = Symbol.for("ilha.actionBoundArgs");
-/** Serialized size ceiling for `.withArgs()` payloads (JSON chars). */
+/** Serialized size ceiling for `.with()` payloads (JSON chars). */
 const MAX_BOUND_ARGS_CHARS = 8192;
 /** Manifest id for a brand-recognized action reference, else undefined.
 * Anything that isn't a branded action stub is rejected outright — event
@@ -601,13 +601,13 @@ function actionManifestId(fn) {
 	if (typeof fn !== "function" || !(SSR_ACTION_STUB in fn)) return void 0;
 	return fn[ACTION_MANIFEST_ID];
 }
-/** Bound args recorded by `.withArgs()` on an action reference, else undefined. */
+/** Bound args recorded by `.with()` on an action reference, else undefined. */
 function actionBoundArgs(fn) {
 	if (typeof fn !== "function" || !(ACTION_BOUND_ARGS in fn)) return void 0;
 	const args = fn[ACTION_BOUND_ARGS];
 	return Array.isArray(args) ? args : void 0;
 }
-/** Attach `.withArgs(...args)` to an action accessor. Returns an explicit,
+/** Attach `.with(...args)` to an action accessor. Returns an explicit,
 * serializable action REFERENCE — never a closure to inspect or probe.
 * Arguments are validated JSON-safe at bind time; the hydration manifest
 * stores `{ actionId, args }` directly and the client RPC path sends them
@@ -631,19 +631,19 @@ function assertJsonSafe(value, seen = /* @__PURE__ */ new WeakSet()) {
 		case "boolean": return;
 		case "number":
 			if (Number.isFinite(value)) return;
-			throw new TypeError("withArgs() rejects non-finite numbers.");
+			throw new TypeError("with() rejects non-finite numbers.");
 		case "object": break;
-		default: throw new TypeError(`withArgs() rejects ${typeof value} values.`);
+		default: throw new TypeError(`with() rejects ${typeof value} values.`);
 	}
-	if (seen.has(value)) throw new TypeError("withArgs() rejects circular values.");
+	if (seen.has(value)) throw new TypeError("with() rejects circular values.");
 	seen.add(value);
 	if (Array.isArray(value)) {
 		for (const item of value) assertJsonSafe(item, seen);
 		return;
 	}
-	if (Object.getPrototypeOf(value) !== Object.prototype) throw new TypeError("withArgs() accepts plain objects only.");
+	if (Object.getPrototypeOf(value) !== Object.prototype) throw new TypeError("with() accepts plain objects only.");
 	for (const [key, child] of Object.entries(value)) {
-		if (UNSAFE_KEYS.has(key)) throw new TypeError(`withArgs() rejects unsafe key "${key}".`);
+		if (UNSAFE_KEYS.has(key)) throw new TypeError(`with() rejects unsafe key "${key}".`);
 		assertJsonSafe(child, seen);
 	}
 }
@@ -651,13 +651,13 @@ function assertJsonSafe(value, seen = /* @__PURE__ */ new WeakSet()) {
 function cloneJsonSafe(value) {
 	return structuredClone(value);
 }
-function attachWithArgs(accessor) {
-	Object.defineProperty(accessor, "withArgs", {
+function attachWith(accessor) {
+	Object.defineProperty(accessor, "with", {
 		enumerable: false,
 		value: (...args) => {
 			for (const arg of args) assertJsonSafe(arg);
 			const serialized = cloneJsonSafe(args);
-			if (JSON.stringify(serialized).length > MAX_BOUND_ARGS_CHARS) throw new RangeError(`withArgs() payload exceeds ${MAX_BOUND_ARGS_CHARS} JSON characters.`);
+			if (JSON.stringify(serialized).length > MAX_BOUND_ARGS_CHARS) throw new RangeError(`with() payload exceeds ${MAX_BOUND_ARGS_CHARS} JSON characters.`);
 			const manifestId = actionManifestId(accessor);
 			const bound = (...runtimeArgs) => {
 				return accessor(serialized.length > 0 ? serialized.length === 1 ? serialized[0] : serialized : runtimeArgs.length === 1 ? runtimeArgs[0] : runtimeArgs);
@@ -670,6 +670,13 @@ function attachWithArgs(accessor) {
 		}
 	});
 }
+setServerActionBinder(function bindExternalAction(fn, manifestId) {
+	const action = fn;
+	action[SSR_ACTION_STUB] = true;
+	action[ACTION_MANIFEST_ID] = manifestId;
+	attachWith(action);
+	return action;
+});
 const RENDER_CTX_STACK = Symbol.for("ilha.renderCtxStack");
 function renderCtxStack() {
 	const g = globalThis;
@@ -1871,7 +1878,7 @@ function action(fn) {
 			data: { get: () => void 0 },
 			error: { get: () => void 0 }
 		});
-		attachWithArgs(noop);
+		attachWith(noop);
 		return noop;
 	}
 	const manifestId = `a${f.actionIndex++}`;
@@ -1900,7 +1907,7 @@ function action(fn) {
 			fn
 		};
 		const ssrAccessor = invoke;
-		attachWithArgs(ssrAccessor);
+		attachWith(ssrAccessor);
 		return ssrAccessor;
 	}
 	const instance = f.instance;
@@ -1997,7 +2004,7 @@ function action(fn) {
 	instance.actionIds.set(slot.acc, manifestId);
 	const clientAccessor = invoke;
 	clientAccessor[ACTION_MANIFEST_ID] = manifestId;
-	attachWithArgs(clientAccessor);
+	attachWith(clientAccessor);
 	return clientAccessor;
 }
 /**
@@ -2824,7 +2831,7 @@ const ilha = ((...args) => {
 		if (snapshot !== false) {
 			const doState = snapshot === true || snapshot.state !== false;
 			const doDerived = snapshot === true || snapshot.derived !== false;
-			const doSkipOnMount = explicitSkipOnMount ?? (doState || doDerived);
+			const doSkipOnMount = explicitSkipOnMount ?? false;
 			const snapshotData = { v: 2 };
 			const input = resolveInput(resolvedProps);
 			const probeFrame = freshFrame({ ssr: true });

package/dist/internal.d.ts

@@ -1,5 +1,13 @@
-import { S as NativeEventModifier, T as RawHtml, x as NativeEventHandler } from "./index-DZI0fEmR.js";
+import { S as NativeEventModifier, T as RawHtml, x as NativeEventHandler } from "./index-BETRqz-0.js";
 //#region src/internal.d.ts
+type ServerAction<A extends unknown[] = unknown[], R = unknown> = ((...args: A) => R) & {
+  with: (...args: unknown[]) => (...runtimeArgs: unknown[]) => unknown;
+};
+type ServerActionBinder = <A extends unknown[], R>(fn: (...args: A) => R, manifestId?: string) => ServerAction<A, R>;
+/** @internal Register core's action branding implementation. */
+declare function setServerActionBinder(binder: ServerActionBinder): void;
+/** @internal Brand an external server action for hydration-manifest replay. */
+declare function bindServerAction<A extends unknown[], R>(fn: (...args: A) => R, manifestId?: string): ServerAction<A, R>;
 /** Registry of live island mount handles keyed by host element. */
 declare const ISLAND_MOUNT_HANDLES: WeakMap<Element, {
   unmount: () => void | Promise<void>;
@@ -58,4 +66,4 @@ declare function setServerManifestSerializer(serializer: ServerManifestSerialize
 /** @internal Used by island rendering to serialize nested child manifests. */
 declare function serializeServerManifest(manifest: Map<string, ManifestEntry>): string;
 //#endregion
-export { ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, JsxEventRegistration, JsxRuntimeBridge, ManifestEntry, ServerManifestSerializer, __ilhaJsxEvent, __ilhaJsxSlot, serializeServerManifest, setJsxRuntimeBridge, setServerManifestSerializer };
+export { ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, JsxEventRegistration, JsxRuntimeBridge, ManifestEntry, ServerAction, ServerManifestSerializer, __ilhaJsxEvent, __ilhaJsxSlot, bindServerAction, serializeServerManifest, setJsxRuntimeBridge, setServerActionBinder, setServerManifestSerializer };

package/dist/internal.js

@@ -1,4 +1,14 @@
 //#region src/internal.ts
+let serverActionBinder;
+/** @internal Register core's action branding implementation. */
+function setServerActionBinder(binder) {
+	serverActionBinder = binder;
+}
+/** @internal Brand an external server action for hydration-manifest replay. */
+function bindServerAction(fn, manifestId) {
+	if (!serverActionBinder) throw new Error("ilha: server action binder is unavailable");
+	return serverActionBinder(fn, manifestId);
+}
 /** Registry of live island mount handles keyed by host element. */
 const ISLAND_MOUNT_HANDLES = /* @__PURE__ */ new WeakMap();
 /** Hook a parent's mountSlots uses to mount a child island and keep a handle
@@ -36,4 +46,4 @@ function serializeServerManifest(manifest) {
 }
 
 //#endregion
-export { ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, __ilhaJsxEvent, __ilhaJsxSlot, serializeServerManifest, setJsxRuntimeBridge, setServerManifestSerializer };
+export { ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, __ilhaJsxEvent, __ilhaJsxSlot, bindServerAction, serializeServerManifest, setJsxRuntimeBridge, setServerActionBinder, setServerManifestSerializer };

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

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

package/dist/{jsx-runtime-BCGuHwTg.d.ts → jsx-runtime-qnxoD2YJ.d.ts}

@@ -1,4 +1,4 @@
-import { E as SignalAccessor, O as SignalWriter, S as NativeEventModifier, T as RawHtml, x as NativeEventHandler } from "./index-DZI0fEmR.js";
+import { E as SignalAccessor, O as SignalWriter, S as NativeEventModifier, T as RawHtml, x as NativeEventHandler } from "./index-BETRqz-0.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-BCGuHwTg.js";
+import { a as JSX, i as jsxs, n as jsx, r as jsxDEV, t as Fragment } from "./jsx-runtime-qnxoD2YJ.js";
 export { Fragment, type JSX, jsx, jsxDEV, jsxs };

package/package.json

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