react-glide-table 1.1.5 → 1.1.6

package/dist/core.d.cts

@@ -1,5 +1,5 @@
-import { C as CellEditType, a as DataTableClassNames, R as RowSelectionMode, c as DataTableProps, b as DataTableLabels } from './types-BfthylVR.cjs';
-export { D as DEFAULT_DATA_TABLE_LABELS, r as resolveDataTableLabels } from './types-BfthylVR.cjs';
+import { C as CellEditType, a as DataTableClassNames, R as RowSelectionMode, d as DataTableProps, c as DataTableLabels, b as DataTableCopyActions, P as PasteMode, f as RowsPastePayload } from './types-DOLnknDe.cjs';
+export { D as DEFAULT_DATA_TABLE_LABELS, r as resolveDataTableLabels } from './types-DOLnknDe.cjs';
 import { Row, ColumnDef, Table, Updater, RowSelectionState } from '@tanstack/react-table';
 export { ColumnDef, RowSelectionState } from '@tanstack/react-table';
 import { Virtualizer, VirtualItem } from '@tanstack/react-virtual';
@@ -133,10 +133,10 @@ type DataTableRowContextValue = {
     rowSpan: {
         enableRowSpan: boolean;
         primaryRowSpanKey?: string;
+        primaryRowSpanColumnId?: string;
         columnRowSpanMap: ColumnRowSpanMap;
         hoveredRowIndex: number | null;
-        hoveredGroupKey: string | null;
-        selectedGroupKeys: Set<string>;
+        selectedRowIndices: Set<number>;
         onRowHover: (rowIndex: number, rowData: RowData) => void;
     };
     selection: {
@@ -193,6 +193,7 @@ type UseGlideTableResult<T extends Record<string, unknown>> = {
     rowContextValue: DataTableRowContextValue;
     handleToggleSelect: (row: Row<T>) => void;
     clearHover: () => void;
+    copySelection: DataTableCopyActions["copySelection"];
 };
 declare function useGlideTable<T extends Record<string, unknown>>(options: UseGlideTableOptions<T>): UseGlideTableResult<T>;
 
@@ -211,25 +212,73 @@ declare function useCellEdit<T extends Record<string, unknown>>({ data, rows, on
     cancelEdit: () => void;
 };
 
+type ParsedClipboardTSV = {
+    values: string[][];
+    /**
+     * Relative tree depth per row when the TSV looks like subtree-copy indentation
+     * (first row unindented, at least one later row with leading empty cells).
+     * Otherwise all zeros — leading blanks are preserved as real cell values.
+     */
+    depths: number[];
+};
+/** Parse Excel/Sheets-style TSV from the clipboard. Trailing newlines are ignored. */
+declare function parseClipboardTSV(text: string): string[][];
+/**
+ * Parse TSV and recover relative tree depth from leading tabs
+ * (encoded by subtree copy as leading empty cells).
+ */
+declare function parseClipboardTSVWithDepths(text: string): ParsedClipboardTSV;
+/** Resolve visible column ids starting at `startCol` for `width` columns. */
+declare function resolvePasteColumnIds<T extends Record<string, unknown>>(rows: Row<T>[], startCol: number, width: number): string[];
+declare function buildRowsPastePayload<T extends Record<string, unknown>>(rows: Row<T>[], startRow: number, startCol: number, text: string, mode: PasteMode, endRow?: number): RowsPastePayload | null;
+declare function isEditablePasteTarget(target: EventTarget | null): boolean;
+
+type CopySelectionOptions = {
+    /** When true, collapsed tree descendants are included. Defaults to false. */
+    includeDescendants?: boolean;
+};
 type UseCellSelectionOptions<T extends Record<string, unknown>> = {
     data: T[];
     rows: Row<T>[];
     enabled?: boolean;
+    /** Enables Ctrl/Cmd+Shift+C subtree copy. Defaults to true when tree expand is enabled. */
+    enableSubtreeCopy?: boolean;
+    /** Enables Ctrl/Cmd+Shift+V insert paste. Defaults to true. */
+    enableInsertPaste?: boolean;
     onDataChange?: (data: T[]) => void;
     onBatchChange?: (changes: Array<{
         rowId: string;
         columnId: string;
         value: unknown;
     }>) => void;
+    onRowsPaste?: (payload: RowsPastePayload) => void;
 };
-declare function useCellSelection<T extends Record<string, unknown>>({ data, rows, enabled, onDataChange, onBatchChange, }: UseCellSelectionOptions<T>): {
+declare function useCellSelection<T extends Record<string, unknown>>({ data, rows, enabled, enableSubtreeCopy, enableInsertPaste, onDataChange, onBatchChange, onRowsPaste, }: UseCellSelectionOptions<T>): {
     dragState: DragState;
     activeSelectionBounds: CellSelectionBounds | null;
     handleCellMouseDown: (rowIndex: number, colIndex: number) => void;
     handleCellMouseEnter: (rowIndex: number, colIndex: number) => void;
     handleFillHandleMouseDown: (rowIndex: number, colIndex: number) => void;
+    copySelection: (options?: CopySelectionOptions) => Promise<boolean>;
 };
 
+type CopySelectionMode = "visible" | "subtree";
+type CopyRowEntry<T extends Record<string, unknown>> = {
+    row: T;
+    /** Tree depth relative to the table root (0 = top-level). */
+    depth: number;
+};
+declare function flattenSubtreeRows<T extends Record<string, unknown>>(row: T): T[];
+/**
+ * Collects copy rows with tree depth so paste can rebuild parent/child nesting.
+ * Descendant depth is derived from the walk, not only from `level`.
+ */
+declare function collectCopyRowEntries<T extends Record<string, unknown>>(visibleRows: Row<T>[], bounds: CellSelectionBounds, mode?: CopySelectionMode): CopyRowEntry<T>[];
+declare function collectCopyRows<T extends Record<string, unknown>>(visibleRows: Row<T>[], bounds: CellSelectionBounds, mode?: CopySelectionMode): T[];
+declare function serializeCopyRowsToTSV<T extends Record<string, unknown>>(copyRows: T[], visibleRows: Row<T>[], bounds: CellSelectionBounds, depths?: number[]): string;
+declare function serializeSelectionToTSV<T extends Record<string, unknown>>(visibleRows: Row<T>[], bounds: CellSelectionBounds, mode?: CopySelectionMode): string;
+declare function writeSelectionToClipboard<T extends Record<string, unknown>>(visibleRows: Row<T>[], bounds: CellSelectionBounds, mode?: CopySelectionMode): Promise<boolean>;
+
 type CellChange = {
     rowId: string;
     columnId: string;
@@ -268,10 +317,14 @@ declare function toggleExpandedRowId(rowId: string, previous: Set<string>): Set<
 /**
  * Builds a tree from flat/nested data, then returns only rows visible under expandedRows.
  * When enabled=false, returns data as-is.
+ *
+ * Flat rows attach to the nearest *preceding* parent with a matching toggle key
+ * (so duplicate keys after paste stay under the pasted parent). Parents must appear
+ * before their children; a child whose parent is later in the array becomes a root.
  */
 declare const useConvertTreeData: <T extends Record<string, unknown>>({ data, enabled, toggleField, childField, flattenField, qtyField, preventExpand, startIndex, expandedRows, onExpandedRowsChange, }: UseConvertTreeDataParams<T>) => T[];
 
 declare function resolveRowSelection(mode: RowSelectionMode, controlledSelection: RowSelectionState | undefined, internalSelection: RowSelectionState): RowSelectionState;
 declare function applySelectionUpdater(mode: RowSelectionMode, updater: Updater<RowSelectionState>, previous: RowSelectionState): RowSelectionState;
 
-export { CELL_SELECTION_EDGES_CLASS, type CellSelectionBounds, type ColumnRowSpanMap, DEFAULT_TREE_CHILDREN_FIELD, DEFAULT_TREE_ID_FIELD, DEFAULT_TREE_PARENT_ID_FIELD, DEFAULT_TREE_QTY_FIELD, DataTableLabels, DataTableProps, type DragState, type EditingCell, RowSelectionMode, type RowSpanInfo, type TreeRow, type UseConvertTreeDataParams, type UseGlideTableOptions, type UseGlideTableResult, applyCellEdit, applyFillData, applySelectionUpdater, buildColumnRowSpanMap, canExpandRow, collectFillChanges, collectRowSpanColumns, getCellEditDraftValue, getCellSelectionEdgeStyle, getColumnEditType, getRowIndexInMergedCell, hasCellSelectionEdges, isCellInSelection, isColumnEditable, measureMergedSpanRowHeights, parseCellEditValue, resolveRowSelection, resolveRowSpanAt, rowRangeToHeightRatios, toggleExpandedRowId, useCellEdit, useCellSelection, useConvertTreeData, useGlideTable };
+export { CELL_SELECTION_EDGES_CLASS, type CellSelectionBounds, type ColumnRowSpanMap, type CopyRowEntry, type CopySelectionMode, DEFAULT_TREE_CHILDREN_FIELD, DEFAULT_TREE_ID_FIELD, DEFAULT_TREE_PARENT_ID_FIELD, DEFAULT_TREE_QTY_FIELD, DataTableCopyActions, DataTableLabels, DataTableProps, type DragState, type EditingCell, PasteMode, RowSelectionMode, type RowSpanInfo, RowsPastePayload, type TreeRow, type UseConvertTreeDataParams, type UseGlideTableOptions, type UseGlideTableResult, applyCellEdit, applyFillData, applySelectionUpdater, buildColumnRowSpanMap, buildRowsPastePayload, canExpandRow, collectCopyRowEntries, collectCopyRows, collectFillChanges, collectRowSpanColumns, flattenSubtreeRows, getCellEditDraftValue, getCellSelectionEdgeStyle, getColumnEditType, getRowIndexInMergedCell, hasCellSelectionEdges, isCellInSelection, isColumnEditable, isEditablePasteTarget, measureMergedSpanRowHeights, parseCellEditValue, parseClipboardTSV, parseClipboardTSVWithDepths, resolvePasteColumnIds, resolveRowSelection, resolveRowSpanAt, rowRangeToHeightRatios, serializeCopyRowsToTSV, serializeSelectionToTSV, toggleExpandedRowId, useCellEdit, useCellSelection, useConvertTreeData, useGlideTable, writeSelectionToClipboard };

package/dist/core.d.ts

@@ -1,5 +1,5 @@
-import { C as CellEditType, a as DataTableClassNames, R as RowSelectionMode, c as DataTableProps, b as DataTableLabels } from './types-BfthylVR.js';
-export { D as DEFAULT_DATA_TABLE_LABELS, r as resolveDataTableLabels } from './types-BfthylVR.js';
+import { C as CellEditType, a as DataTableClassNames, R as RowSelectionMode, d as DataTableProps, c as DataTableLabels, b as DataTableCopyActions, P as PasteMode, f as RowsPastePayload } from './types-DOLnknDe.js';
+export { D as DEFAULT_DATA_TABLE_LABELS, r as resolveDataTableLabels } from './types-DOLnknDe.js';
 import { Row, ColumnDef, Table, Updater, RowSelectionState } from '@tanstack/react-table';
 export { ColumnDef, RowSelectionState } from '@tanstack/react-table';
 import { Virtualizer, VirtualItem } from '@tanstack/react-virtual';
@@ -133,10 +133,10 @@ type DataTableRowContextValue = {
     rowSpan: {
         enableRowSpan: boolean;
         primaryRowSpanKey?: string;
+        primaryRowSpanColumnId?: string;
         columnRowSpanMap: ColumnRowSpanMap;
         hoveredRowIndex: number | null;
-        hoveredGroupKey: string | null;
-        selectedGroupKeys: Set<string>;
+        selectedRowIndices: Set<number>;
         onRowHover: (rowIndex: number, rowData: RowData) => void;
     };
     selection: {
@@ -193,6 +193,7 @@ type UseGlideTableResult<T extends Record<string, unknown>> = {
     rowContextValue: DataTableRowContextValue;
     handleToggleSelect: (row: Row<T>) => void;
     clearHover: () => void;
+    copySelection: DataTableCopyActions["copySelection"];
 };
 declare function useGlideTable<T extends Record<string, unknown>>(options: UseGlideTableOptions<T>): UseGlideTableResult<T>;
 
@@ -211,25 +212,73 @@ declare function useCellEdit<T extends Record<string, unknown>>({ data, rows, on
     cancelEdit: () => void;
 };
 
+type ParsedClipboardTSV = {
+    values: string[][];
+    /**
+     * Relative tree depth per row when the TSV looks like subtree-copy indentation
+     * (first row unindented, at least one later row with leading empty cells).
+     * Otherwise all zeros — leading blanks are preserved as real cell values.
+     */
+    depths: number[];
+};
+/** Parse Excel/Sheets-style TSV from the clipboard. Trailing newlines are ignored. */
+declare function parseClipboardTSV(text: string): string[][];
+/**
+ * Parse TSV and recover relative tree depth from leading tabs
+ * (encoded by subtree copy as leading empty cells).
+ */
+declare function parseClipboardTSVWithDepths(text: string): ParsedClipboardTSV;
+/** Resolve visible column ids starting at `startCol` for `width` columns. */
+declare function resolvePasteColumnIds<T extends Record<string, unknown>>(rows: Row<T>[], startCol: number, width: number): string[];
+declare function buildRowsPastePayload<T extends Record<string, unknown>>(rows: Row<T>[], startRow: number, startCol: number, text: string, mode: PasteMode, endRow?: number): RowsPastePayload | null;
+declare function isEditablePasteTarget(target: EventTarget | null): boolean;
+
+type CopySelectionOptions = {
+    /** When true, collapsed tree descendants are included. Defaults to false. */
+    includeDescendants?: boolean;
+};
 type UseCellSelectionOptions<T extends Record<string, unknown>> = {
     data: T[];
     rows: Row<T>[];
     enabled?: boolean;
+    /** Enables Ctrl/Cmd+Shift+C subtree copy. Defaults to true when tree expand is enabled. */
+    enableSubtreeCopy?: boolean;
+    /** Enables Ctrl/Cmd+Shift+V insert paste. Defaults to true. */
+    enableInsertPaste?: boolean;
     onDataChange?: (data: T[]) => void;
     onBatchChange?: (changes: Array<{
         rowId: string;
         columnId: string;
         value: unknown;
     }>) => void;
+    onRowsPaste?: (payload: RowsPastePayload) => void;
 };
-declare function useCellSelection<T extends Record<string, unknown>>({ data, rows, enabled, onDataChange, onBatchChange, }: UseCellSelectionOptions<T>): {
+declare function useCellSelection<T extends Record<string, unknown>>({ data, rows, enabled, enableSubtreeCopy, enableInsertPaste, onDataChange, onBatchChange, onRowsPaste, }: UseCellSelectionOptions<T>): {
     dragState: DragState;
     activeSelectionBounds: CellSelectionBounds | null;
     handleCellMouseDown: (rowIndex: number, colIndex: number) => void;
     handleCellMouseEnter: (rowIndex: number, colIndex: number) => void;
     handleFillHandleMouseDown: (rowIndex: number, colIndex: number) => void;
+    copySelection: (options?: CopySelectionOptions) => Promise<boolean>;
 };
 
+type CopySelectionMode = "visible" | "subtree";
+type CopyRowEntry<T extends Record<string, unknown>> = {
+    row: T;
+    /** Tree depth relative to the table root (0 = top-level). */
+    depth: number;
+};
+declare function flattenSubtreeRows<T extends Record<string, unknown>>(row: T): T[];
+/**
+ * Collects copy rows with tree depth so paste can rebuild parent/child nesting.
+ * Descendant depth is derived from the walk, not only from `level`.
+ */
+declare function collectCopyRowEntries<T extends Record<string, unknown>>(visibleRows: Row<T>[], bounds: CellSelectionBounds, mode?: CopySelectionMode): CopyRowEntry<T>[];
+declare function collectCopyRows<T extends Record<string, unknown>>(visibleRows: Row<T>[], bounds: CellSelectionBounds, mode?: CopySelectionMode): T[];
+declare function serializeCopyRowsToTSV<T extends Record<string, unknown>>(copyRows: T[], visibleRows: Row<T>[], bounds: CellSelectionBounds, depths?: number[]): string;
+declare function serializeSelectionToTSV<T extends Record<string, unknown>>(visibleRows: Row<T>[], bounds: CellSelectionBounds, mode?: CopySelectionMode): string;
+declare function writeSelectionToClipboard<T extends Record<string, unknown>>(visibleRows: Row<T>[], bounds: CellSelectionBounds, mode?: CopySelectionMode): Promise<boolean>;
+
 type CellChange = {
     rowId: string;
     columnId: string;
@@ -268,10 +317,14 @@ declare function toggleExpandedRowId(rowId: string, previous: Set<string>): Set<
 /**
  * Builds a tree from flat/nested data, then returns only rows visible under expandedRows.
  * When enabled=false, returns data as-is.
+ *
+ * Flat rows attach to the nearest *preceding* parent with a matching toggle key
+ * (so duplicate keys after paste stay under the pasted parent). Parents must appear
+ * before their children; a child whose parent is later in the array becomes a root.
  */
 declare const useConvertTreeData: <T extends Record<string, unknown>>({ data, enabled, toggleField, childField, flattenField, qtyField, preventExpand, startIndex, expandedRows, onExpandedRowsChange, }: UseConvertTreeDataParams<T>) => T[];
 
 declare function resolveRowSelection(mode: RowSelectionMode, controlledSelection: RowSelectionState | undefined, internalSelection: RowSelectionState): RowSelectionState;
 declare function applySelectionUpdater(mode: RowSelectionMode, updater: Updater<RowSelectionState>, previous: RowSelectionState): RowSelectionState;
 
-export { CELL_SELECTION_EDGES_CLASS, type CellSelectionBounds, type ColumnRowSpanMap, DEFAULT_TREE_CHILDREN_FIELD, DEFAULT_TREE_ID_FIELD, DEFAULT_TREE_PARENT_ID_FIELD, DEFAULT_TREE_QTY_FIELD, DataTableLabels, DataTableProps, type DragState, type EditingCell, RowSelectionMode, type RowSpanInfo, type TreeRow, type UseConvertTreeDataParams, type UseGlideTableOptions, type UseGlideTableResult, applyCellEdit, applyFillData, applySelectionUpdater, buildColumnRowSpanMap, canExpandRow, collectFillChanges, collectRowSpanColumns, getCellEditDraftValue, getCellSelectionEdgeStyle, getColumnEditType, getRowIndexInMergedCell, hasCellSelectionEdges, isCellInSelection, isColumnEditable, measureMergedSpanRowHeights, parseCellEditValue, resolveRowSelection, resolveRowSpanAt, rowRangeToHeightRatios, toggleExpandedRowId, useCellEdit, useCellSelection, useConvertTreeData, useGlideTable };
+export { CELL_SELECTION_EDGES_CLASS, type CellSelectionBounds, type ColumnRowSpanMap, type CopyRowEntry, type CopySelectionMode, DEFAULT_TREE_CHILDREN_FIELD, DEFAULT_TREE_ID_FIELD, DEFAULT_TREE_PARENT_ID_FIELD, DEFAULT_TREE_QTY_FIELD, DataTableCopyActions, DataTableLabels, DataTableProps, type DragState, type EditingCell, PasteMode, RowSelectionMode, type RowSpanInfo, RowsPastePayload, type TreeRow, type UseConvertTreeDataParams, type UseGlideTableOptions, type UseGlideTableResult, applyCellEdit, applyFillData, applySelectionUpdater, buildColumnRowSpanMap, buildRowsPastePayload, canExpandRow, collectCopyRowEntries, collectCopyRows, collectFillChanges, collectRowSpanColumns, flattenSubtreeRows, getCellEditDraftValue, getCellSelectionEdgeStyle, getColumnEditType, getRowIndexInMergedCell, hasCellSelectionEdges, isCellInSelection, isColumnEditable, isEditablePasteTarget, measureMergedSpanRowHeights, parseCellEditValue, parseClipboardTSV, parseClipboardTSVWithDepths, resolvePasteColumnIds, resolveRowSelection, resolveRowSpanAt, rowRangeToHeightRatios, serializeCopyRowsToTSV, serializeSelectionToTSV, toggleExpandedRowId, useCellEdit, useCellSelection, useConvertTreeData, useGlideTable, writeSelectionToClipboard };