@directive-run/vue 0.1.1 → 0.2.0

package/README.md

@@ -1,6 +1,10 @@
 # @directive-run/vue
 
-Vue 3 composition API adapter for Directive. Provides reactive `ref` and `shallowRef` composables for reading facts, derivations, and dispatching events.
+[![npm](https://img.shields.io/npm/v/@directive-run/vue?color=%236366f1)](https://www.npmjs.com/package/@directive-run/vue)
+[![downloads](https://img.shields.io/npm/dm/@directive-run/vue)](https://www.npmjs.com/package/@directive-run/vue)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/@directive-run/vue)](https://bundlephobia.com/package/@directive-run/vue)
+
+Vue 3 composables for [Directive](https://www.npmjs.com/package/@directive-run/core). Returns reactive `Ref` and `ShallowRef` values that integrate with Vue's reactivity system.
 
 ## Install
 
@@ -8,11 +12,42 @@ Vue 3 composition API adapter for Directive. Provides reactive `ref` and `shallo
 npm install @directive-run/core @directive-run/vue
 ```
 
-## Usage
+## Quick Start
+
+Define a module in a shared file, then use it in any component:
+
+```typescript
+// system.ts
+import { createModule, createSystem, t } from "@directive-run/core";
+
+const counter = createModule("counter", {
+  schema: {
+    facts: { count: t.number() },
+    derivations: { doubled: t.number() },
+    events: { increment: {}, decrement: {} },
+    requirements: {},
+  },
+  init: (facts) => {
+    facts.count = 0;
+  },
+  derive: {
+    doubled: (facts) => facts.count * 2,
+  },
+  events: {
+    increment: (facts) => { facts.count += 1; },
+    decrement: (facts) => { facts.count -= 1; },
+  },
+});
+
+export const system = createSystem({ module: counter });
+system.start();
+```
 
 ```vue
-<script setup>
+<!-- Counter.vue -->
+<script setup lang="ts">
 import { useFact, useDerived, useEvents } from "@directive-run/vue";
+import { system } from "./system";
 
 const count = useFact(system, "count");
 const doubled = useDerived(system, "doubled");
@@ -22,20 +57,73 @@ const events = useEvents(system);
 <template>
   <p>Count: {{ count }} (doubled: {{ doubled }})</p>
   <button @click="events.increment()">+</button>
+  <button @click="events.decrement()">&minus;</button>
+</template>
+```
+
+## useSelector
+
+Auto-tracking selector over facts and derivations. Returns a `Ref` that updates when accessed keys change:
+
+```vue
+<script setup lang="ts">
+import { useSelector } from "@directive-run/vue";
+import { system } from "./system";
+
+const label = useSelector(system, (state) => {
+  return state.count > 10 ? "High" : "Low";
+});
+</script>
+
+<template>
+  <span>{{ label }}</span>
 </template>
 ```
 
-## Exports
+## API Reference
+
+### Core Composables
+
+| Composable | Return Type | Description |
+|------------|------------|-------------|
+| `useFact(system, key)` | `Ref<T>` | Subscribe to a single fact value |
+| `useFact(system, [keys])` | `ShallowRef<Pick<Facts, K>>` | Subscribe to multiple facts |
+| `useDerived(system, key)` | `Ref<T>` | Subscribe to a single derivation |
+| `useDerived(system, [keys])` | `ShallowRef<Pick<Derivations, K>>` | Subscribe to multiple derivations |
+| `useSelector(system, fn)` | `Ref<R>` | Auto-tracking selector with optional equality function |
+| `useEvents(system)` | `Events` | Events dispatcher |
+| `useDispatch(system)` | `(event) => void` | Low-level dispatch function |
 
-`useFact`, `useDerived`, `useSelector`, `useDispatch`, `useEvents`, `useWatch`, `useInspect`, `useRequirementStatus`, `useExplain`, `useConstraintStatus`, `useOptimisticUpdate`, `useTimeTravel`, `useDirective`, `createTypedHooks`, `shallowEqual`
+### Advanced Composables
+
+| Composable | Return Type | Description |
+|------------|------------|-------------|
+| `useWatch(system, key, cb)` | `void` | Side-effect on fact or derivation change |
+| `useInspect(system)` | `ShallowRef<InspectState>` | Consolidated system state (isSettled, unmet, inflight) |
+| `useRequirementStatus(plugin, type)` | `ShallowRef<RequirementTypeStatus>` | Requirement loading/error state |
+| `useExplain(system, reqId)` | `Ref<string \| null>` | Human-readable requirement explanation |
+| `useConstraintStatus(system)` | `ComputedRef<ConstraintInfo[]>` | All constraint states |
+| `useOptimisticUpdate(system)` | `{ mutate, isPending: Ref, error: Ref, rollback }` | Optimistic mutation with auto-rollback |
+| `useTimeTravel(system)` | `ShallowRef<TimeTravelState \| null>` | Undo/redo navigation |
+
+### Vue-Specific
+
+| Export | Description |
+|--------|-------------|
+| `useDirective(module, config?)` | Scoped system with lifecycle (auto-start/destroy) |
+| `createTypedHooks()` | Factory for pre-typed composables |
+| `shallowEqual` | Shallow equality helper for selectors |
 
 ## Peer Dependencies
 
 - `vue >= 3`
 - `@directive-run/core`
 
+## Documentation
+
+- [Vue Adapter Guide](https://directive.run/docs/adapters/vue)
+- [API Reference](https://directive.run/docs/api)
+
 ## License
 
 MIT
-
-[Full documentation](https://directive.run/docs)

package/dist/index.cjs

@@ -1,2 +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
+'use strict';var vue=require('vue'),core=require('@directive-run/core'),adapterUtils=require('@directive-run/core/adapter-utils');function E(e,t){return adapterUtils.assertSystem("useFact",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useFact() received a function. Did you mean useSelector()? useFact() takes a string key or array of keys, not a selector function."),Array.isArray(t)?V(e,t):T(e,t)}function T(e,t){process.env.NODE_ENV!=="production"&&(e.facts.$store.has(t)||console.warn(`[Directive] useFact("${t}") \u2014 fact not found in store. Check that "${t}" is defined in your module's schema.`));let s=vue.ref(e.facts.$store.get(t)),o=e.facts.$store.subscribe([t],()=>{s.value=e.facts.$store.get(t);});return vue.onScopeDispose(o),s}function V(e,t){let s=()=>{let r={};for(let u of t)r[u]=e.facts.$store.get(u);return r},o=vue.shallowRef(s()),n=e.facts.$store.subscribe(t,()=>{o.value=s();});return vue.onScopeDispose(n),o}function $(e,t){return adapterUtils.assertSystem("useDerived",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useDerived() received a function. Did you mean useSelector()? useDerived() takes a string key or array of keys, not a selector function."),Array.isArray(t)?A(e,t):q(e,t)}function q(e,t){process.env.NODE_ENV!=="production"&&e.read(t)===void 0&&console.warn(`[Directive] useDerived("${t}") returned undefined. Check that "${t}" is defined in your module's derive property.`);let s=vue.ref(e.read(t)),o=e.subscribe([t],()=>{s.value=e.read(t);});return vue.onScopeDispose(o),s}function A(e,t){let s=()=>{let r={};for(let u of t)r[u]=e.read(u);return r},o=vue.shallowRef(s()),n=e.subscribe(t,()=>{o.value=s();});return vue.onScopeDispose(n),o}function z(e,t,s=adapterUtils.defaultEquality){adapterUtils.assertSystem("useSelector",e);let o=new Set(Object.keys(e.derive??{})),n=()=>adapterUtils.runTrackedSelector(e,o,t),r=n(),u=r.factKeys,i=r.deriveKeys,l=vue.ref(r.value),S=[],c=()=>{for(let d of S)d();S.length=0;let g=()=>{let d=n();s(l.value,d.value)||(l.value=d.value),adapterUtils.depsChanged(u,d.factKeys,i,d.deriveKeys)&&(u=d.factKeys,i=d.deriveKeys,c());};u.length>0?S.push(e.facts.$store.subscribe(u,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){adapterUtils.assertSystem("useWatch",e);let o=e.watch(t,s);vue.onScopeDispose(o);}function N(e,t){adapterUtils.assertSystem("useInspect",e);let s=vue.shallowRef(adapterUtils.computeInspectState(e)),o=()=>{s.value=adapterUtils.computeInspectState(e);};if(t?.throttleMs&&t.throttleMs>0){let{throttled:n,cleanup:r}=adapterUtils.createThrottle(o,t.throttleMs),u=e.facts.$store.subscribeAll(n),i=e.onSettledChange(n);vue.onScopeDispose(()=>{r(),u(),i();});}else {let n=e.facts.$store.subscribeAll(o),r=e.onSettledChange(o);vue.onScopeDispose(()=>{n(),r();});}return s}function L(e,t){if(Array.isArray(t)){let n=()=>{let i={};for(let l of t)i[l]=e.getStatus(l);return i},r=vue.shallowRef(n()),u=e.subscribe(()=>{r.value=n();});return vue.onScopeDispose(u),r}let s=vue.shallowRef(e.getStatus(t)),o=e.subscribe(()=>{s.value=e.getStatus(t);});return vue.onScopeDispose(o),s}function G(e,t){adapterUtils.assertSystem("useExplain",e);let s=vue.ref(e.explain(t)),o=()=>{s.value=e.explain(t);},n=e.facts.$store.subscribeAll(o),r=e.onSettledChange(o);return vue.onScopeDispose(()=>{n(),r();}),s}function J(e,t){adapterUtils.assertSystem("useConstraintStatus",e);let s=N(e);return vue.computed(()=>{s.value;let o=e.inspect();return t?o.constraints.find(n=>n.id===t)??null:o.constraints})}function Q(e,t,s){adapterUtils.assertSystem("useOptimisticUpdate",e);let o=vue.ref(false),n=vue.ref(null),r=null,u=null,i=()=>{r&&(e.restore(r),r=null),o.value=false,n.value=null,u?.(),u=null;},l=S=>{r=e.getSnapshot(),o.value=true,n.value=null,e.batch(S),t&&s&&(u?.(),u=t.subscribe(()=>{let c=t.getStatus(s);!c.isLoading&&!c.hasError?(r=null,o.value=false,u?.(),u=null):c.hasError&&(n.value=c.lastError,i());}));};return vue.onScopeDispose(()=>{u?.();}),{mutate:l,isPending:o,error:n,rollback:i}}function X(e){adapterUtils.assertSystem("useTimeTravel",e);let t=vue.shallowRef(adapterUtils.buildTimeTravelState(e)),s=e.onTimeTravelChange(()=>{t.value=adapterUtils.buildTimeTravelState(e);});return vue.onScopeDispose(s),t}function Y(e,t){let s=[...t?.plugins??[]],o;if(t?.status){let v=core.createRequirementStatusPlugin();o=v,s.push(v.plugin);}let n=core.createSystem({module:e,plugins:s.length>0?s:void 0,debug:t?.debug,errorBoundary:t?.errorBoundary,tickMs:t?.tickMs,zeroConfig:t?.zeroConfig,initialFacts:t?.initialFacts});n.start(),vue.onScopeDispose(()=>{n.destroy();});let r=t?.facts,u=t?.derived,i=!r&&!u,l=vue.shallowRef(i?n.facts.$store.toObject():adapterUtils.pickFacts(n,r??[])),S=i?n.facts.$store.subscribeAll(()=>{l.value=n.facts.$store.toObject();}):r&&r.length>0?n.facts.$store.subscribe(r,()=>{l.value=adapterUtils.pickFacts(n,r);}):null,c=i?Object.keys(n.derive??{}):u??[],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)=>E(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=E;exports.useInspect=N;exports.useOptimisticUpdate=Q;exports.useRequirementStatus=L;exports.useSelector=z;exports.useTimeTravel=X;exports.useWatch=U;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["useFact","system","keyOrKeys","assertSystem","_useFactMulti","_useFactSingle","factKey","value","ref","unsubscribe","onScopeDispose","factKeys","getValues","result","key","state","shallowRef","useDerived","idOrIds","_useDerivedMulti","_useDerivedSingle","derivationId","derivationIds","id","useSelector","selector","equalityFn","defaultEquality","deriveKeySet","runWithTracking","runTrackedSelector","initial","trackedFactKeys","trackedDeriveKeys","selected","unsubs","resubscribe","unsub","onUpdate","depsChanged","useDispatch","event","useEvents","useWatch","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"]}
+{"version":3,"sources":["../src/index.ts"],"names":["useFact","system","keyOrKeys","assertSystem","_useFactMulti","_useFactSingle","factKey","value","ref","unsubscribe","onScopeDispose","factKeys","getValues","result","key","state","shallowRef","useDerived","idOrIds","_useDerivedMulti","_useDerivedSingle","derivationId","derivationIds","id","useSelector","selector","equalityFn","defaultEquality","deriveKeySet","runWithTracking","runTrackedSelector","initial","trackedFactKeys","trackedDeriveKeys","selected","unsubs","resubscribe","unsub","onUpdate","depsChanged","useDispatch","event","useEvents","useWatch","callback","useInspect","options","computeInspectState","update","throttled","cleanup","createThrottle","unsubFacts","unsubSettled","useRequirementStatus","statusPlugin","typeOrTypes","type","status","useExplain","requirementId","explanation","useConstraintStatus","constraintId","inspectState","computed","fullInspection","c","useOptimisticUpdate","requirementType","isPending","error","snapshot","rollback","mutate","updateFn","useTimeTravel","buildTimeTravelState","useDirective","moduleDef","config","allPlugins","sp","createRequirementStatusPlugin","createSystem","derivedKeys","subscribeAll","factsState","pickFacts","allDerivationKeys","getDerived","derivedState","unsubDerived","events","createTypedHooks"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Vue Adapter - Vue 3 composables for Directive\n *\n * Exports: useFact, useDerived, useDispatch, useSelector,\n * useWatch, useInspect, useRequirementStatus, useEvents, useExplain,\n * useConstraintStatus, useOptimisticUpdate, useDirective, useTimeTravel,\n * createTypedHooks, shallowEqual\n */\n\nimport {\n\tcomputed,\n\tonScopeDispose,\n\tref,\n\tshallowRef,\n\ttype ComputedRef,\n\ttype Ref,\n\ttype ShallowRef,\n} from \"vue\";\nimport type {\n\tModuleSchema,\n\tModuleDef,\n\tPlugin,\n\tDebugConfig,\n\tErrorBoundaryConfig,\n\tInferFacts,\n\tInferDerivations,\n\tInferSelectorState,\n\tInferEvents,\n\tSingleModuleSystem,\n\tSystemSnapshot,\n} from \"@directive-run/core\";\nimport {\n\tcreateSystem,\n\tcreateRequirementStatusPlugin,\n} from \"@directive-run/core\";\nimport type { RequirementTypeStatus } from \"@directive-run/core\";\nimport {\n\ttype InspectState,\n\ttype ConstraintInfo,\n\tcomputeInspectState,\n\tcreateThrottle,\n\tassertSystem,\n\tdefaultEquality,\n\tbuildTimeTravelState,\n\tpickFacts,\n\trunTrackedSelector,\n\tdepsChanged,\n\tshallowEqual,\n} from \"@directive-run/core/adapter-utils\";\n\n// Re-export for convenience\nexport type { RequirementTypeStatus, InspectState, ConstraintInfo };\nexport { shallowEqual };\n\n/** Type for the requirement status plugin return value */\nexport type StatusPlugin = ReturnType<typeof createRequirementStatusPlugin>;\n\n// ============================================================================\n// useFact — single key or multi key\n// ============================================================================\n\n/** Single key overload */\nexport function useFact<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, factKey: K): Ref<InferFacts<S>[K] | undefined>;\n/** Multi-key overload */\nexport function useFact<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, factKeys: K[]): ShallowRef<Pick<InferFacts<S>, K>>;\n/** Implementation */\nexport function useFact(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tkeyOrKeys: string | string[],\n): Ref<unknown> | ShallowRef<unknown> {\n\tassertSystem(\"useFact\", system);\n\tif (process.env.NODE_ENV !== \"production\" && typeof keyOrKeys === \"function\") {\n\t\tconsole.error(\n\t\t\t\"[Directive] useFact() received a function. Did you mean useSelector()? \" +\n\t\t\t\t\"useFact() takes a string key or array of keys, not a selector function.\",\n\t\t);\n\t}\n\n\t// Multi-key path: useFact(system, [keys])\n\tif (Array.isArray(keyOrKeys)) {\n\t\treturn _useFactMulti(system, keyOrKeys);\n\t}\n\n\t// Single key path: useFact(system, key)\n\treturn _useFactSingle(system, keyOrKeys);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactSingle(system: SingleModuleSystem<any>, factKey: string): Ref<unknown> {\n\tif (process.env.NODE_ENV !== \"production\") {\n\t\tif (!system.facts.$store.has(factKey)) {\n\t\t\tconsole.warn(\n\t\t\t\t`[Directive] useFact(\"${factKey}\") — fact not found in store. ` +\n\t\t\t\t`Check that \"${factKey}\" is defined in your module's schema.`,\n\t\t\t);\n\t\t}\n\t}\n\n\tconst value = ref(system.facts.$store.get(factKey));\n\tconst unsubscribe = system.facts.$store.subscribe([factKey], () => {\n\t\tvalue.value = system.facts.$store.get(factKey);\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactMulti(system: SingleModuleSystem<any>, factKeys: string[]): ShallowRef<Record<string, unknown>> {\n\tconst getValues = (): Record<string, unknown> => {\n\t\tconst result: Record<string, unknown> = {};\n\t\tfor (const key of factKeys) {\n\t\t\tresult[key] = system.facts.$store.get(key);\n\t\t}\n\t\treturn result;\n\t};\n\tconst state = shallowRef(getValues());\n\tconst unsubscribe = system.facts.$store.subscribe(factKeys, () => {\n\t\tstate.value = getValues();\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn state;\n}\n\n// ============================================================================\n// useDerived — single key or multi key\n// ============================================================================\n\n/** Single key overload */\nexport function useDerived<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, derivationId: K): Ref<InferDerivations<S>[K]>;\n/** Multi-key overload */\nexport function useDerived<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, derivationIds: K[]): ShallowRef<Pick<InferDerivations<S>, K>>;\n/** Implementation */\nexport function useDerived(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tidOrIds: string | string[],\n): Ref<unknown> | ShallowRef<unknown> {\n\tassertSystem(\"useDerived\", system);\n\tif (process.env.NODE_ENV !== \"production\" && typeof idOrIds === \"function\") {\n\t\tconsole.error(\n\t\t\t\"[Directive] useDerived() received a function. Did you mean useSelector()? \" +\n\t\t\t\t\"useDerived() takes a string key or array of keys, not a selector function.\",\n\t\t);\n\t}\n\n\t// Multi-key path\n\tif (Array.isArray(idOrIds)) {\n\t\treturn _useDerivedMulti(system, idOrIds);\n\t}\n\n\t// Single key path\n\treturn _useDerivedSingle(system, idOrIds);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedSingle(system: SingleModuleSystem<any>, derivationId: string): Ref<unknown> {\n\tif (process.env.NODE_ENV !== \"production\") {\n\t\tconst initialValue = system.read(derivationId);\n\t\tif (initialValue === undefined) {\n\t\t\tconsole.warn(\n\t\t\t\t`[Directive] useDerived(\"${derivationId}\") returned undefined. ` +\n\t\t\t\t`Check that \"${derivationId}\" is defined in your module's derive property.`,\n\t\t\t);\n\t\t}\n\t}\n\tconst value = ref(system.read(derivationId));\n\tconst unsubscribe = system.subscribe([derivationId], () => {\n\t\tvalue.value = system.read(derivationId);\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedMulti(system: SingleModuleSystem<any>, derivationIds: string[]): ShallowRef<Record<string, unknown>> {\n\tconst getValues = (): Record<string, unknown> => {\n\t\tconst result: Record<string, unknown> = {};\n\t\tfor (const id of derivationIds) {\n\t\t\tresult[id] = system.read(id);\n\t\t}\n\t\treturn result;\n\t};\n\tconst state = shallowRef(getValues());\n\tconst unsubscribe = system.subscribe(derivationIds, () => {\n\t\tstate.value = getValues();\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn state;\n}\n\n// ============================================================================\n// useSelector — auto-tracking selector over facts and derivations\n// ============================================================================\n\n/**\n * Auto-tracking selector over facts and derivations.\n * Uses `withTracking()` to detect which facts the selector accesses,\n * then subscribes only to those keys.\n */\nexport function useSelector<S extends ModuleSchema, R>(system: SingleModuleSystem<S>, selector: (state: InferSelectorState<S>) => R, equalityFn?: (a: R, b: R) => boolean): Ref<R>;\nexport function useSelector(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tselector: (state: Record<string, unknown>) => unknown,\n\tequalityFn: (a: unknown, b: unknown) => boolean = defaultEquality,\n): Ref<unknown> {\n\tassertSystem(\"useSelector\", system);\n\tconst deriveKeySet = new Set(Object.keys(system.derive ?? {}));\n\n\tconst runWithTracking = () => runTrackedSelector(system, deriveKeySet, selector);\n\n\tconst initial = runWithTracking();\n\tlet trackedFactKeys = initial.factKeys;\n\tlet trackedDeriveKeys = initial.deriveKeys;\n\tconst selected = ref(initial.value);\n\n\tconst unsubs: Array<() => void> = [];\n\n\tconst resubscribe = () => {\n\t\tfor (const unsub of unsubs) unsub();\n\t\tunsubs.length = 0;\n\n\t\tconst onUpdate = () => {\n\t\t\tconst result = runWithTracking();\n\t\t\tif (!equalityFn(selected.value, result.value)) {\n\t\t\t\tselected.value = result.value;\n\t\t\t}\n\t\t\t// Re-track: check if deps changed\n\t\t\tif (depsChanged(trackedFactKeys, result.factKeys, trackedDeriveKeys, result.deriveKeys)) {\n\t\t\t\ttrackedFactKeys = result.factKeys;\n\t\t\t\ttrackedDeriveKeys = result.deriveKeys;\n\t\t\t\tresubscribe();\n\t\t\t}\n\t\t};\n\n\t\tif (trackedFactKeys.length > 0) {\n\t\t\tunsubs.push(system.facts.$store.subscribe(trackedFactKeys, onUpdate));\n\t\t} else if (trackedDeriveKeys.length === 0) {\n\t\t\tunsubs.push(system.facts.$store.subscribeAll(onUpdate));\n\t\t}\n\t\tif (trackedDeriveKeys.length > 0) {\n\t\t\tunsubs.push(system.subscribe(trackedDeriveKeys, onUpdate));\n\t\t}\n\t};\n\n\tresubscribe();\n\n\tonScopeDispose(() => {\n\t\tfor (const unsub of unsubs) unsub();\n\t});\n\n\treturn selected;\n}\n\n// ============================================================================\n// useDispatch\n// ============================================================================\n\nexport function useDispatch<S extends ModuleSchema>(\n\tsystem: SingleModuleSystem<S>,\n): (event: InferEvents<S>) => void {\n\tassertSystem(\"useDispatch\", system);\n\treturn (event: InferEvents<S>) => {\n\t\tsystem.dispatch(event);\n\t};\n}\n\n// ============================================================================\n// useEvents — memoized events reference\n// ============================================================================\n\n/**\n * Returns the system's events dispatcher.\n */\nexport function useEvents<S extends ModuleSchema>(\n\tsystem: SingleModuleSystem<S>,\n): SingleModuleSystem<S>[\"events\"] {\n\tassertSystem(\"useEvents\", system);\n\treturn system.events;\n}\n\n// ============================================================================\n// useWatch — derivation or fact side-effect\n// ============================================================================\n\n/** Watch a derivation or fact by key (auto-detected). When a key exists in both facts and derivations, the derivation overload takes priority. */\nexport function useWatch<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(\n\tsystem: SingleModuleSystem<S>,\n\tkey: K,\n\tcallback: (newValue: InferDerivations<S>[K], previousValue: InferDerivations<S>[K] | undefined) => void,\n): void;\n/** Watch a fact key with auto-detection. */\nexport function useWatch<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(\n\tsystem: SingleModuleSystem<S>,\n\tkey: K,\n\tcallback: (newValue: InferFacts<S>[K] | undefined, previousValue: InferFacts<S>[K] | undefined) => void,\n): void;\n/** Implementation */\nexport function useWatch(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tkey: string,\n\tcallback: (newValue: unknown, prevValue: unknown) => void,\n): void {\n\tassertSystem(\"useWatch\", system);\n\n\tconst unsubscribe = system.watch(key, callback);\n\tonScopeDispose(unsubscribe);\n}\n\n// ============================================================================\n// useInspect — consolidated inspection hook\n// ============================================================================\n\n/** Options for useInspect */\nexport interface UseInspectOptions {\n\tthrottleMs?: number;\n}\n\n/**\n * Consolidated system inspection hook.\n * Returns InspectState with optional throttling.\n */\nexport function useInspect(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\toptions?: UseInspectOptions,\n): ShallowRef<InspectState> {\n\tassertSystem(\"useInspect\", system);\n\tconst state = shallowRef<InspectState>(computeInspectState(system));\n\n\tconst update = () => {\n\t\tstate.value = computeInspectState(system);\n\t};\n\n\tif (options?.throttleMs && options.throttleMs > 0) {\n\t\tconst { throttled, cleanup } = createThrottle(update, options.throttleMs);\n\t\tconst unsubFacts = system.facts.$store.subscribeAll(throttled);\n\t\tconst unsubSettled = system.onSettledChange(throttled);\n\t\tonScopeDispose(() => {\n\t\t\tcleanup();\n\t\t\tunsubFacts();\n\t\t\tunsubSettled();\n\t\t});\n\t} else {\n\t\tconst unsubFacts = system.facts.$store.subscribeAll(update);\n\t\tconst unsubSettled = system.onSettledChange(update);\n\t\tonScopeDispose(() => {\n\t\t\tunsubFacts();\n\t\t\tunsubSettled();\n\t\t});\n\t}\n\n\treturn state;\n}\n\n// ============================================================================\n// useRequirementStatus — single or multi\n// ============================================================================\n\n/** Single type overload */\nexport function useRequirementStatus(statusPlugin: StatusPlugin, type: string): ShallowRef<RequirementTypeStatus>;\n/** Multi-type overload */\nexport function useRequirementStatus(statusPlugin: StatusPlugin, types: string[]): ShallowRef<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useRequirementStatus(\n\tstatusPlugin: StatusPlugin,\n\ttypeOrTypes: string | string[],\n): ShallowRef<RequirementTypeStatus> | ShallowRef<Record<string, RequirementTypeStatus>> {\n\tif (Array.isArray(typeOrTypes)) {\n\t\tconst getValues = (): Record<string, RequirementTypeStatus> => {\n\t\t\tconst result: Record<string, RequirementTypeStatus> = {};\n\t\t\tfor (const type of typeOrTypes) {\n\t\t\t\tresult[type] = statusPlugin.getStatus(type);\n\t\t\t}\n\t\t\treturn result;\n\t\t};\n\t\tconst state = shallowRef(getValues());\n\t\tconst unsubscribe = statusPlugin.subscribe(() => {\n\t\t\tstate.value = getValues();\n\t\t});\n\t\tonScopeDispose(unsubscribe);\n\t\treturn state;\n\t}\n\n\tconst status = shallowRef<RequirementTypeStatus>(statusPlugin.getStatus(typeOrTypes));\n\tconst unsubscribe = statusPlugin.subscribe(() => {\n\t\tstatus.value = statusPlugin.getStatus(typeOrTypes);\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn status;\n}\n\n// ============================================================================\n// useExplain — reactive requirement explanation\n// ============================================================================\n\n/**\n * Reactively returns the explanation string for a requirement.\n */\nexport function useExplain(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\trequirementId: string,\n): Ref<string | null> {\n\tassertSystem(\"useExplain\", system);\n\tconst explanation = ref<string | null>(system.explain(requirementId)) as Ref<string | null>;\n\n\tconst update = () => {\n\t\texplanation.value = system.explain(requirementId);\n\t};\n\n\tconst unsubFacts = system.facts.$store.subscribeAll(update);\n\tconst unsubSettled = system.onSettledChange(update);\n\tonScopeDispose(() => {\n\t\tunsubFacts();\n\t\tunsubSettled();\n\t});\n\n\treturn explanation;\n}\n\n// ============================================================================\n// useConstraintStatus — reactive constraint inspection\n// ============================================================================\n\n/** Get all constraints */\nexport function useConstraintStatus(\n\tsystem: SingleModuleSystem<any>,\n): ComputedRef<ConstraintInfo[]>;\n/** Get a single constraint by ID */\nexport function useConstraintStatus(\n\tsystem: SingleModuleSystem<any>,\n\tconstraintId: string,\n): ComputedRef<ConstraintInfo | null>;\n/** Implementation */\nexport function useConstraintStatus(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\tconstraintId?: string,\n): ComputedRef<ConstraintInfo[] | ConstraintInfo | null> {\n\tassertSystem(\"useConstraintStatus\", system);\n\tconst inspectState = useInspect(system);\n\n\treturn computed(() => {\n\t\t// Track reactivity via inspectState, but use full inspect() for constraint list\n\t\tvoid inspectState.value;\n\t\tconst fullInspection = system.inspect();\n\t\tif (!constraintId) return fullInspection.constraints;\n\t\treturn fullInspection.constraints.find((c) => c.id === constraintId) ?? null;\n\t});\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\nexport interface OptimisticUpdateResult {\n\tmutate: (updateFn: () => void) => void;\n\tisPending: Ref<boolean>;\n\terror: Ref<Error | null>;\n\trollback: () => void;\n}\n\n/**\n * Optimistic update hook. Saves a snapshot before mutating, monitors\n * a requirement type via statusPlugin, and rolls back on failure.\n */\nexport function useOptimisticUpdate(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\tstatusPlugin?: StatusPlugin,\n\trequirementType?: string,\n): OptimisticUpdateResult {\n\tassertSystem(\"useOptimisticUpdate\", system);\n\tconst isPending = ref(false);\n\tconst error = ref<Error | null>(null) as Ref<Error | null>;\n\tlet snapshot: SystemSnapshot | null = null;\n\tlet unsubscribe: (() => void) | null = null;\n\n\tconst rollback = () => {\n\t\tif (snapshot) {\n\t\t\tsystem.restore(snapshot);\n\t\t\tsnapshot = null;\n\t\t}\n\t\tisPending.value = false;\n\t\terror.value = null;\n\t\tunsubscribe?.();\n\t\tunsubscribe = null;\n\t};\n\n\tconst mutate = (updateFn: () => void) => {\n\t\tsnapshot = system.getSnapshot();\n\t\tisPending.value = true;\n\t\terror.value = null;\n\t\tsystem.batch(updateFn);\n\n\t\t// Watch for resolver completion/failure\n\t\tif (statusPlugin && requirementType) {\n\t\t\tunsubscribe?.();\n\t\t\tunsubscribe = statusPlugin.subscribe(() => {\n\t\t\t\tconst status = statusPlugin.getStatus(requirementType);\n\t\t\t\tif (!status.isLoading && !status.hasError) {\n\t\t\t\t\tsnapshot = null;\n\t\t\t\t\tisPending.value = false;\n\t\t\t\t\tunsubscribe?.();\n\t\t\t\t\tunsubscribe = null;\n\t\t\t\t} else if (status.hasError) {\n\t\t\t\t\terror.value = status.lastError;\n\t\t\t\t\trollback();\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t};\n\n\tonScopeDispose(() => {\n\t\tunsubscribe?.();\n\t});\n\n\treturn { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// useTimeTravel — reactive time-travel state\n// ============================================================================\n\n/**\n * Reactive time-travel composable. Returns a ShallowRef that updates\n * when snapshots are taken or navigation occurs.\n *\n * @example\n * ```vue\n * const tt = useTimeTravel(system);\n * <button :disabled=\"!tt.value?.canUndo\" @click=\"tt.value?.undo()\">Undo</button>\n * ```\n */\nexport function useTimeTravel(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n): ShallowRef<ReturnType<typeof buildTimeTravelState>> {\n\tassertSystem(\"useTimeTravel\", system);\n\tconst state = shallowRef<ReturnType<typeof buildTimeTravelState>>(buildTimeTravelState(system));\n\tconst unsub = system.onTimeTravelChange(() => {\n\t\tstate.value = buildTimeTravelState(system);\n\t});\n\tonScopeDispose(unsub);\n\treturn state;\n}\n\n// ============================================================================\n// Scoped System Composable\n// ============================================================================\n\n/** Configuration for useDirective */\ninterface UseDirectiveConfig {\n\t// biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n\tplugins?: Plugin<any>[];\n\tdebug?: DebugConfig;\n\terrorBoundary?: ErrorBoundaryConfig;\n\ttickMs?: number;\n\tzeroConfig?: boolean;\n\t// biome-ignore lint/suspicious/noExplicitAny: Facts type varies\n\tinitialFacts?: Record<string, any>;\n\tstatus?: boolean;\n\t/** Fact keys to subscribe to (omit for all) */\n\tfacts?: string[];\n\t/** Derivation keys to subscribe to (omit for all) */\n\tderived?: string[];\n}\n\n/**\n * Create a scoped Directive system with automatic lifecycle management.\n * When no `facts` or `derived` keys are specified, subscribes to ALL\n * facts and derivations and returns reactive state.\n *\n * @example\n * ```vue\n * // Subscribe to everything\n * const { facts, derived, events, dispatch } = useDirective(counterModule);\n *\n * // Selective keys\n * const { facts, derived } = useDirective(counterModule, { facts: [\"count\"], derived: [\"doubled\"] });\n * ```\n */\nexport function useDirective<M extends ModuleSchema>(\n\tmoduleDef: ModuleDef<M>,\n\tconfig?: UseDirectiveConfig,\n) {\n\tconst allPlugins = [...(config?.plugins ?? [])];\n\tlet statusPlugin: StatusPlugin | undefined;\n\n\tif (config?.status) {\n\t\tconst sp = createRequirementStatusPlugin();\n\t\tstatusPlugin = sp;\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Plugin generic issues\n\t\tallPlugins.push(sp.plugin as Plugin<any>);\n\t}\n\n\t// biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n\tconst system = createSystem({\n\t\tmodule: moduleDef,\n\t\tplugins: allPlugins.length > 0 ? allPlugins : undefined,\n\t\tdebug: config?.debug,\n\t\terrorBoundary: config?.errorBoundary,\n\t\ttickMs: config?.tickMs,\n\t\tzeroConfig: config?.zeroConfig,\n\t\tinitialFacts: config?.initialFacts,\n\t} as any) as unknown as SingleModuleSystem<M>;\n\n\tsystem.start();\n\n\tonScopeDispose(() => {\n\t\tsystem.destroy();\n\t});\n\n\tconst factKeys = config?.facts;\n\tconst derivedKeys = config?.derived;\n\tconst subscribeAll = !factKeys && !derivedKeys;\n\n\t// Subscribe to facts\n\tconst factsState = shallowRef(\n\t\tsubscribeAll\n\t\t\t? (system.facts.$store.toObject() as InferFacts<M>)\n\t\t\t: pickFacts(system, factKeys ?? []),\n\t);\n\tconst unsubFacts = subscribeAll\n\t\t? system.facts.$store.subscribeAll(() => {\n\t\t\tfactsState.value = system.facts.$store.toObject() as InferFacts<M>;\n\t\t})\n\t\t: factKeys && factKeys.length > 0\n\t\t\t? system.facts.$store.subscribe(factKeys, () => {\n\t\t\t\tfactsState.value = pickFacts(system, factKeys) as InferFacts<M>;\n\t\t\t})\n\t\t\t: null;\n\n\t// Subscribe to derivations\n\tconst allDerivationKeys = subscribeAll ? Object.keys(system.derive ?? {}) : (derivedKeys ?? []);\n\tconst getDerived = (): InferDerivations<M> => {\n\t\tconst result: Record<string, unknown> = {};\n\t\tfor (const key of allDerivationKeys) {\n\t\t\tresult[key] = system.read(key);\n\t\t}\n\t\treturn result as InferDerivations<M>;\n\t};\n\tconst derivedState = shallowRef(getDerived());\n\tconst unsubDerived = allDerivationKeys.length > 0\n\t\t? system.subscribe(allDerivationKeys, () => { derivedState.value = getDerived(); })\n\t\t: null;\n\n\tonScopeDispose(() => {\n\t\tunsubFacts?.();\n\t\tunsubDerived?.();\n\t});\n\n\tconst events = system.events;\n\tconst dispatch = (event: InferEvents<M>) => system.dispatch(event);\n\n\treturn {\n\t\tsystem,\n\t\tfacts: factsState as ShallowRef<InferFacts<M>>,\n\t\tderived: derivedState as ShallowRef<InferDerivations<M>>,\n\t\tevents,\n\t\tdispatch,\n\t\tstatusPlugin,\n\t};\n}\n\n// ============================================================================\n// Typed Hooks Factory\n// ============================================================================\n\nexport function createTypedHooks<M extends ModuleSchema>(): {\n\tuseFact: <K extends keyof InferFacts<M> & string>(\n\t\tsystem: SingleModuleSystem<M>,\n\t\tfactKey: K,\n\t) => Ref<InferFacts<M>[K] | undefined>;\n\tuseDerived: <K extends keyof InferDerivations<M> & string>(\n\t\tsystem: SingleModuleSystem<M>,\n\t\tderivationId: K,\n\t) => Ref<InferDerivations<M>[K]>;\n\tuseDispatch: (system: SingleModuleSystem<M>) => (event: InferEvents<M>) => void;\n\tuseEvents: (system: SingleModuleSystem<M>) => SingleModuleSystem<M>[\"events\"];\n\tuseWatch: <K extends string>(\n\t\tsystem: SingleModuleSystem<M>,\n\t\tkey: K,\n\t\tcallback: (newValue: unknown, previousValue: unknown) => void,\n\t) => void;\n} {\n\treturn {\n\t\tuseFact: <K extends keyof InferFacts<M> & string>(system: SingleModuleSystem<M>, factKey: K) =>\n\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Type narrowing for internal call\n\t\t\tuseFact(system as SingleModuleSystem<any>, factKey) as Ref<InferFacts<M>[K] | undefined>,\n\t\tuseDerived: <K extends keyof InferDerivations<M> & string>(system: SingleModuleSystem<M>, derivationId: K) =>\n\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Type narrowing for internal call\n\t\t\tuseDerived(system as SingleModuleSystem<any>, derivationId) as Ref<InferDerivations<M>[K]>,\n\t\tuseDispatch: (system: SingleModuleSystem<M>) => {\n\t\t\treturn (event: InferEvents<M>) => {\n\t\t\t\tsystem.dispatch(event);\n\t\t\t};\n\t\t},\n\t\tuseEvents: (system: SingleModuleSystem<M>) => useEvents<M>(system),\n\t\tuseWatch: <K extends string>(\n\t\t\tsystem: SingleModuleSystem<M>,\n\t\t\tkey: K,\n\t\t\tcallback: (newValue: unknown, previousValue: unknown) => void,\n\t\t) =>\n\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Type narrowing for internal call\n\t\t\tuseWatch(system as SingleModuleSystem<any>, key, callback),\n\t};\n}\n"]}

package/dist/index.d.cts

@@ -29,7 +29,6 @@ declare function useDerived<S extends ModuleSchema, K extends keyof InferDerivat
  * 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.
@@ -39,13 +38,6 @@ declare function useEvents<S extends ModuleSchema>(system: SingleModuleSystem<S>
 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;

package/dist/index.d.ts

@@ -29,7 +29,6 @@ declare function useDerived<S extends ModuleSchema, K extends keyof InferDerivat
  * 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.
@@ -39,13 +38,6 @@ declare function useEvents<S extends ModuleSchema>(system: SingleModuleSystem<S>
 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;

package/dist/index.js

@@ -1,2 +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
+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 E(e,t){return assertSystem("useFact",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useFact() received a function. Did you mean useSelector()? useFact() takes a string key or array of keys, not a selector function."),Array.isArray(t)?V(e,t):T(e,t)}function T(e,t){process.env.NODE_ENV!=="production"&&(e.facts.$store.has(t)||console.warn(`[Directive] useFact("${t}") \u2014 fact not found in store. Check that "${t}" is defined in your module's schema.`));let s=ref(e.facts.$store.get(t)),o=e.facts.$store.subscribe([t],()=>{s.value=e.facts.$store.get(t);});return onScopeDispose(o),s}function V(e,t){let s=()=>{let r={};for(let u of t)r[u]=e.facts.$store.get(u);return r},o=shallowRef(s()),n=e.facts.$store.subscribe(t,()=>{o.value=s();});return onScopeDispose(n),o}function $(e,t){return assertSystem("useDerived",e),process.env.NODE_ENV!=="production"&&typeof t=="function"&&console.error("[Directive] useDerived() received a function. Did you mean useSelector()? useDerived() takes a string key or array of keys, not a selector function."),Array.isArray(t)?A(e,t):q(e,t)}function q(e,t){process.env.NODE_ENV!=="production"&&e.read(t)===void 0&&console.warn(`[Directive] useDerived("${t}") returned undefined. Check that "${t}" is defined in your module's derive property.`);let s=ref(e.read(t)),o=e.subscribe([t],()=>{s.value=e.read(t);});return onScopeDispose(o),s}function A(e,t){let s=()=>{let r={};for(let u of t)r[u]=e.read(u);return r},o=shallowRef(s()),n=e.subscribe(t,()=>{o.value=s();});return onScopeDispose(n),o}function z(e,t,s=defaultEquality){assertSystem("useSelector",e);let o=new Set(Object.keys(e.derive??{})),n=()=>runTrackedSelector(e,o,t),r=n(),u=r.factKeys,i=r.deriveKeys,l=ref(r.value),S=[],c=()=>{for(let d of S)d();S.length=0;let g=()=>{let d=n();s(l.value,d.value)||(l.value=d.value),depsChanged(u,d.factKeys,i,d.deriveKeys)&&(u=d.factKeys,i=d.deriveKeys,c());};u.length>0?S.push(e.facts.$store.subscribe(u,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){assertSystem("useWatch",e);let o=e.watch(t,s);onScopeDispose(o);}function N(e,t){assertSystem("useInspect",e);let s=shallowRef(computeInspectState(e)),o=()=>{s.value=computeInspectState(e);};if(t?.throttleMs&&t.throttleMs>0){let{throttled:n,cleanup:r}=createThrottle(o,t.throttleMs),u=e.facts.$store.subscribeAll(n),i=e.onSettledChange(n);onScopeDispose(()=>{r(),u(),i();});}else {let n=e.facts.$store.subscribeAll(o),r=e.onSettledChange(o);onScopeDispose(()=>{n(),r();});}return s}function L(e,t){if(Array.isArray(t)){let n=()=>{let i={};for(let l of t)i[l]=e.getStatus(l);return i},r=shallowRef(n()),u=e.subscribe(()=>{r.value=n();});return onScopeDispose(u),r}let s=shallowRef(e.getStatus(t)),o=e.subscribe(()=>{s.value=e.getStatus(t);});return onScopeDispose(o),s}function G(e,t){assertSystem("useExplain",e);let s=ref(e.explain(t)),o=()=>{s.value=e.explain(t);},n=e.facts.$store.subscribeAll(o),r=e.onSettledChange(o);return onScopeDispose(()=>{n(),r();}),s}function J(e,t){assertSystem("useConstraintStatus",e);let s=N(e);return computed(()=>{s.value;let o=e.inspect();return t?o.constraints.find(n=>n.id===t)??null:o.constraints})}function Q(e,t,s){assertSystem("useOptimisticUpdate",e);let o=ref(false),n=ref(null),r=null,u=null,i=()=>{r&&(e.restore(r),r=null),o.value=false,n.value=null,u?.(),u=null;},l=S=>{r=e.getSnapshot(),o.value=true,n.value=null,e.batch(S),t&&s&&(u?.(),u=t.subscribe(()=>{let c=t.getStatus(s);!c.isLoading&&!c.hasError?(r=null,o.value=false,u?.(),u=null):c.hasError&&(n.value=c.lastError,i());}));};return onScopeDispose(()=>{u?.();}),{mutate:l,isPending:o,error:n,rollback:i}}function X(e){assertSystem("useTimeTravel",e);let t=shallowRef(buildTimeTravelState(e)),s=e.onTimeTravelChange(()=>{t.value=buildTimeTravelState(e);});return onScopeDispose(s),t}function Y(e,t){let s=[...t?.plugins??[]],o;if(t?.status){let v=createRequirementStatusPlugin();o=v,s.push(v.plugin);}let n=createSystem({module:e,plugins:s.length>0?s:void 0,debug:t?.debug,errorBoundary:t?.errorBoundary,tickMs:t?.tickMs,zeroConfig:t?.zeroConfig,initialFacts:t?.initialFacts});n.start(),onScopeDispose(()=>{n.destroy();});let r=t?.facts,u=t?.derived,i=!r&&!u,l=shallowRef(i?n.facts.$store.toObject():pickFacts(n,r??[])),S=i?n.facts.$store.subscribeAll(()=>{l.value=n.facts.$store.toObject();}):r&&r.length>0?n.facts.$store.subscribe(r,()=>{l.value=pickFacts(n,r);}):null,c=i?Object.keys(n.derive??{}):u??[],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)=>E(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,E as useFact,N as useInspect,Q as useOptimisticUpdate,L as useRequirementStatus,z as useSelector,X as useTimeTravel,U as useWatch};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["useFact","system","keyOrKeys","assertSystem","_useFactMulti","_useFactSingle","factKey","value","ref","unsubscribe","onScopeDispose","factKeys","getValues","result","key","state","shallowRef","useDerived","idOrIds","_useDerivedMulti","_useDerivedSingle","derivationId","derivationIds","id","useSelector","selector","equalityFn","defaultEquality","deriveKeySet","runWithTracking","runTrackedSelector","initial","trackedFactKeys","trackedDeriveKeys","selected","unsubs","resubscribe","unsub","onUpdate","depsChanged","useDispatch","event","useEvents","useWatch","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.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"]}
+{"version":3,"sources":["../src/index.ts"],"names":["useFact","system","keyOrKeys","assertSystem","_useFactMulti","_useFactSingle","factKey","value","ref","unsubscribe","onScopeDispose","factKeys","getValues","result","key","state","shallowRef","useDerived","idOrIds","_useDerivedMulti","_useDerivedSingle","derivationId","derivationIds","id","useSelector","selector","equalityFn","defaultEquality","deriveKeySet","runWithTracking","runTrackedSelector","initial","trackedFactKeys","trackedDeriveKeys","selected","unsubs","resubscribe","unsub","onUpdate","depsChanged","useDispatch","event","useEvents","useWatch","callback","useInspect","options","computeInspectState","update","throttled","cleanup","createThrottle","unsubFacts","unsubSettled","useRequirementStatus","statusPlugin","typeOrTypes","type","status","useExplain","requirementId","explanation","useConstraintStatus","constraintId","inspectState","computed","fullInspection","c","useOptimisticUpdate","requirementType","isPending","error","snapshot","rollback","mutate","updateFn","useTimeTravel","buildTimeTravelState","useDirective","moduleDef","config","allPlugins","sp","createRequirementStatusPlugin","createSystem","derivedKeys","subscribeAll","factsState","pickFacts","allDerivationKeys","getDerived","derivedState","unsubDerived","events","createTypedHooks"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Vue Adapter - Vue 3 composables for Directive\n *\n * Exports: useFact, useDerived, useDispatch, useSelector,\n * useWatch, useInspect, useRequirementStatus, useEvents, useExplain,\n * useConstraintStatus, useOptimisticUpdate, useDirective, useTimeTravel,\n * createTypedHooks, shallowEqual\n */\n\nimport {\n\tcomputed,\n\tonScopeDispose,\n\tref,\n\tshallowRef,\n\ttype ComputedRef,\n\ttype Ref,\n\ttype ShallowRef,\n} from \"vue\";\nimport type {\n\tModuleSchema,\n\tModuleDef,\n\tPlugin,\n\tDebugConfig,\n\tErrorBoundaryConfig,\n\tInferFacts,\n\tInferDerivations,\n\tInferSelectorState,\n\tInferEvents,\n\tSingleModuleSystem,\n\tSystemSnapshot,\n} from \"@directive-run/core\";\nimport {\n\tcreateSystem,\n\tcreateRequirementStatusPlugin,\n} from \"@directive-run/core\";\nimport type { RequirementTypeStatus } from \"@directive-run/core\";\nimport {\n\ttype InspectState,\n\ttype ConstraintInfo,\n\tcomputeInspectState,\n\tcreateThrottle,\n\tassertSystem,\n\tdefaultEquality,\n\tbuildTimeTravelState,\n\tpickFacts,\n\trunTrackedSelector,\n\tdepsChanged,\n\tshallowEqual,\n} from \"@directive-run/core/adapter-utils\";\n\n// Re-export for convenience\nexport type { RequirementTypeStatus, InspectState, ConstraintInfo };\nexport { shallowEqual };\n\n/** Type for the requirement status plugin return value */\nexport type StatusPlugin = ReturnType<typeof createRequirementStatusPlugin>;\n\n// ============================================================================\n// useFact — single key or multi key\n// ============================================================================\n\n/** Single key overload */\nexport function useFact<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, factKey: K): Ref<InferFacts<S>[K] | undefined>;\n/** Multi-key overload */\nexport function useFact<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(system: SingleModuleSystem<S>, factKeys: K[]): ShallowRef<Pick<InferFacts<S>, K>>;\n/** Implementation */\nexport function useFact(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tkeyOrKeys: string | string[],\n): Ref<unknown> | ShallowRef<unknown> {\n\tassertSystem(\"useFact\", system);\n\tif (process.env.NODE_ENV !== \"production\" && typeof keyOrKeys === \"function\") {\n\t\tconsole.error(\n\t\t\t\"[Directive] useFact() received a function. Did you mean useSelector()? \" +\n\t\t\t\t\"useFact() takes a string key or array of keys, not a selector function.\",\n\t\t);\n\t}\n\n\t// Multi-key path: useFact(system, [keys])\n\tif (Array.isArray(keyOrKeys)) {\n\t\treturn _useFactMulti(system, keyOrKeys);\n\t}\n\n\t// Single key path: useFact(system, key)\n\treturn _useFactSingle(system, keyOrKeys);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactSingle(system: SingleModuleSystem<any>, factKey: string): Ref<unknown> {\n\tif (process.env.NODE_ENV !== \"production\") {\n\t\tif (!system.facts.$store.has(factKey)) {\n\t\t\tconsole.warn(\n\t\t\t\t`[Directive] useFact(\"${factKey}\") — fact not found in store. ` +\n\t\t\t\t`Check that \"${factKey}\" is defined in your module's schema.`,\n\t\t\t);\n\t\t}\n\t}\n\n\tconst value = ref(system.facts.$store.get(factKey));\n\tconst unsubscribe = system.facts.$store.subscribe([factKey], () => {\n\t\tvalue.value = system.facts.$store.get(factKey);\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useFactMulti(system: SingleModuleSystem<any>, factKeys: string[]): ShallowRef<Record<string, unknown>> {\n\tconst getValues = (): Record<string, unknown> => {\n\t\tconst result: Record<string, unknown> = {};\n\t\tfor (const key of factKeys) {\n\t\t\tresult[key] = system.facts.$store.get(key);\n\t\t}\n\t\treturn result;\n\t};\n\tconst state = shallowRef(getValues());\n\tconst unsubscribe = system.facts.$store.subscribe(factKeys, () => {\n\t\tstate.value = getValues();\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn state;\n}\n\n// ============================================================================\n// useDerived — single key or multi key\n// ============================================================================\n\n/** Single key overload */\nexport function useDerived<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, derivationId: K): Ref<InferDerivations<S>[K]>;\n/** Multi-key overload */\nexport function useDerived<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(system: SingleModuleSystem<S>, derivationIds: K[]): ShallowRef<Pick<InferDerivations<S>, K>>;\n/** Implementation */\nexport function useDerived(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tidOrIds: string | string[],\n): Ref<unknown> | ShallowRef<unknown> {\n\tassertSystem(\"useDerived\", system);\n\tif (process.env.NODE_ENV !== \"production\" && typeof idOrIds === \"function\") {\n\t\tconsole.error(\n\t\t\t\"[Directive] useDerived() received a function. Did you mean useSelector()? \" +\n\t\t\t\t\"useDerived() takes a string key or array of keys, not a selector function.\",\n\t\t);\n\t}\n\n\t// Multi-key path\n\tif (Array.isArray(idOrIds)) {\n\t\treturn _useDerivedMulti(system, idOrIds);\n\t}\n\n\t// Single key path\n\treturn _useDerivedSingle(system, idOrIds);\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedSingle(system: SingleModuleSystem<any>, derivationId: string): Ref<unknown> {\n\tif (process.env.NODE_ENV !== \"production\") {\n\t\tconst initialValue = system.read(derivationId);\n\t\tif (initialValue === undefined) {\n\t\t\tconsole.warn(\n\t\t\t\t`[Directive] useDerived(\"${derivationId}\") returned undefined. ` +\n\t\t\t\t`Check that \"${derivationId}\" is defined in your module's derive property.`,\n\t\t\t);\n\t\t}\n\t}\n\tconst value = ref(system.read(derivationId));\n\tconst unsubscribe = system.subscribe([derivationId], () => {\n\t\tvalue.value = system.read(derivationId);\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn value;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Internal\nfunction _useDerivedMulti(system: SingleModuleSystem<any>, derivationIds: string[]): ShallowRef<Record<string, unknown>> {\n\tconst getValues = (): Record<string, unknown> => {\n\t\tconst result: Record<string, unknown> = {};\n\t\tfor (const id of derivationIds) {\n\t\t\tresult[id] = system.read(id);\n\t\t}\n\t\treturn result;\n\t};\n\tconst state = shallowRef(getValues());\n\tconst unsubscribe = system.subscribe(derivationIds, () => {\n\t\tstate.value = getValues();\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn state;\n}\n\n// ============================================================================\n// useSelector — auto-tracking selector over facts and derivations\n// ============================================================================\n\n/**\n * Auto-tracking selector over facts and derivations.\n * Uses `withTracking()` to detect which facts the selector accesses,\n * then subscribes only to those keys.\n */\nexport function useSelector<S extends ModuleSchema, R>(system: SingleModuleSystem<S>, selector: (state: InferSelectorState<S>) => R, equalityFn?: (a: R, b: R) => boolean): Ref<R>;\nexport function useSelector(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tselector: (state: Record<string, unknown>) => unknown,\n\tequalityFn: (a: unknown, b: unknown) => boolean = defaultEquality,\n): Ref<unknown> {\n\tassertSystem(\"useSelector\", system);\n\tconst deriveKeySet = new Set(Object.keys(system.derive ?? {}));\n\n\tconst runWithTracking = () => runTrackedSelector(system, deriveKeySet, selector);\n\n\tconst initial = runWithTracking();\n\tlet trackedFactKeys = initial.factKeys;\n\tlet trackedDeriveKeys = initial.deriveKeys;\n\tconst selected = ref(initial.value);\n\n\tconst unsubs: Array<() => void> = [];\n\n\tconst resubscribe = () => {\n\t\tfor (const unsub of unsubs) unsub();\n\t\tunsubs.length = 0;\n\n\t\tconst onUpdate = () => {\n\t\t\tconst result = runWithTracking();\n\t\t\tif (!equalityFn(selected.value, result.value)) {\n\t\t\t\tselected.value = result.value;\n\t\t\t}\n\t\t\t// Re-track: check if deps changed\n\t\t\tif (depsChanged(trackedFactKeys, result.factKeys, trackedDeriveKeys, result.deriveKeys)) {\n\t\t\t\ttrackedFactKeys = result.factKeys;\n\t\t\t\ttrackedDeriveKeys = result.deriveKeys;\n\t\t\t\tresubscribe();\n\t\t\t}\n\t\t};\n\n\t\tif (trackedFactKeys.length > 0) {\n\t\t\tunsubs.push(system.facts.$store.subscribe(trackedFactKeys, onUpdate));\n\t\t} else if (trackedDeriveKeys.length === 0) {\n\t\t\tunsubs.push(system.facts.$store.subscribeAll(onUpdate));\n\t\t}\n\t\tif (trackedDeriveKeys.length > 0) {\n\t\t\tunsubs.push(system.subscribe(trackedDeriveKeys, onUpdate));\n\t\t}\n\t};\n\n\tresubscribe();\n\n\tonScopeDispose(() => {\n\t\tfor (const unsub of unsubs) unsub();\n\t});\n\n\treturn selected;\n}\n\n// ============================================================================\n// useDispatch\n// ============================================================================\n\nexport function useDispatch<S extends ModuleSchema>(\n\tsystem: SingleModuleSystem<S>,\n): (event: InferEvents<S>) => void {\n\tassertSystem(\"useDispatch\", system);\n\treturn (event: InferEvents<S>) => {\n\t\tsystem.dispatch(event);\n\t};\n}\n\n// ============================================================================\n// useEvents — memoized events reference\n// ============================================================================\n\n/**\n * Returns the system's events dispatcher.\n */\nexport function useEvents<S extends ModuleSchema>(\n\tsystem: SingleModuleSystem<S>,\n): SingleModuleSystem<S>[\"events\"] {\n\tassertSystem(\"useEvents\", system);\n\treturn system.events;\n}\n\n// ============================================================================\n// useWatch — derivation or fact side-effect\n// ============================================================================\n\n/** Watch a derivation or fact by key (auto-detected). When a key exists in both facts and derivations, the derivation overload takes priority. */\nexport function useWatch<S extends ModuleSchema, K extends keyof InferDerivations<S> & string>(\n\tsystem: SingleModuleSystem<S>,\n\tkey: K,\n\tcallback: (newValue: InferDerivations<S>[K], previousValue: InferDerivations<S>[K] | undefined) => void,\n): void;\n/** Watch a fact key with auto-detection. */\nexport function useWatch<S extends ModuleSchema, K extends keyof InferFacts<S> & string>(\n\tsystem: SingleModuleSystem<S>,\n\tkey: K,\n\tcallback: (newValue: InferFacts<S>[K] | undefined, previousValue: InferFacts<S>[K] | undefined) => void,\n): void;\n/** Implementation */\nexport function useWatch(\n\t// biome-ignore lint/suspicious/noExplicitAny: Implementation signature\n\tsystem: SingleModuleSystem<any>,\n\tkey: string,\n\tcallback: (newValue: unknown, prevValue: unknown) => void,\n): void {\n\tassertSystem(\"useWatch\", system);\n\n\tconst unsubscribe = system.watch(key, callback);\n\tonScopeDispose(unsubscribe);\n}\n\n// ============================================================================\n// useInspect — consolidated inspection hook\n// ============================================================================\n\n/** Options for useInspect */\nexport interface UseInspectOptions {\n\tthrottleMs?: number;\n}\n\n/**\n * Consolidated system inspection hook.\n * Returns InspectState with optional throttling.\n */\nexport function useInspect(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\toptions?: UseInspectOptions,\n): ShallowRef<InspectState> {\n\tassertSystem(\"useInspect\", system);\n\tconst state = shallowRef<InspectState>(computeInspectState(system));\n\n\tconst update = () => {\n\t\tstate.value = computeInspectState(system);\n\t};\n\n\tif (options?.throttleMs && options.throttleMs > 0) {\n\t\tconst { throttled, cleanup } = createThrottle(update, options.throttleMs);\n\t\tconst unsubFacts = system.facts.$store.subscribeAll(throttled);\n\t\tconst unsubSettled = system.onSettledChange(throttled);\n\t\tonScopeDispose(() => {\n\t\t\tcleanup();\n\t\t\tunsubFacts();\n\t\t\tunsubSettled();\n\t\t});\n\t} else {\n\t\tconst unsubFacts = system.facts.$store.subscribeAll(update);\n\t\tconst unsubSettled = system.onSettledChange(update);\n\t\tonScopeDispose(() => {\n\t\t\tunsubFacts();\n\t\t\tunsubSettled();\n\t\t});\n\t}\n\n\treturn state;\n}\n\n// ============================================================================\n// useRequirementStatus — single or multi\n// ============================================================================\n\n/** Single type overload */\nexport function useRequirementStatus(statusPlugin: StatusPlugin, type: string): ShallowRef<RequirementTypeStatus>;\n/** Multi-type overload */\nexport function useRequirementStatus(statusPlugin: StatusPlugin, types: string[]): ShallowRef<Record<string, RequirementTypeStatus>>;\n/** Implementation */\nexport function useRequirementStatus(\n\tstatusPlugin: StatusPlugin,\n\ttypeOrTypes: string | string[],\n): ShallowRef<RequirementTypeStatus> | ShallowRef<Record<string, RequirementTypeStatus>> {\n\tif (Array.isArray(typeOrTypes)) {\n\t\tconst getValues = (): Record<string, RequirementTypeStatus> => {\n\t\t\tconst result: Record<string, RequirementTypeStatus> = {};\n\t\t\tfor (const type of typeOrTypes) {\n\t\t\t\tresult[type] = statusPlugin.getStatus(type);\n\t\t\t}\n\t\t\treturn result;\n\t\t};\n\t\tconst state = shallowRef(getValues());\n\t\tconst unsubscribe = statusPlugin.subscribe(() => {\n\t\t\tstate.value = getValues();\n\t\t});\n\t\tonScopeDispose(unsubscribe);\n\t\treturn state;\n\t}\n\n\tconst status = shallowRef<RequirementTypeStatus>(statusPlugin.getStatus(typeOrTypes));\n\tconst unsubscribe = statusPlugin.subscribe(() => {\n\t\tstatus.value = statusPlugin.getStatus(typeOrTypes);\n\t});\n\tonScopeDispose(unsubscribe);\n\treturn status;\n}\n\n// ============================================================================\n// useExplain — reactive requirement explanation\n// ============================================================================\n\n/**\n * Reactively returns the explanation string for a requirement.\n */\nexport function useExplain(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\trequirementId: string,\n): Ref<string | null> {\n\tassertSystem(\"useExplain\", system);\n\tconst explanation = ref<string | null>(system.explain(requirementId)) as Ref<string | null>;\n\n\tconst update = () => {\n\t\texplanation.value = system.explain(requirementId);\n\t};\n\n\tconst unsubFacts = system.facts.$store.subscribeAll(update);\n\tconst unsubSettled = system.onSettledChange(update);\n\tonScopeDispose(() => {\n\t\tunsubFacts();\n\t\tunsubSettled();\n\t});\n\n\treturn explanation;\n}\n\n// ============================================================================\n// useConstraintStatus — reactive constraint inspection\n// ============================================================================\n\n/** Get all constraints */\nexport function useConstraintStatus(\n\tsystem: SingleModuleSystem<any>,\n): ComputedRef<ConstraintInfo[]>;\n/** Get a single constraint by ID */\nexport function useConstraintStatus(\n\tsystem: SingleModuleSystem<any>,\n\tconstraintId: string,\n): ComputedRef<ConstraintInfo | null>;\n/** Implementation */\nexport function useConstraintStatus(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\tconstraintId?: string,\n): ComputedRef<ConstraintInfo[] | ConstraintInfo | null> {\n\tassertSystem(\"useConstraintStatus\", system);\n\tconst inspectState = useInspect(system);\n\n\treturn computed(() => {\n\t\t// Track reactivity via inspectState, but use full inspect() for constraint list\n\t\tvoid inspectState.value;\n\t\tconst fullInspection = system.inspect();\n\t\tif (!constraintId) return fullInspection.constraints;\n\t\treturn fullInspection.constraints.find((c) => c.id === constraintId) ?? null;\n\t});\n}\n\n// ============================================================================\n// useOptimisticUpdate — batch with rollback on failure\n// ============================================================================\n\nexport interface OptimisticUpdateResult {\n\tmutate: (updateFn: () => void) => void;\n\tisPending: Ref<boolean>;\n\terror: Ref<Error | null>;\n\trollback: () => void;\n}\n\n/**\n * Optimistic update hook. Saves a snapshot before mutating, monitors\n * a requirement type via statusPlugin, and rolls back on failure.\n */\nexport function useOptimisticUpdate(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n\tstatusPlugin?: StatusPlugin,\n\trequirementType?: string,\n): OptimisticUpdateResult {\n\tassertSystem(\"useOptimisticUpdate\", system);\n\tconst isPending = ref(false);\n\tconst error = ref<Error | null>(null) as Ref<Error | null>;\n\tlet snapshot: SystemSnapshot | null = null;\n\tlet unsubscribe: (() => void) | null = null;\n\n\tconst rollback = () => {\n\t\tif (snapshot) {\n\t\t\tsystem.restore(snapshot);\n\t\t\tsnapshot = null;\n\t\t}\n\t\tisPending.value = false;\n\t\terror.value = null;\n\t\tunsubscribe?.();\n\t\tunsubscribe = null;\n\t};\n\n\tconst mutate = (updateFn: () => void) => {\n\t\tsnapshot = system.getSnapshot();\n\t\tisPending.value = true;\n\t\terror.value = null;\n\t\tsystem.batch(updateFn);\n\n\t\t// Watch for resolver completion/failure\n\t\tif (statusPlugin && requirementType) {\n\t\t\tunsubscribe?.();\n\t\t\tunsubscribe = statusPlugin.subscribe(() => {\n\t\t\t\tconst status = statusPlugin.getStatus(requirementType);\n\t\t\t\tif (!status.isLoading && !status.hasError) {\n\t\t\t\t\tsnapshot = null;\n\t\t\t\t\tisPending.value = false;\n\t\t\t\t\tunsubscribe?.();\n\t\t\t\t\tunsubscribe = null;\n\t\t\t\t} else if (status.hasError) {\n\t\t\t\t\terror.value = status.lastError;\n\t\t\t\t\trollback();\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t};\n\n\tonScopeDispose(() => {\n\t\tunsubscribe?.();\n\t});\n\n\treturn { mutate, isPending, error, rollback };\n}\n\n// ============================================================================\n// useTimeTravel — reactive time-travel state\n// ============================================================================\n\n/**\n * Reactive time-travel composable. Returns a ShallowRef that updates\n * when snapshots are taken or navigation occurs.\n *\n * @example\n * ```vue\n * const tt = useTimeTravel(system);\n * <button :disabled=\"!tt.value?.canUndo\" @click=\"tt.value?.undo()\">Undo</button>\n * ```\n */\nexport function useTimeTravel(\n\t// biome-ignore lint/suspicious/noExplicitAny: Must work with any schema\n\tsystem: SingleModuleSystem<any>,\n): ShallowRef<ReturnType<typeof buildTimeTravelState>> {\n\tassertSystem(\"useTimeTravel\", system);\n\tconst state = shallowRef<ReturnType<typeof buildTimeTravelState>>(buildTimeTravelState(system));\n\tconst unsub = system.onTimeTravelChange(() => {\n\t\tstate.value = buildTimeTravelState(system);\n\t});\n\tonScopeDispose(unsub);\n\treturn state;\n}\n\n// ============================================================================\n// Scoped System Composable\n// ============================================================================\n\n/** Configuration for useDirective */\ninterface UseDirectiveConfig {\n\t// biome-ignore lint/suspicious/noExplicitAny: Plugin types vary\n\tplugins?: Plugin<any>[];\n\tdebug?: DebugConfig;\n\terrorBoundary?: ErrorBoundaryConfig;\n\ttickMs?: number;\n\tzeroConfig?: boolean;\n\t// biome-ignore lint/suspicious/noExplicitAny: Facts type varies\n\tinitialFacts?: Record<string, any>;\n\tstatus?: boolean;\n\t/** Fact keys to subscribe to (omit for all) */\n\tfacts?: string[];\n\t/** Derivation keys to subscribe to (omit for all) */\n\tderived?: string[];\n}\n\n/**\n * Create a scoped Directive system with automatic lifecycle management.\n * When no `facts` or `derived` keys are specified, subscribes to ALL\n * facts and derivations and returns reactive state.\n *\n * @example\n * ```vue\n * // Subscribe to everything\n * const { facts, derived, events, dispatch } = useDirective(counterModule);\n *\n * // Selective keys\n * const { facts, derived } = useDirective(counterModule, { facts: [\"count\"], derived: [\"doubled\"] });\n * ```\n */\nexport function useDirective<M extends ModuleSchema>(\n\tmoduleDef: ModuleDef<M>,\n\tconfig?: UseDirectiveConfig,\n) {\n\tconst allPlugins = [...(config?.plugins ?? [])];\n\tlet statusPlugin: StatusPlugin | undefined;\n\n\tif (config?.status) {\n\t\tconst sp = createRequirementStatusPlugin();\n\t\tstatusPlugin = sp;\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Plugin generic issues\n\t\tallPlugins.push(sp.plugin as Plugin<any>);\n\t}\n\n\t// biome-ignore lint/suspicious/noExplicitAny: Required for overload compatibility\n\tconst system = createSystem({\n\t\tmodule: moduleDef,\n\t\tplugins: allPlugins.length > 0 ? allPlugins : undefined,\n\t\tdebug: config?.debug,\n\t\terrorBoundary: config?.errorBoundary,\n\t\ttickMs: config?.tickMs,\n\t\tzeroConfig: config?.zeroConfig,\n\t\tinitialFacts: config?.initialFacts,\n\t} as any) as unknown as SingleModuleSystem<M>;\n\n\tsystem.start();\n\n\tonScopeDispose(() => {\n\t\tsystem.destroy();\n\t});\n\n\tconst factKeys = config?.facts;\n\tconst derivedKeys = config?.derived;\n\tconst subscribeAll = !factKeys && !derivedKeys;\n\n\t// Subscribe to facts\n\tconst factsState = shallowRef(\n\t\tsubscribeAll\n\t\t\t? (system.facts.$store.toObject() as InferFacts<M>)\n\t\t\t: pickFacts(system, factKeys ?? []),\n\t);\n\tconst unsubFacts = subscribeAll\n\t\t? system.facts.$store.subscribeAll(() => {\n\t\t\tfactsState.value = system.facts.$store.toObject() as InferFacts<M>;\n\t\t})\n\t\t: factKeys && factKeys.length > 0\n\t\t\t? system.facts.$store.subscribe(factKeys, () => {\n\t\t\t\tfactsState.value = pickFacts(system, factKeys) as InferFacts<M>;\n\t\t\t})\n\t\t\t: null;\n\n\t// Subscribe to derivations\n\tconst allDerivationKeys = subscribeAll ? Object.keys(system.derive ?? {}) : (derivedKeys ?? []);\n\tconst getDerived = (): InferDerivations<M> => {\n\t\tconst result: Record<string, unknown> = {};\n\t\tfor (const key of allDerivationKeys) {\n\t\t\tresult[key] = system.read(key);\n\t\t}\n\t\treturn result as InferDerivations<M>;\n\t};\n\tconst derivedState = shallowRef(getDerived());\n\tconst unsubDerived = allDerivationKeys.length > 0\n\t\t? system.subscribe(allDerivationKeys, () => { derivedState.value = getDerived(); })\n\t\t: null;\n\n\tonScopeDispose(() => {\n\t\tunsubFacts?.();\n\t\tunsubDerived?.();\n\t});\n\n\tconst events = system.events;\n\tconst dispatch = (event: InferEvents<M>) => system.dispatch(event);\n\n\treturn {\n\t\tsystem,\n\t\tfacts: factsState as ShallowRef<InferFacts<M>>,\n\t\tderived: derivedState as ShallowRef<InferDerivations<M>>,\n\t\tevents,\n\t\tdispatch,\n\t\tstatusPlugin,\n\t};\n}\n\n// ============================================================================\n// Typed Hooks Factory\n// ============================================================================\n\nexport function createTypedHooks<M extends ModuleSchema>(): {\n\tuseFact: <K extends keyof InferFacts<M> & string>(\n\t\tsystem: SingleModuleSystem<M>,\n\t\tfactKey: K,\n\t) => Ref<InferFacts<M>[K] | undefined>;\n\tuseDerived: <K extends keyof InferDerivations<M> & string>(\n\t\tsystem: SingleModuleSystem<M>,\n\t\tderivationId: K,\n\t) => Ref<InferDerivations<M>[K]>;\n\tuseDispatch: (system: SingleModuleSystem<M>) => (event: InferEvents<M>) => void;\n\tuseEvents: (system: SingleModuleSystem<M>) => SingleModuleSystem<M>[\"events\"];\n\tuseWatch: <K extends string>(\n\t\tsystem: SingleModuleSystem<M>,\n\t\tkey: K,\n\t\tcallback: (newValue: unknown, previousValue: unknown) => void,\n\t) => void;\n} {\n\treturn {\n\t\tuseFact: <K extends keyof InferFacts<M> & string>(system: SingleModuleSystem<M>, factKey: K) =>\n\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Type narrowing for internal call\n\t\t\tuseFact(system as SingleModuleSystem<any>, factKey) as Ref<InferFacts<M>[K] | undefined>,\n\t\tuseDerived: <K extends keyof InferDerivations<M> & string>(system: SingleModuleSystem<M>, derivationId: K) =>\n\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Type narrowing for internal call\n\t\t\tuseDerived(system as SingleModuleSystem<any>, derivationId) as Ref<InferDerivations<M>[K]>,\n\t\tuseDispatch: (system: SingleModuleSystem<M>) => {\n\t\t\treturn (event: InferEvents<M>) => {\n\t\t\t\tsystem.dispatch(event);\n\t\t\t};\n\t\t},\n\t\tuseEvents: (system: SingleModuleSystem<M>) => useEvents<M>(system),\n\t\tuseWatch: <K extends string>(\n\t\t\tsystem: SingleModuleSystem<M>,\n\t\t\tkey: K,\n\t\t\tcallback: (newValue: unknown, previousValue: unknown) => void,\n\t\t) =>\n\t\t\t// biome-ignore lint/suspicious/noExplicitAny: Type narrowing for internal call\n\t\t\tuseWatch(system as SingleModuleSystem<any>, key, callback),\n\t};\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@directive-run/vue",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Vue composition API adapter for Directive.",
   "license": "MIT",
   "author": "Jason Comes",
@@ -44,15 +44,15 @@
     "dist"
   ],
   "peerDependencies": {
-    "vue": ">=3",
-    "@directive-run/core": "0.1.1"
+    "@directive-run/core": "*",
+    "vue": ">=3"
   },
   "devDependencies": {
     "@types/node": "^25.2.0",
     "vue": "^3.4.0",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
-    "@directive-run/core": "0.1.1"
+    "@directive-run/core": "0.2.0"
   },
   "scripts": {
     "build": "tsup",