@blac/core 2.1.1 → 2.1.3

package/dist/index.d.ts

@@ -1,16 +1,17 @@
 export { configureBlac, getBlacConfig, resetBlacConfig, shallowEqualState, type BlacConfig, type EqualityFn, } from './config';
 export { StateContainer } from './core/StateContainer';
+export { onActivated } from './core/onActivated';
 export type { HydrationStatus, StateContainerConfig, SystemEvent, SystemEventPayloads, DepHandle, } from './core/StateContainer';
 export { Cubit } from './core/Cubit';
 export type { BlacMeta, BlacHydration } from './core/meta';
 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 { acquire, resolveInstanceKey, borrow, borrowSafe, ensure, release, clear, clearAll, clearWhere, 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, getBlacName, } from './utils/static-props';
+export { isKeepAliveClass, isIsolatedClass, isExcludedFromDevTools, getBlacName, } from './utils/static-props';
 export type { BlacPlugin, BlacPluginWithInit, PluginContext, PluginConfig, InstanceMetadata, } from './plugin/BlacPlugin';
 export { watch, instance, type WatchFn, type WatchOptions, type BlocRef, } from './watch';
 export type { StateContainerConstructor, DeepReadonly, ExtractState, ExtractStateMutable, ExtractArgs, ExtractDeps, InstanceReadonlyState, WithState, InstanceState, StateContainerInstance, } from './types/utilities';

package/dist/index.js

@@ -1,7 +1,20 @@
-import { _ as configureBlac, b as shallowEqualState, f as isExcludedFromDevTools, m as BLAC_STATIC_PROPS, n as globalRegistry, o as ON_DISPOSE, p as isKeepAliveClass, t as StateContainerRegistry, u as getBlacName, v as getBlacConfig, y as resetBlacConfig } from "./StateContainerRegistry-gQbEutkN.js";
-import { a as getStats, i as getRegistry, n as StateContainer, o as setRegistry } from "./StateContainer-Bh2ipNYj.js";
-import { n as acquire, r as resolveInstanceKey, t as ensure } from "./ensure-Bi_yXk6f.js";
+import { S as shallowEqualState, b as getBlacConfig, d as getBlacName, g as BLAC_STATIC_PROPS, h as isKeepAliveClass, m as isIsolatedClass, n as globalRegistry, o as ON_ACTIVATED, p as isExcludedFromDevTools, s as ON_DISPOSE, t as StateContainerRegistry, x as resetBlacConfig, y as configureBlac } from "./StateContainerRegistry-CrTtRX5V.js";
+import { a as getStats, i as getRegistry, n as StateContainer, o as setRegistry } from "./StateContainer-CwByTd5L.js";
+import { n as acquire, r as resolveInstanceKey, t as ensure } from "./ensure-CwtQVTam.js";
 import { ALL_PATHS, ALL_PATHS as ALL_PATHS$1 } from "@dirtytalk/structural";
+//#region src/core/onActivated.ts
+/**
+* Run `handler` each time `container` goes from unowned to owned, and now if it
+* is already owned. `signal` aborts on the matching deactivation and on
+* dispose. Returns an unsubscribe function.
+*
+* Unlike the protected `onActivate`, this can be called from a field
+* initializer or a helper that receives the container.
+*/
+function onActivated(container, handler) {
+	return container[ON_ACTIVATED](handler);
+}
+//#endregion
 //#region src/core/Cubit.ts
 /**
 * `Cubit<S>` is a `StateContainer<S>` that exposes mutation publicly.
@@ -99,6 +112,9 @@ function clear(BlocClass) {
 function clearAll() {
 	getRegistry().clearAll();
 }
+function clearWhere(predicate) {
+	getRegistry().clearWhere(predicate);
+}
 /**
 * @public
 */
@@ -132,6 +148,7 @@ function register(BlocClass) {
 function blac(options) {
 	return function(target, _context) {
 		if (options.keepAlive !== void 0) target[BLAC_STATIC_PROPS.KEEP_ALIVE] = options.keepAlive;
+		if (options.isolated !== void 0) target[BLAC_STATIC_PROPS.ISOLATED] = options.isolated;
 		if (options.excludeFromDevTools) target[BLAC_STATIC_PROPS.EXCLUDE_FROM_DEVTOOLS] = true;
 		if (typeof options.equality === "function") target[BLAC_STATIC_PROPS.EQUALITY] = options.equality;
 		if (typeof options.key === "function") target[BLAC_STATIC_PROPS.KEY] = options.key;
@@ -213,6 +230,8 @@ function watchImpl(blocsOrBloc, callback, options) {
 	const inputs = isSingle ? [blocsOrBloc] : blocsOrBloc;
 	const registry = getRegistry();
 	const create = options?.create ?? true;
+	const signal = options?.signal;
+	if (signal?.aborted) return () => {};
 	const targets = inputs.map((input) => toWatchTarget(registry, input));
 	const refIds = targets.map(() => `_watch_${watchRefSeq++}`);
 	const resolveAt = (index) => create ? resolveBloc(registry, targets[index], refIds[index]) : resolveBlocPassive(registry, targets[index]);
@@ -223,6 +242,7 @@ function watchImpl(blocsOrBloc, callback, options) {
 	const cleanup = () => {
 		if (disposed) return;
 		disposed = true;
+		signal?.removeEventListener("abort", cleanup);
 		for (const unsub of channelUnsubs) unsub?.();
 		for (const unsub of disposedUnsubs) unsub?.();
 		channelUnsubs.length = 0;
@@ -251,6 +271,7 @@ function watchImpl(blocsOrBloc, callback, options) {
 			queueMicrotask(() => resubscribeAt(index));
 		});
 	};
+	signal?.addEventListener("abort", cleanup, { once: true });
 	try {
 		for (let i = 0; i < targets.length; i++) instances.push(resolveAt(i));
 		for (let i = 0; i < instances.length; i++) subscribeAt(i);
@@ -269,6 +290,6 @@ function instanceId(id) {
 	return id;
 }
 //#endregion
-export { ALL_PATHS, Cubit, StateContainer, StateContainerRegistry, acquire, blac, borrow, borrowSafe, clear, clearAll, configureBlac, ensure, forEach, getAll, getBlacConfig, getBlacName, getRefCount, getRefIds, getRegistry, getStats, globalRegistry, hasInstance, instance, instanceId, isExcludedFromDevTools, isKeepAliveClass, register, release, resetBlacConfig, resolveInstanceKey, setRegistry, shallowEqualState, watch };
+export { ALL_PATHS, Cubit, StateContainer, StateContainerRegistry, acquire, blac, borrow, borrowSafe, clear, clearAll, clearWhere, configureBlac, ensure, forEach, getAll, getBlacConfig, getBlacName, getRefCount, getRefIds, getRegistry, getStats, globalRegistry, hasInstance, instance, instanceId, isExcludedFromDevTools, isIsolatedClass, isKeepAliveClass, onActivated, register, release, resetBlacConfig, resolveInstanceKey, setRegistry, shallowEqualState, watch };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["ALL_PATHS"],"sources":["../src/core/Cubit.ts","../src/registry/borrow.ts","../src/registry/release.ts","../src/registry/queries.ts","../src/registry/management.ts","../src/decorators/blac.ts","../src/watch/watch.ts","../src/types/branded.ts"],"sourcesContent":["import { StateContainer } from './StateContainer';\nimport type { DeepPartial } from '@dirtytalk/structural';\n\n/**\n * `Cubit<S>` is a `StateContainer<S>` that exposes mutation publicly.\n *\n * That is the whole difference, and it is a real one: on `StateContainer`\n * `emit` / `patch` / `update` are `protected`, so a container mutates itself\n * from its own methods and callers go through the API it chooses to publish.\n * `Cubit` re-declares the three as `public` for the cases where a caller\n * legitimately drives state from outside — test helpers, devtools\n * time-travel, benchmarks.\n *\n * Reach for `StateContainer` when business logic should live in the class,\n * and `Cubit` when the caller owns the transitions.\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  override emit(next: S): void {\n    super.emit(next);\n  }\n\n  override patch(partial: DeepPartial<S>): void {\n    super.patch(partial);\n  }\n\n  override update(fn: (state: S) => S): void {\n    super.update(fn);\n  }\n}\n","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` derives the instance key (must match acquire);\n *   `refId` picks the ref to drop, otherwise one arbitrary ref goes;\n *   `forceDispose` disposes immediately regardless of remaining 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 { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n  InstanceReadonlyState,\n} from '../types/utilities';\n\n/**\n * @public\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\n/**\n * @public\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\n/**\n * @public\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\n/**\n * @public\n */\nexport function getAll<T extends StateContainerConstructor>(\n  BlocClass: T,\n): InstanceReadonlyState<T>[] {\n  return getRegistry().getAll(BlocClass);\n}\n\n/**\n * @public\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\n/**\n * @public\n */\nexport function register<T extends StateContainerConstructor>(\n  BlocClass: T,\n): void {\n  getRegistry().register(BlocClass);\n}\n","import { BLAC_STATIC_PROPS } from '../constants';\nimport type { EqualityFn } from '../config';\n\n/**\n * Configuration options for the `@blac` decorator. Any combination may be\n * given at once.\n */\nexport interface BlacOptions {\n  /**\n   * Keep the bloc alive when its ref count reaches 0. `false` turns off a\n   * `keepAlive` inherited from a base class.\n   */\n  keepAlive?: boolean;\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   * Explicit, minification-safe identity for this bloc class. Falls back to\n   * `constructor.name` when unset, which collides across classes once a\n   * minifier shortens class names.\n   */\n  name?: string;\n}\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 * @blac({ keepAlive: true, key: (args) => args.userId })\n * class UserBloc extends Cubit<UserState> {}\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 (options.keepAlive !== undefined) {\n      (target as any)[BLAC_STATIC_PROPS.KEEP_ALIVE] = options.keepAlive;\n    }\n    if (options.excludeFromDevTools) {\n      (target as any)[BLAC_STATIC_PROPS.EXCLUDE_FROM_DEVTOOLS] = true;\n    }\n    if (typeof options.equality === 'function') {\n      (target as any)[BLAC_STATIC_PROPS.EQUALITY] = options.equality;\n    }\n    if (typeof options.key === 'function') {\n      (target as any)[BLAC_STATIC_PROPS.KEY] = options.key;\n    }\n    if (typeof options.name === 'string') {\n      (target as any)[BLAC_STATIC_PROPS.BLAC_NAME] = options.name;\n    }\n    return target;\n  };\n}\n","import { ALL_PATHS } from '@dirtytalk/structural';\nimport { ON_DISPOSE } from '../core/symbols';\nimport { getRegistry } from '../registry';\nimport { resolveInstanceKey } from '../registry/acquire';\nimport type { StateContainerRegistry } from '../core/StateContainerRegistry';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n  StateContainerInstance,\n} from '../types/utilities';\n\nconst STOP: unique symbol = Symbol('watch.STOP');\ntype StopSymbol = typeof STOP;\n\nconst BLOC_REF_MARKER = Symbol('BlocRef');\n\n/**\n * Reference to a specific bloc instance, identified by class + the resolved\n * key derived from its `args`.\n */\nexport interface BlocRef<T extends StateContainerConstructor> {\n  [BLOC_REF_MARKER]: true;\n  blocClass: T;\n  /** @internal The resolved instance key (derived from `args`). */\n  instanceId: string;\n  /**\n   * @internal The `args` used to derive `instanceId`. Forwarded to\n   * `registry.acquire` so a not-yet-created instance is initialized with\n   * these args instead of `undefined`.\n   */\n  args?: unknown;\n}\n\n/**\n * Create a reference to a specific bloc instance, identified by its `args`.\n * The key is derived the same way `useBloc`/`acquire` derive it.\n *\n * @example\n * ```ts\n * watch(instance(UserBloc, { userId: 'user-123' }), (userBloc) => {\n *   console.log(userBloc.state.name);\n * });\n * ```\n */\nexport function instance<T extends StateContainerConstructor>(\n  BlocClass: T,\n  args?: ExtractArgs<T>,\n): BlocRef<T> {\n  return {\n    [BLOC_REF_MARKER]: true,\n    blocClass: BlocClass,\n    instanceId: resolveInstanceKey(BlocClass, args),\n    args,\n  };\n}\n\nfunction isBlocRef(\n  input: unknown,\n): input is BlocRef<StateContainerConstructor> {\n  return (\n    typeof input === 'object' && input !== null && BLOC_REF_MARKER in input\n  );\n}\n\ntype BlocInput = StateContainerConstructor | BlocRef<StateContainerConstructor>;\n\n/**\n * Options for `watch`.\n */\nexport interface WatchOptions {\n  /**\n   * When `false`, `watch` observes passively: it neither creates a missing\n   * instance nor takes a real ownership ref on an existing one. If the\n   * instance does not exist yet, the callback simply never fires — `watch`\n   * does not poll; call it again once the instance exists.\n   *\n   * Defaults to `true`.\n   */\n  create?: boolean;\n}\n\ntype ExtractInstance<T> =\n  T extends BlocRef<infer C>\n    ? InstanceType<C>\n    : T extends StateContainerConstructor\n      ? InstanceType<T>\n      : never;\n\ntype ExtractInstances<T extends readonly BlocInput[]> = {\n  [K in keyof T]: ExtractInstance<T[K]>;\n};\n\n/**\n * Watch function signature for single bloc.\n */\nexport interface WatchSingleFn {\n  <T extends StateContainerConstructor>(\n    bloc: T | BlocRef<T>,\n    callback: (bloc: InstanceType<T>) => void | StopSymbol,\n    options?: WatchOptions,\n  ): () => void;\n\n  STOP: StopSymbol;\n}\n\n/**\n * Watch function signature for multiple blocs.\n */\nexport interface WatchMultipleFn {\n  <T extends readonly BlocInput[]>(\n    blocs: T,\n    callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n    options?: WatchOptions,\n  ): () => void;\n\n  STOP: StopSymbol;\n}\n\n/**\n * Combined watch function type.\n */\nexport interface WatchFn extends WatchSingleFn {\n  <T extends readonly BlocInput[]>(\n    blocs: T,\n    callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n    options?: WatchOptions,\n  ): () => void;\n}\n\n/**\n * Class + resolved key + args needed to (re-)acquire a specific instance.\n * `watch` keeps this around per input so it can re-acquire the same logical\n * instance if the underlying container is disposed elsewhere.\n */\ninterface WatchTarget {\n  blocClass: StateContainerConstructor;\n  key: string;\n  args: unknown;\n}\n\nfunction toWatchTarget(\n  registry: StateContainerRegistry,\n  input: BlocInput,\n): WatchTarget {\n  if (isBlocRef(input)) {\n    return {\n      blocClass: input.blocClass,\n      key: input.instanceId,\n      args: input.args,\n    };\n  }\n  return {\n    blocClass: input,\n    key: registry.resolveKey(input, undefined, undefined),\n    args: undefined,\n  };\n}\n\nlet watchRefSeq = 0;\n\n/**\n * Acquire a real ref (countRef: true) for the target, carrying its `args`\n * through so a not-yet-created instance is initialized correctly. The\n * caller is responsible for releasing `refId` in cleanup.\n */\nfunction resolveBloc(\n  registry: StateContainerRegistry,\n  target: WatchTarget,\n  refId: string,\n): StateContainerInstance {\n  return registry.acquire(target.blocClass, target.key, {\n    countRef: true,\n    refId,\n    args: target.args,\n  });\n}\n\n/**\n * Passive lookup for `{ create: false }`: never creates the instance and\n * never takes a ref. Returns `undefined` when no instance currently exists.\n */\nfunction resolveBlocPassive(\n  registry: StateContainerRegistry,\n  target: WatchTarget,\n): StateContainerInstance | undefined {\n  try {\n    return registry.acquire(target.blocClass, target.key, {\n      canCreate: false,\n      countRef: false,\n      args: target.args,\n    });\n  } catch {\n    return undefined;\n  }\n}\n\nfunction isArray(input: unknown): input is readonly BlocInput[] {\n  return Array.isArray(input);\n}\n\n/**\n * Watch one or more blocs for state changes.\n *\n * Thin wrapper around `container.channel.subscribe(ALL_PATHS, ...)`. The\n * callback fires once immediately, then on every state change of any of the\n * passed blocs. Returning `watch.STOP` from the callback tears down all\n * subscriptions. Subscriptions are microtask-deferred, so callbacks land\n * asynchronously after `emit()`.\n *\n * By default `watch` creates the instance if it does not exist and holds a\n * real ownership ref until `unwatch`, matching `acquire`. Pass\n * `{ create: false }` to observe passively instead — see `WatchOptions`.\n *\n * @example Single bloc\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n *   console.log(userBloc.state.name);\n * });\n * ```\n *\n * @example Multiple blocs\n * ```ts\n * const unwatch = watch(\n *   [UserBloc, SettingsBloc] as const,\n *   ([userBloc, settingsBloc]) => {\n *     console.log(userBloc.state.name, settingsBloc.state.theme);\n *   }\n * );\n * ```\n *\n * @example With specific instance\n * ```ts\n * const unwatch = watch(\n *   instance(UserBloc, { userId: 'user-123' }),\n *   (userBloc) => {\n *     console.log(userBloc.state.name);\n *   }\n * );\n * ```\n *\n * @example Stop watching from callback\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n *   if (userBloc.state.done) {\n *     return watch.STOP;\n *   }\n * });\n * ```\n */\nfunction watchImpl<T extends StateContainerConstructor>(\n  bloc: T | BlocRef<T>,\n  callback: (bloc: InstanceType<T>) => void | StopSymbol,\n  options?: WatchOptions,\n): () => void;\n\nfunction watchImpl<T extends readonly BlocInput[]>(\n  blocs: T,\n  callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n  options?: WatchOptions,\n): () => void;\n\nfunction watchImpl(\n  blocsOrBloc: BlocInput | readonly BlocInput[],\n  callback: (blocsOrBloc: any) => void | StopSymbol,\n  options?: WatchOptions,\n): () => void {\n  const isSingle = !isArray(blocsOrBloc);\n  const inputs = isSingle ? [blocsOrBloc] : blocsOrBloc;\n  const registry = getRegistry();\n  const create = options?.create ?? true;\n\n  const targets = inputs.map((input) => toWatchTarget(registry, input));\n  const refIds = targets.map(() => `_watch_${watchRefSeq++}`);\n  const resolveAt = (index: number) =>\n    create\n      ? resolveBloc(registry, targets[index], refIds[index])\n      : resolveBlocPassive(registry, targets[index]);\n\n  let disposed = false;\n  const instances: Array<StateContainerInstance | undefined> = [];\n  const channelUnsubs: Array<(() => void) | undefined> = [];\n  const disposedUnsubs: Array<(() => void) | undefined> = [];\n\n  const cleanup = () => {\n    if (disposed) return;\n    disposed = true;\n    for (const unsub of channelUnsubs) unsub?.();\n    for (const unsub of disposedUnsubs) unsub?.();\n    channelUnsubs.length = 0;\n    disposedUnsubs.length = 0;\n    if (create) {\n      for (let i = 0; i < instances.length; i++) {\n        registry.release(\n          targets[i].blocClass,\n          targets[i].key,\n          false,\n          refIds[i],\n        );\n      }\n    }\n  };\n\n  const runCallback = () => {\n    if (disposed) return;\n    if (instances.some((i) => i === undefined)) return;\n    const arg = isSingle ? instances[0] : instances;\n    const result = callback(arg);\n    if (result === STOP) cleanup();\n  };\n\n  const subscribeAt = (index: number) => {\n    channelUnsubs[index] = instances[index]?.channel.subscribe(\n      () => ALL_PATHS,\n      runCallback,\n    );\n  };\n\n  // On external dispose, tear down the stale subscription and re-acquire +\n  // resubscribe (microtask-deferred, so it never runs mid-mutation of the\n  // registry that triggered the dispose, e.g. `clearAll()`), then notify.\n  const resubscribeAt = (index: number) => {\n    if (disposed) return;\n    instances[index] = resolveAt(index);\n    subscribeAt(index);\n    subscribeDisposeAt(index);\n    runCallback();\n  };\n\n  const subscribeDisposeAt = (index: number) => {\n    disposedUnsubs[index] = instances[index]?.[ON_DISPOSE](() => {\n      channelUnsubs[index]?.();\n      channelUnsubs[index] = undefined;\n      queueMicrotask(() => resubscribeAt(index));\n    });\n  };\n\n  try {\n    for (let i = 0; i < targets.length; i++) instances.push(resolveAt(i));\n    for (let i = 0; i < instances.length; i++) subscribeAt(i);\n    for (let i = 0; i < instances.length; i++) subscribeDisposeAt(i);\n    // Fire once immediately so the consumer sees the current state.\n    runCallback();\n  } catch (error) {\n    cleanup();\n    throw error;\n  }\n\n  return cleanup;\n}\n\nexport const watch: WatchFn = Object.assign(watchImpl, { STOP }) as WatchFn;\n","declare const brand: unique symbol;\n\n/**\n * Nominal type helper, preventing accidental confusion between similar\n * primitive types.\n * @typeParam T - The base type\n * @typeParam B - The brand identifier\n */\nexport type Brand<T, B> = T & { [brand]: B };\n\n/**\n * Branded string type for type-safe IDs.\n * @typeParam B - The brand identifier\n */\nexport type BrandedId<B> = Brand<string, B>;\n\n/** Branded string type for state container instance IDs. */\nexport type InstanceId = Brand<string, 'InstanceId'>;\n\nexport function instanceId(id: string): InstanceId {\n  return id as InstanceId;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["ALL_PATHS"],"sources":["../src/core/onActivated.ts","../src/core/Cubit.ts","../src/registry/borrow.ts","../src/registry/release.ts","../src/registry/queries.ts","../src/registry/management.ts","../src/decorators/blac.ts","../src/watch/watch.ts","../src/types/branded.ts"],"sourcesContent":["import { ON_ACTIVATED } from './symbols';\nimport type { StateContainer } from './StateContainer';\n\n/**\n * Run `handler` each time `container` goes from unowned to owned, and now if it\n * is already owned. `signal` aborts on the matching deactivation and on\n * dispose. Returns an unsubscribe function.\n *\n * Unlike the protected `onActivate`, this can be called from a field\n * initializer or a helper that receives the container.\n */\nexport function onActivated(\n  container: StateContainer<any, any, any>,\n  handler: (signal: AbortSignal) => void,\n): () => void {\n  return container[ON_ACTIVATED](handler);\n}\n","import { StateContainer } from './StateContainer';\nimport type { DeepPartial } from '@dirtytalk/structural';\n\n/**\n * `Cubit<S>` is a `StateContainer<S>` that exposes mutation publicly.\n *\n * That is the whole difference, and it is a real one: on `StateContainer`\n * `emit` / `patch` / `update` are `protected`, so a container mutates itself\n * from its own methods and callers go through the API it chooses to publish.\n * `Cubit` re-declares the three as `public` for the cases where a caller\n * legitimately drives state from outside — test helpers, devtools\n * time-travel, benchmarks.\n *\n * Reach for `StateContainer` when business logic should live in the class,\n * and `Cubit` when the caller owns the transitions.\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  override emit(next: S): void {\n    super.emit(next);\n  }\n\n  override patch(partial: DeepPartial<S>): void {\n    super.patch(partial);\n  }\n\n  override update(fn: (state: S) => S): void {\n    super.update(fn);\n  }\n}\n","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` derives the instance key (must match acquire);\n *   `refId` picks the ref to drop, otherwise one arbitrary ref goes;\n *   `forceDispose` disposes immediately regardless of remaining 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 { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n  InstanceReadonlyState,\n} from '../types/utilities';\n\n/**\n * @public\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\n/**\n * @public\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\n/**\n * @public\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\n/**\n * @public\n */\nexport function getAll<T extends StateContainerConstructor>(\n  BlocClass: T,\n): InstanceReadonlyState<T>[] {\n  return getRegistry().getAll(BlocClass);\n}\n\n/**\n * @public\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 { StateContainer } from '../core/StateContainer';\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 clearWhere(\n  predicate: (instance: StateContainer<any, any, any>) => boolean,\n): void {\n  getRegistry().clearWhere(predicate);\n}\n\n/**\n * @public\n */\nexport function register<T extends StateContainerConstructor>(\n  BlocClass: T,\n): void {\n  getRegistry().register(BlocClass);\n}\n","import { BLAC_STATIC_PROPS } from '../constants';\nimport type { EqualityFn } from '../config';\n\n/**\n * Configuration options for the `@blac` decorator. Any combination may be\n * given at once.\n */\nexport interface BlacOptions {\n  /**\n   * Keep the bloc alive when its ref count reaches 0. `false` turns off a\n   * `keepAlive` inherited from a base class.\n   */\n  keepAlive?: boolean;\n  /**\n   * Give each `useBloc` mount its own private instance, disposed when that\n   * component unmounts. Applies to `useBloc` only; `ensure`/`acquire` still\n   * resolve the shared instance. `false` turns off an `isolated` inherited\n   * from a base class.\n   */\n  isolated?: boolean;\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   * Explicit, minification-safe identity for this bloc class. Falls back to\n   * `constructor.name` when unset, which collides across classes once a\n   * minifier shortens class names.\n   */\n  name?: string;\n}\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 * @blac({ keepAlive: true, key: (args) => args.userId })\n * class UserBloc extends Cubit<UserState> {}\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 (options.keepAlive !== undefined) {\n      (target as any)[BLAC_STATIC_PROPS.KEEP_ALIVE] = options.keepAlive;\n    }\n    if (options.isolated !== undefined) {\n      (target as any)[BLAC_STATIC_PROPS.ISOLATED] = options.isolated;\n    }\n    if (options.excludeFromDevTools) {\n      (target as any)[BLAC_STATIC_PROPS.EXCLUDE_FROM_DEVTOOLS] = true;\n    }\n    if (typeof options.equality === 'function') {\n      (target as any)[BLAC_STATIC_PROPS.EQUALITY] = options.equality;\n    }\n    if (typeof options.key === 'function') {\n      (target as any)[BLAC_STATIC_PROPS.KEY] = options.key;\n    }\n    if (typeof options.name === 'string') {\n      (target as any)[BLAC_STATIC_PROPS.BLAC_NAME] = options.name;\n    }\n    return target;\n  };\n}\n","import { ALL_PATHS } from '@dirtytalk/structural';\nimport { ON_DISPOSE } from '../core/symbols';\nimport { getRegistry } from '../registry';\nimport { resolveInstanceKey } from '../registry/acquire';\nimport type { StateContainerRegistry } from '../core/StateContainerRegistry';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n  StateContainerInstance,\n} from '../types/utilities';\n\nconst STOP: unique symbol = Symbol('watch.STOP');\ntype StopSymbol = typeof STOP;\n\nconst BLOC_REF_MARKER = Symbol('BlocRef');\n\n/**\n * Reference to a specific bloc instance, identified by class + the resolved\n * key derived from its `args`.\n */\nexport interface BlocRef<T extends StateContainerConstructor> {\n  [BLOC_REF_MARKER]: true;\n  blocClass: T;\n  /** @internal The resolved instance key (derived from `args`). */\n  instanceId: string;\n  /**\n   * @internal The `args` used to derive `instanceId`. Forwarded to\n   * `registry.acquire` so a not-yet-created instance is initialized with\n   * these args instead of `undefined`.\n   */\n  args?: unknown;\n}\n\n/**\n * Create a reference to a specific bloc instance, identified by its `args`.\n * The key is derived the same way `useBloc`/`acquire` derive it.\n *\n * @example\n * ```ts\n * watch(instance(UserBloc, { userId: 'user-123' }), (userBloc) => {\n *   console.log(userBloc.state.name);\n * });\n * ```\n */\nexport function instance<T extends StateContainerConstructor>(\n  BlocClass: T,\n  args?: ExtractArgs<T>,\n): BlocRef<T> {\n  return {\n    [BLOC_REF_MARKER]: true,\n    blocClass: BlocClass,\n    instanceId: resolveInstanceKey(BlocClass, args),\n    args,\n  };\n}\n\nfunction isBlocRef(\n  input: unknown,\n): input is BlocRef<StateContainerConstructor> {\n  return (\n    typeof input === 'object' && input !== null && BLOC_REF_MARKER in input\n  );\n}\n\ntype BlocInput = StateContainerConstructor | BlocRef<StateContainerConstructor>;\n\n/**\n * Options for `watch`.\n */\nexport interface WatchOptions {\n  /**\n   * When `false`, `watch` observes passively: it neither creates a missing\n   * instance nor takes a real ownership ref on an existing one. If the\n   * instance does not exist yet, the callback simply never fires — `watch`\n   * does not poll; call it again once the instance exists.\n   *\n   * Defaults to `true`.\n   */\n  create?: boolean;\n  /**\n   * Stops the watch when aborted, equivalent to calling the returned stop\n   * function. An already-aborted signal returns a no-op stop without\n   * creating or acquiring anything.\n   */\n  signal?: AbortSignal;\n}\n\ntype ExtractInstance<T> =\n  T extends BlocRef<infer C>\n    ? InstanceType<C>\n    : T extends StateContainerConstructor\n      ? InstanceType<T>\n      : never;\n\ntype ExtractInstances<T extends readonly BlocInput[]> = {\n  [K in keyof T]: ExtractInstance<T[K]>;\n};\n\n/**\n * Watch function signature for single bloc.\n */\nexport interface WatchSingleFn {\n  <T extends StateContainerConstructor>(\n    bloc: T | BlocRef<T>,\n    callback: (bloc: InstanceType<T>) => void | StopSymbol,\n    options?: WatchOptions,\n  ): () => void;\n\n  STOP: StopSymbol;\n}\n\n/**\n * Watch function signature for multiple blocs.\n */\nexport interface WatchMultipleFn {\n  <T extends readonly BlocInput[]>(\n    blocs: T,\n    callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n    options?: WatchOptions,\n  ): () => void;\n\n  STOP: StopSymbol;\n}\n\n/**\n * Combined watch function type.\n */\nexport interface WatchFn extends WatchSingleFn {\n  <T extends readonly BlocInput[]>(\n    blocs: T,\n    callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n    options?: WatchOptions,\n  ): () => void;\n}\n\n/**\n * Class + resolved key + args needed to (re-)acquire a specific instance.\n * `watch` keeps this around per input so it can re-acquire the same logical\n * instance if the underlying container is disposed elsewhere.\n */\ninterface WatchTarget {\n  blocClass: StateContainerConstructor;\n  key: string;\n  args: unknown;\n}\n\nfunction toWatchTarget(\n  registry: StateContainerRegistry,\n  input: BlocInput,\n): WatchTarget {\n  if (isBlocRef(input)) {\n    return {\n      blocClass: input.blocClass,\n      key: input.instanceId,\n      args: input.args,\n    };\n  }\n  return {\n    blocClass: input,\n    key: registry.resolveKey(input, undefined, undefined),\n    args: undefined,\n  };\n}\n\nlet watchRefSeq = 0;\n\n/**\n * Acquire a real ref (countRef: true) for the target, carrying its `args`\n * through so a not-yet-created instance is initialized correctly. The\n * caller is responsible for releasing `refId` in cleanup.\n */\nfunction resolveBloc(\n  registry: StateContainerRegistry,\n  target: WatchTarget,\n  refId: string,\n): StateContainerInstance {\n  return registry.acquire(target.blocClass, target.key, {\n    countRef: true,\n    refId,\n    args: target.args,\n  });\n}\n\n/**\n * Passive lookup for `{ create: false }`: never creates the instance and\n * never takes a ref. Returns `undefined` when no instance currently exists.\n */\nfunction resolveBlocPassive(\n  registry: StateContainerRegistry,\n  target: WatchTarget,\n): StateContainerInstance | undefined {\n  try {\n    return registry.acquire(target.blocClass, target.key, {\n      canCreate: false,\n      countRef: false,\n      args: target.args,\n    });\n  } catch {\n    return undefined;\n  }\n}\n\nfunction isArray(input: unknown): input is readonly BlocInput[] {\n  return Array.isArray(input);\n}\n\n/**\n * Watch one or more blocs for state changes.\n *\n * Thin wrapper around `container.channel.subscribe(() => ALL_PATHS, ...)`. The\n * callback fires once immediately, then on every state change of any of the\n * passed blocs. Returning `watch.STOP` from the callback tears down all\n * subscriptions. Subscriptions are microtask-deferred, so callbacks land\n * asynchronously after `emit()`.\n *\n * By default `watch` creates the instance if it does not exist and holds a\n * real ownership ref until `unwatch`, matching `acquire`. Pass\n * `{ create: false }` to observe passively instead — see `WatchOptions`.\n *\n * @example Single bloc\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n *   console.log(userBloc.state.name);\n * });\n * ```\n *\n * @example Multiple blocs\n * ```ts\n * const unwatch = watch(\n *   [UserBloc, SettingsBloc] as const,\n *   ([userBloc, settingsBloc]) => {\n *     console.log(userBloc.state.name, settingsBloc.state.theme);\n *   }\n * );\n * ```\n *\n * @example With specific instance\n * ```ts\n * const unwatch = watch(\n *   instance(UserBloc, { userId: 'user-123' }),\n *   (userBloc) => {\n *     console.log(userBloc.state.name);\n *   }\n * );\n * ```\n *\n * @example Stop watching from callback\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n *   if (userBloc.state.done) {\n *     return watch.STOP;\n *   }\n * });\n * ```\n */\nfunction watchImpl<T extends StateContainerConstructor>(\n  bloc: T | BlocRef<T>,\n  callback: (bloc: InstanceType<T>) => void | StopSymbol,\n  options?: WatchOptions,\n): () => void;\n\nfunction watchImpl<T extends readonly BlocInput[]>(\n  blocs: T,\n  callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n  options?: WatchOptions,\n): () => void;\n\nfunction watchImpl(\n  blocsOrBloc: BlocInput | readonly BlocInput[],\n  callback: (blocsOrBloc: any) => void | StopSymbol,\n  options?: WatchOptions,\n): () => void {\n  const isSingle = !isArray(blocsOrBloc);\n  const inputs = isSingle ? [blocsOrBloc] : blocsOrBloc;\n  const registry = getRegistry();\n  const create = options?.create ?? true;\n  const signal = options?.signal;\n  if (signal?.aborted) return () => {};\n\n  const targets = inputs.map((input) => toWatchTarget(registry, input));\n  const refIds = targets.map(() => `_watch_${watchRefSeq++}`);\n  const resolveAt = (index: number) =>\n    create\n      ? resolveBloc(registry, targets[index], refIds[index])\n      : resolveBlocPassive(registry, targets[index]);\n\n  let disposed = false;\n  const instances: Array<StateContainerInstance | undefined> = [];\n  const channelUnsubs: Array<(() => void) | undefined> = [];\n  const disposedUnsubs: Array<(() => void) | undefined> = [];\n\n  const cleanup = () => {\n    if (disposed) return;\n    disposed = true;\n    signal?.removeEventListener('abort', cleanup);\n    for (const unsub of channelUnsubs) unsub?.();\n    for (const unsub of disposedUnsubs) unsub?.();\n    channelUnsubs.length = 0;\n    disposedUnsubs.length = 0;\n    if (create) {\n      for (let i = 0; i < instances.length; i++) {\n        registry.release(\n          targets[i].blocClass,\n          targets[i].key,\n          false,\n          refIds[i],\n        );\n      }\n    }\n  };\n\n  const runCallback = () => {\n    if (disposed) return;\n    if (instances.some((i) => i === undefined)) return;\n    const arg = isSingle ? instances[0] : instances;\n    const result = callback(arg);\n    if (result === STOP) cleanup();\n  };\n\n  const subscribeAt = (index: number) => {\n    channelUnsubs[index] = instances[index]?.channel.subscribe(\n      () => ALL_PATHS,\n      runCallback,\n    );\n  };\n\n  // On external dispose, tear down the stale subscription and re-acquire +\n  // resubscribe (microtask-deferred, so it never runs mid-mutation of the\n  // registry that triggered the dispose, e.g. `clearAll()`), then notify.\n  const resubscribeAt = (index: number) => {\n    if (disposed) return;\n    instances[index] = resolveAt(index);\n    subscribeAt(index);\n    subscribeDisposeAt(index);\n    runCallback();\n  };\n\n  const subscribeDisposeAt = (index: number) => {\n    disposedUnsubs[index] = instances[index]?.[ON_DISPOSE](() => {\n      channelUnsubs[index]?.();\n      channelUnsubs[index] = undefined;\n      queueMicrotask(() => resubscribeAt(index));\n    });\n  };\n\n  signal?.addEventListener('abort', cleanup, { once: true });\n\n  try {\n    for (let i = 0; i < targets.length; i++) instances.push(resolveAt(i));\n    for (let i = 0; i < instances.length; i++) subscribeAt(i);\n    for (let i = 0; i < instances.length; i++) subscribeDisposeAt(i);\n    // Fire once immediately so the consumer sees the current state.\n    runCallback();\n  } catch (error) {\n    cleanup();\n    throw error;\n  }\n\n  return cleanup;\n}\n\nexport const watch: WatchFn = Object.assign(watchImpl, { STOP }) as WatchFn;\n","declare const brand: unique symbol;\n\n/**\n * Nominal type helper, preventing accidental confusion between similar\n * primitive types.\n * @typeParam T - The base type\n * @typeParam B - The brand identifier\n */\nexport type Brand<T, B> = T & { [brand]: B };\n\n/**\n * Branded string type for type-safe IDs.\n * @typeParam B - The brand identifier\n */\nexport type BrandedId<B> = Brand<string, B>;\n\n/** Branded string type for state container instance IDs. */\nexport type InstanceId = Brand<string, 'InstanceId'>;\n\nexport function instanceId(id: string): InstanceId {\n  return id as InstanceId;\n}\n"],"mappings":"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"}

package/dist/internal.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_StateContainerRegistry = require("./StateContainerRegistry-DjQQtlCW.cjs");
-const require_StateContainer = require("./StateContainer-BUyuxKb3.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-B6O6cfJd.cjs");
+const require_StateContainer = require("./StateContainer-D2b10eR4.cjs");
 exports.APPLY_DEPS = require_StateContainerRegistry.APPLY_DEPS;
 exports.DEP_BRAND = require_StateContainer.DEP_BRAND;
 exports.INIT_CONFIG = require_StateContainerRegistry.INIT_CONFIG;

package/dist/internal.js

@@ -1,3 +1,3 @@
-import { a as INSERT_INSTANCE, i as INIT_CONFIG, l as WITH_TRACKED_STATE, o as ON_DISPOSE, r as APPLY_DEPS, s as REMOVE_DEPS_OWNER } from "./StateContainerRegistry-gQbEutkN.js";
-import { t as DEP_BRAND } from "./StateContainer-Bh2ipNYj.js";
+import { a as INSERT_INSTANCE, c as REMOVE_DEPS_OWNER, i as INIT_CONFIG, r as APPLY_DEPS, s as ON_DISPOSE, u as WITH_TRACKED_STATE } from "./StateContainerRegistry-CrTtRX5V.js";
+import { t as DEP_BRAND } from "./StateContainer-CwByTd5L.js";
 export { APPLY_DEPS, DEP_BRAND, INIT_CONFIG, INSERT_INSTANCE, ON_DISPOSE, REMOVE_DEPS_OWNER, WITH_TRACKED_STATE };

package/dist/plugin/BlacPlugin.d.ts

@@ -69,7 +69,9 @@ export interface BlacPlugin {
     onCreated?(ctx: PluginContext): void;
     /**
      * Fires once per channel flush with the changed `PathSet`.
-     * `paths` may be `ALL_PATHS` when the change spans every path.
+     * `paths` may be `ALL_PATHS` when the change spans every path, and may
+     * include the container's reserved root id (`container.interner.rootId()`),
+     * which decodes to the empty path `''`.
      * `prev`/`next` are the coalesced before/after states for the flush.
      */
     onStateChange?<S extends object = any>(ctx: PluginContext, prev: S, next: S, paths: PathSet): void;

package/dist/plugin/PluginManager.d.ts

@@ -9,10 +9,10 @@ import type { BlacPlugin, PluginConfig } from './BlacPlugin';
  * with `ALL_PATHS` interest and dispatches
  * `onStateChange(ctx, prev, next, paths)` on every flush.
  *
- * `ALL_PATHS` interest defeats the single-consumer-skip optimization in
- * `StructuralContainer` — an intended trade-off for plugins that genuinely
- * want every change (devtools/persist). Plugins that want low overhead
- * should remain uninstalled or environment-gated.
+ * `ALL_PATHS` interest wakes the bridge on every flush of every container —
+ * an intended trade-off for plugins that genuinely want every change
+ * (devtools/persist). Plugins that want low overhead should remain
+ * uninstalled or environment-gated.
  *
  * @example
  * ```ts

package/dist/plugins.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_StateContainerRegistry = require("./StateContainerRegistry-DjQQtlCW.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-B6O6cfJd.cjs");
 let _dirtytalk_structural = require("@dirtytalk/structural");
 //#region src/plugin/PluginManager.ts
 /**
@@ -11,10 +11,10 @@ let _dirtytalk_structural = require("@dirtytalk/structural");
 * with `ALL_PATHS` interest and dispatches
 * `onStateChange(ctx, prev, next, paths)` on every flush.
 *
-* `ALL_PATHS` interest defeats the single-consumer-skip optimization in
-* `StructuralContainer` — an intended trade-off for plugins that genuinely
-* want every change (devtools/persist). Plugins that want low overhead
-* should remain uninstalled or environment-gated.
+* `ALL_PATHS` interest wakes the bridge on every flush of every container —
+* an intended trade-off for plugins that genuinely want every change
+* (devtools/persist). Plugins that want low overhead should remain
+* uninstalled or environment-gated.
 *
 * @example
 * ```ts

package/dist/plugins.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.cjs","names":["IS_DEV","ALL_PATHS","getBlacName","readNodeEnv","globalRegistry"],"sources":["../src/plugin/PluginManager.ts","../src/plugins.ts"],"sourcesContent":["import { ALL_PATHS, type PathSet } from '@dirtytalk/structural';\nimport type { StateContainer } from '../core/StateContainer';\nimport { IS_DEV, readNodeEnv } from '../constants';\nimport { getBlacName } from '../utils/static-props';\nimport type { StateContainerConstructor } from '../types/utilities';\nimport type { StateContainerRegistry } from '../core/StateContainerRegistry';\nimport type {\n  BlacPlugin,\n  PluginContext,\n  PluginConfig,\n  InstanceMetadata,\n} from './BlacPlugin';\n\n/**\n * Internal structure for tracking installed plugins.\n *\n * `installContext` is the context handed to `onInstall` — it has no\n * `container`. Per-container contexts are built on demand by\n * `buildContext()` so each event carries the right focal container\n * without mutating a shared object.\n * @internal\n */\ninterface InstalledPlugin {\n  plugin: BlacPlugin;\n  config: PluginConfig;\n  installContext: PluginContext;\n}\n\n/**\n * Per-container bookkeeping for the channel-bridge plugin dispatcher.\n *\n * - `unsub` tears down the channel subscription on dispose.\n * - `prevState` is the state snapshot the manager will hand plugins as\n *   `prev` on the next flush; it is updated to the post-flush state after\n *   each dispatch.\n * @internal\n */\ninterface ContainerBridge {\n  unsub: () => void;\n  prevState: any;\n}\n\n/**\n * Manages plugin lifecycle for the BlaC state management system.\n *\n * Hooks into registry lifecycle events (synchronous) and per-container\n * channel flushes (microtask-coalesced): while at least one installed\n * plugin implements `onStateChange`, the manager subscribes each container\n * with `ALL_PATHS` interest and dispatches\n * `onStateChange(ctx, prev, next, paths)` on every flush.\n *\n * `ALL_PATHS` interest defeats the single-consumer-skip optimization in\n * `StructuralContainer` — an intended trade-off for plugins that genuinely\n * want every change (devtools/persist). Plugins that want low overhead\n * should remain uninstalled or environment-gated.\n *\n * @example\n * ```ts\n * const manager = createPluginManager(registry);\n * manager.install(myPlugin, { environment: 'development' });\n * ```\n */\nexport class PluginManager {\n  private plugins = new Map<string, InstalledPlugin>();\n  private registry: StateContainerRegistry;\n  private lifecycleUnsubscribers: (() => void)[] = [];\n\n  /**\n   * Per-container channel-bridge bookkeeping, subscribed at `created` and\n   * torn down at `disposed`/`destroy()`. Holds the rolling `prevState`\n   * snapshot handed to plugins on each flush.\n   *\n   * Strong, not a `WeakMap`, because `destroy()` must enumerate live bridges\n   * to unsubscribe them; entries are removed on `disposed`, so this never\n   * outlives the registry's own reference.\n   */\n  private containerBridges = new Map<\n    StateContainer<any, any, any>,\n    ContainerBridge\n  >();\n\n  /**\n   * One `PluginContext` per container, safe to reuse since it closes only\n   * over `registry`/`container`, both stable for the container's lifetime.\n   */\n  private contextCache = new WeakMap<\n    StateContainer<any, any, any>,\n    PluginContext\n  >();\n\n  /**\n   * Create a new PluginManager\n   * @param registry - The StateContainerRegistry to monitor for lifecycle events\n   */\n  constructor(registry: StateContainerRegistry) {\n    this.registry = registry;\n    this.setupLifecycleHooks();\n  }\n\n  /**\n   * Install a plugin with optional configuration\n   * @param plugin - The plugin to install\n   * @param config - Optional plugin configuration\n   * @throws Error if plugin is already installed\n   */\n  install(plugin: BlacPlugin, config: PluginConfig = {}): void {\n    const effectiveConfig: PluginConfig = {\n      enabled: true,\n      environment: 'all',\n      ...config,\n    };\n\n    if (!this.shouldEnablePlugin(effectiveConfig)) {\n      if (IS_DEV) {\n        console.log(\n          `[BlaC] Plugin \"${plugin.name}\" skipped (environment mismatch)`,\n        );\n      }\n      return;\n    }\n\n    if (this.plugins.has(plugin.name)) {\n      throw new Error(`Plugin \"${plugin.name}\" is already installed`);\n    }\n\n    const installContext = this.buildContext(undefined);\n\n    if (plugin.onInstall) {\n      try {\n        plugin.onInstall(installContext);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error installing plugin \"${plugin.name}\":`,\n          error,\n        );\n        throw error;\n      }\n    }\n\n    this.plugins.set(plugin.name, {\n      plugin,\n      config: effectiveConfig,\n      installContext,\n    });\n    this.backfillPlugin(plugin);\n\n    if (IS_DEV) {\n      console.log(\n        `[BlaC] Plugin \"${plugin.name}\" v${plugin.version} installed`,\n      );\n    }\n  }\n\n  /**\n   * Uninstall a plugin by name\n   * @param pluginName - The name of the plugin to uninstall\n   * @throws Error if plugin is not installed\n   */\n  uninstall(pluginName: string): void {\n    const installed = this.plugins.get(pluginName);\n    if (!installed) {\n      throw new Error(`Plugin \"${pluginName}\" is not installed`);\n    }\n\n    if (installed.plugin.onUninstall) {\n      try {\n        installed.plugin.onUninstall();\n      } catch (error) {\n        console.error(\n          `[BlaC] Error uninstalling plugin \"${pluginName}\":`,\n          error,\n        );\n      }\n    }\n\n    this.plugins.delete(pluginName);\n    if (!this.hasStateChangePlugin()) this.detachAllStateBridges();\n    if (IS_DEV) {\n      console.log(`[BlaC] Plugin \"${pluginName}\" uninstalled`);\n    }\n  }\n\n  /**\n   * Get an installed plugin by name\n   * @param pluginName - The name of the plugin to retrieve\n   * @returns The plugin instance or undefined if not found\n   */\n  getPlugin(pluginName: string): BlacPlugin | undefined {\n    return this.plugins.get(pluginName)?.plugin;\n  }\n\n  /**\n   * Get all installed plugins\n   * @returns Array of all installed plugins\n   */\n  getAllPlugins(): BlacPlugin[] {\n    return Array.from(this.plugins.values()).map((p) => p.plugin);\n  }\n\n  /**\n   * Check if a plugin is installed\n   * @param pluginName - The name of the plugin to check\n   * @returns true if the plugin is installed\n   */\n  hasPlugin(pluginName: string): boolean {\n    return this.plugins.has(pluginName);\n  }\n\n  /**\n   * Uninstall all plugins\n   */\n  clear(): void {\n    for (const name of this.plugins.keys()) {\n      this.uninstall(name);\n    }\n  }\n\n  destroy(): void {\n    this.clear();\n    for (const unsub of this.lifecycleUnsubscribers) {\n      unsub();\n    }\n    this.lifecycleUnsubscribers = [];\n  }\n\n  /**\n   * Wire registry lifecycle events into plugin dispatch.\n   *\n   * `onStateChange` is not wired through `registry.on('stateChanged', …)` —\n   * that event lacks the `PathSet` payload. Instead each `created` subscribes\n   * to the container's channel directly for `paths`, pairing it with\n   * `(prev, next)` from the per-container snapshot.\n   */\n  private setupLifecycleHooks(): void {\n    this.lifecycleUnsubscribers = [\n      this.registry.on('created', (instance) => {\n        if (this.hasStateChangePlugin()) this.attachStateBridge(instance);\n        this.notifyPlugins('onCreated', instance);\n      }),\n      this.registry.on('disposed', (instance) => {\n        this.notifyPlugins('onDestroyed', instance);\n        this.detachStateBridge(instance);\n      }),\n      this.registry.on('refAcquired', (instance, refId) => {\n        this.notifyPlugins('onRefAcquired', instance, refId);\n      }),\n      this.registry.on('refReleased', (instance, refId) => {\n        this.notifyPlugins('onRefReleased', instance, refId);\n      }),\n      this.registry.on('depsChanged', (instance, previousDeps, currentDeps) => {\n        this.notifyPlugins(\n          'onDepsChanged',\n          instance,\n          previousDeps,\n          currentDeps,\n        );\n      }),\n      this.registry.on(\n        'hydrationChanged',\n        (instance, status, previousStatus) => {\n          this.notifyPlugins(\n            'onHydrationChange',\n            instance,\n            status,\n            previousStatus,\n          );\n        },\n      ),\n      this.registry.on('activated', (instance, signal) => {\n        this.notifyPlugins('onActivate', instance, signal);\n      }),\n      this.registry.on('deactivated', (instance) => {\n        this.notifyPlugins('onDeactivate', instance);\n      }),\n    ];\n  }\n\n  /**\n   * Subscribe to the container's channel with `ALL_PATHS` interest so it\n   * fires on every flush. `prev` is the snapshot from the previous flush (or\n   * create-time for the first); the channel's `paths` is passed straight\n   * through to plugins.\n   */\n  private attachStateBridge(container: StateContainer<any, any, any>): void {\n    // Defensive: if a container is somehow created twice (it shouldn't be),\n    // don't double-subscribe — the existing bridge is canonical.\n    if (this.containerBridges.has(container)) return;\n\n    const bridge: ContainerBridge = {\n      unsub: () => {},\n      prevState: container.state,\n    };\n    this.containerBridges.set(container, bridge);\n\n    bridge.unsub = container.channel.subscribe(\n      () => ALL_PATHS,\n      (paths) => this.dispatchStateChange(container, paths),\n    );\n  }\n\n  private detachStateBridge(container: StateContainer<any, any, any>): void {\n    const bridge = this.containerBridges.get(container);\n    if (!bridge) return;\n    bridge.unsub();\n    this.containerBridges.delete(container);\n  }\n\n  // Bridges cost every container its single-consumer skip, so they exist only\n  // while some installed plugin implements `onStateChange`.\n  private hasStateChangePlugin(): boolean {\n    for (const { plugin } of this.plugins.values()) {\n      if (plugin.onStateChange) return true;\n    }\n    return false;\n  }\n\n  private detachAllStateBridges(): void {\n    for (const bridge of this.containerBridges.values()) {\n      bridge.unsub();\n    }\n    this.containerBridges.clear();\n  }\n\n  /**\n   * Backfill a newly-installed plugin with existing instances: attach the\n   * state bridge (idempotent) if it implements `onStateChange`, and invoke\n   * `onCreated` for each. Scoped to this plugin only — `notifyPlugins` would\n   * wrongly re-notify every plugin of every instance.\n   */\n  private backfillPlugin(plugin: BlacPlugin): void {\n    if (!plugin.onStateChange && !plugin.onCreated) return;\n    for (const Type of this.registry.getTypes()) {\n      for (const instance of this.registry.getAll(Type)) {\n        // getAll returns the readonly public view; internal bridging needs the\n        // real container (same friction the `as any` in queryInstances handles).\n        const container = instance as StateContainer<any, any, any>;\n        if (plugin.onStateChange) this.attachStateBridge(container);\n\n        if (!plugin.onCreated) continue;\n        try {\n          plugin.onCreated(this.buildContext(container));\n        } catch (error) {\n          console.error(\n            `[BlaC] Error in plugin \"${plugin.name}\" onCreated (backfill):`,\n            error,\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Channel-flush callback. Hands `(prev, next, paths)` to every enabled\n   * plugin's `onStateChange`, then updates `prevState` for the next flush.\n   * `prev` is captured once and reused across plugins, so every plugin sees\n   * the same values regardless of dispatch order.\n   */\n  private dispatchStateChange(\n    container: StateContainer<any, any, any>,\n    paths: PathSet,\n  ): void {\n    const bridge = this.containerBridges.get(container);\n    if (!bridge) return;\n\n    const prev = bridge.prevState;\n    const next = container.state;\n    bridge.prevState = next;\n\n    let ctx: PluginContext | undefined;\n    for (const { plugin, config } of this.plugins.values()) {\n      if (!config.enabled) continue;\n      // eslint-disable-next-line @typescript-eslint/unbound-method -- invoked via .call below\n      const hook = plugin.onStateChange;\n      if (typeof hook !== 'function') continue;\n\n      try {\n        ctx ??= this.buildContext(container);\n        hook.call(plugin, ctx, prev, next, paths);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error in plugin \"${plugin.name}\" onStateChange:`,\n          error,\n        );\n      }\n    }\n  }\n\n  /**\n   * Notify all plugins of a lifecycle event. Builds a `PluginContext` lazily\n   * on the first matching hook and reuses it for the rest of this dispatch —\n   * zero builds if no enabled plugin implements `hookName`.\n   */\n  private notifyPlugins(\n    hookName: Exclude<keyof BlacPlugin, 'onStateChange'>,\n    instance: StateContainer<any, any, any>,\n    ...extraArgs: any[]\n  ): void {\n    let ctx: PluginContext | undefined;\n    for (const { plugin, config } of this.plugins.values()) {\n      if (!config.enabled) continue;\n\n      const hook = plugin[hookName];\n      if (typeof hook !== 'function') continue;\n\n      try {\n        ctx ??= this.buildContext(instance);\n        (hook as any).call(plugin, ctx, ...extraArgs);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error in plugin \"${plugin.name}\" ${hookName}:`,\n          error,\n        );\n      }\n    }\n  }\n\n  /**\n   * Get the `PluginContext` for a focal container, building it once and\n   * reusing it thereafter (evicted via the `WeakMap` when the container\n   * dies). `undefined` (install-time) is never cached.\n   */\n  private buildContext(\n    container: StateContainer<any, any, any> | undefined,\n  ): PluginContext {\n    if (container !== undefined) {\n      const cached = this.contextCache.get(container);\n      if (cached) return cached;\n    }\n    const context = this.createContext(container);\n    if (container !== undefined) this.contextCache.set(container, context);\n    return context;\n  }\n\n  private createContext(\n    container: StateContainer<any, any, any> | undefined,\n  ): PluginContext {\n    const registry = this.registry;\n    return {\n      container,\n\n      getInstanceMetadata: (\n        instance: StateContainer<any, any, any>,\n      ): InstanceMetadata => {\n        return {\n          id: instance.$blac.id,\n          className: getBlacName(\n            instance.constructor as StateContainerConstructor,\n          ),\n          isDisposed: instance.$blac.disposed,\n          name: instance.$blac.name,\n          createdAt: instance.$blac.createdAt,\n          state: instance.state,\n          hydrationStatus: instance.$blac.hydration.status,\n          isHydrated: instance.$blac.hydration.isHydrated,\n          hydrationError: instance.$blac.hydration.error,\n          changedWhileHydrating: instance.$blac.hydration.changedWhileHydrating,\n          args: instance.args,\n        };\n      },\n\n      getState: <S extends object = any>(instance: StateContainer<S>): S => {\n        return instance.state;\n      },\n\n      getHydrationStatus: (instance: StateContainer<any, any, any>) => {\n        return instance.$blac.hydration.status;\n      },\n\n      startHydration: (instance: StateContainer<any, any, any>) => {\n        instance.$blac.hydration.begin();\n      },\n\n      applyHydratedState: <S extends object = any>(\n        instance: StateContainer<S>,\n        state: S,\n      ): boolean => {\n        return instance.$blac.hydration.apply(state);\n      },\n\n      finishHydration: (instance: StateContainer<any, any, any>) => {\n        instance.$blac.hydration.finish();\n      },\n\n      failHydration: (\n        instance: StateContainer<any, any, any>,\n        error: Error,\n      ) => {\n        instance.$blac.hydration.fail(error);\n      },\n\n      waitForHydration: (instance: StateContainer<any, any, any>) => {\n        return instance.$blac.hydration.wait();\n      },\n\n      queryInstances: <T extends StateContainer<any, any, any>>(\n        typeClass: new (...args: any[]) => T,\n      ): T[] => {\n        return registry.getAll(typeClass as any);\n      },\n\n      getAllTypes: () => {\n        return registry.getTypes();\n      },\n\n      getStats: () => {\n        return registry.getStats();\n      },\n\n      getRefIds: (instanceId: string): string[] => {\n        return registry.getRefIdsById(instanceId);\n      },\n    };\n  }\n\n  /**\n   * Check if plugin should be enabled based on environment\n   */\n  private shouldEnablePlugin(config: PluginConfig): boolean {\n    if (!config.enabled) return false;\n    if (config.environment === 'all') return true;\n\n    const currentEnv = this.getCurrentEnvironment();\n    return currentEnv === config.environment;\n  }\n\n  /**\n   * Same rule as `IS_DEV`: an unknown environment counts as production.\n   */\n  private getCurrentEnvironment(): 'development' | 'production' | 'test' {\n    const env = readNodeEnv();\n    if (env === undefined || env === 'production') return 'production';\n    return env === 'test' ? 'test' : 'development';\n  }\n}\n\n/**\n * Create a plugin manager instance\n * @param registry - The StateContainerRegistry to monitor for lifecycle events\n * @returns A new PluginManager instance\n */\nexport function createPluginManager(\n  registry: StateContainerRegistry,\n): PluginManager {\n  return new PluginManager(registry);\n}\n","/**\n * Plugin system utilities for extending BlaC functionality.\n * Import from `@blac/core/plugins`.\n *\n * @example\n * ```typescript\n * import { PluginManager, getPluginManager, type BlacPlugin } from '@blac/core/plugins';\n *\n * const myPlugin: BlacPlugin = {\n *   name: 'my-plugin',\n *   onCreated(context) {\n *     console.log('Instance created:', context.container);\n *   },\n * };\n *\n * getPluginManager().install(myPlugin);\n * ```\n *\n * @packageDocumentation\n */\n\nimport { createPluginManager, PluginManager } from './plugin/PluginManager';\nimport {\n  globalRegistry,\n  type StateContainerRegistry,\n} from './core/StateContainerRegistry';\n\nexport { PluginManager } from './plugin/PluginManager';\nexport type {\n  BlacPlugin,\n  BlacPluginWithInit,\n  PluginContext,\n  PluginConfig,\n  InstanceMetadata,\n} from './plugin/BlacPlugin';\n\nconst pluginManagers = new WeakMap<StateContainerRegistry, PluginManager>();\n\n/**\n * Get the plugin manager for a registry (the global one by default). Plugins\n * only observe the registry they are installed on, so install them again on\n * a scoped registry (e.g. one passed to `RegistryProvider`).\n */\nexport function getPluginManager(\n  registry: StateContainerRegistry = globalRegistry,\n): PluginManager {\n  let manager = pluginManagers.get(registry);\n  if (!manager) {\n    manager = createPluginManager(registry);\n    pluginManagers.set(registry, manager);\n  }\n  return manager;\n}\n"],"mappings":"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"}
+{"version":3,"file":"plugins.cjs","names":["IS_DEV","ALL_PATHS","getBlacName","readNodeEnv","globalRegistry"],"sources":["../src/plugin/PluginManager.ts","../src/plugins.ts"],"sourcesContent":["import { ALL_PATHS, type PathSet } from '@dirtytalk/structural';\nimport type { StateContainer } from '../core/StateContainer';\nimport { IS_DEV, readNodeEnv } from '../constants';\nimport { getBlacName } from '../utils/static-props';\nimport type { StateContainerConstructor } from '../types/utilities';\nimport type { StateContainerRegistry } from '../core/StateContainerRegistry';\nimport type {\n  BlacPlugin,\n  PluginContext,\n  PluginConfig,\n  InstanceMetadata,\n} from './BlacPlugin';\n\n/**\n * Internal structure for tracking installed plugins.\n *\n * `installContext` is the context handed to `onInstall` — it has no\n * `container`. Per-container contexts are built on demand by\n * `buildContext()` so each event carries the right focal container\n * without mutating a shared object.\n * @internal\n */\ninterface InstalledPlugin {\n  plugin: BlacPlugin;\n  config: PluginConfig;\n  installContext: PluginContext;\n}\n\n/**\n * Per-container bookkeeping for the channel-bridge plugin dispatcher.\n *\n * - `unsub` tears down the channel subscription on dispose.\n * - `prevState` is the state snapshot the manager will hand plugins as\n *   `prev` on the next flush; it is updated to the post-flush state after\n *   each dispatch.\n * @internal\n */\ninterface ContainerBridge {\n  unsub: () => void;\n  prevState: any;\n}\n\n/**\n * Manages plugin lifecycle for the BlaC state management system.\n *\n * Hooks into registry lifecycle events (synchronous) and per-container\n * channel flushes (microtask-coalesced): while at least one installed\n * plugin implements `onStateChange`, the manager subscribes each container\n * with `ALL_PATHS` interest and dispatches\n * `onStateChange(ctx, prev, next, paths)` on every flush.\n *\n * `ALL_PATHS` interest wakes the bridge on every flush of every container —\n * an intended trade-off for plugins that genuinely want every change\n * (devtools/persist). Plugins that want low overhead should remain\n * uninstalled or environment-gated.\n *\n * @example\n * ```ts\n * const manager = createPluginManager(registry);\n * manager.install(myPlugin, { environment: 'development' });\n * ```\n */\nexport class PluginManager {\n  private plugins = new Map<string, InstalledPlugin>();\n  private registry: StateContainerRegistry;\n  private lifecycleUnsubscribers: (() => void)[] = [];\n\n  /**\n   * Per-container channel-bridge bookkeeping, subscribed at `created` and\n   * torn down at `disposed`/`destroy()`. Holds the rolling `prevState`\n   * snapshot handed to plugins on each flush.\n   *\n   * Strong, not a `WeakMap`, because `destroy()` must enumerate live bridges\n   * to unsubscribe them; entries are removed on `disposed`, so this never\n   * outlives the registry's own reference.\n   */\n  private containerBridges = new Map<\n    StateContainer<any, any, any>,\n    ContainerBridge\n  >();\n\n  /**\n   * One `PluginContext` per container, safe to reuse since it closes only\n   * over `registry`/`container`, both stable for the container's lifetime.\n   */\n  private contextCache = new WeakMap<\n    StateContainer<any, any, any>,\n    PluginContext\n  >();\n\n  /**\n   * Create a new PluginManager\n   * @param registry - The StateContainerRegistry to monitor for lifecycle events\n   */\n  constructor(registry: StateContainerRegistry) {\n    this.registry = registry;\n    this.setupLifecycleHooks();\n  }\n\n  /**\n   * Install a plugin with optional configuration\n   * @param plugin - The plugin to install\n   * @param config - Optional plugin configuration\n   * @throws Error if plugin is already installed\n   */\n  install(plugin: BlacPlugin, config: PluginConfig = {}): void {\n    const effectiveConfig: PluginConfig = {\n      enabled: true,\n      environment: 'all',\n      ...config,\n    };\n\n    if (!this.shouldEnablePlugin(effectiveConfig)) {\n      if (IS_DEV) {\n        console.log(\n          `[BlaC] Plugin \"${plugin.name}\" skipped (environment mismatch)`,\n        );\n      }\n      return;\n    }\n\n    if (this.plugins.has(plugin.name)) {\n      throw new Error(`Plugin \"${plugin.name}\" is already installed`);\n    }\n\n    const installContext = this.buildContext(undefined);\n\n    if (plugin.onInstall) {\n      try {\n        plugin.onInstall(installContext);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error installing plugin \"${plugin.name}\":`,\n          error,\n        );\n        throw error;\n      }\n    }\n\n    this.plugins.set(plugin.name, {\n      plugin,\n      config: effectiveConfig,\n      installContext,\n    });\n    this.backfillPlugin(plugin);\n\n    if (IS_DEV) {\n      console.log(\n        `[BlaC] Plugin \"${plugin.name}\" v${plugin.version} installed`,\n      );\n    }\n  }\n\n  /**\n   * Uninstall a plugin by name\n   * @param pluginName - The name of the plugin to uninstall\n   * @throws Error if plugin is not installed\n   */\n  uninstall(pluginName: string): void {\n    const installed = this.plugins.get(pluginName);\n    if (!installed) {\n      throw new Error(`Plugin \"${pluginName}\" is not installed`);\n    }\n\n    if (installed.plugin.onUninstall) {\n      try {\n        installed.plugin.onUninstall();\n      } catch (error) {\n        console.error(\n          `[BlaC] Error uninstalling plugin \"${pluginName}\":`,\n          error,\n        );\n      }\n    }\n\n    this.plugins.delete(pluginName);\n    if (!this.hasStateChangePlugin()) this.detachAllStateBridges();\n    if (IS_DEV) {\n      console.log(`[BlaC] Plugin \"${pluginName}\" uninstalled`);\n    }\n  }\n\n  /**\n   * Get an installed plugin by name\n   * @param pluginName - The name of the plugin to retrieve\n   * @returns The plugin instance or undefined if not found\n   */\n  getPlugin(pluginName: string): BlacPlugin | undefined {\n    return this.plugins.get(pluginName)?.plugin;\n  }\n\n  /**\n   * Get all installed plugins\n   * @returns Array of all installed plugins\n   */\n  getAllPlugins(): BlacPlugin[] {\n    return Array.from(this.plugins.values()).map((p) => p.plugin);\n  }\n\n  /**\n   * Check if a plugin is installed\n   * @param pluginName - The name of the plugin to check\n   * @returns true if the plugin is installed\n   */\n  hasPlugin(pluginName: string): boolean {\n    return this.plugins.has(pluginName);\n  }\n\n  /**\n   * Uninstall all plugins\n   */\n  clear(): void {\n    for (const name of this.plugins.keys()) {\n      this.uninstall(name);\n    }\n  }\n\n  destroy(): void {\n    this.clear();\n    for (const unsub of this.lifecycleUnsubscribers) {\n      unsub();\n    }\n    this.lifecycleUnsubscribers = [];\n  }\n\n  /**\n   * Wire registry lifecycle events into plugin dispatch.\n   *\n   * `onStateChange` is not wired through `registry.on('stateChanged', …)` —\n   * that event lacks the `PathSet` payload. Instead each `created` subscribes\n   * to the container's channel directly for `paths`, pairing it with\n   * `(prev, next)` from the per-container snapshot.\n   */\n  private setupLifecycleHooks(): void {\n    this.lifecycleUnsubscribers = [\n      this.registry.on('created', (instance) => {\n        if (this.hasStateChangePlugin()) this.attachStateBridge(instance);\n        this.notifyPlugins('onCreated', instance);\n      }),\n      this.registry.on('disposed', (instance) => {\n        this.notifyPlugins('onDestroyed', instance);\n        this.detachStateBridge(instance);\n      }),\n      this.registry.on('refAcquired', (instance, refId) => {\n        this.notifyPlugins('onRefAcquired', instance, refId);\n      }),\n      this.registry.on('refReleased', (instance, refId) => {\n        this.notifyPlugins('onRefReleased', instance, refId);\n      }),\n      this.registry.on('depsChanged', (instance, previousDeps, currentDeps) => {\n        this.notifyPlugins(\n          'onDepsChanged',\n          instance,\n          previousDeps,\n          currentDeps,\n        );\n      }),\n      this.registry.on(\n        'hydrationChanged',\n        (instance, status, previousStatus) => {\n          this.notifyPlugins(\n            'onHydrationChange',\n            instance,\n            status,\n            previousStatus,\n          );\n        },\n      ),\n      this.registry.on('activated', (instance, signal) => {\n        this.notifyPlugins('onActivate', instance, signal);\n      }),\n      this.registry.on('deactivated', (instance) => {\n        this.notifyPlugins('onDeactivate', instance);\n      }),\n    ];\n  }\n\n  /**\n   * Subscribe to the container's channel with `ALL_PATHS` interest so it\n   * fires on every flush. `prev` is the snapshot from the previous flush (or\n   * create-time for the first); the channel's `paths` is passed straight\n   * through to plugins.\n   */\n  private attachStateBridge(container: StateContainer<any, any, any>): void {\n    // Defensive: if a container is somehow created twice (it shouldn't be),\n    // don't double-subscribe — the existing bridge is canonical.\n    if (this.containerBridges.has(container)) return;\n\n    const bridge: ContainerBridge = {\n      unsub: () => {},\n      prevState: container.state,\n    };\n    this.containerBridges.set(container, bridge);\n\n    bridge.unsub = container.channel.subscribe(\n      () => ALL_PATHS,\n      (paths) => this.dispatchStateChange(container, paths),\n    );\n  }\n\n  private detachStateBridge(container: StateContainer<any, any, any>): void {\n    const bridge = this.containerBridges.get(container);\n    if (!bridge) return;\n    bridge.unsub();\n    this.containerBridges.delete(container);\n  }\n\n  // Bridges cost every container a callback per flush, so they exist only\n  // while some installed plugin implements `onStateChange`.\n  private hasStateChangePlugin(): boolean {\n    for (const { plugin } of this.plugins.values()) {\n      if (plugin.onStateChange) return true;\n    }\n    return false;\n  }\n\n  private detachAllStateBridges(): void {\n    for (const bridge of this.containerBridges.values()) {\n      bridge.unsub();\n    }\n    this.containerBridges.clear();\n  }\n\n  /**\n   * Backfill a newly-installed plugin with existing instances: attach the\n   * state bridge (idempotent) if it implements `onStateChange`, and invoke\n   * `onCreated` for each. Scoped to this plugin only — `notifyPlugins` would\n   * wrongly re-notify every plugin of every instance.\n   */\n  private backfillPlugin(plugin: BlacPlugin): void {\n    if (!plugin.onStateChange && !plugin.onCreated) return;\n    for (const Type of this.registry.getTypes()) {\n      for (const instance of this.registry.getAll(Type)) {\n        // getAll returns the readonly public view; internal bridging needs the\n        // real container (same friction the `as any` in queryInstances handles).\n        const container = instance as StateContainer<any, any, any>;\n        if (plugin.onStateChange) this.attachStateBridge(container);\n\n        if (!plugin.onCreated) continue;\n        try {\n          plugin.onCreated(this.buildContext(container));\n        } catch (error) {\n          console.error(\n            `[BlaC] Error in plugin \"${plugin.name}\" onCreated (backfill):`,\n            error,\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Channel-flush callback. Hands `(prev, next, paths)` to every enabled\n   * plugin's `onStateChange`, then updates `prevState` for the next flush.\n   * `prev` is captured once and reused across plugins, so every plugin sees\n   * the same values regardless of dispatch order.\n   */\n  private dispatchStateChange(\n    container: StateContainer<any, any, any>,\n    paths: PathSet,\n  ): void {\n    const bridge = this.containerBridges.get(container);\n    if (!bridge) return;\n\n    const prev = bridge.prevState;\n    const next = container.state;\n    bridge.prevState = next;\n\n    let ctx: PluginContext | undefined;\n    for (const { plugin, config } of this.plugins.values()) {\n      if (!config.enabled) continue;\n      // eslint-disable-next-line @typescript-eslint/unbound-method -- invoked via .call below\n      const hook = plugin.onStateChange;\n      if (typeof hook !== 'function') continue;\n\n      try {\n        ctx ??= this.buildContext(container);\n        hook.call(plugin, ctx, prev, next, paths);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error in plugin \"${plugin.name}\" onStateChange:`,\n          error,\n        );\n      }\n    }\n  }\n\n  /**\n   * Notify all plugins of a lifecycle event. Builds a `PluginContext` lazily\n   * on the first matching hook and reuses it for the rest of this dispatch —\n   * zero builds if no enabled plugin implements `hookName`.\n   */\n  private notifyPlugins(\n    hookName: Exclude<keyof BlacPlugin, 'onStateChange'>,\n    instance: StateContainer<any, any, any>,\n    ...extraArgs: any[]\n  ): void {\n    let ctx: PluginContext | undefined;\n    for (const { plugin, config } of this.plugins.values()) {\n      if (!config.enabled) continue;\n\n      const hook = plugin[hookName];\n      if (typeof hook !== 'function') continue;\n\n      try {\n        ctx ??= this.buildContext(instance);\n        (hook as any).call(plugin, ctx, ...extraArgs);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error in plugin \"${plugin.name}\" ${hookName}:`,\n          error,\n        );\n      }\n    }\n  }\n\n  /**\n   * Get the `PluginContext` for a focal container, building it once and\n   * reusing it thereafter (evicted via the `WeakMap` when the container\n   * dies). `undefined` (install-time) is never cached.\n   */\n  private buildContext(\n    container: StateContainer<any, any, any> | undefined,\n  ): PluginContext {\n    if (container !== undefined) {\n      const cached = this.contextCache.get(container);\n      if (cached) return cached;\n    }\n    const context = this.createContext(container);\n    if (container !== undefined) this.contextCache.set(container, context);\n    return context;\n  }\n\n  private createContext(\n    container: StateContainer<any, any, any> | undefined,\n  ): PluginContext {\n    const registry = this.registry;\n    return {\n      container,\n\n      getInstanceMetadata: (\n        instance: StateContainer<any, any, any>,\n      ): InstanceMetadata => {\n        return {\n          id: instance.$blac.id,\n          className: getBlacName(\n            instance.constructor as StateContainerConstructor,\n          ),\n          isDisposed: instance.$blac.disposed,\n          name: instance.$blac.name,\n          createdAt: instance.$blac.createdAt,\n          state: instance.state,\n          hydrationStatus: instance.$blac.hydration.status,\n          isHydrated: instance.$blac.hydration.isHydrated,\n          hydrationError: instance.$blac.hydration.error,\n          changedWhileHydrating: instance.$blac.hydration.changedWhileHydrating,\n          args: instance.args,\n        };\n      },\n\n      getState: <S extends object = any>(instance: StateContainer<S>): S => {\n        return instance.state;\n      },\n\n      getHydrationStatus: (instance: StateContainer<any, any, any>) => {\n        return instance.$blac.hydration.status;\n      },\n\n      startHydration: (instance: StateContainer<any, any, any>) => {\n        instance.$blac.hydration.begin();\n      },\n\n      applyHydratedState: <S extends object = any>(\n        instance: StateContainer<S>,\n        state: S,\n      ): boolean => {\n        return instance.$blac.hydration.apply(state);\n      },\n\n      finishHydration: (instance: StateContainer<any, any, any>) => {\n        instance.$blac.hydration.finish();\n      },\n\n      failHydration: (\n        instance: StateContainer<any, any, any>,\n        error: Error,\n      ) => {\n        instance.$blac.hydration.fail(error);\n      },\n\n      waitForHydration: (instance: StateContainer<any, any, any>) => {\n        return instance.$blac.hydration.wait();\n      },\n\n      queryInstances: <T extends StateContainer<any, any, any>>(\n        typeClass: new (...args: any[]) => T,\n      ): T[] => {\n        return registry.getAll(typeClass as any);\n      },\n\n      getAllTypes: () => {\n        return registry.getTypes();\n      },\n\n      getStats: () => {\n        return registry.getStats();\n      },\n\n      getRefIds: (instanceId: string): string[] => {\n        return registry.getRefIdsById(instanceId);\n      },\n    };\n  }\n\n  /**\n   * Check if plugin should be enabled based on environment\n   */\n  private shouldEnablePlugin(config: PluginConfig): boolean {\n    if (!config.enabled) return false;\n    if (config.environment === 'all') return true;\n\n    const currentEnv = this.getCurrentEnvironment();\n    return currentEnv === config.environment;\n  }\n\n  /**\n   * Same rule as `IS_DEV`: an unknown environment counts as production.\n   */\n  private getCurrentEnvironment(): 'development' | 'production' | 'test' {\n    const env = readNodeEnv();\n    if (env === undefined || env === 'production') return 'production';\n    return env === 'test' ? 'test' : 'development';\n  }\n}\n\n/**\n * Create a plugin manager instance\n * @param registry - The StateContainerRegistry to monitor for lifecycle events\n * @returns A new PluginManager instance\n */\nexport function createPluginManager(\n  registry: StateContainerRegistry,\n): PluginManager {\n  return new PluginManager(registry);\n}\n","/**\n * Plugin system utilities for extending BlaC functionality.\n * Import from `@blac/core/plugins`.\n *\n * @example\n * ```typescript\n * import { PluginManager, getPluginManager, type BlacPlugin } from '@blac/core/plugins';\n *\n * const myPlugin: BlacPlugin = {\n *   name: 'my-plugin',\n *   onCreated(context) {\n *     console.log('Instance created:', context.container);\n *   },\n * };\n *\n * getPluginManager().install(myPlugin);\n * ```\n *\n * @packageDocumentation\n */\n\nimport { createPluginManager, PluginManager } from './plugin/PluginManager';\nimport {\n  globalRegistry,\n  type StateContainerRegistry,\n} from './core/StateContainerRegistry';\n\nexport { PluginManager } from './plugin/PluginManager';\nexport type {\n  BlacPlugin,\n  BlacPluginWithInit,\n  PluginContext,\n  PluginConfig,\n  InstanceMetadata,\n} from './plugin/BlacPlugin';\n\nconst pluginManagers = new WeakMap<StateContainerRegistry, PluginManager>();\n\n/**\n * Get the plugin manager for a registry (the global one by default). Plugins\n * only observe the registry they are installed on, so install them again on\n * a scoped registry (e.g. one passed to `RegistryProvider`).\n */\nexport function getPluginManager(\n  registry: StateContainerRegistry = globalRegistry,\n): PluginManager {\n  let manager = pluginManagers.get(registry);\n  if (!manager) {\n    manager = createPluginManager(registry);\n    pluginManagers.set(registry, manager);\n  }\n  return manager;\n}\n"],"mappings":"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"}

package/dist/plugins.js

@@ -1,4 +1,4 @@
-import { g as readNodeEnv, h as IS_DEV, n as globalRegistry, u as getBlacName } from "./StateContainerRegistry-gQbEutkN.js";
+import { _ as IS_DEV, d as getBlacName, n as globalRegistry, v as readNodeEnv } from "./StateContainerRegistry-CrTtRX5V.js";
 import { ALL_PATHS } from "@dirtytalk/structural";
 //#region src/plugin/PluginManager.ts
 /**
@@ -10,10 +10,10 @@ import { ALL_PATHS } from "@dirtytalk/structural";
 * with `ALL_PATHS` interest and dispatches
 * `onStateChange(ctx, prev, next, paths)` on every flush.
 *
-* `ALL_PATHS` interest defeats the single-consumer-skip optimization in
-* `StructuralContainer` — an intended trade-off for plugins that genuinely
-* want every change (devtools/persist). Plugins that want low overhead
-* should remain uninstalled or environment-gated.
+* `ALL_PATHS` interest wakes the bridge on every flush of every container —
+* an intended trade-off for plugins that genuinely want every change
+* (devtools/persist). Plugins that want low overhead should remain
+* uninstalled or environment-gated.
 *
 * @example
 * ```ts

package/dist/plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.js","names":[],"sources":["../src/plugin/PluginManager.ts","../src/plugins.ts"],"sourcesContent":["import { ALL_PATHS, type PathSet } from '@dirtytalk/structural';\nimport type { StateContainer } from '../core/StateContainer';\nimport { IS_DEV, readNodeEnv } from '../constants';\nimport { getBlacName } from '../utils/static-props';\nimport type { StateContainerConstructor } from '../types/utilities';\nimport type { StateContainerRegistry } from '../core/StateContainerRegistry';\nimport type {\n  BlacPlugin,\n  PluginContext,\n  PluginConfig,\n  InstanceMetadata,\n} from './BlacPlugin';\n\n/**\n * Internal structure for tracking installed plugins.\n *\n * `installContext` is the context handed to `onInstall` — it has no\n * `container`. Per-container contexts are built on demand by\n * `buildContext()` so each event carries the right focal container\n * without mutating a shared object.\n * @internal\n */\ninterface InstalledPlugin {\n  plugin: BlacPlugin;\n  config: PluginConfig;\n  installContext: PluginContext;\n}\n\n/**\n * Per-container bookkeeping for the channel-bridge plugin dispatcher.\n *\n * - `unsub` tears down the channel subscription on dispose.\n * - `prevState` is the state snapshot the manager will hand plugins as\n *   `prev` on the next flush; it is updated to the post-flush state after\n *   each dispatch.\n * @internal\n */\ninterface ContainerBridge {\n  unsub: () => void;\n  prevState: any;\n}\n\n/**\n * Manages plugin lifecycle for the BlaC state management system.\n *\n * Hooks into registry lifecycle events (synchronous) and per-container\n * channel flushes (microtask-coalesced): while at least one installed\n * plugin implements `onStateChange`, the manager subscribes each container\n * with `ALL_PATHS` interest and dispatches\n * `onStateChange(ctx, prev, next, paths)` on every flush.\n *\n * `ALL_PATHS` interest defeats the single-consumer-skip optimization in\n * `StructuralContainer` — an intended trade-off for plugins that genuinely\n * want every change (devtools/persist). Plugins that want low overhead\n * should remain uninstalled or environment-gated.\n *\n * @example\n * ```ts\n * const manager = createPluginManager(registry);\n * manager.install(myPlugin, { environment: 'development' });\n * ```\n */\nexport class PluginManager {\n  private plugins = new Map<string, InstalledPlugin>();\n  private registry: StateContainerRegistry;\n  private lifecycleUnsubscribers: (() => void)[] = [];\n\n  /**\n   * Per-container channel-bridge bookkeeping, subscribed at `created` and\n   * torn down at `disposed`/`destroy()`. Holds the rolling `prevState`\n   * snapshot handed to plugins on each flush.\n   *\n   * Strong, not a `WeakMap`, because `destroy()` must enumerate live bridges\n   * to unsubscribe them; entries are removed on `disposed`, so this never\n   * outlives the registry's own reference.\n   */\n  private containerBridges = new Map<\n    StateContainer<any, any, any>,\n    ContainerBridge\n  >();\n\n  /**\n   * One `PluginContext` per container, safe to reuse since it closes only\n   * over `registry`/`container`, both stable for the container's lifetime.\n   */\n  private contextCache = new WeakMap<\n    StateContainer<any, any, any>,\n    PluginContext\n  >();\n\n  /**\n   * Create a new PluginManager\n   * @param registry - The StateContainerRegistry to monitor for lifecycle events\n   */\n  constructor(registry: StateContainerRegistry) {\n    this.registry = registry;\n    this.setupLifecycleHooks();\n  }\n\n  /**\n   * Install a plugin with optional configuration\n   * @param plugin - The plugin to install\n   * @param config - Optional plugin configuration\n   * @throws Error if plugin is already installed\n   */\n  install(plugin: BlacPlugin, config: PluginConfig = {}): void {\n    const effectiveConfig: PluginConfig = {\n      enabled: true,\n      environment: 'all',\n      ...config,\n    };\n\n    if (!this.shouldEnablePlugin(effectiveConfig)) {\n      if (IS_DEV) {\n        console.log(\n          `[BlaC] Plugin \"${plugin.name}\" skipped (environment mismatch)`,\n        );\n      }\n      return;\n    }\n\n    if (this.plugins.has(plugin.name)) {\n      throw new Error(`Plugin \"${plugin.name}\" is already installed`);\n    }\n\n    const installContext = this.buildContext(undefined);\n\n    if (plugin.onInstall) {\n      try {\n        plugin.onInstall(installContext);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error installing plugin \"${plugin.name}\":`,\n          error,\n        );\n        throw error;\n      }\n    }\n\n    this.plugins.set(plugin.name, {\n      plugin,\n      config: effectiveConfig,\n      installContext,\n    });\n    this.backfillPlugin(plugin);\n\n    if (IS_DEV) {\n      console.log(\n        `[BlaC] Plugin \"${plugin.name}\" v${plugin.version} installed`,\n      );\n    }\n  }\n\n  /**\n   * Uninstall a plugin by name\n   * @param pluginName - The name of the plugin to uninstall\n   * @throws Error if plugin is not installed\n   */\n  uninstall(pluginName: string): void {\n    const installed = this.plugins.get(pluginName);\n    if (!installed) {\n      throw new Error(`Plugin \"${pluginName}\" is not installed`);\n    }\n\n    if (installed.plugin.onUninstall) {\n      try {\n        installed.plugin.onUninstall();\n      } catch (error) {\n        console.error(\n          `[BlaC] Error uninstalling plugin \"${pluginName}\":`,\n          error,\n        );\n      }\n    }\n\n    this.plugins.delete(pluginName);\n    if (!this.hasStateChangePlugin()) this.detachAllStateBridges();\n    if (IS_DEV) {\n      console.log(`[BlaC] Plugin \"${pluginName}\" uninstalled`);\n    }\n  }\n\n  /**\n   * Get an installed plugin by name\n   * @param pluginName - The name of the plugin to retrieve\n   * @returns The plugin instance or undefined if not found\n   */\n  getPlugin(pluginName: string): BlacPlugin | undefined {\n    return this.plugins.get(pluginName)?.plugin;\n  }\n\n  /**\n   * Get all installed plugins\n   * @returns Array of all installed plugins\n   */\n  getAllPlugins(): BlacPlugin[] {\n    return Array.from(this.plugins.values()).map((p) => p.plugin);\n  }\n\n  /**\n   * Check if a plugin is installed\n   * @param pluginName - The name of the plugin to check\n   * @returns true if the plugin is installed\n   */\n  hasPlugin(pluginName: string): boolean {\n    return this.plugins.has(pluginName);\n  }\n\n  /**\n   * Uninstall all plugins\n   */\n  clear(): void {\n    for (const name of this.plugins.keys()) {\n      this.uninstall(name);\n    }\n  }\n\n  destroy(): void {\n    this.clear();\n    for (const unsub of this.lifecycleUnsubscribers) {\n      unsub();\n    }\n    this.lifecycleUnsubscribers = [];\n  }\n\n  /**\n   * Wire registry lifecycle events into plugin dispatch.\n   *\n   * `onStateChange` is not wired through `registry.on('stateChanged', …)` —\n   * that event lacks the `PathSet` payload. Instead each `created` subscribes\n   * to the container's channel directly for `paths`, pairing it with\n   * `(prev, next)` from the per-container snapshot.\n   */\n  private setupLifecycleHooks(): void {\n    this.lifecycleUnsubscribers = [\n      this.registry.on('created', (instance) => {\n        if (this.hasStateChangePlugin()) this.attachStateBridge(instance);\n        this.notifyPlugins('onCreated', instance);\n      }),\n      this.registry.on('disposed', (instance) => {\n        this.notifyPlugins('onDestroyed', instance);\n        this.detachStateBridge(instance);\n      }),\n      this.registry.on('refAcquired', (instance, refId) => {\n        this.notifyPlugins('onRefAcquired', instance, refId);\n      }),\n      this.registry.on('refReleased', (instance, refId) => {\n        this.notifyPlugins('onRefReleased', instance, refId);\n      }),\n      this.registry.on('depsChanged', (instance, previousDeps, currentDeps) => {\n        this.notifyPlugins(\n          'onDepsChanged',\n          instance,\n          previousDeps,\n          currentDeps,\n        );\n      }),\n      this.registry.on(\n        'hydrationChanged',\n        (instance, status, previousStatus) => {\n          this.notifyPlugins(\n            'onHydrationChange',\n            instance,\n            status,\n            previousStatus,\n          );\n        },\n      ),\n      this.registry.on('activated', (instance, signal) => {\n        this.notifyPlugins('onActivate', instance, signal);\n      }),\n      this.registry.on('deactivated', (instance) => {\n        this.notifyPlugins('onDeactivate', instance);\n      }),\n    ];\n  }\n\n  /**\n   * Subscribe to the container's channel with `ALL_PATHS` interest so it\n   * fires on every flush. `prev` is the snapshot from the previous flush (or\n   * create-time for the first); the channel's `paths` is passed straight\n   * through to plugins.\n   */\n  private attachStateBridge(container: StateContainer<any, any, any>): void {\n    // Defensive: if a container is somehow created twice (it shouldn't be),\n    // don't double-subscribe — the existing bridge is canonical.\n    if (this.containerBridges.has(container)) return;\n\n    const bridge: ContainerBridge = {\n      unsub: () => {},\n      prevState: container.state,\n    };\n    this.containerBridges.set(container, bridge);\n\n    bridge.unsub = container.channel.subscribe(\n      () => ALL_PATHS,\n      (paths) => this.dispatchStateChange(container, paths),\n    );\n  }\n\n  private detachStateBridge(container: StateContainer<any, any, any>): void {\n    const bridge = this.containerBridges.get(container);\n    if (!bridge) return;\n    bridge.unsub();\n    this.containerBridges.delete(container);\n  }\n\n  // Bridges cost every container its single-consumer skip, so they exist only\n  // while some installed plugin implements `onStateChange`.\n  private hasStateChangePlugin(): boolean {\n    for (const { plugin } of this.plugins.values()) {\n      if (plugin.onStateChange) return true;\n    }\n    return false;\n  }\n\n  private detachAllStateBridges(): void {\n    for (const bridge of this.containerBridges.values()) {\n      bridge.unsub();\n    }\n    this.containerBridges.clear();\n  }\n\n  /**\n   * Backfill a newly-installed plugin with existing instances: attach the\n   * state bridge (idempotent) if it implements `onStateChange`, and invoke\n   * `onCreated` for each. Scoped to this plugin only — `notifyPlugins` would\n   * wrongly re-notify every plugin of every instance.\n   */\n  private backfillPlugin(plugin: BlacPlugin): void {\n    if (!plugin.onStateChange && !plugin.onCreated) return;\n    for (const Type of this.registry.getTypes()) {\n      for (const instance of this.registry.getAll(Type)) {\n        // getAll returns the readonly public view; internal bridging needs the\n        // real container (same friction the `as any` in queryInstances handles).\n        const container = instance as StateContainer<any, any, any>;\n        if (plugin.onStateChange) this.attachStateBridge(container);\n\n        if (!plugin.onCreated) continue;\n        try {\n          plugin.onCreated(this.buildContext(container));\n        } catch (error) {\n          console.error(\n            `[BlaC] Error in plugin \"${plugin.name}\" onCreated (backfill):`,\n            error,\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Channel-flush callback. Hands `(prev, next, paths)` to every enabled\n   * plugin's `onStateChange`, then updates `prevState` for the next flush.\n   * `prev` is captured once and reused across plugins, so every plugin sees\n   * the same values regardless of dispatch order.\n   */\n  private dispatchStateChange(\n    container: StateContainer<any, any, any>,\n    paths: PathSet,\n  ): void {\n    const bridge = this.containerBridges.get(container);\n    if (!bridge) return;\n\n    const prev = bridge.prevState;\n    const next = container.state;\n    bridge.prevState = next;\n\n    let ctx: PluginContext | undefined;\n    for (const { plugin, config } of this.plugins.values()) {\n      if (!config.enabled) continue;\n      // eslint-disable-next-line @typescript-eslint/unbound-method -- invoked via .call below\n      const hook = plugin.onStateChange;\n      if (typeof hook !== 'function') continue;\n\n      try {\n        ctx ??= this.buildContext(container);\n        hook.call(plugin, ctx, prev, next, paths);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error in plugin \"${plugin.name}\" onStateChange:`,\n          error,\n        );\n      }\n    }\n  }\n\n  /**\n   * Notify all plugins of a lifecycle event. Builds a `PluginContext` lazily\n   * on the first matching hook and reuses it for the rest of this dispatch —\n   * zero builds if no enabled plugin implements `hookName`.\n   */\n  private notifyPlugins(\n    hookName: Exclude<keyof BlacPlugin, 'onStateChange'>,\n    instance: StateContainer<any, any, any>,\n    ...extraArgs: any[]\n  ): void {\n    let ctx: PluginContext | undefined;\n    for (const { plugin, config } of this.plugins.values()) {\n      if (!config.enabled) continue;\n\n      const hook = plugin[hookName];\n      if (typeof hook !== 'function') continue;\n\n      try {\n        ctx ??= this.buildContext(instance);\n        (hook as any).call(plugin, ctx, ...extraArgs);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error in plugin \"${plugin.name}\" ${hookName}:`,\n          error,\n        );\n      }\n    }\n  }\n\n  /**\n   * Get the `PluginContext` for a focal container, building it once and\n   * reusing it thereafter (evicted via the `WeakMap` when the container\n   * dies). `undefined` (install-time) is never cached.\n   */\n  private buildContext(\n    container: StateContainer<any, any, any> | undefined,\n  ): PluginContext {\n    if (container !== undefined) {\n      const cached = this.contextCache.get(container);\n      if (cached) return cached;\n    }\n    const context = this.createContext(container);\n    if (container !== undefined) this.contextCache.set(container, context);\n    return context;\n  }\n\n  private createContext(\n    container: StateContainer<any, any, any> | undefined,\n  ): PluginContext {\n    const registry = this.registry;\n    return {\n      container,\n\n      getInstanceMetadata: (\n        instance: StateContainer<any, any, any>,\n      ): InstanceMetadata => {\n        return {\n          id: instance.$blac.id,\n          className: getBlacName(\n            instance.constructor as StateContainerConstructor,\n          ),\n          isDisposed: instance.$blac.disposed,\n          name: instance.$blac.name,\n          createdAt: instance.$blac.createdAt,\n          state: instance.state,\n          hydrationStatus: instance.$blac.hydration.status,\n          isHydrated: instance.$blac.hydration.isHydrated,\n          hydrationError: instance.$blac.hydration.error,\n          changedWhileHydrating: instance.$blac.hydration.changedWhileHydrating,\n          args: instance.args,\n        };\n      },\n\n      getState: <S extends object = any>(instance: StateContainer<S>): S => {\n        return instance.state;\n      },\n\n      getHydrationStatus: (instance: StateContainer<any, any, any>) => {\n        return instance.$blac.hydration.status;\n      },\n\n      startHydration: (instance: StateContainer<any, any, any>) => {\n        instance.$blac.hydration.begin();\n      },\n\n      applyHydratedState: <S extends object = any>(\n        instance: StateContainer<S>,\n        state: S,\n      ): boolean => {\n        return instance.$blac.hydration.apply(state);\n      },\n\n      finishHydration: (instance: StateContainer<any, any, any>) => {\n        instance.$blac.hydration.finish();\n      },\n\n      failHydration: (\n        instance: StateContainer<any, any, any>,\n        error: Error,\n      ) => {\n        instance.$blac.hydration.fail(error);\n      },\n\n      waitForHydration: (instance: StateContainer<any, any, any>) => {\n        return instance.$blac.hydration.wait();\n      },\n\n      queryInstances: <T extends StateContainer<any, any, any>>(\n        typeClass: new (...args: any[]) => T,\n      ): T[] => {\n        return registry.getAll(typeClass as any);\n      },\n\n      getAllTypes: () => {\n        return registry.getTypes();\n      },\n\n      getStats: () => {\n        return registry.getStats();\n      },\n\n      getRefIds: (instanceId: string): string[] => {\n        return registry.getRefIdsById(instanceId);\n      },\n    };\n  }\n\n  /**\n   * Check if plugin should be enabled based on environment\n   */\n  private shouldEnablePlugin(config: PluginConfig): boolean {\n    if (!config.enabled) return false;\n    if (config.environment === 'all') return true;\n\n    const currentEnv = this.getCurrentEnvironment();\n    return currentEnv === config.environment;\n  }\n\n  /**\n   * Same rule as `IS_DEV`: an unknown environment counts as production.\n   */\n  private getCurrentEnvironment(): 'development' | 'production' | 'test' {\n    const env = readNodeEnv();\n    if (env === undefined || env === 'production') return 'production';\n    return env === 'test' ? 'test' : 'development';\n  }\n}\n\n/**\n * Create a plugin manager instance\n * @param registry - The StateContainerRegistry to monitor for lifecycle events\n * @returns A new PluginManager instance\n */\nexport function createPluginManager(\n  registry: StateContainerRegistry,\n): PluginManager {\n  return new PluginManager(registry);\n}\n","/**\n * Plugin system utilities for extending BlaC functionality.\n * Import from `@blac/core/plugins`.\n *\n * @example\n * ```typescript\n * import { PluginManager, getPluginManager, type BlacPlugin } from '@blac/core/plugins';\n *\n * const myPlugin: BlacPlugin = {\n *   name: 'my-plugin',\n *   onCreated(context) {\n *     console.log('Instance created:', context.container);\n *   },\n * };\n *\n * getPluginManager().install(myPlugin);\n * ```\n *\n * @packageDocumentation\n */\n\nimport { createPluginManager, PluginManager } from './plugin/PluginManager';\nimport {\n  globalRegistry,\n  type StateContainerRegistry,\n} from './core/StateContainerRegistry';\n\nexport { PluginManager } from './plugin/PluginManager';\nexport type {\n  BlacPlugin,\n  BlacPluginWithInit,\n  PluginContext,\n  PluginConfig,\n  InstanceMetadata,\n} from './plugin/BlacPlugin';\n\nconst pluginManagers = new WeakMap<StateContainerRegistry, PluginManager>();\n\n/**\n * Get the plugin manager for a registry (the global one by default). Plugins\n * only observe the registry they are installed on, so install them again on\n * a scoped registry (e.g. one passed to `RegistryProvider`).\n */\nexport function getPluginManager(\n  registry: StateContainerRegistry = globalRegistry,\n): PluginManager {\n  let manager = pluginManagers.get(registry);\n  if (!manager) {\n    manager = createPluginManager(registry);\n    pluginManagers.set(registry, manager);\n  }\n  return manager;\n}\n"],"mappings":"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"}
+{"version":3,"file":"plugins.js","names":[],"sources":["../src/plugin/PluginManager.ts","../src/plugins.ts"],"sourcesContent":["import { ALL_PATHS, type PathSet } from '@dirtytalk/structural';\nimport type { StateContainer } from '../core/StateContainer';\nimport { IS_DEV, readNodeEnv } from '../constants';\nimport { getBlacName } from '../utils/static-props';\nimport type { StateContainerConstructor } from '../types/utilities';\nimport type { StateContainerRegistry } from '../core/StateContainerRegistry';\nimport type {\n  BlacPlugin,\n  PluginContext,\n  PluginConfig,\n  InstanceMetadata,\n} from './BlacPlugin';\n\n/**\n * Internal structure for tracking installed plugins.\n *\n * `installContext` is the context handed to `onInstall` — it has no\n * `container`. Per-container contexts are built on demand by\n * `buildContext()` so each event carries the right focal container\n * without mutating a shared object.\n * @internal\n */\ninterface InstalledPlugin {\n  plugin: BlacPlugin;\n  config: PluginConfig;\n  installContext: PluginContext;\n}\n\n/**\n * Per-container bookkeeping for the channel-bridge plugin dispatcher.\n *\n * - `unsub` tears down the channel subscription on dispose.\n * - `prevState` is the state snapshot the manager will hand plugins as\n *   `prev` on the next flush; it is updated to the post-flush state after\n *   each dispatch.\n * @internal\n */\ninterface ContainerBridge {\n  unsub: () => void;\n  prevState: any;\n}\n\n/**\n * Manages plugin lifecycle for the BlaC state management system.\n *\n * Hooks into registry lifecycle events (synchronous) and per-container\n * channel flushes (microtask-coalesced): while at least one installed\n * plugin implements `onStateChange`, the manager subscribes each container\n * with `ALL_PATHS` interest and dispatches\n * `onStateChange(ctx, prev, next, paths)` on every flush.\n *\n * `ALL_PATHS` interest wakes the bridge on every flush of every container —\n * an intended trade-off for plugins that genuinely want every change\n * (devtools/persist). Plugins that want low overhead should remain\n * uninstalled or environment-gated.\n *\n * @example\n * ```ts\n * const manager = createPluginManager(registry);\n * manager.install(myPlugin, { environment: 'development' });\n * ```\n */\nexport class PluginManager {\n  private plugins = new Map<string, InstalledPlugin>();\n  private registry: StateContainerRegistry;\n  private lifecycleUnsubscribers: (() => void)[] = [];\n\n  /**\n   * Per-container channel-bridge bookkeeping, subscribed at `created` and\n   * torn down at `disposed`/`destroy()`. Holds the rolling `prevState`\n   * snapshot handed to plugins on each flush.\n   *\n   * Strong, not a `WeakMap`, because `destroy()` must enumerate live bridges\n   * to unsubscribe them; entries are removed on `disposed`, so this never\n   * outlives the registry's own reference.\n   */\n  private containerBridges = new Map<\n    StateContainer<any, any, any>,\n    ContainerBridge\n  >();\n\n  /**\n   * One `PluginContext` per container, safe to reuse since it closes only\n   * over `registry`/`container`, both stable for the container's lifetime.\n   */\n  private contextCache = new WeakMap<\n    StateContainer<any, any, any>,\n    PluginContext\n  >();\n\n  /**\n   * Create a new PluginManager\n   * @param registry - The StateContainerRegistry to monitor for lifecycle events\n   */\n  constructor(registry: StateContainerRegistry) {\n    this.registry = registry;\n    this.setupLifecycleHooks();\n  }\n\n  /**\n   * Install a plugin with optional configuration\n   * @param plugin - The plugin to install\n   * @param config - Optional plugin configuration\n   * @throws Error if plugin is already installed\n   */\n  install(plugin: BlacPlugin, config: PluginConfig = {}): void {\n    const effectiveConfig: PluginConfig = {\n      enabled: true,\n      environment: 'all',\n      ...config,\n    };\n\n    if (!this.shouldEnablePlugin(effectiveConfig)) {\n      if (IS_DEV) {\n        console.log(\n          `[BlaC] Plugin \"${plugin.name}\" skipped (environment mismatch)`,\n        );\n      }\n      return;\n    }\n\n    if (this.plugins.has(plugin.name)) {\n      throw new Error(`Plugin \"${plugin.name}\" is already installed`);\n    }\n\n    const installContext = this.buildContext(undefined);\n\n    if (plugin.onInstall) {\n      try {\n        plugin.onInstall(installContext);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error installing plugin \"${plugin.name}\":`,\n          error,\n        );\n        throw error;\n      }\n    }\n\n    this.plugins.set(plugin.name, {\n      plugin,\n      config: effectiveConfig,\n      installContext,\n    });\n    this.backfillPlugin(plugin);\n\n    if (IS_DEV) {\n      console.log(\n        `[BlaC] Plugin \"${plugin.name}\" v${plugin.version} installed`,\n      );\n    }\n  }\n\n  /**\n   * Uninstall a plugin by name\n   * @param pluginName - The name of the plugin to uninstall\n   * @throws Error if plugin is not installed\n   */\n  uninstall(pluginName: string): void {\n    const installed = this.plugins.get(pluginName);\n    if (!installed) {\n      throw new Error(`Plugin \"${pluginName}\" is not installed`);\n    }\n\n    if (installed.plugin.onUninstall) {\n      try {\n        installed.plugin.onUninstall();\n      } catch (error) {\n        console.error(\n          `[BlaC] Error uninstalling plugin \"${pluginName}\":`,\n          error,\n        );\n      }\n    }\n\n    this.plugins.delete(pluginName);\n    if (!this.hasStateChangePlugin()) this.detachAllStateBridges();\n    if (IS_DEV) {\n      console.log(`[BlaC] Plugin \"${pluginName}\" uninstalled`);\n    }\n  }\n\n  /**\n   * Get an installed plugin by name\n   * @param pluginName - The name of the plugin to retrieve\n   * @returns The plugin instance or undefined if not found\n   */\n  getPlugin(pluginName: string): BlacPlugin | undefined {\n    return this.plugins.get(pluginName)?.plugin;\n  }\n\n  /**\n   * Get all installed plugins\n   * @returns Array of all installed plugins\n   */\n  getAllPlugins(): BlacPlugin[] {\n    return Array.from(this.plugins.values()).map((p) => p.plugin);\n  }\n\n  /**\n   * Check if a plugin is installed\n   * @param pluginName - The name of the plugin to check\n   * @returns true if the plugin is installed\n   */\n  hasPlugin(pluginName: string): boolean {\n    return this.plugins.has(pluginName);\n  }\n\n  /**\n   * Uninstall all plugins\n   */\n  clear(): void {\n    for (const name of this.plugins.keys()) {\n      this.uninstall(name);\n    }\n  }\n\n  destroy(): void {\n    this.clear();\n    for (const unsub of this.lifecycleUnsubscribers) {\n      unsub();\n    }\n    this.lifecycleUnsubscribers = [];\n  }\n\n  /**\n   * Wire registry lifecycle events into plugin dispatch.\n   *\n   * `onStateChange` is not wired through `registry.on('stateChanged', …)` —\n   * that event lacks the `PathSet` payload. Instead each `created` subscribes\n   * to the container's channel directly for `paths`, pairing it with\n   * `(prev, next)` from the per-container snapshot.\n   */\n  private setupLifecycleHooks(): void {\n    this.lifecycleUnsubscribers = [\n      this.registry.on('created', (instance) => {\n        if (this.hasStateChangePlugin()) this.attachStateBridge(instance);\n        this.notifyPlugins('onCreated', instance);\n      }),\n      this.registry.on('disposed', (instance) => {\n        this.notifyPlugins('onDestroyed', instance);\n        this.detachStateBridge(instance);\n      }),\n      this.registry.on('refAcquired', (instance, refId) => {\n        this.notifyPlugins('onRefAcquired', instance, refId);\n      }),\n      this.registry.on('refReleased', (instance, refId) => {\n        this.notifyPlugins('onRefReleased', instance, refId);\n      }),\n      this.registry.on('depsChanged', (instance, previousDeps, currentDeps) => {\n        this.notifyPlugins(\n          'onDepsChanged',\n          instance,\n          previousDeps,\n          currentDeps,\n        );\n      }),\n      this.registry.on(\n        'hydrationChanged',\n        (instance, status, previousStatus) => {\n          this.notifyPlugins(\n            'onHydrationChange',\n            instance,\n            status,\n            previousStatus,\n          );\n        },\n      ),\n      this.registry.on('activated', (instance, signal) => {\n        this.notifyPlugins('onActivate', instance, signal);\n      }),\n      this.registry.on('deactivated', (instance) => {\n        this.notifyPlugins('onDeactivate', instance);\n      }),\n    ];\n  }\n\n  /**\n   * Subscribe to the container's channel with `ALL_PATHS` interest so it\n   * fires on every flush. `prev` is the snapshot from the previous flush (or\n   * create-time for the first); the channel's `paths` is passed straight\n   * through to plugins.\n   */\n  private attachStateBridge(container: StateContainer<any, any, any>): void {\n    // Defensive: if a container is somehow created twice (it shouldn't be),\n    // don't double-subscribe — the existing bridge is canonical.\n    if (this.containerBridges.has(container)) return;\n\n    const bridge: ContainerBridge = {\n      unsub: () => {},\n      prevState: container.state,\n    };\n    this.containerBridges.set(container, bridge);\n\n    bridge.unsub = container.channel.subscribe(\n      () => ALL_PATHS,\n      (paths) => this.dispatchStateChange(container, paths),\n    );\n  }\n\n  private detachStateBridge(container: StateContainer<any, any, any>): void {\n    const bridge = this.containerBridges.get(container);\n    if (!bridge) return;\n    bridge.unsub();\n    this.containerBridges.delete(container);\n  }\n\n  // Bridges cost every container a callback per flush, so they exist only\n  // while some installed plugin implements `onStateChange`.\n  private hasStateChangePlugin(): boolean {\n    for (const { plugin } of this.plugins.values()) {\n      if (plugin.onStateChange) return true;\n    }\n    return false;\n  }\n\n  private detachAllStateBridges(): void {\n    for (const bridge of this.containerBridges.values()) {\n      bridge.unsub();\n    }\n    this.containerBridges.clear();\n  }\n\n  /**\n   * Backfill a newly-installed plugin with existing instances: attach the\n   * state bridge (idempotent) if it implements `onStateChange`, and invoke\n   * `onCreated` for each. Scoped to this plugin only — `notifyPlugins` would\n   * wrongly re-notify every plugin of every instance.\n   */\n  private backfillPlugin(plugin: BlacPlugin): void {\n    if (!plugin.onStateChange && !plugin.onCreated) return;\n    for (const Type of this.registry.getTypes()) {\n      for (const instance of this.registry.getAll(Type)) {\n        // getAll returns the readonly public view; internal bridging needs the\n        // real container (same friction the `as any` in queryInstances handles).\n        const container = instance as StateContainer<any, any, any>;\n        if (plugin.onStateChange) this.attachStateBridge(container);\n\n        if (!plugin.onCreated) continue;\n        try {\n          plugin.onCreated(this.buildContext(container));\n        } catch (error) {\n          console.error(\n            `[BlaC] Error in plugin \"${plugin.name}\" onCreated (backfill):`,\n            error,\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Channel-flush callback. Hands `(prev, next, paths)` to every enabled\n   * plugin's `onStateChange`, then updates `prevState` for the next flush.\n   * `prev` is captured once and reused across plugins, so every plugin sees\n   * the same values regardless of dispatch order.\n   */\n  private dispatchStateChange(\n    container: StateContainer<any, any, any>,\n    paths: PathSet,\n  ): void {\n    const bridge = this.containerBridges.get(container);\n    if (!bridge) return;\n\n    const prev = bridge.prevState;\n    const next = container.state;\n    bridge.prevState = next;\n\n    let ctx: PluginContext | undefined;\n    for (const { plugin, config } of this.plugins.values()) {\n      if (!config.enabled) continue;\n      // eslint-disable-next-line @typescript-eslint/unbound-method -- invoked via .call below\n      const hook = plugin.onStateChange;\n      if (typeof hook !== 'function') continue;\n\n      try {\n        ctx ??= this.buildContext(container);\n        hook.call(plugin, ctx, prev, next, paths);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error in plugin \"${plugin.name}\" onStateChange:`,\n          error,\n        );\n      }\n    }\n  }\n\n  /**\n   * Notify all plugins of a lifecycle event. Builds a `PluginContext` lazily\n   * on the first matching hook and reuses it for the rest of this dispatch —\n   * zero builds if no enabled plugin implements `hookName`.\n   */\n  private notifyPlugins(\n    hookName: Exclude<keyof BlacPlugin, 'onStateChange'>,\n    instance: StateContainer<any, any, any>,\n    ...extraArgs: any[]\n  ): void {\n    let ctx: PluginContext | undefined;\n    for (const { plugin, config } of this.plugins.values()) {\n      if (!config.enabled) continue;\n\n      const hook = plugin[hookName];\n      if (typeof hook !== 'function') continue;\n\n      try {\n        ctx ??= this.buildContext(instance);\n        (hook as any).call(plugin, ctx, ...extraArgs);\n      } catch (error) {\n        console.error(\n          `[BlaC] Error in plugin \"${plugin.name}\" ${hookName}:`,\n          error,\n        );\n      }\n    }\n  }\n\n  /**\n   * Get the `PluginContext` for a focal container, building it once and\n   * reusing it thereafter (evicted via the `WeakMap` when the container\n   * dies). `undefined` (install-time) is never cached.\n   */\n  private buildContext(\n    container: StateContainer<any, any, any> | undefined,\n  ): PluginContext {\n    if (container !== undefined) {\n      const cached = this.contextCache.get(container);\n      if (cached) return cached;\n    }\n    const context = this.createContext(container);\n    if (container !== undefined) this.contextCache.set(container, context);\n    return context;\n  }\n\n  private createContext(\n    container: StateContainer<any, any, any> | undefined,\n  ): PluginContext {\n    const registry = this.registry;\n    return {\n      container,\n\n      getInstanceMetadata: (\n        instance: StateContainer<any, any, any>,\n      ): InstanceMetadata => {\n        return {\n          id: instance.$blac.id,\n          className: getBlacName(\n            instance.constructor as StateContainerConstructor,\n          ),\n          isDisposed: instance.$blac.disposed,\n          name: instance.$blac.name,\n          createdAt: instance.$blac.createdAt,\n          state: instance.state,\n          hydrationStatus: instance.$blac.hydration.status,\n          isHydrated: instance.$blac.hydration.isHydrated,\n          hydrationError: instance.$blac.hydration.error,\n          changedWhileHydrating: instance.$blac.hydration.changedWhileHydrating,\n          args: instance.args,\n        };\n      },\n\n      getState: <S extends object = any>(instance: StateContainer<S>): S => {\n        return instance.state;\n      },\n\n      getHydrationStatus: (instance: StateContainer<any, any, any>) => {\n        return instance.$blac.hydration.status;\n      },\n\n      startHydration: (instance: StateContainer<any, any, any>) => {\n        instance.$blac.hydration.begin();\n      },\n\n      applyHydratedState: <S extends object = any>(\n        instance: StateContainer<S>,\n        state: S,\n      ): boolean => {\n        return instance.$blac.hydration.apply(state);\n      },\n\n      finishHydration: (instance: StateContainer<any, any, any>) => {\n        instance.$blac.hydration.finish();\n      },\n\n      failHydration: (\n        instance: StateContainer<any, any, any>,\n        error: Error,\n      ) => {\n        instance.$blac.hydration.fail(error);\n      },\n\n      waitForHydration: (instance: StateContainer<any, any, any>) => {\n        return instance.$blac.hydration.wait();\n      },\n\n      queryInstances: <T extends StateContainer<any, any, any>>(\n        typeClass: new (...args: any[]) => T,\n      ): T[] => {\n        return registry.getAll(typeClass as any);\n      },\n\n      getAllTypes: () => {\n        return registry.getTypes();\n      },\n\n      getStats: () => {\n        return registry.getStats();\n      },\n\n      getRefIds: (instanceId: string): string[] => {\n        return registry.getRefIdsById(instanceId);\n      },\n    };\n  }\n\n  /**\n   * Check if plugin should be enabled based on environment\n   */\n  private shouldEnablePlugin(config: PluginConfig): boolean {\n    if (!config.enabled) return false;\n    if (config.environment === 'all') return true;\n\n    const currentEnv = this.getCurrentEnvironment();\n    return currentEnv === config.environment;\n  }\n\n  /**\n   * Same rule as `IS_DEV`: an unknown environment counts as production.\n   */\n  private getCurrentEnvironment(): 'development' | 'production' | 'test' {\n    const env = readNodeEnv();\n    if (env === undefined || env === 'production') return 'production';\n    return env === 'test' ? 'test' : 'development';\n  }\n}\n\n/**\n * Create a plugin manager instance\n * @param registry - The StateContainerRegistry to monitor for lifecycle events\n * @returns A new PluginManager instance\n */\nexport function createPluginManager(\n  registry: StateContainerRegistry,\n): PluginManager {\n  return new PluginManager(registry);\n}\n","/**\n * Plugin system utilities for extending BlaC functionality.\n * Import from `@blac/core/plugins`.\n *\n * @example\n * ```typescript\n * import { PluginManager, getPluginManager, type BlacPlugin } from '@blac/core/plugins';\n *\n * const myPlugin: BlacPlugin = {\n *   name: 'my-plugin',\n *   onCreated(context) {\n *     console.log('Instance created:', context.container);\n *   },\n * };\n *\n * getPluginManager().install(myPlugin);\n * ```\n *\n * @packageDocumentation\n */\n\nimport { createPluginManager, PluginManager } from './plugin/PluginManager';\nimport {\n  globalRegistry,\n  type StateContainerRegistry,\n} from './core/StateContainerRegistry';\n\nexport { PluginManager } from './plugin/PluginManager';\nexport type {\n  BlacPlugin,\n  BlacPluginWithInit,\n  PluginContext,\n  PluginConfig,\n  InstanceMetadata,\n} from './plugin/BlacPlugin';\n\nconst pluginManagers = new WeakMap<StateContainerRegistry, PluginManager>();\n\n/**\n * Get the plugin manager for a registry (the global one by default). Plugins\n * only observe the registry they are installed on, so install them again on\n * a scoped registry (e.g. one passed to `RegistryProvider`).\n */\nexport function getPluginManager(\n  registry: StateContainerRegistry = globalRegistry,\n): PluginManager {\n  let manager = pluginManagers.get(registry);\n  if (!manager) {\n    manager = createPluginManager(registry);\n    pluginManagers.set(registry, manager);\n  }\n  return manager;\n}\n"],"mappings":"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"}

package/dist/registry/index.d.ts

@@ -4,5 +4,5 @@ export type { BorrowTarget } from './borrow';
 export { ensure } from './ensure';
 export { release } from './release';
 export { hasInstance, getRefCount, getRefIds, getAll, forEach, } from './queries';
-export { clear, clearAll, register } from './management';
+export { clear, clearAll, clearWhere, register } from './management';
 export { getRegistry, setRegistry, getStats } from './config';

package/dist/registry/management.d.ts

@@ -1,6 +1,8 @@
+import type { StateContainer } from '../core/StateContainer';
 import type { StateContainerConstructor } from '../types/utilities';
 export declare function clear<T extends StateContainerConstructor>(BlocClass: T): void;
 export declare function clearAll(): void;
+export declare function clearWhere(predicate: (instance: StateContainer<any, any, any>) => boolean): void;
 /**
  * @public
  */