chizu 0.2.51 → 0.2.53

package/README.md

@@ -248,4 +248,31 @@ 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.
 
-For caching async results across components, define cache operations with `Cache()` and use `context.actions.cache.put()` inside handlers – on cache hit the value is returned synchronously. Use `context.actions.cache.get()` to read cached values and `context.actions.cache.delete()` to clear entries with partial channel matching. See the [cache recipe](./recipes/cache.md) for details.
+To preserve a component's state across unmount/remount cycles, define a store with `Id` and wrap the initial model with `Rehydrate`:
+
+```ts
+import { useActions, Rehydrate, Id } from "chizu";
+
+class Store {
+  static Counter = Id<Model, { UserId: number }>();
+  static Settings = Id<Model>();
+}
+
+// Channeled — independent snapshot per UserId
+const actions = useActions<Model, typeof Actions>(
+  Rehydrate(model, Store.Counter({ UserId: props.userId })),
+);
+
+// Unchanneled — single shared snapshot
+const actions = useActions<Model, typeof Actions>(
+  Rehydrate(model, Store.Settings()),
+);
+```
+
+When the component unmounts, its model is snapshotted into the rehydrator. On remount with the same channel key, the model is restored automatically. Use `context.actions.invalidate` to clear a specific snapshot so the next mount starts fresh:
+
+```ts
+context.actions.invalidate(Store.Counter({ UserId: 5 }));
+```
+
+This is useful for tab switching, route changes, and conditionally rendered components. See the [rehydration recipe](./recipes/rehydration.md) for details.

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

@@ -0,0 +1,13 @@
+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

@@ -0,0 +1,14 @@
+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

@@ -0,0 +1,12 @@
+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/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, Cache, and Tasks providers.
+ * Wraps children with Broadcaster, Consumer, Rehydrate, 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/chizu.js

@@ -1,8 +1,8 @@
-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");static TTL=/* @__PURE__ */Symbol("chizu.brand/TTL")}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||{}),h=/* @__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))(h||{});class p 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 p);const o=setTimeout(n,e);t?.addEventListener("abort",()=>{clearTimeout(o),r(new p)},{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"})),w=e=>"symbol"==typeof e;function g(t){return e.isString(t)||w(t)?t:(e.isObject(t)||e.isFunction(t))&&u.Action in t?t[u.Action]:t}function x(t){if(e.isString(t))return t.startsWith(m.broadcastActionPrefix);if(w(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 P(t){const n=g(t),r=e.isString(n)?n:n.description??"";return r.startsWith(m.actionPrefix)&&r.slice(r.lastIndexOf("/")+1)||"unknown"}function S(t){return e.isObject(t)&&u.Channel in t&&"channel"in t}function O(t){if(e.isString(t))return t.startsWith(m.multicastActionPrefix);if(w(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 A=(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 E(t){if((e.isObject(t)||e.isFunction(t))&&u.Action in t)return t[u.Action];throw new Error("Invalid cache operation")}function j(t){return function(t){return(e.isObject(t)||e.isFunction(t))&&u.Cache in t&&!0===t[u.Cache]}(t)&&e.isObject(t)&&u.Channel in t&&"channel"in t}function M(e){return e?[...Object.keys(e)].toSorted().map(t=>`${t}=${String(e[t])}`).join("&"):""}function C(e,t){return Object.keys(e).every(n=>t[n]===e[n])}const _=e=>{const t=/* @__PURE__ */Symbol(`${m.cachePrefix}${e}`),n=function(n){return{[u.Action]:t,[u.Cache]:!0,[u.TTL]:e,[u.Channel]:n,channel:n}};return Object.defineProperty(n,u.Action,{value:t,enumerable:!1}),Object.defineProperty(n,u.Cache,{value:!0,enumerable:!1}),Object.defineProperty(n,u.TTL,{value:e,enumerable:!1}),n};function N(e){if(e instanceof Error){if("TimeoutError"===e.name)return h.Timedout;if("AbortError"===e.name)return h.Supplanted}return h.Errored}function k(e){return e instanceof Error?e:new Error(String(e))}const R=o(void 0);function z({handler:e,children:t}){/* @__PURE__ */
-return n(R.Provider,{value:e,children:t})}let L=(e=21)=>{let t="",n=crypto.getRandomValues(new Uint8Array(e|=0));for(;e--;)t+="useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict"[63&n[e]];return t};var T=/* @__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))(T||{}),U=/* @__PURE__ */(e=>(e[e.Produce=0]="Produce",e[e.Hydrate=1]="Hydrate",e))(U||{}),$=/* @__PURE__ */(e=>(e.Property="property",e.Process="process",e.Value="value",e.Operation="operation",e))($||{});class B{[i]=!0;static keys=new Set(Object.values($));property=null;process=null;value;operation;constructor(e,t){this.value=e,this.operation=t}assign(e,t){const n=new B(this.value,this.operation);return n.property=e,n.process=t,n}}class F{static immer=(()=>{s();const e=new a;return e.setAutoFreeze(!1),e})();static tag="κ";static id=L}function W(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 D(t){if(e.isNullable(t)||I(t))return t;if(e.isArray(t))return t.map(e=>D(e));if(e.isObject(t)){const e=Object.entries(t).map(([e,t])=>[e,D(t)]);return{...Object.fromEntries(e),[F.tag]:t[F.tag]??F.id()}}return t}function H(e){if(Array.isArray(e))return e.filter(e=>F.tag in e).map(e=>e[F.tag]??"").join(",");const t=e[F.tag];if(t)return t;try{return JSON.stringify(e)}catch{return`[unserializable:${typeof e}]`}}function I(t){return e.isNullable(t)||e.isString(t)||e.isNumber(t)||e.isBoolean(t)||"symbol"==typeof t||"bigint"==typeof t}function G(t,n,r,o,c,i){return function s(a,u=n.path){if(a instanceof B){const n=W(r,u.join("."));if(Object.entries(a).filter(([e,t])=>!B.keys.has(e)&&t instanceof B).forEach(([e,t])=>s(t,u.concat(e))),I(a.value)){if(t===U.Hydrate)return a.value;const s=u.slice(0,-1),l=s.length>0?W(r,s.join(".")):r;return e.isNullable(l)||V(l,a,u.at(-1),o,c,i),n??a.value}if(t===U.Hydrate){const e=D(s(a.value,u));return V(e,a,null,o,c,i),e}const l=n??D(a.value);return V(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=D(n);return Object.entries(a).forEach(([t,n])=>{n instanceof B&&I(n.value)&&V(e,n,t,o,c,i)}),e}return n}return a}(n.value)}function V(e,t,n,r,o,c){const i=c(e),s=o.get(i)??[];o.set(i,[t.assign(n,r),...s])}class q{#e={};#t;#n=/* @__PURE__ */new Map;#r=/* @__PURE__ */new Set;#o=!1;constructor(e=H){this.#t=e}static pk(){return L()}static"κ"=q.pk;annotate(e,t){return new B(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=W(n(),c),a=c.slice(0,-1),u=t.isNotEmpty(a)?W(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:W(n(),r),inspect:e(r)}):"is"===a?e=>s(r).some(t=>0!==(t.operation&e)):"draft"===a?()=>t.head(s(r))?.value??W(n(),r):"settled"===a?()=>new Promise(e=>{if(t.isEmpty(s(r)))return e(W(n(),r));const o=()=>{t.isEmpty(s(r))&&(i(o),e(W(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]=F.immer.produceWithPatches(this.#e,t);return this.#e=r.reduce((t,r)=>F.immer.applyPatches(t,[{...r,value:G(e,r,t,n,this.#n,this.#t)}]),this.#e),this.#e=D(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 J=new q;function K(e,t){return J.annotate(e,t)}function Q(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var X,Y={exports:{}};const Z=/* @__PURE__ */Q((X||(X=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,h=l.length;for(u=0;u<h;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}(Y)),Y.exports)),ee=r.createContext(new Z);function te(){return r.useContext(ee)}function ne({children:e}){const t=r.useMemo(()=>new Z,[]);/* @__PURE__ */
-return n(ee.Provider,{value:t,children:e})}const re=r.createContext(/* @__PURE__ */new Map);function oe(){return r.useContext(re)}function ce(){const[,e]=r.useReducer(e=>e+1,0);return e}function ie({action:t,renderer:n}){const o=te(),c=oe(),i=ce(),s=r.useMemo(()=>{const e=c.get(t);if(e)return e;const n={state:new q,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 se({children:e}){const t=r.useMemo(()=>/* @__PURE__ */new Map,[]);/* @__PURE__ */
-return n(re.Provider,{value:t,children:e})}const ae=r.createContext(/* @__PURE__ */new Map);function ue({children:e}){const t=r.useMemo(()=>/* @__PURE__ */new Map,[]);/* @__PURE__ */
-return n(ae.Provider,{value:t,children:e})}const le=r.createContext(/* @__PURE__ */new Set);function fe({children:e}){const t=r.useMemo(()=>/* @__PURE__ */new Set,[]);/* @__PURE__ */
-return n(le.Provider,{value:t,children:e})}function de({children:e}){/* @__PURE__ */
-return n(ne,{children:/* @__PURE__ */n(se,{children:/* @__PURE__ */n(ue,{children:/* @__PURE__ */n(fe,{children:e})})})})}const he=r.createContext(null);function pe(){return r.useContext(he)}function me(e,t){return e?.get(t)??null}function ye({action:t,scopeName:n,renderer:o}){const c=pe(),i=ce(),s=r.useMemo(()=>me(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 q,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 be({name:e,children:t}){const o=pe(),c=r.useMemo(()=>({name:e,emitter:new Z,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(he.Provider,{value:i,children:t})}function ve(e){return(t,n)=>{t.actions.produce(t=>{t.model[e]=n})}}function we(n,o=()=>({})){const i=te(),s=pe(),a=c(R),f=r.useContext(le),h=r.useContext(ae),p=ce(),m=r.useRef(null),y=r.useRef((()=>{const e=new q;return m.current=e.hydrate(n),e})()),[b,v]=r.useState(()=>y.current.model),w=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 Z,[]),_=r.useRef({handlers:/* @__PURE__ */new Map}),z=function(){const e=r.useRef(/* @__PURE__ */new Set),t=r.useRef(/* @__PURE__ */new Set);return r.useMemo(()=>({broadcast:e.current,multicast:t.current}),[])}(),L=r.useRef(d.Mounting),T=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}),[])}(),U=r.useRef(/* @__PURE__ */new Set),$=r.useRef(0),B=r.useCallback((t,n,r)=>{const o=new AbortController,c={controller:o,action:t,payload:n};return f.add(c),U.current.add(c),{model:b,get phase(){return L.current},task:c,data:w,tasks:f,nodes:T.refs.current,actions:{produce(e){if(o.signal.aborted)return;const t=y.current.produce(t=>e({model:t,inspect:y.current.inspect}));v(y.current.model),r.processes.add(t),m.current&&(r.processes.add(m.current),m.current=null)},dispatch(e,t,n){if(o.signal.aborted)return;const r=g(e),c=S(e)?e.channel:void 0;if(O(e)&&n?.scope){const e=me(s,n.scope);return void(e&&e.emitter.emit(r,t,c))}(x(e)?i:A).emit(r,t,c)},annotate:(e,t)=>y.current.annotate(e,t),cache:{put(t,n){const r=E(t),o=function(t){if((e.isObject(t)||e.isFunction(t))&&u.TTL in t)return t[u.TTL];throw new Error("Invalid cache operation")}(t),c=j(t)?M(t.channel):"",i=h.get(r);if(i){const e=i.get(c);if(e&&e.expiresAt>Date.now())return e.value}return n(e=>(h.has(r)||h.set(r,/* @__PURE__ */new Map),h.get(r).set(c,{value:e,expiresAt:Date.now()+o,channel:j(t)?t.channel:void 0}),e))},get(e){const t=E(e),n=j(e)?M(e.channel):"",r=h.get(t)?.get(n);return r&&r.expiresAt>Date.now()?r.value:void 0},delete(e){const t=E(e);if(j(e)){const n=e.channel,r=h.get(t);if(r)for(const[e,t]of r)t.channel&&C(n,t.channel)&&r.delete(e)}else h.delete(t)}}}}},[b]);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=B(t,o,s);try{await n(d,o)}catch(h){const e=_.current.handlers.has(l.Error),n={reason:N(h),error:k(h),action:P(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),U.current.delete(e);break}s.processes.forEach(e=>y.current.prune(e)),s.processes.size>0&&p(),u.resolve()}}}$.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(O(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),z.multicast.add(r),n.add(()=>A.off(r,e))}else x(r)?(i.on(r,e),A.on(r,e),z.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=++$.current,t=new Set(n);queueMicrotask(()=>{if($.current===e){for(const e of U.current)e.controller.abort(),f.delete(e);U.current.clear(),L.current=d.Unmounting,A.emit(l.Unmount),L.current=d.Unmounted;for(const e of t)e()}else for(const e of t)e()})}},[A]),r.useLayoutEffect(()=>{for(const[e,t]of T.pending.current)T.emitted.current.get(e)!==t&&(T.emitted.current.set(e,t),A.emit(u.Node,t,{Name:e}));T.pending.current.clear()}),function({unicast:n,broadcastActions:o,phase:c,data:i}){const s=oe(),a=r.useRef(null),u=r.useRef(!1);r.useLayoutEffect(()=>{u.current||(u.current=!0,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:z.broadcast,phase:L,data:o()});const F=r.useMemo(()=>[b,{dispatch(e,t,n){const r=g(e),o=S(e)?e.channel:void 0;if(O(e)&&n?.scope){const e=me(s,n.scope);return void(e&&e.emitter.emit(r,t,o))}(x(e)?i:A).emit(r,t,o)},consume:(e,t,n)=>O(e)&&n?.scope?r.createElement(ye,{action:g(e),scopeName:n.scope,renderer:t}):r.createElement(ie,{action:g(e),renderer:t}),get inspect(){return y.current.inspect},get nodes(){return T.refs.current},node(e,t){T.refs.current[e]=t,T.pending.current.set(e,t)}}],[b,A]);return F.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(()=>S(c.current)?c.current.channel:void 0,[]),a=g(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)},F}export{A as Action,de as Boundary,_ as Cache,f as Distribution,z as Error,l as Lifecycle,T as Op,T as Operation,h as Reason,be as Scope,q as State,ve as With,K as annotate,we as useActions,v as utils};
+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 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 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(){const e=/* @__PURE__ */Symbol();return t=>t??{_:e}}function _(e,t){return{[u.Rehydrate]:!0,model:e,channel:t}}function k(e){if(e instanceof Error){if("TimeoutError"===e.name)return p.Timedout;if("AbortError"===e.name)return p.Supplanted}return p.Errored}function R(e){return e instanceof Error?e:new Error(String(e))}const C=r(void 0);function N({handler:e,children:t}){/* @__PURE__ */
+return c(C.Provider,{value:e,children:t})}let U=(e=21)=>{let t="",n=crypto.getRandomValues(new Uint8Array(e|=0));for(;e--;)t+="useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict"[63&n[e]];return t};var z=/* @__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))(z||{}),L=/* @__PURE__ */(e=>(e[e.Produce=0]="Produce",e[e.Hydrate=1]="Hydrate",e))(L||{}),T=/* @__PURE__ */(e=>(e.Property="property",e.Process="process",e.Value="value",e.Operation="operation",e))(T||{});class B{[i]=!0;static keys=new Set(Object.values(T));property=null;process=null;value;operation;constructor(e,t){this.value=e,this.operation=t}assign(e,t){const n=new B(this.value,this.operation);return n.property=e,n.process=t,n}}class ${static immer=(()=>{s();const e=new a;return e.setAutoFreeze(!1),e})();static tag="κ";static id=U}function F(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 W(t){if(e.isNullable(t)||D(t))return t;if(e.isArray(t))return t.map(e=>W(e));if(e.isObject(t)){const e=Object.entries(t).map(([e,t])=>[e,W(t)]);return{...Object.fromEntries(e),[$.tag]:t[$.tag]??$.id()}}return t}function H(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 D(t){return e.isNullable(t)||e.isString(t)||e.isNumber(t)||e.isBoolean(t)||"symbol"==typeof t||"bigint"==typeof t}function I(t,n,r,o,c,i){return function s(a,u=n.path){if(a instanceof B){const n=F(r,u.join("."));if(Object.entries(a).filter(([e,t])=>!B.keys.has(e)&&t instanceof B).forEach(([e,t])=>s(t,u.concat(e))),D(a.value)){if(t===L.Hydrate)return a.value;const s=u.slice(0,-1),l=s.length>0?F(r,s.join(".")):r;return e.isNullable(l)||G(l,a,u.at(-1),o,c,i),n??a.value}if(t===L.Hydrate){const e=W(s(a.value,u));return G(e,a,null,o,c,i),e}const l=n??W(a.value);return G(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===L.Hydrate){const e=W(n);return Object.entries(a).forEach(([t,n])=>{n instanceof B&&D(n.value)&&G(e,n,t,o,c,i)}),e}return n}return a}(n.value)}function G(e,t,n,r,o,c){const i=c(e),s=o.get(i)??[];o.set(i,[t.assign(n,r),...s])}class V{#e={};#t;#n=/* @__PURE__ */new Map;#r=/* @__PURE__ */new Set;#o=!1;constructor(e=H){this.#t=e}static pk(){return U()}static"κ"=V.pk;annotate(e,t){return new B(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=F(n(),c),a=c.slice(0,-1),u=t.isNotEmpty(a)?F(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:F(n(),r),inspect:e(r)}):"is"===a?e=>s(r).some(t=>0!==(t.operation&e)):"draft"===a?()=>t.head(s(r))?.value??F(n(),r):"settled"===a?()=>new Promise(e=>{if(t.isEmpty(s(r)))return e(F(n(),r));const o=()=>{t.isEmpty(s(r))&&(i(o),e(F(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(L.Hydrate,()=>e)}produce(e){if(!this.#o)throw new Error("State must be hydrated using hydrate() before calling produce()");return this.#c(L.Produce,e)}#c(e,t){const n=/* @__PURE__ */Symbol("process"),[,r]=$.immer.produceWithPatches(this.#e,t);return this.#e=r.reduce((t,r)=>$.immer.applyPatches(t,[{...r,value:I(e,r,t,n,this.#n,this.#t)}]),this.#e),this.#e=W(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 q=new V;function J(e,t){return q.annotate(e,t)}function K(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var Q,X={exports:{}};const Y=/* @__PURE__ */K((Q||(Q=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}(X)),X.exports)),Z=n.createContext(new Y);function ee(){return n.useContext(Z)}function te({children:e}){const t=n.useMemo(()=>new Y,[]);/* @__PURE__ */
+return c(Z.Provider,{value:t,children:e})}const ne=n.createContext(/* @__PURE__ */new Map);function re(){return n.useContext(ne)}function oe(){const[,e]=n.useReducer(e=>e+1,0);return e}function ce({action:t,renderer:r}){const o=ee(),c=re(),i=oe(),s=n.useMemo(()=>{const e=c.get(t);if(e)return e;const n={state:new V,listeners:/* @__PURE__ */new Set};return c.set(t,n),n},[t,c]);n.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:r({value:a,inspect:s.state.inspect.value})}function ie({children:e}){const t=n.useMemo(()=>/* @__PURE__ */new Map,[]);/* @__PURE__ */
+return c(ne.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 ae=n.createContext(/* @__PURE__ */new Set);function ue({children:e}){const t=n.useMemo(()=>/* @__PURE__ */new Set,[]);/* @__PURE__ */
+return c(ae.Provider,{value:t,children:e})}function le({children:e}){/* @__PURE__ */
+return c(te,{children:/* @__PURE__ */c(ie,{children:/* @__PURE__ */c(se,{children:/* @__PURE__ */c(ue,{children:e})})})})}const fe=n.createContext(null);function de(){return n.useContext(fe)}function pe(e,t){return e?.get(t)??null}function he({action:t,scopeName:r,renderer:o}){const c=de(),i=oe(),s=n.useMemo(()=>pe(c,r),[c,r]),a=n.useMemo(()=>s?function(e,t){const n=e.store.get(t);if(n)return n;const r={state:new V,listeners:/* @__PURE__ */new Set};return e.store.set(t,r),r}(s,t):null,[t,s]);if(n.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 me({name:e,children:t}){const r=de(),o=n.useMemo(()=>({name:e,emitter:new Y,store:/* @__PURE__ */new Map,listeners:/* @__PURE__ */new Map}),[]),i=n.useMemo(()=>{const t=new Map(r??[]);return t.set(e,o),t},[r,e,o]);/* @__PURE__ */
+return c(fe.Provider,{value:i,children:t})}function ye(e){return(t,n)=>{t.actions.produce(t=>{t.model[e]=n})}}function be(r,c=()=>({})){const i=ee(),s=de(),a=o(C),f=n.useContext(ae),p=oe(),h=n.useRef(!1),m=n.useRef(null),y=n.useRef(new V),{model:b,save:v,invalidate:g}=function(e){const t=n.useContext(A),r=n.useRef(null);if(!r.current){const n=e=>{const n=O(e);t.data.delete(n)};if("object"==typeof(o=e)&&null!==o&&u.Rehydrate in o&&!0===o[u.Rehydrate]){const{channel:o,model:c}=e,i=function(e,t){const n=O(t);return e.data.get(n)||null}(t,o);r.current={model:i??c,save:e=>function(e,t,n){const r=O(t);e.data.set(r,n)}(t,o,e),invalidate:n}}else r.current={model:e,save:()=>{},invalidate:n}}var o;return r.current}(r);h.current||(h.current=!0,m.current=y.current.hydrate(b));const[M,j]=n.useState(()=>y.current.model),_=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()),N=n.useMemo(()=>new Y,[]),U=n.useRef({handlers:/* @__PURE__ */new Map});U.current.handlers=/* @__PURE__ */new Map;const z=function(){const e=n.useRef(/* @__PURE__ */new Set),t=n.useRef(/* @__PURE__ */new Set);return n.useMemo(()=>({broadcast:e.current,multicast:t.current}),[])}(),L=n.useRef(d.Mounting),T=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}),[])}(),B=n.useRef(/* @__PURE__ */new Set),$=n.useRef(0),F=n.useCallback((e,t,n)=>{const r=new AbortController,o={controller:r,action:e,payload:t};return f.add(o),B.current.add(o),{model:M,get phase(){return L.current},task:o,data:_,tasks:f,nodes:T.refs.current,actions:{produce(e){if(r.signal.aborted)return;const t=y.current.produce(t=>e({model:t,inspect:y.current.inspect}));j(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=pe(s,n.scope);return void(e&&e.emitter.emit(o,t,c))}(S(e)?i:N).emit(o,t,c)},annotate:(e,t)=>y.current.annotate(e,t),invalidate(e){g(e)}}}},[M]);n.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=F(t,o,s);try{await n(d,o)}catch(h){const e=U.current.handlers.has(l.Error),n={reason:k(h),error:R(h),action:x(t),handled:e,tasks:f};a?.(n),e&&N.emit(l.Error,n)}finally{for(const e of f)if(e===d.task){f.delete(e),B.current.delete(e);break}s.processes.forEach(e=>y.current.prune(e)),s.processes.size>0&&p(),u.resolve()}}}$.current++;const n=/* @__PURE__ */new Set;return U.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))}N.on(r,e),z.multicast.add(r),n.add(()=>N.off(r,e))}else S(r)?(i.on(r,e),N.on(r,e),z.broadcast.add(r),n.add(()=>{i.off(r,e),N.off(r,e)})):(N.on(r,e),n.add(()=>N.off(r,e)))}}),()=>{const e=++$.current,t=new Set(n);queueMicrotask(()=>{if($.current===e){v(y.current.model);for(const e of B.current)e.controller.abort(),f.delete(e);B.current.clear(),L.current=d.Unmounting,N.emit(l.Unmount),L.current=d.Unmounted;for(const e of t)e()}else for(const e of t)e()})}},[N]),n.useLayoutEffect(()=>{for(const[e,t]of T.pending.current)T.emitted.current.get(e)!==t&&(T.emitted.current.set(e,t),N.emit(u.Node,t,{Name:e}));T.pending.current.clear()}),function({unicast:r,broadcastActions:o,phase:c,data:i}){const s=re(),a=n.useRef(null);n.useLayoutEffect(()=>{c.current===d.Mounting&&(r.emit(l.Mount),o.forEach(t=>{const n=s.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,i);t.isNotEmpty(Object.keys(e))&&r.emit(l.Update,e)}a.current=i},[i,r])}({unicast:N,broadcastActions:z.broadcast,phase:L,data:c()});const W=n.useMemo(()=>[M,{dispatch(e,t,n){const r=w(e),o=P(e)?e.channel:void 0;if(E(e)&&n?.scope){const e=pe(s,n.scope);return void(e&&e.emitter.emit(r,t,o))}(S(e)?i:N).emit(r,t,o)},consume:(e,t,r)=>E(e)&&r?.scope?n.createElement(he,{action:w(e),scopeName:r.scope,renderer:t}):n.createElement(ce,{action:w(e),renderer:t}),get inspect(){return y.current.inspect},get nodes(){return T.refs.current},node(e,t){T.refs.current[e]=t,T.pending.current.set(e,t)}}],[M,N]);return W.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 i=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)},[]),s=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:s,handler:i})}(U,e,t)},W}export{M as Action,le as Boundary,f as Distribution,N as Error,j as Id,l as Lifecycle,z as Op,z as Operation,p as Reason,_ as Rehydrate,me as Scope,V as State,ye as With,J as annotate,be 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 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");static TTL=Symbol("chizu.brand/TTL")}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 h={actionPrefix:"chizu.action/",broadcastActionPrefix:"chizu.action/broadcast/",multicastActionPrefix:"chizu.action/multicast/",channelPrefix:"chizu.channel/",cachePrefix:"chizu.cache/"};function p(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 b=Object.freeze(Object.defineProperty({__proto__:null,config:h,pk:m,sleep:p,"ζ":p,"κ":m},Symbol.toStringTag,{value:"Module"})),y=e=>"symbol"==typeof e;function v(e){return t.G.isString(e)||y(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(h.broadcastActionPrefix);if(y(e))return e.description?.startsWith(h.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(h.broadcastActionPrefix)??!1}}return!1}function w(e){const n=v(e),r=t.G.isString(n)?n:n.description??"";return r.startsWith(h.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(h.multicastActionPrefix);if(y(e))return e.description?.startsWith(h.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(h.multicastActionPrefix)??!1}}return!1}function A(e){if((t.G.isObject(e)||t.G.isFunction(e))&&s.Action in e)return e[s.Action];throw new Error("Invalid cache operation")}function O(e){return function(e){return(t.G.isObject(e)||t.G.isFunction(e))&&s.Cache in e&&!0===e[s.Cache]}(e)&&t.G.isObject(e)&&s.Channel in e&&"channel"in e}function P(e){return e?[...Object.keys(e)].toSorted().map(t=>`${t}=${String(e[t])}`).join("&"):""}function S(e,t){return Object.keys(e).every(n=>t[n]===e[n])}function E(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 G=r.createContext(void 0);let C=(e=21)=>{let t="",n=crypto.getRandomValues(new Uint8Array(e|=0));for(;e--;)t+="useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict"[63&n[e]];return t};var _=(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))(_||{}),N=(e=>(e[e.Produce=0]="Produce",e[e.Hydrate=1]="Hydrate",e))(N||{}),k=(e=>(e.Property="property",e.Process="process",e.Value="value",e.Operation="operation",e))(k||{});class R{[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 R(this.value,this.operation);return n.property=e,n.process=t,n}}class T{static immer=(()=>{o.enablePatches();const e=new o.Immer;return e.setAutoFreeze(!1),e})();static tag="κ";static id=C}function z(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 L(e){if(t.G.isNullable(e)||B(e))return e;if(t.G.isArray(e))return e.map(e=>L(e));if(t.G.isObject(e)){const t=Object.entries(e).map(([e,t])=>[e,L(t)]);return{...Object.fromEntries(t),[T.tag]:e[T.tag]??T.id()}}return e}function U(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 B(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 $(e,n,r,o,c,i){return function s(a,u=n.path){if(a instanceof R){const n=z(r,u.join("."));if(Object.entries(a).filter(([e,t])=>!R.keys.has(e)&&t instanceof R).forEach(([e,t])=>s(t,u.concat(e))),B(a.value)){if(e===N.Hydrate)return a.value;const s=u.slice(0,-1),l=s.length>0?z(r,s.join(".")):r;return t.G.isNullable(l)||D(l,a,u.at(-1),o,c,i),n??a.value}if(e===N.Hydrate){const e=L(s(a.value,u));return D(e,a,null,o,c,i),e}const l=n??L(a.value);return D(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===N.Hydrate){const e=L(n);return Object.entries(a).forEach(([t,n])=>{n instanceof R&&B(n.value)&&D(e,n,t,o,c,i)}),e}return n}return a}(n.value)}function D(e,t,n,r,o,c){const i=c(e),s=o.get(i)??[];o.set(i,[t.assign(n,r),...s])}class F{#e={};#t;#n=new Map;#r=new Set;#o=!1;constructor(e=U){this.#t=e}static pk(){return C()}static"κ"=F.pk;annotate(e,t){return new R(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=z(e(),o),s=o.slice(0,-1),a=t.A.isNotEmpty(s)?z(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:z(e(),r),inspect:n(r)}):"is"===a?e=>i(r).some(t=>0!==(t.operation&e)):"draft"===a?()=>t.A.head(i(r))?.value??z(e(),r):"settled"===a?()=>new Promise(n=>{if(t.A.isEmpty(i(r)))return n(z(e(),r));const s=()=>{t.A.isEmpty(i(r))&&(c(s),n(z(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(N.Hydrate,()=>e)}produce(e){if(!this.#o)throw new Error("State must be hydrated using hydrate() before calling produce()");return this.#c(N.Produce,e)}#c(e,t){const n=Symbol("process"),[,r]=T.immer.produceWithPatches(this.#e,t);return this.#e=r.reduce((t,r)=>T.immer.applyPatches(t,[{...r,value:$(e,r,t,n,this.#n,this.#t)}]),this.#e),this.#e=L(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 W=new F;function H(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var I,q={exports:{}},V=(I||(I=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,h=l.length;for(u=0;u<h;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}(q)),q.exports);const J=H(V),K=i.createContext(new J);function Q(){return i.useContext(K)}function X({children:e}){const t=i.useMemo(()=>new J,[]);return n.jsx(K.Provider,{value:t,children:e})}const Y=i.createContext(new Map);function Z(){return i.useContext(Y)}function ee(){const[,e]=i.useReducer(e=>e+1,0);return e}function te({action:e,renderer:n}){const r=Q(),o=Z(),c=ee(),s=i.useMemo(()=>{const t=o.get(e);if(t)return t;const n={state:new F,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 ne({children:e}){const t=i.useMemo(()=>new Map,[]);return n.jsx(Y.Provider,{value:t,children:e})}const re=i.createContext(new Map);function oe({children:e}){const t=i.useMemo(()=>new Map,[]);return n.jsx(re.Provider,{value:t,children:e})}const ce=i.createContext(new Set);function ie({children:e}){const t=i.useMemo(()=>new Set,[]);return n.jsx(ce.Provider,{value:t,children:e})}const se=i.createContext(null);function ae(){return i.useContext(se)}function ue(e,t){return e?.get(t)??null}function le({action:e,scopeName:n,renderer:r}){const o=ae(),c=ee(),s=i.useMemo(()=>ue(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 F,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(`${h.broadcastActionPrefix}${e}`):t===u.Multicast?Symbol(`${h.multicastActionPrefix}${e}`):Symbol(`${h.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(X,{children:n.jsx(ne,{children:n.jsx(oe,{children:n.jsx(ie,{children:e})})})})},e.Cache=e=>{const t=Symbol(`${h.cachePrefix}${e}`),n=function(n){return{[s.Action]:t,[s.Cache]:!0,[s.TTL]:e,[s.Channel]:n,channel:n}};return Object.defineProperty(n,s.Action,{value:t,enumerable:!1}),Object.defineProperty(n,s.Cache,{value:!0,enumerable:!1}),Object.defineProperty(n,s.TTL,{value:e,enumerable:!1}),n},e.Distribution=u,e.Error=function({handler:e,children:t}){return n.jsx(G.Provider,{value:e,children:t})},e.Lifecycle=a,e.Op=_,e.Operation=_,e.Reason=f,e.Scope=function({name:e,children:t}){const r=ae(),o=i.useMemo(()=>({name:e,emitter:new J,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(se.Provider,{value:c,children:t})},e.State=F,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,n=()=>({})){const o=Q(),c=ae(),u=r.useContext(G),f=i.useContext(ce),d=i.useContext(re),h=ee(),p=i.useRef(null),m=i.useRef((()=>{const t=new F;return p.current=t.hydrate(e),t})()),[b,y]=i.useState(()=>m.current.model),C=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()),_=i.useMemo(()=>new J,[]),N=i.useRef({handlers:new Map}),k=function(){const e=i.useRef(new Set),t=i.useRef(new Set);return i.useMemo(()=>({broadcast:e.current,multicast:t.current}),[])}(),R=i.useRef(l.Mounting),T=function(){const e=i.useRef({}),t=i.useRef(new Map),n=i.useRef(new Map);return i.useMemo(()=>({refs:e,pending:t,emitted:n}),[])}(),z=i.useRef(new Set),L=i.useRef(0),U=i.useCallback((e,n,r)=>{const i=new AbortController,a={controller:i,action:e,payload:n};return f.add(a),z.current.add(a),{model:b,get phase(){return R.current},task:a,data:C,tasks:f,nodes:T.refs.current,actions:{produce(e){if(i.signal.aborted)return;const t=m.current.produce(t=>e({model:t,inspect:m.current.inspect}));y(m.current.model),r.processes.add(t),p.current&&(r.processes.add(p.current),p.current=null)},dispatch(e,t,n){if(i.signal.aborted)return;const r=v(e),s=x(e)?e.channel:void 0;if(j(e)&&n?.scope){const e=ue(c,n.scope);return void(e&&e.emitter.emit(r,t,s))}(g(e)?o:_).emit(r,t,s)},annotate:(e,t)=>m.current.annotate(e,t),cache:{put(e,n){const r=A(e),o=function(e){if((t.G.isObject(e)||t.G.isFunction(e))&&s.TTL in e)return e[s.TTL];throw new Error("Invalid cache operation")}(e),c=O(e)?P(e.channel):"",i=d.get(r);if(i){const e=i.get(c);if(e&&e.expiresAt>Date.now())return e.value}return n(t=>(d.has(r)||d.set(r,new Map),d.get(r).set(c,{value:t,expiresAt:Date.now()+o,channel:O(e)?e.channel:void 0}),t))},get(e){const t=A(e),n=O(e)?P(e.channel):"",r=d.get(t)?.get(n);return r&&r.expiresAt>Date.now()?r.value:void 0},delete(e){const t=A(e);if(O(e)){const n=e.channel,r=d.get(t);if(r)for(const[e,t]of r)t.channel&&S(n,t.channel)&&r.delete(e)}else d.delete(t)}}}}},[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(p){const t=N.current.handlers.has(a.Error),n={reason:E(p),error:M(p),action:w(e),handled:t,tasks:f};u?.(n),t&&_.emit(a.Error,n)}finally{for(const e of f)if(e===d.task){f.delete(e),z.current.delete(e);break}s.processes.forEach(e=>m.current.prune(e)),s.processes.size>0&&h(),l.resolve()}}}L.current++;const n=new Set;return N.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))}_.on(r,t),k.multicast.add(r),n.add(()=>_.off(r,t))}else g(r)?(o.on(r,t),_.on(r,t),k.broadcast.add(r),n.add(()=>{o.off(r,t),_.off(r,t)})):(_.on(r,t),n.add(()=>_.off(r,t)))}}),()=>{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=l.Unmounting,_.emit(a.Unmount),R.current=l.Unmounted;for(const e of t)e()}else for(const e of t)e()})}},[_]),i.useLayoutEffect(()=>{for(const[e,t]of T.pending.current)T.emitted.current.get(e)!==t&&(T.emitted.current.set(e,t),_.emit(s.Node,t,{Name:e}));T.pending.current.clear()}),function({unicast:e,broadcastActions:n,phase:r,data:o}){const c=Z(),s=i.useRef(null),u=i.useRef(!1);i.useLayoutEffect(()=>{u.current||(u.current=!0,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:_,broadcastActions:k.broadcast,phase:R,data:n()});const B=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=ue(c,n.scope);return void(e&&e.emitter.emit(r,t,i))}(g(e)?o:_).emit(r,t,i)},consume:(e,t,n)=>j(e)&&n?.scope?i.createElement(le,{action:v(e),scopeName:n.scope,renderer:t}):i.createElement(te,{action:v(e),renderer:t}),get inspect(){return m.current.inspect},get nodes(){return T.refs.current},node(e,t){T.refs.current[e]=t,T.pending.current.set(e,t)}}],[b,_]);return B.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})}(N,e,t)},B},e.utils=b,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);
+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(n);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 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=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}const S=i.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||{}),_=(e=>(e[e.Produce=0]="Produce",e[e.Hydrate=1]="Hydrate",e))(_||{}),C=(e=>(e.Property="property",e.Process="process",e.Value="value",e.Operation="operation",e))(C||{});class G{[o.immerable]=!0;static keys=new Set(Object.values(C));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 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,i){return function s(a,u=n.path){if(a instanceof G){const n=N(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))),L(a.value)){if(e===_.Hydrate)return a.value;const s=u.slice(0,-1),l=s.length>0?N(r,s.join(".")):r;return t.G.isNullable(l)||B(l,a,u.at(-1),o,c,i),n??a.value}if(e===_.Hydrate){const e=z(s(a.value,u));return B(e,a,null,o,c,i),e}const l=n??z(a.value);return B(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===_.Hydrate){const e=z(n);return Object.entries(a).forEach(([t,n])=>{n instanceof G&&L(n.value)&&B(e,n,t,o,c,i)}),e}return n}return a}(n.value)}function B(e,t,n,r,o,c){const i=c(e),s=o.get(i)??[];o.set(i,[t.assign(n,r),...s])}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 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=N(e(),o),s=o.slice(0,-1),a=t.A.isNotEmpty(s)?N(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:N(e(),r),inspect:n(r)}):"is"===a?e=>i(r).some(t=>0!==(t.operation&e)):"draft"===a?()=>t.A.head(i(r))?.value??N(e(),r):"settled"===a?()=>new Promise(n=>{if(t.A.isEmpty(i(r)))return n(N(e(),r));const s=()=>{t.A.isEmpty(i(r))&&(c(s),n(N(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(_.Hydrate,()=>e)}produce(e){if(!this.#o)throw new Error("State must be hydrated using hydrate() before calling produce()");return this.#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.#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 W=new $;function F(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var I,D={exports:{}},H=(I||(I=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}(D)),D.exports);const q=F(H),V=i.createContext(new q);function J(){return i.useContext(V)}function K({children:e}){const t=i.useMemo(()=>new q,[]);return r.jsx(V.Provider,{value:t,children:e})}const Q=i.createContext(new Map);function X(){return i.useContext(Q)}function Y(){const[,e]=i.useReducer(e=>e+1,0);return e}function Z({action:e,renderer:n}){const r=J(),o=X(),c=Y(),s=i.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]);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 ee({children:e}){const t=i.useMemo(()=>new Map,[]);return r.jsx(Q.Provider,{value:t,children:e})}function te({children:e}){const t=i.useMemo(()=>({data:new Map}),[]);return r.jsx(S.Provider,{value:t,children:e})}const ne=i.createContext(new Set);function re({children:e}){const t=i.useMemo(()=>new Set,[]);return r.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=Y(),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 $,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 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.Id=function(){const e=Symbol();return t=>t??{_:e}},e.Lifecycle=a,e.Op=R,e.Operation=R,e.Reason=f,e.Rehydrate=function(e,t){return{[s.Rehydrate]:!0,model:e,channel:t}},e.Scope=function({name:e,children:t}){const n=ce(),o=i.useMemo(()=>({name:e,emitter:new q,store:new Map,listeners:new Map}),[]),c=i.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=i.useContext(ne),d=Y(),p=i.useRef(!1),h=i.useRef(null),m=i.useRef(new $),{model:y,save:b,invalidate:O}=function(e){const t=i.useContext(S),n=i.useRef(null);if(!n.current){const o=e=>{const n=P(e);t.data.delete(n)};if("object"==typeof(r=e)&&null!==r&&s.Rehydrate in r&&!0===r[s.Rehydrate]){const{channel:r,model:c}=e,i=function(e,t){const n=P(t);return e.data.get(n)||null}(t,r);n.current={model:i??c,save:e=>function(e,t,n){const r=P(t);e.data.set(r,n)}(t,r,e),invalidate:o}}else n.current={model:e,save:()=>{},invalidate:o}}var r;return n.current}(e);p.current||(p.current=!0,h.current=m.current.hydrate(y));const[R,_]=i.useState(()=>m.current.model),C=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])}(r()),G=i.useMemo(()=>new q,[]),k=i.useRef({handlers:new Map});k.current.handlers=new Map;const N=function(){const e=i.useRef(new Set),t=i.useRef(new Set);return i.useMemo(()=>({broadcast:e.current,multicast:t.current}),[])}(),z=i.useRef(l.Mounting),U=function(){const e=i.useRef({}),t=i.useRef(new Map),n=i.useRef(new Map);return i.useMemo(()=>({refs:e,pending:t,emitted:n}),[])}(),L=i.useRef(new Set),T=i.useRef(0),B=i.useCallback((e,t,n)=>{const r=new AbortController,i={controller:r,action:e,payload:t};return f.add(i),L.current.add(i),{model:R,get phase(){return z.current},task:i,data:C,tasks:f,nodes:U.refs.current,actions:{produce(e){if(r.signal.aborted)return;const t=m.current.produce(t=>e({model:t,inspect:m.current.inspect}));_(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 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:G).emit(i,t,s)},annotate:(e,t)=>m.current.annotate(e,t),invalidate(e){O(e)}}}},[R]);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(),p=B(e,o,s);try{await n(p,o)}catch(h){const t=k.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),L.current.delete(e);break}s.processes.forEach(e=>m.current.prune(e)),s.processes.size>0&&d(),l.resolve()}}}T.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))}G.on(r,t),N.multicast.add(r),n.add(()=>G.off(r,t))}else g(r)?(o.on(r,t),G.on(r,t),N.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=++T.current,t=new Set(n);queueMicrotask(()=>{if(T.current===e){b(m.current.model);for(const e of L.current)e.controller.abort(),f.delete(e);L.current.clear(),z.current=l.Unmounting,G.emit(a.Unmount),z.current=l.Unmounted;for(const e of t)e()}else for(const e of t)e()})}},[G]),i.useLayoutEffect(()=>{for(const[e,t]of U.pending.current)U.emitted.current.get(e)!==t&&(U.emitted.current.set(e,t),G.emit(s.Node,t,{Name:e}));U.pending.current.clear()}),function({unicast:e,broadcastActions:n,phase:r,data:o}){const c=X(),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:G,broadcastActions:N.broadcast,phase:z,data:r()});const W=i.useMemo(()=>[R,{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:G).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(Z,{action:v(e),renderer:t}),get inspect(){return m.current.inspect},get nodes(){return U.refs.current},node(e,t){U.refs.current[e]=t,U.pending.current.set(e,t)}}],[R,G]);return W.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)},W},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);

package/dist/hooks/index.d.ts

@@ -1,5 +1,6 @@
 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.
@@ -17,64 +18,32 @@ export { With } from './utils.ts';
  *
  * @template M The model type representing the component's state.
  * @template AC The actions class containing action definitions.
- * @template S The data type for reactive external values.
- * @param initialModel The initial model state.
- * @param ƒ Optional function that returns reactive values as data.
+ * @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 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.
  * @returns A result `[model, actions]` with pre-typed `useAction` method.
  *
  * @example
  * ```typescript
- * // types.ts
- * type Model = { visitor: Country | null };
- *
- * export class Actions {
- *   static Visitor = Action<Country>("Visitor");
- * }
- *
- * // actions.ts
- * export function useVisitorActions() {
- *   const actions = useActions<Model, typeof Actions>(model);
- *
- *   actions.useAction(Lifecycle.Mount, (context) => {
- *     // Setup logic - types are pre-baked from useActions
- *   });
- *
- *   actions.useAction(Actions.Visitor, (context, country) => {
- *     context.actions.produce((draft) => {
- *       draft.model.visitor = country;
- *     });
- *   });
- *
- *   actions.useAction(Lifecycle.Unmount, (context) => {
- *     // Cleanup logic
- *   });
- *
- *   return actions;
- * }
- *
- * // With data for reactive external values
- * function useSearchActions(props: { query: string }) {
- *   const actions = useActions<Model, typeof Actions, { query: string }>(
- *     model,
- *     () => ({ query: props.query })
- *   );
- *
- *   actions.useAction(Actions.Search, async (context) => {
- *     await fetch("/search");
- *     // context.data.query is always the latest value
- *     console.log(context.data.query);
- *   });
- *
- *   return actions;
- * }
- *
- * // Component usage
- * function Visitor() {
- *   const [model, actions] = useVisitorActions();
- *   return <div>{model.visitor?.name}</div>;
- * }
+ * // 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,
+ *   () => ({ query: props.query }),
+ * );
  * ```
  */
-export declare function useActions<M extends Model, AC extends Actions, D extends Props = Props>(initialModel: M, getData?: Data<D>): UseActions<M, AC, D>;
+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>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { Action } from './action/index.ts';
-export { Cache } from './cache/index.ts';
+export { Rehydrate, Id } from './rehydrate/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 { StoreId } from './rehydrate/index.ts';

package/dist/rehydrate/index.d.ts

@@ -0,0 +1,138 @@
+import { Filter, Model } from '../types/index.ts';
+/**
+ * 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;
+/**
+ * Phantom brand symbol for model type tracking on store identifiers.
+ * Uses a function type `(m: M) => M` to enforce invariance, preventing
+ * a store entry declared for one model from being used with a different model.
+ * @internal
+ */
+declare const StoreModelBrand: unique symbol;
+/**
+ * A `Filter` branded with a phantom model type `M`.
+ *
+ * Returned by `Id<M>()` and `Id<M, C>()`, this type carries the model at
+ * the type level so that `Rehydrate(model, storeId)` can verify at compile
+ * time that the model and the store entry agree on the model shape.
+ *
+ * The phantom brand uses a function type `(m: M) => M` to enforce invariance —
+ * `StoreId<A>` is not assignable to `StoreId<B>` unless `A` and `B` are
+ * identical, preventing accidental cross-component snapshot usage.
+ *
+ * @template M - The model type this store entry is scoped to.
+ */
+export type StoreId<M extends Model = Model> = Filter & {
+    readonly [StoreModelBrand]?: (m: M) => M;
+};
+/**
+ * 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;
+};
+/**
+ * Creates a typed store entry for rehydration snapshots.
+ *
+ * The first type parameter `M` binds the store entry to a specific model type,
+ * ensuring that `Rehydrate(model, storeId)` produces a compile-time error if
+ * the model and store entry disagree on the model shape.
+ *
+ * When called with only `M`, returns a nullary function that produces a unique
+ * `StoreId<M>` — useful for components with a single instance (unchanneled).
+ *
+ * When called with `M` and `C`, returns a unary function that passes through
+ * the channel object as `C & StoreId<M>` — useful for components with multiple
+ * instances keyed by some identifier (channeled).
+ *
+ * @template M - The model type this store entry is scoped to.
+ * @template C - The channel type, constrained to `Filter` (object of non-nullable primitives).
+ * @returns A function that produces a `StoreId<M>` for use with `Rehydrate` and `invalidate`.
+ *
+ * @example
+ * ```ts
+ * import { Id, Rehydrate } from "chizu";
+ *
+ * type CounterModel = { count: number };
+ *
+ * class Store {
+ *   // Unchanneled — one snapshot for all instances
+ *   static Settings = Id<SettingsModel>();
+ *
+ *   // Channeled — independent snapshot per UserId
+ *   static Counter = Id<CounterModel, { UserId: number }>();
+ * }
+ *
+ * // Unchanneled usage
+ * const actions = useActions<SettingsModel, typeof Actions>(
+ *   Rehydrate(model, Store.Settings()),
+ * );
+ *
+ * // Channeled usage
+ * const actions = useActions<CounterModel, typeof Actions>(
+ *   Rehydrate(model, Store.Counter({ UserId: props.userId })),
+ * );
+ *
+ * // Compile error — model mismatch!
+ * // Rehydrate(settingsModel, Store.Counter({ UserId: 1 }));
+ *
+ * // Invalidate a specific snapshot
+ * context.actions.invalidate(Store.Counter({ UserId: 5 }));
+ * context.actions.invalidate(Store.Settings());
+ * ```
+ */
+export declare function Id<M extends Model>(): () => StoreId<M>;
+export declare function Id<M extends Model, C extends Filter>(): (channel: C) => C & StoreId<M>;
+/**
+ * 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 must be a `StoreId<M>` produced by `Id<M>()` or `Id<M, C>()`.
+ * TypeScript verifies that the model type `M` of the store entry matches the
+ * model being passed, preventing accidental cross-component snapshot usage.
+ *
+ * @template M - The model type.
+ * @param model - The initial model (used as fallback when no snapshot exists).
+ * @param channel - A `StoreId<M>` 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, Store.Counter({ UserId: props.userId })),
+ * );
+ * ```
+ */
+export declare function Rehydrate<M extends Model>(model: M, channel: StoreId<M>): 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;
+    invalidate: (channel: Filter) => void;
+};
+export {};

package/dist/types/index.d.ts

@@ -56,10 +56,8 @@ export declare class Brand {
     static Channel: symbol;
     /** Node capture events used by Lifecycle.Node */
     static Node: symbol;
-    /** Identifies cache operations created with Cache() */
-    static Cache: symbol;
-    /** TTL value for cache operations */
-    static TTL: symbol;
+    /** Identifies rehydrated model wrappers created with Rehydrate() */
+    static Rehydrate: symbol;
 }
 /**
  * Lifecycle actions that trigger at specific points in a component's lifecycle.
@@ -279,56 +277,6 @@ export type BroadcastPayload<P = unknown, C extends Filter = never> = HandlerPay
  * ```
  */
 export type MulticastPayload<P = unknown, C extends Filter = never> = HandlerPayload<P, C> & {};
-/**
- * Branded type for cache operations created with `Cache()`.
- * Cache operations identify cached async results and carry a TTL for expiration.
- *
- * When a channel type is specified, the cache operation becomes callable to
- * create channeled cache keys for targeted lookups.
- *
- * @template C - The channel type for keyed cache entries (defaults to never)
- *
- * @example
- * ```ts
- * export class CacheStore {
- *   static User = Cache<{ UserId: number }>(30_000);  // 30s TTL, channeled
- *   static Config = Cache(60_000);                     // 60s TTL, unchanneled
- * }
- *
- * // Channeled usage
- * context.actions.cache.put(CacheStore.User({ UserId: 5 }), () => fetchUser(5));
- * context.actions.cache.delete(CacheStore.User({ UserId: 5 }));
- * ```
- */
-export type CachePayload<C extends Filter = never> = {} & ([C] extends [never] ? unknown : {
-    (channel: C): ChanneledCache<C>;
-});
-/**
- * Result of calling a cache operation with a channel argument.
- * Contains the cache reference and the channel data for keyed lookup.
- *
- * @template C - The channel type
- */
-export type ChanneledCache<C = unknown> = {
-    readonly channel: C;
-};
-/**
- * Union type representing either a plain or channeled cache operation.
- * Used in `cache.put`, `cache.get`, and `cache.delete` signatures.
- */
-export type AnyCacheOperation = CachePayload<Filter> | ChanneledCache;
-/**
- * Interface for the Cache factory function.
- */
-export type CacheFactory = {
-    /**
-     * Creates a new cache operation with a TTL in milliseconds.
-     * @template C The channel type for keyed cache entries (defaults to never).
-     * @param ttl Time-to-live in milliseconds.
-     * @returns A typed cache operation object.
-     */
-    <C extends Filter = never>(ttl: number): CachePayload<C>;
-};
 /**
  * Options for multicast dispatch.
  * Required when dispatching a multicast action.
@@ -556,75 +504,21 @@ export type HandlerContext<M extends Model, _AC extends Actions, D extends Props
         dispatch(action: ActionOrChanneled, payload?: unknown, options?: MulticastOptions): void;
         annotate<T>(operation: Operation, value: T): T;
         /**
-         * Cache operations for reading, writing, and deleting cached values.
+         * Removes a rehydration snapshot from the store.
+         *
+         * Use this to invalidate persisted state for a specific channel key,
+         * so that the next mount of the target component starts fresh instead
+         * of restoring stale data.
+         *
+         * @param channel - The channel key identifying the snapshot to remove.
+         *
+         * @example
+         * ```ts
+         * context.actions.invalidate(Store.Counter({ UserId: 5 }));
+         * context.actions.invalidate(Store.Settings());
+         * ```
          */
-        cache: {
-            /**
-             * Retrieves a value from cache if available and within TTL,
-             * otherwise executes the async function and caches the result.
-             *
-             * Returns `T` synchronously on cache hit, or `Promise<T>` on cache miss.
-             * Using `await` handles both cases uniformly.
-             *
-             * @param operation - The cache operation (plain or channeled).
-             * @param fn - Async function receiving a `cache` callback. Call `cache(value)` to store the value; if not called, nothing is cached.
-             * @returns The cached or freshly fetched value.
-             *
-             * @example
-             * ```ts
-             * const user = await context.actions.cache.put(
-             *   CacheOps.User({ UserId: 5 }),
-             *   async (cache) => {
-             *     const response = await fetchUser(5);
-             *     return response.error ? response : cache(response);
-             *   },
-             * );
-             * ```
-             */
-            put<T>(operation: AnyCacheOperation, fn: (cache: (value: T) => T) => Promise<T>): T | Promise<T>;
-            /**
-             * Reads a cached value for a cache operation without triggering a fetch.
-             * Returns `undefined` if no entry exists or the entry has expired.
-             *
-             * @template T - The expected value type.
-             * @param operation - The cache operation (plain or channeled).
-             * @returns The cached value, or `undefined` if not found or expired.
-             *
-             * @example
-             * ```ts
-             * const user = context.actions.cache.get<User>(CacheStore.User({ UserId: 5 }));
-             * if (user) {
-             *   context.actions.produce(({ model }) => {
-             *     model.user = user;
-             *   });
-             * }
-             * ```
-             */
-            get<T>(operation: AnyCacheOperation): T | undefined;
-            /**
-             * Deletes cache entries for a cache operation.
-             *
-             * With a channeled operation, deletes all entries whose channel
-             * contains the specified keys (partial match). For example,
-             * `cache.delete(CacheOps.User({ UserId: 5 }))` removes entries for
-             * `{ UserId: 5 }`, `{ UserId: 5, Role: "admin" }`, etc.
-             *
-             * With a plain (unchanneled) operation, deletes all entries
-             * for that operation regardless of channel.
-             *
-             * @param operation - The cache operation (plain or channeled).
-             *
-             * @example
-             * ```ts
-             * // Delete specific cache entry (partial channel match)
-             * context.actions.cache.delete(CacheOps.User({ UserId: 5 }));
-             *
-             * // Delete ALL user cache entries
-             * context.actions.cache.delete(CacheOps.User);
-             * ```
-             */
-            delete(operation: AnyCacheOperation): void;
-        };
+        invalidate(channel: Filter): void;
     };
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chizu",
-  "version": "0.2.51",
+  "version": "0.2.53",
   "type": "module",
   "license": "MIT",
   "packageManager": "yarn@1.22.22",
@@ -15,7 +15,7 @@
   },
   "dependencies": {
     "eventemitter3": "^5.0.1",
-    "immertation": "0.1.24"
+    "immertation": "^0.1.25"
   },
   "peerDependencies": {
     "@mobily/ts-belt": "^3.0.0",
@@ -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/cache/index.d.ts

@@ -1,14 +0,0 @@
-import { Props } from './types.ts';
-import * as React from "react";
-export { useCache } from './utils.ts';
-export type { CacheEntry, CacheStore } from './types.ts';
-/**
- * Creates a new cache context for caching async results within action handlers.
- * Automatically included in `<Boundary>`. Only needed directly if you want to
- * isolate a cache context, useful for libraries that want their own cache
- * without interfering with the app's cache.
- *
- * @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

@@ -1,24 +0,0 @@
-import { Filter } from '../../../types/index.ts';
-import type * as React from "react";
-/**
- * A single cache entry with its stored value, expiration timestamp, and
- * original channel for partial-match invalidation.
- */
-export type CacheEntry = {
-    value: unknown;
-    expiresAt: number;
-    channel: Filter | undefined;
-};
-/**
- * The cache store: outer Map keyed by operation symbol, inner Map keyed
- * by serialised channel string.
- *
- * For unchanneled cache operations, the inner key is an empty string "".
- */
-export type CacheStore = Map<symbol, Map<string, CacheEntry>>;
-/**
- * Props for the CacheProvider component.
- */
-export type Props = {
-    children: React.ReactNode;
-};

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

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

package/dist/cache/index.d.ts

@@ -1,29 +0,0 @@
-import { CacheFactory } from '../types/index.ts';
-export { getCacheSymbol, getCacheTtl, isCacheOperation, isChanneledCache, serializeChannel, matchesCacheChannel, } from './utils.ts';
-/**
- * Creates a new cache operation with a TTL (time-to-live) in milliseconds.
- *
- * Cache operations are identifiers used with `context.actions.cache.put()` and
- * `context.actions.cache.delete()` to manage cached async results. They follow the
- * same channel pattern as actions.
- *
- * @template C - The channel type for keyed cache entries (defaults to never).
- * @param ttl - Time-to-live in milliseconds.
- * @returns A typed cache operation object.
- *
- * @example
- * ```ts
- * export class CacheStore {
- *   static User = Cache<{ UserId: number }>(30_000);  // 30s TTL, channeled
- *   static Config = Cache(60_000);                     // 60s TTL, unchanneled
- * }
- *
- * // Channeled usage
- * context.actions.cache.put(CacheStore.User({ UserId: 5 }), () => fetchUser(5));
- *
- * // Deletion (partial channel match)
- * context.actions.cache.delete(CacheStore.User({ UserId: 5 }));
- * context.actions.cache.delete(CacheStore.User); // clears all
- * ```
- */
-export declare const Cache: CacheFactory;

package/dist/cache/utils.d.ts

@@ -1,48 +0,0 @@
-import { Filter } from '../types/index.ts';
-/**
- * Extracts the underlying symbol from a cache operation or channeled cache.
- *
- * @param operation The cache operation to extract the symbol from.
- * @returns The underlying symbol.
- */
-export declare function getCacheSymbol(operation: unknown): symbol;
-/**
- * Extracts the TTL from a cache operation or channeled cache.
- *
- * @param operation The cache operation to extract the TTL from.
- * @returns The TTL in milliseconds.
- */
-export declare function getCacheTtl(operation: unknown): number;
-/**
- * Checks whether a value is a cache operation.
- *
- * @param value The value to check.
- * @returns True if the value is a cache operation.
- */
-export declare function isCacheOperation(value: unknown): boolean;
-/**
- * Checks whether a value is a channeled cache operation.
- *
- * @param value The value to check.
- * @returns True if the value is a channeled cache operation with a channel property.
- */
-export declare function isChanneledCache(value: unknown): boolean;
-/**
- * Serialises a channel object into a deterministic string key for cache lookup.
- * Keys are sorted alphabetically for deterministic output.
- * Returns an empty string for unchanneled operations.
- *
- * @param channel The channel object to serialise.
- * @returns A deterministic string representation of the channel.
- */
-export declare function serializeChannel(channel?: Filter): string;
-/**
- * Checks whether an invalidation channel partially matches a stored channel.
- * Returns true if ALL keys in the invalidation channel exist in the stored
- * channel with matching values.
- *
- * @param invalidateChannel The channel from the invalidation call.
- * @param storedChannel The channel stored with the cache entry.
- * @returns True if the invalidation channel is a subset of the stored channel.
- */
-export declare function matchesCacheChannel(invalidateChannel: Filter, storedChannel: Filter): boolean;