@dcs-tech/ui 0.10.0 → 0.11.0

package/dist/types/components/DataTable/cellSelection/useCellSelection.d.ts

@@ -0,0 +1,63 @@
+import type React from 'react';
+import { type RefObject } from 'react';
+import { type CellRangeFigureId, type CellRangeFigures } from '../../../core/logic';
+import type { DisplayItem } from '../grouping/groupModel';
+import type { DataTableCellPaste, DataTableCellRange, DataTableCellSelectionConfig } from '../types';
+import { type CellRangeStore } from './cellRangeStore';
+export interface ResolvedCellSelection {
+    multiRange: boolean;
+    copyHeaders: boolean;
+    figures: CellRangeFigureId[];
+    onCellRangesChange?: (ranges: DataTableCellRange[]) => void;
+    onCellsPaste?: (event: {
+        cells: DataTableCellPaste[];
+    }) => void;
+}
+export declare function resolveCellSelection(cfg: boolean | DataTableCellSelectionConfig | undefined): ResolvedCellSelection | null;
+export interface CellRangeSummary {
+    cells: number;
+    rows: number;
+    columns: number;
+    ranges: number;
+    figures: CellRangeFigures;
+}
+export interface CellSelectionHost<R> {
+    config: ResolvedCellSelection | null;
+    areaRef: RefObject<HTMLElement | null>;
+    items: DisplayItem<R>[];
+    columns: string[];
+    rowId: (row: R) => string;
+    original: (row: R) => unknown;
+    valueOf: (row: R, column: string) => unknown;
+    isNumber: (column: string) => boolean;
+    textOf: (row: R, column: string) => string;
+    headerOf: (column: string) => string;
+    canCopy: boolean;
+    copy: (text: string, cells: number) => void;
+    selectRows: (ids: string[]) => void;
+    pasted: (cells: number) => void;
+    activeKey: string | null;
+    activeCol: number;
+    resetKey?: string;
+}
+export interface CellKeyContext {
+    key: string;
+    col: number;
+    row: boolean;
+    focus: (key: string, col: number) => void;
+}
+export declare function useCellSelection<R>(host: CellSelectionHost<R>): {
+    enabled: boolean;
+    store: CellRangeStore;
+    onKey: (e: React.KeyboardEvent, at: CellKeyContext) => boolean;
+    getCellRanges: () => DataTableCellRange[];
+    clearCellRanges: () => void;
+    summary: (limit?: number) => CellRangeSummary | null | "large";
+    copyRanges: () => void;
+    pasteText: (text: string) => boolean;
+    ownsLongPress: (t: EventTarget | null) => boolean;
+    lastCell: () => {
+        row: R;
+        column: string;
+    } | null;
+};

package/dist/types/components/DataTable/data/listDelta.d.ts

@@ -0,0 +1,27 @@
+export interface ListDelta<E> {
+    readonly removed: readonly E[];
+    readonly removedAt: readonly number[];
+    readonly added: readonly E[];
+    readonly addedAt: readonly number[];
+}
+export declare const NO_CHANGE: ListDelta<never>;
+export declare const deltaSize: (d: ListDelta<unknown>) => number;
+export declare function recordListDelta<E>(next: readonly E[], before: readonly E[], delta: ListDelta<E>): void;
+export declare function listDeltaBetween<E>(next: readonly E[], before: readonly E[] | null | undefined): ListDelta<E> | null;
+export declare function composeDeltas<E>(ab: ListDelta<E>, bc: ListDelta<E>): ListDelta<E>;
+export declare function placesIn<T>(list: readonly T[], wanted: readonly T[]): number[];
+export declare function patchList<E, O>(before: readonly O[], delta: ListDelta<E>, make: (element: E, at: number) => O): O[];
+export declare function mapDelta<E, O>(delta: ListDelta<E>, before: readonly O[], out: readonly O[]): ListDelta<O>;
+export declare function deltaOfElements<E>(before: readonly E[], next: readonly E[], removed: readonly E[], added: readonly E[]): ListDelta<E>;
+export interface MappedList<E, O> {
+    source: readonly E[] | null;
+    out: O[];
+}
+export declare function newMappedList<E, O>(): MappedList<E, O>;
+export declare function mapList<E, O>(cache: MappedList<E, O>, source: readonly E[], make: (element: E, at: number) => O, opts?: {
+    reuse?: boolean;
+}): O[];
+export declare function patchFilteredList<T>(before: {
+    data: readonly T[];
+    out: T[];
+}, data: readonly T[], delta: ListDelta<T>, test: (element: T) => boolean, known: WeakMap<object, boolean>): T[] | null;

package/dist/types/components/DataTable/data/rowLineage.d.ts

@@ -0,0 +1,3 @@
+export declare function markRowsChangedFrom(next: readonly unknown[], from: readonly unknown[]): void;
+export declare function markRowsTakenFrom(next: readonly unknown[], from: readonly unknown[]): void;
+export declare function rowObjectsUnchanged(next: readonly unknown[], before: readonly unknown[]): boolean;

package/dist/types/components/DataTable/data/rowModels.d.ts

@@ -0,0 +1,9 @@
+import { type RowData, type RowModel, type Table } from '@tanstack/react-table';
+export declare function getReusingCoreRowModel<TData extends RowData>(): (table: Table<TData>) => () => RowModel<TData>;
+export declare function getPatchingFilteredRowModel<TData extends RowData>(): (table: Table<TData>) => () => RowModel<TData>;
+export type HeldRows = ReadonlyMap<string, string | null>;
+export declare function placeHeldRows<R extends {
+    id: string;
+}>(rows: R[], held: HeldRows | null | undefined): R[];
+export declare function getMergingSortedRowModel<TData extends RowData>(getHeld?: () => HeldRows | null | undefined): (table: Table<TData>) => () => RowModel<TData>;
+export declare function mergeSorted<T>(a: T[], b: T[], compare: (x: T, y: T) => number): T[];

package/dist/types/components/DataTable/data/rowTransaction.d.ts

@@ -0,0 +1,9 @@
+import type { DataTableRowTransaction } from '../types';
+export declare const TRANSACTION_WAIT_MS = 50;
+export declare function mergeRowTransactions<T>(txs: Array<DataTableRowTransaction<T>>): Array<DataTableRowTransaction<T>>;
+export interface RowTransactionResult {
+    added: string[];
+    updated: string[];
+    removed: string[];
+}
+export declare function applyRowTransaction<T>(rows: T[], tx: DataTableRowTransaction<T>, rowKey: string | undefined, out?: RowTransactionResult): T[];

package/dist/types/components/DataTable/data/useServerData.d.ts

@@ -1,4 +1,5 @@
-import type { DataTableDataSource, DataTableQuery } from '../types';
+import type { DataTableDataSource, DataTableQuery, DataTableRowTransaction } from '../types';
+import { type RowTransactionResult } from './rowTransaction';
 export interface ServerDataState<TData> {
     rows: TData[];
     total: number;
@@ -7,6 +8,7 @@ export interface ServerDataState<TData> {
     fetching: boolean;
     error: unknown;
     refetch: () => void;
+    applyTransaction: (tx: DataTableRowTransaction<TData>, rowKey: string | undefined) => RowTransactionResult | null;
     tick: number;
 }
 export declare function filterPartOf(q: DataTableQuery): {

package/dist/types/components/DataTable/export/exportCells.d.ts

@@ -1,4 +1,5 @@
-import type { DataTableCellStyle, DataTableColumn, DataTableExportFormat } from '../types';
+import type { DataTableCellStyle, DataTableColumn, DataTableColumnGroup, DataTableExportFormat } from '../types';
+import type { XlsxHeaderGroupRow } from '../../../core/types';
 import { type ColumnTextContext } from '../columnValue';
 import type { ColumnMeta } from './exportEngine';
 export interface ExportRowsForFormat {
@@ -10,4 +11,6 @@ export interface ExportRowsForFormat {
     totals: Record<string, any> | null;
 }
 export declare function uniqueHeaders(names: string[]): string[];
-export declare function exportRowsFor<TData>(format: DataTableExportFormat, data: TData[], columns: DataTableColumn<TData>[], visibleKeys: string[], ctx: ColumnTextContext, totalKeys?: string[], totalLabel?: string): ExportRowsForFormat;
+export declare function exportRowsFor<TData>(format: DataTableExportFormat, data: TData[], columns: DataTableColumn<TData>[], visibleKeys: string[], ctx: ColumnTextContext, totalKeys?: string[], totalLabel?: string, inTotals?: (row: TData) => boolean): ExportRowsForFormat;
+export declare function exportHeaderGroups(groups: DataTableColumnGroup[] | undefined, keys: readonly string[]): XlsxHeaderGroupRow[];
+export declare function withPinnedExportRows(data: ExportRowsForFormat, top: ExportRowsForFormat | null, bottom: ExportRowsForFormat | null): ExportRowsForFormat;

package/dist/types/components/DataTable/export/exportEngine.d.ts

@@ -1,4 +1,6 @@
-import type { FileTask, PdfTaskFonts, XlsxWorkbookSpec } from '../../../core/types';
+import type { FileTask, PdfTaskFonts, XlsxHeaderGroupRow, XlsxWorkbookSpec } from '../../../core/types';
+export type ExportHeaderGroups = XlsxHeaderGroupRow[];
+export declare function headerGroupCells(groups: XlsxHeaderGroupRow, width: number): string[];
 import { type DataTableExportFormat, type DataTableExportMetadata, type DataTableXlsxStyle, type DataTablePdfConfig, type DataTableColumn, type DataTableCellStyle, type DataTableExportSummary } from '../types';
 export { autoFormatValue, prepareExportRows, buildBusinessMeta } from './exportRows';
 export { formatContextLine, formatMetadataLines } from './exportContext';
@@ -13,7 +15,7 @@ export interface ColumnMeta {
     cellStyle?: (value: any, row: any) => DataTableCellStyle | undefined;
 }
 export declare function buildColumnMeta(columns: DataTableColumn[], headers: string[]): ColumnMeta[];
-export declare function generateCSV(headers: string[], rows: Record<string, any>[], totals?: Record<string, any> | null, summary?: DataTableExportSummary | null, metadata?: DataTableExportMetadata, subtitle?: string): Blob;
+export declare function generateCSV(headers: string[], rows: Record<string, any>[], totals?: Record<string, any> | null, summary?: DataTableExportSummary | null, metadata?: DataTableExportMetadata, subtitle?: string, headerGroups?: ExportHeaderGroups): Blob;
 type XlsxConfig = {
     totals?: Record<string, any> | null;
     summary?: DataTableExportSummary | null;
@@ -23,6 +25,7 @@ type XlsxConfig = {
     cellStyles?: Record<string, DataTableCellStyle>[];
     metadata?: DataTableExportMetadata;
     subtitle?: string;
+    headerGroups?: ExportHeaderGroups;
 };
 export declare function buildTableXlsxSpec(headers: string[], rows: Record<string, any>[], config?: XlsxConfig): XlsxWorkbookSpec;
 export declare function generateXLSX(headers: string[], rows: Record<string, any>[], config?: XlsxConfig): Promise<Blob>;
@@ -54,6 +57,7 @@ export declare function generateTablePDFTask(headers: string[], rows: Record<str
     metadata?: DataTableExportMetadata;
     fontFor?: PdfFontFor;
     fonts?: PdfTaskFonts;
+    headerGroups?: ExportHeaderGroups;
 }): TablePdfTask;
 export { rawDataToBlob, downloadBlob, shareFile, openPreview, executeFileAction, getExtension, getFormatLabel, } from '../vendor';
 export declare function generateXML(headers: string[], rows: Record<string, any>[], config?: {
@@ -83,4 +87,5 @@ export declare function buildExportBlob(format: DataTableExportFormat, headers:
         name: string;
         url?: string;
     };
+    headerGroups?: ExportHeaderGroups;
 }): Promise<Blob>;

package/dist/types/components/DataTable/export/useTableExport.d.ts

@@ -1,7 +1,9 @@
 import { type DataTableColumn, type DataTableExportTemplate, type DataTableExportFormat, type DataTableExportAction, type DataTableExportSettings, type DataTableActiveFilter, type DataTableExportResult, type DataTableExportConfig, type DataTablePdfConfig, type DataTableExportSummary, type DataTableExportTemplatePrefs, type DataTableExportOptions, type DataTableAllRowsResult, type DataTableAuthorize, type DataTableSelection } from '../types';
 import type { DataTableExportOptionValues } from '../types';
+import type { DataTableColumnGroup } from '../types';
 import type { ColumnTextContext } from '../columnValue';
 import { type DataTableLabels } from '../labels';
+import { type TreeLevelLook, type TreeLevels } from '../tree/treeExport';
 interface UseTableExportOptions<TData> {
     columns: DataTableColumn<TData>[];
     exportConfig?: DataTableExportConfig<TData>;
@@ -23,11 +25,25 @@ interface UseTableExportOptions<TData> {
     templatePrefs?: DataTableExportTemplatePrefs;
     exportOptions?: DataTableExportOptions;
     authorize?: DataTableAuthorize;
-    loadAllRows?: (format: DataTableExportFormat, action: DataTableExportAction, params?: Record<string, unknown>) => Promise<DataTableAllRowsResult<TData>>;
+    loadAllRows?: (format: DataTableExportFormat, action: DataTableExportAction, params?: Record<string, unknown>) => Promise<ExportRowsLoad<TData>>;
     labels?: DataTableLabels;
     locale?: string;
     text?: ColumnTextContext;
+    columnGroups?: DataTableColumnGroup[];
+    pinnedRows?: {
+        top?: TData[];
+        bottom?: TData[];
+    };
+    tree?: {
+        look: TreeLevelLook;
+        totals: 'leaves' | 'all';
+        levels?: TreeLevels<TData>;
+    };
 }
+export type ExportRowsLoad<TData> = DataTableAllRowsResult<TData> & {
+    levels?: TreeLevels<TData>;
+    treePartial?: boolean;
+};
 interface UseTableExportReturn {
     hasExport: boolean;
     hasQuickExport: boolean;

package/dist/types/components/DataTable/filters/filterRowModel.d.ts

@@ -1,6 +1,7 @@
 import { type DataTableFilterCondition, type DataTableFilterGroup, type DataTableColumn } from '../types';
 export declare const FILTER_ROW_ID_PREFIX = "filter-row:";
 export type FilterRowKind = 'text' | 'number' | 'date' | 'select' | 'boolean';
+export declare const FILTER_ROW_MIN_WIDTH: Partial<Record<FilterRowKind, number>>;
 export type FilterRowValue = {
     kind: 'text';
     text: string;

package/dist/types/components/DataTable/grouping/groupModel.d.ts

@@ -24,6 +24,9 @@ export type DisplayItem<R = any> = {
     key: string;
     row: R;
     depth: number;
+    pinned?: 'top' | 'bottom';
+    app?: boolean;
+    tree?: TreeLineState;
 } | {
     kind: 'more';
     key: string;
@@ -37,6 +40,14 @@ export type DisplayItem<R = any> = {
     node: GroupNode<R>;
     status: 'loading' | 'error';
 };
+export interface TreeLineState {
+    hasChildren: boolean;
+    expanded: boolean;
+    status?: 'loading' | 'error';
+}
+export declare function rowItemOf(row: {
+    id: string;
+}): DisplayItem;
 export interface GroupLabels {
     yes: string;
     no: string;

package/dist/types/components/DataTable/index.d.ts

@@ -1,5 +1,5 @@
 export { default as DataTable } from './DataTable';
-export type { DataTableProps, DataTableView, DataTableColumn, DataTableColumnType, DataTableNumberFormat, DataTableComponentProps, DataTableRowAction, DataTableFilterGroup, DataTableFilterCondition, DataTableActiveFilter, DataTableSingleRowView, DataTableSingleRowField, DataTableSingleRowAction, DataTableSelectionConfig, DataTableSelectionShow, DataTablePaginationConfig, DataTableSortingConfig, DataTableFilteringConfig, DataTableQuickFilter, DataTableQuickFilterMode, DataTableSavedFilter, DataTableSavedFilterIssue, DataTableViewPrefs, DataTableExportFormat, DataTableExportAction, DataTableExportTemplate, DataTableQuickExport, DataTableExportConfig, DataTableXlsxStyle, DataTablePdfConfig, DataTableExportGenerator, DataTableExportResult, DataTableExportResultStatus, DataTableExportGeneratorResult, DataTableFilenameContext, DataTableExportMeta, DataTableExportContext, DataTableExportSettings, DataTableExportPrefs, DataTableExportMetadata, DataTableExportSummary, DataTableExportSummaryTable, DataTableExportOptions, DataTableFileNameAs, DataTablePdfFonts, DataTablePdfPageSize, DataTablePdfOrientation, DataTablePdfFontSize, DataTablePdfMargins, DataTableSummaryConfig, DataTableSummaryCard, DataTableSummaryValueCard, DataTableSummaryRatioCard, DataTableSummaryBreakdownCard, DataTableSummaryTrendCard, DataTableSummaryFunnelCard, DataTableSummaryFunnelStep, DataTableSummaryValueTrend, DataTableSummaryPeriod, DataTableSummaryTrendChart, DataTableSummaryValueChart, DataTableSummaryRatioChart, DataTableSummaryAnyChart, DataTableSummaryCardRequest, DataTableSummaryPeriodCount, DataTableSummaryFigure, DataTableSummarySubline, DataTableSummaryStrip, DataTableSummaryChart, DataTableSummaryWidth, DataTableSummaryShow, DataTableSummaryPart, DataTableSummaryUserCard, DataTableSummaryPrefs, DataTableExportSummaryMode, DataTableSummaryPlacement, DataTableSummaryRequest, DataTableSummaryBucket, DataTableSummaryBreakdown, DataTableSummaryFigures, DataTableLicense, DataTableFlashColor, DataTableFlashColors, DataTableCellFlashStyle, DataTableCellStyle, DataTableLayout, DataTableCardFields, DataTableCardField, DataTableListFields, DataTableListField, DataTableRowMenuConfig, DataTableRowMenuItem, DataTableRowMenuBuiltIn, DataTableRowMenuIconAction, DataTableDetailMode, DataTableDetailContext, DataTableDetailRenderer, DataTableDisplayPrefs, DataTableDensity, DataTableFontSize, DataTableColumnWidth, DataTableActionDisplay, DataTableQuery, DataTableDataSource, DataTableRowsResult, DataTableAllRowsResult, DataTableCounts, DataTableInitialState, DataTableApi, DataTablePersistence, DataTableGate, DataTableAuthorize, DataTableManagePrefs, DataTableManageList, DataTableViewsPrefs, DataTableExportTemplatePrefs, DataTableBulkAction, DataTableBulkActionContext, DataTableBulkActionResult, DataTableBulkConfirm, DataTableToolbarAction, DataTableSelection, DataTableColumnPinning, DataTablePinningConfig, DataTableKeyboardConfig, DataTableShortcut, DataTableVirtualizeConfig, DataTableGroupingConfig, DataTableGroupPathItem, DataTableGroupResult, DataTableGroupSummaryContext, DataTableViewState, DataTableSharedView, DataTableShareAudience, DataTableSharing, } from './types';
+export type { DataTableProps, DataTableView, DataTableColumn, DataTableColumnType, DataTableNumberFormat, DataTableComponentProps, DataTableRowAction, DataTableFilterGroup, DataTableFilterCondition, DataTableActiveFilter, DataTableSingleRowView, DataTableSingleRowField, DataTableSingleRowAction, DataTableSelectionConfig, DataTableSelectionShow, DataTablePaginationConfig, DataTableSortingConfig, DataTableFilteringConfig, DataTableQuickFilter, DataTableQuickFilterMode, DataTableSavedFilter, DataTableSavedFilterIssue, DataTableViewPrefs, DataTableExportFormat, DataTableExportAction, DataTableExportTemplate, DataTableQuickExport, DataTableExportConfig, DataTableXlsxStyle, DataTablePdfConfig, DataTableExportGenerator, DataTableExportResult, DataTableExportResultStatus, DataTableExportGeneratorResult, DataTableFilenameContext, DataTableExportMeta, DataTableExportContext, DataTableExportSettings, DataTableExportPrefs, DataTableExportMetadata, DataTableExportSummary, DataTableExportSummaryTable, DataTableExportOptions, DataTableFileNameAs, DataTablePdfFonts, DataTablePdfPageSize, DataTablePdfOrientation, DataTablePdfFontSize, DataTablePdfMargins, DataTableSummaryConfig, DataTableSummaryCard, DataTableSummaryValueCard, DataTableSummaryRatioCard, DataTableSummaryBreakdownCard, DataTableSummaryTrendCard, DataTableSummaryFunnelCard, DataTableSummaryFunnelStep, DataTableSummaryValueFigure, DataTableSummarySum, DataTableSummaryRowFilter, DataTableSummaryRange, DataTableSummaryCardHeight, DataTableSummaryValueTrend, DataTableSummaryPeriod, DataTableSummaryTrendChart, DataTableSummaryValueChart, DataTableSummaryRatioChart, DataTableSummaryAnyChart, DataTableSummaryCardRequest, DataTableSummaryPeriodCount, DataTableSummaryFigure, DataTableSummarySubline, DataTableSummaryStrip, DataTableSummaryChart, DataTableSummaryWidth, DataTableSummaryShow, DataTableSummaryPart, DataTableSummaryUserCard, DataTableSummaryPrefs, DataTableExportSummaryMode, DataTableSummaryPlacement, DataTableSummaryRequest, DataTableSummaryBucket, DataTableSummaryBreakdown, DataTableSummaryFigures, DataTableLicense, DataTableFlashColor, DataTableFlashColors, DataTableRowChanges, DataTableCellFlashStyle, DataTableCellStyle, DataTableLayout, DataTableCardFields, DataTableCardField, DataTableListFields, DataTableListField, DataTableRowMenuConfig, DataTableRowMenuItem, DataTableRowMenuBuiltIn, DataTableRowMenuIconAction, DataTableDetailMode, DataTableDetailContext, DataTableDetailRenderer, DataTableDisplayPrefs, DataTableDensity, DataTableFontSize, DataTableColumnWidth, DataTableActionDisplay, DataTableQuery, DataTableDataSource, DataTableRowsResult, DataTableAllRowsResult, DataTableExportTreeRequest, DataTableCounts, DataTableInitialState, DataTableApi, DataTableTransactionResult, DataTableTransactionOptions, DataTableRowTransaction, DataTablePersistence, DataTableGate, DataTableAuthorize, DataTableManagePrefs, DataTableManageList, DataTableViewsPrefs, DataTableExportTemplatePrefs, DataTableBulkAction, DataTableBulkActionContext, DataTableBulkActionResult, DataTableBulkConfirm, DataTableToolbarAction, DataTableSelection, DataTableColumnPinning, DataTablePinningConfig, DataTableColumnGroup, DataTableRowPinSide, DataTableRowPinningConfig, DataTableRowPins, DataTableCellSelectionConfig, DataTableCellRange, DataTableCellRangeFigure, DataTableCellPaste, DataTableRowDragConfig, DataTableRowOrderChange, DataTableTreeDataConfig, DataTablePivotConfig, DataTablePivotState, DataTablePivotValue, DataTablePivotTotals, DataTablePivotAggregate, DataTablePivotAggFn, DataTablePivotAggregation, DataTablePivotRequest, DataTablePivotResult, DataTablePivotCell, DataTablePivotKey, DataTableKeyboardConfig, DataTableShortcut, DataTableVirtualizeConfig, DataTableGroupingConfig, DataTableGroupPathItem, DataTableGroupResult, DataTableGroupSummaryContext, DataTableViewState, DataTableSharedView, DataTableShareAudience, DataTableSharing, } from './types';
 export { isFilterGroup, CARD_FIELD_LIMITS, LIST_FIELD_LIMITS, SUMMARY_PLACEMENTS_MAX, SUMMARY_SHOWS, SUMMARY_STRIPS, SUMMARY_TREND_COUNTS, SUMMARY_TREND_COUNT_BOUNDS, SUMMARY_KIND_CHARTS, SUMMARY_USER_CARDS_MAX, SUMMARY_WIDTHS } from './types';
 export { DEFAULT_DATA_TABLE_LABELS } from './labels';
 export type { DataTableLabels, DataTableLabelKey } from './labels';

package/dist/types/components/DataTable/keyboard/ShortcutsDialog.d.ts

@@ -8,7 +8,10 @@ interface ShortcutsDialogProps {
     grouping: boolean;
     actions: ShortcutListEntry[];
     table: ShortcutListEntry[];
+    cells?: {
+        paste: boolean;
+    };
     onClose: () => void;
 }
-export declare function ShortcutsDialog({ builtIns, grouping, actions, table, onClose }: ShortcutsDialogProps): React.JSX.Element;
+export declare function ShortcutsDialog({ builtIns, grouping, actions, table, cells, onClose }: ShortcutsDialogProps): React.JSX.Element;
 export default ShortcutsDialog;

package/dist/types/components/DataTable/keyboard/useGridKeyboard.d.ts

@@ -9,6 +9,7 @@ export interface GridKeyboardHost<R = any, T = any> {
     shortcuts: boolean;
     layout: DataTableLayout;
     items: DisplayItem<R>[];
+    lineOffset?: number;
     columns: string[];
     activeKey: string | null;
     activeCol: number;
@@ -16,6 +17,7 @@ export interface GridKeyboardHost<R = any, T = any> {
     rowId: (row: R) => string;
     original: (row: R) => T;
     openRow: (row: R) => void;
+    followOpen?: boolean;
     toggleRow: (row: R) => void;
     toggleGroup: (key: string) => void;
     toggleGroupSelection: (node: GroupNode<R>) => boolean;
@@ -30,6 +32,12 @@ export interface GridKeyboardHost<R = any, T = any> {
     runTableShortcut: (s: DataTableShortcut<T>, row: T | null) => void;
     page: (delta: 1 | -1) => boolean;
     openHelp: () => void;
+    cellKeys?: (e: React.KeyboardEvent, at: {
+        key: string;
+        col: number;
+        row: boolean;
+        focus: (key: string, col: number) => void;
+    }) => boolean;
 }
 export declare function useGridKeyboard<R, T>(host: GridKeyboardHost<R, T>, areaRef: RefObject<HTMLElement | null>, scrollApi: MutableRefObject<ScrollApi | null>): {
     onKeyDown: (e: React.KeyboardEvent) => void;

package/dist/types/components/DataTable/labels.d.ts

@@ -1,6 +1,8 @@
 import type { DataTableSummaryAnyChart } from './types';
 export declare const DEFAULT_DATA_TABLE_LABELS: {
     toolbar: string;
+    toolbarMore: string;
+    toolbarMoreOn: string;
     search: string;
     searchPlaceholder: string;
     closeSearch: string;
@@ -19,6 +21,7 @@ export declare const DEFAULT_DATA_TABLE_LABELS: {
     columnFilters: string;
     layout: string;
     layoutCurrent: (layout: string) => string;
+    layoutFieldsItem: (fields: string) => string;
     layoutTable: string;
     layoutCards: string;
     layoutSplit: string;
@@ -80,6 +83,16 @@ export declare const DEFAULT_DATA_TABLE_LABELS: {
     undoFailed: string;
     dismiss: string;
     dataTable: string;
+    rowsNewAbove: (n: string, count: number) => string;
+    rowsNewBelow: (n: string, count: number) => string;
+    rowsNewOnOtherPages: (n: string, count: number) => string;
+    rowsRemovedAbove: (n: string) => string;
+    rowsRemovedBelow: (n: string) => string;
+    rowsKeptInPlace: (n: string, count: number) => string;
+    sortNow: string;
+    pauseUpdates: string;
+    resumeUpdates: (n: string, count: number) => string;
+    rowsChangedAnnouncement: (added: string, removed: string, addedCount: number, removedCount: number) => string;
     selectAllRows: string;
     selectRow: (n: string) => string;
     open: string;
@@ -87,6 +100,37 @@ export declare const DEFAULT_DATA_TABLE_LABELS: {
     actions: string;
     expandRow: string;
     collapseRow: string;
+    rowDragHandle: (row: string) => string;
+    rowDragHint: string;
+    rowDragOffSorted: string;
+    rowDragOffSearched: string;
+    rowDragOffFiltered: string;
+    rowDragOffGrouped: string;
+    rowDragPicked: (row: string, at: string, of: string) => string;
+    rowDragPickedMany: (n: string, at: string, of: string) => string;
+    rowDragAt: (at: string, of: string) => string;
+    rowDragDropped: (row: string, at: string, of: string) => string;
+    rowDragDroppedMany: (n: string, at: string, of: string) => string;
+    rowDragCancelled: (row: string) => string;
+    rowDragMore: (n: string) => string;
+    rowDragTreeIn: (parent: string, at: string, of: string) => string;
+    rowDragTreeTop: (at: string, of: string) => string;
+    rowDragTreeInto: (parent: string, at: string, of: string) => string;
+    rowDragTreeToTop: (at: string, of: string) => string;
+    rowDragTreePicked: (row: string, where: string) => string;
+    rowDragTreePickedMany: (n: string, where: string) => string;
+    rowDragTreeDropped: (row: string, where: string) => string;
+    rowDragTreeDroppedMany: (n: string, where: string) => string;
+    rowDragTreeNoIndent: string;
+    rowDragTreeNoOutdent: string;
+    treeExpand: (row: string) => string;
+    treeCollapse: (row: string) => string;
+    treeLoading: string;
+    treeLoadFailed: string;
+    treeExpandAll: string;
+    treeCollapseAll: string;
+    treeRows: string;
+    treeLevel: string;
     showMore: string;
     showLess: string;
     total: string;
@@ -112,6 +156,11 @@ export declare const DEFAULT_DATA_TABLE_LABELS: {
     copyFailed: string;
     selectRowMenu: string;
     unselectRowMenu: string;
+    pinRowTop: string;
+    pinRowBottom: string;
+    unpinRow: string;
+    pinnedRowTop: string;
+    pinnedRowBottom: string;
     filterOnly: (value: string) => string;
     filterAdd: (value: string) => string;
     filterHide: (value: string) => string;
@@ -178,6 +227,34 @@ export declare const DEFAULT_DATA_TABLE_LABELS: {
     kbFilterOnly: string;
     kbFilterHide: string;
     selectionCleared: string;
+    kbCellRange: string;
+    kbCellRangeEdge: string;
+    kbCellAdd: string;
+    kbCellAll: string;
+    kbCellCopy: string;
+    kbCellPaste: string;
+    kbCellRows: string;
+    kbCellEscape: string;
+    cellRangeAnnouncement: (cells: string, rows: string, columns: string, count: {
+        cells: number;
+        rows: number;
+        columns: number;
+        ranges: number;
+    }) => string;
+    cellRangeCleared: string;
+    cellsCopied: (n: string, count: number) => string;
+    cellsPasted: (n: string, count: number) => string;
+    cellRangeBar: string;
+    cellRangeCount: string;
+    cellRangeSum: string;
+    cellRangeAvg: string;
+    cellRangeMin: string;
+    cellRangeMax: string;
+    cellTouchBar: string;
+    cellTouchSize: (n: string, count: number) => string;
+    cellTouchCopy: string;
+    cellTouchMenu: string;
+    cellTouchClear: string;
     groupButton: string;
     groupButtonOn: (columns: string) => string;
     groupMenu: string;
@@ -266,6 +343,9 @@ export declare const DEFAULT_DATA_TABLE_LABELS: {
     actionDisplayMode: string;
     actionDisplayModeCard: string;
     actionDisplayModeHint: string;
+    maxVisibleActions: string;
+    maxVisibleActionsCard: string;
+    maxVisibleActionsHint: string;
     modeIcon: string;
     modeLabel: string;
     modeIconLabel: string;
@@ -425,6 +505,7 @@ export declare const DEFAULT_DATA_TABLE_LABELS: {
     summaryWidthFull: string;
     summaryWidthAuto: (best: string) => string;
     summaryWidthBetter: (best: string) => string;
+    manageSummaryRangeHint: string;
     summarySeeAll: (n: string) => string;
     summaryAllOf: (title: string, n: string) => string;
     summaryLoading: string;
@@ -464,6 +545,7 @@ export declare const DEFAULT_DATA_TABLE_LABELS: {
     exportAwaitingClick: (title: string) => string;
     exportValidationFailed: string;
     exportCapped: (shown: string, total: string) => string;
+    exportTreePartial: string;
     exportBusiness: string;
     exportAddress: string;
     exportPhone: string;
@@ -471,6 +553,7 @@ export declare const DEFAULT_DATA_TABLE_LABELS: {
     exportFiltersLabel: string;
     exportSearchLabel: string;
     exportRowsLabel: string;
+    exportNoteLabel: string;
     exportRowsTotal: (n: string) => string;
     exportRowsFiltered: (n: string) => string;
     exportRowsExported: (n: string) => string;
@@ -607,6 +690,51 @@ export declare const DEFAULT_DATA_TABLE_LABELS: {
     fieldsTab: string;
     previewTab: string;
     fieldsResetDefault: string;
+    pivot: string;
+    pivotOn: string;
+    pivotTitle: string;
+    pivotSubtitle: string;
+    pivotMode: string;
+    pivotModeHint: string;
+    pivotRows: string;
+    pivotRowsHint: string;
+    pivotColumns: string;
+    pivotColumnsHint: string;
+    pivotValues: string;
+    pivotValuesHint: string;
+    pivotFields: string;
+    pivotFieldsHint: string;
+    pivotAllPlaced: string;
+    pivotDropHere: string;
+    pivotAdd: string;
+    pivotAddTo: (part: string) => string;
+    pivotAddField: (field: string, part: string) => string;
+    pivotRemove: (field: string) => string;
+    pivotMove: (field: string) => string;
+    pivotAggregation: (field: string) => string;
+    pivotAggSum: string;
+    pivotAggCount: string;
+    pivotAggAvg: string;
+    pivotAggMin: string;
+    pivotAggMax: string;
+    pivotAggFirst: string;
+    pivotAggLast: string;
+    pivotAggCustom: string;
+    pivotValueHeader: (agg: string, column: string) => string;
+    pivotTotal: string;
+    pivotTotalOf: (value: string) => string;
+    pivotGrandTotal: string;
+    pivotTotals: string;
+    pivotTotalsRows: string;
+    pivotTotalsColumns: string;
+    pivotTotalsGrand: string;
+    pivotCapped: (shown: string, total: string) => string;
+    pivotNoValues: string;
+    pivotNoRows: string;
+    pivotLoadFailed: string;
+    pivotResult: string;
+    pivotReset: string;
+    pivotFieldsOf: (n: string) => string;
     prefsChanged: (what: string) => string;
     prefsColumnsGone: (n: string, count: number) => string;
     prefsFiltersOff: (n: string, count: number) => string;

package/dist/types/components/DataTable/layout/LayoutSwitcher.d.ts

@@ -1,9 +1,17 @@
 import React from 'react';
 import type { DataTableLayout } from '../types';
 export declare const LAYOUT_ICONS: Record<DataTableLayout, React.ReactNode>;
-export declare function LayoutSwitcher({ layouts, layout, onChange }: {
+export interface LayoutFieldsEntry {
+    label: string;
+    icon: React.ReactNode;
+    onOpen: () => void;
+}
+interface LayoutSwitcherProps {
     layouts: DataTableLayout[];
     layout: DataTableLayout;
     onChange: (layout: DataTableLayout) => void;
-}): React.JSX.Element | null;
+    compact?: boolean;
+    fields?: LayoutFieldsEntry;
+}
+export declare function LayoutSwitcher({ layouts, layout, onChange, compact, fields }: LayoutSwitcherProps): React.JSX.Element | null;
 export default LayoutSwitcher;

package/dist/types/components/DataTable/layout/useFitWidths.d.ts

@@ -0,0 +1,7 @@
+import { type RefObject } from 'react';
+import { type FitColumn } from '../../../core/logic';
+export interface FitWidthColumn extends FitColumn {
+    scaledMin?: number;
+}
+export declare const FIT_COL_ATTR = "data-fit-col";
+export declare function useFitWidths(tableRef: RefObject<HTMLTableElement | null>, boxRef: RefObject<HTMLElement | null>, active: boolean, columns: FitWidthColumn[], reserved: number, key: string): void;

package/dist/types/components/DataTable/menu/RowMenu.d.ts

@@ -44,6 +44,7 @@ export interface RowMenuPlacement {
     y: number;
     sheet: boolean;
     alignRight?: boolean;
+    anchorHeight?: number;
 }
 interface RowMenuProps {
     model: RowMenuModel;

package/dist/types/components/DataTable/menu/buildRowMenu.d.ts

@@ -1,8 +1,7 @@
-import React, { type ReactNode } from 'react';
-import type { DataTableCardFields, DataTableFilterGroup, DataTableRowMenuConfig, DataTableRowMenuBuiltIn, DataTableRowAction, DataTableColumn } from '../types';
+import { type ReactNode } from 'react';
+import type { DataTableCardFields, DataTableFilterGroup, DataTableRowMenuConfig, DataTableRowMenuBuiltIn, DataTableRowAction, DataTableColumn, DataTableRowPinSide } from '../types';
 import type { DataTableLabels } from '../labels';
 import type { RowMenuModel } from './RowMenu';
-export declare function NotEqualIcon(): React.JSX.Element;
 export declare const DEFAULT_BUILT_INS: DataTableRowMenuBuiltIn[];
 export interface RowMenuContext<T> {
     row: T;
@@ -31,5 +30,9 @@ export interface RowMenuContext<T> {
     filterGroup: DataTableFilterGroup;
     onFilter: (group: DataTableFilterGroup) => void;
     format: (n: number) => string;
+    pin?: {
+        side: DataTableRowPinSide | null;
+        onPin: (side: DataTableRowPinSide | null) => void;
+    };
 }
 export declare function buildRowMenu<T>(ctx: RowMenuContext<T>): RowMenuModel;

package/dist/types/components/DataTable/motion/RowChangeNotice.d.ts

@@ -0,0 +1,19 @@
+import type { RowChangeNotice as Notice } from './useRowChangeNotices';
+export interface LiveUpdatesControl {
+    paused: boolean;
+    waiting: number;
+    onPause: () => void;
+    onResume: () => void;
+}
+interface Props {
+    notice: Notice;
+    side: 'top' | 'bottom';
+    onJump: (side: 'above' | 'below') => void;
+    onOtherPages: () => void;
+    onDismiss: () => void;
+    held?: number;
+    onSortNow?: () => void;
+    live?: LiveUpdatesControl | null;
+}
+export declare function RowChangeNotice({ notice, side, onJump, onOtherPages, onDismiss, held, onSortNow, live }: Props): import("react").JSX.Element | null;
+export {};

package/dist/types/components/DataTable/motion/rowChanges.d.ts

@@ -0,0 +1,25 @@
+import type { CSSProperties } from 'react';
+import type { DataTableFlashColor, DataTableRowChanges } from '../types';
+import { type RowChangeReport } from './useRowMotion';
+export interface RowChangesOptions {
+    enterMs: number;
+    exitMs: number;
+    maxAnimated: number;
+    onChange?: (report: RowChangeReport) => void;
+    which?: (added: string[], removed: string[]) => {
+        added: string[];
+        removed: string[];
+    };
+    held?: ReadonlyMap<string, unknown>;
+}
+export interface ResolvedRowChanges {
+    enterMs: number;
+    exitMs: number;
+    maxAnimated: number;
+    outOfView: boolean;
+    announce: boolean;
+    pauseControl: boolean;
+    style: CSSProperties;
+}
+export declare const rowChangeColor: (c: DataTableFlashColor) => string;
+export declare function resolveRowChanges(cfg: DataTableRowChanges | undefined): ResolvedRowChanges;

package/dist/types/components/DataTable/motion/useNoticeInsets.d.ts

@@ -0,0 +1,2 @@
+import { type RefObject } from 'react';
+export declare function useNoticeInsets(areaRef: RefObject<HTMLElement | null>, active: boolean, key: string): void;