@ds-mo/ui 14.36.0 → 15.1.0

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

@@ -92,7 +92,54 @@
           "label": "Surface ownership and trigger state",
           "path": "src/docs/SurfaceOwnership.mdx"
         }
-      ]
+      ],
+      "styling": {
+        "rationale": "The component owns the protected recipes below; unspecified host properties and application layout remain customizable.",
+        "protected": [
+          {
+            "properties": [
+              "font",
+              "font-size",
+              "font-weight",
+              "font-family",
+              "line-height",
+              "letter-spacing",
+              "height",
+              "min-height",
+              "max-height",
+              "padding",
+              "gap"
+            ],
+            "reason": "The control density is one atomic recipe; use the size and inset props instead of replacing internal metrics.",
+            "props": [
+              "size"
+            ]
+          },
+          {
+            "properties": [
+              "border-radius"
+            ],
+            "reason": "The component owns its corner treatment; select the supported radius treatment.",
+            "props": [
+              "size"
+            ]
+          },
+          {
+            "properties": [
+              "background",
+              "border",
+              "box-shadow",
+              "color"
+            ],
+            "reason": "The component owns its surface and interaction treatment; use its semantic presentation props or compose an application-owned surrounding surface.",
+            "props": [
+              "hasBorder",
+              "size"
+            ]
+          }
+        ],
+        "customProperties": []
+      }
     },
     "api": {
       "props": {
@@ -853,7 +900,7 @@
       "peerDependencies": {
         "required": [
           "@ds-mo/tokens ^6.5.1",
-          "@ds-mo/icons ^7.0.0"
+          "@ds-mo/icons ^8.1.0"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }
@@ -879,12 +926,12 @@
   "files": [
     {
       "path": "src/wc/components/FilterMenu/FilterMenu.css",
-      "content": "@import '../../utils/radius.css';\n@import '../../utils/choice-list.css';\n@import '../../utils/chrome-header.css';\n@import '../../utils/control-parts.css';\n@import '../../utils/control-width.css';\n@import '../../utils/select-trigger.css';\n@import '../../utils/search-control.css';\n@import '../../utils/table-caption-control.css';\n\n:host(.filter-menu-host--external-trigger) {\n  display: contents;\n}\n\n.filter-menu {\n  display: flex;\n  min-height: 0;\n  flex-direction: column;\n  color: var(--color-foreground-secondary);\n}\n\n.filter-menu__body {\n  display: grid;\n  grid-template-columns: var(--dimension-menu-width-xs) var(--dimension-menu-width-sm);\n  min-height: calc(var(--dimension-size-800) * 4 + var(--dimension-space-150));\n  max-height: calc(100vh - var(--dimension-size-800) - var(--dimension-size-600));\n}\n\n.filter-menu__category-pane {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex-direction: column;\n  border-inline-end: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n}\n\n.filter-menu__categories {\n  flex: 1 1 auto;\n  min-width: 0;\n}\n\n.filter-menu__category-section {\n  display: flex;\n  min-width: 0;\n  flex-direction: column;\n}\n\n.filter-menu__category-section.ds-choice-section--divided {\n  padding-block-end: var(--dimension-space-050);\n}\n\n.filter-menu__category {\n  justify-content: space-between;\n  width: 100%;\n  border: 0;\n  background: transparent;\n  color: var(--color-foreground-secondary);\n  cursor: default;\n  text-align: start;\n}\n\n.filter-menu__category--active {\n  color: var(--color-foreground-primary);\n}\n\n.filter-menu__category-dot-box {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  flex-shrink: 0;\n  width: var(--ds-control-icon, var(--dimension-iconography-md));\n  height: var(--ds-control-icon, var(--dimension-iconography-md));\n  pointer-events: none;\n}\n\n.filter-menu__options {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex-direction: column;\n  overflow: hidden;\n}\n\n.filter-menu__options-content {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex: 1 1 auto;\n  flex-direction: column;\n  overflow: auto;\n}\n\n.filter-menu__option-search {\n  position: relative;\n  flex: 0 0 var(--dimension-size-500);\n  min-width: 0;\n  min-height: var(--dimension-size-500);\n  background: transparent;\n}\n\n.filter-menu__option-search::after {\n  content: '';\n  position: absolute;\n  inset: auto 0 0;\n  height: var(--dimension-stroke-width-012);\n  background-color: var(--color-border-tertiary);\n  pointer-events: none;\n}\n\n.filter-menu__option-search .select-search {\n  height: 100%;\n  background: transparent;\n}\n\n.filter-menu__options--date,\n.filter-menu__option-list--date,\n.filter-menu__date {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex-direction: column;\n}\n\n.filter-menu__option-list--date,\n.filter-menu__date {\n  flex: 1 1 auto;\n}\n\n.filter-menu__date-header {\n  flex: 0 0 var(--dimension-size-500);\n  justify-content: center;\n  min-block-size: var(--dimension-size-500);\n  padding: var(--dimension-space-050);\n  background: var(--color-background-secondary);\n}\n\n.filter-menu__date-body {\n  display: flex;\n  flex: 1 1 auto;\n  min-height: 0;\n  flex-direction: column;\n}\n\n.filter-menu__date-relative {\n  flex: 1 1 auto;\n}\n\n.filter-menu__date-body > ds-calendar {\n  flex: 1 1 auto;\n  min-width: 0;\n  min-height: 0;\n}\n\n.filter-menu__footer {\n  flex: 0 0 auto;\n}\n\n.filter-menu__footer--categories-clear .ds-choice-footer__content {\n  justify-content: flex-start;\n}\n\n.filter-menu__footer--categories-clear[aria-hidden='true']::before {\n  visibility: hidden;\n}\n\n.ds-choice-footer__content:has(.filter-menu__apply) {\n  column-gap: var(--dimension-space-100);\n}\n\n.filter-menu__apply ds-text {\n  padding-right: 0;\n}\n\n.filter-menu__action-separator + .filter-menu__clear ds-text {\n  padding-left: 0;\n}\n\n.filter-menu__apply {\n  color: var(--color-foreground-bold-brand);\n}\n\n.filter-menu__apply:disabled {\n  color: var(--color-foreground-tertiary);\n  text-decoration-line: none;\n}\n\n.filter-menu__clear {\n  --ds-text-action-foreground: var(--color-foreground-bold-negative);\n\n  color: var(--ds-text-action-foreground);\n}\n\n.filter-menu__match-mode-footer {\n  flex: 0 0 auto;\n}\n\n.filter-menu__match-mode-content {\n  justify-content: flex-start;\n  padding-inline: calc(\n    var(--dimension-space-050) + var(--ds-control-padding-inline, var(--dimension-space-075)) +\n      var(--ds-control-label-inset, var(--dimension-space-025))\n  );\n}\n\n.filter-menu__match-mode-toggle {\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: default;\n}\n\n@media (forced-colors: active) {\n  .filter-menu__category-pane {\n    border-inline-end-color: var(--ds-forced-color-content);\n  }\n}\n\n.table-preferences-embedded {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  min-height: 0;\n  color: var(--color-foreground-secondary);\n}\n\n.table-preferences-embedded .filter-menu__body {\n  grid-template-columns: min(var(--dimension-menu-width-xs), 40%) minmax(0, 1fr);\n}\n\n.filter-menu-vertical__section {\n  border-bottom: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n}\n.filter-menu-vertical__section > summary {\n  cursor: default;\n  padding: var(--dimension-space-200);\n}\n.filter-menu-vertical__section > summary ds-text {\n  display: inline;\n}\n\n.filter-menu-vertical__section > summary {\n  display: flex;\n  align-items: center;\n  gap: var(--dimension-space-100);\n  list-style: none;\n}\n.filter-menu-vertical__section > summary::-webkit-details-marker {\n  display: none;\n}\n.filter-menu-vertical__section:not([open]) .filter-menu-vertical__chevron {\n  transform: rotate(-90deg);\n}\n",
+      "content": "@import '../../utils/radius.css';\n@import '../../utils/choice-list.css';\n@import '../../utils/chrome-header.css';\n@import '../../utils/control-parts.css';\n@import '../../utils/control-width.css';\n@import '../../utils/select-trigger.css';\n@import '../../utils/search-control.css';\n@import '../../utils/table-caption-control.css';\n\n:host(.filter-menu-host--external-trigger) {\n  display: contents;\n}\n\n.filter-menu {\n  display: flex;\n  min-height: 0;\n  flex-direction: column;\n  color: var(--color-foreground-secondary);\n}\n\n.filter-menu__body {\n  display: grid;\n  grid-template-columns: var(--dimension-menu-width-xs) var(--dimension-menu-width-sm);\n  min-height: calc(var(--dimension-size-800) * 4 + var(--dimension-space-150));\n  max-height: calc(100vh - var(--dimension-size-800) - var(--dimension-size-600));\n}\n\n.filter-menu__category-pane {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex-direction: column;\n  border-inline-end: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n}\n\n.filter-menu__categories {\n  flex: 1 1 auto;\n  min-width: 0;\n}\n\n.filter-menu__category-section {\n  display: flex;\n  min-width: 0;\n  flex-direction: column;\n}\n\n.filter-menu__category-section.ds-choice-section--divided {\n  padding-block-end: var(--dimension-space-050);\n}\n\n.filter-menu__category {\n  justify-content: space-between;\n  width: 100%;\n  border: 0;\n  background: transparent;\n  color: var(--color-foreground-secondary);\n  cursor: default;\n  text-align: start;\n}\n\n.filter-menu__category--active {\n  color: var(--color-foreground-primary);\n}\n\n.filter-menu__category-dot-box {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  flex-shrink: 0;\n  width: var(--ds-control-icon, var(--dimension-iconography-md));\n  height: var(--ds-control-icon, var(--dimension-iconography-md));\n  pointer-events: none;\n}\n\n.filter-menu__options {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex-direction: column;\n  overflow: hidden;\n}\n\n.filter-menu__options-content {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex: 1 1 auto;\n  flex-direction: column;\n  overflow: auto;\n}\n\n.filter-menu__option-search {\n  position: relative;\n  flex: 0 0 var(--dimension-size-500);\n  min-width: 0;\n  min-height: var(--dimension-size-500);\n  background: transparent;\n}\n\n.filter-menu__option-search::after {\n  content: '';\n  position: absolute;\n  inset: auto 0 0;\n  height: var(--dimension-stroke-width-012);\n  background-color: var(--color-border-tertiary);\n  pointer-events: none;\n}\n\n.filter-menu__option-search .select-search {\n  height: 100%;\n  background: transparent;\n}\n\n.filter-menu__options--date,\n.filter-menu__option-list--date,\n.filter-menu__date {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex-direction: column;\n}\n\n.filter-menu__option-list--date,\n.filter-menu__date {\n  flex: 1 1 auto;\n}\n\n.filter-menu__date-header {\n  flex: 0 0 var(--dimension-size-500);\n  justify-content: center;\n  min-block-size: var(--dimension-size-500);\n  padding: var(--dimension-space-050);\n  background: var(--color-background-secondary);\n}\n\n.filter-menu__date-body {\n  display: flex;\n  flex: 1 1 auto;\n  min-height: 0;\n  flex-direction: column;\n}\n\n.filter-menu__date-relative {\n  flex: 1 1 auto;\n}\n\n.filter-menu__date-body > ds-calendar {\n  flex: 1 1 auto;\n  min-width: 0;\n  min-height: 0;\n}\n\n.filter-menu__footer {\n  flex: 0 0 auto;\n}\n\n.filter-menu__footer--categories-clear .ds-choice-footer__content {\n  justify-content: flex-start;\n}\n\n.filter-menu__footer--categories-clear[aria-hidden='true']::before {\n  visibility: hidden;\n}\n\n.ds-choice-footer__content:has(.filter-menu__apply) {\n  column-gap: var(--dimension-space-100);\n}\n\n.filter-menu__apply ds-text {\n  padding-right: 0;\n}\n\n.filter-menu__action-separator + .filter-menu__clear ds-text {\n  padding-left: 0;\n}\n\n.filter-menu__apply {\n  color: var(--color-foreground-bold-brand);\n}\n\n.filter-menu__apply:disabled {\n  color: var(--color-foreground-tertiary);\n  text-decoration-line: none;\n}\n\n.filter-menu__clear {\n  --ds-text-action-foreground: var(--color-foreground-bold-negative);\n\n  color: var(--ds-text-action-foreground);\n}\n\n.filter-menu__match-mode-footer {\n  flex: 0 0 auto;\n}\n\n.filter-menu__match-mode-content {\n  justify-content: flex-start;\n  padding-inline: calc(\n    var(--dimension-space-050) + var(--ds-control-padding-inline, var(--dimension-space-075)) +\n      var(--ds-control-label-inset, var(--dimension-space-025))\n  );\n}\n\n.filter-menu__match-mode-toggle {\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: default;\n}\n\n@media (forced-colors: active) {\n  .filter-menu__category-pane {\n    border-inline-end-color: var(--ds-forced-color-content);\n  }\n}\n\n.data-preferences-embedded {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  min-height: 0;\n  color: var(--color-foreground-secondary);\n}\n\n.data-preferences-embedded .filter-menu__body {\n  grid-template-columns: min(var(--dimension-menu-width-xs), 40%) minmax(0, 1fr);\n}\n\n.filter-menu-vertical__section {\n  border-bottom: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n}\n.filter-menu-vertical__section > summary {\n  cursor: default;\n  padding: var(--dimension-space-200);\n}\n.filter-menu-vertical__section > summary ds-text {\n  display: inline;\n}\n\n.filter-menu-vertical__section > summary {\n  display: flex;\n  align-items: center;\n  gap: var(--dimension-space-100);\n  list-style: none;\n}\n.filter-menu-vertical__section > summary::-webkit-details-marker {\n  display: none;\n}\n.filter-menu-vertical__section:not([open]) .filter-menu-vertical__chevron {\n  transform: rotate(-90deg);\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/FilterMenu/FilterMenu.tsx",
-      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Listen,\n  Prop,\n  State,\n  type VNode,\n  Watch,\n} from '@stencil/core';\nimport {\n  CONTROL_TEXT_VARIANT,\n  DATE_FILTER_RELATIVE_PRESETS,\n  controlWidthClass,\n  dateFilterRelativeValue,\n  parseDateFilterValue,\n  resolveChoicePopupAlignOffset,\n  resolveCssLengthPx,\n  resolveMotionTimeMs,\n  TOKEN_CSS_LENGTHS,\n  TOKEN_DEFAULTS,\n  type ControlWidth,\n} from '../../utils';\nimport { observeTableCaptionCompact } from '../../utils/table-caption-compact';\nimport type { AnchoredAlign, AnchoredSide } from '../../utils/anchored-position';\nimport { AnchoredPositionController } from '../../utils/anchored-position-controller';\nimport { AnchoredOverlayInteractionController } from '../../utils/anchored-overlay-interaction-controller';\nimport { resolveAnchoredOverlayBoundaryRect } from '../../utils/anchored-overlay-boundary';\nimport { ChoiceOptionRow, ChoiceSearch } from '../../utils/choice-list-parts';\nimport { choiceListUsesSubtext } from '../../utils/choice-list';\n\nexport type FilterMenuFilterKind = 'single' | 'multiple' | 'boolean' | 'date';\nexport type FilterMenuSize = 'lg' | 'md' | 'sm' | 'xs';\nexport type FilterMenuWidth = ControlWidth;\nexport type FilterMenuFooterLayout = 'summary' | 'categories-clear';\nexport type FilterMenuMatchMode = 'any' | 'all';\ntype FilterMenuDateMode = 'range' | 'relative';\n\nexport interface FilterMenuOption {\n  label: string;\n  value: string;\n  description?: string;\n  isInactive?: boolean;\n}\n\nexport interface FilterMenuFilter {\n  id: string;\n  label: string;\n  kind: FilterMenuFilterKind;\n  options?: FilterMenuOption[];\n  description?: string;\n  fieldLabel?: string;\n  /** Draw a standard menu-section divider after this category. */\n  divider?: boolean;\n}\n\nexport type FilterMenuValue = string[] | boolean | string;\nexport type FilterMenuValues = Record<string, FilterMenuValue | undefined>;\nexport type FilterMenuMatchModes = Record<string, FilterMenuMatchMode | undefined>;\n\nexport interface FilterMenuChangeDetail {\n  filterId: string;\n  value: FilterMenuValue;\n}\n\nexport interface FilterMenuMatchModeChangeDetail {\n  filterId: string;\n  mode: FilterMenuMatchMode;\n}\n\nlet filterMenuId = 0;\n\nconst ICON_SIZE: Record<FilterMenuSize, 'lg' | 'md' | 'sm' | 'xs'> = {\n  lg: 'lg',\n  md: 'md',\n  sm: 'sm',\n  xs: 'xs',\n};\n\nconst DATE_MODE_TABS = [\n  { id: 'relative', label: 'Relative' },\n  { id: 'range', label: 'Range' },\n];\n\nconst RELATIVE_DATE_OPTIONS: FilterMenuOption[] = DATE_FILTER_RELATIVE_PRESETS.map(preset => ({\n  label: preset.label,\n  value: dateFilterRelativeValue(preset.value),\n}));\n\n@Component({\n  tag: 'ds-filter-menu',\n  styleUrl: 'FilterMenu.css',\n  scoped: true,\n})\nexport class FilterMenu {\n  @Element() el!: HTMLElement;\n\n  /** Controlled popup visibility. */\n  /** Render content inside a parent-owned surface; the parent owns dismissal and positioning. */\n  @Prop() embedded: boolean = false;\n  /** Stacked, collapsible sections for a configuration panel. */\n  @Prop() vertical: boolean = false;\n  @Prop({ mutable: true }) open: boolean = false;\n  /** Select trigger text. */\n  @Prop() triggerLabel: string = 'Filters';\n  /** Append the active-filter count to the visible trigger label. */\n  @Prop() showSelectedCount: boolean = true;\n  /** Optional select trigger prefix icon name. */\n  @Prop() icon: string | undefined = 'Filters';\n  /** Select trigger density. */\n  @Prop() size: FilterMenuSize = 'md';\n  /** Select trigger width fit. */\n  @Prop() width: FilterMenuWidth = 'hug';\n  /** Show the surface-aware inset border around the select trigger. */\n  /** Show the trigger chevron. */\n  @Prop() showIndicator: boolean = true;\n  @Prop() hasBorder: boolean = true;\n  /** Show selected interaction fill when one or more criteria are active. */\n  /** Keep trigger colors neutral when a value is selected. */\n  @Prop() neutralTrigger: boolean = false;\n  /** Stage filter edits until Apply is pressed. */\n  @Prop() applyRequired: boolean = false;\n  @State() private draftValues?: FilterMenuValues;\n  @State() private draftModes?: FilterMenuMatchModes;\n\n  private changeValue(detail: FilterMenuChangeDetail): void {\n    if (this.applyRequired)\n      this.draftValues = { ...(this.draftValues ?? this.values), [detail.filterId]: detail.value };\n    else this.dsChange.emit(detail);\n  }\n  private changeMode(detail: FilterMenuMatchModeChangeDetail): void {\n    if (this.applyRequired)\n      this.draftModes = { ...(this.draftModes ?? this.matchModes), [detail.filterId]: detail.mode };\n    else this.dsMatchModeChange.emit(detail);\n  }\n  private get hasPendingChanges(): boolean {\n    const normalize = (value: FilterMenuValue | undefined) =>\n      Array.isArray(value) ? (value.length ? [...value].sort() : undefined) : value || undefined;\n    const values = this.draftValues ?? this.values;\n    const modes = this.draftModes ?? this.matchModes;\n    return this.filters.some(\n      filter =>\n        JSON.stringify(normalize(values[filter.id])) !==\n          JSON.stringify(normalize(this.values[filter.id])) ||\n        (modes[filter.id] ?? 'any') !== (this.matchModes[filter.id] ?? 'any')\n    );\n  }\n  private applyDraft(): void {\n    if (!this.hasPendingChanges) return;\n    if (this.draftValues && Object.keys(this.draftValues).length === 0) {\n      this.dsClear.emit();\n    } else if (this.draftValues) {\n      for (const id of new Set([...Object.keys(this.values), ...Object.keys(this.draftValues)])) {\n        if (JSON.stringify(this.values[id]) !== JSON.stringify(this.draftValues[id]))\n          this.dsChange.emit({\n            filterId: id,\n            value:\n              this.draftValues[id] ??\n              (Array.isArray(this.values[id])\n                ? []\n                : typeof this.values[id] === 'boolean'\n                  ? false\n                  : ''),\n          });\n      }\n    }\n    if (this.draftModes) {\n      for (const filterId of new Set([\n        ...Object.keys(this.matchModes),\n        ...Object.keys(this.draftModes),\n      ])) {\n        const mode = this.draftModes[filterId] ?? 'any';\n        if ((this.matchModes[filterId] ?? 'any') !== mode)\n          this.dsMatchModeChange.emit({ filterId, mode });\n      }\n    }\n  }\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  /** ID applied to the internal select trigger. */\n  @Prop() inputId: string | undefined;\n  /** Direct accessible name for the internal select trigger. */\n  @Prop({ attribute: 'aria-label' }) ariaLabel: string | null = null;\n  /** Product-owned filter categories and option definitions. */\n  @Prop() filters: FilterMenuFilter[] = [];\n  /** Controlled values keyed by filter id. */\n  @Prop() values: FilterMenuValues = {};\n  /** Controlled any/all match mode keyed by multiple-choice filter id. Defaults to any. */\n  @Prop() matchModes: FilterMenuMatchModes = {};\n  /** Controlled category shown in the option pane. */\n  @Prop() activeFilterId: string | undefined;\n  /** External trigger element to position against. */\n  @Prop() anchor: HTMLElement | undefined;\n  /** ID of the external trigger element used for positioning and focus return. */\n  @Prop() anchorId: string | undefined;\n  /** Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used. */\n  @Prop() boundary: HTMLElement | undefined;\n  /** Preferred popup side; collision handling may flip it. */\n  @Prop() side: AnchoredSide = 'bottom';\n  /** Cross-axis alignment against the trigger. */\n  @Prop() align: AnchoredAlign = 'end';\n  /** Gap between trigger and popup — number in px or a TokoMo length. */\n  @Prop() sideOffset: number | string = TOKEN_CSS_LENGTHS.space050;\n  /** Cross-axis offset — number in px or a TokoMo length. */\n  @Prop() alignOffset: number | string = 0;\n  /** Popup width. It remains clamped to its collision boundary by the component recipe. */\n  @Prop() menuWidth: string = TOKEN_CSS_LENGTHS.menuWidthLg;\n  /** Accessible name for the non-modal filter dialog. */\n  @Prop() menuLabel: string = 'Filters';\n  /** Accessible name for the category tab list. */\n  @Prop() categoriesLabel: string = 'Filter categories';\n  /** Footer action and date-clear accessible label. */\n  @Prop() clearLabel: string = 'Clear';\n  /** Placeholder shown in each non-date option search header. */\n  @Prop() searchPlaceholder: string = 'Search';\n  /** Empty-state text shown when an option search has no matches. */\n  @Prop() noResultsText: string = 'No results';\n  /** Footer recipe: full-width selected summary or reserved category-pane Clear action. */\n  @Prop() footerLayout: FilterMenuFooterLayout = 'summary';\n  /** Show a visible focus ring on initial entry after keyboard activation. */\n  @Prop() initialFocusVisible: boolean = false;\n\n  @State() private shouldRender = false;\n  @State() private closing = false;\n  @State() private positionReady = false;\n  @State() private pos: { x: number; y: number } = { x: 0, y: 0 };\n  @State() private focusRingVisible = false;\n  @State() private activeOptionIndex = 0;\n  @State() private captionCompact = false;\n  @State() private dateModeByFilter: Record<string, FilterMenuDateMode> = {};\n  @State() private optionQueryByFilter: Record<string, string> = {};\n\n  /** Requests a controlled value replacement without closing the popup. */\n  @Event() dsChange!: EventEmitter<FilterMenuChangeDetail>;\n  /** Requests that the consumer clear every filter value. */\n  @Event() dsClear!: EventEmitter<void>;\n  /** Requests a controlled any/all mode replacement for a multiple-choice filter. */\n  @Event() dsMatchModeChange!: EventEmitter<FilterMenuMatchModeChangeDetail>;\n  /** Requests a controlled active-category replacement. */\n  @Event() dsActiveFilterChange!: EventEmitter<string>;\n  /** Requests that the controlled popup close. */\n  @Event() dsClose!: EventEmitter<void>;\n  /** Emitted whenever internal select-trigger activation changes popup visibility. */\n  @Event() dsOpenChange!: EventEmitter<boolean>;\n  /** Emitted after exit motion and rendered popup removal complete. */\n  @Event() dsAfterClose!: EventEmitter<void>;\n\n  private readonly generatedId = `ds-filter-menu-${++filterMenuId}`;\n  private triggerElement: HTMLButtonElement | null = null;\n  private pendingInitialFocusVisible = false;\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  private captionCompactDisconnect: (() => void) | undefined;\n  private hasLoaded = false;\n  private closingSnapshot: {\n    filters: FilterMenuFilter[];\n    values: FilterMenuValues;\n    matchModes: FilterMenuMatchModes;\n    activeFilterId: string | undefined;\n  } | null = null;\n\n  private readonly position = new AnchoredPositionController({\n    getAnchor: () => this.resolvedAnchor,\n    getPopup: () => this.el.querySelector<HTMLElement>('.filter-menu-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    measure: (anchor, popup) => {\n      if (!this.open) return null;\n      const anchorRect = anchor.getBoundingClientRect();\n      const sectionInsetPx = resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050);\n      return {\n        anchorRect,\n        popupWidth: popup.offsetWidth || this.popupFallbackWidth,\n        popupHeight: popup.offsetHeight || this.popupFallbackHeight,\n        side: this.side,\n        align: this.align,\n        sideOffsetPx: resolveCssLengthPx(this.sideOffset, TOKEN_DEFAULTS.space050),\n        alignOffsetPx: resolveChoicePopupAlignOffset({\n          align: this.align,\n          alignOffsetPx: resolveCssLengthPx(this.alignOffset, 0),\n          sectionInsetPx,\n        }),\n        viewportPadPx: this.viewportPad,\n        viewportWidth: window.innerWidth,\n        viewportHeight: window.innerHeight,\n        collisionRect: resolveAnchoredOverlayBoundaryRect(anchor, this.boundary),\n      };\n    },\n    apply: ({ x, y }) => {\n      this.pos = { x, y };\n    },\n    onReady: () => {\n      this.positionReady = true;\n    },\n    liveUpdate: 'double-frame',\n    observeResize: true,\n    topLayer: true,\n  });\n  private readonly interaction = new AnchoredOverlayInteractionController({\n    getAnchor: () => this.resolvedAnchor,\n    getPopup: () => this.el.querySelector<HTMLElement>('.filter-menu-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    onOutsideActivation: () => this.close(),\n  });\n\n  componentDidLoad() {\n    this.hasLoaded = true;\n    this.syncCaptionCompactObserver();\n    if (this.open) this.onOpenChange(true);\n  }\n\n  connectedCallback() {\n    if (!this.hasLoaded) return;\n    this.syncCaptionCompactObserver();\n    if (this.open) this.onOpenChange(true);\n  }\n\n  disconnectedCallback() {\n    this.disconnectCaptionCompactObserver();\n    this.position.unobserve();\n    this.teardownListeners();\n  }\n\n  @Watch('collapseLabel')\n  onCollapseLabelChange() {\n    this.syncCaptionCompactObserver();\n  }\n\n  @Watch('open')\n  onOpenChange(isOpen: boolean) {\n    if (!isOpen) {\n      this.draftValues = undefined;\n      this.draftModes = undefined;\n    }\n    if (this.embedded) return;\n    if (isOpen) {\n      this.teardownListeners();\n      this.closingSnapshot = null;\n      this.shouldRender = true;\n      this.closing = false;\n      this.positionReady = false;\n      this.focusRingVisible = this.pendingInitialFocusVisible || this.initialFocusVisible;\n      this.setupListeners();\n      this.position.schedule(() => this.focusInitialCategory());\n      return;\n    }\n\n    if (!this.shouldRender) return;\n    this.position.cancel();\n    this.captureClosingSnapshot();\n    this.closing = true;\n    this.teardownListeners();\n    const duration = resolveMotionTimeMs(\n      TOKEN_DEFAULTS.motionShort2,\n      TOKEN_DEFAULTS.animationDurationShort3\n    );\n    if (duration <= 0) {\n      this.finishClose();\n      return;\n    }\n    this.closeTimer = setTimeout(() => this.finishClose(), duration);\n  }\n\n  @Watch('anchor')\n  @Watch('anchorId')\n  @Watch('boundary')\n  @Watch('side')\n  @Watch('align')\n  @Watch('sideOffset')\n  @Watch('alignOffset')\n  @Watch('menuWidth')\n  onPositionInputChange() {\n    if (this.open) this.position.schedule();\n  }\n\n  @Listen('keydown')\n  handleKeyDown(event: KeyboardEvent) {\n    if (this.embedded && (event.key === 'Escape' || event.key === 'Tab')) return;\n    if ((!this.shouldRender && !this.embedded) || this.closing) return;\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      this.close();\n      return;\n    }\n    if (event.key !== 'Tab' || !this.tabLeavesPopup(event)) return;\n    event.preventDefault();\n    this.close(false);\n    this.interaction.moveFocusAfterTab(event.shiftKey);\n  }\n\n  private get resolvedAnchor(): HTMLElement | null {\n    if (this.anchor) return this.anchor;\n    if (this.anchorId) return document.getElementById(this.anchorId);\n    return this.triggerElement;\n  }\n\n  private get usesInternalTrigger(): boolean {\n    return !this.embedded && !this.anchor && !this.anchorId;\n  }\n\n  private get viewportPad(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050);\n  }\n\n  private get popupFallbackWidth(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuWidthLg, TOKEN_DEFAULTS.menuWidthLg);\n  }\n\n  private get popupFallbackHeight(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuFallbackHeight, TOKEN_DEFAULTS.menuFallbackHeight);\n  }\n\n  private setupListeners() {\n    this.interaction.connect();\n    this.position.observe();\n  }\n\n  private teardownListeners() {\n    this.position.unobserve();\n    this.interaction.disconnect();\n    if (this.closeTimer) {\n      clearTimeout(this.closeTimer);\n      this.closeTimer = null;\n    }\n  }\n\n  private close(restoreFocus = true) {\n    this.captureClosingSnapshot();\n    if (restoreFocus) this.interaction.focusAnchor();\n    this.dsOpenChange.emit(false);\n    this.dsClose.emit();\n    this.open = false;\n    this.onOpenChange(false);\n  }\n\n  private toggleFromTrigger(event: MouseEvent) {\n    if (this.open) {\n      this.close();\n      return;\n    }\n    this.pendingInitialFocusVisible = event.detail === 0;\n    this.open = true;\n    this.dsOpenChange.emit(true);\n    this.onOpenChange(true);\n  }\n\n  private handleTriggerKeyDown(event: KeyboardEvent) {\n    if (event.key !== 'ArrowDown' || this.open) return;\n    event.preventDefault();\n    this.pendingInitialFocusVisible = true;\n    this.open = true;\n    this.dsOpenChange.emit(true);\n    this.onOpenChange(true);\n  }\n\n  private finishClose() {\n    const popup = this.el.querySelector<HTMLElement>('.filter-menu-popup');\n    if (popup?.matches(':popover-open')) popup.hidePopover();\n    this.shouldRender = false;\n    this.closing = false;\n    this.closingSnapshot = null;\n    this.closeTimer = null;\n    this.dateModeByFilter = {};\n    this.optionQueryByFilter = {};\n    this.dsAfterClose.emit();\n  }\n\n  private captureClosingSnapshot() {\n    if (this.closingSnapshot) return;\n    this.closingSnapshot = {\n      filters: this.filters.map(filter => ({\n        ...filter,\n        options: filter.options?.map(option => ({ ...option })),\n      })),\n      values: Object.fromEntries(\n        Object.entries(this.values).map(([key, value]) => [\n          key,\n          Array.isArray(value) ? [...value] : value,\n        ])\n      ),\n      matchModes: { ...this.matchModes },\n      activeFilterId: this.activeFilterId,\n    };\n  }\n\n  private focusInitialCategory() {\n    requestAnimationFrame(() => {\n      this.el.querySelector<HTMLElement>('.filter-menu__category[tabindex=\"0\"]')?.focus();\n      this.pendingInitialFocusVisible = false;\n    });\n  }\n\n  private tabLeavesPopup(event: KeyboardEvent): boolean {\n    return this.interaction.tabLeavesPopup(event);\n  }\n\n  private selectedFilter(filters: FilterMenuFilter[], activeFilterId: string | undefined) {\n    return filters.find(filter => filter.id === activeFilterId) ?? filters[0];\n  }\n\n  private selectedCount(filter: FilterMenuFilter, values: FilterMenuValues): number {\n    const value = values[filter.id];\n    if (filter.kind === 'multiple') return Array.isArray(value) ? value.length : 0;\n    if (filter.kind === 'boolean') return value === true ? 1 : 0;\n    return typeof value === 'string' && value.length > 0 ? 1 : 0;\n  }\n\n  private totalSelected(filters: FilterMenuFilter[], values: FilterMenuValues): number {\n    return filters.reduce((total, filter) => total + this.selectedCount(filter, values), 0);\n  }\n\n  private activeFilterCount(filters: FilterMenuFilter[], values: FilterMenuValues): number {\n    return filters.filter(filter => this.selectedCount(filter, values) > 0).length;\n  }\n\n  private selectCategory(filterId: string, focus = false) {\n    this.activeOptionIndex = 0;\n    this.dsActiveFilterChange.emit(filterId);\n    if (!focus) return;\n    requestAnimationFrame(() => {\n      this.el.querySelector<HTMLElement>(`[data-filter-category=\"${filterId}\"]`)?.focus();\n    });\n  }\n\n  private handleCategoryKeyDown(\n    event: KeyboardEvent,\n    filters: FilterMenuFilter[],\n    filterId: string\n  ) {\n    const currentIndex = filters.findIndex(filter => filter.id === filterId);\n    let nextIndex: number;\n    if (event.key === 'ArrowDown') nextIndex = (currentIndex + 1) % filters.length;\n    else if (event.key === 'ArrowUp')\n      nextIndex = (currentIndex - 1 + filters.length) % filters.length;\n    else if (event.key === 'Home') nextIndex = 0;\n    else if (event.key === 'End') nextIndex = filters.length - 1;\n    else if (event.key === 'ArrowRight') {\n      event.preventDefault();\n      requestAnimationFrame(() => {\n        this.el\n          .querySelector<HTMLElement>(\n            '.filter-menu__options [role=\"option\"], .filter-menu__options [data-date-option], .filter-menu__options input'\n          )\n          ?.focus();\n      });\n      return;\n    } else return;\n\n    event.preventDefault();\n    this.focusRingVisible = true;\n    this.selectCategory(filters[nextIndex].id, true);\n  }\n\n  private handlePanelKeyDown(event: KeyboardEvent, filterId: string) {\n    if (event.key !== 'ArrowLeft') return;\n    event.preventDefault();\n    this.el.querySelector<HTMLElement>(`[data-filter-category=\"${filterId}\"]`)?.focus();\n  }\n\n  private handleOptionKeyDown(\n    event: KeyboardEvent,\n    filter: FilterMenuFilter,\n    option: FilterMenuOption,\n    index: number,\n    values: FilterMenuValues,\n    visibleOptions: FilterMenuOption[] = filter.options ?? []\n  ) {\n    if (event.key === 'ArrowLeft') {\n      this.handlePanelKeyDown(event, filter.id);\n      return;\n    }\n    if (event.key === 'Enter' || event.key === ' ') {\n      event.preventDefault();\n      this.selectOption(filter, option, values);\n      return;\n    }\n    if (!['ArrowDown', 'ArrowUp', 'Home', 'End'].includes(event.key)) return;\n    event.preventDefault();\n    const enabled = visibleOptions\n      .map((candidate, optionIndex) => ({ candidate, optionIndex }))\n      .filter(({ candidate }) => !candidate.isInactive)\n      .map(({ optionIndex }) => optionIndex);\n    if (!enabled.length) return;\n    const current = enabled.indexOf(index);\n    let next: number;\n    if (event.key === 'Home') next = enabled[0];\n    else if (event.key === 'End') next = enabled[enabled.length - 1];\n    else {\n      const direction = event.key === 'ArrowDown' ? 1 : -1;\n      const start = current >= 0 ? current : direction === 1 ? -1 : 0;\n      next = enabled[(start + direction + enabled.length) % enabled.length];\n    }\n    this.activeOptionIndex = next;\n    this.focusRingVisible = true;\n    requestAnimationFrame(() => {\n      this.el\n        .querySelector<HTMLElement>(`#${this.generatedId}-${filter.id}-option-${next}`)\n        ?.focus();\n    });\n  }\n\n  private optionMatchesQuery(option: FilterMenuOption, query: string): boolean {\n    const normalized = query.trim().toLocaleLowerCase();\n    if (!normalized) return true;\n    return `${option.label} ${option.description ?? ''}`.toLocaleLowerCase().includes(normalized);\n  }\n\n  private visibleOptions(\n    filter: FilterMenuFilter,\n    query = this.optionQueryByFilter[filter.id] ?? ''\n  ) {\n    if (filter.kind === 'boolean') {\n      const option = this.booleanOption(filter);\n      return this.optionMatchesQuery(option, query) ? [option] : [];\n    }\n    return (filter.options ?? []).filter(option => this.optionMatchesQuery(option, query));\n  }\n\n  private booleanOption(filter: FilterMenuFilter): FilterMenuOption {\n    return {\n      label: filter.fieldLabel ?? filter.label,\n      value: 'true',\n      description: filter.description,\n    };\n  }\n\n  private setOptionQuery(filter: FilterMenuFilter, value: string) {\n    const visibleOptions = this.visibleOptions(filter, value);\n    const firstEnabled = visibleOptions.findIndex(option => !option.isInactive);\n    this.activeOptionIndex = firstEnabled;\n    this.focusRingVisible = false;\n    this.optionQueryByFilter = { ...this.optionQueryByFilter, [filter.id]: value };\n    requestAnimationFrame(() => {\n      const content = this.el.querySelector<HTMLElement>('.filter-menu__options-content');\n      if (content) content.scrollTop = 0;\n      this.position.schedule();\n    });\n  }\n\n  private handleOptionSearchKeyDown(event: KeyboardEvent, filter: FilterMenuFilter) {\n    if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp') return;\n    const visibleOptions = this.visibleOptions(filter);\n    const enabled = visibleOptions\n      .map((option, index) => ({ option, index }))\n      .filter(({ option }) => !option.isInactive)\n      .map(({ index }) => index);\n    if (!enabled.length) return;\n    event.preventDefault();\n    const next = event.key === 'ArrowDown' ? enabled[0] : enabled[enabled.length - 1];\n    this.activeOptionIndex = next;\n    this.focusRingVisible = true;\n    requestAnimationFrame(() => {\n      this.el\n        .querySelector<HTMLElement>(`#${this.generatedId}-${filter.id}-option-${next}`)\n        ?.focus();\n    });\n  }\n\n  private toggleMultiple(\n    filter: FilterMenuFilter,\n    option: FilterMenuOption,\n    checked: boolean,\n    values: FilterMenuValues\n  ) {\n    if (option.isInactive) return;\n    const current = Array.isArray(values[filter.id]) ? (values[filter.id] as string[]) : [];\n    const selected = new Set(current);\n    if (checked) selected.add(option.value);\n    else selected.delete(option.value);\n    const ordered = (filter.options ?? [])\n      .map(candidate => candidate.value)\n      .filter(value => selected.has(value));\n    this.changeValue({ filterId: filter.id, value: ordered });\n  }\n\n  private selectOption(\n    filter: FilterMenuFilter,\n    option: FilterMenuOption,\n    values: FilterMenuValues\n  ) {\n    if (option.isInactive) return;\n    if (filter.kind === 'single') {\n      this.changeValue({ filterId: filter.id, value: option.value });\n      return;\n    }\n    const selected = Array.isArray(values[filter.id])\n      ? (values[filter.id] as string[]).includes(option.value)\n      : false;\n    this.toggleMultiple(filter, option, !selected, values);\n  }\n\n  private dateMode(filterId: string, value: FilterMenuValue | undefined): FilterMenuDateMode {\n    return this.dateModeByFilter[filterId] ?? parseDateFilterValue(value)?.kind ?? 'relative';\n  }\n\n  private setDateMode(filter: FilterMenuFilter, mode: string) {\n    if (mode !== 'range' && mode !== 'relative') return;\n    this.dateModeByFilter = { ...this.dateModeByFilter, [filter.id]: mode };\n    this.activeOptionIndex = 0;\n  }\n\n  private renderRelativeDateOptions(filter: FilterMenuFilter, value: FilterMenuValue | undefined) {\n    const relativeFilter: FilterMenuFilter = {\n      ...filter,\n      kind: 'single',\n      options: RELATIVE_DATE_OPTIONS,\n    };\n    return (\n      <div\n        class=\"filter-menu__date-relative ds-choice-list ds-chrome-column ds-chrome-space--sm\"\n        role=\"listbox\"\n        aria-label=\"Relative date\"\n      >\n        {RELATIVE_DATE_OPTIONS.map((option, index) => (\n          <ChoiceOptionRow\n            size=\"md\"\n            id={`${this.generatedId}-${filter.id}-relative-${index}`}\n            option={option}\n            selected={value === option.value}\n            active={index === this.activeOptionIndex}\n            focusRingVisible={this.focusRingVisible}\n            usesSubtext={false}\n            tabIndex={index === this.activeOptionIndex ? 0 : -1}\n            onFocus={() => {\n              this.activeOptionIndex = index;\n            }}\n            onKeyDown={(event: KeyboardEvent) =>\n              this.handleOptionKeyDown(event, relativeFilter, option, index, {\n                [filter.id]: value,\n              })\n            }\n            onHover={() => {\n              this.focusRingVisible = false;\n              this.activeOptionIndex = index;\n            }}\n            onSelect={() => this.changeValue({ filterId: filter.id, value: option.value })}\n          />\n        ))}\n      </div>\n    );\n  }\n\n  private renderDateCalendar(filter: FilterMenuFilter, value: FilterMenuValue | undefined) {\n    return (\n      <ds-calendar\n        selectionMode=\"range\"\n        value={typeof value === 'string' ? value : ''}\n        onDsChange={(event: CustomEvent<string>) => {\n          event.stopPropagation();\n          this.changeValue({ filterId: filter.id, value: event.detail });\n        }}\n      />\n    );\n  }\n\n  private renderDateFilter(filter: FilterMenuFilter, value: FilterMenuValue | undefined) {\n    const mode = this.dateMode(filter.id, value);\n    return (\n      <div class=\"filter-menu__date\">\n        <header class=\"filter-menu__date-header ds-chrome-header ds-chrome-header--bounded\">\n          <ds-tab-group\n            ariaLabel=\"Date filter mode\"\n            size=\"md\"\n            width=\"fill\"\n            hasContainer={false}\n            value={mode}\n            tabs={DATE_MODE_TABS}\n            onDsChange={(event: CustomEvent<string>) => {\n              event.stopPropagation();\n              this.setDateMode(filter, event.detail);\n            }}\n          />\n        </header>\n        <div class=\"filter-menu__date-body\">\n          {mode === 'relative'\n            ? this.renderRelativeDateOptions(filter, value)\n            : this.renderDateCalendar(filter, value)}\n        </div>\n      </div>\n    );\n  }\n\n  private renderOptionSearch(filter: FilterMenuFilter) {\n    return (\n      <div class=\"filter-menu__option-search\">\n        <ChoiceSearch\n          size=\"md\"\n          hasFocusBoundary={false}\n          hasInteractionFill={false}\n          value={this.optionQueryByFilter[filter.id] ?? ''}\n          placeholder={this.searchPlaceholder}\n          ariaLabel={`Search ${filter.label} options`}\n          controls={`${this.generatedId}-${filter.id}-options`}\n          inputRef={() => undefined}\n          clearLabel={`Clear ${filter.label} search`}\n          onValueChange={value => this.setOptionQuery(filter, value)}\n          onKeyDown={(event: KeyboardEvent) => this.handleOptionSearchKeyDown(event, filter)}\n        />\n      </div>\n    );\n  }\n\n  private renderNoOptionResults() {\n    return (\n      <div\n        class=\"ds-choice-empty ds-empty-region\"\n        role=\"option\"\n        aria-selected=\"false\"\n        aria-disabled=\"true\"\n        aria-label={this.noResultsText}\n        aria-live=\"polite\"\n      >\n        <ds-empty-state body={this.noResultsText} />\n      </div>\n    );\n  }\n\n  private renderOptions(filter: FilterMenuFilter, values: FilterMenuValues) {\n    const value = values[filter.id];\n    if (filter.kind === 'multiple' || filter.kind === 'single') {\n      const selected = Array.isArray(value) ? value : [];\n      const allOptions = filter.options ?? [];\n      const options = this.visibleOptions(filter);\n      const usesSubtext = choiceListUsesSubtext(\n        allOptions.map(option => ({\n          label: option.label,\n          value: option.value,\n          subtext: option.description,\n        }))\n      );\n      if (!options.length) return this.renderNoOptionResults();\n      return options.map((option, index) => {\n        const isSelected =\n          filter.kind === 'multiple' ? selected.includes(option.value) : value === option.value;\n        return (\n          <ChoiceOptionRow\n            size=\"md\"\n            id={`${this.generatedId}-${filter.id}-option-${index}`}\n            option={{\n              label: option.label,\n              value: option.value,\n              subtext: option.description,\n              isInactive: option.isInactive,\n            }}\n            selected={isSelected}\n            active={index === this.activeOptionIndex}\n            focusRingVisible={this.focusRingVisible}\n            usesSubtext={usesSubtext}\n            tabIndex={index === this.activeOptionIndex ? 0 : -1}\n            leading={\n              filter.kind === '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 label=\"\" size=\"md\" checked={isSelected} presentation />\n                </span>\n              ) : undefined\n            }\n            onFocus={() => {\n              this.activeOptionIndex = index;\n            }}\n            onKeyDown={(event: KeyboardEvent) =>\n              this.handleOptionKeyDown(event, filter, option, index, values, options)\n            }\n            onHover={() => {\n              this.focusRingVisible = false;\n              this.activeOptionIndex = index;\n            }}\n            onSelect={() => this.selectOption(filter, option, values)}\n          />\n        );\n      });\n    }\n\n    if (filter.kind === 'boolean') {\n      const [option] = this.visibleOptions(filter);\n      if (!option) return this.renderNoOptionResults();\n      return (\n        <ChoiceOptionRow\n          size=\"md\"\n          id={`${this.generatedId}-${filter.id}-option-0`}\n          option={{\n            label: option.label,\n            value: option.value,\n            subtext: option.description,\n          }}\n          selected={value === true}\n          active\n          focusRingVisible={this.focusRingVisible}\n          usesSubtext={Boolean(option.description)}\n          tabIndex={0}\n          leading={\n            <span\n              class=\"ds-choice-item__icon ds-control-icon-box ds-interaction-fill__content\"\n              aria-hidden=\"true\"\n            >\n              <ds-checkbox label=\"\" size=\"md\" checked={value === true} presentation />\n            </span>\n          }\n          onKeyDown={(event: KeyboardEvent) => {\n            if (event.key === 'ArrowLeft') this.handlePanelKeyDown(event, filter.id);\n            else if (event.key === 'Enter' || event.key === ' ') {\n              event.preventDefault();\n              this.changeValue({ filterId: filter.id, value: value !== true });\n            }\n          }}\n          onHover={() => {\n            this.focusRingVisible = false;\n          }}\n          onSelect={() => this.changeValue({ filterId: filter.id, value: value !== true })}\n        />\n      );\n    }\n\n    return this.renderDateFilter(filter, value);\n  }\n\n  private get captionIconOnly(): boolean {\n    return (\n      this.collapseLabel && this.captionCompact && this.usesInternalTrigger && Boolean(this.icon)\n    );\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  private renderFooter(totalSelected: number, categoriesClear: boolean) {\n    const appliedCount = this.totalSelected(this.filters, this.values);\n    if (this.applyRequired && totalSelected === 0 && appliedCount === 0) return null;\n    return (\n      <div\n        class={{\n          'filter-menu__footer': true,\n          'filter-menu__footer--categories-clear': categoriesClear,\n          'ds-choice-footer': true,\n        }}\n        aria-hidden={\n          !this.applyRequired &&\n          categoriesClear &&\n          totalSelected === 0 &&\n          !this.draftValues &&\n          !this.draftModes\n            ? 'true'\n            : undefined\n        }\n      >\n        <div class=\"ds-choice-footer__content ds-control--md\">\n          {!categoriesClear ? (\n            <ds-text\n              class=\"ds-choice-footer__summary\"\n              as=\"span\"\n              variant=\"text-body-medium\"\n              color=\"secondary\"\n              aria-live=\"polite\"\n            >\n              {totalSelected} selected\n            </ds-text>\n          ) : null}\n          {this.applyRequired ? (\n            <button\n              class=\"filter-menu__apply ds-choice-footer__clear ds-text-action\"\n              type=\"button\"\n              disabled={!this.hasPendingChanges}\n              onClick={() => this.applyDraft()}\n            >\n              <ds-text as=\"span\" variant=\"text-body-medium\" color=\"inherit\">\n                Apply\n              </ds-text>\n            </button>\n          ) : null}\n          {this.applyRequired && (totalSelected > 0 || appliedCount > 0) ? (\n            <ds-text\n              class=\"filter-menu__action-separator\"\n              as=\"span\"\n              variant=\"text-body-medium\"\n              color=\"tertiary\"\n              aria-hidden=\"true\"\n            >\n              ·\n            </ds-text>\n          ) : null}\n          {totalSelected > 0 || (this.applyRequired && appliedCount > 0) ? (\n            <button\n              class=\"filter-menu__clear ds-choice-footer__clear ds-text-action\"\n              type=\"button\"\n              onClick={() => {\n                if (this.applyRequired) {\n                  this.draftValues = {};\n                  this.draftModes = {};\n                }\n                this.dsClear.emit();\n              }}\n            >\n              <ds-text as=\"span\" variant=\"text-body-medium\" color=\"inherit\">\n                {this.clearLabel}\n              </ds-text>\n            </button>\n          ) : null}\n        </div>\n      </div>\n    );\n  }\n\n  private renderMatchModeFooter(filter: FilterMenuFilter, matchModes: FilterMenuMatchModes) {\n    const mode: FilterMenuMatchMode = matchModes[filter.id] === 'all' ? 'all' : 'any';\n    const nextMode: FilterMenuMatchMode = mode === 'any' ? 'all' : 'any';\n    return (\n      <div class=\"filter-menu__match-mode-footer ds-choice-footer\">\n        <div class=\"filter-menu__match-mode-content ds-choice-footer__content ds-control--md\">\n          <ds-text as=\"span\" variant=\"text-body-medium\" color=\"secondary\">\n            Limit results to\n          </ds-text>\n          <button\n            class=\"filter-menu__match-mode-toggle ds-text-action ds-focus-ring\"\n            type=\"button\"\n            aria-label={`Limit ${filter.label} results to ${nextMode} selected`}\n            onClick={() => this.changeMode({ filterId: filter.id, mode: nextMode })}\n            onKeyDown={(event: KeyboardEvent) => this.handlePanelKeyDown(event, filter.id)}\n          >\n            <ds-text as=\"span\" variant=\"text-body-medium\" color=\"inherit\">\n              {mode}\n            </ds-text>\n          </button>\n          <ds-text as=\"span\" variant=\"text-body-medium\" color=\"secondary\">\n            selected\n          </ds-text>\n        </div>\n      </div>\n    );\n  }\n\n  render() {\n    if (this.vertical)\n      return (\n        <Host class=\"filter-menu-vertical\">\n          {this.filters.map(filter => (\n            <details open key={filter.id} class=\"filter-menu-vertical__section\">\n              <summary>\n                <ds-icon class=\"filter-menu-vertical__chevron\" name=\"ChevronDown\" size=\"md\" />\n                <ds-text variant=\"text-body-medium\" emphasis>\n                  {filter.label}\n                </ds-text>\n              </summary>\n              {filter.kind !== 'date' && this.renderOptionSearch(filter)}\n              <div\n                id={`${this.generatedId}-${filter.id}-options`}\n                role={filter.kind === 'date' ? undefined : 'listbox'}\n                aria-label={filter.label}\n                aria-multiselectable={filter.kind === 'multiple' ? 'true' : undefined}\n                class=\"ds-choice-list ds-chrome-column ds-chrome-space--sm\"\n              >\n                {this.renderOptions(filter, this.values)}\n              </div>\n              {filter.kind === 'multiple' && this.renderMatchModeFooter(filter, this.matchModes)}\n            </details>\n          ))}\n        </Host>\n      );\n    const state =\n      this.closing && this.closingSnapshot\n        ? this.closingSnapshot\n        : {\n            filters: this.filters,\n            values: this.draftValues ?? this.values,\n            matchModes: this.draftModes ?? this.matchModes,\n            activeFilterId: this.activeFilterId,\n          };\n    const activeFilter = this.selectedFilter(state.filters, state.activeFilterId);\n    const totalSelected = this.totalSelected(state.filters, state.values);\n    const activeFilterCount = this.activeFilterCount(state.filters, state.values);\n    const hasActiveFilters = activeFilterCount > 0;\n    const categoriesClearFooter = this.footerLayout === 'categories-clear';\n    const label = `${this.triggerLabel}${\n      this.showSelectedCount && hasActiveFilters ? ` · ${activeFilterCount}` : ''\n    }`;\n    const textVariant = CONTROL_TEXT_VARIANT[this.size];\n    const iconSize = ICON_SIZE[this.size];\n    const popupId = `${this.generatedId}-popup`;\n    const popupStyle: Record<string, string> = {\n      position: 'fixed',\n      left: '0',\n      top: '0',\n      width: this.menuWidth,\n      transform: `translate(${Math.round(this.pos.x)}px, ${Math.round(this.pos.y)}px)`,\n      zIndex: '9998',\n      visibility: this.positionReady ? 'visible' : 'hidden',\n    };\n\n    return (\n      <Host\n        class={{\n          'filter-menu-host': true,\n          'filter-menu-host--external-trigger': !this.usesInternalTrigger,\n          'ds-select-trigger-host': this.usesInternalTrigger,\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        }}\n      >\n        {this.usesInternalTrigger\n          ? this.renderCaptionTooltip(\n              <button\n                ref={element => {\n                  this.triggerElement = (element as HTMLButtonElement) ?? null;\n                }}\n                id={this.inputId ?? `${this.generatedId}-trigger`}\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': this.activeFill && hasActiveFilters,\n                  'trigger--expanded': this.open || this.closing,\n                  'ds-interaction-fill--surface-open': this.open || this.closing,\n                  'trigger--bordered': this.hasBorder,\n                  'trigger--has-value': hasActiveFilters && !this.neutralTrigger,\n                  [`ds-control--${this.size}`]: true,\n                }}\n                role=\"combobox\"\n                aria-haspopup=\"dialog\"\n                aria-expanded={String(this.open)}\n                aria-controls={this.open ? popupId : undefined}\n                aria-label={this.ariaLabel ?? this.menuLabel}\n                onClick={(event: MouseEvent) => this.toggleFromTrigger(event)}\n                onKeyDown={(event: KeyboardEvent) => this.handleTriggerKeyDown(event)}\n              >\n                {this.icon ? (\n                  <span\n                    class=\"trigger__prefix ds-control-icon-box ds-interaction-fill__content\"\n                    aria-hidden=\"true\"\n                  >\n                    <ds-icon name={this.icon} size={iconSize} color=\"inherit\" />\n                  </span>\n                ) : null}\n                {this.captionIconOnly ? null : (\n                  <ds-text\n                    class=\"trigger__label-box trigger__label trigger__label-content ds-control-label-box ds-interaction-fill__content\"\n                    as=\"span\"\n                    variant={textVariant}\n                    color=\"inherit\"\n                    lineTruncation={1}\n                  >\n                    {label}\n                  </ds-text>\n                )}\n                {this.captionIconOnly || !this.showIndicator ? null : (\n                  <span\n                    class=\"trigger__chevron ds-control-icon-box ds-interaction-fill__content\"\n                    aria-hidden=\"true\"\n                  >\n                    <ds-icon name=\"ChevronDown\" size={iconSize} color=\"inherit\" />\n                  </span>\n                )}\n              </button>,\n              this.captionIconOnly ? label : ''\n            )\n          : null}\n\n        {this.shouldRender || this.embedded ? (\n          <div\n            id={popupId}\n            popover={this.embedded ? undefined : 'manual'}\n            class={{\n              'filter-menu-popup': true,\n              'ds-choice-popup': !this.embedded,\n              'table-preferences-embedded': this.embedded,\n              'ds-choice-popup--closing': this.closing,\n            }}\n            style={this.embedded ? undefined : popupStyle}\n            role=\"dialog\"\n            aria-label={this.menuLabel}\n          >\n            {activeFilter ? (\n              <div class=\"filter-menu\">\n                <div class=\"filter-menu__body\">\n                  <div class=\"filter-menu__category-pane\">\n                    <div\n                      class=\"filter-menu__categories ds-choice-list ds-chrome-column ds-chrome-space--sm\"\n                      role=\"tablist\"\n                      aria-label={this.categoriesLabel}\n                      aria-orientation=\"vertical\"\n                    >\n                      {state.filters.map(filter => {\n                        const active = filter.id === activeFilter.id;\n                        const count = this.selectedCount(filter, state.values);\n                        return (\n                          <div\n                            key={filter.id}\n                            class={{\n                              'filter-menu__category-section': true,\n                              'ds-choice-section--divided': Boolean(filter.divider),\n                            }}\n                          >\n                            <button\n                              id={`${this.generatedId}-${filter.id}-tab`}\n                              type=\"button\"\n                              role=\"tab\"\n                              data-filter-category={filter.id}\n                              class={{\n                                'filter-menu__category': true,\n                                'filter-menu__category--active': active,\n                                'ds-choice-item': true,\n                                'ds-control-frame': true,\n                                'ds-control--md': true,\n                                'ds-focus-ring-inset': true,\n                                'ds-focus-ring--visible': active && this.focusRingVisible,\n                                'ds-interaction-fill': true,\n                                'ds-interaction-fill--selected': active,\n                              }}\n                              aria-selected={String(active)}\n                              aria-controls={`${this.generatedId}-panel`}\n                              tabIndex={active ? 0 : -1}\n                              onMouseDown={() => {\n                                this.focusRingVisible = false;\n                              }}\n                              onClick={() => this.selectCategory(filter.id)}\n                              onKeyDown={(event: KeyboardEvent) =>\n                                this.handleCategoryKeyDown(event, state.filters, filter.id)\n                              }\n                            >\n                              <ds-text\n                                class=\"ds-choice-item__content ds-choice-item__label ds-control-label-box ds-interaction-fill__content\"\n                                as=\"span\"\n                                variant=\"text-body-medium\"\n                                color={active ? 'primary' : 'secondary'}\n                              >\n                                {filter.label}\n                              </ds-text>\n                              {count > 0 && filter.kind === 'date' ? (\n                                <span\n                                  class=\"filter-menu__category-dot-box ds-interaction-fill__content\"\n                                  aria-hidden=\"true\"\n                                >\n                                  <ds-badge variant=\"dot\" hasRing={false} label=\"\" />\n                                </span>\n                              ) : count > 0 ? (\n                                <ds-tag\n                                  class=\"ds-choice-item__tag ds-interaction-fill__content\"\n                                  label={String(count)}\n                                  size=\"sm\"\n                                  intent=\"brand\"\n                                  contrast=\"bold\"\n                                  isInset\n                                  rounded\n                                />\n                              ) : null}\n                            </button>\n                          </div>\n                        );\n                      })}\n                    </div>\n                    {categoriesClearFooter ? this.renderFooter(totalSelected, true) : null}\n                  </div>\n\n                  <div\n                    id={`${this.generatedId}-panel`}\n                    class={{\n                      'filter-menu__options': true,\n                      'filter-menu__options--date': activeFilter.kind === 'date',\n                    }}\n                    role=\"tabpanel\"\n                    aria-labelledby={`${this.generatedId}-${activeFilter.id}-tab`}\n                  >\n                    {activeFilter.kind === 'date' ? null : this.renderOptionSearch(activeFilter)}\n                    <div class=\"filter-menu__options-content\">\n                      {activeFilter.kind === 'date' ? (\n                        <div key={activeFilter.id} class=\"filter-menu__option-list--date\">\n                          {this.renderOptions(activeFilter, state.values)}\n                        </div>\n                      ) : (\n                        <div\n                          id={`${this.generatedId}-${activeFilter.id}-options`}\n                          key={activeFilter.id}\n                          class=\"filter-menu__option-list ds-choice-list ds-chrome-column ds-chrome-space--sm\"\n                          role=\"listbox\"\n                          aria-label={activeFilter.label}\n                          aria-multiselectable={\n                            activeFilter.kind === 'multiple' ? 'true' : undefined\n                          }\n                        >\n                          {this.renderOptions(activeFilter, state.values)}\n                        </div>\n                      )}\n                    </div>\n                    {activeFilter.kind === 'multiple'\n                      ? this.renderMatchModeFooter(activeFilter, state.matchModes)\n                      : null}\n                  </div>\n                </div>\n\n                {!categoriesClearFooter && totalSelected > 0\n                  ? this.renderFooter(totalSelected, false)\n                  : null}\n              </div>\n            ) : null}\n          </div>\n        ) : null}\n      </Host>\n    );\n  }\n}\n",
+      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Listen,\n  Prop,\n  State,\n  type VNode,\n  Watch,\n} from '@stencil/core';\nimport {\n  CONTROL_TEXT_VARIANT,\n  DATE_FILTER_RELATIVE_PRESETS,\n  controlWidthClass,\n  dateFilterRelativeValue,\n  parseDateFilterValue,\n  resolveChoicePopupAlignOffset,\n  resolveCssLengthPx,\n  resolveMotionTimeMs,\n  TOKEN_CSS_LENGTHS,\n  TOKEN_DEFAULTS,\n  type ControlWidth,\n} from '../../utils';\nimport { observeTableCaptionCompact } from '../../utils/table-caption-compact';\nimport type { AnchoredAlign, AnchoredSide } from '../../utils/anchored-position';\nimport { AnchoredPositionController } from '../../utils/anchored-position-controller';\nimport { AnchoredOverlayInteractionController } from '../../utils/anchored-overlay-interaction-controller';\nimport { resolveAnchoredOverlayBoundaryRect } from '../../utils/anchored-overlay-boundary';\nimport { ChoiceOptionRow, ChoiceSearch } from '../../utils/choice-list-parts';\nimport { choiceListUsesSubtext } from '../../utils/choice-list';\n\nexport type FilterMenuFilterKind = 'single' | 'multiple' | 'boolean' | 'date';\nexport type FilterMenuSize = 'lg' | 'md' | 'sm' | 'xs';\nexport type FilterMenuWidth = ControlWidth;\nexport type FilterMenuFooterLayout = 'summary' | 'categories-clear';\nexport type FilterMenuMatchMode = 'any' | 'all';\ntype FilterMenuDateMode = 'range' | 'relative';\n\nexport interface FilterMenuOption {\n  label: string;\n  value: string;\n  description?: string;\n  isInactive?: boolean;\n}\n\nexport interface FilterMenuFilter {\n  id: string;\n  label: string;\n  kind: FilterMenuFilterKind;\n  options?: FilterMenuOption[];\n  description?: string;\n  fieldLabel?: string;\n  /** Draw a standard menu-section divider after this category. */\n  divider?: boolean;\n}\n\nexport type FilterMenuValue = string[] | boolean | string;\nexport type FilterMenuValues = Record<string, FilterMenuValue | undefined>;\nexport type FilterMenuMatchModes = Record<string, FilterMenuMatchMode | undefined>;\n\nexport interface FilterMenuChangeDetail {\n  filterId: string;\n  value: FilterMenuValue;\n}\n\nexport interface FilterMenuMatchModeChangeDetail {\n  filterId: string;\n  mode: FilterMenuMatchMode;\n}\n\nlet filterMenuId = 0;\n\nconst ICON_SIZE: Record<FilterMenuSize, 'lg' | 'md' | 'sm' | 'xs'> = {\n  lg: 'lg',\n  md: 'md',\n  sm: 'sm',\n  xs: 'xs',\n};\n\nconst DATE_MODE_TABS = [\n  { id: 'relative', label: 'Relative' },\n  { id: 'range', label: 'Range' },\n];\n\nconst RELATIVE_DATE_OPTIONS: FilterMenuOption[] = DATE_FILTER_RELATIVE_PRESETS.map(preset => ({\n  label: preset.label,\n  value: dateFilterRelativeValue(preset.value),\n}));\n\n@Component({\n  tag: 'ds-filter-menu',\n  styleUrl: 'FilterMenu.css',\n  scoped: true,\n})\nexport class FilterMenu {\n  @Element() el!: HTMLElement;\n\n  /** Controlled popup visibility. */\n  /** Render content inside a parent-owned surface; the parent owns dismissal and positioning. */\n  @Prop() embedded: boolean = false;\n  /** Stacked, collapsible sections for a configuration panel. */\n  @Prop() vertical: boolean = false;\n  @Prop({ mutable: true }) open: boolean = false;\n  /** Select trigger text. */\n  @Prop() triggerLabel: string = 'Filters';\n  /** Append the active-filter count to the visible trigger label. */\n  @Prop() showSelectedCount: boolean = true;\n  /** Optional select trigger prefix icon name. */\n  @Prop() icon: string | undefined = 'Filters';\n  /** Select trigger density. */\n  @Prop() size: FilterMenuSize = 'md';\n  /** Select trigger width fit. */\n  @Prop() width: FilterMenuWidth = 'hug';\n  /** Show the surface-aware inset border around the select trigger. */\n  /** Show the trigger chevron. */\n  @Prop() showIndicator: boolean = true;\n  @Prop() hasBorder: boolean = true;\n  /** Show selected interaction fill when one or more criteria are active. */\n  /** Keep trigger colors neutral when a value is selected. */\n  @Prop() neutralTrigger: boolean = false;\n  /** Stage filter edits until Apply is pressed. */\n  @Prop() applyRequired: boolean = false;\n  @State() private draftValues?: FilterMenuValues;\n  @State() private draftModes?: FilterMenuMatchModes;\n\n  private changeValue(detail: FilterMenuChangeDetail): void {\n    if (this.applyRequired)\n      this.draftValues = { ...(this.draftValues ?? this.values), [detail.filterId]: detail.value };\n    else this.dsChange.emit(detail);\n  }\n  private changeMode(detail: FilterMenuMatchModeChangeDetail): void {\n    if (this.applyRequired)\n      this.draftModes = { ...(this.draftModes ?? this.matchModes), [detail.filterId]: detail.mode };\n    else this.dsMatchModeChange.emit(detail);\n  }\n  private get hasPendingChanges(): boolean {\n    const normalize = (value: FilterMenuValue | undefined) =>\n      Array.isArray(value) ? (value.length ? [...value].sort() : undefined) : value || undefined;\n    const values = this.draftValues ?? this.values;\n    const modes = this.draftModes ?? this.matchModes;\n    return this.filters.some(\n      filter =>\n        JSON.stringify(normalize(values[filter.id])) !==\n          JSON.stringify(normalize(this.values[filter.id])) ||\n        (modes[filter.id] ?? 'any') !== (this.matchModes[filter.id] ?? 'any')\n    );\n  }\n  private applyDraft(): void {\n    if (!this.hasPendingChanges) return;\n    if (this.draftValues && Object.keys(this.draftValues).length === 0) {\n      this.dsClear.emit();\n    } else if (this.draftValues) {\n      for (const id of new Set([...Object.keys(this.values), ...Object.keys(this.draftValues)])) {\n        if (JSON.stringify(this.values[id]) !== JSON.stringify(this.draftValues[id]))\n          this.dsChange.emit({\n            filterId: id,\n            value:\n              this.draftValues[id] ??\n              (Array.isArray(this.values[id])\n                ? []\n                : typeof this.values[id] === 'boolean'\n                  ? false\n                  : ''),\n          });\n      }\n    }\n    if (this.draftModes) {\n      for (const filterId of new Set([\n        ...Object.keys(this.matchModes),\n        ...Object.keys(this.draftModes),\n      ])) {\n        const mode = this.draftModes[filterId] ?? 'any';\n        if ((this.matchModes[filterId] ?? 'any') !== mode)\n          this.dsMatchModeChange.emit({ filterId, mode });\n      }\n    }\n  }\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  /** ID applied to the internal select trigger. */\n  @Prop() inputId: string | undefined;\n  /** Direct accessible name for the internal select trigger. */\n  @Prop({ attribute: 'aria-label' }) ariaLabel: string | null = null;\n  /** Product-owned filter categories and option definitions. */\n  @Prop() filters: FilterMenuFilter[] = [];\n  /** Controlled values keyed by filter id. */\n  @Prop() values: FilterMenuValues = {};\n  /** Controlled any/all match mode keyed by multiple-choice filter id. Defaults to any. */\n  @Prop() matchModes: FilterMenuMatchModes = {};\n  /** Controlled category shown in the option pane. */\n  @Prop() activeFilterId: string | undefined;\n  /** External trigger element to position against. */\n  @Prop() anchor: HTMLElement | undefined;\n  /** ID of the external trigger element used for positioning and focus return. */\n  @Prop() anchorId: string | undefined;\n  /** Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used. */\n  @Prop() boundary: HTMLElement | undefined;\n  /** Preferred popup side; collision handling may flip it. */\n  @Prop() side: AnchoredSide = 'bottom';\n  /** Cross-axis alignment against the trigger. */\n  @Prop() align: AnchoredAlign = 'end';\n  /** Gap between trigger and popup — number in px or a TokoMo length. */\n  @Prop() sideOffset: number | string = TOKEN_CSS_LENGTHS.space050;\n  /** Cross-axis offset — number in px or a TokoMo length. */\n  @Prop() alignOffset: number | string = 0;\n  /** Popup width. It remains clamped to its collision boundary by the component recipe. */\n  @Prop() menuWidth: string = TOKEN_CSS_LENGTHS.menuWidthLg;\n  /** Accessible name for the non-modal filter dialog. */\n  @Prop() menuLabel: string = 'Filters';\n  /** Accessible name for the category tab list. */\n  @Prop() categoriesLabel: string = 'Filter categories';\n  /** Footer action and date-clear accessible label. */\n  @Prop() clearLabel: string = 'Clear';\n  /** Placeholder shown in each non-date option search header. */\n  @Prop() searchPlaceholder: string = 'Search';\n  /** Empty-state text shown when an option search has no matches. */\n  @Prop() noResultsText: string = 'No results';\n  /** Footer recipe: full-width selected summary or reserved category-pane Clear action. */\n  @Prop() footerLayout: FilterMenuFooterLayout = 'summary';\n  /** Show a visible focus ring on initial entry after keyboard activation. */\n  @Prop() initialFocusVisible: boolean = false;\n\n  @State() private shouldRender = false;\n  @State() private closing = false;\n  @State() private positionReady = false;\n  @State() private pos: { x: number; y: number } = { x: 0, y: 0 };\n  @State() private focusRingVisible = false;\n  @State() private activeOptionIndex = 0;\n  @State() private captionCompact = false;\n  @State() private dateModeByFilter: Record<string, FilterMenuDateMode> = {};\n  @State() private optionQueryByFilter: Record<string, string> = {};\n\n  /** Requests a controlled value replacement without closing the popup. */\n  @Event() dsChange!: EventEmitter<FilterMenuChangeDetail>;\n  /** Requests that the consumer clear every filter value. */\n  @Event() dsClear!: EventEmitter<void>;\n  /** Requests a controlled any/all mode replacement for a multiple-choice filter. */\n  @Event() dsMatchModeChange!: EventEmitter<FilterMenuMatchModeChangeDetail>;\n  /** Requests a controlled active-category replacement. */\n  @Event() dsActiveFilterChange!: EventEmitter<string>;\n  /** Requests that the controlled popup close. */\n  @Event() dsClose!: EventEmitter<void>;\n  /** Emitted whenever internal select-trigger activation changes popup visibility. */\n  @Event() dsOpenChange!: EventEmitter<boolean>;\n  /** Emitted after exit motion and rendered popup removal complete. */\n  @Event() dsAfterClose!: EventEmitter<void>;\n\n  private readonly generatedId = `ds-filter-menu-${++filterMenuId}`;\n  private triggerElement: HTMLButtonElement | null = null;\n  private pendingInitialFocusVisible = false;\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  private captionCompactDisconnect: (() => void) | undefined;\n  private hasLoaded = false;\n  private closingSnapshot: {\n    filters: FilterMenuFilter[];\n    values: FilterMenuValues;\n    matchModes: FilterMenuMatchModes;\n    activeFilterId: string | undefined;\n  } | null = null;\n\n  private readonly position = new AnchoredPositionController({\n    getAnchor: () => this.resolvedAnchor,\n    getPopup: () => this.el.querySelector<HTMLElement>('.filter-menu-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    measure: (anchor, popup) => {\n      if (!this.open) return null;\n      const anchorRect = anchor.getBoundingClientRect();\n      const sectionInsetPx = resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050);\n      return {\n        anchorRect,\n        popupWidth: popup.offsetWidth || this.popupFallbackWidth,\n        popupHeight: popup.offsetHeight || this.popupFallbackHeight,\n        side: this.side,\n        align: this.align,\n        sideOffsetPx: resolveCssLengthPx(this.sideOffset, TOKEN_DEFAULTS.space050),\n        alignOffsetPx: resolveChoicePopupAlignOffset({\n          align: this.align,\n          alignOffsetPx: resolveCssLengthPx(this.alignOffset, 0),\n          sectionInsetPx,\n        }),\n        viewportPadPx: this.viewportPad,\n        viewportWidth: window.innerWidth,\n        viewportHeight: window.innerHeight,\n        collisionRect: resolveAnchoredOverlayBoundaryRect(anchor, this.boundary),\n      };\n    },\n    apply: ({ x, y }) => {\n      this.pos = { x, y };\n    },\n    onReady: () => {\n      this.positionReady = true;\n    },\n    liveUpdate: 'double-frame',\n    observeResize: true,\n    topLayer: true,\n  });\n  private readonly interaction = new AnchoredOverlayInteractionController({\n    getAnchor: () => this.resolvedAnchor,\n    getPopup: () => this.el.querySelector<HTMLElement>('.filter-menu-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    onOutsideActivation: () => this.close(),\n  });\n\n  componentDidLoad() {\n    this.hasLoaded = true;\n    this.syncCaptionCompactObserver();\n    if (this.open) this.onOpenChange(true);\n  }\n\n  connectedCallback() {\n    if (!this.hasLoaded) return;\n    this.syncCaptionCompactObserver();\n    if (this.open) this.onOpenChange(true);\n  }\n\n  disconnectedCallback() {\n    this.disconnectCaptionCompactObserver();\n    this.position.unobserve();\n    this.teardownListeners();\n  }\n\n  @Watch('collapseLabel')\n  onCollapseLabelChange() {\n    this.syncCaptionCompactObserver();\n  }\n\n  @Watch('open')\n  onOpenChange(isOpen: boolean) {\n    if (!isOpen) {\n      this.draftValues = undefined;\n      this.draftModes = undefined;\n    }\n    if (this.embedded) return;\n    if (isOpen) {\n      this.teardownListeners();\n      this.closingSnapshot = null;\n      this.shouldRender = true;\n      this.closing = false;\n      this.positionReady = false;\n      this.focusRingVisible = this.pendingInitialFocusVisible || this.initialFocusVisible;\n      this.setupListeners();\n      this.position.schedule(() => this.focusInitialCategory());\n      return;\n    }\n\n    if (!this.shouldRender) return;\n    this.position.cancel();\n    this.captureClosingSnapshot();\n    this.closing = true;\n    this.teardownListeners();\n    const duration = resolveMotionTimeMs(\n      TOKEN_DEFAULTS.motionShort2,\n      TOKEN_DEFAULTS.animationDurationShort3\n    );\n    if (duration <= 0) {\n      this.finishClose();\n      return;\n    }\n    this.closeTimer = setTimeout(() => this.finishClose(), duration);\n  }\n\n  @Watch('anchor')\n  @Watch('anchorId')\n  @Watch('boundary')\n  @Watch('side')\n  @Watch('align')\n  @Watch('sideOffset')\n  @Watch('alignOffset')\n  @Watch('menuWidth')\n  onPositionInputChange() {\n    if (this.open) this.position.schedule();\n  }\n\n  @Listen('keydown')\n  handleKeyDown(event: KeyboardEvent) {\n    if (this.embedded && (event.key === 'Escape' || event.key === 'Tab')) return;\n    if ((!this.shouldRender && !this.embedded) || this.closing) return;\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      this.close();\n      return;\n    }\n    if (event.key !== 'Tab' || !this.tabLeavesPopup(event)) return;\n    event.preventDefault();\n    this.close(false);\n    this.interaction.moveFocusAfterTab(event.shiftKey);\n  }\n\n  private get resolvedAnchor(): HTMLElement | null {\n    if (this.anchor) return this.anchor;\n    if (this.anchorId) return document.getElementById(this.anchorId);\n    return this.triggerElement;\n  }\n\n  private get usesInternalTrigger(): boolean {\n    return !this.embedded && !this.anchor && !this.anchorId;\n  }\n\n  private get viewportPad(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050);\n  }\n\n  private get popupFallbackWidth(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuWidthLg, TOKEN_DEFAULTS.menuWidthLg);\n  }\n\n  private get popupFallbackHeight(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuFallbackHeight, TOKEN_DEFAULTS.menuFallbackHeight);\n  }\n\n  private setupListeners() {\n    this.interaction.connect();\n    this.position.observe();\n  }\n\n  private teardownListeners() {\n    this.position.unobserve();\n    this.interaction.disconnect();\n    if (this.closeTimer) {\n      clearTimeout(this.closeTimer);\n      this.closeTimer = null;\n    }\n  }\n\n  private close(restoreFocus = true) {\n    this.captureClosingSnapshot();\n    if (restoreFocus) this.interaction.focusAnchor();\n    this.dsOpenChange.emit(false);\n    this.dsClose.emit();\n    this.open = false;\n    this.onOpenChange(false);\n  }\n\n  private toggleFromTrigger(event: MouseEvent) {\n    if (this.open) {\n      this.close();\n      return;\n    }\n    this.pendingInitialFocusVisible = event.detail === 0;\n    this.open = true;\n    this.dsOpenChange.emit(true);\n    this.onOpenChange(true);\n  }\n\n  private handleTriggerKeyDown(event: KeyboardEvent) {\n    if (event.key !== 'ArrowDown' || this.open) return;\n    event.preventDefault();\n    this.pendingInitialFocusVisible = true;\n    this.open = true;\n    this.dsOpenChange.emit(true);\n    this.onOpenChange(true);\n  }\n\n  private finishClose() {\n    const popup = this.el.querySelector<HTMLElement>('.filter-menu-popup');\n    if (popup?.matches(':popover-open')) popup.hidePopover();\n    this.shouldRender = false;\n    this.closing = false;\n    this.closingSnapshot = null;\n    this.closeTimer = null;\n    this.dateModeByFilter = {};\n    this.optionQueryByFilter = {};\n    this.dsAfterClose.emit();\n  }\n\n  private captureClosingSnapshot() {\n    if (this.closingSnapshot) return;\n    this.closingSnapshot = {\n      filters: this.filters.map(filter => ({\n        ...filter,\n        options: filter.options?.map(option => ({ ...option })),\n      })),\n      values: Object.fromEntries(\n        Object.entries(this.values).map(([key, value]) => [\n          key,\n          Array.isArray(value) ? [...value] : value,\n        ])\n      ),\n      matchModes: { ...this.matchModes },\n      activeFilterId: this.activeFilterId,\n    };\n  }\n\n  private focusInitialCategory() {\n    requestAnimationFrame(() => {\n      this.el.querySelector<HTMLElement>('.filter-menu__category[tabindex=\"0\"]')?.focus();\n      this.pendingInitialFocusVisible = false;\n    });\n  }\n\n  private tabLeavesPopup(event: KeyboardEvent): boolean {\n    return this.interaction.tabLeavesPopup(event);\n  }\n\n  private selectedFilter(filters: FilterMenuFilter[], activeFilterId: string | undefined) {\n    return filters.find(filter => filter.id === activeFilterId) ?? filters[0];\n  }\n\n  private selectedCount(filter: FilterMenuFilter, values: FilterMenuValues): number {\n    const value = values[filter.id];\n    if (filter.kind === 'multiple') return Array.isArray(value) ? value.length : 0;\n    if (filter.kind === 'boolean') return value === true ? 1 : 0;\n    return typeof value === 'string' && value.length > 0 ? 1 : 0;\n  }\n\n  private totalSelected(filters: FilterMenuFilter[], values: FilterMenuValues): number {\n    return filters.reduce((total, filter) => total + this.selectedCount(filter, values), 0);\n  }\n\n  private activeFilterCount(filters: FilterMenuFilter[], values: FilterMenuValues): number {\n    return filters.filter(filter => this.selectedCount(filter, values) > 0).length;\n  }\n\n  private selectCategory(filterId: string, focus = false) {\n    this.activeOptionIndex = 0;\n    this.dsActiveFilterChange.emit(filterId);\n    if (!focus) return;\n    requestAnimationFrame(() => {\n      this.el.querySelector<HTMLElement>(`[data-filter-category=\"${filterId}\"]`)?.focus();\n    });\n  }\n\n  private handleCategoryKeyDown(\n    event: KeyboardEvent,\n    filters: FilterMenuFilter[],\n    filterId: string\n  ) {\n    const currentIndex = filters.findIndex(filter => filter.id === filterId);\n    let nextIndex: number;\n    if (event.key === 'ArrowDown') nextIndex = (currentIndex + 1) % filters.length;\n    else if (event.key === 'ArrowUp')\n      nextIndex = (currentIndex - 1 + filters.length) % filters.length;\n    else if (event.key === 'Home') nextIndex = 0;\n    else if (event.key === 'End') nextIndex = filters.length - 1;\n    else if (event.key === 'ArrowRight') {\n      event.preventDefault();\n      requestAnimationFrame(() => {\n        this.el\n          .querySelector<HTMLElement>(\n            '.filter-menu__options [role=\"option\"], .filter-menu__options [data-date-option], .filter-menu__options input'\n          )\n          ?.focus();\n      });\n      return;\n    } else return;\n\n    event.preventDefault();\n    this.focusRingVisible = true;\n    this.selectCategory(filters[nextIndex].id, true);\n  }\n\n  private handlePanelKeyDown(event: KeyboardEvent, filterId: string) {\n    if (event.key !== 'ArrowLeft') return;\n    event.preventDefault();\n    this.el.querySelector<HTMLElement>(`[data-filter-category=\"${filterId}\"]`)?.focus();\n  }\n\n  private handleOptionKeyDown(\n    event: KeyboardEvent,\n    filter: FilterMenuFilter,\n    option: FilterMenuOption,\n    index: number,\n    values: FilterMenuValues,\n    visibleOptions: FilterMenuOption[] = filter.options ?? []\n  ) {\n    if (event.key === 'ArrowLeft') {\n      this.handlePanelKeyDown(event, filter.id);\n      return;\n    }\n    if (event.key === 'Enter' || event.key === ' ') {\n      event.preventDefault();\n      this.selectOption(filter, option, values);\n      return;\n    }\n    if (!['ArrowDown', 'ArrowUp', 'Home', 'End'].includes(event.key)) return;\n    event.preventDefault();\n    const enabled = visibleOptions\n      .map((candidate, optionIndex) => ({ candidate, optionIndex }))\n      .filter(({ candidate }) => !candidate.isInactive)\n      .map(({ optionIndex }) => optionIndex);\n    if (!enabled.length) return;\n    const current = enabled.indexOf(index);\n    let next: number;\n    if (event.key === 'Home') next = enabled[0];\n    else if (event.key === 'End') next = enabled[enabled.length - 1];\n    else {\n      const direction = event.key === 'ArrowDown' ? 1 : -1;\n      const start = current >= 0 ? current : direction === 1 ? -1 : 0;\n      next = enabled[(start + direction + enabled.length) % enabled.length];\n    }\n    this.activeOptionIndex = next;\n    this.focusRingVisible = true;\n    requestAnimationFrame(() => {\n      this.el\n        .querySelector<HTMLElement>(`#${this.generatedId}-${filter.id}-option-${next}`)\n        ?.focus();\n    });\n  }\n\n  private optionMatchesQuery(option: FilterMenuOption, query: string): boolean {\n    const normalized = query.trim().toLocaleLowerCase();\n    if (!normalized) return true;\n    return `${option.label} ${option.description ?? ''}`.toLocaleLowerCase().includes(normalized);\n  }\n\n  private visibleOptions(\n    filter: FilterMenuFilter,\n    query = this.optionQueryByFilter[filter.id] ?? ''\n  ) {\n    if (filter.kind === 'boolean') {\n      const option = this.booleanOption(filter);\n      return this.optionMatchesQuery(option, query) ? [option] : [];\n    }\n    return (filter.options ?? []).filter(option => this.optionMatchesQuery(option, query));\n  }\n\n  private booleanOption(filter: FilterMenuFilter): FilterMenuOption {\n    return {\n      label: filter.fieldLabel ?? filter.label,\n      value: 'true',\n      description: filter.description,\n    };\n  }\n\n  private setOptionQuery(filter: FilterMenuFilter, value: string) {\n    const visibleOptions = this.visibleOptions(filter, value);\n    const firstEnabled = visibleOptions.findIndex(option => !option.isInactive);\n    this.activeOptionIndex = firstEnabled;\n    this.focusRingVisible = false;\n    this.optionQueryByFilter = { ...this.optionQueryByFilter, [filter.id]: value };\n    requestAnimationFrame(() => {\n      const content = this.el.querySelector<HTMLElement>('.filter-menu__options-content');\n      if (content) content.scrollTop = 0;\n      this.position.schedule();\n    });\n  }\n\n  private handleOptionSearchKeyDown(event: KeyboardEvent, filter: FilterMenuFilter) {\n    if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp') return;\n    const visibleOptions = this.visibleOptions(filter);\n    const enabled = visibleOptions\n      .map((option, index) => ({ option, index }))\n      .filter(({ option }) => !option.isInactive)\n      .map(({ index }) => index);\n    if (!enabled.length) return;\n    event.preventDefault();\n    const next = event.key === 'ArrowDown' ? enabled[0] : enabled[enabled.length - 1];\n    this.activeOptionIndex = next;\n    this.focusRingVisible = true;\n    requestAnimationFrame(() => {\n      this.el\n        .querySelector<HTMLElement>(`#${this.generatedId}-${filter.id}-option-${next}`)\n        ?.focus();\n    });\n  }\n\n  private toggleMultiple(\n    filter: FilterMenuFilter,\n    option: FilterMenuOption,\n    checked: boolean,\n    values: FilterMenuValues\n  ) {\n    if (option.isInactive) return;\n    const current = Array.isArray(values[filter.id]) ? (values[filter.id] as string[]) : [];\n    const selected = new Set(current);\n    if (checked) selected.add(option.value);\n    else selected.delete(option.value);\n    const ordered = (filter.options ?? [])\n      .map(candidate => candidate.value)\n      .filter(value => selected.has(value));\n    this.changeValue({ filterId: filter.id, value: ordered });\n  }\n\n  private selectOption(\n    filter: FilterMenuFilter,\n    option: FilterMenuOption,\n    values: FilterMenuValues\n  ) {\n    if (option.isInactive) return;\n    if (filter.kind === 'single') {\n      this.changeValue({ filterId: filter.id, value: option.value });\n      return;\n    }\n    const selected = Array.isArray(values[filter.id])\n      ? (values[filter.id] as string[]).includes(option.value)\n      : false;\n    this.toggleMultiple(filter, option, !selected, values);\n  }\n\n  private dateMode(filterId: string, value: FilterMenuValue | undefined): FilterMenuDateMode {\n    return this.dateModeByFilter[filterId] ?? parseDateFilterValue(value)?.kind ?? 'relative';\n  }\n\n  private setDateMode(filter: FilterMenuFilter, mode: string) {\n    if (mode !== 'range' && mode !== 'relative') return;\n    this.dateModeByFilter = { ...this.dateModeByFilter, [filter.id]: mode };\n    this.activeOptionIndex = 0;\n  }\n\n  private renderRelativeDateOptions(filter: FilterMenuFilter, value: FilterMenuValue | undefined) {\n    const relativeFilter: FilterMenuFilter = {\n      ...filter,\n      kind: 'single',\n      options: RELATIVE_DATE_OPTIONS,\n    };\n    return (\n      <div\n        class=\"filter-menu__date-relative ds-choice-list ds-chrome-column ds-chrome-space--sm\"\n        role=\"listbox\"\n        aria-label=\"Relative date\"\n      >\n        {RELATIVE_DATE_OPTIONS.map((option, index) => (\n          <ChoiceOptionRow\n            size=\"md\"\n            id={`${this.generatedId}-${filter.id}-relative-${index}`}\n            option={option}\n            selected={value === option.value}\n            active={index === this.activeOptionIndex}\n            focusRingVisible={this.focusRingVisible}\n            usesSubtext={false}\n            tabIndex={index === this.activeOptionIndex ? 0 : -1}\n            onFocus={() => {\n              this.activeOptionIndex = index;\n            }}\n            onKeyDown={(event: KeyboardEvent) =>\n              this.handleOptionKeyDown(event, relativeFilter, option, index, {\n                [filter.id]: value,\n              })\n            }\n            onHover={() => {\n              this.focusRingVisible = false;\n              this.activeOptionIndex = index;\n            }}\n            onSelect={() => this.changeValue({ filterId: filter.id, value: option.value })}\n          />\n        ))}\n      </div>\n    );\n  }\n\n  private renderDateCalendar(filter: FilterMenuFilter, value: FilterMenuValue | undefined) {\n    return (\n      <ds-calendar\n        selectionMode=\"range\"\n        value={typeof value === 'string' ? value : ''}\n        onDsChange={(event: CustomEvent<string>) => {\n          event.stopPropagation();\n          this.changeValue({ filterId: filter.id, value: event.detail });\n        }}\n      />\n    );\n  }\n\n  private renderDateFilter(filter: FilterMenuFilter, value: FilterMenuValue | undefined) {\n    const mode = this.dateMode(filter.id, value);\n    return (\n      <div class=\"filter-menu__date\">\n        <header class=\"filter-menu__date-header ds-chrome-header ds-chrome-header--bounded\">\n          <ds-tab-group\n            ariaLabel=\"Date filter mode\"\n            size=\"md\"\n            width=\"fill\"\n            hasContainer={false}\n            value={mode}\n            tabs={DATE_MODE_TABS}\n            onDsChange={(event: CustomEvent<string>) => {\n              event.stopPropagation();\n              this.setDateMode(filter, event.detail);\n            }}\n          />\n        </header>\n        <div class=\"filter-menu__date-body\">\n          {mode === 'relative'\n            ? this.renderRelativeDateOptions(filter, value)\n            : this.renderDateCalendar(filter, value)}\n        </div>\n      </div>\n    );\n  }\n\n  private renderOptionSearch(filter: FilterMenuFilter) {\n    return (\n      <div class=\"filter-menu__option-search\">\n        <ChoiceSearch\n          size=\"md\"\n          hasFocusBoundary={false}\n          hasInteractionFill={false}\n          value={this.optionQueryByFilter[filter.id] ?? ''}\n          placeholder={this.searchPlaceholder}\n          ariaLabel={`Search ${filter.label} options`}\n          controls={`${this.generatedId}-${filter.id}-options`}\n          inputRef={() => undefined}\n          clearLabel={`Clear ${filter.label} search`}\n          onValueChange={value => this.setOptionQuery(filter, value)}\n          onKeyDown={(event: KeyboardEvent) => this.handleOptionSearchKeyDown(event, filter)}\n        />\n      </div>\n    );\n  }\n\n  private renderNoOptionResults() {\n    return (\n      <div\n        class=\"ds-choice-empty ds-empty-region\"\n        role=\"option\"\n        aria-selected=\"false\"\n        aria-disabled=\"true\"\n        aria-label={this.noResultsText}\n        aria-live=\"polite\"\n      >\n        <ds-empty-state body={this.noResultsText} />\n      </div>\n    );\n  }\n\n  private renderOptions(filter: FilterMenuFilter, values: FilterMenuValues) {\n    const value = values[filter.id];\n    if (filter.kind === 'multiple' || filter.kind === 'single') {\n      const selected = Array.isArray(value) ? value : [];\n      const allOptions = filter.options ?? [];\n      const options = this.visibleOptions(filter);\n      const usesSubtext = choiceListUsesSubtext(\n        allOptions.map(option => ({\n          label: option.label,\n          value: option.value,\n          subtext: option.description,\n        }))\n      );\n      if (!options.length) return this.renderNoOptionResults();\n      return options.map((option, index) => {\n        const isSelected =\n          filter.kind === 'multiple' ? selected.includes(option.value) : value === option.value;\n        return (\n          <ChoiceOptionRow\n            size=\"md\"\n            id={`${this.generatedId}-${filter.id}-option-${index}`}\n            option={{\n              label: option.label,\n              value: option.value,\n              subtext: option.description,\n              isInactive: option.isInactive,\n            }}\n            selected={isSelected}\n            active={index === this.activeOptionIndex}\n            focusRingVisible={this.focusRingVisible}\n            usesSubtext={usesSubtext}\n            tabIndex={index === this.activeOptionIndex ? 0 : -1}\n            leading={\n              filter.kind === '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 label=\"\" size=\"md\" checked={isSelected} presentation />\n                </span>\n              ) : undefined\n            }\n            onFocus={() => {\n              this.activeOptionIndex = index;\n            }}\n            onKeyDown={(event: KeyboardEvent) =>\n              this.handleOptionKeyDown(event, filter, option, index, values, options)\n            }\n            onHover={() => {\n              this.focusRingVisible = false;\n              this.activeOptionIndex = index;\n            }}\n            onSelect={() => this.selectOption(filter, option, values)}\n          />\n        );\n      });\n    }\n\n    if (filter.kind === 'boolean') {\n      const [option] = this.visibleOptions(filter);\n      if (!option) return this.renderNoOptionResults();\n      return (\n        <ChoiceOptionRow\n          size=\"md\"\n          id={`${this.generatedId}-${filter.id}-option-0`}\n          option={{\n            label: option.label,\n            value: option.value,\n            subtext: option.description,\n          }}\n          selected={value === true}\n          active\n          focusRingVisible={this.focusRingVisible}\n          usesSubtext={Boolean(option.description)}\n          tabIndex={0}\n          leading={\n            <span\n              class=\"ds-choice-item__icon ds-control-icon-box ds-interaction-fill__content\"\n              aria-hidden=\"true\"\n            >\n              <ds-checkbox label=\"\" size=\"md\" checked={value === true} presentation />\n            </span>\n          }\n          onKeyDown={(event: KeyboardEvent) => {\n            if (event.key === 'ArrowLeft') this.handlePanelKeyDown(event, filter.id);\n            else if (event.key === 'Enter' || event.key === ' ') {\n              event.preventDefault();\n              this.changeValue({ filterId: filter.id, value: value !== true });\n            }\n          }}\n          onHover={() => {\n            this.focusRingVisible = false;\n          }}\n          onSelect={() => this.changeValue({ filterId: filter.id, value: value !== true })}\n        />\n      );\n    }\n\n    return this.renderDateFilter(filter, value);\n  }\n\n  private get captionIconOnly(): boolean {\n    return (\n      this.collapseLabel && this.captionCompact && this.usesInternalTrigger && Boolean(this.icon)\n    );\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  private renderFooter(totalSelected: number, categoriesClear: boolean) {\n    const appliedCount = this.totalSelected(this.filters, this.values);\n    if (this.applyRequired && totalSelected === 0 && appliedCount === 0) return null;\n    return (\n      <div\n        class={{\n          'filter-menu__footer': true,\n          'filter-menu__footer--categories-clear': categoriesClear,\n          'ds-choice-footer': true,\n        }}\n        aria-hidden={\n          !this.applyRequired &&\n          categoriesClear &&\n          totalSelected === 0 &&\n          !this.draftValues &&\n          !this.draftModes\n            ? 'true'\n            : undefined\n        }\n      >\n        <div class=\"ds-choice-footer__content ds-control--md\">\n          {!categoriesClear ? (\n            <ds-text\n              class=\"ds-choice-footer__summary\"\n              as=\"span\"\n              variant=\"text-body-medium\"\n              color=\"secondary\"\n              aria-live=\"polite\"\n            >\n              {totalSelected} selected\n            </ds-text>\n          ) : null}\n          {this.applyRequired ? (\n            <button\n              class=\"filter-menu__apply ds-choice-footer__clear ds-text-action\"\n              type=\"button\"\n              disabled={!this.hasPendingChanges}\n              onClick={() => this.applyDraft()}\n            >\n              <ds-text as=\"span\" variant=\"text-body-medium\" color=\"inherit\">\n                Apply\n              </ds-text>\n            </button>\n          ) : null}\n          {this.applyRequired && (totalSelected > 0 || appliedCount > 0) ? (\n            <ds-text\n              class=\"filter-menu__action-separator\"\n              as=\"span\"\n              variant=\"text-body-medium\"\n              color=\"tertiary\"\n              aria-hidden=\"true\"\n            >\n              ·\n            </ds-text>\n          ) : null}\n          {totalSelected > 0 || (this.applyRequired && appliedCount > 0) ? (\n            <button\n              class=\"filter-menu__clear ds-choice-footer__clear ds-text-action\"\n              type=\"button\"\n              onClick={() => {\n                if (this.applyRequired) {\n                  this.draftValues = {};\n                  this.draftModes = {};\n                }\n                this.dsClear.emit();\n              }}\n            >\n              <ds-text as=\"span\" variant=\"text-body-medium\" color=\"inherit\">\n                {this.clearLabel}\n              </ds-text>\n            </button>\n          ) : null}\n        </div>\n      </div>\n    );\n  }\n\n  private renderMatchModeFooter(filter: FilterMenuFilter, matchModes: FilterMenuMatchModes) {\n    const mode: FilterMenuMatchMode = matchModes[filter.id] === 'all' ? 'all' : 'any';\n    const nextMode: FilterMenuMatchMode = mode === 'any' ? 'all' : 'any';\n    return (\n      <div class=\"filter-menu__match-mode-footer ds-choice-footer\">\n        <div class=\"filter-menu__match-mode-content ds-choice-footer__content ds-control--md\">\n          <ds-text as=\"span\" variant=\"text-body-medium\" color=\"secondary\">\n            Limit results to\n          </ds-text>\n          <button\n            class=\"filter-menu__match-mode-toggle ds-text-action ds-focus-ring\"\n            type=\"button\"\n            aria-label={`Limit ${filter.label} results to ${nextMode} selected`}\n            onClick={() => this.changeMode({ filterId: filter.id, mode: nextMode })}\n            onKeyDown={(event: KeyboardEvent) => this.handlePanelKeyDown(event, filter.id)}\n          >\n            <ds-text as=\"span\" variant=\"text-body-medium\" color=\"inherit\">\n              {mode}\n            </ds-text>\n          </button>\n          <ds-text as=\"span\" variant=\"text-body-medium\" color=\"secondary\">\n            selected\n          </ds-text>\n        </div>\n      </div>\n    );\n  }\n\n  render() {\n    if (this.vertical)\n      return (\n        <Host class=\"filter-menu-vertical\">\n          {this.filters.map(filter => (\n            <details open key={filter.id} class=\"filter-menu-vertical__section\">\n              <summary>\n                <ds-icon class=\"filter-menu-vertical__chevron\" name=\"ChevronDown\" size=\"md\" />\n                <ds-text variant=\"text-body-medium\" emphasis>\n                  {filter.label}\n                </ds-text>\n              </summary>\n              {filter.kind !== 'date' && this.renderOptionSearch(filter)}\n              <div\n                id={`${this.generatedId}-${filter.id}-options`}\n                role={filter.kind === 'date' ? undefined : 'listbox'}\n                aria-label={filter.label}\n                aria-multiselectable={filter.kind === 'multiple' ? 'true' : undefined}\n                class=\"ds-choice-list ds-chrome-column ds-chrome-space--sm\"\n              >\n                {this.renderOptions(filter, this.values)}\n              </div>\n              {filter.kind === 'multiple' && this.renderMatchModeFooter(filter, this.matchModes)}\n            </details>\n          ))}\n        </Host>\n      );\n    const state =\n      this.closing && this.closingSnapshot\n        ? this.closingSnapshot\n        : {\n            filters: this.filters,\n            values: this.draftValues ?? this.values,\n            matchModes: this.draftModes ?? this.matchModes,\n            activeFilterId: this.activeFilterId,\n          };\n    const activeFilter = this.selectedFilter(state.filters, state.activeFilterId);\n    const totalSelected = this.totalSelected(state.filters, state.values);\n    const activeFilterCount = this.activeFilterCount(state.filters, state.values);\n    const hasActiveFilters = activeFilterCount > 0;\n    const categoriesClearFooter = this.footerLayout === 'categories-clear';\n    const label = `${this.triggerLabel}${\n      this.showSelectedCount && hasActiveFilters ? ` · ${activeFilterCount}` : ''\n    }`;\n    const textVariant = CONTROL_TEXT_VARIANT[this.size];\n    const iconSize = ICON_SIZE[this.size];\n    const popupId = `${this.generatedId}-popup`;\n    const popupStyle: Record<string, string> = {\n      position: 'fixed',\n      left: '0',\n      top: '0',\n      width: this.menuWidth,\n      transform: `translate(${Math.round(this.pos.x)}px, ${Math.round(this.pos.y)}px)`,\n      zIndex: '9998',\n      visibility: this.positionReady ? 'visible' : 'hidden',\n    };\n\n    return (\n      <Host\n        class={{\n          'filter-menu-host': true,\n          'filter-menu-host--external-trigger': !this.usesInternalTrigger,\n          'ds-select-trigger-host': this.usesInternalTrigger,\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        }}\n      >\n        {this.usesInternalTrigger\n          ? this.renderCaptionTooltip(\n              <button\n                ref={element => {\n                  this.triggerElement = (element as HTMLButtonElement) ?? null;\n                }}\n                id={this.inputId ?? `${this.generatedId}-trigger`}\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': this.activeFill && hasActiveFilters,\n                  'trigger--expanded': this.open || this.closing,\n                  'ds-interaction-fill--surface-open': this.open || this.closing,\n                  'trigger--bordered': this.hasBorder,\n                  'trigger--has-value': hasActiveFilters && !this.neutralTrigger,\n                  [`ds-control--${this.size}`]: true,\n                }}\n                role=\"combobox\"\n                aria-haspopup=\"dialog\"\n                aria-expanded={String(this.open)}\n                aria-controls={this.open ? popupId : undefined}\n                aria-label={this.ariaLabel ?? this.menuLabel}\n                onClick={(event: MouseEvent) => this.toggleFromTrigger(event)}\n                onKeyDown={(event: KeyboardEvent) => this.handleTriggerKeyDown(event)}\n              >\n                {this.icon ? (\n                  <span\n                    class=\"trigger__prefix ds-control-icon-box ds-interaction-fill__content\"\n                    aria-hidden=\"true\"\n                  >\n                    <ds-icon name={this.icon} size={iconSize} color=\"inherit\" />\n                  </span>\n                ) : null}\n                {this.captionIconOnly ? null : (\n                  <ds-text\n                    class=\"trigger__label-box trigger__label trigger__label-content ds-control-label-box ds-interaction-fill__content\"\n                    as=\"span\"\n                    variant={textVariant}\n                    color=\"inherit\"\n                    lineTruncation={1}\n                  >\n                    {label}\n                  </ds-text>\n                )}\n                {this.captionIconOnly || !this.showIndicator ? null : (\n                  <span\n                    class=\"trigger__chevron ds-control-icon-box ds-interaction-fill__content\"\n                    aria-hidden=\"true\"\n                  >\n                    <ds-icon name=\"ChevronDown\" size={iconSize} color=\"inherit\" />\n                  </span>\n                )}\n              </button>,\n              this.captionIconOnly ? label : ''\n            )\n          : null}\n\n        {this.shouldRender || this.embedded ? (\n          <div\n            id={popupId}\n            popover={this.embedded ? undefined : 'manual'}\n            class={{\n              'filter-menu-popup': true,\n              'ds-choice-popup': !this.embedded,\n              'data-preferences-embedded': this.embedded,\n              'ds-choice-popup--closing': this.closing,\n            }}\n            style={this.embedded ? undefined : popupStyle}\n            role=\"dialog\"\n            aria-label={this.menuLabel}\n          >\n            {activeFilter ? (\n              <div class=\"filter-menu\">\n                <div class=\"filter-menu__body\">\n                  <div class=\"filter-menu__category-pane\">\n                    <div\n                      class=\"filter-menu__categories ds-choice-list ds-chrome-column ds-chrome-space--sm\"\n                      role=\"tablist\"\n                      aria-label={this.categoriesLabel}\n                      aria-orientation=\"vertical\"\n                    >\n                      {state.filters.map(filter => {\n                        const active = filter.id === activeFilter.id;\n                        const count = this.selectedCount(filter, state.values);\n                        return (\n                          <div\n                            key={filter.id}\n                            class={{\n                              'filter-menu__category-section': true,\n                              'ds-choice-section--divided': Boolean(filter.divider),\n                            }}\n                          >\n                            <button\n                              id={`${this.generatedId}-${filter.id}-tab`}\n                              type=\"button\"\n                              role=\"tab\"\n                              data-filter-category={filter.id}\n                              class={{\n                                'filter-menu__category': true,\n                                'filter-menu__category--active': active,\n                                'ds-choice-item': true,\n                                'ds-control-frame': true,\n                                'ds-control--md': true,\n                                'ds-focus-ring-inset': true,\n                                'ds-focus-ring--visible': active && this.focusRingVisible,\n                                'ds-interaction-fill': true,\n                                'ds-interaction-fill--selected': active,\n                              }}\n                              aria-selected={String(active)}\n                              aria-controls={`${this.generatedId}-panel`}\n                              tabIndex={active ? 0 : -1}\n                              onMouseDown={() => {\n                                this.focusRingVisible = false;\n                              }}\n                              onClick={() => this.selectCategory(filter.id)}\n                              onKeyDown={(event: KeyboardEvent) =>\n                                this.handleCategoryKeyDown(event, state.filters, filter.id)\n                              }\n                            >\n                              <ds-text\n                                class=\"ds-choice-item__content ds-choice-item__label ds-control-label-box ds-interaction-fill__content\"\n                                as=\"span\"\n                                variant=\"text-body-medium\"\n                                color={active ? 'primary' : 'secondary'}\n                              >\n                                {filter.label}\n                              </ds-text>\n                              {count > 0 && filter.kind === 'date' ? (\n                                <span\n                                  class=\"filter-menu__category-dot-box ds-interaction-fill__content\"\n                                  aria-hidden=\"true\"\n                                >\n                                  <ds-badge variant=\"dot\" hasRing={false} label=\"\" />\n                                </span>\n                              ) : count > 0 ? (\n                                <ds-tag\n                                  class=\"ds-choice-item__tag ds-interaction-fill__content\"\n                                  label={String(count)}\n                                  size=\"sm\"\n                                  intent=\"brand\"\n                                  contrast=\"bold\"\n                                  isInset\n                                  rounded\n                                />\n                              ) : null}\n                            </button>\n                          </div>\n                        );\n                      })}\n                    </div>\n                    {categoriesClearFooter ? this.renderFooter(totalSelected, true) : null}\n                  </div>\n\n                  <div\n                    id={`${this.generatedId}-panel`}\n                    class={{\n                      'filter-menu__options': true,\n                      'filter-menu__options--date': activeFilter.kind === 'date',\n                    }}\n                    role=\"tabpanel\"\n                    aria-labelledby={`${this.generatedId}-${activeFilter.id}-tab`}\n                  >\n                    {activeFilter.kind === 'date' ? null : this.renderOptionSearch(activeFilter)}\n                    <div class=\"filter-menu__options-content\">\n                      {activeFilter.kind === 'date' ? (\n                        <div key={activeFilter.id} class=\"filter-menu__option-list--date\">\n                          {this.renderOptions(activeFilter, state.values)}\n                        </div>\n                      ) : (\n                        <div\n                          id={`${this.generatedId}-${activeFilter.id}-options`}\n                          key={activeFilter.id}\n                          class=\"filter-menu__option-list ds-choice-list ds-chrome-column ds-chrome-space--sm\"\n                          role=\"listbox\"\n                          aria-label={activeFilter.label}\n                          aria-multiselectable={\n                            activeFilter.kind === 'multiple' ? 'true' : undefined\n                          }\n                        >\n                          {this.renderOptions(activeFilter, state.values)}\n                        </div>\n                      )}\n                    </div>\n                    {activeFilter.kind === 'multiple'\n                      ? this.renderMatchModeFooter(activeFilter, state.matchModes)\n                      : null}\n                  </div>\n                </div>\n\n                {!categoriesClearFooter && totalSelected > 0\n                  ? this.renderFooter(totalSelected, false)\n                  : null}\n              </div>\n            ) : null}\n          </div>\n        ) : null}\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]