react-glide-table 1.6.0 → 2.0.1

package/dist/{types-tkOzBZ4V.d.cts → types-DJOlsDL8.d.cts}

@@ -1,5 +1,32 @@
-import { ColumnDef, RowSelectionState, Updater, ColumnSizingState, OnChangeFn, ColumnResizeMode, Row } from '@tanstack/react-table';
-import { CSSProperties, ReactNode, InputHTMLAttributes, ComponentType, Ref } from 'react';
+import { Row, ColumnDef, RowSelectionState, Updater, ColumnSizingState, OnChangeFn, ColumnResizeMode } from '@tanstack/react-table';
+import { ReactNode, CSSProperties, InputHTMLAttributes, ComponentType, Ref } from 'react';
+
+/**
+ * Built-in cell kinds inspired by Glide Data Grid All Cell Kinds.
+ * Custom kinds are plain strings registered via `cellRenderers`.
+ */
+type BuiltinCellKind = "text" | "number" | "boolean" | "uri" | "image" | "bubble" | "markdown" | "drilldown" | "loading" | "protected" | "row-id";
+type CellKind = BuiltinCellKind | (string & {});
+type CellRenderContext<T extends Record<string, unknown> = Record<string, unknown>, V = unknown> = {
+    value: V;
+    row: Row<T>;
+    index: number;
+    columnId: string;
+    /** Kind-specific props from `Column.cellProps` / `meta.cellProps` */
+    cellProps?: Record<string, unknown>;
+    /**
+     * Commit a cell value through the table's `onCellChange` / `onDataChange` pipeline.
+     * Prefer this over calling `setData` directly from custom renders.
+     */
+    update: (next: V) => void;
+};
+type CellRenderer<T extends Record<string, unknown> = Record<string, unknown>, V = unknown> = {
+    kind: CellKind;
+    render: (ctx: CellRenderContext<T, V>) => ReactNode;
+    /** Optional extra match when resolving custom renderers */
+    isMatch?: (ctx: CellRenderContext<T, V>) => boolean;
+};
+type CellRenderFn<T extends Record<string, unknown> = Record<string, unknown>, V = unknown> = (ctx: CellRenderContext<T, V>) => ReactNode;
 
 /** Sticky edge for a frozen column. Does not reorder columns. */
 type ColumnFreezeSide = "left" | "right";
@@ -46,7 +73,24 @@ declare function buildColumnFreezeOffsets(columns: ColumnFreezeColumnInput[]): M
 /** Sticky position styles for a frozen header or body cell. */
 declare function getColumnFreezeStyle(offset: ColumnFreezeOffset | undefined, options?: {
     isHeader?: boolean;
+    /**
+     * @deprecated Unused. Vertical sticky belongs on `thead` (`classNames.head`),
+     * not on frozen header cells — dual `top` sticky detaches freeze bands.
+     */
+    headerTop?: number;
 }): CSSProperties | undefined;
+type HeaderFreezeColumnLike = {
+    id: string;
+    columns?: HeaderFreezeColumnLike[];
+    getLeafColumns?: () => HeaderFreezeColumnLike[];
+};
+/**
+ * Resolve freeze offset for a header cell.
+ * Leaf columns use the leaf map directly. Group headers inherit sticky
+ * positioning only when every leaf is frozen on the same side — otherwise a
+ * scrolled-away group label leaves frozen leaves looking like a detached band.
+ */
+declare function resolveHeaderFreezeOffset(column: HeaderFreezeColumnLike, freezeOffsets: Map<string, ColumnFreezeOffset>): ColumnFreezeOffset | undefined;
 
 /** Cell match as `[colIndex, rowIndex]` — same order as Glide Data Grid `Item`.
  * For tree tables, `rowIndex` is the search-corpus index (includes collapsed rows).
@@ -147,6 +191,15 @@ declare module "@tanstack/react-table" {
         editType?: CellEditType;
         /** Inline editor input attribute overrides */
         editInputProps?: DataTableEditInputProps;
+        /**
+         * Built-in or custom cell kind. Resolved via table `cellRenderers` registry.
+         * Column `render` takes precedence over `kind`.
+         */
+        kind?: CellKind;
+        /** Extra props forwarded to the kind / custom renderer as `ctx.cellProps` */
+        cellProps?: Record<string, unknown>;
+        /** Compound `Column.render` stored for `ResolvedTableCell` */
+        cellRender?: CellRenderFn<Record<string, unknown>>;
         /**
          * Freeze (sticky) this column without reordering.
          * `true` / `"left"` stick to the scrollport left; `"right"` to the right.
@@ -251,6 +304,12 @@ type DataTableProps<T extends Record<string, unknown>> = {
         columnId: string;
         value: unknown;
     }>) => void;
+    /**
+     * Extra / overriding cell kind renderers (same `kind` replaces builtins).
+     * Built-ins: text, number, boolean, uri, image, bubble, markdown, drilldown,
+     * loading, protected, row-id.
+     */
+    cellRenderers?: readonly CellRenderer[];
     /**
      * Root className hook (combined with `DataTableJSX`).
      * The package ships no CSS — style these hooks yourself or leave unstyled.
@@ -474,12 +533,33 @@ type TableColumnProps<T extends Record<string, unknown>, K extends string = keyo
     editType?: CellEditType;
     /** Inline editor input attribute overrides */
     editInputProps?: DataTableEditInputProps;
+    /**
+     * Cell kind for the built-in / custom renderer registry.
+     * Ignored when `render` is set (render wins).
+     */
+    kind?: CellKind;
+    /** Extra props for the kind renderer (`ctx.cellProps`) */
+    cellProps?: Record<string, unknown>;
     className?: string;
     headerClassName?: string;
-    render?: (value: K extends keyof T ? T[K] : unknown, row: Row<T>, index: number) => ReactNode;
+    /**
+     * Custom cell content. Receives a single context object — destructure what you need.
+     * Use `update` to commit via `onCellChange` / `onDataChange`.
+     */
+    render?: CellRenderFn<T, K extends keyof T ? T[K] : unknown>;
+};
+/** Declares a multi-row header group wrapping leaf `Table.Column`s. */
+type TableColumnGroupProps = {
+    /** Group header label shown in the top header row */
+    header: ReactNode;
+    children: ReactNode;
+    /** Stable group id. Auto-generated when omitted */
+    id?: string;
+    align?: "left" | "center" | "right";
+    headerClassName?: string;
 };
 type TableProps<T extends Record<string, unknown>> = Omit<DataTableProps<T>, "columns"> & {
     children: ReactNode;
 };
 
-export { getColumnFreezeStyle as A, mapSearchResultToVisibleItem as B, type ColumnFreezeColumnInput as C, DEFAULT_DATA_TABLE_LABELS as D, mapSearchResultsToVisibleKeys as E, nextSearchIndex as F, nextSearchStride as G, previousSearchIndex as H, INLINE_SEARCH_MAX_RESULTS as I, resolveColumnFreezeSide as J, resolveDataTableLabels as K, type CellEditType as L, type PasteMode as P, type RowSelectionMode as R, type SearchCorpusRow as S, 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 DataTableScrollSlotProps as i, type DataTableSlots as j, type RowsPastePayload as k, type SearchResultItem as l, type SearchStatus as m, type TableProps as n, buildColumnFreezeOffsets as o, buildFlatSearchCorpus as p, buildSearchMatchKey as q, buildSearchMatchKeys as r, buildTreeSearchCorpus as s, cellValueToSearchText as t, collectAncestorKeysToExpand as u, collectSearchMatchesInRange as v, createSearchRegex as w, escapeSearchRegex as x, formatSearchResultLabel as y, getColumnFreezeEdgeAttr as z };
+export { collectSearchMatchesInRange as A, type BuiltinCellKind as B, type CellKind as C, DEFAULT_DATA_TABLE_LABELS as D, createSearchRegex as E, escapeSearchRegex as F, formatSearchResultLabel as G, getColumnFreezeEdgeAttr as H, INLINE_SEARCH_MAX_RESULTS as I, getColumnFreezeStyle as J, mapSearchResultToVisibleItem as K, mapSearchResultsToVisibleKeys as L, nextSearchIndex as M, nextSearchStride as N, previousSearchIndex as O, type PasteMode as P, resolveColumnFreezeSide as Q, type RowSelectionMode as R, type SearchCorpusRow as S, type TableColumnGroupProps as T, resolveDataTableLabels as U, resolveHeaderFreezeOffset as V, type CellEditType as W, type CellRenderContext as a, type CellRenderFn as b, type CellRenderer as c, type ColumnFreezeColumnInput as d, type ColumnFreezeEdgeSide as e, type ColumnFreezeMeta as f, type ColumnFreezeOffset as g, type ColumnFreezeSide as h, type DataTableClassNames as i, type DataTableCopyActions as j, type DataTableLabels as k, type DataTableProps as l, type DataTableScrollSlotProps as m, type DataTableSlots as n, type RowsPastePayload as o, type SearchResultItem as p, type SearchStatus as q, type TableColumnProps as r, type TableProps as s, buildColumnFreezeOffsets as t, buildFlatSearchCorpus as u, buildSearchMatchKey as v, buildSearchMatchKeys as w, buildTreeSearchCorpus as x, cellValueToSearchText as y, collectAncestorKeysToExpand as z };

package/dist/{types-tkOzBZ4V.d.ts → types-DJOlsDL8.d.ts}

@@ -1,5 +1,32 @@
-import { ColumnDef, RowSelectionState, Updater, ColumnSizingState, OnChangeFn, ColumnResizeMode, Row } from '@tanstack/react-table';
-import { CSSProperties, ReactNode, InputHTMLAttributes, ComponentType, Ref } from 'react';
+import { Row, ColumnDef, RowSelectionState, Updater, ColumnSizingState, OnChangeFn, ColumnResizeMode } from '@tanstack/react-table';
+import { ReactNode, CSSProperties, InputHTMLAttributes, ComponentType, Ref } from 'react';
+
+/**
+ * Built-in cell kinds inspired by Glide Data Grid All Cell Kinds.
+ * Custom kinds are plain strings registered via `cellRenderers`.
+ */
+type BuiltinCellKind = "text" | "number" | "boolean" | "uri" | "image" | "bubble" | "markdown" | "drilldown" | "loading" | "protected" | "row-id";
+type CellKind = BuiltinCellKind | (string & {});
+type CellRenderContext<T extends Record<string, unknown> = Record<string, unknown>, V = unknown> = {
+    value: V;
+    row: Row<T>;
+    index: number;
+    columnId: string;
+    /** Kind-specific props from `Column.cellProps` / `meta.cellProps` */
+    cellProps?: Record<string, unknown>;
+    /**
+     * Commit a cell value through the table's `onCellChange` / `onDataChange` pipeline.
+     * Prefer this over calling `setData` directly from custom renders.
+     */
+    update: (next: V) => void;
+};
+type CellRenderer<T extends Record<string, unknown> = Record<string, unknown>, V = unknown> = {
+    kind: CellKind;
+    render: (ctx: CellRenderContext<T, V>) => ReactNode;
+    /** Optional extra match when resolving custom renderers */
+    isMatch?: (ctx: CellRenderContext<T, V>) => boolean;
+};
+type CellRenderFn<T extends Record<string, unknown> = Record<string, unknown>, V = unknown> = (ctx: CellRenderContext<T, V>) => ReactNode;
 
 /** Sticky edge for a frozen column. Does not reorder columns. */
 type ColumnFreezeSide = "left" | "right";
@@ -46,7 +73,24 @@ declare function buildColumnFreezeOffsets(columns: ColumnFreezeColumnInput[]): M
 /** Sticky position styles for a frozen header or body cell. */
 declare function getColumnFreezeStyle(offset: ColumnFreezeOffset | undefined, options?: {
     isHeader?: boolean;
+    /**
+     * @deprecated Unused. Vertical sticky belongs on `thead` (`classNames.head`),
+     * not on frozen header cells — dual `top` sticky detaches freeze bands.
+     */
+    headerTop?: number;
 }): CSSProperties | undefined;
+type HeaderFreezeColumnLike = {
+    id: string;
+    columns?: HeaderFreezeColumnLike[];
+    getLeafColumns?: () => HeaderFreezeColumnLike[];
+};
+/**
+ * Resolve freeze offset for a header cell.
+ * Leaf columns use the leaf map directly. Group headers inherit sticky
+ * positioning only when every leaf is frozen on the same side — otherwise a
+ * scrolled-away group label leaves frozen leaves looking like a detached band.
+ */
+declare function resolveHeaderFreezeOffset(column: HeaderFreezeColumnLike, freezeOffsets: Map<string, ColumnFreezeOffset>): ColumnFreezeOffset | undefined;
 
 /** Cell match as `[colIndex, rowIndex]` — same order as Glide Data Grid `Item`.
  * For tree tables, `rowIndex` is the search-corpus index (includes collapsed rows).
@@ -147,6 +191,15 @@ declare module "@tanstack/react-table" {
         editType?: CellEditType;
         /** Inline editor input attribute overrides */
         editInputProps?: DataTableEditInputProps;
+        /**
+         * Built-in or custom cell kind. Resolved via table `cellRenderers` registry.
+         * Column `render` takes precedence over `kind`.
+         */
+        kind?: CellKind;
+        /** Extra props forwarded to the kind / custom renderer as `ctx.cellProps` */
+        cellProps?: Record<string, unknown>;
+        /** Compound `Column.render` stored for `ResolvedTableCell` */
+        cellRender?: CellRenderFn<Record<string, unknown>>;
         /**
          * Freeze (sticky) this column without reordering.
          * `true` / `"left"` stick to the scrollport left; `"right"` to the right.
@@ -251,6 +304,12 @@ type DataTableProps<T extends Record<string, unknown>> = {
         columnId: string;
         value: unknown;
     }>) => void;
+    /**
+     * Extra / overriding cell kind renderers (same `kind` replaces builtins).
+     * Built-ins: text, number, boolean, uri, image, bubble, markdown, drilldown,
+     * loading, protected, row-id.
+     */
+    cellRenderers?: readonly CellRenderer[];
     /**
      * Root className hook (combined with `DataTableJSX`).
      * The package ships no CSS — style these hooks yourself or leave unstyled.
@@ -474,12 +533,33 @@ type TableColumnProps<T extends Record<string, unknown>, K extends string = keyo
     editType?: CellEditType;
     /** Inline editor input attribute overrides */
     editInputProps?: DataTableEditInputProps;
+    /**
+     * Cell kind for the built-in / custom renderer registry.
+     * Ignored when `render` is set (render wins).
+     */
+    kind?: CellKind;
+    /** Extra props for the kind renderer (`ctx.cellProps`) */
+    cellProps?: Record<string, unknown>;
     className?: string;
     headerClassName?: string;
-    render?: (value: K extends keyof T ? T[K] : unknown, row: Row<T>, index: number) => ReactNode;
+    /**
+     * Custom cell content. Receives a single context object — destructure what you need.
+     * Use `update` to commit via `onCellChange` / `onDataChange`.
+     */
+    render?: CellRenderFn<T, K extends keyof T ? T[K] : unknown>;
+};
+/** Declares a multi-row header group wrapping leaf `Table.Column`s. */
+type TableColumnGroupProps = {
+    /** Group header label shown in the top header row */
+    header: ReactNode;
+    children: ReactNode;
+    /** Stable group id. Auto-generated when omitted */
+    id?: string;
+    align?: "left" | "center" | "right";
+    headerClassName?: string;
 };
 type TableProps<T extends Record<string, unknown>> = Omit<DataTableProps<T>, "columns"> & {
     children: ReactNode;
 };
 
-export { getColumnFreezeStyle as A, mapSearchResultToVisibleItem as B, type ColumnFreezeColumnInput as C, DEFAULT_DATA_TABLE_LABELS as D, mapSearchResultsToVisibleKeys as E, nextSearchIndex as F, nextSearchStride as G, previousSearchIndex as H, INLINE_SEARCH_MAX_RESULTS as I, resolveColumnFreezeSide as J, resolveDataTableLabels as K, type CellEditType as L, type PasteMode as P, type RowSelectionMode as R, type SearchCorpusRow as S, 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 DataTableScrollSlotProps as i, type DataTableSlots as j, type RowsPastePayload as k, type SearchResultItem as l, type SearchStatus as m, type TableProps as n, buildColumnFreezeOffsets as o, buildFlatSearchCorpus as p, buildSearchMatchKey as q, buildSearchMatchKeys as r, buildTreeSearchCorpus as s, cellValueToSearchText as t, collectAncestorKeysToExpand as u, collectSearchMatchesInRange as v, createSearchRegex as w, escapeSearchRegex as x, formatSearchResultLabel as y, getColumnFreezeEdgeAttr as z };
+export { collectSearchMatchesInRange as A, type BuiltinCellKind as B, type CellKind as C, DEFAULT_DATA_TABLE_LABELS as D, createSearchRegex as E, escapeSearchRegex as F, formatSearchResultLabel as G, getColumnFreezeEdgeAttr as H, INLINE_SEARCH_MAX_RESULTS as I, getColumnFreezeStyle as J, mapSearchResultToVisibleItem as K, mapSearchResultsToVisibleKeys as L, nextSearchIndex as M, nextSearchStride as N, previousSearchIndex as O, type PasteMode as P, resolveColumnFreezeSide as Q, type RowSelectionMode as R, type SearchCorpusRow as S, type TableColumnGroupProps as T, resolveDataTableLabels as U, resolveHeaderFreezeOffset as V, type CellEditType as W, type CellRenderContext as a, type CellRenderFn as b, type CellRenderer as c, type ColumnFreezeColumnInput as d, type ColumnFreezeEdgeSide as e, type ColumnFreezeMeta as f, type ColumnFreezeOffset as g, type ColumnFreezeSide as h, type DataTableClassNames as i, type DataTableCopyActions as j, type DataTableLabels as k, type DataTableProps as l, type DataTableScrollSlotProps as m, type DataTableSlots as n, type RowsPastePayload as o, type SearchResultItem as p, type SearchStatus as q, type TableColumnProps as r, type TableProps as s, buildColumnFreezeOffsets as t, buildFlatSearchCorpus as u, buildSearchMatchKey as v, buildSearchMatchKeys as w, buildTreeSearchCorpus as x, cellValueToSearchText as y, collectAncestorKeysToExpand as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-glide-table",
-  "version": "1.6.0",
+  "version": "2.0.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/zpxlffjrm/react-glide-table.git"