gridsmith-ui 0.21.0 → 0.23.0

package/dist/index.d.ts

@@ -2,8 +2,10 @@ import * as react from 'react';
 import { ButtonHTMLAttributes, ReactNode, InputHTMLAttributes, LabelHTMLAttributes, TextareaHTMLAttributes, Ref, ReactElement, CSSProperties, HTMLAttributes, RefObject, KeyboardEvent, AnchorHTMLAttributes, ComponentType } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { IconName } from './icons.js';
-import { C as ColumnKind, B as BreakpointKey } from './table-utils-GounRE6s.js';
-export { a as BreakpointWidthProvider, u as useBreakpoint } from './table-utils-GounRE6s.js';
+import { C as ColumnKind, B as BreakpointKey } from './table-utils-BkjNEWts.js';
+export { a as BreakpointWidthProvider, u as useBreakpoint } from './table-utils-BkjNEWts.js';
+import { P as Pager, A as AppShellPreferences } from './use-pagination-DiJo0aW5.js';
+export { a as PaginationOptions, b as PreferencesContext, R as ResolvedPreferences, p as preferenceActionKey, u as usePagination, c as usePreferences } from './use-pagination-DiJo0aW5.js';
 
 type ButtonVariant = "default" | "secondary" | "tertiary" | "outline" | "ghost" | "destructive" | "success" | "warning" | "link";
 type ButtonSize = "xs" | "sm" | "md" | "lg" | "icon-xs" | "icon-sm" | "icon" | "icon-lg";
@@ -685,13 +687,20 @@ interface CardProps extends HTMLAttributes<HTMLDivElement> {
 }
 declare const Card: react.ForwardRefExoticComponent<CardProps & react.RefAttributes<HTMLDivElement>>;
 interface CardHeaderProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * The header's badges and buttons, in one slot. A badge sits beside the title (D1a); a button, like the ⋯, at the
+     * row's end. A header holds a status badge and at most one action or the ⋯ menu (data_display#35).
+     */
     actions?: ReactNode;
     icon?: IconName;
     menuItems?: DropdownMenuEntry[];
 }
 declare const CardHeader: react.ForwardRefExoticComponent<CardHeaderProps & react.RefAttributes<HTMLDivElement>>;
 interface CardTitleProps extends HTMLAttributes<HTMLHeadingElement> {
-    /** Max lines before clamping (with the full title on hover). Default 2, like CardDescription; 1 truncates on one line; 0 = no limit. */
+    /**
+     * Max lines before clamping (with the full title on hover). Default 2, like CardDescription, and 1 in a CardHeader's
+     * row, where the title truncates beside its badge and the ⋯ (Sprint 25.13 A1); 0 = no limit.
+     */
     lines?: number;
 }
 declare const CardTitle: react.ForwardRefExoticComponent<CardTitleProps & react.RefAttributes<HTMLHeadingElement>>;
@@ -734,7 +743,13 @@ interface DataListProps {
 declare function DataList({ items, columns, className }: DataListProps): react_jsx_runtime.JSX.Element;
 
 interface CardGridProps extends HTMLAttributes<HTMLDivElement> {
-    /** The narrowest a card may be, as a CSS length. The grid takes as many columns as fit at it. Default "14rem". */
+    /**
+     * The narrowest a card may be, as a CSS length; the grid takes as many columns as fit at it. By default a collection
+     * reads it from its cards' headers (Sprint 25.13 A2): about 20rem when a header is given `actions` (a badge or a
+     * button besides the ⋯), so a name shows beside them, and 14rem otherwise (a file grid keeps its smaller cards). A comparison keeps
+     * 14rem whatever its headers hold, so its plans stay side by side (D29). Pass one when the cards need their own:
+     * the width at which the longest title you expect still shows beside what its header holds.
+     */
     minWidth?: string;
     /** The most cards in a row, however wide the grid is. Default 4. A comparison (`compare`) takes all its cards instead. */
     maxColumns?: number;
@@ -751,6 +766,13 @@ interface CardGridProps extends HTMLAttributes<HTMLDivElement> {
      * the gap is this prop, never a `gap-*` class (which would leave the columns measured for another gap).
      */
     gap?: string;
+    /**
+     * A collection whose cards all fit on one row fills it (Sprint 25.13 A32, the owner's R28-61: a short row "looks odd
+     * like a fourth card was supposed to be there"): they share the row equally, and a lone card takes at most half. A
+     * grid of more rows keeps its columns. Default on; pass false for a collection whose count changes (a filter, a
+     * pager's last page), so its cards don't change size as the results change.
+     */
+    fill?: boolean;
     children: ReactNode;
     ref?: Ref<HTMLDivElement>;
 }
@@ -770,7 +792,7 @@ interface CardGridProps extends HTMLAttributes<HTMLDivElement> {
  * share three rows (header, content, footer), so their parts line up; a child that is not a Card fills its three rows
  * without lining anything up.
  */
-declare function CardGrid({ minWidth, maxColumns, compare, gap, className, style, children, ref, ...props }: CardGridProps): react_jsx_runtime.JSX.Element;
+declare function CardGrid({ minWidth, maxColumns, compare, gap, fill, className, style, children, ref, ...props }: CardGridProps): react_jsx_runtime.JSX.Element;
 
 interface DescriptionItem {
     label: string;
@@ -826,11 +848,26 @@ interface AccordionProps {
 }
 declare function Accordion({ items, type, defaultOpen, open: controlledOpen, onOpenChange, className }: AccordionProps): react_jsx_runtime.JSX.Element;
 
+/** A row: a value or an element for each column's key, and any fields of the page's own (an `id`, say). */
+type TableRow = Record<string, string | number | ReactNode>;
 interface Column {
     key: string;
     header: string;
     align?: "left" | "center" | "right";
     sortable?: boolean;
+    /**
+     * What the column sorts by, when its cells don't say (Sprint 25.13 A3): a column of elements (an avatar beside a name,
+     * a badge, a time) gives each row's name, number or date here, `sortValue: (row) => row.actorName`, and a column of
+     * sizes gives bytes. Without it a sortable column sorts by the cell itself, which works for text and numbers; a cell
+     * that is an element can't be compared, and the column warns in development (data_display#1).
+     */
+    sortValue?: (row: TableRow) => string | number | Date | null | undefined;
+    /**
+     * Keep the column in view while the table scrolls sideways (Sprint 25.13 A35): "end" for the row's actions, pinned on
+     * the right; "start" for the row's name, drawn first and pinned beside the selection while it leaves room. Without a
+     * "start" column, the first column is the row's name.
+     */
+    pin?: "start" | "end";
     /** Opt-in text truncation. true = 1 line, or { lines: N } for multi-line clamp before truncating. */
     truncate?: boolean | {
         lines: number;
@@ -851,25 +888,58 @@ type SortDir = "asc" | "desc" | null;
 type TableDensity = "default" | "compact";
 interface TableProps {
     columns: Column[];
-    data: Record<string, string | number | ReactNode>[];
+    /** Every row. With `pager`, the whole list: the table sorts all of it and draws the pager's part (A3). */
+    data: TableRow[];
     className?: string;
     sortable?: boolean;
     sortKey?: string | null;
     sortDir?: SortDir;
     onSortChange?: (key: string | null, dir: SortDir) => void;
     selectable?: boolean;
+    /** The selected rows, as indexes into `data`, which a sort or a new page never changes. */
     selectedRows?: number[];
     onSelectionChange?: (rows: number[]) => void;
     expandable?: boolean;
-    renderExpanded?: (row: Record<string, string | number | ReactNode>, index: number) => ReactNode;
+    /** A row's panel, under it when it's open; `index` is the row's index in `data`. */
+    renderExpanded?: (row: TableRow, index: number) => ReactNode;
+    /**
+     * The field that names a row (default `id`, Sprint 25.13 A46): open rows are kept by it, so a sort, a filter or a
+     * new page never moves them. A row with no such field is named by its index in `data`.
+     */
+    rowKey?: string;
+    /**
+     * The open rows, by the field `rowKey` names (A46), controlled with `onExpandedChange`. A record's address opens its
+     * row, `expandedRows={id ? [id] : []}`: the row is brought into view, and with a pager its page comes up.
+     */
+    expandedRows?: Array<string | number>;
+    /** The rows open at first, when the table keeps its own (A46). */
+    defaultExpandedRows?: Array<string | number>;
+    onExpandedChange?: (rows: Array<string | number>) => void;
     density?: TableDensity;
     stickyHeader?: boolean;
     striped?: boolean;
     loading?: boolean;
     emptyState?: ReactNode;
-    onRowClick?: (row: Record<string, string | number | ReactNode>, index: number) => void;
-    /** Breakpoint at which the table switches to card layout. Defaults to "md" (768px). */
+    /**
+     * A click on a row, or Enter or Space on it: the page decides what opens. Without it an expandable row opens with a
+     * click anywhere on it (P33). A click on a control inside the row stays that control's (A45).
+     */
+    onRowClick?: (row: TableRow, index: number) => void;
+    /** The screen width below which the table shows cards: the project's responsive.tableToCardsBreakpoint, else "md". */
     mobileBreakpoint?: BreakpointKey;
+    /**
+     * The table's own width below which it shows cards (Sprint 25.13 A35), in px: about a phone's by default, so a table
+     * in a pane, a drawer or a dialog stays a table, scrolling sideways, until its space is a phone's. 0 never switches by
+     * width; a narrow screen still does.
+     */
+    cardsBelow?: number;
+    /**
+     * The list's pager (Sprint 25.13 A3), from `usePagination(rows)` over the same rows as `data`: the table sorts every
+     * row, draws the pager's part (a page, or every page loaded so far) and, beneath it, the control in the project's
+     * style. A new sort starts again at page 1. Give TableToolbar the same pager for the count, and draw no <Pagination>
+     * of your own.
+     */
+    pager?: Pager<unknown>;
     /**
      * The table's title inside its frame (Sprint 25.9, A1): a heading in CardTitle's style at CardHeader's inset, in a band
      * above the scroll area that never scrolls sideways, and the `<table>`'s name. Title a table this way or with a
@@ -890,7 +960,7 @@ interface TableProps {
     "aria-label"?: string;
     ref?: Ref<HTMLDivElement>;
 }
-declare function Table({ columns, data, className, sortable, sortKey: controlledSortKey, sortDir: controlledSortDir, onSortChange, selectable, selectedRows, onSelectionChange, expandable, renderExpanded, density, stickyHeader, striped, loading, emptyState, onRowClick, mobileBreakpoint: mobileBreakpointProp, title, description, actions, "aria-label": ariaLabel, ref, }: TableProps): react_jsx_runtime.JSX.Element;
+declare function Table({ columns: columnsProp, data, className, sortable, sortKey: controlledSortKey, sortDir: controlledSortDir, onSortChange, selectable, selectedRows, onSelectionChange, expandable, renderExpanded, rowKey, expandedRows: expandedRowsProp, defaultExpandedRows, onExpandedChange, density, stickyHeader, striped, loading, emptyState, onRowClick, mobileBreakpoint: mobileBreakpointProp, cardsBelow, pager, title, description, actions, "aria-label": ariaLabel, ref, }: TableProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
 
 interface CalendarEvent {
     id: string;
@@ -990,6 +1060,10 @@ interface AvatarGroupItem {
     initials?: string;
     src?: string;
     alt?: string;
+    /**
+     * @deprecated Ignored: a group draws no status (the owner, 30 September 2026: dots on overlapping avatars read as
+     * broken). Show someone's status with a single Avatar.
+     */
     status?: AvatarStatus;
     color?: AvatarColor;
 }
@@ -1007,7 +1081,8 @@ interface AvatarGroupProps {
 /**
  * Overlapping row of avatars with a "+N" counter for the rest. Use for
  * members, assignees, participants — anywhere several people share one
- * slot. Do not hand-roll this with -space-x and ring classes.
+ * slot. Do not hand-roll this with -space-x and ring classes. A group shows
+ * no status; a single Avatar does.
  */
 declare function AvatarGroup({ items, max, size, ring, onOverflowClick, className }: AvatarGroupProps): react_jsx_runtime.JSX.Element;
 
@@ -1161,8 +1236,13 @@ interface TimelineProps {
     minItemWidth?: number;
     className?: string;
     ref?: Ref<HTMLDivElement>;
+    /**
+     * The list's pager (Sprint 25.13 A3), from `usePagination(items)` over the same items: the timeline draws the pager's
+     * part of every item and, beneath it, the control in the project's style. Draw no <Pagination> of your own.
+     */
+    pager?: Pager<unknown>;
 }
-declare function Timeline({ items, orientation, minItemWidth, className, ref }: TimelineProps): react_jsx_runtime.JSX.Element;
+declare function Timeline({ items: allItems, orientation, minItemWidth, className, ref, pager }: TimelineProps): react_jsx_runtime.JSX.Element;
 
 interface CodeBlockProps {
     code: string;
@@ -1475,6 +1555,11 @@ interface StackedListProps {
     flush?: boolean;
     /** @deprecated Sprint 25.4: use variant="articles" (hover="title") — the default variant tints the row. */
     hover?: "tint" | "title";
+    /**
+     * The list's pager (Sprint 25.13 A3), from `usePagination(items)` over the same items: the list draws the pager's
+     * part of every item and, beneath it, the control in the project's style. Draw no <Pagination> of your own.
+     */
+    pager?: Pager<unknown>;
 }
 declare const StackedList: react.ForwardRefExoticComponent<StackedListProps & react.RefAttributes<HTMLUListElement>>;
 
@@ -2238,6 +2323,8 @@ interface PaginationProps {
     /** The Load more button's label (default "Load more"). */
     loadMoreLabel?: string;
     className?: string;
+    /** Set by `usePagination` in `pager.props`: which list the control belongs to (Sprint 25.13 A3). */
+    pagerToken?: object;
 }
 declare function Pagination(props: PaginationProps): react_jsx_runtime.JSX.Element;
 
@@ -2408,6 +2495,11 @@ interface PageHeaderProps {
     onBack?: () => void;
     actions?: ReactNode;
     avatar?: ReactNode;
+    /**
+     * Controls that filter the page (Dropdown, DatePicker, SegmentedControl, Input), in one row at the small size; a text
+     * field takes a search field's width, not a line of its own. On a bold colourful header the row sits on a strip drawn
+     * as the cards are, that hugs its controls, as the tab row does.
+     */
     filters?: ReactNode;
     bannerImage?: string;
     as?: HeadingLevel;
@@ -2529,12 +2621,12 @@ interface NavMenuProps {
     items: NavMenuItem[];
     /** Whether any child route is currently active (highlights the trigger) */
     active?: boolean;
-    /** Matches the parent Navbar type for consistent styling (`default` is the deprecated name for `tint`) */
+    /** The navbar's style; by default the one the Navbar gives its items (`default` is the deprecated name for `tint`) */
     type?: NavbarType;
     onItemClick?: (item: NavMenuItem) => void;
     className?: string;
 }
-declare function NavMenu({ label, items, active, type, onItemClick, className, }: NavMenuProps): react_jsx_runtime.JSX.Element;
+declare function NavMenu({ label, items, active, type: typeProp, onItemClick, className, }: NavMenuProps): react_jsx_runtime.JSX.Element;
 
 /** Mirrors NavbarType. `default` is the deprecated pre-20.8 name for `tint`. */
 type MobileHeaderMenuType = "tint" | "underline" | "minimal" | "pill" | "default";
@@ -2585,6 +2677,7 @@ interface DrawerProps {
     open: boolean;
     onClose: () => void;
     position?: "left" | "right" | "bottom";
+    /** Pass none: the Drawer takes the app's width, which the shell carries (AppShell's drawerWidth, 520 px by default; 400 px outside a shell). For a deliberate wide or narrow drawer only. A non-modal side panel (modal={false}, such as the shell's assistant) keeps the width it is given. */
     width?: string;
     title?: ReactNode;
     children: ReactNode;
@@ -2609,7 +2702,8 @@ interface DrawerProps {
      * Default true. false makes the drawer a persistent, non-modal panel the user works alongside
      * (an assistant, help): no backdrop, no scroll lock, no focus trap — the page stays operable.
      * It closes only on Escape while focus is inside it, its close control, or onClose from the
-     * consumer; an outside click does nothing. At phone width the Sheet is always modal.
+     * consumer; an outside click does nothing. At phone width the sheet it becomes is modal: a backdrop, the focus trap,
+     * the scroll lock and Escape from anywhere, and focus moves in if the window narrows while it is open.
      */
     modal?: boolean;
     /**
@@ -2727,8 +2821,6 @@ interface SheetProps {
     title?: ReactNode;
     children: ReactNode;
     footer?: ReactNode;
-    /** A strip between the content and the footer (the Drawer's unsaved-changes question). */
-    confirm?: ReactNode;
     /**
      * The content has unsaved changes: every close path — Escape, the backdrop, dragging it down, the close control and a
      * FormWrapper's Cancel — asks before discarding them, inside the sheet, as a Drawer and a Dialog do (the review of
@@ -2750,7 +2842,11 @@ interface SheetProps {
     /** id of the element that names the dialog when no title is rendered. */
     labelledBy?: string;
 }
-declare function Sheet({ open, onClose: onCloseProp, title, children, footer, confirm, dirty, onDiscard, snapPoints, container, flush, keepMounted, id, labelledBy }: SheetProps): react.ReactPortal | null;
+/**
+ * A bottom sheet with snap heights. It is the Drawer's phone form, drawn by the same panel (Sprint 25.14 A50), so a
+ * sheet and a drawer share their inset, their drag and their focus handling.
+ */
+declare function Sheet({ open, onClose: onCloseProp, title, children, footer, dirty, onDiscard, snapPoints, container, flush, keepMounted, id, labelledBy }: SheetProps): react_jsx_runtime.JSX.Element;
 
 interface Notification {
     id: string;
@@ -2979,71 +3075,6 @@ interface ScrollAreaProps {
 }
 declare function ScrollArea({ children, className, orientation, maxHeight, maxWidth, }: ScrollAreaProps): react_jsx_runtime.JSX.Element;
 
-type PreferenceValidationTiming = "onBlur" | "onSubmit" | "onChange";
-type PreferenceBreakpoint = "sm" | "md" | "lg";
-type PreferenceEmptyStyle = "illustration-cta" | "text-cta" | "redirect";
-type PreferenceLoadingStyle = "skeleton" | "spinner" | "progress-bar";
-type PreferenceDestructiveMode = "dialog" | "undo";
-/** dataDisplay.paginationStyle — how a long list shows more: page numbers, a Load more button, or loading as the user scrolls. */
-type PreferencePaginationStyle = "pagination" | "load-more" | "infinite-scroll";
-interface AppShellPreferences {
-    /** forms.validationTiming — when a field first shows its error. */
-    validationTiming?: PreferenceValidationTiming;
-    /** forms.actions — where a form's buttons sit and how they align. */
-    formActions?: {
-        align?: "start" | "end";
-        placement?: "auto" | "inline";
-    };
-    /** dataDisplay.itemsPerPage — the page size of a paged or load-more list. */
-    itemsPerPage?: number;
-    /** dataDisplay.paginationStyle — page numbers, a Load more button, or loading on scroll; usePagination and Pagination follow it (round 22). */
-    paginationStyle?: PreferencePaginationStyle;
-    /** responsive.tableToCardsBreakpoint — below this width a Table becomes stacked cards. */
-    tableToCardsBreakpoint?: PreferenceBreakpoint;
-    /** emptyStates.emptyStyle — illustration with an action, text with an action, or redirect to creation. */
-    emptyStyle?: PreferenceEmptyStyle;
-    /** emptyStates.loadingStyle — what a page shows while data loads. */
-    loadingStyle?: PreferenceLoadingStyle;
-    /** destructiveActions.mode — confirm in a dialog, or act now with an Undo toast. */
-    destructiveMode?: PreferenceDestructiveMode;
-    /** destructiveActions.highSeverityActions — always confirm in a dialog, even in undo mode. */
-    highSeverityActions?: string[];
-    /** destructiveActions.typeToConfirmActions — the user types the name before the confirm enables. */
-    typeToConfirmActions?: string[];
-    /** destructiveActions.undoWindowSeconds — how long the Undo toast stays. */
-    undoWindowSeconds?: number;
-}
-declare const PreferencesContext: react.Context<AppShellPreferences | null>;
-/** Every preference in force, the shell's value or the house default — what app code reads. */
-interface ResolvedPreferences {
-    validationTiming: PreferenceValidationTiming;
-    formActions: {
-        align: "start" | "end";
-        placement: "auto" | "inline";
-    };
-    itemsPerPage: number;
-    paginationStyle: PreferencePaginationStyle;
-    tableToCardsBreakpoint: PreferenceBreakpoint;
-    emptyStyle: PreferenceEmptyStyle;
-    loadingStyle: PreferenceLoadingStyle;
-    destructiveMode: PreferenceDestructiveMode;
-    highSeverityActions: string[];
-    typeToConfirmActions: string[];
-    undoWindowSeconds: number;
-}
-/**
- * For app code: every preference in force — the shell's value, else the house default — so a page never writes a
- * fallback of its own. Round 21 (run 58): with every field optional, TypeScript made the builder write
- * `const { itemsPerPage = 20 } = usePreferences()`, a second copy of the preference it then edited by hand when the
- * rule changed. Paged lists use `usePagination`, which reads the page size itself.
- */
-declare function usePreferences(): ResolvedPreferences;
-/**
- * "Remove range" → "remove_range": the key the high-severity and type-to-confirm lists use. The engine's `actionKey`
- * (platform/src/lib/destructive-mode.ts) is the same rule for compliance; a platform test keeps the two identical.
- */
-declare function preferenceActionKey(label: string): string;
-
 interface AppShellContextValue {
     hasSidebar: boolean;
     hasMobileMenu: boolean;
@@ -3102,6 +3133,8 @@ interface AppShellContextValue {
     hasUnsavedChanges: boolean;
     /** Set by useUnsavedChanges; not for pages to call. Returns the release. */
     addUnsavedChanges: () => () => void;
+    /** The width every Drawer in the app takes when it is given none (Sprint 25.14 A24): AppShell's drawerWidth, 520 px by default. */
+    drawerWidth: string;
 }
 /**
  * Focus mode (Sprint 25.7, C1): a task flow the user completes before or outside the app — setup, onboarding,
@@ -3164,6 +3197,11 @@ interface AppShellProps {
     theme?: AppShellTheme;
     /** The customer's UX preferences, passed once by the generated shell so pages and components carry nothing (Sprint 25.6). */
     preferences?: AppShellPreferences;
+    /**
+     * The width of every Drawer in the app that is given none (Sprint 25.14 A24): pages pass no width, so the app's
+     * drawers share one. Default "520px". A Drawer's own width prop still wins, for a deliberate wide or narrow one.
+     */
+    drawerWidth?: string;
     /** The current route's path, so the shell knows which page is home. */
     currentPath?: string;
     /** The home page's path. Default "/". */
@@ -3178,68 +3216,6 @@ interface AppShellProps {
 }
 declare const AppShell: react.ForwardRefExoticComponent<AppShellProps & react.RefAttributes<HTMLDivElement>>;
 
-/**
- * A long list in one hook (round 21; all three list styles since round 22). The page size and the list style are the
- * project's `dataDisplay.itemsPerPage` and `dataDisplay.paginationStyle`, read from the shell, so a mid-build
- * `update_rule` on either reaches every list with no page edited. The page gets what to show, the props for
- * `<Pagination>` — page numbers, a Load more button or loading on scroll, whichever the project's style is — and the
- * numbers the count line needs ("Showing 51–100 of 200 events", or "Showing 40 of 120 members" while a list grows).
- *
- * Run 58 hand-wrote the paging; runs 59 and 60 hand-wrote load-more and scroll loading — an IntersectionObserver, a
- * visible count and a page size copied in as a constant, twice in one app — because the library had no way to.
- *
- *   const pager = usePagination(sortedEvents, { resetOn: [sortKey, sortDir] })
- *   <TableToolbar resultCount={sortedEvents.length} resultNoun={["event", "events"]} pagination={pager} />
- *   <Table columns={columns} data={pager.items.map(toRow)} />
- *   <Pagination {...pager.props} />
- */
-interface Pager<T> {
-    /** The list style this list follows: the project's, unless `style` was passed. */
-    style: PreferencePaginationStyle;
-    /** What to show: the current page's rows, or every row loaded so far on a list that grows. */
-    items: T[];
-    /** The current page, from 1; on a growing list, how many pages are loaded. */
-    page: number;
-    pageSize: number;
-    totalItems: number;
-    totalPages: number;
-    /** The first and last row numbers on screen, from 1 ("Showing 51–100"); [0, 0] for an empty list. */
-    range: [number, number];
-    /** How many rows are on screen. */
-    shown: number;
-    /** Rows left to show: a next page, or more to load. */
-    hasMore: boolean;
-    /** The next page, or the next `pageSize` rows on a growing list. */
-    loadMore: () => void;
-    setPage: (page: number) => void;
-    /** A page-size selector's choice; it wins over the project's page size and starts again at page 1. */
-    setPageSize: (size: number) => void;
-    /** Spread onto <Pagination>: it renders page numbers, a Load more button or the scroll trigger, as `style` says. */
-    props: {
-        currentPage: number;
-        totalPages: number;
-        onPageChange: (page: number) => void;
-        pageSize: number;
-        onPageSizeChange: (size: number) => void;
-        mode: PreferencePaginationStyle;
-        hasMore: boolean;
-        onLoadMore: () => void;
-    };
-}
-interface PaginationOptions {
-    /** A fixed page size for this list, over the project's. Leave it out: the project's page size is the rule. */
-    pageSize?: number;
-    /** Values that start the list again at page 1 when they change — the sort column and direction, a search query. */
-    resetOn?: unknown;
-    /**
-     * A list style for this list only, over the project's. Leave it out: the project's style is the rule. Passing one that
-     * differs is overriding a rule in force — ask the user first, and put `// @gridsmith-override
-     * dataDisplay.paginationStyle: <their reason>` above the call.
-     */
-    style?: PreferencePaginationStyle;
-}
-declare function usePagination<T>(list: readonly T[], options?: PaginationOptions): Pager<T>;
-
 interface DestructiveActionOptions {
     /** The action's key as the preference lists name it ("remove_range"); derived from `title` when omitted. */
     action?: string;
@@ -3434,4 +3410,4 @@ interface UseTextOverflowResult {
  */
 declare function useTextOverflow(options?: UseTextOverflowOptions): UseTextOverflowResult;
 
-export { Accordion, ActionPanel, ActionPanelGroup, AddAnother, type AddAnotherProps, Alert, type AlertPlacement, AppShell, type AppShellContextValue, type AppShellFocus, type AppShellPreferences, type AppShellTheme, AsidePanel, type AsidePanelProps, type AsidePanelSide, Avatar, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, type AvatarStatus, Badge, type BadgePaletteColor, type BadgeSeverity, type BadgeSize, type BadgeVariant, BottomNav, type BottomNavItem, type BreadcrumbItem$1 as BreadcrumbItem, Breadcrumbs, type BreadcrumbsSeparator, type BreadcrumbsSize, type BreadcrumbsVariant, BreakpointKey, BulkActionBar, Button, ButtonSizeContext, Calendar, type CalendarDay, Card, CardContent, CardDescription, CardFooter, CardGrid, type CardGridProps, CardHeader, type CardSelectType, CardTitle, type CardVariant, Carousel, type ChatMessage, type ChatMessageAction, type ChatMessageLayout, ChatMessageList, type ChatMessageSender, type ChatMessageSource, type ChatMessageStatus, ChatPanel, type ChatPanelProps, type ChatPanelStatusTone, Checkbox, CheckboxGroup, CheckboxGroupItem, CodeBlock, Collapsible, ColorPicker, type Column, Combobox, CommandPalette, ContextMenu, type ControlSize, ControlSizeContext, CornerPanel, type CornerPanelEdge, type CornerPanelProps, DEFAULT_DATE_RANGE_PRESETS, DataList, type DateInput, DatePicker, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, type DateRangeWords, type DescriptionItem, DescriptionList, type DescriptionListOrientation, type DescriptionListSize, type DestructiveActionHandle, type DestructiveActionOptions, Dialog, Divider, Dock, Drawer, Dropdown, DropdownMenu, type DropdownMenuDivider, type DropdownMenuEntry, type DropdownMenuItem, EmptyState, EntityCell, Field, type FieldControlProps, type FieldLabel, type FieldProps, FileUpload, type FileUploadItem, type FileUploadRequestOptions, type FileUploadStatus, type FitLabelsOptions, type FittedLabel, FormWrapper, Gantt, type GanttGroup, type GanttItem, type GanttProps, type GanttStatus, type GanttTone, type GridKeyboard, type GridKeyboardOptions, HoverCard, InlineFieldError, Input, Kbd, Label, type LabelBox, Launcher, type LauncherEdge, type LauncherProps, type LauncherVariant, type LauncherWhenOpen, Link, type LinkProps, MentionInput, MobileHeaderMenu, type MobileHeaderMenuItemData, type MobileHeaderMenuType, NavItem, type NavItemProps, type NavItemType, NavMenu, type NavMenuItem, Navbar, type NavbarSize, type NavbarType, type NavbarVariant, NotificationCenter, NumberInput, PageContainer, type PageContainerWidth, PageHeader, type PageHeaderBehavior, type PageHeaderIntensity, type PageHeaderProps, type PageHeaderVariant, type Pager, Pagination, type PaginationOptions, PinInput, Popover, PreferencesContext, Progress, type PromiseToastMessages, RadioGroup, Rating, type ResolvedPreferences, ScrollArea, SectionHeading, type SectionHeadingProps, SegmentedControl, SettingsLayout, type SettingsLayoutProps, type SettingsSection, Sheet, Sidebar, type SidebarContextValue, type SidebarItem, SidebarNav, type SidebarNavSize, type SidebarPosition, type SidebarSection, type SidebarType, Skeleton, SkipLink, SliderRange, Spinner, StackedList, type StackedListVariant, StatsCard, StatusDot, type StatusDotVariant, Stepper, TIME_ZOOMS, type Tab, Table, type TableDensity, type TableProps, TableToolbar, type TableToolbarActiveFilter, type TableToolbarFilterOption, Tabs, Tag, TagInput, type TagPaletteColor, type TagVariant, TextOverflow, type TextOverflowProps, Textarea, TimeBar, type TimeBarProps, TimePicker, TimeRow, type TimeRowProps, type TimeScale, TimeScaleHeader, type TimeScaleHeaderProps, type TimeScaleOptions, type TimeTick, TimeViewport, type TimeViewportHandle, type TimeViewportLayout, type TimeViewportProps, type TimeViewportState, type TimeZoom, Timeline, Toast, type ToastAction, type ToastApi, type ToastOptions, type ToastPosition, ToastProvider, type ToastVariant, Toggle, Tooltip, Tour, TransferList, TreeView, type Trend, type UseTextOverflowOptions, type UseTextOverflowResult, dateOfDay, dayOf, endDayOf, fitLabel, fitLabels, formatDateRange, preferenceActionKey, timeExtent, useAppShell, useContentWidth, useDestructiveAction, useFittedLabels, useFormContext, useGridKeyboard, usePagination, usePreferences, useSidebar, useTextMeasure, useTextOverflow, useTimeScale, useTimeViewport, useTimeViewportLayout, useToast, useToastOptional, useUnsavedChanges };
+export { Accordion, ActionPanel, ActionPanelGroup, AddAnother, type AddAnotherProps, Alert, type AlertPlacement, AppShell, type AppShellContextValue, type AppShellFocus, AppShellPreferences, type AppShellTheme, AsidePanel, type AsidePanelProps, type AsidePanelSide, Avatar, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, type AvatarStatus, Badge, type BadgePaletteColor, type BadgeSeverity, type BadgeSize, type BadgeVariant, BottomNav, type BottomNavItem, type BreadcrumbItem$1 as BreadcrumbItem, Breadcrumbs, type BreadcrumbsSeparator, type BreadcrumbsSize, type BreadcrumbsVariant, BreakpointKey, BulkActionBar, Button, ButtonSizeContext, Calendar, type CalendarDay, Card, CardContent, CardDescription, CardFooter, CardGrid, type CardGridProps, CardHeader, type CardSelectType, CardTitle, type CardVariant, Carousel, type ChatMessage, type ChatMessageAction, type ChatMessageLayout, ChatMessageList, type ChatMessageSender, type ChatMessageSource, type ChatMessageStatus, ChatPanel, type ChatPanelProps, type ChatPanelStatusTone, Checkbox, CheckboxGroup, CheckboxGroupItem, CodeBlock, Collapsible, ColorPicker, type Column, Combobox, CommandPalette, ContextMenu, type ControlSize, ControlSizeContext, CornerPanel, type CornerPanelEdge, type CornerPanelProps, DEFAULT_DATE_RANGE_PRESETS, DataList, type DateInput, DatePicker, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, type DateRangeWords, type DescriptionItem, DescriptionList, type DescriptionListOrientation, type DescriptionListSize, type DestructiveActionHandle, type DestructiveActionOptions, Dialog, Divider, Dock, Drawer, Dropdown, DropdownMenu, type DropdownMenuDivider, type DropdownMenuEntry, type DropdownMenuItem, EmptyState, EntityCell, Field, type FieldControlProps, type FieldLabel, type FieldProps, FileUpload, type FileUploadItem, type FileUploadRequestOptions, type FileUploadStatus, type FitLabelsOptions, type FittedLabel, FormWrapper, Gantt, type GanttGroup, type GanttItem, type GanttProps, type GanttStatus, type GanttTone, type GridKeyboard, type GridKeyboardOptions, HoverCard, InlineFieldError, Input, Kbd, Label, type LabelBox, Launcher, type LauncherEdge, type LauncherProps, type LauncherVariant, type LauncherWhenOpen, Link, type LinkProps, MentionInput, MobileHeaderMenu, type MobileHeaderMenuItemData, type MobileHeaderMenuType, NavItem, type NavItemProps, type NavItemType, NavMenu, type NavMenuItem, Navbar, type NavbarSize, type NavbarType, type NavbarVariant, NotificationCenter, NumberInput, PageContainer, type PageContainerWidth, PageHeader, type PageHeaderBehavior, type PageHeaderIntensity, type PageHeaderProps, type PageHeaderVariant, Pager, Pagination, PinInput, Popover, Progress, type PromiseToastMessages, RadioGroup, Rating, ScrollArea, SectionHeading, type SectionHeadingProps, SegmentedControl, SettingsLayout, type SettingsLayoutProps, type SettingsSection, Sheet, Sidebar, type SidebarContextValue, type SidebarItem, SidebarNav, type SidebarNavSize, type SidebarPosition, type SidebarSection, type SidebarType, Skeleton, SkipLink, SliderRange, type SortDir, Spinner, StackedList, type StackedListVariant, StatsCard, StatusDot, type StatusDotVariant, Stepper, TIME_ZOOMS, type Tab, Table, type TableDensity, type TableProps, type TableRow, TableToolbar, type TableToolbarActiveFilter, type TableToolbarFilterOption, Tabs, Tag, TagInput, type TagPaletteColor, type TagVariant, TextOverflow, type TextOverflowProps, Textarea, TimeBar, type TimeBarProps, TimePicker, TimeRow, type TimeRowProps, type TimeScale, TimeScaleHeader, type TimeScaleHeaderProps, type TimeScaleOptions, type TimeTick, TimeViewport, type TimeViewportHandle, type TimeViewportLayout, type TimeViewportProps, type TimeViewportState, type TimeZoom, Timeline, Toast, type ToastAction, type ToastApi, type ToastOptions, type ToastPosition, ToastProvider, type ToastVariant, Toggle, Tooltip, Tour, TransferList, TreeView, type Trend, type UseTextOverflowOptions, type UseTextOverflowResult, dateOfDay, dayOf, endDayOf, fitLabel, fitLabels, formatDateRange, timeExtent, useAppShell, useContentWidth, useDestructiveAction, useFittedLabels, useFormContext, useGridKeyboard, useSidebar, useTextMeasure, useTextOverflow, useTimeScale, useTimeViewport, useTimeViewportLayout, useToast, useToastOptional, useUnsavedChanges };