chizu 0.2.52 → 0.2.54

package/README.md

@@ -248,14 +248,59 @@ actions.dispatch(Actions.Multicast.Update, 42, { scope: "TeamA" });
 
 Unlike broadcast which reaches all components, multicast is scoped to the named boundary – perfect for isolated widget groups, form sections, or distinct UI regions. See the [multicast recipe](./recipes/multicast-actions.md) for more details.
 
-To preserve a component's state across unmount/remount cycles, wrap the initial model with `Rehydrate`:
+For data that is expensive to fetch, use `cacheable` to cache values with a TTL. Define typed cache entries with `Entry` and call `context.actions.cacheable` inside a handler – the callback only runs when the cache is empty or expired:
 
 ```ts
-import { useActions, Rehydrate } from "chizu";
+import { Entry, useActions, Action } from "chizu";
+import { O } from "@mobily/ts-belt";
 
-const actions = useActions<Model, typeof Actions>(
-  Rehydrate(model, { UserId: props.userId }),
-);
+class CacheStore {
+  static Pairs = Entry<CryptoPair[]>();
+  static User = Entry<User, { UserId: number }>();
+}
+
+class Actions {
+  static FetchPairs = Action("FetchPairs");
+  static FetchUser = Action("FetchUser");
+}
+```
+
+```ts
+actions.useAction(Actions.FetchPairs, async (context) => {
+  const { data } = await context.actions.cacheable(
+    CacheStore.Pairs,
+    30_000,
+    async () => O.Some(await api.fetchPairs()),
+  );
+
+  if (data) {
+    context.actions.produce(({ model }) => {
+      model.pairs = data;
+    });
+  }
+});
+
+// Channeled &ndash; independent cache per user
+actions.useAction(Actions.FetchUser, async (context) => {
+  const { data } = await context.actions.cacheable(
+    CacheStore.User({ UserId: context.data.userId }),
+    60_000,
+    async () => O.Some(await api.fetchUser(context.data.userId)),
+  );
+
+  if (data) {
+    context.actions.produce(({ model }) => {
+      model.user = data;
+    });
+  }
+});
+```
+
+Only `Some` / `Ok` values are stored in the cache. `None` and `Error` results are skipped. Use `context.actions.invalidate` to clear a specific entry so the next `cacheable` call fetches fresh data:
+
+```ts
+context.actions.invalidate(CacheStore.Pairs);
+context.actions.invalidate(CacheStore.User({ UserId: 5 }));
 ```
 
-When the component unmounts, its model is snapshotted into the rehydrator. On remount with the same channel key, the model is restored automatically. This is useful for tab switching, route changes, and conditionally rendered components. See the [rehydration recipe](./recipes/rehydration.md) for details.
+The cache is scoped to the nearest `<Boundary>`. See the [caching recipe](./recipes/caching.md) for more details.

package/dist/boundary/components/cache/index.d.ts

@@ -0,0 +1,13 @@
+import { Props } from './types.ts';
+import * as React from "react";
+export { useCacheStore } from './utils.ts';
+export type { CacheContext } from './types.ts';
+/**
+ * Creates a new cache context for storing values from `context.actions.cacheable`.
+ * Automatically included in `<Boundary>`. Only needed directly if you want to
+ * isolate a cache context.
+ *
+ * @param props.children - The children to render within the cache context.
+ * @returns The children wrapped in a cache context provider.
+ */
+export declare function CacheProvider({ children }: Props): React.ReactNode;

package/dist/boundary/components/cache/types.d.ts

@@ -0,0 +1,19 @@
+import type * as React from "react";
+/**
+ * A single cached value with its expiry timestamp.
+ */
+export type CacheItem = {
+    value: unknown;
+    expiry: number;
+};
+/**
+ * Store for cached values.
+ * Keyed by a deterministic string derived from the entry symbol and channel.
+ */
+export type CacheContext = Map<string, CacheItem>;
+/**
+ * Props for the CacheProvider component.
+ */
+export type Props = {
+    children: React.ReactNode;
+};

package/dist/boundary/components/cache/utils.d.ts

@@ -0,0 +1,12 @@
+import { CacheContext } from './types.ts';
+import * as React from "react";
+/**
+ * React context for the shared cache store.
+ */
+export declare const Context: React.Context<CacheContext>;
+/**
+ * Hook to access the cache store from context.
+ *
+ * @returns The cache Map from the nearest CacheProvider.
+ */
+export declare function useCacheStore(): CacheContext;

package/dist/boundary/index.d.ts

@@ -2,7 +2,7 @@ import { Props } from './types.ts';
 import * as React from "react";
 /**
  * Creates a unified context boundary for all Chizu features.
- * Wraps children with Broadcaster, Consumer, Rehydrate, and Tasks providers.
+ * Wraps children with Broadcaster, Consumer, Cache, and Tasks providers.
  *
  * Use this at the root of your application or to create isolated context boundaries
  * for libraries that need their own Chizu context.

package/dist/cache/index.d.ts

@@ -0,0 +1,77 @@
+import { Filter, CacheId, ChanneledCacheId } from '../types/index.ts';
+export type { CacheId, ChanneledCacheId };
+/**
+ * Creates a typed cache entry identifier for use with `context.actions.cacheable`
+ * and `context.actions.invalidate`.
+ *
+ * Each call produces a unique identity. The first type parameter `T` binds the
+ * entry to a specific value type, ensuring that `cacheable` callbacks return the
+ * correct type.
+ *
+ * When called with only `T`, the entry is unchanneled — a single cache slot.
+ * When called with `T` and `C`, the entry is channeled — independent cache
+ * slots per channel value.
+ *
+ * @template T - The cached value type.
+ * @template C - The channel type, constrained to `Filter`.
+ * @returns A cache entry identifier for use with `cacheable` and `invalidate`.
+ *
+ * @example
+ * ```ts
+ * import { Entry } from "chizu";
+ *
+ * class CacheStore {
+ *   // Unchanneled — single cache slot
+ *   static Pairs = Entry<CryptoPair[]>();
+ *
+ *   // Channeled &mdash; independent slot per UserId
+ *   static User = Entry<User, { UserId: number }>();
+ * }
+ *
+ * // Unchanneled usage
+ * await context.actions.cacheable(CacheStore.Pairs, 30_000, async () => ...);
+ *
+ * // Channeled usage
+ * await context.actions.cacheable(CacheStore.User({ UserId: 5 }), 60_000, async () => ...);
+ *
+ * // Invalidate
+ * context.actions.invalidate(CacheStore.Pairs);
+ * context.actions.invalidate(CacheStore.User({ UserId: 5 }));
+ * ```
+ */
+export declare function Entry<T>(): CacheId<T>;
+export declare function Entry<T, C extends Filter>(): CacheId<T, C>;
+/**
+ * Extracts the identity symbol from a plain or channeled cache entry.
+ */
+export declare function getCacheSymbol(entry: CacheId | ChanneledCacheId): symbol;
+/**
+ * Type guard that returns `true` when the entry is a channeled cache identifier.
+ */
+export declare function isChanneledCacheId(entry: CacheId | ChanneledCacheId): entry is ChanneledCacheId;
+/**
+ * Serialises a channel object into a deterministic string key.
+ * Keys are sorted alphabetically for deterministic output.
+ * Returns an empty string for unchanneled operations.
+ */
+export declare function serializeChannel(channel?: Filter): string;
+/**
+ * Builds the cache Map key from an entry identifier.
+ * Combines the symbol description (unique per Entry call) with the
+ * serialised channel string for channeled entries.
+ */
+export declare function getCacheKey(entry: CacheId | ChanneledCacheId): string;
+/**
+ * Unwraps one layer of `Option` or `Result` from a value.
+ *
+ * - `Some(value)` (non-null/undefined) &rarr; `{ ok: true, value }`
+ * - `None` (null/undefined) &rarr; `{ ok: false }`
+ * - `Ok(value)` (TAG 0) &rarr; `{ ok: true, value: _0 }`
+ * - `Error(value)` (TAG 1) &rarr; `{ ok: false }`
+ */
+export declare function unwrap(result: unknown): {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+};

package/dist/chizu.js

@@ -1,8 +1,8 @@
-import{G as e,A as t}from"@mobily/ts-belt";import*as n from"react";import{createContext as r,useContext as o}from"react";import{jsx as c}from"react/jsx-runtime";import{immerable as s,enablePatches as i,Immer as a}from"immer";class u{static Payload=/* @__PURE__ */Symbol("chizu.brand/Payload");static Broadcast=/* @__PURE__ */Symbol("chizu.brand/Broadcast");static Multicast=/* @__PURE__ */Symbol("chizu.brand/Multicast");static Action=/* @__PURE__ */Symbol("chizu.brand/Action");static Channel=/* @__PURE__ */Symbol("chizu.brand/Channel");static Node=/* @__PURE__ */Symbol("chizu.action.lifecycle/Node");static Rehydrate=/* @__PURE__ */Symbol("chizu.brand/Rehydrate")}class l{static Mount=/* @__PURE__ */Symbol("chizu.action.lifecycle/Mount");static Unmount=/* @__PURE__ */Symbol("chizu.action.lifecycle/Unmount");static Error=/* @__PURE__ */Symbol("chizu.action.lifecycle/Error");static Update=/* @__PURE__ */Symbol("chizu.action.lifecycle/Update");static Node=(()=>{const e=u.Node,t=function(t){return{[u.Action]:e,[u.Payload]:void 0,[u.Channel]:t,channel:t}};return Object.defineProperty(t,u.Action,{value:e,enumerable:!1}),Object.defineProperty(t,u.Payload,{value:void 0,enumerable:!1}),t})()}var f=/* @__PURE__ */(e=>(e.Unicast="unicast",e.Broadcast="broadcast",e.Multicast="multicast",e))(f||{}),d=/* @__PURE__ */(e=>(e.Mounting="mounting",e.Mounted="mounted",e.Unmounting="unmounting",e.Unmounted="unmounted",e))(d||{}),p=/* @__PURE__ */(e=>(e[e.Timedout=0]="Timedout",e[e.Supplanted=1]="Supplanted",e[e.Disallowed=2]="Disallowed",e[e.Errored=3]="Errored",e[e.Unmounted=4]="Unmounted",e))(p||{});class h extends Error{name="AbortError";constructor(e="Aborted"){super(e)}}const m={actionPrefix:"chizu.action/",broadcastActionPrefix:"chizu.action/broadcast/",multicastActionPrefix:"chizu.action/multicast/",channelPrefix:"chizu.channel/",cachePrefix:"chizu.cache/"};function y(e,t){return new Promise((n,r)=>{if(t?.aborted)return void r(new h);const o=setTimeout(n,e);t?.addEventListener("abort",()=>{clearTimeout(o),r(new h)},{once:!0})})}function b(e){return e?Boolean(e&&"symbol"!=typeof e):/* @__PURE__ */Symbol(`pk.${Date.now()}.${crypto.randomUUID()}`)}const v=/* @__PURE__ */Object.freeze(/* @__PURE__ */Object.defineProperty({__proto__:null,config:m,pk:b,sleep:y,"ζ":y,"κ":b},Symbol.toStringTag,{value:"Module"})),g=e=>"symbol"==typeof e;function w(t){return e.isString(t)||g(t)?t:(e.isObject(t)||e.isFunction(t))&&u.Action in t?t[u.Action]:t}function S(t){if(e.isString(t))return t.startsWith(m.broadcastActionPrefix);if(g(t))return t.description?.startsWith(m.broadcastActionPrefix)??!1;if(e.isObject(t)||e.isFunction(t)){if(u.Broadcast in t&&t[u.Broadcast])return!0;if(u.Action in t){const e=t[u.Action];return e.description?.startsWith(m.broadcastActionPrefix)??!1}}return!1}function x(t){const n=w(t),r=e.isString(n)?n:n.description??"";return r.startsWith(m.actionPrefix)&&r.slice(r.lastIndexOf("/")+1)||"unknown"}function P(t){return e.isObject(t)&&u.Channel in t&&"channel"in t}function E(t){if(e.isString(t))return t.startsWith(m.multicastActionPrefix);if(g(t))return t.description?.startsWith(m.multicastActionPrefix)??!1;if(e.isObject(t)||e.isFunction(t)){if(u.Multicast in t&&t[u.Multicast])return!0;if(u.Action in t){const e=t[u.Action];return e.description?.startsWith(m.multicastActionPrefix)??!1}}return!1}const M=(e,t=f.Unicast)=>{const n=t===f.Broadcast?/* @__PURE__ */Symbol(`${m.broadcastActionPrefix}${e}`):t===f.Multicast?/* @__PURE__ */Symbol(`${m.multicastActionPrefix}${e}`):/* @__PURE__ */Symbol(`${m.actionPrefix}${e}`),r=function(e){return{[u.Action]:n,[u.Payload]:void 0,[u.Channel]:e,channel:e}};return Object.defineProperty(r,u.Action,{value:n,enumerable:!1}),Object.defineProperty(r,u.Payload,{value:void 0,enumerable:!1}),t===f.Broadcast&&Object.defineProperty(r,u.Broadcast,{value:!0,enumerable:!1}),t===f.Multicast&&Object.defineProperty(r,u.Multicast,{value:!0,enumerable:!1}),r},A=n.createContext({data:/* @__PURE__ */new Map});function O(e){return e?[...Object.keys(e)].toSorted().map(t=>`${t}=${String(e[t])}`).join("&"):""}function j(e,t){return{[u.Rehydrate]:!0,model:e,channel:t}}function _(e){if(e instanceof Error){if("TimeoutError"===e.name)return p.Timedout;if("AbortError"===e.name)return p.Supplanted}return p.Errored}function k(e){return e instanceof Error?e:new Error(String(e))}const R=r(void 0);function C({handler:e,children:t}){/* @__PURE__ */
-return c(R.Provider,{value:e,children:t})}let N=(e=21)=>{let t="",n=crypto.getRandomValues(new Uint8Array(e|=0));for(;e--;)t+="useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict"[63&n[e]];return t};var U=/* @__PURE__ */(e=>(e[e.Add=1]="Add",e[e.Remove=2]="Remove",e[e.Update=4]="Update",e[e.Move=8]="Move",e[e.Replace=16]="Replace",e[e.Sort=32]="Sort",e[e.Create=64]="Create",e[e.Fetch=128]="Fetch",e[e.Clone=256]="Clone",e[e.Archive=512]="Archive",e[e.Restore=1024]="Restore",e[e.Merge=2048]="Merge",e[e.Reorder=4096]="Reorder",e[e.Sync=8192]="Sync",e[e.Publish=16384]="Publish",e[e.Link=32768]="Link",e[e.Unlink=65536]="Unlink",e[e.Lock=131072]="Lock",e[e.Unlock=262144]="Unlock",e[e.Import=524288]="Import",e[e.Export=1048576]="Export",e[e.Transfer=2097152]="Transfer",e))(U||{}),z=/* @__PURE__ */(e=>(e[e.Produce=0]="Produce",e[e.Hydrate=1]="Hydrate",e))(z||{}),L=/* @__PURE__ */(e=>(e.Property="property",e.Process="process",e.Value="value",e.Operation="operation",e))(L||{});class T{[s]=!0;static keys=new Set(Object.values(L));property=null;process=null;value;operation;constructor(e,t){this.value=e,this.operation=t}assign(e,t){const n=new T(this.value,this.operation);return n.property=e,n.process=t,n}}class B{static immer=(()=>{i();const e=new a;return e.setAutoFreeze(!1),e})();static tag="κ";static id=N}function $(e,t){const n="string"==typeof t?""===t?[]:t.split("."):t;let r=e;for(const o of n){if(null==r)return;r=r[o]}return r}function F(t){if(e.isNullable(t)||H(t))return t;if(e.isArray(t))return t.map(e=>F(e));if(e.isObject(t)){const e=Object.entries(t).map(([e,t])=>[e,F(t)]);return{...Object.fromEntries(e),[B.tag]:t[B.tag]??B.id()}}return t}function W(e){if(Array.isArray(e))return e.filter(e=>B.tag in e).map(e=>e[B.tag]??"").join(",");const t=e[B.tag];if(t)return t;try{return JSON.stringify(e)}catch{return`[unserializable:${typeof e}]`}}function H(t){return e.isNullable(t)||e.isString(t)||e.isNumber(t)||e.isBoolean(t)||"symbol"==typeof t||"bigint"==typeof t}function D(t,n,r,o,c,s){return function i(a,u=n.path){if(a instanceof T){const n=$(r,u.join("."));if(Object.entries(a).filter(([e,t])=>!T.keys.has(e)&&t instanceof T).forEach(([e,t])=>i(t,u.concat(e))),H(a.value)){if(t===z.Hydrate)return a.value;const i=u.slice(0,-1),l=i.length>0?$(r,i.join(".")):r;return e.isNullable(l)||I(l,a,u.at(-1),o,c,s),n??a.value}if(t===z.Hydrate){const e=F(i(a.value,u));return I(e,a,null,o,c,s),e}const l=n??F(a.value);return I(l,a,null,o,c,s),e.isNullable(n)?l:(i(a.value,u),n)}if(e.isArray(a))return a.map((e,t)=>i(e,u.concat(t)));if(e.isObject(a)){const e=Object.entries(a).map(([e,t])=>[e,i(t,u.concat(e))]),n=Object.fromEntries(e);if(t===z.Hydrate){const e=F(n);return Object.entries(a).forEach(([t,n])=>{n instanceof T&&H(n.value)&&I(e,n,t,o,c,s)}),e}return n}return a}(n.value)}function I(e,t,n,r,o,c){const s=c(e),i=o.get(s)??[];o.set(s,[t.assign(n,r),...i])}class G{#e={};#t;#n=/* @__PURE__ */new Map;#r=/* @__PURE__ */new Set;#o=!1;constructor(e=W){this.#t=e}static pk(){return N()}static"κ"=G.pk;annotate(e,t){return new T(t,e)}"δ"=this.annotate;get model(){return this.#e}get inspect(){return function(n,r,o,c,s){function i(c){const s=c.at(-1),i=$(n(),c),a=c.slice(0,-1),u=t.isNotEmpty(a)?$(n(),a):n();return[...e.isObject(i)||e.isArray(i)?r.get(o(i))?.filter(t=>e.isNullable(t.property))??[]:[],...e.isObject(u)?r.get(o(u))?.filter(e=>e.property===s)??[]:[]]}return function e(r){return new Proxy(()=>{},{get:(o,a)=>"pending"===a?()=>!t.isEmpty(i(r)):"remaining"===a?()=>t.length(i(r)):"box"===a?()=>({value:$(n(),r),inspect:e(r)}):"is"===a?e=>i(r).some(t=>0!==(t.operation&e)):"draft"===a?()=>t.head(i(r))?.value??$(n(),r):"settled"===a?()=>new Promise(e=>{if(t.isEmpty(i(r)))return e($(n(),r));const o=()=>{t.isEmpty(i(r))&&(s(o),e($(n(),r)))};c(o)}):e([...r,String(a)])})}([])}(()=>this.#e,this.#n,this.#t,e=>this.#r.add(e),e=>this.#r.delete(e))}hydrate(e){return this.#o=!0,this.#c(z.Hydrate,()=>e)}produce(e){if(!this.#o)throw new Error("State must be hydrated using hydrate() before calling produce()");return this.#c(z.Produce,e)}#c(e,t){const n=/* @__PURE__ */Symbol("process"),[,r]=B.immer.produceWithPatches(this.#e,t);return this.#e=r.reduce((t,r)=>B.immer.applyPatches(t,[{...r,value:D(e,r,t,n,this.#n,this.#t)}]),this.#e),this.#e=F(this.#e),this.#s(),n}prune(e){this.#n.forEach((n,r)=>{const o=n.filter(t=>t.process!==e);t.isEmpty(o)?this.#n.delete(r):this.#n.set(r,o)}),this.#s()}#s(){this.#r.forEach(e=>e())}observe(e){const t=()=>e(this.#e);return this.#r.add(t),()=>this.#r.delete(t)}}const V=new G;function q(e,t){return V.annotate(e,t)}function J(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var K,Q={exports:{}};const X=/* @__PURE__ */J((K||(K=1,function(e){var t=Object.prototype.hasOwnProperty,n="~";function r(){}function o(e,t,n){this.fn=e,this.context=t,this.once=n||!1}function c(e,t,r,c,s){if("function"!=typeof r)throw new TypeError("The listener must be a function");var i=new o(r,c||e,s),a=n?n+t:t;return e._events[a]?e._events[a].fn?e._events[a]=[e._events[a],i]:e._events[a].push(i):(e._events[a]=i,e._eventsCount++),e}function s(e,t){0===--e._eventsCount?e._events=new r:delete e._events[t]}function i(){this._events=new r,this._eventsCount=0}Object.create&&(r.prototype=/* @__PURE__ */Object.create(null),(new r).__proto__||(n=!1)),i.prototype.eventNames=function(){var e,r,o=[];if(0===this._eventsCount)return o;for(r in e=this._events)t.call(e,r)&&o.push(n?r.slice(1):r);return Object.getOwnPropertySymbols?o.concat(Object.getOwnPropertySymbols(e)):o},i.prototype.listeners=function(e){var t=this._events[n?n+e:e];if(!t)return[];if(t.fn)return[t.fn];for(var r=0,o=t.length,c=new Array(o);r<o;r++)c[r]=t[r].fn;return c},i.prototype.listenerCount=function(e){var t=this._events[n?n+e:e];return t?t.fn?1:t.length:0},i.prototype.emit=function(e,t,r,o,c,s){var i=n?n+e:e;if(!this._events[i])return!1;var a,u,l=this._events[i],f=arguments.length;if(l.fn){switch(l.once&&this.removeListener(e,l.fn,void 0,!0),f){case 1:return l.fn.call(l.context),!0;case 2:return l.fn.call(l.context,t),!0;case 3:return l.fn.call(l.context,t,r),!0;case 4:return l.fn.call(l.context,t,r,o),!0;case 5:return l.fn.call(l.context,t,r,o,c),!0;case 6:return l.fn.call(l.context,t,r,o,c,s),!0}for(u=1,a=new Array(f-1);u<f;u++)a[u-1]=arguments[u];l.fn.apply(l.context,a)}else{var d,p=l.length;for(u=0;u<p;u++)switch(l[u].once&&this.removeListener(e,l[u].fn,void 0,!0),f){case 1:l[u].fn.call(l[u].context);break;case 2:l[u].fn.call(l[u].context,t);break;case 3:l[u].fn.call(l[u].context,t,r);break;case 4:l[u].fn.call(l[u].context,t,r,o);break;default:if(!a)for(d=1,a=new Array(f-1);d<f;d++)a[d-1]=arguments[d];l[u].fn.apply(l[u].context,a)}}return!0},i.prototype.on=function(e,t,n){return c(this,e,t,n,!1)},i.prototype.once=function(e,t,n){return c(this,e,t,n,!0)},i.prototype.removeListener=function(e,t,r,o){var c=n?n+e:e;if(!this._events[c])return this;if(!t)return s(this,c),this;var i=this._events[c];if(i.fn)i.fn!==t||o&&!i.once||r&&i.context!==r||s(this,c);else{for(var a=0,u=[],l=i.length;a<l;a++)(i[a].fn!==t||o&&!i[a].once||r&&i[a].context!==r)&&u.push(i[a]);u.length?this._events[c]=1===u.length?u[0]:u:s(this,c)}return this},i.prototype.removeAllListeners=function(e){var t;return e?this._events[t=n?n+e:e]&&s(this,t):(this._events=new r,this._eventsCount=0),this},i.prototype.off=i.prototype.removeListener,i.prototype.addListener=i.prototype.on,i.prefixed=n,i.EventEmitter=i,e.exports=i}(Q)),Q.exports)),Y=n.createContext(new X);function Z(){return n.useContext(Y)}function ee({children:e}){const t=n.useMemo(()=>new X,[]);/* @__PURE__ */
-return c(Y.Provider,{value:t,children:e})}const te=n.createContext(/* @__PURE__ */new Map);function ne(){return n.useContext(te)}function re(){const[,e]=n.useReducer(e=>e+1,0);return e}function oe({action:t,renderer:r}){const o=Z(),c=ne(),s=re(),i=n.useMemo(()=>{const e=c.get(t);if(e)return e;const n={state:new G,listeners:/* @__PURE__ */new Set};return c.set(t,n),n},[t,c]);n.useLayoutEffect(()=>{function e(e){i.state.hydrate({value:e}),i.listeners.forEach(e=>e())}return i.listeners.add(s),o.on(t,e),()=>{i.listeners.delete(s),o.off(t,e)}},[t,o,i]);const a=i.state.model?.value;return e.isNullable(a)?null:r({value:a,inspect:i.state.inspect.value})}function ce({children:e}){const t=n.useMemo(()=>/* @__PURE__ */new Map,[]);/* @__PURE__ */
-return c(te.Provider,{value:t,children:e})}function se({children:e}){const t=n.useMemo(()=>({data:/* @__PURE__ */new Map}),[]);/* @__PURE__ */
-return c(A.Provider,{value:t,children:e})}const ie=n.createContext(/* @__PURE__ */new Set);function ae({children:e}){const t=n.useMemo(()=>/* @__PURE__ */new Set,[]);/* @__PURE__ */
-return c(ie.Provider,{value:t,children:e})}function ue({children:e}){/* @__PURE__ */
-return c(ee,{children:/* @__PURE__ */c(ce,{children:/* @__PURE__ */c(se,{children:/* @__PURE__ */c(ae,{children:e})})})})}const le=n.createContext(null);function fe(){return n.useContext(le)}function de(e,t){return e?.get(t)??null}function pe({action:t,scopeName:r,renderer:o}){const c=fe(),s=re(),i=n.useMemo(()=>de(c,r),[c,r]),a=n.useMemo(()=>i?function(e,t){const n=e.store.get(t);if(n)return n;const r={state:new G,listeners:/* @__PURE__ */new Set};return e.store.set(t,r),r}(i,t):null,[t,i]);if(n.useLayoutEffect(()=>{if(i&&a)return a.listeners.add(s),i.emitter.on(t,e),()=>{a.listeners.delete(s),i.emitter.off(t,e)};function e(e){a&&(a.state.hydrate({value:e}),a.listeners.forEach(e=>e()))}},[t,i,a,s]),!a)return null;const u=a.state.model?.value;return e.isNullable(u)?null:o({value:u,inspect:a.state.inspect.value})}function he({name:e,children:t}){const r=fe(),o=n.useMemo(()=>({name:e,emitter:new X,store:/* @__PURE__ */new Map,listeners:/* @__PURE__ */new Map}),[]),s=n.useMemo(()=>{const t=new Map(r??[]);return t.set(e,o),t},[r,e,o]);/* @__PURE__ */
-return c(le.Provider,{value:s,children:t})}function me(e){return(t,n)=>{t.actions.produce(t=>{t.model[e]=n})}}function ye(r,c=()=>({})){const s=Z(),i=fe(),a=o(R),f=n.useContext(ie),p=re(),h=n.useRef(!1),m=n.useRef(null),y=n.useRef(new G),{model:b,save:v}=function(e){const t=n.useContext(A),r=n.useRef(null);if(!r.current)if("object"==typeof(o=e)&&null!==o&&u.Rehydrate in o&&!0===o[u.Rehydrate]){const{channel:n,model:o}=e,c=function(e,t){const n=O(t);return e.data.get(n)||null}(t,n);r.current={model:c??o,save:e=>function(e,t,n){const r=O(t);e.data.set(r,n)}(t,n,e)}}else r.current={model:e,save:()=>{}};var o;return r.current}(r);h.current||(h.current=!0,m.current=y.current.hydrate(b));const[g,M]=n.useState(()=>y.current.model),j=function(e){const t=n.useRef(e);return n.useLayoutEffect(()=>{t.current=e},[e]),n.useMemo(()=>{return n=t,Object.keys(e).reduce((e,t)=>(Object.defineProperty(e,t,{get:()=>n.current[t],enumerable:!0}),e),{});var n},[e])}(c()),C=n.useMemo(()=>new X,[]),N=n.useRef({handlers:/* @__PURE__ */new Map});N.current.handlers=/* @__PURE__ */new Map;const U=function(){const e=n.useRef(/* @__PURE__ */new Set),t=n.useRef(/* @__PURE__ */new Set);return n.useMemo(()=>({broadcast:e.current,multicast:t.current}),[])}(),z=n.useRef(d.Mounting),L=function(){const e=n.useRef({}),t=n.useRef(/* @__PURE__ */new Map),r=n.useRef(/* @__PURE__ */new Map);return n.useMemo(()=>({refs:e,pending:t,emitted:r}),[])}(),T=n.useRef(/* @__PURE__ */new Set),B=n.useRef(0),$=n.useCallback((e,t,n)=>{const r=new AbortController,o={controller:r,action:e,payload:t};return f.add(o),T.current.add(o),{model:g,get phase(){return z.current},task:o,data:j,tasks:f,nodes:L.refs.current,actions:{produce(e){if(r.signal.aborted)return;const t=y.current.produce(t=>e({model:t,inspect:y.current.inspect}));M(y.current.model),n.processes.add(t),m.current&&(n.processes.add(m.current),m.current=null)},dispatch(e,t,n){if(r.signal.aborted)return;const o=w(e),c=P(e)?e.channel:void 0;if(E(e)&&n?.scope){const e=de(i,n.scope);return void(e&&e.emitter.emit(o,t,c))}(S(e)?s:C).emit(o,t,c)},annotate:(e,t)=>y.current.annotate(e,t)}}},[g]);n.useLayoutEffect(()=>{function t(t,n,r){return async function(o,c){const s=r();if(e.isNotNullable(c)&&e.isNotNullable(s)&&!function(e,t){for(const n of Object.keys(e))if(t[n]!==e[n])return!1;return!0}(c,s))return;const i={processes:/* @__PURE__ */new Set},u=Promise.withResolvers(),d=$(t,o,i);try{await n(d,o)}catch(h){const e=N.current.handlers.has(l.Error),n={reason:_(h),error:k(h),action:x(t),handled:e,tasks:f};a?.(n),e&&C.emit(l.Error,n)}finally{for(const e of f)if(e===d.task){f.delete(e),T.current.delete(e);break}i.processes.forEach(e=>y.current.prune(e)),i.processes.size>0&&p(),u.resolve()}}}B.current++;const n=/* @__PURE__ */new Set;return N.current.handlers.forEach((e,r)=>{for(const{getChannel:o,handler:c}of e){const e=t(r,c,o);if(E(r)){if(i)for(const t of i.values()){const o=t.emitter;o.on(r,e),n.add(()=>o.off(r,e))}C.on(r,e),U.multicast.add(r),n.add(()=>C.off(r,e))}else S(r)?(s.on(r,e),C.on(r,e),U.broadcast.add(r),n.add(()=>{s.off(r,e),C.off(r,e)})):(C.on(r,e),n.add(()=>C.off(r,e)))}}),()=>{const e=++B.current,t=new Set(n);queueMicrotask(()=>{if(B.current===e){v(y.current.model);for(const e of T.current)e.controller.abort(),f.delete(e);T.current.clear(),z.current=d.Unmounting,C.emit(l.Unmount),z.current=d.Unmounted;for(const e of t)e()}else for(const e of t)e()})}},[C]),n.useLayoutEffect(()=>{for(const[e,t]of L.pending.current)L.emitted.current.get(e)!==t&&(L.emitted.current.set(e,t),C.emit(u.Node,t,{Name:e}));L.pending.current.clear()}),function({unicast:r,broadcastActions:o,phase:c,data:s}){const i=ne(),a=n.useRef(null);n.useLayoutEffect(()=>{c.current===d.Mounting&&(r.emit(l.Mount),o.forEach(t=>{const n=i.get(t),o=n?.state.model?.value;e.isNullable(o)||r.emit(t,o)}),c.current=d.Mounted)},[]),n.useLayoutEffect(()=>{if(e.isNotNullable(a.current)){const e=function(e,t){return Object.keys(t).reduce((n,r)=>e[r]!==t[r]?{...n,[r]:t[r]}:n,{})}(a.current,s);t.isNotEmpty(Object.keys(e))&&r.emit(l.Update,e)}a.current=s},[s,r])}({unicast:C,broadcastActions:U.broadcast,phase:z,data:c()});const F=n.useMemo(()=>[g,{dispatch(e,t,n){const r=w(e),o=P(e)?e.channel:void 0;if(E(e)&&n?.scope){const e=de(i,n.scope);return void(e&&e.emitter.emit(r,t,o))}(S(e)?s:C).emit(r,t,o)},consume:(e,t,r)=>E(e)&&r?.scope?n.createElement(pe,{action:w(e),scopeName:r.scope,renderer:t}):n.createElement(oe,{action:w(e),renderer:t}),get inspect(){return y.current.inspect},get nodes(){return L.refs.current},node(e,t){L.refs.current[e]=t,L.pending.current.set(e,t)}}],[g,C]);return F.useAction=(e,t)=>{!function(e,t,r){const o=n.useRef(r);n.useLayoutEffect(()=>{o.current=r});const c=n.useRef(t);n.useLayoutEffect(()=>{c.current=t});const s=n.useCallback(async(e,t)=>{const n=o.current;if("GeneratorFunction"===n.constructor.name||"AsyncGeneratorFunction"===n.constructor.name){const r=n(e,t);for await(const e of r);}else await n(e,t)},[]),i=n.useCallback(()=>P(c.current)?c.current.channel:void 0,[]),a=w(t),u=e.current.handlers.get(a)??/* @__PURE__ */new Set;0===u.size&&e.current.handlers.set(a,u),u.add({getChannel:i,handler:s})}(N,e,t)},F}export{M as Action,ue as Boundary,f as Distribution,C as Error,l as Lifecycle,U as Op,U as Operation,p as Reason,j as Rehydrate,he as Scope,G as State,me as With,q as annotate,ye as useActions,v as utils};
+import{G as e,A as t}from"@mobily/ts-belt";import{jsx as n}from"react/jsx-runtime";import*as r from"react";import{createContext as o,useContext as c}from"react";import{immerable as i,enablePatches as s,Immer as a}from"immer";class u{static Payload=/* @__PURE__ */Symbol("chizu.brand/Payload");static Broadcast=/* @__PURE__ */Symbol("chizu.brand/Broadcast");static Multicast=/* @__PURE__ */Symbol("chizu.brand/Multicast");static Action=/* @__PURE__ */Symbol("chizu.brand/Action");static Channel=/* @__PURE__ */Symbol("chizu.brand/Channel");static Node=/* @__PURE__ */Symbol("chizu.action.lifecycle/Node");static Cache=/* @__PURE__ */Symbol("chizu.brand/Cache")}class l{static Mount=/* @__PURE__ */Symbol("chizu.action.lifecycle/Mount");static Unmount=/* @__PURE__ */Symbol("chizu.action.lifecycle/Unmount");static Error=/* @__PURE__ */Symbol("chizu.action.lifecycle/Error");static Update=/* @__PURE__ */Symbol("chizu.action.lifecycle/Update");static Node=(()=>{const e=u.Node,t=function(t){return{[u.Action]:e,[u.Payload]:void 0,[u.Channel]:t,channel:t}};return Object.defineProperty(t,u.Action,{value:e,enumerable:!1}),Object.defineProperty(t,u.Payload,{value:void 0,enumerable:!1}),t})()}var f=/* @__PURE__ */(e=>(e.Unicast="unicast",e.Broadcast="broadcast",e.Multicast="multicast",e))(f||{}),d=/* @__PURE__ */(e=>(e.Mounting="mounting",e.Mounted="mounted",e.Unmounting="unmounting",e.Unmounted="unmounted",e))(d||{}),p=/* @__PURE__ */(e=>(e[e.Timedout=0]="Timedout",e[e.Supplanted=1]="Supplanted",e[e.Disallowed=2]="Disallowed",e[e.Errored=3]="Errored",e[e.Unmounted=4]="Unmounted",e))(p||{});class h extends Error{name="AbortError";constructor(e="Aborted"){super(e)}}const m={actionPrefix:"chizu.action/",broadcastActionPrefix:"chizu.action/broadcast/",multicastActionPrefix:"chizu.action/multicast/",channelPrefix:"chizu.channel/",cachePrefix:"chizu.cache/"};function y(e,t){return new Promise((n,r)=>{if(t?.aborted)return void r(new h);const o=setTimeout(n,e);t?.addEventListener("abort",()=>{clearTimeout(o),r(new h)},{once:!0})})}function b(e){return e?Boolean(e&&"symbol"!=typeof e):/* @__PURE__ */Symbol(`pk.${Date.now()}.${crypto.randomUUID()}`)}const v=/* @__PURE__ */Object.freeze(/* @__PURE__ */Object.defineProperty({__proto__:null,config:m,pk:b,sleep:y,"ζ":y,"κ":b},Symbol.toStringTag,{value:"Module"})),g=e=>"symbol"==typeof e;function w(t){return e.isString(t)||g(t)?t:(e.isObject(t)||e.isFunction(t))&&u.Action in t?t[u.Action]:t}function S(t){if(e.isString(t))return t.startsWith(m.broadcastActionPrefix);if(g(t))return t.description?.startsWith(m.broadcastActionPrefix)??!1;if(e.isObject(t)||e.isFunction(t)){if(u.Broadcast in t&&t[u.Broadcast])return!0;if(u.Action in t){const e=t[u.Action];return e.description?.startsWith(m.broadcastActionPrefix)??!1}}return!1}function x(t){const n=w(t),r=e.isString(n)?n:n.description??"";return r.startsWith(m.actionPrefix)&&r.slice(r.lastIndexOf("/")+1)||"unknown"}function P(t){return e.isObject(t)&&u.Channel in t&&"channel"in t}function E(t){if(e.isString(t))return t.startsWith(m.multicastActionPrefix);if(g(t))return t.description?.startsWith(m.multicastActionPrefix)??!1;if(e.isObject(t)||e.isFunction(t)){if(u.Multicast in t&&t[u.Multicast])return!0;if(u.Action in t){const e=t[u.Action];return e.description?.startsWith(m.multicastActionPrefix)??!1}}return!1}const M=(e,t=f.Unicast)=>{const n=t===f.Broadcast?/* @__PURE__ */Symbol(`${m.broadcastActionPrefix}${e}`):t===f.Multicast?/* @__PURE__ */Symbol(`${m.multicastActionPrefix}${e}`):/* @__PURE__ */Symbol(`${m.actionPrefix}${e}`),r=function(e){return{[u.Action]:n,[u.Payload]:void 0,[u.Channel]:e,channel:e}};return Object.defineProperty(r,u.Action,{value:n,enumerable:!1}),Object.defineProperty(r,u.Payload,{value:void 0,enumerable:!1}),t===f.Broadcast&&Object.defineProperty(r,u.Broadcast,{value:!0,enumerable:!1}),t===f.Multicast&&Object.defineProperty(r,u.Multicast,{value:!0,enumerable:!1}),r};function A(){const e=/* @__PURE__ */Symbol("chizu.cache/Entry"),t=function(t){return{[u.Cache]:e,channel:t}};return Object.defineProperty(t,u.Cache,{value:e,enumerable:!1}),t}function O(e){const t=function(e){return e[u.Cache]}(e),n=function(e){return"channel"in e}(e)&&(r=e.channel)?[...Object.keys(r)].toSorted().map(e=>`${e}=${String(r[e])}`).join("&"):"";var r;return`${String(t)}:${n}`}function j(e){if(e instanceof Error){if("TimeoutError"===e.name)return p.Timedout;if("AbortError"===e.name)return p.Supplanted}return p.Errored}function k(e){return e instanceof Error?e:new Error(String(e))}const C=o(void 0);function _({handler:e,children:t}){/* @__PURE__ */
+return n(C.Provider,{value:e,children:t})}let N=(e=21)=>{let t="",n=crypto.getRandomValues(new Uint8Array(e|=0));for(;e--;)t+="useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict"[63&n[e]];return t};var R=/* @__PURE__ */(e=>(e[e.Add=1]="Add",e[e.Remove=2]="Remove",e[e.Update=4]="Update",e[e.Move=8]="Move",e[e.Replace=16]="Replace",e[e.Sort=32]="Sort",e[e.Create=64]="Create",e[e.Fetch=128]="Fetch",e[e.Clone=256]="Clone",e[e.Archive=512]="Archive",e[e.Restore=1024]="Restore",e[e.Merge=2048]="Merge",e[e.Reorder=4096]="Reorder",e[e.Sync=8192]="Sync",e[e.Publish=16384]="Publish",e[e.Link=32768]="Link",e[e.Unlink=65536]="Unlink",e[e.Lock=131072]="Lock",e[e.Unlock=262144]="Unlock",e[e.Import=524288]="Import",e[e.Export=1048576]="Export",e[e.Transfer=2097152]="Transfer",e))(R||{}),U=/* @__PURE__ */(e=>(e[e.Produce=0]="Produce",e[e.Hydrate=1]="Hydrate",e))(U||{}),z=/* @__PURE__ */(e=>(e.Property="property",e.Process="process",e.Value="value",e.Operation="operation",e))(z||{});class L{[i]=!0;static keys=new Set(Object.values(z));property=null;process=null;value;operation;constructor(e,t){this.value=e,this.operation=t}assign(e,t){const n=new L(this.value,this.operation);return n.property=e,n.process=t,n}}class T{static immer=(()=>{s();const e=new a;return e.setAutoFreeze(!1),e})();static tag="κ";static id=N}function $(e,t){const n="string"==typeof t?""===t?[]:t.split("."):t;let r=e;for(const o of n){if(null==r)return;r=r[o]}return r}function B(t){if(e.isNullable(t)||W(t))return t;if(e.isArray(t))return t.map(e=>B(e));if(e.isObject(t)){const e=Object.entries(t).map(([e,t])=>[e,B(t)]);return{...Object.fromEntries(e),[T.tag]:t[T.tag]??T.id()}}return t}function F(e){if(Array.isArray(e))return e.filter(e=>T.tag in e).map(e=>e[T.tag]??"").join(",");const t=e[T.tag];if(t)return t;try{return JSON.stringify(e)}catch{return`[unserializable:${typeof e}]`}}function W(t){return e.isNullable(t)||e.isString(t)||e.isNumber(t)||e.isBoolean(t)||"symbol"==typeof t||"bigint"==typeof t}function D(t,n,r,o,c,i){return function s(a,u=n.path){if(a instanceof L){const n=$(r,u.join("."));if(Object.entries(a).filter(([e,t])=>!L.keys.has(e)&&t instanceof L).forEach(([e,t])=>s(t,u.concat(e))),W(a.value)){if(t===U.Hydrate)return a.value;const s=u.slice(0,-1),l=s.length>0?$(r,s.join(".")):r;return e.isNullable(l)||H(l,a,u.at(-1),o,c,i),n??a.value}if(t===U.Hydrate){const e=B(s(a.value,u));return H(e,a,null,o,c,i),e}const l=n??B(a.value);return H(l,a,null,o,c,i),e.isNullable(n)?l:(s(a.value,u),n)}if(e.isArray(a))return a.map((e,t)=>s(e,u.concat(t)));if(e.isObject(a)){const e=Object.entries(a).map(([e,t])=>[e,s(t,u.concat(e))]),n=Object.fromEntries(e);if(t===U.Hydrate){const e=B(n);return Object.entries(a).forEach(([t,n])=>{n instanceof L&&W(n.value)&&H(e,n,t,o,c,i)}),e}return n}return a}(n.value)}function H(e,t,n,r,o,c){const i=c(e),s=o.get(i)??[];o.set(i,[t.assign(n,r),...s])}class G{#e={};#t;#n=/* @__PURE__ */new Map;#r=/* @__PURE__ */new Set;#o=!1;constructor(e=F){this.#t=e}static pk(){return N()}static"κ"=G.pk;annotate(e,t){return new L(t,e)}"δ"=this.annotate;get model(){return this.#e}get inspect(){return function(n,r,o,c,i){function s(c){const i=c.at(-1),s=$(n(),c),a=c.slice(0,-1),u=t.isNotEmpty(a)?$(n(),a):n();return[...e.isObject(s)||e.isArray(s)?r.get(o(s))?.filter(t=>e.isNullable(t.property))??[]:[],...e.isObject(u)?r.get(o(u))?.filter(e=>e.property===i)??[]:[]]}return function e(r){return new Proxy(()=>{},{get:(o,a)=>"pending"===a?()=>!t.isEmpty(s(r)):"remaining"===a?()=>t.length(s(r)):"box"===a?()=>({value:$(n(),r),inspect:e(r)}):"is"===a?e=>s(r).some(t=>0!==(t.operation&e)):"draft"===a?()=>t.head(s(r))?.value??$(n(),r):"settled"===a?()=>new Promise(e=>{if(t.isEmpty(s(r)))return e($(n(),r));const o=()=>{t.isEmpty(s(r))&&(i(o),e($(n(),r)))};c(o)}):e([...r,String(a)])})}([])}(()=>this.#e,this.#n,this.#t,e=>this.#r.add(e),e=>this.#r.delete(e))}hydrate(e){return this.#o=!0,this.#c(U.Hydrate,()=>e)}produce(e){if(!this.#o)throw new Error("State must be hydrated using hydrate() before calling produce()");return this.#c(U.Produce,e)}#c(e,t){const n=/* @__PURE__ */Symbol("process"),[,r]=T.immer.produceWithPatches(this.#e,t);return this.#e=r.reduce((t,r)=>T.immer.applyPatches(t,[{...r,value:D(e,r,t,n,this.#n,this.#t)}]),this.#e),this.#e=B(this.#e),this.#i(),n}prune(e){this.#n.forEach((n,r)=>{const o=n.filter(t=>t.process!==e);t.isEmpty(o)?this.#n.delete(r):this.#n.set(r,o)}),this.#i()}#i(){this.#r.forEach(e=>e())}observe(e){const t=()=>e(this.#e);return this.#r.add(t),()=>this.#r.delete(t)}}const I=new G;function V(e,t){return I.annotate(e,t)}function q(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var J,K={exports:{}};const Q=/* @__PURE__ */q((J||(J=1,function(e){var t=Object.prototype.hasOwnProperty,n="~";function r(){}function o(e,t,n){this.fn=e,this.context=t,this.once=n||!1}function c(e,t,r,c,i){if("function"!=typeof r)throw new TypeError("The listener must be a function");var s=new o(r,c||e,i),a=n?n+t:t;return e._events[a]?e._events[a].fn?e._events[a]=[e._events[a],s]:e._events[a].push(s):(e._events[a]=s,e._eventsCount++),e}function i(e,t){0===--e._eventsCount?e._events=new r:delete e._events[t]}function s(){this._events=new r,this._eventsCount=0}Object.create&&(r.prototype=/* @__PURE__ */Object.create(null),(new r).__proto__||(n=!1)),s.prototype.eventNames=function(){var e,r,o=[];if(0===this._eventsCount)return o;for(r in e=this._events)t.call(e,r)&&o.push(n?r.slice(1):r);return Object.getOwnPropertySymbols?o.concat(Object.getOwnPropertySymbols(e)):o},s.prototype.listeners=function(e){var t=this._events[n?n+e:e];if(!t)return[];if(t.fn)return[t.fn];for(var r=0,o=t.length,c=new Array(o);r<o;r++)c[r]=t[r].fn;return c},s.prototype.listenerCount=function(e){var t=this._events[n?n+e:e];return t?t.fn?1:t.length:0},s.prototype.emit=function(e,t,r,o,c,i){var s=n?n+e:e;if(!this._events[s])return!1;var a,u,l=this._events[s],f=arguments.length;if(l.fn){switch(l.once&&this.removeListener(e,l.fn,void 0,!0),f){case 1:return l.fn.call(l.context),!0;case 2:return l.fn.call(l.context,t),!0;case 3:return l.fn.call(l.context,t,r),!0;case 4:return l.fn.call(l.context,t,r,o),!0;case 5:return l.fn.call(l.context,t,r,o,c),!0;case 6:return l.fn.call(l.context,t,r,o,c,i),!0}for(u=1,a=new Array(f-1);u<f;u++)a[u-1]=arguments[u];l.fn.apply(l.context,a)}else{var d,p=l.length;for(u=0;u<p;u++)switch(l[u].once&&this.removeListener(e,l[u].fn,void 0,!0),f){case 1:l[u].fn.call(l[u].context);break;case 2:l[u].fn.call(l[u].context,t);break;case 3:l[u].fn.call(l[u].context,t,r);break;case 4:l[u].fn.call(l[u].context,t,r,o);break;default:if(!a)for(d=1,a=new Array(f-1);d<f;d++)a[d-1]=arguments[d];l[u].fn.apply(l[u].context,a)}}return!0},s.prototype.on=function(e,t,n){return c(this,e,t,n,!1)},s.prototype.once=function(e,t,n){return c(this,e,t,n,!0)},s.prototype.removeListener=function(e,t,r,o){var c=n?n+e:e;if(!this._events[c])return this;if(!t)return i(this,c),this;var s=this._events[c];if(s.fn)s.fn!==t||o&&!s.once||r&&s.context!==r||i(this,c);else{for(var a=0,u=[],l=s.length;a<l;a++)(s[a].fn!==t||o&&!s[a].once||r&&s[a].context!==r)&&u.push(s[a]);u.length?this._events[c]=1===u.length?u[0]:u:i(this,c)}return this},s.prototype.removeAllListeners=function(e){var t;return e?this._events[t=n?n+e:e]&&i(this,t):(this._events=new r,this._eventsCount=0),this},s.prototype.off=s.prototype.removeListener,s.prototype.addListener=s.prototype.on,s.prefixed=n,s.EventEmitter=s,e.exports=s}(K)),K.exports)),X=r.createContext(new Q);function Y(){return r.useContext(X)}function Z({children:e}){const t=r.useMemo(()=>new Q,[]);/* @__PURE__ */
+return n(X.Provider,{value:t,children:e})}const ee=r.createContext(/* @__PURE__ */new Map);function te(){return r.useContext(ee)}function ne(){const[,e]=r.useReducer(e=>e+1,0);return e}function re({action:t,renderer:n}){const o=Y(),c=te(),i=ne(),s=r.useMemo(()=>{const e=c.get(t);if(e)return e;const n={state:new G,listeners:/* @__PURE__ */new Set};return c.set(t,n),n},[t,c]);r.useLayoutEffect(()=>{function e(e){s.state.hydrate({value:e}),s.listeners.forEach(e=>e())}return s.listeners.add(i),o.on(t,e),()=>{s.listeners.delete(i),o.off(t,e)}},[t,o,s]);const a=s.state.model?.value;return e.isNullable(a)?null:n({value:a,inspect:s.state.inspect.value})}function oe({children:e}){const t=r.useMemo(()=>/* @__PURE__ */new Map,[]);/* @__PURE__ */
+return n(ee.Provider,{value:t,children:e})}const ce=r.createContext(/* @__PURE__ */new Map);function ie({children:e}){const t=r.useMemo(()=>/* @__PURE__ */new Map,[]);/* @__PURE__ */
+return n(ce.Provider,{value:t,children:e})}const se=r.createContext(/* @__PURE__ */new Set);function ae({children:e}){const t=r.useMemo(()=>/* @__PURE__ */new Set,[]);/* @__PURE__ */
+return n(se.Provider,{value:t,children:e})}function ue({children:e}){/* @__PURE__ */
+return n(Z,{children:/* @__PURE__ */n(oe,{children:/* @__PURE__ */n(ie,{children:/* @__PURE__ */n(ae,{children:e})})})})}const le=r.createContext(null);function fe(){return r.useContext(le)}function de(e,t){return e?.get(t)??null}function pe({action:t,scopeName:n,renderer:o}){const c=fe(),i=ne(),s=r.useMemo(()=>de(c,n),[c,n]),a=r.useMemo(()=>s?function(e,t){const n=e.store.get(t);if(n)return n;const r={state:new G,listeners:/* @__PURE__ */new Set};return e.store.set(t,r),r}(s,t):null,[t,s]);if(r.useLayoutEffect(()=>{if(s&&a)return a.listeners.add(i),s.emitter.on(t,e),()=>{a.listeners.delete(i),s.emitter.off(t,e)};function e(e){a&&(a.state.hydrate({value:e}),a.listeners.forEach(e=>e()))}},[t,s,a,i]),!a)return null;const u=a.state.model?.value;return e.isNullable(u)?null:o({value:u,inspect:a.state.inspect.value})}function he({name:e,children:t}){const o=fe(),c=r.useMemo(()=>({name:e,emitter:new Q,store:/* @__PURE__ */new Map,listeners:/* @__PURE__ */new Map}),[]),i=r.useMemo(()=>{const t=new Map(o??[]);return t.set(e,c),t},[o,e,c]);/* @__PURE__ */
+return n(le.Provider,{value:i,children:t})}function me(e){return(t,n)=>{t.actions.produce(t=>{t.model[e]=n})}}function ye(n,o=()=>({})){const i=Y(),s=fe(),a=c(C),f=r.useContext(se),p=r.useContext(ce),h=ne(),m=r.useRef(!1),y=r.useRef(null),b=r.useRef(new G);m.current||(m.current=!0,y.current=b.current.hydrate(n));const[v,g]=r.useState(()=>b.current.model),M=function(e){const t=r.useRef(e);return r.useLayoutEffect(()=>{t.current=e},[e]),r.useMemo(()=>{return n=t,Object.keys(e).reduce((e,t)=>(Object.defineProperty(e,t,{get:()=>n.current[t],enumerable:!0}),e),{});var n},[e])}(o()),A=r.useMemo(()=>new Q,[]),_=r.useRef({handlers:/* @__PURE__ */new Map});_.current.handlers=/* @__PURE__ */new Map;const N=function(){const e=r.useRef(/* @__PURE__ */new Set),t=r.useRef(/* @__PURE__ */new Set);return r.useMemo(()=>({broadcast:e.current,multicast:t.current}),[])}(),R=r.useRef(d.Mounting),U=function(){const e=r.useRef({}),t=r.useRef(/* @__PURE__ */new Map),n=r.useRef(/* @__PURE__ */new Map);return r.useMemo(()=>({refs:e,pending:t,emitted:n}),[])}(),z=r.useRef(/* @__PURE__ */new Set),L=r.useRef(0),T=r.useCallback((e,t,n)=>{const r=new AbortController,o={controller:r,action:e,payload:t};return f.add(o),z.current.add(o),{model:v,get phase(){return R.current},task:o,data:M,tasks:f,nodes:U.refs.current,actions:{produce(e){if(r.signal.aborted)return;const t=b.current.produce(t=>e({model:t,inspect:b.current.inspect}));g(b.current.model),n.processes.add(t),y.current&&(n.processes.add(y.current),y.current=null)},dispatch(e,t,n){if(r.signal.aborted)return;const o=w(e),c=P(e)?e.channel:void 0;if(E(e)&&n?.scope){const e=de(s,n.scope);return void(e&&e.emitter.emit(o,t,c))}(S(e)?i:A).emit(o,t,c)},annotate:(e,t)=>b.current.annotate(e,t),async cacheable(e,t,n){if(r.signal.aborted)return{data:null};const o=O(e),c=p.get(o);if(c&&Date.now()<c.expiry)return{data:c.value};const i=function(e){return null!=e&&"object"==typeof e&&"TAG"in e?0===e.TAG?{ok:!0,value:e._0}:{ok:!1}:null==e?{ok:!1}:{ok:!0,value:e}}(await n());return i.ok?(p.set(o,{value:i.value,expiry:Date.now()+t}),{data:i.value}):{data:null}},invalidate(e){p.delete(O(e))}}}},[v]);r.useLayoutEffect(()=>{function t(t,n,r){return async function(o,c){const i=r();if(e.isNotNullable(c)&&e.isNotNullable(i)&&!function(e,t){for(const n of Object.keys(e))if(t[n]!==e[n])return!1;return!0}(c,i))return;const s={processes:/* @__PURE__ */new Set},u=Promise.withResolvers(),d=T(t,o,s);try{await n(d,o)}catch(p){const e=_.current.handlers.has(l.Error),n={reason:j(p),error:k(p),action:x(t),handled:e,tasks:f};a?.(n),e&&A.emit(l.Error,n)}finally{for(const e of f)if(e===d.task){f.delete(e),z.current.delete(e);break}s.processes.forEach(e=>b.current.prune(e)),s.processes.size>0&&h(),u.resolve()}}}L.current++;const n=/* @__PURE__ */new Set;return _.current.handlers.forEach((e,r)=>{for(const{getChannel:o,handler:c}of e){const e=t(r,c,o);if(E(r)){if(s)for(const t of s.values()){const o=t.emitter;o.on(r,e),n.add(()=>o.off(r,e))}A.on(r,e),N.multicast.add(r),n.add(()=>A.off(r,e))}else S(r)?(i.on(r,e),A.on(r,e),N.broadcast.add(r),n.add(()=>{i.off(r,e),A.off(r,e)})):(A.on(r,e),n.add(()=>A.off(r,e)))}}),()=>{const e=++L.current,t=new Set(n);queueMicrotask(()=>{if(L.current===e){for(const e of z.current)e.controller.abort(),f.delete(e);z.current.clear(),R.current=d.Unmounting,A.emit(l.Unmount),R.current=d.Unmounted;for(const e of t)e()}else for(const e of t)e()})}},[A]),r.useLayoutEffect(()=>{for(const[e,t]of U.pending.current)U.emitted.current.get(e)!==t&&(U.emitted.current.set(e,t),A.emit(u.Node,t,{Name:e}));U.pending.current.clear()}),function({unicast:n,broadcastActions:o,phase:c,data:i}){const s=te(),a=r.useRef(null);r.useLayoutEffect(()=>{c.current===d.Mounting&&(n.emit(l.Mount),o.forEach(t=>{const r=s.get(t),o=r?.state.model?.value;e.isNullable(o)||n.emit(t,o)}),c.current=d.Mounted)},[]),r.useLayoutEffect(()=>{if(e.isNotNullable(a.current)){const e=function(e,t){return Object.keys(t).reduce((n,r)=>e[r]!==t[r]?{...n,[r]:t[r]}:n,{})}(a.current,i);t.isNotEmpty(Object.keys(e))&&n.emit(l.Update,e)}a.current=i},[i,n])}({unicast:A,broadcastActions:N.broadcast,phase:R,data:o()});const $=r.useMemo(()=>[v,{dispatch(e,t,n){const r=w(e),o=P(e)?e.channel:void 0;if(E(e)&&n?.scope){const e=de(s,n.scope);return void(e&&e.emitter.emit(r,t,o))}(S(e)?i:A).emit(r,t,o)},consume:(e,t,n)=>E(e)&&n?.scope?r.createElement(pe,{action:w(e),scopeName:n.scope,renderer:t}):r.createElement(re,{action:w(e),renderer:t}),get inspect(){return b.current.inspect},get nodes(){return U.refs.current},node(e,t){U.refs.current[e]=t,U.pending.current.set(e,t)}}],[v,A]);return $.useAction=(e,t)=>{!function(e,t,n){const o=r.useRef(n);r.useLayoutEffect(()=>{o.current=n});const c=r.useRef(t);r.useLayoutEffect(()=>{c.current=t});const i=r.useCallback(async(e,t)=>{const n=o.current;if("GeneratorFunction"===n.constructor.name||"AsyncGeneratorFunction"===n.constructor.name){const r=n(e,t);for await(const e of r);}else await n(e,t)},[]),s=r.useCallback(()=>P(c.current)?c.current.channel:void 0,[]),a=w(t),u=e.current.handlers.get(a)??/* @__PURE__ */new Set;0===u.size&&e.current.handlers.set(a,u),u.add({getChannel:s,handler:i})}(_,e,t)},$}export{M as Action,ue as Boundary,f as Distribution,A as Entry,_ as Error,l as Lifecycle,R as Op,R as Operation,p as Reason,he as Scope,G as State,me as With,V as annotate,ye as useActions,v as utils};

package/dist/chizu.umd.cjs

@@ -1 +1 @@
-var global,factory;global=this,factory=function(e,t,n,r,o){"use strict";function c(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e)for(const n in e)if("default"!==n){const r=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,r.get?r:{enumerable:!0,get:()=>e[n]})}return t.default=e,Object.freeze(t)}const s=c(n);class i{static Payload=Symbol("chizu.brand/Payload");static Broadcast=Symbol("chizu.brand/Broadcast");static Multicast=Symbol("chizu.brand/Multicast");static Action=Symbol("chizu.brand/Action");static Channel=Symbol("chizu.brand/Channel");static Node=Symbol("chizu.action.lifecycle/Node");static Rehydrate=Symbol("chizu.brand/Rehydrate")}class a{static Mount=Symbol("chizu.action.lifecycle/Mount");static Unmount=Symbol("chizu.action.lifecycle/Unmount");static Error=Symbol("chizu.action.lifecycle/Error");static Update=Symbol("chizu.action.lifecycle/Update");static Node=(()=>{const e=i.Node,t=function(t){return{[i.Action]:e,[i.Payload]:void 0,[i.Channel]:t,channel:t}};return Object.defineProperty(t,i.Action,{value:e,enumerable:!1}),Object.defineProperty(t,i.Payload,{value:void 0,enumerable:!1}),t})()}var u=(e=>(e.Unicast="unicast",e.Broadcast="broadcast",e.Multicast="multicast",e))(u||{}),l=(e=>(e.Mounting="mounting",e.Mounted="mounted",e.Unmounting="unmounting",e.Unmounted="unmounted",e))(l||{}),f=(e=>(e[e.Timedout=0]="Timedout",e[e.Supplanted=1]="Supplanted",e[e.Disallowed=2]="Disallowed",e[e.Errored=3]="Errored",e[e.Unmounted=4]="Unmounted",e))(f||{});class d extends Error{name="AbortError";constructor(e="Aborted"){super(e)}}const p={actionPrefix:"chizu.action/",broadcastActionPrefix:"chizu.action/broadcast/",multicastActionPrefix:"chizu.action/multicast/",channelPrefix:"chizu.channel/",cachePrefix:"chizu.cache/"};function h(e,t){return new Promise((n,r)=>{if(t?.aborted)return void r(new d);const o=setTimeout(n,e);t?.addEventListener("abort",()=>{clearTimeout(o),r(new d)},{once:!0})})}function m(e){return e?Boolean(e&&"symbol"!=typeof e):Symbol(`pk.${Date.now()}.${crypto.randomUUID()}`)}const y=Object.freeze(Object.defineProperty({__proto__:null,config:p,pk:m,sleep:h,"ζ":h,"κ":m},Symbol.toStringTag,{value:"Module"})),b=e=>"symbol"==typeof e;function v(e){return t.G.isString(e)||b(e)?e:(t.G.isObject(e)||t.G.isFunction(e))&&i.Action in e?e[i.Action]:e}function g(e){if(t.G.isString(e))return e.startsWith(p.broadcastActionPrefix);if(b(e))return e.description?.startsWith(p.broadcastActionPrefix)??!1;if(t.G.isObject(e)||t.G.isFunction(e)){if(i.Broadcast in e&&e[i.Broadcast])return!0;if(i.Action in e){const t=e[i.Action];return t.description?.startsWith(p.broadcastActionPrefix)??!1}}return!1}function w(e){const n=v(e),r=t.G.isString(n)?n:n.description??"";return r.startsWith(p.actionPrefix)&&r.slice(r.lastIndexOf("/")+1)||"unknown"}function x(e){return t.G.isObject(e)&&i.Channel in e&&"channel"in e}function j(e){if(t.G.isString(e))return e.startsWith(p.multicastActionPrefix);if(b(e))return e.description?.startsWith(p.multicastActionPrefix)??!1;if(t.G.isObject(e)||t.G.isFunction(e)){if(i.Multicast in e&&e[i.Multicast])return!0;if(i.Action in e){const t=e[i.Action];return t.description?.startsWith(p.multicastActionPrefix)??!1}}return!1}const S=s.createContext({data:new Map});function P(e){return e?[...Object.keys(e)].toSorted().map(t=>`${t}=${String(e[t])}`).join("&"):""}function A(e){if(e instanceof Error){if("TimeoutError"===e.name)return f.Timedout;if("AbortError"===e.name)return f.Supplanted}return f.Errored}function M(e){return e instanceof Error?e:new Error(String(e))}const E=n.createContext(void 0);let O=(e=21)=>{let t="",n=crypto.getRandomValues(new Uint8Array(e|=0));for(;e--;)t+="useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict"[63&n[e]];return t};var R=(e=>(e[e.Add=1]="Add",e[e.Remove=2]="Remove",e[e.Update=4]="Update",e[e.Move=8]="Move",e[e.Replace=16]="Replace",e[e.Sort=32]="Sort",e[e.Create=64]="Create",e[e.Fetch=128]="Fetch",e[e.Clone=256]="Clone",e[e.Archive=512]="Archive",e[e.Restore=1024]="Restore",e[e.Merge=2048]="Merge",e[e.Reorder=4096]="Reorder",e[e.Sync=8192]="Sync",e[e.Publish=16384]="Publish",e[e.Link=32768]="Link",e[e.Unlink=65536]="Unlink",e[e.Lock=131072]="Lock",e[e.Unlock=262144]="Unlock",e[e.Import=524288]="Import",e[e.Export=1048576]="Export",e[e.Transfer=2097152]="Transfer",e))(R||{}),C=(e=>(e[e.Produce=0]="Produce",e[e.Hydrate=1]="Hydrate",e))(C||{}),G=(e=>(e.Property="property",e.Process="process",e.Value="value",e.Operation="operation",e))(G||{});class _{[o.immerable]=!0;static keys=new Set(Object.values(G));property=null;process=null;value;operation;constructor(e,t){this.value=e,this.operation=t}assign(e,t){const n=new _(this.value,this.operation);return n.property=e,n.process=t,n}}class k{static immer=(()=>{o.enablePatches();const e=new o.Immer;return e.setAutoFreeze(!1),e})();static tag="κ";static id=O}function N(e,t){const n="string"==typeof t?""===t?[]:t.split("."):t;let r=e;for(const o of n){if(null==r)return;r=r[o]}return r}function z(e){if(t.G.isNullable(e)||L(e))return e;if(t.G.isArray(e))return e.map(e=>z(e));if(t.G.isObject(e)){const t=Object.entries(e).map(([e,t])=>[e,z(t)]);return{...Object.fromEntries(t),[k.tag]:e[k.tag]??k.id()}}return e}function U(e){if(Array.isArray(e))return e.filter(e=>k.tag in e).map(e=>e[k.tag]??"").join(",");const t=e[k.tag];if(t)return t;try{return JSON.stringify(e)}catch{return`[unserializable:${typeof e}]`}}function L(e){return t.G.isNullable(e)||t.G.isString(e)||t.G.isNumber(e)||t.G.isBoolean(e)||"symbol"==typeof e||"bigint"==typeof e}function T(e,n,r,o,c,s){return function i(a,u=n.path){if(a instanceof _){const n=N(r,u.join("."));if(Object.entries(a).filter(([e,t])=>!_.keys.has(e)&&t instanceof _).forEach(([e,t])=>i(t,u.concat(e))),L(a.value)){if(e===C.Hydrate)return a.value;const i=u.slice(0,-1),l=i.length>0?N(r,i.join(".")):r;return t.G.isNullable(l)||B(l,a,u.at(-1),o,c,s),n??a.value}if(e===C.Hydrate){const e=z(i(a.value,u));return B(e,a,null,o,c,s),e}const l=n??z(a.value);return B(l,a,null,o,c,s),t.G.isNullable(n)?l:(i(a.value,u),n)}if(t.G.isArray(a))return a.map((e,t)=>i(e,u.concat(t)));if(t.G.isObject(a)){const t=Object.entries(a).map(([e,t])=>[e,i(t,u.concat(e))]),n=Object.fromEntries(t);if(e===C.Hydrate){const e=z(n);return Object.entries(a).forEach(([t,n])=>{n instanceof _&&L(n.value)&&B(e,n,t,o,c,s)}),e}return n}return a}(n.value)}function B(e,t,n,r,o,c){const s=c(e),i=o.get(s)??[];o.set(s,[t.assign(n,r),...i])}class ${#e={};#t;#n=new Map;#r=new Set;#o=!1;constructor(e=U){this.#t=e}static pk(){return O()}static"κ"=$.pk;annotate(e,t){return new _(t,e)}"δ"=this.annotate;get model(){return this.#e}get inspect(){return function(e,n,r,o,c){function s(o){const c=o.at(-1),s=N(e(),o),i=o.slice(0,-1),a=t.A.isNotEmpty(i)?N(e(),i):e();return[...t.G.isObject(s)||t.G.isArray(s)?n.get(r(s))?.filter(e=>t.G.isNullable(e.property))??[]:[],...t.G.isObject(a)?n.get(r(a))?.filter(e=>e.property===c)??[]:[]]}return function n(r){return new Proxy(()=>{},{get:(i,a)=>"pending"===a?()=>!t.A.isEmpty(s(r)):"remaining"===a?()=>t.A.length(s(r)):"box"===a?()=>({value:N(e(),r),inspect:n(r)}):"is"===a?e=>s(r).some(t=>0!==(t.operation&e)):"draft"===a?()=>t.A.head(s(r))?.value??N(e(),r):"settled"===a?()=>new Promise(n=>{if(t.A.isEmpty(s(r)))return n(N(e(),r));const i=()=>{t.A.isEmpty(s(r))&&(c(i),n(N(e(),r)))};o(i)}):n([...r,String(a)])})}([])}(()=>this.#e,this.#n,this.#t,e=>this.#r.add(e),e=>this.#r.delete(e))}hydrate(e){return this.#o=!0,this.#c(C.Hydrate,()=>e)}produce(e){if(!this.#o)throw new Error("State must be hydrated using hydrate() before calling produce()");return this.#c(C.Produce,e)}#c(e,t){const n=Symbol("process"),[,r]=k.immer.produceWithPatches(this.#e,t);return this.#e=r.reduce((t,r)=>k.immer.applyPatches(t,[{...r,value:T(e,r,t,n,this.#n,this.#t)}]),this.#e),this.#e=z(this.#e),this.#s(),n}prune(e){this.#n.forEach((n,r)=>{const o=n.filter(t=>t.process!==e);t.A.isEmpty(o)?this.#n.delete(r):this.#n.set(r,o)}),this.#s()}#s(){this.#r.forEach(e=>e())}observe(e){const t=()=>e(this.#e);return this.#r.add(t),()=>this.#r.delete(t)}}const W=new $;function F(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var D,H={exports:{}},I=(D||(D=1,function(e){var t=Object.prototype.hasOwnProperty,n="~";function r(){}function o(e,t,n){this.fn=e,this.context=t,this.once=n||!1}function c(e,t,r,c,s){if("function"!=typeof r)throw new TypeError("The listener must be a function");var i=new o(r,c||e,s),a=n?n+t:t;return e._events[a]?e._events[a].fn?e._events[a]=[e._events[a],i]:e._events[a].push(i):(e._events[a]=i,e._eventsCount++),e}function s(e,t){0===--e._eventsCount?e._events=new r:delete e._events[t]}function i(){this._events=new r,this._eventsCount=0}Object.create&&(r.prototype=Object.create(null),(new r).__proto__||(n=!1)),i.prototype.eventNames=function(){var e,r,o=[];if(0===this._eventsCount)return o;for(r in e=this._events)t.call(e,r)&&o.push(n?r.slice(1):r);return Object.getOwnPropertySymbols?o.concat(Object.getOwnPropertySymbols(e)):o},i.prototype.listeners=function(e){var t=this._events[n?n+e:e];if(!t)return[];if(t.fn)return[t.fn];for(var r=0,o=t.length,c=new Array(o);r<o;r++)c[r]=t[r].fn;return c},i.prototype.listenerCount=function(e){var t=this._events[n?n+e:e];return t?t.fn?1:t.length:0},i.prototype.emit=function(e,t,r,o,c,s){var i=n?n+e:e;if(!this._events[i])return!1;var a,u,l=this._events[i],f=arguments.length;if(l.fn){switch(l.once&&this.removeListener(e,l.fn,void 0,!0),f){case 1:return l.fn.call(l.context),!0;case 2:return l.fn.call(l.context,t),!0;case 3:return l.fn.call(l.context,t,r),!0;case 4:return l.fn.call(l.context,t,r,o),!0;case 5:return l.fn.call(l.context,t,r,o,c),!0;case 6:return l.fn.call(l.context,t,r,o,c,s),!0}for(u=1,a=new Array(f-1);u<f;u++)a[u-1]=arguments[u];l.fn.apply(l.context,a)}else{var d,p=l.length;for(u=0;u<p;u++)switch(l[u].once&&this.removeListener(e,l[u].fn,void 0,!0),f){case 1:l[u].fn.call(l[u].context);break;case 2:l[u].fn.call(l[u].context,t);break;case 3:l[u].fn.call(l[u].context,t,r);break;case 4:l[u].fn.call(l[u].context,t,r,o);break;default:if(!a)for(d=1,a=new Array(f-1);d<f;d++)a[d-1]=arguments[d];l[u].fn.apply(l[u].context,a)}}return!0},i.prototype.on=function(e,t,n){return c(this,e,t,n,!1)},i.prototype.once=function(e,t,n){return c(this,e,t,n,!0)},i.prototype.removeListener=function(e,t,r,o){var c=n?n+e:e;if(!this._events[c])return this;if(!t)return s(this,c),this;var i=this._events[c];if(i.fn)i.fn!==t||o&&!i.once||r&&i.context!==r||s(this,c);else{for(var a=0,u=[],l=i.length;a<l;a++)(i[a].fn!==t||o&&!i[a].once||r&&i[a].context!==r)&&u.push(i[a]);u.length?this._events[c]=1===u.length?u[0]:u:s(this,c)}return this},i.prototype.removeAllListeners=function(e){var t;return e?this._events[t=n?n+e:e]&&s(this,t):(this._events=new r,this._eventsCount=0),this},i.prototype.off=i.prototype.removeListener,i.prototype.addListener=i.prototype.on,i.prefixed=n,i.EventEmitter=i,e.exports=i}(H)),H.exports);const q=F(I),V=s.createContext(new q);function J(){return s.useContext(V)}function K({children:e}){const t=s.useMemo(()=>new q,[]);return r.jsx(V.Provider,{value:t,children:e})}const Q=s.createContext(new Map);function X(){return s.useContext(Q)}function Y(){const[,e]=s.useReducer(e=>e+1,0);return e}function Z({action:e,renderer:n}){const r=J(),o=X(),c=Y(),i=s.useMemo(()=>{const t=o.get(e);if(t)return t;const n={state:new $,listeners:new Set};return o.set(e,n),n},[e,o]);s.useLayoutEffect(()=>{function t(e){i.state.hydrate({value:e}),i.listeners.forEach(e=>e())}return i.listeners.add(c),r.on(e,t),()=>{i.listeners.delete(c),r.off(e,t)}},[e,r,i]);const a=i.state.model?.value;return t.G.isNullable(a)?null:n({value:a,inspect:i.state.inspect.value})}function ee({children:e}){const t=s.useMemo(()=>new Map,[]);return r.jsx(Q.Provider,{value:t,children:e})}function te({children:e}){const t=s.useMemo(()=>({data:new Map}),[]);return r.jsx(S.Provider,{value:t,children:e})}const ne=s.createContext(new Set);function re({children:e}){const t=s.useMemo(()=>new Set,[]);return r.jsx(ne.Provider,{value:t,children:e})}const oe=s.createContext(null);function ce(){return s.useContext(oe)}function se(e,t){return e?.get(t)??null}function ie({action:e,scopeName:n,renderer:r}){const o=ce(),c=Y(),i=s.useMemo(()=>se(o,n),[o,n]),a=s.useMemo(()=>i?function(e,t){const n=e.store.get(t);if(n)return n;const r={state:new $,listeners:new Set};return e.store.set(t,r),r}(i,e):null,[e,i]);if(s.useLayoutEffect(()=>{if(i&&a)return a.listeners.add(c),i.emitter.on(e,t),()=>{a.listeners.delete(c),i.emitter.off(e,t)};function t(e){a&&(a.state.hydrate({value:e}),a.listeners.forEach(e=>e()))}},[e,i,a,c]),!a)return null;const u=a.state.model?.value;return t.G.isNullable(u)?null:r({value:u,inspect:a.state.inspect.value})}e.Action=(e,t=u.Unicast)=>{const n=t===u.Broadcast?Symbol(`${p.broadcastActionPrefix}${e}`):t===u.Multicast?Symbol(`${p.multicastActionPrefix}${e}`):Symbol(`${p.actionPrefix}${e}`),r=function(e){return{[i.Action]:n,[i.Payload]:void 0,[i.Channel]:e,channel:e}};return Object.defineProperty(r,i.Action,{value:n,enumerable:!1}),Object.defineProperty(r,i.Payload,{value:void 0,enumerable:!1}),t===u.Broadcast&&Object.defineProperty(r,i.Broadcast,{value:!0,enumerable:!1}),t===u.Multicast&&Object.defineProperty(r,i.Multicast,{value:!0,enumerable:!1}),r},e.Boundary=function({children:e}){return r.jsx(K,{children:r.jsx(ee,{children:r.jsx(te,{children:r.jsx(re,{children:e})})})})},e.Distribution=u,e.Error=function({handler:e,children:t}){return r.jsx(E.Provider,{value:e,children:t})},e.Lifecycle=a,e.Op=R,e.Operation=R,e.Reason=f,e.Rehydrate=function(e,t){return{[i.Rehydrate]:!0,model:e,channel:t}},e.Scope=function({name:e,children:t}){const n=ce(),o=s.useMemo(()=>({name:e,emitter:new q,store:new Map,listeners:new Map}),[]),c=s.useMemo(()=>{const t=new Map(n??[]);return t.set(e,o),t},[n,e,o]);return r.jsx(oe.Provider,{value:c,children:t})},e.State=$,e.With=function(e){return(t,n)=>{t.actions.produce(t=>{t.model[e]=n})}},e.annotate=function(e,t){return W.annotate(e,t)},e.useActions=function(e,r=()=>({})){const o=J(),c=ce(),u=n.useContext(E),f=s.useContext(ne),d=Y(),p=s.useRef(!1),h=s.useRef(null),m=s.useRef(new $),{model:y,save:b}=function(e){const t=s.useContext(S),n=s.useRef(null);if(!n.current)if("object"==typeof(r=e)&&null!==r&&i.Rehydrate in r&&!0===r[i.Rehydrate]){const{channel:r,model:o}=e,c=function(e,t){const n=P(t);return e.data.get(n)||null}(t,r);n.current={model:c??o,save:e=>function(e,t,n){const r=P(t);e.data.set(r,n)}(t,r,e)}}else n.current={model:e,save:()=>{}};var r;return n.current}(e);p.current||(p.current=!0,h.current=m.current.hydrate(y));const[O,R]=s.useState(()=>m.current.model),C=function(e){const t=s.useRef(e);return s.useLayoutEffect(()=>{t.current=e},[e]),s.useMemo(()=>{return n=t,Object.keys(e).reduce((e,t)=>(Object.defineProperty(e,t,{get:()=>n.current[t],enumerable:!0}),e),{});var n},[e])}(r()),G=s.useMemo(()=>new q,[]),_=s.useRef({handlers:new Map});_.current.handlers=new Map;const k=function(){const e=s.useRef(new Set),t=s.useRef(new Set);return s.useMemo(()=>({broadcast:e.current,multicast:t.current}),[])}(),N=s.useRef(l.Mounting),z=function(){const e=s.useRef({}),t=s.useRef(new Map),n=s.useRef(new Map);return s.useMemo(()=>({refs:e,pending:t,emitted:n}),[])}(),U=s.useRef(new Set),L=s.useRef(0),T=s.useCallback((e,t,n)=>{const r=new AbortController,s={controller:r,action:e,payload:t};return f.add(s),U.current.add(s),{model:O,get phase(){return N.current},task:s,data:C,tasks:f,nodes:z.refs.current,actions:{produce(e){if(r.signal.aborted)return;const t=m.current.produce(t=>e({model:t,inspect:m.current.inspect}));R(m.current.model),n.processes.add(t),h.current&&(n.processes.add(h.current),h.current=null)},dispatch(e,t,n){if(r.signal.aborted)return;const s=v(e),i=x(e)?e.channel:void 0;if(j(e)&&n?.scope){const e=se(c,n.scope);return void(e&&e.emitter.emit(s,t,i))}(g(e)?o:G).emit(s,t,i)},annotate:(e,t)=>m.current.annotate(e,t)}}},[O]);s.useLayoutEffect(()=>{function e(e,n,r){return async function(o,c){const s=r();if(t.G.isNotNullable(c)&&t.G.isNotNullable(s)&&!function(e,t){for(const n of Object.keys(e))if(t[n]!==e[n])return!1;return!0}(c,s))return;const i={processes:new Set},l=Promise.withResolvers(),p=T(e,o,i);try{await n(p,o)}catch(h){const t=_.current.handlers.has(a.Error),n={reason:A(h),error:M(h),action:w(e),handled:t,tasks:f};u?.(n),t&&G.emit(a.Error,n)}finally{for(const e of f)if(e===p.task){f.delete(e),U.current.delete(e);break}i.processes.forEach(e=>m.current.prune(e)),i.processes.size>0&&d(),l.resolve()}}}L.current++;const n=new Set;return _.current.handlers.forEach((t,r)=>{for(const{getChannel:s,handler:i}of t){const t=e(r,i,s);if(j(r)){if(c)for(const e of c.values()){const o=e.emitter;o.on(r,t),n.add(()=>o.off(r,t))}G.on(r,t),k.multicast.add(r),n.add(()=>G.off(r,t))}else g(r)?(o.on(r,t),G.on(r,t),k.broadcast.add(r),n.add(()=>{o.off(r,t),G.off(r,t)})):(G.on(r,t),n.add(()=>G.off(r,t)))}}),()=>{const e=++L.current,t=new Set(n);queueMicrotask(()=>{if(L.current===e){b(m.current.model);for(const e of U.current)e.controller.abort(),f.delete(e);U.current.clear(),N.current=l.Unmounting,G.emit(a.Unmount),N.current=l.Unmounted;for(const e of t)e()}else for(const e of t)e()})}},[G]),s.useLayoutEffect(()=>{for(const[e,t]of z.pending.current)z.emitted.current.get(e)!==t&&(z.emitted.current.set(e,t),G.emit(i.Node,t,{Name:e}));z.pending.current.clear()}),function({unicast:e,broadcastActions:n,phase:r,data:o}){const c=X(),i=s.useRef(null);s.useLayoutEffect(()=>{r.current===l.Mounting&&(e.emit(a.Mount),n.forEach(n=>{const r=c.get(n),o=r?.state.model?.value;t.G.isNullable(o)||e.emit(n,o)}),r.current=l.Mounted)},[]),s.useLayoutEffect(()=>{if(t.G.isNotNullable(i.current)){const n=function(e,t){return Object.keys(t).reduce((n,r)=>e[r]!==t[r]?{...n,[r]:t[r]}:n,{})}(i.current,o);t.A.isNotEmpty(Object.keys(n))&&e.emit(a.Update,n)}i.current=o},[o,e])}({unicast:G,broadcastActions:k.broadcast,phase:N,data:r()});const B=s.useMemo(()=>[O,{dispatch(e,t,n){const r=v(e),s=x(e)?e.channel:void 0;if(j(e)&&n?.scope){const e=se(c,n.scope);return void(e&&e.emitter.emit(r,t,s))}(g(e)?o:G).emit(r,t,s)},consume:(e,t,n)=>j(e)&&n?.scope?s.createElement(ie,{action:v(e),scopeName:n.scope,renderer:t}):s.createElement(Z,{action:v(e),renderer:t}),get inspect(){return m.current.inspect},get nodes(){return z.refs.current},node(e,t){z.refs.current[e]=t,z.pending.current.set(e,t)}}],[O,G]);return B.useAction=(e,t)=>{!function(e,t,n){const r=s.useRef(n);s.useLayoutEffect(()=>{r.current=n});const o=s.useRef(t);s.useLayoutEffect(()=>{o.current=t});const c=s.useCallback(async(e,t)=>{const n=r.current;if("GeneratorFunction"===n.constructor.name||"AsyncGeneratorFunction"===n.constructor.name){const r=n(e,t);for await(const e of r);}else await n(e,t)},[]),i=s.useCallback(()=>x(o.current)?o.current.channel:void 0,[]),a=v(t),u=e.current.handlers.get(a)??new Set;0===u.size&&e.current.handlers.set(a,u),u.add({getChannel:i,handler:c})}(_,e,t)},B},e.utils=y,Object.defineProperty(e,Symbol.toStringTag,{value:"Module"})},"object"==typeof exports&&"undefined"!=typeof module?factory(exports,require("@mobily/ts-belt"),require("react"),require("react/jsx-runtime"),require("immer")):"function"==typeof define&&define.amd?define(["exports","@mobily/ts-belt","react","react/jsx-runtime","immer"],factory):factory((global="undefined"!=typeof globalThis?globalThis:global||self).Chizu={},global.TsBelt,global.React,global.jsxRuntime,global.Immer);
+var global,factory;global=this,factory=function(e,t,n,r,o){"use strict";function c(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e)for(const n in e)if("default"!==n){const r=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,r.get?r:{enumerable:!0,get:()=>e[n]})}return t.default=e,Object.freeze(t)}const i=c(r);class s{static Payload=Symbol("chizu.brand/Payload");static Broadcast=Symbol("chizu.brand/Broadcast");static Multicast=Symbol("chizu.brand/Multicast");static Action=Symbol("chizu.brand/Action");static Channel=Symbol("chizu.brand/Channel");static Node=Symbol("chizu.action.lifecycle/Node");static Cache=Symbol("chizu.brand/Cache")}class a{static Mount=Symbol("chizu.action.lifecycle/Mount");static Unmount=Symbol("chizu.action.lifecycle/Unmount");static Error=Symbol("chizu.action.lifecycle/Error");static Update=Symbol("chizu.action.lifecycle/Update");static Node=(()=>{const e=s.Node,t=function(t){return{[s.Action]:e,[s.Payload]:void 0,[s.Channel]:t,channel:t}};return Object.defineProperty(t,s.Action,{value:e,enumerable:!1}),Object.defineProperty(t,s.Payload,{value:void 0,enumerable:!1}),t})()}var u=(e=>(e.Unicast="unicast",e.Broadcast="broadcast",e.Multicast="multicast",e))(u||{}),l=(e=>(e.Mounting="mounting",e.Mounted="mounted",e.Unmounting="unmounting",e.Unmounted="unmounted",e))(l||{}),f=(e=>(e[e.Timedout=0]="Timedout",e[e.Supplanted=1]="Supplanted",e[e.Disallowed=2]="Disallowed",e[e.Errored=3]="Errored",e[e.Unmounted=4]="Unmounted",e))(f||{});class d extends Error{name="AbortError";constructor(e="Aborted"){super(e)}}const p={actionPrefix:"chizu.action/",broadcastActionPrefix:"chizu.action/broadcast/",multicastActionPrefix:"chizu.action/multicast/",channelPrefix:"chizu.channel/",cachePrefix:"chizu.cache/"};function h(e,t){return new Promise((n,r)=>{if(t?.aborted)return void r(new d);const o=setTimeout(n,e);t?.addEventListener("abort",()=>{clearTimeout(o),r(new d)},{once:!0})})}function m(e){return e?Boolean(e&&"symbol"!=typeof e):Symbol(`pk.${Date.now()}.${crypto.randomUUID()}`)}const y=Object.freeze(Object.defineProperty({__proto__:null,config:p,pk:m,sleep:h,"ζ":h,"κ":m},Symbol.toStringTag,{value:"Module"})),b=e=>"symbol"==typeof e;function v(e){return t.G.isString(e)||b(e)?e:(t.G.isObject(e)||t.G.isFunction(e))&&s.Action in e?e[s.Action]:e}function g(e){if(t.G.isString(e))return e.startsWith(p.broadcastActionPrefix);if(b(e))return e.description?.startsWith(p.broadcastActionPrefix)??!1;if(t.G.isObject(e)||t.G.isFunction(e)){if(s.Broadcast in e&&e[s.Broadcast])return!0;if(s.Action in e){const t=e[s.Action];return t.description?.startsWith(p.broadcastActionPrefix)??!1}}return!1}function w(e){const n=v(e),r=t.G.isString(n)?n:n.description??"";return r.startsWith(p.actionPrefix)&&r.slice(r.lastIndexOf("/")+1)||"unknown"}function x(e){return t.G.isObject(e)&&s.Channel in e&&"channel"in e}function j(e){if(t.G.isString(e))return e.startsWith(p.multicastActionPrefix);if(b(e))return e.description?.startsWith(p.multicastActionPrefix)??!1;if(t.G.isObject(e)||t.G.isFunction(e)){if(s.Multicast in e&&e[s.Multicast])return!0;if(s.Action in e){const t=e[s.Action];return t.description?.startsWith(p.multicastActionPrefix)??!1}}return!1}function S(e){const t=function(e){return e[s.Cache]}(e),n=function(e){return"channel"in e}(e)&&(r=e.channel)?[...Object.keys(r)].toSorted().map(e=>`${e}=${String(r[e])}`).join("&"):"";var r;return`${String(t)}:${n}`}function A(e){if(e instanceof Error){if("TimeoutError"===e.name)return f.Timedout;if("AbortError"===e.name)return f.Supplanted}return f.Errored}function P(e){return e instanceof Error?e:new Error(String(e))}const E=r.createContext(void 0);let M=(e=21)=>{let t="",n=crypto.getRandomValues(new Uint8Array(e|=0));for(;e--;)t+="useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict"[63&n[e]];return t};var O=(e=>(e[e.Add=1]="Add",e[e.Remove=2]="Remove",e[e.Update=4]="Update",e[e.Move=8]="Move",e[e.Replace=16]="Replace",e[e.Sort=32]="Sort",e[e.Create=64]="Create",e[e.Fetch=128]="Fetch",e[e.Clone=256]="Clone",e[e.Archive=512]="Archive",e[e.Restore=1024]="Restore",e[e.Merge=2048]="Merge",e[e.Reorder=4096]="Reorder",e[e.Sync=8192]="Sync",e[e.Publish=16384]="Publish",e[e.Link=32768]="Link",e[e.Unlink=65536]="Unlink",e[e.Lock=131072]="Lock",e[e.Unlock=262144]="Unlock",e[e.Import=524288]="Import",e[e.Export=1048576]="Export",e[e.Transfer=2097152]="Transfer",e))(O||{}),C=(e=>(e[e.Produce=0]="Produce",e[e.Hydrate=1]="Hydrate",e))(C||{}),k=(e=>(e.Property="property",e.Process="process",e.Value="value",e.Operation="operation",e))(k||{});class G{[o.immerable]=!0;static keys=new Set(Object.values(k));property=null;process=null;value;operation;constructor(e,t){this.value=e,this.operation=t}assign(e,t){const n=new G(this.value,this.operation);return n.property=e,n.process=t,n}}class _{static immer=(()=>{o.enablePatches();const e=new o.Immer;return e.setAutoFreeze(!1),e})();static tag="κ";static id=M}function R(e,t){const n="string"==typeof t?""===t?[]:t.split("."):t;let r=e;for(const o of n){if(null==r)return;r=r[o]}return r}function N(e){if(t.G.isNullable(e)||U(e))return e;if(t.G.isArray(e))return e.map(e=>N(e));if(t.G.isObject(e)){const t=Object.entries(e).map(([e,t])=>[e,N(t)]);return{...Object.fromEntries(t),[_.tag]:e[_.tag]??_.id()}}return e}function z(e){if(Array.isArray(e))return e.filter(e=>_.tag in e).map(e=>e[_.tag]??"").join(",");const t=e[_.tag];if(t)return t;try{return JSON.stringify(e)}catch{return`[unserializable:${typeof e}]`}}function U(e){return t.G.isNullable(e)||t.G.isString(e)||t.G.isNumber(e)||t.G.isBoolean(e)||"symbol"==typeof e||"bigint"==typeof e}function L(e,n,r,o,c,i){return function s(a,u=n.path){if(a instanceof G){const n=R(r,u.join("."));if(Object.entries(a).filter(([e,t])=>!G.keys.has(e)&&t instanceof G).forEach(([e,t])=>s(t,u.concat(e))),U(a.value)){if(e===C.Hydrate)return a.value;const s=u.slice(0,-1),l=s.length>0?R(r,s.join(".")):r;return t.G.isNullable(l)||T(l,a,u.at(-1),o,c,i),n??a.value}if(e===C.Hydrate){const e=N(s(a.value,u));return T(e,a,null,o,c,i),e}const l=n??N(a.value);return T(l,a,null,o,c,i),t.G.isNullable(n)?l:(s(a.value,u),n)}if(t.G.isArray(a))return a.map((e,t)=>s(e,u.concat(t)));if(t.G.isObject(a)){const t=Object.entries(a).map(([e,t])=>[e,s(t,u.concat(e))]),n=Object.fromEntries(t);if(e===C.Hydrate){const e=N(n);return Object.entries(a).forEach(([t,n])=>{n instanceof G&&U(n.value)&&T(e,n,t,o,c,i)}),e}return n}return a}(n.value)}function T(e,t,n,r,o,c){const i=c(e),s=o.get(i)??[];o.set(i,[t.assign(n,r),...s])}class B{#e={};#t;#n=new Map;#r=new Set;#o=!1;constructor(e=z){this.#t=e}static pk(){return M()}static"κ"=B.pk;annotate(e,t){return new G(t,e)}"δ"=this.annotate;get model(){return this.#e}get inspect(){return function(e,n,r,o,c){function i(o){const c=o.at(-1),i=R(e(),o),s=o.slice(0,-1),a=t.A.isNotEmpty(s)?R(e(),s):e();return[...t.G.isObject(i)||t.G.isArray(i)?n.get(r(i))?.filter(e=>t.G.isNullable(e.property))??[]:[],...t.G.isObject(a)?n.get(r(a))?.filter(e=>e.property===c)??[]:[]]}return function n(r){return new Proxy(()=>{},{get:(s,a)=>"pending"===a?()=>!t.A.isEmpty(i(r)):"remaining"===a?()=>t.A.length(i(r)):"box"===a?()=>({value:R(e(),r),inspect:n(r)}):"is"===a?e=>i(r).some(t=>0!==(t.operation&e)):"draft"===a?()=>t.A.head(i(r))?.value??R(e(),r):"settled"===a?()=>new Promise(n=>{if(t.A.isEmpty(i(r)))return n(R(e(),r));const s=()=>{t.A.isEmpty(i(r))&&(c(s),n(R(e(),r)))};o(s)}):n([...r,String(a)])})}([])}(()=>this.#e,this.#n,this.#t,e=>this.#r.add(e),e=>this.#r.delete(e))}hydrate(e){return this.#o=!0,this.#c(C.Hydrate,()=>e)}produce(e){if(!this.#o)throw new Error("State must be hydrated using hydrate() before calling produce()");return this.#c(C.Produce,e)}#c(e,t){const n=Symbol("process"),[,r]=_.immer.produceWithPatches(this.#e,t);return this.#e=r.reduce((t,r)=>_.immer.applyPatches(t,[{...r,value:L(e,r,t,n,this.#n,this.#t)}]),this.#e),this.#e=N(this.#e),this.#i(),n}prune(e){this.#n.forEach((n,r)=>{const o=n.filter(t=>t.process!==e);t.A.isEmpty(o)?this.#n.delete(r):this.#n.set(r,o)}),this.#i()}#i(){this.#r.forEach(e=>e())}observe(e){const t=()=>e(this.#e);return this.#r.add(t),()=>this.#r.delete(t)}}const $=new B;function W(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var D,F={exports:{}},H=(D||(D=1,function(e){var t=Object.prototype.hasOwnProperty,n="~";function r(){}function o(e,t,n){this.fn=e,this.context=t,this.once=n||!1}function c(e,t,r,c,i){if("function"!=typeof r)throw new TypeError("The listener must be a function");var s=new o(r,c||e,i),a=n?n+t:t;return e._events[a]?e._events[a].fn?e._events[a]=[e._events[a],s]:e._events[a].push(s):(e._events[a]=s,e._eventsCount++),e}function i(e,t){0===--e._eventsCount?e._events=new r:delete e._events[t]}function s(){this._events=new r,this._eventsCount=0}Object.create&&(r.prototype=Object.create(null),(new r).__proto__||(n=!1)),s.prototype.eventNames=function(){var e,r,o=[];if(0===this._eventsCount)return o;for(r in e=this._events)t.call(e,r)&&o.push(n?r.slice(1):r);return Object.getOwnPropertySymbols?o.concat(Object.getOwnPropertySymbols(e)):o},s.prototype.listeners=function(e){var t=this._events[n?n+e:e];if(!t)return[];if(t.fn)return[t.fn];for(var r=0,o=t.length,c=new Array(o);r<o;r++)c[r]=t[r].fn;return c},s.prototype.listenerCount=function(e){var t=this._events[n?n+e:e];return t?t.fn?1:t.length:0},s.prototype.emit=function(e,t,r,o,c,i){var s=n?n+e:e;if(!this._events[s])return!1;var a,u,l=this._events[s],f=arguments.length;if(l.fn){switch(l.once&&this.removeListener(e,l.fn,void 0,!0),f){case 1:return l.fn.call(l.context),!0;case 2:return l.fn.call(l.context,t),!0;case 3:return l.fn.call(l.context,t,r),!0;case 4:return l.fn.call(l.context,t,r,o),!0;case 5:return l.fn.call(l.context,t,r,o,c),!0;case 6:return l.fn.call(l.context,t,r,o,c,i),!0}for(u=1,a=new Array(f-1);u<f;u++)a[u-1]=arguments[u];l.fn.apply(l.context,a)}else{var d,p=l.length;for(u=0;u<p;u++)switch(l[u].once&&this.removeListener(e,l[u].fn,void 0,!0),f){case 1:l[u].fn.call(l[u].context);break;case 2:l[u].fn.call(l[u].context,t);break;case 3:l[u].fn.call(l[u].context,t,r);break;case 4:l[u].fn.call(l[u].context,t,r,o);break;default:if(!a)for(d=1,a=new Array(f-1);d<f;d++)a[d-1]=arguments[d];l[u].fn.apply(l[u].context,a)}}return!0},s.prototype.on=function(e,t,n){return c(this,e,t,n,!1)},s.prototype.once=function(e,t,n){return c(this,e,t,n,!0)},s.prototype.removeListener=function(e,t,r,o){var c=n?n+e:e;if(!this._events[c])return this;if(!t)return i(this,c),this;var s=this._events[c];if(s.fn)s.fn!==t||o&&!s.once||r&&s.context!==r||i(this,c);else{for(var a=0,u=[],l=s.length;a<l;a++)(s[a].fn!==t||o&&!s[a].once||r&&s[a].context!==r)&&u.push(s[a]);u.length?this._events[c]=1===u.length?u[0]:u:i(this,c)}return this},s.prototype.removeAllListeners=function(e){var t;return e?this._events[t=n?n+e:e]&&i(this,t):(this._events=new r,this._eventsCount=0),this},s.prototype.off=s.prototype.removeListener,s.prototype.addListener=s.prototype.on,s.prefixed=n,s.EventEmitter=s,e.exports=s}(F)),F.exports);const I=W(H),q=i.createContext(new I);function V(){return i.useContext(q)}function J({children:e}){const t=i.useMemo(()=>new I,[]);return n.jsx(q.Provider,{value:t,children:e})}const K=i.createContext(new Map);function Q(){return i.useContext(K)}function X(){const[,e]=i.useReducer(e=>e+1,0);return e}function Y({action:e,renderer:n}){const r=V(),o=Q(),c=X(),s=i.useMemo(()=>{const t=o.get(e);if(t)return t;const n={state:new B,listeners:new Set};return o.set(e,n),n},[e,o]);i.useLayoutEffect(()=>{function t(e){s.state.hydrate({value:e}),s.listeners.forEach(e=>e())}return s.listeners.add(c),r.on(e,t),()=>{s.listeners.delete(c),r.off(e,t)}},[e,r,s]);const a=s.state.model?.value;return t.G.isNullable(a)?null:n({value:a,inspect:s.state.inspect.value})}function Z({children:e}){const t=i.useMemo(()=>new Map,[]);return n.jsx(K.Provider,{value:t,children:e})}const ee=i.createContext(new Map);function te({children:e}){const t=i.useMemo(()=>new Map,[]);return n.jsx(ee.Provider,{value:t,children:e})}const ne=i.createContext(new Set);function re({children:e}){const t=i.useMemo(()=>new Set,[]);return n.jsx(ne.Provider,{value:t,children:e})}const oe=i.createContext(null);function ce(){return i.useContext(oe)}function ie(e,t){return e?.get(t)??null}function se({action:e,scopeName:n,renderer:r}){const o=ce(),c=X(),s=i.useMemo(()=>ie(o,n),[o,n]),a=i.useMemo(()=>s?function(e,t){const n=e.store.get(t);if(n)return n;const r={state:new B,listeners:new Set};return e.store.set(t,r),r}(s,e):null,[e,s]);if(i.useLayoutEffect(()=>{if(s&&a)return a.listeners.add(c),s.emitter.on(e,t),()=>{a.listeners.delete(c),s.emitter.off(e,t)};function t(e){a&&(a.state.hydrate({value:e}),a.listeners.forEach(e=>e()))}},[e,s,a,c]),!a)return null;const u=a.state.model?.value;return t.G.isNullable(u)?null:r({value:u,inspect:a.state.inspect.value})}e.Action=(e,t=u.Unicast)=>{const n=t===u.Broadcast?Symbol(`${p.broadcastActionPrefix}${e}`):t===u.Multicast?Symbol(`${p.multicastActionPrefix}${e}`):Symbol(`${p.actionPrefix}${e}`),r=function(e){return{[s.Action]:n,[s.Payload]:void 0,[s.Channel]:e,channel:e}};return Object.defineProperty(r,s.Action,{value:n,enumerable:!1}),Object.defineProperty(r,s.Payload,{value:void 0,enumerable:!1}),t===u.Broadcast&&Object.defineProperty(r,s.Broadcast,{value:!0,enumerable:!1}),t===u.Multicast&&Object.defineProperty(r,s.Multicast,{value:!0,enumerable:!1}),r},e.Boundary=function({children:e}){return n.jsx(J,{children:n.jsx(Z,{children:n.jsx(te,{children:n.jsx(re,{children:e})})})})},e.Distribution=u,e.Entry=function(){const e=Symbol("chizu.cache/Entry"),t=function(t){return{[s.Cache]:e,channel:t}};return Object.defineProperty(t,s.Cache,{value:e,enumerable:!1}),t},e.Error=function({handler:e,children:t}){return n.jsx(E.Provider,{value:e,children:t})},e.Lifecycle=a,e.Op=O,e.Operation=O,e.Reason=f,e.Scope=function({name:e,children:t}){const r=ce(),o=i.useMemo(()=>({name:e,emitter:new I,store:new Map,listeners:new Map}),[]),c=i.useMemo(()=>{const t=new Map(r??[]);return t.set(e,o),t},[r,e,o]);return n.jsx(oe.Provider,{value:c,children:t})},e.State=B,e.With=function(e){return(t,n)=>{t.actions.produce(t=>{t.model[e]=n})}},e.annotate=function(e,t){return $.annotate(e,t)},e.useActions=function(e,n=()=>({})){const o=V(),c=ce(),u=r.useContext(E),f=i.useContext(ne),d=i.useContext(ee),p=X(),h=i.useRef(!1),m=i.useRef(null),y=i.useRef(new B);h.current||(h.current=!0,m.current=y.current.hydrate(e));const[b,M]=i.useState(()=>y.current.model),O=function(e){const t=i.useRef(e);return i.useLayoutEffect(()=>{t.current=e},[e]),i.useMemo(()=>{return n=t,Object.keys(e).reduce((e,t)=>(Object.defineProperty(e,t,{get:()=>n.current[t],enumerable:!0}),e),{});var n},[e])}(n()),C=i.useMemo(()=>new I,[]),k=i.useRef({handlers:new Map});k.current.handlers=new Map;const G=function(){const e=i.useRef(new Set),t=i.useRef(new Set);return i.useMemo(()=>({broadcast:e.current,multicast:t.current}),[])}(),_=i.useRef(l.Mounting),R=function(){const e=i.useRef({}),t=i.useRef(new Map),n=i.useRef(new Map);return i.useMemo(()=>({refs:e,pending:t,emitted:n}),[])}(),N=i.useRef(new Set),z=i.useRef(0),U=i.useCallback((e,t,n)=>{const r=new AbortController,i={controller:r,action:e,payload:t};return f.add(i),N.current.add(i),{model:b,get phase(){return _.current},task:i,data:O,tasks:f,nodes:R.refs.current,actions:{produce(e){if(r.signal.aborted)return;const t=y.current.produce(t=>e({model:t,inspect:y.current.inspect}));M(y.current.model),n.processes.add(t),m.current&&(n.processes.add(m.current),m.current=null)},dispatch(e,t,n){if(r.signal.aborted)return;const i=v(e),s=x(e)?e.channel:void 0;if(j(e)&&n?.scope){const e=ie(c,n.scope);return void(e&&e.emitter.emit(i,t,s))}(g(e)?o:C).emit(i,t,s)},annotate:(e,t)=>y.current.annotate(e,t),async cacheable(e,t,n){if(r.signal.aborted)return{data:null};const o=S(e),c=d.get(o);if(c&&Date.now()<c.expiry)return{data:c.value};const i=function(e){return null!=e&&"object"==typeof e&&"TAG"in e?0===e.TAG?{ok:!0,value:e._0}:{ok:!1}:null==e?{ok:!1}:{ok:!0,value:e}}(await n());return i.ok?(d.set(o,{value:i.value,expiry:Date.now()+t}),{data:i.value}):{data:null}},invalidate(e){d.delete(S(e))}}}},[b]);i.useLayoutEffect(()=>{function e(e,n,r){return async function(o,c){const i=r();if(t.G.isNotNullable(c)&&t.G.isNotNullable(i)&&!function(e,t){for(const n of Object.keys(e))if(t[n]!==e[n])return!1;return!0}(c,i))return;const s={processes:new Set},l=Promise.withResolvers(),d=U(e,o,s);try{await n(d,o)}catch(h){const t=k.current.handlers.has(a.Error),n={reason:A(h),error:P(h),action:w(e),handled:t,tasks:f};u?.(n),t&&C.emit(a.Error,n)}finally{for(const e of f)if(e===d.task){f.delete(e),N.current.delete(e);break}s.processes.forEach(e=>y.current.prune(e)),s.processes.size>0&&p(),l.resolve()}}}z.current++;const n=new Set;return k.current.handlers.forEach((t,r)=>{for(const{getChannel:i,handler:s}of t){const t=e(r,s,i);if(j(r)){if(c)for(const e of c.values()){const o=e.emitter;o.on(r,t),n.add(()=>o.off(r,t))}C.on(r,t),G.multicast.add(r),n.add(()=>C.off(r,t))}else g(r)?(o.on(r,t),C.on(r,t),G.broadcast.add(r),n.add(()=>{o.off(r,t),C.off(r,t)})):(C.on(r,t),n.add(()=>C.off(r,t)))}}),()=>{const e=++z.current,t=new Set(n);queueMicrotask(()=>{if(z.current===e){for(const e of N.current)e.controller.abort(),f.delete(e);N.current.clear(),_.current=l.Unmounting,C.emit(a.Unmount),_.current=l.Unmounted;for(const e of t)e()}else for(const e of t)e()})}},[C]),i.useLayoutEffect(()=>{for(const[e,t]of R.pending.current)R.emitted.current.get(e)!==t&&(R.emitted.current.set(e,t),C.emit(s.Node,t,{Name:e}));R.pending.current.clear()}),function({unicast:e,broadcastActions:n,phase:r,data:o}){const c=Q(),s=i.useRef(null);i.useLayoutEffect(()=>{r.current===l.Mounting&&(e.emit(a.Mount),n.forEach(n=>{const r=c.get(n),o=r?.state.model?.value;t.G.isNullable(o)||e.emit(n,o)}),r.current=l.Mounted)},[]),i.useLayoutEffect(()=>{if(t.G.isNotNullable(s.current)){const n=function(e,t){return Object.keys(t).reduce((n,r)=>e[r]!==t[r]?{...n,[r]:t[r]}:n,{})}(s.current,o);t.A.isNotEmpty(Object.keys(n))&&e.emit(a.Update,n)}s.current=o},[o,e])}({unicast:C,broadcastActions:G.broadcast,phase:_,data:n()});const L=i.useMemo(()=>[b,{dispatch(e,t,n){const r=v(e),i=x(e)?e.channel:void 0;if(j(e)&&n?.scope){const e=ie(c,n.scope);return void(e&&e.emitter.emit(r,t,i))}(g(e)?o:C).emit(r,t,i)},consume:(e,t,n)=>j(e)&&n?.scope?i.createElement(se,{action:v(e),scopeName:n.scope,renderer:t}):i.createElement(Y,{action:v(e),renderer:t}),get inspect(){return y.current.inspect},get nodes(){return R.refs.current},node(e,t){R.refs.current[e]=t,R.pending.current.set(e,t)}}],[b,C]);return L.useAction=(e,t)=>{!function(e,t,n){const r=i.useRef(n);i.useLayoutEffect(()=>{r.current=n});const o=i.useRef(t);i.useLayoutEffect(()=>{o.current=t});const c=i.useCallback(async(e,t)=>{const n=r.current;if("GeneratorFunction"===n.constructor.name||"AsyncGeneratorFunction"===n.constructor.name){const r=n(e,t);for await(const e of r);}else await n(e,t)},[]),s=i.useCallback(()=>x(o.current)?o.current.channel:void 0,[]),a=v(t),u=e.current.handlers.get(a)??new Set;0===u.size&&e.current.handlers.set(a,u),u.add({getChannel:s,handler:c})}(k,e,t)},L},e.utils=y,Object.defineProperty(e,Symbol.toStringTag,{value:"Module"})},"object"==typeof exports&&"undefined"!=typeof module?factory(exports,require("@mobily/ts-belt"),require("react/jsx-runtime"),require("react"),require("immer")):"function"==typeof define&&define.amd?define(["exports","@mobily/ts-belt","react/jsx-runtime","react","immer"],factory):factory((global="undefined"!=typeof globalThis?globalThis:global||self).Chizu={},global.TsBelt,global.jsxRuntime,global.React,global.Immer);

package/dist/hooks/index.d.ts

@@ -1,6 +1,5 @@
 import { Data } from './types.ts';
 import { Model, Props, Actions, UseActions } from '../types/index.ts';
-import { Rehydrated } from '../rehydrate/index.ts';
 export { With } from './utils.ts';
 /**
  * A hook for managing state with actions.
@@ -19,11 +18,7 @@ export { With } from './utils.ts';
  * @template M The model type representing the component's state.
  * @template AC The actions class containing action definitions.
  * @template D The data type for reactive external values.
- * @param initialModelOrRehydrated The initial model state, or a `Rehydrate(model, channel)`
- *   wrapper for automatic state persistence across unmount/remount cycles.
- *   When a `Rehydrated` wrapper is passed, the model is restored from the
- *   rehydrator on mount (if a matching snapshot exists) and snapshotted
- *   back on unmount.
+ * @param initialModel The initial model state.
  * @param getData Optional function that returns reactive values as data.
  *   Values returned are accessible via `context.data` in action handlers,
  *   always reflecting the latest values even after await operations.
@@ -34,11 +29,6 @@ export { With } from './utils.ts';
  * // Basic usage
  * const actions = useActions<Model, typeof Actions>(model);
  *
- * // With rehydration — state survives unmount/remount
- * const actions = useActions<Model, typeof Actions>(
- *   Rehydrate(model, { UserId: props.userId }),
- * );
- *
  * // With reactive data
  * const actions = useActions<Model, typeof Actions, { query: string }>(
  *   model,
@@ -46,4 +36,4 @@ export { With } from './utils.ts';
  * );
  * ```
  */
-export declare function useActions<M extends Model, AC extends Actions, D extends Props = Props>(initialModelOrRehydrated: M | Rehydrated<M>, getData?: Data<D>): UseActions<M, AC, D>;
+export declare function useActions<M extends Model, AC extends Actions, D extends Props = Props>(initialModel: M, getData?: Data<D>): UseActions<M, AC, D>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { Action } from './action/index.ts';
-export { Rehydrate } from './rehydrate/index.ts';
+export { Entry } from './cache/index.ts';
 export { Distribution, Lifecycle } from './types/index.ts';
 export { Error, Reason } from './error/index.tsx';
 export { Operation, Op, State } from 'immertation';
@@ -11,3 +11,4 @@ export * as utils from './utils/index.ts';
 export type { Box } from 'immertation';
 export type { Fault, Catcher } from './error/index.tsx';
 export type { Pk, Task, Tasks, Handlers } from './types/index.ts';
+export type { CacheId, ChanneledCacheId } from './cache/index.ts';

package/dist/types/index.d.ts

@@ -1,6 +1,8 @@
 import { Operation, Process, Inspect, Box } from 'immertation';
 import { ActionId, Task, Tasks } from '../boundary/components/tasks/types.ts';
 import { ConsumerRenderer } from '../boundary/components/consumer/index.tsx';
+import { Option } from '@mobily/ts-belt/Option';
+import { Result as TsBeltResult } from '@mobily/ts-belt/Result';
 import type * as React from "react";
 export type { ActionId, Box, Task, Tasks };
 export type { ConsumerRenderer };
@@ -56,9 +58,41 @@ export declare class Brand {
     static Channel: symbol;
     /** Node capture events used by Lifecycle.Node */
     static Node: symbol;
-    /** Identifies rehydrated model wrappers created with Rehydrate() */
-    static Rehydrate: symbol;
+    /** Identifies cache entry identifiers created with Entry() */
+    static Cache: symbol;
 }
+/**
+ * Phantom brand symbol for value type tracking on cache entry identifiers.
+ * Uses a function type `(t: T) => T` to enforce invariance, preventing
+ * a cache entry declared for one type from being used with a different type.
+ * @internal
+ */
+declare const CacheValueBrand: unique symbol;
+/**
+ * A branded cache entry identifier.
+ *
+ * When the second type parameter `C` is provided, the entry becomes callable
+ * to produce channeled identifiers for independent cache slots per channel.
+ *
+ * @template T - The cached value type.
+ * @template C - The channel type for channeled entries (defaults to never).
+ */
+export type CacheId<T = unknown, C extends Filter = never> = {
+    readonly [CacheValueBrand]?: (t: T) => T;
+} & ([C] extends [never] ? unknown : {
+    (channel: C): ChanneledCacheId<T, C>;
+});
+/**
+ * Result of calling a channeled cache entry with a channel argument.
+ * Contains the entry identity and the channel data for scoped cache access.
+ *
+ * @template T - The cached value type.
+ * @template C - The channel type.
+ */
+export type ChanneledCacheId<T = unknown, C = unknown> = {
+    readonly [CacheValueBrand]?: (t: T) => T;
+    readonly channel: C;
+};
 /**
  * Lifecycle actions that trigger at specific points in a component's lifecycle.
  * Define handlers for these in your actions class to respond to lifecycle events.
@@ -503,6 +537,45 @@ export type HandlerContext<M extends Model, _AC extends Actions, D extends Props
         }) => void>(ƒ: F & AssertSync<F>): void;
         dispatch(action: ActionOrChanneled, payload?: unknown, options?: MulticastOptions): void;
         annotate<T>(operation: Operation, value: T): T;
+        /**
+         * Fetches a value from the cache or executes the callback if not cached / expired.
+         *
+         * The callback must return an `Option<T>` or `Result<T, E>`. Only `Some` / `Ok`
+         * values are stored; `None` / `Error` results are skipped and `{ data: null }`
+         * is returned. Exactly one layer of `Option` / `Result` is unwrapped.
+         *
+         * @param entry - The cache entry identifier (from `Entry()`).
+         * @param ttl - Time-to-live in milliseconds.
+         * @param fn - Async callback that produces the value to cache.
+         * @returns An object with `data` set to the cached or freshly-fetched value, or `null`.
+         *
+         * @example
+         * ```ts
+         * const { data } = await context.actions.cacheable(
+         *   CacheStore.Pairs,
+         *   30_000,
+         *   async () => Some(await api.fetchPairs()),
+         * );
+         * ```
+         */
+        cacheable<T>(entry: CacheId<T> | ChanneledCacheId<T>, ttl: number, fn: () => Promise<Option<T>>): Promise<{
+            data: T | null;
+        }>;
+        cacheable<T>(entry: CacheId<T> | ChanneledCacheId<T>, ttl: number, fn: () => Promise<TsBeltResult<T, unknown>>): Promise<{
+            data: T | null;
+        }>;
+        /**
+         * Removes a cached value from the store.
+         *
+         * @param entry - The cache entry identifier to invalidate.
+         *
+         * @example
+         * ```ts
+         * context.actions.invalidate(CacheStore.Pairs);
+         * context.actions.invalidate(CacheStore.User({ UserId: 5 }));
+         * ```
+         */
+        invalidate(entry: CacheId<unknown> | ChanneledCacheId<unknown>): void;
     };
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chizu",
-  "version": "0.2.52",
+  "version": "0.2.54",
   "type": "module",
   "license": "MIT",
   "packageManager": "yarn@1.22.22",
@@ -70,7 +70,7 @@
     "jest": "^30.2.0",
     "jest-environment-jsdom": "^30.2.0",
     "jsdom": "^27.4.0",
-    "lodash": "^4.17.21",
+    "lodash": "^4.17.23",
     "lucide-react": "^0.562.0",
     "madge": "^8.0.0",
     "prettier": "^3.7.4",

package/dist/boundary/components/rehydrate/index.d.ts

@@ -1,13 +0,0 @@
-import { Props } from './types.ts';
-import * as React from "react";
-export { useRehydrator } from './utils.ts';
-export type { Rehydrator } from './types.ts';
-/**
- * Creates a new rehydrate context for persisting model snapshots across
- * component unmount/remount cycles. Automatically included in `<Boundary>`.
- * Only needed directly if you want to isolate a rehydrate context.
- *
- * @param props.children - The children to render within the rehydrate context.
- * @returns The children wrapped in a rehydrate context provider.
- */
-export declare function RehydrateProvider({ children }: Props): React.ReactNode;

package/dist/boundary/components/rehydrate/types.d.ts

@@ -1,14 +0,0 @@
-import type * as React from "react";
-/**
- * Store for rehydrated model snapshots.
- * Keyed by serialised channel string, values are model snapshots.
- */
-export type Rehydrator = {
-    data: Map<string, unknown>;
-};
-/**
- * Props for the RehydrateProvider component.
- */
-export type Props = {
-    children: React.ReactNode;
-};

package/dist/boundary/components/rehydrate/utils.d.ts

@@ -1,12 +0,0 @@
-import { Rehydrator } from './types.ts';
-import * as React from "react";
-/**
- * React context for the shared rehydrator.
- */
-export declare const Context: React.Context<Rehydrator>;
-/**
- * Hook to access the rehydrator from context.
- *
- * @returns The rehydrator from the current context.
- */
-export declare function useRehydrator(): Rehydrator;

package/dist/rehydrate/index.d.ts

@@ -1,54 +0,0 @@
-import { Filter, Model } from '../types/index.ts';
-/**
- * Branded wrapper for a model with rehydration metadata.
- * When passed to `useActions`, the model state is automatically saved to the
- * rehydrator on unmount and restored from it on remount.
- */
-export type Rehydrated<M extends Model = Model> = {
-    readonly model: M;
-    readonly channel: Filter;
-};
-/**
- * Wraps an initial model with rehydration metadata.
- *
- * When a rehydrated model is passed to `useActions`, the component's state is
- * automatically snapshotted to the rehydrator on unmount and restored from it
- * on remount if a matching entry exists.
- *
- * The channel parameter acts as a key for the snapshot, allowing different
- * component instances to maintain independent rehydrated state.
- *
- * @template M - The model type.
- * @param model - The initial model (used as fallback when no snapshot exists).
- * @param channel - Channel key identifying this component's snapshot.
- * @returns A branded object containing the model and rehydration metadata.
- *
- * @example
- * ```ts
- * const actions = useActions<Model, typeof Actions>(
- *   Rehydrate(model, { UserId: props.userId }),
- * );
- * ```
- */
-export declare function Rehydrate<M extends Model>(model: M, channel: Filter): Rehydrated<M>;
-/**
- * Type guard to detect whether a value is a `Rehydrated` wrapper.
- */
-export declare function isRehydrated<M extends Model>(value: M | Rehydrated<M>): value is Rehydrated<M>;
-/**
- * Hook that resolves the initial model from a potential `Rehydrated` wrapper.
- *
- * On first call, checks the rehydrator for an existing snapshot matching the
- * channel key. If found, returns the snapshot; otherwise returns the initial
- * model. Also returns a `save` function for persisting the model on unmount.
- *
- * For non-rehydrated models, `save` is a no-op.
- *
- * @template M - The model type.
- * @param initialModelOrRehydrated - A plain model or a `Rehydrated` wrapper.
- * @returns The resolved model and a save function.
- */
-export declare function useRehydration<M extends Model>(initialModelOrRehydrated: M | Rehydrated<M>): {
-    model: M;
-    save: (model: M) => void;
-};