npm - @directive-run/react - Versions diffs - 0.5.0 → 0.8.0 - Mend

@directive-run/react 0.5.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -104,7 +104,7 @@ function Summary() {
 | `useExplain(system, reqId)` | `string \| null` | Human-readable requirement explanation |
 | `useConstraintStatus(system)` | `ConstraintInfo[]` | All constraint states |
 | `useOptimisticUpdate(system)` | `{ mutate, isPending, error, rollback }` | Optimistic mutation with auto-rollback |
-| `useTimeTravel(system)` | `TimeTravelState \| null` | Undo/redo navigation |
+| `useHistory(system)` | `HistoryState \| null` | Undo/redo navigation |
 ### React-Specific

package/dist/index.cjs CHANGED Viewed

@@ -1,2 +1,2 @@
-'use strict';var core=require('@directive-run/core'),adapterUtils=require('@directive-run/core/adapter-utils'),react=require('react'),jsxRuntime=require('react/jsx-runtime');var h=Symbol("directive.uninitialized");function Re(e,t){return adapterUtils.assertSystem("useFact",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useFact() received a function. Did you mean useSelector()? useFact() takes a string key or array of keys, not a selector function."),Array.isArray(t)?ne(e,t):te(e,t)}function te(e,t){process.env.NODE_ENV!=="production"&&(t in e.facts.$store.toObject()||console.warn(`[Directive] useFact("${t}") \u2014 fact not found in store. Check that "${t}" is defined in your module's schema.`));let r=react.useCallback(n=>e.facts.$store.subscribe([t],n),[e,t]),u=react.useCallback(()=>e.facts[t],[e,t]);return react.useSyncExternalStore(r,u,u)}function ne(e,t){let r=react.useRef(h),u=react.useCallback(o=>e.facts.$store.subscribe(t,o),[e,...t]),n=react.useCallback(()=>{let o={};for(let s of t)o[s]=e.facts[s];if(r.current!==h){let s=true;for(let i of t)if(!Object.is(r.current[i],o[i])){s=false;break}if(s)return r.current}return r.current=o,o},[e,...t]);return react.useSyncExternalStore(u,n,n)}function be(e,t){return adapterUtils.assertSystem("useDerived",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useDerived() received a function. Did you mean useSelector()? useDerived() takes a string key or array of keys, not a selector function."),Array.isArray(t)?se(e,t):re(e,t)}function re(e,t){process.env.NODE_ENV!=="production"&&(t in e.derive||console.warn(`[Directive] useDerived("${t}") \u2014 derivation not found. Check that "${t}" is defined in your module's derive property.`));let r=react.useCallback(n=>e.subscribe([t],n),[e,t]),u=react.useCallback(()=>e.read(t),[e,t]);return react.useSyncExternalStore(r,u,u)}function se(e,t){let r=react.useRef(h),u=react.useCallback(o=>e.subscribe(t,o),[e,...t]),n=react.useCallback(()=>{let o={};for(let s of t)o[s]=e.read(s);if(r.current!==h){let s=true;for(let i of t)if(!Object.is(r.current[i],o[i])){s=false;break}if(s)return r.current}return r.current=o,o},[e,...t]);return react.useSyncExternalStore(u,n,n)}function he(e,t,r,u){if(e&&e._mode==="namespaced")return ue(e,t,r,u);let n=e,o,s=false,i=u??adapterUtils.defaultEquality;r!==void 0&&(o=r,s=true),process.env.NODE_ENV!=="production"&&!n&&!s&&console.error("[Directive] useSelector() received a null/undefined system without a default value. Provide a default value as the 3rd parameter: useSelector(system, selector, defaultValue)");let f=react.useRef(t),d=react.useRef(i),c=react.useRef(o);f.current=t,d.current=i,c.current=o;let g=react.useRef([]),v=react.useRef([]),M=react.useRef(h),y=react.useRef([]),x=react.useMemo(()=>n?new Set(Object.keys(n.derive)):new Set,[n]),R=react.useCallback(()=>n?adapterUtils.runTrackedSelector(n,x,f.current):{value:c.current,factKeys:[],deriveKeys:[]},[n,x]),F=react.useCallback(m=>{if(!n)return ()=>{};let k=()=>{for(let S of y.current)S();y.current=[];let{factKeys:I,deriveKeys:p}=R();g.current=I,v.current=p,I.length>0?y.current.push(n.facts.$store.subscribe(I,()=>{let S=R();adapterUtils.depsChanged(g.current,S.factKeys,v.current,S.deriveKeys)&&k(),m();})):p.length===0&&y.current.push(n.facts.$store.subscribeAll(m)),p.length>0&&y.current.push(n.subscribe(p,()=>{let S=R();adapterUtils.depsChanged(g.current,S.factKeys,v.current,S.deriveKeys)&&k(),m();}));};return k(),()=>{for(let I of y.current)I();y.current=[];}},[n,R]),N=react.useCallback(()=>{let m;if(!n)m=c.current;else {let{value:k}=R();m=k===void 0&&s?c.current:k;}return M.current!==h&&d.current(M.current,m)?M.current:(M.current=m,m)},[R,n,s]);return react.useSyncExternalStore(F,N,N)}function ue(e,t,r,u){let n=r!==void 0,o=u??adapterUtils.defaultEquality,s=react.useRef(t),i=react.useRef(o),f=react.useRef(r);s.current=t,i.current=o,f.current=r;let d=react.useRef(h),c=react.useMemo(()=>Object.keys(e.facts),[e]),g=react.useCallback(M=>{let y=c.map(x=>`${x}.*`);return e.subscribe(y,M)},[e,c]),v=react.useCallback(()=>{let M=s.current(e),y=M===void 0&&n?f.current:M;return d.current!==h&&i.current(d.current,y)?d.current:(d.current=y,y)},[e,n]);return react.useSyncExternalStore(g,v,v)}function Me(e){return adapterUtils.assertSystem("useDispatch",e),react.useCallback(t=>{e.dispatch(t);},[e])}function De(e,t,r){adapterUtils.assertSystem("useWatch",e);let u=react.useRef(r);u.current=r,react.useEffect(()=>e.watch(t,(n,o)=>{u.current(n,o);}),[e,t]);}function oe(e,t){adapterUtils.assertSystem("useInspect",e);let r=ce(e),u=t?.throttleMs,[n,o]=react.useState(r),s=react.useRef(null);return react.useEffect(()=>{if(!u||u<=0){s.current?.cleanup(),s.current=null;return}return s.current?.cleanup(),s.current=adapterUtils.createThrottle((...i)=>{o(i[0]);},u),()=>{s.current?.cleanup(),s.current=null;}},[u]),react.useEffect(()=>{s.current&&s.current.throttled(r);},[r]),!u||u<=0?r:n}function ie(e){return adapterUtils.computeInspectState(e)}function ce(e){let t=react.useRef(null),r=react.useRef([]),u=react.useRef([]),n=react.useRef(null),o=react.useCallback(i=>{let f=e.facts.$store.subscribeAll(i),d=e.onSettledChange(i);return ()=>{f(),d();}},[e]),s=react.useCallback(()=>{let i=ie(e),f=i.unmet.length===r.current.length&&i.unmet.every((g,v)=>g.id===r.current[v]),d=i.inflight.length===u.current.length&&i.inflight.every((g,v)=>g.id===u.current[v]),c=i.isSettled===n.current;return f&&d&&c&&t.current?t.current:(t.current=i,r.current=i.unmet.map(g=>g.id),u.current=i.inflight.map(g=>g.id),n.current=i.isSettled,i)},[e]);return react.useSyncExternalStore(o,s,s)}function xe(e){adapterUtils.assertSystem("useTimeTravel",e);let t=react.useRef(null),r=react.useCallback(n=>e.onTimeTravelChange(n),[e]),u=react.useCallback(()=>{let n=adapterUtils.buildTimeTravelState(e);return n?(t.current&&t.current.canUndo===n.canUndo&&t.current.canRedo===n.canRedo&&t.current.currentIndex===n.currentIndex&&t.current.totalSnapshots===n.totalSnapshots&&t.current.isPaused===n.isPaused||(t.current=n),t.current):null},[e]);return react.useSyncExternalStore(r,u,u)}function ke(e,t){return Array.isArray(t)?le(e,t):ae(e,t)}function ae(e,t){let r=react.useRef(h),u=react.useCallback(o=>e.subscribe(o),[e]),n=react.useCallback(()=>{let o=e.getStatus(t);if(r.current!==h){let s=r.current;if(s.pending===o.pending&&s.inflight===o.inflight&&s.failed===o.failed&&s.isLoading===o.isLoading&&s.hasError===o.hasError&&s.lastError===o.lastError)return r.current}return r.current=o,o},[e,t]);return react.useSyncExternalStore(u,n,n)}function le(e,t){let r=react.useRef(null),u=react.useRef(""),n=react.useCallback(s=>e.subscribe(s),[e]),o=react.useCallback(()=>{let s={},i=[];for(let d of t){let c=e.getStatus(d);s[d]=c,i.push(`${d}:${c.pending}:${c.inflight}:${c.failed}:${c.hasError}:${c.lastError?.message??""}`);}let f=i.join("|");return f!==u.current&&(u.current=f,r.current=s),r.current??s},[e,...t]);return react.useSyncExternalStore(n,o,o)}var _=new WeakMap;function j(e){let t=_.get(e);return t||(t=new Map,_.set(e,t)),t}function Ie(e,t){return Array.isArray(t)?fe(e,t):de(e,t)}function de(e,t){let r=e.getStatus(t);if(r.hasError&&r.lastError)throw r.lastError;if(r.isLoading){let u=j(e),n=u.get(t);throw n||(n=new Promise(o=>{let s=e.subscribe(()=>{e.getStatus(t).isLoading||(u.delete(t),s(),o());});}),u.set(t,n)),n}return r}function fe(e,t){let r={},u=false,n=null;for(let o of t){let s=e.getStatus(o);r[o]=s,s.hasError&&s.lastError&&!n&&(n=s.lastError),s.isLoading&&(u=true);}if(n)throw n;if(u){let o=j(e),s=t.slice().sort().join(","),i=o.get(s);throw i||(i=new Promise(f=>{let d=e.subscribe(()=>{t.every(g=>!e.getStatus(g).isLoading)&&(o.delete(s),d(),f());});}),o.set(s,i)),i}return r}function V(e,t){let r=react.useRef(null),u=react.useRef(null),n=react.useRef(null),o=t?.status===true,s="modules"in e;return r.current||(n.current=()=>{if(s){let{modules:N,...m}=e,k=t?.plugins??m.plugins??[],I=t?.debug??m.debug,p=t?.errorBoundary??m.errorBoundary,S=t?.tickMs??m.tickMs,E=t?.zeroConfig??m.zeroConfig,q=t?.initialFacts??m.initialFacts,w=core.createSystem({modules:N,plugins:k.length>0?k:void 0,debug:I,errorBoundary:p,tickMs:S,zeroConfig:E,initialFacts:q});return w.initialize(),typeof window<"u"&&w.start(),w}let i="id"in e&&"schema"in e,f=i?e:e.module,d=i?{}:e,c=t?.plugins??d.plugins??[],g=t?.debug??d.debug,v=t?.errorBoundary??d.errorBoundary,M=t?.tickMs??d.tickMs,y=t?.zeroConfig??d.zeroConfig,x=t?.initialFacts??d.initialFacts,R=[...c];o&&(u.current=core.createRequirementStatusPlugin(),R=[...R,u.current.plugin]);let F=core.createSystem({module:f,plugins:R.length>0?R:void 0,debug:g,errorBoundary:v,tickMs:M,zeroConfig:y,initialFacts:x});return F.initialize(),typeof window<"u"&&F.start(),F},r.current=n.current()),react.useEffect(()=>(!r.current&&n.current&&(r.current=n.current()),()=>{r.current?.destroy(),r.current=null,u.current=null;}),[]),o&&!s?{system:r.current,statusPlugin:u.current}:r.current}function we(e,t,r){let u=react.useRef(t);u.current=t;let n=react.useRef(r);n.current=r;let o=react.useCallback(i=>e.subscribe(u.current,i),[e]),s=react.useCallback(()=>n.current(e),[e]);return react.useSyncExternalStore(o,s,s)}function Ke(e,t={}){let{facts:r,derived:u,status:n,...o}=t,s=r??[],i=u??[],f=s.length===0&&i.length===0,d=n?V(e,{status:true,...o}):V(e,o),c=n?d.system:d,g=n?d.statusPlugin:void 0,v=react.useMemo(()=>f?Object.keys(c.derive):[],[c,f]),M=react.useCallback(p=>{let S=[];return f?(S.push(c.facts.$store.subscribeAll(p)),v.length>0&&S.push(c.subscribe(v,p))):(s.length>0&&S.push(c.facts.$store.subscribe(s,p)),i.length>0&&S.push(c.subscribe(i,p))),()=>{for(let E of S)E();}},[c,f,...s,...i,...v]),y=react.useRef(h),x=react.useRef(h),R=react.useRef(null),F=react.useCallback(()=>{let p,S,E,q;if(f){p=c.facts.$store.toObject(),E=Object.keys(p),S={};for(let b of v)S[b]=c.read(b);q=v;}else {p={};for(let b of s)p[b]=c.facts[b];E=s,S={};for(let b of i)S[b]=c.read(b);q=i;}let w=y.current!==h;if(w){let b=y.current;if(Object.keys(b).length!==E.length)w=false;else for(let T of E)if(!Object.is(b[T],p[T])){w=false;break}}let C=x.current!==h;if(C){let b=x.current;if(Object.keys(b).length!==q.length)C=false;else for(let T of q)if(!Object.is(b[T],S[T])){C=false;break}}let z=w?y.current:p,W=C?x.current:S;return w||(y.current=p),C||(x.current=S),w&&C&&R.current||(R.current={facts:z,derived:W}),R.current},[c,f,...s,...i,...v]),N=react.useSyncExternalStore(M,F,F),m=react.useCallback(p=>c.dispatch(p),[c]),k=Se(c),I={system:c,dispatch:m,events:k,facts:N.facts,derived:N.derived};return n&&g?{...I,statusPlugin:g}:I}function Se(e){return adapterUtils.assertSystem("useEvents",e),react.useMemo(()=>e.events,[e])}function Fe(e,t){adapterUtils.assertSystem("useExplain",e);let r=react.useCallback(n=>{let o=e.facts.$store.subscribeAll(n),s=e.onSettledChange(n);return ()=>{o(),s();}},[e]),u=react.useCallback(()=>e.explain(t),[e,t]);return react.useSyncExternalStore(r,u,u)}function Ee(e,t){adapterUtils.assertSystem("useConstraintStatus",e);let r=oe(e);return react.useMemo(()=>{let u=e.inspect();return t?u.constraints.find(n=>n.id===t)??null:u.constraints},[e,t,r])}function Ne(e,t,r){adapterUtils.assertSystem("useOptimisticUpdate",e);let[u,n]=react.useState(false),[o,s]=react.useState(null),i=react.useRef(null),f=react.useCallback(()=>{i.current&&(e.restore(i.current),i.current=null),n(false),s(null);},[e]),d=react.useCallback(c=>{i.current=e.getSnapshot(),n(true),s(null),e.batch(c);},[e]);return react.useEffect(()=>{if(!(!t||!r||!u))return t.subscribe(()=>{let c=t.getStatus(r);!c.isLoading&&!c.hasError?(i.current=null,n(false)):c.hasError&&(s(c.lastError),f());})},[t,r,u,f]),{mutate:d,isPending:u,error:o,rollback:f}}var A=react.createContext(null);function qe({snapshot:e,children:t}){return jsxRuntime.jsx(A.Provider,{value:e,children:t})}function Ce(e,t){let r=react.useContext(A),u=react.useMemo(()=>r?.data?{...t??{},initialFacts:{...t?.initialFacts??{},...r.data}}:t??{},[r,t]);return V(e,u)}Object.defineProperty(exports,"shallowEqual",{enumerable:true,get:function(){return adapterUtils.shallowEqual}});exports.DirectiveHydrator=qe;exports.useConstraintStatus=Ee;exports.useDerived=be;exports.useDirective=Ke;exports.useDirectiveRef=V;exports.useDispatch=Me;exports.useEvents=Se;exports.useExplain=Fe;exports.useFact=Re;exports.useHydratedSystem=Ce;exports.useInspect=oe;exports.useNamespacedSelector=we;exports.useOptimisticUpdate=Ne;exports.useRequirementStatus=ke;exports.useSelector=he;exports.useSuspenseRequirement=Ie;exports.useTimeTravel=xe;exports.useWatch=De;//# sourceMappingURL=index.cjs.map
+'use strict';var core=require('@directive-run/core'),adapterUtils=require('@directive-run/core/adapter-utils'),react=require('react'),jsxRuntime=require('react/jsx-runtime');var h=Symbol("directive.uninitialized");function me(e,t){return adapterUtils.assertSystem("useFact",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useFact() received a function. Did you mean useSelector()? useFact() takes a string key or array of keys, not a selector function."),Array.isArray(t)?ne(e,t):te(e,t)}function te(e,t){process.env.NODE_ENV!=="production"&&(t in e.facts.$store.toObject()||console.warn(`[Directive] useFact("${t}") \u2014 fact not found in store. Check that "${t}" is defined in your module's schema.`));let r=react.useCallback(n=>e.facts.$store.subscribe([t],n),[e,t]),o=react.useCallback(()=>e.facts.$store.get(t),[e,t]);return react.useSyncExternalStore(r,o,o)}function ne(e,t){let r=react.useRef(h),o=react.useCallback(u=>e.facts.$store.subscribe(t,u),[e,...t]),n=react.useCallback(()=>{let u={};for(let s of t)u[s]=e.facts.$store.get(s);if(r.current!==h){let s=true;for(let i of t)if(!Object.is(r.current[i],u[i])){s=false;break}if(s)return r.current}return r.current=u,u},[e,...t]);return react.useSyncExternalStore(o,n,n)}function he(e,t){return adapterUtils.assertSystem("useDerived",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useDerived() received a function. Did you mean useSelector()? useDerived() takes a string key or array of keys, not a selector function."),Array.isArray(t)?se(e,t):re(e,t)}function re(e,t){process.env.NODE_ENV!=="production"&&(t in e.derive||console.warn(`[Directive] useDerived("${t}") \u2014 derivation not found. Check that "${t}" is defined in your module's derive property.`));let r=react.useCallback(n=>e.subscribe([t],n),[e,t]),o=react.useCallback(()=>e.read(t),[e,t]);return react.useSyncExternalStore(r,o,o)}function se(e,t){let r=react.useRef(h),o=react.useCallback(u=>e.subscribe(t,u),[e,...t]),n=react.useCallback(()=>{let u={};for(let s of t)u[s]=e.read(s);if(r.current!==h){let s=true;for(let i of t)if(!Object.is(r.current[i],u[i])){s=false;break}if(s)return r.current}return r.current=u,u},[e,...t]);return react.useSyncExternalStore(o,n,n)}function be(e,t,r,o){if(e&&e._mode==="namespaced")return oe(e,t,r,o);let n=e,u,s=false,i=o??adapterUtils.defaultEquality;r!==void 0&&(u=r,s=true),process.env.NODE_ENV!=="production"&&!n&&!s&&console.error("[Directive] useSelector() received a null/undefined system without a default value. Provide a default value as the 3rd parameter: useSelector(system, selector, defaultValue)");let f=react.useRef(t),l=react.useRef(i),c=react.useRef(u);f.current=t,l.current=i,c.current=u;let g=react.useRef([]),v=react.useRef([]),b=react.useRef(h),y=react.useRef([]),k=react.useMemo(()=>n?new Set(Object.keys(n.derive)):new Set,[n]),M=react.useCallback(()=>n?adapterUtils.runTrackedSelector(n,k,f.current):{value:c.current,factKeys:[],deriveKeys:[]},[n,k]),K=react.useCallback(D=>{if(!n)return ()=>{};let R=()=>{for(let S of y.current)S();y.current=[];let{factKeys:I,deriveKeys:p}=M();g.current=I,v.current=p,I.length>0?y.current.push(n.facts.$store.subscribe(I,()=>{let S=M();adapterUtils.depsChanged(g.current,S.factKeys,v.current,S.deriveKeys)&&R(),D();})):p.length===0&&y.current.push(n.facts.$store.subscribeAll(D)),p.length>0&&y.current.push(n.subscribe(p,()=>{let S=M();adapterUtils.depsChanged(g.current,S.factKeys,v.current,S.deriveKeys)&&R(),D();}));};return R(),()=>{for(let I of y.current)I();y.current=[];}},[n,M]),F=react.useCallback(()=>{let D;if(!n)D=c.current;else {let{value:R}=M();D=R===void 0&&s?c.current:R;}return b.current!==h&&l.current(b.current,D)?b.current:(b.current=D,D)},[M,n,s]);return react.useSyncExternalStore(K,F,F)}function oe(e,t,r,o){let n=r!==void 0,u=o??adapterUtils.defaultEquality,s=react.useRef(t),i=react.useRef(u),f=react.useRef(r);s.current=t,i.current=u,f.current=r;let l=react.useRef(h),c=react.useMemo(()=>Object.keys(e.facts),[e]),g=react.useCallback(b=>{let y=c.map(k=>`${k}.*`);return e.subscribe(y,b)},[e,c]),v=react.useCallback(()=>{let b=s.current(e),y=b===void 0&&n?f.current:b;return l.current!==h&&i.current(l.current,y)?l.current:(l.current=y,y)},[e,n]);return react.useSyncExternalStore(g,v,v)}function Me(e){return adapterUtils.assertSystem("useDispatch",e),react.useCallback(t=>{e.dispatch(t);},[e])}function De(e,t,r){adapterUtils.assertSystem("useWatch",e);let o=react.useRef(r);o.current=r,react.useEffect(()=>e.watch(t,(n,u)=>{o.current(n,u);}),[e,t]);}function ue(e,t){adapterUtils.assertSystem("useInspect",e);let r=ce(e),o=t?.throttleMs,[n,u]=react.useState(r),s=react.useRef(null);return react.useEffect(()=>{if(!o||o<=0){s.current?.cleanup(),s.current=null;return}return s.current?.cleanup(),s.current=adapterUtils.createThrottle((...i)=>{u(i[0]);},o),()=>{s.current?.cleanup(),s.current=null;}},[o]),react.useEffect(()=>{s.current&&s.current.throttled(r);},[r]),!o||o<=0?r:n}function ie(e){return adapterUtils.computeInspectState(e)}function ce(e){let t=react.useRef(null),r=react.useRef([]),o=react.useRef([]),n=react.useRef(null),u=react.useCallback(i=>{let f=e.facts.$store.subscribeAll(i),l=e.onSettledChange(i);return ()=>{f(),l();}},[e]),s=react.useCallback(()=>{let i=ie(e),f=i.unmet.length===r.current.length&&i.unmet.every((g,v)=>g.id===r.current[v]),l=i.inflight.length===o.current.length&&i.inflight.every((g,v)=>g.id===o.current[v]),c=i.isSettled===n.current;return f&&l&&c&&t.current?t.current:(t.current=i,r.current=i.unmet.map(g=>g.id),o.current=i.inflight.map(g=>g.id),n.current=i.isSettled,i)},[e]);return react.useSyncExternalStore(u,s,s)}function xe(e){adapterUtils.assertSystem("useHistory",e);let t=react.useRef(null),r=react.useCallback(n=>e.onHistoryChange(n),[e]),o=react.useCallback(()=>{let n=adapterUtils.buildHistoryState(e);return n?(t.current&&t.current.canGoBack===n.canGoBack&&t.current.canGoForward===n.canGoForward&&t.current.currentIndex===n.currentIndex&&t.current.totalSnapshots===n.totalSnapshots&&t.current.isPaused===n.isPaused||(t.current=n),t.current):null},[e]);return react.useSyncExternalStore(r,o,o)}function ke(e,t){return Array.isArray(t)?le(e,t):ae(e,t)}function ae(e,t){let r=react.useRef(h),o=react.useCallback(u=>e.subscribe(u),[e]),n=react.useCallback(()=>{let u=e.getStatus(t);if(r.current!==h){let s=r.current;if(s.pending===u.pending&&s.inflight===u.inflight&&s.failed===u.failed&&s.isLoading===u.isLoading&&s.hasError===u.hasError&&s.lastError===u.lastError)return r.current}return r.current=u,u},[e,t]);return react.useSyncExternalStore(o,n,n)}function le(e,t){let r=react.useRef(null),o=react.useRef(""),n=react.useCallback(s=>e.subscribe(s),[e]),u=react.useCallback(()=>{let s={},i=[];for(let l of t){let c=e.getStatus(l);s[l]=c,i.push(`${l}:${c.pending}:${c.inflight}:${c.failed}:${c.hasError}:${c.lastError?.message??""}`);}let f=i.join("|");return f!==o.current&&(o.current=f,r.current=s),r.current??s},[e,...t]);return react.useSyncExternalStore(n,u,u)}var H=new WeakMap;function j(e){let t=H.get(e);return t||(t=new Map,H.set(e,t)),t}function Ie(e,t){return Array.isArray(t)?fe(e,t):de(e,t)}function de(e,t){let r=e.getStatus(t);if(r.hasError&&r.lastError)throw r.lastError;if(r.isLoading){let o=j(e),n=o.get(t);throw n||(n=new Promise(u=>{let s=e.subscribe(()=>{e.getStatus(t).isLoading||(o.delete(t),s(),u());});}),o.set(t,n)),n}return r}function fe(e,t){let r={},o=false,n=null;for(let u of t){let s=e.getStatus(u);r[u]=s,s.hasError&&s.lastError&&!n&&(n=s.lastError),s.isLoading&&(o=true);}if(n)throw n;if(o){let u=j(e),s=t.slice().sort().join(","),i=u.get(s);throw i||(i=new Promise(f=>{let l=e.subscribe(()=>{t.every(g=>!e.getStatus(g).isLoading)&&(u.delete(s),l(),f());});}),u.set(s,i)),i}return r}function $(e,t){let r=react.useRef(null),o=react.useRef(null),n=react.useRef(null),u=t?.status===true,s="modules"in e;return r.current||(n.current=()=>{if(s){let{modules:D,...R}=e,I=t?.plugins??R.plugins??[],p=t?.history??R.history,S=t?.trace??R.trace,E=t?.errorBoundary??R.errorBoundary,P=t?.tickMs??R.tickMs,N=t?.zeroConfig??R.zeroConfig,q=t?.initialFacts??R.initialFacts,U=core.createSystem({modules:D,plugins:I.length>0?I:void 0,history:p,trace:S,errorBoundary:E,tickMs:P,zeroConfig:N,initialFacts:q});return U.initialize(),typeof window<"u"&&U.start(),U}let i="id"in e&&"schema"in e,f=i?e:e.module,l=i?{}:e,c=t?.plugins??l.plugins??[],g=t?.history??l.history,v=t?.trace??l.trace,b=t?.errorBoundary??l.errorBoundary,y=t?.tickMs??l.tickMs,k=t?.zeroConfig??l.zeroConfig,M=t?.initialFacts??l.initialFacts,K=[...c];u&&(o.current=core.createRequirementStatusPlugin(),K=[...K,o.current.plugin]);let F=core.createSystem({module:f,plugins:K.length>0?K:void 0,history:g,trace:v,errorBoundary:b,tickMs:y,zeroConfig:k,initialFacts:M});return F.initialize(),typeof window<"u"&&F.start(),F},r.current=n.current()),react.useEffect(()=>(!r.current&&n.current&&(r.current=n.current()),()=>{r.current?.destroy(),r.current=null,o.current=null;}),[]),u&&!s?{system:r.current,statusPlugin:o.current}:r.current}function we(e,t,r){let o=react.useRef(t);o.current=t;let n=react.useRef(r);n.current=r;let u=react.useCallback(i=>e.subscribe(o.current,i),[e]),s=react.useCallback(()=>n.current(e),[e]);return react.useSyncExternalStore(u,s,s)}function Ke(e,t={}){let{facts:r,derived:o,status:n,...u}=t,s=r??[],i=o??[],f=s.length===0&&i.length===0,l=n?$(e,{status:true,...u}):$(e,u),c=n?l.system:l,g=n?l.statusPlugin:void 0,v=react.useMemo(()=>f?Object.keys(c.derive):[],[c,f]),b=react.useCallback(p=>{let S=[];return f?(S.push(c.facts.$store.subscribeAll(p)),v.length>0&&S.push(c.subscribe(v,p))):(s.length>0&&S.push(c.facts.$store.subscribe(s,p)),i.length>0&&S.push(c.subscribe(i,p))),()=>{for(let E of S)E();}},[c,f,...s,...i,...v]),y=react.useRef(h),k=react.useRef(h),M=react.useRef(null),K=react.useCallback(()=>{let p,S,E,P;if(f){p=c.facts.$store.toObject(),E=Object.keys(p),S={};for(let m of v)S[m]=c.read(m);P=v;}else {p={};for(let m of s)p[m]=c.facts[m];E=s,S={};for(let m of i)S[m]=c.read(m);P=i;}let N=y.current!==h;if(N){let m=y.current;if(Object.keys(m).length!==E.length)N=false;else for(let O of E)if(!Object.is(m[O],p[O])){N=false;break}}let q=k.current!==h;if(q){let m=k.current;if(Object.keys(m).length!==P.length)q=false;else for(let O of P)if(!Object.is(m[O],S[O])){q=false;break}}let U=N?y.current:p,z=q?k.current:S;return N||(y.current=p),q||(k.current=S),N&&q&&M.current||(M.current={facts:U,derived:z}),M.current},[c,f,...s,...i,...v]),F=react.useSyncExternalStore(b,K,K),D=react.useCallback(p=>c.dispatch(p),[c]),R=Se(c),I={system:c,dispatch:D,events:R,facts:F.facts,derived:F.derived};return n&&g?{...I,statusPlugin:g}:I}function Se(e){return adapterUtils.assertSystem("useEvents",e),react.useMemo(()=>e.events,[e])}function Fe(e,t){adapterUtils.assertSystem("useExplain",e);let r=react.useCallback(n=>{let u=e.facts.$store.subscribeAll(n),s=e.onSettledChange(n);return ()=>{u(),s();}},[e]),o=react.useCallback(()=>e.explain(t),[e,t]);return react.useSyncExternalStore(r,o,o)}function Ee(e,t){adapterUtils.assertSystem("useConstraintStatus",e);let r=ue(e);return react.useMemo(()=>{let o=e.inspect();return t?o.constraints.find(n=>n.id===t)??null:o.constraints},[e,t,r])}function Ne(e,t,r){adapterUtils.assertSystem("useOptimisticUpdate",e);let[o,n]=react.useState(false),[u,s]=react.useState(null),i=react.useRef(null),f=react.useCallback(()=>{i.current&&(e.restore(i.current),i.current=null),n(false),s(null);},[e]),l=react.useCallback(c=>{i.current=e.getSnapshot(),n(true),s(null),e.batch(c);},[e]);return react.useEffect(()=>{if(!(!t||!r||!o))return t.subscribe(()=>{let c=t.getStatus(r);!c.isLoading&&!c.hasError?(i.current=null,n(false)):c.hasError&&(s(c.lastError),f());})},[t,r,o,f]),{mutate:l,isPending:o,error:u,rollback:f}}var A=react.createContext(null);function qe({snapshot:e,children:t}){return jsxRuntime.jsx(A.Provider,{value:e,children:t})}function Pe(e,t){let r=react.useContext(A),o=react.useMemo(()=>r?.data?{...t??{},initialFacts:{...t?.initialFacts??{},...r.data}}:t??{},[r,t]);return $(e,o)}Object.defineProperty(exports,"shallowEqual",{enumerable:true,get:function(){return adapterUtils.shallowEqual}});exports.DirectiveHydrator=qe;exports.useConstraintStatus=Ee;exports.useDerived=he;exports.useDirective=Ke;exports.useDirectiveRef=$;exports.useDispatch=Me;exports.useEvents=Se;exports.useExplain=Fe;exports.useFact=me;exports.useHistory=xe;exports.useHydratedSystem=Pe;exports.useInspect=ue;exports.useNamespacedSelector=we;exports.useOptimisticUpdate=Ne;exports.useRequirementStatus=ke;exports.useSelector=be;exports.useSuspenseRequirement=Ie;exports.useWatch=De;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.tsx"],"names":["UNINITIALIZED","useFact","system","keyOrKeys","assertSystem","_useFacts","_useSingleFact","factKey","subscribe","useCallback","onStoreChange","getSnapshot","useSyncExternalStore","factKeys","cachedValue","useRef","result","key","same","useDerived","_useDerivedMulti","_useSingleDerived","derivationId","derivationIds","id","useSelector","systemArg","selector","defaultValueArg","equalityFnArg","_useNamespacedSelectorImpl","defaultValue","hasDefault","equalityFn","defaultEquality","selectorRef","eqRef","defaultValueRef","trackedFactKeysRef","trackedDeriveKeysRef","unsubsRef","deriveKeys","useMemo","runWithTracking","runTrackedSelector","resubscribe","unsub","derivedKeys","updated","depsChanged","effectiveValue","newValue","moduleNames","wildcardKeys","ns","useDispatch","event","useWatch","callback","callbackRef","useEffect","prevValue","useInspect","options","syncState","_useInspectSync","throttleMs","deferredState","setDeferredState","useState","throttleRef","createThrottle","args","_buildInspectState","computeInspectState","cachedSnapshot","cachedUnmetIds","cachedInflightIds","cachedIsSettled","unsubFacts","unsubSettled","state","unmetSame","u","i","inflightSame","f","settledSame","useTimeTravel","cachedRef","buildTimeTravelState","useRequirementStatus","statusPlugin","typeOrTypes","_useRequirementStatusMulti","_useRequirementStatusSingle","type","status","prev","types","cachedKey","parts","suspenseCacheMap","getSuspenseCache","plugin","cache","useSuspenseRequirement","_useSuspenseRequirementMulti","_useSuspenseRequirementSingle","promise","resolve","unsubscribe","hasLoading","firstError","cacheKey","t","useDirectiveRef","config","systemRef","statusPluginRef","factoryRef","wantStatus","isNamespaced","modules","rest","plugins","debug","errorBoundary","tickMs","zeroConfig","initialFacts","sys","createSystem","isModule","mod","baseOpts","allPlugins","createRequirementStatusPlugin","useNamespacedSelector","keys","keysRef","useDirective","moduleOrOptions","selections","factKeysOpt","derivedKeysOpt","configRest","subscribeAll","refResult","allDerivationKeys","unsubs","cachedFacts","cachedDerived","cachedWrapper","factsResult","derivedResult","effectiveFactKeys","effectiveDerivedKeys","factsSame","derivedSame","stableFacts","stableDerived","values","dispatch","events","useEvents","base","useExplain","requirementId","useConstraintStatus","constraintId","inspectState","inspection","c","useOptimisticUpdate","requirementType","isPending","setIsPending","error","setError","snapshotRef","rollback","mutate","updateFn","HydrationContext","createContext","DirectiveHydrator","snapshot","children","jsx","useHydratedSystem","moduleDef","useContext","mergedConfig"],"mappings":"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","file":"index.cjs","sourcesContent":["/*\n React Adapter - Consolidated hooks for React integration\n \n 18 public exports: useFact, useDerived, useDispatch, useDirective,\n * useDirectiveRef, useSelector, useWatch, useInspect, useRequirementStatus,\n * useSuspenseRequirement, useEvents, useExplain, useConstraintStatus,\n * useOptimisticUpdate, DirectiveHydrator, useHydratedSystem,\n * useTimeTravel, shallowEqual\n \n @example\n * ```tsx\n * import { useFact, useDerived, useEvents } from '@directive-run/react';\n \n const system = createSystem({ module: counterModule });\n * system.start();\n \n function Counter() {\n * const count = useFact(system, \"count\");\n * const doubled = useDerived(system, \"doubled\");\n * const events = useEvents(system);\n \n return (\n * <div>\n * <p>Count: {count}</p>\n * <p>Doubled: {doubled}</p>\n * <button onClick={() => events.increment()}>+</button>\n * </div>\n * );\n * }\n * ```\n /\n\nimport type {\n DebugConfig,\n DistributableSnapshot,\n ErrorBoundaryConfig,\n InferDerivations,\n InferEvents,\n InferFacts,\n InferSelectorState,\n ModuleDef,\n ModuleSchema,\n ModulesMap,\n NamespacedSystem,\n Plugin,\n SingleModuleSystem,\n SystemSnapshot,\n TimeTravelState,\n} from \"@directive-run/core\";\nimport {\n createRequirementStatusPlugin,\n createSystem,\n} from \"@directive-run/core\";\nimport type { RequirementTypeStatus } from \"@directive-run/core\";\nimport {\n type ConstraintInfo,\n type InspectState,\n assertSystem,\n buildTimeTravelState,\n computeInspectState,\n createThrottle,\n defaultEquality,\n depsChanged,\n runTrackedSelector,\n shallowEqual,\n} from \"@directive-run/core/adapter-utils\";\nimport type { ReactNode } from \"react\";\nimport {\n createContext,\n useCallback,\n useContext,\n useEffect,\n useMemo,\n useRef,\n useState,\n useSyncExternalStore,\n} from \"react\";\n\n// Re-export for convenience\nexport type { RequirementTypeStatus, InspectState, ConstraintInfo };\nexport { shallowEqual };\n\n/* Type for the requirement status plugin return value /\nexport type StatusPlugin = ReturnType<typeof createRequirementStatusPlugin>;\n\n// ============================================================================\n// Internal Helpers\n// ============================================================================\n\n/* Sentinel value for uninitialized selector cache /\nconst UNINITIALIZED = Symbol(\"directive.uninitialized\");\n\n// ============================================================================\n// useFact — single key or multi key\n// ============================================================================\n\n/* Single key overload /\nexport function useFact<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(system: SingleModuleSystem<S>, factKey: K): InferFacts<S>[K] \| undefined;\n\n/* Multi-key overload /\nexport function useFact<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(system: SingleModuleSystem<S>, factKeys: K[]): Pick<InferFacts<S>, K>;\n\n/* Implementation /\nexport function useFact(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n keyOrKeys: string \| string[],\n): unknown {\n assertSystem(\"useFact\", system);\n if (\n process.env.NODE_ENV !== \"production\" &&\n typeof keyOrKeys === \"function\"\n ) {\n console.error(\n \"[Directive] useFact() received a function. Did you mean useSelector()? \" +\n \"useFact() takes a string key or array of keys, not a selector function.\",\n );\n }\n\n // Multi-key path: useFact(system, [keys])\n if (Array.isArray(keyOrKeys)) {\n return _useFacts(system, keyOrKeys);\n }\n\n // Single key path: useFact(system, key)\n return _useSingleFact(system, keyOrKeys);\n}\n\nfunction _useSingleFact(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n factKey: string,\n): unknown {\n if (process.env.NODE_ENV !== \"production\") {\n if (!(factKey in system.facts.$store.toObject())) {\n console.warn(\n `[Directive] useFact(\"${factKey}\") — fact not found in store. ` +\n `Check that \"${factKey}\" is defined in your module's schema.`,\n );\n }\n }\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.facts.$store.subscribe([factKey], onStoreChange);\n },\n [system, factKey],\n );\n\n const getSnapshot = useCallback(() => {\n // biome-ignore lint/suspicious/noExplicitAny: Dynamic fact access\n return (system.facts as any)[factKey];\n }, [system, factKey]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction _useFacts(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n factKeys: string[],\n): Record<string, unknown> {\n const cachedValue = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.facts.$store.subscribe(factKeys, onStoreChange);\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [system, ...factKeys],\n );\n\n const getSnapshot = useCallback(() => {\n const result: Record<string, unknown> = {};\n for (const key of factKeys) {\n // biome-ignore lint/suspicious/noExplicitAny: Dynamic fact access\n result[key] = (system.facts as any)[key];\n }\n\n if (cachedValue.current !== UNINITIALIZED) {\n let same = true;\n for (const key of factKeys) {\n if (\n !Object.is(\n (cachedValue.current as Record<string, unknown>)[key],\n result[key],\n )\n ) {\n same = false;\n break;\n }\n }\n if (same) return cachedValue.current;\n }\n\n cachedValue.current = result;\n return result;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, ...factKeys]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useDerived — single key or multi key\n// ============================================================================\n\n/* Single key overload /\nexport function useDerived<\n S extends ModuleSchema,\n K extends keyof InferDerivations<S> & string,\n>(system: SingleModuleSystem<S>, derivationId: K): InferDerivations<S>[K];\n\n/* Multi-key overload /\nexport function useDerived<\n S extends ModuleSchema,\n K extends keyof InferDerivations<S> & string,\n>(\n system: SingleModuleSystem<S>,\n derivationIds: K[],\n): Pick<InferDerivations<S>, K>;\n\n/* Implementation /\nexport function useDerived(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n keyOrKeys: string \| string[],\n): unknown {\n assertSystem(\"useDerived\", system);\n if (\n process.env.NODE_ENV !== \"production\" &&\n typeof keyOrKeys === \"function\"\n ) {\n console.error(\n \"[Directive] useDerived() received a function. Did you mean useSelector()? \" +\n \"useDerived() takes a string key or array of keys, not a selector function.\",\n );\n }\n\n // Multi-key path\n if (Array.isArray(keyOrKeys)) {\n return _useDerivedMulti(system, keyOrKeys);\n }\n\n // Single key path\n return _useSingleDerived(system, keyOrKeys);\n}\n\nfunction _useSingleDerived(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n derivationId: string,\n): unknown {\n if (process.env.NODE_ENV !== \"production\") {\n if (!(derivationId in system.derive)) {\n console.warn(\n `[Directive] useDerived(\"${derivationId}\") — derivation not found. ` +\n `Check that \"${derivationId}\" is defined in your module's derive property.`,\n );\n }\n }\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.subscribe([derivationId], onStoreChange);\n },\n [system, derivationId],\n );\n\n const getSnapshot = useCallback(() => {\n return system.read(derivationId);\n }, [system, derivationId]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction _useDerivedMulti(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n derivationIds: string[],\n): Record<string, unknown> {\n const cachedValue = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.subscribe(derivationIds, onStoreChange);\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [system, ...derivationIds],\n );\n\n const getSnapshot = useCallback(() => {\n const result: Record<string, unknown> = {};\n for (const id of derivationIds) {\n result[id] = system.read(id);\n }\n\n if (cachedValue.current !== UNINITIALIZED) {\n let same = true;\n for (const id of derivationIds) {\n if (\n !Object.is(\n (cachedValue.current as Record<string, unknown>)[id],\n result[id],\n )\n ) {\n same = false;\n break;\n }\n }\n if (same) return cachedValue.current;\n }\n\n cachedValue.current = result;\n return result;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, ...derivationIds]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useSelector — Zustand-style selector over facts and derivations\n// ============================================================================\n\n/\n Auto-tracking selector over facts and derivations (Zustand-style).\n * Uses `withTracking()` to detect which facts the selector accesses,\n * then subscribes only to those keys. Falls back to subscribeAll\n * if no keys are detected.\n \n Supports an optional default value as the 3rd parameter, used when\n * the system is null/undefined or the selector returns undefined.\n * When a default value is provided, the system parameter may be\n * null \| undefined — the hook returns the default and recomputes\n * when the system becomes available.\n \n An optional equality function can be passed as the 4th parameter\n * to customize when the selector result is considered \"changed\".\n * Defaults to `Object.is`. Use `shallowEqual` (exported from this\n * package) when your selector returns a new object/array each time.\n \n @example\n * ```tsx\n * // Basic usage\n * const count = useSelector(system, (s) => s.count);\n \n // With default value (allows nullable system)\n * const count = useSelector(system, (s) => s.count, 0);\n \n // With default value + custom equality\n * const coords = useSelector(system, (s) => ({ x: s.x, y: s.y }), { x: 0, y: 0 }, shallowEqual);\n * ```\n /\n\n// Non-null system, no default\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S>,\n selector: (state: InferSelectorState<S>) => R,\n): R;\n\n// Non-null system, with default value and optional equality\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S>,\n selector: (state: InferSelectorState<S>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// Nullable system, default REQUIRED\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S> \| null \| undefined,\n selector: (state: InferSelectorState<S>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// --- Namespaced system overloads ---\n\n// Namespaced system, no default\nexport function useSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n selector: (state: NamespacedSystem<Modules>) => R,\n): R;\n\n// Namespaced system, with default value and optional equality\nexport function useSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n selector: (state: NamespacedSystem<Modules>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// Nullable namespaced system, default REQUIRED\nexport function useSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules> \| null \| undefined,\n selector: (state: NamespacedSystem<Modules>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// --- Generic fallbacks ---\n\n// Generic fallback: non-null system\nexport function useSelector<R>(\n // biome-ignore lint/suspicious/noExplicitAny: Generic fallback\n system: SingleModuleSystem<any>,\n // biome-ignore lint/suspicious/noExplicitAny: Selector receives dynamic state\n selector: (state: Record<string, any>) => R,\n defaultValue?: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// Generic fallback: nullable system\nexport function useSelector<R>(\n // biome-ignore lint/suspicious/noExplicitAny: Generic fallback\n system: SingleModuleSystem<any> \| null \| undefined,\n // biome-ignore lint/suspicious/noExplicitAny: Selector receives dynamic state\n selector: (state: Record<string, any>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\nexport function useSelector(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature accepts both system types\n systemArg: SingleModuleSystem<any> \| NamespacedSystem<any> \| null \| undefined,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n selector: (state: any) => unknown,\n defaultValueArg?: unknown,\n equalityFnArg?: (a: unknown, b: unknown) => boolean,\n): unknown {\n // Route to namespaced implementation if system is a NamespacedSystem\n // biome-ignore lint/suspicious/noExplicitAny: Runtime type check\n if (systemArg && (systemArg as any)._mode === \"namespaced\") {\n // biome-ignore lint/suspicious/noExplicitAny: Delegate to namespaced impl\n return _useNamespacedSelectorImpl(\n systemArg as NamespacedSystem<any>,\n selector,\n defaultValueArg,\n equalityFnArg,\n );\n }\n\n // After the namespaced check, system is a SingleModuleSystem\n const system = systemArg as SingleModuleSystem<any> \| null \| undefined;\n let defaultValue: unknown;\n let hasDefault = false;\n const equalityFn: (a: unknown, b: unknown) => boolean =\n equalityFnArg ?? defaultEquality;\n\n if (defaultValueArg !== undefined) {\n defaultValue = defaultValueArg;\n hasDefault = true;\n }\n\n // Dev-mode warning: null system without a default value\n if (process.env.NODE_ENV !== \"production\") {\n if (!system && !hasDefault) {\n console.error(\n \"[Directive] useSelector() received a null/undefined system without a default value. \" +\n \"Provide a default value as the 3rd parameter: useSelector(system, selector, defaultValue)\",\n );\n }\n }\n\n // Store selector/eq/default in refs to avoid resubscription churn\n const selectorRef = useRef(selector);\n const eqRef = useRef(equalityFn);\n const defaultValueRef = useRef(defaultValue);\n selectorRef.current = selector;\n eqRef.current = equalityFn;\n defaultValueRef.current = defaultValue;\n\n const trackedFactKeysRef = useRef<string[]>([]);\n const trackedDeriveKeysRef = useRef<string[]>([]);\n const cachedValue = useRef<unknown>(UNINITIALIZED);\n const unsubsRef = useRef<Array<() => void>>([]);\n\n // Build a tracking-aware state proxy that exposes both facts and derivations\n const deriveKeys = useMemo(\n () => (system ? new Set(Object.keys(system.derive)) : new Set<string>()),\n [system],\n );\n\n const runWithTracking = useCallback(() => {\n if (!system) {\n return {\n value: defaultValueRef.current,\n factKeys: [] as string[],\n deriveKeys: [] as string[],\n };\n }\n\n return runTrackedSelector(system, deriveKeys, selectorRef.current);\n }, [system, deriveKeys]);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n if (!system) {\n // No system — return noop unsubscribe\n return () => {};\n }\n\n const resubscribe = () => {\n // Cleanup previous subscriptions\n for (const unsub of unsubsRef.current) unsub();\n unsubsRef.current = [];\n\n // Run selector with tracking to detect accessed keys\n const { factKeys, deriveKeys: derivedKeys } = runWithTracking();\n trackedFactKeysRef.current = factKeys;\n trackedDeriveKeysRef.current = derivedKeys;\n\n // Subscribe to accessed fact keys\n if (factKeys.length > 0) {\n unsubsRef.current.push(\n system.facts.$store.subscribe(factKeys, () => {\n // Re-track on notification for dynamic deps\n const updated = runWithTracking();\n if (\n depsChanged(\n trackedFactKeysRef.current,\n updated.factKeys,\n trackedDeriveKeysRef.current,\n updated.deriveKeys,\n )\n )\n resubscribe();\n onStoreChange();\n }),\n );\n } else if (derivedKeys.length === 0) {\n // No deps at all — subscribe to everything\n unsubsRef.current.push(\n system.facts.$store.subscribeAll(onStoreChange),\n );\n }\n\n // Subscribe to accessed derivation keys\n if (derivedKeys.length > 0) {\n unsubsRef.current.push(\n system.subscribe(derivedKeys, () => {\n // Re-track on notification for dynamic deps\n const updated = runWithTracking();\n if (\n depsChanged(\n trackedFactKeysRef.current,\n updated.factKeys,\n trackedDeriveKeysRef.current,\n updated.deriveKeys,\n )\n )\n resubscribe();\n onStoreChange();\n }),\n );\n }\n };\n\n resubscribe();\n\n return () => {\n for (const unsub of unsubsRef.current) unsub();\n unsubsRef.current = [];\n };\n },\n [system, runWithTracking],\n );\n\n const getSnapshot = useCallback(() => {\n let effectiveValue: unknown;\n\n if (!system) {\n effectiveValue = defaultValueRef.current;\n } else {\n const { value: newValue } = runWithTracking();\n\n // When selector returns undefined and we have a default, use it\n effectiveValue =\n newValue === undefined && hasDefault\n ? defaultValueRef.current\n : newValue;\n }\n\n if (\n cachedValue.current !== UNINITIALIZED &&\n eqRef.current(cachedValue.current, effectiveValue)\n ) {\n return cachedValue.current;\n }\n cachedValue.current = effectiveValue;\n\n return effectiveValue;\n }, [runWithTracking, system, hasDefault]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// _useNamespacedSelectorImpl — internal namespaced useSelector\n// ============================================================================\n\n/\n Internal implementation for useSelector with NamespacedSystem.\n * Subscribes to all module namespaces and runs the selector against the system.\n * Uses equality comparison to prevent unnecessary re-renders.\n /\nfunction _useNamespacedSelectorImpl(\n // biome-ignore lint/suspicious/noExplicitAny: Internal impl\n system: NamespacedSystem<any>,\n // biome-ignore lint/suspicious/noExplicitAny: Internal impl\n selector: (state: any) => unknown,\n defaultValueArg?: unknown,\n equalityFnArg?: (a: unknown, b: unknown) => boolean,\n): unknown {\n const hasDefault = defaultValueArg !== undefined;\n const equalityFn = equalityFnArg ?? defaultEquality;\n\n const selectorRef = useRef(selector);\n const eqRef = useRef(equalityFn);\n const defaultValueRef = useRef(defaultValueArg);\n selectorRef.current = selector;\n eqRef.current = equalityFn;\n defaultValueRef.current = defaultValueArg;\n\n const cachedValue = useRef<unknown>(UNINITIALIZED);\n\n // Get all module namespace names for wildcard subscription\n const moduleNames = useMemo(() => Object.keys(system.facts), [system]);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n // Subscribe to all modules using wildcard keys\n const wildcardKeys = moduleNames.map((ns) => `${ns}.`);\n\n return system.subscribe(wildcardKeys, onStoreChange);\n },\n [system, moduleNames],\n );\n\n const getSnapshot = useCallback(() => {\n const newValue = selectorRef.current(system);\n const effectiveValue =\n newValue === undefined && hasDefault ? defaultValueRef.current : newValue;\n\n if (\n cachedValue.current !== UNINITIALIZED &&\n eqRef.current(cachedValue.current, effectiveValue)\n ) {\n return cachedValue.current;\n }\n\n cachedValue.current = effectiveValue;\n\n return effectiveValue;\n }, [system, hasDefault]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useDispatch\n// ============================================================================\n\nexport function useDispatch<S extends ModuleSchema>(\n system: SingleModuleSystem<S>,\n): (event: InferEvents<S>) => void {\n assertSystem(\"useDispatch\", system);\n return useCallback(\n (event: InferEvents<S>) => {\n system.dispatch(event);\n },\n [system],\n );\n}\n\n// ============================================================================\n// useWatch — derivation or fact side-effect (no re-render)\n// ============================================================================\n\n/** Watch a derivation or fact by key (auto-detected). When a key exists in both facts and derivations, the derivation overload takes priority. /\nexport function useWatch<\n S extends ModuleSchema,\n K extends keyof InferDerivations<S> & string,\n>(\n system: SingleModuleSystem<S>,\n key: K,\n callback: (\n newValue: InferDerivations<S>[K],\n prevValue: InferDerivations<S>[K] \| undefined,\n ) => void,\n): void;\n/* Watch a fact key with auto-detection. /\nexport function useWatch<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(\n system: SingleModuleSystem<S>,\n key: K,\n callback: (\n newValue: InferFacts<S>[K] \| undefined,\n prevValue: InferFacts<S>[K] \| undefined,\n ) => void,\n): void;\n\n/* Implementation /\nexport function useWatch(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n key: string,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation overload dispatch\n callback: (newValue: any, prevValue: any) => void,\n): void {\n assertSystem(\"useWatch\", system);\n\n const callbackRef = useRef(callback);\n callbackRef.current = callback;\n\n useEffect(() => {\n return system.watch(key, (newValue, prevValue) => {\n callbackRef.current(newValue, prevValue);\n });\n }, [system, key]);\n}\n\n// ============================================================================\n// useInspect — consolidated inspection hook\n// ============================================================================\n\n// InspectState is imported from ./shared.js and re-exported above\n\n/* Options for useInspect /\nexport interface UseInspectOptions {\n /* Throttle updates to this interval (ms). When set, uses useState instead of useSyncExternalStore. /\n throttleMs?: number;\n}\n\n/\n Hook to get consolidated system inspection data reactively.\n \n Merges isSettled, unmet/inflight requirements, and working state\n * into a single subscription. Optionally throttle updates.\n \n @example\n * ```tsx\n * const { isSettled, isWorking, hasUnmet } = useInspect(system);\n * const throttled = useInspect(system, { throttleMs: 200 });\n * ```\n /\nexport function useInspect(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n options?: UseInspectOptions,\n): InspectState {\n assertSystem(\"useInspect\", system);\n // Always call the sync version (useSyncExternalStore path) — no conditional hooks\n const syncState = _useInspectSync(system);\n\n const throttleMs = options?.throttleMs;\n const [deferredState, setDeferredState] = useState(syncState);\n const throttleRef = useRef<{\n throttled: (...args: unknown[]) => void;\n cleanup: () => void;\n } \| null>(null);\n\n // Create/recreate throttle when throttleMs changes\n useEffect(() => {\n if (!throttleMs \|\| throttleMs <= 0) {\n throttleRef.current?.cleanup();\n throttleRef.current = null;\n return;\n }\n // Clean up old throttle before creating new one\n throttleRef.current?.cleanup();\n throttleRef.current = createThrottle((...args: unknown[]) => {\n setDeferredState(args[0] as InspectState);\n }, throttleMs);\n return () => {\n throttleRef.current?.cleanup();\n throttleRef.current = null;\n };\n }, [throttleMs]);\n\n // Feed sync state through throttle after each render\n useEffect(() => {\n if (throttleRef.current) {\n throttleRef.current.throttled(syncState);\n }\n }, [syncState]);\n\n if (!throttleMs \|\| throttleMs <= 0) return syncState;\n return deferredState;\n}\n\nfunction _buildInspectState(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n): InspectState {\n return computeInspectState(system);\n}\n\nfunction _useInspectSync(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n): InspectState {\n const cachedSnapshot = useRef<InspectState \| null>(null);\n const cachedUnmetIds = useRef<string[]>([]);\n const cachedInflightIds = useRef<string[]>([]);\n const cachedIsSettled = useRef<boolean \| null>(null);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const unsubFacts = system.facts.$store.subscribeAll(onStoreChange);\n const unsubSettled = system.onSettledChange(onStoreChange);\n return () => {\n unsubFacts();\n unsubSettled();\n };\n },\n [system],\n );\n\n const getSnapshot = useCallback(() => {\n const state = _buildInspectState(system);\n\n const unmetSame =\n state.unmet.length === cachedUnmetIds.current.length &&\n state.unmet.every((u, i) => u.id === cachedUnmetIds.current[i]);\n const inflightSame =\n state.inflight.length === cachedInflightIds.current.length &&\n state.inflight.every((f, i) => f.id === cachedInflightIds.current[i]);\n const settledSame = state.isSettled === cachedIsSettled.current;\n\n if (unmetSame && inflightSame && settledSame && cachedSnapshot.current) {\n return cachedSnapshot.current;\n }\n\n cachedSnapshot.current = state;\n cachedUnmetIds.current = state.unmet.map((u) => u.id);\n cachedInflightIds.current = state.inflight.map((f) => f.id);\n cachedIsSettled.current = state.isSettled;\n\n return state;\n }, [system]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useTimeTravel — reactive time-travel state\n// ============================================================================\n\n/\n Reactive time-travel hook. Returns null when time-travel is disabled.\n * Re-renders when snapshots are taken or navigation occurs.\n \n @example\n * ```tsx\n * const tt = useTimeTravel(system);\n * if (tt) {\n * return (\n * <div>\n * <button disabled={!tt.canUndo} onClick={tt.undo}>Undo</button>\n * <button disabled={!tt.canRedo} onClick={tt.redo}>Redo</button>\n * <span>{tt.currentIndex + 1} / {tt.totalSnapshots}</span>\n * </div>\n * );\n * }\n * ```\n /\nexport function useTimeTravel(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n): TimeTravelState \| null {\n assertSystem(\"useTimeTravel\", system);\n const cachedRef = useRef<TimeTravelState \| null>(null);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => system.onTimeTravelChange(onStoreChange),\n [system],\n );\n\n const getSnapshot = useCallback(() => {\n const state = buildTimeTravelState(system);\n if (!state) return null;\n\n // Return stable reference when values haven't changed\n if (\n cachedRef.current &&\n cachedRef.current.canUndo === state.canUndo &&\n cachedRef.current.canRedo === state.canRedo &&\n cachedRef.current.currentIndex === state.currentIndex &&\n cachedRef.current.totalSnapshots === state.totalSnapshots &&\n cachedRef.current.isPaused === state.isPaused\n ) {\n return cachedRef.current;\n }\n\n cachedRef.current = state;\n return cachedRef.current;\n }, [system]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useRequirementStatus — single or multi\n// ============================================================================\n\n/* Single type overload /\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus;\n\n/* Multi-type overload /\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus>;\n\n/* Implementation /\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n typeOrTypes: string \| string[],\n): RequirementTypeStatus \| Record<string, RequirementTypeStatus> {\n if (Array.isArray(typeOrTypes)) {\n return _useRequirementStatusMulti(statusPlugin, typeOrTypes);\n }\n return _useRequirementStatusSingle(statusPlugin, typeOrTypes);\n}\n\nfunction _useRequirementStatusSingle(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus {\n const cachedRef = useRef<RequirementTypeStatus \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return statusPlugin.subscribe(onStoreChange);\n },\n [statusPlugin],\n );\n\n const getSnapshot = useCallback(() => {\n const status = statusPlugin.getStatus(type);\n\n if (cachedRef.current !== UNINITIALIZED) {\n const prev = cachedRef.current;\n if (\n prev.pending === status.pending &&\n prev.inflight === status.inflight &&\n prev.failed === status.failed &&\n prev.isLoading === status.isLoading &&\n prev.hasError === status.hasError &&\n prev.lastError === status.lastError\n ) {\n return cachedRef.current;\n }\n }\n\n cachedRef.current = status;\n return status;\n }, [statusPlugin, type]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction _useRequirementStatusMulti(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus> {\n const cachedRef = useRef<Record<string, RequirementTypeStatus> \| null>(null);\n const cachedKey = useRef<string>(\"\");\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return statusPlugin.subscribe(onStoreChange);\n },\n [statusPlugin],\n );\n\n const getSnapshot = useCallback(() => {\n const result: Record<string, RequirementTypeStatus> = {};\n const parts: string[] = [];\n for (const type of types) {\n const status = statusPlugin.getStatus(type);\n result[type] = status;\n parts.push(\n `${type}:${status.pending}:${status.inflight}:${status.failed}:${status.hasError}:${status.lastError?.message ?? \"\"}`,\n );\n }\n const key = parts.join(\"\|\");\n\n if (key !== cachedKey.current) {\n cachedKey.current = key;\n cachedRef.current = result;\n }\n\n return cachedRef.current ?? result;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [statusPlugin, ...types]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useSuspenseRequirement — single or multi\n// ============================================================================\n\n// Cache for pending promises, scoped per statusPlugin to prevent cross-system leaks.\nconst suspenseCacheMap = new WeakMap<\n StatusPlugin,\n Map<string, Promise<void>>\n>();\n\nfunction getSuspenseCache(plugin: StatusPlugin): Map<string, Promise<void>> {\n let cache = suspenseCacheMap.get(plugin);\n if (!cache) {\n cache = new Map();\n suspenseCacheMap.set(plugin, cache);\n }\n return cache;\n}\n\n/* Single type overload /\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus;\n\n/* Multi-type overload /\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus>;\n\n/* Implementation /\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n typeOrTypes: string \| string[],\n): RequirementTypeStatus \| Record<string, RequirementTypeStatus> {\n if (Array.isArray(typeOrTypes)) {\n return _useSuspenseRequirementMulti(statusPlugin, typeOrTypes);\n }\n return _useSuspenseRequirementSingle(statusPlugin, typeOrTypes);\n}\n\nfunction _useSuspenseRequirementSingle(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus {\n const status = statusPlugin.getStatus(type);\n\n if (status.hasError && status.lastError) {\n throw status.lastError;\n }\n\n if (status.isLoading) {\n const cache = getSuspenseCache(statusPlugin);\n let promise = cache.get(type);\n\n if (!promise) {\n promise = new Promise<void>((resolve) => {\n const unsubscribe = statusPlugin.subscribe(() => {\n const currentStatus = statusPlugin.getStatus(type);\n if (!currentStatus.isLoading) {\n cache.delete(type);\n unsubscribe();\n resolve();\n }\n });\n });\n cache.set(type, promise);\n }\n\n throw promise;\n }\n\n return status;\n}\n\nfunction _useSuspenseRequirementMulti(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus> {\n const result: Record<string, RequirementTypeStatus> = {};\n let hasLoading = false;\n let firstError: Error \| null = null;\n\n for (const type of types) {\n const status = statusPlugin.getStatus(type);\n result[type] = status;\n\n if (status.hasError && status.lastError && !firstError) {\n firstError = status.lastError;\n }\n if (status.isLoading) {\n hasLoading = true;\n }\n }\n\n if (firstError) {\n throw firstError;\n }\n\n if (hasLoading) {\n const cache = getSuspenseCache(statusPlugin);\n const cacheKey = types.slice().sort().join(\",\");\n let promise = cache.get(cacheKey);\n\n if (!promise) {\n promise = new Promise<void>((resolve) => {\n const unsubscribe = statusPlugin.subscribe(() => {\n const allDone = types.every(\n (t) => !statusPlugin.getStatus(t).isLoading,\n );\n if (allDone) {\n cache.delete(cacheKey);\n unsubscribe();\n resolve();\n }\n });\n });\n cache.set(cacheKey, promise);\n }\n\n throw promise;\n }\n\n return result;\n}\n\n// ============================================================================\n// useDirectiveRef — scoped system lifecycle\n// ============================================================================\n\n/* Base options for creating a scoped system /\ninterface DirectiveRefBaseConfig {\n // biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n plugins?: Plugin<any>[];\n debug?: DebugConfig;\n errorBoundary?: ErrorBoundaryConfig;\n tickMs?: number;\n zeroConfig?: boolean;\n // biome-ignore lint/suspicious/noExplicitAny: Facts type varies\n initialFacts?: Record<string, any>;\n}\n\n/* Options for useDirectiveRef: module directly, or config object /\nexport type UseDirectiveRefOptions<M extends ModuleSchema> =\n \| ModuleDef<M>\n \| (DirectiveRefBaseConfig & { module: ModuleDef<M> });\n\n/* Options for useDirectiveRef with namespaced modules /\nexport type UseDirectiveRefNamespacedOptions<Modules extends ModulesMap> =\n DirectiveRefBaseConfig & { modules: { [K in keyof Modules]: Modules[K] } };\n\n// --- Single-module overloads ---\n\n/* Without status (no config): returns system directly /\nexport function useDirectiveRef<M extends ModuleSchema>(\n options: UseDirectiveRefOptions<M>,\n): SingleModuleSystem<M>;\n\n/* Without status (with config): returns system directly /\nexport function useDirectiveRef<M extends ModuleSchema>(\n options: UseDirectiveRefOptions<M>,\n config: DirectiveRefBaseConfig,\n): SingleModuleSystem<M>;\n\n/* With status: returns { system, statusPlugin } /\nexport function useDirectiveRef<M extends ModuleSchema>(\n options: UseDirectiveRefOptions<M>,\n config: { status: true } & DirectiveRefBaseConfig,\n): { system: SingleModuleSystem<M>; statusPlugin: StatusPlugin };\n\n// --- Namespaced (multi-module) overloads ---\n\n/* Namespaced: returns NamespacedSystem directly /\nexport function useDirectiveRef<const Modules extends ModulesMap>(\n options: UseDirectiveRefNamespacedOptions<Modules>,\n): NamespacedSystem<Modules>;\n\n/* Namespaced with config: returns NamespacedSystem directly /\nexport function useDirectiveRef<const Modules extends ModulesMap>(\n options: UseDirectiveRefNamespacedOptions<Modules>,\n config: DirectiveRefBaseConfig,\n): NamespacedSystem<Modules>;\n\n/* Implementation /\nexport function useDirectiveRef(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature handles both modes\n options: any,\n config?: { status?: boolean } & DirectiveRefBaseConfig,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation return varies by overload\n): any {\n // biome-ignore lint/suspicious/noExplicitAny: System ref holds either system type\n const systemRef = useRef<any>(null);\n const statusPluginRef = useRef<StatusPlugin \| null>(null);\n // Factory ref for strict mode re-creation (effects unmount then re-mount)\n // biome-ignore lint/suspicious/noExplicitAny: Factory return type varies\n const factoryRef = useRef<(() => any) \| null>(null);\n const wantStatus = config?.status === true;\n const isNamespaced = \"modules\" in options;\n\n if (!systemRef.current) {\n // Build a factory that creates + starts the system.\n // Called once during render and again on strict-mode re-mount.\n factoryRef.current = () => {\n if (isNamespaced) {\n // --- Namespaced mode: { modules: { ... } } ---\n const { modules, ...rest } = options;\n const plugins = config?.plugins ?? rest.plugins ?? [];\n const debug = config?.debug ?? rest.debug;\n const errorBoundary = config?.errorBoundary ?? rest.errorBoundary;\n const tickMs = config?.tickMs ?? rest.tickMs;\n const zeroConfig = config?.zeroConfig ?? rest.zeroConfig;\n const initialFacts = config?.initialFacts ?? rest.initialFacts;\n\n const sys = createSystem({\n modules,\n plugins: plugins.length > 0 ? plugins : undefined,\n debug,\n errorBoundary,\n tickMs,\n zeroConfig,\n initialFacts,\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n } as any);\n // Always initialize facts/derivations (safe for SSR).\n // Only start reconciliation on the client.\n sys.initialize();\n if (typeof window !== \"undefined\") {\n sys.start();\n }\n\n return sys;\n }\n\n // --- Single-module mode ---\n const isModule = \"id\" in options && \"schema\" in options;\n const mod = isModule ? options : options.module;\n const baseOpts = isModule ? {} : (options as DirectiveRefBaseConfig);\n const plugins = config?.plugins ?? baseOpts.plugins ?? [];\n const debug = config?.debug ?? baseOpts.debug;\n const errorBoundary = config?.errorBoundary ?? baseOpts.errorBoundary;\n const tickMs = config?.tickMs ?? baseOpts.tickMs;\n const zeroConfig = config?.zeroConfig ?? baseOpts.zeroConfig;\n const initialFacts = config?.initialFacts ?? baseOpts.initialFacts;\n\n let allPlugins = [...plugins];\n\n if (wantStatus) {\n statusPluginRef.current = createRequirementStatusPlugin();\n // biome-ignore lint/suspicious/noExplicitAny: Plugin generic issues\n allPlugins = [\n ...allPlugins,\n statusPluginRef.current.plugin as Plugin<any>,\n ];\n }\n\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n const sys = createSystem({\n module: mod,\n plugins: allPlugins.length > 0 ? allPlugins : undefined,\n debug,\n errorBoundary,\n tickMs,\n zeroConfig,\n initialFacts,\n } as any);\n // Always initialize facts/derivations (safe for SSR).\n // Only start reconciliation on the client.\n sys.initialize();\n if (typeof window !== \"undefined\") {\n sys.start();\n }\n\n return sys;\n };\n\n // Start synchronously so facts are initialized before the first render\n systemRef.current = factoryRef.current();\n }\n\n useEffect(() => {\n // Strict mode re-mount: system was destroyed in cleanup, recreate it\n if (!systemRef.current && factoryRef.current) {\n systemRef.current = factoryRef.current();\n }\n\n return () => {\n systemRef.current?.destroy();\n systemRef.current = null;\n statusPluginRef.current = null;\n };\n }, []);\n\n if (wantStatus && !isNamespaced) {\n return {\n system: systemRef.current!,\n statusPlugin: statusPluginRef.current!,\n };\n }\n\n return systemRef.current!;\n}\n\n// ============================================================================\n// useNamespacedSelector — select from a NamespacedSystem with useSyncExternalStore\n// ============================================================================\n\n/\n React hook to select derived values from a NamespacedSystem.\n * Uses useSyncExternalStore for tear-free reads.\n \n @param system - The namespaced system to read from\n * @param keys - Namespaced keys to subscribe to (e.g., [\"auth.token\", \"data.count\"])\n * @param selector - Function that reads from system.facts / system.derive\n \n @example\n * ```tsx\n * const system = useDirectiveRef({ modules: { auth, data } });\n * const token = useNamespacedSelector(system, [\"auth.token\"], (s) => s.facts.auth.token);\n * const count = useNamespacedSelector(system, [\"data.\"], (s) => s.derive.data.total);\n ```\n /\nexport function useNamespacedSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n keys: string[],\n selector: (system: NamespacedSystem<Modules>) => R,\n): R {\n const keysRef = useRef(keys);\n keysRef.current = keys;\n const selectorRef = useRef(selector);\n selectorRef.current = selector;\n\n const subscribe = useCallback(\n (onStoreChange: () => void) =>\n system.subscribe(keysRef.current, onStoreChange),\n [system],\n );\n\n const getSnapshot = useCallback(() => selectorRef.current(system), [system]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useDirective — scoped system with selected values in containers\n// ============================================================================\n\n/* Options for useDirective hook /\nexport interface UseDirectiveOptions<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string = never,\n DK extends keyof InferDerivations<S> & string = never,\n> extends DirectiveRefBaseConfig {\n /* Fact keys to subscribe to /\n facts?: FK[];\n /* Derivation keys to subscribe to /\n derived?: DK[];\n /* Enable status plugin /\n status?: boolean;\n}\n\n/* Return type for useDirective hook (without status) /\nexport type UseDirectiveReturn<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string,\n DK extends keyof InferDerivations<S> & string,\n> = {\n system: SingleModuleSystem<S>;\n dispatch: (event: InferEvents<S>) => void;\n events: SingleModuleSystem<S>[\"events\"];\n facts: Pick<InferFacts<S>, FK>;\n derived: Pick<InferDerivations<S>, DK>;\n};\n\n/* Return type for useDirective hook (with status) /\nexport type UseDirectiveReturnWithStatus<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string,\n DK extends keyof InferDerivations<S> & string,\n> = UseDirectiveReturn<S, FK, DK> & {\n statusPlugin: StatusPlugin;\n};\n\n/\n Convenience hook that creates a scoped system and reads selected facts/derivations\n * into container objects. When no `facts` or `derived` keys are specified, subscribes\n * to ALL facts and derivations (replacing the former `useModule` hook).\n \n @example\n * ```tsx\n * // Selective subscription\n * const { dispatch, facts: { count }, derived: { doubled } } = useDirective(counterModule, {\n * facts: [\"count\"],\n * derived: [\"doubled\"],\n * });\n \n // Subscribe to everything (no keys = all facts + all derivations)\n * const { facts, derived, events, dispatch } = useDirective(counterModule);\n * ```\n /\nexport function useDirective<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string = never,\n DK extends keyof InferDerivations<S> & string = never,\n>(\n moduleOrOptions: UseDirectiveRefOptions<S>,\n selections: UseDirectiveOptions<S, FK, DK> = {} as UseDirectiveOptions<\n S,\n FK,\n DK\n >,\n): UseDirectiveReturn<S, FK, DK> \| UseDirectiveReturnWithStatus<S, FK, DK> {\n const {\n facts: factKeysOpt,\n derived: derivedKeysOpt,\n status,\n ...configRest\n } = selections;\n const factKeys = (factKeysOpt ?? []) as FK[];\n const derivedKeys = (derivedKeysOpt ?? []) as DK[];\n\n // When no keys are specified, subscribe to everything\n const subscribeAll = factKeys.length === 0 && derivedKeys.length === 0;\n\n // Create system via useDirectiveRef (handles lifecycle)\n // biome-ignore lint/suspicious/noExplicitAny: Conditional overload dispatch\n const refResult: any = status\n ? useDirectiveRef(moduleOrOptions, { status: true as const, ...configRest })\n : useDirectiveRef(moduleOrOptions, configRest);\n\n const system: SingleModuleSystem<S> = status ? refResult.system : refResult;\n\n const statusPlugin = status\n ? (\n refResult as {\n system: SingleModuleSystem<S>;\n statusPlugin: StatusPlugin;\n }\n ).statusPlugin\n : undefined;\n\n // For subscribe-all mode, get all derivation keys\n const allDerivationKeys = useMemo(\n () => (subscribeAll ? Object.keys(system.derive) : []),\n [system, subscribeAll],\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const unsubs: Array<() => void> = [];\n if (subscribeAll) {\n // Subscribe to ALL facts and ALL derivations\n unsubs.push(system.facts.$store.subscribeAll(onStoreChange));\n if (allDerivationKeys.length > 0) {\n unsubs.push(system.subscribe(allDerivationKeys, onStoreChange));\n }\n } else {\n if (factKeys.length > 0) {\n unsubs.push(system.facts.$store.subscribe(factKeys, onStoreChange));\n }\n if (derivedKeys.length > 0) {\n unsubs.push(system.subscribe(derivedKeys, onStoreChange));\n }\n }\n return () => {\n for (const unsub of unsubs) unsub();\n };\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [system, subscribeAll, ...factKeys, ...derivedKeys, ...allDerivationKeys],\n );\n\n const cachedFacts = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n const cachedDerived = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n const cachedWrapper = useRef<{\n facts: Record<string, unknown>;\n derived: Record<string, unknown>;\n } \| null>(null);\n\n const getSnapshot = useCallback(() => {\n let factsResult: Record<string, unknown>;\n let derivedResult: Record<string, unknown>;\n let effectiveFactKeys: readonly string[];\n let effectiveDerivedKeys: readonly string[];\n\n if (subscribeAll) {\n // Read ALL facts and ALL derivations\n factsResult = system.facts.$store.toObject();\n effectiveFactKeys = Object.keys(factsResult);\n derivedResult = {};\n for (const key of allDerivationKeys) {\n derivedResult[key] = system.read(key);\n }\n effectiveDerivedKeys = allDerivationKeys;\n } else {\n // Read selected keys only\n factsResult = {};\n for (const key of factKeys) {\n // biome-ignore lint/suspicious/noExplicitAny: Dynamic fact access\n factsResult[key] = (system.facts as any)[key];\n }\n effectiveFactKeys = factKeys;\n derivedResult = {};\n for (const key of derivedKeys) {\n derivedResult[key] = system.read(key);\n }\n effectiveDerivedKeys = derivedKeys;\n }\n\n // Check facts stability\n let factsSame = cachedFacts.current !== UNINITIALIZED;\n if (factsSame) {\n const prev = cachedFacts.current as Record<string, unknown>;\n const prevKeys = Object.keys(prev);\n if (prevKeys.length !== effectiveFactKeys.length) {\n factsSame = false;\n } else {\n for (const key of effectiveFactKeys) {\n if (!Object.is(prev[key], factsResult[key])) {\n factsSame = false;\n break;\n }\n }\n }\n }\n\n // Check derived stability\n let derivedSame = cachedDerived.current !== UNINITIALIZED;\n if (derivedSame) {\n const prev = cachedDerived.current as Record<string, unknown>;\n const prevKeys = Object.keys(prev);\n if (prevKeys.length !== effectiveDerivedKeys.length) {\n derivedSame = false;\n } else {\n for (const key of effectiveDerivedKeys) {\n if (!Object.is(prev[key], derivedResult[key])) {\n derivedSame = false;\n break;\n }\n }\n }\n }\n\n const stableFacts = factsSame\n ? (cachedFacts.current as Record<string, unknown>)\n : factsResult;\n const stableDerived = derivedSame\n ? (cachedDerived.current as Record<string, unknown>)\n : derivedResult;\n\n if (!factsSame) cachedFacts.current = factsResult;\n if (!derivedSame) cachedDerived.current = derivedResult;\n\n // Return same wrapper reference when both containers are unchanged\n if (factsSame && derivedSame && cachedWrapper.current) {\n return cachedWrapper.current;\n }\n\n cachedWrapper.current = { facts: stableFacts, derived: stableDerived };\n return cachedWrapper.current;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, subscribeAll, ...factKeys, ...derivedKeys, ...allDerivationKeys]);\n\n const values = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n const dispatch = useCallback(\n (event: InferEvents<S>) => system.dispatch(event),\n [system],\n );\n\n const events = useEvents(system);\n\n const base = {\n system,\n dispatch,\n events,\n facts: values.facts as Pick<InferFacts<S>, FK>,\n derived: values.derived as Pick<InferDerivations<S>, DK>,\n };\n\n if (status && statusPlugin) {\n return { ...base, statusPlugin } as UseDirectiveReturnWithStatus<S, FK, DK>;\n }\n\n return base as UseDirectiveReturn<S, FK, DK>;\n}\n\n// ============================================================================\n// useEvents — memoized events reference\n// ============================================================================\n\n/\n Returns the system's events dispatcher. Provides autocomplete for event names\n * and avoids needing useCallback wrappers for event dispatch.\n \n @example\n * ```tsx\n * const events = useEvents(system);\n * <button onClick={() => events.increment()}>+</button>\n * ```\n /\nexport function useEvents<S extends ModuleSchema>(\n system: SingleModuleSystem<S>,\n): SingleModuleSystem<S>[\"events\"] {\n assertSystem(\"useEvents\", system);\n return useMemo(() => system.events, [system]);\n}\n\n// ============================================================================\n// useExplain — reactive requirement explanation\n// ============================================================================\n\n/\n Reactively returns the explanation string for a requirement.\n * Updates whenever system state changes.\n \n @example\n * ```tsx\n * const explanation = useExplain(system, \"req-123\");\n * if (explanation) <pre>{explanation}</pre>;\n * ```\n /\nexport function useExplain(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n requirementId: string,\n): string \| null {\n assertSystem(\"useExplain\", system);\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const unsubFacts = system.facts.$store.subscribeAll(onStoreChange);\n const unsubSettled = system.onSettledChange(onStoreChange);\n return () => {\n unsubFacts();\n unsubSettled();\n };\n },\n [system],\n );\n\n const getSnapshot = useCallback(() => {\n return system.explain(requirementId);\n }, [system, requirementId]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useConstraintStatus — reactive constraint inspection\n// ============================================================================\n\n// ConstraintInfo is imported from ./shared.js and re-exported above\n\n/* Get all constraints /\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n): ConstraintInfo[];\n/* Get a single constraint by ID /\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n constraintId: string,\n): ConstraintInfo \| null;\n/* Implementation /\nexport function useConstraintStatus(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n constraintId?: string,\n): ConstraintInfo[] \| ConstraintInfo \| null {\n assertSystem(\"useConstraintStatus\", system);\n const inspectState = useInspect(system);\n\n return useMemo(() => {\n const inspection = system.inspect();\n if (!constraintId) return inspection.constraints;\n return inspection.constraints.find((c) => c.id === constraintId) ?? null;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, constraintId, inspectState]);\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\n/* Result of useOptimisticUpdate /\nexport interface OptimisticUpdateResult {\n /* Apply an optimistic update (saves snapshot, then runs updateFn in batch) /\n mutate: (updateFn: () => void) => void;\n /* Whether a resolver is currently processing the optimistic change /\n isPending: boolean;\n /* Error if the resolver failed /\n error: Error \| null;\n /* Manually rollback to the pre-mutation snapshot /\n rollback: () => void;\n}\n\n/\n Optimistic update hook. Saves a snapshot before mutating, monitors\n * a requirement type via statusPlugin, and rolls back on failure.\n \n @example\n * ```tsx\n * const { mutate, isPending, error, rollback } = useOptimisticUpdate(\n * system, statusPlugin, \"SAVE_ITEM\"\n * );\n * mutate(() => { system.facts.items = [...system.facts.items, newItem]; });\n * ```\n /\nexport function useOptimisticUpdate(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n statusPlugin?: StatusPlugin,\n requirementType?: string,\n): OptimisticUpdateResult {\n assertSystem(\"useOptimisticUpdate\", system);\n const [isPending, setIsPending] = useState(false);\n const [error, setError] = useState<Error \| null>(null);\n const snapshotRef = useRef<SystemSnapshot \| null>(null);\n\n const rollback = useCallback(() => {\n if (snapshotRef.current) {\n system.restore(snapshotRef.current);\n snapshotRef.current = null;\n }\n setIsPending(false);\n setError(null);\n }, [system]);\n\n const mutate = useCallback(\n (updateFn: () => void) => {\n snapshotRef.current = system.getSnapshot();\n setIsPending(true);\n setError(null);\n system.batch(updateFn);\n },\n [system],\n );\n\n // Watch for resolver completion/failure\n useEffect(() => {\n if (!statusPlugin \|\| !requirementType \|\| !isPending) return;\n\n return statusPlugin.subscribe(() => {\n const status = statusPlugin.getStatus(requirementType);\n if (!status.isLoading && !status.hasError) {\n // Resolved successfully — keep optimistic state\n snapshotRef.current = null;\n setIsPending(false);\n } else if (status.hasError) {\n // Failed — rollback\n setError(status.lastError);\n rollback();\n }\n });\n }, [statusPlugin, requirementType, isPending, rollback]);\n\n return { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// DirectiveHydrator + useHydratedSystem — SSR/RSC hydration\n// ============================================================================\n\n/* Props for DirectiveHydrator component /\nexport interface HydratorProps {\n snapshot: DistributableSnapshot;\n children: ReactNode;\n}\n\n/* Context for hydrated snapshot /\nconst HydrationContext = createContext<DistributableSnapshot \| null>(null);\n\n/\n SSR/RSC hydration component. Wraps children with a snapshot context\n * that `useHydratedSystem` can consume on the client.\n \n @example\n * ```tsx\n * // Server component\n * <DirectiveHydrator snapshot={serverSnapshot}>\n * <ClientApp />\n * </DirectiveHydrator>\n * ```\n /\nexport function DirectiveHydrator({ snapshot, children }: HydratorProps) {\n return (\n <HydrationContext.Provider value={snapshot}>\n {children}\n </HydrationContext.Provider>\n );\n}\n\n/\n Client-side hook that creates a system hydrated from a server snapshot.\n * Must be used inside a `<DirectiveHydrator>`.\n \n @example\n * ```tsx\n * function ClientApp() {\n * const system = useHydratedSystem(counterModule);\n * const count = useFact(system, \"count\");\n * return <div>{count}</div>;\n * }\n * ```\n */\nexport function useHydratedSystem<S extends ModuleSchema>(\n moduleDef: ModuleDef<S>,\n config?: DirectiveRefBaseConfig,\n): SingleModuleSystem<S> {\n const snapshot = useContext(HydrationContext);\n\n // Merge snapshot data as initial facts if available\n const mergedConfig = useMemo(() => {\n if (!snapshot?.data) return config ?? {};\n return {\n ...(config ?? {}),\n initialFacts: {\n ...(config?.initialFacts ?? {}),\n ...snapshot.data,\n },\n };\n }, [snapshot, config]);\n\n return useDirectiveRef(moduleDef, mergedConfig) as SingleModuleSystem<S>;\n}\n"]}
1	+ {"version":3,"sources":["../src/index.tsx"],"names":["UNINITIALIZED","useFact","system","keyOrKeys","assertSystem","_useFacts","_useSingleFact","factKey","subscribe","useCallback","onStoreChange","getSnapshot","useSyncExternalStore","factKeys","cachedValue","useRef","result","key","same","useDerived","_useDerivedMulti","_useSingleDerived","derivationId","derivationIds","id","useSelector","systemArg","selector","defaultValueArg","equalityFnArg","_useNamespacedSelectorImpl","defaultValue","hasDefault","equalityFn","defaultEquality","selectorRef","eqRef","defaultValueRef","trackedFactKeysRef","trackedDeriveKeysRef","unsubsRef","deriveKeys","useMemo","runWithTracking","runTrackedSelector","resubscribe","unsub","derivedKeys","updated","depsChanged","effectiveValue","newValue","moduleNames","wildcardKeys","ns","useDispatch","event","useWatch","callback","callbackRef","useEffect","prevValue","useInspect","options","syncState","_useInspectSync","throttleMs","deferredState","setDeferredState","useState","throttleRef","createThrottle","args","_buildInspectState","computeInspectState","cachedSnapshot","cachedUnmetIds","cachedInflightIds","cachedIsSettled","unsubFacts","unsubSettled","state","unmetSame","u","i","inflightSame","f","settledSame","useHistory","cachedRef","buildHistoryState","useRequirementStatus","statusPlugin","typeOrTypes","_useRequirementStatusMulti","_useRequirementStatusSingle","type","status","prev","types","cachedKey","parts","suspenseCacheMap","getSuspenseCache","plugin","cache","useSuspenseRequirement","_useSuspenseRequirementMulti","_useSuspenseRequirementSingle","promise","resolve","unsubscribe","hasLoading","firstError","cacheKey","t","useDirectiveRef","config","systemRef","statusPluginRef","factoryRef","wantStatus","isNamespaced","modules","rest","plugins","history","trace","errorBoundary","tickMs","zeroConfig","initialFacts","sys","createSystem","isModule","mod","baseOpts","allPlugins","createRequirementStatusPlugin","useNamespacedSelector","keys","keysRef","useDirective","moduleOrOptions","selections","factKeysOpt","derivedKeysOpt","configRest","subscribeAll","refResult","allDerivationKeys","unsubs","cachedFacts","cachedDerived","cachedWrapper","factsResult","derivedResult","effectiveFactKeys","effectiveDerivedKeys","factsSame","derivedSame","stableFacts","stableDerived","values","dispatch","events","useEvents","base","useExplain","requirementId","useConstraintStatus","constraintId","inspectState","inspection","c","useOptimisticUpdate","requirementType","isPending","setIsPending","error","setError","snapshotRef","rollback","mutate","updateFn","HydrationContext","createContext","DirectiveHydrator","snapshot","children","jsx","useHydratedSystem","moduleDef","useContext","mergedConfig"],"mappings":"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","file":"index.cjs","sourcesContent":["/*\n React Adapter - Consolidated hooks for React integration\n \n 18 public exports: useFact, useDerived, useDispatch, useDirective,\n * useDirectiveRef, useSelector, useWatch, useInspect, useRequirementStatus,\n * useSuspenseRequirement, useEvents, useExplain, useConstraintStatus,\n * useOptimisticUpdate, DirectiveHydrator, useHydratedSystem,\n * useHistory, shallowEqual\n \n @example\n * ```tsx\n * import { useFact, useDerived, useEvents } from '@directive-run/react';\n \n const system = createSystem({ module: counterModule });\n * system.start();\n \n function Counter() {\n * const count = useFact(system, \"count\");\n * const doubled = useDerived(system, \"doubled\");\n * const events = useEvents(system);\n \n return (\n * <div>\n * <p>Count: {count}</p>\n * <p>Doubled: {doubled}</p>\n * <button onClick={() => events.increment()}>+</button>\n * </div>\n * );\n * }\n * ```\n /\n\nimport type {\n TraceOption,\n DistributableSnapshot,\n ErrorBoundaryConfig,\n InferDerivations,\n InferEvents,\n InferFacts,\n InferSelectorState,\n ModuleDef,\n ModuleSchema,\n ModulesMap,\n NamespacedSystem,\n Plugin,\n SingleModuleSystem,\n SystemSnapshot,\n HistoryOption,\n HistoryState,\n} from \"@directive-run/core\";\nimport {\n createRequirementStatusPlugin,\n createSystem,\n} from \"@directive-run/core\";\nimport type { RequirementTypeStatus } from \"@directive-run/core\";\nimport {\n type ConstraintInfo,\n type InspectState,\n assertSystem,\n buildHistoryState,\n computeInspectState,\n createThrottle,\n defaultEquality,\n depsChanged,\n runTrackedSelector,\n shallowEqual,\n} from \"@directive-run/core/adapter-utils\";\nimport type { ReactNode } from \"react\";\nimport {\n createContext,\n useCallback,\n useContext,\n useEffect,\n useMemo,\n useRef,\n useState,\n useSyncExternalStore,\n} from \"react\";\n\n// Re-export for convenience\nexport type { RequirementTypeStatus, InspectState, ConstraintInfo };\nexport { shallowEqual };\n\n/* Type for the requirement status plugin return value /\nexport type StatusPlugin = ReturnType<typeof createRequirementStatusPlugin>;\n\n// ============================================================================\n// Internal Helpers\n// ============================================================================\n\n/* Sentinel value for uninitialized selector cache /\nconst UNINITIALIZED = Symbol(\"directive.uninitialized\");\n\n// ============================================================================\n// useFact — single key or multi key\n// ============================================================================\n\n/* Single key overload /\nexport function useFact<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(system: SingleModuleSystem<S>, factKey: K): InferFacts<S>[K] \| undefined;\n\n/* Multi-key overload /\nexport function useFact<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(system: SingleModuleSystem<S>, factKeys: K[]): Pick<InferFacts<S>, K>;\n\n/* Implementation /\nexport function useFact(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n keyOrKeys: string \| string[],\n): unknown {\n assertSystem(\"useFact\", system);\n if (\n process.env.NODE_ENV !== \"production\" &&\n typeof keyOrKeys === \"function\"\n ) {\n console.error(\n \"[Directive] useFact() received a function. Did you mean useSelector()? \" +\n \"useFact() takes a string key or array of keys, not a selector function.\",\n );\n }\n\n // Multi-key path: useFact(system, [keys])\n if (Array.isArray(keyOrKeys)) {\n return _useFacts(system, keyOrKeys);\n }\n\n // Single key path: useFact(system, key)\n return _useSingleFact(system, keyOrKeys);\n}\n\nfunction _useSingleFact(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n factKey: string,\n): unknown {\n if (process.env.NODE_ENV !== \"production\") {\n if (!(factKey in system.facts.$store.toObject())) {\n console.warn(\n `[Directive] useFact(\"${factKey}\") — fact not found in store. ` +\n `Check that \"${factKey}\" is defined in your module's schema.`,\n );\n }\n }\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.facts.$store.subscribe([factKey], onStoreChange);\n },\n [system, factKey],\n );\n\n const getSnapshot = useCallback(() => {\n return system.facts.$store.get(factKey as never);\n }, [system, factKey]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction _useFacts(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n factKeys: string[],\n): Record<string, unknown> {\n const cachedValue = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.facts.$store.subscribe(factKeys, onStoreChange);\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [system, ...factKeys],\n );\n\n const getSnapshot = useCallback(() => {\n const result: Record<string, unknown> = {};\n for (const key of factKeys) {\n result[key] = system.facts.$store.get(key as never);\n }\n\n if (cachedValue.current !== UNINITIALIZED) {\n let same = true;\n for (const key of factKeys) {\n if (\n !Object.is(\n (cachedValue.current as Record<string, unknown>)[key],\n result[key],\n )\n ) {\n same = false;\n break;\n }\n }\n if (same) return cachedValue.current;\n }\n\n cachedValue.current = result;\n return result;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, ...factKeys]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useDerived — single key or multi key\n// ============================================================================\n\n/* Single key overload /\nexport function useDerived<\n S extends ModuleSchema,\n K extends keyof InferDerivations<S> & string,\n>(system: SingleModuleSystem<S>, derivationId: K): InferDerivations<S>[K];\n\n/* Multi-key overload /\nexport function useDerived<\n S extends ModuleSchema,\n K extends keyof InferDerivations<S> & string,\n>(\n system: SingleModuleSystem<S>,\n derivationIds: K[],\n): Pick<InferDerivations<S>, K>;\n\n/* Implementation /\nexport function useDerived(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n keyOrKeys: string \| string[],\n): unknown {\n assertSystem(\"useDerived\", system);\n if (\n process.env.NODE_ENV !== \"production\" &&\n typeof keyOrKeys === \"function\"\n ) {\n console.error(\n \"[Directive] useDerived() received a function. Did you mean useSelector()? \" +\n \"useDerived() takes a string key or array of keys, not a selector function.\",\n );\n }\n\n // Multi-key path\n if (Array.isArray(keyOrKeys)) {\n return _useDerivedMulti(system, keyOrKeys);\n }\n\n // Single key path\n return _useSingleDerived(system, keyOrKeys);\n}\n\nfunction _useSingleDerived(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n derivationId: string,\n): unknown {\n if (process.env.NODE_ENV !== \"production\") {\n if (!(derivationId in system.derive)) {\n console.warn(\n `[Directive] useDerived(\"${derivationId}\") — derivation not found. ` +\n `Check that \"${derivationId}\" is defined in your module's derive property.`,\n );\n }\n }\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.subscribe([derivationId], onStoreChange);\n },\n [system, derivationId],\n );\n\n const getSnapshot = useCallback(() => {\n return system.read(derivationId);\n }, [system, derivationId]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction _useDerivedMulti(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n derivationIds: string[],\n): Record<string, unknown> {\n const cachedValue = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.subscribe(derivationIds, onStoreChange);\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [system, ...derivationIds],\n );\n\n const getSnapshot = useCallback(() => {\n const result: Record<string, unknown> = {};\n for (const id of derivationIds) {\n result[id] = system.read(id);\n }\n\n if (cachedValue.current !== UNINITIALIZED) {\n let same = true;\n for (const id of derivationIds) {\n if (\n !Object.is(\n (cachedValue.current as Record<string, unknown>)[id],\n result[id],\n )\n ) {\n same = false;\n break;\n }\n }\n if (same) return cachedValue.current;\n }\n\n cachedValue.current = result;\n return result;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, ...derivationIds]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useSelector — Zustand-style selector over facts and derivations\n// ============================================================================\n\n/\n Auto-tracking selector over facts and derivations (Zustand-style).\n * Uses `withTracking()` to detect which facts the selector accesses,\n * then subscribes only to those keys. Falls back to subscribeAll\n * if no keys are detected.\n \n Supports an optional default value as the 3rd parameter, used when\n * the system is null/undefined or the selector returns undefined.\n * When a default value is provided, the system parameter may be\n * null \| undefined — the hook returns the default and recomputes\n * when the system becomes available.\n \n An optional equality function can be passed as the 4th parameter\n * to customize when the selector result is considered \"changed\".\n * Defaults to `Object.is`. Use `shallowEqual` (exported from this\n * package) when your selector returns a new object/array each time.\n \n @example\n * ```tsx\n * // Basic usage\n * const count = useSelector(system, (s) => s.count);\n \n // With default value (allows nullable system)\n * const count = useSelector(system, (s) => s.count, 0);\n \n // With default value + custom equality\n * const coords = useSelector(system, (s) => ({ x: s.x, y: s.y }), { x: 0, y: 0 }, shallowEqual);\n * ```\n /\n\n// Non-null system, no default\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S>,\n selector: (state: InferSelectorState<S>) => R,\n): R;\n\n// Non-null system, with default value and optional equality\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S>,\n selector: (state: InferSelectorState<S>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// Nullable system, default REQUIRED\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S> \| null \| undefined,\n selector: (state: InferSelectorState<S>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// --- Namespaced system overloads ---\n\n// Namespaced system, no default\nexport function useSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n selector: (state: NamespacedSystem<Modules>) => R,\n): R;\n\n// Namespaced system, with default value and optional equality\nexport function useSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n selector: (state: NamespacedSystem<Modules>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// Nullable namespaced system, default REQUIRED\nexport function useSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules> \| null \| undefined,\n selector: (state: NamespacedSystem<Modules>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// --- Generic fallbacks ---\n\n// Generic fallback: non-null system\nexport function useSelector<R>(\n // biome-ignore lint/suspicious/noExplicitAny: Generic fallback\n system: SingleModuleSystem<any>,\n // biome-ignore lint/suspicious/noExplicitAny: Selector receives dynamic state\n selector: (state: Record<string, any>) => R,\n defaultValue?: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// Generic fallback: nullable system\nexport function useSelector<R>(\n // biome-ignore lint/suspicious/noExplicitAny: Generic fallback\n system: SingleModuleSystem<any> \| null \| undefined,\n // biome-ignore lint/suspicious/noExplicitAny: Selector receives dynamic state\n selector: (state: Record<string, any>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\nexport function useSelector(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature accepts both system types\n systemArg: SingleModuleSystem<any> \| NamespacedSystem<any> \| null \| undefined,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n selector: (state: any) => unknown,\n defaultValueArg?: unknown,\n equalityFnArg?: (a: unknown, b: unknown) => boolean,\n): unknown {\n // Route to namespaced implementation if system is a NamespacedSystem\n // biome-ignore lint/suspicious/noExplicitAny: Runtime type check\n if (systemArg && (systemArg as any)._mode === \"namespaced\") {\n // biome-ignore lint/suspicious/noExplicitAny: Delegate to namespaced impl\n return _useNamespacedSelectorImpl(\n systemArg as NamespacedSystem<any>,\n selector,\n defaultValueArg,\n equalityFnArg,\n );\n }\n\n // After the namespaced check, system is a SingleModuleSystem\n const system = systemArg as SingleModuleSystem<any> \| null \| undefined;\n let defaultValue: unknown;\n let hasDefault = false;\n const equalityFn: (a: unknown, b: unknown) => boolean =\n equalityFnArg ?? defaultEquality;\n\n if (defaultValueArg !== undefined) {\n defaultValue = defaultValueArg;\n hasDefault = true;\n }\n\n // Dev-mode warning: null system without a default value\n if (process.env.NODE_ENV !== \"production\") {\n if (!system && !hasDefault) {\n console.error(\n \"[Directive] useSelector() received a null/undefined system without a default value. \" +\n \"Provide a default value as the 3rd parameter: useSelector(system, selector, defaultValue)\",\n );\n }\n }\n\n // Store selector/eq/default in refs to avoid resubscription churn\n const selectorRef = useRef(selector);\n const eqRef = useRef(equalityFn);\n const defaultValueRef = useRef(defaultValue);\n selectorRef.current = selector;\n eqRef.current = equalityFn;\n defaultValueRef.current = defaultValue;\n\n const trackedFactKeysRef = useRef<string[]>([]);\n const trackedDeriveKeysRef = useRef<string[]>([]);\n const cachedValue = useRef<unknown>(UNINITIALIZED);\n const unsubsRef = useRef<Array<() => void>>([]);\n\n // Build a tracking-aware state proxy that exposes both facts and derivations\n const deriveKeys = useMemo(\n () => (system ? new Set(Object.keys(system.derive)) : new Set<string>()),\n [system],\n );\n\n const runWithTracking = useCallback(() => {\n if (!system) {\n return {\n value: defaultValueRef.current,\n factKeys: [] as string[],\n deriveKeys: [] as string[],\n };\n }\n\n return runTrackedSelector(system, deriveKeys, selectorRef.current);\n }, [system, deriveKeys]);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n if (!system) {\n // No system — return noop unsubscribe\n return () => {};\n }\n\n const resubscribe = () => {\n // Cleanup previous subscriptions\n for (const unsub of unsubsRef.current) unsub();\n unsubsRef.current = [];\n\n // Run selector with tracking to detect accessed keys\n const { factKeys, deriveKeys: derivedKeys } = runWithTracking();\n trackedFactKeysRef.current = factKeys;\n trackedDeriveKeysRef.current = derivedKeys;\n\n // Subscribe to accessed fact keys\n if (factKeys.length > 0) {\n unsubsRef.current.push(\n system.facts.$store.subscribe(factKeys, () => {\n // Re-track on notification for dynamic deps\n const updated = runWithTracking();\n if (\n depsChanged(\n trackedFactKeysRef.current,\n updated.factKeys,\n trackedDeriveKeysRef.current,\n updated.deriveKeys,\n )\n )\n resubscribe();\n onStoreChange();\n }),\n );\n } else if (derivedKeys.length === 0) {\n // No deps at all — subscribe to everything\n unsubsRef.current.push(\n system.facts.$store.subscribeAll(onStoreChange),\n );\n }\n\n // Subscribe to accessed derivation keys\n if (derivedKeys.length > 0) {\n unsubsRef.current.push(\n system.subscribe(derivedKeys, () => {\n // Re-track on notification for dynamic deps\n const updated = runWithTracking();\n if (\n depsChanged(\n trackedFactKeysRef.current,\n updated.factKeys,\n trackedDeriveKeysRef.current,\n updated.deriveKeys,\n )\n )\n resubscribe();\n onStoreChange();\n }),\n );\n }\n };\n\n resubscribe();\n\n return () => {\n for (const unsub of unsubsRef.current) unsub();\n unsubsRef.current = [];\n };\n },\n [system, runWithTracking],\n );\n\n const getSnapshot = useCallback(() => {\n let effectiveValue: unknown;\n\n if (!system) {\n effectiveValue = defaultValueRef.current;\n } else {\n const { value: newValue } = runWithTracking();\n\n // When selector returns undefined and we have a default, use it\n effectiveValue =\n newValue === undefined && hasDefault\n ? defaultValueRef.current\n : newValue;\n }\n\n if (\n cachedValue.current !== UNINITIALIZED &&\n eqRef.current(cachedValue.current, effectiveValue)\n ) {\n return cachedValue.current;\n }\n cachedValue.current = effectiveValue;\n\n return effectiveValue;\n }, [runWithTracking, system, hasDefault]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// _useNamespacedSelectorImpl — internal namespaced useSelector\n// ============================================================================\n\n/\n Internal implementation for useSelector with NamespacedSystem.\n * Subscribes to all module namespaces and runs the selector against the system.\n * Uses equality comparison to prevent unnecessary re-renders.\n /\nfunction _useNamespacedSelectorImpl(\n // biome-ignore lint/suspicious/noExplicitAny: Internal impl\n system: NamespacedSystem<any>,\n // biome-ignore lint/suspicious/noExplicitAny: Internal impl\n selector: (state: any) => unknown,\n defaultValueArg?: unknown,\n equalityFnArg?: (a: unknown, b: unknown) => boolean,\n): unknown {\n const hasDefault = defaultValueArg !== undefined;\n const equalityFn = equalityFnArg ?? defaultEquality;\n\n const selectorRef = useRef(selector);\n const eqRef = useRef(equalityFn);\n const defaultValueRef = useRef(defaultValueArg);\n selectorRef.current = selector;\n eqRef.current = equalityFn;\n defaultValueRef.current = defaultValueArg;\n\n const cachedValue = useRef<unknown>(UNINITIALIZED);\n\n // Get all module namespace names for wildcard subscription\n const moduleNames = useMemo(() => Object.keys(system.facts), [system]);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n // Subscribe to all modules using wildcard keys\n const wildcardKeys = moduleNames.map((ns) => `${ns}.`);\n\n return system.subscribe(wildcardKeys, onStoreChange);\n },\n [system, moduleNames],\n );\n\n const getSnapshot = useCallback(() => {\n const newValue = selectorRef.current(system);\n const effectiveValue =\n newValue === undefined && hasDefault ? defaultValueRef.current : newValue;\n\n if (\n cachedValue.current !== UNINITIALIZED &&\n eqRef.current(cachedValue.current, effectiveValue)\n ) {\n return cachedValue.current;\n }\n\n cachedValue.current = effectiveValue;\n\n return effectiveValue;\n }, [system, hasDefault]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useDispatch\n// ============================================================================\n\nexport function useDispatch<S extends ModuleSchema>(\n system: SingleModuleSystem<S>,\n): (event: InferEvents<S>) => void {\n assertSystem(\"useDispatch\", system);\n return useCallback(\n (event: InferEvents<S>) => {\n system.dispatch(event);\n },\n [system],\n );\n}\n\n// ============================================================================\n// useWatch — derivation or fact side-effect (no re-render)\n// ============================================================================\n\n/** Watch a derivation or fact by key (auto-detected). When a key exists in both facts and derivations, the derivation overload takes priority. /\nexport function useWatch<\n S extends ModuleSchema,\n K extends keyof InferDerivations<S> & string,\n>(\n system: SingleModuleSystem<S>,\n key: K,\n callback: (\n newValue: InferDerivations<S>[K],\n prevValue: InferDerivations<S>[K] \| undefined,\n ) => void,\n): void;\n/* Watch a fact key with auto-detection. /\nexport function useWatch<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(\n system: SingleModuleSystem<S>,\n key: K,\n callback: (\n newValue: InferFacts<S>[K] \| undefined,\n prevValue: InferFacts<S>[K] \| undefined,\n ) => void,\n): void;\n\n/* Implementation /\nexport function useWatch(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n key: string,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation overload dispatch\n callback: (newValue: any, prevValue: any) => void,\n): void {\n assertSystem(\"useWatch\", system);\n\n const callbackRef = useRef(callback);\n callbackRef.current = callback;\n\n useEffect(() => {\n return system.watch(key, (newValue, prevValue) => {\n callbackRef.current(newValue, prevValue);\n });\n }, [system, key]);\n}\n\n// ============================================================================\n// useInspect — consolidated inspection hook\n// ============================================================================\n\n// InspectState is imported from ./shared.js and re-exported above\n\n/* Options for useInspect /\nexport interface UseInspectOptions {\n /* Throttle updates to this interval (ms). When set, uses useState instead of useSyncExternalStore. /\n throttleMs?: number;\n}\n\n/\n Hook to get consolidated system inspection data reactively.\n \n Merges isSettled, unmet/inflight requirements, and working state\n * into a single subscription. Optionally throttle updates.\n \n @example\n * ```tsx\n * const { isSettled, isWorking, hasUnmet } = useInspect(system);\n * const throttled = useInspect(system, { throttleMs: 200 });\n * ```\n /\nexport function useInspect(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n options?: UseInspectOptions,\n): InspectState {\n assertSystem(\"useInspect\", system);\n // Always call the sync version (useSyncExternalStore path) — no conditional hooks\n const syncState = _useInspectSync(system);\n\n const throttleMs = options?.throttleMs;\n const [deferredState, setDeferredState] = useState(syncState);\n const throttleRef = useRef<{\n throttled: (...args: unknown[]) => void;\n cleanup: () => void;\n } \| null>(null);\n\n // Create/recreate throttle when throttleMs changes\n useEffect(() => {\n if (!throttleMs \|\| throttleMs <= 0) {\n throttleRef.current?.cleanup();\n throttleRef.current = null;\n return;\n }\n // Clean up old throttle before creating new one\n throttleRef.current?.cleanup();\n throttleRef.current = createThrottle((...args: unknown[]) => {\n setDeferredState(args[0] as InspectState);\n }, throttleMs);\n return () => {\n throttleRef.current?.cleanup();\n throttleRef.current = null;\n };\n }, [throttleMs]);\n\n // Feed sync state through throttle after each render\n useEffect(() => {\n if (throttleRef.current) {\n throttleRef.current.throttled(syncState);\n }\n }, [syncState]);\n\n if (!throttleMs \|\| throttleMs <= 0) return syncState;\n return deferredState;\n}\n\nfunction _buildInspectState(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n): InspectState {\n return computeInspectState(system);\n}\n\nfunction _useInspectSync(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n): InspectState {\n const cachedSnapshot = useRef<InspectState \| null>(null);\n const cachedUnmetIds = useRef<string[]>([]);\n const cachedInflightIds = useRef<string[]>([]);\n const cachedIsSettled = useRef<boolean \| null>(null);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const unsubFacts = system.facts.$store.subscribeAll(onStoreChange);\n const unsubSettled = system.onSettledChange(onStoreChange);\n return () => {\n unsubFacts();\n unsubSettled();\n };\n },\n [system],\n );\n\n const getSnapshot = useCallback(() => {\n const state = _buildInspectState(system);\n\n const unmetSame =\n state.unmet.length === cachedUnmetIds.current.length &&\n state.unmet.every((u, i) => u.id === cachedUnmetIds.current[i]);\n const inflightSame =\n state.inflight.length === cachedInflightIds.current.length &&\n state.inflight.every((f, i) => f.id === cachedInflightIds.current[i]);\n const settledSame = state.isSettled === cachedIsSettled.current;\n\n if (unmetSame && inflightSame && settledSame && cachedSnapshot.current) {\n return cachedSnapshot.current;\n }\n\n cachedSnapshot.current = state;\n cachedUnmetIds.current = state.unmet.map((u) => u.id);\n cachedInflightIds.current = state.inflight.map((f) => f.id);\n cachedIsSettled.current = state.isSettled;\n\n return state;\n }, [system]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useHistory — reactive history state\n// ============================================================================\n\n/\n Reactive history hook. Returns null when history is disabled.\n * Re-renders when snapshots are taken or navigation occurs.\n \n @example\n * ```tsx\n * const history = useHistory(system);\n * if (history) {\n * return (\n * <div>\n * <button disabled={!history.canGoBack} onClick={() => history.goBack()}>Undo</button>\n * <button disabled={!history.canGoForward} onClick={() => history.goForward()}>Redo</button>\n * <span>{history.currentIndex + 1} / {history.totalSnapshots}</span>\n * </div>\n * );\n * }\n * ```\n /\nexport function useHistory(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n): HistoryState \| null {\n assertSystem(\"useHistory\", system);\n const cachedRef = useRef<HistoryState \| null>(null);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => system.onHistoryChange(onStoreChange),\n [system],\n );\n\n const getSnapshot = useCallback(() => {\n const state = buildHistoryState(system);\n if (!state) return null;\n\n // Return stable reference when values haven't changed\n if (\n cachedRef.current &&\n cachedRef.current.canGoBack === state.canGoBack &&\n cachedRef.current.canGoForward === state.canGoForward &&\n cachedRef.current.currentIndex === state.currentIndex &&\n cachedRef.current.totalSnapshots === state.totalSnapshots &&\n cachedRef.current.isPaused === state.isPaused\n ) {\n return cachedRef.current;\n }\n\n cachedRef.current = state;\n return cachedRef.current;\n }, [system]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useRequirementStatus — single or multi\n// ============================================================================\n\n/* Single type overload /\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus;\n\n/* Multi-type overload /\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus>;\n\n/* Implementation /\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n typeOrTypes: string \| string[],\n): RequirementTypeStatus \| Record<string, RequirementTypeStatus> {\n if (Array.isArray(typeOrTypes)) {\n return _useRequirementStatusMulti(statusPlugin, typeOrTypes);\n }\n return _useRequirementStatusSingle(statusPlugin, typeOrTypes);\n}\n\nfunction _useRequirementStatusSingle(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus {\n const cachedRef = useRef<RequirementTypeStatus \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return statusPlugin.subscribe(onStoreChange);\n },\n [statusPlugin],\n );\n\n const getSnapshot = useCallback(() => {\n const status = statusPlugin.getStatus(type);\n\n if (cachedRef.current !== UNINITIALIZED) {\n const prev = cachedRef.current;\n if (\n prev.pending === status.pending &&\n prev.inflight === status.inflight &&\n prev.failed === status.failed &&\n prev.isLoading === status.isLoading &&\n prev.hasError === status.hasError &&\n prev.lastError === status.lastError\n ) {\n return cachedRef.current;\n }\n }\n\n cachedRef.current = status;\n return status;\n }, [statusPlugin, type]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction _useRequirementStatusMulti(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus> {\n const cachedRef = useRef<Record<string, RequirementTypeStatus> \| null>(null);\n const cachedKey = useRef<string>(\"\");\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return statusPlugin.subscribe(onStoreChange);\n },\n [statusPlugin],\n );\n\n const getSnapshot = useCallback(() => {\n const result: Record<string, RequirementTypeStatus> = {};\n const parts: string[] = [];\n for (const type of types) {\n const status = statusPlugin.getStatus(type);\n result[type] = status;\n parts.push(\n `${type}:${status.pending}:${status.inflight}:${status.failed}:${status.hasError}:${status.lastError?.message ?? \"\"}`,\n );\n }\n const key = parts.join(\"\|\");\n\n if (key !== cachedKey.current) {\n cachedKey.current = key;\n cachedRef.current = result;\n }\n\n return cachedRef.current ?? result;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [statusPlugin, ...types]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useSuspenseRequirement — single or multi\n// ============================================================================\n\n// Cache for pending promises, scoped per statusPlugin to prevent cross-system leaks.\nconst suspenseCacheMap = new WeakMap<\n StatusPlugin,\n Map<string, Promise<void>>\n>();\n\nfunction getSuspenseCache(plugin: StatusPlugin): Map<string, Promise<void>> {\n let cache = suspenseCacheMap.get(plugin);\n if (!cache) {\n cache = new Map();\n suspenseCacheMap.set(plugin, cache);\n }\n return cache;\n}\n\n/* Single type overload /\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus;\n\n/* Multi-type overload /\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus>;\n\n/* Implementation /\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n typeOrTypes: string \| string[],\n): RequirementTypeStatus \| Record<string, RequirementTypeStatus> {\n if (Array.isArray(typeOrTypes)) {\n return _useSuspenseRequirementMulti(statusPlugin, typeOrTypes);\n }\n return _useSuspenseRequirementSingle(statusPlugin, typeOrTypes);\n}\n\nfunction _useSuspenseRequirementSingle(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus {\n const status = statusPlugin.getStatus(type);\n\n if (status.hasError && status.lastError) {\n throw status.lastError;\n }\n\n if (status.isLoading) {\n const cache = getSuspenseCache(statusPlugin);\n let promise = cache.get(type);\n\n if (!promise) {\n promise = new Promise<void>((resolve) => {\n const unsubscribe = statusPlugin.subscribe(() => {\n const currentStatus = statusPlugin.getStatus(type);\n if (!currentStatus.isLoading) {\n cache.delete(type);\n unsubscribe();\n resolve();\n }\n });\n });\n cache.set(type, promise);\n }\n\n throw promise;\n }\n\n return status;\n}\n\nfunction _useSuspenseRequirementMulti(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus> {\n const result: Record<string, RequirementTypeStatus> = {};\n let hasLoading = false;\n let firstError: Error \| null = null;\n\n for (const type of types) {\n const status = statusPlugin.getStatus(type);\n result[type] = status;\n\n if (status.hasError && status.lastError && !firstError) {\n firstError = status.lastError;\n }\n if (status.isLoading) {\n hasLoading = true;\n }\n }\n\n if (firstError) {\n throw firstError;\n }\n\n if (hasLoading) {\n const cache = getSuspenseCache(statusPlugin);\n const cacheKey = types.slice().sort().join(\",\");\n let promise = cache.get(cacheKey);\n\n if (!promise) {\n promise = new Promise<void>((resolve) => {\n const unsubscribe = statusPlugin.subscribe(() => {\n const allDone = types.every(\n (t) => !statusPlugin.getStatus(t).isLoading,\n );\n if (allDone) {\n cache.delete(cacheKey);\n unsubscribe();\n resolve();\n }\n });\n });\n cache.set(cacheKey, promise);\n }\n\n throw promise;\n }\n\n return result;\n}\n\n// ============================================================================\n// useDirectiveRef — scoped system lifecycle\n// ============================================================================\n\n/* Base options for creating a scoped system /\ninterface DirectiveRefBaseConfig {\n // biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n plugins?: Plugin<any>[];\n history?: HistoryOption;\n trace?: TraceOption;\n errorBoundary?: ErrorBoundaryConfig;\n tickMs?: number;\n zeroConfig?: boolean;\n // biome-ignore lint/suspicious/noExplicitAny: Facts type varies\n initialFacts?: Record<string, any>;\n}\n\n/* Options for useDirectiveRef: module directly, or config object /\nexport type UseDirectiveRefOptions<M extends ModuleSchema> =\n \| ModuleDef<M>\n \| (DirectiveRefBaseConfig & { module: ModuleDef<M> });\n\n/* Options for useDirectiveRef with namespaced modules /\nexport type UseDirectiveRefNamespacedOptions<Modules extends ModulesMap> =\n DirectiveRefBaseConfig & { modules: { [K in keyof Modules]: Modules[K] } };\n\n// --- Single-module overloads ---\n\n/* Without status (no config): returns system directly /\nexport function useDirectiveRef<M extends ModuleSchema>(\n options: UseDirectiveRefOptions<M>,\n): SingleModuleSystem<M>;\n\n/* Without status (with config): returns system directly /\nexport function useDirectiveRef<M extends ModuleSchema>(\n options: UseDirectiveRefOptions<M>,\n config: DirectiveRefBaseConfig,\n): SingleModuleSystem<M>;\n\n/* With status: returns { system, statusPlugin } /\nexport function useDirectiveRef<M extends ModuleSchema>(\n options: UseDirectiveRefOptions<M>,\n config: { status: true } & DirectiveRefBaseConfig,\n): { system: SingleModuleSystem<M>; statusPlugin: StatusPlugin };\n\n// --- Namespaced (multi-module) overloads ---\n\n/* Namespaced: returns NamespacedSystem directly /\nexport function useDirectiveRef<const Modules extends ModulesMap>(\n options: UseDirectiveRefNamespacedOptions<Modules>,\n): NamespacedSystem<Modules>;\n\n/* Namespaced with config: returns NamespacedSystem directly /\nexport function useDirectiveRef<const Modules extends ModulesMap>(\n options: UseDirectiveRefNamespacedOptions<Modules>,\n config: DirectiveRefBaseConfig,\n): NamespacedSystem<Modules>;\n\n/* Implementation /\nexport function useDirectiveRef(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature handles both modes\n options: any,\n config?: { status?: boolean } & DirectiveRefBaseConfig,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation return varies by overload\n): any {\n // biome-ignore lint/suspicious/noExplicitAny: System ref holds either system type\n const systemRef = useRef<any>(null);\n const statusPluginRef = useRef<StatusPlugin \| null>(null);\n // Factory ref for strict mode re-creation (effects unmount then re-mount)\n // biome-ignore lint/suspicious/noExplicitAny: Factory return type varies\n const factoryRef = useRef<(() => any) \| null>(null);\n const wantStatus = config?.status === true;\n const isNamespaced = \"modules\" in options;\n\n if (!systemRef.current) {\n // Build a factory that creates + starts the system.\n // Called once during render and again on strict-mode re-mount.\n factoryRef.current = () => {\n if (isNamespaced) {\n // --- Namespaced mode: { modules: { ... } } ---\n const { modules, ...rest } = options;\n const plugins = config?.plugins ?? rest.plugins ?? [];\n const history = config?.history ?? rest.history;\n const trace = config?.trace ?? rest.trace;\n const errorBoundary = config?.errorBoundary ?? rest.errorBoundary;\n const tickMs = config?.tickMs ?? rest.tickMs;\n const zeroConfig = config?.zeroConfig ?? rest.zeroConfig;\n const initialFacts = config?.initialFacts ?? rest.initialFacts;\n\n const sys = createSystem({\n modules,\n plugins: plugins.length > 0 ? plugins : undefined,\n history,\n trace,\n errorBoundary,\n tickMs,\n zeroConfig,\n initialFacts,\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n } as any);\n // Always initialize facts/derivations (safe for SSR).\n // Only start reconciliation on the client.\n sys.initialize();\n if (typeof window !== \"undefined\") {\n sys.start();\n }\n\n return sys;\n }\n\n // --- Single-module mode ---\n const isModule = \"id\" in options && \"schema\" in options;\n const mod = isModule ? options : options.module;\n const baseOpts = isModule ? {} : (options as DirectiveRefBaseConfig);\n const plugins = config?.plugins ?? baseOpts.plugins ?? [];\n const history = config?.history ?? baseOpts.history;\n const trace = config?.trace ?? baseOpts.trace;\n const errorBoundary = config?.errorBoundary ?? baseOpts.errorBoundary;\n const tickMs = config?.tickMs ?? baseOpts.tickMs;\n const zeroConfig = config?.zeroConfig ?? baseOpts.zeroConfig;\n const initialFacts = config?.initialFacts ?? baseOpts.initialFacts;\n\n let allPlugins = [...plugins];\n\n if (wantStatus) {\n statusPluginRef.current = createRequirementStatusPlugin();\n // biome-ignore lint/suspicious/noExplicitAny: Plugin generic issues\n allPlugins = [\n ...allPlugins,\n statusPluginRef.current.plugin as Plugin<any>,\n ];\n }\n\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n const sys = createSystem({\n module: mod,\n plugins: allPlugins.length > 0 ? allPlugins : undefined,\n history,\n trace,\n errorBoundary,\n tickMs,\n zeroConfig,\n initialFacts,\n } as any);\n // Always initialize facts/derivations (safe for SSR).\n // Only start reconciliation on the client.\n sys.initialize();\n if (typeof window !== \"undefined\") {\n sys.start();\n }\n\n return sys;\n };\n\n // Start synchronously so facts are initialized before the first render\n systemRef.current = factoryRef.current();\n }\n\n useEffect(() => {\n // Strict mode re-mount: system was destroyed in cleanup, recreate it\n if (!systemRef.current && factoryRef.current) {\n systemRef.current = factoryRef.current();\n }\n\n return () => {\n systemRef.current?.destroy();\n systemRef.current = null;\n statusPluginRef.current = null;\n };\n }, []);\n\n if (wantStatus && !isNamespaced) {\n return {\n system: systemRef.current!,\n statusPlugin: statusPluginRef.current!,\n };\n }\n\n return systemRef.current!;\n}\n\n// ============================================================================\n// useNamespacedSelector — select from a NamespacedSystem with useSyncExternalStore\n// ============================================================================\n\n/\n React hook to select derived values from a NamespacedSystem.\n * Uses useSyncExternalStore for tear-free reads.\n \n @param system - The namespaced system to read from\n * @param keys - Namespaced keys to subscribe to (e.g., [\"auth.token\", \"data.count\"])\n * @param selector - Function that reads from system.facts / system.derive\n \n @example\n * ```tsx\n * const system = useDirectiveRef({ modules: { auth, data } });\n * const token = useNamespacedSelector(system, [\"auth.token\"], (s) => s.facts.auth.token);\n * const count = useNamespacedSelector(system, [\"data.\"], (s) => s.derive.data.total);\n ```\n /\nexport function useNamespacedSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n keys: string[],\n selector: (system: NamespacedSystem<Modules>) => R,\n): R {\n const keysRef = useRef(keys);\n keysRef.current = keys;\n const selectorRef = useRef(selector);\n selectorRef.current = selector;\n\n const subscribe = useCallback(\n (onStoreChange: () => void) =>\n system.subscribe(keysRef.current, onStoreChange),\n [system],\n );\n\n const getSnapshot = useCallback(() => selectorRef.current(system), [system]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useDirective — scoped system with selected values in containers\n// ============================================================================\n\n/* Options for useDirective hook /\nexport interface UseDirectiveOptions<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string = never,\n DK extends keyof InferDerivations<S> & string = never,\n> extends DirectiveRefBaseConfig {\n /* Fact keys to subscribe to /\n facts?: FK[];\n /* Derivation keys to subscribe to /\n derived?: DK[];\n /* Enable status plugin /\n status?: boolean;\n}\n\n/* Return type for useDirective hook (without status) /\nexport type UseDirectiveReturn<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string,\n DK extends keyof InferDerivations<S> & string,\n> = {\n system: SingleModuleSystem<S>;\n dispatch: (event: InferEvents<S>) => void;\n events: SingleModuleSystem<S>[\"events\"];\n facts: Pick<InferFacts<S>, FK>;\n derived: Pick<InferDerivations<S>, DK>;\n};\n\n/* Return type for useDirective hook (with status) /\nexport type UseDirectiveReturnWithStatus<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string,\n DK extends keyof InferDerivations<S> & string,\n> = UseDirectiveReturn<S, FK, DK> & {\n statusPlugin: StatusPlugin;\n};\n\n/\n Convenience hook that creates a scoped system and reads selected facts/derivations\n * into container objects. When no `facts` or `derived` keys are specified, subscribes\n * to ALL facts and derivations (replacing the former `useModule` hook).\n \n @example\n * ```tsx\n * // Selective subscription\n * const { dispatch, facts: { count }, derived: { doubled } } = useDirective(counterModule, {\n * facts: [\"count\"],\n * derived: [\"doubled\"],\n * });\n \n // Subscribe to everything (no keys = all facts + all derivations)\n * const { facts, derived, events, dispatch } = useDirective(counterModule);\n * ```\n /\nexport function useDirective<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string = never,\n DK extends keyof InferDerivations<S> & string = never,\n>(\n moduleOrOptions: UseDirectiveRefOptions<S>,\n selections: UseDirectiveOptions<S, FK, DK> = {} as UseDirectiveOptions<\n S,\n FK,\n DK\n >,\n): UseDirectiveReturn<S, FK, DK> \| UseDirectiveReturnWithStatus<S, FK, DK> {\n const {\n facts: factKeysOpt,\n derived: derivedKeysOpt,\n status,\n ...configRest\n } = selections;\n const factKeys = (factKeysOpt ?? []) as FK[];\n const derivedKeys = (derivedKeysOpt ?? []) as DK[];\n\n // When no keys are specified, subscribe to everything\n const subscribeAll = factKeys.length === 0 && derivedKeys.length === 0;\n\n // Create system via useDirectiveRef (handles lifecycle)\n // biome-ignore lint/suspicious/noExplicitAny: Conditional overload dispatch\n const refResult: any = status\n ? useDirectiveRef(moduleOrOptions, { status: true as const, ...configRest })\n : useDirectiveRef(moduleOrOptions, configRest);\n\n const system: SingleModuleSystem<S> = status ? refResult.system : refResult;\n\n const statusPlugin = status\n ? (\n refResult as {\n system: SingleModuleSystem<S>;\n statusPlugin: StatusPlugin;\n }\n ).statusPlugin\n : undefined;\n\n // For subscribe-all mode, get all derivation keys\n const allDerivationKeys = useMemo(\n () => (subscribeAll ? Object.keys(system.derive) : []),\n [system, subscribeAll],\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const unsubs: Array<() => void> = [];\n if (subscribeAll) {\n // Subscribe to ALL facts and ALL derivations\n unsubs.push(system.facts.$store.subscribeAll(onStoreChange));\n if (allDerivationKeys.length > 0) {\n unsubs.push(system.subscribe(allDerivationKeys, onStoreChange));\n }\n } else {\n if (factKeys.length > 0) {\n unsubs.push(system.facts.$store.subscribe(factKeys, onStoreChange));\n }\n if (derivedKeys.length > 0) {\n unsubs.push(system.subscribe(derivedKeys, onStoreChange));\n }\n }\n return () => {\n for (const unsub of unsubs) unsub();\n };\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [system, subscribeAll, ...factKeys, ...derivedKeys, ...allDerivationKeys],\n );\n\n const cachedFacts = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n const cachedDerived = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n const cachedWrapper = useRef<{\n facts: Record<string, unknown>;\n derived: Record<string, unknown>;\n } \| null>(null);\n\n const getSnapshot = useCallback(() => {\n let factsResult: Record<string, unknown>;\n let derivedResult: Record<string, unknown>;\n let effectiveFactKeys: readonly string[];\n let effectiveDerivedKeys: readonly string[];\n\n if (subscribeAll) {\n // Read ALL facts and ALL derivations\n factsResult = system.facts.$store.toObject();\n effectiveFactKeys = Object.keys(factsResult);\n derivedResult = {};\n for (const key of allDerivationKeys) {\n derivedResult[key] = system.read(key);\n }\n effectiveDerivedKeys = allDerivationKeys;\n } else {\n // Read selected keys only\n factsResult = {};\n for (const key of factKeys) {\n // biome-ignore lint/suspicious/noExplicitAny: Dynamic fact access\n factsResult[key] = (system.facts as any)[key];\n }\n effectiveFactKeys = factKeys;\n derivedResult = {};\n for (const key of derivedKeys) {\n derivedResult[key] = system.read(key);\n }\n effectiveDerivedKeys = derivedKeys;\n }\n\n // Check facts stability\n let factsSame = cachedFacts.current !== UNINITIALIZED;\n if (factsSame) {\n const prev = cachedFacts.current as Record<string, unknown>;\n const prevKeys = Object.keys(prev);\n if (prevKeys.length !== effectiveFactKeys.length) {\n factsSame = false;\n } else {\n for (const key of effectiveFactKeys) {\n if (!Object.is(prev[key], factsResult[key])) {\n factsSame = false;\n break;\n }\n }\n }\n }\n\n // Check derived stability\n let derivedSame = cachedDerived.current !== UNINITIALIZED;\n if (derivedSame) {\n const prev = cachedDerived.current as Record<string, unknown>;\n const prevKeys = Object.keys(prev);\n if (prevKeys.length !== effectiveDerivedKeys.length) {\n derivedSame = false;\n } else {\n for (const key of effectiveDerivedKeys) {\n if (!Object.is(prev[key], derivedResult[key])) {\n derivedSame = false;\n break;\n }\n }\n }\n }\n\n const stableFacts = factsSame\n ? (cachedFacts.current as Record<string, unknown>)\n : factsResult;\n const stableDerived = derivedSame\n ? (cachedDerived.current as Record<string, unknown>)\n : derivedResult;\n\n if (!factsSame) cachedFacts.current = factsResult;\n if (!derivedSame) cachedDerived.current = derivedResult;\n\n // Return same wrapper reference when both containers are unchanged\n if (factsSame && derivedSame && cachedWrapper.current) {\n return cachedWrapper.current;\n }\n\n cachedWrapper.current = { facts: stableFacts, derived: stableDerived };\n return cachedWrapper.current;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, subscribeAll, ...factKeys, ...derivedKeys, ...allDerivationKeys]);\n\n const values = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n const dispatch = useCallback(\n (event: InferEvents<S>) => system.dispatch(event),\n [system],\n );\n\n const events = useEvents(system);\n\n const base = {\n system,\n dispatch,\n events,\n facts: values.facts as Pick<InferFacts<S>, FK>,\n derived: values.derived as Pick<InferDerivations<S>, DK>,\n };\n\n if (status && statusPlugin) {\n return { ...base, statusPlugin } as UseDirectiveReturnWithStatus<S, FK, DK>;\n }\n\n return base as UseDirectiveReturn<S, FK, DK>;\n}\n\n// ============================================================================\n// useEvents — memoized events reference\n// ============================================================================\n\n/\n Returns the system's events dispatcher. Provides autocomplete for event names\n * and avoids needing useCallback wrappers for event dispatch.\n \n @example\n * ```tsx\n * const events = useEvents(system);\n * <button onClick={() => events.increment()}>+</button>\n * ```\n /\nexport function useEvents<S extends ModuleSchema>(\n system: SingleModuleSystem<S>,\n): SingleModuleSystem<S>[\"events\"] {\n assertSystem(\"useEvents\", system);\n return useMemo(() => system.events, [system]);\n}\n\n// ============================================================================\n// useExplain — reactive requirement explanation\n// ============================================================================\n\n/\n Reactively returns the explanation string for a requirement.\n * Updates whenever system state changes.\n \n @example\n * ```tsx\n * const explanation = useExplain(system, \"req-123\");\n * if (explanation) <pre>{explanation}</pre>;\n * ```\n /\nexport function useExplain(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n requirementId: string,\n): string \| null {\n assertSystem(\"useExplain\", system);\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const unsubFacts = system.facts.$store.subscribeAll(onStoreChange);\n const unsubSettled = system.onSettledChange(onStoreChange);\n return () => {\n unsubFacts();\n unsubSettled();\n };\n },\n [system],\n );\n\n const getSnapshot = useCallback(() => {\n return system.explain(requirementId);\n }, [system, requirementId]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useConstraintStatus — reactive constraint inspection\n// ============================================================================\n\n// ConstraintInfo is imported from ./shared.js and re-exported above\n\n/* Get all constraints /\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n): ConstraintInfo[];\n/* Get a single constraint by ID /\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n constraintId: string,\n): ConstraintInfo \| null;\n/* Implementation /\nexport function useConstraintStatus(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n constraintId?: string,\n): ConstraintInfo[] \| ConstraintInfo \| null {\n assertSystem(\"useConstraintStatus\", system);\n const inspectState = useInspect(system);\n\n return useMemo(() => {\n const inspection = system.inspect();\n if (!constraintId) return inspection.constraints;\n return inspection.constraints.find((c) => c.id === constraintId) ?? null;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, constraintId, inspectState]);\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\n/* Result of useOptimisticUpdate /\nexport interface OptimisticUpdateResult {\n /* Apply an optimistic update (saves snapshot, then runs updateFn in batch) /\n mutate: (updateFn: () => void) => void;\n /* Whether a resolver is currently processing the optimistic change /\n isPending: boolean;\n /* Error if the resolver failed /\n error: Error \| null;\n /* Manually rollback to the pre-mutation snapshot /\n rollback: () => void;\n}\n\n/\n Optimistic update hook. Saves a snapshot before mutating, monitors\n * a requirement type via statusPlugin, and rolls back on failure.\n \n @example\n * ```tsx\n * const { mutate, isPending, error, rollback } = useOptimisticUpdate(\n * system, statusPlugin, \"SAVE_ITEM\"\n * );\n * mutate(() => { system.facts.items = [...system.facts.items, newItem]; });\n * ```\n /\nexport function useOptimisticUpdate(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n statusPlugin?: StatusPlugin,\n requirementType?: string,\n): OptimisticUpdateResult {\n assertSystem(\"useOptimisticUpdate\", system);\n const [isPending, setIsPending] = useState(false);\n const [error, setError] = useState<Error \| null>(null);\n const snapshotRef = useRef<SystemSnapshot \| null>(null);\n\n const rollback = useCallback(() => {\n if (snapshotRef.current) {\n system.restore(snapshotRef.current);\n snapshotRef.current = null;\n }\n setIsPending(false);\n setError(null);\n }, [system]);\n\n const mutate = useCallback(\n (updateFn: () => void) => {\n snapshotRef.current = system.getSnapshot();\n setIsPending(true);\n setError(null);\n system.batch(updateFn);\n },\n [system],\n );\n\n // Watch for resolver completion/failure\n useEffect(() => {\n if (!statusPlugin \|\| !requirementType \|\| !isPending) return;\n\n return statusPlugin.subscribe(() => {\n const status = statusPlugin.getStatus(requirementType);\n if (!status.isLoading && !status.hasError) {\n // Resolved successfully — keep optimistic state\n snapshotRef.current = null;\n setIsPending(false);\n } else if (status.hasError) {\n // Failed — rollback\n setError(status.lastError);\n rollback();\n }\n });\n }, [statusPlugin, requirementType, isPending, rollback]);\n\n return { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// DirectiveHydrator + useHydratedSystem — SSR/RSC hydration\n// ============================================================================\n\n/* Props for DirectiveHydrator component /\nexport interface HydratorProps {\n snapshot: DistributableSnapshot;\n children: ReactNode;\n}\n\n/* Context for hydrated snapshot /\nconst HydrationContext = createContext<DistributableSnapshot \| null>(null);\n\n/\n SSR/RSC hydration component. Wraps children with a snapshot context\n * that `useHydratedSystem` can consume on the client.\n \n @example\n * ```tsx\n * // Server component\n * <DirectiveHydrator snapshot={serverSnapshot}>\n * <ClientApp />\n * </DirectiveHydrator>\n * ```\n /\nexport function DirectiveHydrator({ snapshot, children }: HydratorProps) {\n return (\n <HydrationContext.Provider value={snapshot}>\n {children}\n </HydrationContext.Provider>\n );\n}\n\n/\n Client-side hook that creates a system hydrated from a server snapshot.\n * Must be used inside a `<DirectiveHydrator>`.\n \n @example\n * ```tsx\n * function ClientApp() {\n * const system = useHydratedSystem(counterModule);\n * const count = useFact(system, \"count\");\n * return <div>{count}</div>;\n * }\n * ```\n */\nexport function useHydratedSystem<S extends ModuleSchema>(\n moduleDef: ModuleDef<S>,\n config?: DirectiveRefBaseConfig,\n): SingleModuleSystem<S> {\n const snapshot = useContext(HydrationContext);\n\n // Merge snapshot data as initial facts if available\n const mergedConfig = useMemo(() => {\n if (!snapshot?.data) return config ?? {};\n return {\n ...(config ?? {}),\n initialFacts: {\n ...(config?.initialFacts ?? {}),\n ...snapshot.data,\n },\n };\n }, [snapshot, config]);\n\n return useDirectiveRef(moduleDef, mergedConfig) as SingleModuleSystem<S>;\n}\n"]}

package/dist/index.d.cts CHANGED Viewed

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { DistributableSnapshot, createRequirementStatusPlugin, ModuleSchema, InferFacts, InferDerivations, Plugin, DebugConfig, ErrorBoundaryConfig, ModulesMap, ModuleDef, SingleModuleSystem, InferEvents, NamespacedSystem, RequirementTypeStatus, InferSelectorState, TimeTravelState } from '@directive-run/core';
+import { DistributableSnapshot, createRequirementStatusPlugin, ModuleSchema, InferFacts, InferDerivations, Plugin, HistoryOption, TraceOption, ErrorBoundaryConfig, ModulesMap, ModuleDef, SingleModuleSystem, InferEvents, NamespacedSystem, HistoryState, RequirementTypeStatus, InferSelectorState } from '@directive-run/core';
 export { RequirementTypeStatus } from '@directive-run/core';
 import { ConstraintInfo, InspectState } from '@directive-run/core/adapter-utils';
 export { ConstraintInfo, InspectState, shallowEqual } from '@directive-run/core/adapter-utils';
@@ -76,24 +76,24 @@ interface UseInspectOptions {
  */
 declare function useInspect(system: SingleModuleSystem<any>, options?: UseInspectOptions): InspectState;
 /**
- * Reactive time-travel hook. Returns null when time-travel is disabled.
+ * Reactive history hook. Returns null when history is disabled.
  * Re-renders when snapshots are taken or navigation occurs.
  *
  * @example
  * ```tsx
- * const tt = useTimeTravel(system);
- * if (tt) {
+ * const history = useHistory(system);
+ * if (history) {
  *   return (
  *     <div>
- *       <button disabled={!tt.canUndo} onClick={tt.undo}>Undo</button>
- *       <button disabled={!tt.canRedo} onClick={tt.redo}>Redo</button>
- *       <span>{tt.currentIndex + 1} / {tt.totalSnapshots}</span>
+ *       <button disabled={!history.canGoBack} onClick={() => history.goBack()}>Undo</button>
+ *       <button disabled={!history.canGoForward} onClick={() => history.goForward()}>Redo</button>
+ *       <span>{history.currentIndex + 1} / {history.totalSnapshots}</span>
  *     </div>
  *   );
  * }
  * ```
  */
-declare function useTimeTravel(system: SingleModuleSystem<any>): TimeTravelState | null;
+declare function useHistory(system: SingleModuleSystem<any>): HistoryState | null;
 /** Single type overload */
 declare function useRequirementStatus(statusPlugin: StatusPlugin, type: string): RequirementTypeStatus;
 /** Multi-type overload */
@@ -105,7 +105,8 @@ declare function useSuspenseRequirement(statusPlugin: StatusPlugin, types: strin
 /** Base options for creating a scoped system */
 interface DirectiveRefBaseConfig {
     plugins?: Plugin<any>[];
-    debug?: DebugConfig;
+    history?: HistoryOption;
+    trace?: TraceOption;
     errorBoundary?: ErrorBoundaryConfig;
     tickMs?: number;
     zeroConfig?: boolean;
@@ -274,4 +275,4 @@ declare function DirectiveHydrator({ snapshot, children }: HydratorProps): react
  */
 declare function useHydratedSystem<S extends ModuleSchema>(moduleDef: ModuleDef<S>, config?: DirectiveRefBaseConfig): SingleModuleSystem<S>;
-export { DirectiveHydrator, type HydratorProps, type OptimisticUpdateResult, type StatusPlugin, type UseDirectiveOptions, type UseDirectiveRefNamespacedOptions, type UseDirectiveRefOptions, type UseDirectiveReturn, type UseDirectiveReturnWithStatus, type UseInspectOptions, useConstraintStatus, useDerived, useDirective, useDirectiveRef, useDispatch, useEvents, useExplain, useFact, useHydratedSystem, useInspect, useNamespacedSelector, useOptimisticUpdate, useRequirementStatus, useSelector, useSuspenseRequirement, useTimeTravel, useWatch };
+export { DirectiveHydrator, type HydratorProps, type OptimisticUpdateResult, type StatusPlugin, type UseDirectiveOptions, type UseDirectiveRefNamespacedOptions, type UseDirectiveRefOptions, type UseDirectiveReturn, type UseDirectiveReturnWithStatus, type UseInspectOptions, useConstraintStatus, useDerived, useDirective, useDirectiveRef, useDispatch, useEvents, useExplain, useFact, useHistory, useHydratedSystem, useInspect, useNamespacedSelector, useOptimisticUpdate, useRequirementStatus, useSelector, useSuspenseRequirement, useWatch };

package/dist/index.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { DistributableSnapshot, createRequirementStatusPlugin, ModuleSchema, InferFacts, InferDerivations, Plugin, DebugConfig, ErrorBoundaryConfig, ModulesMap, ModuleDef, SingleModuleSystem, InferEvents, NamespacedSystem, RequirementTypeStatus, InferSelectorState, TimeTravelState } from '@directive-run/core';
+import { DistributableSnapshot, createRequirementStatusPlugin, ModuleSchema, InferFacts, InferDerivations, Plugin, HistoryOption, TraceOption, ErrorBoundaryConfig, ModulesMap, ModuleDef, SingleModuleSystem, InferEvents, NamespacedSystem, HistoryState, RequirementTypeStatus, InferSelectorState } from '@directive-run/core';
 export { RequirementTypeStatus } from '@directive-run/core';
 import { ConstraintInfo, InspectState } from '@directive-run/core/adapter-utils';
 export { ConstraintInfo, InspectState, shallowEqual } from '@directive-run/core/adapter-utils';
@@ -76,24 +76,24 @@ interface UseInspectOptions {
  */
 declare function useInspect(system: SingleModuleSystem<any>, options?: UseInspectOptions): InspectState;
 /**
- * Reactive time-travel hook. Returns null when time-travel is disabled.
+ * Reactive history hook. Returns null when history is disabled.
  * Re-renders when snapshots are taken or navigation occurs.
  *
  * @example
  * ```tsx
- * const tt = useTimeTravel(system);
- * if (tt) {
+ * const history = useHistory(system);
+ * if (history) {
  *   return (
  *     <div>
- *       <button disabled={!tt.canUndo} onClick={tt.undo}>Undo</button>
- *       <button disabled={!tt.canRedo} onClick={tt.redo}>Redo</button>
- *       <span>{tt.currentIndex + 1} / {tt.totalSnapshots}</span>
+ *       <button disabled={!history.canGoBack} onClick={() => history.goBack()}>Undo</button>
+ *       <button disabled={!history.canGoForward} onClick={() => history.goForward()}>Redo</button>
+ *       <span>{history.currentIndex + 1} / {history.totalSnapshots}</span>
  *     </div>
  *   );
  * }
  * ```
  */
-declare function useTimeTravel(system: SingleModuleSystem<any>): TimeTravelState | null;
+declare function useHistory(system: SingleModuleSystem<any>): HistoryState | null;
 /** Single type overload */
 declare function useRequirementStatus(statusPlugin: StatusPlugin, type: string): RequirementTypeStatus;
 /** Multi-type overload */
@@ -105,7 +105,8 @@ declare function useSuspenseRequirement(statusPlugin: StatusPlugin, types: strin
 /** Base options for creating a scoped system */
 interface DirectiveRefBaseConfig {
     plugins?: Plugin<any>[];
-    debug?: DebugConfig;
+    history?: HistoryOption;
+    trace?: TraceOption;
     errorBoundary?: ErrorBoundaryConfig;
     tickMs?: number;
     zeroConfig?: boolean;
@@ -274,4 +275,4 @@ declare function DirectiveHydrator({ snapshot, children }: HydratorProps): react
  */
 declare function useHydratedSystem<S extends ModuleSchema>(moduleDef: ModuleDef<S>, config?: DirectiveRefBaseConfig): SingleModuleSystem<S>;
-export { DirectiveHydrator, type HydratorProps, type OptimisticUpdateResult, type StatusPlugin, type UseDirectiveOptions, type UseDirectiveRefNamespacedOptions, type UseDirectiveRefOptions, type UseDirectiveReturn, type UseDirectiveReturnWithStatus, type UseInspectOptions, useConstraintStatus, useDerived, useDirective, useDirectiveRef, useDispatch, useEvents, useExplain, useFact, useHydratedSystem, useInspect, useNamespacedSelector, useOptimisticUpdate, useRequirementStatus, useSelector, useSuspenseRequirement, useTimeTravel, useWatch };
+export { DirectiveHydrator, type HydratorProps, type OptimisticUpdateResult, type StatusPlugin, type UseDirectiveOptions, type UseDirectiveRefNamespacedOptions, type UseDirectiveRefOptions, type UseDirectiveReturn, type UseDirectiveReturnWithStatus, type UseInspectOptions, useConstraintStatus, useDerived, useDirective, useDirectiveRef, useDispatch, useEvents, useExplain, useFact, useHistory, useHydratedSystem, useInspect, useNamespacedSelector, useOptimisticUpdate, useRequirementStatus, useSelector, useSuspenseRequirement, useWatch };

package/dist/index.js CHANGED Viewed

@@ -1,2 +1,2 @@
-import {createSystem,createRequirementStatusPlugin}from'@directive-run/core';import {assertSystem,defaultEquality,runTrackedSelector,createThrottle,buildTimeTravelState,depsChanged,computeInspectState}from'@directive-run/core/adapter-utils';export{shallowEqual}from'@directive-run/core/adapter-utils';import {createContext,useCallback,useSyncExternalStore,useRef,useMemo,useEffect,useState,useContext}from'react';import {jsx}from'react/jsx-runtime';var h=Symbol("directive.uninitialized");function Re(e,t){return assertSystem("useFact",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useFact() received a function. Did you mean useSelector()? useFact() takes a string key or array of keys, not a selector function."),Array.isArray(t)?ne(e,t):te(e,t)}function te(e,t){process.env.NODE_ENV!=="production"&&(t in e.facts.$store.toObject()||console.warn(`[Directive] useFact("${t}") \u2014 fact not found in store. Check that "${t}" is defined in your module's schema.`));let r=useCallback(n=>e.facts.$store.subscribe([t],n),[e,t]),u=useCallback(()=>e.facts[t],[e,t]);return useSyncExternalStore(r,u,u)}function ne(e,t){let r=useRef(h),u=useCallback(o=>e.facts.$store.subscribe(t,o),[e,...t]),n=useCallback(()=>{let o={};for(let s of t)o[s]=e.facts[s];if(r.current!==h){let s=true;for(let i of t)if(!Object.is(r.current[i],o[i])){s=false;break}if(s)return r.current}return r.current=o,o},[e,...t]);return useSyncExternalStore(u,n,n)}function be(e,t){return assertSystem("useDerived",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useDerived() received a function. Did you mean useSelector()? useDerived() takes a string key or array of keys, not a selector function."),Array.isArray(t)?se(e,t):re(e,t)}function re(e,t){process.env.NODE_ENV!=="production"&&(t in e.derive||console.warn(`[Directive] useDerived("${t}") \u2014 derivation not found. Check that "${t}" is defined in your module's derive property.`));let r=useCallback(n=>e.subscribe([t],n),[e,t]),u=useCallback(()=>e.read(t),[e,t]);return useSyncExternalStore(r,u,u)}function se(e,t){let r=useRef(h),u=useCallback(o=>e.subscribe(t,o),[e,...t]),n=useCallback(()=>{let o={};for(let s of t)o[s]=e.read(s);if(r.current!==h){let s=true;for(let i of t)if(!Object.is(r.current[i],o[i])){s=false;break}if(s)return r.current}return r.current=o,o},[e,...t]);return useSyncExternalStore(u,n,n)}function he(e,t,r,u){if(e&&e._mode==="namespaced")return ue(e,t,r,u);let n=e,o,s=false,i=u??defaultEquality;r!==void 0&&(o=r,s=true),process.env.NODE_ENV!=="production"&&!n&&!s&&console.error("[Directive] useSelector() received a null/undefined system without a default value. Provide a default value as the 3rd parameter: useSelector(system, selector, defaultValue)");let f=useRef(t),d=useRef(i),c=useRef(o);f.current=t,d.current=i,c.current=o;let g=useRef([]),v=useRef([]),M=useRef(h),y=useRef([]),x=useMemo(()=>n?new Set(Object.keys(n.derive)):new Set,[n]),R=useCallback(()=>n?runTrackedSelector(n,x,f.current):{value:c.current,factKeys:[],deriveKeys:[]},[n,x]),F=useCallback(m=>{if(!n)return ()=>{};let k=()=>{for(let S of y.current)S();y.current=[];let{factKeys:I,deriveKeys:p}=R();g.current=I,v.current=p,I.length>0?y.current.push(n.facts.$store.subscribe(I,()=>{let S=R();depsChanged(g.current,S.factKeys,v.current,S.deriveKeys)&&k(),m();})):p.length===0&&y.current.push(n.facts.$store.subscribeAll(m)),p.length>0&&y.current.push(n.subscribe(p,()=>{let S=R();depsChanged(g.current,S.factKeys,v.current,S.deriveKeys)&&k(),m();}));};return k(),()=>{for(let I of y.current)I();y.current=[];}},[n,R]),N=useCallback(()=>{let m;if(!n)m=c.current;else {let{value:k}=R();m=k===void 0&&s?c.current:k;}return M.current!==h&&d.current(M.current,m)?M.current:(M.current=m,m)},[R,n,s]);return useSyncExternalStore(F,N,N)}function ue(e,t,r,u){let n=r!==void 0,o=u??defaultEquality,s=useRef(t),i=useRef(o),f=useRef(r);s.current=t,i.current=o,f.current=r;let d=useRef(h),c=useMemo(()=>Object.keys(e.facts),[e]),g=useCallback(M=>{let y=c.map(x=>`${x}.*`);return e.subscribe(y,M)},[e,c]),v=useCallback(()=>{let M=s.current(e),y=M===void 0&&n?f.current:M;return d.current!==h&&i.current(d.current,y)?d.current:(d.current=y,y)},[e,n]);return useSyncExternalStore(g,v,v)}function Me(e){return assertSystem("useDispatch",e),useCallback(t=>{e.dispatch(t);},[e])}function De(e,t,r){assertSystem("useWatch",e);let u=useRef(r);u.current=r,useEffect(()=>e.watch(t,(n,o)=>{u.current(n,o);}),[e,t]);}function oe(e,t){assertSystem("useInspect",e);let r=ce(e),u=t?.throttleMs,[n,o]=useState(r),s=useRef(null);return useEffect(()=>{if(!u||u<=0){s.current?.cleanup(),s.current=null;return}return s.current?.cleanup(),s.current=createThrottle((...i)=>{o(i[0]);},u),()=>{s.current?.cleanup(),s.current=null;}},[u]),useEffect(()=>{s.current&&s.current.throttled(r);},[r]),!u||u<=0?r:n}function ie(e){return computeInspectState(e)}function ce(e){let t=useRef(null),r=useRef([]),u=useRef([]),n=useRef(null),o=useCallback(i=>{let f=e.facts.$store.subscribeAll(i),d=e.onSettledChange(i);return ()=>{f(),d();}},[e]),s=useCallback(()=>{let i=ie(e),f=i.unmet.length===r.current.length&&i.unmet.every((g,v)=>g.id===r.current[v]),d=i.inflight.length===u.current.length&&i.inflight.every((g,v)=>g.id===u.current[v]),c=i.isSettled===n.current;return f&&d&&c&&t.current?t.current:(t.current=i,r.current=i.unmet.map(g=>g.id),u.current=i.inflight.map(g=>g.id),n.current=i.isSettled,i)},[e]);return useSyncExternalStore(o,s,s)}function xe(e){assertSystem("useTimeTravel",e);let t=useRef(null),r=useCallback(n=>e.onTimeTravelChange(n),[e]),u=useCallback(()=>{let n=buildTimeTravelState(e);return n?(t.current&&t.current.canUndo===n.canUndo&&t.current.canRedo===n.canRedo&&t.current.currentIndex===n.currentIndex&&t.current.totalSnapshots===n.totalSnapshots&&t.current.isPaused===n.isPaused||(t.current=n),t.current):null},[e]);return useSyncExternalStore(r,u,u)}function ke(e,t){return Array.isArray(t)?le(e,t):ae(e,t)}function ae(e,t){let r=useRef(h),u=useCallback(o=>e.subscribe(o),[e]),n=useCallback(()=>{let o=e.getStatus(t);if(r.current!==h){let s=r.current;if(s.pending===o.pending&&s.inflight===o.inflight&&s.failed===o.failed&&s.isLoading===o.isLoading&&s.hasError===o.hasError&&s.lastError===o.lastError)return r.current}return r.current=o,o},[e,t]);return useSyncExternalStore(u,n,n)}function le(e,t){let r=useRef(null),u=useRef(""),n=useCallback(s=>e.subscribe(s),[e]),o=useCallback(()=>{let s={},i=[];for(let d of t){let c=e.getStatus(d);s[d]=c,i.push(`${d}:${c.pending}:${c.inflight}:${c.failed}:${c.hasError}:${c.lastError?.message??""}`);}let f=i.join("|");return f!==u.current&&(u.current=f,r.current=s),r.current??s},[e,...t]);return useSyncExternalStore(n,o,o)}var _=new WeakMap;function j(e){let t=_.get(e);return t||(t=new Map,_.set(e,t)),t}function Ie(e,t){return Array.isArray(t)?fe(e,t):de(e,t)}function de(e,t){let r=e.getStatus(t);if(r.hasError&&r.lastError)throw r.lastError;if(r.isLoading){let u=j(e),n=u.get(t);throw n||(n=new Promise(o=>{let s=e.subscribe(()=>{e.getStatus(t).isLoading||(u.delete(t),s(),o());});}),u.set(t,n)),n}return r}function fe(e,t){let r={},u=false,n=null;for(let o of t){let s=e.getStatus(o);r[o]=s,s.hasError&&s.lastError&&!n&&(n=s.lastError),s.isLoading&&(u=true);}if(n)throw n;if(u){let o=j(e),s=t.slice().sort().join(","),i=o.get(s);throw i||(i=new Promise(f=>{let d=e.subscribe(()=>{t.every(g=>!e.getStatus(g).isLoading)&&(o.delete(s),d(),f());});}),o.set(s,i)),i}return r}function V(e,t){let r=useRef(null),u=useRef(null),n=useRef(null),o=t?.status===true,s="modules"in e;return r.current||(n.current=()=>{if(s){let{modules:N,...m}=e,k=t?.plugins??m.plugins??[],I=t?.debug??m.debug,p=t?.errorBoundary??m.errorBoundary,S=t?.tickMs??m.tickMs,E=t?.zeroConfig??m.zeroConfig,q=t?.initialFacts??m.initialFacts,w=createSystem({modules:N,plugins:k.length>0?k:void 0,debug:I,errorBoundary:p,tickMs:S,zeroConfig:E,initialFacts:q});return w.initialize(),typeof window<"u"&&w.start(),w}let i="id"in e&&"schema"in e,f=i?e:e.module,d=i?{}:e,c=t?.plugins??d.plugins??[],g=t?.debug??d.debug,v=t?.errorBoundary??d.errorBoundary,M=t?.tickMs??d.tickMs,y=t?.zeroConfig??d.zeroConfig,x=t?.initialFacts??d.initialFacts,R=[...c];o&&(u.current=createRequirementStatusPlugin(),R=[...R,u.current.plugin]);let F=createSystem({module:f,plugins:R.length>0?R:void 0,debug:g,errorBoundary:v,tickMs:M,zeroConfig:y,initialFacts:x});return F.initialize(),typeof window<"u"&&F.start(),F},r.current=n.current()),useEffect(()=>(!r.current&&n.current&&(r.current=n.current()),()=>{r.current?.destroy(),r.current=null,u.current=null;}),[]),o&&!s?{system:r.current,statusPlugin:u.current}:r.current}function we(e,t,r){let u=useRef(t);u.current=t;let n=useRef(r);n.current=r;let o=useCallback(i=>e.subscribe(u.current,i),[e]),s=useCallback(()=>n.current(e),[e]);return useSyncExternalStore(o,s,s)}function Ke(e,t={}){let{facts:r,derived:u,status:n,...o}=t,s=r??[],i=u??[],f=s.length===0&&i.length===0,d=n?V(e,{status:true,...o}):V(e,o),c=n?d.system:d,g=n?d.statusPlugin:void 0,v=useMemo(()=>f?Object.keys(c.derive):[],[c,f]),M=useCallback(p=>{let S=[];return f?(S.push(c.facts.$store.subscribeAll(p)),v.length>0&&S.push(c.subscribe(v,p))):(s.length>0&&S.push(c.facts.$store.subscribe(s,p)),i.length>0&&S.push(c.subscribe(i,p))),()=>{for(let E of S)E();}},[c,f,...s,...i,...v]),y=useRef(h),x=useRef(h),R=useRef(null),F=useCallback(()=>{let p,S,E,q;if(f){p=c.facts.$store.toObject(),E=Object.keys(p),S={};for(let b of v)S[b]=c.read(b);q=v;}else {p={};for(let b of s)p[b]=c.facts[b];E=s,S={};for(let b of i)S[b]=c.read(b);q=i;}let w=y.current!==h;if(w){let b=y.current;if(Object.keys(b).length!==E.length)w=false;else for(let T of E)if(!Object.is(b[T],p[T])){w=false;break}}let C=x.current!==h;if(C){let b=x.current;if(Object.keys(b).length!==q.length)C=false;else for(let T of q)if(!Object.is(b[T],S[T])){C=false;break}}let z=w?y.current:p,W=C?x.current:S;return w||(y.current=p),C||(x.current=S),w&&C&&R.current||(R.current={facts:z,derived:W}),R.current},[c,f,...s,...i,...v]),N=useSyncExternalStore(M,F,F),m=useCallback(p=>c.dispatch(p),[c]),k=Se(c),I={system:c,dispatch:m,events:k,facts:N.facts,derived:N.derived};return n&&g?{...I,statusPlugin:g}:I}function Se(e){return assertSystem("useEvents",e),useMemo(()=>e.events,[e])}function Fe(e,t){assertSystem("useExplain",e);let r=useCallback(n=>{let o=e.facts.$store.subscribeAll(n),s=e.onSettledChange(n);return ()=>{o(),s();}},[e]),u=useCallback(()=>e.explain(t),[e,t]);return useSyncExternalStore(r,u,u)}function Ee(e,t){assertSystem("useConstraintStatus",e);let r=oe(e);return useMemo(()=>{let u=e.inspect();return t?u.constraints.find(n=>n.id===t)??null:u.constraints},[e,t,r])}function Ne(e,t,r){assertSystem("useOptimisticUpdate",e);let[u,n]=useState(false),[o,s]=useState(null),i=useRef(null),f=useCallback(()=>{i.current&&(e.restore(i.current),i.current=null),n(false),s(null);},[e]),d=useCallback(c=>{i.current=e.getSnapshot(),n(true),s(null),e.batch(c);},[e]);return useEffect(()=>{if(!(!t||!r||!u))return t.subscribe(()=>{let c=t.getStatus(r);!c.isLoading&&!c.hasError?(i.current=null,n(false)):c.hasError&&(s(c.lastError),f());})},[t,r,u,f]),{mutate:d,isPending:u,error:o,rollback:f}}var A=createContext(null);function qe({snapshot:e,children:t}){return jsx(A.Provider,{value:e,children:t})}function Ce(e,t){let r=useContext(A),u=useMemo(()=>r?.data?{...t??{},initialFacts:{...t?.initialFacts??{},...r.data}}:t??{},[r,t]);return V(e,u)}export{qe as DirectiveHydrator,Ee as useConstraintStatus,be as useDerived,Ke as useDirective,V as useDirectiveRef,Me as useDispatch,Se as useEvents,Fe as useExplain,Re as useFact,Ce as useHydratedSystem,oe as useInspect,we as useNamespacedSelector,Ne as useOptimisticUpdate,ke as useRequirementStatus,he as useSelector,Ie as useSuspenseRequirement,xe as useTimeTravel,De as useWatch};//# sourceMappingURL=index.js.map
+import {createSystem,createRequirementStatusPlugin}from'@directive-run/core';import {assertSystem,defaultEquality,runTrackedSelector,createThrottle,buildHistoryState,depsChanged,computeInspectState}from'@directive-run/core/adapter-utils';export{shallowEqual}from'@directive-run/core/adapter-utils';import {createContext,useCallback,useSyncExternalStore,useRef,useMemo,useEffect,useState,useContext}from'react';import {jsx}from'react/jsx-runtime';var h=Symbol("directive.uninitialized");function me(e,t){return assertSystem("useFact",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useFact() received a function. Did you mean useSelector()? useFact() takes a string key or array of keys, not a selector function."),Array.isArray(t)?ne(e,t):te(e,t)}function te(e,t){process.env.NODE_ENV!=="production"&&(t in e.facts.$store.toObject()||console.warn(`[Directive] useFact("${t}") \u2014 fact not found in store. Check that "${t}" is defined in your module's schema.`));let r=useCallback(n=>e.facts.$store.subscribe([t],n),[e,t]),o=useCallback(()=>e.facts.$store.get(t),[e,t]);return useSyncExternalStore(r,o,o)}function ne(e,t){let r=useRef(h),o=useCallback(u=>e.facts.$store.subscribe(t,u),[e,...t]),n=useCallback(()=>{let u={};for(let s of t)u[s]=e.facts.$store.get(s);if(r.current!==h){let s=true;for(let i of t)if(!Object.is(r.current[i],u[i])){s=false;break}if(s)return r.current}return r.current=u,u},[e,...t]);return useSyncExternalStore(o,n,n)}function he(e,t){return assertSystem("useDerived",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useDerived() received a function. Did you mean useSelector()? useDerived() takes a string key or array of keys, not a selector function."),Array.isArray(t)?se(e,t):re(e,t)}function re(e,t){process.env.NODE_ENV!=="production"&&(t in e.derive||console.warn(`[Directive] useDerived("${t}") \u2014 derivation not found. Check that "${t}" is defined in your module's derive property.`));let r=useCallback(n=>e.subscribe([t],n),[e,t]),o=useCallback(()=>e.read(t),[e,t]);return useSyncExternalStore(r,o,o)}function se(e,t){let r=useRef(h),o=useCallback(u=>e.subscribe(t,u),[e,...t]),n=useCallback(()=>{let u={};for(let s of t)u[s]=e.read(s);if(r.current!==h){let s=true;for(let i of t)if(!Object.is(r.current[i],u[i])){s=false;break}if(s)return r.current}return r.current=u,u},[e,...t]);return useSyncExternalStore(o,n,n)}function be(e,t,r,o){if(e&&e._mode==="namespaced")return oe(e,t,r,o);let n=e,u,s=false,i=o??defaultEquality;r!==void 0&&(u=r,s=true),process.env.NODE_ENV!=="production"&&!n&&!s&&console.error("[Directive] useSelector() received a null/undefined system without a default value. Provide a default value as the 3rd parameter: useSelector(system, selector, defaultValue)");let f=useRef(t),l=useRef(i),c=useRef(u);f.current=t,l.current=i,c.current=u;let g=useRef([]),v=useRef([]),b=useRef(h),y=useRef([]),k=useMemo(()=>n?new Set(Object.keys(n.derive)):new Set,[n]),M=useCallback(()=>n?runTrackedSelector(n,k,f.current):{value:c.current,factKeys:[],deriveKeys:[]},[n,k]),K=useCallback(D=>{if(!n)return ()=>{};let R=()=>{for(let S of y.current)S();y.current=[];let{factKeys:I,deriveKeys:p}=M();g.current=I,v.current=p,I.length>0?y.current.push(n.facts.$store.subscribe(I,()=>{let S=M();depsChanged(g.current,S.factKeys,v.current,S.deriveKeys)&&R(),D();})):p.length===0&&y.current.push(n.facts.$store.subscribeAll(D)),p.length>0&&y.current.push(n.subscribe(p,()=>{let S=M();depsChanged(g.current,S.factKeys,v.current,S.deriveKeys)&&R(),D();}));};return R(),()=>{for(let I of y.current)I();y.current=[];}},[n,M]),F=useCallback(()=>{let D;if(!n)D=c.current;else {let{value:R}=M();D=R===void 0&&s?c.current:R;}return b.current!==h&&l.current(b.current,D)?b.current:(b.current=D,D)},[M,n,s]);return useSyncExternalStore(K,F,F)}function oe(e,t,r,o){let n=r!==void 0,u=o??defaultEquality,s=useRef(t),i=useRef(u),f=useRef(r);s.current=t,i.current=u,f.current=r;let l=useRef(h),c=useMemo(()=>Object.keys(e.facts),[e]),g=useCallback(b=>{let y=c.map(k=>`${k}.*`);return e.subscribe(y,b)},[e,c]),v=useCallback(()=>{let b=s.current(e),y=b===void 0&&n?f.current:b;return l.current!==h&&i.current(l.current,y)?l.current:(l.current=y,y)},[e,n]);return useSyncExternalStore(g,v,v)}function Me(e){return assertSystem("useDispatch",e),useCallback(t=>{e.dispatch(t);},[e])}function De(e,t,r){assertSystem("useWatch",e);let o=useRef(r);o.current=r,useEffect(()=>e.watch(t,(n,u)=>{o.current(n,u);}),[e,t]);}function ue(e,t){assertSystem("useInspect",e);let r=ce(e),o=t?.throttleMs,[n,u]=useState(r),s=useRef(null);return useEffect(()=>{if(!o||o<=0){s.current?.cleanup(),s.current=null;return}return s.current?.cleanup(),s.current=createThrottle((...i)=>{u(i[0]);},o),()=>{s.current?.cleanup(),s.current=null;}},[o]),useEffect(()=>{s.current&&s.current.throttled(r);},[r]),!o||o<=0?r:n}function ie(e){return computeInspectState(e)}function ce(e){let t=useRef(null),r=useRef([]),o=useRef([]),n=useRef(null),u=useCallback(i=>{let f=e.facts.$store.subscribeAll(i),l=e.onSettledChange(i);return ()=>{f(),l();}},[e]),s=useCallback(()=>{let i=ie(e),f=i.unmet.length===r.current.length&&i.unmet.every((g,v)=>g.id===r.current[v]),l=i.inflight.length===o.current.length&&i.inflight.every((g,v)=>g.id===o.current[v]),c=i.isSettled===n.current;return f&&l&&c&&t.current?t.current:(t.current=i,r.current=i.unmet.map(g=>g.id),o.current=i.inflight.map(g=>g.id),n.current=i.isSettled,i)},[e]);return useSyncExternalStore(u,s,s)}function xe(e){assertSystem("useHistory",e);let t=useRef(null),r=useCallback(n=>e.onHistoryChange(n),[e]),o=useCallback(()=>{let n=buildHistoryState(e);return n?(t.current&&t.current.canGoBack===n.canGoBack&&t.current.canGoForward===n.canGoForward&&t.current.currentIndex===n.currentIndex&&t.current.totalSnapshots===n.totalSnapshots&&t.current.isPaused===n.isPaused||(t.current=n),t.current):null},[e]);return useSyncExternalStore(r,o,o)}function ke(e,t){return Array.isArray(t)?le(e,t):ae(e,t)}function ae(e,t){let r=useRef(h),o=useCallback(u=>e.subscribe(u),[e]),n=useCallback(()=>{let u=e.getStatus(t);if(r.current!==h){let s=r.current;if(s.pending===u.pending&&s.inflight===u.inflight&&s.failed===u.failed&&s.isLoading===u.isLoading&&s.hasError===u.hasError&&s.lastError===u.lastError)return r.current}return r.current=u,u},[e,t]);return useSyncExternalStore(o,n,n)}function le(e,t){let r=useRef(null),o=useRef(""),n=useCallback(s=>e.subscribe(s),[e]),u=useCallback(()=>{let s={},i=[];for(let l of t){let c=e.getStatus(l);s[l]=c,i.push(`${l}:${c.pending}:${c.inflight}:${c.failed}:${c.hasError}:${c.lastError?.message??""}`);}let f=i.join("|");return f!==o.current&&(o.current=f,r.current=s),r.current??s},[e,...t]);return useSyncExternalStore(n,u,u)}var H=new WeakMap;function j(e){let t=H.get(e);return t||(t=new Map,H.set(e,t)),t}function Ie(e,t){return Array.isArray(t)?fe(e,t):de(e,t)}function de(e,t){let r=e.getStatus(t);if(r.hasError&&r.lastError)throw r.lastError;if(r.isLoading){let o=j(e),n=o.get(t);throw n||(n=new Promise(u=>{let s=e.subscribe(()=>{e.getStatus(t).isLoading||(o.delete(t),s(),u());});}),o.set(t,n)),n}return r}function fe(e,t){let r={},o=false,n=null;for(let u of t){let s=e.getStatus(u);r[u]=s,s.hasError&&s.lastError&&!n&&(n=s.lastError),s.isLoading&&(o=true);}if(n)throw n;if(o){let u=j(e),s=t.slice().sort().join(","),i=u.get(s);throw i||(i=new Promise(f=>{let l=e.subscribe(()=>{t.every(g=>!e.getStatus(g).isLoading)&&(u.delete(s),l(),f());});}),u.set(s,i)),i}return r}function $(e,t){let r=useRef(null),o=useRef(null),n=useRef(null),u=t?.status===true,s="modules"in e;return r.current||(n.current=()=>{if(s){let{modules:D,...R}=e,I=t?.plugins??R.plugins??[],p=t?.history??R.history,S=t?.trace??R.trace,E=t?.errorBoundary??R.errorBoundary,P=t?.tickMs??R.tickMs,N=t?.zeroConfig??R.zeroConfig,q=t?.initialFacts??R.initialFacts,U=createSystem({modules:D,plugins:I.length>0?I:void 0,history:p,trace:S,errorBoundary:E,tickMs:P,zeroConfig:N,initialFacts:q});return U.initialize(),typeof window<"u"&&U.start(),U}let i="id"in e&&"schema"in e,f=i?e:e.module,l=i?{}:e,c=t?.plugins??l.plugins??[],g=t?.history??l.history,v=t?.trace??l.trace,b=t?.errorBoundary??l.errorBoundary,y=t?.tickMs??l.tickMs,k=t?.zeroConfig??l.zeroConfig,M=t?.initialFacts??l.initialFacts,K=[...c];u&&(o.current=createRequirementStatusPlugin(),K=[...K,o.current.plugin]);let F=createSystem({module:f,plugins:K.length>0?K:void 0,history:g,trace:v,errorBoundary:b,tickMs:y,zeroConfig:k,initialFacts:M});return F.initialize(),typeof window<"u"&&F.start(),F},r.current=n.current()),useEffect(()=>(!r.current&&n.current&&(r.current=n.current()),()=>{r.current?.destroy(),r.current=null,o.current=null;}),[]),u&&!s?{system:r.current,statusPlugin:o.current}:r.current}function we(e,t,r){let o=useRef(t);o.current=t;let n=useRef(r);n.current=r;let u=useCallback(i=>e.subscribe(o.current,i),[e]),s=useCallback(()=>n.current(e),[e]);return useSyncExternalStore(u,s,s)}function Ke(e,t={}){let{facts:r,derived:o,status:n,...u}=t,s=r??[],i=o??[],f=s.length===0&&i.length===0,l=n?$(e,{status:true,...u}):$(e,u),c=n?l.system:l,g=n?l.statusPlugin:void 0,v=useMemo(()=>f?Object.keys(c.derive):[],[c,f]),b=useCallback(p=>{let S=[];return f?(S.push(c.facts.$store.subscribeAll(p)),v.length>0&&S.push(c.subscribe(v,p))):(s.length>0&&S.push(c.facts.$store.subscribe(s,p)),i.length>0&&S.push(c.subscribe(i,p))),()=>{for(let E of S)E();}},[c,f,...s,...i,...v]),y=useRef(h),k=useRef(h),M=useRef(null),K=useCallback(()=>{let p,S,E,P;if(f){p=c.facts.$store.toObject(),E=Object.keys(p),S={};for(let m of v)S[m]=c.read(m);P=v;}else {p={};for(let m of s)p[m]=c.facts[m];E=s,S={};for(let m of i)S[m]=c.read(m);P=i;}let N=y.current!==h;if(N){let m=y.current;if(Object.keys(m).length!==E.length)N=false;else for(let O of E)if(!Object.is(m[O],p[O])){N=false;break}}let q=k.current!==h;if(q){let m=k.current;if(Object.keys(m).length!==P.length)q=false;else for(let O of P)if(!Object.is(m[O],S[O])){q=false;break}}let U=N?y.current:p,z=q?k.current:S;return N||(y.current=p),q||(k.current=S),N&&q&&M.current||(M.current={facts:U,derived:z}),M.current},[c,f,...s,...i,...v]),F=useSyncExternalStore(b,K,K),D=useCallback(p=>c.dispatch(p),[c]),R=Se(c),I={system:c,dispatch:D,events:R,facts:F.facts,derived:F.derived};return n&&g?{...I,statusPlugin:g}:I}function Se(e){return assertSystem("useEvents",e),useMemo(()=>e.events,[e])}function Fe(e,t){assertSystem("useExplain",e);let r=useCallback(n=>{let u=e.facts.$store.subscribeAll(n),s=e.onSettledChange(n);return ()=>{u(),s();}},[e]),o=useCallback(()=>e.explain(t),[e,t]);return useSyncExternalStore(r,o,o)}function Ee(e,t){assertSystem("useConstraintStatus",e);let r=ue(e);return useMemo(()=>{let o=e.inspect();return t?o.constraints.find(n=>n.id===t)??null:o.constraints},[e,t,r])}function Ne(e,t,r){assertSystem("useOptimisticUpdate",e);let[o,n]=useState(false),[u,s]=useState(null),i=useRef(null),f=useCallback(()=>{i.current&&(e.restore(i.current),i.current=null),n(false),s(null);},[e]),l=useCallback(c=>{i.current=e.getSnapshot(),n(true),s(null),e.batch(c);},[e]);return useEffect(()=>{if(!(!t||!r||!o))return t.subscribe(()=>{let c=t.getStatus(r);!c.isLoading&&!c.hasError?(i.current=null,n(false)):c.hasError&&(s(c.lastError),f());})},[t,r,o,f]),{mutate:l,isPending:o,error:u,rollback:f}}var A=createContext(null);function qe({snapshot:e,children:t}){return jsx(A.Provider,{value:e,children:t})}function Pe(e,t){let r=useContext(A),o=useMemo(()=>r?.data?{...t??{},initialFacts:{...t?.initialFacts??{},...r.data}}:t??{},[r,t]);return $(e,o)}export{qe as DirectiveHydrator,Ee as useConstraintStatus,he as useDerived,Ke as useDirective,$ as useDirectiveRef,Me as useDispatch,Se as useEvents,Fe as useExplain,me as useFact,xe as useHistory,Pe as useHydratedSystem,ue as useInspect,we as useNamespacedSelector,Ne as useOptimisticUpdate,ke as useRequirementStatus,be as useSelector,Ie as useSuspenseRequirement,De as useWatch};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.tsx"],"names":["UNINITIALIZED","useFact","system","keyOrKeys","assertSystem","_useFacts","_useSingleFact","factKey","subscribe","useCallback","onStoreChange","getSnapshot","useSyncExternalStore","factKeys","cachedValue","useRef","result","key","same","useDerived","_useDerivedMulti","_useSingleDerived","derivationId","derivationIds","id","useSelector","systemArg","selector","defaultValueArg","equalityFnArg","_useNamespacedSelectorImpl","defaultValue","hasDefault","equalityFn","defaultEquality","selectorRef","eqRef","defaultValueRef","trackedFactKeysRef","trackedDeriveKeysRef","unsubsRef","deriveKeys","useMemo","runWithTracking","runTrackedSelector","resubscribe","unsub","derivedKeys","updated","depsChanged","effectiveValue","newValue","moduleNames","wildcardKeys","ns","useDispatch","event","useWatch","callback","callbackRef","useEffect","prevValue","useInspect","options","syncState","_useInspectSync","throttleMs","deferredState","setDeferredState","useState","throttleRef","createThrottle","args","_buildInspectState","computeInspectState","cachedSnapshot","cachedUnmetIds","cachedInflightIds","cachedIsSettled","unsubFacts","unsubSettled","state","unmetSame","u","i","inflightSame","f","settledSame","useTimeTravel","cachedRef","buildTimeTravelState","useRequirementStatus","statusPlugin","typeOrTypes","_useRequirementStatusMulti","_useRequirementStatusSingle","type","status","prev","types","cachedKey","parts","suspenseCacheMap","getSuspenseCache","plugin","cache","useSuspenseRequirement","_useSuspenseRequirementMulti","_useSuspenseRequirementSingle","promise","resolve","unsubscribe","hasLoading","firstError","cacheKey","t","useDirectiveRef","config","systemRef","statusPluginRef","factoryRef","wantStatus","isNamespaced","modules","rest","plugins","debug","errorBoundary","tickMs","zeroConfig","initialFacts","sys","createSystem","isModule","mod","baseOpts","allPlugins","createRequirementStatusPlugin","useNamespacedSelector","keys","keysRef","useDirective","moduleOrOptions","selections","factKeysOpt","derivedKeysOpt","configRest","subscribeAll","refResult","allDerivationKeys","unsubs","cachedFacts","cachedDerived","cachedWrapper","factsResult","derivedResult","effectiveFactKeys","effectiveDerivedKeys","factsSame","derivedSame","stableFacts","stableDerived","values","dispatch","events","useEvents","base","useExplain","requirementId","useConstraintStatus","constraintId","inspectState","inspection","c","useOptimisticUpdate","requirementType","isPending","setIsPending","error","setError","snapshotRef","rollback","mutate","updateFn","HydrationContext","createContext","DirectiveHydrator","snapshot","children","jsx","useHydratedSystem","moduleDef","useContext","mergedConfig"],"mappings":"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","file":"index.js","sourcesContent":["/*\n React Adapter - Consolidated hooks for React integration\n \n 18 public exports: useFact, useDerived, useDispatch, useDirective,\n * useDirectiveRef, useSelector, useWatch, useInspect, useRequirementStatus,\n * useSuspenseRequirement, useEvents, useExplain, useConstraintStatus,\n * useOptimisticUpdate, DirectiveHydrator, useHydratedSystem,\n * useTimeTravel, shallowEqual\n \n @example\n * ```tsx\n * import { useFact, useDerived, useEvents } from '@directive-run/react';\n \n const system = createSystem({ module: counterModule });\n * system.start();\n \n function Counter() {\n * const count = useFact(system, \"count\");\n * const doubled = useDerived(system, \"doubled\");\n * const events = useEvents(system);\n \n return (\n * <div>\n * <p>Count: {count}</p>\n * <p>Doubled: {doubled}</p>\n * <button onClick={() => events.increment()}>+</button>\n * </div>\n * );\n * }\n * ```\n /\n\nimport type {\n DebugConfig,\n DistributableSnapshot,\n ErrorBoundaryConfig,\n InferDerivations,\n InferEvents,\n InferFacts,\n InferSelectorState,\n ModuleDef,\n ModuleSchema,\n ModulesMap,\n NamespacedSystem,\n Plugin,\n SingleModuleSystem,\n SystemSnapshot,\n TimeTravelState,\n} from \"@directive-run/core\";\nimport {\n createRequirementStatusPlugin,\n createSystem,\n} from \"@directive-run/core\";\nimport type { RequirementTypeStatus } from \"@directive-run/core\";\nimport {\n type ConstraintInfo,\n type InspectState,\n assertSystem,\n buildTimeTravelState,\n computeInspectState,\n createThrottle,\n defaultEquality,\n depsChanged,\n runTrackedSelector,\n shallowEqual,\n} from \"@directive-run/core/adapter-utils\";\nimport type { ReactNode } from \"react\";\nimport {\n createContext,\n useCallback,\n useContext,\n useEffect,\n useMemo,\n useRef,\n useState,\n useSyncExternalStore,\n} from \"react\";\n\n// Re-export for convenience\nexport type { RequirementTypeStatus, InspectState, ConstraintInfo };\nexport { shallowEqual };\n\n/* Type for the requirement status plugin return value /\nexport type StatusPlugin = ReturnType<typeof createRequirementStatusPlugin>;\n\n// ============================================================================\n// Internal Helpers\n// ============================================================================\n\n/* Sentinel value for uninitialized selector cache /\nconst UNINITIALIZED = Symbol(\"directive.uninitialized\");\n\n// ============================================================================\n// useFact — single key or multi key\n// ============================================================================\n\n/* Single key overload /\nexport function useFact<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(system: SingleModuleSystem<S>, factKey: K): InferFacts<S>[K] \| undefined;\n\n/* Multi-key overload /\nexport function useFact<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(system: SingleModuleSystem<S>, factKeys: K[]): Pick<InferFacts<S>, K>;\n\n/* Implementation /\nexport function useFact(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n keyOrKeys: string \| string[],\n): unknown {\n assertSystem(\"useFact\", system);\n if (\n process.env.NODE_ENV !== \"production\" &&\n typeof keyOrKeys === \"function\"\n ) {\n console.error(\n \"[Directive] useFact() received a function. Did you mean useSelector()? \" +\n \"useFact() takes a string key or array of keys, not a selector function.\",\n );\n }\n\n // Multi-key path: useFact(system, [keys])\n if (Array.isArray(keyOrKeys)) {\n return _useFacts(system, keyOrKeys);\n }\n\n // Single key path: useFact(system, key)\n return _useSingleFact(system, keyOrKeys);\n}\n\nfunction _useSingleFact(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n factKey: string,\n): unknown {\n if (process.env.NODE_ENV !== \"production\") {\n if (!(factKey in system.facts.$store.toObject())) {\n console.warn(\n `[Directive] useFact(\"${factKey}\") — fact not found in store. ` +\n `Check that \"${factKey}\" is defined in your module's schema.`,\n );\n }\n }\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.facts.$store.subscribe([factKey], onStoreChange);\n },\n [system, factKey],\n );\n\n const getSnapshot = useCallback(() => {\n // biome-ignore lint/suspicious/noExplicitAny: Dynamic fact access\n return (system.facts as any)[factKey];\n }, [system, factKey]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction _useFacts(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n factKeys: string[],\n): Record<string, unknown> {\n const cachedValue = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.facts.$store.subscribe(factKeys, onStoreChange);\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [system, ...factKeys],\n );\n\n const getSnapshot = useCallback(() => {\n const result: Record<string, unknown> = {};\n for (const key of factKeys) {\n // biome-ignore lint/suspicious/noExplicitAny: Dynamic fact access\n result[key] = (system.facts as any)[key];\n }\n\n if (cachedValue.current !== UNINITIALIZED) {\n let same = true;\n for (const key of factKeys) {\n if (\n !Object.is(\n (cachedValue.current as Record<string, unknown>)[key],\n result[key],\n )\n ) {\n same = false;\n break;\n }\n }\n if (same) return cachedValue.current;\n }\n\n cachedValue.current = result;\n return result;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, ...factKeys]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useDerived — single key or multi key\n// ============================================================================\n\n/* Single key overload /\nexport function useDerived<\n S extends ModuleSchema,\n K extends keyof InferDerivations<S> & string,\n>(system: SingleModuleSystem<S>, derivationId: K): InferDerivations<S>[K];\n\n/* Multi-key overload /\nexport function useDerived<\n S extends ModuleSchema,\n K extends keyof InferDerivations<S> & string,\n>(\n system: SingleModuleSystem<S>,\n derivationIds: K[],\n): Pick<InferDerivations<S>, K>;\n\n/* Implementation /\nexport function useDerived(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n keyOrKeys: string \| string[],\n): unknown {\n assertSystem(\"useDerived\", system);\n if (\n process.env.NODE_ENV !== \"production\" &&\n typeof keyOrKeys === \"function\"\n ) {\n console.error(\n \"[Directive] useDerived() received a function. Did you mean useSelector()? \" +\n \"useDerived() takes a string key or array of keys, not a selector function.\",\n );\n }\n\n // Multi-key path\n if (Array.isArray(keyOrKeys)) {\n return _useDerivedMulti(system, keyOrKeys);\n }\n\n // Single key path\n return _useSingleDerived(system, keyOrKeys);\n}\n\nfunction _useSingleDerived(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n derivationId: string,\n): unknown {\n if (process.env.NODE_ENV !== \"production\") {\n if (!(derivationId in system.derive)) {\n console.warn(\n `[Directive] useDerived(\"${derivationId}\") — derivation not found. ` +\n `Check that \"${derivationId}\" is defined in your module's derive property.`,\n );\n }\n }\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.subscribe([derivationId], onStoreChange);\n },\n [system, derivationId],\n );\n\n const getSnapshot = useCallback(() => {\n return system.read(derivationId);\n }, [system, derivationId]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction _useDerivedMulti(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n derivationIds: string[],\n): Record<string, unknown> {\n const cachedValue = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.subscribe(derivationIds, onStoreChange);\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [system, ...derivationIds],\n );\n\n const getSnapshot = useCallback(() => {\n const result: Record<string, unknown> = {};\n for (const id of derivationIds) {\n result[id] = system.read(id);\n }\n\n if (cachedValue.current !== UNINITIALIZED) {\n let same = true;\n for (const id of derivationIds) {\n if (\n !Object.is(\n (cachedValue.current as Record<string, unknown>)[id],\n result[id],\n )\n ) {\n same = false;\n break;\n }\n }\n if (same) return cachedValue.current;\n }\n\n cachedValue.current = result;\n return result;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, ...derivationIds]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useSelector — Zustand-style selector over facts and derivations\n// ============================================================================\n\n/\n Auto-tracking selector over facts and derivations (Zustand-style).\n * Uses `withTracking()` to detect which facts the selector accesses,\n * then subscribes only to those keys. Falls back to subscribeAll\n * if no keys are detected.\n \n Supports an optional default value as the 3rd parameter, used when\n * the system is null/undefined or the selector returns undefined.\n * When a default value is provided, the system parameter may be\n * null \| undefined — the hook returns the default and recomputes\n * when the system becomes available.\n \n An optional equality function can be passed as the 4th parameter\n * to customize when the selector result is considered \"changed\".\n * Defaults to `Object.is`. Use `shallowEqual` (exported from this\n * package) when your selector returns a new object/array each time.\n \n @example\n * ```tsx\n * // Basic usage\n * const count = useSelector(system, (s) => s.count);\n \n // With default value (allows nullable system)\n * const count = useSelector(system, (s) => s.count, 0);\n \n // With default value + custom equality\n * const coords = useSelector(system, (s) => ({ x: s.x, y: s.y }), { x: 0, y: 0 }, shallowEqual);\n * ```\n /\n\n// Non-null system, no default\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S>,\n selector: (state: InferSelectorState<S>) => R,\n): R;\n\n// Non-null system, with default value and optional equality\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S>,\n selector: (state: InferSelectorState<S>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// Nullable system, default REQUIRED\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S> \| null \| undefined,\n selector: (state: InferSelectorState<S>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// --- Namespaced system overloads ---\n\n// Namespaced system, no default\nexport function useSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n selector: (state: NamespacedSystem<Modules>) => R,\n): R;\n\n// Namespaced system, with default value and optional equality\nexport function useSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n selector: (state: NamespacedSystem<Modules>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// Nullable namespaced system, default REQUIRED\nexport function useSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules> \| null \| undefined,\n selector: (state: NamespacedSystem<Modules>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// --- Generic fallbacks ---\n\n// Generic fallback: non-null system\nexport function useSelector<R>(\n // biome-ignore lint/suspicious/noExplicitAny: Generic fallback\n system: SingleModuleSystem<any>,\n // biome-ignore lint/suspicious/noExplicitAny: Selector receives dynamic state\n selector: (state: Record<string, any>) => R,\n defaultValue?: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// Generic fallback: nullable system\nexport function useSelector<R>(\n // biome-ignore lint/suspicious/noExplicitAny: Generic fallback\n system: SingleModuleSystem<any> \| null \| undefined,\n // biome-ignore lint/suspicious/noExplicitAny: Selector receives dynamic state\n selector: (state: Record<string, any>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\nexport function useSelector(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature accepts both system types\n systemArg: SingleModuleSystem<any> \| NamespacedSystem<any> \| null \| undefined,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n selector: (state: any) => unknown,\n defaultValueArg?: unknown,\n equalityFnArg?: (a: unknown, b: unknown) => boolean,\n): unknown {\n // Route to namespaced implementation if system is a NamespacedSystem\n // biome-ignore lint/suspicious/noExplicitAny: Runtime type check\n if (systemArg && (systemArg as any)._mode === \"namespaced\") {\n // biome-ignore lint/suspicious/noExplicitAny: Delegate to namespaced impl\n return _useNamespacedSelectorImpl(\n systemArg as NamespacedSystem<any>,\n selector,\n defaultValueArg,\n equalityFnArg,\n );\n }\n\n // After the namespaced check, system is a SingleModuleSystem\n const system = systemArg as SingleModuleSystem<any> \| null \| undefined;\n let defaultValue: unknown;\n let hasDefault = false;\n const equalityFn: (a: unknown, b: unknown) => boolean =\n equalityFnArg ?? defaultEquality;\n\n if (defaultValueArg !== undefined) {\n defaultValue = defaultValueArg;\n hasDefault = true;\n }\n\n // Dev-mode warning: null system without a default value\n if (process.env.NODE_ENV !== \"production\") {\n if (!system && !hasDefault) {\n console.error(\n \"[Directive] useSelector() received a null/undefined system without a default value. \" +\n \"Provide a default value as the 3rd parameter: useSelector(system, selector, defaultValue)\",\n );\n }\n }\n\n // Store selector/eq/default in refs to avoid resubscription churn\n const selectorRef = useRef(selector);\n const eqRef = useRef(equalityFn);\n const defaultValueRef = useRef(defaultValue);\n selectorRef.current = selector;\n eqRef.current = equalityFn;\n defaultValueRef.current = defaultValue;\n\n const trackedFactKeysRef = useRef<string[]>([]);\n const trackedDeriveKeysRef = useRef<string[]>([]);\n const cachedValue = useRef<unknown>(UNINITIALIZED);\n const unsubsRef = useRef<Array<() => void>>([]);\n\n // Build a tracking-aware state proxy that exposes both facts and derivations\n const deriveKeys = useMemo(\n () => (system ? new Set(Object.keys(system.derive)) : new Set<string>()),\n [system],\n );\n\n const runWithTracking = useCallback(() => {\n if (!system) {\n return {\n value: defaultValueRef.current,\n factKeys: [] as string[],\n deriveKeys: [] as string[],\n };\n }\n\n return runTrackedSelector(system, deriveKeys, selectorRef.current);\n }, [system, deriveKeys]);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n if (!system) {\n // No system — return noop unsubscribe\n return () => {};\n }\n\n const resubscribe = () => {\n // Cleanup previous subscriptions\n for (const unsub of unsubsRef.current) unsub();\n unsubsRef.current = [];\n\n // Run selector with tracking to detect accessed keys\n const { factKeys, deriveKeys: derivedKeys } = runWithTracking();\n trackedFactKeysRef.current = factKeys;\n trackedDeriveKeysRef.current = derivedKeys;\n\n // Subscribe to accessed fact keys\n if (factKeys.length > 0) {\n unsubsRef.current.push(\n system.facts.$store.subscribe(factKeys, () => {\n // Re-track on notification for dynamic deps\n const updated = runWithTracking();\n if (\n depsChanged(\n trackedFactKeysRef.current,\n updated.factKeys,\n trackedDeriveKeysRef.current,\n updated.deriveKeys,\n )\n )\n resubscribe();\n onStoreChange();\n }),\n );\n } else if (derivedKeys.length === 0) {\n // No deps at all — subscribe to everything\n unsubsRef.current.push(\n system.facts.$store.subscribeAll(onStoreChange),\n );\n }\n\n // Subscribe to accessed derivation keys\n if (derivedKeys.length > 0) {\n unsubsRef.current.push(\n system.subscribe(derivedKeys, () => {\n // Re-track on notification for dynamic deps\n const updated = runWithTracking();\n if (\n depsChanged(\n trackedFactKeysRef.current,\n updated.factKeys,\n trackedDeriveKeysRef.current,\n updated.deriveKeys,\n )\n )\n resubscribe();\n onStoreChange();\n }),\n );\n }\n };\n\n resubscribe();\n\n return () => {\n for (const unsub of unsubsRef.current) unsub();\n unsubsRef.current = [];\n };\n },\n [system, runWithTracking],\n );\n\n const getSnapshot = useCallback(() => {\n let effectiveValue: unknown;\n\n if (!system) {\n effectiveValue = defaultValueRef.current;\n } else {\n const { value: newValue } = runWithTracking();\n\n // When selector returns undefined and we have a default, use it\n effectiveValue =\n newValue === undefined && hasDefault\n ? defaultValueRef.current\n : newValue;\n }\n\n if (\n cachedValue.current !== UNINITIALIZED &&\n eqRef.current(cachedValue.current, effectiveValue)\n ) {\n return cachedValue.current;\n }\n cachedValue.current = effectiveValue;\n\n return effectiveValue;\n }, [runWithTracking, system, hasDefault]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// _useNamespacedSelectorImpl — internal namespaced useSelector\n// ============================================================================\n\n/\n Internal implementation for useSelector with NamespacedSystem.\n * Subscribes to all module namespaces and runs the selector against the system.\n * Uses equality comparison to prevent unnecessary re-renders.\n /\nfunction _useNamespacedSelectorImpl(\n // biome-ignore lint/suspicious/noExplicitAny: Internal impl\n system: NamespacedSystem<any>,\n // biome-ignore lint/suspicious/noExplicitAny: Internal impl\n selector: (state: any) => unknown,\n defaultValueArg?: unknown,\n equalityFnArg?: (a: unknown, b: unknown) => boolean,\n): unknown {\n const hasDefault = defaultValueArg !== undefined;\n const equalityFn = equalityFnArg ?? defaultEquality;\n\n const selectorRef = useRef(selector);\n const eqRef = useRef(equalityFn);\n const defaultValueRef = useRef(defaultValueArg);\n selectorRef.current = selector;\n eqRef.current = equalityFn;\n defaultValueRef.current = defaultValueArg;\n\n const cachedValue = useRef<unknown>(UNINITIALIZED);\n\n // Get all module namespace names for wildcard subscription\n const moduleNames = useMemo(() => Object.keys(system.facts), [system]);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n // Subscribe to all modules using wildcard keys\n const wildcardKeys = moduleNames.map((ns) => `${ns}.`);\n\n return system.subscribe(wildcardKeys, onStoreChange);\n },\n [system, moduleNames],\n );\n\n const getSnapshot = useCallback(() => {\n const newValue = selectorRef.current(system);\n const effectiveValue =\n newValue === undefined && hasDefault ? defaultValueRef.current : newValue;\n\n if (\n cachedValue.current !== UNINITIALIZED &&\n eqRef.current(cachedValue.current, effectiveValue)\n ) {\n return cachedValue.current;\n }\n\n cachedValue.current = effectiveValue;\n\n return effectiveValue;\n }, [system, hasDefault]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useDispatch\n// ============================================================================\n\nexport function useDispatch<S extends ModuleSchema>(\n system: SingleModuleSystem<S>,\n): (event: InferEvents<S>) => void {\n assertSystem(\"useDispatch\", system);\n return useCallback(\n (event: InferEvents<S>) => {\n system.dispatch(event);\n },\n [system],\n );\n}\n\n// ============================================================================\n// useWatch — derivation or fact side-effect (no re-render)\n// ============================================================================\n\n/** Watch a derivation or fact by key (auto-detected). When a key exists in both facts and derivations, the derivation overload takes priority. /\nexport function useWatch<\n S extends ModuleSchema,\n K extends keyof InferDerivations<S> & string,\n>(\n system: SingleModuleSystem<S>,\n key: K,\n callback: (\n newValue: InferDerivations<S>[K],\n prevValue: InferDerivations<S>[K] \| undefined,\n ) => void,\n): void;\n/* Watch a fact key with auto-detection. /\nexport function useWatch<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(\n system: SingleModuleSystem<S>,\n key: K,\n callback: (\n newValue: InferFacts<S>[K] \| undefined,\n prevValue: InferFacts<S>[K] \| undefined,\n ) => void,\n): void;\n\n/* Implementation /\nexport function useWatch(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n key: string,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation overload dispatch\n callback: (newValue: any, prevValue: any) => void,\n): void {\n assertSystem(\"useWatch\", system);\n\n const callbackRef = useRef(callback);\n callbackRef.current = callback;\n\n useEffect(() => {\n return system.watch(key, (newValue, prevValue) => {\n callbackRef.current(newValue, prevValue);\n });\n }, [system, key]);\n}\n\n// ============================================================================\n// useInspect — consolidated inspection hook\n// ============================================================================\n\n// InspectState is imported from ./shared.js and re-exported above\n\n/* Options for useInspect /\nexport interface UseInspectOptions {\n /* Throttle updates to this interval (ms). When set, uses useState instead of useSyncExternalStore. /\n throttleMs?: number;\n}\n\n/\n Hook to get consolidated system inspection data reactively.\n \n Merges isSettled, unmet/inflight requirements, and working state\n * into a single subscription. Optionally throttle updates.\n \n @example\n * ```tsx\n * const { isSettled, isWorking, hasUnmet } = useInspect(system);\n * const throttled = useInspect(system, { throttleMs: 200 });\n * ```\n /\nexport function useInspect(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n options?: UseInspectOptions,\n): InspectState {\n assertSystem(\"useInspect\", system);\n // Always call the sync version (useSyncExternalStore path) — no conditional hooks\n const syncState = _useInspectSync(system);\n\n const throttleMs = options?.throttleMs;\n const [deferredState, setDeferredState] = useState(syncState);\n const throttleRef = useRef<{\n throttled: (...args: unknown[]) => void;\n cleanup: () => void;\n } \| null>(null);\n\n // Create/recreate throttle when throttleMs changes\n useEffect(() => {\n if (!throttleMs \|\| throttleMs <= 0) {\n throttleRef.current?.cleanup();\n throttleRef.current = null;\n return;\n }\n // Clean up old throttle before creating new one\n throttleRef.current?.cleanup();\n throttleRef.current = createThrottle((...args: unknown[]) => {\n setDeferredState(args[0] as InspectState);\n }, throttleMs);\n return () => {\n throttleRef.current?.cleanup();\n throttleRef.current = null;\n };\n }, [throttleMs]);\n\n // Feed sync state through throttle after each render\n useEffect(() => {\n if (throttleRef.current) {\n throttleRef.current.throttled(syncState);\n }\n }, [syncState]);\n\n if (!throttleMs \|\| throttleMs <= 0) return syncState;\n return deferredState;\n}\n\nfunction _buildInspectState(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n): InspectState {\n return computeInspectState(system);\n}\n\nfunction _useInspectSync(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n): InspectState {\n const cachedSnapshot = useRef<InspectState \| null>(null);\n const cachedUnmetIds = useRef<string[]>([]);\n const cachedInflightIds = useRef<string[]>([]);\n const cachedIsSettled = useRef<boolean \| null>(null);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const unsubFacts = system.facts.$store.subscribeAll(onStoreChange);\n const unsubSettled = system.onSettledChange(onStoreChange);\n return () => {\n unsubFacts();\n unsubSettled();\n };\n },\n [system],\n );\n\n const getSnapshot = useCallback(() => {\n const state = _buildInspectState(system);\n\n const unmetSame =\n state.unmet.length === cachedUnmetIds.current.length &&\n state.unmet.every((u, i) => u.id === cachedUnmetIds.current[i]);\n const inflightSame =\n state.inflight.length === cachedInflightIds.current.length &&\n state.inflight.every((f, i) => f.id === cachedInflightIds.current[i]);\n const settledSame = state.isSettled === cachedIsSettled.current;\n\n if (unmetSame && inflightSame && settledSame && cachedSnapshot.current) {\n return cachedSnapshot.current;\n }\n\n cachedSnapshot.current = state;\n cachedUnmetIds.current = state.unmet.map((u) => u.id);\n cachedInflightIds.current = state.inflight.map((f) => f.id);\n cachedIsSettled.current = state.isSettled;\n\n return state;\n }, [system]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useTimeTravel — reactive time-travel state\n// ============================================================================\n\n/\n Reactive time-travel hook. Returns null when time-travel is disabled.\n * Re-renders when snapshots are taken or navigation occurs.\n \n @example\n * ```tsx\n * const tt = useTimeTravel(system);\n * if (tt) {\n * return (\n * <div>\n * <button disabled={!tt.canUndo} onClick={tt.undo}>Undo</button>\n * <button disabled={!tt.canRedo} onClick={tt.redo}>Redo</button>\n * <span>{tt.currentIndex + 1} / {tt.totalSnapshots}</span>\n * </div>\n * );\n * }\n * ```\n /\nexport function useTimeTravel(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n): TimeTravelState \| null {\n assertSystem(\"useTimeTravel\", system);\n const cachedRef = useRef<TimeTravelState \| null>(null);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => system.onTimeTravelChange(onStoreChange),\n [system],\n );\n\n const getSnapshot = useCallback(() => {\n const state = buildTimeTravelState(system);\n if (!state) return null;\n\n // Return stable reference when values haven't changed\n if (\n cachedRef.current &&\n cachedRef.current.canUndo === state.canUndo &&\n cachedRef.current.canRedo === state.canRedo &&\n cachedRef.current.currentIndex === state.currentIndex &&\n cachedRef.current.totalSnapshots === state.totalSnapshots &&\n cachedRef.current.isPaused === state.isPaused\n ) {\n return cachedRef.current;\n }\n\n cachedRef.current = state;\n return cachedRef.current;\n }, [system]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useRequirementStatus — single or multi\n// ============================================================================\n\n/* Single type overload /\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus;\n\n/* Multi-type overload /\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus>;\n\n/* Implementation /\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n typeOrTypes: string \| string[],\n): RequirementTypeStatus \| Record<string, RequirementTypeStatus> {\n if (Array.isArray(typeOrTypes)) {\n return _useRequirementStatusMulti(statusPlugin, typeOrTypes);\n }\n return _useRequirementStatusSingle(statusPlugin, typeOrTypes);\n}\n\nfunction _useRequirementStatusSingle(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus {\n const cachedRef = useRef<RequirementTypeStatus \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return statusPlugin.subscribe(onStoreChange);\n },\n [statusPlugin],\n );\n\n const getSnapshot = useCallback(() => {\n const status = statusPlugin.getStatus(type);\n\n if (cachedRef.current !== UNINITIALIZED) {\n const prev = cachedRef.current;\n if (\n prev.pending === status.pending &&\n prev.inflight === status.inflight &&\n prev.failed === status.failed &&\n prev.isLoading === status.isLoading &&\n prev.hasError === status.hasError &&\n prev.lastError === status.lastError\n ) {\n return cachedRef.current;\n }\n }\n\n cachedRef.current = status;\n return status;\n }, [statusPlugin, type]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction _useRequirementStatusMulti(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus> {\n const cachedRef = useRef<Record<string, RequirementTypeStatus> \| null>(null);\n const cachedKey = useRef<string>(\"\");\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return statusPlugin.subscribe(onStoreChange);\n },\n [statusPlugin],\n );\n\n const getSnapshot = useCallback(() => {\n const result: Record<string, RequirementTypeStatus> = {};\n const parts: string[] = [];\n for (const type of types) {\n const status = statusPlugin.getStatus(type);\n result[type] = status;\n parts.push(\n `${type}:${status.pending}:${status.inflight}:${status.failed}:${status.hasError}:${status.lastError?.message ?? \"\"}`,\n );\n }\n const key = parts.join(\"\|\");\n\n if (key !== cachedKey.current) {\n cachedKey.current = key;\n cachedRef.current = result;\n }\n\n return cachedRef.current ?? result;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [statusPlugin, ...types]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useSuspenseRequirement — single or multi\n// ============================================================================\n\n// Cache for pending promises, scoped per statusPlugin to prevent cross-system leaks.\nconst suspenseCacheMap = new WeakMap<\n StatusPlugin,\n Map<string, Promise<void>>\n>();\n\nfunction getSuspenseCache(plugin: StatusPlugin): Map<string, Promise<void>> {\n let cache = suspenseCacheMap.get(plugin);\n if (!cache) {\n cache = new Map();\n suspenseCacheMap.set(plugin, cache);\n }\n return cache;\n}\n\n/* Single type overload /\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus;\n\n/* Multi-type overload /\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus>;\n\n/* Implementation /\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n typeOrTypes: string \| string[],\n): RequirementTypeStatus \| Record<string, RequirementTypeStatus> {\n if (Array.isArray(typeOrTypes)) {\n return _useSuspenseRequirementMulti(statusPlugin, typeOrTypes);\n }\n return _useSuspenseRequirementSingle(statusPlugin, typeOrTypes);\n}\n\nfunction _useSuspenseRequirementSingle(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus {\n const status = statusPlugin.getStatus(type);\n\n if (status.hasError && status.lastError) {\n throw status.lastError;\n }\n\n if (status.isLoading) {\n const cache = getSuspenseCache(statusPlugin);\n let promise = cache.get(type);\n\n if (!promise) {\n promise = new Promise<void>((resolve) => {\n const unsubscribe = statusPlugin.subscribe(() => {\n const currentStatus = statusPlugin.getStatus(type);\n if (!currentStatus.isLoading) {\n cache.delete(type);\n unsubscribe();\n resolve();\n }\n });\n });\n cache.set(type, promise);\n }\n\n throw promise;\n }\n\n return status;\n}\n\nfunction _useSuspenseRequirementMulti(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus> {\n const result: Record<string, RequirementTypeStatus> = {};\n let hasLoading = false;\n let firstError: Error \| null = null;\n\n for (const type of types) {\n const status = statusPlugin.getStatus(type);\n result[type] = status;\n\n if (status.hasError && status.lastError && !firstError) {\n firstError = status.lastError;\n }\n if (status.isLoading) {\n hasLoading = true;\n }\n }\n\n if (firstError) {\n throw firstError;\n }\n\n if (hasLoading) {\n const cache = getSuspenseCache(statusPlugin);\n const cacheKey = types.slice().sort().join(\",\");\n let promise = cache.get(cacheKey);\n\n if (!promise) {\n promise = new Promise<void>((resolve) => {\n const unsubscribe = statusPlugin.subscribe(() => {\n const allDone = types.every(\n (t) => !statusPlugin.getStatus(t).isLoading,\n );\n if (allDone) {\n cache.delete(cacheKey);\n unsubscribe();\n resolve();\n }\n });\n });\n cache.set(cacheKey, promise);\n }\n\n throw promise;\n }\n\n return result;\n}\n\n// ============================================================================\n// useDirectiveRef — scoped system lifecycle\n// ============================================================================\n\n/* Base options for creating a scoped system /\ninterface DirectiveRefBaseConfig {\n // biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n plugins?: Plugin<any>[];\n debug?: DebugConfig;\n errorBoundary?: ErrorBoundaryConfig;\n tickMs?: number;\n zeroConfig?: boolean;\n // biome-ignore lint/suspicious/noExplicitAny: Facts type varies\n initialFacts?: Record<string, any>;\n}\n\n/* Options for useDirectiveRef: module directly, or config object /\nexport type UseDirectiveRefOptions<M extends ModuleSchema> =\n \| ModuleDef<M>\n \| (DirectiveRefBaseConfig & { module: ModuleDef<M> });\n\n/* Options for useDirectiveRef with namespaced modules /\nexport type UseDirectiveRefNamespacedOptions<Modules extends ModulesMap> =\n DirectiveRefBaseConfig & { modules: { [K in keyof Modules]: Modules[K] } };\n\n// --- Single-module overloads ---\n\n/* Without status (no config): returns system directly /\nexport function useDirectiveRef<M extends ModuleSchema>(\n options: UseDirectiveRefOptions<M>,\n): SingleModuleSystem<M>;\n\n/* Without status (with config): returns system directly /\nexport function useDirectiveRef<M extends ModuleSchema>(\n options: UseDirectiveRefOptions<M>,\n config: DirectiveRefBaseConfig,\n): SingleModuleSystem<M>;\n\n/* With status: returns { system, statusPlugin } /\nexport function useDirectiveRef<M extends ModuleSchema>(\n options: UseDirectiveRefOptions<M>,\n config: { status: true } & DirectiveRefBaseConfig,\n): { system: SingleModuleSystem<M>; statusPlugin: StatusPlugin };\n\n// --- Namespaced (multi-module) overloads ---\n\n/* Namespaced: returns NamespacedSystem directly /\nexport function useDirectiveRef<const Modules extends ModulesMap>(\n options: UseDirectiveRefNamespacedOptions<Modules>,\n): NamespacedSystem<Modules>;\n\n/* Namespaced with config: returns NamespacedSystem directly /\nexport function useDirectiveRef<const Modules extends ModulesMap>(\n options: UseDirectiveRefNamespacedOptions<Modules>,\n config: DirectiveRefBaseConfig,\n): NamespacedSystem<Modules>;\n\n/* Implementation /\nexport function useDirectiveRef(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature handles both modes\n options: any,\n config?: { status?: boolean } & DirectiveRefBaseConfig,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation return varies by overload\n): any {\n // biome-ignore lint/suspicious/noExplicitAny: System ref holds either system type\n const systemRef = useRef<any>(null);\n const statusPluginRef = useRef<StatusPlugin \| null>(null);\n // Factory ref for strict mode re-creation (effects unmount then re-mount)\n // biome-ignore lint/suspicious/noExplicitAny: Factory return type varies\n const factoryRef = useRef<(() => any) \| null>(null);\n const wantStatus = config?.status === true;\n const isNamespaced = \"modules\" in options;\n\n if (!systemRef.current) {\n // Build a factory that creates + starts the system.\n // Called once during render and again on strict-mode re-mount.\n factoryRef.current = () => {\n if (isNamespaced) {\n // --- Namespaced mode: { modules: { ... } } ---\n const { modules, ...rest } = options;\n const plugins = config?.plugins ?? rest.plugins ?? [];\n const debug = config?.debug ?? rest.debug;\n const errorBoundary = config?.errorBoundary ?? rest.errorBoundary;\n const tickMs = config?.tickMs ?? rest.tickMs;\n const zeroConfig = config?.zeroConfig ?? rest.zeroConfig;\n const initialFacts = config?.initialFacts ?? rest.initialFacts;\n\n const sys = createSystem({\n modules,\n plugins: plugins.length > 0 ? plugins : undefined,\n debug,\n errorBoundary,\n tickMs,\n zeroConfig,\n initialFacts,\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n } as any);\n // Always initialize facts/derivations (safe for SSR).\n // Only start reconciliation on the client.\n sys.initialize();\n if (typeof window !== \"undefined\") {\n sys.start();\n }\n\n return sys;\n }\n\n // --- Single-module mode ---\n const isModule = \"id\" in options && \"schema\" in options;\n const mod = isModule ? options : options.module;\n const baseOpts = isModule ? {} : (options as DirectiveRefBaseConfig);\n const plugins = config?.plugins ?? baseOpts.plugins ?? [];\n const debug = config?.debug ?? baseOpts.debug;\n const errorBoundary = config?.errorBoundary ?? baseOpts.errorBoundary;\n const tickMs = config?.tickMs ?? baseOpts.tickMs;\n const zeroConfig = config?.zeroConfig ?? baseOpts.zeroConfig;\n const initialFacts = config?.initialFacts ?? baseOpts.initialFacts;\n\n let allPlugins = [...plugins];\n\n if (wantStatus) {\n statusPluginRef.current = createRequirementStatusPlugin();\n // biome-ignore lint/suspicious/noExplicitAny: Plugin generic issues\n allPlugins = [\n ...allPlugins,\n statusPluginRef.current.plugin as Plugin<any>,\n ];\n }\n\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n const sys = createSystem({\n module: mod,\n plugins: allPlugins.length > 0 ? allPlugins : undefined,\n debug,\n errorBoundary,\n tickMs,\n zeroConfig,\n initialFacts,\n } as any);\n // Always initialize facts/derivations (safe for SSR).\n // Only start reconciliation on the client.\n sys.initialize();\n if (typeof window !== \"undefined\") {\n sys.start();\n }\n\n return sys;\n };\n\n // Start synchronously so facts are initialized before the first render\n systemRef.current = factoryRef.current();\n }\n\n useEffect(() => {\n // Strict mode re-mount: system was destroyed in cleanup, recreate it\n if (!systemRef.current && factoryRef.current) {\n systemRef.current = factoryRef.current();\n }\n\n return () => {\n systemRef.current?.destroy();\n systemRef.current = null;\n statusPluginRef.current = null;\n };\n }, []);\n\n if (wantStatus && !isNamespaced) {\n return {\n system: systemRef.current!,\n statusPlugin: statusPluginRef.current!,\n };\n }\n\n return systemRef.current!;\n}\n\n// ============================================================================\n// useNamespacedSelector — select from a NamespacedSystem with useSyncExternalStore\n// ============================================================================\n\n/\n React hook to select derived values from a NamespacedSystem.\n * Uses useSyncExternalStore for tear-free reads.\n \n @param system - The namespaced system to read from\n * @param keys - Namespaced keys to subscribe to (e.g., [\"auth.token\", \"data.count\"])\n * @param selector - Function that reads from system.facts / system.derive\n \n @example\n * ```tsx\n * const system = useDirectiveRef({ modules: { auth, data } });\n * const token = useNamespacedSelector(system, [\"auth.token\"], (s) => s.facts.auth.token);\n * const count = useNamespacedSelector(system, [\"data.\"], (s) => s.derive.data.total);\n ```\n /\nexport function useNamespacedSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n keys: string[],\n selector: (system: NamespacedSystem<Modules>) => R,\n): R {\n const keysRef = useRef(keys);\n keysRef.current = keys;\n const selectorRef = useRef(selector);\n selectorRef.current = selector;\n\n const subscribe = useCallback(\n (onStoreChange: () => void) =>\n system.subscribe(keysRef.current, onStoreChange),\n [system],\n );\n\n const getSnapshot = useCallback(() => selectorRef.current(system), [system]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useDirective — scoped system with selected values in containers\n// ============================================================================\n\n/* Options for useDirective hook /\nexport interface UseDirectiveOptions<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string = never,\n DK extends keyof InferDerivations<S> & string = never,\n> extends DirectiveRefBaseConfig {\n /* Fact keys to subscribe to /\n facts?: FK[];\n /* Derivation keys to subscribe to /\n derived?: DK[];\n /* Enable status plugin /\n status?: boolean;\n}\n\n/* Return type for useDirective hook (without status) /\nexport type UseDirectiveReturn<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string,\n DK extends keyof InferDerivations<S> & string,\n> = {\n system: SingleModuleSystem<S>;\n dispatch: (event: InferEvents<S>) => void;\n events: SingleModuleSystem<S>[\"events\"];\n facts: Pick<InferFacts<S>, FK>;\n derived: Pick<InferDerivations<S>, DK>;\n};\n\n/* Return type for useDirective hook (with status) /\nexport type UseDirectiveReturnWithStatus<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string,\n DK extends keyof InferDerivations<S> & string,\n> = UseDirectiveReturn<S, FK, DK> & {\n statusPlugin: StatusPlugin;\n};\n\n/\n Convenience hook that creates a scoped system and reads selected facts/derivations\n * into container objects. When no `facts` or `derived` keys are specified, subscribes\n * to ALL facts and derivations (replacing the former `useModule` hook).\n \n @example\n * ```tsx\n * // Selective subscription\n * const { dispatch, facts: { count }, derived: { doubled } } = useDirective(counterModule, {\n * facts: [\"count\"],\n * derived: [\"doubled\"],\n * });\n \n // Subscribe to everything (no keys = all facts + all derivations)\n * const { facts, derived, events, dispatch } = useDirective(counterModule);\n * ```\n /\nexport function useDirective<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string = never,\n DK extends keyof InferDerivations<S> & string = never,\n>(\n moduleOrOptions: UseDirectiveRefOptions<S>,\n selections: UseDirectiveOptions<S, FK, DK> = {} as UseDirectiveOptions<\n S,\n FK,\n DK\n >,\n): UseDirectiveReturn<S, FK, DK> \| UseDirectiveReturnWithStatus<S, FK, DK> {\n const {\n facts: factKeysOpt,\n derived: derivedKeysOpt,\n status,\n ...configRest\n } = selections;\n const factKeys = (factKeysOpt ?? []) as FK[];\n const derivedKeys = (derivedKeysOpt ?? []) as DK[];\n\n // When no keys are specified, subscribe to everything\n const subscribeAll = factKeys.length === 0 && derivedKeys.length === 0;\n\n // Create system via useDirectiveRef (handles lifecycle)\n // biome-ignore lint/suspicious/noExplicitAny: Conditional overload dispatch\n const refResult: any = status\n ? useDirectiveRef(moduleOrOptions, { status: true as const, ...configRest })\n : useDirectiveRef(moduleOrOptions, configRest);\n\n const system: SingleModuleSystem<S> = status ? refResult.system : refResult;\n\n const statusPlugin = status\n ? (\n refResult as {\n system: SingleModuleSystem<S>;\n statusPlugin: StatusPlugin;\n }\n ).statusPlugin\n : undefined;\n\n // For subscribe-all mode, get all derivation keys\n const allDerivationKeys = useMemo(\n () => (subscribeAll ? Object.keys(system.derive) : []),\n [system, subscribeAll],\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const unsubs: Array<() => void> = [];\n if (subscribeAll) {\n // Subscribe to ALL facts and ALL derivations\n unsubs.push(system.facts.$store.subscribeAll(onStoreChange));\n if (allDerivationKeys.length > 0) {\n unsubs.push(system.subscribe(allDerivationKeys, onStoreChange));\n }\n } else {\n if (factKeys.length > 0) {\n unsubs.push(system.facts.$store.subscribe(factKeys, onStoreChange));\n }\n if (derivedKeys.length > 0) {\n unsubs.push(system.subscribe(derivedKeys, onStoreChange));\n }\n }\n return () => {\n for (const unsub of unsubs) unsub();\n };\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [system, subscribeAll, ...factKeys, ...derivedKeys, ...allDerivationKeys],\n );\n\n const cachedFacts = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n const cachedDerived = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n const cachedWrapper = useRef<{\n facts: Record<string, unknown>;\n derived: Record<string, unknown>;\n } \| null>(null);\n\n const getSnapshot = useCallback(() => {\n let factsResult: Record<string, unknown>;\n let derivedResult: Record<string, unknown>;\n let effectiveFactKeys: readonly string[];\n let effectiveDerivedKeys: readonly string[];\n\n if (subscribeAll) {\n // Read ALL facts and ALL derivations\n factsResult = system.facts.$store.toObject();\n effectiveFactKeys = Object.keys(factsResult);\n derivedResult = {};\n for (const key of allDerivationKeys) {\n derivedResult[key] = system.read(key);\n }\n effectiveDerivedKeys = allDerivationKeys;\n } else {\n // Read selected keys only\n factsResult = {};\n for (const key of factKeys) {\n // biome-ignore lint/suspicious/noExplicitAny: Dynamic fact access\n factsResult[key] = (system.facts as any)[key];\n }\n effectiveFactKeys = factKeys;\n derivedResult = {};\n for (const key of derivedKeys) {\n derivedResult[key] = system.read(key);\n }\n effectiveDerivedKeys = derivedKeys;\n }\n\n // Check facts stability\n let factsSame = cachedFacts.current !== UNINITIALIZED;\n if (factsSame) {\n const prev = cachedFacts.current as Record<string, unknown>;\n const prevKeys = Object.keys(prev);\n if (prevKeys.length !== effectiveFactKeys.length) {\n factsSame = false;\n } else {\n for (const key of effectiveFactKeys) {\n if (!Object.is(prev[key], factsResult[key])) {\n factsSame = false;\n break;\n }\n }\n }\n }\n\n // Check derived stability\n let derivedSame = cachedDerived.current !== UNINITIALIZED;\n if (derivedSame) {\n const prev = cachedDerived.current as Record<string, unknown>;\n const prevKeys = Object.keys(prev);\n if (prevKeys.length !== effectiveDerivedKeys.length) {\n derivedSame = false;\n } else {\n for (const key of effectiveDerivedKeys) {\n if (!Object.is(prev[key], derivedResult[key])) {\n derivedSame = false;\n break;\n }\n }\n }\n }\n\n const stableFacts = factsSame\n ? (cachedFacts.current as Record<string, unknown>)\n : factsResult;\n const stableDerived = derivedSame\n ? (cachedDerived.current as Record<string, unknown>)\n : derivedResult;\n\n if (!factsSame) cachedFacts.current = factsResult;\n if (!derivedSame) cachedDerived.current = derivedResult;\n\n // Return same wrapper reference when both containers are unchanged\n if (factsSame && derivedSame && cachedWrapper.current) {\n return cachedWrapper.current;\n }\n\n cachedWrapper.current = { facts: stableFacts, derived: stableDerived };\n return cachedWrapper.current;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, subscribeAll, ...factKeys, ...derivedKeys, ...allDerivationKeys]);\n\n const values = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n const dispatch = useCallback(\n (event: InferEvents<S>) => system.dispatch(event),\n [system],\n );\n\n const events = useEvents(system);\n\n const base = {\n system,\n dispatch,\n events,\n facts: values.facts as Pick<InferFacts<S>, FK>,\n derived: values.derived as Pick<InferDerivations<S>, DK>,\n };\n\n if (status && statusPlugin) {\n return { ...base, statusPlugin } as UseDirectiveReturnWithStatus<S, FK, DK>;\n }\n\n return base as UseDirectiveReturn<S, FK, DK>;\n}\n\n// ============================================================================\n// useEvents — memoized events reference\n// ============================================================================\n\n/\n Returns the system's events dispatcher. Provides autocomplete for event names\n * and avoids needing useCallback wrappers for event dispatch.\n \n @example\n * ```tsx\n * const events = useEvents(system);\n * <button onClick={() => events.increment()}>+</button>\n * ```\n /\nexport function useEvents<S extends ModuleSchema>(\n system: SingleModuleSystem<S>,\n): SingleModuleSystem<S>[\"events\"] {\n assertSystem(\"useEvents\", system);\n return useMemo(() => system.events, [system]);\n}\n\n// ============================================================================\n// useExplain — reactive requirement explanation\n// ============================================================================\n\n/\n Reactively returns the explanation string for a requirement.\n * Updates whenever system state changes.\n \n @example\n * ```tsx\n * const explanation = useExplain(system, \"req-123\");\n * if (explanation) <pre>{explanation}</pre>;\n * ```\n /\nexport function useExplain(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n requirementId: string,\n): string \| null {\n assertSystem(\"useExplain\", system);\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const unsubFacts = system.facts.$store.subscribeAll(onStoreChange);\n const unsubSettled = system.onSettledChange(onStoreChange);\n return () => {\n unsubFacts();\n unsubSettled();\n };\n },\n [system],\n );\n\n const getSnapshot = useCallback(() => {\n return system.explain(requirementId);\n }, [system, requirementId]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useConstraintStatus — reactive constraint inspection\n// ============================================================================\n\n// ConstraintInfo is imported from ./shared.js and re-exported above\n\n/* Get all constraints /\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n): ConstraintInfo[];\n/* Get a single constraint by ID /\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n constraintId: string,\n): ConstraintInfo \| null;\n/* Implementation /\nexport function useConstraintStatus(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n constraintId?: string,\n): ConstraintInfo[] \| ConstraintInfo \| null {\n assertSystem(\"useConstraintStatus\", system);\n const inspectState = useInspect(system);\n\n return useMemo(() => {\n const inspection = system.inspect();\n if (!constraintId) return inspection.constraints;\n return inspection.constraints.find((c) => c.id === constraintId) ?? null;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, constraintId, inspectState]);\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\n/* Result of useOptimisticUpdate /\nexport interface OptimisticUpdateResult {\n /* Apply an optimistic update (saves snapshot, then runs updateFn in batch) /\n mutate: (updateFn: () => void) => void;\n /* Whether a resolver is currently processing the optimistic change /\n isPending: boolean;\n /* Error if the resolver failed /\n error: Error \| null;\n /* Manually rollback to the pre-mutation snapshot /\n rollback: () => void;\n}\n\n/\n Optimistic update hook. Saves a snapshot before mutating, monitors\n * a requirement type via statusPlugin, and rolls back on failure.\n \n @example\n * ```tsx\n * const { mutate, isPending, error, rollback } = useOptimisticUpdate(\n * system, statusPlugin, \"SAVE_ITEM\"\n * );\n * mutate(() => { system.facts.items = [...system.facts.items, newItem]; });\n * ```\n /\nexport function useOptimisticUpdate(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n statusPlugin?: StatusPlugin,\n requirementType?: string,\n): OptimisticUpdateResult {\n assertSystem(\"useOptimisticUpdate\", system);\n const [isPending, setIsPending] = useState(false);\n const [error, setError] = useState<Error \| null>(null);\n const snapshotRef = useRef<SystemSnapshot \| null>(null);\n\n const rollback = useCallback(() => {\n if (snapshotRef.current) {\n system.restore(snapshotRef.current);\n snapshotRef.current = null;\n }\n setIsPending(false);\n setError(null);\n }, [system]);\n\n const mutate = useCallback(\n (updateFn: () => void) => {\n snapshotRef.current = system.getSnapshot();\n setIsPending(true);\n setError(null);\n system.batch(updateFn);\n },\n [system],\n );\n\n // Watch for resolver completion/failure\n useEffect(() => {\n if (!statusPlugin \|\| !requirementType \|\| !isPending) return;\n\n return statusPlugin.subscribe(() => {\n const status = statusPlugin.getStatus(requirementType);\n if (!status.isLoading && !status.hasError) {\n // Resolved successfully — keep optimistic state\n snapshotRef.current = null;\n setIsPending(false);\n } else if (status.hasError) {\n // Failed — rollback\n setError(status.lastError);\n rollback();\n }\n });\n }, [statusPlugin, requirementType, isPending, rollback]);\n\n return { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// DirectiveHydrator + useHydratedSystem — SSR/RSC hydration\n// ============================================================================\n\n/* Props for DirectiveHydrator component /\nexport interface HydratorProps {\n snapshot: DistributableSnapshot;\n children: ReactNode;\n}\n\n/* Context for hydrated snapshot /\nconst HydrationContext = createContext<DistributableSnapshot \| null>(null);\n\n/\n SSR/RSC hydration component. Wraps children with a snapshot context\n * that `useHydratedSystem` can consume on the client.\n \n @example\n * ```tsx\n * // Server component\n * <DirectiveHydrator snapshot={serverSnapshot}>\n * <ClientApp />\n * </DirectiveHydrator>\n * ```\n /\nexport function DirectiveHydrator({ snapshot, children }: HydratorProps) {\n return (\n <HydrationContext.Provider value={snapshot}>\n {children}\n </HydrationContext.Provider>\n );\n}\n\n/\n Client-side hook that creates a system hydrated from a server snapshot.\n * Must be used inside a `<DirectiveHydrator>`.\n \n @example\n * ```tsx\n * function ClientApp() {\n * const system = useHydratedSystem(counterModule);\n * const count = useFact(system, \"count\");\n * return <div>{count}</div>;\n * }\n * ```\n */\nexport function useHydratedSystem<S extends ModuleSchema>(\n moduleDef: ModuleDef<S>,\n config?: DirectiveRefBaseConfig,\n): SingleModuleSystem<S> {\n const snapshot = useContext(HydrationContext);\n\n // Merge snapshot data as initial facts if available\n const mergedConfig = useMemo(() => {\n if (!snapshot?.data) return config ?? {};\n return {\n ...(config ?? {}),\n initialFacts: {\n ...(config?.initialFacts ?? {}),\n ...snapshot.data,\n },\n };\n }, [snapshot, config]);\n\n return useDirectiveRef(moduleDef, mergedConfig) as SingleModuleSystem<S>;\n}\n"]}
1	+ {"version":3,"sources":["../src/index.tsx"],"names":["UNINITIALIZED","useFact","system","keyOrKeys","assertSystem","_useFacts","_useSingleFact","factKey","subscribe","useCallback","onStoreChange","getSnapshot","useSyncExternalStore","factKeys","cachedValue","useRef","result","key","same","useDerived","_useDerivedMulti","_useSingleDerived","derivationId","derivationIds","id","useSelector","systemArg","selector","defaultValueArg","equalityFnArg","_useNamespacedSelectorImpl","defaultValue","hasDefault","equalityFn","defaultEquality","selectorRef","eqRef","defaultValueRef","trackedFactKeysRef","trackedDeriveKeysRef","unsubsRef","deriveKeys","useMemo","runWithTracking","runTrackedSelector","resubscribe","unsub","derivedKeys","updated","depsChanged","effectiveValue","newValue","moduleNames","wildcardKeys","ns","useDispatch","event","useWatch","callback","callbackRef","useEffect","prevValue","useInspect","options","syncState","_useInspectSync","throttleMs","deferredState","setDeferredState","useState","throttleRef","createThrottle","args","_buildInspectState","computeInspectState","cachedSnapshot","cachedUnmetIds","cachedInflightIds","cachedIsSettled","unsubFacts","unsubSettled","state","unmetSame","u","i","inflightSame","f","settledSame","useHistory","cachedRef","buildHistoryState","useRequirementStatus","statusPlugin","typeOrTypes","_useRequirementStatusMulti","_useRequirementStatusSingle","type","status","prev","types","cachedKey","parts","suspenseCacheMap","getSuspenseCache","plugin","cache","useSuspenseRequirement","_useSuspenseRequirementMulti","_useSuspenseRequirementSingle","promise","resolve","unsubscribe","hasLoading","firstError","cacheKey","t","useDirectiveRef","config","systemRef","statusPluginRef","factoryRef","wantStatus","isNamespaced","modules","rest","plugins","history","trace","errorBoundary","tickMs","zeroConfig","initialFacts","sys","createSystem","isModule","mod","baseOpts","allPlugins","createRequirementStatusPlugin","useNamespacedSelector","keys","keysRef","useDirective","moduleOrOptions","selections","factKeysOpt","derivedKeysOpt","configRest","subscribeAll","refResult","allDerivationKeys","unsubs","cachedFacts","cachedDerived","cachedWrapper","factsResult","derivedResult","effectiveFactKeys","effectiveDerivedKeys","factsSame","derivedSame","stableFacts","stableDerived","values","dispatch","events","useEvents","base","useExplain","requirementId","useConstraintStatus","constraintId","inspectState","inspection","c","useOptimisticUpdate","requirementType","isPending","setIsPending","error","setError","snapshotRef","rollback","mutate","updateFn","HydrationContext","createContext","DirectiveHydrator","snapshot","children","jsx","useHydratedSystem","moduleDef","useContext","mergedConfig"],"mappings":"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","file":"index.js","sourcesContent":["/*\n React Adapter - Consolidated hooks for React integration\n \n 18 public exports: useFact, useDerived, useDispatch, useDirective,\n * useDirectiveRef, useSelector, useWatch, useInspect, useRequirementStatus,\n * useSuspenseRequirement, useEvents, useExplain, useConstraintStatus,\n * useOptimisticUpdate, DirectiveHydrator, useHydratedSystem,\n * useHistory, shallowEqual\n \n @example\n * ```tsx\n * import { useFact, useDerived, useEvents } from '@directive-run/react';\n \n const system = createSystem({ module: counterModule });\n * system.start();\n \n function Counter() {\n * const count = useFact(system, \"count\");\n * const doubled = useDerived(system, \"doubled\");\n * const events = useEvents(system);\n \n return (\n * <div>\n * <p>Count: {count}</p>\n * <p>Doubled: {doubled}</p>\n * <button onClick={() => events.increment()}>+</button>\n * </div>\n * );\n * }\n * ```\n /\n\nimport type {\n TraceOption,\n DistributableSnapshot,\n ErrorBoundaryConfig,\n InferDerivations,\n InferEvents,\n InferFacts,\n InferSelectorState,\n ModuleDef,\n ModuleSchema,\n ModulesMap,\n NamespacedSystem,\n Plugin,\n SingleModuleSystem,\n SystemSnapshot,\n HistoryOption,\n HistoryState,\n} from \"@directive-run/core\";\nimport {\n createRequirementStatusPlugin,\n createSystem,\n} from \"@directive-run/core\";\nimport type { RequirementTypeStatus } from \"@directive-run/core\";\nimport {\n type ConstraintInfo,\n type InspectState,\n assertSystem,\n buildHistoryState,\n computeInspectState,\n createThrottle,\n defaultEquality,\n depsChanged,\n runTrackedSelector,\n shallowEqual,\n} from \"@directive-run/core/adapter-utils\";\nimport type { ReactNode } from \"react\";\nimport {\n createContext,\n useCallback,\n useContext,\n useEffect,\n useMemo,\n useRef,\n useState,\n useSyncExternalStore,\n} from \"react\";\n\n// Re-export for convenience\nexport type { RequirementTypeStatus, InspectState, ConstraintInfo };\nexport { shallowEqual };\n\n/* Type for the requirement status plugin return value /\nexport type StatusPlugin = ReturnType<typeof createRequirementStatusPlugin>;\n\n// ============================================================================\n// Internal Helpers\n// ============================================================================\n\n/* Sentinel value for uninitialized selector cache /\nconst UNINITIALIZED = Symbol(\"directive.uninitialized\");\n\n// ============================================================================\n// useFact — single key or multi key\n// ============================================================================\n\n/* Single key overload /\nexport function useFact<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(system: SingleModuleSystem<S>, factKey: K): InferFacts<S>[K] \| undefined;\n\n/* Multi-key overload /\nexport function useFact<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(system: SingleModuleSystem<S>, factKeys: K[]): Pick<InferFacts<S>, K>;\n\n/* Implementation /\nexport function useFact(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n keyOrKeys: string \| string[],\n): unknown {\n assertSystem(\"useFact\", system);\n if (\n process.env.NODE_ENV !== \"production\" &&\n typeof keyOrKeys === \"function\"\n ) {\n console.error(\n \"[Directive] useFact() received a function. Did you mean useSelector()? \" +\n \"useFact() takes a string key or array of keys, not a selector function.\",\n );\n }\n\n // Multi-key path: useFact(system, [keys])\n if (Array.isArray(keyOrKeys)) {\n return _useFacts(system, keyOrKeys);\n }\n\n // Single key path: useFact(system, key)\n return _useSingleFact(system, keyOrKeys);\n}\n\nfunction _useSingleFact(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n factKey: string,\n): unknown {\n if (process.env.NODE_ENV !== \"production\") {\n if (!(factKey in system.facts.$store.toObject())) {\n console.warn(\n `[Directive] useFact(\"${factKey}\") — fact not found in store. ` +\n `Check that \"${factKey}\" is defined in your module's schema.`,\n );\n }\n }\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.facts.$store.subscribe([factKey], onStoreChange);\n },\n [system, factKey],\n );\n\n const getSnapshot = useCallback(() => {\n return system.facts.$store.get(factKey as never);\n }, [system, factKey]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction _useFacts(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n factKeys: string[],\n): Record<string, unknown> {\n const cachedValue = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.facts.$store.subscribe(factKeys, onStoreChange);\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [system, ...factKeys],\n );\n\n const getSnapshot = useCallback(() => {\n const result: Record<string, unknown> = {};\n for (const key of factKeys) {\n result[key] = system.facts.$store.get(key as never);\n }\n\n if (cachedValue.current !== UNINITIALIZED) {\n let same = true;\n for (const key of factKeys) {\n if (\n !Object.is(\n (cachedValue.current as Record<string, unknown>)[key],\n result[key],\n )\n ) {\n same = false;\n break;\n }\n }\n if (same) return cachedValue.current;\n }\n\n cachedValue.current = result;\n return result;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, ...factKeys]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useDerived — single key or multi key\n// ============================================================================\n\n/* Single key overload /\nexport function useDerived<\n S extends ModuleSchema,\n K extends keyof InferDerivations<S> & string,\n>(system: SingleModuleSystem<S>, derivationId: K): InferDerivations<S>[K];\n\n/* Multi-key overload /\nexport function useDerived<\n S extends ModuleSchema,\n K extends keyof InferDerivations<S> & string,\n>(\n system: SingleModuleSystem<S>,\n derivationIds: K[],\n): Pick<InferDerivations<S>, K>;\n\n/* Implementation /\nexport function useDerived(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n keyOrKeys: string \| string[],\n): unknown {\n assertSystem(\"useDerived\", system);\n if (\n process.env.NODE_ENV !== \"production\" &&\n typeof keyOrKeys === \"function\"\n ) {\n console.error(\n \"[Directive] useDerived() received a function. Did you mean useSelector()? \" +\n \"useDerived() takes a string key or array of keys, not a selector function.\",\n );\n }\n\n // Multi-key path\n if (Array.isArray(keyOrKeys)) {\n return _useDerivedMulti(system, keyOrKeys);\n }\n\n // Single key path\n return _useSingleDerived(system, keyOrKeys);\n}\n\nfunction _useSingleDerived(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n derivationId: string,\n): unknown {\n if (process.env.NODE_ENV !== \"production\") {\n if (!(derivationId in system.derive)) {\n console.warn(\n `[Directive] useDerived(\"${derivationId}\") — derivation not found. ` +\n `Check that \"${derivationId}\" is defined in your module's derive property.`,\n );\n }\n }\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.subscribe([derivationId], onStoreChange);\n },\n [system, derivationId],\n );\n\n const getSnapshot = useCallback(() => {\n return system.read(derivationId);\n }, [system, derivationId]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction _useDerivedMulti(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n derivationIds: string[],\n): Record<string, unknown> {\n const cachedValue = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return system.subscribe(derivationIds, onStoreChange);\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [system, ...derivationIds],\n );\n\n const getSnapshot = useCallback(() => {\n const result: Record<string, unknown> = {};\n for (const id of derivationIds) {\n result[id] = system.read(id);\n }\n\n if (cachedValue.current !== UNINITIALIZED) {\n let same = true;\n for (const id of derivationIds) {\n if (\n !Object.is(\n (cachedValue.current as Record<string, unknown>)[id],\n result[id],\n )\n ) {\n same = false;\n break;\n }\n }\n if (same) return cachedValue.current;\n }\n\n cachedValue.current = result;\n return result;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, ...derivationIds]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useSelector — Zustand-style selector over facts and derivations\n// ============================================================================\n\n/\n Auto-tracking selector over facts and derivations (Zustand-style).\n * Uses `withTracking()` to detect which facts the selector accesses,\n * then subscribes only to those keys. Falls back to subscribeAll\n * if no keys are detected.\n \n Supports an optional default value as the 3rd parameter, used when\n * the system is null/undefined or the selector returns undefined.\n * When a default value is provided, the system parameter may be\n * null \| undefined — the hook returns the default and recomputes\n * when the system becomes available.\n \n An optional equality function can be passed as the 4th parameter\n * to customize when the selector result is considered \"changed\".\n * Defaults to `Object.is`. Use `shallowEqual` (exported from this\n * package) when your selector returns a new object/array each time.\n \n @example\n * ```tsx\n * // Basic usage\n * const count = useSelector(system, (s) => s.count);\n \n // With default value (allows nullable system)\n * const count = useSelector(system, (s) => s.count, 0);\n \n // With default value + custom equality\n * const coords = useSelector(system, (s) => ({ x: s.x, y: s.y }), { x: 0, y: 0 }, shallowEqual);\n * ```\n /\n\n// Non-null system, no default\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S>,\n selector: (state: InferSelectorState<S>) => R,\n): R;\n\n// Non-null system, with default value and optional equality\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S>,\n selector: (state: InferSelectorState<S>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// Nullable system, default REQUIRED\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S> \| null \| undefined,\n selector: (state: InferSelectorState<S>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// --- Namespaced system overloads ---\n\n// Namespaced system, no default\nexport function useSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n selector: (state: NamespacedSystem<Modules>) => R,\n): R;\n\n// Namespaced system, with default value and optional equality\nexport function useSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n selector: (state: NamespacedSystem<Modules>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// Nullable namespaced system, default REQUIRED\nexport function useSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules> \| null \| undefined,\n selector: (state: NamespacedSystem<Modules>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// --- Generic fallbacks ---\n\n// Generic fallback: non-null system\nexport function useSelector<R>(\n // biome-ignore lint/suspicious/noExplicitAny: Generic fallback\n system: SingleModuleSystem<any>,\n // biome-ignore lint/suspicious/noExplicitAny: Selector receives dynamic state\n selector: (state: Record<string, any>) => R,\n defaultValue?: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\n// Generic fallback: nullable system\nexport function useSelector<R>(\n // biome-ignore lint/suspicious/noExplicitAny: Generic fallback\n system: SingleModuleSystem<any> \| null \| undefined,\n // biome-ignore lint/suspicious/noExplicitAny: Selector receives dynamic state\n selector: (state: Record<string, any>) => R,\n defaultValue: R,\n equalityFn?: (a: R, b: R) => boolean,\n): R;\n\nexport function useSelector(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature accepts both system types\n systemArg: SingleModuleSystem<any> \| NamespacedSystem<any> \| null \| undefined,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n selector: (state: any) => unknown,\n defaultValueArg?: unknown,\n equalityFnArg?: (a: unknown, b: unknown) => boolean,\n): unknown {\n // Route to namespaced implementation if system is a NamespacedSystem\n // biome-ignore lint/suspicious/noExplicitAny: Runtime type check\n if (systemArg && (systemArg as any)._mode === \"namespaced\") {\n // biome-ignore lint/suspicious/noExplicitAny: Delegate to namespaced impl\n return _useNamespacedSelectorImpl(\n systemArg as NamespacedSystem<any>,\n selector,\n defaultValueArg,\n equalityFnArg,\n );\n }\n\n // After the namespaced check, system is a SingleModuleSystem\n const system = systemArg as SingleModuleSystem<any> \| null \| undefined;\n let defaultValue: unknown;\n let hasDefault = false;\n const equalityFn: (a: unknown, b: unknown) => boolean =\n equalityFnArg ?? defaultEquality;\n\n if (defaultValueArg !== undefined) {\n defaultValue = defaultValueArg;\n hasDefault = true;\n }\n\n // Dev-mode warning: null system without a default value\n if (process.env.NODE_ENV !== \"production\") {\n if (!system && !hasDefault) {\n console.error(\n \"[Directive] useSelector() received a null/undefined system without a default value. \" +\n \"Provide a default value as the 3rd parameter: useSelector(system, selector, defaultValue)\",\n );\n }\n }\n\n // Store selector/eq/default in refs to avoid resubscription churn\n const selectorRef = useRef(selector);\n const eqRef = useRef(equalityFn);\n const defaultValueRef = useRef(defaultValue);\n selectorRef.current = selector;\n eqRef.current = equalityFn;\n defaultValueRef.current = defaultValue;\n\n const trackedFactKeysRef = useRef<string[]>([]);\n const trackedDeriveKeysRef = useRef<string[]>([]);\n const cachedValue = useRef<unknown>(UNINITIALIZED);\n const unsubsRef = useRef<Array<() => void>>([]);\n\n // Build a tracking-aware state proxy that exposes both facts and derivations\n const deriveKeys = useMemo(\n () => (system ? new Set(Object.keys(system.derive)) : new Set<string>()),\n [system],\n );\n\n const runWithTracking = useCallback(() => {\n if (!system) {\n return {\n value: defaultValueRef.current,\n factKeys: [] as string[],\n deriveKeys: [] as string[],\n };\n }\n\n return runTrackedSelector(system, deriveKeys, selectorRef.current);\n }, [system, deriveKeys]);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n if (!system) {\n // No system — return noop unsubscribe\n return () => {};\n }\n\n const resubscribe = () => {\n // Cleanup previous subscriptions\n for (const unsub of unsubsRef.current) unsub();\n unsubsRef.current = [];\n\n // Run selector with tracking to detect accessed keys\n const { factKeys, deriveKeys: derivedKeys } = runWithTracking();\n trackedFactKeysRef.current = factKeys;\n trackedDeriveKeysRef.current = derivedKeys;\n\n // Subscribe to accessed fact keys\n if (factKeys.length > 0) {\n unsubsRef.current.push(\n system.facts.$store.subscribe(factKeys, () => {\n // Re-track on notification for dynamic deps\n const updated = runWithTracking();\n if (\n depsChanged(\n trackedFactKeysRef.current,\n updated.factKeys,\n trackedDeriveKeysRef.current,\n updated.deriveKeys,\n )\n )\n resubscribe();\n onStoreChange();\n }),\n );\n } else if (derivedKeys.length === 0) {\n // No deps at all — subscribe to everything\n unsubsRef.current.push(\n system.facts.$store.subscribeAll(onStoreChange),\n );\n }\n\n // Subscribe to accessed derivation keys\n if (derivedKeys.length > 0) {\n unsubsRef.current.push(\n system.subscribe(derivedKeys, () => {\n // Re-track on notification for dynamic deps\n const updated = runWithTracking();\n if (\n depsChanged(\n trackedFactKeysRef.current,\n updated.factKeys,\n trackedDeriveKeysRef.current,\n updated.deriveKeys,\n )\n )\n resubscribe();\n onStoreChange();\n }),\n );\n }\n };\n\n resubscribe();\n\n return () => {\n for (const unsub of unsubsRef.current) unsub();\n unsubsRef.current = [];\n };\n },\n [system, runWithTracking],\n );\n\n const getSnapshot = useCallback(() => {\n let effectiveValue: unknown;\n\n if (!system) {\n effectiveValue = defaultValueRef.current;\n } else {\n const { value: newValue } = runWithTracking();\n\n // When selector returns undefined and we have a default, use it\n effectiveValue =\n newValue === undefined && hasDefault\n ? defaultValueRef.current\n : newValue;\n }\n\n if (\n cachedValue.current !== UNINITIALIZED &&\n eqRef.current(cachedValue.current, effectiveValue)\n ) {\n return cachedValue.current;\n }\n cachedValue.current = effectiveValue;\n\n return effectiveValue;\n }, [runWithTracking, system, hasDefault]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// _useNamespacedSelectorImpl — internal namespaced useSelector\n// ============================================================================\n\n/\n Internal implementation for useSelector with NamespacedSystem.\n * Subscribes to all module namespaces and runs the selector against the system.\n * Uses equality comparison to prevent unnecessary re-renders.\n /\nfunction _useNamespacedSelectorImpl(\n // biome-ignore lint/suspicious/noExplicitAny: Internal impl\n system: NamespacedSystem<any>,\n // biome-ignore lint/suspicious/noExplicitAny: Internal impl\n selector: (state: any) => unknown,\n defaultValueArg?: unknown,\n equalityFnArg?: (a: unknown, b: unknown) => boolean,\n): unknown {\n const hasDefault = defaultValueArg !== undefined;\n const equalityFn = equalityFnArg ?? defaultEquality;\n\n const selectorRef = useRef(selector);\n const eqRef = useRef(equalityFn);\n const defaultValueRef = useRef(defaultValueArg);\n selectorRef.current = selector;\n eqRef.current = equalityFn;\n defaultValueRef.current = defaultValueArg;\n\n const cachedValue = useRef<unknown>(UNINITIALIZED);\n\n // Get all module namespace names for wildcard subscription\n const moduleNames = useMemo(() => Object.keys(system.facts), [system]);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n // Subscribe to all modules using wildcard keys\n const wildcardKeys = moduleNames.map((ns) => `${ns}.`);\n\n return system.subscribe(wildcardKeys, onStoreChange);\n },\n [system, moduleNames],\n );\n\n const getSnapshot = useCallback(() => {\n const newValue = selectorRef.current(system);\n const effectiveValue =\n newValue === undefined && hasDefault ? defaultValueRef.current : newValue;\n\n if (\n cachedValue.current !== UNINITIALIZED &&\n eqRef.current(cachedValue.current, effectiveValue)\n ) {\n return cachedValue.current;\n }\n\n cachedValue.current = effectiveValue;\n\n return effectiveValue;\n }, [system, hasDefault]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useDispatch\n// ============================================================================\n\nexport function useDispatch<S extends ModuleSchema>(\n system: SingleModuleSystem<S>,\n): (event: InferEvents<S>) => void {\n assertSystem(\"useDispatch\", system);\n return useCallback(\n (event: InferEvents<S>) => {\n system.dispatch(event);\n },\n [system],\n );\n}\n\n// ============================================================================\n// useWatch — derivation or fact side-effect (no re-render)\n// ============================================================================\n\n/** Watch a derivation or fact by key (auto-detected). When a key exists in both facts and derivations, the derivation overload takes priority. /\nexport function useWatch<\n S extends ModuleSchema,\n K extends keyof InferDerivations<S> & string,\n>(\n system: SingleModuleSystem<S>,\n key: K,\n callback: (\n newValue: InferDerivations<S>[K],\n prevValue: InferDerivations<S>[K] \| undefined,\n ) => void,\n): void;\n/* Watch a fact key with auto-detection. /\nexport function useWatch<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(\n system: SingleModuleSystem<S>,\n key: K,\n callback: (\n newValue: InferFacts<S>[K] \| undefined,\n prevValue: InferFacts<S>[K] \| undefined,\n ) => void,\n): void;\n\n/* Implementation /\nexport function useWatch(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n key: string,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation overload dispatch\n callback: (newValue: any, prevValue: any) => void,\n): void {\n assertSystem(\"useWatch\", system);\n\n const callbackRef = useRef(callback);\n callbackRef.current = callback;\n\n useEffect(() => {\n return system.watch(key, (newValue, prevValue) => {\n callbackRef.current(newValue, prevValue);\n });\n }, [system, key]);\n}\n\n// ============================================================================\n// useInspect — consolidated inspection hook\n// ============================================================================\n\n// InspectState is imported from ./shared.js and re-exported above\n\n/* Options for useInspect /\nexport interface UseInspectOptions {\n /* Throttle updates to this interval (ms). When set, uses useState instead of useSyncExternalStore. /\n throttleMs?: number;\n}\n\n/\n Hook to get consolidated system inspection data reactively.\n \n Merges isSettled, unmet/inflight requirements, and working state\n * into a single subscription. Optionally throttle updates.\n \n @example\n * ```tsx\n * const { isSettled, isWorking, hasUnmet } = useInspect(system);\n * const throttled = useInspect(system, { throttleMs: 200 });\n * ```\n /\nexport function useInspect(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n options?: UseInspectOptions,\n): InspectState {\n assertSystem(\"useInspect\", system);\n // Always call the sync version (useSyncExternalStore path) — no conditional hooks\n const syncState = _useInspectSync(system);\n\n const throttleMs = options?.throttleMs;\n const [deferredState, setDeferredState] = useState(syncState);\n const throttleRef = useRef<{\n throttled: (...args: unknown[]) => void;\n cleanup: () => void;\n } \| null>(null);\n\n // Create/recreate throttle when throttleMs changes\n useEffect(() => {\n if (!throttleMs \|\| throttleMs <= 0) {\n throttleRef.current?.cleanup();\n throttleRef.current = null;\n return;\n }\n // Clean up old throttle before creating new one\n throttleRef.current?.cleanup();\n throttleRef.current = createThrottle((...args: unknown[]) => {\n setDeferredState(args[0] as InspectState);\n }, throttleMs);\n return () => {\n throttleRef.current?.cleanup();\n throttleRef.current = null;\n };\n }, [throttleMs]);\n\n // Feed sync state through throttle after each render\n useEffect(() => {\n if (throttleRef.current) {\n throttleRef.current.throttled(syncState);\n }\n }, [syncState]);\n\n if (!throttleMs \|\| throttleMs <= 0) return syncState;\n return deferredState;\n}\n\nfunction _buildInspectState(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n): InspectState {\n return computeInspectState(system);\n}\n\nfunction _useInspectSync(\n // biome-ignore lint/suspicious/noExplicitAny: Internal\n system: SingleModuleSystem<any>,\n): InspectState {\n const cachedSnapshot = useRef<InspectState \| null>(null);\n const cachedUnmetIds = useRef<string[]>([]);\n const cachedInflightIds = useRef<string[]>([]);\n const cachedIsSettled = useRef<boolean \| null>(null);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const unsubFacts = system.facts.$store.subscribeAll(onStoreChange);\n const unsubSettled = system.onSettledChange(onStoreChange);\n return () => {\n unsubFacts();\n unsubSettled();\n };\n },\n [system],\n );\n\n const getSnapshot = useCallback(() => {\n const state = _buildInspectState(system);\n\n const unmetSame =\n state.unmet.length === cachedUnmetIds.current.length &&\n state.unmet.every((u, i) => u.id === cachedUnmetIds.current[i]);\n const inflightSame =\n state.inflight.length === cachedInflightIds.current.length &&\n state.inflight.every((f, i) => f.id === cachedInflightIds.current[i]);\n const settledSame = state.isSettled === cachedIsSettled.current;\n\n if (unmetSame && inflightSame && settledSame && cachedSnapshot.current) {\n return cachedSnapshot.current;\n }\n\n cachedSnapshot.current = state;\n cachedUnmetIds.current = state.unmet.map((u) => u.id);\n cachedInflightIds.current = state.inflight.map((f) => f.id);\n cachedIsSettled.current = state.isSettled;\n\n return state;\n }, [system]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useHistory — reactive history state\n// ============================================================================\n\n/\n Reactive history hook. Returns null when history is disabled.\n * Re-renders when snapshots are taken or navigation occurs.\n \n @example\n * ```tsx\n * const history = useHistory(system);\n * if (history) {\n * return (\n * <div>\n * <button disabled={!history.canGoBack} onClick={() => history.goBack()}>Undo</button>\n * <button disabled={!history.canGoForward} onClick={() => history.goForward()}>Redo</button>\n * <span>{history.currentIndex + 1} / {history.totalSnapshots}</span>\n * </div>\n * );\n * }\n * ```\n /\nexport function useHistory(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n): HistoryState \| null {\n assertSystem(\"useHistory\", system);\n const cachedRef = useRef<HistoryState \| null>(null);\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => system.onHistoryChange(onStoreChange),\n [system],\n );\n\n const getSnapshot = useCallback(() => {\n const state = buildHistoryState(system);\n if (!state) return null;\n\n // Return stable reference when values haven't changed\n if (\n cachedRef.current &&\n cachedRef.current.canGoBack === state.canGoBack &&\n cachedRef.current.canGoForward === state.canGoForward &&\n cachedRef.current.currentIndex === state.currentIndex &&\n cachedRef.current.totalSnapshots === state.totalSnapshots &&\n cachedRef.current.isPaused === state.isPaused\n ) {\n return cachedRef.current;\n }\n\n cachedRef.current = state;\n return cachedRef.current;\n }, [system]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useRequirementStatus — single or multi\n// ============================================================================\n\n/* Single type overload /\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus;\n\n/* Multi-type overload /\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus>;\n\n/* Implementation /\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n typeOrTypes: string \| string[],\n): RequirementTypeStatus \| Record<string, RequirementTypeStatus> {\n if (Array.isArray(typeOrTypes)) {\n return _useRequirementStatusMulti(statusPlugin, typeOrTypes);\n }\n return _useRequirementStatusSingle(statusPlugin, typeOrTypes);\n}\n\nfunction _useRequirementStatusSingle(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus {\n const cachedRef = useRef<RequirementTypeStatus \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return statusPlugin.subscribe(onStoreChange);\n },\n [statusPlugin],\n );\n\n const getSnapshot = useCallback(() => {\n const status = statusPlugin.getStatus(type);\n\n if (cachedRef.current !== UNINITIALIZED) {\n const prev = cachedRef.current;\n if (\n prev.pending === status.pending &&\n prev.inflight === status.inflight &&\n prev.failed === status.failed &&\n prev.isLoading === status.isLoading &&\n prev.hasError === status.hasError &&\n prev.lastError === status.lastError\n ) {\n return cachedRef.current;\n }\n }\n\n cachedRef.current = status;\n return status;\n }, [statusPlugin, type]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction _useRequirementStatusMulti(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus> {\n const cachedRef = useRef<Record<string, RequirementTypeStatus> \| null>(null);\n const cachedKey = useRef<string>(\"\");\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n return statusPlugin.subscribe(onStoreChange);\n },\n [statusPlugin],\n );\n\n const getSnapshot = useCallback(() => {\n const result: Record<string, RequirementTypeStatus> = {};\n const parts: string[] = [];\n for (const type of types) {\n const status = statusPlugin.getStatus(type);\n result[type] = status;\n parts.push(\n `${type}:${status.pending}:${status.inflight}:${status.failed}:${status.hasError}:${status.lastError?.message ?? \"\"}`,\n );\n }\n const key = parts.join(\"\|\");\n\n if (key !== cachedKey.current) {\n cachedKey.current = key;\n cachedRef.current = result;\n }\n\n return cachedRef.current ?? result;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [statusPlugin, ...types]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useSuspenseRequirement — single or multi\n// ============================================================================\n\n// Cache for pending promises, scoped per statusPlugin to prevent cross-system leaks.\nconst suspenseCacheMap = new WeakMap<\n StatusPlugin,\n Map<string, Promise<void>>\n>();\n\nfunction getSuspenseCache(plugin: StatusPlugin): Map<string, Promise<void>> {\n let cache = suspenseCacheMap.get(plugin);\n if (!cache) {\n cache = new Map();\n suspenseCacheMap.set(plugin, cache);\n }\n return cache;\n}\n\n/* Single type overload /\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus;\n\n/* Multi-type overload /\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus>;\n\n/* Implementation /\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n typeOrTypes: string \| string[],\n): RequirementTypeStatus \| Record<string, RequirementTypeStatus> {\n if (Array.isArray(typeOrTypes)) {\n return _useSuspenseRequirementMulti(statusPlugin, typeOrTypes);\n }\n return _useSuspenseRequirementSingle(statusPlugin, typeOrTypes);\n}\n\nfunction _useSuspenseRequirementSingle(\n statusPlugin: StatusPlugin,\n type: string,\n): RequirementTypeStatus {\n const status = statusPlugin.getStatus(type);\n\n if (status.hasError && status.lastError) {\n throw status.lastError;\n }\n\n if (status.isLoading) {\n const cache = getSuspenseCache(statusPlugin);\n let promise = cache.get(type);\n\n if (!promise) {\n promise = new Promise<void>((resolve) => {\n const unsubscribe = statusPlugin.subscribe(() => {\n const currentStatus = statusPlugin.getStatus(type);\n if (!currentStatus.isLoading) {\n cache.delete(type);\n unsubscribe();\n resolve();\n }\n });\n });\n cache.set(type, promise);\n }\n\n throw promise;\n }\n\n return status;\n}\n\nfunction _useSuspenseRequirementMulti(\n statusPlugin: StatusPlugin,\n types: string[],\n): Record<string, RequirementTypeStatus> {\n const result: Record<string, RequirementTypeStatus> = {};\n let hasLoading = false;\n let firstError: Error \| null = null;\n\n for (const type of types) {\n const status = statusPlugin.getStatus(type);\n result[type] = status;\n\n if (status.hasError && status.lastError && !firstError) {\n firstError = status.lastError;\n }\n if (status.isLoading) {\n hasLoading = true;\n }\n }\n\n if (firstError) {\n throw firstError;\n }\n\n if (hasLoading) {\n const cache = getSuspenseCache(statusPlugin);\n const cacheKey = types.slice().sort().join(\",\");\n let promise = cache.get(cacheKey);\n\n if (!promise) {\n promise = new Promise<void>((resolve) => {\n const unsubscribe = statusPlugin.subscribe(() => {\n const allDone = types.every(\n (t) => !statusPlugin.getStatus(t).isLoading,\n );\n if (allDone) {\n cache.delete(cacheKey);\n unsubscribe();\n resolve();\n }\n });\n });\n cache.set(cacheKey, promise);\n }\n\n throw promise;\n }\n\n return result;\n}\n\n// ============================================================================\n// useDirectiveRef — scoped system lifecycle\n// ============================================================================\n\n/* Base options for creating a scoped system /\ninterface DirectiveRefBaseConfig {\n // biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n plugins?: Plugin<any>[];\n history?: HistoryOption;\n trace?: TraceOption;\n errorBoundary?: ErrorBoundaryConfig;\n tickMs?: number;\n zeroConfig?: boolean;\n // biome-ignore lint/suspicious/noExplicitAny: Facts type varies\n initialFacts?: Record<string, any>;\n}\n\n/* Options for useDirectiveRef: module directly, or config object /\nexport type UseDirectiveRefOptions<M extends ModuleSchema> =\n \| ModuleDef<M>\n \| (DirectiveRefBaseConfig & { module: ModuleDef<M> });\n\n/* Options for useDirectiveRef with namespaced modules /\nexport type UseDirectiveRefNamespacedOptions<Modules extends ModulesMap> =\n DirectiveRefBaseConfig & { modules: { [K in keyof Modules]: Modules[K] } };\n\n// --- Single-module overloads ---\n\n/* Without status (no config): returns system directly /\nexport function useDirectiveRef<M extends ModuleSchema>(\n options: UseDirectiveRefOptions<M>,\n): SingleModuleSystem<M>;\n\n/* Without status (with config): returns system directly /\nexport function useDirectiveRef<M extends ModuleSchema>(\n options: UseDirectiveRefOptions<M>,\n config: DirectiveRefBaseConfig,\n): SingleModuleSystem<M>;\n\n/* With status: returns { system, statusPlugin } /\nexport function useDirectiveRef<M extends ModuleSchema>(\n options: UseDirectiveRefOptions<M>,\n config: { status: true } & DirectiveRefBaseConfig,\n): { system: SingleModuleSystem<M>; statusPlugin: StatusPlugin };\n\n// --- Namespaced (multi-module) overloads ---\n\n/* Namespaced: returns NamespacedSystem directly /\nexport function useDirectiveRef<const Modules extends ModulesMap>(\n options: UseDirectiveRefNamespacedOptions<Modules>,\n): NamespacedSystem<Modules>;\n\n/* Namespaced with config: returns NamespacedSystem directly /\nexport function useDirectiveRef<const Modules extends ModulesMap>(\n options: UseDirectiveRefNamespacedOptions<Modules>,\n config: DirectiveRefBaseConfig,\n): NamespacedSystem<Modules>;\n\n/* Implementation /\nexport function useDirectiveRef(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature handles both modes\n options: any,\n config?: { status?: boolean } & DirectiveRefBaseConfig,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation return varies by overload\n): any {\n // biome-ignore lint/suspicious/noExplicitAny: System ref holds either system type\n const systemRef = useRef<any>(null);\n const statusPluginRef = useRef<StatusPlugin \| null>(null);\n // Factory ref for strict mode re-creation (effects unmount then re-mount)\n // biome-ignore lint/suspicious/noExplicitAny: Factory return type varies\n const factoryRef = useRef<(() => any) \| null>(null);\n const wantStatus = config?.status === true;\n const isNamespaced = \"modules\" in options;\n\n if (!systemRef.current) {\n // Build a factory that creates + starts the system.\n // Called once during render and again on strict-mode re-mount.\n factoryRef.current = () => {\n if (isNamespaced) {\n // --- Namespaced mode: { modules: { ... } } ---\n const { modules, ...rest } = options;\n const plugins = config?.plugins ?? rest.plugins ?? [];\n const history = config?.history ?? rest.history;\n const trace = config?.trace ?? rest.trace;\n const errorBoundary = config?.errorBoundary ?? rest.errorBoundary;\n const tickMs = config?.tickMs ?? rest.tickMs;\n const zeroConfig = config?.zeroConfig ?? rest.zeroConfig;\n const initialFacts = config?.initialFacts ?? rest.initialFacts;\n\n const sys = createSystem({\n modules,\n plugins: plugins.length > 0 ? plugins : undefined,\n history,\n trace,\n errorBoundary,\n tickMs,\n zeroConfig,\n initialFacts,\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n } as any);\n // Always initialize facts/derivations (safe for SSR).\n // Only start reconciliation on the client.\n sys.initialize();\n if (typeof window !== \"undefined\") {\n sys.start();\n }\n\n return sys;\n }\n\n // --- Single-module mode ---\n const isModule = \"id\" in options && \"schema\" in options;\n const mod = isModule ? options : options.module;\n const baseOpts = isModule ? {} : (options as DirectiveRefBaseConfig);\n const plugins = config?.plugins ?? baseOpts.plugins ?? [];\n const history = config?.history ?? baseOpts.history;\n const trace = config?.trace ?? baseOpts.trace;\n const errorBoundary = config?.errorBoundary ?? baseOpts.errorBoundary;\n const tickMs = config?.tickMs ?? baseOpts.tickMs;\n const zeroConfig = config?.zeroConfig ?? baseOpts.zeroConfig;\n const initialFacts = config?.initialFacts ?? baseOpts.initialFacts;\n\n let allPlugins = [...plugins];\n\n if (wantStatus) {\n statusPluginRef.current = createRequirementStatusPlugin();\n // biome-ignore lint/suspicious/noExplicitAny: Plugin generic issues\n allPlugins = [\n ...allPlugins,\n statusPluginRef.current.plugin as Plugin<any>,\n ];\n }\n\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n const sys = createSystem({\n module: mod,\n plugins: allPlugins.length > 0 ? allPlugins : undefined,\n history,\n trace,\n errorBoundary,\n tickMs,\n zeroConfig,\n initialFacts,\n } as any);\n // Always initialize facts/derivations (safe for SSR).\n // Only start reconciliation on the client.\n sys.initialize();\n if (typeof window !== \"undefined\") {\n sys.start();\n }\n\n return sys;\n };\n\n // Start synchronously so facts are initialized before the first render\n systemRef.current = factoryRef.current();\n }\n\n useEffect(() => {\n // Strict mode re-mount: system was destroyed in cleanup, recreate it\n if (!systemRef.current && factoryRef.current) {\n systemRef.current = factoryRef.current();\n }\n\n return () => {\n systemRef.current?.destroy();\n systemRef.current = null;\n statusPluginRef.current = null;\n };\n }, []);\n\n if (wantStatus && !isNamespaced) {\n return {\n system: systemRef.current!,\n statusPlugin: statusPluginRef.current!,\n };\n }\n\n return systemRef.current!;\n}\n\n// ============================================================================\n// useNamespacedSelector — select from a NamespacedSystem with useSyncExternalStore\n// ============================================================================\n\n/\n React hook to select derived values from a NamespacedSystem.\n * Uses useSyncExternalStore for tear-free reads.\n \n @param system - The namespaced system to read from\n * @param keys - Namespaced keys to subscribe to (e.g., [\"auth.token\", \"data.count\"])\n * @param selector - Function that reads from system.facts / system.derive\n \n @example\n * ```tsx\n * const system = useDirectiveRef({ modules: { auth, data } });\n * const token = useNamespacedSelector(system, [\"auth.token\"], (s) => s.facts.auth.token);\n * const count = useNamespacedSelector(system, [\"data.\"], (s) => s.derive.data.total);\n ```\n /\nexport function useNamespacedSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n keys: string[],\n selector: (system: NamespacedSystem<Modules>) => R,\n): R {\n const keysRef = useRef(keys);\n keysRef.current = keys;\n const selectorRef = useRef(selector);\n selectorRef.current = selector;\n\n const subscribe = useCallback(\n (onStoreChange: () => void) =>\n system.subscribe(keysRef.current, onStoreChange),\n [system],\n );\n\n const getSnapshot = useCallback(() => selectorRef.current(system), [system]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useDirective — scoped system with selected values in containers\n// ============================================================================\n\n/* Options for useDirective hook /\nexport interface UseDirectiveOptions<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string = never,\n DK extends keyof InferDerivations<S> & string = never,\n> extends DirectiveRefBaseConfig {\n /* Fact keys to subscribe to /\n facts?: FK[];\n /* Derivation keys to subscribe to /\n derived?: DK[];\n /* Enable status plugin /\n status?: boolean;\n}\n\n/* Return type for useDirective hook (without status) /\nexport type UseDirectiveReturn<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string,\n DK extends keyof InferDerivations<S> & string,\n> = {\n system: SingleModuleSystem<S>;\n dispatch: (event: InferEvents<S>) => void;\n events: SingleModuleSystem<S>[\"events\"];\n facts: Pick<InferFacts<S>, FK>;\n derived: Pick<InferDerivations<S>, DK>;\n};\n\n/* Return type for useDirective hook (with status) /\nexport type UseDirectiveReturnWithStatus<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string,\n DK extends keyof InferDerivations<S> & string,\n> = UseDirectiveReturn<S, FK, DK> & {\n statusPlugin: StatusPlugin;\n};\n\n/\n Convenience hook that creates a scoped system and reads selected facts/derivations\n * into container objects. When no `facts` or `derived` keys are specified, subscribes\n * to ALL facts and derivations (replacing the former `useModule` hook).\n \n @example\n * ```tsx\n * // Selective subscription\n * const { dispatch, facts: { count }, derived: { doubled } } = useDirective(counterModule, {\n * facts: [\"count\"],\n * derived: [\"doubled\"],\n * });\n \n // Subscribe to everything (no keys = all facts + all derivations)\n * const { facts, derived, events, dispatch } = useDirective(counterModule);\n * ```\n /\nexport function useDirective<\n S extends ModuleSchema,\n FK extends keyof InferFacts<S> & string = never,\n DK extends keyof InferDerivations<S> & string = never,\n>(\n moduleOrOptions: UseDirectiveRefOptions<S>,\n selections: UseDirectiveOptions<S, FK, DK> = {} as UseDirectiveOptions<\n S,\n FK,\n DK\n >,\n): UseDirectiveReturn<S, FK, DK> \| UseDirectiveReturnWithStatus<S, FK, DK> {\n const {\n facts: factKeysOpt,\n derived: derivedKeysOpt,\n status,\n ...configRest\n } = selections;\n const factKeys = (factKeysOpt ?? []) as FK[];\n const derivedKeys = (derivedKeysOpt ?? []) as DK[];\n\n // When no keys are specified, subscribe to everything\n const subscribeAll = factKeys.length === 0 && derivedKeys.length === 0;\n\n // Create system via useDirectiveRef (handles lifecycle)\n // biome-ignore lint/suspicious/noExplicitAny: Conditional overload dispatch\n const refResult: any = status\n ? useDirectiveRef(moduleOrOptions, { status: true as const, ...configRest })\n : useDirectiveRef(moduleOrOptions, configRest);\n\n const system: SingleModuleSystem<S> = status ? refResult.system : refResult;\n\n const statusPlugin = status\n ? (\n refResult as {\n system: SingleModuleSystem<S>;\n statusPlugin: StatusPlugin;\n }\n ).statusPlugin\n : undefined;\n\n // For subscribe-all mode, get all derivation keys\n const allDerivationKeys = useMemo(\n () => (subscribeAll ? Object.keys(system.derive) : []),\n [system, subscribeAll],\n );\n\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const unsubs: Array<() => void> = [];\n if (subscribeAll) {\n // Subscribe to ALL facts and ALL derivations\n unsubs.push(system.facts.$store.subscribeAll(onStoreChange));\n if (allDerivationKeys.length > 0) {\n unsubs.push(system.subscribe(allDerivationKeys, onStoreChange));\n }\n } else {\n if (factKeys.length > 0) {\n unsubs.push(system.facts.$store.subscribe(factKeys, onStoreChange));\n }\n if (derivedKeys.length > 0) {\n unsubs.push(system.subscribe(derivedKeys, onStoreChange));\n }\n }\n return () => {\n for (const unsub of unsubs) unsub();\n };\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [system, subscribeAll, ...factKeys, ...derivedKeys, ...allDerivationKeys],\n );\n\n const cachedFacts = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n const cachedDerived = useRef<Record<string, unknown> \| typeof UNINITIALIZED>(\n UNINITIALIZED,\n );\n const cachedWrapper = useRef<{\n facts: Record<string, unknown>;\n derived: Record<string, unknown>;\n } \| null>(null);\n\n const getSnapshot = useCallback(() => {\n let factsResult: Record<string, unknown>;\n let derivedResult: Record<string, unknown>;\n let effectiveFactKeys: readonly string[];\n let effectiveDerivedKeys: readonly string[];\n\n if (subscribeAll) {\n // Read ALL facts and ALL derivations\n factsResult = system.facts.$store.toObject();\n effectiveFactKeys = Object.keys(factsResult);\n derivedResult = {};\n for (const key of allDerivationKeys) {\n derivedResult[key] = system.read(key);\n }\n effectiveDerivedKeys = allDerivationKeys;\n } else {\n // Read selected keys only\n factsResult = {};\n for (const key of factKeys) {\n // biome-ignore lint/suspicious/noExplicitAny: Dynamic fact access\n factsResult[key] = (system.facts as any)[key];\n }\n effectiveFactKeys = factKeys;\n derivedResult = {};\n for (const key of derivedKeys) {\n derivedResult[key] = system.read(key);\n }\n effectiveDerivedKeys = derivedKeys;\n }\n\n // Check facts stability\n let factsSame = cachedFacts.current !== UNINITIALIZED;\n if (factsSame) {\n const prev = cachedFacts.current as Record<string, unknown>;\n const prevKeys = Object.keys(prev);\n if (prevKeys.length !== effectiveFactKeys.length) {\n factsSame = false;\n } else {\n for (const key of effectiveFactKeys) {\n if (!Object.is(prev[key], factsResult[key])) {\n factsSame = false;\n break;\n }\n }\n }\n }\n\n // Check derived stability\n let derivedSame = cachedDerived.current !== UNINITIALIZED;\n if (derivedSame) {\n const prev = cachedDerived.current as Record<string, unknown>;\n const prevKeys = Object.keys(prev);\n if (prevKeys.length !== effectiveDerivedKeys.length) {\n derivedSame = false;\n } else {\n for (const key of effectiveDerivedKeys) {\n if (!Object.is(prev[key], derivedResult[key])) {\n derivedSame = false;\n break;\n }\n }\n }\n }\n\n const stableFacts = factsSame\n ? (cachedFacts.current as Record<string, unknown>)\n : factsResult;\n const stableDerived = derivedSame\n ? (cachedDerived.current as Record<string, unknown>)\n : derivedResult;\n\n if (!factsSame) cachedFacts.current = factsResult;\n if (!derivedSame) cachedDerived.current = derivedResult;\n\n // Return same wrapper reference when both containers are unchanged\n if (factsSame && derivedSame && cachedWrapper.current) {\n return cachedWrapper.current;\n }\n\n cachedWrapper.current = { facts: stableFacts, derived: stableDerived };\n return cachedWrapper.current;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, subscribeAll, ...factKeys, ...derivedKeys, ...allDerivationKeys]);\n\n const values = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n const dispatch = useCallback(\n (event: InferEvents<S>) => system.dispatch(event),\n [system],\n );\n\n const events = useEvents(system);\n\n const base = {\n system,\n dispatch,\n events,\n facts: values.facts as Pick<InferFacts<S>, FK>,\n derived: values.derived as Pick<InferDerivations<S>, DK>,\n };\n\n if (status && statusPlugin) {\n return { ...base, statusPlugin } as UseDirectiveReturnWithStatus<S, FK, DK>;\n }\n\n return base as UseDirectiveReturn<S, FK, DK>;\n}\n\n// ============================================================================\n// useEvents — memoized events reference\n// ============================================================================\n\n/\n Returns the system's events dispatcher. Provides autocomplete for event names\n * and avoids needing useCallback wrappers for event dispatch.\n \n @example\n * ```tsx\n * const events = useEvents(system);\n * <button onClick={() => events.increment()}>+</button>\n * ```\n /\nexport function useEvents<S extends ModuleSchema>(\n system: SingleModuleSystem<S>,\n): SingleModuleSystem<S>[\"events\"] {\n assertSystem(\"useEvents\", system);\n return useMemo(() => system.events, [system]);\n}\n\n// ============================================================================\n// useExplain — reactive requirement explanation\n// ============================================================================\n\n/\n Reactively returns the explanation string for a requirement.\n * Updates whenever system state changes.\n \n @example\n * ```tsx\n * const explanation = useExplain(system, \"req-123\");\n * if (explanation) <pre>{explanation}</pre>;\n * ```\n /\nexport function useExplain(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n requirementId: string,\n): string \| null {\n assertSystem(\"useExplain\", system);\n const subscribe = useCallback(\n (onStoreChange: () => void) => {\n const unsubFacts = system.facts.$store.subscribeAll(onStoreChange);\n const unsubSettled = system.onSettledChange(onStoreChange);\n return () => {\n unsubFacts();\n unsubSettled();\n };\n },\n [system],\n );\n\n const getSnapshot = useCallback(() => {\n return system.explain(requirementId);\n }, [system, requirementId]);\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n// ============================================================================\n// useConstraintStatus — reactive constraint inspection\n// ============================================================================\n\n// ConstraintInfo is imported from ./shared.js and re-exported above\n\n/* Get all constraints /\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n): ConstraintInfo[];\n/* Get a single constraint by ID /\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n constraintId: string,\n): ConstraintInfo \| null;\n/* Implementation /\nexport function useConstraintStatus(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n constraintId?: string,\n): ConstraintInfo[] \| ConstraintInfo \| null {\n assertSystem(\"useConstraintStatus\", system);\n const inspectState = useInspect(system);\n\n return useMemo(() => {\n const inspection = system.inspect();\n if (!constraintId) return inspection.constraints;\n return inspection.constraints.find((c) => c.id === constraintId) ?? null;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [system, constraintId, inspectState]);\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\n/* Result of useOptimisticUpdate /\nexport interface OptimisticUpdateResult {\n /* Apply an optimistic update (saves snapshot, then runs updateFn in batch) /\n mutate: (updateFn: () => void) => void;\n /* Whether a resolver is currently processing the optimistic change /\n isPending: boolean;\n /* Error if the resolver failed /\n error: Error \| null;\n /* Manually rollback to the pre-mutation snapshot /\n rollback: () => void;\n}\n\n/\n Optimistic update hook. Saves a snapshot before mutating, monitors\n * a requirement type via statusPlugin, and rolls back on failure.\n \n @example\n * ```tsx\n * const { mutate, isPending, error, rollback } = useOptimisticUpdate(\n * system, statusPlugin, \"SAVE_ITEM\"\n * );\n * mutate(() => { system.facts.items = [...system.facts.items, newItem]; });\n * ```\n /\nexport function useOptimisticUpdate(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n statusPlugin?: StatusPlugin,\n requirementType?: string,\n): OptimisticUpdateResult {\n assertSystem(\"useOptimisticUpdate\", system);\n const [isPending, setIsPending] = useState(false);\n const [error, setError] = useState<Error \| null>(null);\n const snapshotRef = useRef<SystemSnapshot \| null>(null);\n\n const rollback = useCallback(() => {\n if (snapshotRef.current) {\n system.restore(snapshotRef.current);\n snapshotRef.current = null;\n }\n setIsPending(false);\n setError(null);\n }, [system]);\n\n const mutate = useCallback(\n (updateFn: () => void) => {\n snapshotRef.current = system.getSnapshot();\n setIsPending(true);\n setError(null);\n system.batch(updateFn);\n },\n [system],\n );\n\n // Watch for resolver completion/failure\n useEffect(() => {\n if (!statusPlugin \|\| !requirementType \|\| !isPending) return;\n\n return statusPlugin.subscribe(() => {\n const status = statusPlugin.getStatus(requirementType);\n if (!status.isLoading && !status.hasError) {\n // Resolved successfully — keep optimistic state\n snapshotRef.current = null;\n setIsPending(false);\n } else if (status.hasError) {\n // Failed — rollback\n setError(status.lastError);\n rollback();\n }\n });\n }, [statusPlugin, requirementType, isPending, rollback]);\n\n return { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// DirectiveHydrator + useHydratedSystem — SSR/RSC hydration\n// ============================================================================\n\n/* Props for DirectiveHydrator component /\nexport interface HydratorProps {\n snapshot: DistributableSnapshot;\n children: ReactNode;\n}\n\n/* Context for hydrated snapshot /\nconst HydrationContext = createContext<DistributableSnapshot \| null>(null);\n\n/\n SSR/RSC hydration component. Wraps children with a snapshot context\n * that `useHydratedSystem` can consume on the client.\n \n @example\n * ```tsx\n * // Server component\n * <DirectiveHydrator snapshot={serverSnapshot}>\n * <ClientApp />\n * </DirectiveHydrator>\n * ```\n /\nexport function DirectiveHydrator({ snapshot, children }: HydratorProps) {\n return (\n <HydrationContext.Provider value={snapshot}>\n {children}\n </HydrationContext.Provider>\n );\n}\n\n/\n Client-side hook that creates a system hydrated from a server snapshot.\n * Must be used inside a `<DirectiveHydrator>`.\n \n @example\n * ```tsx\n * function ClientApp() {\n * const system = useHydratedSystem(counterModule);\n * const count = useFact(system, \"count\");\n * return <div>{count}</div>;\n * }\n * ```\n */\nexport function useHydratedSystem<S extends ModuleSchema>(\n moduleDef: ModuleDef<S>,\n config?: DirectiveRefBaseConfig,\n): SingleModuleSystem<S> {\n const snapshot = useContext(HydrationContext);\n\n // Merge snapshot data as initial facts if available\n const mergedConfig = useMemo(() => {\n if (!snapshot?.data) return config ?? {};\n return {\n ...(config ?? {}),\n initialFacts: {\n ...(config?.initialFacts ?? {}),\n ...snapshot.data,\n },\n };\n }, [snapshot, config]);\n\n return useDirectiveRef(moduleDef, mergedConfig) as SingleModuleSystem<S>;\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@directive-run/react",
-  "version": "0.5.0",
+  "version": "0.8.0",
   "description": "React hooks and components for Directive.",
   "license": "MIT",
   "author": "Jason Comes",
@@ -50,13 +50,14 @@
   "devDependencies": {
     "@testing-library/react": "^16.3.2",
     "@types/node": "^25.2.0",
-    "@types/react": "^18.3.3",
+    "@types/react": "^19.1.2",
+    "@types/react-dom": "^19.1.2",
     "happy-dom": "^20.8.3",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
-    "@directive-run/core": "0.5.0"
+    "@directive-run/core": "0.8.0"
   },
   "scripts": {
     "build": "tsup",