@kanunilabs/datagrid-react 1.8.11 → 1.8.12

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { RefObject, ReactNode, FocusEvent, MouseEvent } from 'react';
-import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, DataRowNode, CardField, RowSaveStatus, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, ToolbarOptions, PortalContainer, CardViewOptions, EditMode, RowChange, RowStatusSource, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnLookup, ColumnModel, ColSpanPlan, SummaryDef, RemoteDistinctList, PortalKind, ToolbarSearchOptions, ToolbarIconName, ColumnState, BusyPhase, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditingEngine, EditingApi, NewRowPosition, ValidationRule, CrudHandlers, EditingPermissions, CommitOn, RowEditSession, ColumnNumberFormat, LookupMatchMode, LookupMatchFold } from '@kanunilabs/datagrid-core';
+import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, DataRowNode, CardField, RowSaveStatus, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, ToolbarOptions, PortalContainer, CardViewOptions, EditMode, RowChange, RowStatusSource, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnLookup, ColumnModel, ColSpanPlan, LookupMatchFold, SummaryDef, RemoteDistinctList, PortalKind, ToolbarSearchOptions, ToolbarIconName, ColumnState, BusyPhase, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditingEngine, EditingApi, NewRowPosition, ValidationRule, CrudHandlers, EditingPermissions, CommitOn, RowEditSession, ColumnNumberFormat, LookupMatchMode, LookupListColumn } from '@kanunilabs/datagrid-core';
 export { BusyChangedEvent, BusyPhase, ChangesChangedEvent, ClientRowModel, ColumnLayout, ColumnLookup, ColumnModel, ColumnPin, ColumnRuntime, ColumnState, ColumnStateChangedEvent, CommitOn, ContentReadyEvent, CustomFilterOperator, CustomFilterOperatorId, DEFAULT_ROW_HEIGHT, DENSITY_ROW_HEIGHT, DataGridController, DataGridCoreConfig, DataRowNode, DataSource, EditingApi, FilterChangedEvent, FilterCondition, FilterGroupNode, FilterNode, FilterOperator, FocusedRowChangedEvent, GRID_COLOR_SCHEMES, GRID_PALETTES, GRID_THEMES, GridColorScheme, GridColumnDef, GridDataType, GridDensity, GridEventMap, GridPalette, GridPaletteName, GridRowData, GridStateStore, GridTheme, GridThemeName, GridViewState, GroupRowNode, GroupingConfig, HeaderBandCell, InferColumnsOptions, LoadOptions, LoadResult, LookupItem, NewRowPosition, PortalContainer, RowDropPosition, RowKey, RowNode, SUMMARY_TYPE_LABEL, SaveRejected, SaveRowError, ScrollingConfig, SelectionDescriptor, SortChangedEvent, SortDescriptor, SortDirection, StateStoringConfig, SummaryDef, SummaryType, THEME_ROW_HEIGHT, ToolbarOptions, ToolbarSearchOptions, ViewportChangedEvent, VirtualWindow, VirtualWindowEngine, allowedSummaryTypes, andFilters, attachStateStoring, bandDepth, bandPath, computeColumnLayout, computeHeaderBands, createRestDataSource, describeFilter, downloadBlob, fillText, filterInputFromNode, formatSummaryValue, humanizeField, importCsv, inferColumns, isDataRow, isDataSource, isFilterGroup, isGroupRow, isPackagedTheme, isSaveRejected, lookupLabel, moveRowInArray, parseCsv, parseFilterInput, sniffDelimiter, summaryKey, summaryLabel, summaryTypeLabels, themeClassName } from '@kanunilabs/datagrid-core';
 
 /** Formats an export menu can offer. */
@@ -427,8 +427,11 @@ interface EditorRowApi {
  *   **Escape** cancels the editor (`cancel()`), and **Tab / Shift+Tab** walk
  *   the focusable elements INSIDE the box (text box → "…" button) and only
  *   past the last (first) one commit and move to the next (previous) cell —
- *   `commit({ move: 'next' })`. Enter is left to the editor: call
- *   `commit({ move: 'down' })` from it for the built-in behaviour. The
+ *   `commit({ move: 'next' })`. **Enter** commits like the built-in editor
+ *   (moves down, or stays with `editKeys.enter`; Shift+Enter stays) — except
+ *   in a `<textarea>` or an editable region, where it types a new line. An
+ *   editor that uses Enter itself (picking from its own list) calls
+ *   `preventDefault()` in its handler. The
  *   editor's own shortcuts (F4, Alt+ArrowDown for its "…" button) are never
  *   taken by the grid.
  * - Events from OUTSIDE the grid's DOM — a dialog the editor opens in a
@@ -451,8 +454,17 @@ interface EditorRowApi {
  *   to the scroller when the editor has closed.
  */
 interface EditorRenderContext<TRow = GridRowData> {
-    /** Current (uncommitted) editor value. */
+    /**
+     * Current (uncommitted) editor value — what the built-in editor would show:
+     * the column's `valueGetter` result when it has one.
+     */
     value: unknown;
+    /**
+     * The column's `field` as stored in the row (pending edits applied), before
+     * any `valueGetter` — the bit set behind a "E;D;S" summary, say. Undefined
+     * when the column has no `field`.
+     */
+    rawValue: unknown;
     /** The row with pending edits applied — what a cascading list should read. */
     row: TRow;
     columnId: string;
@@ -1200,6 +1212,14 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
      * the totals are the headline; the rows below are then the evidence for it.
      */
     footerPosition?: 'top' | 'bottom';
+    /**
+     * Keep the bottom totals row on the grid's bottom edge when there are too few
+     * rows to reach it (Tekax B.3), as a desktop data grid does. Default false:
+     * the row follows the last data row and sticks to the edge only once the rows
+     * scroll. Rows pinned to the bottom (`pinnedBottomRows`) move down with it.
+     * No effect with `footerPosition: 'top'`.
+     */
+    pinFooterToBottom?: boolean;
     /**
      * What to do with the column widths once the grid knows how much room it has
      * (gap analysis P2.5). Default `'none'` — the configured widths are used as
@@ -1739,6 +1759,8 @@ interface GridRowProps<TRow = GridRowData> {
      * when it does not, they do not.
      */
     searchNeedle?: string;
+    /** The grid's `searchFold`: how `searchNeedle` was folded, and so the cell text. */
+    searchFold?: LookupMatchFold;
     /**
      * The grid's cache of FUNCTION lookup lists (P-5.1): a closed cell shows the
      * label, not the raw code. One stable object per grid; when a list arrives
@@ -1778,7 +1800,7 @@ interface GridRowProps<TRow = GridRowData> {
     onCellPointerEnter?: (ctx: CellSlotContext<TRow>, event: React.MouseEvent) => void;
     onCellDoubleClick?: (ctx: CellSlotContext<TRow>) => void;
 }
-declare function GridRowImpl<TRow = GridRowData>({ gridId, node, index, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, striped, selected, ariaSelectable, selectable, groupSelection, onToggleGroupSelect, groupDisplay, focusedColumnId, rowFocused, renderRow, checkboxColumn, statusColumn, rowNumberColumn, rowNumber, getNote, getSpan, resolveColSpans, findKind, headerRowCount, onRowClick, onRowMouseDown, onRowDoubleClick, onToggleSelect, onCellMouseDown, onRowContextMenu, searchNeedle, lookupLabels, onToggleGroup, summaryDefs, detailColumn, detailExpanded, onToggleDetail, onToggleTreeRow, renderDetail, renderEditForm, renderRowMessage, renderCellContent, getCellClassName, onCellPointerDown, onCellPointerEnter, onCellDoubleClick, rowDrag, dropSide, rowStatus, rowStatusText, rowStatusTint, rowStatusStrike, rowClass, height, }: GridRowProps<TRow>): react.JSX.Element | null;
+declare function GridRowImpl<TRow = GridRowData>({ gridId, node, index, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, striped, selected, ariaSelectable, selectable, groupSelection, onToggleGroupSelect, groupDisplay, focusedColumnId, rowFocused, renderRow, checkboxColumn, statusColumn, rowNumberColumn, rowNumber, getNote, getSpan, resolveColSpans, findKind, headerRowCount, onRowClick, onRowMouseDown, onRowDoubleClick, onToggleSelect, onCellMouseDown, onRowContextMenu, searchNeedle, searchFold, lookupLabels, onToggleGroup, summaryDefs, detailColumn, detailExpanded, onToggleDetail, onToggleTreeRow, renderDetail, renderEditForm, renderRowMessage, renderCellContent, getCellClassName, onCellPointerDown, onCellPointerEnter, onCellDoubleClick, rowDrag, dropSide, rowStatus, rowStatusText, rowStatusTint, rowStatusStrike, rowClass, height, }: GridRowProps<TRow>): react.JSX.Element | null;
 declare const GridRow: typeof GridRowImpl;
 
 interface GridFilterRowProps<TRow = GridRowData> {
@@ -2738,11 +2760,12 @@ interface UseGridEditingResult<TRow = GridRowData> {
     /**
      * A custom editor's commit (`renderEditor`'s `ctx.commit`, P-4.2): `'none'`
      * stays on the cell, `'down'` moves down (whatever `editKeys.enter` says —
-     * the editor asked), `'next'` / `'previous'` walk to the adjacent editable
+     * the editor asked), `'enter'` is the grid's own Enter (down unless
+     * `editKeys.enter`), `'next'` / `'previous'` walk to the adjacent editable
      * cell like Tab, `'blur'` leaves focus where it is. False when a rule
      * refused the value.
      */
-    commitCustomEditor: (move: 'down' | 'next' | 'previous' | 'none' | 'blur') => boolean;
+    commitCustomEditor: (move: 'down' | 'enter' | 'next' | 'previous' | 'none' | 'blur') => boolean;
     /**
      * `ctx.suspendBlurCommit` (P-4.1): while on, blur is not leaving the editor
      * (`ctx.commitOnBlur`, the `commitOn: 'row'` send). Turning it off puts focus
@@ -2985,6 +3008,12 @@ interface GridLookupEditorProps {
      * highlighted item; no match picks nothing. Ignored with `allowCustom`.
      */
     typeAhead?: boolean;
+    /** A grip on the open list's corner to resize it (`lookup.listResizable`, B.4.3). */
+    listResizable?: boolean;
+    /** The list as a table with a header row (`lookup.listColumns`, B.4.2). */
+    listColumns?: readonly LookupListColumn[];
+    /** A ▾ button that opens and closes the list (`lookup.dropButton`, B.4.2). */
+    dropButton?: boolean;
     /**
      * Complete typed text to the one item left / an exact label on leaving.
      * Default true. False: the "pick from the list" rule (K-3, see the top).
@@ -3003,6 +3032,8 @@ interface GridLookupEditorProps {
      */
     onPick?: (item: LookupItem) => boolean;
     invalid?: boolean;
+    /** A read-only field (`LookupBox`): the box and its buttons do nothing. */
+    disabled?: boolean;
     /**
      * Take focus on mount. True for a cell editor — it opened BECAUSE the user
      * asked to edit that one cell. False in `row` mode, where every editable cell
@@ -3032,6 +3063,16 @@ interface GridLookupEditorProps {
      * settles the typed text, as before.
      */
     onBlurCommit?: () => void;
+    /**
+     * `lookup.onPickerOpen` (Tekax B.4.1), bound to the row: a "…" button and
+     * Ctrl+Enter open the app's picker; its item is picked like a list item.
+     */
+    onPickerOpen?: (text: string) => Promise<LookupItem | null> | LookupItem | null;
+    /**
+     * The grid's `suspendBlurCommit` (P-4.1): held while the picker is open, so
+     * focus going to the app's dialog neither commits the cell nor sends the row.
+     */
+    suspendBlurCommit?: (on: boolean, restoreTo?: () => HTMLElement | null) => void;
 }
 /**
  * The same match, as items. Kept for callers and tests that want the simple
@@ -3039,7 +3080,7 @@ interface GridLookupEditorProps {
  */
 declare function matchOptions(options: readonly LookupItem[], query: string, mode: LookupMatchMode): readonly LookupItem[];
 /** The editor's settings that come straight from a column's `lookup`. */
-type LookupEditorSettings = Pick<GridLookupEditorProps, 'matchMode' | 'codeMatchMode' | 'linked' | 'allowCustom' | 'autoCompleteSingle' | 'onNoMatch' | 'matchFold' | 'openOnEdit' | 'restrictInput' | 'typeAhead'>;
+type LookupEditorSettings = Pick<GridLookupEditorProps, 'matchMode' | 'codeMatchMode' | 'linked' | 'allowCustom' | 'autoCompleteSingle' | 'onNoMatch' | 'matchFold' | 'openOnEdit' | 'restrictInput' | 'typeAhead' | 'listResizable' | 'listColumns' | 'dropButton'>;
 /** `lookup` → the editor's props, one reading for the cell, row and form editors. */
 declare function lookupEditorSettings(lookup: ColumnLookup<never> | undefined): LookupEditorSettings;
 /**
@@ -3048,10 +3089,16 @@ declare function lookupEditorSettings(lookup: ColumnLookup<never> | undefined):
  * neither — a plain pick, one cell, as before.
  */
 declare function lookupPickValues(lookup: ColumnLookup<never> | undefined, columnId: string, item: LookupItem): Record<string, unknown> | null;
-declare function GridLookupEditor({ options, value, matchMode, codeMatchMode, matchFold, linked, allowCustom, openOnEdit, seeded, restrictInput, typeAhead, autoCompleteSingle, onNoMatch, onPick, invalid, autoFocus, testId, columnId, ariaLabel, onChange, onCommit, commitOnPick, onCancel, onTab, onBlurCommit, }: GridLookupEditorProps): react.JSX.Element;
+declare function GridLookupEditor({ options, value, matchMode, codeMatchMode, matchFold, linked, allowCustom, openOnEdit, seeded, restrictInput, typeAhead, listResizable, listColumns, dropButton, autoCompleteSingle, onNoMatch, onPick, invalid, disabled, autoFocus, testId, columnId, ariaLabel, onChange, onCommit, commitOnPick, onCancel, onTab, onBlurCommit, onPickerOpen, suspendBlurCommit, }: GridLookupEditorProps): react.JSX.Element;
 
 interface GridCellEditorProps {
     value: unknown;
+    /** The column's lookup when it is `multiple` (Tekax B.6): the check-box editor. */
+    multipleLookup?: ColumnLookup<never>;
+    /** `lookup.onPickerOpen`, bound to this cell (Tekax B.4.1). */
+    onPickerOpen?: GridLookupEditorProps['onPickerOpen'];
+    /** The grid's `suspendBlurCommit`, held while that picker is open. */
+    suspendBlurCommit?: GridLookupEditorProps['suspendBlurCommit'];
     dataType: GridDataType | undefined;
     /**
      * Choices for a lookup/select editor. `null` means the list is still being
@@ -3106,7 +3153,7 @@ interface GridCellEditorProps {
     onTab: (direction: 1 | -1) => void;
     onCancel: () => void;
 }
-declare function GridCellEditor({ value, dataType, error, seeded, seedText, options, allowCustom, matchMode, lookupSettings, onPick, ariaLabel, dateFormat, numberFormat, numberLocale, onChange, onCommit, onTab, onCancel, }: GridCellEditorProps): react.JSX.Element;
+declare function GridCellEditor({ value, dataType, error, seeded, seedText, options, allowCustom, matchMode, lookupSettings, onPick, multipleLookup, onPickerOpen, suspendBlurCommit, ariaLabel, dateFormat, numberFormat, numberLocale, onChange, onCommit, onTab, onCancel, }: GridCellEditorProps): react.JSX.Element;
 
 interface GridDateEditorProps {
     value: unknown;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { RefObject, ReactNode, FocusEvent, MouseEvent } from 'react';
-import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, DataRowNode, CardField, RowSaveStatus, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, ToolbarOptions, PortalContainer, CardViewOptions, EditMode, RowChange, RowStatusSource, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnLookup, ColumnModel, ColSpanPlan, SummaryDef, RemoteDistinctList, PortalKind, ToolbarSearchOptions, ToolbarIconName, ColumnState, BusyPhase, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditingEngine, EditingApi, NewRowPosition, ValidationRule, CrudHandlers, EditingPermissions, CommitOn, RowEditSession, ColumnNumberFormat, LookupMatchMode, LookupMatchFold } from '@kanunilabs/datagrid-core';
+import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, DataRowNode, CardField, RowSaveStatus, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, ToolbarOptions, PortalContainer, CardViewOptions, EditMode, RowChange, RowStatusSource, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnLookup, ColumnModel, ColSpanPlan, LookupMatchFold, SummaryDef, RemoteDistinctList, PortalKind, ToolbarSearchOptions, ToolbarIconName, ColumnState, BusyPhase, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditingEngine, EditingApi, NewRowPosition, ValidationRule, CrudHandlers, EditingPermissions, CommitOn, RowEditSession, ColumnNumberFormat, LookupMatchMode, LookupListColumn } from '@kanunilabs/datagrid-core';
 export { BusyChangedEvent, BusyPhase, ChangesChangedEvent, ClientRowModel, ColumnLayout, ColumnLookup, ColumnModel, ColumnPin, ColumnRuntime, ColumnState, ColumnStateChangedEvent, CommitOn, ContentReadyEvent, CustomFilterOperator, CustomFilterOperatorId, DEFAULT_ROW_HEIGHT, DENSITY_ROW_HEIGHT, DataGridController, DataGridCoreConfig, DataRowNode, DataSource, EditingApi, FilterChangedEvent, FilterCondition, FilterGroupNode, FilterNode, FilterOperator, FocusedRowChangedEvent, GRID_COLOR_SCHEMES, GRID_PALETTES, GRID_THEMES, GridColorScheme, GridColumnDef, GridDataType, GridDensity, GridEventMap, GridPalette, GridPaletteName, GridRowData, GridStateStore, GridTheme, GridThemeName, GridViewState, GroupRowNode, GroupingConfig, HeaderBandCell, InferColumnsOptions, LoadOptions, LoadResult, LookupItem, NewRowPosition, PortalContainer, RowDropPosition, RowKey, RowNode, SUMMARY_TYPE_LABEL, SaveRejected, SaveRowError, ScrollingConfig, SelectionDescriptor, SortChangedEvent, SortDescriptor, SortDirection, StateStoringConfig, SummaryDef, SummaryType, THEME_ROW_HEIGHT, ToolbarOptions, ToolbarSearchOptions, ViewportChangedEvent, VirtualWindow, VirtualWindowEngine, allowedSummaryTypes, andFilters, attachStateStoring, bandDepth, bandPath, computeColumnLayout, computeHeaderBands, createRestDataSource, describeFilter, downloadBlob, fillText, filterInputFromNode, formatSummaryValue, humanizeField, importCsv, inferColumns, isDataRow, isDataSource, isFilterGroup, isGroupRow, isPackagedTheme, isSaveRejected, lookupLabel, moveRowInArray, parseCsv, parseFilterInput, sniffDelimiter, summaryKey, summaryLabel, summaryTypeLabels, themeClassName } from '@kanunilabs/datagrid-core';
 
 /** Formats an export menu can offer. */
@@ -427,8 +427,11 @@ interface EditorRowApi {
  *   **Escape** cancels the editor (`cancel()`), and **Tab / Shift+Tab** walk
  *   the focusable elements INSIDE the box (text box → "…" button) and only
  *   past the last (first) one commit and move to the next (previous) cell —
- *   `commit({ move: 'next' })`. Enter is left to the editor: call
- *   `commit({ move: 'down' })` from it for the built-in behaviour. The
+ *   `commit({ move: 'next' })`. **Enter** commits like the built-in editor
+ *   (moves down, or stays with `editKeys.enter`; Shift+Enter stays) — except
+ *   in a `<textarea>` or an editable region, where it types a new line. An
+ *   editor that uses Enter itself (picking from its own list) calls
+ *   `preventDefault()` in its handler. The
  *   editor's own shortcuts (F4, Alt+ArrowDown for its "…" button) are never
  *   taken by the grid.
  * - Events from OUTSIDE the grid's DOM — a dialog the editor opens in a
@@ -451,8 +454,17 @@ interface EditorRowApi {
  *   to the scroller when the editor has closed.
  */
 interface EditorRenderContext<TRow = GridRowData> {
-    /** Current (uncommitted) editor value. */
+    /**
+     * Current (uncommitted) editor value — what the built-in editor would show:
+     * the column's `valueGetter` result when it has one.
+     */
     value: unknown;
+    /**
+     * The column's `field` as stored in the row (pending edits applied), before
+     * any `valueGetter` — the bit set behind a "E;D;S" summary, say. Undefined
+     * when the column has no `field`.
+     */
+    rawValue: unknown;
     /** The row with pending edits applied — what a cascading list should read. */
     row: TRow;
     columnId: string;
@@ -1200,6 +1212,14 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
      * the totals are the headline; the rows below are then the evidence for it.
      */
     footerPosition?: 'top' | 'bottom';
+    /**
+     * Keep the bottom totals row on the grid's bottom edge when there are too few
+     * rows to reach it (Tekax B.3), as a desktop data grid does. Default false:
+     * the row follows the last data row and sticks to the edge only once the rows
+     * scroll. Rows pinned to the bottom (`pinnedBottomRows`) move down with it.
+     * No effect with `footerPosition: 'top'`.
+     */
+    pinFooterToBottom?: boolean;
     /**
      * What to do with the column widths once the grid knows how much room it has
      * (gap analysis P2.5). Default `'none'` — the configured widths are used as
@@ -1739,6 +1759,8 @@ interface GridRowProps<TRow = GridRowData> {
      * when it does not, they do not.
      */
     searchNeedle?: string;
+    /** The grid's `searchFold`: how `searchNeedle` was folded, and so the cell text. */
+    searchFold?: LookupMatchFold;
     /**
      * The grid's cache of FUNCTION lookup lists (P-5.1): a closed cell shows the
      * label, not the raw code. One stable object per grid; when a list arrives
@@ -1778,7 +1800,7 @@ interface GridRowProps<TRow = GridRowData> {
     onCellPointerEnter?: (ctx: CellSlotContext<TRow>, event: React.MouseEvent) => void;
     onCellDoubleClick?: (ctx: CellSlotContext<TRow>) => void;
 }
-declare function GridRowImpl<TRow = GridRowData>({ gridId, node, index, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, striped, selected, ariaSelectable, selectable, groupSelection, onToggleGroupSelect, groupDisplay, focusedColumnId, rowFocused, renderRow, checkboxColumn, statusColumn, rowNumberColumn, rowNumber, getNote, getSpan, resolveColSpans, findKind, headerRowCount, onRowClick, onRowMouseDown, onRowDoubleClick, onToggleSelect, onCellMouseDown, onRowContextMenu, searchNeedle, lookupLabels, onToggleGroup, summaryDefs, detailColumn, detailExpanded, onToggleDetail, onToggleTreeRow, renderDetail, renderEditForm, renderRowMessage, renderCellContent, getCellClassName, onCellPointerDown, onCellPointerEnter, onCellDoubleClick, rowDrag, dropSide, rowStatus, rowStatusText, rowStatusTint, rowStatusStrike, rowClass, height, }: GridRowProps<TRow>): react.JSX.Element | null;
+declare function GridRowImpl<TRow = GridRowData>({ gridId, node, index, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, striped, selected, ariaSelectable, selectable, groupSelection, onToggleGroupSelect, groupDisplay, focusedColumnId, rowFocused, renderRow, checkboxColumn, statusColumn, rowNumberColumn, rowNumber, getNote, getSpan, resolveColSpans, findKind, headerRowCount, onRowClick, onRowMouseDown, onRowDoubleClick, onToggleSelect, onCellMouseDown, onRowContextMenu, searchNeedle, searchFold, lookupLabels, onToggleGroup, summaryDefs, detailColumn, detailExpanded, onToggleDetail, onToggleTreeRow, renderDetail, renderEditForm, renderRowMessage, renderCellContent, getCellClassName, onCellPointerDown, onCellPointerEnter, onCellDoubleClick, rowDrag, dropSide, rowStatus, rowStatusText, rowStatusTint, rowStatusStrike, rowClass, height, }: GridRowProps<TRow>): react.JSX.Element | null;
 declare const GridRow: typeof GridRowImpl;
 
 interface GridFilterRowProps<TRow = GridRowData> {
@@ -2738,11 +2760,12 @@ interface UseGridEditingResult<TRow = GridRowData> {
     /**
      * A custom editor's commit (`renderEditor`'s `ctx.commit`, P-4.2): `'none'`
      * stays on the cell, `'down'` moves down (whatever `editKeys.enter` says —
-     * the editor asked), `'next'` / `'previous'` walk to the adjacent editable
+     * the editor asked), `'enter'` is the grid's own Enter (down unless
+     * `editKeys.enter`), `'next'` / `'previous'` walk to the adjacent editable
      * cell like Tab, `'blur'` leaves focus where it is. False when a rule
      * refused the value.
      */
-    commitCustomEditor: (move: 'down' | 'next' | 'previous' | 'none' | 'blur') => boolean;
+    commitCustomEditor: (move: 'down' | 'enter' | 'next' | 'previous' | 'none' | 'blur') => boolean;
     /**
      * `ctx.suspendBlurCommit` (P-4.1): while on, blur is not leaving the editor
      * (`ctx.commitOnBlur`, the `commitOn: 'row'` send). Turning it off puts focus
@@ -2985,6 +3008,12 @@ interface GridLookupEditorProps {
      * highlighted item; no match picks nothing. Ignored with `allowCustom`.
      */
     typeAhead?: boolean;
+    /** A grip on the open list's corner to resize it (`lookup.listResizable`, B.4.3). */
+    listResizable?: boolean;
+    /** The list as a table with a header row (`lookup.listColumns`, B.4.2). */
+    listColumns?: readonly LookupListColumn[];
+    /** A ▾ button that opens and closes the list (`lookup.dropButton`, B.4.2). */
+    dropButton?: boolean;
     /**
      * Complete typed text to the one item left / an exact label on leaving.
      * Default true. False: the "pick from the list" rule (K-3, see the top).
@@ -3003,6 +3032,8 @@ interface GridLookupEditorProps {
      */
     onPick?: (item: LookupItem) => boolean;
     invalid?: boolean;
+    /** A read-only field (`LookupBox`): the box and its buttons do nothing. */
+    disabled?: boolean;
     /**
      * Take focus on mount. True for a cell editor — it opened BECAUSE the user
      * asked to edit that one cell. False in `row` mode, where every editable cell
@@ -3032,6 +3063,16 @@ interface GridLookupEditorProps {
      * settles the typed text, as before.
      */
     onBlurCommit?: () => void;
+    /**
+     * `lookup.onPickerOpen` (Tekax B.4.1), bound to the row: a "…" button and
+     * Ctrl+Enter open the app's picker; its item is picked like a list item.
+     */
+    onPickerOpen?: (text: string) => Promise<LookupItem | null> | LookupItem | null;
+    /**
+     * The grid's `suspendBlurCommit` (P-4.1): held while the picker is open, so
+     * focus going to the app's dialog neither commits the cell nor sends the row.
+     */
+    suspendBlurCommit?: (on: boolean, restoreTo?: () => HTMLElement | null) => void;
 }
 /**
  * The same match, as items. Kept for callers and tests that want the simple
@@ -3039,7 +3080,7 @@ interface GridLookupEditorProps {
  */
 declare function matchOptions(options: readonly LookupItem[], query: string, mode: LookupMatchMode): readonly LookupItem[];
 /** The editor's settings that come straight from a column's `lookup`. */
-type LookupEditorSettings = Pick<GridLookupEditorProps, 'matchMode' | 'codeMatchMode' | 'linked' | 'allowCustom' | 'autoCompleteSingle' | 'onNoMatch' | 'matchFold' | 'openOnEdit' | 'restrictInput' | 'typeAhead'>;
+type LookupEditorSettings = Pick<GridLookupEditorProps, 'matchMode' | 'codeMatchMode' | 'linked' | 'allowCustom' | 'autoCompleteSingle' | 'onNoMatch' | 'matchFold' | 'openOnEdit' | 'restrictInput' | 'typeAhead' | 'listResizable' | 'listColumns' | 'dropButton'>;
 /** `lookup` → the editor's props, one reading for the cell, row and form editors. */
 declare function lookupEditorSettings(lookup: ColumnLookup<never> | undefined): LookupEditorSettings;
 /**
@@ -3048,10 +3089,16 @@ declare function lookupEditorSettings(lookup: ColumnLookup<never> | undefined):
  * neither — a plain pick, one cell, as before.
  */
 declare function lookupPickValues(lookup: ColumnLookup<never> | undefined, columnId: string, item: LookupItem): Record<string, unknown> | null;
-declare function GridLookupEditor({ options, value, matchMode, codeMatchMode, matchFold, linked, allowCustom, openOnEdit, seeded, restrictInput, typeAhead, autoCompleteSingle, onNoMatch, onPick, invalid, autoFocus, testId, columnId, ariaLabel, onChange, onCommit, commitOnPick, onCancel, onTab, onBlurCommit, }: GridLookupEditorProps): react.JSX.Element;
+declare function GridLookupEditor({ options, value, matchMode, codeMatchMode, matchFold, linked, allowCustom, openOnEdit, seeded, restrictInput, typeAhead, listResizable, listColumns, dropButton, autoCompleteSingle, onNoMatch, onPick, invalid, disabled, autoFocus, testId, columnId, ariaLabel, onChange, onCommit, commitOnPick, onCancel, onTab, onBlurCommit, onPickerOpen, suspendBlurCommit, }: GridLookupEditorProps): react.JSX.Element;
 
 interface GridCellEditorProps {
     value: unknown;
+    /** The column's lookup when it is `multiple` (Tekax B.6): the check-box editor. */
+    multipleLookup?: ColumnLookup<never>;
+    /** `lookup.onPickerOpen`, bound to this cell (Tekax B.4.1). */
+    onPickerOpen?: GridLookupEditorProps['onPickerOpen'];
+    /** The grid's `suspendBlurCommit`, held while that picker is open. */
+    suspendBlurCommit?: GridLookupEditorProps['suspendBlurCommit'];
     dataType: GridDataType | undefined;
     /**
      * Choices for a lookup/select editor. `null` means the list is still being
@@ -3106,7 +3153,7 @@ interface GridCellEditorProps {
     onTab: (direction: 1 | -1) => void;
     onCancel: () => void;
 }
-declare function GridCellEditor({ value, dataType, error, seeded, seedText, options, allowCustom, matchMode, lookupSettings, onPick, ariaLabel, dateFormat, numberFormat, numberLocale, onChange, onCommit, onTab, onCancel, }: GridCellEditorProps): react.JSX.Element;
+declare function GridCellEditor({ value, dataType, error, seeded, seedText, options, allowCustom, matchMode, lookupSettings, onPick, multipleLookup, onPickerOpen, suspendBlurCommit, ariaLabel, dateFormat, numberFormat, numberLocale, onChange, onCommit, onTab, onCancel, }: GridCellEditorProps): react.JSX.Element;
 
 interface GridDateEditorProps {
     value: unknown;