react-glide-table 1.1.0 → 1.1.2

package/dist/index.d.cts

@@ -1,415 +1,6 @@
-import * as react from 'react';
-import { ReactNode, ComponentType, RefObject } from 'react';
-import { ColumnDef, RowSelectionState, Updater, Row, Table } from '@tanstack/react-table';
+export { D as DEFAULT_DATA_TABLE_LABELS, a as DataTableLabels, b as DataTableProps, c as DataTableSlots, R as RowSelectionMode, T as TableColumnProps, d as TableProps, r as resolveDataTableLabels } from './types-ByOoRY8x.cjs';
+export { CELL_SELECTION_EDGES_CLASS, CellSelectionBounds, ColumnRowSpanMap, DEFAULT_TREE_CHILDREN_FIELD, DEFAULT_TREE_ID_FIELD, DEFAULT_TREE_PARENT_ID_FIELD, DEFAULT_TREE_QTY_FIELD, DragState, EditingCell, RowSpanInfo, TreeRow, UseConvertTreeDataParams, UseGlideTableOptions, UseGlideTableResult, applyCellEdit, applyFillData, applySelectionUpdater, buildColumnRowSpanMap, canExpandRow, collectFillChanges, collectRowSpanColumns, getCellEditDraftValue, getCellSelectionEdgeStyle, getColumnEditType, getRowIndexInMergedCell, hasCellSelectionEdges, isCellInSelection, isColumnEditable, parseCellEditValue, resolveRowSelection, resolveRowSpanAt, toggleExpandedRowId, useCellEdit, useCellSelection, useConvertTreeData, useGlideTable } from './core.cjs';
+export { DataTable, Table, TableCompoundComponent, createTable } from './compound.cjs';
 export { ColumnDef, RowSelectionState } from '@tanstack/react-table';
-import { Virtualizer, VirtualItem } from '@tanstack/react-virtual';
-
-type DataTableLabels = {
-    empty: string;
-    loading: string;
-    selection: (selectedCount: number) => ReactNode;
-    expandRow: string;
-    collapseRow: string;
-};
-/** Default copy. Override via the `labels` option. */
-declare const DEFAULT_DATA_TABLE_LABELS: DataTableLabels;
-declare function resolveDataTableLabels(partial?: Partial<DataTableLabels>): DataTableLabels;
-
-/** Neutral default field names for tree conversion */
-declare const DEFAULT_TREE_ID_FIELD = "id";
-declare const DEFAULT_TREE_PARENT_ID_FIELD = "parentId";
-declare const DEFAULT_TREE_CHILDREN_FIELD = "children";
-declare const DEFAULT_TREE_QTY_FIELD = "qty";
-
-type RowSelectionMode = "none" | "single" | "multi";
-type CellEditType = "text" | "number";
-
-declare module "@tanstack/react-table" {
-    interface ColumnMeta<TData, TValue> {
-        /** Whether this column participates in vertical row spanning */
-        rowSpan?: boolean;
-        /** Merge key field. Falls back to the column id when omitted */
-        rowSpanKey?: string;
-        align?: "left" | "center" | "right";
-        className?: string;
-        headerClassName?: string;
-        /** When true, double-click starts inline editing */
-        editable?: boolean;
-        /** Inline editor input type. Defaults to text */
-        editType?: CellEditType;
-    }
-}
-type DataTableProps<T extends Record<string, unknown>> = {
-    data: T[];
-    columns: ColumnDef<T, unknown>[];
-    rowSelectionMode?: RowSelectionMode;
-    rowSelection?: RowSelectionState;
-    onRowSelectionChange?: (updater: Updater<RowSelectionState>) => void;
-    /** Total row count before filtering */
-    totalCount?: number;
-    /** Visible row count after filtering */
-    filteredCount?: number;
-    /** Left-side summary slot */
-    summary?: ReactNode;
-    /** Right-side action slot */
-    toolbar?: ReactNode;
-    /**
-     * UI copy overrides.
-     * Takes precedence over `emptyText` / `selectionLabel`.
-     */
-    labels?: Partial<DataTableLabels>;
-    /** @deprecated Prefer `labels.selection` */
-    selectionLabel?: (selectedCount: number) => ReactNode;
-    isPending?: boolean;
-    /** @deprecated Prefer `labels.empty` */
-    emptyText?: string;
-    /** @deprecated Prefer `labels.loading` */
-    loadingText?: string;
-    enableRowSpan?: boolean;
-    getRowId?: (row: T, index: number) => string;
-    onRowClick?: (row: T, index: number) => void;
-    preserveRowSelection?: boolean;
-    getRowClassName?: (row: T, index: number) => string | undefined;
-    /** Return false to make the row unselectable (row click and checkbox) */
-    getRowCanSelect?: (row: T, index: number) => boolean;
-    /** When false, row click does not toggle selection (checkbox-only) */
-    selectOnRowClick?: boolean;
-    /**
-     * Enable cell drag selection and fill handle. Defaults to true.
-     * When false, browser text selection is allowed and cell selection UI is off.
-     */
-    enableCellSelection?: boolean;
-    /**
-     * @deprecated Combining with paged/tree-transformed data can corrupt the source.
-     * Prefer onCellChange / onBatchChange.
-     */
-    onDataChange?: (data: T[]) => void;
-    /** Single-cell change (edit commit). Takes precedence over onDataChange */
-    onCellChange?: (rowId: string, columnId: string, value: unknown) => void;
-    /** Multi-cell change (fill handle, etc.). Takes precedence over onDataChange */
-    onBatchChange?: (changes: Array<{
-        rowId: string;
-        columnId: string;
-        value: unknown;
-    }>) => void;
-    className?: string;
-    /** Expand key field. Enables tree conversion / expand UI when set. Default `id` */
-    toggleField?: string;
-    /** Child → parent reference field. Default `parentId` */
-    childField?: string;
-    /** Nested children array field. Default `children` */
-    flattenField?: string;
-    /** Parent quantity field used for parentCount. Default `qty` */
-    qtyField?: string;
-    /** Expanded row key set (controlled) */
-    expandedRows?: Set<string>;
-    onExpandedRowsChange?: (next: Set<string>) => void;
-    /** When true, expand is disabled (children always visible) */
-    preventExpand?: boolean;
-    /**
-     * Enable row virtualization. Defaults to true.
-     * Forced off when enableRowSpan is true to preserve merges
-     * (HTML table + spacer rows; no absolute/translateY positioning).
-     */
-    enableVirtualization?: boolean;
-    /** Estimated virtual row height in px. Default 44; refined via measureElement */
-    estimateRowHeight?: number;
-    /** Virtualization overscan row count. Default 8 */
-    virtualOverscan?: number;
-    /**
-     * Optional UI part replacements for the reference DataTable renderer.
-     * Works with the playground `createTable` / `Table.Column` API.
-     */
-    slots?: DataTableSlots<T>;
-};
-type DataTableToolbarSlotProps = {
-    filteredCount?: number;
-    totalCount?: number;
-    summary?: ReactNode;
-    selectedCount: number;
-    selectionLabel?: (selectedCount: number) => ReactNode;
-    toolbar?: ReactNode;
-    className?: string;
-};
-type DataTableRowSlotProps<T extends Record<string, unknown>> = {
-    row: Row<T>;
-    onToggleSelect: () => void;
-    virtualIndex?: number;
-    measureElement?: (node: Element | null) => void;
-};
-type DataTableSlots<T extends Record<string, unknown>> = {
-    Toolbar?: ComponentType<DataTableToolbarSlotProps>;
-    Row?: ComponentType<DataTableRowSlotProps<T>>;
-    /** Replace the pending state view */
-    Pending?: ComponentType<{
-        loadingText: string;
-        className?: string;
-    }>;
-    /** Replace the empty-state cell content */
-    Empty?: ComponentType<{
-        emptyText: string;
-        columnCount: number;
-    }>;
-};
-type TableColumnProps<T extends Record<string, unknown>, K extends string = keyof T & string> = {
-    /** Column id: data field name, or an arbitrary id for virtual columns */
-    field: K;
-    /** When true, uses id only (no accessorKey) — e.g. checkbox / No. columns */
-    virtual?: boolean;
-    children?: ReactNode;
-    sortable?: boolean;
-    width?: number;
-    align?: "left" | "center" | "right";
-    rowSpan?: boolean;
-    rowSpanKey?: string;
-    editable?: boolean;
-    editType?: CellEditType;
-    className?: string;
-    headerClassName?: string;
-    render?: (value: K extends keyof T ? T[K] : unknown, row: Row<T>, index: number) => ReactNode;
-};
-type TableProps<T extends Record<string, unknown>> = Omit<DataTableProps<T>, "columns"> & {
-    children: ReactNode;
-};
-
-type EditingCell = {
-    rowIndex: number;
-    colIndex: number;
-};
-type ColumnDefLike = {
-    id?: string;
-    accessorKey?: unknown;
-    meta?: {
-        editable?: boolean;
-        editType?: CellEditType;
-    };
-};
-declare function isColumnEditable(columnDef: ColumnDefLike): boolean;
-declare function getColumnEditType(columnDef: ColumnDefLike): CellEditType;
-declare function parseCellEditValue(raw: string, editType: CellEditType): {
-    ok: true;
-    value: string | number | null;
-} | {
-    ok: false;
-};
-declare function getCellEditDraftValue(value: unknown): string;
-/** Returns updated data on success; null if parsing fails or the cell is not editable */
-declare function applyCellEdit<T extends Record<string, unknown>>(data: T[], rows: Row<T>[], rowIndex: number, colIndex: number, raw: string): T[] | null;
-
-type CellPosition = {
-    row: number;
-    col: number;
-};
-type CellSelectionBounds = {
-    startRow: number;
-    endRow: number;
-    startCol: number;
-    endCol: number;
-};
-type DragState = {
-    isSelecting: boolean;
-    isFillDragging: boolean;
-    start: CellPosition | null;
-    end: CellPosition | null;
-    /** Fixed anchor opposite the fill handle (top-left) */
-    fillAnchor: CellPosition | null;
-    fillEnd: CellPosition | null;
-};
-declare function getRowIndexInMergedCell(clientY: number, cellElement: HTMLElement, rowIndex: number, rowSpan: number): number;
-declare function isCellInSelection(rowIndex: number, colIndex: number, bounds: CellSelectionBounds | null, rowSpan?: number): boolean;
-declare const CELL_SELECTION_EDGES_CLASS = "cell-selection-edges";
-type CellSelectionEdgeStyle = {
-    /** Full-side inset border applied via ::after */
-    ["--selection-edge-shadows"]?: string;
-    /** Partial vertical border for merged-cell step (stair) segments */
-    ["--selection-edge-gradients"]?: string;
-    ["--selection-edge-sizes"]?: string;
-    ["--selection-edge-positions"]?: string;
-    /** Hide internal horizontal grid lines inside the selection with background color */
-    borderBottomColor?: string;
-};
-/**
- * Draws the selection border with ::after (extended -1px at the bottom) plus
- * inset box-shadow / partial gradients so it does not break on the cell's
- * border-bottom.
- *
- * @param isVisuallySelectedAt Whether a logical cell is visually selected
- *   (including adjacent merged cells). Used to suppress internal step borders
- *   when multiple columns have rowSpan.
- */
-declare function getCellSelectionEdgeStyle(rowIndex: number, colIndex: number, bounds: CellSelectionBounds | null, rowSpan?: number, isVisuallySelectedAt?: (row: number, col: number) => boolean): CellSelectionEdgeStyle | undefined;
-declare function hasCellSelectionEdges(style: CellSelectionEdgeStyle | undefined): boolean;
-
-type RowSpanInfo = {
-    /** 0 means skip render (merged into a parent row) */
-    rowSpan: number;
-    isFirstInGroup: boolean;
-};
-type ColumnRowSpanMap = Map<string, RowSpanInfo[]>;
-/**
- * Returns the start row and rowSpan of the merged cell covering a given row.
- * Rows with rowSpan === 0 walk up to the merge origin.
- */
-declare function resolveRowSpanAt(rowSpans: RowSpanInfo[] | undefined, rowIndex: number): {
-    startRow: number;
-    rowSpan: number;
-};
-/**
- * Computes merge info for every column that has rowSpan meta.
- */
-declare function buildColumnRowSpanMap<T extends Record<string, unknown>>(data: T[], columnKeys: Array<{
-    columnId: string;
-    rowSpanKey: string;
-}>): ColumnRowSpanMap;
-declare function collectRowSpanColumns<T extends Record<string, unknown>>(columns: ColumnDef<T, unknown>[]): Array<{
-    columnId: string;
-    rowSpanKey: string;
-}>;
-
-type RowData = Record<string, unknown>;
-type DataTableRowContextValue = {
-    rowSpan: {
-        enableRowSpan: boolean;
-        primaryRowSpanKey?: string;
-        columnRowSpanMap: ColumnRowSpanMap;
-        hoveredRowIndex: number | null;
-        hoveredGroupKey: string | null;
-        selectedGroupKeys: Set<string>;
-        onRowHover: (rowIndex: number, rowData: RowData) => void;
-    };
-    selection: {
-        rowSelectionMode: RowSelectionMode;
-        selectOnRowClick: boolean;
-        onRowClick?: (row: RowData, index: number) => void;
-        getRowClassName?: (row: RowData, index: number) => string | undefined;
-    };
-    cellSelection: {
-        enableCellSelection: boolean;
-        activeSelectionBounds: CellSelectionBounds | null;
-        dragState: DragState;
-        onCellMouseDown: (rowIndex: number, colIndex: number) => void;
-        onCellMouseEnter: (rowIndex: number, colIndex: number) => void;
-        onFillHandleMouseDown: (rowIndex: number, colIndex: number) => void;
-    };
-    cellEdit: {
-        editingCell: EditingCell | null;
-        draftValue: string;
-        onDraftValueChange: (value: string) => void;
-        onStartEdit: (rowIndex: number, colIndex: number) => void;
-        onCommitEdit: (raw?: string) => boolean;
-        onCancelEdit: () => void;
-    };
-    expand: {
-        enableExpand: boolean;
-        toggleField?: string;
-        expandedRows?: Set<string>;
-        preventExpand: boolean;
-        onToggleExpand?: (rowKey: string) => void;
-        expandRowLabel: string;
-        collapseRowLabel: string;
-    };
-};
-
-type UseGlideTableOptions<T extends Record<string, unknown>> = Omit<DataTableProps<T>, "className" | "slots" | "summary" | "toolbar" | "isPending" | "totalCount" | "filteredCount">;
-type UseGlideTableResult<T extends Record<string, unknown>> = {
-    table: Table<T>;
-    tableData: T[];
-    rows: Row<T>[];
-    columnCount: number;
-    selectedCount: number;
-    labels: DataTableLabels;
-    emptyText: string;
-    loadingText: string;
-    selectionLabel: DataTableLabels["selection"];
-    enableCellSelection: boolean;
-    shouldVirtualize: boolean;
-    scrollRef: RefObject<HTMLDivElement | null>;
-    rowVirtualizer: Virtualizer<HTMLDivElement, Element>;
-    virtualRows: VirtualItem[];
-    paddingTop: number;
-    paddingBottom: number;
-    rowContextValue: DataTableRowContextValue;
-    handleToggleSelect: (row: Row<T>) => void;
-    clearHover: () => void;
-};
-declare function useGlideTable<T extends Record<string, unknown>>(options: UseGlideTableOptions<T>): UseGlideTableResult<T>;
-
-type UseCellEditOptions<T extends Record<string, unknown>> = {
-    data: T[];
-    rows: Row<T>[];
-    onDataChange?: (data: T[]) => void;
-    onCellChange?: (rowId: string, columnId: string, value: unknown) => void;
-};
-declare function useCellEdit<T extends Record<string, unknown>>({ data, rows, onDataChange, onCellChange, }: UseCellEditOptions<T>): {
-    editingCell: EditingCell | null;
-    draftValue: string;
-    setDraftValue: react.Dispatch<react.SetStateAction<string>>;
-    startEdit: (rowIndex: number, colIndex: number) => void;
-    commitEdit: (raw?: string) => boolean;
-    cancelEdit: () => void;
-};
-
-type UseCellSelectionOptions<T extends Record<string, unknown>> = {
-    data: T[];
-    rows: Row<T>[];
-    enabled?: boolean;
-    onDataChange?: (data: T[]) => void;
-    onBatchChange?: (changes: Array<{
-        rowId: string;
-        columnId: string;
-        value: unknown;
-    }>) => void;
-};
-declare function useCellSelection<T extends Record<string, unknown>>({ data, rows, enabled, onDataChange, onBatchChange, }: 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;
-};
-
-type CellChange = {
-    rowId: string;
-    columnId: string;
-    value: unknown;
-};
-declare function collectFillChanges<T extends Record<string, unknown>>(rows: Row<T>[], sourceBounds: CellSelectionBounds, fillBounds: CellSelectionBounds): CellChange[];
-declare function applyFillData<T extends Record<string, unknown>>(data: T[], rows: Row<T>[], sourceBounds: CellSelectionBounds, fillBounds: CellSelectionBounds): T[];
-
-type TreeRow<T extends Record<string, unknown> = Record<string, unknown>> = T & {
-    level: number;
-    children: TreeRow<T>[];
-    treeNo?: string;
-    uniqueId?: string;
-    parentCount?: number;
-    processed?: boolean;
-};
-type UseConvertTreeDataParams<T extends Record<string, unknown>> = {
-    data: T[] | null;
-    /** When false, returns data unchanged (plain DataTable) */
-    enabled?: boolean;
-    /** Row id / expand key field (idField). Defaults to `id` */
-    toggleField?: string;
-    /** Child → parent reference field (parentIdField). Defaults to `parentId` */
-    childField?: string;
-    /** Nested children array field (childrenField). Defaults to `children` */
-    flattenField?: string;
-    /** Parent quantity field (qtyField). Used for parentCount. Defaults to `qty` */
-    qtyField?: string;
-    preventExpand?: boolean;
-    startIndex?: number;
-    expandedRows?: Set<string>;
-    onExpandedRowsChange?: (next: Set<string>) => void;
-};
-declare function canExpandRow(row: Record<string, unknown>): boolean;
-declare function toggleExpandedRowId(rowId: string, previous: Set<string>): Set<string>;
-/**
- * Builds a tree from flat/nested data, then returns only rows visible under expandedRows.
- * When enabled=false, returns data as-is.
- */
-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_DATA_TABLE_LABELS, DEFAULT_TREE_CHILDREN_FIELD, DEFAULT_TREE_ID_FIELD, DEFAULT_TREE_PARENT_ID_FIELD, DEFAULT_TREE_QTY_FIELD, type DataTableLabels, type DataTableProps, type DataTableSlots, type DragState, type EditingCell, type RowSelectionMode, type RowSpanInfo, type TableColumnProps, type TableProps, type TreeRow, type UseConvertTreeDataParams, type UseGlideTableOptions, type UseGlideTableResult, applyCellEdit, applyFillData, applySelectionUpdater, buildColumnRowSpanMap, canExpandRow, collectFillChanges, collectRowSpanColumns, getCellEditDraftValue, getCellSelectionEdgeStyle, getColumnEditType, getRowIndexInMergedCell, hasCellSelectionEdges, isCellInSelection, isColumnEditable, parseCellEditValue, resolveDataTableLabels, resolveRowSelection, resolveRowSpanAt, toggleExpandedRowId, useCellEdit, useCellSelection, useConvertTreeData, useGlideTable };
+import 'react';
+import '@tanstack/react-virtual';