From d5983433c572bf941583548c041d40293344092f Mon Sep 17 00:00:00 2001
From: Bryan Van Deusen <bryan.vandeusen@fabledsword.com>
Date: Sat, 9 May 2026 20:18:10 -0400
Subject: [PATCH] =?UTF-8?q?feat(web):=20PlayerOverflowMenu=20=E2=80=94=20s?=
 =?UTF-8?q?huffle/repeat/queue/volume=20in=20a=20menu?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../lib/components/PlayerOverflowMenu.svelte  | 97 +++++++++++++++++++
 .../lib/components/PlayerOverflowMenu.test.ts | 31 ++++++
 2 files changed, 128 insertions(+)
 create mode 100644 web/src/lib/components/PlayerOverflowMenu.svelte
 create mode 100644 web/src/lib/components/PlayerOverflowMenu.test.ts

diff --git a/web/src/lib/components/PlayerOverflowMenu.svelte b/web/src/lib/components/PlayerOverflowMenu.svelte
new file mode 100644
index 00000000..39eb9035
--- /dev/null
+++ b/web/src/lib/components/PlayerOverflowMenu.svelte
@@ -0,0 +1,97 @@
+<script lang="ts">
+  import { MoreVertical, Shuffle, Repeat, Repeat1, ListMusic, Volume2 } from 'lucide-svelte';
+  import {
+    player, toggleShuffle, cycleRepeat, toggleQueueDrawer, setVolume
+  } from '$lib/player/store.svelte';
+  import TrackMenuItem from './TrackMenuItem.svelte';
+  import TrackMenuDivider from './TrackMenuDivider.svelte';
+
+  let { direction = 'up' }: { direction?: 'up' | 'down' } = $props();
+
+  let menuOpen = $state(false);
+
+  function toggleMenu(e: MouseEvent) {
+    e.stopPropagation();
+    menuOpen = !menuOpen;
+  }
+
+  const repeatLabel = $derived(
+    player.repeat === 'off' ? 'Repeat off' :
+    player.repeat === 'all' ? 'Repeat all' : 'Repeat one'
+  );
+
+  const repeatIcon = $derived(player.repeat === 'one' ? Repeat1 : Repeat);
+
+  function onShuffle() {
+    toggleShuffle();
+  }
+  function onRepeat() {
+    cycleRepeat();
+  }
+  function onQueue() {
+    toggleQueueDrawer();
+    menuOpen = false;
+  }
+  function onVolume(e: Event) {
+    setVolume(Number((e.currentTarget as HTMLInputElement).value));
+  }
+</script>
+
+<svelte:window onclick={() => { menuOpen = false; }} onkeydown={(e) => e.key === 'Escape' && (menuOpen = false)} />
+
+<div class="relative inline-block">
+  <button
+    type="button"
+    aria-label="Player options"
+    aria-haspopup="menu"
+    aria-expanded={menuOpen}
+    onclick={toggleMenu}
+    class="rounded p-1 text-text-muted hover:text-text-primary min-h-[44px] min-w-[44px]
+           flex items-center justify-center"
+  >
+    <MoreVertical size={18} strokeWidth={1} />
+  </button>
+
+  {#if menuOpen}
+    <div
+      role="menu"
+      tabindex="-1"
+      class="absolute right-0 z-20 w-56 rounded-md border border-border bg-surface p-1 shadow-lg
+             {direction === 'up' ? 'bottom-full mb-1' : 'top-full mt-1'}"
+      onclick={(e) => e.stopPropagation()}
+      onkeydown={(e) => e.stopPropagation()}
+    >
+      <TrackMenuItem
+        icon={Shuffle}
+        label={player.shuffle ? 'Shuffle on' : 'Shuffle off'}
+        onclick={onShuffle}
+      />
+      <TrackMenuItem
+        icon={repeatIcon}
+        label={repeatLabel}
+        onclick={onRepeat}
+      />
+      <TrackMenuItem
+        icon={ListMusic}
+        label={player.queueDrawerOpen ? 'Hide queue' : 'Show queue'}
+        onclick={onQueue}
+      />
+
+      <TrackMenuDivider />
+
+      <div class="flex items-center gap-2 px-2 py-1.5">
+        <Volume2 size={14} strokeWidth={1} class="shrink-0 text-text-secondary" />
+        <input
+          type="range"
+          aria-label="Volume"
+          min="0"
+          max="1"
+          step="0.01"
+          value={player.volume}
+          oninput={onVolume}
+          class="flex-1 accent-accent"
+        />
+      </div>
+    </div>
+  {/if}
+</div>
diff --git a/web/src/lib/components/PlayerOverflowMenu.test.ts b/web/src/lib/components/PlayerOverflowMenu.test.ts
new file mode 100644
index 00000000..8d71c12f
--- /dev/null
+++ b/web/src/lib/components/PlayerOverflowMenu.test.ts
@@ -0,0 +1,31 @@
+import { describe, it, expect } from 'vitest';
+import { render, screen, fireEvent } from '@testing-library/svelte';
+import PlayerOverflowMenu from './PlayerOverflowMenu.svelte';
+
+describe('PlayerOverflowMenu', () => {
+  it('renders the trigger button closed by default', () => {
+    render(PlayerOverflowMenu);
+    const trigger = screen.getByLabelText('Player options');
+    expect(trigger.getAttribute('aria-expanded')).toBe('false');
+  });
+
+  it('opens the menu on click and shows shuffle/repeat/queue/volume', async () => {
+    render(PlayerOverflowMenu);
+    const trigger = screen.getByLabelText('Player options');
+    await fireEvent.click(trigger);
+    expect(trigger.getAttribute('aria-expanded')).toBe('true');
+    expect(screen.getByText(/shuffle/i)).toBeInTheDocument();
+    expect(screen.getByText(/repeat/i)).toBeInTheDocument();
+    expect(screen.getByText(/queue/i)).toBeInTheDocument();
+    expect(screen.getByLabelText('Volume')).toBeInTheDocument();
+  });
+
+  it('Escape key closes the menu', async () => {
+    render(PlayerOverflowMenu);
+    await fireEvent.click(screen.getByLabelText('Player options'));
+    expect(screen.getByLabelText('Player options').getAttribute('aria-expanded')).toBe('true');
+    window.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape' }));
+    await Promise.resolve();
+    expect(screen.getByLabelText('Player options').getAttribute('aria-expanded')).toBe('false');
+  });
+});