react-glide-table 2.3.0 → 2.3.2

package/dist/index.js

@@ -441,9 +441,126 @@ function withCellUpdate(context, commitValue) {
   };
 }
 
+// src/components/ui/table/features/cell-selection/pasteData.ts
+function countLeadingEmptyCells(cells) {
+  let depth = 0;
+  while (depth < cells.length && cells[depth] === "") {
+    depth += 1;
+  }
+  return depth;
+}
+function looksLikeSubtreeIndentation(leadingEmptyCounts) {
+  if (leadingEmptyCounts.length === 0) return false;
+  const firstDepth = leadingEmptyCounts[0] ?? 0;
+  if (firstDepth !== 0) return false;
+  return leadingEmptyCounts.some((depth) => depth > 0);
+}
+function parseClipboardTSV(text) {
+  return parseClipboardTSVWithDepths(text).values;
+}
+function parseClipboardTSVWithDepths(text) {
+  if (!text) return { values: [], depths: [] };
+  const normalized = text.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+  const withoutTrailing = normalized.replace(/\n+$/, "");
+  if (!withoutTrailing) return { values: [], depths: [] };
+  const rows = withoutTrailing.split("\n").map((line) => line.split("	"));
+  const leadingEmptyCounts = rows.map(countLeadingEmptyCells);
+  const treatAsDepth = looksLikeSubtreeIndentation(leadingEmptyCounts);
+  const values = [];
+  const depths = [];
+  for (let index = 0; index < rows.length; index += 1) {
+    const cells = rows[index] ?? [];
+    const depth = leadingEmptyCounts[index] ?? 0;
+    if (treatAsDepth) {
+      values.push(cells.slice(depth));
+      depths.push(depth);
+    } else {
+      values.push(cells);
+      depths.push(0);
+    }
+  }
+  return { values, depths };
+}
+function resolvePasteColumnIds(rows, startCol, width) {
+  if (width <= 0) return [];
+  const cells = rows[0]?.getVisibleCells() ?? [];
+  const columnIds = [];
+  for (let offset = 0; offset < width; offset += 1) {
+    const cell = cells[startCol + offset];
+    if (!cell) break;
+    columnIds.push(cell.column.id);
+  }
+  return columnIds;
+}
+function buildRowsPastePayload(rows, startRow, startCol, text, mode, endRow = startRow) {
+  const { values, depths } = parseClipboardTSVWithDepths(text);
+  if (values.length === 0) return null;
+  const width = Math.max(...values.map((row) => row.length), 0);
+  if (width === 0) return null;
+  const columnIds = resolvePasteColumnIds(rows, startCol, width);
+  if (columnIds.length === 0) return null;
+  const rowIds = [];
+  for (let offset = 0; offset < values.length; offset += 1) {
+    const row = rows[startRow + offset];
+    if (!row) break;
+    rowIds.push(row.id);
+  }
+  const anchorRow = rows[endRow] ?? rows[startRow];
+  return {
+    mode,
+    startRow,
+    startCol,
+    endRow,
+    rowIds,
+    anchorRowId: anchorRow?.id ?? "",
+    columnIds,
+    values,
+    depths
+  };
+}
+function isEditablePasteTarget(target) {
+  if (!(target instanceof HTMLElement)) return false;
+  const tag = target.tagName;
+  if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") return true;
+  return Boolean(target.isContentEditable);
+}
+
 // src/components/ui/table/features/cell-selection/useCellSelection.ts
 import { useCallback as useCallback2, useEffect as useEffect2, useRef as useRef2, useState as useState2 } from "react";
 
+// src/components/ui/table/features/cell-selection/activeCellSelectionOwner.ts
+var activeOwner = null;
+var clearByOwner = /* @__PURE__ */ new Map();
+function createCellSelectionOwner() {
+  return /* @__PURE__ */ Symbol("cell-selection-owner");
+}
+function registerCellSelectionOwner(owner, clearSelection) {
+  clearByOwner.set(owner, clearSelection);
+  return () => {
+    clearByOwner.delete(owner);
+    if (activeOwner === owner) {
+      activeOwner = null;
+    }
+  };
+}
+function claimCellSelectionOwner(owner) {
+  if (activeOwner === owner) return;
+  activeOwner = owner;
+  for (const [id, clearSelection] of clearByOwner) {
+    if (id !== owner) {
+      clearSelection();
+    }
+  }
+}
+function isActiveCellSelectionOwner(owner) {
+  return activeOwner === owner;
+}
+function releaseCellSelectionOwner(owner) {
+  if (activeOwner === owner) {
+    activeOwner = null;
+  }
+}
+
 // src/components/ui/table/features/cell-selection/cellSelection.ts
 var INITIAL_DRAG_STATE = {
   isSelecting: false,
@@ -921,19 +1038,31 @@ function extractRenderedCopyText(node, value, cellPosition, root) {
 function formatCopyCellText(rowData, columnDef, columnId, visibleRow, fallbackIndex, sourceCell, cellPosition, options) {
   const meta = columnDef.meta;
   const value = sourceCell ? sourceCell.getValue() : readRowColumnValue(rowData, columnDef);
+  const row = visibleRow ?? createCopyRenderRow(rowData, fallbackIndex);
+  const ctx = {
+    value,
+    row,
+    index: row.index,
+    columnId,
+    cellProps: meta?.cellProps,
+    update: () => {
+    }
+  };
+  const copyValue = meta?.copyValue;
+  if (typeof copyValue === "function") {
+    try {
+      return sanitizeClipboardCell(copyValue(ctx));
+    } catch {
+      return formatCellValue(value);
+    }
+  }
+  if (copyValue === "value") {
+    return formatCellValue(value);
+  }
   const cellRender = meta?.cellRender;
   if (typeof cellRender === "function") {
     try {
-      const row = visibleRow ?? createCopyRenderRow(rowData, fallbackIndex);
-      const node = cellRender({
-        value,
-        row,
-        index: row.index,
-        columnId,
-        cellProps: meta?.cellProps,
-        update: () => {
-        }
-      });
+      const node = cellRender(ctx);
       return extractRenderedCopyText(node, value, cellPosition, options?.root);
     } catch {
       return formatCellValue(value);
@@ -941,16 +1070,6 @@ function formatCopyCellText(rowData, columnDef, columnId, visibleRow, fallbackIn
   }
   if (options?.registry && meta?.kind && isPrimitiveCopyValue(value)) {
     try {
-      const row = visibleRow ?? createCopyRenderRow(rowData, fallbackIndex);
-      const ctx = {
-        value,
-        row,
-        index: row.index,
-        columnId,
-        cellProps: meta.cellProps,
-        update: () => {
-        }
-      };
       const renderer = resolveCellRenderer(options.registry, meta.kind, ctx);
       if (renderer) {
         const node = renderer.render(ctx);
@@ -1076,11 +1195,16 @@ function serializeCopyRowsToTSV(copyRows, visibleRows, bounds, depths, options)
   const resolvedDepths = depths && depths.length === copyRows.length ? depths : copyRows.map((row) => getRowDepth(row));
   const minDepth = Math.min(...resolvedDepths);
   const visibleRowByOriginal = buildVisibleRowLookup(visibleRows);
+  const copyableColumns = columnCells.flatMap((templateCell, colOffset) => {
+    const meta = templateCell.column.columnDef.meta;
+    if (meta?.copyValue === "omit") return [];
+    return [{ templateCell, colOffset }];
+  });
   return copyRows.map((rowData, index) => {
     const relativeDepth = Math.max(0, (resolvedDepths[index] ?? 0) - minDepth);
     const visibleRow = visibleRowByOriginal.get(rowData);
     const matchingCells = visibleRow?.getVisibleCells().slice(startCol, endCol + 1);
-    const line = columnCells.map((templateCell, colOffset) => {
+    const line = copyableColumns.map(({ templateCell, colOffset }) => {
       const sourceCell = matchingCells?.[colOffset];
       const column = sourceCell?.column ?? templateCell.column;
       return formatCopyCellText(
@@ -1174,90 +1298,6 @@ function hasFillExtension(sourceBounds, fillBounds) {
   return fillBounds.startRow < sourceBounds.startRow || fillBounds.endRow > sourceBounds.endRow || fillBounds.startCol < sourceBounds.startCol || fillBounds.endCol > sourceBounds.endCol;
 }
 
-// src/components/ui/table/features/cell-selection/pasteData.ts
-function countLeadingEmptyCells(cells) {
-  let depth = 0;
-  while (depth < cells.length && cells[depth] === "") {
-    depth += 1;
-  }
-  return depth;
-}
-function looksLikeSubtreeIndentation(leadingEmptyCounts) {
-  if (leadingEmptyCounts.length === 0) return false;
-  const firstDepth = leadingEmptyCounts[0] ?? 0;
-  if (firstDepth !== 0) return false;
-  return leadingEmptyCounts.some((depth) => depth > 0);
-}
-function parseClipboardTSV(text) {
-  return parseClipboardTSVWithDepths(text).values;
-}
-function parseClipboardTSVWithDepths(text) {
-  if (!text) return { values: [], depths: [] };
-  const normalized = text.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
-  const withoutTrailing = normalized.replace(/\n+$/, "");
-  if (!withoutTrailing) return { values: [], depths: [] };
-  const rows = withoutTrailing.split("\n").map((line) => line.split("	"));
-  const leadingEmptyCounts = rows.map(countLeadingEmptyCells);
-  const treatAsDepth = looksLikeSubtreeIndentation(leadingEmptyCounts);
-  const values = [];
-  const depths = [];
-  for (let index = 0; index < rows.length; index += 1) {
-    const cells = rows[index] ?? [];
-    const depth = leadingEmptyCounts[index] ?? 0;
-    if (treatAsDepth) {
-      values.push(cells.slice(depth));
-      depths.push(depth);
-    } else {
-      values.push(cells);
-      depths.push(0);
-    }
-  }
-  return { values, depths };
-}
-function resolvePasteColumnIds(rows, startCol, width) {
-  if (width <= 0) return [];
-  const cells = rows[0]?.getVisibleCells() ?? [];
-  const columnIds = [];
-  for (let offset = 0; offset < width; offset += 1) {
-    const cell = cells[startCol + offset];
-    if (!cell) break;
-    columnIds.push(cell.column.id);
-  }
-  return columnIds;
-}
-function buildRowsPastePayload(rows, startRow, startCol, text, mode, endRow = startRow) {
-  const { values, depths } = parseClipboardTSVWithDepths(text);
-  if (values.length === 0) return null;
-  const width = Math.max(...values.map((row) => row.length), 0);
-  if (width === 0) return null;
-  const columnIds = resolvePasteColumnIds(rows, startCol, width);
-  if (columnIds.length === 0) return null;
-  const rowIds = [];
-  for (let offset = 0; offset < values.length; offset += 1) {
-    const row = rows[startRow + offset];
-    if (!row) break;
-    rowIds.push(row.id);
-  }
-  const anchorRow = rows[endRow] ?? rows[startRow];
-  return {
-    mode,
-    startRow,
-    startCol,
-    endRow,
-    rowIds,
-    anchorRowId: anchorRow?.id ?? "",
-    columnIds,
-    values,
-    depths
-  };
-}
-function isEditablePasteTarget(target) {
-  if (!(target instanceof HTMLElement)) return false;
-  const tag = target.tagName;
-  if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") return true;
-  return Boolean(target.isContentEditable);
-}
-
 // src/components/ui/table/features/cell-selection/useCellSelection.ts
 function useCellSelection({
   data,
@@ -1273,6 +1313,7 @@ function useCellSelection({
   cellRendererRegistry,
   rootRef
 }) {
+  const ownerRef = useRef2(createCellSelectionOwner());
   const [dragState, setDragState] = useState2(INITIAL_DRAG_STATE);
   const pendingPasteModeRef = useRef2(null);
   const dragStateRef = useRef2(dragState);
@@ -1284,6 +1325,7 @@ function useCellSelection({
   const handleCellMouseDown = useCallback2(
     (rowIndex, colIndex, options) => {
       if (!enabled) return;
+      claimCellSelectionOwner(ownerRef.current);
       setDragState((prev) => {
         if (options?.shiftKey && prev.start) {
           return {
@@ -1325,6 +1367,7 @@ function useCellSelection({
   const handleFillHandleMouseDown = useCallback2(
     (rowIndex, colIndex) => {
       if (!enabled) return;
+      claimCellSelectionOwner(ownerRef.current);
       setDragState((prev) => {
         const bounds = getCellSelectionBounds(prev.start, prev.end);
         if (!bounds) return prev;
@@ -1339,14 +1382,27 @@ function useCellSelection({
     },
     [enabled]
   );
+  const clearSelection = useCallback2(() => {
+    const prev = dragStateRef.current;
+    if (prev.start === null && prev.end === null && !prev.isSelecting && !prev.isFillDragging) {
+      return;
+    }
+    releaseCellSelectionOwner(ownerRef.current);
+    dragStateRef.current = INITIAL_DRAG_STATE;
+    setDragState(INITIAL_DRAG_STATE);
+  }, []);
   useEffect2(() => {
     if (!enabled) {
-      setDragState(INITIAL_DRAG_STATE);
+      clearSelection();
     }
-  }, [enabled]);
+  }, [clearSelection, enabled]);
+  useEffect2(() => {
+    return registerCellSelectionOwner(ownerRef.current, clearSelection);
+  }, [clearSelection]);
   useEffect2(() => {
     if (!enabled) return;
     const handleKeyDown = (e) => {
+      if (!isActiveCellSelectionOwner(ownerRef.current)) return;
       if (e.ctrlKey || e.metaKey || e.altKey) return;
       if (isEditablePasteTarget(e.target) || isEditablePasteTarget(document.activeElement)) {
         return;
@@ -1412,6 +1468,7 @@ function useCellSelection({
   useEffect2(() => {
     if (!enabled) return;
     const handleKeyDown = (e) => {
+      if (!isActiveCellSelectionOwner(ownerRef.current)) return;
       if (!activeSelectionBounds) return;
       if (!(e.ctrlKey || e.metaKey)) return;
       if (isEditablePasteTarget(e.target) || isEditablePasteTarget(document.activeElement)) {
@@ -1448,6 +1505,7 @@ function useCellSelection({
     const pasteHandledRef = { current: false };
     const ignoreNextPasteRef = { current: false };
     const handleKeyDown = (e) => {
+      if (!isActiveCellSelectionOwner(ownerRef.current)) return;
       if (!activeSelectionBounds) return;
       if (!(e.ctrlKey || e.metaKey)) return;
       if (e.key.toLowerCase() !== "v") return;
@@ -1468,6 +1526,7 @@ function useCellSelection({
           const text = await navigator.clipboard.readText();
           if (pasteHandledRef.current) return;
           if (pendingPasteModeRef.current !== mode) return;
+          if (!isActiveCellSelectionOwner(ownerRef.current)) return;
           if (!text) return;
           pasteHandledRef.current = true;
           emitRowsPaste(text, mode);
@@ -1477,6 +1536,7 @@ function useCellSelection({
       })();
     };
     const handlePaste = (e) => {
+      if (!isActiveCellSelectionOwner(ownerRef.current)) return;
       if (!activeSelectionBounds) return;
       if (isEditablePasteTarget(e.target) || isEditablePasteTarget(document.activeElement)) {
         return;
@@ -1557,10 +1617,30 @@ function useCellSelection({
     handleCellMouseDown,
     handleCellMouseEnter,
     handleFillHandleMouseDown,
+    clearSelection,
     copySelection
   };
 }
 
+// src/components/ui/table/features/selection-dismiss/isOutsideDismissTarget.ts
+var OVERLAY_DISMISS_IGNORE_SELECTOR = [
+  '[role="dialog"]',
+  '[role="alertdialog"]',
+  '[role="menu"]',
+  '[role="listbox"]',
+  '[role="tooltip"]',
+  '[aria-modal="true"]',
+  "[data-radix-portal]",
+  "[data-radix-popper-content-wrapper]",
+  "[data-floating-ui-portal]",
+  "[data-table-ignore-outside-dismiss]"
+].join(",");
+function isOverlayDismissIgnoreTarget(target) {
+  const element = target instanceof Element ? target : target instanceof Node ? target.parentElement : null;
+  if (!element) return false;
+  return element.closest(OVERLAY_DISMISS_IGNORE_SELECTOR) !== null;
+}
+
 // src/components/ui/table/features/column-reorder/columnReorder.ts
 function getColumnDefId(column) {
   if (column.id != null && column.id !== "") return column.id;
@@ -2847,6 +2927,7 @@ function useGlideTable(options) {
     handleCellMouseDown,
     handleCellMouseEnter,
     handleFillHandleMouseDown,
+    clearSelection: clearCellSelection,
     copySelection
   } = useCellSelection({
     data: tableData,
@@ -2862,6 +2943,37 @@ function useGlideTable(options) {
     cellRendererRegistry,
     rootRef
   });
+  const clearRowSelection = useCallback4(() => {
+    if (rowSelectionMode === "none") return;
+    const hasSelection = Object.values(rowSelection).some(Boolean);
+    if (!hasSelection) return;
+    if (onRowSelectionChange) {
+      onRowSelectionChange(() => ({}));
+      return;
+    }
+    setInternalRowSelection({});
+  }, [onRowSelectionChange, rowSelection, rowSelectionMode]);
+  useEffect5(() => {
+    const clearAllSelections = () => {
+      clearCellSelection();
+      clearRowSelection();
+    };
+    const handleKeyDown = (event) => {
+      if (event.key !== "Escape") return;
+      if (event.defaultPrevented) return;
+      if (isEditablePasteTarget(event.target) || isEditablePasteTarget(document.activeElement)) {
+        return;
+      }
+      if (isOverlayDismissIgnoreTarget(event.target) || isOverlayDismissIgnoreTarget(document.activeElement)) {
+        return;
+      }
+      clearAllSelections();
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => {
+      window.removeEventListener("keydown", handleKeyDown);
+    };
+  }, [clearCellSelection, clearRowSelection]);
   const {
     editingCell,
     draftValue,
@@ -4956,7 +5068,8 @@ function buildColumnDef(props, sort, onSort) {
     cellProps,
     className,
     headerClassName,
-    render
+    render,
+    copyValue
   } = props;
   return {
     id: field,
@@ -4990,6 +5103,7 @@ function buildColumnDef(props, sort, onSort) {
       kind,
       cellProps,
       cellRender: render,
+      copyValue,
       frozen,
       reorderable,
       width,

package/dist/{types-DdeVn-9s.d.cts → types-hf2ruVdu.d.cts}

@@ -177,6 +177,14 @@ declare function resolveDataTableLabels(partial?: Partial<DataTableLabels>): Dat
 type RowSelectionMode = "none" | "single" | "multi";
 type CellEditType = "text" | "number";
 type DataTableEditInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "value" | "defaultValue">;
+/**
+ * Per-column clipboard serialization.
+ * - `"display"`: text extracted from the rendered cell
+ * - `"value"`: raw accessor / field value
+ * - `"omit"`: exclude this column from clipboard TSV entirely
+ * - function: custom clipboard string
+ */
+type ColumnCopyValue<T extends Record<string, unknown> = Record<string, unknown>, V = unknown> = "display" | "value" | "omit" | ((ctx: CellRenderContext<T, V>) => string);
 
 declare module "@tanstack/react-table" {
     interface ColumnMeta<TData, TValue> {
@@ -209,6 +217,14 @@ declare module "@tanstack/react-table" {
         cellProps?: Record<string, unknown>;
         /** Compound `Column.render` stored for `ResolvedTableCell` */
         cellRender?: CellRenderFn<Record<string, unknown>>;
+        /**
+         * Clipboard serialization for this column.
+         * - `"display"`: rendered cell text (default when `render` / `kind` is set)
+         * - `"value"`: raw accessor / field value
+         * - `"omit"`: exclude this column from clipboard TSV entirely
+         * - function: custom string for the clipboard
+         */
+        copyValue?: ColumnCopyValue;
         /**
          * Freeze (sticky) this column without reordering.
          * `true` / `"left"` stick to the scrollport left; `"right"` to the right.
@@ -623,6 +639,14 @@ type TableColumnProps<T extends Record<string, unknown>, K extends string = keyo
      * Use `update` to commit via `onCellChange` / `onDataChange`.
      */
     render?: CellRenderFn<T, K extends keyof T ? T[K] : unknown>;
+    /**
+     * Clipboard serialization for this column.
+     * - `"display"`: rendered cell text (default when `render` / `kind` is set)
+     * - `"value"`: raw accessor / field value (useful for button cells that still wrap real data)
+     * - `"omit"`: exclude this column from clipboard TSV (shifts neighbors; prefer empty string for in-table paste)
+     * - function: custom string for the clipboard
+     */
+    copyValue?: ColumnCopyValue<T, K extends keyof T ? T[K] : unknown>;
 };
 /** Declares a multi-row header group wrapping leaf `Table.Column`s. */
 type TableColumnGroupProps = {
@@ -638,4 +662,4 @@ type TableProps<T extends Record<string, unknown>> = Omit<DataTableProps<T>, "co
     children: ReactNode;
 };
 
-export { collectSearchMatchesInRange as A, type BuiltinCellKind as B, type CellKind as C, DEFAULT_DATA_TABLE_LABELS as D, createSearchRegex as E, escapeSearchRegex as F, formatSearchResultLabel as G, getColumnFreezeEdgeAttr as H, INLINE_SEARCH_MAX_RESULTS as I, getColumnFreezeStyle as J, mapSearchResultToVisibleItem as K, mapSearchResultsToVisibleKeys as L, nextSearchIndex as M, nextSearchStride as N, previousSearchIndex as O, type PasteMode as P, resolveColumnFreezeSide as Q, type RowSelectionMode as R, type SearchCorpusRow as S, type TableColumnGroupProps as T, resolveDataTableLabels as U, resolveHeaderFreezeOffset as V, type CellEditType as W, type CellRenderContext as a, type CellRenderFn as b, type CellRenderer as c, type ColumnFreezeColumnInput as d, type ColumnFreezeEdgeSide as e, type ColumnFreezeMeta as f, type ColumnFreezeOffset as g, type ColumnFreezeSide as h, type DataTableClassNames as i, type DataTableCopyActions as j, type DataTableLabels as k, type DataTableProps as l, type DataTableScrollSlotProps as m, type DataTableSlots as n, type RowsPastePayload as o, type SearchResultItem as p, type SearchStatus as q, type TableColumnProps as r, type TableProps as s, buildColumnFreezeOffsets as t, buildFlatSearchCorpus as u, buildSearchMatchKey as v, buildSearchMatchKeys as w, buildTreeSearchCorpus as x, cellValueToSearchText as y, collectAncestorKeysToExpand as z };
+export { collectAncestorKeysToExpand as A, type BuiltinCellKind as B, type CellKind as C, DEFAULT_DATA_TABLE_LABELS as D, collectSearchMatchesInRange as E, createSearchRegex as F, escapeSearchRegex as G, formatSearchResultLabel as H, INLINE_SEARCH_MAX_RESULTS as I, getColumnFreezeEdgeAttr as J, getColumnFreezeStyle as K, mapSearchResultToVisibleItem as L, mapSearchResultsToVisibleKeys as M, nextSearchIndex as N, nextSearchStride as O, type PasteMode as P, previousSearchIndex as Q, type RowSelectionMode as R, type SearchCorpusRow as S, type TableColumnGroupProps as T, resolveColumnFreezeSide as U, resolveDataTableLabels as V, resolveHeaderFreezeOffset as W, type CellEditType as X, type CellRenderContext as a, type CellRenderFn as b, type CellRenderer as c, type ColumnCopyValue as d, type ColumnFreezeColumnInput as e, type ColumnFreezeEdgeSide as f, type ColumnFreezeMeta as g, type ColumnFreezeOffset as h, type ColumnFreezeSide as i, type DataTableClassNames as j, type DataTableCopyActions as k, type DataTableLabels as l, type DataTableProps as m, type DataTableScrollSlotProps as n, type DataTableSlots as o, type RowsPastePayload as p, type SearchResultItem as q, type SearchStatus as r, type TableColumnProps as s, type TableProps as t, buildColumnFreezeOffsets as u, buildFlatSearchCorpus as v, buildSearchMatchKey as w, buildSearchMatchKeys as x, buildTreeSearchCorpus as y, cellValueToSearchText as z };

package/dist/{types-DdeVn-9s.d.ts → types-hf2ruVdu.d.ts}

@@ -177,6 +177,14 @@ declare function resolveDataTableLabels(partial?: Partial<DataTableLabels>): Dat
 type RowSelectionMode = "none" | "single" | "multi";
 type CellEditType = "text" | "number";
 type DataTableEditInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "value" | "defaultValue">;
+/**
+ * Per-column clipboard serialization.
+ * - `"display"`: text extracted from the rendered cell
+ * - `"value"`: raw accessor / field value
+ * - `"omit"`: exclude this column from clipboard TSV entirely
+ * - function: custom clipboard string
+ */
+type ColumnCopyValue<T extends Record<string, unknown> = Record<string, unknown>, V = unknown> = "display" | "value" | "omit" | ((ctx: CellRenderContext<T, V>) => string);
 
 declare module "@tanstack/react-table" {
     interface ColumnMeta<TData, TValue> {
@@ -209,6 +217,14 @@ declare module "@tanstack/react-table" {
         cellProps?: Record<string, unknown>;
         /** Compound `Column.render` stored for `ResolvedTableCell` */
         cellRender?: CellRenderFn<Record<string, unknown>>;
+        /**
+         * Clipboard serialization for this column.
+         * - `"display"`: rendered cell text (default when `render` / `kind` is set)
+         * - `"value"`: raw accessor / field value
+         * - `"omit"`: exclude this column from clipboard TSV entirely
+         * - function: custom string for the clipboard
+         */
+        copyValue?: ColumnCopyValue;
         /**
          * Freeze (sticky) this column without reordering.
          * `true` / `"left"` stick to the scrollport left; `"right"` to the right.
@@ -623,6 +639,14 @@ type TableColumnProps<T extends Record<string, unknown>, K extends string = keyo
      * Use `update` to commit via `onCellChange` / `onDataChange`.
      */
     render?: CellRenderFn<T, K extends keyof T ? T[K] : unknown>;
+    /**
+     * Clipboard serialization for this column.
+     * - `"display"`: rendered cell text (default when `render` / `kind` is set)
+     * - `"value"`: raw accessor / field value (useful for button cells that still wrap real data)
+     * - `"omit"`: exclude this column from clipboard TSV (shifts neighbors; prefer empty string for in-table paste)
+     * - function: custom string for the clipboard
+     */
+    copyValue?: ColumnCopyValue<T, K extends keyof T ? T[K] : unknown>;
 };
 /** Declares a multi-row header group wrapping leaf `Table.Column`s. */
 type TableColumnGroupProps = {
@@ -638,4 +662,4 @@ type TableProps<T extends Record<string, unknown>> = Omit<DataTableProps<T>, "co
     children: ReactNode;
 };
 
-export { collectSearchMatchesInRange as A, type BuiltinCellKind as B, type CellKind as C, DEFAULT_DATA_TABLE_LABELS as D, createSearchRegex as E, escapeSearchRegex as F, formatSearchResultLabel as G, getColumnFreezeEdgeAttr as H, INLINE_SEARCH_MAX_RESULTS as I, getColumnFreezeStyle as J, mapSearchResultToVisibleItem as K, mapSearchResultsToVisibleKeys as L, nextSearchIndex as M, nextSearchStride as N, previousSearchIndex as O, type PasteMode as P, resolveColumnFreezeSide as Q, type RowSelectionMode as R, type SearchCorpusRow as S, type TableColumnGroupProps as T, resolveDataTableLabels as U, resolveHeaderFreezeOffset as V, type CellEditType as W, type CellRenderContext as a, type CellRenderFn as b, type CellRenderer as c, type ColumnFreezeColumnInput as d, type ColumnFreezeEdgeSide as e, type ColumnFreezeMeta as f, type ColumnFreezeOffset as g, type ColumnFreezeSide as h, type DataTableClassNames as i, type DataTableCopyActions as j, type DataTableLabels as k, type DataTableProps as l, type DataTableScrollSlotProps as m, type DataTableSlots as n, type RowsPastePayload as o, type SearchResultItem as p, type SearchStatus as q, type TableColumnProps as r, type TableProps as s, buildColumnFreezeOffsets as t, buildFlatSearchCorpus as u, buildSearchMatchKey as v, buildSearchMatchKeys as w, buildTreeSearchCorpus as x, cellValueToSearchText as y, collectAncestorKeysToExpand as z };
+export { collectAncestorKeysToExpand as A, type BuiltinCellKind as B, type CellKind as C, DEFAULT_DATA_TABLE_LABELS as D, collectSearchMatchesInRange as E, createSearchRegex as F, escapeSearchRegex as G, formatSearchResultLabel as H, INLINE_SEARCH_MAX_RESULTS as I, getColumnFreezeEdgeAttr as J, getColumnFreezeStyle as K, mapSearchResultToVisibleItem as L, mapSearchResultsToVisibleKeys as M, nextSearchIndex as N, nextSearchStride as O, type PasteMode as P, previousSearchIndex as Q, type RowSelectionMode as R, type SearchCorpusRow as S, type TableColumnGroupProps as T, resolveColumnFreezeSide as U, resolveDataTableLabels as V, resolveHeaderFreezeOffset as W, type CellEditType as X, type CellRenderContext as a, type CellRenderFn as b, type CellRenderer as c, type ColumnCopyValue as d, type ColumnFreezeColumnInput as e, type ColumnFreezeEdgeSide as f, type ColumnFreezeMeta as g, type ColumnFreezeOffset as h, type ColumnFreezeSide as i, type DataTableClassNames as j, type DataTableCopyActions as k, type DataTableLabels as l, type DataTableProps as m, type DataTableScrollSlotProps as n, type DataTableSlots as o, type RowsPastePayload as p, type SearchResultItem as q, type SearchStatus as r, type TableColumnProps as s, type TableProps as t, buildColumnFreezeOffsets as u, buildFlatSearchCorpus as v, buildSearchMatchKey as w, buildSearchMatchKeys as x, buildTreeSearchCorpus as y, cellValueToSearchText as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-glide-table",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/zpxlffjrm/react-glide-table.git"