chizu 0.2.18 → 0.2.19

package/README.md

@@ -143,7 +143,7 @@ export default function ProfileView(props: Props): React.ReactElement {
 
 ## Error handling
 
-Actions can throw errors directly or in any of their associated `yield` actions – all unhandled errors are automatically caught and broadcast using the `Lifecycle.Error` action – you can render these [in a toast](https://github.com/fkhadra/react-toastify#readme) or similar UI.
+Actions can throw errors directly or in any of their associated `yield` actions – all unhandled errors are automatically caught and dispatched using the `Lifecycle.Error` action – you can render these [in a toast](https://github.com/fkhadra/react-toastify#readme) or similar UI.
 
 You can also customise these errors a little further with your own error `enum` which describes the error type:
 
@@ -166,7 +166,7 @@ export default <Actions<Module>>function Actions(module) {
 
       const name = await fetch(/* ... */);
 
-      if (!name) throw new EventError(Errors.UserValidation);
+      if (!name) throw new ActionError(Errors.UserValidation);
 
       return module.actions.produce((draft) => {
         draft.name = name;
@@ -190,7 +190,7 @@ export default <Actions<Module>>function Actions(module) {
 
       if (!name) {
         return module.actions.produce((draft) => {
-          draft.name = Maybe.of(new EventError(Errors.UserValidation));
+          draft.name = Maybe.of(new ActionError(Errors.UserValidation));
         });
       }
 

package/dist/broadcast/utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Check if the name is a broadcast event.
+ *
+ * @param name {string}
+ * @returns {boolean}
+ */
+export declare function isBroadcast(name: string): boolean;

package/dist/chizu.js

@@ -1,35 +1,50 @@
-var z = Object.defineProperty;
-var D = (t) => {
+var I = Object.defineProperty;
+var j = (t) => {
   throw TypeError(t);
 };
-var N = (t, e, n) => e in t ? z(t, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : t[e] = n;
-var w = (t, e, n) => N(t, typeof e != "symbol" ? e + "" : e, n), C = (t, e, n) => e.has(t) || D("Cannot " + n);
-var y = (t, e, n) => (C(t, e, "read from private field"), n ? n.call(t) : e.get(t)), g = (t, e, n) => e.has(t) ? D("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(t) : e.set(t, n), b = (t, e, n, r) => (C(t, e, "write to private field"), r ? r.call(t, n) : e.set(t, n), n);
-import { jsx as q } from "react/jsx-runtime";
+var J = (t, e, n) => e in t ? I(t, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : t[e] = n;
+var R = (t, e, n) => J(t, typeof e != "symbol" ? e + "" : e, n), A = (t, e, n) => e.has(t) || j("Cannot " + n);
+var y = (t, e, n) => (A(t, e, "read from private field"), n ? n.call(t) : e.get(t)), w = (t, e, n) => e.has(t) ? j("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(t) : e.set(t, n), b = (t, e, n, r) => (A(t, e, "write to private field"), r ? r.call(t, n) : e.set(t, n), n);
+import { jsx as x, Fragment as Q } from "react/jsx-runtime";
 import * as c from "react";
-import P from "eventemitter3";
-import { Immer as I } from "immer";
-import v from "lodash/get";
-import M from "traverse";
+import D from "eventemitter3";
+import { Immer as W } from "immer";
+import p from "lodash/get";
+import C from "traverse";
 class U {
   constructor(e) {
     this.value = e;
   }
 }
-class F {
+class G {
   static Draft(e) {
     return new U(e);
   }
 }
-w(F, "Op", {
+R(G, "Op", {
   Add: 1,
   Remove: 2,
   Update: 4,
   Move: 8,
   Replace: 16
 });
-var h = /* @__PURE__ */ ((t) => (t.Mount = "lifecycle/mount", t.Node = "lifecycle/node", t.Derive = "lifecycle/derive", t.Error = "distributed/lifecycle/error", t.Unmount = "lifecycle/unmount", t))(h || {});
-function d(t, e) {
+var h = /* @__PURE__ */ ((t) => (t.Mount = "lifecycle/mount", t.Node = "lifecycle/node", t.Derive = "lifecycle/derive", t.Error = "lifecycle/error", t.Unmount = "lifecycle/unmount", t))(h || {});
+function K(t) {
+  return new Promise((e) => setTimeout(e, t));
+}
+function V(t) {
+  return t ? !!(t && typeof t != "symbol") : Symbol(`pk.${Date.now()}.${crypto.randomUUID()}`);
+}
+function m(t) {
+  return JSON.stringify(t);
+}
+const Et = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  hash: m,
+  pk: V,
+  sleep: K
+}, Symbol.toStringTag, { value: "Module" }));
+function f(t, e) {
   const n = c.useRef(null), r = c.useRef(null);
   return c.useMemo(() => {
     const s = m(e);
@@ -41,7 +56,7 @@ function d(t, e) {
     return n.current;
   }, e);
 }
-function O(t, e) {
+function B(t, e) {
   const n = c.useRef(null);
   c.useEffect(() => {
     const r = m(e);
@@ -50,127 +65,127 @@ function O(t, e) {
   }, e);
 }
 const _ = c.createContext({
-  appEmitter: new P()
+  appEmitter: new D()
 });
-function j() {
+function H() {
   return c.useContext(_);
 }
-function ht({ children: t }) {
-  const e = d(
+function gt({ children: t }) {
+  const e = f(
     () => ({
-      appEmitter: new P()
+      appEmitter: new D()
     }),
     []
   );
-  return /* @__PURE__ */ q(_.Provider, { value: e, children: t });
+  return /* @__PURE__ */ x(_.Provider, { value: e, children: t });
 }
-const l = {
-  immer: new I(),
+const a = {
+  immer: new W(),
   annotations: Symbol("annotations")
 };
-l.immer.setAutoFreeze(!1);
-class S {
+a.immer.setAutoFreeze(!1);
+class P {
   constructor(e, n, r = null) {
-    w(this, "process");
+    R(this, "process");
     this.value = e, this.operations = n, this.field = r, this.process = null;
   }
   attach(e) {
     return this.process = e, this;
   }
 }
-function J(t, e = []) {
-  return new S(t, e);
+function X(t, e = []) {
+  return new P(t, e);
 }
 class k {
   constructor(e, n = e) {
     this.stateless = e, this.stateful = n;
   }
   get validatable() {
-    return A(this.stateful);
+    return T(this.stateful);
   }
 }
-function A(t, e = []) {
+function T(t, e = []) {
   return new Proxy(t, {
     get(n, r) {
       switch (r) {
         case "is":
           return (s) => {
-            const o = x(t, e);
+            const o = S(t, e);
             if (!o) return !1;
             const u = new Set(
-              o.flatMap((a) => a.operations)
+              o.flatMap((l) => l.operations)
             );
             return !!(Array.from(u).reduce(
-              (a, f) => a | (f ?? 0),
+              (l, d) => l | (d ?? 0),
               0
             ) & s);
           };
         case "pending":
-          return () => !!x(t, e);
+          return () => !!S(t, e);
         case "draft":
           return () => {
-            const s = x(t, e);
-            if (!s) return v(t, e);
+            const s = S(t, e);
+            if (!s) return p(t, e);
             const o = s.flatMap((u) => u.operations).find((u) => u instanceof U);
-            return o ? o.value : v(t, e);
+            return o ? o.value : p(t, e);
           };
       }
-      return A(t, [...e, String(r)]);
+      return T(t, [...e, String(r)]);
     }
   });
 }
-function x(t, e) {
-  const r = typeof v(t, e) == "object" ? e : e.slice(0, -1), s = r.length === 0 ? t : v(t, r), o = (s == null ? void 0 : s[l.annotations]) ?? [];
+function S(t, e) {
+  const r = typeof p(t, e) == "object" ? e : e.slice(0, -1), s = r.length === 0 ? t : p(t, r), o = (s == null ? void 0 : s[a.annotations]) ?? [];
   return o.length > 0 ? o : null;
 }
-function Q(t, e, n) {
+function Y(t, e, n) {
   function r(o) {
-    return M(o).forEach(function() {
-      if (this.key === l.annotations) {
+    return C(o).forEach(function() {
+      if (this.key === a.annotations) {
         this.block();
         return;
       }
-      this.node instanceof S && this.update(this.node.value);
+      this.node instanceof P && this.update(this.node.value);
     });
   }
   function s(o) {
-    return M(o).forEach(function() {
-      if (this.key === l.annotations) {
+    return C(o).forEach(function() {
+      if (this.key === a.annotations) {
         this.block();
         return;
       }
-      if (this.node instanceof S) {
+      if (this.node instanceof P) {
         const u = typeof this.node.value == "object", i = [
           ...u ? this.path : this.path.slice(0, -1),
-          l.annotations
-        ], a = v(t.stateful, i) ?? [], f = this.node.attach(e);
+          a.annotations
+        ], l = p(t.stateful, i) ?? [], d = this.node.attach(e);
         u ? this.update(
           {
             ...this.node.value,
-            [l.annotations]: [f, ...a]
+            [a.annotations]: [d, ...l]
           },
           !0
-        ) : (this.parent && (this.parent.node[l.annotations] = [f, ...a]), this.update(this.node.value, !0));
+        ) : (this.parent && (this.parent.node[a.annotations] = [d, ...l]), this.update(this.node.value, !0));
       }
     });
   }
   return new k(
-    r(l.immer.produce(t.stateless, n)),
-    s(l.immer.produce(t.stateful, n))
+    r(a.immer.produce(t.stateless, n)),
+    s(a.immer.produce(t.stateful, n))
   );
 }
-function R(t, e) {
-  const n = M(t.stateful).forEach(function() {
-    if (this.key === l.annotations) {
+function M(t, e) {
+  const n = C(t.stateful).forEach(function() {
+    if (this.key === a.annotations) {
       this.block();
       return;
     }
-    if (this.node && this.node[l.annotations]) {
-      const r = this.node[l.annotations];
+    if (this.node && this.node[a.annotations]) {
+      const r = this.node[a.annotations];
       this.update(
         {
           ...this.node,
-          [l.annotations]: r.filter(
+          [a.annotations]: r.filter(
             (s) => s.process !== e
           )
         },
@@ -180,73 +195,8 @@ function R(t, e) {
   });
   return new k(t.stateless, n);
 }
-function W(t) {
-  const e = j();
-  return (n, r) => async (s = Promise.withResolvers(), o) => {
-    if (typeof r != "function") return;
-    const u = Symbol("process"), i = r(...o);
-    try {
-      if (i == null) return;
-      if (typeof i == "function") {
-        const a = i(t.model.current, u);
-        t.model.current = R(a, u), t.update.rerender(), s.resolve();
-        return;
-      }
-      for (; ; ) {
-        const { value: a, done: f } = await i.next();
-        if (f) {
-          const $ = a(t.model.current, u);
-          t.model.current = R($, u), t.update.rerender();
-          break;
-        }
-        const T = a;
-        t.model.current = T(t.model.current, u), t.update.rerender(), s.resolve();
-      }
-    } catch (a) {
-      R(t.model.current, u), t.update.rerender(), e.appEmitter.emit(h.Error, s, [a]);
-    }
-  };
-}
-function B(t) {
-  return t.startsWith("distributed");
-}
-var p, E;
-class G extends Error {
-  constructor(n, r = null) {
-    super(String(r));
-    g(this, p);
-    g(this, E);
-    b(this, p, n), b(this, E, r);
-  }
-  get type() {
-    return y(this, p);
-  }
-  get message() {
-    return y(this, E) || "";
-  }
-}
-p = new WeakMap(), E = new WeakMap();
-function K(t) {
-  return new Promise((e) => setTimeout(e, t));
-}
-function V(t) {
-  return t ? !!(t && typeof t != "symbol") : Symbol(`pk.${Date.now()}.${crypto.randomUUID()}`);
-}
-function X(t) {
-  return t instanceof G;
-}
-function m(t) {
-  return JSON.stringify(t);
-}
-const mt = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
-  __proto__: null,
-  hash: m,
-  isEventError: X,
-  pk: V,
-  sleep: K
-}, Symbol.toStringTag, { value: "Module" }));
-function Y(t) {
-  return d(
+function Z(t) {
+  return f(
     () => ({
       controller: {
         get model() {
@@ -255,10 +205,10 @@ function Y(t) {
         queue: [],
         actions: {
           annotate(e, n) {
-            return J(e, n);
+            return X(e, n);
           },
           produce(e) {
-            return (n, r) => Q(n, r, e);
+            return (n, r) => Y(n, r, e);
           },
           dispatch([e, ...n]) {
             if (e == null) return Promise.reject();
@@ -268,6 +218,7 @@ function Y(t) {
         }
       },
       view: {
+        error: !1,
         get model() {
           return t.model.current.stateless;
         },
@@ -275,6 +226,10 @@ function Y(t) {
           return t.model.current.validatable;
         },
         actions: {
+          retry: () => {
+          },
+          remount: () => {
+          },
           dispatch([e, ...n]) {
             if (e == null) return Promise.reject();
             const r = Promise.withResolvers();
@@ -286,88 +241,187 @@ function Y(t) {
     []
   );
 }
-function Z(t) {
-  return d(() => {
+function L(t) {
+  return f(() => {
     const e = t.options.using.actions(t.actions.controller);
     return Object.entries(e).forEach(([r, s]) => t.dispatchers.attach(r, s)), e;
   }, []);
 }
-function L(t) {
-  const e = j(), n = W(t);
-  return d(() => {
-    const r = new P();
-    return {
-      attach(s, o) {
-        const u = String(s);
-        B(u) ? e.appEmitter.on(u, n(s, o)) : r.on(u, n(s, o));
-      },
-      dispatch(s, o, u) {
-        const i = String(s);
-        B(i) ? e.appEmitter.emit(i, u, o) : r.emit(i, u, o);
+function O(t) {
+  return t.startsWith("distributed");
+}
+function yt(t) {
+  return t instanceof z;
+}
+function wt(t) {
+  return t instanceof F;
+}
+function $(t) {
+  return t instanceof z || t instanceof F || t instanceof Error ? t : new Error("Unknown error", { cause: t });
+}
+var v, E;
+class z extends Error {
+  constructor(n, r = null) {
+    super(String(r));
+    w(this, v);
+    w(this, E);
+    b(this, v, n), b(this, E, r);
+  }
+  get type() {
+    return y(this, v);
+  }
+  get message() {
+    return y(this, E) || "";
+  }
+}
+v = new WeakMap(), E = new WeakMap();
+var g;
+class F extends Error {
+  constructor(n = null) {
+    super(String(n));
+    w(this, g);
+    b(this, g, n);
+  }
+  get message() {
+    return y(this, g) || "";
+  }
+}
+g = new WeakMap();
+function tt(t) {
+  return (e, n) => async (r = Promise.withResolvers(), s) => {
+    if (typeof n != "function") return;
+    const o = Symbol("process"), u = n(...s);
+    try {
+      if (u == null) return;
+      if (typeof u == "function") {
+        const i = u(t.model.current, o);
+        t.model.current = M(i, o), t.update.rerender(), r.resolve();
+        return;
       }
-    };
-  }, []);
+      for (; ; ) {
+        const { value: i, done: l } = await u.next();
+        if (l) {
+          const q = i(t.model.current, o);
+          t.model.current = M(q, o), t.update.rerender();
+          break;
+        }
+        const d = i;
+        t.model.current = d(t.model.current, o), t.update.rerender(), r.resolve();
+      }
+    } catch (i) {
+      M(t.model.current, o), t.update.rerender(), t.unicast.emit(h.Error, r, [$(i)]);
+    }
+  };
+}
+function et(t) {
+  const e = H(), n = f(() => new D(), []), r = tt({ ...t, unicast: n });
+  return f(() => ({
+    attach(s, o) {
+      const u = String(s);
+      O(u) ? e.appEmitter.on(u, r(s, o)) : n.on(u, r(s, o));
+    },
+    dispatch(s, o, u) {
+      const i = String(s);
+      O(i) ? e.appEmitter.emit(i, u, o) : n.emit(i, u, o);
+    }
+  }), []);
 }
-function tt() {
+function nt() {
   const t = c.useRef(null);
-  return d(() => ({ customElement: t }), []);
+  return f(() => ({ customElement: t }), []);
 }
-function et(t) {
-  O(() => {
+function rt(t) {
+  B(() => {
     t.dispatchers.dispatch(h.Derive, []);
-  }, [t.options.using.props]), O(() => (t.dispatchers.dispatch(h.Mount, []), t.dispatchers.dispatch(h.Node, [
+  }, [t.options.using.props]), B(() => (t.dispatchers.dispatch(h.Mount, []), t.dispatchers.dispatch(h.Node, [
     t.elements.customElement.current
   ]), () => t.dispatchers.dispatch(h.Unmount, [])), []);
 }
-function nt(t) {
-  const e = d(() => t.options.using.model ?? {}, []);
+function ot(t) {
+  const e = f(() => t.options.using.model ?? {}, []);
   return c.useRef(new k(e, e));
 }
-function rt() {
+function st() {
   return c.useRef(/* @__PURE__ */ new Set());
 }
-function st() {
+function ut() {
   const [t, e] = c.useReducer((n) => n + 1, 0);
-  return d(() => ({ hash: t, rerender: e }), [t]);
+  return f(() => ({ hash: t, rerender: e }), [t]);
 }
-const H = c.createContext(
+const N = c.createContext(
   null
 );
-function vt() {
-  const t = c.useContext(H);
+function bt() {
+  const t = c.useContext(N);
   if (!t) throw new Error("useModule must be used within a module.");
   return t;
 }
-function ot({
+class ct extends c.Component {
+  constructor(e) {
+    super(e), this.state = { errored: !1 };
+  }
+  static getDerivedStateFromError() {
+    return { errored: !0 };
+  }
+  componentDidCatch(e) {
+    this.props.module.actions.dispatch([h.Error, [$(e)]]);
+  }
+  render() {
+    const e = () => this.setState({ errored: !1 });
+    return this.props.children({ error: this.state.errored, retry: e });
+  }
+}
+function it({
   options: t
 }) {
-  const e = st(), n = rt(), r = tt(), s = j(), o = nt({ options: t }), u = L({
+  const e = ut(), n = st(), r = nt(), s = H(), o = ot({ options: t }), u = et({
     broadcast: s,
     options: t,
     update: e,
     model: o,
     queue: n
-  }), i = Y({ model: o, dispatchers: u });
-  return Z({ options: t, dispatchers: u, actions: i }), et({ options: t, dispatchers: u, elements: r }), d(() => c.createElement(H.Provider, {
-    value: i.view,
-    // eslint-disable-next-line react/no-children-prop
-    children: c.createElement("x-chizu", {
-      ref: r.customElement,
-      style: { display: "contents" },
-      children: t.children(i.view)
-    })
+  }), i = Z({ model: o, dispatchers: u });
+  return L({ options: t, dispatchers: u, actions: i }), rt({ options: t, dispatchers: u, elements: r }), f(() => c.createElement(ct, {
+    module: i.view,
+    children(l) {
+      const d = {
+        ...i.view,
+        error: l.error,
+        actions: {
+          ...i.view.actions,
+          retry: l.retry,
+          remount: t.remount
+        }
+      };
+      return c.createElement(N.Provider, {
+        value: d,
+        // eslint-disable-next-line react/no-children-prop
+        children: c.createElement("x-chizu", {
+          ref: r.customElement,
+          style: { display: "contents" },
+          children: t.children(d)
+        })
+      });
+    }
   }), [e.hash, m(t.using.props)]);
 }
-function ut(t) {
-  return ot({ options: t });
+function at({ children: t }) {
+  return /* @__PURE__ */ x(Q, { children: t });
+}
+function lt(t) {
+  const [e, n] = c.useReducer((r) => r + 1, 0);
+  return /* @__PURE__ */ x(at, { children: /* @__PURE__ */ x(it, { options: { ...t, remount: n } }) }, e);
 }
-const pt = c.memo(ut, (t, e) => m(t) === m(e));
+const xt = c.memo(lt, (t, e) => m(t) === m(e));
 export {
-  ht as BroadcastProvider,
-  G as EventError,
+  z as ActionError,
+  gt as BroadcastProvider,
+  F as ComponentError,
   h as Lifecycle,
-  F as State,
-  pt as Tree,
-  vt as useModule,
-  mt as utils
+  G as State,
+  xt as Tree,
+  yt as isActionError,
+  wt as isComponentError,
+  bt as useModule,
+  Et as utils
 };

package/dist/chizu.umd.cjs

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

package/dist/controller/types.d.ts

@@ -1,4 +1,4 @@
-import { EventError } from '../module/renderer/dispatchers/utils.ts';
+import { ActionError, ComponentError } from '../errors/utils.ts';
 import { Models } from '../module/renderer/model/utils.ts';
 import { Head } from '../module/renderer/types.ts';
 import { Actions, Draft, Lifecycle, ModuleDefinition, Op, Queue } from '../types/index.ts';
@@ -22,7 +22,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 | EventError): ActionGenerator<M>;
+    [Lifecycle.Error]?(error: Error | ActionError | ComponentError): 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/index.d.ts

@@ -0,0 +1,9 @@
+import { Props, State } from './types.ts';
+import { ModuleDefinition } from '../types/index.ts';
+import * as React from "react";
+export default class ErrorBoundary<M extends ModuleDefinition> extends React.Component<Props<M>, State> {
+    constructor(props: Props<M>);
+    static getDerivedStateFromError(): Partial<State>;
+    componentDidCatch(error: unknown): void;
+    render(): React.ReactNode;
+}

package/dist/errors/types.d.ts

@@ -0,0 +1,15 @@
+import { ModuleDefinition } from '../types/index.ts';
+import { ViewArgs } from '../view/types.ts';
+import * as React from "react";
+export type Props<M extends ModuleDefinition> = {
+    module: ViewArgs<M>;
+    children(props: ChildrenProps): React.ReactNode;
+};
+export type State = {
+    errored: boolean;
+};
+export type ChildrenProps = {
+    error: boolean;
+    retry: Retry;
+};
+export type Retry = () => void;

package/dist/errors/utils.d.ts

@@ -0,0 +1,37 @@
+export declare function isActionError(error: Error | ActionError | ComponentError): error is ActionError;
+export declare function isComponentError(error: Error | ActionError | ComponentError): error is ComponentError;
+/**
+ * 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 | ActionError | ComponentError}
+ */
+export declare function intoError(error: unknown): Error | ActionError | ComponentError;
+/**
+ * Custom error class for action errors.
+ *
+ * @class ActionError
+ * @extends Error
+ * @param type {string} - The type of the error.
+ * @param message {string} - The error message.
+ */
+export declare class ActionError extends Error {
+    #private;
+    constructor(type: number | string | symbol, message?: null | string);
+    get type(): number | string | symbol;
+    get message(): string;
+}
+/**
+ * Custom error class for component errors.
+ *
+ * @class ComponentError
+ * @extends Error
+ * @param type {string} - The type of the error.
+ * @param message {string} - The error message.
+ */
+export declare class ComponentError extends Error {
+    #private;
+    constructor(message?: null | string);
+    get message(): string;
+}

package/dist/index.d.ts

@@ -2,10 +2,10 @@ import { ControllerDefinition } from './controller/types.ts';
 import { ViewArgs, ViewDefinition } from './view/types.ts';
 export { Lifecycle, State } from './types/index.ts';
 export * as utils from './utils/index.ts';
-export { EventError } from './module/renderer/dispatchers/utils.ts';
 export { default as Tree } from './module/index.tsx';
 export { BroadcastProvider } from './broadcast/index.tsx';
 export { useModule } from './module/renderer/utils.ts';
+export { isActionError, isComponentError, ActionError, ComponentError, } from './errors/utils.ts';
 export type * as Typed from './types/index.ts';
 export type { Pk } from './types/index.ts';
 export type { ViewDefinition as View };

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

@@ -1,3 +1,4 @@
+import { default as EventEmitter } from 'eventemitter3';
 import { UseBroadcast } from '../../../broadcast/types.ts';
 import { ModuleDefinition } from '../../../types/index.ts';
 import { UseOptions } from '../../types.ts';
@@ -13,5 +14,7 @@ export type Props<M extends ModuleDefinition> = {
     queue: UseQueue;
 };
 export type UseDispatchers = ReturnType<typeof useDispatchers>;
-export type UseDispatchHandlerProps<M extends ModuleDefinition> = Props<M>;
+export type UseDispatchHandlerProps<M extends ModuleDefinition> = Props<M> & {
+    unicast: EventEmitter;
+};
 export type Fn = (...args: any[]) => void;

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

@@ -7,24 +7,3 @@ import { UseDispatchHandlerProps } from './types.ts';
  * @returns {(name: Head<M["Actions"]>, ƒ: GeneratorFn<M>) => (payload: Tail<M["Actions"]>) => Promise<void>}
  */
 export declare function useDispatcher<M extends ModuleDefinition>(props: UseDispatchHandlerProps<M>): (_name: Head<M["Actions"]>, ƒ: ActionEvent<M>) => (task: Task | undefined, payload: Tail<M["Actions"]>) => Promise<void>;
-/**
- * Check if the name is a broadcast event.
- *
- * @param name {string}
- * @returns {boolean}
- */
-export declare function isBroadcast(name: string): boolean;
-/**
- * Custom error class for IO errors.
- *
- * @class EventError
- * @extends Error
- * @param type {string} - The type of the error.
- * @param message {string} - The error message.
- */
-export declare class EventError extends Error {
-    #private;
-    constructor(type: string, message?: null | string);
-    get type(): string;
-    get message(): string;
-}

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

@@ -1,4 +1,4 @@
 import { ModuleDefinition } from '../../types/index.ts';
 import { Props } from './types.ts';
 import * as React from "react";
-export default function renderer<M extends ModuleDefinition>({ options, }: Props<M>): React.ReactNode;
+export default function Renderer<M extends ModuleDefinition>({ options, }: Props<M>): React.ReactNode;

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

@@ -1,8 +1,12 @@
 import { ModuleDefinition } from '../../types/index.ts';
 import { UseOptions } from '../types.ts';
+import * as React from "react";
 export type ElementName = string;
+export type Remount = React.ActionDispatch<[]>;
 export type Props<M extends ModuleDefinition> = {
-    options: UseOptions<M>;
+    options: UseOptions<M> & {
+        remount: Remount;
+    };
 };
 export type Head<T extends any[]> = T extends [infer X, ...any[]] ? X : never;
 export type Tail<T extends any[]> = T extends [any, ...infer XS] ? XS : never;

package/dist/module/types.d.ts

@@ -9,3 +9,6 @@ export type UseOptions<M extends ModuleDefinition> = {
     };
     children(module: ViewArgs<M>): React.ReactNode;
 };
+export type RootProps = {
+    children: React.ReactNode;
+};

package/dist/types/index.d.ts

@@ -24,7 +24,7 @@ export declare enum Lifecycle {
     Mount = "lifecycle/mount",
     Node = "lifecycle/node",
     Derive = "lifecycle/derive",
-    Error = "distributed/lifecycle/error",
+    Error = "lifecycle/error",
     Unmount = "lifecycle/unmount"
 }
 export type Model = Record<string, any>;

package/dist/utils/index.d.ts

@@ -1,7 +1,5 @@
-import { EventError } from '../module/renderer/dispatchers/utils.ts';
 import { Pk } from '../types/index.ts';
 export { default as sleep } from './sleep/index.ts';
 export declare function pk(): symbol;
 export declare function pk<T>(id: Pk<T>): boolean;
-export declare function isEventError(error: Error | EventError): error is EventError;
 export declare function hash<T>(x: T): string;

package/dist/view/types.d.ts

@@ -2,9 +2,12 @@ import { Validatable } from '../module/renderer/model/types.ts';
 import { ModuleDefinition } from '../types/index.ts';
 import * as React from "react";
 export type ViewActions<M extends ModuleDefinition> = {
+    retry(): void;
+    remount(): void;
     dispatch(action: M["Actions"]): Promise<void>;
 };
 export type ViewArgs<M extends ModuleDefinition> = Readonly<{
+    error: boolean;
     model: Readonly<M["Model"]>;
     validate: Readonly<Validatable<M["Model"]>>;
     actions: Readonly<ViewActions<M>>;

package/package.json

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