chizu 0.2.21 → 0.2.23

package/README.md

@@ -9,8 +9,9 @@ Strongly typed React framework using generators and efficiently updated views al
 1. [Benefits](#benefits)
 1. [Getting started](#getting-started)
 1. [Handling errors](#handling-errors)
-1. [Distributed events](#distributed-events)
-1. [Module context](#module-context)
+1. [Distributed actions](#distributed-actions)
+1. [Module dispatch](#module-dispatch)
+1. [Associated context](#associated-context)
 
 ## Benefits
 
@@ -32,7 +33,7 @@ Actions are responsible for mutating the state of the view. In the below example
 ```tsx
 export default <Actions<Module>>function Actions(module) {
   return {
-    [Events.Name](name) {
+    [Action.Name](name) {
       return module.actions.produce((draft) => {
         draft.name = name;
       });
@@ -44,19 +45,19 @@ export default <Actions<Module>>function Actions(module) {
 ```tsx
 export default function Profile(props: Props): React.ReactElement {
   return (
-    <Tree<Module> using={{ model, actions, props }}>
+    <Scope<Module> using={{ model, actions, props }}>
       {(module) => (
         <>
           <p>Hey {module.model.name}</p>
 
           <button
-            onClick={() => module.actions.dispatch([Events.Name, randomName()])}
+            onClick={() => module.actions.dispatch([Action.Name, randomName()])}
           >
             Switch profile
           </button>
         </>
       )}
-    </Tree>
+    </Scope>
   );
 }
 ```
@@ -66,7 +67,7 @@ You can perform asynchronous operations in the action which will cause the assoc
 ```tsx
 export default <Actions<Module>>function Actions(module) {
   return {
-    async *[Events.Name]() {
+    async *[Action.Name]() {
       yield module.actions.produce((draft) => {
         draft.name = null;
       });
@@ -84,17 +85,17 @@ export default <Actions<Module>>function Actions(module) {
 ```tsx
 export default function Profile(props: Props): React.ReactElement {
   return (
-    <Tree<Module> using={{ model, actions, props }}>
+    <Scope<Module> using={{ model, actions, props }}>
       {(module) => (
         <>
           <p>Hey {module.model.name}</p>
 
-          <button onClick={() => module.actions.dispatch([Events.Name])}>
+          <button onClick={() => module.actions.dispatch([Action.Name])}>
             Switch profile
           </button>
         </>
       )}
-    </Tree>
+    </Scope>
   );
 }
 ```
@@ -104,7 +105,7 @@ However in the above example where the name is fetched asynchronously, there is
 ```tsx
 export default <Actions<Module>>function Actions(module) {
   return {
-    async *[Events.Name]() {
+    async *[Action.Name]() {
       yield module.actions.produce((draft) => {
         draft.name = module.actions.annotate(null);
       });
@@ -121,7 +122,7 @@ export default <Actions<Module>>function Actions(module) {
 ```tsx
 export default function ProfileView(props: Props): React.ReactElement {
   return (
-    <Tree<Module> using={{ module, actions, props }}>
+    <Scope<Module> using={{ module, actions, props }}>
       {(module) => (
         <>
           <p>Hey {module.model.name}</p>
@@ -130,13 +131,13 @@ export default function ProfileView(props: Props): React.ReactElement {
 
           <button
             disabled={module.validate.name.is(State.Op.Update)}
-            onClick={() => module.actions.dispatch([Events.Name])}
+            onClick={() => module.actions.dispatch([Action.Name])}
           >
             Switch profile
           </button>
         </>
       )}
-    </Tree>
+    </Scope>
   );
 }
 ```
@@ -148,7 +149,7 @@ Most errors are likely to occur in the actions because the views should be free
 ```tsx
 export default <Actions<Module>>function Actions(module) {
   return {
-    *[Events.Name]() {
+    *[Action.Name]() {
       yield module.actions.produce((draft) => {
         draft.name = null;
       });
@@ -165,12 +166,12 @@ export default <Actions<Module>>function Actions(module) {
 
 However in eventualities where an error has not been caught in an action then the `Lifecycle.Error` is the next best thing &ndash; use it to display a toast message and log it your chosen error log service.
 
-Additionally when rendering an error may be thrown which prevents the DOM from updating as you'd expect &ndash; perhaps a side effect has delivered an unexpected data structure. In those cases again `Lifecycle.Error` is your friend. When such an error is thrown the component channel will be switched to `Channel.Error` which you detect using `module.channel.is(Channel.Error)` and switch to an alternative markup that _should_ render, within that you could display a button to attempt recovery &ndash; simply call an action again and update the meta to switch the channel back to `Channel.Default`:
+Additionally when rendering an error may be thrown which prevents the DOM from updating as you'd expect &ndash; perhaps a side effect has delivered an unexpected data structure. In those cases again `Lifecycle.Error` is your friend. When such an error is thrown the component boundary will be switched to `Boundary.Error` which you detect using `module.boundary.is(Boundary.Error)` and switch to an alternative markup that _should_ render, within that you could display a button to attempt recovery &ndash; simply call an action again and update the meta to switch the boundary back to `Boundary.Default`:
 
 ```tsx
 export default <Actions<Module>>function Actions(module) {
   return {
-    *[Events.Recover]() {
+    *[Action.Recover]() {
       yield module.actions.produce((draft) => {
         draft.name = null;
       });
@@ -178,7 +179,7 @@ export default <Actions<Module>>function Actions(module) {
       const name = await fetch(/* ... */);
 
       return module.actions.produce((draft, meta) => {
-        meta.channel = Channel.Default;
+        meta.boundary = Boundary.Default;
         draft.name = name;
       });
     },
@@ -186,34 +187,62 @@ export default <Actions<Module>>function Actions(module) {
 };
 ```
 
-If the component again throws an error after attempting recovery, it will simply switch back to the `Channel.Error` again.
+If the component again throws an error after attempting recovery, it will simply switch back to the `Boundary.Error` again.
 
-## Distributed events
+## Distributed actions
 
 Actions can communicate with other mounted actions using the `DistributedActions` approach. You can configure the enum and union type in the root of your application:
 
 ```ts
-export enum DistributedEvents {
+export enum DistributedAction {
   SignedOut = "distributed/signed-out",
 }
 
-export type DistributedActions = [DistributedEvents.SignedOut];
+export type DistributedActions = [DistributedAction.SignedOut];
 ```
 
-Note that you must prefix the enum name with `distributed` for it to behave as a distributed event, otherwise it'll be considered a module event only. Once you have the distributed events you simply need to augment the module actions union with the `DistributedActions` and use it as you do other actions:
+Note that you must prefix the enum name with `distributed` for it to behave as a distributed event, otherwise it'll be considered a module event only. Once you have the distributed actions you simply need to augment the module actions union with the `DistributedActions` and use it as you do other actions:
 
 ```ts
-export type Actions = DistributedActions | [Events.Task, string]; // etc...
+export type Actions = DistributedActions | [Action.Task, string]; // etc...
 ```
 
-## Module context
+## Module dispatch
 
-In the eventuality that you have a component but don't want associated actions, models, etc&hellip; but want to still fire events either the closest module or a distributed event, you can use the `useModule` hook:
+In the eventuality that you have a component but don't want associated actions, models, etc&hellip; but want to still fire actions either the closest module or a distributed action, you can use the `useScoped` hook:
 
 ```ts
-const module = useModule<Module>();
+const module = useScoped<Module>();
 
 // ...
 
-module.actions.dispatch([Event.Task, "My task that needs to be done."]);
+module.actions.dispatch([Action.Task, "My task that needs to be done."]);
+```
+
+Alternatively you can pass the current module as a prop to your components using the `Scoped` helper:
+
+```ts
+export type Props = {
+  module: Scoped<Module>;
+};
+```
+
+## Associated context
+
+In many cases you'll still want to retrieve contextual values from within actions &ndash; which you can do by using the `module.actions.context` function:
+
+```tsx
+export default <Actions<Module>>function Actions(module) {
+  const context = module.actions.context({
+    name: NameContext
+  });
+
+  return {
+    [Action.Name](name) {
+      return module.actions.produce((draft) => {
+        draft.name = context.name;
+      });
+    },
+  };
+};
 ```

package/dist/broadcast/index.d.ts

@@ -1,4 +1,12 @@
 import { BroadcastContext, Props } from './types.ts';
 import * as React from "react";
 export declare function useBroadcast(): BroadcastContext;
-export declare function BroadcastProvider({ children }: Props): React.ReactNode;
+/**
+ * Note: only needed if you want to create a new broadcast context, useful for
+ * libraries that want to provide their own broadcast context without intefering
+ * with the app's broadcast context.
+ *
+ * @param param0 - { children }: Props
+ * @returns {React.ReactNode}
+ */
+export declare function Broadcaster({ children }: Props): React.ReactNode;

package/dist/broadcast/types.d.ts

@@ -1,7 +1,7 @@
 import { default as EventEmitter } from 'eventemitter3';
 import * as React from "react";
 export type BroadcastContext = {
-    appEmitter: EventEmitter;
+    instance: EventEmitter;
 };
 export type UseBroadcast = BroadcastContext;
 export type Props = {

package/dist/broadcast/utils.d.ts

@@ -1,5 +1,5 @@
 /**
- * Check if the name is a broadcast event.
+ * Check if the name is a broadcast action.
  *
  * @param name {string}
  * @returns {boolean}

package/dist/chizu.js

@@ -1,184 +1,185 @@
 var J = Object.defineProperty;
-var C = (t) => {
+var U = (t) => {
   throw TypeError(t);
 };
 var Q = (t, e, n) => e in t ? J(t, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : t[e] = n;
-var g = (t, e, n) => Q(t, typeof e != "symbol" ? e + "" : e, n), O = (t, e, n) => e.has(t) || C("Cannot " + n);
-var b = (t, e, n) => (O(t, e, "read from private field"), n ? n.call(t) : e.get(t)), x = (t, e, n) => e.has(t) ? C("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(t) : e.set(t, n), R = (t, e, n, r) => (O(t, e, "write to private field"), r ? r.call(t, n) : e.set(t, n), n);
-import { jsx as k } from "react/jsx-runtime";
-import * as i from "react";
-import U from "eventemitter3";
-import { Immer as W, enablePatches as G } from "immer";
-import p from "lodash/get";
-import M from "traverse";
-class $ {
+var E = (t, e, n) => Q(t, typeof e != "symbol" ? e + "" : e, n), _ = (t, e, n) => e.has(t) || U("Cannot " + n);
+var w = (t, e, n) => (_(t, e, "read from private field"), n ? n.call(t) : e.get(t)), x = (t, e, n) => e.has(t) ? U("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(t) : e.set(t, n), R = (t, e, n, r) => (_(t, e, "write to private field"), r ? r.call(t, n) : e.set(t, n), n);
+import { jsx as P } from "react/jsx-runtime";
+import * as u from "react";
+import { useRef as W } from "react";
+import k from "eventemitter3";
+import { Immer as G, enablePatches as K } from "immer";
+import m from "lodash/get";
+import j from "traverse";
+class B {
   constructor(e) {
     this.value = e;
   }
 }
-class K {
+class V {
   static Draft(e) {
-    return new $(e);
+    return new B(e);
   }
 }
-g(K, "Op", {
+E(V, "Op", {
   Add: 1,
   Remove: 2,
   Update: 4,
   Move: 8,
   Replace: 16
 });
-var f = /* @__PURE__ */ ((t) => (t.Mount = "lifecycle/mount", t.Node = "lifecycle/node", t.Derive = "lifecycle/derive", t.Error = "lifecycle/error", t.Unmount = "lifecycle/unmount", t))(f || {}), j = /* @__PURE__ */ ((t) => (t[t.Default = 0] = "Default", t[t.Error = 1] = "Error", t))(j || {});
-function V(t) {
+var f = /* @__PURE__ */ ((t) => (t.Mount = "lifecycle/mount", t.Node = "lifecycle/node", t.Derive = "lifecycle/derive", t.Error = "lifecycle/error", t.Unmount = "lifecycle/unmount", t))(f || {}), M = /* @__PURE__ */ ((t) => (t[t.Default = 0] = "Default", t[t.Error = 1] = "Error", t))(M || {});
+function X(t) {
   return new Promise((e) => setTimeout(e, t));
 }
-function X(t) {
+function Y(t) {
   return t ? !!(t && typeof t != "symbol") : Symbol(`pk.${Date.now()}.${crypto.randomUUID()}`);
 }
-function m(t) {
+function p(t) {
   return JSON.stringify(t);
 }
-const y = Symbol("meta"), wt = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const g = Symbol("meta"), Et = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  hash: m,
-  meta: y,
-  pk: X,
-  sleep: V
+  hash: p,
+  meta: g,
+  pk: Y,
+  sleep: X
 }, Symbol.toStringTag, { value: "Module" }));
-function l(t, e) {
-  const n = i.useRef(null), r = i.useRef(null);
-  return i.useMemo(() => {
-    const o = m(e);
-    if (r.current !== o) {
-      r.current = o;
-      const s = t();
-      return n.current = s, s;
+function d(t, e) {
+  const n = u.useRef(null), r = u.useRef(null);
+  return u.useMemo(() => {
+    const s = p(e);
+    if (r.current !== s) {
+      r.current = s;
+      const o = t();
+      return n.current = o, o;
     }
     return n.current;
   }, e);
 }
-function _(t, e) {
-  const n = i.useRef(null);
-  i.useEffect(() => {
-    const r = m(e);
+function A(t, e) {
+  const n = u.useRef(null);
+  u.useEffect(() => {
+    const r = p(e);
     if (n.current !== r)
       return n.current = r, t();
   }, e);
 }
-const H = i.createContext({
-  appEmitter: new U()
+const H = u.createContext({
+  instance: new k()
 });
 function T() {
-  return i.useContext(H);
+  return u.useContext(H);
 }
-function yt({ children: t }) {
-  const e = l(
+function wt({ children: t }) {
+  const e = d(
     () => ({
-      appEmitter: new U()
+      instance: new k()
     }),
     []
   );
-  return /* @__PURE__ */ k(H.Provider, { value: e, children: t });
+  return /* @__PURE__ */ P(H.Provider, { value: e, children: t });
 }
 const a = {
-  immer: new W(),
+  immer: new G(),
   annotations: Symbol("annotations")
 };
-G();
+K();
 a.immer.setAutoFreeze(!1);
-class P {
+class C {
   constructor(e, n, r = null) {
-    g(this, "process");
+    E(this, "process");
     this.value = e, this.operations = n, this.field = r, this.process = null;
   }
   attach(e) {
     return this.process = e, this;
   }
 }
-function Y(t, e = []) {
-  return new P(t, e);
+function Z(t, e = []) {
+  return new C(t, e);
 }
-class A {
+class O {
   constructor(e, n = e) {
     this.stateless = e, this.stateful = n;
   }
   get validatable() {
-    return z(this.stateful);
+    return $(this.stateful);
   }
 }
-function z(t, e = []) {
+function $(t, e = []) {
   return new Proxy(t, {
     get(n, r) {
       switch (r) {
         case "is":
-          return (o) => {
-            const s = S(t, e);
-            if (!s) return !1;
+          return (s) => {
+            const o = S(t, e);
+            if (!o) return !1;
             const c = new Set(
-              s.flatMap((d) => d.operations)
+              o.flatMap((l) => l.operations)
             );
             return !!(Array.from(c).reduce(
-              (d, h) => d | (h ?? 0),
+              (l, h) => l | (h ?? 0),
               0
-            ) & o);
+            ) & s);
           };
         case "pending":
           return () => !!S(t, e);
         case "draft":
           return () => {
-            const o = S(t, e);
-            if (!o) return p(t, e);
-            const s = o.flatMap((c) => c.operations).find((c) => c instanceof $);
-            return s ? s.value : p(t, e);
+            const s = S(t, e);
+            if (!s) return m(t, e);
+            const o = s.flatMap((c) => c.operations).find((c) => c instanceof B);
+            return o ? o.value : m(t, e);
           };
       }
-      return z(t, [...e, String(r)]);
+      return $(t, [...e, String(r)]);
     }
   });
 }
 function S(t, e) {
-  const r = typeof p(t, e) == "object" ? e : e.slice(0, -1), o = r.length === 0 ? t : p(t, r), s = (o == null ? void 0 : o[a.annotations]) ?? [];
-  return s.length > 0 ? s : null;
+  const r = typeof m(t, e) == "object" ? e : e.slice(0, -1), s = r.length === 0 ? t : m(t, r), o = (s == null ? void 0 : s[a.annotations]) ?? [];
+  return o.length > 0 ? o : null;
 }
-function q(t, e, n) {
+function z(t, e, n) {
   function r(c) {
-    return M(c).forEach(function() {
+    return j(c).forEach(function() {
       if (this.key === a.annotations) {
         this.block();
         return;
       }
-      this.node instanceof P && this.update(this.node.value);
+      this.node instanceof C && this.update(this.node.value);
     });
   }
-  function o(c) {
-    return M(c).forEach(function() {
+  function s(c) {
+    return j(c).forEach(function() {
       if (this.key === a.annotations) {
         this.block();
         return;
       }
-      if (this.node instanceof P) {
-        const u = typeof this.node.value == "object", d = [
-          ...u ? this.path : this.path.slice(0, -1),
+      if (this.node instanceof C) {
+        const i = typeof this.node.value == "object", l = [
+          ...i ? this.path : this.path.slice(0, -1),
           a.annotations
-        ], h = p(t.stateful, d) ?? [], w = this.node.attach(e);
-        u ? this.update(
+        ], h = m(t.stateful, l) ?? [], b = this.node.attach(e);
+        i ? this.update(
           {
             ...this.node.value,
-            [a.annotations]: [w, ...h]
+            [a.annotations]: [b, ...h]
           },
           !0
-        ) : (this.parent && (this.parent.node[a.annotations] = [w, ...h]), this.update(this.node.value, !0));
+        ) : (this.parent && (this.parent.node[a.annotations] = [b, ...h]), this.update(this.node.value, !0));
       }
     });
   }
-  const s = (c) => n(c, c[y]);
-  return new A(
-    r(a.immer.produce(t.stateless, s)),
-    o(a.immer.produce(t.stateful, s))
+  const o = (c) => n(c, c[g]);
+  return new O(
+    r(a.immer.produce(t.stateless, o)),
+    s(a.immer.produce(t.stateful, o))
   );
 }
 function D(t, e) {
-  const n = M(t.stateful).forEach(function() {
+  const n = j(t.stateful).forEach(function() {
     if (this.key === a.annotations) {
       this.block();
       return;
@@ -189,17 +190,17 @@ function D(t, e) {
         {
           ...this.node,
           [a.annotations]: r.filter(
-            (o) => o.process !== e
+            (s) => s.process !== e
           )
         },
         !0
       );
     }
   });
-  return new A(t.stateless, n);
+  return new O(t.stateless, n);
 }
-function Z(t) {
-  return l(
+function L(t) {
+  return d(
     () => ({
       controller: {
         get model() {
@@ -208,15 +209,27 @@ function Z(t) {
         queue: [],
         actions: {
           annotate(e, n) {
-            return Y(e, n);
+            return Z(e, n);
           },
           produce(e) {
-            return (n, r) => q(n, r, e);
+            return (n, r) => z(n, r, e);
           },
           dispatch([e, ...n]) {
             if (e == null) return Promise.reject();
             const r = Promise.withResolvers();
             return t.dispatchers.dispatch(e, n, r), r.promise;
+          },
+          context(e) {
+            const n = Object.keys(e);
+            return t.context.use.current = e, t.context.update(), n.reduce(
+              (r, s) => ({
+                ...r,
+                get [s]() {
+                  return t.context.registry.current[s];
+                }
+              }),
+              {}
+            );
           }
         }
       },
@@ -227,9 +240,9 @@ function Z(t) {
         get validate() {
           return t.model.current.validatable;
         },
-        channel: {
+        boundary: {
           is(e) {
-            return t.model.current.stateless[y].channel === e;
+            return t.model.current.stateless[g].boundary === e;
           }
         },
         actions: {
@@ -244,171 +257,181 @@ function Z(t) {
     []
   );
 }
-function L(t) {
-  return l(() => {
-    const e = t.options.using.actions(t.actions.controller);
-    return Object.entries(e).forEach(([r, o]) => t.dispatchers.attach(r, o)), e;
+function tt(t) {
+  const e = W(null);
+  return e.current == null && (e.current = t.options.using.actions(t.actions.controller)), d(() => {
+    if (e.current)
+      return Object.entries(e.current).forEach(([r, s]) => t.dispatchers.attach(r, s)), e.current;
   }, []);
 }
 function N(t) {
   return t.startsWith("distributed");
 }
-function gt(t) {
-  return t instanceof B;
+function xt(t) {
+  return t instanceof I;
 }
-function bt(t) {
-  return t instanceof B;
+function q(t) {
+  return t instanceof I || t instanceof Error ? t : new Error("Unknown error", { cause: t });
 }
-function I(t) {
-  return t instanceof B || t instanceof Error ? t : new Error("Unknown error", { cause: t });
-}
-var v, E;
-class B extends Error {
+var v, y;
+class I extends Error {
   constructor(n, r = null) {
     super(String(r));
     x(this, v);
-    x(this, E);
-    R(this, v, n), R(this, E, r);
+    x(this, y);
+    R(this, v, n), R(this, y, r);
   }
   get type() {
-    return b(this, v);
+    return w(this, v);
   }
   get message() {
-    return b(this, E) || "";
+    return w(this, y) || "";
   }
 }
-v = new WeakMap(), E = new WeakMap();
-function tt({
+v = new WeakMap(), y = new WeakMap();
+function et({
   children: t
 }) {
   return t();
 }
-function et(t) {
-  return (e, n) => async (r = Promise.withResolvers(), o) => {
+function nt(t) {
+  return (e, n) => async (r = Promise.withResolvers(), s) => {
     if (typeof n != "function") return;
-    const s = Symbol("process"), c = n(...o);
+    const o = Symbol("process"), c = n(...s);
     try {
       if (c == null) return;
       if (typeof c == "function") {
-        const u = c(t.model.current, s);
-        t.model.current = D(u, s), t.update.rerender(), r.resolve();
+        const i = c(t.model.current, o);
+        t.model.current = D(i, o), t.update.rerender(), r.resolve();
         return;
       }
       for (; ; ) {
-        const { value: u, done: d } = await c.next();
-        if (d) {
-          const w = u(t.model.current, s);
-          t.model.current = D(w, s), t.update.rerender();
+        const { value: i, done: l } = await c.next();
+        if (l) {
+          const b = i(t.model.current, o);
+          t.model.current = D(b, o), t.update.rerender();
           break;
         }
-        const h = u;
-        t.model.current = h(t.model.current, s), t.update.rerender(), r.resolve();
+        const h = i;
+        t.model.current = h(t.model.current, o), t.update.rerender(), r.resolve();
       }
-    } catch (u) {
-      D(t.model.current, s), t.update.rerender(), t.unicast.emit(f.Error, r, [I(u)]);
+    } catch (i) {
+      D(t.model.current, o), t.update.rerender(), t.unicast.emit(f.Error, r, [q(i)]);
     }
   };
 }
-function nt(t) {
-  const e = T(), n = l(() => new U(), []), r = et({ ...t, unicast: n });
-  return l(() => ({
-    attach(o, s) {
-      const c = String(o);
-      N(c) ? e.appEmitter.on(c, r(o, s)) : n.on(c, r(o, s));
+function rt(t) {
+  const e = T(), n = d(() => new k(), []), r = nt({ ...t, unicast: n });
+  return d(() => ({
+    attach(s, o) {
+      const c = String(s);
+      N(c) ? e.instance.on(c, r(s, o)) : n.on(c, r(s, o));
     },
-    dispatch(o, s, c) {
-      const u = String(o);
-      N(u) ? e.appEmitter.emit(u, c, s) : n.emit(u, c, s);
+    dispatch(s, o, c) {
+      const i = String(s);
+      N(i) ? e.instance.emit(i, c, o) : n.emit(i, c, o);
     }
   }), []);
 }
-function rt() {
-  const t = i.useRef(null);
-  return l(() => ({ customElement: t }), []);
+function st() {
+  const t = u.useRef(null);
+  return d(() => ({ customElement: t }), []);
 }
-function st(t) {
-  _(() => {
+function ot(t) {
+  A(() => {
     t.dispatchers.dispatch(f.Derive, []);
-  }, [t.options.using.props]), _(() => (t.dispatchers.dispatch(f.Mount, []), t.dispatchers.dispatch(f.Node, [
+  }, [t.options.using.props]), A(() => (t.dispatchers.dispatch(f.Mount, []), t.dispatchers.dispatch(f.Node, [
     t.elements.customElement.current
   ]), () => t.dispatchers.dispatch(f.Unmount, [])), []);
 }
-function ot(t) {
-  const e = l(() => ({ ...t.options.using.model ?? {}, [y]: { channel: j.Default } }), []);
-  return i.useRef(new A(e, e));
-}
-function ct() {
-  return i.useRef(/* @__PURE__ */ new Set());
+function ct(t) {
+  const e = d(() => ({ ...t.options.using.model ?? {}, [g]: { boundary: M.Default } }), []);
+  return u.useRef(new O(e, e));
 }
 function ut() {
-  const [t, e] = i.useReducer((n) => n + 1, 0);
-  return l(() => ({ hash: t, rerender: e }), [t]);
+  return u.useRef(/* @__PURE__ */ new Set());
+}
+function it() {
+  const [t, e] = u.useReducer((n) => n + 1, 0);
+  return d(() => ({ hash: t, rerender: e }), [t]);
 }
-const it = {
+const at = {
   elementName: "x-chizu"
-}, F = i.createContext(
+}, F = u.createContext(
   null
 );
-function xt() {
-  const t = i.useContext(F);
-  if (!t) throw new Error("useModule must be used within a module.");
+function Rt() {
+  const t = u.useContext(F);
+  if (!t)
+    throw new Error("useScoped is not being used within a scoped module.");
   return t;
 }
-class at extends i.Component {
+class lt extends u.Component {
   constructor(e) {
     super(e), this.state = { error: null };
   }
   componentDidCatch(e) {
-    const n = Symbol("process"), r = q(this.props.model.current, n, (o, s) => {
-      s.channel = j.Error;
+    const n = Symbol("process"), r = z(this.props.model.current, n, (s, o) => {
+      o.boundary = M.Error;
     });
-    this.props.model.current = r, this.props.update.rerender(), this.props.dispatchers.dispatch(f.Error, [I(e)]);
+    this.props.model.current = r, this.props.update.rerender(), this.props.dispatchers.dispatch(f.Error, [q(e)]);
   }
   render() {
-    return /* @__PURE__ */ k(tt, { children: this.props.children });
+    return /* @__PURE__ */ P(et, { children: this.props.children });
   }
 }
-function lt({
+function dt() {
+  const t = u.useRef({}), e = u.useRef({});
+  function n() {
+    e.current = Object.fromEntries(
+      Object.entries(t.current).map(([r, s]) => [r, u.use(s)])
+    );
+  }
+  return n(), d(() => ({ use: t, registry: e, update: n }), []);
+}
+function ft({
   options: t
 }) {
-  const e = ut(), n = ct(), r = rt(), o = T(), s = ot({ options: t }), c = nt({
-    broadcast: o,
+  const e = it(), n = ut(), r = st(), s = T(), o = dt(), c = ct({ options: t }), i = rt({
+    broadcast: s,
     options: t,
     update: e,
-    model: s,
+    model: c,
     queue: n
-  }), u = Z({ model: s, dispatchers: c });
-  return L({ options: t, dispatchers: c, actions: u }), st({ options: t, dispatchers: c, elements: r }), l(() => i.createElement(at, {
-    model: s,
-    dispatchers: c,
+  }), l = L({
+    model: c,
+    dispatchers: i,
+    context: o
+  });
+  return tt({ options: t, dispatchers: i, actions: l }), ot({ options: t, dispatchers: i, elements: r }), d(() => u.createElement(lt, {
+    model: c,
+    dispatchers: i,
     update: e,
-    module: u.view,
+    module: l.view,
     children() {
-      return i.createElement(F.Provider, {
-        value: u.view,
+      return u.createElement(F.Provider, {
+        value: l.view,
         // eslint-disable-next-line react/no-children-prop
-        children: i.createElement(it.elementName, {
+        children: u.createElement(at.elementName, {
           ref: r.customElement,
           style: { display: "contents" },
-          children: t.children(u.view)
+          children: t.children(l.view)
         })
       });
     }
-  }), [e.hash, m(t.using.props)]);
+  }), [e.hash, p(t.using.props), p(o.registry)]);
 }
-function dt(t) {
-  return /* @__PURE__ */ k(lt, { options: t });
+function St(t) {
+  return /* @__PURE__ */ P(ft, { options: t });
 }
-const Rt = i.memo(dt, (t, e) => m(t) === m(e));
 export {
-  yt as BroadcastProvider,
-  j as Channel,
+  M as Boundary,
+  wt as Broadcaster,
   f as Lifecycle,
-  K as State,
-  Rt as Tree,
-  B as UserError,
-  gt as isActionError,
-  bt as isUserError,
-  xt as useModule,
-  wt as utils
+  St as Scope,
+  V as State,
+  I as TypedError,
+  xt as isTypedError,
+  Rt as useScoped,
+  Et as utils
 };

package/dist/chizu.umd.cjs

@@ -1 +1 @@
-(function(s,i){typeof exports=="object"&&typeof module<"u"?i(exports,require("react/jsx-runtime"),require("react"),require("eventemitter3"),require("immer"),require("lodash/get"),require("traverse")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react","eventemitter3","immer","lodash/get","traverse"],i):(s=typeof globalThis<"u"?globalThis:s||self,i(s.Chizu={},s.jsxRuntime,s.React,s.EventEmitter3,s.Immer,s.get,s.Traverse))})(this,function(s,i,d,v,q,w,D){"use strict";var Ee=Object.defineProperty;var W=s=>{throw TypeError(s)};var we=(s,i,d)=>i in s?Ee(s,i,{enumerable:!0,configurable:!0,writable:!0,value:d}):s[i]=d;var k=(s,i,d)=>we(s,typeof i!="symbol"?i+"":i,d),G=(s,i,d)=>i.has(s)||W("Cannot "+d);var _=(s,i,d)=>(G(s,i,"read from private field"),d?d.call(s):i.get(s)),C=(s,i,d)=>i.has(s)?W("Cannot add the same private member more than once"):i instanceof WeakSet?i.add(s):i.set(s,d),T=(s,i,d,v)=>(G(s,i,"write to private field"),v?v.call(s,d):i.set(s,d),d);var b,g;function K(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const n in e)if(n!=="default"){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 l=K(d);class A{constructor(t){this.value=t}}class B{static Draft(t){return new A(t)}}k(B,"Op",{Add:1,Remove:2,Update:4,Move:8,Replace:16});var m=(e=>(e.Mount="lifecycle/mount",e.Node="lifecycle/node",e.Derive="lifecycle/derive",e.Error="lifecycle/error",e.Unmount="lifecycle/unmount",e))(m||{}),S=(e=>(e[e.Default=0]="Default",e[e.Error=1]="Error",e))(S||{});function V(e){return new Promise(t=>setTimeout(t,e))}function X(e){return e?!!(e&&typeof e!="symbol"):Symbol(`pk.${Date.now()}.${crypto.randomUUID()}`)}function y(e){return JSON.stringify(e)}const j=Symbol("meta"),Y=Object.freeze(Object.defineProperty({__proto__:null,hash:y,meta:j,pk:X,sleep:V},Symbol.toStringTag,{value:"Module"}));function h(e,t){const n=l.useRef(null),r=l.useRef(null);return l.useMemo(()=>{const c=y(t);if(r.current!==c){r.current=c;const o=e();return n.current=o,o}return n.current},t)}function N(e,t){const n=l.useRef(null);l.useEffect(()=>{const r=y(t);if(n.current!==r)return n.current=r,e()},t)}const z=l.createContext({appEmitter:new v});function $(){return l.useContext(z)}function Z({children:e}){const t=h(()=>({appEmitter:new v}),[]);return i.jsx(z.Provider,{value:t,children:e})}const f={immer:new q.Immer,annotations:Symbol("annotations")};q.enablePatches(),f.immer.setAutoFreeze(!1);class R{constructor(t,n,r=null){k(this,"process");this.value=t,this.operations=n,this.field=r,this.process=null}attach(t){return this.process=t,this}}function L(e,t=[]){return new R(e,t)}class O{constructor(t,n=t){this.stateless=t,this.stateful=n}get validatable(){return H(this.stateful)}}function H(e,t=[]){return new Proxy(e,{get(n,r){switch(r){case"is":return c=>{const o=x(e,t);if(!o)return!1;const u=new Set(o.flatMap(p=>p.operations));return!!(Array.from(u).reduce((p,E)=>p|(E??0),0)&c)};case"pending":return()=>!!x(e,t);case"draft":return()=>{const c=x(e,t);if(!c)return w(e,t);const o=c.flatMap(u=>u.operations).find(u=>u instanceof A);return o?o.value:w(e,t)}}return H(e,[...t,String(r)])}})}function x(e,t){const r=typeof w(e,t)=="object"?t:t.slice(0,-1),c=r.length===0?e:w(e,r),o=(c==null?void 0:c[f.annotations])??[];return o.length>0?o:null}function I(e,t,n){function r(u){return D(u).forEach(function(){if(this.key===f.annotations){this.block();return}this.node instanceof R&&this.update(this.node.value)})}function c(u){return D(u).forEach(function(){if(this.key===f.annotations){this.block();return}if(this.node instanceof R){const a=typeof this.node.value=="object",p=[...a?this.path:this.path.slice(0,-1),f.annotations],E=w(e.stateful,p)??[],M=this.node.attach(t);a?this.update({...this.node.value,[f.annotations]:[M,...E]},!0):(this.parent&&(this.parent.node[f.annotations]=[M,...E]),this.update(this.node.value,!0))}})}const o=u=>n(u,u[j]);return new O(r(f.immer.produce(e.stateless,o)),c(f.immer.produce(e.stateful,o)))}function U(e,t){const n=D(e.stateful).forEach(function(){if(this.key===f.annotations){this.block();return}if(this.node&&this.node[f.annotations]){const r=this.node[f.annotations];this.update({...this.node,[f.annotations]:r.filter(c=>c.process!==t)},!0)}});return new O(e.stateless,n)}function ee(e){return h(()=>({controller:{get model(){return e.model.current.stateful},queue:[],actions:{annotate(t,n){return L(t,n)},produce(t){return(n,r)=>I(n,r,t)},dispatch([t,...n]){if(t==null)return Promise.reject();const r=Promise.withResolvers();return e.dispatchers.dispatch(t,n,r),r.promise}}},view:{get model(){return e.model.current.stateless},get validate(){return e.model.current.validatable},channel:{is(t){return e.model.current.stateless[j].channel===t}},actions:{dispatch([t,...n]){if(t==null)return Promise.reject();const r=Promise.withResolvers();return e.dispatchers.dispatch(t,n,r),r.promise}}}}),[])}function te(e){return h(()=>{const t=e.options.using.actions(e.actions.controller);return Object.entries(t).forEach(([r,c])=>e.dispatchers.attach(r,c)),t},[])}function F(e){return e.startsWith("distributed")}function ne(e){return e instanceof P}function re(e){return e instanceof P}function J(e){return e instanceof P||e instanceof Error?e:new Error("Unknown error",{cause:e})}class P extends Error{constructor(n,r=null){super(String(r));C(this,b);C(this,g);T(this,b,n),T(this,g,r)}get type(){return _(this,b)}get message(){return _(this,g)||""}}b=new WeakMap,g=new WeakMap;function se({children:e}){return e()}function oe(e){return(t,n)=>async(r=Promise.withResolvers(),c)=>{if(typeof n!="function")return;const o=Symbol("process"),u=n(...c);try{if(u==null)return;if(typeof u=="function"){const a=u(e.model.current,o);e.model.current=U(a,o),e.update.rerender(),r.resolve();return}for(;;){const{value:a,done:p}=await u.next();if(p){const M=a(e.model.current,o);e.model.current=U(M,o),e.update.rerender();break}const E=a;e.model.current=E(e.model.current,o),e.update.rerender(),r.resolve()}}catch(a){U(e.model.current,o),e.update.rerender(),e.unicast.emit(m.Error,r,[J(a)])}}}function ce(e){const t=$(),n=h(()=>new v,[]),r=oe({...e,unicast:n});return h(()=>({attach(c,o){const u=String(c);F(u)?t.appEmitter.on(u,r(c,o)):n.on(u,r(c,o))},dispatch(c,o,u){const a=String(c);F(a)?t.appEmitter.emit(a,u,o):n.emit(a,u,o)}}),[])}function ue(){const e=l.useRef(null);return h(()=>({customElement:e}),[])}function ie(e){N(()=>{e.dispatchers.dispatch(m.Derive,[])},[e.options.using.props]),N(()=>(e.dispatchers.dispatch(m.Mount,[]),e.dispatchers.dispatch(m.Node,[e.elements.customElement.current]),()=>e.dispatchers.dispatch(m.Unmount,[])),[])}function ae(e){const t=h(()=>({...e.options.using.model??{},[j]:{channel:S.Default}}),[]);return l.useRef(new O(t,t))}function le(){return l.useRef(new Set)}function de(){const[e,t]=l.useReducer(n=>n+1,0);return h(()=>({hash:e,rerender:t}),[e])}const fe={elementName:"x-chizu"},Q=l.createContext(null);function he(){const e=l.useContext(Q);if(!e)throw new Error("useModule must be used within a module.");return e}class me extends l.Component{constructor(t){super(t),this.state={error:null}}componentDidCatch(t){const n=Symbol("process"),r=I(this.props.model.current,n,(c,o)=>{o.channel=S.Error});this.props.model.current=r,this.props.update.rerender(),this.props.dispatchers.dispatch(m.Error,[J(t)])}render(){return i.jsx(se,{children:this.props.children})}}function pe({options:e}){const t=de(),n=le(),r=ue(),c=$(),o=ae({options:e}),u=ce({broadcast:c,options:e,update:t,model:o,queue:n}),a=ee({model:o,dispatchers:u});return te({options:e,dispatchers:u,actions:a}),ie({options:e,dispatchers:u,elements:r}),h(()=>l.createElement(me,{model:o,dispatchers:u,update:t,module:a.view,children(){return l.createElement(Q.Provider,{value:a.view,children:l.createElement(fe.elementName,{ref:r.customElement,style:{display:"contents"},children:e.children(a.view)})})}}),[t.hash,y(e.using.props)])}function ve(e){return i.jsx(pe,{options:e})}const ye=l.memo(ve,(e,t)=>y(e)===y(t));s.BroadcastProvider=Z,s.Channel=S,s.Lifecycle=m,s.State=B,s.Tree=ye,s.UserError=P,s.isActionError=ne,s.isUserError=re,s.useModule=he,s.utils=Y,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})});
+(function(s,u){typeof exports=="object"&&typeof module<"u"?u(exports,require("react/jsx-runtime"),require("react"),require("eventemitter3"),require("immer"),require("lodash/get"),require("traverse")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react","eventemitter3","immer","lodash/get","traverse"],u):(s=typeof globalThis<"u"?globalThis:s||self,u(s.Chizu={},s.jsxRuntime,s.React,s.EventEmitter3,s.Immer,s.get,s.Traverse))})(this,function(s,u,d,y,U,b,O){"use strict";var ve=Object.defineProperty;var W=s=>{throw TypeError(s)};var be=(s,u,d)=>u in s?ve(s,u,{enumerable:!0,configurable:!0,writable:!0,value:d}):s[u]=d;var k=(s,u,d)=>be(s,typeof u!="symbol"?u+"":u,d),G=(s,u,d)=>u.has(s)||W("Cannot "+d);var T=(s,u,d)=>(G(s,u,"read from private field"),d?d.call(s):u.get(s)),_=(s,u,d)=>u.has(s)?W("Cannot add the same private member more than once"):u instanceof WeakSet?u.add(s):u.set(s,d),q=(s,u,d,y)=>(G(s,u,"write to private field"),y?y.call(s,d):u.set(s,d),d);var g,E;function K(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const n in e)if(n!=="default"){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 a=K(d);class A{constructor(t){this.value=t}}class B{static Draft(t){return new A(t)}}k(B,"Op",{Add:1,Remove:2,Update:4,Move:8,Replace:16});var p=(e=>(e.Mount="lifecycle/mount",e.Node="lifecycle/node",e.Derive="lifecycle/derive",e.Error="lifecycle/error",e.Unmount="lifecycle/unmount",e))(p||{}),S=(e=>(e[e.Default=0]="Default",e[e.Error=1]="Error",e))(S||{});function V(e){return new Promise(t=>setTimeout(t,e))}function X(e){return e?!!(e&&typeof e!="symbol"):Symbol(`pk.${Date.now()}.${crypto.randomUUID()}`)}function w(e){return JSON.stringify(e)}const j=Symbol("meta"),Y=Object.freeze(Object.defineProperty({__proto__:null,hash:w,meta:j,pk:X,sleep:V},Symbol.toStringTag,{value:"Module"}));function m(e,t){const n=a.useRef(null),r=a.useRef(null);return a.useMemo(()=>{const o=w(t);if(r.current!==o){r.current=o;const c=e();return n.current=c,c}return n.current},t)}function N(e,t){const n=a.useRef(null);a.useEffect(()=>{const r=w(t);if(n.current!==r)return n.current=r,e()},t)}const z=a.createContext({instance:new y});function H(){return a.useContext(z)}function Z({children:e}){const t=m(()=>({instance:new y}),[]);return u.jsx(z.Provider,{value:t,children:e})}const f={immer:new U.Immer,annotations:Symbol("annotations")};U.enablePatches(),f.immer.setAutoFreeze(!1);class R{constructor(t,n,r=null){k(this,"process");this.value=t,this.operations=n,this.field=r,this.process=null}attach(t){return this.process=t,this}}function L(e,t=[]){return new R(e,t)}class D{constructor(t,n=t){this.stateless=t,this.stateful=n}get validatable(){return $(this.stateful)}}function $(e,t=[]){return new Proxy(e,{get(n,r){switch(r){case"is":return o=>{const c=P(e,t);if(!c)return!1;const i=new Set(c.flatMap(h=>h.operations));return!!(Array.from(i).reduce((h,v)=>h|(v??0),0)&o)};case"pending":return()=>!!P(e,t);case"draft":return()=>{const o=P(e,t);if(!o)return b(e,t);const c=o.flatMap(i=>i.operations).find(i=>i instanceof A);return c?c.value:b(e,t)}}return $(e,[...t,String(r)])}})}function P(e,t){const r=typeof b(e,t)=="object"?t:t.slice(0,-1),o=r.length===0?e:b(e,r),c=(o==null?void 0:o[f.annotations])??[];return c.length>0?c:null}function I(e,t,n){function r(i){return O(i).forEach(function(){if(this.key===f.annotations){this.block();return}this.node instanceof R&&this.update(this.node.value)})}function o(i){return O(i).forEach(function(){if(this.key===f.annotations){this.block();return}if(this.node instanceof R){const l=typeof this.node.value=="object",h=[...l?this.path:this.path.slice(0,-1),f.annotations],v=b(e.stateful,h)??[],x=this.node.attach(t);l?this.update({...this.node.value,[f.annotations]:[x,...v]},!0):(this.parent&&(this.parent.node[f.annotations]=[x,...v]),this.update(this.node.value,!0))}})}const c=i=>n(i,i[j]);return new D(r(f.immer.produce(e.stateless,c)),o(f.immer.produce(e.stateful,c)))}function C(e,t){const n=O(e.stateful).forEach(function(){if(this.key===f.annotations){this.block();return}if(this.node&&this.node[f.annotations]){const r=this.node[f.annotations];this.update({...this.node,[f.annotations]:r.filter(o=>o.process!==t)},!0)}});return new D(e.stateless,n)}function ee(e){return m(()=>({controller:{get model(){return e.model.current.stateful},queue:[],actions:{annotate(t,n){return L(t,n)},produce(t){return(n,r)=>I(n,r,t)},dispatch([t,...n]){if(t==null)return Promise.reject();const r=Promise.withResolvers();return e.dispatchers.dispatch(t,n,r),r.promise},context(t){const n=Object.keys(t);return e.context.use.current=t,e.context.update(),n.reduce((r,o)=>({...r,get[o](){return e.context.registry.current[o]}}),{})}}},view:{get model(){return e.model.current.stateless},get validate(){return e.model.current.validatable},boundary:{is(t){return e.model.current.stateless[j].boundary===t}},actions:{dispatch([t,...n]){if(t==null)return Promise.reject();const r=Promise.withResolvers();return e.dispatchers.dispatch(t,n,r),r.promise}}}}),[])}function te(e){const t=d.useRef(null);return t.current==null&&(t.current=e.options.using.actions(e.actions.controller)),m(()=>{if(t.current)return Object.entries(t.current).forEach(([r,o])=>e.dispatchers.attach(r,o)),t.current},[])}function F(e){return e.startsWith("distributed")}function ne(e){return e instanceof M}function J(e){return e instanceof M||e instanceof Error?e:new Error("Unknown error",{cause:e})}class M extends Error{constructor(n,r=null){super(String(r));_(this,g);_(this,E);q(this,g,n),q(this,E,r)}get type(){return T(this,g)}get message(){return T(this,E)||""}}g=new WeakMap,E=new WeakMap;function re({children:e}){return e()}function se(e){return(t,n)=>async(r=Promise.withResolvers(),o)=>{if(typeof n!="function")return;const c=Symbol("process"),i=n(...o);try{if(i==null)return;if(typeof i=="function"){const l=i(e.model.current,c);e.model.current=C(l,c),e.update.rerender(),r.resolve();return}for(;;){const{value:l,done:h}=await i.next();if(h){const x=l(e.model.current,c);e.model.current=C(x,c),e.update.rerender();break}const v=l;e.model.current=v(e.model.current,c),e.update.rerender(),r.resolve()}}catch(l){C(e.model.current,c),e.update.rerender(),e.unicast.emit(p.Error,r,[J(l)])}}}function oe(e){const t=H(),n=m(()=>new y,[]),r=se({...e,unicast:n});return m(()=>({attach(o,c){const i=String(o);F(i)?t.instance.on(i,r(o,c)):n.on(i,r(o,c))},dispatch(o,c,i){const l=String(o);F(l)?t.instance.emit(l,i,c):n.emit(l,i,c)}}),[])}function ce(){const e=a.useRef(null);return m(()=>({customElement:e}),[])}function ue(e){N(()=>{e.dispatchers.dispatch(p.Derive,[])},[e.options.using.props]),N(()=>(e.dispatchers.dispatch(p.Mount,[]),e.dispatchers.dispatch(p.Node,[e.elements.customElement.current]),()=>e.dispatchers.dispatch(p.Unmount,[])),[])}function ie(e){const t=m(()=>({...e.options.using.model??{},[j]:{boundary:S.Default}}),[]);return a.useRef(new D(t,t))}function ae(){return a.useRef(new Set)}function le(){const[e,t]=a.useReducer(n=>n+1,0);return m(()=>({hash:e,rerender:t}),[e])}const de={elementName:"x-chizu"},Q=a.createContext(null);function fe(){const e=a.useContext(Q);if(!e)throw new Error("useScoped is not being used within a scoped module.");return e}class he extends a.Component{constructor(t){super(t),this.state={error:null}}componentDidCatch(t){const n=Symbol("process"),r=I(this.props.model.current,n,(o,c)=>{c.boundary=S.Error});this.props.model.current=r,this.props.update.rerender(),this.props.dispatchers.dispatch(p.Error,[J(t)])}render(){return u.jsx(re,{children:this.props.children})}}function me(){const e=a.useRef({}),t=a.useRef({});function n(){t.current=Object.fromEntries(Object.entries(e.current).map(([r,o])=>[r,a.use(o)]))}return n(),m(()=>({use:e,registry:t,update:n}),[])}function pe({options:e}){const t=le(),n=ae(),r=ce(),o=H(),c=me(),i=ie({options:e}),l=oe({broadcast:o,options:e,update:t,model:i,queue:n}),h=ee({model:i,dispatchers:l,context:c});return te({options:e,dispatchers:l,actions:h}),ue({options:e,dispatchers:l,elements:r}),m(()=>a.createElement(he,{model:i,dispatchers:l,update:t,module:h.view,children(){return a.createElement(Q.Provider,{value:h.view,children:a.createElement(de.elementName,{ref:r.customElement,style:{display:"contents"},children:e.children(h.view)})})}}),[t.hash,w(e.using.props),w(c.registry)])}function ye(e){return u.jsx(pe,{options:e})}s.Boundary=S,s.Broadcaster=Z,s.Lifecycle=p,s.Scope=ye,s.State=B,s.TypedError=M,s.isTypedError=ne,s.useScoped=fe,s.utils=Y,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})});

package/dist/context/index.d.ts

@@ -0,0 +1,7 @@
+import { Context } from '../types/index.ts';
+import * as React from "react";
+export default function useContext<C extends Context>(): {
+    use: React.RefObject<import('../types/index.ts').Props>;
+    registry: React.RefObject<import('../types/index.ts').Props>;
+    update: () => void;
+};

package/dist/context/types.d.ts

@@ -0,0 +1,2 @@
+import { default as useContext } from './index.ts';
+export type UseContext = ReturnType<typeof useContext>;

package/dist/controller/types.d.ts

@@ -1,11 +1,12 @@
-import { UserError } from '../errors/utils.ts';
+import { TypedError } from '../errors/utils.ts';
 import { Models } from '../module/renderer/model/utils.ts';
 import { Head } from '../module/renderer/types.ts';
-import { Actions, Draft, Lifecycle, Meta, ModuleDefinition, Op, Queue } from '../types/index.ts';
+import { Actions, Context, Draft, Lifecycle, Meta, ModuleDefinition, Op, Queue } from '../types/index.ts';
 export type ControllerActions<M extends ModuleDefinition> = {
     annotate<T>(value: T, operations?: (Op | Draft<T>)[]): T;
     produce(ƒ: (model: M["Model"], meta: Meta) => void): (models: Models<M["Model"]>, process: symbol) => Models<M["Model"]>;
     dispatch(action: M["Actions"]): Promise<void>;
+    context<C extends Context>(context: C): C;
 };
 export type ControllerArgs<M extends ModuleDefinition> = Readonly<{
     model: Readonly<M["Model"]>;
@@ -22,7 +23,7 @@ export type ControllerInstance<M extends ModuleDefinition> = {
     [Lifecycle.Mount]?(): ActionGenerator<M>;
     [Lifecycle.Derive]?(): ActionGenerator<M>;
     [Lifecycle.Node]?(tree: HTMLElement): ActionGenerator<M>;
-    [Lifecycle.Error]?(error: Error | UserError): ActionGenerator<M>;
+    [Lifecycle.Error]?(error: Error | TypedError): ActionGenerator<M>;
     [Lifecycle.Unmount]?(): ActionGenerator<M>;
 } & Partial<ActionEvents<M>>;
 type Payload<A extends Actions, K> = A extends [K, infer P] ? P : never;

package/dist/errors/utils.d.ts

@@ -1,22 +1,27 @@
 import { ModuleDefinition } from '../types/index.ts';
 import { Props } from './types.ts';
-export declare function isActionError(error: Error | UserError): error is UserError;
-export declare function isUserError(error: Error | UserError): error is UserError;
+/**
+ *  Check if the error is an instance of TypedError.
+ *
+ * @param error {Error | TypedError}
+ * @returns {boolean}
+ */
+export declare function isTypedError(error: Error | TypedError): error is TypedError;
 /**
  * Convert an unknown error into a known error type.
  *
  * @function intoError
  * @param error {unknown} - The error to convert to a known error type.
- * @returns {Error | UserError}
+ * @returns {Error | TypedError}
  */
-export declare function intoError(error: unknown): Error | UserError;
+export declare function intoError(error: unknown): Error | TypedError;
 /**
- * @class UserError
+ * @class TypedError
  * @extends Error
  * @param type {string} - The type of the error.
  * @param message {string} - The error message.
  */
-export declare class UserError extends Error {
+export declare class TypedError extends Error {
     #private;
     constructor(type: number | string | symbol, message?: null | string);
     get type(): number | string | symbol;

package/dist/index.d.ts

@@ -1,13 +1,11 @@
 import { ControllerDefinition } from './controller/types.ts';
-import { ViewArgs, ViewDefinition } from './view/types.ts';
-export { Lifecycle, State, Channel } from './types/index.ts';
+import { ViewArgs } from './view/types.ts';
+export { Lifecycle, State, Boundary } from './types/index.ts';
 export * as utils from './utils/index.ts';
-export { default as Tree } from './module/index.tsx';
-export { BroadcastProvider } from './broadcast/index.tsx';
-export { useModule } from './module/renderer/utils.ts';
-export { isActionError, isUserError, UserError } from './errors/utils.ts';
-export type * as Typed from './types/index.ts';
-export type { Pk } from './types/index.ts';
-export type { ViewDefinition as View };
-export type { ViewArgs as Within };
+export { default as Scope } from './module/index.tsx';
+export { Broadcaster } from './broadcast/index.tsx';
+export { useScoped } from './module/renderer/utils.ts';
+export { isTypedError, TypedError } from './errors/utils.ts';
+export type { Schema, Pk } from './types/index.ts';
+export type { ViewArgs as Scoped };
 export type { ControllerDefinition as Actions };

package/dist/module/index.d.ts

@@ -1,6 +1,4 @@
 import { ModuleDefinition } from '../types/index.ts';
 import { UseOptions } from './types.ts';
 import * as React from "react";
-declare function Tree<M extends ModuleDefinition>(options: UseOptions<M>): React.ReactNode;
-declare const _default: typeof Tree;
-export default _default;
+export default function Scope<M extends ModuleDefinition>(options: UseOptions<M>): React.ReactNode;

package/dist/module/renderer/actions/types.d.ts

@@ -1,4 +1,5 @@
 import { UseBroadcast } from '../../../broadcast/types.ts';
+import { UseContext } from '../../../context/types.ts';
 import { ControllerArgs } from '../../../controller/types.ts';
 import { ModuleDefinition } from '../../../types/index.ts';
 import { ViewArgs } from '../../../view/types.ts';
@@ -10,6 +11,7 @@ export type Props<M extends ModuleDefinition> = {
     options: UseOptions<M>;
     model: UseModel;
     dispatchers: UseDispatchers;
+    context: UseContext;
 };
 export type UseActions<M extends ModuleDefinition> = {
     controller: ControllerArgs<M>;

package/dist/module/renderer/controller/index.d.ts

@@ -1,3 +1,4 @@
 import { ModuleDefinition } from '../../../types/index.ts';
 import { Props } from './types.ts';
-export default function useController<M extends ModuleDefinition>(props: Props<M>): import('../../../controller/types.ts').ControllerInstance<M>;
+import { ControllerInstance } from '../../../controller/types.ts';
+export default function useController<M extends ModuleDefinition>(props: Props<M>): ControllerInstance<M> | undefined;

package/dist/module/renderer/utils.d.ts

@@ -5,4 +5,4 @@ export declare const config: {
     elementName: string;
 };
 export declare const Context: React.Context<ViewArgs<ModuleDefinition> | null>;
-export declare function useModule<M extends ModuleDefinition>(): ViewArgs<M>;
+export declare function useScoped<M extends ModuleDefinition>(): ViewArgs<M>;

package/dist/types/index.d.ts

@@ -30,7 +30,8 @@ export declare enum Lifecycle {
 export type Model = Record<symbol | string, any>;
 export type Actions = [] | [ActionName] | [ActionName, ...ActionPayload];
 export type Props = Record<string, unknown>;
-export type Module<M extends Model, A extends Actions = [], P extends Props = Record<string, never>> = {
+export type Context = Props;
+export type Schema<M extends Model, A extends Actions = [], P extends Props = Record<string, never>> = {
     Model: M;
     Actions: A;
     Props: P;
@@ -50,11 +51,11 @@ export type Queue<A extends ModuleDefinition["Actions"]> = {
 export type Task = PromiseWithResolvers<void>;
 export type Process = symbol;
 export type Op = number;
-export declare enum Channel {
+export declare enum Boundary {
     Default = 0,
     Error = 1
 }
 export type Meta = {
-    channel: Channel;
+    boundary: Boundary;
 };
 export {};

package/dist/view/types.d.ts

@@ -1,13 +1,13 @@
 import { Validatable } from '../module/renderer/model/types.ts';
-import { Channel, ModuleDefinition } from '../types/index.ts';
+import { Boundary, ModuleDefinition } from '../types/index.ts';
 import * as React from "react";
 export type ViewActions<M extends ModuleDefinition> = {
     dispatch(action: M["Actions"]): Promise<void>;
 };
 export type ViewArgs<M extends ModuleDefinition> = Readonly<{
     model: Readonly<M["Model"]>;
-    channel: {
-        is(channel: Channel): boolean;
+    boundary: {
+        is(boundary: Boundary): boolean;
     };
     validate: Readonly<Validatable<M["Model"]>>;
     actions: Readonly<ViewActions<M>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chizu",
-  "version": "0.2.21",
+  "version": "0.2.23",
   "type": "module",
   "main": "./dist/chizu.js",
   "types": "./dist/index.d.ts",