simple-table-core 4.1.5 → 4.1.7

package/dist/core/pipeline/syncPivotPipeline.d.ts

@@ -0,0 +1,41 @@
+import type ColumnDef from "../../types/ColumnDef";
+import type { Accessor } from "../../types/ColumnDef";
+import type { SimpleTableConfig } from "../../types/SimpleTableConfig";
+import type { CustomTheme } from "../../types/CustomTheme";
+import type Row from "../../types/Row";
+import type { PivotManager } from "../../managers/PivotManager";
+import type { FilterManager } from "../../managers/FilterManager";
+import type { SortManager } from "../../managers/SortManager";
+import type { SelectionManager } from "../../managers/SelectionManager";
+import type { DimensionManager } from "../../managers/DimensionManager";
+import type ExpandedDepthsManager from "../../hooks/expandedDepths";
+import type { RenderOrchestrator } from "../rendering/RenderOrchestrator";
+/** Pivot emits a flat matrix, so consumer row grouping is off while pivot is active. */
+export declare const getEffectiveRowGrouping: (pivotActive: boolean | undefined, rowGrouping: Accessor[] | undefined) => Accessor[] | undefined;
+export interface PivotPipelineInput {
+    pivotManager: PivotManager;
+    filterManager: FilterManager | null;
+    sortManager: SortManager | null;
+    selectionManager: SelectionManager | null;
+    dimensionManager: DimensionManager | null;
+    expandedDepthsManager: ExpandedDepthsManager | null;
+    renderOrchestrator: RenderOrchestrator;
+    config: SimpleTableConfig;
+    customTheme: CustomTheme;
+    localRows: Row[];
+    pristineDefaultHeaders: ColumnDef[];
+    headers: ColumnDef[];
+    essentialAccessors: Set<string>;
+    collapsedHeaders: Set<Accessor>;
+    filteredSourceRows?: Row[];
+}
+export interface PivotPipelineResult {
+    headers: ColumnDef[];
+    essentialAccessors: Set<string>;
+    collapsedHeaders: Set<Accessor>;
+}
+/**
+ * Recomputes pivot from filtered source rows and updates sort, selection, and
+ * dimension managers. When pivot is off, sort sees the filtered source rows.
+ */
+export declare const syncPivotPipeline: (input: PivotPipelineInput) => PivotPipelineResult;

package/dist/core/rendering/RenderContext.d.ts

@@ -0,0 +1,125 @@
+import { SimpleTableConfig } from "../../types/SimpleTableConfig";
+import { CustomTheme } from "../../types/CustomTheme";
+import ColumnDef, { Accessor } from "../../types/ColumnDef";
+import type { PivotConfig } from "../../types/PivotTypes";
+import Row from "../../types/Row";
+import RowState from "../../types/RowState";
+import { DimensionManager } from "../../managers/DimensionManager";
+import { ScrollManager } from "../../managers/ScrollManager";
+import type { SectionScrollController } from "../../managers/SectionScrollController";
+import { SortManager } from "../../managers/SortManager";
+import { FilterManager } from "../../managers/FilterManager";
+import { SelectionManager } from "../../managers/SelectionManager";
+import { RowSelectionManager } from "../../managers/RowSelectionManager";
+import type { AnimationCoordinator } from "../../managers/AnimationCoordinator";
+import type { AccordionAxis } from "../../utils/accordionAnimation";
+import type { NestedTableFactory } from "../../utils/nestedGridRowRenderer";
+import { ResolvedIcons } from "../initialization/TableInitializer";
+export interface RenderContext {
+    /**
+     * Active accordion animation axis for this render. Set on row-grouping or
+     * nested-column collapse/expand toggles. Cell renderers use it to initialize
+     * incoming cells at zero size in the named axis so the CSS size transition
+     * can grow them while sibling cells FLIP into place.
+     */
+    accordionAxis?: AccordionAxis;
+    animationCoordinator?: AnimationCoordinator;
+    cellRegistry: Map<string, any>;
+    collapsedHeaders: Set<Accessor>;
+    collapsedRows: Map<string, number>;
+    config: SimpleTableConfig;
+    customTheme: CustomTheme;
+    dimensionManager: DimensionManager | null;
+    draggedHeaderRef: {
+        current: ColumnDef | null;
+    };
+    effectiveHeaders: ColumnDef[];
+    essentialAccessors: Set<string>;
+    expandedDepths: Set<number>;
+    expandedRows: Map<string, number>;
+    filterManager: FilterManager | null;
+    getCollapsedRows: () => Map<string, number>;
+    getCollapsedHeaders?: () => Set<Accessor>;
+    getExpandedRows: () => Map<string, number>;
+    getHeaders: () => ColumnDef[];
+    /** Last ingested column definitions — the reset target for the column editor's reset button. */
+    getPristineDefaultHeaders: () => ColumnDef[];
+    getPivot: () => PivotConfig | null;
+    setPivot: (pivot: PivotConfig | null) => void;
+    getRowStateMap: () => Map<string | number, RowState>;
+    headerRegistry: Map<string, any>;
+    headers: ColumnDef[];
+    /**
+     * Unique id for this table instance. Scopes row-hover cell tracking so
+     * multiple tables on one page with overlapping rowIds don't cross-hover.
+     */
+    hoverScopeId: string;
+    hoveredHeaderRef: {
+        current: ColumnDef | null;
+    };
+    internalIsLoading: boolean;
+    isResizing: boolean;
+    localRows: Row[];
+    /** Injected factory for nested grid tables (breaks the SimpleTableVanilla import cycle). */
+    createNestedTable?: NestedTableFactory;
+    mainBodyRef: {
+        current: HTMLDivElement | null;
+    };
+    mainHeaderRef: {
+        current: HTMLDivElement | null;
+    };
+    onRender: () => void;
+    /** 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;
+    pinnedLeftHeaderRef: {
+        current: HTMLDivElement | null;
+    };
+    pinnedLeftRef: {
+        current: HTMLDivElement | null;
+    };
+    pinnedRightHeaderRef: {
+        current: HTMLDivElement | null;
+    };
+    pinnedRightRef: {
+        current: HTMLDivElement | null;
+    };
+    resolvedIcons: ResolvedIcons;
+    rowSelectionManager: RowSelectionManager | null;
+    rowStateMap: Map<string | number, RowState>;
+    scrollManager: ScrollManager | null;
+    sectionScrollController: SectionScrollController | null;
+    selectionManager: SelectionManager | null;
+    setCollapsedHeaders: (headers: Set<Accessor>) => void;
+    setCollapsedRows: (rows: Map<string, number>) => void;
+    setColumnEditorOpen: (open: boolean) => void;
+    setCurrentPage: (page: number) => void;
+    setExpandedRows: (rows: Map<string, number>) => void;
+    setHeaders: (headers: ColumnDef[]) => void;
+    setIsResizing: (value: boolean) => void;
+    setRowStateMap: (map: Map<string | number, any>) => void;
+    sortManager: SortManager | null;
+    /** When true, body cells that stay visible get only position updates (no content/selection recalc). Used during vertical scroll for performance. */
+    positionOnlyBody?: boolean;
+    /**
+     * Mid column-header drag. Row model is unchanged — reuse last flatten/process
+     * results and only repaint header/body lefts.
+     */
+    columnDragging?: boolean;
+    /**
+     * Visible portion of the table inside an external scroll parent (in pixels).
+     * Set per render when `config.scrollParent` is active and no explicit
+     * `height`/`maxHeight` is set. Drives virtualization the same way an
+     * explicit `height` does, but the scroll source is external.
+     */
+    externalViewportHeight?: number;
+}
+export interface RenderState {
+    currentPage: number;
+    scrollTop: number;
+    scrollDirection: "up" | "down" | "none";
+    scrollbarWidth: number;
+    isMainSectionScrollable: boolean;
+    columnEditorOpen: boolean;
+}

package/dist/core/rendering/RenderOrchestrator.d.ts

@@ -1,123 +1,13 @@
 import { SimpleTableConfig } from "../../types/SimpleTableConfig";
 import { CustomTheme } from "../../types/CustomTheme";
-import ColumnDef, { Accessor } from "../../types/ColumnDef";
-import Row from "../../types/Row";
-import RowState from "../../types/RowState";
-import { DimensionManager } from "../../managers/DimensionManager";
-import { ScrollManager } from "../../managers/ScrollManager";
-import type { SectionScrollController } from "../../managers/SectionScrollController";
-import { SortManager } from "../../managers/SortManager";
-import { FilterManager } from "../../managers/FilterManager";
-import { SelectionManager } from "../../managers/SelectionManager";
-import { RowSelectionManager } from "../../managers/RowSelectionManager";
-import type { AnimationCoordinator, CellPosition } from "../../managers/AnimationCoordinator";
-import type { AccordionAxis } from "../../utils/accordionAnimation";
-import type { NestedTableFactory } from "../../utils/nestedGridRowRenderer";
+import ColumnDef from "../../types/ColumnDef";
+import type { CellPosition } from "../../managers/AnimationCoordinator";
+import type { HeaderScrollLiveSelection } from "./SectionRenderer";
+import { MergedColumnEditorConfig } from "../initialization/TableInitializer";
 import { FlattenRowsResult } from "../../utils/rowFlattening";
 import { ProcessRowsResult } from "../../utils/rowProcessing";
-import { MergedColumnEditorConfig, ResolvedIcons } from "../initialization/TableInitializer";
-export interface RenderContext {
-    /**
-     * Active accordion animation axis for this render. Set on row-grouping or
-     * nested-column collapse/expand toggles (see
-     * {@link SimpleTableVanilla.beginAccordionAnimation}). Cell renderers use it
-     * to initialize incoming cells at zero size in the named axis so the CSS
-     * size transition can grow them while sibling cells FLIP into place.
-     */
-    accordionAxis?: AccordionAxis;
-    animationCoordinator?: AnimationCoordinator;
-    cellRegistry: Map<string, any>;
-    collapsedHeaders: Set<Accessor>;
-    collapsedRows: Map<string, number>;
-    config: SimpleTableConfig;
-    customTheme: CustomTheme;
-    dimensionManager: DimensionManager | null;
-    draggedHeaderRef: {
-        current: ColumnDef | null;
-    };
-    effectiveHeaders: ColumnDef[];
-    essentialAccessors: Set<string>;
-    expandedDepths: Set<number>;
-    expandedRows: Map<string, number>;
-    filterManager: FilterManager | null;
-    getCollapsedRows: () => Map<string, number>;
-    getCollapsedHeaders?: () => Set<Accessor>;
-    getExpandedRows: () => Map<string, number>;
-    getHeaders: () => ColumnDef[];
-    /** Pristine snapshot of the configured column definitions — the reset target for the column editor's reset button. */
-    getPristineDefaultHeaders: () => ColumnDef[];
-    getRowStateMap: () => Map<string | number, RowState>;
-    headerRegistry: Map<string, any>;
-    headers: ColumnDef[];
-    /**
-     * Unique id for this table instance. Scopes row-hover cell tracking so
-     * multiple tables on one page with overlapping rowIds don't cross-hover.
-     */
-    hoverScopeId: string;
-    hoveredHeaderRef: {
-        current: ColumnDef | null;
-    };
-    internalIsLoading: boolean;
-    isResizing: boolean;
-    localRows: Row[];
-    /** Injected factory for nested grid tables (breaks the SimpleTableVanilla import cycle). */
-    createNestedTable?: NestedTableFactory;
-    mainBodyRef: {
-        current: HTMLDivElement | null;
-    };
-    mainHeaderRef: {
-        current: HTMLDivElement | null;
-    };
-    onRender: () => void;
-    /** 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;
-    pinnedLeftHeaderRef: {
-        current: HTMLDivElement | null;
-    };
-    pinnedLeftRef: {
-        current: HTMLDivElement | null;
-    };
-    pinnedRightHeaderRef: {
-        current: HTMLDivElement | null;
-    };
-    pinnedRightRef: {
-        current: HTMLDivElement | null;
-    };
-    resolvedIcons: ResolvedIcons;
-    rowSelectionManager: RowSelectionManager | null;
-    rowStateMap: Map<string | number, RowState>;
-    scrollManager: ScrollManager | null;
-    sectionScrollController: SectionScrollController | null;
-    selectionManager: SelectionManager | null;
-    setCollapsedHeaders: (headers: Set<Accessor>) => void;
-    setCollapsedRows: (rows: Map<string, number>) => void;
-    setColumnEditorOpen: (open: boolean) => void;
-    setCurrentPage: (page: number) => void;
-    setExpandedRows: (rows: Map<string, number>) => void;
-    setHeaders: (headers: ColumnDef[]) => void;
-    setIsResizing: (value: boolean) => void;
-    setRowStateMap: (map: Map<string | number, any>) => void;
-    sortManager: SortManager | null;
-    /** When true, body cells that stay visible get only position updates (no content/selection recalc). Used during vertical scroll for performance. */
-    positionOnlyBody?: boolean;
-    /**
-     * Visible portion of the table inside an external scroll parent (in pixels).
-     * Set by {@link SimpleTableVanilla} per render when `config.scrollParent` is
-     * active and no explicit `height`/`maxHeight` is set. Drives virtualization
-     * the same way an explicit `height` does, but the scroll source is external.
-     */
-    externalViewportHeight?: number;
-}
-export interface RenderState {
-    currentPage: number;
-    scrollTop: number;
-    scrollDirection: "up" | "down" | "none";
-    scrollbarWidth: number;
-    isMainSectionScrollable: boolean;
-    columnEditorOpen: boolean;
-}
+import type { RenderContext, RenderState } from "./RenderContext";
+export type { RenderContext, RenderState } from "./RenderContext";
 export declare class RenderOrchestrator {
     private tableRenderer;
     private lastHeadersRef;
@@ -136,6 +26,8 @@ export declare class RenderOrchestrator {
     getLastProcessedResult(): ProcessRowsResult | null;
     /** See {@link TableRenderer.getCurrentBodyLayouts}. */
     getCurrentBodyLayouts(): Map<HTMLElement, Map<string, CellPosition>>;
+    /** Re-virtualize main header and body cells for a new horizontal scroll position. */
+    virtualizeMainColumnsForScroll(scrollLeft: number, liveSelection?: HeaderScrollLiveSelection): void;
     setOnRendererHostDiscard(cb: ((host: HTMLElement) => void) | undefined): void;
     invalidateCache(type?: "body" | "header" | "context" | "all"): void;
     /** @see TableRenderer.invalidateCustomFooterCache */

package/dist/core/rendering/SectionRenderer.d.ts

@@ -1,8 +1,13 @@
-import ColumnDef, { Accessor } from "../../types/ColumnDef";
 import { HeaderRenderContext } from "../../utils/headerCellRenderer";
 import { CellRenderContext } from "../../utils/bodyCellRenderer";
 import TableRow from "../../types/TableRow";
+import ColumnDef, { Accessor } from "../../types/ColumnDef";
 import type { AnimationCoordinator, CellPosition } from "../../managers/AnimationCoordinator";
+/** Live selection sets merged into the last header paint during horizontal scroll. */
+export interface HeaderScrollLiveSelection {
+    columnsWithSelectedCells: Set<number>;
+    selectedColumns: Set<number>;
+}
 export interface HeaderSectionParams {
     headers: ColumnDef[];
     collapsedHeaders: Set<Accessor>;
@@ -51,26 +56,27 @@ export declare class SectionRenderer {
      * renderer subtrees (React portals, etc.) before the nodes are discarded.
      */
     private onRendererHostDiscard?;
-    private bodyCellsCache;
-    private headerCellsCache;
-    private contextCache;
+    private caches;
     private bodySectionSnapshots;
     private nextColIndexMap;
     private stateRowsMap;
     private nestedGridRowsMap;
+    private mainHeaderScrollPaint;
+    private mainBodyScrollPaint;
     renderHeaderSection(params: HeaderSectionParams): HTMLElement;
     renderBodySection(params: BodySectionParams): HTMLElement;
-    private renderNestedGridRows;
-    private renderStateRows;
-    private calculateAbsoluteHeaderCells;
-    private calculateAbsoluteBodyCells;
-    private getLeafHeaders;
-    private createHeadersHash;
-    private createHeightOffsetsHash;
-    private createContextHash;
-    private getCachedBodyCells;
-    private getCachedHeaderCells;
-    private getCachedContext;
+    /**
+     * Re-virtualize main header cells for a new horizontal scroll position.
+     * No-op until the main header has painted. When `liveSelection` is passed,
+     * header selected classes use those sets instead of the last painted context.
+     */
+    virtualizeMainHeaderForScroll(scrollLeft: number, liveSelection?: HeaderScrollLiveSelection): void;
+    /**
+     * Re-virtualize main body cells for a new horizontal scroll position.
+     * Updates cell positions only (no content/selection refresh). No-op until
+     * the main body has painted.
+     */
+    virtualizeMainBodyForScroll(scrollLeft: number): void;
     setOnRendererHostDiscard(cb: ((host: HTMLElement) => void) | undefined): void;
     invalidateCache(type?: "body" | "header" | "context" | "all"): void;
     /**

package/dist/core/rendering/TableRenderer.d.ts

@@ -1,98 +1,7 @@
-import ColumnDef, { Accessor } from "../../types/ColumnDef";
-import { SimpleTableConfig } from "../../types/SimpleTableConfig";
-import { CustomTheme } from "../../types/CustomTheme";
-import { DimensionManager } from "../../managers/DimensionManager";
-import type { SectionScrollController } from "../../managers/SectionScrollController";
-import { SortManager } from "../../managers/SortManager";
-import { FilterManager } from "../../managers/FilterManager";
-import { SelectionManager } from "../../managers/SelectionManager";
-import { RowSelectionManager } from "../../managers/RowSelectionManager";
-import type { AnimationCoordinator, CellPosition } from "../../managers/AnimationCoordinator";
-import type { AccordionAxis } from "../../utils/accordionAnimation";
-import type { NestedTableFactory } from "../../utils/nestedGridRowRenderer";
-export interface TableRendererDeps {
-    /** Accordion animation axis for the in-flight collapse/expand. See {@link RenderContext.accordionAxis}. */
-    accordionAxis?: AccordionAxis;
-    animationCoordinator?: AnimationCoordinator;
-    /**
-     * True when the table is using an external `scrollParent` (no `height`/`maxHeight`).
-     * In this mode the main body container does not scroll — the parent does — so
-     * the sticky-parents container reads its scrollTop from `stickyParentsScrollTop`
-     * (sourced from the table's external-aware state) instead of `mainBodyRef.scrollTop`.
-     */
-    externalScrollActive?: boolean;
-    /** Externally-tracked scrollTop (already translated into table coordinates). */
-    stickyParentsScrollTop?: number;
-    cellRegistry: Map<string, any>;
-    collapsedHeaders: Set<Accessor>;
-    collapsedRows: Map<string, number>;
-    config: SimpleTableConfig;
-    customTheme: CustomTheme;
-    dimensionManager: DimensionManager | null;
-    draggedHeaderRef: {
-        current: ColumnDef | null;
-    };
-    effectiveHeaders: ColumnDef[];
-    essentialAccessors: Set<string>;
-    expandedDepths: Set<number>;
-    expandedRows: Map<string, number>;
-    filterManager: FilterManager | null;
-    getCollapsedHeaders?: () => Set<Accessor>;
-    getCollapsedRows: () => Map<string, number>;
-    getExpandedRows: () => Map<string, number>;
-    getHeaders: () => ColumnDef[];
-    /** Pristine snapshot of the configured column definitions — the reset target for the column editor's reset button. */
-    getPristineDefaultHeaders: () => ColumnDef[];
-    getRowStateMap: () => Map<string | number, any>;
-    headerRegistry: Map<string, any>;
-    headers: ColumnDef[];
-    /** Unique id for this table instance — scopes row-hover cell tracking. */
-    hoverScopeId: string;
-    hoveredHeaderRef: {
-        current: ColumnDef | null;
-    };
-    internalIsLoading: boolean;
-    isResizing: boolean;
-    localRows: any[];
-    mainBodyRef: {
-        current: HTMLDivElement | null;
-    };
-    mainHeaderRef: {
-        current: HTMLDivElement | null;
-    };
-    onRender: () => void;
-    /** 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;
-    pinnedLeftHeaderRef: {
-        current: HTMLDivElement | null;
-    };
-    pinnedLeftRef: {
-        current: HTMLDivElement | null;
-    };
-    pinnedRightHeaderRef: {
-        current: HTMLDivElement | null;
-    };
-    pinnedRightRef: {
-        current: HTMLDivElement | null;
-    };
-    positionOnlyBody?: boolean; /** When true, scroll path updates cell geometry only (no full content/selection refresh); row separators still sync. */
-    resolvedIcons: any;
-    rowSelectionManager: RowSelectionManager | null;
-    rowStateMap: Map<string | number, any>;
-    sectionScrollController: SectionScrollController | null;
-    selectionManager: SelectionManager | null;
-    setCollapsedHeaders: (headers: Set<Accessor>) => void;
-    setCollapsedRows: (rows: Map<string, number>) => void;
-    setExpandedRows: (rows: Map<string, number>) => void;
-    setHeaders: (headers: ColumnDef[]) => void;
-    setIsResizing: (value: boolean) => void;
-    setRowStateMap: (map: Map<string | number, any>) => void;
-    sortManager: SortManager | null;
-    /** Injected factory for nested grid tables (breaks the SimpleTableVanilla import cycle). */
-    createNestedTable?: NestedTableFactory;
-}
+import { type HeaderScrollLiveSelection } from "./SectionRenderer";
+import type { CellPosition } from "../../managers/AnimationCoordinator";
+import type { TableRendererDeps } from "./TableRendererDeps";
+export type { TableRendererDeps } from "./TableRendererDeps";
 export declare class TableRenderer {
     private sectionRenderer;
     private footerInstance;
@@ -117,6 +26,8 @@ export declare class TableRenderer {
     invalidateCustomFooterCache(): void;
     /** See {@link SectionRenderer.getCurrentBodyLayouts}. */
     getCurrentBodyLayouts(): Map<HTMLElement, Map<string, CellPosition>>;
+    /** Re-virtualize main header and body cells for a new horizontal scroll position. */
+    virtualizeMainColumnsForScroll(scrollLeft: number, liveSelection?: HeaderScrollLiveSelection): void;
     renderHeader(container: HTMLElement, calculatedHeaderHeight: number, maxHeaderDepth: number, deps: TableRendererDeps): void;
     renderBody(container: HTMLElement, processedResult: any, deps: TableRendererDeps): void;
     renderFooter(container: HTMLElement, totalRows: number, currentPage: number, onPageChange: (page: number) => void, deps: TableRendererDeps): void;

package/dist/core/rendering/TableRendererDeps.d.ts

@@ -0,0 +1,98 @@
+import ColumnDef, { Accessor } from "../../types/ColumnDef";
+import type { PivotConfig } from "../../types/PivotTypes";
+import { SimpleTableConfig } from "../../types/SimpleTableConfig";
+import { CustomTheme } from "../../types/CustomTheme";
+import { DimensionManager } from "../../managers/DimensionManager";
+import type { SectionScrollController } from "../../managers/SectionScrollController";
+import { SortManager } from "../../managers/SortManager";
+import { FilterManager } from "../../managers/FilterManager";
+import { SelectionManager } from "../../managers/SelectionManager";
+import { RowSelectionManager } from "../../managers/RowSelectionManager";
+import type { AnimationCoordinator } from "../../managers/AnimationCoordinator";
+import type { AccordionAxis } from "../../utils/accordionAnimation";
+import type { NestedTableFactory } from "../../utils/nestedGridRowRenderer";
+export interface TableRendererDeps {
+    /** Accordion animation axis for the in-flight collapse/expand. See {@link RenderContext.accordionAxis}. */
+    accordionAxis?: AccordionAxis;
+    animationCoordinator?: AnimationCoordinator;
+    /**
+     * True when the table is using an external `scrollParent` (no `height`/`maxHeight`).
+     * In this mode the main body container does not scroll — the parent does — so
+     * the sticky-parents container reads its scrollTop from `stickyParentsScrollTop`
+     * (sourced from the table's external-aware state) instead of `mainBodyRef.scrollTop`.
+     */
+    externalScrollActive?: boolean;
+    /** Externally-tracked scrollTop (already translated into table coordinates). */
+    stickyParentsScrollTop?: number;
+    cellRegistry: Map<string, any>;
+    collapsedHeaders: Set<Accessor>;
+    collapsedRows: Map<string, number>;
+    config: SimpleTableConfig;
+    customTheme: CustomTheme;
+    dimensionManager: DimensionManager | null;
+    draggedHeaderRef: {
+        current: ColumnDef | null;
+    };
+    effectiveHeaders: ColumnDef[];
+    essentialAccessors: Set<string>;
+    expandedDepths: Set<number>;
+    expandedRows: Map<string, number>;
+    filterManager: FilterManager | null;
+    getCollapsedHeaders?: () => Set<Accessor>;
+    getCollapsedRows: () => Map<string, number>;
+    getExpandedRows: () => Map<string, number>;
+    getHeaders: () => ColumnDef[];
+    /** Last ingested column definitions — the reset target for the column editor's reset button. */
+    getPristineDefaultHeaders: () => ColumnDef[];
+    getPivot: () => PivotConfig | null;
+    setPivot: (pivot: PivotConfig | null) => void;
+    getRowStateMap: () => Map<string | number, any>;
+    headerRegistry: Map<string, any>;
+    headers: ColumnDef[];
+    /** Unique id for this table instance — scopes row-hover cell tracking. */
+    hoverScopeId: string;
+    hoveredHeaderRef: {
+        current: ColumnDef | null;
+    };
+    internalIsLoading: boolean;
+    isResizing: boolean;
+    localRows: any[];
+    mainBodyRef: {
+        current: HTMLDivElement | null;
+    };
+    mainHeaderRef: {
+        current: HTMLDivElement | null;
+    };
+    onRender: () => void;
+    /** 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;
+    pinnedLeftHeaderRef: {
+        current: HTMLDivElement | null;
+    };
+    pinnedLeftRef: {
+        current: HTMLDivElement | null;
+    };
+    pinnedRightHeaderRef: {
+        current: HTMLDivElement | null;
+    };
+    pinnedRightRef: {
+        current: HTMLDivElement | null;
+    };
+    positionOnlyBody?: boolean; /** When true, scroll path updates cell geometry only (no full content/selection refresh); row separators still sync. */
+    resolvedIcons: any;
+    rowSelectionManager: RowSelectionManager | null;
+    rowStateMap: Map<string | number, any>;
+    sectionScrollController: SectionScrollController | null;
+    selectionManager: SelectionManager | null;
+    setCollapsedHeaders: (headers: Set<Accessor>) => void;
+    setCollapsedRows: (rows: Map<string, number>) => void;
+    setExpandedRows: (rows: Map<string, number>) => void;
+    setHeaders: (headers: ColumnDef[]) => void;
+    setIsResizing: (value: boolean) => void;
+    setRowStateMap: (map: Map<string | number, any>) => void;
+    sortManager: SortManager | null;
+    /** Injected factory for nested grid tables (breaks the SimpleTableVanilla import cycle). */
+    createNestedTable?: NestedTableFactory;
+}

package/dist/core/rendering/buildRenderContext.d.ts

@@ -0,0 +1,94 @@
+import type ColumnDef from "../../types/ColumnDef";
+import type { Accessor } from "../../types/ColumnDef";
+import type { SimpleTableConfig } from "../../types/SimpleTableConfig";
+import type { CustomTheme } from "../../types/CustomTheme";
+import type Row from "../../types/Row";
+import type RowState from "../../types/RowState";
+import type { PivotConfig } from "../../types/PivotTypes";
+import type { AnimationCoordinator } from "../../managers/AnimationCoordinator";
+import type { DimensionManager } from "../../managers/DimensionManager";
+import type { ScrollManager } from "../../managers/ScrollManager";
+import type { SectionScrollController } from "../../managers/SectionScrollController";
+import type { SortManager } from "../../managers/SortManager";
+import type { FilterManager } from "../../managers/FilterManager";
+import type { SelectionManager } from "../../managers/SelectionManager";
+import type { RowSelectionManager } from "../../managers/RowSelectionManager";
+import type { AccordionAxis } from "../../utils/accordionAnimation";
+import type { NestedTableFactory } from "../../utils/nestedGridRowRenderer";
+import type { ResolvedIcons } from "../initialization/TableInitializer";
+import type { RenderContext } from "./RenderContext";
+export interface RenderContextSource {
+    accordionAxis: AccordionAxis;
+    animationCoordinator: AnimationCoordinator;
+    cellRegistry: Map<string, any>;
+    collapsedHeaders: Set<Accessor>;
+    collapsedRows: Map<string, number>;
+    config: SimpleTableConfig;
+    customTheme: CustomTheme;
+    dimensionManager: DimensionManager | null;
+    draggedHeaderRef: {
+        current: ColumnDef | null;
+    };
+    essentialAccessors: Set<string>;
+    expandedDepths: Set<number>;
+    expandedRows: Map<string, number>;
+    filterManager: FilterManager | null;
+    headerRegistry: Map<string, any>;
+    headers: ColumnDef[];
+    hoverScopeId: string;
+    hoveredHeaderRef: {
+        current: ColumnDef | null;
+    };
+    internalIsLoading: boolean;
+    isResizing: boolean;
+    localRows: Row[];
+    createNestedTable: NestedTableFactory;
+    mainBodyRef: {
+        current: HTMLDivElement | null;
+    };
+    mainHeaderRef: {
+        current: HTMLDivElement | null;
+    };
+    pinnedLeftHeaderRef: {
+        current: HTMLDivElement | null;
+    };
+    pinnedLeftRef: {
+        current: HTMLDivElement | null;
+    };
+    pinnedRightHeaderRef: {
+        current: HTMLDivElement | null;
+    };
+    pinnedRightRef: {
+        current: HTMLDivElement | null;
+    };
+    positionOnlyBody?: boolean;
+    columnDragging?: boolean;
+    externalViewportHeight?: number;
+    resolvedIcons: ResolvedIcons;
+    rowSelectionManager: RowSelectionManager | null;
+    rowStateMap: Map<string | number, RowState>;
+    scrollManager: ScrollManager | null;
+    sectionScrollController: SectionScrollController | null;
+    selectionManager: SelectionManager | null;
+    sortManager: SortManager | null;
+    onRender: () => void;
+    getShrinkFloors: () => Map<string, number>;
+    onAutoExpandNaturalWidths: (widths: Map<string, number>) => void;
+    setIsResizing: (value: boolean) => void;
+    setHeaders: (headers: ColumnDef[]) => void;
+    setCollapsedHeaders: (headers: Set<Accessor>) => void;
+    setCollapsedRows: (rowsOrUpdater: Map<string, number> | ((prev: Map<string, number>) => Map<string, number>)) => void;
+    setExpandedRows: (rowsOrUpdater: Map<string, number> | ((prev: Map<string, number>) => Map<string, number>)) => void;
+    setRowStateMap: (mapOrUpdater: Map<string | number, any> | ((prev: Map<string | number, any>) => Map<string | number, any>)) => void;
+    getCollapsedRows: () => Map<string, number>;
+    getCollapsedHeaders: () => Set<Accessor>;
+    getExpandedRows: () => Map<string, number>;
+    getHeaders: () => ColumnDef[];
+    getPristineDefaultHeaders: () => ColumnDef[];
+    getPivot: () => PivotConfig | null;
+    setPivot: (pivot: PivotConfig | null) => void;
+    getRowStateMap: () => Map<string | number, RowState>;
+    setColumnEditorOpen: (open: boolean) => void;
+    setCurrentPage: (page: number) => void;
+}
+export declare const buildRenderContext: (source: RenderContextSource) => RenderContext;