@blac/core 2.0.19 → 2.1.0

package/dist/watch-DttHqefn.js

@@ -0,0 +1,108 @@
+import { o as ON_DISPOSE } from "./StateContainerRegistry-D8nu7Z0T.js";
+import { t as getRegistry } from "./config-DXI3kzmA.js";
+import { n as resolveInstanceKey } from "./acquire-B1LYXSGj.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-DttHqefn.js.map

package/dist/watch-DttHqefn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-DttHqefn.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"}

package/dist/watch-DxdIZjpt.cjs

@@ -0,0 +1,119 @@
+const require_StateContainerRegistry = require("./StateContainerRegistry-CS18y4au.cjs");
+const require_config = require("./config-DWUq7zEQ.cjs");
+const require_acquire = require("./acquire-BJ3xUEmh.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-DxdIZjpt.cjs.map

package/dist/watch-DxdIZjpt.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-DxdIZjpt.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-aoNLQAXp.cjs

@@ -0,0 +1,119 @@
+const require_StateContainerRegistry = require("./StateContainerRegistry-C75QpeaO.cjs");
+const require_config = require("./config-D34BkraU.cjs");
+const require_acquire = require("./acquire-CE0uq0Dx.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-aoNLQAXp.cjs.map

package/dist/watch-aoNLQAXp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-aoNLQAXp.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-entry.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_watch = require("./watch-BHfCtbn1.cjs");
+const require_watch = require("./watch-lEco5Tbl.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-hx0r92Zc.js";
+import { n as watch, t as instance } from "./watch-BDiwCPmb.js";
 export { instance, watch };

package/dist/watch-lEco5Tbl.cjs

@@ -0,0 +1,119 @@
+const require_StateContainerRegistry = require("./StateContainerRegistry-G81GcCRm.cjs");
+const require_config = require("./config-C1T6Jw7n.cjs");
+const require_acquire = require("./acquire-CkgLJ8WL.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-lEco5Tbl.cjs.map

package/dist/watch-lEco5Tbl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-lEco5Tbl.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blac/core",
-  "version": "2.0.19",
+  "version": "2.1.0",
   "license": "MIT",
   "author": "Brendan Mullins <jsnanigans@gmail.com>",
   "description": "Type-safe, class-based state management with proxy tracking and plugin system",
@@ -118,11 +118,11 @@
     {
       "name": "@blac/core (ESM, brotli)",
       "path": "dist/index.js",
-      "limit": "7.8 kB"
+      "limit": "9.2 kB"
     }
   ],
   "dependencies": {
-    "@dirtytalk/structural": "^0.0.7"
+    "@dirtytalk/structural": "^0.0.9"
   },
   "devDependencies": {
     "@size-limit/preset-small-lib": "^11.1.6",