react-glide-table 1.1.9 → 1.3.0

package/dist/{types-xxzMLUwM.d.ts → types-B4uHdkrY.d.ts}

@@ -1,5 +1,52 @@
-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;
+};
+/** Which outer sides of a freeze island get a divider shadow. */
+type ColumnFreezeEdgeSide = "left" | "right" | "both";
+type ColumnFreezeOffset = {
+    side: ColumnFreezeSide;
+    /** Cumulative sticky inset (`left` or `right` in px). */
+    offset: number;
+    /** True when this cell is on an island boundary (any side). */
+    isEdge: boolean;
+    /** Shadow toward the previous column (scrollable / other island). */
+    edgeLeft: boolean;
+    /** Shadow toward the next column (scrollable / other island). */
+    edgeRight: 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;
+/** Serialize freeze-edge flags for `data-freeze-edge`. */
+declare function getColumnFreezeEdgeAttr(offset: Pick<ColumnFreezeOffset, "edgeLeft" | "edgeRight"> | undefined): ColumnFreezeEdgeSide | 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)`
+ *
+ * Contiguous same-side freezes form one island — only the outer boundaries
+ * get edge shadows. Gaps between same-side freezes create separate islands,
+ * so both sides of the gap receive a shadow.
+ */
+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 +54,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 +80,12 @@ 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> {
         /**
@@ -180,6 +235,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`.
@@ -205,6 +279,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;
@@ -266,7 +342,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;
@@ -282,4 +374,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 ColumnFreezeEdgeSide as a, type ColumnFreezeMeta as b, type ColumnFreezeOffset as c, type ColumnFreezeSide as d, type DataTableClassNames as e, type DataTableCopyActions as f, type DataTableLabels as g, type DataTableProps as h, type DataTableSlots as i, type RowsPastePayload as j, type TableProps as k, buildColumnFreezeOffsets as l, getColumnFreezeEdgeAttr as m, getColumnFreezeStyle as n, resolveDataTableLabels as o, type CellEditType as p, resolveColumnFreezeSide as r };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-glide-table",
-  "version": "1.1.9",
+  "version": "1.3.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"