@blac/core 2.0.17 → 2.0.19

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-C7Ktkjh2.cjs

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

package/dist/config-C7Ktkjh2.cjs.map

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

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

package/dist/config-COT4Xkbc.js.map

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

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

package/dist/config-b2z51Y_C.cjs.map

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

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

package/dist/config-buwpT7l3.js.map

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

@@ -4,13 +4,13 @@ import { StateContainer } from './StateContainer';
  * public mutation surface. Today it adds nothing structurally beyond
  * `StateContainer` — both are inherited from the underlying
  * `StructuralContainer<S>`. Kept as a real class (not a type alias) because
- * downstream code does `instance instanceof Cubit` checks (see A2 audit).
+ * downstream code does `instance instanceof Cubit` checks.
  *
  * The class body is intentionally empty: a no-op `emit` override would
  * still go through `applyState`, and `patch` is inherited from
- * `StructuralContainer` (path-diffed, microtask-flushed). If a caller
- * needs the old "skip if no real change" patch semantics, they can wrap
- * `patch` themselves or call `emit` after a manual equality check.
+ * `StructuralContainer` (path-diffed, microtask-flushed). A caller that
+ * wants "skip if no real change" patch semantics can wrap `patch`
+ * themselves or call `emit` after a manual equality check.
  */
 export declare abstract class Cubit<S extends object = any, Args = void, Deps extends object = Record<string, never>> extends StateContainer<S, Args, Deps> {
 }

package/dist/core/StateContainer.d.ts

@@ -1,6 +1,7 @@
 import { StructuralContainer, type DeepPartial, type StructuralContainerOptions } from '@dirtytalk/structural';
 import type { ExtractArgs, ExtractState, StateContainerConstructor } from '../types/utilities';
-import { APPLY_DEPS, EMIT, REMOVE_DEPS_OWNER } from './symbols';
+import { APPLY_DEPS, INIT_CONFIG, REMOVE_DEPS_OWNER } from './symbols';
+import { type BlacMeta } from './meta';
 /**
  * Brand symbol carried (non-enumerable) on every handle returned by
  * `depend()`. Framework adapters (`@blac/react`) use this to detect handles
@@ -45,7 +46,6 @@ export interface StateContainerConfig {
     args?: unknown;
 }
 export type HydrationStatus = 'idle' | 'hydrating' | 'hydrated' | 'error';
-type StateListener<S> = (state: S) => void;
 export type SystemEvent = 'stateChanged' | 'dispose' | 'hydrationChanged';
 export interface SystemEventPayloads<S> {
     stateChanged: {
@@ -72,19 +72,15 @@ type SystemEventHandler<S, E extends SystemEvent> = (payload: SystemEventPayload
  *   - per-class `PathInterner`
  *
  * StateContainer layers on:
- *   - identity (`name`, `instanceId`, `createdAt`, `debug`)
- *   - lifecycle (`dispose`, `isDisposed`, `onSystemEvent`)
- *   - hydration (`beginHydration` / `applyHydratedState` / `finishHydration` / `failHydration` / `waitForHydration`)
- *   - cross-bloc deps (`depend()`, `dependencies` getter)
+ *   - identity / lifecycle / hydration (exposed via `$blac: BlacMeta`)
+ *   - cross-bloc deps (`depend()`, `$blac.dependencies`)
  *   - per-consumer deps slices (`APPLY_DEPS` / `REMOVE_DEPS_OWNER` / `onDepsChanged`)
  *   - registry integration (config-driven equality, emit-rate circuit breaker)
  *
  * Subscribers can attach via:
- *   - `subscribe(listener)` — legacy state listener (back-compat); fires on
- *     every flush with the latest state.
  *   - `onSystemEvent('stateChanged' | 'dispose' | 'hydrationChanged', cb)` —
  *     coarse lifecycle events.
- *   - `this.channel.subscribe(interest, cb)` — path-scoped (new code).
+ *   - `this.channel.subscribe(interest, cb)` — path-scoped.
  */
 export declare abstract class StateContainer<S extends object = any, Args = void, Deps extends object = Record<string, never>> extends StructuralContainer<S> {
     static __excludeFromDevTools: boolean;
@@ -123,18 +119,24 @@ export declare abstract class StateContainer<S extends object = any, Args = void
     private _emitWindowStart;
     private _emitCount;
     private _emitRateWarned;
-    private readonly _listeners;
     private readonly _systemEventHandlers;
     private _dependencies;
     private _pendingChange;
     private _bridgeUnsub;
     private _registry;
     private _equalityFn;
-    name: string;
-    debug: boolean;
-    instanceId: string;
-    createdAt: number;
-    get dependencies(): ReadonlyMap<StateContainerConstructor, string>;
+    private _name;
+    private _debug;
+    private _instanceId;
+    private _createdAt;
+    /**
+     * Reserved meta namespace: identity (`name`/`id`/`debug`/`createdAt`),
+     * lifecycle (`disposed`/`dependencies`), and the `hydration` sub-surface.
+     * Own, frozen, branded data property — `buildTrackedProxy` only intercepts
+     * prototype getters, so this own property and its closure-based getters are
+     * proxy-safe. See {@link createMeta}.
+     */
+    readonly $blac: BlacMeta<S>;
     get args(): Args | undefined;
     /**
      * Declare a cross-bloc dependency. Returns a branded handle with two
@@ -160,43 +162,37 @@ export declare abstract class StateContainer<S extends object = any, Args = void
      * this.emit(...)) or kick off loads.
      */
     protected init(_args: Args): void;
-    initConfig(config: StateContainerConfig): void;
-    get isDisposed(): boolean;
-    get hydrationStatus(): HydrationStatus;
-    get hydrationError(): Error | undefined;
-    get isHydrated(): boolean;
-    get changedWhileHydrating(): boolean;
-    subscribe(listener: StateListener<S>): () => void;
+    /**
+     * @internal Framework-only configuration entry point (registry + testing
+     * helpers). Writes the `_`-private identity fields directly, resolves
+     * per-class equality, emits the registry `created` event, and runs `init()`
+     * once. See {@link INIT_CONFIG}.
+     */
+    [INIT_CONFIG](config: StateContainerConfig): void;
     dispose(): void;
     emit(next: S): void;
     /**
      * Override of `StructuralContainer.patch` that routes through the
      * StateContainer concerns: disposed guard, dev-only emit-rate check,
-     * `_changedWhileHydrating` flag, pending-change capture (so legacy
-     * listeners and `stateChanged` system events see the merged prev/next),
-     * and the registry-level `stateChanged` notification. We still call
+     * `_changedWhileHydrating` flag, pending-change capture (so `stateChanged`
+     * system events see the merged prev/next), and the registry-level
+     * `stateChanged` notification. We still call
      * `super.patch` so path-marking semantics (the whole point of patch) are
      * preserved.
      */
     patch(partial: DeepPartial<S>): void;
-    /**
-     * @internal @deprecated Symbol-keyed alias for `emit`. Kept only so legacy
-     * in-package tests that index with `[EMIT]` typecheck/run unchanged. C5
-     * removes this along with the `EMIT` symbol.
-     */
-    protected [EMIT](next: S): void;
     private applyState;
     /**
      * Called by the channel-bridge subscriber on each flush. Drains the
-     * pending change (if any) into legacy listeners and the 'stateChanged'
-     * system event. No pending change == flush from a no-op patch == skip.
+     * pending change (if any) into the 'stateChanged' system event.
+     * No pending change == flush from a no-op patch == skip.
      */
     private _drainPending;
-    beginHydration(): void;
-    applyHydratedState(next: S): boolean;
-    finishHydration(): void;
-    failHydration(error: Error): void;
-    waitForHydration(): Promise<void>;
+    private _beginHydration;
+    private _applyHydratedState;
+    private _finishHydration;
+    private _failHydration;
+    private _waitForHydration;
     private setHydrationStatus;
     private ensureHydrationPromise;
     private resolveHydration;

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';
 /**
@@ -16,12 +16,12 @@ export interface InstanceEntry<T = 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.
@@ -105,7 +105,7 @@ export declare class StateContainerRegistry {
      * You must call `release()` with the same refId when done.
      *
      * @internal Internal key tier. Public callers use the args-based `acquire`
-     *   wrapper; `useBloc`/`compat`/`watch` address a pre-resolved key here.
+     *   wrapper; `useBloc` and `watch` address a pre-resolved key here.
      * @param Type - The StateContainer class constructor
      * @param instanceKey - Pre-resolved instance key (defaults to 'default')
      * @param options - Acquisition options
@@ -258,6 +258,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/meta.d.ts

@@ -0,0 +1,73 @@
+/**
+ * `$blac` meta namespace for `StateContainer`.
+ *
+ * ──────────────────────────────────────────────────────────────────────────
+ * CONSTRAINT — NO ES `#private` FIELDS, ANYWHERE IN THIS FILE.
+ *
+ * `@blac/react`'s `buildTrackedProxy` invokes prototype getters with a
+ * `Proxy(instance)` as the `this`-receiver. Accessing an ES `#private` field
+ * through a proxy receiver throws (`#x` brand checks fail on the proxy). The
+ * whole point of this meta object is to be proxy-safe: every getter/method
+ * here closes over the *real* container instance captured at `createMeta`
+ * time, NEVER over a `this`-receiver. Do not "modernize" the `_`-prefixed
+ * TS-private reads below into `#private` access.
+ * ──────────────────────────────────────────────────────────────────────────
+ */
+import type { HydrationStatus } from './StateContainer';
+import type { StateContainerConstructor } from '../types/utilities';
+/**
+ * Hydration sub-surface of {@link BlacMeta}. Exposes the container's
+ * hydration state machine — the `begin`/`apply`/`finish`/`fail`/`wait`
+ * methods and the `status`/`error`/`isHydrated`/`changedWhileHydrating`
+ * getters — namespaced under `$blac`.
+ */
+export interface BlacHydration<S extends object> {
+    readonly status: HydrationStatus;
+    readonly error: Error | undefined;
+    readonly isHydrated: boolean;
+    readonly changedWhileHydrating: boolean;
+    begin(): void;
+    apply(next: S): boolean;
+    finish(): void;
+    fail(error: Error): void;
+    wait(): Promise<void>;
+}
+/**
+ * The reserved `$blac` instance member on every `StateContainer`. Gathers the
+ * container's identity/lifecycle/hydration surface (`name`, `id`, `debug`,
+ * `createdAt`, `disposed`, `dependencies`, and the hydration methods) under one
+ * namespace, keeping the generic names free for userland blocs.
+ *
+ * The object is allocated once per container, frozen, branded, and exposes
+ * live getters that read the container's current `_`-private fields — values
+ * are never snapshotted.
+ */
+export interface BlacMeta<S extends object = any> {
+    readonly name: string;
+    readonly id: string;
+    readonly debug: boolean;
+    readonly createdAt: number;
+    readonly disposed: boolean;
+    readonly dependencies: ReadonlyMap<StateContainerConstructor, string>;
+    readonly hydration: BlacHydration<S>;
+}
+/**
+ * Non-enumerable brand carried on every `$blac` object produced by
+ * {@link createMeta}. Used by the clobber guard in `StateContainer` to detect
+ * a subclass class-field shadowing the base's own `$blac` property, and by the
+ * meta tests. Intentionally NOT re-exported from the package barrel.
+ */
+export declare const META_BRAND: unique symbol;
+/**
+ * Build the frozen, branded `$blac` meta object for a container.
+ *
+ * Called from a `StateContainer` field initializer (`$blac = createMeta(this)`).
+ * Only the back-reference is captured at this point; every getter/method reads
+ * the container's `_`-private fields lazily on access, so field-initializer
+ * ordering relative to those private fields is irrelevant.
+ *
+ * The getters close over `container` (the real instance), never over a
+ * `this`-receiver — this is what keeps `$blac` reads safe through
+ * `buildTrackedProxy`.
+ */
+export declare function createMeta<S extends object>(container: object): BlacMeta<S>;

package/dist/core/symbols.d.ts

@@ -1,27 +1,20 @@
-/**
- * @internal @deprecated Symbol-keyed mutation entry point on `StateContainer`.
- *
- * Per A2 audit (`plans/blac-core-migration/_audit.md`), this symbol has zero
- * external consumers — only in-package tests still reference it. C0 keeps it
- * as a thin alias for `emit()` so the existing test files typecheck and run
- * unchanged; C5 will port those tests to use `emit()` directly and delete
- * this symbol along with its `[EMIT]` method on `StateContainer`.
- *
- * Do not add new uses of this symbol.
- */
-export declare const EMIT: unique symbol;
 /**
  * @internal Apply one owner's (consumer's) deps slice to an instance.
  * Called by framework adapters (e.g. @blac/react useBloc) — not public API.
- *
- * Kept until D0 ports `useBloc` off the legacy adapter surface. See A2 audit
- * (`plans/blac-core-migration/_audit.md`) for the consumer list.
  */
 export declare const APPLY_DEPS: unique symbol;
 /**
  * @internal Withdraw one owner's entire deps slice (consumer unmounted).
  * Called by framework adapters — not public API.
- *
- * Kept until D0 ports `useBloc`. See A2 audit for the consumer list.
  */
 export declare const REMOVE_DEPS_OWNER: unique symbol;
+/**
+ * @internal Symbol-keyed configuration entry point on `StateContainer`.
+ * Writes the instance's identity fields (`_name`/`_debug`/`_instanceId`),
+ * resolves per-class equality, emits the registry `created` event, and runs
+ * `init()` once.
+ *
+ * Framework-only — the registry (`StateContainerRegistry.ensure`) and testing
+ * helpers are the sole callers, mirroring the `APPLY_DEPS` precedent.
+ */
+export declare const INIT_CONFIG: unique symbol;