Merge branch 'main' into feature/hardover-shelves

This commit is contained in:
kikootwo
2026-03-03 22:23:41 -05:00
43 changed files with 4489 additions and 423 deletions
-170
View File
@@ -1,170 +0,0 @@
/**
* Component: Sticky Pagination with Progress Bar
* Documentation: documentation/frontend/components.md
*/
'use client';
import React, { useState, useEffect, useRef } from 'react';
import { ChevronLeftIcon, ChevronRightIcon } from '@heroicons/react/24/outline';
interface StickyPaginationProps {
currentPage: number;
totalPages: number;
onPageChange: (page: number) => void;
sectionRef: React.RefObject<HTMLElement | null>;
label: string; // e.g., "Popular Audiobooks"
footerRef?: React.RefObject<HTMLElement | null>; // Optional footer ref to avoid overlap
}
export function StickyPagination({
currentPage,
totalPages,
onPageChange,
sectionRef,
label,
footerRef,
}: StickyPaginationProps) {
const [isVisible, setIsVisible] = useState(false);
const [isFooterVisible, setIsFooterVisible] = useState(false);
const [jumpPage, setJumpPage] = useState(currentPage.toString());
// Update jump page input when current page changes externally
useEffect(() => {
setJumpPage(currentPage.toString());
}, [currentPage]);
// Intersection Observer to show/hide pagination based on section visibility
useEffect(() => {
if (!sectionRef.current) return;
const observer = new IntersectionObserver(
([entry]) => {
// Show pagination when section is in viewport
setIsVisible(entry.isIntersecting && entry.intersectionRatio > 0.1);
},
{
threshold: [0, 0.1, 0.5, 1],
rootMargin: '-60px 0px -60px 0px', // Account for header/footer
}
);
observer.observe(sectionRef.current);
return () => observer.disconnect();
}, [sectionRef]);
// Footer observer to hide pagination when footer is visible
useEffect(() => {
if (!footerRef?.current) return;
const observer = new IntersectionObserver(
([entry]) => {
// Hide pagination when footer is in viewport
setIsFooterVisible(entry.isIntersecting);
},
{
threshold: [0, 0.1],
rootMargin: '0px',
}
);
observer.observe(footerRef.current);
return () => observer.disconnect();
}, [footerRef]);
if (totalPages <= 1) {
return null;
}
const handlePrevious = () => {
if (currentPage > 1) {
onPageChange(currentPage - 1);
}
};
const handleNext = () => {
if (currentPage < totalPages) {
onPageChange(currentPage + 1);
}
};
const handleJumpSubmit = (e: React.FormEvent) => {
e.preventDefault();
const page = parseInt(jumpPage, 10);
if (!isNaN(page) && page >= 1 && page <= totalPages) {
onPageChange(page);
} else {
// Reset to current page if invalid
setJumpPage(currentPage.toString());
}
};
// Final visibility: show when section is visible AND footer is not visible
const shouldShow = isVisible && !isFooterVisible;
return (
<div
className={`fixed bottom-6 left-1/2 -translate-x-1/2 z-40 transition-all duration-300 ${
shouldShow ? 'translate-y-0 opacity-100' : 'translate-y-20 opacity-0'
}`}
>
<div className="bg-white/95 dark:bg-gray-900/95 backdrop-blur-lg rounded-full shadow-lg border border-gray-200 dark:border-gray-700 px-4 py-2.5">
<div className="flex items-center gap-3">
{/* Section Label - Hidden on small screens */}
<div className="hidden md:block text-xs font-medium text-gray-600 dark:text-gray-400 pr-2 border-r border-gray-300 dark:border-gray-600">
{label}
</div>
{/* Previous Button */}
<button
onClick={handlePrevious}
disabled={currentPage === 1}
className="p-1.5 rounded-full hover:bg-gray-100 dark:hover:bg-gray-800
text-gray-700 dark:text-gray-300 disabled:opacity-30 disabled:cursor-not-allowed
transition-colors"
aria-label="Previous page"
>
<ChevronLeftIcon className="w-4 h-4" />
</button>
{/* Page Info & Jump */}
<div className="flex items-center gap-1.5">
<span className="text-sm text-gray-600 dark:text-gray-400 whitespace-nowrap">
Page
</span>
<form onSubmit={handleJumpSubmit} className="inline-flex">
<input
type="text"
value={jumpPage}
onChange={(e) => setJumpPage(e.target.value)}
onBlur={handleJumpSubmit}
className="w-10 px-1.5 py-0.5 text-center text-sm font-medium rounded
bg-gray-100 dark:bg-gray-800 text-gray-900 dark:text-gray-100
border border-gray-300 dark:border-gray-600
focus:outline-none focus:ring-1 focus:ring-blue-500 focus:border-transparent"
aria-label="Current page"
/>
</form>
<span className="text-sm text-gray-600 dark:text-gray-400 whitespace-nowrap">
of {totalPages}
</span>
</div>
{/* Next Button */}
<button
onClick={handleNext}
disabled={currentPage === totalPages}
className="p-1.5 rounded-full hover:bg-gray-100 dark:hover:bg-gray-800
text-gray-700 dark:text-gray-300 disabled:opacity-30 disabled:cursor-not-allowed
transition-colors"
aria-label="Next page"
>
<ChevronRightIcon className="w-4 h-4" />
</button>
</div>
</div>
</div>
);
}
+325
View File
@@ -0,0 +1,325 @@
/**
* Component: Unified Pagination — context-aware floating paginator
* Documentation: documentation/frontend/components.md
*
* Replaces two overlapping StickyPagination instances with a single pill
* that automatically tracks which section dominates the viewport and shows
* controls for that section. Transitions smoothly when the dominant section
* changes. Includes a two-dot section indicator for manual switching.
*/
'use client';
import React, { useState, useEffect, useRef, useCallback } from 'react';
import { ChevronLeftIcon, ChevronRightIcon } from '@heroicons/react/24/outline';
export interface PaginationSection {
/** Display label, e.g. "Popular Audiobooks" */
label: string;
/** Tailwind color class applied to the active accent dot, e.g. "bg-blue-500" */
accentColor: string;
currentPage: number;
totalPages: number;
onPageChange: (page: number) => void;
/** Ref to the section element — used for intersection tracking */
sectionRef: React.RefObject<HTMLElement | null>;
/** Called when user clicks this section's dot while it's inactive — should scroll to section */
onScrollToSection: () => void;
}
interface UnifiedPaginationProps {
sections: [PaginationSection, PaginationSection];
footerRef?: React.RefObject<HTMLElement | null>;
}
// ---------------------------------------------------------------------------
// Small page-jump form — isolated to prevent key re-mounts on section switch
// ---------------------------------------------------------------------------
interface PageJumpProps {
currentPage: number;
totalPages: number;
onPageChange: (page: number) => void;
}
function PageJump({ currentPage, totalPages, onPageChange }: PageJumpProps) {
const [value, setValue] = useState(currentPage.toString());
// Sync when page changes externally (e.g. after scrollIntoView + setState)
useEffect(() => {
setValue(currentPage.toString());
}, [currentPage]);
const commit = useCallback(
(e?: React.FormEvent) => {
e?.preventDefault();
const parsed = parseInt(value, 10);
if (!isNaN(parsed) && parsed >= 1 && parsed <= totalPages) {
onPageChange(parsed);
} else {
setValue(currentPage.toString());
}
},
[value, currentPage, totalPages, onPageChange]
);
return (
<div className="flex items-center gap-1.5">
<span className="text-sm text-gray-500 dark:text-gray-400 select-none whitespace-nowrap">
Page
</span>
<form onSubmit={commit} className="inline-flex">
<input
type="text"
inputMode="numeric"
value={value}
onChange={(e) => setValue(e.target.value)}
onBlur={commit}
className="w-10 px-1.5 py-0.5 text-center text-sm font-medium rounded-md
bg-black/[0.04] dark:bg-white/[0.08]
text-gray-900 dark:text-gray-100
border border-gray-300/60 dark:border-white/10
focus:outline-none focus:ring-2 focus:ring-blue-500/50 focus:border-transparent
transition-all duration-150"
aria-label="Jump to page"
/>
</form>
<span className="text-sm text-gray-500 dark:text-gray-400 select-none whitespace-nowrap">
of {totalPages}
</span>
</div>
);
}
// ---------------------------------------------------------------------------
// Main component
// ---------------------------------------------------------------------------
export function UnifiedPagination({ sections, footerRef }: UnifiedPaginationProps) {
// Index of the currently dominant section (0 or 1)
const [activeIndex, setActiveIndex] = useState<0 | 1>(0);
// Whether the label+controls area is mid-transition (drives opacity fade)
const [isTransitioning, setIsTransitioning] = useState(false);
const [footerVisible, setFooterVisible] = useState(false);
// Per-section raw intersection ratios [0,1]
const ratiosRef = useRef<[number, number]>([0, 0]);
// Whether each section has any meaningful intersection
const [sectionVisible, setSectionVisible] = useState<[boolean, boolean]>([false, false]);
const transitionTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
// Determine if the pill should be shown at all:
// - at least one section is meaningfully visible
// - footer is not visible
// - the active section has >1 page
const activeSectionHasPages = sections[activeIndex].totalPages > 1;
const eitherSectionVisible = sectionVisible[0] || sectionVisible[1];
const shouldShow = eitherSectionVisible && !footerVisible && activeSectionHasPages;
// ------------------------------------------------------------------
// Track which section each instance belongs to via intersection ratio
// ------------------------------------------------------------------
useEffect(() => {
const observers: IntersectionObserver[] = [];
sections.forEach((section, idx) => {
if (!section.sectionRef.current) return;
const observer = new IntersectionObserver(
([entry]) => {
ratiosRef.current[idx as 0 | 1] = entry.intersectionRatio;
const isVisible = entry.isIntersecting && entry.intersectionRatio > 0.05;
setSectionVisible((prev) => {
const next: [boolean, boolean] = [...prev] as [boolean, boolean];
next[idx as 0 | 1] = isVisible;
return next;
});
// Determine dominant section (whichever has more viewport coverage)
const [r0, r1] = ratiosRef.current;
const dominant: 0 | 1 = r0 >= r1 ? 0 : 1;
setActiveIndex((current) => {
if (current !== dominant) {
// Trigger cross-fade transition
setIsTransitioning(true);
if (transitionTimerRef.current) {
clearTimeout(transitionTimerRef.current);
}
transitionTimerRef.current = setTimeout(() => {
setIsTransitioning(false);
}, 320);
return dominant;
}
return current;
});
},
{
// Dense threshold array gives us smooth ratio tracking
threshold: Array.from({ length: 21 }, (_, i) => i / 20),
rootMargin: '-60px 0px -80px 0px',
}
);
observer.observe(section.sectionRef.current);
observers.push(observer);
});
return () => {
observers.forEach((o) => o.disconnect());
if (transitionTimerRef.current) clearTimeout(transitionTimerRef.current);
};
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [sections[0].sectionRef, sections[1].sectionRef]);
// ------------------------------------------------------------------
// Footer observer
// ------------------------------------------------------------------
useEffect(() => {
if (!footerRef?.current) return;
const observer = new IntersectionObserver(
([entry]) => setFooterVisible(entry.isIntersecting),
{ threshold: [0, 0.01] }
);
observer.observe(footerRef.current);
return () => observer.disconnect();
}, [footerRef]);
// ------------------------------------------------------------------
// Derived values for the currently active section
// ------------------------------------------------------------------
const active = sections[activeIndex];
const handlePrev = () => {
if (active.currentPage > 1) active.onPageChange(active.currentPage - 1);
};
const handleNext = () => {
if (active.currentPage < active.totalPages) active.onPageChange(active.currentPage + 1);
};
// ------------------------------------------------------------------
// Render
// ------------------------------------------------------------------
return (
<div
className={`
fixed bottom-6 left-1/2 -translate-x-1/2 z-40
transition-all duration-300 ease-out
${shouldShow
? 'translate-y-0 opacity-100 pointer-events-auto'
: 'translate-y-4 opacity-0 pointer-events-none'
}
`}
aria-hidden={!shouldShow}
>
{/* Pill surface */}
<div
className="
flex items-center gap-0
bg-white/90 dark:bg-gray-900/90
backdrop-blur-xl
rounded-full
shadow-[0_8px_32px_rgba(0,0,0,0.12),0_2px_8px_rgba(0,0,0,0.08)]
dark:shadow-[0_8px_32px_rgba(0,0,0,0.4),0_2px_8px_rgba(0,0,0,0.3)]
border border-gray-200/60 dark:border-white/[0.08]
px-1.5 py-1.5
overflow-hidden
"
>
{/* Section selector dots — left side */}
<div className="flex flex-col gap-1 pl-2 pr-3">
{sections.map((section, idx) => {
const isActive = idx === activeIndex;
return (
<button
key={section.label}
onClick={() => {
if (!isActive) section.onScrollToSection();
}}
disabled={isActive}
title={section.label}
aria-label={`Switch to ${section.label}`}
className={`
w-1.5 rounded-full transition-all duration-300 ease-out
${isActive
? `${section.accentColor} h-4 opacity-100`
: 'bg-gray-300 dark:bg-gray-600 h-1.5 opacity-60 hover:opacity-90 hover:scale-110 cursor-pointer'
}
`}
/>
);
})}
</div>
{/* Divider */}
<div className="w-px h-6 bg-gray-200 dark:bg-white/10 mr-3 flex-shrink-0" />
{/* Label + controls — cross-fades on section switch */}
<div
className={`
flex items-center gap-3
transition-opacity duration-200 ease-in-out
${isTransitioning ? 'opacity-0' : 'opacity-100'}
`}
// key forces full remount on switch so input state resets cleanly
key={activeIndex}
>
{/* Section label — hidden on small screens */}
<span className="hidden sm:block text-xs font-medium text-gray-500 dark:text-gray-400 whitespace-nowrap pr-1 select-none">
{active.label}
</span>
{/* Previous */}
<button
onClick={handlePrev}
disabled={active.currentPage === 1}
aria-label="Previous page"
className="
p-1.5 rounded-full
text-gray-600 dark:text-gray-300
hover:bg-black/[0.06] dark:hover:bg-white/[0.08]
active:bg-black/[0.1] dark:active:bg-white/[0.12]
active:scale-95
disabled:opacity-25 disabled:cursor-not-allowed
transition-all duration-150
"
>
<ChevronLeftIcon className="w-4 h-4" strokeWidth={2} />
</button>
{/* Page jump */}
<PageJump
currentPage={active.currentPage}
totalPages={active.totalPages}
onPageChange={active.onPageChange}
/>
{/* Next */}
<button
onClick={handleNext}
disabled={active.currentPage === active.totalPages}
aria-label="Next page"
className="
p-1.5 rounded-full
text-gray-600 dark:text-gray-300
hover:bg-black/[0.06] dark:hover:bg-white/[0.08]
active:bg-black/[0.1] dark:active:bg-white/[0.12]
active:scale-95
disabled:opacity-25 disabled:cursor-not-allowed
transition-all duration-150
"
>
<ChevronRightIcon className="w-4 h-4" strokeWidth={2} />
</button>
</div>
{/* Right padding balance */}
<div className="w-2" />
</div>
</div>
);
}
+186
View File
@@ -0,0 +1,186 @@
/**
* Component: Watch Button (Series / Author)
* Documentation: documentation/features/watched-lists.md
*
* Reusable toggle button for watching/unwatching a series or author.
* Shows a confirmation modal before watching. Unwatching is instant.
*/
'use client';
import React, { useState } from 'react';
import { useWatchedSeries, useAddWatchedSeries, useDeleteWatchedSeries } from '@/lib/hooks/useWatchedSeries';
import { useWatchedAuthors, useAddWatchedAuthor, useDeleteWatchedAuthor } from '@/lib/hooks/useWatchedAuthors';
import { ConfirmModal } from './ConfirmModal';
interface WatchSeriesButtonProps {
seriesAsin: string;
seriesTitle: string;
coverArtUrl?: string;
}
export function WatchSeriesButton({ seriesAsin, seriesTitle, coverArtUrl }: WatchSeriesButtonProps) {
const { series } = useWatchedSeries();
const { addSeries, isLoading: isAdding } = useAddWatchedSeries();
const { deleteSeries, isLoading: isDeleting } = useDeleteWatchedSeries();
const [error, setError] = useState<string | null>(null);
const [showConfirm, setShowConfirm] = useState(false);
const watchedEntry = series.find((s) => s.seriesAsin === seriesAsin);
const isWatching = !!watchedEntry;
const isLoading = isAdding || isDeleting;
const handleClick = async () => {
setError(null);
if (isWatching && watchedEntry) {
// Unwatch immediately (no confirmation needed)
try {
await deleteSeries(watchedEntry.id);
} catch (err) {
setError(err instanceof Error ? err.message : 'Failed');
}
} else {
// Show confirmation before watching
setShowConfirm(true);
}
};
const handleConfirmWatch = async () => {
setShowConfirm(false);
setError(null);
try {
await addSeries(seriesAsin, seriesTitle, coverArtUrl);
} catch (err) {
setError(err instanceof Error ? err.message : 'Failed');
}
};
return (
<div className="inline-flex flex-col items-start">
<button
onClick={handleClick}
disabled={isLoading}
className={`inline-flex items-center gap-2 px-4 py-2 text-sm font-medium rounded-lg transition-all duration-200 ${
isWatching
? 'bg-emerald-50 dark:bg-emerald-900/30 text-emerald-700 dark:text-emerald-300 hover:bg-emerald-100 dark:hover:bg-emerald-900/50 border border-emerald-200 dark:border-emerald-700/50'
: 'bg-gray-100 dark:bg-gray-700/50 text-gray-700 dark:text-gray-300 hover:bg-emerald-50 dark:hover:bg-emerald-900/20 hover:text-emerald-700 dark:hover:text-emerald-300 border border-gray-200 dark:border-gray-600/50 hover:border-emerald-200 dark:hover:border-emerald-700/50'
} ${isLoading ? 'opacity-60 cursor-not-allowed' : ''}`}
>
{isLoading ? (
<svg className="w-4 h-4 animate-spin" fill="none" viewBox="0 0 24 24">
<circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4" />
<path className="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z" />
</svg>
) : isWatching ? (
<svg className="w-4 h-4" fill="currentColor" viewBox="0 0 24 24">
<path d="M12 4.5C7 4.5 2.73 7.61 1 12c1.73 4.39 6 7.5 11 7.5s9.27-3.11 11-7.5c-1.73-4.39-6-7.5-11-7.5zM12 17c-2.76 0-5-2.24-5-5s2.24-5 5-5 5 2.24 5 5-2.24 5-5 5zm0-8c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3-1.34-3-3-3z" />
</svg>
) : (
<svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" />
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z" />
</svg>
)}
{isWatching ? 'Watching' : 'Watch Series'}
</button>
{error && (
<span className="text-xs text-red-500 mt-1">{error}</span>
)}
<ConfirmModal
isOpen={showConfirm}
onClose={() => setShowConfirm(false)}
onConfirm={handleConfirmWatch}
title={`Watch "${seriesTitle}"?`}
message={`This will request all books in "${seriesTitle}" that aren't already in your library, and automatically request new releases as they're added to the series. Continue?`}
confirmText="Watch"
isLoading={isAdding}
/>
</div>
);
}
interface WatchAuthorButtonProps {
authorAsin: string;
authorName: string;
coverArtUrl?: string;
}
export function WatchAuthorButton({ authorAsin, authorName, coverArtUrl }: WatchAuthorButtonProps) {
const { authors } = useWatchedAuthors();
const { addAuthor, isLoading: isAdding } = useAddWatchedAuthor();
const { deleteAuthor, isLoading: isDeleting } = useDeleteWatchedAuthor();
const [error, setError] = useState<string | null>(null);
const [showConfirm, setShowConfirm] = useState(false);
const watchedEntry = authors.find((a) => a.authorAsin === authorAsin);
const isWatching = !!watchedEntry;
const isLoading = isAdding || isDeleting;
const handleClick = async () => {
setError(null);
if (isWatching && watchedEntry) {
// Unwatch immediately (no confirmation needed)
try {
await deleteAuthor(watchedEntry.id);
} catch (err) {
setError(err instanceof Error ? err.message : 'Failed');
}
} else {
// Show confirmation before watching
setShowConfirm(true);
}
};
const handleConfirmWatch = async () => {
setShowConfirm(false);
setError(null);
try {
await addAuthor(authorAsin, authorName, coverArtUrl);
} catch (err) {
setError(err instanceof Error ? err.message : 'Failed');
}
};
return (
<div className="inline-flex flex-col items-start">
<button
onClick={handleClick}
disabled={isLoading}
className={`inline-flex items-center gap-2 px-4 py-2 text-sm font-medium rounded-lg transition-all duration-200 ${
isWatching
? 'bg-blue-50 dark:bg-blue-900/30 text-blue-700 dark:text-blue-300 hover:bg-blue-100 dark:hover:bg-blue-900/50 border border-blue-200 dark:border-blue-700/50'
: 'bg-gray-100 dark:bg-gray-700/50 text-gray-700 dark:text-gray-300 hover:bg-blue-50 dark:hover:bg-blue-900/20 hover:text-blue-700 dark:hover:text-blue-300 border border-gray-200 dark:border-gray-600/50 hover:border-blue-200 dark:hover:border-blue-700/50'
} ${isLoading ? 'opacity-60 cursor-not-allowed' : ''}`}
>
{isLoading ? (
<svg className="w-4 h-4 animate-spin" fill="none" viewBox="0 0 24 24">
<circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4" />
<path className="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z" />
</svg>
) : isWatching ? (
<svg className="w-4 h-4" fill="currentColor" viewBox="0 0 24 24">
<path d="M12 4.5C7 4.5 2.73 7.61 1 12c1.73 4.39 6 7.5 11 7.5s9.27-3.11 11-7.5c-1.73-4.39-6-7.5-11-7.5zM12 17c-2.76 0-5-2.24-5-5s2.24-5 5-5 5 2.24 5 5-2.24 5-5 5zm0-8c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3-1.34-3-3-3z" />
</svg>
) : (
<svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" />
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z" />
</svg>
)}
{isWatching ? 'Watching' : 'Watch Author'}
</button>
{error && (
<span className="text-xs text-red-500 mt-1">{error}</span>
)}
<ConfirmModal
isOpen={showConfirm}
onClose={() => setShowConfirm(false)}
onConfirm={handleConfirmWatch}
title={`Watch "${authorName}"?`}
message={`This will request all books by "${authorName}" that aren't already in your library, and automatically request new releases. Continue?`}
confirmText="Watch"
isLoading={isAdding}
/>
</div>
);
}