bolt-table 0.1.22 → 0.1.23

package/dist/index.d.mts

@@ -238,6 +238,10 @@ interface BoltTableProps<T extends DataRecord = DataRecord> {
     readonly rowStyle?: (record: T, index: number) => React$1.CSSProperties;
     /** When true, removes the filter option from all header column context menus. */
     readonly disabledFilters?: boolean;
+    /** Called after a cell value is copied to the clipboard via the context menu. */
+    readonly onCopy?: (text: string, columnKey: string, record: T, rowIndex: number) => void;
+    /** When true, pinned rows remain visible even after navigating to a different page. */
+    readonly keepPinnedRowsAcrossPages?: boolean;
 }
 interface ClassNamesTypes {
     /** Applied to all non-pinned column header cells. */
@@ -285,7 +289,7 @@ interface StylesTypes {
     /** Inline styles applied to built-in context menu items (sort, filter, pin, copy, etc.). */
     contextMenuItem?: 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, }: 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, }: BoltTableProps<T>): react_jsx_runtime.JSX.Element;
 
 interface DraggableHeaderProps {
     /** Column definition for this header cell. */

package/dist/index.d.ts

@@ -238,6 +238,10 @@ interface BoltTableProps<T extends DataRecord = DataRecord> {
     readonly rowStyle?: (record: T, index: number) => React$1.CSSProperties;
     /** When true, removes the filter option from all header column context menus. */
     readonly disabledFilters?: boolean;
+    /** Called after a cell value is copied to the clipboard via the context menu. */
+    readonly onCopy?: (text: string, columnKey: string, record: T, rowIndex: number) => void;
+    /** When true, pinned rows remain visible even after navigating to a different page. */
+    readonly keepPinnedRowsAcrossPages?: boolean;
 }
 interface ClassNamesTypes {
     /** Applied to all non-pinned column header cells. */
@@ -285,7 +289,7 @@ interface StylesTypes {
     /** Inline styles applied to built-in context menu items (sort, filter, pin, copy, etc.). */
     contextMenuItem?: 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, }: 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, }: BoltTableProps<T>): react_jsx_runtime.JSX.Element;
 
 interface DraggableHeaderProps {
     /** Column definition for this header cell. */

package/dist/index.js

@@ -1511,7 +1511,9 @@ function BoltTable({
   emptyRenderer,
   rowClassName,
   rowStyle,
-  disabledFilters
+  disabledFilters,
+  onCopy,
+  keepPinnedRowsAcrossPages
 }) {
   const data = (0, import_react4.useMemo)(() => {
     if (!Array.isArray(rawData)) return STABLE_EMPTY_DATA;
@@ -2126,8 +2128,10 @@ function BoltTable({
     }
     return result;
   }, [data, sortState, columnFilters]);
+  const pinnedRowCacheRef = (0, import_react4.useRef)(/* @__PURE__ */ new Map());
   const { pinnedTopRows, pinnedBottomRows, unpinnedProcessedData } = (0, import_react4.useMemo)(() => {
     if (!resolvedRowPinning || !resolvedRowPinning.top?.length && !resolvedRowPinning.bottom?.length) {
+      if (keepPinnedRowsAcrossPages) pinnedRowCacheRef.current.clear();
       return {
         pinnedTopRows: [],
         pinnedBottomRows: [],
@@ -2142,10 +2146,32 @@ function BoltTable({
     processedData.forEach((row, idx) => {
       if (row == null) return;
       const key = getRowKey(row, idx);
-      if (topKeySet.has(key)) topMap.set(key, row);
-      else if (bottomKeySet.has(key)) bottomMap.set(key, row);
-      else rest.push(row);
+      if (topKeySet.has(key)) {
+        topMap.set(key, row);
+        if (keepPinnedRowsAcrossPages) pinnedRowCacheRef.current.set(key, row);
+      } else if (bottomKeySet.has(key)) {
+        bottomMap.set(key, row);
+        if (keepPinnedRowsAcrossPages) pinnedRowCacheRef.current.set(key, row);
+      } else {
+        rest.push(row);
+      }
     });
+    if (keepPinnedRowsAcrossPages) {
+      for (const k of topKeySet) {
+        if (!topMap.has(k) && pinnedRowCacheRef.current.has(k)) {
+          topMap.set(k, pinnedRowCacheRef.current.get(k));
+        }
+      }
+      for (const k of bottomKeySet) {
+        if (!bottomMap.has(k) && pinnedRowCacheRef.current.has(k)) {
+          bottomMap.set(k, pinnedRowCacheRef.current.get(k));
+        }
+      }
+      const allPinnedKeys = /* @__PURE__ */ new Set([...topKeySet, ...bottomKeySet]);
+      for (const cachedKey of pinnedRowCacheRef.current.keys()) {
+        if (!allPinnedKeys.has(cachedKey)) pinnedRowCacheRef.current.delete(cachedKey);
+      }
+    }
     const orderedTop = (resolvedRowPinning.top ?? []).map((k) => topMap.get(String(k))).filter((r) => r !== void 0);
     const orderedBottom = (resolvedRowPinning.bottom ?? []).map((k) => bottomMap.get(String(k))).filter((r) => r !== void 0);
     return {
@@ -2153,7 +2179,7 @@ function BoltTable({
       pinnedBottomRows: orderedBottom,
       unpinnedProcessedData: rest
     };
-  }, [processedData, resolvedRowPinning, getRowKey]);
+  }, [processedData, resolvedRowPinning, getRowKey, keepPinnedRowsAcrossPages]);
   const pinnedTopHeight = pinnedTopRows.length * rowHeight;
   const pinnedBottomHeight = pinnedBottomRows.length * rowHeight;
   const pinnedTopKeySet = (0, import_react4.useMemo)(
@@ -3267,6 +3293,7 @@ function BoltTable({
                   onClick: () => {
                     const text = typeof menuCol.copy === "function" ? menuCol.copy(menuValue, menuRecord, menuRowIndex) : String(menuValue ?? "");
                     navigator.clipboard?.writeText(text);
+                    onCopy?.(text, menuCol.key, menuRecord, menuRowIndex);
                     setCellContextMenu(null);
                   },
                   children: [

package/dist/index.mjs

@@ -1477,7 +1477,9 @@ function BoltTable({
   emptyRenderer,
   rowClassName,
   rowStyle,
-  disabledFilters
+  disabledFilters,
+  onCopy,
+  keepPinnedRowsAcrossPages
 }) {
   const data = useMemo2(() => {
     if (!Array.isArray(rawData)) return STABLE_EMPTY_DATA;
@@ -2092,8 +2094,10 @@ function BoltTable({
     }
     return result;
   }, [data, sortState, columnFilters]);
+  const pinnedRowCacheRef = useRef4(/* @__PURE__ */ new Map());
   const { pinnedTopRows, pinnedBottomRows, unpinnedProcessedData } = useMemo2(() => {
     if (!resolvedRowPinning || !resolvedRowPinning.top?.length && !resolvedRowPinning.bottom?.length) {
+      if (keepPinnedRowsAcrossPages) pinnedRowCacheRef.current.clear();
       return {
         pinnedTopRows: [],
         pinnedBottomRows: [],
@@ -2108,10 +2112,32 @@ function BoltTable({
     processedData.forEach((row, idx) => {
       if (row == null) return;
       const key = getRowKey(row, idx);
-      if (topKeySet.has(key)) topMap.set(key, row);
-      else if (bottomKeySet.has(key)) bottomMap.set(key, row);
-      else rest.push(row);
+      if (topKeySet.has(key)) {
+        topMap.set(key, row);
+        if (keepPinnedRowsAcrossPages) pinnedRowCacheRef.current.set(key, row);
+      } else if (bottomKeySet.has(key)) {
+        bottomMap.set(key, row);
+        if (keepPinnedRowsAcrossPages) pinnedRowCacheRef.current.set(key, row);
+      } else {
+        rest.push(row);
+      }
     });
+    if (keepPinnedRowsAcrossPages) {
+      for (const k of topKeySet) {
+        if (!topMap.has(k) && pinnedRowCacheRef.current.has(k)) {
+          topMap.set(k, pinnedRowCacheRef.current.get(k));
+        }
+      }
+      for (const k of bottomKeySet) {
+        if (!bottomMap.has(k) && pinnedRowCacheRef.current.has(k)) {
+          bottomMap.set(k, pinnedRowCacheRef.current.get(k));
+        }
+      }
+      const allPinnedKeys = /* @__PURE__ */ new Set([...topKeySet, ...bottomKeySet]);
+      for (const cachedKey of pinnedRowCacheRef.current.keys()) {
+        if (!allPinnedKeys.has(cachedKey)) pinnedRowCacheRef.current.delete(cachedKey);
+      }
+    }
     const orderedTop = (resolvedRowPinning.top ?? []).map((k) => topMap.get(String(k))).filter((r) => r !== void 0);
     const orderedBottom = (resolvedRowPinning.bottom ?? []).map((k) => bottomMap.get(String(k))).filter((r) => r !== void 0);
     return {
@@ -2119,7 +2145,7 @@ function BoltTable({
       pinnedBottomRows: orderedBottom,
       unpinnedProcessedData: rest
     };
-  }, [processedData, resolvedRowPinning, getRowKey]);
+  }, [processedData, resolvedRowPinning, getRowKey, keepPinnedRowsAcrossPages]);
   const pinnedTopHeight = pinnedTopRows.length * rowHeight;
   const pinnedBottomHeight = pinnedBottomRows.length * rowHeight;
   const pinnedTopKeySet = useMemo2(
@@ -3233,6 +3259,7 @@ function BoltTable({
                   onClick: () => {
                     const text = typeof menuCol.copy === "function" ? menuCol.copy(menuValue, menuRecord, menuRowIndex) : String(menuValue ?? "");
                     navigator.clipboard?.writeText(text);
+                    onCopy?.(text, menuCol.key, menuRecord, menuRowIndex);
                     setCellContextMenu(null);
                   },
                   children: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bolt-table",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "description": "Virtualized React table with column drag & drop, pinning, resizing, sorting, filtering, and pagination.",
   "license": "MIT",
   "main": "./dist/index.js",