@directive-run/vue 0.2.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +18 -3
- package/dist/index.d.ts +18 -3
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/dist/index.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
'use strict';var
|
|
1
|
+
'use strict';var core=require('@directive-run/core'),adapterUtils=require('@directive-run/core/adapter-utils'),vue=require('vue');function E(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=vue.ref(e.facts.$store.get(t)),o=e.facts.$store.subscribe([t],()=>{s.value=e.facts.$store.get(t);});return vue.onScopeDispose(o),s}function V(e,t){let s=()=>{let r={};for(let u of t)r[u]=e.facts.$store.get(u);return r},o=vue.shallowRef(s()),n=e.facts.$store.subscribe(t,()=>{o.value=s();});return vue.onScopeDispose(n),o}function $(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)?A(e,t):q(e,t)}function q(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=vue.ref(e.read(t)),o=e.subscribe([t],()=>{s.value=e.read(t);});return vue.onScopeDispose(o),s}function A(e,t){let s=()=>{let r={};for(let u of t)r[u]=e.read(u);return r},o=vue.shallowRef(s()),n=e.subscribe(t,()=>{o.value=s();});return vue.onScopeDispose(n),o}function z(e,t,s=adapterUtils.defaultEquality){adapterUtils.assertSystem("useSelector",e);let o=new Set(Object.keys(e.derive??{})),n=()=>adapterUtils.runTrackedSelector(e,o,t),r=n(),u=r.factKeys,i=r.deriveKeys,l=vue.ref(r.value),S=[],c=()=>{for(let d of S)d();S.length=0;let p=()=>{let d=n();s(l.value,d.value)||(l.value=d.value),adapterUtils.depsChanged(u,d.factKeys,i,d.deriveKeys)&&(u=d.factKeys,i=d.deriveKeys,c());};u.length>0?S.push(e.facts.$store.subscribe(u,p)):i.length===0&&S.push(e.facts.$store.subscribeAll(p)),i.length>0&&S.push(e.subscribe(i,p));};return c(),vue.onScopeDispose(()=>{for(let p of S)p();}),l}function H(e){return adapterUtils.assertSystem("useDispatch",e),t=>{e.dispatch(t);}}function P(e){return adapterUtils.assertSystem("useEvents",e),e.events}function N(e,t,s){adapterUtils.assertSystem("useWatch",e);let o=e.watch(t,s);vue.onScopeDispose(o);}function U(e,t){adapterUtils.assertSystem("useInspect",e);let s=vue.shallowRef(adapterUtils.computeInspectState(e)),o=()=>{s.value=adapterUtils.computeInspectState(e);};if(t?.throttleMs&&t.throttleMs>0){let{throttled:n,cleanup:r}=adapterUtils.createThrottle(o,t.throttleMs),u=e.facts.$store.subscribeAll(n),i=e.onSettledChange(n);vue.onScopeDispose(()=>{r(),u(),i();});}else {let n=e.facts.$store.subscribeAll(o),r=e.onSettledChange(o);vue.onScopeDispose(()=>{n(),r();});}return s}function L(e,t){if(Array.isArray(t)){let n=()=>{let i={};for(let l of t)i[l]=e.getStatus(l);return i},r=vue.shallowRef(n()),u=e.subscribe(()=>{r.value=n();});return vue.onScopeDispose(u),r}let s=vue.shallowRef(e.getStatus(t)),o=e.subscribe(()=>{s.value=e.getStatus(t);});return vue.onScopeDispose(o),s}function G(e,t){adapterUtils.assertSystem("useExplain",e);let s=vue.ref(e.explain(t)),o=()=>{s.value=e.explain(t);},n=e.facts.$store.subscribeAll(o),r=e.onSettledChange(o);return vue.onScopeDispose(()=>{n(),r();}),s}function J(e,t){adapterUtils.assertSystem("useConstraintStatus",e);let s=U(e);return vue.computed(()=>{s.value;let o=e.inspect();return t?o.constraints.find(n=>n.id===t)??null:o.constraints})}function Q(e,t,s){adapterUtils.assertSystem("useOptimisticUpdate",e);let o=vue.ref(false),n=vue.ref(null),r=null,u=null,i=()=>{r&&(e.restore(r),r=null),o.value=false,n.value=null,u?.(),u=null;},l=S=>{r=e.getSnapshot(),o.value=true,n.value=null,e.batch(S),t&&s&&(u?.(),u=t.subscribe(()=>{let c=t.getStatus(s);!c.isLoading&&!c.hasError?(r=null,o.value=false,u?.(),u=null):c.hasError&&(n.value=c.lastError,i());}));};return vue.onScopeDispose(()=>{u?.();}),{mutate:l,isPending:o,error:n,rollback:i}}function X(e){adapterUtils.assertSystem("useTimeTravel",e);let t=vue.shallowRef(adapterUtils.buildTimeTravelState(e)),s=e.onTimeTravelChange(()=>{t.value=adapterUtils.buildTimeTravelState(e);});return vue.onScopeDispose(s),t}function Y(e,t){let s=[...t?.plugins??[]],o;if(t?.status){let v=core.createRequirementStatusPlugin();o=v,s.push(v.plugin);}let n=core.createSystem({module:e,plugins:s.length>0?s:void 0,debug:t?.debug,errorBoundary:t?.errorBoundary,tickMs:t?.tickMs,zeroConfig:t?.zeroConfig,initialFacts:t?.initialFacts});n.start(),vue.onScopeDispose(()=>{n.destroy();});let r=t?.facts,u=t?.derived,i=!r&&!u,l=vue.shallowRef(i?n.facts.$store.toObject():adapterUtils.pickFacts(n,r??[])),S=i?n.facts.$store.subscribeAll(()=>{l.value=n.facts.$store.toObject();}):r&&r.length>0?n.facts.$store.subscribe(r,()=>{l.value=adapterUtils.pickFacts(n,r);}):null,c=i?Object.keys(n.derive??{}):u??[],p=()=>{let v={};for(let M of c)v[M]=n.read(M);return v},d=vue.shallowRef(p()),h=c.length>0?n.subscribe(c,()=>{d.value=p();}):null;vue.onScopeDispose(()=>{S?.(),h?.();});let k=n.events;return {system:n,facts:l,derived:d,events:k,dispatch:v=>n.dispatch(v),statusPlugin:o}}function Z(){return {useFact:(e,t)=>E(e,t),useDerived:(e,t)=>$(e,t),useDispatch:e=>t=>{e.dispatch(t);},useEvents:e=>P(e),useWatch:(e,t,s)=>N(e,t,s)}}function ee(e,t,s){let o=vue.ref(s(e)),n=e.subscribe(t,()=>{o.value=s(e);});return vue.onScopeDispose(n),o}Object.defineProperty(exports,"shallowEqual",{enumerable:true,get:function(){return adapterUtils.shallowEqual}});exports.createTypedHooks=Z;exports.useConstraintStatus=J;exports.useDerived=$;exports.useDirective=Y;exports.useDispatch=H;exports.useEvents=P;exports.useExplain=G;exports.useFact=E;exports.useInspect=U;exports.useNamespacedSelector=ee;exports.useOptimisticUpdate=Q;exports.useRequirementStatus=L;exports.useSelector=z;exports.useTimeTravel=X;exports.useWatch=N;//# sourceMappingURL=index.cjs.map
|
|
2
2
|
//# sourceMappingURL=index.cjs.map
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts"],"names":["useFact","system","keyOrKeys","assertSystem","_useFactMulti","_useFactSingle","factKey","value","ref","unsubscribe","onScopeDispose","factKeys","getValues","result","key","state","shallowRef","useDerived","idOrIds","_useDerivedMulti","_useDerivedSingle","derivationId","derivationIds","id","useSelector","selector","equalityFn","defaultEquality","deriveKeySet","runWithTracking","runTrackedSelector","initial","trackedFactKeys","trackedDeriveKeys","selected","unsubs","resubscribe","unsub","onUpdate","depsChanged","useDispatch","event","useEvents","useWatch","callback","useInspect","options","computeInspectState","update","throttled","cleanup","createThrottle","unsubFacts","unsubSettled","useRequirementStatus","statusPlugin","typeOrTypes","type","status","useExplain","requirementId","explanation","useConstraintStatus","constraintId","inspectState","computed","fullInspection","c","useOptimisticUpdate","requirementType","isPending","error","snapshot","rollback","mutate","updateFn","useTimeTravel","buildTimeTravelState","useDirective","moduleDef","config","allPlugins","sp","createRequirementStatusPlugin","createSystem","derivedKeys","subscribeAll","factsState","pickFacts","allDerivationKeys","getDerived","derivedState","unsubDerived","events","createTypedHooks"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Vue Adapter - Vue 3 composables for Directive\n *\n * Exports: useFact, useDerived, useDispatch, useSelector,\n * useWatch, useInspect, useRequirementStatus, useEvents, useExplain,\n * useConstraintStatus, useOptimisticUpdate, useDirective, useTimeTravel,\n * createTypedHooks, shallowEqual\n */\n\nimport {\n\tcomputed,\n\tonScopeDispose,\n\tref,\n\tshallowRef,\n\ttype ComputedRef,\n\ttype Ref,\n\ttype ShallowRef,\n} from \"vue\";\nimport type {\n\tModuleSchema,\n\tModuleDef,\n\tPlugin,\n\tDebugConfig,\n\tErrorBoundaryConfig,\n\tInferFacts,\n\tInferDerivations,\n\tInferSelectorState,\n\tInferEvents,\n\tSingleModuleSystem,\n\tSystemSnapshot,\n} from \"@directive-run/core\";\nimport {\n\tcreateSystem,\n\tcreateRequirementStatusPlugin,\n} from \"@directive-run/core\";\nimport type { RequirementTypeStatus } from \"@directive-run/core\";\nimport {\n\ttype InspectState,\n\ttype ConstraintInfo,\n\tcomputeInspectState,\n\tcreateThrottle,\n\tassertSystem,\n\tdefaultEquality,\n\tbuildTimeTravelState,\n\tpickFacts,\n\trunTrackedSelector,\n\tdepsChanged,\n\tshallowEqual,\n} from \"@directive-run/core/adapter-utils\";\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<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, factKey: K): Ref<InferFacts<S>[K] | undefined>;\n/** Multi-key overload */\nexport function useFact<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, factKeys: K[]): ShallowRef<Pick<InferFacts<S>, K>>;\n/** Implementation */\nexport function useFact(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tkeyOrKeys: string | string[],\n): Ref<unknown> | ShallowRef<unknown> {\n\tassertSystem(\"useFact\", system);\n\tif (process.env.NODE_ENV !== \"production\" && typeof keyOrKeys === \"function\") {\n\t\tconsole.error(\n\t\t\t\"[Directive] useFact() received a function. Did you mean useSelector()? \" +\n\t\t\t\t\"useFact() takes a string key or array of keys, not a selector function.\",\n\t\t);\n\t}\n\n\t// Multi-key path: useFact(system, [keys])\n\tif (Array.isArray(keyOrKeys)) {\n\t\treturn _useFactMulti(system, keyOrKeys);\n\t}\n\n\t// Single key path: useFact(system, key)\n\treturn _useFactSingle(system, keyOrKeys);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactSingle(system: SingleModuleSystem<any>, factKey: string): Ref<unknown> {\n\tif (process.env.NODE_ENV !== \"production\") {\n\t\tif (!system.facts.$store.has(factKey)) {\n\t\t\tconsole.warn(\n\t\t\t\t`[Directive] useFact(\"${factKey}\") — fact not found in store. ` +\n\t\t\t\t`Check that \"${factKey}\" is defined in your module's schema.`,\n\t\t\t);\n\t\t}\n\t}\n\n\tconst value = ref(system.facts.$store.get(factKey));\n\tconst unsubscribe = system.facts.$store.subscribe([factKey], () => {\n\t\tvalue.value = system.facts.$store.get(factKey);\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactMulti(system: SingleModuleSystem<any>, factKeys: string[]): ShallowRef<Record<string, unknown>> {\n\tconst getValues = (): Record<string, unknown> => {\n\t\tconst result: Record<string, unknown> = {};\n\t\tfor (const key of factKeys) {\n\t\t\tresult[key] = system.facts.$store.get(key);\n\t\t}\n\t\treturn result;\n\t};\n\tconst state = shallowRef(getValues());\n\tconst unsubscribe = system.facts.$store.subscribe(factKeys, () => {\n\t\tstate.value = getValues();\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn state;\n}\n\n// ============================================================================\n// useDerived — single key or multi key\n// ============================================================================\n\n/** Single key overload */\nexport function useDerived<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, derivationId: K): Ref<InferDerivations<S>[K]>;\n/** Multi-key overload */\nexport function useDerived<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, derivationIds: K[]): ShallowRef<Pick<InferDerivations<S>, K>>;\n/** Implementation */\nexport function useDerived(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tidOrIds: string | string[],\n): Ref<unknown> | ShallowRef<unknown> {\n\tassertSystem(\"useDerived\", system);\n\tif (process.env.NODE_ENV !== \"production\" && typeof idOrIds === \"function\") {\n\t\tconsole.error(\n\t\t\t\"[Directive] useDerived() received a function. Did you mean useSelector()? \" +\n\t\t\t\t\"useDerived() takes a string key or array of keys, not a selector function.\",\n\t\t);\n\t}\n\n\t// Multi-key path\n\tif (Array.isArray(idOrIds)) {\n\t\treturn _useDerivedMulti(system, idOrIds);\n\t}\n\n\t// Single key path\n\treturn _useDerivedSingle(system, idOrIds);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedSingle(system: SingleModuleSystem<any>, derivationId: string): Ref<unknown> {\n\tif (process.env.NODE_ENV !== \"production\") {\n\t\tconst initialValue = system.read(derivationId);\n\t\tif (initialValue === undefined) {\n\t\t\tconsole.warn(\n\t\t\t\t`[Directive] useDerived(\"${derivationId}\") returned undefined. ` +\n\t\t\t\t`Check that \"${derivationId}\" is defined in your module's derive property.`,\n\t\t\t);\n\t\t}\n\t}\n\tconst value = ref(system.read(derivationId));\n\tconst unsubscribe = system.subscribe([derivationId], () => {\n\t\tvalue.value = system.read(derivationId);\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedMulti(system: SingleModuleSystem<any>, derivationIds: string[]): ShallowRef<Record<string, unknown>> {\n\tconst getValues = (): Record<string, unknown> => {\n\t\tconst result: Record<string, unknown> = {};\n\t\tfor (const id of derivationIds) {\n\t\t\tresult[id] = system.read(id);\n\t\t}\n\t\treturn result;\n\t};\n\tconst state = shallowRef(getValues());\n\tconst unsubscribe = system.subscribe(derivationIds, () => {\n\t\tstate.value = getValues();\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn 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>(system: SingleModuleSystem<S>, selector: (state: InferSelectorState<S>) => R, equalityFn?: (a: R, b: R) => boolean): Ref<R>;\nexport function useSelector(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tselector: (state: Record<string, unknown>) => unknown,\n\tequalityFn: (a: unknown, b: unknown) => boolean = defaultEquality,\n): Ref<unknown> {\n\tassertSystem(\"useSelector\", system);\n\tconst deriveKeySet = new Set(Object.keys(system.derive ?? {}));\n\n\tconst runWithTracking = () => runTrackedSelector(system, deriveKeySet, selector);\n\n\tconst initial = runWithTracking();\n\tlet trackedFactKeys = initial.factKeys;\n\tlet trackedDeriveKeys = initial.deriveKeys;\n\tconst selected = ref(initial.value);\n\n\tconst unsubs: Array<() => void> = [];\n\n\tconst resubscribe = () => {\n\t\tfor (const unsub of unsubs) unsub();\n\t\tunsubs.length = 0;\n\n\t\tconst onUpdate = () => {\n\t\t\tconst result = runWithTracking();\n\t\t\tif (!equalityFn(selected.value, result.value)) {\n\t\t\t\tselected.value = result.value;\n\t\t\t}\n\t\t\t// Re-track: check if deps changed\n\t\t\tif (depsChanged(trackedFactKeys, result.factKeys, trackedDeriveKeys, result.deriveKeys)) {\n\t\t\t\ttrackedFactKeys = result.factKeys;\n\t\t\t\ttrackedDeriveKeys = result.deriveKeys;\n\t\t\t\tresubscribe();\n\t\t\t}\n\t\t};\n\n\t\tif (trackedFactKeys.length > 0) {\n\t\t\tunsubs.push(system.facts.$store.subscribe(trackedFactKeys, onUpdate));\n\t\t} else if (trackedDeriveKeys.length === 0) {\n\t\t\tunsubs.push(system.facts.$store.subscribeAll(onUpdate));\n\t\t}\n\t\tif (trackedDeriveKeys.length > 0) {\n\t\t\tunsubs.push(system.subscribe(trackedDeriveKeys, onUpdate));\n\t\t}\n\t};\n\n\tresubscribe();\n\n\tonScopeDispose(() => {\n\t\tfor (const unsub of unsubs) unsub();\n\t});\n\n\treturn selected;\n}\n\n// ============================================================================\n// useDispatch\n// ============================================================================\n\nexport function useDispatch<S extends ModuleSchema>(\n\tsystem: SingleModuleSystem<S>,\n): (event: InferEvents<S>) => void {\n\tassertSystem(\"useDispatch\", system);\n\treturn (event: InferEvents<S>) => {\n\t\tsystem.dispatch(event);\n\t};\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\tsystem: SingleModuleSystem<S>,\n): SingleModuleSystem<S>[\"events\"] {\n\tassertSystem(\"useEvents\", system);\n\treturn 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<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(\n\tsystem: SingleModuleSystem<S>,\n\tkey: K,\n\tcallback: (newValue: InferDerivations<S>[K], previousValue: InferDerivations<S>[K] | undefined) => void,\n): void;\n/** Watch a fact key with auto-detection. */\nexport function useWatch<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(\n\tsystem: SingleModuleSystem<S>,\n\tkey: K,\n\tcallback: (newValue: InferFacts<S>[K] | undefined, previousValue: InferFacts<S>[K] | undefined) => void,\n): void;\n/** Implementation */\nexport function useWatch(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tkey: string,\n\tcallback: (newValue: unknown, prevValue: unknown) => void,\n): void {\n\tassertSystem(\"useWatch\", system);\n\n\tconst unsubscribe = system.watch(key, callback);\n\tonScopeDispose(unsubscribe);\n}\n\n// ============================================================================\n// useInspect — consolidated inspection hook\n// ============================================================================\n\n/** Options for useInspect */\nexport interface UseInspectOptions {\n\tthrottleMs?: number;\n}\n\n/**\n * Consolidated system inspection hook.\n * Returns InspectState with optional throttling.\n */\nexport function useInspect(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\toptions?: UseInspectOptions,\n): ShallowRef<InspectState> {\n\tassertSystem(\"useInspect\", system);\n\tconst state = shallowRef<InspectState>(computeInspectState(system));\n\n\tconst update = () => {\n\t\tstate.value = computeInspectState(system);\n\t};\n\n\tif (options?.throttleMs && options.throttleMs > 0) {\n\t\tconst { throttled, cleanup } = createThrottle(update, options.throttleMs);\n\t\tconst unsubFacts = system.facts.$store.subscribeAll(throttled);\n\t\tconst unsubSettled = system.onSettledChange(throttled);\n\t\tonScopeDispose(() => {\n\t\t\tcleanup();\n\t\t\tunsubFacts();\n\t\t\tunsubSettled();\n\t\t});\n\t} else {\n\t\tconst unsubFacts = system.facts.$store.subscribeAll(update);\n\t\tconst unsubSettled = system.onSettledChange(update);\n\t\tonScopeDispose(() => {\n\t\t\tunsubFacts();\n\t\t\tunsubSettled();\n\t\t});\n\t}\n\n\treturn state;\n}\n\n// ============================================================================\n// useRequirementStatus — single or multi\n// ============================================================================\n\n/** Single type overload */\nexport function useRequirementStatus(statusPlugin: StatusPlugin, type: string): ShallowRef<RequirementTypeStatus>;\n/** Multi-type overload */\nexport function useRequirementStatus(statusPlugin: StatusPlugin, types: string[]): ShallowRef<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useRequirementStatus(\n\tstatusPlugin: StatusPlugin,\n\ttypeOrTypes: string | string[],\n): ShallowRef<RequirementTypeStatus> | ShallowRef<Record<string, RequirementTypeStatus>> {\n\tif (Array.isArray(typeOrTypes)) {\n\t\tconst getValues = (): Record<string, RequirementTypeStatus> => {\n\t\t\tconst result: Record<string, RequirementTypeStatus> = {};\n\t\t\tfor (const type of typeOrTypes) {\n\t\t\t\tresult[type] = statusPlugin.getStatus(type);\n\t\t\t}\n\t\t\treturn result;\n\t\t};\n\t\tconst state = shallowRef(getValues());\n\t\tconst unsubscribe = statusPlugin.subscribe(() => {\n\t\t\tstate.value = getValues();\n\t\t});\n\t\tonScopeDispose(unsubscribe);\n\t\treturn state;\n\t}\n\n\tconst status = shallowRef<RequirementTypeStatus>(statusPlugin.getStatus(typeOrTypes));\n\tconst unsubscribe = statusPlugin.subscribe(() => {\n\t\tstatus.value = statusPlugin.getStatus(typeOrTypes);\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn 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\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\trequirementId: string,\n): Ref<string | null> {\n\tassertSystem(\"useExplain\", system);\n\tconst explanation = ref<string | null>(system.explain(requirementId)) as Ref<string | null>;\n\n\tconst update = () => {\n\t\texplanation.value = system.explain(requirementId);\n\t};\n\n\tconst unsubFacts = system.facts.$store.subscribeAll(update);\n\tconst unsubSettled = system.onSettledChange(update);\n\tonScopeDispose(() => {\n\t\tunsubFacts();\n\t\tunsubSettled();\n\t});\n\n\treturn explanation;\n}\n\n// ============================================================================\n// useConstraintStatus — reactive constraint inspection\n// ============================================================================\n\n/** Get all constraints */\nexport function useConstraintStatus(\n\tsystem: SingleModuleSystem<any>,\n): ComputedRef<ConstraintInfo[]>;\n/** Get a single constraint by ID */\nexport function useConstraintStatus(\n\tsystem: SingleModuleSystem<any>,\n\tconstraintId: string,\n): ComputedRef<ConstraintInfo | null>;\n/** Implementation */\nexport function useConstraintStatus(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\tconstraintId?: string,\n): ComputedRef<ConstraintInfo[] | ConstraintInfo | null> {\n\tassertSystem(\"useConstraintStatus\", system);\n\tconst inspectState = useInspect(system);\n\n\treturn computed(() => {\n\t\t// Track reactivity via inspectState, but use full inspect() for constraint list\n\t\tvoid inspectState.value;\n\t\tconst fullInspection = system.inspect();\n\t\tif (!constraintId) return fullInspection.constraints;\n\t\treturn fullInspection.constraints.find((c) => c.id === constraintId) ?? null;\n\t});\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\nexport interface OptimisticUpdateResult {\n\tmutate: (updateFn: () => void) => void;\n\tisPending: Ref<boolean>;\n\terror: Ref<Error | null>;\n\trollback: () => 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\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\tstatusPlugin?: StatusPlugin,\n\trequirementType?: string,\n): OptimisticUpdateResult {\n\tassertSystem(\"useOptimisticUpdate\", system);\n\tconst isPending = ref(false);\n\tconst error = ref<Error | null>(null) as Ref<Error | null>;\n\tlet snapshot: SystemSnapshot | null = null;\n\tlet unsubscribe: (() => void) | null = null;\n\n\tconst rollback = () => {\n\t\tif (snapshot) {\n\t\t\tsystem.restore(snapshot);\n\t\t\tsnapshot = null;\n\t\t}\n\t\tisPending.value = false;\n\t\terror.value = null;\n\t\tunsubscribe?.();\n\t\tunsubscribe = null;\n\t};\n\n\tconst mutate = (updateFn: () => void) => {\n\t\tsnapshot = system.getSnapshot();\n\t\tisPending.value = true;\n\t\terror.value = null;\n\t\tsystem.batch(updateFn);\n\n\t\t// Watch for resolver completion/failure\n\t\tif (statusPlugin && requirementType) {\n\t\t\tunsubscribe?.();\n\t\t\tunsubscribe = statusPlugin.subscribe(() => {\n\t\t\t\tconst status = statusPlugin.getStatus(requirementType);\n\t\t\t\tif (!status.isLoading && !status.hasError) {\n\t\t\t\t\tsnapshot = null;\n\t\t\t\t\tisPending.value = false;\n\t\t\t\t\tunsubscribe?.();\n\t\t\t\t\tunsubscribe = null;\n\t\t\t\t} else if (status.hasError) {\n\t\t\t\t\terror.value = status.lastError;\n\t\t\t\t\trollback();\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t};\n\n\tonScopeDispose(() => {\n\t\tunsubscribe?.();\n\t});\n\n\treturn { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// useTimeTravel — reactive time-travel state\n// ============================================================================\n\n/**\n * Reactive time-travel composable. Returns a ShallowRef that updates\n * when snapshots are taken or navigation occurs.\n *\n * @example\n * ```vue\n * const tt = useTimeTravel(system);\n * <button :disabled=\"!tt.value?.canUndo\" @click=\"tt.value?.undo()\">Undo</button>\n * ```\n */\nexport function useTimeTravel(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n): ShallowRef<ReturnType<typeof buildTimeTravelState>> {\n\tassertSystem(\"useTimeTravel\", system);\n\tconst state = shallowRef<ReturnType<typeof buildTimeTravelState>>(buildTimeTravelState(system));\n\tconst unsub = system.onTimeTravelChange(() => {\n\t\tstate.value = buildTimeTravelState(system);\n\t});\n\tonScopeDispose(unsub);\n\treturn state;\n}\n\n// ============================================================================\n// Scoped System Composable\n// ============================================================================\n\n/** Configuration for useDirective */\ninterface UseDirectiveConfig {\n\t// biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n\tplugins?: Plugin<any>[];\n\tdebug?: DebugConfig;\n\terrorBoundary?: ErrorBoundaryConfig;\n\ttickMs?: number;\n\tzeroConfig?: boolean;\n\t// biome-ignore lint/suspicious/noExplicitAny: Facts type varies\n\tinitialFacts?: Record<string, any>;\n\tstatus?: boolean;\n\t/** Fact keys to subscribe to (omit for all) */\n\tfacts?: string[];\n\t/** Derivation keys to subscribe to (omit for all) */\n\tderived?: 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 state.\n *\n * @example\n * ```vue\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\tmoduleDef: ModuleDef<M>,\n\tconfig?: UseDirectiveConfig,\n) {\n\tconst allPlugins = [...(config?.plugins ?? [])];\n\tlet statusPlugin: StatusPlugin | undefined;\n\n\tif (config?.status) {\n\t\tconst sp = createRequirementStatusPlugin();\n\t\tstatusPlugin = sp;\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Plugin generic issues\n\t\tallPlugins.push(sp.plugin as Plugin<any>);\n\t}\n\n\t// biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n\tconst system = createSystem({\n\t\tmodule: moduleDef,\n\t\tplugins: allPlugins.length > 0 ? allPlugins : undefined,\n\t\tdebug: config?.debug,\n\t\terrorBoundary: config?.errorBoundary,\n\t\ttickMs: config?.tickMs,\n\t\tzeroConfig: config?.zeroConfig,\n\t\tinitialFacts: config?.initialFacts,\n\t} as any) as unknown as SingleModuleSystem<M>;\n\n\tsystem.start();\n\n\tonScopeDispose(() => {\n\t\tsystem.destroy();\n\t});\n\n\tconst factKeys = config?.facts;\n\tconst derivedKeys = config?.derived;\n\tconst subscribeAll = !factKeys && !derivedKeys;\n\n\t// Subscribe to facts\n\tconst factsState = shallowRef(\n\t\tsubscribeAll\n\t\t\t? (system.facts.$store.toObject() as InferFacts<M>)\n\t\t\t: pickFacts(system, factKeys ?? []),\n\t);\n\tconst unsubFacts = subscribeAll\n\t\t? system.facts.$store.subscribeAll(() => {\n\t\t\tfactsState.value = system.facts.$store.toObject() as InferFacts<M>;\n\t\t})\n\t\t: factKeys && factKeys.length > 0\n\t\t\t? system.facts.$store.subscribe(factKeys, () => {\n\t\t\t\tfactsState.value = pickFacts(system, factKeys) as InferFacts<M>;\n\t\t\t})\n\t\t\t: null;\n\n\t// Subscribe to derivations\n\tconst allDerivationKeys = subscribeAll ? Object.keys(system.derive ?? {}) : (derivedKeys ?? []);\n\tconst getDerived = (): InferDerivations<M> => {\n\t\tconst result: Record<string, unknown> = {};\n\t\tfor (const key of allDerivationKeys) {\n\t\t\tresult[key] = system.read(key);\n\t\t}\n\t\treturn result as InferDerivations<M>;\n\t};\n\tconst derivedState = shallowRef(getDerived());\n\tconst unsubDerived = allDerivationKeys.length > 0\n\t\t? system.subscribe(allDerivationKeys, () => { derivedState.value = getDerived(); })\n\t\t: null;\n\n\tonScopeDispose(() => {\n\t\tunsubFacts?.();\n\t\tunsubDerived?.();\n\t});\n\n\tconst events = system.events;\n\tconst dispatch = (event: InferEvents<M>) => system.dispatch(event);\n\n\treturn {\n\t\tsystem,\n\t\tfacts: factsState as ShallowRef<InferFacts<M>>,\n\t\tderived: derivedState as ShallowRef<InferDerivations<M>>,\n\t\tevents,\n\t\tdispatch,\n\t\tstatusPlugin,\n\t};\n}\n\n// ============================================================================\n// Typed Hooks Factory\n// ============================================================================\n\nexport function createTypedHooks<M extends ModuleSchema>(): {\n\tuseFact: <K extends keyof InferFacts<M> & string>(\n\t\tsystem: SingleModuleSystem<M>,\n\t\tfactKey: K,\n\t) => Ref<InferFacts<M>[K] | undefined>;\n\tuseDerived: <K extends keyof InferDerivations<M> & string>(\n\t\tsystem: SingleModuleSystem<M>,\n\t\tderivationId: K,\n\t) => Ref<InferDerivations<M>[K]>;\n\tuseDispatch: (system: SingleModuleSystem<M>) => (event: InferEvents<M>) => void;\n\tuseEvents: (system: SingleModuleSystem<M>) => SingleModuleSystem<M>[\"events\"];\n\tuseWatch: <K extends string>(\n\t\tsystem: SingleModuleSystem<M>,\n\t\tkey: K,\n\t\tcallback: (newValue: unknown, previousValue: unknown) => void,\n\t) => void;\n} {\n\treturn {\n\t\tuseFact: <K extends keyof InferFacts<M> & string>(system: SingleModuleSystem<M>, factKey: K) =>\n\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Type narrowing for internal call\n\t\t\tuseFact(system as SingleModuleSystem<any>, factKey) as Ref<InferFacts<M>[K] | undefined>,\n\t\tuseDerived: <K extends keyof InferDerivations<M> & string>(system: SingleModuleSystem<M>, derivationId: K) =>\n\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Type narrowing for internal call\n\t\t\tuseDerived(system as SingleModuleSystem<any>, derivationId) as Ref<InferDerivations<M>[K]>,\n\t\tuseDispatch: (system: SingleModuleSystem<M>) => {\n\t\t\treturn (event: InferEvents<M>) => {\n\t\t\t\tsystem.dispatch(event);\n\t\t\t};\n\t\t},\n\t\tuseEvents: (system: SingleModuleSystem<M>) => useEvents<M>(system),\n\t\tuseWatch: <K extends string>(\n\t\t\tsystem: SingleModuleSystem<M>,\n\t\t\tkey: K,\n\t\t\tcallback: (newValue: unknown, previousValue: unknown) => void,\n\t\t) =>\n\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Type narrowing for internal call\n\t\t\tuseWatch(system as SingleModuleSystem<any>, key, callback),\n\t};\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts"],"names":["useFact","system","keyOrKeys","assertSystem","_useFactMulti","_useFactSingle","factKey","value","ref","unsubscribe","onScopeDispose","factKeys","getValues","result","key","state","shallowRef","useDerived","idOrIds","_useDerivedMulti","_useDerivedSingle","derivationId","derivationIds","id","useSelector","selector","equalityFn","defaultEquality","deriveKeySet","runWithTracking","runTrackedSelector","initial","trackedFactKeys","trackedDeriveKeys","selected","unsubs","resubscribe","unsub","onUpdate","depsChanged","useDispatch","event","useEvents","useWatch","callback","useInspect","options","computeInspectState","update","throttled","cleanup","createThrottle","unsubFacts","unsubSettled","useRequirementStatus","statusPlugin","typeOrTypes","type","status","useExplain","requirementId","explanation","useConstraintStatus","constraintId","inspectState","computed","fullInspection","c","useOptimisticUpdate","requirementType","isPending","error","snapshot","rollback","mutate","updateFn","useTimeTravel","buildTimeTravelState","useDirective","moduleDef","config","allPlugins","sp","createRequirementStatusPlugin","createSystem","derivedKeys","subscribeAll","factsState","pickFacts","allDerivationKeys","getDerived","derivedState","unsubDerived","events","createTypedHooks","useNamespacedSelector","keys"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Vue Adapter - Vue 3 composables for Directive\n *\n * Exports: useFact, useDerived, useDispatch, useSelector,\n * useWatch, useInspect, useRequirementStatus, useEvents, useExplain,\n * useConstraintStatus, useOptimisticUpdate, useDirective, useTimeTravel,\n * createTypedHooks, shallowEqual\n */\n\nimport type {\n DebugConfig,\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 buildTimeTravelState,\n computeInspectState,\n createThrottle,\n defaultEquality,\n depsChanged,\n pickFacts,\n runTrackedSelector,\n shallowEqual,\n} from \"@directive-run/core/adapter-utils\";\nimport {\n type ComputedRef,\n type Ref,\n type ShallowRef,\n computed,\n onScopeDispose,\n ref,\n shallowRef,\n} from \"vue\";\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>(system: SingleModuleSystem<S>, factKey: K): Ref<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): ShallowRef<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): Ref<unknown> | ShallowRef<unknown> {\n assertSystem(\"useFact\", system);\n if (\n process.env.NODE_ENV !== \"production\" &&\n typeof keyOrKeys === \"function\"\n ) {\n console.error(\n \"[Directive] useFact() received a function. Did you mean useSelector()? \" +\n \"useFact() takes a string key or array of keys, not a selector function.\",\n );\n }\n\n // Multi-key path: useFact(system, [keys])\n if (Array.isArray(keyOrKeys)) {\n return _useFactMulti(system, keyOrKeys);\n }\n\n // Single key path: useFact(system, key)\n return _useFactSingle(system, keyOrKeys);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactSingle(\n system: SingleModuleSystem<any>,\n factKey: string,\n): Ref<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 = ref(system.facts.$store.get(factKey));\n const unsubscribe = system.facts.$store.subscribe([factKey], () => {\n value.value = system.facts.$store.get(factKey);\n });\n onScopeDispose(unsubscribe);\n return value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactMulti(\n system: SingleModuleSystem<any>,\n factKeys: string[],\n): ShallowRef<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 = shallowRef(getValues());\n const unsubscribe = system.facts.$store.subscribe(factKeys, () => {\n state.value = getValues();\n });\n onScopeDispose(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>(system: SingleModuleSystem<S>, derivationId: K): Ref<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): ShallowRef<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): Ref<unknown> | ShallowRef<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): Ref<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 = ref(system.read(derivationId));\n const unsubscribe = system.subscribe([derivationId], () => {\n value.value = system.read(derivationId);\n });\n onScopeDispose(unsubscribe);\n return value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedMulti(\n system: SingleModuleSystem<any>,\n derivationIds: string[],\n): ShallowRef<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 = shallowRef(getValues());\n const unsubscribe = system.subscribe(derivationIds, () => {\n state.value = getValues();\n });\n onScopeDispose(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): Ref<R>;\nexport function useSelector(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n selector: (state: Record<string, unknown>) => unknown,\n equalityFn: (a: unknown, b: unknown) => boolean = defaultEquality,\n): Ref<unknown> {\n assertSystem(\"useSelector\", system);\n const deriveKeySet = new Set(Object.keys(system.derive ?? {}));\n\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 = ref(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 if (!equalityFn(selected.value, result.value)) {\n selected.value = result.value;\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 onScopeDispose(() => {\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 onScopeDispose(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 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): ShallowRef<InspectState> {\n assertSystem(\"useInspect\", system);\n const state = shallowRef<InspectState>(computeInspectState(system));\n\n const update = () => {\n state.value = 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 onScopeDispose(() => {\n cleanup();\n unsubFacts();\n unsubSettled();\n });\n } else {\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onScopeDispose(() => {\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): ShallowRef<RequirementTypeStatus>;\n/** Multi-type overload */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n types: string[],\n): ShallowRef<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n typeOrTypes: string | string[],\n):\n | ShallowRef<RequirementTypeStatus>\n | ShallowRef<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 = shallowRef(getValues());\n const unsubscribe = statusPlugin.subscribe(() => {\n state.value = getValues();\n });\n onScopeDispose(unsubscribe);\n return state;\n }\n\n const status = shallowRef<RequirementTypeStatus>(\n statusPlugin.getStatus(typeOrTypes),\n );\n const unsubscribe = statusPlugin.subscribe(() => {\n status.value = statusPlugin.getStatus(typeOrTypes);\n });\n onScopeDispose(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): Ref<string | null> {\n assertSystem(\"useExplain\", system);\n const explanation = ref<string | null>(system.explain(requirementId)) as Ref<\n string | null\n >;\n\n const update = () => {\n explanation.value = system.explain(requirementId);\n };\n\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onScopeDispose(() => {\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): ComputedRef<ConstraintInfo[]>;\n/** Get a single constraint by ID */\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n constraintId: string,\n): ComputedRef<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): ComputedRef<ConstraintInfo[] | ConstraintInfo | null> {\n assertSystem(\"useConstraintStatus\", system);\n const inspectState = useInspect(system);\n\n return computed(() => {\n // Track reactivity via inspectState, but use full inspect() for constraint list\n void inspectState.value;\n const fullInspection = system.inspect();\n if (!constraintId) return fullInspection.constraints;\n return (\n fullInspection.constraints.find((c) => c.id === constraintId) ?? null\n );\n });\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\nexport interface OptimisticUpdateResult {\n mutate: (updateFn: () => void) => void;\n isPending: Ref<boolean>;\n error: Ref<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 = ref(false);\n const error = ref<Error | null>(null) as Ref<Error | null>;\n let snapshot: SystemSnapshot | null = null;\n let unsubscribe: (() => void) | null = null;\n\n const rollback = () => {\n if (snapshot) {\n system.restore(snapshot);\n snapshot = null;\n }\n isPending.value = false;\n error.value = null;\n unsubscribe?.();\n unsubscribe = null;\n };\n\n const mutate = (updateFn: () => void) => {\n snapshot = system.getSnapshot();\n isPending.value = true;\n error.value = null;\n system.batch(updateFn);\n\n // Watch for resolver completion/failure\n if (statusPlugin && requirementType) {\n unsubscribe?.();\n unsubscribe = statusPlugin.subscribe(() => {\n const status = statusPlugin.getStatus(requirementType);\n if (!status.isLoading && !status.hasError) {\n snapshot = null;\n isPending.value = false;\n unsubscribe?.();\n unsubscribe = null;\n } else if (status.hasError) {\n error.value = status.lastError;\n rollback();\n }\n });\n }\n };\n\n onScopeDispose(() => {\n unsubscribe?.();\n });\n\n return { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// useTimeTravel — reactive time-travel state\n// ============================================================================\n\n/**\n * Reactive time-travel composable. Returns a ShallowRef that updates\n * when snapshots are taken or navigation occurs.\n *\n * @example\n * ```vue\n * const tt = useTimeTravel(system);\n * <button :disabled=\"!tt.value?.canUndo\" @click=\"tt.value?.undo()\">Undo</button>\n * ```\n */\nexport function useTimeTravel(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n): ShallowRef<ReturnType<typeof buildTimeTravelState>> {\n assertSystem(\"useTimeTravel\", system);\n const state = shallowRef<ReturnType<typeof buildTimeTravelState>>(\n buildTimeTravelState(system),\n );\n const unsub = system.onTimeTravelChange(() => {\n state.value = buildTimeTravelState(system);\n });\n onScopeDispose(unsub);\n return state;\n}\n\n// ============================================================================\n// Scoped System Composable\n// ============================================================================\n\n/** Configuration for useDirective */\ninterface UseDirectiveConfig {\n // biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n plugins?: Plugin<any>[];\n debug?: DebugConfig;\n errorBoundary?: ErrorBoundaryConfig;\n tickMs?: number;\n zeroConfig?: boolean;\n // biome-ignore lint/suspicious/noExplicitAny: Facts type varies\n initialFacts?: Record<string, any>;\n 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 state.\n *\n * @example\n * ```vue\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 debug: config?.debug,\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 onScopeDispose(() => {\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 = shallowRef(\n subscribeAll\n ? (system.facts.$store.toObject() as InferFacts<M>)\n : pickFacts(system, factKeys ?? []),\n );\n const unsubFacts = subscribeAll\n ? system.facts.$store.subscribeAll(() => {\n factsState.value = system.facts.$store.toObject() as InferFacts<M>;\n })\n : factKeys && factKeys.length > 0\n ? system.facts.$store.subscribe(factKeys, () => {\n factsState.value = 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 = shallowRef(getDerived());\n const unsubDerived =\n allDerivationKeys.length > 0\n ? system.subscribe(allDerivationKeys, () => {\n derivedState.value = getDerived();\n })\n : null;\n\n onScopeDispose(() => {\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 ShallowRef<InferFacts<M>>,\n derived: derivedState as ShallowRef<InferDerivations<M>>,\n events,\n dispatch,\n statusPlugin,\n };\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 ) => Ref<InferFacts<M>[K] | undefined>;\n useDerived: <K extends keyof InferDerivations<M> & string>(\n system: SingleModuleSystem<M>,\n derivationId: K,\n ) => Ref<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: Type narrowing for internal call\n useFact(system as SingleModuleSystem<any>, factKey) as Ref<\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: Type narrowing for internal call\n useDerived(system as SingleModuleSystem<any>, derivationId) as Ref<\n InferDerivations<M>[K]\n >,\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: Type narrowing for internal call\n useWatch(system as SingleModuleSystem<any>, key, callback),\n };\n}\n\n// ============================================================================\n// useNamespacedSelector — select from a NamespacedSystem\n// ============================================================================\n\n/**\n * Reactive composable to select from a NamespacedSystem.\n * Subscribes to specified keys and returns a Vue ref.\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 * ```vue\n * const system = useDirectiveRef({ modules: { auth, data } });\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): Ref<R> {\n const value = ref(selector(system)) as Ref<R>;\n const unsubscribe = system.subscribe(keys, () => {\n value.value = selector(system) as R;\n });\n onScopeDispose(unsubscribe);\n\n return value;\n}\n"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { createRequirementStatusPlugin, ModuleSchema, InferFacts, SingleModuleSystem, InferDerivations, InferEvents, ModuleDef, Plugin, DebugConfig, ErrorBoundaryConfig, RequirementTypeStatus, InferSelectorState } from '@directive-run/core';
|
|
1
|
+
import { createRequirementStatusPlugin, ModuleSchema, InferFacts, SingleModuleSystem, InferDerivations, InferEvents, ModuleDef, Plugin, DebugConfig, ErrorBoundaryConfig, RequirementTypeStatus, ModulesMap, NamespacedSystem, InferSelectorState } from '@directive-run/core';
|
|
3
2
|
export { RequirementTypeStatus } from '@directive-run/core';
|
|
4
3
|
import { ConstraintInfo, InspectState, buildTimeTravelState } from '@directive-run/core/adapter-utils';
|
|
5
4
|
export { ConstraintInfo, InspectState, shallowEqual } from '@directive-run/core/adapter-utils';
|
|
5
|
+
import { Ref, ComputedRef, ShallowRef } from 'vue';
|
|
6
6
|
|
|
7
7
|
/**
|
|
8
8
|
* Vue Adapter - Vue 3 composables for Directive
|
|
@@ -132,5 +132,20 @@ declare function createTypedHooks<M extends ModuleSchema>(): {
|
|
|
132
132
|
useEvents: (system: SingleModuleSystem<M>) => SingleModuleSystem<M>["events"];
|
|
133
133
|
useWatch: <K extends string>(system: SingleModuleSystem<M>, key: K, callback: (newValue: unknown, previousValue: unknown) => void) => void;
|
|
134
134
|
};
|
|
135
|
+
/**
|
|
136
|
+
* Reactive composable to select from a NamespacedSystem.
|
|
137
|
+
* Subscribes to specified keys and returns a Vue ref.
|
|
138
|
+
*
|
|
139
|
+
* @param system - The namespaced system
|
|
140
|
+
* @param keys - Namespaced keys to subscribe to (e.g., ["auth.token", "data.count"])
|
|
141
|
+
* @param selector - Function that reads from system.facts / system.derive
|
|
142
|
+
*
|
|
143
|
+
* @example
|
|
144
|
+
* ```vue
|
|
145
|
+
* const system = useDirectiveRef({ modules: { auth, data } });
|
|
146
|
+
* const token = useNamespacedSelector(system, ["auth.token"], (s) => s.facts.auth.token);
|
|
147
|
+
* ```
|
|
148
|
+
*/
|
|
149
|
+
declare function useNamespacedSelector<Modules extends ModulesMap, R>(system: NamespacedSystem<Modules>, keys: string[], selector: (system: NamespacedSystem<Modules>) => R): Ref<R>;
|
|
135
150
|
|
|
136
|
-
export { type OptimisticUpdateResult, type StatusPlugin, type UseInspectOptions, createTypedHooks, useConstraintStatus, useDerived, useDirective, useDispatch, useEvents, useExplain, useFact, useInspect, useOptimisticUpdate, useRequirementStatus, useSelector, useTimeTravel, useWatch };
|
|
151
|
+
export { type OptimisticUpdateResult, type StatusPlugin, type UseInspectOptions, createTypedHooks, useConstraintStatus, useDerived, useDirective, useDispatch, useEvents, useExplain, useFact, useInspect, useNamespacedSelector, useOptimisticUpdate, useRequirementStatus, useSelector, useTimeTravel, useWatch };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { createRequirementStatusPlugin, ModuleSchema, InferFacts, SingleModuleSystem, InferDerivations, InferEvents, ModuleDef, Plugin, DebugConfig, ErrorBoundaryConfig, RequirementTypeStatus, InferSelectorState } from '@directive-run/core';
|
|
1
|
+
import { createRequirementStatusPlugin, ModuleSchema, InferFacts, SingleModuleSystem, InferDerivations, InferEvents, ModuleDef, Plugin, DebugConfig, ErrorBoundaryConfig, RequirementTypeStatus, ModulesMap, NamespacedSystem, InferSelectorState } from '@directive-run/core';
|
|
3
2
|
export { RequirementTypeStatus } from '@directive-run/core';
|
|
4
3
|
import { ConstraintInfo, InspectState, buildTimeTravelState } from '@directive-run/core/adapter-utils';
|
|
5
4
|
export { ConstraintInfo, InspectState, shallowEqual } from '@directive-run/core/adapter-utils';
|
|
5
|
+
import { Ref, ComputedRef, ShallowRef } from 'vue';
|
|
6
6
|
|
|
7
7
|
/**
|
|
8
8
|
* Vue Adapter - Vue 3 composables for Directive
|
|
@@ -132,5 +132,20 @@ declare function createTypedHooks<M extends ModuleSchema>(): {
|
|
|
132
132
|
useEvents: (system: SingleModuleSystem<M>) => SingleModuleSystem<M>["events"];
|
|
133
133
|
useWatch: <K extends string>(system: SingleModuleSystem<M>, key: K, callback: (newValue: unknown, previousValue: unknown) => void) => void;
|
|
134
134
|
};
|
|
135
|
+
/**
|
|
136
|
+
* Reactive composable to select from a NamespacedSystem.
|
|
137
|
+
* Subscribes to specified keys and returns a Vue ref.
|
|
138
|
+
*
|
|
139
|
+
* @param system - The namespaced system
|
|
140
|
+
* @param keys - Namespaced keys to subscribe to (e.g., ["auth.token", "data.count"])
|
|
141
|
+
* @param selector - Function that reads from system.facts / system.derive
|
|
142
|
+
*
|
|
143
|
+
* @example
|
|
144
|
+
* ```vue
|
|
145
|
+
* const system = useDirectiveRef({ modules: { auth, data } });
|
|
146
|
+
* const token = useNamespacedSelector(system, ["auth.token"], (s) => s.facts.auth.token);
|
|
147
|
+
* ```
|
|
148
|
+
*/
|
|
149
|
+
declare function useNamespacedSelector<Modules extends ModulesMap, R>(system: NamespacedSystem<Modules>, keys: string[], selector: (system: NamespacedSystem<Modules>) => R): Ref<R>;
|
|
135
150
|
|
|
136
|
-
export { type OptimisticUpdateResult, type StatusPlugin, type UseInspectOptions, createTypedHooks, useConstraintStatus, useDerived, useDirective, useDispatch, useEvents, useExplain, useFact, useInspect, useOptimisticUpdate, useRequirementStatus, useSelector, useTimeTravel, useWatch };
|
|
151
|
+
export { type OptimisticUpdateResult, type StatusPlugin, type UseInspectOptions, createTypedHooks, useConstraintStatus, useDerived, useDirective, useDispatch, useEvents, useExplain, useFact, useInspect, useNamespacedSelector, useOptimisticUpdate, useRequirementStatus, useSelector, useTimeTravel, useWatch };
|
package/dist/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import {createRequirementStatusPlugin,createSystem}from'@directive-run/core';import {defaultEquality,assertSystem,computeInspectState,createThrottle,buildTimeTravelState,pickFacts,runTrackedSelector,depsChanged}from'@directive-run/core/adapter-utils';export{shallowEqual}from'@directive-run/core/adapter-utils';import {ref,onScopeDispose,shallowRef,computed}from'vue';function E(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=ref(e.facts.$store.get(t)),o=e.facts.$store.subscribe([t],()=>{s.value=e.facts.$store.get(t);});return onScopeDispose(o),s}function V(e,t){let s=()=>{let r={};for(let u of t)r[u]=e.facts.$store.get(u);return r},o=shallowRef(s()),n=e.facts.$store.subscribe(t,()=>{o.value=s();});return onScopeDispose(n),o}function $(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)?A(e,t):q(e,t)}function q(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=ref(e.read(t)),o=e.subscribe([t],()=>{s.value=e.read(t);});return onScopeDispose(o),s}function A(e,t){let s=()=>{let r={};for(let u of t)r[u]=e.read(u);return r},o=shallowRef(s()),n=e.subscribe(t,()=>{o.value=s();});return onScopeDispose(n),o}function z(e,t,s=defaultEquality){assertSystem("useSelector",e);let o=new Set(Object.keys(e.derive??{})),n=()=>runTrackedSelector(e,o,t),r=n(),u=r.factKeys,i=r.deriveKeys,l=ref(r.value),S=[],c=()=>{for(let d of S)d();S.length=0;let p=()=>{let d=n();s(l.value,d.value)||(l.value=d.value),depsChanged(u,d.factKeys,i,d.deriveKeys)&&(u=d.factKeys,i=d.deriveKeys,c());};u.length>0?S.push(e.facts.$store.subscribe(u,p)):i.length===0&&S.push(e.facts.$store.subscribeAll(p)),i.length>0&&S.push(e.subscribe(i,p));};return c(),onScopeDispose(()=>{for(let p of S)p();}),l}function H(e){return assertSystem("useDispatch",e),t=>{e.dispatch(t);}}function P(e){return assertSystem("useEvents",e),e.events}function N(e,t,s){assertSystem("useWatch",e);let o=e.watch(t,s);onScopeDispose(o);}function U(e,t){assertSystem("useInspect",e);let s=shallowRef(computeInspectState(e)),o=()=>{s.value=computeInspectState(e);};if(t?.throttleMs&&t.throttleMs>0){let{throttled:n,cleanup:r}=createThrottle(o,t.throttleMs),u=e.facts.$store.subscribeAll(n),i=e.onSettledChange(n);onScopeDispose(()=>{r(),u(),i();});}else {let n=e.facts.$store.subscribeAll(o),r=e.onSettledChange(o);onScopeDispose(()=>{n(),r();});}return s}function L(e,t){if(Array.isArray(t)){let n=()=>{let i={};for(let l of t)i[l]=e.getStatus(l);return i},r=shallowRef(n()),u=e.subscribe(()=>{r.value=n();});return onScopeDispose(u),r}let s=shallowRef(e.getStatus(t)),o=e.subscribe(()=>{s.value=e.getStatus(t);});return onScopeDispose(o),s}function G(e,t){assertSystem("useExplain",e);let s=ref(e.explain(t)),o=()=>{s.value=e.explain(t);},n=e.facts.$store.subscribeAll(o),r=e.onSettledChange(o);return onScopeDispose(()=>{n(),r();}),s}function J(e,t){assertSystem("useConstraintStatus",e);let s=U(e);return computed(()=>{s.value;let o=e.inspect();return t?o.constraints.find(n=>n.id===t)??null:o.constraints})}function Q(e,t,s){assertSystem("useOptimisticUpdate",e);let o=ref(false),n=ref(null),r=null,u=null,i=()=>{r&&(e.restore(r),r=null),o.value=false,n.value=null,u?.(),u=null;},l=S=>{r=e.getSnapshot(),o.value=true,n.value=null,e.batch(S),t&&s&&(u?.(),u=t.subscribe(()=>{let c=t.getStatus(s);!c.isLoading&&!c.hasError?(r=null,o.value=false,u?.(),u=null):c.hasError&&(n.value=c.lastError,i());}));};return onScopeDispose(()=>{u?.();}),{mutate:l,isPending:o,error:n,rollback:i}}function X(e){assertSystem("useTimeTravel",e);let t=shallowRef(buildTimeTravelState(e)),s=e.onTimeTravelChange(()=>{t.value=buildTimeTravelState(e);});return onScopeDispose(s),t}function Y(e,t){let s=[...t?.plugins??[]],o;if(t?.status){let v=createRequirementStatusPlugin();o=v,s.push(v.plugin);}let n=createSystem({module:e,plugins:s.length>0?s:void 0,debug:t?.debug,errorBoundary:t?.errorBoundary,tickMs:t?.tickMs,zeroConfig:t?.zeroConfig,initialFacts:t?.initialFacts});n.start(),onScopeDispose(()=>{n.destroy();});let r=t?.facts,u=t?.derived,i=!r&&!u,l=shallowRef(i?n.facts.$store.toObject():pickFacts(n,r??[])),S=i?n.facts.$store.subscribeAll(()=>{l.value=n.facts.$store.toObject();}):r&&r.length>0?n.facts.$store.subscribe(r,()=>{l.value=pickFacts(n,r);}):null,c=i?Object.keys(n.derive??{}):u??[],p=()=>{let v={};for(let M of c)v[M]=n.read(M);return v},d=shallowRef(p()),h=c.length>0?n.subscribe(c,()=>{d.value=p();}):null;onScopeDispose(()=>{S?.(),h?.();});let k=n.events;return {system:n,facts:l,derived:d,events:k,dispatch:v=>n.dispatch(v),statusPlugin:o}}function Z(){return {useFact:(e,t)=>E(e,t),useDerived:(e,t)=>$(e,t),useDispatch:e=>t=>{e.dispatch(t);},useEvents:e=>P(e),useWatch:(e,t,s)=>N(e,t,s)}}function ee(e,t,s){let o=ref(s(e)),n=e.subscribe(t,()=>{o.value=s(e);});return onScopeDispose(n),o}export{Z as createTypedHooks,J as useConstraintStatus,$ as useDerived,Y as useDirective,H as useDispatch,P as useEvents,G as useExplain,E as useFact,U as useInspect,ee as useNamespacedSelector,Q as useOptimisticUpdate,L as useRequirementStatus,z as useSelector,X as useTimeTravel,N 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","ref","unsubscribe","onScopeDispose","factKeys","getValues","result","key","state","shallowRef","useDerived","idOrIds","_useDerivedMulti","_useDerivedSingle","derivationId","derivationIds","id","useSelector","selector","equalityFn","defaultEquality","deriveKeySet","runWithTracking","runTrackedSelector","initial","trackedFactKeys","trackedDeriveKeys","selected","unsubs","resubscribe","unsub","onUpdate","depsChanged","useDispatch","event","useEvents","useWatch","callback","useInspect","options","computeInspectState","update","throttled","cleanup","createThrottle","unsubFacts","unsubSettled","useRequirementStatus","statusPlugin","typeOrTypes","type","status","useExplain","requirementId","explanation","useConstraintStatus","constraintId","inspectState","computed","fullInspection","c","useOptimisticUpdate","requirementType","isPending","error","snapshot","rollback","mutate","updateFn","useTimeTravel","buildTimeTravelState","useDirective","moduleDef","config","allPlugins","sp","createRequirementStatusPlugin","createSystem","derivedKeys","subscribeAll","factsState","pickFacts","allDerivationKeys","getDerived","derivedState","unsubDerived","events","createTypedHooks"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Vue Adapter - Vue 3 composables for Directive\n *\n * Exports: useFact, useDerived, useDispatch, useSelector,\n * useWatch, useInspect, useRequirementStatus, useEvents, useExplain,\n * useConstraintStatus, useOptimisticUpdate, useDirective, useTimeTravel,\n * createTypedHooks, shallowEqual\n */\n\nimport {\n\tcomputed,\n\tonScopeDispose,\n\tref,\n\tshallowRef,\n\ttype ComputedRef,\n\ttype Ref,\n\ttype ShallowRef,\n} from \"vue\";\nimport type {\n\tModuleSchema,\n\tModuleDef,\n\tPlugin,\n\tDebugConfig,\n\tErrorBoundaryConfig,\n\tInferFacts,\n\tInferDerivations,\n\tInferSelectorState,\n\tInferEvents,\n\tSingleModuleSystem,\n\tSystemSnapshot,\n} from \"@directive-run/core\";\nimport {\n\tcreateSystem,\n\tcreateRequirementStatusPlugin,\n} from \"@directive-run/core\";\nimport type { RequirementTypeStatus } from \"@directive-run/core\";\nimport {\n\ttype InspectState,\n\ttype ConstraintInfo,\n\tcomputeInspectState,\n\tcreateThrottle,\n\tassertSystem,\n\tdefaultEquality,\n\tbuildTimeTravelState,\n\tpickFacts,\n\trunTrackedSelector,\n\tdepsChanged,\n\tshallowEqual,\n} from \"@directive-run/core/adapter-utils\";\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<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, factKey: K): Ref<InferFacts<S>[K] | undefined>;\n/** Multi-key overload */\nexport function useFact<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, factKeys: K[]): ShallowRef<Pick<InferFacts<S>, K>>;\n/** Implementation */\nexport function useFact(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tkeyOrKeys: string | string[],\n): Ref<unknown> | ShallowRef<unknown> {\n\tassertSystem(\"useFact\", system);\n\tif (process.env.NODE_ENV !== \"production\" && typeof keyOrKeys === \"function\") {\n\t\tconsole.error(\n\t\t\t\"[Directive] useFact() received a function. Did you mean useSelector()? \" +\n\t\t\t\t\"useFact() takes a string key or array of keys, not a selector function.\",\n\t\t);\n\t}\n\n\t// Multi-key path: useFact(system, [keys])\n\tif (Array.isArray(keyOrKeys)) {\n\t\treturn _useFactMulti(system, keyOrKeys);\n\t}\n\n\t// Single key path: useFact(system, key)\n\treturn _useFactSingle(system, keyOrKeys);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactSingle(system: SingleModuleSystem<any>, factKey: string): Ref<unknown> {\n\tif (process.env.NODE_ENV !== \"production\") {\n\t\tif (!system.facts.$store.has(factKey)) {\n\t\t\tconsole.warn(\n\t\t\t\t`[Directive] useFact(\"${factKey}\") — fact not found in store. ` +\n\t\t\t\t`Check that \"${factKey}\" is defined in your module's schema.`,\n\t\t\t);\n\t\t}\n\t}\n\n\tconst value = ref(system.facts.$store.get(factKey));\n\tconst unsubscribe = system.facts.$store.subscribe([factKey], () => {\n\t\tvalue.value = system.facts.$store.get(factKey);\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactMulti(system: SingleModuleSystem<any>, factKeys: string[]): ShallowRef<Record<string, unknown>> {\n\tconst getValues = (): Record<string, unknown> => {\n\t\tconst result: Record<string, unknown> = {};\n\t\tfor (const key of factKeys) {\n\t\t\tresult[key] = system.facts.$store.get(key);\n\t\t}\n\t\treturn result;\n\t};\n\tconst state = shallowRef(getValues());\n\tconst unsubscribe = system.facts.$store.subscribe(factKeys, () => {\n\t\tstate.value = getValues();\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn state;\n}\n\n// ============================================================================\n// useDerived — single key or multi key\n// ============================================================================\n\n/** Single key overload */\nexport function useDerived<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, derivationId: K): Ref<InferDerivations<S>[K]>;\n/** Multi-key overload */\nexport function useDerived<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, derivationIds: K[]): ShallowRef<Pick<InferDerivations<S>, K>>;\n/** Implementation */\nexport function useDerived(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tidOrIds: string | string[],\n): Ref<unknown> | ShallowRef<unknown> {\n\tassertSystem(\"useDerived\", system);\n\tif (process.env.NODE_ENV !== \"production\" && typeof idOrIds === \"function\") {\n\t\tconsole.error(\n\t\t\t\"[Directive] useDerived() received a function. Did you mean useSelector()? \" +\n\t\t\t\t\"useDerived() takes a string key or array of keys, not a selector function.\",\n\t\t);\n\t}\n\n\t// Multi-key path\n\tif (Array.isArray(idOrIds)) {\n\t\treturn _useDerivedMulti(system, idOrIds);\n\t}\n\n\t// Single key path\n\treturn _useDerivedSingle(system, idOrIds);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedSingle(system: SingleModuleSystem<any>, derivationId: string): Ref<unknown> {\n\tif (process.env.NODE_ENV !== \"production\") {\n\t\tconst initialValue = system.read(derivationId);\n\t\tif (initialValue === undefined) {\n\t\t\tconsole.warn(\n\t\t\t\t`[Directive] useDerived(\"${derivationId}\") returned undefined. ` +\n\t\t\t\t`Check that \"${derivationId}\" is defined in your module's derive property.`,\n\t\t\t);\n\t\t}\n\t}\n\tconst value = ref(system.read(derivationId));\n\tconst unsubscribe = system.subscribe([derivationId], () => {\n\t\tvalue.value = system.read(derivationId);\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedMulti(system: SingleModuleSystem<any>, derivationIds: string[]): ShallowRef<Record<string, unknown>> {\n\tconst getValues = (): Record<string, unknown> => {\n\t\tconst result: Record<string, unknown> = {};\n\t\tfor (const id of derivationIds) {\n\t\t\tresult[id] = system.read(id);\n\t\t}\n\t\treturn result;\n\t};\n\tconst state = shallowRef(getValues());\n\tconst unsubscribe = system.subscribe(derivationIds, () => {\n\t\tstate.value = getValues();\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn 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>(system: SingleModuleSystem<S>, selector: (state: InferSelectorState<S>) => R, equalityFn?: (a: R, b: R) => boolean): Ref<R>;\nexport function useSelector(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tselector: (state: Record<string, unknown>) => unknown,\n\tequalityFn: (a: unknown, b: unknown) => boolean = defaultEquality,\n): Ref<unknown> {\n\tassertSystem(\"useSelector\", system);\n\tconst deriveKeySet = new Set(Object.keys(system.derive ?? {}));\n\n\tconst runWithTracking = () => runTrackedSelector(system, deriveKeySet, selector);\n\n\tconst initial = runWithTracking();\n\tlet trackedFactKeys = initial.factKeys;\n\tlet trackedDeriveKeys = initial.deriveKeys;\n\tconst selected = ref(initial.value);\n\n\tconst unsubs: Array<() => void> = [];\n\n\tconst resubscribe = () => {\n\t\tfor (const unsub of unsubs) unsub();\n\t\tunsubs.length = 0;\n\n\t\tconst onUpdate = () => {\n\t\t\tconst result = runWithTracking();\n\t\t\tif (!equalityFn(selected.value, result.value)) {\n\t\t\t\tselected.value = result.value;\n\t\t\t}\n\t\t\t// Re-track: check if deps changed\n\t\t\tif (depsChanged(trackedFactKeys, result.factKeys, trackedDeriveKeys, result.deriveKeys)) {\n\t\t\t\ttrackedFactKeys = result.factKeys;\n\t\t\t\ttrackedDeriveKeys = result.deriveKeys;\n\t\t\t\tresubscribe();\n\t\t\t}\n\t\t};\n\n\t\tif (trackedFactKeys.length > 0) {\n\t\t\tunsubs.push(system.facts.$store.subscribe(trackedFactKeys, onUpdate));\n\t\t} else if (trackedDeriveKeys.length === 0) {\n\t\t\tunsubs.push(system.facts.$store.subscribeAll(onUpdate));\n\t\t}\n\t\tif (trackedDeriveKeys.length > 0) {\n\t\t\tunsubs.push(system.subscribe(trackedDeriveKeys, onUpdate));\n\t\t}\n\t};\n\n\tresubscribe();\n\n\tonScopeDispose(() => {\n\t\tfor (const unsub of unsubs) unsub();\n\t});\n\n\treturn selected;\n}\n\n// ============================================================================\n// useDispatch\n// ============================================================================\n\nexport function useDispatch<S extends ModuleSchema>(\n\tsystem: SingleModuleSystem<S>,\n): (event: InferEvents<S>) => void {\n\tassertSystem(\"useDispatch\", system);\n\treturn (event: InferEvents<S>) => {\n\t\tsystem.dispatch(event);\n\t};\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\tsystem: SingleModuleSystem<S>,\n): SingleModuleSystem<S>[\"events\"] {\n\tassertSystem(\"useEvents\", system);\n\treturn 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<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(\n\tsystem: SingleModuleSystem<S>,\n\tkey: K,\n\tcallback: (newValue: InferDerivations<S>[K], previousValue: InferDerivations<S>[K] | undefined) => void,\n): void;\n/** Watch a fact key with auto-detection. */\nexport function useWatch<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(\n\tsystem: SingleModuleSystem<S>,\n\tkey: K,\n\tcallback: (newValue: InferFacts<S>[K] | undefined, previousValue: InferFacts<S>[K] | undefined) => void,\n): void;\n/** Implementation */\nexport function useWatch(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tkey: string,\n\tcallback: (newValue: unknown, prevValue: unknown) => void,\n): void {\n\tassertSystem(\"useWatch\", system);\n\n\tconst unsubscribe = system.watch(key, callback);\n\tonScopeDispose(unsubscribe);\n}\n\n// ============================================================================\n// useInspect — consolidated inspection hook\n// ============================================================================\n\n/** Options for useInspect */\nexport interface UseInspectOptions {\n\tthrottleMs?: number;\n}\n\n/**\n * Consolidated system inspection hook.\n * Returns InspectState with optional throttling.\n */\nexport function useInspect(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\toptions?: UseInspectOptions,\n): ShallowRef<InspectState> {\n\tassertSystem(\"useInspect\", system);\n\tconst state = shallowRef<InspectState>(computeInspectState(system));\n\n\tconst update = () => {\n\t\tstate.value = computeInspectState(system);\n\t};\n\n\tif (options?.throttleMs && options.throttleMs > 0) {\n\t\tconst { throttled, cleanup } = createThrottle(update, options.throttleMs);\n\t\tconst unsubFacts = system.facts.$store.subscribeAll(throttled);\n\t\tconst unsubSettled = system.onSettledChange(throttled);\n\t\tonScopeDispose(() => {\n\t\t\tcleanup();\n\t\t\tunsubFacts();\n\t\t\tunsubSettled();\n\t\t});\n\t} else {\n\t\tconst unsubFacts = system.facts.$store.subscribeAll(update);\n\t\tconst unsubSettled = system.onSettledChange(update);\n\t\tonScopeDispose(() => {\n\t\t\tunsubFacts();\n\t\t\tunsubSettled();\n\t\t});\n\t}\n\n\treturn state;\n}\n\n// ============================================================================\n// useRequirementStatus — single or multi\n// ============================================================================\n\n/** Single type overload */\nexport function useRequirementStatus(statusPlugin: StatusPlugin, type: string): ShallowRef<RequirementTypeStatus>;\n/** Multi-type overload */\nexport function useRequirementStatus(statusPlugin: StatusPlugin, types: string[]): ShallowRef<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useRequirementStatus(\n\tstatusPlugin: StatusPlugin,\n\ttypeOrTypes: string | string[],\n): ShallowRef<RequirementTypeStatus> | ShallowRef<Record<string, RequirementTypeStatus>> {\n\tif (Array.isArray(typeOrTypes)) {\n\t\tconst getValues = (): Record<string, RequirementTypeStatus> => {\n\t\t\tconst result: Record<string, RequirementTypeStatus> = {};\n\t\t\tfor (const type of typeOrTypes) {\n\t\t\t\tresult[type] = statusPlugin.getStatus(type);\n\t\t\t}\n\t\t\treturn result;\n\t\t};\n\t\tconst state = shallowRef(getValues());\n\t\tconst unsubscribe = statusPlugin.subscribe(() => {\n\t\t\tstate.value = getValues();\n\t\t});\n\t\tonScopeDispose(unsubscribe);\n\t\treturn state;\n\t}\n\n\tconst status = shallowRef<RequirementTypeStatus>(statusPlugin.getStatus(typeOrTypes));\n\tconst unsubscribe = statusPlugin.subscribe(() => {\n\t\tstatus.value = statusPlugin.getStatus(typeOrTypes);\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn 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\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\trequirementId: string,\n): Ref<string | null> {\n\tassertSystem(\"useExplain\", system);\n\tconst explanation = ref<string | null>(system.explain(requirementId)) as Ref<string | null>;\n\n\tconst update = () => {\n\t\texplanation.value = system.explain(requirementId);\n\t};\n\n\tconst unsubFacts = system.facts.$store.subscribeAll(update);\n\tconst unsubSettled = system.onSettledChange(update);\n\tonScopeDispose(() => {\n\t\tunsubFacts();\n\t\tunsubSettled();\n\t});\n\n\treturn explanation;\n}\n\n// ============================================================================\n// useConstraintStatus — reactive constraint inspection\n// ============================================================================\n\n/** Get all constraints */\nexport function useConstraintStatus(\n\tsystem: SingleModuleSystem<any>,\n): ComputedRef<ConstraintInfo[]>;\n/** Get a single constraint by ID */\nexport function useConstraintStatus(\n\tsystem: SingleModuleSystem<any>,\n\tconstraintId: string,\n): ComputedRef<ConstraintInfo | null>;\n/** Implementation */\nexport function useConstraintStatus(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\tconstraintId?: string,\n): ComputedRef<ConstraintInfo[] | ConstraintInfo | null> {\n\tassertSystem(\"useConstraintStatus\", system);\n\tconst inspectState = useInspect(system);\n\n\treturn computed(() => {\n\t\t// Track reactivity via inspectState, but use full inspect() for constraint list\n\t\tvoid inspectState.value;\n\t\tconst fullInspection = system.inspect();\n\t\tif (!constraintId) return fullInspection.constraints;\n\t\treturn fullInspection.constraints.find((c) => c.id === constraintId) ?? null;\n\t});\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\nexport interface OptimisticUpdateResult {\n\tmutate: (updateFn: () => void) => void;\n\tisPending: Ref<boolean>;\n\terror: Ref<Error | null>;\n\trollback: () => 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\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\tstatusPlugin?: StatusPlugin,\n\trequirementType?: string,\n): OptimisticUpdateResult {\n\tassertSystem(\"useOptimisticUpdate\", system);\n\tconst isPending = ref(false);\n\tconst error = ref<Error | null>(null) as Ref<Error | null>;\n\tlet snapshot: SystemSnapshot | null = null;\n\tlet unsubscribe: (() => void) | null = null;\n\n\tconst rollback = () => {\n\t\tif (snapshot) {\n\t\t\tsystem.restore(snapshot);\n\t\t\tsnapshot = null;\n\t\t}\n\t\tisPending.value = false;\n\t\terror.value = null;\n\t\tunsubscribe?.();\n\t\tunsubscribe = null;\n\t};\n\n\tconst mutate = (updateFn: () => void) => {\n\t\tsnapshot = system.getSnapshot();\n\t\tisPending.value = true;\n\t\terror.value = null;\n\t\tsystem.batch(updateFn);\n\n\t\t// Watch for resolver completion/failure\n\t\tif (statusPlugin && requirementType) {\n\t\t\tunsubscribe?.();\n\t\t\tunsubscribe = statusPlugin.subscribe(() => {\n\t\t\t\tconst status = statusPlugin.getStatus(requirementType);\n\t\t\t\tif (!status.isLoading && !status.hasError) {\n\t\t\t\t\tsnapshot = null;\n\t\t\t\t\tisPending.value = false;\n\t\t\t\t\tunsubscribe?.();\n\t\t\t\t\tunsubscribe = null;\n\t\t\t\t} else if (status.hasError) {\n\t\t\t\t\terror.value = status.lastError;\n\t\t\t\t\trollback();\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t};\n\n\tonScopeDispose(() => {\n\t\tunsubscribe?.();\n\t});\n\n\treturn { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// useTimeTravel — reactive time-travel state\n// ============================================================================\n\n/**\n * Reactive time-travel composable. Returns a ShallowRef that updates\n * when snapshots are taken or navigation occurs.\n *\n * @example\n * ```vue\n * const tt = useTimeTravel(system);\n * <button :disabled=\"!tt.value?.canUndo\" @click=\"tt.value?.undo()\">Undo</button>\n * ```\n */\nexport function useTimeTravel(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n): ShallowRef<ReturnType<typeof buildTimeTravelState>> {\n\tassertSystem(\"useTimeTravel\", system);\n\tconst state = shallowRef<ReturnType<typeof buildTimeTravelState>>(buildTimeTravelState(system));\n\tconst unsub = system.onTimeTravelChange(() => {\n\t\tstate.value = buildTimeTravelState(system);\n\t});\n\tonScopeDispose(unsub);\n\treturn state;\n}\n\n// ============================================================================\n// Scoped System Composable\n// ============================================================================\n\n/** Configuration for useDirective */\ninterface UseDirectiveConfig {\n\t// biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n\tplugins?: Plugin<any>[];\n\tdebug?: DebugConfig;\n\terrorBoundary?: ErrorBoundaryConfig;\n\ttickMs?: number;\n\tzeroConfig?: boolean;\n\t// biome-ignore lint/suspicious/noExplicitAny: Facts type varies\n\tinitialFacts?: Record<string, any>;\n\tstatus?: boolean;\n\t/** Fact keys to subscribe to (omit for all) */\n\tfacts?: string[];\n\t/** Derivation keys to subscribe to (omit for all) */\n\tderived?: 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 state.\n *\n * @example\n * ```vue\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\tmoduleDef: ModuleDef<M>,\n\tconfig?: UseDirectiveConfig,\n) {\n\tconst allPlugins = [...(config?.plugins ?? [])];\n\tlet statusPlugin: StatusPlugin | undefined;\n\n\tif (config?.status) {\n\t\tconst sp = createRequirementStatusPlugin();\n\t\tstatusPlugin = sp;\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Plugin generic issues\n\t\tallPlugins.push(sp.plugin as Plugin<any>);\n\t}\n\n\t// biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n\tconst system = createSystem({\n\t\tmodule: moduleDef,\n\t\tplugins: allPlugins.length > 0 ? allPlugins : undefined,\n\t\tdebug: config?.debug,\n\t\terrorBoundary: config?.errorBoundary,\n\t\ttickMs: config?.tickMs,\n\t\tzeroConfig: config?.zeroConfig,\n\t\tinitialFacts: config?.initialFacts,\n\t} as any) as unknown as SingleModuleSystem<M>;\n\n\tsystem.start();\n\n\tonScopeDispose(() => {\n\t\tsystem.destroy();\n\t});\n\n\tconst factKeys = config?.facts;\n\tconst derivedKeys = config?.derived;\n\tconst subscribeAll = !factKeys && !derivedKeys;\n\n\t// Subscribe to facts\n\tconst factsState = shallowRef(\n\t\tsubscribeAll\n\t\t\t? (system.facts.$store.toObject() as InferFacts<M>)\n\t\t\t: pickFacts(system, factKeys ?? []),\n\t);\n\tconst unsubFacts = subscribeAll\n\t\t? system.facts.$store.subscribeAll(() => {\n\t\t\tfactsState.value = system.facts.$store.toObject() as InferFacts<M>;\n\t\t})\n\t\t: factKeys && factKeys.length > 0\n\t\t\t? system.facts.$store.subscribe(factKeys, () => {\n\t\t\t\tfactsState.value = pickFacts(system, factKeys) as InferFacts<M>;\n\t\t\t})\n\t\t\t: null;\n\n\t// Subscribe to derivations\n\tconst allDerivationKeys = subscribeAll ? Object.keys(system.derive ?? {}) : (derivedKeys ?? []);\n\tconst getDerived = (): InferDerivations<M> => {\n\t\tconst result: Record<string, unknown> = {};\n\t\tfor (const key of allDerivationKeys) {\n\t\t\tresult[key] = system.read(key);\n\t\t}\n\t\treturn result as InferDerivations<M>;\n\t};\n\tconst derivedState = shallowRef(getDerived());\n\tconst unsubDerived = allDerivationKeys.length > 0\n\t\t? system.subscribe(allDerivationKeys, () => { derivedState.value = getDerived(); })\n\t\t: null;\n\n\tonScopeDispose(() => {\n\t\tunsubFacts?.();\n\t\tunsubDerived?.();\n\t});\n\n\tconst events = system.events;\n\tconst dispatch = (event: InferEvents<M>) => system.dispatch(event);\n\n\treturn {\n\t\tsystem,\n\t\tfacts: factsState as ShallowRef<InferFacts<M>>,\n\t\tderived: derivedState as ShallowRef<InferDerivations<M>>,\n\t\tevents,\n\t\tdispatch,\n\t\tstatusPlugin,\n\t};\n}\n\n// ============================================================================\n// Typed Hooks Factory\n// ============================================================================\n\nexport function createTypedHooks<M extends ModuleSchema>(): {\n\tuseFact: <K extends keyof InferFacts<M> & string>(\n\t\tsystem: SingleModuleSystem<M>,\n\t\tfactKey: K,\n\t) => Ref<InferFacts<M>[K] | undefined>;\n\tuseDerived: <K extends keyof InferDerivations<M> & string>(\n\t\tsystem: SingleModuleSystem<M>,\n\t\tderivationId: K,\n\t) => Ref<InferDerivations<M>[K]>;\n\tuseDispatch: (system: SingleModuleSystem<M>) => (event: InferEvents<M>) => void;\n\tuseEvents: (system: SingleModuleSystem<M>) => SingleModuleSystem<M>[\"events\"];\n\tuseWatch: <K extends string>(\n\t\tsystem: SingleModuleSystem<M>,\n\t\tkey: K,\n\t\tcallback: (newValue: unknown, previousValue: unknown) => void,\n\t) => void;\n} {\n\treturn {\n\t\tuseFact: <K extends keyof InferFacts<M> & string>(system: SingleModuleSystem<M>, factKey: K) =>\n\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Type narrowing for internal call\n\t\t\tuseFact(system as SingleModuleSystem<any>, factKey) as Ref<InferFacts<M>[K] | undefined>,\n\t\tuseDerived: <K extends keyof InferDerivations<M> & string>(system: SingleModuleSystem<M>, derivationId: K) =>\n\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Type narrowing for internal call\n\t\t\tuseDerived(system as SingleModuleSystem<any>, derivationId) as Ref<InferDerivations<M>[K]>,\n\t\tuseDispatch: (system: SingleModuleSystem<M>) => {\n\t\t\treturn (event: InferEvents<M>) => {\n\t\t\t\tsystem.dispatch(event);\n\t\t\t};\n\t\t},\n\t\tuseEvents: (system: SingleModuleSystem<M>) => useEvents<M>(system),\n\t\tuseWatch: <K extends string>(\n\t\t\tsystem: SingleModuleSystem<M>,\n\t\t\tkey: K,\n\t\t\tcallback: (newValue: unknown, previousValue: unknown) => void,\n\t\t) =>\n\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Type narrowing for internal call\n\t\t\tuseWatch(system as SingleModuleSystem<any>, key, callback),\n\t};\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts"],"names":["useFact","system","keyOrKeys","assertSystem","_useFactMulti","_useFactSingle","factKey","value","ref","unsubscribe","onScopeDispose","factKeys","getValues","result","key","state","shallowRef","useDerived","idOrIds","_useDerivedMulti","_useDerivedSingle","derivationId","derivationIds","id","useSelector","selector","equalityFn","defaultEquality","deriveKeySet","runWithTracking","runTrackedSelector","initial","trackedFactKeys","trackedDeriveKeys","selected","unsubs","resubscribe","unsub","onUpdate","depsChanged","useDispatch","event","useEvents","useWatch","callback","useInspect","options","computeInspectState","update","throttled","cleanup","createThrottle","unsubFacts","unsubSettled","useRequirementStatus","statusPlugin","typeOrTypes","type","status","useExplain","requirementId","explanation","useConstraintStatus","constraintId","inspectState","computed","fullInspection","c","useOptimisticUpdate","requirementType","isPending","error","snapshot","rollback","mutate","updateFn","useTimeTravel","buildTimeTravelState","useDirective","moduleDef","config","allPlugins","sp","createRequirementStatusPlugin","createSystem","derivedKeys","subscribeAll","factsState","pickFacts","allDerivationKeys","getDerived","derivedState","unsubDerived","events","createTypedHooks","useNamespacedSelector","keys"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Vue Adapter - Vue 3 composables for Directive\n *\n * Exports: useFact, useDerived, useDispatch, useSelector,\n * useWatch, useInspect, useRequirementStatus, useEvents, useExplain,\n * useConstraintStatus, useOptimisticUpdate, useDirective, useTimeTravel,\n * createTypedHooks, shallowEqual\n */\n\nimport type {\n DebugConfig,\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 buildTimeTravelState,\n computeInspectState,\n createThrottle,\n defaultEquality,\n depsChanged,\n pickFacts,\n runTrackedSelector,\n shallowEqual,\n} from \"@directive-run/core/adapter-utils\";\nimport {\n type ComputedRef,\n type Ref,\n type ShallowRef,\n computed,\n onScopeDispose,\n ref,\n shallowRef,\n} from \"vue\";\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>(system: SingleModuleSystem<S>, factKey: K): Ref<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): ShallowRef<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): Ref<unknown> | ShallowRef<unknown> {\n assertSystem(\"useFact\", system);\n if (\n process.env.NODE_ENV !== \"production\" &&\n typeof keyOrKeys === \"function\"\n ) {\n console.error(\n \"[Directive] useFact() received a function. Did you mean useSelector()? \" +\n \"useFact() takes a string key or array of keys, not a selector function.\",\n );\n }\n\n // Multi-key path: useFact(system, [keys])\n if (Array.isArray(keyOrKeys)) {\n return _useFactMulti(system, keyOrKeys);\n }\n\n // Single key path: useFact(system, key)\n return _useFactSingle(system, keyOrKeys);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactSingle(\n system: SingleModuleSystem<any>,\n factKey: string,\n): Ref<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 = ref(system.facts.$store.get(factKey));\n const unsubscribe = system.facts.$store.subscribe([factKey], () => {\n value.value = system.facts.$store.get(factKey);\n });\n onScopeDispose(unsubscribe);\n return value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactMulti(\n system: SingleModuleSystem<any>,\n factKeys: string[],\n): ShallowRef<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 = shallowRef(getValues());\n const unsubscribe = system.facts.$store.subscribe(factKeys, () => {\n state.value = getValues();\n });\n onScopeDispose(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>(system: SingleModuleSystem<S>, derivationId: K): Ref<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): ShallowRef<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): Ref<unknown> | ShallowRef<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): Ref<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 = ref(system.read(derivationId));\n const unsubscribe = system.subscribe([derivationId], () => {\n value.value = system.read(derivationId);\n });\n onScopeDispose(unsubscribe);\n return value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedMulti(\n system: SingleModuleSystem<any>,\n derivationIds: string[],\n): ShallowRef<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 = shallowRef(getValues());\n const unsubscribe = system.subscribe(derivationIds, () => {\n state.value = getValues();\n });\n onScopeDispose(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): Ref<R>;\nexport function useSelector(\n // biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n system: SingleModuleSystem<any>,\n selector: (state: Record<string, unknown>) => unknown,\n equalityFn: (a: unknown, b: unknown) => boolean = defaultEquality,\n): Ref<unknown> {\n assertSystem(\"useSelector\", system);\n const deriveKeySet = new Set(Object.keys(system.derive ?? {}));\n\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 = ref(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 if (!equalityFn(selected.value, result.value)) {\n selected.value = result.value;\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 onScopeDispose(() => {\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 onScopeDispose(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 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): ShallowRef<InspectState> {\n assertSystem(\"useInspect\", system);\n const state = shallowRef<InspectState>(computeInspectState(system));\n\n const update = () => {\n state.value = 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 onScopeDispose(() => {\n cleanup();\n unsubFacts();\n unsubSettled();\n });\n } else {\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onScopeDispose(() => {\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): ShallowRef<RequirementTypeStatus>;\n/** Multi-type overload */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n types: string[],\n): ShallowRef<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useRequirementStatus(\n statusPlugin: StatusPlugin,\n typeOrTypes: string | string[],\n):\n | ShallowRef<RequirementTypeStatus>\n | ShallowRef<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 = shallowRef(getValues());\n const unsubscribe = statusPlugin.subscribe(() => {\n state.value = getValues();\n });\n onScopeDispose(unsubscribe);\n return state;\n }\n\n const status = shallowRef<RequirementTypeStatus>(\n statusPlugin.getStatus(typeOrTypes),\n );\n const unsubscribe = statusPlugin.subscribe(() => {\n status.value = statusPlugin.getStatus(typeOrTypes);\n });\n onScopeDispose(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): Ref<string | null> {\n assertSystem(\"useExplain\", system);\n const explanation = ref<string | null>(system.explain(requirementId)) as Ref<\n string | null\n >;\n\n const update = () => {\n explanation.value = system.explain(requirementId);\n };\n\n const unsubFacts = system.facts.$store.subscribeAll(update);\n const unsubSettled = system.onSettledChange(update);\n onScopeDispose(() => {\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): ComputedRef<ConstraintInfo[]>;\n/** Get a single constraint by ID */\nexport function useConstraintStatus(\n system: SingleModuleSystem<any>,\n constraintId: string,\n): ComputedRef<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): ComputedRef<ConstraintInfo[] | ConstraintInfo | null> {\n assertSystem(\"useConstraintStatus\", system);\n const inspectState = useInspect(system);\n\n return computed(() => {\n // Track reactivity via inspectState, but use full inspect() for constraint list\n void inspectState.value;\n const fullInspection = system.inspect();\n if (!constraintId) return fullInspection.constraints;\n return (\n fullInspection.constraints.find((c) => c.id === constraintId) ?? null\n );\n });\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\nexport interface OptimisticUpdateResult {\n mutate: (updateFn: () => void) => void;\n isPending: Ref<boolean>;\n error: Ref<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 = ref(false);\n const error = ref<Error | null>(null) as Ref<Error | null>;\n let snapshot: SystemSnapshot | null = null;\n let unsubscribe: (() => void) | null = null;\n\n const rollback = () => {\n if (snapshot) {\n system.restore(snapshot);\n snapshot = null;\n }\n isPending.value = false;\n error.value = null;\n unsubscribe?.();\n unsubscribe = null;\n };\n\n const mutate = (updateFn: () => void) => {\n snapshot = system.getSnapshot();\n isPending.value = true;\n error.value = null;\n system.batch(updateFn);\n\n // Watch for resolver completion/failure\n if (statusPlugin && requirementType) {\n unsubscribe?.();\n unsubscribe = statusPlugin.subscribe(() => {\n const status = statusPlugin.getStatus(requirementType);\n if (!status.isLoading && !status.hasError) {\n snapshot = null;\n isPending.value = false;\n unsubscribe?.();\n unsubscribe = null;\n } else if (status.hasError) {\n error.value = status.lastError;\n rollback();\n }\n });\n }\n };\n\n onScopeDispose(() => {\n unsubscribe?.();\n });\n\n return { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// useTimeTravel — reactive time-travel state\n// ============================================================================\n\n/**\n * Reactive time-travel composable. Returns a ShallowRef that updates\n * when snapshots are taken or navigation occurs.\n *\n * @example\n * ```vue\n * const tt = useTimeTravel(system);\n * <button :disabled=\"!tt.value?.canUndo\" @click=\"tt.value?.undo()\">Undo</button>\n * ```\n */\nexport function useTimeTravel(\n // biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n system: SingleModuleSystem<any>,\n): ShallowRef<ReturnType<typeof buildTimeTravelState>> {\n assertSystem(\"useTimeTravel\", system);\n const state = shallowRef<ReturnType<typeof buildTimeTravelState>>(\n buildTimeTravelState(system),\n );\n const unsub = system.onTimeTravelChange(() => {\n state.value = buildTimeTravelState(system);\n });\n onScopeDispose(unsub);\n return state;\n}\n\n// ============================================================================\n// Scoped System Composable\n// ============================================================================\n\n/** Configuration for useDirective */\ninterface UseDirectiveConfig {\n // biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n plugins?: Plugin<any>[];\n debug?: DebugConfig;\n errorBoundary?: ErrorBoundaryConfig;\n tickMs?: number;\n zeroConfig?: boolean;\n // biome-ignore lint/suspicious/noExplicitAny: Facts type varies\n initialFacts?: Record<string, any>;\n 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 state.\n *\n * @example\n * ```vue\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 debug: config?.debug,\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 onScopeDispose(() => {\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 = shallowRef(\n subscribeAll\n ? (system.facts.$store.toObject() as InferFacts<M>)\n : pickFacts(system, factKeys ?? []),\n );\n const unsubFacts = subscribeAll\n ? system.facts.$store.subscribeAll(() => {\n factsState.value = system.facts.$store.toObject() as InferFacts<M>;\n })\n : factKeys && factKeys.length > 0\n ? system.facts.$store.subscribe(factKeys, () => {\n factsState.value = 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 = shallowRef(getDerived());\n const unsubDerived =\n allDerivationKeys.length > 0\n ? system.subscribe(allDerivationKeys, () => {\n derivedState.value = getDerived();\n })\n : null;\n\n onScopeDispose(() => {\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 ShallowRef<InferFacts<M>>,\n derived: derivedState as ShallowRef<InferDerivations<M>>,\n events,\n dispatch,\n statusPlugin,\n };\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 ) => Ref<InferFacts<M>[K] | undefined>;\n useDerived: <K extends keyof InferDerivations<M> & string>(\n system: SingleModuleSystem<M>,\n derivationId: K,\n ) => Ref<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: Type narrowing for internal call\n useFact(system as SingleModuleSystem<any>, factKey) as Ref<\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: Type narrowing for internal call\n useDerived(system as SingleModuleSystem<any>, derivationId) as Ref<\n InferDerivations<M>[K]\n >,\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: Type narrowing for internal call\n useWatch(system as SingleModuleSystem<any>, key, callback),\n };\n}\n\n// ============================================================================\n// useNamespacedSelector — select from a NamespacedSystem\n// ============================================================================\n\n/**\n * Reactive composable to select from a NamespacedSystem.\n * Subscribes to specified keys and returns a Vue ref.\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 * ```vue\n * const system = useDirectiveRef({ modules: { auth, data } });\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): Ref<R> {\n const value = ref(selector(system)) as Ref<R>;\n const unsubscribe = system.subscribe(keys, () => {\n value.value = selector(system) as R;\n });\n onScopeDispose(unsubscribe);\n\n return value;\n}\n"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@directive-run/vue",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Vue composition API adapter for Directive.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Jason Comes",
|
|
@@ -52,7 +52,7 @@
|
|
|
52
52
|
"vue": "^3.4.0",
|
|
53
53
|
"tsup": "^8.3.5",
|
|
54
54
|
"typescript": "^5.7.2",
|
|
55
|
-
"@directive-run/core": "0.
|
|
55
|
+
"@directive-run/core": "0.4.0"
|
|
56
56
|
},
|
|
57
57
|
"scripts": {
|
|
58
58
|
"build": "tsup",
|