@blac/core 2.0.18 → 2.0.20

package/dist/management-QWLpbXlW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-QWLpbXlW.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/management-iE4x6IQY.cjs

@@ -0,0 +1,85 @@
+const require_config = require("./config-cwaTn5oy.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-iE4x6IQY.cjs.map

package/dist/management-iE4x6IQY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-iE4x6IQY.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/plugin/PluginManager.d.ts

@@ -98,6 +98,17 @@ export declare class PluginManager {
      */
     private attachStateBridge;
     private detachStateBridge;
+    /**
+     * Backfill a newly-installed plugin with the app's existing instances.
+     *
+     * Iterates every registered `Type` and its live instances (`getAll`
+     * already skips disposed), attaching the state bridge (idempotent — see
+     * `attachStateBridge`) and, if the plugin implements `onCreated`, invoking
+     * it directly for each instance. Scoped to this single plugin only — the
+     * broadcast `notifyPlugins` would re-notify *every* plugin of *every*
+     * instance, which is wrong here.
+     */
+    private backfillPlugin;
     /**
      * Channel-flush callback. Snapshots `next`, hands `(prev, next, paths)`
      * to every enabled plugin's `onStateChange`, then updates `prevState`
@@ -113,7 +124,9 @@ export declare class PluginManager {
      *
      * Builds a fresh `PluginContext` per dispatch (instance becomes
      * `ctx.container`), so plugins can reach the focal bloc through
-     * `ctx.container`.
+     * `ctx.container`. The context is built lazily on the first matching
+     * hook and reused for every other plugin in this dispatch — zero
+     * builds if no enabled plugin implements `hookName`.
      */
     private notifyPlugins;
     /**

package/dist/plugins.cjs

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

package/dist/plugins.js

@@ -1,2 +1,2 @@
-import { d as PluginManager, n as getPluginManager } from "./StateContainerRegistry-CvBOhAT2.js";
+import { f as PluginManager, n as getPluginManager } from "./StateContainerRegistry-D8nu7Z0T.js";
 export { PluginManager, getPluginManager };

package/dist/testing.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_StateContainerRegistry = require("./StateContainerRegistry-CSNm2Ws5.cjs");
-const require_ensure = require("./ensure-B9oOqpOB.cjs");
-const require_config = require("./config-C7Ktkjh2.cjs");
-const require_acquire = require("./acquire-B1Wuqla6.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-CS18y4au.cjs");
+const require_ensure = require("./ensure-B2DYCbbI.cjs");
+const require_config = require("./config-DWUq7zEQ.cjs");
+const require_acquire = require("./acquire-BJ3xUEmh.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 { a as INIT_CONFIG, i as APPLY_DEPS, t as StateContainerRegistry } from "./StateContainerRegistry-CvBOhAT2.js";
-import { n as Cubit, t as ensure } from "./ensure-C1a8IFWy.js";
-import { r as setRegistry, t as getRegistry } from "./config-buwpT7l3.js";
-import { n as resolveInstanceKey } from "./acquire-BP-ZfUH2.js";
+import { a as INIT_CONFIG, i as APPLY_DEPS, t as StateContainerRegistry } from "./StateContainerRegistry-D8nu7Z0T.js";
+import { n as Cubit, t as ensure } from "./ensure-BSJHkUNX.js";
+import { r as setRegistry, t as getRegistry } from "./config-DXI3kzmA.js";
+import { n as resolveInstanceKey } from "./acquire-B1LYXSGj.js";
 //#region src/testing.ts
 /** Synthetic owner id used by test helpers for pre-wired deps. */
 const TESTING_DEPS_OWNER = "testing-deps";

package/dist/utils/idGenerator.d.ts

@@ -4,37 +4,6 @@
  * Provides consistent, collision-resistant ID generation for all BlaC subsystems.
  * Uses timestamp + counter + random suffix for uniqueness.
  */
-/**
- * Creates an ID generator with isolated counter state
- *
- * @param prefix - Prefix for generated IDs
- * @returns Object with next(), nextSimple(), and reset() methods
- *
- * @example
- * ```ts
- * const generator = createIdGenerator('sub');
- * const id1 = generator.next(); // "sub:1698765432100_1_a3k9d7f2q"
- * const id2 = generator.next(); // "sub:1698765432101_2_b4n8e9g3r"
- * ```
- */
-export declare function createIdGenerator(prefix: string): {
-    next: () => string;
-    nextSimple: () => string;
-    reset: () => void;
-};
-/**
- * Generate ID with timestamp, counter, and random suffix (tree-shakeable)
- *
- * Format: `${prefix}:${timestamp}_${counter}_${random}`
- *
- * @param prefix - Prefix for the ID (e.g., 'sub', 'consumer', 'stage')
- * @returns Branded ID string
- *
- * @example
- * const id = generateId('sub');
- * // Returns: "sub:1698765432100_1_a3k9d7f2q"
- */
-export declare function generateId(prefix: string): string;
 /**
  * Generate simple ID with timestamp and random (no counter tracking)
  *
@@ -50,8 +19,3 @@ export declare function generateId(prefix: string): string;
  * ```
  */
 export declare function generateSimpleId(prefix: string, affix?: string): string;
-/**
- * Reset all counters for testing purposes
- * @internal
- */
-export declare function __resetIdCounters(): void;

package/dist/watch/watch.d.ts

@@ -11,6 +11,12 @@ export interface BlocRef<T extends StateContainerConstructor> {
     blocClass: T;
     /** @internal The resolved instance key (derived from `args`). */
     instanceId: string;
+    /**
+     * @internal The `args` used to derive `instanceId`. Forwarded to
+     * `registry.acquire` so a not-yet-created instance is initialized with
+     * these args instead of `undefined`.
+     */
+    args?: unknown;
 }
 /**
  * Create a reference to a specific bloc instance, identified by its `args`.

package/dist/watch-B0pUfh-v.cjs

@@ -0,0 +1,119 @@
+const require_StateContainerRegistry = require("./StateContainerRegistry-Bx2ly-ba.cjs");
+const require_config = require("./config-cwaTn5oy.cjs");
+const require_acquire = require("./acquire-B_p1fNEh.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),
+		args
+	};
+}
+function isBlocRef(input) {
+	return typeof input === "object" && input !== null && BLOC_REF_MARKER in input;
+}
+function toWatchTarget(input) {
+	const registry = require_config.getRegistry();
+	if (isBlocRef(input)) return {
+		blocClass: input.blocClass,
+		key: input.instanceId,
+		args: input.args
+	};
+	return {
+		blocClass: input,
+		key: registry.resolveKey(input, void 0, void 0),
+		args: void 0
+	};
+}
+let watchRefSeq = 0;
+/**
+* Acquire a real ref (countRef: true) for the target, carrying its `args`
+* through so a not-yet-created instance is initialized correctly. The
+* caller is responsible for releasing `refId` in cleanup.
+*/
+function resolveBloc(target, refId) {
+	return require_config.getRegistry().acquire(target.blocClass, target.key, {
+		countRef: true,
+		refId,
+		args: target.args
+	});
+}
+function isArray(input) {
+	return Array.isArray(input);
+}
+function watchImpl(blocsOrBloc, callback) {
+	const isSingle = !isArray(blocsOrBloc);
+	const inputs = isSingle ? [blocsOrBloc] : blocsOrBloc;
+	const registry = require_config.getRegistry();
+	const targets = inputs.map(toWatchTarget);
+	const refIds = targets.map(() => `_watch_${watchRefSeq++}`);
+	let disposed = false;
+	const instances = targets.map((target, i) => resolveBloc(target, refIds[i]));
+	const channelUnsubs = [];
+	const disposedUnsubs = [];
+	const cleanup = () => {
+		if (disposed) return;
+		disposed = true;
+		for (const unsub of channelUnsubs) unsub?.();
+		for (const unsub of disposedUnsubs) unsub();
+		channelUnsubs.length = 0;
+		disposedUnsubs.length = 0;
+		for (let i = 0; i < targets.length; i++) registry.release(targets[i].blocClass, targets[i].key, false, refIds[i]);
+	};
+	const runCallback = () => {
+		if (disposed) return;
+		if (callback(isSingle ? instances[0] : instances) === STOP) cleanup();
+	};
+	const subscribeAt = (index) => {
+		channelUnsubs[index] = instances[index].channel.subscribe(() => _dirtytalk_structural.ALL_PATHS, runCallback);
+	};
+	const resubscribeAt = (index) => {
+		if (disposed) return;
+		instances[index] = resolveBloc(targets[index], refIds[index]);
+		subscribeAt(index);
+		subscribeDisposeAt(index);
+		runCallback();
+	};
+	const subscribeDisposeAt = (index) => {
+		disposedUnsubs[index] = instances[index][require_StateContainerRegistry.ON_DISPOSE](() => {
+			channelUnsubs[index]?.();
+			channelUnsubs[index] = void 0;
+			queueMicrotask(() => resubscribeAt(index));
+		});
+	};
+	for (let i = 0; i < instances.length; i++) subscribeAt(i);
+	for (let i = 0; i < instances.length; i++) subscribeDisposeAt(i);
+	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-B0pUfh-v.cjs.map

package/dist/watch-B0pUfh-v.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-B0pUfh-v.cjs","names":["resolveInstanceKey","getRegistry","ALL_PATHS","ON_DISPOSE"],"sources":["../src/watch/watch.ts"],"sourcesContent":["import { ALL_PATHS } from '@dirtytalk/structural';\nimport { ON_DISPOSE } from '../core/symbols';\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   * @internal The `args` used to derive `instanceId`. Forwarded to\n   * `registry.acquire` so a not-yet-created instance is initialized with\n   * these args instead of `undefined`.\n   */\n  args?: unknown;\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    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\n/**\n * Class + resolved key + args needed to (re-)acquire a specific instance.\n * `watch` keeps this around per input so it can re-acquire the same logical\n * instance if the underlying container is disposed elsewhere.\n */\ninterface WatchTarget {\n  blocClass: StateContainerConstructor;\n  key: string;\n  args: unknown;\n}\n\nfunction toWatchTarget(input: BlocInput): WatchTarget {\n  const registry = getRegistry();\n  if (isBlocRef(input)) {\n    return {\n      blocClass: input.blocClass,\n      key: input.instanceId,\n      args: input.args,\n    };\n  }\n  return {\n    blocClass: input,\n    key: registry.resolveKey(input, undefined, undefined),\n    args: undefined,\n  };\n}\n\nlet watchRefSeq = 0;\n\n/**\n * Acquire a real ref (countRef: true) for the target, carrying its `args`\n * through so a not-yet-created instance is initialized correctly. The\n * caller is responsible for releasing `refId` in cleanup.\n */\nfunction resolveBloc(\n  target: WatchTarget,\n  refId: string,\n): StateContainerInstance {\n  const registry = getRegistry();\n  return registry.acquire(target.blocClass, target.key, {\n    countRef: true,\n    refId,\n    args: target.args,\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  const registry = getRegistry();\n\n  const targets = inputs.map(toWatchTarget);\n  const refIds = targets.map(() => `_watch_${watchRefSeq++}`);\n\n  let disposed = false;\n  const instances: StateContainerInstance[] = targets.map((target, i) =>\n    resolveBloc(target, refIds[i]),\n  );\n  const channelUnsubs: Array<(() => void) | undefined> = [];\n  const disposedUnsubs: Array<() => void> = [];\n\n  const cleanup = () => {\n    if (disposed) return;\n    disposed = true;\n    for (const unsub of channelUnsubs) unsub?.();\n    for (const unsub of disposedUnsubs) unsub();\n    channelUnsubs.length = 0;\n    disposedUnsubs.length = 0;\n    for (let i = 0; i < targets.length; i++) {\n      registry.release(targets[i].blocClass, targets[i].key, false, refIds[i]);\n    }\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  const subscribeAt = (index: number) => {\n    channelUnsubs[index] = instances[index].channel.subscribe(\n      () => ALL_PATHS,\n      runCallback,\n    );\n  };\n\n  // On external dispose, tear down the stale subscription and re-acquire +\n  // resubscribe (microtask-deferred, so it never runs mid-mutation of the\n  // registry that triggered the dispose, e.g. `clearAll()`), then notify.\n  const resubscribeAt = (index: number) => {\n    if (disposed) return;\n    instances[index] = resolveBloc(targets[index], refIds[index]);\n    subscribeAt(index);\n    subscribeDisposeAt(index);\n    runCallback();\n  };\n\n  const subscribeDisposeAt = (index: number) => {\n    disposedUnsubs[index] = instances[index][ON_DISPOSE](() => {\n      channelUnsubs[index]?.();\n      channelUnsubs[index] = undefined;\n      queueMicrotask(() => resubscribeAt(index));\n    });\n  };\n\n  for (let i = 0; i < instances.length; i++) {\n    subscribeAt(i);\n  }\n\n  for (let i = 0; i < instances.length; i++) {\n    subscribeDisposeAt(i);\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":";;;;;AAUA,MAAM,OAAsB,OAAO,YAAY;AAG/C,MAAM,kBAAkB,OAAO,SAAS;;;;;;;;;;;;AA8BxC,SAAgB,SACd,WACA,MACY;CACZ,OAAO;GACJ,kBAAkB;EACnB,WAAW;EACX,YAAYA,gBAAAA,mBAAmB,WAAW,IAAI;EAC9C;CACF;AACF;AAEA,SAAS,UACP,OAC6C;CAC7C,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,mBAAmB;AAEtE;AA4DA,SAAS,cAAc,OAA+B;CACpD,MAAM,WAAWC,eAAAA,YAAY;CAC7B,IAAI,UAAU,KAAK,GACjB,OAAO;EACL,WAAW,MAAM;EACjB,KAAK,MAAM;EACX,MAAM,MAAM;CACd;CAEF,OAAO;EACL,WAAW;EACX,KAAK,SAAS,WAAW,OAAO,KAAA,GAAW,KAAA,CAAS;EACpD,MAAM,KAAA;CACR;AACF;AAEA,IAAI,cAAc;;;;;;AAOlB,SAAS,YACP,QACA,OACwB;CAExB,OADiBA,eAAAA,YACH,EAAE,QAAQ,OAAO,WAAW,OAAO,KAAK;EACpD,UAAU;EACV;EACA,MAAM,OAAO;CACf,CAAC;AACH;AAEA,SAAS,QAAQ,OAA+C;CAC9D,OAAO,MAAM,QAAQ,KAAK;AAC5B;AA2DA,SAAS,UACP,aACA,UACY;CACZ,MAAM,WAAW,CAAC,QAAQ,WAAW;CACrC,MAAM,SAAS,WAAW,CAAC,WAAW,IAAI;CAC1C,MAAM,WAAWA,eAAAA,YAAY;CAE7B,MAAM,UAAU,OAAO,IAAI,aAAa;CACxC,MAAM,SAAS,QAAQ,UAAU,UAAU,eAAe;CAE1D,IAAI,WAAW;CACf,MAAM,YAAsC,QAAQ,KAAK,QAAQ,MAC/D,YAAY,QAAQ,OAAO,EAAE,CAC/B;CACA,MAAM,gBAAiD,CAAC;CACxD,MAAM,iBAAoC,CAAC;CAE3C,MAAM,gBAAgB;EACpB,IAAI,UAAU;EACd,WAAW;EACX,KAAK,MAAM,SAAS,eAAe,QAAQ;EAC3C,KAAK,MAAM,SAAS,gBAAgB,MAAM;EAC1C,cAAc,SAAS;EACvB,eAAe,SAAS;EACxB,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAClC,SAAS,QAAQ,QAAQ,GAAG,WAAW,QAAQ,GAAG,KAAK,OAAO,OAAO,EAAE;CAE3E;CAEA,MAAM,oBAAoB;EACxB,IAAI,UAAU;EAGd,IADe,SADH,WAAW,UAAU,KAAK,SAE7B,MAAM,MAAM,QAAQ;CAC/B;CAEA,MAAM,eAAe,UAAkB;EACrC,cAAc,SAAS,UAAU,OAAO,QAAQ,gBACxCC,sBAAAA,WACN,WACF;CACF;CAKA,MAAM,iBAAiB,UAAkB;EACvC,IAAI,UAAU;EACd,UAAU,SAAS,YAAY,QAAQ,QAAQ,OAAO,MAAM;EAC5D,YAAY,KAAK;EACjB,mBAAmB,KAAK;EACxB,YAAY;CACd;CAEA,MAAM,sBAAsB,UAAkB;EAC5C,eAAe,SAAS,UAAU,OAAOC,+BAAAA,kBAAkB;GACzD,cAAc,SAAS;GACvB,cAAc,SAAS,KAAA;GACvB,qBAAqB,cAAc,KAAK,CAAC;EAC3C,CAAC;CACH;CAEA,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KACpC,YAAY,CAAC;CAGf,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KACpC,mBAAmB,CAAC;CAItB,YAAY;CAEZ,OAAO;AACT;AAEA,MAAa,QAAiB,OAAO,OAAO,WAAW,EAAE,KAAK,CAAC"}

package/dist/watch-BHfCtbn1.cjs

@@ -0,0 +1,119 @@
+const require_config = require("./config-B1l8ZGlU.cjs");
+const require_acquire = require("./acquire-C4WAS13G.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),
+		args
+	};
+}
+function isBlocRef(input) {
+	return typeof input === "object" && input !== null && BLOC_REF_MARKER in input;
+}
+function toWatchTarget(input) {
+	const registry = require_config.getRegistry();
+	if (isBlocRef(input)) return {
+		blocClass: input.blocClass,
+		key: input.instanceId,
+		args: input.args
+	};
+	return {
+		blocClass: input,
+		key: registry.resolveKey(input, void 0, void 0),
+		args: void 0
+	};
+}
+let watchRefSeq = 0;
+/**
+* Acquire a real ref (countRef: true) for the target, carrying its `args`
+* through so a not-yet-created instance is initialized correctly. The
+* caller is responsible for releasing `refId` in cleanup.
+*/
+function resolveBloc(target, refId) {
+	return require_config.getRegistry().acquire(target.blocClass, target.key, {
+		countRef: true,
+		refId,
+		args: target.args
+	});
+}
+function isArray(input) {
+	return Array.isArray(input);
+}
+function watchImpl(blocsOrBloc, callback) {
+	const isSingle = !isArray(blocsOrBloc);
+	const inputs = isSingle ? [blocsOrBloc] : blocsOrBloc;
+	const registry = require_config.getRegistry();
+	const targets = inputs.map(toWatchTarget);
+	const refIds = targets.map(() => `_watch_${watchRefSeq++}`);
+	let disposed = false;
+	const instances = targets.map((target, i) => resolveBloc(target, refIds[i]));
+	const channelUnsubs = [];
+	const disposedUnsubs = [];
+	const cleanup = () => {
+		if (disposed) return;
+		disposed = true;
+		for (const unsub of channelUnsubs) unsub?.();
+		for (const unsub of disposedUnsubs) unsub();
+		channelUnsubs.length = 0;
+		disposedUnsubs.length = 0;
+		for (let i = 0; i < targets.length; i++) registry.release(targets[i].blocClass, targets[i].key, false, refIds[i]);
+	};
+	const runCallback = () => {
+		if (disposed) return;
+		if (callback(isSingle ? instances[0] : instances) === STOP) cleanup();
+	};
+	const subscribeAt = (index) => {
+		channelUnsubs[index] = instances[index].channel.subscribe(() => _dirtytalk_structural.ALL_PATHS, runCallback);
+	};
+	const resubscribeAt = (index) => {
+		if (disposed) return;
+		instances[index] = resolveBloc(targets[index], refIds[index]);
+		subscribeAt(index);
+		runCallback();
+	};
+	for (let i = 0; i < instances.length; i++) subscribeAt(i);
+	for (let i = 0; i < instances.length; i++) {
+		const index = i;
+		disposedUnsubs.push(registry.on("disposed", (container) => {
+			if (disposed) return;
+			if (container !== instances[index]) return;
+			channelUnsubs[index]?.();
+			channelUnsubs[index] = void 0;
+			queueMicrotask(() => resubscribeAt(index));
+		}));
+	}
+	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-BHfCtbn1.cjs.map

package/dist/watch-BHfCtbn1.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-BHfCtbn1.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   * @internal The `args` used to derive `instanceId`. Forwarded to\n   * `registry.acquire` so a not-yet-created instance is initialized with\n   * these args instead of `undefined`.\n   */\n  args?: unknown;\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    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\n/**\n * Class + resolved key + args needed to (re-)acquire a specific instance.\n * `watch` keeps this around per input so it can re-acquire the same logical\n * instance if the underlying container is disposed elsewhere.\n */\ninterface WatchTarget {\n  blocClass: StateContainerConstructor;\n  key: string;\n  args: unknown;\n}\n\nfunction toWatchTarget(input: BlocInput): WatchTarget {\n  const registry = getRegistry();\n  if (isBlocRef(input)) {\n    return {\n      blocClass: input.blocClass,\n      key: input.instanceId,\n      args: input.args,\n    };\n  }\n  return {\n    blocClass: input,\n    key: registry.resolveKey(input, undefined, undefined),\n    args: undefined,\n  };\n}\n\nlet watchRefSeq = 0;\n\n/**\n * Acquire a real ref (countRef: true) for the target, carrying its `args`\n * through so a not-yet-created instance is initialized correctly. The\n * caller is responsible for releasing `refId` in cleanup.\n */\nfunction resolveBloc(\n  target: WatchTarget,\n  refId: string,\n): StateContainerInstance {\n  const registry = getRegistry();\n  return registry.acquire(target.blocClass, target.key, {\n    countRef: true,\n    refId,\n    args: target.args,\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  const registry = getRegistry();\n\n  const targets = inputs.map(toWatchTarget);\n  const refIds = targets.map(() => `_watch_${watchRefSeq++}`);\n\n  let disposed = false;\n  const instances: StateContainerInstance[] = targets.map((target, i) =>\n    resolveBloc(target, refIds[i]),\n  );\n  const channelUnsubs: Array<(() => void) | undefined> = [];\n  const disposedUnsubs: Array<() => void> = [];\n\n  const cleanup = () => {\n    if (disposed) return;\n    disposed = true;\n    for (const unsub of channelUnsubs) unsub?.();\n    for (const unsub of disposedUnsubs) unsub();\n    channelUnsubs.length = 0;\n    disposedUnsubs.length = 0;\n    for (let i = 0; i < targets.length; i++) {\n      registry.release(targets[i].blocClass, targets[i].key, false, refIds[i]);\n    }\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  const subscribeAt = (index: number) => {\n    channelUnsubs[index] = instances[index].channel.subscribe(\n      () => ALL_PATHS,\n      runCallback,\n    );\n  };\n\n  // On external dispose, tear down the stale subscription and re-acquire +\n  // resubscribe (microtask-deferred, so it never runs mid-mutation of the\n  // registry that triggered the dispose, e.g. `clearAll()`), then notify.\n  const resubscribeAt = (index: number) => {\n    if (disposed) return;\n    instances[index] = resolveBloc(targets[index], refIds[index]);\n    subscribeAt(index);\n    runCallback();\n  };\n\n  for (let i = 0; i < instances.length; i++) {\n    subscribeAt(i);\n  }\n\n  for (let i = 0; i < instances.length; i++) {\n    const index = i;\n    disposedUnsubs.push(\n      registry.on('disposed', (container) => {\n        if (disposed) return;\n        if (container !== instances[index]) return;\n        channelUnsubs[index]?.();\n        channelUnsubs[index] = undefined;\n        queueMicrotask(() => resubscribeAt(index));\n      }),\n    );\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;;;;;;;;;;;;AA8BxC,SAAgB,SACd,WACA,MACY;CACZ,OAAO;GACJ,kBAAkB;EACnB,WAAW;EACX,YAAYA,gBAAAA,mBAAmB,WAAW,IAAI;EAC9C;CACF;AACF;AAEA,SAAS,UACP,OAC6C;CAC7C,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,mBAAmB;AAEtE;AA4DA,SAAS,cAAc,OAA+B;CACpD,MAAM,WAAWC,eAAAA,YAAY;CAC7B,IAAI,UAAU,KAAK,GACjB,OAAO;EACL,WAAW,MAAM;EACjB,KAAK,MAAM;EACX,MAAM,MAAM;CACd;CAEF,OAAO;EACL,WAAW;EACX,KAAK,SAAS,WAAW,OAAO,KAAA,GAAW,KAAA,CAAS;EACpD,MAAM,KAAA;CACR;AACF;AAEA,IAAI,cAAc;;;;;;AAOlB,SAAS,YACP,QACA,OACwB;CAExB,OADiBA,eAAAA,YACH,EAAE,QAAQ,OAAO,WAAW,OAAO,KAAK;EACpD,UAAU;EACV;EACA,MAAM,OAAO;CACf,CAAC;AACH;AAEA,SAAS,QAAQ,OAA+C;CAC9D,OAAO,MAAM,QAAQ,KAAK;AAC5B;AA2DA,SAAS,UACP,aACA,UACY;CACZ,MAAM,WAAW,CAAC,QAAQ,WAAW;CACrC,MAAM,SAAS,WAAW,CAAC,WAAW,IAAI;CAC1C,MAAM,WAAWA,eAAAA,YAAY;CAE7B,MAAM,UAAU,OAAO,IAAI,aAAa;CACxC,MAAM,SAAS,QAAQ,UAAU,UAAU,eAAe;CAE1D,IAAI,WAAW;CACf,MAAM,YAAsC,QAAQ,KAAK,QAAQ,MAC/D,YAAY,QAAQ,OAAO,EAAE,CAC/B;CACA,MAAM,gBAAiD,CAAC;CACxD,MAAM,iBAAoC,CAAC;CAE3C,MAAM,gBAAgB;EACpB,IAAI,UAAU;EACd,WAAW;EACX,KAAK,MAAM,SAAS,eAAe,QAAQ;EAC3C,KAAK,MAAM,SAAS,gBAAgB,MAAM;EAC1C,cAAc,SAAS;EACvB,eAAe,SAAS;EACxB,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAClC,SAAS,QAAQ,QAAQ,GAAG,WAAW,QAAQ,GAAG,KAAK,OAAO,OAAO,EAAE;CAE3E;CAEA,MAAM,oBAAoB;EACxB,IAAI,UAAU;EAGd,IADe,SADH,WAAW,UAAU,KAAK,SAE7B,MAAM,MAAM,QAAQ;CAC/B;CAEA,MAAM,eAAe,UAAkB;EACrC,cAAc,SAAS,UAAU,OAAO,QAAQ,gBACxCC,sBAAAA,WACN,WACF;CACF;CAKA,MAAM,iBAAiB,UAAkB;EACvC,IAAI,UAAU;EACd,UAAU,SAAS,YAAY,QAAQ,QAAQ,OAAO,MAAM;EAC5D,YAAY,KAAK;EACjB,YAAY;CACd;CAEA,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KACpC,YAAY,CAAC;CAGf,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EACzC,MAAM,QAAQ;EACd,eAAe,KACb,SAAS,GAAG,aAAa,cAAc;GACrC,IAAI,UAAU;GACd,IAAI,cAAc,UAAU,QAAQ;GACpC,cAAc,SAAS;GACvB,cAAc,SAAS,KAAA;GACvB,qBAAqB,cAAc,KAAK,CAAC;EAC3C,CAAC,CACH;CACF;CAGA,YAAY;CAEZ,OAAO;AACT;AAEA,MAAa,QAAiB,OAAO,OAAO,WAAW,EAAE,KAAK,CAAC"}

package/dist/watch-Bx0y-Kcc.js

@@ -0,0 +1,108 @@
+import { o as ON_DISPOSE } from "./StateContainerRegistry-8zNFMAf7.js";
+import { t as getRegistry } from "./config-DOO82lbZ.js";
+import { n as resolveInstanceKey } from "./acquire-BdsVZBSe.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),
+		args
+	};
+}
+function isBlocRef(input) {
+	return typeof input === "object" && input !== null && BLOC_REF_MARKER in input;
+}
+function toWatchTarget(input) {
+	const registry = getRegistry();
+	if (isBlocRef(input)) return {
+		blocClass: input.blocClass,
+		key: input.instanceId,
+		args: input.args
+	};
+	return {
+		blocClass: input,
+		key: registry.resolveKey(input, void 0, void 0),
+		args: void 0
+	};
+}
+let watchRefSeq = 0;
+/**
+* Acquire a real ref (countRef: true) for the target, carrying its `args`
+* through so a not-yet-created instance is initialized correctly. The
+* caller is responsible for releasing `refId` in cleanup.
+*/
+function resolveBloc(target, refId) {
+	return getRegistry().acquire(target.blocClass, target.key, {
+		countRef: true,
+		refId,
+		args: target.args
+	});
+}
+function isArray(input) {
+	return Array.isArray(input);
+}
+function watchImpl(blocsOrBloc, callback) {
+	const isSingle = !isArray(blocsOrBloc);
+	const inputs = isSingle ? [blocsOrBloc] : blocsOrBloc;
+	const registry = getRegistry();
+	const targets = inputs.map(toWatchTarget);
+	const refIds = targets.map(() => `_watch_${watchRefSeq++}`);
+	let disposed = false;
+	const instances = targets.map((target, i) => resolveBloc(target, refIds[i]));
+	const channelUnsubs = [];
+	const disposedUnsubs = [];
+	const cleanup = () => {
+		if (disposed) return;
+		disposed = true;
+		for (const unsub of channelUnsubs) unsub?.();
+		for (const unsub of disposedUnsubs) unsub();
+		channelUnsubs.length = 0;
+		disposedUnsubs.length = 0;
+		for (let i = 0; i < targets.length; i++) registry.release(targets[i].blocClass, targets[i].key, false, refIds[i]);
+	};
+	const runCallback = () => {
+		if (disposed) return;
+		if (callback(isSingle ? instances[0] : instances) === STOP) cleanup();
+	};
+	const subscribeAt = (index) => {
+		channelUnsubs[index] = instances[index].channel.subscribe(() => ALL_PATHS, runCallback);
+	};
+	const resubscribeAt = (index) => {
+		if (disposed) return;
+		instances[index] = resolveBloc(targets[index], refIds[index]);
+		subscribeAt(index);
+		subscribeDisposeAt(index);
+		runCallback();
+	};
+	const subscribeDisposeAt = (index) => {
+		disposedUnsubs[index] = instances[index][ON_DISPOSE](() => {
+			channelUnsubs[index]?.();
+			channelUnsubs[index] = void 0;
+			queueMicrotask(() => resubscribeAt(index));
+		});
+	};
+	for (let i = 0; i < instances.length; i++) subscribeAt(i);
+	for (let i = 0; i < instances.length; i++) subscribeDisposeAt(i);
+	runCallback();
+	return cleanup;
+}
+const watch = Object.assign(watchImpl, { STOP });
+//#endregion
+export { watch as n, instance as t };
+
+//# sourceMappingURL=watch-Bx0y-Kcc.js.map

package/dist/watch-Bx0y-Kcc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-Bx0y-Kcc.js","names":[],"sources":["../src/watch/watch.ts"],"sourcesContent":["import { ALL_PATHS } from '@dirtytalk/structural';\nimport { ON_DISPOSE } from '../core/symbols';\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   * @internal The `args` used to derive `instanceId`. Forwarded to\n   * `registry.acquire` so a not-yet-created instance is initialized with\n   * these args instead of `undefined`.\n   */\n  args?: unknown;\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    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\n/**\n * Class + resolved key + args needed to (re-)acquire a specific instance.\n * `watch` keeps this around per input so it can re-acquire the same logical\n * instance if the underlying container is disposed elsewhere.\n */\ninterface WatchTarget {\n  blocClass: StateContainerConstructor;\n  key: string;\n  args: unknown;\n}\n\nfunction toWatchTarget(input: BlocInput): WatchTarget {\n  const registry = getRegistry();\n  if (isBlocRef(input)) {\n    return {\n      blocClass: input.blocClass,\n      key: input.instanceId,\n      args: input.args,\n    };\n  }\n  return {\n    blocClass: input,\n    key: registry.resolveKey(input, undefined, undefined),\n    args: undefined,\n  };\n}\n\nlet watchRefSeq = 0;\n\n/**\n * Acquire a real ref (countRef: true) for the target, carrying its `args`\n * through so a not-yet-created instance is initialized correctly. The\n * caller is responsible for releasing `refId` in cleanup.\n */\nfunction resolveBloc(\n  target: WatchTarget,\n  refId: string,\n): StateContainerInstance {\n  const registry = getRegistry();\n  return registry.acquire(target.blocClass, target.key, {\n    countRef: true,\n    refId,\n    args: target.args,\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  const registry = getRegistry();\n\n  const targets = inputs.map(toWatchTarget);\n  const refIds = targets.map(() => `_watch_${watchRefSeq++}`);\n\n  let disposed = false;\n  const instances: StateContainerInstance[] = targets.map((target, i) =>\n    resolveBloc(target, refIds[i]),\n  );\n  const channelUnsubs: Array<(() => void) | undefined> = [];\n  const disposedUnsubs: Array<() => void> = [];\n\n  const cleanup = () => {\n    if (disposed) return;\n    disposed = true;\n    for (const unsub of channelUnsubs) unsub?.();\n    for (const unsub of disposedUnsubs) unsub();\n    channelUnsubs.length = 0;\n    disposedUnsubs.length = 0;\n    for (let i = 0; i < targets.length; i++) {\n      registry.release(targets[i].blocClass, targets[i].key, false, refIds[i]);\n    }\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  const subscribeAt = (index: number) => {\n    channelUnsubs[index] = instances[index].channel.subscribe(\n      () => ALL_PATHS,\n      runCallback,\n    );\n  };\n\n  // On external dispose, tear down the stale subscription and re-acquire +\n  // resubscribe (microtask-deferred, so it never runs mid-mutation of the\n  // registry that triggered the dispose, e.g. `clearAll()`), then notify.\n  const resubscribeAt = (index: number) => {\n    if (disposed) return;\n    instances[index] = resolveBloc(targets[index], refIds[index]);\n    subscribeAt(index);\n    subscribeDisposeAt(index);\n    runCallback();\n  };\n\n  const subscribeDisposeAt = (index: number) => {\n    disposedUnsubs[index] = instances[index][ON_DISPOSE](() => {\n      channelUnsubs[index]?.();\n      channelUnsubs[index] = undefined;\n      queueMicrotask(() => resubscribeAt(index));\n    });\n  };\n\n  for (let i = 0; i < instances.length; i++) {\n    subscribeAt(i);\n  }\n\n  for (let i = 0; i < instances.length; i++) {\n    subscribeDisposeAt(i);\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":";;;;;AAUA,MAAM,OAAsB,OAAO,YAAY;AAG/C,MAAM,kBAAkB,OAAO,SAAS;;;;;;;;;;;;AA8BxC,SAAgB,SACd,WACA,MACY;CACZ,OAAO;GACJ,kBAAkB;EACnB,WAAW;EACX,YAAY,mBAAmB,WAAW,IAAI;EAC9C;CACF;AACF;AAEA,SAAS,UACP,OAC6C;CAC7C,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,mBAAmB;AAEtE;AA4DA,SAAS,cAAc,OAA+B;CACpD,MAAM,WAAW,YAAY;CAC7B,IAAI,UAAU,KAAK,GACjB,OAAO;EACL,WAAW,MAAM;EACjB,KAAK,MAAM;EACX,MAAM,MAAM;CACd;CAEF,OAAO;EACL,WAAW;EACX,KAAK,SAAS,WAAW,OAAO,KAAA,GAAW,KAAA,CAAS;EACpD,MAAM,KAAA;CACR;AACF;AAEA,IAAI,cAAc;;;;;;AAOlB,SAAS,YACP,QACA,OACwB;CAExB,OADiB,YACH,EAAE,QAAQ,OAAO,WAAW,OAAO,KAAK;EACpD,UAAU;EACV;EACA,MAAM,OAAO;CACf,CAAC;AACH;AAEA,SAAS,QAAQ,OAA+C;CAC9D,OAAO,MAAM,QAAQ,KAAK;AAC5B;AA2DA,SAAS,UACP,aACA,UACY;CACZ,MAAM,WAAW,CAAC,QAAQ,WAAW;CACrC,MAAM,SAAS,WAAW,CAAC,WAAW,IAAI;CAC1C,MAAM,WAAW,YAAY;CAE7B,MAAM,UAAU,OAAO,IAAI,aAAa;CACxC,MAAM,SAAS,QAAQ,UAAU,UAAU,eAAe;CAE1D,IAAI,WAAW;CACf,MAAM,YAAsC,QAAQ,KAAK,QAAQ,MAC/D,YAAY,QAAQ,OAAO,EAAE,CAC/B;CACA,MAAM,gBAAiD,CAAC;CACxD,MAAM,iBAAoC,CAAC;CAE3C,MAAM,gBAAgB;EACpB,IAAI,UAAU;EACd,WAAW;EACX,KAAK,MAAM,SAAS,eAAe,QAAQ;EAC3C,KAAK,MAAM,SAAS,gBAAgB,MAAM;EAC1C,cAAc,SAAS;EACvB,eAAe,SAAS;EACxB,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAClC,SAAS,QAAQ,QAAQ,GAAG,WAAW,QAAQ,GAAG,KAAK,OAAO,OAAO,EAAE;CAE3E;CAEA,MAAM,oBAAoB;EACxB,IAAI,UAAU;EAGd,IADe,SADH,WAAW,UAAU,KAAK,SAE7B,MAAM,MAAM,QAAQ;CAC/B;CAEA,MAAM,eAAe,UAAkB;EACrC,cAAc,SAAS,UAAU,OAAO,QAAQ,gBACxC,WACN,WACF;CACF;CAKA,MAAM,iBAAiB,UAAkB;EACvC,IAAI,UAAU;EACd,UAAU,SAAS,YAAY,QAAQ,QAAQ,OAAO,MAAM;EAC5D,YAAY,KAAK;EACjB,mBAAmB,KAAK;EACxB,YAAY;CACd;CAEA,MAAM,sBAAsB,UAAkB;EAC5C,eAAe,SAAS,UAAU,OAAO,kBAAkB;GACzD,cAAc,SAAS;GACvB,cAAc,SAAS,KAAA;GACvB,qBAAqB,cAAc,KAAK,CAAC;EAC3C,CAAC;CACH;CAEA,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KACpC,YAAY,CAAC;CAGf,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KACpC,mBAAmB,CAAC;CAItB,YAAY;CAEZ,OAAO;AACT;AAEA,MAAa,QAAiB,OAAO,OAAO,WAAW,EAAE,KAAK,CAAC"}