@directive-run/core 1.0.0 → 1.1.0

package/dist/testing.d.cts

@@ -1,15 +1,4 @@
-import { k as ModulesMap, l as CreateSystemOptionsNamed, o as Requirement, M as ModuleSchema, i as CreateSystemOptionsSingle, N as NamespacedSystem, R as RequirementWithId, j as SingleModuleSystem, _ as SystemInspection } from './plugins-O-3VHejK.cjs';
-
-/**
- * Testing Utilities - Helpers for testing Directive systems
- *
- * Features:
- * - Mock resolvers with manual resolve/reject
- * - Fake timers integration (works with Vitest/Jest fake timers)
- * - Assertion helpers
- * - Facts history tracking
- * - Pending requirements tracking
- */
+import { k as ModulesMap, l as CreateSystemOptionsNamed, o as Requirement, M as ModuleSchema, i as CreateSystemOptionsSingle, N as NamespacedSystem, R as RequirementWithId, j as SingleModuleSystem, V as ObservationEvent, $ as SystemInspection } from './plugins-day_qfBB.cjs';
 
 /**
  * Flush all pending microtasks by awaiting multiple rounds of `Promise.resolve()`.
@@ -447,5 +436,80 @@ declare function assertNotDynamic(system: {
         isDynamic(id: string): boolean;
     };
 }, type: "constraint" | "resolver" | "derivation" | "effect", id: string): void;
+/** Coverage report for a Directive system. */
+interface CoverageReport {
+    /** Constraints that evaluated to true at least once. */
+    constraintsHit: Set<string>;
+    /** Constraints that never evaluated to true. */
+    constraintsMissed: Set<string>;
+    /** Resolvers that started at least once. */
+    resolversRun: Set<string>;
+    /** Resolvers that never started. */
+    resolversMissed: Set<string>;
+    /** Effects that ran at least once. */
+    effectsRun: Set<string>;
+    /** Derivations that recomputed at least once. */
+    derivationsComputed: Set<string>;
+    /** Coverage percentage (constraintsHit / total constraints). */
+    constraintCoverage: number;
+    /** Coverage percentage (resolversRun / total resolvers). */
+    resolverCoverage: number;
+}
+/**
+ * Track which constraints, resolvers, effects, and derivations are exercised
+ * during a test scenario. Returns a coverage report after the scenario runs.
+ *
+ * @example
+ * ```typescript
+ * const { run, report } = createCoverageTracker(system);
+ *
+ * await run(async () => {
+ *   system.facts.userId = 123;
+ *   await system.settle();
+ *   system.facts.userId = 0;
+ *   await system.settle();
+ * });
+ *
+ * const coverage = report();
+ * expect(coverage.constraintCoverage).toBe(1); // All constraints hit
+ * expect(coverage.constraintsMissed.size).toBe(0);
+ * ```
+ */
+declare function createCoverageTracker(system: SingleModuleSystem<any> | NamespacedSystem<any>): {
+    /** Run a test scenario while tracking coverage. */
+    run: (scenario: () => Promise<void> | void) => Promise<void>;
+    /** Get the coverage report. */
+    report: () => CoverageReport;
+};
+/**
+ * Create a test observer that collects all observation events.
+ * Useful for assertion-based testing of system behavior.
+ *
+ * @example
+ * ```typescript
+ * const observer = createTestObserver(system);
+ *
+ * system.facts.count = 5;
+ * await system.settle();
+ *
+ * expect(observer.events.filter(e => e.type === "constraint.evaluate")).toHaveLength(1);
+ * expect(observer.ofType("resolver.complete")).toHaveLength(1);
+ *
+ * observer.clear();
+ * observer.dispose();
+ * ```
+ */
+declare function createTestObserver(system: SingleModuleSystem<any> | NamespacedSystem<any>): {
+    /** All collected events. */
+    events: ObservationEvent[];
+    /** Filter events by type. */
+    ofType: <T extends ObservationEvent["type"]>(type: T) => Extract<ObservationEvent, {
+        type: T;
+    }>[];
+    /** Clear collected events. */
+    clear: () => void;
+    /** Stop observing. */
+    dispose: () => void;
+};
 
-export { type CreateTestSystemOptions, type CreateTestSystemOptionsSingle, type FactChangeRecord, type FakeTimers, type MockResolver, type MockResolverContext, type MockResolverOptions, type TestSystem, type TestSystemBase, type TestSystemSingle, assertDynamic, assertNotDynamic, createFakeTimers, createMockResolver, createTestSystem, flushMicrotasks, mockResolver, settleWithFakeTimers };
+export { type CoverageReport, type CreateTestSystemOptions, type CreateTestSystemOptionsSingle, type FactChangeRecord, type FakeTimers, type MockResolver, type MockResolverContext, type MockResolverOptions, type TestSystem, type TestSystemBase, type TestSystemSingle, assertDynamic, assertNotDynamic, createCoverageTracker, createFakeTimers, createMockResolver, createTestObserver, createTestSystem, flushMicrotasks, mockResolver, settleWithFakeTimers };

package/dist/testing.d.ts

@@ -1,15 +1,4 @@
-import { k as ModulesMap, l as CreateSystemOptionsNamed, o as Requirement, M as ModuleSchema, i as CreateSystemOptionsSingle, N as NamespacedSystem, R as RequirementWithId, j as SingleModuleSystem, _ as SystemInspection } from './plugins-O-3VHejK.js';
-
-/**
- * Testing Utilities - Helpers for testing Directive systems
- *
- * Features:
- * - Mock resolvers with manual resolve/reject
- * - Fake timers integration (works with Vitest/Jest fake timers)
- * - Assertion helpers
- * - Facts history tracking
- * - Pending requirements tracking
- */
+import { k as ModulesMap, l as CreateSystemOptionsNamed, o as Requirement, M as ModuleSchema, i as CreateSystemOptionsSingle, N as NamespacedSystem, R as RequirementWithId, j as SingleModuleSystem, V as ObservationEvent, $ as SystemInspection } from './plugins-day_qfBB.js';
 
 /**
  * Flush all pending microtasks by awaiting multiple rounds of `Promise.resolve()`.
@@ -447,5 +436,80 @@ declare function assertNotDynamic(system: {
         isDynamic(id: string): boolean;
     };
 }, type: "constraint" | "resolver" | "derivation" | "effect", id: string): void;
+/** Coverage report for a Directive system. */
+interface CoverageReport {
+    /** Constraints that evaluated to true at least once. */
+    constraintsHit: Set<string>;
+    /** Constraints that never evaluated to true. */
+    constraintsMissed: Set<string>;
+    /** Resolvers that started at least once. */
+    resolversRun: Set<string>;
+    /** Resolvers that never started. */
+    resolversMissed: Set<string>;
+    /** Effects that ran at least once. */
+    effectsRun: Set<string>;
+    /** Derivations that recomputed at least once. */
+    derivationsComputed: Set<string>;
+    /** Coverage percentage (constraintsHit / total constraints). */
+    constraintCoverage: number;
+    /** Coverage percentage (resolversRun / total resolvers). */
+    resolverCoverage: number;
+}
+/**
+ * Track which constraints, resolvers, effects, and derivations are exercised
+ * during a test scenario. Returns a coverage report after the scenario runs.
+ *
+ * @example
+ * ```typescript
+ * const { run, report } = createCoverageTracker(system);
+ *
+ * await run(async () => {
+ *   system.facts.userId = 123;
+ *   await system.settle();
+ *   system.facts.userId = 0;
+ *   await system.settle();
+ * });
+ *
+ * const coverage = report();
+ * expect(coverage.constraintCoverage).toBe(1); // All constraints hit
+ * expect(coverage.constraintsMissed.size).toBe(0);
+ * ```
+ */
+declare function createCoverageTracker(system: SingleModuleSystem<any> | NamespacedSystem<any>): {
+    /** Run a test scenario while tracking coverage. */
+    run: (scenario: () => Promise<void> | void) => Promise<void>;
+    /** Get the coverage report. */
+    report: () => CoverageReport;
+};
+/**
+ * Create a test observer that collects all observation events.
+ * Useful for assertion-based testing of system behavior.
+ *
+ * @example
+ * ```typescript
+ * const observer = createTestObserver(system);
+ *
+ * system.facts.count = 5;
+ * await system.settle();
+ *
+ * expect(observer.events.filter(e => e.type === "constraint.evaluate")).toHaveLength(1);
+ * expect(observer.ofType("resolver.complete")).toHaveLength(1);
+ *
+ * observer.clear();
+ * observer.dispose();
+ * ```
+ */
+declare function createTestObserver(system: SingleModuleSystem<any> | NamespacedSystem<any>): {
+    /** All collected events. */
+    events: ObservationEvent[];
+    /** Filter events by type. */
+    ofType: <T extends ObservationEvent["type"]>(type: T) => Extract<ObservationEvent, {
+        type: T;
+    }>[];
+    /** Clear collected events. */
+    clear: () => void;
+    /** Stop observing. */
+    dispose: () => void;
+};
 
-export { type CreateTestSystemOptions, type CreateTestSystemOptionsSingle, type FactChangeRecord, type FakeTimers, type MockResolver, type MockResolverContext, type MockResolverOptions, type TestSystem, type TestSystemBase, type TestSystemSingle, assertDynamic, assertNotDynamic, createFakeTimers, createMockResolver, createTestSystem, flushMicrotasks, mockResolver, settleWithFakeTimers };
+export { type CoverageReport, type CreateTestSystemOptions, type CreateTestSystemOptionsSingle, type FactChangeRecord, type FakeTimers, type MockResolver, type MockResolverContext, type MockResolverOptions, type TestSystem, type TestSystemBase, type TestSystemSingle, assertDynamic, assertNotDynamic, createCoverageTracker, createFakeTimers, createMockResolver, createTestObserver, createTestSystem, flushMicrotasks, mockResolver, settleWithFakeTimers };

package/dist/testing.js

@@ -1,2 +1,2 @@
-import {a}from'./chunk-MPOV2REO.js';import'./chunk-YWKFNZQV.js';import'./chunk-EFBBEXDA.js';import'./chunk-4CMO5OVZ.js';async function S(){for(let t=0;t<10;t++)await Promise.resolve();}async function D(t,r,n={}){let{totalTime:a=5e3,stepSize:c=10,maxIterations:l=1e3}=n,d=0,h=0;for(;d<a&&h<l;){if(await S(),t.inspect().inflight.length===0){await S();return}r(c),d+=c,h++;}let g=t.inspect();if(g.inflight.length>0){let v=g.inflight.map(y=>y.resolverId).join(", ");throw new Error(`[Directive] settleWithFakeTimers did not settle after ${a}ms. ${g.inflight.length} resolvers still inflight: ${v}`)}}function T(){let t=0,r=[];return {async advance(n){let a=t+n;for(;r.length>0&&r[0].time<=a;){let c=r.shift();t=c.time,c.callback(),await Promise.resolve();}t=a;},async next(){if(r.length===0)return;let n=r.shift();t=n.time,n.callback(),await Promise.resolve();},async runAll(){for(;r.length>0;)await this.next();},now(){return t},reset(){t=0,r.length=0;}}}function k(t){let r=typeof t=="string"?{requirement:(a=>a.type===t)}:t,n=r.calls??[];return {requirement:r.requirement??(a=>true),async resolve(a,c){if(n.push(a),r.delay&&await new Promise(l=>setTimeout(l,r.delay)),r.error)throw typeof r.error=="string"?new Error(r.error):r.error;r.resolve&&await r.resolve(a,c);}}}function E(t){let r=[],n=[];return {...{get calls(){return r},get pending(){return n},resolve(l){let d=n.shift();d&&d.resolve(l);},reject(l){let d=n.shift();d&&d.reject(l);},resolveAll(l){for(;n.length>0;)this.resolve(l);},rejectAll(l){for(;n.length>0;)this.reject(l);},reset(){r.length=0,n.length=0;}},handler:(l,d)=>(r.push(l),new Promise((h,g)=>{n.push({requirement:l,resolve:v=>h(v),reject:g});}))}}function C(t){return "module"in t?x(t):M(t)}function x(t){let r=[],n=new Map,a$1=[],c=[],l={};if(t.mocks?.resolvers)for(let[o,e]of Object.entries(t.mocks.resolvers)){let s=[];n.set(o,s),l[o]=k({...e,calls:s});}let d={...t.module,resolvers:{...t.module.resolvers,...l}},g=a({...t,module:d,plugins:[{name:"__test-tracking__",onFactSet:(o,e,s)=>{c.push({key:o,fullKey:o,namespace:void 0,previousValue:s,newValue:e,timestamp:Date.now()});},onRequirementCreated:o=>{a$1.push(o);}},...t.plugins??[]]}),v=g.dispatch.bind(g);return g.dispatch=o=>{r.push(o),v(o);},{...g,eventHistory:r,resolverCalls:n,get allRequirements(){return a$1},getFactsHistory(){return [...c]},resetFactsHistory(){c.length=0;},async waitForIdle(o=5e3){let e=Date.now(),s=async()=>{await new Promise(m=>setTimeout(m,0));let i=g.inspect();if(i.inflight.length>0){if(Date.now()-e>o){let m=i.inflight.map(u=>u.id).join(", ");throw new Error(`[Directive] waitForIdle timed out after ${o}ms. ${i.inflight.length} resolvers still inflight: ${m}`)}return await new Promise(m=>setTimeout(m,10)),s()}};return s()},assertRequirement(o){if(!a$1.some(s=>s.requirement.type===o))throw new Error(`[Directive] Expected requirement of type "${o}" but none found`)},assertResolverCalled(o,e){let s=n.get(o)??[];if(e!==void 0){if(s.length!==e)throw new Error(`[Directive] Expected resolver "${o}" to be called ${e} times but was called ${s.length} times`)}else if(s.length===0)throw new Error(`[Directive] Expected resolver "${o}" to be called but it was not`)},assertFactSet(o,e){let s=c.filter(i=>i.key===o);if(s.length===0)throw new Error(`[Directive] Expected fact "${o}" to be set but it was not`);if(e!==void 0&&!s.some(m=>m.newValue===e)){let m=s.map(u=>JSON.stringify(u.newValue)).join(", ");throw new Error(`[Directive] Expected fact "${o}" to be set to ${JSON.stringify(e)} but got: ${m}`)}},assertFactChanges(o,e){let s=c.filter(i=>i.key===o);if(s.length!==e)throw new Error(`[Directive] Expected fact "${o}" to change ${e} times but it changed ${s.length} times`)}}}function M(t){let r=[],n=new Map,a$1=[],c=[],l={};if(t.mocks?.resolvers)for(let[e,s]of Object.entries(t.mocks.resolvers)){let i=[];n.set(e,i),l[e]=k({...s,calls:i});}let d={};for(let[e,s]of Object.entries(t.modules))d[e]={...s,resolvers:{...s.resolvers,...l}};let h=new Set(Object.keys(t.modules)),v=a({...t,modules:d,plugins:[{name:"__test-tracking__",onFactSet:(e,s,i)=>{let u=e.indexOf("::"),f,p;if(u>0){let R=e.substring(0,u);h.has(R)?(f=R,p=e.substring(u+2)):p=e;}else p=e;c.push({key:p,fullKey:e,namespace:f,previousValue:i,newValue:s,timestamp:Date.now()});},onRequirementCreated:e=>{a$1.push(e);}},...t.plugins??[]]}),y=v.dispatch.bind(v);return v.dispatch=e=>{r.push(e),y(e);},{...v,eventHistory:r,resolverCalls:n,get allRequirements(){return a$1},getFactsHistory(){return [...c]},resetFactsHistory(){c.length=0;},async waitForIdle(e=5e3){let s=Date.now(),i=async()=>{await new Promise(u=>setTimeout(u,0));let m=v.inspect();if(m.inflight.length>0){if(Date.now()-s>e){let u=m.inflight.map(f=>f.id).join(", ");throw new Error(`[Directive] waitForIdle timed out after ${e}ms. ${m.inflight.length} resolvers still inflight: ${u}`)}return await new Promise(u=>setTimeout(u,10)),i()}};return i()},assertRequirement(e){if(!a$1.some(i=>i.requirement.type===e))throw new Error(`[Directive] Expected requirement of type "${e}" but none found`)},assertResolverCalled(e,s){let i=n.get(e)??[];if(s!==void 0){if(i.length!==s)throw new Error(`[Directive] Expected resolver "${e}" to be called ${s} times but was called ${i.length} times`)}else if(i.length===0)throw new Error(`[Directive] Expected resolver "${e}" to be called but it was not`)},assertFactSet(e,s){let i=c.filter(m=>m.key===e);if(i.length===0)throw new Error(`[Directive] Expected fact "${e}" to be set but it was not`);if(s!==void 0&&!i.some(u=>u.newValue===s)){let u=i.map(f=>JSON.stringify(f.newValue)).join(", ");throw new Error(`[Directive] Expected fact "${e}" to be set to ${JSON.stringify(s)} but got: ${u}`)}},assertFactChanges(e,s){let i=c.filter(m=>m.key===e);if(i.length!==s)throw new Error(`[Directive] Expected fact "${e}" to change ${s} times but it changed ${i.length} times`)}}}function $(t,r,n){if(!b(t,r,n))throw new Error(`[Directive] Expected ${r} "${n}" to be dynamic, but it is not.`)}function P(t,r,n){if(b(t,r,n))throw new Error(`[Directive] Expected ${r} "${n}" to NOT be dynamic, but it is.`)}function b(t,r,n){switch(r){case "constraint":return t.constraints.isDynamic(n);case "resolver":return t.resolvers.isDynamic(n);case "derivation":return t.derive.isDynamic(n);case "effect":return t.effects.isDynamic(n)}}export{$ as assertDynamic,P as assertNotDynamic,T as createFakeTimers,k as createMockResolver,C as createTestSystem,S as flushMicrotasks,E as mockResolver,D as settleWithFakeTimers};//# sourceMappingURL=testing.js.map
+import {a}from'./chunk-DB5Z7EOG.js';import'./chunk-B2LVGKNZ.js';import'./chunk-GSXCAMNZ.js';import'./chunk-4CMO5OVZ.js';async function R(){for(let t=0;t<10;t++)await Promise.resolve();}async function T(t,s,r={}){let{totalTime:o=5e3,stepSize:c=10,maxIterations:l=1e3}=r,m=0,u=0;for(;m<o&&u<l;){if(await R(),t.inspect().inflight.length===0){await R();return}s(c),m+=c,u++;}let v=t.inspect();if(v.inflight.length>0){let f=v.inflight.map(p=>p.resolverId).join(", ");throw new Error(`[Directive] settleWithFakeTimers did not settle after ${o}ms. ${v.inflight.length} resolvers still inflight: ${f}`)}}function D(){let t=0,s=[];return {async advance(r){let o=t+r;for(;s.length>0&&s[0].time<=o;){let c=s.shift();t=c.time,c.callback(),await Promise.resolve();}t=o;},async next(){if(s.length===0)return;let r=s.shift();t=r.time,r.callback(),await Promise.resolve();},async runAll(){for(;s.length>0;)await this.next();},now(){return t},reset(){t=0,s.length=0;}}}function b(t){let s=typeof t=="string"?{requirement:(o=>o.type===t)}:t,r=s.calls??[];return {requirement:s.requirement??(o=>true),async resolve(o,c){if(r.push(o),s.delay&&await new Promise(l=>setTimeout(l,s.delay)),s.error)throw typeof s.error=="string"?new Error(s.error):s.error;s.resolve&&await s.resolve(o,c);}}}function C(t){let s=[],r=[];return {...{get calls(){return s},get pending(){return r},resolve(l){let m=r.shift();m&&m.resolve(l);},reject(l){let m=r.shift();m&&m.reject(l);},resolveAll(l){for(;r.length>0;)this.resolve(l);},rejectAll(l){for(;r.length>0;)this.reject(l);},reset(){s.length=0,r.length=0;}},handler:(l,m)=>(s.push(l),new Promise((u,v)=>{r.push({requirement:l,resolve:f=>u(f),reject:v});}))}}function E(t){return "module"in t?x(t):M(t)}function x(t){let s=[],r=new Map,o=[],c=[],l={};if(t.mocks?.resolvers)for(let[i,e]of Object.entries(t.mocks.resolvers)){let n=[];r.set(i,n),l[i]=b({...e,calls:n});}let m={...t.module,resolvers:{...t.module.resolvers,...l}},v=a({...t,module:m,plugins:[{name:"__test-tracking__",onFactSet:(i,e,n)=>{c.push({key:i,fullKey:i,namespace:void 0,previousValue:n,newValue:e,timestamp:Date.now()});},onRequirementCreated:i=>{o.push(i);}},...t.plugins??[]]}),f=v.dispatch.bind(v);return v.dispatch=i=>{s.push(i),f(i);},{...v,eventHistory:s,resolverCalls:r,get allRequirements(){return o},getFactsHistory(){return [...c]},resetFactsHistory(){c.length=0;},async waitForIdle(i=5e3){let e=Date.now(),n=async()=>{await new Promise(d=>setTimeout(d,0));let a=v.inspect();if(a.inflight.length>0){if(Date.now()-e>i){let d=a.inflight.map(g=>g.id).join(", ");throw new Error(`[Directive] waitForIdle timed out after ${i}ms. ${a.inflight.length} resolvers still inflight: ${d}`)}return await new Promise(d=>setTimeout(d,10)),n()}};return n()},assertRequirement(i){if(!o.some(n=>n.requirement.type===i))throw new Error(`[Directive] Expected requirement of type "${i}" but none found`)},assertResolverCalled(i,e){let n=r.get(i)??[];if(e!==void 0){if(n.length!==e)throw new Error(`[Directive] Expected resolver "${i}" to be called ${e} times but was called ${n.length} times`)}else if(n.length===0)throw new Error(`[Directive] Expected resolver "${i}" to be called but it was not`)},assertFactSet(i,e){let n=c.filter(a=>a.key===i);if(n.length===0)throw new Error(`[Directive] Expected fact "${i}" to be set but it was not`);if(e!==void 0&&!n.some(d=>d.newValue===e)){let d=n.map(g=>JSON.stringify(g.newValue)).join(", ");throw new Error(`[Directive] Expected fact "${i}" to be set to ${JSON.stringify(e)} but got: ${d}`)}},assertFactChanges(i,e){let n=c.filter(a=>a.key===i);if(n.length!==e)throw new Error(`[Directive] Expected fact "${i}" to change ${e} times but it changed ${n.length} times`)}}}function M(t){let s=[],r=new Map,o=[],c=[],l={};if(t.mocks?.resolvers)for(let[e,n]of Object.entries(t.mocks.resolvers)){let a=[];r.set(e,a),l[e]=b({...n,calls:a});}let m={};for(let[e,n]of Object.entries(t.modules))m[e]={...n,resolvers:{...n.resolvers,...l}};let u=new Set(Object.keys(t.modules)),f=a({...t,modules:m,plugins:[{name:"__test-tracking__",onFactSet:(e,n,a)=>{let g=e.indexOf("::"),y,h;if(g>0){let w=e.substring(0,g);u.has(w)?(y=w,h=e.substring(g+2)):h=e;}else h=e;c.push({key:h,fullKey:e,namespace:y,previousValue:a,newValue:n,timestamp:Date.now()});},onRequirementCreated:e=>{o.push(e);}},...t.plugins??[]]}),p=f.dispatch.bind(f);return f.dispatch=e=>{s.push(e),p(e);},{...f,eventHistory:s,resolverCalls:r,get allRequirements(){return o},getFactsHistory(){return [...c]},resetFactsHistory(){c.length=0;},async waitForIdle(e=5e3){let n=Date.now(),a=async()=>{await new Promise(g=>setTimeout(g,0));let d=f.inspect();if(d.inflight.length>0){if(Date.now()-n>e){let g=d.inflight.map(y=>y.id).join(", ");throw new Error(`[Directive] waitForIdle timed out after ${e}ms. ${d.inflight.length} resolvers still inflight: ${g}`)}return await new Promise(g=>setTimeout(g,10)),a()}};return a()},assertRequirement(e){if(!o.some(a=>a.requirement.type===e))throw new Error(`[Directive] Expected requirement of type "${e}" but none found`)},assertResolverCalled(e,n){let a=r.get(e)??[];if(n!==void 0){if(a.length!==n)throw new Error(`[Directive] Expected resolver "${e}" to be called ${n} times but was called ${a.length} times`)}else if(a.length===0)throw new Error(`[Directive] Expected resolver "${e}" to be called but it was not`)},assertFactSet(e,n){let a=c.filter(d=>d.key===e);if(a.length===0)throw new Error(`[Directive] Expected fact "${e}" to be set but it was not`);if(n!==void 0&&!a.some(g=>g.newValue===n)){let g=a.map(y=>JSON.stringify(y.newValue)).join(", ");throw new Error(`[Directive] Expected fact "${e}" to be set to ${JSON.stringify(n)} but got: ${g}`)}},assertFactChanges(e,n){let a=c.filter(d=>d.key===e);if(a.length!==n)throw new Error(`[Directive] Expected fact "${e}" to change ${n} times but it changed ${a.length} times`)}}}function O(t,s,r){if(!k(t,s,r))throw new Error(`[Directive] Expected ${s} "${r}" to be dynamic, but it is not.`)}function $(t,s,r){if(k(t,s,r))throw new Error(`[Directive] Expected ${s} "${r}" to NOT be dynamic, but it is.`)}function k(t,s,r){switch(s){case "constraint":return t.constraints.isDynamic(r);case "resolver":return t.resolvers.isDynamic(r);case "derivation":return t.derive.isDynamic(r);case "effect":return t.effects.isDynamic(r)}}function P(t){let s=new Set,r=new Set,o=new Set,c=new Set,l=null;return {async run(m){l=t.observe(u=>{switch(u.type){case "constraint.evaluate":u.active&&s.add(u.id);break;case "resolver.start":r.add(u.resolver);break;case "effect.run":o.add(u.id);break;case "derivation.compute":c.add(u.id);break}});try{await m();}finally{l?.(),l=null;}},report(){let m=t.inspect(),u=new Set(m.constraints.map(i=>i.id)),v=new Set(m.resolverDefs.map(i=>i.id)),f=new Set;for(let i of u)s.has(i)||f.add(i);let p=new Set;for(let i of v)r.has(i)||p.add(i);return {constraintsHit:s,constraintsMissed:f,resolversRun:r,resolversMissed:p,effectsRun:o,derivationsComputed:c,constraintCoverage:u.size===0?1:s.size/u.size,resolverCoverage:v.size===0?1:r.size/v.size}}}}function F(t){let s=[],r=t.observe(o=>s.push(o));return {events:s,ofType(o){return s.filter(c=>c.type===o)},clear(){s.length=0;},dispose(){r();}}}export{O as assertDynamic,$ as assertNotDynamic,P as createCoverageTracker,D as createFakeTimers,b as createMockResolver,F as createTestObserver,E as createTestSystem,R as flushMicrotasks,C as mockResolver,T as settleWithFakeTimers};//# sourceMappingURL=testing.js.map
 //# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/testing.ts"],"names":["flushMicrotasks","i","settleWithFakeTimers","system","advanceTime","options","totalTime","stepSize","maxIterations","elapsed","iterations","finalInspection","resolverIds","r","createFakeTimers","currentTime","timers","ms","targetTime","timer","createMockResolver","typeOrOptions","req","calls","_req","ctx","resolve","mockResolver","_requirementType","pending","result","item","error","_ctx","reject","val","createTestSystem","createTestSystemSingle","createTestSystemNamed","eventHistory","resolverCalls","allRequirements","factsHistory","mockResolvers","type","mockOptions","moduleWithMocks","createSystem","fullKey","value","previousValue","requirement","originalDispatch","event","maxWait","startTime","checkIdle","inspection","times","key","changes","c","actualValues","modulesWithMocks","name","module","moduleNamespaces","sepIndex","namespace","possibleNamespace","assertDynamic","id","getDynamicCheck","assertNotDynamic"],"mappings":"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","file":"testing.js","sourcesContent":["/**\n * Testing Utilities - Helpers for testing Directive systems\n *\n * Features:\n * - Mock resolvers with manual resolve/reject\n * - Fake timers integration (works with Vitest/Jest fake timers)\n * - Assertion helpers\n * - Facts history tracking\n * - Pending requirements tracking\n */\n\nimport { createSystem } from \"../core/system.js\";\nimport type {\n  CreateSystemOptionsNamed,\n  CreateSystemOptionsSingle,\n  ModuleDef,\n  ModuleSchema,\n  ModulesMap,\n  NamespacedSystem,\n  Requirement,\n  RequirementWithId,\n  SingleModuleSystem,\n  SystemInspection,\n} from \"../core/types.js\";\n\n// ============================================================================\n// Fake Timers Integration\n// ============================================================================\n\n/**\n * Flush all pending microtasks by awaiting multiple rounds of `Promise.resolve()`.\n *\n * Call this after advancing fake timers to ensure all Promise callbacks\n * (including nested microtasks) have run before making assertions.\n *\n * @returns A promise that resolves after all pending microtasks have been drained.\n *\n * @example\n * ```typescript\n * vi.useFakeTimers();\n * system.start();\n * system.facts.userId = 1; // Triggers constraint\n * await flushMicrotasks(); // Let reconciliation start\n * vi.advanceTimersByTime(100); // Advance resolver delay\n * await flushMicrotasks(); // Let resolver complete\n * ```\n *\n * @public\n */\nexport async function flushMicrotasks(): Promise<void> {\n  // Multiple rounds to catch nested microtasks\n  for (let i = 0; i < 10; i++) {\n    await Promise.resolve();\n  }\n}\n\n/**\n * Wait for the system to settle with fake timers enabled.\n *\n * Repeatedly advances fake timers in discrete steps while flushing microtasks,\n * until no resolvers remain inflight or the time budget is exhausted.\n *\n * @param system - The Directive system to wait on (must expose {@link SystemInspection} via `inspect()`).\n * @param advanceTime - Function that advances fake timers by a given number of milliseconds (e.g., `vi.advanceTimersByTime`).\n * @param options - Configuration for total time budget, step size, and iteration limit.\n * @returns A promise that resolves once the system is idle.\n *\n * @throws Error if the system does not settle within the configured time budget.\n *\n * @example\n * ```typescript\n * vi.useFakeTimers();\n * const system = createSystem({ modules: [myModule] });\n * system.start();\n * system.dispatch({ type: \"triggerAsync\" });\n *\n * await settleWithFakeTimers(system, vi.advanceTimersByTime, {\n *   totalTime: 1000,\n *   stepSize: 10,\n * });\n *\n * expect(system.facts.result).toBe(\"done\");\n * ```\n *\n * @public\n */\nexport async function settleWithFakeTimers(\n  system: { inspect(): SystemInspection },\n  advanceTime: (ms: number) => void,\n  options: {\n    /** Total time to advance (default: 5000ms) */\n    totalTime?: number;\n    /** Time to advance each step (default: 10ms) */\n    stepSize?: number;\n    /** Maximum iterations before giving up (default: 1000) */\n    maxIterations?: number;\n  } = {},\n): Promise<void> {\n  const { totalTime = 5000, stepSize = 10, maxIterations = 1000 } = options;\n\n  let elapsed = 0;\n  let iterations = 0;\n\n  while (elapsed < totalTime && iterations < maxIterations) {\n    // Flush microtasks first (handles queueMicrotask, Promise.resolve)\n    await flushMicrotasks();\n\n    // Check if settled\n    const inspection = system.inspect();\n    if (inspection.inflight.length === 0) {\n      // One more flush to be safe\n      await flushMicrotasks();\n      return;\n    }\n\n    // Advance fake timers\n    advanceTime(stepSize);\n    elapsed += stepSize;\n    iterations++;\n  }\n\n  // Final check\n  const finalInspection = system.inspect();\n  if (finalInspection.inflight.length > 0) {\n    const resolverIds = finalInspection.inflight\n      .map((r) => r.resolverId)\n      .join(\", \");\n    throw new Error(\n      `[Directive] settleWithFakeTimers did not settle after ${totalTime}ms. ${finalInspection.inflight.length} resolvers still inflight: ${resolverIds}`,\n    );\n  }\n}\n\n// ============================================================================\n// Fake Timers (for standalone use without vi.useFakeTimers)\n// ============================================================================\n\n/**\n * Standalone fake timer controller for tests that do not use Vitest/Jest fake timers.\n *\n * @remarks\n * For most tests, prefer Vitest's `vi.useFakeTimers()` paired with\n * {@link settleWithFakeTimers} for better integration. Use this interface\n * only when you need a lightweight, framework-independent timer mock.\n *\n * @public\n */\nexport interface FakeTimers {\n  /** Advance time by a number of milliseconds, firing any timers that fall within the window. */\n  advance(ms: number): Promise<void>;\n  /** Advance to the next scheduled timer and fire its callback. */\n  next(): Promise<void>;\n  /** Run all pending timers in chronological order. */\n  runAll(): Promise<void>;\n  /** Get the current fake time in milliseconds. */\n  now(): number;\n  /** Reset the clock to time 0 and discard all scheduled timers. */\n  reset(): void;\n}\n\n/**\n * Create standalone fake timers for testing without a framework timer mock.\n *\n * @remarks\n * For most tests, prefer Vitest's `vi.useFakeTimers()` paired with\n * {@link settleWithFakeTimers}. This factory is useful when you need an\n * isolated timer that does not interfere with global timer state.\n *\n * @returns A {@link FakeTimers} controller with `advance`, `next`, `runAll`, `now`, and `reset` methods.\n *\n * @example\n * ```typescript\n * const timers = createFakeTimers();\n * // schedule work, then:\n * await timers.advance(500);\n * expect(timers.now()).toBe(500);\n * ```\n *\n * @public\n */\nexport function createFakeTimers(): FakeTimers {\n  let currentTime = 0;\n  const timers: Array<{ time: number; callback: () => void }> = [];\n\n  return {\n    async advance(ms: number): Promise<void> {\n      const targetTime = currentTime + ms;\n\n      // Run all timers that would fire during this advance\n      while (timers.length > 0 && timers[0]!.time <= targetTime) {\n        const timer = timers.shift()!;\n        currentTime = timer.time;\n        timer.callback();\n        await Promise.resolve(); // Allow microtasks\n      }\n\n      currentTime = targetTime;\n    },\n\n    async next(): Promise<void> {\n      if (timers.length === 0) return;\n\n      const timer = timers.shift()!;\n      currentTime = timer.time;\n      timer.callback();\n      await Promise.resolve();\n    },\n\n    async runAll(): Promise<void> {\n      while (timers.length > 0) {\n        await this.next();\n      }\n    },\n\n    now(): number {\n      return currentTime;\n    },\n\n    reset(): void {\n      currentTime = 0;\n      timers.length = 0;\n    },\n  };\n}\n\n// ============================================================================\n// Mock Resolvers\n// ============================================================================\n\n/**\n * Context passed to mock resolver resolve functions.\n *\n * @public\n */\nexport interface MockResolverContext {\n  /** Facts object (use type assertion for specific facts) */\n  // biome-ignore lint/suspicious/noExplicitAny: Facts type varies by system\n  facts: any;\n  /** Abort signal for cancellation */\n  signal: AbortSignal;\n}\n\n/**\n * Configuration for a simple mock resolver created via {@link createMockResolver}.\n *\n * @typeParam R - The requirement type this resolver handles.\n *\n * @public\n */\nexport interface MockResolverOptions<R extends Requirement = Requirement> {\n  /** Predicate to check if this resolver handles a given requirement. */\n  requirement?: (req: Requirement) => req is R;\n  /** Mock implementation invoked when the resolver runs. */\n  resolve?: (req: R, ctx: MockResolverContext) => void | Promise<void>;\n  /** Artificial delay in milliseconds before the resolver completes. */\n  delay?: number;\n  /** Error (or message string) to throw, simulating a resolver failure. */\n  error?: Error | string;\n  /** Array that receives every requirement passed to this resolver. */\n  calls?: R[];\n}\n\n/** Internal resolver definition type for mock resolvers */\ninterface MockResolverDef {\n  requirement: (req: Requirement) => boolean;\n  resolve: (req: Requirement, ctx: MockResolverContext) => Promise<void>;\n}\n\n/**\n * Create a simple mock resolver that matches requirements by type and optionally\n * records calls, injects delays, or throws errors.\n *\n * @param typeOrOptions - A requirement type string, or a full {@link MockResolverOptions} object.\n * @returns A resolver definition that can be spread into a module's `resolvers` map.\n *\n * @example\n * ```typescript\n * const calls: Requirement[] = [];\n * const mock = createMockResolver({ requirement: (r): r is MyReq => r.type === \"LOAD\", calls });\n * ```\n *\n * @public\n */\nexport function createMockResolver<R extends Requirement = Requirement>(\n  typeOrOptions: string | MockResolverOptions<R>,\n): MockResolverDef {\n  const options: MockResolverOptions<R> =\n    typeof typeOrOptions === \"string\"\n      ? {\n          requirement: ((req: Requirement) => req.type === typeOrOptions) as (\n            req: Requirement,\n          ) => req is R,\n        }\n      : typeOrOptions;\n\n  const calls: R[] = options.calls ?? [];\n\n  return {\n    requirement:\n      options.requirement ?? ((_req: Requirement): _req is R => true),\n    async resolve(req: Requirement, ctx: MockResolverContext): Promise<void> {\n      calls.push(req as R);\n\n      if (options.delay) {\n        await new Promise((resolve) => setTimeout(resolve, options.delay));\n      }\n\n      if (options.error) {\n        throw typeof options.error === \"string\"\n          ? new Error(options.error)\n          : options.error;\n      }\n\n      if (options.resolve) {\n        await options.resolve(req as R, ctx);\n      }\n    },\n  };\n}\n\n// ============================================================================\n// Mock Resolver (Advanced)\n// ============================================================================\n\n/**\n * A mock resolver that captures requirements for manual resolution.\n *\n * @remarks\n * Use this when you need fine-grained control over when and how requirements\n * resolve. Requirements are queued in `pending` and stay unresolved until you\n * explicitly call `resolve()` or `reject()`.\n *\n * @typeParam R - The requirement type this resolver handles.\n *\n * @public\n */\nexport interface MockResolver<R extends Requirement = Requirement> {\n  /** All requirements received by this resolver */\n  readonly calls: R[];\n  /** Pending requirements waiting to be resolved/rejected */\n  readonly pending: Array<{\n    requirement: R;\n    resolve: (result?: unknown) => void;\n    reject: (error: Error) => void;\n  }>;\n  /** Resolve the next pending requirement */\n  resolve(result?: unknown): void;\n  /** Reject the next pending requirement */\n  reject(error: Error): void;\n  /** Resolve all pending requirements */\n  resolveAll(result?: unknown): void;\n  /** Reject all pending requirements */\n  rejectAll(error: Error): void;\n  /** Clear call history and pending queue */\n  reset(): void;\n}\n\n/**\n * Create a mock resolver that captures requirements instead of resolving them,\n * giving you manual control over when and how each requirement completes.\n *\n * @param _requirementType - The requirement `type` string this mock handles (used for documentation; matching is done by the test harness).\n * @returns A {@link MockResolver} with a `handler` function suitable for passing to {@link createTestSystem} mocks.\n *\n * @example\n * ```typescript\n * const fetchMock = mockResolver<{ type: \"FETCH_USER\"; id: string }>(\"FETCH_USER\");\n *\n * const system = createTestSystem({\n *   modules: [userModule],\n *   mocks: {\n *     resolvers: {\n *       FETCH_USER: { resolve: fetchMock.handler },\n *     },\n *   },\n * });\n *\n * system.facts.userId = \"123\";\n * await flushMicrotasks();\n *\n * // Requirement is pending\n * expect(fetchMock.calls).toHaveLength(1);\n * expect(fetchMock.calls[0].id).toBe(\"123\");\n *\n * // Manually resolve it\n * fetchMock.resolve({ name: \"John\" });\n * await flushMicrotasks();\n *\n * expect(system.facts.user).toEqual({ name: \"John\" });\n * ```\n *\n * @public\n */\nexport function mockResolver<R extends Requirement = Requirement>(\n  _requirementType: string,\n): MockResolver<R> & {\n  /** Handler that can be passed to createTestSystem mocks */\n  handler: (req: Requirement, ctx: MockResolverContext) => Promise<void>;\n} {\n  const calls: R[] = [];\n  const pending: Array<{\n    requirement: R;\n    resolve: (result?: unknown) => void;\n    reject: (error: Error) => void;\n  }> = [];\n\n  const mock: MockResolver<R> = {\n    get calls() {\n      return calls;\n    },\n    get pending() {\n      return pending;\n    },\n    resolve(result?: unknown) {\n      const item = pending.shift();\n      if (item) {\n        item.resolve(result);\n      }\n    },\n    reject(error: Error) {\n      const item = pending.shift();\n      if (item) {\n        item.reject(error);\n      }\n    },\n    resolveAll(result?: unknown) {\n      while (pending.length > 0) {\n        this.resolve(result);\n      }\n    },\n    rejectAll(error: Error) {\n      while (pending.length > 0) {\n        this.reject(error);\n      }\n    },\n    reset() {\n      calls.length = 0;\n      pending.length = 0;\n    },\n  };\n\n  const handler = (\n    req: Requirement,\n    _ctx: MockResolverContext,\n  ): Promise<void> => {\n    calls.push(req as R);\n    return new Promise<void>((resolve, reject) => {\n      pending.push({\n        requirement: req as R,\n        resolve: (val?: unknown) => resolve(val as void),\n        reject,\n      });\n    });\n  };\n\n  return {\n    ...mock,\n    handler,\n  };\n}\n\n// ============================================================================\n// Fact Change Tracking\n// ============================================================================\n\n/**\n * Record of a single fact change captured by the test tracking plugin.\n *\n * @public\n */\nexport interface FactChangeRecord {\n  /** The fact key that changed (without namespace prefix for namespaced systems) */\n  key: string;\n  /** The full key including namespace prefix (e.g., \"test::value\") */\n  fullKey: string;\n  /** The namespace (e.g., \"test\") - undefined for single-module systems */\n  namespace?: string;\n  /** The previous value */\n  previousValue: unknown;\n  /** The new value */\n  newValue: unknown;\n  /** Timestamp of the change */\n  timestamp: number;\n}\n\n// ============================================================================\n// Test System\n// ============================================================================\n\n/** Common testing utilities shared by both single-module and namespaced test systems. */\nexport interface TestSystemBase {\n  /**\n   * Wait for all pending operations to complete.\n   * @param maxWait - Maximum time to wait in ms (default: 5000)\n   * @throws Error if timeout is exceeded with resolvers still inflight\n   */\n  waitForIdle(maxWait?: number): Promise<void>;\n  /** Get the history of dispatched events */\n  eventHistory: Array<{ type: string; [key: string]: unknown }>;\n  /** Get resolver call history */\n  resolverCalls: Map<string, Requirement[]>;\n  /**\n   * Get all requirements that have been generated (both resolved and pending).\n   * Unlike `inspect().unmet`, this includes requirements that have already been handled.\n   */\n  readonly allRequirements: RequirementWithId[];\n  /**\n   * Get all fact changes since system start or last reset.\n   */\n  getFactsHistory(): FactChangeRecord[];\n  /**\n   * Reset the facts history tracking.\n   */\n  resetFactsHistory(): void;\n  /** Assert that a requirement was created */\n  assertRequirement(type: string): void;\n  /** Assert that a resolver was called */\n  assertResolverCalled(type: string, times?: number): void;\n  /**\n   * Assert that a fact was set to a specific value.\n   */\n  assertFactSet(key: string, value?: unknown): void;\n  /**\n   * Assert the number of times a fact was changed.\n   */\n  assertFactChanges(key: string, times: number): void;\n}\n\n/**\n * A single-module Directive system augmented with testing utilities.\n *\n * @remarks\n * Extends {@link SingleModuleSystem} with event/resolver/fact tracking, idle\n * waiting, and assertion helpers. Created via {@link createTestSystem}.\n *\n * @typeParam S - The module schema.\n *\n * @public\n */\nexport interface TestSystemSingle<S extends ModuleSchema>\n  extends SingleModuleSystem<S>,\n    TestSystemBase {}\n\n/**\n * A Directive system augmented with testing utilities.\n *\n * @remarks\n * Extends {@link NamespacedSystem} with event/resolver/fact tracking, idle\n * waiting, and assertion helpers. Created via {@link createTestSystem}.\n *\n * @typeParam Modules - The modules map that defines the system's schema.\n *\n * @public\n */\nexport interface TestSystem<Modules extends ModulesMap>\n  extends NamespacedSystem<Modules>,\n    TestSystemBase {}\n\n/**\n * Options for {@link createTestSystem}, extending the standard system options\n * with mock resolver injection and automatic tracking.\n *\n * @typeParam Modules - The modules map that defines the system's schema.\n *\n * @public\n */\nexport interface CreateTestSystemOptions<Modules extends ModulesMap>\n  extends Omit<CreateSystemOptionsNamed<Modules>, \"plugins\"> {\n  /** Mock resolvers by type */\n  mocks?: {\n    resolvers?: Record<string, MockResolverOptions>;\n  };\n  /** Additional plugins (tracking plugin is added automatically) */\n  // biome-ignore lint/suspicious/noExplicitAny: Plugins are schema-agnostic\n  plugins?: any[];\n}\n\n/**\n * Options for {@link createTestSystem} with a single module (no namespacing).\n *\n * @typeParam S - The module schema.\n *\n * @public\n */\nexport interface CreateTestSystemOptionsSingle<S extends ModuleSchema>\n  extends Omit<CreateSystemOptionsSingle<S>, \"plugins\"> {\n  /** Mock resolvers by type */\n  mocks?: {\n    resolvers?: Record<string, MockResolverOptions>;\n  };\n  /** Additional plugins (tracking plugin is added automatically) */\n  // biome-ignore lint/suspicious/noExplicitAny: Plugins are schema-agnostic\n  plugins?: any[];\n}\n\n/**\n * Create a Directive system instrumented for testing.\n *\n * Wraps {@link createSystem} with an automatic tracking plugin that records\n * dispatched events, resolver calls, fact changes, and generated requirements.\n * Mock resolvers can be injected via `options.mocks.resolvers` to replace\n * real resolvers by requirement type.\n *\n * @param options - System configuration with optional mock resolvers and additional plugins.\n * @returns A {@link TestSystem} or {@link TestSystemSingle} with assertion helpers, idle waiting, and history tracking.\n *\n * @example\n * ```typescript\n * // Namespaced (multiple modules)\n * const system = createTestSystem({\n *   modules: { counter: counterModule },\n *   mocks: { resolvers: { INCREMENT: { resolve: (req, context) => { context.facts.count++; } } } },\n * });\n *\n * // Single module\n * const system = createTestSystem({\n *   module: counterModule,\n * });\n * system.start();\n * ```\n *\n * @public\n */\nexport function createTestSystem<S extends ModuleSchema>(\n  options: CreateTestSystemOptionsSingle<S>,\n): TestSystemSingle<S>;\nexport function createTestSystem<Modules extends ModulesMap>(\n  options: CreateTestSystemOptions<Modules>,\n): TestSystem<Modules>;\nexport function createTestSystem<\n  S extends ModuleSchema,\n  Modules extends ModulesMap,\n>(\n  options:\n    | CreateTestSystemOptionsSingle<S>\n    | CreateTestSystemOptions<Modules>,\n): TestSystemSingle<S> | TestSystem<Modules> {\n  // Single module mode: wrap into namespaced and delegate\n  if (\"module\" in options) {\n    return createTestSystemSingle(\n      options as CreateTestSystemOptionsSingle<S>,\n    );\n  }\n\n  return createTestSystemNamed(options as CreateTestSystemOptions<Modules>);\n}\n\nfunction createTestSystemSingle<S extends ModuleSchema>(\n  options: CreateTestSystemOptionsSingle<S>,\n): TestSystemSingle<S> {\n  const eventHistory: Array<{ type: string; [key: string]: unknown }> = [];\n  const resolverCalls = new Map<string, Requirement[]>();\n  const allRequirements: RequirementWithId[] = [];\n  const factsHistory: FactChangeRecord[] = [];\n\n  // Create mock resolvers\n  const mockResolvers: Record<string, MockResolverDef> = {};\n  if (options.mocks?.resolvers) {\n    for (const [type, mockOptions] of Object.entries(options.mocks.resolvers)) {\n      const calls: Requirement[] = [];\n      resolverCalls.set(type, calls);\n      mockResolvers[type] = createMockResolver({ ...mockOptions, calls });\n    }\n  }\n\n  // Create module with mock resolvers\n  // biome-ignore lint/suspicious/noExplicitAny: Mock resolvers have simplified types\n  const moduleWithMocks: ModuleDef<S> = {\n    ...options.module,\n    resolvers: {\n      ...options.module.resolvers,\n      ...mockResolvers,\n    } as any,\n  };\n\n  // Create tracking plugin\n  const trackingPlugin = {\n    name: \"__test-tracking__\",\n    onFactSet: (fullKey: string, value: unknown, previousValue: unknown) => {\n      factsHistory.push({\n        key: fullKey,\n        fullKey,\n        namespace: undefined,\n        previousValue,\n        newValue: value,\n        timestamp: Date.now(),\n      });\n    },\n    onRequirementCreated: (requirement: RequirementWithId) => {\n      allRequirements.push(requirement);\n    },\n  };\n\n  // Create the underlying single-module system\n  const system = createSystem({\n    ...options,\n    module: moduleWithMocks,\n    plugins: [trackingPlugin, ...(options.plugins ?? [])],\n  // biome-ignore lint/suspicious/noExplicitAny: Internal overload compatibility\n  } as any) as SingleModuleSystem<S>;\n\n  // Wrap dispatch to track events\n  const originalDispatch = system.dispatch.bind(system);\n  // biome-ignore lint/suspicious/noExplicitAny: Event type varies\n  (system as any).dispatch = (event: any) => {\n    eventHistory.push(event);\n    originalDispatch(event);\n  };\n\n  const testSystem: TestSystemSingle<S> = {\n    ...system,\n    eventHistory,\n    resolverCalls,\n\n    get allRequirements() {\n      return allRequirements;\n    },\n\n    getFactsHistory(): FactChangeRecord[] {\n      return [...factsHistory];\n    },\n\n    resetFactsHistory(): void {\n      factsHistory.length = 0;\n    },\n\n    async waitForIdle(maxWait = 5000): Promise<void> {\n      const startTime = Date.now();\n\n      const checkIdle = async (): Promise<void> => {\n        await new Promise((resolve) => setTimeout(resolve, 0));\n        const inspection = system.inspect();\n        if (inspection.inflight.length > 0) {\n          if (Date.now() - startTime > maxWait) {\n            const resolverIds = inspection.inflight\n              .map((r) => r.id)\n              .join(\", \");\n            throw new Error(\n              `[Directive] waitForIdle timed out after ${maxWait}ms. ${inspection.inflight.length} resolvers still inflight: ${resolverIds}`,\n            );\n          }\n          await new Promise((resolve) => setTimeout(resolve, 10));\n\n          return checkIdle();\n        }\n      };\n\n      return checkIdle();\n    },\n\n    assertRequirement(type: string): void {\n      const hasRequirement = allRequirements.some(\n        (r) => r.requirement.type === type,\n      );\n      if (!hasRequirement) {\n        throw new Error(\n          `[Directive] Expected requirement of type \"${type}\" but none found`,\n        );\n      }\n    },\n\n    assertResolverCalled(type: string, times?: number): void {\n      const calls = resolverCalls.get(type) ?? [];\n      if (times !== undefined) {\n        if (calls.length !== times) {\n          throw new Error(\n            `[Directive] Expected resolver \"${type}\" to be called ${times} times but was called ${calls.length} times`,\n          );\n        }\n      } else if (calls.length === 0) {\n        throw new Error(\n          `[Directive] Expected resolver \"${type}\" to be called but it was not`,\n        );\n      }\n    },\n\n    assertFactSet(key: string, value?: unknown): void {\n      const changes = factsHistory.filter((c) => c.key === key);\n      if (changes.length === 0) {\n        throw new Error(\n          `[Directive] Expected fact \"${key}\" to be set but it was not`,\n        );\n      }\n      if (value !== undefined) {\n        const hasValue = changes.some((c) => c.newValue === value);\n        if (!hasValue) {\n          const actualValues = changes\n            .map((c) => JSON.stringify(c.newValue))\n            .join(\", \");\n          throw new Error(\n            `[Directive] Expected fact \"${key}\" to be set to ${JSON.stringify(value)} but got: ${actualValues}`,\n          );\n        }\n      }\n    },\n\n    assertFactChanges(key: string, times: number): void {\n      const changes = factsHistory.filter((c) => c.key === key);\n      if (changes.length !== times) {\n        throw new Error(\n          `[Directive] Expected fact \"${key}\" to change ${times} times but it changed ${changes.length} times`,\n        );\n      }\n    },\n  };\n\n  return testSystem;\n}\n\nfunction createTestSystemNamed<Modules extends ModulesMap>(\n  options: CreateTestSystemOptions<Modules>,\n): TestSystem<Modules> {\n  const eventHistory: Array<{ type: string; [key: string]: unknown }> = [];\n  const resolverCalls = new Map<string, Requirement[]>();\n  const allRequirements: RequirementWithId[] = [];\n  const factsHistory: FactChangeRecord[] = [];\n\n  // Create mock resolvers\n  const mockResolvers: Record<string, MockResolverDef> = {};\n  if (options.mocks?.resolvers) {\n    for (const [type, mockOptions] of Object.entries(options.mocks.resolvers)) {\n      const calls: Requirement[] = [];\n      resolverCalls.set(type, calls);\n      mockResolvers[type] = createMockResolver({ ...mockOptions, calls });\n    }\n  }\n\n  // Create modules with mock resolvers\n  const modulesWithMocks: Modules = {} as Modules;\n  for (const [name, module] of Object.entries(options.modules)) {\n    // biome-ignore lint/suspicious/noExplicitAny: Module types are complex\n    (modulesWithMocks as any)[name] = {\n      ...module,\n      resolvers: {\n        ...module.resolvers,\n        ...mockResolvers,\n      },\n    };\n  }\n\n  // Get module namespaces for key parsing\n  const moduleNamespaces = new Set(Object.keys(options.modules));\n\n  // Create tracking plugin\n  const trackingPlugin = {\n    name: \"__test-tracking__\",\n    onFactSet: (fullKey: string, value: unknown, previousValue: unknown) => {\n      // Parse namespaced key (e.g., \"test::value\" -> namespace: \"test\", key: \"value\")\n      const SEPARATOR = \"::\";\n      const sepIndex = fullKey.indexOf(SEPARATOR);\n      let namespace: string | undefined;\n      let key: string;\n\n      if (sepIndex > 0) {\n        const possibleNamespace = fullKey.substring(0, sepIndex);\n        if (moduleNamespaces.has(possibleNamespace)) {\n          namespace = possibleNamespace;\n          key = fullKey.substring(sepIndex + SEPARATOR.length);\n        } else {\n          key = fullKey;\n        }\n      } else {\n        key = fullKey;\n      }\n\n      factsHistory.push({\n        key,\n        fullKey,\n        namespace,\n        previousValue,\n        newValue: value,\n        timestamp: Date.now(),\n      });\n    },\n    onRequirementCreated: (requirement: RequirementWithId) => {\n      allRequirements.push(requirement);\n    },\n  };\n\n  // Create the underlying system\n  const system = createSystem({\n    ...options,\n    modules: modulesWithMocks,\n    plugins: [trackingPlugin, ...(options.plugins ?? [])],\n  }) as NamespacedSystem<Modules>;\n\n  // Wrap dispatch to track events\n  const originalDispatch = system.dispatch.bind(system);\n  // biome-ignore lint/suspicious/noExplicitAny: Event type varies\n  (system as any).dispatch = (event: any) => {\n    eventHistory.push(event);\n    originalDispatch(event);\n  };\n\n  const testSystem: TestSystem<Modules> = {\n    ...system,\n    eventHistory,\n    resolverCalls,\n\n    get allRequirements() {\n      return allRequirements;\n    },\n\n    getFactsHistory(): FactChangeRecord[] {\n      return [...factsHistory];\n    },\n\n    resetFactsHistory(): void {\n      factsHistory.length = 0;\n    },\n\n    async waitForIdle(maxWait = 5000): Promise<void> {\n      const startTime = Date.now();\n\n      const checkIdle = async (): Promise<void> => {\n        // Wait for microtasks\n        await new Promise((resolve) => setTimeout(resolve, 0));\n\n        // Check if there are inflight resolvers\n        const inspection = system.inspect();\n        if (inspection.inflight.length > 0) {\n          // Check timeout\n          if (Date.now() - startTime > maxWait) {\n            const resolverIds = inspection.inflight.map((r) => r.id).join(\", \");\n            throw new Error(\n              `[Directive] waitForIdle timed out after ${maxWait}ms. ${inspection.inflight.length} resolvers still inflight: ${resolverIds}`,\n            );\n          }\n          // Wait a bit more and check again\n          await new Promise((resolve) => setTimeout(resolve, 10));\n          return checkIdle();\n        }\n      };\n\n      return checkIdle();\n    },\n\n    assertRequirement(type: string): void {\n      const hasRequirement = allRequirements.some(\n        (r) => r.requirement.type === type,\n      );\n      if (!hasRequirement) {\n        throw new Error(\n          `[Directive] Expected requirement of type \"${type}\" but none found`,\n        );\n      }\n    },\n\n    assertResolverCalled(type: string, times?: number): void {\n      const calls = resolverCalls.get(type) ?? [];\n      if (times !== undefined) {\n        if (calls.length !== times) {\n          throw new Error(\n            `[Directive] Expected resolver \"${type}\" to be called ${times} times but was called ${calls.length} times`,\n          );\n        }\n      } else if (calls.length === 0) {\n        throw new Error(\n          `[Directive] Expected resolver \"${type}\" to be called but it was not`,\n        );\n      }\n    },\n\n    assertFactSet(key: string, value?: unknown): void {\n      const changes = factsHistory.filter((c) => c.key === key);\n      if (changes.length === 0) {\n        throw new Error(\n          `[Directive] Expected fact \"${key}\" to be set but it was not`,\n        );\n      }\n      if (value !== undefined) {\n        const hasValue = changes.some((c) => c.newValue === value);\n        if (!hasValue) {\n          const actualValues = changes\n            .map((c) => JSON.stringify(c.newValue))\n            .join(\", \");\n          throw new Error(\n            `[Directive] Expected fact \"${key}\" to be set to ${JSON.stringify(value)} but got: ${actualValues}`,\n          );\n        }\n      }\n    },\n\n    assertFactChanges(key: string, times: number): void {\n      const changes = factsHistory.filter((c) => c.key === key);\n      if (changes.length !== times) {\n        throw new Error(\n          `[Directive] Expected fact \"${key}\" to change ${times} times but it changed ${changes.length} times`,\n        );\n      }\n    },\n  };\n\n  return testSystem;\n}\n\n// ============================================================================\n// Dynamic Definition Assertions\n// ============================================================================\n\n/**\n * Assert that a definition was dynamically registered on the system.\n *\n * @param system - The Directive system to check.\n * @param type - The definition type: \"constraint\", \"resolver\", \"derivation\", or \"effect\".\n * @param id - The definition ID.\n * @throws Error if the definition is not dynamic.\n *\n * @example\n * ```typescript\n * system.constraints.register(\"myRule\", { when: () => true, require: { type: \"DO\" } });\n * assertDynamic(system, \"constraint\", \"myRule\"); // passes\n * assertDynamic(system, \"constraint\", \"staticRule\"); // throws\n * ```\n *\n * @public\n */\nexport function assertDynamic(\n  system: {\n    constraints: { isDynamic(id: string): boolean };\n    effects: { isDynamic(id: string): boolean };\n    resolvers: { isDynamic(id: string): boolean };\n    derive: { isDynamic(id: string): boolean };\n  },\n  type: \"constraint\" | \"resolver\" | \"derivation\" | \"effect\",\n  id: string,\n): void {\n  const isDynamic = getDynamicCheck(system, type, id);\n  if (!isDynamic) {\n    throw new Error(\n      `[Directive] Expected ${type} \"${id}\" to be dynamic, but it is not.`,\n    );\n  }\n}\n\n/**\n * Assert that a definition is NOT dynamically registered (i.e., is static or does not exist).\n *\n * @param system - The Directive system to check.\n * @param type - The definition type: \"constraint\", \"resolver\", \"derivation\", or \"effect\".\n * @param id - The definition ID.\n * @throws Error if the definition is dynamic.\n *\n * @example\n * ```typescript\n * assertNotDynamic(system, \"constraint\", \"staticRule\"); // passes\n * system.constraints.register(\"myRule\", def);\n * assertNotDynamic(system, \"constraint\", \"myRule\"); // throws\n * ```\n *\n * @public\n */\nexport function assertNotDynamic(\n  system: {\n    constraints: { isDynamic(id: string): boolean };\n    effects: { isDynamic(id: string): boolean };\n    resolvers: { isDynamic(id: string): boolean };\n    derive: { isDynamic(id: string): boolean };\n  },\n  type: \"constraint\" | \"resolver\" | \"derivation\" | \"effect\",\n  id: string,\n): void {\n  const isDynamic = getDynamicCheck(system, type, id);\n  if (isDynamic) {\n    throw new Error(\n      `[Directive] Expected ${type} \"${id}\" to NOT be dynamic, but it is.`,\n    );\n  }\n}\n\n/** @internal */\nfunction getDynamicCheck(\n  system: {\n    constraints: { isDynamic(id: string): boolean };\n    effects: { isDynamic(id: string): boolean };\n    resolvers: { isDynamic(id: string): boolean };\n    derive: { isDynamic(id: string): boolean };\n  },\n  type: \"constraint\" | \"resolver\" | \"derivation\" | \"effect\",\n  id: string,\n): boolean {\n  switch (type) {\n    case \"constraint\":\n      return system.constraints.isDynamic(id);\n    case \"resolver\":\n      return system.resolvers.isDynamic(id);\n    case \"derivation\":\n      return system.derive.isDynamic(id);\n    case \"effect\":\n      return system.effects.isDynamic(id);\n  }\n}\n"]}
+{"version":3,"sources":["../src/utils/testing.ts"],"names":["flushMicrotasks","i","settleWithFakeTimers","system","advanceTime","options","totalTime","stepSize","maxIterations","elapsed","iterations","finalInspection","resolverIds","r","createFakeTimers","currentTime","timers","ms","targetTime","timer","createMockResolver","typeOrOptions","req","calls","_req","ctx","resolve","mockResolver","_requirementType","pending","result","item","error","_ctx","reject","val","createTestSystem","createTestSystemSingle","createTestSystemNamed","eventHistory","resolverCalls","allRequirements","factsHistory","mockResolvers","type","mockOptions","moduleWithMocks","createSystem","fullKey","value","previousValue","requirement","originalDispatch","event","maxWait","startTime","checkIdle","inspection","times","key","changes","c","actualValues","modulesWithMocks","name","module","moduleNamespaces","sepIndex","namespace","possibleNamespace","assertDynamic","id","getDynamicCheck","assertNotDynamic","createCoverageTracker","constraintsHit","resolversRun","effectsRun","derivationsComputed","unsub","scenario","allConstraints","allResolvers","constraintsMissed","resolversMissed","createTestObserver","events","e"],"mappings":"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","file":"testing.js","sourcesContent":["/**\n * Testing Utilities - Helpers for testing Directive systems\n *\n * Features:\n * - Mock resolvers with manual resolve/reject\n * - Fake timers integration (works with Vitest/Jest fake timers)\n * - Assertion helpers\n * - Facts history tracking\n * - Pending requirements tracking\n */\n\nimport { createSystem } from \"../core/system.js\";\nimport type {\n  CreateSystemOptionsNamed,\n  CreateSystemOptionsSingle,\n  ModuleDef,\n  ModuleSchema,\n  ModulesMap,\n  NamespacedSystem,\n  Requirement,\n  RequirementWithId,\n  SingleModuleSystem,\n  SystemInspection,\n} from \"../core/types.js\";\n\n// ============================================================================\n// Fake Timers Integration\n// ============================================================================\n\n/**\n * Flush all pending microtasks by awaiting multiple rounds of `Promise.resolve()`.\n *\n * Call this after advancing fake timers to ensure all Promise callbacks\n * (including nested microtasks) have run before making assertions.\n *\n * @returns A promise that resolves after all pending microtasks have been drained.\n *\n * @example\n * ```typescript\n * vi.useFakeTimers();\n * system.start();\n * system.facts.userId = 1; // Triggers constraint\n * await flushMicrotasks(); // Let reconciliation start\n * vi.advanceTimersByTime(100); // Advance resolver delay\n * await flushMicrotasks(); // Let resolver complete\n * ```\n *\n * @public\n */\nexport async function flushMicrotasks(): Promise<void> {\n  // Multiple rounds to catch nested microtasks\n  for (let i = 0; i < 10; i++) {\n    await Promise.resolve();\n  }\n}\n\n/**\n * Wait for the system to settle with fake timers enabled.\n *\n * Repeatedly advances fake timers in discrete steps while flushing microtasks,\n * until no resolvers remain inflight or the time budget is exhausted.\n *\n * @param system - The Directive system to wait on (must expose {@link SystemInspection} via `inspect()`).\n * @param advanceTime - Function that advances fake timers by a given number of milliseconds (e.g., `vi.advanceTimersByTime`).\n * @param options - Configuration for total time budget, step size, and iteration limit.\n * @returns A promise that resolves once the system is idle.\n *\n * @throws Error if the system does not settle within the configured time budget.\n *\n * @example\n * ```typescript\n * vi.useFakeTimers();\n * const system = createSystem({ modules: [myModule] });\n * system.start();\n * system.dispatch({ type: \"triggerAsync\" });\n *\n * await settleWithFakeTimers(system, vi.advanceTimersByTime, {\n *   totalTime: 1000,\n *   stepSize: 10,\n * });\n *\n * expect(system.facts.result).toBe(\"done\");\n * ```\n *\n * @public\n */\nexport async function settleWithFakeTimers(\n  system: { inspect(): SystemInspection },\n  advanceTime: (ms: number) => void,\n  options: {\n    /** Total time to advance (default: 5000ms) */\n    totalTime?: number;\n    /** Time to advance each step (default: 10ms) */\n    stepSize?: number;\n    /** Maximum iterations before giving up (default: 1000) */\n    maxIterations?: number;\n  } = {},\n): Promise<void> {\n  const { totalTime = 5000, stepSize = 10, maxIterations = 1000 } = options;\n\n  let elapsed = 0;\n  let iterations = 0;\n\n  while (elapsed < totalTime && iterations < maxIterations) {\n    // Flush microtasks first (handles queueMicrotask, Promise.resolve)\n    await flushMicrotasks();\n\n    // Check if settled\n    const inspection = system.inspect();\n    if (inspection.inflight.length === 0) {\n      // One more flush to be safe\n      await flushMicrotasks();\n      return;\n    }\n\n    // Advance fake timers\n    advanceTime(stepSize);\n    elapsed += stepSize;\n    iterations++;\n  }\n\n  // Final check\n  const finalInspection = system.inspect();\n  if (finalInspection.inflight.length > 0) {\n    const resolverIds = finalInspection.inflight\n      .map((r) => r.resolverId)\n      .join(\", \");\n    throw new Error(\n      `[Directive] settleWithFakeTimers did not settle after ${totalTime}ms. ${finalInspection.inflight.length} resolvers still inflight: ${resolverIds}`,\n    );\n  }\n}\n\n// ============================================================================\n// Fake Timers (for standalone use without vi.useFakeTimers)\n// ============================================================================\n\n/**\n * Standalone fake timer controller for tests that do not use Vitest/Jest fake timers.\n *\n * @remarks\n * For most tests, prefer Vitest's `vi.useFakeTimers()` paired with\n * {@link settleWithFakeTimers} for better integration. Use this interface\n * only when you need a lightweight, framework-independent timer mock.\n *\n * @public\n */\nexport interface FakeTimers {\n  /** Advance time by a number of milliseconds, firing any timers that fall within the window. */\n  advance(ms: number): Promise<void>;\n  /** Advance to the next scheduled timer and fire its callback. */\n  next(): Promise<void>;\n  /** Run all pending timers in chronological order. */\n  runAll(): Promise<void>;\n  /** Get the current fake time in milliseconds. */\n  now(): number;\n  /** Reset the clock to time 0 and discard all scheduled timers. */\n  reset(): void;\n}\n\n/**\n * Create standalone fake timers for testing without a framework timer mock.\n *\n * @remarks\n * For most tests, prefer Vitest's `vi.useFakeTimers()` paired with\n * {@link settleWithFakeTimers}. This factory is useful when you need an\n * isolated timer that does not interfere with global timer state.\n *\n * @returns A {@link FakeTimers} controller with `advance`, `next`, `runAll`, `now`, and `reset` methods.\n *\n * @example\n * ```typescript\n * const timers = createFakeTimers();\n * // schedule work, then:\n * await timers.advance(500);\n * expect(timers.now()).toBe(500);\n * ```\n *\n * @public\n */\nexport function createFakeTimers(): FakeTimers {\n  let currentTime = 0;\n  const timers: Array<{ time: number; callback: () => void }> = [];\n\n  return {\n    async advance(ms: number): Promise<void> {\n      const targetTime = currentTime + ms;\n\n      // Run all timers that would fire during this advance\n      while (timers.length > 0 && timers[0]!.time <= targetTime) {\n        const timer = timers.shift()!;\n        currentTime = timer.time;\n        timer.callback();\n        await Promise.resolve(); // Allow microtasks\n      }\n\n      currentTime = targetTime;\n    },\n\n    async next(): Promise<void> {\n      if (timers.length === 0) return;\n\n      const timer = timers.shift()!;\n      currentTime = timer.time;\n      timer.callback();\n      await Promise.resolve();\n    },\n\n    async runAll(): Promise<void> {\n      while (timers.length > 0) {\n        await this.next();\n      }\n    },\n\n    now(): number {\n      return currentTime;\n    },\n\n    reset(): void {\n      currentTime = 0;\n      timers.length = 0;\n    },\n  };\n}\n\n// ============================================================================\n// Mock Resolvers\n// ============================================================================\n\n/**\n * Context passed to mock resolver resolve functions.\n *\n * @public\n */\nexport interface MockResolverContext {\n  /** Facts object (use type assertion for specific facts) */\n  // biome-ignore lint/suspicious/noExplicitAny: Facts type varies by system\n  facts: any;\n  /** Abort signal for cancellation */\n  signal: AbortSignal;\n}\n\n/**\n * Configuration for a simple mock resolver created via {@link createMockResolver}.\n *\n * @typeParam R - The requirement type this resolver handles.\n *\n * @public\n */\nexport interface MockResolverOptions<R extends Requirement = Requirement> {\n  /** Predicate to check if this resolver handles a given requirement. */\n  requirement?: (req: Requirement) => req is R;\n  /** Mock implementation invoked when the resolver runs. */\n  resolve?: (req: R, ctx: MockResolverContext) => void | Promise<void>;\n  /** Artificial delay in milliseconds before the resolver completes. */\n  delay?: number;\n  /** Error (or message string) to throw, simulating a resolver failure. */\n  error?: Error | string;\n  /** Array that receives every requirement passed to this resolver. */\n  calls?: R[];\n}\n\n/** Internal resolver definition type for mock resolvers */\ninterface MockResolverDef {\n  requirement: (req: Requirement) => boolean;\n  resolve: (req: Requirement, ctx: MockResolverContext) => Promise<void>;\n}\n\n/**\n * Create a simple mock resolver that matches requirements by type and optionally\n * records calls, injects delays, or throws errors.\n *\n * @param typeOrOptions - A requirement type string, or a full {@link MockResolverOptions} object.\n * @returns A resolver definition that can be spread into a module's `resolvers` map.\n *\n * @example\n * ```typescript\n * const calls: Requirement[] = [];\n * const mock = createMockResolver({ requirement: (r): r is MyReq => r.type === \"LOAD\", calls });\n * ```\n *\n * @public\n */\nexport function createMockResolver<R extends Requirement = Requirement>(\n  typeOrOptions: string | MockResolverOptions<R>,\n): MockResolverDef {\n  const options: MockResolverOptions<R> =\n    typeof typeOrOptions === \"string\"\n      ? {\n          requirement: ((req: Requirement) => req.type === typeOrOptions) as (\n            req: Requirement,\n          ) => req is R,\n        }\n      : typeOrOptions;\n\n  const calls: R[] = options.calls ?? [];\n\n  return {\n    requirement:\n      options.requirement ?? ((_req: Requirement): _req is R => true),\n    async resolve(req: Requirement, ctx: MockResolverContext): Promise<void> {\n      calls.push(req as R);\n\n      if (options.delay) {\n        await new Promise((resolve) => setTimeout(resolve, options.delay));\n      }\n\n      if (options.error) {\n        throw typeof options.error === \"string\"\n          ? new Error(options.error)\n          : options.error;\n      }\n\n      if (options.resolve) {\n        await options.resolve(req as R, ctx);\n      }\n    },\n  };\n}\n\n// ============================================================================\n// Mock Resolver (Advanced)\n// ============================================================================\n\n/**\n * A mock resolver that captures requirements for manual resolution.\n *\n * @remarks\n * Use this when you need fine-grained control over when and how requirements\n * resolve. Requirements are queued in `pending` and stay unresolved until you\n * explicitly call `resolve()` or `reject()`.\n *\n * @typeParam R - The requirement type this resolver handles.\n *\n * @public\n */\nexport interface MockResolver<R extends Requirement = Requirement> {\n  /** All requirements received by this resolver */\n  readonly calls: R[];\n  /** Pending requirements waiting to be resolved/rejected */\n  readonly pending: Array<{\n    requirement: R;\n    resolve: (result?: unknown) => void;\n    reject: (error: Error) => void;\n  }>;\n  /** Resolve the next pending requirement */\n  resolve(result?: unknown): void;\n  /** Reject the next pending requirement */\n  reject(error: Error): void;\n  /** Resolve all pending requirements */\n  resolveAll(result?: unknown): void;\n  /** Reject all pending requirements */\n  rejectAll(error: Error): void;\n  /** Clear call history and pending queue */\n  reset(): void;\n}\n\n/**\n * Create a mock resolver that captures requirements instead of resolving them,\n * giving you manual control over when and how each requirement completes.\n *\n * @param _requirementType - The requirement `type` string this mock handles (used for documentation; matching is done by the test harness).\n * @returns A {@link MockResolver} with a `handler` function suitable for passing to {@link createTestSystem} mocks.\n *\n * @example\n * ```typescript\n * const fetchMock = mockResolver<{ type: \"FETCH_USER\"; id: string }>(\"FETCH_USER\");\n *\n * const system = createTestSystem({\n *   modules: [userModule],\n *   mocks: {\n *     resolvers: {\n *       FETCH_USER: { resolve: fetchMock.handler },\n *     },\n *   },\n * });\n *\n * system.facts.userId = \"123\";\n * await flushMicrotasks();\n *\n * // Requirement is pending\n * expect(fetchMock.calls).toHaveLength(1);\n * expect(fetchMock.calls[0].id).toBe(\"123\");\n *\n * // Manually resolve it\n * fetchMock.resolve({ name: \"John\" });\n * await flushMicrotasks();\n *\n * expect(system.facts.user).toEqual({ name: \"John\" });\n * ```\n *\n * @public\n */\nexport function mockResolver<R extends Requirement = Requirement>(\n  _requirementType: string,\n): MockResolver<R> & {\n  /** Handler that can be passed to createTestSystem mocks */\n  handler: (req: Requirement, ctx: MockResolverContext) => Promise<void>;\n} {\n  const calls: R[] = [];\n  const pending: Array<{\n    requirement: R;\n    resolve: (result?: unknown) => void;\n    reject: (error: Error) => void;\n  }> = [];\n\n  const mock: MockResolver<R> = {\n    get calls() {\n      return calls;\n    },\n    get pending() {\n      return pending;\n    },\n    resolve(result?: unknown) {\n      const item = pending.shift();\n      if (item) {\n        item.resolve(result);\n      }\n    },\n    reject(error: Error) {\n      const item = pending.shift();\n      if (item) {\n        item.reject(error);\n      }\n    },\n    resolveAll(result?: unknown) {\n      while (pending.length > 0) {\n        this.resolve(result);\n      }\n    },\n    rejectAll(error: Error) {\n      while (pending.length > 0) {\n        this.reject(error);\n      }\n    },\n    reset() {\n      calls.length = 0;\n      pending.length = 0;\n    },\n  };\n\n  const handler = (\n    req: Requirement,\n    _ctx: MockResolverContext,\n  ): Promise<void> => {\n    calls.push(req as R);\n    return new Promise<void>((resolve, reject) => {\n      pending.push({\n        requirement: req as R,\n        resolve: (val?: unknown) => resolve(val as void),\n        reject,\n      });\n    });\n  };\n\n  return {\n    ...mock,\n    handler,\n  };\n}\n\n// ============================================================================\n// Fact Change Tracking\n// ============================================================================\n\n/**\n * Record of a single fact change captured by the test tracking plugin.\n *\n * @public\n */\nexport interface FactChangeRecord {\n  /** The fact key that changed (without namespace prefix for namespaced systems) */\n  key: string;\n  /** The full key including namespace prefix (e.g., \"test::value\") */\n  fullKey: string;\n  /** The namespace (e.g., \"test\") - undefined for single-module systems */\n  namespace?: string;\n  /** The previous value */\n  previousValue: unknown;\n  /** The new value */\n  newValue: unknown;\n  /** Timestamp of the change */\n  timestamp: number;\n}\n\n// ============================================================================\n// Test System\n// ============================================================================\n\n/** Common testing utilities shared by both single-module and namespaced test systems. */\nexport interface TestSystemBase {\n  /**\n   * Wait for all pending operations to complete.\n   * @param maxWait - Maximum time to wait in ms (default: 5000)\n   * @throws Error if timeout is exceeded with resolvers still inflight\n   */\n  waitForIdle(maxWait?: number): Promise<void>;\n  /** Get the history of dispatched events */\n  eventHistory: Array<{ type: string; [key: string]: unknown }>;\n  /** Get resolver call history */\n  resolverCalls: Map<string, Requirement[]>;\n  /**\n   * Get all requirements that have been generated (both resolved and pending).\n   * Unlike `inspect().unmet`, this includes requirements that have already been handled.\n   */\n  readonly allRequirements: RequirementWithId[];\n  /**\n   * Get all fact changes since system start or last reset.\n   */\n  getFactsHistory(): FactChangeRecord[];\n  /**\n   * Reset the facts history tracking.\n   */\n  resetFactsHistory(): void;\n  /** Assert that a requirement was created */\n  assertRequirement(type: string): void;\n  /** Assert that a resolver was called */\n  assertResolverCalled(type: string, times?: number): void;\n  /**\n   * Assert that a fact was set to a specific value.\n   */\n  assertFactSet(key: string, value?: unknown): void;\n  /**\n   * Assert the number of times a fact was changed.\n   */\n  assertFactChanges(key: string, times: number): void;\n}\n\n/**\n * A single-module Directive system augmented with testing utilities.\n *\n * @remarks\n * Extends {@link SingleModuleSystem} with event/resolver/fact tracking, idle\n * waiting, and assertion helpers. Created via {@link createTestSystem}.\n *\n * @typeParam S - The module schema.\n *\n * @public\n */\nexport interface TestSystemSingle<S extends ModuleSchema>\n  extends SingleModuleSystem<S>,\n    TestSystemBase {}\n\n/**\n * A Directive system augmented with testing utilities.\n *\n * @remarks\n * Extends {@link NamespacedSystem} with event/resolver/fact tracking, idle\n * waiting, and assertion helpers. Created via {@link createTestSystem}.\n *\n * @typeParam Modules - The modules map that defines the system's schema.\n *\n * @public\n */\nexport interface TestSystem<Modules extends ModulesMap>\n  extends NamespacedSystem<Modules>,\n    TestSystemBase {}\n\n/**\n * Options for {@link createTestSystem}, extending the standard system options\n * with mock resolver injection and automatic tracking.\n *\n * @typeParam Modules - The modules map that defines the system's schema.\n *\n * @public\n */\nexport interface CreateTestSystemOptions<Modules extends ModulesMap>\n  extends Omit<CreateSystemOptionsNamed<Modules>, \"plugins\"> {\n  /** Mock resolvers by type */\n  mocks?: {\n    resolvers?: Record<string, MockResolverOptions>;\n  };\n  /** Additional plugins (tracking plugin is added automatically) */\n  // biome-ignore lint/suspicious/noExplicitAny: Plugins are schema-agnostic\n  plugins?: any[];\n}\n\n/**\n * Options for {@link createTestSystem} with a single module (no namespacing).\n *\n * @typeParam S - The module schema.\n *\n * @public\n */\nexport interface CreateTestSystemOptionsSingle<S extends ModuleSchema>\n  extends Omit<CreateSystemOptionsSingle<S>, \"plugins\"> {\n  /** Mock resolvers by type */\n  mocks?: {\n    resolvers?: Record<string, MockResolverOptions>;\n  };\n  /** Additional plugins (tracking plugin is added automatically) */\n  // biome-ignore lint/suspicious/noExplicitAny: Plugins are schema-agnostic\n  plugins?: any[];\n}\n\n/**\n * Create a Directive system instrumented for testing.\n *\n * Wraps {@link createSystem} with an automatic tracking plugin that records\n * dispatched events, resolver calls, fact changes, and generated requirements.\n * Mock resolvers can be injected via `options.mocks.resolvers` to replace\n * real resolvers by requirement type.\n *\n * @param options - System configuration with optional mock resolvers and additional plugins.\n * @returns A {@link TestSystem} or {@link TestSystemSingle} with assertion helpers, idle waiting, and history tracking.\n *\n * @example\n * ```typescript\n * // Namespaced (multiple modules)\n * const system = createTestSystem({\n *   modules: { counter: counterModule },\n *   mocks: { resolvers: { INCREMENT: { resolve: (req, context) => { context.facts.count++; } } } },\n * });\n *\n * // Single module\n * const system = createTestSystem({\n *   module: counterModule,\n * });\n * system.start();\n * ```\n *\n * @public\n */\nexport function createTestSystem<S extends ModuleSchema>(\n  options: CreateTestSystemOptionsSingle<S>,\n): TestSystemSingle<S>;\nexport function createTestSystem<Modules extends ModulesMap>(\n  options: CreateTestSystemOptions<Modules>,\n): TestSystem<Modules>;\nexport function createTestSystem<\n  S extends ModuleSchema,\n  Modules extends ModulesMap,\n>(\n  options:\n    | CreateTestSystemOptionsSingle<S>\n    | CreateTestSystemOptions<Modules>,\n): TestSystemSingle<S> | TestSystem<Modules> {\n  // Single module mode: wrap into namespaced and delegate\n  if (\"module\" in options) {\n    return createTestSystemSingle(\n      options as CreateTestSystemOptionsSingle<S>,\n    );\n  }\n\n  return createTestSystemNamed(options as CreateTestSystemOptions<Modules>);\n}\n\nfunction createTestSystemSingle<S extends ModuleSchema>(\n  options: CreateTestSystemOptionsSingle<S>,\n): TestSystemSingle<S> {\n  const eventHistory: Array<{ type: string; [key: string]: unknown }> = [];\n  const resolverCalls = new Map<string, Requirement[]>();\n  const allRequirements: RequirementWithId[] = [];\n  const factsHistory: FactChangeRecord[] = [];\n\n  // Create mock resolvers\n  const mockResolvers: Record<string, MockResolverDef> = {};\n  if (options.mocks?.resolvers) {\n    for (const [type, mockOptions] of Object.entries(options.mocks.resolvers)) {\n      const calls: Requirement[] = [];\n      resolverCalls.set(type, calls);\n      mockResolvers[type] = createMockResolver({ ...mockOptions, calls });\n    }\n  }\n\n  // Create module with mock resolvers\n  // biome-ignore lint/suspicious/noExplicitAny: Mock resolvers have simplified types\n  const moduleWithMocks: ModuleDef<S> = {\n    ...options.module,\n    resolvers: {\n      ...options.module.resolvers,\n      ...mockResolvers,\n    } as any,\n  };\n\n  // Create tracking plugin\n  const trackingPlugin = {\n    name: \"__test-tracking__\",\n    onFactSet: (fullKey: string, value: unknown, previousValue: unknown) => {\n      factsHistory.push({\n        key: fullKey,\n        fullKey,\n        namespace: undefined,\n        previousValue,\n        newValue: value,\n        timestamp: Date.now(),\n      });\n    },\n    onRequirementCreated: (requirement: RequirementWithId) => {\n      allRequirements.push(requirement);\n    },\n  };\n\n  // Create the underlying single-module system\n  const system = createSystem({\n    ...options,\n    module: moduleWithMocks,\n    plugins: [trackingPlugin, ...(options.plugins ?? [])],\n  // biome-ignore lint/suspicious/noExplicitAny: Internal overload compatibility\n  } as any) as SingleModuleSystem<S>;\n\n  // Wrap dispatch to track events\n  const originalDispatch = system.dispatch.bind(system);\n  // biome-ignore lint/suspicious/noExplicitAny: Event type varies\n  (system as any).dispatch = (event: any) => {\n    eventHistory.push(event);\n    originalDispatch(event);\n  };\n\n  const testSystem: TestSystemSingle<S> = {\n    ...system,\n    eventHistory,\n    resolverCalls,\n\n    get allRequirements() {\n      return allRequirements;\n    },\n\n    getFactsHistory(): FactChangeRecord[] {\n      return [...factsHistory];\n    },\n\n    resetFactsHistory(): void {\n      factsHistory.length = 0;\n    },\n\n    async waitForIdle(maxWait = 5000): Promise<void> {\n      const startTime = Date.now();\n\n      const checkIdle = async (): Promise<void> => {\n        await new Promise((resolve) => setTimeout(resolve, 0));\n        const inspection = system.inspect();\n        if (inspection.inflight.length > 0) {\n          if (Date.now() - startTime > maxWait) {\n            const resolverIds = inspection.inflight\n              .map((r) => r.id)\n              .join(\", \");\n            throw new Error(\n              `[Directive] waitForIdle timed out after ${maxWait}ms. ${inspection.inflight.length} resolvers still inflight: ${resolverIds}`,\n            );\n          }\n          await new Promise((resolve) => setTimeout(resolve, 10));\n\n          return checkIdle();\n        }\n      };\n\n      return checkIdle();\n    },\n\n    assertRequirement(type: string): void {\n      const hasRequirement = allRequirements.some(\n        (r) => r.requirement.type === type,\n      );\n      if (!hasRequirement) {\n        throw new Error(\n          `[Directive] Expected requirement of type \"${type}\" but none found`,\n        );\n      }\n    },\n\n    assertResolverCalled(type: string, times?: number): void {\n      const calls = resolverCalls.get(type) ?? [];\n      if (times !== undefined) {\n        if (calls.length !== times) {\n          throw new Error(\n            `[Directive] Expected resolver \"${type}\" to be called ${times} times but was called ${calls.length} times`,\n          );\n        }\n      } else if (calls.length === 0) {\n        throw new Error(\n          `[Directive] Expected resolver \"${type}\" to be called but it was not`,\n        );\n      }\n    },\n\n    assertFactSet(key: string, value?: unknown): void {\n      const changes = factsHistory.filter((c) => c.key === key);\n      if (changes.length === 0) {\n        throw new Error(\n          `[Directive] Expected fact \"${key}\" to be set but it was not`,\n        );\n      }\n      if (value !== undefined) {\n        const hasValue = changes.some((c) => c.newValue === value);\n        if (!hasValue) {\n          const actualValues = changes\n            .map((c) => JSON.stringify(c.newValue))\n            .join(\", \");\n          throw new Error(\n            `[Directive] Expected fact \"${key}\" to be set to ${JSON.stringify(value)} but got: ${actualValues}`,\n          );\n        }\n      }\n    },\n\n    assertFactChanges(key: string, times: number): void {\n      const changes = factsHistory.filter((c) => c.key === key);\n      if (changes.length !== times) {\n        throw new Error(\n          `[Directive] Expected fact \"${key}\" to change ${times} times but it changed ${changes.length} times`,\n        );\n      }\n    },\n  };\n\n  return testSystem;\n}\n\nfunction createTestSystemNamed<Modules extends ModulesMap>(\n  options: CreateTestSystemOptions<Modules>,\n): TestSystem<Modules> {\n  const eventHistory: Array<{ type: string; [key: string]: unknown }> = [];\n  const resolverCalls = new Map<string, Requirement[]>();\n  const allRequirements: RequirementWithId[] = [];\n  const factsHistory: FactChangeRecord[] = [];\n\n  // Create mock resolvers\n  const mockResolvers: Record<string, MockResolverDef> = {};\n  if (options.mocks?.resolvers) {\n    for (const [type, mockOptions] of Object.entries(options.mocks.resolvers)) {\n      const calls: Requirement[] = [];\n      resolverCalls.set(type, calls);\n      mockResolvers[type] = createMockResolver({ ...mockOptions, calls });\n    }\n  }\n\n  // Create modules with mock resolvers\n  const modulesWithMocks: Modules = {} as Modules;\n  for (const [name, module] of Object.entries(options.modules)) {\n    // biome-ignore lint/suspicious/noExplicitAny: Module types are complex\n    (modulesWithMocks as any)[name] = {\n      ...module,\n      resolvers: {\n        ...module.resolvers,\n        ...mockResolvers,\n      },\n    };\n  }\n\n  // Get module namespaces for key parsing\n  const moduleNamespaces = new Set(Object.keys(options.modules));\n\n  // Create tracking plugin\n  const trackingPlugin = {\n    name: \"__test-tracking__\",\n    onFactSet: (fullKey: string, value: unknown, previousValue: unknown) => {\n      // Parse namespaced key (e.g., \"test::value\" -> namespace: \"test\", key: \"value\")\n      const SEPARATOR = \"::\";\n      const sepIndex = fullKey.indexOf(SEPARATOR);\n      let namespace: string | undefined;\n      let key: string;\n\n      if (sepIndex > 0) {\n        const possibleNamespace = fullKey.substring(0, sepIndex);\n        if (moduleNamespaces.has(possibleNamespace)) {\n          namespace = possibleNamespace;\n          key = fullKey.substring(sepIndex + SEPARATOR.length);\n        } else {\n          key = fullKey;\n        }\n      } else {\n        key = fullKey;\n      }\n\n      factsHistory.push({\n        key,\n        fullKey,\n        namespace,\n        previousValue,\n        newValue: value,\n        timestamp: Date.now(),\n      });\n    },\n    onRequirementCreated: (requirement: RequirementWithId) => {\n      allRequirements.push(requirement);\n    },\n  };\n\n  // Create the underlying system\n  const system = createSystem({\n    ...options,\n    modules: modulesWithMocks,\n    plugins: [trackingPlugin, ...(options.plugins ?? [])],\n  }) as NamespacedSystem<Modules>;\n\n  // Wrap dispatch to track events\n  const originalDispatch = system.dispatch.bind(system);\n  // biome-ignore lint/suspicious/noExplicitAny: Event type varies\n  (system as any).dispatch = (event: any) => {\n    eventHistory.push(event);\n    originalDispatch(event);\n  };\n\n  const testSystem: TestSystem<Modules> = {\n    ...system,\n    eventHistory,\n    resolverCalls,\n\n    get allRequirements() {\n      return allRequirements;\n    },\n\n    getFactsHistory(): FactChangeRecord[] {\n      return [...factsHistory];\n    },\n\n    resetFactsHistory(): void {\n      factsHistory.length = 0;\n    },\n\n    async waitForIdle(maxWait = 5000): Promise<void> {\n      const startTime = Date.now();\n\n      const checkIdle = async (): Promise<void> => {\n        // Wait for microtasks\n        await new Promise((resolve) => setTimeout(resolve, 0));\n\n        // Check if there are inflight resolvers\n        const inspection = system.inspect();\n        if (inspection.inflight.length > 0) {\n          // Check timeout\n          if (Date.now() - startTime > maxWait) {\n            const resolverIds = inspection.inflight.map((r) => r.id).join(\", \");\n            throw new Error(\n              `[Directive] waitForIdle timed out after ${maxWait}ms. ${inspection.inflight.length} resolvers still inflight: ${resolverIds}`,\n            );\n          }\n          // Wait a bit more and check again\n          await new Promise((resolve) => setTimeout(resolve, 10));\n          return checkIdle();\n        }\n      };\n\n      return checkIdle();\n    },\n\n    assertRequirement(type: string): void {\n      const hasRequirement = allRequirements.some(\n        (r) => r.requirement.type === type,\n      );\n      if (!hasRequirement) {\n        throw new Error(\n          `[Directive] Expected requirement of type \"${type}\" but none found`,\n        );\n      }\n    },\n\n    assertResolverCalled(type: string, times?: number): void {\n      const calls = resolverCalls.get(type) ?? [];\n      if (times !== undefined) {\n        if (calls.length !== times) {\n          throw new Error(\n            `[Directive] Expected resolver \"${type}\" to be called ${times} times but was called ${calls.length} times`,\n          );\n        }\n      } else if (calls.length === 0) {\n        throw new Error(\n          `[Directive] Expected resolver \"${type}\" to be called but it was not`,\n        );\n      }\n    },\n\n    assertFactSet(key: string, value?: unknown): void {\n      const changes = factsHistory.filter((c) => c.key === key);\n      if (changes.length === 0) {\n        throw new Error(\n          `[Directive] Expected fact \"${key}\" to be set but it was not`,\n        );\n      }\n      if (value !== undefined) {\n        const hasValue = changes.some((c) => c.newValue === value);\n        if (!hasValue) {\n          const actualValues = changes\n            .map((c) => JSON.stringify(c.newValue))\n            .join(\", \");\n          throw new Error(\n            `[Directive] Expected fact \"${key}\" to be set to ${JSON.stringify(value)} but got: ${actualValues}`,\n          );\n        }\n      }\n    },\n\n    assertFactChanges(key: string, times: number): void {\n      const changes = factsHistory.filter((c) => c.key === key);\n      if (changes.length !== times) {\n        throw new Error(\n          `[Directive] Expected fact \"${key}\" to change ${times} times but it changed ${changes.length} times`,\n        );\n      }\n    },\n  };\n\n  return testSystem;\n}\n\n// ============================================================================\n// Dynamic Definition Assertions\n// ============================================================================\n\n/**\n * Assert that a definition was dynamically registered on the system.\n *\n * @param system - The Directive system to check.\n * @param type - The definition type: \"constraint\", \"resolver\", \"derivation\", or \"effect\".\n * @param id - The definition ID.\n * @throws Error if the definition is not dynamic.\n *\n * @example\n * ```typescript\n * system.constraints.register(\"myRule\", { when: () => true, require: { type: \"DO\" } });\n * assertDynamic(system, \"constraint\", \"myRule\"); // passes\n * assertDynamic(system, \"constraint\", \"staticRule\"); // throws\n * ```\n *\n * @public\n */\nexport function assertDynamic(\n  system: {\n    constraints: { isDynamic(id: string): boolean };\n    effects: { isDynamic(id: string): boolean };\n    resolvers: { isDynamic(id: string): boolean };\n    derive: { isDynamic(id: string): boolean };\n  },\n  type: \"constraint\" | \"resolver\" | \"derivation\" | \"effect\",\n  id: string,\n): void {\n  const isDynamic = getDynamicCheck(system, type, id);\n  if (!isDynamic) {\n    throw new Error(\n      `[Directive] Expected ${type} \"${id}\" to be dynamic, but it is not.`,\n    );\n  }\n}\n\n/**\n * Assert that a definition is NOT dynamically registered (i.e., is static or does not exist).\n *\n * @param system - The Directive system to check.\n * @param type - The definition type: \"constraint\", \"resolver\", \"derivation\", or \"effect\".\n * @param id - The definition ID.\n * @throws Error if the definition is dynamic.\n *\n * @example\n * ```typescript\n * assertNotDynamic(system, \"constraint\", \"staticRule\"); // passes\n * system.constraints.register(\"myRule\", def);\n * assertNotDynamic(system, \"constraint\", \"myRule\"); // throws\n * ```\n *\n * @public\n */\nexport function assertNotDynamic(\n  system: {\n    constraints: { isDynamic(id: string): boolean };\n    effects: { isDynamic(id: string): boolean };\n    resolvers: { isDynamic(id: string): boolean };\n    derive: { isDynamic(id: string): boolean };\n  },\n  type: \"constraint\" | \"resolver\" | \"derivation\" | \"effect\",\n  id: string,\n): void {\n  const isDynamic = getDynamicCheck(system, type, id);\n  if (isDynamic) {\n    throw new Error(\n      `[Directive] Expected ${type} \"${id}\" to NOT be dynamic, but it is.`,\n    );\n  }\n}\n\n/** @internal */\nfunction getDynamicCheck(\n  system: {\n    constraints: { isDynamic(id: string): boolean };\n    effects: { isDynamic(id: string): boolean };\n    resolvers: { isDynamic(id: string): boolean };\n    derive: { isDynamic(id: string): boolean };\n  },\n  type: \"constraint\" | \"resolver\" | \"derivation\" | \"effect\",\n  id: string,\n): boolean {\n  switch (type) {\n    case \"constraint\":\n      return system.constraints.isDynamic(id);\n    case \"resolver\":\n      return system.resolvers.isDynamic(id);\n    case \"derivation\":\n      return system.derive.isDynamic(id);\n    case \"effect\":\n      return system.effects.isDynamic(id);\n  }\n}\n\n// ============================================================================\n// Constraint Coverage\n// ============================================================================\n\n/** Coverage report for a Directive system. */\nexport interface CoverageReport {\n  /** Constraints that evaluated to true at least once. */\n  constraintsHit: Set<string>;\n  /** Constraints that never evaluated to true. */\n  constraintsMissed: Set<string>;\n  /** Resolvers that started at least once. */\n  resolversRun: Set<string>;\n  /** Resolvers that never started. */\n  resolversMissed: Set<string>;\n  /** Effects that ran at least once. */\n  effectsRun: Set<string>;\n  /** Derivations that recomputed at least once. */\n  derivationsComputed: Set<string>;\n  /** Coverage percentage (constraintsHit / total constraints). */\n  constraintCoverage: number;\n  /** Coverage percentage (resolversRun / total resolvers). */\n  resolverCoverage: number;\n}\n\n/**\n * Track which constraints, resolvers, effects, and derivations are exercised\n * during a test scenario. Returns a coverage report after the scenario runs.\n *\n * @example\n * ```typescript\n * const { run, report } = createCoverageTracker(system);\n *\n * await run(async () => {\n *   system.facts.userId = 123;\n *   await system.settle();\n *   system.facts.userId = 0;\n *   await system.settle();\n * });\n *\n * const coverage = report();\n * expect(coverage.constraintCoverage).toBe(1); // All constraints hit\n * expect(coverage.constraintsMissed.size).toBe(0);\n * ```\n */\nexport function createCoverageTracker(\n  // biome-ignore lint/suspicious/noExplicitAny: Works with any system type\n  system: SingleModuleSystem<any> | NamespacedSystem<any>,\n): {\n  /** Run a test scenario while tracking coverage. */\n  run: (scenario: () => Promise<void> | void) => Promise<void>;\n  /** Get the coverage report. */\n  report: () => CoverageReport;\n} {\n  const constraintsHit = new Set<string>();\n  const resolversRun = new Set<string>();\n  const effectsRun = new Set<string>();\n  const derivationsComputed = new Set<string>();\n\n  let unsub: (() => void) | null = null;\n\n  return {\n    async run(scenario) {\n      unsub = system.observe((event) => {\n        switch (event.type) {\n          case \"constraint.evaluate\":\n            if (event.active) constraintsHit.add(event.id);\n            break;\n          case \"resolver.start\":\n            resolversRun.add(event.resolver);\n            break;\n          case \"effect.run\":\n            effectsRun.add(event.id);\n            break;\n          case \"derivation.compute\":\n            derivationsComputed.add(event.id);\n            break;\n        }\n      });\n\n      try {\n        await scenario();\n      } finally {\n        unsub?.();\n        unsub = null;\n      }\n    },\n\n    report(): CoverageReport {\n      const inspection = system.inspect();\n\n      const allConstraints = new Set(inspection.constraints.map((c) => c.id));\n      const allResolvers = new Set(\n        inspection.resolverDefs.map((r) => r.id),\n      );\n\n      const constraintsMissed = new Set<string>();\n      for (const id of allConstraints) {\n        if (!constraintsHit.has(id)) constraintsMissed.add(id);\n      }\n\n      const resolversMissed = new Set<string>();\n      for (const id of allResolvers) {\n        if (!resolversRun.has(id)) resolversMissed.add(id);\n      }\n\n      return {\n        constraintsHit,\n        constraintsMissed,\n        resolversRun,\n        resolversMissed,\n        effectsRun,\n        derivationsComputed,\n        constraintCoverage:\n          allConstraints.size === 0\n            ? 1\n            : constraintsHit.size / allConstraints.size,\n        resolverCoverage:\n          allResolvers.size === 0\n            ? 1\n            : resolversRun.size / allResolvers.size,\n      };\n    },\n  };\n}\n\n// ============================================================================\n// Test Observer\n// ============================================================================\n\n/**\n * Create a test observer that collects all observation events.\n * Useful for assertion-based testing of system behavior.\n *\n * @example\n * ```typescript\n * const observer = createTestObserver(system);\n *\n * system.facts.count = 5;\n * await system.settle();\n *\n * expect(observer.events.filter(e => e.type === \"constraint.evaluate\")).toHaveLength(1);\n * expect(observer.ofType(\"resolver.complete\")).toHaveLength(1);\n *\n * observer.clear();\n * observer.dispose();\n * ```\n */\nexport function createTestObserver(\n  // biome-ignore lint/suspicious/noExplicitAny: Works with any system type\n  system: SingleModuleSystem<any> | NamespacedSystem<any>,\n): {\n  /** All collected events. */\n  events: import(\"../core/types/system.js\").ObservationEvent[];\n  /** Filter events by type. */\n  ofType: <T extends import(\"../core/types/system.js\").ObservationEvent[\"type\"]>(\n    type: T,\n  ) => Extract<import(\"../core/types/system.js\").ObservationEvent, { type: T }>[];\n  /** Clear collected events. */\n  clear: () => void;\n  /** Stop observing. */\n  dispose: () => void;\n} {\n  const events: import(\"../core/types/system.js\").ObservationEvent[] = [];\n  const unsub = system.observe((event) => events.push(event));\n\n  return {\n    events,\n    ofType(type) {\n      return events.filter((e) => e.type === type) as any;\n    },\n    clear() {\n      events.length = 0;\n    },\n    dispose() {\n      unsub();\n    },\n  };\n}\n"]}

package/dist/worker.cjs

@@ -1,2 +1,2 @@
-'use strict';function _(o){let{worker:c,onFactChange:l,onDerivationChange:y,onRequirementCreated:E,onRequirementMet:a,onError:r}=o,s=new Map,u=0,t=null,i=null,d=null,T=null;function g(e){return e?.(),null}function R(e,n){let S=s.get(e);S&&(S.resolve(n),s.delete(e));}function M(){t=g(t);}function m(){i=g(i);}function I(){d=g(d);}function b(){T=g(T);}function h(e){l?.(e.key,e.value,e.prev);}function O(e){y?.(e.key,e.value);}function W(e){E?.(e.requirement);}function C(e){a?.(e.requirementId,e.resolverId);}function P(e){r?.(e.error,e.source);}function D(e){R(e.requestId,e.snapshot);}function w(e){R(e.requestId,e.inspection);}function q(e){let n=s.get(e.requestId);n&&(e.success?n.resolve(void 0):n.reject(new Error(e.error||"Settle failed")),s.delete(e.requestId));}c.onmessage=e=>{let n=e.data;switch(n.type){case "READY":return M();case "STARTED":return m();case "STOPPED":return I();case "DESTROYED":return b();case "FACT_CHANGED":return h(n);case "DERIVATION_CHANGED":return O(n);case "REQUIREMENT_CREATED":return W(n);case "REQUIREMENT_MET":return C(n);case "ERROR":return P(n);case "SNAPSHOT_RESULT":return D(n);case "INSPECT_RESULT":return w(n);case "SETTLE_RESULT":return q(n)}},c.onerror=e=>{r?.(e.message,"worker");};function p(e){c.postMessage(e);}function k(e){return new Promise((n,S)=>{s.set(e.requestId,{resolve:n,reject:S}),p(e);})}return {init(e){return new Promise(n=>{t=n,p({type:"INIT",config:e});})},start(){return new Promise(e=>{i=e,p({type:"START"});})},stop(){return new Promise(e=>{d=e,p({type:"STOP"});})},destroy(){return new Promise(e=>{T=e,p({type:"DESTROY"});})},setFact(e,n){p({type:"SET_FACT",key:e,value:n});},setFacts(e){p({type:"SET_FACTS",facts:e});},dispatch(e){p({type:"DISPATCH",event:e});},getSnapshot(e){let n=`snapshot-${++u}`;return k({type:"GET_SNAPSHOT",options:e,requestId:n})},inspect(){let e=`inspect-${++u}`;return k({type:"INSPECT",requestId:e})},settle(e){let n=`settle-${++u}`;return k({type:"SETTLE",timeout:e,requestId:n})},terminate(){c.terminate();}}}var v=null;function f(){return v||(v=new Map),v}function N(o,c){f().set(o,c);}function x(){let o=null;async function c(t){let i=await A(t.config);return postMessage({type:"READY"}),i}function l(t){t.start(),postMessage({type:"STARTED"});}function y(t){t.stop(),postMessage({type:"STOPPED"});}function E(t){t.destroy(),postMessage({type:"DESTROYED"});}function a(t,i){let d=t.getSnapshot(i.options);postMessage({type:"SNAPSHOT_RESULT",requestId:i.requestId,snapshot:d});}function r(t,i){let d=t.inspect();postMessage({type:"INSPECT_RESULT",requestId:i.requestId,inspection:d});}async function s(t,i){try{await t.settle(i.timeout),postMessage({type:"SETTLE_RESULT",requestId:i.requestId,success:!0});}catch(d){postMessage({type:"SETTLE_RESULT",requestId:i.requestId,success:false,error:d instanceof Error?d.message:String(d)});}}async function u(t){if(t.type==="INIT"){o=await c(t);return}if(o)switch(t.type){case "START":l(o);break;case "STOP":y(o);break;case "DESTROY":E(o),o=null;break;case "SET_FACT":o.setFact(t.key,t.value);break;case "SET_FACTS":o.setFacts(t.facts);break;case "DISPATCH":o.dispatch(t.event);break;case "GET_SNAPSHOT":a(o,t);break;case "INSPECT":r(o,t);break;case "SETTLE":await s(o,t);break}}self.onmessage=async t=>{try{await u(t.data);}catch(i){postMessage({type:"ERROR",error:i instanceof Error?i.message:String(i),source:t.data.type});}};}async function A(o){let{createSystem:c}=await import('./system-QQYBNE7A.cjs'),l=f(),y={};for(let r of o.moduleNames){let s=l.get(r);if(!s)throw new Error(`[Directive Worker] Module "${r}" not registered. Call registerWorkerModule('${r}', module) before handling messages.`);y[r]=s;}let a=c({modules:y,plugins:[{name:"__worker-tracking__",onFactSet:(r,s,u)=>{postMessage({type:"FACT_CHANGED",key:r,value:s,prev:u});},onDerivationCompute:(r,s)=>{postMessage({type:"DERIVATION_CHANGED",key:r,value:s});},onRequirementCreated:r=>{postMessage({type:"REQUIREMENT_CREATED",requirement:{...r.requirement,id:r.id}});},onRequirementMet:(r,s)=>{postMessage({type:"REQUIREMENT_MET",requirementId:r.id,resolverId:s});}}],history:o.history});return {start:()=>a.start(),stop:()=>a.stop(),destroy:()=>a.destroy(),setFact:(r,s)=>{a.facts[r]=s;},setFacts:r=>{let s=a.facts;if(s.$store?.batch)s.$store.batch(()=>{for(let[u,t]of Object.entries(r))s[u]=t;});else for(let[u,t]of Object.entries(r))s[u]=t;},dispatch:r=>{a.dispatch(r);},getSnapshot:r=>a.getDistributableSnapshot(r),inspect:()=>a.inspect(),settle:r=>a.settle(r)}}exports.createWorkerClient=_;exports.getWorkerModuleRegistry=f;exports.handleWorkerMessages=x;exports.registerWorkerModule=N;//# sourceMappingURL=worker.cjs.map
+'use strict';function _(o){let{worker:c,onFactChange:l,onDerivationChange:y,onRequirementCreated:E,onRequirementMet:a,onError:r}=o,s=new Map,u=0,t=null,i=null,d=null,T=null;function g(e){return e?.(),null}function R(e,n){let S=s.get(e);S&&(S.resolve(n),s.delete(e));}function M(){t=g(t);}function m(){i=g(i);}function I(){d=g(d);}function b(){T=g(T);}function h(e){l?.(e.key,e.value,e.prev);}function O(e){y?.(e.key,e.value);}function W(e){E?.(e.requirement);}function C(e){a?.(e.requirementId,e.resolverId);}function P(e){r?.(e.error,e.source);}function D(e){R(e.requestId,e.snapshot);}function w(e){R(e.requestId,e.inspection);}function q(e){let n=s.get(e.requestId);n&&(e.success?n.resolve(void 0):n.reject(new Error(e.error||"Settle failed")),s.delete(e.requestId));}c.onmessage=e=>{let n=e.data;switch(n.type){case "READY":return M();case "STARTED":return m();case "STOPPED":return I();case "DESTROYED":return b();case "FACT_CHANGED":return h(n);case "DERIVATION_CHANGED":return O(n);case "REQUIREMENT_CREATED":return W(n);case "REQUIREMENT_MET":return C(n);case "ERROR":return P(n);case "SNAPSHOT_RESULT":return D(n);case "INSPECT_RESULT":return w(n);case "SETTLE_RESULT":return q(n)}},c.onerror=e=>{r?.(e.message,"worker");};function p(e){c.postMessage(e);}function k(e){return new Promise((n,S)=>{s.set(e.requestId,{resolve:n,reject:S}),p(e);})}return {init(e){return new Promise(n=>{t=n,p({type:"INIT",config:e});})},start(){return new Promise(e=>{i=e,p({type:"START"});})},stop(){return new Promise(e=>{d=e,p({type:"STOP"});})},destroy(){return new Promise(e=>{T=e,p({type:"DESTROY"});})},setFact(e,n){p({type:"SET_FACT",key:e,value:n});},setFacts(e){p({type:"SET_FACTS",facts:e});},dispatch(e){p({type:"DISPATCH",event:e});},getSnapshot(e){let n=`snapshot-${++u}`;return k({type:"GET_SNAPSHOT",options:e,requestId:n})},inspect(){let e=`inspect-${++u}`;return k({type:"INSPECT",requestId:e})},settle(e){let n=`settle-${++u}`;return k({type:"SETTLE",timeout:e,requestId:n})},terminate(){c.terminate();}}}var v=null;function f(){return v||(v=new Map),v}function N(o,c){f().set(o,c);}function x(){let o=null;async function c(t){let i=await A(t.config);return postMessage({type:"READY"}),i}function l(t){t.start(),postMessage({type:"STARTED"});}function y(t){t.stop(),postMessage({type:"STOPPED"});}function E(t){t.destroy(),postMessage({type:"DESTROYED"});}function a(t,i){let d=t.getSnapshot(i.options);postMessage({type:"SNAPSHOT_RESULT",requestId:i.requestId,snapshot:d});}function r(t,i){let d=t.inspect();postMessage({type:"INSPECT_RESULT",requestId:i.requestId,inspection:d});}async function s(t,i){try{await t.settle(i.timeout),postMessage({type:"SETTLE_RESULT",requestId:i.requestId,success:!0});}catch(d){postMessage({type:"SETTLE_RESULT",requestId:i.requestId,success:false,error:d instanceof Error?d.message:String(d)});}}async function u(t){if(t.type==="INIT"){o=await c(t);return}if(o)switch(t.type){case "START":l(o);break;case "STOP":y(o);break;case "DESTROY":E(o),o=null;break;case "SET_FACT":o.setFact(t.key,t.value);break;case "SET_FACTS":o.setFacts(t.facts);break;case "DISPATCH":o.dispatch(t.event);break;case "GET_SNAPSHOT":a(o,t);break;case "INSPECT":r(o,t);break;case "SETTLE":await s(o,t);break}}self.onmessage=async t=>{try{await u(t.data);}catch(i){postMessage({type:"ERROR",error:i instanceof Error?i.message:String(i),source:t.data.type});}};}async function A(o){let{createSystem:c}=await import('./system-6JXMY66X.cjs'),l=f(),y={};for(let r of o.moduleNames){let s=l.get(r);if(!s)throw new Error(`[Directive Worker] Module "${r}" not registered. Call registerWorkerModule('${r}', module) before handling messages.`);y[r]=s;}let a=c({modules:y,plugins:[{name:"__worker-tracking__",onFactSet:(r,s,u)=>{postMessage({type:"FACT_CHANGED",key:r,value:s,prev:u});},onDerivationCompute:(r,s)=>{postMessage({type:"DERIVATION_CHANGED",key:r,value:s});},onRequirementCreated:r=>{postMessage({type:"REQUIREMENT_CREATED",requirement:{...r.requirement,id:r.id}});},onRequirementMet:(r,s)=>{postMessage({type:"REQUIREMENT_MET",requirementId:r.id,resolverId:s});}}],history:o.history});return {start:()=>a.start(),stop:()=>a.stop(),destroy:()=>a.destroy(),setFact:(r,s)=>{a.facts[r]=s;},setFacts:r=>{let s=a.facts;if(s.$store?.batch)s.$store.batch(()=>{for(let[u,t]of Object.entries(r))s[u]=t;});else for(let[u,t]of Object.entries(r))s[u]=t;},dispatch:r=>{a.dispatch(r);},getSnapshot:r=>a.getDistributableSnapshot(r),inspect:()=>a.inspect(),settle:r=>a.settle(r)}}exports.createWorkerClient=_;exports.getWorkerModuleRegistry=f;exports.handleWorkerMessages=x;exports.registerWorkerModule=N;//# sourceMappingURL=worker.cjs.map
 //# sourceMappingURL=worker.cjs.map

package/dist/worker.d.cts

@@ -1,4 +1,4 @@
-import { M as ModuleSchema, s as DistributableSnapshotOptions, r as DistributableSnapshot, _ as SystemInspection, o as Requirement } from './plugins-O-3VHejK.cjs';
+import { M as ModuleSchema, s as DistributableSnapshotOptions, r as DistributableSnapshot, $ as SystemInspection, o as Requirement } from './plugins-day_qfBB.cjs';
 
 /**
  * Web Worker Adapter - Run Directive engine off the main thread

package/dist/worker.d.ts

@@ -1,4 +1,4 @@
-import { M as ModuleSchema, s as DistributableSnapshotOptions, r as DistributableSnapshot, _ as SystemInspection, o as Requirement } from './plugins-O-3VHejK.js';
+import { M as ModuleSchema, s as DistributableSnapshotOptions, r as DistributableSnapshot, $ as SystemInspection, o as Requirement } from './plugins-day_qfBB.js';
 
 /**
  * Web Worker Adapter - Run Directive engine off the main thread

package/dist/worker.js

@@ -1,2 +1,2 @@
-function _(o){let{worker:c,onFactChange:l,onDerivationChange:y,onRequirementCreated:E,onRequirementMet:a,onError:r}=o,s=new Map,u=0,t=null,i=null,d=null,T=null;function g(e){return e?.(),null}function R(e,n){let S=s.get(e);S&&(S.resolve(n),s.delete(e));}function M(){t=g(t);}function m(){i=g(i);}function I(){d=g(d);}function b(){T=g(T);}function h(e){l?.(e.key,e.value,e.prev);}function O(e){y?.(e.key,e.value);}function W(e){E?.(e.requirement);}function C(e){a?.(e.requirementId,e.resolverId);}function P(e){r?.(e.error,e.source);}function D(e){R(e.requestId,e.snapshot);}function w(e){R(e.requestId,e.inspection);}function q(e){let n=s.get(e.requestId);n&&(e.success?n.resolve(void 0):n.reject(new Error(e.error||"Settle failed")),s.delete(e.requestId));}c.onmessage=e=>{let n=e.data;switch(n.type){case "READY":return M();case "STARTED":return m();case "STOPPED":return I();case "DESTROYED":return b();case "FACT_CHANGED":return h(n);case "DERIVATION_CHANGED":return O(n);case "REQUIREMENT_CREATED":return W(n);case "REQUIREMENT_MET":return C(n);case "ERROR":return P(n);case "SNAPSHOT_RESULT":return D(n);case "INSPECT_RESULT":return w(n);case "SETTLE_RESULT":return q(n)}},c.onerror=e=>{r?.(e.message,"worker");};function p(e){c.postMessage(e);}function k(e){return new Promise((n,S)=>{s.set(e.requestId,{resolve:n,reject:S}),p(e);})}return {init(e){return new Promise(n=>{t=n,p({type:"INIT",config:e});})},start(){return new Promise(e=>{i=e,p({type:"START"});})},stop(){return new Promise(e=>{d=e,p({type:"STOP"});})},destroy(){return new Promise(e=>{T=e,p({type:"DESTROY"});})},setFact(e,n){p({type:"SET_FACT",key:e,value:n});},setFacts(e){p({type:"SET_FACTS",facts:e});},dispatch(e){p({type:"DISPATCH",event:e});},getSnapshot(e){let n=`snapshot-${++u}`;return k({type:"GET_SNAPSHOT",options:e,requestId:n})},inspect(){let e=`inspect-${++u}`;return k({type:"INSPECT",requestId:e})},settle(e){let n=`settle-${++u}`;return k({type:"SETTLE",timeout:e,requestId:n})},terminate(){c.terminate();}}}var v=null;function f(){return v||(v=new Map),v}function N(o,c){f().set(o,c);}function x(){let o=null;async function c(t){let i=await A(t.config);return postMessage({type:"READY"}),i}function l(t){t.start(),postMessage({type:"STARTED"});}function y(t){t.stop(),postMessage({type:"STOPPED"});}function E(t){t.destroy(),postMessage({type:"DESTROYED"});}function a(t,i){let d=t.getSnapshot(i.options);postMessage({type:"SNAPSHOT_RESULT",requestId:i.requestId,snapshot:d});}function r(t,i){let d=t.inspect();postMessage({type:"INSPECT_RESULT",requestId:i.requestId,inspection:d});}async function s(t,i){try{await t.settle(i.timeout),postMessage({type:"SETTLE_RESULT",requestId:i.requestId,success:!0});}catch(d){postMessage({type:"SETTLE_RESULT",requestId:i.requestId,success:false,error:d instanceof Error?d.message:String(d)});}}async function u(t){if(t.type==="INIT"){o=await c(t);return}if(o)switch(t.type){case "START":l(o);break;case "STOP":y(o);break;case "DESTROY":E(o),o=null;break;case "SET_FACT":o.setFact(t.key,t.value);break;case "SET_FACTS":o.setFacts(t.facts);break;case "DISPATCH":o.dispatch(t.event);break;case "GET_SNAPSHOT":a(o,t);break;case "INSPECT":r(o,t);break;case "SETTLE":await s(o,t);break}}self.onmessage=async t=>{try{await u(t.data);}catch(i){postMessage({type:"ERROR",error:i instanceof Error?i.message:String(i),source:t.data.type});}};}async function A(o){let{createSystem:c}=await import('./system-AGVKMAYF.js'),l=f(),y={};for(let r of o.moduleNames){let s=l.get(r);if(!s)throw new Error(`[Directive Worker] Module "${r}" not registered. Call registerWorkerModule('${r}', module) before handling messages.`);y[r]=s;}let a=c({modules:y,plugins:[{name:"__worker-tracking__",onFactSet:(r,s,u)=>{postMessage({type:"FACT_CHANGED",key:r,value:s,prev:u});},onDerivationCompute:(r,s)=>{postMessage({type:"DERIVATION_CHANGED",key:r,value:s});},onRequirementCreated:r=>{postMessage({type:"REQUIREMENT_CREATED",requirement:{...r.requirement,id:r.id}});},onRequirementMet:(r,s)=>{postMessage({type:"REQUIREMENT_MET",requirementId:r.id,resolverId:s});}}],history:o.history});return {start:()=>a.start(),stop:()=>a.stop(),destroy:()=>a.destroy(),setFact:(r,s)=>{a.facts[r]=s;},setFacts:r=>{let s=a.facts;if(s.$store?.batch)s.$store.batch(()=>{for(let[u,t]of Object.entries(r))s[u]=t;});else for(let[u,t]of Object.entries(r))s[u]=t;},dispatch:r=>{a.dispatch(r);},getSnapshot:r=>a.getDistributableSnapshot(r),inspect:()=>a.inspect(),settle:r=>a.settle(r)}}export{_ as createWorkerClient,f as getWorkerModuleRegistry,x as handleWorkerMessages,N as registerWorkerModule};//# sourceMappingURL=worker.js.map
+function _(o){let{worker:c,onFactChange:l,onDerivationChange:y,onRequirementCreated:E,onRequirementMet:a,onError:r}=o,s=new Map,u=0,t=null,i=null,d=null,T=null;function g(e){return e?.(),null}function R(e,n){let S=s.get(e);S&&(S.resolve(n),s.delete(e));}function M(){t=g(t);}function m(){i=g(i);}function I(){d=g(d);}function b(){T=g(T);}function h(e){l?.(e.key,e.value,e.prev);}function O(e){y?.(e.key,e.value);}function W(e){E?.(e.requirement);}function C(e){a?.(e.requirementId,e.resolverId);}function P(e){r?.(e.error,e.source);}function D(e){R(e.requestId,e.snapshot);}function w(e){R(e.requestId,e.inspection);}function q(e){let n=s.get(e.requestId);n&&(e.success?n.resolve(void 0):n.reject(new Error(e.error||"Settle failed")),s.delete(e.requestId));}c.onmessage=e=>{let n=e.data;switch(n.type){case "READY":return M();case "STARTED":return m();case "STOPPED":return I();case "DESTROYED":return b();case "FACT_CHANGED":return h(n);case "DERIVATION_CHANGED":return O(n);case "REQUIREMENT_CREATED":return W(n);case "REQUIREMENT_MET":return C(n);case "ERROR":return P(n);case "SNAPSHOT_RESULT":return D(n);case "INSPECT_RESULT":return w(n);case "SETTLE_RESULT":return q(n)}},c.onerror=e=>{r?.(e.message,"worker");};function p(e){c.postMessage(e);}function k(e){return new Promise((n,S)=>{s.set(e.requestId,{resolve:n,reject:S}),p(e);})}return {init(e){return new Promise(n=>{t=n,p({type:"INIT",config:e});})},start(){return new Promise(e=>{i=e,p({type:"START"});})},stop(){return new Promise(e=>{d=e,p({type:"STOP"});})},destroy(){return new Promise(e=>{T=e,p({type:"DESTROY"});})},setFact(e,n){p({type:"SET_FACT",key:e,value:n});},setFacts(e){p({type:"SET_FACTS",facts:e});},dispatch(e){p({type:"DISPATCH",event:e});},getSnapshot(e){let n=`snapshot-${++u}`;return k({type:"GET_SNAPSHOT",options:e,requestId:n})},inspect(){let e=`inspect-${++u}`;return k({type:"INSPECT",requestId:e})},settle(e){let n=`settle-${++u}`;return k({type:"SETTLE",timeout:e,requestId:n})},terminate(){c.terminate();}}}var v=null;function f(){return v||(v=new Map),v}function N(o,c){f().set(o,c);}function x(){let o=null;async function c(t){let i=await A(t.config);return postMessage({type:"READY"}),i}function l(t){t.start(),postMessage({type:"STARTED"});}function y(t){t.stop(),postMessage({type:"STOPPED"});}function E(t){t.destroy(),postMessage({type:"DESTROYED"});}function a(t,i){let d=t.getSnapshot(i.options);postMessage({type:"SNAPSHOT_RESULT",requestId:i.requestId,snapshot:d});}function r(t,i){let d=t.inspect();postMessage({type:"INSPECT_RESULT",requestId:i.requestId,inspection:d});}async function s(t,i){try{await t.settle(i.timeout),postMessage({type:"SETTLE_RESULT",requestId:i.requestId,success:!0});}catch(d){postMessage({type:"SETTLE_RESULT",requestId:i.requestId,success:false,error:d instanceof Error?d.message:String(d)});}}async function u(t){if(t.type==="INIT"){o=await c(t);return}if(o)switch(t.type){case "START":l(o);break;case "STOP":y(o);break;case "DESTROY":E(o),o=null;break;case "SET_FACT":o.setFact(t.key,t.value);break;case "SET_FACTS":o.setFacts(t.facts);break;case "DISPATCH":o.dispatch(t.event);break;case "GET_SNAPSHOT":a(o,t);break;case "INSPECT":r(o,t);break;case "SETTLE":await s(o,t);break}}self.onmessage=async t=>{try{await u(t.data);}catch(i){postMessage({type:"ERROR",error:i instanceof Error?i.message:String(i),source:t.data.type});}};}async function A(o){let{createSystem:c}=await import('./system-I534ZO6E.js'),l=f(),y={};for(let r of o.moduleNames){let s=l.get(r);if(!s)throw new Error(`[Directive Worker] Module "${r}" not registered. Call registerWorkerModule('${r}', module) before handling messages.`);y[r]=s;}let a=c({modules:y,plugins:[{name:"__worker-tracking__",onFactSet:(r,s,u)=>{postMessage({type:"FACT_CHANGED",key:r,value:s,prev:u});},onDerivationCompute:(r,s)=>{postMessage({type:"DERIVATION_CHANGED",key:r,value:s});},onRequirementCreated:r=>{postMessage({type:"REQUIREMENT_CREATED",requirement:{...r.requirement,id:r.id}});},onRequirementMet:(r,s)=>{postMessage({type:"REQUIREMENT_MET",requirementId:r.id,resolverId:s});}}],history:o.history});return {start:()=>a.start(),stop:()=>a.stop(),destroy:()=>a.destroy(),setFact:(r,s)=>{a.facts[r]=s;},setFacts:r=>{let s=a.facts;if(s.$store?.batch)s.$store.batch(()=>{for(let[u,t]of Object.entries(r))s[u]=t;});else for(let[u,t]of Object.entries(r))s[u]=t;},dispatch:r=>{a.dispatch(r);},getSnapshot:r=>a.getDistributableSnapshot(r),inspect:()=>a.inspect(),settle:r=>a.settle(r)}}export{_ as createWorkerClient,f as getWorkerModuleRegistry,x as handleWorkerMessages,N as registerWorkerModule};//# sourceMappingURL=worker.js.map
 //# sourceMappingURL=worker.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@directive-run/core",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "The constraint-driven runtime for TypeScript. Declare what must be true — the runtime makes it happen.",
   "license": "(MIT OR Apache-2.0)",
   "author": "Jason Comes",