simple-table-core 4.0.0 → 4.0.2

package/dist/src/utils/headerUtils.d.ts

@@ -1,41 +0,0 @@
-import HeaderObject from "../types/HeaderObject";
-/**
- * Gets all leaf column indices (bottom-level columns) for a given header and its descendants
- * @param header The header to get indices for
- * @param colIndex The column index of the header in the current context
- * @returns Array of column indices that belong to this header branch
- */
-export declare const getHeaderLeafIndices: (header: HeaderObject, colIndex: number) => number[];
-/**
- * Flattens a nested header structure to get all leaf headers
- * @param headers The headers array to flatten
- * @returns Flattened array of all leaf headers
- */
-export declare const flattenHeaders: (headers: HeaderObject[]) => HeaderObject[];
-/**
- * Flattens a nested header structure to get all headers (including parent headers)
- * @param headers The headers array to flatten
- * @returns Flattened array of all headers in the hierarchy
- */
-export declare const flattenAllHeaders: (headers: HeaderObject[]) => HeaderObject[];
-/**
- * Gets the range of column indices between two column indices
- * @param startColIndex Starting column index
- * @param endColIndex Ending column index
- * @returns Array of column indices in the range (inclusive)
- */
-export declare const getColumnRange: (startColIndex: number, endColIndex: number) => number[];
-export declare const calculatePinnedWidth: (width?: number) => number;
-/**
- * Generates a unique ID for header description element
- * @param accessor The header accessor
- * @returns Unique ID string for aria-describedby
- */
-export declare const getHeaderDescriptionId: (accessor: string | number) => string;
-/**
- * Builds a descriptive string for screen readers about a column header
- * @param header The header object
- * @param filterable Whether the column is filterable
- * @returns Description string for aria-describedby, or empty string if no description
- */
-export declare const getHeaderDescription: (header: HeaderObject, filterable: boolean) => string;

package/dist/src/utils/infiniteScrollUtils.d.ts

@@ -1,145 +0,0 @@
-import TableRow from "../types/TableRow";
-import { CustomTheme } from "../types/CustomTheme";
-import { Accessor } from "../types/HeaderObject";
-/**
- * Sorted array of [position, extraHeight] tuples for nested grids
- * Position: the row index in flattened array
- * ExtraHeight: additional height beyond standard rowHeight (in pixels)
- * Array is kept sorted by position for efficient binary search
- */
-export type HeightOffsets = Array<[number, number]>;
-/**
- * Precomputed cumulative height data structure for O(1) row position lookups
- * and O(log n) viewport calculations
- */
-export interface CumulativeHeightMap {
-    /** Array where index i contains the top pixel position of row i */
-    rowTopPositions: number[];
-    /** Total height of all rows combined */
-    totalHeight: number;
-}
-/**
- * Build a cumulative height map for efficient viewport calculations
- * This precomputes the top position of every row, enabling:
- * - O(1) lookup of row top position
- * - O(log n) binary search to find rows in viewport
- *
- * @param rowCount - Total number of rows
- * @param rowHeight - Standard height of each row
- * @param heightOffsets - Array of [position, extraHeight] for variable-height rows
- * @param customTheme - Theme configuration for separator width
- * @returns Cumulative height map with row positions
- */
-export declare const buildCumulativeHeightMap: (rowCount: number, rowHeight: number, heightOffsets: HeightOffsets | undefined, customTheme: CustomTheme) => CumulativeHeightMap;
-/**
- * Find the row index at a given scroll position using binary search
- * Returns the index of the row that contains or is closest to the scroll position
- *
- * @param scrollTop - The scroll position in pixels
- * @param heightMap - Precomputed cumulative height map
- * @returns Row index at the scroll position
- */
-export declare const findRowAtScrollPosition: (scrollTop: number, heightMap: CumulativeHeightMap) => number;
-/**
- * Calculate cumulative extra height from nested grids above a given position
- * Uses binary search for O(log n) performance
- * @param position - The row position to calculate height for
- * @param heightOffsets - Sorted array of [position, extraHeight] tuples
- * @returns Total extra height from all nested grids above this position
- */
-export declare const getCumulativeExtraHeight: (position: number, heightOffsets?: HeightOffsets) => number;
-export declare const getTotalRowCount: (tableRows: TableRow[]) => number;
-/**
- * Calculate the total height of all rows including nested grids with extra heights
- * @param totalRowCount - Total number of rows
- * @param rowHeight - Standard height of each row
- * @param heightOffsets - Array of [position, extraHeight] tuples for rows with non-standard heights
- * @param customTheme - Custom theme configuration for separator width
- * @returns Total height in pixels
- */
-export declare const calculateTotalHeight: (totalRowCount: number, rowHeight: number, heightOffsets: HeightOffsets | undefined, customTheme: CustomTheme) => number;
-/**
- * Viewport range calculation result containing start/end indices and the actual rows
- */
-export interface ViewportRange {
-    startIndex: number;
-    endIndex: number;
-    rows: TableRow[];
-}
-/**
- * Complete viewport calculations with multiple strategies
- * Provides three different ways to calculate visible rows for different use cases
- */
-export interface ViewportCalculations {
-    /** Rows to render in the DOM (includes overscan buffer for smooth scrolling) */
-    rendered: ViewportRange;
-    /** Rows that are completely visible within the viewport boundaries */
-    fullyVisible: ViewportRange;
-    /** Rows that are at least partially visible in the viewport */
-    partiallyVisible: ViewportRange;
-}
-/**
- * Calculate all viewport ranges for virtual scrolling with variable-height row support
- * Returns three different viewport calculations:
- * - rendered: What should be in the DOM (includes overscan buffer)
- * - fullyVisible: Rows completely visible (useful for scroll-to-view logic)
- * - partiallyVisible: Rows at least partially visible (useful for scroll boundaries)
- *
- * This function now supports variable-height rows by using a cumulative height map
- * for O(log n) viewport calculations instead of assuming fixed row heights.
- */
-export declare const getViewportCalculations: ({ bufferRowCount, contentHeight, rowHeight, scrollTop, tableRows, scrollDirection, heightMap, }: {
-    bufferRowCount: number;
-    contentHeight: number;
-    rowHeight: number;
-    scrollTop: number;
-    tableRows: TableRow[];
-    scrollDirection?: "up" | "down" | "none" | undefined;
-    heightMap?: CumulativeHeightMap | undefined;
-}) => {
-    rendered: {
-        startIndex: number;
-        endIndex: number;
-        rows: TableRow[];
-    };
-    fullyVisible: {
-        startIndex: number;
-        endIndex: number;
-        rows: TableRow[];
-    };
-    partiallyVisible: {
-        startIndex: number;
-        endIndex: number;
-        rows: TableRow[];
-    };
-};
-/**
- * Get visible rows with pixel-based overscan
- * Uses the viewport calculations internally and returns the rendered rows
- * Maintains backward compatibility with existing code
- */
-export declare const getVisibleRows: ({ bufferRowCount, contentHeight, rowHeight, scrollTop, tableRows, scrollDirection, heightMap, }: {
-    bufferRowCount: number;
-    contentHeight: number;
-    rowHeight: number;
-    scrollTop: number;
-    tableRows: TableRow[];
-    scrollDirection?: "up" | "down" | "none" | undefined;
-    heightMap?: CumulativeHeightMap | undefined;
-}) => TableRow[];
-export declare const calculateSeparatorTopPosition: ({ position, rowHeight, heightOffsets, customTheme, }: {
-    position: number;
-    rowHeight: number;
-    heightOffsets?: HeightOffsets | undefined;
-    customTheme: CustomTheme;
-}) => number;
-export declare const calculateRowTopPosition: ({ position, rowHeight, heightOffsets, customTheme, }: {
-    position: number;
-    rowHeight: number;
-    heightOffsets?: HeightOffsets | undefined;
-    customTheme: CustomTheme;
-}) => number;
-export declare const getStickyParents: (allTableRows: TableRow[], renderedRows: TableRow[], fullyVisibleRows: TableRow[], partiallyVisibleRows: TableRow[], rowGrouping: Accessor[]) => {
-    stickyParents: TableRow[];
-    regularRows: TableRow[];
-};

package/dist/src/utils/pinnedColumnUtils.d.ts

@@ -1,29 +0,0 @@
-import HeaderObject, { Accessor } from "../types/HeaderObject";
-import { PinnedSectionsState } from "../types/PinnedSectionsState";
-import { PanelSection } from "../types/PanelSection";
-export type { PinnedSectionsState, PanelSection };
-/** Root-level columns only, preserving order within each pin group. */
-export declare function partitionRootHeadersByPin(headers: HeaderObject[]): {
-    pinnedLeft: HeaderObject[];
-    unpinned: HeaderObject[];
-    pinnedRight: HeaderObject[];
-};
-export declare function isHeaderEssential(header: HeaderObject, essentialAccessors: ReadonlySet<string>): boolean;
-/** Accessors for every header with `isEssential` in the tree (including nested). */
-export declare function collectEssentialAccessors(headers: HeaderObject[]): Set<string>;
-/** Within one sibling list: all essential columns must form a left prefix. */
-export declare function hasEssentialPrefixOrder(siblings: HeaderObject[], essentialAccessors: ReadonlySet<string>): boolean;
-/** Root array mixes pin sections; validate each pin group separately, then recurse into children. */
-export declare function validateFullHeaderTreeEssentialOrder(headers: HeaderObject[], essentialAccessors: ReadonlySet<string>): boolean;
-export declare function getPinnedSectionsState(headers: HeaderObject[]): PinnedSectionsState;
-/**
- * Rebuilds root `headers` order and `pinned` flags from section accessor lists.
- * Clamps essential columns to the left within each section. Returns null if accessors don't match roots.
- */
-export declare function rebuildHeadersFromPinnedState(headers: HeaderObject[], state: PinnedSectionsState, essentialAccessors: ReadonlySet<string>): HeaderObject[] | null;
-/**
- * Move a root column to another pin section.
- * Appends within left/right targets. For `main`, left-pinned columns are inserted at the
- * start of main; right-pinned (and other) columns are inserted at the end of main.
- */
-export declare function moveRootColumnPinSide(headers: HeaderObject[], accessor: Accessor, target: Exclude<PanelSection, "main"> | "main", essentialAccessors: ReadonlySet<string>): HeaderObject[] | null;

package/dist/src/utils/pivot/pivotRows.d.ts

@@ -1,16 +0,0 @@
-import type HeaderObject from "../../types/HeaderObject";
-import type { Accessor } from "../../types/HeaderObject";
-import type Row from "../../types/Row";
-import type { PivotConfig, PivotResult } from "../../types/PivotTypes";
-export type PivotRowsProps = {
-    rows: Row[];
-    pivot: PivotConfig;
-    /** Field catalog (`defaultHeaders`) for labels, types, widths, formatters. */
-    fieldHeaders: HeaderObject[];
-};
-export declare const buildPivotAccessor: (colKey: string, valueAccessor: Accessor) => string;
-export declare const buildPivotRowTotalAccessor: (valueAccessor: Accessor) => string;
-/**
- * Pure transform: flat source rows + pivot config → pivoted rows and generated headers.
- */
-export declare const pivotRows: ({ rows, pivot, fieldHeaders }: PivotRowsProps) => PivotResult;

package/dist/src/utils/quickFilterUtils.d.ts

@@ -1,14 +0,0 @@
-import { SmartFilterToken } from "../types/QuickFilterTypes";
-/**
- * Parses a smart filter query into tokens
- * Supports:
- * - Multi-word: "john engineer" → matches rows containing both "john" AND "engineer"
- * - Phrase: "john doe" → matches exact phrase
- * - Negation: -inactive → excludes rows containing "inactive"
- * - Column-specific: name:john → searches only in name column
- */
-export declare const parseSmartFilter: (query: string) => SmartFilterToken[];
-/**
- * Checks if a value matches a simple filter (case-insensitive contains)
- */
-export declare const matchesSimpleFilter: (value: string, filterText: string, caseSensitive: boolean) => boolean;

package/dist/src/utils/resizeUtils/compensation.d.ts

@@ -1,17 +0,0 @@
-import type HeaderObject from "../../types/HeaderObject";
-/**
- * Distribute compensation among columns proportionally based on available headroom
- * Used in autoExpandColumns mode
- * Positive compensation = shrink columns, Negative compensation = grow columns
- *
- * `shrinkFloors` (accessor -> px) sets each column's shrink floor — its natural
- * width (declared, content-measured, or user-set). Columns give up only their
- * surplus (expanded) space and are never squeezed below their natural width.
- * Falls back to MIN_COLUMN_WIDTH when a column has no known floor.
- */
-export declare const distributeCompensationProportionally: ({ columnsToShrink, totalCompensation, initialWidthsMap, shrinkFloors, }: {
-    columnsToShrink: HeaderObject[];
-    totalCompensation: number;
-    initialWidthsMap: Map<string, number>;
-    shrinkFloors?: Map<string, number> | undefined;
-}) => void;

package/dist/src/utils/resizeUtils/index.d.ts

@@ -1,26 +0,0 @@
-import type HeaderObject from "../../types/HeaderObject";
-import type { Accessor } from "../../types/HeaderObject";
-import type { HandleResizeStartProps } from "../../types/HandleResizeStartProps";
-/**
- * Handler for when resize dragging starts
- */
-export declare const handleResizeStart: ({ autoExpandColumns, collapsedHeaders, containerWidth, event, header, headers, mainBodyRef, onColumnWidthChange, onAutoExpandNaturalWidths, reverse, setHeaders, setIsResizing, shrinkFloors, startWidth, }: HandleResizeStartProps) => void;
-export type ApplyColumnAutoFitWithAutoExpandParams = {
-    collapsedHeaders: Set<Accessor>;
-    containerWidth: number;
-    getTargetLeafWidth: (leafHeader: HeaderObject) => number;
-    header: HeaderObject;
-    headerCellElement: HTMLElement | null;
-    headers: HeaderObject[];
-    mainBodyRef: HandleResizeStartProps["mainBodyRef"];
-    /** Persist the auto-fitted column(s)' widths as their natural widths. */
-    onAutoExpandNaturalWidths?: (widths: Map<string, number>) => void;
-    reverse: boolean;
-    /** Natural-width shrink floors (accessor -> px) for compensating neighbors. */
-    shrinkFloors?: Map<string, number>;
-};
-/**
- * Apply a one-shot "fit to content" width for a column while preserving autoExpand
- * compensation (same redistribution rules as dragging the resize handle).
- */
-export declare const applyColumnAutoFitWithAutoExpand: ({ header, headers, collapsedHeaders, containerWidth, mainBodyRef, reverse, headerCellElement, getTargetLeafWidth, onAutoExpandNaturalWidths, shrinkFloors, }: ApplyColumnAutoFitWithAutoExpandParams) => void;

package/dist/src/utils/resizeUtils/parentHeaderResize.d.ts

@@ -1,11 +0,0 @@
-import type HeaderObject from "../../types/HeaderObject";
-/**
- * Handle resizing of parent headers with multiple children
- */
-export declare const handleParentHeaderResize: ({ delta, leafHeaders, minWidth, startWidth, maxWidth, }: {
-    delta: number;
-    leafHeaders: HeaderObject[];
-    minWidth: number;
-    startWidth: number;
-    maxWidth: number;
-}) => void;

package/dist/src/utils/resizeUtils/sectionWidths.d.ts

@@ -1,36 +0,0 @@
-import type HeaderObject from "../../types/HeaderObject";
-/**
- * Width of the *visible* portion of the main (non-pinned) section: the container
- * width minus the pinned section widths.
- *
- * This is the viewport used for column virtualization (getVisibleBodyCells /
- * getVisibleCells) — NOT `mainWidth` from {@link recalculateAllSectionWidths},
- * which is the full *content* width (sum of all main column widths). Passing the
- * content width here makes every column count as "in viewport", disabling column
- * virtualization (all columns render). See the column-virtualization regression
- * tests.
- *
- * Returns `undefined` when the container has not been measured yet
- * (`containerWidth` 0) so callers fall back to a live `clientWidth` read instead
- * of virtualizing against a 0px viewport.
- */
-export declare const getMainSectionViewportWidth: ({ containerWidth, leftWidth, rightWidth, }: {
-    containerWidth: number;
-    leftWidth: number;
-    rightWidth: number;
-}) => number | undefined;
-/**
- * Recalculate widths for all sections (left, right, main)
- * Returns both constrained widths (for display) and raw content widths (for scrolling)
- */
-export declare const recalculateAllSectionWidths: ({ headers, containerWidth, collapsedHeaders, }: {
-    headers: HeaderObject[];
-    containerWidth?: number | undefined;
-    collapsedHeaders?: Set<string> | undefined;
-}) => {
-    leftWidth: number;
-    rightWidth: number;
-    mainWidth: number;
-    leftContentWidth: number;
-    rightContentWidth: number;
-};

package/dist/src/utils/rowProcessing.d.ts

@@ -1,65 +0,0 @@
-import { CumulativeHeightMap } from "./infiniteScrollUtils";
-import { Accessor } from "../types/HeaderObject";
-import TableRow from "../types/TableRow";
-import { HeightOffsets } from "./infiniteScrollUtils";
-import { CustomTheme } from "../types/CustomTheme";
-export interface ProcessRowsConfig {
-    flattenedRows: TableRow[];
-    paginatableRows: TableRow[];
-    parentEndPositions: number[];
-    currentPage: number;
-    rowsPerPage: number;
-    shouldPaginate: boolean;
-    serverSidePagination: boolean;
-    contentHeight: number | undefined;
-    rowHeight: number;
-    scrollTop: number;
-    scrollDirection?: "up" | "down" | "none";
-    heightOffsets?: HeightOffsets;
-    customTheme: CustomTheme;
-    enableStickyParents: boolean;
-    rowGrouping?: Accessor[];
-}
-export interface ProcessRowsResult {
-    currentTableRows: TableRow[];
-    rowsToRender: TableRow[];
-    /** Visible range start index into currentTableRows (when virtualized). */
-    renderedStartIndex: number;
-    /** Visible range end index into currentTableRows (when virtualized). */
-    renderedEndIndex: number;
-    stickyParents: TableRow[];
-    regularRows: TableRow[];
-    partiallyVisibleRows: TableRow[];
-    paginatedHeightOffsets: HeightOffsets | undefined;
-    heightMap: CumulativeHeightMap | undefined;
-    /** Pre-pagination flattened rows (each row's `position` is its global index).
-     * Used by animation snapshot to include off-page rows so cross-page sort can
-     * FLIP cells in/out from off-screen. */
-    allFlattenedRows: TableRow[];
-    /** Global flattened-list index where the current page starts. 0 when no
-     * pagination is active. Used by animation snapshot to convert global
-     * positions into page-relative `top` values. */
-    pageStartIndex: number;
-}
-export declare function processRows(config: ProcessRowsConfig): ProcessRowsResult;
-/** Layout inputs that do not depend on scroll position (reuse across scroll-raf frames). */
-export interface ProcessRowsScrollReuseBase {
-    currentTableRows: TableRow[];
-    paginatedHeightOffsets: HeightOffsets | undefined;
-    heightMap: CumulativeHeightMap | undefined;
-    allFlattenedRows: TableRow[];
-    pageStartIndex: number;
-}
-/**
- * Recomputes only viewport-dependent fields when pagination, height map, and row list
- * are unchanged (vertical scroll only). Avoids re-running applyPagination and
- * buildCumulativeHeightMap on every scroll frame.
- */
-export declare function recomputeProcessRowsViewport(base: ProcessRowsScrollReuseBase, config: {
-    contentHeight: number | undefined;
-    rowHeight: number;
-    scrollTop: number;
-    scrollDirection?: "up" | "down" | "none";
-    enableStickyParents: boolean;
-    rowGrouping?: Accessor[];
-}): ProcessRowsResult;

package/dist/src/utils/rowSelectionUtils.d.ts

@@ -1,62 +0,0 @@
-import Row from "../types/Row";
-import TableRow from "../types/TableRow";
-import HeaderObject from "../types/HeaderObject";
-import type { RowSelectionMode } from "../types/RowSelectionMode";
-/**
- * Whether the checkbox / row-buttons column should be injected into headers.
- * Always shown when `rowButtons` is set (buttons need a home).
- */
-export declare const shouldShowRowSelectionColumn: (config: {
-    enableRowSelection?: boolean;
-    showRowSelectionColumn?: boolean;
-    rowButtons?: unknown[];
-}) => boolean;
-/**
- * Get the set of selected row IDs from an array of table rows
- */
-export declare const getSelectedRowIds: (tableRows: TableRow[]) => string[];
-/**
- * Check if a specific row is selected
- */
-export declare const isRowSelected: (rowId: string, selectedRows: Set<string>) => boolean;
-/**
- * Check if all rows are selected
- */
-export declare const areAllRowsSelected: (tableRows: TableRow[], selectedRows: Set<string>) => boolean;
-/**
- * Toggle selection of a single row (multiple mode).
- */
-export declare const toggleRowSelection: (rowId: string, selectedRows: Set<string>) => Set<string>;
-/**
- * Set whether a row is selected, respecting selection mode.
- */
-export declare const setRowSelected: (rowId: string, isSelected: boolean, selectedRows: Set<string>, mode?: RowSelectionMode) => Set<string>;
-/**
- * Select a range of visible rows (inclusive) by index into `tableRows`.
- * Used for Shift+arrow keyboard range selection in multiple mode.
- */
-export declare const selectRowRange: (tableRows: TableRow[], startIndex: number, endIndex: number, baseSelection?: Set<string>) => Set<string>;
-/**
- * Select all rows
- */
-export declare const selectAllRows: (tableRows: TableRow[]) => Set<string>;
-/**
- * Deselect all rows
- */
-export declare const deselectAllRows: () => Set<string>;
-/**
- * Get the selected rows from the table rows array
- */
-export declare const getSelectedRows: (tableRows: TableRow[], selectedRows: Set<string>) => Row[];
-/**
- * Find a row by its string row id in the current table rows.
- */
-export declare const findRowById: (tableRows: TableRow[], rowId: string) => Row | undefined;
-/**
- * Get the count of selected rows
- */
-export declare const getSelectedRowCount: (selectedRows: Set<string>) => number;
-/**
- * Create a selection header for the checkbox column
- */
-export declare const createSelectionHeader: (width: number) => HeaderObject;

package/dist/src/utils/rowUtils.d.ts

@@ -1,187 +0,0 @@
-import TableRow from "../types/TableRow";
-import Row from "../types/Row";
-import HeaderObject, { Accessor } from "../types/HeaderObject";
-import CellValue from "../types/CellValue";
-import RowState from "../types/RowState";
-import { CustomTheme } from "../types/CustomTheme";
-import { GetRowId } from "../types/GetRowId";
-import { GenerateRowIdParams } from "../types/GenerateRowIdParams";
-/**
- * Calculate the height of a nested grid based on the number of child rows
- * @param childRowCount - Number of rows in the nested grid
- * @param rowHeight - Height of each row
- * @param headerHeight - Height of the header
- * @param customTheme - Custom theme configuration
- * @returns Calculated height in pixels (includes padding, borders, row separators, and header border)
- */
-export declare const calculateNestedGridHeight: ({ childRowCount, rowHeight, headerHeight, customTheme, }: {
-    childRowCount: number;
-    rowHeight: number;
-    headerHeight: number;
-    customTheme: CustomTheme;
-}) => number;
-/**
- * Calculate the final wrapper height for a nested grid, accounting for custom heights
- *
- * @param calculatedHeight - The default calculated height based on child rows
- * @param customHeight - Optional custom height from nestedTable config (e.g., "200px" or 200)
- * @param customTheme - Custom theme configuration for padding
- * @returns Final height in pixels for the wrapper (includes padding)
- */
-export declare const calculateFinalNestedGridHeight: ({ calculatedHeight, customHeight, customTheme, }: {
-    calculatedHeight: number;
-    customHeight?: string | number | undefined;
-    customTheme: CustomTheme;
-}) => number;
-/**
- * Calculate the inner height for a nested SimpleTable component
- * This accounts for the padding that's applied to the wrapper
- *
- * @param calculatedHeight - The total height of the nested grid row (from calculateNestedGridHeight)
- * @param customHeight - Optional custom height from nestedTable config (e.g., "200px")
- * @param customTheme - Custom theme configuration for padding
- * @returns Height value to pass to the nested SimpleTable (string with units)
- */
-export declare const calculateNestedTableHeight: ({ calculatedHeight, customHeight, customTheme, }: {
-    calculatedHeight: number;
-    customHeight?: string | number | undefined;
-    customTheme: CustomTheme;
-}) => string;
-/**
- * Get a nested property value from an object using dot notation and array bracket notation
- * Examples:
- *   getNestedValue(row, "latest.rank") returns row.latest.rank
- *   getNestedValue(row, "albums[0].title") returns row.albums[0].title
- *   getNestedValue(row, "releaseDate[0]") returns row.releaseDate[0]
- */
-export declare const getNestedValue: (obj: Row, path: Accessor) => CellValue;
-/**
- * True when both arrays have the same length and the same row object references
- * at each index. Used by FilterManager / SortManager so in-place live updates
- * that recompute filter/sort only notify subscribers when membership or order
- * actually changed (`.filter()` / `handleSort` always allocate new arrays).
- */
-export declare const rowsOrderEqual: (a: Row[], b: Row[]) => boolean;
-/**
- * Set a nested property value in an object using dot notation and array bracket notation
- * Examples:
- *   setNestedValue(row, "latest.rank", 5) sets row.latest.rank = 5
- *   setNestedValue(row, "albums[0].title", "New Album") sets row.albums[0].title = "New Album"
- *   setNestedValue(row, "releaseDate[0]", "2024") sets row.releaseDate[0] = "2024"
- */
-export declare const setNestedValue: (obj: Row, path: Accessor, value: CellValue) => void;
-/**
- * Check if an array contains Row objects (vs primitive arrays like string[] or number[])
- */
-export declare const isRowArray: (data: any) => data is Row[];
-/**
- * Generate the row ID array from index path and optional custom identifier.
- *
- * The row ID is always an array that includes:
- * - The index at each level of nesting
- * - The grouping key between levels (for readability)
- * - An optional custom identifier from getRowId (appended at the end)
- *
- * Examples:
- * - Root row (index 1): [1]
- * - Nested store (parent index 1, store index 5): [1, "stores", 5]
- * - With custom ID: [1, "stores", 5, "STORE-101"]
- * - Deep nesting: [1, "stores", 5, "products", 2, "PROD-24"]
- *
- * @param params - Object containing row data, getRowId function, and metadata
- * @returns An array representing the unique row ID path
- */
-export declare const generateRowId: (params: GenerateRowIdParams) => (string | number)[];
-/**
- * Convert a row ID array to a string for use as Map keys, Set members, etc.
- *
- * @param rowId - Array of strings/numbers representing the row ID path
- * @returns A string representation of the row ID
- */
-export declare const rowIdToString: (rowId: (string | number)[]) => string;
-/**
- * Generate a position-independent stable row key.
- *
- * Unlike `generateRowId`, the stable key never includes positional indices, so
- * it survives sort/filter operations. It is used as the basis for the cell DOM
- * `id` and the animation coordinator's snapshot key, allowing the same DOM
- * element to be reused for the same logical row across re-orders (enabling
- * FLIP-based sort animations).
- *
- * When `getRowId` is provided, the key is derived from the user-supplied id.
- * When it is not, the key falls back to the row object's identity (via a
- * WeakMap) so animations still work for plain row arrays. For nested rows the
- * parent's stable key is included as a prefix so siblings of different parents
- * do not collide.
- */
-export declare const generateStableRowKey: (params: {
-    getRowId?: GetRowId;
-    row: Row;
-    depth: number;
-    index: number;
-    rowPath: (string | number)[];
-    rowIndexPath: number[];
-    groupingKey?: string;
-    parentStableKey?: string | null;
-}) => string;
-/**
- * Canonical string key for per-row expandable UI state: {@link expandedRows},
- * {@link collapsedRows}, and entries in {@link rowStateMap} (loading/error/empty).
- *
- * Mirrors {@link TableRow.stableRowKey} whenever it is defined so expand state survives
- * sort/filter reorder while positional `rowId` indices change.
- * Falls back to {@link rowIdToString}(rowId) for synthetic rows without a stable key.
- */
-export declare const expandStateKey: (tableRow: {
-    stableRowKey?: string;
-    rowId: (string | number)[];
-}) => string;
-/**
- * Stable identity for full-width chrome rows (nested grid, loading/error state)
- * under an expanded parent. Parent {@link expandStateKey} survives sort; path-based
- * `rowId` does not, so SectionRenderer must key DOM maps on this instead.
- */
-export declare const nestedChromeRowKey: (parentExpandStateKey: string | number, groupingKey: string | undefined) => string;
-/**
- * Get nested rows from a row based on the grouping path
- */
-export declare const getNestedRows: (row: Row, groupingKey: string) => Row[];
-/**
- * Check if a row has nested rows for a given grouping key
- */
-export declare const hasNestedRows: (row: Row, groupingKey?: string) => boolean;
-/**
- * Determine if a row is expanded based on expandedDepths and manual row overrides
- * @param expandStateRowId - Canonical key for expandable row state ({@link expandStateKey}).
- * Matches keys in expandedRows/collapsedRows (stable across sort/filter when stableRowKey is used).
- * @param depth - The depth level of the row (0-indexed)
- * @param expandedDepths - Set of depth levels that are expanded
- * @param expandedRows - Map of row IDs to their depths for rows that user wants expanded
- * @param collapsedRows - Map of row IDs to their depths for rows that user wants collapsed
- * @returns true if the row is expanded, false otherwise
- */
-export declare const isRowExpanded: (expandStateRowId: string | number, depth: number, expandedDepths: Set<number>, expandedRows: Map<string, number>, collapsedRows: Map<string, number>) => boolean;
-/**
- * Flatten rows recursively based on row grouping configuration
- * Now calculates ALL properties including position and isLastGroupRow
- * Also injects special state rows for loading/error/empty states (only if renderers are available)
- * Also injects nested grid rows when a header has nestedTable configuration
- */
-export declare const flattenRowsWithGrouping: ({ depth, expandedDepths, expandedRows, collapsedRows, rowGrouping, getRowId, rows, displayPositionOffset, rowStateMap, hasLoadingRenderer, hasErrorRenderer, hasEmptyRenderer, headers, rowHeight, headerHeight, customTheme, }: {
-    depth?: number | undefined;
-    expandedDepths: Set<number>;
-    expandedRows: Map<string, number>;
-    collapsedRows: Map<string, number>;
-    rowGrouping?: string[] | undefined;
-    getRowId?: GetRowId | undefined;
-    rows: Row[];
-    displayPositionOffset?: number | undefined;
-    rowStateMap?: Map<string | number, RowState> | undefined;
-    hasLoadingRenderer?: boolean | undefined;
-    hasErrorRenderer?: boolean | undefined;
-    hasEmptyRenderer?: boolean | undefined;
-    headers?: HeaderObject[] | undefined;
-    rowHeight: number;
-    headerHeight: number;
-    customTheme: CustomTheme;
-}) => TableRow[];