@ds-mo/ui 15.4.0 → 15.5.0

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

@@ -186,7 +186,7 @@
     },
     {
       "path": "src/wc/components/ScrollOverlay/ScrollOverlay.tsx",
-      "content": "import { Component, Element, Event, EventEmitter, h, Host, Method, Prop } from '@stencil/core';\nimport { ScrollOverlayController } from '../../utils/scroll-overlay-controller';\n\nexport interface ScrollOverlayScrollDetail {\n  scrollTop: number;\n  scrollHeight: number;\n  clientHeight: number;\n}\n\n@Component({\n  tag: 'ds-scroll-overlay',\n  styleUrl: 'ScrollOverlay.css',\n  styleUrls: ['../../utils/scroll-edge-fade.css'],\n  scoped: true,\n})\nexport class ScrollOverlay {\n  @Element() el!: HTMLElement;\n\n  /** Optional accessible name. When provided, the scrollport is a focusable region. */\n  @Prop() scrollLabel: string | undefined;\n\n  /** Reports scroll position without exposing the internal scrollport element. */\n  @Event() dsScroll!: EventEmitter<ScrollOverlayScrollDetail>;\n\n  private viewport?: HTMLElement;\n  private content?: HTMLElement;\n  private overlay?: HTMLElement;\n  private controller?: ScrollOverlayController;\n\n  componentDidLoad(): void {\n    if (!this.viewport || !this.content || !this.overlay) return;\n    this.controller = new ScrollOverlayController({\n      host: this.el,\n      viewport: this.viewport,\n      content: this.content,\n      overlay: this.overlay,\n    });\n    this.controller.connect();\n  }\n\n  disconnectedCallback(): void {\n    this.controller?.disconnect();\n  }\n\n  /** Move the owned scrollport to its beginning. */\n  @Method()\n  async scrollToStart(): Promise<void> {\n    this.viewport?.scrollTo({ top: 0, behavior: 'auto' });\n    this.controller?.sync();\n  }\n\n  /** Move the owned scrollport to its live end. */\n  @Method()\n  async scrollToEnd(): Promise<void> {\n    this.viewport?.scrollTo({ top: this.viewport.scrollHeight, behavior: 'auto' });\n    this.controller?.sync();\n  }\n\n  /** Re-measure footer geometry after an imperative slotted-content update. */\n  @Method()\n  async refreshOverlay(): Promise<void> {\n    this.controller?.sync();\n  }\n\n  private handleScroll = (): void => {\n    if (!this.viewport) return;\n    this.controller?.sync();\n    this.dsScroll.emit({\n      scrollTop: this.viewport.scrollTop,\n      scrollHeight: this.viewport.scrollHeight,\n      clientHeight: this.viewport.clientHeight,\n    });\n  };\n\n  render() {\n    const labelled = Boolean(this.scrollLabel?.trim());\n    return (\n      <Host>\n        <div class=\"scroll-overlay\">\n          <div\n            class=\"scroll-overlay__viewport\"\n            ref={element => {\n              this.viewport = element;\n            }}\n            role={labelled ? 'region' : undefined}\n            aria-label={labelled ? this.scrollLabel : undefined}\n            tabIndex={labelled ? 0 : undefined}\n            onScroll={this.handleScroll}\n          >\n            <div\n              class=\"scroll-overlay__content scroll-edge-fade--block-window\"\n              ref={element => {\n                this.content = element;\n              }}\n            >\n              <div class=\"scroll-overlay__body\">\n                <slot />\n              </div>\n            </div>\n          </div>\n          <div\n            class=\"scroll-overlay__overlay\"\n            ref={element => {\n              this.overlay = element;\n            }}\n          >\n            <slot name=\"overlay\" />\n          </div>\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { Component, Element, Event, EventEmitter, h, Host, Method, Prop } from '@stencil/core';\nimport { ScrollOverlayController } from '../../utils/scroll-overlay-controller';\n\nexport interface ScrollOverlayScrollDetail {\n  scrollTop: number;\n  scrollHeight: number;\n  clientHeight: number;\n}\n\n@Component({\n  tag: 'ds-scroll-overlay',\n  styleUrl: 'ScrollOverlay.css',\n  styleUrls: ['../../utils/scroll-edge-fade.css'],\n  scoped: true,\n})\nexport class ScrollOverlay {\n  @Element() el!: HTMLElement;\n\n  /** Optional accessible name. When provided, the scrollport is a focusable region. */\n  @Prop() scrollLabel: string | undefined;\n\n  /** Reports scroll position without exposing the internal scrollport element. */\n  @Event() dsScroll!: EventEmitter<ScrollOverlayScrollDetail>;\n\n  private viewport?: HTMLElement;\n  private content?: HTMLElement;\n  private overlay?: HTMLElement;\n  private controller?: ScrollOverlayController;\n\n  connectedCallback(): void {\n    this.controller?.connect();\n  }\n\n  componentDidLoad(): void {\n    if (!this.viewport || !this.content || !this.overlay) return;\n    this.controller = new ScrollOverlayController({\n      host: this.el,\n      viewport: this.viewport,\n      content: this.content,\n      overlay: this.overlay,\n    });\n    this.controller.connect();\n  }\n\n  disconnectedCallback(): void {\n    this.controller?.disconnect();\n  }\n\n  /** Move the owned scrollport to its beginning. */\n  @Method()\n  async scrollToStart(): Promise<void> {\n    this.viewport?.scrollTo({ top: 0, behavior: 'auto' });\n    this.controller?.sync();\n  }\n\n  /** Move the owned scrollport to its live end. */\n  @Method()\n  async scrollToEnd(): Promise<void> {\n    this.viewport?.scrollTo({ top: this.viewport.scrollHeight, behavior: 'auto' });\n    this.controller?.sync();\n  }\n\n  /** Re-measure footer geometry after an imperative slotted-content update. */\n  @Method()\n  async refreshOverlay(): Promise<void> {\n    this.controller?.sync();\n  }\n\n  private handleScroll = (): void => {\n    if (!this.viewport) return;\n    this.controller?.sync();\n    this.dsScroll.emit({\n      scrollTop: this.viewport.scrollTop,\n      scrollHeight: this.viewport.scrollHeight,\n      clientHeight: this.viewport.clientHeight,\n    });\n  };\n\n  render() {\n    const labelled = Boolean(this.scrollLabel?.trim());\n    return (\n      <Host>\n        <div class=\"scroll-overlay\">\n          <div\n            class=\"scroll-overlay__viewport\"\n            ref={element => {\n              this.viewport = element;\n            }}\n            role={labelled ? 'region' : undefined}\n            aria-label={labelled ? this.scrollLabel : undefined}\n            tabIndex={labelled ? 0 : undefined}\n            onScroll={this.handleScroll}\n          >\n            <div\n              class=\"scroll-overlay__content scroll-edge-fade--block-window\"\n              ref={element => {\n                this.content = element;\n              }}\n            >\n              <div class=\"scroll-overlay__body\">\n                <slot />\n              </div>\n            </div>\n          </div>\n          <div\n            class=\"scroll-overlay__overlay\"\n            ref={element => {\n              this.overlay = element;\n            }}\n          >\n            <slot name=\"overlay\" />\n          </div>\n        </div>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

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

@@ -90,6 +90,7 @@
         "Select owns its associated popup and automatically retains the shared surface-open pressed wash. Consumers do not synchronize a second flag for the built-in picker. Contextual option actions are externally owned: their surfaceOpen state keeps the action visible through the associated menu exit, independently of the selected option."
       ],
       "responsiveBehavior": [
+        "An embedded editor may delegate hover, press and focus indication to its containing cell; that owner must supply a visible focus indicator. An explicit anchor positions the popup against the containing surface without transferring trigger focus or accessibility ownership. Popup options keep their own interaction feedback.",
         "Use width fill for form fields and width hug for compact filter bars. Override those defaults only when the owning layout has a clear constraint.",
         "When collapseLabel is set inside a named ds-table container narrower than 900px, the trigger omits its label and chevron, becomes icon-only, and exposes its label through a hover and keyboard-focus tooltip. A selected value promotes the prefix icon to primary.",
         "The popup matches the trigger minimum width, may grow for content, and clamps to the nearest data-ds-overlay-boundary rectangle or the viewport fallback. Assign boundary as an HTMLElement only for an explicit override.",
@@ -196,6 +197,13 @@
           "mutable": false,
           "description": "Show the clear footer action when a value exists."
         },
+        "anchor": {
+          "type": "HTMLElement | undefined",
+          "resolvedType": "HTMLElement | undefined",
+          "required": false,
+          "mutable": false,
+          "description": "Optional popup positioning anchor; the trigger still owns focus and accessibility."
+        },
         "ariaDescribedby": {
           "type": "string | undefined",
           "resolvedType": "string | undefined",
@@ -297,6 +305,14 @@
           "mutable": false,
           "description": "Optional text action shown in the popup footer instead of the clear action."
         },
+        "form": {
+          "type": "string | undefined",
+          "resolvedType": "string | undefined",
+          "attribute": "form",
+          "required": false,
+          "mutable": false,
+          "description": "Associates the select with a form by id when rendered outside that form."
+        },
         "hasBorder": {
           "type": "boolean",
           "resolvedType": "boolean",
@@ -306,6 +322,24 @@
           "mutable": false,
           "description": "Show the surface-aware inset border, including focused and invalid strokes."
         },
+        "hasFocusRing": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "has-focus-ring",
+          "default": "true",
+          "required": false,
+          "mutable": false,
+          "description": "Disable only when a containing surface supplies a visible focus indicator."
+        },
+        "hasInteractionFill": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "has-interaction-fill",
+          "default": "true",
+          "required": false,
+          "mutable": false,
+          "description": "Disable only when a containing surface owns hover and press feedback."
+        },
         "icon": {
           "type": "string | undefined",
           "resolvedType": "string | undefined",
@@ -638,6 +672,13 @@
         "mutable": false,
         "description": "Show the clear footer action when a value exists."
       },
+      "anchor": {
+        "type": "HTMLElement | undefined",
+        "resolvedType": "HTMLElement | undefined",
+        "required": false,
+        "mutable": false,
+        "description": "Optional popup positioning anchor; the trigger still owns focus and accessibility."
+      },
       "ariaDescribedby": {
         "type": "string | undefined",
         "resolvedType": "string | undefined",
@@ -739,6 +780,14 @@
         "mutable": false,
         "description": "Optional text action shown in the popup footer instead of the clear action."
       },
+      "form": {
+        "type": "string | undefined",
+        "resolvedType": "string | undefined",
+        "attribute": "form",
+        "required": false,
+        "mutable": false,
+        "description": "Associates the select with a form by id when rendered outside that form."
+      },
       "hasBorder": {
         "type": "boolean",
         "resolvedType": "boolean",
@@ -748,6 +797,24 @@
         "mutable": false,
         "description": "Show the surface-aware inset border, including focused and invalid strokes."
       },
+      "hasFocusRing": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "has-focus-ring",
+        "default": "true",
+        "required": false,
+        "mutable": false,
+        "description": "Disable only when a containing surface supplies a visible focus indicator."
+      },
+      "hasInteractionFill": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "has-interaction-fill",
+        "default": "true",
+        "required": false,
+        "mutable": false,
+        "description": "Disable only when a containing surface owns hover and press feedback."
+      },
       "icon": {
         "type": "string | undefined",
         "resolvedType": "string | undefined",
@@ -1086,7 +1153,7 @@
         "import": "import { DsSelect } from '@ds-mo/ui/angular/ds-select';",
         "example": "<ds-select></ds-select>"
       },
-      "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: boundary, options, sections.",
+      "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: anchor, boundary, options, sections.",
       "peerDependencies": {
         "required": [
           "@ds-mo/tokens ^6.6.1",
@@ -1115,12 +1182,12 @@
   "files": [
     {
       "path": "src/wc/components/Select/Select.css",
-      "content": "@import '../../utils/radius.css';\n@import '../../utils/choice-list.css';\n@import '../../utils/control-density-inset.css';\n@import '../../utils/control-parts.css';\n@import '../../utils/control-width.css';\n@import '../../utils/field-stack.css';\n@import '../../utils/search-control.css';\n@import '../../utils/select-trigger.css';\n@import '../../utils/table-caption-control.css';\n@import '../../utils/typography.css';\n@import '../../styles/control-elevation.css';\n\n.wrapper--error {\n  --ds-interaction-border-width: var(--dimension-stroke-width-018);\n  --ds-interaction-border-color: var(--color-border-bold-negative);\n}\n\n.select-popup {\n  color: var(--color-foreground-secondary);\n}\n\n.select-option[aria-selected='true'] .ds-choice-item__icon {\n  color: var(--color-foreground-primary);\n}\n\n.select-option-row {\n  position: relative;\n  isolation: isolate;\n}\n\n.select-option-row__action {\n  position: absolute;\n  top: 50%;\n  right: var(--dimension-space-050);\n  z-index: var(--dimension-z-index-floating);\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  border-radius: var(--dimension-radius-half);\n  background: var(--color-background-transparent);\n  -webkit-backdrop-filter: blur(var(--effect-blur-sm));\n  backdrop-filter: blur(var(--effect-blur-sm));\n  opacity: 0;\n  pointer-events: none;\n  transform: translateY(-50%);\n}\n\n.select-option-row:has(:focus-visible) .select-option-row__action,\n.select-option-row--action-open .select-option-row__action,\n.select-option-row--keyboard-active .select-option-row__action {\n  opacity: 1;\n  pointer-events: auto;\n}\n\n.select-option-row--action-open .select-option::after {\n  background: var(--ds-interaction-hover);\n}\n\n.select-option__subtext-actions {\n  display: flex;\n  align-items: center;\n  gap: var(--dimension-space-050);\n  min-inline-size: 0;\n  color: var(--color-foreground-secondary);\n}\n\n.select-option__subtext-action {\n  appearance: none;\n  display: inline-flex;\n  align-items: center;\n  padding: 0;\n  border: 0;\n  border-radius: var(--dimension-radius-025);\n  background: transparent;\n  cursor: pointer;\n}\n\n.select-option__subtext-action--negative {\n  --ds-text-action-foreground: var(--color-foreground-bold-negative);\n}\n\n.select-option__subtext-action-separator {\n  color: var(--color-foreground-tertiary);\n  pointer-events: none;\n}\n\n@media (hover: hover) and (pointer: fine) {\n  .select-option-row:hover .select-option-row__action {\n    opacity: 1;\n    pointer-events: auto;\n  }\n\n  .select-option-row:hover .select-option::after {\n    background: var(--ds-interaction-hover);\n  }\n}\n\n@media (hover: none) {\n  .select-option-row__action {\n    opacity: 1;\n    pointer-events: auto;\n  }\n\n  .select-option-row--has-action .ds-choice-item__content {\n    padding-inline-end: var(--dimension-size-400);\n  }\n}\n\n.error-text {\n  width: 100%;\n}\n",
+      "content": "@import '../../utils/radius.css';\n@import '../../utils/choice-list.css';\n@import '../../utils/control-density-inset.css';\n@import '../../utils/control-parts.css';\n@import '../../utils/control-width.css';\n@import '../../utils/field-stack.css';\n@import '../../utils/search-control.css';\n@import '../../utils/select-trigger.css';\n@import '../../utils/table-caption-control.css';\n@import '../../utils/typography.css';\n@import '../../styles/control-elevation.css';\n\n.wrapper--error {\n  --ds-interaction-border-width: var(--dimension-stroke-width-018);\n  --ds-interaction-border-color: var(--color-border-bold-negative);\n}\n\n.select-popup {\n  color: var(--color-foreground-secondary);\n}\n\n/* An embedding surface supplies the focus indicator instead of a second trigger ring. */\n.trigger--external-focus {\n  outline: none;\n}\n\n.trigger--external-fill {\n  --ds-interaction-hover: transparent;\n  --ds-interaction-pressed: transparent;\n  --ds-interaction-active: transparent;\n}\n\n.select-option[aria-selected='true'] .ds-choice-item__icon {\n  color: var(--color-foreground-primary);\n}\n\n.select-option-row {\n  position: relative;\n  isolation: isolate;\n}\n\n.select-option-row__action {\n  position: absolute;\n  top: 50%;\n  right: var(--dimension-space-050);\n  z-index: var(--dimension-z-index-floating);\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  border-radius: var(--dimension-radius-half);\n  background: var(--color-background-transparent);\n  -webkit-backdrop-filter: blur(var(--effect-blur-sm));\n  backdrop-filter: blur(var(--effect-blur-sm));\n  opacity: 0;\n  pointer-events: none;\n  transform: translateY(-50%);\n}\n\n.select-option-row:has(:focus-visible) .select-option-row__action,\n.select-option-row--action-open .select-option-row__action,\n.select-option-row--keyboard-active .select-option-row__action {\n  opacity: 1;\n  pointer-events: auto;\n}\n\n.select-option-row--action-open .select-option::after {\n  background: var(--ds-interaction-hover);\n}\n\n.select-option__subtext-actions {\n  display: flex;\n  align-items: center;\n  gap: var(--dimension-space-050);\n  min-inline-size: 0;\n  color: var(--color-foreground-secondary);\n}\n\n.select-option__subtext-action {\n  appearance: none;\n  display: inline-flex;\n  align-items: center;\n  padding: 0;\n  border: 0;\n  border-radius: var(--dimension-radius-025);\n  background: transparent;\n  cursor: pointer;\n}\n\n.select-option__subtext-action--negative {\n  --ds-text-action-foreground: var(--color-foreground-bold-negative);\n}\n\n.select-option__subtext-action-separator {\n  color: var(--color-foreground-tertiary);\n  pointer-events: none;\n}\n\n@media (hover: hover) and (pointer: fine) {\n  .select-option-row:hover .select-option-row__action {\n    opacity: 1;\n    pointer-events: auto;\n  }\n\n  .select-option-row:hover .select-option::after {\n    background: var(--ds-interaction-hover);\n  }\n}\n\n@media (hover: none) {\n  .select-option-row__action {\n    opacity: 1;\n    pointer-events: auto;\n  }\n\n  .select-option-row--has-action .ds-choice-item__content {\n    padding-inline-end: var(--dimension-size-400);\n  }\n}\n\n.error-text {\n  width: 100%;\n}\n",
       "type": "registry:ui"
     },
     {
       "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  type VNode,\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 ControlInsetDepth,\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' | 'none';\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  /** Use reduced outer geometry when nested inside a control of the same size. */\n  @Prop() isInset: boolean = false;\n  /** Single removes 4px overall; double removes 8px overall (xs stays single). */\n  @Prop() insetDepth: ControlInsetDepth = 'single';\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  /** Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used. */\n  @Prop() boundary: HTMLElement | undefined;\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  /** Keep trigger colors neutral when a value is selected. */\n  @Prop() neutralTrigger: boolean = false;\n  @Prop() activeFill: boolean = false;\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  /** Always show only the prefix icon; retain an accessible name via aria-label. */\n  @Prop() iconOnly: boolean = false;\n  /** Show the surface-aware inset border, including focused and invalid strokes. */\n  @Prop() hasBorder: boolean = true;\n  /** Use a pill radius on the trigger. Popup chrome stays on the menu radius. */\n  @Prop() rounded: boolean = false;\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 boundary() {\n        return owner.boundary;\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  @Watch('boundary')\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?.surfaceOpen ?? 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                surfaceOpen={option.action.surfaceOpen}\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 (\n      (this.iconOnly || (this.collapseLabel && this.captionCompact)) &&\n      Boolean(this.icon || this.isLoading)\n    );\n  }\n\n  private get doubleInset(): boolean {\n    return this.isInset && this.insetDepth === 'double' && this.size !== 'xs';\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  private renderCaptionTooltip(trigger: VNode, label: string): VNode {\n    if (!this.collapseLabel) return trigger;\n    return (\n      <ds-tooltip label={label} side=\"top\" size=\"sm\">\n        {trigger}\n      </ds-tooltip>\n    );\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-field-stack--supporting-inset': !this.hasBorder,\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        {this.renderCaptionTooltip(\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              'ds-interaction-fill--surface-open': !inactive && this.open,\n              'trigger--bordered': this.hasBorder,\n              'trigger--rounded': this.rounded,\n              'trigger--placeholder': showPlaceholder && !this.multiple,\n              'trigger--has-value': this.hasSelection && !this.neutralTrigger,\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              'ds-control--inset': this.isInset && !this.doubleInset,\n              'ds-control--inset-double': this.doubleInset,\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 || this.indicator === 'none' ? 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          this.captionIconOnly ? this.ariaLabel?.trim() || this.placeholder : ''\n        )}\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  type VNode,\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 ControlInsetDepth,\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' | 'none';\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  /** Associates the select with a form by id when rendered outside that form. */\n  @Prop({ reflect: true }) form: 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  /** Use reduced outer geometry when nested inside a control of the same size. */\n  @Prop() isInset: boolean = false;\n  /** Single removes 4px overall; double removes 8px overall (xs stays single). */\n  @Prop() insetDepth: ControlInsetDepth = 'single';\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  /** Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used. */\n  @Prop() boundary: HTMLElement | undefined;\n  /** Optional popup positioning anchor; the trigger still owns focus and accessibility. */\n  @Prop() anchor: HTMLElement | undefined;\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  /** Keep trigger colors neutral when a value is selected. */\n  @Prop() neutralTrigger: boolean = false;\n  @Prop() activeFill: boolean = false;\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  /** Always show only the prefix icon; retain an accessible name via aria-label. */\n  @Prop() iconOnly: boolean = false;\n  /** Show the surface-aware inset border, including focused and invalid strokes. */\n  @Prop() hasBorder: boolean = true;\n  /** Disable only when a containing surface owns hover and press feedback. */\n  @Prop() hasInteractionFill: boolean = true;\n  /** Disable only when a containing surface supplies a visible focus indicator. */\n  @Prop() hasFocusRing: boolean = true;\n  /** Use a pill radius on the trigger. Popup chrome stays on the menu radius. */\n  @Prop() rounded: boolean = false;\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 boundary() {\n        return owner.boundary;\n      },\n      get anchor() {\n        return owner.anchor;\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('requiredMessage')\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, {\n        inactive,\n        state: JSON.stringify(this.value),\n      });\n    } else {\n      const value = this.hasSelection ? this.scalarValue : '';\n      setFormControlValue(this.internals, value, { inactive, state: this.scalarValue });\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  @Watch('boundary')\n  @Watch('anchor')\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?.surfaceOpen ?? 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                surfaceOpen={option.action.surfaceOpen}\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 (\n      (this.iconOnly || (this.collapseLabel && this.captionCompact)) &&\n      Boolean(this.icon || this.isLoading)\n    );\n  }\n\n  private get doubleInset(): boolean {\n    return this.isInset && this.insetDepth === 'double' && this.size !== 'xs';\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  private renderCaptionTooltip(trigger: VNode, label: string): VNode {\n    if (!this.collapseLabel) return trigger;\n    return (\n      <ds-tooltip label={label} side=\"top\" size=\"sm\">\n        {trigger}\n      </ds-tooltip>\n    );\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-field-stack--supporting-inset': !this.hasBorder,\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        {this.renderCaptionTooltip(\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': this.hasFocusRing,\n              'trigger--external-focus': !this.hasFocusRing,\n              // The shared overlay also carries borders/focus; suppress only its wash.\n              'ds-interaction-fill': this.hasInteractionFill || this.hasBorder || this.hasFocusRing,\n              'trigger--external-fill': !this.hasInteractionFill,\n              'ds-interaction-fill--selected':\n                this.hasInteractionFill && !inactive && this.activeFill && this.hasSelection,\n              'trigger--expanded': !inactive && this.open,\n              'ds-interaction-fill--surface-open':\n                this.hasInteractionFill && !inactive && this.open,\n              'trigger--bordered': this.hasBorder,\n              'trigger--rounded': this.rounded,\n              'trigger--placeholder': showPlaceholder && !this.multiple,\n              'trigger--has-value': this.hasSelection && !this.neutralTrigger,\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              'ds-control--inset': this.isInset && !this.doubleInset,\n              'ds-control--inset-double': this.doubleInset,\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 || this.indicator === 'none' ? 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          this.captionIconOnly ? this.ariaLabel?.trim() || this.placeholder : ''\n        )}\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"
     }
   ]