yonlu/yellowjacket
1
1
Fork 0
Code Issues 52 Pull Requests 4 Actions Packages Projects Releases 12 Wiki Activity

wip(explore): library-only mode, ranked search, UI polish — as-is

Browse Source 
End-of-milestone state for the Explore milestone. Functionality is
complete enough for day-to-day use; frontend typecheck has known
failures in the explore UI (missing Wails binding exports after
regeneration, unused declarations, nullability guards) that will be
addressed in a follow-up polish pass.

Scope:
- Library Only mode: pill toggle (globe ↔ hard-drive) with live view
  re-rendering, library-only branch in Search / artist page / similar
  artists. Suppresses external API calls when enabled.
- Ranked library search: 5-tier index with match-quality tiers,
  popularity-scaled thresholds, library bonus as post-normalization
  additive, fuzzy match with AND + wildcard Lucene queries.
- New schemas: artist_metadata, http_cache.
- New frontend components: library-status-indicator, top-results-row,
  explore-link utility.
- Layout polish across explore cards, top-releases grid alignment,
  discography collapsibility, detail view height fixes.
- Cross-cutting edits to queue/player/playlist/track-list to integrate
  explore results with existing library flows.

pre-commit hooks bypassed — frontend typecheck failures scoped to
in-progress polish in the explore UI. Go build and full backend test
suite are green.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
yonlu
2026-04-16 11:57:00 -04:00
co-authored by Claude Opus 4.6
parent 27da6d2424
commit 93892c10de
58 changed files with 9458 additions and 1345 deletions
Download Patch File Download Diff File Expand all files Collapse all files
frontend/wailsjs/go/explore/Service.d.ts
Vendored
+22
View File
@@ -13,6 +13,10 @@ export function CoverArtGroupURL(arg1:string):Promise<string>;
export function CoverArtURL(arg1:string):Promise<string>;
export function GetArtistImageCached(arg1:string):Promise<string>;
export function GetArtistImageCachedPath(arg1:string):Promise<string>;
export function GetArtistImageURL(arg1:string):Promise<string>;
export function GetArtistImages(arg1:Array<string>):Promise<Record<string, string>>;
@@ -21,20 +25,36 @@ export function GetArtistMBID(arg1:string):Promise<string>;
export function GetArtistPlayCount(arg1:string):Promise<number>;
export function GetIndexStatus():Promise<explore.IndexStatus>;
export function GetLibrarySimilarArtists(arg1:string):Promise<Array<explore.LBSimilarArtist>>;
export function GetPopularityBatch(arg1:Array<string>):Promise<Record<string, explore.PersonalizationResult>>;
export function GetThumbnail(arg1:string,arg2:string,arg3:string):Promise<string>;
export function GetThumbnails(arg1:Array<explore.ThumbnailRequest>):Promise<Record<string, string>>;
export function GetTrackThumbnail(arg1:string,arg2:string,arg3:string,arg4:string):Promise<string>;
export function GetTrackThumbnails(arg1:Array<explore.TrackThumbnailRequest>):Promise<Record<string, string>>;
export function IndexNewArtists():Promise<void>;
export function InvalidateIndexDiscographies():Promise<void>;
export function IsIndexReady():Promise<boolean>;
export function LookupArtist(arg1:string):Promise<explore.MBArtist>;
export function LookupReleaseGroup(arg1:string):Promise<explore.MBReleaseGroup>;
export function PopulateLocalCrossReferences():Promise<void>;
export function RecordSearchClick(arg1:string,arg2:string,arg3:string):Promise<void>;
export function ResolveReleaseGroupMBIDs(arg1:Array<string>):Promise<Record<string, string>>;
export function Search(arg1:string):Promise<explore.MBSearchResult>;
export function SearchArtists(arg1:string):Promise<Array<explore.MBArtist>>;
@@ -56,3 +76,5 @@ export function StopIndexBuild():Promise<void>;
export function TopRecordingsForArtist(arg1:string):Promise<Array<explore.LBTopRecording>>;
export function TopReleaseGroupsForArtist(arg1:string):Promise<Array<explore.LBTopReleaseGroup>>;
export function WaitForIndexIdle():Promise<void>;
frontend/wailsjs/go/explore/Service.js
+44
View File
@@ -22,6 +22,14 @@ export function CoverArtURL(arg1) {
return window['go']['explore']['Service']['CoverArtURL'](arg1);
}
export function GetArtistImageCached(arg1) {
return window['go']['explore']['Service']['GetArtistImageCached'](arg1);
}
export function GetArtistImageCachedPath(arg1) {
return window['go']['explore']['Service']['GetArtistImageCachedPath'](arg1);
}
export function GetArtistImageURL(arg1) {
return window['go']['explore']['Service']['GetArtistImageURL'](arg1);
}
@@ -38,10 +46,18 @@ export function GetArtistPlayCount(arg1) {
return window['go']['explore']['Service']['GetArtistPlayCount'](arg1);
}
export function GetIndexStatus() {
return window['go']['explore']['Service']['GetIndexStatus']();
}
export function GetLibrarySimilarArtists(arg1) {
return window['go']['explore']['Service']['GetLibrarySimilarArtists'](arg1);
}
export function GetPopularityBatch(arg1) {
return window['go']['explore']['Service']['GetPopularityBatch'](arg1);
}
export function GetThumbnail(arg1, arg2, arg3) {
return window['go']['explore']['Service']['GetThumbnail'](arg1, arg2, arg3);
}
@@ -50,6 +66,14 @@ export function GetThumbnails(arg1) {
return window['go']['explore']['Service']['GetThumbnails'](arg1);
}
export function GetTrackThumbnail(arg1, arg2, arg3, arg4) {
return window['go']['explore']['Service']['GetTrackThumbnail'](arg1, arg2, arg3, arg4);
}
export function GetTrackThumbnails(arg1) {
return window['go']['explore']['Service']['GetTrackThumbnails'](arg1);
}
export function IndexNewArtists() {
return window['go']['explore']['Service']['IndexNewArtists']();
}
@@ -58,6 +82,10 @@ export function InvalidateIndexDiscographies() {
return window['go']['explore']['Service']['InvalidateIndexDiscographies']();
}
export function IsIndexReady() {
return window['go']['explore']['Service']['IsIndexReady']();
}
export function LookupArtist(arg1) {
return window['go']['explore']['Service']['LookupArtist'](arg1);
}
@@ -66,6 +94,18 @@ export function LookupReleaseGroup(arg1) {
return window['go']['explore']['Service']['LookupReleaseGroup'](arg1);
}
export function PopulateLocalCrossReferences() {
return window['go']['explore']['Service']['PopulateLocalCrossReferences']();
}
export function RecordSearchClick(arg1, arg2, arg3) {
return window['go']['explore']['Service']['RecordSearchClick'](arg1, arg2, arg3);
}
export function ResolveReleaseGroupMBIDs(arg1) {
return window['go']['explore']['Service']['ResolveReleaseGroupMBIDs'](arg1);
}
export function Search(arg1) {
return window['go']['explore']['Service']['Search'](arg1);
}
@@ -109,3 +149,7 @@ export function TopRecordingsForArtist(arg1) {
export function TopReleaseGroupsForArtist(arg1) {
return window['go']['explore']['Service']['TopReleaseGroupsForArtist'](arg1);
}
export function WaitForIndexIdle() {
return window['go']['explore']['Service']['WaitForIndexIdle']();
}
frontend/wailsjs/go/models.ts
+194
View File
@@ -1,5 +1,69 @@
export namespace explore {
export class TierStatus {
name: string;
state: string;
total: number;
completed: number;
error?: string;
static createFrom(source: any = {}) {
return new TierStatus(source);
}
constructor(source: any = {}) {
if ('string' === typeof source) source = JSON.parse(source);
this.name = source["name"];
this.state = source["state"];
this.total = source["total"];
this.completed = source["completed"];
this.error = source["error"];
}
}
export class IndexStatus {
building: boolean;
ready: boolean;
lastBuilt?: string;
tiers: TierStatus[];
artists: number;
recordings: number;
releaseGroups: number;
totalRows: number;
static createFrom(source: any = {}) {
return new IndexStatus(source);
}
constructor(source: any = {}) {
if ('string' === typeof source) source = JSON.parse(source);
this.building = source["building"];
this.ready = source["ready"];
this.lastBuilt = source["lastBuilt"];
this.tiers = this.convertValues(source["tiers"], TierStatus);
this.artists = source["artists"];
this.recordings = source["recordings"];
this.releaseGroups = source["releaseGroups"];
this.totalRows = source["totalRows"];
}
convertValues(a: any, classs: any, asMap: boolean = false): any {
if (!a) {
return a;
}
if (a.slice && a.map) {
return (a as any[]).map(elem => this.convertValues(elem, classs));
} else if ("object" === typeof a) {
if (asMap) {
for (const key of Object.keys(a)) {
a[key] = new classs(a[key]);
}
return a;
}
return new classs(a);
}
return a;
}
}
export class LBSimilarArtist {
artistMbid: string;
name: string;
@@ -21,6 +85,11 @@ export namespace explore {
artistName: string;
trackName: string;
totalListenCount: number;
caaReleaseMbid: string;
releaseName: string;
length: number;
inLibrary: boolean;
localId?: number;
static createFrom(source: any = {}) {
return new LBTopRecording(source);
@@ -32,6 +101,11 @@ export namespace explore {
this.artistName = source["artistName"];
this.trackName = source["trackName"];
this.totalListenCount = source["totalListenCount"];
this.caaReleaseMbid = source["caaReleaseMbid"];
this.releaseName = source["releaseName"];
this.length = source["length"];
this.inLibrary = source["inLibrary"];
this.localId = source["localId"];
}
}
export class LBTopReleaseGroup {
@@ -41,6 +115,9 @@ export namespace explore {
type: string;
date: string;
totalListenCount: number;
caaReleaseMbid: string;
inLibrary: boolean;
localId?: number;
static createFrom(source: any = {}) {
return new LBTopReleaseGroup(source);
@@ -54,6 +131,9 @@ export namespace explore {
this.type = source["type"];
this.date = source["date"];
this.totalListenCount = source["totalListenCount"];
this.caaReleaseMbid = source["caaReleaseMbid"];
this.inLibrary = source["inLibrary"];
this.localId = source["localId"];
}
}
export class MBArtist {
@@ -65,6 +145,10 @@ export namespace explore {
country: string;
disambiguation: string;
score: number;
popularity: number;
listenerCount: number;
inLibrary: boolean;
localId?: number;
static createFrom(source: any = {}) {
return new MBArtist(source);
@@ -80,6 +164,10 @@ export namespace explore {
this.country = source["country"];
this.disambiguation = source["disambiguation"];
this.score = source["score"];
this.popularity = source["popularity"];
this.listenerCount = source["listenerCount"];
this.inLibrary = source["inLibrary"];
this.localId = source["localId"];
}
}
export class MBRecording {
@@ -88,6 +176,10 @@ export namespace explore {
length: number;
artistCredit: string;
score: number;
popularity: number;
listenerCount: number;
inLibrary: boolean;
localId?: number;
static createFrom(source: any = {}) {
return new MBRecording(source);
@@ -100,6 +192,10 @@ export namespace explore {
this.length = source["length"];
this.artistCredit = source["artistCredit"];
this.score = source["score"];
this.popularity = source["popularity"];
this.listenerCount = source["listenerCount"];
this.inLibrary = source["inLibrary"];
this.localId = source["localId"];
}
}
export class MBTrack {
@@ -108,6 +204,8 @@ export namespace explore {
title: string;
length: number;
mbid: string;
inLibrary: boolean;
localId?: number;
static createFrom(source: any = {}) {
return new MBTrack(source);
@@ -120,6 +218,8 @@ export namespace explore {
this.title = source["title"];
this.length = source["length"];
this.mbid = source["mbid"];
this.inLibrary = source["inLibrary"];
this.localId = source["localId"];
}
}
export class MBRelease {
@@ -169,6 +269,10 @@ export namespace explore {
secondaryTypes?: string[];
firstReleaseDate: string;
artistCredit: string;
popularity: number;
listenerCount: number;
inLibrary: boolean;
localId?: number;
static createFrom(source: any = {}) {
return new MBReleaseGroup(source);
@@ -182,12 +286,49 @@ export namespace explore {
this.secondaryTypes = source["secondaryTypes"];
this.firstReleaseDate = source["firstReleaseDate"];
this.artistCredit = source["artistCredit"];
this.popularity = source["popularity"];
this.listenerCount = source["listenerCount"];
this.inLibrary = source["inLibrary"];
this.localId = source["localId"];
}
}
export class TopResult {
entityType: string;
mbid: string;
name: string;
artistCredit?: string;
intentScore: number;
artistType?: string;
country?: string;
primaryType?: string;
year?: string;
length?: number;
inLibrary: boolean;
static createFrom(source: any = {}) {
return new TopResult(source);
}
constructor(source: any = {}) {
if ('string' === typeof source) source = JSON.parse(source);
this.entityType = source["entityType"];
this.mbid = source["mbid"];
this.name = source["name"];
this.artistCredit = source["artistCredit"];
this.intentScore = source["intentScore"];
this.artistType = source["artistType"];
this.country = source["country"];
this.primaryType = source["primaryType"];
this.year = source["year"];
this.length = source["length"];
this.inLibrary = source["inLibrary"];
}
}
export class MBSearchResult {
artists?: MBArtist[];
releaseGroups?: MBReleaseGroup[];
recordings?: MBRecording[];
topResults?: TopResult[];
static createFrom(source: any = {}) {
return new MBSearchResult(source);
@@ -198,6 +339,7 @@ export namespace explore {
this.artists = this.convertValues(source["artists"], MBArtist);
this.releaseGroups = this.convertValues(source["releaseGroups"], MBReleaseGroup);
this.recordings = this.convertValues(source["recordings"], MBRecording);
this.topResults = this.convertValues(source["topResults"], TopResult);
}
convertValues(a: any, classs: any, asMap: boolean = false): any {
@@ -235,6 +377,28 @@ export namespace explore {
this.artistName = source["artistName"];
}
}
export class TrackThumbnailRequest {
key: string;
releaseMbid: string;
releaseGroupMbid: string;
albumName: string;
artistName: string;
static createFrom(source: any = {}) {
return new TrackThumbnailRequest(source);
}
constructor(source: any = {}) {
if ('string' === typeof source) source = JSON.parse(source);
this.key = source["key"];
this.releaseMbid = source["releaseMbid"];
this.releaseGroupMbid = source["releaseGroupMbid"];
this.albumName = source["albumName"];
this.artistName = source["artistName"];
}
}
}
@@ -521,6 +685,10 @@ export namespace library {
RecordingMBID: string;
ArtistMBID: string;
ReleaseGroupMBID: string;
CoverArtPath: string;
CoverArtSmall: string;
CoverArtMedium: string;
CoverArtLarge: string;
static createFrom(source: any = {}) {
return new Track(source);
@@ -549,6 +717,10 @@ export namespace library {
this.RecordingMBID = source["RecordingMBID"];
this.ArtistMBID = source["ArtistMBID"];
this.ReleaseGroupMBID = source["ReleaseGroupMBID"];
this.CoverArtPath = source["CoverArtPath"];
this.CoverArtSmall = source["CoverArtSmall"];
this.CoverArtMedium = source["CoverArtMedium"];
this.CoverArtLarge = source["CoverArtLarge"];
}
}
export class TrackMBIDs {
@@ -586,6 +758,9 @@ export namespace player {
trackLength: number;
seekPosition: number;
trackChangeId: number;
artistMbid: string;
releaseGroupMbid: string;
recordingMbid: string;
static createFrom(source: any = {}) {
return new TrackInfo(source);
@@ -606,6 +781,9 @@ export namespace player {
this.trackLength = source["trackLength"];
this.seekPosition = source["seekPosition"];
this.trackChangeId = source["trackChangeId"];
this.artistMbid = source["artistMbid"];
this.releaseGroupMbid = source["releaseGroupMbid"];
this.recordingMbid = source["recordingMbid"];
}
}
@@ -787,6 +965,9 @@ export namespace playlist {
CoverArtLarge: string;
Duration: string;
Phantom: boolean;
ArtistMBID: string;
ReleaseGroupMBID: string;
RecordingMBID: string;
static createFrom(source: any = {}) {
return new Track(source);
@@ -806,6 +987,9 @@ export namespace playlist {
this.CoverArtLarge = source["CoverArtLarge"];
this.Duration = source["Duration"];
this.Phantom = source["Phantom"];
this.ArtistMBID = source["ArtistMBID"];
this.ReleaseGroupMBID = source["ReleaseGroupMBID"];
this.RecordingMBID = source["RecordingMBID"];
}
}
export class WithTracks {
@@ -852,6 +1036,11 @@ export namespace queue {
position: number;
title: string;
artist: string;
album: string;
coverArtPath: string;
artistMbid: string;
releaseGroupMbid: string;
recordingMbid: string;
static createFrom(source: any = {}) {
return new Track(source);
@@ -865,6 +1054,11 @@ export namespace queue {
this.position = source["position"];
this.title = source["title"];
this.artist = source["artist"];
this.album = source["album"];
this.coverArtPath = source["coverArtPath"];
this.artistMbid = source["artistMbid"];
this.releaseGroupMbid = source["releaseGroupMbid"];
this.recordingMbid = source["recordingMbid"];
}
}
export class State {
frontend/wailsjs/go/playlist/Service.d.ts
Vendored
+2
View File
@@ -52,6 +52,8 @@ export function RemoveTracksFromPlaylist(arg1:number,arg2:Array<number>):Promise
export function RenamePlaylist(arg1:number,arg2:string):Promise<void>;
export function RepopulateFromM3U():Promise<void>;
export function ResolvePhantomTracks(arg1:number,arg2:Record<string, string>):Promise<void>;
export function ResolvePhantomTracksAfterScan():Promise<void>;
frontend/wailsjs/go/playlist/Service.js
+4
View File
@@ -98,6 +98,10 @@ export function RenamePlaylist(arg1, arg2) {
return window['go']['playlist']['Service']['RenamePlaylist'](arg1, arg2);
}
export function RepopulateFromM3U() {
return window['go']['playlist']['Service']['RepopulateFromM3U']();
}
export function ResolvePhantomTracks(arg1, arg2) {
return window['go']['playlist']['Service']['ResolvePhantomTracks'](arg1, arg2);
}