@directive-run/core 1.12.0 → 1.13.0

package/dist/adapter-utils.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkN4KTCKOI_cjs=require('./chunk-N4KTCKOI.cjs'),chunkEOLY64E6_cjs=require('./chunk-EOLY64E6.cjs');function w(n){let e=n.inspect();return {isSettled:n.isSettled,unmet:e.unmet,inflight:e.inflight,isWorking:e.unmet.length>0||e.inflight.length>0,hasUnmet:e.unmet.length>0,hasInflight:e.inflight.length>0}}function S(n,e){let r=null,t=null,s=0;return {throttled:((...i)=>{let o=Date.now(),l=o-s;l>=e?(s=o,n(...i)):(t=i,r||(r=setTimeout(()=>{r=null,s=Date.now(),t&&(n(...t),t=null);},e-l)));}),cleanup:()=>{r&&(clearTimeout(r),r=null),t=null;}}}function x(n,e){if(chunkN4KTCKOI_cjs.a&&e==null)throw new Error(`[Directive] ${n}() requires a system instance as the first argument. Received ${e}.`)}function R(n,e){return Object.is(n,e)}function T(n){let e=n.history;if(!e)return null;let r=e.snapshots.map(t=>({id:t.id,timestamp:t.timestamp,trigger:t.trigger}));return {canGoBack:e.currentIndex>0,canGoForward:e.currentIndex<e.snapshots.length-1,currentIndex:e.currentIndex,totalSnapshots:e.snapshots.length,snapshots:r,getSnapshotFacts:t=>{let s=e.snapshots.find(a=>a.id===t);return s?s.facts:null},goTo:t=>e.goTo(t),goBack:t=>e.goBack(t),goForward:t=>e.goForward(t),replay:()=>e.replay(),exportSession:()=>e.export(),importSession:t=>e.import(t),beginChangeset:t=>e.beginChangeset(t),endChangeset:()=>e.endChangeset(),isPaused:e.isPaused,pause:()=>e.pause(),resume:()=>e.resume()}}function I(n,e){let r={};for(let t of e)r[t]=n.facts.$store.get(t);return r}function C(n,e,r){let t=[],s=new Proxy({},{get(i,o){if(typeof o=="string")return e.has(o)?(t.push(o),n.read(o)):n.facts.$store.get(o)},has(i,o){return typeof o!="string"?false:e.has(o)||n.facts.$store.has(o)},ownKeys(){let i=Object.keys(n.facts.$store.toObject()),o=new Set(i);for(let l of e)o.add(l);return [...o]},getOwnPropertyDescriptor(){return {configurable:true,enumerable:true,writable:true}}}),{value:a,deps:u}=chunkN4KTCKOI_cjs.i(()=>r(s));return {value:a,factKeys:Array.from(u),deriveKeys:t}}function P(n,e,r,t){let s=e.length!==n.length||e.some((u,i)=>u!==n[i]),a=t.length!==r.length||t.some((u,i)=>u!==r[i]);return s||a}function q(n,e){if(!n)return {...e};let r="data"in n&&typeof n.data=="object"&&n.data!==null?n.data:n;return {...e,...r}}Object.defineProperty(exports,"createCallbackPlugin",{enumerable:true,get:function(){return chunkN4KTCKOI_cjs.d}});Object.defineProperty(exports,"getBridgeFact",{enumerable:true,get:function(){return chunkN4KTCKOI_cjs.c}});Object.defineProperty(exports,"requirementGuard",{enumerable:true,get:function(){return chunkN4KTCKOI_cjs.e}});Object.defineProperty(exports,"requirementGuardMultiple",{enumerable:true,get:function(){return chunkN4KTCKOI_cjs.f}});Object.defineProperty(exports,"setBridgeFact",{enumerable:true,get:function(){return chunkN4KTCKOI_cjs.b}});Object.defineProperty(exports,"shallowEqual",{enumerable:true,get:function(){return chunkEOLY64E6_cjs.f}});exports.assertSystem=x;exports.buildHistoryState=T;exports.computeInspectState=w;exports.createThrottle=S;exports.defaultEquality=R;exports.depsChanged=P;exports.mergeHydrationFacts=q;exports.pickFacts=I;exports.runTrackedSelector=C;//# sourceMappingURL=adapter-utils.cjs.map
+'use strict';var chunkX7G7UBXU_cjs=require('./chunk-X7G7UBXU.cjs'),chunk4MNQDXH7_cjs=require('./chunk-4MNQDXH7.cjs');function w(n){let e=n.inspect();return {isSettled:n.isSettled,unmet:e.unmet,inflight:e.inflight,isWorking:e.unmet.length>0||e.inflight.length>0,hasUnmet:e.unmet.length>0,hasInflight:e.inflight.length>0}}function S(n,e){let r=null,t=null,s=0;return {throttled:((...i)=>{let o=Date.now(),l=o-s;l>=e?(s=o,n(...i)):(t=i,r||(r=setTimeout(()=>{r=null,s=Date.now(),t&&(n(...t),t=null);},e-l)));}),cleanup:()=>{r&&(clearTimeout(r),r=null),t=null;}}}function x(n,e){if(chunk4MNQDXH7_cjs.a&&e==null)throw new Error(`[Directive] ${n}() requires a system instance as the first argument. Received ${e}.`)}function R(n,e){return Object.is(n,e)}function T(n){let e=n.history;if(!e)return null;let r=e.snapshots.map(t=>({id:t.id,timestamp:t.timestamp,trigger:t.trigger}));return {canGoBack:e.currentIndex>0,canGoForward:e.currentIndex<e.snapshots.length-1,currentIndex:e.currentIndex,totalSnapshots:e.snapshots.length,snapshots:r,getSnapshotFacts:t=>{let s=e.snapshots.find(a=>a.id===t);return s?s.facts:null},goTo:t=>e.goTo(t),goBack:t=>e.goBack(t),goForward:t=>e.goForward(t),replay:()=>e.replay(),exportSession:()=>e.export(),importSession:t=>e.import(t),beginChangeset:t=>e.beginChangeset(t),endChangeset:()=>e.endChangeset(),isPaused:e.isPaused,pause:()=>e.pause(),resume:()=>e.resume()}}function I(n,e){let r={};for(let t of e)r[t]=n.facts.$store.get(t);return r}function C(n,e,r){let t=[],s=new Proxy({},{get(i,o){if(typeof o=="string")return e.has(o)?(t.push(o),n.read(o)):n.facts.$store.get(o)},has(i,o){return typeof o!="string"?false:e.has(o)||n.facts.$store.has(o)},ownKeys(){let i=Object.keys(n.facts.$store.toObject()),o=new Set(i);for(let l of e)o.add(l);return [...o]},getOwnPropertyDescriptor(){return {configurable:true,enumerable:true,writable:true}}}),{value:a,deps:u}=chunkX7G7UBXU_cjs.h(()=>r(s));return {value:a,factKeys:Array.from(u),deriveKeys:t}}function P(n,e,r,t){let s=e.length!==n.length||e.some((u,i)=>u!==n[i]),a=t.length!==r.length||t.some((u,i)=>u!==r[i]);return s||a}function q(n,e){if(!n)return {...e};let r="data"in n&&typeof n.data=="object"&&n.data!==null?n.data:n;return {...e,...r}}Object.defineProperty(exports,"createCallbackPlugin",{enumerable:true,get:function(){return chunkX7G7UBXU_cjs.c}});Object.defineProperty(exports,"getBridgeFact",{enumerable:true,get:function(){return chunkX7G7UBXU_cjs.b}});Object.defineProperty(exports,"requirementGuard",{enumerable:true,get:function(){return chunkX7G7UBXU_cjs.d}});Object.defineProperty(exports,"requirementGuardMultiple",{enumerable:true,get:function(){return chunkX7G7UBXU_cjs.e}});Object.defineProperty(exports,"setBridgeFact",{enumerable:true,get:function(){return chunkX7G7UBXU_cjs.a}});Object.defineProperty(exports,"shallowEqual",{enumerable:true,get:function(){return chunk4MNQDXH7_cjs.g}});exports.assertSystem=x;exports.buildHistoryState=T;exports.computeInspectState=w;exports.createThrottle=S;exports.defaultEquality=R;exports.depsChanged=P;exports.mergeHydrationFacts=q;exports.pickFacts=I;exports.runTrackedSelector=C;//# sourceMappingURL=adapter-utils.cjs.map
 //# sourceMappingURL=adapter-utils.cjs.map

package/dist/adapter-utils.d.cts

@@ -1,5 +1,5 @@
-import { t as Requirement, q as Plugin, c as Facts, a8 as Schema, I as HistoryAPI, ac as SystemInspection, K as HistoryState } from './plugins-Ykl_sAPE.cjs';
-export { s as shallowEqual } from './utils-BnQajqPu.cjs';
+import { q as Requirement, P as Plugin, a as Facts, a8 as Schema, H as HistoryAPI, ac as SystemInspection, I as HistoryState } from './plugins-BIzXaYbg.cjs';
+export { s as shallowEqual } from './utils-Mg55IerF.cjs';
 
 /**
  * Adapter Type Utilities - Shared types and helpers for framework adapters

package/dist/adapter-utils.d.ts

@@ -1,5 +1,5 @@
-import { t as Requirement, q as Plugin, c as Facts, a8 as Schema, I as HistoryAPI, ac as SystemInspection, K as HistoryState } from './plugins-Ykl_sAPE.js';
-export { s as shallowEqual } from './utils-BnQajqPu.js';
+import { q as Requirement, P as Plugin, a as Facts, a8 as Schema, H as HistoryAPI, ac as SystemInspection, I as HistoryState } from './plugins-BIzXaYbg.js';
+export { s as shallowEqual } from './utils-Mg55IerF.js';
 
 /**
  * Adapter Type Utilities - Shared types and helpers for framework adapters

package/dist/adapter-utils.js

@@ -1,2 +1,2 @@
-import {a,i}from'./chunk-TZHC4E6S.js';export{d as createCallbackPlugin,c as getBridgeFact,e as requirementGuard,f as requirementGuardMultiple,b as setBridgeFact}from'./chunk-TZHC4E6S.js';export{f as shallowEqual}from'./chunk-T6IJUWYR.js';function w(n){let e=n.inspect();return {isSettled:n.isSettled,unmet:e.unmet,inflight:e.inflight,isWorking:e.unmet.length>0||e.inflight.length>0,hasUnmet:e.unmet.length>0,hasInflight:e.inflight.length>0}}function S(n,e){let r=null,t=null,s=0;return {throttled:((...i)=>{let o=Date.now(),l=o-s;l>=e?(s=o,n(...i)):(t=i,r||(r=setTimeout(()=>{r=null,s=Date.now(),t&&(n(...t),t=null);},e-l)));}),cleanup:()=>{r&&(clearTimeout(r),r=null),t=null;}}}function x(n,e){if(a&&e==null)throw new Error(`[Directive] ${n}() requires a system instance as the first argument. Received ${e}.`)}function R(n,e){return Object.is(n,e)}function T(n){let e=n.history;if(!e)return null;let r=e.snapshots.map(t=>({id:t.id,timestamp:t.timestamp,trigger:t.trigger}));return {canGoBack:e.currentIndex>0,canGoForward:e.currentIndex<e.snapshots.length-1,currentIndex:e.currentIndex,totalSnapshots:e.snapshots.length,snapshots:r,getSnapshotFacts:t=>{let s=e.snapshots.find(a=>a.id===t);return s?s.facts:null},goTo:t=>e.goTo(t),goBack:t=>e.goBack(t),goForward:t=>e.goForward(t),replay:()=>e.replay(),exportSession:()=>e.export(),importSession:t=>e.import(t),beginChangeset:t=>e.beginChangeset(t),endChangeset:()=>e.endChangeset(),isPaused:e.isPaused,pause:()=>e.pause(),resume:()=>e.resume()}}function I(n,e){let r={};for(let t of e)r[t]=n.facts.$store.get(t);return r}function C(n,e,r){let t=[],s=new Proxy({},{get(i,o){if(typeof o=="string")return e.has(o)?(t.push(o),n.read(o)):n.facts.$store.get(o)},has(i,o){return typeof o!="string"?false:e.has(o)||n.facts.$store.has(o)},ownKeys(){let i=Object.keys(n.facts.$store.toObject()),o=new Set(i);for(let l of e)o.add(l);return [...o]},getOwnPropertyDescriptor(){return {configurable:true,enumerable:true,writable:true}}}),{value:a,deps:u}=i(()=>r(s));return {value:a,factKeys:Array.from(u),deriveKeys:t}}function P(n,e,r,t){let s=e.length!==n.length||e.some((u,i)=>u!==n[i]),a=t.length!==r.length||t.some((u,i)=>u!==r[i]);return s||a}function q(n,e){if(!n)return {...e};let r="data"in n&&typeof n.data=="object"&&n.data!==null?n.data:n;return {...e,...r}}export{x as assertSystem,T as buildHistoryState,w as computeInspectState,S as createThrottle,R as defaultEquality,P as depsChanged,q as mergeHydrationFacts,I as pickFacts,C as runTrackedSelector};//# sourceMappingURL=adapter-utils.js.map
+import {h}from'./chunk-I722BZA5.js';export{c as createCallbackPlugin,b as getBridgeFact,d as requirementGuard,e as requirementGuardMultiple,a as setBridgeFact}from'./chunk-I722BZA5.js';import {a}from'./chunk-PXRV64PA.js';export{g as shallowEqual}from'./chunk-PXRV64PA.js';function w(n){let e=n.inspect();return {isSettled:n.isSettled,unmet:e.unmet,inflight:e.inflight,isWorking:e.unmet.length>0||e.inflight.length>0,hasUnmet:e.unmet.length>0,hasInflight:e.inflight.length>0}}function S(n,e){let r=null,t=null,s=0;return {throttled:((...i)=>{let o=Date.now(),l=o-s;l>=e?(s=o,n(...i)):(t=i,r||(r=setTimeout(()=>{r=null,s=Date.now(),t&&(n(...t),t=null);},e-l)));}),cleanup:()=>{r&&(clearTimeout(r),r=null),t=null;}}}function x(n,e){if(a&&e==null)throw new Error(`[Directive] ${n}() requires a system instance as the first argument. Received ${e}.`)}function R(n,e){return Object.is(n,e)}function T(n){let e=n.history;if(!e)return null;let r=e.snapshots.map(t=>({id:t.id,timestamp:t.timestamp,trigger:t.trigger}));return {canGoBack:e.currentIndex>0,canGoForward:e.currentIndex<e.snapshots.length-1,currentIndex:e.currentIndex,totalSnapshots:e.snapshots.length,snapshots:r,getSnapshotFacts:t=>{let s=e.snapshots.find(a=>a.id===t);return s?s.facts:null},goTo:t=>e.goTo(t),goBack:t=>e.goBack(t),goForward:t=>e.goForward(t),replay:()=>e.replay(),exportSession:()=>e.export(),importSession:t=>e.import(t),beginChangeset:t=>e.beginChangeset(t),endChangeset:()=>e.endChangeset(),isPaused:e.isPaused,pause:()=>e.pause(),resume:()=>e.resume()}}function I(n,e){let r={};for(let t of e)r[t]=n.facts.$store.get(t);return r}function C(n,e,r){let t=[],s=new Proxy({},{get(i,o){if(typeof o=="string")return e.has(o)?(t.push(o),n.read(o)):n.facts.$store.get(o)},has(i,o){return typeof o!="string"?false:e.has(o)||n.facts.$store.has(o)},ownKeys(){let i=Object.keys(n.facts.$store.toObject()),o=new Set(i);for(let l of e)o.add(l);return [...o]},getOwnPropertyDescriptor(){return {configurable:true,enumerable:true,writable:true}}}),{value:a,deps:u}=h(()=>r(s));return {value:a,factKeys:Array.from(u),deriveKeys:t}}function P(n,e,r,t){let s=e.length!==n.length||e.some((u,i)=>u!==n[i]),a=t.length!==r.length||t.some((u,i)=>u!==r[i]);return s||a}function q(n,e){if(!n)return {...e};let r="data"in n&&typeof n.data=="object"&&n.data!==null?n.data:n;return {...e,...r}}export{x as assertSystem,T as buildHistoryState,w as computeInspectState,S as createThrottle,R as defaultEquality,P as depsChanged,q as mergeHydrationFacts,I as pickFacts,C as runTrackedSelector};//# sourceMappingURL=adapter-utils.js.map
 //# sourceMappingURL=adapter-utils.js.map

package/dist/adapter-utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/adapter-utils.ts"],"names":["computeInspectState","system","inspection","createThrottle","callback","ms","timeoutId","lastArgs","lastCallTime","args","now","timeSinceLastCall","assertSystem","hookName","dev_true_default","defaultEquality","a","b","buildHistoryState","debug","snapshots","s","id","snap","snapshotId","steps","json","label","pickFacts","keys","result","key","runTrackedSelector","deriveKeySet","selector","accessedDeriveKeys","stateProxy","_","prop","factKeys","combined","k","value","deps","withTracking","depsChanged","prevFacts","newFacts","prevDerived","newDerived","factsChanged","derivedChanged","mergeHydrationFacts","snapshot","initialFacts","data"],"mappings":"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","file":"adapter-utils.js","sourcesContent":["/**\n * Shared Adapter Utilities\n *\n * Common types and helper functions used across all framework adapters.\n * @internal\n */\n\nimport isDevelopment from \"#is-development\";\nimport { withTracking } from \"./core/tracking.js\";\nimport type {\n  HistoryAPI,\n  HistoryState,\n  SnapshotMeta,\n  SystemInspection,\n} from \"./core/types.js\";\n\n// ============================================================================\n// SystemLike — structural type satisfied by both System and SingleModuleSystem\n// ============================================================================\n\n/**\n * Minimal structural type for shared adapter helpers.\n * Both `System<any>` and `SingleModuleSystem<any>` satisfy this interface,\n * eliminating the need for `as unknown as System<any>` casts in adapters.\n * @internal\n */\nexport interface SystemLike {\n  readonly isSettled: boolean;\n  readonly history: HistoryAPI | null;\n  readonly facts: {\n    $store: {\n      get(key: string): unknown;\n      has(key: string): boolean;\n      toObject(): Record<string, unknown>;\n    };\n  };\n  readonly derive?: Record<string, unknown>;\n  read(key: string): unknown;\n  inspect(): SystemInspection;\n}\n\n// ============================================================================\n// Requirements State\n// ============================================================================\n\n/**\n * Requirements state returned by useRequirements hooks.\n * Provides a focused view of just requirements without full inspection overhead.\n */\nexport interface RequirementsState {\n  /** Array of unmet requirements waiting to be resolved */\n  unmet: Array<{\n    id: string;\n    requirement: { type: string; [key: string]: unknown };\n    fromConstraint: string;\n  }>;\n  /** Array of requirements currently being resolved */\n  inflight: Array<{ id: string; resolverId: string; startedAt: number }>;\n  /** Whether there are any unmet requirements */\n  hasUnmet: boolean;\n  /** Whether there are any inflight requirements */\n  hasInflight: boolean;\n  /** Whether the system is actively working (has unmet or inflight requirements) */\n  isWorking: boolean;\n}\n\n// ============================================================================\n// Inspect State (shared across all adapters)\n// ============================================================================\n\n/**\n * Consolidated inspection state returned by useInspect hooks.\n * Identical shape across React, Vue, Svelte, Solid, and Lit adapters.\n */\nexport interface InspectState {\n  /** Whether the system has settled (no pending operations) */\n  isSettled: boolean;\n  /** Array of unmet requirements */\n  unmet: RequirementsState[\"unmet\"];\n  /** Array of inflight requirements */\n  inflight: RequirementsState[\"inflight\"];\n  /** Whether the system is actively working */\n  isWorking: boolean;\n  /** Whether there are any unmet requirements */\n  hasUnmet: boolean;\n  /** Whether there are any inflight requirements */\n  hasInflight: boolean;\n}\n\n/**\n * Information about a single constraint.\n */\nexport interface ConstraintInfo {\n  id: string;\n  active: boolean;\n  priority: number;\n}\n\n/**\n * Compute InspectState from a system instance.\n * Centralizes the logic currently duplicated across adapters.\n * @internal\n */\nexport function computeInspectState(system: SystemLike): InspectState {\n  const inspection = system.inspect();\n  return {\n    isSettled: system.isSettled,\n    unmet: inspection.unmet,\n    inflight: inspection.inflight,\n    isWorking: inspection.unmet.length > 0 || inspection.inflight.length > 0,\n    hasUnmet: inspection.unmet.length > 0,\n    hasInflight: inspection.inflight.length > 0,\n  };\n}\n\n// ============================================================================\n// Throttled Hook Options\n// ============================================================================\n\n/**\n * Options for throttled hooks.\n * Used by useInspectThrottled, useRequirementsThrottled, etc.\n */\nexport interface ThrottledHookOptions {\n  /**\n   * Minimum time between updates in milliseconds.\n   * @default 100\n   */\n  throttleMs?: number;\n}\n\n// ============================================================================\n// Throttle Utility\n// ============================================================================\n\n/**\n * Create a throttled version of a callback function.\n * Uses trailing-edge throttling: the callback will be called at most once per interval,\n * with the latest arguments from the most recent call.\n *\n * @param callback - The function to throttle\n * @param ms - The minimum time between calls in milliseconds\n * @returns A throttled version of the callback and a cleanup function\n * @internal\n */\nexport function createThrottle<T extends (...args: unknown[]) => void>(\n  callback: T,\n  ms: number,\n): { throttled: T; cleanup: () => void } {\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n  let lastArgs: Parameters<T> | null = null;\n  let lastCallTime = 0;\n\n  const throttled = ((...args: Parameters<T>) => {\n    const now = Date.now();\n    const timeSinceLastCall = now - lastCallTime;\n\n    if (timeSinceLastCall >= ms) {\n      // Enough time has passed, call immediately\n      lastCallTime = now;\n      callback(...args);\n    } else {\n      // Schedule for later, keeping latest args\n      lastArgs = args;\n      if (!timeoutId) {\n        timeoutId = setTimeout(() => {\n          timeoutId = null;\n          lastCallTime = Date.now();\n          if (lastArgs) {\n            callback(...lastArgs);\n            lastArgs = null;\n          }\n        }, ms - timeSinceLastCall);\n      }\n    }\n  }) as T;\n\n  const cleanup = () => {\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n    lastArgs = null;\n  };\n\n  return { throttled, cleanup };\n}\n\n// ============================================================================\n// Shared Adapter Helpers\n// ============================================================================\n\n/**\n * Dev-mode assertion that the system parameter is non-null.\n * Tree-shaken in production builds.\n * @internal\n */\nexport function assertSystem(hookName: string, system: unknown): void {\n  if (isDevelopment && system == null) {\n    throw new Error(\n      `[Directive] ${hookName}() requires a system instance as the first argument. Received ${system}.`,\n    );\n  }\n}\n\n/** Default equality function using Object.is */\nexport function defaultEquality<T>(a: T, b: T): boolean {\n  return Object.is(a, b);\n}\n\n/**\n * Build a HistoryState object from a system's history instance.\n * Returns null when history is disabled.\n * @internal\n */\nexport function buildHistoryState(system: SystemLike): HistoryState | null {\n  const debug = system.history;\n  if (!debug) return null;\n\n  // Build lightweight metadata array (no facts data)\n  const snapshots: SnapshotMeta[] = debug.snapshots.map((s) => ({\n    id: s.id,\n    timestamp: s.timestamp,\n    trigger: s.trigger,\n  }));\n\n  return {\n    // Navigation state\n    canGoBack: debug.currentIndex > 0,\n    canGoForward: debug.currentIndex < debug.snapshots.length - 1,\n    currentIndex: debug.currentIndex,\n    totalSnapshots: debug.snapshots.length,\n\n    // Snapshot access\n    snapshots,\n    getSnapshotFacts: (id: number): Record<string, unknown> | null => {\n      const snap = debug.snapshots.find((s) => s.id === id);\n      return snap ? snap.facts : null;\n    },\n\n    // Navigation\n    goTo: (snapshotId: number) => debug.goTo(snapshotId),\n    goBack: (steps?: number) => debug.goBack(steps),\n    goForward: (steps?: number) => debug.goForward(steps),\n    replay: () => debug.replay(),\n\n    // Session persistence\n    exportSession: () => debug.export(),\n    importSession: (json: string) => debug.import(json),\n\n    // Changesets\n    beginChangeset: (label: string) => debug.beginChangeset(label),\n    endChangeset: () => debug.endChangeset(),\n\n    // Recording control\n    isPaused: debug.isPaused,\n    pause: () => debug.pause(),\n    resume: () => debug.resume(),\n  };\n}\n\n/**\n * Pick specific fact values from a system's store.\n * @internal\n */\nexport function pickFacts(\n  system: SystemLike,\n  keys: string[],\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const key of keys) {\n    result[key] = system.facts.$store.get(key);\n  }\n  return result;\n}\n\n// ============================================================================\n// Tracked Selector\n// ============================================================================\n\n/** Result of running a selector with tracking. @internal */\nexport interface TrackedSelectorResult<R> {\n  value: R;\n  factKeys: string[];\n  deriveKeys: string[];\n}\n\n/**\n * Run a selector against a system with automatic dependency tracking.\n * Creates a Proxy that intercepts property access to distinguish between\n * fact reads (tracked via withTracking) and derivation reads (tracked manually).\n *\n * Used by useSelector in all framework adapters.\n * @internal\n */\nexport function runTrackedSelector<R>(\n  system: SystemLike,\n  deriveKeySet: Set<string>,\n  selector: (state: Record<string, unknown>) => R,\n): TrackedSelectorResult<R> {\n  const accessedDeriveKeys: string[] = [];\n\n  const stateProxy = new Proxy(\n    {},\n    {\n      get(_, prop: string | symbol) {\n        if (typeof prop !== \"string\") return undefined;\n        if (deriveKeySet.has(prop)) {\n          accessedDeriveKeys.push(prop);\n          return system.read(prop);\n        }\n        return system.facts.$store.get(prop);\n      },\n      has(_, prop: string | symbol) {\n        if (typeof prop !== \"string\") return false;\n        return deriveKeySet.has(prop) || system.facts.$store.has(prop);\n      },\n      ownKeys() {\n        const factKeys = Object.keys(system.facts.$store.toObject());\n        const combined = new Set(factKeys);\n        for (const k of deriveKeySet) combined.add(k);\n        return [...combined];\n      },\n      getOwnPropertyDescriptor() {\n        return { configurable: true, enumerable: true, writable: true };\n      },\n    },\n  );\n\n  const { value, deps } = withTracking(() =>\n    selector(stateProxy as Record<string, unknown>),\n  );\n  return {\n    value,\n    factKeys: Array.from(deps) as string[],\n    deriveKeys: accessedDeriveKeys,\n  };\n}\n\n/**\n * Check if tracked dependency keys have changed.\n * @internal\n */\nexport function depsChanged(\n  prevFacts: string[],\n  newFacts: string[],\n  prevDerived: string[],\n  newDerived: string[],\n): boolean {\n  const factsChanged =\n    newFacts.length !== prevFacts.length ||\n    newFacts.some((k, i) => k !== prevFacts[i]);\n  const derivedChanged =\n    newDerived.length !== prevDerived.length ||\n    newDerived.some((k, i) => k !== prevDerived[i]);\n  return factsChanged || derivedChanged;\n}\n\n// ============================================================================\n// Re-exports from core/types/adapter-utils and utils/utils\n// ============================================================================\n\nexport {\n  setBridgeFact,\n  getBridgeFact,\n  createCallbackPlugin,\n  requirementGuard,\n  requirementGuardMultiple,\n} from \"./core/types/adapter-utils.js\";\n\nexport { shallowEqual } from \"./utils/utils.js\";\n\n/**\n * Merge a DistributableSnapshot's data into initialFacts for SSR hydration.\n * Used by all framework adapters' hydration hooks/controllers.\n *\n * Accepts both shapes:\n * - DistributableSnapshot (`{ data: Record<string, unknown> }`) — used by React's DirectiveHydrator\n * - Plain `Record<string, unknown>` — used by Lit/Vue/Svelte/Solid adapters\n */\nexport function mergeHydrationFacts(\n  snapshot:\n    | { data?: Record<string, unknown> }\n    | Record<string, unknown>\n    | undefined\n    | null,\n  initialFacts?: Record<string, unknown>,\n): Record<string, unknown> {\n  if (!snapshot) {\n    return { ...initialFacts };\n  }\n\n  // If snapshot has a .data property that is a non-null object, treat as DistributableSnapshot\n  const data =\n    \"data\" in snapshot &&\n    typeof snapshot.data === \"object\" &&\n    snapshot.data !== null\n      ? (snapshot.data as Record<string, unknown>)\n      : (snapshot as Record<string, unknown>);\n\n  return { ...initialFacts, ...data };\n}\n"]}
+{"version":3,"sources":["../src/adapter-utils.ts"],"names":["computeInspectState","system","inspection","createThrottle","callback","ms","timeoutId","lastArgs","lastCallTime","args","now","timeSinceLastCall","assertSystem","hookName","dev_true_default","defaultEquality","a","b","buildHistoryState","debug","snapshots","s","id","snap","snapshotId","steps","json","label","pickFacts","keys","result","key","runTrackedSelector","deriveKeySet","selector","accessedDeriveKeys","stateProxy","_","prop","factKeys","combined","k","value","deps","withTracking","depsChanged","prevFacts","newFacts","prevDerived","newDerived","factsChanged","derivedChanged","mergeHydrationFacts","snapshot","initialFacts","data"],"mappings":"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","file":"adapter-utils.js","sourcesContent":["/**\n * Shared Adapter Utilities\n *\n * Common types and helper functions used across all framework adapters.\n * @internal\n */\n\nimport isDevelopment from \"#is-development\";\nimport { withTracking } from \"./core/tracking.js\";\nimport type {\n  HistoryAPI,\n  HistoryState,\n  SnapshotMeta,\n  SystemInspection,\n} from \"./core/types.js\";\n\n// ============================================================================\n// SystemLike — structural type satisfied by both System and SingleModuleSystem\n// ============================================================================\n\n/**\n * Minimal structural type for shared adapter helpers.\n * Both `System<any>` and `SingleModuleSystem<any>` satisfy this interface,\n * eliminating the need for `as unknown as System<any>` casts in adapters.\n * @internal\n */\nexport interface SystemLike {\n  readonly isSettled: boolean;\n  readonly history: HistoryAPI | null;\n  readonly facts: {\n    $store: {\n      get(key: string): unknown;\n      has(key: string): boolean;\n      toObject(): Record<string, unknown>;\n    };\n  };\n  readonly derive?: Record<string, unknown>;\n  read(key: string): unknown;\n  inspect(): SystemInspection;\n}\n\n// ============================================================================\n// Requirements State\n// ============================================================================\n\n/**\n * Requirements state returned by useRequirements hooks.\n * Provides a focused view of just requirements without full inspection overhead.\n */\nexport interface RequirementsState {\n  /** Array of unmet requirements waiting to be resolved */\n  unmet: Array<{\n    id: string;\n    requirement: { type: string; [key: string]: unknown };\n    fromConstraint: string;\n  }>;\n  /** Array of requirements currently being resolved */\n  inflight: Array<{ id: string; resolverId: string; startedAt: number }>;\n  /** Whether there are any unmet requirements */\n  hasUnmet: boolean;\n  /** Whether there are any inflight requirements */\n  hasInflight: boolean;\n  /** Whether the system is actively working (has unmet or inflight requirements) */\n  isWorking: boolean;\n}\n\n// ============================================================================\n// Inspect State (shared across all adapters)\n// ============================================================================\n\n/**\n * Consolidated inspection state returned by useInspect hooks.\n * Identical shape across React, Vue, Svelte, Solid, and Lit adapters.\n */\nexport interface InspectState {\n  /** Whether the system has settled (no pending operations) */\n  isSettled: boolean;\n  /** Array of unmet requirements */\n  unmet: RequirementsState[\"unmet\"];\n  /** Array of inflight requirements */\n  inflight: RequirementsState[\"inflight\"];\n  /** Whether the system is actively working */\n  isWorking: boolean;\n  /** Whether there are any unmet requirements */\n  hasUnmet: boolean;\n  /** Whether there are any inflight requirements */\n  hasInflight: boolean;\n}\n\n/**\n * Information about a single constraint.\n */\nexport interface ConstraintInfo {\n  id: string;\n  active: boolean;\n  priority: number;\n}\n\n/**\n * Compute InspectState from a system instance.\n * Centralizes the logic currently duplicated across adapters.\n * @internal\n */\nexport function computeInspectState(system: SystemLike): InspectState {\n  const inspection = system.inspect();\n  return {\n    isSettled: system.isSettled,\n    unmet: inspection.unmet,\n    inflight: inspection.inflight,\n    isWorking: inspection.unmet.length > 0 || inspection.inflight.length > 0,\n    hasUnmet: inspection.unmet.length > 0,\n    hasInflight: inspection.inflight.length > 0,\n  };\n}\n\n// ============================================================================\n// Throttled Hook Options\n// ============================================================================\n\n/**\n * Options for throttled hooks.\n * Used by useInspectThrottled, useRequirementsThrottled, etc.\n */\nexport interface ThrottledHookOptions {\n  /**\n   * Minimum time between updates in milliseconds.\n   * @default 100\n   */\n  throttleMs?: number;\n}\n\n// ============================================================================\n// Throttle Utility\n// ============================================================================\n\n/**\n * Create a throttled version of a callback function.\n * Uses trailing-edge throttling: the callback will be called at most once per interval,\n * with the latest arguments from the most recent call.\n *\n * @param callback - The function to throttle\n * @param ms - The minimum time between calls in milliseconds\n * @returns A throttled version of the callback and a cleanup function\n * @internal\n */\nexport function createThrottle<T extends (...args: unknown[]) => void>(\n  callback: T,\n  ms: number,\n): { throttled: T; cleanup: () => void } {\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n  let lastArgs: Parameters<T> | null = null;\n  let lastCallTime = 0;\n\n  const throttled = ((...args: Parameters<T>) => {\n    const now = Date.now();\n    const timeSinceLastCall = now - lastCallTime;\n\n    if (timeSinceLastCall >= ms) {\n      // Enough time has passed, call immediately\n      lastCallTime = now;\n      callback(...args);\n    } else {\n      // Schedule for later, keeping latest args\n      lastArgs = args;\n      if (!timeoutId) {\n        timeoutId = setTimeout(() => {\n          timeoutId = null;\n          lastCallTime = Date.now();\n          if (lastArgs) {\n            callback(...lastArgs);\n            lastArgs = null;\n          }\n        }, ms - timeSinceLastCall);\n      }\n    }\n  }) as T;\n\n  const cleanup = () => {\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n    lastArgs = null;\n  };\n\n  return { throttled, cleanup };\n}\n\n// ============================================================================\n// Shared Adapter Helpers\n// ============================================================================\n\n/**\n * Dev-mode assertion that the system parameter is non-null.\n * Tree-shaken in production builds.\n * @internal\n */\nexport function assertSystem(hookName: string, system: unknown): void {\n  if (isDevelopment && system == null) {\n    throw new Error(\n      `[Directive] ${hookName}() requires a system instance as the first argument. Received ${system}.`,\n    );\n  }\n}\n\n/** Default equality function using Object.is */\nexport function defaultEquality<T>(a: T, b: T): boolean {\n  return Object.is(a, b);\n}\n\n/**\n * Build a HistoryState object from a system's history instance.\n * Returns null when history is disabled.\n * @internal\n */\nexport function buildHistoryState(system: SystemLike): HistoryState | null {\n  const debug = system.history;\n  if (!debug) return null;\n\n  // Build lightweight metadata array (no facts data)\n  const snapshots: SnapshotMeta[] = debug.snapshots.map((s) => ({\n    id: s.id,\n    timestamp: s.timestamp,\n    trigger: s.trigger,\n  }));\n\n  return {\n    // Navigation state\n    canGoBack: debug.currentIndex > 0,\n    canGoForward: debug.currentIndex < debug.snapshots.length - 1,\n    currentIndex: debug.currentIndex,\n    totalSnapshots: debug.snapshots.length,\n\n    // Snapshot access\n    snapshots,\n    getSnapshotFacts: (id: number): Record<string, unknown> | null => {\n      const snap = debug.snapshots.find((s) => s.id === id);\n      return snap ? snap.facts : null;\n    },\n\n    // Navigation\n    goTo: (snapshotId: number) => debug.goTo(snapshotId),\n    goBack: (steps?: number) => debug.goBack(steps),\n    goForward: (steps?: number) => debug.goForward(steps),\n    replay: () => debug.replay(),\n\n    // Session persistence\n    exportSession: () => debug.export(),\n    importSession: (json: string) => debug.import(json),\n\n    // Changesets\n    beginChangeset: (label: string) => debug.beginChangeset(label),\n    endChangeset: () => debug.endChangeset(),\n\n    // Recording control\n    isPaused: debug.isPaused,\n    pause: () => debug.pause(),\n    resume: () => debug.resume(),\n  };\n}\n\n/**\n * Pick specific fact values from a system's store.\n * @internal\n */\nexport function pickFacts(\n  system: SystemLike,\n  keys: string[],\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const key of keys) {\n    result[key] = system.facts.$store.get(key);\n  }\n  return result;\n}\n\n// ============================================================================\n// Tracked Selector\n// ============================================================================\n\n/** Result of running a selector with tracking. @internal */\nexport interface TrackedSelectorResult<R> {\n  value: R;\n  factKeys: string[];\n  deriveKeys: string[];\n}\n\n/**\n * Run a selector against a system with automatic dependency tracking.\n * Creates a Proxy that intercepts property access to distinguish between\n * fact reads (tracked via withTracking) and derivation reads (tracked manually).\n *\n * Used by useSelector in all framework adapters.\n * @internal\n */\nexport function runTrackedSelector<R>(\n  system: SystemLike,\n  deriveKeySet: Set<string>,\n  selector: (state: Record<string, unknown>) => R,\n): TrackedSelectorResult<R> {\n  const accessedDeriveKeys: string[] = [];\n\n  const stateProxy = new Proxy(\n    {},\n    {\n      get(_, prop: string | symbol) {\n        if (typeof prop !== \"string\") return undefined;\n        if (deriveKeySet.has(prop)) {\n          accessedDeriveKeys.push(prop);\n          return system.read(prop);\n        }\n        return system.facts.$store.get(prop);\n      },\n      has(_, prop: string | symbol) {\n        if (typeof prop !== \"string\") return false;\n        return deriveKeySet.has(prop) || system.facts.$store.has(prop);\n      },\n      ownKeys() {\n        const factKeys = Object.keys(system.facts.$store.toObject());\n        const combined = new Set(factKeys);\n        for (const k of deriveKeySet) combined.add(k);\n        return [...combined];\n      },\n      getOwnPropertyDescriptor() {\n        return { configurable: true, enumerable: true, writable: true };\n      },\n    },\n  );\n\n  const { value, deps } = withTracking(() =>\n    selector(stateProxy as Record<string, unknown>),\n  );\n  return {\n    value,\n    factKeys: Array.from(deps) as string[],\n    deriveKeys: accessedDeriveKeys,\n  };\n}\n\n/**\n * Check if tracked dependency keys have changed.\n * @internal\n */\nexport function depsChanged(\n  prevFacts: string[],\n  newFacts: string[],\n  prevDerived: string[],\n  newDerived: string[],\n): boolean {\n  const factsChanged =\n    newFacts.length !== prevFacts.length ||\n    newFacts.some((k, i) => k !== prevFacts[i]);\n  const derivedChanged =\n    newDerived.length !== prevDerived.length ||\n    newDerived.some((k, i) => k !== prevDerived[i]);\n  return factsChanged || derivedChanged;\n}\n\n// ============================================================================\n// Re-exports from core/types/adapter-utils and utils/utils\n// ============================================================================\n\nexport {\n  setBridgeFact,\n  getBridgeFact,\n  createCallbackPlugin,\n  requirementGuard,\n  requirementGuardMultiple,\n} from \"./core/types/adapter-utils.js\";\n\nexport { shallowEqual } from \"./utils/utils.js\";\n\n/**\n * Merge a DistributableSnapshot's data into initialFacts for SSR hydration.\n * Used by all framework adapters' hydration hooks/controllers.\n *\n * Accepts both shapes:\n * - DistributableSnapshot (`{ data: Record<string, unknown> }`) — used by React's DirectiveHydrator\n * - Plain `Record<string, unknown>` — used by Lit/Vue/Svelte/Solid adapters\n */\nexport function mergeHydrationFacts(\n  snapshot:\n    | { data?: Record<string, unknown> }\n    | Record<string, unknown>\n    | undefined\n    | null,\n  initialFacts?: Record<string, unknown>,\n): Record<string, unknown> {\n  if (!snapshot) {\n    return { ...initialFacts };\n  }\n\n  // If snapshot has a .data property that is a non-null object, treat as DistributableSnapshot\n  const data =\n    \"data\" in snapshot &&\n    typeof snapshot.data === \"object\" &&\n    snapshot.data !== null\n      ? (snapshot.data as Record<string, unknown>)\n      : (snapshot as Record<string, unknown>);\n\n  return { ...initialFacts, ...data };\n}\n"]}

package/dist/audit-ledger-Dc6hAXam.d.cts

@@ -0,0 +1,378 @@
+import { F as FactPredicate, C as ClauseResult, P as Plugin, M as ModuleSchema } from './plugins-BIzXaYbg.cjs';
+
+/**
+ * createAuditLedger — append-only, queryable, hash-chained
+ * (djb2; SHA-256 reserved for v2) audit of every state change. For
+ * forensics and "show me why this user got that decision."
+ *
+ * Captures (per observation event):
+ *
+ *   - `constraint.evaluate` → { whenSpec, whenExplain, active, whenSource? }
+ *   - `resolver.write.rejected` (rejection + summary kinds)
+ *   - `fact.change` → { key, prior, next }
+ *   - `resolver.complete` → { resolverId, requirementId, duration }
+ *   - `system.init` / `system.start` / `system.stop` / `system.destroy`
+ *   - `system.snapshot` / `system.history.navigate` (lifecycle markers)
+ *   - `system.truncated` (ring-buffer overflow marker)
+ *   - `system.entry-erased` / `system.subject-erased` (GDPR Art.17 stub)
+ *
+ * Hash chain: each entry stores `prevHash` — the djb2 (`hashObject`)
+ * hash of the previous entry's stable-stringified payload. Tampering
+ * with any entry's payload breaks the next entry's `prevHash` link —
+ * visible in `verify()`. v1 ships sync djb2 only; `verify({ strong: true })`
+ * is reserved for v2 (SHA-256) and throws today.
+ *
+ * PII redaction: by default, fact keys whose meta carries the `pii`
+ * tag (via `system.meta.byTag("pii")`) have their values replaced with
+ * `"[redacted]"` in `whenExplain.actual`, `fact.change.prior`,
+ * `fact.change.next`, and the cached `whenSpec` operands. Opt out with
+ * `capturePII: true`.
+ */
+
+/** Hash algorithm tag — bumped if canonicalization or hash function changes. */
+declare const HASH_ALGO: "djb2-1";
+/**
+ * Entry schema version. Bumped if `AuditEntry` field shape changes in
+ * a way that breaks back-compat parsers. Persisted on every entry so
+ * exports remain self-describing across library upgrades. (F-5)
+ */
+declare const SCHEMA_VERSION: 1;
+/**
+ * Private sentinel stamped onto tombstone entries by {@link createAuditLedger.erase}.
+ * Never exported, never serialized — `verify()` checks for it before
+ * accepting a `system.entry-erased` entry as a legitimate chain break.
+ *
+ * (N7) Without this, a caller holding a raw `AuditLedgerSink` reference
+ * could write `{ kind: "system.entry-erased", … }` directly into the
+ * sink to mask real tampering as legitimate erasure. The sentinel
+ * raises the bar so only the in-process ledger plugin (which lives in
+ * this module's closure) can mint a valid tombstone.
+ */
+declare const LEDGER_INTERNAL_TOKEN: unique symbol;
+type AuditEntryKind = "constraint.evaluate" | "resolver.write.rejected" | "fact.change" | "resolver.complete" | "resolver.error" | "system.init" | "system.start" | "system.stop" | "system.destroy" | "system.snapshot" | "system.history.navigate" | "system.truncated" | "system.entry-erased" | "system.subject-erased";
+interface AuditEntryBase {
+    /** Monotonic sequence number, starting at 0. */
+    readonly seq: number;
+    /** Wall-clock timestamp (ms epoch). */
+    readonly ts: number;
+    /** Discriminator. */
+    readonly kind: AuditEntryKind;
+    /** Hash of the previous entry's full payload. null on the genesis entry. */
+    readonly prevHash: string | null;
+    /**
+     * Hash algorithm tag identifying the canonicalization + hash
+     * function in use. Bumped if the algorithm or canonical form
+     * changes, so exports remain verifiable across versions.
+     */
+    readonly hashAlgo: typeof HASH_ALGO;
+    /**
+     * Entry schema version — bumped if any `AuditEntry` field shape
+     * changes in a way that breaks back-compat. Pair with `hashAlgo`
+     * when migrating older exports. (F-5)
+     */
+    readonly schemaVersion: typeof SCHEMA_VERSION;
+    /**
+     * Private sentinel — present (and equal to the in-module token) only
+     * on legitimate tombstones minted by `ledger.erase()`. Filtered out
+     * of all public read paths (`query`, `recent`, `toJSON`, etc.) so
+     * consumers never see or copy it. (N7)
+     *
+     * NOT serialized. NOT exported. Forging this from outside the module
+     * is impossible without the symbol reference; `verify()` rejects any
+     * `system.entry-erased` entry that lacks it.
+     *
+     * @internal
+     */
+    readonly __internal?: typeof LEDGER_INTERNAL_TOKEN;
+}
+type AuditEntry = (AuditEntryBase & {
+    kind: "constraint.evaluate";
+    constraintId: string;
+    active: boolean;
+    /** Cached at ledger start from `system.inspect().constraints[].whenSpec`. Refreshed on `register()`/`assign()`/`unregister()`. May be undefined for function-form constraints (see `whenSource`). PII operands redacted unless `capturePII: true`. */
+    whenSpec?: FactPredicate<unknown>;
+    whenExplain?: readonly ClauseResult[];
+    /**
+     * For function-form constraints (no `whenSpec`), a tamper-evident
+     * identity for the function. We DO NOT capture the raw source —
+     * closures routinely reference secrets, API keys, or PII (e.g.
+     * `if (apiKey === "sk-live-xxx")`) and a preview would leak them
+     * into the audit log. Instead, we capture a djb2 hash of the
+     * stringified function (`hashObject(String(fn))`). Auditors can
+     * detect "the function changed between deploys" by comparing
+     * hashes across entries, without ever seeing the function body.
+     *
+     * Informational only — NOT replayable. (N5, M22)
+     */
+    whenSource?: {
+        kind: "function";
+        sourceHash: string;
+    };
+}) | (AuditEntryBase & {
+    kind: "resolver.write.rejected";
+    rejection: "rejection" | "summary";
+    resolverId: string;
+    requirementId: string;
+    reason: string;
+    fact?: string;
+    expected?: unknown;
+    actual?: unknown;
+    dropped?: number;
+}) | (AuditEntryBase & {
+    kind: "fact.change";
+    key: string;
+    prior: unknown;
+    next: unknown;
+}) | (AuditEntryBase & {
+    kind: "resolver.complete";
+    resolverId: string;
+    requirementId: string;
+    duration: number;
+}) | (AuditEntryBase & {
+    kind: "resolver.error";
+    resolverId: string;
+    requirementId: string;
+    error: string;
+}) | (AuditEntryBase & {
+    kind: "system.init" | "system.start" | "system.stop" | "system.destroy";
+}) | (AuditEntryBase & {
+    kind: "system.snapshot";
+    snapshotId: number;
+    trigger: string;
+}) | (AuditEntryBase & {
+    kind: "system.history.navigate";
+    from: number;
+    to: number;
+}) | (AuditEntryBase & {
+    kind: "system.truncated";
+    droppedSeq: number;
+    droppedCount: number;
+}) | (AuditEntryBase & {
+    kind: "system.entry-erased";
+    originalKind: AuditEntryKind;
+    erasedAt: number;
+}) | (AuditEntryBase & {
+    kind: "system.subject-erased";
+    /**
+     * djb2 hash of the filter (via `hashObject(filter)`). PII-safe —
+     * the raw filter values never land in the ledger. Pair with
+     * `filterShape` to see which filter fields were used. (N2)
+     */
+    filterHash: string;
+    /**
+     * Stripped-values shape of the filter — captures WHICH fields were
+     * present without recording their values. (N2)
+     */
+    filterShape: {
+        factPath: boolean;
+        constraintId: boolean;
+        kind: AuditEntryKind | readonly AuditEntryKind[] | undefined;
+        changedBetween: "[range]" | undefined;
+    };
+    erased: number;
+});
+interface QueryFilter {
+    /** Exact-match fact path. */
+    factPath?: string;
+    /** Filter by constraint id. */
+    constraintId?: string;
+    /** Filter by entry kind. */
+    kind?: AuditEntryKind | readonly AuditEntryKind[];
+    /** Time range as `[startMs, endMs]`, ISO strings, or epoch numbers. */
+    changedBetween?: [string | number | Date, string | number | Date];
+    /** Maximum entries returned. Default 1000. */
+    limit?: number;
+}
+/**
+ * Verify result — chain valid OR a break with full context for tamper visualization.
+ *
+ * Erased entries (via `ledger.erase()`) appear as legitimate chain breaks —
+ * `verify()` reports them in `erasedSeqs` and continues the walk from the
+ * tombstone's own hash. Real tamper still surfaces as `valid: false`.
+ *
+ * Forged tombstones (a caller writes `kind: "system.entry-erased"`
+ * directly via `sink.write()` to mask tamper as erasure) are detected:
+ * legitimate tombstones carry an in-module sentinel that forgeries
+ * cannot mint, so `verify()` reports them as tamper. (N7)
+ */
+type VerifyResult = {
+    valid: true;
+    entryCount: number;
+    /**
+     * Seq numbers of entries legitimately broken by `erase()`
+     * tombstones. NOT timestamps — each entry pairs this seq with
+     * the per-entry `system.entry-erased.erasedAt` (ms epoch) for
+     * the timestamp. Empty unless the chain contains erasures.
+     * (N1 + M1; renamed from `erasedAt` in R3)
+     */
+    erasedSeqs?: number[];
+} | {
+    valid: false;
+    brokenAt: number;
+    expectedHash: string;
+    actualHash: string;
+    entry: AuditEntry;
+    /**
+     * Human-readable reason for the break — populated for cases
+     * where the cause is more specific than "hash mismatch" (e.g.
+     * tombstone forgery detected via missing sentinel).
+     */
+    reason?: string;
+};
+interface AuditLedgerSink {
+    write(entry: AuditEntry): void;
+    query(filter: QueryFilter): readonly AuditEntry[];
+    recent(n: number): readonly AuditEntry[];
+    forFact(path: string, opts?: {
+        limit?: number;
+    }): readonly AuditEntry[];
+    forConstraint(id: string, opts?: {
+        limit?: number;
+    }): readonly AuditEntry[];
+    toJSON(): {
+        entries: readonly AuditEntry[];
+        capturedAt: number;
+    };
+    clear(): void;
+    destroy(): void;
+    /**
+     * Replace matching entries with tombstones IN PLACE (preserving seq +
+     * prevHash so the hash chain still verifies). v1 implementation
+     * matches on the same `QueryFilter` shape used by `query()`.
+     * Returns the count of entries replaced.
+     *
+     * WARNING: erases only from this sink. Any external copies (toJSON
+     * exports, downstream pipelines) must be erased separately.
+     */
+    erase?(filter: QueryFilter, tombstoneFactory: (e: AuditEntry) => AuditEntry): number;
+    /**
+     * Optional hook fired by the sink BEFORE shifting the oldest entry
+     * out of a bounded ring buffer. The ledger plugin uses this to emit
+     * a `system.truncated` marker so an auditor sees that the log was
+     * truncated and where. (M23)
+     */
+    onTruncate?(handler: (droppedSeq: number, droppedCount: number) => void): void;
+}
+/**
+ * In-memory bounded ring-buffer sink. Drops oldest entries past
+ * `capacity` (default 10,000). Use this as the default sink for dev,
+ * tests, and StackBlitz demos.
+ */
+declare function memorySink(opts?: {
+    capacity?: number;
+}): AuditLedgerSink;
+interface AuditLedgerOptions {
+    /** Sink to write entries to. Default: in-memory ring buffer (capacity 10k). */
+    sink?: AuditLedgerSink;
+    /**
+     * Whether to capture raw fact values (`prior`/`next` on fact.change,
+     * `actual` in whenExplain). Default `false` — PII-tagged facts are
+     * redacted by default. Set `true` to opt out of redaction.
+     */
+    capturePII?: boolean;
+    /**
+     * Optional caller-supplied redactor. Runs AFTER the default
+     * pii-tag-based redaction. Useful for additional sanitization.
+     */
+    redact?: (entry: AuditEntry) => AuditEntry;
+}
+interface AuditLedger {
+    /** The plugin to pass to `createSystem({ plugins: [...] })`. */
+    readonly plugin: Plugin<ModuleSchema>;
+    /** Query entries matching the filter. */
+    query(filter?: QueryFilter): readonly AuditEntry[];
+    /** Most recent N entries (chronological). */
+    recent(n: number): readonly AuditEntry[];
+    /** All entries that touch this fact path (exact match). */
+    forFact(path: string, opts?: {
+        limit?: number;
+    }): readonly AuditEntry[];
+    /** All entries for this constraint id. */
+    forConstraint(id: string, opts?: {
+        limit?: number;
+    }): readonly AuditEntry[];
+    /** Full ledger snapshot for export / serialization. */
+    toJSON(): {
+        entries: readonly AuditEntry[];
+        capturedAt: number;
+    };
+    /**
+     * Walk the hash chain genesis → tip. Returns `{ valid: true }` iff
+     * every entry's `prevHash` matches the (sync, djb2-based) hash of
+     * the previous entry. On break, returns the index of the first
+     * broken link plus the expected vs actual hashes — feed into a
+     * "TAMPERED" visualization.
+     *
+     * Erased entries (via `ledger.erase()`) appear as legitimate chain
+     * breaks — `verify()` reports them in `erasedSeqs` and continues
+     * the walk from the tombstone's actual hash. Real tamper still
+     * surfaces as `valid: false`. (N1 + M1)
+     *
+     * Forged tombstones — `kind: "system.entry-erased"` entries written
+     * directly via `sink.write()` to mask tamper — are detected as
+     * forgery. Legitimate tombstones carry an in-module sentinel that
+     * forgeries cannot mint. (N7)
+     *
+     * v1 ships sync djb2 only. `verify({ strong: true })` is reserved
+     * for v2 (SHA-256) and THROWS today — there is no silent fallback.
+     * Call `verify()` (no args) for tamper detection.
+     */
+    verify(opts?: {
+        strong?: boolean;
+    }): VerifyResult;
+    /**
+     * Per-subject erasure (GDPR Art. 17 stub). Replaces matching entries
+     * in this sink with `system.entry-erased` tombstones (preserving
+     * seq + prevHash so verify() can resync), then appends a chained
+     * `system.subject-erased` marker entry that summarises the erasure.
+     *
+     * Returns `{ erased, markerEntry }` — `markerEntry` is the chained
+     * `system.subject-erased` summary (the N per-entry tombstones live
+     * in the sink, not on the return value). (M7)
+     *
+     * When `erased === 0` (filter matched nothing), `markerEntry` is
+     * `null` and no marker is emitted into the chain — avoids polluting
+     * the audit trail with empty "erased: 0" records. (MAJOR-3)
+     *
+     * WARNING: v1 erases only from THIS sink. External copies (toJSON
+     * exports, downstream pipelines, persisted backups) must be erased
+     * separately. (C8)
+     */
+    erase(filter: QueryFilter): {
+        erased: number;
+        markerEntry: AuditEntry | null;
+    };
+    /** Empty the sink. */
+    clear(): void;
+    /** Unsubscribe + drop the sink. */
+    destroy(): void;
+}
+/**
+ * Create an audit ledger that subscribes to the given system's
+ * observation stream. Returns a `Plugin` to install + a query/verify
+ * API for the ledger.
+ *
+ * @example
+ * ```ts
+ * import { createAuditLedger } from "@directive-run/core/plugins";
+ *
+ * const ledger = createAuditLedger();
+ * const system = createSystem({ module, plugins: [ledger.plugin] });
+ * system.start();
+ *
+ * // Six months later — auditor asks "what changed cart-total in March?"
+ * ledger.query({
+ *   factPath: "cartTotal",
+ *   changedBetween: ["2026-03-01", "2026-04-01"],
+ * });
+ *
+ * // Verify nobody tampered with the ledger
+ * const verdict = await ledger.verify();
+ * if (!verdict.valid) {
+ *   console.error("Tamper at entry", verdict.brokenAt);
+ * }
+ * ```
+ */
+declare function createAuditLedger(opts?: AuditLedgerOptions): AuditLedger;
+
+export { type AuditEntry as A, type QueryFilter as Q, type VerifyResult as V, type AuditEntryKind as a, type AuditLedger as b, type AuditLedgerOptions as c, type AuditLedgerSink as d, createAuditLedger as e, memorySink as m };