@ds-mo/ui 14.19.1 → 14.21.0

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

@@ -2,7 +2,7 @@
   "$schema": "https://ui.shadcn.com/schema/registry-item.json",
   "name": "filter-menu",
   "title": "FilterMenu",
-  "description": "Controlled two-pane filter select with menu-recipe category navigation, single- and multiple-choice, boolean, and date filters, selected counts, and a clear action.",
+  "description": "Controlled two-pane filter select with menu-recipe category navigation, local option search for non-date categories, single- and multiple-choice, boolean, semantic relative-date and fixed-range filters, selected counts, and a clear action.",
   "type": "registry:ui",
   "meta": {
     "library": "@ds-mo/ui",
@@ -13,7 +13,7 @@
     "intent": {
       "audience": "general",
       "status": "stable",
-      "summary": "Controlled two-pane filter select with menu-recipe category navigation, single- and multiple-choice, boolean, and date filters, selected counts, and a clear action.",
+      "summary": "Controlled two-pane filter select with menu-recipe category navigation, local option search for non-date categories, single- and multiple-choice, boolean, semantic relative-date and fixed-range filters, selected counts, and a clear action.",
       "useWhen": [
         "A compact trigger must expose several filter families without turning the toolbar into many separate controls.",
         "Users need to move between persistent filter categories while editing the selected category in a second pane."
@@ -43,16 +43,23 @@
       "accessibility": [
         "The built-in select trigger exposes combobox semantics with a dialog popup, synchronizes expanded state, holds the pressed interaction wash without changing resting foreground while open, and restores focus after dismissal.",
         "The category pane is a vertical tab list. Arrow Up and Arrow Down wrap, Home and End jump, Arrow Right enters the option pane, and Arrow Left returns to the active category.",
+        "Every non-date category begins with a labelled search field. Arrow Down and Arrow Up enter the first or last visible option, while Left and Right retain native text-caret behavior. Search matches option labels and descriptions without changing selected values.",
         "Escape and outside activation close the popup and restore trigger focus. Tab moves through option controls and closes only when it leaves the popup boundary.",
+        "Date filters expose containerless Range and Relative tabs in a secondary-background header with 4px padding around the 32px medium control. Relative presets use listbox semantics; the range calendar exposes a labelled grid, one tab stop, arrow-key day navigation, Home and End week navigation, and Page Up or Page Down month navigation. After a range start is chosen, pointer hover and keyboard focus preview the possible inclusive range without changing selection semantics.",
         "When an external trigger is inside an open shadow tree, pass its HTMLElement through anchor so outside activation, focus return, and Tab continuation use the composed tree.",
-        "The trigger count reports active filter categories. Category counts and the footer report individual selected criteria; none replace visible selected-state indication."
+        "The trigger count reports active filter categories. Multiple-choice category tags report individual selected criteria, while an applied Date category uses a visual dot because its value is singular. The default summary footer announces the total; the categories-clear footer recipe reserves a visually empty category-pane action row and exposes its divider and only Clear when criteria are active."
       ],
       "states": [
-        "The application owns filters, values, activeFilterId, and open. Replace controlled objects and arrays after dsChange, dsActiveFilterChange, dsClear, or dsClose.",
-        "Single filters return a string, multiple filters return ordered string arrays, boolean filters return a boolean, and date filters return a YYYY-MM-DD string.",
+        "The application owns filters, values, matchModes, activeFilterId, and open. Replace controlled objects and arrays after dsChange, dsMatchModeChange, dsActiveFilterChange, dsClear, or dsClose.",
+        "Single filters return a string, multiple filters return ordered string arrays, boolean filters return a boolean, and date filters return a serializable semantic string.",
+        "Multiple filters expose a right-pane footer reading Limit results to any or all selected. any is the default OR mode. Activating the blue mode word requests the opposite controlled mode through dsMatchModeChange; the application owns the corresponding query semantics.",
+        "Non-date option search is internal, scoped independently per category while the popup remains open, and reset after the popup closes. An unmatched query shows the configurable noResultsText empty state. Date uses its Relative and Range modes instead of option search.",
+        "Date values are serializable semantic strings: relative:<preset> preserves a relative choice for future resolution and range:<start>/<end> preserves fixed inclusive ISO calendar dates. A legacy YYYY-MM-DD value is interpreted as a one-day range.",
+        "Relative presets are Today, Yesterday, and the last 7, 14, 30, 60, or 90 inclusive calendar days. Applications resolve them against their current product date and time-zone policy by using resolveDateFilterRange from @ds-mo/ui/utils.",
+        "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, while the footer appears when values are selected and reports the total selected criteria."
+        "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."
       ],
       "responsiveBehavior": [
         "The popup defaults to the large menu-width token and clamps to the nearest data-ds-overlay-boundary rectangle or the viewport fallback.",
@@ -62,13 +69,13 @@
       ],
       "frameworkCaveats": {
         "customElements": [
-          "Assign filters and values as JavaScript properties after the element is defined."
+          "Assign filters, values, and matchModes as JavaScript properties after the element is defined."
         ],
         "react": [
-          "Pass filters and values as controlled props and handle onDsChange, onDsActiveFilterChange, onDsClear, and onDsClose."
+          "Pass filters, values, and matchModes as controlled props and handle onDsChange, onDsMatchModeChange, onDsActiveFilterChange, onDsClear, and onDsClose."
         ],
         "angular": [
-          "Use property bindings for filters and values and event bindings for dsChange, dsActiveFilterChange, dsClear, and dsClose."
+          "Use property bindings for filters, values, and matchModes and event bindings for dsChange, dsMatchModeChange, dsActiveFilterChange, dsClear, and dsClose."
         ]
       },
       "references": [
@@ -181,6 +188,15 @@
           "mutable": false,
           "description": "Product-owned filter categories and option definitions."
         },
+        "footerLayout": {
+          "type": "FilterMenuFooterLayout",
+          "resolvedType": "\"categories-clear\" | \"summary\"",
+          "attribute": "footer-layout",
+          "default": "'summary'",
+          "required": false,
+          "mutable": false,
+          "description": "Footer recipe: full-width selected summary or reserved category-pane Clear action."
+        },
         "hasBorder": {
           "type": "boolean",
           "resolvedType": "boolean",
@@ -216,6 +232,14 @@
           "mutable": false,
           "description": "ID applied to the internal select trigger."
         },
+        "matchModes": {
+          "type": "FilterMenuMatchModes",
+          "resolvedType": "{ [x: string]: FilterMenuMatchMode | undefined; }",
+          "default": "{}",
+          "required": false,
+          "mutable": false,
+          "description": "Controlled any/all match mode keyed by multiple-choice filter id. Defaults to any."
+        },
         "menuLabel": {
           "type": "string",
           "resolvedType": "string",
@@ -234,6 +258,15 @@
           "mutable": false,
           "description": "Popup width. It remains clamped to its collision boundary by the component recipe."
         },
+        "noResultsText": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "no-results-text",
+          "default": "'No results'",
+          "required": false,
+          "mutable": false,
+          "description": "Empty-state text shown when an option search has no matches."
+        },
         "open": {
           "type": "boolean",
           "resolvedType": "boolean",
@@ -243,6 +276,24 @@
           "mutable": true,
           "description": "Controlled popup visibility."
         },
+        "searchPlaceholder": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "search-placeholder",
+          "default": "'Search'",
+          "required": false,
+          "mutable": false,
+          "description": "Placeholder shown in each non-date option search header."
+        },
+        "showSelectedCount": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "show-selected-count",
+          "default": "true",
+          "required": false,
+          "mutable": false,
+          "description": "Append the active-filter count to the visible trigger label."
+        },
         "side": {
           "type": "AnchoredSide",
           "resolvedType": "\"bottom\" | \"left\" | \"right\" | \"top\"",
@@ -277,7 +328,7 @@
           "default": "'Filters'",
           "required": false,
           "mutable": false,
-          "description": "Select trigger text. The selected count is appended automatically."
+          "description": "Select trigger text."
         },
         "values": {
           "type": "FilterMenuValues",
@@ -338,6 +389,14 @@
           "composed": true,
           "description": "Requests that the controlled popup close."
         },
+        {
+          "name": "dsMatchModeChange",
+          "detail": "FilterMenuMatchModeChangeDetail",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "description": "Requests a controlled any/all mode replacement for a multiple-choice filter."
+        },
         {
           "name": "dsOpenChange",
           "detail": "boolean",
@@ -452,6 +511,15 @@
         "mutable": false,
         "description": "Product-owned filter categories and option definitions."
       },
+      "footerLayout": {
+        "type": "FilterMenuFooterLayout",
+        "resolvedType": "\"categories-clear\" | \"summary\"",
+        "attribute": "footer-layout",
+        "default": "'summary'",
+        "required": false,
+        "mutable": false,
+        "description": "Footer recipe: full-width selected summary or reserved category-pane Clear action."
+      },
       "hasBorder": {
         "type": "boolean",
         "resolvedType": "boolean",
@@ -487,6 +555,14 @@
         "mutable": false,
         "description": "ID applied to the internal select trigger."
       },
+      "matchModes": {
+        "type": "FilterMenuMatchModes",
+        "resolvedType": "{ [x: string]: FilterMenuMatchMode | undefined; }",
+        "default": "{}",
+        "required": false,
+        "mutable": false,
+        "description": "Controlled any/all match mode keyed by multiple-choice filter id. Defaults to any."
+      },
       "menuLabel": {
         "type": "string",
         "resolvedType": "string",
@@ -505,6 +581,15 @@
         "mutable": false,
         "description": "Popup width. It remains clamped to its collision boundary by the component recipe."
       },
+      "noResultsText": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "no-results-text",
+        "default": "'No results'",
+        "required": false,
+        "mutable": false,
+        "description": "Empty-state text shown when an option search has no matches."
+      },
       "open": {
         "type": "boolean",
         "resolvedType": "boolean",
@@ -514,6 +599,24 @@
         "mutable": true,
         "description": "Controlled popup visibility."
       },
+      "searchPlaceholder": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "search-placeholder",
+        "default": "'Search'",
+        "required": false,
+        "mutable": false,
+        "description": "Placeholder shown in each non-date option search header."
+      },
+      "showSelectedCount": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "show-selected-count",
+        "default": "true",
+        "required": false,
+        "mutable": false,
+        "description": "Append the active-filter count to the visible trigger label."
+      },
       "side": {
         "type": "AnchoredSide",
         "resolvedType": "\"bottom\" | \"left\" | \"right\" | \"top\"",
@@ -548,7 +651,7 @@
         "default": "'Filters'",
         "required": false,
         "mutable": false,
-        "description": "Select trigger text. The selected count is appended automatically."
+        "description": "Select trigger text."
       },
       "values": {
         "type": "FilterMenuValues",
@@ -609,6 +712,14 @@
         "composed": true,
         "description": "Requests that the controlled popup close."
       },
+      {
+        "name": "dsMatchModeChange",
+        "detail": "FilterMenuMatchModeChangeDetail",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "description": "Requests a controlled any/all mode replacement for a multiple-choice filter."
+      },
       {
         "name": "dsOpenChange",
         "detail": "boolean",
@@ -645,7 +756,7 @@
         "import": "import { DsFilterMenu } from '@ds-mo/ui/angular/ds-filter-menu';",
         "example": "<ds-filter-menu></ds-filter-menu>"
       },
-      "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: anchor, boundary, filters, values.",
+      "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: anchor, boundary, filters, matchModes, values.",
       "peerDependencies": {
         "required": [
           "@ds-mo/tokens ^6.5.0",
@@ -661,9 +772,13 @@
     "@ds-mo/icons"
   ],
   "registryDependencies": [
+    "badge",
     "button-unfilled",
     "checkbox",
+    "empty-state",
     "icon",
+    "input",
+    "tab-group",
     "tag",
     "text",
     "tooltip"
@@ -671,12 +786,17 @@
   "files": [
     {
       "path": "src/wc/components/FilterMenu/FilterMenu.css",
-      "content": "@import '../../utils/choice-list.css';\n@import '../../utils/control-parts.css';\n@import '../../utils/control-width.css';\n@import '../../utils/select-trigger.css';\n@import '../../utils/table-caption-control.css';\n\n:host(.filter-menu-host--external-trigger) {\n  display: contents;\n}\n\n.filter-menu {\n  display: flex;\n  min-height: 0;\n  flex-direction: column;\n  color: var(--color-foreground-primary);\n}\n\n.filter-menu__body {\n  display: grid;\n  grid-template-columns: minmax(calc(var(--dimension-size-base) * 18), 2fr) minmax(0, 3fr);\n  min-height: calc(var(--dimension-size-800) * 4 + var(--dimension-space-150));\n  max-height: calc(100vh - var(--dimension-size-800) - var(--dimension-size-600));\n}\n\n.filter-menu__categories {\n  min-width: 0;\n  border-inline-end: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n}\n\n.filter-menu__category-section {\n  display: flex;\n  min-width: 0;\n  flex-direction: column;\n}\n\n.filter-menu__category-section.ds-choice-section--divided {\n  padding-block-end: var(--dimension-space-050);\n}\n\n.filter-menu__category {\n  justify-content: space-between;\n  width: 100%;\n  border: 0;\n  background: transparent;\n  color: var(--color-foreground-secondary);\n  cursor: default;\n  text-align: start;\n}\n\n.filter-menu__category--active {\n  color: var(--color-foreground-primary);\n}\n\n.filter-menu__options {\n  min-width: 0;\n  overflow: hidden;\n}\n\n.filter-menu__date-field {\n  display: flex;\n  min-width: 0;\n  flex-direction: column;\n  align-items: stretch;\n  gap: var(--dimension-space-100);\n}\n\n.filter-menu__date-control {\n  width: 100%;\n  border-radius: var(--dimension-radius-025);\n  background: transparent;\n  box-shadow: inset 0 0 0 var(--dimension-stroke-width-012) var(--color-border-secondary);\n}\n\n.filter-menu__date-control:focus-within {\n  box-shadow: inset 0 0 0 var(--dimension-stroke-width-018) var(--color-border-bold-brand);\n}\n\n.filter-menu__date-input {\n  flex: 1 1 auto;\n  min-width: 0;\n  height: 100%;\n  padding-inline: var(--dimension-space-100);\n  border: 0;\n  outline: 0;\n  background: transparent;\n  color: var(--color-foreground-primary);\n  font: inherit;\n}\n\n.filter-menu__footer {\n  flex: 0 0 auto;\n}\n\n.filter-menu__clear {\n  color: var(--color-foreground-bold-brand);\n}\n\n@media (max-width: 520px) {\n  .filter-menu__body {\n    grid-template-columns: minmax(calc(var(--dimension-size-base) * 14), 2fr) minmax(0, 3fr);\n  }\n}\n\n@media (forced-colors: active) {\n  .filter-menu__categories {\n    border-inline-end-color: var(--ds-forced-color-content);\n  }\n\n  .filter-menu__date-control {\n    outline: var(--dimension-stroke-width-012) solid var(--ds-forced-color-content);\n  }\n}\n",
+      "content": "@import '../../utils/choice-list.css';\n@import '../../utils/chrome-header.css';\n@import '../../utils/control-parts.css';\n@import '../../utils/control-width.css';\n@import '../../utils/select-trigger.css';\n@import '../../utils/search-control.css';\n@import '../../utils/table-caption-control.css';\n\n:host(.filter-menu-host--external-trigger) {\n  display: contents;\n}\n\n.filter-menu {\n  display: flex;\n  min-height: 0;\n  flex-direction: column;\n  color: var(--color-foreground-secondary);\n}\n\n.filter-menu__body {\n  display: grid;\n  grid-template-columns: var(--dimension-menu-width-xs) var(--dimension-menu-width-sm);\n  min-height: calc(var(--dimension-size-800) * 4 + var(--dimension-space-150));\n  max-height: calc(100vh - var(--dimension-size-800) - var(--dimension-size-600));\n}\n\n.filter-menu__category-pane {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex-direction: column;\n  border-inline-end: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n}\n\n.filter-menu__categories {\n  flex: 1 1 auto;\n  min-width: 0;\n}\n\n.filter-menu__category-section {\n  display: flex;\n  min-width: 0;\n  flex-direction: column;\n}\n\n.filter-menu__category-section.ds-choice-section--divided {\n  padding-block-end: var(--dimension-space-050);\n}\n\n.filter-menu__category {\n  justify-content: space-between;\n  width: 100%;\n  border: 0;\n  background: transparent;\n  color: var(--color-foreground-secondary);\n  cursor: default;\n  text-align: start;\n}\n\n.filter-menu__category--active {\n  color: var(--color-foreground-primary);\n}\n\n.filter-menu__category-dot-box {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  flex-shrink: 0;\n  width: var(--ds-control-icon, var(--dimension-iconography-md));\n  height: var(--ds-control-icon, var(--dimension-iconography-md));\n  pointer-events: none;\n}\n\n.filter-menu__options {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex-direction: column;\n  overflow: hidden;\n}\n\n.filter-menu__options-content {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex: 1 1 auto;\n  flex-direction: column;\n  overflow: auto;\n}\n\n.filter-menu__option-search {\n  position: relative;\n  flex: 0 0 var(--dimension-size-500);\n  min-width: 0;\n  min-height: var(--dimension-size-500);\n  background: transparent;\n}\n\n.filter-menu__option-search::after {\n  content: '';\n  position: absolute;\n  inset: auto 0 0;\n  height: var(--dimension-stroke-width-012);\n  background-color: var(--color-border-tertiary);\n  pointer-events: none;\n}\n\n.filter-menu__option-search .select-search {\n  height: 100%;\n  background: transparent;\n}\n\n.filter-menu__options--date,\n.filter-menu__option-list--date,\n.filter-menu__date {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex-direction: column;\n}\n\n.filter-menu__option-list--date,\n.filter-menu__date {\n  flex: 1 1 auto;\n}\n\n.filter-menu__date-header {\n  flex: 0 0 var(--dimension-size-500);\n  justify-content: center;\n  min-block-size: var(--dimension-size-500);\n  padding: var(--dimension-space-050);\n  background: var(--color-background-secondary);\n}\n\n.filter-menu__date-body {\n  display: flex;\n  flex: 1 1 auto;\n  min-height: 0;\n  flex-direction: column;\n}\n\n.filter-menu__date-relative {\n  flex: 1 1 auto;\n}\n\n.filter-menu__calendar {\n  display: flex;\n  min-height: 0;\n  flex-direction: column;\n  padding: var(--dimension-space-100);\n}\n\n.filter-menu__calendar-heading {\n  display: grid;\n  grid-template-columns: var(--dimension-size-400) minmax(0, 1fr) var(--dimension-size-400);\n  align-items: center;\n  text-align: center;\n}\n\n.filter-menu__calendar-nav--previous {\n  justify-self: start;\n}\n\n.filter-menu__calendar-nav--next {\n  justify-self: end;\n}\n\n.filter-menu__calendar-weekdays,\n.filter-menu__calendar-grid {\n  display: grid;\n  grid-template-columns: repeat(7, minmax(0, 1fr));\n  column-gap: var(--dimension-space-050);\n}\n\n.filter-menu__calendar-grid {\n  row-gap: var(--dimension-space-050);\n}\n\n.filter-menu__calendar-weekdays {\n  align-items: center;\n  min-height: var(--dimension-size-400);\n  margin-block-start: var(--dimension-space-050);\n  color: var(--color-foreground-secondary);\n  text-align: center;\n}\n\n.filter-menu__calendar-day {\n  appearance: none;\n  position: relative;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  min-width: 0;\n  width: 100%;\n  height: var(--dimension-size-400);\n  padding: 0;\n  border: 0;\n  border-radius: var(--dimension-radius-025);\n  background: transparent;\n  color: var(--color-foreground-primary);\n  cursor: default;\n}\n\n.filter-menu__calendar-day--outside {\n  color: var(--color-foreground-tertiary);\n}\n\n.filter-menu__calendar-day--in-range {\n  background: var(--color-background-faint-brand);\n  color: var(--color-foreground-primary);\n}\n\n/* Pending range preview stays faint while the already-selected start keeps its bold edge. */\n.filter-menu__calendar-day--range-preview {\n  background: var(--color-background-faint-brand);\n}\n\n.filter-menu__calendar-day--today {\n  color: var(--color-foreground-primary);\n}\n\n.filter-menu__calendar-day--range-edge {\n  background: var(--color-background-bold-brand);\n  color: var(--color-foreground-on-bold-background-primary);\n}\n\n.filter-menu__footer {\n  flex: 0 0 auto;\n}\n\n.filter-menu__footer--categories-clear .ds-choice-footer__content {\n  justify-content: flex-start;\n}\n\n.filter-menu__footer--categories-clear[aria-hidden='true']::before {\n  visibility: hidden;\n}\n\n.filter-menu__clear {\n  color: var(--color-foreground-bold-brand);\n}\n\n.filter-menu__match-mode-footer {\n  flex: 0 0 auto;\n}\n\n.filter-menu__match-mode-content {\n  justify-content: flex-start;\n  padding-inline: calc(\n    var(--dimension-space-050) + var(--ds-control-padding-inline, var(--dimension-space-075)) +\n      var(--ds-control-label-inset, var(--dimension-space-025))\n  );\n}\n\n.filter-menu__match-mode-toggle {\n  appearance: none;\n  display: inline-flex;\n  align-items: center;\n  padding: 0;\n  border: 0;\n  border-radius: var(--dimension-radius-025);\n  background: transparent;\n  cursor: default;\n}\n\n@media (forced-colors: active) {\n  .filter-menu__category-pane {\n    border-inline-end-color: var(--ds-forced-color-content);\n  }\n\n  .filter-menu__calendar-day--range-edge {\n    outline: var(--dimension-stroke-width-012) solid var(--ds-forced-color-content);\n  }\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/FilterMenu/FilterMenu.tsx",
-      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Listen,\n  Prop,\n  State,\n  type VNode,\n  Watch,\n} from '@stencil/core';\nimport {\n  CONTROL_TEXT_VARIANT,\n  controlWidthClass,\n  resolveChoicePopupAlignOffset,\n  resolveCssLengthPx,\n  resolveMotionTimeMs,\n  TOKEN_CSS_LENGTHS,\n  TOKEN_DEFAULTS,\n  type ControlWidth,\n} from '../../utils';\nimport { observeTableCaptionCompact } from '../../utils/table-caption-compact';\nimport type { AnchoredAlign, AnchoredSide } from '../../utils/anchored-position';\nimport { AnchoredPositionController } from '../../utils/anchored-position-controller';\nimport { AnchoredOverlayInteractionController } from '../../utils/anchored-overlay-interaction-controller';\nimport { resolveAnchoredOverlayBoundaryRect } from '../../utils/anchored-overlay-boundary';\nimport { ChoiceOptionRow } from '../../utils/choice-list-parts';\nimport { choiceListUsesSubtext } from '../../utils/choice-list';\n\nexport type FilterMenuFilterKind = 'single' | 'multiple' | 'boolean' | 'date';\nexport type FilterMenuSize = 'lg' | 'md' | 'sm' | 'xs';\nexport type FilterMenuWidth = ControlWidth;\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>;\n\nexport interface FilterMenuChangeDetail {\n  filterId: string;\n  value: FilterMenuValue;\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\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. The selected count is appended automatically. */\n  @Prop() triggerLabel: string = 'Filters';\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 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  /** 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\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 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    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.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      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 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  ) {\n    const options = filter.options ?? [];\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 = options\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 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 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 options = filter.options ?? [];\n      const usesSubtext = choiceListUsesSubtext(\n        options.map(option => ({\n          label: option.label,\n          value: option.value,\n          subtext: option.description,\n        }))\n      );\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)\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: FilterMenuOption = {\n        label: filter.fieldLabel ?? filter.label,\n        value: 'true',\n        description: filter.description,\n      };\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    const dateValue = typeof value === 'string' ? value : '';\n    const inputId = `${this.generatedId}-${filter.id}-input`;\n    return (\n      <div class=\"filter-menu__date-field\">\n        <label htmlFor={inputId}>\n          <ds-text as=\"span\" variant=\"text-body-small\" emphasis color=\"primary\">\n            {filter.fieldLabel ?? 'Event date'}\n          </ds-text>\n        </label>\n        <div class=\"filter-menu__date-control ds-control-frame ds-control--md\">\n          <input\n            id={inputId}\n            class=\"filter-menu__date-input\"\n            type=\"date\"\n            value={dateValue}\n            onInput={(event: Event) =>\n              this.dsChange.emit({\n                filterId: filter.id,\n                value: (event.target as HTMLInputElement).value,\n              })\n            }\n          />\n          {dateValue ? (\n            <ds-button-unfilled\n              variant=\"icon\"\n              icon=\"CrossCircle\"\n              size=\"sm\"\n              isInset\n              hasBorder={false}\n              rounded\n              ariaLabel={`${this.clearLabel} ${filter.fieldLabel ?? filter.label}`}\n              onDsClick={(event: CustomEvent<MouseEvent>) => {\n                event.stopPropagation();\n                this.dsChange.emit({ filterId: filter.id, value: '' });\n              }}\n            />\n          ) : null}\n        </div>\n      </div>\n    );\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  render() {\n    const state =\n      this.closing && this.closingSnapshot\n        ? this.closingSnapshot\n        : {\n            filters: this.filters,\n            values: this.values,\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 label = `${this.triggerLabel}${hasActiveFilters ? ` · ${activeFilterCount}` : ''}`;\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\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 ? (\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\n                  <div\n                    id={`${this.generatedId}-panel`}\n                    class=\"filter-menu__options\"\n                    role=\"tabpanel\"\n                    aria-labelledby={`${this.generatedId}-${activeFilter.id}-tab`}\n                  >\n                    <div\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={activeFilter.kind === 'multiple' ? 'true' : undefined}\n                    >\n                      {this.renderOptions(activeFilter, state.values)}\n                    </div>\n                  </div>\n                </div>\n\n                {totalSelected > 0 ? (\n                  <div class=\"filter-menu__footer ds-choice-footer\">\n                    <div class=\"ds-choice-footer__content ds-control--md\">\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                      <button\n                        class=\"filter-menu__clear ds-choice-footer__clear ds-text-action\"\n                        type=\"button\"\n                        onClick={() => this.dsClear.emit()}\n                      >\n                        <ds-text as=\"span\" variant=\"text-body-medium\" color=\"inherit\">\n                          {this.clearLabel}\n                        </ds-text>\n                      </button>\n                    </div>\n                  </div>\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                  '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"
+    },
+    {
+      "path": "src/wc/components/FilterMenu/filter-menu-calendar.ts",
+      "content": "import { isIsoCalendarDate, shiftIsoCalendarDate } from '../../utils';\n\nexport interface FilterMenuCalendarDay {\n  value: string;\n  day: number;\n  inMonth: boolean;\n  label: string;\n}\n\nexport const FILTER_MENU_WEEKDAYS = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];\n\nconst MONTH_FORMATTER = new Intl.DateTimeFormat('en-US', {\n  month: 'long',\n  year: 'numeric',\n  timeZone: 'UTC',\n});\nconst DATE_FORMATTER = new Intl.DateTimeFormat('en-US', {\n  weekday: 'long',\n  month: 'long',\n  day: 'numeric',\n  year: 'numeric',\n  timeZone: 'UTC',\n});\n\nexport function filterMenuToday(): string {\n  const today = new Date();\n  const year = today.getFullYear();\n  const month = String(today.getMonth() + 1).padStart(2, '0');\n  const day = String(today.getDate()).padStart(2, '0');\n  return `${year}-${month}-${day}`;\n}\n\nexport function filterMenuCalendarMonth(value: string): string {\n  return isIsoCalendarDate(value) ? value.slice(0, 7) : filterMenuToday().slice(0, 7);\n}\n\nexport function shiftFilterMenuCalendarMonth(value: string, offset: number): string {\n  const [year, month] = value.split('-').map(Number);\n  const date = new Date(Date.UTC(year, month - 1 + offset, 1));\n  return `${date.getUTCFullYear()}-${String(date.getUTCMonth() + 1).padStart(2, '0')}`;\n}\n\nexport function filterMenuCalendarMonthLabel(value: string): string {\n  const [year, month] = value.split('-').map(Number);\n  return MONTH_FORMATTER.format(new Date(Date.UTC(year, month - 1, 1)));\n}\n\nexport function filterMenuCalendarDays(value: string): FilterMenuCalendarDay[] {\n  const [year, month] = value.split('-').map(Number);\n  const firstOfMonth = `${year}-${String(month).padStart(2, '0')}-01`;\n  const firstWeekday = new Date(`${firstOfMonth}T00:00:00Z`).getUTCDay();\n  const gridStart = shiftIsoCalendarDate(firstOfMonth, -firstWeekday);\n  return Array.from({ length: 42 }, (_, index) => {\n    const dateValue = shiftIsoCalendarDate(gridStart, index);\n    const date = new Date(`${dateValue}T00:00:00Z`);\n    return {\n      value: dateValue,\n      day: date.getUTCDate(),\n      inMonth: dateValue.startsWith(`${value}-`),\n      label: DATE_FORMATTER.format(date),\n    };\n  });\n}\n",
       "type": "registry:ui"
     }
   ]