@blac/core 2.0.19 → 2.1.0

package/dist/config-D2A8ZYRM.js

@@ -0,0 +1,16 @@
+import { r as globalRegistry } from "./StateContainerRegistry-DWOzx7Gd.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-D2A8ZYRM.js.map

package/dist/config-D2A8ZYRM.js.map

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

package/dist/config-D34BkraU.cjs

@@ -0,0 +1,32 @@
+//#region src/registry/config.ts
+let _registry = require("./StateContainerRegistry-C75QpeaO.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-D34BkraU.cjs.map

package/dist/config-D34BkraU.cjs.map

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

package/dist/config-DOO82lbZ.js

@@ -0,0 +1,16 @@
+import { r as globalRegistry } from "./StateContainerRegistry-8zNFMAf7.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-DOO82lbZ.js.map

package/dist/config-DOO82lbZ.js.map

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

package/dist/config-DWUq7zEQ.cjs

@@ -0,0 +1,32 @@
+//#region src/registry/config.ts
+let _registry = require("./StateContainerRegistry-CS18y4au.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-DWUq7zEQ.cjs.map

package/dist/config-DWUq7zEQ.cjs.map

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

package/dist/config-DXI3kzmA.js

@@ -0,0 +1,16 @@
+import { r as globalRegistry } from "./StateContainerRegistry-D8nu7Z0T.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-DXI3kzmA.js.map

package/dist/config-DXI3kzmA.js.map

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

package/dist/config-ZVy_yFZ3.js

@@ -0,0 +1,16 @@
+import { r as globalRegistry } from "./StateContainerRegistry-DL5Ai7wh.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-ZVy_yFZ3.js.map

package/dist/config-ZVy_yFZ3.js.map

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

package/dist/config-cwaTn5oy.cjs

@@ -0,0 +1,32 @@
+//#region src/registry/config.ts
+let _registry = require("./StateContainerRegistry-Bx2ly-ba.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-cwaTn5oy.cjs.map

package/dist/config-cwaTn5oy.cjs.map

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

package/dist/config.d.cts

@@ -8,6 +8,10 @@ export interface BlacConfig {
      * `prev` and `next` are structurally equal. Default: `shallowEqualState`.
      *
      * Return `true` to skip the emit (states considered equal).
+     *
+     * Applies to `emit`/`update` only — `patch` does not consult this fn; it
+     * relies on its own per-key `Object.is` pre-check plus structural no-op
+     * detection to skip redundant notifications.
      */
     equality: EqualityFn;
     /**
@@ -16,7 +20,7 @@ export interface BlacConfig {
      * creation — typically an unstable/args-derived key churning out instances
      * that are never disposed (a memory leak that eventually freezes the app).
      *
-     * Default: `1000`. Set to `Infinity` (or any non-positive value) to disable.
+     * Default: `100000`. Set to `Infinity` (or any non-positive value) to disable.
      */
     maxInstancesPerType: number;
     /**
@@ -25,7 +29,7 @@ export interface BlacConfig {
      * other leak shape — consumer cleanup (e.g. `useBloc` unmount `release`)
      * never firing, so refs accumulate without bound on one instance.
      *
-     * Default: `1000`. Set to `Infinity` (or any non-positive value) to disable.
+     * Default: `100000`. Set to `Infinity` (or any non-positive value) to disable.
      */
     maxRefsPerInstance: number;
     /**
@@ -37,7 +41,7 @@ export interface BlacConfig {
      * plugins (logging/devtools), and the main thread.
      *
      * Heuristic by nature — warns, never throws, since high-frequency state can
-     * occasionally be legitimate. No-op in production. Default: `100`. Set to
+     * occasionally be legitimate. No-op in production. Default: `1000`. Set to
      * `Infinity` (or any non-positive value) to disable.
      */
     maxEmitsPerSecond: number;

package/dist/config.d.ts

@@ -8,6 +8,10 @@ export interface BlacConfig {
      * `prev` and `next` are structurally equal. Default: `shallowEqualState`.
      *
      * Return `true` to skip the emit (states considered equal).
+     *
+     * Applies to `emit`/`update` only — `patch` does not consult this fn; it
+     * relies on its own per-key `Object.is` pre-check plus structural no-op
+     * detection to skip redundant notifications.
      */
     equality: EqualityFn;
     /**
@@ -16,7 +20,7 @@ export interface BlacConfig {
      * creation — typically an unstable/args-derived key churning out instances
      * that are never disposed (a memory leak that eventually freezes the app).
      *
-     * Default: `1000`. Set to `Infinity` (or any non-positive value) to disable.
+     * Default: `100000`. Set to `Infinity` (or any non-positive value) to disable.
      */
     maxInstancesPerType: number;
     /**
@@ -25,7 +29,7 @@ export interface BlacConfig {
      * other leak shape — consumer cleanup (e.g. `useBloc` unmount `release`)
      * never firing, so refs accumulate without bound on one instance.
      *
-     * Default: `1000`. Set to `Infinity` (or any non-positive value) to disable.
+     * Default: `100000`. Set to `Infinity` (or any non-positive value) to disable.
      */
     maxRefsPerInstance: number;
     /**
@@ -37,7 +41,7 @@ export interface BlacConfig {
      * plugins (logging/devtools), and the main thread.
      *
      * Heuristic by nature — warns, never throws, since high-frequency state can
-     * occasionally be legitimate. No-op in production. Default: `100`. Set to
+     * occasionally be legitimate. No-op in production. Default: `1000`. Set to
      * `Infinity` (or any non-positive value) to disable.
      */
     maxEmitsPerSecond: number;

package/dist/constants.d.cts

@@ -11,10 +11,6 @@ export declare const BLAC_DEFAULTS: {
      * Default instance key for shared instances
      */
     readonly DEFAULT_INSTANCE_KEY: "default";
-    /**
-     * Maximum getter nesting depth (prevents infinite recursion)
-     */
-    readonly MAX_GETTER_DEPTH: 10;
 };
 /**
  * Static property names for StateContainer classes
@@ -42,15 +38,8 @@ export declare const BLAC_STATIC_PROPS: {
      * non-identity fields (e.g., `readonly` flags) while still keying by id.
      */
     readonly KEY: "key";
-};
-/**
- * ID generation patterns and constants
- */
-export declare const BLAC_ID_PATTERNS: {
-    /**
-     * Length of generated ID portion (9 characters from base36)
-     */
-    readonly ID_LENGTH: 9;
+    /** Mark a bloc as always per-mount: `static isolated = true`. */
+    readonly ISOLATED: "isolated";
 };
 /**
  * Standard error message prefix

package/dist/constants.d.ts

@@ -11,10 +11,6 @@ export declare const BLAC_DEFAULTS: {
      * Default instance key for shared instances
      */
     readonly DEFAULT_INSTANCE_KEY: "default";
-    /**
-     * Maximum getter nesting depth (prevents infinite recursion)
-     */
-    readonly MAX_GETTER_DEPTH: 10;
 };
 /**
  * Static property names for StateContainer classes
@@ -42,15 +38,8 @@ export declare const BLAC_STATIC_PROPS: {
      * non-identity fields (e.g., `readonly` flags) while still keying by id.
      */
     readonly KEY: "key";
-};
-/**
- * ID generation patterns and constants
- */
-export declare const BLAC_ID_PATTERNS: {
-    /**
-     * Length of generated ID portion (9 characters from base36)
-     */
-    readonly ID_LENGTH: 9;
+    /** Mark a bloc as always per-mount: `static isolated = true`. */
+    readonly ISOLATED: "isolated";
 };
 /**
  * Standard error message prefix

package/dist/core/StateContainer.d.ts

@@ -1,6 +1,7 @@
 import { StructuralContainer, type DeepPartial, type StructuralContainerOptions } from '@dirtytalk/structural';
+import { type EventToken } from '../events';
 import type { ExtractArgs, ExtractState, StateContainerConstructor } from '../types/utilities';
-import { APPLY_DEPS, INIT_CONFIG, REMOVE_DEPS_OWNER } from './symbols';
+import { APPLY_DEPS, INIT_CONFIG, ON_DISPOSE, REMOVE_DEPS_OWNER } from './symbols';
 import { type BlacMeta } from './meta';
 /**
  * Brand symbol carried (non-enumerable) on every handle returned by
@@ -104,6 +105,12 @@ export declare abstract class StateContainer<S extends object = any, Args = void
      * @internal Withdraw an owner's entire deps slice (consumer unmounted).
      */
     [REMOVE_DEPS_OWNER](ownerId: string): void;
+    /**
+     * @internal Subscribe to this instance's own disposal. Delegates to the
+     * per-instance `'dispose'` system event — used by `watch()` in place of
+     * filtering the global registry `'disposed'` event.
+     */
+    [ON_DISPOSE](handler: () => void): () => void;
     private reconcileDeps;
     protected onDepsChanged(_next: Readonly<Deps>, _prev: Readonly<Deps>): void;
     private _disposed;
@@ -121,6 +128,7 @@ export declare abstract class StateContainer<S extends object = any, Args = void
     private _emitRateWarned;
     private readonly _systemEventHandlers;
     private _dependencies;
+    private _depEdges;
     private _pendingChange;
     private _bridgeUnsub;
     private _registry;
@@ -156,6 +164,15 @@ export declare abstract class StateContainer<S extends object = any, Args = void
      */
     protected depend<T extends StateContainerConstructor>(Type: T, defaultArgs?: ExtractArgs<T>): DepHandle<T>;
     constructor(initialState: S, options?: StructuralContainerOptions);
+    /**
+     * @internal Subscribe the channel bridge that turns flushes into
+     * 'stateChanged' system events. Interest is ALL_PATHS so we wake on every
+     * flush. Coalesced via `_pendingChange`: if no emit happened (e.g. a no-op
+     * patch), the bridge sees null and skips. Lazy: only subscribed while at
+     * least one 'stateChanged' handler exists.
+     */
+    private _subscribeBridge;
+    private _hasStateChangedHandlers;
     /**
      * Called once after construction with the args passed at acquire time, before the first
      * state snapshot is read by any consumer. Override to seed args-derived state (via
@@ -198,6 +215,16 @@ export declare abstract class StateContainer<S extends object = any, Args = void
     private resolveHydration;
     private rejectHydration;
     protected onSystemEvent: <E extends SystemEvent>(event: E, handler: SystemEventHandler<S, E>) => (() => void);
+    /**
+     * Subscribe to a cross-cutting application event for this container's
+     * lifetime. The subscription is torn down automatically on `dispose()` — no
+     * manual `off` in consumer code (requirements AC3).
+     *
+     * Uses THIS container's registry (`_registry`, captured at construction), not
+     * the ambient one, so a container always listens on the bus of the registry it
+     * belongs to.
+     */
+    protected on: <P>(token: EventToken<P>, handler: (payload: P) => void) => (() => void);
     private emitSystemEvent;
     /**
      * Dev-only soft circuit breaker. Counts real state changes in a rolling 1s

package/dist/core/StateContainerRegistry.d.ts

@@ -1,6 +1,6 @@
 import type { HydrationStatus, StateContainer } from './StateContainer';
 import { type PluginManager } from '../plugin/PluginManager';
-import { InstanceReadonlyState, StateContainerConstructor } from '../types/utilities';
+import { InstanceReadonlyState, StateContainerConstructor, StateContainerInstance } from '../types/utilities';
 /**
  * Entry in the instance registry, tracking the instance and its named references
  * @template T - Instance type
@@ -12,6 +12,17 @@ export interface InstanceEntry<T = any> {
     refs: Map<string, number>;
     /** The args used when this entry was first created; used for dev-warn on arg mismatch. */
     args?: unknown;
+    /** Memoized structuralKey(args) for the dev arg-mismatch warning. */
+    argsKey?: string;
+    /** `depend()`-owners currently holding this instance (see `acquire`'s `dependent` option). */
+    dependents?: Set<StateContainer<any, any, any>>;
+    /**
+     * `$blac.id` this entry is indexed under in `_byId`, captured at index time.
+     * Removal always keys off THIS stored id (never a fresh `$blac.id` read),
+     * so an id that changes later (e.g. `INIT_CONFIG` running after insertion)
+     * can never orphan the index.
+     */
+    id?: string;
 }
 /**
  * Lifecycle events emitted by the registry
@@ -38,13 +49,69 @@ export type LifecycleListener<E extends LifecycleEvent> = E extends 'created' ?
  */
 export declare class StateContainerRegistry {
     private readonly instancesByConstructor;
+    /**
+     * Known storage key for each live instance, so disposal can delete its
+     * Map entry directly instead of scanning every entry for identity (P3).
+     */
+    private readonly _keyByInstance;
+    /** Id index for O(1) `findEntryById` lookups (P6, used by devtools' `getRefIds`). */
+    private readonly _byId;
     private readonly types;
-    private readonly registeredTypeNames;
+    private _registeredTypes;
     private readonly listeners;
     private _stateChangedListenerCount;
     get hasStateChangedListeners(): boolean;
     private _pendingStateChanges;
     private _autoRefIdCounter;
+    constructor();
+    /**
+     * Registry-internal reaction to any instance's `disposed` lifecycle event.
+     * Prunes its Map entry, if this registry was tracking it (i.e. it was
+     * `acquire()`/`ensure()`'d, not a bare `new`), and always releases its
+     * dependent edges on whatever it `depend()`'d on.
+     */
+    private _handleDisposed;
+    /**
+     * Remove the Map entry for `container`, if this registry is tracking it.
+     * O(1): looks up the entry's key via `_keyByInstance` instead of scanning
+     * every entry for identity. Keeps an identity guard so a recreated entry
+     * under the same key (a fresh instance under a reused/derived key) is
+     * never deleted by a stale container's disposal.
+     * @returns true if an entry was found and removed
+     */
+    private _pruneEntry;
+    /**
+     * Single removal point for the `_byId` index (P6). Every path that drops
+     * an `InstanceEntry` from the registry MUST route through this so the
+     * index can never leak a stale id -> entry mapping.
+     */
+    private _forgetEntry;
+    /**
+     * O(1) entry lookup by `$blac.id`, used by `PluginContext.getRefIds`
+     * instead of a nested scan over every type x every instance.
+     */
+    findEntryById(id: string): InstanceEntry | undefined;
+    /**
+     * Storage key `container` is CURRENTLY indexed under, or `undefined` if this
+     * registry never tracked it (bare `new`) or no longer does (disposed/pruned,
+     * or its key was taken over by a newer instance). Lets callers that hold only
+     * an instance address it without knowing the `args` it was acquired with.
+     */
+    keyOf(instance: StateContainerInstance): string | undefined;
+    /**
+     * Drop `Type` from `types` once its instances map is empty, so constructors
+     * (and anything keyed on them, e.g. a per-class PathInterner) aren't held
+     * alive forever. Deliberate consequence: `getStats()`/`getTypes()` no
+     * longer list types with zero live instances.
+     */
+    private _maybeDropType;
+    /**
+     * Drop `dependent`'s edge on the `Type`/`key` entry (a `depend()`-resolved
+     * instance). When that leaves the entry with no dependents AND no public
+     * refs AND it isn't keepAlive, dispose it — this recurses into the same
+     * `disposed` listener, so dep-of-dep chains unwind naturally.
+     */
+    private _releaseDependent;
     /**
      * Register a type for lifecycle event tracking
      * @param constructor - The StateContainer class constructor
@@ -112,6 +179,8 @@ export declare class StateContainerRegistry {
      * @param options.canCreate - Whether to create new instance if not found (default: true)
      * @param options.countRef - Whether to add a reference (default: true)
      * @param options.refId - Named reference ID for debugging; auto-generated if omitted
+     * @param options.dependent - The `depend()`-owner resolving this instance, if any;
+     *   recorded so its dependent edge can be released on the owner's disposal.
      * @returns The state container instance
      */
     acquire<T extends StateContainerConstructor = StateContainerConstructor>(Type: T, instanceKey?: string, options?: {
@@ -119,6 +188,7 @@ export declare class StateContainerRegistry {
         countRef?: boolean;
         refId?: string;
         args?: unknown;
+        dependent?: StateContainer<any, any, any>;
     }): InstanceType<T>;
     /**
      * Borrow an existing instance without adding a ref (borrowing semantics).

package/dist/core/symbols.d.ts

@@ -8,6 +8,12 @@ export declare const APPLY_DEPS: unique symbol;
  * Called by framework adapters — not public API.
  */
 export declare const REMOVE_DEPS_OWNER: unique symbol;
+/**
+ * @internal Subscribe to this specific instance's own disposal, bypassing
+ * the global registry `'disposed'` event. Called by `watch()` — not public
+ * API.
+ */
+export declare const ON_DISPOSE: unique symbol;
 /**
  * @internal Symbol-keyed configuration entry point on `StateContainer`.
  * Writes the instance's identity fields (`_name`/`_debug`/`_instanceId`),

package/dist/debug.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_StateContainerRegistry = require("./StateContainerRegistry-lIwo-0m3.cjs");
-const require_config = require("./config-B1l8ZGlU.cjs");
-const require_management = require("./management-DwO0nBzL.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-G81GcCRm.cjs");
+const require_config = require("./config-C1T6Jw7n.cjs");
+const require_management = require("./management-hkY13log.cjs");
 exports.forEach = require_management.forEach;
 exports.getAll = require_management.getAll;
 exports.getRefCount = require_management.getRefCount;

package/dist/debug.js

@@ -1,4 +1,4 @@
-import { r as globalRegistry } from "./StateContainerRegistry-Dj77cok9.js";
-import { n as getStats, r as setRegistry, t as getRegistry } from "./config-CzcoAvBo.js";
-import { a as getAll, c as hasInstance, i as forEach, o as getRefCount, r as register, s as getRefIds } from "./management-AFuqQEwz.js";
+import { r as globalRegistry } from "./StateContainerRegistry-DWOzx7Gd.js";
+import { n as getStats, r as setRegistry, t as getRegistry } from "./config-D2A8ZYRM.js";
+import { a as getAll, c as hasInstance, i as forEach, o as getRefCount, r as register, s as getRefIds } from "./management-8x1OVMi6.js";
 export { forEach, getAll, getRefCount, getRefIds, getRegistry, getStats, globalRegistry, hasInstance, register, setRegistry };

package/dist/decorators/blac.d.ts

@@ -15,6 +15,8 @@ export type BlacOptions =
 /**
  * Override the global equality check for this bloc.
  * Return `true` to skip the emit (states considered equal).
+ * Applies to `emit`/`update` only — `patch` does not consult this fn; it
+ * still skips structural no-ops on its own.
  */
  | {
     equality: EqualityFn;