@acorex/components 22.1.0-next.9 → 22.1.1

package/lookup/README.md

@@ -1,6 +1,6 @@
 # @acorex/components/lookup
 
-An advanced drop-down (lookup) component with five modes, `AXDataSource` support, and virtual scrolling.
+An advanced drop-down (lookup) component with six modes, `AXDataSource` support, and virtual scrolling.
 
 ## Modes
 
@@ -11,6 +11,7 @@ An advanced drop-down (lookup) component with five modes, `AXDataSource` support
 | `drop-down-tree`    | A tree-like structure for single item selection.                    |
 | `multi-select-tree` | A tree-like structure for multiple item selection.                  |
 | `multi-column`      | An `ax-data-table` grid; further pages load on scroll.              |
+| `multi-column-tree` | A multi-column table with a drop-down tree inside it (expandable rows). |
 
 ## Usage
 
@@ -42,22 +43,32 @@ import { AXDataSource } from '@acorex/cdk/common';
 
 <!-- MultiColumnComboBox -->
 <ax-lookup mode="multi-column" [dataSource]="items" [columns]="columns" [(ngModel)]="selected"></ax-lookup>
+
+<!-- MultiColumnTree (table + expandable tree) -->
+<ax-lookup
+  mode="multi-column-tree"
+  [treeDataSource]="nodes"
+  [columns]="columns"
+  textField="title"
+  [(ngModel)]="selectedNode"
+></ax-lookup>
 ```
 
 Value binding uses the signal `value` model (`FormValueControl`) — prefer `[(ngModel)]` (or `[(value)]` / signal forms). No `ControlValueAccessor`.
 
-- `dataSource`: `AXDataSource` or a plain array (list and multi-column modes). Supports remote paging, `byKey` value resolution, and server-side filtering.
+- `dataSource`: `AXDataSource` or a plain array (list and multi-column modes). Supports remote paging, `byKey` value resolution, and server-side filtering. Also used by `multi-column-tree` when `treeDataSource` is not set (hierarchical load via `treeParentField`).
 - `valueItems`: full items that resolve the current `value` key(s) without calling `byKey` (useful when the parent already loaded the selected entity). Missing keys still fall through to `find` / `byKey`. You can also call `seedItems(items)` imperatively.
-- `treeDataSource`: node array or lazy children callback (tree modes).
+- `treeDataSource`: node array or lazy children callback (tree modes, including `multi-column-tree`).
 - `valueField` / `textField` / `disabledField`: field mappings. For tree modes these map to the tree `idField` / `titleField`.
-- `columns`: column definitions (`{ field, title, width? }`) for `multi-column` mode (mapped to `ax-text-column`).
-- `searchable`: when `true` (default), the trigger accepts typing and filters the list (`drop-down-list`, `multi-select`, `multi-column`). When `false`, the trigger is select-only. Tree modes have no search UI.
+- `columns`: column definitions (`{ field, title, width?, expandHandler? }`) for `multi-column` and `multi-column-tree` (mapped to `ax-text-column`).
+- `treeParentField` / `hasChildrenField`: hierarchy fields for `multi-column-tree` (defaults `parentId` / `hasChild`).
+- `searchable`: when `true` (default), the trigger accepts typing and filters the list or tree in every mode. Nested array trees keep matching branches and expand ancestors of hits; lazy callback trees filter each loaded level (unloaded descendants are not searched). When `false`, the trigger is select-only.
 - `adaptivityEnabled`: when `true` (default), the list opens as a bottom actionsheet on small screens instead of a dropdown; set `false` to always use the anchored dropdown.
 - `caption`: title shown in the actionsheet header (falls back to `placeholder`).
-- `alternate`: when `true`, list rows use alternating background colors for easier scanning (`drop-down-list`, `multi-select`, `multi-column`).
-- `searchPlaceholder`: placeholder for the multi-select trigger search input when chips are already selected.
+- `alternate`: when `true`, list rows use alternating background colors for easier scanning (all modes, including tree).
+- `searchPlaceholder`: placeholder for the multi-select / multi-select-tree trigger search input when chips are already selected.
 - `itemHeight` / `maxVisibleItems`: list virtual-scroll sizing, and multi-column table viewport height (multi-column loads more pages on scroll, not via a pager).
 - `look`: the same editor-container look schemes as other editors like `ax-text-box`.
 - `ax-prefix` / `ax-suffix`: project decorators into the editor container.
 
-Each mode is rendered by its own internal mini component (`ax-lookup-drop-down-list`, `ax-lookup-multi-select`, `ax-lookup-drop-down-tree`, `ax-lookup-multi-select-tree`, `ax-lookup-multi-column`), all exported for direct use.
+Each mode is rendered by its own internal mini component (`ax-lookup-drop-down-list`, `ax-lookup-multi-select`, `ax-lookup-drop-down-tree`, `ax-lookup-multi-select-tree`, `ax-lookup-multi-column`, `ax-lookup-multi-column-tree`), all exported for direct use.

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@acorex/components",
-  "version": "22.1.0-next.9",
+  "version": "22.1.1",
   "peerDependencies": {
-    "@acorex/core": "22.1.0-next.9",
-    "@acorex/cdk": "22.1.0-next.9",
+    "@acorex/core": "22.1.1",
+    "@acorex/cdk": "22.1.1",
+    "@angular/aria": ">=22.1.0",
     "polytype": ">=0.17.0",
     "angular-imask": ">=7.6.1",
     "imask": ">=7.6.1",

package/types/acorex-components-audio-wave.d.ts

@@ -84,12 +84,15 @@ declare class AXAudioWaveComponent implements OnDestroy {
      *
      */
     getMediaElement(): HTMLMediaElement;
+    getCurrentTime(): number;
     /**
      * Sets the playback rate of the audio.
      *
      * @param rate - The playback rate to set.
      */
     setRate(rate: number): void;
+    setMuted(muted: boolean): void;
+    isMuted(): boolean;
     /**
      *  @ignore
      */

package/types/acorex-components-calendar.d.ts

@@ -71,6 +71,7 @@ interface AXCalendarViewSlot {
 interface AXCalendarView {
     range: AXDateTimeRange;
     slots: AXCalendarViewSlot[];
+    weekCount?: number;
 }
 declare class MXCalendarBaseComponent extends MXBaseComponent {
     protected localeService: AXLocaleService;
@@ -134,8 +135,8 @@ declare const AXCalendarRangeComponent_base: polytype.Polytype.ClusteredConstruc
     ɵprov: _angular_core.ɵɵInjectableDeclaration<MXValueComponent<any>>;
 }, typeof MXInteractiveComponent, typeof MXCalendarBaseComponent]>;
 declare class AXCalendarRangeComponent extends AXCalendarRangeComponent_base implements AfterViewInit {
-    private formatService;
     private unsubscriber;
+    protected readonly isRtl: _angular_core.Signal<boolean>;
     protected calendar: _angular_core.WritableSignal<string>;
     /**
      * Day view navigation style passed through to embedded calendars.
@@ -151,7 +152,8 @@ declare class AXCalendarRangeComponent extends AXCalendarRangeComponent_base imp
     private _calendarService;
     private _c1;
     private _c2;
-    _navText: string;
+    _navText1: string;
+    _navText2: string;
     /**
      *  @ignore
      */
@@ -164,6 +166,14 @@ declare class AXCalendarRangeComponent extends AXCalendarRangeComponent_base imp
      *  @ignore
      */
     private _refreshCalendars;
+    /**
+     *  @ignore
+     */
+    private _scheduleNavTextSync;
+    /**
+     *  @ignore
+     */
+    private _ensureCalendarsReady;
     /**
      *  @ignore
      */
@@ -173,10 +183,10 @@ declare class AXCalendarRangeComponent extends AXCalendarRangeComponent_base imp
      */
     ngAfterViewInit(): void;
     internalValueChanged(value: any): void;
-    /** w
+    /**
      *  @ignore
      */
-    getCellClass: (date: AXDateTime) => "ax-range-start" | "ax-range-end" | "ax-range-between";
+    getCellClass: (date: AXDateTime) => string;
     /**
      *  @ignore
      */
@@ -197,6 +207,18 @@ declare class AXCalendarRangeComponent extends AXCalendarRangeComponent_base imp
      *  @ignore
      */
     private _syncNavText;
+    /**
+     *  @ignore
+     */
+    private _formatNavDate;
+    /**
+     *  @ignore
+     */
+    private _monthLabel;
+    /**
+     *  @ignore
+     */
+    private _fallbackMonthName;
     /**
      *  @ignore
      */
@@ -213,12 +235,16 @@ declare class AXCalendarRangeComponent extends AXCalendarRangeComponent_base imp
      *  @ignore
      */
     private _syncNav1;
+    /**
+     *  @ignore
+     */
+    protected handleCalendar2Navigate(): void;
     /**
      *  @ignore
      */
     private _syncNav2;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCalendarRangeComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXCalendarRangeComponent, "ax-calendar-range", never, { "rtl": { "alias": "rtl"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "value": { "alias": "value"; "required": false; }; "name": { "alias": "name"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "depth": { "alias": "depth"; "required": false; }; "activeView": { "alias": "activeView"; "required": false; }; "minValue": { "alias": "minValue"; "required": false; }; "maxValue": { "alias": "maxValue"; "required": false; }; "disabledDates": { "alias": "disabledDates"; "required": false; }; "holidayDates": { "alias": "holidayDates"; "required": false; }; "type": { "alias": "type"; "required": false; }; "dayCellTemplate": { "alias": "dayCellTemplate"; "required": false; }; "monthCellTemplate": { "alias": "monthCellTemplate"; "required": false; }; "yearCellTemplate": { "alias": "yearCellTemplate"; "required": false; }; "cellClass": { "alias": "cellClass"; "required": false; }; "showNavigation": { "alias": "showNavigation"; "required": false; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "holidays": { "alias": "holidays"; "required": false; "isSignal": true; }; }, { "onOptionChanged": "onOptionChanged"; "valueChange": "valueChange"; "onValueChanged": "onValueChanged"; "onBlur": "onBlur"; "onFocus": "onFocus"; "depthChange": "depthChange"; "typeChange": "typeChange"; "activeViewChange": "activeViewChange"; "disabledDatesChange": "disabledDatesChange"; "holidayDatesChange": "holidayDatesChange"; "onNavigate": "onNavigate"; "onSlotClick": "onSlotClick"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXCalendarRangeComponent, "ax-calendar-range", never, { "rtl": { "alias": "rtl"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "value": { "alias": "value"; "required": false; }; "name": { "alias": "name"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "depth": { "alias": "depth"; "required": false; }; "activeView": { "alias": "activeView"; "required": false; }; "minValue": { "alias": "minValue"; "required": false; }; "maxValue": { "alias": "maxValue"; "required": false; }; "disabledDates": { "alias": "disabledDates"; "required": false; }; "holidayDates": { "alias": "holidayDates"; "required": false; }; "type": { "alias": "type"; "required": false; }; "dayCellTemplate": { "alias": "dayCellTemplate"; "required": false; }; "monthCellTemplate": { "alias": "monthCellTemplate"; "required": false; }; "yearCellTemplate": { "alias": "yearCellTemplate"; "required": false; }; "cellClass": { "alias": "cellClass"; "required": false; }; "showNavigation": { "alias": "showNavigation"; "required": false; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "holidays": { "alias": "holidays"; "required": false; "isSignal": true; }; }, { "onOptionChanged": "onOptionChanged"; "valueChange": "valueChange"; "onValueChanged": "onValueChanged"; "onBlur": "onBlur"; "onFocus": "onFocus"; "depthChange": "depthChange"; "typeChange": "typeChange"; "activeViewChange": "activeViewChange"; "disabledDatesChange": "disabledDatesChange"; "holidayDatesChange": "holidayDatesChange"; "onNavigate": "onNavigate"; "onSlotClick": "onSlotClick"; }, never, ["ax-footer"], true, never>;
 }
 
 declare const AXCalendarComponent_base: polytype.Polytype.ClusteredConstructor<[{
@@ -255,8 +281,11 @@ declare class AXCalendarComponent extends AXCalendarComponent_base {
     holidays: _angular_core.InputSignal<AXCalendarHolidaysLoader>;
     protected readonly isRtl: _angular_core.Signal<boolean>;
     protected calendar: _angular_core.WritableSignal<string>;
+    /** Explicit `type` input wins over the locale profile calendar. */
+    protected calendarSystem: _angular_core.Signal<string>;
     /** Week column order from the active locale profile (0 = Sun … 6 = Sat). */
     protected weekLayout: _angular_core.Signal<number[]>;
+    protected weekdayLabel(index: number): string;
     get displayRange(): AXDateTimeRange | null;
     /**
      *  @ignore
@@ -317,10 +346,6 @@ declare class AXCalendarComponent extends AXCalendarComponent_base {
      *  @ignore
      */
     private _initValues;
-    /**
-     * Maps a date to a 1-based grid column using the active week layout.
-     */
-    private _getWeekColumn;
     /**
      * Defers refresh so explicit `type` input can sync after locale profile changes.
      */
@@ -345,6 +370,7 @@ declare class AXCalendarComponent extends AXCalendarComponent_base {
      *  @ignore
      */
     private _updateSelectOptions;
+    private _createMonthDate;
     /**
      *  @ignore
      */
@@ -357,6 +383,10 @@ declare class AXCalendarComponent extends AXCalendarComponent_base {
      *  @ignore
      */
     private _getSelectBoxValue;
+    /**
+     * Builds the day grid for a single month (no leading/trailing days from adjacent months).
+     */
+    private _getDayGridRange;
     /**
      *  @ignore
      */
@@ -486,6 +516,8 @@ declare class AXCalendarComponent extends AXCalendarComponent_base {
      *  @ignore
      */
     protected getMonthName(date: AXDateTime, style: 'short' | 'long'): string;
+    private monthLabel;
+    private fallbackMonthName;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCalendarComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXCalendarComponent, "ax-calendar", never, { "rtl": { "alias": "rtl"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "value": { "alias": "value"; "required": false; }; "name": { "alias": "name"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "depth": { "alias": "depth"; "required": false; }; "activeView": { "alias": "activeView"; "required": false; }; "minValue": { "alias": "minValue"; "required": false; }; "maxValue": { "alias": "maxValue"; "required": false; }; "disabledDates": { "alias": "disabledDates"; "required": false; }; "holidayDates": { "alias": "holidayDates"; "required": false; }; "type": { "alias": "type"; "required": false; }; "dayCellTemplate": { "alias": "dayCellTemplate"; "required": false; }; "monthCellTemplate": { "alias": "monthCellTemplate"; "required": false; }; "yearCellTemplate": { "alias": "yearCellTemplate"; "required": false; }; "cellClass": { "alias": "cellClass"; "required": false; }; "showNavigation": { "alias": "showNavigation"; "required": false; }; "count": { "alias": "count"; "required": false; }; "id": { "alias": "id"; "required": false; }; "weekend": { "alias": "weekend"; "required": false; "isSignal": true; }; "weekdays": { "alias": "weekdays"; "required": false; "isSignal": true; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "yearRange": { "alias": "yearRange"; "required": false; "isSignal": true; }; "holidays": { "alias": "holidays"; "required": false; "isSignal": true; }; }, { "onOptionChanged": "onOptionChanged"; "valueChange": "valueChange"; "onValueChanged": "onValueChanged"; "minValueChange": "minValueChange"; "maxValueChange": "maxValueChange"; "onBlur": "onBlur"; "onFocus": "onFocus"; "depthChange": "depthChange"; "typeChange": "typeChange"; "activeViewChange": "activeViewChange"; "disabledDatesChange": "disabledDatesChange"; "holidayDatesChange": "holidayDatesChange"; "onNavigate": "onNavigate"; "onSlotClick": "onSlotClick"; "countChange": "countChange"; }, never, ["ax-header", "ax-footer"], true, never>;
 }

package/types/acorex-components-combo-box.d.ts

@@ -1,7 +1,8 @@
 import * as _angular_core from '@angular/core';
-import { TemplateRef } from '@angular/core';
-import { NXValueComponent, AXStyleLookType, AXValueChangedEvent, AXFocusEvent, AXItemClickEvent, AXItemSelectedEvent, AXEvent } from '@acorex/cdk/common';
+import { TemplateRef, ElementRef } from '@angular/core';
+import { NXValueComponent, AXStyleLookType, AXValueChangedEvent, AXFocusEvent, AXItemClickEvent, AXItemSelectedEvent, AXEvent, AXHtmlEvent } from '@acorex/cdk/common';
 import { AXPopoverComponent } from '@acorex/components/popover';
+import { AXSearchBoxComponent } from '@acorex/components/search-box';
 import { Combobox } from '@angular/aria/combobox';
 import { Listbox } from '@angular/aria/listbox';
 import { FormValueControl } from '@angular/forms/signals';
@@ -28,12 +29,14 @@ type AXComboBoxValue = string | number | (string | number)[] | null;
  * A minimal combo box for selecting one or more values from a list of items.
  *
  * Built on top of the `@angular/aria/combobox` directives, it supports two behaviors:
- * - `searchable="true"` (default): an input with typeahead filtering (matches `id`).
+ * - `searchable="true"` (default): an input with typeahead filtering (matches `id`). On small
+ *   screens with `adaptivityEnabled`, the trigger is select-like and search moves into the actionsheet.
  * - `searchable="false"`: a select-like, non-editable trigger (same input; typing blocked without
  *   Combobox `readonly`, so Tab focus and keyboard open/select keep working).
  *
  * With `multiple="true"`, selected values are shown as chips in the trigger and the popup stays
- * open while toggling items (same interaction model as `ax-lookup` multi-select).
+ * open while toggling items (same interaction model as `ax-lookup` multi-select). Backspace with
+ * an empty trigger input removes the last chip; repeated presses clear the whole selection.
  *
  * With `adaptivityEnabled` (default `true`), the list opens as a bottom actionsheet on small
  * screens instead of an anchored dropdown — the same alternate presentation as `ax-select-box`.
@@ -58,6 +61,7 @@ declare class AXComboBoxComponent extends NXValueComponent implements FormValueC
     /**
      * Whether the combo box accepts typing and filters the list (`true`),
      * or is a select-like, non-editable trigger (`false`).
+     * On small screens with `adaptivityEnabled`, search is typed in the actionsheet instead of the trigger.
      */
     searchable: _angular_core.InputSignal<boolean>;
     /**
@@ -67,7 +71,8 @@ declare class AXComboBoxComponent extends NXValueComponent implements FormValueC
     multiple: _angular_core.InputSignal<boolean>;
     /**
      * When `true` (default), the popup list uses the alternate actionsheet presentation on small
-     * screens (`SM`). When `false`, the list always opens as an anchored dropdown.
+     * screens (`SM`). Searchable mode then shows a search field inside the sheet. When `false`,
+     * the list always opens as an anchored dropdown.
      */
     adaptivityEnabled: _angular_core.InputSignal<boolean>;
     /**
@@ -83,10 +88,16 @@ declare class AXComboBoxComponent extends NXValueComponent implements FormValueC
      */
     placeholder: _angular_core.InputSignal<string>;
     /**
-     * Placeholder for the trigger search input when items are already selected (multi-select).
-     * Falls back to `placeholder` when the selection is empty.
+     * Placeholder for the trigger search input when items are already selected (multi-select),
+     * and for the in-sheet search field on small screens. Falls back to `placeholder` when the
+     * selection is empty on desktop.
      */
     searchPlaceholder: _angular_core.InputSignal<string>;
+    /**
+     * When `true` (default), matching characters in popup result items are highlighted
+     * while the user searches.
+     */
+    highlightSearch: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * Custom template rendered when the filtered list has no items.
      * When omitted, a default "no result found" message is shown.
@@ -154,6 +165,12 @@ declare class AXComboBoxComponent extends NXValueComponent implements FormValueC
     protected expanded: _angular_core.WritableSignal<boolean>;
     /** Whether the list is currently shown as a bottom actionsheet (small screens + adaptivity). */
     protected isActionsheetStyle: _angular_core.WritableSignal<boolean>;
+    /** Whether the trigger input is writable and filters as you type (desktop searchable only). */
+    protected isEditableTrigger: _angular_core.Signal<boolean>;
+    /** Whether search is typed in the actionsheet instead of the trigger. */
+    protected isSheetSearchEnabled: _angular_core.Signal<boolean>;
+    /** Query typed in the actionsheet search field (independent of the trigger display text). */
+    protected sheetSearchText: _angular_core.WritableSignal<string>;
     /** The current selection normalized to an array of submitted values. */
     protected selectedValues: _angular_core.Signal<(string | number)[]>;
     /** Whether there is at least one selected value. */
@@ -175,11 +192,20 @@ declare class AXComboBoxComponent extends NXValueComponent implements FormValueC
     protected triggerSearchPlaceholder: _angular_core.Signal<string>;
     /** The listbox selection (item ids), kept in sync with the selected value(s). */
     protected selection: _angular_core.WritableSignal<string[]>;
+    /** Active search query used for filtering and highlighting. */
+    protected searchQuery: _angular_core.Signal<string>;
+    /** Query passed to result-item highlighting (empty when disabled). */
+    protected highlightQuery: _angular_core.Signal<string>;
     /** Items filtered by typed query against `id` when the combo box is searchable. */
     protected filteredItems: _angular_core.Signal<AXComboBoxItem[]>;
+    /** Whether the filtered list is empty (empty-state vs hidden listbox). */
+    protected hasNoMatches: _angular_core.Signal<boolean>;
     protected comboboxRef: _angular_core.Signal<Combobox>;
     protected listboxRef: _angular_core.Signal<Listbox<any>>;
     protected popoverRef: _angular_core.Signal<AXPopoverComponent>;
+    protected originRef: _angular_core.Signal<ElementRef<HTMLElement>>;
+    protected popupRef: _angular_core.Signal<ElementRef<HTMLElement>>;
+    protected sheetSearchRef: _angular_core.Signal<AXSearchBoxComponent>;
     constructor();
     /** Stable unique key for `@for` — avoids NG0955 when `id` is missing or duplicated. */
     protected trackItemKey(index: number, item: AXComboBoxItem): string;
@@ -191,12 +217,24 @@ declare class AXComboBoxComponent extends NXValueComponent implements FormValueC
     protected onTriggerClick(): void;
     /**
      * Keyboard handling on the trigger:
+     * - Searchable: Enter never submits the form; with no matches the value is cleared (`null`).
      * - Non-searchable: open with Enter/Space when collapsed; commit with Space when expanded.
-     * - Multi-select: Backspace removes the last chip when the search input is empty.
+     * - Multi-select: Backspace with an empty trigger input removes the last chip; repeated presses
+     *   clear the whole selection.
      */
     protected onTriggerKeydown(event: KeyboardEvent): void;
-    /** Blocks typing in non-searchable mode without Combobox `readonly` (keeps Tab/keyboard working). */
+    /** Handles Enter in the actionsheet search field (no form submit; clear on no matches). */
+    protected onSheetSearchKeydown(e: AXHtmlEvent<KeyboardEvent>): void;
+    /** Blocks typing when the trigger is not editable (keeps Tab / keyboard open working). */
     protected onBeforeInput(event: Event): void;
+    /**
+     * Combobox `expanded` two-way binding. On actionsheet with in-sheet search, ignore collapse
+     * so focusing the search field (Aria combobox blur) does not close the popup. Dismiss is owned
+     * by the header Apply/close button, `commit()`, and Escape. On desktop, outside click also closes.
+     */
+    protected onExpandedChange(open: boolean): void;
+    /** Filters the list from the actionsheet search field (reads the input so delayed ngModel cannot block typing). */
+    protected onSheetSearchInput(): void;
     /**
      * Keeps the combobox expanded state in sync when the popover closes (e.g. click outside).
      */
@@ -227,7 +265,9 @@ declare class AXComboBoxComponent extends NXValueComponent implements FormValueC
      * that option. Clicks resolve from the event target so we do not depend on listener order vs ngListbox.
      *
      * In multi-select mode the item is toggled and the popup stays open.
+     * When the user typed a query with no matches, Enter clears single-select to `null`.
      */
+    protected onListEnter(event: Event): void;
     protected commit(event?: Event): void;
     /**
      * Focuses the combo box trigger input.
@@ -238,7 +278,7 @@ declare class AXComboBoxComponent extends NXValueComponent implements FormValueC
     /** Forwards native blur from the trigger input. */
     protected emitOnBlur(e: FocusEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXComboBoxComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXComboBoxComponent, "ax-combo-box", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "adaptivityEnabled": { "alias": "adaptivityEnabled"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "selectedTemplate": { "alias": "selectedTemplate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "look": "lookChange"; "value": "valueChange"; "onValueChanged": "onValueChanged"; "onFocus": "onFocus"; "onBlur": "onBlur"; "onItemClick": "onItemClick"; "onItemSelected": "onItemSelected"; "onOpened": "onOpened"; "onClosed": "onClosed"; }, never, ["ax-prefix", "ax-clear-button", "ax-suffix", "ax-header", "ax-footer", "ax-validation-rule"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXComboBoxComponent, "ax-combo-box", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "adaptivityEnabled": { "alias": "adaptivityEnabled"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "highlightSearch": { "alias": "highlightSearch"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "selectedTemplate": { "alias": "selectedTemplate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "look": "lookChange"; "value": "valueChange"; "onValueChanged": "onValueChanged"; "onFocus": "onFocus"; "onBlur": "onBlur"; "onItemClick": "onItemClick"; "onItemSelected": "onItemSelected"; "onOpened": "onOpened"; "onClosed": "onClosed"; }, never, ["ax-prefix", "ax-clear-button", "ax-suffix", "ax-header", "ax-footer", "ax-validation-rule"], true, never>;
 }
 
 declare class AXComboBoxModule {