bolt-table 0.1.36 → 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. */
@@ -208,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. */
@@ -306,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. */
@@ -373,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. */
@@ -510,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. */
@@ -208,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. */
@@ -306,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. */
@@ -373,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. */
@@ -510,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 };