@kanunilabs/datagrid-react 1.8.12 → 1.8.13

package/dist/index.d.cts

@@ -2507,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`).
@@ -2989,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
@@ -3014,6 +3023,42 @@ interface GridLookupEditorProps {
     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).
@@ -3073,6 +3118,12 @@ interface GridLookupEditorProps {
      * 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
@@ -3080,16 +3131,11 @@ 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' | 'listResizable' | 'listColumns' | 'dropButton'>;
+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, listResizable, listColumns, dropButton, autoCompleteSingle, onNoMatch, onPick, invalid, disabled, autoFocus, testId, columnId, ariaLabel, onChange, onCommit, commitOnPick, onCancel, onTab, onBlurCommit, onPickerOpen, suspendBlurCommit, }: 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;
@@ -3097,6 +3143,8 @@ interface GridCellEditorProps {
     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;
@@ -3153,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, multipleLookup, onPickerOpen, suspendBlurCommit, 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;
@@ -3184,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

@@ -2507,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`).
@@ -2989,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
@@ -3014,6 +3023,42 @@ interface GridLookupEditorProps {
     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).
@@ -3073,6 +3118,12 @@ interface GridLookupEditorProps {
      * 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
@@ -3080,16 +3131,11 @@ 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' | 'listResizable' | 'listColumns' | 'dropButton'>;
+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, listResizable, listColumns, dropButton, autoCompleteSingle, onNoMatch, onPick, invalid, disabled, autoFocus, testId, columnId, ariaLabel, onChange, onCommit, commitOnPick, onCancel, onTab, onBlurCommit, onPickerOpen, suspendBlurCommit, }: 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;
@@ -3097,6 +3143,8 @@ interface GridCellEditorProps {
     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;
@@ -3153,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, multipleLookup, onPickerOpen, suspendBlurCommit, 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;
@@ -3184,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;