From 8690e1529a008d72f80e259445db9356396217bb Mon Sep 17 00:00:00 2001
From: Psychotoxical <171614930+Psychotoxical@users.noreply.github.com>
Date: Tue, 30 Jun 2026 17:32:34 +0200
Subject: [PATCH] docs(src): refresh CLAUDE.md + test/README.md key-file paths
 after the restructure

The frontend moves left the subsystem docs pointing at pre-campaign locations.
Update the src/CLAUDE.md key-files table + prose and the test/README.md examples
to current homes: playerStore/playAlbum -> features/playback, Track model +
songToTrack -> lib/media, sidebar -> features/sidebar, QueuePanel ->
features/queue, CachedImage/TooltipPortal/CustomSelect -> ui/, toast -> utils/ui,
subsonic/i18n -> lib, App.tsx split into app/{MainApp,AppShell,RequireAuth}.
Docs only; no code touched.
---
 src/test/README.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/test/README.md b/src/test/README.md
index b82a9d5f..fff7d959 100644
--- a/src/test/README.md
+++ b/src/test/README.md
@@ -97,8 +97,10 @@ from `mocks/subsonic.ts`:
 
 ```ts
 import { vi, describe, it, beforeEach, expect } from 'vitest';
-vi.mock('@/api/subsonic');
-import { getAlbum, buildStreamUrl } from '@/api/subsonic';
+vi.mock('@/lib/api/subsonicLibrary');
+vi.mock('@/lib/api/subsonicStreamUrl');
+import { getAlbum } from '@/lib/api/subsonicLibrary';
+import { buildStreamUrl } from '@/lib/api/subsonicStreamUrl';
 import { sampleAlbumWithSongs, mockStreamUrl } from '@/test/mocks/subsonic';
 
 beforeEach(() => {
@@ -152,7 +154,7 @@ red on a contributor's machine.
 
 ### Pure utilities
 
-Direct import + assert (see `src/utils/dynamicColors.test.ts`). No setup
+Direct import + assert (see `src/utils/ui/dynamicColors.test.ts`). No setup
 needed beyond `import { describe, it, expect } from 'vitest'`.
 
 ### Zustand stores
@@ -162,7 +164,7 @@ needed beyond `import { describe, it, expect } from 'vitest'`.
 - Stub Tauri side effects via `onInvoke()`.
 - Use `emitTauriEvent()` to drive event-driven state transitions.
 
-See `src/store/previewStore.test.ts` for the reference pattern.
+See `src/features/playback/store/previewStore.test.ts` for the reference pattern.
 
 ### Components