more replacements, plus a compiler error

Author: Rich-Harris

.changeset/dirty-donuts-yell.md

@@ -0,0 +1,5 @@
+---
+'svelte': patch
+---
+
+breaking: replace `$derived.call` with `$derived.by`

packages/svelte/src/compiler/errors.js

@@ -208,7 +208,8 @@ const runes = {
 	'invalid-runes-mode-import': (name) => `${name} cannot be used in runes mode`,
 	'duplicate-props-rune': () => `Cannot use $props() more than once`,
 	'invalid-each-assignment': () =>
-		`Cannot reassign or bind to each block argument in runes mode. Use the array and index variables instead (e.g. 'array[i] = value' instead of 'entry = value')`
+		`Cannot reassign or bind to each block argument in runes mode. Use the array and index variables instead (e.g. 'array[i] = value' instead of 'entry = value')`,
+	'invalid-derived-call': () => `$derived.call(...) has been replaced with $derived.by(...)`
 };
 
 /** @satisfies {Errors} */

packages/svelte/src/compiler/phases/scope.js

@@ -717,6 +717,8 @@ export function get_rune(node, scope) {
 	if (n.type !== 'Identifier') return null;
 
 	joined = n.name + joined;
+
+	if (joined === '$derived.call') error(node, 'invalid-derived-call');
 	if (!Runes.includes(/** @type {any} */ (joined))) return null;
 
 	const binding = scope.get(n.name);

sites/svelte-5-preview/src/lib/CodeMirror.svelte

@@ -208,8 +208,8 @@
 				{ label: '$state', type: 'keyword', boost: 10 },
 				{ label: '$props', type: 'keyword', boost: 9 },
 				{ label: '$derived', type: 'keyword', boost: 8 },
-				snip('$derived.call(() => {\n\t${}\n});', {
-					label: '$derived.call',
+				snip('$derived.by(() => {\n\t${}\n});', {
+					label: '$derived.by',
 					type: 'keyword',
 					boost: 7
 				}),

sites/svelte-5-preview/src/routes/docs/content/01-api/02-runes.md

@@ -134,14 +134,14 @@ If the value of a reactive variable is being computed it should be replaced with
   ```
   ...`double` will be calculated first despite the source order. In runes mode, `triple` cannot reference `double` before it has been declared.
 
-## `$derived.call`
+## `$derived.by`
 
-Sometimes you need to create complex derivations that don't fit inside a short expression. In these cases, you can use `$derived.call` which accepts a function as its argument.
+Sometimes you need to create complex derivations that don't fit inside a short expression. In these cases, you can use `$derived.by` which accepts a function as its argument.
 
 ```svelte
 <script>
 	let numbers = $state([1, 2, 3]);
-	let total = $derived.call(() => {
+	let total = $derived.by(() => {
 		let total = 0;
 		for (const n of numbers) {
 			total += n;
@@ -155,7 +155,7 @@ Sometimes you need to create complex derivations that don't fit inside a short e
 </button>
 ```
 
-In essence, `$derived(expression)` is equivalent to `$derived.call(() => expression)`.
+In essence, `$derived(expression)` is equivalent to `$derived.by(() => expression)`.
 
 ## `$effect`