@kanunilabs/datagrid-react 1.8.11 → 1.8.13

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> {
@@ -2485,11 +2507,13 @@ interface GridSurfaceProviderProps {
     theme?: GridThemeName;
     density?: GridDensity;
     palette?: GridPaletteName;
+    /** Dark tokens for the popups too (`LookupBox` `dark`, B.9.13). */
+    dark?: boolean;
     /** Where popups are drawn (the grid's `portalContainer`). Default <body>. */
     portalContainer?: PortalContainer;
     children: ReactNode;
 }
-declare function GridSurfaceProvider({ theme, density, palette, portalContainer, children, }: GridSurfaceProviderProps): react.JSX.Element;
+declare function GridSurfaceProvider({ theme, density, palette, dark, portalContainer, children, }: GridSurfaceProviderProps): react.JSX.Element;
 /**
  * The element a popup is portalled into, read when the popup opens: <body>,
  * or the host inside the grid's `portalContainer` (core `portalTarget`).
@@ -2738,11 +2762,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
@@ -2966,6 +2991,13 @@ interface GridLookupEditorProps {
      * field would open its list at once.
      */
     openOnEdit?: boolean;
+    /**
+     * Focusing or clicking the box opens the list. Default false (Tekax B.9.3):
+     * the list opens on typing, ▾, F4, Alt+Down, Space (`editKeys.space`) or,
+     * with `openOnEdit`, when the editor starts — so a Tab into a form field or
+     * an editor opened with Enter shows the value, not a list over the rows.
+     */
+    openOnFocus?: boolean;
     /**
      * The editor was opened by TYPING and `value` is that one character: the
      * box starts with it as the typed text (list filtered by it, caret after
@@ -2985,6 +3017,48 @@ 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;
+    /**
+     * What the box shows and completes against (`lookup.display`, B.9.1):
+     * `'code'`, `'name'` or `'both'`. Default: `'code'` for a `linked` list, the
+     * label otherwise.
+     */
+    display?: 'code' | 'name' | 'both';
+    /**
+     * Does the pointer over an item move the highlight (what Enter, Tab and
+     * leaving write)? Default true. False (B.9.6, `LookupBox`'s default): the
+     * pointer only marks the item it is over; the keyboard's highlight stays.
+     */
+    hoverHighlights?: boolean;
+    /** `lookup.openHighlight`: `'current'` opens on the current item, or the first (Tekax, 2026-11-12). */
+    openHighlight?: 'none' | 'current';
+    /** Text emptied and left: the value becomes null (B.9.7, `LookupBox`). Default false. */
+    clearable?: boolean;
+    /**
+     * The list is on its way (B.9.8): typing is not refused, Enter picks
+     * nothing, the list says so; once it arrives the text is checked against it
+     * (cut back to what still matches) and completed.
+     */
+    loading?: boolean;
+    /** Keys the box does not use (Insert, Ctrl+Delete, F-keys) go on to the page (B.9.9, `LookupBox`). */
+    passKeys?: boolean;
+    /** The "…" button is a Tab stop; Enter, Space, F4 and Alt+Down on it open the picker (B.9.14). */
+    pickerTabStop?: boolean;
+    /** `'picker-first'`: [box][…][▾] (B.9.14). Default [box][▾][…]. */
+    buttonOrder?: 'drop-first' | 'picker-first';
+    /** The buttons' accessible names (B.9.14): default "Choose from the full list" and the field's name. */
+    pickerLabel?: string;
+    dropLabel?: string;
+    /** On the BOX (B.9.11): its id (for `<label for>`), form name, required, described-by. */
+    inputId?: string;
+    name?: string;
+    required?: boolean;
+    describedBy?: string;
     /**
      * 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 +3077,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 +3108,22 @@ 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 grid's `setEditFlusher` (B.12.5 / B.9.19): the editor registers its
+     * leaving rule, so a commit the editor did not start (`stopEditing()`,
+     * `ctx.commit()`, a press elsewhere) writes what Tab would.
+     */
+    registerFlush?: (flush: (() => boolean) | null) => void;
 }
 /**
  * The same match, as items. Kept for callers and tests that want the simple
@@ -3039,19 +3131,22 @@ 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' | 'display' | 'hoverHighlights' | 'openHighlight'>;
 /** `lookup` → the editor's props, one reading for the cell, row and form editors. */
 declare function lookupEditorSettings(lookup: ColumnLookup<never> | undefined): LookupEditorSettings;
-/**
- * What one pick writes to the row (P-5.2 / P-5.3): the column's own value,
- * `linkedColumns`' code / name / id, then `map`. Null when the column has
- * 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, openOnFocus, display, hoverHighlights, openHighlight, clearable, loading, passKeys, pickerTabStop, buttonOrder, pickerLabel, dropLabel, inputId, name, required, describedBy, autoCompleteSingle, onNoMatch, onPick, invalid, disabled, autoFocus, testId, columnId, ariaLabel, onChange, onCommit, commitOnPick, onCancel, onTab, onBlurCommit, onPickerOpen, suspendBlurCommit, registerFlush, }: 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 engine's `setEditFlusher` (B.12.5): lookup and date editors register their leaving rule. */
+    registerFlush?: (flush: (() => boolean) | null) => void;
+    /** 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 +3201,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, registerFlush, ariaLabel, dateFormat, numberFormat, numberLocale, onChange, onCommit, onTab, onCancel, }: GridCellEditorProps): react.JSX.Element;
 
 interface GridDateEditorProps {
     value: unknown;
@@ -3137,13 +3232,15 @@ interface GridDateEditorProps {
      * only settles the typed text, as before.
      */
     onBlurCommit?: () => void;
+    /** The grid's `setEditFlusher` (B.12.5): a commit from elsewhere writes the typed (or cleared) day first. */
+    registerFlush?: (flush: (() => boolean) | null) => void;
     /**
      * Digits the box starts with — the editor was opened by typing one on the
      * cell (P-3.6). The caret goes after them instead of selecting.
      */
     seedDigits?: string;
 }
-declare function GridDateEditor({ value, format, invalid, disabled, autoFocus, testId, columnId, ariaLabel, onChange, onCommit, onCancel, onTab, onBlurCommit, seedDigits, }: GridDateEditorProps): react.JSX.Element;
+declare function GridDateEditor({ value, format, invalid, disabled, autoFocus, testId, columnId, ariaLabel, onChange, onCommit, onCancel, onTab, onBlurCommit, registerFlush, seedDigits, }: GridDateEditorProps): react.JSX.Element;
 
 interface GridDialogProps {
     open: boolean;

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> {
@@ -2485,11 +2507,13 @@ interface GridSurfaceProviderProps {
     theme?: GridThemeName;
     density?: GridDensity;
     palette?: GridPaletteName;
+    /** Dark tokens for the popups too (`LookupBox` `dark`, B.9.13). */
+    dark?: boolean;
     /** Where popups are drawn (the grid's `portalContainer`). Default <body>. */
     portalContainer?: PortalContainer;
     children: ReactNode;
 }
-declare function GridSurfaceProvider({ theme, density, palette, portalContainer, children, }: GridSurfaceProviderProps): react.JSX.Element;
+declare function GridSurfaceProvider({ theme, density, palette, dark, portalContainer, children, }: GridSurfaceProviderProps): react.JSX.Element;
 /**
  * The element a popup is portalled into, read when the popup opens: <body>,
  * or the host inside the grid's `portalContainer` (core `portalTarget`).
@@ -2738,11 +2762,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
@@ -2966,6 +2991,13 @@ interface GridLookupEditorProps {
      * field would open its list at once.
      */
     openOnEdit?: boolean;
+    /**
+     * Focusing or clicking the box opens the list. Default false (Tekax B.9.3):
+     * the list opens on typing, ▾, F4, Alt+Down, Space (`editKeys.space`) or,
+     * with `openOnEdit`, when the editor starts — so a Tab into a form field or
+     * an editor opened with Enter shows the value, not a list over the rows.
+     */
+    openOnFocus?: boolean;
     /**
      * The editor was opened by TYPING and `value` is that one character: the
      * box starts with it as the typed text (list filtered by it, caret after
@@ -2985,6 +3017,48 @@ 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;
+    /**
+     * What the box shows and completes against (`lookup.display`, B.9.1):
+     * `'code'`, `'name'` or `'both'`. Default: `'code'` for a `linked` list, the
+     * label otherwise.
+     */
+    display?: 'code' | 'name' | 'both';
+    /**
+     * Does the pointer over an item move the highlight (what Enter, Tab and
+     * leaving write)? Default true. False (B.9.6, `LookupBox`'s default): the
+     * pointer only marks the item it is over; the keyboard's highlight stays.
+     */
+    hoverHighlights?: boolean;
+    /** `lookup.openHighlight`: `'current'` opens on the current item, or the first (Tekax, 2026-11-12). */
+    openHighlight?: 'none' | 'current';
+    /** Text emptied and left: the value becomes null (B.9.7, `LookupBox`). Default false. */
+    clearable?: boolean;
+    /**
+     * The list is on its way (B.9.8): typing is not refused, Enter picks
+     * nothing, the list says so; once it arrives the text is checked against it
+     * (cut back to what still matches) and completed.
+     */
+    loading?: boolean;
+    /** Keys the box does not use (Insert, Ctrl+Delete, F-keys) go on to the page (B.9.9, `LookupBox`). */
+    passKeys?: boolean;
+    /** The "…" button is a Tab stop; Enter, Space, F4 and Alt+Down on it open the picker (B.9.14). */
+    pickerTabStop?: boolean;
+    /** `'picker-first'`: [box][…][▾] (B.9.14). Default [box][▾][…]. */
+    buttonOrder?: 'drop-first' | 'picker-first';
+    /** The buttons' accessible names (B.9.14): default "Choose from the full list" and the field's name. */
+    pickerLabel?: string;
+    dropLabel?: string;
+    /** On the BOX (B.9.11): its id (for `<label for>`), form name, required, described-by. */
+    inputId?: string;
+    name?: string;
+    required?: boolean;
+    describedBy?: string;
     /**
      * 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 +3077,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 +3108,22 @@ 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 grid's `setEditFlusher` (B.12.5 / B.9.19): the editor registers its
+     * leaving rule, so a commit the editor did not start (`stopEditing()`,
+     * `ctx.commit()`, a press elsewhere) writes what Tab would.
+     */
+    registerFlush?: (flush: (() => boolean) | null) => void;
 }
 /**
  * The same match, as items. Kept for callers and tests that want the simple
@@ -3039,19 +3131,22 @@ 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' | 'display' | 'hoverHighlights' | 'openHighlight'>;
 /** `lookup` → the editor's props, one reading for the cell, row and form editors. */
 declare function lookupEditorSettings(lookup: ColumnLookup<never> | undefined): LookupEditorSettings;
-/**
- * What one pick writes to the row (P-5.2 / P-5.3): the column's own value,
- * `linkedColumns`' code / name / id, then `map`. Null when the column has
- * 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, openOnFocus, display, hoverHighlights, openHighlight, clearable, loading, passKeys, pickerTabStop, buttonOrder, pickerLabel, dropLabel, inputId, name, required, describedBy, autoCompleteSingle, onNoMatch, onPick, invalid, disabled, autoFocus, testId, columnId, ariaLabel, onChange, onCommit, commitOnPick, onCancel, onTab, onBlurCommit, onPickerOpen, suspendBlurCommit, registerFlush, }: 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 engine's `setEditFlusher` (B.12.5): lookup and date editors register their leaving rule. */
+    registerFlush?: (flush: (() => boolean) | null) => void;
+    /** 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 +3201,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, registerFlush, ariaLabel, dateFormat, numberFormat, numberLocale, onChange, onCommit, onTab, onCancel, }: GridCellEditorProps): react.JSX.Element;
 
 interface GridDateEditorProps {
     value: unknown;
@@ -3137,13 +3232,15 @@ interface GridDateEditorProps {
      * only settles the typed text, as before.
      */
     onBlurCommit?: () => void;
+    /** The grid's `setEditFlusher` (B.12.5): a commit from elsewhere writes the typed (or cleared) day first. */
+    registerFlush?: (flush: (() => boolean) | null) => void;
     /**
      * Digits the box starts with — the editor was opened by typing one on the
      * cell (P-3.6). The caret goes after them instead of selecting.
      */
     seedDigits?: string;
 }
-declare function GridDateEditor({ value, format, invalid, disabled, autoFocus, testId, columnId, ariaLabel, onChange, onCommit, onCancel, onTab, onBlurCommit, seedDigits, }: GridDateEditorProps): react.JSX.Element;
+declare function GridDateEditor({ value, format, invalid, disabled, autoFocus, testId, columnId, ariaLabel, onChange, onCommit, onCancel, onTab, onBlurCommit, registerFlush, seedDigits, }: GridDateEditorProps): react.JSX.Element;
 
 interface GridDialogProps {
     open: boolean;