@expcat/tigercat-core 2.1.2 → 2.1.4

package/dist/{table-CHeBgM_2.d.ts → table-R9Yp1aVa.d.ts}

@@ -1,4 +1,4 @@
-import { a as TigerLocaleInput, b as TigerLocalePagination, c as TigerLocaleTable } from './locale-KMGxL6bT.js';
+import { b as TigerLocaleInput, c as TigerLocalePagination, d as TigerLocaleTable } from './locale-qoiGEqe_.js';
 
 /**
  * Pagination component types and interfaces
@@ -9,9 +9,9 @@ import { a as TigerLocaleInput, b as TigerLocalePagination, c as TigerLocaleTabl
  */
 type PaginationSize = 'small' | 'medium' | 'large';
 /**
- * Pagination alignment type
+ * Pagination alignment. `left`/`right` are aliases of logical `start`/`end`.
  */
-type PaginationAlign = 'left' | 'center' | 'right';
+type PaginationAlign = 'start' | 'center' | 'end' | 'left' | 'right';
 /**
  * Page size option type
  */
@@ -102,7 +102,7 @@ interface PaginationProps {
     simple?: boolean;
     /**
      * Custom text renderer for the simple-mode page indicator.
-     * Defaults to `{current} / {totalPages}` when not provided.
+     * Defaults to the locale `pageIndicatorText` template.
      * @param current - Current page number
      * @param totalPages - Total number of pages
      */
@@ -150,32 +150,6 @@ interface PaginationProps {
      */
     labels?: Partial<TigerLocalePagination>;
 }
-/**
- * Page change event info
- */
-interface PageChangeInfo {
-    /**
-     * New current page
-     */
-    current: number;
-    /**
-     * Current page size
-     */
-    pageSize: number;
-}
-/**
- * Page size change event info
- */
-interface PageSizeChangeInfo {
-    /**
-     * Current page (might be adjusted)
-     */
-    current: number;
-    /**
-     * New page size
-     */
-    pageSize: number;
-}
 
 /**
  * Table component types and interfaces
@@ -185,7 +159,8 @@ interface PageSizeChangeInfo {
  * Table size types
  */
 type TableSize = 'sm' | 'md' | 'lg';
-type TableExportFormat = 'csv' | 'excel';
+/** Built-in Table export is CSV only. Use DataExport for `.xlsx`. */
+type TableExportFormat = 'csv';
 type TableResponsiveMode = 'card' | 'scroll';
 type TableCardSelectionPosition = 'controls-row' | 'title-inline';
 /**
@@ -440,17 +415,24 @@ interface PaginationConfig {
      */
     defaultPageSize?: number;
     /**
-     * Total number of items
+     * Total number of items. `undefined` means “not passed” (local mode uses
+     * processed length). `0` is a real total — especially for `remote`.
      */
     total?: number;
     /**
-     * Remote (server-side) pagination mode. When true, `dataSource` is treated
-     * as the current page and the table skips internal slicing; page count and
-     * range text are derived from `total`. Built-in sorting/filtering only
-     * affects the current page — perform them server-side instead.
+     * Remote (server-side) mode. `dataSource` is the current page: the table
+     * skips internal slicing **and** built-in filter / sort / group. Page count
+     * uses `total` (including `0`). Set `localProcessing` to still run those
+     * on the current page.
      * @default false
      */
     remote?: boolean;
+    /**
+     * When `remote` is true, still run built-in filter / sort / group on the
+     * current page. Default is off.
+     * @default false
+     */
+    localProcessing?: boolean;
     /**
      * Available page size options
      * @default [10, 20, 50, 100]
@@ -516,7 +498,9 @@ interface RowSelectionConfig<T = Record<string, unknown>> {
      */
     defaultSelectedRowKeys?: (string | number)[];
     /**
-     * Function to get row key
+     * Function to get row key. Shares Table `rowKey` when both are set
+     * (`getRowKey` wins). Missing keys fall back to the dataSource index, never
+     * a page offset.
      * @default (record) => record.id
      */
     getRowKey?: (record: T) => string | number;
@@ -706,8 +690,8 @@ interface TableProps<T = Record<string, unknown>> {
      */
     emptyText?: string;
     /**
-     * Pagination configuration
-     * Set to false to disable pagination
+     * Pagination configuration. Omit to use the default pager (`pageSize` 10).
+     * Set to `false` to disable pagination.
      */
     pagination?: PaginationConfig | false;
     /**
@@ -720,8 +704,10 @@ interface TableProps<T = Record<string, unknown>> {
      */
     expandable?: ExpandableConfig<T>;
     /**
-     * Function to get row key
-     * @default (record) => record.id
+     * Row identity. String form reads `record[rowKey]`. Missing keys fall back
+     * to the dataSource index (not the current page index).
+     * `rowSelection.getRowKey`, when set, uses the same resolver (and wins).
+     * @default 'id'
      */
     rowKey?: string | ((record: T) => string | number);
     /**
@@ -744,8 +730,8 @@ interface TableProps<T = Record<string, unknown>> {
     tableLayout?: 'auto' | 'fixed';
     /**
      * Mobile layout below the `cardBreakpoint` width (640px by default).
-     * `scroll` keeps the table horizontally scrollable; `card` renders each row
-     * as a stacked card list.
+     * `scroll` keeps the table horizontally scrollable; `card` mounts a stacked
+     * card list **instead of** the `<table>` on that viewport (one accessible tree).
      * @default 'scroll'
      */
     responsiveMode?: TableResponsiveMode;
@@ -786,13 +772,17 @@ interface TableProps<T = Record<string, unknown>> {
      */
     cardFieldGap?: string;
     /**
-     * Enable virtual scrolling for large datasets
+     * Enable virtual scrolling for large datasets.
+     * Ignored when `expandable` or `groupBy` is set (row height is not fixed).
+     * The active card tree uses the same row window.
      * @default false
      */
     virtual?: boolean;
     /**
-     * Automatically enable Table's virtual scroll container for very large data sets.
-     * @default true
+     * Automatically enable Table's virtual scroll container for very large
+     * **processed** row counts. Default is off so a 1000-row source filtered to
+     * a handful of rows does not jump to a 400px virtual box.
+     * @default false
      */
     autoVirtual?: boolean;
     /**
@@ -817,10 +807,10 @@ interface TableProps<T = Record<string, unknown>> {
      */
     editable?: boolean;
     /**
-     * Set of editable cells: Map<columnKey, Set<rowIndex>>
-     * If not provided and editable=true, all cells are editable
+     * Editable cells as `{ [columnKey]: dataSourceIndex[] }`.
+     * If omitted and `editable` is true, every cell is editable.
      */
-    editableCells?: Map<string, Set<number>>;
+    editableCells?: Record<string, number[]>;
     /**
      * Filter mode
      * @default 'basic'
@@ -857,25 +847,58 @@ interface TableProps<T = Record<string, unknown>> {
      */
     exportable?: boolean;
     /**
-     * Export format.
+     * Built-in export format. Table only serializes CSV; use DataExport for xlsx.
      * @default 'csv'
      */
     exportFormat?: TableExportFormat;
     /**
-     * Export filename (without extension)
+     * Export filename. A trailing `.csv` is not duplicated.
      * @default 'export'
      */
     exportFilename?: string;
+    onChange?: (params: {
+        sort: SortState;
+        filters: Record<string, unknown>;
+        pagination: {
+            current: number;
+            pageSize: number;
+        } | null;
+    }) => void;
+    onRowClick?: (record: T, index: number) => void;
+    onSelectionChange?: (selectedKeys: (string | number)[]) => void;
+    onSortChange?: (sort: SortState) => void;
+    onFilterChange?: (filters: Record<string, unknown>) => void;
+    onHiddenColumnKeysChange?: (hiddenKeys: string[]) => void;
+    onPageChange?: (page: {
+        current: number;
+        pageSize: number;
+    }) => void;
+    onExpandChange?: (expandedKeys: (string | number)[], record: T, expanded: boolean) => void;
+    /**
+     * Cell commit. `rowIndex` is the **dataSource** index.
+     */
+    onCellChange?: (rowIndex: number, columnKey: string, newValue: string) => void;
+    onColumnOrderChange?: (columns: TableColumn<T>[]) => void;
+    onColumnFixedChange?: (columnKey: string, fixed: TableFixedPosition | false, columns: TableColumn<T>[]) => void;
+    onRowOrderChange?: (rows: T[]) => void;
+    onExport?: (csv: string) => void;
 }
 /**
  * Filter rule for advanced filtering
  */
 interface FilterRule {
+    /** Column key (not the record field). Values resolve through `dataKey`. */
     column: string;
-    operator: 'equals' | 'contains' | 'gt' | 'lt' | 'between' | 'notEquals';
-    value: unknown;
+    operator: 'equals' | 'contains' | 'gt' | 'lt' | 'gte' | 'lte' | 'between' | 'notEquals' | 'isEmpty';
+    /**
+     * Compared value. Empty `''` / `null` / `undefined` skips the rule
+     * (does not match every row). Use `isEmpty` to target blank cells.
+     */
+    value?: unknown;
+    /** Inclusive upper bound for `between`. */
     valueTo?: unknown;
+    /** How this rule combines with the previous one. Ignored on the first rule. */
     logic?: 'and' | 'or';
 }
 
-export type { TableFixedHeaderClassName as A, TableFixedHeaderClassNameContext as B, ColumnAlign as C, ExpandableConfig as E, FilterOption as F, PaginationConfig as P, RowSelectionConfig as R, SortDirection as S, TableColumn as T, TableSize as a, TableCardLayoutItem as b, TableFixedPosition as c, TableCardBreakpoint as d, TableResponsiveMode as e, TableProps as f, PaginationQuickJumperValidationOptions as g, PaginationSize as h, PaginationAlign as i, FilterRule as j, ColumnFilter as k, FilterType as l, PageChangeInfo as m, PageSizeChangeInfo as n, PaginationPageSizeOption as o, PaginationPageSizeOptionItem as p, PaginationProps as q, SortState as r, TableCardColSpan as s, TableCardRenderContext as t, TableCardRowSpan as u, TableCardSelectionPosition as v, TableColumnCardGrid as w, TableExportFormat as x, TableFixedCellClassName as y, TableFixedCellClassNameContext as z };
+export type { ColumnAlign as C, ExpandableConfig as E, FilterOption as F, PaginationConfig as P, RowSelectionConfig as R, SortState as S, TableColumn as T, TableSize as a, TableCardLayoutItem as b, TableFixedPosition as c, TableCardBreakpoint as d, TableResponsiveMode as e, SortDirection as f, TableProps as g, PaginationQuickJumperValidationOptions as h, PaginationSize as i, PaginationAlign as j, FilterRule as k, ColumnFilter as l, FilterType as m, PaginationPageSizeOption as n, PaginationPageSizeOptionItem as o, PaginationProps as p, TableCardColSpan as q, TableCardRenderContext as r, TableCardRowSpan as s, TableCardSelectionPosition as t, TableColumnCardGrid as u, TableExportFormat as v, TableFixedCellClassName as w, TableFixedCellClassNameContext as x, TableFixedHeaderClassName as y, TableFixedHeaderClassNameContext as z };