refactor(waveform): co-locate seekbar feature into features/waveform

src/components/fullscreenPlayer/FullscreenPlayerStatic.tsx

@@ -14,7 +14,7 @@ import { backdropFromConfig } from '../../cover/artistBackdrop';
 import { useThemeStore } from '../../store/themeStore';
 import { useFsIdleFade } from '../../hooks/useFsIdleFade';
 import { useQueueTrackAt } from '../../hooks/useQueueTracks';
-import WaveformSeek from '../WaveformSeek';
+import { WaveformSeek } from '@/features/waveform';
 import { FsQueueModal } from './FsQueueModal';
 import { FsLyricsApple } from './FsLyricsApple';
 import { FsPlayBtn } from './FsPlayBtn';

src/components/playerBar/PlayerSeekbarSection.tsx

@@ -3,7 +3,7 @@ import type { TFunction } from 'i18next';
 import type { RadioMetadata } from '../../hooks/useRadioMetadata';
 import { useThemeStore } from '../../store/themeStore';
 import { formatTrackTime, playbarMinuteFieldWidth } from '../../utils/format/formatDuration';
-import WaveformSeek from '../WaveformSeek';
+import { WaveformSeek } from '@/features/waveform';
 import { PlaybackTime, ToggleClock } from './PlaybackClock';
 
 interface Props {

src/components/settings/AppearanceTab.tsx

@@ -16,7 +16,7 @@ import { SettingsGroup } from './SettingsGroup';
 import { SettingsToggle } from './SettingsToggle';
 import { SettingsSubCard, SettingsField, SettingsValue } from './SettingsSubCard';
 import { SettingsSegmented, type SegmentedOption } from './SettingsSegmented';
-import { SeekbarPreview } from '../WaveformSeekPreview';
+import { SeekbarPreview } from '@/features/waveform';
 import WindowButtonPreview from '../WindowButtonPreview';
 
 export function AppearanceTab() {

src/features/waveform/components/WaveformSeek.test.tsx

@@ -25,7 +25,7 @@ vi.mock('@/api/subsonic', () => ({
 }));
 
 
-import WaveformSeek from './WaveformSeek';
+import WaveformSeek from '@/features/waveform/components/WaveformSeek';
 import { renderWithProviders } from '@/test/helpers/renderWithProviders';
 import { usePlayerStore } from '@/store/playerStore';
 import { useAuthStore } from '@/store/authStore';

src/features/waveform/components/WaveformSeek.tsx

@@ -1,17 +1,17 @@
-import { getPlaybackProgressSnapshot, subscribePlaybackProgress } from '../store/playbackProgress';
+import { getPlaybackProgressSnapshot, subscribePlaybackProgress } from '@/store/playbackProgress';
 import { useEffect, useRef, useState } from 'react';
-import { usePlayerStore } from '../store/playerStore';
+import { usePlayerStore } from '@/store/playerStore';
-import { usePreviewStore } from '../store/previewStore';
+import { usePreviewStore } from '@/store/previewStore';
-import { useAuthStore } from '../store/authStore';
+import { useAuthStore } from '@/store/authStore';
 import {
   ANIMATED_STYLES, AnimState,
   STATIC_REDRAW_FORCE_MS, STATIC_REDRAW_MIN_MS,
   fmt, invalidateColorCache, isBarQuantizedSeekStyle, makeAnimState,
   quantizeProgressByBars,
-} from '../utils/waveform/waveformSeekHelpers';
+} from '@/features/waveform/utils/waveformSeekHelpers';
-import { drawSeekbar } from '../utils/waveform/waveformSeekRenderers';
+import { drawSeekbar } from '@/features/waveform/utils/waveformSeekRenderers';
-import { useWaveformHeights } from '../hooks/useWaveformHeights';
+import { useWaveformHeights } from '@/features/waveform/hooks/useWaveformHeights';
-import { useWaveformInterpolation } from '../hooks/useWaveformInterpolation';
+import { useWaveformInterpolation } from '@/features/waveform/hooks/useWaveformInterpolation';
 
 // ── main component ────────────────────────────────────────────────────────────
 //

src/features/waveform/components/WaveformSeekPreview.tsx

@@ -1,7 +1,7 @@
 import { useEffect, useRef } from 'react';
-import type { SeekbarStyle } from '../store/authStoreTypes';
+import type { SeekbarStyle } from '@/store/authStoreTypes';
-import { makeAnimState, makeHeights } from '../utils/waveform/waveformSeekHelpers';
+import { makeAnimState, makeHeights } from '@/features/waveform/utils/waveformSeekHelpers';
-import { drawSeekbar } from '../utils/waveform/waveformSeekRenderers';
+import { drawSeekbar } from '@/features/waveform/utils/waveformSeekRenderers';
 
 interface Props {
   style: SeekbarStyle;

src/features/waveform/hooks/useWaveformHeights.ts

@@ -1,12 +1,12 @@
 import React, { useEffect } from 'react';
-import type { SeekbarStyle } from '../store/authStoreTypes';
+import type { SeekbarStyle } from '@/store/authStoreTypes';
-import type { AnimState } from '../utils/waveform/waveformSeekHelpers';
+import type { AnimState } from '@/features/waveform/utils/waveformSeekHelpers';
 import {
   ANIMATED_STYLES, BAR_COUNT, FLAT_WAVE_NORM, WAVE_MORPH_MS,
   binsToHeights, easeOutCubic, heightsNearlyEqual,
   makeFlatWaveHeights, makeHeights,
-} from '../utils/waveform/waveformSeekHelpers';
+} from '@/features/waveform/utils/waveformSeekHelpers';
-import { drawSeekbar } from '../utils/waveform/waveformSeekRenderers';
+import { drawSeekbar } from '@/features/waveform/utils/waveformSeekRenderers';
 
 interface Args {
   trackId: string | undefined;

src/features/waveform/hooks/useWaveformInterpolation.ts

@@ -1,11 +1,11 @@
 import React, { useEffect } from 'react';
-import type { SeekbarStyle } from '../store/authStoreTypes';
+import type { SeekbarStyle } from '@/store/authStoreTypes';
-import { getPlaybackProgressSnapshot } from '../store/playbackProgress';
+import { getPlaybackProgressSnapshot } from '@/store/playbackProgress';
 import {
   ANIMATED_STYLES, AnimState, INTERPOLATION_PAINT_MIN_MS,
   isBarQuantizedSeekStyle, quantizeProgressByBars,
-} from '../utils/waveform/waveformSeekHelpers';
+} from '@/features/waveform/utils/waveformSeekHelpers';
-import { drawSeekbar } from '../utils/waveform/waveformSeekRenderers';
+import { drawSeekbar } from '@/features/waveform/utils/waveformSeekRenderers';
 
 interface Args {
   duration: number;

src/features/waveform/index.ts

@@ -0,0 +1,11 @@
+/**
+ * Waveform seekbar feature — the canvas seekbar, its waveform-bin loading, and
+ * the per-track refresh generation guard. Co-located mirror of `cover/` /
+ * `music-network/`. `waveformSilence` stays in `utils/waveform/` (crossfade /
+ * auto-dj concern, not seekbar rendering).
+ */
+export { default as WaveformSeek } from './components/WaveformSeek';
+export { SeekbarPreview } from './components/WaveformSeekPreview';
+export { fetchWaveformBins, refreshWaveformForTrack } from './store/waveformRefresh';
+export type { WaveformCachePayload } from './store/waveformRefresh';
+export { bumpWaveformRefreshGen, getWaveformRefreshGen } from './store/waveformRefreshGen';

src/features/waveform/store/waveformRefresh.test.ts

@@ -22,18 +22,18 @@ const hoisted = vi.hoisted(() => ({
 }));
 
 vi.mock('@tauri-apps/api/core', () => ({ invoke: hoisted.invokeMock }));
-vi.mock('../utils/waveform/waveformParse', () => ({ coerceWaveformBins: hoisted.coerceWaveformBinsMock }));
+vi.mock('@/features/waveform/utils/waveformParse', () => ({ coerceWaveformBins: hoisted.coerceWaveformBinsMock }));
-vi.mock('./playerStore', () => ({
+vi.mock('@/store/playerStore', () => ({
   usePlayerStore: {
     getState: () => hoisted.playerSnapshot,
     setState: hoisted.playerSetStateMock,
   },
 }));
-vi.mock('./waveformRefreshGen', () => ({
+vi.mock('@/features/waveform/store/waveformRefreshGen', () => ({
   getWaveformRefreshGen: hoisted.getGenMock,
 }));
 
-import { refreshWaveformForTrack } from './waveformRefresh';
+import { refreshWaveformForTrack } from '@/features/waveform/store/waveformRefresh';
 
 beforeEach(() => {
   hoisted.invokeMock.mockReset();

src/features/waveform/store/waveformRefresh.ts

@@ -1,8 +1,8 @@
 import { invoke } from '@tauri-apps/api/core';
-import { coerceWaveformBins } from '../utils/waveform/waveformParse';
+import { coerceWaveformBins } from '@/features/waveform/utils/waveformParse';
-import { getPlaybackIndexKey } from '../utils/playback/playbackServer';
+import { getPlaybackIndexKey } from '@/utils/playback/playbackServer';
-import { usePlayerStore } from './playerStore';
+import { usePlayerStore } from '@/store/playerStore';
-import { getWaveformRefreshGen } from './waveformRefreshGen';
+import { getWaveformRefreshGen } from '@/features/waveform/store/waveformRefreshGen';
 
 /** Subsonic-server waveform-cache row as Rust hands it back. */
 export type WaveformCachePayload = {

src/features/waveform/store/waveformRefreshGen.test.ts

@@ -3,7 +3,7 @@ import {
   _resetWaveformRefreshGenForTest,
   bumpWaveformRefreshGen,
   getWaveformRefreshGen,
-} from './waveformRefreshGen';
+} from '@/features/waveform/store/waveformRefreshGen';
 
 afterEach(() => {
   _resetWaveformRefreshGenForTest();

src/features/waveform/utils/waveformParse.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { coerceWaveformBins, waveformBlobLenOk } from './waveformParse';
+import { coerceWaveformBins, waveformBlobLenOk } from '@/features/waveform/utils/waveformParse';
 
 describe('waveformBlobLenOk', () => {
   it('accepts the legacy single-curve length (500)', () => {

src/features/waveform/utils/waveformSeekHelpers.ts

@@ -1,4 +1,4 @@
-import type { SeekbarStyle } from '../../store/authStoreTypes';
+import type { SeekbarStyle } from '@/store/authStoreTypes';
 
 export function fmt(s: number): string {
   if (!s || isNaN(s)) return '0:00';

src/features/waveform/utils/waveformSeekRenderers.ts

@@ -1,12 +1,12 @@
-import type { SeekbarStyle } from '../../store/authStoreTypes';
+import type { SeekbarStyle } from '@/store/authStoreTypes';
-import { bumpPerfCounter } from '../perf/perfTelemetry';
+import { bumpPerfCounter } from '@/utils/perf/perfTelemetry';
-import { AnimState, makeAnimState } from './waveformSeekHelpers';
+import { AnimState, makeAnimState } from '@/features/waveform/utils/waveformSeekHelpers';
 import {
   drawBar, drawLineDot, drawNeon, drawSegmented, drawThick, drawWaveform,
-} from './waveformSeekRenderersStatic';
+} from '@/features/waveform/utils/waveformSeekRenderersStatic';
 import {
   drawLiquidFill, drawParticleTrail, drawPulseWave, drawRetroTape,
-} from './waveformSeekRenderersAnimated';
+} from '@/features/waveform/utils/waveformSeekRenderersAnimated';
 
 export function drawSeekbar(
   canvas: HTMLCanvasElement,

src/features/waveform/utils/waveformSeekRenderersAnimated.ts

@@ -1,4 +1,4 @@
-import { AnimState, getColors, setShadowBlur, setupCanvas } from './waveformSeekHelpers';
+import { AnimState, getColors, setShadowBlur, setupCanvas } from '@/features/waveform/utils/waveformSeekHelpers';
 
 export function drawPulseWave(
   canvas: HTMLCanvasElement,

src/features/waveform/utils/waveformSeekRenderersStatic.ts

@@ -1,7 +1,7 @@
 import {
   BAR_COUNT, SEG_COUNT,
   getColors, setShadowBlur, setupCanvas, waveformBarThickness,
-} from './waveformSeekHelpers';
+} from '@/features/waveform/utils/waveformSeekHelpers';
 
 export function drawWaveform(
   canvas: HTMLCanvasElement,

src/store/applyQueueHistorySnapshot.ts

@@ -20,7 +20,7 @@ import {
   type QueueUndoSnapshot,
 } from './queueUndo';
 import { refreshLoudnessForTrack } from './loudnessRefresh';
-import { refreshWaveformForTrack } from './waveformRefresh';
+import { refreshWaveformForTrack } from '@/features/waveform';
 import { stopRadio } from './radioPlayer';
 import { clearAllPlaybackScheduleTimers } from './scheduleTimers';
 import { syncUserQueueMutationToServer } from './queueSync';

src/store/applyServerPlayQueue.idle.test.ts

@@ -27,7 +27,7 @@ vi.mock('./pausedRestorePrepare', () => ({
   preparePausedRestoreOnStartup: vi.fn(),
 }));
 
-vi.mock('./waveformRefresh', () => ({
+vi.mock('@/features/waveform', () => ({
   refreshWaveformForTrack: vi.fn(),
 }));
 

src/store/applyServerPlayQueue.ts

@@ -9,7 +9,7 @@ import { useAuthStore } from './authStore';
 import { usePlayerStore } from './playerStore';
 import { preparePausedRestoreOnStartup } from './pausedRestorePrepare';
 import { pushQueueUndoFromGetter } from './queueUndo';
-import { refreshWaveformForTrack } from './waveformRefresh';
+import { refreshWaveformForTrack } from '@/features/waveform';
 import {
   getIdlePullGeneration,
   isIdleQueuePullSuspended,

src/store/audioEventHandlers.ts

@@ -87,7 +87,7 @@ import {
   getSeekTarget,
   getSeekTargetSetAt,
 } from './seekTargetState';
-import { refreshWaveformForTrack } from './waveformRefresh';
+import { refreshWaveformForTrack } from '@/features/waveform';
 import { analyzeBoundary, computeWaveformSilence } from '../utils/waveform/waveformSilence';
 import { autodjMaxOverlapCapSec } from '../utils/playback/autodjOverlapCap';
 import {

src/store/audioListenerSetup/audioEngineListeners.ts

@@ -24,8 +24,8 @@ import {
   markNormalizationUiUpdate,
 } from '../playbackThrottles';
 import { usePlayerStore } from '../playerStore';
-import { refreshWaveformForTrack } from '../waveformRefresh';
+import { refreshWaveformForTrack } from '@/features/waveform';
-import { bumpWaveformRefreshGen } from '../waveformRefreshGen';
+import { bumpWaveformRefreshGen } from '@/features/waveform';
 import { setBytePreloadingId } from '../gaplessPreloadState';
 
 type PreloadEventPayload = {

src/store/audioListenerSetup/authSyncListener.ts

@@ -7,8 +7,8 @@ import { invokeAudioSetNormalizationDeduped } from '../normalizationIpcDedupe';
 import { usePlayerStore } from '../playerStore';
 import { clearLoudnessCacheStateForTrackId } from '../loudnessGainCache';
 import { refreshLoudnessForTrack } from '../loudnessRefresh';
-import { refreshWaveformForTrack } from '../waveformRefresh';
+import { refreshWaveformForTrack } from '@/features/waveform';
-import { bumpWaveformRefreshGen } from '../waveformRefreshGen';
+import { bumpWaveformRefreshGen } from '@/features/waveform';
 
 /**
  * Keeps the Rust audio engine in sync whenever the auth store changes

src/store/audioListenerSetup/initialAudioSync.ts

@@ -5,7 +5,7 @@ import { emitNormalizationDebug } from '../normalizationDebug';
 import { invokeAudioSetNormalizationDeduped } from '../normalizationIpcDedupe';
 import { usePlayerStore } from '../playerStore';
 import { refreshLoudnessForTrack } from '../loudnessRefresh';
-import { refreshWaveformForTrack } from '../waveformRefresh';
+import { refreshWaveformForTrack } from '@/features/waveform';
 
 /**
  * One-shot startup sync: pushes the persisted audio settings to the Rust engine

src/store/crossfadePreload.ts

@@ -15,7 +15,7 @@ import {
 import { getBytePreloadingId, setBytePreloadingId } from './gaplessPreloadState';
 import { refreshLoudnessForTrack } from './loudnessRefresh';
 import { usePlayerStore } from './playerStore';
-import { fetchWaveformBins } from './waveformRefresh';
+import { fetchWaveformBins } from '@/features/waveform';
 
 // Crossfade pre-buffer budget: begin downloading the next track this many
 // seconds before it needs to play (the crossfade start), so a large lossless

src/store/loudnessReseed.test.ts

@@ -39,7 +39,7 @@ vi.mock('./playerStore', () => ({
     setState: hoisted.playerSetStateMock,
   },
 }));
-vi.mock('./waveformRefreshGen', () => ({
+vi.mock('@/features/waveform', () => ({
   bumpWaveformRefreshGen: hoisted.bumpWaveformRefreshGenMock,
 }));
 vi.mock('./loudnessGainCache', () => ({

src/store/loudnessReseed.ts

@@ -3,7 +3,7 @@ import { invoke } from '@tauri-apps/api/core';
 import { getPlaybackIndexKey } from '../utils/playback/playbackServer';
 import { useAuthStore } from './authStore';
 import { usePlayerStore } from './playerStore';
-import { bumpWaveformRefreshGen } from './waveformRefreshGen';
+import { bumpWaveformRefreshGen } from '@/features/waveform';
 import { clearLoudnessCacheStateForTrackId } from './loudnessGainCache';
 import { resetLoudnessBackfillStateForTrackId } from './loudnessBackfillState';
 

src/store/playTrackAction.ts

@@ -51,7 +51,7 @@ import {
   loudnessGainDbForEngineBind,
 } from './loudnessGainCache';
 import { refreshLoudnessForTrack } from './loudnessRefresh';
-import { fetchWaveformBins, refreshWaveformForTrack } from './waveformRefresh';
+import { fetchWaveformBins, refreshWaveformForTrack } from '@/features/waveform';
 import { deriveNormalizationSnapshot } from './normalizationSnapshot';
 import { useOrbitStore } from './orbitStore';
 import {

src/store/transportLightActions.ts

@@ -11,7 +11,7 @@ import { clearSeekDebounce } from './seekDebounce';
 import { clearSeekFallbackRetry } from './seekFallbackState';
 import { clearSeekTarget } from './seekTargetState';
 import { tryAcquireTogglePlayLock } from './togglePlayLock';
-import { refreshWaveformForTrack } from './waveformRefresh';
+import { refreshWaveformForTrack } from '@/features/waveform';
 import { clearAutodjTransitionUi } from './autodjTransitionUi';
 
 type SetState = (