@simple-table/react 3.0.0-beta.9 → 3.0.2

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

@@ -8,7 +8,6 @@ export interface CreateColumnEditorPopoutOptions {
     searchPlaceholder: string;
     searchFunction?: ColumnEditorSearchFunction;
     columnEditorConfig: ColumnEditorConfig;
-    contextHeaders: HeaderObject[];
     essentialAccessors?: ReadonlySet<string>;
     setHeaders: (headers: HeaderObject[]) => void;
     onColumnVisibilityChange?: (state: ColumnVisibilityState) => void;

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

@@ -27,5 +27,12 @@ export interface CreateColumnEditorRowOptions {
     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 declare const createColumnEditorRow: (options: CreateColumnEditorRowOptions) => DocumentFragment;
+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/types/core/src/utils/filters/createDropdown.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Filter / filter-UI dropdown positioning (React-era parity):
+ * - Fixed: portaled under `.simple-table-root`, anchored to `anchorElement` (e.g. filter icon) so
+ *   `overflow: hidden` on `.st-header-cell` does not clip the panel. Same top/left +4px and
+ *   container-based flip as legacy React Dropdown.tsx.
+ * - Absolute: stays under caller’s parent (e.g. `.st-custom-select`); use `anchorElement` for the
+ *   trigger rect vs `position: relative` parent (React CustomSelect pattern).
+ */
+export interface CreateDropdownOptions {
+    children: HTMLElement;
+    containerRef?: HTMLElement;
+    mainBodyRef?: HTMLElement;
+    /** Rect used for placement. Required for fixed portaling (e.g. filter icon); for absolute, pass the real trigger (button/input) when it differs from the dropdown parent. */
+    anchorElement?: HTMLElement;
+    onClose: () => void;
+    open: boolean;
+    overflow?: "auto" | "visible" | "hidden";
+    width?: number;
+    maxWidth?: number;
+    positioning?: "fixed" | "absolute";
+    /**
+     * When true, this panel does not clip overflowing descendants (e.g. nested operator menus inside
+     * the filter popover). Uses overflow: visible and drops max-height on the shell — see
+     * `.st-dropdown-content--allow-descendant-overflow` in base.css.
+     */
+    allowDescendantOverflow?: boolean;
+}
+export declare const createDropdown: (options: CreateDropdownOptions) => {
+    element: HTMLDivElement;
+    update: (newOptions: Partial<CreateDropdownOptions>) => void;
+    destroy: () => void;
+    setOpen: (newOpen: boolean) => void;
+};

package/dist/{cjs → types}/core/src/utils/filters/createFilterActions.d.ts

@@ -4,6 +4,7 @@ export interface CreateFilterActionsOptions {
     canApply: boolean;
     showClear: boolean;
 }
+/** Matches React FilterActions: `st-filter-button-apply`, `st-filter-button-clear`, `st-filter-button-disabled`. */
 export declare const createFilterActions: (options: CreateFilterActionsOptions) => {
     element: HTMLDivElement;
     update: (newOptions: Partial<CreateFilterActionsOptions>) => void;

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

@@ -2,5 +2,5 @@ import HeaderObject from "../../types/HeaderObject";
 import { HeaderRenderContext } from "./types";
 /** Use same icon and animation as body row expand/collapse (icons.expand + st-expand-icon-container). */
 export declare const createCollapseIcon: (header: HeaderObject, context: HeaderRenderContext) => HTMLElement | null;
-/** Update header collapse icon direction on an existing cell (same pattern as body updateExpandIconState). */
+/** Update header collapse icon direction on an existing cell (delegates to body updateExpandIconState). */
 export declare const updateHeaderCollapseIconState: (cellElement: HTMLElement, isCollapsed: boolean, label?: string) => void;

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

@@ -22,4 +22,7 @@ export declare const getHeaderPositionCache: (container: HTMLElement) => Map<str
 export declare const REVERT_TO_PREVIOUS_HEADERS_DELAY = 1500;
 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) => void;

package/dist/{core → types/core}/src/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, isLastHeader: boolean) => HTMLElement | null;
+export declare const createResizeHandle: (header: HeaderObject, context: HeaderRenderContext, isLastMainAutoExpandColumn: boolean) => HTMLElement | null;

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

@@ -1,5 +1,5 @@
 import { AbsoluteCell, HeaderRenderContext } from "./types";
-export declare const calculateHeaderCellClasses: (cell: AbsoluteCell, context: HeaderRenderContext, isLastHeader: boolean) => string;
-export declare const createHeaderCellElement: (cell: AbsoluteCell, context: HeaderRenderContext, isLastHeader: boolean) => HTMLElement;
+export declare const calculateHeaderCellClasses: (cell: AbsoluteCell, context: HeaderRenderContext, isLastMainAutoExpandColumn: boolean) => string;
+export declare const createHeaderCellElement: (cell: AbsoluteCell, context: HeaderRenderContext, isLastMainAutoExpandColumn: boolean) => HTMLElement;
 export declare const getLastHeaderIndex: (absoluteCells: AbsoluteCell[]) => number;
-export declare const updateHeaderCellElement: (cellElement: HTMLElement, cell: AbsoluteCell, context: HeaderRenderContext, isLastHeader: boolean) => void;
+export declare const updateHeaderCellElement: (cellElement: HTMLElement, cell: AbsoluteCell, context: HeaderRenderContext, isLastMainAutoExpandColumn: boolean) => void;

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

@@ -39,6 +39,8 @@ export interface HeaderRenderContext {
     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;

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

@@ -13,8 +13,8 @@ export declare const DEFAULT_TABLE_WIDTH = 800;
  * Normalize header widths so that fr and % are converted to pixels.
  * Call this as soon as headers are received so the rest of the code can assume numeric widths.
  * If totalWidth is not provided, a reasonable total is computed from fixed widths + default for fr columns.
- * If options.containerWidth is provided, the main section's fr columns are given the remaining space
- * (container width minus pinned left/right), so the flexible column fills available space.
+ * If options.containerWidth is provided, all fr/% columns are resolved against the full container width,
+ * so pinned and non-pinned fr columns share the same proportional pool.
  */
 export declare function normalizeHeaderWidths(headers: HeaderObject[], totalWidthOrOptions?: number | {
     containerWidth: number;
@@ -53,4 +53,6 @@ export declare const calculateHeaderContentWidth: (accessor: Accessor, options?:
     header?: HeaderObject;
     maxWidth?: number;
     sampleSize?: number;
+    /** Scope `.st-cell-content` font/padding sampling to this table instance */
+    styleRoot?: ParentNode | null;
 }) => number;

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

@@ -11,4 +11,9 @@ export interface HorizontalScrollbarProps {
     sectionScrollController?: SectionScrollController | null;
 }
 export declare const createHorizontalScrollbar: (props: HorizontalScrollbarProps) => HTMLElement | null;
+/**
+ * Apply width props to an existing scrollbar from {@link createHorizontalScrollbar}.
+ * Used when layout is recreated without tearing down the DOM node (e.g. pinned resize).
+ */
+export declare const syncHorizontalScrollbarLayout: (container: HTMLElement, props: HorizontalScrollbarProps) => void;
 export declare const cleanupHorizontalScrollbar: (container: HTMLElement, sectionScrollController?: SectionScrollController | null) => void;

package/dist/{cjs → types}/core/src/utils/pinnedColumnUtils.d.ts

@@ -21,5 +21,9 @@ export declare function getPinnedSectionsState(headers: HeaderObject[]): PinnedS
  * 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 (append within target section). */
+/**
+ * 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/types/core/src/utils/resizeUtils/index.d.ts

@@ -0,0 +1,22 @@
+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, reverse, setHeaders, setIsResizing, 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"];
+    reverse: boolean;
+};
+/**
+ * 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, }: ApplyColumnAutoFitWithAutoExpandParams) => void;

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

@@ -7,6 +7,10 @@ export interface CreateRowSeparatorOptions {
     heightOffsets?: HeightOffsets;
     customTheme?: CustomTheme;
     isSticky?: boolean;
+    /** Same px width as the body/sticky section (`SectionRenderer` / sticky pane); omit to use 100%. */
+    sectionWidthPx?: number;
 }
+/** Keep separator width in sync with section layout (resize, pinned width changes). */
+export declare const applyRowSeparatorSectionWidth: (separator: HTMLElement, sectionWidthPx?: number) => void;
 export declare const createRowSeparator: (options: CreateRowSeparatorOptions) => HTMLElement;
 export declare const createSpacerRow: (position: number, rowHeight: number, heightOffsets: HeightOffsets | undefined, customTheme: CustomTheme, className: string, height?: number) => HTMLElement;

package/dist/types/react/src/defaultHeadersFromCore.d.ts

@@ -0,0 +1,12 @@
+import type { HeaderObject } from "simple-table-core";
+import type { ReactHeaderObject } from "./types";
+/** Single column from a core/shared config, typed for React `defaultHeaders`. */
+export declare function defaultHeaderFromCore(header: HeaderObject): ReactHeaderObject;
+/** Column tree from `simple-table-core` or shared configs, typed for React `defaultHeaders`. */
+export declare function defaultHeadersFromCore(headers: readonly HeaderObject[]): ReactHeaderObject[];
+/**
+ * Use after mapping over {@link HeaderObject} and spreading into `{ ...h, cellRenderer }` (or
+ * `headerRenderer`). TypeScript keeps vanilla renderer types on the spread; this asserts the
+ * React-only column shape for `defaultHeaders`.
+ */
+export declare function mapToReactHeaderObjects(columns: readonly object[]): ReactHeaderObject[];

package/dist/types/react/src/index.d.ts

@@ -0,0 +1,5 @@
+export { default as SimpleTable } from "./SimpleTable";
+export { asRows } from "simple-table-core";
+export { defaultHeaderFromCore, defaultHeadersFromCore, mapToReactHeaderObjects, } from "./defaultHeadersFromCore";
+export type { SimpleTableReactProps, TableInstance, ReactHeaderObject, ReactColumnEditorConfig, ReactIconsConfig, ReactIconElement, ReactCellRenderer, ReactHeaderRenderer, ReactFooterRenderer, ReactHeaderDropdown, ReactColumnEditorRowRenderer, ReactColumnEditorCustomRenderer, ReactLoadingStateRenderer, ReactErrorStateRenderer, ReactEmptyStateRenderer, HeaderRendererComponents, HeaderRendererProps, ColumnEditorRowRendererComponents, ColumnEditorRowRendererProps, FooterRendererProps, HeaderDropdownProps, } from "./types";
+export type { Accessor, AggregationConfig, AggregationType, BoundingBox, Cell, CellChangeProps, CellClickProps, CellRenderer, CellRendererProps, CellValue, ChartOptions, ColumnEditorConfig, ColumnEditorRowRenderer, ColumnEditorCustomRenderer, ColumnEditorCustomRendererProps, ColumnEditorSearchFunction, ColumnType, ColumnVisibilityState, Comparator, ComparatorProps, CustomTheme, CustomThemeProps, DragHandlerProps, EmptyStateRenderer, EmptyStateRendererProps, EnumOption, ErrorStateRenderer, ErrorStateRendererProps, ExportToCSVProps, ExportValueGetter, ExportValueProps, FilterCondition, GetRowId, GetRowIdParams, HeaderDropdown, HeaderObject, HeaderRenderer, IconsConfig, LoadingStateRenderer, LoadingStateRendererProps, OnRowGroupExpandProps, OnSortProps, QuickFilterConfig, QuickFilterGetter, QuickFilterGetterProps, QuickFilterMode, Row, RowButtonProps, RowId, RowSelectionChangeProps, RowState, SetHeaderRenameProps, SharedTableProps, ShowWhen, SimpleTableConfig, SimpleTableProps, SortColumn, TableAPI, TableFilterState, TableHeaderProps, TableRowProps, Theme, UpdateDataProps, ValueFormatter, ValueFormatterProps, ValueGetter, ValueGetterProps, } from "simple-table-core";

package/dist/types/react/src/types.d.ts

@@ -0,0 +1,90 @@
+import type React from "react";
+import type { SimpleTableProps, SimpleTableConfig, HeaderObject, TableAPI, Row, CellRendererProps, HeaderRendererProps as VanillaHeaderRendererProps, FooterRendererProps as VanillaFooterRendererProps, LoadingStateRendererProps, ErrorStateRendererProps, EmptyStateRendererProps, HeaderDropdownProps as VanillaHeaderDropdownProps, ColumnEditorRowRendererProps as VanillaColumnEditorRowRendererProps, ColumnEditorCustomRendererProps, ColumnEditorConfig } from "simple-table-core";
+/** Passed to React `headerRenderer` / `headerDropdown`; slots are React nodes. */
+export interface HeaderRendererComponents {
+    sortIcon?: React.ReactNode;
+    filterIcon?: React.ReactNode;
+    collapseIcon?: React.ReactNode;
+    labelContent?: React.ReactNode;
+}
+export type HeaderRendererProps = Omit<VanillaHeaderRendererProps, "components"> & {
+    components?: HeaderRendererComponents;
+};
+/** Column editor row slots as React nodes (core uses `IconElement` / `HTMLElement`). */
+export interface ColumnEditorRowRendererComponents {
+    expandIcon?: React.ReactNode;
+    checkbox?: React.ReactNode;
+    dragIcon?: React.ReactNode;
+    labelContent?: React.ReactNode;
+    pinIcon?: React.ReactNode;
+}
+export type ColumnEditorRowRendererProps = Omit<VanillaColumnEditorRowRendererProps, "components"> & {
+    components: ColumnEditorRowRendererComponents;
+};
+export type FooterRendererProps = Omit<VanillaFooterRendererProps, "nextIcon" | "prevIcon"> & {
+    nextIcon?: React.ReactNode;
+    prevIcon?: React.ReactNode;
+};
+export type HeaderDropdownProps = Omit<VanillaHeaderDropdownProps, "components"> & {
+    components?: HeaderRendererComponents;
+};
+export interface TableInstance {
+    mount(): void;
+    update(config: Partial<SimpleTableConfig>): void;
+    destroy(): void;
+    getAPI(): TableAPI;
+}
+export type ReactIconElement = React.ReactNode;
+export interface ReactIconsConfig {
+    drag?: ReactIconElement;
+    expand?: ReactIconElement;
+    filter?: ReactIconElement;
+    headerCollapse?: ReactIconElement;
+    headerExpand?: ReactIconElement;
+    next?: ReactIconElement;
+    prev?: ReactIconElement;
+    sortDown?: ReactIconElement;
+    sortUp?: ReactIconElement;
+    pinnedLeftIcon?: ReactIconElement;
+    pinnedRightIcon?: ReactIconElement;
+}
+export type ReactCellRenderer = React.ComponentType<CellRendererProps> | ((props: CellRendererProps) => React.ReactNode);
+export type ReactHeaderRenderer = React.ComponentType<HeaderRendererProps> | ((props: HeaderRendererProps) => React.ReactNode);
+export type ReactFooterRenderer = React.ComponentType<FooterRendererProps> | ((props: FooterRendererProps) => React.ReactNode);
+export type ReactHeaderDropdown = React.ComponentType<HeaderDropdownProps> | ((props: HeaderDropdownProps) => React.ReactNode);
+export type ReactColumnEditorRowRenderer = React.ComponentType<ColumnEditorRowRendererProps> | ((props: ColumnEditorRowRendererProps) => React.ReactNode);
+export type ReactColumnEditorCustomRenderer = React.ComponentType<ColumnEditorCustomRendererProps> | ((props: ColumnEditorCustomRendererProps) => React.ReactNode);
+export type ReactLoadingStateRenderer = React.ComponentType<LoadingStateRendererProps> | React.ReactNode;
+export type ReactErrorStateRenderer = React.ComponentType<ErrorStateRendererProps> | React.ReactNode;
+export type ReactEmptyStateRenderer = React.ComponentType<EmptyStateRendererProps> | React.ReactNode;
+export interface ReactColumnEditorConfig extends Omit<ColumnEditorConfig, "rowRenderer" | "customRenderer"> {
+    rowRenderer?: ReactColumnEditorRowRenderer;
+    customRenderer?: ReactColumnEditorCustomRenderer;
+}
+/**
+ * Column definition for `defaultHeaders`: same column metadata as core `HeaderObject`, but
+ * `cellRenderer` / `headerRenderer` / `children` / `nestedTable` are React-only. For column
+ * defs authored against core types, import `defaultHeadersFromCore`, `defaultHeaderFromCore`, or
+ * `mapToReactHeaderObjects` (after spreading core columns and adding React renderers).
+ */
+export interface ReactHeaderObject extends Omit<HeaderObject, "cellRenderer" | "headerRenderer" | "children" | "nestedTable"> {
+    cellRenderer?: ReactCellRenderer;
+    headerRenderer?: ReactHeaderRenderer;
+    children?: ReadonlyArray<ReactHeaderObject>;
+    /** Nested grid: React table props minus row data and inherited state renderers. */
+    nestedTable?: Omit<SimpleTableReactProps, "rows" | "loadingStateRenderer" | "errorStateRenderer" | "emptyStateRenderer" | "tableEmptyStateRenderer">;
+}
+export interface SimpleTableReactProps extends Omit<SimpleTableProps, "defaultHeaders" | "footerRenderer" | "emptyStateRenderer" | "errorStateRenderer" | "loadingStateRenderer" | "tableEmptyStateRenderer" | "headerDropdown" | "columnEditorConfig" | "icons" | "rows"> {
+    defaultHeaders: ReactHeaderObject[];
+    /** Row data: any object rows (domain models) or core `Row[]`; cast to vanilla `Row[]` inside the adapter. */
+    rows: ReadonlyArray<Row> | ReadonlyArray<object>;
+    footerRenderer?: ReactFooterRenderer;
+    loadingStateRenderer?: ReactLoadingStateRenderer;
+    errorStateRenderer?: ReactErrorStateRenderer;
+    emptyStateRenderer?: ReactEmptyStateRenderer;
+    tableEmptyStateRenderer?: React.ReactNode;
+    headerDropdown?: ReactHeaderDropdown;
+    columnEditorConfig?: ReactColumnEditorConfig;
+    icons?: ReactIconsConfig;
+}
+export type { CellRendererProps, LoadingStateRendererProps, ErrorStateRendererProps, EmptyStateRendererProps, ColumnEditorCustomRendererProps, };

package/dist/types/react/src/utils/ImperativeDomSlot.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+import type { ColumnEditorRowRendererComponents as VanillaColumnEditorRowComponents } from "simple-table-core";
+type DomSlotProps = {
+    node: Node;
+};
+/**
+ * Bridges imperative DOM from simple-table-core into a React subtree. Core passes
+ * HTMLElement/SVG nodes as slots; React cannot render those as children directly.
+ * This host uses `display: contents` so flex/grid parents still lay out the slot.
+ */
+export declare function ImperativeDomSlot({ node }: DomSlotProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Converts a core column-editor slot (string markup or a live node) into a ReactNode.
+ */
+export declare function domSlotToReactNode(value: string | Node | null | undefined): React.ReactNode;
+/** Maps core column-editor row slots (live DOM) to React nodes for `rowRenderer` JSX. */
+export declare function mapColumnEditorRowComponentsForReact(components: VanillaColumnEditorRowComponents): {
+    expandIcon?: React.ReactNode;
+    checkbox?: React.ReactNode;
+    dragIcon?: React.ReactNode;
+    labelContent?: React.ReactNode;
+    pinIcon?: React.ReactNode;
+};
+export {};

package/dist/types/react/src/utils/wrapReactRenderer.d.ts

@@ -0,0 +1,41 @@
+import React from "react";
+import type { ColumnEditorCustomRendererProps as VanillaColumnEditorCustomRendererProps, ColumnEditorRowRendererProps as VanillaColumnEditorRowRendererProps } from "simple-table-core";
+/**
+ * Wraps a React component into a function that returns an HTMLElement, matching
+ * the vanilla renderer contract expected by simple-table-core.
+ *
+ * Uses `createRoot` so event handlers work (same idea as Vue/Svelte/Solid adapters).
+ * When core replaces or clears that DOM, the root is detached like other adapters.
+ */
+export declare function wrapReactRenderer<P extends object>(Component: React.ComponentType<P>): (props: P) => HTMLElement;
+/**
+ * Like {@link wrapReactRenderer} for column editor rows: core passes `components.*` as
+ * live DOM nodes; this maps them to React hosts so consumers can use normal JSX.
+ */
+export declare function wrapReactColumnEditorRowRenderer(Component: React.ComponentType<object>): (props: VanillaColumnEditorRowRendererProps) => HTMLElement;
+/**
+ * Maps `searchSection` / `listSection` / `resetSection` HTMLElement slots for
+ * `columnEditorConfig.customRenderer` the same way as row slots.
+ */
+export declare function wrapReactColumnEditorCustomRenderer(Component: React.ComponentType<object>): (props: VanillaColumnEditorCustomRendererProps) => HTMLElement;
+/**
+ * Like wrapReactRenderer but uses `display: contents` so layout is unchanged
+ * when core appends this node (no extra box vs a plain div).
+ * Commit scheduling matches {@link wrapReactRenderer} (microtask + flushSync).
+ */
+export declare function wrapReactRendererIntoFragment<P extends object>(Component: React.ComponentType<P>): (props: P) => HTMLElement;
+/**
+ * Renders a static ReactNode into an HTMLElement.
+ * Used for props like tableEmptyStateRenderer that are not called with arguments.
+ */
+export declare function wrapReactNode(node: React.ReactNode): HTMLElement;
+/**
+ * Converts a ReactNode to an HTML string using server-side static rendering.
+ * Used for icon props where the vanilla table expects a string | HTMLElement | SVGSVGElement.
+ * Uses renderToStaticMarkup so it works synchronously from any context — including
+ * inside a useEffect — unlike createRoot alone without a follow-up commit, which
+ * can yield empty output when React defers the nested root.
+ */
+export declare function reactNodeToHtmlString(node: React.ReactNode): string;
+/** Returns true if the value is a React component (function or class). */
+export declare function isReactComponent(value: unknown): value is React.ComponentType<any>;

package/package.json

@@ -1,17 +1,20 @@
 {
   "name": "@simple-table/react",
-  "version": "3.0.0-beta.9",
-  "type": "module",
+  "version": "3.0.2",
   "main": "dist/cjs/index.js",
   "module": "dist/index.es.js",
-  "types": "dist/index.d.ts",
-  "sideEffects": false,
+  "types": "dist/types/react/src/index.d.ts",
+  "sideEffects": [
+    "*.css",
+    "**/*.css"
+  ],
   "exports": {
     ".": {
       "import": "./dist/index.es.js",
       "require": "./dist/cjs/index.js",
-      "types": "./dist/index.d.ts"
-    }
+      "types": "./dist/types/react/src/index.d.ts"
+    },
+    "./styles.css": "./dist/styles.css"
   },
   "license": "MIT",
   "publishConfig": {
@@ -26,7 +29,7 @@
     "react-dom": ">=18.0.0"
   },
   "dependencies": {
-    "simple-table-core": "3.0.0-beta.9"
+    "simple-table-core": "3.0.2"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "^4.0.4",

package/dist/cjs/core/src/core/initialization/TableInitializer.d.ts

@@ -1,30 +0,0 @@
-import { SimpleTableConfig } from "../../types/SimpleTableConfig";
-import { CustomTheme } from "../../types/CustomTheme";
-import HeaderObject, { Accessor } from "../../types/HeaderObject";
-export interface ResolvedIcons {
-    drag: string | HTMLElement | SVGSVGElement;
-    expand: string | HTMLElement | SVGSVGElement;
-    filter: string | HTMLElement | SVGSVGElement;
-    headerCollapse: string | HTMLElement | SVGSVGElement;
-    headerExpand: string | HTMLElement | SVGSVGElement;
-    next: string | HTMLElement | SVGSVGElement;
-    prev: string | HTMLElement | SVGSVGElement;
-    sortDown: string | HTMLElement | SVGSVGElement;
-    sortUp: string | HTMLElement | SVGSVGElement;
-}
-export interface MergedColumnEditorConfig {
-    text: string;
-    searchEnabled: boolean;
-    searchPlaceholder: string;
-    allowColumnPinning: boolean;
-    searchFunction?: (header: HeaderObject, searchText: string) => boolean;
-    rowRenderer?: any;
-}
-export declare class TableInitializer {
-    static resolveIcons(config: SimpleTableConfig): ResolvedIcons;
-    static mergeCustomTheme(config: SimpleTableConfig): CustomTheme;
-    static mergeColumnEditorConfig(config: SimpleTableConfig): MergedColumnEditorConfig;
-    static buildEssentialAccessors(headers: HeaderObject[]): Set<string>;
-    static getInitialCollapsedHeaders(headers: HeaderObject[]): Set<Accessor>;
-    static getInitialExpandedDepths(config: SimpleTableConfig): Set<number>;
-}

package/dist/cjs/core/src/index.d.ts

@@ -1,48 +0,0 @@
-import { SimpleTableVanilla } from "./core/SimpleTableVanilla";
-import type BoundingBox from "./types/BoundingBox";
-import type Cell from "./types/Cell";
-import type CellChangeProps from "./types/CellChangeProps";
-import type CellValue from "./types/CellValue";
-import type DragHandlerProps from "./types/DragHandlerProps";
-import type EnumOption from "./types/EnumOption";
-import type HeaderObject from "./types/HeaderObject";
-import type { Accessor, ChartOptions, ColumnType, Comparator, ComparatorProps, ExportValueGetter, ExportValueProps, ShowWhen, ValueFormatter, ValueFormatterProps, ValueGetter, ValueGetterProps } from "./types/HeaderObject";
-import type { AggregationConfig, AggregationType } from "./types/AggregationTypes";
-import type OnSortProps from "./types/OnSortProps";
-import type OnRowGroupExpandProps from "./types/OnRowGroupExpandProps";
-import type Row from "./types/Row";
-import type RowState from "./types/RowState";
-import type SharedTableProps from "./types/SharedTableProps";
-import type SortColumn from "./types/SortColumn";
-import type TableHeaderProps from "./types/TableHeaderProps";
-import type { TableAPI, SetHeaderRenameProps, ExportToCSVProps } from "./types/TableAPI";
-import type TableRefType from "./types/TableRefType";
-import type TableRowProps from "./types/TableRowProps";
-import type Theme from "./types/Theme";
-import type UpdateDataProps from "./types/UpdateCellProps";
-import type { FilterCondition, TableFilterState } from "./types/FilterTypes";
-import type { QuickFilterConfig, QuickFilterGetter, QuickFilterGetterProps, QuickFilterMode } from "./types/QuickFilterTypes";
-import type { ColumnVisibilityState } from "./types/ColumnVisibilityTypes";
-import type RowSelectionChangeProps from "./types/RowSelectionChangeProps";
-import type CellClickProps from "./types/CellClickProps";
-import type CellRendererProps from "./types/CellRendererProps";
-import type { CellRenderer } from "./types/CellRendererProps";
-import type HeaderRendererProps from "./types/HeaderRendererProps";
-import type { HeaderRenderer, HeaderRendererComponents } from "./types/HeaderRendererProps";
-import type ColumnEditorRowRendererProps from "./types/ColumnEditorRowRendererProps";
-import type { ColumnEditorRowRenderer, ColumnEditorRowRendererComponents } from "./types/ColumnEditorRowRendererProps";
-import type HeaderDropdownProps from "./types/HeaderDropdownProps";
-import type { HeaderDropdown } from "./types/HeaderDropdownProps";
-import type { RowButtonProps } from "./types/RowButton";
-import type FooterRendererProps from "./types/FooterRendererProps";
-import type { LoadingStateRenderer, ErrorStateRenderer, EmptyStateRenderer, LoadingStateRendererProps, ErrorStateRendererProps, EmptyStateRendererProps } from "./types/RowStateRendererProps";
-import type { CustomTheme, CustomThemeProps } from "./types/CustomTheme";
-import type { ColumnEditorConfig, ColumnEditorSearchFunction } from "./types/ColumnEditorConfig";
-import type { IconsConfig } from "./types/IconsConfig";
-import type { GetRowId, GetRowIdParams } from "./types/GetRowId";
-import type { SimpleTableConfig } from "./types/SimpleTableConfig";
-import type { SimpleTableProps } from "./types/SimpleTableProps";
-import type { RowId } from "./types/RowId";
-import type { PinnedSectionsState } from "./types/PinnedSectionsState";
-export { SimpleTableVanilla };
-export type { Accessor, AggregationConfig, AggregationType, BoundingBox, Cell, CellChangeProps, CellClickProps, CellRenderer, CellRendererProps, CellValue, ChartOptions, ColumnEditorConfig, ColumnEditorRowRenderer, ColumnEditorRowRendererComponents, ColumnEditorRowRendererProps, ColumnEditorSearchFunction, ColumnType, ColumnVisibilityState, Comparator, ComparatorProps, CustomTheme, CustomThemeProps, DragHandlerProps, EmptyStateRenderer, EmptyStateRendererProps, EnumOption, ErrorStateRenderer, ErrorStateRendererProps, ExportToCSVProps, ExportValueGetter, ExportValueProps, FilterCondition, FooterRendererProps, GetRowId, GetRowIdParams, IconsConfig, LoadingStateRenderer, LoadingStateRendererProps, HeaderDropdown, HeaderDropdownProps, HeaderObject, HeaderRenderer, HeaderRendererProps, HeaderRendererComponents, OnRowGroupExpandProps, OnSortProps, QuickFilterConfig, QuickFilterGetter, QuickFilterGetterProps, QuickFilterMode, Row, RowButtonProps, RowId, RowSelectionChangeProps, RowState, SetHeaderRenameProps, SharedTableProps, ShowWhen, SimpleTableConfig, SimpleTableProps, SortColumn, TableAPI, TableFilterState, TableHeaderProps, TableRefType, TableRowProps, Theme, PinnedSectionsState, UpdateDataProps, ValueFormatter, ValueFormatterProps, ValueGetter, ValueGetterProps, };

package/dist/cjs/core/src/managers/DimensionManager.d.ts

@@ -1,42 +0,0 @@
-import HeaderObject from "../types/HeaderObject";
-export interface DimensionManagerConfig {
-    effectiveHeaders: HeaderObject[];
-    headerHeight?: number;
-    rowHeight: number;
-    height?: string | number;
-    maxHeight?: string | number;
-    totalRowCount: number;
-    footerHeight?: number;
-    containerElement?: HTMLElement;
-}
-export interface DimensionManagerState {
-    containerWidth: number;
-    calculatedHeaderHeight: number;
-    maxHeaderDepth: number;
-    contentHeight: number | undefined;
-}
-type StateChangeCallback = (state: DimensionManagerState) => void;
-export declare class DimensionManager {
-    private config;
-    private state;
-    private subscribers;
-    private resizeObserver;
-    private rafId;
-    constructor(config: DimensionManagerConfig);
-    private getHeaderDepth;
-    private calculateMaxHeaderDepth;
-    private calculateHeaderHeight;
-    private convertHeightToPixels;
-    private calculateContentHeight;
-    private observeContainer;
-    updateConfig(config: Partial<DimensionManagerConfig>): void;
-    subscribe(callback: StateChangeCallback): () => void;
-    private notifySubscribers;
-    getState(): DimensionManagerState;
-    getContainerWidth(): number;
-    getCalculatedHeaderHeight(): number;
-    getMaxHeaderDepth(): number;
-    getContentHeight(): number | undefined;
-    destroy(): void;
-}
-export {};