mirror of
https://github.com/calibrain/shelfmark.git
synced 2026-11-19 17:06:43 +00:00
## Headline features ### Prowlarr plugin - search trackers and download usenet/torrent books - Search any usenet/torrent tracker via Prowlarr, returns books within Universal search - Configure download clients in the app settings (Qbittorrent, Deluge, Transmission, NZBget, SABnzbd) - Unified download and file handling within the app, same as AA. ### IRC plugin - Search IRCHighway #ebooks channel for books and download right in the app. - No setup needed - Credit to OpenBooks for the broad idea and inspiration for best practices for ebook-specific search and download. ### Google Books Metadata Provider - Create a Google Cloud API key and use Google Books as a metadata provider - Not the best source (Hardcover is still recommended), but another option and further redundancy for universal search ### Book series support - New "Series" search field in Hardcover provider - "Series order" sort option - lists books in reading order - "View Series" button in book details modal to search the full series - Series info display (e.g., "3 of 12 in The Wheel of Time") ## Others: - Better format filtering, helpful errors when formats rejected (e.g., "Found 3 ebooks but format not supported (.pdf). Enable in Settings > Formats." - Directory processing - Handles multi-file torrent/usenet downloads properly - Expand search toggle - Skip ISBN search to find more editions - Filtered authors - Uses primary authors only (excludes translators/narrators) for better search results - Language multi-select - Filter releases by multiple languages Docker / Build / Testing - pip cache mounts - Faster Docker builds via BuildKit cache - npm cache mounts - Faster frontend builds - APT cleanup - Smaller final image size - Added make restart command for quick restarts without rebuild - New pytest-based test framework with proper configuration (pyproject.toml) - Unit tests for all download clients (qBittorrent, Transmission, Deluge, NZBGet, SABnzbd) - Bencode parsing tests - Cache tests - Integration tests for Prowlarr handler - E2E test framework
200 lines
7.0 KiB
TypeScript
200 lines
7.0 KiB
TypeScript
import { useState, useRef, useEffect } from 'react';
|
|
import { MultiSelectFieldConfig } from '../../../types/settings';
|
|
|
|
interface MultiSelectFieldProps {
|
|
field: MultiSelectFieldConfig;
|
|
value: string[];
|
|
onChange: (value: string[]) => void;
|
|
disabled?: boolean;
|
|
}
|
|
|
|
// Threshold for when to enable collapsible behavior
|
|
const COLLAPSE_THRESHOLD_OPTIONS = 12;
|
|
// Approximate height for ~4 rows of pills (pills are ~32px + 8px gap)
|
|
const COLLAPSED_HEIGHT = 156;
|
|
|
|
/**
|
|
* Sort options with selected items first, preserving relative order within each group
|
|
*/
|
|
const sortOptionsWithSelectedFirst = (
|
|
options: MultiSelectFieldConfig['options'],
|
|
selectedValues: string[]
|
|
): MultiSelectFieldConfig['options'] => {
|
|
const selectedSet = new Set(selectedValues);
|
|
const selectedOptions = options.filter((opt) => selectedSet.has(opt.value));
|
|
const unselectedOptions = options.filter((opt) => !selectedSet.has(opt.value));
|
|
return [...selectedOptions, ...unselectedOptions];
|
|
};
|
|
|
|
export const MultiSelectField = ({ field, value, onChange, disabled }: MultiSelectFieldProps) => {
|
|
const selected = value ?? [];
|
|
// disabled prop is already computed by SettingsContent.getDisabledState()
|
|
const isDisabled = disabled ?? false;
|
|
const [isExpanded, setIsExpanded] = useState(false);
|
|
// Initialize based on option count to avoid flash of expanded content
|
|
const [needsCollapse, setNeedsCollapse] = useState(
|
|
() => field.options.length > COLLAPSE_THRESHOLD_OPTIONS
|
|
);
|
|
const containerRef = useRef<HTMLDivElement>(null);
|
|
|
|
// Track the last value we set via onChange to detect external changes
|
|
const lastInternalValueRef = useRef<string[] | null>(null);
|
|
|
|
// Sorted options - initialized with selected items first, updated only on external changes
|
|
const [sortedOptions, setSortedOptions] = useState(() =>
|
|
sortOptionsWithSelectedFirst(field.options, selected)
|
|
);
|
|
|
|
// Detect external value changes (like after save or initial load) and re-sort
|
|
useEffect(() => {
|
|
// If the value changed and it's not from our own onChange call, re-sort
|
|
const lastInternal = lastInternalValueRef.current;
|
|
const isExternalChange =
|
|
lastInternal === null || // Initial mount
|
|
lastInternal.length !== selected.length ||
|
|
!lastInternal.every((v) => selected.includes(v));
|
|
|
|
// Only re-sort if the change wasn't triggered by user interaction
|
|
if (isExternalChange && lastInternal !== null) {
|
|
// Check if this is truly external (values differ in a way that suggests a save/reset)
|
|
const wasInternalToggle =
|
|
Math.abs(lastInternal.length - selected.length) === 1 &&
|
|
(lastInternal.every((v) => selected.includes(v)) ||
|
|
selected.every((v) => lastInternal.includes(v)));
|
|
|
|
if (!wasInternalToggle) {
|
|
setSortedOptions(sortOptionsWithSelectedFirst(field.options, selected));
|
|
}
|
|
}
|
|
}, [selected, field.options]);
|
|
|
|
// Update sortedOptions when field itself changes (different field or options refreshed)
|
|
useEffect(() => {
|
|
setSortedOptions(sortOptionsWithSelectedFirst(field.options, selected));
|
|
// eslint-disable-next-line react-hooks/exhaustive-deps -- intentionally omit 'selected' to avoid re-sorting on user toggle
|
|
}, [field.key, field.options]);
|
|
|
|
// Verify collapse need after render (handles edge cases where few options still fit)
|
|
useEffect(() => {
|
|
if (containerRef.current) {
|
|
if (field.options.length > COLLAPSE_THRESHOLD_OPTIONS) {
|
|
const scrollHeight = containerRef.current.scrollHeight;
|
|
setNeedsCollapse(scrollHeight > COLLAPSED_HEIGHT + 20);
|
|
} else {
|
|
setNeedsCollapse(false);
|
|
}
|
|
}
|
|
}, [field.options.length]);
|
|
|
|
const toggleOption = (optValue: string) => {
|
|
if (isDisabled) return;
|
|
let newValue: string[];
|
|
if (selected.includes(optValue)) {
|
|
newValue = selected.filter((v) => v !== optValue);
|
|
} else {
|
|
newValue = [...selected, optValue];
|
|
}
|
|
// Track this as an internal change so we don't re-sort
|
|
lastInternalValueRef.current = newValue;
|
|
onChange(newValue);
|
|
};
|
|
|
|
const isCollapsible = needsCollapse;
|
|
const isCollapsed = isCollapsible && !isExpanded;
|
|
|
|
return (
|
|
<div>
|
|
{/* Container with optional max-height constraint */}
|
|
<div className="relative">
|
|
<div
|
|
ref={containerRef}
|
|
className={`flex flex-wrap gap-2 transition-[max-height] duration-300 ease-in-out ${
|
|
isCollapsed ? 'overflow-hidden' : ''
|
|
}`}
|
|
style={{
|
|
maxHeight: isCollapsed ? `${COLLAPSED_HEIGHT}px` : '2000px',
|
|
}}
|
|
>
|
|
{sortedOptions.map((opt) => {
|
|
const isSelected = selected.includes(opt.value);
|
|
return (
|
|
<button
|
|
key={opt.value}
|
|
type="button"
|
|
onClick={() => toggleOption(opt.value)}
|
|
disabled={isDisabled}
|
|
className={`px-3 py-1.5 rounded-full text-sm font-medium
|
|
transition-colors border
|
|
disabled:opacity-60 disabled:cursor-not-allowed
|
|
${
|
|
isSelected
|
|
? 'bg-sky-600 text-white border-sky-600'
|
|
: 'bg-transparent border-[var(--border-muted)] hover:bg-[var(--hover-surface)]'
|
|
}`}
|
|
>
|
|
{opt.label}
|
|
</button>
|
|
);
|
|
})}
|
|
</div>
|
|
|
|
{/* Gradient fade overlay when collapsed */}
|
|
{isCollapsed && (
|
|
<div
|
|
className="absolute bottom-0 left-0 right-0 h-20 pointer-events-none"
|
|
style={{
|
|
background: 'linear-gradient(to top, var(--bg) 0%, transparent 85%)',
|
|
}}
|
|
/>
|
|
)}
|
|
</div>
|
|
|
|
{/* Expand/Collapse toggle - outside the relative container */}
|
|
{isCollapsible && (
|
|
<button
|
|
type="button"
|
|
onClick={() => setIsExpanded(!isExpanded)}
|
|
className="mt-2 text-sm text-sky-500 hover:text-sky-400
|
|
transition-colors flex items-center gap-1"
|
|
>
|
|
{isExpanded ? (
|
|
<>
|
|
<svg
|
|
className="w-4 h-4"
|
|
fill="none"
|
|
viewBox="0 0 24 24"
|
|
stroke="currentColor"
|
|
>
|
|
<path
|
|
strokeLinecap="round"
|
|
strokeLinejoin="round"
|
|
strokeWidth={2}
|
|
d="M5 15l7-7 7 7"
|
|
/>
|
|
</svg>
|
|
Show less
|
|
</>
|
|
) : (
|
|
<>
|
|
<svg
|
|
className="w-4 h-4"
|
|
fill="none"
|
|
viewBox="0 0 24 24"
|
|
stroke="currentColor"
|
|
>
|
|
<path
|
|
strokeLinecap="round"
|
|
strokeLinejoin="round"
|
|
strokeWidth={2}
|
|
d="M19 9l-7 7-7-7"
|
|
/>
|
|
</svg>
|
|
Show all {field.options.length} options
|
|
</>
|
|
)}
|
|
</button>
|
|
)}
|
|
</div>
|
|
);
|
|
};
|