@dimaan/ui 0.0.17 → 0.0.19

package/dist/index.d.cts

@@ -1468,8 +1468,16 @@ interface TableProps<T> {
     data: readonly T[];
     /** Column definitions. */
     columns: ReadonlyArray<Column<T>>;
-    /** Stable id for each row. Required for selection; recommended always. */
-    getRowId: (row: T, index: number) => string;
+    /**
+     * Stable id for each row. Required for selection; recommended always.
+     *
+     * **Optional with a default**: when omitted, Table reads `row.id` (most
+     * APIs use it) and falls back to the row index. Provide this explicitly
+     * for records that use a different identifier (`_id`, `uuid`) or any
+     * time the list can reorder — index-based ids break selection across
+     * reorders.
+     */
+    getRowId?: (row: T, index: number) => string;
     /**
      * Total row count across all pages. Pass this when the parent paginates/sorts
      * server-side — Table will skip its local sort + slice.
@@ -1576,16 +1584,64 @@ interface ListPageProps<T> {
     actions?: ReactNode;
     data: T[];
     columns: Column<T>[];
-    getRowId: (row: T) => string;
+    /**
+     * Stable id for each row. Required for row selection across re-renders and
+     * for stable React keys.
+     *
+     * Defaults to reading `row.id` when present, falling back to the row index.
+     * Provide this explicitly when your records use a different identifier
+     * (e.g. `_id`, `uuid`, a composite key) — index-based ids break selection
+     * when the data list reorders.
+     */
+    getRowId?: (row: T) => string;
     /** Show skeleton rows in the table area while data is fetching. */
     isLoading?: boolean;
     /** Number of skeleton rows rendered while loading. Defaults to the table page size. */
     loadingRowCount?: number;
     /** Keys on `T` to search. Search input only renders when this is provided. */
     searchKeys?: Array<keyof T>;
+    /**
+     * Controlled search input value. Pair with `onSearchChange` to drive the
+     * search from outside (typical for server-side filtering). When both are
+     * provided, ListPage **stops filtering `data` locally** for search —
+     * `data` is trusted to already match the query.
+     */
+    searchValue?: string;
+    /** Fires on every search input change. Pair with `searchValue` for controlled mode. */
+    onSearchChange?: (value: string) => void;
     filters?: ListPageFilter<T>[];
+    /**
+     * Controlled filter values keyed by `filter.key`. When provided alongside
+     * `onFilterChange`, ListPage **stops filtering `data` locally** — `data`
+     * is trusted to already match the active filter selections.
+     */
+    filterValues?: Record<string, string>;
+    /** Fires when any filter Select changes. Pair with `filterValues` for controlled mode. */
+    onFilterChange?: (key: string, value: string) => void;
     enableRowSelection?: boolean;
     bulkActions?: (selected: T[]) => ReactNode;
+    /**
+     * Controlled pagination state. Pair with `onPaginationChange` and `totalCount`
+     * for server-side pagination — the consumer's data-fetching layer becomes
+     * the source of truth for `pageIndex` / `pageSize`.
+     */
+    pagination?: PaginationState;
+    /** Uncontrolled initial pagination state. Ignored when `pagination` is set. */
+    defaultPagination?: PaginationState;
+    /** Fires when the user changes the page or page size. */
+    onPaginationChange?: (next: PaginationState) => void;
+    /**
+     * Total row count across all pages on the server. Setting this flips the
+     * inner Table into server-side mode — it stops slicing `data` locally and
+     * trusts `data` to be the current page already.
+     *
+     * In server-side mode the consumer also typically skips `searchKeys` /
+     * `filters` (those would filter only the current page) and drives search /
+     * filter from the data-fetching layer instead.
+     */
+    totalCount?: number;
+    /** Page-size dropdown options. Defaults to `[10, 25, 50]`. */
+    pageSizeOptions?: readonly number[];
     /**
      * Shown when filters/search are active but match zero rows. Falls back to a
      * "No results — try clearing the search or adjusting the filters" prompt
@@ -1664,7 +1720,7 @@ interface ListPageProps<T> {
  * />
  * ```
  */
-declare function ListPage<T>({ title, description, bordered, actions, data, columns, getRowId, isLoading, loadingRowCount, searchKeys, filters, enableRowSelection, bulkActions, emptyState, noDataState, labels: labelsProp, className, }: ListPageProps<T>): react_jsx_runtime.JSX.Element;
+declare function ListPage<T>({ title, description, bordered, actions, data, columns, getRowId, isLoading, loadingRowCount, searchKeys, searchValue: searchValueProp, onSearchChange, filters, filterValues: filterValuesProp, onFilterChange, enableRowSelection, bulkActions, pagination, defaultPagination, onPaginationChange, totalCount, pageSizeOptions, emptyState, noDataState, labels: labelsProp, className, }: ListPageProps<T>): react_jsx_runtime.JSX.Element;
 
 type RadioGroupSize = 'sm' | 'md' | 'lg';
 /** Outer circle (radio button itself) — sized + bordered. */

package/dist/index.d.ts

@@ -1468,8 +1468,16 @@ interface TableProps<T> {
     data: readonly T[];
     /** Column definitions. */
     columns: ReadonlyArray<Column<T>>;
-    /** Stable id for each row. Required for selection; recommended always. */
-    getRowId: (row: T, index: number) => string;
+    /**
+     * Stable id for each row. Required for selection; recommended always.
+     *
+     * **Optional with a default**: when omitted, Table reads `row.id` (most
+     * APIs use it) and falls back to the row index. Provide this explicitly
+     * for records that use a different identifier (`_id`, `uuid`) or any
+     * time the list can reorder — index-based ids break selection across
+     * reorders.
+     */
+    getRowId?: (row: T, index: number) => string;
     /**
      * Total row count across all pages. Pass this when the parent paginates/sorts
      * server-side — Table will skip its local sort + slice.
@@ -1576,16 +1584,64 @@ interface ListPageProps<T> {
     actions?: ReactNode;
     data: T[];
     columns: Column<T>[];
-    getRowId: (row: T) => string;
+    /**
+     * Stable id for each row. Required for row selection across re-renders and
+     * for stable React keys.
+     *
+     * Defaults to reading `row.id` when present, falling back to the row index.
+     * Provide this explicitly when your records use a different identifier
+     * (e.g. `_id`, `uuid`, a composite key) — index-based ids break selection
+     * when the data list reorders.
+     */
+    getRowId?: (row: T) => string;
     /** Show skeleton rows in the table area while data is fetching. */
     isLoading?: boolean;
     /** Number of skeleton rows rendered while loading. Defaults to the table page size. */
     loadingRowCount?: number;
     /** Keys on `T` to search. Search input only renders when this is provided. */
     searchKeys?: Array<keyof T>;
+    /**
+     * Controlled search input value. Pair with `onSearchChange` to drive the
+     * search from outside (typical for server-side filtering). When both are
+     * provided, ListPage **stops filtering `data` locally** for search —
+     * `data` is trusted to already match the query.
+     */
+    searchValue?: string;
+    /** Fires on every search input change. Pair with `searchValue` for controlled mode. */
+    onSearchChange?: (value: string) => void;
     filters?: ListPageFilter<T>[];
+    /**
+     * Controlled filter values keyed by `filter.key`. When provided alongside
+     * `onFilterChange`, ListPage **stops filtering `data` locally** — `data`
+     * is trusted to already match the active filter selections.
+     */
+    filterValues?: Record<string, string>;
+    /** Fires when any filter Select changes. Pair with `filterValues` for controlled mode. */
+    onFilterChange?: (key: string, value: string) => void;
     enableRowSelection?: boolean;
     bulkActions?: (selected: T[]) => ReactNode;
+    /**
+     * Controlled pagination state. Pair with `onPaginationChange` and `totalCount`
+     * for server-side pagination — the consumer's data-fetching layer becomes
+     * the source of truth for `pageIndex` / `pageSize`.
+     */
+    pagination?: PaginationState;
+    /** Uncontrolled initial pagination state. Ignored when `pagination` is set. */
+    defaultPagination?: PaginationState;
+    /** Fires when the user changes the page or page size. */
+    onPaginationChange?: (next: PaginationState) => void;
+    /**
+     * Total row count across all pages on the server. Setting this flips the
+     * inner Table into server-side mode — it stops slicing `data` locally and
+     * trusts `data` to be the current page already.
+     *
+     * In server-side mode the consumer also typically skips `searchKeys` /
+     * `filters` (those would filter only the current page) and drives search /
+     * filter from the data-fetching layer instead.
+     */
+    totalCount?: number;
+    /** Page-size dropdown options. Defaults to `[10, 25, 50]`. */
+    pageSizeOptions?: readonly number[];
     /**
      * Shown when filters/search are active but match zero rows. Falls back to a
      * "No results — try clearing the search or adjusting the filters" prompt
@@ -1664,7 +1720,7 @@ interface ListPageProps<T> {
  * />
  * ```
  */
-declare function ListPage<T>({ title, description, bordered, actions, data, columns, getRowId, isLoading, loadingRowCount, searchKeys, filters, enableRowSelection, bulkActions, emptyState, noDataState, labels: labelsProp, className, }: ListPageProps<T>): react_jsx_runtime.JSX.Element;
+declare function ListPage<T>({ title, description, bordered, actions, data, columns, getRowId, isLoading, loadingRowCount, searchKeys, searchValue: searchValueProp, onSearchChange, filters, filterValues: filterValuesProp, onFilterChange, enableRowSelection, bulkActions, pagination, defaultPagination, onPaginationChange, totalCount, pageSizeOptions, emptyState, noDataState, labels: labelsProp, className, }: ListPageProps<T>): react_jsx_runtime.JSX.Element;
 
 type RadioGroupSize = 'sm' | 'md' | 'lg';
 /** Outer circle (radio button itself) — sized + bordered. */