@ds-mo/ui 15.5.1 → 15.6.0

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

@@ -218,7 +218,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -899,7 +899,7 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: anchor, boundary, filters, matchModes, values.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -221,7 +221,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

package/dist/mcp-data/registry/inline-banner-settings.json

@@ -146,7 +146,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -532,7 +532,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -570,7 +570,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -1037,7 +1037,7 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: suggestions, tokens.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -191,7 +191,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

package/dist/mcp-data/registry/map-cluster-marker.json

@@ -234,7 +234,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

package/dist/mcp-data/registry/map-entity-marker.json

@@ -290,7 +290,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -138,7 +138,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -2,7 +2,7 @@
   "$schema": "https://ui.shadcn.com/schema/registry-item.json",
   "name": "menu",
   "title": "Menu",
-  "description": "Anchored action menu with flat commands, grouped sections, single-selection choices, supplemental notification dots or trailing tags, prefix icons, reorderable rows, switches, and destructive actions.",
+  "description": "Anchored action menu with flat commands, grouped sections, single-selection choices, supplemental notification dots or trailing tags, prefix icons, reorderable rows, switches, independent trailing actions, separate trailing toggles, and destructive actions.",
   "type": "registry:ui",
   "meta": {
     "library": "@ds-mo/ui",
@@ -13,7 +13,7 @@
     "intent": {
       "audience": "general",
       "status": "stable",
-      "summary": "Anchored action menu with flat commands, grouped sections, single-selection choices, supplemental notification dots or trailing tags, prefix icons, reorderable rows, switches, and destructive actions.",
+      "summary": "Anchored action menu with flat commands, grouped sections, single-selection choices, supplemental notification dots or trailing tags, prefix icons, reorderable rows, switches, independent trailing actions, separate trailing toggles, and destructive actions.",
       "useWhen": [
         "A trigger reveals a short contextual list of commands or state-changing actions.",
         "Actions need grouping, mutually exclusive selected state, supplemental notification dots or trailing tags, prefix icons, reorderable switch or command rows, or destructive treatment."
@@ -60,7 +60,9 @@
         "When the anchor is inside an open shadow tree, pass its HTMLElement through anchor. Outside activation, focus return, and forward Tab continuation follow the composed tree across that boundary.",
         "Use notification dots only as supplemental status and not as the sole indication of important information.",
         "Trailing tags are non-interactive supplemental content; their visible label remains part of the menu item's accessible name.",
-        "Reorderable rows keep a presentation Drag handle. Pointer drag on the handle and Alt+Arrow Up or Down emit dsReorder without closing. Pointer cancellation abandons the pending move. Hide-locked reorderable rows expose aria-disabled for the unavailable toggle but stay focusable so they can move; fully locked rows stay out of the contiguous reorderable run.",
+        "Reorderable rows keep a presentation Drag handle. Pointer drag on the handle and Alt+Arrow Up or Down emit dsReorder without closing. Pointer cancellation abandons the pending move. Hide-locked reorderable rows expose aria-disabled for the unavailable toggle but stay focusable so they can move; fully locked rows stay out of the contiguous reorderable run. Use reorderHandleInactive to retain quaternary Drag dots without exposing drag interaction when a temporarily fixed row still needs visual alignment.",
+        "A row may append one separately focusable icon toggle after a decorative tertiary divider. The popup uses non-modal dialog semantics for this composite content, the row retains its primary command or visibility toggle, and dsItemToggle reports the requested controlled state without closing the surface.",
+        "A composite row may expose independent trailing icon actions without making its non-actionable row surface appear clickable. Active Drag handles and trailing actions own separate inset hover and pressed feedback. Each action has its own accessible name, does not use aria-pressed, and reports its stable action identity through dsItemToggle without closing the surface.",
         "Announce the new position through a polite live region that is a sibling of the role=menu popup, so the menu retains only permitted descendants."
       ],
       "states": [
@@ -74,7 +76,7 @@
         "Use a swatch-picker section for a small curated visual preference and apply dsSwatchSelect immediately without closing the popup.",
         "Ordinary rows, section headings, and supporting text consume the Menu size. At xs, both the primary label and supporting text use caption metrics.",
         "A trailing tag resolves one density smaller than its menu row and uses the inset recipe so it nests without changing row height. Do not combine tag, dot, and switch suffixes on one item.",
-        "Reorderable rows use the Drag prefix and ignore icon. Prefix and drag-handle icons inherit the choice-popup secondary foreground, matching Select. When any row in a section has an icon or is reorderable, the remaining rows get a spacer so labels align.",
+        "Reorderable rows use the Drag prefix and ignore icon. Active drag handles inherit the choice-popup secondary foreground; inactive drag handles use quaternary foreground. When any row in a section has an icon, an active handle, or an inactive handle, the remaining rows get a spacer so labels align.",
         "Embedded mode renders the same controlled content inside a parent-owned surface; the parent owns positioning, initial focus, Escape, Tab exit, and dismissal."
       ],
       "responsiveBehavior": [
@@ -88,13 +90,13 @@
       "frameworkCaveats": {
         "customElements": [
           "Assign items, sections, and HTMLElement anchors as properties after the element is defined.",
-          "Handle dsReorder by replacing the items or section items with the emitted items array; Menu never mutates order."
+          "Handle dsReorder by replacing the items or section items with the emitted items array; Menu never mutates order. Handle dsItemToggle by replacing either the controlled trailingToggle state or the requested trailingActions state without changing unrelated row state."
         ],
         "react": [
-          "Pass arrays and objects as wrapper props and handle generated onDsSelect, onDsReorder, and onDsClose event props."
+          "Pass arrays and objects as wrapper props and handle generated onDsSelect, onDsItemToggle, onDsReorder, and onDsClose event props."
         ],
         "angular": [
-          "Use property bindings for arrays, objects, and anchors and event bindings for dsSelect, dsReorder, and dsClose."
+          "Use property bindings for arrays, objects, and anchors and event bindings for dsSelect, dsItemToggle, dsReorder, and dsClose."
         ]
       },
       "references": [
@@ -308,6 +310,14 @@
           "cancelable": true,
           "composed": true
         },
+        {
+          "name": "dsItemToggle",
+          "detail": "MenuItemToggleDetail",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "description": "Emitted when a row's separate trailing toggle requests a controlled state change."
+        },
         {
           "name": "dsReorder",
           "detail": "MenuReorderDetail",
@@ -509,6 +519,14 @@
         "cancelable": true,
         "composed": true
       },
+      {
+        "name": "dsItemToggle",
+        "detail": "MenuItemToggleDetail",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "description": "Emitted when a row's separate trailing toggle requests a controlled state change."
+      },
       {
         "name": "dsReorder",
         "detail": "MenuReorderDetail",
@@ -563,7 +581,7 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: anchor, boundary, items, sections.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
@@ -577,6 +595,7 @@
   ],
   "registryDependencies": [
     "badge",
+    "button-unfilled",
     "icon",
     "swatch-picker",
     "switch",
@@ -586,12 +605,12 @@
   "files": [
     {
       "path": "src/wc/components/Menu/Menu.css",
-      "content": "@import '../../utils/radius.css';\n@import '../../utils/choice-list.css';\n@import '../../utils/visually-hidden.css';\n@import '../../utils/forced-colors.css';\n\n/* Inactive: `.ds-control-inactive` (50% opacity). */\n\n.menu-empty {\n  padding: var(--dimension-space-200);\n  box-sizing: border-box;\n  overflow-wrap: anywhere;\n}\n\n.menu-item--destructive .menu-item__label {\n  /* Beat ds-text color-* host classes for destructive rows. */\n  color: var(--color-foreground-bold-negative) !important;\n}\n\n/* Standard md icon zone keeps the dot aligned with other control suffixes. */\n.menu-item__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/* Switch suffix keeps an 8px label-to-control gap without changing the\n   density gap between a prefix icon or drag handle and the label. */\n.menu-item__switch {\n  flex-shrink: 0;\n  margin-inline-start: calc(\n    var(--dimension-space-100) - var(--ds-control-gap, var(--dimension-space-050))\n  );\n}\n\n/* ── Prefix icon / reorder handle ────────────────────────────────────────── */\n\n.menu-item > .menu-item__handle {\n  pointer-events: auto;\n  cursor: grab;\n  touch-action: none;\n}\n\n.menu-item > .menu-item__handle:active,\n.menu-item--dragging > .menu-item__handle {\n  cursor: grabbing;\n}\n\n.menu-item--dragging {\n  opacity: var(--effect-opacity-medium);\n}\n\n.menu-item__drop-rail {\n  position: absolute;\n  z-index: var(--dimension-z-index-raised);\n  inset-inline: var(--dimension-space-050);\n  block-size: var(--dimension-stroke-width-025);\n  border-radius: var(--dimension-radius-half);\n  background: var(--color-border-bold-brand);\n  pointer-events: none;\n}\n\n.menu-item__drop-rail--before {\n  inset-block-start: calc(-1 * var(--dimension-space-025));\n  transform: translateY(-50%);\n}\n\n.menu-item__drop-rail--after {\n  inset-block-end: calc(-1 * var(--dimension-space-025));\n  transform: translateY(50%);\n}\n\n@media (forced-colors: active) {\n  .menu-item__drop-rail {\n    background: var(--ds-forced-color-selected);\n  }\n}\n\n.data-preferences-embedded {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  min-height: 0;\n  color: var(--color-foreground-secondary);\n}\n",
+      "content": "@import '../../utils/radius.css';\n@import '../../utils/choice-list.css';\n@import '../../utils/visually-hidden.css';\n@import '../../utils/forced-colors.css';\n\n/* Inactive: `.ds-control-inactive` (50% opacity). */\n\n.menu-empty {\n  padding: var(--dimension-space-200);\n  box-sizing: border-box;\n  overflow-wrap: anywhere;\n}\n\n.menu-item--destructive .menu-item__label {\n  /* Beat ds-text color-* host classes for destructive rows. */\n  color: var(--color-foreground-bold-negative) !important;\n}\n\n/* Standard md icon zone keeps the dot aligned with other control suffixes. */\n.menu-item__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/* Switch suffix keeps an 8px label-to-control gap without changing the\n   density gap between a prefix icon or drag handle and the label. */\n.menu-item__switch {\n  flex-shrink: 0;\n  margin-inline-start: calc(\n    var(--dimension-space-100) - var(--ds-control-gap, var(--dimension-space-050))\n  );\n}\n\n.menu-item-row {\n  display: contents;\n}\n\n.menu-item-row--trailing-toggle {\n  display: flex;\n  align-items: center;\n  min-width: 0;\n}\n\n.menu-item-row--actions {\n  display: flex;\n  align-items: center;\n  min-width: 0;\n  padding-inline-end: var(--dimension-space-025);\n}\n\n.menu-item-row--trailing-toggle > .menu-item {\n  flex: 1;\n  min-width: 0;\n  width: auto;\n}\n\n.menu-item-row__trailing-toggle {\n  display: inline-flex;\n  align-items: center;\n  flex-shrink: 0;\n}\n\n.menu-item-row__divider {\n  flex-shrink: 0;\n  width: var(--dimension-stroke-width-012);\n  height: var(--dimension-size-250);\n  margin-inline: var(--dimension-space-025);\n  background: var(--color-border-tertiary);\n}\n\n.menu-item-row__trailing-toggle > ds-button-unfilled {\n  flex-shrink: 0;\n}\n\n.menu-item-row__actions,\n.menu-item-row__action {\n  display: inline-flex;\n  align-items: center;\n  flex-shrink: 0;\n}\n\n.menu-item-row__action > ds-button-unfilled {\n  flex-shrink: 0;\n}\n\n.menu-subsection-divider {\n  display: block;\n  flex-shrink: 0;\n  height: var(--dimension-stroke-width-012);\n  margin-inline: calc(\n    var(--ds-control-padding-inline, var(--dimension-space-075)) +\n      var(--ds-control-label-inset, var(--dimension-space-025))\n  );\n  background: var(--color-border-tertiary);\n}\n\n/* ── Prefix icon / reorder handle ────────────────────────────────────────── */\n\n.menu-item > .menu-item__handle {\n  pointer-events: auto;\n  cursor: grab;\n  touch-action: none;\n}\n\n.menu-item > .menu-item__handle--action-row {\n  --ds-menu-action-handle-size: calc(\n    var(--ds-control-height, var(--dimension-size-400)) - var(--dimension-space-050)\n  );\n\n  width: var(--ds-menu-action-handle-size);\n  height: var(--ds-menu-action-handle-size);\n  margin-inline: calc(\n    (var(--ds-control-icon, var(--dimension-iconography-md)) - var(--ds-menu-action-handle-size)) /\n      2\n  );\n  border-radius: var(--ds-control-radius, var(--dimension-radius-025));\n}\n\n.menu-item > .menu-item__handle--inactive {\n  color: var(--color-foreground-quaternary);\n  pointer-events: none;\n  cursor: default;\n  touch-action: auto;\n}\n\n.menu-item > .menu-item__handle:active,\n.menu-item--dragging > .menu-item__handle {\n  cursor: grabbing;\n}\n\n.menu-item--dragging {\n  opacity: var(--effect-opacity-medium);\n}\n\n.menu-item__drop-rail {\n  position: absolute;\n  z-index: var(--dimension-z-index-raised);\n  inset-inline: var(--dimension-space-050);\n  block-size: var(--dimension-stroke-width-025);\n  border-radius: var(--dimension-radius-half);\n  background: var(--color-border-bold-brand);\n  pointer-events: none;\n}\n\n.menu-item__drop-rail--before {\n  inset-block-start: calc(-1 * var(--dimension-space-025));\n  transform: translateY(-50%);\n}\n\n.menu-item__drop-rail--after {\n  inset-block-end: calc(-1 * var(--dimension-space-025));\n  transform: translateY(50%);\n}\n\n@media (forced-colors: active) {\n  .menu-item-row__divider {\n    background: var(--ds-forced-color-content);\n  }\n\n  .menu-subsection-divider {\n    background: var(--ds-forced-color-content);\n  }\n\n  .menu-item__drop-rail {\n    background: var(--ds-forced-color-selected);\n  }\n}\n\n.data-preferences-embedded {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  min-height: 0;\n  color: var(--color-foreground-secondary);\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/Menu/Menu.tsx",
-      "content": "import {\n  Component,\n  Prop,\n  State,\n  Event,\n  EventEmitter,\n  Element,\n  Watch,\n  Listen,\n  h,\n  Host,\n} from '@stencil/core';\nimport {\n  choicePopupMinWidth,\n  CONTROL_SUPPORTING_TEXT_VARIANT,\n  CONTROL_TEXT_VARIANT,\n  resolveChoicePopupAlignOffset,\n  resolveCssLengthPx,\n  resolveMotionTimeMs,\n  TOKEN_CSS_LENGTHS,\n  TOKEN_DEFAULTS,\n  type ChoicePopupAnchorAlignment,\n  type ControlSize,\n} from '../../utils';\nimport { AnchoredPositionController } from '../../utils/anchored-position-controller';\nimport { ConnectionTasks } from '../../utils/connection-tasks';\nimport { AnchoredOverlayInteractionController } from '../../utils/anchored-overlay-interaction-controller';\nimport { resolveAnchoredOverlayBoundaryRect } from '../../utils/anchored-overlay-boundary';\nimport { computeAnchoredPosition, type AnchoredPositionInput } from '../../utils/anchored-position';\nimport type { MenuAlign, MenuSide } from './menu-position';\nimport {\n  isMenuPickerSection,\n  isMenuSwatchPickerSection,\n  type MenuItemData,\n  type MenuReorderDetail,\n  type MenuSection,\n} from './menu-types';\nimport { snapshotMenuSections } from './menu-sections';\nimport {\n  createMenuReorderDetail,\n  locateMenuItem,\n  menuReorderableRange,\n  moveReorderableMenuItemBefore,\n  moveReorderableMenuItemBy,\n} from './menu-reorder';\n\nexport type MenuSelectionMode = 'none' | 'single';\nexport type MenuSize = ControlSize;\nlet menuId = 0;\nconst MENU_ITEM_TAG_SIZE: Record<MenuSize, 'md' | 'sm' | 'xs'> = {\n  lg: 'md',\n  md: 'sm',\n  sm: 'xs',\n  xs: 'xs',\n};\n\n@Component({\n  tag: 'ds-menu',\n  styleUrl: 'Menu.css',\n  scoped: true,\n})\nexport class Menu {\n  @Element() el!: HTMLElement;\n\n  /** Render content inside a parent-owned surface; the parent owns dismissal and positioning. */\n  @Prop() embedded: boolean = false;\n  @Prop({ mutable: true }) open: boolean = false;\n  @Prop() items: MenuItemData[] = [];\n  /** Choice-row density. */\n  @Prop() size: MenuSize = 'md';\n  /** Give ordinary rows mutually-exclusive menu semantics using isSelected. */\n  @Prop() selectionMode: MenuSelectionMode = 'none';\n  @Prop() sections: MenuSection[] = [];\n  /** Preferred side; placement flips to the opposite side when that offers a better fit. */\n  @Prop() side: MenuSide = 'bottom';\n  @Prop() align: MenuAlign = 'start';\n  /** Align choice-row edges to the anchor by default; use `popup-frame` only for custom frame geometry. */\n  @Prop() anchorAlignment: ChoicePopupAnchorAlignment = 'choice-cell';\n  /** Gap between anchor and menu — number (px) or TokoMo length (`var(--dimension-space-050)`, etc.). */\n  @Prop() sideOffset: number | string = TOKEN_CSS_LENGTHS.space050;\n  /** Cross-axis offset — number (px) or TokoMo length. */\n  @Prop() alignOffset: number | string = 0;\n  @Prop() menuWidth: string | undefined;\n  @Prop() minWidth: string | undefined;\n  /** External trigger element to position against. Set via JS: menuEl.anchor = buttonEl */\n  @Prop() anchor: HTMLElement | undefined;\n  /** ID of the external trigger element for positioning */\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  /** Show a visible ring on the initially focused menu item. Use only when the opener was keyboard-driven. */\n  @Prop() initialFocusVisible: boolean = false;\n  /** Accessible name for the popup menu. */\n  @Prop() menuLabel: string = 'Menu';\n  /** Informational message shown when there are no choices. Uses a non-modal dialog, not a fake menu item. */\n  @Prop() emptyMessage: string = '';\n\n  @State() private shouldRender: boolean = false;\n  @State() private closing: boolean = false;\n  @State() private pos: { x: number; y: number } = { x: 0, y: 0 };\n  @State() private focusedIndex: number = 0;\n  @State() private positionReady: boolean = false;\n  @State() private availableHeight: number | null = null;\n  @State() private focusRingVisible: boolean = false;\n  @State() private reorderFromFlat: number | null = null;\n  @State() private reorderInsertBefore: number | null = null;\n  @State() private reorderAnnouncement = '';\n\n  @Event() dsClose!: EventEmitter<void>;\n  /** Emitted after the popup's exit motion is complete and its rendered content is removed. */\n  @Event() dsAfterClose!: EventEmitter<void>;\n  @Event() dsSelect!: EventEmitter<MenuItemData>;\n  /** Emitted when a generic `swatch-picker` section option is chosen. */\n  @Event() dsSwatchSelect!: EventEmitter<string>;\n  /** Emitted after a pointer drop or keyboard move; Menu never mutates item order. */\n  @Event() dsReorder!: EventEmitter<MenuReorderDetail>;\n\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  private loaded = false;\n  private readonly tasks = new ConnectionTasks(() => this.el.isConnected);\n  private positionReadyCallback: (() => void) | undefined;\n  private suppressItemClick = false;\n  private reorderPointer: {\n    pointerId: number;\n    sectionIndex: number;\n    fromIndex: number;\n  } | null = null;\n  /**\n   * Anchored placement. The choice-cell measurement stays here on purpose: the\n   * inner-cell align offset and the `--dimension-menu-width-xs` floor are Menu\n   * semantics, not shared geometry.\n   */\n  private readonly position = new AnchoredPositionController({\n    getAnchor: () => this.resolvedAnchor ?? null,\n    getPopup: () => this.el.querySelector<HTMLElement>('.menu-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    measure: (anchorEl, popup) => {\n      if (!this.open) return null;\n\n      const anchorRect = anchorEl.getBoundingClientRect();\n      const sectionInsetPx = this.viewportPadPx;\n      if (!this.minWidth) {\n        if (\n          this.anchorAlignment === 'choice-cell' &&\n          (this.side === 'top' || this.side === 'bottom')\n        ) {\n          popup.style.minWidth = `max(var(--dimension-menu-width-xs), ${choicePopupMinWidth(\n            anchorRect.width,\n            sectionInsetPx\n          )}px)`;\n        } else {\n          popup.style.removeProperty('min-width');\n        }\n      }\n\n      const viewportPadPx = this.viewportPadPx;\n      const list = popup.querySelector<HTMLElement>('.ds-choice-list');\n      const naturalPopupHeight = Math.min(\n        Math.max(popup.offsetHeight, list?.scrollHeight ?? 0),\n        window.innerHeight - viewportPadPx * 2\n      );\n      const input: AnchoredPositionInput = {\n        anchorRect,\n        popupWidth: popup.offsetWidth || this.popupFallbackWidthPx,\n        popupHeight: naturalPopupHeight || this.popupFallbackHeightPx,\n        side: this.side,\n        align: this.align,\n        sideOffsetPx: this.sideOffsetPx,\n        alignOffsetPx: resolveChoicePopupAlignOffset({\n          align: this.align,\n          alignOffsetPx: this.alignOffsetPx,\n          sectionInsetPx,\n          anchorAlignment: this.anchorAlignment,\n        }),\n        viewportPadPx,\n        viewportWidth: window.innerWidth,\n        viewportHeight: window.innerHeight,\n        collisionRect: resolveAnchoredOverlayBoundaryRect(anchorEl, this.boundary),\n      };\n      const unconstrained = computeAnchoredPosition(input);\n      return {\n        ...input,\n        popupHeight: Math.min(input.popupHeight, unconstrained.availableHeight),\n      };\n    },\n    apply: ({ x, y, availableHeight }) => {\n      this.pos = { x, y };\n      this.availableHeight = availableHeight;\n    },\n    onReady: () => {\n      this.positionReady = true;\n    },\n    liveUpdate: 'double-frame',\n    topLayer: true,\n    observeResize: true,\n    observeAnchorMotion: true,\n  });\n  private readonly interaction = new AnchoredOverlayInteractionController({\n    getAnchor: () => this.resolvedAnchor,\n    getPopup: () => this.el.querySelector<HTMLElement>('.menu-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    onOutsideActivation: () => this.close(),\n  });\n  /** Last content actually painted while open; retained unchanged through exit motion. */\n  private lastRenderedSections: MenuSection[] = [];\n  private closingSections: MenuSection[] | null = null;\n  private readonly emptyMessageId = `ds-menu-empty-${++menuId}`;\n  private lastRenderedEmptyMessage = '';\n\n  componentDidLoad() {\n    this.loaded = true;\n    if (this.open) this.onOpenChange(true);\n  }\n\n  connectedCallback() {\n    if (this.loaded && this.open) this.onOpenChange(true);\n  }\n\n  disconnectedCallback() {\n    this.cancelPositionRetry();\n    this.cancelLivePositionUpdate();\n    this.clearReorderPointer();\n    this.teardownListeners();\n    this.positionReadyCallback = undefined;\n    this.shouldRender = false;\n    this.closing = false;\n    this.positionReady = false;\n    this.closingSections = null;\n    this.lastRenderedSections = [];\n    this.suppressItemClick = false;\n    this.reorderAnnouncement = '';\n  }\n\n  @Watch('open')\n  onOpenChange(isOpen: boolean) {\n    if (this.embedded || !this.loaded || !this.el.isConnected) return;\n    if (isOpen) {\n      this.teardownListeners();\n      this.closingSections = null;\n      this.shouldRender = true;\n      this.closing = false;\n      this.positionReady = false;\n      this.availableHeight = null;\n      this.focusRingVisible = this.initialFocusVisible;\n      this.setupListeners();\n      this.schedulePositionUpdate(() => {\n        this.focusInitialItem();\n      });\n    } else if (this.shouldRender && !this.closing) {\n      this.positionReadyCallback = undefined;\n      this.cancelPositionRetry();\n      this.captureClosingSections();\n      this.closing = true;\n      this.teardownListeners();\n      const closeAnimationMs = this.closeAnimationMs;\n      if (closeAnimationMs <= 0) {\n        this.finishClose();\n        return;\n      }\n      this.closeTimer = setTimeout(() => {\n        this.closeTimer = null;\n        this.finishClose();\n      }, closeAnimationMs);\n    }\n  }\n\n  @Watch('anchor')\n  @Watch('anchorId')\n  @Watch('boundary')\n  onAnchorChange() {\n    if (this.open) this.schedulePositionUpdate();\n  }\n\n  @Watch('side')\n  @Watch('align')\n  @Watch('anchorAlignment')\n  @Watch('sideOffset')\n  @Watch('alignOffset')\n  onPositionPropsChange() {\n    if (this.open) this.schedulePositionUpdate();\n  }\n\n  private get viewportPadPx(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050);\n  }\n\n  private get sideOffsetPx(): number {\n    return resolveCssLengthPx(this.sideOffset, TOKEN_DEFAULTS.space050);\n  }\n\n  private get alignOffsetPx(): number {\n    return resolveCssLengthPx(this.alignOffset, 0);\n  }\n\n  private get popupFallbackWidthPx(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuWidthXs, TOKEN_DEFAULTS.menuWidthXs);\n  }\n\n  private get popupFallbackHeightPx(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuFallbackHeight, TOKEN_DEFAULTS.menuFallbackHeight);\n  }\n\n  private get closeAnimationMs(): number {\n    return resolveMotionTimeMs(TOKEN_DEFAULTS.motionShort2, TOKEN_DEFAULTS.animationDurationShort3);\n  }\n\n  private finishClose() {\n    if (this.open || !this.closing || !this.el.isConnected) return;\n    const popup = this.el.querySelector<HTMLElement>('.menu-popup');\n    if (popup?.matches(':popover-open')) popup.hidePopover();\n    this.shouldRender = false;\n    this.closing = false;\n    this.lastRenderedSections = [];\n    this.closingSections = null;\n    this.clearReorderPointer();\n    this.reorderAnnouncement = '';\n    this.dsAfterClose.emit();\n  }\n\n  private captureClosingSections() {\n    if (this.closingSections) return;\n    const visibleSections = this.lastRenderedSections.length\n      ? this.lastRenderedSections\n      : this.activeSections;\n    this.closingSections = snapshotMenuSections(visibleSections);\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 null;\n  }\n\n  private compositeTabLeavesPopup(event: KeyboardEvent): boolean {\n    return this.interaction.tabLeavesPopup(event);\n  }\n\n  private get activeSections(): MenuSection[] {\n    if (this.sections.length > 0) return this.sections;\n    if (this.items.length > 0) return [{ items: this.items }];\n    return [];\n  }\n\n  private get flatItems(): MenuItemData[] {\n    return this.activeSections.flatMap(section =>\n      isMenuPickerSection(section) ? [] : section.items\n    );\n  }\n\n  /** Rich preference content is a non-modal dialog, not an ARIA action menu. */\n  private get hasCompositeSections(): boolean {\n    return this.activeSections.some(isMenuPickerSection);\n  }\n\n  private cancelPositionRetry() {\n    this.position.cancel();\n  }\n\n  private cancelLivePositionUpdate() {\n    this.position.cancel();\n  }\n\n  /** Reposition after the current scroll/layout frame without hiding the open popup. */\n  private scheduleLivePositionUpdate() {\n    this.position.scheduleLiveUpdate();\n  }\n\n  /** Retry until anchor + popup exist — do not reveal at 0,0 on a failed first pass. */\n  private schedulePositionUpdate(onReady?: () => void) {\n    if (!this.open || !this.el.isConnected) return;\n    this.positionReady = false;\n    // Opening often sets `open` and `anchorId` together. Each Watch reschedules\n    // placement; keep the open-path ready callback so initial focus is not dropped.\n    if (onReady) this.positionReadyCallback = onReady;\n    const callback = this.positionReadyCallback;\n    this.position.schedule(() => {\n      if (this.positionReadyCallback === callback) {\n        this.positionReadyCallback = undefined;\n      }\n      callback?.();\n    });\n  }\n\n  /** @returns `true` when anchor and popup were found and `pos` was updated. */\n  private calculatePosition(): boolean {\n    return this.position.update();\n  }\n\n  /** Focus the selected item when present, otherwise the first enabled item. */\n  private focusInitialItem() {\n    if (!this.hasCompositeSections && !this.flatItems.length && this.emptyMessage.trim()) {\n      this.tasks.frame(() => {\n        if (this.open) this.el.querySelector<HTMLElement>('.menu-popup')?.focus();\n      });\n      return;\n    }\n    if (this.hasCompositeSections) {\n      this.tasks.frame(() => {\n        this.el.querySelector<HTMLElement>('.menu-popup [tabindex=\"0\"]')?.focus();\n      });\n      return;\n    }\n\n    const flat = this.flatItems;\n    const selectedIdx = flat.findIndex(it => it.isSelected && !it.isInactive);\n    const firstEnabledIdx = flat.findIndex(it => !it.isInactive || !!it.reorderable);\n    this.focusedIndex = selectedIdx >= 0 ? selectedIdx : firstEnabledIdx >= 0 ? firstEnabledIdx : 0;\n\n    this.tasks.frame(() => {\n      const btns = this.el.querySelectorAll<HTMLElement>('.menu-item');\n      btns[this.focusedIndex]?.focus();\n    });\n  }\n\n  private setupListeners() {\n    this.interaction.connect();\n    this.position.observe();\n  }\n\n  private teardownListeners() {\n    this.tasks.cancel();\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.captureClosingSections();\n    if (restoreFocus) this.interaction.focusAnchor();\n    this.dsClose.emit();\n    this.open = false;\n    this.onOpenChange(false);\n  }\n\n  @Listen('keydown')\n  handleKeyDown(e: KeyboardEvent) {\n    if (this.embedded && (e.key === 'Escape' || e.key === 'Tab')) return;\n    if ((!this.shouldRender && !this.embedded) || this.closing) return;\n\n    if (e.key === 'Escape') {\n      e.preventDefault();\n      this.close();\n      return;\n    }\n\n    if (e.key === 'Tab') {\n      if (this.hasCompositeSections && !this.compositeTabLeavesPopup(e)) return;\n      e.preventDefault();\n      this.close(false);\n      this.interaction.moveFocusAfterTab(e.shiftKey);\n      return;\n    }\n\n    if (this.hasCompositeSections) return;\n\n    if ((e.key === 'ArrowUp' || e.key === 'ArrowDown') && e.altKey && !e.ctrlKey && !e.shiftKey) {\n      this.handleReorderKey(e);\n      return;\n    }\n\n    const flat = this.flatItems;\n    const enabled = flat\n      .map((it, i) => ({ it, i }))\n      .filter(({ it }) => !it.isInactive || !!it.reorderable)\n      .map(({ i }) => i);\n    if (!enabled.length) return;\n\n    const cur = enabled.indexOf(this.focusedIndex);\n    const safe = cur < 0 ? 0 : cur;\n\n    switch (e.key) {\n      case 'ArrowDown':\n        e.preventDefault();\n        e.stopPropagation();\n        this.focusRingVisible = true;\n        this.focusedIndex = enabled[(safe + 1) % enabled.length];\n        this.focusItem(this.focusedIndex);\n        break;\n      case 'ArrowUp':\n        e.preventDefault();\n        e.stopPropagation();\n        this.focusRingVisible = true;\n        this.focusedIndex = enabled[(safe - 1 + enabled.length) % enabled.length];\n        this.focusItem(this.focusedIndex);\n        break;\n      case 'Home':\n        e.preventDefault();\n        e.stopPropagation();\n        this.focusRingVisible = true;\n        this.focusedIndex = enabled[0];\n        this.focusItem(this.focusedIndex);\n        break;\n      case 'End':\n        e.preventDefault();\n        e.stopPropagation();\n        this.focusRingVisible = true;\n        this.focusedIndex = enabled[enabled.length - 1];\n        this.focusItem(this.focusedIndex);\n        break;\n    }\n  }\n\n  private focusItem(idx: number) {\n    const btns = this.el.querySelectorAll<HTMLElement>('.menu-item');\n    btns[idx]?.focus();\n  }\n\n  private handleItemClick(item: MenuItemData) {\n    if (this.suppressItemClick) {\n      this.suppressItemClick = false;\n      return;\n    }\n    if (item.isInactive) return;\n    // Consumers commonly change the item source while handling selection.\n    // Capture first so the exit animation never paints the next menu context.\n    this.captureClosingSections();\n    this.dsSelect.emit(item);\n  }\n\n  private handleSwatchSelect(value: string) {\n    this.dsSwatchSelect.emit(value);\n  }\n\n  private handleReorderKey(event: KeyboardEvent): void {\n    const located = locateMenuItem(this.activeSections, this.focusedIndex);\n    if (!located || !located.items[located.itemIndex]?.reorderable) return;\n\n    const nextItems = moveReorderableMenuItemBy(\n      located.items,\n      located.itemIndex,\n      event.key === 'ArrowUp' ? -1 : 1\n    );\n    if (!nextItems) return;\n\n    event.preventDefault();\n    event.stopPropagation();\n    this.emitReorder(located.items, located.itemIndex, nextItems, located.sectionIndex);\n  }\n\n  private emitReorder(\n    items: MenuItemData[],\n    fromIndex: number,\n    nextItems: MenuItemData[],\n    sectionIndex: number\n  ): void {\n    const detail = createMenuReorderDetail(items, fromIndex, nextItems, sectionIndex);\n    if (!detail) return;\n    this.focusedIndex = this.flatIndexFor(sectionIndex, detail.toIndex);\n    this.announceReorder(detail);\n    this.dsReorder.emit(detail);\n  }\n\n  private flatIndexFor(sectionIndex: number, itemIndex: number): number {\n    let flat = 0;\n    for (let index = 0; index < this.activeSections.length; index += 1) {\n      const section = this.activeSections[index];\n      if (isMenuPickerSection(section)) continue;\n      if (index === sectionIndex) return flat + itemIndex;\n      flat += section.items.length;\n    }\n    return itemIndex;\n  }\n\n  private announceReorder(detail: MenuReorderDetail): void {\n    const range = menuReorderableRange(detail.items, detail.toIndex);\n    const count = range ? range.end - range.start + 1 : detail.items.length;\n    const position = range ? detail.toIndex - range.start + 1 : detail.toIndex + 1;\n    this.reorderAnnouncement = `${detail.item.label} moved to position ${position} of ${count}`;\n  }\n\n  private onReorderPointerDown(\n    event: PointerEvent,\n    sectionIndex: number,\n    itemIndex: number,\n    flatIndex: number\n  ): void {\n    if (event.button !== 0) return;\n    const section = this.activeSections[sectionIndex];\n    if (!section || isMenuPickerSection(section)) return;\n    if (!section.items[itemIndex]?.reorderable) return;\n\n    event.preventDefault();\n    event.stopPropagation();\n    this.suppressItemClick = true;\n    this.focusRingVisible = false;\n    this.focusedIndex = flatIndex;\n    this.focusItem(flatIndex);\n    this.reorderPointer = {\n      pointerId: event.pointerId,\n      sectionIndex,\n      fromIndex: itemIndex,\n    };\n    this.reorderFromFlat = flatIndex;\n    this.reorderInsertBefore = itemIndex;\n    window.addEventListener('pointermove', this.onReorderPointerMove);\n    window.addEventListener('pointerup', this.onReorderPointerUp);\n    window.addEventListener('pointercancel', this.onReorderPointerCancel);\n  }\n\n  private onReorderPointerMove = (event: PointerEvent) => {\n    const drag = this.reorderPointer;\n    if (!drag || event.pointerId !== drag.pointerId) return;\n    const section = this.activeSections[drag.sectionIndex];\n    if (!section || isMenuPickerSection(section)) return;\n\n    const insertBefore = this.resolveReorderInsertBefore(\n      event.clientY,\n      drag.sectionIndex,\n      drag.fromIndex,\n      section.items\n    );\n    if (insertBefore !== this.reorderInsertBefore) this.reorderInsertBefore = insertBefore;\n  };\n\n  private onReorderPointerUp = (event: PointerEvent) => {\n    const drag = this.reorderPointer;\n    if (!drag || event.pointerId !== drag.pointerId) return;\n\n    const section = this.activeSections[drag.sectionIndex];\n    const insertBefore = this.reorderInsertBefore;\n    this.clearReorderPointer();\n    this.tasks.microtask(() => {\n      this.suppressItemClick = false;\n    });\n    if (!section || isMenuPickerSection(section) || insertBefore === null) return;\n\n    const nextItems = moveReorderableMenuItemBefore(section.items, drag.fromIndex, insertBefore);\n    if (!nextItems) return;\n    this.emitReorder(section.items, drag.fromIndex, nextItems, drag.sectionIndex);\n  };\n\n  private onReorderPointerCancel = (event: PointerEvent) => {\n    if (!this.reorderPointer || event.pointerId !== this.reorderPointer.pointerId) return;\n    this.clearReorderPointer();\n    this.tasks.microtask(() => {\n      this.suppressItemClick = false;\n    });\n  };\n\n  private resolveReorderInsertBefore(\n    clientY: number,\n    sectionIndex: number,\n    fromIndex: number,\n    items: MenuItemData[]\n  ): number {\n    const range = menuReorderableRange(items, fromIndex);\n    if (!range) return fromIndex;\n\n    const buttons = [...this.el.querySelectorAll<HTMLElement>('.menu-item')];\n    const sectionStart = this.flatIndexFor(sectionIndex, 0);\n    let insertBefore = range.end + 1;\n    for (let itemIndex = range.start; itemIndex <= range.end; itemIndex += 1) {\n      const row = buttons[sectionStart + itemIndex];\n      if (!row) continue;\n      const rect = row.getBoundingClientRect();\n      if (clientY < rect.top + rect.height / 2) {\n        insertBefore = itemIndex;\n        break;\n      }\n    }\n    return Math.min(Math.max(insertBefore, range.start), range.end + 1);\n  }\n\n  private clearReorderPointer(): void {\n    if (this.reorderPointer) {\n      window.removeEventListener('pointermove', this.onReorderPointerMove);\n      window.removeEventListener('pointerup', this.onReorderPointerUp);\n      window.removeEventListener('pointercancel', this.onReorderPointerCancel);\n    }\n    this.reorderPointer = null;\n    this.reorderFromFlat = null;\n    this.reorderInsertBefore = null;\n  }\n\n  render() {\n    if (!this.shouldRender && !this.embedded) return <Host style={{ display: 'contents' }} />;\n\n    const sections = this.closing\n      ? (this.closingSections ?? this.lastRenderedSections)\n      : this.activeSections;\n    const hasCompositeSections = sections.some(isMenuPickerSection);\n    const emptyMessage = this.closing ? this.lastRenderedEmptyMessage : this.emptyMessage.trim();\n    const showEmpty =\n      Boolean(emptyMessage) &&\n      !hasCompositeSections &&\n      sections.every(section => !isMenuPickerSection(section) && section.items.length === 0);\n    if (!this.closing) {\n      this.lastRenderedEmptyMessage = emptyMessage;\n      this.lastRenderedSections = snapshotMenuSections(sections);\n      this.closingSections = null;\n    }\n    let flatIdx = 0;\n    const dragLocated =\n      this.reorderFromFlat === null ? null : locateMenuItem(sections, this.reorderFromFlat);\n    const dragRange = dragLocated\n      ? menuReorderableRange(dragLocated.items, dragLocated.itemIndex)\n      : null;\n\n    const popupStyle: Record<string, string> = {\n      position: 'fixed',\n      left: '0',\n      top: '0',\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    if (this.menuWidth) popupStyle['width'] = this.menuWidth;\n    if (this.minWidth) popupStyle['min-width'] = this.minWidth;\n    if (this.availableHeight !== null) {\n      popupStyle['max-height'] = `${Math.floor(this.availableHeight)}px`;\n    }\n\n    return (\n      <Host style={{ display: 'contents' }}>\n        <div\n          popover={this.embedded ? undefined : 'manual'}\n          class={{\n            'menu-popup': true,\n            'menu-popup--closing': this.closing,\n            'ds-choice-popup': !this.embedded,\n            'data-preferences-embedded': this.embedded,\n            'ds-choice-popup--closing': this.closing,\n            'ds-focus-ring': showEmpty,\n            'ds-focus-ring--visible': showEmpty && this.focusRingVisible,\n          }}\n          style={this.embedded ? undefined : popupStyle}\n          role={hasCompositeSections || showEmpty ? 'dialog' : 'menu'}\n          aria-label={this.menuLabel}\n          aria-orientation={hasCompositeSections || showEmpty ? undefined : 'vertical'}\n          aria-describedby={showEmpty ? this.emptyMessageId : undefined}\n          tabIndex={showEmpty ? -1 : undefined}\n        >\n          <div class=\"ds-choice-list\">\n            {showEmpty ? (\n              <ds-text\n                textId={this.emptyMessageId}\n                class=\"menu-empty\"\n                as=\"p\"\n                variant={CONTROL_TEXT_VARIANT[this.size]}\n                color=\"secondary\"\n              >\n                {emptyMessage}\n              </ds-text>\n            ) : (\n              sections.map((section, si) => (\n                <div\n                  key={si}\n                  class={{\n                    'menu-section': true,\n                    'menu-section--divided': si < sections.length - 1,\n                    'menu-section--swatch-picker': isMenuPickerSection(section),\n                    'ds-choice-section': true,\n                    'ds-chrome-column': true,\n                    'ds-chrome-space--sm': true,\n                    'ds-choice-section--divided': si < sections.length - 1,\n                    'ds-choice-section--headed-after-first': si > 0 && Boolean(section.header),\n                  }}\n                  role={section.header ? 'group' : undefined}\n                  aria-label={section.header}\n                >\n                  {section.header && (\n                    <ds-text\n                      class={`section-header ds-choice-section__header ds-control-section-heading ds-control--${this.size}`}\n                      as=\"span\"\n                      variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                      emphasis\n                      color=\"primary\"\n                      aria-hidden=\"true\"\n                    >\n                      <span class=\"ds-choice-section__header-label\">{section.header}</span>\n                    </ds-text>\n                  )}\n                  {isMenuSwatchPickerSection(section) ? (\n                    <ds-swatch-picker\n                      value={section.value}\n                      groupLabel={section.groupLabel ?? section.header ?? 'Swatch options'}\n                      options={section.options ?? []}\n                      sections={section.sections ?? []}\n                      onDsChange={(e: CustomEvent<string>) => {\n                        e.stopPropagation();\n                        this.handleSwatchSelect(e.detail);\n                      }}\n                    />\n                  ) : (\n                    section.items.map((item, itemIndex) => {\n                      const idx = flatIdx++;\n                      const isFocused = this.focusedIndex === idx;\n                      const isSingleSelectionItem =\n                        !hasCompositeSections &&\n                        this.selectionMode === 'single' &&\n                        !item.showSwitch;\n                      const usesLeading = section.items.some(\n                        candidate => candidate.reorderable || !!candidate.icon\n                      );\n                      const locked = !!item.isInactive && !item.reorderable;\n                      const dragging = this.reorderFromFlat === idx;\n                      const dropBefore =\n                        dragLocated?.sectionIndex === si &&\n                        dragRange !== null &&\n                        itemIndex <= dragRange.end &&\n                        this.reorderInsertBefore === itemIndex;\n                      const dropAfter =\n                        dragLocated?.sectionIndex === si &&\n                        dragRange !== null &&\n                        this.reorderInsertBefore === dragRange.end + 1 &&\n                        itemIndex === dragRange.end;\n                      return (\n                        <button\n                          key={item.value ?? `${si}-${item.label}`}\n                          type=\"button\"\n                          class={{\n                            'menu-item': true,\n                            'ds-choice-item': true,\n                            'ds-control-frame': true,\n                            [`ds-control--${this.size}`]: true,\n                            'ds-focus-ring-inset': true,\n                            'ds-focus-ring--visible': isFocused && this.focusRingVisible,\n                            'ds-interaction-fill': !locked,\n                            'ds-interaction-fill--selected': !!item.isSelected && !locked,\n                            'menu-item--selected': !!item.isSelected,\n                            'menu-item--switch': !!item.showSwitch,\n                            'ds-control-inactive': locked,\n                            'menu-item--destructive': !!item.isDestructive,\n                            'menu-item--focused': isFocused,\n                            'menu-item--dragging': dragging,\n                          }}\n                          role={\n                            hasCompositeSections\n                              ? undefined\n                              : item.showSwitch\n                                ? 'menuitemcheckbox'\n                                : isSingleSelectionItem\n                                  ? 'menuitemradio'\n                                  : 'menuitem'\n                          }\n                          aria-checked={\n                            !hasCompositeSections && item.showSwitch\n                              ? String(!!item.switchValue)\n                              : isSingleSelectionItem\n                                ? String(!!item.isSelected)\n                                : undefined\n                          }\n                          aria-pressed={\n                            hasCompositeSections\n                              ? String(item.showSwitch ? !!item.switchValue : !!item.isSelected)\n                              : undefined\n                          }\n                          aria-current={\n                            !hasCompositeSections &&\n                            !item.showSwitch &&\n                            !isSingleSelectionItem &&\n                            item.isSelected\n                              ? 'true'\n                              : undefined\n                          }\n                          aria-description={\n                            item.reorderable\n                              ? item.isInactive\n                                ? 'Visibility cannot be changed. Alt + Arrow Up or Alt + Arrow Down moves this row.'\n                                : 'Drag to reorder. Alt + Arrow Up or Alt + Arrow Down moves this row.'\n                              : undefined\n                          }\n                          aria-disabled={item.isInactive ? 'true' : undefined}\n                          disabled={locked}\n                          tabIndex={\n                            hasCompositeSections || (this.embedded && idx === 0)\n                              ? 0\n                              : isFocused\n                                ? 0\n                                : -1\n                          }\n                          onMouseDown={() => {\n                            this.focusRingVisible = false;\n                          }}\n                          onClick={() => this.handleItemClick(item)}\n                          onFocus={() => {\n                            this.focusedIndex = idx;\n                          }}\n                        >\n                          {(dropBefore || dropAfter) && (\n                            <span\n                              class={{\n                                'menu-item__drop-rail': true,\n                                'menu-item__drop-rail--before': dropBefore,\n                                'menu-item__drop-rail--after': dropAfter,\n                              }}\n                              data-menu-drop-rail\n                              aria-hidden=\"true\"\n                            />\n                          )}\n                          {item.reorderable ? (\n                            <span\n                              class=\"menu-item__handle ds-choice-item__icon ds-control-icon-box ds-interaction-fill__content\"\n                              data-menu-handle\n                              aria-hidden=\"true\"\n                              onPointerDown={event =>\n                                this.onReorderPointerDown(event, si, itemIndex, idx)\n                              }\n                              onClick={event => {\n                                event.preventDefault();\n                                event.stopPropagation();\n                              }}\n                            >\n                              <ds-icon name=\"DragDots\" size={this.size} color=\"inherit\" />\n                            </span>\n                          ) : usesLeading && item.icon ? (\n                            <span\n                              class=\"menu-item__icon ds-choice-item__icon ds-control-icon-box ds-interaction-fill__content\"\n                              aria-hidden=\"true\"\n                            >\n                              <ds-icon name={item.icon} size={this.size} color=\"inherit\" />\n                            </span>\n                          ) : usesLeading ? (\n                            <span\n                              class=\"menu-item__icon-spacer ds-choice-item__icon ds-control-icon-box\"\n                              aria-hidden=\"true\"\n                            />\n                          ) : null}\n                          <div class=\"menu-item__content ds-choice-item__content ds-interaction-fill__content\">\n                            <ds-text\n                              class=\"menu-item__label ds-choice-item__label ds-control-label-box\"\n                              as=\"span\"\n                              variant={CONTROL_TEXT_VARIANT[this.size]}\n                              color={item.isSelected ? 'primary' : 'secondary'}\n                            >\n                              {item.label}\n                            </ds-text>\n                            {item.subtext && (\n                              <ds-text\n                                class=\"menu-item__subtext ds-choice-item__subtext ds-control-label-box\"\n                                as=\"span\"\n                                variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                                color=\"secondary\"\n                              >\n                                {item.subtext}\n                              </ds-text>\n                            )}\n                          </div>\n                          {item.tag && (\n                            <ds-tag\n                              class=\"ds-choice-item__tag ds-interaction-fill__content\"\n                              label={item.tag.label}\n                              size={MENU_ITEM_TAG_SIZE[this.size]}\n                              intent={item.tag.intent ?? 'neutral'}\n                              contrast={item.tag.contrast ?? 'faint'}\n                              rounded={item.tag.rounded ?? false}\n                              isInset\n                            />\n                          )}\n                          {item.dot && (\n                            <span\n                              class=\"menu-item__dot-box ds-interaction-fill__content\"\n                              aria-hidden=\"true\"\n                            >\n                              <ds-badge\n                                class=\"menu-item__dot\"\n                                variant=\"dot\"\n                                hasRing={false}\n                                label=\"\"\n                              />\n                            </span>\n                          )}\n                          {item.showSwitch && (\n                            <ds-switch\n                              class=\"menu-item__switch ds-interaction-fill__content\"\n                              size={this.size}\n                              checked={!!item.switchValue}\n                              isInactive={!!item.isInactive}\n                              presentation\n                            />\n                          )}\n                        </button>\n                      );\n                    })\n                  )}\n                </div>\n              ))\n            )}\n          </div>\n        </div>\n        <div class=\"ds-visually-hidden\" role=\"status\" aria-live=\"polite\">\n          {this.reorderAnnouncement}\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import {\n  Component,\n  Prop,\n  State,\n  Event,\n  EventEmitter,\n  Element,\n  Watch,\n  Listen,\n  h,\n  Host,\n} from '@stencil/core';\nimport {\n  choicePopupMinWidth,\n  CONTROL_SUPPORTING_TEXT_VARIANT,\n  CONTROL_TEXT_VARIANT,\n  resolveChoicePopupAlignOffset,\n  resolveCssLengthPx,\n  resolveMotionTimeMs,\n  TOKEN_CSS_LENGTHS,\n  TOKEN_DEFAULTS,\n  type ChoicePopupAnchorAlignment,\n  type ControlSize,\n} from '../../utils';\nimport { AnchoredPositionController } from '../../utils/anchored-position-controller';\nimport { ConnectionTasks } from '../../utils/connection-tasks';\nimport { AnchoredOverlayInteractionController } from '../../utils/anchored-overlay-interaction-controller';\nimport { resolveAnchoredOverlayBoundaryRect } from '../../utils/anchored-overlay-boundary';\nimport { computeAnchoredPosition, type AnchoredPositionInput } from '../../utils/anchored-position';\nimport type { MenuAlign, MenuSide } from './menu-position';\nimport {\n  isMenuPickerSection,\n  isMenuSwatchPickerSection,\n  type MenuItemData,\n  type MenuItemToggleDetail,\n  type MenuReorderDetail,\n  type MenuSection,\n} from './menu-types';\nimport { snapshotMenuSections } from './menu-sections';\nimport {\n  createMenuReorderDetail,\n  locateMenuItem,\n  menuReorderableRange,\n  moveReorderableMenuItemBefore,\n  moveReorderableMenuItemBy,\n} from './menu-reorder';\n\nexport type MenuSelectionMode = 'none' | 'single';\nexport type MenuSize = ControlSize;\nlet menuId = 0;\nconst MENU_ITEM_TAG_SIZE: Record<MenuSize, 'md' | 'sm' | 'xs'> = {\n  lg: 'md',\n  md: 'sm',\n  sm: 'xs',\n  xs: 'xs',\n};\n\n@Component({\n  tag: 'ds-menu',\n  styleUrl: 'Menu.css',\n  scoped: true,\n})\nexport class Menu {\n  @Element() el!: HTMLElement;\n\n  /** Render content inside a parent-owned surface; the parent owns dismissal and positioning. */\n  @Prop() embedded: boolean = false;\n  @Prop({ mutable: true }) open: boolean = false;\n  @Prop() items: MenuItemData[] = [];\n  /** Choice-row density. */\n  @Prop() size: MenuSize = 'md';\n  /** Give ordinary rows mutually-exclusive menu semantics using isSelected. */\n  @Prop() selectionMode: MenuSelectionMode = 'none';\n  @Prop() sections: MenuSection[] = [];\n  /** Preferred side; placement flips to the opposite side when that offers a better fit. */\n  @Prop() side: MenuSide = 'bottom';\n  @Prop() align: MenuAlign = 'start';\n  /** Align choice-row edges to the anchor by default; use `popup-frame` only for custom frame geometry. */\n  @Prop() anchorAlignment: ChoicePopupAnchorAlignment = 'choice-cell';\n  /** Gap between anchor and menu — number (px) or TokoMo length (`var(--dimension-space-050)`, etc.). */\n  @Prop() sideOffset: number | string = TOKEN_CSS_LENGTHS.space050;\n  /** Cross-axis offset — number (px) or TokoMo length. */\n  @Prop() alignOffset: number | string = 0;\n  @Prop() menuWidth: string | undefined;\n  @Prop() minWidth: string | undefined;\n  /** External trigger element to position against. Set via JS: menuEl.anchor = buttonEl */\n  @Prop() anchor: HTMLElement | undefined;\n  /** ID of the external trigger element for positioning */\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  /** Show a visible ring on the initially focused menu item. Use only when the opener was keyboard-driven. */\n  @Prop() initialFocusVisible: boolean = false;\n  /** Accessible name for the popup menu. */\n  @Prop() menuLabel: string = 'Menu';\n  /** Informational message shown when there are no choices. Uses a non-modal dialog, not a fake menu item. */\n  @Prop() emptyMessage: string = '';\n\n  @State() private shouldRender: boolean = false;\n  @State() private closing: boolean = false;\n  @State() private pos: { x: number; y: number } = { x: 0, y: 0 };\n  @State() private focusedIndex: number = 0;\n  @State() private positionReady: boolean = false;\n  @State() private availableHeight: number | null = null;\n  @State() private focusRingVisible: boolean = false;\n  @State() private reorderFromFlat: number | null = null;\n  @State() private reorderInsertBefore: number | null = null;\n  @State() private reorderAnnouncement = '';\n\n  @Event() dsClose!: EventEmitter<void>;\n  /** Emitted after the popup's exit motion is complete and its rendered content is removed. */\n  @Event() dsAfterClose!: EventEmitter<void>;\n  @Event() dsSelect!: EventEmitter<MenuItemData>;\n  /** Emitted when a row's separate trailing toggle requests a controlled state change. */\n  @Event() dsItemToggle!: EventEmitter<MenuItemToggleDetail>;\n  /** Emitted when a generic `swatch-picker` section option is chosen. */\n  @Event() dsSwatchSelect!: EventEmitter<string>;\n  /** Emitted after a pointer drop or keyboard move; Menu never mutates item order. */\n  @Event() dsReorder!: EventEmitter<MenuReorderDetail>;\n\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  private loaded = false;\n  private readonly tasks = new ConnectionTasks(() => this.el.isConnected);\n  private positionReadyCallback: (() => void) | undefined;\n  private suppressItemClick = false;\n  private reorderPointer: {\n    pointerId: number;\n    sectionIndex: number;\n    fromIndex: number;\n  } | null = null;\n  /**\n   * Anchored placement. The choice-cell measurement stays here on purpose: the\n   * inner-cell align offset and the `--dimension-menu-width-xs` floor are Menu\n   * semantics, not shared geometry.\n   */\n  private readonly position = new AnchoredPositionController({\n    getAnchor: () => this.resolvedAnchor ?? null,\n    getPopup: () => this.el.querySelector<HTMLElement>('.menu-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    measure: (anchorEl, popup) => {\n      if (!this.open) return null;\n\n      const anchorRect = anchorEl.getBoundingClientRect();\n      const sectionInsetPx = this.viewportPadPx;\n      if (!this.minWidth) {\n        if (\n          this.anchorAlignment === 'choice-cell' &&\n          (this.side === 'top' || this.side === 'bottom')\n        ) {\n          popup.style.minWidth = `max(var(--dimension-menu-width-xs), ${choicePopupMinWidth(\n            anchorRect.width,\n            sectionInsetPx\n          )}px)`;\n        } else {\n          popup.style.removeProperty('min-width');\n        }\n      }\n\n      const viewportPadPx = this.viewportPadPx;\n      const list = popup.querySelector<HTMLElement>('.ds-choice-list');\n      const naturalPopupHeight = Math.min(\n        Math.max(popup.offsetHeight, list?.scrollHeight ?? 0),\n        window.innerHeight - viewportPadPx * 2\n      );\n      const input: AnchoredPositionInput = {\n        anchorRect,\n        popupWidth: popup.offsetWidth || this.popupFallbackWidthPx,\n        popupHeight: naturalPopupHeight || this.popupFallbackHeightPx,\n        side: this.side,\n        align: this.align,\n        sideOffsetPx: this.sideOffsetPx,\n        alignOffsetPx: resolveChoicePopupAlignOffset({\n          align: this.align,\n          alignOffsetPx: this.alignOffsetPx,\n          sectionInsetPx,\n          anchorAlignment: this.anchorAlignment,\n        }),\n        viewportPadPx,\n        viewportWidth: window.innerWidth,\n        viewportHeight: window.innerHeight,\n        collisionRect: resolveAnchoredOverlayBoundaryRect(anchorEl, this.boundary),\n      };\n      const unconstrained = computeAnchoredPosition(input);\n      return {\n        ...input,\n        popupHeight: Math.min(input.popupHeight, unconstrained.availableHeight),\n      };\n    },\n    apply: ({ x, y, availableHeight }) => {\n      this.pos = { x, y };\n      this.availableHeight = availableHeight;\n    },\n    onReady: () => {\n      this.positionReady = true;\n    },\n    liveUpdate: 'double-frame',\n    topLayer: true,\n    observeResize: true,\n    observeAnchorMotion: true,\n  });\n  private readonly interaction = new AnchoredOverlayInteractionController({\n    getAnchor: () => this.resolvedAnchor,\n    getPopup: () => this.el.querySelector<HTMLElement>('.menu-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    onOutsideActivation: () => this.close(),\n  });\n  /** Last content actually painted while open; retained unchanged through exit motion. */\n  private lastRenderedSections: MenuSection[] = [];\n  private closingSections: MenuSection[] | null = null;\n  private readonly emptyMessageId = `ds-menu-empty-${++menuId}`;\n  private lastRenderedEmptyMessage = '';\n\n  componentDidLoad() {\n    this.loaded = true;\n    if (this.open) this.onOpenChange(true);\n  }\n\n  connectedCallback() {\n    if (this.loaded && this.open) this.onOpenChange(true);\n  }\n\n  disconnectedCallback() {\n    this.cancelPositionRetry();\n    this.cancelLivePositionUpdate();\n    this.clearReorderPointer();\n    this.teardownListeners();\n    this.positionReadyCallback = undefined;\n    this.shouldRender = false;\n    this.closing = false;\n    this.positionReady = false;\n    this.closingSections = null;\n    this.lastRenderedSections = [];\n    this.suppressItemClick = false;\n    this.reorderAnnouncement = '';\n  }\n\n  @Watch('open')\n  onOpenChange(isOpen: boolean) {\n    if (this.embedded || !this.loaded || !this.el.isConnected) return;\n    if (isOpen) {\n      this.teardownListeners();\n      this.closingSections = null;\n      this.shouldRender = true;\n      this.closing = false;\n      this.positionReady = false;\n      this.availableHeight = null;\n      this.focusRingVisible = this.initialFocusVisible;\n      this.setupListeners();\n      this.schedulePositionUpdate(() => {\n        this.focusInitialItem();\n      });\n    } else if (this.shouldRender && !this.closing) {\n      this.positionReadyCallback = undefined;\n      this.cancelPositionRetry();\n      this.captureClosingSections();\n      this.closing = true;\n      this.teardownListeners();\n      const closeAnimationMs = this.closeAnimationMs;\n      if (closeAnimationMs <= 0) {\n        this.finishClose();\n        return;\n      }\n      this.closeTimer = setTimeout(() => {\n        this.closeTimer = null;\n        this.finishClose();\n      }, closeAnimationMs);\n    }\n  }\n\n  @Watch('anchor')\n  @Watch('anchorId')\n  @Watch('boundary')\n  onAnchorChange() {\n    if (this.open) this.schedulePositionUpdate();\n  }\n\n  @Watch('side')\n  @Watch('align')\n  @Watch('anchorAlignment')\n  @Watch('sideOffset')\n  @Watch('alignOffset')\n  onPositionPropsChange() {\n    if (this.open) this.schedulePositionUpdate();\n  }\n\n  private get viewportPadPx(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050);\n  }\n\n  private get sideOffsetPx(): number {\n    return resolveCssLengthPx(this.sideOffset, TOKEN_DEFAULTS.space050);\n  }\n\n  private get alignOffsetPx(): number {\n    return resolveCssLengthPx(this.alignOffset, 0);\n  }\n\n  private get popupFallbackWidthPx(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuWidthXs, TOKEN_DEFAULTS.menuWidthXs);\n  }\n\n  private get popupFallbackHeightPx(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuFallbackHeight, TOKEN_DEFAULTS.menuFallbackHeight);\n  }\n\n  private get closeAnimationMs(): number {\n    return resolveMotionTimeMs(TOKEN_DEFAULTS.motionShort2, TOKEN_DEFAULTS.animationDurationShort3);\n  }\n\n  private finishClose() {\n    if (this.open || !this.closing || !this.el.isConnected) return;\n    const popup = this.el.querySelector<HTMLElement>('.menu-popup');\n    if (popup?.matches(':popover-open')) popup.hidePopover();\n    this.shouldRender = false;\n    this.closing = false;\n    this.lastRenderedSections = [];\n    this.closingSections = null;\n    this.clearReorderPointer();\n    this.reorderAnnouncement = '';\n    this.dsAfterClose.emit();\n  }\n\n  private captureClosingSections() {\n    if (this.closingSections) return;\n    const visibleSections = this.lastRenderedSections.length\n      ? this.lastRenderedSections\n      : this.activeSections;\n    this.closingSections = snapshotMenuSections(visibleSections);\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 null;\n  }\n\n  private compositeTabLeavesPopup(event: KeyboardEvent): boolean {\n    return this.interaction.tabLeavesPopup(event);\n  }\n\n  private get activeSections(): MenuSection[] {\n    if (this.sections.length > 0) return this.sections;\n    if (this.items.length > 0) return [{ items: this.items }];\n    return [];\n  }\n\n  private get flatItems(): MenuItemData[] {\n    return this.activeSections.flatMap(section =>\n      isMenuPickerSection(section) ? [] : section.items\n    );\n  }\n\n  /** Rich preference content is a non-modal dialog, not an ARIA action menu. */\n  private get hasCompositeSections(): boolean {\n    return this.sectionsHaveCompositeControls(this.activeSections);\n  }\n\n  private sectionsHaveCompositeControls(sections: MenuSection[]): boolean {\n    return sections.some(\n      section =>\n        isMenuPickerSection(section) ||\n        section.items.some(item => Boolean(item.trailingToggle || item.trailingActions?.length))\n    );\n  }\n\n  private sectionUsesInsetDivider(section: MenuSection | undefined): boolean {\n    return Boolean(section && !isMenuPickerSection(section) && section.insetDividerBefore);\n  }\n\n  private cancelPositionRetry() {\n    this.position.cancel();\n  }\n\n  private cancelLivePositionUpdate() {\n    this.position.cancel();\n  }\n\n  /** Reposition after the current scroll/layout frame without hiding the open popup. */\n  private scheduleLivePositionUpdate() {\n    this.position.scheduleLiveUpdate();\n  }\n\n  /** Retry until anchor + popup exist — do not reveal at 0,0 on a failed first pass. */\n  private schedulePositionUpdate(onReady?: () => void) {\n    if (!this.open || !this.el.isConnected) return;\n    this.positionReady = false;\n    // Opening often sets `open` and `anchorId` together. Each Watch reschedules\n    // placement; keep the open-path ready callback so initial focus is not dropped.\n    if (onReady) this.positionReadyCallback = onReady;\n    const callback = this.positionReadyCallback;\n    this.position.schedule(() => {\n      if (this.positionReadyCallback === callback) {\n        this.positionReadyCallback = undefined;\n      }\n      callback?.();\n    });\n  }\n\n  /** @returns `true` when anchor and popup were found and `pos` was updated. */\n  private calculatePosition(): boolean {\n    return this.position.update();\n  }\n\n  /** Focus the selected item when present, otherwise the first enabled item. */\n  private focusInitialItem() {\n    if (!this.hasCompositeSections && !this.flatItems.length && this.emptyMessage.trim()) {\n      this.tasks.frame(() => {\n        if (this.open) this.el.querySelector<HTMLElement>('.menu-popup')?.focus();\n      });\n      return;\n    }\n    if (this.hasCompositeSections) {\n      this.tasks.frame(() => {\n        this.el.querySelector<HTMLElement>('.menu-popup [tabindex=\"0\"]')?.focus();\n      });\n      return;\n    }\n\n    const flat = this.flatItems;\n    const selectedIdx = flat.findIndex(it => it.isSelected && !it.isInactive);\n    const firstEnabledIdx = flat.findIndex(it => !it.isInactive || !!it.reorderable);\n    this.focusedIndex = selectedIdx >= 0 ? selectedIdx : firstEnabledIdx >= 0 ? firstEnabledIdx : 0;\n\n    this.tasks.frame(() => {\n      const btns = this.el.querySelectorAll<HTMLElement>('.menu-item');\n      btns[this.focusedIndex]?.focus();\n    });\n  }\n\n  private setupListeners() {\n    this.interaction.connect();\n    this.position.observe();\n  }\n\n  private teardownListeners() {\n    this.tasks.cancel();\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.captureClosingSections();\n    if (restoreFocus) this.interaction.focusAnchor();\n    this.dsClose.emit();\n    this.open = false;\n    this.onOpenChange(false);\n  }\n\n  @Listen('keydown')\n  handleKeyDown(e: KeyboardEvent) {\n    if (this.embedded && (e.key === 'Escape' || e.key === 'Tab')) return;\n    if ((!this.shouldRender && !this.embedded) || this.closing) return;\n\n    if (e.key === 'Escape') {\n      e.preventDefault();\n      this.close();\n      return;\n    }\n\n    if (e.key === 'Tab') {\n      if (this.hasCompositeSections && !this.compositeTabLeavesPopup(e)) return;\n      e.preventDefault();\n      this.close(false);\n      this.interaction.moveFocusAfterTab(e.shiftKey);\n      return;\n    }\n\n    if (\n      (e.key === 'ArrowUp' || e.key === 'ArrowDown') &&\n      e.altKey &&\n      !e.ctrlKey &&\n      !e.shiftKey &&\n      (e.target as HTMLElement).closest('.menu-item')\n    ) {\n      this.handleReorderKey(e);\n      return;\n    }\n\n    if (this.hasCompositeSections) return;\n\n    const flat = this.flatItems;\n    const enabled = flat\n      .map((it, i) => ({ it, i }))\n      .filter(({ it }) => !it.isInactive || !!it.reorderable)\n      .map(({ i }) => i);\n    if (!enabled.length) return;\n\n    const cur = enabled.indexOf(this.focusedIndex);\n    const safe = cur < 0 ? 0 : cur;\n\n    switch (e.key) {\n      case 'ArrowDown':\n        e.preventDefault();\n        e.stopPropagation();\n        this.focusRingVisible = true;\n        this.focusedIndex = enabled[(safe + 1) % enabled.length];\n        this.focusItem(this.focusedIndex);\n        break;\n      case 'ArrowUp':\n        e.preventDefault();\n        e.stopPropagation();\n        this.focusRingVisible = true;\n        this.focusedIndex = enabled[(safe - 1 + enabled.length) % enabled.length];\n        this.focusItem(this.focusedIndex);\n        break;\n      case 'Home':\n        e.preventDefault();\n        e.stopPropagation();\n        this.focusRingVisible = true;\n        this.focusedIndex = enabled[0];\n        this.focusItem(this.focusedIndex);\n        break;\n      case 'End':\n        e.preventDefault();\n        e.stopPropagation();\n        this.focusRingVisible = true;\n        this.focusedIndex = enabled[enabled.length - 1];\n        this.focusItem(this.focusedIndex);\n        break;\n    }\n  }\n\n  private focusItem(idx: number) {\n    const rows = this.el.querySelectorAll<HTMLElement>('.menu-item');\n    const row = rows[idx];\n    if (!row) return;\n    if (row.matches('button')) row.focus();\n    else row.querySelector<HTMLElement>('[tabindex=\"0\"]')?.focus();\n  }\n\n  private handleItemClick(item: MenuItemData) {\n    if (this.suppressItemClick) {\n      this.suppressItemClick = false;\n      return;\n    }\n    if (item.isInactive) return;\n    // Consumers commonly change the item source while handling selection.\n    // Capture first so the exit animation never paints the next menu context.\n    this.captureClosingSections();\n    this.dsSelect.emit(item);\n  }\n\n  private handleSwatchSelect(value: string) {\n    this.dsSwatchSelect.emit(value);\n  }\n\n  private handleReorderKey(event: KeyboardEvent): void {\n    const located = locateMenuItem(this.activeSections, this.focusedIndex);\n    if (!located || !located.items[located.itemIndex]?.reorderable) return;\n\n    const nextItems = moveReorderableMenuItemBy(\n      located.items,\n      located.itemIndex,\n      event.key === 'ArrowUp' ? -1 : 1\n    );\n    if (!nextItems) return;\n\n    event.preventDefault();\n    event.stopPropagation();\n    this.emitReorder(located.items, located.itemIndex, nextItems, located.sectionIndex);\n  }\n\n  private emitReorder(\n    items: MenuItemData[],\n    fromIndex: number,\n    nextItems: MenuItemData[],\n    sectionIndex: number\n  ): void {\n    const detail = createMenuReorderDetail(items, fromIndex, nextItems, sectionIndex);\n    if (!detail) return;\n    this.focusedIndex = this.flatIndexFor(sectionIndex, detail.toIndex);\n    this.announceReorder(detail);\n    this.dsReorder.emit(detail);\n  }\n\n  private flatIndexFor(sectionIndex: number, itemIndex: number): number {\n    let flat = 0;\n    for (let index = 0; index < this.activeSections.length; index += 1) {\n      const section = this.activeSections[index];\n      if (isMenuPickerSection(section)) continue;\n      if (index === sectionIndex) return flat + itemIndex;\n      flat += section.items.length;\n    }\n    return itemIndex;\n  }\n\n  private announceReorder(detail: MenuReorderDetail): void {\n    const range = menuReorderableRange(detail.items, detail.toIndex);\n    const count = range ? range.end - range.start + 1 : detail.items.length;\n    const position = range ? detail.toIndex - range.start + 1 : detail.toIndex + 1;\n    this.reorderAnnouncement = `${detail.item.label} moved to position ${position} of ${count}`;\n  }\n\n  private onReorderPointerDown(\n    event: PointerEvent,\n    sectionIndex: number,\n    itemIndex: number,\n    flatIndex: number\n  ): void {\n    if (event.button !== 0) return;\n    const section = this.activeSections[sectionIndex];\n    if (!section || isMenuPickerSection(section)) return;\n    if (!section.items[itemIndex]?.reorderable) return;\n\n    event.preventDefault();\n    event.stopPropagation();\n    this.suppressItemClick = true;\n    this.focusRingVisible = false;\n    this.focusedIndex = flatIndex;\n    this.focusItem(flatIndex);\n    this.reorderPointer = {\n      pointerId: event.pointerId,\n      sectionIndex,\n      fromIndex: itemIndex,\n    };\n    this.reorderFromFlat = flatIndex;\n    this.reorderInsertBefore = itemIndex;\n    window.addEventListener('pointermove', this.onReorderPointerMove);\n    window.addEventListener('pointerup', this.onReorderPointerUp);\n    window.addEventListener('pointercancel', this.onReorderPointerCancel);\n  }\n\n  private onReorderPointerMove = (event: PointerEvent) => {\n    const drag = this.reorderPointer;\n    if (!drag || event.pointerId !== drag.pointerId) return;\n    const section = this.activeSections[drag.sectionIndex];\n    if (!section || isMenuPickerSection(section)) return;\n\n    const insertBefore = this.resolveReorderInsertBefore(\n      event.clientY,\n      drag.sectionIndex,\n      drag.fromIndex,\n      section.items\n    );\n    if (insertBefore !== this.reorderInsertBefore) this.reorderInsertBefore = insertBefore;\n  };\n\n  private onReorderPointerUp = (event: PointerEvent) => {\n    const drag = this.reorderPointer;\n    if (!drag || event.pointerId !== drag.pointerId) return;\n\n    const section = this.activeSections[drag.sectionIndex];\n    const insertBefore = this.reorderInsertBefore;\n    this.clearReorderPointer();\n    this.tasks.microtask(() => {\n      this.suppressItemClick = false;\n    });\n    if (!section || isMenuPickerSection(section) || insertBefore === null) return;\n\n    const nextItems = moveReorderableMenuItemBefore(section.items, drag.fromIndex, insertBefore);\n    if (!nextItems) return;\n    this.emitReorder(section.items, drag.fromIndex, nextItems, drag.sectionIndex);\n  };\n\n  private onReorderPointerCancel = (event: PointerEvent) => {\n    if (!this.reorderPointer || event.pointerId !== this.reorderPointer.pointerId) return;\n    this.clearReorderPointer();\n    this.tasks.microtask(() => {\n      this.suppressItemClick = false;\n    });\n  };\n\n  private resolveReorderInsertBefore(\n    clientY: number,\n    sectionIndex: number,\n    fromIndex: number,\n    items: MenuItemData[]\n  ): number {\n    const range = menuReorderableRange(items, fromIndex);\n    if (!range) return fromIndex;\n\n    const buttons = [...this.el.querySelectorAll<HTMLElement>('.menu-item')];\n    const sectionStart = this.flatIndexFor(sectionIndex, 0);\n    let insertBefore = range.end + 1;\n    for (let itemIndex = range.start; itemIndex <= range.end; itemIndex += 1) {\n      const row = buttons[sectionStart + itemIndex];\n      if (!row) continue;\n      const rect = row.getBoundingClientRect();\n      if (clientY < rect.top + rect.height / 2) {\n        insertBefore = itemIndex;\n        break;\n      }\n    }\n    return Math.min(Math.max(insertBefore, range.start), range.end + 1);\n  }\n\n  private clearReorderPointer(): void {\n    if (this.reorderPointer) {\n      window.removeEventListener('pointermove', this.onReorderPointerMove);\n      window.removeEventListener('pointerup', this.onReorderPointerUp);\n      window.removeEventListener('pointercancel', this.onReorderPointerCancel);\n    }\n    this.reorderPointer = null;\n    this.reorderFromFlat = null;\n    this.reorderInsertBefore = null;\n  }\n\n  render() {\n    if (!this.shouldRender && !this.embedded) return <Host style={{ display: 'contents' }} />;\n\n    const sections = this.closing\n      ? (this.closingSections ?? this.lastRenderedSections)\n      : this.activeSections;\n    const hasCompositeSections = this.sectionsHaveCompositeControls(sections);\n    const emptyMessage = this.closing ? this.lastRenderedEmptyMessage : this.emptyMessage.trim();\n    const showEmpty =\n      Boolean(emptyMessage) &&\n      !hasCompositeSections &&\n      sections.every(section => !isMenuPickerSection(section) && section.items.length === 0);\n    if (!this.closing) {\n      this.lastRenderedEmptyMessage = emptyMessage;\n      this.lastRenderedSections = snapshotMenuSections(sections);\n      this.closingSections = null;\n    }\n    let flatIdx = 0;\n    const dragLocated =\n      this.reorderFromFlat === null ? null : locateMenuItem(sections, this.reorderFromFlat);\n    const dragRange = dragLocated\n      ? menuReorderableRange(dragLocated.items, dragLocated.itemIndex)\n      : null;\n\n    const popupStyle: Record<string, string> = {\n      position: 'fixed',\n      left: '0',\n      top: '0',\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    if (this.menuWidth) popupStyle['width'] = this.menuWidth;\n    if (this.minWidth) popupStyle['min-width'] = this.minWidth;\n    if (this.availableHeight !== null) {\n      popupStyle['max-height'] = `${Math.floor(this.availableHeight)}px`;\n    }\n\n    return (\n      <Host style={{ display: 'contents' }}>\n        <div\n          popover={this.embedded ? undefined : 'manual'}\n          class={{\n            'menu-popup': true,\n            'menu-popup--closing': this.closing,\n            'ds-choice-popup': !this.embedded,\n            'data-preferences-embedded': this.embedded,\n            'ds-choice-popup--closing': this.closing,\n            'ds-focus-ring': showEmpty,\n            'ds-focus-ring--visible': showEmpty && this.focusRingVisible,\n          }}\n          style={this.embedded ? undefined : popupStyle}\n          role={hasCompositeSections || showEmpty ? 'dialog' : 'menu'}\n          aria-label={this.menuLabel}\n          aria-orientation={hasCompositeSections || showEmpty ? undefined : 'vertical'}\n          aria-describedby={showEmpty ? this.emptyMessageId : undefined}\n          tabIndex={showEmpty ? -1 : undefined}\n        >\n          <div class=\"ds-choice-list\">\n            {showEmpty ? (\n              <ds-text\n                textId={this.emptyMessageId}\n                class=\"menu-empty\"\n                as=\"p\"\n                variant={CONTROL_TEXT_VARIANT[this.size]}\n                color=\"secondary\"\n              >\n                {emptyMessage}\n              </ds-text>\n            ) : (\n              sections.map((section, si) => (\n                <div\n                  key={si}\n                  class={{\n                    'menu-section': true,\n                    'menu-section--divided':\n                      si < sections.length - 1 && !this.sectionUsesInsetDivider(sections[si + 1]),\n                    'menu-section--swatch-picker': isMenuPickerSection(section),\n                    'ds-choice-section': true,\n                    'ds-chrome-column': true,\n                    'ds-chrome-space--sm': true,\n                    'ds-choice-section--divided':\n                      si < sections.length - 1 && !this.sectionUsesInsetDivider(sections[si + 1]),\n                    'ds-choice-section--headed-after-first':\n                      si > 0 &&\n                      !isMenuPickerSection(section) &&\n                      Boolean(section.header || section.subheader),\n                  }}\n                  role={\n                    section.header || (!isMenuPickerSection(section) && section.subheader)\n                      ? 'group'\n                      : undefined\n                  }\n                  aria-label={\n                    !isMenuPickerSection(section) && section.subheader\n                      ? section.subheader\n                      : section.header\n                  }\n                >\n                  {!isMenuPickerSection(section) && section.insetDividerBefore && (\n                    <span class=\"menu-subsection-divider\" aria-hidden=\"true\" />\n                  )}\n                  {section.header && (\n                    <ds-text\n                      class={`section-header ds-choice-section__header ds-control-section-heading ds-control--${this.size}`}\n                      as=\"span\"\n                      variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                      emphasis\n                      color=\"primary\"\n                      aria-hidden=\"true\"\n                    >\n                      <span class=\"ds-choice-section__header-label\">{section.header}</span>\n                    </ds-text>\n                  )}\n                  {!isMenuSwatchPickerSection(section) && section.subheader && (\n                    <ds-text\n                      class={`section-subheader ds-choice-section__header ds-control-section-heading ds-control--${this.size}`}\n                      as=\"span\"\n                      variant=\"text-caption\"\n                      emphasis\n                      color=\"secondary\"\n                      aria-hidden=\"true\"\n                    >\n                      <span class=\"ds-choice-section__header-label\">{section.subheader}</span>\n                    </ds-text>\n                  )}\n                  {isMenuSwatchPickerSection(section) ? (\n                    <ds-swatch-picker\n                      value={section.value}\n                      groupLabel={section.groupLabel ?? section.header ?? 'Swatch options'}\n                      options={section.options ?? []}\n                      sections={section.sections ?? []}\n                      onDsChange={(e: CustomEvent<string>) => {\n                        e.stopPropagation();\n                        this.handleSwatchSelect(e.detail);\n                      }}\n                    />\n                  ) : (\n                    section.items.map((item, itemIndex) => {\n                      const idx = flatIdx++;\n                      const isFocused = this.focusedIndex === idx;\n                      const isSingleSelectionItem =\n                        !hasCompositeSections &&\n                        this.selectionMode === 'single' &&\n                        !item.showSwitch;\n                      const usesLeading = section.items.some(\n                        candidate =>\n                          candidate.reorderable ||\n                          candidate.reorderHandleInactive ||\n                          !!candidate.icon\n                      );\n                      const locked = !!item.isInactive && !item.reorderable;\n                      const dragging = this.reorderFromFlat === idx;\n                      const dropBefore =\n                        dragLocated?.sectionIndex === si &&\n                        dragRange !== null &&\n                        itemIndex <= dragRange.end &&\n                        this.reorderInsertBefore === itemIndex;\n                      const dropAfter =\n                        dragLocated?.sectionIndex === si &&\n                        dragRange !== null &&\n                        this.reorderInsertBefore === dragRange.end + 1 &&\n                        itemIndex === dragRange.end;\n                      if (item.trailingActions?.length) {\n                        return (\n                          <div\n                            key={item.value ?? `${si}-${item.label}`}\n                            class={{\n                              'menu-item-row': true,\n                              'menu-item-row--actions': true,\n                              'menu-item': true,\n                              'ds-choice-item': true,\n                              'ds-control-frame': true,\n                              [`ds-control--${this.size}`]: true,\n                              'menu-item--dragging': dragging,\n                            }}\n                            role=\"group\"\n                            aria-label={item.label}\n                            onMouseDown={() => {\n                              this.focusRingVisible = false;\n                            }}\n                            onFocusin={() => {\n                              this.focusedIndex = idx;\n                            }}\n                          >\n                            {(dropBefore || dropAfter) && (\n                              <span\n                                class={{\n                                  'menu-item__drop-rail': true,\n                                  'menu-item__drop-rail--before': dropBefore,\n                                  'menu-item__drop-rail--after': dropAfter,\n                                }}\n                                data-menu-drop-rail\n                                aria-hidden=\"true\"\n                              />\n                            )}\n                            {item.reorderable || item.reorderHandleInactive ? (\n                              <span\n                                class={{\n                                  'menu-item__handle': true,\n                                  'menu-item__handle--action-row': true,\n                                  'menu-item__handle--inactive': Boolean(\n                                    item.reorderHandleInactive\n                                  ),\n                                  'ds-interaction-fill': Boolean(item.reorderable),\n                                  'ds-choice-item__icon': true,\n                                  'ds-control-icon-box': true,\n                                }}\n                                data-menu-handle\n                                aria-hidden=\"true\"\n                                onPointerDown={\n                                  item.reorderable\n                                    ? event => this.onReorderPointerDown(event, si, itemIndex, idx)\n                                    : undefined\n                                }\n                              >\n                                <ds-icon\n                                  class=\"ds-interaction-fill__content\"\n                                  name=\"DragDots\"\n                                  size={this.size}\n                                  color=\"inherit\"\n                                />\n                              </span>\n                            ) : usesLeading && item.icon ? (\n                              <span\n                                class=\"menu-item__icon ds-choice-item__icon ds-control-icon-box\"\n                                aria-hidden=\"true\"\n                              >\n                                <ds-icon name={item.icon} size={this.size} color=\"inherit\" />\n                              </span>\n                            ) : usesLeading ? (\n                              <span\n                                class=\"menu-item__icon-spacer ds-choice-item__icon ds-control-icon-box\"\n                                aria-hidden=\"true\"\n                              />\n                            ) : null}\n                            <div class=\"menu-item__content ds-choice-item__content\">\n                              <ds-text\n                                class=\"menu-item__label ds-choice-item__label ds-control-label-box\"\n                                as=\"span\"\n                                variant={CONTROL_TEXT_VARIANT[this.size]}\n                                color=\"secondary\"\n                              >\n                                {item.label}\n                              </ds-text>\n                              {item.subtext && (\n                                <ds-text\n                                  class=\"menu-item__subtext ds-choice-item__subtext ds-control-label-box\"\n                                  as=\"span\"\n                                  variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                                  color=\"secondary\"\n                                >\n                                  {item.subtext}\n                                </ds-text>\n                              )}\n                            </div>\n                            <span class=\"menu-item-row__actions\">\n                              {item.trailingActions.map((action, actionIndex) => (\n                                <span class=\"menu-item-row__action\" key={action.id}>\n                                  {actionIndex > 0 && (\n                                    <span class=\"menu-item-row__divider\" aria-hidden=\"true\" />\n                                  )}\n                                  <ds-button-unfilled\n                                    variant=\"icon\"\n                                    icon={action.icon}\n                                    size=\"md\"\n                                    ariaLabel={action.label}\n                                    hasBorder={false}\n                                    pressScale={false}\n                                    isInset\n                                    insetDepth=\"single\"\n                                    isInactive={action.isInactive ?? false}\n                                    focusTabIndex={0}\n                                    onDsClick={event => {\n                                      event.stopPropagation();\n                                      this.dsItemToggle.emit({ item, action, pressed: false });\n                                    }}\n                                  />\n                                </span>\n                              ))}\n                            </span>\n                          </div>\n                        );\n                      }\n                      return (\n                        <div\n                          key={item.value ?? `${si}-${item.label}`}\n                          class={{\n                            'menu-item-row': true,\n                            'menu-item-row--trailing-toggle': Boolean(item.trailingToggle),\n                          }}\n                        >\n                          <button\n                            type=\"button\"\n                            class={{\n                              'menu-item': true,\n                              'ds-choice-item': true,\n                              'ds-control-frame': true,\n                              [`ds-control--${this.size}`]: true,\n                              'ds-focus-ring-inset': true,\n                              'ds-focus-ring--visible': isFocused && this.focusRingVisible,\n                              'ds-interaction-fill': !locked,\n                              'ds-interaction-fill--selected': !!item.isSelected && !locked,\n                              'menu-item--selected': !!item.isSelected,\n                              'menu-item--switch': !!item.showSwitch,\n                              'ds-control-inactive': locked,\n                              'menu-item--destructive': !!item.isDestructive,\n                              'menu-item--focused': isFocused,\n                              'menu-item--dragging': dragging,\n                            }}\n                            role={\n                              hasCompositeSections\n                                ? undefined\n                                : item.showSwitch\n                                  ? 'menuitemcheckbox'\n                                  : isSingleSelectionItem\n                                    ? 'menuitemradio'\n                                    : 'menuitem'\n                            }\n                            aria-checked={\n                              !hasCompositeSections && item.showSwitch\n                                ? String(!!item.switchValue)\n                                : isSingleSelectionItem\n                                  ? String(!!item.isSelected)\n                                  : undefined\n                            }\n                            aria-pressed={\n                              hasCompositeSections\n                                ? String(item.showSwitch ? !!item.switchValue : !!item.isSelected)\n                                : undefined\n                            }\n                            aria-current={\n                              !hasCompositeSections &&\n                              !item.showSwitch &&\n                              !isSingleSelectionItem &&\n                              item.isSelected\n                                ? 'true'\n                                : undefined\n                            }\n                            aria-description={\n                              item.reorderable\n                                ? item.isInactive\n                                  ? 'Visibility cannot be changed. Alt + Arrow Up or Alt + Arrow Down moves this row.'\n                                  : 'Drag to reorder. Alt + Arrow Up or Alt + Arrow Down moves this row.'\n                                : undefined\n                            }\n                            aria-disabled={item.isInactive ? 'true' : undefined}\n                            disabled={locked}\n                            tabIndex={\n                              hasCompositeSections || (this.embedded && idx === 0)\n                                ? 0\n                                : isFocused\n                                  ? 0\n                                  : -1\n                            }\n                            onMouseDown={() => {\n                              this.focusRingVisible = false;\n                            }}\n                            onClick={() => this.handleItemClick(item)}\n                            onFocus={() => {\n                              this.focusedIndex = idx;\n                            }}\n                          >\n                            {(dropBefore || dropAfter) && (\n                              <span\n                                class={{\n                                  'menu-item__drop-rail': true,\n                                  'menu-item__drop-rail--before': dropBefore,\n                                  'menu-item__drop-rail--after': dropAfter,\n                                }}\n                                data-menu-drop-rail\n                                aria-hidden=\"true\"\n                              />\n                            )}\n                            {item.reorderable || item.reorderHandleInactive ? (\n                              <span\n                                class={{\n                                  'menu-item__handle': true,\n                                  'menu-item__handle--inactive': Boolean(\n                                    item.reorderHandleInactive\n                                  ),\n                                  'ds-choice-item__icon': true,\n                                  'ds-control-icon-box': true,\n                                  'ds-interaction-fill__content': true,\n                                }}\n                                data-menu-handle\n                                aria-hidden=\"true\"\n                                onPointerDown={\n                                  item.reorderable\n                                    ? event => this.onReorderPointerDown(event, si, itemIndex, idx)\n                                    : undefined\n                                }\n                                onClick={\n                                  item.reorderable\n                                    ? event => {\n                                        event.preventDefault();\n                                        event.stopPropagation();\n                                      }\n                                    : undefined\n                                }\n                              >\n                                <ds-icon name=\"DragDots\" size={this.size} color=\"inherit\" />\n                              </span>\n                            ) : usesLeading && item.icon ? (\n                              <span\n                                class=\"menu-item__icon ds-choice-item__icon ds-control-icon-box ds-interaction-fill__content\"\n                                aria-hidden=\"true\"\n                              >\n                                <ds-icon name={item.icon} size={this.size} color=\"inherit\" />\n                              </span>\n                            ) : usesLeading ? (\n                              <span\n                                class=\"menu-item__icon-spacer ds-choice-item__icon ds-control-icon-box\"\n                                aria-hidden=\"true\"\n                              />\n                            ) : null}\n                            <div class=\"menu-item__content ds-choice-item__content ds-interaction-fill__content\">\n                              <ds-text\n                                class=\"menu-item__label ds-choice-item__label ds-control-label-box\"\n                                as=\"span\"\n                                variant={CONTROL_TEXT_VARIANT[this.size]}\n                                color={item.isSelected ? 'primary' : 'secondary'}\n                              >\n                                {item.label}\n                              </ds-text>\n                              {item.subtext && (\n                                <ds-text\n                                  class=\"menu-item__subtext ds-choice-item__subtext ds-control-label-box\"\n                                  as=\"span\"\n                                  variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                                  color=\"secondary\"\n                                >\n                                  {item.subtext}\n                                </ds-text>\n                              )}\n                            </div>\n                            {item.tag && (\n                              <ds-tag\n                                class=\"ds-choice-item__tag ds-interaction-fill__content\"\n                                label={item.tag.label}\n                                size={MENU_ITEM_TAG_SIZE[this.size]}\n                                intent={item.tag.intent ?? 'neutral'}\n                                contrast={item.tag.contrast ?? 'faint'}\n                                rounded={item.tag.rounded ?? false}\n                                isInset\n                              />\n                            )}\n                            {item.dot && (\n                              <span\n                                class=\"menu-item__dot-box ds-interaction-fill__content\"\n                                aria-hidden=\"true\"\n                              >\n                                <ds-badge\n                                  class=\"menu-item__dot\"\n                                  variant=\"dot\"\n                                  hasRing={false}\n                                  label=\"\"\n                                />\n                              </span>\n                            )}\n                            {item.showSwitch && (\n                              <ds-switch\n                                class=\"menu-item__switch ds-interaction-fill__content\"\n                                size={this.size}\n                                checked={!!item.switchValue}\n                                isInactive={!!item.isInactive}\n                                presentation\n                              />\n                            )}\n                          </button>\n                          {item.trailingToggle && (\n                            <span class=\"menu-item-row__trailing-toggle\">\n                              <span class=\"menu-item-row__divider\" aria-hidden=\"true\" />\n                              <ds-button-unfilled\n                                variant=\"icon\"\n                                icon={item.trailingToggle.icon}\n                                size={this.size}\n                                ariaLabel={item.trailingToggle.label}\n                                hasBorder={false}\n                                pressScale={false}\n                                pressed={item.trailingToggle.pressed}\n                                isInactive={item.trailingToggle.isInactive ?? false}\n                                onDsChange={event => {\n                                  event.stopPropagation();\n                                  this.dsItemToggle.emit({ item, pressed: event.detail });\n                                }}\n                              />\n                            </span>\n                          )}\n                        </div>\n                      );\n                    })\n                  )}\n                </div>\n              ))\n            )}\n          </div>\n        </div>\n        <div class=\"ds-visually-hidden\" role=\"status\" aria-live=\"polite\">\n          {this.reorderAnnouncement}\n        </div>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     },
     {
@@ -611,12 +630,12 @@
     },
     {
       "path": "src/wc/components/Menu/menu-sections.ts",
-      "content": "import type { MenuSection } from './menu-types';\nimport { isMenuSwatchPickerSection } from './menu-types';\n\n/** Preserve the exact menu context painted during exit motion. */\nexport function snapshotMenuSections(sections: readonly MenuSection[]): MenuSection[] {\n  return sections.map(section => {\n    if (isMenuSwatchPickerSection(section)) {\n      return {\n        ...section,\n        ...(section.options ? { options: section.options.map(option => ({ ...option })) } : {}),\n        ...(section.sections\n          ? {\n              sections: section.sections.map(swatchSection => ({\n                ...swatchSection,\n                options: swatchSection.options.map(option => ({ ...option })),\n              })),\n            }\n          : {}),\n      };\n    }\n    return { ...section, items: section.items.map(item => ({ ...item })) };\n  });\n}\n",
+      "content": "import type { MenuSection } from './menu-types';\nimport { isMenuSwatchPickerSection } from './menu-types';\n\n/** Preserve the exact menu context painted during exit motion. */\nexport function snapshotMenuSections(sections: readonly MenuSection[]): MenuSection[] {\n  return sections.map(section => {\n    if (isMenuSwatchPickerSection(section)) {\n      return {\n        ...section,\n        ...(section.options ? { options: section.options.map(option => ({ ...option })) } : {}),\n        ...(section.sections\n          ? {\n              sections: section.sections.map(swatchSection => ({\n                ...swatchSection,\n                options: swatchSection.options.map(option => ({ ...option })),\n              })),\n            }\n          : {}),\n      };\n    }\n    return {\n      ...section,\n      items: section.items.map(item => ({\n        ...item,\n        ...(item.trailingToggle ? { trailingToggle: { ...item.trailingToggle } } : {}),\n        ...(item.trailingActions\n          ? { trailingActions: item.trailingActions.map(action => ({ ...action })) }\n          : {}),\n      })),\n    };\n  });\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/Menu/menu-types.ts",
-      "content": "import type { SwatchPickerOption, SwatchPickerSection } from '../SwatchPicker/swatch-picker-types';\nimport type { TagContrast, TagIntent } from '../Tag/Tag';\n\nexport type { MenuAlign, MenuSide } from './menu-position';\nexport {\n  PANEL_NAV_USER_MENU_PLACEMENT,\n  PANEL_TOOLS_HEADER_MENU_PLACEMENT,\n  type MenuPlacement,\n} from './menu-placement';\n\nexport interface MenuItemTagData {\n  label: string;\n  intent?: TagIntent;\n  contrast?: TagContrast;\n  rounded?: boolean;\n}\n\nexport interface MenuItemData {\n  label: string;\n  value?: string;\n  subtext?: string;\n  /** Leading decorative icon. Ignored when `reorderable` is true. */\n  icon?: string;\n  /** Show a supplemental brand notification dot. */\n  dot?: boolean;\n  /** Show a non-interactive tag at the trailing edge of the row. */\n  tag?: MenuItemTagData;\n  isSelected?: boolean;\n  isInactive?: boolean;\n  isDestructive?: boolean;\n  /** Render a compact switch indicator; the menu row owns interaction. */\n  showSwitch?: boolean;\n  switchValue?: boolean;\n  /** Prefix a drag handle and allow pointer and keyboard reorder within the contiguous reorderable run. */\n  reorderable?: boolean;\n}\n\n/** Next section item order after a pointer or keyboard reorder. */\nexport interface MenuReorderDetail {\n  item: MenuItemData;\n  fromIndex: number;\n  toIndex: number;\n  sectionIndex: number;\n  items: MenuItemData[];\n}\n\nexport interface MenuItemsSection {\n  header?: string;\n  items: MenuItemData[];\n}\n\nexport interface MenuSwatchPickerSection {\n  header?: string;\n  variant: 'swatch-picker';\n  value: string;\n  options?: SwatchPickerOption[];\n  sections?: SwatchPickerSection[];\n  groupLabel?: string;\n}\n\nexport type MenuSection = MenuItemsSection | MenuSwatchPickerSection;\n\nexport function isMenuSwatchPickerSection(\n  section: MenuSection\n): section is MenuSwatchPickerSection {\n  return 'variant' in section && section.variant === 'swatch-picker';\n}\n\nexport function isMenuPickerSection(section: MenuSection): section is MenuSwatchPickerSection {\n  return isMenuSwatchPickerSection(section);\n}\n\nexport type { SwatchPickerOption, SwatchPickerSection };\n",
+      "content": "import type { SwatchPickerOption, SwatchPickerSection } from '../SwatchPicker/swatch-picker-types';\nimport type { TagContrast, TagIntent } from '../Tag/Tag';\n\nexport type { MenuAlign, MenuSide } from './menu-position';\nexport {\n  PANEL_NAV_USER_MENU_PLACEMENT,\n  PANEL_TOOLS_HEADER_MENU_PLACEMENT,\n  type MenuPlacement,\n} from './menu-placement';\n\nexport interface MenuItemTagData {\n  label: string;\n  intent?: TagIntent;\n  contrast?: TagContrast;\n  rounded?: boolean;\n}\n\nexport interface MenuItemTrailingToggleData {\n  /** Icon-only toggle glyph. */\n  icon: string;\n  /** Accessible name describing the requested state change. */\n  label: string;\n  /** Controlled toggle state. */\n  pressed: boolean;\n  /** Keep the toggle visible but unavailable. */\n  isInactive?: boolean;\n}\n\nexport interface MenuItemActionData {\n  /** Stable action identity for consumer event handling. */\n  id: string;\n  /** Icon-only action glyph. */\n  icon: string;\n  /** Accessible name describing the action. */\n  label: string;\n  /** Keep the action visible but unavailable. */\n  isInactive?: boolean;\n}\n\nexport interface MenuItemData {\n  label: string;\n  value?: string;\n  subtext?: string;\n  /** Leading decorative icon. Ignored when `reorderable` is true. */\n  icon?: string;\n  /** Show a supplemental brand notification dot. */\n  dot?: boolean;\n  /** Show a non-interactive tag at the trailing edge of the row. */\n  tag?: MenuItemTagData;\n  isSelected?: boolean;\n  isInactive?: boolean;\n  isDestructive?: boolean;\n  /** Render a compact switch indicator; the menu row owns interaction. */\n  showSwitch?: boolean;\n  switchValue?: boolean;\n  /** Prefix a drag handle and allow pointer and keyboard reorder within the contiguous reorderable run. */\n  reorderable?: boolean;\n  /** Keep the drag handle visible as an inactive alignment affordance when reordering is unavailable. */\n  reorderHandleInactive?: boolean;\n  /** Append a separate unfilled icon toggle after a decorative divider. */\n  trailingToggle?: MenuItemTrailingToggleData;\n  /** Append independent unfilled icon actions while the row owns the shared hover surface. */\n  trailingActions?: MenuItemActionData[];\n}\n\nexport interface MenuItemToggleDetail {\n  item: MenuItemData;\n  pressed: boolean;\n  /** Identifies an independent trailing action; omitted for the legacy toggle control. */\n  action?: MenuItemActionData;\n}\n\n/** Next section item order after a pointer or keyboard reorder. */\nexport interface MenuReorderDetail {\n  item: MenuItemData;\n  fromIndex: number;\n  toIndex: number;\n  sectionIndex: number;\n  items: MenuItemData[];\n}\n\nexport interface MenuItemsSection {\n  header?: string;\n  /** Secondary heading beneath a shared parent section heading. */\n  subheader?: string;\n  /** Separate this subsection from the previous one with an inset divider. */\n  insetDividerBefore?: boolean;\n  items: MenuItemData[];\n}\n\nexport interface MenuSwatchPickerSection {\n  header?: string;\n  variant: 'swatch-picker';\n  value: string;\n  options?: SwatchPickerOption[];\n  sections?: SwatchPickerSection[];\n  groupLabel?: string;\n}\n\nexport type MenuSection = MenuItemsSection | MenuSwatchPickerSection;\n\nexport function isMenuSwatchPickerSection(\n  section: MenuSection\n): section is MenuSwatchPickerSection {\n  return 'variant' in section && section.variant === 'swatch-picker';\n}\n\nexport function isMenuPickerSection(section: MenuSection): section is MenuSwatchPickerSection {\n  return isMenuSwatchPickerSection(section);\n}\n\nexport type { SwatchPickerOption, SwatchPickerSection };\n",
       "type": "registry:ui"
     }
   ]

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

@@ -167,7 +167,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -127,7 +127,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -285,7 +285,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -212,7 +212,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -259,7 +259,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

package/dist/mcp-data/registry/mobile-bar-nav.json

@@ -429,7 +429,7 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: currentArea.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -368,7 +368,7 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: sections, subsections.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

package/dist/mcp-data/registry/mobile-section-switcher.json

@@ -228,7 +228,7 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: sections.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

package/dist/mcp-data/registry/mobile-sheet-nav.json

@@ -390,7 +390,7 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: dashboardGroups, settingsGroups.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -298,7 +298,7 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."

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

@@ -410,7 +410,7 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: pageSizeOptions.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.6.1",
+          "@ds-mo/tokens ^6.7.0",
           "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."