@directive-run/vue 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jason Comes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# @directive-run/vue
+
+Vue 3 composition API adapter for Directive. Provides reactive `ref` and `shallowRef` composables for reading facts, derivations, and dispatching events.
+
+## Install
+
+```bash
+npm install @directive-run/core @directive-run/vue
+```
+
+## Usage
+
+```vue
+<script setup>
+import { useFact, useDerived, useEvents } from "@directive-run/vue";
+
+const count = useFact(system, "count");
+const doubled = useDerived(system, "doubled");
+const events = useEvents(system);
+</script>
+
+<template>
+  <p>Count: {{ count }} (doubled: {{ doubled }})</p>
+  <button @click="events.increment()">+</button>
+</template>
+```
+
+## Exports
+
+`useFact`, `useDerived`, `useSelector`, `useDispatch`, `useEvents`, `useWatch`, `useInspect`, `useRequirementStatus`, `useExplain`, `useConstraintStatus`, `useOptimisticUpdate`, `useTimeTravel`, `useDirective`, `createTypedHooks`, `shallowEqual`
+
+## Peer Dependencies
+
+- `vue >= 3`
+- `@directive-run/core`
+
+## License
+
+MIT
+
+[Full documentation](https://directive.run/docs)

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var vue=require('vue'),core=require('@directive-run/core'),adapterUtils=require('@directive-run/core/adapter-utils');function C(e,t){return adapterUtils.assertSystem("useFact",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useFact() received a function. Did you mean useSelector()? useFact() takes a string key or array of keys, not a selector function."),Array.isArray(t)?V(e,t):T(e,t)}function T(e,t){process.env.NODE_ENV!=="production"&&(e.facts.$store.has(t)||console.warn(`[Directive] useFact("${t}") \u2014 fact not found in store. Check that "${t}" is defined in your module's schema.`));let s=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 u={};for(let r of t)u[r]=e.facts.$store.get(r);return u},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 u={};for(let r of t)u[r]=e.read(r);return u},o=vue.shallowRef(s()),n=e.subscribe(t,()=>{o.value=s();});return vue.onScopeDispose(n),o}function O(e,t,s=adapterUtils.defaultEquality){adapterUtils.assertSystem("useSelector",e);let o=new Set(Object.keys(e.derive??{})),n=()=>adapterUtils.runTrackedSelector(e,o,t),u=n(),r=u.factKeys,i=u.deriveKeys,l=vue.ref(u.value),S=[],c=()=>{for(let d of S)d();S.length=0;let g=()=>{let d=n();s(l.value,d.value)||(l.value=d.value),adapterUtils.depsChanged(r,d.factKeys,i,d.deriveKeys)&&(r=d.factKeys,i=d.deriveKeys,c());};r.length>0?S.push(e.facts.$store.subscribe(r,g)):i.length===0&&S.push(e.facts.$store.subscribeAll(g)),i.length>0&&S.push(e.subscribe(i,g));};return c(),vue.onScopeDispose(()=>{for(let g of S)g();}),l}function H(e){return adapterUtils.assertSystem("useDispatch",e),t=>{e.dispatch(t);}}function P(e){return adapterUtils.assertSystem("useEvents",e),e.events}function U(e,t,s,o){adapterUtils.assertSystem("useWatch",e);let n=t==="fact"&&typeof s=="string"&&typeof o=="function",u=n?s:t,r=n?o:s,i=e.watch(u,r);vue.onScopeDispose(i);}function W(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:u}=adapterUtils.createThrottle(o,t.throttleMs),r=e.facts.$store.subscribeAll(n),i=e.onSettledChange(n);vue.onScopeDispose(()=>{u(),r(),i();});}else {let n=e.facts.$store.subscribeAll(o),u=e.onSettledChange(o);vue.onScopeDispose(()=>{n(),u();});}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},u=vue.shallowRef(n()),r=e.subscribe(()=>{u.value=n();});return vue.onScopeDispose(r),u}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),u=e.onSettledChange(o);return vue.onScopeDispose(()=>{n(),u();}),s}function J(e,t){adapterUtils.assertSystem("useConstraintStatus",e);let s=W(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),u=null,r=null,i=()=>{u&&(e.restore(u),u=null),o.value=false,n.value=null,r?.(),r=null;},l=S=>{u=e.getSnapshot(),o.value=true,n.value=null,e.batch(S),t&&s&&(r?.(),r=t.subscribe(()=>{let c=t.getStatus(s);!c.isLoading&&!c.hasError?(u=null,o.value=false,r?.(),r=null):c.hasError&&(n.value=c.lastError,i());}));};return vue.onScopeDispose(()=>{r?.();}),{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 u=t?.facts,r=t?.derived,i=!u&&!r,l=vue.shallowRef(i?n.facts.$store.toObject():adapterUtils.pickFacts(n,u??[])),S=i?n.facts.$store.subscribeAll(()=>{l.value=n.facts.$store.toObject();}):u&&u.length>0?n.facts.$store.subscribe(u,()=>{l.value=adapterUtils.pickFacts(n,u);}):null,c=i?Object.keys(n.derive??{}):r??[],g=()=>{let v={};for(let M of c)v[M]=n.read(M);return v},d=vue.shallowRef(g()),R=c.length>0?n.subscribe(c,()=>{d.value=g();}):null;vue.onScopeDispose(()=>{S?.(),R?.();});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)=>C(e,t),useDerived:(e,t)=>$(e,t),useDispatch:e=>t=>{e.dispatch(t);},useEvents:e=>P(e),useWatch:(e,t,s)=>U(e,t,s)}}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=C;exports.useInspect=W;exports.useOptimisticUpdate=Q;exports.useRequirementStatus=L;exports.useSelector=O;exports.useTimeTravel=X;exports.useWatch=U;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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","derivationIdOrKind","callbackOrFactKey","maybeCallback","isFact","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<R>(\n\t// biome-ignore lint/suspicious/noExplicitAny: Backward-compatible fallback\n\tsystem: SingleModuleSystem<any>,\n\t// biome-ignore lint/suspicious/noExplicitAny: Selector receives dynamic state\n\tselector: (state: Record<string, any>) => R,\n\tequalityFn?: (a: R, b: R) => boolean,\n): 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/**\n * Watch a fact by explicit \"fact\" discriminator.\n * @deprecated Use `useWatch(system, key, callback)` instead — facts are now auto-detected.\n */\nexport function useWatch<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(\n\tsystem: SingleModuleSystem<S>,\n\tkind: \"fact\",\n\tfactKey: K,\n\tcallback: (newValue: InferFacts<S>[K] | undefined, previousValue: InferFacts<S>[K] | undefined) => void,\n): void;\n/** Watch a fact or derivation (generic fallback) */\nexport function useWatch<T>(\n\t// biome-ignore lint/suspicious/noExplicitAny: Backward-compatible fallback\n\tsystem: SingleModuleSystem<any>,\n\tkey: string,\n\tcallback: (newValue: T, previousValue: T | undefined) => void,\n): void;\n/** Implementation */\nexport function useWatch(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tderivationIdOrKind: string,\n\tcallbackOrFactKey: string | ((newValue: unknown, prevValue: unknown) => void),\n\tmaybeCallback?: (newValue: unknown, prevValue: unknown) => void,\n): void {\n\tassertSystem(\"useWatch\", system);\n\t// Backward compat: useWatch(system, \"fact\", factKey, callback)\n\tconst isFact =\n\t\tderivationIdOrKind === \"fact\" &&\n\t\ttypeof callbackOrFactKey === \"string\" &&\n\t\ttypeof maybeCallback === \"function\";\n\n\tconst key = isFact ? (callbackOrFactKey as string) : derivationIdOrKind;\n\tconst callback = isFact\n\t\t? maybeCallback!\n\t\t: (callbackOrFactKey as (newValue: unknown, prevValue: unknown) => void);\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"]}

package/dist/index.d.cts

@@ -0,0 +1,144 @@
+import { Ref, ComputedRef, ShallowRef } from 'vue';
+import { createRequirementStatusPlugin, ModuleSchema, InferFacts, SingleModuleSystem, InferDerivations, InferEvents, ModuleDef, Plugin, DebugConfig, ErrorBoundaryConfig, RequirementTypeStatus, InferSelectorState } from '@directive-run/core';
+export { RequirementTypeStatus } from '@directive-run/core';
+import { ConstraintInfo, InspectState, buildTimeTravelState } from '@directive-run/core/adapter-utils';
+export { ConstraintInfo, InspectState, shallowEqual } from '@directive-run/core/adapter-utils';
+
+/**
+ * Vue Adapter - Vue 3 composables for Directive
+ *
+ * Exports: useFact, useDerived, useDispatch, useSelector,
+ * useWatch, useInspect, useRequirementStatus, useEvents, useExplain,
+ * useConstraintStatus, useOptimisticUpdate, useDirective, useTimeTravel,
+ * createTypedHooks, shallowEqual
+ */
+
+/** Type for the requirement status plugin return value */
+type StatusPlugin = ReturnType<typeof createRequirementStatusPlugin>;
+/** Single key overload */
+declare function useFact<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, factKey: K): Ref<InferFacts<S>[K] | undefined>;
+/** Multi-key overload */
+declare function useFact<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, factKeys: K[]): ShallowRef<Pick<InferFacts<S>, K>>;
+/** Single key overload */
+declare function useDerived<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, derivationId: K): Ref<InferDerivations<S>[K]>;
+/** Multi-key overload */
+declare function useDerived<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, derivationIds: K[]): ShallowRef<Pick<InferDerivations<S>, K>>;
+/**
+ * Auto-tracking selector over facts and derivations.
+ * Uses `withTracking()` to detect which facts the selector accesses,
+ * then subscribes only to those keys.
+ */
+declare function useSelector<S extends ModuleSchema, R>(system: SingleModuleSystem<S>, selector: (state: InferSelectorState<S>) => R, equalityFn?: (a: R, b: R) => boolean): Ref<R>;
+declare function useSelector<R>(system: SingleModuleSystem<any>, selector: (state: Record<string, any>) => R, equalityFn?: (a: R, b: R) => boolean): Ref<R>;
+declare function useDispatch<S extends ModuleSchema>(system: SingleModuleSystem<S>): (event: InferEvents<S>) => void;
+/**
+ * Returns the system's events dispatcher.
+ */
+declare function useEvents<S extends ModuleSchema>(system: SingleModuleSystem<S>): SingleModuleSystem<S>["events"];
+/** Watch a derivation or fact by key (auto-detected). When a key exists in both facts and derivations, the derivation overload takes priority. */
+declare function useWatch<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, key: K, callback: (newValue: InferDerivations<S>[K], previousValue: InferDerivations<S>[K] | undefined) => void): void;
+/** Watch a fact key with auto-detection. */
+declare function useWatch<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, key: K, callback: (newValue: InferFacts<S>[K] | undefined, previousValue: InferFacts<S>[K] | undefined) => void): void;
+/**
+ * Watch a fact by explicit "fact" discriminator.
+ * @deprecated Use `useWatch(system, key, callback)` instead — facts are now auto-detected.
+ */
+declare function useWatch<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, kind: "fact", factKey: K, callback: (newValue: InferFacts<S>[K] | undefined, previousValue: InferFacts<S>[K] | undefined) => void): void;
+/** Watch a fact or derivation (generic fallback) */
+declare function useWatch<T>(system: SingleModuleSystem<any>, key: string, callback: (newValue: T, previousValue: T | undefined) => void): void;
+/** Options for useInspect */
+interface UseInspectOptions {
+    throttleMs?: number;
+}
+/**
+ * Consolidated system inspection hook.
+ * Returns InspectState with optional throttling.
+ */
+declare function useInspect(system: SingleModuleSystem<any>, options?: UseInspectOptions): ShallowRef<InspectState>;
+/** Single type overload */
+declare function useRequirementStatus(statusPlugin: StatusPlugin, type: string): ShallowRef<RequirementTypeStatus>;
+/** Multi-type overload */
+declare function useRequirementStatus(statusPlugin: StatusPlugin, types: string[]): ShallowRef<Record<string, RequirementTypeStatus>>;
+/**
+ * Reactively returns the explanation string for a requirement.
+ */
+declare function useExplain(system: SingleModuleSystem<any>, requirementId: string): Ref<string | null>;
+/** Get all constraints */
+declare function useConstraintStatus(system: SingleModuleSystem<any>): ComputedRef<ConstraintInfo[]>;
+/** Get a single constraint by ID */
+declare function useConstraintStatus(system: SingleModuleSystem<any>, constraintId: string): ComputedRef<ConstraintInfo | null>;
+interface OptimisticUpdateResult {
+    mutate: (updateFn: () => void) => void;
+    isPending: Ref<boolean>;
+    error: Ref<Error | null>;
+    rollback: () => void;
+}
+/**
+ * Optimistic update hook. Saves a snapshot before mutating, monitors
+ * a requirement type via statusPlugin, and rolls back on failure.
+ */
+declare function useOptimisticUpdate(system: SingleModuleSystem<any>, statusPlugin?: StatusPlugin, requirementType?: string): OptimisticUpdateResult;
+/**
+ * Reactive time-travel composable. Returns a ShallowRef that updates
+ * when snapshots are taken or navigation occurs.
+ *
+ * @example
+ * ```vue
+ * const tt = useTimeTravel(system);
+ * <button :disabled="!tt.value?.canUndo" @click="tt.value?.undo()">Undo</button>
+ * ```
+ */
+declare function useTimeTravel(system: SingleModuleSystem<any>): ShallowRef<ReturnType<typeof buildTimeTravelState>>;
+/** Configuration for useDirective */
+interface UseDirectiveConfig {
+    plugins?: Plugin<any>[];
+    debug?: DebugConfig;
+    errorBoundary?: ErrorBoundaryConfig;
+    tickMs?: number;
+    zeroConfig?: boolean;
+    initialFacts?: Record<string, any>;
+    status?: boolean;
+    /** Fact keys to subscribe to (omit for all) */
+    facts?: string[];
+    /** Derivation keys to subscribe to (omit for all) */
+    derived?: string[];
+}
+/**
+ * Create a scoped Directive system with automatic lifecycle management.
+ * When no `facts` or `derived` keys are specified, subscribes to ALL
+ * facts and derivations and returns reactive state.
+ *
+ * @example
+ * ```vue
+ * // Subscribe to everything
+ * const { facts, derived, events, dispatch } = useDirective(counterModule);
+ *
+ * // Selective keys
+ * const { facts, derived } = useDirective(counterModule, { facts: ["count"], derived: ["doubled"] });
+ * ```
+ */
+declare function useDirective<M extends ModuleSchema>(moduleDef: ModuleDef<M>, config?: UseDirectiveConfig): {
+    system: SingleModuleSystem<M>;
+    facts: ShallowRef<InferFacts<M>>;
+    derived: ShallowRef<InferDerivations<M>>;
+    events: M["events"] extends Record<string, unknown> ? { [E in keyof M["events"]]: M["events"][E] extends Record<string, unknown> ? keyof M["events"][E] extends never ? () => void : (payload: M["events"][E] extends infer T ? T extends M["events"][E] ? T extends Record<string, unknown> ? { [K in keyof T]: T[K] extends {
+        _type: infer T_1;
+    } ? T_1 : T[K]; } : never : never : never) => void : () => void; } : Record<string, never>;
+    dispatch: (event: InferEvents<M>) => void;
+    statusPlugin: {
+        plugin: Plugin<never>;
+        getStatus: (type: string) => RequirementTypeStatus;
+        getAllStatus: () => Map<string, RequirementTypeStatus>;
+        subscribe: (listener: () => void) => () => void;
+        reset: () => void;
+    } | undefined;
+};
+declare function createTypedHooks<M extends ModuleSchema>(): {
+    useFact: <K extends keyof InferFacts<M> & string>(system: SingleModuleSystem<M>, factKey: K) => Ref<InferFacts<M>[K] | undefined>;
+    useDerived: <K extends keyof InferDerivations<M> & string>(system: SingleModuleSystem<M>, derivationId: K) => Ref<InferDerivations<M>[K]>;
+    useDispatch: (system: SingleModuleSystem<M>) => (event: InferEvents<M>) => void;
+    useEvents: (system: SingleModuleSystem<M>) => SingleModuleSystem<M>["events"];
+    useWatch: <K extends string>(system: SingleModuleSystem<M>, key: K, callback: (newValue: unknown, previousValue: unknown) => void) => void;
+};
+
+export { type OptimisticUpdateResult, type StatusPlugin, type UseInspectOptions, createTypedHooks, useConstraintStatus, useDerived, useDirective, useDispatch, useEvents, useExplain, useFact, useInspect, useOptimisticUpdate, useRequirementStatus, useSelector, useTimeTravel, useWatch };

package/dist/index.d.ts

@@ -0,0 +1,144 @@
+import { Ref, ComputedRef, ShallowRef } from 'vue';
+import { createRequirementStatusPlugin, ModuleSchema, InferFacts, SingleModuleSystem, InferDerivations, InferEvents, ModuleDef, Plugin, DebugConfig, ErrorBoundaryConfig, RequirementTypeStatus, InferSelectorState } from '@directive-run/core';
+export { RequirementTypeStatus } from '@directive-run/core';
+import { ConstraintInfo, InspectState, buildTimeTravelState } from '@directive-run/core/adapter-utils';
+export { ConstraintInfo, InspectState, shallowEqual } from '@directive-run/core/adapter-utils';
+
+/**
+ * Vue Adapter - Vue 3 composables for Directive
+ *
+ * Exports: useFact, useDerived, useDispatch, useSelector,
+ * useWatch, useInspect, useRequirementStatus, useEvents, useExplain,
+ * useConstraintStatus, useOptimisticUpdate, useDirective, useTimeTravel,
+ * createTypedHooks, shallowEqual
+ */
+
+/** Type for the requirement status plugin return value */
+type StatusPlugin = ReturnType<typeof createRequirementStatusPlugin>;
+/** Single key overload */
+declare function useFact<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, factKey: K): Ref<InferFacts<S>[K] | undefined>;
+/** Multi-key overload */
+declare function useFact<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, factKeys: K[]): ShallowRef<Pick<InferFacts<S>, K>>;
+/** Single key overload */
+declare function useDerived<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, derivationId: K): Ref<InferDerivations<S>[K]>;
+/** Multi-key overload */
+declare function useDerived<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, derivationIds: K[]): ShallowRef<Pick<InferDerivations<S>, K>>;
+/**
+ * Auto-tracking selector over facts and derivations.
+ * Uses `withTracking()` to detect which facts the selector accesses,
+ * then subscribes only to those keys.
+ */
+declare function useSelector<S extends ModuleSchema, R>(system: SingleModuleSystem<S>, selector: (state: InferSelectorState<S>) => R, equalityFn?: (a: R, b: R) => boolean): Ref<R>;
+declare function useSelector<R>(system: SingleModuleSystem<any>, selector: (state: Record<string, any>) => R, equalityFn?: (a: R, b: R) => boolean): Ref<R>;
+declare function useDispatch<S extends ModuleSchema>(system: SingleModuleSystem<S>): (event: InferEvents<S>) => void;
+/**
+ * Returns the system's events dispatcher.
+ */
+declare function useEvents<S extends ModuleSchema>(system: SingleModuleSystem<S>): SingleModuleSystem<S>["events"];
+/** Watch a derivation or fact by key (auto-detected). When a key exists in both facts and derivations, the derivation overload takes priority. */
+declare function useWatch<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, key: K, callback: (newValue: InferDerivations<S>[K], previousValue: InferDerivations<S>[K] | undefined) => void): void;
+/** Watch a fact key with auto-detection. */
+declare function useWatch<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, key: K, callback: (newValue: InferFacts<S>[K] | undefined, previousValue: InferFacts<S>[K] | undefined) => void): void;
+/**
+ * Watch a fact by explicit "fact" discriminator.
+ * @deprecated Use `useWatch(system, key, callback)` instead — facts are now auto-detected.
+ */
+declare function useWatch<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, kind: "fact", factKey: K, callback: (newValue: InferFacts<S>[K] | undefined, previousValue: InferFacts<S>[K] | undefined) => void): void;
+/** Watch a fact or derivation (generic fallback) */
+declare function useWatch<T>(system: SingleModuleSystem<any>, key: string, callback: (newValue: T, previousValue: T | undefined) => void): void;
+/** Options for useInspect */
+interface UseInspectOptions {
+    throttleMs?: number;
+}
+/**
+ * Consolidated system inspection hook.
+ * Returns InspectState with optional throttling.
+ */
+declare function useInspect(system: SingleModuleSystem<any>, options?: UseInspectOptions): ShallowRef<InspectState>;
+/** Single type overload */
+declare function useRequirementStatus(statusPlugin: StatusPlugin, type: string): ShallowRef<RequirementTypeStatus>;
+/** Multi-type overload */
+declare function useRequirementStatus(statusPlugin: StatusPlugin, types: string[]): ShallowRef<Record<string, RequirementTypeStatus>>;
+/**
+ * Reactively returns the explanation string for a requirement.
+ */
+declare function useExplain(system: SingleModuleSystem<any>, requirementId: string): Ref<string | null>;
+/** Get all constraints */
+declare function useConstraintStatus(system: SingleModuleSystem<any>): ComputedRef<ConstraintInfo[]>;
+/** Get a single constraint by ID */
+declare function useConstraintStatus(system: SingleModuleSystem<any>, constraintId: string): ComputedRef<ConstraintInfo | null>;
+interface OptimisticUpdateResult {
+    mutate: (updateFn: () => void) => void;
+    isPending: Ref<boolean>;
+    error: Ref<Error | null>;
+    rollback: () => void;
+}
+/**
+ * Optimistic update hook. Saves a snapshot before mutating, monitors
+ * a requirement type via statusPlugin, and rolls back on failure.
+ */
+declare function useOptimisticUpdate(system: SingleModuleSystem<any>, statusPlugin?: StatusPlugin, requirementType?: string): OptimisticUpdateResult;
+/**
+ * Reactive time-travel composable. Returns a ShallowRef that updates
+ * when snapshots are taken or navigation occurs.
+ *
+ * @example
+ * ```vue
+ * const tt = useTimeTravel(system);
+ * <button :disabled="!tt.value?.canUndo" @click="tt.value?.undo()">Undo</button>
+ * ```
+ */
+declare function useTimeTravel(system: SingleModuleSystem<any>): ShallowRef<ReturnType<typeof buildTimeTravelState>>;
+/** Configuration for useDirective */
+interface UseDirectiveConfig {
+    plugins?: Plugin<any>[];
+    debug?: DebugConfig;
+    errorBoundary?: ErrorBoundaryConfig;
+    tickMs?: number;
+    zeroConfig?: boolean;
+    initialFacts?: Record<string, any>;
+    status?: boolean;
+    /** Fact keys to subscribe to (omit for all) */
+    facts?: string[];
+    /** Derivation keys to subscribe to (omit for all) */
+    derived?: string[];
+}
+/**
+ * Create a scoped Directive system with automatic lifecycle management.
+ * When no `facts` or `derived` keys are specified, subscribes to ALL
+ * facts and derivations and returns reactive state.
+ *
+ * @example
+ * ```vue
+ * // Subscribe to everything
+ * const { facts, derived, events, dispatch } = useDirective(counterModule);
+ *
+ * // Selective keys
+ * const { facts, derived } = useDirective(counterModule, { facts: ["count"], derived: ["doubled"] });
+ * ```
+ */
+declare function useDirective<M extends ModuleSchema>(moduleDef: ModuleDef<M>, config?: UseDirectiveConfig): {
+    system: SingleModuleSystem<M>;
+    facts: ShallowRef<InferFacts<M>>;
+    derived: ShallowRef<InferDerivations<M>>;
+    events: M["events"] extends Record<string, unknown> ? { [E in keyof M["events"]]: M["events"][E] extends Record<string, unknown> ? keyof M["events"][E] extends never ? () => void : (payload: M["events"][E] extends infer T ? T extends M["events"][E] ? T extends Record<string, unknown> ? { [K in keyof T]: T[K] extends {
+        _type: infer T_1;
+    } ? T_1 : T[K]; } : never : never : never) => void : () => void; } : Record<string, never>;
+    dispatch: (event: InferEvents<M>) => void;
+    statusPlugin: {
+        plugin: Plugin<never>;
+        getStatus: (type: string) => RequirementTypeStatus;
+        getAllStatus: () => Map<string, RequirementTypeStatus>;
+        subscribe: (listener: () => void) => () => void;
+        reset: () => void;
+    } | undefined;
+};
+declare function createTypedHooks<M extends ModuleSchema>(): {
+    useFact: <K extends keyof InferFacts<M> & string>(system: SingleModuleSystem<M>, factKey: K) => Ref<InferFacts<M>[K] | undefined>;
+    useDerived: <K extends keyof InferDerivations<M> & string>(system: SingleModuleSystem<M>, derivationId: K) => Ref<InferDerivations<M>[K]>;
+    useDispatch: (system: SingleModuleSystem<M>) => (event: InferEvents<M>) => void;
+    useEvents: (system: SingleModuleSystem<M>) => SingleModuleSystem<M>["events"];
+    useWatch: <K extends string>(system: SingleModuleSystem<M>, key: K, callback: (newValue: unknown, previousValue: unknown) => void) => void;
+};
+
+export { type OptimisticUpdateResult, type StatusPlugin, type UseInspectOptions, createTypedHooks, useConstraintStatus, useDerived, useDirective, useDispatch, useEvents, useExplain, useFact, useInspect, useOptimisticUpdate, useRequirementStatus, useSelector, useTimeTravel, useWatch };

package/dist/index.js

@@ -0,0 +1,2 @@
+import {ref,onScopeDispose,shallowRef,computed}from'vue';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';function C(e,t){return assertSystem("useFact",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useFact() received a function. Did you mean useSelector()? useFact() takes a string key or array of keys, not a selector function."),Array.isArray(t)?V(e,t):T(e,t)}function T(e,t){process.env.NODE_ENV!=="production"&&(e.facts.$store.has(t)||console.warn(`[Directive] useFact("${t}") \u2014 fact not found in store. Check that "${t}" is defined in your module's schema.`));let s=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 u={};for(let r of t)u[r]=e.facts.$store.get(r);return u},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 u={};for(let r of t)u[r]=e.read(r);return u},o=shallowRef(s()),n=e.subscribe(t,()=>{o.value=s();});return onScopeDispose(n),o}function O(e,t,s=defaultEquality){assertSystem("useSelector",e);let o=new Set(Object.keys(e.derive??{})),n=()=>runTrackedSelector(e,o,t),u=n(),r=u.factKeys,i=u.deriveKeys,l=ref(u.value),S=[],c=()=>{for(let d of S)d();S.length=0;let g=()=>{let d=n();s(l.value,d.value)||(l.value=d.value),depsChanged(r,d.factKeys,i,d.deriveKeys)&&(r=d.factKeys,i=d.deriveKeys,c());};r.length>0?S.push(e.facts.$store.subscribe(r,g)):i.length===0&&S.push(e.facts.$store.subscribeAll(g)),i.length>0&&S.push(e.subscribe(i,g));};return c(),onScopeDispose(()=>{for(let g of S)g();}),l}function H(e){return assertSystem("useDispatch",e),t=>{e.dispatch(t);}}function P(e){return assertSystem("useEvents",e),e.events}function U(e,t,s,o){assertSystem("useWatch",e);let n=t==="fact"&&typeof s=="string"&&typeof o=="function",u=n?s:t,r=n?o:s,i=e.watch(u,r);onScopeDispose(i);}function W(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:u}=createThrottle(o,t.throttleMs),r=e.facts.$store.subscribeAll(n),i=e.onSettledChange(n);onScopeDispose(()=>{u(),r(),i();});}else {let n=e.facts.$store.subscribeAll(o),u=e.onSettledChange(o);onScopeDispose(()=>{n(),u();});}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},u=shallowRef(n()),r=e.subscribe(()=>{u.value=n();});return onScopeDispose(r),u}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),u=e.onSettledChange(o);return onScopeDispose(()=>{n(),u();}),s}function J(e,t){assertSystem("useConstraintStatus",e);let s=W(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),u=null,r=null,i=()=>{u&&(e.restore(u),u=null),o.value=false,n.value=null,r?.(),r=null;},l=S=>{u=e.getSnapshot(),o.value=true,n.value=null,e.batch(S),t&&s&&(r?.(),r=t.subscribe(()=>{let c=t.getStatus(s);!c.isLoading&&!c.hasError?(u=null,o.value=false,r?.(),r=null):c.hasError&&(n.value=c.lastError,i());}));};return onScopeDispose(()=>{r?.();}),{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 u=t?.facts,r=t?.derived,i=!u&&!r,l=shallowRef(i?n.facts.$store.toObject():pickFacts(n,u??[])),S=i?n.facts.$store.subscribeAll(()=>{l.value=n.facts.$store.toObject();}):u&&u.length>0?n.facts.$store.subscribe(u,()=>{l.value=pickFacts(n,u);}):null,c=i?Object.keys(n.derive??{}):r??[],g=()=>{let v={};for(let M of c)v[M]=n.read(M);return v},d=shallowRef(g()),R=c.length>0?n.subscribe(c,()=>{d.value=g();}):null;onScopeDispose(()=>{S?.(),R?.();});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)=>C(e,t),useDerived:(e,t)=>$(e,t),useDispatch:e=>t=>{e.dispatch(t);},useEvents:e=>P(e),useWatch:(e,t,s)=>U(e,t,s)}}export{Z as createTypedHooks,J as useConstraintStatus,$ as useDerived,Y as useDirective,H as useDispatch,P as useEvents,G as useExplain,C as useFact,W as useInspect,Q as useOptimisticUpdate,L as useRequirementStatus,O as useSelector,X as useTimeTravel,U as useWatch};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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","derivationIdOrKind","callbackOrFactKey","maybeCallback","isFact","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":"gXAkEO,SAASA,CAAAA,CAEfC,CAAAA,CACAC,CAAAA,CACqC,CAUrC,OATAC,YAAAA,CAAa,UAAWF,CAAM,CAAA,CAC1B,OAAA,CAAQ,GAAA,CAAI,WAAa,YAAA,EAAgB,OAAOC,CAAAA,EAAc,UAAA,EACjE,QAAQ,KAAA,CACP,gJAED,CAAA,CAIG,KAAA,CAAM,OAAA,CAAQA,CAAS,CAAA,CACnBE,CAAAA,CAAcH,EAAQC,CAAS,CAAA,CAIhCG,CAAAA,CAAeJ,CAAAA,CAAQC,CAAS,CACxC,CAGA,SAASG,CAAAA,CAAeJ,EAAiCK,CAAAA,CAA+B,CACnF,OAAA,CAAQ,GAAA,CAAI,QAAA,GAAa,YAAA,GACvBL,CAAAA,CAAO,KAAA,CAAM,OAAO,GAAA,CAAIK,CAAO,CAAA,EACnC,OAAA,CAAQ,KACP,CAAA,qBAAA,EAAwBA,CAAO,CAAA,+CAAA,EAChBA,CAAO,uCACvB,CAAA,CAAA,CAIF,IAAMC,CAAAA,CAAQC,GAAAA,CAAIP,CAAAA,CAAO,KAAA,CAAM,MAAA,CAAO,GAAA,CAAIK,CAAO,CAAC,CAAA,CAC5CG,CAAAA,CAAcR,CAAAA,CAAO,MAAM,MAAA,CAAO,SAAA,CAAU,CAACK,CAAO,EAAG,IAAM,CAClEC,CAAAA,CAAM,KAAA,CAAQN,CAAAA,CAAO,KAAA,CAAM,MAAA,CAAO,GAAA,CAAIK,CAAO,EAC9C,CAAC,CAAA,CACD,OAAAI,eAAeD,CAAW,CAAA,CACnBF,CACR,CAGA,SAASH,CAAAA,CAAcH,CAAAA,CAAiCU,CAAAA,CAAyD,CAChH,IAAMC,CAAAA,CAAY,IAA+B,CAChD,IAAMC,CAAAA,CAAkC,EAAC,CACzC,IAAA,IAAWC,KAAOH,CAAAA,CACjBE,CAAAA,CAAOC,CAAG,CAAA,CAAIb,EAAO,KAAA,CAAM,MAAA,CAAO,GAAA,CAAIa,CAAG,CAAA,CAE1C,OAAOD,CACR,CAAA,CACME,EAAQC,UAAAA,CAAWJ,CAAAA,EAAW,CAAA,CAC9BH,EAAcR,CAAAA,CAAO,KAAA,CAAM,MAAA,CAAO,SAAA,CAAUU,EAAU,IAAM,CACjEI,CAAAA,CAAM,KAAA,CAAQH,CAAAA,GACf,CAAC,CAAA,CACD,OAAAF,cAAAA,CAAeD,CAAW,CAAA,CACnBM,CACR,CAWO,SAASE,CAAAA,CAEfhB,CAAAA,CACAiB,CAAAA,CACqC,CAUrC,OATAf,YAAAA,CAAa,YAAA,CAAcF,CAAM,CAAA,CAC7B,OAAA,CAAQ,GAAA,CAAI,QAAA,GAAa,cAAgB,OAAOiB,CAAAA,EAAY,UAAA,EAC/D,OAAA,CAAQ,MACP,sJAED,CAAA,CAIG,KAAA,CAAM,OAAA,CAAQA,CAAO,CAAA,CACjBC,CAAAA,CAAiBlB,CAAAA,CAAQiB,CAAO,CAAA,CAIjCE,CAAAA,CAAkBnB,CAAAA,CAAQiB,CAAO,CACzC,CAGA,SAASE,CAAAA,CAAkBnB,CAAAA,CAAiCoB,EAAoC,CAC3F,OAAA,CAAQ,GAAA,CAAI,QAAA,GAAa,cACPpB,CAAAA,CAAO,IAAA,CAAKoB,CAAY,CAAA,GACxB,MAAA,EACpB,OAAA,CAAQ,IAAA,CACP,CAAA,wBAAA,EAA2BA,CAAY,CAAA,mCAAA,EACxBA,CAAY,CAAA,8CAAA,CAC5B,CAAA,CAGF,IAAMd,CAAAA,CAAQC,GAAAA,CAAIP,CAAAA,CAAO,IAAA,CAAKoB,CAAY,CAAC,CAAA,CACrCZ,CAAAA,CAAcR,CAAAA,CAAO,SAAA,CAAU,CAACoB,CAAY,CAAA,CAAG,IAAM,CAC1Dd,CAAAA,CAAM,KAAA,CAAQN,CAAAA,CAAO,KAAKoB,CAAY,EACvC,CAAC,CAAA,CACD,OAAAX,cAAAA,CAAeD,CAAW,CAAA,CACnBF,CACR,CAGA,SAASY,CAAAA,CAAiBlB,CAAAA,CAAiCqB,EAA8D,CACxH,IAAMV,CAAAA,CAAY,IAA+B,CAChD,IAAMC,CAAAA,CAAkC,EAAC,CACzC,QAAWU,CAAAA,IAAMD,CAAAA,CAChBT,CAAAA,CAAOU,CAAE,EAAItB,CAAAA,CAAO,IAAA,CAAKsB,CAAE,CAAA,CAE5B,OAAOV,CACR,CAAA,CACME,CAAAA,CAAQC,UAAAA,CAAWJ,GAAW,CAAA,CAC9BH,CAAAA,CAAcR,CAAAA,CAAO,UAAUqB,CAAAA,CAAe,IAAM,CACzDP,CAAAA,CAAM,KAAA,CAAQH,CAAAA,GACf,CAAC,EACD,OAAAF,cAAAA,CAAeD,CAAW,CAAA,CACnBM,CACR,CAmBO,SAASS,CAAAA,CAEfvB,CAAAA,CACAwB,EACAC,CAAAA,CAAkDC,eAAAA,CACnC,CACfxB,YAAAA,CAAa,aAAA,CAAeF,CAAM,CAAA,CAClC,IAAM2B,EAAe,IAAI,GAAA,CAAI,MAAA,CAAO,IAAA,CAAK3B,EAAO,MAAA,EAAU,EAAE,CAAC,EAEvD4B,CAAAA,CAAkB,IAAMC,kBAAAA,CAAmB7B,CAAAA,CAAQ2B,CAAAA,CAAcH,CAAQ,CAAA,CAEzEM,CAAAA,CAAUF,GAAgB,CAC5BG,CAAAA,CAAkBD,CAAAA,CAAQ,QAAA,CAC1BE,EAAoBF,CAAAA,CAAQ,UAAA,CAC1BG,CAAAA,CAAW1B,GAAAA,CAAIuB,EAAQ,KAAK,CAAA,CAE5BI,CAAAA,CAA4B,EAAC,CAE7BC,CAAAA,CAAc,IAAM,CACzB,QAAWC,CAAAA,IAASF,CAAAA,CAAQE,CAAAA,EAAM,CAClCF,EAAO,MAAA,CAAS,CAAA,CAEhB,IAAMG,CAAAA,CAAW,IAAM,CACtB,IAAMzB,CAAAA,CAASgB,CAAAA,EAAgB,CAC1BH,CAAAA,CAAWQ,CAAAA,CAAS,KAAA,CAAOrB,EAAO,KAAK,CAAA,GAC3CqB,CAAAA,CAAS,KAAA,CAAQrB,EAAO,KAAA,CAAA,CAGrB0B,WAAAA,CAAYP,CAAAA,CAAiBnB,CAAAA,CAAO,SAAUoB,CAAAA,CAAmBpB,CAAAA,CAAO,UAAU,CAAA,GACrFmB,CAAAA,CAAkBnB,CAAAA,CAAO,QAAA,CACzBoB,CAAAA,CAAoBpB,EAAO,UAAA,CAC3BuB,CAAAA,EAAY,EAEd,CAAA,CAEIJ,EAAgB,MAAA,CAAS,CAAA,CAC5BG,CAAAA,CAAO,IAAA,CAAKlC,EAAO,KAAA,CAAM,MAAA,CAAO,SAAA,CAAU+B,CAAAA,CAAiBM,CAAQ,CAAC,CAAA,CAC1DL,CAAAA,CAAkB,SAAW,CAAA,EACvCE,CAAAA,CAAO,IAAA,CAAKlC,CAAAA,CAAO,MAAM,MAAA,CAAO,YAAA,CAAaqC,CAAQ,CAAC,EAEnDL,CAAAA,CAAkB,MAAA,CAAS,CAAA,EAC9BE,CAAAA,CAAO,IAAA,CAAKlC,CAAAA,CAAO,SAAA,CAAUgC,CAAAA,CAAmBK,CAAQ,CAAC,EAE3D,CAAA,CAEA,OAAAF,GAAY,CAEZ1B,cAAAA,CAAe,IAAM,CACpB,QAAW2B,CAAAA,IAASF,CAAAA,CAAQE,CAAAA,GAC7B,CAAC,CAAA,CAEMH,CACR,CAMO,SAASM,CAAAA,CACfvC,CAAAA,CACkC,CAClC,OAAAE,aAAa,aAAA,CAAeF,CAAM,CAAA,CAC1BwC,CAAAA,EAA0B,CACjCxC,CAAAA,CAAO,QAAA,CAASwC,CAAK,EACtB,CACD,CASO,SAASC,CAAAA,CACfzC,EACkC,CAClC,OAAAE,YAAAA,CAAa,WAAA,CAAaF,CAAM,CAAA,CACzBA,CAAAA,CAAO,MACf,CAoCO,SAAS0C,CAAAA,CAEf1C,CAAAA,CACA2C,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACO,CACP3C,YAAAA,CAAa,UAAA,CAAYF,CAAM,CAAA,CAE/B,IAAM8C,CAAAA,CACLH,CAAAA,GAAuB,QACvB,OAAOC,CAAAA,EAAsB,QAAA,EAC7B,OAAOC,GAAkB,UAAA,CAEpBhC,CAAAA,CAAMiC,CAAAA,CAAUF,CAAAA,CAA+BD,CAAAA,CAC/CI,CAAAA,CAAWD,CAAAA,CACdD,CAAAA,CACCD,EAEEpC,CAAAA,CAAcR,CAAAA,CAAO,KAAA,CAAMa,CAAAA,CAAKkC,CAAQ,CAAA,CAC9CtC,cAAAA,CAAeD,CAAW,EAC3B,CAeO,SAASwC,CAAAA,CAEfhD,CAAAA,CACAiD,CAAAA,CAC2B,CAC3B/C,YAAAA,CAAa,YAAA,CAAcF,CAAM,EACjC,IAAMc,CAAAA,CAAQC,UAAAA,CAAyBmC,mBAAAA,CAAoBlD,CAAM,CAAC,CAAA,CAE5DmD,CAAAA,CAAS,IAAM,CACpBrC,CAAAA,CAAM,KAAA,CAAQoC,mBAAAA,CAAoBlD,CAAM,EACzC,CAAA,CAEA,GAAIiD,CAAAA,EAAS,YAAcA,CAAAA,CAAQ,UAAA,CAAa,CAAA,CAAG,CAClD,GAAM,CAAE,SAAA,CAAAG,CAAAA,CAAW,OAAA,CAAAC,CAAQ,CAAA,CAAIC,cAAAA,CAAeH,CAAAA,CAAQF,CAAAA,CAAQ,UAAU,CAAA,CAClEM,CAAAA,CAAavD,CAAAA,CAAO,MAAM,MAAA,CAAO,YAAA,CAAaoD,CAAS,CAAA,CACvDI,EAAexD,CAAAA,CAAO,eAAA,CAAgBoD,CAAS,CAAA,CACrD3C,eAAe,IAAM,CACpB4C,CAAAA,EAAQ,CACRE,GAAW,CACXC,CAAAA,GACD,CAAC,EACF,CAAA,KAAO,CACN,IAAMD,CAAAA,CAAavD,EAAO,KAAA,CAAM,MAAA,CAAO,YAAA,CAAamD,CAAM,EACpDK,CAAAA,CAAexD,CAAAA,CAAO,eAAA,CAAgBmD,CAAM,CAAA,CAClD1C,cAAAA,CAAe,IAAM,CACpB8C,GAAW,CACXC,CAAAA,GACD,CAAC,EACF,CAEA,OAAO1C,CACR,CAWO,SAAS2C,CAAAA,CACfC,CAAAA,CACAC,CAAAA,CACwF,CACxF,GAAI,KAAA,CAAM,OAAA,CAAQA,CAAW,EAAG,CAC/B,IAAMhD,CAAAA,CAAY,IAA6C,CAC9D,IAAMC,CAAAA,CAAgD,EAAC,CACvD,QAAWgD,CAAAA,IAAQD,CAAAA,CAClB/C,CAAAA,CAAOgD,CAAI,CAAA,CAAIF,CAAAA,CAAa,SAAA,CAAUE,CAAI,EAE3C,OAAOhD,CACR,CAAA,CACME,CAAAA,CAAQC,WAAWJ,CAAAA,EAAW,CAAA,CAC9BH,CAAAA,CAAckD,EAAa,SAAA,CAAU,IAAM,CAChD5C,CAAAA,CAAM,KAAA,CAAQH,CAAAA,GACf,CAAC,EACD,OAAAF,cAAAA,CAAeD,CAAW,CAAA,CACnBM,CACR,CAEA,IAAM+C,CAAAA,CAAS9C,UAAAA,CAAkC2C,EAAa,SAAA,CAAUC,CAAW,CAAC,CAAA,CAC9EnD,CAAAA,CAAckD,CAAAA,CAAa,SAAA,CAAU,IAAM,CAChDG,CAAAA,CAAO,KAAA,CAAQH,CAAAA,CAAa,SAAA,CAAUC,CAAW,EAClD,CAAC,CAAA,CACD,OAAAlD,eAAeD,CAAW,CAAA,CACnBqD,CACR,CASO,SAASC,CAAAA,CAEf9D,CAAAA,CACA+D,CAAAA,CACqB,CACrB7D,YAAAA,CAAa,YAAA,CAAcF,CAAM,CAAA,CACjC,IAAMgE,CAAAA,CAAczD,GAAAA,CAAmBP,CAAAA,CAAO,OAAA,CAAQ+D,CAAa,CAAC,CAAA,CAE9DZ,CAAAA,CAAS,IAAM,CACpBa,CAAAA,CAAY,KAAA,CAAQhE,CAAAA,CAAO,QAAQ+D,CAAa,EACjD,CAAA,CAEMR,CAAAA,CAAavD,EAAO,KAAA,CAAM,MAAA,CAAO,YAAA,CAAamD,CAAM,EACpDK,CAAAA,CAAexD,CAAAA,CAAO,eAAA,CAAgBmD,CAAM,CAAA,CAClD,OAAA1C,cAAAA,CAAe,IAAM,CACpB8C,CAAAA,EAAW,CACXC,CAAAA,GACD,CAAC,CAAA,CAEMQ,CACR,CAgBO,SAASC,EAEfjE,CAAAA,CACAkE,CAAAA,CACwD,CACxDhE,YAAAA,CAAa,qBAAA,CAAuBF,CAAM,CAAA,CAC1C,IAAMmE,EAAenB,CAAAA,CAAWhD,CAAM,CAAA,CAEtC,OAAOoE,SAAS,IAAM,CAEhBD,CAAAA,CAAa,KAAA,CAClB,IAAME,CAAAA,CAAiBrE,CAAAA,CAAO,OAAA,EAAQ,CACtC,OAAKkE,CAAAA,CACEG,CAAAA,CAAe,WAAA,CAAY,KAAMC,CAAAA,EAAMA,CAAAA,CAAE,EAAA,GAAOJ,CAAY,GAAK,IAAA,CAD9CG,CAAAA,CAAe,WAE1C,CAAC,CACF,CAiBO,SAASE,CAAAA,CAEfvE,CAAAA,CACA0D,CAAAA,CACAc,CAAAA,CACyB,CACzBtE,YAAAA,CAAa,sBAAuBF,CAAM,CAAA,CAC1C,IAAMyE,CAAAA,CAAYlE,IAAI,KAAK,CAAA,CACrBmE,CAAAA,CAAQnE,GAAAA,CAAkB,IAAI,CAAA,CAChCoE,CAAAA,CAAkC,IAAA,CAClCnE,CAAAA,CAAmC,IAAA,CAEjCoE,CAAAA,CAAW,IAAM,CAClBD,IACH3E,CAAAA,CAAO,OAAA,CAAQ2E,CAAQ,CAAA,CACvBA,EAAW,IAAA,CAAA,CAEZF,CAAAA,CAAU,KAAA,CAAQ,KAAA,CAClBC,EAAM,KAAA,CAAQ,IAAA,CACdlE,CAAAA,IAAc,CACdA,CAAAA,CAAc,KACf,CAAA,CAEMqE,CAAAA,CAAUC,GAAyB,CACxCH,CAAAA,CAAW3E,CAAAA,CAAO,WAAA,GAClByE,CAAAA,CAAU,KAAA,CAAQ,IAAA,CAClBC,CAAAA,CAAM,MAAQ,IAAA,CACd1E,CAAAA,CAAO,KAAA,CAAM8E,CAAQ,CAAA,CAGjBpB,CAAAA,EAAgBc,CAAAA,GACnBhE,CAAAA,KACAA,CAAAA,CAAckD,CAAAA,CAAa,SAAA,CAAU,IAAM,CAC1C,IAAMG,CAAAA,CAASH,CAAAA,CAAa,SAAA,CAAUc,CAAe,CAAA,CACjD,CAACX,CAAAA,CAAO,SAAA,EAAa,CAACA,CAAAA,CAAO,QAAA,EAChCc,CAAAA,CAAW,KACXF,CAAAA,CAAU,KAAA,CAAQ,KAAA,CAClBjE,CAAAA,KACAA,CAAAA,CAAc,IAAA,EACJqD,CAAAA,CAAO,QAAA,GACjBa,EAAM,KAAA,CAAQb,CAAAA,CAAO,SAAA,CACrBe,CAAAA,IAEF,CAAC,CAAA,EAEH,CAAA,CAEA,OAAAnE,eAAe,IAAM,CACpBD,CAAAA,KACD,CAAC,CAAA,CAEM,CAAE,MAAA,CAAAqE,CAAAA,CAAQ,UAAAJ,CAAAA,CAAW,KAAA,CAAAC,CAAAA,CAAO,QAAA,CAAAE,CAAS,CAC7C,CAgBO,SAASG,EAEf/E,CAAAA,CACsD,CACtDE,YAAAA,CAAa,eAAA,CAAiBF,CAAM,CAAA,CACpC,IAAMc,CAAAA,CAAQC,UAAAA,CAAoDiE,qBAAqBhF,CAAM,CAAC,CAAA,CACxFoC,CAAAA,CAAQpC,CAAAA,CAAO,kBAAA,CAAmB,IAAM,CAC7Cc,EAAM,KAAA,CAAQkE,oBAAAA,CAAqBhF,CAAM,EAC1C,CAAC,CAAA,CACD,OAAAS,cAAAA,CAAe2B,CAAK,EACbtB,CACR,CAqCO,SAASmE,CAAAA,CACfC,CAAAA,CACAC,CAAAA,CACC,CACD,IAAMC,EAAa,CAAC,GAAID,CAAAA,EAAQ,OAAA,EAAW,EAAG,CAAA,CAC1CzB,CAAAA,CAEJ,GAAIyB,GAAQ,MAAA,CAAQ,CACnB,IAAME,CAAAA,CAAKC,6BAAAA,EAA8B,CACzC5B,CAAAA,CAAe2B,CAAAA,CAEfD,EAAW,IAAA,CAAKC,CAAAA,CAAG,MAAqB,EACzC,CAGA,IAAMrF,CAAAA,CAASuF,YAAAA,CAAa,CAC3B,OAAQL,CAAAA,CACR,OAAA,CAASE,CAAAA,CAAW,MAAA,CAAS,CAAA,CAAIA,CAAAA,CAAa,MAAA,CAC9C,KAAA,CAAOD,GAAQ,KAAA,CACf,aAAA,CAAeA,CAAAA,EAAQ,aAAA,CACvB,OAAQA,CAAAA,EAAQ,MAAA,CAChB,UAAA,CAAYA,CAAAA,EAAQ,WACpB,YAAA,CAAcA,CAAAA,EAAQ,YACvB,CAAQ,CAAA,CAERnF,CAAAA,CAAO,KAAA,EAAM,CAEbS,eAAe,IAAM,CACpBT,CAAAA,CAAO,OAAA,GACR,CAAC,CAAA,CAED,IAAMU,CAAAA,CAAWyE,GAAQ,KAAA,CACnBK,CAAAA,CAAcL,CAAAA,EAAQ,OAAA,CACtBM,CAAAA,CAAe,CAAC/E,CAAAA,EAAY,CAAC8E,EAG7BE,CAAAA,CAAa3E,UAAAA,CAClB0E,CAAAA,CACIzF,CAAAA,CAAO,MAAM,MAAA,CAAO,QAAA,EAAS,CAC9B2F,SAAAA,CAAU3F,EAAQU,CAAAA,EAAY,EAAE,CACpC,EACM6C,CAAAA,CAAakC,CAAAA,CAChBzF,CAAAA,CAAO,KAAA,CAAM,OAAO,YAAA,CAAa,IAAM,CACxC0F,CAAAA,CAAW,MAAQ1F,CAAAA,CAAO,KAAA,CAAM,MAAA,CAAO,QAAA,GACxC,CAAC,CAAA,CACCU,CAAAA,EAAYA,CAAAA,CAAS,MAAA,CAAS,CAAA,CAC7BV,CAAAA,CAAO,KAAA,CAAM,OAAO,SAAA,CAAUU,CAAAA,CAAU,IAAM,CAC/CgF,EAAW,KAAA,CAAQC,SAAAA,CAAU3F,CAAAA,CAAQU,CAAQ,EAC9C,CAAC,CAAA,CACC,IAAA,CAGEkF,CAAAA,CAAoBH,CAAAA,CAAe,MAAA,CAAO,IAAA,CAAKzF,CAAAA,CAAO,QAAU,EAAE,CAAA,CAAKwF,CAAAA,EAAe,EAAC,CACvFK,CAAAA,CAAa,IAA2B,CAC7C,IAAMjF,CAAAA,CAAkC,EAAC,CACzC,IAAA,IAAWC,CAAAA,IAAO+E,CAAAA,CACjBhF,CAAAA,CAAOC,CAAG,EAAIb,CAAAA,CAAO,IAAA,CAAKa,CAAG,CAAA,CAE9B,OAAOD,CACR,CAAA,CACMkF,CAAAA,CAAe/E,UAAAA,CAAW8E,GAAY,CAAA,CACtCE,CAAAA,CAAeH,CAAAA,CAAkB,MAAA,CAAS,CAAA,CAC7C5F,CAAAA,CAAO,SAAA,CAAU4F,EAAmB,IAAM,CAAEE,CAAAA,CAAa,KAAA,CAAQD,IAAc,CAAC,CAAA,CAChF,IAAA,CAEHpF,eAAe,IAAM,CACpB8C,CAAAA,IAAa,CACbwC,CAAAA,KACD,CAAC,CAAA,CAED,IAAMC,CAAAA,CAAShG,CAAAA,CAAO,MAAA,CAGtB,OAAO,CACN,MAAA,CAAAA,CAAAA,CACA,KAAA,CAAO0F,CAAAA,CACP,QAASI,CAAAA,CACT,MAAA,CAAAE,CAAAA,CACA,QAAA,CAPiBxD,CAAAA,EAA0BxC,CAAAA,CAAO,QAAA,CAASwC,CAAK,EAQhE,YAAA,CAAAkB,CACD,CACD,CAMO,SAASuC,CAAAA,EAgBd,CACD,OAAO,CACN,QAAS,CAAyCjG,CAAAA,CAA+BK,CAAAA,GAEhFN,CAAAA,CAAQC,CAAAA,CAAmCK,CAAO,CAAA,CACnD,UAAA,CAAY,CAA+CL,CAAAA,CAA+BoB,CAAAA,GAEzFJ,CAAAA,CAAWhB,CAAAA,CAAmCoB,CAAY,CAAA,CAC3D,WAAA,CAAcpB,CAAAA,EACLwC,CAAAA,EAA0B,CACjCxC,CAAAA,CAAO,QAAA,CAASwC,CAAK,EACtB,EAED,SAAA,CAAYxC,CAAAA,EAAkCyC,CAAAA,CAAazC,CAAM,EACjE,QAAA,CAAU,CACTA,CAAAA,CACAa,CAAAA,CACAkC,IAGAL,CAAAA,CAAS1C,CAAAA,CAAmCa,CAAAA,CAAKkC,CAAQ,CAC3D,CACD","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<R>(\n\t// biome-ignore lint/suspicious/noExplicitAny: Backward-compatible fallback\n\tsystem: SingleModuleSystem<any>,\n\t// biome-ignore lint/suspicious/noExplicitAny: Selector receives dynamic state\n\tselector: (state: Record<string, any>) => R,\n\tequalityFn?: (a: R, b: R) => boolean,\n): 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/**\n * Watch a fact by explicit \"fact\" discriminator.\n * @deprecated Use `useWatch(system, key, callback)` instead — facts are now auto-detected.\n */\nexport function useWatch<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(\n\tsystem: SingleModuleSystem<S>,\n\tkind: \"fact\",\n\tfactKey: K,\n\tcallback: (newValue: InferFacts<S>[K] | undefined, previousValue: InferFacts<S>[K] | undefined) => void,\n): void;\n/** Watch a fact or derivation (generic fallback) */\nexport function useWatch<T>(\n\t// biome-ignore lint/suspicious/noExplicitAny: Backward-compatible fallback\n\tsystem: SingleModuleSystem<any>,\n\tkey: string,\n\tcallback: (newValue: T, previousValue: T | undefined) => void,\n): void;\n/** Implementation */\nexport function useWatch(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tderivationIdOrKind: string,\n\tcallbackOrFactKey: string | ((newValue: unknown, prevValue: unknown) => void),\n\tmaybeCallback?: (newValue: unknown, prevValue: unknown) => void,\n): void {\n\tassertSystem(\"useWatch\", system);\n\t// Backward compat: useWatch(system, \"fact\", factKey, callback)\n\tconst isFact =\n\t\tderivationIdOrKind === \"fact\" &&\n\t\ttypeof callbackOrFactKey === \"string\" &&\n\t\ttypeof maybeCallback === \"function\";\n\n\tconst key = isFact ? (callbackOrFactKey as string) : derivationIdOrKind;\n\tconst callback = isFact\n\t\t? maybeCallback!\n\t\t: (callbackOrFactKey as (newValue: unknown, prevValue: unknown) => void);\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"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@directive-run/vue",
+  "version": "0.1.1",
+  "description": "Vue composition API adapter for Directive.",
+  "license": "MIT",
+  "author": "Jason Comes",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/directive-run/directive",
+    "directory": "packages/vue"
+  },
+  "homepage": "https://directive.run",
+  "bugs": {
+    "url": "https://github.com/directive-run/directive/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "directive",
+    "vue",
+    "composition-api",
+    "state-management",
+    "reactive",
+    "constraint-driven"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "vue": ">=3",
+    "@directive-run/core": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "vue": "^3.4.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "@directive-run/core": "0.1.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}