@blac/core 2.0.14 → 2.0.16

package/dist/StateContainerRegistry-FWKzPfS-.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateContainerRegistry-FWKzPfS-.cjs","names":["ALL_PATHS"],"sources":["../src/config.ts","../src/plugin/PluginManager.ts","../src/constants.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","import { ALL_PATHS, type PathSet } from '@dirtytalk/structural';\nimport 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 *\n * `installContext` is the context handed to `onInstall` — it has no\n * `container`. Per-container contexts are built on demand by\n * `buildContext()` so each event carries the right focal container\n * without mutating a shared object.\n * @internal\n */\ninterface InstalledPlugin {\n  plugin: BlacPlugin;\n  config: PluginConfig;\n  installContext: PluginContext;\n}\n\n/**\n * Per-container bookkeeping for the channel-bridge plugin dispatcher.\n *\n * - `unsub` tears down the channel subscription on dispose.\n * - `prevState` is the state snapshot the manager will hand plugins as\n *   `prev` on the next flush; it is updated to the post-flush state after\n *   each dispatch.\n * @internal\n */\ninterface ContainerBridge {\n  unsub: () => void;\n  prevState: any;\n}\n\n/**\n * Manages plugin lifecycle for the BlaC state management system.\n *\n * The manager hooks into two surfaces:\n *\n * 1. **Registry lifecycle events** (`created`, `disposed`, `refAcquired`,\n *    `refReleased`, `depsChanged`) — synchronous, fired by the registry.\n *\n * 2. **Per-container channel flushes** — microtask-coalesced. For each\n *    container, the manager subscribes once at create-time with\n *    `ALL_PATHS` interest and stashes `prevState`. On every flush it\n *    captures the new state + the changed `PathSet` and dispatches\n *    `onStateChange(ctx, prev, next, paths)` to every enabled plugin.\n *\n * The `ALL_PATHS` subscription cost: plugins counted as a consumer with\n * `ALL_PATHS` interest will defeat the single-consumer-skip optimization\n * in `StructuralContainer`. This is the intended trade-off — devtools /\n * persist plugins genuinely want every change, and stateful plugins\n * (logging) can decode `paths` via `container.interner.lookup(id)` to log\n * only relevant fields. Plugins that want low overhead should remain\n * uninstalled or environment-gated.\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   * Per-container channel-bridge bookkeeping. Subscribed at `created`,\n   * torn down at `disposed`. Holds the rolling `prevState` snapshot the\n   * manager hands plugins on each flush.\n   */\n  private containerBridges = new WeakMap<\n    StateContainer<any, any, any>,\n    ContainerBridge\n  >();\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 installContext = this.buildContext(undefined);\n\n    this.plugins.set(plugin.name, {\n      plugin,\n      config: effectiveConfig,\n      installContext,\n    });\n\n    if (plugin.onInstall) {\n      try {\n        plugin.onInstall(installContext);\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   * Wire registry lifecycle events into plugin dispatch.\n   *\n   * `onStateChange` is NOT wired through `registry.on('stateChanged', …)` —\n   * that event lacks the `PathSet` payload. Instead, on each `created` we\n   * subscribe to the container's channel directly so we get\n   * `(paths)` and capture `(prev, next)` via the per-container snapshot.\n   */\n  private setupLifecycleHooks(): void {\n    this.lifecycleUnsubscribers = [\n      this.registry.on('created', (instance) => {\n        this.attachStateBridge(instance);\n        this.notifyPlugins('onCreated', instance);\n      }),\n      this.registry.on('disposed', (instance) => {\n        this.notifyPlugins('onDestroyed', instance);\n        this.detachStateBridge(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      this.registry.on('depsChanged', (instance, previousDeps, currentDeps) => {\n        this.notifyPlugins(\n          'onDepsChanged',\n          instance,\n          previousDeps,\n          currentDeps,\n        );\n      }),\n    ];\n  }\n\n  /**\n   * Subscribe to the container's channel with `ALL_PATHS` interest, so we\n   * fire on every flush. Capture `prev` from the snapshot taken on the\n   * previous flush (or at create-time for the first flush) and pass the\n   * channel's `paths` argument straight through to plugins.\n   *\n   * Per-container bookkeeping is stored in a `WeakMap` keyed by the\n   * container itself, so a disposed/GC'd container drops cleanly.\n   */\n  private attachStateBridge(container: StateContainer<any, any, any>): void {\n    // Defensive: if a container is somehow created twice (it shouldn't be),\n    // don't double-subscribe — the existing bridge is canonical.\n    if (this.containerBridges.has(container)) return;\n\n    const bridge: ContainerBridge = {\n      unsub: () => {},\n      prevState: container.state,\n    };\n    this.containerBridges.set(container, bridge);\n\n    bridge.unsub = container.channel.subscribe(\n      () => ALL_PATHS,\n      (paths) => this.dispatchStateChange(container, paths),\n    );\n  }\n\n  private detachStateBridge(container: StateContainer<any, any, any>): void {\n    const bridge = this.containerBridges.get(container);\n    if (!bridge) return;\n    bridge.unsub();\n    this.containerBridges.delete(container);\n  }\n\n  /**\n   * Channel-flush callback. Snapshots `next`, hands `(prev, next, paths)`\n   * to every enabled plugin's `onStateChange`, then updates `prevState`\n   * for the next flush.\n   *\n   * Note: `prev` is captured once and reused across plugins — every\n   * plugin sees the same `prev`/`next`/`paths` regardless of dispatch\n   * order, matching the \"snapshot prev once per flush\" invariant called\n   * out in the C2 spec pitfalls.\n   */\n  private dispatchStateChange(\n    container: StateContainer<any, any, any>,\n    paths: PathSet,\n  ): void {\n    const bridge = this.containerBridges.get(container);\n    if (!bridge) return;\n\n    const prev = bridge.prevState;\n    const next = container.state;\n    bridge.prevState = next;\n\n    for (const { plugin, config } of this.plugins.values()) {\n      if (!config.enabled) continue;\n      // eslint-disable-next-line @typescript-eslint/unbound-method -- invoked via .call below\n      const hook = plugin.onStateChange;\n      if (typeof hook !== 'function') continue;\n\n      try {\n        hook.call(plugin, this.buildContext(container), prev, next, paths);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error in plugin \"${plugin.name}\" onStateChange:`,\n          error,\n        );\n      }\n    }\n  }\n\n  /**\n   * Notify all plugins of a lifecycle event.\n   *\n   * Builds a fresh `PluginContext` per dispatch (instance becomes\n   * `ctx.container`), so plugins can reach the focal bloc through\n   * `ctx.container` per Decision 6.\n   */\n  private notifyPlugins(\n    hookName: Exclude<keyof BlacPlugin, 'onStateChange'>,\n    instance: StateContainer<any, any, any>,\n    ...extraArgs: any[]\n  ): void {\n    for (const { plugin, config } of this.plugins.values()) {\n      if (!config.enabled) continue;\n\n      const hook = plugin[hookName];\n      if (typeof hook !== 'function') continue;\n\n      try {\n        (hook as any).call(plugin, this.buildContext(instance), ...extraArgs);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error in plugin \"${plugin.name}\" ${hookName}:`,\n          error,\n        );\n      }\n    }\n  }\n\n  /**\n   * Build a `PluginContext` for a given focal container. The context is\n   * cheap to build — its methods close over `this.registry` directly —\n   * so we create one per dispatch rather than caching per container.\n   * This sidesteps the lifetime question of \"when do we evict a cached\n   * context?\" and keeps `paths`-vs-`container` lifetimes cleanly\n   * separated per the C2 spec.\n   */\n  private buildContext(\n    container: StateContainer<any, any, any> | undefined,\n  ): PluginContext {\n    const registry = this.registry;\n    return {\n      container,\n\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          args: instance.args,\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: (\n        instance: StateContainer<any, any, any>,\n        error: Error,\n      ) => {\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 registry.getAll(typeClass as any);\n      },\n\n      getAllTypes: () => {\n        return registry.getTypes();\n      },\n\n      getStats: () => {\n        return registry.getStats();\n      },\n\n      getRefIds: (instanceId: string): string[] => {\n        for (const Type of registry.getTypes()) {\n          const map = 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 * 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   * 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","/**\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 * 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 { structuralKey, DEFAULT_STRUCTURAL_KEY } 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  | 'depsChanged';\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          : E extends 'depsChanged'\n            ? (\n                container: StateContainer<any, any, any>,\n                previousDeps: Readonly<Record<string, unknown>>,\n                currentDeps: Readonly<Record<string, unknown>>,\n              ) => 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<\n    [StateContainer<any, any, any>, any, any]\n  > | null = 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 (\n      existingEntry &&\n      existingEntry.instance !== instance &&\n      !existingEntry.instance.isDisposed\n    ) {\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   *\n   * @internal Internal key tier. Public callers use the args-based `acquire`\n   *   wrapper; `useBloc`/`compat`/`watch` address a pre-resolved key here.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Pre-resolved 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   *\n   * @internal Internal key tier; public callers use the args-based `borrow`.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Pre-resolved 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   *\n   * @internal Internal key tier; public callers use the args-based `borrowSafe`.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Pre-resolved 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   *\n   * @internal Internal key tier; public callers use the args-based `ensure`.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Pre-resolved 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   *\n   * @internal Internal key tier; public callers use the args-based `release`.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Pre-resolved 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   *\n   * @internal Internal key tier; public callers use the args-based `getRefCount`.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Pre-resolved 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   *\n   * @internal Internal key tier; public callers use the args-based `getRefIds`.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Pre-resolved 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   *\n   * @internal Internal key tier; public callers use the args-based `hasInstance`.\n   * @param Type - The StateContainer class constructor\n   * @param instanceKey - Pre-resolved 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(\n    event: 'depsChanged',\n    container: StateContainer<any, any, any>,\n    previousDeps: Readonly<Record<string, unknown>>,\n    currentDeps: Readonly<Record<string, unknown>>,\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":"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"}

package/dist/acquire-DHEOEVcj.cjs

@@ -0,0 +1,46 @@
+const require_config = require("./config-DVMnlHLv.cjs");
+//#region src/registry/acquire.ts
+/**
+* Acquire an instance with ref tracking (ownership semantics). Instance
+* identity is derived purely from `args` (via the class's `static key(args)`,
+* a structural hash of `args`, or the default sentinel when there are none).
+*
+* @param BlocClass - The StateContainer class constructor
+* @param opts.args - Construction/identity args; derives the instance key
+* @param opts.refId - Named reference ID for debugging; auto-generated if omitted
+*/
+function acquire(BlocClass, opts) {
+	const registry = require_config.getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.acquire(BlocClass, key, {
+		canCreate: true,
+		countRef: true,
+		refId: opts?.refId,
+		args: opts?.args
+	});
+}
+/**
+* Resolve the storage key an instance would be acquired under, given its
+* construction `args`. This is the canonical key-computation path. Callers that
+* both acquire and release against the `@internal` registry tier (e.g.
+* `@blac/react` `useBloc`) must use this once and pass the same resolved key to
+* both, so the ref is dropped under the key it was taken.
+*/
+function resolveInstanceKey(BlocClass, args) {
+	return require_config.getRegistry().resolveKey(BlocClass, void 0, args);
+}
+//#endregion
+Object.defineProperty(exports, "acquire", {
+	enumerable: true,
+	get: function() {
+		return acquire;
+	}
+});
+Object.defineProperty(exports, "resolveInstanceKey", {
+	enumerable: true,
+	get: function() {
+		return resolveInstanceKey;
+	}
+});
+
+//# sourceMappingURL=acquire-DHEOEVcj.cjs.map

package/dist/acquire-DHEOEVcj.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquire-DHEOEVcj.cjs","names":["getRegistry"],"sources":["../src/registry/acquire.ts"],"sourcesContent":["import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n} from '../types/utilities';\n\n/**\n * Acquire an instance with ref tracking (ownership semantics). Instance\n * identity is derived purely from `args` (via the class's `static key(args)`,\n * a structural hash of `args`, or the default sentinel when there are none).\n *\n * @param BlocClass - The StateContainer class constructor\n * @param opts.args - Construction/identity args; derives the instance key\n * @param opts.refId - Named reference ID for debugging; auto-generated if omitted\n */\nexport function acquire<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T>; refId?: string },\n): InstanceType<T> {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.acquire(BlocClass, key, {\n    canCreate: true,\n    countRef: true,\n    refId: opts?.refId,\n    args: opts?.args,\n  });\n}\n\n/**\n * Resolve the storage key an instance would be acquired under, given its\n * construction `args`. This is the canonical key-computation path. Callers that\n * both acquire and release against the `@internal` registry tier (e.g.\n * `@blac/react` `useBloc`) must use this once and pass the same resolved key to\n * both, so the ref is dropped under the key it was taken.\n */\nexport function resolveInstanceKey<T extends StateContainerConstructor>(\n  BlocClass: T,\n  args?: ExtractArgs<T>,\n): string {\n  return getRegistry().resolveKey(BlocClass, undefined, args);\n}\n"],"mappings":";;;;;;;;;;;AAeA,SAAgB,QACd,WACA,MACiB;CACjB,MAAM,WAAWA,eAAAA,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,QAAQ,WAAW,KAAK;EACtC,WAAW;EACX,UAAU;EACV,OAAO,MAAM;EACb,MAAM,MAAM;CACd,CAAC;AACH;;;;;;;;AASA,SAAgB,mBACd,WACA,MACQ;CACR,OAAOA,eAAAA,YAAY,EAAE,WAAW,WAAW,KAAA,GAAW,IAAI;AAC5D"}

package/dist/acquire-Don7499S.js

@@ -0,0 +1,35 @@
+import { t as getRegistry } from "./config-8pyOC5gv.js";
+//#region src/registry/acquire.ts
+/**
+* Acquire an instance with ref tracking (ownership semantics). Instance
+* identity is derived purely from `args` (via the class's `static key(args)`,
+* a structural hash of `args`, or the default sentinel when there are none).
+*
+* @param BlocClass - The StateContainer class constructor
+* @param opts.args - Construction/identity args; derives the instance key
+* @param opts.refId - Named reference ID for debugging; auto-generated if omitted
+*/
+function acquire(BlocClass, opts) {
+	const registry = getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.acquire(BlocClass, key, {
+		canCreate: true,
+		countRef: true,
+		refId: opts?.refId,
+		args: opts?.args
+	});
+}
+/**
+* Resolve the storage key an instance would be acquired under, given its
+* construction `args`. This is the canonical key-computation path. Callers that
+* both acquire and release against the `@internal` registry tier (e.g.
+* `@blac/react` `useBloc`) must use this once and pass the same resolved key to
+* both, so the ref is dropped under the key it was taken.
+*/
+function resolveInstanceKey(BlocClass, args) {
+	return getRegistry().resolveKey(BlocClass, void 0, args);
+}
+//#endregion
+export { resolveInstanceKey as n, acquire as t };
+
+//# sourceMappingURL=acquire-Don7499S.js.map

package/dist/acquire-Don7499S.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquire-Don7499S.js","names":[],"sources":["../src/registry/acquire.ts"],"sourcesContent":["import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n} from '../types/utilities';\n\n/**\n * Acquire an instance with ref tracking (ownership semantics). Instance\n * identity is derived purely from `args` (via the class's `static key(args)`,\n * a structural hash of `args`, or the default sentinel when there are none).\n *\n * @param BlocClass - The StateContainer class constructor\n * @param opts.args - Construction/identity args; derives the instance key\n * @param opts.refId - Named reference ID for debugging; auto-generated if omitted\n */\nexport function acquire<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T>; refId?: string },\n): InstanceType<T> {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.acquire(BlocClass, key, {\n    canCreate: true,\n    countRef: true,\n    refId: opts?.refId,\n    args: opts?.args,\n  });\n}\n\n/**\n * Resolve the storage key an instance would be acquired under, given its\n * construction `args`. This is the canonical key-computation path. Callers that\n * both acquire and release against the `@internal` registry tier (e.g.\n * `@blac/react` `useBloc`) must use this once and pass the same resolved key to\n * both, so the ref is dropped under the key it was taken.\n */\nexport function resolveInstanceKey<T extends StateContainerConstructor>(\n  BlocClass: T,\n  args?: ExtractArgs<T>,\n): string {\n  return getRegistry().resolveKey(BlocClass, undefined, args);\n}\n"],"mappings":";;;;;;;;;;;AAeA,SAAgB,QACd,WACA,MACiB;CACjB,MAAM,WAAW,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,QAAQ,WAAW,KAAK;EACtC,WAAW;EACX,UAAU;EACV,OAAO,MAAM;EACb,MAAM,MAAM;CACd,CAAC;AACH;;;;;;;;AASA,SAAgB,mBACd,WACA,MACQ;CACR,OAAO,YAAY,EAAE,WAAW,WAAW,KAAA,GAAW,IAAI;AAC5D"}

package/dist/{branded-BSeA_mZO.cjs → branded-BybA0_xw.cjs}

@@ -15,4 +15,4 @@ Object.defineProperty(exports, "instanceId", {
 	}
 });
 
-//# sourceMappingURL=branded-BSeA_mZO.cjs.map
+//# sourceMappingURL=branded-BybA0_xw.cjs.map

package/dist/{branded-BSeA_mZO.cjs.map → branded-BybA0_xw.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"branded-BSeA_mZO.cjs","names":[],"sources":["../src/types/branded.ts"],"sourcesContent":["declare const brand: unique symbol;\n\n/**\n * Utility type for creating branded/nominal types.\n * Prevents accidental type confusion between similar primitive types.\n * @template T - The base type\n * @template B - The brand identifier\n */\nexport type Brand<T, B> = T & { [brand]: B };\n\n/**\n * Branded string type for type-safe IDs.\n * @template B - The brand identifier\n */\nexport type BrandedId<B> = Brand<string, B>;\n\n/**\n * Branded string type for state container instance IDs\n */\nexport type InstanceId = Brand<string, 'InstanceId'>;\n\n/**\n * Create a branded InstanceId from a string\n * @param id - The string ID to brand\n * @returns Branded InstanceId\n */\nexport function instanceId(id: string): InstanceId {\n  return id as InstanceId;\n}\n"],"mappings":";;;;;;AA0BA,SAAgB,WAAW,IAAwB;CACjD,OAAO"}
+{"version":3,"file":"branded-BybA0_xw.cjs","names":[],"sources":["../src/types/branded.ts"],"sourcesContent":["declare const brand: unique symbol;\n\n/**\n * Utility type for creating branded/nominal types.\n * Prevents accidental type confusion between similar primitive types.\n * @template T - The base type\n * @template B - The brand identifier\n */\nexport type Brand<T, B> = T & { [brand]: B };\n\n/**\n * Branded string type for type-safe IDs.\n * @template B - The brand identifier\n */\nexport type BrandedId<B> = Brand<string, B>;\n\n/**\n * Branded string type for state container instance IDs\n */\nexport type InstanceId = Brand<string, 'InstanceId'>;\n\n/**\n * Create a branded InstanceId from a string\n * @param id - The string ID to brand\n * @returns Branded InstanceId\n */\nexport function instanceId(id: string): InstanceId {\n  return id as InstanceId;\n}\n"],"mappings":";;;;;;AA0BA,SAAgB,WAAW,IAAwB;CACjD,OAAO;AACT"}

package/dist/{branded-DwtzSsg0.js → branded-DkbUzncc.js}

@@ -10,4 +10,4 @@ function instanceId(id) {
 //#endregion
 export { instanceId as t };
 
-//# sourceMappingURL=branded-DwtzSsg0.js.map
+//# sourceMappingURL=branded-DkbUzncc.js.map

package/dist/{branded-DwtzSsg0.js.map → branded-DkbUzncc.js.map}

@@ -1 +1 @@
-{"version":3,"file":"branded-DwtzSsg0.js","names":[],"sources":["../src/types/branded.ts"],"sourcesContent":["declare const brand: unique symbol;\n\n/**\n * Utility type for creating branded/nominal types.\n * Prevents accidental type confusion between similar primitive types.\n * @template T - The base type\n * @template B - The brand identifier\n */\nexport type Brand<T, B> = T & { [brand]: B };\n\n/**\n * Branded string type for type-safe IDs.\n * @template B - The brand identifier\n */\nexport type BrandedId<B> = Brand<string, B>;\n\n/**\n * Branded string type for state container instance IDs\n */\nexport type InstanceId = Brand<string, 'InstanceId'>;\n\n/**\n * Create a branded InstanceId from a string\n * @param id - The string ID to brand\n * @returns Branded InstanceId\n */\nexport function instanceId(id: string): InstanceId {\n  return id as InstanceId;\n}\n"],"mappings":";;;;;;AA0BA,SAAgB,WAAW,IAAwB;CACjD,OAAO"}
+{"version":3,"file":"branded-DkbUzncc.js","names":[],"sources":["../src/types/branded.ts"],"sourcesContent":["declare const brand: unique symbol;\n\n/**\n * Utility type for creating branded/nominal types.\n * Prevents accidental type confusion between similar primitive types.\n * @template T - The base type\n * @template B - The brand identifier\n */\nexport type Brand<T, B> = T & { [brand]: B };\n\n/**\n * Branded string type for type-safe IDs.\n * @template B - The brand identifier\n */\nexport type BrandedId<B> = Brand<string, B>;\n\n/**\n * Branded string type for state container instance IDs\n */\nexport type InstanceId = Brand<string, 'InstanceId'>;\n\n/**\n * Create a branded InstanceId from a string\n * @param id - The string ID to brand\n * @returns Branded InstanceId\n */\nexport function instanceId(id: string): InstanceId {\n  return id as InstanceId;\n}\n"],"mappings":";;;;;;AA0BA,SAAgB,WAAW,IAAwB;CACjD,OAAO;AACT"}

package/dist/{config-DoHx0Xsl.js → config-8pyOC5gv.js}

@@ -1,4 +1,4 @@
-import { r as globalRegistry } from "./StateContainerRegistry-DmmzYa7S.js";
+import { r as globalRegistry } from "./StateContainerRegistry-B_ViBLvJ.js";
 //#region src/registry/config.ts
 let _registry = globalRegistry;
 function getRegistry() {
@@ -13,4 +13,4 @@ function getStats() {
 //#endregion
 export { getStats as n, setRegistry as r, getRegistry as t };
 
-//# sourceMappingURL=config-DoHx0Xsl.js.map
+//# sourceMappingURL=config-8pyOC5gv.js.map

package/dist/{config-0ZD9i3wy.js.map → config-8pyOC5gv.js.map}

@@ -1 +1 @@
-{"version":3,"file":"config-0ZD9i3wy.js","names":[],"sources":["../src/registry/config.ts"],"sourcesContent":["import {\n  globalRegistry,\n  StateContainerRegistry,\n} from '../core/StateContainerRegistry';\n\nlet _registry = globalRegistry;\n\nexport function getRegistry(): StateContainerRegistry {\n  return _registry;\n}\n\nexport function setRegistry(registry: StateContainerRegistry): void {\n  _registry = registry;\n}\n\nexport function getStats(): {\n  registeredTypes: number;\n  totalInstances: number;\n  typeBreakdown: Record<string, number>;\n} {\n  return _registry.getStats();\n}\n"],"mappings":";;AAKA,IAAI,YAAY;AAEhB,SAAgB,cAAsC;AACpD,QAAO;;AAGT,SAAgB,YAAY,UAAwC;AAClE,aAAY;;AAGd,SAAgB,WAId;AACA,QAAO,UAAU,UAAU"}
+{"version":3,"file":"config-8pyOC5gv.js","names":[],"sources":["../src/registry/config.ts"],"sourcesContent":["import {\n  globalRegistry,\n  StateContainerRegistry,\n} from '../core/StateContainerRegistry';\n\nlet _registry = globalRegistry;\n\nexport function getRegistry(): StateContainerRegistry {\n  return _registry;\n}\n\nexport function setRegistry(registry: StateContainerRegistry): void {\n  _registry = registry;\n}\n\nexport function getStats(): {\n  registeredTypes: number;\n  totalInstances: number;\n  typeBreakdown: Record<string, number>;\n} {\n  return _registry.getStats();\n}\n"],"mappings":";;AAKA,IAAI,YAAY;AAEhB,SAAgB,cAAsC;CACpD,OAAO;AACT;AAEA,SAAgB,YAAY,UAAwC;CAClE,YAAY;AACd;AAEA,SAAgB,WAId;CACA,OAAO,UAAU,SAAS;AAC5B"}

package/dist/{config-B_4xXpvK.cjs → config-DVMnlHLv.cjs}

@@ -1,5 +1,5 @@
 //#region src/registry/config.ts
-let _registry = require("./StateContainerRegistry-B4yVMYbx.cjs").globalRegistry;
+let _registry = require("./StateContainerRegistry-FWKzPfS-.cjs").globalRegistry;
 function getRegistry() {
 	return _registry;
 }
@@ -29,4 +29,4 @@ Object.defineProperty(exports, "setRegistry", {
 	}
 });
 
-//# sourceMappingURL=config-B_4xXpvK.cjs.map
+//# sourceMappingURL=config-DVMnlHLv.cjs.map

package/dist/{config-B3NIwDQv.cjs.map → config-DVMnlHLv.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"config-B3NIwDQv.cjs","names":["globalRegistry"],"sources":["../src/registry/config.ts"],"sourcesContent":["import {\n  globalRegistry,\n  StateContainerRegistry,\n} from '../core/StateContainerRegistry';\n\nlet _registry = globalRegistry;\n\nexport function getRegistry(): StateContainerRegistry {\n  return _registry;\n}\n\nexport function setRegistry(registry: StateContainerRegistry): void {\n  _registry = registry;\n}\n\nexport function getStats(): {\n  registeredTypes: number;\n  totalInstances: number;\n  typeBreakdown: Record<string, number>;\n} {\n  return _registry.getStats();\n}\n"],"mappings":";AAKA,IAAI,6DAAYA;AAEhB,SAAgB,cAAsC;AACpD,QAAO;;AAGT,SAAgB,YAAY,UAAwC;AAClE,aAAY;;AAGd,SAAgB,WAId;AACA,QAAO,UAAU,UAAU"}
+{"version":3,"file":"config-DVMnlHLv.cjs","names":["globalRegistry"],"sources":["../src/registry/config.ts"],"sourcesContent":["import {\n  globalRegistry,\n  StateContainerRegistry,\n} from '../core/StateContainerRegistry';\n\nlet _registry = globalRegistry;\n\nexport function getRegistry(): StateContainerRegistry {\n  return _registry;\n}\n\nexport function setRegistry(registry: StateContainerRegistry): void {\n  _registry = registry;\n}\n\nexport function getStats(): {\n  registeredTypes: number;\n  totalInstances: number;\n  typeBreakdown: Record<string, number>;\n} {\n  return _registry.getStats();\n}\n"],"mappings":";AAKA,IAAI,2DAAYA,EAAAA;AAEhB,SAAgB,cAAsC;CACpD,OAAO;AACT;AAEA,SAAgB,YAAY,UAAwC;CAClE,YAAY;AACd;AAEA,SAAgB,WAId;CACA,OAAO,UAAU,SAAS;AAC5B"}

package/dist/constants.d.cts

@@ -29,11 +29,6 @@ export declare const BLAC_STATIC_PROPS: {
      * Exclude a bloc from DevTools reporting (prevents infinite loops)
      */
     readonly EXCLUDE_FROM_DEVTOOLS: "__excludeFromDevTools";
-    /**
-     * Mark a bloc so each `useBloc` call site gets its own per-mount instance.
-     * The React adapter auto-keys via `useId()` when this is set.
-     */
-    readonly ISOLATED: "isolated";
     /**
      * Per-class equality function used to short-circuit `emit`/`patch` when the
      * new state is structurally equal to the previous state. Falls back to the

package/dist/constants.d.ts

@@ -29,11 +29,6 @@ export declare const BLAC_STATIC_PROPS: {
      * Exclude a bloc from DevTools reporting (prevents infinite loops)
      */
     readonly EXCLUDE_FROM_DEVTOOLS: "__excludeFromDevTools";
-    /**
-     * Mark a bloc so each `useBloc` call site gets its own per-mount instance.
-     * The React adapter auto-keys via `useId()` when this is set.
-     */
-    readonly ISOLATED: "isolated";
     /**
      * Per-class equality function used to short-circuit `emit`/`patch` when the
      * new state is structurally equal to the previous state. Falls back to the

package/dist/core/StateContainer.d.ts

@@ -1,5 +1,5 @@
 import { StructuralContainer, type DeepPartial, type StructuralContainerOptions } from '@dirtytalk/structural';
-import type { StateContainerConstructor } from '../types/utilities';
+import type { ExtractArgs, StateContainerConstructor } from '../types/utilities';
 import { APPLY_DEPS, EMIT, REMOVE_DEPS_OWNER } from './symbols';
 export interface StateContainerConfig {
     name?: string;
@@ -111,7 +111,7 @@ export declare abstract class StateContainer<S extends object = any, Args = void
      * here would cycle on mutual deps; the channel's same-tick coalescing
      * limits the blast radius but a true mutual cycle is still a user bug.
      */
-    protected depend<T extends StateContainerConstructor>(Type: T, instanceKey?: string): () => InstanceType<T>;
+    protected depend<T extends StateContainerConstructor>(Type: T, args?: ExtractArgs<T>): () => InstanceType<T>;
     constructor(initialState: S, options?: StructuralContainerOptions);
     /**
      * Called once after construction with the args passed at acquire time, before the first

package/dist/core/StateContainerRegistry.d.ts

@@ -103,8 +103,11 @@ export declare class StateContainerRegistry {
      * Acquire an instance with ref tracking (ownership semantics).
      * Creates a new instance if one doesn't exist, or returns existing and adds a ref.
      * You must call `release()` with the same refId when done.
+     *
+     * @internal Internal key tier. Public callers use the args-based `acquire`
+     *   wrapper; `useBloc`/`compat`/`watch` address a pre-resolved key here.
      * @param Type - The StateContainer class constructor
-     * @param instanceKey - Instance key (defaults to 'default')
+     * @param instanceKey - Pre-resolved instance key (defaults to 'default')
      * @param options - Acquisition options
      * @param options.canCreate - Whether to create new instance if not found (default: true)
      * @param options.countRef - Whether to add a reference (default: true)
@@ -120,8 +123,10 @@ export declare class StateContainerRegistry {
     /**
      * Borrow an existing instance without adding a ref (borrowing semantics).
      * Tracks cross-bloc dependency for reactive updates.
+     *
+     * @internal Internal key tier; public callers use the args-based `borrow`.
      * @param Type - The StateContainer class constructor
-     * @param instanceKey - Instance key (defaults to 'default')
+     * @param instanceKey - Pre-resolved instance key (defaults to 'default')
      * @returns The state container instance
      * @throws Error if instance doesn't exist
      */
@@ -129,8 +134,10 @@ export declare class StateContainerRegistry {
     /**
      * Safely borrow an existing instance (borrowing semantics with error handling).
      * Returns discriminated union for type-safe conditional access.
+     *
+     * @internal Internal key tier; public callers use the args-based `borrowSafe`.
      * @param Type - The StateContainer class constructor
-     * @param instanceKey - Instance key (defaults to 'default')
+     * @param instanceKey - Pre-resolved instance key (defaults to 'default')
      * @returns Discriminated union with either the instance or an error
      */
     borrowSafe<T extends StateContainerConstructor = StateContainerConstructor>(Type: T, instanceKey?: string): {
@@ -147,8 +154,10 @@ export declare class StateContainerRegistry {
      *
      * Use this in bloc-to-bloc communication when you need to ensure an instance exists
      * but don't want to claim ownership (no ref added).
+     *
+     * @internal Internal key tier; public callers use the args-based `ensure`.
      * @param Type - The StateContainer class constructor
-     * @param instanceKey - Explicit instance key, or undefined to derive from `args`
+     * @param instanceKey - Pre-resolved instance key, or undefined to derive from `args`
      *   (`static key(args)` / structural hash), matching `acquire`.
      * @param args - Construction args; used for keying when no explicit key is given
      * @returns The state container instance
@@ -158,8 +167,10 @@ export declare class StateContainerRegistry {
      * Release a reference to an instance.
      * Removes the ref and disposes when refs is empty (unless keepAlive).
      * Releasing an already-removed refId is a no-op (idempotent).
+     *
+     * @internal Internal key tier; public callers use the args-based `release`.
      * @param Type - The StateContainer class constructor
-     * @param instanceKey - Instance key (defaults to 'default')
+     * @param instanceKey - Pre-resolved instance key (defaults to 'default')
      * @param forceDispose - Force immediate disposal regardless of refs
      * @param refId - The specific ref to remove; removes one arbitrary ref if omitted
      */
@@ -184,22 +195,28 @@ export declare class StateContainerRegistry {
     clear<T extends StateContainerConstructor>(Type: T): void;
     /**
      * Get reference count for an instance (number of active refs).
+     *
+     * @internal Internal key tier; public callers use the args-based `getRefCount`.
      * @param Type - The StateContainer class constructor
-     * @param instanceKey - Instance key (defaults to 'default')
+     * @param instanceKey - Pre-resolved instance key (defaults to 'default')
      * @returns Current ref count (0 if instance doesn't exist)
      */
     getRefCount<T extends StateContainerConstructor>(Type: T, instanceKey?: string): number;
     /**
      * Get all active reference IDs for an instance.
+     *
+     * @internal Internal key tier; public callers use the args-based `getRefIds`.
      * @param Type - The StateContainer class constructor
-     * @param instanceKey - Instance key (defaults to 'default')
+     * @param instanceKey - Pre-resolved instance key (defaults to 'default')
      * @returns Array of ref ID strings (empty if instance doesn't exist)
      */
     getRefIds<T extends StateContainerConstructor>(Type: T, instanceKey?: string): string[];
     /**
      * Check if an instance exists.
+     *
+     * @internal Internal key tier; public callers use the args-based `hasInstance`.
      * @param Type - The StateContainer class constructor
-     * @param instanceKey - Instance key (defaults to 'default')
+     * @param instanceKey - Pre-resolved instance key (defaults to 'default')
      * @returns true if instance exists
      */
     hasInstance<T extends StateContainerConstructor>(Type: T, instanceKey?: string): boolean;

package/dist/debug.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_StateContainerRegistry = require("./StateContainerRegistry-B4yVMYbx.cjs");
-const require_config = require("./config-B_4xXpvK.cjs");
-const require_management = require("./management-DTzcC6aD.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-FWKzPfS-.cjs");
+const require_config = require("./config-DVMnlHLv.cjs");
+const require_management = require("./management-GcnNJjnm.cjs");
 exports.forEach = require_management.forEach;
 exports.getAll = require_management.getAll;
 exports.getRefCount = require_management.getRefCount;

package/dist/debug.js

@@ -1,4 +1,4 @@
-import { r as globalRegistry } from "./StateContainerRegistry-DmmzYa7S.js";
-import { n as getStats, r as setRegistry, t as getRegistry } from "./config-DoHx0Xsl.js";
-import { a as getAll, c as hasInstance, i as forEach, o as getRefCount, r as register, s as getRefIds } from "./management-H4m3ciJO.js";
+import { r as globalRegistry } from "./StateContainerRegistry-B_ViBLvJ.js";
+import { n as getStats, r as setRegistry, t as getRegistry } from "./config-8pyOC5gv.js";
+import { a as getAll, c as hasInstance, i as forEach, o as getRefCount, r as register, s as getRefIds } from "./management-7jLjVHJd.js";
 export { forEach, getAll, getRefCount, getRefIds, getRegistry, getStats, globalRegistry, hasInstance, register, setRegistry };

package/dist/{Cubit-CWP8Ddzx.cjs → ensure-CLQEx0Nn.cjs}

@@ -1,5 +1,5 @@
-const require_StateContainerRegistry = require("./StateContainerRegistry-B4yVMYbx.cjs");
-const require_config = require("./config-B_4xXpvK.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-FWKzPfS-.cjs");
+const require_config = require("./config-DVMnlHLv.cjs");
 let _dirtytalk_structural = require("@dirtytalk/structural");
 //#region src/utils/idGenerator.ts
 /**
@@ -155,10 +155,11 @@ var StateContainer = class extends _dirtytalk_structural.StructuralContainer {
 	* here would cycle on mutual deps; the channel's same-tick coalescing
 	* limits the blast radius but a true mutual cycle is still a user bug.
 	*/
-	depend(Type, instanceKey) {
+	depend(Type, args) {
 		if (!this._dependencies) this._dependencies = /* @__PURE__ */ new Map();
-		this._dependencies.set(Type, instanceKey ?? require_StateContainerRegistry.BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY);
-		return () => this._registry.ensure(Type, instanceKey);
+		const key = this._registry.resolveKey(Type, void 0, args);
+		this._dependencies.set(Type, key);
+		return () => this._registry.ensure(Type, key, args);
 	}
 	constructor(initialState, options) {
 		super(initialState, options);
@@ -476,6 +477,17 @@ var StateContainer = class extends _dirtytalk_structural.StructuralContainer {
 */
 var Cubit = class extends StateContainer {};
 //#endregion
+//#region src/registry/ensure.ts
+/**
+* Ensure an instance exists without taking ownership (no ref added). Instance
+* identity is derived purely from `args`, matching `acquire`.
+*/
+function ensure(BlocClass, opts) {
+	const registry = require_config.getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.ensure(BlocClass, key, opts?.args);
+}
+//#endregion
 Object.defineProperty(exports, "APPLY_DEPS", {
 	enumerable: true,
 	get: function() {
@@ -506,5 +518,11 @@ Object.defineProperty(exports, "StateContainer", {
 		return StateContainer;
 	}
 });
+Object.defineProperty(exports, "ensure", {
+	enumerable: true,
+	get: function() {
+		return ensure;
+	}
+});
 
-//# sourceMappingURL=Cubit-CWP8Ddzx.cjs.map
+//# sourceMappingURL=ensure-CLQEx0Nn.cjs.map