@nldd/design-system 0.8.92 → 0.8.94

package/dist/components/actions/menu/menu.d.ts

@@ -50,18 +50,18 @@ export declare class NLDDMenuGroup extends LitElement {
  *
  * @element nldd-menu-item
  *
+ * @attr {boolean} destructive - Marks the item as destructive (red text; red highlight bg). Use for irreversible actions like "Delete". Color is the only built-in signal, so per WCAG 1.4.1 the item's own label must convey the destructive nature (e.g. "Verwijder") — don't rely on the red alone. Confirming the action (e.g. a follow-up dialog) is the consumer's responsibility.
  * @attr {string} text - Display text. Supports **bold** markdown syntax.
- * @attr {string} value - A value of the item's own, read off the item in a `select` handler. The default filter matches on it as well as on `text` and `aliases`. Not a form value: this component is not form-associated.
- * @attr {string} href - Optional link target. A plain button item with an href renders as an `<a>` so it is a real link (middle-click, open in new tab, copy link). Ignored for submenu openers, checkbox/radio items, and while disabled.
- * @attr {string} aliases - Space-separated alternative search terms.
  * @attr {string} details - Secondary label shown on the right side.
+ * @attr {string} icon - Icon name rendered before the text.
  * @attr {string} shortcut - Keyboard shortcut hint shown on the right, e.g. 'Cmd+E'. Display only (rendered via nldd-keyboard-shortcut) — it does not bind the key; wire up the handling in your app. Hidden on touch-only devices, where it isn't invokable.
  * @attr {string} shortcut-mac / shortcut-windows / shortcut-linux - Per-OS overrides for `shortcut`, picked by detected OS (falls back to `shortcut`).
- * @attr {string} icon - Icon name rendered before the text (nldd-icon name).
- * @attr {string} type - Item type: 'button' | 'checkbox' | 'radio'. Default: 'button'.
+ * @attr {string} href - Optional link target. A plain button item with an href renders as an `<a>` so it is a real link (middle-click, open in new tab, copy link). Ignored for submenu openers, checkbox/radio items, and while disabled.
+ * @attr {string} type - Item type: 'button' | 'checkbox' | 'radio'. Default: 'button'. One checkbox or radio item gives every item in its menu the check-mark column, so the text of the whole menu starts at one line, as in a native menu. Submenus decide for themselves.
  * @attr {boolean} selected - Selected state for checkbox and radio types.
- * @attr {boolean} destructive - Marks the item as destructive (red text; red highlight bg). Use for irreversible actions like "Delete". Color is the only built-in signal, so per WCAG 1.4.1 the item's own label must convey the destructive nature (e.g. "Verwijder") — don't rely on the red alone. Confirming the action (e.g. a follow-up dialog) is the consumer's responsibility.
  * @attr {boolean} disabled - Disabled state.
+ * @attr {string} value - A value of the item's own, read off the item in a `select` handler. The default filter matches on it as well as on `text` and `aliases`. Not a form value: this component is not form-associated.
+ * @attr {string} aliases - Space-separated alternative search terms.
  * @attr {string} query - Query substring to bold-highlight in text. Set by menu's filter(); also settable by consumers.
  * @attr {string} query-mark-mode - 'match' | 'predictive' (default: 'predictive'). See text-cell for details.
  *
@@ -69,20 +69,20 @@ export declare class NLDDMenuGroup extends LitElement {
  */
 export declare class NLDDMenuItem extends LitElement {
     static styles: import("lit").CSSResult;
+    destructive: boolean;
     text: string;
-    value: string;
-    href: string;
-    aliases: string;
     details: string;
+    icon: string;
     shortcut: string;
     shortcutMac: string;
     shortcutWindows: string;
     shortcutLinux: string;
-    icon: string;
+    href: string;
     type: 'button' | 'checkbox' | 'radio';
     selected: boolean;
-    destructive: boolean;
     disabled: boolean;
+    value: string;
+    aliases: string;
     query: string;
     queryMarkMode: QueryMarkMode;
     /**
@@ -96,6 +96,10 @@ export declare class NLDDMenuItem extends LitElement {
      * declaration stays what it is.
      */
     menuVariant: 'menu' | 'listbox' | null;
+    /** Whether this item keeps the check-mark column free without being
+     *  checkable, because another item in its menu is. Set by that nldd-menu.
+     *  Not part of the public API. */
+    checkColumn: boolean;
     /** Tracks whether this item's submenu (if any) is currently open. Set by
      * the parent nldd-menu via the `submenu-open`/`submenu-close` lifecycle. */
     _submenuOpen: boolean;
@@ -110,6 +114,7 @@ export declare class NLDDMenuItem extends LitElement {
     get _submenuEl(): NLDDMenu | null;
     get _hasSubmenu(): boolean;
     willUpdate(): void;
+    updated(changedProperties: Map<string, unknown>): void;
     firstUpdated(): void;
     disconnectedCallback(): void;
     _handleClick(event?: Event): void;
@@ -129,12 +134,12 @@ export declare class NLDDMenuItem extends LitElement {
  *
  * @element nldd-menu
  *
+ * @attr {string} width - Explicit width, pinned exactly. Without it the menu sizes to its content between a minimum and a viewport-aware maximum (min(100vw - inset, 640px)).
  * @attr {string} anchor - ID of the anchor element. Positions the menu against it AND makes it a toggle: the menu listens on document click and opens/closes itself when the click lands on the anchor. Use this for a menu hung off a button. For a menu you open yourself (a type-ahead under a text field, say), set the `anchorElement` property instead — same positioning, no toggle.
  * @attr {string} placement - Floating UI placement. Default: 'bottom-start'.
+ * @attr {number} max-items - Maximum number of visible items before scrolling. Sets --_max-items internally. Default: 0 (no limit).
  * @attr {string} empty-text - Text of the default empty-state dialog. Falls back to Dutch i18n "Geen opties beschikbaar".
  * @attr {string} empty-supporting-text - Supporting text of the default empty-state dialog.
- * @attr {string} width - Explicit width, pinned exactly. Without it the menu sizes to its content between a minimum and a viewport-aware maximum (min(100vw - inset, 640px)).
- * @attr {number} max-items - Maximum number of visible items before scrolling. Sets --_max-items internally. Default: 0 (no limit).
  * @attr {object} translations - Override one or more translation keys.
  * @attr {Function} filterFn - Custom filter function (query, item) => boolean.
  *
@@ -145,40 +150,45 @@ export declare class NLDDMenuItem extends LitElement {
  */
 export declare class NLDDMenu extends LitElement {
     static styles: import("lit").CSSResult;
-    anchor: string;
-    /**
-     * The anchor as an element reference. Positions the menu exactly like the
-     * `anchor` attribute, but does NOT turn the anchor into a toggle — clicking
-     * it does not open the menu. Use this whenever you drive open/close yourself
-     * (`showPopover()` / `hidePopover()`), which is what nldd-combo-box and
-     * nldd-token-field do: their input must stay an input, not a menu button.
-     */
-    anchorElement: Element | null;
-    placement: string;
     /**
      * Render variant. Use 'listbox' when the menu serves as a combobox popup —
      * this switches role to "listbox" and item roles to "option" per ARIA spec.
      * Default: 'menu'.
      */
     variant: 'menu' | 'listbox';
-    emptyText: string;
-    emptySupportingText: string;
     /**
      * Explicit width, pinned exactly (sets --_width and clamps min/max to it).
      * Leave unset to let the menu size to its content between a minimum and a
      * viewport-aware maximum of min(100vw - inset, 640px).
      */
     width: string;
+    anchor: string;
+    /**
+     * The anchor as an element reference. Positions the menu exactly like the
+     * `anchor` attribute, but does NOT turn the anchor into a toggle — clicking
+     * it does not open the menu. Use this whenever you drive open/close yourself
+     * (`showPopover()` / `hidePopover()`), which is what nldd-combo-box and
+     * nldd-token-field do: their input must stay an input, not a menu button.
+     */
+    anchorElement: Element | null;
+    placement: string;
     /**
      * Maximum number of visible items before the menu scrolls.
      * Sets --_max-items internally. Default: 0 (no limit).
      */
     maxItems: number;
+    emptyText: string;
+    emptySupportingText: string;
     /**
      * Override one or more translation keys.
      * Unset keys fall back to the Dutch default.
      */
     translations: Partial<NLDDMenuTranslations>;
+    /**
+     * Custom filter function. Defaults to case-insensitive substring match
+     * on text, value, and aliases attributes.
+     */
+    filterFn: (query: string, item: NLDDMenuItem) => boolean;
     /**
      * @internal — development only.
      *
@@ -189,11 +199,6 @@ export declare class NLDDMenu extends LitElement {
      * as a development aid.
      */
     debugSafeTriangle: boolean;
-    /**
-     * Custom filter function. Defaults to case-insensitive substring match
-     * on text, value, and aliases attributes.
-     */
-    filterFn: (query: string, item: NLDDMenuItem) => boolean;
     private _isEmpty;
     /** Whether the `header` / `footer` slots have meaningful content, driving
      * whether their (root-only) region renders. Set from slotchange + an initial
@@ -584,8 +589,14 @@ export declare class NLDDMenu extends LitElement {
      * remainder (predictive completion — the ARIA APG pattern for combobox).
      *
      * When the query is empty, all items are shown and `query` is cleared.
+     *
+     * With `hide: false` nothing is hidden and every item gets the `query`, for
+     * a list someone else already filtered, such as a server answering per
+     * keystroke. Text without the query in it is shown as it is.
      */
-    filter(query: string): void;
+    filter(query: string, { hide }?: {
+        hide?: boolean;
+    }): void;
     /**
      * Hide each nldd-menu-group whose items are all filtered out — a labeled
      * heading above an empty section reads as broken. Runs after filter() has
@@ -642,6 +653,10 @@ export declare class NLDDMenu extends LitElement {
      * Items nested in an `nldd-menu-group` are reached by the query but not by
      * that slotchange, since they are assigned to the group's slot. They are
      * claimed on the next open.
+     *
+     * The same pass gives the menu's own items one check-mark column when any of
+     * them is a checkbox or radio, so the text of every group starts at the same
+     * place. A submenu's items are its own and are left to it.
      */
     _claimItems: () => void;
     private _handleBeforeToggle;

package/dist/components/actions/menu/menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../../src/components/actions/menu/menu.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../../src/components/actions/menu/menu.ts"],"names":[],"mappings":"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"}

package/dist/components/actions/menu/menu.js

@@ -19,6 +19,7 @@ import '../../content/keyboard-shortcut/keyboard-shortcut.js';
 import '../../status-and-feedback/inline-dialog/inline-dialog.js';
 import { isKeyboardMode, isTouchMode } from '../../../utilities/input-modality.js';
 import { breakpoints } from '../../../assets/styles/breakpoints.js';
+import { translate } from '../../../utilities/translations.js';
 // # nldd-menu-divider
 /**
  * A horizontal rule between groups of items in an `nldd-menu`.
@@ -86,18 +87,18 @@ if (!customElements.get('nldd-menu-group')) {
  *
  * @element nldd-menu-item
  *
+ * @attr {boolean} destructive - Marks the item as destructive (red text; red highlight bg). Use for irreversible actions like "Delete". Color is the only built-in signal, so per WCAG 1.4.1 the item's own label must convey the destructive nature (e.g. "Verwijder") — don't rely on the red alone. Confirming the action (e.g. a follow-up dialog) is the consumer's responsibility.
  * @attr {string} text - Display text. Supports **bold** markdown syntax.
- * @attr {string} value - A value of the item's own, read off the item in a `select` handler. The default filter matches on it as well as on `text` and `aliases`. Not a form value: this component is not form-associated.
- * @attr {string} href - Optional link target. A plain button item with an href renders as an `<a>` so it is a real link (middle-click, open in new tab, copy link). Ignored for submenu openers, checkbox/radio items, and while disabled.
- * @attr {string} aliases - Space-separated alternative search terms.
  * @attr {string} details - Secondary label shown on the right side.
+ * @attr {string} icon - Icon name rendered before the text.
  * @attr {string} shortcut - Keyboard shortcut hint shown on the right, e.g. 'Cmd+E'. Display only (rendered via nldd-keyboard-shortcut) — it does not bind the key; wire up the handling in your app. Hidden on touch-only devices, where it isn't invokable.
  * @attr {string} shortcut-mac / shortcut-windows / shortcut-linux - Per-OS overrides for `shortcut`, picked by detected OS (falls back to `shortcut`).
- * @attr {string} icon - Icon name rendered before the text (nldd-icon name).
- * @attr {string} type - Item type: 'button' | 'checkbox' | 'radio'. Default: 'button'.
+ * @attr {string} href - Optional link target. A plain button item with an href renders as an `<a>` so it is a real link (middle-click, open in new tab, copy link). Ignored for submenu openers, checkbox/radio items, and while disabled.
+ * @attr {string} type - Item type: 'button' | 'checkbox' | 'radio'. Default: 'button'. One checkbox or radio item gives every item in its menu the check-mark column, so the text of the whole menu starts at one line, as in a native menu. Submenus decide for themselves.
  * @attr {boolean} selected - Selected state for checkbox and radio types.
- * @attr {boolean} destructive - Marks the item as destructive (red text; red highlight bg). Use for irreversible actions like "Delete". Color is the only built-in signal, so per WCAG 1.4.1 the item's own label must convey the destructive nature (e.g. "Verwijder") — don't rely on the red alone. Confirming the action (e.g. a follow-up dialog) is the consumer's responsibility.
  * @attr {boolean} disabled - Disabled state.
+ * @attr {string} value - A value of the item's own, read off the item in a `select` handler. The default filter matches on it as well as on `text` and `aliases`. Not a form value: this component is not form-associated.
+ * @attr {string} aliases - Space-separated alternative search terms.
  * @attr {string} query - Query substring to bold-highlight in text. Set by menu's filter(); also settable by consumers.
  * @attr {string} query-mark-mode - 'match' | 'predictive' (default: 'predictive'). See text-cell for details.
  *
@@ -106,20 +107,20 @@ if (!customElements.get('nldd-menu-group')) {
 export class NLDDMenuItem extends LitElement {
     constructor() {
         super(...arguments);
+        this.destructive = false;
         this.text = '';
-        this.value = '';
-        this.href = '';
-        this.aliases = '';
         this.details = '';
+        this.icon = '';
         this.shortcut = '';
         this.shortcutMac = '';
         this.shortcutWindows = '';
         this.shortcutLinux = '';
-        this.icon = '';
+        this.href = '';
         this.type = 'button';
         this.selected = false;
-        this.destructive = false;
         this.disabled = false;
+        this.value = '';
+        this.aliases = '';
         this.query = '';
         this.queryMarkMode = 'predictive';
         /**
@@ -133,6 +134,10 @@ export class NLDDMenuItem extends LitElement {
          * declaration stays what it is.
          */
         this.menuVariant = null;
+        /** Whether this item keeps the check-mark column free without being
+         *  checkable, because another item in its menu is. Set by that nldd-menu.
+         *  Not part of the public API. */
+        this.checkColumn = false;
         /** Tracks whether this item's submenu (if any) is currently open. Set by
          * the parent nldd-menu via the `submenu-open`/`submenu-close` lifecycle. */
         this._submenuOpen = false;
@@ -191,6 +196,13 @@ export class NLDDMenuItem extends LitElement {
         // for a second render from inside the first.
         this._cachedSubmenuEl = this.querySelector(':scope > nldd-menu');
     }
+    updated(changedProperties) {
+        // An item that becomes checkable, or stops being so, changes whether its
+        // menu reserves the check-mark column, also while the menu is open.
+        if (changedProperties.has('type') && changedProperties.get('type') !== undefined && this.menuVariant) {
+            this.closest('nldd-menu')?._claimItems();
+        }
+    }
     firstUpdated() {
         // Submenu attachment is one-shot in v1 — a nldd-menu added after this
         // point would silently miss aria-controls, the chevron indicator, the
@@ -265,20 +277,17 @@ export class NLDDMenuItem extends LitElement {
 NLDDMenuItem.styles = menuItemStyles;
 NLDDMenuItem._idCounter = 0;
 __decorate([
-    property({ reflect: true, converter: reflectNonDefault('') })
-], NLDDMenuItem.prototype, "text", void 0);
-__decorate([
-    property({ type: String, reflect: true })
-], NLDDMenuItem.prototype, "value", void 0);
-__decorate([
-    property({ type: String, reflect: true })
-], NLDDMenuItem.prototype, "href", void 0);
+    property({ type: Boolean, reflect: true })
+], NLDDMenuItem.prototype, "destructive", void 0);
 __decorate([
     property({ reflect: true, converter: reflectNonDefault('') })
-], NLDDMenuItem.prototype, "aliases", void 0);
+], NLDDMenuItem.prototype, "text", void 0);
 __decorate([
     property({ reflect: true, converter: reflectNonDefault('') })
 ], NLDDMenuItem.prototype, "details", void 0);
+__decorate([
+    property({ type: String, reflect: true })
+], NLDDMenuItem.prototype, "icon", void 0);
 __decorate([
     property({ reflect: true, converter: reflectNonDefault('') })
 ], NLDDMenuItem.prototype, "shortcut", void 0);
@@ -293,19 +302,22 @@ __decorate([
 ], NLDDMenuItem.prototype, "shortcutLinux", void 0);
 __decorate([
     property({ type: String, reflect: true })
-], NLDDMenuItem.prototype, "icon", void 0);
+], NLDDMenuItem.prototype, "href", void 0);
 __decorate([
     property({ type: String, reflect: true })
 ], NLDDMenuItem.prototype, "type", void 0);
 __decorate([
     property({ type: Boolean, reflect: true })
 ], NLDDMenuItem.prototype, "selected", void 0);
-__decorate([
-    property({ type: Boolean, reflect: true })
-], NLDDMenuItem.prototype, "destructive", void 0);
 __decorate([
     property({ type: Boolean, reflect: true })
 ], NLDDMenuItem.prototype, "disabled", void 0);
+__decorate([
+    property({ type: String, reflect: true })
+], NLDDMenuItem.prototype, "value", void 0);
+__decorate([
+    property({ reflect: true, converter: reflectNonDefault('') })
+], NLDDMenuItem.prototype, "aliases", void 0);
 __decorate([
     property({ reflect: true, converter: reflectNonDefault('') })
 ], NLDDMenuItem.prototype, "query", void 0);
@@ -315,6 +327,9 @@ __decorate([
 __decorate([
     state()
 ], NLDDMenuItem.prototype, "menuVariant", void 0);
+__decorate([
+    state()
+], NLDDMenuItem.prototype, "checkColumn", void 0);
 __decorate([
     state()
 ], NLDDMenuItem.prototype, "_submenuOpen", void 0);
@@ -341,12 +356,12 @@ const defaultFilterFn = (query, item) => {
  *
  * @element nldd-menu
  *
+ * @attr {string} width - Explicit width, pinned exactly. Without it the menu sizes to its content between a minimum and a viewport-aware maximum (min(100vw - inset, 640px)).
  * @attr {string} anchor - ID of the anchor element. Positions the menu against it AND makes it a toggle: the menu listens on document click and opens/closes itself when the click lands on the anchor. Use this for a menu hung off a button. For a menu you open yourself (a type-ahead under a text field, say), set the `anchorElement` property instead — same positioning, no toggle.
  * @attr {string} placement - Floating UI placement. Default: 'bottom-start'.
+ * @attr {number} max-items - Maximum number of visible items before scrolling. Sets --_max-items internally. Default: 0 (no limit).
  * @attr {string} empty-text - Text of the default empty-state dialog. Falls back to Dutch i18n "Geen opties beschikbaar".
  * @attr {string} empty-supporting-text - Supporting text of the default empty-state dialog.
- * @attr {string} width - Explicit width, pinned exactly. Without it the menu sizes to its content between a minimum and a viewport-aware maximum (min(100vw - inset, 640px)).
- * @attr {number} max-items - Maximum number of visible items before scrolling. Sets --_max-items internally. Default: 0 (no limit).
  * @attr {object} translations - Override one or more translation keys.
  * @attr {Function} filterFn - Custom filter function (query, item) => boolean.
  *
@@ -358,40 +373,45 @@ const defaultFilterFn = (query, item) => {
 export class NLDDMenu extends LitElement {
     constructor() {
         super(...arguments);
-        this.anchor = '';
-        /**
-         * The anchor as an element reference. Positions the menu exactly like the
-         * `anchor` attribute, but does NOT turn the anchor into a toggle — clicking
-         * it does not open the menu. Use this whenever you drive open/close yourself
-         * (`showPopover()` / `hidePopover()`), which is what nldd-combo-box and
-         * nldd-token-field do: their input must stay an input, not a menu button.
-         */
-        this.anchorElement = null;
-        this.placement = 'bottom-start';
         /**
          * Render variant. Use 'listbox' when the menu serves as a combobox popup —
          * this switches role to "listbox" and item roles to "option" per ARIA spec.
          * Default: 'menu'.
          */
         this.variant = 'menu';
-        this.emptyText = '';
-        this.emptySupportingText = '';
         /**
          * Explicit width, pinned exactly (sets --_width and clamps min/max to it).
          * Leave unset to let the menu size to its content between a minimum and a
          * viewport-aware maximum of min(100vw - inset, 640px).
          */
         this.width = '';
+        this.anchor = '';
+        /**
+         * The anchor as an element reference. Positions the menu exactly like the
+         * `anchor` attribute, but does NOT turn the anchor into a toggle — clicking
+         * it does not open the menu. Use this whenever you drive open/close yourself
+         * (`showPopover()` / `hidePopover()`), which is what nldd-combo-box and
+         * nldd-token-field do: their input must stay an input, not a menu button.
+         */
+        this.anchorElement = null;
+        this.placement = 'bottom-start';
         /**
          * Maximum number of visible items before the menu scrolls.
          * Sets --_max-items internally. Default: 0 (no limit).
          */
         this.maxItems = 0;
+        this.emptyText = '';
+        this.emptySupportingText = '';
         /**
          * Override one or more translation keys.
          * Unset keys fall back to the Dutch default.
          */
         this.translations = {};
+        /**
+         * Custom filter function. Defaults to case-insensitive substring match
+         * on text, value, and aliases attributes.
+         */
+        this.filterFn = defaultFilterFn;
         /**
          * @internal — development only.
          *
@@ -402,11 +422,6 @@ export class NLDDMenu extends LitElement {
          * as a development aid.
          */
         this.debugSafeTriangle = false;
-        /**
-         * Custom filter function. Defaults to case-insensitive substring match
-         * on text, value, and aliases attributes.
-         */
-        this.filterFn = defaultFilterFn;
         this._isEmpty = false;
         /** Whether the `header` / `footer` slots have meaningful content, driving
          * whether their (root-only) region renders. Set from slotchange + an initial
@@ -1137,11 +1152,21 @@ export class NLDDMenu extends LitElement {
          * Items nested in an `nldd-menu-group` are reached by the query but not by
          * that slotchange, since they are assigned to the group's slot. They are
          * claimed on the next open.
+         *
+         * The same pass gives the menu's own items one check-mark column when any of
+         * them is a checkbox or radio, so the text of every group starts at the same
+         * place. A submenu's items are its own and are left to it.
          */
         this._claimItems = () => {
-            Array.from(this.querySelectorAll('nldd-menu-item')).forEach(item => {
+            const items = Array.from(this.querySelectorAll('nldd-menu-item'));
+            items.forEach(item => {
                 item.menuVariant = this.variant;
             });
+            const own = items.filter(item => item.closest('nldd-menu') === this);
+            const checkColumn = this.variant === 'menu' && own.some(item => item.type !== 'button');
+            own.forEach(item => {
+                item.checkColumn = checkColumn;
+            });
         };
         this._handleBeforeToggle = (event) => {
             if (event.newState === 'open')
@@ -1203,13 +1228,7 @@ export class NLDDMenu extends LitElement {
     }
     // — i18n ——————————————————————————————————————————————————————————————————
     _t(key, vars) {
-        let str = this.translations[key] ?? nlddMenuTranslations[key];
-        if (vars) {
-            for (const [k, v] of Object.entries(vars)) {
-                str = str.replace(`{${k}}`, String(v));
-            }
-        }
-        return str;
+        return translate(this.translations, nlddMenuTranslations, key, vars);
     }
     /** Resolved empty text: emptyText attribute takes precedence, then i18n fallback. */
     get _resolvedEmptyText() {
@@ -1910,11 +1929,15 @@ export class NLDDMenu extends LitElement {
      * remainder (predictive completion — the ARIA APG pattern for combobox).
      *
      * When the query is empty, all items are shown and `query` is cleared.
+     *
+     * With `hide: false` nothing is hidden and every item gets the `query`, for
+     * a list someone else already filtered, such as a server answering per
+     * keystroke. Text without the query in it is shown as it is.
      */
-    filter(query) {
+    filter(query, { hide = true } = {}) {
         const allItems = Array.from(this.querySelectorAll('nldd-menu-item'));
         allItems.forEach(item => {
-            const matches = !query || this.filterFn(query, item);
+            const matches = !hide || !query || this.filterFn(query, item);
             item.toggleAttribute('hidden', !matches);
             item.query = (matches && query) ? query : '';
         });
@@ -2132,6 +2155,12 @@ NLDDMenu._menuIdCounter = 0;
  * comfortably, short enough that an unrelated later keystroke starts a
  * fresh search. */
 NLDDMenu._TYPEAHEAD_RESET_MS = 500;
+__decorate([
+    property({ reflect: true, converter: reflectNonDefault('menu') })
+], NLDDMenu.prototype, "variant", void 0);
+__decorate([
+    property({ type: String, reflect: true })
+], NLDDMenu.prototype, "width", void 0);
 __decorate([
     property({ type: String, reflect: true })
 ], NLDDMenu.prototype, "anchor", void 0);
@@ -2142,29 +2171,23 @@ __decorate([
     property({ reflect: true, converter: reflectNonDefault('bottom-start') })
 ], NLDDMenu.prototype, "placement", void 0);
 __decorate([
-    property({ reflect: true, converter: reflectNonDefault('menu') })
-], NLDDMenu.prototype, "variant", void 0);
+    property({ type: Number, attribute: 'max-items' })
+], NLDDMenu.prototype, "maxItems", void 0);
 __decorate([
     property({ reflect: true, attribute: 'empty-text', converter: reflectNonDefault('') })
 ], NLDDMenu.prototype, "emptyText", void 0);
 __decorate([
     property({ reflect: true, attribute: 'empty-supporting-text', converter: reflectNonDefault('') })
 ], NLDDMenu.prototype, "emptySupportingText", void 0);
-__decorate([
-    property({ type: String, reflect: true })
-], NLDDMenu.prototype, "width", void 0);
-__decorate([
-    property({ type: Number, attribute: 'max-items' })
-], NLDDMenu.prototype, "maxItems", void 0);
 __decorate([
     property({ type: Object })
 ], NLDDMenu.prototype, "translations", void 0);
-__decorate([
-    property({ type: Boolean, reflect: true, attribute: 'debug-safe-triangle' })
-], NLDDMenu.prototype, "debugSafeTriangle", void 0);
 __decorate([
     property({ attribute: false })
 ], NLDDMenu.prototype, "filterFn", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true, attribute: 'debug-safe-triangle' })
+], NLDDMenu.prototype, "debugSafeTriangle", void 0);
 __decorate([
     state()
 ], NLDDMenu.prototype, "_isEmpty", void 0);