ilha 0.12.0 → 0.13.0

package/README.md

@@ -23,7 +23,7 @@ const Counter = ilha(() => {
   const count = state(0);
 
   const increment = action(() => {
-    count((value) => value + 1);
+    count.update((value) => value + 1);
   });
 
   return html`
@@ -66,7 +66,7 @@ A plain function component stays transparent: its rendering, events, and cleanup
 
 ### `state(init?)`
 
-Island-local reactive state. Returns a signal accessor — a function that reads or writes depending on how you call it:
+Island-local reactive state. Returns a signal accessor — call it to read, use `.set()` / `.update()` to write:
 
 ```tsx
 const Counter = ilha(() => {
@@ -75,11 +75,11 @@ const Counter = ilha(() => {
 });
 
 count(); // read
-count(5); // write
-count((previous) => previous + 1); // update from the latest value
+count.set(5); // write
+count.update((previous) => previous + 1); // update from the latest value
 ```
 
-A function argument is a lazy initializer. To store a function value, return it from an updater wrapper: `callback(() => nextCallback)`.
+A function argument is a lazy initializer. To store a function value, pass it to `.set`: `onSave.set(nextCallback)`.
 
 A state initializer applies only when the instance is created. Later prop changes rerender the component but do not reset state:
 
@@ -264,24 +264,6 @@ mount({ Counter, Badge });
 
 Pass `{ root, lazy }` to scope discovery to a root element or defer mounting until hosts scroll into view.
 
-### `signal(initial)`
-
-Create a free-standing signal for shared state. Same accessor shape as `state()` but lives outside any island:
-
-```ts
-const count = signal(0);
-count(); // read
-count(5); // write
-```
-
-### `computed(fn)`
-
-Create a lazy, cached, read-only value derived from signals:
-
-```ts
-const total = computed(() => price() * qty());
-```
-
 ### `effect(fn)`
 
 Run a standalone reactive effect outside any island; returns a stop function:
@@ -308,8 +290,8 @@ const theme = context("app.theme", "light");
 
 ```ts
 batch(() => {
-  a(1);
-  b(2);
+  a.set(1);
+  b.set(2);
 });
 
 const value = untrack(() => secret());

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

@@ -86,8 +86,6 @@ interface NativeEventContext {
   readonly signal: AbortSignal;
 }
 type NativeEventHandler<E extends Event = Event> = (event: E, context: NativeEventContext) => unknown;
-type NonFunctionValue<T> = T extends ((...args: any[]) => any) ? never : T;
-type SignalSetter<T> = NonFunctionValue<T> | ((previous: T) => T);
 declare const SIGNAL_WRITER_TYPE: unique symbol;
 /** @internal Type-level write target carried by signal accessors. */
 interface SignalWriter<T> {
@@ -96,7 +94,8 @@ interface SignalWriter<T> {
 type PathValue<T, P extends readonly PathSegment[]> = P extends readonly [infer Head, ...infer Tail] ? Head extends keyof T ? Tail extends readonly PathSegment[] ? PathValue<T[Head], Tail> : never : unknown : T;
 interface MarkedSignalAccessor<T> extends SignalWriter<T> {
   (): T;
-  (...args: [value: SignalSetter<T>]): void;
+  set(value: T): void;
+  update(fn: (previous: T) => T): void;
   select<S>(selector: (state: T) => S): MarkedSignalAccessor<S>;
   select<const P extends readonly PathSegment[]>(...path: P): MarkedSignalAccessor<PathValue<T, P>>;
   [SIGNAL_ACCESSOR]: true;
@@ -131,15 +130,33 @@ declare function json(value: unknown): RawHtml;
  * an attribute is author error.
  */
 declare function css(value: string): RawHtml;
+declare const TEMPLATE_PARTS: unique symbol;
+interface TemplateParts {
+  [TEMPLATE_PARTS]: true;
+  values: unknown[];
+}
+type TemplateNode = {
+  kind: "fragment";
+  children: TemplateNode[];
+} | {
+  kind: "element";
+  tag: string;
+  props: Record<string, unknown>;
+  children: TemplateNode[];
+  selfClosing?: boolean;
+} | {
+  kind: "text";
+  value: string;
+} | {
+  kind: "comment";
+  value: string | TemplateParts;
+} | {
+  kind: "dynamic";
+  value: unknown;
+};
 declare function ilhaHtml(strings: TemplateStringsArray, ...values: unknown[]): RawHtml;
 type ContextSignal<T> = SignalAccessor<T>;
 declare function ilhaContextFn<T>(key: string, initial: T): ContextSignal<T>;
-/**
- * Create a free-standing reactive signal that lives outside any island.
- * Internal: used by state()'s slot-drift fallback. The public way to create
- * free-standing shared state is `context(key, initial)`.
- */
-declare function ilhaSignal<T>(initial: T): SignalAccessor<T>;
 /**
  * Run `fn` with reactive tracking suspended. Reading signals inside `fn`
  * returns their current value without subscribing the surrounding scope.
@@ -199,7 +216,8 @@ type DerivedAccessor<T> = {
   readonly value: T | undefined;
   readonly error: Error | undefined;
   (): T | undefined;
-  (value: T): void;
+  set(value: T): void;
+  update(fn: (previous: T | undefined) => T | undefined): void;
 };
 type ExternalSignal<T = unknown> = SignalAccessor<T>;
 type SignalAccessor<T> = MarkedSignalAccessor<T>;
@@ -246,6 +264,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 +276,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 {
   /**
@@ -302,8 +323,8 @@ interface MountResult {
  *
  * A function argument is treated as a lazy initializer:
  *   const count = state(() => expensiveInitialValue());
- * To store a function VALUE, return it from the updater wrapper on write:
- *   setCallback(() => nextCallback);
+ * To store a function VALUE, pass it to `.set`:
+ *   onSave.set(nextCallback);
  */
 declare function state<T>(init?: T | (() => T)): StateAccessor<T>;
 /**
@@ -371,4 +392,4 @@ declare const context: typeof ilhaContextFn & {
   clear(): void;
 };
 //#endregion
-export { action as A, isSafeUrl as B, PersistOptions as C, SignalSetter as D, SignalAccessor as E, each as F, mount as G, isUrlAttributeName as H, effect as I, persist as J, onError as K, html as L, context as M, css as N, SignalWriter as O, derived as P, untrack as Q, ilha as R, NativeEventModifier as S, RawHtml as T, json as U, isSafeUrlAttrValue as V, morph as W, serializeStyle as X, raw as Y, state as Z, KeyedIsland as _, EachKeyedBuilder as a, NativeEventContext as b, EffectFn as c, ErrorContext as d, ErrorSource as f, IslandComponent as g, Island as h, EachBuilder as i, batch as j, StateAccessor as k, EffectOnceContext as l, HydratableOptions as m, DerivedAccessor as n, EachResult as o, ExternalSignal as p, onUncaughtError as q, DerivedValue as r, EffectContext as s, ActionAccessor as t, EffectOnceFn as u, MountOptions as v, PersistStorage as w, NativeEventHandler as x, MountResult as y, ilhaSignal as z };
+export { action as A, isSafeUrlAttrValue as B, PersistOptions as C, SignalWriter as D, SignalAccessor as E, each as F, onError as G, json as H, effect as I, raw as J, onUncaughtError as K, html as L, context as M, css as N, StateAccessor as O, derived as P, ilha as R, NativeEventModifier as S, RawHtml as T, morph as U, isUrlAttributeName as V, mount as W, state as X, serializeStyle as Y, untrack as Z, KeyedIsland as _, EachKeyedBuilder as a, NativeEventContext as b, EffectFn as c, ErrorContext as d, ErrorSource as f, IslandComponent as g, Island as h, EachBuilder as i, batch as j, TemplateNode as k, EffectOnceContext as l, HydratableOptions as m, DerivedAccessor as n, EachResult as o, ExternalSignal as p, persist as q, DerivedValue as r, EffectContext as s, ActionAccessor as t, EffectOnceFn as u, MountOptions as v, PersistStorage as w, NativeEventHandler as x, MountResult as y, isSafeUrl as z };

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";
-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 };
+import { A as action, B as isSafeUrlAttrValue, C as PersistOptions, D as SignalWriter, E as SignalAccessor, F as each, G as onError, H as json, I as effect, J as raw, K as onUncaughtError, L as html, M as context, N as css, O as StateAccessor, P as derived, R as ilha, S as NativeEventModifier, T as RawHtml, U as morph, V as isUrlAttributeName, W as mount, X as state, Y as serializeStyle, Z as untrack, _ 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 TemplateNode, l as EffectOnceContext, m as HydratableOptions, n as DerivedAccessor, o as EachResult, p as ExternalSignal, q as persist, 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 isSafeUrl } from "./index-CVOjC94p.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, SignalWriter, StateAccessor, TemplateNode, action, batch, context, css, derived, each, effect, html, ilha, isSafeUrl, isSafeUrlAttrValue, isUrlAttributeName, json, morph, mount, onError, onUncaughtError, persist, raw, serializeStyle, state, untrack };