@economic/taco 2.25.1-alpha.13 → 2.25.1

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+import './css/global.css';
+export * from './components/Alert/Alert';
+export * from './components/AlertDialog/AlertDialog';
+export * from './components/Accordion/Accordion';
+export * from './components/Backdrop/Backdrop';
+export * from './components/Badge/Badge';
+export * from './components/BadgeIcon/BadgeIcon';
+export * from './components/Banner/Banner';
+export * from './components/Button/Button';
+export * from './components/Calendar/Calendar';
+export * from './components/Card/Card';
+export * from './components/Checkbox/Checkbox';
+export * from './components/Combobox/Combobox';
+export * from './components/Datepicker/Datepicker';
+export * from './components/Dialog/Dialog';
+export * from './components/Drawer/Drawer';
+export * from './components/Field/Field';
+export * from './components/Form/Form';
+export * from './components/Group/Group';
+export * from './components/Hanger/Hanger';
+export * from './components/HoverCard/HoverCard';
+export * from './components/Icon/Icon';
+export * from './components/IconButton/IconButton';
+export * from './components/Input/Input';
+export * from './components/Listbox/Listbox';
+export * from './components/Menu/Menu';
+export * from './components/ModeSwitch/ModeSwitch';
+export * from './components/Navigation/Navigation';
+export * from './components/OverflowGroup/OverflowGroup';
+export * from './components/Pagination/Pagination';
+export * from './components/Popover/Popover';
+export * from './components/Progress/Progress';
+export * from './components/Provider/Provider';
+export * from './components/Provider/Localization';
+export * from './components/RadioGroup/RadioGroup';
+export * from './components/Report/Report';
+export * from './components/SearchInput/SearchInput';
+export * from './components/SearchInput2/SearchInput2';
+export * from './components/Select/Select';
+export * from './components/Select2/Select2';
+export * from './components/Shortcut/Shortcut';
+export * from './components/Spinner/Spinner';
+export * from './components/Switch/Switch';
+export * from './components/Table/Table';
+export * from './components/Table3/Table3';
+export * from './components/Tabs/Tabs';
+export * from './components/Tag/Tag';
+export * from './components/Textarea/Textarea';
+export * from './components/Toast/Toaster';
+export * from './components/Tooltip/Tooltip';
+export * from './components/Tour/Tour';
+export * from './components/Treeview/Treeview';
+export * from './components/VisuallyHidden/VisuallyHidden';
+export * from './components/Header/Header';
+export * from './components/Layout/Layout';
+export * from './components/Navigation2/Navigation2';
+export * as CollectionPrimitive from './primitives/Collection/Collection';
+export * from './primitives/Table/useTableDataLoader';
+export * from './utils/date';
+export * from './utils/keyboard';
+export * from './utils/mergeRefs';
+export * from './hooks/useBoundaryOverflowDetection';
+export * from './hooks/useBoundingClientRectListener';
+export * from './hooks/useIntersectionObserver';
+export * from './hooks/useIsLargeScreen';
+export * from './hooks/useLazyEffect';
+export * from './hooks/useMatchMedia';
+export * from './hooks/useMergedRef';
+export * from './utils/hooks/useDropTarget';
+export * from './utils/hooks/useListKeyboardNavigation';
+export * from './utils/hooks/useListScrollTo';
+export * from './utils/hooks/useOnClickOutside';
+export * from './types';

package/dist/primitives/Table/types.d.ts

@@ -0,0 +1,214 @@
+/// <reference types="react" />
+import { ColumnFilter as ReactTableColumnFilter, ColumnFiltersState as ReactTableColumnFilterState, ColumnOrderState as ReactTableColumnOrderState, ColumnPinningState as ReactTableColumnPinningState, ColumnSort as ReactTableColumnSort, ColumnSizingState as ReactTableColumnSizingState, GroupingState as ReactTableGroupingState, VisibilityState as ReactTableColumnVisibilityState, SortingState as ReactTableSortingState, BuiltInAggregationFn as ReactTableBuiltInAggregationFn, BuiltInSortingFn as ReactTableBuiltInSortingFn } from '@tanstack/react-table';
+import { FontSize, FontSizes, ValueOf } from '../../types';
+import { MenuProps } from '../../components/Menu/Menu';
+declare type TODO = any;
+export declare type TableRef = HTMLTableElement & {
+    instance: {
+        resetFiltering: () => void;
+        resetRowExpansion: () => void;
+        resetRowSelection: () => void;
+        resetSorting: () => void;
+    };
+};
+export declare enum TableFilterComparator {
+    Contains = 0,
+    DoesNotContain = 1,
+    IsEqualTo = 2,
+    IsNotEqualTo = 3,
+    IsGreaterThan = 4,
+    IsLessThan = 5,
+    IsBetween = 6,
+    IsEmpty = 7,
+    IsNotEmpty = 8,
+    IsLessThanOrEqualTo = 9,
+    IsGreaterThanOrEqualTo = 10,
+    HasAnyOf = 11,
+    HasAllOf = 12,
+    HasNoneOf = 13
+}
+export declare type TableFilterValue = {
+    comparator: TableFilterComparator;
+    value: any;
+};
+export declare type TableFilter = {
+    id: string;
+    value: TableFilterValue;
+};
+export declare type TableColumnAlignment = 'left' | 'center' | 'right';
+export declare type TableColumnClassNameHandler<TType = unknown> = string | ((row: TType) => string | undefined);
+export declare type TableColumnDataType = 'auto' | 'number' | 'alphanumeric' | 'alphanumericCaseSensitive' | 'datetime' | 'boolean';
+export declare type TableColumnFilter = ReactTableColumnFilter;
+export declare type TableColumnMenu = (props: Partial<MenuProps>) => JSX.Element;
+export declare type TableColumnRenderer<TType, TValue> = (value: TValue, row: TType) => JSX.Element | string | number | null;
+export declare type TableColumnRendererAggregate<TType, TValue> = (value: TValue, row: TType) => JSX.Element | string | number | null;
+export declare type TableColumnRendererControl<TType = unknown> = ((props: TableColumnRendererControlProps, row?: TType) => JSX.Element) | 'datepicker' | 'input' | 'switch' | 'textarea';
+export declare type TableColumnRendererControlProps = {
+    className?: string;
+    disabled?: boolean;
+    fontSize?: FontSize;
+    invalid?: boolean;
+    onBlur?: (value: any) => void;
+    onFocus?: React.FocusEventHandler;
+    readOnly?: boolean;
+    ref: React.RefObject<HTMLElement> | ((instance: HTMLElement | null | undefined) => void);
+    setValue: (value: any) => void;
+    value: any;
+};
+export declare type TableColumnRendererHeader = string;
+export declare type TableColumnRendererFooter<TValue> = (values: TValue[]) => JSX.Element | string | number | null;
+export declare type TableColumnSort = ReactTableColumnSort;
+export declare type TableColumnSortDirection = 'asc' | 'desc';
+export declare type TableColumnSortFn<TType = unknown> = ((rowA: TType, rowB: TType, columnId: string) => -1 | 0 | 1) | ReactTableBuiltInSortingFn | 'auto';
+export declare type TableColumnWidth = number | 'grow';
+export declare type TableRowActionRenderer<TType = unknown> = (row: TType) => JSX.Element | null;
+export declare type TableRowActionGroupRenderer<TType = unknown> = (rows: TType[]) => JSX.Element | null;
+export declare type TableRowClickHandler<TType = unknown> = (row: TType) => void;
+export declare type TableRowGotoHandler = (column: string, query: string, sorting: TableColumnSort[], filters: TableColumnFilter[], search: string | undefined) => Promise<number>;
+export declare type TableRowHeight = 'short' | 'medium' | 'tall' | 'extra-tall';
+export declare type TableRowSelectHandler<TType = unknown> = (rows: TType[]) => void;
+export declare type TableShortcutHandlerFn<TType = unknown> = (row: TType) => void;
+export declare type TableShortcutHandlerObject<TType = unknown> = {
+    handler: TableShortcutHandlerFn<TType>;
+    meta?: boolean;
+    shift?: boolean;
+};
+export declare type TableFilterHandler = (filters: TableColumnFilter[]) => void;
+export declare type TableFontSize = keyof typeof FontSizes;
+export declare type TablePreset = 'lite' | 'complex';
+export declare type TableRowExpansionRenderer<TType = unknown> = (row: TType) => (() => JSX.Element) | null;
+export declare type TableScrollToIndexHandler = (index: number, options?: {
+    align: 'start' | 'center' | 'end' | 'auto';
+}) => void;
+export declare type TableServerLoadPageHandler = (pageIndex: number, sorting: TableColumnSort[], filters: TableColumnFilter[], search: string | undefined) => Promise<void>;
+export declare type TableServerLoadAllHandler = (sorting: TableColumnSort[], filters: TableColumnFilter[], search: string | undefined) => Promise<void>;
+export declare enum TableServerLoadAllState {
+    Incomplete = 0,
+    Loading = 1,
+    Completed = 2
+}
+export declare type TableSettingsHandler = (settings: TableSettings) => void | Promise<void>;
+export declare type TableShortcuts<TType = unknown> = Record<string, TableShortcutHandlerFn<TType> | TableShortcutHandlerObject<TType>>;
+export declare type TableSortHandler = (sorting: TableColumnSort[]) => void;
+export declare type TableSettings = {
+    columnFilters?: ReactTableColumnFilterState;
+    columnOrder?: ReactTableColumnOrderState;
+    columnPinning?: ReactTableColumnPinningState;
+    columnSizing?: ReactTableColumnSizingState;
+    columnVisibility?: ReactTableColumnVisibilityState;
+    excludeUnmatchedRecordsInSearch?: boolean;
+    fontSize?: TableFontSize;
+    grouping?: ReactTableGroupingState;
+    rowHeight?: TableRowHeight;
+    searchQuery?: string;
+    sorting?: ReactTableSortingState;
+};
+export declare type EnableSettingsOptions = {
+    columnOrder: boolean;
+    columnPinning: boolean;
+    columnSizing: boolean;
+    columnVisibility: boolean;
+    excludeUnmatchedRecordsInSearch: boolean;
+    fontSize: boolean;
+    grouping: boolean;
+    rowHeight: boolean;
+    sorting: boolean;
+};
+export declare type TableFeatureProps = {
+    enableFiltering?: boolean;
+    enableSearch?: boolean;
+    enableSorting?: boolean;
+    enableColumnFreezing?: boolean;
+    enableColumnHiding?: boolean;
+    enableColumnResizing?: boolean;
+    enableRowExpansion?: boolean;
+    enableRowSelection?: boolean;
+    enableRowSelectionSingle?: boolean;
+    enableColumnOrdering?: boolean;
+    enableFontSize?: boolean;
+    enableFooter?: boolean;
+    enablePrinting?: boolean;
+    enableRowActions?: boolean;
+    enableRowActive?: boolean;
+    enableRowClick?: boolean;
+    enableRowGoto?: boolean;
+    enableRowHeight?: boolean;
+    enableSaveSettings?: boolean | Partial<EnableSettingsOptions>;
+};
+declare type TableCommonProps<TType = unknown> = TableFeatureProps & {
+    children: (JSX.Element | boolean | null | undefined)[];
+    data: TType[];
+    id: string;
+    defaultColumnFreezingIndex?: number;
+    defaultRowActiveIndex?: number;
+    defaultRowGroupColumnId?: keyof TType;
+    defaultSettings?: TableSettings;
+    preset?: TablePreset;
+    rowActions?: TableRowActionRenderer<TType>[];
+    rowActionsForGroup?: TableRowActionGroupRenderer<TType>[];
+    rowActionsLength?: number;
+    rowExpansionRenderer?: TableRowExpansionRenderer<TType>;
+    shortcuts?: TableShortcuts<TType>;
+    onRowClick?: TableRowClickHandler<TType>;
+    onRowGoto?: TableRowGotoHandler;
+    onRowSelect?: TableRowSelectHandler<TType>;
+    onChangeFilter?: TableFilterHandler;
+    onChangeSearch?: TODO;
+    onChangeSettings?: TableSettingsHandler;
+    onChangeSort?: TableSortHandler;
+};
+export interface TableClientProps<TType = unknown> extends TableCommonProps<TType> {
+    length?: never;
+    loadAll?: never;
+    loadPage?: never;
+    pageSize?: never;
+}
+export interface TableServerProps<TType = unknown> extends TableCommonProps<TType> {
+    length: number | undefined;
+    loadAll: TableServerLoadAllHandler;
+    loadPage: TableServerLoadPageHandler;
+    pageSize?: number;
+}
+export declare type TableProps<TType = unknown> = TableClientProps<TType> | TableServerProps<TType>;
+export declare type TableColumnProps<TType = unknown> = ValueOf<{
+    [Key in keyof TType]: {
+        accessor?: Key;
+        id: string;
+    } & {
+        renderer?: TableColumnRenderer<TType, TType[Key]>;
+        /** Renderer to use if the cell is an aggregate cell and part of a grouped row */
+        aggregate?: TableColumnRendererAggregate<TType, TType[Key]>;
+        control?: TableColumnRendererControl<TType>;
+        footer?: TableColumnRendererFooter<TType[Key]>;
+        header: TableColumnRendererHeader;
+        /** Aggregation function to be used when the column is part of a grouped row */
+        aggregationFn?: 'auto' | ReactTableBuiltInAggregationFn;
+        align?: TableColumnAlignment;
+        className?: TableColumnClassNameHandler<TType>;
+        dataType?: TableColumnDataType;
+        defaultHidden?: boolean;
+        defaultWidth?: TableColumnWidth;
+        enableFiltering?: boolean;
+        enableGrouping?: boolean;
+        enableHiding?: boolean;
+        enableOrdering?: boolean;
+        enablePrinting?: boolean;
+        enableResizing?: boolean;
+        enableSearch?: boolean;
+        enableSorting?: boolean;
+        enableTruncate?: boolean;
+        filters?: TableFilterComparator[];
+        headerClassName?: string;
+        menu?: TableColumnMenu;
+        minWidth?: number;
+        sort?: TableColumnSortDirection;
+        sortFn?: TableColumnSortFn<TType>;
+        tooltip?: string;
+    };
+}>;
+export declare type TableGroupProps = {
+    children: (JSX.Element | boolean | null | undefined)[];
+    header: string;
+    id: string;
+};
+export {};

package/dist/primitives/Table/useTableManager/features/useTableRowActive.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { TableRef, TableScrollToIndexHandler } from '../../types';
+export declare function useTableRowActive(isEnabled?: boolean, initialRowActiveIndex?: number): {
+    isEnabled: boolean;
+    rowActiveIndex: number | undefined;
+    setRowActiveIndex: React.Dispatch<React.SetStateAction<number | undefined>>;
+    isHoverStatePaused: boolean;
+    setHoverStatePaused: React.Dispatch<React.SetStateAction<boolean>>;
+    handleFocus: (event: React.FocusEvent, length: number, scrollToIndex: TableScrollToIndexHandler) => void;
+    handleKeyDown: (event: KeyboardEvent, length: number, scrollToIndex: TableScrollToIndexHandler, tableRef?: React.RefObject<TableRef> | undefined) => void;
+};

package/dist/primitives/Table/useTableManager/types.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="react" />
+import { HeaderContext as ReactTableHeaderContext, CellContext as ReactTableCellContext, ColumnMeta as ReactTableColumnMeta } from '@tanstack/react-table';
+export declare type useTableManagerInternalColumn<TType = unknown> = {
+    header?: (info: ReactTableHeaderContext<TType, unknown>) => JSX.Element | string | null;
+    renderer: (info: ReactTableCellContext<TType, unknown>) => JSX.Element | string | null;
+    meta?: ReactTableColumnMeta<TType, unknown>;
+    size?: number;
+};
+export declare type useTableManagerInternalColumns<TType = unknown> = {
+    rowActions?: useTableManagerInternalColumn<TType>;
+    rowExpansion?: useTableManagerInternalColumn<TType>;
+    rowSelection?: useTableManagerInternalColumn<TType>;
+};

package/dist/primitives/Table/useTableManager/useTableManager.d.ts

@@ -0,0 +1,59 @@
+/// <reference types="react" />
+import { TableMeta as ReactTableMeta, RowData } from '@tanstack/react-table';
+import { TableColumnAlignment, TableColumnClassNameHandler, TableColumnDataType, TableColumnMenu, TableColumnRendererControl, TableFilterComparator, TableRef, TableProps } from '../types';
+import { useTableColumnFreezing } from './features/useTableColumnFreezing';
+import { useTableColumnOrdering } from './features/useTableColumnOrdering';
+import { useTableFooter } from './features/useTableFooter';
+import { useTableFontSize } from './features/useTableFontSize';
+import { useTablePrinting } from './features/useTablePrinting';
+import { useTableRowActions } from './features/useTableRowActions';
+import { useTableRowActive } from './features/useTableRowActive';
+import { useTableRowClick } from './features/useTableRowClick';
+import { useTableRowExpansion } from './features/useTableRowExpansion';
+import { useTableRowGoto } from './features/useTableRowGoto';
+import { useTableRowGroups } from './features/useTableRowGroups';
+import { useTableRowHeight } from './features/useTableRowHeight';
+import { useTableRowSelection } from './features/useTableRowSelection';
+import { useTableSearch } from './features/useTableSearch';
+import { useTableServerLoading } from './features/useTableServerLoading';
+import { useTableManagerInternalColumns } from './types';
+declare module '@tanstack/table-core' {
+    interface TableMeta<TData extends RowData> {
+        columnFreezing: ReturnType<typeof useTableColumnFreezing>;
+        columnOrdering: ReturnType<typeof useTableColumnOrdering>;
+        fontSize: ReturnType<typeof useTableFontSize>;
+        footer: ReturnType<typeof useTableFooter>;
+        length: number;
+        printing: ReturnType<typeof useTablePrinting>;
+        rowActions: ReturnType<typeof useTableRowActions>;
+        rowActive: ReturnType<typeof useTableRowActive>;
+        rowClick: ReturnType<typeof useTableRowClick>;
+        rowExpansion: ReturnType<typeof useTableRowExpansion>;
+        rowGoto: ReturnType<typeof useTableRowGoto>;
+        rowGroups: ReturnType<typeof useTableRowGroups>;
+        rowHeight: ReturnType<typeof useTableRowHeight>;
+        rowSelection: ReturnType<typeof useTableRowSelection>;
+        search: ReturnType<typeof useTableSearch>;
+        server: ReturnType<typeof useTableServerLoading>;
+    }
+    interface ColumnMeta<TData extends RowData, TValue> {
+        align?: TableColumnAlignment;
+        className?: TableColumnClassNameHandler<TData>;
+        control?: TableColumnRendererControl<TData>;
+        dataType?: TableColumnDataType;
+        enableOrdering?: boolean;
+        enablePrinting?: boolean;
+        enableTruncate?: boolean;
+        filters?: TableFilterComparator[];
+        header: string;
+        headerClassName?: string;
+        menu?: TableColumnMenu;
+        tooltip?: string;
+    }
+}
+export declare function useTableManager<TType = unknown, TMeta = {}>(props: TableProps<TType>, ref: React.RefObject<TableRef>, meta?: Partial<ReactTableMeta<TType>> & TMeta, internalColumns?: useTableManagerInternalColumns<TType>): {
+    id: string;
+    instance: import("@tanstack/react-table").Table<TType>;
+    meta: ReactTableMeta<TType> & TMeta;
+    state: import("@tanstack/react-table").TableState;
+};

package/dist/primitives/Table/useTableManager/util/settings.d.ts

@@ -0,0 +1,12 @@
+import { Table as ReactTable } from '@tanstack/react-table';
+export declare function getSettings<TType = unknown>(table: ReactTable<TType>): {
+    columnOrder: import("@tanstack/react-table").ColumnOrderState | undefined;
+    columnPinning: import("@tanstack/react-table").ColumnPinningState;
+    columnSizing: Record<string, number>;
+    columnVisibility: Record<string, boolean> | undefined;
+    excludeUnmatchedRecordsInSearch: any;
+    fontSize: "small" | "medium" | "large" | undefined;
+    grouping: import("@tanstack/react-table").GroupingState | undefined;
+    rowHeight: "medium" | "short" | "tall" | "extra-tall" | undefined;
+    sorting: import("@tanstack/react-table").SortingState;
+};