@morze/ui 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -3,6 +3,8 @@ import * as React from 'react';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 import { Toggle as Toggle$1, ToggleGroup as ToggleGroup$1, Checkbox as Checkbox$1, RadioGroup as RadioGroup$1, Switch as Switch$1, Slider as Slider$1, Label as Label$1, Select as Select$1, Tabs as Tabs$1, Accordion as Accordion$1, Progress as Progress$1, Avatar as Avatar$1, Separator as Separator$1, Dialog as Dialog$1, Popover as Popover$1, DropdownMenu as DropdownMenu$1, Tooltip as Tooltip$1 } from 'radix-ui';
+import { D as DataTableLabels } from './types-B8jz2FF9.cjs';
+export { M as MorzeCommonLabels, a as MorzeLocale, d as defaultDataTableLabels, r as resolveLabels } from './types-B8jz2FF9.cjs';
 
 /**
  * Class name joiner. Morze UI ships plain, prefixed CSS rather than utility
@@ -46,18 +48,15 @@ type ButtonProps = React.ComponentProps<'button'> & VariantProps<typeof buttonVa
     tone?: Tone;
     /** Swaps the label for a spinner and blocks interaction. */
     loading?: boolean;
-    /** Pulsing morse dot before the label — the landing's signature accent. */
-    dot?: boolean;
 };
-declare function Button({ className, variant, size, asChild, tone, loading, dot, disabled, children, ...props }: ButtonProps): React.JSX.Element;
+declare function Button({ className, variant, size, asChild, tone, loading, disabled, children, ...props }: ButtonProps): React.JSX.Element;
 
 declare const badgeVariants: (props?: ({
     variant?: "outline" | "solid" | "soft" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-declare function Badge({ className, variant, tone, dot, asChild, children, ...props }: React.ComponentProps<'span'> & VariantProps<typeof badgeVariants> & {
+declare function Badge({ className, variant, tone, asChild, children, ...props }: React.ComponentProps<'span'> & VariantProps<typeof badgeVariants> & {
     asChild?: boolean;
     tone?: Tone;
-    dot?: boolean;
 }): React.JSX.Element;
 
 declare const toggleVariants: (props?: ({
@@ -364,6 +363,16 @@ type FilterValue = {
 } | {
     type: 'boolean';
     value: boolean;
+}
+/**
+ * Whatever a host's own filter widget produces. The value travels into
+ * `query.filters` untouched — its shape is the host's business — and `label`
+ * is what the chip above the table shows.
+ */
+ | {
+    type: 'custom';
+    value: unknown;
+    label?: string;
 };
 type DataTableFilters = Record<string, FilterValue>;
 type DataTableQuery = {
@@ -376,6 +385,18 @@ type SelectOptionDef = {
     value: string;
     label: string;
 };
+/** What a `custom` filter's `render` gets to work with. */
+type CustomFilterContext = {
+    /** The staged value — the popover's draft, not what the query carries yet. */
+    value: unknown;
+    label?: string;
+    /** Stages a value; it reaches the query when Apply is pressed. */
+    onChange: (value: unknown, label?: string) => void;
+    /** Stages and applies in one step, then closes the popover. */
+    commit: (value: unknown, label?: string) => void;
+    /** The table's resolved strings, so a host widget stays translated with it. */
+    labels: DataTableLabels;
+};
 /** Declares which control the header popover shows and what it sends back. */
 type ColumnFilterDef = {
     type: 'text';
@@ -394,6 +415,20 @@ type ColumnFilterDef = {
     type: 'boolean';
     trueLabel?: string;
     falseLabel?: string;
+}
+/**
+ * A host-supplied control — async multiselect, range slider, presence
+ * toggle — rendered inside the kit's popover so it looks like the built-in
+ * filters and, unlike a widget smuggled into `column.header`, takes part in
+ * `query.filters`.
+ */
+ | {
+    type: 'custom';
+    render: (context: CustomFilterContext) => React.ReactNode;
+    /** Chip text for a value; falls back to the label the widget supplied. */
+    describe?: (value: unknown) => string;
+    /** `false` drops the Apply/Reset footer — for a widget that commits itself. */
+    actions?: boolean;
 };
 type EditableDef<T> = {
     type: 'text' | 'number' | 'select';
@@ -432,6 +467,10 @@ type DataTableColumn<T> = {
     editable?: EditableDef<T>;
     headerTitle?: string;
 };
+/** Anything valid on a `<tr>`, plus `data-*` — the row-level escape hatch. */
+type RowAttributes = React.ComponentPropsWithoutRef<'tr'> & {
+    [key: `data-${string}`]: string | number | boolean | undefined;
+};
 /** Column layout is UI state, not query state — it never reaches the backend. */
 type ColumnLayout = {
     order: string[];
@@ -458,60 +497,6 @@ type RowSelectionState = {
 };
 declare const emptyQuery: DataTableQuery;
 
-/**
- * Every visible string the table owns, in one place. Defaults are English;
- * pass a partial `labels` object to translate or reword any of them.
- */
-type DataTableLabels = {
-    filter: string;
-    filterFor: (column: string) => string;
-    filterActive: string;
-    contains: string;
-    apply: string;
-    reset: string;
-    resetAll: string;
-    resetFilters: string;
-    clearFilter: string;
-    rangeFrom: string;
-    rangeTo: string;
-    dateFrom: string;
-    dateTo: string;
-    yes: string;
-    no: string;
-    columns: string;
-    moveUp: (column: string) => string;
-    moveDown: (column: string) => string;
-    pinning: (column: string, side: string) => string;
-    pinnedLeft: string;
-    pinnedRight: string;
-    notPinned: string;
-    show: (column: string) => string;
-    hide: (column: string) => string;
-    sortBy: (column: string) => string;
-    columnWidth: (column: string) => string;
-    selectPage: string;
-    selectRow: string;
-    expandRow: string;
-    collapseRow: string;
-    details: string;
-    empty: string;
-    retry: string;
-    rowsPerPage: string;
-    nothingFound: string;
-    of: string;
-    firstPage: string;
-    previousPage: string;
-    nextPage: string;
-    lastPage: string;
-    selectedCount: (count: string) => string;
-    allMatchingSuffix: string;
-    selectAllMatching: (total: string) => string;
-    clearSelection: string;
-    bulkActions: string;
-};
-declare const defaultDataTableLabels: DataTableLabels;
-declare function resolveLabels(labels?: Partial<DataTableLabels>): DataTableLabels;
-
 type DataTableProps<T> = {
     columns: DataTableColumn<T>[];
     data: T[];
@@ -529,6 +514,19 @@ type DataTableProps<T> = {
     bulkActions?: (selection: RowSelectionState) => React.ReactNode;
     renderExpanded?: (row: T) => React.ReactNode;
     onRowClick?: (row: T) => void;
+    /** Per-row class name — tinting a row by record state, marking it stale. */
+    rowClassName?: (row: T, context: {
+        rowIndex: number;
+    }) => string | undefined;
+    /**
+     * Extra attributes for the row element: `data-*`, `title`, `aria-*`, a
+     * handler of your own. The table's own attributes win, so this cannot break
+     * selection, expansion or the pinned-column seam; a `className` here is
+     * merged, and an `onClick` runs before `onRowClick`.
+     */
+    rowProps?: (row: T, context: {
+        rowIndex: number;
+    }) => RowAttributes;
     layout?: Partial<ColumnLayout>;
     onLayoutChange?: (layout: ColumnLayout) => void;
     /** localStorage key for widths, order, visibility and pinning. */
@@ -543,7 +541,20 @@ type DataTableProps<T> = {
     density?: 'compact' | 'normal' | 'relaxed';
     stickyHeader?: boolean;
     emptyState?: React.ReactNode;
-    pageSizeOptions?: number[];
+    /** `false` — or a single option — hides the rows-per-page select. */
+    pageSizeOptions?: number[] | false;
+    /** Renders the pager. Defaults to `false` once `onLoadMore` is given. */
+    pagination?: boolean;
+    /**
+     * Appends the next page instead of replacing the current one. Passing it
+     * puts a footer inside the table's own scroller — the element an infinite
+     * scroll needs to watch, which a host cannot add from the outside.
+     */
+    onLoadMore?: () => void;
+    /** Whether anything is left to load. Defaults to `data.length < total`. */
+    hasMore?: boolean;
+    /** `false` waits for a click instead of loading as the footer scrolls in. */
+    autoLoadMore?: boolean;
     /** Overrides for any of the table's own strings. Defaults are English. */
     labels?: Partial<DataTableLabels>;
     /** Locale for number formatting; defaults to the browser's. */
@@ -551,13 +562,17 @@ type DataTableProps<T> = {
     caption?: string;
     className?: string;
 };
-declare function DataTable<T>({ columns, data, rowKey, total, loading, error, onRetry, query, onQueryChange, selection, onSelectionChange, bulkActions, renderExpanded, onRowClick, layout: controlledLayout, onLayoutChange, persistKey, toolbar, autoFit, density, stickyHeader, emptyState, pageSizeOptions, labels: labelsProp, locale, caption, className, }: DataTableProps<T>): React.JSX.Element;
+declare function DataTable<T>({ columns, data, rowKey, total, loading, error, onRetry, query, onQueryChange, selection, onSelectionChange, bulkActions, renderExpanded, onRowClick, rowClassName, rowProps, layout: controlledLayout, onLayoutChange, persistKey, toolbar, autoFit, density, stickyHeader, emptyState, pageSizeOptions, pagination, onLoadMore, hasMore, autoLoadMore, labels: labelsProp, locale, caption, className, }: DataTableProps<T>): React.JSX.Element;
 
 declare function DataTablePagination({ query, total, rowsOnPage, pageSizeOptions, labels: labelsProp, locale, onQueryChange, }: {
     query: DataTableQuery;
     total?: number;
     rowsOnPage: number;
-    pageSizeOptions?: number[];
+    /**
+     * `false` — or a single option — hides the control: a host whose backend
+     * fixes the page size would otherwise show a select that changes nothing.
+     */
+    pageSizeOptions?: number[] | false;
     labels?: Partial<DataTableLabels>;
     /** Number formatting locale; defaults to the browser's. */
     locale?: string;
@@ -689,4 +704,4 @@ declare function pageCount(total: number | undefined, pageSize: number): number;
 declare function serializeSort(sort: DataTableSort[]): string;
 declare function parseSort(raw: string | null): DataTableSort[];
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, Button, type ButtonProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, type CheckboxProps, ColumnFilter, type ColumnFilterDef, type ColumnLayout, ColumnManager, DataTable, type DataTableColumn, type DataTableFilters, type DataTableLabels, DataTablePagination, type DataTableProps, type DataTableQuery, type DataTableSort, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type EditableDef, Field, FieldError, FieldHint, FilterChip, type FilterValue, Input, type InputProps, Label, type MorzeTheme, MorzeThemeProvider, type MorzeThemeProviderProps, Popover, PopoverAnchor, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, Progress, RadioGroup, RadioGroupItem, type RowSelectionState, type SavedView, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOptionDef, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, type SidebarMenuButtonProps, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarPanel, type SidebarProps, SidebarProvider, type SidebarProviderProps, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, type SortDir, Spinner, Switch, type SwitchProps, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toggle, ToggleGroup, ToggleGroupItem, type Tone, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseSavedViewsOptions, type UseTableQueryOptions, activeFilters, badgeVariants, buttonVariants, cn, defaultDataTableLabels, emptyQuery, isFilterActive, pageCount, parseSort, resolveLabels, serializeSort, setFilter, sortStateOf, toggleSort, toggleVariants, useColumnLayout, useIsMobile, useMorzeTheme, useRowSelection, useSavedViews, useSidebar, useTableQuery };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, Button, type ButtonProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, type CheckboxProps, ColumnFilter, type ColumnFilterDef, type ColumnLayout, ColumnManager, type CustomFilterContext, DataTable, type DataTableColumn, type DataTableFilters, DataTableLabels, DataTablePagination, type DataTableProps, type DataTableQuery, type DataTableSort, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type EditableDef, Field, FieldError, FieldHint, FilterChip, type FilterValue, Input, type InputProps, Label, type MorzeTheme, MorzeThemeProvider, type MorzeThemeProviderProps, Popover, PopoverAnchor, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, Progress, RadioGroup, RadioGroupItem, type RowAttributes, type RowSelectionState, type SavedView, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOptionDef, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, type SidebarMenuButtonProps, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarPanel, type SidebarProps, SidebarProvider, type SidebarProviderProps, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, type SortDir, Spinner, Switch, type SwitchProps, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toggle, ToggleGroup, ToggleGroupItem, type Tone, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseSavedViewsOptions, type UseTableQueryOptions, activeFilters, badgeVariants, buttonVariants, cn, emptyQuery, isFilterActive, pageCount, parseSort, serializeSort, setFilter, sortStateOf, toggleSort, toggleVariants, useColumnLayout, useIsMobile, useMorzeTheme, useRowSelection, useSavedViews, useSidebar, useTableQuery };

package/dist/index.d.ts

@@ -3,6 +3,8 @@ import * as React from 'react';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 import { Toggle as Toggle$1, ToggleGroup as ToggleGroup$1, Checkbox as Checkbox$1, RadioGroup as RadioGroup$1, Switch as Switch$1, Slider as Slider$1, Label as Label$1, Select as Select$1, Tabs as Tabs$1, Accordion as Accordion$1, Progress as Progress$1, Avatar as Avatar$1, Separator as Separator$1, Dialog as Dialog$1, Popover as Popover$1, DropdownMenu as DropdownMenu$1, Tooltip as Tooltip$1 } from 'radix-ui';
+import { D as DataTableLabels } from './types-B8jz2FF9.js';
+export { M as MorzeCommonLabels, a as MorzeLocale, d as defaultDataTableLabels, r as resolveLabels } from './types-B8jz2FF9.js';
 
 /**
  * Class name joiner. Morze UI ships plain, prefixed CSS rather than utility
@@ -46,18 +48,15 @@ type ButtonProps = React.ComponentProps<'button'> & VariantProps<typeof buttonVa
     tone?: Tone;
     /** Swaps the label for a spinner and blocks interaction. */
     loading?: boolean;
-    /** Pulsing morse dot before the label — the landing's signature accent. */
-    dot?: boolean;
 };
-declare function Button({ className, variant, size, asChild, tone, loading, dot, disabled, children, ...props }: ButtonProps): React.JSX.Element;
+declare function Button({ className, variant, size, asChild, tone, loading, disabled, children, ...props }: ButtonProps): React.JSX.Element;
 
 declare const badgeVariants: (props?: ({
     variant?: "outline" | "solid" | "soft" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-declare function Badge({ className, variant, tone, dot, asChild, children, ...props }: React.ComponentProps<'span'> & VariantProps<typeof badgeVariants> & {
+declare function Badge({ className, variant, tone, asChild, children, ...props }: React.ComponentProps<'span'> & VariantProps<typeof badgeVariants> & {
     asChild?: boolean;
     tone?: Tone;
-    dot?: boolean;
 }): React.JSX.Element;
 
 declare const toggleVariants: (props?: ({
@@ -364,6 +363,16 @@ type FilterValue = {
 } | {
     type: 'boolean';
     value: boolean;
+}
+/**
+ * Whatever a host's own filter widget produces. The value travels into
+ * `query.filters` untouched — its shape is the host's business — and `label`
+ * is what the chip above the table shows.
+ */
+ | {
+    type: 'custom';
+    value: unknown;
+    label?: string;
 };
 type DataTableFilters = Record<string, FilterValue>;
 type DataTableQuery = {
@@ -376,6 +385,18 @@ type SelectOptionDef = {
     value: string;
     label: string;
 };
+/** What a `custom` filter's `render` gets to work with. */
+type CustomFilterContext = {
+    /** The staged value — the popover's draft, not what the query carries yet. */
+    value: unknown;
+    label?: string;
+    /** Stages a value; it reaches the query when Apply is pressed. */
+    onChange: (value: unknown, label?: string) => void;
+    /** Stages and applies in one step, then closes the popover. */
+    commit: (value: unknown, label?: string) => void;
+    /** The table's resolved strings, so a host widget stays translated with it. */
+    labels: DataTableLabels;
+};
 /** Declares which control the header popover shows and what it sends back. */
 type ColumnFilterDef = {
     type: 'text';
@@ -394,6 +415,20 @@ type ColumnFilterDef = {
     type: 'boolean';
     trueLabel?: string;
     falseLabel?: string;
+}
+/**
+ * A host-supplied control — async multiselect, range slider, presence
+ * toggle — rendered inside the kit's popover so it looks like the built-in
+ * filters and, unlike a widget smuggled into `column.header`, takes part in
+ * `query.filters`.
+ */
+ | {
+    type: 'custom';
+    render: (context: CustomFilterContext) => React.ReactNode;
+    /** Chip text for a value; falls back to the label the widget supplied. */
+    describe?: (value: unknown) => string;
+    /** `false` drops the Apply/Reset footer — for a widget that commits itself. */
+    actions?: boolean;
 };
 type EditableDef<T> = {
     type: 'text' | 'number' | 'select';
@@ -432,6 +467,10 @@ type DataTableColumn<T> = {
     editable?: EditableDef<T>;
     headerTitle?: string;
 };
+/** Anything valid on a `<tr>`, plus `data-*` — the row-level escape hatch. */
+type RowAttributes = React.ComponentPropsWithoutRef<'tr'> & {
+    [key: `data-${string}`]: string | number | boolean | undefined;
+};
 /** Column layout is UI state, not query state — it never reaches the backend. */
 type ColumnLayout = {
     order: string[];
@@ -458,60 +497,6 @@ type RowSelectionState = {
 };
 declare const emptyQuery: DataTableQuery;
 
-/**
- * Every visible string the table owns, in one place. Defaults are English;
- * pass a partial `labels` object to translate or reword any of them.
- */
-type DataTableLabels = {
-    filter: string;
-    filterFor: (column: string) => string;
-    filterActive: string;
-    contains: string;
-    apply: string;
-    reset: string;
-    resetAll: string;
-    resetFilters: string;
-    clearFilter: string;
-    rangeFrom: string;
-    rangeTo: string;
-    dateFrom: string;
-    dateTo: string;
-    yes: string;
-    no: string;
-    columns: string;
-    moveUp: (column: string) => string;
-    moveDown: (column: string) => string;
-    pinning: (column: string, side: string) => string;
-    pinnedLeft: string;
-    pinnedRight: string;
-    notPinned: string;
-    show: (column: string) => string;
-    hide: (column: string) => string;
-    sortBy: (column: string) => string;
-    columnWidth: (column: string) => string;
-    selectPage: string;
-    selectRow: string;
-    expandRow: string;
-    collapseRow: string;
-    details: string;
-    empty: string;
-    retry: string;
-    rowsPerPage: string;
-    nothingFound: string;
-    of: string;
-    firstPage: string;
-    previousPage: string;
-    nextPage: string;
-    lastPage: string;
-    selectedCount: (count: string) => string;
-    allMatchingSuffix: string;
-    selectAllMatching: (total: string) => string;
-    clearSelection: string;
-    bulkActions: string;
-};
-declare const defaultDataTableLabels: DataTableLabels;
-declare function resolveLabels(labels?: Partial<DataTableLabels>): DataTableLabels;
-
 type DataTableProps<T> = {
     columns: DataTableColumn<T>[];
     data: T[];
@@ -529,6 +514,19 @@ type DataTableProps<T> = {
     bulkActions?: (selection: RowSelectionState) => React.ReactNode;
     renderExpanded?: (row: T) => React.ReactNode;
     onRowClick?: (row: T) => void;
+    /** Per-row class name — tinting a row by record state, marking it stale. */
+    rowClassName?: (row: T, context: {
+        rowIndex: number;
+    }) => string | undefined;
+    /**
+     * Extra attributes for the row element: `data-*`, `title`, `aria-*`, a
+     * handler of your own. The table's own attributes win, so this cannot break
+     * selection, expansion or the pinned-column seam; a `className` here is
+     * merged, and an `onClick` runs before `onRowClick`.
+     */
+    rowProps?: (row: T, context: {
+        rowIndex: number;
+    }) => RowAttributes;
     layout?: Partial<ColumnLayout>;
     onLayoutChange?: (layout: ColumnLayout) => void;
     /** localStorage key for widths, order, visibility and pinning. */
@@ -543,7 +541,20 @@ type DataTableProps<T> = {
     density?: 'compact' | 'normal' | 'relaxed';
     stickyHeader?: boolean;
     emptyState?: React.ReactNode;
-    pageSizeOptions?: number[];
+    /** `false` — or a single option — hides the rows-per-page select. */
+    pageSizeOptions?: number[] | false;
+    /** Renders the pager. Defaults to `false` once `onLoadMore` is given. */
+    pagination?: boolean;
+    /**
+     * Appends the next page instead of replacing the current one. Passing it
+     * puts a footer inside the table's own scroller — the element an infinite
+     * scroll needs to watch, which a host cannot add from the outside.
+     */
+    onLoadMore?: () => void;
+    /** Whether anything is left to load. Defaults to `data.length < total`. */
+    hasMore?: boolean;
+    /** `false` waits for a click instead of loading as the footer scrolls in. */
+    autoLoadMore?: boolean;
     /** Overrides for any of the table's own strings. Defaults are English. */
     labels?: Partial<DataTableLabels>;
     /** Locale for number formatting; defaults to the browser's. */
@@ -551,13 +562,17 @@ type DataTableProps<T> = {
     caption?: string;
     className?: string;
 };
-declare function DataTable<T>({ columns, data, rowKey, total, loading, error, onRetry, query, onQueryChange, selection, onSelectionChange, bulkActions, renderExpanded, onRowClick, layout: controlledLayout, onLayoutChange, persistKey, toolbar, autoFit, density, stickyHeader, emptyState, pageSizeOptions, labels: labelsProp, locale, caption, className, }: DataTableProps<T>): React.JSX.Element;
+declare function DataTable<T>({ columns, data, rowKey, total, loading, error, onRetry, query, onQueryChange, selection, onSelectionChange, bulkActions, renderExpanded, onRowClick, rowClassName, rowProps, layout: controlledLayout, onLayoutChange, persistKey, toolbar, autoFit, density, stickyHeader, emptyState, pageSizeOptions, pagination, onLoadMore, hasMore, autoLoadMore, labels: labelsProp, locale, caption, className, }: DataTableProps<T>): React.JSX.Element;
 
 declare function DataTablePagination({ query, total, rowsOnPage, pageSizeOptions, labels: labelsProp, locale, onQueryChange, }: {
     query: DataTableQuery;
     total?: number;
     rowsOnPage: number;
-    pageSizeOptions?: number[];
+    /**
+     * `false` — or a single option — hides the control: a host whose backend
+     * fixes the page size would otherwise show a select that changes nothing.
+     */
+    pageSizeOptions?: number[] | false;
     labels?: Partial<DataTableLabels>;
     /** Number formatting locale; defaults to the browser's. */
     locale?: string;
@@ -689,4 +704,4 @@ declare function pageCount(total: number | undefined, pageSize: number): number;
 declare function serializeSort(sort: DataTableSort[]): string;
 declare function parseSort(raw: string | null): DataTableSort[];
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, Button, type ButtonProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, type CheckboxProps, ColumnFilter, type ColumnFilterDef, type ColumnLayout, ColumnManager, DataTable, type DataTableColumn, type DataTableFilters, type DataTableLabels, DataTablePagination, type DataTableProps, type DataTableQuery, type DataTableSort, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type EditableDef, Field, FieldError, FieldHint, FilterChip, type FilterValue, Input, type InputProps, Label, type MorzeTheme, MorzeThemeProvider, type MorzeThemeProviderProps, Popover, PopoverAnchor, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, Progress, RadioGroup, RadioGroupItem, type RowSelectionState, type SavedView, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOptionDef, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, type SidebarMenuButtonProps, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarPanel, type SidebarProps, SidebarProvider, type SidebarProviderProps, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, type SortDir, Spinner, Switch, type SwitchProps, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toggle, ToggleGroup, ToggleGroupItem, type Tone, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseSavedViewsOptions, type UseTableQueryOptions, activeFilters, badgeVariants, buttonVariants, cn, defaultDataTableLabels, emptyQuery, isFilterActive, pageCount, parseSort, resolveLabels, serializeSort, setFilter, sortStateOf, toggleSort, toggleVariants, useColumnLayout, useIsMobile, useMorzeTheme, useRowSelection, useSavedViews, useSidebar, useTableQuery };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, Button, type ButtonProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, type CheckboxProps, ColumnFilter, type ColumnFilterDef, type ColumnLayout, ColumnManager, type CustomFilterContext, DataTable, type DataTableColumn, type DataTableFilters, DataTableLabels, DataTablePagination, type DataTableProps, type DataTableQuery, type DataTableSort, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type EditableDef, Field, FieldError, FieldHint, FilterChip, type FilterValue, Input, type InputProps, Label, type MorzeTheme, MorzeThemeProvider, type MorzeThemeProviderProps, Popover, PopoverAnchor, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, Progress, RadioGroup, RadioGroupItem, type RowAttributes, type RowSelectionState, type SavedView, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOptionDef, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, type SidebarMenuButtonProps, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarPanel, type SidebarProps, SidebarProvider, type SidebarProviderProps, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, type SortDir, Spinner, Switch, type SwitchProps, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toggle, ToggleGroup, ToggleGroupItem, type Tone, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseSavedViewsOptions, type UseTableQueryOptions, activeFilters, badgeVariants, buttonVariants, cn, emptyQuery, isFilterActive, pageCount, parseSort, serializeSort, setFilter, sortStateOf, toggleSort, toggleVariants, useColumnLayout, useIsMobile, useMorzeTheme, useRowSelection, useSavedViews, useSidebar, useTableQuery };