@ds-mo/ui 14.27.1 → 14.29.0

package/dist/mcp-data/registry/card-settings-scope.json

@@ -0,0 +1,314 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "card-settings-scope",
+  "title": "CardSettingsScope",
+  "description": "Compact, theme-aware settings context card with inline product-area and profile menu triggers.",
+  "type": "registry:ui",
+  "meta": {
+    "library": "@ds-mo/ui",
+    "distribution": "npm",
+    "storybook": "https://zainadeel.github.io/compomo/?path=/story/card-settings-scope",
+    "source": "src/wc/components/CardSettingsScope/CardSettingsScope.tsx",
+    "intentStatus": "complete",
+    "intent": {
+      "audience": "general",
+      "status": "stable",
+      "summary": "Compact, theme-aware settings context card with inline product-area and profile menu triggers.",
+      "useWhen": [
+        "A settings workspace needs to show and change both its product area and the organization or profile being managed."
+      ],
+      "avoidWhen": [
+        "The content is a reporting period and metrics summary; use CardOverview.",
+        "The card edits settings in place; use CardSetting."
+      ],
+      "commonlyComposedWith": [
+        "component:ds-menu",
+        "component:ds-card-setting"
+      ],
+      "accessibility": [
+        "Both scope values are native buttons with popup relationships and controlled expanded state.",
+        "Use the emitted native anchor for menu placement and focus return.",
+        "An empty informational profiles popup uses dialog semantics.",
+        "The shared text-action recipe supplies brand foreground, hover underline, and keyboard focus indication."
+      ],
+      "states": [
+        "The application owns the selected area, profile, available choices, permissions, and empty-state copy.",
+        "The card reports popup requests without changing selection or expanded state.",
+        "The surface follows the active theme rather than imposing always-dark colors."
+      ],
+      "responsiveBehavior": [
+        "The parent owns sticky positioning and shell offsets.",
+        "The compact sentence wraps when space is constrained so both controls remain available."
+      ],
+      "frameworkCaveats": {
+        "angular": [
+          "Import the generated standalone adapter; bind controlled labels and expanded states and handle dsScopeRequest."
+        ]
+      },
+      "references": [
+        {
+          "label": "Storybook examples",
+          "path": "src/wc/components/CardSettingsScope/CardSettingsScope.stories.ts"
+        }
+      ]
+    },
+    "api": {
+      "props": {
+        "areaControls": {
+          "type": "string | undefined",
+          "resolvedType": "string | undefined",
+          "attribute": "area-controls",
+          "required": false,
+          "mutable": false,
+          "description": "ID of the application-owned product-area menu."
+        },
+        "areaExpanded": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "area-expanded",
+          "default": "false",
+          "required": false,
+          "mutable": false,
+          "description": "Whether the product-area menu is open."
+        },
+        "areaLabel": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "area-label",
+          "default": "'All settings'",
+          "required": false,
+          "mutable": false,
+          "description": "Current product area or the label for the combined settings view."
+        },
+        "forLabel": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "for-label",
+          "default": "'for'",
+          "required": false,
+          "mutable": false,
+          "description": "Sentence connector, supplied separately for localization."
+        },
+        "managingLabel": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "managing-label",
+          "default": "'Managing'",
+          "required": false,
+          "mutable": false,
+          "description": "Sentence prefix, supplied separately for localization."
+        },
+        "profileControls": {
+          "type": "string | undefined",
+          "resolvedType": "string | undefined",
+          "attribute": "profile-controls",
+          "required": false,
+          "mutable": false,
+          "description": "ID of the application-owned profiles popup."
+        },
+        "profileExpanded": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "profile-expanded",
+          "default": "false",
+          "required": false,
+          "mutable": false,
+          "description": "Whether the profiles popup is open."
+        },
+        "profileLabel": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "profile-label",
+          "default": "'Organization'",
+          "required": false,
+          "mutable": false,
+          "description": "Current organization or settings profile."
+        },
+        "profilePopup": {
+          "type": "'menu' | 'dialog'",
+          "resolvedType": "\"dialog\" | \"menu\"",
+          "attribute": "profile-popup",
+          "default": "'menu'",
+          "required": false,
+          "mutable": false,
+          "description": "Empty informational profile popups use dialog semantics instead of a menu."
+        },
+        "scopeLabel": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "scope-label",
+          "default": "'Settings scope'",
+          "required": false,
+          "mutable": false,
+          "description": "Accessible name for this context region."
+        }
+      },
+      "events": [
+        {
+          "name": "dsScopeRequest",
+          "detail": "SettingsScopeRequest",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "description": "Requests a popup; the owner supplies choices, open state, and selection."
+        }
+      ],
+      "methods": [],
+      "slots": []
+    },
+    "props": {
+      "areaControls": {
+        "type": "string | undefined",
+        "resolvedType": "string | undefined",
+        "attribute": "area-controls",
+        "required": false,
+        "mutable": false,
+        "description": "ID of the application-owned product-area menu."
+      },
+      "areaExpanded": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "area-expanded",
+        "default": "false",
+        "required": false,
+        "mutable": false,
+        "description": "Whether the product-area menu is open."
+      },
+      "areaLabel": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "area-label",
+        "default": "'All settings'",
+        "required": false,
+        "mutable": false,
+        "description": "Current product area or the label for the combined settings view."
+      },
+      "forLabel": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "for-label",
+        "default": "'for'",
+        "required": false,
+        "mutable": false,
+        "description": "Sentence connector, supplied separately for localization."
+      },
+      "managingLabel": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "managing-label",
+        "default": "'Managing'",
+        "required": false,
+        "mutable": false,
+        "description": "Sentence prefix, supplied separately for localization."
+      },
+      "profileControls": {
+        "type": "string | undefined",
+        "resolvedType": "string | undefined",
+        "attribute": "profile-controls",
+        "required": false,
+        "mutable": false,
+        "description": "ID of the application-owned profiles popup."
+      },
+      "profileExpanded": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "profile-expanded",
+        "default": "false",
+        "required": false,
+        "mutable": false,
+        "description": "Whether the profiles popup is open."
+      },
+      "profileLabel": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "profile-label",
+        "default": "'Organization'",
+        "required": false,
+        "mutable": false,
+        "description": "Current organization or settings profile."
+      },
+      "profilePopup": {
+        "type": "'menu' | 'dialog'",
+        "resolvedType": "\"dialog\" | \"menu\"",
+        "attribute": "profile-popup",
+        "default": "'menu'",
+        "required": false,
+        "mutable": false,
+        "description": "Empty informational profile popups use dialog semantics instead of a menu."
+      },
+      "scopeLabel": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "scope-label",
+        "default": "'Settings scope'",
+        "required": false,
+        "mutable": false,
+        "description": "Accessible name for this context region."
+      }
+    },
+    "events": [
+      {
+        "name": "dsScopeRequest",
+        "detail": "SettingsScopeRequest",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "description": "Requests a popup; the owner supplies choices, open state, and selection."
+      }
+    ],
+    "methods": [],
+    "slots": [],
+    "exports": {
+      "customElement": "ds-card-settings-scope",
+      "react": "DsCardSettingsScope",
+      "vue": "DsCardSettingsScope",
+      "angular": "DsCardSettingsScope"
+    },
+    "consumption": {
+      "install": "npm install @ds-mo/ui @ds-mo/tokens @ds-mo/icons",
+      "cssSetup": "import '@ds-mo/tokens';\nimport '@ds-mo/tokens/reset';\nimport '@ds-mo/tokens/globals';",
+      "customElements": {
+        "import": "import '@ds-mo/ui/dist/components/ds-card-settings-scope.js';",
+        "example": "<ds-card-settings-scope></ds-card-settings-scope>"
+      },
+      "react": {
+        "import": "import { DsCardSettingsScope } from '@ds-mo/ui/react';",
+        "example": "<DsCardSettingsScope />"
+      },
+      "vue": {
+        "import": "import { DsCardSettingsScope } from '@ds-mo/ui/vue';",
+        "example": "<DsCardSettingsScope />"
+      },
+      "angular": {
+        "import": "import { DsCardSettingsScope } from '@ds-mo/ui/angular/ds-card-settings-scope';",
+        "example": "<ds-card-settings-scope></ds-card-settings-scope>"
+      },
+      "peerDependencies": {
+        "required": [
+          "@ds-mo/tokens ^6.5.1",
+          "@ds-mo/icons ^7.0.0"
+        ],
+        "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
+      }
+    }
+  },
+  "dependencies": [
+    "@ds-mo/ui",
+    "@ds-mo/tokens"
+  ],
+  "registryDependencies": [
+    "text"
+  ],
+  "files": [
+    {
+      "path": "src/wc/components/CardSettingsScope/CardSettingsScope.css",
+      "content": "@import '../../utils/text-decoration.css';\n@import '../../utils/focus-ring.css';\n@import '../../styles/control-elevation.css';\n\n:host {\n  display: block;\n  min-width: 0;\n  width: var(--dimension-card-width-md);\n  max-width: 100%;\n}\n\n.card-settings-scope {\n  display: flex;\n  align-items: center;\n  flex-wrap: wrap;\n  gap: 0 var(--dimension-space-050);\n  box-sizing: border-box;\n  min-height: var(--dimension-size-600);\n  padding: var(--dimension-space-100) var(--dimension-space-200);\n  border-radius: var(--dimension-radius-125);\n  background: var(--color-background-primary);\n  color: var(--color-foreground-primary);\n}\n\n.card-settings-scope__action {\n  display: inline-flex;\n  align-items: center;\n  min-height: var(--dimension-size-400);\n  max-width: 100%;\n  margin: 0;\n  padding: 0;\n  border: 0;\n  border-radius: var(--dimension-radius-025);\n  background: transparent;\n  cursor: pointer;\n}\n\n.card-settings-scope__action ds-text {\n  overflow-wrap: anywhere;\n  text-align: start;\n}\n\n@media (forced-colors: active) {\n  .card-settings-scope {\n    outline: var(--dimension-stroke-width-012) solid var(--ds-forced-color-content);\n    outline-offset: calc(-1 * var(--dimension-stroke-width-012));\n  }\n}\n",
+      "type": "registry:ui"
+    },
+    {
+      "path": "src/wc/components/CardSettingsScope/CardSettingsScope.tsx",
+      "content": "import { Component, Event, EventEmitter, h, Host, Prop } from '@stencil/core';\n\nexport interface SettingsScopeRequest {\n  scope: 'area' | 'profile';\n  anchor: HTMLButtonElement;\n  originalEvent: MouseEvent;\n}\n\n@Component({\n  tag: 'ds-card-settings-scope',\n  styleUrl: 'CardSettingsScope.css',\n  scoped: true,\n})\nexport class CardSettingsScope {\n  /** Current product area or the label for the combined settings view. */\n  @Prop() areaLabel: string = 'All settings';\n  /** Current organization or settings profile. */\n  @Prop() profileLabel: string = 'Organization';\n  /** Sentence prefix, supplied separately for localization. */\n  @Prop() managingLabel: string = 'Managing';\n  /** Sentence connector, supplied separately for localization. */\n  @Prop() forLabel: string = 'for';\n  /** Accessible name for this context region. */\n  @Prop() scopeLabel: string = 'Settings scope';\n  /** ID of the application-owned product-area menu. */\n  @Prop() areaControls: string | undefined;\n  /** ID of the application-owned profiles popup. */\n  @Prop() profileControls: string | undefined;\n  /** Whether the product-area menu is open. */\n  @Prop() areaExpanded: boolean = false;\n  /** Whether the profiles popup is open. */\n  @Prop() profileExpanded: boolean = false;\n  /** Empty informational profile popups use dialog semantics instead of a menu. */\n  @Prop() profilePopup: 'menu' | 'dialog' = 'menu';\n\n  /** Requests a popup; the owner supplies choices, open state, and selection. */\n  @Event() dsScopeRequest!: EventEmitter<SettingsScopeRequest>;\n\n  private request(scope: SettingsScopeRequest['scope'], event: MouseEvent) {\n    this.dsScopeRequest.emit({\n      scope,\n      anchor: event.currentTarget as HTMLButtonElement,\n      originalEvent: event,\n    });\n  }\n\n  render() {\n    return (\n      <Host>\n        <div\n          class=\"card-settings-scope ds-control-elevation ds-control-elevation--sm\"\n          role=\"region\"\n          aria-label={this.scopeLabel}\n        >\n          <ds-text as=\"span\" variant=\"text-body-medium\" color=\"primary\">\n            {this.managingLabel}\n          </ds-text>\n          <button\n            type=\"button\"\n            class=\"card-settings-scope__action ds-text-action ds-focus-ring\"\n            aria-haspopup=\"menu\"\n            aria-controls={this.areaControls}\n            aria-expanded={String(this.areaExpanded)}\n            onClick={event => this.request('area', event)}\n          >\n            <ds-text as=\"span\" variant=\"text-body-medium\" color=\"inherit\">\n              {this.areaLabel}\n            </ds-text>\n          </button>\n          <ds-text as=\"span\" variant=\"text-body-medium\" color=\"primary\">\n            {this.forLabel}\n          </ds-text>\n          <button\n            type=\"button\"\n            class=\"card-settings-scope__action ds-text-action ds-focus-ring\"\n            aria-haspopup={this.profilePopup}\n            aria-controls={this.profileControls}\n            aria-expanded={String(this.profileExpanded)}\n            onClick={event => this.request('profile', event)}\n          >\n            <ds-text as=\"span\" variant=\"text-body-medium\" color=\"inherit\">\n              {this.profileLabel}\n            </ds-text>\n          </button>\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "type": "registry:ui"
+    }
+  ]
+}

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

@@ -59,7 +59,8 @@
         "Range selection applies the first date immediately as a one-day range; while an end is pending, that selected start retains its bold treatment and hovering or focusing another day paints the rest of the provisional inclusive span faint without emitting a value. A second activation completes an ordered inclusive range and gives both edges the bold treatment. A new activation after completion starts a replacement range.",
         "Selection applies immediately and does not close the popup.",
         "Changing category replaces the option-pane subtree so checkbox and other option visuals mount in their new state instead of transitioning from the previous category's row state.",
-        "The trigger reports how many filter categories have selections. footerLayout=summary adds a full-width selected-count footer only while values are selected; footerLayout=categories-clear always reserves the category-pane footer height while keeping its inactive divider hidden, then reveals the divider and only its left-aligned Clear action while values are selected."
+        "The trigger reports how many filter categories have selections. footerLayout=summary adds a full-width selected-count footer only while values are selected; footerLayout=categories-clear always reserves the category-pane footer height while keeping its inactive divider hidden, then reveals the divider and only its left-aligned Clear action while values are selected.",
+        "The built-in trigger derives the shared surface-open wash from the rendered popup lifecycle, including closing. For an external trigger, the application owns that relationship and retains the wash until dsAfterClose; selected filter values remain independent."
       ],
       "responsiveBehavior": [
         "The popup defaults to the large menu-width token and clamps to the nearest data-ds-overlay-boundary rectangle or the viewport fallback.",
@@ -82,6 +83,10 @@
         {
           "label": "Storybook example",
           "path": "src/wc/components/FilterMenu/FilterMenu.stories.ts"
+        },
+        {
+          "label": "Surface ownership and trigger state",
+          "path": "src/docs/SurfaceOwnership.mdx"
         }
       ]
     },
@@ -791,7 +796,7 @@
     },
     {
       "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  dateFilterRangeValue,\n  dateFilterRelativeValue,\n  parseDateFilterValue,\n  resolveChoicePopupAlignOffset,\n  resolveCssLengthPx,\n  resolveMotionTimeMs,\n  shiftIsoCalendarDate,\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';\nimport {\n  FILTER_MENU_WEEKDAYS,\n  filterMenuCalendarDays,\n  filterMenuCalendarMonth,\n  filterMenuCalendarMonthLabel,\n  filterMenuToday,\n  shiftFilterMenuCalendarMonth,\n} from './filter-menu-calendar';\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  @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  @Prop() hasBorder: boolean = true;\n  /** Show selected interaction fill when one or more criteria are active. */\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 calendarMonthByFilter: Record<string, string> = {};\n  @State() private pendingRangeStartByFilter: Record<string, string> = {};\n  @State() private previewRangeEndByFilter: Record<string, string> = {};\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.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.shouldRender || 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.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.calendarMonthByFilter = {};\n    this.pendingRangeStartByFilter = {};\n    this.previewRangeEndByFilter = {};\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.dsChange.emit({ 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.dsChange.emit({ 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, value: FilterMenuValue | undefined, mode: string) {\n    if (mode !== 'range' && mode !== 'relative') return;\n    this.dateModeByFilter = { ...this.dateModeByFilter, [filter.id]: mode };\n    this.activeOptionIndex = 0;\n    if (mode === 'range' && !this.calendarMonthByFilter[filter.id]) {\n      const parsed = parseDateFilterValue(value);\n      const initialDate = parsed?.kind === 'range' ? parsed.start : filterMenuToday();\n      this.calendarMonthByFilter = {\n        ...this.calendarMonthByFilter,\n        [filter.id]: filterMenuCalendarMonth(initialDate),\n      };\n    }\n    if (mode === 'relative' && this.pendingRangeStartByFilter[filter.id]) {\n      const next = { ...this.pendingRangeStartByFilter };\n      delete next[filter.id];\n      this.pendingRangeStartByFilter = next;\n    }\n    if (mode === 'relative') this.clearCalendarRangePreview(filter.id);\n  }\n\n  private calendarMonth(filterId: string, value: FilterMenuValue | undefined): string {\n    const parsed = parseDateFilterValue(value);\n    const initialDate = parsed?.kind === 'range' ? parsed.start : filterMenuToday();\n    return this.calendarMonthByFilter[filterId] ?? filterMenuCalendarMonth(initialDate);\n  }\n\n  private moveCalendarMonth(filterId: string, month: string, offset: number) {\n    this.clearCalendarRangePreview(filterId);\n    this.calendarMonthByFilter = {\n      ...this.calendarMonthByFilter,\n      [filterId]: shiftFilterMenuCalendarMonth(month, offset),\n    };\n  }\n\n  private selectCalendarDate(filterId: string, value: string) {\n    this.clearCalendarRangePreview(filterId);\n    const pendingStart = this.pendingRangeStartByFilter[filterId];\n    const next = { ...this.pendingRangeStartByFilter };\n    if (pendingStart) delete next[filterId];\n    else next[filterId] = value;\n    this.pendingRangeStartByFilter = next;\n    this.dsChange.emit({\n      filterId,\n      value: dateFilterRangeValue(pendingStart ?? value, value),\n    });\n  }\n\n  private previewCalendarRange(filterId: string, value: string) {\n    if (!this.pendingRangeStartByFilter[filterId]) return;\n    if (this.previewRangeEndByFilter[filterId] === value) return;\n    this.previewRangeEndByFilter = { ...this.previewRangeEndByFilter, [filterId]: value };\n  }\n\n  private clearCalendarRangePreview(filterId: string) {\n    if (!this.previewRangeEndByFilter[filterId]) return;\n    const next = { ...this.previewRangeEndByFilter };\n    delete next[filterId];\n    this.previewRangeEndByFilter = next;\n  }\n\n  private focusCalendarDate(filterId: string, value: string) {\n    this.previewCalendarRange(filterId, value);\n    const targetMonth = filterMenuCalendarMonth(value);\n    if (this.calendarMonthByFilter[filterId] !== targetMonth) {\n      this.calendarMonthByFilter = { ...this.calendarMonthByFilter, [filterId]: targetMonth };\n    }\n    requestAnimationFrame(() => {\n      this.el.querySelector<HTMLElement>(`[data-date-option=\"${value}\"]`)?.focus();\n    });\n  }\n\n  private handleCalendarDayKeyDown(event: KeyboardEvent, filterId: string, value: string) {\n    let offset: number | null = null;\n    if (event.key === 'ArrowLeft') offset = -1;\n    else if (event.key === 'ArrowRight') offset = 1;\n    else if (event.key === 'ArrowUp') offset = -7;\n    else if (event.key === 'ArrowDown') offset = 7;\n    else if (event.key === 'Home') {\n      offset = -new Date(`${value}T00:00:00Z`).getUTCDay();\n    } else if (event.key === 'End') {\n      offset = 6 - new Date(`${value}T00:00:00Z`).getUTCDay();\n    } else if (event.key === 'PageUp') {\n      const month = shiftFilterMenuCalendarMonth(filterMenuCalendarMonth(value), -1);\n      const day = value.slice(8, 10);\n      const candidate = `${month}-${day}`;\n      const target = parseDateFilterValue(candidate) ? candidate : `${month}-01`;\n      event.preventDefault();\n      this.focusCalendarDate(filterId, target);\n      return;\n    } else if (event.key === 'PageDown') {\n      const month = shiftFilterMenuCalendarMonth(filterMenuCalendarMonth(value), 1);\n      const day = value.slice(8, 10);\n      const candidate = `${month}-${day}`;\n      const target = parseDateFilterValue(candidate) ? candidate : `${month}-01`;\n      event.preventDefault();\n      this.focusCalendarDate(filterId, target);\n      return;\n    }\n    if (offset === null) return;\n    event.preventDefault();\n    this.focusCalendarDate(filterId, shiftIsoCalendarDate(value, offset));\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.dsChange.emit({ filterId: filter.id, value: option.value })}\n          />\n        ))}\n      </div>\n    );\n  }\n\n  private renderDateCalendar(filter: FilterMenuFilter, value: FilterMenuValue | undefined) {\n    const parsed = parseDateFilterValue(value);\n    const range = parsed?.kind === 'range' ? parsed : null;\n    const month = this.calendarMonth(filter.id, value);\n    const days = filterMenuCalendarDays(month);\n    const today = filterMenuToday();\n    const pendingStart = this.pendingRangeStartByFilter[filter.id];\n    const previewEnd = this.previewRangeEndByFilter[filter.id];\n    const previewStart = pendingStart && previewEnd ? [pendingStart, previewEnd].sort()[0] : null;\n    const previewFinish = pendingStart && previewEnd ? [pendingStart, previewEnd].sort()[1] : null;\n    const preferredFocus =\n      this.pendingRangeStartByFilter[filter.id] ??\n      range?.end ??\n      (month === today.slice(0, 7) ? today : '');\n    const focusDate = days.some(day => day.value === preferredFocus)\n      ? preferredFocus\n      : (days.find(day => day.inMonth)?.value ?? days[0]?.value);\n\n    return (\n      <div class=\"filter-menu__calendar\">\n        <div class=\"filter-menu__calendar-heading ds-control--md\">\n          <ds-button-unfilled\n            class=\"filter-menu__calendar-nav filter-menu__calendar-nav--previous\"\n            variant=\"icon\"\n            icon=\"ChevronLeft\"\n            size=\"md\"\n            hasBorder={false}\n            ariaLabel=\"Previous month\"\n            onDsClick={() => this.moveCalendarMonth(filter.id, month, -1)}\n          />\n          <ds-text as=\"span\" variant=\"text-body-medium\" emphasis color=\"primary\">\n            {filterMenuCalendarMonthLabel(month)}\n          </ds-text>\n          <ds-button-unfilled\n            class=\"filter-menu__calendar-nav filter-menu__calendar-nav--next\"\n            variant=\"icon\"\n            icon=\"ChevronRight\"\n            size=\"md\"\n            hasBorder={false}\n            ariaLabel=\"Next month\"\n            onDsClick={() => this.moveCalendarMonth(filter.id, month, 1)}\n          />\n        </div>\n        <div class=\"filter-menu__calendar-weekdays\" aria-hidden=\"true\">\n          {FILTER_MENU_WEEKDAYS.map(day => (\n            <ds-text as=\"span\" variant=\"text-body-small\" color=\"secondary\">\n              {day}\n            </ds-text>\n          ))}\n        </div>\n        <div\n          class=\"filter-menu__calendar-grid\"\n          role=\"grid\"\n          aria-label={filterMenuCalendarMonthLabel(month)}\n          onMouseLeave={() => this.clearCalendarRangePreview(filter.id)}\n        >\n          {days.map(day => {\n            const selectedInRange = Boolean(\n              range && day.value >= range.start && day.value <= range.end\n            );\n            const previewInRange = Boolean(\n              previewStart &&\n              previewFinish &&\n              day.value >= previewStart &&\n              day.value <= previewFinish\n            );\n            const inRange = previewInRange || selectedInRange;\n            const rangeEdge = Boolean(\n              previewStart\n                ? day.value === pendingStart\n                : range && (day.value === range.start || day.value === range.end)\n            );\n            const textColor = rangeEdge\n              ? 'on-bold'\n              : inRange || day.value === today\n                ? 'primary'\n                : day.inMonth\n                  ? 'secondary'\n                  : 'tertiary';\n            return (\n              <button\n                type=\"button\"\n                role=\"gridcell\"\n                data-date-option={day.value}\n                class={{\n                  'filter-menu__calendar-day': true,\n                  'filter-menu__calendar-day--outside': !day.inMonth,\n                  'filter-menu__calendar-day--today': day.value === today,\n                  'filter-menu__calendar-day--in-range': inRange,\n                  'filter-menu__calendar-day--range-preview': previewInRange,\n                  'filter-menu__calendar-day--range-edge': rangeEdge,\n                  'ds-focus-ring-inset': true,\n                  'ds-interaction-fill': true,\n                }}\n                aria-label={day.label}\n                aria-selected={selectedInRange ? 'true' : 'false'}\n                tabIndex={day.value === focusDate ? 0 : -1}\n                onMouseEnter={() => this.previewCalendarRange(filter.id, day.value)}\n                onFocus={() => this.previewCalendarRange(filter.id, day.value)}\n                onClick={() => this.selectCalendarDate(filter.id, day.value)}\n                onKeyDown={(event: KeyboardEvent) =>\n                  this.handleCalendarDayKeyDown(event, filter.id, day.value)\n                }\n              >\n                <ds-text\n                  class=\"ds-interaction-fill__content\"\n                  as=\"span\"\n                  variant=\"text-body-medium\"\n                  color={textColor}\n                  emphasis={day.value === today}\n                >\n                  {day.day}\n                </ds-text>\n              </button>\n            );\n          })}\n        </div>\n      </div>\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, value, 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.dsChange.emit({ filterId: filter.id, value: value !== true });\n            }\n          }}\n          onHover={() => {\n            this.focusRingVisible = false;\n          }}\n          onSelect={() => this.dsChange.emit({ 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    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={categoriesClear && totalSelected === 0 ? 'true' : undefined}\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          {totalSelected > 0 ? (\n            <button\n              class=\"filter-menu__clear ds-choice-footer__clear ds-text-action\"\n              type=\"button\"\n              onClick={() => {\n                this.pendingRangeStartByFilter = {};\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.dsMatchModeChange.emit({ 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    const state =\n      this.closing && this.closingSnapshot\n        ? this.closingSnapshot\n        : {\n            filters: this.filters,\n            values: this.values,\n            matchModes: 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                  'trigger--bordered': this.hasBorder,\n                  'trigger--has-value': hasActiveFilters,\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 ? 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 ? (\n          <div\n            id={popupId}\n            popover=\"manual\"\n            class={{\n              'filter-menu-popup': true,\n              'ds-choice-popup': true,\n              'ds-choice-popup--closing': this.closing,\n            }}\n            style={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  dateFilterRangeValue,\n  dateFilterRelativeValue,\n  parseDateFilterValue,\n  resolveChoicePopupAlignOffset,\n  resolveCssLengthPx,\n  resolveMotionTimeMs,\n  shiftIsoCalendarDate,\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';\nimport {\n  FILTER_MENU_WEEKDAYS,\n  filterMenuCalendarDays,\n  filterMenuCalendarMonth,\n  filterMenuCalendarMonthLabel,\n  filterMenuToday,\n  shiftFilterMenuCalendarMonth,\n} from './filter-menu-calendar';\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  @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  @Prop() hasBorder: boolean = true;\n  /** Show selected interaction fill when one or more criteria are active. */\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 calendarMonthByFilter: Record<string, string> = {};\n  @State() private pendingRangeStartByFilter: Record<string, string> = {};\n  @State() private previewRangeEndByFilter: Record<string, string> = {};\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.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.shouldRender || 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.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.calendarMonthByFilter = {};\n    this.pendingRangeStartByFilter = {};\n    this.previewRangeEndByFilter = {};\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.dsChange.emit({ 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.dsChange.emit({ 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, value: FilterMenuValue | undefined, mode: string) {\n    if (mode !== 'range' && mode !== 'relative') return;\n    this.dateModeByFilter = { ...this.dateModeByFilter, [filter.id]: mode };\n    this.activeOptionIndex = 0;\n    if (mode === 'range' && !this.calendarMonthByFilter[filter.id]) {\n      const parsed = parseDateFilterValue(value);\n      const initialDate = parsed?.kind === 'range' ? parsed.start : filterMenuToday();\n      this.calendarMonthByFilter = {\n        ...this.calendarMonthByFilter,\n        [filter.id]: filterMenuCalendarMonth(initialDate),\n      };\n    }\n    if (mode === 'relative' && this.pendingRangeStartByFilter[filter.id]) {\n      const next = { ...this.pendingRangeStartByFilter };\n      delete next[filter.id];\n      this.pendingRangeStartByFilter = next;\n    }\n    if (mode === 'relative') this.clearCalendarRangePreview(filter.id);\n  }\n\n  private calendarMonth(filterId: string, value: FilterMenuValue | undefined): string {\n    const parsed = parseDateFilterValue(value);\n    const initialDate = parsed?.kind === 'range' ? parsed.start : filterMenuToday();\n    return this.calendarMonthByFilter[filterId] ?? filterMenuCalendarMonth(initialDate);\n  }\n\n  private moveCalendarMonth(filterId: string, month: string, offset: number) {\n    this.clearCalendarRangePreview(filterId);\n    this.calendarMonthByFilter = {\n      ...this.calendarMonthByFilter,\n      [filterId]: shiftFilterMenuCalendarMonth(month, offset),\n    };\n  }\n\n  private selectCalendarDate(filterId: string, value: string) {\n    this.clearCalendarRangePreview(filterId);\n    const pendingStart = this.pendingRangeStartByFilter[filterId];\n    const next = { ...this.pendingRangeStartByFilter };\n    if (pendingStart) delete next[filterId];\n    else next[filterId] = value;\n    this.pendingRangeStartByFilter = next;\n    this.dsChange.emit({\n      filterId,\n      value: dateFilterRangeValue(pendingStart ?? value, value),\n    });\n  }\n\n  private previewCalendarRange(filterId: string, value: string) {\n    if (!this.pendingRangeStartByFilter[filterId]) return;\n    if (this.previewRangeEndByFilter[filterId] === value) return;\n    this.previewRangeEndByFilter = { ...this.previewRangeEndByFilter, [filterId]: value };\n  }\n\n  private clearCalendarRangePreview(filterId: string) {\n    if (!this.previewRangeEndByFilter[filterId]) return;\n    const next = { ...this.previewRangeEndByFilter };\n    delete next[filterId];\n    this.previewRangeEndByFilter = next;\n  }\n\n  private focusCalendarDate(filterId: string, value: string) {\n    this.previewCalendarRange(filterId, value);\n    const targetMonth = filterMenuCalendarMonth(value);\n    if (this.calendarMonthByFilter[filterId] !== targetMonth) {\n      this.calendarMonthByFilter = { ...this.calendarMonthByFilter, [filterId]: targetMonth };\n    }\n    requestAnimationFrame(() => {\n      this.el.querySelector<HTMLElement>(`[data-date-option=\"${value}\"]`)?.focus();\n    });\n  }\n\n  private handleCalendarDayKeyDown(event: KeyboardEvent, filterId: string, value: string) {\n    let offset: number | null = null;\n    if (event.key === 'ArrowLeft') offset = -1;\n    else if (event.key === 'ArrowRight') offset = 1;\n    else if (event.key === 'ArrowUp') offset = -7;\n    else if (event.key === 'ArrowDown') offset = 7;\n    else if (event.key === 'Home') {\n      offset = -new Date(`${value}T00:00:00Z`).getUTCDay();\n    } else if (event.key === 'End') {\n      offset = 6 - new Date(`${value}T00:00:00Z`).getUTCDay();\n    } else if (event.key === 'PageUp') {\n      const month = shiftFilterMenuCalendarMonth(filterMenuCalendarMonth(value), -1);\n      const day = value.slice(8, 10);\n      const candidate = `${month}-${day}`;\n      const target = parseDateFilterValue(candidate) ? candidate : `${month}-01`;\n      event.preventDefault();\n      this.focusCalendarDate(filterId, target);\n      return;\n    } else if (event.key === 'PageDown') {\n      const month = shiftFilterMenuCalendarMonth(filterMenuCalendarMonth(value), 1);\n      const day = value.slice(8, 10);\n      const candidate = `${month}-${day}`;\n      const target = parseDateFilterValue(candidate) ? candidate : `${month}-01`;\n      event.preventDefault();\n      this.focusCalendarDate(filterId, target);\n      return;\n    }\n    if (offset === null) return;\n    event.preventDefault();\n    this.focusCalendarDate(filterId, shiftIsoCalendarDate(value, offset));\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.dsChange.emit({ filterId: filter.id, value: option.value })}\n          />\n        ))}\n      </div>\n    );\n  }\n\n  private renderDateCalendar(filter: FilterMenuFilter, value: FilterMenuValue | undefined) {\n    const parsed = parseDateFilterValue(value);\n    const range = parsed?.kind === 'range' ? parsed : null;\n    const month = this.calendarMonth(filter.id, value);\n    const days = filterMenuCalendarDays(month);\n    const today = filterMenuToday();\n    const pendingStart = this.pendingRangeStartByFilter[filter.id];\n    const previewEnd = this.previewRangeEndByFilter[filter.id];\n    const previewStart = pendingStart && previewEnd ? [pendingStart, previewEnd].sort()[0] : null;\n    const previewFinish = pendingStart && previewEnd ? [pendingStart, previewEnd].sort()[1] : null;\n    const preferredFocus =\n      this.pendingRangeStartByFilter[filter.id] ??\n      range?.end ??\n      (month === today.slice(0, 7) ? today : '');\n    const focusDate = days.some(day => day.value === preferredFocus)\n      ? preferredFocus\n      : (days.find(day => day.inMonth)?.value ?? days[0]?.value);\n\n    return (\n      <div class=\"filter-menu__calendar\">\n        <div class=\"filter-menu__calendar-heading ds-control--md\">\n          <ds-button-unfilled\n            class=\"filter-menu__calendar-nav filter-menu__calendar-nav--previous\"\n            variant=\"icon\"\n            icon=\"ChevronLeft\"\n            size=\"md\"\n            hasBorder={false}\n            ariaLabel=\"Previous month\"\n            onDsClick={() => this.moveCalendarMonth(filter.id, month, -1)}\n          />\n          <ds-text as=\"span\" variant=\"text-body-medium\" emphasis color=\"primary\">\n            {filterMenuCalendarMonthLabel(month)}\n          </ds-text>\n          <ds-button-unfilled\n            class=\"filter-menu__calendar-nav filter-menu__calendar-nav--next\"\n            variant=\"icon\"\n            icon=\"ChevronRight\"\n            size=\"md\"\n            hasBorder={false}\n            ariaLabel=\"Next month\"\n            onDsClick={() => this.moveCalendarMonth(filter.id, month, 1)}\n          />\n        </div>\n        <div class=\"filter-menu__calendar-weekdays\" aria-hidden=\"true\">\n          {FILTER_MENU_WEEKDAYS.map(day => (\n            <ds-text as=\"span\" variant=\"text-body-small\" color=\"secondary\">\n              {day}\n            </ds-text>\n          ))}\n        </div>\n        <div\n          class=\"filter-menu__calendar-grid\"\n          role=\"grid\"\n          aria-label={filterMenuCalendarMonthLabel(month)}\n          onMouseLeave={() => this.clearCalendarRangePreview(filter.id)}\n        >\n          {days.map(day => {\n            const selectedInRange = Boolean(\n              range && day.value >= range.start && day.value <= range.end\n            );\n            const previewInRange = Boolean(\n              previewStart &&\n              previewFinish &&\n              day.value >= previewStart &&\n              day.value <= previewFinish\n            );\n            const inRange = previewInRange || selectedInRange;\n            const rangeEdge = Boolean(\n              previewStart\n                ? day.value === pendingStart\n                : range && (day.value === range.start || day.value === range.end)\n            );\n            const textColor = rangeEdge\n              ? 'on-bold'\n              : inRange || day.value === today\n                ? 'primary'\n                : day.inMonth\n                  ? 'secondary'\n                  : 'tertiary';\n            return (\n              <button\n                type=\"button\"\n                role=\"gridcell\"\n                data-date-option={day.value}\n                class={{\n                  'filter-menu__calendar-day': true,\n                  'filter-menu__calendar-day--outside': !day.inMonth,\n                  'filter-menu__calendar-day--today': day.value === today,\n                  'filter-menu__calendar-day--in-range': inRange,\n                  'filter-menu__calendar-day--range-preview': previewInRange,\n                  'filter-menu__calendar-day--range-edge': rangeEdge,\n                  'ds-focus-ring-inset': true,\n                  'ds-interaction-fill': true,\n                }}\n                aria-label={day.label}\n                aria-selected={selectedInRange ? 'true' : 'false'}\n                tabIndex={day.value === focusDate ? 0 : -1}\n                onMouseEnter={() => this.previewCalendarRange(filter.id, day.value)}\n                onFocus={() => this.previewCalendarRange(filter.id, day.value)}\n                onClick={() => this.selectCalendarDate(filter.id, day.value)}\n                onKeyDown={(event: KeyboardEvent) =>\n                  this.handleCalendarDayKeyDown(event, filter.id, day.value)\n                }\n              >\n                <ds-text\n                  class=\"ds-interaction-fill__content\"\n                  as=\"span\"\n                  variant=\"text-body-medium\"\n                  color={textColor}\n                  emphasis={day.value === today}\n                >\n                  {day.day}\n                </ds-text>\n              </button>\n            );\n          })}\n        </div>\n      </div>\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, value, 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.dsChange.emit({ filterId: filter.id, value: value !== true });\n            }\n          }}\n          onHover={() => {\n            this.focusRingVisible = false;\n          }}\n          onSelect={() => this.dsChange.emit({ 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    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={categoriesClear && totalSelected === 0 ? 'true' : undefined}\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          {totalSelected > 0 ? (\n            <button\n              class=\"filter-menu__clear ds-choice-footer__clear ds-text-action\"\n              type=\"button\"\n              onClick={() => {\n                this.pendingRangeStartByFilter = {};\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.dsMatchModeChange.emit({ 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    const state =\n      this.closing && this.closingSnapshot\n        ? this.closingSnapshot\n        : {\n            filters: this.filters,\n            values: this.values,\n            matchModes: 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,\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 ? 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 ? (\n          <div\n            id={popupId}\n            popover=\"manual\"\n            class={{\n              'filter-menu-popup': true,\n              'ds-choice-popup': true,\n              'ds-choice-popup--closing': this.closing,\n            }}\n            style={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"
     },
     {