@blac/core 2.0.14 → 2.0.16

package/dist/StateContainerRegistry-BqS-wpb_.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"StateContainerRegistry-BqS-wpb_.js","names":[],"sources":["../src/config.ts","../src/constants.ts","../src/plugin/PluginManager.ts","../src/utils/static-props.ts","../src/utils/structural-key.ts","../src/core/StateContainerRegistry.ts"],"sourcesContent":["/**\n * Global configuration for @blac/core\n */\n\nexport type EqualityFn = <S>(prev: S, next: S) => boolean;\n\nexport interface BlacConfig {\n  /**\n   * Equality check used by `StateContainer.applyState` to skip emits when\n   * `prev` and `next` are structurally equal. Default: `shallowEqualState`.\n   *\n   * Return `true` to skip the emit (states considered equal).\n   */\n  equality: EqualityFn;\n\n  /**\n   * Circuit breaker: maximum number of live instances allowed under a single\n   * bloc constructor before `acquire` throws. Guards against runaway instance\n   * creation — typically an unstable/args-derived key churning out instances\n   * that are never disposed (a memory leak that eventually freezes the app).\n   *\n   * Default: `1000`. Set to `Infinity` (or any non-positive value) to disable.\n   */\n  maxInstancesPerType: number;\n\n  /**\n   * Circuit breaker: maximum number of distinct live references (consumers)\n   * allowed on a single instance before `acquire` throws. Guards against the\n   * other leak shape — consumer cleanup (e.g. `useBloc` unmount `release`)\n   * never firing, so refs accumulate without bound on one instance.\n   *\n   * Default: `1000`. Set to `Infinity` (or any non-positive value) to disable.\n   */\n  maxRefsPerInstance: number;\n\n  /**\n   * Dev-only soft circuit breaker: if a single instance emits more than this\n   * many *real* state changes within a rolling one-second window, log a single\n   * `console.warn`. This is the \"frozen app\" smell — almost always a tight loop\n   * (RAF/animation, or an effect that emits on every commit) pushing\n   * high-frequency data through bloc state, which then saturates subscribers,\n   * plugins (logging/devtools), and the main thread.\n   *\n   * Heuristic by nature — warns, never throws, since high-frequency state can\n   * occasionally be legitimate. No-op in production. Default: `100`. Set to\n   * `Infinity` (or any non-positive value) to disable.\n   */\n  maxEmitsPerSecond: number;\n}\n\n/**\n * Default equality: shallow per-key `Object.is` comparison.\n * Falls through to `false` for primitives/null so reference-only state still\n * behaves correctly.\n */\nexport const shallowEqualState: EqualityFn = (prev, next) => {\n  if (Object.is(prev, next)) return true;\n  if (typeof prev !== 'object' || prev === null) return false;\n  if (typeof next !== 'object' || next === null) return false;\n\n  const prevKeys = Object.keys(prev as object);\n  if (prevKeys.length !== Object.keys(next as object).length) return false;\n\n  for (let i = 0; i < prevKeys.length; i++) {\n    const key = prevKeys[i];\n    if (\n      !Object.is(\n        (prev as Record<string, unknown>)[key],\n        (next as Record<string, unknown>)[key],\n      )\n    ) {\n      return false;\n    }\n  }\n  return true;\n};\n\nconst defaultConfig: BlacConfig = {\n  equality: shallowEqualState,\n  maxInstancesPerType: 1000,\n  maxRefsPerInstance: 1000,\n  maxEmitsPerSecond: 100,\n};\n\nlet globalConfig: BlacConfig = { ...defaultConfig };\n\n/**\n * Configure global defaults for @blac/core.\n *\n * @example\n * ```ts\n * import { configureBlac, shallowEqualState } from '@blac/core';\n *\n * // Swap in a deep-equality check for all blocs\n * configureBlac({ equality: myDeepEqual });\n * ```\n */\nexport function configureBlac(config: Partial<BlacConfig>): void {\n  globalConfig = { ...globalConfig, ...config };\n}\n\n/**\n * Get the current global configuration.\n * @internal\n */\nexport function getBlacConfig(): BlacConfig {\n  return globalConfig;\n}\n\n/**\n * Reset configuration to defaults (useful for testing).\n * @internal\n */\nexport function resetBlacConfig(): void {\n  globalConfig = { ...defaultConfig };\n}\n","/**\n * Default configuration constants for BlaC\n *\n * Centralized location for all magic numbers and default values.\n */\n\n/**\n * Default configuration constants for BlaC\n */\nexport const BLAC_DEFAULTS = {\n  /**\n   * Default instance key for shared instances\n   */\n  DEFAULT_INSTANCE_KEY: 'default',\n\n  /**\n   * Maximum getter nesting depth (prevents infinite recursion)\n   */\n  MAX_GETTER_DEPTH: 10,\n} as const;\n\n/**\n * Static property names for StateContainer classes\n * Used for feature flags and configuration on bloc classes\n */\nexport const BLAC_STATIC_PROPS = {\n  /**\n   * Mark a bloc to never be auto-disposed (kept alive permanently)\n   */\n  KEEP_ALIVE: 'keepAlive',\n\n  /**\n   * Exclude a bloc from DevTools reporting (prevents infinite loops)\n   */\n  EXCLUDE_FROM_DEVTOOLS: '__excludeFromDevTools',\n\n  /**\n   * Mark a bloc so each `useBloc` call site gets its own per-mount instance.\n   * The React adapter auto-keys via `useId()` when this is set.\n   */\n  ISOLATED: 'isolated',\n\n  /**\n   * Per-class equality function used to short-circuit `emit`/`patch` when the\n   * new state is structurally equal to the previous state. Falls back to the\n   * global `configureBlac({ equality })` value when unset.\n   */\n  EQUALITY: '__equality',\n\n  /**\n   * Per-class key function: `static key = (args) => string`.\n   * When set, the registry calls `Type.key(args)` to derive the instance key\n   * instead of using a structural hash of `args`. Allows blocs to ignore\n   * non-identity fields (e.g., `readonly` flags) while still keying by id.\n   */\n  KEY: 'key',\n} as const;\n\n/**\n * ID generation patterns and constants\n */\nexport const BLAC_ID_PATTERNS = {\n  /**\n   * Length of generated ID portion (9 characters from base36)\n   */\n  ID_LENGTH: 9,\n} as const;\n\n/**\n * Standard error message prefix\n */\nexport const BLAC_ERROR_PREFIX = '[BlaC]' as const;\n","import type { StateContainer } from '../core/StateContainer';\nimport type { StateContainerRegistry } from '../core/StateContainerRegistry';\nimport type {\n  BlacPlugin,\n  PluginContext,\n  PluginConfig,\n  InstanceMetadata,\n} from './BlacPlugin';\n\n/**\n * Internal structure for tracking installed plugins\n * @internal\n */\ninterface InstalledPlugin {\n  plugin: BlacPlugin;\n  config: PluginConfig;\n  context: PluginContext;\n}\n\n/**\n * Manages plugin lifecycle for the BlaC state management system.\n * Plugins receive notifications about state container lifecycle events.\n *\n * @example\n * ```ts\n * const manager = createPluginManager(registry);\n * manager.install(myPlugin, { environment: 'development' });\n * ```\n */\nexport class PluginManager {\n  private plugins = new Map<string, InstalledPlugin>();\n  private registry: StateContainerRegistry;\n  private lifecycleUnsubscribers: (() => void)[] = [];\n\n  /**\n   * Create a new PluginManager\n   * @param registry - The StateContainerRegistry to monitor for lifecycle events\n   */\n  constructor(registry: StateContainerRegistry) {\n    this.registry = registry;\n    this.setupLifecycleHooks();\n  }\n\n  /**\n   * Install a plugin with optional configuration\n   * @param plugin - The plugin to install\n   * @param config - Optional plugin configuration\n   * @throws Error if plugin is already installed\n   */\n  install(plugin: BlacPlugin, config: PluginConfig = {}): void {\n    const effectiveConfig: PluginConfig = {\n      enabled: true,\n      environment: 'all',\n      ...config,\n    };\n\n    if (!this.shouldEnablePlugin(effectiveConfig)) {\n      console.log(\n        `[BlaC] Plugin \"${plugin.name}\" skipped (environment mismatch)`,\n      );\n      return;\n    }\n\n    if (this.plugins.has(plugin.name)) {\n      throw new Error(`Plugin \"${plugin.name}\" is already installed`);\n    }\n\n    const context = this.createPluginContext();\n\n    this.plugins.set(plugin.name, {\n      plugin,\n      config: effectiveConfig,\n      context,\n    });\n\n    if (plugin.onInstall) {\n      try {\n        plugin.onInstall(context);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error installing plugin \"${plugin.name}\":`,\n          error,\n        );\n        this.plugins.delete(plugin.name);\n        throw error;\n      }\n    }\n\n    console.log(`[BlaC] Plugin \"${plugin.name}\" v${plugin.version} installed`);\n  }\n\n  /**\n   * Uninstall a plugin by name\n   * @param pluginName - The name of the plugin to uninstall\n   * @throws Error if plugin is not installed\n   */\n  uninstall(pluginName: string): void {\n    const installed = this.plugins.get(pluginName);\n    if (!installed) {\n      throw new Error(`Plugin \"${pluginName}\" is not installed`);\n    }\n\n    if (installed.plugin.onUninstall) {\n      try {\n        installed.plugin.onUninstall();\n      } catch (error) {\n        console.error(\n          `[BlaC] Error uninstalling plugin \"${pluginName}\":`,\n          error,\n        );\n      }\n    }\n\n    this.plugins.delete(pluginName);\n    console.log(`[BlaC] Plugin \"${pluginName}\" uninstalled`);\n  }\n\n  /**\n   * Get an installed plugin by name\n   * @param pluginName - The name of the plugin to retrieve\n   * @returns The plugin instance or undefined if not found\n   */\n  getPlugin(pluginName: string): BlacPlugin | undefined {\n    return this.plugins.get(pluginName)?.plugin;\n  }\n\n  /**\n   * Get all installed plugins\n   * @returns Array of all installed plugins\n   */\n  getAllPlugins(): BlacPlugin[] {\n    return Array.from(this.plugins.values()).map((p) => p.plugin);\n  }\n\n  /**\n   * Check if a plugin is installed\n   * @param pluginName - The name of the plugin to check\n   * @returns true if the plugin is installed\n   */\n  hasPlugin(pluginName: string): boolean {\n    return this.plugins.has(pluginName);\n  }\n\n  /**\n   * Uninstall all plugins\n   */\n  clear(): void {\n    for (const name of this.plugins.keys()) {\n      this.uninstall(name);\n    }\n  }\n\n  destroy(): void {\n    this.clear();\n    for (const unsub of this.lifecycleUnsubscribers) {\n      unsub();\n    }\n    this.lifecycleUnsubscribers = [];\n  }\n\n  /**\n   * Setup lifecycle hooks to notify plugins\n   */\n  private setupLifecycleHooks(): void {\n    this.lifecycleUnsubscribers = [\n      this.registry.on('created', (instance) => {\n        this.notifyPlugins('onInstanceCreated', instance);\n      }),\n      this.registry.on(\n        'stateChanged',\n        (instance, previousState, currentState) => {\n          this.notifyPlugins(\n            'onStateChanged',\n            instance,\n            previousState,\n            currentState,\n          );\n        },\n      ),\n      this.registry.on('disposed', (instance) => {\n        this.notifyPlugins('onInstanceDisposed', instance);\n      }),\n      this.registry.on('refAcquired', (instance, refId) => {\n        this.notifyPlugins('onRefAcquired', instance, refId);\n      }),\n      this.registry.on('refReleased', (instance, refId) => {\n        this.notifyPlugins('onRefReleased', instance, refId);\n      }),\n    ];\n  }\n\n  /**\n   * Notify all plugins of a lifecycle event\n   */\n  private notifyPlugins(hookName: keyof BlacPlugin, ...args: any[]): void {\n    for (const { plugin, config, context } of this.plugins.values()) {\n      if (!config.enabled) continue;\n\n      const hook = plugin[hookName];\n      if (typeof hook === 'function') {\n        try {\n          (hook as any).apply(plugin, [...args, context]);\n        } catch (error) {\n          console.error(\n            `[BlaC] Error in plugin \"${plugin.name}\" ${hookName}:`,\n            error,\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Create plugin context with safe API access\n   */\n  private createPluginContext(): PluginContext {\n    return {\n      getInstanceMetadata: (\n        instance: StateContainer<any, any, any>,\n      ): InstanceMetadata => {\n        return {\n          id: instance.instanceId,\n          className: instance.constructor.name,\n          isDisposed: instance.isDisposed,\n          name: instance.name,\n          createdAt: instance.createdAt,\n          state: instance.state,\n          hydrationStatus: instance.hydrationStatus,\n          isHydrated: instance.isHydrated,\n          hydrationError: instance.hydrationError,\n          changedWhileHydrating: instance.changedWhileHydrating,\n        };\n      },\n\n      getState: <S extends object = any>(instance: StateContainer<S>): S => {\n        return instance.state;\n      },\n\n      getHydrationStatus: (instance: StateContainer<any, any, any>) => {\n        return instance.hydrationStatus;\n      },\n\n      startHydration: (instance: StateContainer<any, any, any>) => {\n        instance.beginHydration();\n      },\n\n      applyHydratedState: <S extends object = any>(\n        instance: StateContainer<S>,\n        state: S,\n      ): boolean => {\n        return instance.applyHydratedState(state);\n      },\n\n      finishHydration: (instance: StateContainer<any, any, any>) => {\n        instance.finishHydration();\n      },\n\n      failHydration: (instance: StateContainer<any, any, any>, error: Error) => {\n        instance.failHydration(error);\n      },\n\n      waitForHydration: (instance: StateContainer<any, any, any>) => {\n        return instance.waitForHydration();\n      },\n\n      queryInstances: <T extends StateContainer<any, any, any>>(\n        typeClass: new (...args: any[]) => T,\n      ): T[] => {\n        return this.registry.getAll(typeClass as any);\n      },\n\n      getAllTypes: () => {\n        return this.registry.getTypes();\n      },\n\n      getStats: () => {\n        return this.registry.getStats();\n      },\n\n      getRefIds: (instanceId: string): string[] => {\n        for (const Type of this.registry.getTypes()) {\n          const map = this.registry.getInstancesMap(Type);\n          for (const [, entry] of map) {\n            if ((entry.instance as any).instanceId === instanceId) {\n              return Array.from(entry.refs.keys());\n            }\n          }\n        }\n        return [];\n      },\n    };\n  }\n\n  /**\n   * Check if plugin should be enabled based on environment\n   */\n  private shouldEnablePlugin(config: PluginConfig): boolean {\n    if (!config.enabled) return false;\n    if (config.environment === 'all') return true;\n\n    const currentEnv = this.getCurrentEnvironment();\n    return currentEnv === config.environment;\n  }\n\n  /**\n   * Get current environment\n   */\n  private getCurrentEnvironment(): 'development' | 'production' | 'test' {\n    if (typeof process !== 'undefined') {\n      if (process.env.NODE_ENV === 'test') return 'test';\n      if (process.env.NODE_ENV === 'production') return 'production';\n      return 'development';\n    }\n    return 'development';\n  }\n}\n\n/**\n * Create a plugin manager instance\n * @param registry - The StateContainerRegistry to monitor for lifecycle events\n * @returns A new PluginManager instance\n */\nexport function createPluginManager(\n  registry: StateContainerRegistry,\n): PluginManager {\n  return new PluginManager(registry);\n}\n","/**\n * Utility functions for accessing static properties on StateContainer classes\n */\n\nimport { BLAC_STATIC_PROPS } from '../constants';\nimport type { EqualityFn } from '../config';\nimport { StateContainerConstructor } from '../types/utilities';\n\n/**\n * Get a static property from a class constructor\n * Type-safe helper that avoids (Type as any) casts\n *\n * @param Type - The class constructor\n * @param propName - The property name to access\n * @param defaultValue - Optional default value if property is undefined\n * @returns The property value or default\n */\nexport function getStaticProp<\n  V,\n  T extends StateContainerConstructor = StateContainerConstructor,\n>(Type: T, propName: string, defaultValue?: V): V | undefined {\n  return (Type as any)[propName] ?? defaultValue;\n}\n\n/**\n * Check if a class is marked as keepAlive.\n * KeepAlive classes are never auto-disposed when ref count reaches 0.\n * @param Type - The class constructor to check\n * @returns true if the class has `static keepAlive = true`\n */\nexport function isKeepAliveClass<T extends StateContainerConstructor>(\n  Type: T,\n): boolean {\n  return getStaticProp<boolean>(Type, BLAC_STATIC_PROPS.KEEP_ALIVE) === true;\n}\n\n/**\n * Check if a class should be excluded from DevTools.\n * Used to prevent infinite loops when DevTools tracks itself.\n * @param Type - The class constructor to check\n * @returns true if the class has `static __excludeFromDevTools = true`\n */\nexport function isExcludedFromDevTools<T extends StateContainerConstructor>(\n  Type: T,\n): boolean {\n  return (\n    getStaticProp<boolean>(Type, BLAC_STATIC_PROPS.EXCLUDE_FROM_DEVTOOLS) ===\n    true\n  );\n}\n\n/**\n * Check if a class is marked as isolated.\n * Isolated classes get a fresh, per-mount instance from `useBloc`\n * (auto-keyed via React's `useId()`), instead of sharing the default\n * instance with sibling call sites.\n * @param Type - The class constructor to check\n * @returns true if the class has `static isolated = true`\n */\nexport function isIsolatedClass<T extends StateContainerConstructor>(\n  Type: T,\n): boolean {\n  return getStaticProp<boolean>(Type, BLAC_STATIC_PROPS.ISOLATED) === true;\n}\n\n/**\n * Get the per-class equality function set via `@blac({ equality })`, if any.\n * @param Type - The class constructor to check\n * @returns the equality function or `undefined`\n */\nexport function getClassEquality<T extends StateContainerConstructor>(\n  Type: T,\n): EqualityFn | undefined {\n  const fn = getStaticProp<EqualityFn>(Type, BLAC_STATIC_PROPS.EQUALITY);\n  return typeof fn === 'function' ? fn : undefined;\n}\n\n/**\n * Get the per-class key function set via `@blac({ key })` or `static key = …`, if any.\n * Used by the registry to derive a stable instance key from `args`.\n * @param Type - The class constructor to check\n * @returns the key function or `undefined`\n */\nexport function getClassKey(\n  Type: unknown,\n): ((args: any) => string) | undefined {\n  const fn = getStaticProp<(args: any) => string>(\n    Type as StateContainerConstructor,\n    BLAC_STATIC_PROPS.KEY,\n    undefined,\n  );\n  return typeof fn === 'function' ? fn : undefined;\n}\n","/**\n * Deterministic, order-independent hash of serializable args.\n * Sorts object keys so {a,b} === {b,a}.\n * Throws (dev) if it encounters a function or non-plain object — those belong in `deps`.\n */\n\nexport const DEFAULT_STRUCTURAL_KEY = 'default';\n\n/**\n * Produce a stable string key for serializable args.\n * - `undefined` / `void` args → `'default'` sentinel (no-args blocs stay on the default key).\n * - Object keys are sorted for order-independence.\n * - Arrays keep their insertion order.\n * - Functions throw — they must be passed via `deps`, not `args`.\n */\nexport function structuralKey(args: unknown): string {\n  if (args === undefined || args === null) {\n    return DEFAULT_STRUCTURAL_KEY;\n  }\n\n  return JSON.stringify(args, function (_k, v) {\n    if (typeof v === 'function') {\n      throw new Error(\n        '[blac] args must be serializable; put refs/callbacks in `deps`',\n      );\n    }\n    if (v && typeof v === 'object' && !Array.isArray(v)) {\n      return Object.keys(v)\n        .sort()\n        .reduce(\n          (o, k) => {\n            (o as any)[k] = (v as any)[k];\n            return o;\n          },\n          {} as Record<string, unknown>,\n        );\n    }\n    return v;\n  });\n}\n","import type { StateContainer, StateContainerConfig } from './StateContainer';\nimport {\n  createPluginManager,\n  type PluginManager,\n} from '../plugin/PluginManager';\nimport { BLAC_DEFAULTS, BLAC_ERROR_PREFIX } from '../constants';\nimport { getBlacConfig } from '../config';\nimport { isKeepAliveClass, getClassKey } from '../utils/static-props';\nimport {\n  structuralKey,\n  DEFAULT_STRUCTURAL_KEY,\n} from '../utils/structural-key';\nimport {\n  InstanceReadonlyState,\n  StateContainerConstructor,\n} from '../types/utilities';\n\n/**\n * Entry in the instance registry, tracking the instance and its named references\n * @template T - Instance type\n */\nexport interface InstanceEntry<T = any> {\n  /** The state container instance */\n  instance: T;\n  /** Map of active reference IDs to their acquire count (supports paired acquire/release) */\n  refs: Map<string, number>;\n  /** The args used when this entry was first created; used for dev-warn on arg mismatch. */\n  args?: unknown;\n}\n\n/**\n * Lifecycle events emitted by the registry\n */\nexport type LifecycleEvent =\n  | 'created'\n  | 'stateChanged'\n  | 'disposed'\n  | 'refAcquired'\n  | 'refReleased';\n\n/**\n * Listener function type for each lifecycle event\n * @template E - The lifecycle event type\n */\nexport type LifecycleListener<E extends LifecycleEvent> = E extends 'created'\n  ? (container: StateContainer<any, any, any>) => void\n  : E extends 'stateChanged'\n    ? (\n        container: StateContainer<any, any, any>,\n        previousState: any,\n        currentState: any,\n      ) => void\n    : E extends 'disposed'\n      ? (container: StateContainer<any, any, any>) => void\n      : E extends 'refAcquired'\n        ? (container: StateContainer<any, any, any>, refId: string) => void\n        : E extends 'refReleased'\n          ? (container: StateContainer<any, any, any>, refId: string) => void\n          : never;\n\n/**\n * Central registry for managing StateContainer instances.\n * Handles instance lifecycle, named ref tracking, and lifecycle event emission.\n *\n * @example\n * ```ts\n * const registry = new StateContainerRegistry();\n * const instance = registry.acquire(MyBloc);  // ownership, must release\n * const other = registry.ensure(OtherBloc);   // no ownership, bloc-to-bloc\n * registry.on('stateChanged', (container, prev, next) => {\n *   console.log('State changed:', prev, '->', next);\n * });\n * ```\n */\nexport class StateContainerRegistry {\n  private readonly instancesByConstructor = new WeakMap<\n    StateContainerConstructor,\n    Map<string, InstanceEntry>\n  >();\n\n  private readonly types = new Set<StateContainerConstructor>();\n\n  private readonly registeredTypeNames = new Set<string>();\n\n  private readonly listeners = new Map<\n    LifecycleEvent,\n    Set<(...args: any[]) => void>\n  >();\n\n  private _stateChangedListenerCount = 0;\n  get hasStateChangedListeners(): boolean {\n    return this._stateChangedListenerCount > 0;\n  }\n  private _pendingStateChanges: Array<[StateContainer<any, any, any>, any, any]> | null =\n    null;\n\n  private _autoRefIdCounter = 0;\n\n  /**\n   * Register a type for lifecycle event tracking\n   * @param constructor - The StateContainer class constructor\n   */\n  registerType<T extends StateContainerConstructor>(constructor: T): void {\n    this.types.add(constructor);\n  }\n\n  /**\n   * Register a StateContainer class with configuration\n   * @param constructor - The StateContainer class constructor\n   * @throws Error if type is already registered\n   */\n  register<T extends StateContainerConstructor>(constructor: T): void {\n    const className = constructor.name;\n\n    if (this.registeredTypeNames.has(className)) {\n      throw new Error(\n        `${BLAC_ERROR_PREFIX} Type \"${className}\" is already registered`,\n      );\n    }\n\n    this.registeredTypeNames.add(className);\n    this.registerType(constructor);\n  }\n\n  private ensureInstancesMap<T extends StateContainerConstructor>(\n    Type: T,\n  ): Map<string, InstanceEntry> {\n    let instances = this.instancesByConstructor.get(Type);\n    if (!instances) {\n      instances = new Map<string, InstanceEntry>();\n      this.instancesByConstructor.set(Type, instances);\n    }\n    return instances;\n  }\n\n  /**\n   * Get the instances Map for a specific class (public API for stats/debugging)\n   */\n  getInstancesMap<T extends StateContainerConstructor>(\n    Type: T,\n  ): Map<string, InstanceEntry> {\n    return this.instancesByConstructor.get(Type) || new Map();\n  }\n\n  /**\n   * Directly insert an instance entry into the registry without going through\n   * acquire/release. Creates the internal WeakMap bucket for the constructor if\n   * it does not exist yet. Replaces any existing entry for the same key.\n   *\n   * The provided instance is NOT configured or disposed here — callers are\n   * responsible for any initConfig / dispose calls. Intended for testing\n   * helpers that create stubs outside the normal acquisition path.\n   *\n   * @internal Used by testing helpers only.\n   */\n  insertInstance<T extends StateContainerConstructor>(\n    Type: T,\n    instanceKey: string,\n    instance: InstanceType<T>,\n    refs: Map<string, number> = new Map(),\n  ): void {\n    const instances = this.ensureInstancesMap(Type);\n    const existingEntry = instances.get(instanceKey);\n    if (existingEntry && existingEntry.instance !== instance && !existingEntry.instance.isDisposed) {\n      existingEntry.instance.dispose();\n    }\n    instances.set(instanceKey, { instance, refs });\n  }\n\n  /**\n   * Resolve the storage key for an instance. This is the single source of truth\n   * for keying — `acquire` and `release` MUST agree, otherwise a ref taken under\n   * an args-derived key is never dropped (instance leaks).\n   *\n   * Resolution order (explicit beats derived):\n   * explicit key > `static key(args)` > structural hash of args > default sentinel.\n   *\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Explicit key, or undefined to derive from args\n   * @param args - Construction args used for structural/`static key` derivation\n   */\n  resolveKey<T extends StateContainerConstructor = StateContainerConstructor>(\n    Type: T,\n    instanceKey: string | undefined,\n    args: unknown,\n  ): string {\n    if (instanceKey !== undefined) {\n      return instanceKey;\n    }\n    const keyFn = getClassKey(Type);\n    if (keyFn) {\n      return keyFn(args);\n    }\n    if (args !== undefined) {\n      return structuralKey(args);\n    }\n    return DEFAULT_STRUCTURAL_KEY;\n  }\n\n  /**\n   * Circuit breaker for runaway instance creation. Throws when a single\n   * constructor would exceed `maxInstancesPerType` live instances — almost\n   * always an unstable instance key (e.g. a new object/array passed as `args`\n   * every render, or a missing `static key`) leaking an instance per render.\n   */\n  private assertInstanceLimit(\n    Type: StateContainerConstructor,\n    currentCount: number,\n  ): void {\n    const limit = getBlacConfig().maxInstancesPerType;\n    if (limit > 0 && currentCount >= limit) {\n      throw new Error(\n        `${BLAC_ERROR_PREFIX} ${Type.name} exceeded the maximum of ${limit} live instances. ` +\n          `This usually means the instance key is unstable — e.g. \\`args\\` that ` +\n          `change identity every render, or a missing \\`static key\\` — so a new ` +\n          `instance is created and never disposed (memory leak). Stabilize the key, ` +\n          `add a \\`static key(args)\\`, or raise \\`configureBlac({ maxInstancesPerType })\\`.`,\n      );\n    }\n  }\n\n  /**\n   * Circuit breaker for runaway reference growth. Throws when one instance\n   * accumulates more than `maxRefsPerInstance` distinct live refs — almost\n   * always consumer cleanup (e.g. `useBloc`'s unmount `release`) never firing.\n   */\n  private assertRefLimit(\n    Type: StateContainerConstructor,\n    resolvedKey: string,\n    refCount: number,\n  ): void {\n    const limit = getBlacConfig().maxRefsPerInstance;\n    if (limit > 0 && refCount > limit) {\n      throw new Error(\n        `${BLAC_ERROR_PREFIX} ${Type.name} instance \"${resolvedKey}\" exceeded the maximum of ${limit} live references. ` +\n          `This usually means references are acquired without a matching release ` +\n          `(e.g. a consumer that never unmounts/cleans up), leaking refs that keep ` +\n          `the instance alive forever. Ensure every acquire is paired with a release, ` +\n          `or raise \\`configureBlac({ maxRefsPerInstance })\\`.`,\n      );\n    }\n  }\n\n  /**\n   * Acquire an instance with ref tracking (ownership semantics).\n   * Creates a new instance if one doesn't exist, or returns existing and adds a ref.\n   * You must call `release()` with the same refId when done.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Instance key (defaults to 'default')\n   * @param options - Acquisition options\n   * @param options.canCreate - Whether to create new instance if not found (default: true)\n   * @param options.countRef - Whether to add a reference (default: true)\n   * @param options.refId - Named reference ID for debugging; auto-generated if omitted\n   * @returns The state container instance\n   */\n  acquire<T extends StateContainerConstructor = StateContainerConstructor>(\n    Type: T,\n    instanceKey: string | undefined = undefined,\n    options: {\n      canCreate?: boolean;\n      countRef?: boolean;\n      refId?: string;\n      args?: unknown;\n    } = {},\n  ): InstanceType<T> {\n    const { canCreate = true, countRef = true } = options;\n    const args = options.args;\n\n    const resolvedKey = this.resolveKey(Type, instanceKey, args);\n\n    const config: StateContainerConfig = {\n      instanceId: resolvedKey,\n      args,\n    };\n\n    const instances = this.ensureInstancesMap(Type);\n    let entry = instances.get(resolvedKey);\n\n    // Detect stale disposed entries (disposed directly, not through release)\n    if (entry?.instance.isDisposed) {\n      instances.delete(resolvedKey);\n      entry = undefined;\n    }\n\n    if (entry) {\n      // Dev-warn when the same key is reused with structurally different args.\n      if (\n        process.env.NODE_ENV !== 'production' &&\n        args !== undefined &&\n        entry.args !== undefined\n      ) {\n        const incomingKey = structuralKey(args);\n        const storedKey = structuralKey(entry.args);\n        if (incomingKey !== storedKey) {\n          console.warn(\n            `${BLAC_ERROR_PREFIX} ${Type.name} instance key \"${resolvedKey}\" was acquired with different args. ` +\n              `Existing args: ${storedKey}, new args: ${incomingKey}. ` +\n              `The existing instance will be reused. If distinct args should produce distinct instances, ` +\n              `either remove the explicit instanceKey or provide a \\`static key\\` function that reflects the difference.`,\n          );\n        }\n      }\n\n      if (countRef) {\n        const refId = options.refId ?? `_auto_${this._autoRefIdCounter++}`;\n        entry.refs.set(refId, (entry.refs.get(refId) ?? 0) + 1);\n        this.assertRefLimit(Type, resolvedKey, entry.refs.size);\n        this.emit('refAcquired', entry.instance, refId);\n      }\n\n      return entry.instance;\n    }\n\n    if (!canCreate) {\n      throw new Error(\n        `${BLAC_ERROR_PREFIX} ${Type.name} instance \"${resolvedKey}\" not found and creation is disabled.`,\n      );\n    }\n\n    // Circuit breaker: refuse to create when this type already holds too many\n    // live instances — a runaway key (unstable/args-derived) never disposing.\n    this.assertInstanceLimit(Type, instances.size);\n\n    // Create new shared instance\n    const instance = new Type() as InstanceType<T>;\n    instance.initConfig(config);\n    const initialRefs = new Map<string, number>();\n    let initialRefId: string | undefined;\n    if (countRef) {\n      initialRefId = options.refId ?? `_auto_${this._autoRefIdCounter++}`;\n      initialRefs.set(initialRefId, 1);\n    }\n    instances.set(resolvedKey, { instance, refs: initialRefs, args });\n\n    // Register type for lifecycle coordination\n    this.registerType(Type);\n\n    if (initialRefId) {\n      this.emit('refAcquired', instance, initialRefId);\n    }\n\n    return instance;\n  }\n\n  /**\n   * Borrow an existing instance without adding a ref (borrowing semantics).\n   * Tracks cross-bloc dependency for reactive updates.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Instance key (defaults to 'default')\n   * @returns The state container instance\n   * @throws Error if instance doesn't exist\n   */\n  borrow<T extends StateContainerConstructor = StateContainerConstructor>(\n    Type: T,\n    instanceKey: string = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY,\n  ): InstanceType<T> {\n    return this.acquire(Type, instanceKey, {\n      canCreate: false,\n      countRef: false,\n    });\n  }\n\n  /**\n   * Safely borrow an existing instance (borrowing semantics with error handling).\n   * Returns discriminated union for type-safe conditional access.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Instance key (defaults to 'default')\n   * @returns Discriminated union with either the instance or an error\n   */\n  borrowSafe<T extends StateContainerConstructor = StateContainerConstructor>(\n    Type: T,\n    instanceKey: string = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY,\n  ):\n    | { error: Error; instance: null }\n    | { error: null; instance: InstanceType<T> } {\n    try {\n      const instance = this.borrow(Type, instanceKey);\n      return { error: null, instance };\n    } catch (error: any) {\n      return { error, instance: null };\n    }\n  }\n\n  /**\n   * Ensure an instance exists without taking ownership (for bloc-to-bloc communication).\n   * Gets existing instance OR creates it if it doesn't exist, without adding a ref.\n   * Tracks cross-bloc dependency for reactive updates.\n   *\n   * Use this in bloc-to-bloc communication when you need to ensure an instance exists\n   * but don't want to claim ownership (no ref added).\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Explicit instance key, or undefined to derive from `args`\n   *   (`static key(args)` / structural hash), matching `acquire`.\n   * @param args - Construction args; used for keying when no explicit key is given\n   * @returns The state container instance\n   */\n  ensure<T extends StateContainerConstructor = StateContainerConstructor>(\n    Type: T,\n    instanceKey: string | undefined = undefined,\n    args?: unknown,\n  ): InstanceType<T> {\n    return this.acquire(Type, instanceKey, {\n      canCreate: true,\n      countRef: false,\n      args,\n    });\n  }\n\n  /**\n   * Release a reference to an instance.\n   * Removes the ref and disposes when refs is empty (unless keepAlive).\n   * Releasing an already-removed refId is a no-op (idempotent).\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Instance key (defaults to 'default')\n   * @param forceDispose - Force immediate disposal regardless of refs\n   * @param refId - The specific ref to remove; removes one arbitrary ref if omitted\n   */\n  release<T extends StateContainerConstructor>(\n    Type: T,\n    instanceKey: string = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY,\n    forceDispose = false,\n    refId?: string,\n  ): void {\n    const instances = this.ensureInstancesMap(Type);\n    const entry = instances.get(instanceKey);\n\n    if (!entry) return;\n\n    // Force dispose immediately\n    if (forceDispose) {\n      if (!entry.instance.isDisposed) {\n        entry.instance.dispose();\n      }\n      instances.delete(instanceKey);\n      return;\n    }\n\n    // Decrement the ref count, or pick one arbitrary ref for backward compat\n    let releasedRefId: string | undefined;\n    if (refId !== undefined) {\n      const count = entry.refs.get(refId) ?? 0;\n      if (count <= 1) {\n        entry.refs.delete(refId);\n      } else {\n        entry.refs.set(refId, count - 1);\n      }\n      releasedRefId = refId;\n    } else {\n      const firstKey = entry.refs.keys().next().value;\n      if (firstKey !== undefined) {\n        const count = entry.refs.get(firstKey) ?? 0;\n        if (count <= 1) {\n          entry.refs.delete(firstKey);\n        } else {\n          entry.refs.set(firstKey, count - 1);\n        }\n        releasedRefId = firstKey;\n      }\n    }\n\n    if (releasedRefId) {\n      this.emit('refReleased', entry.instance, releasedRefId);\n    }\n\n    // Check static keepAlive property\n    const keepAlive = isKeepAliveClass(Type);\n\n    // Auto-dispose when refs are empty (unless keepAlive)\n    if (entry.refs.size === 0 && !keepAlive) {\n      // Collect dependencies before disposing so we can clean up orphans\n      const deps = entry.instance.dependencies;\n\n      if (!entry.instance.isDisposed) {\n        entry.instance.dispose();\n      }\n      instances.delete(instanceKey);\n\n      // Clean up ensure-created dependencies that now have no refs\n      for (const [DepType, depKey] of deps) {\n        const depInstances = this.ensureInstancesMap(DepType);\n        const depEntry = depInstances.get(depKey);\n        if (\n          depEntry &&\n          depEntry.refs.size === 0 &&\n          !isKeepAliveClass(DepType) &&\n          !depEntry.instance.isDisposed\n        ) {\n          depEntry.instance.dispose();\n          depInstances.delete(depKey);\n        }\n      }\n    }\n  }\n\n  /**\n   * Get all instances of a specific type.\n   * @param Type - The StateContainer class constructor\n   * @returns Array of all instances\n   */\n  getAll<T extends StateContainerConstructor>(\n    Type: T,\n  ): InstanceReadonlyState<T>[] {\n    const instances = this.ensureInstancesMap(Type);\n    const result: InstanceReadonlyState<T>[] = [];\n    for (const entry of instances.values()) {\n      result.push(entry.instance);\n    }\n    return result;\n  }\n\n  /**\n   * Safely iterate over all instances of a type.\n   * Skips disposed instances and catches callback errors.\n   * @param Type - The StateContainer class constructor\n   * @param callback - Function to call for each instance\n   */\n  forEach<T extends StateContainerConstructor>(\n    Type: T,\n    callback: (instance: InstanceReadonlyState<T>) => void,\n  ): void {\n    const instances = this.ensureInstancesMap(Type);\n    for (const entry of instances.values()) {\n      const instance = entry.instance;\n      if (!instance.isDisposed) {\n        try {\n          callback(instance);\n        } catch (error) {\n          console.error(\n            `${BLAC_ERROR_PREFIX} forEach callback error for ${Type.name}:`,\n            error,\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Clear all instances of a specific type (disposes them).\n   * @param Type - The StateContainer class constructor\n   */\n  clear<T extends StateContainerConstructor>(Type: T): void {\n    const instances = this.ensureInstancesMap(Type);\n    // Dispose all instances\n    for (const entry of instances.values()) {\n      if (!entry.instance.isDisposed) {\n        entry.instance.dispose();\n      }\n    }\n    // Clear the Map\n    instances.clear();\n  }\n\n  /**\n   * Get reference count for an instance (number of active refs).\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Instance key (defaults to 'default')\n   * @returns Current ref count (0 if instance doesn't exist)\n   */\n  getRefCount<T extends StateContainerConstructor>(\n    Type: T,\n    instanceKey: string = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY,\n  ): number {\n    const instances = this.ensureInstancesMap(Type);\n    const entry = instances.get(instanceKey);\n    return entry?.refs.size ?? 0;\n  }\n\n  /**\n   * Get all active reference IDs for an instance.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Instance key (defaults to 'default')\n   * @returns Array of ref ID strings (empty if instance doesn't exist)\n   */\n  getRefIds<T extends StateContainerConstructor>(\n    Type: T,\n    instanceKey: string = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY,\n  ): string[] {\n    const instances = this.instancesByConstructor.get(Type);\n    if (!instances) return [];\n    const entry = instances.get(instanceKey);\n    return entry ? Array.from(entry.refs.keys()) : [];\n  }\n\n  /**\n   * Check if an instance exists.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Instance key (defaults to 'default')\n   * @returns true if instance exists\n   */\n  hasInstance<T extends StateContainerConstructor>(\n    Type: T,\n    instanceKey: string = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY,\n  ): boolean {\n    const instances = this.ensureInstancesMap(Type);\n    return instances.has(instanceKey);\n  }\n\n  /**\n   * Clear all instances from all types (for testing)\n   *\n   * Iterates all registered types and clears their instances.\n   * Also clears type tracking to reset the registry state.\n   */\n  clearAll(): void {\n    // Step 1: Clear instances from each type (while we still have the types list)\n    for (const Type of this.types) {\n      this.clear(Type);\n    }\n    // Step 2: Now clear type tracking (resets registry state for tests)\n    this.types.clear();\n    this.registeredTypeNames.clear();\n  }\n\n  /**\n   * Get registry statistics for debugging.\n   * @returns Object with registeredTypes, totalInstances, and typeBreakdown\n   */\n  getStats(): {\n    registeredTypes: number;\n    totalInstances: number;\n    typeBreakdown: Record<string, number>;\n  } {\n    const typeBreakdown: Record<string, number> = {};\n    let totalInstances = 0;\n\n    // Collect stats from each registered type\n    for (const Type of this.types) {\n      const typeName = Type.name;\n      const instances = this.getInstancesMap(Type);\n      const count = instances.size;\n\n      typeBreakdown[typeName] = count;\n      totalInstances += count;\n    }\n\n    return {\n      registeredTypes: this.types.size,\n      totalInstances,\n      typeBreakdown,\n    };\n  }\n\n  /**\n   * Get all registered types (for plugin system).\n   * @returns Array of all registered StateContainer class constructors\n   */\n  getTypes(): StateContainerConstructor[] {\n    return Array.from(this.types);\n  }\n\n  /**\n   * Subscribe to lifecycle events\n   * @param event - The lifecycle event to listen for\n   * @param listener - The listener function to call when the event occurs\n   * @returns Unsubscribe function\n   */\n  on<E extends LifecycleEvent>(\n    event: E,\n    listener: LifecycleListener<E>,\n  ): () => void {\n    if (!this.listeners.has(event)) {\n      this.listeners.set(event, new Set());\n    }\n    const instance = this.listeners.get(event);\n    if (!instance) {\n      throw new Error(\n        `${BLAC_ERROR_PREFIX} Failed to register listener for event '${event}'`,\n      );\n    }\n\n    instance.add(listener as (...args: any[]) => void);\n\n    if (event === 'stateChanged') {\n      this._stateChangedListenerCount++;\n    }\n\n    // Return unsubscribe function\n    return () => {\n      const deleted = this.listeners\n        .get(event)\n        ?.delete(listener as (...args: any[]) => void);\n      if (deleted && event === 'stateChanged') {\n        this._stateChangedListenerCount--;\n      }\n    };\n  }\n\n  /**\n   * Emit lifecycle event to all listeners\n   * @internal - Called by StateContainer lifecycle methods\n   */\n  emit(event: 'created', container: StateContainer<any, any, any>): void;\n  emit(event: 'disposed', container: StateContainer<any, any, any>): void;\n  emit(\n    event: 'stateChanged',\n    container: StateContainer<any, any, any>,\n    previousState: any,\n    currentState: any,\n  ): void;\n  emit(\n    event: 'refAcquired',\n    container: StateContainer<any, any, any>,\n    refId: string,\n  ): void;\n  emit(\n    event: 'refReleased',\n    container: StateContainer<any, any, any>,\n    refId: string,\n  ): void;\n  emit(event: LifecycleEvent, ...args: any[]): void {\n    const listeners = this.listeners.get(event);\n    if (!listeners || listeners.size === 0) return; // Zero overhead when no listeners\n\n    for (const listener of listeners) {\n      try {\n        listener(...args);\n      } catch (error) {\n        console.error(\n          `${BLAC_ERROR_PREFIX} Listener error for '${event}':`,\n          error,\n        );\n      }\n    }\n  }\n\n  /**\n   * Schedule a deferred stateChanged notification via microtask.\n   * Skips entirely when no stateChanged listeners are registered.\n   * @internal - Called by StateContainer.applyState\n   */\n  notifyStateChanged(\n    container: StateContainer<any, any, any>,\n    previousState: any,\n    newState: any,\n  ): void {\n    if (this._stateChangedListenerCount === 0) return;\n\n    if (!this._pendingStateChanges) {\n      this._pendingStateChanges = [];\n      queueMicrotask(() => this.flushStateChanged());\n    }\n    this._pendingStateChanges.push([container, previousState, newState]);\n  }\n\n  private flushStateChanged(): void {\n    const pending = this._pendingStateChanges;\n    this._pendingStateChanges = null;\n    if (!pending) return;\n\n    for (const [container, prev, next] of pending) {\n      this.emit('stateChanged', container, prev, next);\n    }\n  }\n}\n\n/**\n * Global default registry instance\n */\nexport const globalRegistry = new StateContainerRegistry();\n\n/**\n * Global plugin manager (initialized lazily)\n */\nlet _globalPluginManager: PluginManager | null = null;\n\n/**\n * Get the global plugin manager\n */\nexport function getPluginManager(): PluginManager {\n  if (!_globalPluginManager) {\n    _globalPluginManager = createPluginManager(globalRegistry);\n  }\n  return _globalPluginManager;\n}\n"],"mappings":";;;;;;AAuDA,MAAa,qBAAiC,MAAM,SAAS;AAC3D,KAAI,OAAO,GAAG,MAAM,KAAK,CAAE,QAAO;AAClC,KAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;AACtD,KAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;CAEtD,MAAM,WAAW,OAAO,KAAK,KAAe;AAC5C,KAAI,SAAS,WAAW,OAAO,KAAK,KAAe,CAAC,OAAQ,QAAO;AAEnE,MAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;EACxC,MAAM,MAAM,SAAS;AACrB,MACE,CAAC,OAAO,GACL,KAAiC,MACjC,KAAiC,KACnC,CAED,QAAO;;AAGX,QAAO;;AAGT,MAAM,gBAA4B;CAChC,UAAU;CACV,qBAAqB;CACrB,oBAAoB;CACpB,mBAAmB;CACpB;AAED,IAAI,eAA2B,EAAE,GAAG,eAAe;;;;;;;;;;;;AAanD,SAAgB,cAAc,QAAmC;AAC/D,gBAAe;EAAE,GAAG;EAAc,GAAG;EAAQ;;;;;;AAO/C,SAAgB,gBAA4B;AAC1C,QAAO;;;;;;AAOT,SAAgB,kBAAwB;AACtC,gBAAe,EAAE,GAAG,eAAe;;;;;;;;;;;;ACzGrC,MAAa,gBAAgB;CAI3B,sBAAsB;CAKtB,kBAAkB;CACnB;;;;;AAMD,MAAa,oBAAoB;CAI/B,YAAY;CAKZ,uBAAuB;CAMvB,UAAU;CAOV,UAAU;CAQV,KAAK;CACN;;;;AAeD,MAAa,oBAAoB;;;;;;;;;;;;;AC1CjC,IAAa,gBAAb,MAA2B;;;;;CASzB,YAAY,UAAkC;iCAR5B,IAAI,KAA8B;gCAEH,EAAE;AAOjD,OAAK,WAAW;AAChB,OAAK,qBAAqB;;;;;;;;CAS5B,QAAQ,QAAoB,SAAuB,EAAE,EAAQ;EAC3D,MAAM,kBAAgC;GACpC,SAAS;GACT,aAAa;GACb,GAAG;GACJ;AAED,MAAI,CAAC,KAAK,mBAAmB,gBAAgB,EAAE;AAC7C,WAAQ,IACN,kBAAkB,OAAO,KAAK,kCAC/B;AACD;;AAGF,MAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,CAC/B,OAAM,IAAI,MAAM,WAAW,OAAO,KAAK,wBAAwB;EAGjE,MAAM,UAAU,KAAK,qBAAqB;AAE1C,OAAK,QAAQ,IAAI,OAAO,MAAM;GAC5B;GACA,QAAQ;GACR;GACD,CAAC;AAEF,MAAI,OAAO,UACT,KAAI;AACF,UAAO,UAAU,QAAQ;WAClB,OAAO;AACd,WAAQ,MACN,mCAAmC,OAAO,KAAK,KAC/C,MACD;AACD,QAAK,QAAQ,OAAO,OAAO,KAAK;AAChC,SAAM;;AAIV,UAAQ,IAAI,kBAAkB,OAAO,KAAK,KAAK,OAAO,QAAQ,YAAY;;;;;;;CAQ5E,UAAU,YAA0B;EAClC,MAAM,YAAY,KAAK,QAAQ,IAAI,WAAW;AAC9C,MAAI,CAAC,UACH,OAAM,IAAI,MAAM,WAAW,WAAW,oBAAoB;AAG5D,MAAI,UAAU,OAAO,YACnB,KAAI;AACF,aAAU,OAAO,aAAa;WACvB,OAAO;AACd,WAAQ,MACN,qCAAqC,WAAW,KAChD,MACD;;AAIL,OAAK,QAAQ,OAAO,WAAW;AAC/B,UAAQ,IAAI,kBAAkB,WAAW,eAAe;;;;;;;CAQ1D,UAAU,YAA4C;AACpD,SAAO,KAAK,QAAQ,IAAI,WAAW,EAAE;;;;;;CAOvC,gBAA8B;AAC5B,SAAO,MAAM,KAAK,KAAK,QAAQ,QAAQ,CAAC,CAAC,KAAK,MAAM,EAAE,OAAO;;;;;;;CAQ/D,UAAU,YAA6B;AACrC,SAAO,KAAK,QAAQ,IAAI,WAAW;;;;;CAMrC,QAAc;AACZ,OAAK,MAAM,QAAQ,KAAK,QAAQ,MAAM,CACpC,MAAK,UAAU,KAAK;;CAIxB,UAAgB;AACd,OAAK,OAAO;AACZ,OAAK,MAAM,SAAS,KAAK,uBACvB,QAAO;AAET,OAAK,yBAAyB,EAAE;;;;;CAMlC,sBAAoC;AAClC,OAAK,yBAAyB;GAC5B,KAAK,SAAS,GAAG,YAAY,aAAa;AACxC,SAAK,cAAc,qBAAqB,SAAS;KACjD;GACF,KAAK,SAAS,GACZ,iBACC,UAAU,eAAe,iBAAiB;AACzC,SAAK,cACH,kBACA,UACA,eACA,aACD;KAEJ;GACD,KAAK,SAAS,GAAG,aAAa,aAAa;AACzC,SAAK,cAAc,sBAAsB,SAAS;KAClD;GACF,KAAK,SAAS,GAAG,gBAAgB,UAAU,UAAU;AACnD,SAAK,cAAc,iBAAiB,UAAU,MAAM;KACpD;GACF,KAAK,SAAS,GAAG,gBAAgB,UAAU,UAAU;AACnD,SAAK,cAAc,iBAAiB,UAAU,MAAM;KACpD;GACH;;;;;CAMH,cAAsB,UAA4B,GAAG,MAAmB;AACtE,OAAK,MAAM,EAAE,QAAQ,QAAQ,aAAa,KAAK,QAAQ,QAAQ,EAAE;AAC/D,OAAI,CAAC,OAAO,QAAS;GAErB,MAAM,OAAO,OAAO;AACpB,OAAI,OAAO,SAAS,WAClB,KAAI;AACD,SAAa,MAAM,QAAQ,CAAC,GAAG,MAAM,QAAQ,CAAC;YACxC,OAAO;AACd,YAAQ,MACN,2BAA2B,OAAO,KAAK,IAAI,SAAS,IACpD,MACD;;;;;;;CAST,sBAA6C;AAC3C,SAAO;GACL,sBACE,aACqB;AACrB,WAAO;KACL,IAAI,SAAS;KACb,WAAW,SAAS,YAAY;KAChC,YAAY,SAAS;KACrB,MAAM,SAAS;KACf,WAAW,SAAS;KACpB,OAAO,SAAS;KAChB,iBAAiB,SAAS;KAC1B,YAAY,SAAS;KACrB,gBAAgB,SAAS;KACzB,uBAAuB,SAAS;KACjC;;GAGH,WAAmC,aAAmC;AACpE,WAAO,SAAS;;GAGlB,qBAAqB,aAA4C;AAC/D,WAAO,SAAS;;GAGlB,iBAAiB,aAA4C;AAC3D,aAAS,gBAAgB;;GAG3B,qBACE,UACA,UACY;AACZ,WAAO,SAAS,mBAAmB,MAAM;;GAG3C,kBAAkB,aAA4C;AAC5D,aAAS,iBAAiB;;GAG5B,gBAAgB,UAAyC,UAAiB;AACxE,aAAS,cAAc,MAAM;;GAG/B,mBAAmB,aAA4C;AAC7D,WAAO,SAAS,kBAAkB;;GAGpC,iBACE,cACQ;AACR,WAAO,KAAK,SAAS,OAAO,UAAiB;;GAG/C,mBAAmB;AACjB,WAAO,KAAK,SAAS,UAAU;;GAGjC,gBAAgB;AACd,WAAO,KAAK,SAAS,UAAU;;GAGjC,YAAY,eAAiC;AAC3C,SAAK,MAAM,QAAQ,KAAK,SAAS,UAAU,EAAE;KAC3C,MAAM,MAAM,KAAK,SAAS,gBAAgB,KAAK;AAC/C,UAAK,MAAM,GAAG,UAAU,IACtB,KAAK,MAAM,SAAiB,eAAe,WACzC,QAAO,MAAM,KAAK,MAAM,KAAK,MAAM,CAAC;;AAI1C,WAAO,EAAE;;GAEZ;;;;;CAMH,mBAA2B,QAA+B;AACxD,MAAI,CAAC,OAAO,QAAS,QAAO;AAC5B,MAAI,OAAO,gBAAgB,MAAO,QAAO;AAGzC,SADmB,KAAK,uBAAuB,KACzB,OAAO;;;;;CAM/B,wBAAuE;AACrE,MAAI,OAAO,YAAY,aAAa;AAClC,OAAI,QAAQ,IAAI,aAAa,OAAQ,QAAO;AAC5C,OAAI,QAAQ,IAAI,aAAa,aAAc,QAAO;AAClD,UAAO;;AAET,SAAO;;;;;;;;AASX,SAAgB,oBACd,UACe;AACf,QAAO,IAAI,cAAc,SAAS;;;;;;;;;;;;;;;;ACpTpC,SAAgB,cAGd,MAAS,UAAkB,cAAiC;AAC5D,QAAQ,KAAa,aAAa;;;;;;;;AASpC,SAAgB,iBACd,MACS;AACT,QAAO,cAAuB,MAAM,kBAAkB,WAAW,KAAK;;;;;;;;AASxE,SAAgB,uBACd,MACS;AACT,QACE,cAAuB,MAAM,kBAAkB,sBAAsB,KACrE;;;;;;;;;;AAYJ,SAAgB,gBACd,MACS;AACT,QAAO,cAAuB,MAAM,kBAAkB,SAAS,KAAK;;;;;;;AAQtE,SAAgB,iBACd,MACwB;CACxB,MAAM,KAAK,cAA0B,MAAM,kBAAkB,SAAS;AACtE,QAAO,OAAO,OAAO,aAAa,KAAK,KAAA;;;;;;;;AASzC,SAAgB,YACd,MACqC;CACrC,MAAM,KAAK,cACT,MACA,kBAAkB,KAClB,KAAA,EACD;AACD,QAAO,OAAO,OAAO,aAAa,KAAK,KAAA;;;;;;;;;ACrFzC,MAAa,yBAAyB;;;;;;;;AAStC,SAAgB,cAAc,MAAuB;AACnD,KAAI,SAAS,KAAA,KAAa,SAAS,KACjC,QAAO;AAGT,QAAO,KAAK,UAAU,MAAM,SAAU,IAAI,GAAG;AAC3C,MAAI,OAAO,MAAM,WACf,OAAM,IAAI,MACR,iEACD;AAEH,MAAI,KAAK,OAAO,MAAM,YAAY,CAAC,MAAM,QAAQ,EAAE,CACjD,QAAO,OAAO,KAAK,EAAE,CAClB,MAAM,CACN,QACE,GAAG,MAAM;AACP,KAAU,KAAM,EAAU;AAC3B,UAAO;KAET,EAAE,CACH;AAEL,SAAO;GACP;;;;;;;;;;;;;;;;;;ACoCJ,IAAa,yBAAb,MAAoC;;gDACQ,IAAI,SAG3C;+BAEsB,IAAI,KAAgC;6CAEtB,IAAI,KAAa;mCAE3B,IAAI,KAG9B;oCAEkC;8BAKnC;2BAE0B;;CAN5B,IAAI,2BAAoC;AACtC,SAAO,KAAK,6BAA6B;;;;;;CAW3C,aAAkD,aAAsB;AACtE,OAAK,MAAM,IAAI,YAAY;;;;;;;CAQ7B,SAA8C,aAAsB;EAClE,MAAM,YAAY,YAAY;AAE9B,MAAI,KAAK,oBAAoB,IAAI,UAAU,CACzC,OAAM,IAAI,MACR,GAAG,kBAAkB,SAAS,UAAU,yBACzC;AAGH,OAAK,oBAAoB,IAAI,UAAU;AACvC,OAAK,aAAa,YAAY;;CAGhC,mBACE,MAC4B;EAC5B,IAAI,YAAY,KAAK,uBAAuB,IAAI,KAAK;AACrD,MAAI,CAAC,WAAW;AACd,+BAAY,IAAI,KAA4B;AAC5C,QAAK,uBAAuB,IAAI,MAAM,UAAU;;AAElD,SAAO;;;;;CAMT,gBACE,MAC4B;AAC5B,SAAO,KAAK,uBAAuB,IAAI,KAAK,oBAAI,IAAI,KAAK;;;;;;;;;;;;;CAc3D,eACE,MACA,aACA,UACA,uBAA4B,IAAI,KAAK,EAC/B;EACN,MAAM,YAAY,KAAK,mBAAmB,KAAK;EAC/C,MAAM,gBAAgB,UAAU,IAAI,YAAY;AAChD,MAAI,iBAAiB,cAAc,aAAa,YAAY,CAAC,cAAc,SAAS,WAClF,eAAc,SAAS,SAAS;AAElC,YAAU,IAAI,aAAa;GAAE;GAAU;GAAM,CAAC;;;;;;;;;;;;;;CAehD,WACE,MACA,aACA,MACQ;AACR,MAAI,gBAAgB,KAAA,EAClB,QAAO;EAET,MAAM,QAAQ,YAAY,KAAK;AAC/B,MAAI,MACF,QAAO,MAAM,KAAK;AAEpB,MAAI,SAAS,KAAA,EACX,QAAO,cAAc,KAAK;AAE5B,SAAO;;;;;;;;CAST,oBACE,MACA,cACM;EACN,MAAM,QAAQ,eAAe,CAAC;AAC9B,MAAI,QAAQ,KAAK,gBAAgB,MAC/B,OAAM,IAAI,MACR,GAAG,kBAAkB,GAAG,KAAK,KAAK,2BAA2B,MAAM,sTAKpE;;;;;;;CASL,eACE,MACA,aACA,UACM;EACN,MAAM,QAAQ,eAAe,CAAC;AAC9B,MAAI,QAAQ,KAAK,WAAW,MAC1B,OAAM,IAAI,MACR,GAAG,kBAAkB,GAAG,KAAK,KAAK,aAAa,YAAY,4BAA4B,MAAM,gSAK9F;;;;;;;;;;;;;;CAgBL,QACE,MACA,cAAkC,KAAA,GAClC,UAKI,EAAE,EACW;EACjB,MAAM,EAAE,YAAY,MAAM,WAAW,SAAS;EAC9C,MAAM,OAAO,QAAQ;EAErB,MAAM,cAAc,KAAK,WAAW,MAAM,aAAa,KAAK;EAE5D,MAAM,SAA+B;GACnC,YAAY;GACZ;GACD;EAED,MAAM,YAAY,KAAK,mBAAmB,KAAK;EAC/C,IAAI,QAAQ,UAAU,IAAI,YAAY;AAGtC,MAAI,OAAO,SAAS,YAAY;AAC9B,aAAU,OAAO,YAAY;AAC7B,WAAQ,KAAA;;AAGV,MAAI,OAAO;AAET,OACE,QAAQ,IAAI,aAAa,gBACzB,SAAS,KAAA,KACT,MAAM,SAAS,KAAA,GACf;IACA,MAAM,cAAc,cAAc,KAAK;IACvC,MAAM,YAAY,cAAc,MAAM,KAAK;AAC3C,QAAI,gBAAgB,UAClB,SAAQ,KACN,GAAG,kBAAkB,GAAG,KAAK,KAAK,iBAAiB,YAAY,qDAC3C,UAAU,cAAc,YAAY,uMAGzD;;AAIL,OAAI,UAAU;IACZ,MAAM,QAAQ,QAAQ,SAAS,SAAS,KAAK;AAC7C,UAAM,KAAK,IAAI,QAAQ,MAAM,KAAK,IAAI,MAAM,IAAI,KAAK,EAAE;AACvD,SAAK,eAAe,MAAM,aAAa,MAAM,KAAK,KAAK;AACvD,SAAK,KAAK,eAAe,MAAM,UAAU,MAAM;;AAGjD,UAAO,MAAM;;AAGf,MAAI,CAAC,UACH,OAAM,IAAI,MACR,GAAG,kBAAkB,GAAG,KAAK,KAAK,aAAa,YAAY,uCAC5D;AAKH,OAAK,oBAAoB,MAAM,UAAU,KAAK;EAG9C,MAAM,WAAW,IAAI,MAAM;AAC3B,WAAS,WAAW,OAAO;EAC3B,MAAM,8BAAc,IAAI,KAAqB;EAC7C,IAAI;AACJ,MAAI,UAAU;AACZ,kBAAe,QAAQ,SAAS,SAAS,KAAK;AAC9C,eAAY,IAAI,cAAc,EAAE;;AAElC,YAAU,IAAI,aAAa;GAAE;GAAU,MAAM;GAAa;GAAM,CAAC;AAGjE,OAAK,aAAa,KAAK;AAEvB,MAAI,aACF,MAAK,KAAK,eAAe,UAAU,aAAa;AAGlD,SAAO;;;;;;;;;;CAWT,OACE,MACA,cAAsB,cAAc,sBACnB;AACjB,SAAO,KAAK,QAAQ,MAAM,aAAa;GACrC,WAAW;GACX,UAAU;GACX,CAAC;;;;;;;;;CAUJ,WACE,MACA,cAAsB,cAAc,sBAGS;AAC7C,MAAI;AAEF,UAAO;IAAE,OAAO;IAAM,UADL,KAAK,OAAO,MAAM,YAAY;IACf;WACzB,OAAY;AACnB,UAAO;IAAE;IAAO,UAAU;IAAM;;;;;;;;;;;;;;;;CAiBpC,OACE,MACA,cAAkC,KAAA,GAClC,MACiB;AACjB,SAAO,KAAK,QAAQ,MAAM,aAAa;GACrC,WAAW;GACX,UAAU;GACV;GACD,CAAC;;;;;;;;;;;CAYJ,QACE,MACA,cAAsB,cAAc,sBACpC,eAAe,OACf,OACM;EACN,MAAM,YAAY,KAAK,mBAAmB,KAAK;EAC/C,MAAM,QAAQ,UAAU,IAAI,YAAY;AAExC,MAAI,CAAC,MAAO;AAGZ,MAAI,cAAc;AAChB,OAAI,CAAC,MAAM,SAAS,WAClB,OAAM,SAAS,SAAS;AAE1B,aAAU,OAAO,YAAY;AAC7B;;EAIF,IAAI;AACJ,MAAI,UAAU,KAAA,GAAW;GACvB,MAAM,QAAQ,MAAM,KAAK,IAAI,MAAM,IAAI;AACvC,OAAI,SAAS,EACX,OAAM,KAAK,OAAO,MAAM;OAExB,OAAM,KAAK,IAAI,OAAO,QAAQ,EAAE;AAElC,mBAAgB;SACX;GACL,MAAM,WAAW,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC;AAC1C,OAAI,aAAa,KAAA,GAAW;IAC1B,MAAM,QAAQ,MAAM,KAAK,IAAI,SAAS,IAAI;AAC1C,QAAI,SAAS,EACX,OAAM,KAAK,OAAO,SAAS;QAE3B,OAAM,KAAK,IAAI,UAAU,QAAQ,EAAE;AAErC,oBAAgB;;;AAIpB,MAAI,cACF,MAAK,KAAK,eAAe,MAAM,UAAU,cAAc;EAIzD,MAAM,YAAY,iBAAiB,KAAK;AAGxC,MAAI,MAAM,KAAK,SAAS,KAAK,CAAC,WAAW;GAEvC,MAAM,OAAO,MAAM,SAAS;AAE5B,OAAI,CAAC,MAAM,SAAS,WAClB,OAAM,SAAS,SAAS;AAE1B,aAAU,OAAO,YAAY;AAG7B,QAAK,MAAM,CAAC,SAAS,WAAW,MAAM;IACpC,MAAM,eAAe,KAAK,mBAAmB,QAAQ;IACrD,MAAM,WAAW,aAAa,IAAI,OAAO;AACzC,QACE,YACA,SAAS,KAAK,SAAS,KACvB,CAAC,iBAAiB,QAAQ,IAC1B,CAAC,SAAS,SAAS,YACnB;AACA,cAAS,SAAS,SAAS;AAC3B,kBAAa,OAAO,OAAO;;;;;;;;;;CAWnC,OACE,MAC4B;EAC5B,MAAM,YAAY,KAAK,mBAAmB,KAAK;EAC/C,MAAM,SAAqC,EAAE;AAC7C,OAAK,MAAM,SAAS,UAAU,QAAQ,CACpC,QAAO,KAAK,MAAM,SAAS;AAE7B,SAAO;;;;;;;;CAST,QACE,MACA,UACM;EACN,MAAM,YAAY,KAAK,mBAAmB,KAAK;AAC/C,OAAK,MAAM,SAAS,UAAU,QAAQ,EAAE;GACtC,MAAM,WAAW,MAAM;AACvB,OAAI,CAAC,SAAS,WACZ,KAAI;AACF,aAAS,SAAS;YACX,OAAO;AACd,YAAQ,MACN,GAAG,kBAAkB,8BAA8B,KAAK,KAAK,IAC7D,MACD;;;;;;;;CAUT,MAA2C,MAAe;EACxD,MAAM,YAAY,KAAK,mBAAmB,KAAK;AAE/C,OAAK,MAAM,SAAS,UAAU,QAAQ,CACpC,KAAI,CAAC,MAAM,SAAS,WAClB,OAAM,SAAS,SAAS;AAI5B,YAAU,OAAO;;;;;;;;CASnB,YACE,MACA,cAAsB,cAAc,sBAC5B;AAGR,SAFkB,KAAK,mBAAmB,KAAK,CACvB,IAAI,YAAY,EAC1B,KAAK,QAAQ;;;;;;;;CAS7B,UACE,MACA,cAAsB,cAAc,sBAC1B;EACV,MAAM,YAAY,KAAK,uBAAuB,IAAI,KAAK;AACvD,MAAI,CAAC,UAAW,QAAO,EAAE;EACzB,MAAM,QAAQ,UAAU,IAAI,YAAY;AACxC,SAAO,QAAQ,MAAM,KAAK,MAAM,KAAK,MAAM,CAAC,GAAG,EAAE;;;;;;;;CASnD,YACE,MACA,cAAsB,cAAc,sBAC3B;AAET,SADkB,KAAK,mBAAmB,KAAK,CAC9B,IAAI,YAAY;;;;;;;;CASnC,WAAiB;AAEf,OAAK,MAAM,QAAQ,KAAK,MACtB,MAAK,MAAM,KAAK;AAGlB,OAAK,MAAM,OAAO;AAClB,OAAK,oBAAoB,OAAO;;;;;;CAOlC,WAIE;EACA,MAAM,gBAAwC,EAAE;EAChD,IAAI,iBAAiB;AAGrB,OAAK,MAAM,QAAQ,KAAK,OAAO;GAC7B,MAAM,WAAW,KAAK;GAEtB,MAAM,QADY,KAAK,gBAAgB,KAAK,CACpB;AAExB,iBAAc,YAAY;AAC1B,qBAAkB;;AAGpB,SAAO;GACL,iBAAiB,KAAK,MAAM;GAC5B;GACA;GACD;;;;;;CAOH,WAAwC;AACtC,SAAO,MAAM,KAAK,KAAK,MAAM;;;;;;;;CAS/B,GACE,OACA,UACY;AACZ,MAAI,CAAC,KAAK,UAAU,IAAI,MAAM,CAC5B,MAAK,UAAU,IAAI,uBAAO,IAAI,KAAK,CAAC;EAEtC,MAAM,WAAW,KAAK,UAAU,IAAI,MAAM;AAC1C,MAAI,CAAC,SACH,OAAM,IAAI,MACR,GAAG,kBAAkB,0CAA0C,MAAM,GACtE;AAGH,WAAS,IAAI,SAAqC;AAElD,MAAI,UAAU,eACZ,MAAK;AAIP,eAAa;AAIX,OAHgB,KAAK,UAClB,IAAI,MAAM,EACT,OAAO,SAAqC,IACjC,UAAU,eACvB,MAAK;;;CA2BX,KAAK,OAAuB,GAAG,MAAmB;EAChD,MAAM,YAAY,KAAK,UAAU,IAAI,MAAM;AAC3C,MAAI,CAAC,aAAa,UAAU,SAAS,EAAG;AAExC,OAAK,MAAM,YAAY,UACrB,KAAI;AACF,YAAS,GAAG,KAAK;WACV,OAAO;AACd,WAAQ,MACN,GAAG,kBAAkB,uBAAuB,MAAM,KAClD,MACD;;;;;;;;CAUP,mBACE,WACA,eACA,UACM;AACN,MAAI,KAAK,+BAA+B,EAAG;AAE3C,MAAI,CAAC,KAAK,sBAAsB;AAC9B,QAAK,uBAAuB,EAAE;AAC9B,wBAAqB,KAAK,mBAAmB,CAAC;;AAEhD,OAAK,qBAAqB,KAAK;GAAC;GAAW;GAAe;GAAS,CAAC;;CAGtE,oBAAkC;EAChC,MAAM,UAAU,KAAK;AACrB,OAAK,uBAAuB;AAC5B,MAAI,CAAC,QAAS;AAEd,OAAK,MAAM,CAAC,WAAW,MAAM,SAAS,QACpC,MAAK,KAAK,gBAAgB,WAAW,MAAM,KAAK;;;;;;AAQtD,MAAa,iBAAiB,IAAI,wBAAwB;;;;AAK1D,IAAI,uBAA6C;;;;AAKjD,SAAgB,mBAAkC;AAChD,KAAI,CAAC,qBACH,wBAAuB,oBAAoB,eAAe;AAE5D,QAAO"}