@ds-mo/ui 14.16.0 → 14.17.0

package/dist/mcp-data/registry/registry.json

@@ -2043,7 +2043,7 @@
             "Set isInset only when the button is nested inside a same-size control. The default single inset removes 4px overall; insetDepth double removes 8px overall so the parent can add 4px per edge while preserving its outer alignment box. Double inset falls back to single at xs to protect minimum icon geometry.",
             "A true pressed toggle and owner-controlled isActive emphasis share the selected visual treatment, but only pressed supplies toggle semantics and dsChange.",
             "General content UI keeps the selected interaction fill and border for pressed or active emphasis.",
-            "Shell, navigation, and tool-rail composites use isActive with foreground-only emphasis and no selected fill or border. On icon-label that emphasis is the label; the leading icon and menu chevron keep the resting foreground. On icon, the glyph is the only content and takes the primary foreground.",
+            "Shell, navigation, and tool-rail composites use isActive with primary foreground across the complete control and no selected fill or border.",
             "The omitted default surface treatment is for primary and secondary parent surfaces and uses the brand-active selected fill; pass faint explicitly on faint surfaces to use the neutral active fill.",
             "Surface context must match the actual parent surface; translucent, inverted, media, and always-dark treatments are reserved for those surfaces.",
             "Loading prevents duplicate activation without applying inactive opacity or removing the current keyboard focus.",
@@ -4532,6 +4532,7 @@
           ],
           "states": [
             "Loader communicates indeterminate progress only and does not emit completion or failure events.",
+            "The segmented glyph rotates clockwise, with its opacity ramp trailing the leading arc.",
             "Omitted color inherits currentColor. Explicit semantic aliases and CSS-variable references match Icon when an independent progress color is required.",
             "Nested Loader inherits a readable color from its owning busy control or region rather than selecting tertiary or quaternary directly.",
             "The owner decides whether to delay Loader visibility for short operations and removes it when the operation settles.",
@@ -9065,6 +9066,7 @@
             "component:ds-pagination",
             "component:ds-table-toolbar",
             "component:ds-table-saved-views",
+            "component:ds-table-filter",
             "component:ds-table-sort",
             "component:ds-bar-action",
             "component:ds-button-unfilled",
@@ -9449,6 +9451,163 @@
         "tooltip"
       ]
     },
+    {
+      "name": "table-filter",
+      "title": "TableFilter",
+      "description": "Standard table-toolbar Filter control that owns the shared trigger, filter menu UI, accessible defaults, and compact-caption behavior while the application controls data and values.",
+      "type": "registry:ui",
+      "meta": {
+        "library": "@ds-mo/ui",
+        "distribution": "npm",
+        "storybook": "https://zainadeel.github.io/compomo/?path=/story/table-filter",
+        "source": "src/wc/components/TableFilter/TableFilter.tsx",
+        "intentStatus": "complete",
+        "intent": {
+          "audience": "general",
+          "status": "stable",
+          "summary": "Standard table-toolbar Filter control that owns the shared trigger, filter menu UI, accessible defaults, and compact-caption behavior while the application controls data and values.",
+          "useWhen": [
+            "A table toolbar should expose the standard singular Filter control and shared filter-menu interaction.",
+            "A product supplies filter definitions and controlled values but should not recreate the toolbar trigger, selected count, category navigation, or responsive treatment."
+          ],
+          "avoidWhen": [
+            "Filtering is unrelated to a table or structured result set; use ds-filter-menu directly.",
+            "The application expects the component to filter, fetch, persist, or otherwise transform rows.",
+            "A filter requires a product-specific editor that the shared filter category kinds cannot represent."
+          ],
+          "alternatives": [
+            {
+              "when": "A non-table surface needs the generic filter interaction or custom trigger recipe.",
+              "component": "component:ds-filter-menu",
+              "reason": "FilterMenu exposes generic trigger geometry and popup positioning rather than the fixed table-toolbar recipe."
+            }
+          ],
+          "commonlyComposedWith": [
+            "component:ds-table",
+            "component:ds-table-toolbar",
+            "component:ds-table-saved-views",
+            "component:ds-table-sort",
+            "component:ds-filter-menu"
+          ],
+          "patterns": [
+            "pattern:menu-trigger"
+          ],
+          "accessibility": [
+            "The trigger is an icon-label combobox named Filter table unless a product aria-label supplies the table context. Compact caption widths preserve that accessible name after the visible label and chevron are omitted.",
+            "The popup retains ds-filter-menu category navigation, option semantics, focus entry, dismissal, and focus return.",
+            "Localize label, menuLabel, categoriesLabel, and clearLabel together so visible and accessible wording remains consistent."
+          ],
+          "states": [
+            "filters, values, and activeFilterId are controlled. dsChange, dsClear, and dsActiveFilterChange report intent without changing those inputs; the application applies query consequences and returns replacement values.",
+            "The visible trigger label defaults to singular Filter and appends the selected criterion count. The trigger uses resting secondary chrome at typical widths; active criteria promote only the visible label, without redefining generic button active semantics.",
+            "Popup visibility follows the same mutable open and dsOpenChange contract as ds-filter-menu."
+          ],
+          "responsiveBehavior": [
+            "Place the control in the trailing region of ds-table-toolbar.",
+            "Inside a named ds-table container narrower than 900px, the trigger becomes icon-only and active criteria promote the Filters icon to primary."
+          ],
+          "frameworkCaveats": {
+            "customElements": [
+              "Assign filters, values, and activeFilterId as JavaScript properties. Replace controlled values in response to dsChange and dsClear."
+            ],
+            "react": [
+              "Keep filters and values in application state and replace values from the typed dsChange and dsClear events."
+            ],
+            "angular": [
+              "Import the generated DsTableFilter adapter, bind filters and values, and handle dsChange, dsClear, and dsActiveFilterChange."
+            ]
+          },
+          "references": [
+            {
+              "label": "Storybook review states",
+              "path": "src/wc/components/TableFilter/TableFilter.stories.ts"
+            },
+            {
+              "label": "Toolbar composition owner",
+              "path": "src/wc/components/TableToolbar/TableToolbar.agent.json"
+            }
+          ]
+        },
+        "props": {
+          "activeFilterId": {
+            "type": "string | undefined",
+            "required": false
+          },
+          "ariaLabel": {
+            "type": "string | null",
+            "required": false
+          },
+          "categoriesLabel": {
+            "type": "string",
+            "required": false
+          },
+          "clearLabel": {
+            "type": "string",
+            "required": false
+          },
+          "filters": {
+            "type": "FilterMenuFilter[]",
+            "required": false
+          },
+          "label": {
+            "type": "string",
+            "required": false
+          },
+          "menuLabel": {
+            "type": "string | null",
+            "required": false
+          },
+          "open": {
+            "type": "boolean",
+            "required": false
+          },
+          "values": {
+            "type": "FilterMenuValues",
+            "required": false
+          }
+        },
+        "events": [
+          {
+            "name": "dsActiveFilterChange",
+            "detail": "string"
+          },
+          {
+            "name": "dsAfterClose",
+            "detail": "void"
+          },
+          {
+            "name": "dsChange",
+            "detail": "FilterMenuChangeDetail"
+          },
+          {
+            "name": "dsClear",
+            "detail": "void"
+          },
+          {
+            "name": "dsClose",
+            "detail": "void"
+          },
+          {
+            "name": "dsOpenChange",
+            "detail": "boolean"
+          }
+        ],
+        "slots": [],
+        "exports": {
+          "customElement": "ds-table-filter",
+          "react": "DsTableFilter",
+          "vue": "DsTableFilter",
+          "angular": "DsTableFilter"
+        }
+      },
+      "dependencies": [
+        "@ds-mo/ui",
+        "@ds-mo/tokens"
+      ],
+      "registryDependencies": [
+        "filter-menu"
+      ]
+    },
     {
       "name": "table-saved-views",
       "title": "TableSavedViews",
@@ -9493,7 +9652,7 @@
             "The default view is a non-editable template. Application-owned custom views appear in a separate section with Rename and Remove actions. New view opens the naming dialog. When an editable selected view is dirty, that view row shows Save and negative Discard supporting actions while the footer remains dedicated to New view. The application decides which table state to capture, restore, and persist."
           ],
           "responsiveBehavior": [
-            "The control remains a single toolbar item and relies on Select, Menu, and Modal collision and viewport behavior. Its trigger is capped at the compact menu-width token so long view names truncate while the dirty dot stays visible. Its choice popup keeps that same token as the minimum width.",
+            "The control remains a single toolbar item and relies on Select, Menu, and Modal collision and viewport behavior. Its trigger hugs short view names and is capped at the compact menu-width token so long names truncate while the dirty dot stays visible. Its choice popup keeps that same token as the minimum width.",
             "Place it in the start region of ds-table-toolbar so the middle region can keep left-side and right-side controls on one spanning cluster."
           ],
           "frameworkCaveats": {
@@ -9634,7 +9793,7 @@
           "commonlyComposedWith": [
             "component:ds-table",
             "component:ds-table-toolbar",
-            "component:ds-filter-menu",
+            "component:ds-table-filter",
             "component:ds-select",
             "component:ds-button-unfilled",
             "component:ds-menu"
@@ -9745,7 +9904,7 @@
             "component:ds-table-saved-views",
             "component:ds-divider",
             "component:ds-input",
-            "component:ds-filter-menu",
+            "component:ds-table-filter",
             "component:ds-select",
             "component:ds-table-sort",
             "component:ds-button-unfilled"
@@ -9757,25 +9916,25 @@
             "Tab order follows authored DOM order. The toolbar does not add roving focus because it may contain heterogeneous form and popup controls."
           ],
           "states": [
-            "The component owns layout only. Slotted controls, values, menus, loading, persistence, and consequences remain controlled by the application. Use ds-table-saved-views when saved-view interaction needs the shared CompoMo behavior while application storage remains external.",
+            "The component owns layout only. It never mutates slotted control props, values, menus, loading, persistence, or consequences. Use ds-table-saved-views and ds-table-filter when those interactions need the shared CompoMo behavior while application data and persistence remain external.",
             "The start cluster is followed by a decorative vertical divider, then the spanning middle region. The start cluster and divider hide when nothing is projected. Search is a dedicated slot that hides when nothing is projected. Empty leading or trailing clusters add no placeholder chrome. The middle region occupies remaining width so trailing controls stay at its inline end.",
             "Column customizer and data-mode switching stay table-owned caption actions. Do not recreate those menus in the toolbar."
           ],
           "responsiveBehavior": [
-            "The start cluster, search, trailing Filter/Group/Sort, and table caption trailing actions stay on one line. Saved views, Filter, Group, and Sort triggers cap at the compact menu-width token and truncate their labels, keeping a saved-view dirty dot visible. Group and Sort popups keep that same compact menu-width floor. The toolbar horizontally scrolls when its complete controls no longer fit.",
-            "Inside a named ds-table container narrower than 900px, Filter, Group, and Sort omit their labels and chevrons and become icon-only. Active filtering or grouping promotes the prefix icon to primary. Sort keeps resting secondary chrome. Table-owned Customize also becomes the icon-only Table menu button at that width.",
+            "The start cluster, search, trailing Filter/Group/Sort, and table caption trailing actions stay on one line. Saved views hug their current trigger content up to the compact menu-width token rather than reserving that full width; long names truncate while the dirty dot stays visible. Filter, Group, and Sort triggers cap at the same token, and Group and Sort popups keep that compact menu-width floor. The toolbar horizontally scrolls when its complete controls no longer fit.",
+            "Inside a named ds-table container narrower than 900px, ds-table-filter and ds-table-sort omit their labels and chevrons and become icon-only. Group controls explicitly opt into the same treatment with collapseLabel. Active filtering or grouping promotes the prefix icon to primary. Sort keeps resting secondary chrome. Table-owned Customize also becomes the icon-only Table menu button at that width.",
             "The scrollbar is visually suppressed without removing touch, trackpad, mouse-wheel, or keyboard scrolling from the overflow container.",
             "Trailing controls remain grouped after leading controls; the toolbar does not collapse controls into an application-specific overflow menu."
           ],
           "frameworkCaveats": {
             "customElements": [
-              "Project saved views through slot=start, search through slot=search, additional left-side middle controls through slot=leading, and Filter, Group, and Sort through slot=trailing. Provide a label that names their table context when Table controls is insufficient."
+              "Project saved views through slot=start, search through slot=search, additional left-side middle controls through slot=leading, and ds-table-filter, Group, and ds-table-sort through slot=trailing. Set collapseLabel on the Group control and provide contextual accessible names when Table controls is insufficient."
             ],
             "react": [
-              "Set slot=start, slot=search, slot=leading, or slot=trailing on each child control; keep values and event handlers in the application."
+              "Set slot=start, slot=search, slot=leading, or slot=trailing on each child control. Use ds-table-filter for the standard Filter recipe, opt Group into collapseLabel, and keep values and event handlers in the application."
             ],
             "angular": [
-              "Set slot=start, slot=search, slot=leading, or slot=trailing on each child control and import the generated DsTableToolbar adapter alongside those controls."
+              "Set slot=start, slot=search, slot=leading, or slot=trailing on each child control, use DsTableFilter for the standard Filter recipe, opt Group into collapseLabel, and import the generated adapters."
             ]
           },
           "references": [

package/dist/mcp-data/registry/select.json

@@ -957,7 +957,7 @@
     },
     {
       "path": "src/wc/components/Select/Select.tsx",
-      "content": "import {\n  AttachInternals,\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Method,\n  Prop,\n  State,\n  Watch,\n} from '@stencil/core';\nimport {\n  controlWidthClass,\n  CONTROL_SUPPORTING_TEXT_VARIANT,\n  CONTROL_TEXT_VARIANT,\n  DEFAULT_REQUIRED_MESSAGE,\n  restoreStringArrayFormState,\n  restoreStringFormState,\n  setFormControlValue,\n  setRepeatedFormControlValue,\n  setRequiredValidity,\n  type ControlWidth,\n} from '../../utils';\nimport {\n  ChoiceActionFooter,\n  ChoiceFooter,\n  ChoiceOptionRow,\n  ChoiceSearch,\n} from '../../utils/choice-list-parts';\nimport {\n  choiceBackgroundClassMap,\n  choiceListUsesIcons,\n  choiceListUsesSubtext,\n  enabledChoiceIndexes,\n  filterChoiceSections,\n  flattenChoiceSections,\n  resolveChoiceSections,\n  type ChoiceBackground,\n  type ChoiceOption,\n  type ChoiceSection,\n} from '../../utils/choice-list';\nimport { SelectController } from '../../utils/select-controller';\nimport { observeTableCaptionCompact } from '../../utils/table-caption-compact';\n\nexport type SelectOption = ChoiceOption;\nexport type SelectSection = ChoiceSection;\nexport type SelectBackground = ChoiceBackground;\nexport type SelectSize = 'lg' | 'md' | 'sm' | 'xs';\nexport type SelectWidth = ControlWidth;\nexport type SelectPopupAlign = 'start' | 'end';\nexport type SelectValue = string | string[];\nexport type SelectIndicator = 'down' | 'up-down';\n\nexport interface SelectOptionActionDetail {\n  value: string;\n  anchorId: string;\n  originalEvent: MouseEvent;\n}\n\nexport interface SelectOptionSubtextActionDetail {\n  value: string;\n  actionValue: string;\n  originalEvent: MouseEvent;\n}\n\nconst ICON_SIZE: Record<SelectSize, 'lg' | 'md' | 'sm' | 'xs'> = {\n  lg: 'lg',\n  md: 'md',\n  sm: 'sm',\n  xs: 'xs',\n};\n\nconst OPTION_ACTION_SIZE: Record<SelectSize, 'md' | 'sm' | 'xs'> = {\n  lg: 'md',\n  md: 'sm',\n  sm: 'xs',\n  xs: 'xs',\n};\n\nlet selectId = 0;\n\n@Component({\n  tag: 'ds-select',\n  styleUrl: 'Select.css',\n  scoped: true,\n  formAssociated: true,\n})\nexport class Select {\n  @Element() el!: HTMLElement;\n  @AttachInternals() internals!: ElementInternals;\n\n  /** Flat choices. Assign arrays through the JavaScript property. */\n  @Prop() options: SelectOption[] = [];\n  /** Grouped choices; takes precedence over options. Assign through JavaScript. */\n  @Prop() sections: SelectSection[] = [];\n  /** Enable independent multi-value selection while keeping the popup open. */\n  @Prop({ reflect: true }) multiple: boolean = false;\n  /** Selected scalar or array value according to `multiple`. */\n  @Prop({ mutable: true }) value: SelectValue = '';\n  /** Controlled popup visibility. */\n  @Prop({ mutable: true, reflect: true }) open: boolean = false;\n  /** Native form field name. */\n  @Prop({ reflect: true }) name: string | undefined;\n  /** Native disabled state. */\n  @Prop({ reflect: true }) disabled: boolean = false;\n  /** Require one valid selected value. */\n  @Prop({ reflect: true }) required: boolean = false;\n  /** Validation message used when required is missing. */\n  @Prop() requiredMessage: string = DEFAULT_REQUIRED_MESSAGE;\n  /** Trigger text shown when no valid value is selected. */\n  @Prop() placeholder: string = 'Select';\n  /** Optional scalar-mode trigger text that does not change the selected option label. */\n  @Prop() triggerLabel: string | undefined;\n  /** Present triggerLabel with placeholder emphasis while preserving the selected value. */\n  @Prop() triggerLabelPlaceholder: boolean = false;\n  /** Show a supplemental notification dot beside the trigger label. */\n  @Prop() dot: boolean = false;\n  /** Control density. */\n  @Prop() size: SelectSize = 'md';\n  /** Width fit — hug content (default) or fill the parent. */\n  @Prop() width: SelectWidth = 'hug';\n  /** Align the popup's choice edge to the trigger start or end edge. */\n  @Prop() popupAlign: SelectPopupAlign = 'start';\n  /** Shared inactive treatment; removes interaction and form submission. */\n  @Prop() isInactive: boolean = false;\n  /** Replace the prefix with a loader and disable option interaction. */\n  @Prop() isLoading: boolean = false;\n  /** Show the selected interaction fill when a valid value exists. */\n  @Prop() activeFill: boolean = true;\n  /**\n   * Opt into table-caption icon-only chrome below 900px. The trigger omits its\n   * visible label and chevron; keep an accessible name via aria-label.\n   */\n  @Prop({ reflect: true }) collapseLabel: boolean = false;\n  /** Show the surface-aware inset border, including focused and invalid strokes. */\n  @Prop() hasBorder: boolean = true;\n  /** Optional trigger prefix icon name. */\n  @Prop() icon: string | undefined;\n  /** Trailing choice indicator. Use up-down for compact value steppers such as page size. */\n  @Prop() indicator: SelectIndicator = 'down';\n  /** Show the clear footer action when a value exists. */\n  @Prop() allowClear: boolean = true;\n  /** Localized clear action label. */\n  @Prop() clearLabel: string = 'Clear';\n  /** Localized noun displayed after the selected count in multiple mode. */\n  @Prop() selectedLabel: string = 'selected';\n  /** Optional text action shown in the popup footer instead of the clear action. */\n  @Prop() footerActionLabel: string | undefined;\n  /** Show immediate local filtering over option labels, subtext, and section headings. */\n  @Prop() searchable: boolean = false;\n  /** Localized search-field placeholder and accessible name. */\n  @Prop() searchPlaceholder: string = 'Search';\n  /** Localized empty-filter result text. */\n  @Prop() noResultsText: string = 'No results found';\n  /** Accessible loading status label. */\n  @Prop() loadingLabel: string = 'Loading';\n  /** Actual parent surface context; omit on primary and secondary surfaces. */\n  @Prop() background: SelectBackground | undefined;\n  /** Show invalid visual state. */\n  @Prop() error: boolean = false;\n  /** Error text rendered below the trigger when error is true. */\n  @Prop() errorMessage: string | undefined;\n  /** ID applied to the internal combobox trigger for external labels. */\n  @Prop() inputId: string | undefined;\n  /** Direct accessible name when no external label is available. */\n  @Prop({ attribute: 'aria-label' }) ariaLabel: string | null = null;\n  /** IDs of elements that label the combobox. */\n  @Prop({ attribute: 'aria-labelledby' }) ariaLabelledby: string | undefined;\n  /** Additional IDs that describe the combobox. */\n  @Prop({ attribute: 'aria-describedby' }) ariaDescribedby: string | undefined;\n\n  /** Emitted after selection or clearing with the next scalar or array value. */\n  @Event() dsChange!: EventEmitter<SelectValue>;\n  /** Emitted after the footer clear action. */\n  @Event() dsClear!: EventEmitter<void>;\n  /** Emitted whenever popup visibility changes. */\n  @Event() dsOpenChange!: EventEmitter<boolean>;\n  /** Emitted when the optional popup footer action is activated. */\n  @Event() dsFooterAction!: EventEmitter<void>;\n  /** Emitted when an option's contextual ellipsis action is activated. */\n  @Event() dsOptionAction!: EventEmitter<SelectOptionActionDetail>;\n  /** Emitted when an option's supporting text action is activated. */\n  @Event() dsOptionSubtextAction!: EventEmitter<SelectOptionSubtextActionDetail>;\n\n  @State() private activeIndex = -1;\n  @State() private searchTerm = '';\n  @State() private formDisabled = false;\n  @State() private position = { x: 0, y: 0 };\n  @State() private positionReady = false;\n  @State() private focusRingVisible = false;\n  @State() private compactFooterSummary = false;\n  @State() private captionCompact = false;\n\n  private readonly generatedId = `ds-select-${++selectId}`;\n  private readonly listboxId = `${this.generatedId}-listbox`;\n  private readonly errorId = `${this.generatedId}-error`;\n  private initialValue: SelectValue = '';\n  private readonly controller = this.createController();\n  private footerContentElement?: HTMLDivElement;\n  private footerSummaryMeasureElement?: HTMLElement;\n  private footerClearElement?: HTMLButtonElement;\n  private footerResizeObserver?: ResizeObserver;\n  private observedFooterContentElement?: HTMLDivElement;\n  private footerMeasurementFrame?: number;\n  private captionCompactDisconnect: (() => void) | undefined;\n\n  private createController() {\n    // eslint-disable-next-line @typescript-eslint/no-this-alias -- adapter getters preserve reactive component ownership without inheritance.\n    const owner = this;\n    return new SelectController<SelectOption>({\n      get host() {\n        return owner.el;\n      },\n      generatedId: owner.generatedId,\n      get options() {\n        return owner.visibleOptions;\n      },\n      get searchable() {\n        return owner.searchable;\n      },\n      get isLoading() {\n        return owner.isLoading;\n      },\n      get isDisabled() {\n        return owner.isDisabled;\n      },\n      get preferredIndex() {\n        if (owner.multiple) return -1;\n        return owner.visibleOptions.findIndex(\n          option => option.value === owner.scalarValue && !option.isInactive\n        );\n      },\n      get popupAlign() {\n        return owner.popupAlign;\n      },\n      get open() {\n        return owner.open;\n      },\n      set open(value) {\n        owner.open = value;\n      },\n      get activeIndex() {\n        return owner.activeIndex;\n      },\n      set activeIndex(value) {\n        owner.activeIndex = value;\n      },\n      get searchTerm() {\n        return owner.searchTerm;\n      },\n      set searchTerm(value) {\n        owner.searchTerm = value;\n      },\n      get focusRingVisible() {\n        return owner.focusRingVisible;\n      },\n      set focusRingVisible(value) {\n        owner.focusRingVisible = value;\n      },\n      get position() {\n        return owner.position;\n      },\n      set position(value) {\n        owner.position = value;\n      },\n      get positionReady() {\n        return owner.positionReady;\n      },\n      set positionReady(value) {\n        owner.positionReady = value;\n      },\n      selectOption: option => owner.selectOption(option),\n    });\n  }\n\n  componentWillLoad() {\n    this.value = this.normalizeValueForMode(this.value);\n    this.initialValue = Array.isArray(this.value) ? [...this.value] : this.value;\n    this.syncFormValue();\n  }\n\n  componentDidLoad() {\n    this.controller.connect();\n    this.observeFooterContent();\n    this.syncCaptionCompactObserver();\n  }\n\n  componentDidRender() {\n    this.observeFooterContent();\n    this.scheduleFooterSummaryMeasurement();\n  }\n\n  disconnectedCallback() {\n    this.controller.disconnect();\n    this.footerResizeObserver?.disconnect();\n    this.observedFooterContentElement = undefined;\n    if (this.footerMeasurementFrame !== undefined) {\n      cancelAnimationFrame(this.footerMeasurementFrame);\n    }\n    this.disconnectCaptionCompactObserver();\n  }\n\n  @Watch('collapseLabel')\n  onCollapseLabelChange() {\n    this.syncCaptionCompactObserver();\n  }\n\n  @Watch('value')\n  @Watch('multiple')\n  @Watch('disabled')\n  @Watch('isInactive')\n  @Watch('required')\n  @Watch('name')\n  @Watch('options')\n  @Watch('sections')\n  syncFormValue() {\n    if (\n      (this.multiple && !Array.isArray(this.value)) ||\n      (!this.multiple && Array.isArray(this.value))\n    ) {\n      this.value = this.normalizeValueForMode(this.value);\n    }\n    const inactive = this.isDisabled;\n    if (this.multiple) {\n      const values = this.resolvedValues;\n      setRepeatedFormControlValue(this.internals, this.name, values, { inactive });\n    } else {\n      const value = this.hasSelection ? this.scalarValue : '';\n      setFormControlValue(this.internals, value, { inactive });\n    }\n    const missing = this.required && !inactive && !this.hasSelection;\n    setRequiredValidity(this.internals, missing, this.requiredMessage);\n    this.controller.optionsChanged();\n  }\n\n  @Watch('isLoading')\n  onLoadingChange() {\n    this.controller.loadingChanged();\n  }\n\n  @Watch('popupAlign')\n  onPopupAlignChange() {\n    this.controller.positionChanged();\n  }\n\n  @Watch('open')\n  onOpenChange(open: boolean) {\n    this.dsOpenChange.emit(open);\n    this.controller.openChanged(open);\n  }\n\n  @Watch('searchTerm')\n  onSearchTermChange() {\n    this.controller.searchChanged();\n  }\n\n  @Watch('activeIndex')\n  onActiveIndexChange() {\n    this.controller.activeIndexChanged();\n  }\n\n  formDisabledCallback(disabled: boolean) {\n    this.formDisabled = disabled;\n    this.syncFormValue();\n  }\n\n  formResetCallback() {\n    this.value = this.normalizeValueForMode(this.initialValue);\n    this.closePopup();\n  }\n\n  formStateRestoreCallback(state: string | File | FormData | null) {\n    if (!this.multiple) {\n      this.value = restoreStringFormState(state);\n      return;\n    }\n    this.value = restoreStringArrayFormState(state);\n  }\n\n  @Method()\n  async setFocus() {\n    this.controller.setFocus();\n  }\n\n  private get isDisabled(): boolean {\n    return this.disabled || this.isInactive || this.formDisabled;\n  }\n\n  private normalizeValueForMode(value: SelectValue): SelectValue {\n    if (this.multiple) {\n      return Array.isArray(value) ? [...value] : value ? [value] : [];\n    }\n    return Array.isArray(value) ? (value[0] ?? '') : value;\n  }\n\n  private get allSections(): SelectSection[] {\n    return resolveChoiceSections(this.options, this.sections);\n  }\n\n  private get allOptions(): SelectOption[] {\n    return flattenChoiceSections(this.allSections);\n  }\n\n  private get visibleSections(): SelectSection[] {\n    return this.searchable\n      ? filterChoiceSections(this.allSections, this.searchTerm)\n      : this.allSections;\n  }\n\n  private get visibleOptions(): SelectOption[] {\n    return flattenChoiceSections(this.visibleSections);\n  }\n\n  private get scalarValue(): string {\n    return typeof this.value === 'string' ? this.value : '';\n  }\n\n  private get resolvedValues(): string[] {\n    if (!this.multiple || !Array.isArray(this.value)) return [];\n    const valid = new Set(this.allOptions.map(option => option.value));\n    return [...new Set(this.value.filter(value => valid.has(value)))];\n  }\n\n  private get selectedOption(): SelectOption | undefined {\n    if (this.multiple) return undefined;\n    return this.allOptions.find(option => option.value === this.scalarValue);\n  }\n\n  private get hasSelection(): boolean {\n    return this.multiple ? this.resolvedValues.length > 0 : Boolean(this.selectedOption);\n  }\n\n  private get activeOptionId(): string | undefined {\n    return this.controller.activeOptionId;\n  }\n\n  private get popupRole(): 'listbox' | 'grid' {\n    return this.allOptions.some(option => Boolean(option.action)) ? 'grid' : 'listbox';\n  }\n\n  private observeFooterContent() {\n    const content =\n      this.open && this.multiple && this.hasSelection ? this.footerContentElement : undefined;\n    if (!content?.isConnected) {\n      this.footerResizeObserver?.disconnect();\n      this.observedFooterContentElement = undefined;\n      return;\n    }\n    if (this.observedFooterContentElement === content) return;\n\n    this.footerResizeObserver?.disconnect();\n    if (typeof ResizeObserver !== 'undefined') {\n      this.footerResizeObserver = new ResizeObserver(() => this.scheduleFooterSummaryMeasurement());\n      this.footerResizeObserver.observe(content);\n    }\n    this.observedFooterContentElement = content;\n  }\n\n  private scheduleFooterSummaryMeasurement() {\n    if (\n      !this.open ||\n      !this.multiple ||\n      !this.hasSelection ||\n      this.footerMeasurementFrame !== undefined\n    ) {\n      return;\n    }\n    this.footerMeasurementFrame = requestAnimationFrame(() => {\n      this.footerMeasurementFrame = undefined;\n      this.measureFooterSummary();\n    });\n  }\n\n  private measureFooterSummary() {\n    const content = this.footerContentElement;\n    const summary = this.footerSummaryMeasureElement;\n    const clear = this.footerClearElement;\n    if (!content?.isConnected || !summary?.isConnected || !clear?.isConnected) return;\n\n    const styles = getComputedStyle(content);\n    const innerWidth =\n      content.clientWidth -\n      Number.parseFloat(styles.paddingInlineStart || '0') -\n      Number.parseFloat(styles.paddingInlineEnd || '0');\n    const requiredWidth =\n      summary.getBoundingClientRect().width +\n      clear.getBoundingClientRect().width +\n      Number.parseFloat(styles.columnGap || '0');\n    const nextCompact = requiredWidth > innerWidth + 0.5;\n    if (nextCompact !== this.compactFooterSummary) {\n      this.compactFooterSummary = nextCompact;\n    }\n  }\n\n  private closePopup(restoreFocus = false) {\n    this.controller.closePopup(restoreFocus);\n  }\n\n  private openPopup(focusVisible: boolean, edge?: 'first' | 'last') {\n    this.controller.openPopup(focusVisible, edge);\n  }\n\n  private selectOption(option: SelectOption) {\n    if (option.isInactive || this.isLoading) return;\n    if (this.multiple) {\n      const current = this.resolvedValues;\n      const next = current.includes(option.value)\n        ? current.filter(value => value !== option.value)\n        : [...current, option.value];\n      this.value = next;\n      this.dsChange.emit([...next]);\n      return;\n    }\n    this.value = option.value;\n    this.dsChange.emit(option.value);\n    this.controller.closePopup(true);\n  }\n\n  private clearSelection = (event: Event) => {\n    event.preventDefault();\n    event.stopPropagation();\n    this.value = this.multiple ? [] : '';\n    this.dsChange.emit(this.multiple ? [] : '');\n    this.dsClear.emit();\n    if (!this.multiple) {\n      const enabled = enabledChoiceIndexes(this.visibleOptions);\n      this.activeIndex = enabled[0] ?? -1;\n    }\n    this.controller.focusSearchOrTrigger();\n  };\n\n  private activateFooterAction = (event: MouseEvent) => {\n    event.preventDefault();\n    event.stopPropagation();\n    this.dsFooterAction.emit();\n    this.closePopup();\n  };\n\n  private readonly handleListKeyDown = this.controller.handleListKeyDown;\n  private readonly handleTriggerKeyDown = this.controller.handleTriggerKeyDown;\n\n  private renderOption(\n    option: SelectOption,\n    index: number,\n    usesIcons: boolean,\n    usesSubtext: boolean\n  ) {\n    const selected = this.multiple\n      ? this.resolvedValues.includes(option.value)\n      : option.value === this.scalarValue;\n    const active = index === this.activeIndex;\n    const actionId = `${this.generatedId}-option-action-${index}`;\n    return (\n      <ChoiceOptionRow\n        size={this.size}\n        id={`${this.generatedId}-option-${index}`}\n        option={option}\n        selected={selected}\n        active={active}\n        focusRingVisible={this.focusRingVisible}\n        usesSubtext={usesSubtext}\n        actionOpen={option.action?.expanded}\n        popupRole={this.popupRole}\n        leading={\n          this.multiple ? (\n            <span\n              class=\"ds-choice-item__icon ds-control-icon-box ds-interaction-fill__content\"\n              aria-hidden=\"true\"\n            >\n              <ds-checkbox\n                class=\"select-option__checkbox\"\n                label=\"\"\n                size={this.size}\n                checked={selected}\n                presentation\n              />\n            </span>\n          ) : usesIcons && option.icon ? (\n            <span\n              class=\"ds-choice-item__icon ds-control-icon-box ds-interaction-fill__content\"\n              aria-hidden=\"true\"\n            >\n              <ds-icon name={option.icon} size={this.size} color=\"inherit\" />\n            </span>\n          ) : undefined\n        }\n        supporting={\n          option.subtextActions?.length ? (\n            <span class=\"ds-choice-item__subtext ds-control-label-box select-option__subtext-actions\">\n              {option.subtextActions.map((action, actionIndex) => [\n                actionIndex > 0 ? (\n                  <ds-text\n                    class=\"select-option__subtext-action-separator\"\n                    as=\"span\"\n                    variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                    color=\"inherit\"\n                    aria-hidden=\"true\"\n                  >\n                    ·\n                  </ds-text>\n                ) : null,\n                <button\n                  type=\"button\"\n                  class={{\n                    'select-option__subtext-action': true,\n                    'select-option__subtext-action--negative': action.tone === 'negative',\n                    'ds-text-action': true,\n                    'ds-focus-ring': true,\n                  }}\n                  onKeyDown={(event: KeyboardEvent) => event.stopPropagation()}\n                  onClick={(event: MouseEvent) => {\n                    event.preventDefault();\n                    event.stopPropagation();\n                    this.dsOptionSubtextAction.emit({\n                      value: option.value,\n                      actionValue: action.value,\n                      originalEvent: event,\n                    });\n                  }}\n                >\n                  <ds-text\n                    as=\"span\"\n                    variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                    color=\"inherit\"\n                  >\n                    {action.label}\n                  </ds-text>\n                </button>,\n              ])}\n            </span>\n          ) : undefined\n        }\n        action={\n          option.action ? (\n            <ds-tooltip label={option.action.label} side=\"left\" size=\"sm\">\n              <ds-button-unfilled\n                id={actionId}\n                variant=\"icon\"\n                size={OPTION_ACTION_SIZE[this.size]}\n                icon=\"Ellipses\"\n                rounded\n                hasBorder={false}\n                activeFill={false}\n                ariaLabel={option.action.label}\n                haspopup=\"menu\"\n                controls={option.action.controls}\n                expanded={option.action.expanded}\n                onKeyDown={event => {\n                  event.stopPropagation();\n                  if (event.key === 'Escape' || event.key === 'ArrowLeft') {\n                    event.preventDefault();\n                    this.controller.focusSearchOrTrigger();\n                  }\n                }}\n                onDsClick={(event: CustomEvent<MouseEvent>) => {\n                  event.stopPropagation();\n                  this.dsOptionAction.emit({\n                    value: option.value,\n                    anchorId: actionId,\n                    originalEvent: event.detail,\n                  });\n                }}\n              />\n            </ds-tooltip>\n          ) : undefined\n        }\n        onHover={() => {\n          this.focusRingVisible = false;\n          this.activeIndex = index;\n        }}\n        onSelect={() => this.selectOption(option)}\n      />\n    );\n  }\n\n  private get captionIconOnly(): boolean {\n    return this.collapseLabel && this.captionCompact && Boolean(this.icon || this.isLoading);\n  }\n\n  private syncCaptionCompactObserver(): void {\n    this.disconnectCaptionCompactObserver();\n    if (!this.collapseLabel) {\n      if (this.captionCompact) this.captionCompact = false;\n      return;\n    }\n    this.captionCompactDisconnect = observeTableCaptionCompact(this.el, compact => {\n      if (this.captionCompact !== compact) this.captionCompact = compact;\n    });\n  }\n\n  private disconnectCaptionCompactObserver(): void {\n    this.captionCompactDisconnect?.();\n    this.captionCompactDisconnect = undefined;\n  }\n\n  render() {\n    const inactive = this.isDisabled;\n    const showPlaceholder = !this.hasSelection;\n    const count = this.resolvedValues.length;\n    const label = this.multiple\n      ? `${this.placeholder}${count > 0 ? ` · ${count}` : ''}`\n      : showPlaceholder\n        ? this.placeholder\n        : (this.triggerLabel ?? this.selectedOption?.label);\n    const textVariant = CONTROL_TEXT_VARIANT[this.size];\n    const iconSize = ICON_SIZE[this.size];\n    const usesOptionIcons = !this.multiple && choiceListUsesIcons(this.allOptions);\n    const usesOptionSubtext = choiceListUsesSubtext(this.allOptions);\n    const showError = this.error && Boolean(this.errorMessage);\n    const describedBy =\n      [this.ariaDescribedby, showError ? this.errorId : undefined].filter(Boolean).join(' ') ||\n      undefined;\n    const popupStyle = {\n      position: 'fixed',\n      left: '0',\n      top: '0',\n      transform: `translate(${Math.round(this.position.x)}px, ${Math.round(this.position.y)}px)`,\n      zIndex: 'var(--dimension-z-index-floating)',\n      visibility: this.positionReady ? 'visible' : 'hidden',\n    };\n    let flatIndex = 0;\n\n    return (\n      <Host\n        class={{\n          'select-host': true,\n          'ds-select-trigger-host': true,\n          'select-host--multiple': this.multiple,\n          'ds-field-stack': true,\n          'ds-control-inactive': inactive,\n          [`ds-control--${this.size}`]: true,\n          'ds-table-caption-control': this.collapseLabel,\n          'ds-table-caption-control--compact': this.captionIconOnly,\n          ...controlWidthClass(this.width),\n          [`select-host--background-${this.background}`]: !!this.background,\n          [`ds-select-trigger-host--background-${this.background}`]: !!this.background,\n        }}\n      >\n        <button\n          ref={element => {\n            this.controller.setTriggerElement((element as HTMLButtonElement) ?? null);\n          }}\n          id={this.inputId ?? this.generatedId}\n          type=\"button\"\n          class={{\n            trigger: true,\n            'ds-control-frame': true,\n            'ds-focus-ring-inset': true,\n            'ds-interaction-fill': true,\n            'ds-interaction-fill--selected': !inactive && this.activeFill && this.hasSelection,\n            'trigger--expanded': !inactive && this.open,\n            'trigger--bordered': this.hasBorder,\n            'trigger--placeholder': showPlaceholder && !this.multiple,\n            'trigger--has-value': this.hasSelection,\n            'trigger--label-placeholder':\n              !this.multiple && Boolean(this.triggerLabel) && this.triggerLabelPlaceholder,\n            'wrapper--error': this.hasBorder && this.error,\n            [`ds-control--${this.size}`]: true,\n            ...choiceBackgroundClassMap(this.background),\n          }}\n          disabled={inactive}\n          role=\"combobox\"\n          aria-haspopup={this.popupRole}\n          aria-expanded={String(this.open)}\n          aria-controls={this.open ? this.listboxId : undefined}\n          aria-activedescendant={this.open && !this.searchable ? this.activeOptionId : undefined}\n          aria-label={this.ariaLabel ?? (this.captionIconOnly ? label : undefined)}\n          aria-labelledby={this.ariaLabelledby}\n          aria-describedby={describedBy}\n          aria-invalid={this.error ? 'true' : undefined}\n          aria-required={this.required || undefined}\n          aria-busy={this.isLoading ? 'true' : undefined}\n          onClick={() => (this.open ? this.closePopup() : this.openPopup(false))}\n          onKeyDown={event => {\n            const action = this.visibleOptions[this.activeIndex]?.action;\n            if (\n              this.open &&\n              action &&\n              (event.key === 'ArrowRight' || (event.key === 'F10' && event.shiftKey))\n            ) {\n              event.preventDefault();\n              document\n                .getElementById(`${this.generatedId}-option-action-${this.activeIndex}`)\n                ?.querySelector<HTMLElement>('button')\n                ?.focus();\n              return;\n            }\n            this.handleTriggerKeyDown(event);\n          }}\n        >\n          {(this.icon || this.isLoading) && (\n            <span\n              class=\"trigger__prefix ds-control-icon-box ds-interaction-fill__content\"\n              aria-hidden=\"true\"\n            >\n              {this.isLoading ? (\n                <ds-loader size={iconSize} color=\"inherit\" />\n              ) : (\n                <ds-icon name={this.icon} size={iconSize} color=\"inherit\" />\n              )}\n            </span>\n          )}\n          {this.captionIconOnly ? null : (\n            <span\n              class={{\n                'trigger__label-box': true,\n                'ds-interaction-fill__content': true,\n              }}\n            >\n              <span\n                class={{\n                  'trigger__label-content': true,\n                  'ds-control-label-box': true,\n                  'ds-control-label-dot': this.dot,\n                  'trigger__label-content--dot': this.dot,\n                }}\n              >\n                <ds-text\n                  class=\"trigger__label\"\n                  as=\"span\"\n                  variant={textVariant}\n                  color=\"inherit\"\n                  lineTruncation={1}\n                >\n                  {label}\n                </ds-text>\n                {this.dot && (\n                  <ds-badge\n                    class=\"trigger__dot ds-control-label-dot__badge\"\n                    variant=\"dot\"\n                    hasRing={false}\n                    label=\"\"\n                    aria-hidden=\"true\"\n                  />\n                )}\n              </span>\n            </span>\n          )}\n          {this.captionIconOnly ? null : (\n            <span\n              class=\"trigger__chevron ds-control-icon-box ds-interaction-fill__content\"\n              aria-hidden=\"true\"\n            >\n              <ds-icon\n                name={this.indicator === 'up-down' ? 'ChevronUpDown' : 'ChevronDown'}\n                size={iconSize}\n                color=\"inherit\"\n              />\n            </span>\n          )}\n        </button>\n\n        {this.open && (\n          <div\n            popover=\"manual\"\n            ref={element => {\n              this.controller.setPopupElement((element as HTMLDivElement) ?? null);\n            }}\n            class=\"select-popup ds-choice-popup\"\n            style={popupStyle}\n          >\n            {this.searchable && (\n              <ChoiceSearch\n                size={this.size}\n                value={this.searchTerm}\n                placeholder={this.searchPlaceholder}\n                controls={this.listboxId}\n                activeDescendant={this.activeOptionId}\n                inputRef={this.controller.setSearchElement}\n                clearLabel={this.clearLabel}\n                onValueChange={value => {\n                  this.searchTerm = value;\n                }}\n                onKeyDown={event => this.handleListKeyDown(event)}\n              />\n            )}\n            <div\n              id={this.listboxId}\n              class=\"ds-choice-list\"\n              role={this.popupRole}\n              aria-multiselectable={this.multiple ? 'true' : undefined}\n              aria-label={this.ariaLabel ?? this.placeholder}\n              aria-busy={this.isLoading ? 'true' : undefined}\n            >\n              {this.isLoading ? (\n                <div\n                  class=\"ds-choice-loading ds-empty-region\"\n                  role={this.popupRole === 'grid' ? 'row' : 'option'}\n                  aria-selected=\"false\"\n                  aria-disabled=\"true\"\n                  aria-label={this.loadingLabel}\n                  aria-live=\"polite\"\n                >\n                  {this.popupRole === 'grid' ? (\n                    <span role=\"gridcell\">\n                      <ds-loader size={this.size} color=\"inherit\" />\n                    </span>\n                  ) : (\n                    <ds-loader size={this.size} color=\"inherit\" />\n                  )}\n                </div>\n              ) : this.visibleOptions.length === 0 ? (\n                <div\n                  class=\"ds-choice-empty ds-empty-region\"\n                  role={this.popupRole === 'grid' ? 'row' : 'option'}\n                  aria-selected=\"false\"\n                  aria-disabled=\"true\"\n                  aria-label={this.noResultsText}\n                  aria-live=\"polite\"\n                >\n                  {this.popupRole === 'grid' ? (\n                    <span role=\"gridcell\">\n                      <ds-empty-state body={this.noResultsText} />\n                    </span>\n                  ) : (\n                    <ds-empty-state body={this.noResultsText} />\n                  )}\n                </div>\n              ) : (\n                this.visibleSections.map((section, sectionIndex) => (\n                  <div\n                    class={{\n                      'ds-choice-section': true,\n                      'ds-chrome-column': true,\n                      'ds-chrome-space--sm': true,\n                      'ds-choice-section--divided': !!section.divider,\n                      'ds-choice-section--headed-after-first':\n                        sectionIndex > 0 && Boolean(section.header),\n                    }}\n                    role={\n                      this.popupRole === 'grid' ? 'rowgroup' : section.header ? 'group' : undefined\n                    }\n                    aria-label={section.header}\n                  >\n                    {section.header && this.popupRole === 'grid' ? (\n                      <ds-text\n                        class={`ds-choice-section__header ds-control-section-heading ds-control--${this.size}`}\n                        as=\"span\"\n                        variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                        emphasis\n                        color=\"primary\"\n                        role=\"row\"\n                      >\n                        <span class=\"ds-choice-section__header-label\" role=\"gridcell\">\n                          {section.header}\n                        </span>\n                      </ds-text>\n                    ) : section.header ? (\n                      <ds-text\n                        class={`ds-choice-section__header ds-control-section-heading ds-control--${this.size}`}\n                        as=\"span\"\n                        variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                        emphasis\n                        color=\"primary\"\n                        aria-hidden=\"true\"\n                      >\n                        <span class=\"ds-choice-section__header-label\">{section.header}</span>\n                      </ds-text>\n                    ) : null}\n                    {section.options.map(option =>\n                      this.renderOption(option, flatIndex++, usesOptionIcons, usesOptionSubtext)\n                    )}\n                  </div>\n                ))\n              )}\n            </div>\n            {this.footerActionLabel && !this.isLoading ? (\n              <ChoiceActionFooter\n                size={this.size}\n                label={this.footerActionLabel}\n                onAction={this.activateFooterAction}\n              />\n            ) : this.allowClear && this.hasSelection && !this.isLoading ? (\n              <ChoiceFooter\n                size={this.size}\n                summary={this.multiple ? `${count} ${this.selectedLabel}` : undefined}\n                compactSummary={this.multiple ? String(count) : undefined}\n                useCompactSummary={this.compactFooterSummary}\n                contentRef={element => {\n                  this.footerContentElement = element ?? undefined;\n                }}\n                summaryMeasureRef={element => {\n                  this.footerSummaryMeasureElement = element ?? undefined;\n                }}\n                clearRef={element => {\n                  this.footerClearElement = element ?? undefined;\n                }}\n                clearLabel={this.clearLabel}\n                onClear={this.clearSelection}\n              />\n            ) : null}\n          </div>\n        )}\n\n        {showError && (\n          <ds-text\n            class=\"error-text\"\n            as=\"div\"\n            variant=\"text-body-small\"\n            color=\"negative\"\n            textId={this.errorId}\n            role=\"alert\"\n          >\n            {this.errorMessage}\n          </ds-text>\n        )}\n      </Host>\n    );\n  }\n}\n",
+      "content": "import {\n  AttachInternals,\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Method,\n  Prop,\n  State,\n  Watch,\n} from '@stencil/core';\nimport {\n  controlWidthClass,\n  CONTROL_SUPPORTING_TEXT_VARIANT,\n  CONTROL_TEXT_VARIANT,\n  DEFAULT_REQUIRED_MESSAGE,\n  restoreStringArrayFormState,\n  restoreStringFormState,\n  setFormControlValue,\n  setRepeatedFormControlValue,\n  setRequiredValidity,\n  type ControlWidth,\n} from '../../utils';\nimport {\n  ChoiceActionFooter,\n  ChoiceFooter,\n  ChoiceOptionRow,\n  ChoiceSearch,\n} from '../../utils/choice-list-parts';\nimport {\n  choiceBackgroundClassMap,\n  choiceListUsesIcons,\n  choiceListUsesSubtext,\n  enabledChoiceIndexes,\n  filterChoiceSections,\n  flattenChoiceSections,\n  resolveChoiceSections,\n  type ChoiceBackground,\n  type ChoiceOption,\n  type ChoiceSection,\n} from '../../utils/choice-list';\nimport { SelectController } from '../../utils/select-controller';\nimport { observeTableCaptionCompact } from '../../utils/table-caption-compact';\n\nexport type SelectOption = ChoiceOption;\nexport type SelectSection = ChoiceSection;\nexport type SelectBackground = ChoiceBackground;\nexport type SelectSize = 'lg' | 'md' | 'sm' | 'xs';\nexport type SelectWidth = ControlWidth;\nexport type SelectPopupAlign = 'start' | 'end';\nexport type SelectValue = string | string[];\nexport type SelectIndicator = 'down' | 'up-down';\n\nexport interface SelectOptionActionDetail {\n  value: string;\n  anchorId: string;\n  originalEvent: MouseEvent;\n}\n\nexport interface SelectOptionSubtextActionDetail {\n  value: string;\n  actionValue: string;\n  originalEvent: MouseEvent;\n}\n\nconst ICON_SIZE: Record<SelectSize, 'lg' | 'md' | 'sm' | 'xs'> = {\n  lg: 'lg',\n  md: 'md',\n  sm: 'sm',\n  xs: 'xs',\n};\n\nconst OPTION_ACTION_SIZE: Record<SelectSize, 'md' | 'sm' | 'xs'> = {\n  lg: 'md',\n  md: 'sm',\n  sm: 'xs',\n  xs: 'xs',\n};\n\nlet selectId = 0;\n\n@Component({\n  tag: 'ds-select',\n  styleUrl: 'Select.css',\n  scoped: true,\n  formAssociated: true,\n})\nexport class Select {\n  @Element() el!: HTMLElement;\n  @AttachInternals() internals!: ElementInternals;\n\n  /** Flat choices. Assign arrays through the JavaScript property. */\n  @Prop() options: SelectOption[] = [];\n  /** Grouped choices; takes precedence over options. Assign through JavaScript. */\n  @Prop() sections: SelectSection[] = [];\n  /** Enable independent multi-value selection while keeping the popup open. */\n  @Prop({ reflect: true }) multiple: boolean = false;\n  /** Selected scalar or array value according to `multiple`. */\n  @Prop({ mutable: true }) value: SelectValue = '';\n  /** Controlled popup visibility. */\n  @Prop({ mutable: true, reflect: true }) open: boolean = false;\n  /** Native form field name. */\n  @Prop({ reflect: true }) name: string | undefined;\n  /** Native disabled state. */\n  @Prop({ reflect: true }) disabled: boolean = false;\n  /** Require one valid selected value. */\n  @Prop({ reflect: true }) required: boolean = false;\n  /** Validation message used when required is missing. */\n  @Prop() requiredMessage: string = DEFAULT_REQUIRED_MESSAGE;\n  /** Trigger text shown when no valid value is selected. */\n  @Prop() placeholder: string = 'Select';\n  /** Optional scalar-mode trigger text that does not change the selected option label. */\n  @Prop() triggerLabel: string | undefined;\n  /** Present triggerLabel with placeholder emphasis while preserving the selected value. */\n  @Prop() triggerLabelPlaceholder: boolean = false;\n  /** Show a supplemental notification dot beside the trigger label. */\n  @Prop() dot: boolean = false;\n  /** Control density. */\n  @Prop() size: SelectSize = 'md';\n  /** Width fit — hug content (default) or fill the parent. */\n  @Prop() width: SelectWidth = 'hug';\n  /** Align the popup's choice edge to the trigger start or end edge. */\n  @Prop() popupAlign: SelectPopupAlign = 'start';\n  /** Shared inactive treatment; removes interaction and form submission. */\n  @Prop() isInactive: boolean = false;\n  /** Replace the prefix with a loader and disable option interaction. */\n  @Prop() isLoading: boolean = false;\n  /** Show the selected interaction fill when a valid value exists. */\n  @Prop() activeFill: boolean = true;\n  /**\n   * Opt into table-caption icon-only chrome below 900px. The trigger omits its\n   * visible label and chevron; keep an accessible name via aria-label.\n   */\n  @Prop({ reflect: true }) collapseLabel: boolean = false;\n  /** Show the surface-aware inset border, including focused and invalid strokes. */\n  @Prop() hasBorder: boolean = true;\n  /** Optional trigger prefix icon name. */\n  @Prop() icon: string | undefined;\n  /** Trailing choice indicator. Use up-down for compact value steppers such as page size. */\n  @Prop() indicator: SelectIndicator = 'down';\n  /** Show the clear footer action when a value exists. */\n  @Prop() allowClear: boolean = true;\n  /** Localized clear action label. */\n  @Prop() clearLabel: string = 'Clear';\n  /** Localized noun displayed after the selected count in multiple mode. */\n  @Prop() selectedLabel: string = 'selected';\n  /** Optional text action shown in the popup footer instead of the clear action. */\n  @Prop() footerActionLabel: string | undefined;\n  /** Show immediate local filtering over option labels, subtext, and section headings. */\n  @Prop() searchable: boolean = false;\n  /** Localized search-field placeholder and accessible name. */\n  @Prop() searchPlaceholder: string = 'Search';\n  /** Localized empty-filter result text. */\n  @Prop() noResultsText: string = 'No results found';\n  /** Accessible loading status label. */\n  @Prop() loadingLabel: string = 'Loading';\n  /** Actual parent surface context; omit on primary and secondary surfaces. */\n  @Prop() background: SelectBackground | undefined;\n  /** Show invalid visual state. */\n  @Prop() error: boolean = false;\n  /** Error text rendered below the trigger when error is true. */\n  @Prop() errorMessage: string | undefined;\n  /** ID applied to the internal combobox trigger for external labels. */\n  @Prop() inputId: string | undefined;\n  /** Direct accessible name when no external label is available. */\n  @Prop({ attribute: 'aria-label' }) ariaLabel: string | null = null;\n  /** IDs of elements that label the combobox. */\n  @Prop({ attribute: 'aria-labelledby' }) ariaLabelledby: string | undefined;\n  /** Additional IDs that describe the combobox. */\n  @Prop({ attribute: 'aria-describedby' }) ariaDescribedby: string | undefined;\n\n  /** Emitted after selection or clearing with the next scalar or array value. */\n  @Event() dsChange!: EventEmitter<SelectValue>;\n  /** Emitted after the footer clear action. */\n  @Event() dsClear!: EventEmitter<void>;\n  /** Emitted whenever popup visibility changes. */\n  @Event() dsOpenChange!: EventEmitter<boolean>;\n  /** Emitted when the optional popup footer action is activated. */\n  @Event() dsFooterAction!: EventEmitter<void>;\n  /** Emitted when an option's contextual ellipsis action is activated. */\n  @Event() dsOptionAction!: EventEmitter<SelectOptionActionDetail>;\n  /** Emitted when an option's supporting text action is activated. */\n  @Event() dsOptionSubtextAction!: EventEmitter<SelectOptionSubtextActionDetail>;\n\n  @State() private activeIndex = -1;\n  @State() private searchTerm = '';\n  @State() private formDisabled = false;\n  @State() private position = { x: 0, y: 0 };\n  @State() private positionReady = false;\n  @State() private focusRingVisible = false;\n  @State() private compactFooterSummary = false;\n  @State() private captionCompact = false;\n\n  private readonly generatedId = `ds-select-${++selectId}`;\n  private readonly listboxId = `${this.generatedId}-listbox`;\n  private readonly errorId = `${this.generatedId}-error`;\n  private initialValue: SelectValue = '';\n  private readonly controller = this.createController();\n  private footerContentElement?: HTMLDivElement;\n  private footerSummaryMeasureElement?: HTMLElement;\n  private footerClearElement?: HTMLButtonElement;\n  private footerResizeObserver?: ResizeObserver;\n  private observedFooterContentElement?: HTMLDivElement;\n  private footerMeasurementFrame?: number;\n  private captionCompactDisconnect: (() => void) | undefined;\n  private hasLoaded = false;\n\n  private createController() {\n    // eslint-disable-next-line @typescript-eslint/no-this-alias -- adapter getters preserve reactive component ownership without inheritance.\n    const owner = this;\n    return new SelectController<SelectOption>({\n      get host() {\n        return owner.el;\n      },\n      generatedId: owner.generatedId,\n      get options() {\n        return owner.visibleOptions;\n      },\n      get searchable() {\n        return owner.searchable;\n      },\n      get isLoading() {\n        return owner.isLoading;\n      },\n      get isDisabled() {\n        return owner.isDisabled;\n      },\n      get preferredIndex() {\n        if (owner.multiple) return -1;\n        return owner.visibleOptions.findIndex(\n          option => option.value === owner.scalarValue && !option.isInactive\n        );\n      },\n      get popupAlign() {\n        return owner.popupAlign;\n      },\n      get open() {\n        return owner.open;\n      },\n      set open(value) {\n        owner.open = value;\n      },\n      get activeIndex() {\n        return owner.activeIndex;\n      },\n      set activeIndex(value) {\n        owner.activeIndex = value;\n      },\n      get searchTerm() {\n        return owner.searchTerm;\n      },\n      set searchTerm(value) {\n        owner.searchTerm = value;\n      },\n      get focusRingVisible() {\n        return owner.focusRingVisible;\n      },\n      set focusRingVisible(value) {\n        owner.focusRingVisible = value;\n      },\n      get position() {\n        return owner.position;\n      },\n      set position(value) {\n        owner.position = value;\n      },\n      get positionReady() {\n        return owner.positionReady;\n      },\n      set positionReady(value) {\n        owner.positionReady = value;\n      },\n      selectOption: option => owner.selectOption(option),\n    });\n  }\n\n  componentWillLoad() {\n    this.value = this.normalizeValueForMode(this.value);\n    this.initialValue = Array.isArray(this.value) ? [...this.value] : this.value;\n    this.syncFormValue();\n  }\n\n  componentDidLoad() {\n    this.hasLoaded = true;\n    this.controller.connect();\n    this.observeFooterContent();\n    this.syncCaptionCompactObserver();\n  }\n\n  connectedCallback() {\n    if (!this.hasLoaded) return;\n    this.controller.connect();\n    this.observeFooterContent();\n    this.syncCaptionCompactObserver();\n  }\n\n  componentDidRender() {\n    this.observeFooterContent();\n    this.scheduleFooterSummaryMeasurement();\n  }\n\n  disconnectedCallback() {\n    this.controller.disconnect();\n    this.footerResizeObserver?.disconnect();\n    this.observedFooterContentElement = undefined;\n    if (this.footerMeasurementFrame !== undefined) {\n      cancelAnimationFrame(this.footerMeasurementFrame);\n      this.footerMeasurementFrame = undefined;\n    }\n    this.disconnectCaptionCompactObserver();\n  }\n\n  @Watch('collapseLabel')\n  onCollapseLabelChange() {\n    this.syncCaptionCompactObserver();\n  }\n\n  @Watch('value')\n  @Watch('multiple')\n  @Watch('disabled')\n  @Watch('isInactive')\n  @Watch('required')\n  @Watch('name')\n  @Watch('options')\n  @Watch('sections')\n  syncFormValue() {\n    if (\n      (this.multiple && !Array.isArray(this.value)) ||\n      (!this.multiple && Array.isArray(this.value))\n    ) {\n      this.value = this.normalizeValueForMode(this.value);\n    }\n    const inactive = this.isDisabled;\n    if (this.multiple) {\n      const values = this.resolvedValues;\n      setRepeatedFormControlValue(this.internals, this.name, values, { inactive });\n    } else {\n      const value = this.hasSelection ? this.scalarValue : '';\n      setFormControlValue(this.internals, value, { inactive });\n    }\n    const missing = this.required && !inactive && !this.hasSelection;\n    setRequiredValidity(this.internals, missing, this.requiredMessage);\n    this.controller.optionsChanged();\n  }\n\n  @Watch('isLoading')\n  onLoadingChange() {\n    this.controller.loadingChanged();\n  }\n\n  @Watch('popupAlign')\n  onPopupAlignChange() {\n    this.controller.positionChanged();\n  }\n\n  @Watch('open')\n  onOpenChange(open: boolean) {\n    this.dsOpenChange.emit(open);\n    this.controller.openChanged(open);\n  }\n\n  @Watch('searchTerm')\n  onSearchTermChange() {\n    this.controller.searchChanged();\n  }\n\n  @Watch('activeIndex')\n  onActiveIndexChange() {\n    this.controller.activeIndexChanged();\n  }\n\n  formDisabledCallback(disabled: boolean) {\n    this.formDisabled = disabled;\n    this.syncFormValue();\n  }\n\n  formResetCallback() {\n    this.value = this.normalizeValueForMode(this.initialValue);\n    this.closePopup();\n  }\n\n  formStateRestoreCallback(state: string | File | FormData | null) {\n    if (!this.multiple) {\n      this.value = restoreStringFormState(state);\n      return;\n    }\n    this.value = restoreStringArrayFormState(state);\n  }\n\n  @Method()\n  async setFocus() {\n    this.controller.setFocus();\n  }\n\n  private get isDisabled(): boolean {\n    return this.disabled || this.isInactive || this.formDisabled;\n  }\n\n  private normalizeValueForMode(value: SelectValue): SelectValue {\n    if (this.multiple) {\n      return Array.isArray(value) ? [...value] : value ? [value] : [];\n    }\n    return Array.isArray(value) ? (value[0] ?? '') : value;\n  }\n\n  private get allSections(): SelectSection[] {\n    return resolveChoiceSections(this.options, this.sections);\n  }\n\n  private get allOptions(): SelectOption[] {\n    return flattenChoiceSections(this.allSections);\n  }\n\n  private get visibleSections(): SelectSection[] {\n    return this.searchable\n      ? filterChoiceSections(this.allSections, this.searchTerm)\n      : this.allSections;\n  }\n\n  private get visibleOptions(): SelectOption[] {\n    return flattenChoiceSections(this.visibleSections);\n  }\n\n  private get scalarValue(): string {\n    return typeof this.value === 'string' ? this.value : '';\n  }\n\n  private get resolvedValues(): string[] {\n    if (!this.multiple || !Array.isArray(this.value)) return [];\n    const valid = new Set(this.allOptions.map(option => option.value));\n    return [...new Set(this.value.filter(value => valid.has(value)))];\n  }\n\n  private get selectedOption(): SelectOption | undefined {\n    if (this.multiple) return undefined;\n    return this.allOptions.find(option => option.value === this.scalarValue);\n  }\n\n  private get hasSelection(): boolean {\n    return this.multiple ? this.resolvedValues.length > 0 : Boolean(this.selectedOption);\n  }\n\n  private get activeOptionId(): string | undefined {\n    return this.controller.activeOptionId;\n  }\n\n  private get popupRole(): 'listbox' | 'grid' {\n    return this.allOptions.some(option => Boolean(option.action)) ? 'grid' : 'listbox';\n  }\n\n  private observeFooterContent() {\n    const content =\n      this.open && this.multiple && this.hasSelection ? this.footerContentElement : undefined;\n    if (!content?.isConnected) {\n      this.footerResizeObserver?.disconnect();\n      this.observedFooterContentElement = undefined;\n      return;\n    }\n    if (this.observedFooterContentElement === content) return;\n\n    this.footerResizeObserver?.disconnect();\n    if (typeof ResizeObserver !== 'undefined') {\n      this.footerResizeObserver = new ResizeObserver(() => this.scheduleFooterSummaryMeasurement());\n      this.footerResizeObserver.observe(content);\n    }\n    this.observedFooterContentElement = content;\n  }\n\n  private scheduleFooterSummaryMeasurement() {\n    if (\n      !this.open ||\n      !this.multiple ||\n      !this.hasSelection ||\n      this.footerMeasurementFrame !== undefined\n    ) {\n      return;\n    }\n    this.footerMeasurementFrame = requestAnimationFrame(() => {\n      this.footerMeasurementFrame = undefined;\n      this.measureFooterSummary();\n    });\n  }\n\n  private measureFooterSummary() {\n    const content = this.footerContentElement;\n    const summary = this.footerSummaryMeasureElement;\n    const clear = this.footerClearElement;\n    if (!content?.isConnected || !summary?.isConnected || !clear?.isConnected) return;\n\n    const styles = getComputedStyle(content);\n    const innerWidth =\n      content.clientWidth -\n      Number.parseFloat(styles.paddingInlineStart || '0') -\n      Number.parseFloat(styles.paddingInlineEnd || '0');\n    const requiredWidth =\n      summary.getBoundingClientRect().width +\n      clear.getBoundingClientRect().width +\n      Number.parseFloat(styles.columnGap || '0');\n    const nextCompact = requiredWidth > innerWidth + 0.5;\n    if (nextCompact !== this.compactFooterSummary) {\n      this.compactFooterSummary = nextCompact;\n    }\n  }\n\n  private closePopup(restoreFocus = false) {\n    this.controller.closePopup(restoreFocus);\n  }\n\n  private openPopup(focusVisible: boolean, edge?: 'first' | 'last') {\n    this.controller.openPopup(focusVisible, edge);\n  }\n\n  private selectOption(option: SelectOption) {\n    if (option.isInactive || this.isLoading) return;\n    if (this.multiple) {\n      const current = this.resolvedValues;\n      const next = current.includes(option.value)\n        ? current.filter(value => value !== option.value)\n        : [...current, option.value];\n      this.value = next;\n      this.dsChange.emit([...next]);\n      return;\n    }\n    this.value = option.value;\n    this.dsChange.emit(option.value);\n    this.controller.closePopup(true);\n  }\n\n  private clearSelection = (event: Event) => {\n    event.preventDefault();\n    event.stopPropagation();\n    this.value = this.multiple ? [] : '';\n    this.dsChange.emit(this.multiple ? [] : '');\n    this.dsClear.emit();\n    if (!this.multiple) {\n      const enabled = enabledChoiceIndexes(this.visibleOptions);\n      this.activeIndex = enabled[0] ?? -1;\n    }\n    this.controller.focusSearchOrTrigger();\n  };\n\n  private activateFooterAction = (event: MouseEvent) => {\n    event.preventDefault();\n    event.stopPropagation();\n    this.dsFooterAction.emit();\n    this.closePopup();\n  };\n\n  private readonly handleListKeyDown = this.controller.handleListKeyDown;\n  private readonly handleTriggerKeyDown = this.controller.handleTriggerKeyDown;\n\n  private renderOption(\n    option: SelectOption,\n    index: number,\n    usesIcons: boolean,\n    usesSubtext: boolean\n  ) {\n    const selected = this.multiple\n      ? this.resolvedValues.includes(option.value)\n      : option.value === this.scalarValue;\n    const active = index === this.activeIndex;\n    const actionId = `${this.generatedId}-option-action-${index}`;\n    return (\n      <ChoiceOptionRow\n        size={this.size}\n        id={`${this.generatedId}-option-${index}`}\n        option={option}\n        selected={selected}\n        active={active}\n        focusRingVisible={this.focusRingVisible}\n        usesSubtext={usesSubtext}\n        actionOpen={option.action?.expanded}\n        popupRole={this.popupRole}\n        leading={\n          this.multiple ? (\n            <span\n              class=\"ds-choice-item__icon ds-control-icon-box ds-interaction-fill__content\"\n              aria-hidden=\"true\"\n            >\n              <ds-checkbox\n                class=\"select-option__checkbox\"\n                label=\"\"\n                size={this.size}\n                checked={selected}\n                presentation\n              />\n            </span>\n          ) : usesIcons && option.icon ? (\n            <span\n              class=\"ds-choice-item__icon ds-control-icon-box ds-interaction-fill__content\"\n              aria-hidden=\"true\"\n            >\n              <ds-icon name={option.icon} size={this.size} color=\"inherit\" />\n            </span>\n          ) : undefined\n        }\n        supporting={\n          option.subtextActions?.length ? (\n            <span class=\"ds-choice-item__subtext ds-control-label-box select-option__subtext-actions\">\n              {option.subtextActions.map((action, actionIndex) => [\n                actionIndex > 0 ? (\n                  <ds-text\n                    class=\"select-option__subtext-action-separator\"\n                    as=\"span\"\n                    variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                    color=\"inherit\"\n                    aria-hidden=\"true\"\n                  >\n                    ·\n                  </ds-text>\n                ) : null,\n                <button\n                  type=\"button\"\n                  class={{\n                    'select-option__subtext-action': true,\n                    'select-option__subtext-action--negative': action.tone === 'negative',\n                    'ds-text-action': true,\n                    'ds-focus-ring': true,\n                  }}\n                  onKeyDown={(event: KeyboardEvent) => event.stopPropagation()}\n                  onClick={(event: MouseEvent) => {\n                    event.preventDefault();\n                    event.stopPropagation();\n                    this.dsOptionSubtextAction.emit({\n                      value: option.value,\n                      actionValue: action.value,\n                      originalEvent: event,\n                    });\n                  }}\n                >\n                  <ds-text\n                    as=\"span\"\n                    variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                    color=\"inherit\"\n                  >\n                    {action.label}\n                  </ds-text>\n                </button>,\n              ])}\n            </span>\n          ) : undefined\n        }\n        action={\n          option.action ? (\n            <ds-tooltip label={option.action.label} side=\"left\" size=\"sm\">\n              <ds-button-unfilled\n                id={actionId}\n                variant=\"icon\"\n                size={OPTION_ACTION_SIZE[this.size]}\n                icon=\"Ellipses\"\n                rounded\n                hasBorder={false}\n                activeFill={false}\n                ariaLabel={option.action.label}\n                haspopup=\"menu\"\n                controls={option.action.controls}\n                expanded={option.action.expanded}\n                onKeyDown={event => {\n                  event.stopPropagation();\n                  if (event.key === 'Escape' || event.key === 'ArrowLeft') {\n                    event.preventDefault();\n                    this.controller.focusSearchOrTrigger();\n                  }\n                }}\n                onDsClick={(event: CustomEvent<MouseEvent>) => {\n                  event.stopPropagation();\n                  this.dsOptionAction.emit({\n                    value: option.value,\n                    anchorId: actionId,\n                    originalEvent: event.detail,\n                  });\n                }}\n              />\n            </ds-tooltip>\n          ) : undefined\n        }\n        onHover={() => {\n          this.focusRingVisible = false;\n          this.activeIndex = index;\n        }}\n        onSelect={() => this.selectOption(option)}\n      />\n    );\n  }\n\n  private get captionIconOnly(): boolean {\n    return this.collapseLabel && this.captionCompact && Boolean(this.icon || this.isLoading);\n  }\n\n  private syncCaptionCompactObserver(): void {\n    this.disconnectCaptionCompactObserver();\n    if (!this.collapseLabel) {\n      if (this.captionCompact) this.captionCompact = false;\n      return;\n    }\n    this.captionCompactDisconnect = observeTableCaptionCompact(this.el, compact => {\n      if (this.captionCompact !== compact) this.captionCompact = compact;\n    });\n  }\n\n  private disconnectCaptionCompactObserver(): void {\n    this.captionCompactDisconnect?.();\n    this.captionCompactDisconnect = undefined;\n  }\n\n  render() {\n    const inactive = this.isDisabled;\n    const showPlaceholder = !this.hasSelection;\n    const count = this.resolvedValues.length;\n    const label = this.multiple\n      ? `${this.placeholder}${count > 0 ? ` · ${count}` : ''}`\n      : showPlaceholder\n        ? this.placeholder\n        : (this.triggerLabel ?? this.selectedOption?.label);\n    const textVariant = CONTROL_TEXT_VARIANT[this.size];\n    const iconSize = ICON_SIZE[this.size];\n    const usesOptionIcons = !this.multiple && choiceListUsesIcons(this.allOptions);\n    const usesOptionSubtext = choiceListUsesSubtext(this.allOptions);\n    const showError = this.error && Boolean(this.errorMessage);\n    const describedBy =\n      [this.ariaDescribedby, showError ? this.errorId : undefined].filter(Boolean).join(' ') ||\n      undefined;\n    const popupStyle = {\n      position: 'fixed',\n      left: '0',\n      top: '0',\n      transform: `translate(${Math.round(this.position.x)}px, ${Math.round(this.position.y)}px)`,\n      zIndex: 'var(--dimension-z-index-floating)',\n      visibility: this.positionReady ? 'visible' : 'hidden',\n    };\n    let flatIndex = 0;\n\n    return (\n      <Host\n        class={{\n          'select-host': true,\n          'ds-select-trigger-host': true,\n          'select-host--multiple': this.multiple,\n          'ds-field-stack': true,\n          'ds-control-inactive': inactive,\n          [`ds-control--${this.size}`]: true,\n          'ds-table-caption-control': this.collapseLabel,\n          'ds-table-caption-control--compact': this.captionIconOnly,\n          ...controlWidthClass(this.width),\n          [`select-host--background-${this.background}`]: !!this.background,\n          [`ds-select-trigger-host--background-${this.background}`]: !!this.background,\n        }}\n      >\n        <button\n          ref={element => {\n            this.controller.setTriggerElement((element as HTMLButtonElement) ?? null);\n          }}\n          id={this.inputId ?? this.generatedId}\n          type=\"button\"\n          class={{\n            trigger: true,\n            'ds-control-frame': true,\n            'ds-focus-ring-inset': true,\n            'ds-interaction-fill': true,\n            'ds-interaction-fill--selected': !inactive && this.activeFill && this.hasSelection,\n            'trigger--expanded': !inactive && this.open,\n            'trigger--bordered': this.hasBorder,\n            'trigger--placeholder': showPlaceholder && !this.multiple,\n            'trigger--has-value': this.hasSelection,\n            'trigger--label-placeholder':\n              !this.multiple && Boolean(this.triggerLabel) && this.triggerLabelPlaceholder,\n            'wrapper--error': this.hasBorder && this.error,\n            [`ds-control--${this.size}`]: true,\n            ...choiceBackgroundClassMap(this.background),\n          }}\n          disabled={inactive}\n          role=\"combobox\"\n          aria-haspopup={this.popupRole}\n          aria-expanded={String(this.open)}\n          aria-controls={this.open ? this.listboxId : undefined}\n          aria-activedescendant={this.open && !this.searchable ? this.activeOptionId : undefined}\n          aria-label={this.ariaLabel ?? (this.captionIconOnly ? label : undefined)}\n          aria-labelledby={this.ariaLabelledby}\n          aria-describedby={describedBy}\n          aria-invalid={this.error ? 'true' : undefined}\n          aria-required={this.required || undefined}\n          aria-busy={this.isLoading ? 'true' : undefined}\n          onClick={() => (this.open ? this.closePopup() : this.openPopup(false))}\n          onKeyDown={event => {\n            const action = this.visibleOptions[this.activeIndex]?.action;\n            if (\n              this.open &&\n              action &&\n              (event.key === 'ArrowRight' || (event.key === 'F10' && event.shiftKey))\n            ) {\n              event.preventDefault();\n              document\n                .getElementById(`${this.generatedId}-option-action-${this.activeIndex}`)\n                ?.querySelector<HTMLElement>('button')\n                ?.focus();\n              return;\n            }\n            this.handleTriggerKeyDown(event);\n          }}\n        >\n          {(this.icon || this.isLoading) && (\n            <span\n              class=\"trigger__prefix ds-control-icon-box ds-interaction-fill__content\"\n              aria-hidden=\"true\"\n            >\n              {this.isLoading ? (\n                <ds-loader size={iconSize} color=\"inherit\" />\n              ) : (\n                <ds-icon name={this.icon} size={iconSize} color=\"inherit\" />\n              )}\n            </span>\n          )}\n          {this.captionIconOnly ? null : (\n            <span\n              class={{\n                'trigger__label-box': true,\n                'ds-interaction-fill__content': true,\n              }}\n            >\n              <span\n                class={{\n                  'trigger__label-content': true,\n                  'ds-control-label-box': true,\n                  'ds-control-label-dot': this.dot,\n                  'trigger__label-content--dot': this.dot,\n                }}\n              >\n                <ds-text\n                  class=\"trigger__label\"\n                  as=\"span\"\n                  variant={textVariant}\n                  color=\"inherit\"\n                  lineTruncation={1}\n                >\n                  {label}\n                </ds-text>\n                {this.dot && (\n                  <ds-badge\n                    class=\"trigger__dot ds-control-label-dot__badge\"\n                    variant=\"dot\"\n                    hasRing={false}\n                    label=\"\"\n                    aria-hidden=\"true\"\n                  />\n                )}\n              </span>\n            </span>\n          )}\n          {this.captionIconOnly ? null : (\n            <span\n              class=\"trigger__chevron ds-control-icon-box ds-interaction-fill__content\"\n              aria-hidden=\"true\"\n            >\n              <ds-icon\n                name={this.indicator === 'up-down' ? 'ChevronUpDown' : 'ChevronDown'}\n                size={iconSize}\n                color=\"inherit\"\n              />\n            </span>\n          )}\n        </button>\n\n        {this.open && (\n          <div\n            popover=\"manual\"\n            ref={element => {\n              this.controller.setPopupElement((element as HTMLDivElement) ?? null);\n            }}\n            class=\"select-popup ds-choice-popup\"\n            style={popupStyle}\n          >\n            {this.searchable && (\n              <ChoiceSearch\n                size={this.size}\n                value={this.searchTerm}\n                placeholder={this.searchPlaceholder}\n                controls={this.listboxId}\n                activeDescendant={this.activeOptionId}\n                inputRef={this.controller.setSearchElement}\n                clearLabel={this.clearLabel}\n                onValueChange={value => {\n                  this.searchTerm = value;\n                }}\n                onKeyDown={event => this.handleListKeyDown(event)}\n              />\n            )}\n            <div\n              id={this.listboxId}\n              class=\"ds-choice-list\"\n              role={this.popupRole}\n              aria-multiselectable={this.multiple ? 'true' : undefined}\n              aria-label={this.ariaLabel ?? this.placeholder}\n              aria-busy={this.isLoading ? 'true' : undefined}\n            >\n              {this.isLoading ? (\n                <div\n                  class=\"ds-choice-loading ds-empty-region\"\n                  role={this.popupRole === 'grid' ? 'row' : 'option'}\n                  aria-selected=\"false\"\n                  aria-disabled=\"true\"\n                  aria-label={this.loadingLabel}\n                  aria-live=\"polite\"\n                >\n                  {this.popupRole === 'grid' ? (\n                    <span role=\"gridcell\">\n                      <ds-loader size={this.size} color=\"inherit\" />\n                    </span>\n                  ) : (\n                    <ds-loader size={this.size} color=\"inherit\" />\n                  )}\n                </div>\n              ) : this.visibleOptions.length === 0 ? (\n                <div\n                  class=\"ds-choice-empty ds-empty-region\"\n                  role={this.popupRole === 'grid' ? 'row' : 'option'}\n                  aria-selected=\"false\"\n                  aria-disabled=\"true\"\n                  aria-label={this.noResultsText}\n                  aria-live=\"polite\"\n                >\n                  {this.popupRole === 'grid' ? (\n                    <span role=\"gridcell\">\n                      <ds-empty-state body={this.noResultsText} />\n                    </span>\n                  ) : (\n                    <ds-empty-state body={this.noResultsText} />\n                  )}\n                </div>\n              ) : (\n                this.visibleSections.map((section, sectionIndex) => (\n                  <div\n                    class={{\n                      'ds-choice-section': true,\n                      'ds-chrome-column': true,\n                      'ds-chrome-space--sm': true,\n                      'ds-choice-section--divided': !!section.divider,\n                      'ds-choice-section--headed-after-first':\n                        sectionIndex > 0 && Boolean(section.header),\n                    }}\n                    role={\n                      this.popupRole === 'grid' ? 'rowgroup' : section.header ? 'group' : undefined\n                    }\n                    aria-label={section.header}\n                  >\n                    {section.header && this.popupRole === 'grid' ? (\n                      <ds-text\n                        class={`ds-choice-section__header ds-control-section-heading ds-control--${this.size}`}\n                        as=\"span\"\n                        variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                        emphasis\n                        color=\"primary\"\n                        role=\"row\"\n                      >\n                        <span class=\"ds-choice-section__header-label\" role=\"gridcell\">\n                          {section.header}\n                        </span>\n                      </ds-text>\n                    ) : section.header ? (\n                      <ds-text\n                        class={`ds-choice-section__header ds-control-section-heading ds-control--${this.size}`}\n                        as=\"span\"\n                        variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                        emphasis\n                        color=\"primary\"\n                        aria-hidden=\"true\"\n                      >\n                        <span class=\"ds-choice-section__header-label\">{section.header}</span>\n                      </ds-text>\n                    ) : null}\n                    {section.options.map(option =>\n                      this.renderOption(option, flatIndex++, usesOptionIcons, usesOptionSubtext)\n                    )}\n                  </div>\n                ))\n              )}\n            </div>\n            {this.footerActionLabel && !this.isLoading ? (\n              <ChoiceActionFooter\n                size={this.size}\n                label={this.footerActionLabel}\n                onAction={this.activateFooterAction}\n              />\n            ) : this.allowClear && this.hasSelection && !this.isLoading ? (\n              <ChoiceFooter\n                size={this.size}\n                summary={this.multiple ? `${count} ${this.selectedLabel}` : undefined}\n                compactSummary={this.multiple ? String(count) : undefined}\n                useCompactSummary={this.compactFooterSummary}\n                contentRef={element => {\n                  this.footerContentElement = element ?? undefined;\n                }}\n                summaryMeasureRef={element => {\n                  this.footerSummaryMeasureElement = element ?? undefined;\n                }}\n                clearRef={element => {\n                  this.footerClearElement = element ?? undefined;\n                }}\n                clearLabel={this.clearLabel}\n                onClear={this.clearSelection}\n              />\n            ) : null}\n          </div>\n        )}\n\n        {showError && (\n          <ds-text\n            class=\"error-text\"\n            as=\"div\"\n            variant=\"text-body-small\"\n            color=\"negative\"\n            textId={this.errorId}\n            role=\"alert\"\n          >\n            {this.errorMessage}\n          </ds-text>\n        )}\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]