@blac/core 2.1.0 → 2.1.2

package/dist/watch-DztcJuUy.cjs.map

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

@@ -1,108 +0,0 @@
-import { t as getRegistry } from "./config-D6BoWWPv.js";
-import { n as resolveInstanceKey } from "./acquire-DXEQDZGr.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);
-		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
-export { watch as n, instance as t };
-
-//# sourceMappingURL=watch-IrR8G28N.js.map

package/dist/watch-IrR8G28N.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"watch-IrR8G28N.js","names":[],"sources":["../src/watch/watch.ts"],"sourcesContent":["import { ALL_PATHS } from '@dirtytalk/structural';\nimport { getRegistry } from '../registry';\nimport { resolveInstanceKey } from '../registry/acquire';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n  StateContainerInstance,\n} from '../types/utilities';\n\nconst STOP: unique symbol = Symbol('watch.STOP');\ntype StopSymbol = typeof STOP;\n\nconst BLOC_REF_MARKER = Symbol('BlocRef');\n\n/**\n * Reference to a specific bloc instance, identified by class + the resolved\n * key derived from its `args`.\n */\nexport interface BlocRef<T extends StateContainerConstructor> {\n  [BLOC_REF_MARKER]: true;\n  blocClass: T;\n  /** @internal The resolved instance key (derived from `args`). */\n  instanceId: string;\n  /**\n   * @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,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,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-aoNLQAXp.cjs

@@ -1,119 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_watch = require("./watch-lEco5Tbl.cjs");
-exports.instance = require_watch.instance;
-exports.watch = require_watch.watch;

package/dist/watch-entry.d.cts

@@ -1,24 +0,0 @@
-/**
- * Watch Subpath Export
- *
- * Reactive subscription utilities for watching bloc state changes.
- * Import from '@blac/core/watch'
- *
- * @example
- * ```typescript
- * import { watch, instance } from '@blac/core/watch';
- *
- * // Watch a bloc
- * const unwatch = watch(UserBloc, (userBloc) => {
- *   console.log(userBloc.state.name);
- * });
- *
- * // Watch a specific instance
- * const unwatch = watch(instance(UserBloc, 'user-123'), (userBloc) => {
- *   console.log(userBloc.state.name);
- * });
- * ```
- *
- * @packageDocumentation
- */
-export { watch, instance, type WatchFn, type BlocRef } from './watch';

package/dist/watch-entry.d.ts

@@ -1,24 +0,0 @@
-/**
- * Watch Subpath Export
- *
- * Reactive subscription utilities for watching bloc state changes.
- * Import from '@blac/core/watch'
- *
- * @example
- * ```typescript
- * import { watch, instance } from '@blac/core/watch';
- *
- * // Watch a bloc
- * const unwatch = watch(UserBloc, (userBloc) => {
- *   console.log(userBloc.state.name);
- * });
- *
- * // Watch a specific instance
- * const unwatch = watch(instance(UserBloc, 'user-123'), (userBloc) => {
- *   console.log(userBloc.state.name);
- * });
- * ```
- *
- * @packageDocumentation
- */
-export { watch, instance, type WatchFn, type BlocRef } from './watch';

package/dist/watch-entry.js

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

package/dist/watch-hx0r92Zc.js

@@ -1,108 +0,0 @@
-import { t as getRegistry } from "./config-CzcoAvBo.js";
-import { n as resolveInstanceKey } from "./acquire-BRIJVJaA.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);
-		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
-export { watch as n, instance as t };
-
-//# sourceMappingURL=watch-hx0r92Zc.js.map

package/dist/watch-hx0r92Zc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"watch-hx0r92Zc.js","names":[],"sources":["../src/watch/watch.ts"],"sourcesContent":["import { ALL_PATHS } from '@dirtytalk/structural';\nimport { getRegistry } from '../registry';\nimport { resolveInstanceKey } from '../registry/acquire';\nimport type {\n  ExtractArgs,\n  StateContainerConstructor,\n  StateContainerInstance,\n} from '../types/utilities';\n\nconst STOP: unique symbol = Symbol('watch.STOP');\ntype StopSymbol = typeof STOP;\n\nconst BLOC_REF_MARKER = Symbol('BlocRef');\n\n/**\n * Reference to a specific bloc instance, identified by class + the resolved\n * key derived from its `args`.\n */\nexport interface BlocRef<T extends StateContainerConstructor> {\n  [BLOC_REF_MARKER]: true;\n  blocClass: T;\n  /** @internal The resolved instance key (derived from `args`). */\n  instanceId: string;\n  /**\n   * @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,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,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-lEco5Tbl.cjs

@@ -1,119 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}