@xcelsior/ui-spreadsheets 1.1.4 → 1.1.6

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @xcelsior/ui-spreadsheets@1.0.14 build /Users/tuannguyen/Work/xcelsior-packages/packages/ui/ui-spreadsheets
+> @xcelsior/ui-spreadsheets@1.1.4 build /Users/tuannguyen/Work/xcelsior-packages/packages/ui/ui-spreadsheets
 > tsup && tsc --noEmit
 
 CLI Building entry: src/index.ts, src/styles/globals.css
@@ -11,18 +11,18 @@
 CJS Build start
 ESM Build start
 DTS Build start
-ESM dist/index.mjs              147.76 KB
-ESM dist/styles/globals.css     33.17 KB
-ESM dist/styles/globals.css.map 55.33 KB
-ESM dist/index.mjs.map          4.62 MB
-ESM ⚡️ Build success in 359ms
-CJS dist/styles/globals.css     33.17 KB
-CJS dist/index.js               158.96 KB
-CJS dist/styles/globals.css.map 55.33 KB
-CJS dist/index.js.map           4.62 MB
-CJS ⚡️ Build success in 360ms
-DTS ⚡️ Build success in 2017ms
+CJS dist/styles/globals.css     33.16 KB
+CJS dist/index.js               173.50 KB
+CJS dist/styles/globals.css.map 55.29 KB
+CJS dist/index.js.map           4.65 MB
+CJS ⚡️ Build success in 397ms
+ESM dist/styles/globals.css     33.16 KB
+ESM dist/index.mjs              162.16 KB
+ESM dist/styles/globals.css.map 55.29 KB
+ESM dist/index.mjs.map          4.65 MB
+ESM ⚡️ Build success in 396ms
+DTS ⚡️ Build success in 2168ms
 DTS dist/styles/globals.d.ts  13.00 B
-DTS dist/index.d.ts           22.84 KB
+DTS dist/index.d.ts           26.27 KB
 DTS dist/styles/globals.d.mts 13.00 B
-DTS dist/index.d.mts          22.84 KB
+DTS dist/index.d.mts          26.27 KB

package/.turbo/turbo-lint.log

@@ -1,6 +1,6 @@
 
-> @xcelsior/ui-spreadsheets@1.0.14 lint /Users/tuannguyen/Work/xcelsior-packages/packages/ui/ui-spreadsheets
-> biome check . && tsc
+> @xcelsior/ui-spreadsheets@1.1.4 lint /Users/tuannguyen/Work/xcelsior-packages/packages/ui/ui-spreadsheets
+> biome check . && tsc --noEmit
 
  at src/components/CommentModals.tsx:57:21 ]8;;https://biomejs.dev/linter/rules/no-autofocus\lint/a11y/noAutofocus]8;;\  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
@@ -22,102 +22,42 @@
      59  58 │                   <div className="flex justify-end gap-2 mt-4">
   
 
- at src/components/Spreadsheet.stories.tsx:333:34 ]8;;https://biomejs.dev/linter/rules/no-unused-function-parameters\lint/correctness/noUnusedFunctionParameters]8;;\  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-  ⚠ This parameter is unused.
-  
-    331 │         };
-    332 │ 
-  > 333 │         const handleRowDelete = (row: User, rowId: string | number) => {
-        │                                  ^^^
-    334 │             setData((prev) => prev.filter((r) => r.id !== rowId));
-    335 │         };
-  
-  ℹ Unused parameters might be the result of an incomplete refactoring.
-  
-  ℹ Unsafe fix: If this is intentional, prepend row with an underscore.
-  
-     331  331 │           };
-     332  332 │   
-     333      │ - ········const·handleRowDelete·=·(row:·User,·rowId:·string·|·number)·=>·{
-          333 │ + ········const·handleRowDelete·=·(_row:·User,·rowId:·string·|·number)·=>·{
-     334  334 │               setData((prev) => prev.filter((r) => r.id !== rowId));
-     335  335 │           };
-  
-
- at src/components/Spreadsheet.stories.tsx:385:34 ]8;;https://biomejs.dev/linter/rules/no-unused-function-parameters\lint/correctness/noUnusedFunctionParameters]8;;\  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-  ⚠ This parameter is unused.
-  
-    383 │         };
-    384 │ 
-  > 385 │         const handleRowDelete = (row: User, rowId: string | number) => {
-        │                                  ^^^
-    386 │             setData((prev) => prev.filter((r) => r.id !== rowId));
-    387 │         };
-  
-  ℹ Unused parameters might be the result of an incomplete refactoring.
-  
-  ℹ Unsafe fix: If this is intentional, prepend row with an underscore.
-  
-     383  383 │           };
-     384  384 │   
-     385      │ - ········const·handleRowDelete·=·(row:·User,·rowId:·string·|·number)·=>·{
-          385 │ + ········const·handleRowDelete·=·(_row:·User,·rowId:·string·|·number)·=>·{
-     386  386 │               setData((prev) => prev.filter((r) => r.id !== rowId));
-     387  387 │           };
-  
-
- at src/components/Spreadsheet.tsx:829:49 ]8;;https://biomejs.dev/linter/rules/use-key-with-click-events\lint/a11y/useKeyWithClickEvents]8;;\ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ at src/components/Spreadsheet.tsx:845:45 ]8;;https://biomejs.dev/linter/rules/use-key-with-click-events\lint/a11y/useKeyWithClickEvents]8;;\ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   ⚠ Enforce to have the onClick mouse event with the onKeyUp, the onKeyDown, or the onKeyPress keyboard event.
   
-    827 │                                             {/* Row Index Column */}
-    828 │                                             {effectiveShowRowIndex && (
-  > 829 │                                                 <td
-        │                                                 ^^^
-  > 830 │                                                     onClick={(e) => handleRowSelect(rowId, e)}
+    843 │                                         >
+    844 │                                             {/* Row Index Column */}
+  > 845 │                                             <td
+        │                                             ^^^
+  > 846 │                                                 onClick={(e) => handleRowSelect(rowId, e)}
          ...
-  > 856 │                                                     }}
-  > 857 │                                                 >
-        │                                                 ^
-    858 │                                                     <div className="relative flex items-center justify-center">
-    859 │                                                         {/* Row number - always centered */}
+  > 874 │                                                 }}
+  > 875 │                                             >
+        │                                             ^
+    876 │                                                 <div className="relative flex items-center justify-center w-full h-full">
+    877 │                                                     {/* Row number - centered */}
   
   ℹ Actions triggered using mouse events should have corresponding keyboard events to account for keyboard-only navigation.
   
 
- at src/components/Spreadsheet.tsx:27:15 ]8;;https://biomejs.dev/linter/rules/no-unused-imports\lint/correctness/noUnusedImports]8;;\  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ at src/components/Spreadsheet.tsx:29:15 ]8;;https://biomejs.dev/linter/rules/no-unused-imports\lint/correctness/noUnusedImports]8;;\  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   ⚠ Several of these imports are unused.
   
-    25 │ import { useSpreadsheetKeyboardShortcuts } from '../hooks/useSpreadsheetKeyboardShortcuts';
-    26 │ import { useSpreadsheetSelection } from '../hooks/useSpreadsheetSelection';
-  > 27 │ import type { CellEdit, CellPosition, SpreadsheetProps } from '../types';
-       │               ^^^^^^^^^^^^^^^^^^^^^^
-    28 │ 
-    29 │ type SingleCellEdit = {
+    27 │ import { useSpreadsheetKeyboardShortcuts } from '../hooks/useSpreadsheetKeyboardShortcuts';
+    28 │ import { useSpreadsheetSelection } from '../hooks/useSpreadsheetSelection';
+  > 29 │ import type { CellEdit, SpreadsheetProps } from '../types';
+       │               ^^^^^^^^
+    30 │ 
+    31 │ type SingleCellEdit = {
   
   ℹ Unused imports might be the result of an incomplete refactoring.
   
   ℹ Unsafe fix: Remove the unused imports.
   
-    27 │ import·type·{·CellEdit,·CellPosition,·SpreadsheetProps·}·from·'../types';
-       │               ------------------------                                   
-
- at src/components/Spreadsheet.tsx:329:9 ]8;;https://biomejs.dev/linter/rules/no-unused-variables\lint/correctness/noUnusedVariables]8;;\ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-  ⚠ This variable setFocusedCell is unused.
-  
-    327 │     const {
-    328 │         focusedCell,
-  > 329 │         setFocusedCell,
-        │         ^^^^^^^^^^^^^^
-    330 │         editingCell,
-    331 │         setEditingCell,
-  
-  ℹ Unused variables are often the result of typos, incomplete refactors, or other sources of bugs.
-  
+    29 │ import·type·{·CellEdit,·SpreadsheetProps·}·from·'../types';
+       │               ----------                                   
 
  at src/components/SpreadsheetCell.tsx:54:5 ]8;;https://biomejs.dev/linter/rules/no-unused-function-parameters\lint/correctness/noUnusedFunctionParameters]8;;\ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
@@ -192,5 +132,54 @@
     604 604 │   
   
 
-Checked 31 files in 18ms. No fixes applied.
-Found 10 warnings.
+ at src/components/Spreadsheet.stories.tsx format ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  ✖ Formatter would have printed the following content:
+  
+     489  489 │                   icon: <HiEye className="h-4 w-4" />,
+     490  490 │                   onClick: (row) => {
+     491      │ - ····················alert(`Viewing·user:·${row.name}\nEmail:·${row.email}\nDepartment:·${row.department}`);
+          491 │ + ····················alert(
+          492 │ + ························`Viewing·user:·${row.name}\nEmail:·${row.email}\nDepartment:·${row.department}`
+          493 │ + ····················);
+     492  494 │                   },
+     493  495 │               },
+    ········· │ 
+     533  535 │                   <div className="mb-4 text-sm text-gray-600">
+     534  536 │                       <p className="font-medium mb-2">Row Context Menu Example</p>
+     535      │ - ····················<p>Hover·over·a·row·and·click·the·3-dot·icon·(⋮)·to·see·the·context·menu·with·actions.</p>
+     536      │ - ····················<p·className="text-xs·mt-1·text-gray-500">Note:·Delete·is·only·visible·for·non-Active·users.</p>
+          537 │ + ····················<p>
+          538 │ + ························Hover·over·a·row·and·click·the·3-dot·icon·(⋮)·to·see·the·context·menu·with
+          539 │ + ························actions.
+          540 │ + ····················</p>
+          541 │ + ····················<p·className="text-xs·mt-1·text-gray-500">
+          542 │ + ························Note:·Delete·is·only·visible·for·non-Active·users.
+          543 │ + ····················</p>
+     537  544 │                   </div>
+     538  545 │                   <Spreadsheet
+  
+
+ at src/components/Spreadsheet.tsx format ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  ✖ Formatter would have printed the following content:
+  
+     887  887 │                                                                       rowId={rowId}
+     888  888 │                                                                       items={rowContextMenuItems}
+     889      │ - ····································································compactMode={effectiveCompactMode}
+          889 │ + ····································································compactMode={
+          890 │ + ········································································effectiveCompactMode
+          891 │ + ····································································}
+     890  892 │                                                                   />
+     891  893 │                                                               )}
+  
+
+Checked 31 files in 25ms. No fixes applied.
+Found 2 errors.
+Found 7 warnings.
+check ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  ✖ Some errors were emitted while running checks.
+  
+
+ ELIFECYCLE  Command failed with exit code 1.

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @xcelsior/ui-spreadsheets
 
+## 1.1.5
+
+### Patch Changes
+
+- 8db1f10: improve row context menu
+- Updated dependencies [8db1f10]
+  - @xcelsior/design-system@1.0.8
+
 ## 1.0.15
 
 ### Patch Changes

package/dist/index.d.mts

@@ -247,6 +247,28 @@ interface RowAction<T = any> {
     /** Custom className */
     className?: string;
 }
+/**
+ * Row context menu item configuration
+ * Used for the 3-dot menu that appears on row hover
+ */
+interface RowContextMenuItem<T = any> {
+    /** Unique identifier */
+    id: string;
+    /** Display label for the menu item */
+    label: string;
+    /** Icon component to display next to the label */
+    icon?: React$1.ReactNode;
+    /** Callback when menu item is clicked */
+    onClick: (row: T, rowId: string | number) => void;
+    /** Whether the menu item is visible */
+    visible?: (row: T) => boolean;
+    /** Whether the menu item is disabled */
+    disabled?: (row: T) => boolean;
+    /** Variant for styling (e.g., destructive for delete actions) */
+    variant?: 'default' | 'destructive';
+    /** Custom className */
+    className?: string;
+}
 /**
  * Props for the main Spreadsheet component
  */
@@ -271,10 +293,6 @@ interface SpreadsheetProps<T = any> {
     onRowClick?: (row: T, rowIndex: number) => void;
     /** Callback for row double click */
     onRowDoubleClick?: (row: T, rowIndex: number) => void;
-    /** Callback when a row is cloned/duplicated */
-    onRowClone?: (row: T, rowId: string | number) => void;
-    /** Callback when a row is deleted */
-    onRowDelete?: (row: T, rowId: string | number) => void;
     /** Callback when a cell comment is added */
     onAddCellComment?: (rowId: string | number, columnId: string, comment: string) => void;
     /** Callback when a comment's resolved status is toggled */
@@ -343,6 +361,12 @@ interface SpreadsheetProps<T = any> {
     cellComments?: CellComment[];
     /** Custom row actions to display in the index column */
     rowActions?: RowAction<T>[];
+    /**
+     * Context menu items to display in the 3-dot menu for each row.
+     * These appear in a dropdown when the user clicks the 3-dot icon on row hover.
+     * Use this for actions like clone, delete, view, edit, etc.
+     */
+    rowContextMenuItems?: RowContextMenuItem<T>[];
     /** Custom menu items to display in the toolbar's "More" dropdown menu */
     toolbarMenuItems?: ToolbarMenuItem[];
     /**
@@ -630,7 +654,7 @@ interface SpreadsheetColumnGroupHeaderProps {
  * />
  * ```
  */
-declare function Spreadsheet<T extends Record<string, any>>({ data, columns, columnGroups, getRowId, onCellsEdit, onSelectionChange, onSortChange, onFilterChange, onRowClick, onRowDoubleClick, onRowClone, onRowDelete, onAddCellComment, onToggleCommentResolved, onRowHighlight, onColumnHighlight, onCellHighlight, showToolbar, showPagination, enableRowSelection, enableCellEditing, enableComments, enableHighlighting, enableUndoRedo, pageSizeOptions, onSave, settings: initialSettings, onSettingsChange, isLoading, className, emptyMessage, rowHighlights: externalRowHighlights, columnHighlights: externalColumnHighlights, cellHighlights: externalCellHighlights, cellComments: externalCellComments, rowActions, toolbarMenuItems, serverSide, totalItems, currentPage: controlledCurrentPage, pageSize: controlledPageSize, sortConfig: controlledSortConfig, onPageChange, filters: controlledFilters, }: SpreadsheetProps<T>): react_jsx_runtime.JSX.Element;
+declare function Spreadsheet<T extends Record<string, any>>({ data, columns, columnGroups, getRowId, onCellsEdit, onSelectionChange, onSortChange, onFilterChange, onRowClick, onRowDoubleClick, onAddCellComment, onToggleCommentResolved, onRowHighlight, onColumnHighlight, onCellHighlight, showToolbar, showPagination, enableRowSelection, enableCellEditing, enableComments, enableHighlighting, enableUndoRedo, pageSizeOptions, onSave, settings: initialSettings, onSettingsChange, isLoading, className, emptyMessage, rowHighlights: externalRowHighlights, columnHighlights: externalColumnHighlights, cellHighlights: externalCellHighlights, cellComments: externalCellComments, rowActions, rowContextMenuItems, toolbarMenuItems, serverSide, totalItems, currentPage: controlledCurrentPage, pageSize: controlledPageSize, sortConfig: controlledSortConfig, onPageChange, filters: controlledFilters, }: SpreadsheetProps<T>): react_jsx_runtime.JSX.Element;
 declare namespace Spreadsheet {
     var displayName: string;
 }
@@ -740,4 +764,25 @@ interface SpreadsheetSettingsModalProps {
  */
 declare const SpreadsheetSettingsModal: React.FC<SpreadsheetSettingsModalProps>;
 
-export { type CellComment, type CellEdit, type CellHighlight, type CellPosition, type CellRange, type PaginationState, type RowAction, type SelectionEdge, type SelectionState, Spreadsheet, MemoizedSpreadsheetCell as SpreadsheetCell, type SpreadsheetCellProps, type SpreadsheetColumn, type SpreadsheetColumnFilter, type SpreadsheetColumnGroup, type SpreadsheetColumnGroupHeaderProps, SpreadsheetFilterDropdown, type SpreadsheetFilterDropdownProps, SpreadsheetHeader, type SpreadsheetHeaderProps, type SpreadsheetProps, type SpreadsheetSettings, SpreadsheetSettingsModal, type SpreadsheetSortConfig, type SpreadsheetState, SpreadsheetToolbar, type SpreadsheetToolbarProps, type ToolbarMenuItem };
+interface RowContextMenuProps<T = any> {
+    /** The row data */
+    row: T;
+    /** The row ID */
+    rowId: string | number;
+    /** Menu items to display */
+    items: RowContextMenuItem<T>[];
+    /** Whether compact mode is enabled */
+    compactMode?: boolean;
+    /** Custom className for the trigger button */
+    className?: string;
+}
+/**
+ * RowContextMenu component - A 3-dot menu that appears on row hover
+ * Displays a dropdown with action items (icons + text)
+ */
+declare function RowContextMenu<T>({ row, rowId, items, compactMode, className, }: RowContextMenuProps<T>): react_jsx_runtime.JSX.Element | null;
+declare namespace RowContextMenu {
+    var displayName: string;
+}
+
+export { type CellComment, type CellEdit, type CellHighlight, type CellPosition, type CellRange, type PaginationState, type RowAction, RowContextMenu, type RowContextMenuItem, type SelectionEdge, type SelectionState, Spreadsheet, MemoizedSpreadsheetCell as SpreadsheetCell, type SpreadsheetCellProps, type SpreadsheetColumn, type SpreadsheetColumnFilter, type SpreadsheetColumnGroup, type SpreadsheetColumnGroupHeaderProps, SpreadsheetFilterDropdown, type SpreadsheetFilterDropdownProps, SpreadsheetHeader, type SpreadsheetHeaderProps, type SpreadsheetProps, type SpreadsheetSettings, SpreadsheetSettingsModal, type SpreadsheetSortConfig, type SpreadsheetState, SpreadsheetToolbar, type SpreadsheetToolbarProps, type ToolbarMenuItem };

package/dist/index.d.ts

@@ -247,6 +247,28 @@ interface RowAction<T = any> {
     /** Custom className */
     className?: string;
 }
+/**
+ * Row context menu item configuration
+ * Used for the 3-dot menu that appears on row hover
+ */
+interface RowContextMenuItem<T = any> {
+    /** Unique identifier */
+    id: string;
+    /** Display label for the menu item */
+    label: string;
+    /** Icon component to display next to the label */
+    icon?: React$1.ReactNode;
+    /** Callback when menu item is clicked */
+    onClick: (row: T, rowId: string | number) => void;
+    /** Whether the menu item is visible */
+    visible?: (row: T) => boolean;
+    /** Whether the menu item is disabled */
+    disabled?: (row: T) => boolean;
+    /** Variant for styling (e.g., destructive for delete actions) */
+    variant?: 'default' | 'destructive';
+    /** Custom className */
+    className?: string;
+}
 /**
  * Props for the main Spreadsheet component
  */
@@ -271,10 +293,6 @@ interface SpreadsheetProps<T = any> {
     onRowClick?: (row: T, rowIndex: number) => void;
     /** Callback for row double click */
     onRowDoubleClick?: (row: T, rowIndex: number) => void;
-    /** Callback when a row is cloned/duplicated */
-    onRowClone?: (row: T, rowId: string | number) => void;
-    /** Callback when a row is deleted */
-    onRowDelete?: (row: T, rowId: string | number) => void;
     /** Callback when a cell comment is added */
     onAddCellComment?: (rowId: string | number, columnId: string, comment: string) => void;
     /** Callback when a comment's resolved status is toggled */
@@ -343,6 +361,12 @@ interface SpreadsheetProps<T = any> {
     cellComments?: CellComment[];
     /** Custom row actions to display in the index column */
     rowActions?: RowAction<T>[];
+    /**
+     * Context menu items to display in the 3-dot menu for each row.
+     * These appear in a dropdown when the user clicks the 3-dot icon on row hover.
+     * Use this for actions like clone, delete, view, edit, etc.
+     */
+    rowContextMenuItems?: RowContextMenuItem<T>[];
     /** Custom menu items to display in the toolbar's "More" dropdown menu */
     toolbarMenuItems?: ToolbarMenuItem[];
     /**
@@ -630,7 +654,7 @@ interface SpreadsheetColumnGroupHeaderProps {
  * />
  * ```
  */
-declare function Spreadsheet<T extends Record<string, any>>({ data, columns, columnGroups, getRowId, onCellsEdit, onSelectionChange, onSortChange, onFilterChange, onRowClick, onRowDoubleClick, onRowClone, onRowDelete, onAddCellComment, onToggleCommentResolved, onRowHighlight, onColumnHighlight, onCellHighlight, showToolbar, showPagination, enableRowSelection, enableCellEditing, enableComments, enableHighlighting, enableUndoRedo, pageSizeOptions, onSave, settings: initialSettings, onSettingsChange, isLoading, className, emptyMessage, rowHighlights: externalRowHighlights, columnHighlights: externalColumnHighlights, cellHighlights: externalCellHighlights, cellComments: externalCellComments, rowActions, toolbarMenuItems, serverSide, totalItems, currentPage: controlledCurrentPage, pageSize: controlledPageSize, sortConfig: controlledSortConfig, onPageChange, filters: controlledFilters, }: SpreadsheetProps<T>): react_jsx_runtime.JSX.Element;
+declare function Spreadsheet<T extends Record<string, any>>({ data, columns, columnGroups, getRowId, onCellsEdit, onSelectionChange, onSortChange, onFilterChange, onRowClick, onRowDoubleClick, onAddCellComment, onToggleCommentResolved, onRowHighlight, onColumnHighlight, onCellHighlight, showToolbar, showPagination, enableRowSelection, enableCellEditing, enableComments, enableHighlighting, enableUndoRedo, pageSizeOptions, onSave, settings: initialSettings, onSettingsChange, isLoading, className, emptyMessage, rowHighlights: externalRowHighlights, columnHighlights: externalColumnHighlights, cellHighlights: externalCellHighlights, cellComments: externalCellComments, rowActions, rowContextMenuItems, toolbarMenuItems, serverSide, totalItems, currentPage: controlledCurrentPage, pageSize: controlledPageSize, sortConfig: controlledSortConfig, onPageChange, filters: controlledFilters, }: SpreadsheetProps<T>): react_jsx_runtime.JSX.Element;
 declare namespace Spreadsheet {
     var displayName: string;
 }
@@ -740,4 +764,25 @@ interface SpreadsheetSettingsModalProps {
  */
 declare const SpreadsheetSettingsModal: React.FC<SpreadsheetSettingsModalProps>;
 
-export { type CellComment, type CellEdit, type CellHighlight, type CellPosition, type CellRange, type PaginationState, type RowAction, type SelectionEdge, type SelectionState, Spreadsheet, MemoizedSpreadsheetCell as SpreadsheetCell, type SpreadsheetCellProps, type SpreadsheetColumn, type SpreadsheetColumnFilter, type SpreadsheetColumnGroup, type SpreadsheetColumnGroupHeaderProps, SpreadsheetFilterDropdown, type SpreadsheetFilterDropdownProps, SpreadsheetHeader, type SpreadsheetHeaderProps, type SpreadsheetProps, type SpreadsheetSettings, SpreadsheetSettingsModal, type SpreadsheetSortConfig, type SpreadsheetState, SpreadsheetToolbar, type SpreadsheetToolbarProps, type ToolbarMenuItem };
+interface RowContextMenuProps<T = any> {
+    /** The row data */
+    row: T;
+    /** The row ID */
+    rowId: string | number;
+    /** Menu items to display */
+    items: RowContextMenuItem<T>[];
+    /** Whether compact mode is enabled */
+    compactMode?: boolean;
+    /** Custom className for the trigger button */
+    className?: string;
+}
+/**
+ * RowContextMenu component - A 3-dot menu that appears on row hover
+ * Displays a dropdown with action items (icons + text)
+ */
+declare function RowContextMenu<T>({ row, rowId, items, compactMode, className, }: RowContextMenuProps<T>): react_jsx_runtime.JSX.Element | null;
+declare namespace RowContextMenu {
+    var displayName: string;
+}
+
+export { type CellComment, type CellEdit, type CellHighlight, type CellPosition, type CellRange, type PaginationState, type RowAction, RowContextMenu, type RowContextMenuItem, type SelectionEdge, type SelectionState, Spreadsheet, MemoizedSpreadsheetCell as SpreadsheetCell, type SpreadsheetCellProps, type SpreadsheetColumn, type SpreadsheetColumnFilter, type SpreadsheetColumnGroup, type SpreadsheetColumnGroupHeaderProps, SpreadsheetFilterDropdown, type SpreadsheetFilterDropdownProps, SpreadsheetHeader, type SpreadsheetHeaderProps, type SpreadsheetProps, type SpreadsheetSettings, SpreadsheetSettingsModal, type SpreadsheetSortConfig, type SpreadsheetState, SpreadsheetToolbar, type SpreadsheetToolbarProps, type ToolbarMenuItem };