@blac/core 2.0.0 → 2.0.3

package/dist/watch-entry.js

@@ -0,0 +1,107 @@
+import { b as stopTracking, f as hasChanges, l as createState, u as createTrackingProxy, y as startTracking } from "./tracking-proxy.js";
+import { n as watch, t as instance } from "./watch.js";
+
+//#region src/tracking/tracked.ts
+/**
+* Run a callback while tracking all bloc dependencies accessed.
+* Returns both the result and the set of discovered dependencies.
+*
+* @example
+* ```ts
+* const { result, dependencies } = tracked(() => {
+*   const user = ensure(UserBloc);
+*   return user.fullName; // getter that may access other blocs
+* });
+* // dependencies contains UserBloc + any blocs accessed in fullName getter
+* ```
+*/
+function tracked(callback, options) {
+	const tracker = createState();
+	startTracking(tracker);
+	let result;
+	try {
+		result = callback();
+	} finally {
+		stopTracking(tracker, { state: null });
+	}
+	const dependencies = new Set(tracker.dependencies);
+	for (const dep of tracker.getterState.externalDependencies) dependencies.add(dep);
+	if (options?.exclude) dependencies.delete(options.exclude);
+	return {
+		result,
+		dependencies
+	};
+}
+/**
+* Context for running tracked callbacks with bloc proxies.
+* Provides methods to create proxies and check for changes.
+*/
+var TrackedContext = class {
+	constructor() {
+		this.proxiedBlocs = /* @__PURE__ */ new WeakMap();
+		this.primaryBlocs = /* @__PURE__ */ new Set();
+		this.tracker = createState();
+	}
+	/**
+	* Get a tracking proxy for a bloc instance.
+	* The proxy will track state and getter accesses.
+	*/
+	proxy(bloc) {
+		const cached = this.proxiedBlocs.get(bloc);
+		if (cached) return cached;
+		const proxied = createTrackingProxy(bloc, this.tracker);
+		this.proxiedBlocs.set(bloc, proxied);
+		this.primaryBlocs.add(bloc);
+		return proxied;
+	}
+	/**
+	* Start tracking for a new callback execution.
+	*/
+	start() {
+		startTracking(this.tracker);
+	}
+	/**
+	* Stop tracking and get discovered dependencies.
+	* Excludes primary blocs (those explicitly proxied via proxy()).
+	*/
+	stop() {
+		const allDeps = /* @__PURE__ */ new Set();
+		for (const bloc of this.primaryBlocs) {
+			const deps = stopTracking(this.tracker, bloc);
+			for (const dep of deps) if (!this.primaryBlocs.has(dep)) allDeps.add(dep);
+		}
+		for (const dep of this.tracker.getterState.externalDependencies) if (!this.primaryBlocs.has(dep)) allDeps.add(dep);
+		return allDeps;
+	}
+	/**
+	* Check if any tracked state or getters have changed.
+	*/
+	changed() {
+		for (const bloc of this.primaryBlocs) if (hasChanges(this.tracker, bloc)) return true;
+		return false;
+	}
+	/**
+	* Get all primary blocs (those explicitly proxied).
+	*/
+	getPrimaryBlocs() {
+		return new Set(this.primaryBlocs);
+	}
+	/**
+	* Reset the context for reuse.
+	*/
+	reset() {
+		this.tracker = createState();
+		this.proxiedBlocs = /* @__PURE__ */ new WeakMap();
+		this.primaryBlocs.clear();
+	}
+};
+/**
+* Create a new tracked context for manual control over tracking.
+*/
+function createTrackedContext() {
+	return new TrackedContext();
+}
+
+//#endregion
+export { TrackedContext, createTrackedContext, instance, tracked, watch };
+//# sourceMappingURL=watch-entry.js.map

package/dist/watch-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-entry.js","names":[],"sources":["../src/tracking/tracked.ts"],"sourcesContent":["import type { StateContainerInstance } from '../types/utilities';\nimport {\n  createState,\n  startTracking,\n  stopTracking,\n  createTrackingProxy,\n  hasChanges,\n  type TrackingProxyState,\n} from './tracking-proxy';\nimport { DependencyManager } from './dependency-manager';\n\n/**\n * Result of running a tracked callback.\n */\nexport interface TrackedResult<T> {\n  result: T;\n  dependencies: Set<StateContainerInstance>;\n}\n\n/**\n * Options for the tracked() function.\n */\nexport interface TrackedOptions {\n  exclude?: StateContainerInstance;\n}\n\n/**\n * Run a callback while tracking all bloc dependencies accessed.\n * Returns both the result and the set of discovered dependencies.\n *\n * @example\n * ```ts\n * const { result, dependencies } = tracked(() => {\n *   const user = ensure(UserBloc);\n *   return user.fullName; // getter that may access other blocs\n * });\n * // dependencies contains UserBloc + any blocs accessed in fullName getter\n * ```\n */\nexport function tracked<T>(\n  callback: () => T,\n  options?: TrackedOptions,\n): TrackedResult<T> {\n  const tracker = createState();\n  startTracking(tracker);\n\n  let result: T;\n  try {\n    result = callback();\n  } finally {\n    stopTracking(tracker, { state: null } as any);\n  }\n\n  const dependencies = new Set(tracker.dependencies);\n  for (const dep of tracker.getterState.externalDependencies) {\n    dependencies.add(dep);\n  }\n\n  if (options?.exclude) {\n    dependencies.delete(options.exclude);\n  }\n\n  return { result, dependencies };\n}\n\n/**\n * Context for running tracked callbacks with bloc proxies.\n * Provides methods to create proxies and check for changes.\n */\nexport class TrackedContext {\n  private tracker: TrackingProxyState;\n  private proxiedBlocs = new WeakMap<\n    StateContainerInstance,\n    StateContainerInstance\n  >();\n  private primaryBlocs = new Set<StateContainerInstance>();\n\n  constructor() {\n    this.tracker = createState();\n  }\n\n  /**\n   * Get a tracking proxy for a bloc instance.\n   * The proxy will track state and getter accesses.\n   */\n  proxy<T extends StateContainerInstance>(bloc: T): T {\n    const cached = this.proxiedBlocs.get(bloc);\n    if (cached) {\n      return cached as T;\n    }\n\n    const proxied = createTrackingProxy(bloc, this.tracker);\n    this.proxiedBlocs.set(bloc, proxied);\n    this.primaryBlocs.add(bloc);\n    return proxied;\n  }\n\n  /**\n   * Start tracking for a new callback execution.\n   */\n  start(): void {\n    startTracking(this.tracker);\n  }\n\n  /**\n   * Stop tracking and get discovered dependencies.\n   * Excludes primary blocs (those explicitly proxied via proxy()).\n   */\n  stop(): Set<StateContainerInstance> {\n    const allDeps = new Set<StateContainerInstance>();\n\n    for (const bloc of this.primaryBlocs) {\n      const deps = stopTracking(this.tracker, bloc);\n      for (const dep of deps) {\n        if (!this.primaryBlocs.has(dep)) {\n          allDeps.add(dep);\n        }\n      }\n    }\n\n    for (const dep of this.tracker.getterState.externalDependencies) {\n      if (!this.primaryBlocs.has(dep)) {\n        allDeps.add(dep);\n      }\n    }\n\n    return allDeps;\n  }\n\n  /**\n   * Check if any tracked state or getters have changed.\n   */\n  changed(): boolean {\n    for (const bloc of this.primaryBlocs) {\n      if (hasChanges(this.tracker, bloc)) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Get all primary blocs (those explicitly proxied).\n   */\n  getPrimaryBlocs(): Set<StateContainerInstance> {\n    return new Set(this.primaryBlocs);\n  }\n\n  /**\n   * Reset the context for reuse.\n   */\n  reset(): void {\n    this.tracker = createState();\n    this.proxiedBlocs = new WeakMap();\n    this.primaryBlocs.clear();\n  }\n}\n\n/**\n * Create a new tracked context for manual control over tracking.\n */\nexport function createTrackedContext(): TrackedContext {\n  return new TrackedContext();\n}\n\nexport { DependencyManager };\n"],"mappings":";;;;;;;;;;;;;;;;;AAuCA,SAAgB,QACd,UACA,SACkB;CAClB,MAAM,UAAU,aAAa;AAC7B,eAAc,QAAQ;CAEtB,IAAI;AACJ,KAAI;AACF,WAAS,UAAU;WACX;AACR,eAAa,SAAS,EAAE,OAAO,MAAM,CAAQ;;CAG/C,MAAM,eAAe,IAAI,IAAI,QAAQ,aAAa;AAClD,MAAK,MAAM,OAAO,QAAQ,YAAY,qBACpC,cAAa,IAAI,IAAI;AAGvB,KAAI,SAAS,QACX,cAAa,OAAO,QAAQ,QAAQ;AAGtC,QAAO;EAAE;EAAQ;EAAc;;;;;;AAOjC,IAAa,iBAAb,MAA4B;CAQ1B,cAAc;sCANS,IAAI,SAGxB;sCACoB,IAAI,KAA6B;AAGtD,OAAK,UAAU,aAAa;;;;;;CAO9B,MAAwC,MAAY;EAClD,MAAM,SAAS,KAAK,aAAa,IAAI,KAAK;AAC1C,MAAI,OACF,QAAO;EAGT,MAAM,UAAU,oBAAoB,MAAM,KAAK,QAAQ;AACvD,OAAK,aAAa,IAAI,MAAM,QAAQ;AACpC,OAAK,aAAa,IAAI,KAAK;AAC3B,SAAO;;;;;CAMT,QAAc;AACZ,gBAAc,KAAK,QAAQ;;;;;;CAO7B,OAAoC;EAClC,MAAM,0BAAU,IAAI,KAA6B;AAEjD,OAAK,MAAM,QAAQ,KAAK,cAAc;GACpC,MAAM,OAAO,aAAa,KAAK,SAAS,KAAK;AAC7C,QAAK,MAAM,OAAO,KAChB,KAAI,CAAC,KAAK,aAAa,IAAI,IAAI,CAC7B,SAAQ,IAAI,IAAI;;AAKtB,OAAK,MAAM,OAAO,KAAK,QAAQ,YAAY,qBACzC,KAAI,CAAC,KAAK,aAAa,IAAI,IAAI,CAC7B,SAAQ,IAAI,IAAI;AAIpB,SAAO;;;;;CAMT,UAAmB;AACjB,OAAK,MAAM,QAAQ,KAAK,aACtB,KAAI,WAAW,KAAK,SAAS,KAAK,CAChC,QAAO;AAGX,SAAO;;;;;CAMT,kBAA+C;AAC7C,SAAO,IAAI,IAAI,KAAK,aAAa;;;;;CAMnC,QAAc;AACZ,OAAK,UAAU,aAAa;AAC5B,OAAK,+BAAe,IAAI,SAAS;AACjC,OAAK,aAAa,OAAO;;;;;;AAO7B,SAAgB,uBAAuC;AACrD,QAAO,IAAI,gBAAgB"}

package/dist/watch.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.cjs","names":["globalRegistry","BLAC_DEFAULTS","createState","createTrackingProxy","DependencyManager","stopTracking"],"sources":["../src/registry/ensure.ts","../src/watch/watch.ts"],"sourcesContent":["import { globalRegistry } from '../core/StateContainerRegistry';\nimport type { StateContainerConstructor } from '../types/utilities';\n\nexport function ensure<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey?: string,\n): InstanceType<T> {\n  return globalRegistry.ensure(BlocClass, instanceKey);\n}\n","import { ensure } from '../registry';\nimport type {\n  StateContainerConstructor,\n  StateContainerInstance,\n} from '../types/utilities';\nimport { BLAC_DEFAULTS } from '../constants';\nimport {\n  createState,\n  startTracking,\n  stopTracking,\n  createTrackingProxy,\n  type TrackingProxyState,\n} from '../tracking/tracking-proxy';\nimport { DependencyManager } from '../tracking/dependency-manager';\n\nconst STOP: unique symbol = Symbol('watch.STOP');\n\nconst BLOC_REF_MARKER = Symbol('BlocRef');\n\n/**\n * Reference to a specific bloc instance by class and instance ID.\n */\nexport interface BlocRef<T extends StateContainerConstructor> {\n  [BLOC_REF_MARKER]: true;\n  blocClass: T;\n  instanceId: string;\n}\n\n/**\n * Create a reference to a specific bloc instance.\n *\n * @example\n * ```ts\n * watch(instance(UserBloc, 'user-123'), (userBloc) => {\n *   console.log(userBloc.state.name);\n * });\n * ```\n */\nexport function instance<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceId: string,\n): BlocRef<T> {\n  return {\n    [BLOC_REF_MARKER]: true,\n    blocClass: BlocClass,\n    instanceId,\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\ntype StopSymbol = typeof STOP;\n\n/**\n * Watch function signature for single bloc.\n */\nexport interface WatchSingleFn {\n  <T extends StateContainerConstructor>(\n    bloc: T | BlocRef<T>,\n    callback: (bloc: InstanceType<T>) => void | StopSymbol,\n  ): () => void;\n\n  STOP: StopSymbol;\n}\n\n/**\n * Watch function signature for multiple blocs.\n */\nexport interface WatchMultipleFn {\n  <T extends readonly BlocInput[]>(\n    blocs: T,\n    callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n  ): () => void;\n\n  STOP: StopSymbol;\n}\n\n/**\n * Combined watch function type.\n */\nexport interface WatchFn extends WatchSingleFn {\n  <T extends readonly BlocInput[]>(\n    blocs: T,\n    callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n  ): () => void;\n}\n\nfunction resolveBloc(input: BlocInput): StateContainerInstance {\n  if (isBlocRef(input)) {\n    return ensure(input.blocClass, input.instanceId);\n  }\n  return ensure(input, BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY);\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 * Automatically tracks state property and getter accesses.\n *\n * @example Single bloc\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n *   console.log(userBloc.state.name);\n *   console.log(userBloc.fullName); // getter also tracked\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, 'user-123'),\n *   (userBloc) => {\n *     console.log(userBloc.state.name);\n *   }\n * );\n * ```\n *\n * @example Stop watching from callback\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n *   if (userBloc.state.done) {\n *     return watch.STOP;\n *   }\n * });\n * ```\n */\nfunction watchImpl<T extends StateContainerConstructor>(\n  bloc: T | BlocRef<T>,\n  callback: (bloc: InstanceType<T>) => void | StopSymbol,\n): () => void;\n\nfunction watchImpl<T extends readonly BlocInput[]>(\n  blocs: T,\n  callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n): () => void;\n\nfunction watchImpl(\n  blocsOrBloc: BlocInput | readonly BlocInput[],\n  callback: (blocsOrBloc: any) => void | StopSymbol,\n): () => void {\n  const isSingle = !isArray(blocsOrBloc);\n  const inputs = isSingle ? [blocsOrBloc] : blocsOrBloc;\n\n  const instances = inputs.map(resolveBloc);\n\n  const tracker: TrackingProxyState = createState();\n  const proxiedInstances = instances.map((inst) =>\n    createTrackingProxy(inst, tracker),\n  );\n\n  const externalDepsManager = new DependencyManager();\n\n  let disposed = false;\n  const primarySubscriptions: (() => void)[] = [];\n\n  const cleanup = () => {\n    if (disposed) return;\n    disposed = true;\n    primarySubscriptions.forEach((unsub) => unsub());\n    externalDepsManager.cleanup();\n  };\n\n  const runCallback = () => {\n    if (disposed) return;\n\n    startTracking(tracker);\n\n    let result: void | StopSymbol;\n    try {\n      const arg = isSingle ? proxiedInstances[0] : proxiedInstances;\n      result = callback(arg);\n    } finally {\n      const externalDeps = new Set<StateContainerInstance>();\n      for (const inst of instances) {\n        const deps = stopTracking(tracker, inst);\n        for (const dep of deps) {\n          externalDeps.add(dep);\n        }\n      }\n\n      for (const dep of tracker.getterState.externalDependencies) {\n        externalDeps.add(dep);\n      }\n\n      for (const inst of instances) {\n        externalDeps.delete(inst);\n      }\n\n      externalDepsManager.sync(externalDeps, runCallback);\n    }\n\n    if (result === STOP) {\n      cleanup();\n    }\n  };\n\n  const onChange = () => {\n    if (disposed) return;\n    runCallback();\n  };\n\n  for (const inst of instances) {\n    primarySubscriptions.push(inst.subscribe(onChange));\n  }\n\n  runCallback();\n\n  return cleanup;\n}\n\nexport const watch: WatchFn = Object.assign(watchImpl, { STOP }) as WatchFn;\n"],"mappings":";;;;;AAGA,SAAgB,OACd,WACA,aACiB;AACjB,QAAOA,8CAAe,OAAO,WAAW,YAAY;;;;;ACQtD,MAAM,OAAsB,OAAO,aAAa;AAEhD,MAAM,kBAAkB,OAAO,UAAU;;;;;;;;;;;AAqBzC,SAAgB,SACd,WACA,YACY;AACZ,QAAO;GACJ,kBAAkB;EACnB,WAAW;EACX;EACD;;AAGH,SAAS,UACP,OAC6C;AAC7C,QACE,OAAO,UAAU,YAAY,UAAU,QAAQ,mBAAmB;;AAqDtE,SAAS,YAAY,OAA0C;AAC7D,KAAI,UAAU,MAAM,CAClB,QAAO,OAAO,MAAM,WAAW,MAAM,WAAW;AAElD,QAAO,OAAO,OAAOC,qCAAc,qBAAqB;;AAG1D,SAAS,QAAQ,OAA+C;AAC9D,QAAO,MAAM,QAAQ,MAAM;;AAsD7B,SAAS,UACP,aACA,UACY;CACZ,MAAM,WAAW,CAAC,QAAQ,YAAY;CAGtC,MAAM,aAFS,WAAW,CAAC,YAAY,GAAG,aAEjB,IAAI,YAAY;CAEzC,MAAM,UAA8BC,oCAAa;CACjD,MAAM,mBAAmB,UAAU,KAAK,SACtCC,2CAAoB,MAAM,QAAQ,CACnC;CAED,MAAM,sBAAsB,IAAIC,8CAAmB;CAEnD,IAAI,WAAW;CACf,MAAM,uBAAuC,EAAE;CAE/C,MAAM,gBAAgB;AACpB,MAAI,SAAU;AACd,aAAW;AACX,uBAAqB,SAAS,UAAU,OAAO,CAAC;AAChD,sBAAoB,SAAS;;CAG/B,MAAM,oBAAoB;AACxB,MAAI,SAAU;AAEd,uCAAc,QAAQ;EAEtB,IAAI;AACJ,MAAI;AAEF,YAAS,SADG,WAAW,iBAAiB,KAAK,iBACvB;YACd;GACR,MAAM,+BAAe,IAAI,KAA6B;AACtD,QAAK,MAAM,QAAQ,WAAW;IAC5B,MAAM,OAAOC,oCAAa,SAAS,KAAK;AACxC,SAAK,MAAM,OAAO,KAChB,cAAa,IAAI,IAAI;;AAIzB,QAAK,MAAM,OAAO,QAAQ,YAAY,qBACpC,cAAa,IAAI,IAAI;AAGvB,QAAK,MAAM,QAAQ,UACjB,cAAa,OAAO,KAAK;AAG3B,uBAAoB,KAAK,cAAc,YAAY;;AAGrD,MAAI,WAAW,KACb,UAAS;;CAIb,MAAM,iBAAiB;AACrB,MAAI,SAAU;AACd,eAAa;;AAGf,MAAK,MAAM,QAAQ,UACjB,sBAAqB,KAAK,KAAK,UAAU,SAAS,CAAC;AAGrD,cAAa;AAEb,QAAO;;AAGT,MAAa,QAAiB,OAAO,OAAO,WAAW,EAAE,MAAM,CAAC"}

package/dist/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","names":[],"sources":["../src/registry/ensure.ts","../src/watch/watch.ts"],"sourcesContent":["import { globalRegistry } from '../core/StateContainerRegistry';\nimport type { StateContainerConstructor } from '../types/utilities';\n\nexport function ensure<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceKey?: string,\n): InstanceType<T> {\n  return globalRegistry.ensure(BlocClass, instanceKey);\n}\n","import { ensure } from '../registry';\nimport type {\n  StateContainerConstructor,\n  StateContainerInstance,\n} from '../types/utilities';\nimport { BLAC_DEFAULTS } from '../constants';\nimport {\n  createState,\n  startTracking,\n  stopTracking,\n  createTrackingProxy,\n  type TrackingProxyState,\n} from '../tracking/tracking-proxy';\nimport { DependencyManager } from '../tracking/dependency-manager';\n\nconst STOP: unique symbol = Symbol('watch.STOP');\n\nconst BLOC_REF_MARKER = Symbol('BlocRef');\n\n/**\n * Reference to a specific bloc instance by class and instance ID.\n */\nexport interface BlocRef<T extends StateContainerConstructor> {\n  [BLOC_REF_MARKER]: true;\n  blocClass: T;\n  instanceId: string;\n}\n\n/**\n * Create a reference to a specific bloc instance.\n *\n * @example\n * ```ts\n * watch(instance(UserBloc, 'user-123'), (userBloc) => {\n *   console.log(userBloc.state.name);\n * });\n * ```\n */\nexport function instance<T extends StateContainerConstructor>(\n  BlocClass: T,\n  instanceId: string,\n): BlocRef<T> {\n  return {\n    [BLOC_REF_MARKER]: true,\n    blocClass: BlocClass,\n    instanceId,\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\ntype StopSymbol = typeof STOP;\n\n/**\n * Watch function signature for single bloc.\n */\nexport interface WatchSingleFn {\n  <T extends StateContainerConstructor>(\n    bloc: T | BlocRef<T>,\n    callback: (bloc: InstanceType<T>) => void | StopSymbol,\n  ): () => void;\n\n  STOP: StopSymbol;\n}\n\n/**\n * Watch function signature for multiple blocs.\n */\nexport interface WatchMultipleFn {\n  <T extends readonly BlocInput[]>(\n    blocs: T,\n    callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n  ): () => void;\n\n  STOP: StopSymbol;\n}\n\n/**\n * Combined watch function type.\n */\nexport interface WatchFn extends WatchSingleFn {\n  <T extends readonly BlocInput[]>(\n    blocs: T,\n    callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n  ): () => void;\n}\n\nfunction resolveBloc(input: BlocInput): StateContainerInstance {\n  if (isBlocRef(input)) {\n    return ensure(input.blocClass, input.instanceId);\n  }\n  return ensure(input, BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY);\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 * Automatically tracks state property and getter accesses.\n *\n * @example Single bloc\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n *   console.log(userBloc.state.name);\n *   console.log(userBloc.fullName); // getter also tracked\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, 'user-123'),\n *   (userBloc) => {\n *     console.log(userBloc.state.name);\n *   }\n * );\n * ```\n *\n * @example Stop watching from callback\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n *   if (userBloc.state.done) {\n *     return watch.STOP;\n *   }\n * });\n * ```\n */\nfunction watchImpl<T extends StateContainerConstructor>(\n  bloc: T | BlocRef<T>,\n  callback: (bloc: InstanceType<T>) => void | StopSymbol,\n): () => void;\n\nfunction watchImpl<T extends readonly BlocInput[]>(\n  blocs: T,\n  callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n): () => void;\n\nfunction watchImpl(\n  blocsOrBloc: BlocInput | readonly BlocInput[],\n  callback: (blocsOrBloc: any) => void | StopSymbol,\n): () => void {\n  const isSingle = !isArray(blocsOrBloc);\n  const inputs = isSingle ? [blocsOrBloc] : blocsOrBloc;\n\n  const instances = inputs.map(resolveBloc);\n\n  const tracker: TrackingProxyState = createState();\n  const proxiedInstances = instances.map((inst) =>\n    createTrackingProxy(inst, tracker),\n  );\n\n  const externalDepsManager = new DependencyManager();\n\n  let disposed = false;\n  const primarySubscriptions: (() => void)[] = [];\n\n  const cleanup = () => {\n    if (disposed) return;\n    disposed = true;\n    primarySubscriptions.forEach((unsub) => unsub());\n    externalDepsManager.cleanup();\n  };\n\n  const runCallback = () => {\n    if (disposed) return;\n\n    startTracking(tracker);\n\n    let result: void | StopSymbol;\n    try {\n      const arg = isSingle ? proxiedInstances[0] : proxiedInstances;\n      result = callback(arg);\n    } finally {\n      const externalDeps = new Set<StateContainerInstance>();\n      for (const inst of instances) {\n        const deps = stopTracking(tracker, inst);\n        for (const dep of deps) {\n          externalDeps.add(dep);\n        }\n      }\n\n      for (const dep of tracker.getterState.externalDependencies) {\n        externalDeps.add(dep);\n      }\n\n      for (const inst of instances) {\n        externalDeps.delete(inst);\n      }\n\n      externalDepsManager.sync(externalDeps, runCallback);\n    }\n\n    if (result === STOP) {\n      cleanup();\n    }\n  };\n\n  const onChange = () => {\n    if (disposed) return;\n    runCallback();\n  };\n\n  for (const inst of instances) {\n    primarySubscriptions.push(inst.subscribe(onChange));\n  }\n\n  runCallback();\n\n  return cleanup;\n}\n\nexport const watch: WatchFn = Object.assign(watchImpl, { STOP }) as WatchFn;\n"],"mappings":";;;;;AAGA,SAAgB,OACd,WACA,aACiB;AACjB,QAAO,eAAe,OAAO,WAAW,YAAY;;;;;ACQtD,MAAM,OAAsB,OAAO,aAAa;AAEhD,MAAM,kBAAkB,OAAO,UAAU;;;;;;;;;;;AAqBzC,SAAgB,SACd,WACA,YACY;AACZ,QAAO;GACJ,kBAAkB;EACnB,WAAW;EACX;EACD;;AAGH,SAAS,UACP,OAC6C;AAC7C,QACE,OAAO,UAAU,YAAY,UAAU,QAAQ,mBAAmB;;AAqDtE,SAAS,YAAY,OAA0C;AAC7D,KAAI,UAAU,MAAM,CAClB,QAAO,OAAO,MAAM,WAAW,MAAM,WAAW;AAElD,QAAO,OAAO,OAAO,cAAc,qBAAqB;;AAG1D,SAAS,QAAQ,OAA+C;AAC9D,QAAO,MAAM,QAAQ,MAAM;;AAsD7B,SAAS,UACP,aACA,UACY;CACZ,MAAM,WAAW,CAAC,QAAQ,YAAY;CAGtC,MAAM,aAFS,WAAW,CAAC,YAAY,GAAG,aAEjB,IAAI,YAAY;CAEzC,MAAM,UAA8B,aAAa;CACjD,MAAM,mBAAmB,UAAU,KAAK,SACtC,oBAAoB,MAAM,QAAQ,CACnC;CAED,MAAM,sBAAsB,IAAI,mBAAmB;CAEnD,IAAI,WAAW;CACf,MAAM,uBAAuC,EAAE;CAE/C,MAAM,gBAAgB;AACpB,MAAI,SAAU;AACd,aAAW;AACX,uBAAqB,SAAS,UAAU,OAAO,CAAC;AAChD,sBAAoB,SAAS;;CAG/B,MAAM,oBAAoB;AACxB,MAAI,SAAU;AAEd,gBAAc,QAAQ;EAEtB,IAAI;AACJ,MAAI;AAEF,YAAS,SADG,WAAW,iBAAiB,KAAK,iBACvB;YACd;GACR,MAAM,+BAAe,IAAI,KAA6B;AACtD,QAAK,MAAM,QAAQ,WAAW;IAC5B,MAAM,OAAO,aAAa,SAAS,KAAK;AACxC,SAAK,MAAM,OAAO,KAChB,cAAa,IAAI,IAAI;;AAIzB,QAAK,MAAM,OAAO,QAAQ,YAAY,qBACpC,cAAa,IAAI,IAAI;AAGvB,QAAK,MAAM,QAAQ,UACjB,cAAa,OAAO,KAAK;AAG3B,uBAAoB,KAAK,cAAc,YAAY;;AAGrD,MAAI,WAAW,KACb,UAAS;;CAIb,MAAM,iBAAiB;AACrB,MAAI,SAAU;AACd,eAAa;;AAGf,MAAK,MAAM,QAAQ,UACjB,sBAAqB,KAAK,KAAK,UAAU,SAAS,CAAC;AAGrD,cAAa;AAEb,QAAO;;AAGT,MAAa,QAAiB,OAAO,OAAO,WAAW,EAAE,MAAM,CAAC"}

package/package.json

@@ -1,45 +1,148 @@
 {
   "name": "@blac/core",
-  "version": "2.0.0",
+  "version": "2.0.3",
   "license": "MIT",
   "author": "Brendan Mullins <jsnanigans@gmail.com>",
-  "main": "dist/index.cjs.js",
-  "module": "dist/index.es.js",
-  "typings": "dist/index.d.ts",
-  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jsnanigans/blac.git",
+    "directory": "packages/blac"
+  },
+  "homepage": "https://github.com/jsnanigans/blac#readme",
+  "bugs": {
+    "url": "https://github.com/jsnanigans/blac/issues"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./types": {
+      "import": {
+        "types": "./dist/types.d.ts",
+        "default": "./dist/types.js"
+      },
+      "require": {
+        "types": "./dist/types.d.cts",
+        "default": "./dist/types.cjs"
+      }
+    },
+    "./tracking": {
+      "import": {
+        "types": "./dist/tracking.d.ts",
+        "default": "./dist/tracking.js"
+      },
+      "require": {
+        "types": "./dist/tracking.d.cts",
+        "default": "./dist/tracking.cjs"
+      }
+    },
+    "./watch": {
+      "import": {
+        "types": "./dist/watch-entry.d.ts",
+        "default": "./dist/watch-entry.js"
+      },
+      "require": {
+        "types": "./dist/watch-entry.d.cts",
+        "default": "./dist/watch-entry.cjs"
+      }
+    },
+    "./plugins": {
+      "import": {
+        "types": "./dist/plugins.d.ts",
+        "default": "./dist/plugins.js"
+      },
+      "require": {
+        "types": "./dist/plugins.d.cts",
+        "default": "./dist/plugins.cjs"
+      }
+    },
+    "./debug": {
+      "import": {
+        "types": "./dist/debug.d.ts",
+        "default": "./dist/debug.js"
+      },
+      "require": {
+        "types": "./dist/debug.d.cts",
+        "default": "./dist/debug.cjs"
+      }
+    }
+  },
   "files": [
-    "dist",
-    "src",
+    "dist/index.js",
+    "dist/index.cjs",
+    "dist/index.d.ts",
+    "dist/index.d.cts",
+    "dist/types.js",
+    "dist/types.cjs",
+    "dist/types.d.ts",
+    "dist/types.d.cts",
+    "dist/tracking.js",
+    "dist/tracking.cjs",
+    "dist/tracking.d.ts",
+    "dist/tracking.d.cts",
+    "dist/tracking/**/*.d.ts",
+    "dist/watch-entry.js",
+    "dist/watch-entry.cjs",
+    "dist/watch-entry.d.ts",
+    "dist/watch-entry.d.cts",
+    "dist/plugins.js",
+    "dist/plugins.cjs",
+    "dist/plugins.d.ts",
+    "dist/plugins.d.cts",
+    "dist/debug.js",
+    "dist/debug.cjs",
+    "dist/debug.d.ts",
+    "dist/debug.d.cts",
+    "dist/*.map",
     "README.md",
     "LICENSE"
   ],
   "sideEffects": false,
   "keywords": [
     "typescript",
-    "rxjs",
     "state-management",
     "observer-pattern",
     "bloc",
     "bloc-pattern"
   ],
-  "dependencies": {},
   "devDependencies": {
-    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/jest-dom": "^6.6.4",
     "@testing-library/user-event": "^14.6.1",
-    "@vitest/browser": "^3.1.3",
-    "jsdom": "^24.1.1",
-    "prettier": "^3.5.3",
-    "typescript": "^5.8.3",
-    "vite-plugin-dts": "^4.5.3",
-    "vitest": "^1.6.0"
+    "@vitest/browser": "^3.2.4",
+    "arktype": "^2.1.23",
+    "fast-check": "^4.3.0",
+    "jsdom": "^26.1.0",
+    "prettier": "^3.6.2",
+    "tsdown": "^0.15.7",
+    "typescript": "^5.9.2",
+    "valibot": "^1.1.0",
+    "vitest": "3.2.4",
+    "zod": "^4.1.12"
   },
   "scripts": {
-    "prettier": "prettier --write ./src",
+    "dev": "tsdown --watch",
+    "build": "pnpm build:js && pnpm build:types && pnpm build:dts",
+    "build:js": "tsdown",
+    "build:types": "tsc -p tsconfig.build.json",
+    "build:dts": "api-extractor run --local && cp dist/index.d.ts dist/index.d.cts && cp -r dist/.types/tracking dist/tracking && cp dist/.types/tracking.d.ts dist/tracking.d.ts && cp dist/.types/tracking.d.ts dist/tracking.d.cts && cp dist/.types/types.d.ts dist/types.d.ts && cp dist/.types/types.d.ts dist/types.d.cts && rm -rf dist/.types",
+    "clean": "rm -rf dist",
+    "format": "prettier --write \".\"",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
     "test": "vitest run",
     "test:watch": "vitest --watch",
     "coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
-    "build": "vite build",
-    "deploy": "pnpm run build && pnpm publish --access public"
+    "deploy": "pnpm publish --access public"
   }
 }

package/dist/index.cjs.js

@@ -1,2 +0,0 @@
-"use strict";var m=Object.defineProperty;var D=(c,t,e)=>t in c?m(c,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):c[t]=e;var n=(c,t,e)=>D(c,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var g=(c=>(c.BLOC_DISPOSED="BLOC_DISPOSED",c.BLOC_CREATED="BLOC_CREATED",c.LISTENER_REMOVED="LISTENER_REMOVED",c.LISTENER_ADDED="LISTENER_ADDED",c.STATE_CHANGED="STATE_CHANGED",c.BLOC_CONSUMER_REMOVED="BLOC_CONSUMER_REMOVED",c.BLOC_CONSUMER_ADDED="BLOC_CONSUMER_ADDED",c))(g||{});const r=class r{constructor(t={}){n(this,"createdAt",Date.now());n(this,"blocInstanceMap",new Map);n(this,"isolatedBlocMap",new Map);n(this,"pluginList",[]);n(this,"postChangesToDocument",!1);n(this,"log",(...t)=>{r.enableLog&&console.warn(`☢️ [Blac ${this.createdAt.toString()}]`,...t)});n(this,"warn",(t,...e)=>{r.enableLog&&console.warn(`🚨 [Blac ${String(r.instance.createdAt)}]`,t,...e)});n(this,"error",(t,...e)=>{r.enableLog&&console.error(`🚨 [Blac ${String(r.instance.createdAt)}]`,t,...e)});n(this,"resetInstance",()=>{this.log("Reset Blac instance");const t=new Map(this.blocInstanceMap),e=new Map(this.isolatedBlocMap);t.forEach(s=>{s._dispose()}),e.forEach(s=>{s.forEach(i=>{i._dispose()})}),this.blocInstanceMap.clear(),this.isolatedBlocMap.clear(),r.instance=new r({__unsafe_ignore_singleton:!0})});n(this,"addPlugin",t=>{this.pluginList.findIndex(s=>s.name===t.name)===-1&&(this.log("Add plugin",t.name),this.pluginList.push(t))});n(this,"dispatchEventToPlugins",(t,e,s)=>{this.pluginList.forEach(i=>{i.onEvent(t,e,s)})});n(this,"dispatchEvent",(t,e,s)=>{switch(this.log(t,e,s),t){case"BLOC_DISPOSED":this.disposeBloc(e);break;case"BLOC_CONSUMER_REMOVED":case"LISTENER_REMOVED":this.log(`[${e._name}:${String(e._id)}] Listener/Consumer removed. Listeners: ${String(e._observer.size)}, Consumers: ${String(e._consumers.size)}, KeepAlive: ${String(e._keepAlive)}`),e._observer.size===0&&e._consumers.size===0&&!e._keepAlive&&(this.log(`[${e._name}:${String(e._id)}] No listeners or consumers left and not keepAlive. Disposing.`),e._dispose());break}this.dispatchEventToPlugins(t,e,s)});n(this,"disposeBloc",t=>{const e=t.constructor,s=this.createBlocInstanceMapKey(t._name,t._id);this.log(`[${t._name}:${String(t._id)}] disposeBloc called. Isolated: ${String(e.isolated)}`),e.isolated?(this.unregisterIsolatedBlocInstance(t),this.blocInstanceMap.delete(s)):this.unregisterBlocInstance(t),this.dispatchEventToPlugins("BLOC_DISPOSED",t)});n(this,"getBloc",(t,e={})=>{const{id:s}=e,i=t,a=s??t.name;if(this.log(`[${t.name}:${String(a)}] getBloc called. Options:`,e),i.isolated){const o=this.findIsolatedBlocInstance(t,a);if(o)return this.log(`[${t.name}:${String(a)}] Found existing isolated instance.`),o}if(!i.isolated){const o=this.findRegisteredBlocInstance(t,a);if(o)return this.log(`[${t.name}:${String(a)}] Found existing registered instance.`),o}return this.log(`[${t.name}:${String(a)}] No existing instance found. Creating new one.`),this.createNewBlocInstance(t,a,e)});n(this,"getBlocOrThrow",(t,e={})=>{const s=t.isolated,i=e.id||t.name,a=s?this.findIsolatedBlocInstance(t,i):this.findRegisteredBlocInstance(t,i);if(a)return a;throw new Error(`Bloc ${t.name} not found`)});n(this,"getAllBlocs",(t,e={})=>{const s=[];if(this.blocInstanceMap.forEach(i=>{i.constructor===t&&s.push(i)}),e.searchIsolated!==!1){const i=this.isolatedBlocMap.get(t);i&&s.push(...i.map(a=>a))}return s});const{__unsafe_ignore_singleton:e=!1}=t;if(!e)return r.instance;r.instance=this}static getInstance(){return r.instance}createBlocInstanceMapKey(t,e){return`${t}:${String(e)}`}unregisterBlocInstance(t){const e=this.createBlocInstanceMapKey(t._name,t._id);this.blocInstanceMap.delete(e)}registerBlocInstance(t){const e=this.createBlocInstanceMapKey(t._name,t._id);this.blocInstanceMap.set(e,t)}findRegisteredBlocInstance(t,e){if(t.isolated)return;const i=this.createBlocInstanceMapKey(t.name,e),a=this.blocInstanceMap.get(i);return a&&this.log(`[${t.name}:${String(e)}] Found registered instance. Returning.`),a}registerIsolatedBlocInstance(t){const e=t.constructor,s=this.isolatedBlocMap.get(e);s?s.push(t):this.isolatedBlocMap.set(e,[t])}unregisterIsolatedBlocInstance(t){const e=t.constructor,s=this.isolatedBlocMap.get(e);if(s){const i=s.findIndex(a=>a._id===t._id);i!==-1&&s.splice(i,1),s.length===0&&this.isolatedBlocMap.delete(e)}}findIsolatedBlocInstance(t,e){if(!t.isolated)return;const i=this.isolatedBlocMap.get(t);if(!i)return;const a=i.find(o=>o._id===e);return a&&this.log(`[${t.name}:${String(e)}] Found isolated instance. Returning.`),a}createNewBlocInstance(t,e,s={}){const{props:i,instanceRef:a}=s,o=new t(i);return o._instanceRef=a,o.props=i||null,o._updateId(e),o.isIsolated?(this.registerIsolatedBlocInstance(o),o):(this.registerBlocInstance(o),o)}};n(r,"instance",new r),n(r,"getAllBlocs",r.instance.getAllBlocs),n(r,"addPlugin",r.instance.addPlugin),n(r,"enableLog",!1),n(r,"log",r.instance.log),n(r,"warn",r.instance.warn),n(r,"error",r.instance.error),n(r,"resetInstance",r.instance.resetInstance),n(r,"getBloc",r.instance.getBloc),n(r,"getBlocOrThrow",r.instance.getBlocOrThrow);let h=r;class B{constructor(t){n(this,"bloc");n(this,"_observers",new Set);this.bloc=t}get size(){return this._observers.size}get observers(){return this._observers}subscribe(t){return this._observers.add(t),h.instance.dispatchEvent(g.LISTENER_ADDED,this.bloc,{listenerId:t.id}),t.lastState||(t.lastState=t.dependencyArray?t.dependencyArray(this.bloc.state,this.bloc.state):[]),()=>{this.unsubscribe(t)}}unsubscribe(t){this._observers.delete(t),h.instance.dispatchEvent(g.LISTENER_REMOVED,this.bloc,{listenerId:t.id})}notify(t,e,s){this._observers.forEach(i=>{let a=!1;if(i.dependencyArray){const o=i.lastState||[],p=i.dependencyArray(t,e);for(let _=0;_<p.length;_++){const S=p[_],d=o[_]||[];for(let l=0;l<S.length;l++)if(!Object.is(S[l],d[l])){a=!0;break}}i.lastState=p}else a=!0;a&&i.fn(t,e,s)})}dispose(){this._observers.forEach(t=>{var e;this.unsubscribe(t),(e=t.dispose)==null||e.call(t)}),this._observers.clear()}}class E{constructor(t){n(this,"defaultDependencySelector");n(this,"_addons");n(this,"_isolated",!1);n(this,"_observer");n(this,"_blac",h.getInstance());n(this,"_id");n(this,"_instanceRef");n(this,"_keepAlive",!1);n(this,"_createdAt",Date.now());n(this,"_state");n(this,"_oldState");n(this,"props",null);n(this,"_updateId",t=>{const e=this._id;!t||t===e||(this._id=t)});n(this,"onDispose");n(this,"_consumers",new Set);n(this,"_addConsumer",t=>{this._consumers.add(t),this._blac.dispatchEvent(g.BLOC_CONSUMER_ADDED,this,{consumerId:t})});n(this,"_removeConsumer",t=>{this._blac.log(`[${this._name}:${String(this._id??"default_id")}] Removing consumer: ${t}`),this._consumers.delete(t),this._blac.dispatchEvent(g.BLOC_CONSUMER_REMOVED,this,{consumerId:t})});n(this,"_connectAddons",()=>{const{_addons:t}=this;t&&t.forEach(e=>{var s;(s=e.onInit)==null||s.call(e,this)})});n(this,"lastUpdate",Date.now());n(this,"_pushState",(t,e,s)=>{this._state=t,this._observer.notify(t,e,s),this.lastUpdate=Date.now()});this._state=t,this._observer=new B(this),this._blac.dispatchEvent(g.BLOC_CREATED,this),this._id=this.constructor.name;const e=this.constructor;this._keepAlive=e.keepAlive,this._isolated=e.isolated,this._addons=e.addons,this._connectAddons()}get isIsolated(){return this._isolated}get isKeepAlive(){return this._keepAlive}get state(){return this._state}get _name(){return this.constructor.name}_dispose(){var t;this._observer.dispose(),this._blac.dispatchEvent(g.BLOC_DISPOSED,this),(t=this.onDispose)==null||t.call(this)}}n(E,"isolated",!1),n(E,"keepAlive",!1);class O extends E{emit(t){if(Object.is(t,this.state))return;const e=this.state,s=t;this._pushState(s,e)}patch(t,e=!1){if(typeof this.state!="object"||this.state===null){h.warn("Cubit.patch: was called on a cubit where the state is not an object. This is a no-op.");return}let s=!1;if(e)s=!0;else for(const i in t)if(Object.prototype.hasOwnProperty.call(t,i)){const o=this.state[i];if(!Object.is(t[i],o)){s=!0;break}}s&&this.emit({...this.state,...t})}}class M extends E{constructor(){super(...arguments);n(this,"eventHandlers",new Map);n(this,"add",async e=>{const s=e.constructor,i=this.eventHandlers.get(s);if(i){const a=o=>{const p=this.state;this._pushState(o,p,e)};try{await i(e,a)}catch(o){h.error(`[Bloc ${this._name}:${String(this._id)}] Error in event handler for '${s.name}':`,o,"Action:",e)}}else{const a=e.constructor.name||"UnnamedConstructor";h.warn(`[Bloc ${this._name}:${String(this._id)}] No handler registered for action type: '${a}'. Action was:`,e)}})}on(e,s){this.eventHandlers.has(e)&&h.warn(`[Bloc ${this._name}:${String(this._id)}] Handler for event '${e.name}' already registered. It will be overwritten.`),this.eventHandlers.set(e,s)}}function I(c){switch(c){case"localStorage":return localStorage;case"sessionStorage":return sessionStorage;default:return localStorage}}function w(c={}){const{keyPrefix:t="blac",keyName:e,defaultValue:s,storageType:i="localStorage"}=c,a=d=>`${t}:${String(d)}`,o=d=>{var l;try{const u=I(i).getItem(a(d));if(typeof u!="string")return s;const f=JSON.parse(u);return typeof f.v<"u"?f.v:s}catch(u){return(l=c.onError)==null||l.call(c,u),s}},p=d=>{const l=e??d._id,u=o(l);d._pushState(u,null)};let _="";return{name:"Persist",onInit:p,onEmit:({newState:d,cubit:l})=>{const u=e??l._id,f=JSON.stringify({v:d});f!==_&&(I(i).setItem(a(u),f),_=f)}}}exports.Blac=h;exports.BlacLifecycleEvent=g;exports.BlacObservable=B;exports.Bloc=M;exports.BlocBase=E;exports.Cubit=O;exports.Persist=w;
-//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs.js","sources":["../src/Blac.ts","../src/BlacObserver.ts","../src/BlocBase.ts","../src/Cubit.ts","../src/Bloc.ts","../src/addons/Persist.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { BlacPlugin } from \"./BlacPlugin\";\nimport { BlocBase, BlocInstanceId } from \"./BlocBase\";\nimport {\n  BlocBaseAbstract,\n  BlocConstructor,\n  BlocHookDependencyArrayFn,\n  BlocState,\n  InferPropsFromGeneric\n} from \"./types\";\n\n/**\n * Configuration options for the Blac instance\n */\nexport interface BlacConfig {\n  /** Whether to expose the Blac instance globally */\n  exposeBlacInstance?: boolean;\n}\n\nexport interface GetBlocOptions<B extends BlocBase<any>> {\n  id?: string;\n  dependencySelector?: BlocHookDependencyArrayFn<BlocState<B>>;\n  props?: InferPropsFromGeneric<B>;\n  onMount?: (bloc: B) => void;\n  instanceRef?: string;\n}\n\n/**\n * Enum representing different lifecycle events that can occur in the Blac system.\n * These events are used to track the lifecycle of blocs and their consumers.\n */\nexport enum BlacLifecycleEvent {\n  BLOC_DISPOSED = \"BLOC_DISPOSED\",\n  BLOC_CREATED = \"BLOC_CREATED\",\n  LISTENER_REMOVED = \"LISTENER_REMOVED\",\n  LISTENER_ADDED = \"LISTENER_ADDED\",\n  STATE_CHANGED = \"STATE_CHANGED\",\n  BLOC_CONSUMER_REMOVED = \"BLOC_CONSUMER_REMOVED\",\n  BLOC_CONSUMER_ADDED = \"BLOC_CONSUMER_ADDED\",\n}\n\n/**\n * Main Blac class that manages the state management system.\n * Implements a singleton pattern to ensure only one instance exists.\n * Handles bloc lifecycle, plugin management, and instance tracking.\n * \n * Key responsibilities:\n * - Managing bloc instances (creation, disposal, lookup)\n * - Handling isolated and non-isolated blocs\n * - Managing plugins and lifecycle events\n * - Providing logging and debugging capabilities\n */\nexport class Blac {\n  /** The singleton instance of Blac */\n  static instance: Blac = new Blac();\n  /** Timestamp when the instance was created */\n  createdAt = Date.now();\n  static getAllBlocs = Blac.instance.getAllBlocs;\n  static addPlugin = Blac.instance.addPlugin;\n  /** Map storing all registered bloc instances by their class name and ID */\n  blocInstanceMap: Map<string, BlocBase<any>> = new Map();\n  /** Map storing isolated bloc instances grouped by their constructor */\n  isolatedBlocMap: Map<BlocConstructor<any>, BlocBase<any>[]> = new Map();\n  pluginList: BlacPlugin[] = [];\n  /** Flag to control whether changes should be posted to document */\n  postChangesToDocument = false;\n\n  /**\n   * Creates a new Blac instance.\n   * @param options - Configuration options including singleton control\n   */\n  constructor(options: { __unsafe_ignore_singleton?: boolean } = {}) {\n    const { __unsafe_ignore_singleton = false } = options;\n    if (!__unsafe_ignore_singleton) {\n      return Blac.instance;\n    }\n    Blac.instance = this;\n  }\n\n  /** Flag to enable/disable logging */\n  static enableLog = false;\n\n  /**\n   * Logs messages to console when logging is enabled\n   * @param args - Arguments to log\n   */\n  log = (...args: unknown[]) => {\n    if (Blac.enableLog) console.warn(`☢️ [Blac ${this.createdAt.toString()}]`, ...args);\n  };\n  static log = Blac.instance.log;\n\n  /**\n   * Gets the singleton instance of Blac\n   * @returns The Blac instance\n   */\n  static getInstance(): Blac {\n    return Blac.instance;\n  }\n\n\n  /**\n   * Logs a warning message\n   * @param message - Warning message\n   * @param args - Additional arguments\n   */\n  warn = (message: string, ...args: unknown[]) => {\n    if (Blac.enableLog) {\n      console.warn(`🚨 [Blac ${String(Blac.instance.createdAt)}]`, message, ...args);\n    }\n  };\n  static warn = Blac.instance.warn;\n  /**\n   * Logs an error message\n   * @param message - Error message\n   * @param args - Additional arguments\n   */\n  error = (message: string, ...args: unknown[]) => {\n    if (Blac.enableLog) {\n      console.error(`🚨 [Blac ${String(Blac.instance.createdAt)}]`, message, ...args);\n    }\n  };\n  static error = Blac.instance.error;\n\n  /**\n   * Resets the Blac instance to a new one, disposing non-keepAlive blocs\n   * from the old instance.\n   */\n  resetInstance = (): void => {\n    this.log(\"Reset Blac instance\");\n\n    // Dispose non-keepAlive blocs from the current instance\n    const oldBlocInstanceMap = new Map(this.blocInstanceMap);\n    const oldIsolatedBlocMap = new Map(this.isolatedBlocMap);\n\n    oldBlocInstanceMap.forEach((bloc) => {\n      bloc._dispose();\n    });\n\n    oldIsolatedBlocMap.forEach((blocArray) => {\n      blocArray.forEach((bloc) => {\n        bloc._dispose();\n      });\n    });\n\n    this.blocInstanceMap.clear();\n    this.isolatedBlocMap.clear();\n\n    // Create and assign the new instance\n    Blac.instance = new Blac({\n      __unsafe_ignore_singleton: true,\n    });\n  }\n  static resetInstance = Blac.instance.resetInstance;\n\n  /**\n   * Adds a plugin to the Blac instance\n   * @param plugin - The plugin to add\n   */\n  addPlugin = (plugin: BlacPlugin): void => {\n    // check if already added\n    const index = this.pluginList.findIndex((p) => p.name === plugin.name);\n    if (index !== -1) return;\n    this.log(\"Add plugin\", plugin.name);\n    this.pluginList.push(plugin);\n  };\n\n  /**\n   * Dispatches a lifecycle event to all registered plugins\n   * @param event - The lifecycle event to dispatch\n   * @param bloc - The bloc instance involved in the event\n   * @param params - Additional parameters for the event\n   */\n  dispatchEventToPlugins = (\n    event: BlacLifecycleEvent,\n    bloc: BlocBase<any>,\n    params?: unknown,\n  ) => {\n    this.pluginList.forEach((plugin) => {\n      plugin.onEvent(event, bloc, params);\n    });\n  };\n\n  /**\n   * Dispatches a lifecycle event and handles related cleanup actions.\n   * This method is responsible for:\n   * - Logging the event\n   * - Handling bloc disposal when needed\n   * - Managing bloc consumer cleanup\n   * - Forwarding the event to plugins\n   * \n   * @param event - The lifecycle event to dispatch\n   * @param bloc - The bloc instance involved in the event\n   * @param params - Additional parameters for the event\n   */\n  dispatchEvent = (\n    event: BlacLifecycleEvent,\n    bloc: BlocBase<any>,\n    params?: unknown,\n  ) => {\n    this.log(event, bloc, params);\n\n    switch (event) {\n      case BlacLifecycleEvent.BLOC_DISPOSED:\n        this.disposeBloc(bloc);\n        break;\n      case BlacLifecycleEvent.BLOC_CONSUMER_REMOVED:\n      case BlacLifecycleEvent.LISTENER_REMOVED:\n        this.log(`[${bloc._name}:${String(bloc._id)}] Listener/Consumer removed. Listeners: ${String(bloc._observer.size)}, Consumers: ${String(bloc._consumers.size)}, KeepAlive: ${String(bloc._keepAlive)}`);\n        if (\n          bloc._observer.size === 0 &&\n          bloc._consumers.size === 0 &&\n          !bloc._keepAlive\n        ) {\n          this.log(`[${bloc._name}:${String(bloc._id)}] No listeners or consumers left and not keepAlive. Disposing.`);\n          bloc._dispose();\n        }\n        break;\n    }\n\n    this.dispatchEventToPlugins(event, bloc, params);\n  };\n\n  /**\n   * Disposes of a bloc instance by removing it from the appropriate registry\n   * @param bloc - The bloc instance to dispose\n   */\n  disposeBloc = (bloc: BlocBase<any>): void => {\n    const base = bloc.constructor as unknown as BlocBaseAbstract;\n    const key = this.createBlocInstanceMapKey(bloc._name, bloc._id);\n    this.log(`[${bloc._name}:${String(bloc._id)}] disposeBloc called. Isolated: ${String(base.isolated)}`);\n\n    if (base.isolated) {\n      this.unregisterIsolatedBlocInstance(bloc);\n      this.blocInstanceMap.delete(key);\n    } else {\n      this.unregisterBlocInstance(bloc);\n    }\n    this.dispatchEventToPlugins(BlacLifecycleEvent.BLOC_DISPOSED, bloc);\n  };\n\n  /**\n   * Creates a unique key for a bloc instance in the map based on the bloc class name and instance ID\n   * @param blocClassName - The name of the bloc class\n   * @param id - The instance ID\n   * @returns A unique key string in the format \"className:id\"\n   */\n  createBlocInstanceMapKey(blocClassName: string, id: BlocInstanceId): string {\n    return `${blocClassName}:${String(id)}`;\n  }\n\n  /**\n   * Unregister a bloc instance from the main registry\n   * @param bloc - The bloc instance to unregister\n   */\n  unregisterBlocInstance(bloc: BlocBase<any>): void {\n    const key = this.createBlocInstanceMapKey(bloc._name, bloc._id);\n    this.blocInstanceMap.delete(key);\n  }\n\n  /**\n   * Registers a bloc instance in the main registry\n   * @param bloc - The bloc instance to register\n   */\n  registerBlocInstance(bloc: BlocBase<any>): void {\n    const key = this.createBlocInstanceMapKey(bloc._name, bloc._id);\n    this.blocInstanceMap.set(key, bloc);\n  }\n\n  /**\n   * Finds a registered bloc instance by its class and ID\n   * @param blocClass - The bloc class to search for\n   * @param id - The instance ID\n   * @returns The found bloc instance or undefined if not found\n   */\n  findRegisteredBlocInstance<B extends BlocConstructor<unknown>>(\n    blocClass: B,\n    id: BlocInstanceId,\n  ): InstanceType<B> | undefined {\n    const base = blocClass as unknown as BlocBaseAbstract;\n    if (base.isolated) return undefined;\n\n    const key = this.createBlocInstanceMapKey(blocClass.name, id);\n    const found = this.blocInstanceMap.get(key) as InstanceType<B> | undefined;\n    if (found) {\n      this.log(`[${blocClass.name}:${String(id)}] Found registered instance. Returning.`);\n    }\n    return found \n  }\n\n  /**\n   * Registers an isolated bloc instance in the isolated registry\n   * @param bloc - The isolated bloc instance to register\n   */\n  registerIsolatedBlocInstance(bloc: BlocBase<any>): void {\n    const blocClass = bloc.constructor as BlocConstructor<unknown>;\n    const blocs = this.isolatedBlocMap.get(blocClass);\n    if (blocs) {\n      blocs.push(bloc);\n    } else {\n      this.isolatedBlocMap.set(blocClass, [bloc]);\n    }\n  }\n\n  /**\n   * Unregister an isolated bloc instance from the isolated registry\n   * @param bloc - The isolated bloc instance to unregister\n   */\n  unregisterIsolatedBlocInstance(bloc: BlocBase<any>): void {\n    const blocClass = bloc.constructor;\n    const blocs = this.isolatedBlocMap.get(blocClass as BlocConstructor<unknown>);\n    if (blocs) {\n      const index = blocs.findIndex((b) => b._id === bloc._id);\n      if (index !== -1) {\n        blocs.splice(index, 1);\n      }\n\n      if (blocs.length === 0) {\n        this.isolatedBlocMap.delete(blocClass as BlocConstructor<unknown>);\n      }\n    }\n  }\n\n  /**\n   * Finds an isolated bloc instance by its class and ID\n   */\n  findIsolatedBlocInstance<B extends BlocConstructor<unknown>>(\n    blocClass: B,\n    id: BlocInstanceId,\n  ): InstanceType<B> | undefined {\n    const base = blocClass as unknown as BlocBaseAbstract;\n    if (!base.isolated) return undefined;\n\n    const blocs = this.isolatedBlocMap.get(blocClass);\n    if (!blocs) return undefined;\n\n    // Fix: Find the specific bloc by ID within the isolated array\n    const found = blocs.find((b) => b._id === id) as InstanceType<B> | undefined;\n\n    if (found) {\n      this.log(`[${blocClass.name}:${String(id)}] Found isolated instance. Returning.`);\n    }\n\n    return found;\n  }\n\n  /**\n   * Creates a new bloc instance and registers it in the appropriate registry\n   * @param blocClass - The bloc class to instantiate\n   * @param id - The instance ID\n   * @param props - Properties to pass to the bloc constructor\n   * @param instanceRef - Optional reference string for the instance\n   * @returns The newly created bloc instance\n   */\n  createNewBlocInstance<B extends BlocConstructor<BlocBase<any>>>(\n    blocClass: B,\n    id: BlocInstanceId,\n    options: GetBlocOptions<InstanceType<B>> = {},\n  ): InstanceType<B> {\n    const { props, instanceRef } = options;\n    const newBloc = new blocClass(props as never) as InstanceType<BlocConstructor<BlocBase<unknown>>>;\n    newBloc._instanceRef = instanceRef;\n    newBloc.props = props || null;\n    newBloc._updateId(id);\n\n    if (newBloc.isIsolated) {\n      this.registerIsolatedBlocInstance(newBloc);\n      return newBloc as InstanceType<B>;\n    }\n\n    this.registerBlocInstance(newBloc);\n    return newBloc as InstanceType<B>;\n  }\n\n  /**\n   * Gets or creates a bloc instance based on the provided class and options.\n   * If a bloc with the given ID exists, it will be returned. Otherwise, a new instance will be created.\n   * \n   * @param blocClass - The bloc class to get or create\n   * @param options - Options including:\n   *   - id: The instance ID (defaults to class name if not provided)\n   *   - props: Properties to pass to the bloc constructor\n   *   - instanceRef: Optional reference string for the instance\n   * @returns The bloc instance\n   */\n  getBloc = <B extends BlocConstructor<BlocBase<any>>>(\n    blocClass: B,\n    options: GetBlocOptions<InstanceType<B>> = {},\n  ): InstanceType<B> => {\n    const { id } = options;\n    const base = blocClass as unknown as BlocBaseAbstract;\n    const blocId = id ?? blocClass.name;\n\n    this.log(`[${blocClass.name}:${String(blocId)}] getBloc called. Options:`, options);\n\n    if (base.isolated) {\n      const isolatedBloc = this.findIsolatedBlocInstance<B>(blocClass, blocId)\n      if (isolatedBloc) {\n        this.log(`[${blocClass.name}:${String(blocId)}] Found existing isolated instance.`);\n        return isolatedBloc;\n      }\n    }\n\n    if (!base.isolated) {\n      const registeredBloc = this.findRegisteredBlocInstance(blocClass, blocId)\n      if (registeredBloc) {\n        this.log(`[${blocClass.name}:${String(blocId)}] Found existing registered instance.`);\n        return registeredBloc\n      }\n    }\n\n    this.log(`[${blocClass.name}:${String(blocId)}] No existing instance found. Creating new one.`);\n    return this.createNewBlocInstance(\n      blocClass,\n      blocId,\n      options,\n    );\n  };\n  static getBloc = Blac.instance.getBloc;\n\n  /**\n   * Gets a bloc instance or throws an error if it doesn't exist\n   * @param blocClass - The bloc class to get\n   * @param options - Options including:\n   *   - id: The instance ID (defaults to class name if not provided)\n   *   - props: Properties to pass to the bloc constructor\n   *   - instanceRef: Optional reference string for the instance\n   */\n  getBlocOrThrow = <B extends BlocConstructor<unknown>>(\n    blocClass: B,\n    options: {\n      id?: BlocInstanceId;\n      props?: InferPropsFromGeneric<B>;\n      instanceRef?: string;\n    } = {},\n  ): InstanceType<B> => {\n    const isIsolated = (blocClass as unknown as BlocBaseAbstract).isolated;\n    const id = options.id || blocClass.name;\n\n    const registered = isIsolated\n      ? this.findIsolatedBlocInstance(blocClass, id)\n      : this.findRegisteredBlocInstance(blocClass, id);\n\n    if (registered) {\n      return registered;\n    }\n    throw new Error(`Bloc ${blocClass.name} not found`);\n  };\n  static getBlocOrThrow = Blac.instance.getBlocOrThrow;\n\n  /**\n   * Gets all instances of a specific bloc class\n   * @param blocClass - The bloc class to search for\n   * @param options - Options including:\n   *   - searchIsolated: Whether to search in isolated blocs (defaults to bloc's isolated property)\n   * @returns Array of matching bloc instances\n   */\n  getAllBlocs = <B extends BlocConstructor<unknown>>(\n    blocClass: B,\n    options: {\n      searchIsolated?: boolean;\n    } = {},\n  ): InstanceType<B>[] => {\n    const results: InstanceType<B>[] = [];\n    // const blocClassName = (blocClass as any).name; // Temporarily removed for debugging\n\n    // Search non-isolated blocs\n    this.blocInstanceMap.forEach((blocInstance) => {\n      if (blocInstance.constructor === blocClass) { // Strict constructor check\n        results.push(blocInstance as InstanceType<B>);\n      }\n    });\n\n    // Optionally search isolated blocs\n    if (options.searchIsolated !== false) {\n      const isolatedBlocs = this.isolatedBlocMap.get(blocClass);\n      if (isolatedBlocs) {\n        results.push(...isolatedBlocs.map(bloc => bloc as InstanceType<B>));\n      }\n    }\n\n    return results;\n  };\n}\n","import { Blac, BlacLifecycleEvent } from './Blac';\nimport { BlocBase } from './BlocBase';\nimport { BlocHookDependencyArrayFn } from './types';\n\n/**\n * Represents an observer that can subscribe to state changes in a Bloc\n * @template S - The type of state being observed\n */\nexport type BlacObserver<S> = {\n  /** Function to be called when state changes */\n  fn: (newState: S, oldState: S, action?: unknown) => void | Promise<void>;\n  /** Optional function to determine if the observer should be notified of state changes */\n  dependencyArray?: BlocHookDependencyArrayFn<S>;\n  /** Dispose function for the observer */\n  dispose?: () => void;\n  /** Cached state values used for dependency comparison */\n  lastState?: unknown[][];\n  /** Unique identifier for the observer */\n  id: string;\n};\n\n/**\n * A class that manages observers for a Bloc's state changes\n * @template S - The type of state being observed\n */\nexport class BlacObservable<S = unknown> {\n  /** The Bloc instance this observable is associated with */\n  bloc: BlocBase<S>;\n\n  /**\n   * Creates a new BlacObservable instance\n   * @param bloc - The Bloc instance to observe\n   */\n  constructor(bloc: BlocBase<S>) {\n    this.bloc = bloc;\n  }\n\n  private _observers = new Set<BlacObserver<S>>();\n\n  /**\n   * Gets the number of active observers\n   * @returns The number of observers currently subscribed\n   */\n  get size(): number {\n    return this._observers.size;\n  }\n\n  /**\n   * Gets the set of all observers\n   * @returns The Set of all BlacObserver instances\n   */\n  get observers() {\n    return this._observers;\n  }\n\n  /**\n   * Subscribes an observer to state changes\n   * @param observer - The observer to subscribe\n   * @returns A function that can be called to unsubscribe the observer\n   */\n  subscribe(observer: BlacObserver<S>): () => void {\n    this._observers.add(observer);\n    Blac.instance.dispatchEvent(BlacLifecycleEvent.LISTENER_ADDED, this.bloc, { listenerId: observer.id });\n    if (!observer.lastState) {\n      observer.lastState = observer.dependencyArray\n        ? observer.dependencyArray(this.bloc.state, this.bloc.state)\n        : [];\n    }\n    return () => {\n      this.unsubscribe(observer);\n    }\n  }\n\n  /**\n   * Unsubscribes an observer from state changes\n   * @param observer - The observer to unsubscribe\n   */\n  unsubscribe(observer: BlacObserver<S>) {\n    this._observers.delete(observer);\n    Blac.instance.dispatchEvent(BlacLifecycleEvent.LISTENER_REMOVED, this.bloc, { listenerId: observer.id });\n  }\n\n  /**\n   * Notifies all observers of a state change\n   * @param newState - The new state value\n   * @param oldState - The previous state value\n   * @param action - Optional action that triggered the state change\n   */\n  notify(newState: S, oldState: S, action?: unknown) {\n    this._observers.forEach((observer) => {\n      let shouldUpdate = false;\n\n      if (observer.dependencyArray) {\n        const lastDependencyCheck = observer.lastState || [];\n        const newDependencyCheck = observer.dependencyArray(newState, oldState);\n\n        for (let o = 0; o < newDependencyCheck.length; o++) {\n          const partNew = newDependencyCheck[o];\n          const partOld = lastDependencyCheck[o] || [];\n          for (let i = 0; i < partNew.length; i++) {\n            if (!Object.is(partNew[i], partOld[i])) {\n              shouldUpdate = true;\n              break;\n            }\n          }\n        }\n\n        observer.lastState = newDependencyCheck;\n      } else {\n        shouldUpdate = true;\n      }\n\n      if (shouldUpdate) {\n        void observer.fn(newState, oldState, action);\n      }\n    });\n  }\n\n  /**\n   * Disposes of all observers and clears the observer set\n   */\n  dispose() {\n    this._observers.forEach((observer) => {\n      this.unsubscribe(observer);\n      observer.dispose?.();\n    });\n    this._observers.clear();\n  }\n}\n","import { Blac, BlacLifecycleEvent } from './Blac';\nimport { BlacObservable } from './BlacObserver';\nimport BlacAddon from './addons/BlacAddon';\nimport { BlocConstructor } from './types';\n\nexport type BlocInstanceId = string | number | undefined;\ntype DependencySelector<S> = (newState: S, oldState?: S) => unknown[][];\n\n// Define an interface for the static properties expected on a Bloc/Cubit constructor\ninterface BlocStaticProperties {\n  isolated: boolean;\n  keepAlive: boolean;\n  addons?: BlacAddon[];\n}\n\n/**\n * Base class for both Blocs and Cubits that provides core state management functionality.\n * Handles state transitions, observer notifications, lifecycle management, and addon integration.\n * \n * @abstract This class should be extended, not instantiated directly\n * @template S The type of state managed by this Bloc\n * @template P The type of props that can be passed during instance creation (optional)\n */\nexport abstract class BlocBase<\n  S,\n  P = unknown\n> {\n  /**\n   * When true, every consumer will receive its own unique instance of this Bloc.\n   * Use this when state should not be shared between components.\n   * @default false\n   */\n  static isolated = false;\n  get isIsolated() {\n    return this._isolated;\n  }\n  \n  /**\n   * When true, the Bloc instance persists even when there are no active consumers.\n   * Useful for maintaining state between component unmount/remount cycles.\n   * @default false\n   */\n  static keepAlive = false;\n  get isKeepAlive() {\n    return this._keepAlive;\n  }\n  \n  /**\n   * Defines how dependencies are selected from the state for efficient updates.\n   * When provided, observers will only be notified when selected dependencies change.\n   */\n  defaultDependencySelector: DependencySelector<S> | undefined;\n\n  /**\n   * @internal\n   * Optional array of addons to extend the functionality of this Bloc.\n   */\n  public _addons?: BlacAddon[];\n  \n  /**\n   * @internal\n   * Indicates if this specific Bloc instance is isolated from others of the same type.\n   */\n  public _isolated = false;\n  \n  /**\n   * @internal\n   * Observable responsible for managing state listeners and notifying consumers.\n   */\n  public _observer: BlacObservable<S>;\n  \n  /**\n   * @internal\n   * Reference to the global Blac manager instance.\n   */\n  public _blac = Blac.getInstance();\n  \n  /**\n   * The unique identifier for this Bloc instance.\n   * Defaults to the class name, but can be customized.\n   */\n  public _id: BlocInstanceId;\n  \n  /**\n   * @internal\n   * Reference string used internally for tracking and debugging.\n   */\n  public _instanceRef?: string;\n  \n  /**\n   * @internal\n   * Indicates if this specific Bloc instance should be kept alive when no consumers are present.\n   */\n  public _keepAlive = false;\n  \n  /**\n   * @readonly\n   * Timestamp when this Bloc instance was created, useful for debugging and performance tracking.\n   */\n  public readonly _createdAt = Date.now();\n\n  /**\n   * @internal\n   * The current state of the Bloc.\n   */\n  public _state: S;\n  \n  /**\n   * @internal\n   * The previous state of the Bloc, maintained for comparison and history.\n   */\n  public _oldState: S | undefined;\n  \n  /**\n   * Props passed during Bloc instance creation.\n   * Can be used to configure or parameterize the Bloc's behavior.\n   */\n  public props: P | null = null;\n\n  /**\n   * Creates a new BlocBase instance with the given initial state.\n   * Sets up the observer, registers with the Blac manager, and initializes addons.\n   * \n   * @param initialState The initial state value for this Bloc\n   */\n  constructor(initialState: S) {\n    this._state = initialState;\n    this._observer = new BlacObservable(this);\n    this._blac.dispatchEvent(BlacLifecycleEvent.BLOC_CREATED, this);\n    this._id = this.constructor.name;\n\n    // Use a type assertion for the constructor to access static properties safely\n    const constructorWithStaticProps = this.constructor as BlocConstructor<this> & BlocStaticProperties;\n\n    this._keepAlive = constructorWithStaticProps.keepAlive;\n    this._isolated = constructorWithStaticProps.isolated;\n    this._addons = constructorWithStaticProps.addons;\n\n    this._connectAddons();\n  }\n\n  /**\n   * Returns the current state of the Bloc.\n   * Use this getter to access the state in a read-only manner.\n   */\n  get state(): S {\n    return this._state;\n  }\n\n  /**\n   * @internal\n   * Returns the name of the Bloc class for identification and debugging.\n   */\n  get _name() {\n    return this.constructor.name;\n  }\n\n  /**\n   * @internal\n   * Updates the Bloc instance's ID to a new value.\n   * Only updates if the new ID is defined and different from the current one.\n   * \n   * @param id The new ID to assign to this Bloc instance\n   */\n  _updateId = (id?: BlocInstanceId) => {\n    const originalId = this._id;\n    if (!id || id === originalId) return;\n    this._id = id;\n  };\n\n  /**\n   * @internal\n   * Cleans up resources and removes this Bloc from the system.\n   * Notifies the Blac manager and clears all observers.\n   */\n  _dispose() {\n    this._observer.dispose();\n    this._blac.dispatchEvent(BlacLifecycleEvent.BLOC_DISPOSED, this);\n    this.onDispose?.();\n  }\n\n  /**\n   * @internal\n   * Optional function to be called when the Bloc is disposed.\n   */\n  onDispose?: () => void;\n\n  /**\n   * @internal\n   * Set of consumer IDs currently listening to this Bloc's state changes.\n   */\n  _consumers = new Set<string>();\n\n  /**\n   * @internal\n   * Registers a new consumer to this Bloc instance.\n   * Notifies the Blac manager that a consumer has been added.\n   * \n   * @param consumerId The unique ID of the consumer being added\n   */\n  _addConsumer = (consumerId: string) => {\n    this._consumers.add(consumerId);\n    this._blac.dispatchEvent(BlacLifecycleEvent.BLOC_CONSUMER_ADDED, this, { consumerId });\n  };\n\n  /**\n   * @internal\n   * Unregisters a consumer from this Bloc instance.\n   * Notifies the Blac manager that a consumer has been removed.\n   * \n   * @param consumerId The unique ID of the consumer being removed\n   */\n  _removeConsumer = (consumerId: string) => {\n    this._blac.log(`[${this._name}:${String(this._id ?? 'default_id')}] Removing consumer: ${consumerId}`);\n    this._consumers.delete(consumerId);\n    this._blac.dispatchEvent(BlacLifecycleEvent.BLOC_CONSUMER_REMOVED, this, { consumerId });\n  };\n\n  /**\n   * @internal\n   * Initializes all registered addons for this Bloc instance.\n   * Calls the onInit lifecycle method on each addon if defined.\n   */\n  _connectAddons = () => {\n    const { _addons: addons } = this;\n    if (addons) {\n      addons.forEach(addon => {\n        addon.onInit?.(this);\n      });\n    }\n  };\n\n  lastUpdate = Date.now();\n\n  /**\n   * @internal\n   * Updates the state and notifies all observers of the change.\n   * \n   * @param newState The new state to be set\n   * @param oldState The previous state for comparison\n   * @param action Optional metadata about what caused the state change\n   */\n  _pushState = (newState: S, oldState: S, action?: unknown): void => {\n    this._state = newState;\n    this._observer.notify(newState, oldState, action);\n    this.lastUpdate = Date.now();\n  };\n}\n","import { Blac } from './Blac';\nimport { BlocBase } from './BlocBase';\n\n/**\n * A Cubit is a simpler version of a Bloc that doesn't handle events.\n * It manages state and provides methods to update it.\n * @template S - The type of state this Cubit manages\n * @template P - The type of parameters (optional, defaults to null)\n */\nexport abstract class Cubit<S, P = null> extends BlocBase<S, P> {\n  /**\n   * Updates the current state and notifies all observers of the change.\n   * If the new state is identical to the current state (using Object.is),\n   * no update will occur.\n   * @param state - The new state to set\n   */\n  emit(state: S): void {\n    if (Object.is(state, this.state)) {\n      return;\n    }\n\n    const oldState = this.state;\n    const newState = state;\n    this._pushState(newState, oldState);\n  }\n\n  /**\n   * Partially updates the current state by merging it with the provided state patch.\n   * This method is only applicable when the state is an object type.\n   * \n   * @param statePatch - A partial state object containing only the properties to update\n   * @param ignoreChangeCheck - If true, skips checking if the state has actually changed\n   * @throws {TypeError} If the state is not an object type\n   */\n  patch(\n    statePatch: S extends object ? Partial<S> : S,\n    ignoreChangeCheck = false,\n  ): void {\n    if (typeof this.state !== 'object' || this.state === null) {\n      Blac.warn(\n        'Cubit.patch: was called on a cubit where the state is not an object. This is a no-op.',\n      );\n      return;\n    }\n\n    let changes = false;\n    if (!ignoreChangeCheck) {\n      for (const key in statePatch) {\n        if (Object.prototype.hasOwnProperty.call(statePatch, key)) {\n          const s = this.state;\n          const current = s[key as keyof S];\n          if (!Object.is(statePatch[key as keyof S], current)) {\n            changes = true;\n            break;\n          }\n        }\n      }\n    } else {\n      changes = true;\n    }\n\n    if (changes) {\n      this.emit({\n        ...this.state,\n        ...(statePatch as Partial<S>),\n      } as S);\n    }\n  }\n}\n","import { Blac } from './Blac';\nimport { BlocBase } from './BlocBase';\n\n// A should be the base type for all events this Bloc handles and must be an object type\n// to access action.constructor. Events are typically class instances.\n// P is for props, changed from any to unknown.\nexport abstract class Bloc<\n    S, // State type\n    A extends object, // Base Action/Event type, constrained to object\n    P = unknown // Props type\n> extends BlocBase<S, P> {\n    // Stores handlers: Map<EventConstructor (subtype of A), HandlerFunction>\n    // The handler's event parameter will be correctly typed to the specific EventConstructor\n    // by the 'on' method's signature.\n    readonly eventHandlers: Map<\n        // Key: Constructor of a specific event E (where E extends A)\n        // Using 'any[]' for constructor arguments for broader compatibility.\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        new (...args: any[]) => A,\n        // Value: Handler function. 'event: A' is used here for the stored function type.\n        // The 'on' method ensures the specific handler (event: E) is correctly typed.\n        (event: A, emit: (newState: S) => void) => void | Promise<void>\n    > = new Map();\n\n    /**\n     * Registers an event handler for a specific event type.\n     * This method is typically called in the constructor of a derived Bloc class.\n     * @param eventConstructor The constructor of the event to handle (e.g., LoadDataEvent).\n     * @param handler A function that processes the event and can emit new states.\n     *                The 'event' parameter in the handler will be typed to the specific eventConstructor.\n     */\n    protected on<E extends A>(\n        // Using 'any[]' for constructor arguments for broader compatibility.\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        eventConstructor: new (...args: any[]) => E, \n        handler: (event: E, emit: (newState: S) => void) => void | Promise<void>\n    ): void {\n        if (this.eventHandlers.has(eventConstructor)) {\n            // Using Blac.warn or a similar logging mechanism from BlocBase if available,\n            // otherwise console.warn. Assuming this._name and this._id are available from BlocBase.\n            Blac.warn(\n                `[Bloc ${this._name}:${String(this._id)}] Handler for event '${eventConstructor.name}' already registered. It will be overwritten.`\n            );\n        }\n        // Cast the specific handler (event: E) to a more general (event: A) for storage.\n        // This is safe because E extends A. When the handler is called with an 'action' of type A,\n        // if it was originally registered for type E, 'action' must be an instance of E.\n        this.eventHandlers.set(\n            eventConstructor,\n            handler as (event: A, emit: (newState: S) => void) => void | Promise<void>\n        );\n    }\n\n    /**\n     * Dispatches an action/event to the Bloc.\n     * If a handler is registered for this specific event type (via 'on'), it will be invoked.\n     * Asynchronous handlers are awaited.\n     * @param action The action/event instance to be processed.\n     */\n    public add = async (action: A): Promise<void> => {\n        // Using 'any[]' for constructor arguments for broader compatibility.\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const eventConstructor = action.constructor as new (...args: any[]) => A;\n        const handler = this.eventHandlers.get(eventConstructor);\n\n        if (handler) {\n            // Define the 'emit' function that handlers will use to update state.\n            // It captures the current state ('this.state') right before each emission\n            // to provide the correct 'previousState' to _pushState.\n            const emit = (newState: S): void => {\n                const previousState = this.state; // State just before this specific emission\n                // The 'action' passed to _pushState is the original action that triggered the handler,\n                // providing context for the state change (e.g., for logging or plugins).\n                this._pushState(newState, previousState, action);\n            };\n\n            try {\n                // Await the handler in case it's an async function (e.g., performs API calls).\n                // The 'action' is passed to the handler, and due to the way 'on' is typed,\n                // the 'event' parameter within the handler function will be correctly\n                // typed to its specific class (e.g., LoadMyFeatureData).\n                await handler(action, emit);\n            } catch (error) {\n                // It's good practice to handle errors occurring within event handlers.\n                Blac.error(\n                    `[Bloc ${this._name}:${String(this._id)}] Error in event handler for '${eventConstructor.name}':`,\n                    error,\n                    \"Action:\", action\n                );\n                // Depending on the desired error handling strategy, you might:\n                // 1. Emit a specific error state: this.emit(new MyErrorState(error));\n                // 2. Re-throw the error: throw error;\n                // 3. Log and ignore (as done here by default).\n                // This should be decided based on application requirements.\n            }\n        } else {\n            // action.constructor.name should be safe due to 'A extends object' and common JS practice for constructors.\n            // If linting still complains, it might be overly strict for this common pattern.\n            const constructorName = (action.constructor as { name?: string }).name || 'UnnamedConstructor';\n            Blac.warn(\n                `[Bloc ${this._name}:${String(this._id)}] No handler registered for action type: '${constructorName}'. Action was:`,\n                action\n            );\n            // If no handler is found, the action is effectively ignored.\n            // Consider if this is the desired behavior or if an error should be thrown\n            // or a default handler should be invoked.\n        }\n    };\n}\n","import { BlocBase, BlocInstanceId } from '../BlocBase';\nimport BlacAddon, { BlacAddonEmit, BlacAddonInit } from './BlacAddon';\n\ntype StorageType = 'localStorage' | 'sessionStorage';\n\nfunction getStorage(type: StorageType): Storage {\n  switch (type) {\n    case 'localStorage':\n      return localStorage;\n    case 'sessionStorage':\n      return sessionStorage;\n    default:\n      return localStorage;\n  }\n}\n\n/**\n * Persist addon\n *\n * @param options\n * @returns BlacAddon\n */\nexport function Persist(\n  options: {\n    /**\n     * @default 'blac'\n     */\n    keyPrefix?: string;\n    /**\n     * @default the bloc's id\n     */\n    keyName?: string;\n    /**\n     * Used when the value is not found in storage\n     */\n    defaultValue?: unknown;\n\n    /**\n     * @default 'localStorage'\n     * @see StorageType\n     */\n    storageType?: StorageType;\n\n    /**\n     * @default false\n     */\n    onError?: (e: unknown) => void;\n  } = {},\n): BlacAddon {\n  const {\n    keyPrefix = 'blac',\n    keyName,\n    defaultValue,\n    storageType = 'localStorage',\n  } = options;\n\n  const fullKey = (id: string | BlocInstanceId) => `${keyPrefix}:${String(id)}`;\n\n  const getFromLocalStorage = (id: string | BlocInstanceId): unknown => {\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n      const value = getStorage(storageType).getItem(fullKey(id));\n      if (typeof value !== 'string') {\n        return defaultValue;\n      }\n\n      const p = JSON.parse(value) as { v: unknown };\n      if (typeof p.v !== 'undefined') {\n        return p.v;\n      } else {\n        return defaultValue;\n      }\n    } catch (e) {\n      options.onError?.(e);\n      return defaultValue;\n    }\n  };\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const onInit: BlacAddonInit = (e: BlocBase<any>) => {\n    const id = keyName ?? e._id;\n\n    const value = getFromLocalStorage(id);\n    e._pushState(value, null);\n  };\n\n  let currentCachedValue = '';\n  const onEmit: BlacAddonEmit = ({ newState, cubit }) => {\n    const id = keyName ?? cubit._id;\n\n    const newValue = JSON.stringify({ v: newState });\n\n    if (newValue !== currentCachedValue) {\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access\n      getStorage(storageType).setItem(fullKey(id), newValue);\n      currentCachedValue = newValue;\n    }\n  };\n\n  return {\n    name: 'Persist',\n    onInit,\n    onEmit,\n  };\n}\n"],"names":["BlacLifecycleEvent","_Blac","options","__publicField","args","message","oldBlocInstanceMap","oldIsolatedBlocMap","bloc","blocArray","plugin","p","event","params","base","key","blocClass","id","blocId","isolatedBloc","registeredBloc","isIsolated","registered","results","blocInstance","isolatedBlocs","__unsafe_ignore_singleton","blocClassName","found","blocs","index","b","props","instanceRef","newBloc","Blac","BlacObservable","observer","newState","oldState","action","shouldUpdate","lastDependencyCheck","newDependencyCheck","o","partNew","partOld","i","_a","BlocBase","initialState","originalId","consumerId","addons","addon","constructorWithStaticProps","Cubit","state","statePatch","ignoreChangeCheck","changes","current","Bloc","eventConstructor","handler","emit","previousState","error","constructorName","getStorage","type","Persist","keyPrefix","keyName","defaultValue","storageType","fullKey","getFromLocalStorage","value","e","onInit","currentCachedValue","cubit","newValue"],"mappings":"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"}