@blac/core 2.0.12 → 2.0.14

package/dist/testing.cjs

@@ -1,9 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_Cubit = require("./Cubit-BAUPiUF7.cjs");
-const require_StateContainerRegistry = require("./StateContainerRegistry-mseeTqSA.cjs");
-const require_config = require("./config-DMNZ2YLV.cjs");
-const require_ensure = require("./ensure-vS71MV4q.cjs");
+const require_StateContainerRegistry = require("./StateContainerRegistry-B4yVMYbx.cjs");
+const require_Cubit = require("./Cubit-CWP8Ddzx.cjs");
+const require_config = require("./config-B_4xXpvK.cjs");
+const require_ensure = require("./ensure-BB6xHQAF.cjs");
 //#region src/testing.ts
+/** Synthetic owner id used by test helpers for pre-wired deps. */
+const TESTING_DEPS_OWNER = "testing-deps";
 function createTestRegistry() {
 	return new require_StateContainerRegistry.StateContainerRegistry();
 }
@@ -38,19 +40,9 @@ function blacTestSetup() {
 	});
 }
 const DEFAULT_KEY = "default";
-function registerOverride(BlocClass, instance, instanceKey = DEFAULT_KEY) {
-	const registry = require_config.getRegistry();
-	const existing = registry.acquire(BlocClass, instanceKey, {
-		canCreate: true,
-		countRef: false
-	});
-	if (existing !== instance && !existing.isDisposed) existing.dispose();
-	const instancesMap = registry.getInstancesMap(BlocClass);
-	const entry = {
-		instance,
-		refs: new Map([["testing-override", 1]])
-	};
-	instancesMap.set(instanceKey, entry);
+function registerOverride(BlocClass, instance, instanceKey) {
+	const key = instanceKey ?? DEFAULT_KEY;
+	require_config.getRegistry().insertInstance(BlocClass, key, instance, new Map([["testing-override", 1]]));
 }
 function overrideEnsure(BlocClass, instance, fn, instanceKey = DEFAULT_KEY) {
 	return withTestRegistry(() => {
@@ -60,6 +52,7 @@ function overrideEnsure(BlocClass, instance, fn, instanceKey = DEFAULT_KEY) {
 }
 function createCubitStub(BlocClass, options) {
 	const instance = new BlocClass();
+	if (options?.args != null) instance.initConfig({ args: options.args });
 	if (options?.state != null) {
 		if (instance instanceof require_Cubit.Cubit) {
 			const currentState = instance.state;
@@ -70,6 +63,7 @@ function createCubitStub(BlocClass, options) {
 	if (options?.methods) {
 		for (const [key, impl] of Object.entries(options.methods)) if (typeof impl === "function") instance[key] = impl;
 	}
+	if (options?.deps != null) instance[require_Cubit.APPLY_DEPS](TESTING_DEPS_OWNER, options.deps);
 	return instance;
 }
 function withBlocState(BlocClass, state, instanceKey) {
@@ -86,15 +80,28 @@ function withBlocMethod(BlocClass, methodName, impl, instanceKey) {
 	instance[methodName] = impl;
 	return instance;
 }
+/**
+* Drain pending microtasks so any channel-flushed effects (subscribe()
+* listeners, `onSystemEvent('stateChanged')` handlers, plugin hooks) run
+* before the next assertion.
+*
+* The default `MicrotaskScheduler` coalesces emits within a tick; tests
+* that emit and then assert on listener side-effects need `await flush()`
+* (or its alias `flushBlocUpdates()`) between the two.
+*/
+async function flush() {
+	await Promise.resolve();
+	await Promise.resolve();
+}
+/** @deprecated Alias for `flush()`. */
 async function flushBlocUpdates() {
-	await new Promise((resolve) => {
-		setTimeout(resolve, 0);
-	});
+	await flush();
 }
 //#endregion
 exports.blacTestSetup = blacTestSetup;
 exports.createCubitStub = createCubitStub;
 exports.createTestRegistry = createTestRegistry;
+exports.flush = flush;
 exports.flushBlocUpdates = flushBlocUpdates;
 exports.overrideEnsure = overrideEnsure;
 exports.registerOverride = registerOverride;

package/dist/testing.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.cjs","names":["StateContainerRegistry","getRegistry","Cubit","ensure"],"sources":["../src/testing.ts"],"sourcesContent":["import { Cubit } from './core/Cubit';\nimport {\n  type InstanceEntry,\n  StateContainerRegistry,\n} from './core/StateContainerRegistry';\nimport { ensure, getRegistry, setRegistry } from './registry';\nimport type {\n  ExtractState,\n  StateContainerConstructor,\n} from './types/utilities';\n\ndeclare const beforeEach: (fn: () => void) => void;\ndeclare const afterEach: (fn: () => void) => void;\n\n// --- createTestRegistry + withTestRegistry ---\n\nexport function createTestRegistry(): StateContainerRegistry {\n  return new StateContainerRegistry();\n}\n\nexport function withTestRegistry<T>(\n  fn: (registry: StateContainerRegistry) => T,\n): T {\n  const previous = getRegistry();\n  const testRegistry = createTestRegistry();\n  setRegistry(testRegistry);\n  try {\n    const result = fn(testRegistry);\n    if (result instanceof Promise) {\n      return result.then(\n        (value) => {\n          setRegistry(previous);\n          return value;\n        },\n        (error) => {\n          setRegistry(previous);\n          throw error;\n        },\n      ) as T;\n    }\n    setRegistry(previous);\n    return result;\n  } catch (error) {\n    setRegistry(previous);\n    throw error;\n  }\n}\n\n// --- blacTestSetup ---\n\nexport function blacTestSetup(): void {\n  let savedRegistry: StateContainerRegistry;\n  beforeEach(() => {\n    savedRegistry = getRegistry();\n    setRegistry(new StateContainerRegistry());\n  });\n  afterEach(() => {\n    setRegistry(savedRegistry);\n  });\n}\n\n// --- registerOverride + overrideEnsure ---\n\nconst DEFAULT_KEY = 'default';\n\nexport function registerOverride<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instance: InstanceType<T>,\n  instanceKey: string = DEFAULT_KEY,\n): void {\n  const registry = getRegistry();\n  const existing = registry.acquire(BlocClass, instanceKey, {\n    canCreate: true,\n    countRef: false,\n  });\n  if (existing !== instance && !existing.isDisposed) {\n    existing.dispose();\n  }\n  const instancesMap = registry.getInstancesMap(BlocClass);\n  const entry: InstanceEntry<InstanceType<T>> = {\n    instance,\n    refs: new Map([['testing-override', 1]]),\n  };\n  instancesMap.set(instanceKey, entry);\n}\n\nexport function overrideEnsure<T extends StateContainerConstructor, R>(\n  BlocClass: T,\n  instance: InstanceType<T>,\n  fn: () => R,\n  instanceKey: string = DEFAULT_KEY,\n): R {\n  return withTestRegistry(() => {\n    registerOverride(BlocClass, instance, instanceKey);\n    return fn();\n  });\n}\n\n// --- createCubitStub ---\n\ntype MethodKeys<T> = {\n  [K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;\n}[keyof T];\n\nexport interface CubitStubOptions<T extends StateContainerConstructor> {\n  state?: ExtractState<T> extends Record<string, any>\n    ? Partial<ExtractState<T>>\n    : ExtractState<T>;\n  methods?: Partial<\n    Record<MethodKeys<InstanceType<T>>, (...args: any[]) => any>\n  >;\n}\n\nexport function createCubitStub<T extends StateContainerConstructor>(\n  BlocClass: T,\n  options?: CubitStubOptions<T>,\n): InstanceType<T> {\n  const instance = new BlocClass() as InstanceType<T>;\n  if (options?.state != null) {\n    if (instance instanceof Cubit) {\n      const currentState = instance.state;\n      if (\n        typeof currentState === 'object' &&\n        currentState !== null &&\n        typeof options.state === 'object' &&\n        options.state !== null\n      ) {\n        instance.patch(options.state as any);\n      } else {\n        instance.emit(options.state as any);\n      }\n    }\n  }\n  if (options?.methods) {\n    for (const [key, impl] of Object.entries(options.methods)) {\n      if (typeof impl === 'function') {\n        (instance as any)[key] = impl;\n      }\n    }\n  }\n  return instance;\n}\n\n// --- withBlocState ---\n\nexport function withBlocState<T extends StateContainerConstructor>(\n  BlocClass: T,\n  state: ExtractState<T> extends Record<string, any>\n    ? Partial<ExtractState<T>>\n    : ExtractState<T>,\n  instanceKey?: string,\n): InstanceType<T> {\n  const instance = ensure(BlocClass, instanceKey);\n  if (instance instanceof Cubit) {\n    const currentState = instance.state;\n    if (\n      typeof currentState === 'object' &&\n      currentState !== null &&\n      typeof state === 'object' &&\n      state !== null\n    ) {\n      instance.patch(state as any);\n    } else {\n      instance.emit(state as any);\n    }\n  }\n  return instance;\n}\n\n// --- withBlocMethod ---\n\nexport function withBlocMethod<T extends StateContainerConstructor>(\n  BlocClass: T,\n  methodName: keyof InstanceType<T>,\n  impl: (...args: any[]) => any,\n  instanceKey?: string,\n): InstanceType<T> {\n  const instance = ensure(BlocClass, instanceKey);\n  (instance as any)[methodName] = impl;\n  return instance;\n}\n\n// --- flushBlocUpdates ---\n\nexport async function flushBlocUpdates(): Promise<void> {\n  await new Promise<void>((resolve) => {\n    setTimeout(resolve, 0);\n  });\n}\n"],"mappings":";;;;;;AAgBA,SAAgB,qBAA6C;AAC3D,QAAO,IAAIA,+BAAAA,wBAAwB;;AAGrC,SAAgB,iBACd,IACG;CACH,MAAM,WAAWC,eAAAA,aAAa;CAC9B,MAAM,eAAe,oBAAoB;AACzC,gBAAA,YAAY,aAAa;AACzB,KAAI;EACF,MAAM,SAAS,GAAG,aAAa;AAC/B,MAAI,kBAAkB,QACpB,QAAO,OAAO,MACX,UAAU;AACT,kBAAA,YAAY,SAAS;AACrB,UAAO;MAER,UAAU;AACT,kBAAA,YAAY,SAAS;AACrB,SAAM;IAET;AAEH,iBAAA,YAAY,SAAS;AACrB,SAAO;UACA,OAAO;AACd,iBAAA,YAAY,SAAS;AACrB,QAAM;;;AAMV,SAAgB,gBAAsB;CACpC,IAAI;AACJ,kBAAiB;AACf,kBAAgBA,eAAAA,aAAa;AAC7B,iBAAA,YAAY,IAAID,+BAAAA,wBAAwB,CAAC;GACzC;AACF,iBAAgB;AACd,iBAAA,YAAY,cAAc;GAC1B;;AAKJ,MAAM,cAAc;AAEpB,SAAgB,iBACd,WACA,UACA,cAAsB,aAChB;CACN,MAAM,WAAWC,eAAAA,aAAa;CAC9B,MAAM,WAAW,SAAS,QAAQ,WAAW,aAAa;EACxD,WAAW;EACX,UAAU;EACX,CAAC;AACF,KAAI,aAAa,YAAY,CAAC,SAAS,WACrC,UAAS,SAAS;CAEpB,MAAM,eAAe,SAAS,gBAAgB,UAAU;CACxD,MAAM,QAAwC;EAC5C;EACA,MAAM,IAAI,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC;EACzC;AACD,cAAa,IAAI,aAAa,MAAM;;AAGtC,SAAgB,eACd,WACA,UACA,IACA,cAAsB,aACnB;AACH,QAAO,uBAAuB;AAC5B,mBAAiB,WAAW,UAAU,YAAY;AAClD,SAAO,IAAI;GACX;;AAkBJ,SAAgB,gBACd,WACA,SACiB;CACjB,MAAM,WAAW,IAAI,WAAW;AAChC,KAAI,SAAS,SAAS;MAChB,oBAAoBC,cAAAA,OAAO;GAC7B,MAAM,eAAe,SAAS;AAC9B,OACE,OAAO,iBAAiB,YACxB,iBAAiB,QACjB,OAAO,QAAQ,UAAU,YACzB,QAAQ,UAAU,KAElB,UAAS,MAAM,QAAQ,MAAa;OAEpC,UAAS,KAAK,QAAQ,MAAa;;;AAIzC,KAAI,SAAS;OACN,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,QAAQ,QAAQ,CACvD,KAAI,OAAO,SAAS,WACjB,UAAiB,OAAO;;AAI/B,QAAO;;AAKT,SAAgB,cACd,WACA,OAGA,aACiB;CACjB,MAAM,WAAWC,eAAAA,OAAO,WAAW,YAAY;AAC/C,KAAI,oBAAoBD,cAAAA,OAAO;EAC7B,MAAM,eAAe,SAAS;AAC9B,MACE,OAAO,iBAAiB,YACxB,iBAAiB,QACjB,OAAO,UAAU,YACjB,UAAU,KAEV,UAAS,MAAM,MAAa;MAE5B,UAAS,KAAK,MAAa;;AAG/B,QAAO;;AAKT,SAAgB,eACd,WACA,YACA,MACA,aACiB;CACjB,MAAM,WAAWC,eAAAA,OAAO,WAAW,YAAY;AAC9C,UAAiB,cAAc;AAChC,QAAO;;AAKT,eAAsB,mBAAkC;AACtD,OAAM,IAAI,SAAe,YAAY;AACnC,aAAW,SAAS,EAAE;GACtB"}
+{"version":3,"file":"testing.cjs","names":["StateContainerRegistry","getRegistry","Cubit","APPLY_DEPS","ensure"],"sources":["../src/testing.ts"],"sourcesContent":["import { Cubit } from './core/Cubit';\nimport { StateContainerRegistry } from './core/StateContainerRegistry';\nimport { APPLY_DEPS } from './core/symbols';\nimport { ensure, getRegistry, setRegistry } from './registry';\nimport type {\n  ExtractArgs,\n  ExtractDeps,\n  ExtractState,\n  StateContainerConstructor,\n} from './types/utilities';\n\n/** Synthetic owner id used by test helpers for pre-wired deps. */\nconst TESTING_DEPS_OWNER = 'testing-deps';\n\ndeclare const beforeEach: (fn: () => void) => void;\ndeclare const afterEach: (fn: () => void) => void;\n\n// --- createTestRegistry + withTestRegistry ---\n\nexport function createTestRegistry(): StateContainerRegistry {\n  return new StateContainerRegistry();\n}\n\nexport function withTestRegistry<T>(\n  fn: (registry: StateContainerRegistry) => T,\n): T {\n  const previous = getRegistry();\n  const testRegistry = createTestRegistry();\n  setRegistry(testRegistry);\n  try {\n    const result = fn(testRegistry);\n    if (result instanceof Promise) {\n      return result.then(\n        (value) => {\n          setRegistry(previous);\n          return value;\n        },\n        (error) => {\n          setRegistry(previous);\n          throw error;\n        },\n      ) as T;\n    }\n    setRegistry(previous);\n    return result;\n  } catch (error) {\n    setRegistry(previous);\n    throw error;\n  }\n}\n\n// --- blacTestSetup ---\n\nexport function blacTestSetup(): void {\n  let savedRegistry: StateContainerRegistry;\n  beforeEach(() => {\n    savedRegistry = getRegistry();\n    setRegistry(new StateContainerRegistry());\n  });\n  afterEach(() => {\n    setRegistry(savedRegistry);\n  });\n}\n\n// --- registerOverride + overrideEnsure ---\n\nconst DEFAULT_KEY = 'default';\n\nexport function registerOverride<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instance: InstanceType<T>,\n  instanceKey?: string,\n): void {\n  const key = instanceKey ?? DEFAULT_KEY;\n  const registry = getRegistry();\n  registry.insertInstance(\n    BlocClass,\n    key,\n    instance,\n    new Map([['testing-override', 1]]),\n  );\n}\n\nexport function overrideEnsure<T extends StateContainerConstructor, R>(\n  BlocClass: T,\n  instance: InstanceType<T>,\n  fn: () => R,\n  instanceKey: string = DEFAULT_KEY,\n): R {\n  return withTestRegistry(() => {\n    registerOverride(BlocClass, instance, instanceKey);\n    return fn();\n  });\n}\n\n// --- createCubitStub ---\n\ntype MethodKeys<T> = {\n  [K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;\n}[keyof T];\n\nexport interface CubitStubOptions<T extends StateContainerConstructor> {\n  state?: ExtractState<T> extends Record<string, any>\n    ? Partial<ExtractState<T>>\n    : ExtractState<T>;\n  methods?: Partial<\n    Record<MethodKeys<InstanceType<T>>, (...args: any[]) => any>\n  >;\n  /**\n   * Args to pass to init(). If the bloc's Args type is not void, supplying\n   * args here causes initConfig({ args }) to be called so init() runs.\n   */\n  args?: ExtractArgs<T> extends void ? never : ExtractArgs<T>;\n  /**\n   * Deps slice to pre-wire via the core [APPLY_DEPS] path (synthetic owner\n   * \"testing-deps\"), so onDepsChanged fires during tests.\n   */\n  deps?: Partial<ExtractDeps<T>>;\n}\n\nexport function createCubitStub<T extends StateContainerConstructor>(\n  BlocClass: T,\n  options?: CubitStubOptions<T>,\n): InstanceType<T> {\n  const instance = new BlocClass() as InstanceType<T>;\n\n  // Run init() if args are supplied — goes through the same initConfig path\n  // that the registry uses, so lifecycle hooks fire correctly.\n  if (options?.args != null) {\n    instance.initConfig({ args: options.args });\n  }\n\n  if (options?.state != null) {\n    if (instance instanceof Cubit) {\n      const currentState = instance.state;\n      if (\n        typeof currentState === 'object' &&\n        currentState !== null &&\n        typeof options.state === 'object' &&\n        options.state !== null\n      ) {\n        instance.patch(options.state as any);\n      } else {\n        instance.emit(options.state as any);\n      }\n    }\n  }\n  if (options?.methods) {\n    for (const [key, impl] of Object.entries(options.methods)) {\n      if (typeof impl === 'function') {\n        (instance as any)[key] = impl;\n      }\n    }\n  }\n\n  // Pre-wire deps via the core merge path so onDepsChanged fires in tests.\n  if (options?.deps != null) {\n    (instance as any)[APPLY_DEPS](TESTING_DEPS_OWNER, options.deps);\n  }\n\n  return instance;\n}\n\n// --- withBlocState ---\n\nexport function withBlocState<T extends StateContainerConstructor>(\n  BlocClass: T,\n  state: ExtractState<T> extends Record<string, any>\n    ? Partial<ExtractState<T>>\n    : ExtractState<T>,\n  instanceKey?: string,\n): InstanceType<T> {\n  const instance = ensure(BlocClass, instanceKey);\n  if (instance instanceof Cubit) {\n    const currentState = instance.state;\n    if (\n      typeof currentState === 'object' &&\n      currentState !== null &&\n      typeof state === 'object' &&\n      state !== null\n    ) {\n      instance.patch(state as any);\n    } else {\n      instance.emit(state as any);\n    }\n  }\n  return instance;\n}\n\n// --- withBlocMethod ---\n\nexport function withBlocMethod<T extends StateContainerConstructor>(\n  BlocClass: T,\n  methodName: keyof InstanceType<T>,\n  impl: (...args: any[]) => any,\n  instanceKey?: string,\n): InstanceType<T> {\n  const instance = ensure(BlocClass, instanceKey);\n  (instance as any)[methodName] = impl;\n  return instance;\n}\n\n// --- flushBlocUpdates ---\n\n/**\n * Drain pending microtasks so any channel-flushed effects (subscribe()\n * listeners, `onSystemEvent('stateChanged')` handlers, plugin hooks) run\n * before the next assertion.\n *\n * The default `MicrotaskScheduler` coalesces emits within a tick; tests\n * that emit and then assert on listener side-effects need `await flush()`\n * (or its alias `flushBlocUpdates()`) between the two.\n */\nexport async function flush(): Promise<void> {\n  // queueMicrotask wins the race against the channel's own queued flush —\n  // we resolve after the channel has drained its current pending flush.\n  await Promise.resolve();\n  await Promise.resolve();\n}\n\n/** @deprecated Alias for `flush()`. */\nexport async function flushBlocUpdates(): Promise<void> {\n  await flush();\n}\n"],"mappings":";;;;;;;AAYA,MAAM,qBAAqB;AAO3B,SAAgB,qBAA6C;CAC3D,OAAO,IAAIA,+BAAAA,wBAAwB;;AAGrC,SAAgB,iBACd,IACG;CACH,MAAM,WAAWC,eAAAA,aAAa;CAC9B,MAAM,eAAe,oBAAoB;CACzC,eAAA,YAAY,aAAa;CACzB,IAAI;EACF,MAAM,SAAS,GAAG,aAAa;EAC/B,IAAI,kBAAkB,SACpB,OAAO,OAAO,MACX,UAAU;GACT,eAAA,YAAY,SAAS;GACrB,OAAO;MAER,UAAU;GACT,eAAA,YAAY,SAAS;GACrB,MAAM;IAET;EAEH,eAAA,YAAY,SAAS;EACrB,OAAO;UACA,OAAO;EACd,eAAA,YAAY,SAAS;EACrB,MAAM;;;AAMV,SAAgB,gBAAsB;CACpC,IAAI;CACJ,iBAAiB;EACf,gBAAgBA,eAAAA,aAAa;EAC7B,eAAA,YAAY,IAAID,+BAAAA,wBAAwB,CAAC;GACzC;CACF,gBAAgB;EACd,eAAA,YAAY,cAAc;GAC1B;;AAKJ,MAAM,cAAc;AAEpB,SAAgB,iBACd,WACA,UACA,aACM;CACN,MAAM,MAAM,eAAe;CAE3B,eADiBC,aACT,CAAC,eACP,WACA,KACA,UACA,IAAI,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,CACnC;;AAGH,SAAgB,eACd,WACA,UACA,IACA,cAAsB,aACnB;CACH,OAAO,uBAAuB;EAC5B,iBAAiB,WAAW,UAAU,YAAY;EAClD,OAAO,IAAI;GACX;;AA4BJ,SAAgB,gBACd,WACA,SACiB;CACjB,MAAM,WAAW,IAAI,WAAW;CAIhC,IAAI,SAAS,QAAQ,MACnB,SAAS,WAAW,EAAE,MAAM,QAAQ,MAAM,CAAC;CAG7C,IAAI,SAAS,SAAS;MAChB,oBAAoBC,cAAAA,OAAO;GAC7B,MAAM,eAAe,SAAS;GAC9B,IACE,OAAO,iBAAiB,YACxB,iBAAiB,QACjB,OAAO,QAAQ,UAAU,YACzB,QAAQ,UAAU,MAElB,SAAS,MAAM,QAAQ,MAAa;QAEpC,SAAS,KAAK,QAAQ,MAAa;;;CAIzC,IAAI,SAAS;OACN,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,QAAQ,QAAQ,EACvD,IAAI,OAAO,SAAS,YAClB,SAAkB,OAAO;;CAM/B,IAAI,SAAS,QAAQ,MACnB,SAAkBC,cAAAA,YAAY,oBAAoB,QAAQ,KAAK;CAGjE,OAAO;;AAKT,SAAgB,cACd,WACA,OAGA,aACiB;CACjB,MAAM,WAAWC,eAAAA,OAAO,WAAW,YAAY;CAC/C,IAAI,oBAAoBF,cAAAA,OAAO;EAC7B,MAAM,eAAe,SAAS;EAC9B,IACE,OAAO,iBAAiB,YACxB,iBAAiB,QACjB,OAAO,UAAU,YACjB,UAAU,MAEV,SAAS,MAAM,MAAa;OAE5B,SAAS,KAAK,MAAa;;CAG/B,OAAO;;AAKT,SAAgB,eACd,WACA,YACA,MACA,aACiB;CACjB,MAAM,WAAWE,eAAAA,OAAO,WAAW,YAAY;CAC/C,SAAkB,cAAc;CAChC,OAAO;;;;;;;;;;;AAcT,eAAsB,QAAuB;CAG3C,MAAM,QAAQ,SAAS;CACvB,MAAM,QAAQ,SAAS;;;AAIzB,eAAsB,mBAAkC;CACtD,MAAM,OAAO"}

package/dist/testing.d.cts

@@ -1,5 +1,5 @@
 import { StateContainerRegistry } from './core/StateContainerRegistry';
-import type { ExtractState, StateContainerConstructor } from './types/utilities';
+import type { ExtractArgs, ExtractDeps, ExtractState, StateContainerConstructor } from './types/utilities';
 export declare function createTestRegistry(): StateContainerRegistry;
 export declare function withTestRegistry<T>(fn: (registry: StateContainerRegistry) => T): T;
 export declare function blacTestSetup(): void;
@@ -11,9 +11,30 @@ type MethodKeys<T> = {
 export interface CubitStubOptions<T extends StateContainerConstructor> {
     state?: ExtractState<T> extends Record<string, any> ? Partial<ExtractState<T>> : ExtractState<T>;
     methods?: Partial<Record<MethodKeys<InstanceType<T>>, (...args: any[]) => any>>;
+    /**
+     * Args to pass to init(). If the bloc's Args type is not void, supplying
+     * args here causes initConfig({ args }) to be called so init() runs.
+     */
+    args?: ExtractArgs<T> extends void ? never : ExtractArgs<T>;
+    /**
+     * Deps slice to pre-wire via the core [APPLY_DEPS] path (synthetic owner
+     * "testing-deps"), so onDepsChanged fires during tests.
+     */
+    deps?: Partial<ExtractDeps<T>>;
 }
 export declare function createCubitStub<T extends StateContainerConstructor>(BlocClass: T, options?: CubitStubOptions<T>): InstanceType<T>;
 export declare function withBlocState<T extends StateContainerConstructor>(BlocClass: T, state: ExtractState<T> extends Record<string, any> ? Partial<ExtractState<T>> : ExtractState<T>, instanceKey?: string): InstanceType<T>;
 export declare function withBlocMethod<T extends StateContainerConstructor>(BlocClass: T, methodName: keyof InstanceType<T>, impl: (...args: any[]) => any, instanceKey?: string): InstanceType<T>;
+/**
+ * Drain pending microtasks so any channel-flushed effects (subscribe()
+ * listeners, `onSystemEvent('stateChanged')` handlers, plugin hooks) run
+ * before the next assertion.
+ *
+ * The default `MicrotaskScheduler` coalesces emits within a tick; tests
+ * that emit and then assert on listener side-effects need `await flush()`
+ * (or its alias `flushBlocUpdates()`) between the two.
+ */
+export declare function flush(): Promise<void>;
+/** @deprecated Alias for `flush()`. */
 export declare function flushBlocUpdates(): Promise<void>;
 export {};

package/dist/testing.d.ts

@@ -1,5 +1,5 @@
 import { StateContainerRegistry } from './core/StateContainerRegistry';
-import type { ExtractState, StateContainerConstructor } from './types/utilities';
+import type { ExtractArgs, ExtractDeps, ExtractState, StateContainerConstructor } from './types/utilities';
 export declare function createTestRegistry(): StateContainerRegistry;
 export declare function withTestRegistry<T>(fn: (registry: StateContainerRegistry) => T): T;
 export declare function blacTestSetup(): void;
@@ -11,9 +11,30 @@ type MethodKeys<T> = {
 export interface CubitStubOptions<T extends StateContainerConstructor> {
     state?: ExtractState<T> extends Record<string, any> ? Partial<ExtractState<T>> : ExtractState<T>;
     methods?: Partial<Record<MethodKeys<InstanceType<T>>, (...args: any[]) => any>>;
+    /**
+     * Args to pass to init(). If the bloc's Args type is not void, supplying
+     * args here causes initConfig({ args }) to be called so init() runs.
+     */
+    args?: ExtractArgs<T> extends void ? never : ExtractArgs<T>;
+    /**
+     * Deps slice to pre-wire via the core [APPLY_DEPS] path (synthetic owner
+     * "testing-deps"), so onDepsChanged fires during tests.
+     */
+    deps?: Partial<ExtractDeps<T>>;
 }
 export declare function createCubitStub<T extends StateContainerConstructor>(BlocClass: T, options?: CubitStubOptions<T>): InstanceType<T>;
 export declare function withBlocState<T extends StateContainerConstructor>(BlocClass: T, state: ExtractState<T> extends Record<string, any> ? Partial<ExtractState<T>> : ExtractState<T>, instanceKey?: string): InstanceType<T>;
 export declare function withBlocMethod<T extends StateContainerConstructor>(BlocClass: T, methodName: keyof InstanceType<T>, impl: (...args: any[]) => any, instanceKey?: string): InstanceType<T>;
+/**
+ * Drain pending microtasks so any channel-flushed effects (subscribe()
+ * listeners, `onSystemEvent('stateChanged')` handlers, plugin hooks) run
+ * before the next assertion.
+ *
+ * The default `MicrotaskScheduler` coalesces emits within a tick; tests
+ * that emit and then assert on listener side-effects need `await flush()`
+ * (or its alias `flushBlocUpdates()`) between the two.
+ */
+export declare function flush(): Promise<void>;
+/** @deprecated Alias for `flush()`. */
 export declare function flushBlocUpdates(): Promise<void>;
 export {};

package/dist/testing.js

@@ -1,8 +1,10 @@
-import { t as Cubit } from "./Cubit-BOgUZva7.js";
-import { t as StateContainerRegistry } from "./StateContainerRegistry-DOuGI-l5.js";
-import { r as setRegistry, t as getRegistry } from "./config-CCUhIYIF.js";
-import { t as ensure } from "./ensure-CU-B1ywv.js";
+import { t as StateContainerRegistry } from "./StateContainerRegistry-DmmzYa7S.js";
+import { r as APPLY_DEPS, t as Cubit } from "./Cubit-VJuu2tt9.js";
+import { r as setRegistry, t as getRegistry } from "./config-DoHx0Xsl.js";
+import { t as ensure } from "./ensure-mkL-3qh8.js";
 //#region src/testing.ts
+/** Synthetic owner id used by test helpers for pre-wired deps. */
+const TESTING_DEPS_OWNER = "testing-deps";
 function createTestRegistry() {
 	return new StateContainerRegistry();
 }
@@ -37,19 +39,9 @@ function blacTestSetup() {
 	});
 }
 const DEFAULT_KEY = "default";
-function registerOverride(BlocClass, instance, instanceKey = DEFAULT_KEY) {
-	const registry = getRegistry();
-	const existing = registry.acquire(BlocClass, instanceKey, {
-		canCreate: true,
-		countRef: false
-	});
-	if (existing !== instance && !existing.isDisposed) existing.dispose();
-	const instancesMap = registry.getInstancesMap(BlocClass);
-	const entry = {
-		instance,
-		refs: new Map([["testing-override", 1]])
-	};
-	instancesMap.set(instanceKey, entry);
+function registerOverride(BlocClass, instance, instanceKey) {
+	const key = instanceKey ?? DEFAULT_KEY;
+	getRegistry().insertInstance(BlocClass, key, instance, new Map([["testing-override", 1]]));
 }
 function overrideEnsure(BlocClass, instance, fn, instanceKey = DEFAULT_KEY) {
 	return withTestRegistry(() => {
@@ -59,6 +51,7 @@ function overrideEnsure(BlocClass, instance, fn, instanceKey = DEFAULT_KEY) {
 }
 function createCubitStub(BlocClass, options) {
 	const instance = new BlocClass();
+	if (options?.args != null) instance.initConfig({ args: options.args });
 	if (options?.state != null) {
 		if (instance instanceof Cubit) {
 			const currentState = instance.state;
@@ -69,6 +62,7 @@ function createCubitStub(BlocClass, options) {
 	if (options?.methods) {
 		for (const [key, impl] of Object.entries(options.methods)) if (typeof impl === "function") instance[key] = impl;
 	}
+	if (options?.deps != null) instance[APPLY_DEPS](TESTING_DEPS_OWNER, options.deps);
 	return instance;
 }
 function withBlocState(BlocClass, state, instanceKey) {
@@ -85,12 +79,24 @@ function withBlocMethod(BlocClass, methodName, impl, instanceKey) {
 	instance[methodName] = impl;
 	return instance;
 }
+/**
+* Drain pending microtasks so any channel-flushed effects (subscribe()
+* listeners, `onSystemEvent('stateChanged')` handlers, plugin hooks) run
+* before the next assertion.
+*
+* The default `MicrotaskScheduler` coalesces emits within a tick; tests
+* that emit and then assert on listener side-effects need `await flush()`
+* (or its alias `flushBlocUpdates()`) between the two.
+*/
+async function flush() {
+	await Promise.resolve();
+	await Promise.resolve();
+}
+/** @deprecated Alias for `flush()`. */
 async function flushBlocUpdates() {
-	await new Promise((resolve) => {
-		setTimeout(resolve, 0);
-	});
+	await flush();
 }
 //#endregion
-export { blacTestSetup, createCubitStub, createTestRegistry, flushBlocUpdates, overrideEnsure, registerOverride, withBlocMethod, withBlocState, withTestRegistry };
+export { blacTestSetup, createCubitStub, createTestRegistry, flush, flushBlocUpdates, overrideEnsure, registerOverride, withBlocMethod, withBlocState, withTestRegistry };
 
 //# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["import { Cubit } from './core/Cubit';\nimport {\n  type InstanceEntry,\n  StateContainerRegistry,\n} from './core/StateContainerRegistry';\nimport { ensure, getRegistry, setRegistry } from './registry';\nimport type {\n  ExtractState,\n  StateContainerConstructor,\n} from './types/utilities';\n\ndeclare const beforeEach: (fn: () => void) => void;\ndeclare const afterEach: (fn: () => void) => void;\n\n// --- createTestRegistry + withTestRegistry ---\n\nexport function createTestRegistry(): StateContainerRegistry {\n  return new StateContainerRegistry();\n}\n\nexport function withTestRegistry<T>(\n  fn: (registry: StateContainerRegistry) => T,\n): T {\n  const previous = getRegistry();\n  const testRegistry = createTestRegistry();\n  setRegistry(testRegistry);\n  try {\n    const result = fn(testRegistry);\n    if (result instanceof Promise) {\n      return result.then(\n        (value) => {\n          setRegistry(previous);\n          return value;\n        },\n        (error) => {\n          setRegistry(previous);\n          throw error;\n        },\n      ) as T;\n    }\n    setRegistry(previous);\n    return result;\n  } catch (error) {\n    setRegistry(previous);\n    throw error;\n  }\n}\n\n// --- blacTestSetup ---\n\nexport function blacTestSetup(): void {\n  let savedRegistry: StateContainerRegistry;\n  beforeEach(() => {\n    savedRegistry = getRegistry();\n    setRegistry(new StateContainerRegistry());\n  });\n  afterEach(() => {\n    setRegistry(savedRegistry);\n  });\n}\n\n// --- registerOverride + overrideEnsure ---\n\nconst DEFAULT_KEY = 'default';\n\nexport function registerOverride<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instance: InstanceType<T>,\n  instanceKey: string = DEFAULT_KEY,\n): void {\n  const registry = getRegistry();\n  const existing = registry.acquire(BlocClass, instanceKey, {\n    canCreate: true,\n    countRef: false,\n  });\n  if (existing !== instance && !existing.isDisposed) {\n    existing.dispose();\n  }\n  const instancesMap = registry.getInstancesMap(BlocClass);\n  const entry: InstanceEntry<InstanceType<T>> = {\n    instance,\n    refs: new Map([['testing-override', 1]]),\n  };\n  instancesMap.set(instanceKey, entry);\n}\n\nexport function overrideEnsure<T extends StateContainerConstructor, R>(\n  BlocClass: T,\n  instance: InstanceType<T>,\n  fn: () => R,\n  instanceKey: string = DEFAULT_KEY,\n): R {\n  return withTestRegistry(() => {\n    registerOverride(BlocClass, instance, instanceKey);\n    return fn();\n  });\n}\n\n// --- createCubitStub ---\n\ntype MethodKeys<T> = {\n  [K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;\n}[keyof T];\n\nexport interface CubitStubOptions<T extends StateContainerConstructor> {\n  state?: ExtractState<T> extends Record<string, any>\n    ? Partial<ExtractState<T>>\n    : ExtractState<T>;\n  methods?: Partial<\n    Record<MethodKeys<InstanceType<T>>, (...args: any[]) => any>\n  >;\n}\n\nexport function createCubitStub<T extends StateContainerConstructor>(\n  BlocClass: T,\n  options?: CubitStubOptions<T>,\n): InstanceType<T> {\n  const instance = new BlocClass() as InstanceType<T>;\n  if (options?.state != null) {\n    if (instance instanceof Cubit) {\n      const currentState = instance.state;\n      if (\n        typeof currentState === 'object' &&\n        currentState !== null &&\n        typeof options.state === 'object' &&\n        options.state !== null\n      ) {\n        instance.patch(options.state as any);\n      } else {\n        instance.emit(options.state as any);\n      }\n    }\n  }\n  if (options?.methods) {\n    for (const [key, impl] of Object.entries(options.methods)) {\n      if (typeof impl === 'function') {\n        (instance as any)[key] = impl;\n      }\n    }\n  }\n  return instance;\n}\n\n// --- withBlocState ---\n\nexport function withBlocState<T extends StateContainerConstructor>(\n  BlocClass: T,\n  state: ExtractState<T> extends Record<string, any>\n    ? Partial<ExtractState<T>>\n    : ExtractState<T>,\n  instanceKey?: string,\n): InstanceType<T> {\n  const instance = ensure(BlocClass, instanceKey);\n  if (instance instanceof Cubit) {\n    const currentState = instance.state;\n    if (\n      typeof currentState === 'object' &&\n      currentState !== null &&\n      typeof state === 'object' &&\n      state !== null\n    ) {\n      instance.patch(state as any);\n    } else {\n      instance.emit(state as any);\n    }\n  }\n  return instance;\n}\n\n// --- withBlocMethod ---\n\nexport function withBlocMethod<T extends StateContainerConstructor>(\n  BlocClass: T,\n  methodName: keyof InstanceType<T>,\n  impl: (...args: any[]) => any,\n  instanceKey?: string,\n): InstanceType<T> {\n  const instance = ensure(BlocClass, instanceKey);\n  (instance as any)[methodName] = impl;\n  return instance;\n}\n\n// --- flushBlocUpdates ---\n\nexport async function flushBlocUpdates(): Promise<void> {\n  await new Promise<void>((resolve) => {\n    setTimeout(resolve, 0);\n  });\n}\n"],"mappings":";;;;;AAgBA,SAAgB,qBAA6C;AAC3D,QAAO,IAAI,wBAAwB;;AAGrC,SAAgB,iBACd,IACG;CACH,MAAM,WAAW,aAAa;CAC9B,MAAM,eAAe,oBAAoB;AACzC,aAAY,aAAa;AACzB,KAAI;EACF,MAAM,SAAS,GAAG,aAAa;AAC/B,MAAI,kBAAkB,QACpB,QAAO,OAAO,MACX,UAAU;AACT,eAAY,SAAS;AACrB,UAAO;MAER,UAAU;AACT,eAAY,SAAS;AACrB,SAAM;IAET;AAEH,cAAY,SAAS;AACrB,SAAO;UACA,OAAO;AACd,cAAY,SAAS;AACrB,QAAM;;;AAMV,SAAgB,gBAAsB;CACpC,IAAI;AACJ,kBAAiB;AACf,kBAAgB,aAAa;AAC7B,cAAY,IAAI,wBAAwB,CAAC;GACzC;AACF,iBAAgB;AACd,cAAY,cAAc;GAC1B;;AAKJ,MAAM,cAAc;AAEpB,SAAgB,iBACd,WACA,UACA,cAAsB,aAChB;CACN,MAAM,WAAW,aAAa;CAC9B,MAAM,WAAW,SAAS,QAAQ,WAAW,aAAa;EACxD,WAAW;EACX,UAAU;EACX,CAAC;AACF,KAAI,aAAa,YAAY,CAAC,SAAS,WACrC,UAAS,SAAS;CAEpB,MAAM,eAAe,SAAS,gBAAgB,UAAU;CACxD,MAAM,QAAwC;EAC5C;EACA,MAAM,IAAI,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC;EACzC;AACD,cAAa,IAAI,aAAa,MAAM;;AAGtC,SAAgB,eACd,WACA,UACA,IACA,cAAsB,aACnB;AACH,QAAO,uBAAuB;AAC5B,mBAAiB,WAAW,UAAU,YAAY;AAClD,SAAO,IAAI;GACX;;AAkBJ,SAAgB,gBACd,WACA,SACiB;CACjB,MAAM,WAAW,IAAI,WAAW;AAChC,KAAI,SAAS,SAAS;MAChB,oBAAoB,OAAO;GAC7B,MAAM,eAAe,SAAS;AAC9B,OACE,OAAO,iBAAiB,YACxB,iBAAiB,QACjB,OAAO,QAAQ,UAAU,YACzB,QAAQ,UAAU,KAElB,UAAS,MAAM,QAAQ,MAAa;OAEpC,UAAS,KAAK,QAAQ,MAAa;;;AAIzC,KAAI,SAAS;OACN,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,QAAQ,QAAQ,CACvD,KAAI,OAAO,SAAS,WACjB,UAAiB,OAAO;;AAI/B,QAAO;;AAKT,SAAgB,cACd,WACA,OAGA,aACiB;CACjB,MAAM,WAAW,OAAO,WAAW,YAAY;AAC/C,KAAI,oBAAoB,OAAO;EAC7B,MAAM,eAAe,SAAS;AAC9B,MACE,OAAO,iBAAiB,YACxB,iBAAiB,QACjB,OAAO,UAAU,YACjB,UAAU,KAEV,UAAS,MAAM,MAAa;MAE5B,UAAS,KAAK,MAAa;;AAG/B,QAAO;;AAKT,SAAgB,eACd,WACA,YACA,MACA,aACiB;CACjB,MAAM,WAAW,OAAO,WAAW,YAAY;AAC9C,UAAiB,cAAc;AAChC,QAAO;;AAKT,eAAsB,mBAAkC;AACtD,OAAM,IAAI,SAAe,YAAY;AACnC,aAAW,SAAS,EAAE;GACtB"}
+{"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["import { Cubit } from './core/Cubit';\nimport { StateContainerRegistry } from './core/StateContainerRegistry';\nimport { APPLY_DEPS } from './core/symbols';\nimport { ensure, getRegistry, setRegistry } from './registry';\nimport type {\n  ExtractArgs,\n  ExtractDeps,\n  ExtractState,\n  StateContainerConstructor,\n} from './types/utilities';\n\n/** Synthetic owner id used by test helpers for pre-wired deps. */\nconst TESTING_DEPS_OWNER = 'testing-deps';\n\ndeclare const beforeEach: (fn: () => void) => void;\ndeclare const afterEach: (fn: () => void) => void;\n\n// --- createTestRegistry + withTestRegistry ---\n\nexport function createTestRegistry(): StateContainerRegistry {\n  return new StateContainerRegistry();\n}\n\nexport function withTestRegistry<T>(\n  fn: (registry: StateContainerRegistry) => T,\n): T {\n  const previous = getRegistry();\n  const testRegistry = createTestRegistry();\n  setRegistry(testRegistry);\n  try {\n    const result = fn(testRegistry);\n    if (result instanceof Promise) {\n      return result.then(\n        (value) => {\n          setRegistry(previous);\n          return value;\n        },\n        (error) => {\n          setRegistry(previous);\n          throw error;\n        },\n      ) as T;\n    }\n    setRegistry(previous);\n    return result;\n  } catch (error) {\n    setRegistry(previous);\n    throw error;\n  }\n}\n\n// --- blacTestSetup ---\n\nexport function blacTestSetup(): void {\n  let savedRegistry: StateContainerRegistry;\n  beforeEach(() => {\n    savedRegistry = getRegistry();\n    setRegistry(new StateContainerRegistry());\n  });\n  afterEach(() => {\n    setRegistry(savedRegistry);\n  });\n}\n\n// --- registerOverride + overrideEnsure ---\n\nconst DEFAULT_KEY = 'default';\n\nexport function registerOverride<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instance: InstanceType<T>,\n  instanceKey?: string,\n): void {\n  const key = instanceKey ?? DEFAULT_KEY;\n  const registry = getRegistry();\n  registry.insertInstance(\n    BlocClass,\n    key,\n    instance,\n    new Map([['testing-override', 1]]),\n  );\n}\n\nexport function overrideEnsure<T extends StateContainerConstructor, R>(\n  BlocClass: T,\n  instance: InstanceType<T>,\n  fn: () => R,\n  instanceKey: string = DEFAULT_KEY,\n): R {\n  return withTestRegistry(() => {\n    registerOverride(BlocClass, instance, instanceKey);\n    return fn();\n  });\n}\n\n// --- createCubitStub ---\n\ntype MethodKeys<T> = {\n  [K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;\n}[keyof T];\n\nexport interface CubitStubOptions<T extends StateContainerConstructor> {\n  state?: ExtractState<T> extends Record<string, any>\n    ? Partial<ExtractState<T>>\n    : ExtractState<T>;\n  methods?: Partial<\n    Record<MethodKeys<InstanceType<T>>, (...args: any[]) => any>\n  >;\n  /**\n   * Args to pass to init(). If the bloc's Args type is not void, supplying\n   * args here causes initConfig({ args }) to be called so init() runs.\n   */\n  args?: ExtractArgs<T> extends void ? never : ExtractArgs<T>;\n  /**\n   * Deps slice to pre-wire via the core [APPLY_DEPS] path (synthetic owner\n   * \"testing-deps\"), so onDepsChanged fires during tests.\n   */\n  deps?: Partial<ExtractDeps<T>>;\n}\n\nexport function createCubitStub<T extends StateContainerConstructor>(\n  BlocClass: T,\n  options?: CubitStubOptions<T>,\n): InstanceType<T> {\n  const instance = new BlocClass() as InstanceType<T>;\n\n  // Run init() if args are supplied — goes through the same initConfig path\n  // that the registry uses, so lifecycle hooks fire correctly.\n  if (options?.args != null) {\n    instance.initConfig({ args: options.args });\n  }\n\n  if (options?.state != null) {\n    if (instance instanceof Cubit) {\n      const currentState = instance.state;\n      if (\n        typeof currentState === 'object' &&\n        currentState !== null &&\n        typeof options.state === 'object' &&\n        options.state !== null\n      ) {\n        instance.patch(options.state as any);\n      } else {\n        instance.emit(options.state as any);\n      }\n    }\n  }\n  if (options?.methods) {\n    for (const [key, impl] of Object.entries(options.methods)) {\n      if (typeof impl === 'function') {\n        (instance as any)[key] = impl;\n      }\n    }\n  }\n\n  // Pre-wire deps via the core merge path so onDepsChanged fires in tests.\n  if (options?.deps != null) {\n    (instance as any)[APPLY_DEPS](TESTING_DEPS_OWNER, options.deps);\n  }\n\n  return instance;\n}\n\n// --- withBlocState ---\n\nexport function withBlocState<T extends StateContainerConstructor>(\n  BlocClass: T,\n  state: ExtractState<T> extends Record<string, any>\n    ? Partial<ExtractState<T>>\n    : ExtractState<T>,\n  instanceKey?: string,\n): InstanceType<T> {\n  const instance = ensure(BlocClass, instanceKey);\n  if (instance instanceof Cubit) {\n    const currentState = instance.state;\n    if (\n      typeof currentState === 'object' &&\n      currentState !== null &&\n      typeof state === 'object' &&\n      state !== null\n    ) {\n      instance.patch(state as any);\n    } else {\n      instance.emit(state as any);\n    }\n  }\n  return instance;\n}\n\n// --- withBlocMethod ---\n\nexport function withBlocMethod<T extends StateContainerConstructor>(\n  BlocClass: T,\n  methodName: keyof InstanceType<T>,\n  impl: (...args: any[]) => any,\n  instanceKey?: string,\n): InstanceType<T> {\n  const instance = ensure(BlocClass, instanceKey);\n  (instance as any)[methodName] = impl;\n  return instance;\n}\n\n// --- flushBlocUpdates ---\n\n/**\n * Drain pending microtasks so any channel-flushed effects (subscribe()\n * listeners, `onSystemEvent('stateChanged')` handlers, plugin hooks) run\n * before the next assertion.\n *\n * The default `MicrotaskScheduler` coalesces emits within a tick; tests\n * that emit and then assert on listener side-effects need `await flush()`\n * (or its alias `flushBlocUpdates()`) between the two.\n */\nexport async function flush(): Promise<void> {\n  // queueMicrotask wins the race against the channel's own queued flush —\n  // we resolve after the channel has drained its current pending flush.\n  await Promise.resolve();\n  await Promise.resolve();\n}\n\n/** @deprecated Alias for `flush()`. */\nexport async function flushBlocUpdates(): Promise<void> {\n  await flush();\n}\n"],"mappings":";;;;;;AAYA,MAAM,qBAAqB;AAO3B,SAAgB,qBAA6C;CAC3D,OAAO,IAAI,wBAAwB;;AAGrC,SAAgB,iBACd,IACG;CACH,MAAM,WAAW,aAAa;CAC9B,MAAM,eAAe,oBAAoB;CACzC,YAAY,aAAa;CACzB,IAAI;EACF,MAAM,SAAS,GAAG,aAAa;EAC/B,IAAI,kBAAkB,SACpB,OAAO,OAAO,MACX,UAAU;GACT,YAAY,SAAS;GACrB,OAAO;MAER,UAAU;GACT,YAAY,SAAS;GACrB,MAAM;IAET;EAEH,YAAY,SAAS;EACrB,OAAO;UACA,OAAO;EACd,YAAY,SAAS;EACrB,MAAM;;;AAMV,SAAgB,gBAAsB;CACpC,IAAI;CACJ,iBAAiB;EACf,gBAAgB,aAAa;EAC7B,YAAY,IAAI,wBAAwB,CAAC;GACzC;CACF,gBAAgB;EACd,YAAY,cAAc;GAC1B;;AAKJ,MAAM,cAAc;AAEpB,SAAgB,iBACd,WACA,UACA,aACM;CACN,MAAM,MAAM,eAAe;CAE3B,aAAQ,CAAC,eACP,WACA,KACA,UACA,IAAI,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,CACnC;;AAGH,SAAgB,eACd,WACA,UACA,IACA,cAAsB,aACnB;CACH,OAAO,uBAAuB;EAC5B,iBAAiB,WAAW,UAAU,YAAY;EAClD,OAAO,IAAI;GACX;;AA4BJ,SAAgB,gBACd,WACA,SACiB;CACjB,MAAM,WAAW,IAAI,WAAW;CAIhC,IAAI,SAAS,QAAQ,MACnB,SAAS,WAAW,EAAE,MAAM,QAAQ,MAAM,CAAC;CAG7C,IAAI,SAAS,SAAS;MAChB,oBAAoB,OAAO;GAC7B,MAAM,eAAe,SAAS;GAC9B,IACE,OAAO,iBAAiB,YACxB,iBAAiB,QACjB,OAAO,QAAQ,UAAU,YACzB,QAAQ,UAAU,MAElB,SAAS,MAAM,QAAQ,MAAa;QAEpC,SAAS,KAAK,QAAQ,MAAa;;;CAIzC,IAAI,SAAS;OACN,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,QAAQ,QAAQ,EACvD,IAAI,OAAO,SAAS,YAClB,SAAkB,OAAO;;CAM/B,IAAI,SAAS,QAAQ,MACnB,SAAkB,YAAY,oBAAoB,QAAQ,KAAK;CAGjE,OAAO;;AAKT,SAAgB,cACd,WACA,OAGA,aACiB;CACjB,MAAM,WAAW,OAAO,WAAW,YAAY;CAC/C,IAAI,oBAAoB,OAAO;EAC7B,MAAM,eAAe,SAAS;EAC9B,IACE,OAAO,iBAAiB,YACxB,iBAAiB,QACjB,OAAO,UAAU,YACjB,UAAU,MAEV,SAAS,MAAM,MAAa;OAE5B,SAAS,KAAK,MAAa;;CAG/B,OAAO;;AAKT,SAAgB,eACd,WACA,YACA,MACA,aACiB;CACjB,MAAM,WAAW,OAAO,WAAW,YAAY;CAC/C,SAAkB,cAAc;CAChC,OAAO;;;;;;;;;;;AAcT,eAAsB,QAAuB;CAG3C,MAAM,QAAQ,SAAS;CACvB,MAAM,QAAQ,SAAS;;;AAIzB,eAAsB,mBAAkC;CACtD,MAAM,OAAO"}