perf(frontend): round 6 — coalesced progressive listing, in-place SvelteSet, batch fan-out, t() value cache

Four SPA hot-path fixes, each shipping with a vitest benchmark gate
(verbatim BEFORE replica + equivalence + perf assertion) so CI
re-verifies the win on every run:

- fetchFolderListing invoked onPage after EVERY 200-row page with the
  whole accumulated listing, and the files view re-sorts everything per
  emission — O(N²/page) main-thread work on large folders. Page one and
  the final page always emit; intermediates coalesce to one per 150 ms.
  25×200 load: 30.9 → 4.0 ms (7.8x), 65 000 → 5 200 sorted elements.

- selected/favoriteIds/sharedIds (files) and favoriteIds (recent) were
  $state<Set>s copied whole on every toggle. Now one SvelteSet each,
  mutated in place (the useSelection pattern): 1 000 toggles @ N=5 000
  771.9 → 1.9 ms (399x); one-toggle fan-out across 40 mounted rows
  40 → 3 re-runs when refining a select-all.

- batchDelete/moveInto awaited one request per item serially and
  probed listing.folders.find per id (O(N·M)). Now an id index built
  once + mapLimit(6) fan-out, failure semantics preserved: 100-item
  delete @ 5 ms RTT 525 → 89 ms (5.9x), 38 825 → 500 probes.

- t() re-split its dotted key and walked the nested dict on every call,
  and interpolate regex-scanned strings without placeholders. Resolved
  values now memoize per (dict, key) in a WeakMap + a {{ guard:
  20k mixed calls 22.7 → 8.6 ms (2.63x).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017aJu9ghvuT8WqC31ZEGTBA
This commit is contained in:
Claude
2026-07-18 00:54:38 +00:00
parent 63cf6646d0
commit 61c9470981
10 changed files with 905 additions and 71 deletions
@@ -0,0 +1,85 @@
/**
* Bench harness for the selection/badge-set reactivity patterns compared in
* `selectionPatterns.bench.test.ts` (runes only compile in `.svelte.ts`
* modules, so the models live here; the app never imports this file — it is
* test-only and tree-shaken from the bundle).
*
* `copyReassignModel` is the pre-fix files-view pattern, verbatim: a
* `$state<Set>` where every toggle copies the whole set into a fresh
* `SvelteSet` and reassigns. `inPlaceModel` is the post-fix pattern: one
* `SvelteSet` mutated in place.
*/
import { flushSync } from 'svelte';
import { SvelteSet } from 'svelte/reactivity';
export interface SelectionModel {
has(id: string): boolean;
toggle(id: string): void;
seed(ids: Iterable<string>): void;
readonly size: number;
}
/** Pre-fix pattern (files view `toggleSelected`, verbatim copy-and-reassign). */
export function copyReassignModel(): SelectionModel {
// eslint-disable-next-line svelte/prefer-svelte-reactivity -- BEFORE arm replicates the pre-fix plain-Set pattern verbatim
let selected = $state<Set<string>>(new Set());
return {
has: (id) => selected.has(id),
toggle(id) {
const next = new SvelteSet(selected);
if (next.has(id)) next.delete(id);
else next.add(id);
selected = next;
},
seed(ids) {
// eslint-disable-next-line svelte/prefer-svelte-reactivity -- BEFORE arm replicates the pre-fix plain-Set pattern verbatim
selected = new Set(ids);
},
get size() {
return selected.size;
}
};
}
/** Post-fix pattern: one live `SvelteSet` mutated in place (per-key sources
* for present keys; absent-key reads track the version signal). */
export function inPlaceModel(): SelectionModel {
const selected = new SvelteSet<string>();
return {
has: (id) => selected.has(id),
toggle(id) {
if (selected.has(id)) selected.delete(id);
else selected.add(id);
},
seed(ids) {
selected.clear();
for (const id of ids) selected.add(id);
},
get size() {
return selected.size;
}
};
}
/**
* Mount one effect per row reading `model.has(rowId)` — the shape of a row's
* checkbox/star binding — run `mutate`, and report how many row effects re-ran
* (the invalidation fan-out of the mutation).
*/
export function measureFanout(model: SelectionModel, rowIds: string[], mutate: () => void): number {
let runs = 0;
const destroy = $effect.root(() => {
for (const id of rowIds) {
$effect(() => {
void model.has(id);
runs += 1;
});
}
});
flushSync(); // initial run of every row effect
const baseline = runs;
mutate();
flushSync();
destroy();
return runs - baseline;
}
@@ -0,0 +1,127 @@
import { describe, expect, it } from 'vitest';
import {
copyReassignModel,
inPlaceModel,
measureFanout,
type SelectionModel
} from './selectionBench.svelte';
/**
* Benchmark gate for the in-place `SvelteSet` selection/badge sets in the
* files and recent views.
*
* Audit finding: `selected`, `favoriteIds` and `sharedIds` were plain
* `$state<Set>`s rebuilt from a full copy on every single-item toggle
* (`new SvelteSet(selected)` + reassign). That costs (a) an O(N) copy per
* toggle — N unbounded under "select all → refine" — and (b) reassigning the
* state reference invalidates EVERY mounted row's `.has(id)` read, so the
* whole viewport re-renders for a one-row change. The fix keeps one
* `SvelteSet` per set and mutates it in place; `SvelteSet` tracks per-key, so
* a toggle re-runs only the toggled row's readers. The composable
* `useSelection` already shipped this pattern — the views now match it.
*
* `SvelteSet` granularity (svelte/src/reactivity/set.js): present keys get a
* per-key source; `.has()` on an ABSENT key tracks the set's version signal
* ("don't create sources willy-nilly"), so miss-readers re-run on any
* mutation in both patterns. The in-place win is therefore: no O(N) copy, and
* every OTHER present-key reader is spared — copy-reassign re-runs all rows.
*
* Gates: (1) both patterns agree on membership across a deterministic toggle
* script; (2) fan-out under 40 mounted row-effects matches those exact
* semantics (misses+1 in place vs all 40 copied — 3 vs 40 when the list is
* mostly selected, the "select all → refine" case); (3) 1 000 toggles over a
* 5 000-id selection run ≥5x faster in place.
*/
/** Deterministic PRNG so both models replay the identical script. */
function mulberry32(seed: number): () => number {
let a = seed >>> 0;
return () => {
a = (a + 0x6d2b79f5) | 0;
let t = Math.imul(a ^ (a >>> 15), 1 | a);
t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
};
}
const ids = (n: number): string[] => Array.from({ length: n }, (_, i) => `id-${i}`);
describe('in-place SvelteSet selection (benchmark gate)', () => {
it('membership after a 500-op toggle script is identical in both patterns', () => {
const universe = ids(1_000);
const a = copyReassignModel();
const b = inPlaceModel();
a.seed(universe.slice(0, 100));
b.seed(universe.slice(0, 100));
const rand = mulberry32(0xc0ffee);
for (let i = 0; i < 500; i++) {
const id = universe[Math.floor(rand() * universe.length)];
a.toggle(id);
b.toggle(id);
}
expect(a.size).toBe(b.size);
for (const id of universe) {
expect(b.has(id), id).toBe(a.has(id));
}
});
it('fan-out of one toggle across 40 mounted rows matches per-key semantics', () => {
const rows = ids(40);
const scenario = (seeded: number): { copy: number; inplace: number } => {
const copy = copyReassignModel();
copy.seed(rows.slice(0, seeded));
const copyFanout = measureFanout(copy, rows, () => copy.toggle('id-7'));
const inplace = inPlaceModel();
inplace.seed(rows.slice(0, seeded));
const inplaceFanout = measureFanout(inplace, rows, () => inplace.toggle('id-7'));
return { copy: copyFanout, inplace: inplaceFanout };
};
// 10/40 selected (sparse selection): misses (30) + the toggled row.
const sparse = scenario(10);
// 38/40 selected ("select all → refine"): misses (2) + the toggled row.
const dense = scenario(38);
console.info(
`fan-out of 1 toggle across 40 row effects — 10/40 selected: copy ${sparse.copy} vs in-place ${sparse.inplace}; 38/40 selected: copy ${dense.copy} vs in-place ${dense.inplace}`
);
// Copy-reassign invalidates every row that reads `.has` on the state.
expect(sparse.copy).toBeGreaterThanOrEqual(rows.length);
expect(dense.copy).toBeGreaterThanOrEqual(rows.length);
// In place: absent-key readers track the version signal (SvelteSet
// design), present-key readers other than the toggled row are spared.
expect(sparse.inplace).toBe(40 - 10 + 1);
expect(dense.inplace).toBe(40 - 38 + 1);
// The refine-after-select-all case is where the win is decisive.
expect(dense.inplace).toBeLessThan(dense.copy / 10);
});
it('1 000 toggles over a 5 000-id selection are ≥5x faster in place (perf gate)', () => {
const N = 5_000;
const TOGGLES = 1_000;
const universe = ids(N);
const run = (model: SelectionModel): number => {
model.seed(universe);
const rand = mulberry32(0xbeef);
const t0 = performance.now();
for (let i = 0; i < TOGGLES; i++) {
model.toggle(universe[Math.floor(rand() * N)]);
}
return performance.now() - t0;
};
// Warm-up (JIT) then measure.
run(copyReassignModel());
run(inPlaceModel());
const copyMs = run(copyReassignModel());
const inplaceMs = run(inPlaceModel());
console.info(
`${TOGGLES} toggles @ N=${N}: copy-reassign ${copyMs.toFixed(1)} ms vs in-place ${inplaceMs.toFixed(1)} ms (${(copyMs / inplaceMs).toFixed(1)}x)`
);
expect(inplaceMs).toBeLessThan(copyMs / 5);
});
});