@economic/taco 2.25.1 → 2.26.1

package/dist/components/Provider/Localization.d.ts

@@ -11,12 +11,13 @@ import { HeaderTexts } from '../Header/Header';
 import { HangerTexts } from '../Hanger/Hanger';
 import { SelectTexts } from '../Select/Select';
 import { TourTexts } from '../Tour/Tour';
-import { TableTexts } from '../Table/Table';
+import { LegacyTableTexts } from '../Table/Table';
 import { Table3Texts } from '../Table3/types';
 import { SearchInputTexts } from '../SearchInput/SearchInput';
 import { Select2Texts } from '../Select2/Select2';
 import { BannerTexts } from '../Banner/Banner';
 import { DrawerTexts } from '../Drawer/Drawer';
+import { TableTexts } from '../../primitives/Table/types';
 export declare type LocalizationTexts = {
     /** Localized texts and aria-labels for [Banner](component:banner) component */
     banner: BannerTexts;
@@ -37,6 +38,8 @@ export declare type LocalizationTexts = {
     /** Localized texts and aria-labels for [Pagination](component:pagination) component */
     pagination: PaginationTexts;
     /** Localized texts and aria-labels for [Table](component:table) component */
+    legacyTable: LegacyTableTexts;
+    /** Localized texts and aria-labels for [Table](primitive:table) component */
     table: TableTexts;
     /** Localized texts and aria-labels for [Table3](component:table3) component */
     table3: Table3Texts;
@@ -127,7 +130,7 @@ export declare const defaultLocalisationTexts: {
             pageX: string;
         };
     };
-    table: {
+    legacyTable: {
         actions: string;
         edit: string;
         copy: string;
@@ -135,7 +138,7 @@ export declare const defaultLocalisationTexts: {
         newSubRow: string;
         loading: string;
     };
-    table3: {
+    table: {
         columns: {
             actions: {
                 tooltip: string;
@@ -154,7 +157,6 @@ export declare const defaultLocalisationTexts: {
                 filter: string;
                 freezeFirstColumn: string;
                 freezeUptoColumn: string;
-                freezeColumns: (count?: number) => string;
                 gotoRow: string;
                 hideColumn: string;
                 unfreezeColumns: string;
@@ -181,36 +183,6 @@ export declare const defaultLocalisationTexts: {
             button: string;
             noResults: string;
         };
-        editing: {
-            actions: {
-                tooltip: string;
-                save: string;
-                clear: string;
-                exit: string;
-            };
-            buttons: {
-                edit: {
-                    tooltip: string;
-                };
-            };
-            rowIndicator: {
-                rowWillMove: string;
-                rowWillBeHidden: string;
-                rowWillMoveReasonSearch: string;
-                rowWillMoveReasonFilter: string;
-                rowWillMoveReasonSorting: string;
-            };
-            saving: {
-                progress: string;
-                complete: string;
-            };
-            clearChangesConfirmationDialog: {
-                title: string;
-                description: string;
-                cancel: string;
-                confirm: string;
-            };
-        };
         filters: {
             button: string;
             buttons: {
@@ -310,36 +282,56 @@ export declare const defaultLocalisationTexts: {
             excludeUnmatchedResults: string;
             placeholder: string;
         };
-        shortcuts: {
-            tooltip: string;
-            search: string;
-            filter: string;
-            previousRow: string;
-            nextRow: string;
-            editCell: string;
-            previousColumn: string;
-            nextColumn: string;
-            rowClick: string;
-            selectRow: string;
-            selectAllRows: string;
-            expandRow: string;
-            collapseRow: string;
-        };
         otherOptions: {
             tooltip: string;
         };
-        validation: {
-            index: string;
-            alert: {
-                unsavedEntries: (count?: number) => "unsaved entry:" | "unsaved entries:";
-                incompleteAndHavntBeenSaved: (count?: number) => "is incomplete and haven’t been saved." | "are incomplete and haven’t been saved.";
+    };
+    table3: {
+        editing: {
+            actions: {
+                tooltip: string;
+                save: string;
+                clear: string;
+                exit: string;
+            };
+            buttons: {
+                edit: {
+                    tooltip: string;
+                };
             };
-            resetFiltersDialog: {
+            clearChangesConfirmationDialog: {
                 title: string;
                 description: string;
                 cancel: string;
                 confirm: string;
             };
+            rowIndicator: {
+                rowWillMove: string;
+                rowWillBeHidden: string;
+                rowWillMoveReasonSearch: string;
+                rowWillMoveReasonFilter: string;
+                rowWillMoveReasonSorting: string;
+            };
+            saving: {
+                progress: string;
+                complete: string;
+            };
+            validation: {
+                alert: {
+                    titleOne: string;
+                    titlePlural: string;
+                    messageOne: string;
+                    messagePlural: string;
+                    messageRow: string;
+                    messageAnd: string;
+                };
+                resetFiltersDialog: {
+                    title: string;
+                    description: string;
+                    cancel: string;
+                    confirm: string;
+                };
+            };
         };
     };
     searchInput: {

package/dist/components/Report/Report.d.ts

@@ -1,23 +1,9 @@
 import React from 'react';
-import { ReportColumnProps, ReportGroupProps, ReportProps } from './types';
-import { TableRef } from '../../primitives/Table/types';
-import './style.css';
-declare function Column<TType = unknown>(_: ReportColumnProps<TType>): null;
-declare function Group(_: ReportGroupProps): null;
-export declare const Report: (<TType = unknown>(props: (import("../../primitives/Table/types").TableClientProps<TType> & {
-    customSettings?: import("./types").ReportCustomSettingsRenderer | undefined;
-    emptyState?: import("./types").ReportEmptyStateRenderer | undefined;
-    toolbarLeft?: JSX.Element | undefined;
-    toolbarRight?: JSX.Element | undefined;
-    toolbarPanel?: JSX.Element | undefined;
-} & React.RefAttributes<TableRef>) | (import("../../primitives/Table/types").TableServerProps<TType> & {
-    customSettings?: import("./types").ReportCustomSettingsRenderer | undefined;
-    emptyState?: import("./types").ReportEmptyStateRenderer | undefined;
-    toolbarLeft?: JSX.Element | undefined;
-    toolbarRight?: JSX.Element | undefined;
-    toolbarPanel?: JSX.Element | undefined;
-} & React.RefAttributes<TableRef>)) => JSX.Element) & {
+import { TableColumnProps, TableGroupProps, TableProps, TableRef } from '../../primitives/Table/types';
+declare function Column<TType = unknown>(_: TableColumnProps<TType>): null;
+declare function Group(_: TableGroupProps): null;
+export declare const Report: (<TType = unknown>(props: (import("../../primitives/Table/types").TableClientProps<TType> & React.RefAttributes<TableRef>) | (import("../../primitives/Table/types").TableServerProps<TType> & React.RefAttributes<TableRef>)) => JSX.Element) & {
     Column: typeof Column;
     Group: typeof Group;
 };
-export * from './types';
+export {};

package/dist/components/Report/useReport.d.ts

@@ -1,9 +1,5 @@
 import React from 'react';
-import { ReportProps } from './types';
 import { TableRef } from '../../primitives/Table/types';
-export declare function useReport<TType>(props: ReportProps<TType>, ref: React.RefObject<TableRef>): {
-    id: string;
-    instance: import("@tanstack/table-core").Table<TType>;
-    meta: import("@tanstack/table-core").TableMeta<TType>;
-    state: import("@tanstack/table-core").TableState;
-};
+import { useTableReturnValue } from '../../primitives/Table/Core/useTable';
+import { TableProps } from '../../primitives/Table/types';
+export declare function useReport<TType>(props: TableProps<TType>, ref: React.Ref<TableRef>): useTableReturnValue<TType>;

package/dist/components/Select2/hooks/useChildren.d.ts

@@ -1,7 +1,8 @@
 import React from 'react';
 import { Select2OptionProps } from '../components/Option';
+import { Select2GroupProps } from '../Select2';
 import { Select2Children, Select2OptionValue, Select2Value } from '../types';
-export declare const isGroup: (child: React.ReactElement) => boolean;
+export declare const isGroup: (child: React.ReactElement<Select2OptionProps> | React.ReactElement<Select2GroupProps>) => child is React.ReactElement<Select2GroupProps, string | ((props: any) => React.ReactElement<any, any> | null) | (new (props: any) => React.Component<any, any, any>)>;
 export declare type useChildrenArgs = {
     children: Select2Children;
     emptyValue?: Select2OptionValue;

package/dist/components/Table/Table.d.ts

@@ -1,10 +1,10 @@
 export * from './components/Table';
 export * from './components/PaginatedTable';
 export * from './components/WindowedTable';
-export type { PaginationHandler, Row, RowIndexPath, RowClickHandler, RowDragHandler, RowCreateHandler, RowCopyHandler, RowDeleteHandler, RowActionHandler, SelectedRowsHandler, SelectedRowsState, SortDirection, SortHandler, SortRule, SortTypes, LegacyTableCell as TableCell, LegacyTableColumnProps as TableColumnProps, LegacyTableGroupProps as TableGroupProps, LegacyTableProps as TableProps, LegacyTableRow as TableRow, LegacyTableRef as TableRef, } from './types';
+export type { PaginationHandler, Row, RowIndexPath, RowClickHandler, RowDragHandler, RowCreateHandler, RowCopyHandler, RowDeleteHandler, RowActionHandler, SelectedRowsHandler, SelectedRowsState, SortDirection, SortHandler, SortRule, SortTypes, LegacyTableCell, LegacyTableColumnProps, LegacyTableGroupProps, LegacyTableProps, LegacyTableRow, LegacyTableRef, } from './types';
 export * from './util/rowIndexPath';
 export * from './hooks/useRowCreation';
-export declare type TableTexts = {
+export declare type LegacyTableTexts = {
     actions: string;
     edit: string;
     copy: string;

package/dist/components/Table3/Table3.d.ts

@@ -1,19 +1,19 @@
 import React from 'react';
-import { Table3ColumnProps, Table3GroupProps, Table3Props, Table3Ref } from './types';
+import { TableColumnProps, TableGroupProps, TableRef } from '../../primitives/Table/types';
+import { Table3Props } from './types';
 import './style.css';
-declare function Column<TType = unknown>(_: Table3ColumnProps<TType>): null;
-declare namespace Column {
-    var displayName: string;
-}
-declare function Group(_: Table3GroupProps): null;
-declare namespace Group {
-    var displayName: string;
-}
-declare type Table3WithStatics = (<TType = unknown>(props: Table3Props<TType> & React.RefAttributes<Table3Ref>) => JSX.Element) & {
+declare function Column<TType = unknown>(_: TableColumnProps<TType>): null;
+declare function Group(_: TableGroupProps): null;
+export declare const Table3: (<TType = unknown>(props: (import("../../primitives/Table/types").TableClientProps<TType> & {
+    enableEditing?: boolean | undefined;
+    onSave?: import("./types").TableEditingSaveHandler<TType> | undefined;
+    validator?: import("./types").TableEditingValidatorFn<TType> | undefined;
+} & React.RefAttributes<TableRef>) | (import("../../primitives/Table/types").TableServerProps<TType> & {
+    enableEditing?: boolean | undefined;
+    onSave?: import("./types").TableEditingSaveHandler<TType> | undefined;
+    validator?: import("./types").TableEditingValidatorFn<TType> | undefined;
+} & React.RefAttributes<TableRef>)) => JSX.Element) & {
     Column: typeof Column;
     Group: typeof Group;
 };
-export declare const Table3: Table3WithStatics;
-export { useTable3DataLoader } from './hooks/useTableDataLoader';
-export type { useTable3DataFetcher, useTable3DataOptions, useTable3DataFetcherValues as useTableDataValues, } from './hooks/useTableDataLoader';
-export type { Table3Ref, Table3Props, Table3Preset, Table3Settings, Table3SettingsHandler, Table3RowHeight, Table3FilterComparator, Table3FilterHandler, Table3LoadPageHandler, Table3LoadAllHandler, Table3RowGotoHandler, Table3SortHandler, Table3Shortcuts, Table3ShortcutHandlerFn, Table3ShortcutHandlerObject, Table3SortDirection, Table3SortFn, Table3RowActionRenderer, Table3RowSelectionHandler, Table3RowExpansionRenderer, Table3RowDropHandler, Table3RowDragHandler, Table3RowClickHandler, Table3ColumnProps, Table3ColumnAlignment, Table3ColumnDataType, Table3ColumnHeaderMenu, Table3ColumnClassNameHandler, Table3ColumnFooterRenderer, Table3ColumnRenderer, Table3ColumnControlRenderer, Table3ColumnControlProps, } from './types';
+export {};

package/dist/components/Table3/components/Columns/Cell/Cell.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import { TableCellRendererProps } from '../../../../../primitives/Table/Core/types';
+export declare function Cell<TType = unknown>(props: TableCellRendererProps<TType>): JSX.Element;

package/dist/components/Table3/components/Columns/Cell/Editing/RowMoveIndicator.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { Cell as ReactTableCell } from '@tanstack/react-table';
+declare type TableRowMoveIndicatorProps<TType = unknown> = {
+    cell: ReactTableCell<TType, unknown>;
+    cellRef: React.RefObject<HTMLTableCellElement>;
+    isActiveRow: boolean;
+};
+export declare function RowMoveIndicator<TType = unknown>(props: TableRowMoveIndicatorProps<TType>): JSX.Element | null;
+export {};

package/dist/components/Table3/components/Columns/Cell/Editing/TextareaWithAutosizing.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { TableFontSize } from '../../../../../../primitives/Table/types';
+export declare const TextareaWithAutosizing: React.ForwardRefExoticComponent<React.TextareaHTMLAttributes<HTMLTextAreaElement> & {
+    highlighted?: boolean | undefined;
+    invalid?: boolean | undefined;
+    value?: string | undefined;
+} & {
+    fontSize: TableFontSize;
+    isTruncated: boolean;
+} & React.RefAttributes<HTMLTextAreaElement>>;

package/dist/components/Table3/components/Columns/Cell/EditingControlCell.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import { TableCellRendererProps } from '../../../../../primitives/Table/Core/types';
+export declare function EditingControlCell<TType = unknown>(props: TableCellRendererProps<TType>): JSX.Element;

package/dist/components/Table3/components/Columns/Cell/EditingDisplayCell.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import { TableCellRendererProps } from '../../../../../primitives/Table/Core/types';
+export declare const EditingDisplayCell: <TType = unknown>(props: TableCellRendererProps<TType>) => JSX.Element;

package/dist/components/Table3/components/Columns/Cell/util.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { TableCellRendererProps } from '../../../../../primitives/Table/Core/types';
+export declare function useEditingCellAutofocus<TType = unknown>(props: TableCellRendererProps<TType>): (event: React.FocusEvent<HTMLTableCellElement>) => void;

package/dist/components/Table3/components/Columns/Internal/EditingActionsMenu.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+declare type EditingActionMenuProps = {
+    hasChanges: boolean;
+    hasErrors: boolean;
+    onClear: () => void;
+    onExit: () => void;
+    onSave: () => Promise<void>;
+};
+export declare function EditingActionMenu(props: EditingActionMenuProps): JSX.Element;
+export {};

package/dist/components/Table3/components/Editing/Alert.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import { Table as ReactTable } from '@tanstack/react-table';
+import { ScrollToOptions as ReactVirtualScrollToOptions } from '@tanstack/react-virtual';
+import { AlertProps as BaseAlertProps } from '../../../Alert/Alert';
+import { TableRef } from '../../../../primitives/Table/types';
+declare type AlertProps<TType = unknown> = Omit<BaseAlertProps, 'children'> & {
+    scrollToIndex: (index: number, options: ReactVirtualScrollToOptions) => void;
+    table: ReactTable<TType>;
+    tableRef: React.RefObject<TableRef>;
+};
+export declare function Alert<TType = unknown>(props: AlertProps<TType>): JSX.Element;
+export {};

package/dist/components/Table3/components/Row/Editing/SaveStatus.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="react" />
+import { Table as ReactTable } from '@tanstack/react-table';
+declare type SaveStatusProps<TType = unknown> = {
+    rowId: string;
+    table: ReactTable<TType>;
+};
+export declare function SaveStatus<TType = unknown>(props: SaveStatusProps<TType>): JSX.Element;
+export {};

package/dist/components/Table3/components/Row/Row.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import { DisplayRowProps } from '../../../../primitives/Table/Core/components/Row/BuiltIns/DisplayRow';
+export declare function Row<TType = unknown>(props: DisplayRowProps<TType>): JSX.Element;

package/dist/components/Table3/components/Toolbar/Editing/Editing.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { Table as ReactTable } from '@tanstack/react-table';
+declare type EditingProps<TType = unknown> = React.HTMLAttributes<HTMLButtonElement> & {
+    scrollToIndex: any;
+    table: ReactTable<TType>;
+};
+export declare function Editing<TType = unknown>(props: EditingProps<TType>): JSX.Element;
+export {};

package/dist/components/Table3/features/useTableEditing.d.ts

@@ -0,0 +1,46 @@
+import React from 'react';
+import { Cell as ReactTableCell, Table as ReactTable } from '@tanstack/react-table';
+import { TableEditingSaveHandler, TableEditingValidatorFn } from '../types';
+import { TableRef } from '../../../primitives/Table/types';
+export declare function useTableEditing<TType = unknown>(isEnabled: boolean | undefined, handleSave: TableEditingSaveHandler<TType> | undefined, validator: TableEditingValidatorFn<TType> | undefined): {
+    handleBlur: (event: React.FocusEvent<HTMLTableElement>) => void;
+    getCellValue: <T extends TType>(cell: ReactTableCell<T, unknown>) => unknown;
+    getCellError: <T_1 extends TType>(cell: ReactTableCell<T_1, unknown>) => string | undefined;
+    setCellValue: <T_2 extends TType>(cell: ReactTableCell<T_2, unknown>, change: unknown, rowIndex: number) => void;
+    validateCell: <T_3 extends TType>(cell: ReactTableCell<T_3, unknown>) => Promise<void>;
+    hasChanges: (rowId?: string | undefined) => boolean;
+    hasErrors: <T_4 extends TType>(table: ReactTable<T_4>, tableRef: React.RefObject<TableRef>) => number | false;
+    getErrors: <T_5 extends TType>() => {
+        rowId: string;
+        pendingChange: PendingChange<T_5>;
+    }[];
+    saveChanges: (rowId?: string | undefined) => Promise<void>;
+    resetChanges: (rowId: string) => void;
+    hasRowErrors: (rowId: string) => boolean;
+    hasRowErrorsSeen: (rowId: string) => boolean;
+    setRowErrorsSeen: (rowId: string) => void;
+    getRowSaveStatus: (rowId: string) => false | "pending" | "complete";
+    setRowSaveStatus: (rowId: string, status: "pending" | "complete" | undefined) => void;
+    getRowMoveReason: (rowId: string) => "search" | "sorting" | "filter" | undefined;
+    isEnabled: boolean;
+    isEditing: boolean;
+    isDetailedMode: boolean;
+    toggleDetailedMode: React.Dispatch<React.SetStateAction<boolean>>;
+    toggleEditing: React.Dispatch<React.SetStateAction<boolean>>;
+    lastFocusedCellIndex: number | undefined;
+    setLastFocusedCellIndex: (index: number | undefined) => void;
+};
+declare type SaveState = 'pending' | 'complete';
+declare type PendingChange<TType = unknown> = Partial<TType> & {
+    _meta: {
+        original: TType;
+        moveReason: Record<string, 'search' | 'sorting' | 'filter'>;
+        errors: {
+            row: string;
+            cells: Record<string, string>;
+            hasShownErrorAlert: boolean;
+        };
+        status?: SaveState;
+    };
+};
+export {};

package/dist/components/Table3/listeners/useTableEditingListener.d.ts

@@ -0,0 +1,2 @@
+import { Table as ReactTable } from '@tanstack/react-table';
+export declare function useTableEditingListener<TType = unknown>(table: ReactTable<TType>): void;