@lensui/lens-table 0.1.80 → 0.1.81

package/dist/index.cjs

@@ -1929,6 +1929,9 @@ function TableInner({
   defaultSelectedCell,
   onSelectedCellChange,
   rangeSelection = false,
+  selectedRange,
+  defaultSelectedRange,
+  onSelectedRangeChange,
   rowSelection,
   selectedRowKeys,
   defaultSelectedRowKeys,
@@ -2338,6 +2341,20 @@ function TableInner({
   }, [columns, getDataRowKey, rows]);
   const resolvedSelectedCell = (0, import_react8.useMemo)(() => resolveSelectionTarget(selectedCell), [resolveSelectionTarget, selectedCell]);
   const resolvedDefaultSelectedCell = (0, import_react8.useMemo)(() => resolveSelectionTarget(defaultSelectedCell), [defaultSelectedCell, resolveSelectionTarget]);
+  const resolveSelectionRangeTarget = (0, import_react8.useCallback)((target) => {
+    if (target == null) return target;
+    const anchor = resolveSelectionTarget(target.anchor);
+    const focus = resolveSelectionTarget(target.focus);
+    return anchor && focus ? { anchor, focus } : null;
+  }, [resolveSelectionTarget]);
+  const resolvedSelectedRange = (0, import_react8.useMemo)(
+    () => resolveSelectionRangeTarget(selectedRange),
+    [resolveSelectionRangeTarget, selectedRange]
+  );
+  const resolvedDefaultSelectedRange = (0, import_react8.useMemo)(
+    () => resolveSelectionRangeTarget(defaultSelectedRange),
+    [defaultSelectedRange, resolveSelectionRangeTarget]
+  );
   const handleSelectedCellChange = (0, import_react8.useCallback)((next) => {
     if (!onSelectedCellChange) return;
     if (!next) {
@@ -2350,7 +2367,11 @@ function TableInner({
     onSelectedCellChange({ ...next, value });
   }, [columns, onSelectedCellChange, rows]);
   const [selection, setSelection] = useControllableValue(resolvedSelectedCell, resolvedDefaultSelectedCell, handleSelectedCellChange);
-  const [selectionRange, setSelectionRange] = (0, import_react8.useState)(null);
+  const [selectionRange, setSelectionRange] = useControllableValue(
+    resolvedSelectedRange,
+    resolvedDefaultSelectedRange,
+    onSelectedRangeChange
+  );
   const rangeDragRef = (0, import_react8.useRef)(null);
   (0, import_react8.useEffect)(() => {
     if (!selection) return void 0;
@@ -3476,8 +3497,10 @@ function TableInner({
     if (focus.rowIndex === drag.anchor.rowIndex && focus.columnIndex === drag.anchor.columnIndex) return;
     drag.moved = true;
     event.preventDefault();
-    setSelectionRange((current) => current?.focus.rowIndex === focus.rowIndex && current.focus.columnIndex === focus.columnIndex ? current : { anchor: drag.anchor, focus });
-  }, [columns, locateCell]);
+    if (selectionRange?.focus.rowIndex === focus.rowIndex && selectionRange.focus.columnIndex === focus.columnIndex)
+      return;
+    setSelectionRange({ anchor: drag.anchor, focus });
+  }, [columns, locateCell, selectionRange, setSelectionRange]);
   const endRangeDrag = (0, import_react8.useCallback)((event) => {
     const drag = rangeDragRef.current;
     if (!drag) return;
@@ -4876,6 +4899,23 @@ function TableInner({
         setSelection(cell);
         return true;
       },
+      getSelectedRange: () => selectionRange ? { anchor: { ...selectionRange.anchor }, focus: { ...selectionRange.focus } } : null,
+      setSelectedRange: (target) => {
+        if (target === null) {
+          rangeDragRef.current = null;
+          setSelectionRange(null);
+          return true;
+        }
+        if (!rangeSelection) return false;
+        const anchor = resolveDataCell(target.anchor);
+        const focus = resolveDataCell(target.focus);
+        if (!anchor || !focus) return false;
+        rangeDragRef.current = null;
+        setEditing(null);
+        setSelection(null);
+        setSelectionRange({ anchor, focus });
+        return true;
+      },
       getSelectedRowKeys: () => [...rowKeys],
       getSelectedRows: () => rows.filter((row, index) => selectedRowKeySet.has(getRowKey(row, index))),
       setSelectedRowKeys: (keys) => {

package/dist/index.d.cts

@@ -260,6 +260,16 @@ type GridSelectionTarget = {
     rowKey?: GridKey;
     columnIndex?: number;
 };
+/** Fully resolved rectangular cell selection. */
+interface GridSelectionRange {
+    anchor: GridSelection;
+    focus: GridSelection;
+}
+/** Stable locators accepted when restoring a rectangular cell selection. */
+interface GridSelectionRangeTarget {
+    anchor: GridSelectionTarget;
+    focus: GridSelectionTarget;
+}
 /** Fully resolved selected cell returned by onSelectedCellChange. */
 interface SelectedCellChange extends GridSelection {
     value: unknown;
@@ -283,6 +293,9 @@ interface TableRef<Row extends object> {
     scrollToCell: (target: GridSelectionTarget) => boolean;
     getSelectedCell: () => TableCellContext<Row> | null;
     setSelectedCell: (target: GridSelectionTarget | null) => boolean;
+    getSelectedRange: () => GridSelectionRange | null;
+    /** Restore or clear the native range outline; false if range selection is disabled or a target is unavailable. */
+    setSelectedRange: (target: GridSelectionRangeTarget | null) => boolean;
     getSelectedRowKeys: () => GridKey[];
     getSelectedRows: () => Row[];
     setSelectedRowKeys: (keys: GridKey[]) => void;
@@ -402,6 +415,11 @@ interface TableProps<Row extends object> {
     onSelectedCellChange?: (selection: SelectedCellChange | null) => void;
     /** Enable spreadsheet-style mouse drag selection across multiple body cells. Defaults to false. */
     rangeSelection?: boolean;
+    /** Controlled rectangular cell selection. */
+    selectedRange?: GridSelectionRangeTarget | null;
+    /** Initial rectangular cell selection for uncontrolled usage. */
+    defaultSelectedRange?: GridSelectionRangeTarget | null;
+    onSelectedRangeChange?: (range: GridSelectionRange | null) => void;
     rowSelection?: boolean | RowSelectionConfig;
     selectedRowKeys?: GridKey[];
     defaultSelectedRowKeys?: GridKey[];
@@ -513,4 +531,4 @@ declare function hitTestColumn(metrics: ColumnMetric[], contentX: number): numbe
 
 type TableFilterValues = Record<string, string>;
 
-export { type AxisSelectionConfig, type CellChange, type ContextMenuEvent, type GridCellPosition, type GridColumn, type GridKey, type GridSelection, type GridSelectionTarget, type GridSortState, type RowSelectionConfig, type SelectedCellChange, type SelectionMode, type SortDirection, Table, type CellChange as TableCellChange, type TableCellContext, type GridCellPosition as TableCellPosition, type TableCellSpan, type TableCellSpanRule, type TableCellSpanRuleContext, type TableCellSpans, type GridColumn as TableColumn, type TableContextMenu, type TableContextMenuConfig, type ContextMenuEvent as TableContextMenuEvent, type GridSelection as TableEditingCell, type TableFilterValues, type TableHighlightConfig, type GridKey as TableKey, type TableLabels, type TableLayoutConfig, type TableLocaleCode, type TableLocaleConfig, type TableProps, type TableRef, type TableResolvedCellSpan, type TableRowNumberConfig, type GridSortState as TableSorter, type TableSummaryConfig, type TableTooltipConfig, type ViewportRange as TableViewportRange, type TableVirtualizedConfig, Table as VelocityGrid, type TableCellSpan as VelocityGridCellSpan, type TableCellSpanRule as VelocityGridCellSpanRule, type TableCellSpanRuleContext as VelocityGridCellSpanRuleContext, type TableCellSpans as VelocityGridCellSpans, type TableContextMenu as VelocityGridContextMenu, type TableContextMenuConfig as VelocityGridContextMenuConfig, type TableHighlightConfig as VelocityGridHighlightConfig, type TableLabels as VelocityGridLabels, type TableLayoutConfig as VelocityGridLayoutConfig, type TableLocaleCode as VelocityGridLocaleCode, type TableLocaleConfig as VelocityGridLocaleConfig, type TableProps as VelocityGridProps, type TableRef as VelocityGridRef, type TableResolvedCellSpan as VelocityGridResolvedCellSpan, type TableSummaryConfig as VelocityGridSummaryConfig, type TableTooltipConfig as VelocityGridTooltipConfig, type TableVirtualizedConfig as VelocityGridVirtualizedConfig, type ViewportRange, buildColumnMetrics, getViewportRange, hitTestColumn };
+export { type AxisSelectionConfig, type CellChange, type ContextMenuEvent, type GridCellPosition, type GridColumn, type GridKey, type GridSelection, type GridSelectionRange, type GridSelectionRangeTarget, type GridSelectionTarget, type GridSortState, type RowSelectionConfig, type SelectedCellChange, type SelectionMode, type SortDirection, Table, type CellChange as TableCellChange, type TableCellContext, type GridCellPosition as TableCellPosition, type TableCellSpan, type TableCellSpanRule, type TableCellSpanRuleContext, type TableCellSpans, type GridColumn as TableColumn, type TableContextMenu, type TableContextMenuConfig, type ContextMenuEvent as TableContextMenuEvent, type GridSelection as TableEditingCell, type TableFilterValues, type TableHighlightConfig, type GridKey as TableKey, type TableLabels, type TableLayoutConfig, type TableLocaleCode, type TableLocaleConfig, type TableProps, type TableRef, type TableResolvedCellSpan, type TableRowNumberConfig, type GridSortState as TableSorter, type TableSummaryConfig, type TableTooltipConfig, type ViewportRange as TableViewportRange, type TableVirtualizedConfig, Table as VelocityGrid, type TableCellSpan as VelocityGridCellSpan, type TableCellSpanRule as VelocityGridCellSpanRule, type TableCellSpanRuleContext as VelocityGridCellSpanRuleContext, type TableCellSpans as VelocityGridCellSpans, type TableContextMenu as VelocityGridContextMenu, type TableContextMenuConfig as VelocityGridContextMenuConfig, type TableHighlightConfig as VelocityGridHighlightConfig, type TableLabels as VelocityGridLabels, type TableLayoutConfig as VelocityGridLayoutConfig, type TableLocaleCode as VelocityGridLocaleCode, type TableLocaleConfig as VelocityGridLocaleConfig, type TableProps as VelocityGridProps, type TableRef as VelocityGridRef, type TableResolvedCellSpan as VelocityGridResolvedCellSpan, type TableSummaryConfig as VelocityGridSummaryConfig, type TableTooltipConfig as VelocityGridTooltipConfig, type TableVirtualizedConfig as VelocityGridVirtualizedConfig, type ViewportRange, buildColumnMetrics, getViewportRange, hitTestColumn };

package/dist/index.d.ts

@@ -260,6 +260,16 @@ type GridSelectionTarget = {
     rowKey?: GridKey;
     columnIndex?: number;
 };
+/** Fully resolved rectangular cell selection. */
+interface GridSelectionRange {
+    anchor: GridSelection;
+    focus: GridSelection;
+}
+/** Stable locators accepted when restoring a rectangular cell selection. */
+interface GridSelectionRangeTarget {
+    anchor: GridSelectionTarget;
+    focus: GridSelectionTarget;
+}
 /** Fully resolved selected cell returned by onSelectedCellChange. */
 interface SelectedCellChange extends GridSelection {
     value: unknown;
@@ -283,6 +293,9 @@ interface TableRef<Row extends object> {
     scrollToCell: (target: GridSelectionTarget) => boolean;
     getSelectedCell: () => TableCellContext<Row> | null;
     setSelectedCell: (target: GridSelectionTarget | null) => boolean;
+    getSelectedRange: () => GridSelectionRange | null;
+    /** Restore or clear the native range outline; false if range selection is disabled or a target is unavailable. */
+    setSelectedRange: (target: GridSelectionRangeTarget | null) => boolean;
     getSelectedRowKeys: () => GridKey[];
     getSelectedRows: () => Row[];
     setSelectedRowKeys: (keys: GridKey[]) => void;
@@ -402,6 +415,11 @@ interface TableProps<Row extends object> {
     onSelectedCellChange?: (selection: SelectedCellChange | null) => void;
     /** Enable spreadsheet-style mouse drag selection across multiple body cells. Defaults to false. */
     rangeSelection?: boolean;
+    /** Controlled rectangular cell selection. */
+    selectedRange?: GridSelectionRangeTarget | null;
+    /** Initial rectangular cell selection for uncontrolled usage. */
+    defaultSelectedRange?: GridSelectionRangeTarget | null;
+    onSelectedRangeChange?: (range: GridSelectionRange | null) => void;
     rowSelection?: boolean | RowSelectionConfig;
     selectedRowKeys?: GridKey[];
     defaultSelectedRowKeys?: GridKey[];
@@ -513,4 +531,4 @@ declare function hitTestColumn(metrics: ColumnMetric[], contentX: number): numbe
 
 type TableFilterValues = Record<string, string>;
 
-export { type AxisSelectionConfig, type CellChange, type ContextMenuEvent, type GridCellPosition, type GridColumn, type GridKey, type GridSelection, type GridSelectionTarget, type GridSortState, type RowSelectionConfig, type SelectedCellChange, type SelectionMode, type SortDirection, Table, type CellChange as TableCellChange, type TableCellContext, type GridCellPosition as TableCellPosition, type TableCellSpan, type TableCellSpanRule, type TableCellSpanRuleContext, type TableCellSpans, type GridColumn as TableColumn, type TableContextMenu, type TableContextMenuConfig, type ContextMenuEvent as TableContextMenuEvent, type GridSelection as TableEditingCell, type TableFilterValues, type TableHighlightConfig, type GridKey as TableKey, type TableLabels, type TableLayoutConfig, type TableLocaleCode, type TableLocaleConfig, type TableProps, type TableRef, type TableResolvedCellSpan, type TableRowNumberConfig, type GridSortState as TableSorter, type TableSummaryConfig, type TableTooltipConfig, type ViewportRange as TableViewportRange, type TableVirtualizedConfig, Table as VelocityGrid, type TableCellSpan as VelocityGridCellSpan, type TableCellSpanRule as VelocityGridCellSpanRule, type TableCellSpanRuleContext as VelocityGridCellSpanRuleContext, type TableCellSpans as VelocityGridCellSpans, type TableContextMenu as VelocityGridContextMenu, type TableContextMenuConfig as VelocityGridContextMenuConfig, type TableHighlightConfig as VelocityGridHighlightConfig, type TableLabels as VelocityGridLabels, type TableLayoutConfig as VelocityGridLayoutConfig, type TableLocaleCode as VelocityGridLocaleCode, type TableLocaleConfig as VelocityGridLocaleConfig, type TableProps as VelocityGridProps, type TableRef as VelocityGridRef, type TableResolvedCellSpan as VelocityGridResolvedCellSpan, type TableSummaryConfig as VelocityGridSummaryConfig, type TableTooltipConfig as VelocityGridTooltipConfig, type TableVirtualizedConfig as VelocityGridVirtualizedConfig, type ViewportRange, buildColumnMetrics, getViewportRange, hitTestColumn };
+export { type AxisSelectionConfig, type CellChange, type ContextMenuEvent, type GridCellPosition, type GridColumn, type GridKey, type GridSelection, type GridSelectionRange, type GridSelectionRangeTarget, type GridSelectionTarget, type GridSortState, type RowSelectionConfig, type SelectedCellChange, type SelectionMode, type SortDirection, Table, type CellChange as TableCellChange, type TableCellContext, type GridCellPosition as TableCellPosition, type TableCellSpan, type TableCellSpanRule, type TableCellSpanRuleContext, type TableCellSpans, type GridColumn as TableColumn, type TableContextMenu, type TableContextMenuConfig, type ContextMenuEvent as TableContextMenuEvent, type GridSelection as TableEditingCell, type TableFilterValues, type TableHighlightConfig, type GridKey as TableKey, type TableLabels, type TableLayoutConfig, type TableLocaleCode, type TableLocaleConfig, type TableProps, type TableRef, type TableResolvedCellSpan, type TableRowNumberConfig, type GridSortState as TableSorter, type TableSummaryConfig, type TableTooltipConfig, type ViewportRange as TableViewportRange, type TableVirtualizedConfig, Table as VelocityGrid, type TableCellSpan as VelocityGridCellSpan, type TableCellSpanRule as VelocityGridCellSpanRule, type TableCellSpanRuleContext as VelocityGridCellSpanRuleContext, type TableCellSpans as VelocityGridCellSpans, type TableContextMenu as VelocityGridContextMenu, type TableContextMenuConfig as VelocityGridContextMenuConfig, type TableHighlightConfig as VelocityGridHighlightConfig, type TableLabels as VelocityGridLabels, type TableLayoutConfig as VelocityGridLayoutConfig, type TableLocaleCode as VelocityGridLocaleCode, type TableLocaleConfig as VelocityGridLocaleConfig, type TableProps as VelocityGridProps, type TableRef as VelocityGridRef, type TableResolvedCellSpan as VelocityGridResolvedCellSpan, type TableSummaryConfig as VelocityGridSummaryConfig, type TableTooltipConfig as VelocityGridTooltipConfig, type TableVirtualizedConfig as VelocityGridVirtualizedConfig, type ViewportRange, buildColumnMetrics, getViewportRange, hitTestColumn };

package/dist/index.js

@@ -1899,6 +1899,9 @@ function TableInner({
   defaultSelectedCell,
   onSelectedCellChange,
   rangeSelection = false,
+  selectedRange,
+  defaultSelectedRange,
+  onSelectedRangeChange,
   rowSelection,
   selectedRowKeys,
   defaultSelectedRowKeys,
@@ -2308,6 +2311,20 @@ function TableInner({
   }, [columns, getDataRowKey, rows]);
   const resolvedSelectedCell = useMemo2(() => resolveSelectionTarget(selectedCell), [resolveSelectionTarget, selectedCell]);
   const resolvedDefaultSelectedCell = useMemo2(() => resolveSelectionTarget(defaultSelectedCell), [defaultSelectedCell, resolveSelectionTarget]);
+  const resolveSelectionRangeTarget = useCallback2((target) => {
+    if (target == null) return target;
+    const anchor = resolveSelectionTarget(target.anchor);
+    const focus = resolveSelectionTarget(target.focus);
+    return anchor && focus ? { anchor, focus } : null;
+  }, [resolveSelectionTarget]);
+  const resolvedSelectedRange = useMemo2(
+    () => resolveSelectionRangeTarget(selectedRange),
+    [resolveSelectionRangeTarget, selectedRange]
+  );
+  const resolvedDefaultSelectedRange = useMemo2(
+    () => resolveSelectionRangeTarget(defaultSelectedRange),
+    [defaultSelectedRange, resolveSelectionRangeTarget]
+  );
   const handleSelectedCellChange = useCallback2((next) => {
     if (!onSelectedCellChange) return;
     if (!next) {
@@ -2320,7 +2337,11 @@ function TableInner({
     onSelectedCellChange({ ...next, value });
   }, [columns, onSelectedCellChange, rows]);
   const [selection, setSelection] = useControllableValue(resolvedSelectedCell, resolvedDefaultSelectedCell, handleSelectedCellChange);
-  const [selectionRange, setSelectionRange] = useState6(null);
+  const [selectionRange, setSelectionRange] = useControllableValue(
+    resolvedSelectedRange,
+    resolvedDefaultSelectedRange,
+    onSelectedRangeChange
+  );
   const rangeDragRef = useRef4(null);
   useEffect3(() => {
     if (!selection) return void 0;
@@ -3446,8 +3467,10 @@ function TableInner({
     if (focus.rowIndex === drag.anchor.rowIndex && focus.columnIndex === drag.anchor.columnIndex) return;
     drag.moved = true;
     event.preventDefault();
-    setSelectionRange((current) => current?.focus.rowIndex === focus.rowIndex && current.focus.columnIndex === focus.columnIndex ? current : { anchor: drag.anchor, focus });
-  }, [columns, locateCell]);
+    if (selectionRange?.focus.rowIndex === focus.rowIndex && selectionRange.focus.columnIndex === focus.columnIndex)
+      return;
+    setSelectionRange({ anchor: drag.anchor, focus });
+  }, [columns, locateCell, selectionRange, setSelectionRange]);
   const endRangeDrag = useCallback2((event) => {
     const drag = rangeDragRef.current;
     if (!drag) return;
@@ -4846,6 +4869,23 @@ function TableInner({
         setSelection(cell);
         return true;
       },
+      getSelectedRange: () => selectionRange ? { anchor: { ...selectionRange.anchor }, focus: { ...selectionRange.focus } } : null,
+      setSelectedRange: (target) => {
+        if (target === null) {
+          rangeDragRef.current = null;
+          setSelectionRange(null);
+          return true;
+        }
+        if (!rangeSelection) return false;
+        const anchor = resolveDataCell(target.anchor);
+        const focus = resolveDataCell(target.focus);
+        if (!anchor || !focus) return false;
+        rangeDragRef.current = null;
+        setEditing(null);
+        setSelection(null);
+        setSelectionRange({ anchor, focus });
+        return true;
+      },
       getSelectedRowKeys: () => [...rowKeys],
       getSelectedRows: () => rows.filter((row, index) => selectedRowKeySet.has(getRowKey(row, index))),
       setSelectedRowKeys: (keys) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensui/lens-table",
-  "version": "0.1.80",
+  "version": "0.1.81",
   "description": "A lightweight, canvas-rendered React table component for LensUI.",
   "type": "module",
   "main": "./dist/index.cjs",