diff --git a/web/package.json b/web/package.json
index 5031ce78..e5f1f7b5 100644
--- a/web/package.json
+++ b/web/package.json
@@ -33,6 +33,7 @@
     "lucide-svelte": "^1.0.1"
   },
   "imports": {
-    "#lib/*": "./src/lib/*"
+    "#lib/*": "./src/lib/*",
+    "#test-utils/*": "./src/test-utils/*"
   }
 }
diff --git a/web/src/lib/components/AddToPlaylistMenu.test.ts b/web/src/lib/components/AddToPlaylistMenu.test.ts
index dbfa4d0a..7b4c7da4 100644
--- a/web/src/lib/components/AddToPlaylistMenu.test.ts
+++ b/web/src/lib/components/AddToPlaylistMenu.test.ts
@@ -1,7 +1,7 @@
 import { describe, expect, test, vi } from 'vitest';
 import { render, screen, fireEvent, waitFor } from '@testing-library/svelte';
 import { readable } from 'svelte/store';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 const playlistsData = vi.hoisted(() => ({
   owned: [
diff --git a/web/src/lib/components/AdminTabs.test.ts b/web/src/lib/components/AdminTabs.test.ts
index c6e42c89..f01eaab9 100644
--- a/web/src/lib/components/AdminTabs.test.ts
+++ b/web/src/lib/components/AdminTabs.test.ts
@@ -1,6 +1,6 @@
 import { describe, expect, test, vi } from 'vitest';
 import { render, screen } from '@testing-library/svelte';
-import { pageUrlModule } from '$test-utils/mocks/appState';
+import { pageUrlModule } from '#test-utils/mocks/appState.js';
 
 const state = vi.hoisted(() => ({
   pageUrl: new URL('http://localhost/admin')
diff --git a/web/src/lib/components/AlbumCard.test.ts b/web/src/lib/components/AlbumCard.test.ts
index 7c09291a..7cb69f77 100644
--- a/web/src/lib/components/AlbumCard.test.ts
+++ b/web/src/lib/components/AlbumCard.test.ts
@@ -4,7 +4,7 @@ import type { AlbumRef, AlbumDetail, TrackRef } from '#lib/api/types.js';
 import { FALLBACK_COVER } from '#lib/media/covers.js';
 import { emptyLikesMock } from '../../test-utils/mocks/likes';
 import { apiClientMock } from '../../test-utils/mocks/client';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 vi.mock('#lib/api/client.js', () => apiClientMock());
 vi.mock('#lib/player/store.svelte.js', () => ({
diff --git a/web/src/lib/components/AlbumMenu.test.ts b/web/src/lib/components/AlbumMenu.test.ts
index be1ac6b9..4520cce0 100644
--- a/web/src/lib/components/AlbumMenu.test.ts
+++ b/web/src/lib/components/AlbumMenu.test.ts
@@ -3,7 +3,7 @@ import { render, screen, fireEvent, waitFor } from '@testing-library/svelte';
 import { emptyLikesMock } from '../../test-utils/mocks/likes';
 import { emptyPlaylistsMock } from '../../test-utils/mocks/playlists';
 import type { TrackRef } from '#lib/api/types.js';
-import { makeTracks } from '$test-utils/fixtures/track';
+import { makeTracks } from '#test-utils/fixtures/track.js';
 
 vi.mock('$app/navigation', () => ({ goto: vi.fn() }));
 
diff --git a/web/src/lib/components/ArtistCard.test.ts b/web/src/lib/components/ArtistCard.test.ts
index 7ad98579..44fd8d9c 100644
--- a/web/src/lib/components/ArtistCard.test.ts
+++ b/web/src/lib/components/ArtistCard.test.ts
@@ -3,7 +3,7 @@ import { render, screen, fireEvent } from '@testing-library/svelte';
 import { emptyLikesMock } from '../../test-utils/mocks/likes';
 import { apiClientMock } from '../../test-utils/mocks/client';
 import type { ArtistRef, TrackRef } from '#lib/api/types.js';
-import { makeTrack, makeTracks } from '$test-utils/fixtures/track';
+import { makeTrack, makeTracks } from '#test-utils/fixtures/track.js';
 
 vi.mock('#lib/api/client.js', () => apiClientMock());
 vi.mock('#lib/player/store.svelte.js', () => ({
diff --git a/web/src/lib/components/ArtistMenu.test.ts b/web/src/lib/components/ArtistMenu.test.ts
index 2f4272f4..b6b7270f 100644
--- a/web/src/lib/components/ArtistMenu.test.ts
+++ b/web/src/lib/components/ArtistMenu.test.ts
@@ -3,7 +3,7 @@ import { render, screen, fireEvent, waitFor } from '@testing-library/svelte';
 import { emptyLikesMock } from '../../test-utils/mocks/likes';
 import { emptyPlaylistsMock } from '../../test-utils/mocks/playlists';
 import type { TrackRef } from '#lib/api/types.js';
-import { makeTracks } from '$test-utils/fixtures/track';
+import { makeTracks } from '#test-utils/fixtures/track.js';
 
 vi.mock('$app/navigation', () => ({ goto: vi.fn() }));
 
diff --git a/web/src/lib/components/CompactTrackCard.test.ts b/web/src/lib/components/CompactTrackCard.test.ts
index 94948dcf..8366c305 100644
--- a/web/src/lib/components/CompactTrackCard.test.ts
+++ b/web/src/lib/components/CompactTrackCard.test.ts
@@ -4,7 +4,7 @@ import type { TrackRef } from '#lib/api/types.js';
 import { emptyLikesMock } from '../../test-utils/mocks/likes';
 import { emptyPlaylistsMock } from '../../test-utils/mocks/playlists';
 import { emptyQuarantineMock } from '../../test-utils/mocks/quarantine';
-import { makeTracks } from '$test-utils/fixtures/track';
+import { makeTracks } from '#test-utils/fixtures/track.js';
 
 vi.mock('#lib/api/likes.js', () => emptyLikesMock());
 
diff --git a/web/src/lib/components/DiscoverTabs.test.ts b/web/src/lib/components/DiscoverTabs.test.ts
index a57757f0..28dedf90 100644
--- a/web/src/lib/components/DiscoverTabs.test.ts
+++ b/web/src/lib/components/DiscoverTabs.test.ts
@@ -1,6 +1,6 @@
 import { describe, expect, test, vi } from 'vitest';
 import { render, screen } from '@testing-library/svelte';
-import { pageUrlModule } from '$test-utils/mocks/appState';
+import { pageUrlModule } from '#test-utils/mocks/appState.js';
 
 const state = vi.hoisted(() => ({
   pageUrl: new URL('http://localhost/discover')
diff --git a/web/src/lib/components/FlagPopover.test.ts b/web/src/lib/components/FlagPopover.test.ts
index 55e5e9ae..9b9f37cc 100644
--- a/web/src/lib/components/FlagPopover.test.ts
+++ b/web/src/lib/components/FlagPopover.test.ts
@@ -1,7 +1,7 @@
 import { afterEach, describe, expect, test, vi } from 'vitest';
 import { render, screen, fireEvent } from '@testing-library/svelte';
 import FlagPopover from './FlagPopover.svelte';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 const invalidateMock = vi.fn();
 vi.mock('@tanstack/svelte-query', async (orig) => {
diff --git a/web/src/lib/components/HistoryRow.test.ts b/web/src/lib/components/HistoryRow.test.ts
index aefe6d1d..52145e0c 100644
--- a/web/src/lib/components/HistoryRow.test.ts
+++ b/web/src/lib/components/HistoryRow.test.ts
@@ -2,7 +2,7 @@ import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { render, screen, fireEvent } from '@testing-library/svelte';
 import HistoryRow from './HistoryRow.svelte';
 import type { HistoryEvent } from '#lib/api/history.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 const playQueue = vi.fn();
 
diff --git a/web/src/lib/components/PlayerBar.test.ts b/web/src/lib/components/PlayerBar.test.ts
index d3886287..85c953f4 100644
--- a/web/src/lib/components/PlayerBar.test.ts
+++ b/web/src/lib/components/PlayerBar.test.ts
@@ -3,7 +3,7 @@ import { render, screen, fireEvent, within } from '@testing-library/svelte';
 import type { TrackRef } from '#lib/api/types.js';
 import { emptyLikesMock } from '../../test-utils/mocks/likes';
 import { emptyQuarantineMock } from '../../test-utils/mocks/quarantine';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 // Mutable state the mocked store reads from.
 const state = vi.hoisted(() => ({
diff --git a/web/src/lib/components/QueueDrawer.test.ts b/web/src/lib/components/QueueDrawer.test.ts
index 5ce17569..ebec241e 100644
--- a/web/src/lib/components/QueueDrawer.test.ts
+++ b/web/src/lib/components/QueueDrawer.test.ts
@@ -2,7 +2,7 @@ import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { render, screen, fireEvent } from '@testing-library/svelte';
 import { emptyLikesMock } from '../../test-utils/mocks/likes';
 import type { TrackRef } from '#lib/api/types.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 // QueueTrackRow (rendered inside QueueDrawer → QueueList) now renders a
 // LikeButton, which reads createLikedIdsQuery. Stub the likes API so the
diff --git a/web/src/lib/components/QueueTrackRow.test.ts b/web/src/lib/components/QueueTrackRow.test.ts
index 8113dd08..72ab7dc7 100644
--- a/web/src/lib/components/QueueTrackRow.test.ts
+++ b/web/src/lib/components/QueueTrackRow.test.ts
@@ -1,7 +1,7 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { render, screen, fireEvent } from '@testing-library/svelte';
 import { emptyLikesMock } from '../../test-utils/mocks/likes';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 // QueueTrackRow now renders a LikeButton, which reads createLikedIdsQuery.
 // Stub the likes API so the row doesn't need a real QueryClient in context.
diff --git a/web/src/lib/components/SearchInput.test.ts b/web/src/lib/components/SearchInput.test.ts
index 0966d8f9..b01c87e2 100644
--- a/web/src/lib/components/SearchInput.test.ts
+++ b/web/src/lib/components/SearchInput.test.ts
@@ -1,6 +1,6 @@
 import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
 import { render, screen, fireEvent } from '@testing-library/svelte';
-import { pageUrlModule } from '$test-utils/mocks/appState';
+import { pageUrlModule } from '#test-utils/mocks/appState.js';
 
 const state = vi.hoisted(() => ({
   pageUrl: new URL('http://localhost/')
diff --git a/web/src/lib/components/TrackMenu.test.ts b/web/src/lib/components/TrackMenu.test.ts
index bcbc28a0..1b0ece70 100644
--- a/web/src/lib/components/TrackMenu.test.ts
+++ b/web/src/lib/components/TrackMenu.test.ts
@@ -3,7 +3,7 @@ import { render, screen, fireEvent, waitFor } from '@testing-library/svelte';
 import { emptyLikesMock } from '../../test-utils/mocks/likes';
 import { emptyPlaylistsMock } from '../../test-utils/mocks/playlists';
 import { emptyQuarantineMock } from '../../test-utils/mocks/quarantine';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 // Mutable mock-user handle so individual tests can flip is_admin / null
 // without re-importing the module under test.
diff --git a/web/src/lib/components/TrackRow.test.ts b/web/src/lib/components/TrackRow.test.ts
index cd280625..f0049c72 100644
--- a/web/src/lib/components/TrackRow.test.ts
+++ b/web/src/lib/components/TrackRow.test.ts
@@ -3,7 +3,7 @@ import { render, screen, fireEvent } from '@testing-library/svelte';
 import type { TrackRef } from '#lib/api/types.js';
 import { emptyLikesMock } from '../../test-utils/mocks/likes';
 import { emptyQuarantineMock } from '../../test-utils/mocks/quarantine';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 vi.mock('#lib/player/store.svelte.js', () => ({
   playQueue: vi.fn(),
diff --git a/web/src/lib/player/events.svelte.test.ts b/web/src/lib/player/events.svelte.test.ts
index 9485f09c..a22e6473 100644
--- a/web/src/lib/player/events.svelte.test.ts
+++ b/web/src/lib/player/events.svelte.test.ts
@@ -21,7 +21,7 @@ import {
 } from './store.svelte';
 import { api } from '#lib/api/client.js';
 import type { TrackRef } from '#lib/api/types.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 function track(id: string, dur = 200): TrackRef {
   return makeTrack({
diff --git a/web/src/lib/player/gain.test.ts b/web/src/lib/player/gain.test.ts
index b6900646..bb36fb9b 100644
--- a/web/src/lib/player/gain.test.ts
+++ b/web/src/lib/player/gain.test.ts
@@ -2,7 +2,7 @@ import { describe, expect, test } from 'vitest';
 import { dbToLinear, gainDb, playingAsAlbum, MAX_BOOST_DB } from './gain';
 import type { NormalizationPrefs } from '#lib/api/normalization.js';
 import type { TrackRef } from '#lib/api/types.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 const prefs = (over: Partial<NormalizationPrefs> = {}): NormalizationPrefs => ({
   mode: 'auto',
diff --git a/web/src/lib/player/gainStage.svelte.test.ts b/web/src/lib/player/gainStage.svelte.test.ts
index e9a5b29b..73d0f644 100644
--- a/web/src/lib/player/gainStage.svelte.test.ts
+++ b/web/src/lib/player/gainStage.svelte.test.ts
@@ -1,6 +1,6 @@
 import { beforeEach, describe, expect, test, vi } from 'vitest';
 import type { TrackRef } from '#lib/api/types.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 vi.mock('#lib/auth/store.svelte.js', () => ({
   user: {
diff --git a/web/src/lib/player/mediaSession.svelte.test.ts b/web/src/lib/player/mediaSession.svelte.test.ts
index 42761c0f..1be42640 100644
--- a/web/src/lib/player/mediaSession.svelte.test.ts
+++ b/web/src/lib/player/mediaSession.svelte.test.ts
@@ -1,7 +1,7 @@
 import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
 import { flushSync } from 'svelte';
 import type { TrackRef } from '#lib/api/types.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 function track(id: string): TrackRef {
   return makeTrack({
diff --git a/web/src/lib/player/persisted.test.ts b/web/src/lib/player/persisted.test.ts
index 1eb711a7..0a7786fd 100644
--- a/web/src/lib/player/persisted.test.ts
+++ b/web/src/lib/player/persisted.test.ts
@@ -1,6 +1,6 @@
 import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
 import { readPersistedQueue, writePersistedQueue, clearPersistedQueue } from './persisted';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 const sampleTrack = makeTrack();
 
diff --git a/web/src/lib/player/shortcuts.svelte.test.ts b/web/src/lib/player/shortcuts.svelte.test.ts
index b7a9e459..5bfab168 100644
--- a/web/src/lib/player/shortcuts.svelte.test.ts
+++ b/web/src/lib/player/shortcuts.svelte.test.ts
@@ -1,7 +1,7 @@
 import { afterEach, beforeEach, describe, expect, test } from 'vitest';
 import { flushSync } from 'svelte';
 import type { TrackRef } from '#lib/api/types.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 function track(id: string): TrackRef {
   return makeTrack({
diff --git a/web/src/lib/player/store.test.ts b/web/src/lib/player/store.test.ts
index cf00506d..51edbbcb 100644
--- a/web/src/lib/player/store.test.ts
+++ b/web/src/lib/player/store.test.ts
@@ -19,7 +19,7 @@ import {
 } from './store.svelte';
 import type { TrackRef } from '#lib/api/types.js';
 import { writePersistedQueue, clearPersistedQueue } from './persisted';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 vi.mock('#lib/auth/store.svelte.js', () => ({
   user: {
diff --git a/web/src/lib/selection/store.svelte.test.ts b/web/src/lib/selection/store.svelte.test.ts
index 8e6c175c..508f79f4 100644
--- a/web/src/lib/selection/store.svelte.test.ts
+++ b/web/src/lib/selection/store.svelte.test.ts
@@ -1,6 +1,6 @@
 import { describe, expect, test, beforeEach } from 'vitest';
 import type { TrackRef } from '#lib/api/types.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 import {
   selection, toggleOne, selectRange, clearSelection
 } from './store.svelte';
diff --git a/web/src/lib/utils/dayGroup.test.ts b/web/src/lib/utils/dayGroup.test.ts
index 14669dfc..3541573b 100644
--- a/web/src/lib/utils/dayGroup.test.ts
+++ b/web/src/lib/utils/dayGroup.test.ts
@@ -1,7 +1,7 @@
 import { describe, it, expect } from 'vitest';
 import { dayBucket, groupByDay } from './dayGroup';
 import type { HistoryEvent } from '#lib/api/history.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 const NOW = new Date('2026-05-04T14:00:00Z');
 
diff --git a/web/src/routes/albums/[id]/album.test.ts b/web/src/routes/albums/[id]/album.test.ts
index e0cab0b8..287d1422 100644
--- a/web/src/routes/albums/[id]/album.test.ts
+++ b/web/src/routes/albums/[id]/album.test.ts
@@ -4,7 +4,7 @@ import { flushSync } from 'svelte';
 import { mockQuery } from '../../../test-utils/query';
 import { emptyLikesMock } from '../../../test-utils/mocks/likes';
 import type { AlbumDetail, TrackRef } from '#lib/api/types.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 const state = vi.hoisted(() => ({ pageParams: { id: 'xyz' } as Record<string, string> }));
 
diff --git a/web/src/routes/library/genres/genres.test.ts b/web/src/routes/library/genres/genres.test.ts
index e285e7ef..f24be753 100644
--- a/web/src/routes/library/genres/genres.test.ts
+++ b/web/src/routes/library/genres/genres.test.ts
@@ -1,9 +1,9 @@
 import { afterEach, describe, expect, test, vi } from 'vitest';
 import { render, screen, waitFor, fireEvent } from '@testing-library/svelte';
-import { mockQuery } from '$test-utils/query';
-import { pageUrlModule } from '$test-utils/mocks/appState';
-import { apiClientMock } from '$test-utils/mocks/client';
-import { emptyLikesMock } from '$test-utils/mocks/likes';
+import { mockQuery } from '#test-utils/query.js';
+import { pageUrlModule } from '#test-utils/mocks/appState.js';
+import { apiClientMock } from '#test-utils/mocks/client.js';
+import { emptyLikesMock } from '#test-utils/mocks/likes.js';
 import type { AlbumRef } from '#lib/api/types.js';
 
 const pageState = vi.hoisted(() => ({
diff --git a/web/src/routes/library/history/page.test.ts b/web/src/routes/library/history/page.test.ts
index 7d2ead66..550cf6e4 100644
--- a/web/src/routes/library/history/page.test.ts
+++ b/web/src/routes/library/history/page.test.ts
@@ -2,7 +2,7 @@ import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { render, screen } from '@testing-library/svelte';
 import HistoryPage from './+page.svelte';
 import type { HistoryEvent, HistoryResponse } from '#lib/api/history.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 const mkTrack = (id: string) => makeTrack({ id: `track-${id}`, title: `Song ${id}` });
 
diff --git a/web/src/routes/library/liked/liked.test.ts b/web/src/routes/library/liked/liked.test.ts
index d076c559..b5a49797 100644
--- a/web/src/routes/library/liked/liked.test.ts
+++ b/web/src/routes/library/liked/liked.test.ts
@@ -4,7 +4,7 @@ import { mockInfiniteQuery } from '../../../test-utils/query';
 import { apiClientMock } from '../../../test-utils/mocks/client';
 import type { ArtistRef, AlbumRef, TrackRef, Page } from '#lib/api/types.js';
 import { readable } from 'svelte/store';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 vi.mock('#lib/api/likes.js', () => ({
   createLikedIdsQuery: () => readable({
diff --git a/web/src/routes/library/years/years.test.ts b/web/src/routes/library/years/years.test.ts
index 5554315c..cd0f2436 100644
--- a/web/src/routes/library/years/years.test.ts
+++ b/web/src/routes/library/years/years.test.ts
@@ -1,9 +1,9 @@
 import { afterEach, describe, expect, test, vi } from 'vitest';
 import { render, screen, waitFor, fireEvent } from '@testing-library/svelte';
-import { mockQuery } from '$test-utils/query';
-import { pageUrlModule } from '$test-utils/mocks/appState';
-import { apiClientMock } from '$test-utils/mocks/client';
-import { emptyLikesMock } from '$test-utils/mocks/likes';
+import { mockQuery } from '#test-utils/query.js';
+import { pageUrlModule } from '#test-utils/mocks/appState.js';
+import { apiClientMock } from '#test-utils/mocks/client.js';
+import { emptyLikesMock } from '#test-utils/mocks/likes.js';
 import type { AlbumRef } from '#lib/api/types.js';
 
 const pageState = vi.hoisted(() => ({
diff --git a/web/src/routes/login/login.test.ts b/web/src/routes/login/login.test.ts
index c28f84f2..504a55ce 100644
--- a/web/src/routes/login/login.test.ts
+++ b/web/src/routes/login/login.test.ts
@@ -1,6 +1,6 @@
 import { afterEach, describe, expect, test, vi } from 'vitest';
 import { render, screen, fireEvent, waitFor } from '@testing-library/svelte';
-import { pageUrlModule } from '$test-utils/mocks/appState';
+import { pageUrlModule } from '#test-utils/mocks/appState.js';
 
 // vi.hoisted avoids the temporal-dead-zone hazard: mock factories are lazy
 // and can run before top-level `let` is initialized, since imports are
diff --git a/web/src/routes/search/albums/albums.test.ts b/web/src/routes/search/albums/albums.test.ts
index 5b8e36fd..2ad8d960 100644
--- a/web/src/routes/search/albums/albums.test.ts
+++ b/web/src/routes/search/albums/albums.test.ts
@@ -3,7 +3,7 @@ import { render, screen, fireEvent } from '@testing-library/svelte';
 import { mockInfiniteQuery } from '../../../test-utils/query';
 import { emptyLikesMock } from '../../../test-utils/mocks/likes';
 import { apiClientMock } from '../../../test-utils/mocks/client';
-import { pageUrlModule } from '$test-utils/mocks/appState';
+import { pageUrlModule } from '#test-utils/mocks/appState.js';
 import type { AlbumRef, Page } from '#lib/api/types.js';
 
 const state = vi.hoisted(() => ({ pageUrl: new URL('http://localhost/search/albums?q=miles') }));
diff --git a/web/src/routes/search/artists/artists.test.ts b/web/src/routes/search/artists/artists.test.ts
index f62ad34e..d604f734 100644
--- a/web/src/routes/search/artists/artists.test.ts
+++ b/web/src/routes/search/artists/artists.test.ts
@@ -2,7 +2,7 @@ import { afterEach, describe, expect, test, vi } from 'vitest';
 import { render, screen, fireEvent } from '@testing-library/svelte';
 import { mockInfiniteQuery } from '../../../test-utils/query';
 import { emptyLikesMock } from '../../../test-utils/mocks/likes';
-import { pageUrlModule } from '$test-utils/mocks/appState';
+import { pageUrlModule } from '#test-utils/mocks/appState.js';
 import type { ArtistRef, Page } from '#lib/api/types.js';
 
 const state = vi.hoisted(() => ({ pageUrl: new URL('http://localhost/search/artists?q=miles') }));
diff --git a/web/src/routes/search/search.test.ts b/web/src/routes/search/search.test.ts
index 967acc4e..d500ebc8 100644
--- a/web/src/routes/search/search.test.ts
+++ b/web/src/routes/search/search.test.ts
@@ -3,9 +3,9 @@ import { render, screen } from '@testing-library/svelte';
 import { mockQuery } from '../../test-utils/query';
 import { emptyLikesMock } from '../../test-utils/mocks/likes';
 import { apiClientMock } from '../../test-utils/mocks/client';
-import { pageUrlModule } from '$test-utils/mocks/appState';
+import { pageUrlModule } from '#test-utils/mocks/appState.js';
 import type { ArtistRef, AlbumRef, SearchResponse } from '#lib/api/types.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 const state = vi.hoisted(() => ({
   pageUrl: new URL('http://localhost/search')
diff --git a/web/src/routes/search/tracks/tracks.test.ts b/web/src/routes/search/tracks/tracks.test.ts
index c39cc42d..c624b5f4 100644
--- a/web/src/routes/search/tracks/tracks.test.ts
+++ b/web/src/routes/search/tracks/tracks.test.ts
@@ -3,9 +3,9 @@ import { render, screen, fireEvent } from '@testing-library/svelte';
 import { mockInfiniteQuery } from '../../../test-utils/query';
 import { emptyLikesMock } from '../../../test-utils/mocks/likes';
 import { emptyQuarantineMock } from '../../../test-utils/mocks/quarantine';
-import { pageUrlModule } from '$test-utils/mocks/appState';
+import { pageUrlModule } from '#test-utils/mocks/appState.js';
 import type { TrackRef, Page } from '#lib/api/types.js';
-import { makeTrack } from '$test-utils/fixtures/track';
+import { makeTrack } from '#test-utils/fixtures/track.js';
 
 const state = vi.hoisted(() => ({ pageUrl: new URL('http://localhost/search/tracks?q=miles') }));
 
diff --git a/web/vite.config.ts b/web/vite.config.ts
index 892f29b5..853a6961 100644
--- a/web/vite.config.ts
+++ b/web/vite.config.ts
@@ -57,7 +57,7 @@ const injectGoTokensPlugin = {
 };
 
 // SvelteKit's options, which lived in svelte.config.js before kit 3. Exported
-// so vitest.config.ts runs the same kit setup (the $test-utils alias above all).
+// so vitest.config.ts runs the same kit setup.
 export const kitOptions = {
   preprocess: vitePreprocess(),
   adapter: adapter({
@@ -67,13 +67,7 @@ export const kitOptions = {
     precompress: false,
     strict: false
   }),
-  files: { assets: 'static' },
-  alias: {
-    // test-only helper barrel; resolves the same way #lib does so test
-    // files can import shared mock factories without ../../../ chains.
-    '$test-utils': 'src/test-utils',
-    '$test-utils/*': 'src/test-utils/*'
-  }
+  files: { assets: 'static' }
 };
 
 export default defineConfig({
diff --git a/web/vitest.config.ts b/web/vitest.config.ts
index a3eb4031..7a534ee1 100644
--- a/web/vitest.config.ts
+++ b/web/vitest.config.ts
@@ -1,7 +1,7 @@
 import { sveltekit } from '@sveltejs/kit/vite';
 import { svelteTesting } from '@testing-library/svelte/vite';
 import { configDefaults, defineConfig } from 'vitest/config';
-import { kitOptions } from './vite.config';
+import { kitOptions } from './vite.config.ts';
 
 export default defineConfig({
   plugins: [sveltekit(kitOptions), svelteTesting()],