@rowakit/table 0.3.0 → 0.5.0

package/dist/index.d.cts

@@ -39,23 +39,45 @@ type FilterValue = {
  * Undefined values represent cleared filters.
  */
 type Filters = Record<string, FilterValue | undefined>;
+/**
+ * Sort column definition for multi-column sorting.
+ *
+ * Stage E adds multi-column sorting support:
+ * - sorts is an array of sort configurations (primary, secondary, etc.)
+ * - Ctrl/Cmd + click on header adds secondary sort
+ * - Click on header performs primary sort only
+ */
+interface SortColumn {
+    /** Field name to sort by */
+    field: string;
+    /** Sort direction */
+    direction: 'asc' | 'desc';
+    /** Sort priority (0 = primary, 1 = secondary, etc.) */
+    priority: number;
+}
 /**
  * Query parameters passed to the fetcher function.
  *
  * All pagination, sorting, and filtering state is passed through this query.
+ *
+ * Stage E changes:
+ * - sort is deprecated in favor of sorts array (backward compatible)
+ * - sorts supports multi-column sorting
  */
 interface FetcherQuery {
     /** Current page number (1-based) */
     page: number;
     /** Number of items per page */
     pageSize: number;
-    /** Optional sorting configuration */
+    /** Optional sorting configuration - DEPRECATED, use sorts instead */
     sort?: {
         /** Field name to sort by */
         field: string;
         /** Sort direction */
         direction: 'asc' | 'desc';
     };
+    /** Multi-column sorting configuration (Stage E+) */
+    sorts?: SortColumn[];
     /** Optional filters (omitted when empty) */
     filters?: Filters;
 }
@@ -215,6 +237,11 @@ interface ActionDef<T> {
     disabled?: boolean | ((row: T) => boolean);
 }
 
+type ExporterResult = {
+    url: string;
+} | Blob;
+type Exporter = (query: FetcherQuery) => Promise<ExporterResult>;
+
 /**
  * Column helper factory functions
  *
@@ -452,6 +479,16 @@ declare const col: {
     readonly custom: typeof custom;
 };
 
+interface BulkActionDef {
+    id: string;
+    label: string;
+    confirm?: {
+        title: string;
+        description?: string;
+    };
+    onClick: (selectedKeys: Array<string | number>) => void;
+}
+
 interface SmartTableProps<T> {
     /** Server-side data fetcher function */
     fetcher: Fetcher<T>;
@@ -473,6 +510,14 @@ interface SmartTableProps<T> {
     syncToUrl?: boolean;
     /** Stage C: Enable saved views feature (default: false) */
     enableSavedViews?: boolean;
+    /** Stage E: Enable row selection (default: false) */
+    enableRowSelection?: boolean;
+    /** Stage E: Selection change callback */
+    onSelectionChange?: (keys: Array<string | number>) => void;
+    /** Stage E: Bulk actions based on selection */
+    bulkActions?: BulkActionDef[];
+    /** Stage E: Export CSV (server-triggered) */
+    exporter?: Exporter;
 }
 /**
  * RowaKitTable - Server-side table component for internal/business apps.
@@ -525,7 +570,7 @@ interface SmartTableProps<T> {
  * }
  * ```
  */
-declare function RowaKitTable<T>({ fetcher, columns, defaultPageSize, pageSizeOptions, rowKey, className, enableFilters, enableColumnResizing, syncToUrl, enableSavedViews, }: SmartTableProps<T>): react_jsx_runtime.JSX.Element;
+declare function RowaKitTable<T>({ fetcher, columns, defaultPageSize, pageSizeOptions, rowKey, className, enableFilters, enableColumnResizing, syncToUrl, enableSavedViews, enableRowSelection, onSelectionChange, bulkActions, exporter, }: SmartTableProps<T>): react_jsx_runtime.JSX.Element;
 /**
  * @deprecated Use RowaKitTable instead. SmartTable is kept as an alias for backward compatibility.
  */
@@ -539,6 +584,6 @@ declare const SmartTable: typeof RowaKitTable;
  * @packageDocumentation
  */
 
-declare const VERSION = "0.1.0";
+declare const VERSION: string;
 
-export { type ActionDef, type ActionsColumnDef, type BadgeColumnDef, type BadgeTone, type BaseColumnDef, type BooleanColumnDef, type ColumnDef, type ColumnKind, type CustomColumnDef, type DateColumnDef, type Fetcher, type FetcherQuery, type FetcherResult, type FilterValue, type Filters, type NumberColumnDef, RowaKitTable, SmartTable, type SmartTableProps, type TextColumnDef, VERSION, col };
+export { type ActionDef, type ActionsColumnDef, type BadgeColumnDef, type BadgeTone, type BaseColumnDef, type BooleanColumnDef, type ColumnDef, type ColumnKind, type CustomColumnDef, type DateColumnDef, type Exporter, type ExporterResult, type Fetcher, type FetcherQuery, type FetcherResult, type FilterValue, type Filters, type NumberColumnDef, RowaKitTable, SmartTable, type SmartTableProps, type TextColumnDef, VERSION, col };

package/dist/index.d.ts

@@ -39,23 +39,45 @@ type FilterValue = {
  * Undefined values represent cleared filters.
  */
 type Filters = Record<string, FilterValue | undefined>;
+/**
+ * Sort column definition for multi-column sorting.
+ *
+ * Stage E adds multi-column sorting support:
+ * - sorts is an array of sort configurations (primary, secondary, etc.)
+ * - Ctrl/Cmd + click on header adds secondary sort
+ * - Click on header performs primary sort only
+ */
+interface SortColumn {
+    /** Field name to sort by */
+    field: string;
+    /** Sort direction */
+    direction: 'asc' | 'desc';
+    /** Sort priority (0 = primary, 1 = secondary, etc.) */
+    priority: number;
+}
 /**
  * Query parameters passed to the fetcher function.
  *
  * All pagination, sorting, and filtering state is passed through this query.
+ *
+ * Stage E changes:
+ * - sort is deprecated in favor of sorts array (backward compatible)
+ * - sorts supports multi-column sorting
  */
 interface FetcherQuery {
     /** Current page number (1-based) */
     page: number;
     /** Number of items per page */
     pageSize: number;
-    /** Optional sorting configuration */
+    /** Optional sorting configuration - DEPRECATED, use sorts instead */
     sort?: {
         /** Field name to sort by */
         field: string;
         /** Sort direction */
         direction: 'asc' | 'desc';
     };
+    /** Multi-column sorting configuration (Stage E+) */
+    sorts?: SortColumn[];
     /** Optional filters (omitted when empty) */
     filters?: Filters;
 }
@@ -215,6 +237,11 @@ interface ActionDef<T> {
     disabled?: boolean | ((row: T) => boolean);
 }
 
+type ExporterResult = {
+    url: string;
+} | Blob;
+type Exporter = (query: FetcherQuery) => Promise<ExporterResult>;
+
 /**
  * Column helper factory functions
  *
@@ -452,6 +479,16 @@ declare const col: {
     readonly custom: typeof custom;
 };
 
+interface BulkActionDef {
+    id: string;
+    label: string;
+    confirm?: {
+        title: string;
+        description?: string;
+    };
+    onClick: (selectedKeys: Array<string | number>) => void;
+}
+
 interface SmartTableProps<T> {
     /** Server-side data fetcher function */
     fetcher: Fetcher<T>;
@@ -473,6 +510,14 @@ interface SmartTableProps<T> {
     syncToUrl?: boolean;
     /** Stage C: Enable saved views feature (default: false) */
     enableSavedViews?: boolean;
+    /** Stage E: Enable row selection (default: false) */
+    enableRowSelection?: boolean;
+    /** Stage E: Selection change callback */
+    onSelectionChange?: (keys: Array<string | number>) => void;
+    /** Stage E: Bulk actions based on selection */
+    bulkActions?: BulkActionDef[];
+    /** Stage E: Export CSV (server-triggered) */
+    exporter?: Exporter;
 }
 /**
  * RowaKitTable - Server-side table component for internal/business apps.
@@ -525,7 +570,7 @@ interface SmartTableProps<T> {
  * }
  * ```
  */
-declare function RowaKitTable<T>({ fetcher, columns, defaultPageSize, pageSizeOptions, rowKey, className, enableFilters, enableColumnResizing, syncToUrl, enableSavedViews, }: SmartTableProps<T>): react_jsx_runtime.JSX.Element;
+declare function RowaKitTable<T>({ fetcher, columns, defaultPageSize, pageSizeOptions, rowKey, className, enableFilters, enableColumnResizing, syncToUrl, enableSavedViews, enableRowSelection, onSelectionChange, bulkActions, exporter, }: SmartTableProps<T>): react_jsx_runtime.JSX.Element;
 /**
  * @deprecated Use RowaKitTable instead. SmartTable is kept as an alias for backward compatibility.
  */
@@ -539,6 +584,6 @@ declare const SmartTable: typeof RowaKitTable;
  * @packageDocumentation
  */
 
-declare const VERSION = "0.1.0";
+declare const VERSION: string;
 
-export { type ActionDef, type ActionsColumnDef, type BadgeColumnDef, type BadgeTone, type BaseColumnDef, type BooleanColumnDef, type ColumnDef, type ColumnKind, type CustomColumnDef, type DateColumnDef, type Fetcher, type FetcherQuery, type FetcherResult, type FilterValue, type Filters, type NumberColumnDef, RowaKitTable, SmartTable, type SmartTableProps, type TextColumnDef, VERSION, col };
+export { type ActionDef, type ActionsColumnDef, type BadgeColumnDef, type BadgeTone, type BaseColumnDef, type BooleanColumnDef, type ColumnDef, type ColumnKind, type CustomColumnDef, type DateColumnDef, type Exporter, type ExporterResult, type Fetcher, type FetcherQuery, type FetcherResult, type FilterValue, type Filters, type NumberColumnDef, RowaKitTable, SmartTable, type SmartTableProps, type TextColumnDef, VERSION, col };