From 5aff44a83fde800631d73737384c839bbfcee80a Mon Sep 17 00:00:00 2001
From: ComputerGuy <63362464+Ocean-OS@users.noreply.github.com>
Date: Mon, 21 Jul 2025 02:20:33 -0700
Subject: [PATCH] rename to `$effect.allowed`

---
 .changeset/two-dancers-speak.md                    |  2 +-
 documentation/docs/02-runes/04-$effect.md          | 12 ++++++------
 packages/svelte/src/ambient.d.ts                   | 14 +++++++-------
 .../phases/2-analyze/visitors/CallExpression.js    |  2 +-
 .../3-transform/client/visitors/CallExpression.js  |  4 ++--
 .../3-transform/server/visitors/CallExpression.js  |  2 +-
 packages/svelte/src/internal/client/index.js       |  2 +-
 .../src/internal/client/reactivity/effects.js      | 10 +++++-----
 packages/svelte/src/utils.js                       |  2 +-
 .../samples/effect-active-rune/_config.js          |  8 ++++++++
 .../samples/effect-active-rune/main.svelte.js      |  1 +
 packages/svelte/tests/signals/test.ts              | 14 +++++++-------
 packages/svelte/types/index.d.ts                   | 14 +++++++-------
 13 files changed, 48 insertions(+), 39 deletions(-)
 create mode 100644 packages/svelte/tests/compiler-errors/samples/effect-active-rune/_config.js
 create mode 100644 packages/svelte/tests/compiler-errors/samples/effect-active-rune/main.svelte.js

diff --git a/.changeset/two-dancers-speak.md b/.changeset/two-dancers-speak.md
index 7044eaa329..b0d8d394d0 100644
--- a/.changeset/two-dancers-speak.md
+++ b/.changeset/two-dancers-speak.md
@@ -2,4 +2,4 @@
 'svelte': minor
 ---
 
-feat: add `$effect.active` rune
+feat: add `$effect.allowed` rune
diff --git a/documentation/docs/02-runes/04-$effect.md b/documentation/docs/02-runes/04-$effect.md
index 4a27a72778..59010c981f 100644
--- a/documentation/docs/02-runes/04-$effect.md
+++ b/documentation/docs/02-runes/04-$effect.md
@@ -255,22 +255,22 @@ const destroy = $effect.root(() => {
 destroy();
 ```
 
-## `$effect.active`
+## `$effect.allowed`
 
-The `$effect.active` rune is an advanced feature that indicates whether or not an effect or [async `$derived`](await-expressions) can be created in the current context. To improve performance and memory efficiency, effects and async deriveds can only be created when a root effect is active. Root effects are created during component setup, but they can also be programmatically created via `$effect.root`. 
+The `$effect.allowed` rune is an advanced feature that indicates whether or not an effect or [async `$derived`](await-expressions) can be created in the current context. To improve performance and memory efficiency, effects and async deriveds can only be created when a root effect is active. Root effects are created during component setup, but they can also be programmatically created via `$effect.root`. 
 
 ```svelte
 <script>
-	console.log('in component setup', $effect.active()); // true
+	console.log('in component setup', $effect.allowed()); // true
 
 	function onclick() {
-		console.log('after component setup', $effect.active()); // false
+		console.log('after component setup', $effect.allowed()); // false
 	}
 	function ondblclick() {
 		$effect.root(() => {
-			console.log('in root effect', $effect.active()); // true
+			console.log('in root effect', $effect.allowed()); // true
 			return () => {
-				console.log('in effect teardown', $effect.active()); // false
+				console.log('in effect teardown', $effect.allowed()); // false
 			}
 		})();
 	}
diff --git a/packages/svelte/src/ambient.d.ts b/packages/svelte/src/ambient.d.ts
index cc395995cc..5245626d53 100644
--- a/packages/svelte/src/ambient.d.ts
+++ b/packages/svelte/src/ambient.d.ts
@@ -238,22 +238,22 @@ declare function $effect(fn: () => void | (() => void)): void;
 
 declare namespace $effect {
 	/**
-	 * The `$effect.active` rune is an advanced feature that indicates whether an effect or async `$derived` can be created in the current context.
+	 * The `$effect.allowed` rune is an advanced feature that indicates whether an effect or async `$derived` can be created in the current context.
 	 * Effects and async deriveds can only be created in root effects, which are created during component setup, or can be programmatically created via `$effect.root`.
 	 *
 	 * Example:
 	 * ```svelte
 	 * <script>
-	 *   console.log('in component setup', $effect.active()); // true
+	 *   console.log('in component setup', $effect.allowed()); // true
 	 *
 	 *   function onclick() {
-	 *     console.log('after component setup', $effect.active()); // false
+	 *     console.log('after component setup', $effect.allowed()); // false
 	 *   }
 	 *   function ondblclick() {
 	 *     $effect.root(() => {
-	 *       console.log('in root effect', $effect.active()); // true
+	 *       console.log('in root effect', $effect.allowed()); // true
 	 *       return () => {
-	 *         console.log('in effect teardown', $effect.active()); // false
+	 *         console.log('in effect teardown', $effect.allowed()); // false
 	 *       }
 	 *     })();
 	 *   }
@@ -262,9 +262,9 @@ declare namespace $effect {
 	 * <button {ondblclick}>Click me twice!</button>
 	 * ```
 	 *
-	 * https://svelte.dev/docs/svelte/$effect#$effect.active
+	 * https://svelte.dev/docs/svelte/$effect#$effect.allowed
 	 */
-	export function active(): boolean;
+	export function allowed(): boolean;
 	/**
 	 * Runs code right before a component is mounted to the DOM, and then whenever its dependencies change, i.e. `$state` or `$derived` values.
 	 * The timing of the execution is right before the DOM is updated.
diff --git a/packages/svelte/src/compiler/phases/2-analyze/visitors/CallExpression.js b/packages/svelte/src/compiler/phases/2-analyze/visitors/CallExpression.js
index 25cff4bfe0..b4c5d4fdc4 100644
--- a/packages/svelte/src/compiler/phases/2-analyze/visitors/CallExpression.js
+++ b/packages/svelte/src/compiler/phases/2-analyze/visitors/CallExpression.js
@@ -150,7 +150,7 @@ export function CallExpression(node, context) {
 
 			break;
 
-		case '$effect.active':
+		case '$effect.allowed':
 		case '$effect.tracking':
 			if (node.arguments.length !== 0) {
 				e.rune_invalid_arguments(node, rune);
diff --git a/packages/svelte/src/compiler/phases/3-transform/client/visitors/CallExpression.js b/packages/svelte/src/compiler/phases/3-transform/client/visitors/CallExpression.js
index 746c051e3f..1b5c2fa2da 100644
--- a/packages/svelte/src/compiler/phases/3-transform/client/visitors/CallExpression.js
+++ b/packages/svelte/src/compiler/phases/3-transform/client/visitors/CallExpression.js
@@ -17,8 +17,8 @@ export function CallExpression(node, context) {
 		case '$host':
 			return b.id('$$props.$$host');
 
-		case '$effect.active':
-			return b.call('$.effect_active');
+		case '$effect.allowed':
+			return b.call('$.effect_allowed');
 
 		case '$effect.tracking':
 			return b.call('$.effect_tracking');
diff --git a/packages/svelte/src/compiler/phases/3-transform/server/visitors/CallExpression.js b/packages/svelte/src/compiler/phases/3-transform/server/visitors/CallExpression.js
index 64d4f573c5..e4c6fc66ab 100644
--- a/packages/svelte/src/compiler/phases/3-transform/server/visitors/CallExpression.js
+++ b/packages/svelte/src/compiler/phases/3-transform/server/visitors/CallExpression.js
@@ -16,7 +16,7 @@ export function CallExpression(node, context) {
 		return b.void0;
 	}
 
-	if (rune === '$effect.tracking' || rune === '$effect.active') {
+	if (rune === '$effect.tracking' || rune === '$effect.allowed') {
 		return b.false;
 	}
 
diff --git a/packages/svelte/src/internal/client/index.js b/packages/svelte/src/internal/client/index.js
index a186cdd86b..a38f2f4173 100644
--- a/packages/svelte/src/internal/client/index.js
+++ b/packages/svelte/src/internal/client/index.js
@@ -107,7 +107,7 @@ export {
 } from './reactivity/deriveds.js';
 export {
 	aborted,
-	effect_active,
+	effect_allowed,
 	effect_tracking,
 	effect_root,
 	legacy_pre_effect,
diff --git a/packages/svelte/src/internal/client/reactivity/effects.js b/packages/svelte/src/internal/client/reactivity/effects.js
index 5eb98c8de7..18167d6bf5 100644
--- a/packages/svelte/src/internal/client/reactivity/effects.js
+++ b/packages/svelte/src/internal/client/reactivity/effects.js
@@ -53,7 +53,7 @@ const EFFECT_TEARDOWN = 3;
  * If not, a value indicating why is returned.
  * @returns {number}
  */
-function active_root_effect() {
+function valid_effect_creation_context() {
 	if (active_effect === null && active_reaction === null) {
 		return EFFECT_ORPHAN;
 	}
@@ -73,7 +73,7 @@ function active_root_effect() {
  * @param {'$effect' | '$effect.pre' | '$inspect'} rune
  */
 export function validate_effect(rune) {
-	const valid_effect_parent = active_root_effect();
+	const valid_effect_parent = valid_effect_creation_context();
 	switch (valid_effect_parent) {
 		case VALID_EFFECT_PARENT:
 			return;
@@ -195,11 +195,11 @@ export function effect_tracking() {
 }
 
 /**
- * Internal representation of `$effect.active()`
+ * Internal representation of `$effect.allowed()`
  * @returns {boolean}
  */
-export function effect_active() {
-	return active_root_effect() === VALID_EFFECT_PARENT;
+export function effect_allowed() {
+	return valid_effect_creation_context() === VALID_EFFECT_PARENT;
 }
 
 /**
diff --git a/packages/svelte/src/utils.js b/packages/svelte/src/utils.js
index f49382921a..231c10c7cf 100644
--- a/packages/svelte/src/utils.js
+++ b/packages/svelte/src/utils.js
@@ -442,7 +442,7 @@ const RUNES = /** @type {const} */ ([
 	'$props.id',
 	'$bindable',
 	'$effect',
-	'$effect.active',
+	'$effect.allowed',
 	'$effect.pre',
 	'$effect.tracking',
 	'$effect.root',
diff --git a/packages/svelte/tests/compiler-errors/samples/effect-active-rune/_config.js b/packages/svelte/tests/compiler-errors/samples/effect-active-rune/_config.js
new file mode 100644
index 0000000000..e12e4046f3
--- /dev/null
+++ b/packages/svelte/tests/compiler-errors/samples/effect-active-rune/_config.js
@@ -0,0 +1,8 @@
+import { test } from '../../test';
+
+export default test({
+	error: {
+		code: 'rune_renamed',
+		message: '`$effect.active` is now `$effect.tracking`'
+	}
+});
diff --git a/packages/svelte/tests/compiler-errors/samples/effect-active-rune/main.svelte.js b/packages/svelte/tests/compiler-errors/samples/effect-active-rune/main.svelte.js
new file mode 100644
index 0000000000..c33c104aac
--- /dev/null
+++ b/packages/svelte/tests/compiler-errors/samples/effect-active-rune/main.svelte.js
@@ -0,0 +1 @@
+$effect.active();
diff --git a/packages/svelte/tests/signals/test.ts b/packages/svelte/tests/signals/test.ts
index 261198fc1c..32aed75b65 100644
--- a/packages/svelte/tests/signals/test.ts
+++ b/packages/svelte/tests/signals/test.ts
@@ -4,7 +4,7 @@ import * as $ from '../../src/internal/client/runtime';
 import { push, pop } from '../../src/internal/client/context';
 import {
 	effect,
-	effect_active,
+	effect_allowed,
 	effect_root,
 	render_effect,
 	user_effect,
@@ -1392,24 +1392,24 @@ describe('signals', () => {
 		};
 	});
 
-	test('$effect.active()', () => {
+	test('$effect.allowed()', () => {
 		const log: Array<string | boolean> = [];
 
 		return () => {
-			log.push('effect orphan', effect_active());
+			log.push('effect orphan', effect_allowed());
 			const destroy = effect_root(() => {
-				log.push('effect root', effect_active());
+				log.push('effect root', effect_allowed());
 				effect(() => {
-					log.push('effect', effect_active());
+					log.push('effect', effect_allowed());
 				});
 				$.get(
 					derived(() => {
-						log.push('derived', effect_active());
+						log.push('derived', effect_allowed());
 						return 1;
 					})
 				);
 				return () => {
-					log.push('effect teardown', effect_active());
+					log.push('effect teardown', effect_allowed());
 				};
 			});
 			flushSync();
diff --git a/packages/svelte/types/index.d.ts b/packages/svelte/types/index.d.ts
index 39e1c54d4c..e1ac803198 100644
--- a/packages/svelte/types/index.d.ts
+++ b/packages/svelte/types/index.d.ts
@@ -3312,22 +3312,22 @@ declare function $effect(fn: () => void | (() => void)): void;
 
 declare namespace $effect {
 	/**
-	 * The `$effect.active` rune is an advanced feature that indicates whether an effect or async `$derived` can be created in the current context.
+	 * The `$effect.allowed` rune is an advanced feature that indicates whether an effect or async `$derived` can be created in the current context.
 	 * Effects and async deriveds can only be created in root effects, which are created during component setup, or can be programmatically created via `$effect.root`.
 	 *
 	 * Example:
 	 * ```svelte
 	 * <script>
-	 *   console.log('in component setup', $effect.active()); // true
+	 *   console.log('in component setup', $effect.allowed()); // true
 	 *
 	 *   function onclick() {
-	 *     console.log('after component setup', $effect.active()); // false
+	 *     console.log('after component setup', $effect.allowed()); // false
 	 *   }
 	 *   function ondblclick() {
 	 *     $effect.root(() => {
-	 *       console.log('in root effect', $effect.active()); // true
+	 *       console.log('in root effect', $effect.allowed()); // true
 	 *       return () => {
-	 *         console.log('in effect teardown', $effect.active()); // false
+	 *         console.log('in effect teardown', $effect.allowed()); // false
 	 *       }
 	 *     })();
 	 *   }
@@ -3336,9 +3336,9 @@ declare namespace $effect {
 	 * <button {ondblclick}>Click me twice!</button>
 	 * ```
 	 *
-	 * https://svelte.dev/docs/svelte/$effect#$effect.active
+	 * https://svelte.dev/docs/svelte/$effect#$effect.allowed
 	 */
-	export function active(): boolean;
+	export function allowed(): boolean;
 	/**
 	 * Runs code right before a component is mounted to the DOM, and then whenever its dependencies change, i.e. `$state` or `$derived` values.
 	 * The timing of the execution is right before the DOM is updated.