@directive-run/core 1.0.1 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/adapter-utils.cjs +1 -1
- package/dist/adapter-utils.cjs.map +1 -1
- package/dist/adapter-utils.d.cts +1 -1
- package/dist/adapter-utils.d.ts +1 -1
- package/dist/adapter-utils.js +1 -1
- package/dist/adapter-utils.js.map +1 -1
- package/dist/chunk-2HKKISIL.js +3 -0
- package/dist/chunk-2HKKISIL.js.map +1 -0
- package/dist/chunk-4KFEHIIX.cjs +3 -0
- package/dist/chunk-4KFEHIIX.cjs.map +1 -0
- package/dist/chunk-KKHSUZA5.cjs +2 -0
- package/dist/chunk-KKHSUZA5.cjs.map +1 -0
- package/dist/chunk-L76IJROE.cjs +16 -0
- package/dist/chunk-L76IJROE.cjs.map +1 -0
- package/dist/chunk-LN4YQDLL.js +2 -0
- package/dist/chunk-LN4YQDLL.js.map +1 -0
- package/dist/chunk-WIMO6TQ3.js +16 -0
- package/dist/chunk-WIMO6TQ3.js.map +1 -0
- package/dist/{helpers-CDNl3Rd2.d.ts → helpers-B8RS-sa_.d.ts} +1 -1
- package/dist/{helpers-Akay-GZq.d.cts → helpers-CroApnZa.d.cts} +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +3 -3
- package/dist/index.d.ts +3 -3
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/internals.cjs +1 -1
- package/dist/internals.d.cts +5 -5
- package/dist/internals.d.ts +5 -5
- package/dist/internals.js +1 -1
- package/dist/plugins/index.d.cts +1 -1
- package/dist/plugins/index.d.ts +1 -1
- package/dist/{plugins-O-3VHejK.d.cts → plugins-day_qfBB.d.cts} +84 -1
- package/dist/{plugins-O-3VHejK.d.ts → plugins-day_qfBB.d.ts} +84 -1
- package/dist/system-4J3B25OD.cjs +2 -0
- package/dist/{system-CWUYJT43.cjs.map → system-4J3B25OD.cjs.map} +1 -1
- package/dist/system-5OAYXJIG.js +2 -0
- package/dist/{system-TM7ZQZYW.js.map → system-5OAYXJIG.js.map} +1 -1
- package/dist/testing.cjs +1 -1
- package/dist/testing.cjs.map +1 -1
- package/dist/testing.d.cts +81 -13
- package/dist/testing.d.ts +81 -13
- package/dist/testing.js +1 -1
- package/dist/testing.js.map +1 -1
- package/dist/worker.cjs +1 -1
- package/dist/worker.d.cts +1 -1
- package/dist/worker.d.ts +1 -1
- package/dist/worker.js +1 -1
- package/package.json +7 -1
- package/dist/chunk-4AN3P4W5.cjs +0 -3
- package/dist/chunk-4AN3P4W5.cjs.map +0 -1
- package/dist/chunk-GSXCAMNZ.js +0 -2
- package/dist/chunk-GSXCAMNZ.js.map +0 -1
- package/dist/chunk-MXIBBD7Z.js +0 -16
- package/dist/chunk-MXIBBD7Z.js.map +0 -1
- package/dist/chunk-PUZVNO5U.js +0 -3
- package/dist/chunk-PUZVNO5U.js.map +0 -1
- package/dist/chunk-SLHKLDQR.cjs +0 -16
- package/dist/chunk-SLHKLDQR.cjs.map +0 -1
- package/dist/chunk-WFIJ6OST.cjs +0 -2
- package/dist/chunk-WFIJ6OST.cjs.map +0 -1
- package/dist/system-CWUYJT43.cjs +0 -2
- package/dist/system-TM7ZQZYW.js +0 -2
package/dist/adapter-utils.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
'use strict';var
|
|
1
|
+
'use strict';var chunkKKHSUZA5_cjs=require('./chunk-KKHSUZA5.cjs'),chunkBEJ6ICA7_cjs=require('./chunk-BEJ6ICA7.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(chunkKKHSUZA5_cjs.f&&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}=chunkKKHSUZA5_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 chunkKKHSUZA5_cjs.c}});Object.defineProperty(exports,"getBridgeFact",{enumerable:true,get:function(){return chunkKKHSUZA5_cjs.b}});Object.defineProperty(exports,"requirementGuard",{enumerable:true,get:function(){return chunkKKHSUZA5_cjs.d}});Object.defineProperty(exports,"requirementGuardMultiple",{enumerable:true,get:function(){return chunkKKHSUZA5_cjs.e}});Object.defineProperty(exports,"setBridgeFact",{enumerable:true,get:function(){return chunkKKHSUZA5_cjs.a}});Object.defineProperty(exports,"shallowEqual",{enumerable:true,get:function(){return chunkBEJ6ICA7_cjs.d}});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
|
|
2
2
|
//# sourceMappingURL=adapter-utils.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/adapter-utils.ts"],"names":["computeInspectState","system","inspection","createThrottle","callback","ms","timeoutId","lastArgs","lastCallTime","args","now","timeSinceLastCall","assertSystem","hookName","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.cjs","sourcesContent":["/**\n * Shared Adapter Utilities\n *\n * Common types and helper functions used across all framework adapters.\n * @internal\n */\n\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 (process.env.NODE_ENV !== \"production\" && 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"]}
|
|
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.cjs","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/adapter-utils.d.cts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { o as Requirement, P as Plugin, F as Facts,
|
|
1
|
+
import { o as Requirement, P as Plugin, F as Facts, X as Schema, H as HistoryAPI, $ as SystemInspection, y as HistoryState } from './plugins-day_qfBB.cjs';
|
|
2
2
|
export { s as shallowEqual } from './utils-BnQajqPu.cjs';
|
|
3
3
|
|
|
4
4
|
/**
|
package/dist/adapter-utils.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { o as Requirement, P as Plugin, F as Facts,
|
|
1
|
+
import { o as Requirement, P as Plugin, F as Facts, X as Schema, H as HistoryAPI, $ as SystemInspection, y as HistoryState } from './plugins-day_qfBB.js';
|
|
2
2
|
export { s as shallowEqual } from './utils-BnQajqPu.js';
|
|
3
3
|
|
|
4
4
|
/**
|
package/dist/adapter-utils.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import {f,i}from'./chunk-LN4YQDLL.js';export{c as createCallbackPlugin,b as getBridgeFact,d as requirementGuard,e as requirementGuardMultiple,a as setBridgeFact}from'./chunk-LN4YQDLL.js';export{d as shallowEqual}from'./chunk-4CMO5OVZ.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(f&&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
|
|
2
2
|
//# sourceMappingURL=adapter-utils.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/adapter-utils.ts"],"names":["computeInspectState","system","inspection","createThrottle","callback","ms","timeoutId","lastArgs","lastCallTime","args","now","timeSinceLastCall","assertSystem","hookName","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 { 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 (process.env.NODE_ENV !== \"production\" && 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"]}
|
|
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"]}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import {f,l,k,i,j}from'./chunk-LN4YQDLL.js';import {c,b,a,e}from'./chunk-4CMO5OVZ.js';var we=class extends Error{constructor(A,R,q,g,S=true){super(A);this.source=R;this.sourceId=q;this.context=g;this.recoverable=S;this.name="DirectiveError";}};function Ze(){return {create(m){return m}}}function Ye(){return {create(m){return m}}}function Qe(m){return m}function et(m){return m}function vt(m){return m._mode==="single"}function yt(m){return m._mode==="namespaced"}function me(m){if(!m)return;let r=Object.assign(Object.create(null),m);return Array.isArray(r.tags)&&Object.freeze(r.tags),Object.freeze(r)}function xe(m){return typeof m=="object"&&m!==null&&Object.hasOwn(m,"compute")&&typeof m.compute=="function"}function tt(m){return typeof m=="boolean"?{enabled:m,maxSnapshots:100}:{enabled:true,maxSnapshots:m.maxSnapshots??100}}function Ae(m){let{historyOption:r,facts:A,store:R,onSnapshot:q,onHistoryChange:g}=m,{enabled:S,maxSnapshots:B}=tt(r),T=[],b=-1,_=1,P=false,V=false,I=[],M=null,C=-1;function W(){return R.toObject()}function K(){let U=W();try{return structuredClone(U)}catch{try{return JSON.parse(JSON.stringify(U))}catch{return {...U}}}}function Z(U){if(!c(U)){console.error("[Directive] Potential prototype pollution detected in snapshot data, skipping restore");return}R.batch(()=>{for(let[L,z]of Object.entries(U)){if(L==="__proto__"||L==="constructor"||L==="prototype"){console.warn(`[Directive] Skipping dangerous key "${L}" during fact restoration`);continue}A[L]=z;}});}return {get isEnabled(){return S},get isRestoring(){return V},get isPaused(){return P},get snapshots(){return [...T]},get currentIndex(){return b},takeSnapshot(U){if(!S||P)return {id:-1,timestamp:Date.now(),facts:{},trigger:U};let L={id:_++,timestamp:Date.now(),facts:K(),trigger:U};for(b<T.length-1&&T.splice(b+1),T.push(L),b=T.length-1;T.length>B;)T.shift(),b--;return q?.(L),L},restore(U){if(S){P=true,V=true;try{Z(U.facts);}finally{P=false,V=false;}}},goBack(U=1){if(!S||T.length===0)return;let L=b,z=b,f=I.find(u=>b>u.startIndex&&b<=u.endIndex);if(f)z=f.startIndex;else if(I.find(c=>b===c.startIndex)){let c=I.find(D=>D.endIndex<b&&b-D.endIndex<=U);z=c?c.startIndex:Math.max(0,b-U);}else z=Math.max(0,b-U);if(L===z)return;b=z;let i=T[b];i&&(this.restore(i),g?.(L,z));},goForward(U=1){if(!S||T.length===0)return;let L=b,z=b,f=I.find(u=>b>=u.startIndex&&b<u.endIndex);if(f?z=f.endIndex:z=Math.min(T.length-1,b+U),L===z)return;b=z;let i=T[b];i&&(this.restore(i),g?.(L,z));},goTo(U){if(!S)return;let L=T.findIndex(i=>i.id===U);if(L===-1){console.warn(`[Directive] Snapshot ${U} not found`);return}let z=b;b=L;let f=T[b];f&&(this.restore(f),g?.(z,L));},replay(){if(!S||T.length===0)return;b=0;let U=T[0];U&&this.restore(U);},export(){return JSON.stringify({version:1,snapshots:T,currentIndex:b})},import(U){if(S)try{let L=JSON.parse(U);if(typeof L!="object"||L===null)throw new Error("[Directive] Invalid history data: expected object");if(L.version!==1)throw new Error(`[Directive] Unsupported history export version: ${L.version}`);if(!Array.isArray(L.snapshots))throw new Error("[Directive] Invalid history data: snapshots must be an array");if(typeof L.currentIndex!="number")throw new Error("Invalid history data: currentIndex must be a number");for(let f of L.snapshots){if(typeof f!="object"||f===null)throw new Error("[Directive] Invalid snapshot: expected object");if(typeof f.id!="number"||typeof f.timestamp!="number"||typeof f.trigger!="string"||typeof f.facts!="object")throw new Error("Invalid snapshot structure");if(!c(f.facts))throw new Error("[Directive] Invalid fact data: potential prototype pollution detected in nested objects")}T.length=0,T.push(...L.snapshots),b=L.currentIndex;let z=T[b];z&&this.restore(z);}catch(L){console.error("[Directive] Failed to import history data:",L);}},beginChangeset(U){S&&(M=U,C=b);},endChangeset(){!S||M===null||(b>C&&I.push({label:M,startIndex:C,endIndex:b}),M=null,C=-1);},pause(){P=true;},resume(){P=false;}}}function je(){let m={id:-1,timestamp:0,facts:{},trigger:""};return {isEnabled:false,isRestoring:false,isPaused:false,snapshots:[],currentIndex:-1,takeSnapshot:()=>m,restore:()=>{},goBack:()=>{},goForward:()=>{},goTo:()=>{},replay:()=>{},export:()=>"{}",import:()=>{},beginChangeset:()=>{},endChangeset:()=>{},pause:()=>{},resume:()=>{}}}var $e=new WeakMap;function nt(m,r){if(r)return r(m);let A=$e.get(m);if(A!==void 0)return A;let{type:R,...q}=m,g=b(q),S=`${R}:${g}`;return $e.set(m,S),S}function Ie(m,r,A){return {requirement:m,id:nt(m,A),fromConstraint:r}}function Et(m){return r=>({type:m,...r})}function Mt(m,r){return m.type===r}function Ct(m){return r=>r.type===m}var De=class m{map=new Map;add(r){this.map.has(r.id)||this.map.set(r.id,r);}remove(r){return this.map.delete(r)}has(r){return this.map.has(r)}get(r){return this.map.get(r)}all(){return [...this.map.values()]}ids(){return [...this.map.keys()]}get size(){return this.map.size}clear(){this.map.clear();}clone(){let r=new m;for(let A of this.map.values())r.add(A);return r}diff(r){let A=[],R=[];for(let q of this.map.values())r.has(q.id)||A.push(q);for(let q of r.map.values())this.map.has(q.id)||R.push(q);return {added:A,removed:R}}};var rt=5e3;function Fe(m){let{definitions:r,facts:A,requirementKeys:R={},defaultTimeout:q=rt,onEvaluate:g,onError:S}=m,B=new Map,T=new Set,b=new Set,_=new Map,P=new Map,V=new Set,I=new Map,M=new Map,C=false,W=new Set,K=new Set,Z=new Map,ne=[],U=new Map;function L(t,a){r[t]&&(Z.has(t)||Z.set(t,new Set),Z.get(t).add(a));}function z(){Z.clear();for(let[t,a]of Object.entries(r))if(a.after)for(let v of a.after)L(v,t);}function f$1(t,a,v,O,H){if(v.has(t))return;if(O.has(t)){let de=a.indexOf(t),ge=[...a.slice(de),t].join(" \u2192 ");throw new Error(`[Directive] Constraint cycle detected: ${ge}. Remove one of the \`after\` dependencies to break the cycle.`)}O.add(t),a.push(t);let oe=r[t];if(oe?.after)for(let de of oe.after)r[de]&&f$1(de,a,v,O,H);a.pop(),O.delete(t),v.add(t),H.push(t);}function i$1(){let t=new Set,a=new Set,v=[];for(let O of Object.keys(r))f$1(O,[],t,a,v);ne=v,U=new Map(ne.map((O,H)=>[O,H]));}i$1(),z();function u(){for(let[t,a]of Object.entries(r))if(a.after)for(let v of a.after)r[v]||console.warn(`[Directive] Constraint "${t}" references unknown constraint "${v}" in \`after\`. This dependency will be ignored. Check for typos or ensure the constraint exists.`);}f&&u();function c(t,a){return a.async!==void 0?a.async:!!b.has(t)}function D(t){let a=r[t];if(!a)throw new Error(`[Directive] Unknown constraint: ${t}`);let v=c(t,a);v&&b.add(t);let O={id:t,priority:a.priority??0,isAsync:v,lastResult:null,isEvaluating:false,error:null,lastResolvedAt:null,after:a.after??[],hitCount:0,lastActiveAt:null};return B.set(t,O),O}function F(t){return B.get(t)??D(t)}function X(t,a){if(t.size!==a.size||t.size===0)return false;for(let v of a)if(!t.has(v))return false;return true}function fe(t,a){for(let v of a){let O=P.get(v);O&&(O.delete(t),O.size===0&&P.delete(v));}}function re(t,a){for(let v of a)P.has(v)||P.set(v,new Set),P.get(v).add(t);}function h(t){let a=_.get(t);a&&(fe(t,a),_.delete(t));}function E(t){Z.delete(t);for(let a of Z.values())a.delete(t);}function o(t,a){let v=_.get(t)??new Set;X(v,a)||(fe(t,v),re(t,a),_.set(t,a));}function w(t,a){if(a.deps)return I.set(t,new Set(a.deps)),a.when(A);let v=i(()=>a.when(A));return I.set(t,v.deps),v.value}function N(t,a,v){a.lastResult=v,v&&(a.hitCount++,a.lastActiveAt=Date.now()),a.isEvaluating=false,g?.(t,v);}function Y(t,a,v){a.error=v instanceof Error?v:new Error(String(v)),a.lastResult=false,a.isEvaluating=false,S?.(t,v);}function pe(t,a,v){return b.add(t),a.isAsync=true,f&&console.warn(`[Directive] Constraint "${t}" returned a Promise but was not marked as async. Add \`async: true\` to the constraint definition to avoid this warning and improve performance.`),v.then(O=>(N(t,a,O),O)).catch(O=>(Y(t,a,O),false))}function ye(t){let a=r[t];if(!a)return false;let v=F(t);v.isEvaluating=true,v.error=null;try{let O=w(t,a);return O instanceof Promise?pe(t,v,O):(N(t,v,O),O)}catch(O){return Y(t,v,O),false}}async function j(t){let a$1=r[t];if(!a$1)return false;let v=F(t),O=a$1.timeout??q;if(v.isEvaluating=true,v.error=null,a$1.deps?.length){let H=new Set(a$1.deps);o(t,H),I.set(t,H);}try{let H=a$1.when(A),oe=await a(H,O,`Constraint "${t}" timed out after ${O}ms`);return v.lastResult=oe,oe&&(v.hitCount++,v.lastActiveAt=Date.now()),v.isEvaluating=!1,g?.(t,oe),oe}catch(H){return v.error=H instanceof Error?H:new Error(String(H)),v.lastResult=false,v.isEvaluating=false,S?.(t,H),false}}let ee=10;function ve(t,a){if(t==null)return [];if(Array.isArray(t)){let v=t.filter(O=>O!=null);return f&&v.length>ee&&a&&console.warn(`[Directive] Constraint "${a}" produced ${v.length} requirements. Consider splitting into multiple constraints for better performance.`),v}return [t]}function Re(t){let a=r[t];if(!a)return {requirements:[],deps:new Set};let v=a.require;if(typeof v=="function"){let{value:H,deps:oe}=i(()=>v(A));return {requirements:ve(H,t),deps:oe}}return {requirements:ve(v,t),deps:new Set}}function he(t,a){if(a.size===0)return;let v=_.get(t)??new Set;for(let O of a)v.add(O);re(t,a),_.set(t,v);}let Se=null;function s(){return Se||(Se=Object.keys(r).sort((t,a)=>{let v=F(t),H=F(a).priority-v.priority;if(H!==0)return H;let oe=U.get(t)??0,de=U.get(a)??0;return oe-de})),Se}for(let t of Object.keys(r))D(t);function y(t){for(let[a,v]of Object.entries(t))v.async&&!v.deps&&console.warn(`[Directive] Async constraint "${a}" has no \`deps\` declared. Auto-tracking cannot work across async boundaries. Add \`deps: ["key1", "key2"]\` to enable dependency tracking.`);}f&&y(r);function p(t){return !r[t]||T.has(t)||K.has(t)?true:W.has(t)}function $(t){let a=B.get(t);if(!a||a.after.length===0)return true;for(let v of a.after)if(!p(v))return false;return true}function e(t){let a=I.get(t);a!==void 0&&o(t,a),K.add(t),M.set(t,[]);}function n(t,a,v){if(a!==void 0){let O=new Set(a);for(let H of v)O.add(H);o(t,O);}else he(t,v);}function l(t,a,v){if(a.length===0){M.set(t,[]);return}let O=a.map(H=>Ie(H,t,R[H.type]));for(let H of O)v.add(H);M.set(t,O);}function d(t,a){for(let v of t)a.add(v);}function k(t,a,v){if(T.has(t))return;if(!a){e(t);return}K.delete(t);let O=I.get(t),H,oe;try{let de=Re(t);H=de.requirements,oe=de.deps;}catch(de){S?.(t,de),e(t);return}n(t,O,oe),l(t,H,v);}function x(t,a){let v=[],O=[];for(let H of t){if($(H)){O.push(H);continue}v.push(H);let oe=M.get(H);oe&&d(oe,a);}return {blocked:v,ready:O}}function G(t,a){let v=[];for(let O of t){let H=ye(O);if(H instanceof Promise){v.push({id:O,promise:H});continue}k(O,H,a);}return v}async function Q(t,a){let v=await Promise.all(t.map(async({id:O,promise:H})=>({id:O,active:await H})));for(let{id:O,active:H}of v)k(O,H,a);}async function te(t,a){let{blocked:v,ready:O}=x(t,a);if(O.length===0)return v;let H=[],oe=[];for(let ge of O)F(ge).isAsync?oe.push(ge):H.push(ge);let de=G(H,a);if(de.length>0&&await Q(de,a),oe.length>0){let ge=oe.map(ke=>({id:ke,promise:j(ke)}));await Q(ge,a);}return v}function J(t,a){for(let v of t){let O=P.get(v);if(O)for(let H of O)T.has(H)||a.add(H);}}function ie(t){for(let a of V)T.has(a)||t.add(a);V.clear();}function se(t){let a=new Set;return J(t,a),ie(a),a}function le(t,a,v){for(let O of t){if(a.has(O))continue;let H=M.get(O);H&&d(H,v);}}return {async evaluate(t){let a=new De;K.clear();let v=s(),O=T.size===0?v:v.filter(ge=>!T.has(ge)),H;if(!C||!t||t.size===0)H=O,C=true;else {let ge=se(t);H=[...ge],le(O,ge,a);}let oe=H,de=H.length+1;for(;oe.length>0&&de>0;){let ge=oe.length;if(oe=await te(oe,a),oe.length===ge)break;de--;}return a.all()},getState(t){return B.get(t)},getDependencies(t){return _.get(t)},getAllStates(){return [...B.values()]},disable(t){if(!B.has(t)){console.warn(`[Directive] constraints.disable("${t}") \u2014 no such constraint`);return}T.add(t),Se=null,M.delete(t),h(t),I.delete(t);},enable(t){if(!B.has(t)){console.warn(`[Directive] constraints.enable("${t}") \u2014 no such constraint`);return}T.delete(t),Se=null,V.add(t);},isDisabled(t){return T.has(t)},invalidate(t){let a=P.get(t);if(a)for(let v of a)V.add(v);},markResolved(t){W.add(t);let a=B.get(t);a&&(a.lastResolvedAt=Date.now());let v=Z.get(t);if(v)for(let O of v)V.add(O);},isResolved(t){return W.has(t)},registerDefinitions(t){let a=false;for(let[v,O]of Object.entries(t))r[v]=O,D(v),V.add(v),O.after?.length&&(a=true);Se=null,a&&i$1(),z();},assignDefinition(t,a){if(!r[t])throw new Error(`[Directive] Cannot assign constraint "${t}" \u2014 it does not exist. Use register() to create it.`);r[t]=a,D(t),V.add(t),Se=null,i$1(),z();},unregisterDefinition(t){r[t]&&(delete r[t],B.delete(t),T.delete(t),b.delete(t),V.delete(t),K.delete(t),W.delete(t),M.delete(t),I.delete(t),h(t),E(t),Se=null,i$1(),z());},async callOne(t,a){if(!r[t])throw new Error(`[Directive] Cannot call constraint "${t}" \u2014 it does not exist.`);if(T.has(t))return [];let O=F(t),H;if(O.isAsync)H=await j(t);else {let ge=ye(t);H=ge instanceof Promise?await ge:ge;}if(!H)return [];let{requirements:oe}=Re(t);if(oe.length===0)return [];let de=[];for(let ge of oe){let ke=a?{...ge,...a}:ge;de.push(Ie(ke,t,R[ke.type]));}return de},setRequirementKey(t,a){R[t]=a;},removeRequirementKey(t){delete R[t];}}}function Ke(m){let{definitions:r,facts:A,onCompute:R,onInvalidate:q,onError:g}=m,S=3,B=new Map;for(let[h,E]of Object.entries(r))if(xe(E)){r[h]=E.compute;let o=me(E.meta);o&&B.set(h,o);}let T=new Map,b=new Map,_=new Map,P=new Map,V=0,I=new Set,M=false,C=100,W;function K(h,E){let o=T.has(h)?P:_,w=o.get(h);w?.delete(E),w&&w.size===0&&o.delete(h);}function Z(h,E){let o=r[h]?P:_,w=o.get(h);w||(w=new Set,o.set(h,w)),w.add(E);}function ne(h){let E=T.get(h);if(E)for(let o of E.dependencies)K(o,h);}function U(h){let E=P.get(h);if(E){V++;try{for(let o of E)fe(o);}finally{V--;}P.delete(h);}}function L(h){delete r[h],T.delete(h),b.delete(h),I.delete(h),B.delete(h);}function z(h){if(!r[h])throw new Error(`[Directive] Unknown derivation: ${h}`);let o={id:h,compute:()=>i$1(h),cachedValue:void 0,dependencies:new Set,isStale:true,isComputing:false,stableRunCount:0,depsStable:false};return T.set(h,o),o}function f(h){return T.get(h)??z(h)}function i$1(h){let E=f(h),o=r[h];if(!o)throw new Error(`[Directive] Unknown derivation: ${h}`);if(E.isComputing)throw new Error(`[Directive] Circular dependency detected in derivation: ${h}`);E.isComputing=true;try{let w=E.cachedValue,N,Y;if(E.depsStable&&E.dependencies.size>0)N=o(A,W),Y=E.dependencies;else {let pe=i(()=>o(A,W));N=pe.value,Y=pe.deps,E.dependencies.size>0&&u(Y,E.dependencies)?(E.stableRunCount++,E.stableRunCount>=S&&(E.depsStable=!0)):E.stableRunCount=0;}return E.cachedValue=N,E.isStale=!1,c(h,Y),R&&R(h,N,w,[...Y]),N}catch(w){throw g?.(h,w),w}finally{E.isComputing=false;}}function u(h,E){if(h.size!==E.size)return false;for(let o of E)if(!h.has(o))return false;return true}function c(h,E){let o=f(h),w=o.dependencies;if(!u(w,E)){for(let N of w)K(N,h);for(let N of E)Z(N,h);o.dependencies=E;}}function D(h){for(let E of h){let o=b.get(E);if(o)for(let w of o)w();}}function F(){if(!(V>0||M)){M=true;try{let h=0;for(;I.size>0;){if(++h>C){let o=[...I];throw I.clear(),new Error(`[Directive] Infinite derivation notification loop detected after ${C} iterations. Remaining: ${o.join(", ")}. This usually means a derivation listener is mutating facts that re-trigger the same derivation.`)}let E=[...I];I.clear(),D(E);}}finally{M=false;}}}function X(h,E){let o=P.get(h);if(o)for(let w of o)E.push(w);}function fe(h,E=new Set){let o=[h];for(;o.length>0;){let w=o.pop();if(E.has(w))continue;E.add(w);let N=T.get(w);!N||N.isStale||(N.isStale=true,N.depsStable=false,N.stableRunCount=0,q?.(w),I.add(w),X(w,o));}}return W=new Proxy({},{get(h,E){if(typeof E=="symbol"||l.has(E)||!r[E])return;k(E);let o=f(E);return o.isStale&&i$1(E),o.cachedValue},set(){return false},deleteProperty(){return false},defineProperty(){return false},getPrototypeOf(){return null},setPrototypeOf(){return false}}),{get(h){let E=f(h);return E.isStale&&i$1(h),E.cachedValue},isStale(h){return T.get(h)?.isStale??true},invalidate(h){let E=_.get(h);if(!E)return;V++;let o=new Set;try{for(let w of E)fe(w,o);}finally{V--,F();}},invalidateMany(h){V++;let E=new Set;try{for(let o of h){let w=_.get(o);if(w)for(let N of w)fe(N,E);}}finally{V--,F();}},invalidateAll(){V++;try{for(let h of T.values())h.isStale||(h.isStale=!0,h.depsStable=!1,h.stableRunCount=0,I.add(h.id));}finally{V--,F();}},subscribe(h,E){for(let o of h){let w=o;b.has(w)||b.set(w,new Set),b.get(w).add(E);}return ()=>{for(let o of h){let w=o,N=b.get(w);N?.delete(E),N&&N.size===0&&b.delete(w);}}},getProxy(){return W},getDependencies(h){return f(h).dependencies},registerDefinitions(h){for(let[E,o]of Object.entries(h)){if(xe(o)){r[E]=o.compute;let w=me(o.meta);w&&B.set(E,w);}else r[E]=o;z(E);}},assignDefinition(h,E){if(!r[h])throw new Error(`[Directive] Cannot assign derivation "${h}" \u2014 it does not exist. Use register() to create it.`);if(xe(E)){r[h]=E.compute;let w=me(E.meta);w?B.set(h,w):B.delete(h);}else r[h]=E;let o=T.get(h);o&&(o.isStale=true,o.depsStable=false,o.stableRunCount=0,I.add(h)),F();},unregisterDefinition(h){r[h]&&(ne(h),U(h),L(h),F());},getMeta(h){return B.get(h)},callOne(h){if(!r[h])throw new Error(`[Directive] Cannot call derivation "${h}" \u2014 it does not exist.`);return i$1(h)}}}var it=3;function Be(m){let{definitions:r,facts:A,store:R,onRun:q,onError:g}=m,S=new Map,B=null,T=false;function b(f){let i=r[f];if(!i)throw new Error(`[Directive] Unknown effect: ${f}`);let u={id:f,enabled:true,hasExplicitDeps:!!i.deps,dependencies:i.deps?new Set(i.deps):null,cleanup:null,stableRunCount:0,depsStable:false};return S.set(f,u),u}function _(f){return S.get(f)??b(f)}function P(){return R.toObject()}function V(f){f.depsStable=false,f.stableRunCount=0;}function I(f,i){for(let u of f)if(i.has(u))return true;return false}function M(f,i){let u=_(f);return u.enabled?u.dependencies?I(u.dependencies,i)?(u.depsStable&&V(u),true):false:true:false}function C(f){if(f.cleanup){try{f.cleanup();}catch(i){g?.(f.id,i),console.error(`[Directive] Effect "${f.id}" cleanup threw an error:`,i);}f.cleanup=null;}}function W(f,i){if(typeof i=="function")if(T)try{i();}catch(u){g?.(f.id,u),console.error(`[Directive] Effect "${f.id}" cleanup threw an error:`,u);}else f.cleanup=i;}async function K(f,i){let u;if(R.batch(()=>{u=i.run(A,B);}),u instanceof Promise){let c=await u;W(f,c);}else W(f,u);}function Z(f,i){if(f.size!==i.size)return false;for(let u of i)if(!f.has(u))return false;return true}function ne(f,i){if(!(f.dependencies&&Z(f.dependencies,i))){V(f);return}f.stableRunCount++,f.stableRunCount>=it&&(f.depsStable=true);}async function U(f,i$1){if(f.depsStable&&f.dependencies){await K(f,i$1);return}let u,c=i(()=>(R.batch(()=>{u=i$1.run(A,B);}),u)),D=c.deps,F=c.value;F instanceof Promise&&(F=await F),W(f,F),ne(f,D),f.dependencies=D.size>0?D:null;}async function L(f){let i=_(f),u=r[f];if(!(!i.enabled||!u)){C(i),q?.(f,i.dependencies?[...i.dependencies]:[]);try{i.hasExplicitDeps?await K(i,u):await U(i,u);}catch(c){g?.(f,c),console.error(`[Directive] Effect "${f}" threw an error:`,c),i.hasExplicitDeps||V(i);}}}for(let f of Object.keys(r))b(f);return {async runEffects(f){let i=[];for(let u of Object.keys(r))M(u,f)&&i.push(u);await Promise.all(i.map(L)),B=P();},async runAll(){let f=Object.keys(r);await Promise.all(f.map(i=>{let u=_(i);return u.enabled?(V(u),L(i)):Promise.resolve()})),B=P();},disable(f){let i=_(f);i.enabled=false;},enable(f){let i=_(f);i.enabled=true;},isEnabled(f){return _(f).enabled},cleanupAll(){T=true;for(let f of S.values())C(f);},registerDefinitions(f){for(let[i,u]of Object.entries(f))r[i]=u,b(i);},assignDefinition(f,i){if(!r[f])throw new Error(`[Directive] Cannot assign effect "${f}" \u2014 it does not exist. Use register() to create it.`);let u=S.get(f);u&&C(u),r[f]=i,b(f);},unregisterDefinition(f){if(!r[f])return;let i=S.get(f);i&&C(i),delete r[f],S.delete(f);},async callOne(f){let i=r[f];if(!i)throw new Error(`[Directive] Cannot call effect "${f}" \u2014 it does not exist.`);let u=_(f);if(u.enabled){C(u),q?.(f,u.dependencies?[...u.dependencies]:[]);try{let c;if(R.batch(()=>{c=i.run(A,B);}),c instanceof Promise){let D=await c;W(u,D);}else W(u,c);}catch(c){g?.(f,c),console.error(`[Directive] Effect "${f}" threw an error:`,c);}}}}}function st(m={}){let{delayMs:r=1e3,maxRetries:A=3,backoffMultiplier:R=2,maxDelayMs:q=3e4}=m,g=new Map;function S(B){let T=r*R**(B-1);return Math.min(T,q)}return {scheduleRetry(B,T,b,_,P){if(_>A)return null;let V=S(_),I={source:B,sourceId:T,context:b,attempt:_,nextRetryTime:Date.now()+V,callback:P};return g.set(T,I),I},getPendingRetries(){return Array.from(g.values())},processDueRetries(){let B=Date.now(),T=[];for(let[b,_]of g)_.nextRetryTime<=B&&(T.push(_),g.delete(b));return T},cancelRetry(B){g.delete(B);},clearAll(){g.clear();}}}var ot={constraint:"skip",resolver:"skip",effect:"skip",derivation:"skip",system:"throw"};function _e(m={}){let{config:r={},onError:A,onRecovery:R}=m,q=[],g=100,S=st(r.retryLater),B=new Map,T=1e3;function b(M,C,W,K){if(W instanceof we)return W;let Z=W instanceof Error?W.message:String(W),ne=M!=="system";return new we(Z,M,C,K,ne)}function _(M,C,W){let K=(()=>{switch(M){case "constraint":return r.onConstraintError;case "resolver":return r.onResolverError;case "effect":return r.onEffectError;case "derivation":return r.onDerivationError;default:return}})();if(typeof K=="function"){try{let Z=K(W,C);if(typeof Z=="string")return Z}catch(Z){console.error("[Directive] Error in error handler callback:",Z);}return "skip"}return typeof K=="string"?K:ot[M]}function P(M){q.push(M),q.length>g&&q.shift();try{A?.(M);}catch(C){console.error("[Directive] Error in onError callback:",C);}try{r.onError?.(M);}catch(C){console.error("[Directive] Error in config.onError callback:",C);}}function V(M,C,W){let K=(B.get(C)??0)+1;if(B.set(C,K),B.size>T){let ne=B.keys().next().value;ne!==void 0&&B.delete(ne);}return S.scheduleRetry(M,C,W,K)?"retry-later":(B.delete(C),typeof process<"u"&&process.env?.NODE_ENV!=="production"&&console.warn(`[Directive] ${M} "${C}" exceeded max retry-later attempts. Skipping.`),"skip")}return {handleError(M,C,W,K){let Z=b(M,C,W,K);P(Z);let ne=_(M,C,W instanceof Error?W:new Error(String(W)));ne==="retry-later"&&(ne=V(M,C,K));try{R?.(Z,ne);}catch(U){console.error("[Directive] Error in onRecovery callback:",U);}if(ne==="throw")throw Z;return ne},getLastError(){return q[q.length-1]??null},getAllErrors(){return [...q]},clearErrors(){q.length=0;},getRetryLaterManager(){return S},processDueRetries(){return S.processDueRetries()},clearRetryAttempts(M){B.delete(M),S.cancelRetry(M);}}}function at(m,r=100){try{return JSON.stringify(m)?.slice(0,r)??String(m)}catch{return "[circular or non-serializable]"}}function ct(m){let{schema:r,onChange:A,onBatch:R}=m,g=Object.keys(r).length===0,S=m.validate??f,B=m.strictKeys??(f&&!g),T=m.redactErrors??false,b=new Map,_=new Set,P=new Map,V=new Set,I=0,M=[],C=new Set,W=false,K=[],Z=100;function ne(o){return o!==null&&typeof o=="object"&&"safeParse"in o&&typeof o.safeParse=="function"&&"_def"in o&&"parse"in o&&typeof o.parse=="function"}function U(o){let w=o;if(w._typeName)return w._typeName;if(ne(o)){let N=o._def;if(N?.typeName)return N.typeName.replace(/^Zod/,"").toLowerCase()}return "unknown"}function L(o){return T?"[redacted]":at(o)}function z(o){return o===null?"null":Array.isArray(o)?"array":typeof o}function f$1(o,w,N){let Y=N.safeParse(w);if(Y.success)return;let pe=z(w),ye=L(w),j=Y.error?.message??Y.error?.issues?.[0]?.message??"Validation failed",ee=U(N);throw new Error(`[Directive] Validation failed for "${o}": expected ${ee}, got ${pe} ${ye}. ${j}`)}function i(o){if(typeof o._lastFailedIndex=="number"&&o._lastFailedIndex>=0){let w=` (element at index ${o._lastFailedIndex} failed)`;return o._lastFailedIndex=-1,w}return ""}function u(o,w,N){let Y=N._validators;if(!Y||!Array.isArray(Y)||Y.length===0)return;let pe=N._typeName??"unknown";for(let ye=0;ye<Y.length;ye++){let j=Y[ye];if(typeof j!="function"||j(w))continue;let ee=z(w),ve=L(w),Re=i(N),he=ye===0?"":` (validator ${ye+1} failed)`;throw new Error(`[Directive] Validation failed for "${o}": expected ${pe}, got ${ee} ${ve}${he}${Re}`)}}function c(o){if(B)throw new Error(`[Directive] Unknown fact key: "${o}". Key not defined in schema.`);console.warn(`[Directive] Unknown fact key: "${o}"`);}function D(o,w){if(!S)return;let N=r[o];if(!N){c(o);return}if(ne(N)){f$1(o,w,N);return}u(o,w,N);}function F(o){P.get(o)?.forEach(w=>w());}function X(){V.forEach(o=>o());}function fe(o,w,N){if(W){K.push({key:o,value:w,prev:N});return}W=true;try{A?.(o,w,N),F(o),X(),re(". A listener is repeatedly mutating facts that re-trigger notifications");}finally{W=false;}}function re(o){let w=0;for(;K.length>0;){if(++w>Z)throw K.length=0,new Error(`[Directive] Infinite notification loop detected after ${Z} iterations${o}.`);let N=[...K];K.length=0;for(let Y of N)A?.(Y.key,Y.value,Y.prev),F(Y.key);X();}}function h(){if(!(I>0)){if(R&&M.length>0&&R([...M]),C.size>0){W=true;try{for(let o of C)F(o);X(),re(" during flush");}finally{W=false;}}M.length=0,C.clear();}}let E={get(o){return k(o),b.get(o)},has(o){return k(o),b.has(o)},set(o,w){f&&D(o,w);let N=b.get(o);Object.is(N,w)||(b.set(o,w),_.add(o),I>0?(M.push({key:o,value:w,prev:N,type:"set"}),C.add(o)):fe(o,w,N));},delete(o){let w=b.get(o);b.delete(o),_.delete(o),I>0?(M.push({key:o,value:void 0,prev:w,type:"delete"}),C.add(o)):fe(o,void 0,w);},batch(o){I++;try{o();}finally{I--,h();}},subscribe(o,w){for(let N of o){let Y=N;P.has(Y)||P.set(Y,new Set),P.get(Y).add(w);}return ()=>{for(let N of o){let Y=P.get(N);Y&&(Y.delete(w),Y.size===0&&P.delete(N));}}},subscribeAll(o){return V.add(o),()=>V.delete(o)},toObject(){let o={};for(let w of _)b.has(w)&&(o[w]=b.get(w));return o}};return E.destroy=()=>{P.clear(),V.clear();},E.registerKeys=o=>{for(let w of Object.keys(o))l.has(w)||(r[w]=o[w],_.add(w));},E}var Te=new WeakMap;function We(m,r,A=r){return new Proxy(m,{get(R,q){if(typeof q=="string"&&l.has(q))return;let g=Reflect.get(R,q);if(typeof q=="symbol"||typeof g!="object"||g===null)return g;if(Te.has(g))return Te.get(g);let S=We(g,r,`${A}.${String(q)}`);return Te.set(g,S),S},set(R,q,g){return typeof q!="symbol"&&console.warn(`[Directive] Nested mutation on "facts.${A}.${String(q)}" will not trigger reactivity. Use: facts.${r} = { ...facts.${r}, ... }`),Reflect.set(R,q,g)}})}function lt(m,r){let A=()=>({get:q=>j(()=>m.get(q)),has:q=>j(()=>m.has(q))});return new Proxy({},{get(q,g){if(typeof g=="symbol"||l.has(g))return;if(g==="$store")return m;if(g==="$snapshot")return A;let S=m.get(g);return f&&S!==null&&typeof S=="object"?We(S,g):S},set(q,g,S){return typeof g=="symbol"||g==="$store"||g==="$snapshot"||l.has(g)?false:(m.set(g,S),true)},deleteProperty(q,g){return typeof g=="symbol"||g==="$store"||g==="$snapshot"||l.has(g)?false:(m.delete(g),true)},has(q,g){return g==="$store"||g==="$snapshot"?true:typeof g=="symbol"||l.has(g)?false:m.has(g)},ownKeys(){return Object.keys(r)},getOwnPropertyDescriptor(q,g){return g==="$store"||g==="$snapshot"?{configurable:true,enumerable:false,writable:false}:{configurable:true,enumerable:true,writable:true}},defineProperty(){return false},getPrototypeOf(){return null},setPrototypeOf(){return false}})}function ze(m){let r=ct(m),A=lt(r,m.schema);return {store:r,facts:A}}function Ne(){let m=[];function r(g){if(g)try{return g()}catch(S){console.error("[Directive] Plugin error:",S);return}}async function A(g){if(g)try{return await g()}catch(S){console.error("[Directive] Plugin error:",S);return}}function R(g){return (...S)=>{for(let B of m)r(()=>B[g]?.(...S));}}return {register(g){m.some(S=>S.name===g.name)&&(console.warn(`[Directive] Plugin "${g.name}" is already registered, replacing...`),this.unregister(g.name)),m.push(g);},unregister(g){let S=m.findIndex(B=>B.name===g);S!==-1&&m.splice(S,1);},getPlugins(){return [...m]},async emitInit(g){for(let S of m)await A(()=>S.onInit?.(g));},emitStart:R("onStart"),emitStop:R("onStop"),emitDestroy:R("onDestroy"),emitFactSet:R("onFactSet"),emitFactDelete:R("onFactDelete"),emitFactsBatch:R("onFactsBatch"),emitDerivationCompute:R("onDerivationCompute"),emitDerivationInvalidate:R("onDerivationInvalidate"),emitReconcileStart:R("onReconcileStart"),emitReconcileEnd:R("onReconcileEnd"),emitConstraintEvaluate:R("onConstraintEvaluate"),emitConstraintError:R("onConstraintError"),emitRequirementCreated:R("onRequirementCreated"),emitRequirementMet:R("onRequirementMet"),emitRequirementCanceled:R("onRequirementCanceled"),emitResolverStart:R("onResolverStart"),emitResolverComplete:R("onResolverComplete"),emitResolverError:R("onResolverError"),emitResolverRetry:R("onResolverRetry"),emitResolverCancel:R("onResolverCancel"),emitEffectRun:R("onEffectRun"),emitEffectError:R("onEffectError"),emitSnapshot:R("onSnapshot"),emitHistoryNavigate:R("onHistoryNavigate"),emitError:R("onError"),emitErrorRecovery:R("onErrorRecovery"),emitDefinitionRegister:R("onDefinitionRegister"),emitDefinitionAssign:R("onDefinitionAssign"),emitDefinitionUnregister:R("onDefinitionUnregister"),emitDefinitionCall:R("onDefinitionCall"),emitTraceComplete:R("onTraceComplete")}}var He={attempts:1,backoff:"none",initialDelay:100,maxDelay:3e4},Le={enabled:false,windowMs:50};function ut(m,r){let{backoff:A,initialDelay:R=100,maxDelay:q=3e4}=m,g;switch(A){case "none":g=R;break;case "linear":g=R*r;break;case "exponential":g=R*2**(r-1);break;default:g=R;}return Math.max(1,Math.min(g,q))}function ft(m){if(f)for(let[r,A]of Object.entries(m)){if(!A.resolve&&!A.resolveBatch&&!A.resolveBatchWithResults)throw new Error(`[Directive] Resolver "${r}" must define either resolve() or resolveBatch(). Add one of these methods to handle requirements.`);if(!(!A.batch?.enabled||A.resolveBatch||A.resolveBatchWithResults))if(A.resolve)console.warn(`[Directive] Resolver "${r}" has batch.enabled but no resolveBatch(). Falling back to individual resolve() calls. Add resolveBatch() for true bulk operations.`);else throw new Error(`[Directive] Resolver "${r}" has batch.enabled=true but no resolve(), resolveBatch(), or resolveBatchWithResults() method.`)}}function Ve(m){let{definitions:r,facts:A,store:R,onStart:q,onComplete:g,onError:S,onRetry:B,onCancel:T,onResolutionComplete:b}=m;ft(r);let _=new Map,P=new Map,V=1e3,I=new Map,M=new Map,C=1e3;function W(){if(P.size>V){let s=P.size-V,y=P.keys();for(let p=0;p<s;p++){let $=y.next().value;$&&P.delete($);}}}function K(s){return typeof s=="object"&&s!==null&&"requirement"in s&&typeof s.requirement=="string"}function Z(s){return typeof s=="object"&&s!==null&&"requirement"in s&&typeof s.requirement=="function"}function ne(s,y){return K(s)?y.type===s.requirement:Z(s)?s.requirement(y):false}function U(s,y){let p=M.get(s);if(!p)return null;M.delete(s),M.set(s,p);for(let $ of p){let e=r[$];if(e&&ne(e,y))return $}return null}function L(s,y){if(!M.has(s)){if(M.size>=C){let p=M.keys().next().value;p!==void 0&&M.delete(p);}M.set(s,new Set);}M.get(s).add(y);}function z(s){let y=s.type,p=U(y,s);if(p)return p;for(let[$,e]of Object.entries(r))if(ne(e,s))return L(y,$),$;return null}function f$1(s){return {facts:A,signal:s,snapshot:()=>A.$snapshot()}}async function i(s,y,p,$){let e=s instanceof Error?s:new Error(String(s));if($.signal.aborted)return {action:"abort",error:e};if(p.shouldRetry&&!p.shouldRetry(e,y))return {action:"break",error:e};if(y<p.attempts){if($.signal.aborted)return {action:"abort",error:e};let n=ut(p,y);if(await new Promise(l=>{let d=setTimeout(l,n),k=()=>{clearTimeout(d),l();};$.signal.addEventListener("abort",k,{once:true});}),$.signal.aborted)return {action:"abort",error:e}}return {action:"continue",error:e}}async function u(s,y,p,$){if(!s.resolve)return;let e;R.batch(()=>{e=s.resolve(p.requirement,f$1($));});let n=s.timeout;if(n&&n>0){await a(e,n,`Resolver "${y}" timed out after ${n}ms`);return}await e;}function c(s,y,p){let $=Date.now()-p;P.set(y.id,{state:"success",requirementId:y.id,completedAt:Date.now(),duration:$}),W(),g?.(s,y,$);}function D(s,y,p,$){P.set(y.id,{state:"error",requirementId:y.id,error:p,failedAt:Date.now(),attempts:$}),W(),S?.(s,y,p);}function F(s,y,p){let $=_.get(s);$&&($.attempt=y,$.status={state:"running",requirementId:s,startedAt:p,attempt:y});}async function X(s,y,p,$,e){let n=await i(s,y,p,$);return n.action==="continue"&&y<p.attempts&&e(y+1),{lastError:n.error,shouldContinue:n.action==="continue"}}async function fe(s,y,p){let $=r[s];if(!$)return;let e={...He,...$.retry},n=null,l=_.get(y.id)?.startedAt??Date.now();for(let d=1;d<=e.attempts;d++){if(p.signal.aborted)return;F(y.id,d,l);try{await u($,s,y,p.signal),c(s,y,l);return}catch(k){let x=await X(k,d,e,p,G=>B?.(s,y,G));if(n=x.lastError,!x.shouldContinue)break}}D(s,y,n,e.attempts);}async function re(s,y,p){return y&&y>0?a(s,y,p):s}async function h(s,y,p,$,e,n,l,d){let k;R.batch(()=>{k=s.resolveBatchWithResults($,e);});let x=await re(k,n,`Batch resolver "${y}" timed out after ${n}ms`);if(x.length!==p.length)throw new Error(`[Directive] Batch resolver "${y}" returned ${x.length} results but expected ${p.length}. Results array must match input order.`);let G=false;for(let Q=0;Q<p.length;Q++){let te=p[Q],J=x[Q];if(J.success){c(y,te,l);continue}G=true;let ie=J.error??new Error("Batch item failed");P.set(te.id,{state:"error",requirementId:te.id,error:ie,failedAt:Date.now(),attempts:d}),S?.(y,te,ie);}return !G||p.some((Q,te)=>x[te]?.success)?"done":"retry"}async function E(s,y,p,$,e,n,l){let d;R.batch(()=>{d=s.resolveBatch($,e);}),await re(d,n,`Batch resolver "${y}" timed out after ${n}ms`);for(let k of p)c(y,k,l);}function o(s,y,p,$){for(let e of y)D(s,e,p,$);}async function w(s,y){await Promise.all(y.map(p=>{let $=new AbortController;return fe(s,p,$)}));}async function N(s,y,p,$,e,n,l){let d=f$1($),k=p.map(x=>x.requirement);return s.resolveBatchWithResults?h(s,y,p,k,d,e,n,l):(await E(s,y,p,k,d,e,n),"done")}function Y(s,y,p){for(let $ of y)B?.(s,$,p);}async function pe(s,y,p,$,e){let n=new AbortController,l=Date.now(),d=null;for(let k=1;k<=$.attempts;k++){if(n.signal.aborted)return null;try{if(await N(s,y,p,n.signal,e,l,k)==="done")return null}catch(x){let G=await X(x,k,$,n,Q=>Y(y,p,Q));if(d=G.lastError,!G.shouldContinue)break}}return d}async function ye(s,y){let p=r[s];if(!p)return;if(!p.resolveBatch&&!p.resolveBatchWithResults){await w(s,y);return}let $={...He,...p.retry},n={...Le,...p.batch}.timeoutMs??p.timeout,l=await pe(p,s,y,$,n);l&&o(s,y,l,$.attempts);}let j=1e4;function ee(s){s.timer&&(clearTimeout(s.timer),s.timer=null);}function ve(s){return I.has(s)||I.set(s,{resolverId:s,requirements:[],timer:null}),I.get(s)}function Re(s,y){let p=r[s];if(!p)return;let $={...Le,...p.batch},e=ve(s),n=$.maxSize||j;if(e.requirements.length>=n&&(ee(e),he(s)),e.requirements.push(y),$.maxSize&&e.requirements.length>=$.maxSize){ee(e),he(s);return}ee(e),e.timer=setTimeout(()=>{he(s);},$.windowMs);}function he(s){let y=I.get(s);if(!y||y.requirements.length===0)return;let p=[...y.requirements];y.requirements=[],y.timer=null,ye(s,p).then(()=>{b?.();});}return {resolve(s){if(_.has(s.id))return;let y=z(s.requirement);if(!y){f&&console.warn(`[Directive] No resolver found for requirement type "${s.requirement.type}" (id: ${s.id})`);return}let p=r[y];if(!p)return;if(p.batch?.enabled){Re(y,s);return}let $=new AbortController,e=Date.now(),n={requirementId:s.id,resolverId:y,controller:$,startedAt:e,attempt:1,status:{state:"pending",requirementId:s.id,startedAt:e},originalRequirement:s};_.set(s.id,n),q?.(y,s),fe(y,s,$).finally(()=>{_.delete(s.id)&&b?.();});},cancel(s){let y=_.get(s);if(y){y.controller.abort(),_.delete(s),P.set(s,{state:"canceled",requirementId:s,canceledAt:Date.now()}),W(),T?.(y.resolverId,y.originalRequirement);return}for(let p of I.values()){let $=p.requirements.findIndex(e=>e.id===s);if($!==-1){let[e]=p.requirements.splice($,1);P.set(s,{state:"canceled",requirementId:s,canceledAt:Date.now()}),W(),e&&T?.(p.resolverId,e);return}}},cancelAll(){let s=[..._.keys()];for(let y of s)this.cancel(y);for(let y of I.values()){y.timer&&clearTimeout(y.timer);for(let p of y.requirements)P.set(p.id,{state:"canceled",requirementId:p.id,canceledAt:Date.now()}),T?.(y.resolverId,p);}I.clear(),W();},getStatus(s){let y=_.get(s);if(y)return y.status;let p=P.get(s);return p||{state:"idle"}},getInflight(){return [..._.keys()]},getInflightInfo(){return [..._.values()].map(s=>({id:s.requirementId,resolverId:s.resolverId,startedAt:s.startedAt}))},getInflightCount(){return _.size},isResolving(s){return _.has(s)},processBatches(){for(let s of I.keys())he(s);},hasPendingBatches(){for(let s of I.values())if(s.requirements.length>0)return true;return false},registerDefinitions(s){for(let[y,p]of Object.entries(s))r[y]=p;M.clear();},assignDefinition(s,y){if(!r[s])throw new Error(`[Directive] Cannot assign resolver "${s}" \u2014 it does not exist. Use register() to create it.`);r[s]=y,M.clear();},unregisterDefinition(s){if(!r[s])return;for(let[p,$]of _)$.resolverId===s&&($.controller.abort(),_.delete(p),P.set(p,{state:"canceled",requirementId:p,canceledAt:Date.now()}),T?.(s,$.originalRequirement));let y=I.get(s);if(y){y.timer&&clearTimeout(y.timer);for(let p of y.requirements)P.set(p.id,{state:"canceled",requirementId:p.id,canceledAt:Date.now()}),T?.(s,p);I.delete(s);}delete r[s],M.clear(),W();},async callOne(s,y){let p=r[s];if(!p)throw new Error(`[Directive] Cannot call resolver "${s}" \u2014 it does not exist.`);let $=new AbortController,e=f$1($.signal);if(p.resolve){let n;R.batch(()=>{n=p.resolve(y,e);}),await n;}},destroy(){this.cancelAll(),P.clear(),M.clear();}}}function Ue(m){let{mergedDerive:r,getDerivation:A,definitions:R}=m,q={register:(g,S)=>R.register("derivation",g,S),assign:(g,S)=>R.assign("derivation",g,S),unregister:g=>R.unregister("derivation",g),call:g=>R.call("derivation",g),isDynamic:g=>R.isDynamic("derivation",g),listDynamic:()=>R.listDynamic("derivation")};return new Proxy({},{get(g,S){if(typeof S!="symbol"&&!l.has(S)){if(S in q)return q[S];if(S in r)return A(S)}},has(g,S){return typeof S=="symbol"||l.has(S)?false:S in r||S in q},ownKeys(){return Object.keys(r)},getOwnPropertyDescriptor(g,S){if(typeof S!="symbol"&&!l.has(S)&&(S in r||S in q))return {configurable:true,enumerable:true}},set(){return false},defineProperty(){return false},getPrototypeOf(){return null},setPrototypeOf(){return false}})}function Xe(m){let{mergedEvents:r,dispatchEvent:A}=m;return new Proxy({},{get(R,q){if(typeof q!="symbol"&&!l.has(q))return g=>{A(q,g);}},has(R,q){return typeof q=="symbol"||l.has(q)?false:q in r},ownKeys(){return Object.keys(r)},getOwnPropertyDescriptor(R,q){if(typeof q!="symbol"&&!l.has(q)&&q in r)return {configurable:true,enumerable:true}},set(){return false},defineProperty(){return false},getPrototypeOf(){return null},setPrototypeOf(){return false}})}var dt=new Set(["register","assign","unregister","call","isDynamic","listDynamic"]);function Je(m){let{mergedConstraints:r,mergedResolvers:A,mergedDerive:R,mergedEffects:q,constraintsManager:g,resolversManager:S,derivationsManager:B,effectsManager:T,pluginManager:b,getState:_,scheduleReconcile:P,maxDeferredRegistrations:V}=m,I={constraints:new Set,resolvers:new Set,derivations:new Set,effects:new Set},M={constraints:new Map,resolvers:new Map,derivations:new Map,effects:new Map},C=[];function W(i){if(dt.has(i))throw new Error(`[Directive] Derivation ID "${i}" conflicts with a reserved derive method name.`)}let K={constraint:{label:"Constraint",mergedMap:r,manager:g,dynamicSet:I.constraints,originalsMap:M.constraints,reconciles:true},resolver:{label:"Resolver",mergedMap:A,manager:S,dynamicSet:I.resolvers,originalsMap:M.resolvers,reconciles:true},derivation:{label:"Derivation",mergedMap:R,manager:B,dynamicSet:I.derivations,originalsMap:M.derivations,reconciles:false,validateId:W},effect:{label:"Effect",mergedMap:q,manager:T,dynamicSet:I.effects,originalsMap:M.effects,reconciles:false}};function Z(i){if(typeof i!="string"||i.length===0)throw new Error(`[Directive] Definition ID must be a non-empty string. Received: ${String(i)}`);if(l.has(i))throw new Error(`[Directive] Security: Definition ID "${i}" is a blocked property.`);if(i.includes("::"))throw new Error(`[Directive] Definition ID "${i}" cannot contain "::". This separator is reserved for namespacing.`)}function ne(i,u,c){let D=K[i];if(D.validateId?.(u),u in D.mergedMap)throw new Error(`[Directive] ${D.label} "${u}" already exists. Use assign() to override.`);if(i!=="derivation"){let F=c;F.meta&&(F.meta=me(F.meta));}D.mergedMap[u]=c,D.manager.registerDefinitions({[u]:c}),D.dynamicSet.add(u),b.emitDefinitionRegister(i,u,c),D.reconciles&&P();}function U(i,u,c){let D=K[i];if(D.validateId?.(u),!(u in D.mergedMap))throw new Error(`[Directive] ${D.label} "${u}" does not exist. Use register() to create it.`);if(i!=="derivation"){let X=c;X.meta&&(X.meta=me(X.meta));}let F=D.mergedMap[u];D.manager.assignDefinition(u,c),D.originalsMap.set(u,F),D.mergedMap[u]=c,b.emitDefinitionAssign(i,u,c,F),D.reconciles&&P();}function L(i,u){let c=K[i];if(!c.dynamicSet.has(u)){f&&console.warn(`[Directive] Cannot unregister static ${i} "${u}". Only dynamically registered ${i}s can be removed.`);return}c.manager.unregisterDefinition(u),delete c.mergedMap[u],c.dynamicSet.delete(u),c.originalsMap.delete(u),b.emitDefinitionUnregister(i,u),c.reconciles&&P();}function z(){if(C.length===0)return;let i=C.splice(0);for(let u of i)try{switch(u.op){case "register":ne(u.type,u.id,u.def);break;case "assign":U(u.type,u.id,u.def);break;case "unregister":L(u.type,u.id);break}}catch(c){f&&console.error(`[Directive] Error in deferred ${u.op} for ${u.type} "${u.id}":`,c);}}function f$1(i,u,c,D){let{isDestroyed:F,isReconciling:X}=_();if(F)throw new Error(`[Directive] Cannot ${i} ${u} "${c}" on a destroyed system.`);if(Z(c),X){if(C.length>=V)throw new Error(`[Directive] Too many deferred registrations (max ${V}). Avoid calling register/assign/unregister in resolver or effect callbacks during reconciliation.`);i==="unregister"?C.push({op:i,type:u,id:c}):C.push({op:i,type:u,id:c,def:D});return}switch(i){case "register":ne(u,c,D);break;case "assign":U(u,c,D);break;case "unregister":L(u,c);break}}return {register(i,u,c){f$1("register",i,u,c);},assign(i,u,c){f$1("assign",i,u,c);},unregister(i,u){f$1("unregister",i,u);},call(i,u,c){let{isDestroyed:D}=_();if(D)throw new Error(`[Directive] Cannot call ${i} "${u}" on a destroyed system.`);switch(Z(u),b.emitDefinitionCall(i,u,c),i){case "constraint":return g.callOne(u,c);case "resolver":return S.callOne(u,c);case "derivation":return B.callOne(u);case "effect":return T.callOne(u)}},isDynamic(i,u){switch(i){case "constraint":return I.constraints.has(u);case "resolver":return I.resolvers.has(u);case "derivation":return I.derivations.has(u);case "effect":return I.effects.has(u)}},listDynamic(i){switch(i){case "constraint":return [...I.constraints];case "resolver":return [...I.resolvers];case "derivation":return [...I.derivations];case "effect":return [...I.effects]}},flushDeferred:z,getOriginal(i,u){let D={constraint:M.constraints,resolver:M.resolvers,derivation:M.derivations,effect:M.effects}[i];if(D)return D.get(u)},restoreOriginal(i,u){let D={constraint:M.constraints,resolver:M.resolvers,derivation:M.derivations,effect:M.effects}[i];if(!D||!D.has(u))return false;let F=D.get(u);return f$1("assign",i,u,F),D.delete(u),true},destroy(){C.length=0,I.constraints.clear(),I.resolvers.clear(),I.derivations.clear(),I.effects.clear(),M.constraints.clear(),M.resolvers.clear(),M.derivations.clear(),M.effects.clear();}}}function Ge(m){let{traceConfig:r,pluginManager:A,resolverMetaLookup:R}=m;if(!(r===true||typeof r=="object"&&r!==null))return {enabled:false,recordFactChange(){},startRun(){return 0},currentTrace:null,getEntries(){return null},attributeResolverStart(){},recordResolverComplete(){},recordResolverError(){},decrementInflight(){},finalizeCurrentRun(){},drainPendingChanges(){},destroy(){}};let g=(typeof r=="object"&&r!==null?r.maxRuns:void 0)??100,S=[],B=new Map,T=0,b=null,_=[],P=new Map,V=new Map,I=new Map,M=null,C=0,W=0,K={count:0,totalDuration:0,avgDuration:0,maxDuration:0,avgResolverCount:0,totalResolverCount:0,avgFactChangeCount:0,totalFactChangeCount:0};function Z(c){let D=B.get(c);if(D&&D.status==="pending"){D.status="settled";let F=I.get(c);D.duration=F!==void 0?performance.now()-F:Date.now()-D.timestamp,I.delete(c),V.delete(c),D.causalChain=L(D),z(D),W++,A.emitTraceComplete(D);}}function ne(c){let D=P.get(c);if(P.delete(c),D!==void 0){let F=(V.get(D)??1)-1;F<=0?Z(D):V.set(D,F);}}function U(){let c=S.shift();if(c&&(B.delete(c.id),I.delete(c.id),c.status==="pending")){V.delete(c.id);for(let[D,F]of P)F===c.id&&P.delete(D);}}function L(c){let D=[];for(let F of c.factChanges)D.push(`${F.key} changed`);for(let F of c.derivationsRecomputed)D.push(`${F.id} recomputed`);for(let F of c.constraintsHit)D.push(`${F.id} constraint hit`);for(let F of c.requirementsAdded)D.push(`${F.type} requirement added`);for(let F of c.resolversCompleted)D.push(`${F.resolver} resolved (${F.duration.toFixed(0)}ms)`);for(let F of c.resolversErrored)D.push(`${F.resolver} errored`);for(let F of c.effectsRun)D.push(`${F.id} effect ran`);return D.join(" \u2192 ")}function z(c){K.count++,K.totalDuration+=c.duration,K.avgDuration=K.totalDuration/K.count,c.duration>K.maxDuration&&(K.maxDuration=c.duration);let D=c.resolversStarted.length;K.totalResolverCount+=D,K.avgResolverCount=K.totalResolverCount/K.count;let F=c.factChanges.length;K.totalFactChangeCount+=F,K.avgFactChangeCount=K.totalFactChangeCount/K.count;let X=[];K.count>3&&c.duration>K.avgDuration*5&&X.push(`Duration ${c.duration.toFixed(0)}ms is 5x+ above average (${K.avgDuration.toFixed(0)}ms)`),c.resolversErrored.length>0&&X.push(`${c.resolversErrored.length} resolver(s) errored`),X.length>0&&(c.anomalies=X);}function f(c){S.push(c),B.set(c.id,c),S.length>g&&U(),W++;}function i(c){return c.factChanges.length>0||c.constraintsHit.length>0||c.requirementsAdded.length>0||c.effectsRun.length>0}return {enabled:true,get currentTrace(){return b},set currentTrace(c){b=c;},recordFactChange(c,D,F){_.push({key:c,oldValue:D,newValue:F});},startRun(){let c=performance.now(),D=++T;return I.set(D,c),b={id:D,timestamp:Date.now(),duration:0,status:"pending",factChanges:_.splice(0),derivationsRecomputed:[],constraintsHit:[],requirementsAdded:[],requirementsRemoved:[],resolversStarted:[],resolversCompleted:[],resolversErrored:[],effectsRun:[],effectErrors:[]},c},getEntries(){return (!M||C!==W)&&(M=[...S],C=W),M},attributeResolverStart(c){b&&P.set(c,b.id);},recordResolverComplete(c,D,F){let X=P.get(c);if(X!==void 0){let fe=B.get(X);fe&&fe.resolversCompleted.push({resolver:D,requirementId:c,duration:F,meta:R?.(D)});}},recordResolverError(c,D,F){let X=P.get(c);if(X!==void 0){let fe=B.get(X);fe&&fe.resolversErrored.push({resolver:D,requirementId:c,error:F,meta:R?.(D)});}},decrementInflight(c){ne(c);},finalizeCurrentRun(c){if(!b)return;if(b.duration=performance.now()-c,!i(b)){I.delete(b.id),b=null;return}let D=b.resolversStarted.length;D===0?(b.status="settled",b.causalChain=L(b),z(b),f(b),A.emitTraceComplete(b)):(b.status="pending",f(b),V.set(b.id,D)),b=null;},drainPendingChanges(){_.length=0;},destroy(){S.length=0,B.clear(),P.clear(),V.clear(),I.clear(),_.length=0,b=null,M=null;}}}function hn(m){let r=Object.create(null),A=Object.create(null),R=Object.create(null),q=Object.create(null),g=Object.create(null),S=Object.create(null),B=new Map,T=new Map,b=new Map,_=new Map;for(let e of m.modules){let n=(d,k)=>{if(d)for(let x of Object.keys(d)){if(l.has(x))throw new Error(`[Directive] Security: Module "${e.id}" has dangerous key "${x}" in ${k}. This could indicate a prototype pollution attempt.`);if(k==="schema"&&x.startsWith("$"))throw new Error(`[Directive] Module "${e.id}" has schema key "${x}" starting with "$". Keys starting with $ are reserved for internal accessors ($store, $snapshot).`)}};n(e.schema,"schema"),n(e.events,"events"),n(e.derive,"derive"),n(e.effects,"effects"),n(e.constraints,"constraints"),n(e.resolvers,"resolvers");for(let d of Object.keys(e.schema)){let k=b.get(d);if(k)throw new Error(`[Directive] Schema collision: Fact "${d}" is defined in both module "${k}" and "${e.id}". Use namespacing (e.g., "${e.id}::${d}") or merge into one module.`);b.set(d,e.id);}let l$1=(d,k)=>{if(d)for(let x of Object.keys(d)){let G=_.get(x);if(G&&G!==e.id)throw new Error(`[Directive] Definition collision: ${k} "${x}" is defined in both module "${G}" and "${e.id}". Use namespacing or rename to avoid conflicts.`);_.set(x,e.id);}};if(l$1(e.derive,"derivation"),l$1(e.effects,"effect"),l$1(e.constraints,"constraint"),l$1(e.resolvers,"resolver"),l$1(e.events,"event"),Object.assign(r,e.schema),e.events){for(let[d,k]of Object.entries(e.events))if(typeof k=="object"&&k!==null&&Object.hasOwn(k,"handler")){let x=k;if(e.events[d]=x.handler,x.meta){let G=me(x.meta);G&&T.set(d,G);}}Object.assign(A,e.events);}if(e.derive&&Object.assign(R,e.derive),e.effects&&Object.assign(q,e.effects),e.constraints&&Object.assign(g,e.constraints),e.resolvers&&Object.assign(S,e.resolvers),e.meta){let d=me(e.meta);d&&B.set(e.id,d);}}for(let e of Object.values(g))e.meta&&(e.meta=me(e.meta));for(let e of Object.values(S))e.meta&&(e.meta=me(e.meta));for(let e of Object.values(q)){let n=e;n.meta&&(n.meta=me(n.meta));}for(let e of Object.values(r)){let n=e;n._meta&&(n._meta=me(n._meta));}let P=null;if(m.modules.some(e=>e.history?.snapshotEvents)){P=new Set;for(let e of m.modules){let n=e;if(n.history?.snapshotEvents)for(let l of n.history.snapshotEvents)P.add(l);else if(n.events)for(let l of Object.keys(n.events))P.add(l);}}let I=0,M=false;if(f){let e=new Set(Object.keys(R));for(let n of Object.keys(r))e.has(n)&&console.warn(`[Directive] "${n}" exists as both a fact and a derivation. This may cause unexpected dependency tracking behavior.`);}let C=Ne();for(let e of m.plugins??[])C.register(e);let W=()=>C.getPlugins().length>0,K=_e({config:m.errorBoundary,onError:e=>C.emitError(e),onRecovery:(e,n)=>C.emitErrorRecovery(e,n)}),Z=null,ne=()=>{},U=()=>{},L=null,z=Ge({traceConfig:m.trace,pluginManager:C,resolverMetaLookup:e=>S[e]?.meta}),f$1=z.enabled,{store:i,facts:u}=ze({schema:r,onChange:(e,n,l)=>{C.emitFactSet(e,n,l),ne(e),f$1&&z.recordFactChange(String(e),l,n),!L?.isRestoring&&(I===0&&(M=true),j.changedKeys.add(e),ve());},onBatch:e=>{C.emitFactsBatch(e);let n=[];for(let l of e)n.push(l.key);if(f$1)for(let l of e)z.recordFactChange(l.key,l.prev,l.type==="delete"?void 0:l.value);if(U(n),!L?.isRestoring){I===0&&(M=true);for(let l of e)j.changedKeys.add(l.key);ve();}}}),c$1=Ke({definitions:R,facts:u,onCompute:(e,n,l,d)=>{W()&&C.emitDerivationCompute(e,n,d),z.currentTrace&&z.currentTrace.derivationsRecomputed.push({id:e,deps:d?[...d]:[],oldValue:l,newValue:n,meta:c$1.getMeta(e)});},onInvalidate:e=>{W()&&C.emitDerivationInvalidate(e);},onError:(e,n)=>{K.handleError("derivation",e,n)==="retry"&&c$1.invalidate(e);}});ne=e=>c$1.invalidate(e),U=e=>c$1.invalidateMany(e);let D=Be({definitions:q,facts:u,store:i,onRun:(e,n)=>{W()&&C.emitEffectRun(e),z.currentTrace&&z.currentTrace.effectsRun.push({id:e,triggeredBy:n,meta:q[e]?.meta});},onError:(e,n)=>{let l=K.handleError("effect",e,n);W()&&C.emitEffectError(e,n),z.currentTrace&&z.currentTrace.effectErrors.push({id:e,error:String(n),meta:q[e]?.meta}),l==="disable"&&D.disable(e),l==="retry"&&(j.changedKeys.add("*"),ve());}}),F=Object.create(null);for(let e of Object.values(S))e.key&&typeof e.requirement=="string"&&(F[e.requirement]=e.key);let X=Fe({definitions:g,facts:u,requirementKeys:F,onEvaluate:(e,n)=>{W()&&C.emitConstraintEvaluate(e,n);},onError:(e,n)=>{let l=K.handleError("constraint",e,n);W()&&C.emitConstraintError(e,n),l==="disable"&&X.disable(e);}});function fe(e){for(let n of Object.values(e))n.key&&typeof n.requirement=="string"&&X.setRequirementKey(n.requirement,n.key);}let re=Ve({definitions:S,facts:u,store:i,onStart:(e,n)=>{W()&&C.emitResolverStart(e,n);},onComplete:(e,n,l)=>{K.clearRetryAttempts(e),W()&&(C.emitResolverComplete(e,n,l),C.emitRequirementMet(n,e)),X.markResolved(n.fromConstraint),f$1&&(z.recordResolverComplete(n.id,e,l),z.decrementInflight(n.id));},onError:(e,n,l)=>{let d=K.handleError("resolver",e,l,n);if(W()&&C.emitResolverError(e,n,l),d==="disable"&&X.disable(n.fromConstraint),d==="retry"&&(j.previousRequirements.remove(n.id),ve()),d==="retry-later"){let x=K.getRetryLaterManager().getPendingRetries().find(G=>G.sourceId===e);x&&!x.callback&&(x.callback=()=>{ve();});}f$1&&(z.recordResolverError(n.id,e,String(l)),z.decrementInflight(n.id));},onRetry:(e,n,l)=>C.emitResolverRetry(e,n,l),onCancel:(e,n)=>{C.emitResolverCancel(e,n),C.emitRequirementCanceled(n),f$1&&z.decrementInflight(n.id);},onResolutionComplete:()=>{N(),ve();}}),h=new Set;function E(){for(let e of h)e();}let o=m.history?Ae({historyOption:m.history,facts:u,store:i,onSnapshot:e=>{C.emitSnapshot(e),E();},onHistoryChange:(e,n)=>{C.emitHistoryNavigate(e,n),E();}}):je();L=o;let w=new Set;function N(){for(let e of w)e();}let Y=50,pe=100,ye=0,j={isRunning:false,isReconciling:false,reconcileScheduled:false,isInitializing:false,isInitialized:false,isReady:false,isDestroyed:false,changedKeys:new Set,previousRequirements:new De,readyPromise:null,readyResolve:null},ee=Je({mergedConstraints:g,mergedResolvers:S,mergedDerive:R,mergedEffects:q,constraintsManager:X,resolversManager:re,derivationsManager:c$1,effectsManager:D,pluginManager:C,getState:()=>j,scheduleReconcile:ve,maxDeferredRegistrations:pe});function ve(){!j.isRunning||j.reconcileScheduled||j.isInitializing||(j.reconcileScheduled=true,N(),queueMicrotask(()=>{j.reconcileScheduled=false,j.isRunning&&!j.isInitializing&&Re().catch(e=>{f&&console.error("[Directive] Unexpected error in reconcile:",e);});}));}async function Re(){if(j.isReconciling)return;if(ye++,ye>Y){f&&console.warn(`[Directive] Reconcile loop exceeded ${Y} iterations. This usually means resolvers are creating circular requirement chains. Check that resolvers aren't mutating facts that re-trigger their own constraints.`),f$1&&z.drainPendingChanges(),j.previousRequirements=new De,ye=0;return}j.isReconciling=true,N();let e=f$1?z.startRun():0,n=z.currentTrace;if(n)for(let l of n.factChanges){let d=r[l.key];l.meta=d?._meta;}try{if(j.changedKeys.size>0){if(P===null||M){let J=j.changedKeys,ie=J.size<=5?`facts-changed:${[...J].join(",")}`:`facts-changed:${[...J].slice(0,5).join(",")}+${J.size-5}more`;o.takeSnapshot(ie);}M=!1;}let l=u.$snapshot();C.emitReconcileStart(l),await D.runEffects(j.changedKeys);let d=new Set(j.changedKeys);j.changedKeys.clear();let k=await X.evaluate(d),x=new De;for(let J of k)x.add(J),C.emitRequirementCreated(J);if(n){let J=new Set(k.map(ie=>ie.fromConstraint));for(let ie of J){let se=X.getState(ie);if(se){let le=X.getDependencies(ie);n.constraintsHit.push({id:ie,priority:se.priority,deps:le?[...le]:[],meta:g[ie]?.meta});}}}let{added:G,removed:Q}=x.diff(j.previousRequirements);if(n){for(let J of G)n.requirementsAdded.push({id:J.id,type:J.requirement.type,fromConstraint:J.fromConstraint});for(let J of Q)n.requirementsRemoved.push({id:J.id,type:J.requirement.type,fromConstraint:J.fromConstraint});}for(let J of Q)re.cancel(J.id);for(let J of G)re.resolve(J);if(n){let J=re.getInflightInfo(),ie=new Map(J.map(se=>[se.id,se]));for(let se of G){let ce=ie.get(se.id)?.resolverId??"unknown";n.resolversStarted.push({resolver:ce,requirementId:se.id,meta:S[ce]?.meta}),z.attributeResolverStart(se.id);}}j.previousRequirements=x;let te=re.getInflightInfo();if(m.plugins&&m.plugins.length>0){let J=Q.length>0?new Map(te.map(se=>[se.id,se.resolverId])):void 0,ie={unmet:k.filter(se=>!re.isResolving(se.id)),inflight:te,completed:[],canceled:Q.map(se=>({id:se.id,resolverId:J?.get(se.id)??"unknown"}))};C.emitReconcileEnd(ie);}j.isReady||(j.isReady=!0,j.readyResolve&&(j.readyResolve(),j.readyResolve=null));}finally{f$1&&z.finalizeCurrentRun(e),j.isReconciling=false,ee.flushDeferred(),ye=0,j.changedKeys.size>0&&ve(),N();}}function he(e,n){let l=A[e];if(l){I++,(P===null||P.has(e))&&(M=true);try{i.batch(()=>{l(u,{type:e,...n});});}finally{I--;}}else f&&console.warn(`[Directive] Unknown event type "${e}". No handler is registered for this event. Available events: ${Object.keys(A).join(", ")||"(none)"}`);}let Se=Ue({mergedDerive:R,getDerivation:e=>c$1.get(e),definitions:ee}),s=Xe({mergedEvents:A,dispatchEvent:he});function y(){let e=[];for(let[n,l]of B)e.push({type:"module",id:n,meta:l});for(let n of Object.keys(r)){let l=r[n]?._meta;l&&e.push({type:"fact",id:n,meta:l});}for(let[n,l]of T)e.push({type:"event",id:n,meta:l});for(let[n,l]of Object.entries(g))l.meta&&e.push({type:"constraint",id:n,meta:l.meta});for(let[n,l]of Object.entries(S))l.meta&&e.push({type:"resolver",id:n,meta:l.meta});for(let[n,l]of Object.entries(q)){let d=l.meta;d&&e.push({type:"effect",id:n,meta:d});}for(let n of Object.keys(R)){let l=c$1.getMeta(n);l&&e.push({type:"derivation",id:n,meta:l});}return e}let p={facts:u,history:o.isEnabled?o:null,derive:Se,events:s,constraints:{disable:e=>X.disable(e),enable:e=>X.enable(e),isDisabled:e=>X.isDisabled(e),register:(e,n)=>{ee.register("constraint",e,n);},assign:(e,n)=>{ee.assign("constraint",e,n);},unregister:e=>{ee.unregister("constraint",e);},call:(e,n)=>ee.call("constraint",e,n),isDynamic:e=>ee.isDynamic("constraint",e),listDynamic:()=>ee.listDynamic("constraint")},effects:{disable:e=>D.disable(e),enable:e=>D.enable(e),isEnabled:e=>D.isEnabled(e),register:(e,n)=>{ee.register("effect",e,n);},assign:(e,n)=>{ee.assign("effect",e,n);},unregister:e=>{ee.unregister("effect",e);},call:e=>ee.call("effect",e),isDynamic:e=>ee.isDynamic("effect",e),listDynamic:()=>ee.listDynamic("effect")},resolvers:{register:(e,n)=>{ee.register("resolver",e,n),fe({[e]:n});},assign:(e,n)=>{ee.assign("resolver",e,n),fe({[e]:n});},unregister:e=>{let n=S[e];n?.key&&typeof n.requirement=="string"&&X.removeRequirementKey(n.requirement),ee.unregister("resolver",e);},call:(e,n)=>ee.call("resolver",e,n),isDynamic:e=>ee.isDynamic("resolver",e),listDynamic:()=>ee.listDynamic("resolver")},get trace(){return z.getEntries()},meta:{module(e){return B.get(e)},fact(e){return r[e]?._meta},event(e){return T.get(e)},constraint(e){return g[e]?.meta},resolver(e){return S[e]?.meta},effect(e){return q[e]?.meta},derivation(e){return c$1.getMeta(e)},byCategory(e){return y().filter(n=>n.meta.category===e)},byTag(e){return y().filter(n=>n.meta.tags?.includes(e))}},observe(e){let n=`__observer_${Date.now()}_${Math.random().toString(36).slice(2)}`,l={name:n,onInit:()=>e({type:"system.init"}),onStart:()=>e({type:"system.start"}),onStop:()=>e({type:"system.stop"}),onDestroy:()=>e({type:"system.destroy"}),onFactSet:(d,k,x)=>e({type:"fact.change",key:d,prev:x,next:k}),onConstraintEvaluate:(d,k)=>e({type:"constraint.evaluate",id:d,active:k}),onConstraintError:(d,k)=>e({type:"constraint.error",id:d,error:k}),onRequirementCreated:d=>e({type:"requirement.created",id:d.id,requirementType:d.requirement.type}),onRequirementMet:(d,k)=>e({type:"requirement.met",id:d.id,byResolver:k}),onRequirementCanceled:d=>e({type:"requirement.canceled",id:d.id}),onResolverStart:(d,k)=>e({type:"resolver.start",resolver:d,requirementId:k.id}),onResolverComplete:(d,k,x)=>e({type:"resolver.complete",resolver:d,requirementId:k.id,duration:x}),onResolverError:(d,k,x)=>e({type:"resolver.error",resolver:d,requirementId:k.id,error:x}),onEffectRun:d=>e({type:"effect.run",id:d}),onEffectError:(d,k)=>e({type:"effect.error",id:d,error:k}),onDerivationCompute:(d,k)=>e({type:"derivation.compute",id:d,value:k}),onReconcileStart:()=>e({type:"reconcile.start"}),onReconcileEnd:d=>{let k=d;e({type:"reconcile.end",added:Array.isArray(k.completed)?k.completed.length:0,removed:Array.isArray(k.canceled)?k.canceled.length:0});}};return C.register(l),()=>C.unregister(n)},initialize(){if(!j.isInitialized){j.isInitializing=true;for(let e of m.modules)e.init&&i.batch(()=>{e.init(u);});m.onAfterModuleInit&&i.batch(()=>{m.onAfterModuleInit();}),j.isInitializing=false,j.isInitialized=true;for(let e of Object.keys(R))c$1.get(e);}},start(){if(!j.isRunning){j.isInitialized||this.initialize(),j.isRunning=true;for(let e of m.modules)e.hooks?.onStart?.(p);if(C.emitStart(p),m.errorBoundary?.retryLater&&!Z){let e=Math.max(m.errorBoundary.retryLater.delayMs??1e3,250);Z=setInterval(()=>{let n=K.processDueRetries();for(let l of n)l.callback?l.callback():ve();},Math.min(e,500));}ve();}},stop(){if(j.isRunning){j.isRunning=false,Z!==null&&(clearInterval(Z),Z=null),K.getRetryLaterManager().clearAll(),re.cancelAll(),D.cleanupAll();for(let e of m.modules)e.hooks?.onStop?.(p);C.emitStop(p);}},destroy(){j.isDestroyed||(this.stop(),j.isDestroyed=true,i.destroy?.(),re.destroy(),K.clearErrors(),w.clear(),h.clear(),z.destroy(),ee.destroy(),B.clear(),T.clear(),C.emitDestroy(p));},dispatch(e){l.has(e.type)||he(e.type,e);},read(e){return c$1.get(e)},subscribe(e,n){let l=[],d=[];for(let x of e)x in R?l.push(x):x in r?d.push(x):f&&console.warn(`[Directive] subscribe: unknown key "${x}"`);let k=[];return l.length>0&&k.push(c$1.subscribe(l,n)),d.length>0&&k.push(i.subscribe(d,n)),()=>{for(let x of k)x();}},watch(e,n,l){let d=l?.equalityFn?(x,G)=>l.equalityFn(x,G):(x,G)=>Object.is(x,G);if(e in R){let x=c$1.get(e);return c$1.subscribe([e],()=>{let G=c$1.get(e);if(!d(G,x)){let Q=x;x=G,n(G,Q);}})}f&&(e in r||console.warn(`[Directive] watch: unknown key "${e}"`));let k=i.get(e);return i.subscribe([e],()=>{let x=i.get(e);if(!d(x,k)){let G=k;k=x,n(x,G);}})},when(e,n){return new Promise((l,d)=>{let k=i.toObject();if(e(k)){l();return}let x,G,Q=()=>{x?.(),G!==void 0&&clearTimeout(G);};x=i.subscribeAll(()=>{let te=i.toObject();e(te)&&(Q(),l());}),n?.timeout!==void 0&&n.timeout>0&&(G=setTimeout(()=>{Q(),d(new Error(`[Directive] when: timed out after ${n.timeout}ms`));},n.timeout));})},inspect(){return {unmet:j.previousRequirements.all(),inflight:re.getInflightInfo(),facts:Object.keys(r).map(e=>({key:e,meta:r[e]?._meta})),events:Object.keys(A).map(e=>({name:e,meta:T.get(e)})),constraints:X.getAllStates().map(e=>({id:e.id,active:e.lastResult??false,disabled:X.isDisabled(e.id),priority:e.priority,hitCount:e.hitCount,lastActiveAt:e.lastActiveAt,meta:g[e.id]?.meta})),resolvers:Object.fromEntries(re.getInflight().map(e=>[e,re.getStatus(e)])),resolverDefs:Object.entries(S).map(([e,n])=>({id:e,requirement:typeof n.requirement=="string"?n.requirement:"(predicate)",meta:n.meta})),effects:Object.entries(q).map(([e,n])=>({id:e,meta:n.meta})),derivations:Object.keys(R).map(e=>({id:e,meta:c$1.getMeta(e)})),modules:m.modules.map(e=>({id:e.id,meta:B.get(e.id)})),traceEnabled:f$1,...f$1?{trace:structuredClone(z.getEntries()??[])}:{}}},explain(e){let l=j.previousRequirements.all().find(le=>le.id===e);if(!l)return null;let d=X.getState(l.fromConstraint),k=re.getStatus(e),x={},G=X.getDependencies(l.fromConstraint);if(G)for(let le of G)x[le]=i.get(le);else for(let[le,ce]of Object.entries(i.toObject()))x[le]=ce;let Q=g[l.fromConstraint],te=Q?.meta?.label??l.fromConstraint,J=[`Requirement "${l.requirement.type}" (id: ${l.id})`,`\u251C\u2500 Produced by constraint: ${te}`,`\u251C\u2500 Constraint priority: ${d?.priority??0}`,`\u251C\u2500 Constraint active: ${d?.lastResult??"unknown"}`,`\u251C\u2500 Resolver status: ${k.state}`];Q?.meta?.description&&J.push(`\u251C\u2500 Description: ${Q.meta.description}`);let ie=Object.entries(l.requirement).filter(([le])=>le!=="type").map(([le,ce])=>`${le}=${JSON.stringify(ce)}`).join(", ");ie&&J.push(`\u251C\u2500 Requirement payload: { ${ie} }`);let se=Object.entries(x).slice(0,10);return se.length>0&&(J.push("\u2514\u2500 Relevant facts:"),se.forEach(([le,ce],t)=>{let a=t===se.length-1?" \u2514\u2500":" \u251C\u2500",v=typeof ce=="object"?JSON.stringify(ce):String(ce);J.push(`${a} ${le} = ${v.slice(0,50)}${v.length>50?"...":""}`);})),J.join(`
|
|
2
|
+
`)},getOriginal(e,n){return ee.getOriginal(e,n)},restoreOriginal(e,n){return ee.restoreOriginal(e,n)},async settle(e=5e3){let n=()=>re.getInflightCount()===0&&!j.isReconciling&&!j.reconcileScheduled&&!re.hasPendingBatches();if(re.hasPendingBatches()&&re.processBatches(),await new Promise(l=>queueMicrotask(l)),!n())return new Promise((l,d)=>{let k=false,x=()=>{k||(k=true,clearTimeout(G),Q());},G=setTimeout(()=>{x();let te=[],J=re.getInflightInfo();J.length>0&&te.push(`${J.length} resolvers inflight: ${J.map(se=>se.resolverId).join(", ")}`),j.isReconciling&&te.push("reconciliation in progress"),j.reconcileScheduled&&te.push("reconcile scheduled");let ie=j.previousRequirements.all();ie.length>0&&te.push(`${ie.length} unmet requirements: ${ie.map(se=>se.requirement.type).join(", ")}`),d(new Error(`[Directive] settle() timed out after ${e}ms. ${te.join("; ")}`));},e),Q=this.onSettledChange(()=>{re.hasPendingBatches()&&re.processBatches(),queueMicrotask(()=>{!k&&n()&&(x(),l());});});})},getSnapshot(){return {facts:i.toObject(),version:1}},getDistributableSnapshot(e$1={}){let{includeDerivations:n,excludeDerivations:l,includeFacts:d,ttlSeconds:k,metadata:x,includeVersion:G}=e$1,Q={},te=Object.keys(R),J=new Set(te),ie;if(n){if(ie=n.filter(ce=>J.has(ce)),f){let ce=n.filter(t=>!J.has(t));ce.length>0&&console.warn(`[Directive] getDistributableSnapshot: Unknown derivation keys ignored: ${ce.join(", ")}. Available: ${te.join(", ")||"(none)"}`);}}else ie=te;if(l){let ce=new Set(l);ie=ie.filter(t=>!ce.has(t));}for(let ce of ie)try{Q[ce]=c$1.get(ce);}catch(t){f&&console.warn(`[Directive] getDistributableSnapshot: Skipping derivation "${ce}" due to error:`,t);}if(d&&d.length>0){let ce=i.toObject(),t=Object.keys(ce);if(f){let a=d.filter(v=>!(v in ce));a.length>0&&console.warn(`[Directive] getDistributableSnapshot: Unknown fact keys ignored: ${a.join(", ")}. Available: ${t.join(", ")||"(none)"}`);}for(let a of d)a in ce&&(Q[a]=ce[a]);}let se=Date.now(),le={data:Q,createdAt:se};return k!==void 0&&k>0&&(le.expiresAt=se+k*1e3),G&&(le.version=e(Q)),x&&(le.metadata=x),le},watchDistributableSnapshot(e,n){let{includeDerivations:l,excludeDerivations:d}=e,k=Object.keys(R),x;if(l?x=l.filter(te=>k.includes(te)):x=k,d){let te=new Set(d);x=x.filter(J=>!te.has(J));}if(x.length===0)return f&&console.warn("[Directive] watchDistributableSnapshot: No derivations to watch. Callback will never be called."),()=>{};let Q=this.getDistributableSnapshot({...e,includeVersion:true}).version;return c$1.subscribe(x,()=>{let te=this.getDistributableSnapshot({...e,includeVersion:true});te.version!==Q&&(Q=te.version,n(te));})},restore(e){if(!e||typeof e!="object")throw new Error("[Directive] restore() requires a valid snapshot object");if(!e.facts||typeof e.facts!="object")throw new Error("[Directive] restore() snapshot must have a facts object");if(!c(e))throw new Error("[Directive] restore() rejected: snapshot contains potentially dangerous keys (__proto__, constructor, or prototype). This may indicate a prototype pollution attack.");i.batch(()=>{for(let[n,l$1]of Object.entries(e.facts))l.has(n)||i.set(n,l$1);});},onSettledChange(e){return w.add(e),()=>{w.delete(e);}},onHistoryChange(e){return h.add(e),()=>{h.delete(e);}},batch(e){i.batch(e);},get isSettled(){return re.getInflightCount()===0&&!re.hasPendingBatches()&&!j.isReconciling&&!j.reconcileScheduled},get isRunning(){return j.isRunning},get isInitialized(){return j.isInitialized},get isReady(){return j.isReady},whenReady(){return j.isReady?Promise.resolve():j.isRunning?(j.readyPromise||(j.readyPromise=new Promise(e=>{j.readyResolve=e;})),j.readyPromise):Promise.reject(new Error("[Directive] whenReady() called before start(). Call system.start() first, then await system.whenReady()."))}};function $(e){if(j.isReconciling)throw new Error(`[Directive] Cannot register module "${e.id}" during reconciliation. Wait for the current reconciliation cycle to complete.`);if(j.isDestroyed)throw new Error(`[Directive] Cannot register module "${e.id}" on a destroyed system.`);let n=(l$1,d)=>{if(l$1)for(let k of Object.keys(l$1)){if(l.has(k))throw new Error(`[Directive] Security: Module "${e.id}" has dangerous key "${k}" in ${d}.`);if(d==="schema"&&k.startsWith("$"))throw new Error(`[Directive] Module "${e.id}" has schema key "${k}" starting with "$". Keys starting with $ are reserved for internal accessors ($store, $snapshot).`)}};n(e.schema,"schema"),n(e.events,"events"),n(e.derive,"derive"),n(e.effects,"effects"),n(e.constraints,"constraints"),n(e.resolvers,"resolvers");for(let l of Object.keys(e.schema))if(l in r)throw new Error(`[Directive] Schema collision: Fact "${l}" already exists. Cannot register module "${e.id}".`);if(f&&e.derive){let l=new Set(Object.keys(r));for(let d of Object.keys(e.derive))l.has(d)&&console.warn(`[Directive] "${d}" exists as both a fact and a derivation after registering module "${e.id}".`);}if(e.history?.snapshotEvents){P===null&&(P=new Set(Object.keys(A)));for(let l of e.history.snapshotEvents)P.add(l);}else if(P!==null&&e.events)for(let l of Object.keys(e.events))P.add(l);Object.assign(r,e.schema);for(let l of Object.values(e.schema)){let d=l;d._meta&&(d._meta=me(d._meta));}if(e.events){for(let[l,d]of Object.entries(e.events))if(typeof d=="object"&&d!==null&&Object.hasOwn(d,"handler")){let k=d;if(e.events[l]=k.handler,k.meta){let x=me(k.meta);x&&T.set(l,x);}}Object.assign(A,e.events);}if(e.derive&&(Object.assign(R,e.derive),c$1.registerDefinitions(e.derive)),e.effects){for(let l of Object.values(e.effects)){let d=l;d.meta&&(d.meta=me(d.meta));}Object.assign(q,e.effects),D.registerDefinitions(e.effects);}if(e.constraints){for(let l of Object.values(e.constraints)){let d=l;d.meta&&(d.meta=me(d.meta));}Object.assign(g,e.constraints),X.registerDefinitions(e.constraints);}if(e.resolvers){for(let l of Object.values(e.resolvers)){let d=l;d.meta&&(d.meta=me(d.meta));}Object.assign(S,e.resolvers),re.registerDefinitions(e.resolvers),fe(e.resolvers);}if(i.registerKeys(e.schema),e.meta){let l=me(e.meta);l&&B.set(e.id,l);}m.modules.push(e),e.init&&i.batch(()=>{e.init(u);}),e.hooks?.onInit?.(p),j.isRunning&&(e.hooks?.onStart?.(p),ve());}p.registerModule=$,C.emitInit(p);for(let e of m.modules)e.hooks?.onInit?.(p);return p}export{xe as a,we as b,Ze as c,Ye as d,Qe as e,et as f,vt as g,yt as h,Ae as i,je as j,nt as k,Et as l,Mt as m,Ct as n,De as o,Fe as p,Ke as q,Be as r,st as s,_e as t,ct as u,lt as v,ze as w,Ne as x,Ve as y,hn as z};//# sourceMappingURL=chunk-2HKKISIL.js.map
|
|
3
|
+
//# sourceMappingURL=chunk-2HKKISIL.js.map
|