@directive-run/core 0.8.7 → 0.8.8

package/dist/{chunk-O75OISQ2.js.map → chunk-EFBBEXDA.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/types/adapter-utils.ts","../src/core/tracking.ts"],"names":["setBridgeFact","facts","key","value","getBridgeFact","createCallbackPlugin","name","callbacks","req","requirementGuard","type","requirementGuardMultiple","types","typeSet","trackingStack","createTrackingContext","dependencies","nullContext","getCurrentTracker","isTracking","withTracking","fn","context","withoutTracking","saved","ctx","trackAccess","BLOCKED_PROPS"],"mappings":"AA8FO,SAASA,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACM,CACLF,EAAkCC,CAAG,CAAA,CAAIC,EAC5C,CAWO,SAASC,CAAAA,CAAiBH,EAAsBC,CAAAA,CAAgB,CACrE,OAAQD,CAAAA,CAAkCC,CAAG,CAC/C,CAyJO,SAASG,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACa,CACb,OAAO,CACL,KAAAD,CAAAA,CACA,oBAAA,CAAsBC,CAAAA,CAAU,oBAAA,CAC3BC,CAAAA,EAAQD,CAAAA,CAAU,qBAAsBC,CAAAA,CAAI,WAAW,CAAA,CACxD,MAAA,CACJ,gBAAA,CAAkBD,CAAAA,CAAU,sBACvBC,CAAAA,EAAQD,CAAAA,CAAU,qBAAA,CAAuBC,CAAAA,CAAI,WAAW,CAAA,CACzD,MAAA,CACJ,OAAA,CAASD,CAAAA,CAAU,OACrB,CACF,CAyCO,SAASE,CAAAA,CACdC,EACgC,CAChC,OAAQF,CAAAA,EAAkBA,CAAAA,CAAI,IAAA,GAASE,CACzC,CAUO,SAASC,CAAAA,CACdC,CAAAA,CACgC,CAChC,IAAMC,CAAAA,CAAU,IAAI,GAAA,CAAID,CAAK,CAAA,CAC7B,OAAQJ,CAAAA,EAAkBK,CAAAA,CAAQ,GAAA,CAAIL,CAAAA,CAAI,IAAI,CAChD,CC1UA,IAAMM,CAAAA,CAAmC,GAGzC,SAASC,CAAAA,EAAyC,CAChD,IAAMC,CAAAA,CAAe,IAAI,GAAA,CAEzB,OAAO,CACL,IAAI,UAAA,EAAa,CACf,OAAO,KACT,EACA,KAAA,CAAMd,CAAAA,CAAa,CACjBc,CAAAA,CAAa,GAAA,CAAId,CAAG,EACtB,CAAA,CACA,eAAA,EAAkB,CAChB,OAAOc,CACT,CACF,CACF,CAGA,IAAMC,CAAAA,CAA+B,CACnC,UAAA,CAAY,KAAA,CACZ,KAAA,EAAQ,CAAC,CAAA,CACT,eAAA,EAAkB,CAChB,OAAO,IAAI,GACb,CACF,CAAA,CAUO,SAASC,CAAAA,EAAqC,CACnD,OAAOJ,CAAAA,CAAcA,CAAAA,CAAc,MAAA,CAAS,CAAC,CAAA,EAAKG,CACpD,CASO,SAASE,CAAAA,EAAsB,CACpC,OAAOL,CAAAA,CAAc,MAAA,CAAS,CAChC,CAgBO,SAASM,EAAgBC,CAAAA,CAA8C,CAC5E,IAAMC,CAAAA,CAAUP,CAAAA,EAAsB,CACtCD,EAAc,IAAA,CAAKQ,CAAO,CAAA,CAE1B,GAAI,CAEF,OAAO,CAAE,KAAA,CADKD,CAAAA,EAAG,CACD,IAAA,CAAMC,CAAAA,CAAQ,eAAA,EAAkB,CAClD,CAAA,OAAE,CACAR,CAAAA,CAAc,GAAA,GAChB,CACF,CAgBO,SAASS,CAAAA,CAAmBF,CAAAA,CAAgB,CAEjD,IAAMG,CAAAA,CAAQV,EAAc,MAAA,CAAO,CAAA,CAAGA,CAAAA,CAAc,MAAM,CAAA,CAE1D,GAAI,CACF,OAAOO,CAAAA,EACT,CAAA,OAAE,CAEA,IAAA,IAAWI,CAAAA,IAAOD,EAChBV,CAAAA,CAAc,IAAA,CAAKW,CAAG,EAE1B,CACF,CAYO,SAASC,CAAAA,CAAYxB,CAAAA,CAAmB,CAC7CgB,CAAAA,EAAkB,CAAE,KAAA,CAAMhB,CAAG,EAC/B,CAYO,IAAMyB,CAAAA,CAAqC,MAAA,CAAO,MAAA,CACvD,IAAI,GAAA,CAAI,CAAC,WAAA,CAAa,aAAA,CAAe,WAAW,CAAC,CACnD","file":"chunk-O75OISQ2.js","sourcesContent":["/**\n * Adapter Type Utilities - Shared types and helpers for framework adapters\n *\n * These utilities reduce type assertions in adapters by providing:\n * - Schema composition types\n * - Constraint/resolver converters\n * - Plugin factory helpers\n */\n\nimport type { Facts } from \"./facts.js\";\nimport type { Plugin } from \"./plugins.js\";\nimport type { ConstraintDef, Requirement } from \"./requirements.js\";\nimport type { ResolverContext, ResolverDef } from \"./resolvers.js\";\nimport type { InferSchema, Schema } from \"./schema.js\";\n\n// ============================================================================\n// Schema Composition Types\n// ============================================================================\n\n/**\n * Merge two schemas into one.\n * Useful for adapters that add bridge-specific facts to user schemas.\n *\n * @example\n * ```typescript\n * type BridgeFields = { __state: SchemaType<Record<string, unknown>> };\n * type Combined = MergedSchema<UserSchema, BridgeFields>;\n * ```\n */\nexport type MergedSchema<Base extends Schema, Extra extends Schema> = Base &\n  Extra;\n\n/**\n * Create a schema type from a fields definition.\n * Helper for defining adapter bridge schemas.\n *\n * @example\n * ```typescript\n * type AdapterBridgeSchema = BridgeSchema<{\n *   __adapterState: SchemaType<Record<string, unknown>>;\n * }>;\n * ```\n */\nexport type BridgeSchema<Fields extends Schema> = Fields;\n\n// ============================================================================\n// Bridge Schema Helper\n// ============================================================================\n\n/**\n * Create a bridge schema definition for adapters.\n * Returns a schema object compatible with createModule().\n *\n * @example\n * ```typescript\n * const bridgeSchema = createBridgeSchema({\n *   __state: t.object<Record<string, unknown>>(),\n * });\n * ```\n */\nexport function createBridgeSchema<S extends Schema>(schema: S): S {\n  return schema;\n}\n\n// ============================================================================\n// Type-Safe Fact Mutation\n// ============================================================================\n\n/**\n * Type-safe fact setter for known schema keys.\n * Use when you have a typed schema and want to set a specific fact.\n *\n * @example\n * ```typescript\n * setFact(facts, \"count\", 10); // Type-checked\n * ```\n */\nexport function setFact<S extends Schema, K extends keyof InferSchema<S>>(\n  facts: Facts<S>,\n  key: K,\n  value: InferSchema<S>[K],\n): void {\n  (facts as Record<string, unknown>)[key as string] = value;\n}\n\n/**\n * Set a bridge fact without strict typing.\n * Use for adapter-internal bridge fields like `__adapterState`.\n *\n * @example\n * ```typescript\n * setBridgeFact(facts, \"__adapterState\", currentState);\n * ```\n */\nexport function setBridgeFact<V>(\n  facts: Facts<Schema>,\n  key: string,\n  value: V,\n): void {\n  (facts as Record<string, unknown>)[key] = value;\n}\n\n/**\n * Get a bridge fact without strict typing.\n * Use for adapter-internal bridge fields.\n *\n * @example\n * ```typescript\n * const state = getBridgeFact<MyState>(facts, \"__adapterState\");\n * ```\n */\nexport function getBridgeFact<V>(facts: Facts<Schema>, key: string): V {\n  return (facts as Record<string, unknown>)[key] as V;\n}\n\n// ============================================================================\n// Constraint Converters\n// ============================================================================\n\n/**\n * Adapter constraint definition (generic form used by adapters).\n */\nexport interface AdapterConstraint<TState> {\n  when: (state: TState) => boolean | Promise<boolean>;\n  require: Requirement | ((state: TState) => Requirement | null);\n  priority?: number;\n}\n\n/**\n * Convert adapter-style constraints to Directive format.\n * Maps adapter constraints that work with external state (TState) to\n * Directive constraints that work with Facts<Schema>.\n *\n * @param constraints - Adapter constraints keyed by name\n * @param extractState - Function to extract adapter state from facts\n *\n * @example\n * ```typescript\n * const directiveConstraints = convertConstraints<MyState, BridgeSchema>(\n *   adapterConstraints,\n *   (facts) => getBridgeFact<MyState>(facts, \"__state\"),\n * );\n * ```\n */\nexport function convertConstraints<TState, S extends Schema>(\n  constraints: Record<string, AdapterConstraint<TState>>,\n  extractState: (facts: Facts<S>) => TState,\n): Record<string, ConstraintDef<S, Requirement>> {\n  const result: Record<string, ConstraintDef<S, Requirement>> = {};\n\n  for (const [id, constraint] of Object.entries(constraints)) {\n    result[id] = {\n      priority: constraint.priority ?? 0,\n      when: (facts) => constraint.when(extractState(facts)),\n      require: (facts) => {\n        const req =\n          typeof constraint.require === \"function\"\n            ? constraint.require(extractState(facts))\n            : constraint.require;\n        return req;\n      },\n    };\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Resolver Converters\n// ============================================================================\n\n/**\n * Adapter resolver context (generic form used by adapters).\n */\nexport interface AdapterResolverContext<TContext> {\n  context: TContext;\n  signal: AbortSignal;\n}\n\n/**\n * Adapter resolver definition (generic form used by adapters).\n */\nexport interface AdapterResolver<\n  TContext,\n  R extends Requirement = Requirement,\n> {\n  requirement: (req: Requirement) => req is R;\n  key?: (req: R) => string;\n  resolve: (\n    req: R,\n    ctx: AdapterResolverContext<TContext>,\n  ) => void | Promise<void>;\n}\n\n/**\n * Convert adapter-style resolvers to Directive format.\n * Maps adapter resolvers that work with external context (TContext) to\n * Directive resolvers that work with ResolverContext<Schema>.\n *\n * @param resolvers - Adapter resolvers keyed by name\n * @param createContext - Function to create adapter context from Directive context\n *\n * @example\n * ```typescript\n * const directiveResolvers = convertResolvers<MyContext, BridgeSchema>(\n *   adapterResolvers,\n *   (ctx) => ({\n *     getState: () => getBridgeFact<MyState>(ctx.facts, \"__state\"),\n *     setState: (update) => setBridgeFact(ctx.facts, \"__state\", update),\n *     signal: ctx.signal,\n *   }),\n * );\n * ```\n */\nexport function convertResolvers<TContext, S extends Schema>(\n  resolvers: Record<string, AdapterResolver<TContext, Requirement>>,\n  createContext: (ctx: ResolverContext<S>) => TContext,\n): Record<string, ResolverDef<S, Requirement>> {\n  const result: Record<string, ResolverDef<S, Requirement>> = {};\n\n  for (const [id, resolver] of Object.entries(resolvers)) {\n    result[id] = {\n      requirement: resolver.requirement,\n      key: resolver.key,\n      resolve: async (req, ctx) => {\n        const adapterCtx = createContext(ctx);\n        await resolver.resolve(req, {\n          context: adapterCtx,\n          signal: ctx.signal,\n        });\n      },\n    };\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Plugin Factory\n// ============================================================================\n\n/**\n * Callback definitions for adapter plugins.\n */\nexport interface AdapterCallbacks {\n  onRequirementCreated?: (req: Requirement) => void;\n  onRequirementResolved?: (req: Requirement) => void;\n  onError?: (error: Error) => void;\n}\n\n/**\n * Create a callback plugin for adapter events.\n * Wraps adapter callbacks in a Directive plugin.\n *\n * @param name - Plugin name (for debugging)\n * @param callbacks - Callback functions to invoke\n *\n * @example\n * ```typescript\n * const callbackPlugin = createCallbackPlugin(\"adapter-callbacks\", {\n *   onRequirementCreated: (req) => console.log(\"Created:\", req),\n *   onRequirementResolved: (req) => console.log(\"Resolved:\", req),\n * });\n * ```\n */\n// biome-ignore lint/suspicious/noExplicitAny: Plugins work with any schema type\nexport function createCallbackPlugin(\n  name: string,\n  callbacks: AdapterCallbacks,\n): Plugin<any> {\n  return {\n    name,\n    onRequirementCreated: callbacks.onRequirementCreated\n      ? (req) => callbacks.onRequirementCreated!(req.requirement)\n      : undefined,\n    onRequirementMet: callbacks.onRequirementResolved\n      ? (req) => callbacks.onRequirementResolved!(req.requirement)\n      : undefined,\n    onError: callbacks.onError,\n  };\n}\n\n// ============================================================================\n// Module Config Helpers\n// ============================================================================\n\n/**\n * Cast constraints to the correct type for createModule.\n * Use this when TypeScript can't infer the constraint types correctly.\n */\nexport function asConstraints<S extends Schema>(\n  constraints: Record<string, ConstraintDef<S, Requirement>>,\n): Record<string, ConstraintDef<S, Requirement>> {\n  return constraints;\n}\n\n/**\n * Cast resolvers to the correct type for createModule.\n * Use this when TypeScript can't infer the resolver types correctly.\n */\nexport function asResolvers<S extends Schema>(\n  resolvers: Record<string, ResolverDef<S, Requirement>>,\n): Record<string, ResolverDef<S, Requirement>> {\n  return resolvers;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Create a type guard for a specific requirement type.\n * Simplifies the common pattern of checking req.type.\n *\n * @example\n * ```typescript\n * const isResetReq = requirementGuard<ResetReq>(\"RESET\");\n * // Use in resolver:\n * { requirement: isResetReq, resolve: ... }\n * ```\n */\nexport function requirementGuard<R extends Requirement>(\n  type: R[\"type\"],\n): (req: Requirement) => req is R {\n  return (req): req is R => req.type === type;\n}\n\n/**\n * Create a type guard that matches multiple requirement types.\n *\n * @example\n * ```typescript\n * const isDataReq = requirementGuardMultiple<FetchReq | RefreshReq>([\"FETCH\", \"REFRESH\"]);\n * ```\n */\nexport function requirementGuardMultiple<R extends Requirement>(\n  types: Array<R[\"type\"]>,\n): (req: Requirement) => req is R {\n  const typeSet = new Set(types);\n  return (req): req is R => typeSet.has(req.type);\n}\n","/**\n * Dependency tracking context for auto-tracking derivations\n *\n * Uses a stack-based approach to handle nested derivation computations.\n * When a derivation accesses a fact, the tracking context records it.\n */\n\nimport type { TrackingContext } from \"./types.js\";\n\n/** Stack of active tracking contexts */\nconst trackingStack: TrackingContext[] = [];\n\n/** Create a new tracking context */\nfunction createTrackingContext(): TrackingContext {\n  const dependencies = new Set<string>();\n\n  return {\n    get isTracking() {\n      return true;\n    },\n    track(key: string) {\n      dependencies.add(key);\n    },\n    getDependencies() {\n      return dependencies;\n    },\n  };\n}\n\n/** Null tracking context when not tracking */\nconst nullContext: TrackingContext = {\n  isTracking: false,\n  track() {},\n  getDependencies() {\n    return new Set();\n  },\n};\n\n/**\n * Get the current tracking context.\n *\n * @returns The active {@link TrackingContext}, or a null context (no-op) if\n *   no tracking is active.\n *\n * @internal\n */\nexport function getCurrentTracker(): TrackingContext {\n  return trackingStack[trackingStack.length - 1] ?? nullContext;\n}\n\n/**\n * Check if dependency tracking is currently active.\n *\n * @returns `true` if inside a {@link withTracking} call, `false` otherwise.\n *\n * @internal\n */\nexport function isTracking(): boolean {\n  return trackingStack.length > 0;\n}\n\n/**\n * Run a function with dependency tracking.\n *\n * @remarks\n * Pushes a fresh tracking context onto the stack, executes `fn`, then pops\n * the context. Any fact reads inside `fn` are recorded as dependencies.\n * Nesting is supported — inner calls get their own independent context.\n *\n * @param fn - The function to execute under tracking.\n * @returns An object with the computed `value` and a `deps` Set of accessed\n *   fact keys.\n *\n * @internal\n */\nexport function withTracking<T>(fn: () => T): { value: T; deps: Set<string> } {\n  const context = createTrackingContext();\n  trackingStack.push(context);\n\n  try {\n    const value = fn();\n    return { value, deps: context.getDependencies() };\n  } finally {\n    trackingStack.pop();\n  }\n}\n\n/**\n * Run a function without tracking.\n *\n * @remarks\n * Temporarily clears the tracking stack so that fact reads inside `fn` do\n * not register as dependencies. The stack is restored after `fn` returns\n * (even on error). Useful for side-effect reads that should not trigger\n * derivation invalidation.\n *\n * @param fn - The function to execute without tracking.\n * @returns The return value of `fn`.\n *\n * @internal\n */\nexport function withoutTracking<T>(fn: () => T): T {\n  // Temporarily clear the stack\n  const saved = trackingStack.splice(0, trackingStack.length);\n\n  try {\n    return fn();\n  } finally {\n    // Restore the stack (loop avoids spread overflow with deep stacks)\n    for (const ctx of saved) {\n      trackingStack.push(ctx);\n    }\n  }\n}\n\n/**\n * Track a specific key in the current context.\n *\n * @remarks\n * No-op if no tracking context is active.\n *\n * @param key - The fact key to record as a dependency.\n *\n * @internal\n */\nexport function trackAccess(key: string): void {\n  getCurrentTracker().track(key);\n}\n\n/**\n * Prototype pollution guard — shared across all proxy handlers.\n *\n * @remarks\n * Contains `__proto__`, `constructor`, and `prototype`. Every proxy `get`\n * and `has` trap checks this set and returns `undefined` / `false` for\n * matching keys, preventing prototype pollution via proxy-based objects.\n *\n * @internal\n */\nexport const BLOCKED_PROPS: ReadonlySet<string> = Object.freeze(\n  new Set([\"__proto__\", \"constructor\", \"prototype\"]),\n);\n"]}
+{"version":3,"sources":["../src/core/types/adapter-utils.ts","../src/core/tracking.ts"],"names":["setBridgeFact","facts","key","value","getBridgeFact","createCallbackPlugin","name","callbacks","req","requirementGuard","type","requirementGuardMultiple","types","typeSet","trackingStack","createTrackingContext","dependencies","nullContext","getCurrentTracker","isTracking","withTracking","fn","context","withoutTracking","saved","ctx","trackAccess","len","BLOCKED_PROPS"],"mappings":"AA8FO,SAASA,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACM,CACLF,CAAAA,CAAkCC,CAAG,CAAA,CAAIC,EAC5C,CAWO,SAASC,CAAAA,CAAiBH,CAAAA,CAAsBC,EAAgB,CACrE,OAAQD,CAAAA,CAAkCC,CAAG,CAC/C,CAyJO,SAASG,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACa,CACb,OAAO,CACL,IAAA,CAAAD,EACA,oBAAA,CAAsBC,CAAAA,CAAU,oBAAA,CAC3BC,CAAAA,EAAQD,CAAAA,CAAU,oBAAA,CAAsBC,CAAAA,CAAI,WAAW,CAAA,CACxD,MAAA,CACJ,gBAAA,CAAkBD,CAAAA,CAAU,qBAAA,CACvBC,CAAAA,EAAQD,EAAU,qBAAA,CAAuBC,CAAAA,CAAI,WAAW,CAAA,CACzD,MAAA,CACJ,OAAA,CAASD,CAAAA,CAAU,OACrB,CACF,CAyCO,SAASE,CAAAA,CACdC,CAAAA,CACgC,CAChC,OAAQF,CAAAA,EAAkBA,CAAAA,CAAI,IAAA,GAASE,CACzC,CAUO,SAASC,CAAAA,CACdC,CAAAA,CACgC,CAChC,IAAMC,CAAAA,CAAU,IAAI,GAAA,CAAID,CAAK,EAC7B,OAAQJ,CAAAA,EAAkBK,CAAAA,CAAQ,GAAA,CAAIL,CAAAA,CAAI,IAAI,CAChD,CC1UA,IAAMM,CAAAA,CAAmC,EAAC,CAG1C,SAASC,CAAAA,EAAyC,CAChD,IAAMC,CAAAA,CAAe,IAAI,GAAA,CAEzB,OAAO,CACL,IAAI,UAAA,EAAa,CACf,OAAO,KACT,CAAA,CACA,KAAA,CAAMd,CAAAA,CAAa,CACjBc,CAAAA,CAAa,GAAA,CAAId,CAAG,EACtB,CAAA,CACA,eAAA,EAAkB,CAChB,OAAOc,CACT,CACF,CACF,CAGA,IAAMC,CAAAA,CAA+B,CACnC,WAAY,KAAA,CACZ,KAAA,EAAQ,CAAC,CAAA,CACT,eAAA,EAAkB,CAChB,OAAO,IAAI,GACb,CACF,CAAA,CAUO,SAASC,CAAAA,EAAqC,CACnD,OAAOJ,CAAAA,CAAcA,CAAAA,CAAc,MAAA,CAAS,CAAC,CAAA,EAAKG,CACpD,CASO,SAASE,CAAAA,EAAsB,CACpC,OAAOL,CAAAA,CAAc,MAAA,CAAS,CAChC,CAgBO,SAASM,CAAAA,CAAgBC,CAAAA,CAA8C,CAC5E,IAAMC,CAAAA,CAAUP,CAAAA,EAAsB,CACtCD,CAAAA,CAAc,IAAA,CAAKQ,CAAO,CAAA,CAE1B,GAAI,CAEF,OAAO,CAAE,KAAA,CADKD,CAAAA,EAAG,CACD,IAAA,CAAMC,CAAAA,CAAQ,eAAA,EAAkB,CAClD,CAAA,OAAE,CACAR,CAAAA,CAAc,GAAA,GAChB,CACF,CAgBO,SAASS,CAAAA,CAAmBF,CAAAA,CAAgB,CAEjD,IAAMG,CAAAA,CAAQV,CAAAA,CAAc,MAAA,CAAO,CAAA,CAAGA,CAAAA,CAAc,MAAM,CAAA,CAE1D,GAAI,CACF,OAAOO,CAAAA,EACT,CAAA,OAAE,CAEA,IAAA,IAAWI,CAAAA,IAAOD,CAAAA,CAChBV,CAAAA,CAAc,IAAA,CAAKW,CAAG,EAE1B,CACF,CAYO,SAASC,CAAAA,CAAYxB,CAAAA,CAAmB,CAE7C,IAAMyB,CAAAA,CAAMb,CAAAA,CAAc,MAAA,CACtBa,CAAAA,GAAQ,CAAA,EAGZb,CAAAA,CAAca,CAAAA,CAAM,CAAC,CAAA,CAAG,KAAA,CAAMzB,CAAG,EACnC,CAYO,IAAM0B,CAAAA,CAAqC,MAAA,CAAO,MAAA,CACvD,IAAI,GAAA,CAAI,CAAC,WAAA,CAAa,aAAA,CAAe,WAAW,CAAC,CACnD","file":"chunk-EFBBEXDA.js","sourcesContent":["/**\n * Adapter Type Utilities - Shared types and helpers for framework adapters\n *\n * These utilities reduce type assertions in adapters by providing:\n * - Schema composition types\n * - Constraint/resolver converters\n * - Plugin factory helpers\n */\n\nimport type { Facts } from \"./facts.js\";\nimport type { Plugin } from \"./plugins.js\";\nimport type { ConstraintDef, Requirement } from \"./requirements.js\";\nimport type { ResolverContext, ResolverDef } from \"./resolvers.js\";\nimport type { InferSchema, Schema } from \"./schema.js\";\n\n// ============================================================================\n// Schema Composition Types\n// ============================================================================\n\n/**\n * Merge two schemas into one.\n * Useful for adapters that add bridge-specific facts to user schemas.\n *\n * @example\n * ```typescript\n * type BridgeFields = { __state: SchemaType<Record<string, unknown>> };\n * type Combined = MergedSchema<UserSchema, BridgeFields>;\n * ```\n */\nexport type MergedSchema<Base extends Schema, Extra extends Schema> = Base &\n  Extra;\n\n/**\n * Create a schema type from a fields definition.\n * Helper for defining adapter bridge schemas.\n *\n * @example\n * ```typescript\n * type AdapterBridgeSchema = BridgeSchema<{\n *   __adapterState: SchemaType<Record<string, unknown>>;\n * }>;\n * ```\n */\nexport type BridgeSchema<Fields extends Schema> = Fields;\n\n// ============================================================================\n// Bridge Schema Helper\n// ============================================================================\n\n/**\n * Create a bridge schema definition for adapters.\n * Returns a schema object compatible with createModule().\n *\n * @example\n * ```typescript\n * const bridgeSchema = createBridgeSchema({\n *   __state: t.object<Record<string, unknown>>(),\n * });\n * ```\n */\nexport function createBridgeSchema<S extends Schema>(schema: S): S {\n  return schema;\n}\n\n// ============================================================================\n// Type-Safe Fact Mutation\n// ============================================================================\n\n/**\n * Type-safe fact setter for known schema keys.\n * Use when you have a typed schema and want to set a specific fact.\n *\n * @example\n * ```typescript\n * setFact(facts, \"count\", 10); // Type-checked\n * ```\n */\nexport function setFact<S extends Schema, K extends keyof InferSchema<S>>(\n  facts: Facts<S>,\n  key: K,\n  value: InferSchema<S>[K],\n): void {\n  (facts as Record<string, unknown>)[key as string] = value;\n}\n\n/**\n * Set a bridge fact without strict typing.\n * Use for adapter-internal bridge fields like `__adapterState`.\n *\n * @example\n * ```typescript\n * setBridgeFact(facts, \"__adapterState\", currentState);\n * ```\n */\nexport function setBridgeFact<V>(\n  facts: Facts<Schema>,\n  key: string,\n  value: V,\n): void {\n  (facts as Record<string, unknown>)[key] = value;\n}\n\n/**\n * Get a bridge fact without strict typing.\n * Use for adapter-internal bridge fields.\n *\n * @example\n * ```typescript\n * const state = getBridgeFact<MyState>(facts, \"__adapterState\");\n * ```\n */\nexport function getBridgeFact<V>(facts: Facts<Schema>, key: string): V {\n  return (facts as Record<string, unknown>)[key] as V;\n}\n\n// ============================================================================\n// Constraint Converters\n// ============================================================================\n\n/**\n * Adapter constraint definition (generic form used by adapters).\n */\nexport interface AdapterConstraint<TState> {\n  when: (state: TState) => boolean | Promise<boolean>;\n  require: Requirement | ((state: TState) => Requirement | null);\n  priority?: number;\n}\n\n/**\n * Convert adapter-style constraints to Directive format.\n * Maps adapter constraints that work with external state (TState) to\n * Directive constraints that work with Facts<Schema>.\n *\n * @param constraints - Adapter constraints keyed by name\n * @param extractState - Function to extract adapter state from facts\n *\n * @example\n * ```typescript\n * const directiveConstraints = convertConstraints<MyState, BridgeSchema>(\n *   adapterConstraints,\n *   (facts) => getBridgeFact<MyState>(facts, \"__state\"),\n * );\n * ```\n */\nexport function convertConstraints<TState, S extends Schema>(\n  constraints: Record<string, AdapterConstraint<TState>>,\n  extractState: (facts: Facts<S>) => TState,\n): Record<string, ConstraintDef<S, Requirement>> {\n  const result: Record<string, ConstraintDef<S, Requirement>> = {};\n\n  for (const [id, constraint] of Object.entries(constraints)) {\n    result[id] = {\n      priority: constraint.priority ?? 0,\n      when: (facts) => constraint.when(extractState(facts)),\n      require: (facts) => {\n        const req =\n          typeof constraint.require === \"function\"\n            ? constraint.require(extractState(facts))\n            : constraint.require;\n        return req;\n      },\n    };\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Resolver Converters\n// ============================================================================\n\n/**\n * Adapter resolver context (generic form used by adapters).\n */\nexport interface AdapterResolverContext<TContext> {\n  context: TContext;\n  signal: AbortSignal;\n}\n\n/**\n * Adapter resolver definition (generic form used by adapters).\n */\nexport interface AdapterResolver<\n  TContext,\n  R extends Requirement = Requirement,\n> {\n  requirement: (req: Requirement) => req is R;\n  key?: (req: R) => string;\n  resolve: (\n    req: R,\n    ctx: AdapterResolverContext<TContext>,\n  ) => void | Promise<void>;\n}\n\n/**\n * Convert adapter-style resolvers to Directive format.\n * Maps adapter resolvers that work with external context (TContext) to\n * Directive resolvers that work with ResolverContext<Schema>.\n *\n * @param resolvers - Adapter resolvers keyed by name\n * @param createContext - Function to create adapter context from Directive context\n *\n * @example\n * ```typescript\n * const directiveResolvers = convertResolvers<MyContext, BridgeSchema>(\n *   adapterResolvers,\n *   (ctx) => ({\n *     getState: () => getBridgeFact<MyState>(ctx.facts, \"__state\"),\n *     setState: (update) => setBridgeFact(ctx.facts, \"__state\", update),\n *     signal: ctx.signal,\n *   }),\n * );\n * ```\n */\nexport function convertResolvers<TContext, S extends Schema>(\n  resolvers: Record<string, AdapterResolver<TContext, Requirement>>,\n  createContext: (ctx: ResolverContext<S>) => TContext,\n): Record<string, ResolverDef<S, Requirement>> {\n  const result: Record<string, ResolverDef<S, Requirement>> = {};\n\n  for (const [id, resolver] of Object.entries(resolvers)) {\n    result[id] = {\n      requirement: resolver.requirement,\n      key: resolver.key,\n      resolve: async (req, ctx) => {\n        const adapterCtx = createContext(ctx);\n        await resolver.resolve(req, {\n          context: adapterCtx,\n          signal: ctx.signal,\n        });\n      },\n    };\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Plugin Factory\n// ============================================================================\n\n/**\n * Callback definitions for adapter plugins.\n */\nexport interface AdapterCallbacks {\n  onRequirementCreated?: (req: Requirement) => void;\n  onRequirementResolved?: (req: Requirement) => void;\n  onError?: (error: Error) => void;\n}\n\n/**\n * Create a callback plugin for adapter events.\n * Wraps adapter callbacks in a Directive plugin.\n *\n * @param name - Plugin name (for debugging)\n * @param callbacks - Callback functions to invoke\n *\n * @example\n * ```typescript\n * const callbackPlugin = createCallbackPlugin(\"adapter-callbacks\", {\n *   onRequirementCreated: (req) => console.log(\"Created:\", req),\n *   onRequirementResolved: (req) => console.log(\"Resolved:\", req),\n * });\n * ```\n */\n// biome-ignore lint/suspicious/noExplicitAny: Plugins work with any schema type\nexport function createCallbackPlugin(\n  name: string,\n  callbacks: AdapterCallbacks,\n): Plugin<any> {\n  return {\n    name,\n    onRequirementCreated: callbacks.onRequirementCreated\n      ? (req) => callbacks.onRequirementCreated!(req.requirement)\n      : undefined,\n    onRequirementMet: callbacks.onRequirementResolved\n      ? (req) => callbacks.onRequirementResolved!(req.requirement)\n      : undefined,\n    onError: callbacks.onError,\n  };\n}\n\n// ============================================================================\n// Module Config Helpers\n// ============================================================================\n\n/**\n * Cast constraints to the correct type for createModule.\n * Use this when TypeScript can't infer the constraint types correctly.\n */\nexport function asConstraints<S extends Schema>(\n  constraints: Record<string, ConstraintDef<S, Requirement>>,\n): Record<string, ConstraintDef<S, Requirement>> {\n  return constraints;\n}\n\n/**\n * Cast resolvers to the correct type for createModule.\n * Use this when TypeScript can't infer the resolver types correctly.\n */\nexport function asResolvers<S extends Schema>(\n  resolvers: Record<string, ResolverDef<S, Requirement>>,\n): Record<string, ResolverDef<S, Requirement>> {\n  return resolvers;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Create a type guard for a specific requirement type.\n * Simplifies the common pattern of checking req.type.\n *\n * @example\n * ```typescript\n * const isResetReq = requirementGuard<ResetReq>(\"RESET\");\n * // Use in resolver:\n * { requirement: isResetReq, resolve: ... }\n * ```\n */\nexport function requirementGuard<R extends Requirement>(\n  type: R[\"type\"],\n): (req: Requirement) => req is R {\n  return (req): req is R => req.type === type;\n}\n\n/**\n * Create a type guard that matches multiple requirement types.\n *\n * @example\n * ```typescript\n * const isDataReq = requirementGuardMultiple<FetchReq | RefreshReq>([\"FETCH\", \"REFRESH\"]);\n * ```\n */\nexport function requirementGuardMultiple<R extends Requirement>(\n  types: Array<R[\"type\"]>,\n): (req: Requirement) => req is R {\n  const typeSet = new Set(types);\n  return (req): req is R => typeSet.has(req.type);\n}\n","/**\n * Dependency tracking context for auto-tracking derivations\n *\n * Uses a stack-based approach to handle nested derivation computations.\n * When a derivation accesses a fact, the tracking context records it.\n */\n\nimport type { TrackingContext } from \"./types.js\";\n\n/** Stack of active tracking contexts */\nconst trackingStack: TrackingContext[] = [];\n\n/** Create a new tracking context */\nfunction createTrackingContext(): TrackingContext {\n  const dependencies = new Set<string>();\n\n  return {\n    get isTracking() {\n      return true;\n    },\n    track(key: string) {\n      dependencies.add(key);\n    },\n    getDependencies() {\n      return dependencies;\n    },\n  };\n}\n\n/** Null tracking context when not tracking */\nconst nullContext: TrackingContext = {\n  isTracking: false,\n  track() {},\n  getDependencies() {\n    return new Set();\n  },\n};\n\n/**\n * Get the current tracking context.\n *\n * @returns The active {@link TrackingContext}, or a null context (no-op) if\n *   no tracking is active.\n *\n * @internal\n */\nexport function getCurrentTracker(): TrackingContext {\n  return trackingStack[trackingStack.length - 1] ?? nullContext;\n}\n\n/**\n * Check if dependency tracking is currently active.\n *\n * @returns `true` if inside a {@link withTracking} call, `false` otherwise.\n *\n * @internal\n */\nexport function isTracking(): boolean {\n  return trackingStack.length > 0;\n}\n\n/**\n * Run a function with dependency tracking.\n *\n * @remarks\n * Pushes a fresh tracking context onto the stack, executes `fn`, then pops\n * the context. Any fact reads inside `fn` are recorded as dependencies.\n * Nesting is supported — inner calls get their own independent context.\n *\n * @param fn - The function to execute under tracking.\n * @returns An object with the computed `value` and a `deps` Set of accessed\n *   fact keys.\n *\n * @internal\n */\nexport function withTracking<T>(fn: () => T): { value: T; deps: Set<string> } {\n  const context = createTrackingContext();\n  trackingStack.push(context);\n\n  try {\n    const value = fn();\n    return { value, deps: context.getDependencies() };\n  } finally {\n    trackingStack.pop();\n  }\n}\n\n/**\n * Run a function without tracking.\n *\n * @remarks\n * Temporarily clears the tracking stack so that fact reads inside `fn` do\n * not register as dependencies. The stack is restored after `fn` returns\n * (even on error). Useful for side-effect reads that should not trigger\n * derivation invalidation.\n *\n * @param fn - The function to execute without tracking.\n * @returns The return value of `fn`.\n *\n * @internal\n */\nexport function withoutTracking<T>(fn: () => T): T {\n  // Temporarily clear the stack\n  const saved = trackingStack.splice(0, trackingStack.length);\n\n  try {\n    return fn();\n  } finally {\n    // Restore the stack (loop avoids spread overflow with deep stacks)\n    for (const ctx of saved) {\n      trackingStack.push(ctx);\n    }\n  }\n}\n\n/**\n * Track a specific key in the current context.\n *\n * @remarks\n * No-op if no tracking context is active.\n *\n * @param key - The fact key to record as a dependency.\n *\n * @internal\n */\nexport function trackAccess(key: string): void {\n  // Fast path: skip when no tracking context is active (99% of calls)\n  const len = trackingStack.length;\n  if (len === 0) {\n    return;\n  }\n  trackingStack[len - 1]!.track(key);\n}\n\n/**\n * Prototype pollution guard — shared across all proxy handlers.\n *\n * @remarks\n * Contains `__proto__`, `constructor`, and `prototype`. Every proxy `get`\n * and `has` trap checks this set and returns `undefined` / `false` for\n * matching keys, preventing prototype pollution via proxy-based objects.\n *\n * @internal\n */\nexport const BLOCKED_PROPS: ReadonlySet<string> = Object.freeze(\n  new Set([\"__proto__\", \"constructor\", \"prototype\"]),\n);\n"]}

package/dist/chunk-ER6QUYTL.cjs

@@ -0,0 +1,2 @@
+'use strict';function s(t,e,r){t[e]=r;}function a(t,e){return t[e]}function c(t,e){return {name:t,onRequirementCreated:e.onRequirementCreated?r=>e.onRequirementCreated(r.requirement):void 0,onRequirementMet:e.onRequirementResolved?r=>e.onRequirementResolved(r.requirement):void 0,onError:e.onError}}function u(t){return e=>e.type===t}function d(t){let e=new Set(t);return r=>e.has(r.type)}var n=[];function o(){let t=new Set;return {get isTracking(){return  true},track(e){t.add(e);},getDependencies(){return t}}}var i={isTracking:false,track(){},getDependencies(){return new Set}};function R(){return n[n.length-1]??i}function m(){return n.length>0}function x(t){let e=o();n.push(e);try{return {value:t(),deps:e.getDependencies()}}finally{n.pop();}}function f(t){let e=n.splice(0,n.length);try{return t()}finally{for(let r of e)n.push(r);}}function g(t){let e=n.length;e!==0&&n[e-1].track(t);}var q=Object.freeze(new Set(["__proto__","constructor","prototype"]));exports.a=s;exports.b=a;exports.c=c;exports.d=u;exports.e=d;exports.f=R;exports.g=m;exports.h=x;exports.i=f;exports.j=g;exports.k=q;//# sourceMappingURL=chunk-ER6QUYTL.cjs.map
+//# sourceMappingURL=chunk-ER6QUYTL.cjs.map

package/dist/{chunk-PK2EH26L.cjs.map → chunk-ER6QUYTL.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/types/adapter-utils.ts","../src/core/tracking.ts"],"names":["setBridgeFact","facts","key","value","getBridgeFact","createCallbackPlugin","name","callbacks","req","requirementGuard","type","requirementGuardMultiple","types","typeSet","trackingStack","createTrackingContext","dependencies","nullContext","getCurrentTracker","isTracking","withTracking","fn","context","withoutTracking","saved","ctx","trackAccess","BLOCKED_PROPS"],"mappings":"aA8FO,SAASA,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACM,CACLF,EAAkCC,CAAG,CAAA,CAAIC,EAC5C,CAWO,SAASC,CAAAA,CAAiBH,EAAsBC,CAAAA,CAAgB,CACrE,OAAQD,CAAAA,CAAkCC,CAAG,CAC/C,CAyJO,SAASG,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACa,CACb,OAAO,CACL,KAAAD,CAAAA,CACA,oBAAA,CAAsBC,CAAAA,CAAU,oBAAA,CAC3BC,CAAAA,EAAQD,CAAAA,CAAU,qBAAsBC,CAAAA,CAAI,WAAW,CAAA,CACxD,MAAA,CACJ,gBAAA,CAAkBD,CAAAA,CAAU,sBACvBC,CAAAA,EAAQD,CAAAA,CAAU,qBAAA,CAAuBC,CAAAA,CAAI,WAAW,CAAA,CACzD,MAAA,CACJ,OAAA,CAASD,CAAAA,CAAU,OACrB,CACF,CAyCO,SAASE,CAAAA,CACdC,EACgC,CAChC,OAAQF,CAAAA,EAAkBA,CAAAA,CAAI,IAAA,GAASE,CACzC,CAUO,SAASC,CAAAA,CACdC,CAAAA,CACgC,CAChC,IAAMC,CAAAA,CAAU,IAAI,GAAA,CAAID,CAAK,CAAA,CAC7B,OAAQJ,CAAAA,EAAkBK,CAAAA,CAAQ,GAAA,CAAIL,CAAAA,CAAI,IAAI,CAChD,CC1UA,IAAMM,CAAAA,CAAmC,GAGzC,SAASC,CAAAA,EAAyC,CAChD,IAAMC,CAAAA,CAAe,IAAI,GAAA,CAEzB,OAAO,CACL,IAAI,UAAA,EAAa,CACf,OAAO,KACT,EACA,KAAA,CAAMd,CAAAA,CAAa,CACjBc,CAAAA,CAAa,GAAA,CAAId,CAAG,EACtB,CAAA,CACA,eAAA,EAAkB,CAChB,OAAOc,CACT,CACF,CACF,CAGA,IAAMC,CAAAA,CAA+B,CACnC,UAAA,CAAY,KAAA,CACZ,KAAA,EAAQ,CAAC,CAAA,CACT,eAAA,EAAkB,CAChB,OAAO,IAAI,GACb,CACF,CAAA,CAUO,SAASC,CAAAA,EAAqC,CACnD,OAAOJ,CAAAA,CAAcA,CAAAA,CAAc,MAAA,CAAS,CAAC,CAAA,EAAKG,CACpD,CASO,SAASE,CAAAA,EAAsB,CACpC,OAAOL,CAAAA,CAAc,MAAA,CAAS,CAChC,CAgBO,SAASM,EAAgBC,CAAAA,CAA8C,CAC5E,IAAMC,CAAAA,CAAUP,CAAAA,EAAsB,CACtCD,EAAc,IAAA,CAAKQ,CAAO,CAAA,CAE1B,GAAI,CAEF,OAAO,CAAE,KAAA,CADKD,CAAAA,EAAG,CACD,IAAA,CAAMC,CAAAA,CAAQ,eAAA,EAAkB,CAClD,CAAA,OAAE,CACAR,CAAAA,CAAc,GAAA,GAChB,CACF,CAgBO,SAASS,CAAAA,CAAmBF,CAAAA,CAAgB,CAEjD,IAAMG,CAAAA,CAAQV,EAAc,MAAA,CAAO,CAAA,CAAGA,CAAAA,CAAc,MAAM,CAAA,CAE1D,GAAI,CACF,OAAOO,CAAAA,EACT,CAAA,OAAE,CAEA,IAAA,IAAWI,CAAAA,IAAOD,EAChBV,CAAAA,CAAc,IAAA,CAAKW,CAAG,EAE1B,CACF,CAYO,SAASC,CAAAA,CAAYxB,CAAAA,CAAmB,CAC7CgB,CAAAA,EAAkB,CAAE,KAAA,CAAMhB,CAAG,EAC/B,CAYO,IAAMyB,CAAAA,CAAqC,MAAA,CAAO,MAAA,CACvD,IAAI,GAAA,CAAI,CAAC,WAAA,CAAa,aAAA,CAAe,WAAW,CAAC,CACnD","file":"chunk-PK2EH26L.cjs","sourcesContent":["/**\n * Adapter Type Utilities - Shared types and helpers for framework adapters\n *\n * These utilities reduce type assertions in adapters by providing:\n * - Schema composition types\n * - Constraint/resolver converters\n * - Plugin factory helpers\n */\n\nimport type { Facts } from \"./facts.js\";\nimport type { Plugin } from \"./plugins.js\";\nimport type { ConstraintDef, Requirement } from \"./requirements.js\";\nimport type { ResolverContext, ResolverDef } from \"./resolvers.js\";\nimport type { InferSchema, Schema } from \"./schema.js\";\n\n// ============================================================================\n// Schema Composition Types\n// ============================================================================\n\n/**\n * Merge two schemas into one.\n * Useful for adapters that add bridge-specific facts to user schemas.\n *\n * @example\n * ```typescript\n * type BridgeFields = { __state: SchemaType<Record<string, unknown>> };\n * type Combined = MergedSchema<UserSchema, BridgeFields>;\n * ```\n */\nexport type MergedSchema<Base extends Schema, Extra extends Schema> = Base &\n  Extra;\n\n/**\n * Create a schema type from a fields definition.\n * Helper for defining adapter bridge schemas.\n *\n * @example\n * ```typescript\n * type AdapterBridgeSchema = BridgeSchema<{\n *   __adapterState: SchemaType<Record<string, unknown>>;\n * }>;\n * ```\n */\nexport type BridgeSchema<Fields extends Schema> = Fields;\n\n// ============================================================================\n// Bridge Schema Helper\n// ============================================================================\n\n/**\n * Create a bridge schema definition for adapters.\n * Returns a schema object compatible with createModule().\n *\n * @example\n * ```typescript\n * const bridgeSchema = createBridgeSchema({\n *   __state: t.object<Record<string, unknown>>(),\n * });\n * ```\n */\nexport function createBridgeSchema<S extends Schema>(schema: S): S {\n  return schema;\n}\n\n// ============================================================================\n// Type-Safe Fact Mutation\n// ============================================================================\n\n/**\n * Type-safe fact setter for known schema keys.\n * Use when you have a typed schema and want to set a specific fact.\n *\n * @example\n * ```typescript\n * setFact(facts, \"count\", 10); // Type-checked\n * ```\n */\nexport function setFact<S extends Schema, K extends keyof InferSchema<S>>(\n  facts: Facts<S>,\n  key: K,\n  value: InferSchema<S>[K],\n): void {\n  (facts as Record<string, unknown>)[key as string] = value;\n}\n\n/**\n * Set a bridge fact without strict typing.\n * Use for adapter-internal bridge fields like `__adapterState`.\n *\n * @example\n * ```typescript\n * setBridgeFact(facts, \"__adapterState\", currentState);\n * ```\n */\nexport function setBridgeFact<V>(\n  facts: Facts<Schema>,\n  key: string,\n  value: V,\n): void {\n  (facts as Record<string, unknown>)[key] = value;\n}\n\n/**\n * Get a bridge fact without strict typing.\n * Use for adapter-internal bridge fields.\n *\n * @example\n * ```typescript\n * const state = getBridgeFact<MyState>(facts, \"__adapterState\");\n * ```\n */\nexport function getBridgeFact<V>(facts: Facts<Schema>, key: string): V {\n  return (facts as Record<string, unknown>)[key] as V;\n}\n\n// ============================================================================\n// Constraint Converters\n// ============================================================================\n\n/**\n * Adapter constraint definition (generic form used by adapters).\n */\nexport interface AdapterConstraint<TState> {\n  when: (state: TState) => boolean | Promise<boolean>;\n  require: Requirement | ((state: TState) => Requirement | null);\n  priority?: number;\n}\n\n/**\n * Convert adapter-style constraints to Directive format.\n * Maps adapter constraints that work with external state (TState) to\n * Directive constraints that work with Facts<Schema>.\n *\n * @param constraints - Adapter constraints keyed by name\n * @param extractState - Function to extract adapter state from facts\n *\n * @example\n * ```typescript\n * const directiveConstraints = convertConstraints<MyState, BridgeSchema>(\n *   adapterConstraints,\n *   (facts) => getBridgeFact<MyState>(facts, \"__state\"),\n * );\n * ```\n */\nexport function convertConstraints<TState, S extends Schema>(\n  constraints: Record<string, AdapterConstraint<TState>>,\n  extractState: (facts: Facts<S>) => TState,\n): Record<string, ConstraintDef<S, Requirement>> {\n  const result: Record<string, ConstraintDef<S, Requirement>> = {};\n\n  for (const [id, constraint] of Object.entries(constraints)) {\n    result[id] = {\n      priority: constraint.priority ?? 0,\n      when: (facts) => constraint.when(extractState(facts)),\n      require: (facts) => {\n        const req =\n          typeof constraint.require === \"function\"\n            ? constraint.require(extractState(facts))\n            : constraint.require;\n        return req;\n      },\n    };\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Resolver Converters\n// ============================================================================\n\n/**\n * Adapter resolver context (generic form used by adapters).\n */\nexport interface AdapterResolverContext<TContext> {\n  context: TContext;\n  signal: AbortSignal;\n}\n\n/**\n * Adapter resolver definition (generic form used by adapters).\n */\nexport interface AdapterResolver<\n  TContext,\n  R extends Requirement = Requirement,\n> {\n  requirement: (req: Requirement) => req is R;\n  key?: (req: R) => string;\n  resolve: (\n    req: R,\n    ctx: AdapterResolverContext<TContext>,\n  ) => void | Promise<void>;\n}\n\n/**\n * Convert adapter-style resolvers to Directive format.\n * Maps adapter resolvers that work with external context (TContext) to\n * Directive resolvers that work with ResolverContext<Schema>.\n *\n * @param resolvers - Adapter resolvers keyed by name\n * @param createContext - Function to create adapter context from Directive context\n *\n * @example\n * ```typescript\n * const directiveResolvers = convertResolvers<MyContext, BridgeSchema>(\n *   adapterResolvers,\n *   (ctx) => ({\n *     getState: () => getBridgeFact<MyState>(ctx.facts, \"__state\"),\n *     setState: (update) => setBridgeFact(ctx.facts, \"__state\", update),\n *     signal: ctx.signal,\n *   }),\n * );\n * ```\n */\nexport function convertResolvers<TContext, S extends Schema>(\n  resolvers: Record<string, AdapterResolver<TContext, Requirement>>,\n  createContext: (ctx: ResolverContext<S>) => TContext,\n): Record<string, ResolverDef<S, Requirement>> {\n  const result: Record<string, ResolverDef<S, Requirement>> = {};\n\n  for (const [id, resolver] of Object.entries(resolvers)) {\n    result[id] = {\n      requirement: resolver.requirement,\n      key: resolver.key,\n      resolve: async (req, ctx) => {\n        const adapterCtx = createContext(ctx);\n        await resolver.resolve(req, {\n          context: adapterCtx,\n          signal: ctx.signal,\n        });\n      },\n    };\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Plugin Factory\n// ============================================================================\n\n/**\n * Callback definitions for adapter plugins.\n */\nexport interface AdapterCallbacks {\n  onRequirementCreated?: (req: Requirement) => void;\n  onRequirementResolved?: (req: Requirement) => void;\n  onError?: (error: Error) => void;\n}\n\n/**\n * Create a callback plugin for adapter events.\n * Wraps adapter callbacks in a Directive plugin.\n *\n * @param name - Plugin name (for debugging)\n * @param callbacks - Callback functions to invoke\n *\n * @example\n * ```typescript\n * const callbackPlugin = createCallbackPlugin(\"adapter-callbacks\", {\n *   onRequirementCreated: (req) => console.log(\"Created:\", req),\n *   onRequirementResolved: (req) => console.log(\"Resolved:\", req),\n * });\n * ```\n */\n// biome-ignore lint/suspicious/noExplicitAny: Plugins work with any schema type\nexport function createCallbackPlugin(\n  name: string,\n  callbacks: AdapterCallbacks,\n): Plugin<any> {\n  return {\n    name,\n    onRequirementCreated: callbacks.onRequirementCreated\n      ? (req) => callbacks.onRequirementCreated!(req.requirement)\n      : undefined,\n    onRequirementMet: callbacks.onRequirementResolved\n      ? (req) => callbacks.onRequirementResolved!(req.requirement)\n      : undefined,\n    onError: callbacks.onError,\n  };\n}\n\n// ============================================================================\n// Module Config Helpers\n// ============================================================================\n\n/**\n * Cast constraints to the correct type for createModule.\n * Use this when TypeScript can't infer the constraint types correctly.\n */\nexport function asConstraints<S extends Schema>(\n  constraints: Record<string, ConstraintDef<S, Requirement>>,\n): Record<string, ConstraintDef<S, Requirement>> {\n  return constraints;\n}\n\n/**\n * Cast resolvers to the correct type for createModule.\n * Use this when TypeScript can't infer the resolver types correctly.\n */\nexport function asResolvers<S extends Schema>(\n  resolvers: Record<string, ResolverDef<S, Requirement>>,\n): Record<string, ResolverDef<S, Requirement>> {\n  return resolvers;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Create a type guard for a specific requirement type.\n * Simplifies the common pattern of checking req.type.\n *\n * @example\n * ```typescript\n * const isResetReq = requirementGuard<ResetReq>(\"RESET\");\n * // Use in resolver:\n * { requirement: isResetReq, resolve: ... }\n * ```\n */\nexport function requirementGuard<R extends Requirement>(\n  type: R[\"type\"],\n): (req: Requirement) => req is R {\n  return (req): req is R => req.type === type;\n}\n\n/**\n * Create a type guard that matches multiple requirement types.\n *\n * @example\n * ```typescript\n * const isDataReq = requirementGuardMultiple<FetchReq | RefreshReq>([\"FETCH\", \"REFRESH\"]);\n * ```\n */\nexport function requirementGuardMultiple<R extends Requirement>(\n  types: Array<R[\"type\"]>,\n): (req: Requirement) => req is R {\n  const typeSet = new Set(types);\n  return (req): req is R => typeSet.has(req.type);\n}\n","/**\n * Dependency tracking context for auto-tracking derivations\n *\n * Uses a stack-based approach to handle nested derivation computations.\n * When a derivation accesses a fact, the tracking context records it.\n */\n\nimport type { TrackingContext } from \"./types.js\";\n\n/** Stack of active tracking contexts */\nconst trackingStack: TrackingContext[] = [];\n\n/** Create a new tracking context */\nfunction createTrackingContext(): TrackingContext {\n  const dependencies = new Set<string>();\n\n  return {\n    get isTracking() {\n      return true;\n    },\n    track(key: string) {\n      dependencies.add(key);\n    },\n    getDependencies() {\n      return dependencies;\n    },\n  };\n}\n\n/** Null tracking context when not tracking */\nconst nullContext: TrackingContext = {\n  isTracking: false,\n  track() {},\n  getDependencies() {\n    return new Set();\n  },\n};\n\n/**\n * Get the current tracking context.\n *\n * @returns The active {@link TrackingContext}, or a null context (no-op) if\n *   no tracking is active.\n *\n * @internal\n */\nexport function getCurrentTracker(): TrackingContext {\n  return trackingStack[trackingStack.length - 1] ?? nullContext;\n}\n\n/**\n * Check if dependency tracking is currently active.\n *\n * @returns `true` if inside a {@link withTracking} call, `false` otherwise.\n *\n * @internal\n */\nexport function isTracking(): boolean {\n  return trackingStack.length > 0;\n}\n\n/**\n * Run a function with dependency tracking.\n *\n * @remarks\n * Pushes a fresh tracking context onto the stack, executes `fn`, then pops\n * the context. Any fact reads inside `fn` are recorded as dependencies.\n * Nesting is supported — inner calls get their own independent context.\n *\n * @param fn - The function to execute under tracking.\n * @returns An object with the computed `value` and a `deps` Set of accessed\n *   fact keys.\n *\n * @internal\n */\nexport function withTracking<T>(fn: () => T): { value: T; deps: Set<string> } {\n  const context = createTrackingContext();\n  trackingStack.push(context);\n\n  try {\n    const value = fn();\n    return { value, deps: context.getDependencies() };\n  } finally {\n    trackingStack.pop();\n  }\n}\n\n/**\n * Run a function without tracking.\n *\n * @remarks\n * Temporarily clears the tracking stack so that fact reads inside `fn` do\n * not register as dependencies. The stack is restored after `fn` returns\n * (even on error). Useful for side-effect reads that should not trigger\n * derivation invalidation.\n *\n * @param fn - The function to execute without tracking.\n * @returns The return value of `fn`.\n *\n * @internal\n */\nexport function withoutTracking<T>(fn: () => T): T {\n  // Temporarily clear the stack\n  const saved = trackingStack.splice(0, trackingStack.length);\n\n  try {\n    return fn();\n  } finally {\n    // Restore the stack (loop avoids spread overflow with deep stacks)\n    for (const ctx of saved) {\n      trackingStack.push(ctx);\n    }\n  }\n}\n\n/**\n * Track a specific key in the current context.\n *\n * @remarks\n * No-op if no tracking context is active.\n *\n * @param key - The fact key to record as a dependency.\n *\n * @internal\n */\nexport function trackAccess(key: string): void {\n  getCurrentTracker().track(key);\n}\n\n/**\n * Prototype pollution guard — shared across all proxy handlers.\n *\n * @remarks\n * Contains `__proto__`, `constructor`, and `prototype`. Every proxy `get`\n * and `has` trap checks this set and returns `undefined` / `false` for\n * matching keys, preventing prototype pollution via proxy-based objects.\n *\n * @internal\n */\nexport const BLOCKED_PROPS: ReadonlySet<string> = Object.freeze(\n  new Set([\"__proto__\", \"constructor\", \"prototype\"]),\n);\n"]}
+{"version":3,"sources":["../src/core/types/adapter-utils.ts","../src/core/tracking.ts"],"names":["setBridgeFact","facts","key","value","getBridgeFact","createCallbackPlugin","name","callbacks","req","requirementGuard","type","requirementGuardMultiple","types","typeSet","trackingStack","createTrackingContext","dependencies","nullContext","getCurrentTracker","isTracking","withTracking","fn","context","withoutTracking","saved","ctx","trackAccess","len","BLOCKED_PROPS"],"mappings":"aA8FO,SAASA,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACM,CACLF,CAAAA,CAAkCC,CAAG,CAAA,CAAIC,EAC5C,CAWO,SAASC,CAAAA,CAAiBH,CAAAA,CAAsBC,EAAgB,CACrE,OAAQD,CAAAA,CAAkCC,CAAG,CAC/C,CAyJO,SAASG,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACa,CACb,OAAO,CACL,IAAA,CAAAD,EACA,oBAAA,CAAsBC,CAAAA,CAAU,oBAAA,CAC3BC,CAAAA,EAAQD,CAAAA,CAAU,oBAAA,CAAsBC,CAAAA,CAAI,WAAW,CAAA,CACxD,MAAA,CACJ,gBAAA,CAAkBD,CAAAA,CAAU,qBAAA,CACvBC,CAAAA,EAAQD,EAAU,qBAAA,CAAuBC,CAAAA,CAAI,WAAW,CAAA,CACzD,MAAA,CACJ,OAAA,CAASD,CAAAA,CAAU,OACrB,CACF,CAyCO,SAASE,CAAAA,CACdC,CAAAA,CACgC,CAChC,OAAQF,CAAAA,EAAkBA,CAAAA,CAAI,IAAA,GAASE,CACzC,CAUO,SAASC,CAAAA,CACdC,CAAAA,CACgC,CAChC,IAAMC,CAAAA,CAAU,IAAI,GAAA,CAAID,CAAK,EAC7B,OAAQJ,CAAAA,EAAkBK,CAAAA,CAAQ,GAAA,CAAIL,CAAAA,CAAI,IAAI,CAChD,CC1UA,IAAMM,CAAAA,CAAmC,EAAC,CAG1C,SAASC,CAAAA,EAAyC,CAChD,IAAMC,CAAAA,CAAe,IAAI,GAAA,CAEzB,OAAO,CACL,IAAI,UAAA,EAAa,CACf,OAAO,KACT,CAAA,CACA,KAAA,CAAMd,CAAAA,CAAa,CACjBc,CAAAA,CAAa,GAAA,CAAId,CAAG,EACtB,CAAA,CACA,eAAA,EAAkB,CAChB,OAAOc,CACT,CACF,CACF,CAGA,IAAMC,CAAAA,CAA+B,CACnC,WAAY,KAAA,CACZ,KAAA,EAAQ,CAAC,CAAA,CACT,eAAA,EAAkB,CAChB,OAAO,IAAI,GACb,CACF,CAAA,CAUO,SAASC,CAAAA,EAAqC,CACnD,OAAOJ,CAAAA,CAAcA,CAAAA,CAAc,MAAA,CAAS,CAAC,CAAA,EAAKG,CACpD,CASO,SAASE,CAAAA,EAAsB,CACpC,OAAOL,CAAAA,CAAc,MAAA,CAAS,CAChC,CAgBO,SAASM,CAAAA,CAAgBC,CAAAA,CAA8C,CAC5E,IAAMC,CAAAA,CAAUP,CAAAA,EAAsB,CACtCD,CAAAA,CAAc,IAAA,CAAKQ,CAAO,CAAA,CAE1B,GAAI,CAEF,OAAO,CAAE,KAAA,CADKD,CAAAA,EAAG,CACD,IAAA,CAAMC,CAAAA,CAAQ,eAAA,EAAkB,CAClD,CAAA,OAAE,CACAR,CAAAA,CAAc,GAAA,GAChB,CACF,CAgBO,SAASS,CAAAA,CAAmBF,CAAAA,CAAgB,CAEjD,IAAMG,CAAAA,CAAQV,CAAAA,CAAc,MAAA,CAAO,CAAA,CAAGA,CAAAA,CAAc,MAAM,CAAA,CAE1D,GAAI,CACF,OAAOO,CAAAA,EACT,CAAA,OAAE,CAEA,IAAA,IAAWI,CAAAA,IAAOD,CAAAA,CAChBV,CAAAA,CAAc,IAAA,CAAKW,CAAG,EAE1B,CACF,CAYO,SAASC,CAAAA,CAAYxB,CAAAA,CAAmB,CAE7C,IAAMyB,CAAAA,CAAMb,CAAAA,CAAc,MAAA,CACtBa,CAAAA,GAAQ,CAAA,EAGZb,CAAAA,CAAca,CAAAA,CAAM,CAAC,CAAA,CAAG,KAAA,CAAMzB,CAAG,EACnC,CAYO,IAAM0B,CAAAA,CAAqC,MAAA,CAAO,MAAA,CACvD,IAAI,GAAA,CAAI,CAAC,WAAA,CAAa,aAAA,CAAe,WAAW,CAAC,CACnD","file":"chunk-ER6QUYTL.cjs","sourcesContent":["/**\n * Adapter Type Utilities - Shared types and helpers for framework adapters\n *\n * These utilities reduce type assertions in adapters by providing:\n * - Schema composition types\n * - Constraint/resolver converters\n * - Plugin factory helpers\n */\n\nimport type { Facts } from \"./facts.js\";\nimport type { Plugin } from \"./plugins.js\";\nimport type { ConstraintDef, Requirement } from \"./requirements.js\";\nimport type { ResolverContext, ResolverDef } from \"./resolvers.js\";\nimport type { InferSchema, Schema } from \"./schema.js\";\n\n// ============================================================================\n// Schema Composition Types\n// ============================================================================\n\n/**\n * Merge two schemas into one.\n * Useful for adapters that add bridge-specific facts to user schemas.\n *\n * @example\n * ```typescript\n * type BridgeFields = { __state: SchemaType<Record<string, unknown>> };\n * type Combined = MergedSchema<UserSchema, BridgeFields>;\n * ```\n */\nexport type MergedSchema<Base extends Schema, Extra extends Schema> = Base &\n  Extra;\n\n/**\n * Create a schema type from a fields definition.\n * Helper for defining adapter bridge schemas.\n *\n * @example\n * ```typescript\n * type AdapterBridgeSchema = BridgeSchema<{\n *   __adapterState: SchemaType<Record<string, unknown>>;\n * }>;\n * ```\n */\nexport type BridgeSchema<Fields extends Schema> = Fields;\n\n// ============================================================================\n// Bridge Schema Helper\n// ============================================================================\n\n/**\n * Create a bridge schema definition for adapters.\n * Returns a schema object compatible with createModule().\n *\n * @example\n * ```typescript\n * const bridgeSchema = createBridgeSchema({\n *   __state: t.object<Record<string, unknown>>(),\n * });\n * ```\n */\nexport function createBridgeSchema<S extends Schema>(schema: S): S {\n  return schema;\n}\n\n// ============================================================================\n// Type-Safe Fact Mutation\n// ============================================================================\n\n/**\n * Type-safe fact setter for known schema keys.\n * Use when you have a typed schema and want to set a specific fact.\n *\n * @example\n * ```typescript\n * setFact(facts, \"count\", 10); // Type-checked\n * ```\n */\nexport function setFact<S extends Schema, K extends keyof InferSchema<S>>(\n  facts: Facts<S>,\n  key: K,\n  value: InferSchema<S>[K],\n): void {\n  (facts as Record<string, unknown>)[key as string] = value;\n}\n\n/**\n * Set a bridge fact without strict typing.\n * Use for adapter-internal bridge fields like `__adapterState`.\n *\n * @example\n * ```typescript\n * setBridgeFact(facts, \"__adapterState\", currentState);\n * ```\n */\nexport function setBridgeFact<V>(\n  facts: Facts<Schema>,\n  key: string,\n  value: V,\n): void {\n  (facts as Record<string, unknown>)[key] = value;\n}\n\n/**\n * Get a bridge fact without strict typing.\n * Use for adapter-internal bridge fields.\n *\n * @example\n * ```typescript\n * const state = getBridgeFact<MyState>(facts, \"__adapterState\");\n * ```\n */\nexport function getBridgeFact<V>(facts: Facts<Schema>, key: string): V {\n  return (facts as Record<string, unknown>)[key] as V;\n}\n\n// ============================================================================\n// Constraint Converters\n// ============================================================================\n\n/**\n * Adapter constraint definition (generic form used by adapters).\n */\nexport interface AdapterConstraint<TState> {\n  when: (state: TState) => boolean | Promise<boolean>;\n  require: Requirement | ((state: TState) => Requirement | null);\n  priority?: number;\n}\n\n/**\n * Convert adapter-style constraints to Directive format.\n * Maps adapter constraints that work with external state (TState) to\n * Directive constraints that work with Facts<Schema>.\n *\n * @param constraints - Adapter constraints keyed by name\n * @param extractState - Function to extract adapter state from facts\n *\n * @example\n * ```typescript\n * const directiveConstraints = convertConstraints<MyState, BridgeSchema>(\n *   adapterConstraints,\n *   (facts) => getBridgeFact<MyState>(facts, \"__state\"),\n * );\n * ```\n */\nexport function convertConstraints<TState, S extends Schema>(\n  constraints: Record<string, AdapterConstraint<TState>>,\n  extractState: (facts: Facts<S>) => TState,\n): Record<string, ConstraintDef<S, Requirement>> {\n  const result: Record<string, ConstraintDef<S, Requirement>> = {};\n\n  for (const [id, constraint] of Object.entries(constraints)) {\n    result[id] = {\n      priority: constraint.priority ?? 0,\n      when: (facts) => constraint.when(extractState(facts)),\n      require: (facts) => {\n        const req =\n          typeof constraint.require === \"function\"\n            ? constraint.require(extractState(facts))\n            : constraint.require;\n        return req;\n      },\n    };\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Resolver Converters\n// ============================================================================\n\n/**\n * Adapter resolver context (generic form used by adapters).\n */\nexport interface AdapterResolverContext<TContext> {\n  context: TContext;\n  signal: AbortSignal;\n}\n\n/**\n * Adapter resolver definition (generic form used by adapters).\n */\nexport interface AdapterResolver<\n  TContext,\n  R extends Requirement = Requirement,\n> {\n  requirement: (req: Requirement) => req is R;\n  key?: (req: R) => string;\n  resolve: (\n    req: R,\n    ctx: AdapterResolverContext<TContext>,\n  ) => void | Promise<void>;\n}\n\n/**\n * Convert adapter-style resolvers to Directive format.\n * Maps adapter resolvers that work with external context (TContext) to\n * Directive resolvers that work with ResolverContext<Schema>.\n *\n * @param resolvers - Adapter resolvers keyed by name\n * @param createContext - Function to create adapter context from Directive context\n *\n * @example\n * ```typescript\n * const directiveResolvers = convertResolvers<MyContext, BridgeSchema>(\n *   adapterResolvers,\n *   (ctx) => ({\n *     getState: () => getBridgeFact<MyState>(ctx.facts, \"__state\"),\n *     setState: (update) => setBridgeFact(ctx.facts, \"__state\", update),\n *     signal: ctx.signal,\n *   }),\n * );\n * ```\n */\nexport function convertResolvers<TContext, S extends Schema>(\n  resolvers: Record<string, AdapterResolver<TContext, Requirement>>,\n  createContext: (ctx: ResolverContext<S>) => TContext,\n): Record<string, ResolverDef<S, Requirement>> {\n  const result: Record<string, ResolverDef<S, Requirement>> = {};\n\n  for (const [id, resolver] of Object.entries(resolvers)) {\n    result[id] = {\n      requirement: resolver.requirement,\n      key: resolver.key,\n      resolve: async (req, ctx) => {\n        const adapterCtx = createContext(ctx);\n        await resolver.resolve(req, {\n          context: adapterCtx,\n          signal: ctx.signal,\n        });\n      },\n    };\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Plugin Factory\n// ============================================================================\n\n/**\n * Callback definitions for adapter plugins.\n */\nexport interface AdapterCallbacks {\n  onRequirementCreated?: (req: Requirement) => void;\n  onRequirementResolved?: (req: Requirement) => void;\n  onError?: (error: Error) => void;\n}\n\n/**\n * Create a callback plugin for adapter events.\n * Wraps adapter callbacks in a Directive plugin.\n *\n * @param name - Plugin name (for debugging)\n * @param callbacks - Callback functions to invoke\n *\n * @example\n * ```typescript\n * const callbackPlugin = createCallbackPlugin(\"adapter-callbacks\", {\n *   onRequirementCreated: (req) => console.log(\"Created:\", req),\n *   onRequirementResolved: (req) => console.log(\"Resolved:\", req),\n * });\n * ```\n */\n// biome-ignore lint/suspicious/noExplicitAny: Plugins work with any schema type\nexport function createCallbackPlugin(\n  name: string,\n  callbacks: AdapterCallbacks,\n): Plugin<any> {\n  return {\n    name,\n    onRequirementCreated: callbacks.onRequirementCreated\n      ? (req) => callbacks.onRequirementCreated!(req.requirement)\n      : undefined,\n    onRequirementMet: callbacks.onRequirementResolved\n      ? (req) => callbacks.onRequirementResolved!(req.requirement)\n      : undefined,\n    onError: callbacks.onError,\n  };\n}\n\n// ============================================================================\n// Module Config Helpers\n// ============================================================================\n\n/**\n * Cast constraints to the correct type for createModule.\n * Use this when TypeScript can't infer the constraint types correctly.\n */\nexport function asConstraints<S extends Schema>(\n  constraints: Record<string, ConstraintDef<S, Requirement>>,\n): Record<string, ConstraintDef<S, Requirement>> {\n  return constraints;\n}\n\n/**\n * Cast resolvers to the correct type for createModule.\n * Use this when TypeScript can't infer the resolver types correctly.\n */\nexport function asResolvers<S extends Schema>(\n  resolvers: Record<string, ResolverDef<S, Requirement>>,\n): Record<string, ResolverDef<S, Requirement>> {\n  return resolvers;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Create a type guard for a specific requirement type.\n * Simplifies the common pattern of checking req.type.\n *\n * @example\n * ```typescript\n * const isResetReq = requirementGuard<ResetReq>(\"RESET\");\n * // Use in resolver:\n * { requirement: isResetReq, resolve: ... }\n * ```\n */\nexport function requirementGuard<R extends Requirement>(\n  type: R[\"type\"],\n): (req: Requirement) => req is R {\n  return (req): req is R => req.type === type;\n}\n\n/**\n * Create a type guard that matches multiple requirement types.\n *\n * @example\n * ```typescript\n * const isDataReq = requirementGuardMultiple<FetchReq | RefreshReq>([\"FETCH\", \"REFRESH\"]);\n * ```\n */\nexport function requirementGuardMultiple<R extends Requirement>(\n  types: Array<R[\"type\"]>,\n): (req: Requirement) => req is R {\n  const typeSet = new Set(types);\n  return (req): req is R => typeSet.has(req.type);\n}\n","/**\n * Dependency tracking context for auto-tracking derivations\n *\n * Uses a stack-based approach to handle nested derivation computations.\n * When a derivation accesses a fact, the tracking context records it.\n */\n\nimport type { TrackingContext } from \"./types.js\";\n\n/** Stack of active tracking contexts */\nconst trackingStack: TrackingContext[] = [];\n\n/** Create a new tracking context */\nfunction createTrackingContext(): TrackingContext {\n  const dependencies = new Set<string>();\n\n  return {\n    get isTracking() {\n      return true;\n    },\n    track(key: string) {\n      dependencies.add(key);\n    },\n    getDependencies() {\n      return dependencies;\n    },\n  };\n}\n\n/** Null tracking context when not tracking */\nconst nullContext: TrackingContext = {\n  isTracking: false,\n  track() {},\n  getDependencies() {\n    return new Set();\n  },\n};\n\n/**\n * Get the current tracking context.\n *\n * @returns The active {@link TrackingContext}, or a null context (no-op) if\n *   no tracking is active.\n *\n * @internal\n */\nexport function getCurrentTracker(): TrackingContext {\n  return trackingStack[trackingStack.length - 1] ?? nullContext;\n}\n\n/**\n * Check if dependency tracking is currently active.\n *\n * @returns `true` if inside a {@link withTracking} call, `false` otherwise.\n *\n * @internal\n */\nexport function isTracking(): boolean {\n  return trackingStack.length > 0;\n}\n\n/**\n * Run a function with dependency tracking.\n *\n * @remarks\n * Pushes a fresh tracking context onto the stack, executes `fn`, then pops\n * the context. Any fact reads inside `fn` are recorded as dependencies.\n * Nesting is supported — inner calls get their own independent context.\n *\n * @param fn - The function to execute under tracking.\n * @returns An object with the computed `value` and a `deps` Set of accessed\n *   fact keys.\n *\n * @internal\n */\nexport function withTracking<T>(fn: () => T): { value: T; deps: Set<string> } {\n  const context = createTrackingContext();\n  trackingStack.push(context);\n\n  try {\n    const value = fn();\n    return { value, deps: context.getDependencies() };\n  } finally {\n    trackingStack.pop();\n  }\n}\n\n/**\n * Run a function without tracking.\n *\n * @remarks\n * Temporarily clears the tracking stack so that fact reads inside `fn` do\n * not register as dependencies. The stack is restored after `fn` returns\n * (even on error). Useful for side-effect reads that should not trigger\n * derivation invalidation.\n *\n * @param fn - The function to execute without tracking.\n * @returns The return value of `fn`.\n *\n * @internal\n */\nexport function withoutTracking<T>(fn: () => T): T {\n  // Temporarily clear the stack\n  const saved = trackingStack.splice(0, trackingStack.length);\n\n  try {\n    return fn();\n  } finally {\n    // Restore the stack (loop avoids spread overflow with deep stacks)\n    for (const ctx of saved) {\n      trackingStack.push(ctx);\n    }\n  }\n}\n\n/**\n * Track a specific key in the current context.\n *\n * @remarks\n * No-op if no tracking context is active.\n *\n * @param key - The fact key to record as a dependency.\n *\n * @internal\n */\nexport function trackAccess(key: string): void {\n  // Fast path: skip when no tracking context is active (99% of calls)\n  const len = trackingStack.length;\n  if (len === 0) {\n    return;\n  }\n  trackingStack[len - 1]!.track(key);\n}\n\n/**\n * Prototype pollution guard — shared across all proxy handlers.\n *\n * @remarks\n * Contains `__proto__`, `constructor`, and `prototype`. Every proxy `get`\n * and `has` trap checks this set and returns `undefined` / `false` for\n * matching keys, preventing prototype pollution via proxy-based objects.\n *\n * @internal\n */\nexport const BLOCKED_PROPS: ReadonlySet<string> = Object.freeze(\n  new Set([\"__proto__\", \"constructor\", \"prototype\"]),\n);\n"]}

package/dist/chunk-ISYFVEHR.js

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