Files
silo-server/web/src/components/AppSidebar.tsx
T
eb6024573e feat(audiobooks): make audiobook libraries first-class catalog items (#73)
* docs(audiobooks): design spec for plugin absorption

Plan to absorb silo-plugin-audiobooks into silo-server as a first-party
feature. Audiobooks land in silo's existing SPA; ABS clients connect
directly. Hard constraints: reuse existing tables (media_items,
media_files, user_watch_progress, user_playback_sessions, people,
item_people, library_collections); only two new tables (abs_sessions,
podcast_feeds) and at most one column add (media_libraries.kind);
silo's main :8080 listener handles ABS Socket.io natively. Out of
scope: audiobook requests flow, smart collections, share links,
external recommender, custom metadata providers, separate audiobook
SPA.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs(audiobooks): implementation plan sub-plan 1 (discovery + schema)

First of six sub-plans for the absorption. Six tasks: a discovery
audit that resolves the spec's Risk questions, four idempotent SQL
migrations (abs_sessions, podcast_feeds, media_libraries.kind,
audiobooks.enabled feature flag), and an empty-but-compiling
internal/audiobooks package scaffolded into cmd/silo. Lands as a
strict no-op for users (feature flag defaults to false).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs(audiobooks): discovery findings for absorption sub-plan 1

Locks schema/code decisions for migrations 139-142 and downstream
sub-plans. Resolves open Risk questions from the absorption design spec.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): migration 139 add abs_sessions table

Parallel of jellycompat_sessions for Audiobookshelf-compatible clients.
Lets ABS mobile/desktop apps maintain a device-bound session that
silo's audiobooks/abs handlers will validate.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* style(audiobooks): match codebase conventions in migration 139

Lowercases type keywords in the abs_sessions CREATE TABLE body to
match neighboring migrations, fixes the client_version column
alignment, and replaces the misleading "parallel to
jellycompat_sessions" header comment with a more accurate
description of the table's role.

Cosmetic only — the running schema is unchanged.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): migration 140 add podcast_feeds table

Side table on media_items for RSS-subscribed podcasts. Holds feed URL,
ETag/Last-Modified for conditional fetches, last-refresh timestamp, and
the per-feed refresh interval consumed by the upcoming
podcastfeed.Refresher scheduled task.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* style(audiobooks): uppercase PRIMARY KEY in migration 140

Aligns with the codebase convention (type keywords lowercase,
constraint keywords uppercase) established in migration 139's
post-style-fix form. Cosmetic only — running schema is unchanged.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore(audiobooks): migration 141 no-op for media_folders.type

Sub-plan 1 originally reserved migration 141 to add a 'kind' column to
media_libraries discriminating audiobook/podcast libraries. Discovery
audit (sub-plan 1 Task 1) found that the actual table is media_folders
and it already has a type text NOT NULL column with no CHECK constraint
or enum, so 'audiobooks' and 'podcasts' can be added as future values
without DDL.

Landing this migration as a documented no-op preserves the version
numbering audit trail and pins the decision in git history. The
matching down migration is also a no-op.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): migration 142 add audiobooks.enabled flag

Server-settings row that gates the absorbed audiobooks feature.
Defaults to 'false' so sub-plan 1 lands as a strict no-op; subsequent
sub-plans branch on this flag and operators flip it to 'true' at
cutover.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): scaffold internal/audiobooks package

Empty-but-compiling Service that reads the audiobooks.enabled feature
flag from server_settings. Wired into cmd/silo so the package is
referenced from the binary; no routes mounted, no scheduled tasks
registered, no DB writes. Subsequent sub-plans hang scanner branches,
ABS handlers, Socket.io, podcast refresher, and SPA pages off this
Service.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* style(audiobooks): cosmetic cleanups in scaffolded package

Two pre-emptive cleanups flagged by code review before sub-plan 2
copies the patterns:

  1. Sort the internal/audiobooks import after internal/adminjob in
     cmd/silo/main.go (alphabetical).
  2. Drop the redundant "audiobooks: " prefix from the Enabled() error
     wrap; matches how every other top-level service package
     (watchstate, scanqueue, metadata, etc.) formats errors.

No behavior change.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs(audiobooks): implementation plan sub-plan 2 (scanner)

Second of six sub-plans. 10 tasks: PersonKind constants for Author and
Narrator, audio-extension recognizer, library-type helpers, a
walkLogicalTree refactor (movieLibrary bool -> typed walkMode), chapter
extraction via ffprobe, single-file and multi-file audiobook parsers,
scanner write path producing media_items.type='audiobook', and a
filesystem podcast parser (RSS deferred to sub-plan 5).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): add Author and Narrator PersonKind constants

Discovery audit confirmed item_people.kind is unconstrained smallint
with values 1-6 in use. Reserve 7 = Author, 8 = Narrator for audiobook
people-links written by the upcoming scanner branches.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): add audio-extension recognizer for scanner

Mirrors the existing videoExtensions/SupportsVideoFile pair. Used by
upcoming audiobook and podcast scanner branches to filter directory
walks.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): library-type recognizers for scanner dispatch

isAudiobookLibraryType and isPodcastLibraryType match singular and
plural forms case-insensitively, mirroring isMovieLibraryType. Used by
upcoming scanner walk branches (Task 4) that filter audio files into
audiobook and podcast libraries.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* refactor(scanner): replace movieLibrary bool with typed walkMode

Lets walkLogicalTree dispatch on multiple library shapes (video, movie,
audiobook, podcast) without proliferating boolean flags. Behavior for
existing video and movie libraries is unchanged; audiobook and podcast
modes will be consumed by the upcoming audiobook.go and podcast.go
parsers in later tasks of this sub-plan.

walkModeFor() derives the mode from a media_folders.type string;
unknown types default to walkModeVideo to preserve prior behavior for
any caller still passing a raw type.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): expose ffprobe format tags on ProbeData

The audiobook scanner needs format-level tags (title, artist, album,
date) for media_items metadata; ffprobe already parses them in
ffprobeFormat.Tags but ProbeData previously discarded them. Add
FormatTags map[string]string to ProbeData, populate it in
convertProbeData via a new normalizeFormatTags helper that lowercases
keys and trims values.

Adds a fixture audiobook .m4b with embedded chapters (Intro/Outro) and
format tags, and a test that verifies ProbeFile() returns both
correctly.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): parser for single-file audiobook folders

parseAudiobookFolder reads tags + chapters via the existing ProbeFile
(now that Task 5 exposes FormatTags on ProbeData) and produces a
parsedAudiobook struct. Title falls back from "title" tag to "album";
author from "artist" -> "album_artist" -> "composer"; series from
"album" -> "series" -> "mvnm" (Movement Name, used by some MP4 tools).
Year parsed from "date" or "year" tags, tolerating ISO dates and
parenthesized forms.

Single-file case only; multi-file folders (one audio file per chapter)
return a placeholder error and arrive in Task 7.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): multi-file audiobook folder support

Folders containing N audio files (one per chapter/part) get one
parsedAudiobookFile per file; each file's chapter list is synthesized
as a single chapter with title = filename stem. Title/author/series/
year come from the first file's tags.

Also drops the duplicate pickFirstNonEmpty helper added in Task 6 in
favor of the existing firstNonEmpty already in probe.go.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): scanner write path produces audiobook media_items

ScanAudiobookFolder walks an audiobooks-typed media folder and treats
each immediate subdirectory as one audiobook. For each parsed audiobook
it upserts:
  - one media_items row with type='audiobook'
  - one media_files row per audio file (with chapters JSONB)
  - author/narrator links in item_people (kind=7, kind=8)

Adds itemRepo and personRepo to the Scanner struct, wired from
fileRepo.Pool() in NewScanner — no constructor signature change needed.

ScanFolder dispatches to this path when folder.Type='audiobooks',
bypassing the per-file movie/TV pipeline because audiobooks are
folder-scoped entities.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): filesystem podcast scanner

ScanPodcastFolder walks a podcasts-typed media folder, treating each
subdirectory as a podcast show and each audio file inside as an
episode. Writes media_items.type='podcast' + episodes rows + media_files
rows. RSS-subscribed feeds (podcast_feeds table) arrive in sub-plan 5;
this task covers filesystem-only ingestion.

ScanFolder dispatches to this path when folder.Type='podcasts'.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs(audiobooks): implementation plan sub-plan 5 (podcasts)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): expose audiobooks/podcasts library types in admin UI

Adds 'Audiobooks' and 'Podcasts' options to the library-type dropdown
in the admin libraries page so operators can flag a folder as an
audiobook or podcast library. Extends contentLevelsForType() so the
admin UI's downstream filtering treats those types correctly
(audiobook -> ['audiobook'], podcasts -> ['podcast',
'podcast_episode']).

Backend scanner branches for these types were already wired in
sub-plan 2.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore(migrations): renumber 139_abs_sessions to 147 for origin/main merge

origin/main adds 139_media_requests at the same number our local
audiobook branch had used for abs_sessions. Renumber ours to 147 to
free up 139 for the upstream migration. The schema_versions row is
updated in lockstep on the running database so the migrator sees the
abs_sessions migration as already applied at its new version.

Migrations 140-146 (podcast feeds, media_folders kind noop, audiobook
feature flag, abs playback sessions, podcast episode guid, audiobook
series, audiobook title cleanup) stay where they are — they don't
collide with anything on origin/main.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore(migrations): renumber 140_podcast_feeds to 157 for origin/main merge

origin/main added 140_user_permissions at the same version this branch
had used for podcast_feeds. Renumber ours to 157 (next free above the
collections-unify migration at 156) so 140 is free for the upstream
migration. schema_versions on the running database is updated in lockstep
so the migrator sees podcast_feeds as already applied at its new version.

Same pattern as d59c1cb (renumber 139_abs_sessions to 147 for the prior
main merge). Pending migrations after this rename: 132 (downloaded
subtitles admin index, main), 140 (user_permissions, main), and 156
(unify_user_collections, this branch).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore(migrations): renumber 141_media_folders_kind_noop to 159 for origin/main merge

Same shape as eb8f67d (the 140→157 renumber from the previous main
merge). origin/main added 141_episode_title_sort_index at the same
version this branch had used for media_folders_kind_noop. Renumber
ours to 159 (next free above the audiobook_series truncate at 158) so
141 is open for the upstream migration. schema_versions on the
running database is updated in lockstep so the migrator sees
media_folders_kind_noop as already applied at its new version.

Pending migrations on silo-prod after this rename: 141
(episode_title_sort_index, main) and any other newer ones from main
that the branch hasn't picked up yet.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore(migrations): renumber 142_audiobooks_feature_flag to 160 for origin/main merge

Companion to 3c6f062's 141 renumber — origin/main also added
142_episode_catalog_entries (alongside 141_episode_title_sort_index)
at a version this branch had used for the audiobooks feature flag.
Renumber ours to 160 so 142 is open for the upstream migration;
schema_versions on silo-prod is updated in lockstep so the migrator
sees audiobooks_feature_flag as already applied at its new version.

This was the only remaining collision (verified by checking for
duplicate version prefixes across migrations/).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix(audiobooks): address foundation review comments

* fix(audiobooks): tighten scanner identity handling

* fix(audiobooks): propagate scanner cancellation

* chore(audiobooks): adopt goose migration layout

* docs(audiobooks): implementation plan sub-plan 3 (API + frontend MVP)

Third of six sub-plans. 9 tasks: three REST endpoints (list/detail/
progress), TanStack Query hooks + types, three React pages
(Library/Detail/Player), and navigation integration. Scoped to MVP —
author/series indices, smart collections, share links, and other
nice-to-haves from the spec are deferred. Streaming reuses silo's
existing /api/v1/stream/{session_id}; no new transcode code.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): list endpoint at GET /api/v1/audiobooks

Paginated list of media_items with type='audiobook' scoped to the
caller's accessible libraries via the existing access filter.
Mirrors silo's existing list-style handlers for movies and series.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): detail endpoint at GET /api/v1/audiobooks/{id}

Returns the media_items row, its media_files (with chapters JSONB),
author/narrator extracted from item_people (kinds 7/8), and the
caller's per-profile listening progress from user_watch_progress.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): progress endpoint at POST /api/v1/audiobooks/{id}/progress

UPSERTs user_watch_progress for the caller's (user_id, profile_id,
content_id). Body carries position_seconds; clients are expected to
post every 5-10s during playback plus on pause/seek (matching silo's
existing video progress cadence).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): frontend types and TanStack Query hooks

TypeScript types match the JSON shapes from the new
/api/v1/audiobooks endpoints (list, detail, progress). Three hooks:
useAudiobookLibrary (list), useAudiobook (detail), and
useReportAudiobookProgress (mutation that invalidates the detail
query on success so progress updates reflect immediately).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): library grid page at /audiobooks

Renders a paginated grid of audiobook cards using the
useAudiobookLibrary hook. Each card links to /audiobooks/book/{id}.
Cards show poster, title, and year; falls back to a "No cover"
placeholder when the audiobook has no poster_url. Empty state hints
to operators that they need to set a library's type to 'audiobooks'.

Routes themselves are wired in Task 8 (navigation integration).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): detail page with chapter list

Renders cover, title, author, narrator, year, and overview alongside a
chapter list. Clicking a chapter opens an inline sticky
AudiobookPlayer at that chapter's start. A "Resume" button restarts
playback at the saved progress position if present.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): HTML5 audio player with chapter navigation

Single-file audiobook playback for MVP. Multi-file queuing arrives in
a follow-up. Streams via the existing /api/v1/direct-download GET
endpoint. Position is reported to /api/v1/audiobooks/{id}/progress
every 10s while playing plus on pause/seek/end. Skip-30s, playback
rate select, chapter list panel.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(audiobooks): wire navigation and routes

Adds an Audiobooks entry to the sidebar and registers the two new
routes (/audiobooks for the library grid, /audiobooks/book/:id for
detail). The player renders inline inside the detail page; no
dedicated player route is required for MVP.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix(audiobooks): address native API review comments

* feat(audiobooks): add ABS compatibility and polish

* fix(audiobooks): stabilize ABS playback progress reporting

* fix(audiobooks): clean up ABS branch review fixes

* chore(audiobooks): adopt goose layout for ABS migrations

* fix(audiobooks): align player seek bar props

* feat(audiobooks): make libraries first-class catalog items

* feat(admin): add server restart endpoint

* fix(audiobooks): address review comment findings

---------

Co-authored-by: RXWatcher <14085001+RXWatcher@users.noreply.github.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-06-07 15:57:05 -04:00

840 lines
33 KiB
TypeScript

import { useState, useCallback, useEffect, useMemo, useRef } from "react";
import type { ReactNode } from "react";
import { Link, useLocation, useParams } from "react-router";
import ViewTransitionLink from "@/components/ViewTransitionLink";
import { getProfileMenuSide, isSidebarExpanded } from "@/components/AppSidebar.logic";
import { SiloBrand } from "@/components/SiloBrand";
import { useAuth } from "@/hooks/useAuth";
import { useCurrentProfile } from "@/hooks/useCurrentProfile";
import { navigateToPluginRoute } from "@/lib/buildPluginHref";
import { useUserLibraries } from "@/hooks/queries/libraries";
import { usePluginSettingsList } from "@/hooks/queries/pluginSettings";
import { useRequestFeatureStatus } from "@/hooks/queries/useRequests";
import { useSidebarPins, useToggleSidebarPin } from "@/hooks/queries/sidebarPins";
import { useViewTransitionNavigate } from "@/hooks/useViewTransition";
import { pluginRouteHref } from "@/lib/pluginRouteHref";
import {
buildLibraryCollectionCatalogHref,
buildPersonalCatalogHref,
buildQueryCatalogHref,
buildSectionCatalogHref,
parseCatalogSearchParams,
} from "@/pages/catalogSearchParams";
import { Avatar, AvatarFallback, AvatarImage } from "@/components/ui/avatar";
import {
DropdownMenu,
DropdownMenuContent,
DropdownMenuItem,
DropdownMenuLabel,
DropdownMenuSeparator,
DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu";
import {
Film,
Tv,
Library,
Search,
Heart,
List,
Clock,
FolderOpen,
LogOut,
UserCircle,
Shield,
Settings,
Sparkles,
CalendarDays,
Home,
UsersRound,
ChevronDown,
ChevronRight,
PinOff,
LayoutGrid,
Puzzle,
BookHeadphones,
Send,
} from "lucide-react";
import { useTheme } from "@/hooks/useTheme";
import { CURATED_THEME_IDS, THEMES } from "@/lib/themes";
import { cn } from "@/lib/utils";
function getLibraryIcon(type: string) {
switch (type) {
case "movies":
return <Film className="h-[18px] w-[18px]" />;
case "series":
return <Tv className="h-[18px] w-[18px]" />;
case "audiobook":
case "audiobooks":
return <BookHeadphones className="h-[18px] w-[18px]" />;
default:
return <Library className="h-[18px] w-[18px]" />;
}
}
function getLibraryIdFromPathname(pathname: string): number | null {
const match = pathname.match(/^\/library\/(\d+)(?:\/|$)/);
if (!match) return null;
const id = Number(match[1]);
return Number.isInteger(id) && id > 0 ? id : null;
}
function SidebarLabel({ children, show }: { children: ReactNode; show: boolean }) {
return (
<span
className={`truncate transition-[opacity,max-width] duration-200 ease-out ${
show ? "max-w-[180px] opacity-100 delay-[50ms]" : "max-w-0 overflow-hidden opacity-0"
}`}
>
{children}
</span>
);
}
function SidebarSectionHeader({
children,
show,
collapsible = false,
expanded = false,
onToggle,
}: {
children: ReactNode;
show: boolean;
collapsible?: boolean;
expanded?: boolean;
onToggle?: () => void;
}) {
const textClass = "text-muted-foreground text-[10px] font-semibold tracking-[0.22em] uppercase";
const collapsedDivider = (
<div
className={`absolute inset-0 flex items-center justify-center transition-opacity duration-150 ${
show ? "pointer-events-none opacity-0" : "opacity-100"
}`}
aria-hidden="true"
>
<div className="bg-sidebar-section-divider h-px w-5 rounded-full" />
</div>
);
if (collapsible) {
return (
<div className="relative mb-2">
{collapsedDivider}
<button
type="button"
onClick={onToggle}
disabled={!show}
aria-hidden={!show}
aria-expanded={expanded}
aria-label={expanded ? `Collapse ${String(children)}` : `Expand ${String(children)}`}
tabIndex={show ? 0 : -1}
className={`${textClass} hover:text-sidebar-foreground flex h-5 w-full items-center gap-1 px-3 transition-opacity duration-150 ${
show ? "opacity-100" : "pointer-events-none opacity-0"
}`}
>
{expanded ? <ChevronDown className="h-3 w-3" /> : <ChevronRight className="h-3 w-3" />}
<span>{children}</span>
</button>
</div>
);
}
return (
<div className="relative mb-2 px-3">
{collapsedDivider}
<div
aria-hidden={!show}
className={`${textClass} flex h-5 items-center transition-opacity duration-150 ${
show ? "opacity-100" : "opacity-0"
}`}
>
{children}
</div>
</div>
);
}
interface AppSidebarProps {
onNavigate?: () => void;
collapsed?: boolean;
}
export default function AppSidebar({ onNavigate, collapsed = false }: AppSidebarProps) {
const location = useLocation();
const navigate = useViewTransitionNavigate();
const params = useParams<{ libraryId: string }>();
const { user, logout, clearProfile } = useAuth();
const { profile } = useCurrentProfile();
const { theme, setTheme, previewTheme, resetPreviewTheme } = useTheme();
const isAdmin = user?.role === "admin";
const { data: libraries } = useUserLibraries();
const { pins } = useSidebarPins();
const { togglePin } = useToggleSidebarPin();
const { data: pluginSettings } = usePluginSettingsList();
const requestStatus = useRequestFeatureStatus();
const showRequestsNav = requestStatus.data?.requests_enabled === true;
const pluginNavLinks = useMemo(() => {
const installations = pluginSettings?.installations ?? [];
const links: { id: string; basePath: string; label: string; pluginId: string }[] = [];
for (const inst of installations) {
for (const route of inst.routes) {
if (!route.navigable || route.navigation_kind !== "user") continue;
links.push({
id: `${inst.id}:${route.id || route.path}`,
basePath: pluginRouteHref(inst.id, route.path),
label: route.navigation_label || inst.plugin_id,
pluginId: inst.plugin_id,
});
}
}
return links;
}, [pluginSettings]);
const catalogState = useMemo(
() =>
location.pathname === "/catalog"
? parseCatalogSearchParams(new URLSearchParams(location.search))
: null,
[location.pathname, location.search],
);
const activeLibraryId =
params.libraryId && Number.isInteger(Number(params.libraryId))
? Number(params.libraryId)
: (getLibraryIdFromPathname(location.pathname) ??
(catalogState?.source === "section" && catalogState.scope === "library"
? (catalogState.library_id ?? null)
: catalogState?.source === "library_collection"
? (catalogState.library_id ?? null)
: null));
// Hover-to-expand when collapsed (150ms enter delay prevents accidental expansion)
const [hovered, setHovered] = useState(false);
const [profileMenuOpen, setProfileMenuOpen] = useState(false);
const hoverTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
const handleMouseEnter = useCallback(() => {
if (!collapsed) return;
hoverTimerRef.current = setTimeout(() => setHovered(true), 150);
}, [collapsed]);
const handleMouseLeave = useCallback(() => {
if (hoverTimerRef.current) clearTimeout(hoverTimerRef.current);
hoverTimerRef.current = null;
if (profileMenuOpen) return;
setHovered(false);
}, [profileMenuOpen]);
useEffect(() => {
return () => {
if (hoverTimerRef.current) clearTimeout(hoverTimerRef.current);
};
}, []);
const sidebarExpanded = isSidebarExpanded(collapsed, hovered, profileMenuOpen);
const showLabels = sidebarExpanded;
const [librariesExpanded, setLibrariesExpanded] = useState(true);
const [expandedLibraries, setExpandedLibraries] = useState<Set<number>>(
() =>
new Set(
Object.keys(pins)
.map(Number)
.filter((id) => Number.isInteger(id) && id > 0),
),
);
const toggleLibraryExpand = useCallback((libId: number) => {
setExpandedLibraries((prev) => {
const next = new Set(prev);
if (next.has(libId)) {
next.delete(libId);
} else {
next.add(libId);
}
return next;
});
}, []);
function isActive(href: string, exact?: boolean) {
if (exact) return location.pathname === href;
return location.pathname === href || location.pathname.startsWith(`${href}/`);
}
function isCatalogSourceActive(source: "query" | "favorites" | "watchlist" | "history") {
return location.pathname === "/catalog" && catalogState?.source === source;
}
function isPinnedCatalogActive(
libId: number,
pin: { type: "collection" | "section"; id: string },
) {
if (location.pathname !== "/catalog" || !catalogState) {
return false;
}
if (pin.type === "collection") {
return catalogState.source === "library_collection" && catalogState.collection_id === pin.id;
}
return (
catalogState.source === "section" &&
catalogState.scope === "library" &&
catalogState.library_id === libId &&
catalogState.section_id === pin.id
);
}
const navLinkClass = (href: string, exact?: boolean) =>
navLinkClassForState(isActive(href, exact));
const navLinkClassForState = (active: boolean) =>
`relative flex items-center gap-2.5 rounded-xl px-3 py-3 text-[13px] font-medium transition-all duration-200 ${
active
? "text-sidebar-accent-foreground bg-sidebar-accent/90 shadow-[0_16px_30px_-24px_rgba(0,0,0,0.7)]"
: "text-muted-foreground hover:text-sidebar-foreground hover:bg-sidebar-accent/70"
}`;
return (
<aside
className={`border-sidebar-border/70 bg-sidebar/88 sidebar-transition fixed top-0 bottom-0 left-0 z-40 flex flex-col border-r backdrop-blur-2xl ${collapsed && !sidebarExpanded ? "w-16" : "w-[260px]"}`}
onMouseEnter={handleMouseEnter}
onMouseLeave={handleMouseLeave}
style={
collapsed && sidebarExpanded
? { zIndex: 45, boxShadow: "0 25px 50px -12px rgb(0 0 0 / 0.5)" }
: undefined
}
>
{/* Logo */}
<div
className={`sidebar-logo flex items-center py-6 ${showLabels ? "px-5" : "justify-center px-2"}`}
>
<SiloBrand
variant={showLabels ? "wordmark" : "mark"}
className={showLabels ? "h-12 w-[112px]" : "h-9 w-9"}
/>
</div>
{/* Main nav */}
<nav
aria-label="Main navigation"
className="sidebar-nav sidebar-scroll flex-1 space-y-7 overflow-y-auto px-3 pb-5"
>
{/* Home */}
<ul className="list-none space-y-0.5">
<li>
<ViewTransitionLink
to="/"
onClick={onNavigate}
className={navLinkClass("/", true)}
aria-current={isActive("/", true) ? "page" : undefined}
>
{isActive("/", true) && (
<span
className="absolute top-1/2 left-0 h-[18px] w-[3px] -translate-y-1/2 rounded-r-sm"
style={{ background: "var(--primary)" }}
/>
)}
<Home className="h-[18px] w-[18px] shrink-0" />
<SidebarLabel show={showLabels}>Home</SidebarLabel>
</ViewTransitionLink>
</li>
</ul>
{/* Libraries */}
{libraries && libraries.length > 0 && (
<div className="sidebar-libraries">
<SidebarSectionHeader
show={showLabels}
collapsible
expanded={librariesExpanded}
onToggle={() => setLibrariesExpanded((v) => !v)}
>
Libraries
</SidebarSectionHeader>
{(showLabels ? librariesExpanded : true) && (
<ul className="list-none space-y-0.5">
{libraries.map((lib) => {
const baseHref = `/library/${lib.id}`;
const active = activeLibraryId === lib.id;
const href =
active && location.pathname === baseHref
? `${baseHref}${location.search}`
: baseHref;
const libraryPins = pins[String(lib.id)] ?? [];
const hasPins = libraryPins.length > 0;
const isExpanded = hasPins && !expandedLibraries.has(lib.id);
return (
<li key={lib.id}>
{/* Library row: chevron (if pins) + icon + name link */}
<div
className={`relative flex items-center rounded-lg text-[13px] font-medium transition-colors duration-150 ${
active
? "text-sidebar-accent-foreground bg-sidebar-accent"
: "text-muted-foreground hover:text-sidebar-foreground hover:bg-sidebar-accent"
}`}
>
{active && (
<span
className="absolute top-1/2 left-0 h-[18px] w-[3px] -translate-y-1/2 rounded-r-sm"
style={{ background: "var(--primary)" }}
/>
)}
{showLabels && hasPins ? (
<button
type="button"
onClick={() => toggleLibraryExpand(lib.id)}
className="flex h-full items-center py-3 pr-1 pl-3"
aria-label={isExpanded ? `Collapse ${lib.name}` : `Expand ${lib.name}`}
aria-expanded={isExpanded}
>
{isExpanded ? (
<ChevronDown className="h-3.5 w-3.5 opacity-60" />
) : (
<ChevronRight className="h-3.5 w-3.5 opacity-60" />
)}
</button>
) : showLabels ? (
<span className="w-3 shrink-0 pl-3" />
) : null}
<ViewTransitionLink
to={href}
onClick={onNavigate}
className={`flex items-center gap-2.5 py-2.5 ${
showLabels ? "flex-1 pr-3" : "w-full px-3"
}`}
aria-current={active ? "page" : undefined}
>
<span className="flex w-[18px] flex-shrink-0 items-center justify-center">
{getLibraryIcon(lib.type)}
</span>
<SidebarLabel show={showLabels}>{lib.name}</SidebarLabel>
</ViewTransitionLink>
</div>
{/* Pinned items under this library — hidden when collapsed */}
{showLabels && hasPins && isExpanded && (
<div className="border-sidebar-border ml-3 space-y-0.5 border-l pl-2">
{libraryPins.map((pin) => {
const pinHref =
pin.type === "collection"
? buildLibraryCollectionCatalogHref(pin.id, pin.label)
: buildSectionCatalogHref({
scope: "library",
libraryId: lib.id,
sectionId: pin.id,
title: pin.label,
});
const pinActive = isPinnedCatalogActive(lib.id, pin);
return (
<div
key={`${pin.type}-${pin.id}`}
className="group/pin relative flex items-center"
>
<ViewTransitionLink
to={pinHref}
onClick={onNavigate}
className={`flex flex-1 items-center gap-2 rounded-xl px-2.5 py-2.5 text-[12.5px] font-medium transition-colors duration-150 ${
pinActive
? "text-sidebar-accent-foreground bg-sidebar-accent/90"
: "text-muted-foreground hover:text-sidebar-foreground hover:bg-sidebar-accent/70"
}`}
>
{pin.type === "collection" ? (
<FolderOpen className="h-3.5 w-3.5 opacity-60" />
) : (
<LayoutGrid className="h-3.5 w-3.5 opacity-60" />
)}
<span className="truncate">{pin.label}</span>
</ViewTransitionLink>
<button
type="button"
onClick={() =>
togglePin(lib.id, {
type: pin.type,
id: pin.id,
label: pin.label,
})
}
className="text-muted-foreground hover:text-destructive absolute right-1 rounded p-1 opacity-0 transition-opacity group-hover/pin:opacity-100"
title="Unpin"
>
<PinOff className="h-3 w-3" />
</button>
</div>
);
})}
</div>
)}
</li>
);
})}
</ul>
)}
</div>
)}
{/* Discover */}
<div>
<SidebarSectionHeader show={showLabels}>Discover</SidebarSectionHeader>
<ul className="list-none space-y-0.5">
<li>
<ViewTransitionLink
to={buildQueryCatalogHref()}
onClick={onNavigate}
className={navLinkClassForState(isCatalogSourceActive("query"))}
aria-current={isCatalogSourceActive("query") ? "page" : undefined}
>
{isCatalogSourceActive("query") && (
<span
className="absolute top-1/2 left-0 h-[18px] w-[3px] -translate-y-1/2 rounded-r-sm"
style={{ background: "var(--primary)" }}
/>
)}
<Search className="h-[18px] w-[18px] shrink-0" />
<SidebarLabel show={showLabels}>Search</SidebarLabel>
{showLabels && (
<kbd className="bg-muted text-muted-foreground pointer-events-none ml-auto hidden rounded border px-1.5 py-0.5 text-[10px] font-medium select-none lg:inline-flex">
{"\u2318"}K
</kbd>
)}
</ViewTransitionLink>
</li>
<li>
<ViewTransitionLink
to="/recommendations"
onClick={onNavigate}
className={navLinkClass("/recommendations")}
aria-current={isActive("/recommendations") ? "page" : undefined}
>
{isActive("/recommendations") && (
<span
className="absolute top-1/2 left-0 h-[18px] w-[3px] -translate-y-1/2 rounded-r-sm"
style={{ background: "var(--primary)" }}
/>
)}
<Sparkles className="h-[18px] w-[18px] shrink-0" />
<SidebarLabel show={showLabels}>Recommendations</SidebarLabel>
</ViewTransitionLink>
</li>
{showRequestsNav && (
<li>
<ViewTransitionLink
to="/requests"
onClick={onNavigate}
className={navLinkClass("/requests")}
aria-current={isActive("/requests") ? "page" : undefined}
>
{isActive("/requests") && (
<span
className="absolute top-1/2 left-0 h-[18px] w-[3px] -translate-y-1/2 rounded-r-sm"
style={{ background: "var(--primary)" }}
/>
)}
<Send className="h-[18px] w-[18px] shrink-0" />
<SidebarLabel show={showLabels}>Requests</SidebarLabel>
</ViewTransitionLink>
</li>
)}
<li>
<ViewTransitionLink
to="/calendar"
onClick={onNavigate}
className={navLinkClass("/calendar")}
aria-current={isActive("/calendar") ? "page" : undefined}
>
{isActive("/calendar") && (
<span
className="absolute top-1/2 left-0 h-[18px] w-[3px] -translate-y-1/2 rounded-r-sm"
style={{ background: "var(--primary)" }}
/>
)}
<CalendarDays className="h-[18px] w-[18px] shrink-0" />
<SidebarLabel show={showLabels}>Calendar</SidebarLabel>
</ViewTransitionLink>
</li>
</ul>
</div>
{/* Your Stuff */}
<div className="sidebar-personal">
<SidebarSectionHeader show={showLabels}>Your Stuff</SidebarSectionHeader>
<ul className="list-none space-y-0.5">
<li>
<ViewTransitionLink
to={buildPersonalCatalogHref("favorites")}
onClick={onNavigate}
className={navLinkClassForState(isCatalogSourceActive("favorites"))}
aria-current={isCatalogSourceActive("favorites") ? "page" : undefined}
>
{isCatalogSourceActive("favorites") && (
<span
className="absolute top-1/2 left-0 h-[18px] w-[3px] -translate-y-1/2 rounded-r-sm"
style={{ background: "var(--primary)" }}
/>
)}
<Heart className="h-[18px] w-[18px] shrink-0" />
<SidebarLabel show={showLabels}>Favorites</SidebarLabel>
</ViewTransitionLink>
</li>
<li>
<ViewTransitionLink
to={buildPersonalCatalogHref("watchlist")}
onClick={onNavigate}
className={navLinkClassForState(isCatalogSourceActive("watchlist"))}
aria-current={isCatalogSourceActive("watchlist") ? "page" : undefined}
>
{isCatalogSourceActive("watchlist") && (
<span
className="absolute top-1/2 left-0 h-[18px] w-[3px] -translate-y-1/2 rounded-r-sm"
style={{ background: "var(--primary)" }}
/>
)}
<List className="h-[18px] w-[18px] shrink-0" />
<SidebarLabel show={showLabels}>Watchlist</SidebarLabel>
</ViewTransitionLink>
</li>
<li>
<ViewTransitionLink
to="/rooms/join"
onClick={onNavigate}
className={navLinkClass("/rooms/join")}
aria-current={isActive("/rooms/join") ? "page" : undefined}
>
{isActive("/rooms/join") && (
<span
className="absolute top-1/2 left-0 h-[18px] w-[3px] -translate-y-1/2 rounded-r-sm"
style={{ background: "var(--primary)" }}
/>
)}
<UsersRound className="h-[18px] w-[18px] shrink-0" />
<SidebarLabel show={showLabels}>Watch Party</SidebarLabel>
</ViewTransitionLink>
</li>
<li>
<ViewTransitionLink
to="/collections"
onClick={onNavigate}
className={navLinkClass("/collections")}
aria-current={isActive("/collections") ? "page" : undefined}
>
{isActive("/collections") && (
<span
className="absolute top-1/2 left-0 h-[18px] w-[3px] -translate-y-1/2 rounded-r-sm"
style={{ background: "var(--primary)" }}
/>
)}
<FolderOpen className="h-[18px] w-[18px] shrink-0" />
<SidebarLabel show={showLabels}>Collections</SidebarLabel>
</ViewTransitionLink>
</li>
<li>
<ViewTransitionLink
to={buildPersonalCatalogHref("history")}
onClick={onNavigate}
className={navLinkClassForState(isCatalogSourceActive("history"))}
aria-current={isCatalogSourceActive("history") ? "page" : undefined}
>
{isCatalogSourceActive("history") && (
<span
className="absolute top-1/2 left-0 h-[18px] w-[3px] -translate-y-1/2 rounded-r-sm"
style={{ background: "var(--primary)" }}
/>
)}
<Clock className="h-[18px] w-[18px] shrink-0" />
<SidebarLabel show={showLabels}>History</SidebarLabel>
</ViewTransitionLink>
</li>
</ul>
</div>
{/* Apps (plugin-supplied user navigation) */}
{pluginNavLinks.length > 0 && (
<div className="sidebar-apps">
<SidebarSectionHeader show={showLabels}>Apps</SidebarSectionHeader>
<ul className="list-none space-y-0.5">
{pluginNavLinks.map((link) => (
<li key={link.id}>
<a
href={link.basePath}
onClick={(e) => {
e.preventDefault();
void navigateToPluginRoute(link.basePath);
onNavigate?.();
}}
className={navLinkClassForState(false)}
title={link.pluginId}
>
<Puzzle className="h-[18px] w-[18px] shrink-0" />
<SidebarLabel show={showLabels}>{link.label}</SidebarLabel>
</a>
</li>
))}
</ul>
</div>
)}
</nav>
{/* Footer */}
<div className="sidebar-footer border-sidebar-border/70 space-y-2 border-t px-3 py-3">
{isAdmin && (
<Link
to="/admin"
onClick={onNavigate}
className={navLinkClass("/admin")}
aria-current={isActive("/admin") ? "page" : undefined}
>
<Shield className="h-[18px] w-[18px] shrink-0" />
<SidebarLabel show={showLabels}>Admin</SidebarLabel>
</Link>
)}
{/* User profile dropdown */}
<DropdownMenu
onOpenChange={(open) => {
if (hoverTimerRef.current) clearTimeout(hoverTimerRef.current);
hoverTimerRef.current = null;
setProfileMenuOpen(open);
if (!open && !collapsed) return;
setHovered(open);
}}
>
<DropdownMenuTrigger asChild>
<button
type="button"
aria-label={`${profile?.name ?? user?.username ?? "User"} menu`}
className={`hover:bg-sidebar-accent/70 flex items-center rounded-xl py-3 transition-colors duration-150 ${
showLabels ? "w-full gap-2.5 px-3" : "mx-auto h-10 w-10 justify-center px-0"
}`}
>
<Avatar className="h-7 w-7 shrink-0">
{profile?.avatar_url ? (
<AvatarImage src={profile.avatar_url} alt={profile.name} />
) : null}
<AvatarFallback className="bg-primary text-primary-foreground text-xs font-bold shadow-[0_14px_32px_-20px_rgba(0,0,0,0.8)]">
{profile?.name?.charAt(0).toUpperCase() ??
user?.username?.charAt(0).toUpperCase() ??
"?"}
</AvatarFallback>
</Avatar>
<span
className={`text-sidebar-foreground truncate text-[13px] font-medium transition-[opacity,max-width] duration-200 ease-out ${
showLabels
? "max-w-[180px] opacity-100 delay-[50ms]"
: "max-w-0 overflow-hidden opacity-0"
}`}
>
{profile?.name ?? user?.username ?? "User"}
</span>
</button>
</DropdownMenuTrigger>
<DropdownMenuContent
side={getProfileMenuSide(collapsed)}
align="start"
className="w-[min(20rem,calc(100vw-1.5rem))] rounded-2xl p-2"
>
<DropdownMenuLabel className="flex items-center gap-3 px-2 py-2">
<Avatar className="h-10 w-10">
{profile?.avatar_url ? (
<AvatarImage src={profile.avatar_url} alt={profile.name} />
) : null}
<AvatarFallback className="bg-primary text-primary-foreground text-sm font-bold">
{(profile?.name ?? user?.username ?? "?").charAt(0).toUpperCase()}
</AvatarFallback>
</Avatar>
<div className="flex min-w-0 flex-col">
<span className="truncate text-[14px] font-semibold">
{profile?.name ?? user?.username ?? "User"}
</span>
{profile && user?.username && user.username !== profile.name && (
<span className="text-muted-foreground truncate text-[11px] font-normal">
{user.username}
</span>
)}
</div>
</DropdownMenuLabel>
<div
className="flex items-center justify-between gap-2 px-2.5 pt-1 pb-1.5"
role="group"
aria-label="Theme"
>
<span className="text-muted-foreground text-[10px] font-medium tracking-[0.14em] uppercase">
Theme
</span>
<div className="flex items-center gap-1.5">
{CURATED_THEME_IDS.map((id) => {
const def = THEMES[id];
const isActive = theme === id;
return (
<DropdownMenuItem
key={id}
onSelect={(event) => {
event.preventDefault();
setTheme(id);
}}
onMouseEnter={() => previewTheme(id)}
onMouseLeave={resetPreviewTheme}
onFocus={() => previewTheme(id)}
onBlur={resetPreviewTheme}
aria-label={def.label}
title={def.label}
className={cn(
"relative h-6 w-6 flex-none cursor-pointer rounded-full border p-0 transition-transform hover:scale-110 focus:scale-110",
isActive
? "ring-primary ring-offset-popover border-transparent ring-2 ring-offset-2"
: "border-border/60",
)}
style={{ backgroundColor: def.previewBg }}
>
<span
aria-hidden="true"
className="absolute top-1/2 left-1/2 h-2 w-2 -translate-x-1/2 -translate-y-1/2 rounded-full"
style={{ backgroundColor: def.previewAccent }}
/>
</DropdownMenuItem>
);
})}
</div>
</div>
<DropdownMenuSeparator />
<DropdownMenuItem
onClick={() => {
navigate("/settings/playback");
}}
className="gap-2.5 rounded-lg px-2.5 py-2 text-[13px]"
>
<Settings className="h-[18px] w-[18px]" />
Settings
</DropdownMenuItem>
<DropdownMenuSeparator />
<div className="flex flex-col gap-1 pt-0.5">
{profile && (
<DropdownMenuItem
onClick={() => {
clearProfile();
navigate("/profiles");
}}
className="border-sidebar-border/60 bg-sidebar-accent/40 hover:bg-sidebar-accent focus:bg-sidebar-accent gap-3 rounded-xl border px-3 py-3 text-[13px] font-semibold"
>
<UserCircle className="h-[18px] w-[18px]" />
Switch Profile
</DropdownMenuItem>
)}
<DropdownMenuItem
onClick={logout}
className="border-sidebar-border/60 bg-sidebar-accent/40 hover:bg-sidebar-accent focus:bg-sidebar-accent gap-3 rounded-xl border px-3 py-3 text-[13px] font-semibold"
>
<LogOut className="h-[18px] w-[18px]" />
Logout
</DropdownMenuItem>
</div>
</DropdownMenuContent>
</DropdownMenu>
</div>
</aside>
);
}