bolt-table 0.1.35 → 0.1.37

package/dist/index.d.mts

@@ -22,6 +22,9 @@ interface BoltTableIcons {
     search?: React$1.ReactNode;
     columns?: React$1.ReactNode;
     close?: React$1.ReactNode;
+    sparkles?: React$1.ReactNode;
+    send?: React$1.ReactNode;
+    loader?: React$1.ReactNode;
 }
 
 /** `'asc'` | `'desc'` | `null` — the direction of a column sort. */
@@ -84,31 +87,52 @@ interface ColumnType<T = unknown> {
 interface CellContextMenuItem<T = unknown> {
     /** Unique identifier for this menu item, used as the React `key`. */
     key: string;
-    /** The label shown in the menu. Can be a string or React node. */
-    label: React.ReactNode;
-    /** Optional icon shown to the left of the label. */
-    icon?: React.ReactNode;
+    /**
+     * The label shown in the menu. Can be a string, React node, or a function
+     * `(columnKey, record, rowIndex) => ReactNode` that returns a custom node
+     * derived from the row being clicked.
+     */
+    label: React.ReactNode | ((columnKey: string, record: T, rowIndex: number) => React.ReactNode);
+    /**
+     * Optional icon shown to the left of the label. Can be a React node or a
+     * function `(columnKey, record, rowIndex) => ReactNode` for row-aware icons.
+     */
+    icon?: React.ReactNode | ((columnKey: string, record: T, rowIndex: number) => React.ReactNode);
     /** When `true`, the label renders in red to indicate a destructive action. */
     danger?: boolean;
     /** When `true`, the item is grayed out and click handler is not called. */
     disabled?: boolean;
-    /** Called when the user clicks this menu item. Receives the column key, row record, and row index. */
-    onClick: (columnKey: string, record: T, rowIndex: number) => void;
+    /**
+     * Called when the user clicks this menu item. Receives the column key, row
+     * record, and row index. Optional — omit if the item's label renders its
+     * own interactive content (e.g. a custom React node that handles clicks).
+     */
+    onClick?: (columnKey: string, record: T, rowIndex: number) => void;
 }
 /** A single item in the column header right-click context menu. */
 interface ColumnContextMenuItem {
     /** Unique identifier for this menu item, used as the React `key`. */
     key: string;
-    /** The label shown in the menu. Can be a string or React node. */
-    label: React.ReactNode;
-    /** Optional icon shown to the left of the label. */
-    icon?: React.ReactNode;
+    /**
+     * The label shown in the menu. Can be a string, React node, or a function
+     * `(columnKey) => ReactNode` that returns a custom node derived from the
+     * column being clicked.
+     */
+    label: React.ReactNode | ((columnKey: string) => React.ReactNode);
+    /**
+     * Optional icon shown to the left of the label. Can be a React node or a
+     * function `(columnKey) => ReactNode` for column-aware icons.
+     */
+    icon?: React.ReactNode | ((columnKey: string) => React.ReactNode);
     /** When `true`, the label renders in red to indicate a destructive action. */
     danger?: boolean;
     /** When `true`, the item is grayed out and click handler is not called. */
     disabled?: boolean;
-    /** Called when the user clicks this menu item. Receives the column `key`. */
-    onClick: (columnKey: string) => void;
+    /**
+     * Called when the user clicks this menu item. Receives the column `key`.
+     * Optional — omit if the item's label renders its own interactive content.
+     */
+    onClick?: (columnKey: string) => void;
 }
 /** How the row selection was triggered: `'all'`, `'single'`, or `'multiple'`. */
 type RowSelectMethod = "all" | "single" | "multiple";
@@ -187,6 +211,68 @@ interface ColumnPersistenceConfig {
     /** Persist column pinned state. Defaults to `true`. */
     persistPinned?: boolean;
 }
+/** Supported comparison operators for AI-generated conditions. */
+type AIOperator = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "contains" | "notContains" | "startsWith" | "endsWith" | "in" | "notIn";
+/** A single condition produced by the AI. */
+interface AICondition {
+    column: string;
+    op: AIOperator;
+    value: unknown;
+}
+/** Filter rows matching conditions. */
+interface AIFilterOperation {
+    type: "filter";
+    conditions: AICondition[];
+    logic?: "and" | "or";
+}
+/** Apply inline styles to rows matching conditions. */
+interface AIStyleOperation {
+    type: "rowStyle";
+    conditions: AICondition[];
+    logic?: "and" | "or";
+    style: Record<string, string>;
+}
+/** Apply inline styles to specific cells matching conditions. */
+interface AICellStyleOperation {
+    type: "cellStyle";
+    column: string;
+    conditions: AICondition[];
+    logic?: "and" | "or";
+    style: Record<string, string>;
+}
+/** Sort data by a column. */
+interface AISortOperation {
+    type: "sort";
+    column: string;
+    direction: "asc" | "desc";
+}
+/** Hide or show specific columns. */
+interface AIColumnVisibilityOperation {
+    type: "hideColumns" | "showColumns";
+    columns: string[];
+}
+/** Union of all possible AI operations. */
+type AIOperation = AIFilterOperation | AIStyleOperation | AICellStyleOperation | AISortOperation | AIColumnVisibilityOperation;
+/** The structured response returned by the AI. */
+interface AIResponse {
+    operations: AIOperation[];
+    message: string;
+}
+/** AI provider configuration. */
+interface BoltTableAIConfig {
+    provider: "openai" | "anthropic" | "custom";
+    apiKey: string;
+    model?: string;
+    baseUrl?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+/** Top-level configuration for bolt-table.config.ts files. */
+interface BoltTableConfig {
+    ai?: BoltTableAIConfig;
+}
+/** Helper for type-safe bolt-table.config.ts files. */
+declare function defineConfig(config: BoltTableConfig): BoltTableConfig;
 
 interface BoltTableProps<T extends DataRecord = DataRecord> {
     /** Column definitions controlling what columns are shown, their order, width, pinning, sort/filter, and rendering. */
@@ -285,6 +371,21 @@ interface BoltTableProps<T extends DataRecord = DataRecord> {
     readonly toolbarContent?: React$1.ReactNode;
     /** Label for the column-settings button. Defaults to "Columns". */
     readonly columnSettingsLabel?: React$1.ReactNode;
+    /** Enable the AI assistant button in the toolbar. Requires `aiConfig` or `onAIQuery`. */
+    readonly aiMode?: boolean;
+    /** AI provider configuration (API key, model, etc.). Used by the built-in AI handler. */
+    readonly aiConfig?: BoltTableAIConfig;
+    /** Custom AI query handler. When provided, overrides the built-in AI call. Return an `AIResponse` with operations to apply. */
+    readonly onAIQuery?: (query: string, context: {
+        data: T[];
+        columns: ColumnType<T>[];
+    }) => Promise<AIResponse>;
+    /** Called after the AI applies operations. Receives the parsed response. */
+    readonly onAIResponse?: (response: AIResponse) => void;
+    /** Placeholder text for the AI search bar. */
+    readonly aiPlaceholder?: string;
+    /** Label for the AI button. Defaults to "Ask AI". */
+    readonly aiButtonLabel?: React$1.ReactNode;
 }
 interface ClassNamesTypes {
     /** Applied to all non-pinned column header cells. */
@@ -352,7 +453,7 @@ interface StylesTypes {
     /** Inline styles for the "X–Y of Z" info text. */
     paginationInfo?: CSSProperties;
 }
-declare function BoltTable<T extends DataRecord = DataRecord>({ columns: rawInitialColumns, data: rawData, rowHeight, expandedRowHeight, maxExpandedRowHeight, accentColor, className, classNames, styles, gripIcon, hideGripIcon, icons, pagination, onPaginationChange, onColumnResize, onColumnOrderChange, onColumnPin, onColumnHide, rowSelection, rowPinning, onRowPin, expandable, rowKey, onEndReached, onEndReachedThreshold, isLoading, onSortChange, onFilterChange, columnContextMenuItems, autoHeight, layoutLoading, emptyRenderer, rowClassName, rowStyle, disabledFilters, onCopy, keepPinnedRowsAcrossPages, onEdit, onRowClick, enableColumnVirtualization, enableDynamicRowHeight, columnPersistence, showColumnSettings, hideGlobalSearch, globalSearchValue, onGlobalSearchChange, toolbarContent, columnSettingsLabel, }: BoltTableProps<T>): react_jsx_runtime.JSX.Element;
+declare function BoltTable<T extends DataRecord = DataRecord>({ columns: rawInitialColumns, data: rawData, rowHeight, expandedRowHeight, maxExpandedRowHeight, accentColor, className, classNames, styles, gripIcon, hideGripIcon, icons, pagination, onPaginationChange, onColumnResize, onColumnOrderChange, onColumnPin, onColumnHide, rowSelection, rowPinning, onRowPin, expandable, rowKey, onEndReached, onEndReachedThreshold, isLoading, onSortChange, onFilterChange, columnContextMenuItems, autoHeight, layoutLoading, emptyRenderer, rowClassName, rowStyle, disabledFilters, onCopy, keepPinnedRowsAcrossPages, onEdit, onRowClick, enableColumnVirtualization, enableDynamicRowHeight, columnPersistence, showColumnSettings, hideGlobalSearch, globalSearchValue, onGlobalSearchChange, toolbarContent, columnSettingsLabel, aiMode, aiConfig, onAIQuery, onAIResponse, aiPlaceholder, aiButtonLabel, }: BoltTableProps<T>): react_jsx_runtime.JSX.Element;
 
 interface DraggableHeaderProps {
     /** Column definition for this header cell. */
@@ -489,7 +590,9 @@ interface TableBodyProps {
     onRowHeightChange?: (index: number, height: number) => void;
     /** Maps column key → 1-based CSS grid column index in the full (non-virtualized) grid. Required for correct placement when column virtualization is enabled. */
     columnGridIndexMap?: Map<string, number>;
+    /** Optional AI cell style function. Returns extra styles for a specific cell. */
+    cellStyleFn?: (record: DataRecord, columnKey: string) => React$1.CSSProperties | undefined;
 }
 declare const TableBody: React$1.FC<TableBodyProps>;
 
-export { BoltTable, type BoltTableIcons, type CellContextMenuItem, type ClassNamesTypes, type ColumnContextMenuItem, type ColumnPersistenceConfig, type ColumnType, type DataRecord, DraggableHeader, type ExpandableConfig, type PaginationType, ResizeOverlay, type RowPinningConfig, type RowSelectionConfig, type SortDirection, type StylesTypes, TableBody };
+export { type AICellStyleOperation, type AIColumnVisibilityOperation, type AICondition, type AIFilterOperation, type AIOperation, type AIOperator, type AIResponse, type AISortOperation, type AIStyleOperation, BoltTable, type BoltTableAIConfig, type BoltTableConfig, type BoltTableIcons, type CellContextMenuItem, type ClassNamesTypes, type ColumnContextMenuItem, type ColumnPersistenceConfig, type ColumnType, type DataRecord, DraggableHeader, type ExpandableConfig, type PaginationType, ResizeOverlay, type RowPinningConfig, type RowSelectionConfig, type SortDirection, type StylesTypes, TableBody, defineConfig };

package/dist/index.d.ts

@@ -22,6 +22,9 @@ interface BoltTableIcons {
     search?: React$1.ReactNode;
     columns?: React$1.ReactNode;
     close?: React$1.ReactNode;
+    sparkles?: React$1.ReactNode;
+    send?: React$1.ReactNode;
+    loader?: React$1.ReactNode;
 }
 
 /** `'asc'` | `'desc'` | `null` — the direction of a column sort. */
@@ -84,31 +87,52 @@ interface ColumnType<T = unknown> {
 interface CellContextMenuItem<T = unknown> {
     /** Unique identifier for this menu item, used as the React `key`. */
     key: string;
-    /** The label shown in the menu. Can be a string or React node. */
-    label: React.ReactNode;
-    /** Optional icon shown to the left of the label. */
-    icon?: React.ReactNode;
+    /**
+     * The label shown in the menu. Can be a string, React node, or a function
+     * `(columnKey, record, rowIndex) => ReactNode` that returns a custom node
+     * derived from the row being clicked.
+     */
+    label: React.ReactNode | ((columnKey: string, record: T, rowIndex: number) => React.ReactNode);
+    /**
+     * Optional icon shown to the left of the label. Can be a React node or a
+     * function `(columnKey, record, rowIndex) => ReactNode` for row-aware icons.
+     */
+    icon?: React.ReactNode | ((columnKey: string, record: T, rowIndex: number) => React.ReactNode);
     /** When `true`, the label renders in red to indicate a destructive action. */
     danger?: boolean;
     /** When `true`, the item is grayed out and click handler is not called. */
     disabled?: boolean;
-    /** Called when the user clicks this menu item. Receives the column key, row record, and row index. */
-    onClick: (columnKey: string, record: T, rowIndex: number) => void;
+    /**
+     * Called when the user clicks this menu item. Receives the column key, row
+     * record, and row index. Optional — omit if the item's label renders its
+     * own interactive content (e.g. a custom React node that handles clicks).
+     */
+    onClick?: (columnKey: string, record: T, rowIndex: number) => void;
 }
 /** A single item in the column header right-click context menu. */
 interface ColumnContextMenuItem {
     /** Unique identifier for this menu item, used as the React `key`. */
     key: string;
-    /** The label shown in the menu. Can be a string or React node. */
-    label: React.ReactNode;
-    /** Optional icon shown to the left of the label. */
-    icon?: React.ReactNode;
+    /**
+     * The label shown in the menu. Can be a string, React node, or a function
+     * `(columnKey) => ReactNode` that returns a custom node derived from the
+     * column being clicked.
+     */
+    label: React.ReactNode | ((columnKey: string) => React.ReactNode);
+    /**
+     * Optional icon shown to the left of the label. Can be a React node or a
+     * function `(columnKey) => ReactNode` for column-aware icons.
+     */
+    icon?: React.ReactNode | ((columnKey: string) => React.ReactNode);
     /** When `true`, the label renders in red to indicate a destructive action. */
     danger?: boolean;
     /** When `true`, the item is grayed out and click handler is not called. */
     disabled?: boolean;
-    /** Called when the user clicks this menu item. Receives the column `key`. */
-    onClick: (columnKey: string) => void;
+    /**
+     * Called when the user clicks this menu item. Receives the column `key`.
+     * Optional — omit if the item's label renders its own interactive content.
+     */
+    onClick?: (columnKey: string) => void;
 }
 /** How the row selection was triggered: `'all'`, `'single'`, or `'multiple'`. */
 type RowSelectMethod = "all" | "single" | "multiple";
@@ -187,6 +211,68 @@ interface ColumnPersistenceConfig {
     /** Persist column pinned state. Defaults to `true`. */
     persistPinned?: boolean;
 }
+/** Supported comparison operators for AI-generated conditions. */
+type AIOperator = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "contains" | "notContains" | "startsWith" | "endsWith" | "in" | "notIn";
+/** A single condition produced by the AI. */
+interface AICondition {
+    column: string;
+    op: AIOperator;
+    value: unknown;
+}
+/** Filter rows matching conditions. */
+interface AIFilterOperation {
+    type: "filter";
+    conditions: AICondition[];
+    logic?: "and" | "or";
+}
+/** Apply inline styles to rows matching conditions. */
+interface AIStyleOperation {
+    type: "rowStyle";
+    conditions: AICondition[];
+    logic?: "and" | "or";
+    style: Record<string, string>;
+}
+/** Apply inline styles to specific cells matching conditions. */
+interface AICellStyleOperation {
+    type: "cellStyle";
+    column: string;
+    conditions: AICondition[];
+    logic?: "and" | "or";
+    style: Record<string, string>;
+}
+/** Sort data by a column. */
+interface AISortOperation {
+    type: "sort";
+    column: string;
+    direction: "asc" | "desc";
+}
+/** Hide or show specific columns. */
+interface AIColumnVisibilityOperation {
+    type: "hideColumns" | "showColumns";
+    columns: string[];
+}
+/** Union of all possible AI operations. */
+type AIOperation = AIFilterOperation | AIStyleOperation | AICellStyleOperation | AISortOperation | AIColumnVisibilityOperation;
+/** The structured response returned by the AI. */
+interface AIResponse {
+    operations: AIOperation[];
+    message: string;
+}
+/** AI provider configuration. */
+interface BoltTableAIConfig {
+    provider: "openai" | "anthropic" | "custom";
+    apiKey: string;
+    model?: string;
+    baseUrl?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+/** Top-level configuration for bolt-table.config.ts files. */
+interface BoltTableConfig {
+    ai?: BoltTableAIConfig;
+}
+/** Helper for type-safe bolt-table.config.ts files. */
+declare function defineConfig(config: BoltTableConfig): BoltTableConfig;
 
 interface BoltTableProps<T extends DataRecord = DataRecord> {
     /** Column definitions controlling what columns are shown, their order, width, pinning, sort/filter, and rendering. */
@@ -285,6 +371,21 @@ interface BoltTableProps<T extends DataRecord = DataRecord> {
     readonly toolbarContent?: React$1.ReactNode;
     /** Label for the column-settings button. Defaults to "Columns". */
     readonly columnSettingsLabel?: React$1.ReactNode;
+    /** Enable the AI assistant button in the toolbar. Requires `aiConfig` or `onAIQuery`. */
+    readonly aiMode?: boolean;
+    /** AI provider configuration (API key, model, etc.). Used by the built-in AI handler. */
+    readonly aiConfig?: BoltTableAIConfig;
+    /** Custom AI query handler. When provided, overrides the built-in AI call. Return an `AIResponse` with operations to apply. */
+    readonly onAIQuery?: (query: string, context: {
+        data: T[];
+        columns: ColumnType<T>[];
+    }) => Promise<AIResponse>;
+    /** Called after the AI applies operations. Receives the parsed response. */
+    readonly onAIResponse?: (response: AIResponse) => void;
+    /** Placeholder text for the AI search bar. */
+    readonly aiPlaceholder?: string;
+    /** Label for the AI button. Defaults to "Ask AI". */
+    readonly aiButtonLabel?: React$1.ReactNode;
 }
 interface ClassNamesTypes {
     /** Applied to all non-pinned column header cells. */
@@ -352,7 +453,7 @@ interface StylesTypes {
     /** Inline styles for the "X–Y of Z" info text. */
     paginationInfo?: CSSProperties;
 }
-declare function BoltTable<T extends DataRecord = DataRecord>({ columns: rawInitialColumns, data: rawData, rowHeight, expandedRowHeight, maxExpandedRowHeight, accentColor, className, classNames, styles, gripIcon, hideGripIcon, icons, pagination, onPaginationChange, onColumnResize, onColumnOrderChange, onColumnPin, onColumnHide, rowSelection, rowPinning, onRowPin, expandable, rowKey, onEndReached, onEndReachedThreshold, isLoading, onSortChange, onFilterChange, columnContextMenuItems, autoHeight, layoutLoading, emptyRenderer, rowClassName, rowStyle, disabledFilters, onCopy, keepPinnedRowsAcrossPages, onEdit, onRowClick, enableColumnVirtualization, enableDynamicRowHeight, columnPersistence, showColumnSettings, hideGlobalSearch, globalSearchValue, onGlobalSearchChange, toolbarContent, columnSettingsLabel, }: BoltTableProps<T>): react_jsx_runtime.JSX.Element;
+declare function BoltTable<T extends DataRecord = DataRecord>({ columns: rawInitialColumns, data: rawData, rowHeight, expandedRowHeight, maxExpandedRowHeight, accentColor, className, classNames, styles, gripIcon, hideGripIcon, icons, pagination, onPaginationChange, onColumnResize, onColumnOrderChange, onColumnPin, onColumnHide, rowSelection, rowPinning, onRowPin, expandable, rowKey, onEndReached, onEndReachedThreshold, isLoading, onSortChange, onFilterChange, columnContextMenuItems, autoHeight, layoutLoading, emptyRenderer, rowClassName, rowStyle, disabledFilters, onCopy, keepPinnedRowsAcrossPages, onEdit, onRowClick, enableColumnVirtualization, enableDynamicRowHeight, columnPersistence, showColumnSettings, hideGlobalSearch, globalSearchValue, onGlobalSearchChange, toolbarContent, columnSettingsLabel, aiMode, aiConfig, onAIQuery, onAIResponse, aiPlaceholder, aiButtonLabel, }: BoltTableProps<T>): react_jsx_runtime.JSX.Element;
 
 interface DraggableHeaderProps {
     /** Column definition for this header cell. */
@@ -489,7 +590,9 @@ interface TableBodyProps {
     onRowHeightChange?: (index: number, height: number) => void;
     /** Maps column key → 1-based CSS grid column index in the full (non-virtualized) grid. Required for correct placement when column virtualization is enabled. */
     columnGridIndexMap?: Map<string, number>;
+    /** Optional AI cell style function. Returns extra styles for a specific cell. */
+    cellStyleFn?: (record: DataRecord, columnKey: string) => React$1.CSSProperties | undefined;
 }
 declare const TableBody: React$1.FC<TableBodyProps>;
 
-export { BoltTable, type BoltTableIcons, type CellContextMenuItem, type ClassNamesTypes, type ColumnContextMenuItem, type ColumnPersistenceConfig, type ColumnType, type DataRecord, DraggableHeader, type ExpandableConfig, type PaginationType, ResizeOverlay, type RowPinningConfig, type RowSelectionConfig, type SortDirection, type StylesTypes, TableBody };
+export { type AICellStyleOperation, type AIColumnVisibilityOperation, type AICondition, type AIFilterOperation, type AIOperation, type AIOperator, type AIResponse, type AISortOperation, type AIStyleOperation, BoltTable, type BoltTableAIConfig, type BoltTableConfig, type BoltTableIcons, type CellContextMenuItem, type ClassNamesTypes, type ColumnContextMenuItem, type ColumnPersistenceConfig, type ColumnType, type DataRecord, DraggableHeader, type ExpandableConfig, type PaginationType, ResizeOverlay, type RowPinningConfig, type RowSelectionConfig, type SortDirection, type StylesTypes, TableBody, defineConfig };