svelte-effect-runtime 2.4.1 → 2.5.0

package/.dist/chunks/{preprocess-Cn4JH9OO.js → preprocess-DseI9Doo.js}

@@ -1,47 +1,7 @@
-import { a as find_yield_star_node, c as AsyncEffectInSyncRuneError, i as extract_binding_names, l as AwaitInEffectWorkError, n as collect_yield_star_nodes, o as is_yield_star_expression, r as contains_top_level_await, s as collect_free_identifiers } from "./transform-s9gKPYu5.js";
+import { a as find_yield_star_node, c as AsyncEffectInSyncRuneError, d as collect_top_level_binding_names, f as has_local_import_binding, i as extract_binding_names, l as AwaitInEffectWorkError, n as collect_yield_star_nodes, o as is_yield_star_expression, p as make_imports, r as contains_top_level_await, s as collect_free_identifiers, u as PreprocessError } from "./transform-Cx5bjmP6.js";
 import { contains_top_level_yield_star } from "../detect.js";
 import MagicString from "magic-string";
 import ts from "typescript";
-//#region src/preprocess/imports.ts
-/**
-* Builds the import statements injected by the script preprocessor.
-*
-* @since 2.0.0
-* @param has_effect_import - Whether the user already imports `Effect`.
-* @param has_dispatcher_import - Whether the user already imports
-*   `get_dispatcher`.
-* @param has_untrack_import - Whether the user already imports `untrack`.
-* @returns Newline-separated import statements to inject.
-*/
-function make_imports(has_effect_import, has_dispatcher_import, has_untrack_import) {
-	return [
-		!has_dispatcher_import && `import { get_dispatcher } from "svelte-effect-runtime/internal/generators";`,
-		!has_untrack_import && `import { untrack } from "svelte";`,
-		!has_effect_import && `import { Effect } from "effect";`
-	].filter(Boolean).join("\n");
-}
-/**
-* Checks whether a source file imports a local binding from a module.
-*
-* @since 2.0.0
-* @param source_file - Parsed TypeScript source file to inspect.
-* @param module_name - Module specifier to match.
-* @param local_name - Local binding name to look for.
-* @returns Whether that binding is already locally available.
-*/
-function has_local_import_binding(source_file, module_name, local_name) {
-	return source_file.statements.some((stmt) => {
-		if (!ts.isImportDeclaration(stmt) || !ts.isStringLiteral(stmt.moduleSpecifier) || stmt.moduleSpecifier.text !== module_name) return false;
-		const clause = stmt.importClause;
-		if (!clause) return false;
-		if (clause.name?.text === local_name) return true;
-		const named_bindings = clause.namedBindings;
-		if (!named_bindings) return false;
-		if (ts.isNamespaceImport(named_bindings)) return named_bindings.name.text === local_name;
-		return named_bindings.elements.some((element) => element.name.text === local_name);
-	});
-}
-//#endregion
 //#region src/preprocess/source.ts
 /**
 * Creates a source map from transformed script back to the original block.
@@ -83,13 +43,15 @@ function slice_start(content, node) {
 //#endregion
 //#region src/preprocess/runtime-block.ts
 /**
-* Builds the runtime blocks appended to lowered script effect code.
+* Builds the runtime blocks appended to lowered script effect code with
+* explicit runtime import bindings.
 *
-* @since 2.0.0
+* @since 2.4.2
 * @param blocks - Effect bodies and dependency reads to emit.
+* @param bindings - Runtime binding names available in the generated code.
 * @returns Full `$effect` blocks that fork generated `Effect.gen` programs.
 */
-function make_runtime_block(blocks) {
+function make_runtime_block_with_bindings(blocks, bindings) {
 	const merged_block = merge_effect_blocks(blocks);
 	const dep_reads = merged_block.deps.map((dep) => `  ${dep};`);
 	const body = merged_block.statements.map((statement) => `    ${statement}`).join("\n");
@@ -97,13 +59,13 @@ function make_runtime_block(blocks) {
 		"",
 		"$effect(() => {",
 		...dep_reads,
-		"  const __SER___dispatcher = get_dispatcher();",
-		"  const __SER___program = Effect.gen(function* () {",
+		`  const ${bindings.dispatcher_value} = ${bindings.dispatcher}();`,
+		`  const ${bindings.program} = ${bindings.effect}.gen(function* () {`,
 		body,
 		"  });",
-		"  const __SER___cancel = untrack(() => __SER___dispatcher.fork(__SER___program));",
-		"  import.meta.hot?.dispose(__SER___cancel);",
-		"  return __SER___cancel;",
+		`  const ${bindings.cancel} = ${bindings.untrack}(() => ${bindings.dispatcher_value}.fork(${bindings.program}));`,
+		`  import.meta.hot?.dispose(${bindings.cancel});`,
+		`  return ${bindings.cancel};`,
 		"});",
 		""
 	].join("\n");
@@ -218,6 +180,7 @@ function lower_statement(stmt, content, context) {
 }
 function lower_variable_statement(stmt, content, context) {
 	const temps = [];
+	const type_helpers = [];
 	const rewritten_decls = [];
 	const statements = [];
 	const deps = [];
@@ -226,6 +189,17 @@ function lower_variable_statement(stmt, content, context) {
 	let has_bare_yield = false;
 	for (const decl of decl_list.declarations) {
 		if (!decl.initializer || !contains_top_level_yield_star(decl.initializer)) {
+			if (contains_top_level_yield_star(decl.name)) {
+				has_bare_yield = true;
+				const binding_text = slice(content, decl.name).trim();
+				const initializer_text = decl.initializer ? slice(content, decl.initializer).trim() : "undefined";
+				const names = extract_binding_names(decl.name);
+				const statement = `(${binding_text} = ${initializer_text});`;
+				temps.push(...names.map((name) => make_unknown_temp(name, context)));
+				statements.push(statement);
+				deps.push(...collect_deps(statement, names));
+				continue;
+			}
 			rewritten_decls.push(slice(content, decl).trim());
 			continue;
 		}
@@ -234,37 +208,56 @@ function lower_variable_statement(stmt, content, context) {
 			const original_name = binding_text;
 			if (is_yield_star_expression(decl.initializer)) {
 				const temp_name = context.next_temp_name(original_name);
-				temps.push({ name: temp_name });
+				const yield_text = extract_yield_star_full_text(decl.initializer, content);
+				const type_helper = make_yield_type_helper(yield_text, original_name, context);
+				if (type_helper) {
+					type_helpers.push(type_helper.declaration);
+					temps.push({
+						name: temp_name,
+						type: type_helper.type
+					});
+				} else temps.push({ name: temp_name });
 				has_bare_yield = true;
 				rewritten_decls.push(`${original_name} = $derived(${temp_name})`);
-				const yield_text = extract_yield_star_full_text(decl.initializer, content);
 				statements.push(`${temp_name} = ${yield_text};`);
 				deps.push(...collect_deps(yield_text));
 			} else {
 				const state_rune = get_state_rune_initializer(decl.initializer, content);
 				if (state_rune) {
+					const state_type = extract_yield_star_full_text(decl.initializer, content) === state_rune.value_text ? make_yield_type_helper(state_rune.value_text, original_name, context) : void 0;
+					if (state_type) type_helpers.push(state_type.declaration);
 					has_bare_yield = true;
-					rewritten_decls.push(`${original_name} = ${state_rune.rune_name}(undefined)`);
+					rewritten_decls.push(`${original_name} = ${make_state_placeholder(state_rune.rune_name, state_type?.type, context)}`);
 					statements.push(`${original_name} = ${state_rune.value_text};`);
 					deps.push(...collect_deps(state_rune.value_text));
 					continue;
 				}
 				const lowered = lower_expression_yields(decl.initializer, content, original_name, context);
 				temps.push(...lowered.temps);
+				type_helpers.push(...lowered.type_helpers ?? []);
 				for (const block of lowered.effect_blocks) {
 					statements.push(...block.statements);
 					deps.push(...block.deps);
 				}
 				const rewritten_expr = rewrite_state_rune_as_derived(lowered.rewritten_expr);
-				rewritten_decls.push(`${original_name} = ${rewritten_expr}`);
+				const final_expr = should_wrap_complex_initializer_as_derived(decl.initializer, content) ? `$derived(${rewritten_expr})` : rewritten_expr;
+				if (final_expr !== rewritten_expr) has_bare_yield = true;
+				rewritten_decls.push(`${original_name} = ${final_expr}`);
 			}
 		} else {
 			has_bare_yield = true;
 			const temp_name = context.next_temp_name("destructure");
 			const names = extract_binding_names(decl.name);
-			temps.push({ name: temp_name });
-			temps.push(...names.map((name) => ({ name })));
 			const yield_text = extract_yield_star_full_text(decl.initializer, content);
+			const type_helper = make_yield_type_helper(yield_text, "destructure", context);
+			if (type_helper) {
+				type_helpers.push(type_helper.declaration);
+				temps.push({
+					name: temp_name,
+					type: type_helper.type
+				});
+			} else temps.push({ name: temp_name });
+			temps.push(...names.map((name) => make_unknown_temp(name, context)));
 			statements.push(`${temp_name} = ${yield_text};`);
 			statements.push(`(${binding_text} = ${temp_name});`);
 			deps.push(...collect_deps(yield_text));
@@ -272,6 +265,7 @@ function lower_variable_statement(stmt, content, context) {
 	}
 	return {
 		temps,
+		type_helpers,
 		rewritten_text: rewritten_decls.length === 0 ? "" : `${has_bare_yield ? "let" : kind} ${rewritten_decls.join(", ")};`,
 		effect_blocks: statements.length === 0 ? [] : [make_effect_block(statements, deps)],
 		range: {
@@ -303,14 +297,29 @@ function lower_expression_statement(stmt, content, context) {
 			}
 		};
 	}
-	if (ts.isBinaryExpression(expr) && expr.operatorToken.kind === ts.SyntaxKind.EqualsToken) {
+	if (ts.isBinaryExpression(expr) && is_assignment_operator(expr)) {
 		const target = slice(content, expr.left).trim();
-		const yield_text = extract_yield_star_full_text(expr, content);
 		const target_names = collect_assignment_target_names(expr.left);
+		if (expr.operatorToken.kind === ts.SyntaxKind.EqualsToken && is_yield_star_expression(expr.right)) {
+			const yield_text = extract_yield_star_full_text(expr.right, content);
+			return {
+				temps: [],
+				rewritten_text: "",
+				effect_blocks: [make_effect_block([`${target} = ${yield_text};`], collect_deps(yield_text, target_names))],
+				range: {
+					start: stmt.getStart(),
+					end: stmt.end
+				}
+			};
+		}
+		const lowered = lower_expression_yields(expr.right, content, make_temp_hint(target), context);
+		const temp_names = lowered.temps.map((temp) => temp.name);
+		const statement = `${target} ${slice(content, expr.operatorToken).trim()} ${lowered.rewritten_expr};`;
 		return {
-			temps: [],
+			temps: lowered.temps,
+			type_helpers: lowered.type_helpers,
 			rewritten_text: "",
-			effect_blocks: [make_effect_block([`${target} = ${yield_text};`], collect_deps(yield_text, target_names))],
+			effect_blocks: [make_effect_block([...lowered.effect_blocks.flatMap((block) => block.statements), statement], [...lowered.effect_blocks.flatMap((block) => block.deps), ...collect_deps(lowered.rewritten_expr, [...target_names, ...temp_names])])],
 			range: {
 				start: stmt.getStart(),
 				end: stmt.end
@@ -318,8 +327,9 @@ function lower_expression_statement(stmt, content, context) {
 		};
 	}
 	const lowered = lower_expression_yields(expr, content, "call", context);
-	return {
+	if (is_top_level_rune_call(expr)) return {
 		temps: lowered.temps,
+		type_helpers: lowered.type_helpers,
 		rewritten_text: lowered.rewritten_expr + ";",
 		effect_blocks: lowered.effect_blocks,
 		range: {
@@ -327,16 +337,35 @@ function lower_expression_statement(stmt, content, context) {
 			end: stmt.end
 		}
 	};
+	const temp_names = lowered.temps.map((temp) => temp.name);
+	return {
+		temps: lowered.temps,
+		type_helpers: lowered.type_helpers,
+		rewritten_text: "",
+		effect_blocks: [make_effect_block([...lowered.effect_blocks.flatMap((block) => block.statements), lowered.rewritten_expr + ";"], [...lowered.effect_blocks.flatMap((block) => block.deps), ...collect_deps(lowered.rewritten_expr, temp_names)])],
+		range: {
+			start: stmt.getStart(),
+			end: stmt.end
+		}
+	};
 }
 function lower_expression_yields(expr, content, hint, context) {
 	const replacements = [];
 	const temps = [];
+	const type_helpers = [];
 	const statements = [];
 	const deps = [];
 	collect_yield_star_nodes(expr, (node) => {
 		const temp_name = context.next_temp_name(hint);
 		const yield_text = slice_start(content, node).trim();
-		temps.push({ name: temp_name });
+		const type_helper = make_yield_type_helper(yield_text, hint, context);
+		if (type_helper) {
+			type_helpers.push(type_helper.declaration);
+			temps.push({
+				name: temp_name,
+				type: type_helper.type
+			});
+		} else temps.push({ name: temp_name });
 		statements.push(`${temp_name} = ${yield_text};`);
 		deps.push(...collect_deps(yield_text));
 		replacements.push({
@@ -347,6 +376,7 @@ function lower_expression_yields(expr, content, hint, context) {
 	});
 	if (replacements.length === 0) return {
 		temps,
+		type_helpers,
 		rewritten_expr: slice(content, expr).trim(),
 		effect_blocks: []
 	};
@@ -356,15 +386,54 @@ function lower_expression_yields(expr, content, hint, context) {
 	for (const replacement of replacements) text = text.slice(0, replacement.start - offset_in_expr) + replacement.text + text.slice(replacement.end - offset_in_expr);
 	return {
 		temps,
+		type_helpers,
 		rewritten_expr: text.trim(),
 		effect_blocks: [make_effect_block(statements, deps)]
 	};
 }
+function make_yield_type_helper(yield_text, hint, context) {
+	if (!context.emit_types) return;
+	const helper_name = context.next_type_helper_name(hint);
+	return {
+		declaration: `function ${helper_name}() { return (${strip_yield_star(yield_text)}); }`,
+		type: `${context.effect_name}.Success<ReturnType<typeof ${helper_name}>> | undefined`
+	};
+}
+function make_unknown_temp(name, context) {
+	return {
+		name,
+		type: context.emit_types ? "unknown" : void 0
+	};
+}
+function make_state_placeholder(rune_name, type, context) {
+	if (type) return `${rune_name}<${type}>(undefined)`;
+	if (context.emit_types) return `${rune_name}<unknown>(undefined)`;
+	return `${rune_name}(undefined)`;
+}
+function strip_yield_star(yield_text) {
+	return yield_text.replace(/^yield\*\s*/, "");
+}
 function rewrite_state_rune_as_derived(expression) {
 	const state_call = expression.match(/^\$state(?:\.raw)?\(([\s\S]*)\)$/);
 	if (!state_call) return expression;
 	return `$derived(${state_call[1]})`;
 }
+function should_wrap_complex_initializer_as_derived(expr, content) {
+	const text = slice(content, expr).trim();
+	return !/^\$derived(?:\.by)?\(/.test(text) && !/^\$inspect(?:\.trace)?\(/.test(text);
+}
+function is_assignment_operator(expr) {
+	return expr.operatorToken.kind >= ts.SyntaxKind.FirstAssignment && expr.operatorToken.kind <= ts.SyntaxKind.LastAssignment;
+}
+function is_top_level_rune_call(expr) {
+	if (!ts.isCallExpression(expr)) return false;
+	const callee = expr.expression;
+	if (ts.isIdentifier(callee)) return callee.text.startsWith("$");
+	return ts.isPropertyAccessExpression(callee) && ts.isIdentifier(callee.expression) && callee.expression.text.startsWith("$");
+}
+function make_temp_hint(target) {
+	return target.match(/[A-Za-z_$][\w$]*$/)?.[0] ?? "assignment";
+}
 function extract_yield_star_full_text(expr, content) {
 	let found;
 	find_yield_star_node(expr, (node) => {
@@ -413,35 +482,58 @@ function collect_assignment_target_names(node) {
 * @since 2.0.0
 * @param content - The raw `<script effect>` body content.
 * @param filename - The source filename, used in error messages.
+* @param options - Optional transform settings for generated script code.
 * @returns The transformed code and any block references.
 */
-function transform_script_effect(content, filename) {
+function transform_script_effect(content, filename, options = {}) {
 	let temp_counter = 0;
 	const source_file = ts.createSourceFile(filename, content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
 	const magic = new MagicString(content);
 	const effect_blocks = [];
 	const block_refs = [];
+	const top_level_binding_names = collect_top_level_binding_names(source_file);
+	const top_level_binding_names_set = new Set(top_level_binding_names);
+	const name_allocator = make_name_allocator(top_level_binding_names);
+	const emit_types = options.emit_types ?? true;
 	let has_effect = false;
-	const context = { next_temp_name(hint) {
-		const suffix = temp_counter === 0 ? "" : `_${temp_counter}`;
-		const name = hint ? `__SER___${hint}${suffix}` : `__SER___${temp_counter}`;
-		temp_counter += 1;
-		return name;
-	} };
 	/** Phase 1: detect imports already provided by the user. */
 	const has_effect_import = has_local_import_binding(source_file, "effect", "Effect");
 	const has_dispatcher_import = has_local_import_binding(source_file, "svelte-effect-runtime/internal/generators", "get_dispatcher");
 	const has_untrack_import = has_local_import_binding(source_file, "svelte", "untrack");
+	const reserve_runtime_import = (name) => top_level_binding_names_set.has(name) ? name_allocator.reserve(make_generated_name(name, "")) : name_allocator.reserve(name);
+	const runtime_bindings = {
+		cancel: name_allocator.reserve("__SER___cancel"),
+		dispatcher: has_dispatcher_import ? "get_dispatcher" : reserve_runtime_import("get_dispatcher"),
+		dispatcher_value: name_allocator.reserve("__SER___dispatcher"),
+		effect: has_effect_import ? "Effect" : reserve_runtime_import("Effect"),
+		program: name_allocator.reserve("__SER___program"),
+		untrack: has_untrack_import ? "untrack" : reserve_runtime_import("untrack")
+	};
+	const context = {
+		effect_name: runtime_bindings.effect,
+		emit_types,
+		next_temp_name(hint) {
+			const suffix = temp_counter === 0 ? "" : `_${temp_counter}`;
+			const name = make_generated_name(hint ?? String(temp_counter), suffix);
+			temp_counter += 1;
+			return name_allocator.reserve(name);
+		},
+		next_type_helper_name(hint) {
+			return name_allocator.reserve(make_generated_name(`type_${hint ?? "effect"}`, ""));
+		}
+	};
 	/** Phase 2: lower every top-level statement that contains `yield*`. */
 	for (const stmt of source_file.statements) {
 		validate_rune_yield_usage(stmt, content, filename);
+		validate_script_yield_boundaries(stmt, content, filename);
 		if (!contains_top_level_yield_star(stmt)) continue;
 		if (contains_top_level_await(stmt)) throw new AwaitInEffectWorkError(filename, slice(content, stmt));
 		has_effect = true;
 		const lowered = lower_statement(stmt, content, context);
 		magic.overwrite(lowered.range.start, lowered.range.end, lowered.rewritten_text);
-		if (lowered.temps.length > 0) {
-			const prefix = lowered.temps.map((temp) => `let ${temp.name} = $state(undefined);`).join("\n");
+		if (lowered.temps.length > 0 || lowered.type_helpers?.length) {
+			const temp_declarations = lowered.temps.map((temp) => temp.type ? `let ${temp.name} = $state<${temp.type}>(undefined);` : `let ${temp.name} = $state(undefined);`);
+			const prefix = [...lowered.type_helpers ?? [], ...temp_declarations].join("\n");
 			magic.appendLeft(lowered.range.start, prefix + "\n");
 		}
 		effect_blocks.push(...lowered.effect_blocks);
@@ -457,12 +549,12 @@ function transform_script_effect(content, filename) {
 		};
 	}
 	/** Phase 3: inject runtime imports after the last user import. */
-	const imports = make_imports(has_effect_import, has_dispatcher_import, has_untrack_import);
+	const imports = make_imports(has_effect_import, has_dispatcher_import, has_untrack_import, runtime_bindings);
 	const last_import = [...source_file.statements].reverse().find(ts.isImportDeclaration);
 	if (last_import) magic.appendRight(last_import.end, "\n" + imports);
 	else magic.prepend(imports + "\n");
 	/** Phase 4: append the runtime program and lifecycle wiring. */
-	const runtime_block = make_runtime_block(effect_blocks);
+	const runtime_block = make_runtime_block_with_bindings(effect_blocks, runtime_bindings);
 	magic.append("\n" + runtime_block);
 	block_refs.push({
 		id: filename,
@@ -474,7 +566,48 @@ function transform_script_effect(content, filename) {
 		map: create_source_map(magic, filename)
 	};
 }
+function validate_script_yield_boundaries(stmt, content, filename) {
+	const bad_member = find_class_member_with_yield_star(stmt);
+	if (!bad_member) return;
+	throw new PreprocessError([
+		`[ASYNC_EFFECT_IN_CLASS_MEMBER]: ${filename}: yield* cannot be used inside class members.`,
+		`Class fields and methods are not component top-level reactive work. Move the Effect work into a script effect statement before assigning it to the class instance.`,
+		"",
+		"Problematic member:",
+		slice(content, bad_member)
+	].join("\n"), filename);
+}
+function find_class_member_with_yield_star(stmt) {
+	let found;
+	function visit(node) {
+		if (found) return;
+		if (ts.isPropertyDeclaration(node) && node.initializer && contains_top_level_yield_star(node.initializer)) {
+			found = node;
+			return;
+		}
+		node.forEachChild(visit);
+	}
+	visit(stmt);
+	return found;
+}
+function make_name_allocator(initial_names) {
+	const used_names = new Set(initial_names);
+	return { reserve(name) {
+		let candidate = name;
+		let suffix = 1;
+		while (used_names.has(candidate)) {
+			candidate = `${name}_${suffix}`;
+			suffix += 1;
+		}
+		used_names.add(candidate);
+		return candidate;
+	} };
+}
+function make_generated_name(hint, suffix) {
+	const normalized_hint = hint.replace(/[^A-Za-z0-9_$]/g, "_");
+	return `__SER___${/^[A-Za-z_$]/.test(normalized_hint) ? normalized_hint : `temp_${normalized_hint}`}${suffix}`;
+}
 //#endregion
 export { transform_script_effect as t };
 
-//# sourceMappingURL=preprocess-Cn4JH9OO.js.map
+//# sourceMappingURL=preprocess-DseI9Doo.js.map

package/.dist/chunks/preprocess-DseI9Doo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preprocess-DseI9Doo.js","names":[],"sources":["../../../modules/svelte-effect-runtime/src/preprocess/source.ts","../../../modules/svelte-effect-runtime/src/preprocess/runtime-block.ts","../../../modules/svelte-effect-runtime/src/preprocess/runes.ts","../../../modules/svelte-effect-runtime/src/preprocess/lower.ts","../../../modules/svelte-effect-runtime/src/preprocess/index.ts"],"sourcesContent":["import type MagicString from \"magic-string\";\nimport type ts from \"typescript\";\n\n/**\n * Creates a source map from transformed script back to the original block.\n *\n * @since 2.0.0\n * @param magic - MagicString instance holding the transformed source.\n * @param filename - Source filename used for the source map entry.\n * @returns A plain source map object.\n */\nexport function create_source_map(\n  magic: MagicString,\n  filename: string,\n): Record<string, unknown> {\n  const map = magic.generateMap({\n    hires: true,\n    includeContent: true,\n    source: filename,\n  });\n\n  return map as unknown as Record<string, unknown>;\n}\n\n/**\n * Slices a substring matching a node's full source range.\n *\n * @since 2.0.0\n * @param content - Original source text.\n * @param node - AST node whose full range should be extracted.\n * @returns Source text including leading trivia.\n */\nexport function slice(content: string, node: ts.Node): string {\n  return content.slice(node.getFullStart(), node.end);\n}\n\n/**\n * Slices a substring matching a node's source range without leading trivia.\n *\n * @since 2.0.0\n * @param content - Original source text.\n * @param node - AST node whose non-trivia range should be extracted.\n * @returns Source text excluding leading trivia.\n */\nexport function slice_start(content: string, node: ts.Node): string {\n  return content.slice(node.getStart(), node.end);\n}\n","import type { EffectBlock, RuntimeImportBindings } from \"./types.ts\";\n\n/**\n * Builds the runtime blocks appended to lowered script effect code.\n *\n * @since 2.0.0\n * @param blocks - Effect bodies and dependency reads to emit.\n * @returns Full `$effect` blocks that fork generated `Effect.gen` programs.\n */\nexport function make_runtime_block(blocks: EffectBlock[]): string {\n  const bindings: RuntimeImportBindings = {\n    cancel: \"__SER___cancel\",\n    dispatcher: \"get_dispatcher\",\n    dispatcher_value: \"__SER___dispatcher\",\n    effect: \"Effect\",\n    program: \"__SER___program\",\n    untrack: \"untrack\",\n  };\n\n  return make_runtime_block_with_bindings(blocks, bindings);\n}\n\n/**\n * Builds the runtime blocks appended to lowered script effect code with\n * explicit runtime import bindings.\n *\n * @since 2.4.2\n * @param blocks - Effect bodies and dependency reads to emit.\n * @param bindings - Runtime binding names available in the generated code.\n * @returns Full `$effect` blocks that fork generated `Effect.gen` programs.\n */\nexport function make_runtime_block_with_bindings(\n  blocks: EffectBlock[],\n  bindings: RuntimeImportBindings,\n): string {\n  const merged_block = merge_effect_blocks(blocks);\n  const dep_reads = merged_block.deps.map((dep) => `  ${dep};`);\n\n  const body = merged_block.statements\n    .map((statement) => `    ${statement}`)\n    .join(\"\\n\");\n\n  return [\n    \"\",\n    \"$effect(() => {\",\n    ...dep_reads,\n    `  const ${bindings.dispatcher_value} = ${bindings.dispatcher}();`,\n    `  const ${bindings.program} = ${bindings.effect}.gen(function* () {`,\n    body,\n    \"  });\",\n    `  const ${bindings.cancel} = ${bindings.untrack}(() => ${bindings.dispatcher_value}.fork(${bindings.program}));`,\n    `  import.meta.hot?.dispose(${bindings.cancel});`,\n    `  return ${bindings.cancel};`,\n    \"});\",\n    \"\",\n  ].join(\"\\n\");\n}\n\nfunction merge_effect_blocks(blocks: EffectBlock[]): EffectBlock {\n  const statements = blocks.flatMap((block) => block.statements);\n  const deps = blocks.flatMap((block) => block.deps);\n\n  return {\n    statements,\n    deps: [...new Set(deps)],\n  };\n}\n","import { contains_top_level_yield_star } from \"$/detect.ts\";\nimport { AsyncEffectInSyncRuneError } from \"$/error.ts\";\nimport { slice } from \"./source.ts\";\n\nimport ts from \"typescript\";\n\nconst ASYNC_EXPRESSION_RUNES = new Set([\n  \"$derived\",\n  \"$inspect\",\n  \"$state\",\n  \"$state.raw\",\n]);\n\nconst CALLBACK_RUNES = new Set([\n  \"$derived.by\",\n  \"$effect\",\n  \"$effect.pre\",\n  \"$effect.root\",\n]);\n\n/**\n * Validates that `yield*` only appears in rune positions the script-effect\n * transform can lower without changing the rune's normal Svelte contract.\n *\n * @since 2.0.0\n * @param node - AST node to scan.\n * @param content - Original script source used for diagnostics.\n * @param filename - Source filename used for diagnostics.\n * @returns Nothing.\n */\nexport function validate_rune_yield_usage(\n  node: ts.Node,\n  content: string,\n  filename: string,\n): void {\n  visit_rune_yield_usage(node, content, filename);\n}\n\n/**\n * Identifies `$state(...)` and `$state.raw(...)` initializer calls.\n *\n * @since 2.0.0\n * @param expr - Expression to classify.\n * @param content - Original script source used to preserve argument text.\n * @returns State rune details when the expression is a state initializer.\n */\nexport function get_state_rune_initializer(\n  expr: ts.Expression,\n  content: string,\n): { rune_name: \"$state\" | \"$state.raw\"; value_text: string } | undefined {\n  if (!ts.isCallExpression(expr)) {\n    return undefined;\n  }\n\n  const rune_name = get_rune_name(expr.expression);\n\n  if (rune_name !== \"$state\" && rune_name !== \"$state.raw\") {\n    return undefined;\n  }\n\n  const first_arg = expr.arguments[0];\n\n  if (!first_arg) {\n    return undefined;\n  }\n\n  return {\n    rune_name,\n    value_text: slice(content, first_arg).trim(),\n  };\n}\n\nfunction visit_rune_yield_usage(\n  node: ts.Node,\n  content: string,\n  filename: string,\n): void {\n  if (ts.isCallExpression(node)) {\n    validate_call_expression(node, content, filename);\n  }\n\n  node.forEachChild((child) => {\n    visit_rune_yield_usage(child, content, filename);\n  });\n}\n\nfunction validate_call_expression(\n  call: ts.CallExpression,\n  content: string,\n  filename: string,\n): void {\n  const rune_name = get_rune_name(call.expression);\n\n  if (!rune_name) {\n    return;\n  }\n\n  if (\n    !ASYNC_EXPRESSION_RUNES.has(rune_name) &&\n    contains_top_level_yield_star(call)\n  ) {\n    throw new AsyncEffectInSyncRuneError(\n      rune_name,\n      slice(content, call),\n      filename,\n    );\n  }\n\n  if (!CALLBACK_RUNES.has(rune_name)) {\n    return;\n  }\n\n  const callback = call.arguments[0];\n\n  if (!callback || !callback_has_top_level_yield_star(callback)) {\n    return;\n  }\n\n  throw new AsyncEffectInSyncRuneError(\n    rune_name,\n    slice(content, call),\n    filename,\n  );\n}\n\nfunction callback_has_top_level_yield_star(node: ts.Expression): boolean {\n  if (\n    (ts.isArrowFunction(node) ||\n      ts.isFunctionExpression(node)) &&\n    node.body !== undefined\n  ) {\n    return contains_top_level_yield_star(node.body);\n  }\n\n  return contains_top_level_yield_star(node);\n}\n\nfunction get_rune_name(expr: ts.Expression): string | undefined {\n  if (ts.isIdentifier(expr) && is_rune_root(expr.text)) {\n    return expr.text;\n  }\n\n  if (!ts.isPropertyAccessExpression(expr)) {\n    return undefined;\n  }\n\n  const root_name = get_rune_name(expr.expression);\n\n  if (!root_name) {\n    return undefined;\n  }\n\n  return `${root_name}.${expr.name.text}`;\n}\n\nfunction is_rune_root(name: string): boolean {\n  return (\n    name === \"$bindable\" ||\n    name === \"$derived\" ||\n    name === \"$effect\" ||\n    name === \"$host\" ||\n    name === \"$inspect\" ||\n    name === \"$props\" ||\n    name === \"$state\"\n  );\n}\n","import { collect_free_identifiers } from \"$/markup/transform/expressions.ts\";\nimport { contains_top_level_yield_star } from \"$/detect.ts\";\nimport {\n  collect_yield_star_nodes,\n  extract_binding_names,\n  find_yield_star_node,\n  is_yield_star_expression,\n} from \"./ast.ts\";\nimport { get_state_rune_initializer } from \"./runes.ts\";\nimport { slice, slice_start } from \"./source.ts\";\nimport type {\n  EffectBlock,\n  LoweredExpression,\n  LoweredStatement,\n  ScriptLoweringContext,\n  TempBinding,\n} from \"./types.ts\";\n\nimport ts from \"typescript\";\n\n/**\n * Delegates a statement to the correct lowerer based on syntax kind.\n *\n * @since 2.0.0\n * @param stmt - Statement to lower.\n * @param content - Original source text.\n * @param context - Lowering services for this transform pass.\n * @returns Lowered statement descriptor.\n */\nexport function lower_statement(\n  stmt: ts.Statement,\n  content: string,\n  context: ScriptLoweringContext,\n): LoweredStatement {\n  if (ts.isExpressionStatement(stmt)) {\n    return lower_expression_statement(stmt, content, context);\n  }\n\n  if (ts.isVariableStatement(stmt)) {\n    return lower_variable_statement(stmt, content, context);\n  }\n\n  const text = slice(content, stmt);\n\n  return {\n    temps: [],\n    rewritten_text: \"\",\n    effect_blocks: [make_effect_block([text], collect_deps(text))],\n    range: { start: stmt.getFullStart(), end: stmt.end },\n  };\n}\n\nfunction lower_variable_statement(\n  stmt: ts.VariableStatement,\n  content: string,\n  context: ScriptLoweringContext,\n): LoweredStatement {\n  const temps: TempBinding[] = [];\n  const type_helpers: string[] = [];\n  const rewritten_decls: string[] = [];\n  const statements: string[] = [];\n  const deps: string[] = [];\n\n  const decl_list = stmt.declarationList;\n  const kind = (decl_list.flags & ts.NodeFlags.Let) !== 0 ? \"let\" : \"const\";\n  let has_bare_yield = false;\n\n  for (const decl of decl_list.declarations) {\n    if (!decl.initializer || !contains_top_level_yield_star(decl.initializer)) {\n      if (contains_top_level_yield_star(decl.name)) {\n        has_bare_yield = true;\n\n        const binding_text = slice(content, decl.name).trim();\n        const initializer_text = decl.initializer\n          ? slice(content, decl.initializer).trim()\n          : \"undefined\";\n        const names = extract_binding_names(decl.name);\n        const statement = `(${binding_text} = ${initializer_text});`;\n\n        temps.push(...names.map((name) => make_unknown_temp(name, context)));\n        statements.push(statement);\n        deps.push(...collect_deps(statement, names));\n\n        continue;\n      }\n\n      rewritten_decls.push(slice(content, decl).trim());\n      continue;\n    }\n\n    const binding_text = slice(content, decl.name).trim();\n\n    if (ts.isIdentifier(decl.name)) {\n      const original_name = binding_text;\n\n      if (is_yield_star_expression(decl.initializer)) {\n        const temp_name = context.next_temp_name(original_name);\n        const yield_text = extract_yield_star_full_text(\n          decl.initializer,\n          content,\n        );\n        const type_helper = make_yield_type_helper(\n          yield_text,\n          original_name,\n          context,\n        );\n\n        if (type_helper) {\n          type_helpers.push(type_helper.declaration);\n          temps.push({ name: temp_name, type: type_helper.type });\n        } else {\n          temps.push({ name: temp_name });\n        }\n\n        has_bare_yield = true;\n        rewritten_decls.push(`${original_name} = $derived(${temp_name})`);\n\n        statements.push(`${temp_name} = ${yield_text};`);\n        deps.push(...collect_deps(yield_text));\n      } else {\n        const state_rune = get_state_rune_initializer(\n          decl.initializer,\n          content,\n        );\n\n        if (state_rune) {\n          const direct_yield_text = extract_yield_star_full_text(\n            decl.initializer,\n            content,\n          );\n          const state_type = direct_yield_text === state_rune.value_text\n            ? make_yield_type_helper(\n              state_rune.value_text,\n              original_name,\n              context,\n            )\n            : undefined;\n\n          if (state_type) {\n            type_helpers.push(state_type.declaration);\n          }\n\n          has_bare_yield = true;\n          rewritten_decls.push(\n            `${original_name} = ${\n              make_state_placeholder(\n                state_rune.rune_name,\n                state_type?.type,\n                context,\n              )\n            }`,\n          );\n          statements.push(`${original_name} = ${state_rune.value_text};`);\n          deps.push(...collect_deps(state_rune.value_text));\n          continue;\n        }\n\n        const lowered = lower_expression_yields(\n          decl.initializer,\n          content,\n          original_name,\n          context,\n        );\n\n        temps.push(...lowered.temps);\n        type_helpers.push(...(lowered.type_helpers ?? []));\n        for (const block of lowered.effect_blocks) {\n          statements.push(...block.statements);\n          deps.push(...block.deps);\n        }\n\n        const rewritten_expr = rewrite_state_rune_as_derived(\n          lowered.rewritten_expr,\n        );\n        const final_expr = should_wrap_complex_initializer_as_derived(\n            decl.initializer,\n            content,\n          )\n          ? `$derived(${rewritten_expr})`\n          : rewritten_expr;\n\n        if (final_expr !== rewritten_expr) {\n          has_bare_yield = true;\n        }\n\n        rewritten_decls.push(`${original_name} = ${final_expr}`);\n      }\n    } else {\n      has_bare_yield = true;\n\n      const temp_name = context.next_temp_name(\"destructure\");\n      const names = extract_binding_names(decl.name);\n      const yield_text = extract_yield_star_full_text(\n        decl.initializer,\n        content,\n      );\n      const type_helper = make_yield_type_helper(\n        yield_text,\n        \"destructure\",\n        context,\n      );\n\n      if (type_helper) {\n        type_helpers.push(type_helper.declaration);\n        temps.push({ name: temp_name, type: type_helper.type });\n      } else {\n        temps.push({ name: temp_name });\n      }\n\n      temps.push(...names.map((name) => make_unknown_temp(name, context)));\n\n      statements.push(`${temp_name} = ${yield_text};`);\n      statements.push(`(${binding_text} = ${temp_name});`);\n      deps.push(...collect_deps(yield_text));\n    }\n  }\n\n  const rewritten_text = rewritten_decls.length === 0\n    ? \"\"\n    : `${has_bare_yield ? \"let\" : kind} ${rewritten_decls.join(\", \")};`;\n\n  return {\n    temps,\n    type_helpers,\n    rewritten_text,\n    effect_blocks: statements.length === 0\n      ? []\n      : [make_effect_block(statements, deps)],\n    range: { start: stmt.getStart(), end: stmt.end },\n  };\n}\n\nfunction lower_expression_statement(\n  stmt: ts.ExpressionStatement,\n  content: string,\n  context: ScriptLoweringContext,\n): LoweredStatement {\n  const expr = stmt.expression;\n\n  if (!contains_top_level_yield_star(expr)) {\n    return {\n      temps: [],\n      rewritten_text: slice(content, stmt).trim(),\n      effect_blocks: [],\n      range: { start: stmt.getStart(), end: stmt.end },\n    };\n  }\n\n  if (is_yield_star_expression(expr)) {\n    const text = slice(content, expr).trim();\n\n    return {\n      temps: [],\n      rewritten_text: \"\",\n      effect_blocks: [make_effect_block([text + \";\"], collect_deps(text))],\n      range: { start: stmt.getFullStart(), end: stmt.end },\n    };\n  }\n\n  if (ts.isBinaryExpression(expr) && is_assignment_operator(expr)) {\n    const target = slice(content, expr.left).trim();\n    const target_names = collect_assignment_target_names(expr.left);\n\n    if (\n      expr.operatorToken.kind === ts.SyntaxKind.EqualsToken &&\n      is_yield_star_expression(expr.right)\n    ) {\n      const yield_text = extract_yield_star_full_text(expr.right, content);\n\n      return {\n        temps: [],\n        rewritten_text: \"\",\n        effect_blocks: [\n          make_effect_block(\n            [`${target} = ${yield_text};`],\n            collect_deps(yield_text, target_names),\n          ),\n        ],\n        range: { start: stmt.getStart(), end: stmt.end },\n      };\n    }\n\n    const lowered = lower_expression_yields(\n      expr.right,\n      content,\n      make_temp_hint(target),\n      context,\n    );\n    const temp_names = lowered.temps.map((temp) => temp.name);\n    const statement = `${target} ${\n      slice(content, expr.operatorToken).trim()\n    } ${lowered.rewritten_expr};`;\n\n    return {\n      temps: lowered.temps,\n      type_helpers: lowered.type_helpers,\n      rewritten_text: \"\",\n      effect_blocks: [\n        make_effect_block(\n          [\n            ...lowered.effect_blocks.flatMap((block) => block.statements),\n            statement,\n          ],\n          [\n            ...lowered.effect_blocks.flatMap((block) => block.deps),\n            ...collect_deps(lowered.rewritten_expr, [\n              ...target_names,\n              ...temp_names,\n            ]),\n          ],\n        ),\n      ],\n      range: { start: stmt.getStart(), end: stmt.end },\n    };\n  }\n\n  const lowered = lower_expression_yields(\n    expr,\n    content,\n    \"call\",\n    context,\n  );\n\n  if (is_top_level_rune_call(expr)) {\n    return {\n      temps: lowered.temps,\n      type_helpers: lowered.type_helpers,\n      rewritten_text: lowered.rewritten_expr + \";\",\n      effect_blocks: lowered.effect_blocks,\n      range: { start: stmt.getStart(), end: stmt.end },\n    };\n  }\n\n  const temp_names = lowered.temps.map((temp) => temp.name);\n\n  return {\n    temps: lowered.temps,\n    type_helpers: lowered.type_helpers,\n    rewritten_text: \"\",\n    effect_blocks: [\n      make_effect_block(\n        [\n          ...lowered.effect_blocks.flatMap((block) => block.statements),\n          lowered.rewritten_expr + \";\",\n        ],\n        [\n          ...lowered.effect_blocks.flatMap((block) => block.deps),\n          ...collect_deps(lowered.rewritten_expr, temp_names),\n        ],\n      ),\n    ],\n    range: { start: stmt.getStart(), end: stmt.end },\n  };\n}\n\nfunction lower_expression_yields(\n  expr: ts.Expression,\n  content: string,\n  hint: string,\n  context: ScriptLoweringContext,\n): LoweredExpression {\n  const replacements: Array<{\n    start: number;\n    end: number;\n    text: string;\n  }> = [];\n\n  const temps: TempBinding[] = [];\n  const type_helpers: string[] = [];\n  const statements: string[] = [];\n  const deps: string[] = [];\n\n  collect_yield_star_nodes(expr, (node) => {\n    const temp_name = context.next_temp_name(hint);\n    const yield_text = slice_start(content, node).trim();\n    const type_helper = make_yield_type_helper(yield_text, hint, context);\n\n    if (type_helper) {\n      type_helpers.push(type_helper.declaration);\n      temps.push({ name: temp_name, type: type_helper.type });\n    } else {\n      temps.push({ name: temp_name });\n    }\n\n    statements.push(`${temp_name} = ${yield_text};`);\n    deps.push(...collect_deps(yield_text));\n    replacements.push({\n      start: node.getStart(),\n      end: node.end,\n      text: temp_name,\n    });\n  });\n\n  if (replacements.length === 0) {\n    return {\n      temps,\n      type_helpers,\n      rewritten_expr: slice(content, expr).trim(),\n      effect_blocks: [],\n    };\n  }\n\n  replacements.sort((a, b) => b.start - a.start);\n\n  let text = slice(content, expr);\n\n  const offset_in_expr = expr.getFullStart();\n\n  for (const replacement of replacements) {\n    text = text.slice(0, replacement.start - offset_in_expr) +\n      replacement.text +\n      text.slice(replacement.end - offset_in_expr);\n  }\n\n  return {\n    temps,\n    type_helpers,\n    rewritten_expr: text.trim(),\n    effect_blocks: [make_effect_block(statements, deps)],\n  };\n}\n\nfunction make_yield_type_helper(\n  yield_text: string,\n  hint: string,\n  context: ScriptLoweringContext,\n): { declaration: string; type: string } | undefined {\n  if (!context.emit_types) {\n    return undefined;\n  }\n\n  const helper_name = context.next_type_helper_name(hint);\n  const effect_text = strip_yield_star(yield_text);\n\n  return {\n    declaration: `function ${helper_name}() { return (${effect_text}); }`,\n    type:\n      `${context.effect_name}.Success<ReturnType<typeof ${helper_name}>> | undefined`,\n  };\n}\n\nfunction make_unknown_temp(\n  name: string,\n  context: ScriptLoweringContext,\n): TempBinding {\n  return {\n    name,\n    type: context.emit_types ? \"unknown\" : undefined,\n  };\n}\n\nfunction make_state_placeholder(\n  rune_name: string,\n  type: string | undefined,\n  context: ScriptLoweringContext,\n): string {\n  if (type) {\n    return `${rune_name}<${type}>(undefined)`;\n  }\n\n  if (context.emit_types) {\n    return `${rune_name}<unknown>(undefined)`;\n  }\n\n  return `${rune_name}(undefined)`;\n}\n\nfunction strip_yield_star(yield_text: string): string {\n  return yield_text.replace(/^yield\\*\\s*/, \"\");\n}\n\nfunction rewrite_state_rune_as_derived(expression: string): string {\n  const state_call = expression.match(/^\\$state(?:\\.raw)?\\(([\\s\\S]*)\\)$/);\n\n  if (!state_call) {\n    return expression;\n  }\n\n  return `$derived(${state_call[1]})`;\n}\n\nfunction should_wrap_complex_initializer_as_derived(\n  expr: ts.Expression,\n  content: string,\n): boolean {\n  const text = slice(content, expr).trim();\n\n  return !/^\\$derived(?:\\.by)?\\(/.test(text) &&\n    !/^\\$inspect(?:\\.trace)?\\(/.test(text);\n}\n\nfunction is_assignment_operator(expr: ts.BinaryExpression): boolean {\n  return expr.operatorToken.kind >= ts.SyntaxKind.FirstAssignment &&\n    expr.operatorToken.kind <= ts.SyntaxKind.LastAssignment;\n}\n\nfunction is_top_level_rune_call(expr: ts.Expression): boolean {\n  if (!ts.isCallExpression(expr)) {\n    return false;\n  }\n\n  const callee = expr.expression;\n\n  if (ts.isIdentifier(callee)) {\n    return callee.text.startsWith(\"$\");\n  }\n\n  return ts.isPropertyAccessExpression(callee) &&\n    ts.isIdentifier(callee.expression) &&\n    callee.expression.text.startsWith(\"$\");\n}\n\nfunction make_temp_hint(target: string): string {\n  const match = target.match(/[A-Za-z_$][\\w$]*$/);\n\n  return match?.[0] ?? \"assignment\";\n}\n\nfunction extract_yield_star_full_text(\n  expr: ts.Expression,\n  content: string,\n): string {\n  let found: string | undefined;\n\n  find_yield_star_node(expr, (node) => {\n    found = slice_start(content, node).trim();\n  });\n\n  return found ?? \"undefined\";\n}\n\nfunction make_effect_block(\n  statements: string[],\n  deps: string[],\n): EffectBlock {\n  return {\n    statements,\n    deps: [...new Set(deps)],\n  };\n}\n\nfunction collect_deps(\n  expr_text: string,\n  excluded_names: readonly string[] = [],\n): string[] {\n  const excluded = new Set(excluded_names);\n\n  return collect_free_identifiers(expr_text).filter(\n    (identifier) =>\n      !identifier.startsWith(\"__SER___\") && !excluded.has(identifier),\n  );\n}\n\nfunction collect_assignment_target_names(node: ts.Node): string[] {\n  if (ts.isIdentifier(node)) {\n    return [node.text];\n  }\n\n  if (ts.isParenthesizedExpression(node)) {\n    return collect_assignment_target_names(node.expression);\n  }\n\n  if (\n    ts.isPropertyAccessExpression(node) || ts.isElementAccessExpression(node)\n  ) {\n    return collect_assignment_target_names(node.expression);\n  }\n\n  if (ts.isObjectLiteralExpression(node)) {\n    return node.properties.flatMap((property) => {\n      if (ts.isShorthandPropertyAssignment(property)) {\n        return [property.name.text];\n      }\n\n      if (ts.isPropertyAssignment(property)) {\n        return collect_assignment_target_names(property.initializer);\n      }\n\n      if (ts.isSpreadAssignment(property)) {\n        return collect_assignment_target_names(property.expression);\n      }\n\n      return [];\n    });\n  }\n\n  if (ts.isArrayLiteralExpression(node)) {\n    return node.elements.flatMap((element) =>\n      ts.isSpreadElement(element)\n        ? collect_assignment_target_names(element.expression)\n        : collect_assignment_target_names(element)\n    );\n  }\n\n  return [];\n}\n","import { contains_top_level_yield_star } from \"$/detect.ts\";\nimport {\n  collect_top_level_binding_names,\n  has_local_import_binding,\n  make_imports,\n} from \"./imports.ts\";\nimport { create_source_map, slice } from \"./source.ts\";\nimport { AwaitInEffectWorkError, PreprocessError } from \"$/error.ts\";\nimport { make_runtime_block_with_bindings } from \"./runtime-block.ts\";\nimport { contains_top_level_await } from \"./ast.ts\";\nimport { lower_statement } from \"./lower.ts\";\nimport { validate_rune_yield_usage } from \"./runes.ts\";\nimport type {\n  BlockRef,\n  EffectBlock,\n  RuntimeImportBindings,\n  ScriptLoweringContext,\n  ScriptTransformResult,\n} from \"./types.ts\";\n\nimport MagicString from \"magic-string\";\nimport ts from \"typescript\";\n\nexport type { BlockRef, ScriptTransformResult } from \"./types.ts\";\n\ninterface ScriptTransformOptions {\n  emit_types?: boolean;\n}\n\n/**\n * Transforms a `<script effect>` body by extracting top-level `yield*`\n * expressions into `$state` temp bindings and wrapping the lowered\n * assignments in a dependency-tracked `$effect` block.\n *\n * @example\n * ```ts\n * const result = transform_script_effect(\n *   `let user = $state(yield* getUser(id));`,\n *   \"App.svelte\",\n * );\n * ```\n *\n * @since 2.0.0\n * @param content - The raw `<script effect>` body content.\n * @param filename - The source filename, used in error messages.\n * @param options - Optional transform settings for generated script code.\n * @returns The transformed code and any block references.\n */\nexport function transform_script_effect(\n  content: string,\n  filename: string,\n  options: ScriptTransformOptions = {},\n): ScriptTransformResult {\n  let temp_counter = 0;\n\n  const source_file = ts.createSourceFile(\n    filename,\n    content,\n    ts.ScriptTarget.Latest,\n    true,\n    ts.ScriptKind.TS,\n  );\n\n  const magic = new MagicString(content);\n  const effect_blocks: EffectBlock[] = [];\n  const block_refs: BlockRef[] = [];\n  const top_level_binding_names = collect_top_level_binding_names(source_file);\n  const top_level_binding_names_set = new Set(top_level_binding_names);\n  const name_allocator = make_name_allocator(top_level_binding_names);\n  const emit_types = options.emit_types ?? true;\n\n  let has_effect = false;\n\n  /** Phase 1: detect imports already provided by the user. */\n  const has_effect_import = has_local_import_binding(\n    source_file,\n    \"effect\",\n    \"Effect\",\n  );\n\n  const has_dispatcher_import = has_local_import_binding(\n    source_file,\n    \"svelte-effect-runtime/internal/generators\",\n    \"get_dispatcher\",\n  );\n\n  const has_untrack_import = has_local_import_binding(\n    source_file,\n    \"svelte\",\n    \"untrack\",\n  );\n\n  const reserve_runtime_import = (name: string) =>\n    top_level_binding_names_set.has(name)\n      ? name_allocator.reserve(make_generated_name(name, \"\"))\n      : name_allocator.reserve(name);\n\n  const runtime_bindings: RuntimeImportBindings = {\n    cancel: name_allocator.reserve(\"__SER___cancel\"),\n    dispatcher: has_dispatcher_import\n      ? \"get_dispatcher\"\n      : reserve_runtime_import(\"get_dispatcher\"),\n    dispatcher_value: name_allocator.reserve(\"__SER___dispatcher\"),\n    effect: has_effect_import ? \"Effect\" : reserve_runtime_import(\"Effect\"),\n    program: name_allocator.reserve(\"__SER___program\"),\n    untrack: has_untrack_import ? \"untrack\" : reserve_runtime_import(\"untrack\"),\n  };\n\n  const context: ScriptLoweringContext = {\n    effect_name: runtime_bindings.effect,\n    emit_types,\n    next_temp_name(hint?: string) {\n      const suffix = temp_counter === 0 ? \"\" : `_${temp_counter}`;\n      const name = make_generated_name(hint ?? String(temp_counter), suffix);\n\n      temp_counter += 1;\n\n      return name_allocator.reserve(name);\n    },\n    next_type_helper_name(hint?: string) {\n      return name_allocator.reserve(\n        make_generated_name(`type_${hint ?? \"effect\"}`, \"\"),\n      );\n    },\n  };\n\n  /** Phase 2: lower every top-level statement that contains `yield*`. */\n  for (const stmt of source_file.statements) {\n    validate_rune_yield_usage(stmt, content, filename);\n    validate_script_yield_boundaries(stmt, content, filename);\n\n    const has_top_level_yield_star = contains_top_level_yield_star(stmt);\n\n    if (!has_top_level_yield_star) {\n      continue;\n    }\n\n    if (contains_top_level_await(stmt)) {\n      const text = slice(content, stmt);\n      throw new AwaitInEffectWorkError(filename, text);\n    }\n\n    has_effect = true;\n    const lowered = lower_statement(stmt, content, context);\n\n    magic.overwrite(\n      lowered.range.start,\n      lowered.range.end,\n      lowered.rewritten_text,\n    );\n\n    if (lowered.temps.length > 0 || lowered.type_helpers?.length) {\n      const temp_declarations = lowered.temps.map((temp) =>\n        temp.type\n          ? `let ${temp.name} = $state<${temp.type}>(undefined);`\n          : `let ${temp.name} = $state(undefined);`\n      );\n\n      const prefix = [\n        ...(lowered.type_helpers ?? []),\n        ...temp_declarations,\n      ].join(\"\\n\");\n\n      magic.appendLeft(lowered.range.start, prefix + \"\\n\");\n    }\n\n    effect_blocks.push(...lowered.effect_blocks);\n  }\n\n  if (!has_effect) {\n    block_refs.push({ id: filename, kind: \"script\" });\n\n    return { code: content, blocks: block_refs };\n  }\n\n  /** Phase 3: inject runtime imports after the last user import. */\n  const imports = make_imports(\n    has_effect_import,\n    has_dispatcher_import,\n    has_untrack_import,\n    runtime_bindings,\n  );\n\n  const last_import = [...source_file.statements]\n    .reverse()\n    .find(ts.isImportDeclaration);\n\n  if (last_import) {\n    magic.appendRight(last_import.end, \"\\n\" + imports);\n  } else {\n    magic.prepend(imports + \"\\n\");\n  }\n\n  /** Phase 4: append the runtime program and lifecycle wiring. */\n  const runtime_block = make_runtime_block_with_bindings(\n    effect_blocks,\n    runtime_bindings,\n  );\n  magic.append(\"\\n\" + runtime_block);\n\n  block_refs.push({ id: filename, kind: \"script\" });\n\n  return {\n    code: magic.toString(),\n    blocks: block_refs,\n    map: create_source_map(magic, filename),\n  };\n}\n\nfunction validate_script_yield_boundaries(\n  stmt: ts.Statement,\n  content: string,\n  filename: string,\n): void {\n  const bad_member = find_class_member_with_yield_star(stmt);\n\n  if (!bad_member) {\n    return;\n  }\n\n  throw new PreprocessError(\n    [\n      `[ASYNC_EFFECT_IN_CLASS_MEMBER]: ${filename}: yield* cannot be used inside class members.`,\n      `Class fields and methods are not component top-level reactive work. Move the Effect work into a script effect statement before assigning it to the class instance.`,\n      \"\",\n      \"Problematic member:\",\n      slice(content, bad_member),\n    ].join(\"\\n\"),\n    filename,\n  );\n}\n\nfunction find_class_member_with_yield_star(\n  stmt: ts.Statement,\n): ts.Node | undefined {\n  let found: ts.Node | undefined;\n\n  function visit(node: ts.Node): void {\n    if (found) {\n      return;\n    }\n\n    if (\n      ts.isPropertyDeclaration(node) &&\n      node.initializer &&\n      contains_top_level_yield_star(node.initializer)\n    ) {\n      found = node;\n      return;\n    }\n\n    node.forEachChild(visit);\n  }\n\n  visit(stmt);\n\n  return found;\n}\n\nfunction make_name_allocator(initial_names: readonly string[]): {\n  reserve(name: string): string;\n} {\n  const used_names = new Set(initial_names);\n\n  return {\n    reserve(name: string): string {\n      let candidate = name;\n      let suffix = 1;\n\n      while (used_names.has(candidate)) {\n        candidate = `${name}_${suffix}`;\n        suffix += 1;\n      }\n\n      used_names.add(candidate);\n\n      return candidate;\n    },\n  };\n}\n\nfunction make_generated_name(hint: string, suffix: string): string {\n  const normalized_hint = hint.replace(/[^A-Za-z0-9_$]/g, \"_\");\n  const safe_hint = /^[A-Za-z_$]/.test(normalized_hint)\n    ? normalized_hint\n    : `temp_${normalized_hint}`;\n\n  return `__SER___${safe_hint}${suffix}`;\n}\n"],"mappings":"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"}

package/.dist/chunks/transform-BDfspL1K.js

@@ -0,0 +1,59 @@
+import { t as transform_markup_effect } from "./transform-Cx5bjmP6.js";
+import { t as transform_script_effect } from "./preprocess-DseI9Doo.js";
+//#region src/runtime/transform.ts
+/**
+* Lowers SER syntax in a complete Svelte component without using Svelte's
+* preprocessor adapter API.
+*
+* @example
+* ```ts
+* const result = transform_svelte_effect(
+*   "<script effect>const value = yield* load()<\/script>",
+*   "App.svelte",
+* );
+* ```
+*
+* @since 2.5.0
+* @param content - Full Svelte component source to lower before Svelte parses
+*   it.
+* @param filename - Component filename used in generated cache identifiers and
+*   diagnostics.
+* @returns The transformed component source.
+*/
+function transform_svelte_effect(content, filename = "unknown.svelte") {
+	const script = find_script(content);
+	let combined = content;
+	if (script?.has_effect) {
+		const result = transform_script_effect(script.text, filename, { emit_types: script.is_typescript });
+		combined = content.slice(0, script.effect_attr_start) + content.slice(script.effect_attr_end, script.open_end) + result.code + content.slice(script.close_start);
+	}
+	return { code: transform_markup_effect(combined, filename).code };
+}
+function find_script(content) {
+	for (const match of content.matchAll(/<script\b([^>]*)>([\s\S]*?)<\/script\s*>/gi)) {
+		if (match.index === void 0 || /\bmodule\b/.test(match[1] ?? "")) continue;
+		const attrs = match[1] ?? "";
+		const effect_match = /\s+effect(?:\s*=\s*(?:"[^"]*"|'[^']*'|[^\s>]+))?/.exec(attrs);
+		const open_end = match.index + match[0].indexOf(">") + 1;
+		const attr_start = effect_match?.index ?? attrs.length;
+		const attr_end = attr_start + (effect_match?.[0].length ?? 0);
+		return {
+			text: match[2],
+			open_end,
+			close_start: match.index + match[0].lastIndexOf("<"),
+			has_effect: effect_match !== null,
+			effect_attr_start: match.index + 7 + attr_start,
+			effect_attr_end: match.index + 7 + attr_end,
+			is_typescript: has_typescript_lang(attrs)
+		};
+	}
+}
+function has_typescript_lang(attrs) {
+	const lang_match = /\blang\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/i.exec(attrs);
+	const lang = (lang_match?.[1] ?? lang_match?.[2] ?? lang_match?.[3] ?? "").toLowerCase();
+	return lang === "ts" || lang === "typescript";
+}
+//#endregion
+export { transform_svelte_effect as t };
+
+//# sourceMappingURL=transform-BDfspL1K.js.map

package/.dist/chunks/transform-BDfspL1K.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-BDfspL1K.js","names":[],"sources":["../../../modules/svelte-effect-runtime/src/runtime/transform.ts"],"sourcesContent":["import { transform_markup_effect } from \"$/markup/transform.ts\";\nimport { transform_script_effect } from \"$/preprocess.ts\";\n\n/**\n * Result returned by the direct whole-file Svelte transform.\n *\n * @example\n * ```ts\n * const result = transform_svelte_effect(\"<p>{yield* load()}</p>\", \"App.svelte\");\n * result.code;\n * ```\n *\n * @since 2.5.0\n */\nexport interface SvelteTransformResult {\n  /** Transformed Svelte source. */\n  code: string;\n}\n\n/**\n * Lowers SER syntax in a complete Svelte component without using Svelte's\n * preprocessor adapter API.\n *\n * @example\n * ```ts\n * const result = transform_svelte_effect(\n *   \"<script effect>const value = yield* load()</script>\",\n *   \"App.svelte\",\n * );\n * ```\n *\n * @since 2.5.0\n * @param content - Full Svelte component source to lower before Svelte parses\n *   it.\n * @param filename - Component filename used in generated cache identifiers and\n *   diagnostics.\n * @returns The transformed component source.\n */\nexport function transform_svelte_effect(\n  content: string,\n  filename = \"unknown.svelte\",\n): SvelteTransformResult {\n  const script = find_script(content);\n\n  let combined = content;\n\n  if (script?.has_effect) {\n    const result = transform_script_effect(script.text, filename, {\n      emit_types: script.is_typescript,\n    });\n\n    combined = content.slice(0, script.effect_attr_start) +\n      content.slice(script.effect_attr_end, script.open_end) +\n      result.code +\n      content.slice(script.close_start);\n  }\n\n  const result = transform_markup_effect(combined, filename);\n\n  return { code: result.code };\n}\n\nfunction find_script(content: string):\n  | {\n    text: string;\n    open_end: number;\n    close_start: number;\n    has_effect: boolean;\n    effect_attr_start: number;\n    effect_attr_end: number;\n    is_typescript: boolean;\n  }\n  | undefined {\n  const pattern = /<script\\b([^>]*)>([\\s\\S]*?)<\\/script\\s*>/gi;\n\n  for (const match of content.matchAll(pattern)) {\n    if (match.index === undefined || /\\bmodule\\b/.test(match[1] ?? \"\")) {\n      continue;\n    }\n\n    const attrs = match[1] ?? \"\";\n    const effect_match = /\\s+effect(?:\\s*=\\s*(?:\"[^\"]*\"|'[^']*'|[^\\s>]+))?/\n      .exec(attrs);\n    const open_end = match.index + match[0].indexOf(\">\") + 1;\n    const attr_start = effect_match?.index ?? attrs.length;\n    const attr_end = attr_start + (effect_match?.[0].length ?? 0);\n\n    return {\n      text: match[2],\n      open_end,\n      close_start: match.index + match[0].lastIndexOf(\"<\"),\n      has_effect: effect_match !== null,\n      effect_attr_start: match.index + \"<script\".length + attr_start,\n      effect_attr_end: match.index + \"<script\".length + attr_end,\n      is_typescript: has_typescript_lang(attrs),\n    };\n  }\n\n  return undefined;\n}\n\nfunction has_typescript_lang(attrs: string): boolean {\n  const lang_match = /\\blang\\s*=\\s*(?:\"([^\"]*)\"|'([^']*)'|([^\\s>]+))/i.exec(\n    attrs,\n  );\n  const lang = (lang_match?.[1] ?? lang_match?.[2] ?? lang_match?.[3] ?? \"\")\n    .toLowerCase();\n\n  return lang === \"ts\" || lang === \"typescript\";\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,wBACd,SACA,WAAW,kBACY;CACvB,MAAM,SAAS,YAAY,OAAO;CAElC,IAAI,WAAW;CAEf,IAAI,QAAQ,YAAY;EACtB,MAAM,SAAS,wBAAwB,OAAO,MAAM,UAAU,EAC5D,YAAY,OAAO,cACrB,CAAC;EAED,WAAW,QAAQ,MAAM,GAAG,OAAO,iBAAiB,IAClD,QAAQ,MAAM,OAAO,iBAAiB,OAAO,QAAQ,IACrD,OAAO,OACP,QAAQ,MAAM,OAAO,WAAW;CACpC;CAIA,OAAO,EAAE,MAFM,wBAAwB,UAAU,QAE7B,EAAE,KAAK;AAC7B;AAEA,SAAS,YAAY,SAUP;CAGZ,KAAK,MAAM,SAAS,QAAQ,SAAS,4CAAO,GAAG;EAC7C,IAAI,MAAM,UAAU,KAAA,KAAa,aAAa,KAAK,MAAM,MAAM,EAAE,GAC/D;EAGF,MAAM,QAAQ,MAAM,MAAM;EAC1B,MAAM,eAAe,mDAClB,KAAK,KAAK;EACb,MAAM,WAAW,MAAM,QAAQ,MAAM,GAAG,QAAQ,GAAG,IAAI;EACvD,MAAM,aAAa,cAAc,SAAS,MAAM;EAChD,MAAM,WAAW,cAAc,eAAe,GAAG,UAAU;EAE3D,OAAO;GACL,MAAM,MAAM;GACZ;GACA,aAAa,MAAM,QAAQ,MAAM,GAAG,YAAY,GAAG;GACnD,YAAY,iBAAiB;GAC7B,mBAAmB,MAAM,QAAQ,IAAmB;GACpD,iBAAiB,MAAM,QAAQ,IAAmB;GAClD,eAAe,oBAAoB,KAAK;EAC1C;CACF;AAGF;AAEA,SAAS,oBAAoB,OAAwB;CACnD,MAAM,aAAa,kDAAkD,KACnE,KACF;CACA,MAAM,QAAQ,aAAa,MAAM,aAAa,MAAM,aAAa,MAAM,IACpE,YAAY;CAEf,OAAO,SAAS,QAAQ,SAAS;AACnC"}