svelte-effect-runtime 1.6.2 → 2.0.0-beta.1

package/.dist/chunks/descriptors-CU2g4U_i.js

@@ -0,0 +1,36 @@
+//#region src/internal/descriptors.ts
+const default_excluded_descriptor_keys = new Set([
+	"length",
+	"name",
+	"prototype"
+]);
+/**
+* Copies own property descriptors from a native helper to a wrapper while
+* skipping function metadata and any caller-specific keys.
+*
+* @example
+* ```ts
+* copy_property_descriptors(native_remote, wrapped_remote);
+* ```
+*
+* @since 2.0.0
+* @param source - Source object or function whose descriptors should be
+*   mirrored.
+* @param target - Wrapper object or function that receives copied descriptors.
+* @param exclude - Additional property keys that should not be copied.
+* @returns Nothing.
+*/
+function copy_property_descriptors(source, target, exclude = default_excluded_descriptor_keys) {
+	if (typeof source !== "object" && typeof source !== "function") return;
+	if (source === null) return;
+	for (const key of Reflect.ownKeys(source)) {
+		if (default_excluded_descriptor_keys.has(key) || exclude.has(key)) continue;
+		const descriptor = Object.getOwnPropertyDescriptor(source, key);
+		if (!descriptor) continue;
+		Object.defineProperty(target, key, descriptor);
+	}
+}
+//#endregion
+export { copy_property_descriptors as t };
+
+//# sourceMappingURL=descriptors-CU2g4U_i.js.map

package/.dist/chunks/descriptors-CU2g4U_i.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors-CU2g4U_i.js","names":[],"sources":["../../../modules/svelte-effect-runtime/src/internal/descriptors.ts"],"sourcesContent":["const default_excluded_descriptor_keys = new Set<PropertyKey>([\n  \"length\",\n  \"name\",\n  \"prototype\",\n]);\n\n/**\n * Copies own property descriptors from a native helper to a wrapper while\n * skipping function metadata and any caller-specific keys.\n *\n * @example\n * ```ts\n * copy_property_descriptors(native_remote, wrapped_remote);\n * ```\n *\n * @since 2.0.0\n * @param source - Source object or function whose descriptors should be\n *   mirrored.\n * @param target - Wrapper object or function that receives copied descriptors.\n * @param exclude - Additional property keys that should not be copied.\n * @returns Nothing.\n */\nexport function copy_property_descriptors(\n  source: unknown,\n  target: object,\n  exclude: ReadonlySet<PropertyKey> = default_excluded_descriptor_keys,\n): void {\n  if (typeof source !== \"object\" && typeof source !== \"function\") {\n    return;\n  }\n\n  if (source === null) {\n    return;\n  }\n\n  for (const key of Reflect.ownKeys(source)) {\n    if (default_excluded_descriptor_keys.has(key) || exclude.has(key)) {\n      continue;\n    }\n\n    const descriptor = Object.getOwnPropertyDescriptor(source, key);\n\n    if (!descriptor) {\n      continue;\n    }\n\n    Object.defineProperty(target, key, descriptor);\n  }\n}\n"],"mappings":";AAAA,MAAM,mCAAmC,IAAI,IAAiB;CAC5D;CACA;CACA;CACD,CAAC;;;;;;;;;;;;;;;;;AAkBF,SAAgB,0BACd,QACA,QACA,UAAoC,kCAC9B;AACN,KAAI,OAAO,WAAW,YAAY,OAAO,WAAW,WAClD;AAGF,KAAI,WAAW,KACb;AAGF,MAAK,MAAM,OAAO,QAAQ,QAAQ,OAAO,EAAE;AACzC,MAAI,iCAAiC,IAAI,IAAI,IAAI,QAAQ,IAAI,IAAI,CAC/D;EAGF,MAAM,aAAa,OAAO,yBAAyB,QAAQ,IAAI;AAE/D,MAAI,CAAC,WACH;AAGF,SAAO,eAAe,QAAQ,KAAK,WAAW"}

package/.dist/chunks/dispatcher-BSg2-ttN.js

@@ -0,0 +1,339 @@
+import { Cause, Effect, Exit, Fiber, Layer, ManagedRuntime } from "effect";
+//#region src/dispatcher/fibers.ts
+/**
+* Interrupts a dispatcher fiber through its managed runtime.
+*
+* @example
+* ```ts
+* interrupt_fiber(runtime, fiber);
+* ```
+*
+* @since 2.0.0
+* @param runtime - Managed runtime that owns the fiber.
+* @param fiber - Fiber to interrupt.
+* @returns Nothing.
+* @internal
+*/
+function interrupt_fiber(runtime, fiber) {
+	runtime.runFork(Fiber.interrupt(fiber));
+}
+/**
+* Watches a dispatcher fiber, runs completion callbacks, and surfaces
+* non-interrupt failures on the microtask queue.
+*
+* @example
+* ```ts
+* watch_fiber_exit({ runtime, fiber, on_complete: cleanup });
+* ```
+*
+* @since 2.0.0
+* @param options - Runtime, fiber, and callbacks used for the watcher.
+* @returns Nothing.
+* @internal
+*/
+function watch_fiber_exit(options) {
+	const { runtime, fiber, on_complete, on_success } = options;
+	runtime.runFork(Effect.flatMap(Fiber.await(fiber), (exit) => Effect.sync(() => {
+		on_complete?.();
+		if (Exit.isSuccess(exit)) {
+			on_success?.(exit.value);
+			return;
+		}
+		if (!Cause.hasInterruptsOnly(exit.cause)) queueMicrotask(() => {
+			throw Cause.squash(exit.cause);
+		});
+	})));
+}
+//#endregion
+//#region src/dispatcher/deps.ts
+const object_dep_ids = /* @__PURE__ */ new WeakMap();
+const symbol_dep_ids = /* @__PURE__ */ new Map();
+let next_object_dep_id = 0;
+let next_symbol_dep_id = 0;
+/**
+* Builds a deterministic cache key from a dependency array.
+*
+* @example
+* ```ts
+* const key = hash_deps([user_id, filters]);
+* ```
+*
+* @since 2.0.0
+* @param deps - Dependency array to encode for cache lookup.
+* @returns A structured string key suitable for Map lookups.
+* @internal
+*/
+function hash_deps(deps) {
+	const parts = deps.map((dep) => {
+		if (dep === null) return "l:null";
+		if (dep === void 0) return "u:undefined";
+		const type = typeof dep;
+		if (type === "string") return ["s", dep];
+		if (type === "number") return `n:${Object.is(dep, -0) ? "-0" : String(dep)}`;
+		if (type === "bigint") return `b:${dep}`;
+		if (type === "boolean") return dep ? "t:true" : "f:false";
+		if (type === "symbol") return hash_symbol_dep(dep);
+		return hash_object_dep(dep);
+	});
+	return JSON.stringify(parts);
+}
+function hash_symbol_dep(dep) {
+	let id = symbol_dep_ids.get(dep);
+	if (id === void 0) {
+		next_symbol_dep_id += 1;
+		id = next_symbol_dep_id;
+		symbol_dep_ids.set(dep, id);
+	}
+	return `y:${id}`;
+}
+function hash_object_dep(dep) {
+	let id = object_dep_ids.get(dep);
+	if (id === void 0) {
+		next_object_dep_id += 1;
+		id = next_object_dep_id;
+		object_dep_ids.set(dep, id);
+	}
+	return `o:${id}`;
+}
+//#endregion
+//#region src/dispatcher/index.ts
+/**
+* Unified effect block dispatcher. Manages the fiber lifecycle of every
+* effect block and wires results into reactive channels.
+*
+* @example
+* ```ts
+* const dispatcher = new Dispatcher();
+* const cancel = dispatcher.fork(Effect.log("running"));
+* cancel();
+* ```
+*
+* @since 2.0.0
+* @internal
+*/
+var Dispatcher = class Dispatcher {
+	/** The underlying Effect runtime that executes forked programs. */
+	#runtime;
+	/** Active fibers keyed by cache id or generated fork id. */
+	#fibers = /* @__PURE__ */ new Map();
+	/** Resolved values and pending promises keyed by cache id. */
+	#values = /* @__PURE__ */ new Map();
+	/** Current cache key per value block id. */
+	#value_ids = /* @__PURE__ */ new Map();
+	/** Whether dispose has been called, blocking new work. */
+	#disposed = false;
+	/** Monotonically increasing counter for unnamed fiber keys. */
+	#next_fiber_id = 0;
+	/**
+	* Creates a dispatcher with an optional layer and installs it as the global
+	* singleton returned by {@link get_dispatcher}.
+	*
+	* @example
+	* ```ts
+	* const dispatcher = Dispatcher.make(Db.Live);
+	* ```
+	*
+	* @since 2.0.0
+	* @param layer - Optional Effect layer to provide to the runtime.
+	* @returns The newly created dispatcher.
+	*/
+	static make(layer) {
+		const dispatcher = new Dispatcher(ManagedRuntime.make(layer ?? Layer.empty));
+		current_dispatcher = dispatcher;
+		return dispatcher;
+	}
+	/**
+	* Creates a dispatcher backed by the provided managed runtime.
+	*
+	* @example
+	* ```ts
+	* const dispatcher = new Dispatcher(runtime);
+	* ```
+	*
+	* @since 2.0.0
+	* @param runtime - Managed runtime to use, or an empty-layer runtime when
+	*   omitted.
+	*/
+	constructor(runtime) {
+		this.#runtime = runtime ?? ManagedRuntime.make(Layer.empty);
+	}
+	/**
+	* Forks an effect as a managed fiber and returns a cleanup function.
+	*
+	* @example
+	* ```ts
+	* const dispose = dispatcher.fork(Effect.log("clicked"));
+	* ```
+	*
+	* @since 2.0.0
+	* @param effect - Effect to fork.
+	* @returns A function that interrupts the fiber.
+	*/
+	fork(effect) {
+		if (this.#disposed) return () => {};
+		const fiber = this.#runtime.runFork(effect);
+		const key = `fork:${this.#next_fiber_id}`;
+		this.#next_fiber_id += 1;
+		this.#fibers.set(key, fiber);
+		watch_fiber_exit({
+			runtime: this.#runtime,
+			fiber,
+			on_complete: () => this.#fibers.delete(key)
+		});
+		let disposed = false;
+		return () => {
+			if (disposed) return;
+			disposed = true;
+			interrupt_fiber(this.#runtime, fiber);
+		};
+	}
+	/**
+	* Forks an effect and exposes its result as a cached reactive value.
+	*
+	* @example
+	* ```ts
+	* const user = dispatcher.value({ id, deps, fallback, factory });
+	* ```
+	*
+	* @since 2.0.0
+	* @param options - Value id, dependency array, fallback, and effect factory.
+	* @returns The cached value if resolved, otherwise the fallback.
+	*/
+	value(options) {
+		const cache_key = `${options.id}::${hash_deps(options.deps)}`;
+		const old_key = this.#value_ids.get(options.id);
+		if (old_key !== void 0 && old_key !== cache_key) this.#interrupt_cached_fiber(old_key);
+		this.#value_ids.set(options.id, cache_key);
+		if (this.#should_start_value_fiber(cache_key)) this.#start_value_fiber(cache_key, options);
+		if (this.#values.has(cache_key)) return this.#values.get(cache_key);
+		return options.fallback;
+	}
+	/**
+	* Forks an effect and exposes its completion as a cached promise.
+	*
+	* @example
+	* ```ts
+	* const promise = dispatcher.promise({ id, deps, factory });
+	* ```
+	*
+	* @since 2.0.0
+	* @param options - Promise id, dependency array, and effect factory.
+	* @returns A promise that resolves with the effect result.
+	*/
+	promise(options) {
+		if (this.#disposed) return Promise.reject(/* @__PURE__ */ new Error("Dispatcher has been disposed"));
+		const cache_key = `promise:${options.id}::${hash_deps(options.deps)}`;
+		const existing = this.#values.get(cache_key);
+		if (existing instanceof Promise) return existing;
+		const program = Effect.gen(function* () {
+			return yield* Effect.gen(options.factory);
+		});
+		const promise = this.#runtime.runPromise(program).then((value) => {
+			this.#values.delete(cache_key);
+			return value;
+		}).catch((error) => {
+			this.#values.delete(cache_key);
+			throw error;
+		});
+		this.#values.set(cache_key, promise);
+		return promise;
+	}
+	/**
+	* Runs an event-handler effect and surfaces failures to Svelte.
+	*
+	* @example
+	* ```ts
+	* await dispatcher.run(Effect.log("submit"));
+	* ```
+	*
+	* @since 2.0.0
+	* @param effect - Effect to execute.
+	* @returns A promise that resolves or rejects when the effect completes.
+	*/
+	run(effect) {
+		if (this.#disposed) return Promise.reject(/* @__PURE__ */ new Error("Dispatcher has been disposed"));
+		return this.#runtime.runPromise(effect).catch((error) => {
+			queueMicrotask(() => {
+				throw error;
+			});
+			throw error;
+		});
+	}
+	/**
+	* Cancels all running fibers and releases cached values.
+	*
+	* @example
+	* ```ts
+	* dispatcher.dispose();
+	* ```
+	*
+	* @since 2.0.0
+	* @returns Nothing.
+	*/
+	dispose() {
+		this.#disposed = true;
+		for (const fiber of this.#fibers.values()) interrupt_fiber(this.#runtime, fiber);
+		this.#fibers.clear();
+		this.#values.clear();
+		this.#value_ids.clear();
+	}
+	#interrupt_cached_fiber(cache_key) {
+		const old_fiber = this.#fibers.get(cache_key);
+		if (!old_fiber) return;
+		interrupt_fiber(this.#runtime, old_fiber);
+		this.#fibers.delete(cache_key);
+	}
+	#should_start_value_fiber(cache_key) {
+		return !this.#disposed && !this.#fibers.has(cache_key) && !this.#values.has(cache_key);
+	}
+	#start_value_fiber(cache_key, options) {
+		const program = Effect.gen(function* () {
+			return yield* Effect.gen(options.factory);
+		});
+		const fiber = this.#runtime.runFork(program);
+		this.#fibers.set(cache_key, fiber);
+		watch_fiber_exit({
+			runtime: this.#runtime,
+			fiber,
+			on_complete: () => this.#fibers.delete(cache_key),
+			on_success: (value) => this.#values.set(cache_key, value)
+		});
+	}
+};
+let current_dispatcher = null;
+/**
+* Resolves the active dispatcher, creating a default one if necessary.
+*
+* @example
+* ```ts
+* const dispatcher = get_dispatcher();
+* ```
+*
+* @since 2.0.0
+* @returns The active dispatcher singleton.
+* @internal
+*/
+function get_dispatcher() {
+	current_dispatcher ??= new Dispatcher();
+	return current_dispatcher;
+}
+/**
+* Resets the internal singleton dispatcher used by source-level tests.
+*
+* @example
+* ```ts
+* reset_dispatcher();
+* ```
+*
+* @since 2.0.0
+* @returns Nothing.
+* @internal
+*/
+function reset_dispatcher() {
+	current_dispatcher?.dispose();
+	current_dispatcher = null;
+}
+//#endregion
+export { get_dispatcher as n, reset_dispatcher as r, Dispatcher as t };
+
+//# sourceMappingURL=dispatcher-BSg2-ttN.js.map

package/.dist/chunks/dispatcher-BSg2-ttN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-BSg2-ttN.js","names":["#runtime","#disposed","#next_fiber_id","#fibers","#value_ids","#interrupt_cached_fiber","#should_start_value_fiber","#start_value_fiber","#values"],"sources":["../../../modules/svelte-effect-runtime/src/dispatcher/fibers.ts","../../../modules/svelte-effect-runtime/src/dispatcher/deps.ts","../../../modules/svelte-effect-runtime/src/dispatcher/index.ts"],"sourcesContent":["import { Cause, Effect, Exit, Fiber } from \"effect\";\nimport type { Fiber as FiberType } from \"effect/Fiber\";\nimport type { ManagedRuntime as ManagedRuntimeType } from \"effect/ManagedRuntime\";\n\n/**\n * Callbacks fired when a watched dispatcher fiber completes.\n *\n * @example\n * ```ts\n * const callbacks: FiberWatchCallbacks<number> = {\n *   on_success: (value) => cache.set(key, value),\n * };\n * ```\n *\n * @since 2.0.0\n * @internal\n */\nexport interface FiberWatchCallbacks<A> {\n  on_complete?: () => void;\n  on_success?: (value: A) => void;\n}\n\n/**\n * Interrupts a dispatcher fiber through its managed runtime.\n *\n * @example\n * ```ts\n * interrupt_fiber(runtime, fiber);\n * ```\n *\n * @since 2.0.0\n * @param runtime - Managed runtime that owns the fiber.\n * @param fiber - Fiber to interrupt.\n * @returns Nothing.\n * @internal\n */\nexport function interrupt_fiber(\n  runtime: ManagedRuntimeType<unknown, unknown>,\n  fiber: FiberType<unknown, unknown>,\n): void {\n  runtime.runFork(\n    Fiber.interrupt(fiber) as Effect.Effect<unknown, unknown, unknown>,\n  );\n}\n\n/**\n * Watches a dispatcher fiber, runs completion callbacks, and surfaces\n * non-interrupt failures on the microtask queue.\n *\n * @example\n * ```ts\n * watch_fiber_exit({ runtime, fiber, on_complete: cleanup });\n * ```\n *\n * @since 2.0.0\n * @param options - Runtime, fiber, and callbacks used for the watcher.\n * @returns Nothing.\n * @internal\n */\nexport function watch_fiber_exit<A>(\n  options: {\n    runtime: ManagedRuntimeType<unknown, unknown>;\n    fiber: FiberType<unknown, unknown>;\n  } & FiberWatchCallbacks<A>,\n): void {\n  const { runtime, fiber, on_complete, on_success } = options;\n\n  runtime.runFork(\n    Effect.flatMap(Fiber.await(fiber), (exit) =>\n      Effect.sync(() => {\n        on_complete?.();\n\n        if (Exit.isSuccess(exit)) {\n          on_success?.(exit.value as A);\n\n          return;\n        }\n\n        if (!Cause.hasInterruptsOnly(exit.cause)) {\n          queueMicrotask(() => {\n            throw Cause.squash(exit.cause);\n          });\n        }\n      })),\n  );\n}\n","const object_dep_ids = new WeakMap<object, number>();\nconst symbol_dep_ids = new Map<symbol, number>();\n\nlet next_object_dep_id = 0;\nlet next_symbol_dep_id = 0;\n\n/**\n * Builds a deterministic cache key from a dependency array.\n *\n * @example\n * ```ts\n * const key = hash_deps([user_id, filters]);\n * ```\n *\n * @since 2.0.0\n * @param deps - Dependency array to encode for cache lookup.\n * @returns A structured string key suitable for Map lookups.\n * @internal\n */\nexport function hash_deps(deps: readonly unknown[]): string {\n  const parts = deps.map((dep) => {\n    if (dep === null) {\n      return \"l:null\";\n    }\n\n    if (dep === undefined) {\n      return \"u:undefined\";\n    }\n\n    const type = typeof dep;\n\n    if (type === \"string\") {\n      return [\"s\", dep];\n    }\n\n    if (type === \"number\") {\n      return `n:${Object.is(dep, -0) ? \"-0\" : String(dep)}`;\n    }\n\n    if (type === \"bigint\") {\n      return `b:${dep}`;\n    }\n\n    if (type === \"boolean\") {\n      return dep ? \"t:true\" : \"f:false\";\n    }\n\n    if (type === \"symbol\") {\n      return hash_symbol_dep(dep as symbol);\n    }\n\n    return hash_object_dep(dep as object);\n  });\n\n  return JSON.stringify(parts);\n}\n\nfunction hash_symbol_dep(dep: symbol): string {\n  let id = symbol_dep_ids.get(dep);\n\n  if (id === undefined) {\n    next_symbol_dep_id += 1;\n    id = next_symbol_dep_id;\n    symbol_dep_ids.set(dep, id);\n  }\n\n  return `y:${id}`;\n}\n\nfunction hash_object_dep(dep: object): string {\n  let id = object_dep_ids.get(dep);\n\n  if (id === undefined) {\n    next_object_dep_id += 1;\n    id = next_object_dep_id;\n    object_dep_ids.set(dep, id);\n  }\n\n  return `o:${id}`;\n}\n","import { Effect, Layer, ManagedRuntime } from \"effect\";\nimport type { Fiber as FiberType } from \"effect/Fiber\";\nimport type { ManagedRuntime as ManagedRuntimeType } from \"effect/ManagedRuntime\";\n\nimport { interrupt_fiber, watch_fiber_exit } from \"./fibers.ts\";\nimport { hash_deps } from \"./deps.ts\";\nimport type { Dispose, PromiseOptions, ValueOptions } from \"./types.ts\";\n\nexport type { Dispose, PromiseOptions, ValueOptions } from \"./types.ts\";\n\n/**\n * Unified effect block dispatcher. Manages the fiber lifecycle of every\n * effect block and wires results into reactive channels.\n *\n * @example\n * ```ts\n * const dispatcher = new Dispatcher();\n * const cancel = dispatcher.fork(Effect.log(\"running\"));\n * cancel();\n * ```\n *\n * @since 2.0.0\n * @internal\n */\nexport class Dispatcher {\n  /** The underlying Effect runtime that executes forked programs. */\n  #runtime: ManagedRuntimeType<unknown, unknown>;\n  /** Active fibers keyed by cache id or generated fork id. */\n  #fibers = new Map<string, FiberType<unknown, unknown>>();\n  /** Resolved values and pending promises keyed by cache id. */\n  #values = new Map<string, unknown>();\n  /** Current cache key per value block id. */\n  #value_ids = new Map<string, string>();\n  /** Whether dispose has been called, blocking new work. */\n  #disposed = false;\n  /** Monotonically increasing counter for unnamed fiber keys. */\n  #next_fiber_id = 0;\n\n  /**\n   * Creates a dispatcher with an optional layer and installs it as the global\n   * singleton returned by {@link get_dispatcher}.\n   *\n   * @example\n   * ```ts\n   * const dispatcher = Dispatcher.make(Db.Live);\n   * ```\n   *\n   * @since 2.0.0\n   * @param layer - Optional Effect layer to provide to the runtime.\n   * @returns The newly created dispatcher.\n   */\n  static make<R = never>(\n    layer?: Layer.Layer<R>,\n  ): Dispatcher {\n    const runtime = ManagedRuntime.make(\n      layer ?? (Layer.empty as unknown as Layer.Layer<R>),\n    );\n\n    const dispatcher = new Dispatcher(\n      runtime as ManagedRuntimeType<unknown, unknown>,\n    );\n    current_dispatcher = dispatcher;\n\n    return dispatcher;\n  }\n\n  /**\n   * Creates a dispatcher backed by the provided managed runtime.\n   *\n   * @example\n   * ```ts\n   * const dispatcher = new Dispatcher(runtime);\n   * ```\n   *\n   * @since 2.0.0\n   * @param runtime - Managed runtime to use, or an empty-layer runtime when\n   *   omitted.\n   */\n  constructor(runtime?: ManagedRuntimeType<unknown, unknown>) {\n    this.#runtime = runtime ??\n      ManagedRuntime.make(Layer.empty) as unknown as ManagedRuntimeType<\n        unknown,\n        unknown\n      >;\n  }\n\n  /**\n   * Forks an effect as a managed fiber and returns a cleanup function.\n   *\n   * @example\n   * ```ts\n   * const dispose = dispatcher.fork(Effect.log(\"clicked\"));\n   * ```\n   *\n   * @since 2.0.0\n   * @param effect - Effect to fork.\n   * @returns A function that interrupts the fiber.\n   */\n  fork<A, E, R>(effect: Effect.Effect<A, E, R>): Dispose {\n    if (this.#disposed) {\n      return () => {};\n    }\n\n    const fiber = this.#runtime.runFork(\n      effect as Effect.Effect<unknown, unknown, unknown>,\n    );\n    const key = `fork:${this.#next_fiber_id}`;\n\n    this.#next_fiber_id += 1;\n    this.#fibers.set(key, fiber);\n    watch_fiber_exit({\n      runtime: this.#runtime,\n      fiber,\n      on_complete: () => this.#fibers.delete(key),\n    });\n\n    let disposed = false;\n\n    return (): void => {\n      if (disposed) {\n        return;\n      }\n\n      disposed = true;\n      interrupt_fiber(this.#runtime, fiber);\n    };\n  }\n\n  /**\n   * Forks an effect and exposes its result as a cached reactive value.\n   *\n   * @example\n   * ```ts\n   * const user = dispatcher.value({ id, deps, fallback, factory });\n   * ```\n   *\n   * @since 2.0.0\n   * @param options - Value id, dependency array, fallback, and effect factory.\n   * @returns The cached value if resolved, otherwise the fallback.\n   */\n  value<A>(options: ValueOptions<A>): A {\n    const cache_key = `${options.id}::${hash_deps(options.deps)}`;\n    const old_key = this.#value_ids.get(options.id);\n\n    if (old_key !== undefined && old_key !== cache_key) {\n      this.#interrupt_cached_fiber(old_key);\n    }\n\n    this.#value_ids.set(options.id, cache_key);\n\n    if (this.#should_start_value_fiber(cache_key)) {\n      this.#start_value_fiber(cache_key, options);\n    }\n\n    if (this.#values.has(cache_key)) {\n      return this.#values.get(cache_key) as A;\n    }\n\n    return options.fallback;\n  }\n\n  /**\n   * Forks an effect and exposes its completion as a cached promise.\n   *\n   * @example\n   * ```ts\n   * const promise = dispatcher.promise({ id, deps, factory });\n   * ```\n   *\n   * @since 2.0.0\n   * @param options - Promise id, dependency array, and effect factory.\n   * @returns A promise that resolves with the effect result.\n   */\n  promise<A>(options: PromiseOptions<A>): Promise<A> {\n    if (this.#disposed) {\n      return Promise.reject(new Error(\"Dispatcher has been disposed\"));\n    }\n\n    const cache_key = `promise:${options.id}::${hash_deps(options.deps)}`;\n    const existing = this.#values.get(cache_key);\n\n    if (existing instanceof Promise) {\n      return existing as Promise<A>;\n    }\n\n    const program = Effect.gen(function* () {\n      const result = yield* Effect.gen(options.factory);\n\n      return result;\n    });\n    const promise = this.#runtime\n      .runPromise(program as Effect.Effect<unknown, unknown, unknown>)\n      .then((value) => {\n        this.#values.delete(cache_key);\n\n        return value;\n      })\n      .catch((error: unknown) => {\n        this.#values.delete(cache_key);\n\n        throw error;\n      }) as Promise<A>;\n\n    this.#values.set(cache_key, promise);\n\n    return promise;\n  }\n\n  /**\n   * Runs an event-handler effect and surfaces failures to Svelte.\n   *\n   * @example\n   * ```ts\n   * await dispatcher.run(Effect.log(\"submit\"));\n   * ```\n   *\n   * @since 2.0.0\n   * @param effect - Effect to execute.\n   * @returns A promise that resolves or rejects when the effect completes.\n   */\n  run<A, E, R>(effect: Effect.Effect<A, E, R>): Promise<A> {\n    if (this.#disposed) {\n      return Promise.reject(new Error(\"Dispatcher has been disposed\"));\n    }\n\n    return this.#runtime\n      .runPromise(effect as Effect.Effect<unknown, unknown, unknown>)\n      .catch((error: unknown) => {\n        queueMicrotask(() => {\n          throw error;\n        });\n\n        throw error;\n      }) as Promise<A>;\n  }\n\n  /**\n   * Cancels all running fibers and releases cached values.\n   *\n   * @example\n   * ```ts\n   * dispatcher.dispose();\n   * ```\n   *\n   * @since 2.0.0\n   * @returns Nothing.\n   */\n  dispose(): void {\n    this.#disposed = true;\n\n    for (const fiber of this.#fibers.values()) {\n      interrupt_fiber(this.#runtime, fiber);\n    }\n\n    this.#fibers.clear();\n    this.#values.clear();\n    this.#value_ids.clear();\n  }\n\n  #interrupt_cached_fiber(cache_key: string): void {\n    const old_fiber = this.#fibers.get(cache_key);\n\n    if (!old_fiber) {\n      return;\n    }\n\n    interrupt_fiber(this.#runtime, old_fiber);\n    this.#fibers.delete(cache_key);\n  }\n\n  #should_start_value_fiber(cache_key: string): boolean {\n    return (\n      !this.#disposed &&\n      !this.#fibers.has(cache_key) &&\n      !this.#values.has(cache_key)\n    );\n  }\n\n  #start_value_fiber<A>(cache_key: string, options: ValueOptions<A>): void {\n    const program = Effect.gen(function* () {\n      const result = yield* Effect.gen(options.factory);\n\n      return result;\n    });\n    const fiber = this.#runtime.runFork(\n      program as Effect.Effect<unknown, unknown, unknown>,\n    );\n\n    this.#fibers.set(cache_key, fiber);\n    watch_fiber_exit({\n      runtime: this.#runtime,\n      fiber,\n      on_complete: () => this.#fibers.delete(cache_key),\n      on_success: (value) => this.#values.set(cache_key, value),\n    });\n  }\n}\n\nlet current_dispatcher: Dispatcher | null = null;\n\n/**\n * Resolves the active dispatcher, creating a default one if necessary.\n *\n * @example\n * ```ts\n * const dispatcher = get_dispatcher();\n * ```\n *\n * @since 2.0.0\n * @returns The active dispatcher singleton.\n * @internal\n */\nexport function get_dispatcher(): Dispatcher {\n  current_dispatcher ??= new Dispatcher();\n\n  return current_dispatcher;\n}\n\n/**\n * Resets the internal singleton dispatcher used by source-level tests.\n *\n * @example\n * ```ts\n * reset_dispatcher();\n * ```\n *\n * @since 2.0.0\n * @returns Nothing.\n * @internal\n */\nexport function reset_dispatcher(): void {\n  current_dispatcher?.dispose();\n  current_dispatcher = null;\n}\n"],"mappings":"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"}