@apia/table2-controller 5.0.0 → 5.0.1

package/dist/index.d.ts

@@ -1,434 +1,21 @@
-import * as react from 'react';
-import { HTMLAttributes, FC, ReactNode, ThHTMLAttributes, FocusEvent } from 'react';
-import { TSortType, EventEmitter, TLoadStructure } from '@apia/util';
-
-type RowsGroupBaseState = ElementBaseState & {
-    rows: Row[];
-    domProperties?: HTMLAttributes<HTMLTableSectionElement>;
-    properties?: Record<string, unknown>;
-};
-declare class RowsGroup<U extends RowsGroupBaseState> extends Element<U & RowsGroupBaseState> {
-    table: TableController;
-    constructor(table: TableController, state: U);
-    get rows(): Row[];
-    addRow(row: Row): this;
-    addRows(rows: Row[]): this;
-    clear(): Row[];
-    getRowById(id: string | number): Row | undefined;
-    getRowByIndex(index: number): Row;
-    getRowIndex(row: Row): number;
-    insertAfter(anchor: Row, newElement: Row): void;
-    insertBefore(anchor: Row, newElement: Row): void;
-    removeRow(row: Row): void;
-    swapRows(a: Row, b: Row): void;
-    protected runAddRowPlugin(newRow: Row): void;
-}
-
-type RowProperties = {
-    id: string;
-    cells: Cell[];
-    isExpandible?: boolean;
-    isExpanded?: boolean;
-    isHidden?: boolean;
-    isSelectable?: boolean;
-    isSelected?: boolean;
-    domProperties?: HTMLAttributes<HTMLTableRowElement>;
-    properties?: Record<string, unknown>;
-};
-type TBuildRow = Omit<RowProperties, 'cells'> & {
-    cells: (Omit<CellState, 'colName'> & {
-        colName?: string;
-    })[];
-};
-type RowState = Omit<RowProperties, 'isSelected'>;
-declare class Row extends Element<RowState> {
-    protected properties?: Omit<RowProperties, "id"> | undefined;
-    protected container: null | RowsGroup<RowsGroupBaseState>;
-    hiddenCells: Map<string, Cell>;
-    addCell(cell: Cell): this;
-    addCellAfter(anchor: Cell, newElement: Cell): void;
-    addCellBefore(anchor: Cell, newElement: Cell): void;
-    build(data: TBuildRow): void;
-    constructor(id: string, properties?: Omit<RowProperties, "id"> | undefined);
-    get cells(): Cell[];
-    get isSelected(): boolean;
-    getCellByColumnName(colName: string): Cell<CellState<any>> | undefined;
-    getCellByIndex(index: number): Cell<CellState<any>>;
-    getCellIndex(cell: Cell): number;
-    getContainer(): RowsGroup<RowsGroupBaseState> | null;
-    getFollowingRow(): Row;
-    getHiddenCell(colName: string): Cell<CellState<any>> | undefined;
-    getIndex(): number;
-    getPreviousRow(): Row;
-    insertAfter(row: Row): void;
-    insertBefore(row: Row): void;
-    remove(): void;
-    replaceCellOnIndex(index: number, newCell: Cell): void;
-    scrollIntoView(): void;
-    setContainer(container: null | RowsGroup<RowsGroupBaseState>): this;
-    setTable(table: null | TableController): this;
-    swap(withRow: Row): void;
-    toggleSelection(forceState?: boolean): void;
-    protected attachCell(cell: Cell): void;
-    protected detachCell(cell: Cell): void;
-}
-
-type TableBodyState = ElementBaseState & RowsGroupBaseState & {};
-type TBuildBody = {
-    rows: TBuildRow[];
-};
-declare class TableBody extends RowsGroup<TableBodyState> {
-    constructor(table: TableController);
-    build(data: TBuildBody): void;
-}
-
-type ColumnState<T extends ColumnState<any> = ColumnState<any>> = CellState<T> & {
-    asAdditional?: boolean;
-    sortable?: boolean;
-    sortState?: TSortType;
-};
-declare class Column extends Cell<ColumnState> {
-    asAdditional(): boolean;
-    isHidden(): boolean;
-    /**
-     * A visible column is that which is not additional nor hidden.
-     */
-    isVisible(): boolean;
-    sort(order?: ColumnState['sortState']): void;
-}
-
-declare class Filters extends Row {
-    filters: Map<string, Filter<any>>;
-    private buildFilterFromDefinition;
-    buildFilters(filters: Omit<FilterState, 'colName'>[]): boolean;
-    getAdditionalFilters(): Filter<any>[];
-    getCells(): Filter<string>[];
-    getContainer(): TableHead;
-    getFilter(name: string): Filter<any> | undefined;
-    getFilters(): Filter<any>[];
-    getFiltersInTable(): Filter<any>[];
-}
-
-type FilterRenderer = FC<{
-    cell: Filter<any>;
-}>;
-type FilterState<ValueType = string, T extends FilterState<any> = FilterState<ValueType, any>> = CellState<T> & {
-    asAdditional?: boolean;
-    name: string;
-    columnName?: string;
-    isRequired?: boolean;
-    Renderer?: FilterRenderer;
-    runAutomatically?: boolean;
-    title: string;
-    tooltip: string;
-    value: ValueType;
-    type: 'DATE' | 'INPUT' | 'COMBO' | 'DATERANGE' | 'SIZE' | 'SIZERANGE' | 'DATEHOUR' | 'DATEHOURRANGE';
-};
-type FilterEvents = Pick<TableEvents, 'filterBlur' | 'filterChange' | 'filterPressEnter'>;
-declare class Filter<ValueType = string> extends Cell<FilterState<ValueType>> {
-    asAdditional(): boolean;
-    constructor(state: FilterState<ValueType>);
-    clear(): void;
-    getCorrespondingColumn(): Column | undefined;
-    fire(ev: keyof FilterEvents): void;
-    getRow(): Filters;
-    getValue(): ValueType;
-    hasValue(): boolean;
-    setValue(val: ValueType): void;
-    validate(): boolean;
-}
-
-declare class Columns extends Row {
-    columns: Map<string, Column>;
-    buildColumnsRow(columns: ColumnState[]): void;
-    getColumn(name: string): Column;
-    getColumns(): Column[];
-    getAdditionalColumns(): Column[];
-    getShownColumns(): Column[];
-}
-
-type TableHeadState = ElementBaseState & RowsGroupBaseState & {};
-type TBuildHead = {
-    columns: ColumnState[];
-    filters: Omit<FilterState, 'colName'>[];
-};
-declare class TableHead extends RowsGroup<TableHeadState> {
-    constructor(table: TableController);
-    columnsRow: Columns | null;
-    filtersRow: Filters | null;
-    getHeaderRow(): Columns | undefined;
-    getFiltersRow(): Filters | undefined;
-    build(data: TBuildHead): void;
-}
-
-/**
- * This class is the default way to customize the table behavior.
- */
-interface TablePlugin {
-    getRenderers?: () => {
-        cell?: React.FC<{
-            cell: Cell;
-        }>;
-    };
-    onAddRow?: (controller: TableController, target: RowsGroup<any>, newRow: Row) => void;
-    onResize?: (controller: TableController, colName: string, newSize: number) => void;
-    /**
-     * This hook is called when the table is renderized.
-     * The elements returned by this hook will be added to the dom of the element.
-     */
-    useElementDomProps?: (controller: TableController, _element: TableController | Element<any>, _context: any) => HTMLAttributes<HTMLElement>;
-}
-declare const defaultPlugins: () => (WaiAriaPlugin | FocusControllerPlugin)[];
-
-type TableState = {
-    allowEdition: boolean;
-    allowResize: boolean;
-    allowSelection: boolean;
-    editionMode: boolean;
-    focusedCell: Cell | null;
-    isSelectionMultiple: boolean;
-    onRowExpand?: (row: Row) => Promise<false | ReactNode>;
-    plugins: TablePlugin[];
-    selection: Set<Row>;
-};
-type TBuildTable = TBuildHead & TBuildBody;
-type TableEvents = {
-    cellFocus: {
-        cell: Cell;
-        doFocus: boolean;
-    };
-    columnSort: Column;
-    editionMode: boolean;
-    filterChange: Filter<any>;
-    filterPressEnter: Filter<any>;
-    filterBlur: Filter<any>;
-    keyEnter: null;
-    rowDelete: Row;
-    scrollIntoRow: Row;
-    selectionChange: Row[];
-};
-declare class TableController extends EventEmitter<TableEvents> {
-    protected state: TableState;
-    constructor(props?: Partial<Omit<TableState, 'selection'>>);
-    body: TableBody;
-    head: TableHead;
-    /**
-     * Clears all data in the table, except for the events
-     * listeners and recreates the structure based on the passed data.
-     */
-    build(data: TBuildTable): void;
-    fromGenericTable(table: TLoadStructure): void;
-    getColumn(name: string): Column | undefined;
-    getColumns(): Column[];
-    getFilter(name: string): Filter<any> | undefined;
-    getFilters(): Filter<any>[];
-    getRowById(id: string | number): Row | undefined;
-    hasAdditionalContent(): true | ((row: Row) => Promise<false | ReactNode>) | undefined;
-    onRowExpand(row: Row): string | Promise<ReactNode> | undefined;
-    /**
-     * EDITION MODE
-     */
-    get isEditionMode(): boolean;
-    toggleEditionMode(force?: boolean): void;
-    /**
-     * SELECTION
-     */
-    clearSelection(): void;
-    /**
-     * Returns the selected rows.
-     */
-    getSelectedRows(): Row[];
-    isSelected(row: Row): boolean;
-    toggleColumnVisibility(colName: string, isVisible?: boolean): void;
-    toggleFiltersRowVisibility(): void;
-    /**
-     * Toggles the selection state of a given row.
-     *
-     * If the `isSelected` parameter is provided, it explicitly sets the selection
-     * state of the row to the given value (`true` for selected, `false` for deselected).
-     * If `isSelected` is not provided, the method will toggle the current selection state
-     * of the row (i.e., select it if it's currently not selected, or deselect it if it is).
-     *
-     * @param row - The row to toggle selection for.
-     * @param isSelected - Optional. A boolean indicating whether the row should be selected (`true`)
-     *                     or deselected (`false`). If not provided, the selection state will be toggled.
-     */
-    toggleRowSelection(row: Row, isSelected?: boolean): void;
-    protected restoreFocus(): void;
-    removeRow(row: Row): void;
-    /**
-     * FOCUS
-     */
-    /**
-     * @returns The currently focused cell in the table.
-     */
-    getFocusedCell(): Cell<CellState<any>> | null;
-    setFocusedCell(cell: Cell, doFocus?: boolean): void;
-    setSelection(indices: number[]): void;
-    scrollRowIntoView(row: Row): void;
-    /**
-     * STATE
-     */
-    /**
-     * Returns the current state of the `TableController` instance.
-     *
-     * @param prop - The property of the state to retrieve.
-     */
-    getState<K extends keyof TableState>(prop: K): TableState[K];
-    /**
-     * Updates the state of the `TableController` instance.
-     *
-     * This method provides two overloads:
-     * 1. A callback function that takes the current state and returns a new state.
-     * 2. A key-value pair where the key is a property of the state, and the value is the new value for that property.
-     *
-     * @param prop - Either a callback function to update the state or the key of the state property to update.
-     * @param value - (Optional) The new value for the specified state property. This is required if `prop` is a key.
-     *
-     * @returns The `TableController` instance for method chaining.
-     *
-     * ### Usage:
-     *
-     * **Using a callback function:**
-     * ```tsx
-     * tableController.setState((state) => ({
-     *   ...state,
-     *   allowEdition: false,
-     * }));
-     * ```
-     *
-     * **Using a key-value pair:**
-     * ```tsx
-     * tableController.setState('allowEdition', false);
-     * ```
-     */
-    setState(cb: (s: TableState) => TableState): this;
-    setState<K extends keyof TableState>(prop: K, value: TableState[K]): this;
-    sortColumn(col: Column, sortState?: TSortType): void;
-    /**
-     * PLUGINS
-     */
-    getPluginOfType<T extends TablePlugin>(clazz: new (...args: any[]) => T): T | undefined;
-    /**
-     * Sets the plugins for the table.
-     */
-    setPlugins(cb: (currentPlugins: TablePlugin[]) => TablePlugin[]): void;
-    getApplicablePlugins<K extends keyof TablePlugin>(method: K): ((...args: Parameters<NonNullable<TablePlugin[K]>> extends [
-        any,
-        ...infer Rest
-    ] ? Rest : void[]) => ReturnType<NonNullable<TablePlugin[K]>>)[];
-}
-
-type ElementBaseState = {
-    properties?: Record<string, unknown>;
-};
-declare abstract class Element<T extends ElementBaseState> {
-    protected state: T;
-    protected table: TableController;
-    constructor(state: T);
-    getTable(): TableController;
-    setTable(table: null | TableController): this;
-    getState<K extends keyof T>(prop: K): T[K];
-    setState(cb: (s: T) => T): this;
-    setState<K extends keyof T>(prop: K, value: T[K]): this;
-}
-
-type CellState<T extends CellState<any> = CellState<any>> = {
-    colName: string;
-    content?: ReactNode;
-    className?: string;
-    isFocused?: boolean;
-    isHidden?: boolean;
-    tag?: 'td' | 'th;';
-    Renderer?: FC<{
-        cell: Cell<T>;
-    }>;
-    domProperties?: ThHTMLAttributes<HTMLTableCellElement>;
-    properties?: Record<string, unknown>;
-};
-declare class Cell<State extends CellState<any> = CellState<any>> extends Element<State> {
-    protected parentRow: Row | null;
-    getColumnName(): State["colName"];
-    getIndex(): number;
-    getRow(): Row | null;
-    setRow(row: Row | null): this;
-    /**
-     *
-     * @param doFocus - If true, the cell will be focused after being set as the focused cell.
-     *                 If false, the cell will contain the tabIndex = 0 but will not be focused.
-     */
-    focus(doFocus?: boolean): void;
-    updateState(state: Partial<State>): void;
-}
-
-declare class AdditionalCell extends Cell<CellState & {
-    expanded: boolean;
-}> {
-    constructor();
-    onToggle(): Promise<void>;
-}
-
-declare class AdditionalRow extends Row {
-    constructor(id: string);
-    get cells(): Cell<CellState<any>>[];
-}
-
-declare class FocusControllerPlugin implements TablePlugin {
-    rootElement: HTMLElement | null;
-    scrollIntoView(rowId: string): void;
-    useElementDomProps(controller: TableController, element: TableController | Element<any>, _context: any): {
-        className: string;
-        onClick: (ev: react.MouseEvent) => void;
-        onKeyDown: (ev: react.KeyboardEvent) => void;
-        onBlur: (ev: FocusEvent) => void;
-        ref: (el: HTMLElement | null) => void;
-    } | {
-        className?: undefined;
-        onClick?: undefined;
-        onKeyDown?: undefined;
-        onBlur?: undefined;
-        ref?: undefined;
-    };
-}
-
-declare class WaiAriaPlugin implements TablePlugin {
-    useElementDomProps(controller: TableController, element: TableController | Element<any>, context: any): {
-        'aria-selected': boolean;
-        'aria-rowindex': any;
-        'aria-colindex'?: undefined;
-        role?: undefined;
-        'aria-multiselectable'?: undefined;
-        'aria-colcount'?: undefined;
-        'aria-rowcount'?: undefined;
-    } | {
-        'aria-colindex': any;
-        'aria-selected'?: undefined;
-        'aria-rowindex'?: undefined;
-        role?: undefined;
-        'aria-multiselectable'?: undefined;
-        'aria-colcount'?: undefined;
-        'aria-rowcount'?: undefined;
-    } | {
-        role: string;
-        'aria-multiselectable': boolean | undefined;
-        'aria-colcount': number;
-        'aria-rowcount': number;
-        'aria-selected'?: undefined;
-        'aria-rowindex'?: undefined;
-        'aria-colindex'?: undefined;
-    } | {
-        'aria-selected'?: undefined;
-        'aria-rowindex'?: undefined;
-        'aria-colindex'?: undefined;
-        role?: undefined;
-        'aria-multiselectable'?: undefined;
-        'aria-colcount'?: undefined;
-        'aria-rowcount'?: undefined;
-    };
-}
-
-declare class DateFilter extends Filter<number | null> {
-}
-
-export { AdditionalCell, AdditionalRow, Cell, type CellState, Column, type ColumnState, Columns, DateFilter, Element, type ElementBaseState, Filter, type FilterEvents, type FilterRenderer, type FilterState, Filters, FocusControllerPlugin, Row, type RowProperties, type RowState, RowsGroup, type RowsGroupBaseState, type TBuildBody, type TBuildHead, type TBuildRow, type TBuildTable, TableBody, type TableBodyState, TableController, type TableEvents, TableHead, type TableHeadState, type TablePlugin, type TableState, WaiAriaPlugin, defaultPlugins };
+export { AdditionalCell } from './data/primitive/AdditionalCell.js';
+export { AdditionalRow } from './data/primitive/AdditionalRow.js';
+export { Cell, CellState } from './data/primitive/Cell.js';
+export { Row, RowProperties, RowState, TBuildRow } from './data/primitive/Row.js';
+export { TBuildTable, TTableEnvironment, TableController, TableEvents, TableState } from './data/TableController.js';
+export { TBuildBody, TableBody, TableBodyState } from './data/body/TableBody.js';
+export { TablePlugin, defaultPlugins } from './data/plugins/TablePlugin.js';
+export { FocusControllerPlugin } from './data/plugins/FocusControllerPlugin/index.js';
+export { WaiAriaPlugin } from './data/plugins/WaiAriaPlugin.js';
+export { Element, ElementBaseState } from './data/primitive/Element.js';
+export { RowsGroup, RowsGroupBaseState } from './data/primitive/RowsGroup.js';
+export { Filter, FilterEvents, FilterRenderer, FilterState, TFilterType, TFilterValueType } from './data/filter/Filter.js';
+export { DateFilter } from './data/filter/DateFilter.js';
+export { TBuildHead, TableHead, TableHeadState } from './data/head/TableHead.js';
+export { Column, ColumnState } from './data/head/Column.js';
+export { Columns } from './data/head/Columns.js';
+export { Filters } from './data/head/Filters.js';
+export { ComboFilter } from './data/filter/ComboFilter.js';
+export { DateRangeFilter } from './data/filter/DateRangeFilter.js';
+export { DateTimeRangeFilter } from './data/filter/DateTimeRangeFilter.js';
 //# sourceMappingURL=index.d.ts.map