@cosmicdrift/kumiko-renderer 0.388.0 → 0.390.0

package/dist/web/primitives/data-table.js

@@ -1,279 +1,37 @@
-import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { cardColumnRoles } from "@cosmicdrift/kumiko-framework/ui-types";
-import { ArrowDown, ArrowUp, ChevronDown, ChevronRight, Search, SlidersHorizontal, X, } from "lucide-react";
-import { Fragment, useId, useState, } from "react";
-import { useOptionalLocale, useOptionalTranslation } from "../../index.js";
-import { UNIFORM_BAR_CONTROLS_CLASSES } from "../layout/uniform-bar-controls.js";
+import { jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "../lib/cn.js";
-import { Button as UiButton } from "../ui/button.js";
-import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "../ui/table.js";
-import { CardLeadingImage } from "./file-thumbnail.js";
+import { renderTableContent } from "./data-table/table-content.js";
+import { buildModelFacetCluster, hasToolbarContent, renderToolbar, renderToolbarDescription, } from "./data-table/toolbar.js";
+import { useDataTableState } from "./data-table/use-data-table-state.js";
 import { screenPaddingClassName } from "./layout.js";
-import { useIsNarrowViewport } from "./use-narrow-viewport.js";
-import "../react-css-custom-properties.js";
-import { buildTableItems, cellLinkProp, cellTitle, DataTableCell, FIT_CONTENT_CELL_CLASS, FirstCellLink, isBadgeColumn, isEmptyCellValue, isUnlabeledFalse, NUMERIC_COLUMN_TYPES, rowToneClass, SortableHeader, showsBareCheckMark, TABULAR_COLUMN_TYPES, } from "./data-table-cell.js";
-import { DateRangeFacetFilter, FacetFilter } from "./facet-filter.js";
-import { InfiniteSentinel, Pager, TABLE_FOOTER_BAR_CLASS } from "./pager.js";
-import { RowActionsCell } from "./row-actions.js";
-// The vendored Table wraps <table> in an `overflow-x-auto` container, which
-// would become the scrollport of a sticky header. A scrollBody table scrolls
-// in its parent instead, so it renders the bare <table>.
-function FlushTable({ className, ...props }) {
-    return (_jsx("table", { "data-slot": "table", className: cn("w-full caption-bottom text-sm", className), ...props }));
+// `screenPadding`: on a list screen this wrapper IS the screen container,
+// so it takes the same token as FormScreenShell/PageSection instead of its
+// own inset — a list ends at the same footer distance as a form.
+// Explicit `false` (vs. the default/omitted case) means a host that
+// already pads its own children — a relatedList section nested in a
+// tabs-mode Card — so this wrapper adds no inset of its
+// own, or its content would sit ~24px deeper than sibling banners in the
+// same Card body.
+function screenPaddingOf(screenPadding) {
+    if (screenPadding === true)
+        return screenPaddingClassName;
+    return screenPadding === false ? undefined : "p-6";
 }
-// Header cells stick to the scroll surface; the bottom rule is an inset
-// shadow because a border on a sticky cell scrolls away under border-collapse.
-// Column weight (medium vs. semibold for the sorted one) lives on the th itself
-// in SortableHeader: a `[&_th]:font-*` rule here would outrank it.
-// Child selectors only: an expanded row nests a whole table inside a cell, and
-// descendant selectors would make its header sticky and re-pad its cells.
-const FILL_TABLE_CLASS = cn("[&>thead>tr>th]:sticky [&>thead>tr>th]:top-0 [&>thead>tr>th]:z-10 [&>thead>tr>th]:h-9 [&>thead>tr>th]:bg-muted [&>thead>tr>th]:px-2 [&>thead>tr>th]:text-[13px]", "[&>thead>tr>th]:shadow-[inset_0_-1px_0_var(--color-border)] [&>thead>tr>th_button]:text-[13px] [&>tbody>tr>td]:px-2 [&>tbody>tr>td]:py-0", "[&>*>tr>:first-child]:pl-6 [&>*>tr>:last-child]:pr-6");
-// `!`: beats the first/last-child padding of FILL_TABLE_CLASS, which would
-// otherwise widen the narrow toggle column / pad the full-width expansion cell.
-// The nested table's sticky actions cell (last td) gets the muted surface
-// instead of its own md:bg-background, so it blends into the area.
-const EXPAND_TOGGLE_CELL_CLASS = "w-10 px-1! py-0!";
-const EXPANSION_CELL_CLASS = "whitespace-normal bg-muted p-0! align-top md:[&_td:last-child]:bg-muted";
-const EXPANSION_CONTENT_CLASS = "pt-1 pr-4 pb-3.5 pl-[52px]";
-function RowExpandToggle({ expanded, controlsId, label, onToggle, testId, }) {
-    return (_jsx(UiButton, { type: "button", variant: "ghost", size: "icon", className: "size-8 shrink-0 max-md:size-11", "aria-expanded": expanded, ...(expanded && { "aria-controls": controlsId }), "aria-label": label, "data-testid": testId, onClick: (e) => {
-            e.stopPropagation();
-            onToggle();
-        }, onKeyDown: (e) => e.stopPropagation(), children: _jsx(ChevronRight, { className: cn("size-4 transition-transform", expanded && "rotate-90"), "aria-hidden": "true" }) }));
+function wrapperClassName({ fillsHeight, screenPadding }) {
+    return cn("flex flex-col w-full", 
+    // scrollBody: the wrapper fills its container so the footer sits at the
+    // same spot at 3 and 300 rows; the 24px insets live in toolbar, cells
+    // and footer, so no outer padding.
+    fillsHeight ? "h-full min-h-0" : cn("gap-4", screenPaddingOf(screenPadding)));
 }
-function DataTableFooter({ count, itemNoun, testId, }) {
-    const t = useOptionalTranslation();
-    const noun = itemNoun?.(count);
-    const label = noun !== undefined
-        ? (t?.("kumiko.list.count.noun", { count: count.toLocaleString(), noun }) ??
-            `${count.toLocaleString()} ${noun}`)
-        : count === 1
-            ? (t?.("kumiko.list.count.one") ?? "1 entry")
-            : (t?.("kumiko.list.count.other", { count: count.toLocaleString() }) ??
-                `${count.toLocaleString()} entries`);
-    return (_jsx("div", { "data-testid": testId, className: TABLE_FOOTER_BAR_CLASS, children: _jsx("span", { "data-testid": `${testId}-count`, children: label }) }));
-}
-// Cell content is a ReactNode, so the tooltip text is read from the rendered DOM.
-function showFullTextOnHover(event) {
-    const element = event.currentTarget;
-    element.title = element.scrollWidth > element.clientWidth ? (element.textContent ?? "") : "";
-}
-export function DefaultDataTable({ columns, rows, onRowClick, sort, onSortChange, emptyState, toolbarStart, toolbarDescription, toolbarEnd, pager, onReachEnd, loadingMore, hasMore, itemNoun, rowActions, rowActionMode, rowGrouping, rowTone, filterFacets, filterValues, onFilterChange, onFilterReset, dateRangeFacets, onDateRangeChange, testId, onCellChange, getRowTestId, getCellTestId, chromeless, scrollBody, screenPadding, expandedRowIds, onToggleRowExpanded, renderExpandedRow, }) {
-    // One locale/translate subscription per table — not per cell.
-    // Optional hooks: a bare DataTable outside LocaleProvider must not crash.
-    const tableTranslate = useOptionalTranslation();
-    const tableLocale = useOptionalLocale();
-    // Below 768px a table scrolls its columns out of reach with no visible
-    // affordance. Cards replace the table entirely below the breakpoint — same
-    // single-mount pattern as EmbeddedListInput/embedded-list-input.tsx.
-    const isNarrow = useIsNarrowViewport();
-    const [facetsOpenNarrow, setFacetsOpenNarrow] = useState(false);
-    const [toggledGroups, setToggledGroups] = useState(new Set());
-    // Toolbar wrapper: shared container for toolbar + table so the two belong
-    // together visually. The toolbar is NOT sticky: lists typically scroll with
-    // the page container, not internally. Sticky would compete with the topbar.
-    // The row click already runs rowClick actions, so with a clickable row they
-    // must not reappear in the kebab (a list whose only action is the rowClick
-    // one gets no actions column at all).
-    const rowIsLink = onRowClick !== undefined;
-    const menuActions = rowActions !== undefined && rowIsLink
-        ? rowActions.filter((action) => action.rowClick !== true)
-        : rowActions;
-    // The table keeps every action in "inline" mode, and with editable cells the
-    // first cell is not a keyboard link (FirstCellLink is off), so the kebab is
-    // then the only keyboard route to the rowClick action.
-    const tableActions = rowActionMode === "inline" || onCellChange !== undefined ? rowActions : menuActions;
-    const rowClickAction = rowActions?.find((action) => action.rowClick === true);
-    const rowClickLabel = rowClickAction?.label;
-    const rowClickIsHidden = (row) => rowClickAction?.isVisible !== undefined && !rowClickAction.isVisible(row);
-    const hasTableActions = tableActions !== undefined && tableActions.length > 0;
-    const isEmpty = rows.length === 0;
-    const expansionIdPrefix = useId();
-    const isRowExpandable = renderExpandedRow !== undefined && onToggleRowExpanded !== undefined;
-    const rowTestId = (row) => getRowTestId?.(row) ?? `row-${row.id}`;
-    const expansionDomId = (row) => `${expansionIdPrefix}-${row.id}`;
-    // The expand toggle of a row, shared by table and card layout. Named after
-    // the first data column, the one a user recognizes the row by.
-    function renderExpandToggle(row) {
-        if (!isRowExpandable)
-            return null;
-        const expanded = expandedRowIds?.has(row.id) === true;
-        const firstColumn = columns[0];
-        const title = (firstColumn !== undefined ? cellTitle(row.values[firstColumn.field]) : undefined) ?? "";
-        const labelKey = expanded ? "kumiko.list.row.collapse" : "kumiko.list.row.expand";
-        return (_jsx(RowExpandToggle, { expanded: expanded, controlsId: expansionDomId(row), label: tableTranslate?.(labelKey, { title }) ?? `${expanded ? "Collapse" : "Expand"} ${title}`, onToggle: () => onToggleRowExpanded(row.id), testId: `${rowTestId(row)}-toggle` }));
-    }
-    function renderExpansion(row, as, colSpan) {
-        if (!isRowExpandable || expandedRowIds?.has(row.id) !== true)
-            return null;
-        const content = renderExpandedRow(row);
-        if (as === "item") {
-            return (_jsx("li", { id: expansionDomId(row), "data-testid": `${rowTestId(row)}-expansion`, className: "border-b border-border-row bg-muted px-4 pt-1 pb-3.5", children: content }));
-        }
-        return (_jsx(TableRow, { id: expansionDomId(row), "data-testid": `${rowTestId(row)}-expansion`, className: "hover:bg-transparent", children: _jsx(TableCell, { colSpan: colSpan, className: EXPANSION_CELL_CLASS, children: _jsx("div", { className: EXPANSION_CONTENT_CLASS, children: content }) }) }));
-    }
-    const fillsHeight = scrollBody === true;
-    const TableRoot = fillsHeight ? FlushTable : Table;
-    const emptyBlock = (_jsx("div", { "data-testid": testId !== undefined ? `${testId}-empty` : "render-list-empty", className: cn("flex flex-col items-center justify-center p-12 text-sm text-muted-foreground gap-3", chromeless !== true && !fillsHeight && "rounded-md border border-dashed"), children: emptyState ?? _jsx("span", { children: tableTranslate?.("kumiko.list.no-entries") ?? "No entries." }) }));
-    const tableItems = buildTableItems(rows, rowGrouping, toggledGroups);
-    function renderGroupToggle(item) {
-        return (_jsxs("button", { type: "button", "aria-expanded": !item.collapsed, "data-testid": `row-group-${item.key}-toggle`, onClick: () => setToggledGroups((prev) => {
-                const next = new Set(prev);
-                if (!next.delete(item.key))
-                    next.add(item.key);
-                return next;
-            }), className: "flex w-full items-center gap-2 px-4 py-2 text-left text-xs font-medium text-foreground-secondary", children: [item.collapsed ? (_jsx(ChevronRight, { className: "size-3.5" })) : (_jsx(ChevronDown, { className: "size-3.5" })), item.label] }));
-    }
-    function tableInner() {
-        if (isEmpty)
-            return emptyBlock;
-        return (_jsx("div", { className: cn(!fillsHeight && "overflow-hidden", !fillsHeight && chromeless !== true && "rounded-lg border bg-card"), children: _jsxs(TableRoot, { "data-testid": testId, className: fillsHeight ? FILL_TABLE_CLASS : undefined, children: [_jsx(TableHeader, { className: "bg-muted", children: _jsxs(TableRow, { className: "hover:bg-transparent", children: [isRowExpandable && (_jsx(TableHead, { "data-testid": "column-expand", className: EXPAND_TOGGLE_CELL_CLASS })), columns.map((col) => (_jsx(SortableHeader, { field: col.field, label: col.label, sortable: col.sortable === true, highlighted: col.highlighted === true, numeric: NUMERIC_COLUMN_TYPES.has(col.type), fitContent: col.fileDisplay !== undefined, ...(sort !== undefined && sort !== null && { sort }), ...(onSortChange !== undefined && { onSortChange }) }, col.field))), hasTableActions && (_jsx(TableHead, { "data-testid": "column-actions", 
-                                    // From md: sticky right-0 + bg-muted (= header tone) so the
-                                    // action column stays at the right edge during horizontal
-                                    // scroll on wider screens. Below md, actions scroll in
-                                    // normal flow — sticky there would pin the column over the
-                                    // preceding data column instead of the (already narrow)
-                                    // page edge. No border-l: a permanent divider looks heavy;
-                                    // the sticky bg already sets the column apart during scroll.
-                                    className: "w-px text-right text-muted-foreground md:sticky md:right-0 md:z-10 md:bg-muted", "aria-label": tableTranslate?.("kumiko.list.actions") ?? "Actions" }))] }) }), _jsx(TableBody, { children: tableItems.map((item) => {
-                            if (item.kind === "group") {
-                                return (_jsx(TableRow, { "data-testid": `row-group-${item.key}`, children: _jsx(TableCell, { colSpan: columns.length + (isRowExpandable ? 1 : 0) + (hasTableActions ? 1 : 0), className: "bg-muted/40 p-0", children: renderGroupToggle(item) }) }, `group-${item.key}`));
-                            }
-                            const row = item.row;
-                            const opensOnClick = rowIsLink && !rowClickIsHidden(row);
-                            return (_jsxs(Fragment, { children: [_jsxs(TableRow, { "data-testid": rowTestId(row), "data-tone": rowTone?.(row), onClick: opensOnClick ? () => onRowClick(row) : undefined, className: cn(rowToneClass(rowTone?.(row)), opensOnClick && "cursor-pointer", fillsHeight && "h-10 border-border-row hover:bg-muted"), children: [isRowExpandable && (_jsx(TableCell, { "data-testid": getCellTestId?.(row, "expand") ?? `cell-${row.id}-expand`, className: EXPAND_TOGGLE_CELL_CLASS, children: renderExpandToggle(row) })), columns.map((col, colIndex) => (_jsx(TableCell, { "data-testid": getCellTestId?.(row, col.field) ?? `cell-${row.id}-${col.field}`, "data-highlighted": col.highlighted === true ? "true" : undefined, 
-                                                // Text wraps instead of truncating: nowrap cells keep their
-                                                // full width, so a wide table scrolled sideways and its
-                                                // last column slid under the sticky actions column with
-                                                // nothing visibly cut off. max-w-xs bounds a single column;
-                                                // badges and dates stay nowrap by their own classes.
-                                                className: cn(col.fileDisplay === undefined
-                                                    ? "max-w-xs whitespace-normal break-words"
-                                                    : FIT_CONTENT_CELL_CLASS, colIndex === 0
-                                                    ? "font-medium text-foreground"
-                                                    : "text-foreground-secondary", NUMERIC_COLUMN_TYPES.has(col.type) && "text-right", TABULAR_COLUMN_TYPES.has(col.type) && "tabular-nums", col.highlighted === true && "bg-accent/40"), title: cellTitle(row.values[col.field]), children: _jsx(FirstCellLink, { enabled: colIndex === 0 && opensOnClick && onCellChange === undefined, onOpen: () => onRowClick?.(row), empty: isEmptyCellValue(row.values[col.field]), emptyLabel: rowClickLabel, children: _jsx(DataTableCell, { value: row.values[col.field], row: row.values, field: col.field, type: col.type, renderer: col.renderer, translate: tableTranslate, locale: tableLocale, ...(col.optionLabels !== undefined && {
-                                                            optionLabels: col.optionLabels,
-                                                        }), ...(col.optionTones !== undefined && { optionTones: col.optionTones }), ...(col.grouping !== undefined && { grouping: col.grouping }), ...(col.fileDisplay !== undefined && { fileDisplay: col.fileDisplay }), ...(onCellChange !== undefined && {
-                                                            onChange: (value) => onCellChange(row.id, col.field, value),
-                                                        }), ...cellLinkProp(col, row, !(colIndex === 0 && opensOnClick && onCellChange === undefined)) }) }) }, col.field))), hasTableActions && (_jsx(TableCell, { "data-testid": getCellTestId?.(row, "actions") ?? `cell-${row.id}-actions`, 
-                                                // From md: sticky-right so the actions stay visible on the
-                                                // right edge during horizontal scroll. Below md, actions
-                                                // scroll with the row like any other cell — sticky there
-                                                // would hide the neighboring data column on narrow
-                                                // viewports. bg-background sets the column apart during
-                                                // scroll — no border-l (divider too heavy).
-                                                className: cn("whitespace-nowrap text-right md:sticky md:right-0 md:z-10 md:bg-background", fillsHeight && "md:bg-card"), 
-                                                // Action-cell events must not trigger the row click/activation
-                                                // (typically "Open Detail" — the user wanted the action,
-                                                // not navigation). We stopPropagation for mouse and
-                                                // keyboard so a11y stays consistent.
-                                                onClick: (e) => e.stopPropagation(), onKeyDown: (e) => e.stopPropagation(), children: _jsx(RowActionsCell, { row: row, actions: tableActions, mode: rowActionMode, rowIsLink: rowIsLink }) }))] }), renderExpansion(row, "row", columns.length + (isRowExpandable ? 1 : 0) + (hasTableActions ? 1 : 0))] }, row.id));
-                        }) })] }) }));
-    }
-    // No column headers below the breakpoint, so the click-to-sort affordance
-    // on SortableHeader has nothing to attach to. A single native <select> is
-    // the whole fix — no custom widget, no menu — fed straight from the
-    // columns marked sortable in the ViewModel. Options carry the resolved
-    // {field, dir} directly so onChange can look the pick up by value instead
-    // of parsing/casting the option string back apart.
-    const sortableColumns = columns.filter((col) => col.sortable);
-    const sortOptions = sortableColumns.flatMap((col) => [
-        { value: `${col.field}:asc`, field: col.field, dir: "asc", label: `${col.label} ↑` },
-        { value: `${col.field}:desc`, field: col.field, dir: "desc", label: `${col.label} ↓` },
-    ]);
-    const { image: cardImageColumn, title: cardTitleColumn, status: cardStatusColumn, meta: cardMetaColumns, } = cardColumnRoles(columns);
-    function cardCell(row, col) {
-        // A bare check mark in the subtitle line says nothing without its column.
-        if (showsBareCheckMark(col.type, row.values[col.field], col.renderer))
-            return col.label;
-        return (_jsx(DataTableCell, { value: row.values[col.field], row: row.values, field: col.field, type: col.type, renderer: col.renderer, translate: tableTranslate, locale: tableLocale, ...(col.optionLabels !== undefined && { optionLabels: col.optionLabels }), ...(col.optionTones !== undefined && { optionTones: col.optionTones }), ...(col.grouping !== undefined && { grouping: col.grouping }), ...(col.fileDisplay !== undefined && { fileDisplay: col.fileDisplay, compactFile: true }), ...(onCellChange !== undefined && {
-                onChange: (value) => onCellChange(row.id, col.field, value),
-            }), ...cellLinkProp(col, row, !(rowIsLink && !rowClickIsHidden(row))) }));
-    }
-    function renderCard(row) {
-        const metaColumns = cardMetaColumns.filter((col) => !isEmptyCellValue(row.values[col.field]) &&
-            !isUnlabeledFalse(col.type, row.values[col.field], col.renderer));
-        const showStatus = cardStatusColumn !== undefined && !isEmptyCellValue(row.values[cardStatusColumn.field]);
-        const hasMenu = menuActions !== undefined && menuActions.length > 0;
-        const opensOnClick = rowIsLink && !rowClickIsHidden(row);
-        const body = (_jsxs(_Fragment, { children: [cardImageColumn?.fileDisplay !== undefined && (_jsx("div", { "data-testid": `card-image-${row.id}`, className: "shrink-0", children: _jsx(CardLeadingImage, { value: row.values[cardImageColumn.field], display: cardImageColumn.fileDisplay }) })), _jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-1", children: [_jsxs("div", { className: "flex min-w-0 items-start justify-between gap-2", children: [cardTitleColumn !== undefined && (_jsx("span", { "data-testid": getCellTestId?.(row, cardTitleColumn.field) ??
-                                        `cell-${row.id}-${cardTitleColumn.field}`, className: "min-w-0 break-words text-base font-semibold text-foreground", children: cardCell(row, cardTitleColumn) })), showStatus && (_jsx("span", { "data-testid": getCellTestId?.(row, cardStatusColumn.field) ??
-                                        `cell-${row.id}-${cardStatusColumn.field}`, className: "shrink-0", children: cardCell(row, cardStatusColumn) }))] }), metaColumns.length > 0 && (_jsx("div", { className: "min-w-0 overflow-x-clip", children: _jsx("div", { "data-testid": `card-meta-${row.id}`, className: "-ms-3 flex min-w-0 flex-wrap items-center text-[13px] leading-5 tabular-nums text-foreground-secondary", children: metaColumns.map((col) => (_jsxs("div", { className: "flex h-5 min-w-0 max-w-full items-center", children: [_jsx("span", { "aria-hidden": "true", className: "w-3 shrink-0 text-center", children: "\u00B7" }), _jsx("div", { "data-testid": getCellTestId?.(row, col.field) ?? `cell-${row.id}-${col.field}`, className: "min-w-0 truncate leading-5", onPointerEnter: showFullTextOnHover, children: isBadgeColumn(col) ? (_jsx("span", { className: "inline-flex align-middle", children: cardCell(row, col) })) : (cardCell(row, col)) })] }, col.field))) }) }))] }), opensOnClick && (_jsx(ChevronRight, { className: "size-4 shrink-0 text-muted-foreground", "aria-hidden": "true" }))] }));
-        const rowItem = (_jsxs("li", { "data-testid": rowTestId(row), "data-tone": rowTone?.(row), className: cn("flex min-h-[72px] items-center gap-2 border-b border-border-row py-3", rowToneClass(rowTone?.(row)), isRowExpandable ? "pl-2" : "pl-4", hasMenu ? "pr-2" : "pr-4"), ...(opensOnClick && { onClick: () => onRowClick(row) }), children: [renderExpandToggle(row), opensOnClick ? (_jsx("button", { type: "button", className: "flex min-w-0 flex-1 cursor-pointer items-center gap-2 bg-transparent p-0 text-left", onKeyDown: (e) => {
-                        if (e.key !== "Enter")
-                            return;
-                        e.preventDefault();
-                        e.stopPropagation();
-                        onRowClick(row);
-                    }, children: body })) : (body), hasMenu && (_jsx("div", { onClick: (e) => e.stopPropagation(), onKeyDown: (e) => e.stopPropagation(), children: _jsx(RowActionsCell, { row: row, actions: menuActions, mode: rowActionMode, rowIsLink: rowIsLink, compact: true }) }))] }, row.id));
-        if (!isRowExpandable)
-            return rowItem;
-        // The expansion is a sibling <li>, outside the row's click target, so
-        // clicks in the sub-area never navigate the parent row.
-        return (_jsxs(Fragment, { children: [rowItem, renderExpansion(row, "item", 0)] }, row.id));
-    }
-    function cardsInner() {
-        if (isEmpty)
-            return emptyBlock;
-        const sortLabel = sort !== undefined && sort !== null
-            ? (tableTranslate?.("kumiko.list.sort.by", {
-                column: columns.find((col) => col.field === sort.field)?.label ?? sort.field,
-            }) ?? `Sorted by ${sort.field}`)
-            : (tableTranslate?.("kumiko.list.sort.unsorted") ?? "Unsorted");
-        const SortArrow = sort?.dir === "desc" ? ArrowDown : ArrowUp;
-        // URL state can carry a sort on a column that is not sortable; without an
-        // option for it the select would claim "Unsorted" while the list is sorted.
-        const currentSortValue = sort !== undefined && sort !== null ? `${sort.field}:${sort.dir}` : "";
-        const currentSortIsUnlisted = sort !== undefined && sort !== null && !sortOptions.some((o) => o.value === currentSortValue);
-        return (_jsx("div", { "data-testid": testId, className: "contents", children: _jsxs("div", { "data-testid": testId !== undefined ? `${testId}-cards` : "render-list-cards", className: "flex flex-col", children: [onSortChange !== undefined && sortableColumns.length > 0 && (_jsxs("div", { className: "relative flex h-9 items-center gap-1.5 px-4 text-[13px] text-foreground-secondary", children: [_jsx("span", { "aria-hidden": "true", children: sortLabel }), sort !== undefined && sort !== null && (_jsx(SortArrow, { className: "size-3.5", "aria-hidden": "true" })), _jsxs("select", { "aria-label": tableTranslate?.("kumiko.list.sort.label") ?? "Sort", "data-testid": testId !== undefined ? `${testId}-sort` : "render-list-sort", value: currentSortValue, onChange: (e) => {
-                                    const raw = e.target.value;
-                                    if (raw === "") {
-                                        onSortChange(null);
-                                        return;
-                                    }
-                                    const picked = sortOptions.find((o) => o.value === raw);
-                                    if (picked === undefined)
-                                        return;
-                                    onSortChange({ field: picked.field, dir: picked.dir });
-                                }, className: "absolute inset-0 size-full cursor-pointer opacity-0", children: [_jsx("option", { value: "", children: tableTranslate?.("kumiko.list.sort.unsorted") ?? "Unsorted" }), currentSortIsUnlisted && (_jsx("option", { value: currentSortValue, children: `${columns.find((col) => col.field === sort.field)?.label ?? sort.field} ${sort.dir === "desc" ? "↓" : "↑"}` })), sortOptions.map((o) => (_jsx("option", { value: o.value, children: o.label }, o.value)))] })] })), _jsx("ul", { className: "m-0 list-none border-t border-border-row p-0", children: tableItems.map((item) => item.kind === "group" ? (_jsx("li", { "data-testid": `row-group-${item.key}`, className: "border-b border-border-row bg-muted/40", children: renderGroupToggle(item) }, `group-${item.key}`)) : (renderCard(item.row))) })] }) }));
-    }
-    const tableContent = isNarrow ? cardsInner() : tableInner();
-    // The pager is ALWAYS rendered below the table (even with rows=[]) so the
-    // user can page back on a filter hit of zero without losing the list.
-    // Except total === 0: then there is nothing to paginate. Incompatible with
-    // infinite scroll: the caller sets either pager OR onReachEnd.
-    const pagerElement = pager !== undefined && pager.total > 0 ? (_jsx(Pager, { page: pager.page, limit: pager.limit, total: pager.total, onPageChange: pager.onPageChange, ...(pager.pageSizeOptions !== undefined && { pageSizeOptions: pager.pageSizeOptions }), ...(pager.onPageSizeChange !== undefined && { onPageSizeChange: pager.onPageSizeChange }), ...(itemNoun !== undefined && { itemNoun }), testId: testId !== undefined ? `${testId}-pager` : "render-list-pager", pinned: fillsHeight })) : undefined;
-    const sentinelElement = pagerElement === undefined && onReachEnd !== undefined ? (_jsx(InfiniteSentinel, { onReachEnd: onReachEnd, loadingMore: loadingMore === true, hasMore: hasMore !== false, rowsCount: rows.length, testId: testId !== undefined ? `${testId}-sentinel` : "render-list-sentinel" })) : undefined;
-    // With scrollBody the footer (pager, else the entry count) sits OUTSIDE the
-    // scroll surface so it stays put at any row count; the infinite sentinel
-    // stays INSIDE, or it would never intersect the scrollport.
-    const content = fillsHeight ? (_jsxs(_Fragment, { children: [_jsxs("div", { "data-testid": testId !== undefined ? `${testId}-scroll` : "render-list-scroll", className: "min-h-0 flex-1 overflow-auto border-t border-border bg-card", children: [tableContent, sentinelElement] }), pagerElement ?? (_jsx(DataTableFooter, { count: rows.length, ...(itemNoun !== undefined && { itemNoun }), testId: testId !== undefined ? `${testId}-footer` : "render-list-footer" }))] })) : (_jsxs(_Fragment, { children: [tableContent, pagerElement, sentinelElement] }));
-    const hasFacets = filterFacets !== undefined && filterFacets.length > 0 && onFilterChange !== undefined;
-    const hasDateRangeFacets = dateRangeFacets !== undefined && dateRangeFacets.length > 0 && onDateRangeChange !== undefined;
-    const hasActiveFilters = filterValues !== undefined && Object.values(filterValues).some((v) => v.length > 0);
-    const facetCluster = hasFacets || hasDateRangeFacets ? (_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [hasFacets &&
-                filterFacets.map((facet) => (_jsx(FacetFilter, { facet: facet, selected: filterValues?.[facet.field] ?? [], onChange: onFilterChange, dense: fillsHeight }, facet.field))), hasDateRangeFacets &&
-                dateRangeFacets.map((facet) => (_jsx(DateRangeFacetFilter, { facet: facet, onChange: onDateRangeChange }, facet.field))), hasActiveFilters && onFilterReset !== undefined && (_jsxs(UiButton, { variant: "ghost", size: "sm", className: "h-9 px-2", onClick: onFilterReset, "data-testid": "facet-reset", children: [tableTranslate?.("kumiko.list.filter.reset") ?? "Reset", _jsx(X, {})] }))] })) : undefined;
-    const collapsesFacetsBehindButton = isNarrow && fillsHeight && facetCluster !== undefined;
-    const hasToolbar = toolbarStart !== undefined || toolbarEnd !== undefined || facetCluster !== undefined;
+export function DefaultDataTable(props) {
+    const model = useDataTableState(props);
+    const facetCluster = buildModelFacetCluster(model);
+    const hasToolbar = hasToolbarContent(model, facetCluster);
     // dashboard-01 pattern: the toolbar (search + facets + "+ New") sits ABOVE
     // the table in the same padding block; no separate bg bar, no screen title
-    // (that lives in the shell's breadcrumb).
-    return (_jsxs("div", { className: cn("flex flex-col w-full", 
-        // scrollBody: the wrapper fills its container so the footer sits at the
-        // same spot at 3 and 300 rows; the 24px insets live in toolbar, cells
-        // and footer, so no outer padding.
-        fillsHeight
-            ? "h-full min-h-0"
-            : cn("gap-4", screenPadding === true
-                ? screenPaddingClassName
-                : screenPadding === false
-                    ? undefined
-                    : "p-6")), children: [hasToolbar && (_jsxs("div", { "data-testid": testId !== undefined ? `${testId}-toolbar` : "render-list-toolbar", className: cn("flex flex-wrap items-center", UNIFORM_BAR_CONTROLS_CLASSES, fillsHeight
-                    ? isNarrow
-                        ? "shrink-0 gap-2 p-3"
-                        : "min-h-13 shrink-0 gap-2 px-6 py-2 md:py-0"
-                    : "gap-3"), children: [toolbarStart !== undefined && (_jsxs("div", { className: cn(fillsHeight
-                            ? "relative w-full md:w-[300px] max-md:flex-1 [&_input]:border-border-strong [&_input]:pl-8 [&_input]:max-md:h-11"
-                            : "flex-1 min-w-48 max-w-sm"), children: [fillsHeight && (_jsx(Search, { className: "pointer-events-none absolute left-2.5 top-1/2 z-10 size-4 -translate-y-1/2 text-muted-foreground", "aria-hidden": "true" })), toolbarStart] })), collapsesFacetsBehindButton ? (_jsxs(_Fragment, { children: [_jsx(UiButton, { type: "button", variant: "outline", size: "icon", className: "size-11", "aria-label": tableTranslate?.("kumiko.list.filter.toggle") ?? "Filter", "aria-expanded": facetsOpenNarrow, "data-testid": testId !== undefined ? `${testId}-filter-toggle` : "filter-toggle", onClick: () => setFacetsOpenNarrow((open) => !open), children: _jsx(SlidersHorizontal, { className: "size-4", "aria-hidden": "true" }) }), facetsOpenNarrow && _jsx("div", { className: "w-full", children: facetCluster })] })) : (facetCluster), toolbarEnd !== undefined && (_jsx("div", { className: "flex flex-wrap items-center gap-2 ml-auto", children: toolbarEnd }))] })), toolbarDescription !== undefined && (_jsx("p", { "data-testid": testId !== undefined ? `${testId}-description` : "render-list-description", className: cn("m-0 pb-2 text-sm text-muted-foreground", fillsHeight && (isNarrow ? "px-3" : "px-6"), fillsHeight && !hasToolbar && "pt-4"), children: toolbarDescription })), content] }));
+    // (that lives in the shell's breadcrumb). The toolbar is NOT sticky: lists
+    // typically scroll with the page container, not internally. Sticky would
+    // compete with the topbar.
+    return (_jsxs("div", { className: wrapperClassName(model), children: [hasToolbar && renderToolbar(model, facetCluster), renderToolbarDescription(model, hasToolbar), renderTableContent(model)] }));
 }

package/dist/web/primitives/file-value-list.d.ts

@@ -1,3 +1,3 @@
 import { type ReactNode } from "react";
 import { type FileValueListProps } from "../../index.ts";
-export declare function FileValueList({ fileIds, testId }: FileValueListProps): ReactNode;
+export declare function FileValueList({ fileIds, previewOpenByDefault, testId, }: FileValueListProps): ReactNode;

package/dist/web/primitives/file-value-list.js

@@ -6,17 +6,17 @@ import { Button } from "../ui/button.js";
 import { PdfPreview } from "../widgets/pdf-preview.js";
 import { fileOriginalUrl, useFileMeta } from "./file-thumbnail.js";
 const PDF_MIME_TYPE = "application/pdf";
-function FileValueRow({ fileId, testId, }) {
+function FileValueRow({ fileId, previewOpenInitially, testId, }) {
     const t = useTranslation();
     const meta = useFileMeta(fileId);
-    const [previewOpen, setPreviewOpen] = useState(false);
+    const [previewOpen, setPreviewOpen] = useState(previewOpenInitially);
     if (!isUuid(fileId))
         return _jsx("span", { className: "text-sm", children: fileId });
     const downloadUrl = fileOriginalUrl(fileId);
-    return (_jsxs("li", { className: "flex flex-col gap-2", "data-testid": testId, children: [_jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [_jsx("span", { className: "text-sm", children: meta?.fileName ?? fileId.slice(0, 8) }), _jsx("a", { href: downloadUrl, download: meta?.fileName ?? "", className: "text-primary text-sm underline underline-offset-2", ...(testId !== undefined && { "data-testid": `${testId}-download` }), children: t("kumiko.field.file-list.download") }), meta?.mimeType === PDF_MIME_TYPE && (_jsx(Button, { type: "button", variant: "link", size: "sm", "aria-expanded": previewOpen, onClick: () => setPreviewOpen((open) => !open), ...(testId !== undefined && { "data-testid": `${testId}-preview-toggle` }), children: t(previewOpen ? "kumiko.field.file-list.hidePreview" : "kumiko.field.file-list.preview") }))] }), previewOpen && (_jsx(PdfPreview, { source: { url: downloadUrl }, testId: `file-preview-${fileId}` }))] }));
+    return (_jsxs("li", { className: "flex flex-col gap-2", "data-testid": testId, children: [_jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [_jsx("span", { className: "text-sm", children: meta?.fileName ?? fileId.slice(0, 8) }), _jsx("a", { href: downloadUrl, download: meta?.fileName ?? "", className: "text-primary text-sm underline underline-offset-2", ...(testId !== undefined && { "data-testid": `${testId}-download` }), children: t("kumiko.field.file-list.download") }), meta?.mimeType === PDF_MIME_TYPE && (_jsx(Button, { type: "button", variant: "link", size: "sm", "aria-expanded": previewOpen, onClick: () => setPreviewOpen((open) => !open), ...(testId !== undefined && { "data-testid": `${testId}-preview-toggle` }), children: t(previewOpen ? "kumiko.field.file-list.hidePreview" : "kumiko.field.file-list.preview") }))] }), previewOpen && meta?.mimeType === PDF_MIME_TYPE && (_jsx(PdfPreview, { source: { url: downloadUrl }, testId: `file-preview-${fileId}` }))] }));
 }
-export function FileValueList({ fileIds, testId }) {
+export function FileValueList({ fileIds, previewOpenByDefault = false, testId, }) {
     if (fileIds.length === 0)
         return null;
-    return (_jsx("ul", { className: "m-0 flex list-none flex-col gap-3 p-0", "data-testid": testId, children: fileIds.map((fileId) => (_jsx(FileValueRow, { fileId: fileId, ...(testId !== undefined && { testId: `${testId}-${fileId}` }) }, fileId))) }));
+    return (_jsx("ul", { className: "m-0 flex list-none flex-col gap-3 p-0", "data-testid": testId, children: fileIds.map((fileId, index) => (_jsx(FileValueRow, { fileId: fileId, previewOpenInitially: previewOpenByDefault && index === fileIds.length - 1, ...(testId !== undefined && { testId: `${testId}-${fileId}` }) }, fileId))) }));
 }

package/dist/web/primitives/form-footer-parts.d.ts

@@ -0,0 +1,25 @@
+import type { CSSProperties, ReactNode } from "react";
+import type { useTranslation } from "../../index.ts";
+type Translate = ReturnType<typeof useTranslation>;
+export type FormFooterModel = {
+    readonly t: Translate;
+    readonly testId: string | undefined;
+    readonly chromeless: boolean;
+    readonly stickyActions: boolean | undefined;
+    readonly fillHeight: boolean | undefined;
+    readonly unsavedCount: number | undefined;
+    readonly railed: boolean;
+    readonly pinned: boolean;
+    readonly secondaryActions: ReactNode;
+    readonly renderedSecondary: ReactNode;
+    readonly renderedActions: ReactNode;
+    readonly hasNonPrimaryOverflow: boolean;
+    readonly fixedFooterStyle: CSSProperties | undefined;
+};
+export declare function unsavedStatusText(t: Translate, unsavedCount: number): string;
+export declare function renderNarrowPinnedFooter(model: Pick<FormFooterModel, "t" | "testId" | "unsavedCount">, nodes: readonly ReactNode[], keyboardInset: number): ReactNode;
+export declare function footerRowClassName(model: FormFooterModel): string;
+export declare function renderUnsavedStatus(model: FormFooterModel, unsavedCount: number): ReactNode;
+export declare function renderSecondaryActionsGroup(model: FormFooterModel): ReactNode;
+export declare function renderPrimaryActionsGroup(model: FormFooterModel): ReactNode;
+export {};

package/dist/web/primitives/form-footer-parts.js

@@ -0,0 +1,55 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "../lib/cn.js";
+import { cardFooterBorder } from "./card-styles.js";
+import { NarrowPinnedFooter } from "./narrow-pinned-footer.js";
+import { STICKY_FOOTER_SAFE_AREA_CLASS } from "./sticky-action-bar.js";
+export function unsavedStatusText(t, unsavedCount) {
+    if (unsavedCount === 0)
+        return t("kumiko.form.noUnsavedChanges");
+    if (unsavedCount === 1)
+        return t("kumiko.form.unsaved.one");
+    return t("kumiko.form.unsaved.other", { count: unsavedCount });
+}
+export function renderNarrowPinnedFooter(model, nodes, keyboardInset) {
+    const { t, testId, unsavedCount } = model;
+    return (_jsx(NarrowPinnedFooter, { nodes: nodes, overflowLabel: unsavedCount !== undefined && unsavedCount > 0
+            ? `${t("kumiko.list.row-actions.more")}, ${unsavedStatusText(t, unsavedCount)}`
+            : t("kumiko.list.row-actions.more"), unsavedCount: unsavedCount, unsavedStatus: unsavedCount !== undefined && unsavedCount > 0
+            ? unsavedStatusText(t, unsavedCount)
+            : undefined, testId: testId, keyboardInset: keyboardInset }));
+}
+export function footerRowClassName(model) {
+    const { pinned, chromeless, fillHeight, railed } = model;
+    return cn(pinned
+        ? cn("flex h-14 shrink-0 items-center justify-end gap-2 border-t border-border bg-card px-6", !railed && "md:pl-10")
+        : "flex flex-col-reverse gap-3 py-3 sm:flex-row sm:items-center sm:justify-between sm:py-4", !pinned && !chromeless && "px-[var(--card-padding)]", !pinned && !chromeless && cardFooterBorder, !pinned && fillHeight === true && "shrink-0");
+}
+export function renderUnsavedStatus(model, unsavedCount) {
+    const { t, testId, pinned } = model;
+    return (_jsxs("div", { "data-testid": testId !== undefined ? `${testId}-unsaved` : undefined, className: cn("mr-auto flex min-w-0 items-center gap-2 text-[13px]", 
+        // Only the stacked (flex-col-reverse) footer moves the status above the
+        // actions; the pinned single-row footer keeps it on the left.
+        !pinned && "max-sm:order-last", unsavedCount > 0 ? "text-foreground-secondary" : "text-muted-foreground"), children: [unsavedCount > 0 && (_jsx("span", { className: "size-1.5 shrink-0 rounded-full bg-status-active", "aria-hidden": "true" })), _jsx("span", { className: "truncate", children: unsavedStatusText(t, unsavedCount) })] }));
+}
+export function renderSecondaryActionsGroup(model) {
+    const { testId, pinned, hasNonPrimaryOverflow, renderedSecondary } = model;
+    return (_jsx("div", { "data-testid": testId !== undefined ? `${testId}-actions-secondary` : undefined, className: cn(
+        // min-h-11: link-variant buttons (Copy link) are h-auto and would fall
+        // below the 24px touch-target minimum on narrow viewports.
+        "flex flex-wrap items-center gap-2 max-sm:[&_button]:min-h-11 max-sm:[&_button]:px-2 max-sm:[&_button]:text-xs", pinned && hasNonPrimaryOverflow && "mr-auto"), children: renderedSecondary }));
+}
+export function renderPrimaryActionsGroup(model) {
+    const { testId, pinned, stickyActions, fixedFooterStyle, renderedActions } = model;
+    return (_jsx("div", { "data-testid": testId !== undefined ? `${testId}-actions` : undefined, style: fixedFooterStyle, className: cn("flex items-center gap-2", pinned
+            ? "shrink-0 max-md:[&>button]:min-h-11"
+            : "flex-wrap max-sm:w-full max-sm:[&>button]:flex-1 max-sm:[&>button]:min-h-11 sm:ml-auto", 
+        // Below sm (640px): pin only the primary action to the viewport
+        // bottom instead of normal flow, so a virtual keyboard shrinking
+        // the viewport can't push it out of reach. `fixed`
+        // escapes the card's `overflow-hidden` (only transform/filter/
+        // contain ancestors trap it, confirmed against
+        // AppLayout/SidebarInset — neither sets those).
+        stickyActions === true &&
+            !pinned &&
+            cn("max-sm:fixed max-sm:inset-x-0 max-sm:bottom-0 max-sm:z-20 max-sm:bg-background max-sm:p-4 max-sm:shadow-[0_-4px_12px_-4px_rgb(0_0_0_/_0.15)]", STICKY_FOOTER_SAFE_AREA_CLASS)), children: renderedActions }));
+}

package/dist/web/primitives/form.js

@@ -2,13 +2,13 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { Children, Fragment, isValidElement, useContext, useEffect, useRef, useState, } from "react";
 import { STICKY_PRIMARY_ACTION_PROP, useTranslation, } from "../../index.js";
 import { cn } from "../lib/cn.js";
+import { footerRowClassName, renderNarrowPinnedFooter, renderPrimaryActionsGroup, renderSecondaryActionsGroup, renderUnsavedStatus, } from "./form-footer-parts.js";
 import { screenPaddingClassName, screenWidthClassName } from "./layout.js";
-import { NarrowPinnedFooter } from "./narrow-pinned-footer.js";
-import { STICKY_FOOTER_SAFE_AREA_CLASS, STICKY_FOOTER_SPACER_CLASS } from "./sticky-action-bar.js";
+import { STICKY_FOOTER_SPACER_CLASS } from "./sticky-action-bar.js";
 import { useKeyboardInset } from "./use-keyboard-inset.js";
 import { useIsBelowSmViewport } from "./use-narrow-viewport.js";
 import "../react-css-custom-properties.js";
-import { cardFooterBorder, cardHeaderBorder } from "./card-styles.js";
+import { cardHeaderBorder } from "./card-styles.js";
 import { InsideFormContext, ScreenFormContext, ScreenWidthContext } from "./contexts.js";
 // Extension sections that render their own <form> via BareFormProvider
 // (legacy custom-form pattern, e.g. ChangeEmailSection) land
@@ -138,21 +138,7 @@ function flattenActionNodes(node) {
     }
     return Children.toArray(node);
 }
-function unsavedStatusText(t, unsavedCount) {
-    if (unsavedCount === 0)
-        return t("kumiko.form.noUnsavedChanges");
-    if (unsavedCount === 1)
-        return t("kumiko.form.unsaved.one");
-    return t("kumiko.form.unsaved.other", { count: unsavedCount });
-}
-// Footer wrapper for DefaultForm's card and chromeless layouts alike — only
-// the card-derived horizontal padding/border differs between them.
-export function FormFooter({ actions, secondaryActions, testId, chromeless, stickyActions, fillHeight, unsavedCount, railed = false, }) {
-    const t = useTranslation();
-    const isBelowSm = useIsBelowSmViewport();
-    const keyboardInset = useKeyboardInset();
-    if (actions === undefined && secondaryActions === undefined)
-        return null;
+function splitStickyActions(stickyActions, actions, secondaryActions) {
     // Only split when sticky: the non-sticky (regular, non-wizard) footer must
     // reproduce the previous DOM exactly (form-action-bar.test.tsx pins
     // `-actions`/`-actions-secondary` content 1:1 to the `actions`/
@@ -170,6 +156,17 @@ export function FormFooter({ actions, secondaryActions, testId, chromeless, stic
     const renderedActions = stickyActions === true ? (hasPrimaryAction ? primaryActionNodes : actions) : actions;
     const hasNonPrimaryOverflow = nonPrimaryActionNodes !== undefined && nonPrimaryActionNodes.length > 0;
     const renderedSecondary = stickyActions === true && hasPrimaryAction ? (_jsxs(_Fragment, { children: [secondaryActions, nonPrimaryActionNodes] })) : (secondaryActions);
+    return { renderedActions, renderedSecondary, hasNonPrimaryOverflow };
+}
+// Footer wrapper for DefaultForm's card and chromeless layouts alike — only
+// the card-derived horizontal padding/border differs between them.
+export function FormFooter({ actions, secondaryActions, testId, chromeless, stickyActions, fillHeight, unsavedCount, railed = false, }) {
+    const t = useTranslation();
+    const isBelowSm = useIsBelowSmViewport();
+    const keyboardInset = useKeyboardInset();
+    if (actions === undefined && secondaryActions === undefined)
+        return null;
+    const { renderedActions, renderedSecondary, hasNonPrimaryOverflow } = splitStickyActions(stickyActions, actions, secondaryActions);
     const pinned = isPinnedFooter(stickyActions, fillHeight);
     const fixedFooterStyle = stickyActions === true && !pinned && isBelowSm && keyboardInset > 0
         ? { bottom: keyboardInset }
@@ -177,32 +174,25 @@ export function FormFooter({ actions, secondaryActions, testId, chromeless, stic
     // Below sm the pinned footer swaps to NarrowPinnedFooter; the subtree remounts, so a
     // confirm dialog owned by an action button closes on a breakpoint change (rotate, resize).
     if (pinned && isBelowSm) {
-        return (_jsx(NarrowPinnedFooter, { nodes: [...flattenActionNodes(secondaryActions), ...flattenActionNodes(actions)], overflowLabel: unsavedCount !== undefined && unsavedCount > 0
-                ? `${t("kumiko.list.row-actions.more")}, ${unsavedStatusText(t, unsavedCount)}`
-                : t("kumiko.list.row-actions.more"), unsavedCount: unsavedCount, unsavedStatus: unsavedCount !== undefined && unsavedCount > 0
-                ? unsavedStatusText(t, unsavedCount)
-                : undefined, testId: testId, keyboardInset: keyboardInset }));
+        return renderNarrowPinnedFooter({ t, testId, unsavedCount }, [...flattenActionNodes(secondaryActions), ...flattenActionNodes(actions)], keyboardInset);
     }
-    return (_jsxs("div", { className: cn(pinned
-            ? cn("flex h-14 shrink-0 items-center justify-end gap-2 border-t border-border bg-card px-6", !railed && "md:pl-10")
-            : "flex flex-col-reverse gap-3 py-3 sm:flex-row sm:items-center sm:justify-between sm:py-4", !pinned && !chromeless && "px-[var(--card-padding)]", !pinned && !chromeless && cardFooterBorder, !pinned && fillHeight === true && "shrink-0"), children: [unsavedCount !== undefined && (_jsxs("div", { "data-testid": testId !== undefined ? `${testId}-unsaved` : undefined, className: cn("mr-auto flex min-w-0 items-center gap-2 text-[13px]", 
-                // Only the stacked (flex-col-reverse) footer moves the status above the
-                // actions; the pinned single-row footer keeps it on the left.
-                !pinned && "max-sm:order-last", unsavedCount > 0 ? "text-foreground-secondary" : "text-muted-foreground"), children: [unsavedCount > 0 && (_jsx("span", { className: "size-1.5 shrink-0 rounded-full bg-status-active", "aria-hidden": "true" })), _jsx("span", { className: "truncate", children: unsavedStatusText(t, unsavedCount) })] })), (secondaryActions !== undefined || hasNonPrimaryOverflow) && (_jsx("div", { "data-testid": testId !== undefined ? `${testId}-actions-secondary` : undefined, className: cn(
-                // min-h-11: link-variant buttons (Copy link) are h-auto and would fall
-                // below the 24px touch-target minimum on narrow viewports.
-                "flex flex-wrap items-center gap-2 max-sm:[&_button]:min-h-11 max-sm:[&_button]:px-2 max-sm:[&_button]:text-xs", pinned && hasNonPrimaryOverflow && "mr-auto"), children: renderedSecondary })), renderedActions !== undefined && (_jsx("div", { "data-testid": testId !== undefined ? `${testId}-actions` : undefined, style: fixedFooterStyle, className: cn("flex items-center gap-2", pinned
-                    ? "shrink-0 max-md:[&>button]:min-h-11"
-                    : "flex-wrap max-sm:w-full max-sm:[&>button]:flex-1 max-sm:[&>button]:min-h-11 sm:ml-auto", 
-                // Below sm (640px): pin only the primary action to the viewport
-                // bottom instead of normal flow, so a virtual keyboard shrinking
-                // the viewport can't push it out of reach. `fixed`
-                // escapes the card's `overflow-hidden` (only transform/filter/
-                // contain ancestors trap it, confirmed against
-                // AppLayout/SidebarInset — neither sets those).
-                stickyActions === true &&
-                    !pinned &&
-                    cn("max-sm:fixed max-sm:inset-x-0 max-sm:bottom-0 max-sm:z-20 max-sm:bg-background max-sm:p-4 max-sm:shadow-[0_-4px_12px_-4px_rgb(0_0_0_/_0.15)]", STICKY_FOOTER_SAFE_AREA_CLASS)), children: renderedActions }))] }));
+    const model = {
+        t,
+        testId,
+        chromeless,
+        stickyActions,
+        fillHeight,
+        unsavedCount,
+        railed,
+        pinned,
+        secondaryActions,
+        renderedSecondary,
+        renderedActions,
+        hasNonPrimaryOverflow,
+        fixedFooterStyle,
+    };
+    return (_jsxs("div", { className: footerRowClassName(model), children: [unsavedCount !== undefined && renderUnsavedStatus(model, unsavedCount), (secondaryActions !== undefined || hasNonPrimaryOverflow) &&
+                renderSecondaryActionsGroup(model), renderedActions !== undefined && renderPrimaryActionsGroup(model)] }));
 }
 export const SECTION_NAV_MIN_ITEMS = 3;
 // "On this page" navigation next to a screen form. The active entry follows

package/dist/web/primitives/input-choice-kinds.d.ts

@@ -0,0 +1,4 @@
+import type { KindRenderer } from "./input-shared.ts";
+export declare const renderBooleanKind: KindRenderer<"boolean">;
+export declare const renderSelectKind: KindRenderer<"select">;
+export declare const renderComboboxKind: KindRenderer<"combobox">;