@blac/core 2.0.11 → 2.0.13

package/dist/config-De9oQ6Ki.js.map

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

package/dist/config-DokTzpr8.cjs

@@ -0,0 +1,32 @@
+//#region src/registry/config.ts
+let _registry = require("./StateContainerRegistry-pRNxHNFD.cjs").globalRegistry;
+function getRegistry() {
+	return _registry;
+}
+function setRegistry(registry) {
+	_registry = registry;
+}
+function getStats() {
+	return _registry.getStats();
+}
+//#endregion
+Object.defineProperty(exports, "getRegistry", {
+	enumerable: true,
+	get: function() {
+		return getRegistry;
+	}
+});
+Object.defineProperty(exports, "getStats", {
+	enumerable: true,
+	get: function() {
+		return getStats;
+	}
+});
+Object.defineProperty(exports, "setRegistry", {
+	enumerable: true,
+	get: function() {
+		return setRegistry;
+	}
+});
+
+//# sourceMappingURL=config-DokTzpr8.cjs.map

package/dist/config-DokTzpr8.cjs.map

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

package/dist/config-DslYBm4Z.js

@@ -0,0 +1,16 @@
+import { r as globalRegistry } from "./StateContainerRegistry-Ck2-XmT_.js";
+//#region src/registry/config.ts
+let _registry = globalRegistry;
+function getRegistry() {
+	return _registry;
+}
+function setRegistry(registry) {
+	_registry = registry;
+}
+function getStats() {
+	return _registry.getStats();
+}
+//#endregion
+export { getStats as n, setRegistry as r, getRegistry as t };
+
+//# sourceMappingURL=config-DslYBm4Z.js.map

package/dist/config-DslYBm4Z.js.map

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

package/dist/config-H6FAqbW4.cjs

@@ -0,0 +1,32 @@
+//#region src/registry/config.ts
+let _registry = require("./StateContainerRegistry-CX2CBOmv.cjs").globalRegistry;
+function getRegistry() {
+	return _registry;
+}
+function setRegistry(registry) {
+	_registry = registry;
+}
+function getStats() {
+	return _registry.getStats();
+}
+//#endregion
+Object.defineProperty(exports, "getRegistry", {
+	enumerable: true,
+	get: function() {
+		return getRegistry;
+	}
+});
+Object.defineProperty(exports, "getStats", {
+	enumerable: true,
+	get: function() {
+		return getStats;
+	}
+});
+Object.defineProperty(exports, "setRegistry", {
+	enumerable: true,
+	get: function() {
+		return setRegistry;
+	}
+});
+
+//# sourceMappingURL=config-H6FAqbW4.cjs.map

package/dist/config-H6FAqbW4.cjs.map

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

package/dist/config-XQua95Xz.js

@@ -1,16 +1,16 @@
-import { r as globalRegistry } from "./StateContainerRegistry-DOkDGng-.js";
+import { r as globalRegistry } from './StateContainerRegistry-DOkDGng-.js';
 //#region src/registry/config.ts
 let _registry = globalRegistry;
 function getRegistry() {
-	return _registry;
+  return _registry;
 }
 function setRegistry(registry) {
-	_registry = registry;
+  _registry = registry;
 }
 function getStats() {
-	return _registry.getStats();
+  return _registry.getStats();
 }
 //#endregion
 export { getStats as n, setRegistry as r, getRegistry as t };
 
-//# sourceMappingURL=config-XQua95Xz.js.map
+//# sourceMappingURL=config-XQua95Xz.js.map

package/dist/config-Yp645dGK.js

@@ -0,0 +1,16 @@
+import { r as globalRegistry } from "./StateContainerRegistry-BAcxouCu.js";
+//#region src/registry/config.ts
+let _registry = globalRegistry;
+function getRegistry() {
+	return _registry;
+}
+function setRegistry(registry) {
+	_registry = registry;
+}
+function getStats() {
+	return _registry.getStats();
+}
+//#endregion
+export { getStats as n, setRegistry as r, getRegistry as t };
+
+//# sourceMappingURL=config-Yp645dGK.js.map

package/dist/config-Yp645dGK.js.map

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

package/dist/config-ispAzOZV.js

@@ -0,0 +1,16 @@
+import { r as globalRegistry } from "./StateContainerRegistry-BK57H92E.js";
+//#region src/registry/config.ts
+let _registry = globalRegistry;
+function getRegistry() {
+	return _registry;
+}
+function setRegistry(registry) {
+	_registry = registry;
+}
+function getStats() {
+	return _registry.getStats();
+}
+//#endregion
+export { getStats as n, setRegistry as r, getRegistry as t };
+
+//# sourceMappingURL=config-ispAzOZV.js.map

package/dist/config-ispAzOZV.js.map

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

package/dist/constants.d.cts

@@ -15,34 +15,6 @@ export declare const BLAC_DEFAULTS: {
      * Maximum getter nesting depth (prevents infinite recursion)
      */
     readonly MAX_GETTER_DEPTH: 10;
-    /**
-     * Default cleanup interval for subscriptions (30 seconds)
-     */
-    readonly CLEANUP_INTERVAL_MS: 30000;
-    /**
-     * Cleanup interval for weak reference stage (10 seconds)
-     */
-    readonly WEAKREF_CLEANUP_INTERVAL_MS: 10000;
-    /**
-     * Default maximum subscriptions per container
-     */
-    readonly MAX_SUBSCRIPTIONS: 1000;
-    /**
-     * Maximum subscriptions for high-performance mode
-     */
-    readonly MAX_SUBSCRIPTIONS_HIGH_PERF: 10000;
-    /**
-     * Default timeout for pipeline execution (5 seconds)
-     */
-    readonly PIPELINE_TIMEOUT_MS: 5000;
-    /**
-     * Cleanup interval for high-performance mode (5 seconds)
-     */
-    readonly CLEANUP_INTERVAL_HIGH_PERF_MS: 5000;
-    /**
-     * Maximum number of stages in a pipeline
-     */
-    readonly MAX_PIPELINE_STAGES: 30;
 };
 /**
  * Static property names for StateContainer classes
@@ -57,6 +29,11 @@ export declare const BLAC_STATIC_PROPS: {
      * Exclude a bloc from DevTools reporting (prevents infinite loops)
      */
     readonly EXCLUDE_FROM_DEVTOOLS: "__excludeFromDevTools";
+    /**
+     * Mark a bloc so each `useBloc` call site gets its own per-mount instance.
+     * The React adapter auto-keys via `useId()` when this is set.
+     */
+    readonly ISOLATED: "isolated";
 };
 /**
  * ID generation patterns and constants

package/dist/constants.d.ts

@@ -15,34 +15,6 @@ export declare const BLAC_DEFAULTS: {
      * Maximum getter nesting depth (prevents infinite recursion)
      */
     readonly MAX_GETTER_DEPTH: 10;
-    /**
-     * Default cleanup interval for subscriptions (30 seconds)
-     */
-    readonly CLEANUP_INTERVAL_MS: 30000;
-    /**
-     * Cleanup interval for weak reference stage (10 seconds)
-     */
-    readonly WEAKREF_CLEANUP_INTERVAL_MS: 10000;
-    /**
-     * Default maximum subscriptions per container
-     */
-    readonly MAX_SUBSCRIPTIONS: 1000;
-    /**
-     * Maximum subscriptions for high-performance mode
-     */
-    readonly MAX_SUBSCRIPTIONS_HIGH_PERF: 10000;
-    /**
-     * Default timeout for pipeline execution (5 seconds)
-     */
-    readonly PIPELINE_TIMEOUT_MS: 5000;
-    /**
-     * Cleanup interval for high-performance mode (5 seconds)
-     */
-    readonly CLEANUP_INTERVAL_HIGH_PERF_MS: 5000;
-    /**
-     * Maximum number of stages in a pipeline
-     */
-    readonly MAX_PIPELINE_STAGES: 30;
 };
 /**
  * Static property names for StateContainer classes
@@ -57,6 +29,11 @@ export declare const BLAC_STATIC_PROPS: {
      * Exclude a bloc from DevTools reporting (prevents infinite loops)
      */
     readonly EXCLUDE_FROM_DEVTOOLS: "__excludeFromDevTools";
+    /**
+     * Mark a bloc so each `useBloc` call site gets its own per-mount instance.
+     * The React adapter auto-keys via `useId()` when this is set.
+     */
+    readonly ISOLATED: "isolated";
 };
 /**
  * ID generation patterns and constants

package/dist/core/Cubit.d.ts

@@ -2,6 +2,5 @@ import { StateContainer } from './StateContainer';
 export declare abstract class Cubit<S extends object = any> extends StateContainer<S> {
     constructor(initialState: S);
     emit(newState: S): void;
-    update(updater: (current: S) => S): void;
     patch: S extends object ? (partial: Partial<S>) => void : never;
 }

package/dist/core/StateContainer.d.ts

@@ -1,5 +1,5 @@
 import type { StateContainerConstructor } from '../types/utilities';
-import { EMIT, UPDATE } from './symbols';
+import { EMIT } from './symbols';
 export interface StateContainerConfig {
     name?: string;
     debug?: boolean;
@@ -24,7 +24,6 @@ export interface SystemEventPayloads<S> {
 type SystemEventHandler<S, E extends SystemEvent> = (payload: SystemEventPayloads<S>[E]) => void;
 export declare abstract class StateContainer<S extends object = any> {
     static __excludeFromDevTools: boolean;
-    static enableStackTrace: boolean;
     private _state;
     private readonly _listeners;
     private _disposed;
@@ -38,11 +37,12 @@ export declare abstract class StateContainer<S extends object = any> {
     private _config;
     private readonly _systemEventHandlers;
     private _dependencies;
+    private _hasStateChangeHandlers;
+    private _registry;
     name: string;
     debug: boolean;
     instanceId: string;
     createdAt: number;
-    lastUpdateTimestamp: number;
     get dependencies(): ReadonlyMap<StateContainerConstructor, string>;
     protected depend<T extends StateContainerConstructor>(Type: T, instanceKey?: string): () => InstanceType<T>;
     constructor(initialState: S);
@@ -56,15 +56,12 @@ export declare abstract class StateContainer<S extends object = any> {
     subscribe(listener: StateListener<S>): () => void;
     dispose(): void;
     protected [EMIT](newState: S): void;
-    protected [UPDATE](updater: (current: S) => S): void;
+    protected emit(newState: S): void;
     beginHydration(): void;
     applyHydratedState(newState: S): boolean;
     finishHydration(): void;
     failHydration(error: Error): void;
     waitForHydration(): Promise<void>;
-    private captureStackTrace;
-    private formatStackLine;
-    private cleanFilePath;
     private applyState;
     private setHydrationStatus;
     private ensureHydrationPromise;

package/dist/core/StateContainerRegistry.d.ts

@@ -1,27 +1,28 @@
 import type { StateContainer } from './StateContainer';
+import { type PluginManager } from '../plugin/PluginManager';
 import { InstanceReadonlyState, StateContainerConstructor } from '../types/utilities';
 /**
- * Entry in the instance registry, tracking the instance and its reference count
+ * Entry in the instance registry, tracking the instance and its named references
  * @template T - Instance type
  */
 export interface InstanceEntry<T = any> {
     /** The state container instance */
     instance: T;
-    /** Number of active references to this instance */
-    refCount: number;
+    /** Map of active reference IDs to their acquire count (supports paired acquire/release) */
+    refs: Map<string, number>;
 }
 /**
  * Lifecycle events emitted by the registry
  */
-export type LifecycleEvent = 'created' | 'stateChanged' | 'disposed';
+export type LifecycleEvent = 'created' | 'stateChanged' | 'disposed' | 'refAcquired' | 'refReleased';
 /**
  * Listener function type for each lifecycle event
  * @template E - The lifecycle event type
  */
-export type LifecycleListener<E extends LifecycleEvent> = E extends 'created' ? (container: StateContainer<any>) => void : E extends 'stateChanged' ? (container: StateContainer<any>, previousState: any, currentState: any, callstack?: string) => void : E extends 'disposed' ? (container: StateContainer<any>) => void : never;
+export type LifecycleListener<E extends LifecycleEvent> = E extends 'created' ? (container: StateContainer<any>) => void : E extends 'stateChanged' ? (container: StateContainer<any>, previousState: any, currentState: any) => void : E extends 'disposed' ? (container: StateContainer<any>) => void : E extends 'refAcquired' ? (container: StateContainer<any>, refId: string) => void : E extends 'refReleased' ? (container: StateContainer<any>, refId: string) => void : never;
 /**
  * Central registry for managing StateContainer instances.
- * Handles instance lifecycle, ref counting, and lifecycle event emission.
+ * Handles instance lifecycle, named ref tracking, and lifecycle event emission.
  *
  * @example
  * ```ts
@@ -38,6 +39,10 @@ export declare class StateContainerRegistry {
     private readonly types;
     private readonly registeredTypeNames;
     private readonly listeners;
+    private _stateChangedListenerCount;
+    get hasStateChangedListeners(): boolean;
+    private _pendingStateChanges;
+    private _autoRefIdCounter;
     /**
      * Register a type for lifecycle event tracking
      * @param constructor - The StateContainer class constructor
@@ -55,22 +60,24 @@ export declare class StateContainerRegistry {
      */
     getInstancesMap<T extends StateContainerConstructor>(Type: T): Map<string, InstanceEntry>;
     /**
-     * Acquire an instance with ref counting (ownership semantics).
-     * Creates a new instance if one doesn't exist, or returns existing and increments ref count.
-     * You must call `release()` when done to decrement the ref count.
+     * Acquire an instance with ref tracking (ownership semantics).
+     * Creates a new instance if one doesn't exist, or returns existing and adds a ref.
+     * You must call `release()` with the same refId when done.
      * @param Type - The StateContainer class constructor
      * @param instanceKey - Instance key (defaults to 'default')
      * @param options - Acquisition options
      * @param options.canCreate - Whether to create new instance if not found (default: true)
-     * @param options.countRef - Whether to increment ref count (default: true)
+     * @param options.countRef - Whether to add a reference (default: true)
+     * @param options.refId - Named reference ID for debugging; auto-generated if omitted
      * @returns The state container instance
      */
     acquire<T extends StateContainerConstructor = StateContainerConstructor>(Type: T, instanceKey?: string, options?: {
         canCreate?: boolean;
         countRef?: boolean;
+        refId?: string;
     }): InstanceType<T>;
     /**
-     * Borrow an existing instance without incrementing ref count (borrowing semantics).
+     * Borrow an existing instance without adding a ref (borrowing semantics).
      * Tracks cross-bloc dependency for reactive updates.
      * @param Type - The StateContainer class constructor
      * @param instanceKey - Instance key (defaults to 'default')
@@ -94,11 +101,11 @@ export declare class StateContainerRegistry {
     };
     /**
      * Ensure an instance exists without taking ownership (for bloc-to-bloc communication).
-     * Gets existing instance OR creates it if it doesn't exist, without incrementing ref count.
+     * Gets existing instance OR creates it if it doesn't exist, without adding a ref.
      * Tracks cross-bloc dependency for reactive updates.
      *
      * Use this in bloc-to-bloc communication when you need to ensure an instance exists
-     * but don't want to claim ownership (no ref count increment).
+     * but don't want to claim ownership (no ref added).
      * @param Type - The StateContainer class constructor
      * @param instanceKey - Instance key (defaults to 'default')
      * @returns The state container instance
@@ -106,12 +113,14 @@ export declare class StateContainerRegistry {
     ensure<T extends StateContainerConstructor = StateContainerConstructor>(Type: T, instanceKey?: string): InstanceType<T>;
     /**
      * Release a reference to an instance.
-     * Decrements ref count and disposes when it reaches 0 (unless keepAlive).
+     * Removes the ref and disposes when refs is empty (unless keepAlive).
+     * Releasing an already-removed refId is a no-op (idempotent).
      * @param Type - The StateContainer class constructor
      * @param instanceKey - Instance key (defaults to 'default')
-     * @param forceDispose - Force immediate disposal regardless of ref count
+     * @param forceDispose - Force immediate disposal regardless of refs
+     * @param refId - The specific ref to remove; removes one arbitrary ref if omitted
      */
-    release<T extends StateContainerConstructor>(Type: T, instanceKey?: string, forceDispose?: boolean): void;
+    release<T extends StateContainerConstructor>(Type: T, instanceKey?: string, forceDispose?: boolean, refId?: string): void;
     /**
      * Get all instances of a specific type.
      * @param Type - The StateContainer class constructor
@@ -131,12 +140,19 @@ export declare class StateContainerRegistry {
      */
     clear<T extends StateContainerConstructor>(Type: T): void;
     /**
-     * Get reference count for an instance.
+     * Get reference count for an instance (number of active refs).
      * @param Type - The StateContainer class constructor
      * @param instanceKey - Instance key (defaults to 'default')
      * @returns Current ref count (0 if instance doesn't exist)
      */
     getRefCount<T extends StateContainerConstructor>(Type: T, instanceKey?: string): number;
+    /**
+     * Get all active reference IDs for an instance.
+     * @param Type - The StateContainer class constructor
+     * @param instanceKey - Instance key (defaults to 'default')
+     * @returns Array of ref ID strings (empty if instance doesn't exist)
+     */
+    getRefIds<T extends StateContainerConstructor>(Type: T, instanceKey?: string): string[];
     /**
      * Check if an instance exists.
      * @param Type - The StateContainer class constructor
@@ -176,7 +192,18 @@ export declare class StateContainerRegistry {
      * Emit lifecycle event to all listeners
      * @internal - Called by StateContainer lifecycle methods
      */
-    emit(event: LifecycleEvent, ...args: any[]): void;
+    emit(event: 'created', container: StateContainer<any>): void;
+    emit(event: 'disposed', container: StateContainer<any>): void;
+    emit(event: 'stateChanged', container: StateContainer<any>, previousState: any, currentState: any): void;
+    emit(event: 'refAcquired', container: StateContainer<any>, refId: string): void;
+    emit(event: 'refReleased', container: StateContainer<any>, refId: string): void;
+    /**
+     * Schedule a deferred stateChanged notification via microtask.
+     * Skips entirely when no stateChanged listeners are registered.
+     * @internal - Called by StateContainer.applyState
+     */
+    notifyStateChanged(container: StateContainer<any>, previousState: any, newState: any): void;
+    private flushStateChanged;
 }
 /**
  * Global default registry instance
@@ -185,4 +212,4 @@ export declare const globalRegistry: StateContainerRegistry;
 /**
  * Get the global plugin manager
  */
-export declare function getPluginManager(): any;
+export declare function getPluginManager(): PluginManager;

package/dist/core/symbols.d.ts

@@ -1,2 +1 @@
 export declare const EMIT: unique symbol;
-export declare const UPDATE: unique symbol;

package/dist/debug.cjs

@@ -1,10 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_StateContainerRegistry = require("./StateContainerRegistry-BsMIpllP.cjs");
-const require_config = require("./config-DLzmy2rZ.cjs");
-const require_management = require("./management-xoZ7w3bI.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-CX2CBOmv.cjs");
+const require_config = require("./config-H6FAqbW4.cjs");
+const require_management = require("./management-DMZ8qpwr.cjs");
 exports.forEach = require_management.forEach;
 exports.getAll = require_management.getAll;
 exports.getRefCount = require_management.getRefCount;
+exports.getRefIds = require_management.getRefIds;
 exports.getRegistry = require_config.getRegistry;
 exports.getStats = require_config.getStats;
 exports.globalRegistry = require_StateContainerRegistry.globalRegistry;

package/dist/debug.d.cts

@@ -9,7 +9,7 @@
  *
  * @example
  * ```typescript
- * import { getStats, globalRegistry, hasInstance } from '@blac/core/debug';
+ * import { getStats, globalRegistry, hasInstance, getRefIds } from '@blac/core/debug';
  *
  * // Get registry statistics
  * const stats = getStats();
@@ -20,15 +20,14 @@
  *   console.log('UserBloc is registered');
  * }
  *
- * // Iterate over all instances of a type
- * forEach(UserBloc, (instance) => {
- *   console.log(instance.state);
- * });
+ * // See who holds a reference
+ * const refs = getRefIds(UserBloc);
+ * console.log('Ref holders:', refs);
  * ```
  *
  * @packageDocumentation
  */
-export { hasInstance, getRefCount, getAll, forEach } from './registry/queries';
+export { hasInstance, getRefCount, getRefIds, getAll, forEach, } from './registry/queries';
 export { register } from './registry/management';
 export { getRegistry, setRegistry, getStats } from './registry/config';
 export { globalRegistry } from './core/StateContainerRegistry';

package/dist/debug.d.ts

@@ -9,7 +9,7 @@
  *
  * @example
  * ```typescript
- * import { getStats, globalRegistry, hasInstance } from '@blac/core/debug';
+ * import { getStats, globalRegistry, hasInstance, getRefIds } from '@blac/core/debug';
  *
  * // Get registry statistics
  * const stats = getStats();
@@ -20,15 +20,14 @@
  *   console.log('UserBloc is registered');
  * }
  *
- * // Iterate over all instances of a type
- * forEach(UserBloc, (instance) => {
- *   console.log(instance.state);
- * });
+ * // See who holds a reference
+ * const refs = getRefIds(UserBloc);
+ * console.log('Ref holders:', refs);
  * ```
  *
  * @packageDocumentation
  */
-export { hasInstance, getRefCount, getAll, forEach } from './registry/queries';
+export { hasInstance, getRefCount, getRefIds, getAll, forEach, } from './registry/queries';
 export { register } from './registry/management';
 export { getRegistry, setRegistry, getStats } from './registry/config';
 export { globalRegistry } from './core/StateContainerRegistry';

package/dist/debug.js

@@ -1,4 +1,4 @@
-import { r as globalRegistry } from "./StateContainerRegistry-DOkDGng-.js";
-import { n as getStats, r as setRegistry, t as getRegistry } from "./config-XQua95Xz.js";
-import { a as getAll, i as forEach, o as getRefCount, r as register, s as hasInstance } from "./management-C-wBdpho.js";
-export { forEach, getAll, getRefCount, getRegistry, getStats, globalRegistry, hasInstance, register, setRegistry };
+import { r as globalRegistry } from "./StateContainerRegistry-BK57H92E.js";
+import { n as getStats, r as setRegistry, t as getRegistry } from "./config-ispAzOZV.js";
+import { a as getAll, c as hasInstance, i as forEach, o as getRefCount, r as register, s as getRefIds } from "./management-CK-GL3wY.js";
+export { forEach, getAll, getRefCount, getRefIds, getRegistry, getStats, globalRegistry, hasInstance, register, setRegistry };

package/dist/ensure-9VEq5H0L.js

@@ -0,0 +1,9 @@
+import { t as getRegistry } from "./config-CR_Bz7RD.js";
+//#region src/registry/ensure.ts
+function ensure(BlocClass, instanceKey) {
+	return getRegistry().ensure(BlocClass, instanceKey);
+}
+//#endregion
+export { ensure as t };
+
+//# sourceMappingURL=ensure-9VEq5H0L.js.map

package/dist/ensure-9VEq5H0L.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-9VEq5H0L.js","names":[],"sources":["../src/registry/ensure.ts"],"sourcesContent":["import { getRegistry } from './config';\nimport type { StateContainerConstructor } from '../types/utilities';\n\nexport function ensure<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey?: string,\n): InstanceType<T> {\n  return getRegistry().ensure(BlocClass, instanceKey);\n}\n"],"mappings":";;AAGA,SAAgB,OACd,WACA,aACiB;AACjB,QAAO,aAAa,CAAC,OAAO,WAAW,YAAY"}

package/dist/ensure-BNDfTzqg.cjs

@@ -0,0 +1,14 @@
+const require_config = require("./config-CTOa-yPN.cjs");
+//#region src/registry/ensure.ts
+function ensure(BlocClass, instanceKey) {
+	return require_config.getRegistry().ensure(BlocClass, instanceKey);
+}
+//#endregion
+Object.defineProperty(exports, "ensure", {
+	enumerable: true,
+	get: function() {
+		return ensure;
+	}
+});
+
+//# sourceMappingURL=ensure-BNDfTzqg.cjs.map

package/dist/ensure-BNDfTzqg.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-BNDfTzqg.cjs","names":["getRegistry"],"sources":["../src/registry/ensure.ts"],"sourcesContent":["import { getRegistry } from './config';\nimport type { StateContainerConstructor } from '../types/utilities';\n\nexport function ensure<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey?: string,\n): InstanceType<T> {\n  return getRegistry().ensure(BlocClass, instanceKey);\n}\n"],"mappings":";;AAGA,SAAgB,OACd,WACA,aACiB;AACjB,QAAOA,eAAAA,aAAa,CAAC,OAAO,WAAW,YAAY"}