simple-table-core 4.0.1 → 4.0.3

package/dist/{src/utils → utils}/headerCell/eventTracking.d.ts

@@ -1,28 +1,28 @@
-import HeaderObject from "../../types/HeaderObject";
-export declare let prevUpdateTime: number;
-export declare let prevDraggingPosition: {
-    screenX: number;
-    screenY: number;
-};
-export declare let prevHeaders: HeaderObject[] | null;
-export declare const setPrevUpdateTime: (time: number) => void;
-export declare const setPrevDraggingPosition: (position: {
-    screenX: number;
-    screenY: number;
-}) => void;
-export declare const setPrevHeaders: (headers: HeaderObject[] | null) => void;
-export declare const getRenderedCells: (container: HTMLElement) => Map<string, HTMLElement>;
-export interface CachedHeaderPosition {
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-}
-export declare const getHeaderPositionCache: (container: HTMLElement) => Map<string, CachedHeaderPosition>;
-export declare const REVERT_TO_PREVIOUS_HEADERS_DELAY = 150;
-export declare const throttle: (callback: () => void, limit: number) => void;
-export declare const addTrackedEventListener: (element: HTMLElement, event: string, handler: EventListener, options?: AddEventListenerOptions) => void;
-/** Header tooltips are portaled under .simple-table-root; remove them when header DOM is torn down
- *  without pointer leave (e.g. sort/filter invalidates context cache and removes header cells). */
-export declare const removeFloatingHeaderTooltips: (fromElement: HTMLElement) => void;
-export declare const cleanupHeaderCellRendering: (container?: HTMLElement, onHostDiscard?: ((host: HTMLElement) => void) | undefined) => void;
+import HeaderObject from "../../types/HeaderObject";
+export declare let prevUpdateTime: number;
+export declare let prevDraggingPosition: {
+    screenX: number;
+    screenY: number;
+};
+export declare let prevHeaders: HeaderObject[] | null;
+export declare const setPrevUpdateTime: (time: number) => void;
+export declare const setPrevDraggingPosition: (position: {
+    screenX: number;
+    screenY: number;
+}) => void;
+export declare const setPrevHeaders: (headers: HeaderObject[] | null) => void;
+export declare const getRenderedCells: (container: HTMLElement) => Map<string, HTMLElement>;
+export interface CachedHeaderPosition {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export declare const getHeaderPositionCache: (container: HTMLElement) => Map<string, CachedHeaderPosition>;
+export declare const REVERT_TO_PREVIOUS_HEADERS_DELAY = 150;
+export declare const throttle: (callback: () => void, limit: number) => void;
+export declare const addTrackedEventListener: (element: HTMLElement, event: string, handler: EventListener, options?: AddEventListenerOptions) => void;
+/** Header tooltips are portaled under .simple-table-root; remove them when header DOM is torn down
+ *  without pointer leave (e.g. sort/filter invalidates context cache and removes header cells). */
+export declare const removeFloatingHeaderTooltips: (fromElement: HTMLElement) => void;
+export declare const cleanupHeaderCellRendering: (container?: HTMLElement, onHostDiscard?: (host: HTMLElement) => void) => void;

package/dist/{src/utils → utils}/headerCell/filtering.d.ts

@@ -1,3 +1,3 @@
-import HeaderObject from "../../types/HeaderObject";
-import { HeaderRenderContext } from "./types";
-export declare const createFilterIcon: (header: HeaderObject, context: HeaderRenderContext) => HTMLElement | null;
+import HeaderObject from "../../types/HeaderObject";
+import { HeaderRenderContext } from "./types";
+export declare const createFilterIcon: (header: HeaderObject, context: HeaderRenderContext) => HTMLElement | null;

package/dist/{src/utils → utils}/headerCell/resizing.d.ts

@@ -1,3 +1,3 @@
-import HeaderObject from "../../types/HeaderObject";
-import { HeaderRenderContext } from "./types";
-export declare const createResizeHandle: (header: HeaderObject, context: HeaderRenderContext) => HTMLElement | null;
+import HeaderObject from "../../types/HeaderObject";
+import { HeaderRenderContext } from "./types";
+export declare const createResizeHandle: (header: HeaderObject, context: HeaderRenderContext) => HTMLElement | null;

package/dist/{src/utils → utils}/headerCell/selection.d.ts

@@ -1,10 +1,10 @@
-import { HeaderRenderContext } from "./types";
-/**
- * Updates an existing header select-all checkbox to match the current checked state.
- * Use when selection changes but the header cell DOM is reused (e.g. from cache).
- */
-export declare const updateHeaderSelectionCheckbox: (cellElement: HTMLElement, checked: boolean) => void;
-/**
- * Creates the header select-all checkbox using the shared createCheckbox (same as column editor popout).
- */
-export declare const createSelectionCheckbox: (context: HeaderRenderContext) => HTMLElement;
+import { HeaderRenderContext } from "./types";
+/**
+ * Updates an existing header select-all checkbox to match the current checked state.
+ * Use when selection changes but the header cell DOM is reused (e.g. from cache).
+ */
+export declare const updateHeaderSelectionCheckbox: (cellElement: HTMLElement, checked: boolean) => void;
+/**
+ * Creates the header select-all checkbox using the shared createCheckbox (same as column editor popout).
+ */
+export declare const createSelectionCheckbox: (context: HeaderRenderContext) => HTMLElement;

package/dist/{src/utils → utils}/headerCell/sorting.d.ts

@@ -1,3 +1,3 @@
-import HeaderObject from "../../types/HeaderObject";
-import { HeaderRenderContext } from "./types";
-export declare const createSortIcon: (header: HeaderObject, context: HeaderRenderContext) => HTMLElement | null;
+import HeaderObject from "../../types/HeaderObject";
+import { HeaderRenderContext } from "./types";
+export declare const createSortIcon: (header: HeaderObject, context: HeaderRenderContext) => HTMLElement | null;

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

@@ -1,7 +1,7 @@
-import { AbsoluteCell, HeaderRenderContext } from "./types";
-export declare const calculateHeaderCellClasses: (cell: AbsoluteCell, context: HeaderRenderContext) => string;
-export declare const createHeaderCellElement: (cell: AbsoluteCell, context: HeaderRenderContext) => HTMLElement;
-export declare const getLastHeaderIndex: (absoluteCells: AbsoluteCell[]) => number;
-/** Replace sort/filter/collapse icons on an existing header cell, preserving label/drag handlers. */
-export declare const refreshHeaderCellIcons: (cellElement: HTMLElement, header: AbsoluteCell["header"], context: HeaderRenderContext, colIndex: number) => void;
-export declare const updateHeaderCellElement: (cellElement: HTMLElement, cell: AbsoluteCell, context: HeaderRenderContext) => void;
+import { AbsoluteCell, HeaderRenderContext } from "./types";
+export declare const calculateHeaderCellClasses: (cell: AbsoluteCell, context: HeaderRenderContext) => string;
+export declare const createHeaderCellElement: (cell: AbsoluteCell, context: HeaderRenderContext) => HTMLElement;
+export declare const getLastHeaderIndex: (absoluteCells: AbsoluteCell[]) => number;
+/** Replace sort/filter/collapse icons on an existing header cell, preserving label/drag handlers. */
+export declare const refreshHeaderCellIcons: (cellElement: HTMLElement, header: AbsoluteCell["header"], context: HeaderRenderContext, colIndex: number) => void;
+export declare const updateHeaderCellElement: (cellElement: HTMLElement, cell: AbsoluteCell, context: HeaderRenderContext) => void;

package/dist/{src/utils → utils}/headerCell/types.d.ts

@@ -1,110 +1,110 @@
-import HeaderObject, { Accessor } from "../../types/HeaderObject";
-import SortColumn from "../../types/SortColumn";
-import { TableFilterState, FilterCondition } from "../../types/FilterTypes";
-import { IconsConfig } from "../../types/IconsConfig";
-import Row from "../../types/Row";
-import type { AccordionAxis } from "../accordionAnimation";
-import type { AnimationCoordinator } from "../../managers/AnimationCoordinator";
-type SetStateAction<T> = T | ((prevState: T) => T);
-type Dispatch<A> = (value: A) => void;
-type MutableRefObject<T> = {
-    current: T;
-};
-type RefObject<T> = {
-    readonly current: T | null;
-};
-export interface AbsoluteCell {
-    header: HeaderObject;
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-    colIndex: number;
-    parentHeader?: HeaderObject;
-}
-export interface HeaderRenderContext {
-    areAllRowsSelected?: () => boolean;
-    autoExpandColumns: boolean;
-    collapsedHeaders: Set<Accessor>;
-    essentialAccessors?: ReadonlySet<string>;
-    columnBorders: boolean;
-    columnReordering: boolean;
-    columnResizing: boolean;
-    columnsWithSelectedCells: Set<number>;
-    containerWidth: number;
-    draggedHeaderRef: MutableRefObject<HeaderObject | null>;
-    enableHeaderEditing?: boolean;
-    enableRowSelection?: boolean;
-    /** When `"single"`, header select-all checkbox is hidden. */
-    rowSelectionMode?: "single" | "multiple";
-    filters: TableFilterState;
-    forceUpdate: () => void;
-    getCollapsedHeaders?: () => Set<Accessor>; /** Get current collapsed headers (avoids stale closure in toggle handler). */
-    /** Natural-width shrink floors (accessor -> px) for auto-expand column resize. */
-    getShrinkFloors?: () => Map<string, number>;
-    /** Persist user-set widths (drag / double-click auto-fit) as natural widths. */
-    onAutoExpandNaturalWidths?: (widths: Map<string, number>) => void;
-    handleApplyFilter: (filter: FilterCondition) => void;
-    handleClearFilter: (accessor: Accessor) => void;
-    handleSelectAll?: (checked: boolean) => void;
-    /** Live header tree from table state (avoids stale `headers` snapshot in long-lived handlers). */
-    getHeaders: () => HeaderObject[];
-    headerHeight: number;
-    headerRegistry?: Map<string, {
-        setEditing: (editing: boolean) => void;
-    }>;
-    headers: HeaderObject[];
-    hoveredHeaderRef: MutableRefObject<HeaderObject | null>;
-    icons: IconsConfig;
-    lastHeaderIndex: number;
-    mainBodyRef: RefObject<HTMLDivElement>;
-    mainSectionContainerWidth?: number; /** Main section *content* width (sum of all non-pinned column widths). NOT the virtualization viewport. */
-    mainSectionViewportWidth?: number; /** Main section *visible* viewport width (container minus pinned); use for getVisibleCells when !pinned */
-    /** When false, skip column virtualization and render every header cell in the main section. Default true. */
-    enableVirtualization?: boolean;
-    onColumnOrderChange?: (headers: HeaderObject[]) => void;
-    onColumnSelect?: (header: HeaderObject) => void;
-    onColumnWidthChange?: (headers: HeaderObject[]) => void;
-    onHeaderEdit?: (header: HeaderObject, newLabel: string) => void;
-    onSort: (accessor: Accessor) => void;
-    onTableHeaderDragEnd: (headers: HeaderObject[]) => void;
-    pinned?: "left" | "right";
-    /** Mirrors body context: pinned strip width for cache invalidation when only section width changes. */
-    pinnedSectionWidthPx?: number;
-    pinnedLeftRef: RefObject<HTMLDivElement>;
-    pinnedRightRef: RefObject<HTMLDivElement>;
-    reverse: boolean;
-    rows: Row[];
-    selectColumns?: (columnIndices: number[]) => void;
-    selectableColumns?: boolean;
-    selectedColumns: Set<number>;
-    selectedRowCount?: number; /** Used for context cache invalidation when row selection changes */
-    setCollapsedHeaders: Dispatch<SetStateAction<Set<Accessor>>>;
-    setHeaders: Dispatch<SetStateAction<HeaderObject[]>>;
-    setInitialFocusedCell: (cell: any) => void;
-    setIsResizing: Dispatch<SetStateAction<boolean>>;
-    setSelectedCells: Dispatch<SetStateAction<Set<string>>>;
-    setSelectedColumns: Dispatch<SetStateAction<Set<number>>>;
-    sort: SortColumn | null;
-    /**
-     * Active accordion animation axis (parallel to {@link CellRenderContext.accordionAxis}).
-     * Used so newly-visible header cells (e.g. children of a just-expanded
-     * collapsible header) start at zero width and CSS-transition to their
-     * final width.
-     */
-    accordionAxis?: AccordionAxis;
-    /**
-     * Animation coordinator (when enabled). The header renderer uses
-     * {@link AnimationCoordinator.hasSnapshotEntry} to detect cells that did
-     * not exist in the pre-render layout — those are the incoming cells
-     * driving the unfold animation.
-     */
-    animationCoordinator?: AnimationCoordinator;
-    /**
-     * Called immediately before a header host (or its label content) is permanently
-     * discarded so adapters can tear down renderer subtrees (e.g. React portals).
-     * Mirrors {@link CellRenderContext.onRendererHostDiscard}.
-     */
-    onRendererHostDiscard?: (host: HTMLElement) => void;
-}
-export {};
+import HeaderObject, { Accessor } from "../../types/HeaderObject";
+import SortColumn from "../../types/SortColumn";
+import { TableFilterState, FilterCondition } from "../../types/FilterTypes";
+import { IconsConfig } from "../../types/IconsConfig";
+import Row from "../../types/Row";
+import type { AccordionAxis } from "../accordionAnimation";
+import type { AnimationCoordinator } from "../../managers/AnimationCoordinator";
+type SetStateAction<T> = T | ((prevState: T) => T);
+type Dispatch<A> = (value: A) => void;
+type MutableRefObject<T> = {
+    current: T;
+};
+type RefObject<T> = {
+    readonly current: T | null;
+};
+export interface AbsoluteCell {
+    header: HeaderObject;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    colIndex: number;
+    parentHeader?: HeaderObject;
+}
+export interface HeaderRenderContext {
+    areAllRowsSelected?: () => boolean;
+    autoExpandColumns: boolean;
+    collapsedHeaders: Set<Accessor>;
+    essentialAccessors?: ReadonlySet<string>;
+    columnBorders: boolean;
+    columnReordering: boolean;
+    columnResizing: boolean;
+    columnsWithSelectedCells: Set<number>;
+    containerWidth: number;
+    draggedHeaderRef: MutableRefObject<HeaderObject | null>;
+    enableHeaderEditing?: boolean;
+    enableRowSelection?: boolean;
+    /** When `"single"`, header select-all checkbox is hidden. */
+    rowSelectionMode?: "single" | "multiple";
+    filters: TableFilterState;
+    forceUpdate: () => void;
+    getCollapsedHeaders?: () => Set<Accessor>; /** Get current collapsed headers (avoids stale closure in toggle handler). */
+    /** Natural-width shrink floors (accessor -> px) for auto-expand column resize. */
+    getShrinkFloors?: () => Map<string, number>;
+    /** Persist user-set widths (drag / double-click auto-fit) as natural widths. */
+    onAutoExpandNaturalWidths?: (widths: Map<string, number>) => void;
+    handleApplyFilter: (filter: FilterCondition) => void;
+    handleClearFilter: (accessor: Accessor) => void;
+    handleSelectAll?: (checked: boolean) => void;
+    /** Live header tree from table state (avoids stale `headers` snapshot in long-lived handlers). */
+    getHeaders: () => HeaderObject[];
+    headerHeight: number;
+    headerRegistry?: Map<string, {
+        setEditing: (editing: boolean) => void;
+    }>;
+    headers: HeaderObject[];
+    hoveredHeaderRef: MutableRefObject<HeaderObject | null>;
+    icons: IconsConfig;
+    lastHeaderIndex: number;
+    mainBodyRef: RefObject<HTMLDivElement>;
+    mainSectionContainerWidth?: number; /** Main section *content* width (sum of all non-pinned column widths). NOT the virtualization viewport. */
+    mainSectionViewportWidth?: number; /** Main section *visible* viewport width (container minus pinned); use for getVisibleCells when !pinned */
+    /** When false, skip column virtualization and render every header cell in the main section. Default true. */
+    enableVirtualization?: boolean;
+    onColumnOrderChange?: (headers: HeaderObject[]) => void;
+    onColumnSelect?: (header: HeaderObject) => void;
+    onColumnWidthChange?: (headers: HeaderObject[]) => void;
+    onHeaderEdit?: (header: HeaderObject, newLabel: string) => void;
+    onSort: (accessor: Accessor) => void;
+    onTableHeaderDragEnd: (headers: HeaderObject[]) => void;
+    pinned?: "left" | "right";
+    /** Mirrors body context: pinned strip width for cache invalidation when only section width changes. */
+    pinnedSectionWidthPx?: number;
+    pinnedLeftRef: RefObject<HTMLDivElement>;
+    pinnedRightRef: RefObject<HTMLDivElement>;
+    reverse: boolean;
+    rows: Row[];
+    selectColumns?: (columnIndices: number[]) => void;
+    selectableColumns?: boolean;
+    selectedColumns: Set<number>;
+    selectedRowCount?: number; /** Used for context cache invalidation when row selection changes */
+    setCollapsedHeaders: Dispatch<SetStateAction<Set<Accessor>>>;
+    setHeaders: Dispatch<SetStateAction<HeaderObject[]>>;
+    setInitialFocusedCell: (cell: any) => void;
+    setIsResizing: Dispatch<SetStateAction<boolean>>;
+    setSelectedCells: Dispatch<SetStateAction<Set<string>>>;
+    setSelectedColumns: Dispatch<SetStateAction<Set<number>>>;
+    sort: SortColumn | null;
+    /**
+     * Active accordion animation axis (parallel to {@link CellRenderContext.accordionAxis}).
+     * Used so newly-visible header cells (e.g. children of a just-expanded
+     * collapsible header) start at zero width and CSS-transition to their
+     * final width.
+     */
+    accordionAxis?: AccordionAxis;
+    /**
+     * Animation coordinator (when enabled). The header renderer uses
+     * {@link AnimationCoordinator.hasSnapshotEntry} to detect cells that did
+     * not exist in the pre-render layout — those are the incoming cells
+     * driving the unfold animation.
+     */
+    animationCoordinator?: AnimationCoordinator;
+    /**
+     * Called immediately before a header host (or its label content) is permanently
+     * discarded so adapters can tear down renderer subtrees (e.g. React portals).
+     * Mirrors {@link CellRenderContext.onRendererHostDiscard}.
+     */
+    onRendererHostDiscard?: (host: HTMLElement) => void;
+}
+export {};

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

@@ -1,4 +1,4 @@
-import { AbsoluteCell, HeaderRenderContext } from "./headerCell/types";
-export type { AbsoluteCell, HeaderRenderContext } from "./headerCell/types";
-export { cleanupHeaderCellRendering } from "./headerCell/eventTracking";
-export declare const renderHeaderCells: (container: HTMLElement, absoluteCells: AbsoluteCell[], context: HeaderRenderContext, scrollLeft?: number) => void;
+import { AbsoluteCell, HeaderRenderContext } from "./headerCell/types";
+export type { AbsoluteCell, HeaderRenderContext } from "./headerCell/types";
+export { cleanupHeaderCellRendering } from "./headerCell/eventTracking";
+export declare const renderHeaderCells: (container: HTMLElement, absoluteCells: AbsoluteCell[], context: HeaderRenderContext, scrollLeft?: number) => void;

package/dist/utils/headerLayoutUtils.d.ts

@@ -0,0 +1,9 @@
+import type HeaderObject from "../types/HeaderObject";
+/**
+ * True when a column must not participate in table layout: cells, widths,
+ * positions, colspan, pinned-section math, etc.
+ *
+ * Covers both user-hidden columns (`hide`) and export-only columns
+ * (`excludeFromRender`). Prefer this over checking either flag alone.
+ */
+export declare const isHeaderExcludedFromLayout: (header: Pick<HeaderObject, "hide" | "excludeFromRender">) => boolean;

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

@@ -1,41 +1,41 @@
-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;
+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;