react-glide-table 1.1.4 → 1.1.6

package/dist/core.cjs

@@ -30,9 +30,13 @@ __export(core_exports, {
   applyFillData: () => applyFillData,
   applySelectionUpdater: () => applySelectionUpdater,
   buildColumnRowSpanMap: () => buildColumnRowSpanMap,
+  buildRowsPastePayload: () => buildRowsPastePayload,
   canExpandRow: () => canExpandRow,
+  collectCopyRowEntries: () => collectCopyRowEntries,
+  collectCopyRows: () => collectCopyRows,
   collectFillChanges: () => collectFillChanges,
   collectRowSpanColumns: () => collectRowSpanColumns,
+  flattenSubtreeRows: () => flattenSubtreeRows,
   getCellEditDraftValue: () => getCellEditDraftValue,
   getCellSelectionEdgeStyle: () => getCellSelectionEdgeStyle,
   getColumnEditType: () => getColumnEditType,
@@ -40,15 +44,24 @@ __export(core_exports, {
   hasCellSelectionEdges: () => hasCellSelectionEdges,
   isCellInSelection: () => isCellInSelection,
   isColumnEditable: () => isColumnEditable,
+  isEditablePasteTarget: () => isEditablePasteTarget,
+  measureMergedSpanRowHeights: () => measureMergedSpanRowHeights,
   parseCellEditValue: () => parseCellEditValue,
+  parseClipboardTSV: () => parseClipboardTSV,
+  parseClipboardTSVWithDepths: () => parseClipboardTSVWithDepths,
   resolveDataTableLabels: () => resolveDataTableLabels,
+  resolvePasteColumnIds: () => resolvePasteColumnIds,
   resolveRowSelection: () => resolveRowSelection,
   resolveRowSpanAt: () => resolveRowSpanAt,
+  rowRangeToHeightRatios: () => rowRangeToHeightRatios,
+  serializeCopyRowsToTSV: () => serializeCopyRowsToTSV,
+  serializeSelectionToTSV: () => serializeSelectionToTSV,
   toggleExpandedRowId: () => toggleExpandedRowId,
   useCellEdit: () => useCellEdit,
   useCellSelection: () => useCellSelection,
   useConvertTreeData: () => useConvertTreeData,
-  useGlideTable: () => useGlideTable
+  useGlideTable: () => useGlideTable,
+  writeSelectionToClipboard: () => writeSelectionToClipboard
 });
 module.exports = __toCommonJS(core_exports);
 
@@ -230,10 +243,36 @@ function getCellSelectionBounds(start, end) {
     endCol: Math.max(start.col, end.col)
   };
 }
+function measureMergedSpanRowHeights(rowIndex, rowSpan, cellElement) {
+  if (rowSpan <= 1) return void 0;
+  const tbody = cellElement?.closest("tbody") ?? (typeof document !== "undefined" ? document.querySelector("tbody.data-table-body") : null);
+  if (!tbody) return void 0;
+  const rows = tbody.querySelectorAll(":scope > tr");
+  if (rows.length < rowIndex + rowSpan) return void 0;
+  const heights = [];
+  for (let i = 0; i < rowSpan; i++) {
+    const row = rows[rowIndex + i];
+    const height = row?.getBoundingClientRect().height ?? 0;
+    if (height <= 0) return void 0;
+    heights.push(height);
+  }
+  return heights;
+}
 function getRowIndexInMergedCell(clientY, cellElement, rowIndex, rowSpan) {
   if (rowSpan <= 1) return rowIndex;
   const rect = cellElement.getBoundingClientRect();
   const relativeY = clientY - rect.top;
+  const heights = measureMergedSpanRowHeights(rowIndex, rowSpan, cellElement);
+  if (heights && heights.length === rowSpan) {
+    let accrued = 0;
+    for (let i = 0; i < rowSpan; i++) {
+      accrued += heights[i];
+      if (relativeY < accrued) {
+        return rowIndex + i;
+      }
+    }
+    return rowIndex + rowSpan - 1;
+  }
   const rowHeight = rect.height / rowSpan;
   const offset = Math.min(
     Math.max(Math.floor(relativeY / rowHeight), 0),
@@ -255,7 +294,35 @@ function getActiveSelectionBounds(dragState, selectionBounds) {
 var SELECTION_EDGE_WIDTH_PX = 2;
 var SELECTION_EDGE_COLOR = "var(--color-brand-primary)";
 var CELL_SELECTION_EDGES_CLASS = "cell-selection-edges";
-function getMergedCellStepEdges(rowIndex, colIndex, bounds, rowSpan, isVisuallySelectedAt) {
+function rowRangeToHeightRatios(rowIndex, span, fromRow, toRowExclusive, rowHeights) {
+  const clampedFrom = Math.max(fromRow, rowIndex);
+  const clampedTo = Math.min(toRowExclusive, rowIndex + span);
+  if (clampedTo <= clampedFrom) {
+    return { offsetRatio: 0, lengthRatio: 0 };
+  }
+  if (!rowHeights || rowHeights.length !== span) {
+    return {
+      offsetRatio: (clampedFrom - rowIndex) / span,
+      lengthRatio: (clampedTo - clampedFrom) / span
+    };
+  }
+  const total = rowHeights.reduce((sum, height) => sum + height, 0) || 1;
+  let offsetPx = 0;
+  for (let i = 0; i < clampedFrom - rowIndex; i++) {
+    offsetPx += rowHeights[i] ?? 0;
+  }
+  let lengthPx = 0;
+  for (let i = clampedFrom - rowIndex; i < clampedTo - rowIndex; i++) {
+    lengthPx += rowHeights[i] ?? 0;
+  }
+  return {
+    offsetRatio: offsetPx / total,
+    lengthRatio: lengthPx / total,
+    offsetPx,
+    lengthPx
+  };
+}
+function getMergedCellStepEdges(rowIndex, colIndex, bounds, rowSpan, isVisuallySelectedAt, rowHeights) {
   const cellEndRow = rowIndex + rowSpan - 1;
   const span = cellEndRow - rowIndex + 1;
   if (span <= 1) return [];
@@ -274,20 +341,30 @@ function getMergedCellStepEdges(rowIndex, colIndex, bounds, rowSpan, isVisuallyS
         continue;
       }
       if (runStart !== null) {
-        edges.push({
-          side,
-          offsetRatio: (runStart - rowIndex) / span,
-          heightRatio: (row - runStart) / span
-        });
+        const ratios = rowRangeToHeightRatios(
+          rowIndex,
+          span,
+          runStart,
+          row,
+          rowHeights
+        );
+        if (ratios.lengthRatio > 0) {
+          edges.push({ side, ...ratios });
+        }
         runStart = null;
       }
     }
     if (runStart !== null) {
-      edges.push({
-        side,
-        offsetRatio: (runStart - rowIndex) / span,
-        heightRatio: (toRowExclusive - runStart) / span
-      });
+      const ratios = rowRangeToHeightRatios(
+        rowIndex,
+        span,
+        runStart,
+        toRowExclusive,
+        rowHeights
+      );
+      if (ratios.lengthRatio > 0) {
+        edges.push({ side, ...ratios });
+      }
     }
   };
   const collectSide = (side, neighborCol) => {
@@ -316,14 +393,17 @@ function getMergedCellStepEdges(rowIndex, colIndex, bounds, rowSpan, isVisuallyS
   }
   return edges;
 }
-function buildPartialVerticalGradient(edge) {
+function buildPartialEdgeGradient(edge) {
+  const usePx = edge.offsetPx != null && edge.lengthPx != null;
   const startPct = edge.offsetRatio * 100;
-  const endPct = (edge.offsetRatio + edge.heightRatio) * 100;
-  const overlapPx = SELECTION_EDGE_WIDTH_PX + 1;
-  const isTopProtrusion = edge.offsetRatio === 0 && edge.heightRatio < 1;
-  const isBottomProtrusion = edge.offsetRatio > 0;
-  const startStop = isBottomProtrusion ? `calc(${startPct}% - ${overlapPx}px)` : `${startPct}%`;
-  const endStop = isTopProtrusion ? `calc(${endPct}% + ${overlapPx}px)` : `${endPct}%`;
+  const endPct = (edge.offsetRatio + edge.lengthRatio) * 100;
+  const startPx = edge.offsetPx ?? 0;
+  const endPx = (edge.offsetPx ?? 0) + (edge.lengthPx ?? 0);
+  const overlapPx = SELECTION_EDGE_WIDTH_PX;
+  const isTopProtrusion = (usePx ? startPx === 0 : edge.offsetRatio === 0) && edge.lengthRatio < 1;
+  const isBottomProtrusion = usePx ? startPx > 0 : edge.offsetRatio > 0;
+  const startStop = usePx ? isBottomProtrusion ? `${Math.max(0, startPx - overlapPx)}px` : `${startPx}px` : isBottomProtrusion ? `calc(${startPct}% - ${overlapPx}px)` : `${startPct}%`;
+  const endStop = usePx ? isTopProtrusion ? `${endPx + overlapPx}px` : `${endPx}px` : isTopProtrusion ? `calc(${endPct}% + ${overlapPx}px)` : `${endPct}%`;
   const xPos = edge.side === "left" ? "0" : "100%";
   const layers = [
     {
@@ -333,7 +413,7 @@ function buildPartialVerticalGradient(edge) {
     }
   ];
   if (isTopProtrusion || isBottomProtrusion) {
-    const capTop = isTopProtrusion ? `calc(${endPct}% - ${SELECTION_EDGE_WIDTH_PX}px)` : `calc(${startPct}% - ${SELECTION_EDGE_WIDTH_PX}px)`;
+    const capTop = usePx ? isTopProtrusion ? `${Math.max(0, endPx - SELECTION_EDGE_WIDTH_PX)}px` : `${Math.max(0, startPx - SELECTION_EDGE_WIDTH_PX)}px` : isTopProtrusion ? `calc(${endPct}% - ${SELECTION_EDGE_WIDTH_PX}px)` : `calc(${startPct}% - ${SELECTION_EDGE_WIDTH_PX}px)`;
     layers.push({
       image: `linear-gradient(${SELECTION_EDGE_COLOR}, ${SELECTION_EDGE_COLOR})`,
       size: `${SELECTION_EDGE_WIDTH_PX}px ${SELECTION_EDGE_WIDTH_PX}px`,
@@ -342,7 +422,7 @@ function buildPartialVerticalGradient(edge) {
   }
   return layers;
 }
-function getCellSelectionEdgeStyle(rowIndex, colIndex, bounds, rowSpan = 1, isVisuallySelectedAt) {
+function getCellSelectionEdgeStyle(rowIndex, colIndex, bounds, rowSpan = 1, isVisuallySelectedAt, rowHeights) {
   if (!isCellInSelection(rowIndex, colIndex, bounds, rowSpan) || !bounds)
     return void 0;
   const cellEndRow = rowIndex + rowSpan - 1;
@@ -351,39 +431,47 @@ function getCellSelectionEdgeStyle(rowIndex, colIndex, bounds, rowSpan = 1, isVi
   const isLeftEdge = colIndex === bounds.startCol;
   const isRightEdge = colIndex === bounds.endCol;
   const selectionContinuesBelow = cellEndRow < bounds.endRow;
-  const shadows = [];
-  if (isTopEdge) {
-    shadows.push(
-      `inset 0 ${SELECTION_EDGE_WIDTH_PX}px 0 0 ${SELECTION_EDGE_COLOR}`
-    );
-  }
-  if (isBottomEdge) {
-    shadows.push(
-      `inset 0 -${SELECTION_EDGE_WIDTH_PX}px 0 0 ${SELECTION_EDGE_COLOR}`
-    );
-  }
-  if (isLeftEdge) {
-    shadows.push(
-      `inset ${SELECTION_EDGE_WIDTH_PX}px 0 0 0 ${SELECTION_EDGE_COLOR}`
-    );
-  }
-  if (isRightEdge) {
-    shadows.push(
-      `inset -${SELECTION_EDGE_WIDTH_PX}px 0 0 0 ${SELECTION_EDGE_COLOR}`
-    );
-  }
   const stepEdges = getMergedCellStepEdges(
     rowIndex,
     colIndex,
     bounds,
     rowSpan,
-    isVisuallySelectedAt
+    isVisuallySelectedAt,
+    rowHeights
   );
+  const shadows = [];
+  const hasFullPerimeter = isTopEdge && isBottomEdge && isLeftEdge && isRightEdge && stepEdges.length === 0;
+  if (hasFullPerimeter) {
+    shadows.push(
+      `inset 0 0 0 ${SELECTION_EDGE_WIDTH_PX}px ${SELECTION_EDGE_COLOR}`
+    );
+  } else {
+    if (isTopEdge) {
+      shadows.push(
+        `inset 0 ${SELECTION_EDGE_WIDTH_PX}px 0 0 ${SELECTION_EDGE_COLOR}`
+      );
+    }
+    if (isBottomEdge) {
+      shadows.push(
+        `inset 0 -${SELECTION_EDGE_WIDTH_PX}px 0 0 ${SELECTION_EDGE_COLOR}`
+      );
+    }
+    if (isLeftEdge) {
+      shadows.push(
+        `inset ${SELECTION_EDGE_WIDTH_PX}px 0 0 0 ${SELECTION_EDGE_COLOR}`
+      );
+    }
+    if (isRightEdge) {
+      shadows.push(
+        `inset -${SELECTION_EDGE_WIDTH_PX}px 0 0 0 ${SELECTION_EDGE_COLOR}`
+      );
+    }
+  }
   const gradients = [];
   const sizes = [];
   const positions = [];
   for (const edge of stepEdges) {
-    for (const partial of buildPartialVerticalGradient(edge)) {
+    for (const partial of buildPartialEdgeGradient(edge)) {
       gradients.push(partial.image);
       sizes.push(partial.size);
       positions.push(partial.position);
@@ -412,6 +500,127 @@ function hasCellSelectionEdges(style) {
   );
 }
 
+// src/components/ui/table/features/cell-selection/copyData.ts
+function formatCellValue(value) {
+  if (value === null || value === void 0) return "";
+  return String(value);
+}
+function getNestedValue(row, path) {
+  if (!path.includes(".")) return row[path];
+  return path.split(".").reduce((current, key) => {
+    if (current === null || current === void 0 || typeof current !== "object") {
+      return void 0;
+    }
+    return current[key];
+  }, row);
+}
+function readRowColumnValue(rowData, columnDef) {
+  if ("accessorFn" in columnDef && typeof columnDef.accessorFn === "function") {
+    return columnDef.accessorFn(rowData, 0);
+  }
+  if ("accessorKey" in columnDef && columnDef.accessorKey != null && columnDef.accessorKey !== "") {
+    return getNestedValue(rowData, String(columnDef.accessorKey));
+  }
+  return void 0;
+}
+function flattenSubtreeRows(row) {
+  const children = row.children;
+  if (!Array.isArray(children) || children.length === 0) return [];
+  const result = [];
+  const walk = (nodes) => {
+    for (const node of nodes) {
+      result.push(node);
+      const nested = node.children;
+      if (Array.isArray(nested) && nested.length > 0) {
+        walk(nested);
+      }
+    }
+  };
+  walk(children);
+  return result;
+}
+function hasSubtree(row) {
+  const children = row.children;
+  return Array.isArray(children) && children.length > 0;
+}
+function getOriginalRowId(original) {
+  return String(original.id ?? original.uniqueId ?? "");
+}
+function getRowDepth(original) {
+  return typeof original.level === "number" ? original.level : 0;
+}
+function collectCopyRowEntries(visibleRows, bounds, mode = "visible") {
+  const { startRow, endRow } = bounds;
+  const result = [];
+  const includedOriginalIds = /* @__PURE__ */ new Set();
+  const appendSubtree = (node, depth) => {
+    const children = node.children;
+    if (!Array.isArray(children) || children.length === 0) return;
+    for (const child of children) {
+      const childId = getOriginalRowId(child);
+      if (!(childId && includedOriginalIds.has(childId))) {
+        result.push({ row: child, depth });
+        if (childId) includedOriginalIds.add(childId);
+      }
+      appendSubtree(child, depth + 1);
+    }
+  };
+  for (let rowIndex = startRow; rowIndex <= endRow; rowIndex += 1) {
+    const row = visibleRows[rowIndex];
+    if (!row) continue;
+    const originalId = getOriginalRowId(row.original);
+    if (originalId && includedOriginalIds.has(originalId)) continue;
+    const depth = getRowDepth(row.original);
+    result.push({ row: row.original, depth });
+    if (originalId) includedOriginalIds.add(originalId);
+    if (mode !== "subtree" || !hasSubtree(row.original)) continue;
+    appendSubtree(row.original, depth + 1);
+  }
+  return result;
+}
+function collectCopyRows(visibleRows, bounds, mode = "visible") {
+  return collectCopyRowEntries(visibleRows, bounds, mode).map((entry) => entry.row);
+}
+function serializeCopyRowsToTSV(copyRows, visibleRows, bounds, depths) {
+  if (copyRows.length === 0) return "";
+  const { startCol, endCol } = bounds;
+  const columnCells = visibleRows[0]?.getVisibleCells().slice(startCol, endCol + 1) ?? [];
+  if (columnCells.length === 0) return "";
+  const resolvedDepths = depths && depths.length === copyRows.length ? depths : copyRows.map((row) => getRowDepth(row));
+  const minDepth = Math.min(...resolvedDepths);
+  return copyRows.map((rowData, index) => {
+    const relativeDepth = Math.max(0, (resolvedDepths[index] ?? 0) - minDepth);
+    const line = columnCells.map(
+      (cell) => formatCellValue(
+        readRowColumnValue(
+          rowData,
+          cell.column.columnDef
+        )
+      )
+    ).join("	");
+    return `${"	".repeat(relativeDepth)}${line}`;
+  }).join("\n");
+}
+function serializeSelectionToTSV(visibleRows, bounds, mode = "visible") {
+  const entries = collectCopyRowEntries(visibleRows, bounds, mode);
+  return serializeCopyRowsToTSV(
+    entries.map((entry) => entry.row),
+    visibleRows,
+    bounds,
+    entries.map((entry) => entry.depth)
+  );
+}
+async function writeSelectionToClipboard(visibleRows, bounds, mode = "visible") {
+  const text = serializeSelectionToTSV(visibleRows, bounds, mode);
+  if (!text) return false;
+  try {
+    await navigator.clipboard.writeText(text);
+  } catch {
+    return false;
+  }
+  return true;
+}
+
 // src/components/ui/table/features/cell-selection/fillData.ts
 function getColumnAccessorKey2(columnDef) {
   if ("accessorKey" in columnDef && columnDef.accessorKey) {
@@ -468,15 +677,103 @@ 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,
   rows,
   enabled = true,
+  enableSubtreeCopy = false,
+  enableInsertPaste = true,
   onDataChange,
-  onBatchChange
+  onBatchChange,
+  onRowsPaste
 }) {
   const [dragState, setDragState] = (0, import_react2.useState)(INITIAL_DRAG_STATE);
+  const pendingPasteModeRef = (0, import_react2.useRef)(null);
   const cellSelectionBounds = getCellSelectionBounds(dragState.start, dragState.end);
   const activeSelectionBounds = enabled ? getActiveSelectionBounds(dragState, cellSelectionBounds) : null;
   const handleCellMouseDown = (0, import_react2.useCallback)(
@@ -530,21 +827,113 @@ function useCellSelection({
       setDragState(INITIAL_DRAG_STATE);
     }
   }, [enabled]);
+  const copySelection = (0, import_react2.useCallback)(
+    async (options) => {
+      if (!enabled || !activeSelectionBounds) return false;
+      const mode = options?.includeDescendants && enableSubtreeCopy ? "subtree" : "visible";
+      return writeSelectionToClipboard(rows, activeSelectionBounds, mode);
+    },
+    [activeSelectionBounds, enableSubtreeCopy, enabled, rows]
+  );
   (0, import_react2.useEffect)(() => {
     if (!enabled) return;
     const handleKeyDown = (e) => {
-      if ((e.ctrlKey || e.metaKey) && e.key === "c" && activeSelectionBounds) {
-        const { startRow, endRow, startCol, endCol } = activeSelectionBounds;
-        const selectedData = rows.slice(startRow, endRow + 1).map((row) => {
-          const cells = row.getVisibleCells();
-          return cells.slice(startCol, endCol + 1).map((cell) => cell.getValue()).join("	");
-        }).join("\n");
-        navigator.clipboard.writeText(selectedData);
-      }
+      if (!activeSelectionBounds) return;
+      if (!(e.ctrlKey || e.metaKey)) return;
+      const isSubtreeShortcut = enableSubtreeCopy && e.shiftKey && e.key.toLowerCase() === "c";
+      const isVisibleCopyShortcut = !e.shiftKey && e.key.toLowerCase() === "c";
+      if (!isSubtreeShortcut && !isVisibleCopyShortcut) return;
+      e.preventDefault();
+      void copySelection({ includeDescendants: isSubtreeShortcut });
     };
     window.addEventListener("keydown", handleKeyDown);
     return () => window.removeEventListener("keydown", handleKeyDown);
-  }, [activeSelectionBounds, enabled, rows]);
+  }, [activeSelectionBounds, copySelection, enableSubtreeCopy, enabled]);
+  const emitRowsPaste = (0, import_react2.useCallback)(
+    (text, mode) => {
+      if (!onRowsPaste || !activeSelectionBounds) return false;
+      const payload = buildRowsPastePayload(
+        rows,
+        activeSelectionBounds.startRow,
+        activeSelectionBounds.startCol,
+        text,
+        mode,
+        activeSelectionBounds.endRow
+      );
+      if (!payload) return false;
+      onRowsPaste(payload);
+      return true;
+    },
+    [activeSelectionBounds, onRowsPaste, rows]
+  );
+  (0, import_react2.useEffect)(() => {
+    if (!enabled || !onRowsPaste) return;
+    const pasteHandledRef = { current: false };
+    const ignoreNextPasteRef = { current: false };
+    const handleKeyDown = (e) => {
+      if (!activeSelectionBounds) return;
+      if (!(e.ctrlKey || e.metaKey)) return;
+      if (e.key.toLowerCase() !== "v") return;
+      if (isEditablePasteTarget(e.target) || isEditablePasteTarget(document.activeElement)) {
+        return;
+      }
+      if (e.shiftKey && !enableInsertPaste) {
+        ignoreNextPasteRef.current = true;
+        pendingPasteModeRef.current = null;
+        return;
+      }
+      const mode = e.shiftKey ? "insert" : "overwrite";
+      pasteHandledRef.current = false;
+      ignoreNextPasteRef.current = false;
+      pendingPasteModeRef.current = mode;
+      void (async () => {
+        try {
+          const text = await navigator.clipboard.readText();
+          if (pasteHandledRef.current) return;
+          if (pendingPasteModeRef.current !== mode) return;
+          if (!text) return;
+          pasteHandledRef.current = true;
+          emitRowsPaste(text, mode);
+          pendingPasteModeRef.current = null;
+        } catch {
+        }
+      })();
+    };
+    const handlePaste = (e) => {
+      if (!activeSelectionBounds) return;
+      if (isEditablePasteTarget(e.target) || isEditablePasteTarget(document.activeElement)) {
+        return;
+      }
+      if (ignoreNextPasteRef.current) {
+        ignoreNextPasteRef.current = false;
+        pendingPasteModeRef.current = null;
+        return;
+      }
+      const mode = pendingPasteModeRef.current ?? "overwrite";
+      if (pasteHandledRef.current) {
+        e.preventDefault();
+        return;
+      }
+      const text = e.clipboardData?.getData("text/plain");
+      if (text == null || text === "") return;
+      pasteHandledRef.current = true;
+      e.preventDefault();
+      emitRowsPaste(text, mode);
+      pendingPasteModeRef.current = null;
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    window.addEventListener("paste", handlePaste);
+    return () => {
+      window.removeEventListener("keydown", handleKeyDown);
+      window.removeEventListener("paste", handlePaste);
+    };
+  }, [
+    activeSelectionBounds,
+    emitRowsPaste,
+    enableInsertPaste,
+    enabled,
+    onRowsPaste
+  ]);
   (0, import_react2.useEffect)(() => {
     if (!enabled) return;
     const handleMouseUp = () => {
@@ -590,7 +979,8 @@ function useCellSelection({
     activeSelectionBounds,
     handleCellMouseDown,
     handleCellMouseEnter,
-    handleFillHandleMouseDown
+    handleFillHandleMouseDown,
+    copySelection
   };
 }
 
@@ -672,15 +1062,16 @@ var useConvertTreeData = ({
       children: [],
       processed: false
     }));
-    const itemMap = /* @__PURE__ */ new Map();
-    dataWithLevels.forEach((item) => {
-      const key = getFieldValue(item, toggleField);
-      if (typeof key !== "string" || !key) return;
-      if (!itemMap.has(key)) {
-        itemMap.set(key, []);
+    const findNearestPrecedingParent = (index, parentKey) => {
+      for (let i = index - 1; i >= 0; i -= 1) {
+        const candidate = dataWithLevels[i];
+        if (!candidate) continue;
+        if (getFieldValue(candidate, toggleField) === parentKey) {
+          return candidate;
+        }
       }
-      itemMap.get(key)?.push(item);
-    });
+      return void 0;
+    };
     const rootItems = [];
     dataWithLevels.forEach((item) => {
       if (!getFieldValue(item, childField)) {
@@ -688,29 +1079,18 @@ var useConvertTreeData = ({
         item.processed = true;
       }
     });
-    dataWithLevels.forEach((item) => {
+    dataWithLevels.forEach((item, index) => {
       const parentKey = getFieldValue(item, childField);
       if (!parentKey || item.processed) return;
-      const parentItems = dataWithLevels.filter(
-        (parent) => getFieldValue(parent, toggleField) === parentKey && !getFieldValue(parent, childField)
-      );
-      if (parentItems.length > 0) {
-        const parent = parentItems[0];
+      const parent = findNearestPrecedingParent(index, parentKey);
+      if (parent) {
         item.level = parent.level + 1;
         parent.children.push(item);
         item.processed = true;
-      } else {
-        const otherParents = itemMap.get(String(parentKey)) || [];
-        if (otherParents.length > 0) {
-          const parent = otherParents[0];
-          item.level = parent.level + 1;
-          parent.children.push(item);
-          item.processed = true;
-        } else {
-          rootItems.push(item);
-          item.processed = true;
-        }
+        return;
       }
+      rootItems.push(item);
+      item.processed = true;
     });
     return rootItems;
   }, [enabled, data, toggleField, childField, flattenField]);
@@ -735,16 +1115,23 @@ var useConvertTreeData = ({
       return result;
     };
     const flattenedData = flatten(processedData, [], 0);
-    flattenedData.forEach((item) => {
-      if (getFieldValue(item, childField)) {
-        const parentItem = flattenedData.find(
-          (parent) => getFieldValue(parent, toggleField) === getFieldValue(item, childField)
-        );
-        const parentAmount = parentItem ? Number(getFieldValue(parentItem, qtyField) ?? 1) : 1;
-        item.parentCount = parentAmount || 1;
-      } else {
+    flattenedData.forEach((item, index) => {
+      const parentKey = getFieldValue(item, childField);
+      if (!parentKey) {
         item.parentCount = 1;
+        return;
       }
+      let parentItem;
+      for (let i = index - 1; i >= 0; i -= 1) {
+        const candidate = flattenedData[i];
+        if (!candidate) continue;
+        if (getFieldValue(candidate, toggleField) === parentKey) {
+          parentItem = candidate;
+          break;
+        }
+      }
+      const parentAmount = parentItem ? Number(getFieldValue(parentItem, qtyField) ?? 1) : 1;
+      item.parentCount = parentAmount || 1;
     });
     return flattenedData;
   }, [
@@ -891,6 +1278,10 @@ function useGlideTable(options) {
     expandedRows: controlledExpandedRows,
     onExpandedRowsChange,
     preventExpand = false,
+    enableSubtreeCopy,
+    onCopyActionsReady,
+    onRowsPaste,
+    enableInsertPaste,
     enableVirtualization = true,
     estimateRowHeight = DATA_TABLE_ROW_HEIGHT,
     virtualOverscan = DATA_TABLE_VIRTUAL_OVERSCAN
@@ -905,12 +1296,12 @@ function useGlideTable(options) {
     };
   }, [labelsProp, emptyText, loadingText, selectionLabel]);
   const enableExpand = Boolean(toggleField);
+  const resolvedEnableSubtreeCopy = enableSubtreeCopy ?? enableExpand;
   const [internalRowSelection, setInternalRowSelection] = (0, import_react4.useState)({});
   const [internalExpandedRows, setInternalExpandedRows] = (0, import_react4.useState)(
     () => /* @__PURE__ */ new Set()
   );
   const [hoveredRowIndex, setHoveredRowIndex] = (0, import_react4.useState)(null);
-  const [hoveredGroupKey, setHoveredGroupKey] = (0, import_react4.useState)(null);
   const scrollRef = (0, import_react4.useRef)(null);
   const shouldVirtualize = enableVirtualization && !enableRowSpan;
   (0, import_react4.useEffect)(() => {
@@ -974,6 +1365,7 @@ function useGlideTable(options) {
     return collectRowSpanColumns(columns);
   }, [enableRowSpan, columns]);
   const primaryRowSpanKey = rowSpanColumnKeys[0]?.rowSpanKey;
+  const primaryRowSpanColumnId = rowSpanColumnKeys[0]?.columnId;
   const columnRowSpanMap = (0, import_react4.useMemo)(
     () => buildColumnRowSpanMap(tableData, rowSpanColumnKeys),
     [tableData, rowSpanColumnKeys]
@@ -992,27 +1384,29 @@ function useGlideTable(options) {
   const totalSize = rowVirtualizer.getTotalSize();
   const paddingTop = virtualRows.length > 0 ? virtualRows[0]?.start ?? 0 : 0;
   const paddingBottom = virtualRows.length > 0 ? totalSize - (virtualRows[virtualRows.length - 1]?.end ?? 0) : 0;
-  const selectedGroupKeys = (0, import_react4.useMemo)(() => {
-    if (!enableRowSpan || !primaryRowSpanKey) return /* @__PURE__ */ new Set();
-    const keys = /* @__PURE__ */ new Set();
+  const selectedRowIndices = (0, import_react4.useMemo)(() => {
+    const indices = /* @__PURE__ */ new Set();
     for (const selectedRow of selectedRows) {
-      const value = selectedRow.original[primaryRowSpanKey];
-      if (value !== null && value !== void 0) keys.add(String(value));
+      indices.add(selectedRow.index);
     }
-    return keys;
-  }, [enableRowSpan, primaryRowSpanKey, selectedRows]);
+    return indices;
+  }, [selectedRows]);
   const {
     dragState,
     activeSelectionBounds,
     handleCellMouseDown,
     handleCellMouseEnter,
-    handleFillHandleMouseDown
+    handleFillHandleMouseDown,
+    copySelection
   } = useCellSelection({
     data: tableData,
     rows,
     enabled: enableCellSelection,
+    enableSubtreeCopy: resolvedEnableSubtreeCopy,
+    enableInsertPaste: enableInsertPaste ?? true,
     onDataChange,
-    onBatchChange
+    onBatchChange,
+    onRowsPaste
   });
   const {
     editingCell,
@@ -1034,22 +1428,10 @@ function useGlideTable(options) {
   );
   const clearHover = (0, import_react4.useCallback)(() => {
     setHoveredRowIndex(null);
-    setHoveredGroupKey(null);
   }, []);
-  const handleRowHover = (0, import_react4.useCallback)(
-    (rowIndex, rowData) => {
-      setHoveredRowIndex(rowIndex);
-      if (!primaryRowSpanKey) {
-        setHoveredGroupKey(null);
-        return;
-      }
-      const groupValue = rowData[primaryRowSpanKey];
-      setHoveredGroupKey(
-        groupValue === null || groupValue === void 0 ? null : String(groupValue)
-      );
-    },
-    [primaryRowSpanKey]
-  );
+  const handleRowHover = (0, import_react4.useCallback)((rowIndex, _rowData) => {
+    setHoveredRowIndex(rowIndex);
+  }, []);
   const handleToggleSelect = (0, import_react4.useCallback)(
     (row) => {
       if (!row.getCanSelect()) return;
@@ -1072,10 +1454,10 @@ function useGlideTable(options) {
       rowSpan: {
         enableRowSpan,
         primaryRowSpanKey,
+        primaryRowSpanColumnId,
         columnRowSpanMap,
         hoveredRowIndex,
-        hoveredGroupKey,
-        selectedGroupKeys,
+        selectedRowIndices,
         onRowHover: handleRowHover
       },
       selection: {
@@ -1113,10 +1495,10 @@ function useGlideTable(options) {
   }, [
     enableRowSpan,
     primaryRowSpanKey,
+    primaryRowSpanColumnId,
     columnRowSpanMap,
     hoveredRowIndex,
-    hoveredGroupKey,
-    selectedGroupKeys,
+    selectedRowIndices,
     handleRowHover,
     rowSelectionMode,
     selectOnRowClick,
@@ -1142,6 +1524,14 @@ function useGlideTable(options) {
     labels.expandRow,
     labels.collapseRow
   ]);
+  const copySelectionRef = (0, import_react4.useRef)(copySelection);
+  (0, import_react4.useEffect)(() => {
+    copySelectionRef.current = copySelection;
+  }, [copySelection]);
+  const stableCopySelection = (0, import_react4.useCallback)((options2) => copySelectionRef.current(options2), []);
+  (0, import_react4.useEffect)(() => {
+    onCopyActionsReady?.({ copySelection: stableCopySelection });
+  }, [onCopyActionsReady, stableCopySelection]);
   return {
     table,
     tableData,
@@ -1161,7 +1551,8 @@ function useGlideTable(options) {
     paddingBottom,
     rowContextValue,
     handleToggleSelect,
-    clearHover
+    clearHover,
+    copySelection: stableCopySelection
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -1176,9 +1567,13 @@ function useGlideTable(options) {
   applyFillData,
   applySelectionUpdater,
   buildColumnRowSpanMap,
+  buildRowsPastePayload,
   canExpandRow,
+  collectCopyRowEntries,
+  collectCopyRows,
   collectFillChanges,
   collectRowSpanColumns,
+  flattenSubtreeRows,
   getCellEditDraftValue,
   getCellSelectionEdgeStyle,
   getColumnEditType,
@@ -1186,13 +1581,22 @@ function useGlideTable(options) {
   hasCellSelectionEdges,
   isCellInSelection,
   isColumnEditable,
+  isEditablePasteTarget,
+  measureMergedSpanRowHeights,
   parseCellEditValue,
+  parseClipboardTSV,
+  parseClipboardTSVWithDepths,
   resolveDataTableLabels,
+  resolvePasteColumnIds,
   resolveRowSelection,
   resolveRowSpanAt,
+  rowRangeToHeightRatios,
+  serializeCopyRowsToTSV,
+  serializeSelectionToTSV,
   toggleExpandedRowId,
   useCellEdit,
   useCellSelection,
   useConvertTreeData,
-  useGlideTable
+  useGlideTable,
+  writeSelectionToClipboard
 });