import { useRef, useState, type ReactNode } from "react"; import { useTranslation } from "react-i18next"; import { ArrowDown, ArrowUp, ListFilter, X } from "lucide-react"; import { PopoverItem, PopoverSurface, useAnchoredPopover } from "./AnchoredPopover"; import { useScrollFade } from "../lib/useScrollFade"; import { type SortState } from "../lib/columnSort"; // The column-header machinery — the column contract, the sortable header row with its filter // funnel + popover, and the filter predicate — lifted OUT of DataTable so a non-DataTable body can // render under the same headers. // // Why it lives here and not in DataTable: DataTable owns its filter/sort/page state internally, // while the playlist manager's body is a drag-reorderable list whose order is the persisted // server-side one. Two owners of the same ordering fight; composing these pieces instead lets the // playlist keep its stored order and still get real column headers. Same move as E4 S3's // ChannelLayoutGrid, which builds a card view straight from the `Column` render closures. type ColumnFilter = | { kind: "text"; get: (row: T) => string } | { kind: "select"; options: { value: string; label: string }[]; test: (row: T, value: string) => boolean; } | { kind: "multi"; options: { value: string; label: string }[]; test: (row: T, values: string[]) => boolean; }; export interface Column { key: string; header: string; render: (row: T) => ReactNode; align?: "left" | "right" | "center"; width?: string; sortable?: boolean; sortValue?: (row: T) => string | number; filter?: ColumnFilter; // Keep the cell on one line so the column auto-sizes to its content (table-layout: auto). nowrap?: boolean; // Card fallback (below md): `cardPrimary` renders as the card heading (no label); `hideInCard` // omits the column; `cardLabel:false` shows the value without its header label. cardPrimary?: boolean; hideInCard?: boolean; cardLabel?: boolean; } export type FilterMap = Record; export function isActive(value: string | string[] | undefined): boolean { return Array.isArray(value) ? value.length > 0 : !!value; } /** Apply every column's own filter predicate. A column with no filter, or an empty value, passes. */ export function filterRows(rows: T[], columns: Column[], filters: FilterMap): T[] { return rows.filter((row) => columns.every((col) => { const f = col.filter; if (!f) return true; const val = filters[col.key]; if (!isActive(val)) return true; if (f.kind === "text") return f.get(row).toLowerCase().includes(String(val).toLowerCase()); if (f.kind === "select") return f.test(row, String(val)); return f.test(row, val as string[]); }), ); } export const alignClass = (a?: "left" | "right" | "center") => a === "right" ? "text-right" : a === "center" ? "text-center" : "text-left"; // The multi-select filter's option list, capped and scrollable. Its own component because it owns a // hook — see the FilterPopover note below for why nesting either of these would remount them. function FilterOptionList({ children }: { children: ReactNode }) { const fade = useScrollFade(); return (
{children}
); } // MODULE LEVEL, deliberately. The panel used to be declared inside DataTable's body, which made it a // NEW component type on every render: React unmounted and remounted the popover on each keystroke, // so the caret jumped to the end and IME composition (accents, any CJK input) broke mid-word. The // `autoFocus` masked it well enough that it read as "the filter is just twitchy". // // The funnel and its panel live in ONE component because the R8 popover platform anchors the panel // to its trigger. That also retires this file's three hand-rolled focus chores: capturing the // trigger element at open time (a `ref` scoped to the open column nulled out before focus could go // back), the restore-focus effect that stopped Escape stranding focus on , and the useDismiss // registration that had to include the trigger so its own mousedown didn't close-then-reopen. function FilterFunnel({ col, value, onApply, open, onOpenChange, }: { col: Column; value: string | string[] | undefined; onApply: (key: string, value: string | string[]) => void; open: boolean; onOpenChange: (open: boolean) => void; }) { const { t } = useTranslation(); const f = col.filter!; const inputRef = useRef(null); // A text filter is a free-text field, so it is a dialog whose input takes focus; the option lists // are real menus with roving focus. `select` is one exclusive choice (radio), `multi` is several // independent ones (checkbox). const isText = f.kind === "text"; const pop = useAnchoredPopover({ open, onOpenChange, mode: isText ? "dialog" : "menu", role: isText ? "dialog" : "menu", }); const filterOn = isActive(value); return ( <> {f.kind === "text" && ( onApply(col.key, e.target.value)} placeholder={col.header} className="w-full bg-surface border border-border rounded-md px-2 py-1 text-xs focus:outline-hidden focus:ring-2 focus:ring-accent/40" /> )} {f.kind === "select" && (
onApply(col.key, "")} label={t("datatable.all")} className={`text-left text-xs px-2 py-1.5 rounded-md outline-hidden transition ${ !filterOn ? "bg-accent text-accent-fg" : "text-muted hover:bg-card" }`} > {t("datatable.all")} {f.options.map((o) => ( onApply(col.key, o.value)} label={o.label} className={`text-left text-xs px-2 py-1.5 rounded-md outline-hidden transition ${ value === o.value ? "bg-accent text-accent-fg" : "text-muted hover:bg-card" }`} > {o.label} ))}
)} {f.kind === "multi" && ( {f.options.length === 0 && ( {t("datatable.noOptions")} )} {f.options.map((o) => { const arr = (value as string[]) ?? []; const on = arr.includes(o.value); return ( onApply(col.key, on ? arr.filter((x) => x !== o.value) : [...arr, o.value]) } label={o.label} className={`flex w-full items-center gap-2 text-left text-xs px-2 py-1.5 rounded-md outline-hidden transition ${ on ? "text-fg" : "text-muted" }`} > {on && } {o.label} ); })} )} {filterOn && ( )}
); } /** The sticky ``: one sortable/filterable cell per column. * * Sticky-header notes (kept from DataTable, where this look was designed): the header stays put at * the top of the page scroller while rows scroll under it. `bg-bg` on each cell stops rows showing * through; the bottom border rides a `box-shadow` because a sticky ``'s own border scrolls away * with the collapsed table box in some browsers. The `::after` paints a short fade just BELOW the * header so rows dissolve as they slide under it while the header itself stays crisp — which is why * pages using this pass `PageShell fadeTop={false}`. */ export function ColumnHead({ columns, sort, onToggleSort, filters, onFilter, }: { columns: Column[]; sort: SortState; onToggleSort: (key: string) => void; filters: FilterMap; onFilter: (key: string, value: string | string[]) => void; }) { // Only one column's filter panel is open at a time; each funnel owns its own anchoring. const [openFilter, setOpenFilter] = useState(null); return ( {columns.map((col) => { const isSorted = sort?.key === col.key; return ( {/* Only a sortable header is a control. A non-sortable one used to render a focusable no-op button, which put unlabeled dead stops in the tab order — two of them per playlist table, whose grip and actions headers are empty. */} {col.sortable ? ( ) : ( {col.header} )} {col.filter && ( setOpenFilter(o ? col.key : null)} /> )} ); })} ); }