svelte-effect-runtime 3.0.1 → 3.1.0

package/.dist/errors.d.ts

@@ -0,0 +1,544 @@
+/**
+ * Base class for runtime-authored errors. The class gives every local failure
+ * a stable JavaScript error name while preserving the technical message that
+ * reaches Vite, SvelteKit, and test output.
+ *
+ * @example
+ * ```ts
+ * throw new RuntimeError("Invariant violated.");
+ * ```
+ *
+ * @since 2.4.0
+ * @param message - Technical diagnostic message describing the failed runtime
+ *   invariant.
+ * @returns A runtime-authored Error instance.
+ */
+export declare class RuntimeError extends Error {
+    constructor(message: string);
+}
+/**
+ * Formats a runtime-owned error message with a stable screaming-case code.
+ *
+ * @example
+ * ```ts
+ * throw new Error(make_error_message("DISPATCHER_DISPOSED", "Dispatcher has been disposed"));
+ * ```
+ *
+ * @since 2.0.0
+ * @param code - Stable screaming-case identifier for the error category.
+ * @param message - Human-readable error message without the leading code.
+ * @returns The complete error message prefixed with the stable code.
+ */
+export declare function make_error_message(code: string, message: string): string;
+/**
+ * Base error class for all preprocessor errors emitted during script and
+ * markup transformation. Carries the source filename so error messages can
+ * reference the affected file.
+ *
+ * @example
+ * ```ts
+ * throw new PreprocessError("Component.svelte: invalid transform input.", "Component.svelte");
+ * ```
+ *
+ * @since 2.0.0
+ * @param message - Technical diagnostic message for the transform failure.
+ * @param filename - Source filename that triggered the transform failure.
+ * @returns A preprocessor Error instance with source file context.
+ */
+export declare class PreprocessError extends RuntimeError {
+    /**
+     * The source filename that triggered this error.
+     *
+     * @since 2.0.0
+     */
+    readonly filename: string;
+    constructor(message: string, filename: string);
+}
+/**
+ * Thrown when a statement mixes JavaScript `await` with Effect `yield*` work
+ * that must be lowered into an `Effect.gen` program.
+ *
+ * @example
+ * ```ts
+ * throw new AwaitInEffectWorkError("Component.svelte", "const value = await load();");
+ * ```
+ *
+ * @since 2.0.0
+ * @param filename - Source filename containing the unsupported statement.
+ * @param statement_text - Full source text for the statement containing
+ *   mixed async work.
+ * @returns A preprocessor Error instance with statement context.
+ */
+export declare class AwaitInEffectWorkError extends PreprocessError {
+    /**
+     * The full text of the problematic statement containing mixed async work.
+     *
+     * @since 2.0.0
+     */
+    readonly statement_text: string;
+    constructor(filename: string, statement_text: string);
+}
+/**
+ * Thrown when async Effect work appears inside a Svelte rune position that
+ * must stay synchronous.
+ *
+ * @example
+ * ```ts
+ * throw new AsyncEffectInSyncRuneError("$derived", "$derived(yield* load())", "Component.svelte");
+ * ```
+ *
+ * @since 2.0.0
+ * @param rune_name - Name of the Svelte rune containing the unsupported async
+ *   Effect work.
+ * @param expression_text - Full source text for the rune expression.
+ * @param filename - Source filename containing the unsupported rune.
+ * @returns A preprocessor Error instance with rune source context.
+ */
+export declare class AsyncEffectInSyncRuneError extends PreprocessError {
+    /**
+     * The name of the rune that contained async Effect work.
+     *
+     * @since 2.0.0
+     */
+    readonly rune_name: string;
+    /**
+     * The full text of the expression that triggered the error.
+     *
+     * @since 2.0.0
+     */
+    readonly expression_text: string;
+    constructor(rune_name: string, expression_text: string, filename: string);
+}
+/**
+ * Thrown when async Effect work appears inside a non-generator callback nested
+ * in a markup event handler.
+ *
+ * @example
+ * ```ts
+ * throw new AsyncEffectInEventCallbackError(
+ *   "Component.svelte",
+ *   "Effect.try(() => yield* save())",
+ * );
+ * ```
+ *
+ * @since 2.0.0
+ * @param filename - Source filename containing the invalid event handler.
+ * @param expression_text - Event handler expression that contains the nested
+ *   unsupported async Effect work.
+ * @returns A preprocessor Error instance with event expression context.
+ */
+export declare class AsyncEffectInEventCallbackError extends PreprocessError {
+    /**
+     * The full text of the problematic event handler body.
+     *
+     * @since 2.0.0
+     */
+    readonly expression_text: string;
+    constructor(filename: string, expression_text: string);
+}
+/**
+ * Thrown when an event handler callback contains the old raw `yield*`
+ * shorthand. Effectful event handlers must put `yield*` directly in the event
+ * attribute so the callback boundary is generated by the markup runtime.
+ *
+ * @example
+ * ```ts
+ * throw new YieldStarInEventCallbackError("Component.svelte", "() => yield* save()");
+ * ```
+ *
+ * @since 2.0.0
+ * @param filename - Svelte component filename used to identify where the
+ *   invalid event handler callback was found.
+ * @param expression_text - Original event handler callback text that contained
+ *   `yield*` and should be rewritten as a direct event Effect expression.
+ * @returns A preprocessor Error instance with event callback context.
+ */
+export declare class YieldStarInEventCallbackError extends PreprocessError {
+    /**
+     * The full text of the problematic event handler callback.
+     *
+     * @since 2.0.0
+     */
+    readonly expression_text: string;
+    constructor(filename: string, expression_text: string);
+}
+/**
+ * Thrown when async Effect work appears in a markup position SER cannot lower
+ * safely.
+ *
+ * @example
+ * ```ts
+ * throw new UnsupportedMarkupEffectPositionError(
+ *   "Component.svelte",
+ *   "value={yield* load()}",
+ * );
+ * ```
+ *
+ * @since 2.4.2
+ * @param filename - Source filename containing the unsupported markup.
+ * @param expression_text - The unsupported markup expression text.
+ * @returns A preprocessor Error instance with markup source context.
+ */
+export declare class UnsupportedMarkupEffectPositionError extends PreprocessError {
+    /**
+     * The unsupported markup expression text.
+     *
+     * @since 2.4.2
+     */
+    readonly expression_text: string;
+    constructor(filename: string, expression_text: string);
+}
+/**
+ * Thrown when the request-scoped SvelteKit event context is read outside a
+ * remote handler.
+ *
+ * @example
+ * ```ts
+ * throw new RequestEventUnavailableError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing missing request context.
+ */
+export declare class RequestEventUnavailableError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when an unchecked Query declaration omits the handler.
+ *
+ * @example
+ * ```ts
+ * throw new UncheckedQueryHandlerMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the invalid Query overload usage.
+ */
+export declare class UncheckedQueryHandlerMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a batch Query declaration omits the batch handler.
+ *
+ * @example
+ * ```ts
+ * throw new BatchQueryHandlerMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the invalid batch Query overload usage.
+ */
+export declare class BatchQueryHandlerMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when an unchecked live Query declaration omits the handler.
+ *
+ * @example
+ * ```ts
+ * throw new UncheckedLiveQueryHandlerMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the invalid live Query overload usage.
+ */
+export declare class UncheckedLiveQueryHandlerMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when an unchecked Command declaration omits the handler.
+ *
+ * @example
+ * ```ts
+ * throw new UncheckedCommandHandlerMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the invalid Command overload usage.
+ */
+export declare class UncheckedCommandHandlerMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when an unchecked Form declaration omits the handler.
+ *
+ * @example
+ * ```ts
+ * throw new UncheckedFormHandlerMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the invalid Form overload usage.
+ */
+export declare class UncheckedFormHandlerMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when an unchecked Prerender declaration omits the handler.
+ *
+ * @example
+ * ```ts
+ * throw new UncheckedPrerenderHandlerMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the invalid Prerender overload usage.
+ */
+export declare class UncheckedPrerenderHandlerMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a live query handler resolves to a value that cannot be streamed.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidLiveQueryReturnError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the expected live query return protocol.
+ */
+export declare class InvalidLiveQueryReturnError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a dispatcher operation is requested after disposal.
+ *
+ * @example
+ * ```ts
+ * throw new DispatcherDisposedError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing an invalid dispatcher lifecycle transition.
+ */
+export declare class DispatcherDisposedError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a generated or native remote query export is not callable.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidQueryFactoryError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing an invalid query adapter input.
+ */
+export declare class InvalidQueryFactoryError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a generated or native remote live query export is not callable.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidLiveQueryFactoryError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing an invalid live query adapter input.
+ */
+export declare class InvalidLiveQueryFactoryError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a generated or native remote command export is not callable.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidCommandFactoryError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing an invalid command adapter input.
+ */
+export declare class InvalidCommandFactoryError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when the client-side form adapter cannot derive a remote endpoint.
+ *
+ * @example
+ * ```ts
+ * throw new RemoteFormEndpointMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing missing form transport metadata.
+ */
+export declare class RemoteFormEndpointMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a remote form response envelope is not an object with a response
+ * type.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidRemoteFormResponseError(envelope);
+ * ```
+ *
+ * @since 2.4.0
+ * @param envelope - Raw response envelope returned by the remote form endpoint.
+ * @returns An Error describing malformed form response data.
+ */
+export declare class InvalidRemoteFormResponseError extends RuntimeError {
+    /**
+     * Raw response envelope returned by the remote form endpoint.
+     *
+     * @since 2.4.0
+     */
+    readonly envelope: unknown;
+    constructor(envelope?: unknown);
+}
+/**
+ * Thrown when a remote form response has a well-formed envelope but an
+ * unsupported response type or payload slot.
+ *
+ * @example
+ * ```ts
+ * throw new UnsupportedRemoteFormResponseError(envelope);
+ * ```
+ *
+ * @since 2.4.0
+ * @param envelope - Raw response envelope returned by the remote form endpoint.
+ * @returns An Error describing unsupported form response data.
+ */
+export declare class UnsupportedRemoteFormResponseError extends RuntimeError {
+    /**
+     * Raw response envelope returned by the remote form endpoint.
+     *
+     * @since 2.4.0
+     */
+    readonly envelope: unknown;
+    constructor(envelope?: unknown);
+}
+/**
+ * Thrown when a serialized remote failure envelope cannot be decoded.
+ *
+ * @example
+ * ```ts
+ * throw new RemoteErrorDecodeError(raw);
+ * ```
+ *
+ * @since 2.4.0
+ * @param raw - Raw serialized remote failure payload that failed decoding.
+ * @returns An Error describing a malformed remote failure payload.
+ */
+export declare class RemoteErrorDecodeError extends RuntimeError {
+    /**
+     * Raw serialized remote failure payload that failed decoding.
+     *
+     * @since 2.4.0
+     */
+    readonly raw: unknown;
+    constructor(raw?: unknown);
+}
+/**
+ * Thrown when a root server-only helper is imported without Vite rewriting.
+ *
+ * @example
+ * ```ts
+ * throw new ServerOnlyImportError("Query");
+ * ```
+ *
+ * @since 2.4.0
+ * @param export_name - Name of the server-only root export that was invoked.
+ * @returns An Error describing a missing server rewrite.
+ */
+export declare class ServerOnlyImportError extends RuntimeError {
+    /**
+     * Name of the server-only root export that was invoked.
+     *
+     * @since 2.4.0
+     */
+    readonly export_name: string;
+    constructor(export_name: string);
+}
+/**
+ * Thrown when the publish-time `$app/server` shim executes outside SvelteKit.
+ *
+ * @example
+ * ```ts
+ * throw new SvelteKitServerExportUnavailableError("query");
+ * ```
+ *
+ * @since 2.4.0
+ * @param export_name - Name of the `$app/server` export that was invoked.
+ * @returns An Error describing an unavailable SvelteKit virtual module export.
+ */
+export declare class SvelteKitServerExportUnavailableError extends RuntimeError {
+    /**
+     * Name of the `$app/server` export that was invoked.
+     *
+     * @since 2.4.0
+     */
+    readonly export_name: string;
+    constructor(export_name: string);
+}
+/**
+ * Thrown when a SvelteKit remote helper reports that it was called outside the
+ * route-scoped remote module context.
+ *
+ * @example
+ * ```ts
+ * throw new RemoteHelperContextError("Query");
+ * ```
+ *
+ * @since 2.4.0
+ * @param helper_name - SER helper name that triggered the context failure.
+ * @returns An Error describing the required `.remote.ts` placement.
+ */
+export declare class RemoteHelperContextError extends RuntimeError {
+    /**
+     * SER helper name that triggered the context failure.
+     *
+     * @since 2.4.0
+     */
+    readonly helper_name: string;
+    constructor(helper_name: string);
+}
+/**
+ * Thrown when a SvelteKit remote helper normalizes a non-Error thrown value.
+ *
+ * @example
+ * ```ts
+ * throw new RemoteHelperError("raw failure");
+ * ```
+ *
+ * @since 2.4.0
+ * @param value - Non-Error value thrown while creating a remote helper.
+ * @returns An Error preserving the remote helper failure value.
+ */
+export declare class RemoteHelperError extends RuntimeError {
+    /**
+     * Non-Error value that was normalized.
+     *
+     * @since 2.4.0
+     */
+    readonly value: unknown;
+    constructor(value: unknown);
+}
+/**
+ * Thrown when a non-Error value must be normalized into an Error instance.
+ *
+ * @example
+ * ```ts
+ * throw new UnknownRuntimeError("raw failure");
+ * ```
+ *
+ * @since 2.4.0
+ * @param value - Non-Error value that needs Error normalization.
+ * @returns An Error preserving the string representation of an unknown value.
+ */
+export declare class UnknownRuntimeError extends RuntimeError {
+    /**
+     * Non-Error value that was normalized.
+     *
+     * @since 2.4.0
+     */
+    readonly value: unknown;
+    constructor(value: unknown);
+}

package/.dist/internal/generators.js

@@ -1,4 +1,4 @@
-import { t as get_dispatcher } from "../chunks/dispatcher-FCsx1Hlh.js";
+import { t as get_dispatcher } from "../chunks/dispatcher-CLSN-Cxn.js";
 import { value } from "../markup/value.js";
 import { promise } from "../markup/promise.js";
 import { run } from "../markup/run.js";

package/.dist/internal/remote-client.js

@@ -1,2 +1,2 @@
-import { i as create_remote_command_adapter, n as create_remote_query_adapter, r as create_remote_form_adapter, t as create_remote_live_query_adapter } from "../chunks/client-Cruhk6Oo.js";
+import { i as create_remote_command_adapter, n as create_remote_query_adapter, r as create_remote_form_adapter, t as create_remote_live_query_adapter } from "../chunks/client-DRjQiULJ.js";
 export { create_remote_command_adapter, create_remote_form_adapter, create_remote_live_query_adapter, create_remote_query_adapter };

package/.dist/markup/promise.d.ts

@@ -1,15 +1,29 @@
 import type { Effect } from "effect";
+/**
+ * Options for markup promise behavior during server rendering.
+ *
+ * @since 2.4.0
+ */
+interface MarkupPromiseOptions {
+    /** Keep the SSR promise pending so Svelte renders an await block fallback. */
+    ssr?: "pending";
+}
 /**
  * Runtime helper emitted by the markup transform for
  * `{#await yield* expr}` blocks. Delegates to the dispatcher's
- * promise mechanism — returns a Promise that resolves when the effect
- * completes.
+ * promise mechanism. During SSR it can return a fallback promise without
+ * starting the dispatcher.
  *
  * @since 2.0.0
  * @param id - Stable identifier generated from the expression's source
  *   position, used for cache lookups.
  * @param deps - Array of reactive dependencies.
  * @param factory - Generator function that yields the effect to run.
+ * @param ssr_fallback - Value to resolve during SSR when the helper is used
+ *   from an awaited expression outside a Svelte await block.
+ * @param options - Optional SSR behavior for contexts such as await blocks
+ *   that should render pending UI.
  * @returns A Promise that resolves with the effect's result.
  */
-export declare function promise<A, E, R>(id: string, deps: readonly unknown[], factory: () => Effect.gen.Return<A, E, R>): Promise<A>;
+export declare function promise<A, E, R>(id: string, deps: readonly unknown[], factory: () => Effect.gen.Return<A, E, R>, ssr_fallback?: A, options?: MarkupPromiseOptions): Promise<A>;
+export {};

package/.dist/markup/promise.js

@@ -1,25 +1,36 @@
-import { t as get_dispatcher } from "../chunks/dispatcher-FCsx1Hlh.js";
+import { t as get_dispatcher } from "../chunks/dispatcher-CLSN-Cxn.js";
 //#region src/markup/promise.ts
 /**
 * Runtime helper emitted by the markup transform for
 * `{#await yield* expr}` blocks. Delegates to the dispatcher's
-* promise mechanism — returns a Promise that resolves when the effect
-* completes.
+* promise mechanism. During SSR it can return a fallback promise without
+* starting the dispatcher.
 *
 * @since 2.0.0
 * @param id - Stable identifier generated from the expression's source
 *   position, used for cache lookups.
 * @param deps - Array of reactive dependencies.
 * @param factory - Generator function that yields the effect to run.
+* @param ssr_fallback - Value to resolve during SSR when the helper is used
+*   from an awaited expression outside a Svelte await block.
+* @param options - Optional SSR behavior for contexts such as await blocks
+*   that should render pending UI.
 * @returns A Promise that resolves with the effect's result.
 */
-function promise(id, deps, factory) {
+function promise(id, deps, factory, ssr_fallback, options) {
+	if (is_server_render()) {
+		if (options?.ssr === "pending") return new Promise(() => {});
+		if (arguments.length >= 4) return Promise.resolve(ssr_fallback);
+	}
 	return get_dispatcher().promise({
 		id,
 		deps,
 		factory
 	});
 }
+function is_server_render() {
+	return typeof document === "undefined";
+}
 //#endregion
 export { promise };
 

package/.dist/markup/promise.js.map

@@ -1 +1 @@
-{"version":3,"file":"promise.js","names":[],"sources":["../../../modules/svelte-effect-runtime/src/markup/promise.ts"],"sourcesContent":["import { get_dispatcher } from \"$/generated/dispatcher.ts\";\nimport type { Effect } from \"effect\";\n\n/**\n * Runtime helper emitted by the markup transform for\n * `{#await yield* expr}` blocks. Delegates to the dispatcher's\n * promise mechanism — returns a Promise that resolves when the effect\n * completes.\n *\n * @since 2.0.0\n * @param id - Stable identifier generated from the expression's source\n *   position, used for cache lookups.\n * @param deps - Array of reactive dependencies.\n * @param factory - Generator function that yields the effect to run.\n * @returns A Promise that resolves with the effect's result.\n */\nexport function promise<A, E, R>(\n  id: string,\n  deps: readonly unknown[],\n  factory: () => Effect.gen.Return<A, E, R>,\n): Promise<A> {\n  return get_dispatcher().promise({ id, deps, factory });\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,QACd,IACA,MACA,SACY;CACZ,OAAO,eAAe,EAAE,QAAQ;EAAE;EAAI;EAAM;CAAQ,CAAC;AACvD"}
+{"version":3,"file":"promise.js","names":[],"sources":["../../../modules/svelte-effect-runtime/src/markup/promise.ts"],"sourcesContent":["import { get_dispatcher } from \"$/generated/dispatcher.ts\";\nimport type { Effect } from \"effect\";\n\n/**\n * Options for markup promise behavior during server rendering.\n *\n * @since 2.4.0\n */\ninterface MarkupPromiseOptions {\n  /** Keep the SSR promise pending so Svelte renders an await block fallback. */\n  ssr?: \"pending\";\n}\n\n/**\n * Runtime helper emitted by the markup transform for\n * `{#await yield* expr}` blocks. Delegates to the dispatcher's\n * promise mechanism. During SSR it can return a fallback promise without\n * starting the dispatcher.\n *\n * @since 2.0.0\n * @param id - Stable identifier generated from the expression's source\n *   position, used for cache lookups.\n * @param deps - Array of reactive dependencies.\n * @param factory - Generator function that yields the effect to run.\n * @param ssr_fallback - Value to resolve during SSR when the helper is used\n *   from an awaited expression outside a Svelte await block.\n * @param options - Optional SSR behavior for contexts such as await blocks\n *   that should render pending UI.\n * @returns A Promise that resolves with the effect's result.\n */\nexport function promise<A, E, R>(\n  id: string,\n  deps: readonly unknown[],\n  factory: () => Effect.gen.Return<A, E, R>,\n  ssr_fallback?: A,\n  options?: MarkupPromiseOptions,\n): Promise<A> {\n  if (is_server_render()) {\n    if (options?.ssr === \"pending\") {\n      return new Promise<A>(() => {});\n    }\n\n    if (arguments.length >= 4) {\n      return Promise.resolve(ssr_fallback as A);\n    }\n  }\n\n  return get_dispatcher().promise({ id, deps, factory });\n}\n\nfunction is_server_render(): boolean {\n  return typeof document === \"undefined\";\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,QACd,IACA,MACA,SACA,cACA,SACY;CACZ,IAAI,iBAAiB,GAAG;EACtB,IAAI,SAAS,QAAQ,WACnB,OAAO,IAAI,cAAiB,CAAC,CAAC;EAGhC,IAAI,UAAU,UAAU,GACtB,OAAO,QAAQ,QAAQ,YAAiB;CAE5C;CAEA,OAAO,eAAe,EAAE,QAAQ;EAAE;EAAI;EAAM;CAAQ,CAAC;AACvD;AAEA,SAAS,mBAA4B;CACnC,OAAO,OAAO,aAAa;AAC7B"}

package/.dist/markup/run.js

@@ -1,4 +1,4 @@
-import { t as get_dispatcher } from "../chunks/dispatcher-FCsx1Hlh.js";
+import { t as get_dispatcher } from "../chunks/dispatcher-CLSN-Cxn.js";
 import { Effect } from "effect";
 //#region src/markup/run.ts
 /**

package/.dist/markup/transform.js

@@ -1,2 +1,2 @@
-import { t as transform_markup_effect } from "../chunks/transform-CebZMD6u.js";
+import { t as transform_markup_effect } from "../chunks/transform-B7_CCcvq.js";
 export { transform_markup_effect };

package/.dist/markup/value.d.ts

@@ -3,9 +3,9 @@ import type { Effect } from "effect";
  * Runtime helper emitted by the markup transform for `{yield* expr}`
  * expressions in Svelte templates. Delegates to the dispatcher's
  * cached reactive value mechanism — returns the fallback synchronously,
- * then the resolved value once the effect completes. The effect is still
- * started during SSR so SvelteKit remote queries can register hydratable
- * data before the HTML is sent.
+ * then the resolved value once the effect completes in the browser. During
+ * SSR the client dispatcher is not touched, so browser-only layers cannot
+ * turn server rendering into a 500.
  *
  * @since 2.0.0
  * @param id - Stable identifier generated from the expression's source