From d822c50b758d3ce387af555f79f3a09403d24a2f Mon Sep 17 00:00:00 2001
From: Simon Holthausen <simon.holthausen@vercel.com>
Date: Thu, 8 Oct 2026 15:26:50 +0200
Subject: [PATCH] ensure offscreen each items always last; reschedule effects
 from earlier batches when unskipping

---
 .../src/internal/client/dom/blocks/each.js    |  7 +++
 .../src/internal/client/reactivity/batch.js   | 24 +++++++----
 .../async-each-item-skipped-stale/_config.js  | 34 +++++++++++++++
 .../async-each-item-skipped-stale/main.svelte | 35 +++++++++++++++
 .../_config.js                                | 28 ++++++++++++
 .../main.svelte                               | 23 ++++++++++
 .../async-if-skipped-branch-stale/_config.js  | 34 +++++++++++++++
 .../async-if-skipped-branch-stale/main.svelte | 43 +++++++++++++++++++
 8 files changed, 219 insertions(+), 9 deletions(-)
 create mode 100644 packages/svelte/tests/runtime-runes/samples/async-each-item-skipped-stale/_config.js
 create mode 100644 packages/svelte/tests/runtime-runes/samples/async-each-item-skipped-stale/main.svelte
 create mode 100644 packages/svelte/tests/runtime-runes/samples/async-each-keyed-order-overlapping/_config.js
 create mode 100644 packages/svelte/tests/runtime-runes/samples/async-each-keyed-order-overlapping/main.svelte
 create mode 100644 packages/svelte/tests/runtime-runes/samples/async-if-skipped-branch-stale/_config.js
 create mode 100644 packages/svelte/tests/runtime-runes/samples/async-if-skipped-branch-stale/main.svelte

diff --git a/packages/svelte/src/internal/client/dom/blocks/each.js b/packages/svelte/src/internal/client/dom/blocks/each.js
index 35b6430b60..877eb3ff84 100644
--- a/packages/svelte/src/internal/client/dom/blocks/each.js
+++ b/packages/svelte/src/internal/client/dom/blocks/each.js
@@ -166,6 +166,13 @@ function destroy_effects(state, to_destroy, remove_dom = true) {
 
 			const fragment = document.createDocumentFragment();
 			move_effect(e, fragment);
+
+			// `reconcile` expects offscreen items to come after all onscreen items
+			if (e !== state.effect.last) {
+				link(state, e.prev, e.next);
+				link(state, state.effect.last, e);
+				link(state, e, null);
+			}
 		} else {
 			destroy_effect(to_destroy[i], remove_dom);
 		}
diff --git a/packages/svelte/src/internal/client/reactivity/batch.js b/packages/svelte/src/internal/client/reactivity/batch.js
index 281e6fa0ff..eca4a35c48 100644
--- a/packages/svelte/src/internal/client/reactivity/batch.js
+++ b/packages/svelte/src/internal/client/reactivity/batch.js
@@ -404,18 +404,24 @@ export class Batch {
 	 * @param {Effect} effect
 	 */
 	unskip_effect(effect) {
-		var tracked = this.#skipped_branches.get(effect);
-		if (tracked) {
-			this.#skipped_branches.delete(effect);
-
-			for (var e of tracked.d) {
-				this.schedule(e, DIRTY);
-			}
+		for (var batch = /** @type {Batch | null} */ (this); batch !== null; batch = batch.prev) {
+			// Earlier (non-fork) batches that skip this branch have reset the effects inside it that are
+			// dirty because of their changes. This batch sees those changes as well, so it runs them, too
+			var tracked =
+				batch === this || !batch.is_fork ? batch.#skipped_branches.get(effect) : undefined;
+
+			if (tracked) {
+				for (var e of tracked.d) {
+					this.schedule(e, DIRTY);
+				}
 
-			for (e of tracked.m) {
-				this.schedule(e, MAYBE_DIRTY);
+				for (e of tracked.m) {
+					this.schedule(e, MAYBE_DIRTY);
+				}
 			}
 		}
+
+		this.#skipped_branches.delete(effect);
 		this.unskipped_branches.add(effect);
 	}
 
diff --git a/packages/svelte/tests/runtime-runes/samples/async-each-item-skipped-stale/_config.js b/packages/svelte/tests/runtime-runes/samples/async-each-item-skipped-stale/_config.js
new file mode 100644
index 0000000000..6adae749b5
--- /dev/null
+++ b/packages/svelte/tests/runtime-runes/samples/async-each-item-skipped-stale/_config.js
@@ -0,0 +1,34 @@
+import { tick } from 'svelte';
+import { test } from '../../test';
+
+export default test({
+	mode: ['client'],
+	async test({ assert, target }) {
+		await tick();
+
+		const [skip, readd, resolve_earlier, resolve_all] = target.querySelectorAll('button');
+		const buttons =
+			'<button>c = 2, list = [3]</button><button>list = [5, 1]</button><button>resolve 6</button><button>resolve all</button>';
+
+		assert.htmlEqual(target.innerHTML, `${buttons}<s>0|0</s><s>1|1</s>`);
+
+		// the second item is skipped by this batch, which also changes what it shows
+		skip.click();
+		await tick();
+		// the second item is needed again by a later batch
+		readd.click();
+		await tick();
+
+		// resolve the earlier batch first, so that it commits first
+		resolve_earlier.click();
+		await tick();
+		assert.htmlEqual(target.innerHTML, `${buttons}<s>3|6</s>`);
+
+		for (let i = 0; i < 5; i++) {
+			await tick();
+			resolve_all.click();
+		}
+		await tick();
+		assert.htmlEqual(target.innerHTML, `${buttons}<s>5|10</s><s>1|2</s>`);
+	}
+});
diff --git a/packages/svelte/tests/runtime-runes/samples/async-each-item-skipped-stale/main.svelte b/packages/svelte/tests/runtime-runes/samples/async-each-item-skipped-stale/main.svelte
new file mode 100644
index 0000000000..b5347b9832
--- /dev/null
+++ b/packages/svelte/tests/runtime-runes/samples/async-each-item-skipped-stale/main.svelte
@@ -0,0 +1,35 @@
+<script>
+	let list = $state([0, 1]);
+	let c = $state(1);
+	const queued = [];
+
+	function delay(value) {
+		return new Promise((resolve) => queued.push({ value, resolve: () => resolve(value) }));
+	}
+
+	function resolve(value) {
+		for (const r of queued.filter((r) => r.value === value)) {
+			queued.splice(queued.indexOf(r), 1);
+			r.resolve();
+		}
+	}
+
+	function resolve_all() {
+		for (const r of queued.splice(0)) r.resolve();
+	}
+
+	// nothing (including the buttons) shows up until the initial render resolves
+	queueMicrotask(resolve_all);
+</script>
+
+<button
+	onclick={() => {
+		c = 2;
+		list = [3];
+	}}>c = 2, list = [3]</button
+>
+<button onclick={() => (list = [5, 1])}>list = [5, 1]</button>
+<button onclick={() => resolve(6)}>resolve 6</button>
+<button onclick={resolve_all}>resolve all</button>
+
+{#each list as x}<s>{x}|{await delay(x * c)}</s>{/each}
diff --git a/packages/svelte/tests/runtime-runes/samples/async-each-keyed-order-overlapping/_config.js b/packages/svelte/tests/runtime-runes/samples/async-each-keyed-order-overlapping/_config.js
new file mode 100644
index 0000000000..09f57c9166
--- /dev/null
+++ b/packages/svelte/tests/runtime-runes/samples/async-each-keyed-order-overlapping/_config.js
@@ -0,0 +1,28 @@
+import { tick } from 'svelte';
+import { test } from '../../test';
+
+export default test({
+	mode: ['client'],
+	async test({ assert, target }) {
+		await tick();
+
+		const [set_b, list_1, list_2, resolve_all] = target.querySelectorAll('button');
+		const buttons =
+			'<button>b = 2</button><button>list = [2, 1]</button><button>list = [2, 0, 3]</button><button>resolve all</button>';
+
+		assert.htmlEqual(target.innerHTML, `${buttons}<b>0</b><b>1</b>`);
+
+		set_b.click();
+		await tick();
+		list_1.click();
+		await tick();
+		list_2.click();
+
+		for (let i = 0; i < 5; i++) {
+			await tick();
+			resolve_all.click();
+		}
+		await tick();
+		assert.htmlEqual(target.innerHTML, `${buttons}<b>4</b><b>2</b><b>5</b>`);
+	}
+});
diff --git a/packages/svelte/tests/runtime-runes/samples/async-each-keyed-order-overlapping/main.svelte b/packages/svelte/tests/runtime-runes/samples/async-each-keyed-order-overlapping/main.svelte
new file mode 100644
index 0000000000..ec5153cd84
--- /dev/null
+++ b/packages/svelte/tests/runtime-runes/samples/async-each-keyed-order-overlapping/main.svelte
@@ -0,0 +1,23 @@
+<script>
+	let list = $state([0, 1]);
+	let b = $state(0);
+	const queued = [];
+
+	function delay(value) {
+		return new Promise((resolve) => queued.push(() => resolve(value)));
+	}
+
+	function resolve_all() {
+		for (const r of queued.splice(0)) r();
+	}
+
+	// nothing (including the buttons) shows up until the initial render resolves
+	queueMicrotask(resolve_all);
+</script>
+
+<button onclick={() => (b = 2)}>b = 2</button>
+<button onclick={() => (list = [2, 1])}>list = [2, 1]</button>
+<button onclick={() => (list = [2, 0, 3])}>list = [2, 0, 3]</button>
+<button onclick={resolve_all}>resolve all</button>
+
+{#each list as x (x)}<b>{await delay(x + b)}</b>{/each}
diff --git a/packages/svelte/tests/runtime-runes/samples/async-if-skipped-branch-stale/_config.js b/packages/svelte/tests/runtime-runes/samples/async-if-skipped-branch-stale/_config.js
new file mode 100644
index 0000000000..dad1f1b244
--- /dev/null
+++ b/packages/svelte/tests/runtime-runes/samples/async-if-skipped-branch-stale/_config.js
@@ -0,0 +1,34 @@
+import { tick } from 'svelte';
+import { test } from '../../test';
+
+export default test({
+	mode: ['client'],
+	async test({ assert, target }) {
+		await tick();
+
+		const [skip, show, resolve_earlier, resolve_all] = target.querySelectorAll('button');
+		const buttons =
+			'<button>b = 1, show = false</button><button>c = 1, show = true</button><button>resolve p1</button><button>resolve all</button>';
+
+		assert.htmlEqual(target.innerHTML, `${buttons}<p>p0</p><u>c0</u><i>i0</i>`);
+
+		// the branch is skipped by this batch, which also changes what the branch shows
+		skip.click();
+		await tick();
+		// the branch is needed again by a later batch
+		show.click();
+		await tick();
+
+		// resolve the earlier batch first, so that it commits first
+		resolve_earlier.click();
+		await tick();
+		assert.htmlEqual(target.innerHTML, `${buttons}<p>p1</p><u>c0</u>`);
+
+		for (let i = 0; i < 5; i++) {
+			await tick();
+			resolve_all.click();
+		}
+		await tick();
+		assert.htmlEqual(target.innerHTML, `${buttons}<p>p1</p><u>c1</u><i>i1</i>`);
+	}
+});
diff --git a/packages/svelte/tests/runtime-runes/samples/async-if-skipped-branch-stale/main.svelte b/packages/svelte/tests/runtime-runes/samples/async-if-skipped-branch-stale/main.svelte
new file mode 100644
index 0000000000..c903b007f1
--- /dev/null
+++ b/packages/svelte/tests/runtime-runes/samples/async-if-skipped-branch-stale/main.svelte
@@ -0,0 +1,43 @@
+<script>
+	let show = $state(true);
+	let b = $state(0);
+	let c = $state(0);
+	const queued = [];
+
+	function delay(value) {
+		return new Promise((resolve) => queued.push({ value, resolve: () => resolve(value) }));
+	}
+
+	function resolve(value) {
+		for (const r of queued.filter((r) => r.value === value)) {
+			queued.splice(queued.indexOf(r), 1);
+			r.resolve();
+		}
+	}
+
+	function resolve_all() {
+		for (const r of queued.splice(0)) r.resolve();
+	}
+
+	// nothing (including the buttons) shows up until the initial render resolves
+	queueMicrotask(resolve_all);
+</script>
+
+<button
+	onclick={() => {
+		b = 1;
+		show = false;
+	}}>b = 1, show = false</button
+>
+<button
+	onclick={() => {
+		c = 1;
+		show = true;
+	}}>c = 1, show = true</button
+>
+<button onclick={() => resolve('p1')}>resolve p1</button>
+<button onclick={resolve_all}>resolve all</button>
+
+<p>{await delay('p' + b)}</p>
+<u>{await delay('c' + c)}</u>
+{#if show}<i>{await delay('i' + b)}</i>{/if}