initial scaffold

src/types/audio.ts

@@ -0,0 +1,78 @@
+// Core audio types — ported from desktop `src/renderer/types/audio.ts`.
+// Kept field-for-field so desktop logic (queue, EQ, library) ports cleanly later.
+
+// Track metadata
+export interface Track {
+  id: string;
+  path: string;
+  origin?: 'library' | 'associated-external';
+  title: string;
+  artist: string;
+  artistNames?: string[];
+  album: string;
+  albumArtist?: string;
+  albumArtistNames?: string[];
+  albumIdentityKey?: string;
+  duration: number;
+  trackNumber?: number;
+  discNumber?: number;
+  year?: number;
+  genre?: string;
+  artworkData?: string; // Base64 data URL (for files opened directly)
+  artworkHash?: string; // Hash for cached artwork (for library tracks)
+  format: string;
+  sampleRate?: number;
+  bitDepth?: number;
+  bitrate?: number;
+  channels?: number;
+  codec?: string;
+  codecProfile?: string;
+  isAtmosJoc?: boolean;
+  replayGainTrackDb?: number;
+  replayGainAlbumDb?: number;
+  sourceType?: 'local' | 'subsonic' | 'jellyfin';
+  sourceId?: number;
+  sourceTrackId?: string;
+  sourcePath?: string;
+  isAvailable?: boolean;
+  availabilityReason?: string;
+}
+
+// Playback state
+export type PlaybackState = 'stopped' | 'playing' | 'paused' | 'loading';
+
+// Player store state (subset realized at M0; expands toward desktop PlayerStore)
+export interface PlayerState {
+  currentTrack: Track | null;
+  playbackState: PlaybackState;
+  currentTime: number;
+  duration: number;
+  volume: number;
+  isMuted: boolean;
+}
+
+// EQ Band
+export interface EQBand {
+  id: string;
+  type: 'lowshelf' | 'peaking' | 'highshelf' | 'highpass' | 'lowpass';
+  frequency: number;
+  gain: number;
+  Q: number;
+}
+
+// EQ Preset
+export interface EQPreset {
+  id: string;
+  name: string;
+  bands: EQBand[];
+  preamp: number;
+  isCustom?: boolean;
+}
+
+// Visualizer config (scopes land at M3)
+export interface VisualizerConfig {
+  type: 'oscilloscope' | 'spectrum' | 'spectrogram' | 'vu' | 'loudness' | 'stereo';
+  fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+  pitchLock?: boolean;
+  scale?: 'linear' | 'log' | 'mel';
+}

src/types/library.ts

@@ -0,0 +1,42 @@
+// Library row types — a mobile subset of desktop `DbTrack` (libraryStore.ts).
+// SQLite-backed scanning lands at M1; this shape lets the store/UI be typed now.
+
+export type TrackSourceType = 'local' | 'subsonic' | 'jellyfin';
+
+export interface DbTrack {
+  id: number;
+  path: string;
+  title: string;
+  artist: string;
+  album: string;
+  album_artist: string | null;
+  duration: number;
+  track_number: number | null;
+  disc_number: number | null;
+  year: number | null;
+  genre: string | null;
+  artwork_hash: string | null;
+  format: string;
+  sample_rate: number | null;
+  bit_depth: number | null;
+  bitrate: number | null;
+  channels: number | null;
+  codec: string | null;
+  source_type: TrackSourceType;
+  added_at: number;
+}
+
+export interface Album {
+  identity_key: string;
+  album: string;
+  artist: string;
+  year: number | null;
+  artwork_hash: string | null;
+  track_count: number;
+}
+
+export interface Artist {
+  artist: string;
+  track_count: number;
+  artwork_hash: string | null;
+}