feat(enrichment): oximedia BPM/mood facts, mood search, and queue display (#863)

* feat(enrichment): oximedia BPM/mood facts, mood search, and queue UI Run client-side oximedia analysis after CPU seed and persist BPM, mood JSON, and searchable mood_tag facts. Add product mood groups (joy/sadness/dance/work/ romance) with Advanced Search filter on the local index, queue BPM/mood display, migration 008 mood_tag index, and refreshed licenses for oximedia crates. * fix(enrichment): keep mood_groups module comment in English * feat(search): virtual mood groups, anger filter, and Advanced Search UX Expand mood search via overlapping virtual groups (tag expansion only), add anger/Злость group, skip album/artist shortcuts for track-only filters, and simplify mood search UI (songs-only, hide type tabs). Fix CustomSelect spurious scrollbar on short option lists. * feat(analysis): unified track analysis plan and enqueue path Add TrackAnalysisPlan (waveform, LUFS, enrichment) with a single enqueue_track_analysis entry for all byte-backed triggers. Run enrichment when cache is full but library facts are missing; route playback, cache, and backfill through the planner. Fix browseTextSearch LocalSearchOpts tsc gap and remove obsolete read_seed_bytes_if_needed helper. * fix(analysis): wire playback dispatch, preload enrichment, and UI refresh Route stream, gapless, preload, and local-file playback through analysis_dispatch so BPM/mood enrichment runs when waveform/LUFS are already cached. Fix audio_preload cache-hit and hot-cache paths, emit preload-cancelled for retry, and add analysis:enrichment-updated plus content_cache_coverage key resolution. * fix(audio): preload local files from disk and stop analysis retry loop Seed hot/offline next tracks via LocalFilePlayback (512 MiB) instead of copying into the RAM preload slot. Keep bytePreloadingId set after preload-ready so progress ticks do not re-invoke audio_preload every second. * fix(enrichment): clippy, album bpm filter routing, and queue mood display Clippy-clean analysis_dispatch and engine imports; restrict track-derived album routing to mood_group/mood_tag only so bpm is skipped on album queries. Log enrichment plan errors with retry-all plan; filter queue mood labels to oximedia ids. * fix(enrichment): simplify mood_tag backfill branch in plan_track_enrichment Remove empty if-block; keep same behaviour when backfill fails and moods row exists. * docs: CHANGELOG and credits for track enrichment PR #863 * docs(credits): track enrichment PR #863 contributor line * chore(enrichment): clippy-clean plan branch and trim dead exports Collapse mood_tag backfill if for clippy; remove unused moodGroupById and OXIMEDIA_MOOD_LABELS re-exports; stop poll when server BPM is already known. * fix(enrichment): close R2/S1–S3 limits and Song Info BPM fallback Return TrackEnrichmentOutcome::Failed on oximedia errors so retries are not masked as complete; extract mood Advanced Search SQL, unify top-3 mood tag selection in mood_groups with TS invariant tests, and show measured BPM in Song Info when tag BPM is missing or zero. * fix(enrichment): restore offline coverage and show mood in Song Info Add unit tests for offline download cancel/clear registry after the analysis seed refactor dropped read_seed_bytes coverage; show localized mood labels in Song Info when library enrichment facts exist. * fix(enrichment): soft mood scoring and unblock offline cancel tests Replace oximedia quadrant happy/excited mapping with valence/arousal soft scores across all mood tags for display, storage, and backfill; fix offline cancel unit tests that deadlocked by calling clear while holding the global offline_cancel_flags mutex. * fix(enrichment): dedupe joy cluster and cap mood display at two labels Never show happy and excited together; pick one tag per V/A cluster, tighten oximedia recalibration, and limit queue/Song Info to two moods that pass a relative score floor. * fix(enrichment): disable oximedia mood labels in UI and search tags Oximedia 0.1.7 mood is a spectral energy heuristic, not independent mood weights; valence correlates with loud/bright audio and false-labels metal and lyrical tracks as happy. Hide queue/Song Info mood and stop writing mood_tag facts until a reliable detector lands; keep V/A/moods JSON stored. * fix(enrichment): disable oximedia mood analysis and add BPM advanced search Stop planning, running, and storing oximedia mood facts; purge accumulated mood rows via migration 009. Hide mood filters in Advanced Search, expose BPM range filter with dual-storage resolution, and show a BPM column in song results when that filter is active. * feat(search): analysis BPM priority, source tooltip, and filter UX Prefer analysis track_fact over file tags for BPM resolution; show source in list tooltips. Validate BPM range on blur, add clear button, fix double tooltip. * fix(enrichment): prefer analysis BPM in Song Info and queue tech row Show measured track_fact BPM before file tags until analysis completes; pick the highest-confidence analysis fact when several exist.
2026-07-22 14:35:41 +00:00 · 2026-05-23 18:54:04 +03:00
parent 67b1dc790b
commit 003b280a77
92 changed files with 4566 additions and 492 deletions
@@ -0,0 +1,100 @@
+import { useEffect, useState } from 'react';
+import { listen } from '@tauri-apps/api/event';
+import { libraryGetFacts, libraryGetTrack } from '../api/library';
+import { usePlaybackServerId } from './usePlaybackServerId';
+import { useLibraryIndexStore } from '../store/libraryIndexStore';
+import {
+  enrichmentDisplayComplete,
+  OXIMEDIA_MOOD_UI_ENABLED,
+  parseTrackEnrichmentFacts,
+  type ParsedTrackEnrichment,
+} from '../utils/library/trackEnrichment';
+import { libraryIsReady } from '../utils/library/libraryReady';
+import { normalizeAnalysisTrackId } from '../utils/playback/queueIdentity';
+
+const EMPTY: ParsedTrackEnrichment = {
+  serverBpm: null,
+  measuredBpm: null,
+  moodLabels: [],
+};
+
+/** Enrichment may finish several seconds after CPU seed / playback start. */
+const REFETCH_MS = [3_000, 8_000, 15_000, 30_000, 60_000] as const;
+
+const ENRICHMENT_FACT_KINDS = OXIMEDIA_MOOD_UI_ENABLED
+  ? (['bpm', 'moods', 'mood_tag', 'mood_labels', 'valence', 'arousal'] as const)
+  : (['bpm'] as const);
+
+/**
+ * Loads server BPM + oximedia mood facts for the queue "now playing" block.
+ * Uses the playback server id (queue scope), not the browsed server.
+ */
+export function useQueueTrackEnrichment(trackId: string | undefined): ParsedTrackEnrichment {
+  const serverId = usePlaybackServerId();
+  const indexEnabled = useLibraryIndexStore(s =>
+    serverId ? s.isIndexEnabled(serverId) : false,
+  );
+  const [data, setData] = useState<ParsedTrackEnrichment>(EMPTY);
+  const [refreshNonce, setRefreshNonce] = useState(0);
+
+  useEffect(() => {
+    if (!serverId || !trackId || !indexEnabled) {
+      setData(EMPTY);
+      return;
+    }
+
+    let cancelled = false;
+    const timers: ReturnType<typeof setTimeout>[] = [];
+
+    const load = async () => {
+      if (!(await libraryIsReady(serverId))) return;
+      try {
+        const [track, facts] = await Promise.all([
+          libraryGetTrack(serverId, trackId),
+          libraryGetFacts(serverId, trackId, [...ENRICHMENT_FACT_KINDS]),
+        ]);
+        if (cancelled) return;
+        const parsed = parseTrackEnrichmentFacts(facts, track?.bpm ?? null);
+        setData(parsed);
+        if (enrichmentDisplayComplete(parsed)) {
+          for (const id of timers) clearTimeout(id);
+          timers.length = 0;
+        }
+      } catch {
+        if (!cancelled) setData(EMPTY);
+      }
+    };
+
+    void load();
+    for (const ms of REFETCH_MS) {
+      timers.push(setTimeout(() => { void load(); }, ms));
+    }
+
+    return () => {
+      cancelled = true;
+      for (const id of timers) clearTimeout(id);
+    };
+  }, [serverId, trackId, indexEnabled, refreshNonce]);
+
+  useEffect(() => {
+    if (!serverId || !trackId || !indexEnabled) return;
+
+    let unlisten: (() => void) | undefined;
+    void listen<{ trackId: string; serverId: string }>('analysis:enrichment-updated', ({ payload }) => {
+      if (!payload?.trackId) return;
+      const eventTrackId = normalizeAnalysisTrackId(payload.trackId);
+      const currentId = normalizeAnalysisTrackId(trackId);
+      if (!eventTrackId || eventTrackId !== currentId) return;
+      if (payload.serverId && payload.serverId !== serverId) return;
+      setRefreshNonce(n => n + 1);
+    }).then(fn => {
+      unlisten = fn;
+    });
+
+    return () => {
+      unlisten?.();
+    };
+  }, [serverId, trackId, indexEnabled]);
+
+  return data;
+}