@ds-mo/ui 15.4.0 → 15.5.0

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

@@ -594,7 +594,7 @@
     },
     {
       "path": "src/wc/components/InputTime/InputTime.tsx",
-      "content": "import {\n  AttachInternals,\n  Component,\n  Element,\n  Prop,\n  State,\n  Event,\n  EventEmitter,\n  Listen,\n  Method,\n  Watch,\n  h,\n  Host,\n} from '@stencil/core';\nimport {\n  controlWidthClass,\n  CONTROL_TEXT_VARIANT,\n  DEFAULT_REQUIRED_MESSAGE,\n  formatClockTimeLabel,\n  isClockTime,\n  isClockTimeStepAligned,\n  parseLooseClockTime,\n  resolveChoicePopupAlignOffset,\n  resolveCssLengthPx,\n  resolveMotionTimeMs,\n  restoreStringFormState,\n  setFormControlValue,\n  TOKEN_DEFAULTS,\n  type ControlSize,\n  type ControlWidth,\n} from '../../utils';\nimport { AnchoredPositionController } from '../../utils/anchored-position-controller';\nimport { AnchoredOverlayInteractionController } from '../../utils/anchored-overlay-interaction-controller';\nimport { resolveAnchoredOverlayBoundaryRect } from '../../utils/anchored-overlay-boundary';\n\nexport type InputTimeSize = ControlSize;\nexport type InputTimeWidth = ControlWidth;\n\nlet idCounter = 0;\n\nconst INVALID_TIME_MESSAGE = 'Enter a valid time.';\nconst TIME_BEFORE_MIN_MESSAGE = 'Time is before the minimum allowed time.';\nconst TIME_AFTER_MAX_MESSAGE = 'Time is after the maximum allowed time.';\nconst TIME_STEP_MESSAGE = 'Time does not match the allowed interval.';\n\n@Component({\n  tag: 'ds-input-time',\n  styleUrl: 'InputTime.css',\n  scoped: true,\n  formAssociated: true,\n})\nexport class InputTime {\n  @Element() el!: HTMLElement;\n  @AttachInternals() internals!: ElementInternals;\n\n  private generatedId = `ds-input-time-${++idCounter}`;\n  private errorId = `${this.generatedId}-error`;\n  private popupId = `${this.generatedId}-popup`;\n\n  @Prop({ mutable: true }) value: string = '';\n  @Prop({ reflect: true }) name: string | undefined;\n  @Prop({ reflect: true }) form: string | undefined;\n  @Prop({ reflect: true }) disabled: boolean = false;\n  @Prop({ reflect: true }) readOnly: boolean = false;\n  @Prop({ reflect: true }) required: boolean = false;\n  @Prop() requiredMessage: string = DEFAULT_REQUIRED_MESSAGE;\n  /** Native time step in seconds. Defaults to minutes (`60`). */\n  @Prop() step: string | number = 60;\n  /** Display format; submitted values remain HH:MM in either format. */\n  @Prop() hourFormat: '12' | '24' = '12';\n  @Prop() min: string | undefined;\n  @Prop() max: string | undefined;\n  @Prop() size: InputTimeSize = 'md';\n  @Prop() width: InputTimeWidth = 'fill';\n  @Prop() hasBorder: boolean = true;\n  @Prop() hasInteractionFill: boolean = true;\n  @Prop() isInactive: boolean = false;\n  @Prop() autoFocus: boolean = false;\n  @Prop() error: boolean = false;\n  @Prop() errorMessage: string | undefined;\n  @Prop() inputId: string | undefined;\n  @Prop({ attribute: 'aria-label' }) ariaLabel: string | null = null;\n  @Prop({ attribute: 'aria-labelledby' }) ariaLabelledby: string | undefined;\n  @Prop({ attribute: 'aria-describedby' }) ariaDescribedby: string | undefined;\n\n  @Event() dsChange!: EventEmitter<string>;\n\n  private initialValue = '';\n  private inputEl?: HTMLInputElement;\n  private controlEl?: HTMLElement;\n  private clockButton?: HTMLDsButtonUnfilledElement;\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  @State() private formDisabled = false;\n  @State() private focused = false;\n  @State() private touched = false;\n  @State() private draftText = '';\n  @State() private open = false;\n  @State() private shouldRender = false;\n  @State() private closing = false;\n  @State() private positionReady = false;\n  @State() private pos = { x: 0, y: 0 };\n\n  private readonly position = new AnchoredPositionController({\n    getAnchor: () => this.controlEl ?? null,\n    getPopup: () => this.el.querySelector<HTMLElement>('.input-time-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    measure: (anchor, popup) => {\n      if (!this.open) return null;\n      const sectionInsetPx = resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050);\n      return {\n        anchorRect: anchor.getBoundingClientRect(),\n        popupWidth: popup.offsetWidth || this.popupFallbackWidth,\n        popupHeight: popup.offsetHeight || this.popupFallbackHeight,\n        side: 'bottom',\n        align: 'end',\n        sideOffsetPx: resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050),\n        alignOffsetPx: resolveChoicePopupAlignOffset({\n          align: 'end',\n          alignOffsetPx: 0,\n          sectionInsetPx,\n          anchorAlignment: 'popup-frame',\n        }),\n        viewportPadPx: resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050),\n        viewportWidth: window.innerWidth,\n        viewportHeight: window.innerHeight,\n        collisionRect: resolveAnchoredOverlayBoundaryRect(anchor),\n      };\n    },\n    apply: ({ x, y }) => {\n      this.pos = { x, y };\n    },\n    onReady: () => {\n      this.positionReady = true;\n    },\n    liveUpdate: 'double-frame',\n    observeResize: true,\n    topLayer: true,\n  });\n  private readonly interaction = new AnchoredOverlayInteractionController({\n    getAnchor: () => this.controlEl ?? null,\n    getPopup: () => this.el.querySelector<HTMLElement>('.input-time-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    onOutsideActivation: () => this.closePicker(false),\n  });\n\n  private get popupFallbackWidth(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuWidthXs, TOKEN_DEFAULTS.menuWidthXs);\n  }\n\n  private get popupFallbackHeight(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuFallbackHeight, TOKEN_DEFAULTS.menuFallbackHeight);\n  }\n\n  private get formInactive(): boolean {\n    return this.isInactive || this.disabled || this.formDisabled;\n  }\n\n  private get pickerInactive(): boolean {\n    return this.formInactive || this.readOnly;\n  }\n\n  private get hasConstraintError(): boolean {\n    if (!this.value) return false;\n    if (!isClockTime(this.value)) return true;\n    if (this.min && isClockTime(this.min) && this.value < this.min) return true;\n    if (this.max && isClockTime(this.max) && this.value > this.max) return true;\n    return !isClockTimeStepAligned(this.value, this.step, this.min);\n  }\n\n  private get isInvalid(): boolean {\n    return (\n      this.error ||\n      (!this.formInactive &&\n        ((this.required && this.value.length === 0) || this.hasConstraintError))\n    );\n  }\n\n  componentWillLoad() {\n    this.initialValue = this.value;\n    this.syncFormValue();\n  }\n\n  disconnectedCallback() {\n    this.position.unobserve();\n    this.teardownListeners();\n  }\n\n  @Watch('hourFormat')\n  onHourFormatChange() {\n    this.draftText = this.displayValue;\n  }\n\n  @Watch('value')\n  @Watch('required')\n  @Watch('requiredMessage')\n  @Watch('min')\n  @Watch('max')\n  @Watch('step')\n  syncFormValue() {\n    const inactive = this.formInactive;\n    setFormControlValue(this.internals, this.value, { inactive });\n    const flags: ValidityStateFlags = {};\n    let message = '';\n    if (!inactive) {\n      if (this.required && this.value.length === 0) {\n        flags.valueMissing = true;\n        message = this.requiredMessage;\n      } else if (this.value && !isClockTime(this.value)) {\n        flags.badInput = true;\n        message = INVALID_TIME_MESSAGE;\n      } else if (this.value && this.min && isClockTime(this.min) && this.value < this.min) {\n        flags.rangeUnderflow = true;\n        message = TIME_BEFORE_MIN_MESSAGE;\n      } else if (this.value && this.max && isClockTime(this.max) && this.value > this.max) {\n        flags.rangeOverflow = true;\n        message = TIME_AFTER_MAX_MESSAGE;\n      } else if (this.value && !isClockTimeStepAligned(this.value, this.step, this.min)) {\n        flags.stepMismatch = true;\n        message = TIME_STEP_MESSAGE;\n      }\n    }\n    this.internals.setValidity(flags, message);\n  }\n\n  @Watch('disabled')\n  @Watch('isInactive')\n  @Watch('readOnly')\n  onInteractionStateChange() {\n    this.syncFormValue();\n    if (this.pickerInactive && this.shouldRender) this.closePicker(false);\n  }\n\n  formDisabledCallback(disabled: boolean) {\n    this.formDisabled = disabled;\n    this.onInteractionStateChange();\n  }\n\n  formResetCallback() {\n    this.value = this.initialValue;\n    this.draftText = this.displayValue;\n  }\n\n  formStateRestoreCallback(state: string | File | FormData | null) {\n    this.value = restoreStringFormState(state);\n    this.draftText = this.displayValue;\n  }\n\n  @Method()\n  async setFocus() {\n    this.inputEl?.focus();\n  }\n\n  @Listen('keydown')\n  handleHostKeyDown(event: KeyboardEvent) {\n    if (!this.shouldRender || this.closing) return;\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      this.closePicker('button');\n      return;\n    }\n    if (event.key !== 'Tab') return;\n    const popup = this.el.querySelector<HTMLElement>('.input-time-popup');\n    if (!popup || !event.composedPath().includes(popup)) return;\n    if (!this.interaction.tabLeavesPopup(event)) return;\n    event.preventDefault();\n    this.closePicker(false);\n    this.interaction.moveFocusAfterTab(event.shiftKey);\n  }\n\n  private get displayValue(): string {\n    return this.hourFormat === '24' ? this.value : formatClockTimeLabel(this.value);\n  }\n\n  private parseDraft(text: string): string | null {\n    const trimmed = text.trim();\n    if (!trimmed) return '';\n    const iso = parseLooseClockTime(trimmed);\n    if (!iso) return null;\n    if (this.min && isClockTime(this.min) && iso < this.min) return null;\n    if (this.max && isClockTime(this.max) && iso > this.max) return null;\n    if (!isClockTimeStepAligned(iso, this.step, this.min)) return null;\n    return iso;\n  }\n\n  private commitIso(iso: string, emit = true) {\n    if (this.value !== iso) {\n      this.value = iso;\n      if (emit) this.dsChange.emit(iso);\n    }\n    this.draftText = this.hourFormat === '24' ? iso : formatClockTimeLabel(iso);\n  }\n\n  private teardownListeners() {\n    this.position.unobserve();\n    this.interaction.disconnect();\n    if (this.closeTimer) {\n      clearTimeout(this.closeTimer);\n      this.closeTimer = null;\n    }\n  }\n\n  private openPicker() {\n    const inactive = this.isInactive || this.disabled || this.formDisabled || this.readOnly;\n    if (inactive || this.open) return;\n    this.shouldRender = true;\n    this.closing = false;\n    this.positionReady = false;\n    this.open = true;\n    this.teardownListeners();\n    this.interaction.connect();\n    this.position.observe();\n    this.position.schedule();\n  }\n\n  private closePicker(restore: 'input' | 'button' | false) {\n    if (!this.shouldRender || this.closing) return;\n    this.open = false;\n    this.position.cancel();\n    this.closing = true;\n    this.interaction.disconnect();\n    this.position.unobserve();\n    if (restore === 'input') this.inputEl?.focus();\n    if (restore === 'button') void this.clockButton?.setFocus();\n    const duration = resolveMotionTimeMs(\n      TOKEN_DEFAULTS.motionShort2,\n      TOKEN_DEFAULTS.animationDurationShort3\n    );\n    if (duration <= 0) {\n      this.finishClose();\n      return;\n    }\n    this.closeTimer = setTimeout(() => this.finishClose(), duration);\n  }\n\n  private finishClose() {\n    const popup = this.el.querySelector<HTMLElement>('.input-time-popup');\n    if (popup?.matches(':popover-open')) popup.hidePopover();\n    this.shouldRender = false;\n    this.closing = false;\n    this.closeTimer = null;\n  }\n\n  private togglePicker = () => {\n    if (this.isInactive || this.disabled || this.formDisabled || this.readOnly) return;\n    if (this.open) this.closePicker('button');\n    else this.openPicker();\n  };\n\n  private handleInput = (event: Event) => {\n    if (this.pickerInactive) return;\n    this.draftText = (event.target as HTMLInputElement).value;\n    const parsed = this.parseDraft(this.draftText);\n    if (parsed === null) return;\n    this.commitIso(parsed);\n  };\n\n  private handleFocus = () => {\n    this.draftText = this.displayValue || this.value;\n    this.focused = true;\n  };\n\n  private handleBlur = () => {\n    this.focused = false;\n    this.touched = true;\n    if (this.pickerInactive) {\n      this.draftText = this.displayValue;\n      return;\n    }\n    const parsed = this.parseDraft(this.draftText);\n    if (parsed === null) {\n      this.draftText = this.displayValue;\n      return;\n    }\n    this.commitIso(parsed);\n  };\n\n  private handleTimeChange = (event: CustomEvent<string>) => {\n    event.stopPropagation();\n    if (this.pickerInactive) return;\n    const parsed = this.parseDraft(event.detail);\n    if (parsed === null) return;\n    this.commitIso(parsed);\n  };\n\n  render() {\n    const inputId = this.inputId ?? this.generatedId;\n    const inactive = this.formInactive;\n    const pickerInactive = this.pickerInactive;\n    const filled = this.value.length > 0;\n    const dirty = this.value !== this.initialValue;\n    const showError = this.error && Boolean(this.errorMessage);\n    const textVariant = CONTROL_TEXT_VARIANT[this.size];\n    const textClass = `ds-text--${textVariant.replace('text-', '')}`;\n    const describedBy =\n      [this.ariaDescribedby, showError ? this.errorId : undefined].filter(Boolean).join(' ') ||\n      undefined;\n    const popupStyle = {\n      position: 'fixed',\n      left: '0',\n      top: '0',\n      transform: `translate(${Math.round(this.pos.x)}px, ${Math.round(this.pos.y)}px)`,\n      zIndex: 'var(--dimension-z-index-floating)',\n      visibility: this.positionReady ? 'visible' : 'hidden',\n    };\n\n    return (\n      <Host\n        class={{\n          'input-host': true,\n          'ds-field-stack': true,\n          'ds-field-stack--supporting-inset': !this.hasBorder,\n          'ds-control-inactive': inactive,\n          [`ds-control--${this.size}`]: true,\n          ...controlWidthClass(this.width),\n        }}\n        data-disabled={inactive ? '' : undefined}\n        data-readonly={this.readOnly ? '' : undefined}\n        data-required={this.required ? '' : undefined}\n        data-invalid={this.isInvalid ? '' : undefined}\n        data-filled={filled ? '' : undefined}\n        data-focused={this.focused ? '' : undefined}\n        data-dirty={dirty ? '' : undefined}\n        data-touched={this.touched ? '' : undefined}\n      >\n        <div\n          ref={element => {\n            this.controlEl = element;\n          }}\n          class={{\n            'input-control': true,\n            'ds-control-frame': true,\n            'input-control--bordered': this.hasBorder,\n            'input-control--error': this.hasBorder && this.error,\n            'ds-interaction-fill': this.hasInteractionFill,\n            [`ds-control--${this.size}`]: true,\n          }}\n        >\n          <input\n            ref={element => {\n              this.inputEl = element;\n            }}\n            type=\"text\"\n            id={inputId}\n            value={this.focused ? this.draftText : this.displayValue}\n            disabled={inactive}\n            readOnly={this.readOnly}\n            required={this.required}\n            autoFocus={this.autoFocus}\n            autoComplete=\"off\"\n            spellcheck={false}\n            class={{\n              'native-input': true,\n              'native-input--align-start': true,\n              'ds-control-label-box': true,\n              [textClass]: true,\n              'ds-text--regular': true,\n            }}\n            aria-label={this.ariaLabel}\n            aria-labelledby={this.ariaLabelledby}\n            aria-describedby={describedBy}\n            aria-invalid={this.isInvalid ? 'true' : undefined}\n            onInput={this.handleInput}\n            onFocus={this.handleFocus}\n            onBlur={this.handleBlur}\n          />\n          <ds-button-unfilled\n            ref={element => {\n              this.clockButton = element as HTMLDsButtonUnfilledElement | undefined;\n            }}\n            class=\"input-control__datetime-action\"\n            variant=\"icon\"\n            size={this.size}\n            icon=\"Clock\"\n            hasBorder={false}\n            isInset\n            isInactive={pickerInactive}\n            ariaLabel=\"Choose time\"\n            haspopup=\"dialog\"\n            expanded={this.open}\n            surfaceOpen={this.open || this.closing}\n            controls={this.open ? this.popupId : undefined}\n            onDsClick={this.togglePicker}\n          />\n        </div>\n        {this.shouldRender ? (\n          <div\n            id={this.popupId}\n            popover=\"manual\"\n            class={{\n              'input-time-popup': true,\n              'ds-choice-popup': true,\n              'ds-choice-popup--closing': this.closing,\n              'ds-chrome-column': true,\n              'ds-chrome-space--sm': true,\n            }}\n            style={popupStyle}\n            role=\"dialog\"\n            aria-label=\"Choose time\"\n          >\n            <ds-time-picker\n              hourFormat={this.hourFormat}\n              value={this.value}\n              min={this.min}\n              max={this.max}\n              step={this.step}\n              isInactive={pickerInactive}\n              autoFocus\n              onDsChange={this.handleTimeChange}\n            />\n          </div>\n        ) : null}\n        {showError && (\n          <ds-text\n            class=\"error-text\"\n            as=\"div\"\n            variant=\"text-body-small\"\n            color=\"negative\"\n            textId={this.errorId}\n            role=\"alert\"\n          >\n            {this.errorMessage}\n          </ds-text>\n        )}\n      </Host>\n    );\n  }\n}\n",
+      "content": "import {\n  AttachInternals,\n  Component,\n  Element,\n  Prop,\n  State,\n  Event,\n  EventEmitter,\n  Listen,\n  Method,\n  Watch,\n  h,\n  Host,\n} from '@stencil/core';\nimport {\n  controlWidthClass,\n  CONTROL_TEXT_VARIANT,\n  DEFAULT_REQUIRED_MESSAGE,\n  formatClockTimeLabel,\n  isClockTime,\n  isClockTimeStepAligned,\n  parseLooseClockTime,\n  resolveChoicePopupAlignOffset,\n  resolveCssLengthPx,\n  resolveMotionTimeMs,\n  restoreStringFormState,\n  setFormControlValue,\n  TOKEN_DEFAULTS,\n  type ControlSize,\n  type ControlWidth,\n} from '../../utils';\nimport { AnchoredPositionController } from '../../utils/anchored-position-controller';\nimport { AnchoredOverlayInteractionController } from '../../utils/anchored-overlay-interaction-controller';\nimport { resolveAnchoredOverlayBoundaryRect } from '../../utils/anchored-overlay-boundary';\n\nexport type InputTimeSize = ControlSize;\nexport type InputTimeWidth = ControlWidth;\n\nlet idCounter = 0;\n\nconst INVALID_TIME_MESSAGE = 'Enter a valid time.';\nconst TIME_BEFORE_MIN_MESSAGE = 'Time is before the minimum allowed time.';\nconst TIME_AFTER_MAX_MESSAGE = 'Time is after the maximum allowed time.';\nconst TIME_STEP_MESSAGE = 'Time does not match the allowed interval.';\n\n@Component({\n  tag: 'ds-input-time',\n  styleUrl: 'InputTime.css',\n  scoped: true,\n  formAssociated: true,\n})\nexport class InputTime {\n  @Element() el!: HTMLElement;\n  @AttachInternals() internals!: ElementInternals;\n\n  private generatedId = `ds-input-time-${++idCounter}`;\n  private errorId = `${this.generatedId}-error`;\n  private popupId = `${this.generatedId}-popup`;\n\n  @Prop({ mutable: true }) value: string = '';\n  @Prop({ reflect: true }) name: string | undefined;\n  @Prop({ reflect: true }) form: string | undefined;\n  @Prop({ reflect: true }) disabled: boolean = false;\n  @Prop({ reflect: true }) readOnly: boolean = false;\n  @Prop({ reflect: true }) required: boolean = false;\n  @Prop() requiredMessage: string = DEFAULT_REQUIRED_MESSAGE;\n  /** Native time step in seconds. Defaults to minutes (`60`). */\n  @Prop() step: string | number = 60;\n  /** Display format; submitted values remain HH:MM in either format. */\n  @Prop() hourFormat: '12' | '24' = '12';\n  @Prop() min: string | undefined;\n  @Prop() max: string | undefined;\n  @Prop() size: InputTimeSize = 'md';\n  @Prop() width: InputTimeWidth = 'fill';\n  @Prop() hasBorder: boolean = true;\n  @Prop() hasInteractionFill: boolean = true;\n  @Prop() isInactive: boolean = false;\n  @Prop() autoFocus: boolean = false;\n  @Prop() error: boolean = false;\n  @Prop() errorMessage: string | undefined;\n  @Prop() inputId: string | undefined;\n  @Prop({ attribute: 'aria-label' }) ariaLabel: string | null = null;\n  @Prop({ attribute: 'aria-labelledby' }) ariaLabelledby: string | undefined;\n  @Prop({ attribute: 'aria-describedby' }) ariaDescribedby: string | undefined;\n\n  @Event() dsChange!: EventEmitter<string>;\n\n  private initialValue = '';\n  private inputEl?: HTMLInputElement;\n  private controlEl?: HTMLElement;\n  private clockButton?: HTMLDsButtonUnfilledElement;\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  @State() private formDisabled = false;\n  @State() private focused = false;\n  @State() private touched = false;\n  @State() private draftText = '';\n  @State() private open = false;\n  @State() private shouldRender = false;\n  @State() private closing = false;\n  @State() private positionReady = false;\n  @State() private pos = { x: 0, y: 0 };\n\n  private readonly position = new AnchoredPositionController({\n    getAnchor: () => this.controlEl ?? null,\n    getPopup: () => this.el.querySelector<HTMLElement>('.input-time-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    measure: (anchor, popup) => {\n      if (!this.open) return null;\n      const sectionInsetPx = resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050);\n      return {\n        anchorRect: anchor.getBoundingClientRect(),\n        popupWidth: popup.offsetWidth || this.popupFallbackWidth,\n        popupHeight: popup.offsetHeight || this.popupFallbackHeight,\n        side: 'bottom',\n        align: 'end',\n        sideOffsetPx: resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050),\n        alignOffsetPx: resolveChoicePopupAlignOffset({\n          align: 'end',\n          alignOffsetPx: 0,\n          sectionInsetPx,\n          anchorAlignment: 'popup-frame',\n        }),\n        viewportPadPx: resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050),\n        viewportWidth: window.innerWidth,\n        viewportHeight: window.innerHeight,\n        collisionRect: resolveAnchoredOverlayBoundaryRect(anchor),\n      };\n    },\n    apply: ({ x, y }) => {\n      this.pos = { x, y };\n    },\n    onReady: () => {\n      this.positionReady = true;\n    },\n    liveUpdate: 'double-frame',\n    observeResize: true,\n    topLayer: true,\n  });\n  private readonly interaction = new AnchoredOverlayInteractionController({\n    getAnchor: () => this.controlEl ?? null,\n    getPopup: () => this.el.querySelector<HTMLElement>('.input-time-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    onOutsideActivation: () => this.closePicker(false),\n  });\n\n  private get popupFallbackWidth(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuWidthXs, TOKEN_DEFAULTS.menuWidthXs);\n  }\n\n  private get popupFallbackHeight(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuFallbackHeight, TOKEN_DEFAULTS.menuFallbackHeight);\n  }\n\n  private get formInactive(): boolean {\n    return this.isInactive || this.disabled || this.formDisabled;\n  }\n\n  private get pickerInactive(): boolean {\n    return this.formInactive || this.readOnly;\n  }\n\n  private get hasConstraintError(): boolean {\n    if (!this.value) return false;\n    if (!isClockTime(this.value)) return true;\n    if (this.min && isClockTime(this.min) && this.value < this.min) return true;\n    if (this.max && isClockTime(this.max) && this.value > this.max) return true;\n    return !isClockTimeStepAligned(this.value, this.step, this.min);\n  }\n\n  private get isInvalid(): boolean {\n    return (\n      this.error ||\n      (!this.formInactive &&\n        ((this.required && this.value.length === 0) || this.hasConstraintError))\n    );\n  }\n\n  componentWillLoad() {\n    this.initialValue = this.value;\n    this.syncFormValue();\n  }\n\n  disconnectedCallback() {\n    this.teardownListeners();\n    this.open = false;\n    this.shouldRender = false;\n    this.closing = false;\n    this.positionReady = false;\n    this.focused = false;\n  }\n\n  @Watch('hourFormat')\n  onHourFormatChange() {\n    this.draftText = this.displayValue;\n  }\n\n  @Watch('value')\n  @Watch('required')\n  @Watch('requiredMessage')\n  @Watch('min')\n  @Watch('max')\n  @Watch('step')\n  syncFormValue() {\n    const inactive = this.formInactive;\n    setFormControlValue(this.internals, this.value, { inactive });\n    const flags: ValidityStateFlags = {};\n    let message = '';\n    if (!inactive) {\n      if (this.required && this.value.length === 0) {\n        flags.valueMissing = true;\n        message = this.requiredMessage;\n      } else if (this.value && !isClockTime(this.value)) {\n        flags.badInput = true;\n        message = INVALID_TIME_MESSAGE;\n      } else if (this.value && this.min && isClockTime(this.min) && this.value < this.min) {\n        flags.rangeUnderflow = true;\n        message = TIME_BEFORE_MIN_MESSAGE;\n      } else if (this.value && this.max && isClockTime(this.max) && this.value > this.max) {\n        flags.rangeOverflow = true;\n        message = TIME_AFTER_MAX_MESSAGE;\n      } else if (this.value && !isClockTimeStepAligned(this.value, this.step, this.min)) {\n        flags.stepMismatch = true;\n        message = TIME_STEP_MESSAGE;\n      }\n    }\n    this.internals.setValidity(flags, message);\n  }\n\n  @Watch('disabled')\n  @Watch('isInactive')\n  @Watch('readOnly')\n  onInteractionStateChange() {\n    this.syncFormValue();\n    if (this.pickerInactive && this.shouldRender) this.closePicker(false);\n  }\n\n  formDisabledCallback(disabled: boolean) {\n    this.formDisabled = disabled;\n    this.onInteractionStateChange();\n  }\n\n  formResetCallback() {\n    this.value = this.initialValue;\n    this.draftText = this.displayValue;\n  }\n\n  formStateRestoreCallback(state: string | File | FormData | null) {\n    this.value = restoreStringFormState(state);\n    this.draftText = this.displayValue;\n  }\n\n  @Method()\n  async setFocus() {\n    this.inputEl?.focus();\n  }\n\n  @Listen('keydown')\n  handleHostKeyDown(event: KeyboardEvent) {\n    if (!this.shouldRender || this.closing) return;\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      this.closePicker('button');\n      return;\n    }\n    if (event.key !== 'Tab') return;\n    const popup = this.el.querySelector<HTMLElement>('.input-time-popup');\n    if (!popup || !event.composedPath().includes(popup)) return;\n    if (!this.interaction.tabLeavesPopup(event)) return;\n    event.preventDefault();\n    this.closePicker(false);\n    this.interaction.moveFocusAfterTab(event.shiftKey);\n  }\n\n  private get displayValue(): string {\n    return this.hourFormat === '24' ? this.value : formatClockTimeLabel(this.value);\n  }\n\n  private parseDraft(text: string): string | null {\n    const trimmed = text.trim();\n    if (!trimmed) return '';\n    const iso = parseLooseClockTime(trimmed);\n    if (!iso) return null;\n    if (this.min && isClockTime(this.min) && iso < this.min) return null;\n    if (this.max && isClockTime(this.max) && iso > this.max) return null;\n    if (!isClockTimeStepAligned(iso, this.step, this.min)) return null;\n    return iso;\n  }\n\n  private commitIso(iso: string, emit = true) {\n    if (this.value !== iso) {\n      this.value = iso;\n      if (emit) this.dsChange.emit(iso);\n    }\n    this.draftText = this.hourFormat === '24' ? iso : formatClockTimeLabel(iso);\n  }\n\n  private teardownListeners() {\n    this.position.unobserve();\n    this.interaction.disconnect();\n    if (this.closeTimer) {\n      clearTimeout(this.closeTimer);\n      this.closeTimer = null;\n    }\n  }\n\n  private openPicker() {\n    const inactive = this.isInactive || this.disabled || this.formDisabled || this.readOnly;\n    if (inactive || this.open || !this.el.isConnected) return;\n    this.shouldRender = true;\n    this.closing = false;\n    this.positionReady = false;\n    this.open = true;\n    this.teardownListeners();\n    this.interaction.connect();\n    this.position.observe();\n    this.position.schedule();\n  }\n\n  private closePicker(restore: 'input' | 'button' | false) {\n    if (!this.shouldRender || this.closing) return;\n    this.open = false;\n    this.position.cancel();\n    this.closing = true;\n    this.interaction.disconnect();\n    this.position.unobserve();\n    if (restore === 'input') this.inputEl?.focus();\n    if (restore === 'button') void this.clockButton?.setFocus();\n    const duration = resolveMotionTimeMs(\n      TOKEN_DEFAULTS.motionShort2,\n      TOKEN_DEFAULTS.animationDurationShort3\n    );\n    if (duration <= 0) {\n      this.finishClose();\n      return;\n    }\n    this.closeTimer = setTimeout(() => this.finishClose(), duration);\n  }\n\n  private finishClose() {\n    const popup = this.el.querySelector<HTMLElement>('.input-time-popup');\n    if (popup?.matches(':popover-open')) popup.hidePopover();\n    this.shouldRender = false;\n    this.closing = false;\n    this.closeTimer = null;\n  }\n\n  private togglePicker = () => {\n    if (this.isInactive || this.disabled || this.formDisabled || this.readOnly) return;\n    if (this.open) this.closePicker('button');\n    else this.openPicker();\n  };\n\n  private handleInput = (event: Event) => {\n    if (this.pickerInactive) return;\n    this.draftText = (event.target as HTMLInputElement).value;\n    const parsed = this.parseDraft(this.draftText);\n    if (parsed === null) return;\n    this.commitIso(parsed);\n  };\n\n  private handleFocus = () => {\n    this.draftText = this.displayValue || this.value;\n    this.focused = true;\n  };\n\n  private handleBlur = () => {\n    this.focused = false;\n    this.touched = true;\n    if (this.pickerInactive) {\n      this.draftText = this.displayValue;\n      return;\n    }\n    const parsed = this.parseDraft(this.draftText);\n    if (parsed === null) {\n      this.draftText = this.displayValue;\n      return;\n    }\n    this.commitIso(parsed);\n  };\n\n  private handleTimeChange = (event: CustomEvent<string>) => {\n    event.stopPropagation();\n    if (this.pickerInactive) return;\n    const parsed = this.parseDraft(event.detail);\n    if (parsed === null) return;\n    this.commitIso(parsed);\n  };\n\n  render() {\n    const inputId = this.inputId ?? this.generatedId;\n    const inactive = this.formInactive;\n    const pickerInactive = this.pickerInactive;\n    const filled = this.value.length > 0;\n    const dirty = this.value !== this.initialValue;\n    const showError = this.error && Boolean(this.errorMessage);\n    const textVariant = CONTROL_TEXT_VARIANT[this.size];\n    const textClass = `ds-text--${textVariant.replace('text-', '')}`;\n    const describedBy =\n      [this.ariaDescribedby, showError ? this.errorId : undefined].filter(Boolean).join(' ') ||\n      undefined;\n    const popupStyle = {\n      position: 'fixed',\n      left: '0',\n      top: '0',\n      transform: `translate(${Math.round(this.pos.x)}px, ${Math.round(this.pos.y)}px)`,\n      zIndex: 'var(--dimension-z-index-floating)',\n      visibility: this.positionReady ? 'visible' : 'hidden',\n    };\n\n    return (\n      <Host\n        class={{\n          'input-host': true,\n          'ds-field-stack': true,\n          'ds-field-stack--supporting-inset': !this.hasBorder,\n          'ds-control-inactive': inactive,\n          [`ds-control--${this.size}`]: true,\n          ...controlWidthClass(this.width),\n        }}\n        data-disabled={inactive ? '' : undefined}\n        data-readonly={this.readOnly ? '' : undefined}\n        data-required={this.required ? '' : undefined}\n        data-invalid={this.isInvalid ? '' : undefined}\n        data-filled={filled ? '' : undefined}\n        data-focused={this.focused ? '' : undefined}\n        data-dirty={dirty ? '' : undefined}\n        data-touched={this.touched ? '' : undefined}\n      >\n        <div\n          ref={element => {\n            this.controlEl = element;\n          }}\n          class={{\n            'input-control': true,\n            'ds-control-frame': true,\n            'input-control--bordered': this.hasBorder,\n            'input-control--error': this.hasBorder && this.error,\n            'ds-interaction-fill': this.hasInteractionFill,\n            [`ds-control--${this.size}`]: true,\n          }}\n        >\n          <input\n            ref={element => {\n              this.inputEl = element;\n            }}\n            type=\"text\"\n            id={inputId}\n            value={this.focused ? this.draftText : this.displayValue}\n            disabled={inactive}\n            readOnly={this.readOnly}\n            required={this.required}\n            autoFocus={this.autoFocus}\n            autoComplete=\"off\"\n            spellcheck={false}\n            class={{\n              'native-input': true,\n              'native-input--align-start': true,\n              'ds-control-label-box': true,\n              [textClass]: true,\n              'ds-text--regular': true,\n            }}\n            aria-label={this.ariaLabel}\n            aria-labelledby={this.ariaLabelledby}\n            aria-describedby={describedBy}\n            aria-invalid={this.isInvalid ? 'true' : undefined}\n            onInput={this.handleInput}\n            onFocus={this.handleFocus}\n            onBlur={this.handleBlur}\n          />\n          <ds-button-unfilled\n            ref={element => {\n              this.clockButton = element as HTMLDsButtonUnfilledElement | undefined;\n            }}\n            class=\"input-control__datetime-action\"\n            variant=\"icon\"\n            size={this.size}\n            icon=\"Clock\"\n            hasBorder={false}\n            isInset\n            isInactive={pickerInactive}\n            ariaLabel=\"Choose time\"\n            haspopup=\"dialog\"\n            expanded={this.open}\n            surfaceOpen={this.open || this.closing}\n            controls={this.open ? this.popupId : undefined}\n            onDsClick={this.togglePicker}\n          />\n        </div>\n        {this.shouldRender ? (\n          <div\n            id={this.popupId}\n            popover=\"manual\"\n            class={{\n              'input-time-popup': true,\n              'ds-choice-popup': true,\n              'ds-choice-popup--closing': this.closing,\n              'ds-chrome-column': true,\n              'ds-chrome-space--sm': true,\n            }}\n            style={popupStyle}\n            role=\"dialog\"\n            aria-label=\"Choose time\"\n          >\n            <ds-time-picker\n              hourFormat={this.hourFormat}\n              value={this.value}\n              min={this.min}\n              max={this.max}\n              step={this.step}\n              isInactive={pickerInactive}\n              autoFocus\n              onDsChange={this.handleTimeChange}\n            />\n          </div>\n        ) : null}\n        {showError && (\n          <ds-text\n            class=\"error-text\"\n            as=\"div\"\n            variant=\"text-body-small\"\n            color=\"negative\"\n            textId={this.errorId}\n            role=\"alert\"\n          >\n            {this.errorMessage}\n          </ds-text>\n        )}\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

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

@@ -160,7 +160,7 @@
     },
     {
       "path": "src/wc/components/Markdown/Markdown.tsx",
-      "content": "import { Component, h, Host, Prop, State, VNode, Watch } from '@stencil/core';\nimport type { Nodes, Root } from 'mdast';\nimport { resolveSafeUrl } from '../../utils';\n\ntype MarkdownRender = VNode | string | null | MarkdownRender[];\ntype MarkdownParser = {\n  fromMarkdown: typeof import('mdast-util-from-markdown').fromMarkdown;\n  gfmFromMarkdown: typeof import('mdast-util-gfm').gfmFromMarkdown;\n  gfm: typeof import('micromark-extension-gfm').gfm;\n};\n\nlet parserPromise: Promise<MarkdownParser> | undefined;\n\nfunction loadParser(): Promise<MarkdownParser> {\n  parserPromise ??= Promise.all([\n    import('mdast-util-from-markdown'),\n    import('mdast-util-gfm'),\n    import('micromark-extension-gfm'),\n  ]).then(([fromMarkdownModule, gfmFromMarkdownModule, gfmModule]) => ({\n    fromMarkdown: fromMarkdownModule.fromMarkdown,\n    gfmFromMarkdown: gfmFromMarkdownModule.gfmFromMarkdown,\n    gfm: gfmModule.gfm,\n  }));\n  return parserPromise;\n}\n\n@Component({\n  tag: 'ds-markdown',\n  styleUrl: 'Markdown.css',\n  scoped: true,\n})\nexport class Markdown {\n  @Prop() content: string = '';\n  @Prop() streaming: boolean = false;\n\n  @State() private tree: Root | null = null;\n  private parseFrame?: number;\n  private parseRevision = 0;\n\n  componentWillLoad() {\n    // The browser-targeted named-character decoder used by the Markdown parser\n    // creates a DOM element when its module is evaluated. Keep public package\n    // imports server-safe by loading that parser only in a browser context.\n    if (typeof document !== 'undefined') return this.parse();\n  }\n\n  disconnectedCallback() {\n    this.parseRevision += 1;\n    if (this.parseFrame && typeof cancelAnimationFrame === 'function') {\n      cancelAnimationFrame(this.parseFrame);\n    }\n  }\n\n  @Watch('content')\n  scheduleParse() {\n    if (typeof requestAnimationFrame !== 'function') return;\n    if (this.parseFrame) cancelAnimationFrame(this.parseFrame);\n    this.parseFrame = requestAnimationFrame(() => {\n      this.parseFrame = undefined;\n      void this.parse();\n    });\n  }\n\n  private async parse() {\n    const revision = ++this.parseRevision;\n    try {\n      const { fromMarkdown, gfmFromMarkdown, gfm } = await loadParser();\n      const tree = fromMarkdown(this.content, {\n        extensions: [gfm()],\n        mdastExtensions: [gfmFromMarkdown()],\n      });\n      if (revision === this.parseRevision) this.tree = tree;\n    } catch {\n      if (revision === this.parseRevision) this.tree = null;\n    }\n  }\n\n  private children(node: Nodes): MarkdownRender[] {\n    if (!('children' in node)) return [];\n    return node.children.map(child => this.renderNode(child));\n  }\n\n  private renderNode(node: Nodes): MarkdownRender {\n    switch (node.type) {\n      case 'root':\n        return this.children(node);\n      case 'text':\n        // Keep prose text on an element boundary. Besides giving streaming updates a\n        // stable render target, this avoids axe-core treating a bare Stencil text\n        // vnode as an element while it generates a contrast-result selector.\n        return <span class=\"markdown__text\">{node.value}</span>;\n      case 'paragraph':\n        return <p class=\"markdown__paragraph\">{this.children(node)}</p>;\n      case 'heading': {\n        const Tag = `h${node.depth}`;\n        return <Tag class=\"markdown__heading\">{this.children(node)}</Tag>;\n      }\n      case 'strong':\n        return <strong class=\"markdown__strong\">{this.children(node)}</strong>;\n      case 'emphasis':\n        return <em class=\"markdown__emphasis\">{this.children(node)}</em>;\n      case 'delete':\n        return <del class=\"markdown__delete\">{this.children(node)}</del>;\n      case 'blockquote':\n        return <blockquote class=\"markdown__blockquote\">{this.children(node)}</blockquote>;\n      case 'break':\n        return <br class=\"markdown__break\" />;\n      case 'thematicBreak':\n        return <hr class=\"markdown__thematic-break\" />;\n      case 'inlineCode':\n        return <code class=\"markdown__inline-code\">{node.value}</code>;\n      case 'code':\n        return (\n          <ds-code-block\n            class=\"markdown__code-block\"\n            data-ds-prose=\"off\"\n            code={node.value}\n            language={node.lang ?? ''}\n            filename={node.meta ?? ''}\n          />\n        );\n      case 'link': {\n        const href = resolveSafeUrl(node.url, {\n          protocols: ['http:', 'https:', 'mailto:'],\n        });\n        return href ? (\n          <a class=\"markdown__link\" href={href} target=\"_blank\" rel=\"noopener noreferrer\">\n            {this.children(node)}\n          </a>\n        ) : (\n          this.children(node)\n        );\n      }\n      case 'list': {\n        const Tag = node.ordered ? 'ol' : 'ul';\n        return (\n          <Tag class=\"markdown__list\" start={node.ordered && node.start ? node.start : undefined}>\n            {this.children(node)}\n          </Tag>\n        );\n      }\n      case 'listItem':\n        return (\n          <li class=\"markdown__list-item\">\n            {typeof node.checked === 'boolean' ? (\n              <input\n                class=\"markdown__task-indicator\"\n                type=\"checkbox\"\n                checked={node.checked}\n                disabled\n                aria-hidden=\"true\"\n                tabIndex={-1}\n              />\n            ) : null}\n            {this.children(node)}\n          </li>\n        );\n      case 'table': {\n        const [heading, ...rows] = node.children;\n        return (\n          <div class=\"markdown__table-wrap ds-prose__table-scroll\" tabIndex={0}>\n            <table class=\"markdown__table\">\n              {heading ? (\n                <thead class=\"markdown__table-head\">\n                  <tr class=\"markdown__table-row\">\n                    {heading.children.map(cell => (\n                      <th class=\"markdown__table-heading\" scope=\"col\">\n                        {this.children(cell)}\n                      </th>\n                    ))}\n                  </tr>\n                </thead>\n              ) : null}\n              <tbody class=\"markdown__table-body\">{rows.map(row => this.renderNode(row))}</tbody>\n            </table>\n          </div>\n        );\n      }\n      case 'tableRow':\n        return <tr class=\"markdown__table-row\">{this.children(node)}</tr>;\n      case 'tableCell':\n        return <td class=\"markdown__table-cell\">{this.children(node)}</td>;\n      case 'image': {\n        const href = resolveSafeUrl(node.url, {\n          protocols: ['http:', 'https:', 'mailto:'],\n        });\n        return href ? (\n          <a class=\"markdown__image-link\" href={href} target=\"_blank\" rel=\"noopener noreferrer\">\n            {node.alt || 'View image'}\n          </a>\n        ) : (\n          node.alt || null\n        );\n      }\n      case 'html':\n      case 'definition':\n      case 'footnoteDefinition':\n        return null;\n      case 'footnoteReference':\n        return <sup class=\"markdown__footnote\">{node.label}</sup>;\n      default:\n        return this.children(node);\n    }\n  }\n\n  render() {\n    return (\n      <Host aria-busy={this.streaming ? 'true' : undefined}>\n        <div class=\"markdown ds-prose\">\n          {this.tree ? (\n            this.renderNode(this.tree)\n          ) : (\n            <p class=\"markdown__paragraph\">\n              <span class=\"markdown__text\">{this.content}</span>\n            </p>\n          )}\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { Component, Element, h, Host, Prop, State, VNode, Watch } from '@stencil/core';\nimport type { Nodes, Root } from 'mdast';\nimport { resolveSafeUrl } from '../../utils';\nimport { ConnectionTasks } from '../../utils/connection-tasks';\n\ntype MarkdownRender = VNode | string | null | MarkdownRender[];\ntype MarkdownParser = {\n  fromMarkdown: typeof import('mdast-util-from-markdown').fromMarkdown;\n  gfmFromMarkdown: typeof import('mdast-util-gfm').gfmFromMarkdown;\n  gfm: typeof import('micromark-extension-gfm').gfm;\n};\n\nlet parserPromise: Promise<MarkdownParser> | undefined;\n\nfunction loadParser(): Promise<MarkdownParser> {\n  parserPromise ??= Promise.all([\n    import('mdast-util-from-markdown'),\n    import('mdast-util-gfm'),\n    import('micromark-extension-gfm'),\n  ]).then(([fromMarkdownModule, gfmFromMarkdownModule, gfmModule]) => ({\n    fromMarkdown: fromMarkdownModule.fromMarkdown,\n    gfmFromMarkdown: gfmFromMarkdownModule.gfmFromMarkdown,\n    gfm: gfmModule.gfm,\n  }));\n  return parserPromise;\n}\n\n@Component({\n  tag: 'ds-markdown',\n  styleUrl: 'Markdown.css',\n  scoped: true,\n})\nexport class Markdown {\n  @Element() el!: HTMLElement;\n\n  @Prop() content: string = '';\n  @Prop() streaming: boolean = false;\n\n  @State() private tree: Root | null = null;\n  private parseFrame?: number;\n  private parseRevision = 0;\n  private initialized = false;\n  private readonly tasks = new ConnectionTasks(() => this.el.isConnected);\n\n  connectedCallback() {\n    if (this.initialized) this.scheduleParse();\n  }\n\n  componentWillLoad() {\n    this.initialized = true;\n    // Keep the parser lazy so importing public package entries does not load\n    // the Markdown grammar before a browser actually renders Markdown.\n    if (typeof document !== 'undefined') return this.parse();\n  }\n\n  disconnectedCallback() {\n    this.parseRevision += 1;\n    this.tasks.cancel();\n    this.parseFrame = undefined;\n  }\n\n  @Watch('content')\n  scheduleParse() {\n    this.parseRevision += 1;\n    if (typeof requestAnimationFrame !== 'function') return;\n    this.tasks.cancelFrame(this.parseFrame);\n    this.parseFrame = this.tasks.frame(() => {\n      this.parseFrame = undefined;\n      void this.parse();\n    });\n  }\n\n  private async parse() {\n    const revision = ++this.parseRevision;\n    try {\n      const { fromMarkdown, gfmFromMarkdown, gfm } = await loadParser();\n      if (revision !== this.parseRevision || !this.el.isConnected) return;\n      const tree = fromMarkdown(this.content, {\n        extensions: [gfm()],\n        mdastExtensions: [gfmFromMarkdown()],\n      });\n      if (revision === this.parseRevision) this.tree = tree;\n    } catch {\n      if (revision === this.parseRevision && this.el.isConnected) this.tree = null;\n    }\n  }\n\n  private children(node: Nodes): MarkdownRender[] {\n    if (!('children' in node)) return [];\n    return node.children.map(child => this.renderNode(child));\n  }\n\n  private renderNode(node: Nodes): MarkdownRender {\n    switch (node.type) {\n      case 'root':\n        return this.children(node);\n      case 'text':\n        // Keep prose text on an element boundary. Besides giving streaming updates a\n        // stable render target, this avoids axe-core treating a bare Stencil text\n        // vnode as an element while it generates a contrast-result selector.\n        return <span class=\"markdown__text\">{node.value}</span>;\n      case 'paragraph':\n        return <p class=\"markdown__paragraph\">{this.children(node)}</p>;\n      case 'heading': {\n        const Tag = `h${node.depth}`;\n        return <Tag class=\"markdown__heading\">{this.children(node)}</Tag>;\n      }\n      case 'strong':\n        return <strong class=\"markdown__strong\">{this.children(node)}</strong>;\n      case 'emphasis':\n        return <em class=\"markdown__emphasis\">{this.children(node)}</em>;\n      case 'delete':\n        return <del class=\"markdown__delete\">{this.children(node)}</del>;\n      case 'blockquote':\n        return <blockquote class=\"markdown__blockquote\">{this.children(node)}</blockquote>;\n      case 'break':\n        return <br class=\"markdown__break\" />;\n      case 'thematicBreak':\n        return <hr class=\"markdown__thematic-break\" />;\n      case 'inlineCode':\n        return <code class=\"markdown__inline-code\">{node.value}</code>;\n      case 'code':\n        return (\n          <ds-code-block\n            class=\"markdown__code-block\"\n            data-ds-prose=\"off\"\n            code={node.value}\n            language={node.lang ?? ''}\n            filename={node.meta ?? ''}\n          />\n        );\n      case 'link': {\n        const href = resolveSafeUrl(node.url, {\n          protocols: ['http:', 'https:', 'mailto:'],\n        });\n        return href ? (\n          <a class=\"markdown__link\" href={href} target=\"_blank\" rel=\"noopener noreferrer\">\n            {this.children(node)}\n          </a>\n        ) : (\n          this.children(node)\n        );\n      }\n      case 'list': {\n        const Tag = node.ordered ? 'ol' : 'ul';\n        return (\n          <Tag class=\"markdown__list\" start={node.ordered && node.start ? node.start : undefined}>\n            {this.children(node)}\n          </Tag>\n        );\n      }\n      case 'listItem':\n        return (\n          <li class=\"markdown__list-item\">\n            {typeof node.checked === 'boolean' ? (\n              <input\n                class=\"markdown__task-indicator\"\n                type=\"checkbox\"\n                checked={node.checked}\n                disabled\n                aria-hidden=\"true\"\n                tabIndex={-1}\n              />\n            ) : null}\n            {this.children(node)}\n          </li>\n        );\n      case 'table': {\n        const [heading, ...rows] = node.children;\n        return (\n          <div class=\"markdown__table-wrap ds-prose__table-scroll\" tabIndex={0}>\n            <table class=\"markdown__table\">\n              {heading ? (\n                <thead class=\"markdown__table-head\">\n                  <tr class=\"markdown__table-row\">\n                    {heading.children.map(cell => (\n                      <th class=\"markdown__table-heading\" scope=\"col\">\n                        {this.children(cell)}\n                      </th>\n                    ))}\n                  </tr>\n                </thead>\n              ) : null}\n              <tbody class=\"markdown__table-body\">{rows.map(row => this.renderNode(row))}</tbody>\n            </table>\n          </div>\n        );\n      }\n      case 'tableRow':\n        return <tr class=\"markdown__table-row\">{this.children(node)}</tr>;\n      case 'tableCell':\n        return <td class=\"markdown__table-cell\">{this.children(node)}</td>;\n      case 'image': {\n        const href = resolveSafeUrl(node.url, {\n          protocols: ['http:', 'https:', 'mailto:'],\n        });\n        return href ? (\n          <a class=\"markdown__image-link\" href={href} target=\"_blank\" rel=\"noopener noreferrer\">\n            {node.alt || 'View image'}\n          </a>\n        ) : (\n          node.alt || null\n        );\n      }\n      case 'html':\n      case 'definition':\n      case 'footnoteDefinition':\n        return null;\n      case 'footnoteReference':\n        return <sup class=\"markdown__footnote\">{node.label}</sup>;\n      default:\n        return this.children(node);\n    }\n  }\n\n  render() {\n    return (\n      <Host aria-busy={this.streaming ? 'true' : undefined}>\n        <div class=\"markdown ds-prose\">\n          {this.tree ? (\n            this.renderNode(this.tree)\n          ) : (\n            <p class=\"markdown__paragraph\">\n              <span class=\"markdown__text\">{this.content}</span>\n            </p>\n          )}\n        </div>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

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

@@ -591,7 +591,7 @@
     },
     {
       "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 { 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 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    if (this.open) this.onOpenChange(true);\n  }\n\n  disconnectedCallback() {\n    this.cancelPositionRetry();\n    this.cancelLivePositionUpdate();\n    this.clearReorderPointer();\n    this.teardownListeners();\n  }\n\n  @Watch('open')\n  onOpenChange(isOpen: boolean) {\n    if (this.embedded) 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) {\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    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) 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      requestAnimationFrame(() => {\n        if (this.open) this.el.querySelector<HTMLElement>('.menu-popup')?.focus();\n      });\n      return;\n    }\n    if (this.hasCompositeSections) {\n      requestAnimationFrame(() => {\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    requestAnimationFrame(() => {\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.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    queueMicrotask(() => {\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    queueMicrotask(() => {\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 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",
       "type": "registry:ui"
     },
     {

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

@@ -34,7 +34,7 @@
         "Hover-only metadata rows remain keyboard reachable, reveal on focus, and stay visible for touch and coarse-pointer input."
       ],
       "states": [
-        "Pass an ISO timestamp. Message keeps the full value in dateTime and formats the visible value as a localized time; applications must not render a raw ISO string as visible transcript metadata.",
+        "Pass an ISO timestamp. Message keeps the full value in dateTime and formats the visible value in English using the viewer’s local time zone; applications must not render a raw ISO string as visible transcript metadata.",
         "A visible incoming author uses body-small emphasis with primary foreground; timestamp and delivery metadata remain caption text.",
         "Visible author, bubble content, and timestamp or delivery footer use consistent 4px vertical gaps.",
         "Grouping joins adjacent bubble corners, shows the incoming author only at the start, and shows delivery/time metadata only at the end. Outgoing author remains in the accessible message label without repeating a visible You label.",
@@ -138,7 +138,7 @@
           "default": "''",
           "required": false,
           "mutable": false,
-          "description": "ISO timestamp."
+          "description": "ISO timestamp. Displayed in English using the viewer’s local time zone."
         }
       },
       "events": [],
@@ -226,7 +226,7 @@
         "default": "''",
         "required": false,
         "mutable": false,
-        "description": "ISO timestamp."
+        "description": "ISO timestamp. Displayed in English using the viewer’s local time zone."
       }
     },
     "events": [],
@@ -281,7 +281,7 @@
     },
     {
       "path": "src/wc/components/Message/Message.tsx",
-      "content": "import { Component, h, Host, Prop } from '@stencil/core';\nimport type {\n  MessageDeliveryState,\n  MessageDirection,\n  MessageGroupPosition,\n  MessageMetadataVisibility,\n} from '../conversation-types';\n\nconst DELIVERY_LABELS: Record<MessageDeliveryState, string> = {\n  sending: 'Sending',\n  sent: 'Sent',\n  delivered: 'Delivered',\n  read: 'Read',\n  failed: 'Failed to send',\n};\n\n@Component({\n  tag: 'ds-message',\n  styleUrl: 'Message.css',\n  scoped: true,\n})\nexport class Message {\n  @Prop({ reflect: true }) messageId: string = '';\n  @Prop({ reflect: true }) direction: MessageDirection = 'incoming';\n  @Prop() groupPosition: MessageGroupPosition = 'single';\n  @Prop() author: string = '';\n  /** Keep author semantics while allowing products with self-evident roles to hide the visible label. */\n  @Prop() showAuthor: boolean = true;\n  /** ISO timestamp. */\n  @Prop() timestamp: string = '';\n  @Prop() deliveryState: MessageDeliveryState | undefined;\n  @Prop() streaming: boolean = false;\n  /** Controls whether the complete metadata footer is persistent or revealed through hover/focus. */\n  @Prop() metadataVisibility: MessageMetadataVisibility = 'always';\n  @Prop({ reflect: true }) scrollAnchor: boolean = false;\n\n  private formattedTimestamp(): string {\n    if (!this.timestamp) return '';\n    const parsed = Date.parse(this.timestamp);\n    if (Number.isNaN(parsed)) return this.timestamp;\n    return new Intl.DateTimeFormat(undefined, {\n      hour: 'numeric',\n      minute: '2-digit',\n    }).format(new Date(parsed));\n  }\n\n  private renderMetadataActions() {\n    return (\n      <div class=\"message__metadata-actions\">\n        <slot name=\"metadata-actions\" />\n      </div>\n    );\n  }\n\n  render() {\n    const delivery = this.deliveryState ? DELIVERY_LABELS[this.deliveryState] : '';\n    const formattedTimestamp = this.formattedTimestamp();\n    return (\n      <Host\n        class={`message-host--group-${this.groupPosition}`}\n        data-message-id={this.messageId || undefined}\n        data-scroll-anchor={this.scrollAnchor ? 'true' : undefined}\n        aria-busy={this.streaming ? 'true' : undefined}\n      >\n        <article\n          class={{\n            message: true,\n            [`message--${this.direction}`]: true,\n            [`message--group-${this.groupPosition}`]: true,\n            [`message--metadata-${this.metadataVisibility}`]: true,\n          }}\n          aria-label={this.author ? `Message from ${this.author}` : 'Message'}\n        >\n          <div class=\"message__body\">\n            <div class=\"message__header\">\n              <slot name=\"header\" />\n              {this.author && this.showAuthor ? (\n                <ds-text as=\"span\" variant=\"text-body-small\" emphasis color=\"primary\">\n                  {this.author}\n                </ds-text>\n              ) : null}\n            </div>\n            <div class=\"message__content\">\n              <slot />\n            </div>\n            <div class=\"message__footer\">\n              {this.direction === 'incoming' ? this.renderMetadataActions() : null}\n              <slot name=\"footer\" />\n              {delivery ? (\n                <ds-text\n                  as=\"span\"\n                  variant=\"text-caption\"\n                  color={this.deliveryState === 'failed' ? 'negative' : 'secondary'}\n                >\n                  {delivery}\n                </ds-text>\n              ) : null}\n              {this.deliveryState === 'failed' && formattedTimestamp ? (\n                <ds-text as=\"span\" variant=\"text-caption\" color=\"tertiary\" aria-hidden=\"true\">\n                  ·\n                </ds-text>\n              ) : null}\n              {formattedTimestamp ? (\n                <time dateTime={this.timestamp}>\n                  <ds-text as=\"span\" variant=\"text-caption\" color=\"secondary\">\n                    {formattedTimestamp}\n                  </ds-text>\n                </time>\n              ) : null}\n              {this.direction !== 'incoming' ? this.renderMetadataActions() : null}\n            </div>\n          </div>\n          <div class=\"message__actions\">\n            <slot name=\"actions\" />\n          </div>\n        </article>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { dateFormatter } from '../../utils/intl-formatters';\nimport { Component, h, Host, Prop } from '@stencil/core';\nimport type {\n  MessageDeliveryState,\n  MessageDirection,\n  MessageGroupPosition,\n  MessageMetadataVisibility,\n} from '../conversation-types';\n\nconst DELIVERY_LABELS: Record<MessageDeliveryState, string> = {\n  sending: 'Sending',\n  sent: 'Sent',\n  delivered: 'Delivered',\n  read: 'Read',\n  failed: 'Failed to send',\n};\n\n@Component({\n  tag: 'ds-message',\n  styleUrl: 'Message.css',\n  scoped: true,\n})\nexport class Message {\n  @Prop({ reflect: true }) messageId: string = '';\n  @Prop({ reflect: true }) direction: MessageDirection = 'incoming';\n  @Prop() groupPosition: MessageGroupPosition = 'single';\n  @Prop() author: string = '';\n  /** Keep author semantics while allowing products with self-evident roles to hide the visible label. */\n  @Prop() showAuthor: boolean = true;\n  /** ISO timestamp. Displayed in English using the viewer’s local time zone. */\n  @Prop() timestamp: string = '';\n  @Prop() deliveryState: MessageDeliveryState | undefined;\n  @Prop() streaming: boolean = false;\n  /** Controls whether the complete metadata footer is persistent or revealed through hover/focus. */\n  @Prop() metadataVisibility: MessageMetadataVisibility = 'always';\n  @Prop({ reflect: true }) scrollAnchor: boolean = false;\n\n  private formattedTimestamp(): string {\n    if (!this.timestamp) return '';\n    const parsed = Date.parse(this.timestamp);\n    if (Number.isNaN(parsed)) return this.timestamp;\n    return dateFormatter(undefined, {\n      hour: 'numeric',\n      minute: '2-digit',\n    }).format(new Date(parsed));\n  }\n\n  private renderMetadataActions() {\n    return (\n      <div class=\"message__metadata-actions\">\n        <slot name=\"metadata-actions\" />\n      </div>\n    );\n  }\n\n  render() {\n    const delivery = this.deliveryState ? DELIVERY_LABELS[this.deliveryState] : '';\n    const formattedTimestamp = this.formattedTimestamp();\n    return (\n      <Host\n        class={`message-host--group-${this.groupPosition}`}\n        data-message-id={this.messageId || undefined}\n        data-scroll-anchor={this.scrollAnchor ? 'true' : undefined}\n        aria-busy={this.streaming ? 'true' : undefined}\n      >\n        <article\n          class={{\n            message: true,\n            [`message--${this.direction}`]: true,\n            [`message--group-${this.groupPosition}`]: true,\n            [`message--metadata-${this.metadataVisibility}`]: true,\n          }}\n          aria-label={this.author ? `Message from ${this.author}` : 'Message'}\n        >\n          <div class=\"message__body\">\n            <div class=\"message__header\">\n              <slot name=\"header\" />\n              {this.author && this.showAuthor ? (\n                <ds-text as=\"span\" variant=\"text-body-small\" emphasis color=\"primary\">\n                  {this.author}\n                </ds-text>\n              ) : null}\n            </div>\n            <div class=\"message__content\">\n              <slot />\n            </div>\n            <div class=\"message__footer\">\n              {this.direction === 'incoming' ? this.renderMetadataActions() : null}\n              <slot name=\"footer\" />\n              {delivery ? (\n                <ds-text\n                  as=\"span\"\n                  variant=\"text-caption\"\n                  color={this.deliveryState === 'failed' ? 'negative' : 'secondary'}\n                >\n                  {delivery}\n                </ds-text>\n              ) : null}\n              {this.deliveryState === 'failed' && formattedTimestamp ? (\n                <ds-text as=\"span\" variant=\"text-caption\" color=\"tertiary\" aria-hidden=\"true\">\n                  ·\n                </ds-text>\n              ) : null}\n              {formattedTimestamp ? (\n                <time dateTime={this.timestamp}>\n                  <ds-text as=\"span\" variant=\"text-caption\" color=\"secondary\">\n                    {formattedTimestamp}\n                  </ds-text>\n                </time>\n              ) : null}\n              {this.direction !== 'incoming' ? this.renderMetadataActions() : null}\n            </div>\n          </div>\n          <div class=\"message__actions\">\n            <slot name=\"actions\" />\n          </div>\n        </article>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

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

@@ -251,7 +251,7 @@
     },
     {
       "path": "src/wc/components/MobileSectionSwitcher/MobileSectionSwitcher.tsx",
-      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Prop,\n  State,\n  Watch,\n} from '@stencil/core';\nimport type { MenuItemData, MenuSection } from '../Menu/menu-types';\nimport {\n  getSelectableTabs,\n  isTabDivider,\n  type TabItem,\n  type TabItemTab,\n} from '../TabGroup/tab-item-utils';\nimport { resolveMobileSectionPosition } from './mobile-section-switcher-utils';\nimport { resolveMotionTimeMs, TOKEN_DEFAULTS } from '../../utils';\n\nlet nextMobileSectionSwitcherId = 0;\n\n@Component({\n  tag: 'ds-mobile-section-switcher',\n  styleUrl: 'MobileSectionSwitcher.css',\n  scoped: true,\n})\nexport class MobileSectionSwitcher {\n  @Element() el!: HTMLElement;\n\n  /** Ordered controlled sections. Divider entries group the popup menu. */\n  @Prop() sections: TabItem[] = [];\n  /** Controlled selected section id. */\n  @Prop() value: string = '';\n  /** Accessible name for the section chooser. */\n  @Prop() navigationLabel: string = 'Change page section';\n  /** Anchored local-view menu or viewport-edge sheet for primary page sections. */\n  @Prop() presentation: 'menu' | 'sheet' = 'menu';\n  /** Stable page identity shown before the selected section in a sheet trigger. */\n  @Prop() pageLabel: string = '';\n\n  /** Selection intent. The route, tool, or workflow owner updates `value`. */\n  @Event() dsChange!: EventEmitter<string>;\n\n  @State() private menuOpen = false;\n  @State() private menuSurfaceOpen = false;\n  @State() private initialFocusVisible = false;\n  @State() private pointerFocus = false;\n  @State() private sheetClosing = false;\n  @State() private focusedSection = '';\n\n  private readonly instanceId = nextMobileSectionSwitcherId++;\n  private readonly triggerId = `ds-mobile-section-switcher-trigger-${this.instanceId}`;\n  private readonly menuId = `ds-mobile-section-switcher-menu-${this.instanceId}`;\n  private triggerEl: HTMLButtonElement | null = null;\n  private dialogEl: HTMLDialogElement | null = null;\n  private browserEdgeEl: HTMLDivElement | null = null;\n  private browserEdgeColors = '';\n  private themeObserver?: MutationObserver;\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  private visibilityObserver?: ResizeObserver;\n\n  private readonly handleDocumentKeyDown = (event: KeyboardEvent) => {\n    if (['Shift', 'Control', 'Alt', 'Meta'].includes(event.key)) return;\n    this.pointerFocus = false;\n  };\n\n  componentDidLoad() {\n    this.el.ownerDocument.addEventListener('keydown', this.handleDocumentKeyDown, true);\n    this.visibilityObserver = new ResizeObserver(() => {\n      if (this.dialogEl?.open && !this.triggerEl?.getClientRects().length) {\n        this.finishSheetClose(false);\n      }\n    });\n    this.visibilityObserver.observe(this.el);\n  }\n\n  componentDidRender() {\n    if (!this.dialogEl) return;\n    if (this.presentation === 'sheet' && this.menuOpen && !this.dialogEl.open) {\n      const initialSection = this.focusedSection;\n      this.updateBrowserEdgeColor();\n      this.observeBrowserEdgeTheme();\n      this.dialogEl.showModal();\n      this.focusSheetItem(initialSection);\n    }\n    if (this.sheetClosing && this.dialogEl.open && !this.closeTimer) {\n      const duration = resolveMotionTimeMs(\n        TOKEN_DEFAULTS.motionShort2,\n        TOKEN_DEFAULTS.animationDurationShort3\n      );\n      if (!duration) this.finishSheetClose();\n      else this.closeTimer = setTimeout(() => this.finishSheetClose(), duration);\n    }\n  }\n\n  disconnectedCallback() {\n    this.el.ownerDocument.removeEventListener('keydown', this.handleDocumentKeyDown, true);\n    this.visibilityObserver?.disconnect();\n    this.menuSurfaceOpen = false;\n    this.finishSheetClose(false);\n  }\n\n  @Watch('presentation')\n  handlePresentationChange() {\n    this.menuSurfaceOpen = false;\n    this.closeMenu();\n  }\n\n  @Watch('value')\n  @Watch('pageLabel')\n  handleContextChange() {\n    this.closeMenu();\n  }\n\n  private finishSheetClose(restoreFocus = true) {\n    if (this.closeTimer) clearTimeout(this.closeTimer);\n    this.closeTimer = null;\n    const wasOpen = this.dialogEl?.open;\n    this.dialogEl?.close();\n    this.themeObserver?.disconnect();\n    this.menuOpen = false;\n    this.sheetClosing = false;\n    if (wasOpen && restoreFocus && this.triggerEl?.getClientRects().length) this.triggerEl.focus();\n  }\n\n  private updateBrowserEdgeColor = () => {\n    if (!this.browserEdgeEl || !this.dialogEl) return;\n    const base = getComputedStyle(this.browserEdgeEl).color;\n    const shade = getComputedStyle(this.dialogEl, '::backdrop').backgroundColor;\n    const colors = `${base}|${shade}`;\n    if (colors === this.browserEdgeColors) return;\n    // Let the browser resolve token colors, including alpha and non-sRGB syntax,\n    // then flatten the shade over the bar into the opaque color Safari samples.\n    const canvas = this.el.ownerDocument.createElement('canvas');\n    canvas.width = canvas.height = 1;\n    const context = canvas.getContext('2d');\n    if (!context) return;\n    context.fillStyle = base;\n    context.fillRect(0, 0, 1, 1);\n    context.fillStyle = shade;\n    context.fillRect(0, 0, 1, 1);\n    const [red, green, blue] = context.getImageData(0, 0, 1, 1).data;\n    this.browserEdgeEl.style.setProperty(\n      '--_mobile-section-edge-color',\n      `rgb(${red}, ${green}, ${blue})`\n    );\n    this.browserEdgeColors = colors;\n  };\n\n  private observeBrowserEdgeTheme() {\n    this.themeObserver ??= new MutationObserver(this.updateBrowserEdgeColor);\n    // Token themes are inherited from the page or a containing theme scope.\n    for (let ancestor: HTMLElement | null = this.el; ancestor; ancestor = ancestor.parentElement) {\n      this.themeObserver.observe(ancestor, {\n        attributes: true,\n        attributeFilter: ['class', 'style', 'data-theme'],\n      });\n    }\n  }\n\n  private focusSheetItem(id: string) {\n    const buttons = Array.from(this.dialogEl?.querySelectorAll<HTMLButtonElement>('button') ?? []);\n    const button =\n      buttons.find(item => item.value === id && !item.disabled) ??\n      buttons.find(item => !item.disabled);\n    if (button) {\n      this.focusedSection = button.value;\n      button.focus();\n    } else this.dialogEl?.focus();\n  }\n\n  private handleSheetKeyDown = (event: KeyboardEvent) => {\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      event.stopPropagation();\n      this.closeMenu();\n      return;\n    }\n    const sections = this.selectableSections.filter(section => !section.isInactive);\n    if (!sections.length) return;\n    const index = Math.max(\n      0,\n      sections.findIndex(section => section.id === this.focusedSection)\n    );\n    let next: number;\n    if (event.key === 'ArrowDown') next = (index + 1) % sections.length;\n    else if (event.key === 'ArrowUp') next = (index + sections.length - 1) % sections.length;\n    else if (event.key === 'Home') next = 0;\n    else if (event.key === 'End') next = sections.length - 1;\n    else if (event.key === 'Tab') next = index;\n    else if (\n      event.key.length === 1 &&\n      !event.ctrlKey &&\n      !event.metaKey &&\n      !event.altKey &&\n      event.key !== ' '\n    ) {\n      const match = sections.findIndex((_, offset) =>\n        sections[(index + offset + 1) % sections.length].label\n          .toLowerCase()\n          .startsWith(event.key.toLowerCase())\n      );\n      if (match < 0) return;\n      next = (index + match + 1) % sections.length;\n    } else return;\n    event.preventDefault();\n    this.initialFocusVisible = true;\n    this.focusSheetItem(sections[next].id);\n  };\n\n  private get resolvedSections(): TabItem[] {\n    return this.sections ?? [];\n  }\n\n  private get selectableSections(): TabItemTab[] {\n    return getSelectableTabs(this.resolvedSections);\n  }\n\n  private get selectedIndex(): number {\n    return resolveMobileSectionPosition(this.resolvedSections, this.value).selectedIndex;\n  }\n\n  private get selectedSection(): TabItemTab | undefined {\n    return this.selectableSections[this.selectedIndex];\n  }\n\n  private get hasPrevious(): boolean {\n    return resolveMobileSectionPosition(this.resolvedSections, this.value).hasPrevious;\n  }\n\n  private get hasNext(): boolean {\n    return resolveMobileSectionPosition(this.resolvedSections, this.value).hasNext;\n  }\n\n  private get triggerAriaLabel(): string {\n    return `${this.presentation === 'sheet' && this.pageLabel ? `${this.pageLabel}. ` : ''}${this.navigationLabel}. Current section: ${this.selectedSection?.label ?? ''}`;\n  }\n\n  private get menuSections(): MenuSection[] {\n    const groups: MenuSection[] = [];\n    let items: MenuItemData[] = [];\n    const commit = () => {\n      if (items.length) groups.push({ items });\n      items = [];\n    };\n\n    for (const section of this.resolvedSections) {\n      if (isTabDivider(section)) {\n        commit();\n        continue;\n      }\n      items.push({\n        label: section.label,\n        value: section.id,\n        dot: section.dot,\n        isSelected: section.id === this.selectedSection?.id,\n        isInactive: section.isInactive,\n      });\n    }\n    commit();\n    return groups;\n  }\n\n  @Watch('sections')\n  handleSectionsChange() {\n    if (this.selectableSections.length <= 1) {\n      this.closeMenu();\n      this.menuSurfaceOpen = false;\n    } else if (this.dialogEl?.open && !this.sheetClosing) this.focusSheetItem(this.focusedSection);\n  }\n\n  private toggleMenu = (event: MouseEvent) => {\n    if (this.selectableSections.length <= 1) return;\n    this.initialFocusVisible = event.detail === 0;\n    if (this.presentation === 'sheet') {\n      if (this.menuOpen) this.closeMenu();\n      else {\n        this.focusedSection = this.selectedSection?.id ?? '';\n        this.menuOpen = true;\n      }\n      return;\n    }\n    this.menuOpen = !this.menuOpen;\n    if (this.menuOpen) this.menuSurfaceOpen = true;\n  };\n\n  private closeMenu = () => {\n    this.menuOpen = false;\n    if (this.dialogEl?.open) this.sheetClosing = true;\n  };\n\n  private renderSheet() {\n    return (\n      <dialog\n        id={this.menuId}\n        ref={element => {\n          this.dialogEl = element ?? null;\n        }}\n        class={{ 'mobile-section-sheet': true, 'mobile-section-sheet--closing': this.sheetClosing }}\n        aria-label={this.navigationLabel}\n        tabIndex={-1}\n        onCancel={event => {\n          event.preventDefault();\n          this.closeMenu();\n        }}\n        onKeyDown={this.handleSheetKeyDown}\n        onClick={event => {\n          if (!this.dialogEl || event.target !== this.dialogEl) return;\n          const rect = this.dialogEl.getBoundingClientRect();\n          if (\n            event.clientY < rect.top ||\n            event.clientY > rect.bottom ||\n            event.clientX < rect.left ||\n            event.clientX > rect.right\n          )\n            this.closeMenu();\n        }}\n      >\n        <div class=\"mobile-section-sheet__items\" role=\"menu\" aria-label={this.navigationLabel}>\n          {this.resolvedSections.map(section =>\n            isTabDivider(section) ? (\n              <div class=\"mobile-section-sheet__divider\" role=\"separator\" />\n            ) : (\n              <button\n                type=\"button\"\n                role=\"menuitem\"\n                value={section.id}\n                disabled={section.isInactive}\n                aria-current={section.id === this.selectedSection?.id ? 'page' : undefined}\n                tabIndex={section.id === this.focusedSection ? 0 : -1}\n                class={{\n                  'mobile-section-sheet__item': true,\n                  'ds-control--lg': true,\n                  'ds-interaction-fill': true,\n                  'ds-focus-ring-inset': true,\n                  'ds-focus-ring--visible':\n                    this.initialFocusVisible && section.id === this.focusedSection,\n                }}\n                onFocus={() => {\n                  this.focusedSection = section.id;\n                }}\n                onClick={() => {\n                  if (this.sheetClosing || section.isInactive) return;\n                  this.closeMenu();\n                  if (section.id !== this.selectedSection?.id) this.dsChange.emit(section.id);\n                }}\n              >\n                <ds-text\n                  class=\"mobile-section-sheet__label ds-interaction-fill__content\"\n                  as=\"span\"\n                  variant=\"text-body-large\"\n                  color=\"inherit\"\n                  emphasis={section.id === this.selectedSection?.id}\n                  lineTruncation={1}\n                >\n                  {section.label}\n                </ds-text>\n              </button>\n            )\n          )}\n        </div>\n        <div\n          ref={element => {\n            if (this.browserEdgeEl !== element) this.browserEdgeColors = '';\n            this.browserEdgeEl = element ?? null;\n          }}\n          class=\"mobile-section-sheet__browser-edge\"\n          aria-hidden=\"true\"\n        />\n      </dialog>\n    );\n  }\n\n  private handleSelect = (event: CustomEvent<MenuItemData>) => {\n    const id = String(event.detail.value ?? '');\n    const section = this.selectableSections.find(candidate => candidate.id === id);\n    if (!section || section.isInactive) return;\n    this.closeMenu();\n    if (id !== this.selectedSection?.id) this.dsChange.emit(id);\n    requestAnimationFrame(() => this.triggerEl?.focus());\n  };\n\n  render() {\n    const selected = this.selectedSection;\n    if (!selected) return <Host />;\n    const combined = this.presentation === 'sheet' && !!this.pageLabel;\n\n    return (\n      <Host\n        class={{ 'mobile-section-switcher--pointer-focus': this.pointerFocus }}\n        onPointerDown={() => {\n          this.pointerFocus = true;\n          this.initialFocusVisible = false;\n        }}\n      >\n        <button\n          ref={element => {\n            this.triggerEl = element ?? null;\n          }}\n          id={this.triggerId}\n          class={{\n            'mobile-section-switcher': true,\n            'mobile-section-switcher--expanded': this.menuOpen,\n            'ds-interaction-fill--surface-open':\n              this.menuSurfaceOpen || this.menuOpen || this.sheetClosing,\n            'mobile-section-switcher--sheet': this.presentation === 'sheet',\n            'mobile-section-switcher--combined': combined,\n            'ds-focus-ring-inset': true,\n            'ds-interaction-fill': true,\n          }}\n          type=\"button\"\n          aria-haspopup={this.presentation === 'sheet' ? 'dialog' : 'menu'}\n          aria-controls={this.menuId}\n          aria-expanded={String(this.menuOpen)}\n          aria-label={this.triggerAriaLabel}\n          onClick={this.toggleMenu}\n        >\n          {this.presentation === 'menu' ? (\n            <span\n              class={{\n                'mobile-section-switcher__position': true,\n                'mobile-section-switcher__position--visible': this.hasPrevious,\n                'ds-interaction-fill__content': true,\n              }}\n              aria-hidden=\"true\"\n            />\n          ) : null}\n          {combined\n            ? [\n                <ds-text\n                  class=\"mobile-section-switcher__page-label ds-interaction-fill__content\"\n                  as=\"span\"\n                  variant=\"text-body-large\"\n                  emphasis\n                  color=\"inherit\"\n                  lineTruncation={1}\n                >\n                  {this.pageLabel}\n                </ds-text>,\n                <ds-text\n                  class=\"mobile-section-switcher__separator ds-interaction-fill__content\"\n                  as=\"span\"\n                  variant=\"text-body-large\"\n                  color=\"inherit\"\n                  aria-hidden=\"true\"\n                >\n                  ·\n                </ds-text>,\n              ]\n            : null}\n          <ds-text\n            class=\"mobile-section-switcher__label ds-interaction-fill__content\"\n            as=\"span\"\n            variant={this.presentation === 'sheet' ? 'text-body-large' : 'text-body-medium'}\n            emphasis\n            color=\"inherit\"\n            lineTruncation={1}\n          >\n            {selected.label}\n          </ds-text>\n          {this.presentation === 'menu' ? (\n            <span\n              class={{\n                'mobile-section-switcher__position': true,\n                'mobile-section-switcher__position--visible': this.hasNext,\n                'ds-interaction-fill__content': true,\n              }}\n              aria-hidden=\"true\"\n            />\n          ) : null}\n        </button>\n\n        {this.presentation === 'sheet' || this.sheetClosing ? (\n          this.renderSheet()\n        ) : this.selectableSections.length > 1 ? (\n          <ds-menu\n            id={this.menuId}\n            anchorId={this.triggerId}\n            align=\"center\"\n            menuLabel={this.navigationLabel}\n            open={this.menuOpen}\n            initialFocusVisible={this.initialFocusVisible}\n            sections={this.menuSections}\n            onDsClose={this.closeMenu}\n            onDsAfterClose={() => {\n              if (!this.menuOpen) this.menuSurfaceOpen = false;\n            }}\n            onDsSelect={this.handleSelect}\n          />\n        ) : null}\n      </Host>\n    );\n  }\n}\n",
+      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Prop,\n  State,\n  Watch,\n} from '@stencil/core';\nimport type { MenuItemData, MenuSection } from '../Menu/menu-types';\nimport {\n  getSelectableTabs,\n  isTabDivider,\n  type TabItem,\n  type TabItemTab,\n} from '../TabGroup/tab-item-utils';\nimport { resolveMobileSectionPosition } from './mobile-section-switcher-utils';\nimport { resolveMotionTimeMs, TOKEN_DEFAULTS } from '../../utils';\nimport { ConnectionTasks } from '../../utils/connection-tasks';\n\nlet nextMobileSectionSwitcherId = 0;\n\n@Component({\n  tag: 'ds-mobile-section-switcher',\n  styleUrl: 'MobileSectionSwitcher.css',\n  scoped: true,\n})\nexport class MobileSectionSwitcher {\n  @Element() el!: HTMLElement;\n\n  /** Ordered controlled sections. Divider entries group the popup menu. */\n  @Prop() sections: TabItem[] = [];\n  /** Controlled selected section id. */\n  @Prop() value: string = '';\n  /** Accessible name for the section chooser. */\n  @Prop() navigationLabel: string = 'Change page section';\n  /** Anchored local-view menu or viewport-edge sheet for primary page sections. */\n  @Prop() presentation: 'menu' | 'sheet' = 'menu';\n  /** Stable page identity shown before the selected section in a sheet trigger. */\n  @Prop() pageLabel: string = '';\n\n  /** Selection intent. The route, tool, or workflow owner updates `value`. */\n  @Event() dsChange!: EventEmitter<string>;\n\n  @State() private menuOpen = false;\n  @State() private menuSurfaceOpen = false;\n  @State() private initialFocusVisible = false;\n  @State() private pointerFocus = false;\n  @State() private sheetClosing = false;\n  @State() private focusedSection = '';\n\n  private readonly instanceId = nextMobileSectionSwitcherId++;\n  private readonly triggerId = `ds-mobile-section-switcher-trigger-${this.instanceId}`;\n  private readonly menuId = `ds-mobile-section-switcher-menu-${this.instanceId}`;\n  private triggerEl: HTMLButtonElement | null = null;\n  private dialogEl: HTMLDialogElement | null = null;\n  private browserEdgeEl: HTMLDivElement | null = null;\n  private browserEdgeColors = '';\n  private themeObserver?: MutationObserver;\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  private visibilityObserver?: ResizeObserver;\n  private loaded = false;\n  private boundDocument?: Document;\n  private readonly tasks = new ConnectionTasks(() => this.el.isConnected);\n\n  private readonly handleDocumentKeyDown = (event: KeyboardEvent) => {\n    if (['Shift', 'Control', 'Alt', 'Meta'].includes(event.key)) return;\n    this.pointerFocus = false;\n  };\n\n  componentDidLoad() {\n    this.loaded = true;\n    this.connectResources();\n  }\n\n  connectedCallback() {\n    if (this.loaded) this.connectResources();\n  }\n\n  private connectResources() {\n    if (!this.el.isConnected || this.boundDocument) return;\n    this.boundDocument = this.el.ownerDocument;\n    this.boundDocument.addEventListener('keydown', this.handleDocumentKeyDown, true);\n    this.visibilityObserver = new ResizeObserver(\n      this.tasks.guard(() => {\n        if (this.dialogEl?.open && !this.triggerEl?.getClientRects().length) {\n          this.finishSheetClose(false);\n        }\n      })\n    );\n    this.visibilityObserver.observe(this.el);\n  }\n\n  componentDidRender() {\n    if (!this.el.isConnected || !this.dialogEl) return;\n    if (this.presentation === 'sheet' && this.menuOpen && !this.dialogEl.open) {\n      const initialSection = this.focusedSection;\n      this.updateBrowserEdgeColor();\n      this.observeBrowserEdgeTheme();\n      this.dialogEl.showModal();\n      this.focusSheetItem(initialSection);\n    }\n    if (this.sheetClosing && this.dialogEl.open && !this.closeTimer) {\n      const duration = resolveMotionTimeMs(\n        TOKEN_DEFAULTS.motionShort2,\n        TOKEN_DEFAULTS.animationDurationShort3\n      );\n      if (!duration) this.finishSheetClose();\n      else this.closeTimer = setTimeout(() => this.finishSheetClose(), duration);\n    }\n  }\n\n  disconnectedCallback() {\n    this.tasks.cancel();\n    this.boundDocument?.removeEventListener('keydown', this.handleDocumentKeyDown, true);\n    this.boundDocument = undefined;\n    this.visibilityObserver?.disconnect();\n    this.visibilityObserver = undefined;\n    this.pointerFocus = false;\n    this.menuSurfaceOpen = false;\n    this.finishSheetClose(false);\n  }\n\n  @Watch('presentation')\n  handlePresentationChange() {\n    this.menuSurfaceOpen = false;\n    this.closeMenu();\n  }\n\n  @Watch('value')\n  @Watch('pageLabel')\n  handleContextChange() {\n    this.closeMenu();\n  }\n\n  private finishSheetClose(restoreFocus = true) {\n    if (this.closeTimer) clearTimeout(this.closeTimer);\n    this.closeTimer = null;\n    const wasOpen = this.dialogEl?.open;\n    this.dialogEl?.close();\n    this.themeObserver?.disconnect();\n    this.menuOpen = false;\n    this.sheetClosing = false;\n    if (wasOpen && restoreFocus && this.triggerEl?.getClientRects().length) this.triggerEl.focus();\n  }\n\n  private updateBrowserEdgeColor = () => {\n    if (!this.el.isConnected || !this.browserEdgeEl || !this.dialogEl) return;\n    const base = getComputedStyle(this.browserEdgeEl).color;\n    const shade = getComputedStyle(this.dialogEl, '::backdrop').backgroundColor;\n    const colors = `${base}|${shade}`;\n    if (colors === this.browserEdgeColors) return;\n    // Let the browser resolve token colors, including alpha and non-sRGB syntax,\n    // then flatten the shade over the bar into the opaque color Safari samples.\n    const canvas = this.el.ownerDocument.createElement('canvas');\n    canvas.width = canvas.height = 1;\n    const context = canvas.getContext('2d');\n    if (!context) return;\n    context.fillStyle = base;\n    context.fillRect(0, 0, 1, 1);\n    context.fillStyle = shade;\n    context.fillRect(0, 0, 1, 1);\n    const [red, green, blue] = context.getImageData(0, 0, 1, 1).data;\n    this.browserEdgeEl.style.setProperty(\n      '--_mobile-section-edge-color',\n      `rgb(${red}, ${green}, ${blue})`\n    );\n    this.browserEdgeColors = colors;\n  };\n\n  private observeBrowserEdgeTheme() {\n    this.themeObserver ??= new MutationObserver(this.updateBrowserEdgeColor);\n    // Token themes are inherited from the page or a containing theme scope.\n    for (let ancestor: HTMLElement | null = this.el; ancestor; ancestor = ancestor.parentElement) {\n      this.themeObserver.observe(ancestor, {\n        attributes: true,\n        attributeFilter: ['class', 'style', 'data-theme'],\n      });\n    }\n  }\n\n  private focusSheetItem(id: string) {\n    const buttons = Array.from(this.dialogEl?.querySelectorAll<HTMLButtonElement>('button') ?? []);\n    const button =\n      buttons.find(item => item.value === id && !item.disabled) ??\n      buttons.find(item => !item.disabled);\n    if (button) {\n      this.focusedSection = button.value;\n      button.focus();\n    } else this.dialogEl?.focus();\n  }\n\n  private handleSheetKeyDown = (event: KeyboardEvent) => {\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      event.stopPropagation();\n      this.closeMenu();\n      return;\n    }\n    const sections = this.selectableSections.filter(section => !section.isInactive);\n    if (!sections.length) return;\n    const index = Math.max(\n      0,\n      sections.findIndex(section => section.id === this.focusedSection)\n    );\n    let next: number;\n    if (event.key === 'ArrowDown') next = (index + 1) % sections.length;\n    else if (event.key === 'ArrowUp') next = (index + sections.length - 1) % sections.length;\n    else if (event.key === 'Home') next = 0;\n    else if (event.key === 'End') next = sections.length - 1;\n    else if (event.key === 'Tab') next = index;\n    else if (\n      event.key.length === 1 &&\n      !event.ctrlKey &&\n      !event.metaKey &&\n      !event.altKey &&\n      event.key !== ' '\n    ) {\n      const match = sections.findIndex((_, offset) =>\n        sections[(index + offset + 1) % sections.length].label\n          .toLowerCase()\n          .startsWith(event.key.toLowerCase())\n      );\n      if (match < 0) return;\n      next = (index + match + 1) % sections.length;\n    } else return;\n    event.preventDefault();\n    this.initialFocusVisible = true;\n    this.focusSheetItem(sections[next].id);\n  };\n\n  private get resolvedSections(): TabItem[] {\n    return this.sections ?? [];\n  }\n\n  private get selectableSections(): TabItemTab[] {\n    return getSelectableTabs(this.resolvedSections);\n  }\n\n  private get selectedIndex(): number {\n    return resolveMobileSectionPosition(this.resolvedSections, this.value).selectedIndex;\n  }\n\n  private get selectedSection(): TabItemTab | undefined {\n    return this.selectableSections[this.selectedIndex];\n  }\n\n  private get hasPrevious(): boolean {\n    return resolveMobileSectionPosition(this.resolvedSections, this.value).hasPrevious;\n  }\n\n  private get hasNext(): boolean {\n    return resolveMobileSectionPosition(this.resolvedSections, this.value).hasNext;\n  }\n\n  private get triggerAriaLabel(): string {\n    return `${this.presentation === 'sheet' && this.pageLabel ? `${this.pageLabel}. ` : ''}${this.navigationLabel}. Current section: ${this.selectedSection?.label ?? ''}`;\n  }\n\n  private get menuSections(): MenuSection[] {\n    const groups: MenuSection[] = [];\n    let items: MenuItemData[] = [];\n    const commit = () => {\n      if (items.length) groups.push({ items });\n      items = [];\n    };\n\n    for (const section of this.resolvedSections) {\n      if (isTabDivider(section)) {\n        commit();\n        continue;\n      }\n      items.push({\n        label: section.label,\n        value: section.id,\n        dot: section.dot,\n        isSelected: section.id === this.selectedSection?.id,\n        isInactive: section.isInactive,\n      });\n    }\n    commit();\n    return groups;\n  }\n\n  @Watch('sections')\n  handleSectionsChange() {\n    if (this.selectableSections.length <= 1) {\n      this.closeMenu();\n      this.menuSurfaceOpen = false;\n    } else if (this.dialogEl?.open && !this.sheetClosing) {\n      this.tasks.frame(() => {\n        if (this.dialogEl?.open && !this.sheetClosing) this.focusSheetItem(this.focusedSection);\n      });\n    }\n  }\n\n  private toggleMenu = (event: MouseEvent) => {\n    if (this.selectableSections.length <= 1) return;\n    this.initialFocusVisible = event.detail === 0;\n    if (this.presentation === 'sheet') {\n      if (this.menuOpen) this.closeMenu();\n      else {\n        this.focusedSection = this.selectedSection?.id ?? '';\n        this.menuOpen = true;\n      }\n      return;\n    }\n    this.menuOpen = !this.menuOpen;\n    if (this.menuOpen) this.menuSurfaceOpen = true;\n  };\n\n  private closeMenu = () => {\n    this.menuOpen = false;\n    if (this.dialogEl?.open) this.sheetClosing = true;\n  };\n\n  private renderSheet() {\n    return (\n      <dialog\n        id={this.menuId}\n        ref={element => {\n          this.dialogEl = element ?? null;\n        }}\n        class={{ 'mobile-section-sheet': true, 'mobile-section-sheet--closing': this.sheetClosing }}\n        aria-label={this.navigationLabel}\n        tabIndex={-1}\n        onCancel={event => {\n          event.preventDefault();\n          this.closeMenu();\n        }}\n        onKeyDown={this.handleSheetKeyDown}\n        onClick={event => {\n          if (!this.dialogEl || event.target !== this.dialogEl) return;\n          const rect = this.dialogEl.getBoundingClientRect();\n          if (\n            event.clientY < rect.top ||\n            event.clientY > rect.bottom ||\n            event.clientX < rect.left ||\n            event.clientX > rect.right\n          )\n            this.closeMenu();\n        }}\n      >\n        <div class=\"mobile-section-sheet__items\" role=\"menu\" aria-label={this.navigationLabel}>\n          {this.resolvedSections.map(section =>\n            isTabDivider(section) ? (\n              <div class=\"mobile-section-sheet__divider\" role=\"separator\" />\n            ) : (\n              <button\n                type=\"button\"\n                role=\"menuitem\"\n                value={section.id}\n                disabled={section.isInactive}\n                aria-current={section.id === this.selectedSection?.id ? 'page' : undefined}\n                tabIndex={section.id === this.focusedSection ? 0 : -1}\n                class={{\n                  'mobile-section-sheet__item': true,\n                  'ds-control--lg': true,\n                  'ds-interaction-fill': true,\n                  'ds-focus-ring-inset': true,\n                  'ds-focus-ring--visible':\n                    this.initialFocusVisible && section.id === this.focusedSection,\n                }}\n                onFocus={() => {\n                  this.focusedSection = section.id;\n                }}\n                onClick={() => {\n                  if (this.sheetClosing || section.isInactive) return;\n                  this.closeMenu();\n                  if (section.id !== this.selectedSection?.id) this.dsChange.emit(section.id);\n                }}\n              >\n                <ds-text\n                  class=\"mobile-section-sheet__label ds-interaction-fill__content\"\n                  as=\"span\"\n                  variant=\"text-body-large\"\n                  color=\"inherit\"\n                  emphasis={section.id === this.selectedSection?.id}\n                  lineTruncation={1}\n                >\n                  {section.label}\n                </ds-text>\n              </button>\n            )\n          )}\n        </div>\n        <div\n          ref={element => {\n            if (this.browserEdgeEl !== element) this.browserEdgeColors = '';\n            this.browserEdgeEl = element ?? null;\n          }}\n          class=\"mobile-section-sheet__browser-edge\"\n          aria-hidden=\"true\"\n        />\n      </dialog>\n    );\n  }\n\n  private handleSelect = (event: CustomEvent<MenuItemData>) => {\n    const id = String(event.detail.value ?? '');\n    const section = this.selectableSections.find(candidate => candidate.id === id);\n    if (!section || section.isInactive) return;\n    this.closeMenu();\n    if (id !== this.selectedSection?.id) this.dsChange.emit(id);\n    this.tasks.frame(() => this.triggerEl?.focus());\n  };\n\n  render() {\n    const selected = this.selectedSection;\n    if (!selected) return <Host />;\n    const combined = this.presentation === 'sheet' && !!this.pageLabel;\n\n    return (\n      <Host\n        class={{ 'mobile-section-switcher--pointer-focus': this.pointerFocus }}\n        onPointerDown={() => {\n          this.pointerFocus = true;\n          this.initialFocusVisible = false;\n        }}\n      >\n        <button\n          ref={element => {\n            this.triggerEl = element ?? null;\n          }}\n          id={this.triggerId}\n          class={{\n            'mobile-section-switcher': true,\n            'mobile-section-switcher--expanded': this.menuOpen,\n            'ds-interaction-fill--surface-open':\n              this.menuSurfaceOpen || this.menuOpen || this.sheetClosing,\n            'mobile-section-switcher--sheet': this.presentation === 'sheet',\n            'mobile-section-switcher--combined': combined,\n            'ds-focus-ring-inset': true,\n            'ds-interaction-fill': true,\n          }}\n          type=\"button\"\n          aria-haspopup={this.presentation === 'sheet' ? 'dialog' : 'menu'}\n          aria-controls={this.menuId}\n          aria-expanded={String(this.menuOpen)}\n          aria-label={this.triggerAriaLabel}\n          onClick={this.toggleMenu}\n        >\n          {this.presentation === 'menu' ? (\n            <span\n              class={{\n                'mobile-section-switcher__position': true,\n                'mobile-section-switcher__position--visible': this.hasPrevious,\n                'ds-interaction-fill__content': true,\n              }}\n              aria-hidden=\"true\"\n            />\n          ) : null}\n          {combined\n            ? [\n                <ds-text\n                  class=\"mobile-section-switcher__page-label ds-interaction-fill__content\"\n                  as=\"span\"\n                  variant=\"text-body-large\"\n                  emphasis\n                  color=\"inherit\"\n                  lineTruncation={1}\n                >\n                  {this.pageLabel}\n                </ds-text>,\n                <ds-text\n                  class=\"mobile-section-switcher__separator ds-interaction-fill__content\"\n                  as=\"span\"\n                  variant=\"text-body-large\"\n                  color=\"inherit\"\n                  aria-hidden=\"true\"\n                >\n                  ·\n                </ds-text>,\n              ]\n            : null}\n          <ds-text\n            class=\"mobile-section-switcher__label ds-interaction-fill__content\"\n            as=\"span\"\n            variant={this.presentation === 'sheet' ? 'text-body-large' : 'text-body-medium'}\n            emphasis\n            color=\"inherit\"\n            lineTruncation={1}\n          >\n            {selected.label}\n          </ds-text>\n          {this.presentation === 'menu' ? (\n            <span\n              class={{\n                'mobile-section-switcher__position': true,\n                'mobile-section-switcher__position--visible': this.hasNext,\n                'ds-interaction-fill__content': true,\n              }}\n              aria-hidden=\"true\"\n            />\n          ) : null}\n        </button>\n\n        {this.presentation === 'sheet' || this.sheetClosing ? (\n          this.renderSheet()\n        ) : this.selectableSections.length > 1 ? (\n          <ds-menu\n            id={this.menuId}\n            anchorId={this.triggerId}\n            align=\"center\"\n            menuLabel={this.navigationLabel}\n            open={this.menuOpen}\n            initialFocusVisible={this.initialFocusVisible}\n            sections={this.menuSections}\n            onDsClose={this.closeMenu}\n            onDsAfterClose={() => {\n              if (!this.menuOpen) this.menuSurfaceOpen = false;\n            }}\n            onDsSelect={this.handleSelect}\n          />\n        ) : null}\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     },
     {

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

@@ -322,7 +322,7 @@
     },
     {
       "path": "src/wc/components/Modal/Modal.tsx",
-      "content": "import {\n  Component,\n  Prop,\n  State,\n  Event,\n  EventEmitter,\n  Element,\n  Watch,\n  h,\n  Host,\n} from '@stencil/core';\nimport { resolveMotionTimeMs, TOKEN_DEFAULTS } from '../../utils';\n\nexport type ModalWidth = 'sm' | 'md' | 'lg';\nexport type ModalCloseReason = 'close-button' | 'escape' | 'backdrop';\n\nexport interface ModalCloseDetail {\n  reason: ModalCloseReason;\n  originalEvent: Event;\n}\n\nconst WIDTH_MAP: Record<ModalWidth, string> = {\n  sm: 'var(--dimension-modal-width-sm)',\n  md: 'var(--dimension-modal-width-md)',\n  lg: 'var(--dimension-modal-width-lg)',\n};\n\nconst FOCUSABLE_SEL = [\n  'a[href]',\n  'area[href]',\n  'button:not([disabled])',\n  'input:not([disabled]):not([type=\"hidden\"])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  'iframe',\n  '[contenteditable=\"true\"]',\n  '[tabindex]:not([tabindex=\"-1\"])',\n].join(',');\n\nlet modalIdCounter = 0;\n\n@Component({\n  tag: 'ds-modal',\n  styleUrl: 'Modal.css',\n  scoped: true,\n})\nexport class Modal {\n  @Element() el!: HTMLElement;\n\n  @Prop({ mutable: true }) open: boolean = false;\n  @Prop() heading!: string;\n  /** Optional supporting copy shown below the heading. */\n  @Prop() description: string = '';\n  @Prop() closeAriaLabel: string = 'Close';\n  @Prop() modalWidth: ModalWidth | string = 'md';\n  /** Optional id reference for explanatory content in the default slot. */\n  @Prop({ attribute: 'aria-describedby' }) ariaDescribedby: string | undefined;\n\n  @State() private closing: boolean = false;\n  @State() private hasFooter: boolean = false;\n\n  /** Emitted when an internal dismissal control requests that the modal close. */\n  @Event() dsClose!: EventEmitter<ModalCloseDetail>;\n  /** Emitted after exit motion completes, the top layer closes, and focus is restored. */\n  @Event() dsAfterClose!: EventEmitter<void>;\n\n  private titleId = `ds-modal-title-${++modalIdCounter}`;\n  private descriptionId = `${this.titleId}-description`;\n  private dialogEl: HTMLDialogElement | null = null;\n  private previousFocus: HTMLElement | null = null;\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n\n  componentDidLoad() {\n    this.updateFooterPresence();\n    if (this.open) this.onOpenChange(true);\n  }\n\n  componentDidRender() {\n    if (!this.closing || !this.dialogEl?.open || this.closeTimer) return;\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  disconnectedCallback() {\n    this.clearCloseTimer();\n    if (this.dialogEl?.open) this.dialogEl.close();\n  }\n\n  @Watch('open')\n  onOpenChange(isOpen: boolean) {\n    if (isOpen) {\n      this.clearCloseTimer();\n      const alreadyOpen = !!this.dialogEl?.open;\n      this.closing = false;\n      if (!this.dialogEl || alreadyOpen) return;\n      this.previousFocus = document.activeElement as HTMLElement | null;\n      this.dialogEl.showModal();\n      requestAnimationFrame(() => {\n        if (this.open && this.dialogEl?.open) this.focusClose();\n      });\n    } else if (this.dialogEl?.open) {\n      this.closing = true;\n    }\n  }\n\n  private focusClose() {\n    const close = this.el.querySelector('ds-button-unfilled.modal-close') as\n      | (HTMLElement & { setFocus?: () => Promise<void> })\n      | null;\n    void close?.setFocus?.();\n  }\n\n  private clearCloseTimer() {\n    if (this.closeTimer) {\n      clearTimeout(this.closeTimer);\n      this.closeTimer = null;\n    }\n  }\n\n  private requestClose(reason: ModalCloseReason, originalEvent: Event) {\n    if (!this.open || this.closing || !this.dialogEl?.open) return;\n    this.dsClose.emit({ reason, originalEvent });\n    this.open = false;\n  }\n\n  private updateFooterPresence(slot?: HTMLSlotElement) {\n    const assignedNodes = slot?.assignedNodes() ?? [];\n    this.hasFooter =\n      assignedNodes.some(node => node.nodeType !== Node.TEXT_NODE || !!node.textContent?.trim()) ||\n      this.el.querySelector('[slot=\"footer\"]') !== null;\n  }\n\n  private handleCancel(event: Event) {\n    event.preventDefault();\n    this.requestClose('escape', event);\n  }\n\n  private handleBackdropPointerDown(event: PointerEvent) {\n    if (event.target === this.dialogEl) this.requestClose('backdrop', event);\n  }\n\n  private handleKeyDown(event: KeyboardEvent) {\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      this.requestClose('escape', event);\n      return;\n    }\n    if (event.key !== 'Tab' || !this.dialogEl) return;\n    const focusables = Array.from(\n      this.dialogEl.querySelectorAll<HTMLElement>(FOCUSABLE_SEL)\n    ).filter(\n      element => !element.hasAttribute('disabled') && element.getAttribute('aria-hidden') !== 'true'\n    );\n    if (!focusables.length) {\n      event.preventDefault();\n      this.dialogEl.focus();\n      return;\n    }\n    const first = focusables[0];\n    const last = focusables[focusables.length - 1];\n    const active = document.activeElement;\n    if (event.shiftKey && (active === first || active === this.dialogEl)) {\n      event.preventDefault();\n      last.focus();\n    } else if (!event.shiftKey && active === last) {\n      event.preventDefault();\n      first.focus();\n    }\n  }\n\n  private get resolvedWidth(): string {\n    if (this.modalWidth === 'sm' || this.modalWidth === 'md' || this.modalWidth === 'lg') {\n      return WIDTH_MAP[this.modalWidth];\n    }\n    return this.modalWidth as string;\n  }\n\n  private get describedBy(): string | undefined {\n    const ids = [this.description ? this.descriptionId : '', this.ariaDescribedby ?? ''].filter(\n      Boolean\n    );\n    return ids.length > 0 ? ids.join(' ') : undefined;\n  }\n\n  private get closeAnimationMs(): number {\n    return resolveMotionTimeMs(TOKEN_DEFAULTS.motionShort2, TOKEN_DEFAULTS.animationDurationShort3);\n  }\n\n  private finishClose() {\n    if (!this.dialogEl?.open) return;\n    this.dialogEl.close();\n    this.closing = false;\n    this.clearCloseTimer();\n    this.previousFocus?.focus?.();\n    this.previousFocus = null;\n    this.dsAfterClose.emit();\n  }\n\n  render() {\n    return (\n      <Host>\n        <dialog\n          ref={(element?: HTMLDialogElement) => {\n            this.dialogEl = element ?? null;\n          }}\n          class={{ 'modal-dialog': true, 'modal-dialog--closing': this.closing }}\n          aria-labelledby={this.titleId}\n          aria-describedby={this.describedBy}\n          onCancel={(event: Event) => this.handleCancel(event)}\n          onPointerDown={(event: PointerEvent) => this.handleBackdropPointerDown(event)}\n          onKeyDown={(event: KeyboardEvent) => this.handleKeyDown(event)}\n          style={{\n            width: `min(${this.resolvedWidth}, calc(100vw - 2 * var(--dimension-space-200)))`,\n          }}\n        >\n          <div class=\"modal-header ds-chrome-header ds-chrome-header--bounded\">\n            <div class=\"modal-copy ds-chrome-header__copy ds-chrome-header__copy--stacked ds-control--md\">\n              <ds-text\n                class=\"modal-heading ds-chrome-header__heading\"\n                as=\"h2\"\n                variant=\"text-title-small\"\n                emphasis\n                color=\"primary\"\n                lineTruncation={1}\n                textId={this.titleId}\n              >\n                {this.heading}\n              </ds-text>\n              {this.description ? (\n                <ds-text\n                  class=\"modal-description ds-chrome-header__description\"\n                  as=\"p\"\n                  variant=\"text-body-medium\"\n                  color=\"secondary\"\n                  wrap=\"wrap\"\n                  textId={this.descriptionId}\n                >\n                  {this.description}\n                </ds-text>\n              ) : null}\n            </div>\n            <ds-tooltip\n              class=\"modal-close-tooltip ds-chrome-header__trailing\"\n              label={this.closeAriaLabel}\n              side=\"bottom\"\n              size=\"sm\"\n            >\n              <ds-button-unfilled\n                class=\"modal-close\"\n                variant=\"icon\"\n                icon=\"Cross\"\n                size=\"md\"\n                aria-label={this.closeAriaLabel}\n                activeFill={false}\n                hasBorder={false}\n                onDsClick={(event: CustomEvent<MouseEvent>) =>\n                  this.requestClose('close-button', event.detail)\n                }\n              />\n            </ds-tooltip>\n          </div>\n          <div class=\"modal-content\">\n            <slot />\n          </div>\n          <div\n            class={{\n              'modal-footer': true,\n              'ds-chrome-row': true,\n              'ds-chrome-space--lg': true,\n              'modal-footer--empty': !this.hasFooter,\n            }}\n          >\n            <div class=\"modal-footer__actions\">\n              <slot\n                name=\"footer\"\n                onSlotchange={(event: Event) =>\n                  this.updateFooterPresence(event.currentTarget as HTMLSlotElement)\n                }\n              />\n            </div>\n          </div>\n        </dialog>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import {\n  Component,\n  Prop,\n  State,\n  Event,\n  EventEmitter,\n  Element,\n  Watch,\n  h,\n  Host,\n} from '@stencil/core';\nimport { resolveMotionTimeMs, TOKEN_DEFAULTS } from '../../utils';\nimport { ConnectionTasks } from '../../utils/connection-tasks';\n\nexport type ModalWidth = 'sm' | 'md' | 'lg';\nexport type ModalCloseReason = 'close-button' | 'escape' | 'backdrop';\n\nexport interface ModalCloseDetail {\n  reason: ModalCloseReason;\n  originalEvent: Event;\n}\n\nconst WIDTH_MAP: Record<ModalWidth, string> = {\n  sm: 'var(--dimension-modal-width-sm)',\n  md: 'var(--dimension-modal-width-md)',\n  lg: 'var(--dimension-modal-width-lg)',\n};\n\nconst FOCUSABLE_SEL = [\n  'a[href]',\n  'area[href]',\n  'button:not([disabled])',\n  'input:not([disabled]):not([type=\"hidden\"])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  'iframe',\n  '[contenteditable=\"true\"]',\n  '[tabindex]:not([tabindex=\"-1\"])',\n].join(',');\n\nlet modalIdCounter = 0;\n\n@Component({\n  tag: 'ds-modal',\n  styleUrl: 'Modal.css',\n  scoped: true,\n})\nexport class Modal {\n  @Element() el!: HTMLElement;\n\n  @Prop({ mutable: true }) open: boolean = false;\n  @Prop() heading!: string;\n  /** Optional supporting copy shown below the heading. */\n  @Prop() description: string = '';\n  @Prop() closeAriaLabel: string = 'Close';\n  @Prop() modalWidth: ModalWidth | string = 'md';\n  /** Optional id reference for explanatory content in the default slot. */\n  @Prop({ attribute: 'aria-describedby' }) ariaDescribedby: string | undefined;\n\n  @State() private closing: boolean = false;\n  @State() private hasFooter: boolean = false;\n\n  /** Emitted when an internal dismissal control requests that the modal close. */\n  @Event() dsClose!: EventEmitter<ModalCloseDetail>;\n  /** Emitted after exit motion completes, the top layer closes, and focus is restored. */\n  @Event() dsAfterClose!: EventEmitter<void>;\n\n  private titleId = `ds-modal-title-${++modalIdCounter}`;\n  private descriptionId = `${this.titleId}-description`;\n  private dialogEl: HTMLDialogElement | null = null;\n  private previousFocus: HTMLElement | null = null;\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  private loaded = false;\n  private readonly tasks = new ConnectionTasks(() => this.el.isConnected);\n\n  connectedCallback() {\n    if (!this.loaded) return;\n    this.updateFooterPresence();\n    this.onOpenChange(this.open);\n  }\n\n  componentDidLoad() {\n    this.loaded = true;\n    this.updateFooterPresence();\n    if (this.open) this.onOpenChange(true);\n  }\n\n  componentDidRender() {\n    if (!this.el.isConnected) return;\n    if (!this.closing || !this.dialogEl?.open || this.closeTimer) return;\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  disconnectedCallback() {\n    this.tasks.cancel();\n    this.clearCloseTimer();\n    if (this.dialogEl?.open) this.dialogEl.close();\n    this.closing = false;\n    this.previousFocus = null;\n  }\n\n  @Watch('open')\n  onOpenChange(isOpen: boolean) {\n    if (!this.loaded || !this.el.isConnected) return;\n    this.tasks.cancel();\n    if (isOpen) {\n      this.clearCloseTimer();\n      const alreadyOpen = !!this.dialogEl?.open;\n      this.closing = false;\n      if (!this.dialogEl || alreadyOpen) return;\n      this.previousFocus = this.el.ownerDocument.activeElement as HTMLElement | null;\n      this.dialogEl.showModal();\n      this.tasks.frame(() => {\n        if (this.open && this.dialogEl?.open) this.focusClose();\n      });\n    } else if (this.dialogEl?.open) {\n      this.closing = true;\n    }\n  }\n\n  private focusClose() {\n    const close = this.el.querySelector('ds-button-unfilled.modal-close') as\n      | (HTMLElement & { setFocus?: () => Promise<void> })\n      | null;\n    void close?.setFocus?.();\n  }\n\n  private clearCloseTimer() {\n    if (this.closeTimer) {\n      clearTimeout(this.closeTimer);\n      this.closeTimer = null;\n    }\n  }\n\n  private requestClose(reason: ModalCloseReason, originalEvent: Event) {\n    if (!this.open || this.closing || !this.dialogEl?.open) return;\n    this.dsClose.emit({ reason, originalEvent });\n    this.open = false;\n  }\n\n  private updateFooterPresence(slot?: HTMLSlotElement) {\n    const assignedNodes = slot?.assignedNodes() ?? [];\n    this.hasFooter =\n      assignedNodes.some(node => node.nodeType !== Node.TEXT_NODE || !!node.textContent?.trim()) ||\n      this.el.querySelector('[slot=\"footer\"]') !== null;\n  }\n\n  private handleCancel(event: Event) {\n    event.preventDefault();\n    this.requestClose('escape', event);\n  }\n\n  private handleBackdropPointerDown(event: PointerEvent) {\n    if (event.target === this.dialogEl) this.requestClose('backdrop', event);\n  }\n\n  private handleKeyDown(event: KeyboardEvent) {\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      this.requestClose('escape', event);\n      return;\n    }\n    if (event.key !== 'Tab' || !this.dialogEl) return;\n    const focusables = Array.from(\n      this.dialogEl.querySelectorAll<HTMLElement>(FOCUSABLE_SEL)\n    ).filter(\n      element => !element.hasAttribute('disabled') && element.getAttribute('aria-hidden') !== 'true'\n    );\n    if (!focusables.length) {\n      event.preventDefault();\n      this.dialogEl.focus();\n      return;\n    }\n    const first = focusables[0];\n    const last = focusables[focusables.length - 1];\n    const active = document.activeElement;\n    if (event.shiftKey && (active === first || active === this.dialogEl)) {\n      event.preventDefault();\n      last.focus();\n    } else if (!event.shiftKey && active === last) {\n      event.preventDefault();\n      first.focus();\n    }\n  }\n\n  private get resolvedWidth(): string {\n    if (this.modalWidth === 'sm' || this.modalWidth === 'md' || this.modalWidth === 'lg') {\n      return WIDTH_MAP[this.modalWidth];\n    }\n    return this.modalWidth as string;\n  }\n\n  private get describedBy(): string | undefined {\n    const ids = [this.description ? this.descriptionId : '', this.ariaDescribedby ?? ''].filter(\n      Boolean\n    );\n    return ids.length > 0 ? ids.join(' ') : undefined;\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.el.isConnected || !this.dialogEl?.open) return;\n    this.dialogEl.close();\n    this.closing = false;\n    this.clearCloseTimer();\n    this.previousFocus?.focus?.();\n    this.previousFocus = null;\n    this.dsAfterClose.emit();\n  }\n\n  render() {\n    return (\n      <Host>\n        <dialog\n          ref={(element?: HTMLDialogElement) => {\n            this.dialogEl = element ?? null;\n          }}\n          class={{ 'modal-dialog': true, 'modal-dialog--closing': this.closing }}\n          aria-labelledby={this.titleId}\n          aria-describedby={this.describedBy}\n          onCancel={(event: Event) => this.handleCancel(event)}\n          onPointerDown={(event: PointerEvent) => this.handleBackdropPointerDown(event)}\n          onKeyDown={(event: KeyboardEvent) => this.handleKeyDown(event)}\n          style={{\n            width: `min(${this.resolvedWidth}, calc(100vw - 2 * var(--dimension-space-200)))`,\n          }}\n        >\n          <div class=\"modal-header ds-chrome-header ds-chrome-header--bounded\">\n            <div class=\"modal-copy ds-chrome-header__copy ds-chrome-header__copy--stacked ds-control--md\">\n              <ds-text\n                class=\"modal-heading ds-chrome-header__heading\"\n                as=\"h2\"\n                variant=\"text-title-small\"\n                emphasis\n                color=\"primary\"\n                lineTruncation={1}\n                textId={this.titleId}\n              >\n                {this.heading}\n              </ds-text>\n              {this.description ? (\n                <ds-text\n                  class=\"modal-description ds-chrome-header__description\"\n                  as=\"p\"\n                  variant=\"text-body-medium\"\n                  color=\"secondary\"\n                  wrap=\"wrap\"\n                  textId={this.descriptionId}\n                >\n                  {this.description}\n                </ds-text>\n              ) : null}\n            </div>\n            <ds-tooltip\n              class=\"modal-close-tooltip ds-chrome-header__trailing\"\n              label={this.closeAriaLabel}\n              side=\"bottom\"\n              size=\"sm\"\n            >\n              <ds-button-unfilled\n                class=\"modal-close\"\n                variant=\"icon\"\n                icon=\"Cross\"\n                size=\"md\"\n                aria-label={this.closeAriaLabel}\n                activeFill={false}\n                hasBorder={false}\n                onDsClick={(event: CustomEvent<MouseEvent>) =>\n                  this.requestClose('close-button', event.detail)\n                }\n              />\n            </ds-tooltip>\n          </div>\n          <div class=\"modal-content\">\n            <slot />\n          </div>\n          <div\n            class={{\n              'modal-footer': true,\n              'ds-chrome-row': true,\n              'ds-chrome-space--lg': true,\n              'modal-footer--empty': !this.hasFooter,\n            }}\n          >\n            <div class=\"modal-footer__actions\">\n              <slot\n                name=\"footer\"\n                onSlotchange={(event: Event) =>\n                  this.updateFooterPresence(event.currentTarget as HTMLSlotElement)\n                }\n              />\n            </div>\n          </div>\n        </dialog>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]