fix: virtual list and cover grid (#63)

* very basic slow buggy queue

* cover grid can now add albums to queue

* added virtualized lists to track list and cover grid components

backend/database/sql/sqlcgen/playlists.sql.go

@@ -1,6 +1,6 @@
 // Code generated by sqlc. DO NOT EDIT.
 // versions:
-//   sqlc v1.30.0
+//   sqlc v1.29.0
 // source: playlists.sql
 
 package sqlcgen

backend/database/sql/sqlcgen/queue.sql.go

@@ -1,6 +1,6 @@
 // Code generated by sqlc. DO NOT EDIT.
 // versions:
-//   sqlc v1.30.0
+//   sqlc v1.29.0
 // source: queue.sql
 
 package sqlcgen

backend/queue/queue.go

@@ -38,8 +38,8 @@ type TrackLoader interface {
 	CurrentPositionSeconds() (int, error)
 }
 
-// Track represents a track in the queue with its metadata.
-type Track struct {
+// QueueTrack represents a track in the queue with its metadata.
+type QueueTrack struct {
 	ID          int64  `json:"id"`
 	AudioFileID int64  `json:"audioFileId"`
 	FilePath    string `json:"filePath"`
@@ -48,13 +48,13 @@ type Track struct {
 	Artist      string `json:"artist"`
 }
 
-// State is the full state emitted to the frontend.
-type State struct {
-	Tracks           []Track    `json:"tracks"`
-	CurrentIndex     int        `json:"currentIndex"`
-	ShuffleMode      bool       `json:"shuffleMode"`
-	RepeatMode       RepeatMode `json:"repeatMode"`
-	SourcePlaylistID int64      `json:"sourcePlaylistId"`
+// QueueState is the full state emitted to the frontend.
+type QueueState struct {
+	Tracks           []QueueTrack `json:"tracks"`
+	CurrentIndex     int          `json:"currentIndex"`
+	ShuffleMode      bool         `json:"shuffleMode"`
+	RepeatMode       RepeatMode   `json:"repeatMode"`
+	SourcePlaylistID int64        `json:"sourcePlaylistId"`
 }
 
 // Queue manages an ordered list of tracks for playback.
@@ -65,7 +65,7 @@ type Queue struct {
 	player TrackLoader
 
 	mu               sync.Mutex
-	tracks           []Track
+	tracks           []QueueTrack
 	currentIndex     int
 	shuffleMode      bool
 	repeatMode       RepeatMode
@@ -331,7 +331,7 @@ func (q *Queue) SetQueue(filePaths []string, startIndex int) {
 	defer q.mu.Unlock()
 
 	// Look up audio file IDs and metadata for all paths.
-	tracks := make([]Track, 0, len(filePaths))
+	tracks := make([]QueueTrack, 0, len(filePaths))
 
 	for i, fp := range filePaths {
 		af, err := q.db.Queries.GetAudioFileByPath(q.db.Ctx, fp)
@@ -341,7 +341,7 @@ func (q *Queue) SetQueue(filePaths []string, startIndex int) {
 			continue
 		}
 
-		track := Track{
+		track := QueueTrack{
 			AudioFileID: af.ID,
 			FilePath:    fp,
 			Position:    int64(i),
@@ -395,7 +395,7 @@ func (q *Queue) AddTrack(filePath string) {
 
 	wasEmpty := len(q.tracks) == 0
 
-	track := Track{
+	track := QueueTrack{
 		AudioFileID: af.ID,
 		FilePath:    filePath,
 		Position:    int64(len(q.tracks)),
@@ -449,7 +449,7 @@ func (q *Queue) AddTracks(filePaths []string) {
 			continue
 		}
 
-		track := Track{
+		track := QueueTrack{
 			AudioFileID: af.ID,
 			FilePath:    fp,
 			Position:    int64(len(q.tracks)),
@@ -490,8 +490,7 @@ func (q *Queue) InsertNextTracks(filePaths []string) {
 	}
 
 	wasEmpty := len(q.tracks) == 0
-
-	var newTracks []Track
+	var newTracks []QueueTrack
 
 	for _, fp := range filePaths {
 		af, err := q.db.Queries.GetAudioFileByPath(q.db.Ctx, fp)
@@ -501,7 +500,7 @@ func (q *Queue) InsertNextTracks(filePaths []string) {
 			continue
 		}
 
-		track := Track{
+		track := QueueTrack{
 			AudioFileID: af.ID,
 			FilePath:    fp,
 		}
@@ -520,7 +519,7 @@ func (q *Queue) InsertNextTracks(filePaths []string) {
 	}
 
 	// Insert the block into the slice at insertPos.
-	tail := make([]Track, len(q.tracks[insertPos:]))
+	tail := make([]QueueTrack, len(q.tracks[insertPos:]))
 	copy(tail, q.tracks[insertPos:])
 	q.tracks = append(q.tracks[:insertPos], newTracks...)
 	q.tracks = append(q.tracks, tail...)
@@ -559,7 +558,7 @@ func (q *Queue) InsertNext(filePath string) {
 		insertPos = len(q.tracks)
 	}
 
-	track := Track{
+	track := QueueTrack{
 		AudioFileID: af.ID,
 		FilePath:    filePath,
 		Position:    int64(insertPos),
@@ -573,7 +572,7 @@ func (q *Queue) InsertNext(filePath string) {
 	}
 
 	// Insert into slice.
-	q.tracks = append(q.tracks, Track{})
+	q.tracks = append(q.tracks, QueueTrack{})
 	copy(q.tracks[insertPos+1:], q.tracks[insertPos:])
 	q.tracks[insertPos] = track
 
@@ -711,14 +710,14 @@ func (q *Queue) CycleRepeat() {
 }
 
 // GetState returns the current queue state for the frontend.
-func (q *Queue) GetState() State {
+func (q *Queue) GetState() QueueState {
 	q.mu.Lock()
 	defer q.mu.Unlock()
 
-	tracks := make([]Track, len(q.tracks))
+	tracks := make([]QueueTrack, len(q.tracks))
 	copy(tracks, q.tracks)
 
-	return State{
+	return QueueState{
 		Tracks:           tracks,
 		CurrentIndex:     q.currentIndex,
 		ShuffleMode:      q.shuffleMode,
@@ -791,10 +790,10 @@ func (q *Queue) RestoreState() {
 		return
 	}
 
-	q.tracks = make([]Track, 0, len(rows))
+	q.tracks = make([]QueueTrack, 0, len(rows))
 
 	for _, row := range rows {
-		q.tracks = append(q.tracks, Track{
+		q.tracks = append(q.tracks, QueueTrack{
 			ID:          row.ID,
 			AudioFileID: row.AudioFileID,
 			FilePath:    row.FilePath,
@@ -955,25 +954,13 @@ func (q *Queue) playCurrentTrack() {
 	}
 
 	if q.currentIndex < 0 || q.currentIndex >= len(q.tracks) {
-		q.logger.Warn(
-			"Current index out of range",
-			"index",
-			q.currentIndex,
-			"trackCount",
-			len(q.tracks),
-		)
+		q.logger.Warn("Current index out of range", "index", q.currentIndex, "trackCount", len(q.tracks))
 
 		return
 	}
 
 	track := q.tracks[q.currentIndex]
-	q.logger.Info(
-		"Playing track from queue",
-		"filePath",
-		track.FilePath,
-		"position",
-		q.currentIndex,
-	)
+	q.logger.Info("Playing track from queue", "filePath", track.FilePath, "position", q.currentIndex)
 
 	err := q.player.LoadFile(track.FilePath)
 	if err != nil {
@@ -993,8 +980,8 @@ func (q *Queue) playCurrentTrack() {
 // onQueueExhausted is called when there are no more tracks to play.
 // This is the extension point for a future fallback playlist feature.
 func (q *Queue) onQueueExhausted() {
-	// Future: load fallback playlist here.
 	q.logger.Info("Queue exhausted, stopping playback")
+	// Future: load fallback playlist here.
 }
 
 // reindexPositions updates the Position field of all tracks to match slice index.
@@ -1060,7 +1047,7 @@ func (q *Queue) emitQueueChanged() {
 		return
 	}
 
-	state := State{
+	state := QueueState{
 		Tracks:           q.tracks,
 		CurrentIndex:     q.currentIndex,
 		ShuffleMode:      q.shuffleMode,
@@ -1070,7 +1057,7 @@ func (q *Queue) emitQueueChanged() {
 
 	// Ensure tracks is never nil in JSON.
 	if state.Tracks == nil {
-		state.Tracks = []Track{}
+		state.Tracks = []QueueTrack{}
 	}
 
 	runtime.EventsEmit(q.ctx, events.QueueChanged, state)

frontend/index.css

@@ -112,5 +112,9 @@ body div.sidebar {
     grid-area: main-panel;
     padding: 0.25em;
     background-color: #212529;
-    overflow: auto;
+    overflow: hidden;
+}
+
+.main-panel > * {
+    height: 100%;
 }

frontend/index.ts

@@ -10,10 +10,6 @@ import { setBasePath } from '@awesome.me/webawesome/dist/webawesome.js';
 
 setBasePath('/dist/webawesome');
 
-// Scroll state management per view
-const scrollPositions = new Map<string, number>();
-let currentView = 'tracks';
-
 // Navigation event listener for view switching
 document.addEventListener('navigate', (e: Event) => {
     const { view } = (e as CustomEvent).detail;
@@ -21,9 +17,6 @@ document.addEventListener('navigate', (e: Event) => {
 
     if (!mainContent) return;
 
-    // Save scroll position for current view before switching
-    scrollPositions.set(currentView, mainContent.scrollTop);
-
     switch (view) {
         case 'albums':
             mainContent.innerHTML = '<cover-grid></cover-grid>';
@@ -36,12 +29,6 @@ document.addEventListener('navigate', (e: Event) => {
                 <p>Coming soon: ${view}</p>
             </div>`;
     }
-
-    // Restore scroll position for new view
-    mainContent.scrollTop = scrollPositions.get(view) ?? 0;
-
-    // Update current view tracker
-    currentView = view;
 });
 
 // Queue panel toggle

frontend/package.json

@@ -7,6 +7,7 @@
   "dependencies": {
     "@awesome.me/webawesome": "^3.2.1",
     "@lit-labs/signals": "^0.2.0",
+    "@lit-labs/virtualizer": "^2.1.1",
     "htmx.org": "2.0.8",
     "lit": "^3.2.1"
   },

frontend/package.json.md5

@@ -1 +1 @@
-0abc2bb78bacb130d41b3ed39483ae9f
+02c7eb24a50fc8301be7488868be5860

frontend/src/components/cover-grid/cover-grid.ts

@@ -4,6 +4,8 @@ import { EventsEmit } from '@runtime/runtime';
 import { GetAllAlbums, GetAlbumTracks } from '@go/library/Library';
 import { library } from '@go/models';
 import { QueueController } from '@store/controllers/queue-controller';
+import '@lit-labs/virtualizer';
+import { grid } from '@lit-labs/virtualizer/layouts/grid.js';
 import '@awesome.me/webawesome/dist/components/popup/popup.js';
 import '@awesome.me/webawesome/dist/components/dropdown-item/dropdown-item.js';
 import '@awesome.me/webawesome/dist/components/icon/icon.js';
@@ -16,14 +18,14 @@ export class CoverGrid extends LitElement {
 
     static override styles = css`
         :host {
-            display: block;
+            display: flex;
+            flex-direction: column;
+            overflow: hidden;
         }
 
-        .grid {
-            display: grid;
-            grid-template-columns: repeat(auto-fill, minmax(160px, 1fr));
-            gap: 16px;
-            padding: 16px;
+        lit-virtualizer {
+            flex: 1;
+            overflow-y: auto;
         }
 
         .album-card {
@@ -33,6 +35,7 @@ export class CoverGrid extends LitElement {
             border-radius: 8px;
             padding: 8px;
             transition: background-color 0.2s ease;
+            box-sizing: border-box;
         }
 
         .album-card:hover {
@@ -260,6 +263,61 @@ export class CoverGrid extends LitElement {
         }
     }
 
+    private renderAlbumCard = (album: library.Album): unknown => {
+        return html`
+            <div
+                class="album-card"
+                tabindex="0"
+                role="button"
+                aria-label="${album.Name} by ${album.ArtistName}"
+                @click=${() => this.onAlbumClick(album)}
+                @keydown=${(e: KeyboardEvent) => this.onAlbumKeydown(e, album)}
+                @contextmenu=${(e: MouseEvent) => this.onAlbumContextMenu(e, album)}
+            >
+                <div class="cover-container">
+                    ${album.CoverArtPath
+                        ? html`<img
+                              class="cover-image"
+                              src="${album.CoverArtPath}"
+                              alt="${album.Name} cover"
+                              loading="lazy"
+                          />`
+                        : html`<div class="placeholder-cover">
+                              ${this.getAlbumInitial(album.Name)}
+                          </div>`}
+                </div>
+                <div class="album-info">
+                    <div class="album-name" title="${album.Name}">${album.Name}</div>
+                    <div class="artist-name" title="${album.ArtistName}">
+                        ${album.ArtistName}${album.Year ? ` - ${album.Year}` : ''}
+                    </div>
+                </div>
+            </div>
+        `;
+    };
+
+    private getAlbumInitial(name: string): string {
+        return name.charAt(0).toUpperCase();
+    }
+
+    private onAlbumClick(album: library.Album) {
+        EventsEmit('AlbumSelected', album);
+        this.dispatchEvent(
+            new CustomEvent('album-selected', {
+                detail: album,
+                bubbles: true,
+                composed: true,
+            })
+        );
+    }
+
+    private onAlbumKeydown(e: KeyboardEvent, album: library.Album) {
+        if (e.key === 'Enter' || e.key === ' ') {
+            e.preventDefault();
+            this.onAlbumClick(album);
+        }
+    }
+
     override render() {
         if (this.loading) {
             return html`<div class="loading">Loading albums...</div>`;
@@ -275,9 +333,16 @@ export class CoverGrid extends LitElement {
         }
 
         return html`
-            <div class="grid">
-                ${this.albums.map(album => this.renderAlbumCard(album))}
-            </div>
+            <lit-virtualizer
+                scroller
+                .items=${this.albums}
+                .renderItem=${this.renderAlbumCard}
+                .layout=${grid({
+                    itemSize: { width: '176px', height: '230px' },
+                    gap: '16px',
+                    padding: '16px',
+                })}
+            ></lit-virtualizer>
 
             <wa-popup
                 id="context-menu"
@@ -311,61 +376,6 @@ export class CoverGrid extends LitElement {
             </wa-popup>
         `;
     }
-
-    private renderAlbumCard(album: library.Album) {
-        return html`
-            <div
-                class="album-card"
-                tabindex="0"
-                role="button"
-                aria-label="${album.Name} by ${album.ArtistName}"
-                @click=${() => this.onAlbumClick(album)}
-                @keydown=${(e: KeyboardEvent) => this.onAlbumKeydown(e, album)}
-                @contextmenu=${(e: MouseEvent) => this.onAlbumContextMenu(e, album)}
-            >
-                <div class="cover-container">
-                    ${album.CoverArtPath
-                        ? html`<img
-                              class="cover-image"
-                              src="${album.CoverArtPath}"
-                              alt="${album.Name} cover"
-                              loading="lazy"
-                          />`
-                        : html`<div class="placeholder-cover">
-                              ${this.getAlbumInitial(album.Name)}
-                          </div>`}
-                </div>
-                <div class="album-info">
-                    <div class="album-name" title="${album.Name}">${album.Name}</div>
-                    <div class="artist-name" title="${album.ArtistName}">
-                        ${album.ArtistName}${album.Year ? ` - ${album.Year}` : ''}
-                    </div>
-                </div>
-            </div>
-        `;
-    }
-
-    private getAlbumInitial(name: string): string {
-        return name.charAt(0).toUpperCase();
-    }
-
-    private onAlbumClick(album: library.Album) {
-        EventsEmit('AlbumSelected', album);
-        this.dispatchEvent(
-            new CustomEvent('album-selected', {
-                detail: album,
-                bubbles: true,
-                composed: true,
-            })
-        );
-    }
-
-    private onAlbumKeydown(e: KeyboardEvent, album: library.Album) {
-        if (e.key === 'Enter' || e.key === ' ') {
-            e.preventDefault();
-            this.onAlbumClick(album);
-        }
-    }
 }
 
 declare global {

frontend/src/components/track-list/track-list.ts

@@ -6,6 +6,8 @@ import { customElement, state, query } from 'lit/decorators.js';
 import { formatMilliseconds } from '@utils/time';
 import { PlayerController } from '@store/controllers/player-controller';
 import { QueueController } from '@store/controllers/queue-controller';
+import '@lit-labs/virtualizer';
+import { flow } from '@lit-labs/virtualizer/layouts/flow.js';
 import '@awesome.me/webawesome/dist/components/popup/popup.js';
 import '@awesome.me/webawesome/dist/components/dropdown-item/dropdown-item.js';
 import '@awesome.me/webawesome/dist/components/icon/icon.js';
@@ -30,42 +32,48 @@ export class TrackList extends LitElement {
   private closeHandler = () => this.closeContextMenu();
 
   static override styles = css`
-    table {
-      width: 100%;
-      border-collapse: collapse;
+    :host {
+      display: flex;
+      flex-direction: column;
+      overflow: hidden;
     }
 
-    th {
+    .header-row {
+      display: grid;
+      grid-template-columns: 1fr 1fr 80px;
       padding: 8px;
-      text-align: left;
       font-weight: bold;
       color: #fff;
-    }
-
-    thead tr {
       border-bottom: 1px solid #666;
+      flex-shrink: 0;
     }
 
-    tbody tr {
+    lit-virtualizer {
+      flex: 1;
+      overflow-y: auto;
+    }
+
+    .track-row {
+      display: grid;
+      grid-template-columns: 1fr 1fr 80px;
+      padding: 8px;
       border-bottom: 1px solid #333;
+      align-items: center;
+      width: 100%;
     }
 
-    tbody tr:hover {
+    .track-row:hover {
       background-color: rgba(255, 255, 255, 0.05);
     }
 
-    tbody tr.active {
+    .track-row.active {
       background-color: rgba(255, 212, 59, 0.1);
     }
 
-    tbody tr.active .track-name-button {
+    .track-row.active .track-name-button {
       color: #ffd43b;
     }
 
-    td {
-      padding: 8px;
-    }
-
     .track-name-button {
       background: none;
       border: none;
@@ -74,12 +82,23 @@ export class TrackList extends LitElement {
       padding: 0;
       cursor: pointer;
       width: 100%;
+      font: inherit;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
     }
 
     .track-name-button:hover {
       text-decoration: underline;
     }
 
+    .artist-name,
+    .track-length {
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+
     #context-menu {
       z-index: 200;
     }
@@ -209,45 +228,45 @@ export class TrackList extends LitElement {
     return currentTrack.filePath === track.FilePath;
   }
 
+  private renderTrackRow = (track: library.Track): unknown => {
+    const active = this.isActiveTrack(track);
+
+    return html`
+      <div
+        class="track-row ${active ? 'active' : ''}"
+        @contextmenu=${(e: MouseEvent) => this.onTrackContextMenu(e, track)}
+      >
+        <div>
+          <button
+            class="track-name-button"
+            @click=${() => this.onTrackClick(track)}
+          >
+            ${track.TrackName}
+          </button>
+        </div>
+        <div class="artist-name">${track.ArtistName}</div>
+        <div class="track-length">${formatMilliseconds(track.TrackLength)}</div>
+      </div>
+    `;
+  };
+
   override render() {
     return html`
-      <div>
-        ${this.tracks.length === 0
-          ? html`<p>Loading tracks...</p>`
-          : html`
-              <table>
-                <thead>
-                  <tr>
-                    <th>Track Name</th>
-                    <th>Artist</th>
-                    <th>Track Length</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  ${this.tracks.map(
-                    (track) => html`
-                      <tr
-                        class=${this.isActiveTrack(track) ? 'active' : ''}
-                        @contextmenu=${(e: MouseEvent) =>
-                          this.onTrackContextMenu(e, track)}
-                      >
-                        <td>
-                          <button
-                            class="track-name-button"
-                            @click=${() => this.onTrackClick(track)}
-                          >
-                            ${track.TrackName}
-                          </button>
-                        </td>
-                        <td>${track.ArtistName}</td>
-                        <td>${formatMilliseconds(track.TrackLength)}</td>
-                      </tr>
-                    `
-                  )}
-                </tbody>
-              </table>
-            `}
-      </div>
+      ${this.tracks.length === 0
+        ? html`<p>Loading tracks...</p>`
+        : html`
+            <div class="header-row">
+              <span>Track Name</span>
+              <span>Artist</span>
+              <span>Track Length</span>
+            </div>
+            <lit-virtualizer
+              scroller
+              .items=${this.tracks}
+              .renderItem=${this.renderTrackRow}
+              .layout=${flow()}
+            ></lit-virtualizer>
+          `}
 
       <wa-popup
         id="context-menu"

frontend/src/store/queue-store.ts

@@ -7,8 +7,6 @@ export interface QueueTrack {
   audioFileId: number;
   filePath: string;
   position: number;
-  title: string;
-  artist: string;
 }
 
 export type RepeatMode = 'off' | 'all' | 'one';