chizu 0.2.24 → 0.2.25

package/README.md

@@ -246,3 +246,27 @@ export default <Actions<Module>>function Actions(module) {
   };
 };
 ```
+
+If you need the context values to be reactive and fire the `Lifecycle.Derive` method then simply add it to your `props` definition when you initialise your scoped component:
+
+```tsx
+export default function Profile(props: Props): React.ReactElement {
+  const name = React.useContext(NameContext);
+
+  return (
+    <Scope<Module> using={{ model, actions, props: { ...props, name } }}>
+      {(module) => (
+        <>
+          <p>Hey {module.model.name}</p>
+
+          <button
+            onClick={() => module.actions.dispatch([Action.Name, randomName()])}
+          >
+            Switch profile
+          </button>
+        </>
+      )}
+    </Scope>
+  );
+}
+```

package/dist/chizu.js

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

package/dist/chizu.umd.cjs

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

@@ -17,7 +17,7 @@ export type ActionEvent<M extends ModuleDefinition> = (...args: M["Actions"][num
 type ActionEvents<M extends ModuleDefinition> = {
     [K in Head<M["Actions"]>]: (payload: Payload<M["Actions"], K>) => ActionGenerator<M>;
 };
-export type ActionGenerator<M extends ModuleDefinition> = void | ((models: Models<M["Model"]>, process: symbol) => Models<M["Model"]>) | AsyncGenerator<(models: Models<M["Model"]>, process: symbol) => Models<M["Model"]>, (models: Models<M["Model"]>, process: symbol) => Models<M["Model"]>, unknown>;
+export type ActionGenerator<M extends ModuleDefinition> = void | Promise<void> | ((models: Models<M["Model"]>, process: symbol) => Models<M["Model"]>) | Promise<(models: Models<M["Model"]>, process: symbol) => Models<M["Model"]>> | AsyncGenerator<(models: Models<M["Model"]>, process: symbol) => Models<M["Model"]>, (models: Models<M["Model"]>, process: symbol) => Models<M["Model"]>, unknown>;
 export type ControllerDefinition<M extends ModuleDefinition> = (controller: ControllerArgs<M>) => ControllerInstance<M>;
 export type ControllerInstance<M extends ModuleDefinition> = {
     [Lifecycle.Mount]?(): ActionGenerator<M>;

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

@@ -3,6 +3,7 @@ import { ModuleDefinition, Task } from '../../../types/index.ts';
 import { Head, Tail } from '../types.ts';
 import { UseDispatchHandlerProps } from './types.ts';
 /**
+ * @function useDispatcher
  * @param props {UseDispatchHandlerProps<M>}
  * @returns {(name: Head<M["Actions"]>, ƒ: GeneratorFn<M>) => (payload: Tail<M["Actions"]>) => Promise<void>}
  */

package/package.json

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