@aquera/nile-elements 1.7.0 → 1.7.2

package/src/nile-combobox/selection-manager.ts

@@ -0,0 +1,57 @@
+/**
+ * Copyright Aquera Inc 2025
+ *
+ * This source code is licensed under the BSD-3-Clause license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import type { ComboboxOption } from './types.js';
+
+export class ComboboxSelectionManager {
+  static createOptionsFromValues(
+    value: string | string[],
+    data: any[],
+    getDisplayText: (item: any) => string,
+    getItemValue?: (item: any) => string
+  ): ComboboxOption[] {
+    if (!value || (Array.isArray(value) && value.length === 0)) {
+      return [];
+    }
+
+    const values = Array.isArray(value) ? value : [value];
+    const valueFn = getItemValue || ((item: any) => item?.value ?? item);
+
+    return values.map(valueItem => {
+      const item = data.find((d: any) => {
+        const iv = valueFn(d);
+        return String(iv) === String(valueItem);
+      });
+
+      const displayText = item ? getDisplayText(item) : valueItem;
+
+      return {
+        value: valueItem,
+        selected: true,
+        getTextLabel: () => {
+          if (typeof displayText === 'string' && /<[^>]+>/.test(displayText)) {
+            const div = document.createElement('div');
+            div.innerHTML = displayText;
+            return div.textContent || div.innerText || '';
+          }
+          return displayText;
+        },
+      };
+    });
+  }
+
+  static toggleMultiValue(currentValues: string[], optionValue: string): string[] {
+    if (currentValues.includes(optionValue)) {
+      return currentValues.filter(v => v !== optionValue);
+    }
+    return [...currentValues, optionValue];
+  }
+
+  static removeValue(currentValues: string[], removeValue: string): string[] {
+    return currentValues.filter(v => v !== removeValue);
+  }
+}

package/src/nile-combobox/types.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright Aquera Inc 2025
+ *
+ * This source code is licensed under the BSD-3-Clause license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+export type NileRemoveEvent = CustomEvent<Record<PropertyKey, never>>;
+
+export interface ComboboxOption {
+  value: string;
+  selected: boolean;
+  getTextLabel: () => string;
+}
+
+export interface ComboboxRenderItemConfig {
+  getDisplayText: (item: any) => string;
+  getValue?: (item: any) => string;
+  getSearchText?: (item: any) => string;
+  getDescription?: (item: any) => string;
+  getPrefix?: (item: any) => string;
+  getSuffix?: (item: any) => string;
+}
+
+export type ComboboxTagLayout = 'single-line' | 'wrap' | 'fixed-height';
+export type ComboboxSize = 'small' | 'medium' | 'large';
+export type ComboboxPlacement = 'top' | 'bottom';

package/src/nile-nav-tab/nile-nav-tab.ts

@@ -165,7 +165,7 @@ export class NileNavTab extends NileElement {
           @click=${this.handleTabClick}
         >
           <slot name="prefix" @slotchange=${this.updateAccessibleName}></slot>
-          <slot @slotchange=${this.updateAccessibleName}></slot>
+          <span part="name"><slot @slotchange=${this.updateAccessibleName}></slot></span>
           <slot name="suffix" @slotchange=${this.updateAccessibleName}></slot>
 
           ${this.closable

package/vscode-html-custom-data.json

@@ -1330,6 +1330,308 @@
         }
       ]
     },
+    {
+      "name": "nile-combobox",
+      "description": "Events:\n\n  * `nile-change` {} - Emitted when the control's value changes.\n\n  * `nile-clear` {} - Emitted when the control's value is cleared.\n\n  * `nile-input` {} - Emitted when the control receives input.\n\n  * `nile-focus` {} - Emitted when the control gains focus.\n\n  * `nile-blur` {} - Emitted when the control loses focus.\n\n  * `nile-show` {} - Emitted when the dropdown opens.\n\n  * `nile-after-show` {} - Emitted after the dropdown opens and all animations complete.\n\n  * `nile-hide` {} - Emitted when the dropdown closes.\n\n  * `nile-after-hide` {} - Emitted after the dropdown closes and all animations complete.\n\n  * `nile-search` {} - Emitted (debounced) when the user types. Useful for API-driven filtering.\n\n  * `nile-tag-remove` {} - Emitted when a tag is removed in multi-select mode.\n\n  * `nile-tag-add` {} - Emitted when a custom value is added via allowCustomValue.\n\n  * `nile-scroll-end` {} - Emitted when scrolled to the bottom (for infinite loading).\n\n  * `nile-invalid` {} - Emitted when form validation constraints aren't satisfied.\n\n  * `nile-select-all` {} - Emitted when the Select all / Deselect all control toggles. Detail: { value, name, action: 'select-all' | 'deselect-all' }.\n\nSlots:\n\n  * `label` {} - The input's label.\n\n  * `prefix` {} - Prepend a presentational icon or element before the input.\n\n  * `clear-icon` {} - An icon to use in lieu of the default clear icon.\n\n  * `expand-icon` {} - The icon to show when the control is expanded/collapsed.\n\n  * `help-text` {} - Text that describes how to use the input.\n\n  * `footer` {} - Custom footer content (overrides default footer in multi-select mode).\n\n  * `no-results` {} - Custom no-results content.\n\nAttributes:\n\n  * `data` {`any[]`} - \n\n  * `size` {`\"small\" | \"medium\" | \"large\"`} - \n\n  * `placeholder` {`string`} - \n\n  * `multiple` {`boolean`} - \n\n  * `label` {`string`} - \n\n  * `open` {`boolean`} - \n\n  * `clearable` {`boolean`} - \n\n  * `loading` {`boolean`} - \n\n  * `optionsLoading` {`boolean`} - \n\n  * `disableLocalSearch` {`boolean`} - When true, skip local filtering and rely solely on the `nile-search` event for API-driven results.\n\n  * `allowCustomValue` {`boolean`} - When true, displays a \"+ Add [value]\" option for values not in the data.\n\n  * `acceptUserInput` {`boolean`} - When true, typing free text and pressing Enter/Tab adds it as a tag (like nile-chip's acceptUserInput).\n\n  * `addToSuggestions` {`boolean`} - When true, custom values added via allowCustomValue or acceptUserInput are also appended to the suggestions list.\n\n  * `strict` {`boolean`} - When true, value must match an option. On blur, reverts to the last valid value if text doesn't match.\n\n  * `max-tags-visible` {`number`} - Max tags visible before showing \"+N more\" (0 = no limit).\n\n  * `tagLayout` {`ComboboxTagLayout`} - Controls how tags wrap in multi-select mode.\n\n  * `showFooter` {`boolean`} - Show footer with \"Show Selected\" and \"Clear All\" in multi-select mode.\nAutomatically suppressed when `selectAllEnabled` is true, since the top\nactions row already provides the same controls.\n\n  * `select-all-enabled` {`boolean`} - When true (and `multiple` is true), renders a \"Select all\" / \"Deselect all\"\ncheckbox at the top of the listbox. Operates on the currently visible,\nnon-disabled options (respects the active search filter).\n\n  * `portal` {`boolean`} - \n\n  * `hoist` {`boolean`} - \n\n  * `placement` {`ComboboxPlacement`} - \n\n  * `help-text` {`string`} - \n\n  * `error-message` {`string`} - \n\n  * `warning` {`boolean`} - \n\n  * `error` {`boolean`} - \n\n  * `success` {`boolean`} - \n\n  * `filled` {`boolean`} - \n\n  * `pill` {`boolean`} - \n\n  * `noResultsMessage` {`string`} - \n\n  * `no-results-subtitle` {`string`} - \n\n  * `no-data-message` {`string`} - \n\n  * `autoCompleteOptions` {`any[]`} - Pre-defined autocomplete suggestions. Accepts a JSON array string attribute\nor a JS array property (like nile-chip). When `addToSuggestions` is true,\ncustom values added by the user are appended to this list and persisted.\n\n  * `debounceMs` {`number`} - Debounce interval (ms) for the nile-search event.\n\n  * `allowHtmlLabel` {`boolean`} - \n\n  * `enableVisibilityEffect` {`boolean`} - \n\n  * `enableTabClose` {`boolean`} - \n\n  * `noWidthSync` {`boolean`} - \n\n  * `grid-columns` {`number`} - Number of columns in the dropdown grid (vertical scroll). When > 1, options render in a multi-column grid layout.\n\n  * `grid-rows` {`number`} - Number of visible rows in horizontal grid mode. When > 0, enables horizontal virtual scroll with columns scrolling left/right.\n\n  * `grid-column-width` {`number`} - Width of each column in horizontal grid mode (px).\n\n  * `name` {`string`} - \n\n  * `value` {`string | string[]`} - \n\n  * `disabled` {`boolean`} - \n\n  * `form` {`string`} - \n\n  * `required` {`boolean`} - \n\nProperties:\n\n  * `styles` - \n\n  * `formControlController` - \n\n  * `hasSlotController` - \n\n  * `portalManager` - \n\n  * `searchManager` - \n\n  * `scrollElementRef` - \n\n  * `virtualizerCtrl` - \n\n  * `hScrollElementRef` - \n\n  * `hVirtualizerCtrl` - \n\n  * `scrollTimeout` {`number | undefined`} - \n\n  * `scrolling` {`boolean`} - \n\n  * `visibilityManager` - \n\n  * `keyboardActiveIndex` {`number`} - \n\n  * `popup` - \n\n  * `combobox` {`HTMLElement`} - \n\n  * `inputElement` {`HTMLInputElement`} - \n\n  * `valueInput` {`HTMLInputElement`} - \n\n  * `hasFocus` {`boolean`} - \n\n  * `displayLabel` {`string`} - \n\n  * `selectedOptions` {`ComboboxOption[]`} - \n\n  * `filteredData` {`any[]`} - The items displayed after filtering. Renderer reads from this.\n\n  * `originalData` {`any[]`} - The complete unfiltered dataset (preserved for re-filtering).\n\n  * `showNoResults` {`boolean`} - \n\n  * `showListbox` {`boolean`} - \n\n  * `searchValue` {`string`} - \n\n  * `showSelectedOnly` {`boolean`} - \n\n  * `selectAllChecked` {`boolean`} - \n\n  * `selectAllIndeterminate` {`boolean`} - \n\n  * `data` {`any[]`} - \n\n  * `size` {`\"small\" | \"medium\" | \"large\"`} - \n\n  * `placeholder` {`string`} - \n\n  * `multiple` {`boolean`} - \n\n  * `label` {`string`} - \n\n  * `open` {`boolean`} - \n\n  * `clearable` {`boolean`} - \n\n  * `loading` {`boolean`} - \n\n  * `optionsLoading` {`boolean`} - \n\n  * `disableLocalSearch` {`boolean`} - When true, skip local filtering and rely solely on the `nile-search` event for API-driven results.\n\n  * `allowCustomValue` {`boolean`} - When true, displays a \"+ Add [value]\" option for values not in the data.\n\n  * `acceptUserInput` {`boolean`} - When true, typing free text and pressing Enter/Tab adds it as a tag (like nile-chip's acceptUserInput).\n\n  * `addToSuggestions` {`boolean`} - When true, custom values added via allowCustomValue or acceptUserInput are also appended to the suggestions list.\n\n  * `strict` {`boolean`} - When true, value must match an option. On blur, reverts to the last valid value if text doesn't match.\n\n  * `maxTagsVisible` {`number`} - Max tags visible before showing \"+N more\" (0 = no limit).\n\n  * `tagLayout` {`ComboboxTagLayout`} - Controls how tags wrap in multi-select mode.\n\n  * `showFooter` {`boolean`} - Show footer with \"Show Selected\" and \"Clear All\" in multi-select mode.\nAutomatically suppressed when `selectAllEnabled` is true, since the top\nactions row already provides the same controls.\n\n  * `selectAllEnabled` {`boolean`} - When true (and `multiple` is true), renders a \"Select all\" / \"Deselect all\"\ncheckbox at the top of the listbox. Operates on the currently visible,\nnon-disabled options (respects the active search filter).\n\n  * `portal` {`boolean`} - \n\n  * `hoist` {`boolean`} - \n\n  * `placement` {`ComboboxPlacement`} - \n\n  * `helpText` {`string`} - \n\n  * `errorMessage` {`string`} - \n\n  * `warning` {`boolean`} - \n\n  * `error` {`boolean`} - \n\n  * `success` {`boolean`} - \n\n  * `filled` {`boolean`} - \n\n  * `pill` {`boolean`} - \n\n  * `noResultsMessage` {`string`} - \n\n  * `noResultsSubtitle` {`string`} - \n\n  * `noDataMessage` {`string`} - \n\n  * `autoCompleteOptions` {`any[]`} - Pre-defined autocomplete suggestions. Accepts a JSON array string attribute\nor a JS array property (like nile-chip). When `addToSuggestions` is true,\ncustom values added by the user are appended to this list and persisted.\n\n  * `debounceMs` {`number`} - Debounce interval (ms) for the nile-search event.\n\n  * `renderItemConfig` {`ComboboxRenderItemConfig | undefined`} - \n\n  * `allowHtmlLabel` {`boolean`} - \n\n  * `enableVisibilityEffect` {`boolean`} - \n\n  * `enableTabClose` {`boolean`} - \n\n  * `noWidthSync` {`boolean`} - \n\n  * `gridColumns` {`number`} - Number of columns in the dropdown grid (vertical scroll). When > 1, options render in a multi-column grid layout.\n\n  * `gridRows` {`number`} - Number of visible rows in horizontal grid mode. When > 0, enables horizontal virtual scroll with columns scrolling left/right.\n\n  * `gridColumnWidth` {`number`} - Width of each column in horizontal grid mode (px).\n\n  * `isHorizontalGrid` {`boolean`} - \n\n  * `hasActiveFilter` {`boolean`} - \n\n  * `isBidirectionalGrid` {`boolean`} - \n\n  * `virtualRowCount` {`number`} - \n\n  * `virtualColumnCount` {`number`} - \n\n  * `handleDocumentFocusIn` - \n\n  * `handleDocumentKeyDown` - \n\n  * `handleDocumentMouseDown` - \n\n  * `handleWindowError` - \n\n  * `handleWindowResize` - \n\n  * `handleWindowScroll` - \n\n  * `name` {`string`} - \n\n  * `value` {`string | string[]`} - \n\n  * `disabled` {`boolean`} - \n\n  * `defaultValue` {`string | string[]`} - \n\n  * `defaultChecked` {`boolean | undefined`} - \n\n  * `form` {`string`} - \n\n  * `pattern` {`string | undefined`} - \n\n  * `min` {`string | number | Date | undefined`} - \n\n  * `max` {`string | number | Date | undefined`} - \n\n  * `step` {`number | \"any\" | undefined`} - \n\n  * `required` {`boolean`} - \n\n  * `minlength` {`number | undefined`} - \n\n  * `maxlength` {`number | undefined`} - \n\n  * `validity` {`ValidityState`} - \n\n  * `validationMessage` {`string`} - \n\n  * `checkValidity` - \n\n  * `getForm` - \n\n  * `reportValidity` - \n\n  * `setCustomValidity` - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "attributes": [
+        {
+          "name": "data",
+          "description": "`data` {`any[]`} - \n\nProperty: data\n\nDefault: "
+        },
+        {
+          "name": "size",
+          "description": "`size` {`\"small\" | \"medium\" | \"large\"`} - \n\nProperty: size\n\nDefault: medium",
+          "values": [
+            {
+              "name": "small"
+            },
+            {
+              "name": "medium"
+            },
+            {
+              "name": "large"
+            }
+          ]
+        },
+        {
+          "name": "placeholder",
+          "description": "`placeholder` {`string`} - \n\nProperty: placeholder\n\nDefault: Type to search..."
+        },
+        {
+          "name": "multiple",
+          "description": "`multiple` {`boolean`} - \n\nProperty: multiple\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "label",
+          "description": "`label` {`string`} - \n\nProperty: label\n\nDefault: "
+        },
+        {
+          "name": "open",
+          "description": "`open` {`boolean`} - \n\nProperty: open\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "clearable",
+          "description": "`clearable` {`boolean`} - \n\nProperty: clearable\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "loading",
+          "description": "`loading` {`boolean`} - \n\nProperty: loading\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "optionsLoading",
+          "description": "`optionsLoading` {`boolean`} - \n\nProperty: optionsLoading\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "disableLocalSearch",
+          "description": "`disableLocalSearch` {`boolean`} - When true, skip local filtering and rely solely on the `nile-search` event for API-driven results.\n\nProperty: disableLocalSearch\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "allowCustomValue",
+          "description": "`allowCustomValue` {`boolean`} - When true, displays a \"+ Add [value]\" option for values not in the data.\n\nProperty: allowCustomValue\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "acceptUserInput",
+          "description": "`acceptUserInput` {`boolean`} - When true, typing free text and pressing Enter/Tab adds it as a tag (like nile-chip's acceptUserInput).\n\nProperty: acceptUserInput\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "addToSuggestions",
+          "description": "`addToSuggestions` {`boolean`} - When true, custom values added via allowCustomValue or acceptUserInput are also appended to the suggestions list.\n\nProperty: addToSuggestions\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "strict",
+          "description": "`strict` {`boolean`} - When true, value must match an option. On blur, reverts to the last valid value if text doesn't match.\n\nProperty: strict\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "max-tags-visible",
+          "description": "`max-tags-visible` {`number`} - Max tags visible before showing \"+N more\" (0 = no limit).\n\nProperty: maxTagsVisible\n\nDefault: 3"
+        },
+        {
+          "name": "tagLayout",
+          "description": "`tagLayout` {`ComboboxTagLayout`} - Controls how tags wrap in multi-select mode.\n\nProperty: tagLayout\n\nDefault: single-line",
+          "values": [
+            {
+              "name": "single-line"
+            },
+            {
+              "name": "wrap"
+            },
+            {
+              "name": "fixed-height"
+            }
+          ]
+        },
+        {
+          "name": "showFooter",
+          "description": "`showFooter` {`boolean`} - Show footer with \"Show Selected\" and \"Clear All\" in multi-select mode.\nAutomatically suppressed when `selectAllEnabled` is true, since the top\nactions row already provides the same controls.\n\nProperty: showFooter\n\nDefault: true",
+          "valueSet": "v"
+        },
+        {
+          "name": "select-all-enabled",
+          "description": "`select-all-enabled` {`boolean`} - When true (and `multiple` is true), renders a \"Select all\" / \"Deselect all\"\ncheckbox at the top of the listbox. Operates on the currently visible,\nnon-disabled options (respects the active search filter).\n\nProperty: selectAllEnabled\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "portal",
+          "description": "`portal` {`boolean`} - \n\nProperty: portal\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "hoist",
+          "description": "`hoist` {`boolean`} - \n\nProperty: hoist\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "placement",
+          "description": "`placement` {`ComboboxPlacement`} - \n\nProperty: placement\n\nDefault: bottom",
+          "values": [
+            {
+              "name": "top"
+            },
+            {
+              "name": "bottom"
+            }
+          ]
+        },
+        {
+          "name": "help-text",
+          "description": "`help-text` {`string`} - \n\nProperty: helpText\n\nDefault: "
+        },
+        {
+          "name": "error-message",
+          "description": "`error-message` {`string`} - \n\nProperty: errorMessage\n\nDefault: "
+        },
+        {
+          "name": "warning",
+          "description": "`warning` {`boolean`} - \n\nProperty: warning\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "error",
+          "description": "`error` {`boolean`} - \n\nProperty: error\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "success",
+          "description": "`success` {`boolean`} - \n\nProperty: success\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "filled",
+          "description": "`filled` {`boolean`} - \n\nProperty: filled\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "pill",
+          "description": "`pill` {`boolean`} - \n\nProperty: pill\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "noResultsMessage",
+          "description": "`noResultsMessage` {`string`} - \n\nProperty: noResultsMessage\n\nDefault: No result found"
+        },
+        {
+          "name": "no-results-subtitle",
+          "description": "`no-results-subtitle` {`string`} - \n\nProperty: noResultsSubtitle\n\nDefault: Clear search or change filter"
+        },
+        {
+          "name": "no-data-message",
+          "description": "`no-data-message` {`string`} - \n\nProperty: noDataMessage\n\nDefault: No data available"
+        },
+        {
+          "name": "autoCompleteOptions",
+          "description": "`autoCompleteOptions` {`any[]`} - Pre-defined autocomplete suggestions. Accepts a JSON array string attribute\nor a JS array property (like nile-chip). When `addToSuggestions` is true,\ncustom values added by the user are appended to this list and persisted.\n\nProperty: autoCompleteOptions\n\nDefault: "
+        },
+        {
+          "name": "debounceMs",
+          "description": "`debounceMs` {`number`} - Debounce interval (ms) for the nile-search event.\n\nProperty: debounceMs\n\nDefault: 300"
+        },
+        {
+          "name": "allowHtmlLabel",
+          "description": "`allowHtmlLabel` {`boolean`} - \n\nProperty: allowHtmlLabel\n\nDefault: true",
+          "valueSet": "v"
+        },
+        {
+          "name": "enableVisibilityEffect",
+          "description": "`enableVisibilityEffect` {`boolean`} - \n\nProperty: enableVisibilityEffect\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "enableTabClose",
+          "description": "`enableTabClose` {`boolean`} - \n\nProperty: enableTabClose\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "noWidthSync",
+          "description": "`noWidthSync` {`boolean`} - \n\nProperty: noWidthSync\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "grid-columns",
+          "description": "`grid-columns` {`number`} - Number of columns in the dropdown grid (vertical scroll). When > 1, options render in a multi-column grid layout.\n\nProperty: gridColumns\n\nDefault: 1"
+        },
+        {
+          "name": "grid-rows",
+          "description": "`grid-rows` {`number`} - Number of visible rows in horizontal grid mode. When > 0, enables horizontal virtual scroll with columns scrolling left/right.\n\nProperty: gridRows\n\nDefault: 0"
+        },
+        {
+          "name": "grid-column-width",
+          "description": "`grid-column-width` {`number`} - Width of each column in horizontal grid mode (px).\n\nProperty: gridColumnWidth\n\nDefault: 160"
+        },
+        {
+          "name": "name",
+          "description": "`name` {`string`} - \n\nProperty: name\n\nDefault: "
+        },
+        {
+          "name": "value",
+          "description": "`value` {`string | string[]`} - \n\nProperty: value\n\nDefault: ",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "`disabled` {`boolean`} - \n\nProperty: disabled\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "form",
+          "description": "`form` {`string`} - \n\nProperty: form\n\nDefault: "
+        },
+        {
+          "name": "required",
+          "description": "`required` {`boolean`} - \n\nProperty: required\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "onnile-change",
+          "description": "`nile-change` {} - Emitted when the control's value changes."
+        },
+        {
+          "name": "onnile-clear",
+          "description": "`nile-clear` {} - Emitted when the control's value is cleared."
+        },
+        {
+          "name": "onnile-input",
+          "description": "`nile-input` {} - Emitted when the control receives input."
+        },
+        {
+          "name": "onnile-focus",
+          "description": "`nile-focus` {} - Emitted when the control gains focus."
+        },
+        {
+          "name": "onnile-blur",
+          "description": "`nile-blur` {} - Emitted when the control loses focus."
+        },
+        {
+          "name": "onnile-show",
+          "description": "`nile-show` {} - Emitted when the dropdown opens."
+        },
+        {
+          "name": "onnile-after-show",
+          "description": "`nile-after-show` {} - Emitted after the dropdown opens and all animations complete."
+        },
+        {
+          "name": "onnile-hide",
+          "description": "`nile-hide` {} - Emitted when the dropdown closes."
+        },
+        {
+          "name": "onnile-after-hide",
+          "description": "`nile-after-hide` {} - Emitted after the dropdown closes and all animations complete."
+        },
+        {
+          "name": "onnile-search",
+          "description": "`nile-search` {} - Emitted (debounced) when the user types. Useful for API-driven filtering."
+        },
+        {
+          "name": "onnile-tag-remove",
+          "description": "`nile-tag-remove` {} - Emitted when a tag is removed in multi-select mode."
+        },
+        {
+          "name": "onnile-tag-add",
+          "description": "`nile-tag-add` {} - Emitted when a custom value is added via allowCustomValue."
+        },
+        {
+          "name": "onnile-scroll-end",
+          "description": "`nile-scroll-end` {} - Emitted when scrolled to the bottom (for infinite loading)."
+        },
+        {
+          "name": "onnile-invalid",
+          "description": "`nile-invalid` {} - Emitted when form validation constraints aren't satisfied."
+        },
+        {
+          "name": "onnile-select-all",
+          "description": "`nile-select-all` {} - Emitted when the Select all / Deselect all control toggles. Detail: { value, name, action: 'select-all' | 'deselect-all' }."
+        }
+      ]
+    },
     {
       "name": "nile-content-editor",
       "description": "Nile icon component.\n\nAttributes:\n\n  * `value` {`string`} - \n\n  * `options` {`any[]`} - \n\n  * `filteredOptions` {`any[]`} - \n\n  * `showLabel` {`boolean`} - \n\n  * `labelText` {`string`} - \n\n  * `type` {`string`} - \n\n  * `required` {`boolean`} - \n\n  * `help-text` {`string`} - \n\n  * `readonly` {`boolean`} - \n\n  * `error-message` {`string`} - \n\n  * `error` {`boolean`} - \n\n  * `noborder` {`boolean`} - \n\n  * `updateValue` - \n\nProperties:\n\n  * `value` {`string`} - \n\n  * `options` {`any[]`} - \n\n  * `filteredOptions` {`any[]`} - \n\n  * `showLabel` {`boolean`} - \n\n  * `labelText` {`string`} - \n\n  * `type` {`string`} - \n\n  * `required` {`boolean`} - \n\n  * `contentEditor` {`HTMLInputElement`} - \n\n  * `autoOptions` {`HTMLInputElement`} - \n\n  * `openDropdown` {`boolean`} - \n\n  * `tagIdentifier` {`string`} - \n\n  * `filteredValue` {`string`} - \n\n  * `helpText` {`string`} - \n\n  * `readonly` {`boolean`} - \n\n  * `errorMessage` {`string`} - \n\n  * `error` {`boolean`} - \n\n  * `noborder` {`boolean`} - \n\n  * `updateValue` - \n\n  * `initialValue` {`string`} - \n\n  * `styles` - \n\n  * `replaceText` {`string`} - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
@@ -5031,7 +5333,7 @@
     },
     {
       "name": "nile-select",
-      "description": "Events:\n\n  * `nile-change` {} - Emitted when the control's value changes.\n\n  * `nile-clear` {} - Emitted when the control's value is cleared.\n\n  * `nile-input` {} - Emitted when the control receives input.\n\n  * `nile-focus` {} - Emitted when the control gains focus.\n\n  * `nile-blur` {} - Emitted when the control loses focus.\n\n  * `nile-show` {} - Emitted when the select's menu opens.\n\n  * `nile-after-show` {} - Emitted after the select's menu opens and all animations are complete.\n\n  * `nile-hide` {} - Emitted when the select's menu closes.\n\n  * `nile-after-hide` {} - Emitted after the select's menu closes and all animations are complete.\n\n  * `nile-invalid` {} - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n  * `nile-search` {} - Emitted when the user types in the search input. The event payload includes the search query for backend search functionality.\n\n  * `nile-scroll` {} - Emitted when the user scrolls within the listbox. The event payload includes scroll position information.\n\n  * `nile-scroll-start` {} - Emitted when the user starts scrolling within the listbox.\n\n  * `nile-scroll-end` {} - Emitted when the user stops scrolling and reaches the bottom of the listbox (debounced).\n\nSlots:\n\n  * ` ` {} - The listbox options. Must be `<nile-option>` elements. You can use `<nile-divider>` to group items visually.\n\n  * `label` {} - The input's label. Alternatively, you can use the `label` attribute.\n\n  * `prefix` {} - Used to prepend a presentational icon or similar element to the combobox.\n\n  * `clear-icon` {} - An icon to use in lieu of the default clear icon.\n\n  * `expand-icon` {} - The icon to show when the control is expanded and collapsed. Rotates on open and close.\n\n  * `help-text` {} - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n  * `pre-footer` {} - Content to display at the bottom of the dropdown listbox. Useful for action buttons like \"Create New\". In multi-select mode, appears above the \"Show Selected\" / \"Clear All\" bar.\n\nAttributes:\n\n  * `size` {`\"small\" | \"medium\" | \"large\"`} - The select's size.\n\n  * `placeholder` {`string`} - Placeholder text to show as a hint when the select is empty.\n\n  * `searchEnabled` {`boolean`} - \n\n  * `internal-search-placeholder` {`string`} - \n\n  * `enableVisibilityEffect` {`boolean`} - \n\n  * `blockValueChange` {`boolean`} - \n\n  * `disableLocalSearch` {`boolean`} - \n\n  * `optionsLoading` {`boolean`} - \n\n  * `noWidthSync` {`boolean`} - \n\n  * `portal` {`boolean`} - When true, the listbox will be appended to the document body instead of the parent container.\nThis is useful when the parent has overflow: hidden, clip-path, or transform applied.\n\n  * `multiple` {`string | boolean`} - Allows more than one option to be selected.\n\n  * `helpText` {`string`} - \n\n  * `help-text` {`string`} - \n\n  * `autoResize` {`boolean`} - \n\n  * `error-message` {`string`} - \n\n  * `warning` {`boolean`} - Sets the input to a warning state, changing its visual appearance.\n\n  * `error` {`boolean`} - Sets the input to an error state, changing its visual appearance.\n\n  * `success` {`boolean`} - Sets the input to a success state, changing its visual appearance.\n\n  * `max-options-visible` {`number`} - The maximum number of selected options to show when `multiple` is true. After the maximum, \"+n\" will be shown to\nindicate the number of additional items that are selected. Set to 0 to remove the limit.\n\n  * `clearable` {`boolean`} - Adds a clear button when the select is not empty.\n\n  * `open` {`boolean`} - Indicates whether or not the select is open. You can toggle this attribute to show and hide the menu, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the select's open state.\n\n  * `hoist` {`boolean`} - Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.\n\n  * `filled` {`boolean`} - Draws a filled select.\n\n  * `pill` {`boolean`} - Draws a pill-style select with rounded edges.\n\n  * `label` {`string`} - The select's label. If you need to display HTML, use the `label` slot instead.\n\n  * `placement` {`\"top\" | \"bottom\"`} - The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.\n\n  * `showSelected` {`boolean`} - \n\n  * `enableTabClose` {`boolean`} - \n\n  * `showNoResults` {`boolean`} - \n\n  * `noResultsMessage` {`string`} - \n\n  * `data` - \n\n  * `enableVirtualScroll` {`boolean`} - \n\n  * `enableGroupHeader` {`boolean`} - To enable the group header in the select\n\n  * `autoFocusSearch` {`boolean`} - To auto focus the search input when the select is opened\n\n  * `loading` {`boolean`} - loading indicator for virtual select\n\n  * `stickyHeader` {`boolean`} - \n\n  * `descriptionSearchEnabled` {`boolean`} - \n\n  * `enableDescription` {`boolean`} - \n\n  * `allowHtmlLabel` {`boolean`} - \n\n  * `name` {`string`} - The name of the select, submitted as a name/value pair with form data.\n\n  * `value` {`string | string[]`} - The current value of the select, submitted as a name/value pair with form data. When `multiple` is enabled, the\nvalue will be a space-delimited list of values based on the options selected.\n\n  * `disabled` {`boolean`} - Disables the select control.\n\n  * `form` {`string`} - By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.\n\n  * `required` {`boolean`} - The select's required attribute.\n\nProperties:\n\n  * `styles` - \n\n  * `formControlController` - \n\n  * `virtualScrollHelper` - \n\n  * `portalManager` - \n\n  * `hasSlotController` - \n\n  * `typeToSelectString` {`string`} - \n\n  * `typeToSelectTimeout` {`number`} - \n\n  * `scrollTimeout` {`number | undefined`} - \n\n  * `scrolling` {`boolean`} - \n\n  * `options` {`NileOption[]`} - \n\n  * `resizeController` - \n\n  * `visibilityManager` - \n\n  * `popup` - \n\n  * `combobox` {`HTMLSlotElement`} - \n\n  * `displayInput` {`HTMLInputElement`} - \n\n  * `valueInput` {`HTMLInputElement`} - \n\n  * `listbox` {`HTMLSlotElement`} - \n\n  * `hasFocus` {`boolean`} - \n\n  * `displayLabel` {`string`} - \n\n  * `currentOption` - \n\n  * `selectedOptions` {`NileOption[]`} - \n\n  * `oldValue` {`string | string[]`} - \n\n  * `size` {`\"small\" | \"medium\" | \"large\"`} - The select's size.\n\n  * `placeholder` {`string`} - Placeholder text to show as a hint when the select is empty.\n\n  * `searchValue` {`string`} - Placeholder text to show as a hint when the select is empty.\n\n  * `searchEnabled` {`boolean`} - \n\n  * `internalSearchPlaceHolder` {`string`} - \n\n  * `enableVisibilityEffect` {`boolean`} - \n\n  * `blockValueChange` {`boolean`} - \n\n  * `disableLocalSearch` {`boolean`} - \n\n  * `optionsLoading` {`boolean`} - \n\n  * `noWidthSync` {`boolean`} - \n\n  * `portal` {`boolean`} - When true, the listbox will be appended to the document body instead of the parent container.\nThis is useful when the parent has overflow: hidden, clip-path, or transform applied.\n\n  * `multiple` {`string | boolean`} - Allows more than one option to be selected.\n\n  * `helpText` {`string`} - \n\n  * `help_text` {`string`} - \n\n  * `autoResize` {`boolean`} - \n\n  * `errorMessage` {`string`} - \n\n  * `warning` {`boolean`} - Sets the input to a warning state, changing its visual appearance.\n\n  * `error` {`boolean`} - Sets the input to an error state, changing its visual appearance.\n\n  * `success` {`boolean`} - Sets the input to a success state, changing its visual appearance.\n\n  * `maxOptionsVisible` {`number`} - The maximum number of selected options to show when `multiple` is true. After the maximum, \"+n\" will be shown to\nindicate the number of additional items that are selected. Set to 0 to remove the limit.\n\n  * `clearable` {`boolean`} - Adds a clear button when the select is not empty.\n\n  * `open` {`boolean`} - Indicates whether or not the select is open. You can toggle this attribute to show and hide the menu, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the select's open state.\n\n  * `hoist` {`boolean`} - Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.\n\n  * `filled` {`boolean`} - Draws a filled select.\n\n  * `pill` {`boolean`} - Draws a pill-style select with rounded edges.\n\n  * `label` {`string`} - The select's label. If you need to display HTML, use the `label` slot instead.\n\n  * `placement` {`\"top\" | \"bottom\"`} - The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.\n\n  * `showSelected` {`boolean`} - \n\n  * `oldMaxOptionsVisible` {`number`} - \n\n  * `enableTabClose` {`boolean`} - \n\n  * `showNoResults` {`boolean`} - \n\n  * `noResultsMessage` {`string`} - \n\n  * `renderItemConfig` {`RenderItemConfig | undefined`} - Enhanced configuration for rendering items with support for display text, value, and search text\n\n  * `data` - \n\n  * `enableVirtualScroll` {`boolean`} - \n\n  * `enableGroupHeader` {`boolean`} - To enable the group header in the select\n\n  * `autoFocusSearch` {`boolean`} - To auto focus the search input when the select is opened\n\n  * `loading` {`boolean`} - loading indicator for virtual select\n\n  * `stickyHeader` {`boolean`} - \n\n  * `descriptionSearchEnabled` {`boolean`} - \n\n  * `enableDescription` {`boolean`} - \n\n  * `allowHtmlLabel` {`boolean`} - \n\n  * `handleWindowResize` - \n\n  * `handleWindowScroll` - \n\n  * `name` {`string`} - The name of the select, submitted as a name/value pair with form data.\n\n  * `value` {`string | string[]`} - The current value of the select, submitted as a name/value pair with form data. When `multiple` is enabled, the\nvalue will be a space-delimited list of values based on the options selected.\n\n  * `disabled` {`boolean`} - Disables the select control.\n\n  * `defaultValue` {`string | string[]`} - The default value of the form control. Primarily used for resetting the form control.\n\n  * `defaultChecked` {`boolean | undefined`} - \n\n  * `form` {`string`} - By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.\n\n  * `pattern` {`string | undefined`} - \n\n  * `min` {`string | number | Date | undefined`} - \n\n  * `max` {`string | number | Date | undefined`} - \n\n  * `step` {`number | \"any\" | undefined`} - \n\n  * `required` {`boolean`} - The select's required attribute.\n\n  * `minlength` {`number | undefined`} - \n\n  * `maxlength` {`number | undefined`} - \n\n  * `validity` {`ValidityState`} - Gets the validity state object\n\n  * `validationMessage` {`string`} - Gets the validation message\n\n  * `checkValidity` - \n\n  * `getForm` - \n\n  * `reportValidity` - \n\n  * `setCustomValidity` - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Events:\n\n  * `nile-change` {} - Emitted when the control's value changes.\n\n  * `nile-clear` {} - Emitted when the control's value is cleared.\n\n  * `nile-input` {} - Emitted when the control receives input.\n\n  * `nile-focus` {} - Emitted when the control gains focus.\n\n  * `nile-blur` {} - Emitted when the control loses focus.\n\n  * `nile-show` {} - Emitted when the select's menu opens.\n\n  * `nile-after-show` {} - Emitted after the select's menu opens and all animations are complete.\n\n  * `nile-hide` {} - Emitted when the select's menu closes.\n\n  * `nile-after-hide` {} - Emitted after the select's menu closes and all animations are complete.\n\n  * `nile-invalid` {} - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n  * `nile-search` {} - Emitted when the user types in the search input. The event payload includes the search query for backend search functionality.\n\n  * `nile-scroll` {} - Emitted when the user scrolls within the listbox. The event payload includes scroll position information.\n\n  * `nile-scroll-start` {} - Emitted when the user starts scrolling within the listbox.\n\n  * `nile-scroll-end` {} - Emitted when the user stops scrolling and reaches the bottom of the listbox (debounced).\n\nSlots:\n\n  * ` ` {} - The listbox options. Must be `<nile-option>` elements. You can use `<nile-divider>` to group items visually.\n\n  * `label` {} - The input's label. Alternatively, you can use the `label` attribute.\n\n  * `prefix` {} - Used to prepend a presentational icon or similar element to the combobox.\n\n  * `clear-icon` {} - An icon to use in lieu of the default clear icon.\n\n  * `expand-icon` {} - The icon to show when the control is expanded and collapsed. Rotates on open and close.\n\n  * `help-text` {} - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n  * `pre-footer` {} - Content to display at the bottom of the dropdown listbox. Useful for action buttons like \"Create New\". In multi-select mode, appears above the \"Show Selected\" / \"Clear All\" bar.\n\nAttributes:\n\n  * `size` {`\"small\" | \"medium\" | \"large\"`} - The select's size.\n\n  * `placeholder` {`string`} - Placeholder text to show as a hint when the select is empty.\n\n  * `searchEnabled` {`boolean`} - \n\n  * `internal-search-placeholder` {`string`} - \n\n  * `enableVisibilityEffect` {`boolean`} - \n\n  * `blockValueChange` {`boolean`} - \n\n  * `disableLocalSearch` {`boolean`} - \n\n  * `optionsLoading` {`boolean`} - \n\n  * `noWidthSync` {`boolean`} - \n\n  * `portal` {`boolean`} - When true, the listbox will be appended to the document body instead of the parent container.\nThis is useful when the parent has overflow: hidden, clip-path, or transform applied.\n\n  * `multiple` {`string | boolean`} - Allows more than one option to be selected.\n\n  * `helpText` {`string`} - \n\n  * `help-text` {`string`} - \n\n  * `autoResize` {`boolean`} - \n\n  * `error-message` {`string`} - \n\n  * `warning` {`boolean`} - Sets the input to a warning state, changing its visual appearance.\n\n  * `error` {`boolean`} - Sets the input to an error state, changing its visual appearance.\n\n  * `success` {`boolean`} - Sets the input to a success state, changing its visual appearance.\n\n  * `max-options-visible` {`number`} - The maximum number of selected options to show when `multiple` is true. After the maximum, \"+n\" will be shown to\nindicate the number of additional items that are selected. Set to 0 to remove the limit.\n\n  * `clearable` {`boolean`} - Adds a clear button when the select is not empty.\n\n  * `open` {`boolean`} - Indicates whether or not the select is open. You can toggle this attribute to show and hide the menu, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the select's open state.\n\n  * `hoist` {`boolean`} - Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.\n\n  * `filled` {`boolean`} - Draws a filled select.\n\n  * `pill` {`boolean`} - Draws a pill-style select with rounded edges.\n\n  * `label` {`string`} - The select's label. If you need to display HTML, use the `label` slot instead.\n\n  * `placement` {`ComboboxPlacement`} - The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.\n\n  * `showSelected` {`boolean`} - \n\n  * `enableTabClose` {`boolean`} - \n\n  * `showNoResults` {`boolean`} - \n\n  * `noResultsMessage` {`string`} - \n\n  * `data` - \n\n  * `enableVirtualScroll` {`boolean`} - \n\n  * `enableGroupHeader` {`boolean`} - To enable the group header in the select\n\n  * `autoFocusSearch` {`boolean`} - To auto focus the search input when the select is opened\n\n  * `loading` {`boolean`} - loading indicator for virtual select\n\n  * `stickyHeader` {`boolean`} - \n\n  * `descriptionSearchEnabled` {`boolean`} - \n\n  * `enableDescription` {`boolean`} - \n\n  * `allowHtmlLabel` {`boolean`} - \n\n  * `name` {`string`} - The name of the select, submitted as a name/value pair with form data.\n\n  * `value` {`string | string[]`} - The current value of the select, submitted as a name/value pair with form data. When `multiple` is enabled, the\nvalue will be a space-delimited list of values based on the options selected.\n\n  * `disabled` {`boolean`} - Disables the select control.\n\n  * `form` {`string`} - By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.\n\n  * `required` {`boolean`} - The select's required attribute.\n\nProperties:\n\n  * `styles` - \n\n  * `formControlController` - \n\n  * `virtualScrollHelper` - \n\n  * `portalManager` - \n\n  * `hasSlotController` - \n\n  * `typeToSelectString` {`string`} - \n\n  * `typeToSelectTimeout` {`number`} - \n\n  * `scrollTimeout` {`number | undefined`} - \n\n  * `scrolling` {`boolean`} - \n\n  * `options` {`NileOption[]`} - \n\n  * `resizeController` - \n\n  * `visibilityManager` - \n\n  * `popup` - \n\n  * `combobox` {`HTMLSlotElement`} - \n\n  * `displayInput` {`HTMLInputElement`} - \n\n  * `valueInput` {`HTMLInputElement`} - \n\n  * `listbox` {`HTMLSlotElement`} - \n\n  * `hasFocus` {`boolean`} - \n\n  * `displayLabel` {`string`} - \n\n  * `currentOption` - \n\n  * `selectedOptions` {`NileOption[]`} - \n\n  * `oldValue` {`string | string[]`} - \n\n  * `size` {`\"small\" | \"medium\" | \"large\"`} - The select's size.\n\n  * `placeholder` {`string`} - Placeholder text to show as a hint when the select is empty.\n\n  * `searchValue` {`string`} - Placeholder text to show as a hint when the select is empty.\n\n  * `searchEnabled` {`boolean`} - \n\n  * `internalSearchPlaceHolder` {`string`} - \n\n  * `enableVisibilityEffect` {`boolean`} - \n\n  * `blockValueChange` {`boolean`} - \n\n  * `disableLocalSearch` {`boolean`} - \n\n  * `optionsLoading` {`boolean`} - \n\n  * `noWidthSync` {`boolean`} - \n\n  * `portal` {`boolean`} - When true, the listbox will be appended to the document body instead of the parent container.\nThis is useful when the parent has overflow: hidden, clip-path, or transform applied.\n\n  * `multiple` {`string | boolean`} - Allows more than one option to be selected.\n\n  * `helpText` {`string`} - \n\n  * `help_text` {`string`} - \n\n  * `autoResize` {`boolean`} - \n\n  * `errorMessage` {`string`} - \n\n  * `warning` {`boolean`} - Sets the input to a warning state, changing its visual appearance.\n\n  * `error` {`boolean`} - Sets the input to an error state, changing its visual appearance.\n\n  * `success` {`boolean`} - Sets the input to a success state, changing its visual appearance.\n\n  * `maxOptionsVisible` {`number`} - The maximum number of selected options to show when `multiple` is true. After the maximum, \"+n\" will be shown to\nindicate the number of additional items that are selected. Set to 0 to remove the limit.\n\n  * `clearable` {`boolean`} - Adds a clear button when the select is not empty.\n\n  * `open` {`boolean`} - Indicates whether or not the select is open. You can toggle this attribute to show and hide the menu, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the select's open state.\n\n  * `hoist` {`boolean`} - Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.\n\n  * `filled` {`boolean`} - Draws a filled select.\n\n  * `pill` {`boolean`} - Draws a pill-style select with rounded edges.\n\n  * `label` {`string`} - The select's label. If you need to display HTML, use the `label` slot instead.\n\n  * `placement` {`ComboboxPlacement`} - The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.\n\n  * `showSelected` {`boolean`} - \n\n  * `oldMaxOptionsVisible` {`number`} - \n\n  * `enableTabClose` {`boolean`} - \n\n  * `showNoResults` {`boolean`} - \n\n  * `noResultsMessage` {`string`} - \n\n  * `renderItemConfig` {`RenderItemConfig | undefined`} - Enhanced configuration for rendering items with support for display text, value, and search text\n\n  * `data` - \n\n  * `enableVirtualScroll` {`boolean`} - \n\n  * `enableGroupHeader` {`boolean`} - To enable the group header in the select\n\n  * `autoFocusSearch` {`boolean`} - To auto focus the search input when the select is opened\n\n  * `loading` {`boolean`} - loading indicator for virtual select\n\n  * `stickyHeader` {`boolean`} - \n\n  * `descriptionSearchEnabled` {`boolean`} - \n\n  * `enableDescription` {`boolean`} - \n\n  * `allowHtmlLabel` {`boolean`} - \n\n  * `handleWindowResize` - \n\n  * `handleWindowScroll` - \n\n  * `name` {`string`} - The name of the select, submitted as a name/value pair with form data.\n\n  * `value` {`string | string[]`} - The current value of the select, submitted as a name/value pair with form data. When `multiple` is enabled, the\nvalue will be a space-delimited list of values based on the options selected.\n\n  * `disabled` {`boolean`} - Disables the select control.\n\n  * `defaultValue` {`string | string[]`} - The default value of the form control. Primarily used for resetting the form control.\n\n  * `defaultChecked` {`boolean | undefined`} - \n\n  * `form` {`string`} - By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.\n\n  * `pattern` {`string | undefined`} - \n\n  * `min` {`string | number | Date | undefined`} - \n\n  * `max` {`string | number | Date | undefined`} - \n\n  * `step` {`number | \"any\" | undefined`} - \n\n  * `required` {`boolean`} - The select's required attribute.\n\n  * `minlength` {`number | undefined`} - \n\n  * `maxlength` {`number | undefined`} - \n\n  * `validity` {`ValidityState`} - Gets the validity state object\n\n  * `validationMessage` {`string`} - Gets the validation message\n\n  * `checkValidity` - \n\n  * `getForm` - \n\n  * `reportValidity` - \n\n  * `setCustomValidity` - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "size",
@@ -5163,7 +5465,7 @@
         },
         {
           "name": "placement",
-          "description": "`placement` {`\"top\" | \"bottom\"`} - The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.\n\nProperty: placement\n\nDefault: bottom",
+          "description": "`placement` {`ComboboxPlacement`} - The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.\n\nProperty: placement\n\nDefault: bottom",
           "values": [
             {
               "name": "top"
@@ -6857,7 +7159,7 @@
     },
     {
       "name": "nile-virtual-select",
-      "description": "Events:\n\n  * `nile-change` {} - Emitted when the control's value changes.\n\n  * `nile-clear` {} - Emitted when the control's value is cleared.\n\n  * `nile-input` {} - Emitted when the control receives input.\n\n  * `nile-focus` {} - Emitted when the control gains focus.\n\n  * `nile-blur` {} - Emitted when the control loses focus.\n\n  * `nile-show` {} - Emitted when the select's menu opens.\n\n  * `nile-after-show` {} - Emitted after the select's menu opens and all animations are complete.\n\n  * `nile-hide` {} - Emitted when the select's menu closes.\n\n  * `nile-after-hide` {} - Emitted after the select's menu closes and all animations are complete.\n\n  * `nile-invalid` {} - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n  * `nile-search` {} - Emitted when the user types in the search input. The event payload includes the search query for backend search functionality.\n\n  * `nile-scroll` {} - Emitted when the user scrolls within the virtualized container. The event payload includes scroll position information.\n\n  * `nile-scroll-start` {} - Emitted when the user starts scrolling within the virtualized container.\n\n  * `nile-scroll-end` {} - Emitted when the user stops scrolling and reaches the bottom of the virtualized container (debounced).\n\nSlots:\n\n  * `label` {} - The input's label. Alternatively, you can use the `label` attribute.\n\n  * `prefix` {} - Used to prepend a presentational icon or similar element to the combobox.\n\n  * `clear-icon` {} - An icon to use in lieu of the default clear icon.\n\n  * `expand-icon` {} - The icon to show when the control is expanded and collapsed.\n\n  * `help-text` {} - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\nAttributes:\n\n  * `data` - Array of all option items for virtual scrolling\n\n  * `size` {`\"small\" | \"medium\" | \"large\"`} - The select's size.\n\n  * `placeholder` {`string`} - Placeholder text to show as a hint when the select is empty.\n\n  * `autoResize` {`boolean`} - Enable automatic resizing of tags area\n\n  * `searchEnabled` {`boolean`} - Enable search functionality\n\n  * `enableVisibilityEffect` {`boolean`} - \n\n  * `internal-search-placeholder` {`string`} - Search input placeholder\n\n  * `disableLocalSearch` {`boolean`} - Disable local search filtering\n\n  * `optionsLoading` {`boolean`} - Show loading state\n\n  * `loading` {`boolean`} - Show loading state using nile-loader\n\n  * `multiple` {`boolean`} - Allows more than one option to be selected.\n\n  * `help-text` {`string`} - Help text\n\n  * `error-message` {`string`} - Error message\n\n  * `warning` {`boolean`} - Sets the input to a warning state\n\n  * `error` {`boolean`} - Sets the input to an error state\n\n  * `success` {`boolean`} - Sets the input to a success state\n\n  * `clearable` {`boolean`} - Adds a clear button when the select is not empty.\n\n  * `open` {`boolean`} - The select's open state.\n\n  * `hoist` {`boolean`} - Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.\n\n  * `filled` {`boolean`} - Draws a filled select.\n\n  * `pill` {`boolean`} - Draws a pill-style select with rounded edges.\n\n  * `label` {`string`} - The select's label. If you need to display HTML, use the `label` slot instead.\n\n  * `placement` {`\"top\" | \"bottom\"`} - The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.\n\n  * `showNoResults` {`boolean`} - Show no results message\n\n  * `noResultsMessage` {`string`} - No results message\n\n  * `showSelected` {`boolean`} - Show selected options only\n\n  * `blockValueChange` {`boolean`} - Block value change events\n\n  * `noWidthSync` {`boolean`} - Disable width synchronization\n\n  * `portal` {`boolean`} - When true, the listbox will be appended to the document body instead of the parent container.\nThis is useful when the parent has overflow: hidden, clip-path, or transform applied.\n\n  * `max-options-visible` {`number`} - The maximum number of selected options to show when `multiple` is true. After the maximum, \"+n\" will be shown to\nindicate the number of additional items that are selected. Set to 0 to remove the limit.\n\n  * `enableTabClose` {`boolean`} - \n\n  * `descriptionSearchEnabled` {`boolean`} - \n\n  * `allowHtmlLabel` {`boolean`} - \n\n  * `enableDescription` {`boolean`} - \n\n  * `name` {`string`} - The name of the select, submitted as a name/value pair with form data.\n\n  * `value` {`string | string[]`} - The current value of the select. When `multiple` is enabled, the value will be an array of selected values.\n\n  * `disabled` {`boolean`} - Disables the select control.\n\n  * `form` {`string`} - By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.\n\n  * `required` {`boolean`} - The select's required attribute.\n\nProperties:\n\n  * `styles` - \n\n  * `formControlController` - \n\n  * `hasSlotController` - \n\n  * `portalManager` - \n\n  * `popup` - \n\n  * `combobox` {`HTMLElement`} - \n\n  * `displayInput` {`HTMLInputElement`} - \n\n  * `valueInput` {`HTMLInputElement`} - \n\n  * `virtualizedContainer` {`HTMLElement`} - \n\n  * `hasFocus` {`boolean`} - \n\n  * `displayLabel` {`string`} - \n\n  * `selectedOptions` {`VirtualOption[]`} - \n\n  * `oldValue` {`string | string[]`} - \n\n  * `scrollTimeout` {`number | undefined`} - \n\n  * `scrolling` {`boolean`} - \n\n  * `visibilityManager` - \n\n  * `data` - Array of all option items for virtual scrolling\n\n  * `originalOptionItems` - Original unfiltered option items for search functionality\n\n  * `size` {`\"small\" | \"medium\" | \"large\"`} - The select's size.\n\n  * `placeholder` {`string`} - Placeholder text to show as a hint when the select is empty.\n\n  * `autoResize` {`boolean`} - Enable automatic resizing of tags area\n\n  * `searchValue` {`string`} - Current search value\n\n  * `searchEnabled` {`boolean`} - Enable search functionality\n\n  * `enableVisibilityEffect` {`boolean`} - \n\n  * `internalSearchPlaceHolder` {`string`} - Search input placeholder\n\n  * `disableLocalSearch` {`boolean`} - Disable local search filtering\n\n  * `optionsLoading` {`boolean`} - Show loading state\n\n  * `loading` {`boolean`} - Show loading state using nile-loader\n\n  * `multiple` {`boolean`} - Allows more than one option to be selected.\n\n  * `helpText` {`string`} - Help text\n\n  * `errorMessage` {`string`} - Error message\n\n  * `warning` {`boolean`} - Sets the input to a warning state\n\n  * `error` {`boolean`} - Sets the input to an error state\n\n  * `success` {`boolean`} - Sets the input to a success state\n\n  * `clearable` {`boolean`} - Adds a clear button when the select is not empty.\n\n  * `open` {`boolean`} - The select's open state.\n\n  * `hoist` {`boolean`} - Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.\n\n  * `filled` {`boolean`} - Draws a filled select.\n\n  * `pill` {`boolean`} - Draws a pill-style select with rounded edges.\n\n  * `label` {`string`} - The select's label. If you need to display HTML, use the `label` slot instead.\n\n  * `placement` {`\"top\" | \"bottom\"`} - The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.\n\n  * `showNoResults` {`boolean`} - Show no results message\n\n  * `noResultsMessage` {`string`} - No results message\n\n  * `showSelected` {`boolean`} - Show selected options only\n\n  * `renderItemConfig` {`RenderItemConfig | undefined`} - Enhanced configuration for rendering items with support for display text, value, and search text\n\n  * `blockValueChange` {`boolean`} - Block value change events\n\n  * `noWidthSync` {`boolean`} - Disable width synchronization\n\n  * `portal` {`boolean`} - When true, the listbox will be appended to the document body instead of the parent container.\nThis is useful when the parent has overflow: hidden, clip-path, or transform applied.\n\n  * `maxOptionsVisible` {`number`} - The maximum number of selected options to show when `multiple` is true. After the maximum, \"+n\" will be shown to\nindicate the number of additional items that are selected. Set to 0 to remove the limit.\n\n  * `oldMaxOptionsVisible` {`number`} - \n\n  * `enableTabClose` {`boolean`} - \n\n  * `descriptionSearchEnabled` {`boolean`} - \n\n  * `allowHtmlLabel` {`boolean`} - \n\n  * `enableDescription` {`boolean`} - \n\n  * `showListbox` {`boolean`} - \n\n  * `wasShowSelectedCheckedOnClose` {`boolean`} - \n\n  * `handleDocumentMouseDown` - \n\n  * `handleWindowError` - This is a workaround for an error in the Lit Labs virtualizer.\nSince there are no specific guidelines available to fix the issue,\nwe are catching only the error message related to the virtualizer.\n\n  * `handleWindowResize` - \n\n  * `handleWindowScroll` - \n\n  * `resizeController` - \n\n  * `name` {`string`} - The name of the select, submitted as a name/value pair with form data.\n\n  * `value` {`string | string[]`} - The current value of the select. When `multiple` is enabled, the value will be an array of selected values.\n\n  * `disabled` {`boolean`} - Disables the select control.\n\n  * `defaultValue` {`string | string[]`} - The default value of the form control. Primarily used for resetting the form control.\n\n  * `defaultChecked` {`boolean | undefined`} - \n\n  * `form` {`string`} - By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.\n\n  * `pattern` {`string | undefined`} - \n\n  * `min` {`string | number | Date | undefined`} - \n\n  * `max` {`string | number | Date | undefined`} - \n\n  * `step` {`number | \"any\" | undefined`} - \n\n  * `required` {`boolean`} - The select's required attribute.\n\n  * `minlength` {`number | undefined`} - \n\n  * `maxlength` {`number | undefined`} - \n\n  * `validity` {`ValidityState`} - Gets the validity state object\n\n  * `validationMessage` {`string`} - Gets the validation message\n\n  * `checkValidity` - \n\n  * `getForm` - \n\n  * `reportValidity` - \n\n  * `setCustomValidity` - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Events:\n\n  * `nile-change` {} - Emitted when the control's value changes.\n\n  * `nile-clear` {} - Emitted when the control's value is cleared.\n\n  * `nile-input` {} - Emitted when the control receives input.\n\n  * `nile-focus` {} - Emitted when the control gains focus.\n\n  * `nile-blur` {} - Emitted when the control loses focus.\n\n  * `nile-show` {} - Emitted when the select's menu opens.\n\n  * `nile-after-show` {} - Emitted after the select's menu opens and all animations are complete.\n\n  * `nile-hide` {} - Emitted when the select's menu closes.\n\n  * `nile-after-hide` {} - Emitted after the select's menu closes and all animations are complete.\n\n  * `nile-invalid` {} - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n  * `nile-search` {} - Emitted when the user types in the search input. The event payload includes the search query for backend search functionality.\n\n  * `nile-scroll` {} - Emitted when the user scrolls within the virtualized container. The event payload includes scroll position information.\n\n  * `nile-scroll-start` {} - Emitted when the user starts scrolling within the virtualized container.\n\n  * `nile-scroll-end` {} - Emitted when the user stops scrolling and reaches the bottom of the virtualized container (debounced).\n\nSlots:\n\n  * `label` {} - The input's label. Alternatively, you can use the `label` attribute.\n\n  * `prefix` {} - Used to prepend a presentational icon or similar element to the combobox.\n\n  * `clear-icon` {} - An icon to use in lieu of the default clear icon.\n\n  * `expand-icon` {} - The icon to show when the control is expanded and collapsed.\n\n  * `help-text` {} - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\nAttributes:\n\n  * `data` - Array of all option items for virtual scrolling\n\n  * `size` {`\"small\" | \"medium\" | \"large\"`} - The select's size.\n\n  * `placeholder` {`string`} - Placeholder text to show as a hint when the select is empty.\n\n  * `autoResize` {`boolean`} - Enable automatic resizing of tags area\n\n  * `searchEnabled` {`boolean`} - Enable search functionality\n\n  * `enableVisibilityEffect` {`boolean`} - \n\n  * `internal-search-placeholder` {`string`} - Search input placeholder\n\n  * `disableLocalSearch` {`boolean`} - Disable local search filtering\n\n  * `optionsLoading` {`boolean`} - Show loading state\n\n  * `loading` {`boolean`} - Show loading state using nile-loader\n\n  * `multiple` {`boolean`} - Allows more than one option to be selected.\n\n  * `help-text` {`string`} - Help text\n\n  * `error-message` {`string`} - Error message\n\n  * `warning` {`boolean`} - Sets the input to a warning state\n\n  * `error` {`boolean`} - Sets the input to an error state\n\n  * `success` {`boolean`} - Sets the input to a success state\n\n  * `clearable` {`boolean`} - Adds a clear button when the select is not empty.\n\n  * `open` {`boolean`} - The select's open state.\n\n  * `hoist` {`boolean`} - Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.\n\n  * `filled` {`boolean`} - Draws a filled select.\n\n  * `pill` {`boolean`} - Draws a pill-style select with rounded edges.\n\n  * `label` {`string`} - The select's label. If you need to display HTML, use the `label` slot instead.\n\n  * `placement` {`ComboboxPlacement`} - The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.\n\n  * `showNoResults` {`boolean`} - Show no results message\n\n  * `noResultsMessage` {`string`} - No results message\n\n  * `showSelected` {`boolean`} - Show selected options only\n\n  * `blockValueChange` {`boolean`} - Block value change events\n\n  * `noWidthSync` {`boolean`} - Disable width synchronization\n\n  * `portal` {`boolean`} - When true, the listbox will be appended to the document body instead of the parent container.\nThis is useful when the parent has overflow: hidden, clip-path, or transform applied.\n\n  * `max-options-visible` {`number`} - The maximum number of selected options to show when `multiple` is true. After the maximum, \"+n\" will be shown to\nindicate the number of additional items that are selected. Set to 0 to remove the limit.\n\n  * `enableTabClose` {`boolean`} - \n\n  * `descriptionSearchEnabled` {`boolean`} - \n\n  * `allowHtmlLabel` {`boolean`} - \n\n  * `enableDescription` {`boolean`} - \n\n  * `name` {`string`} - The name of the select, submitted as a name/value pair with form data.\n\n  * `value` {`string | string[]`} - The current value of the select. When `multiple` is enabled, the value will be an array of selected values.\n\n  * `disabled` {`boolean`} - Disables the select control.\n\n  * `form` {`string`} - By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.\n\n  * `required` {`boolean`} - The select's required attribute.\n\nProperties:\n\n  * `styles` - \n\n  * `formControlController` - \n\n  * `hasSlotController` - \n\n  * `portalManager` - \n\n  * `popup` - \n\n  * `combobox` {`HTMLElement`} - \n\n  * `displayInput` {`HTMLInputElement`} - \n\n  * `valueInput` {`HTMLInputElement`} - \n\n  * `virtualizedContainer` {`HTMLElement`} - \n\n  * `hasFocus` {`boolean`} - \n\n  * `displayLabel` {`string`} - \n\n  * `selectedOptions` {`VirtualOption[]`} - \n\n  * `oldValue` {`string | string[]`} - \n\n  * `scrollTimeout` {`number | undefined`} - \n\n  * `scrolling` {`boolean`} - \n\n  * `visibilityManager` - \n\n  * `data` - Array of all option items for virtual scrolling\n\n  * `originalOptionItems` - Original unfiltered option items for search functionality\n\n  * `size` {`\"small\" | \"medium\" | \"large\"`} - The select's size.\n\n  * `placeholder` {`string`} - Placeholder text to show as a hint when the select is empty.\n\n  * `autoResize` {`boolean`} - Enable automatic resizing of tags area\n\n  * `searchValue` {`string`} - Current search value\n\n  * `searchEnabled` {`boolean`} - Enable search functionality\n\n  * `enableVisibilityEffect` {`boolean`} - \n\n  * `internalSearchPlaceHolder` {`string`} - Search input placeholder\n\n  * `disableLocalSearch` {`boolean`} - Disable local search filtering\n\n  * `optionsLoading` {`boolean`} - Show loading state\n\n  * `loading` {`boolean`} - Show loading state using nile-loader\n\n  * `multiple` {`boolean`} - Allows more than one option to be selected.\n\n  * `helpText` {`string`} - Help text\n\n  * `errorMessage` {`string`} - Error message\n\n  * `warning` {`boolean`} - Sets the input to a warning state\n\n  * `error` {`boolean`} - Sets the input to an error state\n\n  * `success` {`boolean`} - Sets the input to a success state\n\n  * `clearable` {`boolean`} - Adds a clear button when the select is not empty.\n\n  * `open` {`boolean`} - The select's open state.\n\n  * `hoist` {`boolean`} - Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.\n\n  * `filled` {`boolean`} - Draws a filled select.\n\n  * `pill` {`boolean`} - Draws a pill-style select with rounded edges.\n\n  * `label` {`string`} - The select's label. If you need to display HTML, use the `label` slot instead.\n\n  * `placement` {`ComboboxPlacement`} - The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.\n\n  * `showNoResults` {`boolean`} - Show no results message\n\n  * `noResultsMessage` {`string`} - No results message\n\n  * `showSelected` {`boolean`} - Show selected options only\n\n  * `renderItemConfig` {`RenderItemConfig | undefined`} - Enhanced configuration for rendering items with support for display text, value, and search text\n\n  * `blockValueChange` {`boolean`} - Block value change events\n\n  * `noWidthSync` {`boolean`} - Disable width synchronization\n\n  * `portal` {`boolean`} - When true, the listbox will be appended to the document body instead of the parent container.\nThis is useful when the parent has overflow: hidden, clip-path, or transform applied.\n\n  * `maxOptionsVisible` {`number`} - The maximum number of selected options to show when `multiple` is true. After the maximum, \"+n\" will be shown to\nindicate the number of additional items that are selected. Set to 0 to remove the limit.\n\n  * `oldMaxOptionsVisible` {`number`} - \n\n  * `enableTabClose` {`boolean`} - \n\n  * `descriptionSearchEnabled` {`boolean`} - \n\n  * `allowHtmlLabel` {`boolean`} - \n\n  * `enableDescription` {`boolean`} - \n\n  * `showListbox` {`boolean`} - \n\n  * `wasShowSelectedCheckedOnClose` {`boolean`} - \n\n  * `handleDocumentMouseDown` - \n\n  * `handleWindowError` - This is a workaround for an error in the Lit Labs virtualizer.\nSince there are no specific guidelines available to fix the issue,\nwe are catching only the error message related to the virtualizer.\n\n  * `handleWindowResize` - \n\n  * `handleWindowScroll` - \n\n  * `resizeController` - \n\n  * `name` {`string`} - The name of the select, submitted as a name/value pair with form data.\n\n  * `value` {`string | string[]`} - The current value of the select. When `multiple` is enabled, the value will be an array of selected values.\n\n  * `disabled` {`boolean`} - Disables the select control.\n\n  * `defaultValue` {`string | string[]`} - The default value of the form control. Primarily used for resetting the form control.\n\n  * `defaultChecked` {`boolean | undefined`} - \n\n  * `form` {`string`} - By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.\n\n  * `pattern` {`string | undefined`} - \n\n  * `min` {`string | number | Date | undefined`} - \n\n  * `max` {`string | number | Date | undefined`} - \n\n  * `step` {`number | \"any\" | undefined`} - \n\n  * `required` {`boolean`} - The select's required attribute.\n\n  * `minlength` {`number | undefined`} - \n\n  * `maxlength` {`number | undefined`} - \n\n  * `validity` {`ValidityState`} - Gets the validity state object\n\n  * `validationMessage` {`string`} - Gets the validation message\n\n  * `checkValidity` - \n\n  * `getForm` - \n\n  * `reportValidity` - \n\n  * `setCustomValidity` - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "data",
@@ -6975,7 +7277,7 @@
         },
         {
           "name": "placement",
-          "description": "`placement` {`\"top\" | \"bottom\"`} - The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.\n\nProperty: placement\n\nDefault: bottom",
+          "description": "`placement` {`ComboboxPlacement`} - The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.\n\nProperty: placement\n\nDefault: bottom",
           "values": [
             {
               "name": "top"

package/web-dev-server.config.mjs

@@ -1,4 +1,8 @@
 // import { hmrPlugin, presets } from '@open-wc/dev-server-hmr';
+import { fromRollup } from '@web/dev-server-rollup';
+import rollupReplace from '@rollup/plugin-replace';
+
+const replace = fromRollup(rollupReplace);
 
 /** Use Hot Module replacement by adding --hmr to the start command */
 const hmr = process.argv.includes('--hmr');
@@ -21,6 +25,11 @@ export default /** @type {import('@web/dev-server').DevServerConfig} */ ({
   plugins: [
     /** Use Hot Module Replacement by uncommenting. Requires @open-wc/dev-server-hmr plugin */
     // hmr && hmrPlugin({ exclude: ['**/*/node_modules/**/*'], presets: [presets.litElement] }),
+
+    replace({
+      preventAssignment: true,
+      'process.env.NODE_ENV': JSON.stringify('production'),
+    }),
   ],
 
   // See documentation for all available options

package/web-test-runner.config.mjs

@@ -1,4 +1,8 @@
 import { puppeteerLauncher } from '@web/test-runner-puppeteer';
+import { fromRollup } from '@web/dev-server-rollup';
+import rollupReplace from '@rollup/plugin-replace';
+
+const replace = fromRollup(rollupReplace);
 
 const filteredLogs = ['Running in dev mode', 'lit-html is in dev mode', 'Multiple versions of Lit loaded', 'The main \'lit-element\' module entrypoint is deprecated'];
 
@@ -47,6 +51,13 @@ export default /** @type {import("@web/test-runner").TestRunnerConfig} */ ({
     }
   },
 
+  plugins: [
+    replace({
+      preventAssignment: true,
+      'process.env.NODE_ENV': JSON.stringify('production'),
+    }),
+  ],
+
   coverage: true,
 
   /** Coverage configuration */