@blac/core 2.0.16 → 2.0.17

package/dist/index.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_StateContainerRegistry = require("./StateContainerRegistry-FWKzPfS-.cjs");
-const require_ensure = require("./ensure-CLQEx0Nn.cjs");
-const require_config = require("./config-DVMnlHLv.cjs");
-const require_acquire = require("./acquire-DHEOEVcj.cjs");
-const require_management = require("./management-GcnNJjnm.cjs");
-const require_watch = require("./watch-CKWt788i.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-DJQqLrli.cjs");
+const require_ensure = require("./ensure-Dx86f80B.cjs");
+const require_config = require("./config-sCPKPYxZ.cjs");
+const require_acquire = require("./acquire-CbMz7gWs.cjs");
+const require_management = require("./management-DAV9sN-k.cjs");
+const require_watch = require("./watch-B91opmva.cjs");
 const require_branded = require("./branded-BybA0_xw.cjs");
 let _dirtytalk_structural = require("@dirtytalk/structural");
 //#region src/registry/borrow.ts
@@ -71,6 +71,7 @@ Object.defineProperty(exports, "ALL_PATHS", {
 });
 exports.APPLY_DEPS = require_ensure.APPLY_DEPS;
 exports.Cubit = require_ensure.Cubit;
+exports.DEP_BRAND = require_ensure.DEP_BRAND;
 exports.EMIT = require_ensure.EMIT;
 exports.PluginManager = require_StateContainerRegistry.PluginManager;
 exports.REMOVE_DEPS_OWNER = require_ensure.REMOVE_DEPS_OWNER;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 export { configureBlac, getBlacConfig, resetBlacConfig, shallowEqualState, type BlacConfig, type EqualityFn, } from './config';
-export { StateContainer } from './core/StateContainer';
-export type { HydrationStatus, StateContainerConfig, SystemEvent, SystemEventPayloads, } from './core/StateContainer';
+export { StateContainer, DEP_BRAND } from './core/StateContainer';
+export type { HydrationStatus, StateContainerConfig, SystemEvent, SystemEventPayloads, DepHandle, } from './core/StateContainer';
 export { Cubit } from './core/Cubit';
 /**
  * @internal symbols — read by framework adapters (`@blac/react` via the

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { configureBlac, getBlacConfig, resetBlacConfig, shallowEqualState, type BlacConfig, type EqualityFn, } from './config';
-export { StateContainer } from './core/StateContainer';
-export type { HydrationStatus, StateContainerConfig, SystemEvent, SystemEventPayloads, } from './core/StateContainer';
+export { StateContainer, DEP_BRAND } from './core/StateContainer';
+export type { HydrationStatus, StateContainerConfig, SystemEvent, SystemEventPayloads, DepHandle, } from './core/StateContainer';
 export { Cubit } from './core/Cubit';
 /**
  * @internal symbols — read by framework adapters (`@blac/react` via the

package/dist/index.js

@@ -1,9 +1,9 @@
-import { a as isExcludedFromDevTools, c as PluginManager, d as resetBlacConfig, f as shallowEqualState, l as configureBlac, n as getPluginManager, o as isKeepAliveClass, r as globalRegistry, s as BLAC_STATIC_PROPS, t as StateContainerRegistry, u as getBlacConfig } from "./StateContainerRegistry-B_ViBLvJ.js";
-import { a as EMIT, i as APPLY_DEPS, n as Cubit, o as REMOVE_DEPS_OWNER, r as StateContainer, t as ensure } from "./ensure-CPMiGvov.js";
-import { n as getStats, r as setRegistry, t as getRegistry } from "./config-8pyOC5gv.js";
-import { n as resolveInstanceKey, t as acquire } from "./acquire-Don7499S.js";
-import { a as getAll, c as hasInstance, i as forEach, n as clearAll, o as getRefCount, r as register, s as getRefIds, t as clear } from "./management-7jLjVHJd.js";
-import { n as watch, t as instance } from "./watch-BmC-Tyqg.js";
+import { a as isExcludedFromDevTools, c as PluginManager, d as resetBlacConfig, f as shallowEqualState, l as configureBlac, n as getPluginManager, o as isKeepAliveClass, r as globalRegistry, s as BLAC_STATIC_PROPS, t as StateContainerRegistry, u as getBlacConfig } from "./StateContainerRegistry-B1GYx9Xo.js";
+import { a as APPLY_DEPS, i as StateContainer, n as Cubit, o as EMIT, r as DEP_BRAND, s as REMOVE_DEPS_OWNER, t as ensure } from "./ensure-DzqGej43.js";
+import { n as getStats, r as setRegistry, t as getRegistry } from "./config-Dk1FxfXj.js";
+import { n as resolveInstanceKey, t as acquire } from "./acquire-G8aB3GAx.js";
+import { a as getAll, c as hasInstance, i as forEach, n as clearAll, o as getRefCount, r as register, s as getRefIds, t as clear } from "./management-444tdCBG.js";
+import { n as watch, t as instance } from "./watch-DPVUwPUY.js";
 import { t as instanceId } from "./branded-DkbUzncc.js";
 import { ALL_PATHS } from "@dirtytalk/structural";
 //#region src/registry/borrow.ts
@@ -62,6 +62,6 @@ function blac(options) {
 	};
 }
 //#endregion
-export { ALL_PATHS, APPLY_DEPS, Cubit, EMIT, PluginManager, REMOVE_DEPS_OWNER, StateContainer, StateContainerRegistry, acquire, blac, borrow, borrowSafe, clear, clearAll, configureBlac, ensure, forEach, getAll, getBlacConfig, getPluginManager, getRefCount, getRefIds, getRegistry, getStats, globalRegistry, hasInstance, instance, instanceId, isExcludedFromDevTools, isKeepAliveClass, register, release, resetBlacConfig, resolveInstanceKey, setRegistry, shallowEqualState, watch };
+export { ALL_PATHS, APPLY_DEPS, Cubit, DEP_BRAND, EMIT, PluginManager, REMOVE_DEPS_OWNER, StateContainer, StateContainerRegistry, acquire, blac, borrow, borrowSafe, clear, clearAll, configureBlac, ensure, forEach, getAll, getBlacConfig, getPluginManager, getRefCount, getRefIds, getRegistry, getStats, globalRegistry, hasInstance, instance, instanceId, isExcludedFromDevTools, isKeepAliveClass, register, release, resetBlacConfig, resolveInstanceKey, setRegistry, shallowEqualState, watch };
 
 //# sourceMappingURL=index.js.map

package/dist/management-444tdCBG.js

@@ -0,0 +1,38 @@
+import { t as getRegistry } from "./config-Dk1FxfXj.js";
+//#region src/registry/queries.ts
+function hasInstance(BlocClass, opts) {
+	const registry = getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.hasInstance(BlocClass, key);
+}
+function getRefCount(BlocClass, opts) {
+	const registry = getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.getRefCount(BlocClass, key);
+}
+function getRefIds(BlocClass, opts) {
+	const registry = getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.getRefIds(BlocClass, key);
+}
+function getAll(BlocClass) {
+	return getRegistry().getAll(BlocClass);
+}
+function forEach(BlocClass, callback) {
+	getRegistry().forEach(BlocClass, callback);
+}
+//#endregion
+//#region src/registry/management.ts
+function clear(BlocClass) {
+	getRegistry().clear(BlocClass);
+}
+function clearAll() {
+	getRegistry().clearAll();
+}
+function register(BlocClass) {
+	getRegistry().register(BlocClass);
+}
+//#endregion
+export { getAll as a, hasInstance as c, forEach as i, clearAll as n, getRefCount as o, register as r, getRefIds as s, clear as t };
+
+//# sourceMappingURL=management-444tdCBG.js.map

package/dist/management-444tdCBG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-444tdCBG.js","names":[],"sources":["../src/registry/queries.ts","../src/registry/management.ts"],"sourcesContent":["import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n  InstanceReadonlyState,\n} from '../types/utilities';\n\nexport function hasInstance<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): boolean {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.hasInstance(BlocClass, key);\n}\n\nexport function getRefCount<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): number {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.getRefCount(BlocClass, key);\n}\n\nexport function getRefIds<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): string[] {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.getRefIds(BlocClass, key);\n}\n\nexport function getAll<T extends StateContainerConstructor>(\n  BlocClass: T,\n): InstanceReadonlyState<T>[] {\n  return getRegistry().getAll(BlocClass);\n}\n\nexport function forEach<T extends StateContainerConstructor>(\n  BlocClass: T,\n  callback: (instance: InstanceReadonlyState<T>) => void,\n): void {\n  getRegistry().forEach(BlocClass, callback);\n}\n","import { getRegistry } from './config';\nimport type { StateContainerConstructor } from '../types/utilities';\n\nexport function clear<T extends StateContainerConstructor>(BlocClass: T): void {\n  getRegistry().clear(BlocClass);\n}\n\nexport function clearAll(): void {\n  getRegistry().clearAll();\n}\n\nexport function register<T extends StateContainerConstructor>(\n  BlocClass: T,\n): void {\n  getRegistry().register(BlocClass);\n}\n"],"mappings":";;AAOA,SAAgB,YACd,WACA,MACS;CACT,MAAM,WAAW,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,YAAY,WAAW,GAAG;AAC5C;AAEA,SAAgB,YACd,WACA,MACQ;CACR,MAAM,WAAW,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,YAAY,WAAW,GAAG;AAC5C;AAEA,SAAgB,UACd,WACA,MACU;CACV,MAAM,WAAW,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,UAAU,WAAW,GAAG;AAC1C;AAEA,SAAgB,OACd,WAC4B;CAC5B,OAAO,YAAY,EAAE,OAAO,SAAS;AACvC;AAEA,SAAgB,QACd,WACA,UACM;CACN,YAAY,EAAE,QAAQ,WAAW,QAAQ;AAC3C;;;AC1CA,SAAgB,MAA2C,WAAoB;CAC7E,YAAY,EAAE,MAAM,SAAS;AAC/B;AAEA,SAAgB,WAAiB;CAC/B,YAAY,EAAE,SAAS;AACzB;AAEA,SAAgB,SACd,WACM;CACN,YAAY,EAAE,SAAS,SAAS;AAClC"}

package/dist/management-DAV9sN-k.cjs

@@ -0,0 +1,85 @@
+const require_config = require("./config-sCPKPYxZ.cjs");
+//#region src/registry/queries.ts
+function hasInstance(BlocClass, opts) {
+	const registry = require_config.getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.hasInstance(BlocClass, key);
+}
+function getRefCount(BlocClass, opts) {
+	const registry = require_config.getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.getRefCount(BlocClass, key);
+}
+function getRefIds(BlocClass, opts) {
+	const registry = require_config.getRegistry();
+	const key = registry.resolveKey(BlocClass, void 0, opts?.args);
+	return registry.getRefIds(BlocClass, key);
+}
+function getAll(BlocClass) {
+	return require_config.getRegistry().getAll(BlocClass);
+}
+function forEach(BlocClass, callback) {
+	require_config.getRegistry().forEach(BlocClass, callback);
+}
+//#endregion
+//#region src/registry/management.ts
+function clear(BlocClass) {
+	require_config.getRegistry().clear(BlocClass);
+}
+function clearAll() {
+	require_config.getRegistry().clearAll();
+}
+function register(BlocClass) {
+	require_config.getRegistry().register(BlocClass);
+}
+//#endregion
+Object.defineProperty(exports, "clear", {
+	enumerable: true,
+	get: function() {
+		return clear;
+	}
+});
+Object.defineProperty(exports, "clearAll", {
+	enumerable: true,
+	get: function() {
+		return clearAll;
+	}
+});
+Object.defineProperty(exports, "forEach", {
+	enumerable: true,
+	get: function() {
+		return forEach;
+	}
+});
+Object.defineProperty(exports, "getAll", {
+	enumerable: true,
+	get: function() {
+		return getAll;
+	}
+});
+Object.defineProperty(exports, "getRefCount", {
+	enumerable: true,
+	get: function() {
+		return getRefCount;
+	}
+});
+Object.defineProperty(exports, "getRefIds", {
+	enumerable: true,
+	get: function() {
+		return getRefIds;
+	}
+});
+Object.defineProperty(exports, "hasInstance", {
+	enumerable: true,
+	get: function() {
+		return hasInstance;
+	}
+});
+Object.defineProperty(exports, "register", {
+	enumerable: true,
+	get: function() {
+		return register;
+	}
+});
+
+//# sourceMappingURL=management-DAV9sN-k.cjs.map

package/dist/management-DAV9sN-k.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-DAV9sN-k.cjs","names":["getRegistry"],"sources":["../src/registry/queries.ts","../src/registry/management.ts"],"sourcesContent":["import { getRegistry } from './config';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n  InstanceReadonlyState,\n} from '../types/utilities';\n\nexport function hasInstance<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): boolean {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.hasInstance(BlocClass, key);\n}\n\nexport function getRefCount<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): number {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.getRefCount(BlocClass, key);\n}\n\nexport function getRefIds<T extends StateContainerConstructor>(\n  BlocClass: T,\n  opts?: { args?: ExtractArgs<T> },\n): string[] {\n  const registry = getRegistry();\n  const key = registry.resolveKey(BlocClass, undefined, opts?.args);\n  return registry.getRefIds(BlocClass, key);\n}\n\nexport function getAll<T extends StateContainerConstructor>(\n  BlocClass: T,\n): InstanceReadonlyState<T>[] {\n  return getRegistry().getAll(BlocClass);\n}\n\nexport function forEach<T extends StateContainerConstructor>(\n  BlocClass: T,\n  callback: (instance: InstanceReadonlyState<T>) => void,\n): void {\n  getRegistry().forEach(BlocClass, callback);\n}\n","import { getRegistry } from './config';\nimport type { StateContainerConstructor } from '../types/utilities';\n\nexport function clear<T extends StateContainerConstructor>(BlocClass: T): void {\n  getRegistry().clear(BlocClass);\n}\n\nexport function clearAll(): void {\n  getRegistry().clearAll();\n}\n\nexport function register<T extends StateContainerConstructor>(\n  BlocClass: T,\n): void {\n  getRegistry().register(BlocClass);\n}\n"],"mappings":";;AAOA,SAAgB,YACd,WACA,MACS;CACT,MAAM,WAAWA,eAAAA,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,YAAY,WAAW,GAAG;AAC5C;AAEA,SAAgB,YACd,WACA,MACQ;CACR,MAAM,WAAWA,eAAAA,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,YAAY,WAAW,GAAG;AAC5C;AAEA,SAAgB,UACd,WACA,MACU;CACV,MAAM,WAAWA,eAAAA,YAAY;CAC7B,MAAM,MAAM,SAAS,WAAW,WAAW,KAAA,GAAW,MAAM,IAAI;CAChE,OAAO,SAAS,UAAU,WAAW,GAAG;AAC1C;AAEA,SAAgB,OACd,WAC4B;CAC5B,OAAOA,eAAAA,YAAY,EAAE,OAAO,SAAS;AACvC;AAEA,SAAgB,QACd,WACA,UACM;CACN,eAAA,YAAY,EAAE,QAAQ,WAAW,QAAQ;AAC3C;;;AC1CA,SAAgB,MAA2C,WAAoB;CAC7E,eAAA,YAAY,EAAE,MAAM,SAAS;AAC/B;AAEA,SAAgB,WAAiB;CAC/B,eAAA,YAAY,EAAE,SAAS;AACzB;AAEA,SAAgB,SACd,WACM;CACN,eAAA,YAAY,EAAE,SAAS,SAAS;AAClC"}

package/dist/plugins.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_StateContainerRegistry = require("./StateContainerRegistry-FWKzPfS-.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-DJQqLrli.cjs");
 exports.PluginManager = require_StateContainerRegistry.PluginManager;
 exports.getPluginManager = require_StateContainerRegistry.getPluginManager;

package/dist/plugins.js

@@ -1,2 +1,2 @@
-import { c as PluginManager, n as getPluginManager } from "./StateContainerRegistry-B_ViBLvJ.js";
+import { c as PluginManager, n as getPluginManager } from "./StateContainerRegistry-B1GYx9Xo.js";
 export { PluginManager, getPluginManager };

package/dist/testing.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_StateContainerRegistry = require("./StateContainerRegistry-FWKzPfS-.cjs");
-const require_ensure = require("./ensure-CLQEx0Nn.cjs");
-const require_config = require("./config-DVMnlHLv.cjs");
-const require_acquire = require("./acquire-DHEOEVcj.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-DJQqLrli.cjs");
+const require_ensure = require("./ensure-Dx86f80B.cjs");
+const require_config = require("./config-sCPKPYxZ.cjs");
+const require_acquire = require("./acquire-CbMz7gWs.cjs");
 //#region src/testing.ts
 /** Synthetic owner id used by test helpers for pre-wired deps. */
 const TESTING_DEPS_OWNER = "testing-deps";

package/dist/testing.js

@@ -1,7 +1,7 @@
-import { t as StateContainerRegistry } from "./StateContainerRegistry-B_ViBLvJ.js";
-import { i as APPLY_DEPS, n as Cubit, t as ensure } from "./ensure-CPMiGvov.js";
-import { r as setRegistry, t as getRegistry } from "./config-8pyOC5gv.js";
-import { n as resolveInstanceKey } from "./acquire-Don7499S.js";
+import { t as StateContainerRegistry } from "./StateContainerRegistry-B1GYx9Xo.js";
+import { a as APPLY_DEPS, n as Cubit, t as ensure } from "./ensure-DzqGej43.js";
+import { r as setRegistry, t as getRegistry } from "./config-Dk1FxfXj.js";
+import { n as resolveInstanceKey } from "./acquire-G8aB3GAx.js";
 //#region src/testing.ts
 /** Synthetic owner id used by test helpers for pre-wired deps. */
 const TESTING_DEPS_OWNER = "testing-deps";

package/dist/watch-B91opmva.cjs

@@ -0,0 +1,70 @@
+const require_config = require("./config-sCPKPYxZ.cjs");
+const require_acquire = require("./acquire-CbMz7gWs.cjs");
+let _dirtytalk_structural = require("@dirtytalk/structural");
+//#region src/watch/watch.ts
+const STOP = Symbol("watch.STOP");
+const BLOC_REF_MARKER = Symbol("BlocRef");
+/**
+* Create a reference to a specific bloc instance, identified by its `args`.
+* The key is derived the same way `useBloc`/`acquire` derive it.
+*
+* @example
+* ```ts
+* watch(instance(UserBloc, { userId: 'user-123' }), (userBloc) => {
+*   console.log(userBloc.state.name);
+* });
+* ```
+*/
+function instance(BlocClass, args) {
+	return {
+		[BLOC_REF_MARKER]: true,
+		blocClass: BlocClass,
+		instanceId: require_acquire.resolveInstanceKey(BlocClass, args)
+	};
+}
+function isBlocRef(input) {
+	return typeof input === "object" && input !== null && BLOC_REF_MARKER in input;
+}
+function resolveBloc(input) {
+	const registry = require_config.getRegistry();
+	if (isBlocRef(input)) return registry.ensure(input.blocClass, input.instanceId);
+	return registry.ensure(input, registry.resolveKey(input, void 0, void 0));
+}
+function isArray(input) {
+	return Array.isArray(input);
+}
+function watchImpl(blocsOrBloc, callback) {
+	const isSingle = !isArray(blocsOrBloc);
+	const instances = (isSingle ? [blocsOrBloc] : blocsOrBloc).map(resolveBloc);
+	let disposed = false;
+	const subscriptions = [];
+	const cleanup = () => {
+		if (disposed) return;
+		disposed = true;
+		for (const unsub of subscriptions) unsub();
+		subscriptions.length = 0;
+	};
+	const runCallback = () => {
+		if (disposed) return;
+		if (callback(isSingle ? instances[0] : instances) === STOP) cleanup();
+	};
+	for (const inst of instances) subscriptions.push(inst.channel.subscribe(() => _dirtytalk_structural.ALL_PATHS, runCallback));
+	runCallback();
+	return cleanup;
+}
+const watch = Object.assign(watchImpl, { STOP });
+//#endregion
+Object.defineProperty(exports, "instance", {
+	enumerable: true,
+	get: function() {
+		return instance;
+	}
+});
+Object.defineProperty(exports, "watch", {
+	enumerable: true,
+	get: function() {
+		return watch;
+	}
+});
+
+//# sourceMappingURL=watch-B91opmva.cjs.map

package/dist/watch-B91opmva.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-B91opmva.cjs","names":["resolveInstanceKey","getRegistry","ALL_PATHS"],"sources":["../src/watch/watch.ts"],"sourcesContent":["import { ALL_PATHS } from '@dirtytalk/structural';\nimport { getRegistry } from '../registry';\nimport { resolveInstanceKey } from '../registry/acquire';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n  StateContainerInstance,\n} from '../types/utilities';\n\nconst STOP: unique symbol = Symbol('watch.STOP');\ntype StopSymbol = typeof STOP;\n\nconst BLOC_REF_MARKER = Symbol('BlocRef');\n\n/**\n * Reference to a specific bloc instance, identified by class + the resolved\n * key derived from its `args`.\n */\nexport interface BlocRef<T extends StateContainerConstructor> {\n  [BLOC_REF_MARKER]: true;\n  blocClass: T;\n  /** @internal The resolved instance key (derived from `args`). */\n  instanceId: string;\n}\n\n/**\n * Create a reference to a specific bloc instance, identified by its `args`.\n * The key is derived the same way `useBloc`/`acquire` derive it.\n *\n * @example\n * ```ts\n * watch(instance(UserBloc, { userId: 'user-123' }), (userBloc) => {\n *   console.log(userBloc.state.name);\n * });\n * ```\n */\nexport function instance<T extends StateContainerConstructor>(\n  BlocClass: T,\n  args?: ExtractArgs<T>,\n): BlocRef<T> {\n  return {\n    [BLOC_REF_MARKER]: true,\n    blocClass: BlocClass,\n    instanceId: resolveInstanceKey(BlocClass, args),\n  };\n}\n\nfunction isBlocRef(\n  input: unknown,\n): input is BlocRef<StateContainerConstructor> {\n  return (\n    typeof input === 'object' && input !== null && BLOC_REF_MARKER in input\n  );\n}\n\ntype BlocInput = StateContainerConstructor | BlocRef<StateContainerConstructor>;\n\ntype ExtractInstance<T> =\n  T extends BlocRef<infer C>\n    ? InstanceType<C>\n    : T extends StateContainerConstructor\n      ? InstanceType<T>\n      : never;\n\ntype ExtractInstances<T extends readonly BlocInput[]> = {\n  [K in keyof T]: ExtractInstance<T[K]>;\n};\n\n/**\n * Watch function signature for single bloc.\n */\nexport interface WatchSingleFn {\n  <T extends StateContainerConstructor>(\n    bloc: T | BlocRef<T>,\n    callback: (bloc: InstanceType<T>) => void | StopSymbol,\n  ): () => void;\n\n  STOP: StopSymbol;\n}\n\n/**\n * Watch function signature for multiple blocs.\n */\nexport interface WatchMultipleFn {\n  <T extends readonly BlocInput[]>(\n    blocs: T,\n    callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n  ): () => void;\n\n  STOP: StopSymbol;\n}\n\n/**\n * Combined watch function type.\n */\nexport interface WatchFn extends WatchSingleFn {\n  <T extends readonly BlocInput[]>(\n    blocs: T,\n    callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n  ): () => void;\n}\n\nfunction resolveBloc(input: BlocInput): StateContainerInstance {\n  const registry = getRegistry();\n  if (isBlocRef(input)) {\n    return registry.ensure(input.blocClass, input.instanceId);\n  }\n  return registry.ensure(\n    input,\n    registry.resolveKey(input, undefined, undefined),\n  );\n}\n\nfunction isArray(input: unknown): input is readonly BlocInput[] {\n  return Array.isArray(input);\n}\n\n/**\n * Watch one or more blocs for state changes.\n *\n * Thin wrapper around `container.channel.subscribe(ALL_PATHS, ...)`. The\n * callback fires once immediately, then on every state change of any of the\n * passed blocs. Returning `watch.STOP` from the callback tears down all\n * subscriptions.\n *\n * Note: subscriptions are microtask-deferred (per the DirtyChannel default\n * scheduler), so callbacks land asynchronously after `emit()`.\n *\n * @example Single bloc\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n *   console.log(userBloc.state.name);\n * });\n * ```\n *\n * @example Multiple blocs\n * ```ts\n * const unwatch = watch(\n *   [UserBloc, SettingsBloc] as const,\n *   ([userBloc, settingsBloc]) => {\n *     console.log(userBloc.state.name, settingsBloc.state.theme);\n *   }\n * );\n * ```\n *\n * @example With specific instance\n * ```ts\n * const unwatch = watch(\n *   instance(UserBloc, { userId: 'user-123' }),\n *   (userBloc) => {\n *     console.log(userBloc.state.name);\n *   }\n * );\n * ```\n *\n * @example Stop watching from callback\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n *   if (userBloc.state.done) {\n *     return watch.STOP;\n *   }\n * });\n * ```\n */\nfunction watchImpl<T extends StateContainerConstructor>(\n  bloc: T | BlocRef<T>,\n  callback: (bloc: InstanceType<T>) => void | StopSymbol,\n): () => void;\n\nfunction watchImpl<T extends readonly BlocInput[]>(\n  blocs: T,\n  callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n): () => void;\n\nfunction watchImpl(\n  blocsOrBloc: BlocInput | readonly BlocInput[],\n  callback: (blocsOrBloc: any) => void | StopSymbol,\n): () => void {\n  const isSingle = !isArray(blocsOrBloc);\n  const inputs = isSingle ? [blocsOrBloc] : blocsOrBloc;\n\n  const instances = inputs.map(resolveBloc);\n\n  let disposed = false;\n  const subscriptions: (() => void)[] = [];\n\n  const cleanup = () => {\n    if (disposed) return;\n    disposed = true;\n    for (const unsub of subscriptions) unsub();\n    subscriptions.length = 0;\n  };\n\n  const runCallback = () => {\n    if (disposed) return;\n    const arg = isSingle ? instances[0] : instances;\n    const result = callback(arg);\n    if (result === STOP) cleanup();\n  };\n\n  for (const inst of instances) {\n    subscriptions.push(inst.channel.subscribe(() => ALL_PATHS, runCallback));\n  }\n\n  // Fire once immediately so the consumer sees the current state.\n  runCallback();\n\n  return cleanup;\n}\n\nexport const watch: WatchFn = Object.assign(watchImpl, { STOP }) as WatchFn;\n"],"mappings":";;;;AASA,MAAM,OAAsB,OAAO,YAAY;AAG/C,MAAM,kBAAkB,OAAO,SAAS;;;;;;;;;;;;AAwBxC,SAAgB,SACd,WACA,MACY;CACZ,OAAO;GACJ,kBAAkB;EACnB,WAAW;EACX,YAAYA,gBAAAA,mBAAmB,WAAW,IAAI;CAChD;AACF;AAEA,SAAS,UACP,OAC6C;CAC7C,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,mBAAmB;AAEtE;AAiDA,SAAS,YAAY,OAA0C;CAC7D,MAAM,WAAWC,eAAAA,YAAY;CAC7B,IAAI,UAAU,KAAK,GACjB,OAAO,SAAS,OAAO,MAAM,WAAW,MAAM,UAAU;CAE1D,OAAO,SAAS,OACd,OACA,SAAS,WAAW,OAAO,KAAA,GAAW,KAAA,CAAS,CACjD;AACF;AAEA,SAAS,QAAQ,OAA+C;CAC9D,OAAO,MAAM,QAAQ,KAAK;AAC5B;AA2DA,SAAS,UACP,aACA,UACY;CACZ,MAAM,WAAW,CAAC,QAAQ,WAAW;CAGrC,MAAM,aAFS,WAAW,CAAC,WAAW,IAAI,aAEjB,IAAI,WAAW;CAExC,IAAI,WAAW;CACf,MAAM,gBAAgC,CAAC;CAEvC,MAAM,gBAAgB;EACpB,IAAI,UAAU;EACd,WAAW;EACX,KAAK,MAAM,SAAS,eAAe,MAAM;EACzC,cAAc,SAAS;CACzB;CAEA,MAAM,oBAAoB;EACxB,IAAI,UAAU;EAGd,IADe,SADH,WAAW,UAAU,KAAK,SAE7B,MAAM,MAAM,QAAQ;CAC/B;CAEA,KAAK,MAAM,QAAQ,WACjB,cAAc,KAAK,KAAK,QAAQ,gBAAgBC,sBAAAA,WAAW,WAAW,CAAC;CAIzE,YAAY;CAEZ,OAAO;AACT;AAEA,MAAa,QAAiB,OAAO,OAAO,WAAW,EAAE,KAAK,CAAC"}

package/dist/watch-DPVUwPUY.js

@@ -0,0 +1,59 @@
+import { t as getRegistry } from "./config-Dk1FxfXj.js";
+import { n as resolveInstanceKey } from "./acquire-G8aB3GAx.js";
+import { ALL_PATHS } from "@dirtytalk/structural";
+//#region src/watch/watch.ts
+const STOP = Symbol("watch.STOP");
+const BLOC_REF_MARKER = Symbol("BlocRef");
+/**
+* Create a reference to a specific bloc instance, identified by its `args`.
+* The key is derived the same way `useBloc`/`acquire` derive it.
+*
+* @example
+* ```ts
+* watch(instance(UserBloc, { userId: 'user-123' }), (userBloc) => {
+*   console.log(userBloc.state.name);
+* });
+* ```
+*/
+function instance(BlocClass, args) {
+	return {
+		[BLOC_REF_MARKER]: true,
+		blocClass: BlocClass,
+		instanceId: resolveInstanceKey(BlocClass, args)
+	};
+}
+function isBlocRef(input) {
+	return typeof input === "object" && input !== null && BLOC_REF_MARKER in input;
+}
+function resolveBloc(input) {
+	const registry = getRegistry();
+	if (isBlocRef(input)) return registry.ensure(input.blocClass, input.instanceId);
+	return registry.ensure(input, registry.resolveKey(input, void 0, void 0));
+}
+function isArray(input) {
+	return Array.isArray(input);
+}
+function watchImpl(blocsOrBloc, callback) {
+	const isSingle = !isArray(blocsOrBloc);
+	const instances = (isSingle ? [blocsOrBloc] : blocsOrBloc).map(resolveBloc);
+	let disposed = false;
+	const subscriptions = [];
+	const cleanup = () => {
+		if (disposed) return;
+		disposed = true;
+		for (const unsub of subscriptions) unsub();
+		subscriptions.length = 0;
+	};
+	const runCallback = () => {
+		if (disposed) return;
+		if (callback(isSingle ? instances[0] : instances) === STOP) cleanup();
+	};
+	for (const inst of instances) subscriptions.push(inst.channel.subscribe(() => ALL_PATHS, runCallback));
+	runCallback();
+	return cleanup;
+}
+const watch = Object.assign(watchImpl, { STOP });
+//#endregion
+export { watch as n, instance as t };
+
+//# sourceMappingURL=watch-DPVUwPUY.js.map

package/dist/watch-DPVUwPUY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-DPVUwPUY.js","names":[],"sources":["../src/watch/watch.ts"],"sourcesContent":["import { ALL_PATHS } from '@dirtytalk/structural';\nimport { getRegistry } from '../registry';\nimport { resolveInstanceKey } from '../registry/acquire';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n  StateContainerInstance,\n} from '../types/utilities';\n\nconst STOP: unique symbol = Symbol('watch.STOP');\ntype StopSymbol = typeof STOP;\n\nconst BLOC_REF_MARKER = Symbol('BlocRef');\n\n/**\n * Reference to a specific bloc instance, identified by class + the resolved\n * key derived from its `args`.\n */\nexport interface BlocRef<T extends StateContainerConstructor> {\n  [BLOC_REF_MARKER]: true;\n  blocClass: T;\n  /** @internal The resolved instance key (derived from `args`). */\n  instanceId: string;\n}\n\n/**\n * Create a reference to a specific bloc instance, identified by its `args`.\n * The key is derived the same way `useBloc`/`acquire` derive it.\n *\n * @example\n * ```ts\n * watch(instance(UserBloc, { userId: 'user-123' }), (userBloc) => {\n *   console.log(userBloc.state.name);\n * });\n * ```\n */\nexport function instance<T extends StateContainerConstructor>(\n  BlocClass: T,\n  args?: ExtractArgs<T>,\n): BlocRef<T> {\n  return {\n    [BLOC_REF_MARKER]: true,\n    blocClass: BlocClass,\n    instanceId: resolveInstanceKey(BlocClass, args),\n  };\n}\n\nfunction isBlocRef(\n  input: unknown,\n): input is BlocRef<StateContainerConstructor> {\n  return (\n    typeof input === 'object' && input !== null && BLOC_REF_MARKER in input\n  );\n}\n\ntype BlocInput = StateContainerConstructor | BlocRef<StateContainerConstructor>;\n\ntype ExtractInstance<T> =\n  T extends BlocRef<infer C>\n    ? InstanceType<C>\n    : T extends StateContainerConstructor\n      ? InstanceType<T>\n      : never;\n\ntype ExtractInstances<T extends readonly BlocInput[]> = {\n  [K in keyof T]: ExtractInstance<T[K]>;\n};\n\n/**\n * Watch function signature for single bloc.\n */\nexport interface WatchSingleFn {\n  <T extends StateContainerConstructor>(\n    bloc: T | BlocRef<T>,\n    callback: (bloc: InstanceType<T>) => void | StopSymbol,\n  ): () => void;\n\n  STOP: StopSymbol;\n}\n\n/**\n * Watch function signature for multiple blocs.\n */\nexport interface WatchMultipleFn {\n  <T extends readonly BlocInput[]>(\n    blocs: T,\n    callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n  ): () => void;\n\n  STOP: StopSymbol;\n}\n\n/**\n * Combined watch function type.\n */\nexport interface WatchFn extends WatchSingleFn {\n  <T extends readonly BlocInput[]>(\n    blocs: T,\n    callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n  ): () => void;\n}\n\nfunction resolveBloc(input: BlocInput): StateContainerInstance {\n  const registry = getRegistry();\n  if (isBlocRef(input)) {\n    return registry.ensure(input.blocClass, input.instanceId);\n  }\n  return registry.ensure(\n    input,\n    registry.resolveKey(input, undefined, undefined),\n  );\n}\n\nfunction isArray(input: unknown): input is readonly BlocInput[] {\n  return Array.isArray(input);\n}\n\n/**\n * Watch one or more blocs for state changes.\n *\n * Thin wrapper around `container.channel.subscribe(ALL_PATHS, ...)`. The\n * callback fires once immediately, then on every state change of any of the\n * passed blocs. Returning `watch.STOP` from the callback tears down all\n * subscriptions.\n *\n * Note: subscriptions are microtask-deferred (per the DirtyChannel default\n * scheduler), so callbacks land asynchronously after `emit()`.\n *\n * @example Single bloc\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n *   console.log(userBloc.state.name);\n * });\n * ```\n *\n * @example Multiple blocs\n * ```ts\n * const unwatch = watch(\n *   [UserBloc, SettingsBloc] as const,\n *   ([userBloc, settingsBloc]) => {\n *     console.log(userBloc.state.name, settingsBloc.state.theme);\n *   }\n * );\n * ```\n *\n * @example With specific instance\n * ```ts\n * const unwatch = watch(\n *   instance(UserBloc, { userId: 'user-123' }),\n *   (userBloc) => {\n *     console.log(userBloc.state.name);\n *   }\n * );\n * ```\n *\n * @example Stop watching from callback\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n *   if (userBloc.state.done) {\n *     return watch.STOP;\n *   }\n * });\n * ```\n */\nfunction watchImpl<T extends StateContainerConstructor>(\n  bloc: T | BlocRef<T>,\n  callback: (bloc: InstanceType<T>) => void | StopSymbol,\n): () => void;\n\nfunction watchImpl<T extends readonly BlocInput[]>(\n  blocs: T,\n  callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n): () => void;\n\nfunction watchImpl(\n  blocsOrBloc: BlocInput | readonly BlocInput[],\n  callback: (blocsOrBloc: any) => void | StopSymbol,\n): () => void {\n  const isSingle = !isArray(blocsOrBloc);\n  const inputs = isSingle ? [blocsOrBloc] : blocsOrBloc;\n\n  const instances = inputs.map(resolveBloc);\n\n  let disposed = false;\n  const subscriptions: (() => void)[] = [];\n\n  const cleanup = () => {\n    if (disposed) return;\n    disposed = true;\n    for (const unsub of subscriptions) unsub();\n    subscriptions.length = 0;\n  };\n\n  const runCallback = () => {\n    if (disposed) return;\n    const arg = isSingle ? instances[0] : instances;\n    const result = callback(arg);\n    if (result === STOP) cleanup();\n  };\n\n  for (const inst of instances) {\n    subscriptions.push(inst.channel.subscribe(() => ALL_PATHS, runCallback));\n  }\n\n  // Fire once immediately so the consumer sees the current state.\n  runCallback();\n\n  return cleanup;\n}\n\nexport const watch: WatchFn = Object.assign(watchImpl, { STOP }) as WatchFn;\n"],"mappings":";;;;AASA,MAAM,OAAsB,OAAO,YAAY;AAG/C,MAAM,kBAAkB,OAAO,SAAS;;;;;;;;;;;;AAwBxC,SAAgB,SACd,WACA,MACY;CACZ,OAAO;GACJ,kBAAkB;EACnB,WAAW;EACX,YAAY,mBAAmB,WAAW,IAAI;CAChD;AACF;AAEA,SAAS,UACP,OAC6C;CAC7C,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,mBAAmB;AAEtE;AAiDA,SAAS,YAAY,OAA0C;CAC7D,MAAM,WAAW,YAAY;CAC7B,IAAI,UAAU,KAAK,GACjB,OAAO,SAAS,OAAO,MAAM,WAAW,MAAM,UAAU;CAE1D,OAAO,SAAS,OACd,OACA,SAAS,WAAW,OAAO,KAAA,GAAW,KAAA,CAAS,CACjD;AACF;AAEA,SAAS,QAAQ,OAA+C;CAC9D,OAAO,MAAM,QAAQ,KAAK;AAC5B;AA2DA,SAAS,UACP,aACA,UACY;CACZ,MAAM,WAAW,CAAC,QAAQ,WAAW;CAGrC,MAAM,aAFS,WAAW,CAAC,WAAW,IAAI,aAEjB,IAAI,WAAW;CAExC,IAAI,WAAW;CACf,MAAM,gBAAgC,CAAC;CAEvC,MAAM,gBAAgB;EACpB,IAAI,UAAU;EACd,WAAW;EACX,KAAK,MAAM,SAAS,eAAe,MAAM;EACzC,cAAc,SAAS;CACzB;CAEA,MAAM,oBAAoB;EACxB,IAAI,UAAU;EAGd,IADe,SADH,WAAW,UAAU,KAAK,SAE7B,MAAM,MAAM,QAAQ;CAC/B;CAEA,KAAK,MAAM,QAAQ,WACjB,cAAc,KAAK,KAAK,QAAQ,gBAAgB,WAAW,WAAW,CAAC;CAIzE,YAAY;CAEZ,OAAO;AACT;AAEA,MAAa,QAAiB,OAAO,OAAO,WAAW,EAAE,KAAK,CAAC"}

package/dist/watch-entry.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_watch = require("./watch-CKWt788i.cjs");
+const require_watch = require("./watch-B91opmva.cjs");
 exports.instance = require_watch.instance;
 exports.watch = require_watch.watch;

package/dist/watch-entry.js

@@ -1,2 +1,2 @@
-import { n as watch, t as instance } from "./watch-BmC-Tyqg.js";
+import { n as watch, t as instance } from "./watch-DPVUwPUY.js";
 export { instance, watch };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blac/core",
-  "version": "2.0.16",
+  "version": "2.0.17",
   "license": "MIT",
   "author": "Brendan Mullins <jsnanigans@gmail.com>",
   "description": "Type-safe, class-based state management with proxy tracking and plugin system",
@@ -122,7 +122,7 @@
     }
   ],
   "dependencies": {
-    "@dirtytalk/structural": "^0.0.4"
+    "@dirtytalk/structural": "^0.0.5"
   },
   "devDependencies": {
     "@size-limit/preset-small-lib": "^11.1.6",