@simple-table/react 3.0.0-beta.12 → 3.0.0-beta.15

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

@@ -1,136 +0,0 @@
-import TableRow from "../types/TableRow";
-import Row from "../types/Row";
-import HeaderObject, { Accessor } from "../types/HeaderObject";
-import CellValue from "../types/CellValue";
-import RowState from "../types/RowState";
-import { CustomTheme } from "../types/CustomTheme";
-import { GetRowId } from "../types/GetRowId";
-import { GenerateRowIdParams } from "../types/GenerateRowIdParams";
-/**
- * Calculate the height of a nested grid based on the number of child rows
- * @param childRowCount - Number of rows in the nested grid
- * @param rowHeight - Height of each row
- * @param headerHeight - Height of the header
- * @param customTheme - Custom theme configuration
- * @returns Calculated height in pixels (includes padding, borders, row separators, and header border)
- */
-export declare const calculateNestedGridHeight: ({ childRowCount, rowHeight, headerHeight, customTheme, }: {
-    childRowCount: number;
-    rowHeight: number;
-    headerHeight: number;
-    customTheme: CustomTheme;
-}) => number;
-/**
- * Calculate the final wrapper height for a nested grid, accounting for custom heights
- *
- * @param calculatedHeight - The default calculated height based on child rows
- * @param customHeight - Optional custom height from nestedTable config (e.g., "200px" or 200)
- * @param customTheme - Custom theme configuration for padding
- * @returns Final height in pixels for the wrapper (includes padding)
- */
-export declare const calculateFinalNestedGridHeight: ({ calculatedHeight, customHeight, customTheme, }: {
-    calculatedHeight: number;
-    customHeight?: string | number | undefined;
-    customTheme: CustomTheme;
-}) => number;
-/**
- * Calculate the inner height for a nested SimpleTable component
- * This accounts for the padding that's applied to the wrapper
- *
- * @param calculatedHeight - The total height of the nested grid row (from calculateNestedGridHeight)
- * @param customHeight - Optional custom height from nestedTable config (e.g., "200px")
- * @param customTheme - Custom theme configuration for padding
- * @returns Height value to pass to the nested SimpleTable (string with units)
- */
-export declare const calculateNestedTableHeight: ({ calculatedHeight, customHeight, customTheme, }: {
-    calculatedHeight: number;
-    customHeight?: string | number | undefined;
-    customTheme: CustomTheme;
-}) => string;
-/**
- * Get a nested property value from an object using dot notation and array bracket notation
- * Examples:
- *   getNestedValue(row, "latest.rank") returns row.latest.rank
- *   getNestedValue(row, "albums[0].title") returns row.albums[0].title
- *   getNestedValue(row, "releaseDate[0]") returns row.releaseDate[0]
- */
-export declare const getNestedValue: (obj: Row, path: Accessor) => CellValue;
-/**
- * Set a nested property value in an object using dot notation and array bracket notation
- * Examples:
- *   setNestedValue(row, "latest.rank", 5) sets row.latest.rank = 5
- *   setNestedValue(row, "albums[0].title", "New Album") sets row.albums[0].title = "New Album"
- *   setNestedValue(row, "releaseDate[0]", "2024") sets row.releaseDate[0] = "2024"
- */
-export declare const setNestedValue: (obj: Row, path: Accessor, value: CellValue) => void;
-/**
- * Check if an array contains Row objects (vs primitive arrays like string[] or number[])
- */
-export declare const isRowArray: (data: any) => data is Row[];
-/**
- * Generate the row ID array from index path and optional custom identifier.
- *
- * The row ID is always an array that includes:
- * - The index at each level of nesting
- * - The grouping key between levels (for readability)
- * - An optional custom identifier from getRowId (appended at the end)
- *
- * Examples:
- * - Root row (index 1): [1]
- * - Nested store (parent index 1, store index 5): [1, "stores", 5]
- * - With custom ID: [1, "stores", 5, "STORE-101"]
- * - Deep nesting: [1, "stores", 5, "products", 2, "PROD-24"]
- *
- * @param params - Object containing row data, getRowId function, and metadata
- * @returns An array representing the unique row ID path
- */
-export declare const generateRowId: (params: GenerateRowIdParams) => (string | number)[];
-/**
- * Convert a row ID array to a string for use as Map keys, Set members, etc.
- *
- * @param rowId - Array of strings/numbers representing the row ID path
- * @returns A string representation of the row ID
- */
-export declare const rowIdToString: (rowId: (string | number)[]) => string;
-/**
- * Get nested rows from a row based on the grouping path
- */
-export declare const getNestedRows: (row: Row, groupingKey: string) => Row[];
-/**
- * Check if a row has nested rows for a given grouping key
- */
-export declare const hasNestedRows: (row: Row, groupingKey?: string) => boolean;
-/**
- * Determine if a row is expanded based on expandedDepths and manual row overrides
- * @param rowId - The ID of the row to check
- * @param depth - The depth level of the row (0-indexed)
- * @param expandedDepths - Set of depth levels that are expanded
- * @param expandedRows - Map of row IDs to their depths for rows that user wants expanded
- * @param collapsedRows - Map of row IDs to their depths for rows that user wants collapsed
- * @returns true if the row is expanded, false otherwise
- */
-export declare const isRowExpanded: (rowId: string | number, depth: number, expandedDepths: Set<number>, expandedRows: Map<string, number>, collapsedRows: Map<string, number>) => boolean;
-/**
- * Flatten rows recursively based on row grouping configuration
- * Now calculates ALL properties including position and isLastGroupRow
- * Also injects special state rows for loading/error/empty states (only if renderers are available)
- * Also injects nested grid rows when a header has nestedTable configuration
- */
-export declare const flattenRowsWithGrouping: ({ depth, expandedDepths, expandedRows, collapsedRows, rowGrouping, getRowId, rows, displayPositionOffset, rowStateMap, hasLoadingRenderer, hasErrorRenderer, hasEmptyRenderer, headers, rowHeight, headerHeight, customTheme, }: {
-    depth?: number | undefined;
-    expandedDepths: Set<number>;
-    expandedRows: Map<string, number>;
-    collapsedRows: Map<string, number>;
-    rowGrouping?: string[] | undefined;
-    getRowId?: GetRowId | undefined;
-    rows: Row[];
-    displayPositionOffset?: number | undefined;
-    rowStateMap?: Map<string | number, RowState> | undefined;
-    hasLoadingRenderer?: boolean | undefined;
-    hasErrorRenderer?: boolean | undefined;
-    hasEmptyRenderer?: boolean | undefined;
-    headers?: HeaderObject[] | undefined;
-    rowHeight: number;
-    headerHeight: number;
-    customTheme: CustomTheme;
-}) => TableRow[];

package/dist/core/src/utils/sortUtils.d.ts

@@ -1,8 +0,0 @@
-import HeaderObject from "../types/HeaderObject";
-import Row from "../types/Row";
-import SortColumn from "../types/SortColumn";
-export declare const handleSort: ({ headers, rows, sortColumn, }: {
-    headers: HeaderObject[];
-    rows: Row[];
-    sortColumn: SortColumn;
-}) => Row[];

package/dist/core/src/utils/stateRowRenderer.d.ts

@@ -1,15 +0,0 @@
-import type TableRowType from "../types/TableRow";
-import { HeightOffsets } from "./infiniteScrollUtils";
-import { CustomTheme } from "../types/CustomTheme";
-import { LoadingStateRenderer, ErrorStateRenderer, EmptyStateRenderer } from "../types/RowStateRendererProps";
-export interface StateRowRenderContext {
-    index: number;
-    rowHeight: number;
-    heightOffsets: HeightOffsets | undefined;
-    customTheme: CustomTheme;
-    loadingStateRenderer?: LoadingStateRenderer;
-    errorStateRenderer?: ErrorStateRenderer;
-    emptyStateRenderer?: EmptyStateRenderer;
-}
-export declare const createStateRow: (tableRow: TableRowType, context: StateRowRenderContext) => HTMLElement;
-export declare const cleanupStateRow: (rowElement: HTMLElement) => void;

package/dist/core/src/utils/stickyParentsRenderer.d.ts

@@ -1,30 +0,0 @@
-import TableRow from "../types/TableRow";
-import HeaderObject from "../types/HeaderObject";
-import { CumulativeHeightMap, HeightOffsets } from "./infiniteScrollUtils";
-import type { SectionScrollController } from "../managers/SectionScrollController";
-import { CustomTheme } from "../types/CustomTheme";
-import { CellRenderContext } from "./bodyCell/types";
-export interface StickyParentsContainerProps {
-    calculatedHeaderHeight: number;
-    heightMap?: CumulativeHeightMap;
-    partiallyVisibleRows: TableRow[];
-    pinnedLeftColumns: HeaderObject[];
-    pinnedLeftWidth: number;
-    pinnedRightColumns: HeaderObject[];
-    pinnedRightWidth: number;
-    scrollTop: number;
-    scrollbarWidth: number;
-    stickyParents: TableRow[];
-}
-export interface StickyParentsRenderContext {
-    collapsedHeaders: Set<string>;
-    customTheme: CustomTheme;
-    editColumns: boolean;
-    headers: HeaderObject[];
-    rowHeight: number;
-    heightOffsets: HeightOffsets | undefined;
-    cellRenderContext: CellRenderContext;
-    sectionScrollController?: SectionScrollController | null;
-}
-export declare const createStickyParentsContainer: (props: StickyParentsContainerProps, context: StickyParentsRenderContext) => HTMLElement | null;
-export declare const cleanupStickyParentsContainer: (container: HTMLElement, sectionScrollController?: SectionScrollController | null) => void;

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

@@ -1,27 +0,0 @@
-import React from "react";
-import type { TableAPI } from "simple-table-core";
-import type { SimpleTableReactProps } from "./types";
-/**
- * SimpleTable — React adapter for simple-table-core.
- *
- * Accepts the same props as SimpleTableProps (the vanilla user-facing API) but
- * with React component types for all renderer props: cellRenderer,
- * headerRenderer, footerRenderer, loadingStateRenderer, errorStateRenderer,
- * emptyStateRenderer, headerDropdown, and per-column renderers inside
- * ReactHeaderObject.
- *
- * The ref exposes the full TableAPI imperative interface (sort, filter,
- * paginate, export to CSV, cell selection, column visibility, etc.).
- *
- * @example
- * const tableRef = useRef<TableAPI>(null);
- *
- * <SimpleTable
- *   ref={tableRef}
- *   rows={rows}
- *   defaultHeaders={headers}
- *   footerRenderer={MyFooter}
- * />
- */
-declare const SimpleTable: React.ForwardRefExoticComponent<SimpleTableReactProps & React.RefAttributes<TableAPI>>;
-export default SimpleTable;

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

@@ -1,3 +0,0 @@
-import type { SimpleTableConfig } from "simple-table-core";
-import type { SimpleTableReactProps } from "./types";
-export declare function buildVanillaConfig(config: SimpleTableReactProps): SimpleTableConfig;

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

@@ -1,3 +0,0 @@
-export { default as SimpleTable } from "./SimpleTable";
-export type { SimpleTableReactProps, TableInstance, ReactHeaderObject, ReactColumnEditorConfig, ReactIconsConfig, ReactIconElement, ReactCellRenderer, ReactHeaderRenderer, ReactFooterRenderer, ReactHeaderDropdown, ReactColumnEditorRowRenderer, ReactLoadingStateRenderer, ReactErrorStateRenderer, ReactEmptyStateRenderer, } from "./types";
-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, HeaderDropdown, HeaderDropdownProps, HeaderObject, HeaderRenderer, HeaderRendererComponents, HeaderRendererProps, 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/react/src/types.d.ts

@@ -1,51 +0,0 @@
-import type React from "react";
-import type { SimpleTableProps, SimpleTableConfig, HeaderObject, TableAPI, CellRendererProps, HeaderRendererProps, FooterRendererProps, LoadingStateRendererProps, ErrorStateRendererProps, EmptyStateRendererProps, HeaderDropdownProps, ColumnEditorRowRendererProps, ColumnEditorConfig } from "simple-table-core";
-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>;
-export type ReactHeaderRenderer = React.ComponentType<HeaderRendererProps>;
-export type ReactFooterRenderer = React.ComponentType<FooterRendererProps>;
-export type ReactHeaderDropdown = React.ComponentType<HeaderDropdownProps>;
-export type ReactColumnEditorRowRenderer = React.ComponentType<ColumnEditorRowRendererProps>;
-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"> {
-    rowRenderer?: ReactColumnEditorRowRenderer;
-}
-export interface ReactHeaderObject extends Omit<HeaderObject, "cellRenderer" | "headerRenderer" | "children" | "nestedTable"> {
-    cellRenderer?: ReactCellRenderer;
-    headerRenderer?: ReactHeaderRenderer;
-    children?: ReactHeaderObject[];
-    nestedTable?: Omit<SimpleTableReactProps, "rows">;
-}
-export interface SimpleTableReactProps extends Omit<SimpleTableProps, "tableRef" | "allowAnimations" | "expandIcon" | "filterIcon" | "headerCollapseIcon" | "headerExpandIcon" | "nextIcon" | "prevIcon" | "sortDownIcon" | "sortUpIcon" | "columnEditorText" | "defaultHeaders" | "footerRenderer" | "emptyStateRenderer" | "errorStateRenderer" | "loadingStateRenderer" | "tableEmptyStateRenderer" | "headerDropdown" | "columnEditorConfig" | "icons"> {
-    defaultHeaders: ReactHeaderObject[];
-    footerRenderer?: ReactFooterRenderer;
-    loadingStateRenderer?: ReactLoadingStateRenderer;
-    errorStateRenderer?: ReactErrorStateRenderer;
-    emptyStateRenderer?: ReactEmptyStateRenderer;
-    tableEmptyStateRenderer?: React.ReactNode;
-    headerDropdown?: ReactHeaderDropdown;
-    columnEditorConfig?: ReactColumnEditorConfig;
-    icons?: ReactIconsConfig;
-}
-export type { CellRendererProps, HeaderRendererProps, FooterRendererProps, LoadingStateRendererProps, ErrorStateRendererProps, EmptyStateRendererProps, HeaderDropdownProps, ColumnEditorRowRendererProps, };

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

@@ -1,25 +0,0 @@
-import React from "react";
-/**
- * Wraps a React component into a function that returns an HTMLElement, matching
- * the vanilla renderer contract expected by simple-table-core.
- *
- * Uses renderToStaticMarkup for synchronous rendering that is safe to call from
- * any context (including inside useEffect) without triggering React 18's
- * "flushSync was called from inside a lifecycle method" warning.
- */
-export declare function wrapReactRenderer<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 + flushSync which silently produces empty
- * output when called during React 18's passive effects phase.
- */
-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>;