simple-table-core 4.0.0 → 4.0.2

package/dist/{src/utils → utils}/columnEditor/columnEditorUtils.d.ts

@@ -1,27 +1,27 @@
-import HeaderObject, { Accessor } from "../../types/HeaderObject";
-import { ColumnVisibilityState } from "../../types/ColumnVisibilityTypes";
-import { FlattenedHeader } from "../../types/FlattenedHeader";
-import { PanelSection } from "../../types/PanelSection";
-export type { FlattenedHeader };
-/**
- * Tracks which drop separator is currently highlighted during a column-editor
- * drag. The `index` is **section-relative** (matches the per-section
- * `visualIndex`, or `-1` for the separator above the first row), so it must be
- * paired with the `panelSection` it belongs to. Without the section, the same
- * index is ambiguous across the pinned-left / main / pinned-right lists and the
- * divider renders in the wrong section.
- */
-export type HoveredSeparator = {
-    panelSection: PanelSection;
-    index: number;
-} | null;
-export declare const findAndMarkParentsVisible: (headers: HeaderObject[], childAccessor: Accessor, visited?: Set<string>) => void;
-export declare const areAllChildrenHidden: (children: HeaderObject[]) => boolean;
-export declare const updateParentHeaders: (headers: HeaderObject[]) => void;
-export declare const buildColumnVisibilityState: (headers: HeaderObject[]) => ColumnVisibilityState;
-export declare const findClosestValidSeparatorIndex: ({ flattenedHeaders, draggingRow, hoveredRowIndex, isTopHalfOfRow, }: {
-    flattenedHeaders: FlattenedHeader[];
-    draggingRow: FlattenedHeader;
-    hoveredRowIndex: number;
-    isTopHalfOfRow: boolean;
-}) => number | null;
+import HeaderObject, { Accessor } from "../../types/HeaderObject";
+import { ColumnVisibilityState } from "../../types/ColumnVisibilityTypes";
+import { FlattenedHeader } from "../../types/FlattenedHeader";
+import { PanelSection } from "../../types/PanelSection";
+export type { FlattenedHeader };
+/**
+ * Tracks which drop separator is currently highlighted during a column-editor
+ * drag. The `index` is **section-relative** (matches the per-section
+ * `visualIndex`, or `-1` for the separator above the first row), so it must be
+ * paired with the `panelSection` it belongs to. Without the section, the same
+ * index is ambiguous across the pinned-left / main / pinned-right lists and the
+ * divider renders in the wrong section.
+ */
+export type HoveredSeparator = {
+    panelSection: PanelSection;
+    index: number;
+} | null;
+export declare const findAndMarkParentsVisible: (headers: HeaderObject[], childAccessor: Accessor, visited?: Set<string>) => void;
+export declare const areAllChildrenHidden: (children: HeaderObject[]) => boolean;
+export declare const updateParentHeaders: (headers: HeaderObject[]) => void;
+export declare const buildColumnVisibilityState: (headers: HeaderObject[]) => ColumnVisibilityState;
+export declare const findClosestValidSeparatorIndex: ({ flattenedHeaders, draggingRow, hoveredRowIndex, isTopHalfOfRow, }: {
+    flattenedHeaders: FlattenedHeader[];
+    draggingRow: FlattenedHeader;
+    hoveredRowIndex: number;
+    isTopHalfOfRow: boolean;
+}) => number | null;

package/dist/{src/utils → utils}/columnEditor/createCheckbox.d.ts

@@ -1,21 +1,21 @@
-/**
- * Creates a vanilla JS checkbox element
- */
-export interface CreateCheckboxOptions {
-    checked: boolean;
-    onChange: (checked: boolean) => void;
-    ariaLabel?: string;
-}
-/** Shared checkmark SVG for checkbox custom visual (used by createCheckbox and update helpers). */
-export declare const createCheckmarkSVG: () => SVGSVGElement;
-/**
- * Updates an existing checkbox DOM (created by createCheckbox) to match the given checked state.
- * Use when the checkbox element is reused (e.g. from cache) and selection state changed.
- * @param container - Element that contains .st-checkbox-input and .st-checkbox-custom (the label or a parent)
- */
-export declare const updateCheckboxElement: (container: HTMLElement, checked: boolean) => void;
-export declare const createCheckbox: ({ checked, onChange, ariaLabel }: CreateCheckboxOptions) => {
-    element: HTMLLabelElement;
-    update: (newChecked: boolean) => void;
-    destroy: () => void;
-};
+/**
+ * Creates a vanilla JS checkbox element
+ */
+export interface CreateCheckboxOptions {
+    checked: boolean;
+    onChange: (checked: boolean) => void;
+    ariaLabel?: string;
+}
+/** Shared checkmark SVG for checkbox custom visual (used by createCheckbox and update helpers). */
+export declare const createCheckmarkSVG: () => SVGSVGElement;
+/**
+ * Updates an existing checkbox DOM (created by createCheckbox) to match the given checked state.
+ * Use when the checkbox element is reused (e.g. from cache) and selection state changed.
+ * @param container - Element that contains .st-checkbox-input and .st-checkbox-custom (the label or a parent)
+ */
+export declare const updateCheckboxElement: (container: HTMLElement, checked: boolean) => void;
+export declare const createCheckbox: ({ checked, onChange, ariaLabel }: CreateCheckboxOptions) => {
+    element: HTMLLabelElement;
+    update: (newChecked: boolean) => void;
+    destroy: () => void;
+};

package/dist/{src/utils → utils}/columnEditor/createColumnEditor.d.ts

@@ -1,26 +1,26 @@
-import HeaderObject from "../../types/HeaderObject";
-import { ColumnEditorSearchFunction, ColumnEditorConfig } from "../../types/ColumnEditorConfig";
-import { ColumnVisibilityState } from "../../types/ColumnVisibilityTypes";
-import { IconsConfig } from "../../types/IconsConfig";
-export interface CreateColumnEditorOptions {
-    columnEditorText: string;
-    editColumns: boolean;
-    headers: HeaderObject[];
-    open: boolean;
-    searchEnabled: boolean;
-    searchPlaceholder: string;
-    searchFunction?: ColumnEditorSearchFunction;
-    columnEditorConfig: ColumnEditorConfig;
-    icons?: IconsConfig;
-    essentialAccessors?: ReadonlySet<string>;
-    resetColumns?: () => void;
-    setHeaders: (headers: HeaderObject[]) => void;
-    onColumnVisibilityChange?: (state: ColumnVisibilityState) => void;
-    onColumnOrderChange?: (headers: HeaderObject[]) => void;
-    setOpen: (open: boolean) => void;
-}
-export declare const createColumnEditor: (options: CreateColumnEditorOptions) => {
-    update: (newOptions: Partial<CreateColumnEditorOptions>) => void;
-    destroy: () => void;
-    element: HTMLDivElement;
-};
+import HeaderObject from "../../types/HeaderObject";
+import { ColumnEditorSearchFunction, ColumnEditorConfig } from "../../types/ColumnEditorConfig";
+import { ColumnVisibilityState } from "../../types/ColumnVisibilityTypes";
+import { IconsConfig } from "../../types/IconsConfig";
+export interface CreateColumnEditorOptions {
+    columnEditorText: string;
+    editColumns: boolean;
+    headers: HeaderObject[];
+    open: boolean;
+    searchEnabled: boolean;
+    searchPlaceholder: string;
+    searchFunction?: ColumnEditorSearchFunction;
+    columnEditorConfig: ColumnEditorConfig;
+    icons?: IconsConfig;
+    essentialAccessors?: ReadonlySet<string>;
+    resetColumns?: () => void;
+    setHeaders: (headers: HeaderObject[]) => void;
+    onColumnVisibilityChange?: (state: ColumnVisibilityState) => void;
+    onColumnOrderChange?: (headers: HeaderObject[]) => void;
+    setOpen: (open: boolean) => void;
+}
+export declare const createColumnEditor: (options: CreateColumnEditorOptions) => {
+    update: (newOptions: Partial<CreateColumnEditorOptions>) => void;
+    destroy: () => void;
+    element: HTMLDivElement;
+};

package/dist/{cjs/src/utils → utils}/columnEditor/createColumnEditorPopout.d.ts

@@ -1,23 +1,23 @@
-import HeaderObject from "../../types/HeaderObject";
-import { ColumnEditorSearchFunction, ColumnEditorConfig } from "../../types/ColumnEditorConfig";
-import { ColumnVisibilityState } from "../../types/ColumnVisibilityTypes";
-import { IconsConfig } from "../../types/IconsConfig";
-export interface CreateColumnEditorPopoutOptions {
-    headers: HeaderObject[];
-    open: boolean;
-    searchEnabled: boolean;
-    searchPlaceholder: string;
-    searchFunction?: ColumnEditorSearchFunction;
-    columnEditorConfig: ColumnEditorConfig;
-    icons?: IconsConfig;
-    essentialAccessors?: ReadonlySet<string>;
-    setHeaders: (headers: HeaderObject[]) => void;
-    onColumnVisibilityChange?: (state: ColumnVisibilityState) => void;
-    onColumnOrderChange?: (headers: HeaderObject[]) => void;
-    resetColumns?: () => void;
-}
-export declare const createColumnEditorPopout: (initialOptions: CreateColumnEditorPopoutOptions) => {
-    element: HTMLDivElement;
-    update: (newOptions: Partial<CreateColumnEditorPopoutOptions>) => void;
-    destroy: () => void;
-};
+import HeaderObject from "../../types/HeaderObject";
+import { ColumnEditorSearchFunction, ColumnEditorConfig } from "../../types/ColumnEditorConfig";
+import { ColumnVisibilityState } from "../../types/ColumnVisibilityTypes";
+import { IconsConfig } from "../../types/IconsConfig";
+export interface CreateColumnEditorPopoutOptions {
+    headers: HeaderObject[];
+    open: boolean;
+    searchEnabled: boolean;
+    searchPlaceholder: string;
+    searchFunction?: ColumnEditorSearchFunction;
+    columnEditorConfig: ColumnEditorConfig;
+    icons?: IconsConfig;
+    essentialAccessors?: ReadonlySet<string>;
+    setHeaders: (headers: HeaderObject[]) => void;
+    onColumnVisibilityChange?: (state: ColumnVisibilityState) => void;
+    onColumnOrderChange?: (headers: HeaderObject[]) => void;
+    resetColumns?: () => void;
+}
+export declare const createColumnEditorPopout: (initialOptions: CreateColumnEditorPopoutOptions) => {
+    element: HTMLDivElement;
+    update: (newOptions: Partial<CreateColumnEditorPopoutOptions>) => void;
+    destroy: () => void;
+};

package/dist/{src/utils → utils}/columnEditor/createColumnEditorRow.d.ts

@@ -1,41 +1,41 @@
-import HeaderObject from "../../types/HeaderObject";
-import { ColumnEditorConfig } from "../../types/ColumnEditorConfig";
-import { IconsConfig } from "../../types/IconsConfig";
-import { FlattenedHeader, HoveredSeparator } from "./columnEditorUtils";
-import { ColumnVisibilityState } from "../../types/ColumnVisibilityTypes";
-import { PanelSection } from "../pinnedColumnUtils";
-export interface CreateColumnEditorRowOptions {
-    allHeaders: HeaderObject[];
-    clearHoverSeparator?: () => void;
-    depth: number;
-    doesAnyHeaderHaveChildren: boolean;
-    draggingRow: FlattenedHeader | null;
-    getDraggingRow?: () => FlattenedHeader | null;
-    getHoveredSeparator?: () => HoveredSeparator;
-    expandedHeaders: Set<string>;
-    flattenedHeaders: FlattenedHeader[];
-    forceExpanded: boolean;
-    header: HeaderObject;
-    hoveredSeparator: HoveredSeparator;
-    panelSection?: PanelSection;
-    rowIndex: number;
-    setDraggingRow: (row: FlattenedHeader | null) => void;
-    setExpandedHeaders: (headers: Set<string>) => void;
-    setHoveredSeparator: (value: HoveredSeparator) => void;
-    columnEditorConfig: ColumnEditorConfig;
-    /** Resolved table icons; `icons.drag` overrides the default column-editor drag handle. */
-    icons?: IconsConfig;
-    essentialAccessors?: ReadonlySet<string>;
-    headers: HeaderObject[];
-    setHeaders: (headers: HeaderObject[]) => void;
-    onColumnVisibilityChange?: (state: ColumnVisibilityState) => void;
-    onColumnOrderChange?: (headers: HeaderObject[]) => void;
-    /** When set (e.g. after expand toggle), used with updateExpandIconState so the chevron animates like table cells. */
-    previousExpandedHeaders?: ReadonlySet<string>;
-}
-export interface CreateColumnEditorRowResult {
-    fragment: DocumentFragment;
-    /** Run after the row fragment is connected to the document (e.g. listEl.appendChild). */
-    scheduleExpandIconAnimation?: () => void;
-}
-export declare const createColumnEditorRow: (options: CreateColumnEditorRowOptions) => CreateColumnEditorRowResult;
+import HeaderObject from "../../types/HeaderObject";
+import { ColumnEditorConfig } from "../../types/ColumnEditorConfig";
+import { IconsConfig } from "../../types/IconsConfig";
+import { FlattenedHeader, HoveredSeparator } from "./columnEditorUtils";
+import { ColumnVisibilityState } from "../../types/ColumnVisibilityTypes";
+import { PanelSection } from "../pinnedColumnUtils";
+export interface CreateColumnEditorRowOptions {
+    allHeaders: HeaderObject[];
+    clearHoverSeparator?: () => void;
+    depth: number;
+    doesAnyHeaderHaveChildren: boolean;
+    draggingRow: FlattenedHeader | null;
+    getDraggingRow?: () => FlattenedHeader | null;
+    getHoveredSeparator?: () => HoveredSeparator;
+    expandedHeaders: Set<string>;
+    flattenedHeaders: FlattenedHeader[];
+    forceExpanded: boolean;
+    header: HeaderObject;
+    hoveredSeparator: HoveredSeparator;
+    panelSection?: PanelSection;
+    rowIndex: number;
+    setDraggingRow: (row: FlattenedHeader | null) => void;
+    setExpandedHeaders: (headers: Set<string>) => void;
+    setHoveredSeparator: (value: HoveredSeparator) => void;
+    columnEditorConfig: ColumnEditorConfig;
+    /** Resolved table icons; `icons.drag` overrides the default column-editor drag handle. */
+    icons?: IconsConfig;
+    essentialAccessors?: ReadonlySet<string>;
+    headers: HeaderObject[];
+    setHeaders: (headers: HeaderObject[]) => void;
+    onColumnVisibilityChange?: (state: ColumnVisibilityState) => void;
+    onColumnOrderChange?: (headers: HeaderObject[]) => void;
+    /** When set (e.g. after expand toggle), used with updateExpandIconState so the chevron animates like table cells. */
+    previousExpandedHeaders?: ReadonlySet<string>;
+}
+export interface CreateColumnEditorRowResult {
+    fragment: DocumentFragment;
+    /** Run after the row fragment is connected to the document (e.g. listEl.appendChild). */
+    scheduleExpandIconAnimation?: () => void;
+}
+export declare const createColumnEditorRow: (options: CreateColumnEditorRowOptions) => CreateColumnEditorRowResult;

package/dist/{cjs/src/utils → utils}/columnIndicesUtils.d.ts

@@ -1,15 +1,15 @@
-import HeaderObject, { Accessor } from "../types/HeaderObject";
-export type ColumnIndices = Record<string, number>;
-/**
- * Calculates column indices for all headers to ensure consistent colIndex values
- * This function is used in both TableBody and TableHeader components
- *
- * Note: In hierarchical headers, a parent header and its first child can share
- * the same column index, which is needed for proper alignment in the grid.
- */
-export declare function calculateColumnIndices({ headers, pinnedLeftColumns, pinnedRightColumns, collapsedHeaders, }: {
-    headers: HeaderObject[];
-    pinnedLeftColumns: HeaderObject[];
-    pinnedRightColumns: HeaderObject[];
-    collapsedHeaders?: Set<Accessor>;
-}): ColumnIndices;
+import HeaderObject, { Accessor } from "../types/HeaderObject";
+export type ColumnIndices = Record<string, number>;
+/**
+ * Calculates column indices for all headers to ensure consistent colIndex values
+ * This function is used in both TableBody and TableHeader components
+ *
+ * Note: In hierarchical headers, a parent header and its first child can share
+ * the same column index, which is needed for proper alignment in the grid.
+ */
+export declare function calculateColumnIndices({ headers, pinnedLeftColumns, pinnedRightColumns, collapsedHeaders, }: {
+    headers: HeaderObject[];
+    pinnedLeftColumns: HeaderObject[];
+    pinnedRightColumns: HeaderObject[];
+    collapsedHeaders?: Set<Accessor>;
+}): ColumnIndices;

package/dist/{src/utils → utils}/columnVirtualizationUtils.d.ts

@@ -1,128 +1,128 @@
-import HeaderObject, { Accessor } from "../types/HeaderObject";
-import { Pinned } from "../types/Pinned";
-/**
- * Precomputed cumulative width data structure for O(1) column position lookups
- * and O(log n) viewport calculations (analogous to CumulativeHeightMap for rows)
- */
-export interface CumulativeWidthMap {
-    /** Array where index i contains the left pixel position of leaf column i */
-    columnLeftPositions: number[];
-    /** Total width of all columns combined */
-    totalWidth: number;
-    /** Ordered array of leaf headers (actual columns that render) */
-    leafHeaders: HeaderObject[];
-}
-/**
- * Get all leaf headers (actual columns that render) from a header tree
- * Handles nested headers, collapsed state, showWhen logic, and pinned sections
- *
- * Uses the existing displayCell utility to respect all visibility rules
- *
- * @param headers - Array of header objects (can be nested)
- * @param pinned - The pinned state for this section
- * @param allHeaders - All headers in the table (for displayCell context)
- * @param collapsedHeaders - Set of collapsed header accessors
- * @returns Flat array of leaf headers in order
- */
-export declare const getLeafHeaders: (headers: HeaderObject[], pinned: Pinned | undefined, allHeaders: HeaderObject[], collapsedHeaders?: Set<Accessor>) => HeaderObject[];
-/**
- * Build a cumulative width map for efficient viewport calculations
- * This precomputes the left position of every column, enabling:
- * - O(1) lookup of column left position
- * - O(log n) binary search to find columns in viewport
- *
- * Similar to buildCumulativeHeightMap for rows
- *
- * @param headers - Array of header objects for a section
- * @param pinned - The pinned state for this section
- * @param allHeaders - All headers in the table (for displayCell context)
- * @param collapsedHeaders - Set of collapsed header accessors
- * @returns Cumulative width map with column positions
- */
-export declare const buildCumulativeWidthMap: (headers: HeaderObject[], pinned: Pinned | undefined, allHeaders: HeaderObject[], collapsedHeaders?: Set<Accessor>) => CumulativeWidthMap;
-/**
- * Find the column index at a given scroll position using binary search
- * Returns the index of the column that contains or is closest to the scroll position
- *
- * Similar to findRowAtScrollPosition for rows
- *
- * @param scrollLeft - The horizontal scroll position in pixels
- * @param widthMap - Precomputed cumulative width map
- * @returns Column index at the scroll position
- */
-export declare const findColumnAtScrollPosition: (scrollLeft: number, widthMap: CumulativeWidthMap) => number;
-/**
- * Calculate visible columns for viewport with overscan buffer
- * Returns column indices and the actual leaf header objects to render
- *
- * Similar to getViewportCalculations for rows
- *
- * @param scrollLeft - Current horizontal scroll position
- * @param viewportWidth - Width of the visible viewport
- * @param bufferColumnCount - Number of columns to render outside viewport (overscan)
- * @param scrollDirection - Direction of scroll for asymmetric overscan
- * @param widthMap - Precomputed cumulative width map
- * @returns Object with startIndex, endIndex, and columns array (leaf columns only)
- */
-export declare const getVisibleColumns: ({ scrollLeft, viewportWidth, bufferColumnCount, scrollDirection, widthMap, }: {
-    scrollLeft: number;
-    viewportWidth: number;
-    bufferColumnCount: number;
-    scrollDirection?: "left" | "right" | "none" | undefined;
-    widthMap: CumulativeWidthMap;
-}) => {
-    startIndex: number;
-    endIndex: number;
-    columns: HeaderObject[];
-};
-/**
- * Build parent-child relationship maps for the header hierarchy
- * This enables efficient lookup of ancestors for visible leaf columns
- *
- * @param headers - Array of top-level header objects
- * @param pinned - The pinned state for this section
- * @param allHeaders - All headers in the table (for displayCell context)
- * @param collapsedHeaders - Set of collapsed header accessors
- * @returns Maps for leaf-to-parents and parent-to-leaves relationships
- */
-export declare const buildColumnHierarchy: (headers: HeaderObject[], pinned: Pinned | undefined, allHeaders: HeaderObject[], collapsedHeaders?: Set<Accessor>) => {
-    leafToParents: Map<Accessor, Accessor[]>;
-    parentToLeaves: Map<Accessor, Accessor[]>;
-};
-/**
- * Get all headers to render (visible leaves + their ancestors)
- *
- * Strategy: Include a parent header if ANY of its children are visible
- *
- * @param visibleLeafColumns - Array of visible leaf header objects
- * @param leafToParents - Map from leaf accessor to parent accessor chain
- * @returns Set of all header accessors to render (leaves + ancestors)
- */
-export declare const getHeadersToRender: (visibleLeafColumns: HeaderObject[], leafToParents: Map<Accessor, Accessor[]>) => Set<Accessor>;
-/**
- * GridCell type (matches TableHeaderSection.tsx)
- * Represents a single header cell in the grid with its positioning
- */
-export type GridCell = {
-    header: HeaderObject;
-    gridColumnStart: number;
-    gridColumnEnd: number;
-    gridRowStart: number;
-    gridRowEnd: number;
-    colIndex: number;
-    parentHeader?: HeaderObject;
-};
-/**
- * Recalculate grid column positions for visible headers
- * Adjusts gridColumnStart/End to account for hidden columns before the viewport
- *
- * This is the key function that makes virtualization work - it offsets the grid
- * positions so that the visible subset appears correctly positioned
- *
- * @param originalGridCells - All grid cells from the full header tree
- * @param headersToRender - Set of header accessors that should be rendered
- * @param visibleLeafColumns - Array of visible leaf columns (for determining offset)
- * @param startColumnIndex - Index of first visible leaf column in the full leaf array
- * @returns Filtered and repositioned grid cells
- */
-export declare const recalculateGridPositions: (originalGridCells: GridCell[], headersToRender: Set<Accessor>, visibleLeafColumns: HeaderObject[], startColumnIndex: number) => GridCell[];
+import HeaderObject, { Accessor } from "../types/HeaderObject";
+import { Pinned } from "../types/Pinned";
+/**
+ * Precomputed cumulative width data structure for O(1) column position lookups
+ * and O(log n) viewport calculations (analogous to CumulativeHeightMap for rows)
+ */
+export interface CumulativeWidthMap {
+    /** Array where index i contains the left pixel position of leaf column i */
+    columnLeftPositions: number[];
+    /** Total width of all columns combined */
+    totalWidth: number;
+    /** Ordered array of leaf headers (actual columns that render) */
+    leafHeaders: HeaderObject[];
+}
+/**
+ * Get all leaf headers (actual columns that render) from a header tree
+ * Handles nested headers, collapsed state, showWhen logic, and pinned sections
+ *
+ * Uses the existing displayCell utility to respect all visibility rules
+ *
+ * @param headers - Array of header objects (can be nested)
+ * @param pinned - The pinned state for this section
+ * @param allHeaders - All headers in the table (for displayCell context)
+ * @param collapsedHeaders - Set of collapsed header accessors
+ * @returns Flat array of leaf headers in order
+ */
+export declare const getLeafHeaders: (headers: HeaderObject[], pinned: Pinned | undefined, allHeaders: HeaderObject[], collapsedHeaders?: Set<Accessor>) => HeaderObject[];
+/**
+ * Build a cumulative width map for efficient viewport calculations
+ * This precomputes the left position of every column, enabling:
+ * - O(1) lookup of column left position
+ * - O(log n) binary search to find columns in viewport
+ *
+ * Similar to buildCumulativeHeightMap for rows
+ *
+ * @param headers - Array of header objects for a section
+ * @param pinned - The pinned state for this section
+ * @param allHeaders - All headers in the table (for displayCell context)
+ * @param collapsedHeaders - Set of collapsed header accessors
+ * @returns Cumulative width map with column positions
+ */
+export declare const buildCumulativeWidthMap: (headers: HeaderObject[], pinned: Pinned | undefined, allHeaders: HeaderObject[], collapsedHeaders?: Set<Accessor>) => CumulativeWidthMap;
+/**
+ * Find the column index at a given scroll position using binary search
+ * Returns the index of the column that contains or is closest to the scroll position
+ *
+ * Similar to findRowAtScrollPosition for rows
+ *
+ * @param scrollLeft - The horizontal scroll position in pixels
+ * @param widthMap - Precomputed cumulative width map
+ * @returns Column index at the scroll position
+ */
+export declare const findColumnAtScrollPosition: (scrollLeft: number, widthMap: CumulativeWidthMap) => number;
+/**
+ * Calculate visible columns for viewport with overscan buffer
+ * Returns column indices and the actual leaf header objects to render
+ *
+ * Similar to getViewportCalculations for rows
+ *
+ * @param scrollLeft - Current horizontal scroll position
+ * @param viewportWidth - Width of the visible viewport
+ * @param bufferColumnCount - Number of columns to render outside viewport (overscan)
+ * @param scrollDirection - Direction of scroll for asymmetric overscan
+ * @param widthMap - Precomputed cumulative width map
+ * @returns Object with startIndex, endIndex, and columns array (leaf columns only)
+ */
+export declare const getVisibleColumns: ({ scrollLeft, viewportWidth, bufferColumnCount, scrollDirection, widthMap, }: {
+    scrollLeft: number;
+    viewportWidth: number;
+    bufferColumnCount: number;
+    scrollDirection?: "left" | "right" | "none";
+    widthMap: CumulativeWidthMap;
+}) => {
+    startIndex: number;
+    endIndex: number;
+    columns: HeaderObject[];
+};
+/**
+ * Build parent-child relationship maps for the header hierarchy
+ * This enables efficient lookup of ancestors for visible leaf columns
+ *
+ * @param headers - Array of top-level header objects
+ * @param pinned - The pinned state for this section
+ * @param allHeaders - All headers in the table (for displayCell context)
+ * @param collapsedHeaders - Set of collapsed header accessors
+ * @returns Maps for leaf-to-parents and parent-to-leaves relationships
+ */
+export declare const buildColumnHierarchy: (headers: HeaderObject[], pinned: Pinned | undefined, allHeaders: HeaderObject[], collapsedHeaders?: Set<Accessor>) => {
+    leafToParents: Map<Accessor, Accessor[]>;
+    parentToLeaves: Map<Accessor, Accessor[]>;
+};
+/**
+ * Get all headers to render (visible leaves + their ancestors)
+ *
+ * Strategy: Include a parent header if ANY of its children are visible
+ *
+ * @param visibleLeafColumns - Array of visible leaf header objects
+ * @param leafToParents - Map from leaf accessor to parent accessor chain
+ * @returns Set of all header accessors to render (leaves + ancestors)
+ */
+export declare const getHeadersToRender: (visibleLeafColumns: HeaderObject[], leafToParents: Map<Accessor, Accessor[]>) => Set<Accessor>;
+/**
+ * GridCell type (matches TableHeaderSection.tsx)
+ * Represents a single header cell in the grid with its positioning
+ */
+export type GridCell = {
+    header: HeaderObject;
+    gridColumnStart: number;
+    gridColumnEnd: number;
+    gridRowStart: number;
+    gridRowEnd: number;
+    colIndex: number;
+    parentHeader?: HeaderObject;
+};
+/**
+ * Recalculate grid column positions for visible headers
+ * Adjusts gridColumnStart/End to account for hidden columns before the viewport
+ *
+ * This is the key function that makes virtualization work - it offsets the grid
+ * positions so that the visible subset appears correctly positioned
+ *
+ * @param originalGridCells - All grid cells from the full header tree
+ * @param headersToRender - Set of header accessors that should be rendered
+ * @param visibleLeafColumns - Array of visible leaf columns (for determining offset)
+ * @param startColumnIndex - Index of first visible leaf column in the full leaf array
+ * @returns Filtered and repositioned grid cells
+ */
+export declare const recalculateGridPositions: (originalGridCells: GridCell[], headersToRender: Set<Accessor>, visibleLeafColumns: HeaderObject[], startColumnIndex: number) => GridCell[];

package/dist/{cjs/src/utils → utils}/csvExportUtils.d.ts

@@ -1,14 +1,14 @@
-import HeaderObject from "../types/HeaderObject";
-import TableRow from "../types/TableRow";
-/**
- * Converts table data to CSV format
- */
-export declare const convertToCSV: (visibleRows: TableRow[], headers: HeaderObject[], includeHeadersInCSVExport?: boolean) => string;
-/**
- * Triggers a download of the CSV file
- */
-export declare const downloadCSV: (csvContent: string, filename?: string) => void;
-/**
- * Main export function that combines CSV conversion and download
- */
-export declare const exportTableToCSV: (visibleRows: TableRow[], headers: HeaderObject[], filename?: string, includeHeadersInCSVExport?: boolean) => void;
+import HeaderObject from "../types/HeaderObject";
+import TableRow from "../types/TableRow";
+/**
+ * Converts table data to CSV format
+ */
+export declare const convertToCSV: (visibleRows: TableRow[], headers: HeaderObject[], includeHeadersInCSVExport?: boolean) => string;
+/**
+ * Triggers a download of the CSV file
+ */
+export declare const downloadCSV: (csvContent: string, filename?: string) => void;
+/**
+ * Main export function that combines CSV conversion and download
+ */
+export declare const exportTableToCSV: (visibleRows: TableRow[], headers: HeaderObject[], filename?: string, includeHeadersInCSVExport?: boolean) => void;

package/dist/{cjs/src/utils → utils}/dateUtils.d.ts

@@ -1,18 +1,18 @@
-/**
- * Utility functions for safe date handling to avoid timezone issues
- */
-/**
- * Safely parses a date string in YYYY-MM-DD format to a Date object at noon local time
- * This prevents timezone edge cases where midnight UTC becomes the previous day in local time
- */
-export declare const parseDateString: (dateString: string) => Date;
-/**
- * Normalizes a date to remove time component for accurate date-only comparison
- * Creates the date at noon to avoid timezone edge cases
- */
-export declare const normalizeDate: (date: Date) => Date;
-/**
- * Safely creates a Date object from various input types
- * Always creates dates at noon local time to avoid timezone issues
- */
-export declare const createSafeDate: (input: string | number | Date | null | undefined) => Date;
+/**
+ * Utility functions for safe date handling to avoid timezone issues
+ */
+/**
+ * Safely parses a date string in YYYY-MM-DD format to a Date object at noon local time
+ * This prevents timezone edge cases where midnight UTC becomes the previous day in local time
+ */
+export declare const parseDateString: (dateString: string) => Date;
+/**
+ * Normalizes a date to remove time component for accurate date-only comparison
+ * Creates the date at noon to avoid timezone edge cases
+ */
+export declare const normalizeDate: (date: Date) => Date;
+/**
+ * Safely creates a Date object from various input types
+ * Always creates dates at noon local time to avoid timezone issues
+ */
+export declare const createSafeDate: (input: string | number | Date | null | undefined) => Date;