@blac/core 2.0.14 → 2.0.16

package/dist/ensure-CLQEx0Nn.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-CLQEx0Nn.cjs","names":["StructuralContainer","getRegistry","getBlacConfig","ALL_PATHS","getClassEquality","getRegistry"],"sources":["../src/utils/idGenerator.ts","../src/core/symbols.ts","../src/core/StateContainer.ts","../src/core/Cubit.ts","../src/registry/ensure.ts"],"sourcesContent":["/**\n * Centralized ID Generation\n *\n * Provides consistent, collision-resistant ID generation for all BlaC subsystems.\n * Uses timestamp + counter + random suffix for uniqueness.\n */\n\n// Global counter map for ID generation\nconst globalCounters = new Map<string, number>();\n\n/**\n * Creates an ID generator with isolated counter state\n *\n * @param prefix - Prefix for generated IDs\n * @returns Object with next(), nextSimple(), and reset() methods\n *\n * @example\n * ```ts\n * const generator = createIdGenerator('sub');\n * const id1 = generator.next(); // \"sub:1698765432100_1_a3k9d7f2q\"\n * const id2 = generator.next(); // \"sub:1698765432101_2_b4n8e9g3r\"\n * ```\n */\nexport function createIdGenerator(prefix: string) {\n  let counter = 0;\n  return {\n    next: () =>\n      `${prefix}:${Date.now()}_${++counter}_${Math.random().toString(36).substring(2, 11)}`,\n    nextSimple: () => `${prefix}:${++counter}`,\n    reset: () => {\n      counter = 0;\n    },\n  };\n}\n\n/**\n * Generate ID with timestamp, counter, and random suffix (tree-shakeable)\n *\n * Format: `${prefix}:${timestamp}_${counter}_${random}`\n *\n * @param prefix - Prefix for the ID (e.g., 'sub', 'consumer', 'stage')\n * @returns Branded ID string\n *\n * @example\n * const id = generateId('sub');\n * // Returns: \"sub:1698765432100_1_a3k9d7f2q\"\n */\nexport function generateId(prefix: string): string {\n  const counter = (globalCounters.get(prefix) ?? 0) + 1;\n  globalCounters.set(prefix, counter);\n  const timestamp = Date.now();\n  const random = Math.random().toString(36).substring(2, 11);\n  return `${prefix}:${timestamp}_${counter}_${random}`;\n}\n\n/**\n * Generate simple ID with timestamp and random (no counter tracking)\n *\n * Format: `${prefix}:${timestamp}_${random}`\n *\n * @param prefix - Prefix for the ID\n * @returns Branded ID string\n *\n * @example\n * ```ts\n * const id = generateSimpleId('CounterBloc');\n * // Returns: \"CounterBloc:1698765432100_a3k9d7f2q\"\n * ```\n */\nexport function generateSimpleId(prefix: string, affix?: string): string {\n  if (affix) {\n    return `${prefix}:${affix}`;\n  }\n  const timestamp = Date.now();\n  const random = Math.random().toString(36).substring(2, 11);\n  return `${prefix}:${timestamp}_${random}`;\n}\n\n/**\n * Reset all counters for testing purposes\n * @internal\n */\nexport function __resetIdCounters(): void {\n  globalCounters.clear();\n}\n","/**\n * @internal @deprecated Symbol-keyed mutation entry point on `StateContainer`.\n *\n * Per A2 audit (`plans/blac-core-migration/_audit.md`), this symbol has zero\n * external consumers — only in-package tests still reference it. C0 keeps it\n * as a thin alias for `emit()` so the existing test files typecheck and run\n * unchanged; C5 will port those tests to use `emit()` directly and delete\n * this symbol along with its `[EMIT]` method on `StateContainer`.\n *\n * Do not add new uses of this symbol.\n */\nexport const EMIT = Symbol('blac.emit');\n\n/**\n * @internal Apply one owner's (consumer's) deps slice to an instance.\n * Called by framework adapters (e.g. @blac/react useBloc) — not public API.\n *\n * Kept until D0 ports `useBloc` off the legacy adapter surface. See A2 audit\n * (`plans/blac-core-migration/_audit.md`) for the consumer list.\n */\nexport const APPLY_DEPS = Symbol('blac.applyDeps');\n\n/**\n * @internal Withdraw one owner's entire deps slice (consumer unmounted).\n * Called by framework adapters — not public API.\n *\n * Kept until D0 ports `useBloc`. See A2 audit for the consumer list.\n */\nexport const REMOVE_DEPS_OWNER = Symbol('blac.removeDepsOwner');\n","import {\n  ALL_PATHS,\n  StructuralContainer,\n  type DeepPartial,\n  type StructuralContainerOptions,\n} from '@dirtytalk/structural';\nimport { generateSimpleId } from '../utils/idGenerator';\nimport { getRegistry } from '../registry/config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n} from '../types/utilities';\nimport { APPLY_DEPS, EMIT, REMOVE_DEPS_OWNER } from './symbols';\nimport { type EqualityFn, getBlacConfig } from '../config';\nimport { getClassEquality } from '../utils/static-props';\n\nexport interface StateContainerConfig {\n  name?: string;\n  debug?: boolean;\n  instanceId?: string;\n  /** Args passed at acquire time; forwarded to init(). */\n  args?: unknown;\n}\n\nexport type HydrationStatus = 'idle' | 'hydrating' | 'hydrated' | 'error';\n\ntype StateListener<S> = (state: S) => void;\n\nexport type SystemEvent = 'stateChanged' | 'dispose' | 'hydrationChanged';\n\nexport interface SystemEventPayloads<S> {\n  stateChanged: { state: S; previousState: S };\n  dispose: void;\n  hydrationChanged: {\n    status: HydrationStatus;\n    previousStatus: HydrationStatus;\n    error?: Error;\n    changedWhileHydrating: boolean;\n  };\n}\n\ntype SystemEventHandler<S, E extends SystemEvent> = (\n  payload: SystemEventPayloads<S>[E],\n) => void;\n\nconst EMPTY_DEPS: ReadonlyMap<any, any> = new Map();\n\n/**\n * Shallow per-key `Object.is` comparison of two plain records. Keys are\n * considered: a key present in one but not the other (regardless of value)\n * makes the records unequal. Used to detect real deps changes.\n */\nfunction shallowEqualRecord(\n  a: Record<string, unknown>,\n  b: Record<string, unknown>,\n): boolean {\n  if (a === b) return true;\n  const aKeys = Object.keys(a);\n  if (aKeys.length !== Object.keys(b).length) return false;\n  for (const key of aKeys) {\n    if (!(key in b)) return false;\n    if (!Object.is(a[key], b[key])) return false;\n  }\n  return true;\n}\n\n/**\n * BlaC's lifecycle/identity/dependency layer on top of `StructuralContainer`.\n *\n * StructuralContainer provides:\n *   - `state` getter\n *   - `emit` / `patch` / `update` (path-tracked, microtask-flushed)\n *   - `channel` (the underlying `DirtyChannel`)\n *   - `registerConsumerPaths` / `unregisterConsumer` (for fine-grained consumers)\n *   - per-class `PathInterner`\n *\n * StateContainer layers on:\n *   - identity (`name`, `instanceId`, `createdAt`, `debug`)\n *   - lifecycle (`dispose`, `isDisposed`, `onSystemEvent`)\n *   - hydration (`beginHydration` / `applyHydratedState` / `finishHydration` / `failHydration` / `waitForHydration`)\n *   - cross-bloc deps (`depend()`, `dependencies` getter)\n *   - per-consumer deps slices (`APPLY_DEPS` / `REMOVE_DEPS_OWNER` / `onDepsChanged`)\n *   - registry integration (config-driven equality, emit-rate circuit breaker)\n *\n * Subscribers can attach via:\n *   - `subscribe(listener)` — legacy state listener (back-compat); fires on\n *     every flush with the latest state.\n *   - `onSystemEvent('stateChanged' | 'dispose' | 'hydrationChanged', cb)` —\n *     coarse lifecycle events.\n *   - `this.channel.subscribe(interest, cb)` — path-scoped (new code).\n */\nexport abstract class StateContainer<\n  S extends object = any,\n  Args = void,\n  Deps extends object = Record<string, never>,\n> extends StructuralContainer<S> {\n  static __excludeFromDevTools = false;\n\n  /** @internal phantom — the args type this bloc is constructed with (see init()) */\n  declare readonly __args: Args;\n  /** @internal phantom — the injected deps type */\n  declare readonly __deps: Deps;\n\n  // ---------------------------------------------------------------------------\n  // Per-consumer deps slices (APPLY_DEPS / REMOVE_DEPS_OWNER)\n  //\n  // Kept until D0 ports `useBloc` off the adapter surface. See A2 audit:\n  // `@blac/react/src/useBloc.ts` calls these via the `@blac/adapter`\n  // re-export. EMIT is gone; APPLY_DEPS / REMOVE_DEPS_OWNER stay.\n  // ---------------------------------------------------------------------------\n\n  private _depsByOwner: Map<string, Partial<Deps>> | null = null;\n  private _deps: Partial<Deps> = {};\n\n  get deps(): Readonly<Deps> {\n    return this._deps as Readonly<Deps>;\n  }\n\n  /**\n   * @internal Apply one owner's (consumer's) deps slice. Shallow-merges the\n   * slice, reconciles keys the owner dropped since its last apply (other\n   * owners' keys untouched), dev-warns on cross-owner key collisions, then\n   * recomputes the merged view and fires onDepsChanged if it changed.\n   *\n   * Idempotent: re-applying an identical slice for the same owner is a no-op.\n   */\n  [APPLY_DEPS](ownerId: string, slice: Partial<Deps>): void {\n    if (this._disposed) return;\n\n    const owners = (this._depsByOwner ??= new Map());\n    const prevSlice = owners.get(ownerId);\n\n    if (prevSlice && shallowEqualRecord(prevSlice, slice)) {\n      return;\n    }\n\n    if (process.env.NODE_ENV !== 'production') {\n      for (const key of Object.keys(slice) as (keyof Deps)[]) {\n        for (const [otherOwner, otherSlice] of owners) {\n          if (otherOwner === ownerId) continue;\n          if (\n            key in otherSlice &&\n            (otherSlice as Record<keyof Deps, unknown>)[key] !==\n              (slice as Record<keyof Deps, unknown>)[key]\n          ) {\n            console.warn(\n              `[${this.name}] multiple owners writing dep \\`${String(\n                key,\n              )}\\`; last write wins`,\n            );\n          }\n        }\n      }\n    }\n\n    owners.set(ownerId, { ...slice });\n    this.reconcileDeps();\n  }\n\n  /**\n   * @internal Withdraw an owner's entire deps slice (consumer unmounted).\n   */\n  [REMOVE_DEPS_OWNER](ownerId: string): void {\n    if (this._disposed) return;\n    if (!this._depsByOwner?.delete(ownerId)) return;\n    this.reconcileDeps();\n  }\n\n  private reconcileDeps(): void {\n    const prev = this._deps;\n    const next: Partial<Deps> = {};\n    if (this._depsByOwner) {\n      for (const slice of this._depsByOwner.values()) {\n        Object.assign(next, slice);\n      }\n    }\n    for (const key of Object.keys(prev) as (keyof Deps)[]) {\n      if (!(key in next)) {\n        (next as Record<keyof Deps, unknown>)[key] = undefined;\n      }\n    }\n\n    if (shallowEqualRecord(prev, next)) return;\n\n    this._deps = next;\n    this.onDepsChanged(next as Readonly<Deps>, prev as Readonly<Deps>);\n    this._registry.emit(\n      'depsChanged',\n      this,\n      prev as Readonly<Record<string, unknown>>,\n      next as Readonly<Record<string, unknown>>,\n    );\n  }\n\n  protected onDepsChanged(_next: Readonly<Deps>, _prev: Readonly<Deps>): void {}\n\n  // ---------------------------------------------------------------------------\n  // Identity / lifecycle\n  // ---------------------------------------------------------------------------\n\n  private _disposed = false;\n  private _hydrationStatus: HydrationStatus = 'idle';\n  private _hydrationError?: Error;\n  private _changedWhileHydrating = false;\n  private _hydrationPromise: Promise<void> | null = null;\n  private _resolveHydrationPromise?: () => void;\n  private _rejectHydrationPromise?: (error: Error) => void;\n  private _hydrationPromiseSettled = false;\n  private _config: StateContainerConfig = {};\n  private _initCalled = false;\n\n  // Dev-only emit-rate circuit breaker state (see configureBlac.maxEmitsPerSecond).\n  private _emitWindowStart = 0;\n  private _emitCount = 0;\n  private _emitRateWarned = false;\n\n  // Legacy listener-style subscribers (subscribe(listener)). Fires on every\n  // channel flush with the latest state. Kept for back-compat with code that\n  // hasn't migrated to `channel.subscribe(interest, cb)`.\n  private readonly _listeners = new Set<StateListener<S>>();\n\n  // System-event handlers (stateChanged | dispose | hydrationChanged).\n  private readonly _systemEventHandlers = new Map<\n    SystemEvent,\n    Set<SystemEventHandler<S, any>>\n  >();\n\n  // Cross-bloc dependencies recorded by depend(). Map<DepCtor, instanceKey>.\n  private _dependencies: Map<StateContainerConstructor, string> | null = null;\n\n  // Pending state-change capture; set by emit(), drained by the channel-bridge\n  // callback on flush. Coalesced: multiple emits in one tick collapse to one\n  // (prev = the first prev, next = the latest next), matching Decision 7.\n  private _pendingChange: { prev: S; next: S } | null = null;\n\n  // Unsubscribe from the internal bridge that turns channel flushes into\n  // legacy listener calls + 'stateChanged' system events.\n  private _bridgeUnsub: (() => void) | null = null;\n\n  private _registry = getRegistry();\n  private _equalityFn: EqualityFn = getBlacConfig().equality;\n\n  name: string = this.constructor.name;\n  debug: boolean = false;\n  instanceId: string = generateSimpleId(this.constructor.name, 'main');\n  createdAt: number = Date.now();\n\n  get dependencies(): ReadonlyMap<StateContainerConstructor, string> {\n    return this._dependencies ?? EMPTY_DEPS;\n  }\n\n  get args(): Args | undefined {\n    return this._config.args as Args | undefined;\n  }\n\n  /**\n   * Declare a cross-bloc dependency. Returns a getter so callers write\n   * `this.user()` lazily — the dep is resolved against the registry on each\n   * call, which keeps the surface immune to dep-instance churn.\n   *\n   * Note: this does NOT auto-resubscribe to the dep's channel. Consumers that\n   * need reactive updates from a dep should subscribe explicitly (typically\n   * via the framework adapter / `useBloc`'s tracker). A naive auto-bridge\n   * here would cycle on mutual deps; the channel's same-tick coalescing\n   * limits the blast radius but a true mutual cycle is still a user bug.\n   */\n  protected depend<T extends StateContainerConstructor>(\n    Type: T,\n    args?: ExtractArgs<T>,\n  ): () => InstanceType<T> {\n    if (!this._dependencies) {\n      this._dependencies = new Map();\n    }\n    const key = this._registry.resolveKey(Type, undefined, args);\n    this._dependencies.set(Type, key);\n    return () => this._registry.ensure(Type, key, args);\n  }\n\n  constructor(initialState: S, options?: StructuralContainerOptions) {\n    super(initialState, options);\n\n    // Bridge channel flushes -> legacy listeners + 'stateChanged' system event.\n    // Interest is ALL_PATHS so we wake on every flush. Coalesced via\n    // `_pendingChange`: if no emit happened (e.g. a no-op patch), the bridge\n    // sees null and skips.\n    this._bridgeUnsub = this.channel.subscribe(\n      () => ALL_PATHS,\n      () => this._drainPending(),\n    );\n  }\n\n  /**\n   * Called once after construction with the args passed at acquire time, before the first\n   * state snapshot is read by any consumer. Override to seed args-derived state (via\n   * this.emit(...)) or kick off loads.\n   */\n  protected init(_args: Args): void {}\n\n  initConfig(config: StateContainerConfig): void {\n    this._config = { ...config };\n    this.name = this._config.name || this.constructor.name;\n    this.debug = this._config.debug ?? false;\n    this.instanceId = generateSimpleId(\n      this.constructor.name,\n      this._config.instanceId,\n    );\n    const perClass = getClassEquality(\n      this.constructor as StateContainerConstructor,\n    );\n    this._equalityFn = perClass ?? getBlacConfig().equality;\n    this._registry.emit('created', this);\n    if (!this._initCalled) {\n      this._initCalled = true;\n      this.init(this._config.args as Args);\n    }\n  }\n\n  get isDisposed(): boolean {\n    return this._disposed;\n  }\n\n  get hydrationStatus(): HydrationStatus {\n    return this._hydrationStatus;\n  }\n\n  get hydrationError(): Error | undefined {\n    return this._hydrationError;\n  }\n\n  get isHydrated(): boolean {\n    return this._hydrationStatus === 'hydrated';\n  }\n\n  get changedWhileHydrating(): boolean {\n    return this._changedWhileHydrating;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Subscribe (legacy listener-style) — back-compat.\n  //\n  // Old surface: subscribe(listener: (state) => void). New code should use\n  // `this.channel.subscribe(interest, cb)` directly. This override shadows\n  // `StructuralContainer.subscribe`'s richer signature on purpose — only one\n  // legacy consumer pattern exists (per A2 audit: tracking/, watch/, adapter).\n  // ---------------------------------------------------------------------------\n\n  subscribe(listener: StateListener<S>): () => void {\n    if (this._disposed) {\n      throw new Error(`Cannot subscribe to disposed container ${this.name}`);\n    }\n    this._listeners.add(listener);\n    return () => {\n      this._listeners.delete(listener);\n    };\n  }\n\n  // ---------------------------------------------------------------------------\n  // Lifecycle: dispose\n  // ---------------------------------------------------------------------------\n\n  dispose(): void {\n    if (this._disposed) return;\n\n    if (this.debug) {\n      console.log(`[${this.name}] Disposing...`);\n    }\n\n    // Reconcile to an empty deps view so a final onDepsChanged(next, prev)\n    // fires with all keys absent (undefined). After this, APPLY_DEPS /\n    // REMOVE_DEPS_OWNER are guarded by _disposed.\n    if (this._depsByOwner) {\n      this._depsByOwner.clear();\n      this.reconcileDeps();\n    }\n\n    this._disposed = true;\n\n    if (this._hydrationStatus === 'hydrating') {\n      this.failHydration(\n        new Error(`Hydration cancelled because ${this.name} was disposed`),\n      );\n    }\n\n    this.emitSystemEvent('dispose', undefined as void);\n\n    // Tear down the channel bridge so we don't leak a subscription.\n    this._bridgeUnsub?.();\n    this._bridgeUnsub = null;\n\n    this._listeners.clear();\n    this._systemEventHandlers.clear();\n    this._pendingChange = null;\n\n    this._registry.emit('disposed', this);\n\n    if (this.debug) {\n      console.log(`[${this.name}] Disposed successfully`);\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Mutation: emit / patch / update.\n  //\n  // We override `emit` to layer in:\n  //   - disposed guard\n  //   - equality-fn short-circuit (consults getBlacConfig().equality or the\n  //     per-class override via @blac decorator)\n  //   - emit-rate circuit breaker (dev-only)\n  //   - `_changedWhileHydrating` flag tracking\n  //   - registry-level stateChanged notification (microtask-deferred)\n  //   - pending-change capture so the channel-bridge callback can fire the\n  //     legacy listeners + 'stateChanged' system event with prev/next.\n  //\n  // The actual change-detection (path diff, channel mark, single-consumer\n  // skip) is delegated to `super.emit`.\n  // ---------------------------------------------------------------------------\n\n  override emit(next: S): void {\n    this.applyState(next, 'default');\n  }\n\n  /**\n   * Override of `StructuralContainer.patch` that routes through the\n   * StateContainer concerns: disposed guard, dev-only emit-rate check,\n   * `_changedWhileHydrating` flag, pending-change capture (so legacy\n   * listeners and `stateChanged` system events see the merged prev/next),\n   * and the registry-level `stateChanged` notification. We still call\n   * `super.patch` so path-marking semantics (the whole point of patch) are\n   * preserved.\n   */\n  override patch(partial: DeepPartial<S>): void {\n    if (this._disposed) {\n      throw new Error(`Cannot emit state from disposed container ${this.name}`);\n    }\n    const partialKeys = Object.keys(partial as object);\n    if (partialKeys.length === 0) return;\n\n    const prev = this.state;\n\n    // Pre-spread skip: if every top-level key in `partial` is already\n    // `Object.is`-equal to the current state's value at that key, the\n    // merge is a structural no-op — skip entirely. Matches the pre-C0\n    // `Cubit.patch` semantics (per-key Object.is short-circuit). This is\n    // shallow on purpose; deep no-op detection lives in `super.patch`'s\n    // path-diff path which still wakes consumers if anything truly moved.\n    let allEqual = true;\n    for (const key of partialKeys) {\n      if (\n        !Object.is(\n          (prev as Record<string, unknown>)[key],\n          (partial as Record<string, unknown>)[key],\n        )\n      ) {\n        allEqual = false;\n        break;\n      }\n    }\n    if (allEqual) return;\n\n    if (process.env.NODE_ENV !== 'production') {\n      this._checkEmitRate();\n    }\n\n    super.patch(partial);\n\n    const next = this.state;\n    if (Object.is(prev, next)) return;\n\n    if (this._hydrationStatus === 'hydrating') {\n      this._changedWhileHydrating = true;\n    }\n\n    if (this._pendingChange) {\n      this._pendingChange.next = next;\n    } else {\n      this._pendingChange = { prev, next };\n    }\n\n    if (this._registry.hasStateChangedListeners) {\n      this._registry.notifyStateChanged(this, prev, next);\n    }\n  }\n\n  /**\n   * @internal @deprecated Symbol-keyed alias for `emit`. Kept only so legacy\n   * in-package tests that index with `[EMIT]` typecheck/run unchanged. C5\n   * removes this along with the `EMIT` symbol.\n   */\n  protected [EMIT](next: S): void {\n    this.applyState(next, 'default');\n  }\n\n  private applyState(next: S, source: 'default' | 'hydration'): void {\n    if (this._disposed) {\n      throw new Error(`Cannot emit state from disposed container ${this.name}`);\n    }\n\n    const prev = this.state;\n    if (prev === next) return;\n    if (this._equalityFn(prev, next)) return;\n\n    if (process.env.NODE_ENV !== 'production') {\n      this._checkEmitRate();\n    }\n\n    if (this._hydrationStatus === 'hydrating' && source !== 'hydration') {\n      this._changedWhileHydrating = true;\n    }\n\n    // Coalesce: keep the first prev seen this tick, take the latest next.\n    if (this._pendingChange) {\n      this._pendingChange.next = next;\n    } else {\n      this._pendingChange = { prev, next };\n    }\n\n    super.emit(next);\n\n    if (this._registry.hasStateChangedListeners) {\n      this._registry.notifyStateChanged(this, prev, next);\n    }\n  }\n\n  /**\n   * Called by the channel-bridge subscriber on each flush. Drains the\n   * pending change (if any) into legacy listeners and the 'stateChanged'\n   * system event. No pending change == flush from a no-op patch == skip.\n   */\n  private _drainPending(): void {\n    const pending = this._pendingChange;\n    if (!pending) return;\n    this._pendingChange = null;\n\n    // Iterate against a fixed-size snapshot so a listener that subscribes a\n    // new listener mid-drain does not get the late one called in this flush.\n    // (Matches the pre-C0 contract; restored by counting against the size\n    // captured at drain entry.) Order matches pre-C0: 'stateChanged' system\n    // event fires *before* legacy subscribe() listeners.\n    const handlers = this._systemEventHandlers.get('stateChanged');\n    if (handlers && handlers.size > 0) {\n      const payload = { state: pending.next, previousState: pending.prev };\n      let count = 0;\n      const size = handlers.size;\n      for (const handler of handlers) {\n        if (++count > size) break;\n        try {\n          handler(payload);\n        } catch (error) {\n          console.error(`[${this.name}] Error in system event handler:`, error);\n        }\n      }\n    }\n\n    if (this._listeners.size > 0) {\n      const current = this.state;\n      let count = 0;\n      const size = this._listeners.size;\n      for (const listener of this._listeners) {\n        if (++count > size) break;\n        try {\n          listener(current);\n        } catch (error) {\n          console.error(`[${this.name}] Error in listener:`, error);\n        }\n      }\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Hydration\n  // ---------------------------------------------------------------------------\n\n  beginHydration(): void {\n    if (this._disposed) {\n      throw new Error(\n        `Cannot begin hydration for disposed container ${this.name}`,\n      );\n    }\n\n    this._changedWhileHydrating = false;\n    this._hydrationError = undefined;\n    this._hydrationPromise = null;\n    this._resolveHydrationPromise = undefined;\n    this._rejectHydrationPromise = undefined;\n    this._hydrationPromiseSettled = false;\n    void this.ensureHydrationPromise();\n    this.setHydrationStatus('hydrating');\n  }\n\n  applyHydratedState(next: S): boolean {\n    if (this._disposed) {\n      return false;\n    }\n\n    if (this._hydrationStatus !== 'hydrating' || this._changedWhileHydrating) {\n      return false;\n    }\n\n    this.applyState(next, 'hydration');\n    return true;\n  }\n\n  finishHydration(): void {\n    if (this._hydrationStatus !== 'hydrating') {\n      if (this._hydrationStatus === 'hydrated') {\n        return;\n      }\n      if (this._hydrationStatus === 'error') {\n        void this.ensureHydrationPromise();\n      }\n    }\n\n    this.setHydrationStatus('hydrated');\n    this.resolveHydration();\n  }\n\n  failHydration(error: Error): void {\n    const err =\n      error instanceof Error\n        ? error\n        : new Error(`Hydration failed: ${String(error)}`);\n\n    this._hydrationError = err;\n    this.setHydrationStatus('error', err);\n    this.rejectHydration(err);\n  }\n\n  waitForHydration(): Promise<void> {\n    if (\n      this._hydrationStatus === 'idle' ||\n      this._hydrationStatus === 'hydrated'\n    ) {\n      return Promise.resolve();\n    }\n\n    if (this._hydrationStatus === 'error') {\n      return Promise.reject(\n        this._hydrationError ??\n          new Error(`Hydration failed for container ${this.name}`),\n      );\n    }\n\n    return this.ensureHydrationPromise();\n  }\n\n  private setHydrationStatus(status: HydrationStatus, error?: Error): void {\n    const previousStatus = this._hydrationStatus;\n    this._hydrationStatus = status;\n    this._hydrationError = error;\n\n    this.emitSystemEvent('hydrationChanged', {\n      status,\n      previousStatus,\n      error,\n      changedWhileHydrating: this._changedWhileHydrating,\n    });\n  }\n\n  private ensureHydrationPromise(): Promise<void> {\n    if (!this._hydrationPromise || this._hydrationPromiseSettled) {\n      this._hydrationPromiseSettled = false;\n      this._hydrationPromise = new Promise<void>((resolve, reject) => {\n        this._resolveHydrationPromise = () => {\n          if (this._hydrationPromiseSettled) return;\n          this._hydrationPromiseSettled = true;\n          resolve();\n        };\n        this._rejectHydrationPromise = (error: Error) => {\n          if (this._hydrationPromiseSettled) return;\n          this._hydrationPromiseSettled = true;\n          reject(error);\n        };\n      });\n      this._hydrationPromise.catch(() => {});\n    }\n\n    return this._hydrationPromise;\n  }\n\n  private resolveHydration(): void {\n    this._resolveHydrationPromise?.();\n  }\n\n  private rejectHydration(error: Error): void {\n    void this.ensureHydrationPromise();\n    this._rejectHydrationPromise?.(error);\n  }\n\n  // ---------------------------------------------------------------------------\n  // System events\n  // ---------------------------------------------------------------------------\n\n  protected onSystemEvent = <E extends SystemEvent>(\n    event: E,\n    handler: SystemEventHandler<S, E>,\n  ): (() => void) => {\n    let handlers = this._systemEventHandlers.get(event);\n    if (!handlers) {\n      handlers = new Set();\n      this._systemEventHandlers.set(event, handlers);\n    }\n    handlers.add(handler as SystemEventHandler<S, any>);\n\n    return () => {\n      handlers?.delete(handler as SystemEventHandler<S, any>);\n    };\n  };\n\n  private emitSystemEvent<E extends SystemEvent>(\n    event: E,\n    payload: SystemEventPayloads<S>[E],\n  ): void {\n    const handlers = this._systemEventHandlers.get(event);\n    if (!handlers) return;\n\n    for (const handler of handlers) {\n      try {\n        handler(payload);\n      } catch (error) {\n        console.error(`[${this.name}] Error in system event handler:`, error);\n      }\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Emit-rate circuit breaker (dev-only)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Dev-only soft circuit breaker. Counts real state changes in a rolling 1s\n   * window and warns once if the rate exceeds `maxEmitsPerSecond` — the\n   * signature of a runaway loop (RAF/animation or emit-on-every-commit) pushing\n   * high-frequency data through state, which freezes subscribers/plugins.\n   */\n  private _checkEmitRate(): void {\n    const limit = getBlacConfig().maxEmitsPerSecond;\n    if (!(limit > 0) || !Number.isFinite(limit) || this._emitRateWarned) return;\n\n    const now = Date.now();\n    if (now - this._emitWindowStart >= 1000) {\n      this._emitWindowStart = now;\n      this._emitCount = 1;\n      return;\n    }\n\n    this._emitCount++;\n    if (this._emitCount > limit) {\n      this._emitRateWarned = true;\n      console.warn(\n        `[${this.name}] emitted more than ${limit} state changes in under a second. ` +\n          `This is usually a runaway loop pushing high-frequency data through state ` +\n          `(e.g. \\`emit\\`/\\`patch\\` inside a requestAnimationFrame loop, or an effect ` +\n          `that emits on every render). It can freeze the app by saturating ` +\n          `subscribers and plugins (logging/devtools). Keep high-frequency work ` +\n          `imperative and emit only coarse/throttled state, or raise ` +\n          `\\`configureBlac({ maxEmitsPerSecond })\\`. (This warning fires once.)`,\n      );\n    }\n  }\n}\n","import { StateContainer } from './StateContainer';\n\n/**\n * `Cubit<S>` is a `StateContainer<S>` with `emit` / `patch` exposed as\n * public mutation surface. Today it adds nothing structurally beyond\n * `StateContainer` — both are inherited from the underlying\n * `StructuralContainer<S>`. Kept as a real class (not a type alias) because\n * downstream code does `instance instanceof Cubit` checks (see A2 audit).\n *\n * The class body is intentionally empty: a no-op `emit` override would\n * still go through `applyState`, and `patch` is inherited from\n * `StructuralContainer` (path-diffed, microtask-flushed). If a caller\n * needs the old \"skip if no real change\" patch semantics, they can wrap\n * `patch` themselves or call `emit` after a manual equality check.\n */\nexport abstract class Cubit<\n  S extends object = any,\n  Args = void,\n  Deps extends object = Record<string, never>,\n> extends StateContainer<S, Args, Deps> {}\n","import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n} from '../types/utilities';\n\n/**\n * Ensure an instance exists without taking ownership (no ref added). Instance\n * identity is derived purely from `args`, matching `acquire`.\n */\nexport function ensure<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): InstanceType<T> {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.ensure(BlocClass, key, opts?.args);\n}\n"],"mappings":"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"}

package/dist/{Cubit-VJuu2tt9.js → ensure-CPMiGvov.js}

@@ -1,5 +1,5 @@
-import { f as getBlacConfig, i as getClassEquality, l as BLAC_DEFAULTS } from "./StateContainerRegistry-DmmzYa7S.js";
-import { t as getRegistry } from "./config-DoHx0Xsl.js";
+import { i as getClassEquality, u as getBlacConfig } from "./StateContainerRegistry-B_ViBLvJ.js";
+import { t as getRegistry } from "./config-8pyOC5gv.js";
 import { ALL_PATHS, StructuralContainer } from "@dirtytalk/structural";
 //#region src/utils/idGenerator.ts
 /**
@@ -155,10 +155,11 @@ var StateContainer = class extends 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 ?? 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 StructuralContainer {
 */
 var Cubit = class extends StateContainer {};
 //#endregion
-export { REMOVE_DEPS_OWNER as a, EMIT as i, StateContainer as n, APPLY_DEPS as r, Cubit as t };
+//#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 = getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.ensure(BlocClass, key, opts?.args);
+}
+//#endregion
+export { EMIT as a, APPLY_DEPS as i, Cubit as n, REMOVE_DEPS_OWNER as o, StateContainer as r, ensure as t };
 
-//# sourceMappingURL=Cubit-VJuu2tt9.js.map
+//# sourceMappingURL=ensure-CPMiGvov.js.map

package/dist/ensure-CPMiGvov.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-CPMiGvov.js","names":[],"sources":["../src/utils/idGenerator.ts","../src/core/symbols.ts","../src/core/StateContainer.ts","../src/core/Cubit.ts","../src/registry/ensure.ts"],"sourcesContent":["/**\n * Centralized ID Generation\n *\n * Provides consistent, collision-resistant ID generation for all BlaC subsystems.\n * Uses timestamp + counter + random suffix for uniqueness.\n */\n\n// Global counter map for ID generation\nconst globalCounters = new Map<string, number>();\n\n/**\n * Creates an ID generator with isolated counter state\n *\n * @param prefix - Prefix for generated IDs\n * @returns Object with next(), nextSimple(), and reset() methods\n *\n * @example\n * ```ts\n * const generator = createIdGenerator('sub');\n * const id1 = generator.next(); // \"sub:1698765432100_1_a3k9d7f2q\"\n * const id2 = generator.next(); // \"sub:1698765432101_2_b4n8e9g3r\"\n * ```\n */\nexport function createIdGenerator(prefix: string) {\n  let counter = 0;\n  return {\n    next: () =>\n      `${prefix}:${Date.now()}_${++counter}_${Math.random().toString(36).substring(2, 11)}`,\n    nextSimple: () => `${prefix}:${++counter}`,\n    reset: () => {\n      counter = 0;\n    },\n  };\n}\n\n/**\n * Generate ID with timestamp, counter, and random suffix (tree-shakeable)\n *\n * Format: `${prefix}:${timestamp}_${counter}_${random}`\n *\n * @param prefix - Prefix for the ID (e.g., 'sub', 'consumer', 'stage')\n * @returns Branded ID string\n *\n * @example\n * const id = generateId('sub');\n * // Returns: \"sub:1698765432100_1_a3k9d7f2q\"\n */\nexport function generateId(prefix: string): string {\n  const counter = (globalCounters.get(prefix) ?? 0) + 1;\n  globalCounters.set(prefix, counter);\n  const timestamp = Date.now();\n  const random = Math.random().toString(36).substring(2, 11);\n  return `${prefix}:${timestamp}_${counter}_${random}`;\n}\n\n/**\n * Generate simple ID with timestamp and random (no counter tracking)\n *\n * Format: `${prefix}:${timestamp}_${random}`\n *\n * @param prefix - Prefix for the ID\n * @returns Branded ID string\n *\n * @example\n * ```ts\n * const id = generateSimpleId('CounterBloc');\n * // Returns: \"CounterBloc:1698765432100_a3k9d7f2q\"\n * ```\n */\nexport function generateSimpleId(prefix: string, affix?: string): string {\n  if (affix) {\n    return `${prefix}:${affix}`;\n  }\n  const timestamp = Date.now();\n  const random = Math.random().toString(36).substring(2, 11);\n  return `${prefix}:${timestamp}_${random}`;\n}\n\n/**\n * Reset all counters for testing purposes\n * @internal\n */\nexport function __resetIdCounters(): void {\n  globalCounters.clear();\n}\n","/**\n * @internal @deprecated Symbol-keyed mutation entry point on `StateContainer`.\n *\n * Per A2 audit (`plans/blac-core-migration/_audit.md`), this symbol has zero\n * external consumers — only in-package tests still reference it. C0 keeps it\n * as a thin alias for `emit()` so the existing test files typecheck and run\n * unchanged; C5 will port those tests to use `emit()` directly and delete\n * this symbol along with its `[EMIT]` method on `StateContainer`.\n *\n * Do not add new uses of this symbol.\n */\nexport const EMIT = Symbol('blac.emit');\n\n/**\n * @internal Apply one owner's (consumer's) deps slice to an instance.\n * Called by framework adapters (e.g. @blac/react useBloc) — not public API.\n *\n * Kept until D0 ports `useBloc` off the legacy adapter surface. See A2 audit\n * (`plans/blac-core-migration/_audit.md`) for the consumer list.\n */\nexport const APPLY_DEPS = Symbol('blac.applyDeps');\n\n/**\n * @internal Withdraw one owner's entire deps slice (consumer unmounted).\n * Called by framework adapters — not public API.\n *\n * Kept until D0 ports `useBloc`. See A2 audit for the consumer list.\n */\nexport const REMOVE_DEPS_OWNER = Symbol('blac.removeDepsOwner');\n","import {\n  ALL_PATHS,\n  StructuralContainer,\n  type DeepPartial,\n  type StructuralContainerOptions,\n} from '@dirtytalk/structural';\nimport { generateSimpleId } from '../utils/idGenerator';\nimport { getRegistry } from '../registry/config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n} from '../types/utilities';\nimport { APPLY_DEPS, EMIT, REMOVE_DEPS_OWNER } from './symbols';\nimport { type EqualityFn, getBlacConfig } from '../config';\nimport { getClassEquality } from '../utils/static-props';\n\nexport interface StateContainerConfig {\n  name?: string;\n  debug?: boolean;\n  instanceId?: string;\n  /** Args passed at acquire time; forwarded to init(). */\n  args?: unknown;\n}\n\nexport type HydrationStatus = 'idle' | 'hydrating' | 'hydrated' | 'error';\n\ntype StateListener<S> = (state: S) => void;\n\nexport type SystemEvent = 'stateChanged' | 'dispose' | 'hydrationChanged';\n\nexport interface SystemEventPayloads<S> {\n  stateChanged: { state: S; previousState: S };\n  dispose: void;\n  hydrationChanged: {\n    status: HydrationStatus;\n    previousStatus: HydrationStatus;\n    error?: Error;\n    changedWhileHydrating: boolean;\n  };\n}\n\ntype SystemEventHandler<S, E extends SystemEvent> = (\n  payload: SystemEventPayloads<S>[E],\n) => void;\n\nconst EMPTY_DEPS: ReadonlyMap<any, any> = new Map();\n\n/**\n * Shallow per-key `Object.is` comparison of two plain records. Keys are\n * considered: a key present in one but not the other (regardless of value)\n * makes the records unequal. Used to detect real deps changes.\n */\nfunction shallowEqualRecord(\n  a: Record<string, unknown>,\n  b: Record<string, unknown>,\n): boolean {\n  if (a === b) return true;\n  const aKeys = Object.keys(a);\n  if (aKeys.length !== Object.keys(b).length) return false;\n  for (const key of aKeys) {\n    if (!(key in b)) return false;\n    if (!Object.is(a[key], b[key])) return false;\n  }\n  return true;\n}\n\n/**\n * BlaC's lifecycle/identity/dependency layer on top of `StructuralContainer`.\n *\n * StructuralContainer provides:\n *   - `state` getter\n *   - `emit` / `patch` / `update` (path-tracked, microtask-flushed)\n *   - `channel` (the underlying `DirtyChannel`)\n *   - `registerConsumerPaths` / `unregisterConsumer` (for fine-grained consumers)\n *   - per-class `PathInterner`\n *\n * StateContainer layers on:\n *   - identity (`name`, `instanceId`, `createdAt`, `debug`)\n *   - lifecycle (`dispose`, `isDisposed`, `onSystemEvent`)\n *   - hydration (`beginHydration` / `applyHydratedState` / `finishHydration` / `failHydration` / `waitForHydration`)\n *   - cross-bloc deps (`depend()`, `dependencies` getter)\n *   - per-consumer deps slices (`APPLY_DEPS` / `REMOVE_DEPS_OWNER` / `onDepsChanged`)\n *   - registry integration (config-driven equality, emit-rate circuit breaker)\n *\n * Subscribers can attach via:\n *   - `subscribe(listener)` — legacy state listener (back-compat); fires on\n *     every flush with the latest state.\n *   - `onSystemEvent('stateChanged' | 'dispose' | 'hydrationChanged', cb)` —\n *     coarse lifecycle events.\n *   - `this.channel.subscribe(interest, cb)` — path-scoped (new code).\n */\nexport abstract class StateContainer<\n  S extends object = any,\n  Args = void,\n  Deps extends object = Record<string, never>,\n> extends StructuralContainer<S> {\n  static __excludeFromDevTools = false;\n\n  /** @internal phantom — the args type this bloc is constructed with (see init()) */\n  declare readonly __args: Args;\n  /** @internal phantom — the injected deps type */\n  declare readonly __deps: Deps;\n\n  // ---------------------------------------------------------------------------\n  // Per-consumer deps slices (APPLY_DEPS / REMOVE_DEPS_OWNER)\n  //\n  // Kept until D0 ports `useBloc` off the adapter surface. See A2 audit:\n  // `@blac/react/src/useBloc.ts` calls these via the `@blac/adapter`\n  // re-export. EMIT is gone; APPLY_DEPS / REMOVE_DEPS_OWNER stay.\n  // ---------------------------------------------------------------------------\n\n  private _depsByOwner: Map<string, Partial<Deps>> | null = null;\n  private _deps: Partial<Deps> = {};\n\n  get deps(): Readonly<Deps> {\n    return this._deps as Readonly<Deps>;\n  }\n\n  /**\n   * @internal Apply one owner's (consumer's) deps slice. Shallow-merges the\n   * slice, reconciles keys the owner dropped since its last apply (other\n   * owners' keys untouched), dev-warns on cross-owner key collisions, then\n   * recomputes the merged view and fires onDepsChanged if it changed.\n   *\n   * Idempotent: re-applying an identical slice for the same owner is a no-op.\n   */\n  [APPLY_DEPS](ownerId: string, slice: Partial<Deps>): void {\n    if (this._disposed) return;\n\n    const owners = (this._depsByOwner ??= new Map());\n    const prevSlice = owners.get(ownerId);\n\n    if (prevSlice && shallowEqualRecord(prevSlice, slice)) {\n      return;\n    }\n\n    if (process.env.NODE_ENV !== 'production') {\n      for (const key of Object.keys(slice) as (keyof Deps)[]) {\n        for (const [otherOwner, otherSlice] of owners) {\n          if (otherOwner === ownerId) continue;\n          if (\n            key in otherSlice &&\n            (otherSlice as Record<keyof Deps, unknown>)[key] !==\n              (slice as Record<keyof Deps, unknown>)[key]\n          ) {\n            console.warn(\n              `[${this.name}] multiple owners writing dep \\`${String(\n                key,\n              )}\\`; last write wins`,\n            );\n          }\n        }\n      }\n    }\n\n    owners.set(ownerId, { ...slice });\n    this.reconcileDeps();\n  }\n\n  /**\n   * @internal Withdraw an owner's entire deps slice (consumer unmounted).\n   */\n  [REMOVE_DEPS_OWNER](ownerId: string): void {\n    if (this._disposed) return;\n    if (!this._depsByOwner?.delete(ownerId)) return;\n    this.reconcileDeps();\n  }\n\n  private reconcileDeps(): void {\n    const prev = this._deps;\n    const next: Partial<Deps> = {};\n    if (this._depsByOwner) {\n      for (const slice of this._depsByOwner.values()) {\n        Object.assign(next, slice);\n      }\n    }\n    for (const key of Object.keys(prev) as (keyof Deps)[]) {\n      if (!(key in next)) {\n        (next as Record<keyof Deps, unknown>)[key] = undefined;\n      }\n    }\n\n    if (shallowEqualRecord(prev, next)) return;\n\n    this._deps = next;\n    this.onDepsChanged(next as Readonly<Deps>, prev as Readonly<Deps>);\n    this._registry.emit(\n      'depsChanged',\n      this,\n      prev as Readonly<Record<string, unknown>>,\n      next as Readonly<Record<string, unknown>>,\n    );\n  }\n\n  protected onDepsChanged(_next: Readonly<Deps>, _prev: Readonly<Deps>): void {}\n\n  // ---------------------------------------------------------------------------\n  // Identity / lifecycle\n  // ---------------------------------------------------------------------------\n\n  private _disposed = false;\n  private _hydrationStatus: HydrationStatus = 'idle';\n  private _hydrationError?: Error;\n  private _changedWhileHydrating = false;\n  private _hydrationPromise: Promise<void> | null = null;\n  private _resolveHydrationPromise?: () => void;\n  private _rejectHydrationPromise?: (error: Error) => void;\n  private _hydrationPromiseSettled = false;\n  private _config: StateContainerConfig = {};\n  private _initCalled = false;\n\n  // Dev-only emit-rate circuit breaker state (see configureBlac.maxEmitsPerSecond).\n  private _emitWindowStart = 0;\n  private _emitCount = 0;\n  private _emitRateWarned = false;\n\n  // Legacy listener-style subscribers (subscribe(listener)). Fires on every\n  // channel flush with the latest state. Kept for back-compat with code that\n  // hasn't migrated to `channel.subscribe(interest, cb)`.\n  private readonly _listeners = new Set<StateListener<S>>();\n\n  // System-event handlers (stateChanged | dispose | hydrationChanged).\n  private readonly _systemEventHandlers = new Map<\n    SystemEvent,\n    Set<SystemEventHandler<S, any>>\n  >();\n\n  // Cross-bloc dependencies recorded by depend(). Map<DepCtor, instanceKey>.\n  private _dependencies: Map<StateContainerConstructor, string> | null = null;\n\n  // Pending state-change capture; set by emit(), drained by the channel-bridge\n  // callback on flush. Coalesced: multiple emits in one tick collapse to one\n  // (prev = the first prev, next = the latest next), matching Decision 7.\n  private _pendingChange: { prev: S; next: S } | null = null;\n\n  // Unsubscribe from the internal bridge that turns channel flushes into\n  // legacy listener calls + 'stateChanged' system events.\n  private _bridgeUnsub: (() => void) | null = null;\n\n  private _registry = getRegistry();\n  private _equalityFn: EqualityFn = getBlacConfig().equality;\n\n  name: string = this.constructor.name;\n  debug: boolean = false;\n  instanceId: string = generateSimpleId(this.constructor.name, 'main');\n  createdAt: number = Date.now();\n\n  get dependencies(): ReadonlyMap<StateContainerConstructor, string> {\n    return this._dependencies ?? EMPTY_DEPS;\n  }\n\n  get args(): Args | undefined {\n    return this._config.args as Args | undefined;\n  }\n\n  /**\n   * Declare a cross-bloc dependency. Returns a getter so callers write\n   * `this.user()` lazily — the dep is resolved against the registry on each\n   * call, which keeps the surface immune to dep-instance churn.\n   *\n   * Note: this does NOT auto-resubscribe to the dep's channel. Consumers that\n   * need reactive updates from a dep should subscribe explicitly (typically\n   * via the framework adapter / `useBloc`'s tracker). A naive auto-bridge\n   * here would cycle on mutual deps; the channel's same-tick coalescing\n   * limits the blast radius but a true mutual cycle is still a user bug.\n   */\n  protected depend<T extends StateContainerConstructor>(\n    Type: T,\n    args?: ExtractArgs<T>,\n  ): () => InstanceType<T> {\n    if (!this._dependencies) {\n      this._dependencies = new Map();\n    }\n    const key = this._registry.resolveKey(Type, undefined, args);\n    this._dependencies.set(Type, key);\n    return () => this._registry.ensure(Type, key, args);\n  }\n\n  constructor(initialState: S, options?: StructuralContainerOptions) {\n    super(initialState, options);\n\n    // Bridge channel flushes -> legacy listeners + 'stateChanged' system event.\n    // Interest is ALL_PATHS so we wake on every flush. Coalesced via\n    // `_pendingChange`: if no emit happened (e.g. a no-op patch), the bridge\n    // sees null and skips.\n    this._bridgeUnsub = this.channel.subscribe(\n      () => ALL_PATHS,\n      () => this._drainPending(),\n    );\n  }\n\n  /**\n   * Called once after construction with the args passed at acquire time, before the first\n   * state snapshot is read by any consumer. Override to seed args-derived state (via\n   * this.emit(...)) or kick off loads.\n   */\n  protected init(_args: Args): void {}\n\n  initConfig(config: StateContainerConfig): void {\n    this._config = { ...config };\n    this.name = this._config.name || this.constructor.name;\n    this.debug = this._config.debug ?? false;\n    this.instanceId = generateSimpleId(\n      this.constructor.name,\n      this._config.instanceId,\n    );\n    const perClass = getClassEquality(\n      this.constructor as StateContainerConstructor,\n    );\n    this._equalityFn = perClass ?? getBlacConfig().equality;\n    this._registry.emit('created', this);\n    if (!this._initCalled) {\n      this._initCalled = true;\n      this.init(this._config.args as Args);\n    }\n  }\n\n  get isDisposed(): boolean {\n    return this._disposed;\n  }\n\n  get hydrationStatus(): HydrationStatus {\n    return this._hydrationStatus;\n  }\n\n  get hydrationError(): Error | undefined {\n    return this._hydrationError;\n  }\n\n  get isHydrated(): boolean {\n    return this._hydrationStatus === 'hydrated';\n  }\n\n  get changedWhileHydrating(): boolean {\n    return this._changedWhileHydrating;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Subscribe (legacy listener-style) — back-compat.\n  //\n  // Old surface: subscribe(listener: (state) => void). New code should use\n  // `this.channel.subscribe(interest, cb)` directly. This override shadows\n  // `StructuralContainer.subscribe`'s richer signature on purpose — only one\n  // legacy consumer pattern exists (per A2 audit: tracking/, watch/, adapter).\n  // ---------------------------------------------------------------------------\n\n  subscribe(listener: StateListener<S>): () => void {\n    if (this._disposed) {\n      throw new Error(`Cannot subscribe to disposed container ${this.name}`);\n    }\n    this._listeners.add(listener);\n    return () => {\n      this._listeners.delete(listener);\n    };\n  }\n\n  // ---------------------------------------------------------------------------\n  // Lifecycle: dispose\n  // ---------------------------------------------------------------------------\n\n  dispose(): void {\n    if (this._disposed) return;\n\n    if (this.debug) {\n      console.log(`[${this.name}] Disposing...`);\n    }\n\n    // Reconcile to an empty deps view so a final onDepsChanged(next, prev)\n    // fires with all keys absent (undefined). After this, APPLY_DEPS /\n    // REMOVE_DEPS_OWNER are guarded by _disposed.\n    if (this._depsByOwner) {\n      this._depsByOwner.clear();\n      this.reconcileDeps();\n    }\n\n    this._disposed = true;\n\n    if (this._hydrationStatus === 'hydrating') {\n      this.failHydration(\n        new Error(`Hydration cancelled because ${this.name} was disposed`),\n      );\n    }\n\n    this.emitSystemEvent('dispose', undefined as void);\n\n    // Tear down the channel bridge so we don't leak a subscription.\n    this._bridgeUnsub?.();\n    this._bridgeUnsub = null;\n\n    this._listeners.clear();\n    this._systemEventHandlers.clear();\n    this._pendingChange = null;\n\n    this._registry.emit('disposed', this);\n\n    if (this.debug) {\n      console.log(`[${this.name}] Disposed successfully`);\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Mutation: emit / patch / update.\n  //\n  // We override `emit` to layer in:\n  //   - disposed guard\n  //   - equality-fn short-circuit (consults getBlacConfig().equality or the\n  //     per-class override via @blac decorator)\n  //   - emit-rate circuit breaker (dev-only)\n  //   - `_changedWhileHydrating` flag tracking\n  //   - registry-level stateChanged notification (microtask-deferred)\n  //   - pending-change capture so the channel-bridge callback can fire the\n  //     legacy listeners + 'stateChanged' system event with prev/next.\n  //\n  // The actual change-detection (path diff, channel mark, single-consumer\n  // skip) is delegated to `super.emit`.\n  // ---------------------------------------------------------------------------\n\n  override emit(next: S): void {\n    this.applyState(next, 'default');\n  }\n\n  /**\n   * Override of `StructuralContainer.patch` that routes through the\n   * StateContainer concerns: disposed guard, dev-only emit-rate check,\n   * `_changedWhileHydrating` flag, pending-change capture (so legacy\n   * listeners and `stateChanged` system events see the merged prev/next),\n   * and the registry-level `stateChanged` notification. We still call\n   * `super.patch` so path-marking semantics (the whole point of patch) are\n   * preserved.\n   */\n  override patch(partial: DeepPartial<S>): void {\n    if (this._disposed) {\n      throw new Error(`Cannot emit state from disposed container ${this.name}`);\n    }\n    const partialKeys = Object.keys(partial as object);\n    if (partialKeys.length === 0) return;\n\n    const prev = this.state;\n\n    // Pre-spread skip: if every top-level key in `partial` is already\n    // `Object.is`-equal to the current state's value at that key, the\n    // merge is a structural no-op — skip entirely. Matches the pre-C0\n    // `Cubit.patch` semantics (per-key Object.is short-circuit). This is\n    // shallow on purpose; deep no-op detection lives in `super.patch`'s\n    // path-diff path which still wakes consumers if anything truly moved.\n    let allEqual = true;\n    for (const key of partialKeys) {\n      if (\n        !Object.is(\n          (prev as Record<string, unknown>)[key],\n          (partial as Record<string, unknown>)[key],\n        )\n      ) {\n        allEqual = false;\n        break;\n      }\n    }\n    if (allEqual) return;\n\n    if (process.env.NODE_ENV !== 'production') {\n      this._checkEmitRate();\n    }\n\n    super.patch(partial);\n\n    const next = this.state;\n    if (Object.is(prev, next)) return;\n\n    if (this._hydrationStatus === 'hydrating') {\n      this._changedWhileHydrating = true;\n    }\n\n    if (this._pendingChange) {\n      this._pendingChange.next = next;\n    } else {\n      this._pendingChange = { prev, next };\n    }\n\n    if (this._registry.hasStateChangedListeners) {\n      this._registry.notifyStateChanged(this, prev, next);\n    }\n  }\n\n  /**\n   * @internal @deprecated Symbol-keyed alias for `emit`. Kept only so legacy\n   * in-package tests that index with `[EMIT]` typecheck/run unchanged. C5\n   * removes this along with the `EMIT` symbol.\n   */\n  protected [EMIT](next: S): void {\n    this.applyState(next, 'default');\n  }\n\n  private applyState(next: S, source: 'default' | 'hydration'): void {\n    if (this._disposed) {\n      throw new Error(`Cannot emit state from disposed container ${this.name}`);\n    }\n\n    const prev = this.state;\n    if (prev === next) return;\n    if (this._equalityFn(prev, next)) return;\n\n    if (process.env.NODE_ENV !== 'production') {\n      this._checkEmitRate();\n    }\n\n    if (this._hydrationStatus === 'hydrating' && source !== 'hydration') {\n      this._changedWhileHydrating = true;\n    }\n\n    // Coalesce: keep the first prev seen this tick, take the latest next.\n    if (this._pendingChange) {\n      this._pendingChange.next = next;\n    } else {\n      this._pendingChange = { prev, next };\n    }\n\n    super.emit(next);\n\n    if (this._registry.hasStateChangedListeners) {\n      this._registry.notifyStateChanged(this, prev, next);\n    }\n  }\n\n  /**\n   * Called by the channel-bridge subscriber on each flush. Drains the\n   * pending change (if any) into legacy listeners and the 'stateChanged'\n   * system event. No pending change == flush from a no-op patch == skip.\n   */\n  private _drainPending(): void {\n    const pending = this._pendingChange;\n    if (!pending) return;\n    this._pendingChange = null;\n\n    // Iterate against a fixed-size snapshot so a listener that subscribes a\n    // new listener mid-drain does not get the late one called in this flush.\n    // (Matches the pre-C0 contract; restored by counting against the size\n    // captured at drain entry.) Order matches pre-C0: 'stateChanged' system\n    // event fires *before* legacy subscribe() listeners.\n    const handlers = this._systemEventHandlers.get('stateChanged');\n    if (handlers && handlers.size > 0) {\n      const payload = { state: pending.next, previousState: pending.prev };\n      let count = 0;\n      const size = handlers.size;\n      for (const handler of handlers) {\n        if (++count > size) break;\n        try {\n          handler(payload);\n        } catch (error) {\n          console.error(`[${this.name}] Error in system event handler:`, error);\n        }\n      }\n    }\n\n    if (this._listeners.size > 0) {\n      const current = this.state;\n      let count = 0;\n      const size = this._listeners.size;\n      for (const listener of this._listeners) {\n        if (++count > size) break;\n        try {\n          listener(current);\n        } catch (error) {\n          console.error(`[${this.name}] Error in listener:`, error);\n        }\n      }\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Hydration\n  // ---------------------------------------------------------------------------\n\n  beginHydration(): void {\n    if (this._disposed) {\n      throw new Error(\n        `Cannot begin hydration for disposed container ${this.name}`,\n      );\n    }\n\n    this._changedWhileHydrating = false;\n    this._hydrationError = undefined;\n    this._hydrationPromise = null;\n    this._resolveHydrationPromise = undefined;\n    this._rejectHydrationPromise = undefined;\n    this._hydrationPromiseSettled = false;\n    void this.ensureHydrationPromise();\n    this.setHydrationStatus('hydrating');\n  }\n\n  applyHydratedState(next: S): boolean {\n    if (this._disposed) {\n      return false;\n    }\n\n    if (this._hydrationStatus !== 'hydrating' || this._changedWhileHydrating) {\n      return false;\n    }\n\n    this.applyState(next, 'hydration');\n    return true;\n  }\n\n  finishHydration(): void {\n    if (this._hydrationStatus !== 'hydrating') {\n      if (this._hydrationStatus === 'hydrated') {\n        return;\n      }\n      if (this._hydrationStatus === 'error') {\n        void this.ensureHydrationPromise();\n      }\n    }\n\n    this.setHydrationStatus('hydrated');\n    this.resolveHydration();\n  }\n\n  failHydration(error: Error): void {\n    const err =\n      error instanceof Error\n        ? error\n        : new Error(`Hydration failed: ${String(error)}`);\n\n    this._hydrationError = err;\n    this.setHydrationStatus('error', err);\n    this.rejectHydration(err);\n  }\n\n  waitForHydration(): Promise<void> {\n    if (\n      this._hydrationStatus === 'idle' ||\n      this._hydrationStatus === 'hydrated'\n    ) {\n      return Promise.resolve();\n    }\n\n    if (this._hydrationStatus === 'error') {\n      return Promise.reject(\n        this._hydrationError ??\n          new Error(`Hydration failed for container ${this.name}`),\n      );\n    }\n\n    return this.ensureHydrationPromise();\n  }\n\n  private setHydrationStatus(status: HydrationStatus, error?: Error): void {\n    const previousStatus = this._hydrationStatus;\n    this._hydrationStatus = status;\n    this._hydrationError = error;\n\n    this.emitSystemEvent('hydrationChanged', {\n      status,\n      previousStatus,\n      error,\n      changedWhileHydrating: this._changedWhileHydrating,\n    });\n  }\n\n  private ensureHydrationPromise(): Promise<void> {\n    if (!this._hydrationPromise || this._hydrationPromiseSettled) {\n      this._hydrationPromiseSettled = false;\n      this._hydrationPromise = new Promise<void>((resolve, reject) => {\n        this._resolveHydrationPromise = () => {\n          if (this._hydrationPromiseSettled) return;\n          this._hydrationPromiseSettled = true;\n          resolve();\n        };\n        this._rejectHydrationPromise = (error: Error) => {\n          if (this._hydrationPromiseSettled) return;\n          this._hydrationPromiseSettled = true;\n          reject(error);\n        };\n      });\n      this._hydrationPromise.catch(() => {});\n    }\n\n    return this._hydrationPromise;\n  }\n\n  private resolveHydration(): void {\n    this._resolveHydrationPromise?.();\n  }\n\n  private rejectHydration(error: Error): void {\n    void this.ensureHydrationPromise();\n    this._rejectHydrationPromise?.(error);\n  }\n\n  // ---------------------------------------------------------------------------\n  // System events\n  // ---------------------------------------------------------------------------\n\n  protected onSystemEvent = <E extends SystemEvent>(\n    event: E,\n    handler: SystemEventHandler<S, E>,\n  ): (() => void) => {\n    let handlers = this._systemEventHandlers.get(event);\n    if (!handlers) {\n      handlers = new Set();\n      this._systemEventHandlers.set(event, handlers);\n    }\n    handlers.add(handler as SystemEventHandler<S, any>);\n\n    return () => {\n      handlers?.delete(handler as SystemEventHandler<S, any>);\n    };\n  };\n\n  private emitSystemEvent<E extends SystemEvent>(\n    event: E,\n    payload: SystemEventPayloads<S>[E],\n  ): void {\n    const handlers = this._systemEventHandlers.get(event);\n    if (!handlers) return;\n\n    for (const handler of handlers) {\n      try {\n        handler(payload);\n      } catch (error) {\n        console.error(`[${this.name}] Error in system event handler:`, error);\n      }\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Emit-rate circuit breaker (dev-only)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Dev-only soft circuit breaker. Counts real state changes in a rolling 1s\n   * window and warns once if the rate exceeds `maxEmitsPerSecond` — the\n   * signature of a runaway loop (RAF/animation or emit-on-every-commit) pushing\n   * high-frequency data through state, which freezes subscribers/plugins.\n   */\n  private _checkEmitRate(): void {\n    const limit = getBlacConfig().maxEmitsPerSecond;\n    if (!(limit > 0) || !Number.isFinite(limit) || this._emitRateWarned) return;\n\n    const now = Date.now();\n    if (now - this._emitWindowStart >= 1000) {\n      this._emitWindowStart = now;\n      this._emitCount = 1;\n      return;\n    }\n\n    this._emitCount++;\n    if (this._emitCount > limit) {\n      this._emitRateWarned = true;\n      console.warn(\n        `[${this.name}] emitted more than ${limit} state changes in under a second. ` +\n          `This is usually a runaway loop pushing high-frequency data through state ` +\n          `(e.g. \\`emit\\`/\\`patch\\` inside a requestAnimationFrame loop, or an effect ` +\n          `that emits on every render). It can freeze the app by saturating ` +\n          `subscribers and plugins (logging/devtools). Keep high-frequency work ` +\n          `imperative and emit only coarse/throttled state, or raise ` +\n          `\\`configureBlac({ maxEmitsPerSecond })\\`. (This warning fires once.)`,\n      );\n    }\n  }\n}\n","import { StateContainer } from './StateContainer';\n\n/**\n * `Cubit<S>` is a `StateContainer<S>` with `emit` / `patch` exposed as\n * public mutation surface. Today it adds nothing structurally beyond\n * `StateContainer` — both are inherited from the underlying\n * `StructuralContainer<S>`. Kept as a real class (not a type alias) because\n * downstream code does `instance instanceof Cubit` checks (see A2 audit).\n *\n * The class body is intentionally empty: a no-op `emit` override would\n * still go through `applyState`, and `patch` is inherited from\n * `StructuralContainer` (path-diffed, microtask-flushed). If a caller\n * needs the old \"skip if no real change\" patch semantics, they can wrap\n * `patch` themselves or call `emit` after a manual equality check.\n */\nexport abstract class Cubit<\n  S extends object = any,\n  Args = void,\n  Deps extends object = Record<string, never>,\n> extends StateContainer<S, Args, Deps> {}\n","import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n} from '../types/utilities';\n\n/**\n * Ensure an instance exists without taking ownership (no ref added). Instance\n * identity is derived purely from `args`, matching `acquire`.\n */\nexport function ensure<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): InstanceType<T> {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.ensure(BlocClass, key, opts?.args);\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -1,42 +1,36 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_StateContainerRegistry = require("./StateContainerRegistry-B4yVMYbx.cjs");
-const require_Cubit = require("./Cubit-CWP8Ddzx.cjs");
-const require_config = require("./config-B_4xXpvK.cjs");
-const require_ensure = require("./ensure-BB6xHQAF.cjs");
-const require_management = require("./management-DTzcC6aD.cjs");
-const require_watch = require("./watch-BpwaUL8r.cjs");
-const require_branded = require("./branded-BSeA_mZO.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-FWKzPfS-.cjs");
+const require_ensure = require("./ensure-CLQEx0Nn.cjs");
+const require_config = require("./config-DVMnlHLv.cjs");
+const require_acquire = require("./acquire-DHEOEVcj.cjs");
+const require_management = require("./management-GcnNJjnm.cjs");
+const require_watch = require("./watch-CKWt788i.cjs");
+const require_branded = require("./branded-BybA0_xw.cjs");
 let _dirtytalk_structural = require("@dirtytalk/structural");
-//#region src/registry/acquire.ts
-function acquire(BlocClass, instanceKey, refId, args) {
-	return require_config.getRegistry().acquire(BlocClass, instanceKey, {
-		canCreate: true,
-		countRef: true,
-		refId,
-		args
-	});
-}
-/**
-* Resolve the storage key an instance would be acquired under, given an
-* (optional) explicit key and construction args. Callers that both acquire and
-* release (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, instanceKey, args) {
-	return require_config.getRegistry().resolveKey(BlocClass, instanceKey, args);
-}
-//#endregion
 //#region src/registry/borrow.ts
-function borrow(BlocClass, instanceKey) {
-	return require_config.getRegistry().borrow(BlocClass, instanceKey);
+function resolveBorrowKey(BlocClass, target) {
+	return require_config.getRegistry().resolveKey(BlocClass, void 0, target?.args);
 }
-function borrowSafe(BlocClass, instanceKey) {
-	return require_config.getRegistry().borrowSafe(BlocClass, instanceKey);
+function borrow(BlocClass, target) {
+	return require_config.getRegistry().borrow(BlocClass, resolveBorrowKey(BlocClass, target));
+}
+function borrowSafe(BlocClass, target) {
+	return require_config.getRegistry().borrowSafe(BlocClass, resolveBorrowKey(BlocClass, target));
 }
 //#endregion
 //#region src/registry/release.ts
-function release(BlocClass, instanceKey, forceDispose = false, refId) {
-	require_config.getRegistry().release(BlocClass, instanceKey, forceDispose, refId);
+/**
+* Release a reference to an instance. Instance identity is derived purely from
+* `args` (must match the `args` it was acquired with).
+*
+* @param opts.args - Construction/identity args; derives the instance key
+* @param opts.refId - The specific ref to drop; drops one arbitrary ref if omitted
+* @param opts.forceDispose - Force immediate disposal regardless of refs
+*/
+function release(BlocClass, opts) {
+	const registry = require_config.getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	registry.release(BlocClass, key, opts?.forceDispose ?? false, opts?.refId);
 }
 //#endregion
 //#region src/decorators/blac.ts
@@ -75,14 +69,14 @@ Object.defineProperty(exports, "ALL_PATHS", {
 		return _dirtytalk_structural.ALL_PATHS;
 	}
 });
-exports.APPLY_DEPS = require_Cubit.APPLY_DEPS;
-exports.Cubit = require_Cubit.Cubit;
-exports.EMIT = require_Cubit.EMIT;
+exports.APPLY_DEPS = require_ensure.APPLY_DEPS;
+exports.Cubit = require_ensure.Cubit;
+exports.EMIT = require_ensure.EMIT;
 exports.PluginManager = require_StateContainerRegistry.PluginManager;
-exports.REMOVE_DEPS_OWNER = require_Cubit.REMOVE_DEPS_OWNER;
-exports.StateContainer = require_Cubit.StateContainer;
+exports.REMOVE_DEPS_OWNER = require_ensure.REMOVE_DEPS_OWNER;
+exports.StateContainer = require_ensure.StateContainer;
 exports.StateContainerRegistry = require_StateContainerRegistry.StateContainerRegistry;
-exports.acquire = acquire;
+exports.acquire = require_acquire.acquire;
 exports.blac = blac;
 exports.borrow = borrow;
 exports.borrowSafe = borrowSafe;
@@ -103,12 +97,11 @@ exports.hasInstance = require_management.hasInstance;
 exports.instance = require_watch.instance;
 exports.instanceId = require_branded.instanceId;
 exports.isExcludedFromDevTools = require_StateContainerRegistry.isExcludedFromDevTools;
-exports.isIsolatedClass = require_StateContainerRegistry.isIsolatedClass;
 exports.isKeepAliveClass = require_StateContainerRegistry.isKeepAliveClass;
 exports.register = require_management.register;
 exports.release = release;
 exports.resetBlacConfig = require_StateContainerRegistry.resetBlacConfig;
-exports.resolveInstanceKey = resolveInstanceKey;
+exports.resolveInstanceKey = require_acquire.resolveInstanceKey;
 exports.setRegistry = require_config.setRegistry;
 exports.shallowEqualState = require_StateContainerRegistry.shallowEqualState;
 exports.watch = require_watch.watch;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["getRegistry","getRegistry","BLAC_STATIC_PROPS"],"sources":["../src/registry/acquire.ts","../src/registry/borrow.ts","../src/registry/release.ts","../src/decorators/blac.ts"],"sourcesContent":["import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n} from '../types/utilities';\n\nexport function acquire<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey?: string,\n  refId?: string,\n  args?: ExtractArgs<T>,\n): InstanceType<T> {\n  return getRegistry().acquire(BlocClass, instanceKey, {\n    canCreate: true,\n    countRef: true,\n    refId,\n    args,\n  });\n}\n\n/**\n * Resolve the storage key an instance would be acquired under, given an\n * (optional) explicit key and construction args. Callers that both acquire and\n * release (e.g. `@blac/react` `useBloc`) must use this once and pass the same\n * resolved key to both, so the ref is dropped under the key it was taken.\n */\nexport function resolveInstanceKey<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey: string | undefined,\n  args?: ExtractArgs<T>,\n): string {\n  return getRegistry().resolveKey(BlocClass, instanceKey, args);\n}\n","import { getRegistry } from './config';\nimport type { StateContainerConstructor } from '../types/utilities';\n\nexport function borrow<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey?: string,\n): InstanceType<T> {\n  return getRegistry().borrow(BlocClass, instanceKey);\n}\n\nexport function borrowSafe<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey?: string,\n):\n  | { error: Error; instance: null }\n  | { error: null; instance: InstanceType<T> } {\n  return getRegistry().borrowSafe(BlocClass, instanceKey);\n}\n","import { getRegistry } from './config';\nimport type { StateContainerConstructor } from '../types/utilities';\n\nexport function release<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey?: string,\n  forceDispose = false,\n  refId?: string,\n): void {\n  getRegistry().release(BlocClass, instanceKey, forceDispose, refId);\n}\n","import { BLAC_STATIC_PROPS } from '../constants';\nimport type { EqualityFn } from '../config';\n\n/**\n * Configuration options for the @blac decorator.\n * Only one option can be specified at a time (union type).\n */\nexport type BlacOptions =\n  /** Mark bloc to never be auto-disposed when ref count reaches 0 */\n  | { keepAlive: true }\n  /** Exclude bloc from DevTools tracking (prevents infinite loops) */\n  | { excludeFromDevTools: true }\n  /**\n   * Override the global equality check for this bloc.\n   * Return `true` to skip the emit (states considered equal).\n   */\n  | { equality: EqualityFn }\n  /**\n   * Override the default structural-hash identity key.\n   * The function receives `args` and returns the instance key string.\n   * Distinct return values → distinct instances; identical values → shared instance.\n   * Non-identity fields can be excluded so they don't fork new instances.\n   */\n  | { key: (args: any) => string };\n\n/**\n * Decorator to configure StateContainer classes.\n *\n * @example Decorator syntax (requires experimentalDecorators or TC39 decorators)\n * ```ts\n * @blac({ keepAlive: true })\n * class AuthBloc extends Cubit<AuthState> {}\n *\n * @blac({ excludeFromDevTools: true })\n * class InternalBloc extends Cubit<InternalState> {}\n * ```\n *\n * @example Function syntax (no decorator support needed)\n * ```ts\n * const AuthBloc = blac({ keepAlive: true })(\n *   class extends Cubit<AuthState> {}\n * );\n * ```\n */\nexport function blac(options: BlacOptions) {\n  return function <T extends new (...args: any[]) => any>(\n    target: T,\n    _context?: ClassDecoratorContext,\n  ): T {\n    if ('keepAlive' in options && options.keepAlive) {\n      (target as any)[BLAC_STATIC_PROPS.KEEP_ALIVE] = true;\n    }\n    if ('excludeFromDevTools' in options && options.excludeFromDevTools) {\n      (target as any)[BLAC_STATIC_PROPS.EXCLUDE_FROM_DEVTOOLS] = true;\n    }\n    if ('equality' in options && typeof options.equality === 'function') {\n      (target as any)[BLAC_STATIC_PROPS.EQUALITY] = options.equality;\n    }\n    if ('key' in options && typeof options.key === 'function') {\n      (target as any)[BLAC_STATIC_PROPS.KEY] = options.key;\n    }\n    return target;\n  };\n}\n"],"mappings":";;;;;;;;;;AAMA,SAAgB,QACd,WACA,aACA,OACA,MACiB;CACjB,OAAOA,eAAAA,aAAa,CAAC,QAAQ,WAAW,aAAa;EACnD,WAAW;EACX,UAAU;EACV;EACA;EACD,CAAC;;;;;;;;AASJ,SAAgB,mBACd,WACA,aACA,MACQ;CACR,OAAOA,eAAAA,aAAa,CAAC,WAAW,WAAW,aAAa,KAAK;;;;AC5B/D,SAAgB,OACd,WACA,aACiB;CACjB,OAAOC,eAAAA,aAAa,CAAC,OAAO,WAAW,YAAY;;AAGrD,SAAgB,WACd,WACA,aAG6C;CAC7C,OAAOA,eAAAA,aAAa,CAAC,WAAW,WAAW,YAAY;;;;ACbzD,SAAgB,QACd,WACA,aACA,eAAe,OACf,OACM;CACN,eAAA,aAAa,CAAC,QAAQ,WAAW,aAAa,cAAc,MAAM;;;;;;;;;;;;;;;;;;;;;;;ACmCpE,SAAgB,KAAK,SAAsB;CACzC,OAAO,SACL,QACA,UACG;EACH,IAAI,eAAe,WAAW,QAAQ,WACpC,OAAgBC,+BAAAA,kBAAkB,cAAc;EAElD,IAAI,yBAAyB,WAAW,QAAQ,qBAC9C,OAAgBA,+BAAAA,kBAAkB,yBAAyB;EAE7D,IAAI,cAAc,WAAW,OAAO,QAAQ,aAAa,YACvD,OAAgBA,+BAAAA,kBAAkB,YAAY,QAAQ;EAExD,IAAI,SAAS,WAAW,OAAO,QAAQ,QAAQ,YAC7C,OAAgBA,+BAAAA,kBAAkB,OAAO,QAAQ;EAEnD,OAAO"}
+{"version":3,"file":"index.cjs","names":["getRegistry","getRegistry","BLAC_STATIC_PROPS"],"sources":["../src/registry/borrow.ts","../src/registry/release.ts","../src/decorators/blac.ts"],"sourcesContent":["import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n} from '../types/utilities';\n\n/**\n * How to identify the instance to borrow: the same `args` shape `useBloc`\n * accepts, resolved through the class's `static key(args)` so call sites use\n * the *same* shape they pass to `useBloc` instead of hand-deriving the key.\n *\n * `borrowSafe(ChannelBloc, { args: { channelId } })` and\n * `useBloc(ChannelBloc, { args: { channelId } })` therefore always agree.\n */\nexport type BorrowTarget<T extends StateContainerConstructor> = {\n  args?: ExtractArgs<T>;\n};\n\nfunction resolveBorrowKey<T extends StateContainerConstructor>(\n  BlocClass: T,\n  target: BorrowTarget<T> | undefined,\n): string {\n  return getRegistry().resolveKey(BlocClass, undefined, target?.args);\n}\n\nexport function borrow<T extends StateContainerConstructor>(\n  BlocClass: T,\n  target?: BorrowTarget<T>,\n): InstanceType<T> {\n  return getRegistry().borrow(BlocClass, resolveBorrowKey(BlocClass, target));\n}\n\nexport function borrowSafe<T extends StateContainerConstructor>(\n  BlocClass: T,\n  target?: BorrowTarget<T>,\n):\n  | { error: Error; instance: null }\n  | { error: null; instance: InstanceType<T> } {\n  return getRegistry().borrowSafe(\n    BlocClass,\n    resolveBorrowKey(BlocClass, target),\n  );\n}\n","import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n} from '../types/utilities';\n\n/**\n * Release a reference to an instance. Instance identity is derived purely from\n * `args` (must match the `args` it was acquired with).\n *\n * @param opts.args - Construction/identity args; derives the instance key\n * @param opts.refId - The specific ref to drop; drops one arbitrary ref if omitted\n * @param opts.forceDispose - Force immediate disposal regardless of refs\n */\nexport function release<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T>; refId?: string; forceDispose?: boolean },\n): void {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  registry.release(BlocClass, key, opts?.forceDispose ?? false, opts?.refId);\n}\n","import { BLAC_STATIC_PROPS } from '../constants';\nimport type { EqualityFn } from '../config';\n\n/**\n * Configuration options for the @blac decorator.\n * Only one option can be specified at a time (union type).\n */\nexport type BlacOptions =\n  /** Mark bloc to never be auto-disposed when ref count reaches 0 */\n  | { keepAlive: true }\n  /** Exclude bloc from DevTools tracking (prevents infinite loops) */\n  | { excludeFromDevTools: true }\n  /**\n   * Override the global equality check for this bloc.\n   * Return `true` to skip the emit (states considered equal).\n   */\n  | { equality: EqualityFn }\n  /**\n   * Override the default structural-hash identity key.\n   * The function receives `args` and returns the instance key string.\n   * Distinct return values → distinct instances; identical values → shared instance.\n   * Non-identity fields can be excluded so they don't fork new instances.\n   */\n  | { key: (args: any) => string };\n\n/**\n * Decorator to configure StateContainer classes.\n *\n * @example Decorator syntax (requires experimentalDecorators or TC39 decorators)\n * ```ts\n * @blac({ keepAlive: true })\n * class AuthBloc extends Cubit<AuthState> {}\n *\n * @blac({ excludeFromDevTools: true })\n * class InternalBloc extends Cubit<InternalState> {}\n * ```\n *\n * @example Function syntax (no decorator support needed)\n * ```ts\n * const AuthBloc = blac({ keepAlive: true })(\n *   class extends Cubit<AuthState> {}\n * );\n * ```\n */\nexport function blac(options: BlacOptions) {\n  return function <T extends new (...args: any[]) => any>(\n    target: T,\n    _context?: ClassDecoratorContext,\n  ): T {\n    if ('keepAlive' in options && options.keepAlive) {\n      (target as any)[BLAC_STATIC_PROPS.KEEP_ALIVE] = true;\n    }\n    if ('excludeFromDevTools' in options && options.excludeFromDevTools) {\n      (target as any)[BLAC_STATIC_PROPS.EXCLUDE_FROM_DEVTOOLS] = true;\n    }\n    if ('equality' in options && typeof options.equality === 'function') {\n      (target as any)[BLAC_STATIC_PROPS.EQUALITY] = options.equality;\n    }\n    if ('key' in options && typeof options.key === 'function') {\n      (target as any)[BLAC_STATIC_PROPS.KEY] = options.key;\n    }\n    return target;\n  };\n}\n"],"mappings":";;;;;;;;;;AAkBA,SAAS,iBACP,WACA,QACQ;CACR,OAAOA,eAAAA,YAAY,EAAE,WAAW,WAAW,KAAA,GAAW,QAAQ,IAAI;AACpE;AAEA,SAAgB,OACd,WACA,QACiB;CACjB,OAAOA,eAAAA,YAAY,EAAE,OAAO,WAAW,iBAAiB,WAAW,MAAM,CAAC;AAC5E;AAEA,SAAgB,WACd,WACA,QAG6C;CAC7C,OAAOA,eAAAA,YAAY,EAAE,WACnB,WACA,iBAAiB,WAAW,MAAM,CACpC;AACF;;;;;;;;;;;AC5BA,SAAgB,QACd,WACA,MACM;CACN,MAAM,WAAWC,eAAAA,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,SAAS,QAAQ,WAAW,KAAK,MAAM,gBAAgB,OAAO,MAAM,KAAK;AAC3E;;;;;;;;;;;;;;;;;;;;;;ACuBA,SAAgB,KAAK,SAAsB;CACzC,OAAO,SACL,QACA,UACG;EACH,IAAI,eAAe,WAAW,QAAQ,WACpC,OAAgBC,+BAAAA,kBAAkB,cAAc;EAElD,IAAI,yBAAyB,WAAW,QAAQ,qBAC9C,OAAgBA,+BAAAA,kBAAkB,yBAAyB;EAE7D,IAAI,cAAc,WAAW,OAAO,QAAQ,aAAa,YACvD,OAAgBA,+BAAAA,kBAAkB,YAAY,QAAQ;EAExD,IAAI,SAAS,WAAW,OAAO,QAAQ,QAAQ,YAC7C,OAAgBA,+BAAAA,kBAAkB,OAAO,QAAQ;EAEnD,OAAO;CACT;AACF"}

package/dist/index.d.cts

@@ -14,10 +14,11 @@ export { EMIT, APPLY_DEPS, REMOVE_DEPS_OWNER } from './core/symbols';
 export { ALL_PATHS } from '@dirtytalk/structural';
 export type { PathSet } from '@dirtytalk/structural';
 export { acquire, resolveInstanceKey, borrow, borrowSafe, ensure, release, clear, clearAll, register, hasInstance, getRefCount, getRefIds, getAll, forEach, getRegistry, setRegistry, getStats, } from './registry';
+export type { BorrowTarget } from './registry';
 export { globalRegistry, StateContainerRegistry, } from './core/StateContainerRegistry';
 export type { LifecycleEvent, LifecycleListener, InstanceEntry, } from './core/StateContainerRegistry';
 export { blac, type BlacOptions } from './decorators';
-export { isKeepAliveClass, isExcludedFromDevTools, isIsolatedClass, } from './utils/static-props';
+export { isKeepAliveClass, isExcludedFromDevTools } from './utils/static-props';
 export { getPluginManager } from './core/StateContainerRegistry';
 export type { BlacPlugin, BlacPluginWithInit, PluginContext, PluginConfig, InstanceMetadata, } from './plugin/BlacPlugin';
 export { PluginManager } from './plugin/PluginManager';

package/dist/index.d.ts

@@ -14,10 +14,11 @@ export { EMIT, APPLY_DEPS, REMOVE_DEPS_OWNER } from './core/symbols';
 export { ALL_PATHS } from '@dirtytalk/structural';
 export type { PathSet } from '@dirtytalk/structural';
 export { acquire, resolveInstanceKey, borrow, borrowSafe, ensure, release, clear, clearAll, register, hasInstance, getRefCount, getRefIds, getAll, forEach, getRegistry, setRegistry, getStats, } from './registry';
+export type { BorrowTarget } from './registry';
 export { globalRegistry, StateContainerRegistry, } from './core/StateContainerRegistry';
 export type { LifecycleEvent, LifecycleListener, InstanceEntry, } from './core/StateContainerRegistry';
 export { blac, type BlacOptions } from './decorators';
-export { isKeepAliveClass, isExcludedFromDevTools, isIsolatedClass, } from './utils/static-props';
+export { isKeepAliveClass, isExcludedFromDevTools } from './utils/static-props';
 export { getPluginManager } from './core/StateContainerRegistry';
 export type { BlacPlugin, BlacPluginWithInit, PluginContext, PluginConfig, InstanceMetadata, } from './plugin/BlacPlugin';
 export { PluginManager } from './plugin/PluginManager';

package/dist/index.js

@@ -1,41 +1,35 @@
-import { a as isExcludedFromDevTools, c as PluginManager, d as configureBlac, f as getBlacConfig, m as shallowEqualState, n as getPluginManager, o as isIsolatedClass, p as resetBlacConfig, r as globalRegistry, s as isKeepAliveClass, t as StateContainerRegistry, u as BLAC_STATIC_PROPS } from "./StateContainerRegistry-DmmzYa7S.js";
-import { a as REMOVE_DEPS_OWNER, i as EMIT, n as StateContainer, r as APPLY_DEPS, t as Cubit } from "./Cubit-VJuu2tt9.js";
-import { n as getStats, r as setRegistry, t as getRegistry } from "./config-DoHx0Xsl.js";
-import { t as ensure } from "./ensure-mkL-3qh8.js";
-import { a as getAll, c as hasInstance, i as forEach, n as clearAll, o as getRefCount, r as register, s as getRefIds, t as clear } from "./management-H4m3ciJO.js";
-import { n as watch, t as instance } from "./watch-DWCqXllW.js";
-import { t as instanceId } from "./branded-DwtzSsg0.js";
+import { a as isExcludedFromDevTools, c as PluginManager, d as resetBlacConfig, f as shallowEqualState, l as configureBlac, n as getPluginManager, o as isKeepAliveClass, r as globalRegistry, s as BLAC_STATIC_PROPS, t as StateContainerRegistry, u as getBlacConfig } from "./StateContainerRegistry-B_ViBLvJ.js";
+import { a as EMIT, i as APPLY_DEPS, n as Cubit, o as REMOVE_DEPS_OWNER, r as StateContainer, t as ensure } from "./ensure-CPMiGvov.js";
+import { n as getStats, r as setRegistry, t as getRegistry } from "./config-8pyOC5gv.js";
+import { n as resolveInstanceKey, t as acquire } from "./acquire-Don7499S.js";
+import { a as getAll, c as hasInstance, i as forEach, n as clearAll, o as getRefCount, r as register, s as getRefIds, t as clear } from "./management-7jLjVHJd.js";
+import { n as watch, t as instance } from "./watch-BmC-Tyqg.js";
+import { t as instanceId } from "./branded-DkbUzncc.js";
 import { ALL_PATHS } from "@dirtytalk/structural";
-//#region src/registry/acquire.ts
-function acquire(BlocClass, instanceKey, refId, args) {
-	return getRegistry().acquire(BlocClass, instanceKey, {
-		canCreate: true,
-		countRef: true,
-		refId,
-		args
-	});
-}
-/**
-* Resolve the storage key an instance would be acquired under, given an
-* (optional) explicit key and construction args. Callers that both acquire and
-* release (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, instanceKey, args) {
-	return getRegistry().resolveKey(BlocClass, instanceKey, args);
-}
-//#endregion
 //#region src/registry/borrow.ts
-function borrow(BlocClass, instanceKey) {
-	return getRegistry().borrow(BlocClass, instanceKey);
+function resolveBorrowKey(BlocClass, target) {
+	return getRegistry().resolveKey(BlocClass, void 0, target?.args);
 }
-function borrowSafe(BlocClass, instanceKey) {
-	return getRegistry().borrowSafe(BlocClass, instanceKey);
+function borrow(BlocClass, target) {
+	return getRegistry().borrow(BlocClass, resolveBorrowKey(BlocClass, target));
+}
+function borrowSafe(BlocClass, target) {
+	return getRegistry().borrowSafe(BlocClass, resolveBorrowKey(BlocClass, target));
 }
 //#endregion
 //#region src/registry/release.ts
-function release(BlocClass, instanceKey, forceDispose = false, refId) {
-	getRegistry().release(BlocClass, instanceKey, forceDispose, refId);
+/**
+* Release a reference to an instance. Instance identity is derived purely from
+* `args` (must match the `args` it was acquired with).
+*
+* @param opts.args - Construction/identity args; derives the instance key
+* @param opts.refId - The specific ref to drop; drops one arbitrary ref if omitted
+* @param opts.forceDispose - Force immediate disposal regardless of refs
+*/
+function release(BlocClass, opts) {
+	const registry = getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	registry.release(BlocClass, key, opts?.forceDispose ?? false, opts?.refId);
 }
 //#endregion
 //#region src/decorators/blac.ts
@@ -68,6 +62,6 @@ function blac(options) {
 	};
 }
 //#endregion
-export { ALL_PATHS, APPLY_DEPS, Cubit, EMIT, PluginManager, REMOVE_DEPS_OWNER, StateContainer, StateContainerRegistry, acquire, blac, borrow, borrowSafe, clear, clearAll, configureBlac, ensure, forEach, getAll, getBlacConfig, getPluginManager, getRefCount, getRefIds, getRegistry, getStats, globalRegistry, hasInstance, instance, instanceId, isExcludedFromDevTools, isIsolatedClass, isKeepAliveClass, register, release, resetBlacConfig, resolveInstanceKey, setRegistry, shallowEqualState, watch };
+export { ALL_PATHS, APPLY_DEPS, Cubit, EMIT, PluginManager, REMOVE_DEPS_OWNER, StateContainer, StateContainerRegistry, acquire, blac, borrow, borrowSafe, clear, clearAll, configureBlac, ensure, forEach, getAll, getBlacConfig, getPluginManager, getRefCount, getRefIds, getRegistry, getStats, globalRegistry, hasInstance, instance, instanceId, isExcludedFromDevTools, isKeepAliveClass, register, release, resetBlacConfig, resolveInstanceKey, setRegistry, shallowEqualState, watch };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/registry/acquire.ts","../src/registry/borrow.ts","../src/registry/release.ts","../src/decorators/blac.ts"],"sourcesContent":["import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n} from '../types/utilities';\n\nexport function acquire<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey?: string,\n  refId?: string,\n  args?: ExtractArgs<T>,\n): InstanceType<T> {\n  return getRegistry().acquire(BlocClass, instanceKey, {\n    canCreate: true,\n    countRef: true,\n    refId,\n    args,\n  });\n}\n\n/**\n * Resolve the storage key an instance would be acquired under, given an\n * (optional) explicit key and construction args. Callers that both acquire and\n * release (e.g. `@blac/react` `useBloc`) must use this once and pass the same\n * resolved key to both, so the ref is dropped under the key it was taken.\n */\nexport function resolveInstanceKey<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey: string | undefined,\n  args?: ExtractArgs<T>,\n): string {\n  return getRegistry().resolveKey(BlocClass, instanceKey, args);\n}\n","import { getRegistry } from './config';\nimport type { StateContainerConstructor } from '../types/utilities';\n\nexport function borrow<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey?: string,\n): InstanceType<T> {\n  return getRegistry().borrow(BlocClass, instanceKey);\n}\n\nexport function borrowSafe<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey?: string,\n):\n  | { error: Error; instance: null }\n  | { error: null; instance: InstanceType<T> } {\n  return getRegistry().borrowSafe(BlocClass, instanceKey);\n}\n","import { getRegistry } from './config';\nimport type { StateContainerConstructor } from '../types/utilities';\n\nexport function release<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey?: string,\n  forceDispose = false,\n  refId?: string,\n): void {\n  getRegistry().release(BlocClass, instanceKey, forceDispose, refId);\n}\n","import { BLAC_STATIC_PROPS } from '../constants';\nimport type { EqualityFn } from '../config';\n\n/**\n * Configuration options for the @blac decorator.\n * Only one option can be specified at a time (union type).\n */\nexport type BlacOptions =\n  /** Mark bloc to never be auto-disposed when ref count reaches 0 */\n  | { keepAlive: true }\n  /** Exclude bloc from DevTools tracking (prevents infinite loops) */\n  | { excludeFromDevTools: true }\n  /**\n   * Override the global equality check for this bloc.\n   * Return `true` to skip the emit (states considered equal).\n   */\n  | { equality: EqualityFn }\n  /**\n   * Override the default structural-hash identity key.\n   * The function receives `args` and returns the instance key string.\n   * Distinct return values → distinct instances; identical values → shared instance.\n   * Non-identity fields can be excluded so they don't fork new instances.\n   */\n  | { key: (args: any) => string };\n\n/**\n * Decorator to configure StateContainer classes.\n *\n * @example Decorator syntax (requires experimentalDecorators or TC39 decorators)\n * ```ts\n * @blac({ keepAlive: true })\n * class AuthBloc extends Cubit<AuthState> {}\n *\n * @blac({ excludeFromDevTools: true })\n * class InternalBloc extends Cubit<InternalState> {}\n * ```\n *\n * @example Function syntax (no decorator support needed)\n * ```ts\n * const AuthBloc = blac({ keepAlive: true })(\n *   class extends Cubit<AuthState> {}\n * );\n * ```\n */\nexport function blac(options: BlacOptions) {\n  return function <T extends new (...args: any[]) => any>(\n    target: T,\n    _context?: ClassDecoratorContext,\n  ): T {\n    if ('keepAlive' in options && options.keepAlive) {\n      (target as any)[BLAC_STATIC_PROPS.KEEP_ALIVE] = true;\n    }\n    if ('excludeFromDevTools' in options && options.excludeFromDevTools) {\n      (target as any)[BLAC_STATIC_PROPS.EXCLUDE_FROM_DEVTOOLS] = true;\n    }\n    if ('equality' in options && typeof options.equality === 'function') {\n      (target as any)[BLAC_STATIC_PROPS.EQUALITY] = options.equality;\n    }\n    if ('key' in options && typeof options.key === 'function') {\n      (target as any)[BLAC_STATIC_PROPS.KEY] = options.key;\n    }\n    return target;\n  };\n}\n"],"mappings":";;;;;;;;;AAMA,SAAgB,QACd,WACA,aACA,OACA,MACiB;CACjB,OAAO,aAAa,CAAC,QAAQ,WAAW,aAAa;EACnD,WAAW;EACX,UAAU;EACV;EACA;EACD,CAAC;;;;;;;;AASJ,SAAgB,mBACd,WACA,aACA,MACQ;CACR,OAAO,aAAa,CAAC,WAAW,WAAW,aAAa,KAAK;;;;AC5B/D,SAAgB,OACd,WACA,aACiB;CACjB,OAAO,aAAa,CAAC,OAAO,WAAW,YAAY;;AAGrD,SAAgB,WACd,WACA,aAG6C;CAC7C,OAAO,aAAa,CAAC,WAAW,WAAW,YAAY;;;;ACbzD,SAAgB,QACd,WACA,aACA,eAAe,OACf,OACM;CACN,aAAa,CAAC,QAAQ,WAAW,aAAa,cAAc,MAAM;;;;;;;;;;;;;;;;;;;;;;;ACmCpE,SAAgB,KAAK,SAAsB;CACzC,OAAO,SACL,QACA,UACG;EACH,IAAI,eAAe,WAAW,QAAQ,WACpC,OAAgB,kBAAkB,cAAc;EAElD,IAAI,yBAAyB,WAAW,QAAQ,qBAC9C,OAAgB,kBAAkB,yBAAyB;EAE7D,IAAI,cAAc,WAAW,OAAO,QAAQ,aAAa,YACvD,OAAgB,kBAAkB,YAAY,QAAQ;EAExD,IAAI,SAAS,WAAW,OAAO,QAAQ,QAAQ,YAC7C,OAAgB,kBAAkB,OAAO,QAAQ;EAEnD,OAAO"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/registry/borrow.ts","../src/registry/release.ts","../src/decorators/blac.ts"],"sourcesContent":["import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n} from '../types/utilities';\n\n/**\n * How to identify the instance to borrow: the same `args` shape `useBloc`\n * accepts, resolved through the class's `static key(args)` so call sites use\n * the *same* shape they pass to `useBloc` instead of hand-deriving the key.\n *\n * `borrowSafe(ChannelBloc, { args: { channelId } })` and\n * `useBloc(ChannelBloc, { args: { channelId } })` therefore always agree.\n */\nexport type BorrowTarget<T extends StateContainerConstructor> = {\n  args?: ExtractArgs<T>;\n};\n\nfunction resolveBorrowKey<T extends StateContainerConstructor>(\n  BlocClass: T,\n  target: BorrowTarget<T> | undefined,\n): string {\n  return getRegistry().resolveKey(BlocClass, undefined, target?.args);\n}\n\nexport function borrow<T extends StateContainerConstructor>(\n  BlocClass: T,\n  target?: BorrowTarget<T>,\n): InstanceType<T> {\n  return getRegistry().borrow(BlocClass, resolveBorrowKey(BlocClass, target));\n}\n\nexport function borrowSafe<T extends StateContainerConstructor>(\n  BlocClass: T,\n  target?: BorrowTarget<T>,\n):\n  | { error: Error; instance: null }\n  | { error: null; instance: InstanceType<T> } {\n  return getRegistry().borrowSafe(\n    BlocClass,\n    resolveBorrowKey(BlocClass, target),\n  );\n}\n","import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n} from '../types/utilities';\n\n/**\n * Release a reference to an instance. Instance identity is derived purely from\n * `args` (must match the `args` it was acquired with).\n *\n * @param opts.args - Construction/identity args; derives the instance key\n * @param opts.refId - The specific ref to drop; drops one arbitrary ref if omitted\n * @param opts.forceDispose - Force immediate disposal regardless of refs\n */\nexport function release<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T>; refId?: string; forceDispose?: boolean },\n): void {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  registry.release(BlocClass, key, opts?.forceDispose ?? false, opts?.refId);\n}\n","import { BLAC_STATIC_PROPS } from '../constants';\nimport type { EqualityFn } from '../config';\n\n/**\n * Configuration options for the @blac decorator.\n * Only one option can be specified at a time (union type).\n */\nexport type BlacOptions =\n  /** Mark bloc to never be auto-disposed when ref count reaches 0 */\n  | { keepAlive: true }\n  /** Exclude bloc from DevTools tracking (prevents infinite loops) */\n  | { excludeFromDevTools: true }\n  /**\n   * Override the global equality check for this bloc.\n   * Return `true` to skip the emit (states considered equal).\n   */\n  | { equality: EqualityFn }\n  /**\n   * Override the default structural-hash identity key.\n   * The function receives `args` and returns the instance key string.\n   * Distinct return values → distinct instances; identical values → shared instance.\n   * Non-identity fields can be excluded so they don't fork new instances.\n   */\n  | { key: (args: any) => string };\n\n/**\n * Decorator to configure StateContainer classes.\n *\n * @example Decorator syntax (requires experimentalDecorators or TC39 decorators)\n * ```ts\n * @blac({ keepAlive: true })\n * class AuthBloc extends Cubit<AuthState> {}\n *\n * @blac({ excludeFromDevTools: true })\n * class InternalBloc extends Cubit<InternalState> {}\n * ```\n *\n * @example Function syntax (no decorator support needed)\n * ```ts\n * const AuthBloc = blac({ keepAlive: true })(\n *   class extends Cubit<AuthState> {}\n * );\n * ```\n */\nexport function blac(options: BlacOptions) {\n  return function <T extends new (...args: any[]) => any>(\n    target: T,\n    _context?: ClassDecoratorContext,\n  ): T {\n    if ('keepAlive' in options && options.keepAlive) {\n      (target as any)[BLAC_STATIC_PROPS.KEEP_ALIVE] = true;\n    }\n    if ('excludeFromDevTools' in options && options.excludeFromDevTools) {\n      (target as any)[BLAC_STATIC_PROPS.EXCLUDE_FROM_DEVTOOLS] = true;\n    }\n    if ('equality' in options && typeof options.equality === 'function') {\n      (target as any)[BLAC_STATIC_PROPS.EQUALITY] = options.equality;\n    }\n    if ('key' in options && typeof options.key === 'function') {\n      (target as any)[BLAC_STATIC_PROPS.KEY] = options.key;\n    }\n    return target;\n  };\n}\n"],"mappings":";;;;;;;;;AAkBA,SAAS,iBACP,WACA,QACQ;CACR,OAAO,YAAY,EAAE,WAAW,WAAW,KAAA,GAAW,QAAQ,IAAI;AACpE;AAEA,SAAgB,OACd,WACA,QACiB;CACjB,OAAO,YAAY,EAAE,OAAO,WAAW,iBAAiB,WAAW,MAAM,CAAC;AAC5E;AAEA,SAAgB,WACd,WACA,QAG6C;CAC7C,OAAO,YAAY,EAAE,WACnB,WACA,iBAAiB,WAAW,MAAM,CACpC;AACF;;;;;;;;;;;AC5BA,SAAgB,QACd,WACA,MACM;CACN,MAAM,WAAW,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,SAAS,QAAQ,WAAW,KAAK,MAAM,gBAAgB,OAAO,MAAM,KAAK;AAC3E;;;;;;;;;;;;;;;;;;;;;;ACuBA,SAAgB,KAAK,SAAsB;CACzC,OAAO,SACL,QACA,UACG;EACH,IAAI,eAAe,WAAW,QAAQ,WACpC,OAAgB,kBAAkB,cAAc;EAElD,IAAI,yBAAyB,WAAW,QAAQ,qBAC9C,OAAgB,kBAAkB,yBAAyB;EAE7D,IAAI,cAAc,WAAW,OAAO,QAAQ,aAAa,YACvD,OAAgB,kBAAkB,YAAY,QAAQ;EAExD,IAAI,SAAS,WAAW,OAAO,QAAQ,QAAQ,YAC7C,OAAgB,kBAAkB,OAAO,QAAQ;EAEnD,OAAO;CACT;AACF"}

package/dist/management-7jLjVHJd.js

@@ -0,0 +1,38 @@
+import { t as getRegistry } from "./config-8pyOC5gv.js";
+//#region src/registry/queries.ts
+function hasInstance(BlocClass, opts) {
+	const registry = getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.hasInstance(BlocClass, key);
+}
+function getRefCount(BlocClass, opts) {
+	const registry = getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.getRefCount(BlocClass, key);
+}
+function getRefIds(BlocClass, opts) {
+	const registry = getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.getRefIds(BlocClass, key);
+}
+function getAll(BlocClass) {
+	return getRegistry().getAll(BlocClass);
+}
+function forEach(BlocClass, callback) {
+	getRegistry().forEach(BlocClass, callback);
+}
+//#endregion
+//#region src/registry/management.ts
+function clear(BlocClass) {
+	getRegistry().clear(BlocClass);
+}
+function clearAll() {
+	getRegistry().clearAll();
+}
+function register(BlocClass) {
+	getRegistry().register(BlocClass);
+}
+//#endregion
+export { getAll as a, hasInstance as c, forEach as i, clearAll as n, getRefCount as o, register as r, getRefIds as s, clear as t };
+
+//# sourceMappingURL=management-7jLjVHJd.js.map

package/dist/management-7jLjVHJd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-7jLjVHJd.js","names":[],"sources":["../src/registry/queries.ts","../src/registry/management.ts"],"sourcesContent":["import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n  InstanceReadonlyState,\n} from '../types/utilities';\n\nexport function hasInstance<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): boolean {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.hasInstance(BlocClass, key);\n}\n\nexport function getRefCount<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): number {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.getRefCount(BlocClass, key);\n}\n\nexport function getRefIds<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): string[] {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.getRefIds(BlocClass, key);\n}\n\nexport function getAll<T extends StateContainerConstructor>(\n  BlocClass: T,\n): InstanceReadonlyState<T>[] {\n  return getRegistry().getAll(BlocClass);\n}\n\nexport function forEach<T extends StateContainerConstructor>(\n  BlocClass: T,\n  callback: (instance: InstanceReadonlyState<T>) => void,\n): void {\n  getRegistry().forEach(BlocClass, callback);\n}\n","import { getRegistry } from './config';\nimport type { StateContainerConstructor } from '../types/utilities';\n\nexport function clear<T extends StateContainerConstructor>(BlocClass: T): void {\n  getRegistry().clear(BlocClass);\n}\n\nexport function clearAll(): void {\n  getRegistry().clearAll();\n}\n\nexport function register<T extends StateContainerConstructor>(\n  BlocClass: T,\n): void {\n  getRegistry().register(BlocClass);\n}\n"],"mappings":";;AAOA,SAAgB,YACd,WACA,MACS;CACT,MAAM,WAAW,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,YAAY,WAAW,GAAG;AAC5C;AAEA,SAAgB,YACd,WACA,MACQ;CACR,MAAM,WAAW,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,YAAY,WAAW,GAAG;AAC5C;AAEA,SAAgB,UACd,WACA,MACU;CACV,MAAM,WAAW,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,UAAU,WAAW,GAAG;AAC1C;AAEA,SAAgB,OACd,WAC4B;CAC5B,OAAO,YAAY,EAAE,OAAO,SAAS;AACvC;AAEA,SAAgB,QACd,WACA,UACM;CACN,YAAY,EAAE,QAAQ,WAAW,QAAQ;AAC3C;;;AC1CA,SAAgB,MAA2C,WAAoB;CAC7E,YAAY,EAAE,MAAM,SAAS;AAC/B;AAEA,SAAgB,WAAiB;CAC/B,YAAY,EAAE,SAAS;AACzB;AAEA,SAAgB,SACd,WACM;CACN,YAAY,EAAE,SAAS,SAAS;AAClC"}

package/dist/{management-DTzcC6aD.cjs → management-GcnNJjnm.cjs}

@@ -1,13 +1,19 @@
-const require_config = require("./config-B_4xXpvK.cjs");
+const require_config = require("./config-DVMnlHLv.cjs");
 //#region src/registry/queries.ts
-function hasInstance(BlocClass, instanceKey) {
-	return require_config.getRegistry().hasInstance(BlocClass, instanceKey);
+function hasInstance(BlocClass, opts) {
+	const registry = require_config.getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.hasInstance(BlocClass, key);
 }
-function getRefCount(BlocClass, instanceKey) {
-	return require_config.getRegistry().getRefCount(BlocClass, instanceKey);
+function getRefCount(BlocClass, opts) {
+	const registry = require_config.getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.getRefCount(BlocClass, key);
 }
-function getRefIds(BlocClass, instanceKey) {
-	return require_config.getRegistry().getRefIds(BlocClass, instanceKey);
+function getRefIds(BlocClass, opts) {
+	const registry = require_config.getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.getRefIds(BlocClass, key);
 }
 function getAll(BlocClass) {
 	return require_config.getRegistry().getAll(BlocClass);
@@ -76,4 +82,4 @@ Object.defineProperty(exports, "register", {
 	}
 });
 
-//# sourceMappingURL=management-DTzcC6aD.cjs.map
+//# sourceMappingURL=management-GcnNJjnm.cjs.map

package/dist/management-GcnNJjnm.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-GcnNJjnm.cjs","names":["getRegistry"],"sources":["../src/registry/queries.ts","../src/registry/management.ts"],"sourcesContent":["import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n  InstanceReadonlyState,\n} from '../types/utilities';\n\nexport function hasInstance<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): boolean {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.hasInstance(BlocClass, key);\n}\n\nexport function getRefCount<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): number {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.getRefCount(BlocClass, key);\n}\n\nexport function getRefIds<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): string[] {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.getRefIds(BlocClass, key);\n}\n\nexport function getAll<T extends StateContainerConstructor>(\n  BlocClass: T,\n): InstanceReadonlyState<T>[] {\n  return getRegistry().getAll(BlocClass);\n}\n\nexport function forEach<T extends StateContainerConstructor>(\n  BlocClass: T,\n  callback: (instance: InstanceReadonlyState<T>) => void,\n): void {\n  getRegistry().forEach(BlocClass, callback);\n}\n","import { getRegistry } from './config';\nimport type { StateContainerConstructor } from '../types/utilities';\n\nexport function clear<T extends StateContainerConstructor>(BlocClass: T): void {\n  getRegistry().clear(BlocClass);\n}\n\nexport function clearAll(): void {\n  getRegistry().clearAll();\n}\n\nexport function register<T extends StateContainerConstructor>(\n  BlocClass: T,\n): void {\n  getRegistry().register(BlocClass);\n}\n"],"mappings":";;AAOA,SAAgB,YACd,WACA,MACS;CACT,MAAM,WAAWA,eAAAA,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,YAAY,WAAW,GAAG;AAC5C;AAEA,SAAgB,YACd,WACA,MACQ;CACR,MAAM,WAAWA,eAAAA,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,YAAY,WAAW,GAAG;AAC5C;AAEA,SAAgB,UACd,WACA,MACU;CACV,MAAM,WAAWA,eAAAA,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,UAAU,WAAW,GAAG;AAC1C;AAEA,SAAgB,OACd,WAC4B;CAC5B,OAAOA,eAAAA,YAAY,EAAE,OAAO,SAAS;AACvC;AAEA,SAAgB,QACd,WACA,UACM;CACN,eAAA,YAAY,EAAE,QAAQ,WAAW,QAAQ;AAC3C;;;AC1CA,SAAgB,MAA2C,WAAoB;CAC7E,eAAA,YAAY,EAAE,MAAM,SAAS;AAC/B;AAEA,SAAgB,WAAiB;CAC/B,eAAA,YAAY,EAAE,SAAS;AACzB;AAEA,SAAgB,SACd,WACM;CACN,eAAA,YAAY,EAAE,SAAS,SAAS;AAClC"}