react-glide-table 1.1.8 → 1.2.0

package/dist/{types-Ce4qepIU.d.ts → types-D031_07N.d.ts}

@@ -1,5 +1,42 @@
-import { ColumnDef, RowSelectionState, Updater, Row } from '@tanstack/react-table';
-import { ReactNode, InputHTMLAttributes, ComponentType } from 'react';
+import { ColumnDef, RowSelectionState, Updater, ColumnSizingState, OnChangeFn, ColumnResizeMode, Row } from '@tanstack/react-table';
+import { CSSProperties, ReactNode, InputHTMLAttributes, ComponentType } from 'react';
+
+/** Sticky edge for a frozen column. Does not reorder columns. */
+type ColumnFreezeSide = "left" | "right";
+/**
+ * Per-column freeze flag.
+ * `true` is sugar for `"left"`.
+ */
+type ColumnFreezeMeta = boolean | ColumnFreezeSide;
+type ColumnFreezeColumnInput = {
+    id: string;
+    size: number;
+    side?: ColumnFreezeSide;
+};
+type ColumnFreezeOffset = {
+    side: ColumnFreezeSide;
+    /** Cumulative sticky inset (`left` or `right` in px). */
+    offset: number;
+    /** Inner edge of the sticky group (shadow / divider). */
+    isEdge: boolean;
+    /** Relative stack order within the freeze side (higher = closer to the viewport edge). */
+    stack: number;
+};
+/** Normalize column `frozen` meta into a sticky side. */
+declare function resolveColumnFreezeSide(frozen?: ColumnFreezeMeta): ColumnFreezeSide | undefined;
+/**
+ * Build sticky insets for frozen columns without changing DOM/column order.
+ *
+ * - `left`: `left = Σ(widths of left-frozen columns before this one)`
+ * - `right`: `right = Σ(widths of right-frozen columns after this one)`
+ *
+ * Middle columns may be frozen; non-frozen neighbors scroll underneath.
+ */
+declare function buildColumnFreezeOffsets(columns: ColumnFreezeColumnInput[]): Map<string, ColumnFreezeOffset>;
+/** Sticky position styles for a frozen header or body cell. */
+declare function getColumnFreezeStyle(offset: ColumnFreezeOffset | undefined, options?: {
+    isHeader?: boolean;
+}): CSSProperties | undefined;
 
 type DataTableLabels = {
     empty: string;
@@ -7,6 +44,8 @@ type DataTableLabels = {
     selection: (selectedCount: number) => ReactNode;
     expandRow: string;
     collapseRow: string;
+    /** Accessible label for the column resize handle */
+    resizeColumn: string;
 };
 /** Default copy. Override via the `labels` option. */
 declare const DEFAULT_DATA_TABLE_LABELS: DataTableLabels;
@@ -31,6 +70,21 @@ declare module "@tanstack/react-table" {
         editType?: CellEditType;
         /** Inline editor input attribute overrides */
         editInputProps?: DataTableEditInputProps;
+        /**
+         * Freeze (sticky) this column without reordering.
+         * `true` / `"left"` stick to the scrollport left; `"right"` to the right.
+         * Middle columns are allowed; multiple frozen columns stack via cumulative offsets.
+         */
+        frozen?: ColumnFreezeMeta;
+    }
+    interface Row<TData> {
+        /**
+         * Returns whether this row's cell is inside the active drag selection.
+         * Attached at render time by DataTableRow (optional outside that renderer).
+         * - `columnId` omitted: true when any visible cell in the row is selected.
+         * - `columnId` provided: checks only that column (row-span aware via merge origin).
+         */
+        getIsCellDragSelected?: (columnId?: string) => boolean;
     }
 }
 type DataTableCopyActions = {
@@ -171,6 +225,25 @@ type DataTableProps<T extends Record<string, unknown>> = {
     estimateRowHeight?: number;
     /** Virtualization overscan row count. Default 8 */
     virtualOverscan?: number;
+    /**
+     * Enable drag-to-resize on column headers. Defaults to false.
+     * Opt out per column with `Column.resizable={false}` / `enableResizing: false`.
+     */
+    enableColumnResize?: boolean;
+    /** Controlled column sizing map (`{ [columnId]: widthPx }`) */
+    columnSizing?: ColumnSizingState;
+    onColumnSizingChange?: OnChangeFn<ColumnSizingState>;
+    /**
+     * When to commit resize updates. Defaults to `"onChange"` (live while dragging).
+     * Use `"onEnd"` to update only after the pointer is released.
+     */
+    columnResizeMode?: ColumnResizeMode;
+    /**
+     * Enable sticky freeze columns. Defaults to false.
+     * Mark columns with `Column.frozen` / `meta.frozen` (`true` | `"left"` | `"right"`).
+     * Does not reorder columns; offsets stack so frozen cells do not overlap.
+     */
+    enableColumnFreeze?: boolean;
     /**
      * Optional UI part replacements for the unstyled DataTable renderer.
      * Use with `createTable` / `Table.Column`, or pass columns directly to `DataTable`.
@@ -196,6 +269,8 @@ type DataTableClassNames = {
     head?: string;
     headRow?: string;
     headCell?: string;
+    /** Column resize drag handle inside a header cell */
+    resizeHandle?: string;
     body?: string;
     emptyCell?: string;
     virtualSpacer?: string;
@@ -257,7 +332,23 @@ type TableColumnProps<T extends Record<string, unknown>, K extends string = keyo
     virtual?: boolean;
     children?: ReactNode;
     sortable?: boolean;
+    /** Initial / default column width in px (TanStack `size`) */
     width?: number;
+    /** Minimum resize width in px. Defaults to the table min when omitted */
+    minWidth?: number;
+    /** Maximum resize width in px. Defaults to the table max when omitted */
+    maxWidth?: number;
+    /**
+     * When false, this column cannot be resized even if `enableColumnResize` is on.
+     * Defaults to true.
+     */
+    resizable?: boolean;
+    /**
+     * Freeze (sticky) without changing column order.
+     * `true` / `"left"` → left edge; `"right"` → right edge.
+     * Requires `enableColumnFreeze`. Middle columns are allowed.
+     */
+    frozen?: ColumnFreezeMeta;
     align?: "left" | "center" | "right";
     rowSpan?: boolean;
     rowSpanKey?: string;
@@ -273,4 +364,4 @@ type TableProps<T extends Record<string, unknown>> = Omit<DataTableProps<T>, "co
     children: ReactNode;
 };
 
-export { type CellEditType as C, DEFAULT_DATA_TABLE_LABELS as D, type PasteMode as P, type RowSelectionMode as R, type TableColumnProps as T, type DataTableClassNames as a, type DataTableCopyActions as b, type DataTableLabels as c, type DataTableProps as d, type DataTableSlots as e, type RowsPastePayload as f, type TableProps as g, resolveDataTableLabels as r };
+export { type ColumnFreezeColumnInput as C, DEFAULT_DATA_TABLE_LABELS as D, type PasteMode as P, type RowSelectionMode as R, type TableColumnProps as T, type ColumnFreezeMeta as a, type ColumnFreezeOffset as b, type ColumnFreezeSide as c, type DataTableClassNames as d, type DataTableCopyActions as e, type DataTableLabels as f, type DataTableProps as g, type DataTableSlots as h, type RowsPastePayload as i, type TableProps as j, buildColumnFreezeOffsets as k, getColumnFreezeStyle as l, resolveDataTableLabels as m, type CellEditType as n, resolveColumnFreezeSide as r };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-glide-table",
-  "version": "1.1.8",
+  "version": "1.2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/zpxlffjrm/react-glide-table.git"
@@ -11,6 +11,28 @@
   "homepage": "https://github.com/zpxlffjrm/react-glide-table#readme",
   "type": "module",
   "license": "MIT",
+  "keywords": [
+    "react",
+    "table",
+    "datagrid",
+    "data-grid",
+    "headless",
+    "unstyled",
+    "tanstack",
+    "tanstack-table",
+    "virtualization",
+    "virtualized",
+    "typescript",
+    "compound-components",
+    "column-resize",
+    "column-freeze",
+    "sticky-columns",
+    "row-span",
+    "cell-selection",
+    "editable",
+    "tree-table",
+    "clipboard"
+  ],
   "sideEffects": false,
   "engines": {
     "node": "^20.19.0 || >=22.12.0"