@blac/core 2.0.18 → 2.0.20

package/dist/acquire-Dg-uXwjF.js

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

package/dist/acquire-Dg-uXwjF.js.map

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

package/dist/config-B1l8ZGlU.cjs

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

package/dist/config-B1l8ZGlU.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-B1l8ZGlU.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-CzcoAvBo.js

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

package/dist/config-CzcoAvBo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-CzcoAvBo.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-D6BoWWPv.js

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

package/dist/config-D6BoWWPv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-D6BoWWPv.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-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-DVM_ESQt.js

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

package/dist/config-DVM_ESQt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-DVM_ESQt.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-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-d9_U58ef.cjs

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

package/dist/config-d9_U58ef.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-d9_U58ef.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-hWTayX76.cjs

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

package/dist/config-hWTayX76.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-hWTayX76.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/core/StateContainer.d.ts

@@ -1,6 +1,6 @@
 import { StructuralContainer, type DeepPartial, type StructuralContainerOptions } from '@dirtytalk/structural';
 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 +104,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;

package/dist/core/StateContainerRegistry.d.ts

@@ -1,4 +1,4 @@
-import type { StateContainer } from './StateContainer';
+import type { HydrationStatus, StateContainer } from './StateContainer';
 import { type PluginManager } from '../plugin/PluginManager';
 import { InstanceReadonlyState, StateContainerConstructor } from '../types/utilities';
 /**
@@ -12,16 +12,20 @@ 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>>;
 }
 /**
  * Lifecycle events emitted by the registry
  */
-export type LifecycleEvent = 'created' | 'stateChanged' | 'disposed' | 'refAcquired' | 'refReleased' | 'depsChanged';
+export type LifecycleEvent = 'created' | 'stateChanged' | 'disposed' | 'refAcquired' | 'refReleased' | 'depsChanged' | 'hydrationChanged';
 /**
  * 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, any, any>) => void : E extends 'stateChanged' ? (container: StateContainer<any, any, any>, previousState: any, currentState: any) => void : E extends 'disposed' ? (container: StateContainer<any, any, any>) => void : E extends 'refAcquired' ? (container: StateContainer<any, any, any>, refId: string) => void : E extends 'refReleased' ? (container: StateContainer<any, any, any>, refId: string) => void : E extends 'depsChanged' ? (container: StateContainer<any, any, any>, previousDeps: Readonly<Record<string, unknown>>, currentDeps: Readonly<Record<string, unknown>>) => void : never;
+export type LifecycleListener<E extends LifecycleEvent> = E extends 'created' ? (container: StateContainer<any, any, any>) => void : E extends 'stateChanged' ? (container: StateContainer<any, any, any>, previousState: any, currentState: any) => void : E extends 'disposed' ? (container: StateContainer<any, any, any>) => void : E extends 'refAcquired' ? (container: StateContainer<any, any, any>, refId: string) => void : E extends 'refReleased' ? (container: StateContainer<any, any, any>, refId: string) => void : E extends 'depsChanged' ? (container: StateContainer<any, any, any>, previousDeps: Readonly<Record<string, unknown>>, currentDeps: Readonly<Record<string, unknown>>) => void : E extends 'hydrationChanged' ? (container: StateContainer<any, any, any>, status: HydrationStatus, previousStatus: HydrationStatus) => void : never;
 /**
  * Central registry for managing StateContainer instances.
  * Handles instance lifecycle, named ref tracking, and lifecycle event emission.
@@ -45,6 +49,26 @@ export declare class StateContainerRegistry {
     get hasStateChangedListeners(): boolean;
     private _pendingStateChanges;
     private _autoRefIdCounter;
+    constructor();
+    /**
+     * Registry-internal reaction to any instance's `disposed` lifecycle event.
+     * If the disposing container is itself tracked in this registry (i.e. it
+     * was `acquire()`/`ensure()`'d, not a bare `new`), prune its Map entry and
+     * release its dependent edges on whatever it `depend()`'d on.
+     */
+    private _handleDisposed;
+    /**
+     * Remove the Map entry for `container`, if this registry is tracking it.
+     * @returns true if an entry was found and removed
+     */
+    private _pruneEntry;
+    /**
+     * 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 +136,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 +145,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).
@@ -258,6 +285,7 @@ export declare class StateContainerRegistry {
     emit(event: 'refAcquired', container: StateContainer<any, any, any>, refId: string): void;
     emit(event: 'refReleased', container: StateContainer<any, any, any>, refId: string): void;
     emit(event: 'depsChanged', container: StateContainer<any, any, any>, previousDeps: Readonly<Record<string, unknown>>, currentDeps: Readonly<Record<string, unknown>>): void;
+    emit(event: 'hydrationChanged', container: StateContainer<any, any, any>, status: HydrationStatus, previousStatus: HydrationStatus): void;
     /**
      * Schedule a deferred stateChanged notification via microtask.
      * Skips entirely when no stateChanged listeners are registered.

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-CSNm2Ws5.cjs");
-const require_config = require("./config-C7Ktkjh2.cjs");
-const require_management = require("./management-14vsHr4t.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-CS18y4au.cjs");
+const require_config = require("./config-DWUq7zEQ.cjs");
+const require_management = require("./management-QWLpbXlW.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-CvBOhAT2.js";
-import { n as getStats, r as setRegistry, t as getRegistry } from "./config-buwpT7l3.js";
-import { a as getAll, c as hasInstance, i as forEach, o as getRefCount, r as register, s as getRefIds } from "./management-BvUAjril.js";
+import { r as globalRegistry } from "./StateContainerRegistry-D8nu7Z0T.js";
+import { n as getStats, r as setRegistry, t as getRegistry } from "./config-DXI3kzmA.js";
+import { a as getAll, c as hasInstance, i as forEach, o as getRefCount, r as register, s as getRefIds } from "./management-C-WGcwPD.js";
 export { forEach, getAll, getRefCount, getRefIds, getRegistry, getStats, globalRegistry, hasInstance, register, setRegistry };