@directive-run/solid 0.8.2 → 0.8.3

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.
package/LICENSE CHANGED
@@ -2,6 +2,11 @@ MIT License
2
2
 
3
3
  Copyright (c) 2026 Sizls LLC
4
4
 
5
+ This project is dual-licensed under MIT OR Apache-2.0. You may choose
6
+ either license. See LICENSE-APACHE for the Apache License, Version 2.0.
7
+
8
+ ---
9
+
5
10
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
11
  of this software and associated documentation files (the "Software"), to deal
7
12
  in the Software without restriction, including without limitation the rights
package/dist/index.cjs CHANGED
@@ -1,2 +1,2 @@
1
- 'use strict';var core=require('@directive-run/core'),adapterUtils=require('@directive-run/core/adapter-utils'),solidJs=require('solid-js');function C(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)?V(e,t):T(e,t)}function T(e,t){process.env.NODE_ENV!=="production"&&(e.facts.$store.has(t)||console.warn(`[Directive] useFact("${t}") \u2014 fact not found in store. Check that "${t}" is defined in your module's schema.`));let[s,r]=solidJs.createSignal(e.facts.$store.get(t)),n=e.facts.$store.subscribe([t],()=>{r(()=>e.facts.$store.get(t));});return solidJs.onCleanup(n),s}function V(e,t){let s=()=>{let u={};for(let i of t)u[i]=e.facts.$store.get(i);return u},[r,n]=solidJs.createSignal(s()),o=e.facts.$store.subscribe(t,()=>{n(s);});return solidJs.onCleanup(o),r}function q(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)?P(e,t):$(e,t)}function $(e,t){process.env.NODE_ENV!=="production"&&e.read(t)===void 0&&console.warn(`[Directive] useDerived("${t}") returned undefined. Check that "${t}" is defined in your module's derive property.`);let[s,r]=solidJs.createSignal(e.read(t)),n=e.subscribe([t],()=>{r(()=>e.read(t));});return solidJs.onCleanup(n),s}function P(e,t){let s=()=>{let u={};for(let i of t)u[i]=e.read(i);return u},[r,n]=solidJs.createSignal(s()),o=e.subscribe(t,()=>{n(s);});return solidJs.onCleanup(o),r}function z(e,t,s=adapterUtils.defaultEquality){adapterUtils.assertSystem("useSelector",e);let r=new Set(Object.keys(e.derive??{})),n=()=>adapterUtils.runTrackedSelector(e,r,t),o=n(),u=o.factKeys,i=o.deriveKeys,[c,f]=solidJs.createSignal(o.value),d=[],y=()=>{for(let p of d)p();d.length=0;let S=()=>{let p=n();f(b=>s(b,p.value)?b:p.value),adapterUtils.depsChanged(u,p.factKeys,i,p.deriveKeys)&&(u=p.factKeys,i=p.deriveKeys,y());};u.length>0?d.push(e.facts.$store.subscribe(u,S)):i.length===0&&d.push(e.facts.$store.subscribeAll(S)),i.length>0&&d.push(e.subscribe(i,S));};return y(),solidJs.onCleanup(()=>{for(let S of d)S();}),c}function L(e){return adapterUtils.assertSystem("useDispatch",e),t=>{e.dispatch(t);}}function N(e){return adapterUtils.assertSystem("useEvents",e),e.events}function U(e,t,s){adapterUtils.assertSystem("useWatch",e);let r=e.watch(t,s);solidJs.onCleanup(r);}function O(e,t){adapterUtils.assertSystem("useInspect",e);let[s,r]=solidJs.createSignal(adapterUtils.computeInspectState(e)),n=()=>{r(adapterUtils.computeInspectState(e));};if(t?.throttleMs&&t.throttleMs>0){let{throttled:o,cleanup:u}=adapterUtils.createThrottle(n,t.throttleMs),i=e.facts.$store.subscribeAll(o),c=e.onSettledChange(o);solidJs.onCleanup(()=>{u(),i(),c();});}else {let o=e.facts.$store.subscribeAll(n),u=e.onSettledChange(n);solidJs.onCleanup(()=>{o(),u();});}return s}function k(e,t){if(Array.isArray(t)){let o=()=>{let f={};for(let d of t)f[d]=e.getStatus(d);return f},[u,i]=solidJs.createSignal(o()),c=e.subscribe(()=>{i(o);});return solidJs.onCleanup(c),u}let[s,r]=solidJs.createSignal(e.getStatus(t)),n=e.subscribe(()=>{r(e.getStatus(t));});return solidJs.onCleanup(n),s}function G(e,t){adapterUtils.assertSystem("useExplain",e);let[s,r]=solidJs.createSignal(e.explain(t)),n=()=>r(e.explain(t)),o=e.facts.$store.subscribeAll(n),u=e.onSettledChange(n);return solidJs.onCleanup(()=>{o(),u();}),s}function J(e,t){adapterUtils.assertSystem("useConstraintStatus",e);let s=()=>{let c=e.inspect();return t?c.constraints.find(f=>f.id===t)??null:c.constraints},[r,n]=solidJs.createSignal(s()),o=()=>n(s),u=e.facts.$store.subscribeAll(o),i=e.onSettledChange(o);return solidJs.onCleanup(()=>{u(),i();}),r}function Q(e,t,s){adapterUtils.assertSystem("useOptimisticUpdate",e);let[r,n]=solidJs.createSignal(false),[o,u]=solidJs.createSignal(null),i=null,c=null,f=()=>{i&&(e.restore(i),i=null),n(false),u(null),c?.(),c=null;},d=y=>{i=e.getSnapshot(),n(true),u(null),e.batch(y),t&&s&&(c?.(),c=t.subscribe(()=>{let S=t.getStatus(s);!S.isLoading&&!S.hasError?(i=null,n(false),c?.(),c=null):S.hasError&&(u(()=>S.lastError),f());}));};return solidJs.onCleanup(()=>{c?.();}),{mutate:d,isPending:r,error:o,rollback:f}}function X(e,t){let s=Array.isArray(t)?t:[t],r=()=>s.some(n=>e.getStatus(n).isLoading);if(r())throw new Promise(n=>{let o=e.subscribe(()=>{r()||(o(),n());});});return k(e,t)}function Y(e){adapterUtils.assertSystem("useHistory",e);let[t,s]=solidJs.createSignal(adapterUtils.buildHistoryState(e)),r=e.onHistoryChange(()=>s(adapterUtils.buildHistoryState(e)));return solidJs.onCleanup(r),t}function Z(e,t){let s=[...t?.plugins??[]],r;if(t?.status){let M=core.createRequirementStatusPlugin();r=M,s.push(M.plugin);}let n=core.createSystem({module:e,plugins:s.length>0?s:void 0,trace:t?.trace,errorBoundary:t?.errorBoundary,tickMs:t?.tickMs,zeroConfig:t?.zeroConfig,initialFacts:t?.initialFacts});n.start(),solidJs.onCleanup(()=>{n.destroy();});let o=t?.facts,u=t?.derived,i=!o&&!u,[c,f]=solidJs.createSignal(i?n.facts.$store.toObject():adapterUtils.pickFacts(n,o??[])),d=i?n.facts.$store.subscribeAll(()=>{f(()=>n.facts.$store.toObject());}):o&&o.length>0?n.facts.$store.subscribe(o,()=>{f(()=>adapterUtils.pickFacts(n,o));}):null,y=i?Object.keys(n.derive??{}):u??[],S=()=>{let M={};for(let v of y)M[v]=n.read(v);return M},[p,b]=solidJs.createSignal(S()),A=y.length>0?n.subscribe(y,()=>{b(S);}):null;solidJs.onCleanup(()=>{d?.(),A?.();});let R=n.events;return {system:n,facts:c,derived:p,events:R,dispatch:M=>n.dispatch(M),statusPlugin:r}}function ee(e,t){let[s,r]=solidJs.createSignal(e.read(t)),n=e.subscribe([t],()=>{r(()=>e.read(t));});return [s,n]}function te(e,t){let[s,r]=solidJs.createSignal(e.facts.$store.get(t)),n=e.facts.$store.subscribe([t],()=>{r(()=>e.facts.$store.get(t));});return [s,n]}function ne(){return {useFact:(e,t)=>C(e,t),useDerived:(e,t)=>q(e,t),useDispatch:e=>t=>{e.dispatch(t);},useEvents:e=>N(e),useWatch:(e,t,s)=>U(e,t,s)}}function se(e,t,s){let[r,n]=solidJs.createSignal(s(e)),o=e.subscribe(t,()=>{n(()=>s(e));});return solidJs.onCleanup(o),r}Object.defineProperty(exports,"shallowEqual",{enumerable:true,get:function(){return adapterUtils.shallowEqual}});exports.createDerivedSignal=ee;exports.createFactSignal=te;exports.createTypedHooks=ne;exports.useConstraintStatus=J;exports.useDerived=q;exports.useDirective=Z;exports.useDispatch=L;exports.useEvents=N;exports.useExplain=G;exports.useFact=C;exports.useHistory=Y;exports.useInspect=O;exports.useNamespacedSelector=se;exports.useOptimisticUpdate=Q;exports.useRequirementStatus=k;exports.useSelector=z;exports.useSuspenseRequirement=X;exports.useWatch=U;//# sourceMappingURL=index.cjs.map
1
+ 'use strict';var core=require('@directive-run/core'),adapterUtils=require('@directive-run/core/adapter-utils'),solidJs=require('solid-js');function C(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)?V(e,t):T(e,t)}function T(e,t){process.env.NODE_ENV!=="production"&&(e.facts.$store.has(t)||console.warn(`[Directive] useFact("${t}") \u2014 fact not found in store. Check that "${t}" is defined in your module's schema.`));let[s,r]=solidJs.createSignal(e.facts.$store.get(t)),n=e.facts.$store.subscribe([t],()=>{r(()=>e.facts.$store.get(t));});return solidJs.onCleanup(n),s}function V(e,t){let s=()=>{let u={};for(let i of t)u[i]=e.facts.$store.get(i);return u},[r,n]=solidJs.createSignal(s()),o=e.facts.$store.subscribe(t,()=>{n(s);});return solidJs.onCleanup(o),r}function q(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)?P(e,t):$(e,t)}function $(e,t){process.env.NODE_ENV!=="production"&&e.read(t)===void 0&&console.warn(`[Directive] useDerived("${t}") returned undefined. Check that "${t}" is defined in your module's derive property.`);let[s,r]=solidJs.createSignal(e.read(t)),n=e.subscribe([t],()=>{r(()=>e.read(t));});return solidJs.onCleanup(n),s}function P(e,t){let s=()=>{let u={};for(let i of t)u[i]=e.read(i);return u},[r,n]=solidJs.createSignal(s()),o=e.subscribe(t,()=>{n(s);});return solidJs.onCleanup(o),r}function z(e,t,s=adapterUtils.defaultEquality){adapterUtils.assertSystem("useSelector",e);let r=new Set(Object.keys(e.derive??{})),n=()=>adapterUtils.runTrackedSelector(e,r,t),o=n(),u=o.factKeys,i=o.deriveKeys,[c,f]=solidJs.createSignal(o.value),d=[],y=()=>{for(let p of d)p();d.length=0;let S=()=>{let p=n();f(b=>s(b,p.value)?b:p.value),adapterUtils.depsChanged(u,p.factKeys,i,p.deriveKeys)&&(u=p.factKeys,i=p.deriveKeys,y());};u.length>0?d.push(e.facts.$store.subscribe(u,S)):i.length===0&&d.push(e.facts.$store.subscribeAll(S)),i.length>0&&d.push(e.subscribe(i,S));};return y(),solidJs.onCleanup(()=>{for(let S of d)S();}),c}function L(e){return adapterUtils.assertSystem("useDispatch",e),t=>{e.dispatch(t);}}function N(e){return adapterUtils.assertSystem("useEvents",e),e.events}function U(e,t,s){adapterUtils.assertSystem("useWatch",e);let r=e.watch(t,s);solidJs.onCleanup(r);}function O(e,t){adapterUtils.assertSystem("useInspect",e);let[s,r]=solidJs.createSignal(adapterUtils.computeInspectState(e)),n=()=>{r(adapterUtils.computeInspectState(e));};if(t?.throttleMs&&t.throttleMs>0){let{throttled:o,cleanup:u}=adapterUtils.createThrottle(n,t.throttleMs),i=e.facts.$store.subscribeAll(o),c=e.onSettledChange(o);solidJs.onCleanup(()=>{u(),i(),c();});}else {let o=e.facts.$store.subscribeAll(n),u=e.onSettledChange(n);solidJs.onCleanup(()=>{o(),u();});}return s}function k(e,t){if(Array.isArray(t)){let o=()=>{let f={};for(let d of t)f[d]=e.getStatus(d);return f},[u,i]=solidJs.createSignal(o()),c=e.subscribe(()=>{i(o);});return solidJs.onCleanup(c),u}let[s,r]=solidJs.createSignal(e.getStatus(t)),n=e.subscribe(()=>{r(e.getStatus(t));});return solidJs.onCleanup(n),s}function Q(e,t){adapterUtils.assertSystem("useExplain",e);let[s,r]=solidJs.createSignal(e.explain(t)),n=()=>r(e.explain(t)),o=e.facts.$store.subscribeAll(n),u=e.onSettledChange(n);return solidJs.onCleanup(()=>{o(),u();}),s}function G(e,t){adapterUtils.assertSystem("useConstraintStatus",e);let s=()=>{let c=e.inspect();return t?c.constraints.find(f=>f.id===t)??null:c.constraints},[r,n]=solidJs.createSignal(s()),o=()=>n(s),u=e.facts.$store.subscribeAll(o),i=e.onSettledChange(o);return solidJs.onCleanup(()=>{u(),i();}),r}function J(e,t,s){adapterUtils.assertSystem("useOptimisticUpdate",e);let[r,n]=solidJs.createSignal(false),[o,u]=solidJs.createSignal(null),i=null,c=null,f=()=>{i&&(e.restore(i),i=null),n(false),u(null),c?.(),c=null;},d=y=>{i=e.getSnapshot(),n(true),u(null),e.batch(y),t&&s&&(c?.(),c=t.subscribe(()=>{let S=t.getStatus(s);!S.isLoading&&!S.hasError?(i=null,n(false),c?.(),c=null):S.hasError&&(u(()=>S.lastError),f());}));};return solidJs.onCleanup(()=>{c?.();}),{mutate:d,isPending:r,error:o,rollback:f}}function X(e,t){let s=Array.isArray(t)?t:[t],r=()=>s.some(n=>e.getStatus(n).isLoading);if(r())throw new Promise(n=>{let o=e.subscribe(()=>{r()||(o(),n());});});return k(e,t)}function Y(e){adapterUtils.assertSystem("useHistory",e);let[t,s]=solidJs.createSignal(adapterUtils.buildHistoryState(e)),r=e.onHistoryChange(()=>s(adapterUtils.buildHistoryState(e)));return solidJs.onCleanup(r),t}function Z(e,t){let s=[...t?.plugins??[]],r;if(t?.status){let M=core.createRequirementStatusPlugin();r=M,s.push(M.plugin);}let n=core.createSystem({module:e,plugins:s.length>0?s:void 0,trace:t?.trace,errorBoundary:t?.errorBoundary,tickMs:t?.tickMs,zeroConfig:t?.zeroConfig,initialFacts:t?.initialFacts});typeof window<"u"?n.start():n.initialize(),solidJs.onCleanup(()=>{n.destroy();});let o=t?.facts,u=t?.derived,i=!o&&!u,[c,f]=solidJs.createSignal(i?n.facts.$store.toObject():adapterUtils.pickFacts(n,o??[])),d=i?n.facts.$store.subscribeAll(()=>{f(()=>n.facts.$store.toObject());}):o&&o.length>0?n.facts.$store.subscribe(o,()=>{f(()=>adapterUtils.pickFacts(n,o));}):null,y=i?Object.keys(n.derive??{}):u??[],S=()=>{let M={};for(let v of y)M[v]=n.read(v);return M},[p,b]=solidJs.createSignal(S()),A=y.length>0?n.subscribe(y,()=>{b(S);}):null;solidJs.onCleanup(()=>{d?.(),A?.();});let R=n.events;return {system:n,facts:c,derived:p,events:R,dispatch:M=>n.dispatch(M),statusPlugin:r}}function ee(e,t){let[s,r]=solidJs.createSignal(e.read(t)),n=e.subscribe([t],()=>{r(()=>e.read(t));});return [s,n]}function te(e,t){let[s,r]=solidJs.createSignal(e.facts.$store.get(t)),n=e.facts.$store.subscribe([t],()=>{r(()=>e.facts.$store.get(t));});return [s,n]}function ne(){return {useFact:(e,t)=>C(e,t),useDerived:(e,t)=>q(e,t),useDispatch:e=>t=>{e.dispatch(t);},useEvents:e=>N(e),useWatch:(e,t,s)=>U(e,t,s)}}function se(e,t,s){let[r,n]=solidJs.createSignal(s(e)),o=e.subscribe(t,()=>{n(()=>s(e));});return solidJs.onCleanup(o),r}function re(e){let t=e();return typeof window<"u"&&!t.isRunning&&t.start(),solidJs.onCleanup(()=>{t.destroy();}),t}Object.defineProperty(exports,"shallowEqual",{enumerable:true,get:function(){return adapterUtils.shallowEqual}});exports.createDerivedSignal=ee;exports.createFactSignal=te;exports.createTypedHooks=ne;exports.useConstraintStatus=G;exports.useDerived=q;exports.useDirective=Z;exports.useDispatch=L;exports.useEvents=N;exports.useExplain=Q;exports.useFact=C;exports.useHistory=Y;exports.useInspect=O;exports.useNamespacedSelector=se;exports.useOptimisticUpdate=J;exports.useQuerySystem=re;exports.useRequirementStatus=k;exports.useSelector=z;exports.useSuspenseRequirement=X;exports.useWatch=U;//# sourceMappingURL=index.cjs.map
2
2
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts"],"names":["useFact","system","keyOrKeys","assertSystem","_useFactMulti","_useFactSingle","factKey","value","setValue","createSignal","unsubscribe","onCleanup","factKeys","getValues","result","key","state","setState","useDerived","idOrIds","_useDerivedMulti","_useDerivedSingle","derivationId","derivationIds","id","useSelector","selector","equalityFn","defaultEquality","deriveKeySet","runWithTracking","runTrackedSelector","initial","trackedFactKeys","trackedDeriveKeys","selected","setSelected","unsubs","resubscribe","unsub","onUpdate","prev","depsChanged","useDispatch","event","useEvents","useWatch","callback","useInspect","options","computeInspectState","update","throttled","cleanup","createThrottle","unsubFacts","unsubSettled","useRequirementStatus","statusPlugin","typeOrTypes","type","status","setStatus","useExplain","requirementId","explanation","setExplanation","useConstraintStatus","constraintId","getVal","inspection","c","useOptimisticUpdate","requirementType","isPending","setIsPending","error","setError","snapshot","statusUnsub","rollback","mutate","updateFn","useSuspenseRequirement","types","anyLoading","t","resolve","useHistory","buildHistoryState","useDirective","moduleDef","config","allPlugins","sp","createRequirementStatusPlugin","createSystem","derivedKeys","subscribeAll","factsState","setFactsState","pickFacts","allDerivationKeys","getDerived","derivedState","setDerivedState","unsubDerived","events","createDerivedSignal","createFactSignal","createTypedHooks","useNamespacedSelector","keys"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Solid Adapter - Consolidated SolidJS primitives for Directive\n *\n * 16 active exports: useFact, useDerived, useDispatch, useSelector,\n * useWatch, useInspect, useRequirementStatus, useEvents, useExplain,\n * useConstraintStatus, useOptimisticUpdate, useDirective, useHistory,\n * createTypedHooks, useSuspenseRequirement, shallowEqual\n *\n * Signal factories: createDerivedSignal, createFactSignal\n */\n\nimport type {\n TraceOption,\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} 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 pickFacts,\n runTrackedSelector,\n shallowEqual,\n} from \"@directive-run/core/adapter-utils\";\nimport { type Accessor, createSignal, onCleanup } from \"solid-js\";\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// 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>(\n system: SingleModuleSystem<S>,\n factKey: K,\n): Accessor<InferFacts<S>[K] | undefined>;\n/** Multi-key overload */\nexport function useFact<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(\n system: SingleModuleSystem<S>,\n factKeys: K[],\n): Accessor<Pick<InferFacts<S>, K>>;\n/** Implementation */\nexport function useFact(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n keyOrKeys: string | string[],\n): Accessor<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\n if (Array.isArray(keyOrKeys)) {\n return _useFactMulti(system, keyOrKeys);\n }\n\n // Single key path\n return _useFactSingle(system, keyOrKeys);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactSingle(\n system: SingleModuleSystem<any>,\n factKey: string,\n): Accessor<unknown> {\n if (process.env.NODE_ENV !== \"production\") {\n if (!system.facts.$store.has(factKey)) {\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 [value, setValue] = createSignal(system.facts.$store.get(factKey));\n const unsubscribe = system.facts.$store.subscribe([factKey], () => {\n setValue(() => system.facts.$store.get(factKey));\n });\n onCleanup(unsubscribe);\n return value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactMulti(\n system: SingleModuleSystem<any>,\n factKeys: string[],\n): Accessor<Record<string, unknown>> {\n const getValues = (): Record<string, unknown> => {\n const result: Record<string, unknown> = {};\n for (const key of factKeys) {\n result[key] = system.facts.$store.get(key);\n }\n return result;\n };\n const [state, setState] = createSignal(getValues());\n const unsubscribe = system.facts.$store.subscribe(factKeys, () => {\n setState(getValues);\n });\n onCleanup(unsubscribe);\n return state;\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>(\n system: SingleModuleSystem<S>,\n derivationId: K,\n): Accessor<InferDerivations<S>[K]>;\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): Accessor<Pick<InferDerivations<S>, K>>;\n/** Implementation */\nexport function useDerived(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n idOrIds: string | string[],\n): Accessor<unknown> {\n assertSystem(\"useDerived\", system);\n if (process.env.NODE_ENV !== \"production\" && typeof idOrIds === \"function\") {\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(idOrIds)) {\n return _useDerivedMulti(system, idOrIds);\n }\n\n // Single key path\n return _useDerivedSingle(system, idOrIds);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedSingle(\n system: SingleModuleSystem<any>,\n derivationId: string,\n): Accessor<unknown> {\n if (process.env.NODE_ENV !== \"production\") {\n const initialValue = system.read(derivationId);\n if (initialValue === undefined) {\n console.warn(\n `[Directive] useDerived(\"${derivationId}\") returned undefined. ` +\n `Check that \"${derivationId}\" is defined in your module's derive property.`,\n );\n }\n }\n const [value, setValue] = createSignal(system.read(derivationId));\n const unsubscribe = system.subscribe([derivationId], () => {\n setValue(() => system.read(derivationId));\n });\n onCleanup(unsubscribe);\n return value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedMulti(\n system: SingleModuleSystem<any>,\n derivationIds: string[],\n): Accessor<Record<string, unknown>> {\n const getValues = (): Record<string, unknown> => {\n const result: Record<string, unknown> = {};\n for (const id of derivationIds) {\n result[id] = system.read(id);\n }\n return result;\n };\n const [state, setState] = createSignal(getValues());\n const unsubscribe = system.subscribe(derivationIds, () => {\n setState(getValues);\n });\n onCleanup(unsubscribe);\n return state;\n}\n\n// ============================================================================\n// useSelector — auto-tracking selector over facts and derivations\n// ============================================================================\n\n/**\n * Auto-tracking selector over facts and derivations.\n * Uses `withTracking()` to detect which facts the selector accesses,\n * then subscribes only to those keys.\n */\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S>,\n selector: (state: InferSelectorState<S>) => R,\n equalityFn?: (a: R, b: R) => boolean,\n): Accessor<R>;\nexport function useSelector(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n selector: (state: any) => unknown,\n equalityFn: (a: unknown, b: unknown) => boolean = defaultEquality,\n): Accessor<unknown> {\n assertSystem(\"useSelector\", system);\n const deriveKeySet = new Set(Object.keys(system.derive ?? {}));\n\n // Build a tracking-aware state proxy that exposes both facts and derivations\n const runWithTracking = () =>\n runTrackedSelector(system, deriveKeySet, selector);\n\n const initial = runWithTracking();\n let trackedFactKeys = initial.factKeys;\n let trackedDeriveKeys = initial.deriveKeys;\n const [selected, setSelected] = createSignal(initial.value);\n\n const unsubs: Array<() => void> = [];\n\n const resubscribe = () => {\n for (const unsub of unsubs) unsub();\n unsubs.length = 0;\n\n const onUpdate = () => {\n const result = runWithTracking();\n setSelected((prev) => {\n if (!equalityFn(prev, result.value)) return result.value;\n return prev;\n });\n // Re-track: check if deps changed\n if (\n depsChanged(\n trackedFactKeys,\n result.factKeys,\n trackedDeriveKeys,\n result.deriveKeys,\n )\n ) {\n trackedFactKeys = result.factKeys;\n trackedDeriveKeys = result.deriveKeys;\n resubscribe();\n }\n };\n\n if (trackedFactKeys.length > 0) {\n unsubs.push(system.facts.$store.subscribe(trackedFactKeys, onUpdate));\n } else if (trackedDeriveKeys.length === 0) {\n unsubs.push(system.facts.$store.subscribeAll(onUpdate));\n }\n if (trackedDeriveKeys.length > 0) {\n unsubs.push(system.subscribe(trackedDeriveKeys, onUpdate));\n }\n };\n\n resubscribe();\n\n onCleanup(() => {\n for (const unsub of unsubs) unsub();\n });\n\n return selected;\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 (event: InferEvents<S>) => {\n system.dispatch(event);\n };\n}\n\n// ============================================================================\n// useEvents — memoized events reference\n// ============================================================================\n\n/**\n * Returns the system's events dispatcher.\n */\nexport function useEvents<S extends ModuleSchema>(\n system: SingleModuleSystem<S>,\n): SingleModuleSystem<S>[\"events\"] {\n assertSystem(\"useEvents\", system);\n return system.events;\n}\n\n// ============================================================================\n// useWatch — derivation or fact side-effect\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 previousValue: 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 previousValue: InferFacts<S>[K] | undefined,\n ) => void,\n): void;\n/** Implementation */\nexport function useWatch(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n key: string,\n callback: (newValue: unknown, prevValue: unknown) => void,\n): void {\n assertSystem(\"useWatch\", system);\n\n const unsubscribe = system.watch(key, callback);\n onCleanup(unsubscribe);\n}\n\n// ============================================================================\n// useInspect — consolidated inspection hook\n// ============================================================================\n\n/** Options for useInspect */\nexport interface UseInspectOptions {\n throttleMs?: number;\n}\n\n/**\n * Consolidated system inspection hook.\n * Returns Accessor<InspectState> with optional throttling.\n */\nexport function useInspect(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n options?: UseInspectOptions,\n): Accessor<InspectState> {\n assertSystem(\"useInspect\", system);\n const [state, setState] = createSignal<InspectState>(\n computeInspectState(system),\n );\n\n const update = () => {\n setState(computeInspectState(system));\n };\n\n if (options?.throttleMs && options.throttleMs > 0) {\n const { throttled, cleanup } = createThrottle(update, options.throttleMs);\n const unsubFacts = system.facts.$store.subscribeAll(throttled);\n const unsubSettled = system.onSettledChange(throttled);\n onCleanup(() => {\n cleanup();\n unsubFacts();\n unsubSettled();\n });\n } else {\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onCleanup(() => {\n unsubFacts();\n unsubSettled();\n });\n }\n\n return state;\n}\n\n// ============================================================================\n// useRequirementStatus — single or multi\n// ============================================================================\n\n/** Single type overload */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n type: string,\n): Accessor<RequirementTypeStatus>;\n/** Multi-type overload */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n types: string[],\n): Accessor<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n typeOrTypes: string | string[],\n):\n | Accessor<RequirementTypeStatus>\n | Accessor<Record<string, RequirementTypeStatus>> {\n if (Array.isArray(typeOrTypes)) {\n const getValues = (): Record<string, RequirementTypeStatus> => {\n const result: Record<string, RequirementTypeStatus> = {};\n for (const type of typeOrTypes) {\n result[type] = statusPlugin.getStatus(type);\n }\n return result;\n };\n const [state, setState] = createSignal(getValues());\n const unsubscribe = statusPlugin.subscribe(() => {\n setState(getValues);\n });\n onCleanup(unsubscribe);\n return state;\n }\n\n const [status, setStatus] = createSignal<RequirementTypeStatus>(\n statusPlugin.getStatus(typeOrTypes),\n );\n const unsubscribe = statusPlugin.subscribe(() => {\n setStatus(statusPlugin.getStatus(typeOrTypes));\n });\n onCleanup(unsubscribe);\n return status;\n}\n\n// ============================================================================\n// useExplain — reactive requirement explanation\n// ============================================================================\n\n/**\n * Reactively returns the explanation string for a requirement.\n */\nexport function useExplain(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n requirementId: string,\n): Accessor<string | null> {\n assertSystem(\"useExplain\", system);\n const [explanation, setExplanation] = createSignal<string | null>(\n system.explain(requirementId),\n );\n\n const update = () => setExplanation(system.explain(requirementId));\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onCleanup(() => {\n unsubFacts();\n unsubSettled();\n });\n\n return explanation;\n}\n\n// ============================================================================\n// useConstraintStatus — reactive constraint inspection\n// ============================================================================\n\n/** Get all constraints */\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n): Accessor<ConstraintInfo[]>;\n/** Get a single constraint by ID */\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n constraintId: string,\n): Accessor<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): Accessor<ConstraintInfo[] | ConstraintInfo | null> {\n assertSystem(\"useConstraintStatus\", system);\n const getVal = () => {\n const inspection = system.inspect();\n if (!constraintId) return inspection.constraints;\n return (\n inspection.constraints.find(\n (c: ConstraintInfo) => c.id === constraintId,\n ) ?? null\n );\n };\n\n const [state, setState] = createSignal<\n ConstraintInfo[] | ConstraintInfo | null\n >(getVal());\n\n const update = () => setState(getVal);\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onCleanup(() => {\n unsubFacts();\n unsubSettled();\n });\n\n return state;\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\nexport interface OptimisticUpdateResult {\n mutate: (updateFn: () => void) => void;\n isPending: Accessor<boolean>;\n error: Accessor<Error | null>;\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 */\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] = createSignal(false);\n const [error, setError] = createSignal<Error | null>(null);\n let snapshot: SystemSnapshot | null = null;\n let statusUnsub: (() => void) | null = null;\n\n const rollback = () => {\n if (snapshot) {\n system.restore(snapshot);\n snapshot = null;\n }\n setIsPending(false);\n setError(null);\n statusUnsub?.();\n statusUnsub = null;\n };\n\n const mutate = (updateFn: () => void) => {\n snapshot = system.getSnapshot();\n setIsPending(true);\n setError(null);\n system.batch(updateFn);\n\n if (statusPlugin && requirementType) {\n statusUnsub?.();\n statusUnsub = statusPlugin.subscribe(() => {\n const status = statusPlugin.getStatus(requirementType);\n if (!status.isLoading && !status.hasError) {\n snapshot = null;\n setIsPending(false);\n statusUnsub?.();\n statusUnsub = null;\n } else if (status.hasError) {\n setError(() => status.lastError);\n rollback();\n }\n });\n }\n };\n\n onCleanup(() => {\n statusUnsub?.();\n });\n\n return { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// useSuspenseRequirement — Solid-specific Suspense integration\n// ============================================================================\n\n/**\n * Single type: throws a promise while the requirement is pending (Suspense).\n */\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n type: string,\n): Accessor<RequirementTypeStatus>;\n/**\n * Multi-type: throws a promise while any of the requirements are pending.\n */\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n types: string[],\n): Accessor<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n typeOrTypes: string | string[],\n):\n | Accessor<RequirementTypeStatus>\n | Accessor<Record<string, RequirementTypeStatus>> {\n const types = Array.isArray(typeOrTypes) ? typeOrTypes : [typeOrTypes];\n\n // Check if any are still loading — if so, throw a promise\n const anyLoading = () =>\n types.some((t) => statusPlugin.getStatus(t).isLoading);\n\n if (anyLoading()) {\n throw new Promise<void>((resolve) => {\n const unsub = statusPlugin.subscribe(() => {\n if (!anyLoading()) {\n unsub();\n resolve();\n }\n });\n });\n }\n\n // Once resolved, return normal accessor\n if (Array.isArray(typeOrTypes)) {\n return useRequirementStatus(statusPlugin, typeOrTypes) as Accessor<\n Record<string, RequirementTypeStatus>\n >;\n }\n return useRequirementStatus(\n statusPlugin,\n typeOrTypes,\n ) as Accessor<RequirementTypeStatus>;\n}\n\n// ============================================================================\n// useHistory — reactive history signal\n// ============================================================================\n\n/**\n * Reactive history signal. Returns an Accessor that updates\n * when snapshots are taken or navigation occurs.\n *\n * @example\n * ```tsx\n * const history = useHistory(system);\n * <button disabled={!history()?.canGoBack} onClick={() => history()?.goBack()}>Undo</button>\n * ```\n */\nexport function useHistory(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n): Accessor<ReturnType<typeof buildHistoryState>> {\n assertSystem(\"useHistory\", system);\n const [state, setState] = createSignal<\n ReturnType<typeof buildHistoryState>\n >(buildHistoryState(system));\n const unsub = system.onHistoryChange(() =>\n setState(buildHistoryState(system)),\n );\n onCleanup(unsub);\n return state;\n}\n\n// ============================================================================\n// Scoped System\n// ============================================================================\n\n/** Configuration for useDirective */\ninterface UseDirectiveConfig {\n // biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n plugins?: Plugin<any>[];\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 status?: boolean;\n /** Fact keys to subscribe to (omit for all) */\n facts?: string[];\n /** Derivation keys to subscribe to (omit for all) */\n derived?: string[];\n}\n\n/**\n * Create a scoped Directive system with automatic lifecycle management.\n * When no `facts` or `derived` keys are specified, subscribes to ALL\n * facts and derivations and returns reactive signals.\n *\n * @example\n * ```tsx\n * // Subscribe to everything\n * const { facts, derived, events, dispatch } = useDirective(counterModule);\n *\n * // Selective keys\n * const { facts, derived } = useDirective(counterModule, { facts: [\"count\"], derived: [\"doubled\"] });\n * ```\n */\nexport function useDirective<M extends ModuleSchema>(\n moduleDef: ModuleDef<M>,\n config?: UseDirectiveConfig,\n) {\n const allPlugins = [...(config?.plugins ?? [])];\n let statusPlugin: StatusPlugin | undefined;\n\n if (config?.status) {\n const sp = createRequirementStatusPlugin();\n statusPlugin = sp;\n // biome-ignore lint/suspicious/noExplicitAny: Plugin generic issues\n allPlugins.push(sp.plugin as Plugin<any>);\n }\n\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n const system = createSystem({\n module: moduleDef,\n plugins: allPlugins.length > 0 ? allPlugins : undefined,\n trace: config?.trace,\n errorBoundary: config?.errorBoundary,\n tickMs: config?.tickMs,\n zeroConfig: config?.zeroConfig,\n initialFacts: config?.initialFacts,\n } as any) as unknown as SingleModuleSystem<M>;\n\n system.start();\n\n onCleanup(() => {\n system.destroy();\n });\n\n const factKeys = config?.facts;\n const derivedKeys = config?.derived;\n const subscribeAll = !factKeys && !derivedKeys;\n\n // Subscribe to facts\n const [factsState, setFactsState] = createSignal(\n subscribeAll\n ? (system.facts.$store.toObject() as InferFacts<M>)\n : (pickFacts(system, factKeys ?? []) as InferFacts<M>),\n );\n const unsubFacts = subscribeAll\n ? system.facts.$store.subscribeAll(() => {\n setFactsState(() => system.facts.$store.toObject() as InferFacts<M>);\n })\n : factKeys && factKeys.length > 0\n ? system.facts.$store.subscribe(factKeys, () => {\n setFactsState(() => pickFacts(system, factKeys) as InferFacts<M>);\n })\n : null;\n\n // Subscribe to derivations\n const allDerivationKeys = subscribeAll\n ? Object.keys(system.derive ?? {})\n : (derivedKeys ?? []);\n const getDerived = (): InferDerivations<M> => {\n const result: Record<string, unknown> = {};\n for (const key of allDerivationKeys) {\n result[key] = system.read(key);\n }\n return result as InferDerivations<M>;\n };\n const [derivedState, setDerivedState] = createSignal(getDerived());\n const unsubDerived =\n allDerivationKeys.length > 0\n ? system.subscribe(allDerivationKeys, () => {\n setDerivedState(getDerived);\n })\n : null;\n\n onCleanup(() => {\n unsubFacts?.();\n unsubDerived?.();\n });\n\n const events = system.events;\n const dispatch = (event: InferEvents<M>) => system.dispatch(event);\n\n return {\n system,\n facts: factsState as Accessor<InferFacts<M>>,\n derived: derivedState as Accessor<InferDerivations<M>>,\n events,\n dispatch,\n statusPlugin,\n };\n}\n\n// ============================================================================\n// Signal Factories (for use outside components)\n// ============================================================================\n\n/**\n * Create a derivation signal outside of a component.\n */\nexport function createDerivedSignal<T>(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n derivationId: string,\n): [Accessor<T>, () => void] {\n const [value, setValue] = createSignal<T>(system.read(derivationId) as T);\n const unsubscribe = system.subscribe([derivationId], () => {\n setValue(() => system.read(derivationId) as T);\n });\n return [value, unsubscribe];\n}\n\n/**\n * Create a fact signal outside of a component.\n */\nexport function createFactSignal<T>(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n factKey: string,\n): [Accessor<T | undefined>, () => void] {\n const [value, setValue] = createSignal<T | undefined>(\n system.facts.$store.get(factKey) as T | undefined,\n );\n const unsubscribe = system.facts.$store.subscribe([factKey], () => {\n setValue(() => system.facts.$store.get(factKey) as T | undefined);\n });\n return [value, unsubscribe];\n}\n\n// ============================================================================\n// Typed Hooks Factory\n// ============================================================================\n\nexport function createTypedHooks<M extends ModuleSchema>(): {\n useFact: <K extends keyof InferFacts<M> & string>(\n system: SingleModuleSystem<M>,\n factKey: K,\n ) => Accessor<InferFacts<M>[K] | undefined>;\n useDerived: <K extends keyof InferDerivations<M> & string>(\n system: SingleModuleSystem<M>,\n derivationId: K,\n ) => Accessor<InferDerivations<M>[K]>;\n useDispatch: (\n system: SingleModuleSystem<M>,\n ) => (event: InferEvents<M>) => void;\n useEvents: (system: SingleModuleSystem<M>) => SingleModuleSystem<M>[\"events\"];\n useWatch: <K extends string>(\n system: SingleModuleSystem<M>,\n key: K,\n callback: (newValue: unknown, previousValue: unknown) => void,\n ) => void;\n} {\n return {\n useFact: <K extends keyof InferFacts<M> & string>(\n system: SingleModuleSystem<M>,\n factKey: K,\n ) =>\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n useFact(system as SingleModuleSystem<any>, factKey as string) as Accessor<\n InferFacts<M>[K] | undefined\n >,\n useDerived: <K extends keyof InferDerivations<M> & string>(\n system: SingleModuleSystem<M>,\n derivationId: K,\n ) =>\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n useDerived(\n system as SingleModuleSystem<any>,\n derivationId as string,\n ) as Accessor<InferDerivations<M>[K]>,\n useDispatch: (system: SingleModuleSystem<M>) => {\n return (event: InferEvents<M>) => {\n system.dispatch(event);\n };\n },\n useEvents: (system: SingleModuleSystem<M>) => useEvents<M>(system),\n useWatch: <K extends string>(\n system: SingleModuleSystem<M>,\n key: K,\n callback: (newValue: unknown, previousValue: unknown) => void,\n ) =>\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n useWatch(system as SingleModuleSystem<any>, key, callback),\n };\n}\n\n// ============================================================================\n// useNamespacedSelector — select from a NamespacedSystem\n// ============================================================================\n\n/**\n * SolidJS accessor that selects from a NamespacedSystem.\n * Subscribes to specified keys and provides reactive updates.\n *\n * @param system - The namespaced system\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 token = useNamespacedSelector(system, [\"auth.token\"], (s) => s.facts.auth.token);\n * ```\n */\nexport function useNamespacedSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n keys: string[],\n selector: (system: NamespacedSystem<Modules>) => R,\n): Accessor<R> {\n const [value, setValue] = createSignal<R>(selector(system));\n const unsubscribe = system.subscribe(keys, () => {\n setValue(() => selector(system));\n });\n onCleanup(unsubscribe);\n\n return value as Accessor<R>;\n}\n"]}
1
+ {"version":3,"sources":["../src/index.ts"],"names":["useFact","system","keyOrKeys","assertSystem","_useFactMulti","_useFactSingle","factKey","value","setValue","createSignal","unsubscribe","onCleanup","factKeys","getValues","result","key","state","setState","useDerived","idOrIds","_useDerivedMulti","_useDerivedSingle","derivationId","derivationIds","id","useSelector","selector","equalityFn","defaultEquality","deriveKeySet","runWithTracking","runTrackedSelector","initial","trackedFactKeys","trackedDeriveKeys","selected","setSelected","unsubs","resubscribe","unsub","onUpdate","prev","depsChanged","useDispatch","event","useEvents","useWatch","callback","useInspect","options","computeInspectState","update","throttled","cleanup","createThrottle","unsubFacts","unsubSettled","useRequirementStatus","statusPlugin","typeOrTypes","type","status","setStatus","useExplain","requirementId","explanation","setExplanation","useConstraintStatus","constraintId","getVal","inspection","c","useOptimisticUpdate","requirementType","isPending","setIsPending","error","setError","snapshot","statusUnsub","rollback","mutate","updateFn","useSuspenseRequirement","types","anyLoading","t","resolve","useHistory","buildHistoryState","useDirective","moduleDef","config","allPlugins","sp","createRequirementStatusPlugin","createSystem","derivedKeys","subscribeAll","factsState","setFactsState","pickFacts","allDerivationKeys","getDerived","derivedState","setDerivedState","unsubDerived","events","createDerivedSignal","createFactSignal","createTypedHooks","useNamespacedSelector","keys","useQuerySystem","factory"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Solid Adapter - Consolidated SolidJS primitives for Directive\n *\n * 16 active exports: useFact, useDerived, useDispatch, useSelector,\n * useWatch, useInspect, useRequirementStatus, useEvents, useExplain,\n * useConstraintStatus, useOptimisticUpdate, useDirective, useHistory,\n * createTypedHooks, useSuspenseRequirement, shallowEqual\n *\n * Signal factories: createDerivedSignal, createFactSignal\n */\n\nimport type {\n TraceOption,\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} 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 pickFacts,\n runTrackedSelector,\n shallowEqual,\n} from \"@directive-run/core/adapter-utils\";\nimport { type Accessor, createSignal, onCleanup } from \"solid-js\";\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// 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>(\n system: SingleModuleSystem<S>,\n factKey: K,\n): Accessor<InferFacts<S>[K] | undefined>;\n/** Multi-key overload */\nexport function useFact<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(\n system: SingleModuleSystem<S>,\n factKeys: K[],\n): Accessor<Pick<InferFacts<S>, K>>;\n/** Implementation */\nexport function useFact(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n keyOrKeys: string | string[],\n): Accessor<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\n if (Array.isArray(keyOrKeys)) {\n return _useFactMulti(system, keyOrKeys);\n }\n\n // Single key path\n return _useFactSingle(system, keyOrKeys);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactSingle(\n system: SingleModuleSystem<any>,\n factKey: string,\n): Accessor<unknown> {\n if (process.env.NODE_ENV !== \"production\") {\n if (!system.facts.$store.has(factKey)) {\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 [value, setValue] = createSignal(system.facts.$store.get(factKey));\n const unsubscribe = system.facts.$store.subscribe([factKey], () => {\n setValue(() => system.facts.$store.get(factKey));\n });\n onCleanup(unsubscribe);\n return value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactMulti(\n system: SingleModuleSystem<any>,\n factKeys: string[],\n): Accessor<Record<string, unknown>> {\n const getValues = (): Record<string, unknown> => {\n const result: Record<string, unknown> = {};\n for (const key of factKeys) {\n result[key] = system.facts.$store.get(key);\n }\n return result;\n };\n const [state, setState] = createSignal(getValues());\n const unsubscribe = system.facts.$store.subscribe(factKeys, () => {\n setState(getValues);\n });\n onCleanup(unsubscribe);\n return state;\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>(\n system: SingleModuleSystem<S>,\n derivationId: K,\n): Accessor<InferDerivations<S>[K]>;\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): Accessor<Pick<InferDerivations<S>, K>>;\n/** Implementation */\nexport function useDerived(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n idOrIds: string | string[],\n): Accessor<unknown> {\n assertSystem(\"useDerived\", system);\n if (process.env.NODE_ENV !== \"production\" && typeof idOrIds === \"function\") {\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(idOrIds)) {\n return _useDerivedMulti(system, idOrIds);\n }\n\n // Single key path\n return _useDerivedSingle(system, idOrIds);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedSingle(\n system: SingleModuleSystem<any>,\n derivationId: string,\n): Accessor<unknown> {\n if (process.env.NODE_ENV !== \"production\") {\n const initialValue = system.read(derivationId);\n if (initialValue === undefined) {\n console.warn(\n `[Directive] useDerived(\"${derivationId}\") returned undefined. ` +\n `Check that \"${derivationId}\" is defined in your module's derive property.`,\n );\n }\n }\n const [value, setValue] = createSignal(system.read(derivationId));\n const unsubscribe = system.subscribe([derivationId], () => {\n setValue(() => system.read(derivationId));\n });\n onCleanup(unsubscribe);\n return value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedMulti(\n system: SingleModuleSystem<any>,\n derivationIds: string[],\n): Accessor<Record<string, unknown>> {\n const getValues = (): Record<string, unknown> => {\n const result: Record<string, unknown> = {};\n for (const id of derivationIds) {\n result[id] = system.read(id);\n }\n return result;\n };\n const [state, setState] = createSignal(getValues());\n const unsubscribe = system.subscribe(derivationIds, () => {\n setState(getValues);\n });\n onCleanup(unsubscribe);\n return state;\n}\n\n// ============================================================================\n// useSelector — auto-tracking selector over facts and derivations\n// ============================================================================\n\n/**\n * Auto-tracking selector over facts and derivations.\n * Uses `withTracking()` to detect which facts the selector accesses,\n * then subscribes only to those keys.\n */\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S>,\n selector: (state: InferSelectorState<S>) => R,\n equalityFn?: (a: R, b: R) => boolean,\n): Accessor<R>;\nexport function useSelector(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n selector: (state: any) => unknown,\n equalityFn: (a: unknown, b: unknown) => boolean = defaultEquality,\n): Accessor<unknown> {\n assertSystem(\"useSelector\", system);\n const deriveKeySet = new Set(Object.keys(system.derive ?? {}));\n\n // Build a tracking-aware state proxy that exposes both facts and derivations\n const runWithTracking = () =>\n runTrackedSelector(system, deriveKeySet, selector);\n\n const initial = runWithTracking();\n let trackedFactKeys = initial.factKeys;\n let trackedDeriveKeys = initial.deriveKeys;\n const [selected, setSelected] = createSignal(initial.value);\n\n const unsubs: Array<() => void> = [];\n\n const resubscribe = () => {\n for (const unsub of unsubs) unsub();\n unsubs.length = 0;\n\n const onUpdate = () => {\n const result = runWithTracking();\n setSelected((prev) => {\n if (!equalityFn(prev, result.value)) return result.value;\n return prev;\n });\n // Re-track: check if deps changed\n if (\n depsChanged(\n trackedFactKeys,\n result.factKeys,\n trackedDeriveKeys,\n result.deriveKeys,\n )\n ) {\n trackedFactKeys = result.factKeys;\n trackedDeriveKeys = result.deriveKeys;\n resubscribe();\n }\n };\n\n if (trackedFactKeys.length > 0) {\n unsubs.push(system.facts.$store.subscribe(trackedFactKeys, onUpdate));\n } else if (trackedDeriveKeys.length === 0) {\n unsubs.push(system.facts.$store.subscribeAll(onUpdate));\n }\n if (trackedDeriveKeys.length > 0) {\n unsubs.push(system.subscribe(trackedDeriveKeys, onUpdate));\n }\n };\n\n resubscribe();\n\n onCleanup(() => {\n for (const unsub of unsubs) unsub();\n });\n\n return selected;\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 (event: InferEvents<S>) => {\n system.dispatch(event);\n };\n}\n\n// ============================================================================\n// useEvents — memoized events reference\n// ============================================================================\n\n/**\n * Returns the system's events dispatcher.\n */\nexport function useEvents<S extends ModuleSchema>(\n system: SingleModuleSystem<S>,\n): SingleModuleSystem<S>[\"events\"] {\n assertSystem(\"useEvents\", system);\n return system.events;\n}\n\n// ============================================================================\n// useWatch — derivation or fact side-effect\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 previousValue: 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 previousValue: InferFacts<S>[K] | undefined,\n ) => void,\n): void;\n/** Implementation */\nexport function useWatch(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n key: string,\n callback: (newValue: unknown, prevValue: unknown) => void,\n): void {\n assertSystem(\"useWatch\", system);\n\n const unsubscribe = system.watch(key, callback);\n onCleanup(unsubscribe);\n}\n\n// ============================================================================\n// useInspect — consolidated inspection hook\n// ============================================================================\n\n/** Options for useInspect */\nexport interface UseInspectOptions {\n throttleMs?: number;\n}\n\n/**\n * Consolidated system inspection hook.\n * Returns Accessor<InspectState> with optional throttling.\n */\nexport function useInspect(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n options?: UseInspectOptions,\n): Accessor<InspectState> {\n assertSystem(\"useInspect\", system);\n const [state, setState] = createSignal<InspectState>(\n computeInspectState(system),\n );\n\n const update = () => {\n setState(computeInspectState(system));\n };\n\n if (options?.throttleMs && options.throttleMs > 0) {\n const { throttled, cleanup } = createThrottle(update, options.throttleMs);\n const unsubFacts = system.facts.$store.subscribeAll(throttled);\n const unsubSettled = system.onSettledChange(throttled);\n onCleanup(() => {\n cleanup();\n unsubFacts();\n unsubSettled();\n });\n } else {\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onCleanup(() => {\n unsubFacts();\n unsubSettled();\n });\n }\n\n return state;\n}\n\n// ============================================================================\n// useRequirementStatus — single or multi\n// ============================================================================\n\n/** Single type overload */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n type: string,\n): Accessor<RequirementTypeStatus>;\n/** Multi-type overload */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n types: string[],\n): Accessor<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n typeOrTypes: string | string[],\n):\n | Accessor<RequirementTypeStatus>\n | Accessor<Record<string, RequirementTypeStatus>> {\n if (Array.isArray(typeOrTypes)) {\n const getValues = (): Record<string, RequirementTypeStatus> => {\n const result: Record<string, RequirementTypeStatus> = {};\n for (const type of typeOrTypes) {\n result[type] = statusPlugin.getStatus(type);\n }\n return result;\n };\n const [state, setState] = createSignal(getValues());\n const unsubscribe = statusPlugin.subscribe(() => {\n setState(getValues);\n });\n onCleanup(unsubscribe);\n return state;\n }\n\n const [status, setStatus] = createSignal<RequirementTypeStatus>(\n statusPlugin.getStatus(typeOrTypes),\n );\n const unsubscribe = statusPlugin.subscribe(() => {\n setStatus(statusPlugin.getStatus(typeOrTypes));\n });\n onCleanup(unsubscribe);\n return status;\n}\n\n// ============================================================================\n// useExplain — reactive requirement explanation\n// ============================================================================\n\n/**\n * Reactively returns the explanation string for a requirement.\n */\nexport function useExplain(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n requirementId: string,\n): Accessor<string | null> {\n assertSystem(\"useExplain\", system);\n const [explanation, setExplanation] = createSignal<string | null>(\n system.explain(requirementId),\n );\n\n const update = () => setExplanation(system.explain(requirementId));\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onCleanup(() => {\n unsubFacts();\n unsubSettled();\n });\n\n return explanation;\n}\n\n// ============================================================================\n// useConstraintStatus — reactive constraint inspection\n// ============================================================================\n\n/** Get all constraints */\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n): Accessor<ConstraintInfo[]>;\n/** Get a single constraint by ID */\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n constraintId: string,\n): Accessor<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): Accessor<ConstraintInfo[] | ConstraintInfo | null> {\n assertSystem(\"useConstraintStatus\", system);\n const getVal = () => {\n const inspection = system.inspect();\n if (!constraintId) return inspection.constraints;\n return (\n inspection.constraints.find(\n (c: ConstraintInfo) => c.id === constraintId,\n ) ?? null\n );\n };\n\n const [state, setState] = createSignal<\n ConstraintInfo[] | ConstraintInfo | null\n >(getVal());\n\n const update = () => setState(getVal);\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onCleanup(() => {\n unsubFacts();\n unsubSettled();\n });\n\n return state;\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\nexport interface OptimisticUpdateResult {\n mutate: (updateFn: () => void) => void;\n isPending: Accessor<boolean>;\n error: Accessor<Error | null>;\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 */\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] = createSignal(false);\n const [error, setError] = createSignal<Error | null>(null);\n let snapshot: SystemSnapshot | null = null;\n let statusUnsub: (() => void) | null = null;\n\n const rollback = () => {\n if (snapshot) {\n system.restore(snapshot);\n snapshot = null;\n }\n setIsPending(false);\n setError(null);\n statusUnsub?.();\n statusUnsub = null;\n };\n\n const mutate = (updateFn: () => void) => {\n snapshot = system.getSnapshot();\n setIsPending(true);\n setError(null);\n system.batch(updateFn);\n\n if (statusPlugin && requirementType) {\n statusUnsub?.();\n statusUnsub = statusPlugin.subscribe(() => {\n const status = statusPlugin.getStatus(requirementType);\n if (!status.isLoading && !status.hasError) {\n snapshot = null;\n setIsPending(false);\n statusUnsub?.();\n statusUnsub = null;\n } else if (status.hasError) {\n setError(() => status.lastError);\n rollback();\n }\n });\n }\n };\n\n onCleanup(() => {\n statusUnsub?.();\n });\n\n return { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// useSuspenseRequirement — Solid-specific Suspense integration\n// ============================================================================\n\n/**\n * Single type: throws a promise while the requirement is pending (Suspense).\n */\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n type: string,\n): Accessor<RequirementTypeStatus>;\n/**\n * Multi-type: throws a promise while any of the requirements are pending.\n */\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n types: string[],\n): Accessor<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n typeOrTypes: string | string[],\n):\n | Accessor<RequirementTypeStatus>\n | Accessor<Record<string, RequirementTypeStatus>> {\n const types = Array.isArray(typeOrTypes) ? typeOrTypes : [typeOrTypes];\n\n // Check if any are still loading — if so, throw a promise\n const anyLoading = () =>\n types.some((t) => statusPlugin.getStatus(t).isLoading);\n\n if (anyLoading()) {\n throw new Promise<void>((resolve) => {\n const unsub = statusPlugin.subscribe(() => {\n if (!anyLoading()) {\n unsub();\n resolve();\n }\n });\n });\n }\n\n // Once resolved, return normal accessor\n if (Array.isArray(typeOrTypes)) {\n return useRequirementStatus(statusPlugin, typeOrTypes) as Accessor<\n Record<string, RequirementTypeStatus>\n >;\n }\n return useRequirementStatus(\n statusPlugin,\n typeOrTypes,\n ) as Accessor<RequirementTypeStatus>;\n}\n\n// ============================================================================\n// useHistory — reactive history signal\n// ============================================================================\n\n/**\n * Reactive history signal. Returns an Accessor that updates\n * when snapshots are taken or navigation occurs.\n *\n * @example\n * ```tsx\n * const history = useHistory(system);\n * <button disabled={!history()?.canGoBack} onClick={() => history()?.goBack()}>Undo</button>\n * ```\n */\nexport function useHistory(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n): Accessor<ReturnType<typeof buildHistoryState>> {\n assertSystem(\"useHistory\", system);\n const [state, setState] = createSignal<\n ReturnType<typeof buildHistoryState>\n >(buildHistoryState(system));\n const unsub = system.onHistoryChange(() =>\n setState(buildHistoryState(system)),\n );\n onCleanup(unsub);\n return state;\n}\n\n// ============================================================================\n// Scoped System\n// ============================================================================\n\n/** Configuration for useDirective */\ninterface UseDirectiveConfig {\n // biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n plugins?: Plugin<any>[];\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 status?: boolean;\n /** Fact keys to subscribe to (omit for all) */\n facts?: string[];\n /** Derivation keys to subscribe to (omit for all) */\n derived?: string[];\n}\n\n/**\n * Create a scoped Directive system with automatic lifecycle management.\n * When no `facts` or `derived` keys are specified, subscribes to ALL\n * facts and derivations and returns reactive signals.\n *\n * @example\n * ```tsx\n * // Subscribe to everything\n * const { facts, derived, events, dispatch } = useDirective(counterModule);\n *\n * // Selective keys\n * const { facts, derived } = useDirective(counterModule, { facts: [\"count\"], derived: [\"doubled\"] });\n * ```\n */\nexport function useDirective<M extends ModuleSchema>(\n moduleDef: ModuleDef<M>,\n config?: UseDirectiveConfig,\n) {\n const allPlugins = [...(config?.plugins ?? [])];\n let statusPlugin: StatusPlugin | undefined;\n\n if (config?.status) {\n const sp = createRequirementStatusPlugin();\n statusPlugin = sp;\n // biome-ignore lint/suspicious/noExplicitAny: Plugin generic issues\n allPlugins.push(sp.plugin as Plugin<any>);\n }\n\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n const system = createSystem({\n module: moduleDef,\n plugins: allPlugins.length > 0 ? allPlugins : undefined,\n trace: config?.trace,\n errorBoundary: config?.errorBoundary,\n tickMs: config?.tickMs,\n zeroConfig: config?.zeroConfig,\n initialFacts: config?.initialFacts,\n } as any) as unknown as SingleModuleSystem<M>;\n\n // SSR guard: initialize facts for SSR rendering, start reconciliation only in the browser\n if (typeof window !== \"undefined\") {\n system.start();\n } else {\n system.initialize();\n }\n\n onCleanup(() => {\n system.destroy();\n });\n\n const factKeys = config?.facts;\n const derivedKeys = config?.derived;\n const subscribeAll = !factKeys && !derivedKeys;\n\n // Subscribe to facts\n const [factsState, setFactsState] = createSignal(\n subscribeAll\n ? (system.facts.$store.toObject() as InferFacts<M>)\n : (pickFacts(system, factKeys ?? []) as InferFacts<M>),\n );\n const unsubFacts = subscribeAll\n ? system.facts.$store.subscribeAll(() => {\n setFactsState(() => system.facts.$store.toObject() as InferFacts<M>);\n })\n : factKeys && factKeys.length > 0\n ? system.facts.$store.subscribe(factKeys, () => {\n setFactsState(() => pickFacts(system, factKeys) as InferFacts<M>);\n })\n : null;\n\n // Subscribe to derivations\n const allDerivationKeys = subscribeAll\n ? Object.keys(system.derive ?? {})\n : (derivedKeys ?? []);\n const getDerived = (): InferDerivations<M> => {\n const result: Record<string, unknown> = {};\n for (const key of allDerivationKeys) {\n result[key] = system.read(key);\n }\n return result as InferDerivations<M>;\n };\n const [derivedState, setDerivedState] = createSignal(getDerived());\n const unsubDerived =\n allDerivationKeys.length > 0\n ? system.subscribe(allDerivationKeys, () => {\n setDerivedState(getDerived);\n })\n : null;\n\n onCleanup(() => {\n unsubFacts?.();\n unsubDerived?.();\n });\n\n const events = system.events;\n const dispatch = (event: InferEvents<M>) => system.dispatch(event);\n\n return {\n system,\n facts: factsState as Accessor<InferFacts<M>>,\n derived: derivedState as Accessor<InferDerivations<M>>,\n events,\n dispatch,\n statusPlugin,\n };\n}\n\n// ============================================================================\n// Signal Factories (for use outside components)\n// ============================================================================\n\n/**\n * Create a derivation signal outside of a component.\n */\nexport function createDerivedSignal<T>(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n derivationId: string,\n): [Accessor<T>, () => void] {\n const [value, setValue] = createSignal<T>(system.read(derivationId) as T);\n const unsubscribe = system.subscribe([derivationId], () => {\n setValue(() => system.read(derivationId) as T);\n });\n return [value, unsubscribe];\n}\n\n/**\n * Create a fact signal outside of a component.\n */\nexport function createFactSignal<T>(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n factKey: string,\n): [Accessor<T | undefined>, () => void] {\n const [value, setValue] = createSignal<T | undefined>(\n system.facts.$store.get(factKey) as T | undefined,\n );\n const unsubscribe = system.facts.$store.subscribe([factKey], () => {\n setValue(() => system.facts.$store.get(factKey) as T | undefined);\n });\n return [value, unsubscribe];\n}\n\n// ============================================================================\n// Typed Hooks Factory\n// ============================================================================\n\nexport function createTypedHooks<M extends ModuleSchema>(): {\n useFact: <K extends keyof InferFacts<M> & string>(\n system: SingleModuleSystem<M>,\n factKey: K,\n ) => Accessor<InferFacts<M>[K] | undefined>;\n useDerived: <K extends keyof InferDerivations<M> & string>(\n system: SingleModuleSystem<M>,\n derivationId: K,\n ) => Accessor<InferDerivations<M>[K]>;\n useDispatch: (\n system: SingleModuleSystem<M>,\n ) => (event: InferEvents<M>) => void;\n useEvents: (system: SingleModuleSystem<M>) => SingleModuleSystem<M>[\"events\"];\n useWatch: <K extends string>(\n system: SingleModuleSystem<M>,\n key: K,\n callback: (newValue: unknown, previousValue: unknown) => void,\n ) => void;\n} {\n return {\n useFact: <K extends keyof InferFacts<M> & string>(\n system: SingleModuleSystem<M>,\n factKey: K,\n ) =>\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n useFact(system as SingleModuleSystem<any>, factKey as string) as Accessor<\n InferFacts<M>[K] | undefined\n >,\n useDerived: <K extends keyof InferDerivations<M> & string>(\n system: SingleModuleSystem<M>,\n derivationId: K,\n ) =>\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n useDerived(\n system as SingleModuleSystem<any>,\n derivationId as string,\n ) as Accessor<InferDerivations<M>[K]>,\n useDispatch: (system: SingleModuleSystem<M>) => {\n return (event: InferEvents<M>) => {\n system.dispatch(event);\n };\n },\n useEvents: (system: SingleModuleSystem<M>) => useEvents<M>(system),\n useWatch: <K extends string>(\n system: SingleModuleSystem<M>,\n key: K,\n callback: (newValue: unknown, previousValue: unknown) => void,\n ) =>\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n useWatch(system as SingleModuleSystem<any>, key, callback),\n };\n}\n\n// ============================================================================\n// useNamespacedSelector — select from a NamespacedSystem\n// ============================================================================\n\n/**\n * SolidJS accessor that selects from a NamespacedSystem.\n * Subscribes to specified keys and provides reactive updates.\n *\n * @param system - The namespaced system\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 token = useNamespacedSelector(system, [\"auth.token\"], (s) => s.facts.auth.token);\n * ```\n */\nexport function useNamespacedSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n keys: string[],\n selector: (system: NamespacedSystem<Modules>) => R,\n): Accessor<R> {\n const [value, setValue] = createSignal<R>(selector(system));\n const unsubscribe = system.subscribe(keys, () => {\n setValue(() => selector(system));\n });\n onCleanup(unsubscribe);\n\n return value as Accessor<R>;\n}\n\n// ============================================================================\n// useQuerySystem — Stable query system with lifecycle management\n// ============================================================================\n\n/**\n * Solid composable to create and manage a query system with proper lifecycle.\n *\n * Accepts a factory function that creates the system.\n * Handles cleanup via onCleanup.\n *\n * @example\n * ```tsx\n * import { useQuerySystem, useDerived } from \"@directive-run/solid\";\n * import { createQuerySystem } from \"@directive-run/query\";\n *\n * function App() {\n * const app = useQuerySystem(() =>\n * createQuerySystem({\n * facts: { userId: \"\" },\n * queries: { user: { key: ..., fetcher: ... } },\n * autoStart: false,\n * })\n * );\n *\n * const user = useDerived(app, \"user\");\n * return <div>{user().data?.name}</div>;\n * }\n * ```\n */\n// biome-ignore lint/suspicious/noExplicitAny: Factory return type varies\nexport function useQuerySystem<T extends { start: () => void; destroy: () => void; isRunning?: boolean; [key: string]: any }>(\n factory: () => T,\n): T {\n const system = factory();\n\n if (typeof window !== \"undefined\" && !system.isRunning) {\n system.start();\n }\n\n onCleanup(() => {\n system.destroy();\n });\n\n return system;\n}\n"]}
package/dist/index.d.cts CHANGED
@@ -164,5 +164,36 @@ declare function createTypedHooks<M extends ModuleSchema>(): {
164
164
  * ```
165
165
  */
166
166
  declare function useNamespacedSelector<Modules extends ModulesMap, R>(system: NamespacedSystem<Modules>, keys: string[], selector: (system: NamespacedSystem<Modules>) => R): Accessor<R>;
167
+ /**
168
+ * Solid composable to create and manage a query system with proper lifecycle.
169
+ *
170
+ * Accepts a factory function that creates the system.
171
+ * Handles cleanup via onCleanup.
172
+ *
173
+ * @example
174
+ * ```tsx
175
+ * import { useQuerySystem, useDerived } from "@directive-run/solid";
176
+ * import { createQuerySystem } from "@directive-run/query";
177
+ *
178
+ * function App() {
179
+ * const app = useQuerySystem(() =>
180
+ * createQuerySystem({
181
+ * facts: { userId: "" },
182
+ * queries: { user: { key: ..., fetcher: ... } },
183
+ * autoStart: false,
184
+ * })
185
+ * );
186
+ *
187
+ * const user = useDerived(app, "user");
188
+ * return <div>{user().data?.name}</div>;
189
+ * }
190
+ * ```
191
+ */
192
+ declare function useQuerySystem<T extends {
193
+ start: () => void;
194
+ destroy: () => void;
195
+ isRunning?: boolean;
196
+ [key: string]: any;
197
+ }>(factory: () => T): T;
167
198
 
168
- export { type OptimisticUpdateResult, type StatusPlugin, type UseInspectOptions, createDerivedSignal, createFactSignal, createTypedHooks, useConstraintStatus, useDerived, useDirective, useDispatch, useEvents, useExplain, useFact, useHistory, useInspect, useNamespacedSelector, useOptimisticUpdate, useRequirementStatus, useSelector, useSuspenseRequirement, useWatch };
199
+ export { type OptimisticUpdateResult, type StatusPlugin, type UseInspectOptions, createDerivedSignal, createFactSignal, createTypedHooks, useConstraintStatus, useDerived, useDirective, useDispatch, useEvents, useExplain, useFact, useHistory, useInspect, useNamespacedSelector, useOptimisticUpdate, useQuerySystem, useRequirementStatus, useSelector, useSuspenseRequirement, useWatch };
package/dist/index.d.ts CHANGED
@@ -164,5 +164,36 @@ declare function createTypedHooks<M extends ModuleSchema>(): {
164
164
  * ```
165
165
  */
166
166
  declare function useNamespacedSelector<Modules extends ModulesMap, R>(system: NamespacedSystem<Modules>, keys: string[], selector: (system: NamespacedSystem<Modules>) => R): Accessor<R>;
167
+ /**
168
+ * Solid composable to create and manage a query system with proper lifecycle.
169
+ *
170
+ * Accepts a factory function that creates the system.
171
+ * Handles cleanup via onCleanup.
172
+ *
173
+ * @example
174
+ * ```tsx
175
+ * import { useQuerySystem, useDerived } from "@directive-run/solid";
176
+ * import { createQuerySystem } from "@directive-run/query";
177
+ *
178
+ * function App() {
179
+ * const app = useQuerySystem(() =>
180
+ * createQuerySystem({
181
+ * facts: { userId: "" },
182
+ * queries: { user: { key: ..., fetcher: ... } },
183
+ * autoStart: false,
184
+ * })
185
+ * );
186
+ *
187
+ * const user = useDerived(app, "user");
188
+ * return <div>{user().data?.name}</div>;
189
+ * }
190
+ * ```
191
+ */
192
+ declare function useQuerySystem<T extends {
193
+ start: () => void;
194
+ destroy: () => void;
195
+ isRunning?: boolean;
196
+ [key: string]: any;
197
+ }>(factory: () => T): T;
167
198
 
168
- export { type OptimisticUpdateResult, type StatusPlugin, type UseInspectOptions, createDerivedSignal, createFactSignal, createTypedHooks, useConstraintStatus, useDerived, useDirective, useDispatch, useEvents, useExplain, useFact, useHistory, useInspect, useNamespacedSelector, useOptimisticUpdate, useRequirementStatus, useSelector, useSuspenseRequirement, useWatch };
199
+ export { type OptimisticUpdateResult, type StatusPlugin, type UseInspectOptions, createDerivedSignal, createFactSignal, createTypedHooks, useConstraintStatus, useDerived, useDirective, useDispatch, useEvents, useExplain, useFact, useHistory, useInspect, useNamespacedSelector, useOptimisticUpdate, useQuerySystem, useRequirementStatus, useSelector, useSuspenseRequirement, useWatch };
package/dist/index.js CHANGED
@@ -1,2 +1,2 @@
1
- import {createRequirementStatusPlugin,createSystem}from'@directive-run/core';import {defaultEquality,assertSystem,computeInspectState,createThrottle,buildHistoryState,pickFacts,runTrackedSelector,depsChanged}from'@directive-run/core/adapter-utils';export{shallowEqual}from'@directive-run/core/adapter-utils';import {createSignal,onCleanup}from'solid-js';function C(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)?V(e,t):T(e,t)}function T(e,t){process.env.NODE_ENV!=="production"&&(e.facts.$store.has(t)||console.warn(`[Directive] useFact("${t}") \u2014 fact not found in store. Check that "${t}" is defined in your module's schema.`));let[s,r]=createSignal(e.facts.$store.get(t)),n=e.facts.$store.subscribe([t],()=>{r(()=>e.facts.$store.get(t));});return onCleanup(n),s}function V(e,t){let s=()=>{let u={};for(let i of t)u[i]=e.facts.$store.get(i);return u},[r,n]=createSignal(s()),o=e.facts.$store.subscribe(t,()=>{n(s);});return onCleanup(o),r}function q(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)?P(e,t):$(e,t)}function $(e,t){process.env.NODE_ENV!=="production"&&e.read(t)===void 0&&console.warn(`[Directive] useDerived("${t}") returned undefined. Check that "${t}" is defined in your module's derive property.`);let[s,r]=createSignal(e.read(t)),n=e.subscribe([t],()=>{r(()=>e.read(t));});return onCleanup(n),s}function P(e,t){let s=()=>{let u={};for(let i of t)u[i]=e.read(i);return u},[r,n]=createSignal(s()),o=e.subscribe(t,()=>{n(s);});return onCleanup(o),r}function z(e,t,s=defaultEquality){assertSystem("useSelector",e);let r=new Set(Object.keys(e.derive??{})),n=()=>runTrackedSelector(e,r,t),o=n(),u=o.factKeys,i=o.deriveKeys,[c,f]=createSignal(o.value),d=[],y=()=>{for(let p of d)p();d.length=0;let S=()=>{let p=n();f(b=>s(b,p.value)?b:p.value),depsChanged(u,p.factKeys,i,p.deriveKeys)&&(u=p.factKeys,i=p.deriveKeys,y());};u.length>0?d.push(e.facts.$store.subscribe(u,S)):i.length===0&&d.push(e.facts.$store.subscribeAll(S)),i.length>0&&d.push(e.subscribe(i,S));};return y(),onCleanup(()=>{for(let S of d)S();}),c}function L(e){return assertSystem("useDispatch",e),t=>{e.dispatch(t);}}function N(e){return assertSystem("useEvents",e),e.events}function U(e,t,s){assertSystem("useWatch",e);let r=e.watch(t,s);onCleanup(r);}function O(e,t){assertSystem("useInspect",e);let[s,r]=createSignal(computeInspectState(e)),n=()=>{r(computeInspectState(e));};if(t?.throttleMs&&t.throttleMs>0){let{throttled:o,cleanup:u}=createThrottle(n,t.throttleMs),i=e.facts.$store.subscribeAll(o),c=e.onSettledChange(o);onCleanup(()=>{u(),i(),c();});}else {let o=e.facts.$store.subscribeAll(n),u=e.onSettledChange(n);onCleanup(()=>{o(),u();});}return s}function k(e,t){if(Array.isArray(t)){let o=()=>{let f={};for(let d of t)f[d]=e.getStatus(d);return f},[u,i]=createSignal(o()),c=e.subscribe(()=>{i(o);});return onCleanup(c),u}let[s,r]=createSignal(e.getStatus(t)),n=e.subscribe(()=>{r(e.getStatus(t));});return onCleanup(n),s}function G(e,t){assertSystem("useExplain",e);let[s,r]=createSignal(e.explain(t)),n=()=>r(e.explain(t)),o=e.facts.$store.subscribeAll(n),u=e.onSettledChange(n);return onCleanup(()=>{o(),u();}),s}function J(e,t){assertSystem("useConstraintStatus",e);let s=()=>{let c=e.inspect();return t?c.constraints.find(f=>f.id===t)??null:c.constraints},[r,n]=createSignal(s()),o=()=>n(s),u=e.facts.$store.subscribeAll(o),i=e.onSettledChange(o);return onCleanup(()=>{u(),i();}),r}function Q(e,t,s){assertSystem("useOptimisticUpdate",e);let[r,n]=createSignal(false),[o,u]=createSignal(null),i=null,c=null,f=()=>{i&&(e.restore(i),i=null),n(false),u(null),c?.(),c=null;},d=y=>{i=e.getSnapshot(),n(true),u(null),e.batch(y),t&&s&&(c?.(),c=t.subscribe(()=>{let S=t.getStatus(s);!S.isLoading&&!S.hasError?(i=null,n(false),c?.(),c=null):S.hasError&&(u(()=>S.lastError),f());}));};return onCleanup(()=>{c?.();}),{mutate:d,isPending:r,error:o,rollback:f}}function X(e,t){let s=Array.isArray(t)?t:[t],r=()=>s.some(n=>e.getStatus(n).isLoading);if(r())throw new Promise(n=>{let o=e.subscribe(()=>{r()||(o(),n());});});return k(e,t)}function Y(e){assertSystem("useHistory",e);let[t,s]=createSignal(buildHistoryState(e)),r=e.onHistoryChange(()=>s(buildHistoryState(e)));return onCleanup(r),t}function Z(e,t){let s=[...t?.plugins??[]],r;if(t?.status){let M=createRequirementStatusPlugin();r=M,s.push(M.plugin);}let n=createSystem({module:e,plugins:s.length>0?s:void 0,trace:t?.trace,errorBoundary:t?.errorBoundary,tickMs:t?.tickMs,zeroConfig:t?.zeroConfig,initialFacts:t?.initialFacts});n.start(),onCleanup(()=>{n.destroy();});let o=t?.facts,u=t?.derived,i=!o&&!u,[c,f]=createSignal(i?n.facts.$store.toObject():pickFacts(n,o??[])),d=i?n.facts.$store.subscribeAll(()=>{f(()=>n.facts.$store.toObject());}):o&&o.length>0?n.facts.$store.subscribe(o,()=>{f(()=>pickFacts(n,o));}):null,y=i?Object.keys(n.derive??{}):u??[],S=()=>{let M={};for(let v of y)M[v]=n.read(v);return M},[p,b]=createSignal(S()),A=y.length>0?n.subscribe(y,()=>{b(S);}):null;onCleanup(()=>{d?.(),A?.();});let R=n.events;return {system:n,facts:c,derived:p,events:R,dispatch:M=>n.dispatch(M),statusPlugin:r}}function ee(e,t){let[s,r]=createSignal(e.read(t)),n=e.subscribe([t],()=>{r(()=>e.read(t));});return [s,n]}function te(e,t){let[s,r]=createSignal(e.facts.$store.get(t)),n=e.facts.$store.subscribe([t],()=>{r(()=>e.facts.$store.get(t));});return [s,n]}function ne(){return {useFact:(e,t)=>C(e,t),useDerived:(e,t)=>q(e,t),useDispatch:e=>t=>{e.dispatch(t);},useEvents:e=>N(e),useWatch:(e,t,s)=>U(e,t,s)}}function se(e,t,s){let[r,n]=createSignal(s(e)),o=e.subscribe(t,()=>{n(()=>s(e));});return onCleanup(o),r}export{ee as createDerivedSignal,te as createFactSignal,ne as createTypedHooks,J as useConstraintStatus,q as useDerived,Z as useDirective,L as useDispatch,N as useEvents,G as useExplain,C as useFact,Y as useHistory,O as useInspect,se as useNamespacedSelector,Q as useOptimisticUpdate,k as useRequirementStatus,z as useSelector,X as useSuspenseRequirement,U as useWatch};//# sourceMappingURL=index.js.map
1
+ import {createRequirementStatusPlugin,createSystem}from'@directive-run/core';import {defaultEquality,assertSystem,computeInspectState,createThrottle,buildHistoryState,pickFacts,runTrackedSelector,depsChanged}from'@directive-run/core/adapter-utils';export{shallowEqual}from'@directive-run/core/adapter-utils';import {createSignal,onCleanup}from'solid-js';function C(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)?V(e,t):T(e,t)}function T(e,t){process.env.NODE_ENV!=="production"&&(e.facts.$store.has(t)||console.warn(`[Directive] useFact("${t}") \u2014 fact not found in store. Check that "${t}" is defined in your module's schema.`));let[s,r]=createSignal(e.facts.$store.get(t)),n=e.facts.$store.subscribe([t],()=>{r(()=>e.facts.$store.get(t));});return onCleanup(n),s}function V(e,t){let s=()=>{let u={};for(let i of t)u[i]=e.facts.$store.get(i);return u},[r,n]=createSignal(s()),o=e.facts.$store.subscribe(t,()=>{n(s);});return onCleanup(o),r}function q(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)?P(e,t):$(e,t)}function $(e,t){process.env.NODE_ENV!=="production"&&e.read(t)===void 0&&console.warn(`[Directive] useDerived("${t}") returned undefined. Check that "${t}" is defined in your module's derive property.`);let[s,r]=createSignal(e.read(t)),n=e.subscribe([t],()=>{r(()=>e.read(t));});return onCleanup(n),s}function P(e,t){let s=()=>{let u={};for(let i of t)u[i]=e.read(i);return u},[r,n]=createSignal(s()),o=e.subscribe(t,()=>{n(s);});return onCleanup(o),r}function z(e,t,s=defaultEquality){assertSystem("useSelector",e);let r=new Set(Object.keys(e.derive??{})),n=()=>runTrackedSelector(e,r,t),o=n(),u=o.factKeys,i=o.deriveKeys,[c,f]=createSignal(o.value),d=[],y=()=>{for(let p of d)p();d.length=0;let S=()=>{let p=n();f(b=>s(b,p.value)?b:p.value),depsChanged(u,p.factKeys,i,p.deriveKeys)&&(u=p.factKeys,i=p.deriveKeys,y());};u.length>0?d.push(e.facts.$store.subscribe(u,S)):i.length===0&&d.push(e.facts.$store.subscribeAll(S)),i.length>0&&d.push(e.subscribe(i,S));};return y(),onCleanup(()=>{for(let S of d)S();}),c}function L(e){return assertSystem("useDispatch",e),t=>{e.dispatch(t);}}function N(e){return assertSystem("useEvents",e),e.events}function U(e,t,s){assertSystem("useWatch",e);let r=e.watch(t,s);onCleanup(r);}function O(e,t){assertSystem("useInspect",e);let[s,r]=createSignal(computeInspectState(e)),n=()=>{r(computeInspectState(e));};if(t?.throttleMs&&t.throttleMs>0){let{throttled:o,cleanup:u}=createThrottle(n,t.throttleMs),i=e.facts.$store.subscribeAll(o),c=e.onSettledChange(o);onCleanup(()=>{u(),i(),c();});}else {let o=e.facts.$store.subscribeAll(n),u=e.onSettledChange(n);onCleanup(()=>{o(),u();});}return s}function k(e,t){if(Array.isArray(t)){let o=()=>{let f={};for(let d of t)f[d]=e.getStatus(d);return f},[u,i]=createSignal(o()),c=e.subscribe(()=>{i(o);});return onCleanup(c),u}let[s,r]=createSignal(e.getStatus(t)),n=e.subscribe(()=>{r(e.getStatus(t));});return onCleanup(n),s}function Q(e,t){assertSystem("useExplain",e);let[s,r]=createSignal(e.explain(t)),n=()=>r(e.explain(t)),o=e.facts.$store.subscribeAll(n),u=e.onSettledChange(n);return onCleanup(()=>{o(),u();}),s}function G(e,t){assertSystem("useConstraintStatus",e);let s=()=>{let c=e.inspect();return t?c.constraints.find(f=>f.id===t)??null:c.constraints},[r,n]=createSignal(s()),o=()=>n(s),u=e.facts.$store.subscribeAll(o),i=e.onSettledChange(o);return onCleanup(()=>{u(),i();}),r}function J(e,t,s){assertSystem("useOptimisticUpdate",e);let[r,n]=createSignal(false),[o,u]=createSignal(null),i=null,c=null,f=()=>{i&&(e.restore(i),i=null),n(false),u(null),c?.(),c=null;},d=y=>{i=e.getSnapshot(),n(true),u(null),e.batch(y),t&&s&&(c?.(),c=t.subscribe(()=>{let S=t.getStatus(s);!S.isLoading&&!S.hasError?(i=null,n(false),c?.(),c=null):S.hasError&&(u(()=>S.lastError),f());}));};return onCleanup(()=>{c?.();}),{mutate:d,isPending:r,error:o,rollback:f}}function X(e,t){let s=Array.isArray(t)?t:[t],r=()=>s.some(n=>e.getStatus(n).isLoading);if(r())throw new Promise(n=>{let o=e.subscribe(()=>{r()||(o(),n());});});return k(e,t)}function Y(e){assertSystem("useHistory",e);let[t,s]=createSignal(buildHistoryState(e)),r=e.onHistoryChange(()=>s(buildHistoryState(e)));return onCleanup(r),t}function Z(e,t){let s=[...t?.plugins??[]],r;if(t?.status){let M=createRequirementStatusPlugin();r=M,s.push(M.plugin);}let n=createSystem({module:e,plugins:s.length>0?s:void 0,trace:t?.trace,errorBoundary:t?.errorBoundary,tickMs:t?.tickMs,zeroConfig:t?.zeroConfig,initialFacts:t?.initialFacts});typeof window<"u"?n.start():n.initialize(),onCleanup(()=>{n.destroy();});let o=t?.facts,u=t?.derived,i=!o&&!u,[c,f]=createSignal(i?n.facts.$store.toObject():pickFacts(n,o??[])),d=i?n.facts.$store.subscribeAll(()=>{f(()=>n.facts.$store.toObject());}):o&&o.length>0?n.facts.$store.subscribe(o,()=>{f(()=>pickFacts(n,o));}):null,y=i?Object.keys(n.derive??{}):u??[],S=()=>{let M={};for(let v of y)M[v]=n.read(v);return M},[p,b]=createSignal(S()),A=y.length>0?n.subscribe(y,()=>{b(S);}):null;onCleanup(()=>{d?.(),A?.();});let R=n.events;return {system:n,facts:c,derived:p,events:R,dispatch:M=>n.dispatch(M),statusPlugin:r}}function ee(e,t){let[s,r]=createSignal(e.read(t)),n=e.subscribe([t],()=>{r(()=>e.read(t));});return [s,n]}function te(e,t){let[s,r]=createSignal(e.facts.$store.get(t)),n=e.facts.$store.subscribe([t],()=>{r(()=>e.facts.$store.get(t));});return [s,n]}function ne(){return {useFact:(e,t)=>C(e,t),useDerived:(e,t)=>q(e,t),useDispatch:e=>t=>{e.dispatch(t);},useEvents:e=>N(e),useWatch:(e,t,s)=>U(e,t,s)}}function se(e,t,s){let[r,n]=createSignal(s(e)),o=e.subscribe(t,()=>{n(()=>s(e));});return onCleanup(o),r}function re(e){let t=e();return typeof window<"u"&&!t.isRunning&&t.start(),onCleanup(()=>{t.destroy();}),t}export{ee as createDerivedSignal,te as createFactSignal,ne as createTypedHooks,G as useConstraintStatus,q as useDerived,Z as useDirective,L as useDispatch,N as useEvents,Q as useExplain,C as useFact,Y as useHistory,O as useInspect,se as useNamespacedSelector,J as useOptimisticUpdate,re as useQuerySystem,k as useRequirementStatus,z as useSelector,X as useSuspenseRequirement,U as useWatch};//# sourceMappingURL=index.js.map
2
2
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts"],"names":["useFact","system","keyOrKeys","assertSystem","_useFactMulti","_useFactSingle","factKey","value","setValue","createSignal","unsubscribe","onCleanup","factKeys","getValues","result","key","state","setState","useDerived","idOrIds","_useDerivedMulti","_useDerivedSingle","derivationId","derivationIds","id","useSelector","selector","equalityFn","defaultEquality","deriveKeySet","runWithTracking","runTrackedSelector","initial","trackedFactKeys","trackedDeriveKeys","selected","setSelected","unsubs","resubscribe","unsub","onUpdate","prev","depsChanged","useDispatch","event","useEvents","useWatch","callback","useInspect","options","computeInspectState","update","throttled","cleanup","createThrottle","unsubFacts","unsubSettled","useRequirementStatus","statusPlugin","typeOrTypes","type","status","setStatus","useExplain","requirementId","explanation","setExplanation","useConstraintStatus","constraintId","getVal","inspection","c","useOptimisticUpdate","requirementType","isPending","setIsPending","error","setError","snapshot","statusUnsub","rollback","mutate","updateFn","useSuspenseRequirement","types","anyLoading","t","resolve","useHistory","buildHistoryState","useDirective","moduleDef","config","allPlugins","sp","createRequirementStatusPlugin","createSystem","derivedKeys","subscribeAll","factsState","setFactsState","pickFacts","allDerivationKeys","getDerived","derivedState","setDerivedState","unsubDerived","events","createDerivedSignal","createFactSignal","createTypedHooks","useNamespacedSelector","keys"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Solid Adapter - Consolidated SolidJS primitives for Directive\n *\n * 16 active exports: useFact, useDerived, useDispatch, useSelector,\n * useWatch, useInspect, useRequirementStatus, useEvents, useExplain,\n * useConstraintStatus, useOptimisticUpdate, useDirective, useHistory,\n * createTypedHooks, useSuspenseRequirement, shallowEqual\n *\n * Signal factories: createDerivedSignal, createFactSignal\n */\n\nimport type {\n TraceOption,\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} 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 pickFacts,\n runTrackedSelector,\n shallowEqual,\n} from \"@directive-run/core/adapter-utils\";\nimport { type Accessor, createSignal, onCleanup } from \"solid-js\";\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// 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>(\n system: SingleModuleSystem<S>,\n factKey: K,\n): Accessor<InferFacts<S>[K] | undefined>;\n/** Multi-key overload */\nexport function useFact<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(\n system: SingleModuleSystem<S>,\n factKeys: K[],\n): Accessor<Pick<InferFacts<S>, K>>;\n/** Implementation */\nexport function useFact(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n keyOrKeys: string | string[],\n): Accessor<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\n if (Array.isArray(keyOrKeys)) {\n return _useFactMulti(system, keyOrKeys);\n }\n\n // Single key path\n return _useFactSingle(system, keyOrKeys);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactSingle(\n system: SingleModuleSystem<any>,\n factKey: string,\n): Accessor<unknown> {\n if (process.env.NODE_ENV !== \"production\") {\n if (!system.facts.$store.has(factKey)) {\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 [value, setValue] = createSignal(system.facts.$store.get(factKey));\n const unsubscribe = system.facts.$store.subscribe([factKey], () => {\n setValue(() => system.facts.$store.get(factKey));\n });\n onCleanup(unsubscribe);\n return value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactMulti(\n system: SingleModuleSystem<any>,\n factKeys: string[],\n): Accessor<Record<string, unknown>> {\n const getValues = (): Record<string, unknown> => {\n const result: Record<string, unknown> = {};\n for (const key of factKeys) {\n result[key] = system.facts.$store.get(key);\n }\n return result;\n };\n const [state, setState] = createSignal(getValues());\n const unsubscribe = system.facts.$store.subscribe(factKeys, () => {\n setState(getValues);\n });\n onCleanup(unsubscribe);\n return state;\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>(\n system: SingleModuleSystem<S>,\n derivationId: K,\n): Accessor<InferDerivations<S>[K]>;\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): Accessor<Pick<InferDerivations<S>, K>>;\n/** Implementation */\nexport function useDerived(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n idOrIds: string | string[],\n): Accessor<unknown> {\n assertSystem(\"useDerived\", system);\n if (process.env.NODE_ENV !== \"production\" && typeof idOrIds === \"function\") {\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(idOrIds)) {\n return _useDerivedMulti(system, idOrIds);\n }\n\n // Single key path\n return _useDerivedSingle(system, idOrIds);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedSingle(\n system: SingleModuleSystem<any>,\n derivationId: string,\n): Accessor<unknown> {\n if (process.env.NODE_ENV !== \"production\") {\n const initialValue = system.read(derivationId);\n if (initialValue === undefined) {\n console.warn(\n `[Directive] useDerived(\"${derivationId}\") returned undefined. ` +\n `Check that \"${derivationId}\" is defined in your module's derive property.`,\n );\n }\n }\n const [value, setValue] = createSignal(system.read(derivationId));\n const unsubscribe = system.subscribe([derivationId], () => {\n setValue(() => system.read(derivationId));\n });\n onCleanup(unsubscribe);\n return value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedMulti(\n system: SingleModuleSystem<any>,\n derivationIds: string[],\n): Accessor<Record<string, unknown>> {\n const getValues = (): Record<string, unknown> => {\n const result: Record<string, unknown> = {};\n for (const id of derivationIds) {\n result[id] = system.read(id);\n }\n return result;\n };\n const [state, setState] = createSignal(getValues());\n const unsubscribe = system.subscribe(derivationIds, () => {\n setState(getValues);\n });\n onCleanup(unsubscribe);\n return state;\n}\n\n// ============================================================================\n// useSelector — auto-tracking selector over facts and derivations\n// ============================================================================\n\n/**\n * Auto-tracking selector over facts and derivations.\n * Uses `withTracking()` to detect which facts the selector accesses,\n * then subscribes only to those keys.\n */\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S>,\n selector: (state: InferSelectorState<S>) => R,\n equalityFn?: (a: R, b: R) => boolean,\n): Accessor<R>;\nexport function useSelector(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n selector: (state: any) => unknown,\n equalityFn: (a: unknown, b: unknown) => boolean = defaultEquality,\n): Accessor<unknown> {\n assertSystem(\"useSelector\", system);\n const deriveKeySet = new Set(Object.keys(system.derive ?? {}));\n\n // Build a tracking-aware state proxy that exposes both facts and derivations\n const runWithTracking = () =>\n runTrackedSelector(system, deriveKeySet, selector);\n\n const initial = runWithTracking();\n let trackedFactKeys = initial.factKeys;\n let trackedDeriveKeys = initial.deriveKeys;\n const [selected, setSelected] = createSignal(initial.value);\n\n const unsubs: Array<() => void> = [];\n\n const resubscribe = () => {\n for (const unsub of unsubs) unsub();\n unsubs.length = 0;\n\n const onUpdate = () => {\n const result = runWithTracking();\n setSelected((prev) => {\n if (!equalityFn(prev, result.value)) return result.value;\n return prev;\n });\n // Re-track: check if deps changed\n if (\n depsChanged(\n trackedFactKeys,\n result.factKeys,\n trackedDeriveKeys,\n result.deriveKeys,\n )\n ) {\n trackedFactKeys = result.factKeys;\n trackedDeriveKeys = result.deriveKeys;\n resubscribe();\n }\n };\n\n if (trackedFactKeys.length > 0) {\n unsubs.push(system.facts.$store.subscribe(trackedFactKeys, onUpdate));\n } else if (trackedDeriveKeys.length === 0) {\n unsubs.push(system.facts.$store.subscribeAll(onUpdate));\n }\n if (trackedDeriveKeys.length > 0) {\n unsubs.push(system.subscribe(trackedDeriveKeys, onUpdate));\n }\n };\n\n resubscribe();\n\n onCleanup(() => {\n for (const unsub of unsubs) unsub();\n });\n\n return selected;\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 (event: InferEvents<S>) => {\n system.dispatch(event);\n };\n}\n\n// ============================================================================\n// useEvents — memoized events reference\n// ============================================================================\n\n/**\n * Returns the system's events dispatcher.\n */\nexport function useEvents<S extends ModuleSchema>(\n system: SingleModuleSystem<S>,\n): SingleModuleSystem<S>[\"events\"] {\n assertSystem(\"useEvents\", system);\n return system.events;\n}\n\n// ============================================================================\n// useWatch — derivation or fact side-effect\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 previousValue: 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 previousValue: InferFacts<S>[K] | undefined,\n ) => void,\n): void;\n/** Implementation */\nexport function useWatch(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n key: string,\n callback: (newValue: unknown, prevValue: unknown) => void,\n): void {\n assertSystem(\"useWatch\", system);\n\n const unsubscribe = system.watch(key, callback);\n onCleanup(unsubscribe);\n}\n\n// ============================================================================\n// useInspect — consolidated inspection hook\n// ============================================================================\n\n/** Options for useInspect */\nexport interface UseInspectOptions {\n throttleMs?: number;\n}\n\n/**\n * Consolidated system inspection hook.\n * Returns Accessor<InspectState> with optional throttling.\n */\nexport function useInspect(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n options?: UseInspectOptions,\n): Accessor<InspectState> {\n assertSystem(\"useInspect\", system);\n const [state, setState] = createSignal<InspectState>(\n computeInspectState(system),\n );\n\n const update = () => {\n setState(computeInspectState(system));\n };\n\n if (options?.throttleMs && options.throttleMs > 0) {\n const { throttled, cleanup } = createThrottle(update, options.throttleMs);\n const unsubFacts = system.facts.$store.subscribeAll(throttled);\n const unsubSettled = system.onSettledChange(throttled);\n onCleanup(() => {\n cleanup();\n unsubFacts();\n unsubSettled();\n });\n } else {\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onCleanup(() => {\n unsubFacts();\n unsubSettled();\n });\n }\n\n return state;\n}\n\n// ============================================================================\n// useRequirementStatus — single or multi\n// ============================================================================\n\n/** Single type overload */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n type: string,\n): Accessor<RequirementTypeStatus>;\n/** Multi-type overload */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n types: string[],\n): Accessor<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n typeOrTypes: string | string[],\n):\n | Accessor<RequirementTypeStatus>\n | Accessor<Record<string, RequirementTypeStatus>> {\n if (Array.isArray(typeOrTypes)) {\n const getValues = (): Record<string, RequirementTypeStatus> => {\n const result: Record<string, RequirementTypeStatus> = {};\n for (const type of typeOrTypes) {\n result[type] = statusPlugin.getStatus(type);\n }\n return result;\n };\n const [state, setState] = createSignal(getValues());\n const unsubscribe = statusPlugin.subscribe(() => {\n setState(getValues);\n });\n onCleanup(unsubscribe);\n return state;\n }\n\n const [status, setStatus] = createSignal<RequirementTypeStatus>(\n statusPlugin.getStatus(typeOrTypes),\n );\n const unsubscribe = statusPlugin.subscribe(() => {\n setStatus(statusPlugin.getStatus(typeOrTypes));\n });\n onCleanup(unsubscribe);\n return status;\n}\n\n// ============================================================================\n// useExplain — reactive requirement explanation\n// ============================================================================\n\n/**\n * Reactively returns the explanation string for a requirement.\n */\nexport function useExplain(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n requirementId: string,\n): Accessor<string | null> {\n assertSystem(\"useExplain\", system);\n const [explanation, setExplanation] = createSignal<string | null>(\n system.explain(requirementId),\n );\n\n const update = () => setExplanation(system.explain(requirementId));\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onCleanup(() => {\n unsubFacts();\n unsubSettled();\n });\n\n return explanation;\n}\n\n// ============================================================================\n// useConstraintStatus — reactive constraint inspection\n// ============================================================================\n\n/** Get all constraints */\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n): Accessor<ConstraintInfo[]>;\n/** Get a single constraint by ID */\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n constraintId: string,\n): Accessor<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): Accessor<ConstraintInfo[] | ConstraintInfo | null> {\n assertSystem(\"useConstraintStatus\", system);\n const getVal = () => {\n const inspection = system.inspect();\n if (!constraintId) return inspection.constraints;\n return (\n inspection.constraints.find(\n (c: ConstraintInfo) => c.id === constraintId,\n ) ?? null\n );\n };\n\n const [state, setState] = createSignal<\n ConstraintInfo[] | ConstraintInfo | null\n >(getVal());\n\n const update = () => setState(getVal);\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onCleanup(() => {\n unsubFacts();\n unsubSettled();\n });\n\n return state;\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\nexport interface OptimisticUpdateResult {\n mutate: (updateFn: () => void) => void;\n isPending: Accessor<boolean>;\n error: Accessor<Error | null>;\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 */\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] = createSignal(false);\n const [error, setError] = createSignal<Error | null>(null);\n let snapshot: SystemSnapshot | null = null;\n let statusUnsub: (() => void) | null = null;\n\n const rollback = () => {\n if (snapshot) {\n system.restore(snapshot);\n snapshot = null;\n }\n setIsPending(false);\n setError(null);\n statusUnsub?.();\n statusUnsub = null;\n };\n\n const mutate = (updateFn: () => void) => {\n snapshot = system.getSnapshot();\n setIsPending(true);\n setError(null);\n system.batch(updateFn);\n\n if (statusPlugin && requirementType) {\n statusUnsub?.();\n statusUnsub = statusPlugin.subscribe(() => {\n const status = statusPlugin.getStatus(requirementType);\n if (!status.isLoading && !status.hasError) {\n snapshot = null;\n setIsPending(false);\n statusUnsub?.();\n statusUnsub = null;\n } else if (status.hasError) {\n setError(() => status.lastError);\n rollback();\n }\n });\n }\n };\n\n onCleanup(() => {\n statusUnsub?.();\n });\n\n return { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// useSuspenseRequirement — Solid-specific Suspense integration\n// ============================================================================\n\n/**\n * Single type: throws a promise while the requirement is pending (Suspense).\n */\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n type: string,\n): Accessor<RequirementTypeStatus>;\n/**\n * Multi-type: throws a promise while any of the requirements are pending.\n */\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n types: string[],\n): Accessor<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n typeOrTypes: string | string[],\n):\n | Accessor<RequirementTypeStatus>\n | Accessor<Record<string, RequirementTypeStatus>> {\n const types = Array.isArray(typeOrTypes) ? typeOrTypes : [typeOrTypes];\n\n // Check if any are still loading — if so, throw a promise\n const anyLoading = () =>\n types.some((t) => statusPlugin.getStatus(t).isLoading);\n\n if (anyLoading()) {\n throw new Promise<void>((resolve) => {\n const unsub = statusPlugin.subscribe(() => {\n if (!anyLoading()) {\n unsub();\n resolve();\n }\n });\n });\n }\n\n // Once resolved, return normal accessor\n if (Array.isArray(typeOrTypes)) {\n return useRequirementStatus(statusPlugin, typeOrTypes) as Accessor<\n Record<string, RequirementTypeStatus>\n >;\n }\n return useRequirementStatus(\n statusPlugin,\n typeOrTypes,\n ) as Accessor<RequirementTypeStatus>;\n}\n\n// ============================================================================\n// useHistory — reactive history signal\n// ============================================================================\n\n/**\n * Reactive history signal. Returns an Accessor that updates\n * when snapshots are taken or navigation occurs.\n *\n * @example\n * ```tsx\n * const history = useHistory(system);\n * <button disabled={!history()?.canGoBack} onClick={() => history()?.goBack()}>Undo</button>\n * ```\n */\nexport function useHistory(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n): Accessor<ReturnType<typeof buildHistoryState>> {\n assertSystem(\"useHistory\", system);\n const [state, setState] = createSignal<\n ReturnType<typeof buildHistoryState>\n >(buildHistoryState(system));\n const unsub = system.onHistoryChange(() =>\n setState(buildHistoryState(system)),\n );\n onCleanup(unsub);\n return state;\n}\n\n// ============================================================================\n// Scoped System\n// ============================================================================\n\n/** Configuration for useDirective */\ninterface UseDirectiveConfig {\n // biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n plugins?: Plugin<any>[];\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 status?: boolean;\n /** Fact keys to subscribe to (omit for all) */\n facts?: string[];\n /** Derivation keys to subscribe to (omit for all) */\n derived?: string[];\n}\n\n/**\n * Create a scoped Directive system with automatic lifecycle management.\n * When no `facts` or `derived` keys are specified, subscribes to ALL\n * facts and derivations and returns reactive signals.\n *\n * @example\n * ```tsx\n * // Subscribe to everything\n * const { facts, derived, events, dispatch } = useDirective(counterModule);\n *\n * // Selective keys\n * const { facts, derived } = useDirective(counterModule, { facts: [\"count\"], derived: [\"doubled\"] });\n * ```\n */\nexport function useDirective<M extends ModuleSchema>(\n moduleDef: ModuleDef<M>,\n config?: UseDirectiveConfig,\n) {\n const allPlugins = [...(config?.plugins ?? [])];\n let statusPlugin: StatusPlugin | undefined;\n\n if (config?.status) {\n const sp = createRequirementStatusPlugin();\n statusPlugin = sp;\n // biome-ignore lint/suspicious/noExplicitAny: Plugin generic issues\n allPlugins.push(sp.plugin as Plugin<any>);\n }\n\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n const system = createSystem({\n module: moduleDef,\n plugins: allPlugins.length > 0 ? allPlugins : undefined,\n trace: config?.trace,\n errorBoundary: config?.errorBoundary,\n tickMs: config?.tickMs,\n zeroConfig: config?.zeroConfig,\n initialFacts: config?.initialFacts,\n } as any) as unknown as SingleModuleSystem<M>;\n\n system.start();\n\n onCleanup(() => {\n system.destroy();\n });\n\n const factKeys = config?.facts;\n const derivedKeys = config?.derived;\n const subscribeAll = !factKeys && !derivedKeys;\n\n // Subscribe to facts\n const [factsState, setFactsState] = createSignal(\n subscribeAll\n ? (system.facts.$store.toObject() as InferFacts<M>)\n : (pickFacts(system, factKeys ?? []) as InferFacts<M>),\n );\n const unsubFacts = subscribeAll\n ? system.facts.$store.subscribeAll(() => {\n setFactsState(() => system.facts.$store.toObject() as InferFacts<M>);\n })\n : factKeys && factKeys.length > 0\n ? system.facts.$store.subscribe(factKeys, () => {\n setFactsState(() => pickFacts(system, factKeys) as InferFacts<M>);\n })\n : null;\n\n // Subscribe to derivations\n const allDerivationKeys = subscribeAll\n ? Object.keys(system.derive ?? {})\n : (derivedKeys ?? []);\n const getDerived = (): InferDerivations<M> => {\n const result: Record<string, unknown> = {};\n for (const key of allDerivationKeys) {\n result[key] = system.read(key);\n }\n return result as InferDerivations<M>;\n };\n const [derivedState, setDerivedState] = createSignal(getDerived());\n const unsubDerived =\n allDerivationKeys.length > 0\n ? system.subscribe(allDerivationKeys, () => {\n setDerivedState(getDerived);\n })\n : null;\n\n onCleanup(() => {\n unsubFacts?.();\n unsubDerived?.();\n });\n\n const events = system.events;\n const dispatch = (event: InferEvents<M>) => system.dispatch(event);\n\n return {\n system,\n facts: factsState as Accessor<InferFacts<M>>,\n derived: derivedState as Accessor<InferDerivations<M>>,\n events,\n dispatch,\n statusPlugin,\n };\n}\n\n// ============================================================================\n// Signal Factories (for use outside components)\n// ============================================================================\n\n/**\n * Create a derivation signal outside of a component.\n */\nexport function createDerivedSignal<T>(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n derivationId: string,\n): [Accessor<T>, () => void] {\n const [value, setValue] = createSignal<T>(system.read(derivationId) as T);\n const unsubscribe = system.subscribe([derivationId], () => {\n setValue(() => system.read(derivationId) as T);\n });\n return [value, unsubscribe];\n}\n\n/**\n * Create a fact signal outside of a component.\n */\nexport function createFactSignal<T>(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n factKey: string,\n): [Accessor<T | undefined>, () => void] {\n const [value, setValue] = createSignal<T | undefined>(\n system.facts.$store.get(factKey) as T | undefined,\n );\n const unsubscribe = system.facts.$store.subscribe([factKey], () => {\n setValue(() => system.facts.$store.get(factKey) as T | undefined);\n });\n return [value, unsubscribe];\n}\n\n// ============================================================================\n// Typed Hooks Factory\n// ============================================================================\n\nexport function createTypedHooks<M extends ModuleSchema>(): {\n useFact: <K extends keyof InferFacts<M> & string>(\n system: SingleModuleSystem<M>,\n factKey: K,\n ) => Accessor<InferFacts<M>[K] | undefined>;\n useDerived: <K extends keyof InferDerivations<M> & string>(\n system: SingleModuleSystem<M>,\n derivationId: K,\n ) => Accessor<InferDerivations<M>[K]>;\n useDispatch: (\n system: SingleModuleSystem<M>,\n ) => (event: InferEvents<M>) => void;\n useEvents: (system: SingleModuleSystem<M>) => SingleModuleSystem<M>[\"events\"];\n useWatch: <K extends string>(\n system: SingleModuleSystem<M>,\n key: K,\n callback: (newValue: unknown, previousValue: unknown) => void,\n ) => void;\n} {\n return {\n useFact: <K extends keyof InferFacts<M> & string>(\n system: SingleModuleSystem<M>,\n factKey: K,\n ) =>\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n useFact(system as SingleModuleSystem<any>, factKey as string) as Accessor<\n InferFacts<M>[K] | undefined\n >,\n useDerived: <K extends keyof InferDerivations<M> & string>(\n system: SingleModuleSystem<M>,\n derivationId: K,\n ) =>\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n useDerived(\n system as SingleModuleSystem<any>,\n derivationId as string,\n ) as Accessor<InferDerivations<M>[K]>,\n useDispatch: (system: SingleModuleSystem<M>) => {\n return (event: InferEvents<M>) => {\n system.dispatch(event);\n };\n },\n useEvents: (system: SingleModuleSystem<M>) => useEvents<M>(system),\n useWatch: <K extends string>(\n system: SingleModuleSystem<M>,\n key: K,\n callback: (newValue: unknown, previousValue: unknown) => void,\n ) =>\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n useWatch(system as SingleModuleSystem<any>, key, callback),\n };\n}\n\n// ============================================================================\n// useNamespacedSelector — select from a NamespacedSystem\n// ============================================================================\n\n/**\n * SolidJS accessor that selects from a NamespacedSystem.\n * Subscribes to specified keys and provides reactive updates.\n *\n * @param system - The namespaced system\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 token = useNamespacedSelector(system, [\"auth.token\"], (s) => s.facts.auth.token);\n * ```\n */\nexport function useNamespacedSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n keys: string[],\n selector: (system: NamespacedSystem<Modules>) => R,\n): Accessor<R> {\n const [value, setValue] = createSignal<R>(selector(system));\n const unsubscribe = system.subscribe(keys, () => {\n setValue(() => selector(system));\n });\n onCleanup(unsubscribe);\n\n return value as Accessor<R>;\n}\n"]}
1
+ {"version":3,"sources":["../src/index.ts"],"names":["useFact","system","keyOrKeys","assertSystem","_useFactMulti","_useFactSingle","factKey","value","setValue","createSignal","unsubscribe","onCleanup","factKeys","getValues","result","key","state","setState","useDerived","idOrIds","_useDerivedMulti","_useDerivedSingle","derivationId","derivationIds","id","useSelector","selector","equalityFn","defaultEquality","deriveKeySet","runWithTracking","runTrackedSelector","initial","trackedFactKeys","trackedDeriveKeys","selected","setSelected","unsubs","resubscribe","unsub","onUpdate","prev","depsChanged","useDispatch","event","useEvents","useWatch","callback","useInspect","options","computeInspectState","update","throttled","cleanup","createThrottle","unsubFacts","unsubSettled","useRequirementStatus","statusPlugin","typeOrTypes","type","status","setStatus","useExplain","requirementId","explanation","setExplanation","useConstraintStatus","constraintId","getVal","inspection","c","useOptimisticUpdate","requirementType","isPending","setIsPending","error","setError","snapshot","statusUnsub","rollback","mutate","updateFn","useSuspenseRequirement","types","anyLoading","t","resolve","useHistory","buildHistoryState","useDirective","moduleDef","config","allPlugins","sp","createRequirementStatusPlugin","createSystem","derivedKeys","subscribeAll","factsState","setFactsState","pickFacts","allDerivationKeys","getDerived","derivedState","setDerivedState","unsubDerived","events","createDerivedSignal","createFactSignal","createTypedHooks","useNamespacedSelector","keys","useQuerySystem","factory"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Solid Adapter - Consolidated SolidJS primitives for Directive\n *\n * 16 active exports: useFact, useDerived, useDispatch, useSelector,\n * useWatch, useInspect, useRequirementStatus, useEvents, useExplain,\n * useConstraintStatus, useOptimisticUpdate, useDirective, useHistory,\n * createTypedHooks, useSuspenseRequirement, shallowEqual\n *\n * Signal factories: createDerivedSignal, createFactSignal\n */\n\nimport type {\n TraceOption,\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} 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 pickFacts,\n runTrackedSelector,\n shallowEqual,\n} from \"@directive-run/core/adapter-utils\";\nimport { type Accessor, createSignal, onCleanup } from \"solid-js\";\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// 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>(\n system: SingleModuleSystem<S>,\n factKey: K,\n): Accessor<InferFacts<S>[K] | undefined>;\n/** Multi-key overload */\nexport function useFact<\n S extends ModuleSchema,\n K extends keyof InferFacts<S> & string,\n>(\n system: SingleModuleSystem<S>,\n factKeys: K[],\n): Accessor<Pick<InferFacts<S>, K>>;\n/** Implementation */\nexport function useFact(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n keyOrKeys: string | string[],\n): Accessor<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\n if (Array.isArray(keyOrKeys)) {\n return _useFactMulti(system, keyOrKeys);\n }\n\n // Single key path\n return _useFactSingle(system, keyOrKeys);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactSingle(\n system: SingleModuleSystem<any>,\n factKey: string,\n): Accessor<unknown> {\n if (process.env.NODE_ENV !== \"production\") {\n if (!system.facts.$store.has(factKey)) {\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 [value, setValue] = createSignal(system.facts.$store.get(factKey));\n const unsubscribe = system.facts.$store.subscribe([factKey], () => {\n setValue(() => system.facts.$store.get(factKey));\n });\n onCleanup(unsubscribe);\n return value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactMulti(\n system: SingleModuleSystem<any>,\n factKeys: string[],\n): Accessor<Record<string, unknown>> {\n const getValues = (): Record<string, unknown> => {\n const result: Record<string, unknown> = {};\n for (const key of factKeys) {\n result[key] = system.facts.$store.get(key);\n }\n return result;\n };\n const [state, setState] = createSignal(getValues());\n const unsubscribe = system.facts.$store.subscribe(factKeys, () => {\n setState(getValues);\n });\n onCleanup(unsubscribe);\n return state;\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>(\n system: SingleModuleSystem<S>,\n derivationId: K,\n): Accessor<InferDerivations<S>[K]>;\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): Accessor<Pick<InferDerivations<S>, K>>;\n/** Implementation */\nexport function useDerived(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n idOrIds: string | string[],\n): Accessor<unknown> {\n assertSystem(\"useDerived\", system);\n if (process.env.NODE_ENV !== \"production\" && typeof idOrIds === \"function\") {\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(idOrIds)) {\n return _useDerivedMulti(system, idOrIds);\n }\n\n // Single key path\n return _useDerivedSingle(system, idOrIds);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedSingle(\n system: SingleModuleSystem<any>,\n derivationId: string,\n): Accessor<unknown> {\n if (process.env.NODE_ENV !== \"production\") {\n const initialValue = system.read(derivationId);\n if (initialValue === undefined) {\n console.warn(\n `[Directive] useDerived(\"${derivationId}\") returned undefined. ` +\n `Check that \"${derivationId}\" is defined in your module's derive property.`,\n );\n }\n }\n const [value, setValue] = createSignal(system.read(derivationId));\n const unsubscribe = system.subscribe([derivationId], () => {\n setValue(() => system.read(derivationId));\n });\n onCleanup(unsubscribe);\n return value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedMulti(\n system: SingleModuleSystem<any>,\n derivationIds: string[],\n): Accessor<Record<string, unknown>> {\n const getValues = (): Record<string, unknown> => {\n const result: Record<string, unknown> = {};\n for (const id of derivationIds) {\n result[id] = system.read(id);\n }\n return result;\n };\n const [state, setState] = createSignal(getValues());\n const unsubscribe = system.subscribe(derivationIds, () => {\n setState(getValues);\n });\n onCleanup(unsubscribe);\n return state;\n}\n\n// ============================================================================\n// useSelector — auto-tracking selector over facts and derivations\n// ============================================================================\n\n/**\n * Auto-tracking selector over facts and derivations.\n * Uses `withTracking()` to detect which facts the selector accesses,\n * then subscribes only to those keys.\n */\nexport function useSelector<S extends ModuleSchema, R>(\n system: SingleModuleSystem<S>,\n selector: (state: InferSelectorState<S>) => R,\n equalityFn?: (a: R, b: R) => boolean,\n): Accessor<R>;\nexport function useSelector(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n selector: (state: any) => unknown,\n equalityFn: (a: unknown, b: unknown) => boolean = defaultEquality,\n): Accessor<unknown> {\n assertSystem(\"useSelector\", system);\n const deriveKeySet = new Set(Object.keys(system.derive ?? {}));\n\n // Build a tracking-aware state proxy that exposes both facts and derivations\n const runWithTracking = () =>\n runTrackedSelector(system, deriveKeySet, selector);\n\n const initial = runWithTracking();\n let trackedFactKeys = initial.factKeys;\n let trackedDeriveKeys = initial.deriveKeys;\n const [selected, setSelected] = createSignal(initial.value);\n\n const unsubs: Array<() => void> = [];\n\n const resubscribe = () => {\n for (const unsub of unsubs) unsub();\n unsubs.length = 0;\n\n const onUpdate = () => {\n const result = runWithTracking();\n setSelected((prev) => {\n if (!equalityFn(prev, result.value)) return result.value;\n return prev;\n });\n // Re-track: check if deps changed\n if (\n depsChanged(\n trackedFactKeys,\n result.factKeys,\n trackedDeriveKeys,\n result.deriveKeys,\n )\n ) {\n trackedFactKeys = result.factKeys;\n trackedDeriveKeys = result.deriveKeys;\n resubscribe();\n }\n };\n\n if (trackedFactKeys.length > 0) {\n unsubs.push(system.facts.$store.subscribe(trackedFactKeys, onUpdate));\n } else if (trackedDeriveKeys.length === 0) {\n unsubs.push(system.facts.$store.subscribeAll(onUpdate));\n }\n if (trackedDeriveKeys.length > 0) {\n unsubs.push(system.subscribe(trackedDeriveKeys, onUpdate));\n }\n };\n\n resubscribe();\n\n onCleanup(() => {\n for (const unsub of unsubs) unsub();\n });\n\n return selected;\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 (event: InferEvents<S>) => {\n system.dispatch(event);\n };\n}\n\n// ============================================================================\n// useEvents — memoized events reference\n// ============================================================================\n\n/**\n * Returns the system's events dispatcher.\n */\nexport function useEvents<S extends ModuleSchema>(\n system: SingleModuleSystem<S>,\n): SingleModuleSystem<S>[\"events\"] {\n assertSystem(\"useEvents\", system);\n return system.events;\n}\n\n// ============================================================================\n// useWatch — derivation or fact side-effect\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 previousValue: 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 previousValue: InferFacts<S>[K] | undefined,\n ) => void,\n): void;\n/** Implementation */\nexport function useWatch(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n key: string,\n callback: (newValue: unknown, prevValue: unknown) => void,\n): void {\n assertSystem(\"useWatch\", system);\n\n const unsubscribe = system.watch(key, callback);\n onCleanup(unsubscribe);\n}\n\n// ============================================================================\n// useInspect — consolidated inspection hook\n// ============================================================================\n\n/** Options for useInspect */\nexport interface UseInspectOptions {\n throttleMs?: number;\n}\n\n/**\n * Consolidated system inspection hook.\n * Returns Accessor<InspectState> with optional throttling.\n */\nexport function useInspect(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n options?: UseInspectOptions,\n): Accessor<InspectState> {\n assertSystem(\"useInspect\", system);\n const [state, setState] = createSignal<InspectState>(\n computeInspectState(system),\n );\n\n const update = () => {\n setState(computeInspectState(system));\n };\n\n if (options?.throttleMs && options.throttleMs > 0) {\n const { throttled, cleanup } = createThrottle(update, options.throttleMs);\n const unsubFacts = system.facts.$store.subscribeAll(throttled);\n const unsubSettled = system.onSettledChange(throttled);\n onCleanup(() => {\n cleanup();\n unsubFacts();\n unsubSettled();\n });\n } else {\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onCleanup(() => {\n unsubFacts();\n unsubSettled();\n });\n }\n\n return state;\n}\n\n// ============================================================================\n// useRequirementStatus — single or multi\n// ============================================================================\n\n/** Single type overload */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n type: string,\n): Accessor<RequirementTypeStatus>;\n/** Multi-type overload */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n types: string[],\n): Accessor<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n typeOrTypes: string | string[],\n):\n | Accessor<RequirementTypeStatus>\n | Accessor<Record<string, RequirementTypeStatus>> {\n if (Array.isArray(typeOrTypes)) {\n const getValues = (): Record<string, RequirementTypeStatus> => {\n const result: Record<string, RequirementTypeStatus> = {};\n for (const type of typeOrTypes) {\n result[type] = statusPlugin.getStatus(type);\n }\n return result;\n };\n const [state, setState] = createSignal(getValues());\n const unsubscribe = statusPlugin.subscribe(() => {\n setState(getValues);\n });\n onCleanup(unsubscribe);\n return state;\n }\n\n const [status, setStatus] = createSignal<RequirementTypeStatus>(\n statusPlugin.getStatus(typeOrTypes),\n );\n const unsubscribe = statusPlugin.subscribe(() => {\n setStatus(statusPlugin.getStatus(typeOrTypes));\n });\n onCleanup(unsubscribe);\n return status;\n}\n\n// ============================================================================\n// useExplain — reactive requirement explanation\n// ============================================================================\n\n/**\n * Reactively returns the explanation string for a requirement.\n */\nexport function useExplain(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n requirementId: string,\n): Accessor<string | null> {\n assertSystem(\"useExplain\", system);\n const [explanation, setExplanation] = createSignal<string | null>(\n system.explain(requirementId),\n );\n\n const update = () => setExplanation(system.explain(requirementId));\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onCleanup(() => {\n unsubFacts();\n unsubSettled();\n });\n\n return explanation;\n}\n\n// ============================================================================\n// useConstraintStatus — reactive constraint inspection\n// ============================================================================\n\n/** Get all constraints */\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n): Accessor<ConstraintInfo[]>;\n/** Get a single constraint by ID */\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n constraintId: string,\n): Accessor<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): Accessor<ConstraintInfo[] | ConstraintInfo | null> {\n assertSystem(\"useConstraintStatus\", system);\n const getVal = () => {\n const inspection = system.inspect();\n if (!constraintId) return inspection.constraints;\n return (\n inspection.constraints.find(\n (c: ConstraintInfo) => c.id === constraintId,\n ) ?? null\n );\n };\n\n const [state, setState] = createSignal<\n ConstraintInfo[] | ConstraintInfo | null\n >(getVal());\n\n const update = () => setState(getVal);\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onCleanup(() => {\n unsubFacts();\n unsubSettled();\n });\n\n return state;\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\nexport interface OptimisticUpdateResult {\n mutate: (updateFn: () => void) => void;\n isPending: Accessor<boolean>;\n error: Accessor<Error | null>;\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 */\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] = createSignal(false);\n const [error, setError] = createSignal<Error | null>(null);\n let snapshot: SystemSnapshot | null = null;\n let statusUnsub: (() => void) | null = null;\n\n const rollback = () => {\n if (snapshot) {\n system.restore(snapshot);\n snapshot = null;\n }\n setIsPending(false);\n setError(null);\n statusUnsub?.();\n statusUnsub = null;\n };\n\n const mutate = (updateFn: () => void) => {\n snapshot = system.getSnapshot();\n setIsPending(true);\n setError(null);\n system.batch(updateFn);\n\n if (statusPlugin && requirementType) {\n statusUnsub?.();\n statusUnsub = statusPlugin.subscribe(() => {\n const status = statusPlugin.getStatus(requirementType);\n if (!status.isLoading && !status.hasError) {\n snapshot = null;\n setIsPending(false);\n statusUnsub?.();\n statusUnsub = null;\n } else if (status.hasError) {\n setError(() => status.lastError);\n rollback();\n }\n });\n }\n };\n\n onCleanup(() => {\n statusUnsub?.();\n });\n\n return { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// useSuspenseRequirement — Solid-specific Suspense integration\n// ============================================================================\n\n/**\n * Single type: throws a promise while the requirement is pending (Suspense).\n */\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n type: string,\n): Accessor<RequirementTypeStatus>;\n/**\n * Multi-type: throws a promise while any of the requirements are pending.\n */\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n types: string[],\n): Accessor<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useSuspenseRequirement(\n statusPlugin: StatusPlugin,\n typeOrTypes: string | string[],\n):\n | Accessor<RequirementTypeStatus>\n | Accessor<Record<string, RequirementTypeStatus>> {\n const types = Array.isArray(typeOrTypes) ? typeOrTypes : [typeOrTypes];\n\n // Check if any are still loading — if so, throw a promise\n const anyLoading = () =>\n types.some((t) => statusPlugin.getStatus(t).isLoading);\n\n if (anyLoading()) {\n throw new Promise<void>((resolve) => {\n const unsub = statusPlugin.subscribe(() => {\n if (!anyLoading()) {\n unsub();\n resolve();\n }\n });\n });\n }\n\n // Once resolved, return normal accessor\n if (Array.isArray(typeOrTypes)) {\n return useRequirementStatus(statusPlugin, typeOrTypes) as Accessor<\n Record<string, RequirementTypeStatus>\n >;\n }\n return useRequirementStatus(\n statusPlugin,\n typeOrTypes,\n ) as Accessor<RequirementTypeStatus>;\n}\n\n// ============================================================================\n// useHistory — reactive history signal\n// ============================================================================\n\n/**\n * Reactive history signal. Returns an Accessor that updates\n * when snapshots are taken or navigation occurs.\n *\n * @example\n * ```tsx\n * const history = useHistory(system);\n * <button disabled={!history()?.canGoBack} onClick={() => history()?.goBack()}>Undo</button>\n * ```\n */\nexport function useHistory(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n): Accessor<ReturnType<typeof buildHistoryState>> {\n assertSystem(\"useHistory\", system);\n const [state, setState] = createSignal<\n ReturnType<typeof buildHistoryState>\n >(buildHistoryState(system));\n const unsub = system.onHistoryChange(() =>\n setState(buildHistoryState(system)),\n );\n onCleanup(unsub);\n return state;\n}\n\n// ============================================================================\n// Scoped System\n// ============================================================================\n\n/** Configuration for useDirective */\ninterface UseDirectiveConfig {\n // biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n plugins?: Plugin<any>[];\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 status?: boolean;\n /** Fact keys to subscribe to (omit for all) */\n facts?: string[];\n /** Derivation keys to subscribe to (omit for all) */\n derived?: string[];\n}\n\n/**\n * Create a scoped Directive system with automatic lifecycle management.\n * When no `facts` or `derived` keys are specified, subscribes to ALL\n * facts and derivations and returns reactive signals.\n *\n * @example\n * ```tsx\n * // Subscribe to everything\n * const { facts, derived, events, dispatch } = useDirective(counterModule);\n *\n * // Selective keys\n * const { facts, derived } = useDirective(counterModule, { facts: [\"count\"], derived: [\"doubled\"] });\n * ```\n */\nexport function useDirective<M extends ModuleSchema>(\n moduleDef: ModuleDef<M>,\n config?: UseDirectiveConfig,\n) {\n const allPlugins = [...(config?.plugins ?? [])];\n let statusPlugin: StatusPlugin | undefined;\n\n if (config?.status) {\n const sp = createRequirementStatusPlugin();\n statusPlugin = sp;\n // biome-ignore lint/suspicious/noExplicitAny: Plugin generic issues\n allPlugins.push(sp.plugin as Plugin<any>);\n }\n\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n const system = createSystem({\n module: moduleDef,\n plugins: allPlugins.length > 0 ? allPlugins : undefined,\n trace: config?.trace,\n errorBoundary: config?.errorBoundary,\n tickMs: config?.tickMs,\n zeroConfig: config?.zeroConfig,\n initialFacts: config?.initialFacts,\n } as any) as unknown as SingleModuleSystem<M>;\n\n // SSR guard: initialize facts for SSR rendering, start reconciliation only in the browser\n if (typeof window !== \"undefined\") {\n system.start();\n } else {\n system.initialize();\n }\n\n onCleanup(() => {\n system.destroy();\n });\n\n const factKeys = config?.facts;\n const derivedKeys = config?.derived;\n const subscribeAll = !factKeys && !derivedKeys;\n\n // Subscribe to facts\n const [factsState, setFactsState] = createSignal(\n subscribeAll\n ? (system.facts.$store.toObject() as InferFacts<M>)\n : (pickFacts(system, factKeys ?? []) as InferFacts<M>),\n );\n const unsubFacts = subscribeAll\n ? system.facts.$store.subscribeAll(() => {\n setFactsState(() => system.facts.$store.toObject() as InferFacts<M>);\n })\n : factKeys && factKeys.length > 0\n ? system.facts.$store.subscribe(factKeys, () => {\n setFactsState(() => pickFacts(system, factKeys) as InferFacts<M>);\n })\n : null;\n\n // Subscribe to derivations\n const allDerivationKeys = subscribeAll\n ? Object.keys(system.derive ?? {})\n : (derivedKeys ?? []);\n const getDerived = (): InferDerivations<M> => {\n const result: Record<string, unknown> = {};\n for (const key of allDerivationKeys) {\n result[key] = system.read(key);\n }\n return result as InferDerivations<M>;\n };\n const [derivedState, setDerivedState] = createSignal(getDerived());\n const unsubDerived =\n allDerivationKeys.length > 0\n ? system.subscribe(allDerivationKeys, () => {\n setDerivedState(getDerived);\n })\n : null;\n\n onCleanup(() => {\n unsubFacts?.();\n unsubDerived?.();\n });\n\n const events = system.events;\n const dispatch = (event: InferEvents<M>) => system.dispatch(event);\n\n return {\n system,\n facts: factsState as Accessor<InferFacts<M>>,\n derived: derivedState as Accessor<InferDerivations<M>>,\n events,\n dispatch,\n statusPlugin,\n };\n}\n\n// ============================================================================\n// Signal Factories (for use outside components)\n// ============================================================================\n\n/**\n * Create a derivation signal outside of a component.\n */\nexport function createDerivedSignal<T>(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n derivationId: string,\n): [Accessor<T>, () => void] {\n const [value, setValue] = createSignal<T>(system.read(derivationId) as T);\n const unsubscribe = system.subscribe([derivationId], () => {\n setValue(() => system.read(derivationId) as T);\n });\n return [value, unsubscribe];\n}\n\n/**\n * Create a fact signal outside of a component.\n */\nexport function createFactSignal<T>(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n factKey: string,\n): [Accessor<T | undefined>, () => void] {\n const [value, setValue] = createSignal<T | undefined>(\n system.facts.$store.get(factKey) as T | undefined,\n );\n const unsubscribe = system.facts.$store.subscribe([factKey], () => {\n setValue(() => system.facts.$store.get(factKey) as T | undefined);\n });\n return [value, unsubscribe];\n}\n\n// ============================================================================\n// Typed Hooks Factory\n// ============================================================================\n\nexport function createTypedHooks<M extends ModuleSchema>(): {\n useFact: <K extends keyof InferFacts<M> & string>(\n system: SingleModuleSystem<M>,\n factKey: K,\n ) => Accessor<InferFacts<M>[K] | undefined>;\n useDerived: <K extends keyof InferDerivations<M> & string>(\n system: SingleModuleSystem<M>,\n derivationId: K,\n ) => Accessor<InferDerivations<M>[K]>;\n useDispatch: (\n system: SingleModuleSystem<M>,\n ) => (event: InferEvents<M>) => void;\n useEvents: (system: SingleModuleSystem<M>) => SingleModuleSystem<M>[\"events\"];\n useWatch: <K extends string>(\n system: SingleModuleSystem<M>,\n key: K,\n callback: (newValue: unknown, previousValue: unknown) => void,\n ) => void;\n} {\n return {\n useFact: <K extends keyof InferFacts<M> & string>(\n system: SingleModuleSystem<M>,\n factKey: K,\n ) =>\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n useFact(system as SingleModuleSystem<any>, factKey as string) as Accessor<\n InferFacts<M>[K] | undefined\n >,\n useDerived: <K extends keyof InferDerivations<M> & string>(\n system: SingleModuleSystem<M>,\n derivationId: K,\n ) =>\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n useDerived(\n system as SingleModuleSystem<any>,\n derivationId as string,\n ) as Accessor<InferDerivations<M>[K]>,\n useDispatch: (system: SingleModuleSystem<M>) => {\n return (event: InferEvents<M>) => {\n system.dispatch(event);\n };\n },\n useEvents: (system: SingleModuleSystem<M>) => useEvents<M>(system),\n useWatch: <K extends string>(\n system: SingleModuleSystem<M>,\n key: K,\n callback: (newValue: unknown, previousValue: unknown) => void,\n ) =>\n // biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n useWatch(system as SingleModuleSystem<any>, key, callback),\n };\n}\n\n// ============================================================================\n// useNamespacedSelector — select from a NamespacedSystem\n// ============================================================================\n\n/**\n * SolidJS accessor that selects from a NamespacedSystem.\n * Subscribes to specified keys and provides reactive updates.\n *\n * @param system - The namespaced system\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 token = useNamespacedSelector(system, [\"auth.token\"], (s) => s.facts.auth.token);\n * ```\n */\nexport function useNamespacedSelector<Modules extends ModulesMap, R>(\n system: NamespacedSystem<Modules>,\n keys: string[],\n selector: (system: NamespacedSystem<Modules>) => R,\n): Accessor<R> {\n const [value, setValue] = createSignal<R>(selector(system));\n const unsubscribe = system.subscribe(keys, () => {\n setValue(() => selector(system));\n });\n onCleanup(unsubscribe);\n\n return value as Accessor<R>;\n}\n\n// ============================================================================\n// useQuerySystem — Stable query system with lifecycle management\n// ============================================================================\n\n/**\n * Solid composable to create and manage a query system with proper lifecycle.\n *\n * Accepts a factory function that creates the system.\n * Handles cleanup via onCleanup.\n *\n * @example\n * ```tsx\n * import { useQuerySystem, useDerived } from \"@directive-run/solid\";\n * import { createQuerySystem } from \"@directive-run/query\";\n *\n * function App() {\n * const app = useQuerySystem(() =>\n * createQuerySystem({\n * facts: { userId: \"\" },\n * queries: { user: { key: ..., fetcher: ... } },\n * autoStart: false,\n * })\n * );\n *\n * const user = useDerived(app, \"user\");\n * return <div>{user().data?.name}</div>;\n * }\n * ```\n */\n// biome-ignore lint/suspicious/noExplicitAny: Factory return type varies\nexport function useQuerySystem<T extends { start: () => void; destroy: () => void; isRunning?: boolean; [key: string]: any }>(\n factory: () => T,\n): T {\n const system = factory();\n\n if (typeof window !== \"undefined\" && !system.isRunning) {\n system.start();\n }\n\n onCleanup(() => {\n system.destroy();\n });\n\n return system;\n}\n"]}
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@directive-run/solid",
3
- "version": "0.8.2",
3
+ "version": "0.8.3",
4
4
  "description": "Solid.js signals adapter for Directive.",
5
- "license": "MIT",
5
+ "license": "(MIT OR Apache-2.0)",
6
6
  "author": "Jason Comes",
7
7
  "repository": {
8
8
  "type": "git",
@@ -45,7 +45,7 @@
45
45
  "dist"
46
46
  ],
47
47
  "peerDependencies": {
48
- "@directive-run/core": "*",
48
+ "@directive-run/core": "^0.8.0",
49
49
  "solid-js": ">=1"
50
50
  },
51
51
  "devDependencies": {
@@ -53,7 +53,7 @@
53
53
  "solid-js": "^1.8.0",
54
54
  "tsup": "^8.3.5",
55
55
  "typescript": "^5.7.2",
56
- "@directive-run/core": "0.8.2"
56
+ "@directive-run/core": "0.8.3"
57
57
  },
58
58
  "scripts": {
59
59
  "build": "tsup",