@ds-mo/ui 12.5.0 → 12.6.0

package/dist/mcp-data/registry/shell-page.json

@@ -48,7 +48,7 @@
       ],
       "accessibility": [
         "ShellPage exposes the routed page as the main landmark; render exactly one active ShellPage inside ShellApp.",
-        "Provide exactly one BarTitle or BarWorkflow through the header slot so the page has one h1.",
+        "Provide one BarTitle or BarWorkflow through the desktop header slot and one MobileHeader through mobile-header when the page participates in the mobile shell.",
         "Keep loading, empty, validation, error, progress, success, and failure communication in the default product-content slot.",
         "Responsive variant changes preserve the same heading, controls, accessible names, and keyboard focus targets."
       ],
@@ -57,12 +57,13 @@
         "headerPresentation=auto selects the matching header variant from headerCapacity and scroll position.",
         "expanded, compact, and constrained are explicit overrides for exceptional layouts and deterministic examples.",
         "contentInset=default supplies standard page gutters; none permits maps, canvases, and other full-bleed content.",
-        "The required header slot accepts one BarTitle or BarWorkflow. The default slot owns router output and all page product content."
+        "The header slot accepts one desktop BarTitle or BarWorkflow; mobile-header accepts the corresponding MobileHeader presentation. The default slot owns router output and all page product content."
       ],
       "responsiveBehavior": [
         "The owning application shell resolves viewport and persistent-chrome state into the explicit headerCapacity prop; ShellPage never guesses the cause of reduced width from its own rendered size.",
         "Roomy capacity expands at the top and compacts after scroll; compact capacity stays compact; constrained capacity uses the constrained action layout.",
         "A ShellPage-managed BarTitle remains concealed until headerCapacity is available and its rendered variant matches the resolved presentation, preventing a default-variant flash during route activation.",
+        "responsiveMode=mobile hides and inerts the desktop header, exposes mobile-header, and disables desktop scroll-compaction geometry.",
         "Update headerCapacity synchronously with shell layout state so opening tools or crossing application breakpoints cannot briefly render the wrong presentation.",
         "On roomy pages, the expanded header scrolls upward until its title and action row reaches the compact row position, then snaps variants without moving that shared visual anchor.",
         "Scroll compaction preserves the expanded page flow offset so content never jumps beneath the sticky header.",
@@ -71,15 +72,15 @@
       ],
       "frameworkCaveats": {
         "customElements": [
-          "Import ShellPage with BarTitle or BarWorkflow, place one header in slot=header, and render route content as default children.",
+          "Import ShellPage with BarTitle or BarWorkflow in slot=header and MobileHeader in slot=mobile-header, then render route content as default children.",
           "Do not set BarTitle.variant while ShellPage owns headerPresentation."
         ],
         "react": [
-          "Render DsBarTitle or DsBarWorkflow with slot=header inside DsShellPage and keep routed content as the remaining children.",
+          "Render the desktop header with slot=header and DsMobileHeader with slot=mobile-header inside DsShellPage.",
           "Use contentInset none only for deliberately full-bleed page products."
         ],
         "angular": [
-          "Import the generated standalone DsShellPage adapter with DsBarTitle or DsBarWorkflow, preserve slot=header, and place router-outlet in the ShellPage default slot.",
+          "Import the generated standalone DsShellPage adapter with the desktop header and DsMobileHeader, preserve both header slots, and place router-outlet in the default slot.",
           "Do not add another overflow auto wrapper around the routed page."
         ]
       },
@@ -125,6 +126,15 @@
           "required": false,
           "mutable": false,
           "description": "Automatic capacity/scroll behavior, or an explicit header variant override."
+        },
+        "responsiveMode": {
+          "type": "ShellResponsiveMode",
+          "resolvedType": "\"desktop\" | \"mobile\" | \"tablet\"",
+          "attribute": "responsive-mode",
+          "default": "'desktop'",
+          "required": false,
+          "mutable": false,
+          "description": "Explicit shell breakpoint presentation. Mobile uses the dedicated mobile-header slot."
         }
       },
       "events": [],
@@ -157,6 +167,15 @@
         "required": false,
         "mutable": false,
         "description": "Automatic capacity/scroll behavior, or an explicit header variant override."
+      },
+      "responsiveMode": {
+        "type": "ShellResponsiveMode",
+        "resolvedType": "\"desktop\" | \"mobile\" | \"tablet\"",
+        "attribute": "responsive-mode",
+        "default": "'desktop'",
+        "required": false,
+        "mutable": false,
+        "description": "Explicit shell breakpoint presentation. Mobile uses the dedicated mobile-header slot."
       }
     },
     "events": [],
@@ -199,12 +218,12 @@
   "files": [
     {
       "path": "src/wc/components/ShellPage/ShellPage.css",
-      "content": ":host {\n  display: block;\n  position: relative;\n  min-width: 0;\n  min-height: 100%;\n  box-sizing: border-box;\n  background: var(--color-background-primary);\n}\n\n.shell-page__scroll-sentinel {\n  position: absolute;\n  inset-block-start: var(--ds-shell-page-header-travel, 0);\n  inset-inline-start: 0;\n  width: var(--dimension-stroke-width-012);\n  height: var(--dimension-stroke-width-012);\n  pointer-events: none;\n}\n\n.shell-page__sticky-header {\n  position: sticky;\n  inset-block-start: var(--ds-shell-page-sticky-offset, 0);\n  z-index: var(--dimension-z-index-raised);\n  min-width: 0;\n  background: var(--color-background-primary);\n  overflow: visible;\n  overflow-anchor: none;\n}\n\n.shell-page__sticky-header ::slotted(ds-bar-title),\n.shell-page__sticky-header ::slotted(ds-bar-workflow) {\n  display: block;\n  min-width: 0;\n}\n\n.shell-page__flow-spacer {\n  height: var(--ds-shell-page-flow-spacer, 0);\n  background: var(--color-background-primary);\n}\n\n.shell-page__content {\n  min-width: 0;\n  box-sizing: border-box;\n  background: var(--color-background-primary);\n}\n\n:host(.shell-page-host--inset-default) .shell-page__content {\n  padding: var(--dimension-space-400) var(--dimension-space-400) var(--dimension-space-800);\n}\n\n:host(.shell-page-host--inset-none) .shell-page__content {\n  padding: 0;\n}\n",
+      "content": ":host {\n  display: block;\n  position: relative;\n  min-width: 0;\n  min-height: 100%;\n  box-sizing: border-box;\n  background: var(--color-background-primary);\n}\n\n.shell-page__scroll-sentinel {\n  position: absolute;\n  inset-block-start: var(--ds-shell-page-header-travel, 0);\n  inset-inline-start: 0;\n  width: var(--dimension-stroke-width-012);\n  height: var(--dimension-stroke-width-012);\n  pointer-events: none;\n}\n\n.shell-page__sticky-header {\n  position: sticky;\n  inset-block-start: var(--ds-shell-page-sticky-offset, 0);\n  z-index: var(--dimension-z-index-raised);\n  min-width: 0;\n  background: var(--color-background-primary);\n  overflow: visible;\n  overflow-anchor: none;\n}\n\n.shell-page__desktop-header ::slotted(ds-bar-title),\n.shell-page__desktop-header ::slotted(ds-bar-workflow),\n.shell-page__mobile-header ::slotted(ds-mobile-header) {\n  display: block;\n  min-width: 0;\n}\n\n.shell-page__desktop-header[hidden],\n.shell-page__mobile-header[hidden] {\n  display: none;\n}\n\n:host(.shell-page-host--mobile) .shell-page__scroll-sentinel,\n:host(.shell-page-host--mobile) .shell-page__flow-spacer {\n  display: none;\n}\n\n.shell-page__flow-spacer {\n  height: var(--ds-shell-page-flow-spacer, 0);\n  background: var(--color-background-primary);\n}\n\n.shell-page__content {\n  min-width: 0;\n  box-sizing: border-box;\n  background: var(--color-background-primary);\n}\n\n:host(.shell-page-host--inset-default) .shell-page__content {\n  padding: var(--dimension-space-400) var(--dimension-space-400) var(--dimension-space-800);\n}\n\n:host(.shell-page-host--inset-none) .shell-page__content {\n  padding: 0;\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/ShellPage/ShellPage.tsx",
-      "content": "import { Component, Element, h, Host, Prop, State, Watch } from '@stencil/core';\nimport { resolveCssLengthPx } from '../../utils/resolve-css-length-px';\nimport type { BarTitleVariant } from '../BarTitle/bar-title-types';\nimport { resolveShellPageHeaderVariant } from './shell-page-responsive';\nimport type {\n  ShellPageCapacity,\n  ShellPageContentInset,\n  ShellPageHeaderPresentation,\n} from './shell-page-types';\n\ntype BarTitleElement = HTMLElement & { variant: BarTitleVariant };\n\n@Component({\n  tag: 'ds-shell-page',\n  styleUrl: 'ShellPage.css',\n  scoped: true,\n})\nexport class ShellPage {\n  private static readonly MAX_HEADER_REVEAL_FRAMES = 12;\n  private static readonly MAX_HEADER_GEOMETRY_FRAMES = 12;\n\n  @Element() el!: HTMLElement;\n\n  /** Automatic capacity/scroll behavior, or an explicit header variant override. */\n  @Prop() headerPresentation: ShellPageHeaderPresentation = 'auto';\n\n  /** Available page-header capacity supplied by the owning application shell. */\n  @Prop() headerCapacity?: ShellPageCapacity;\n\n  /** Standard page gutters, or no inset for full-bleed page content. */\n  @Prop() contentInset: ShellPageContentInset = 'default';\n\n  @State() private pageTopVisible = true;\n\n  private sentinelEl: HTMLElement | null = null;\n  private spacerEl: HTMLElement | null = null;\n  private stickyHeaderEl: HTMLElement | null = null;\n  private headerEl: BarTitleElement | null = null;\n  private expandedHeaderHeight = 0;\n  private headerTravel = 0;\n  private expandedGeometryFrozen = false;\n  private headerResizeObserver: ResizeObserver | null = null;\n  private headerMutationObserver: MutationObserver | null = null;\n  private headerRevealFrame: number | null = null;\n  private headerGeometryFrame: number | null = null;\n  private scrollRoot: HTMLElement | Window | null = null;\n\n  @Watch('headerCapacity')\n  @Watch('headerPresentation')\n  handleHeaderContractChange() {\n    this.syncHeaderVariant(true);\n  }\n\n  componentDidLoad() {\n    this.observeHeader(this.findHeader());\n    this.connectScrollRoot();\n  }\n\n  componentDidRender() {\n    this.syncHeaderVariant();\n  }\n\n  disconnectedCallback() {\n    this.headerResizeObserver?.disconnect();\n    this.headerResizeObserver = null;\n    this.headerMutationObserver?.disconnect();\n    this.headerMutationObserver = null;\n    this.cancelHeaderReveal();\n    this.cancelHeaderGeometrySync();\n    this.scrollRoot?.removeEventListener('scroll', this.handleScroll);\n    this.scrollRoot = null;\n  }\n\n  private get effectiveVariant(): BarTitleVariant {\n    return resolveShellPageHeaderVariant(\n      this.headerPresentation,\n      this.headerCapacity ?? 'roomy',\n      this.pageTopVisible\n    );\n  }\n\n  private get headerContractResolved(): boolean {\n    return this.headerPresentation !== 'auto' || this.headerCapacity !== undefined;\n  }\n\n  private get isScrollCompacted(): boolean {\n    return (\n      this.headerPresentation === 'auto' && this.headerCapacity === 'roomy' && !this.pageTopVisible\n    );\n  }\n\n  private composedParent(element: Element): Element | null {\n    return (element as HTMLElement).assignedSlot?.parentElement ?? element.parentElement;\n  }\n\n  private findScrollRoot(): HTMLElement | Window {\n    let ancestor = this.composedParent(this.el);\n    while (ancestor && ancestor !== document.documentElement) {\n      const overflow = getComputedStyle(ancestor).overflowY;\n      if (overflow === 'auto' || overflow === 'scroll' || overflow === 'overlay') {\n        return ancestor as HTMLElement;\n      }\n      ancestor = this.composedParent(ancestor);\n    }\n    return window;\n  }\n\n  private connectScrollRoot() {\n    const next = this.findScrollRoot();\n    if (next === this.scrollRoot) return;\n    this.scrollRoot?.removeEventListener('scroll', this.handleScroll);\n    this.scrollRoot = next;\n    this.scrollRoot.addEventListener('scroll', this.handleScroll, { passive: true });\n    this.handleScroll();\n  }\n\n  private handleScroll = () => {\n    if (!this.sentinelEl || !this.scrollRoot) return;\n    const rootTop =\n      this.scrollRoot === window ? 0 : (this.scrollRoot as HTMLElement).getBoundingClientRect().top;\n    const nextPageTopVisible = this.sentinelEl.getBoundingClientRect().top >= rootTop;\n    if (\n      !nextPageTopVisible &&\n      this.pageTopVisible &&\n      this.headerEl?.classList.contains(this.variantClass('expanded'))\n    ) {\n      this.captureExpandedHeaderGeometry(this.headerEl);\n      this.expandedGeometryFrozen = true;\n    }\n    if (\n      nextPageTopVisible &&\n      this.expandedGeometryFrozen &&\n      this.el.getBoundingClientRect().top >= rootTop\n    ) {\n      this.expandedGeometryFrozen = false;\n      if (this.headerEl?.classList.contains(this.variantClass('expanded'))) {\n        this.captureExpandedHeaderGeometry(this.headerEl);\n      }\n    }\n    this.pageTopVisible = nextPageTopVisible;\n  };\n\n  private findHeader(): BarTitleElement | null {\n    return this.el.querySelector<BarTitleElement>('ds-bar-title');\n  }\n\n  private get compactHeaderHeight(): number {\n    return resolveCssLengthPx('--dimension-size-600', 0);\n  }\n\n  private setHeaderTravel(distance: number) {\n    const next = Math.max(0, distance);\n    if (Math.abs(next - this.headerTravel) < 0.5) return;\n    this.headerTravel = next;\n    this.el.style.setProperty('--ds-shell-page-header-travel', `${next}px`);\n    this.handleScroll();\n  }\n\n  private measureHeaderTravel(header: BarTitleElement) {\n    const anchor = header.querySelector<HTMLElement>('[data-shell-page-header-anchor]');\n    const compactHeight = this.compactHeaderHeight;\n    if (!anchor || compactHeight <= 0) return;\n\n    const headerRect = header.getBoundingClientRect();\n    const anchorRect = anchor.getBoundingClientRect();\n    if (headerRect.height <= 0 || anchorRect.height <= 0) return;\n\n    const expandedAnchorTop = anchorRect.top - headerRect.top;\n    const compactAnchorTop = Math.max(0, (compactHeight - anchorRect.height) / 2);\n    this.setHeaderTravel(expandedAnchorTop - compactAnchorTop);\n  }\n\n  private captureExpandedHeaderGeometry(header: BarTitleElement) {\n    this.expandedHeaderHeight = header.getBoundingClientRect().height;\n    this.measureHeaderTravel(header);\n  }\n\n  private setSpacerHeight(height: number) {\n    if (!this.spacerEl) return;\n    this.spacerEl.style.setProperty('--ds-shell-page-flow-spacer', `${Math.max(0, height)}px`);\n  }\n\n  private variantClass(variant: BarTitleVariant): string {\n    return `bar-title-host--${variant}`;\n  }\n\n  private setStickyHeaderOffset(renderedVariant: BarTitleVariant) {\n    this.stickyHeaderEl?.style.setProperty(\n      '--ds-shell-page-sticky-offset',\n      renderedVariant === 'expanded' &&\n        this.headerPresentation === 'auto' &&\n        this.headerCapacity === 'roomy'\n        ? `${-this.headerTravel}px`\n        : '0px'\n    );\n  }\n\n  private syncRenderedHeaderGeometry(header: BarTitleElement) {\n    const renderedVariant = this.effectiveVariant;\n    if (!header.classList.contains(this.variantClass(renderedVariant))) return;\n\n    // Update both flow-preservation pieces before reading layout. Otherwise a\n    // reverse compact → expanded render can briefly contain the tall header and\n    // the compact spacer together, giving browser scroll anchoring a transient\n    // height change to compensate.\n    this.setSpacerHeight(\n      this.isScrollCompacted ? this.expandedHeaderHeight - this.compactHeaderHeight : 0\n    );\n    this.setStickyHeaderOffset(renderedVariant);\n\n    if (renderedVariant === 'expanded' && !this.expandedGeometryFrozen) {\n      this.captureExpandedHeaderGeometry(header);\n      this.setStickyHeaderOffset(renderedVariant);\n    }\n  }\n\n  private cancelHeaderGeometrySync() {\n    if (this.headerGeometryFrame !== null) cancelAnimationFrame(this.headerGeometryFrame);\n    this.headerGeometryFrame = null;\n  }\n\n  private scheduleHeaderGeometrySync(header: BarTitleElement) {\n    this.cancelHeaderGeometrySync();\n    let framesRemaining = ShellPage.MAX_HEADER_GEOMETRY_FRAMES;\n    let framesElapsed = 0;\n    const sync = () => {\n      if (this.headerEl !== header) return;\n      framesRemaining -= 1;\n      framesElapsed += 1;\n      // In WebKit a child's componentDidLoad can precede its assignment into\n      // the parent's rendered slot. Revalidate after ShellApp has had a frame\n      // to expose the actual content scroller.\n      this.connectScrollRoot();\n      this.syncRenderedHeaderGeometry(header);\n      const geometryReady =\n        this.effectiveVariant !== 'expanded' ||\n        (this.expandedHeaderHeight > 0 && this.headerTravel > 0);\n      if ((geometryReady && framesElapsed >= 2) || framesRemaining <= 0) {\n        this.headerGeometryFrame = null;\n        return;\n      }\n      this.headerGeometryFrame = requestAnimationFrame(sync);\n    };\n    this.headerGeometryFrame = requestAnimationFrame(sync);\n  }\n\n  private cancelHeaderReveal() {\n    if (this.headerRevealFrame !== null) cancelAnimationFrame(this.headerRevealFrame);\n    this.headerRevealFrame = null;\n    this.headerEl?.removeAttribute('data-shell-page-syncing');\n  }\n\n  private revealHeaderWhenSynced(header: BarTitleElement, variant: BarTitleVariant) {\n    // Stencil normally re-renders within a frame or two of a prop change. Stop\n    // polling at the cap, but fail closed: a stale variant must never paint.\n    let framesRemaining = ShellPage.MAX_HEADER_REVEAL_FRAMES;\n    const reveal = () => {\n      if (this.headerEl !== header) {\n        header.removeAttribute('data-shell-page-syncing');\n        return;\n      }\n      framesRemaining -= 1;\n      if (header.classList.contains(this.variantClass(variant))) {\n        header.removeAttribute('data-shell-page-syncing');\n        this.headerRevealFrame = null;\n        return;\n      }\n      if (framesRemaining <= 0) {\n        this.headerRevealFrame = null;\n        return;\n      }\n      this.headerRevealFrame = requestAnimationFrame(reveal);\n    };\n    this.headerRevealFrame = requestAnimationFrame(reveal);\n  }\n\n  private syncHeaderVariant(concealUntilSynced = false) {\n    const header = this.headerEl;\n    if (!header) return;\n\n    if (!this.headerContractResolved) {\n      this.cancelHeaderReveal();\n      header.setAttribute('data-shell-page-syncing', '');\n      return;\n    }\n\n    const next = this.effectiveVariant;\n    const renderedVariantIsStale = !header.classList.contains(this.variantClass(next));\n    if (!renderedVariantIsStale) this.syncRenderedHeaderGeometry(header);\n    if (concealUntilSynced) {\n      this.cancelHeaderReveal();\n      header.setAttribute('data-shell-page-syncing', '');\n    }\n    if (header.variant !== next) header.variant = next;\n    if (concealUntilSynced) {\n      this.revealHeaderWhenSynced(header, next);\n    }\n  }\n\n  private observeHeader(header: BarTitleElement | null) {\n    this.cancelHeaderReveal();\n    this.cancelHeaderGeometrySync();\n    this.headerResizeObserver?.disconnect();\n    this.headerResizeObserver = null;\n    this.headerMutationObserver?.disconnect();\n    this.headerMutationObserver = null;\n    this.headerEl = header;\n    this.expandedHeaderHeight = 0;\n    this.expandedGeometryFrozen = false;\n    this.setHeaderTravel(0);\n    this.setSpacerHeight(0);\n    this.stickyHeaderEl?.style.setProperty('--ds-shell-page-sticky-offset', '0px');\n\n    if (!header) return;\n    if (header.classList.contains(this.variantClass('expanded'))) {\n      this.captureExpandedHeaderGeometry(header);\n    }\n    if (typeof ResizeObserver !== 'undefined') {\n      this.headerResizeObserver = new ResizeObserver(() => {\n        this.syncRenderedHeaderGeometry(header);\n      });\n      this.headerResizeObserver.observe(header);\n    }\n    if (typeof MutationObserver !== 'undefined') {\n      this.headerMutationObserver = new MutationObserver(() => {\n        this.syncRenderedHeaderGeometry(header);\n      });\n      this.headerMutationObserver.observe(header, {\n        attributes: true,\n        attributeFilter: ['class'],\n      });\n    }\n    this.syncHeaderVariant(true);\n    this.scheduleHeaderGeometrySync(header);\n  }\n\n  private handleHeaderSlotChange = (event: Event) => {\n    const slot = event.target as HTMLSlotElement;\n    const header = slot\n      .assignedElements()\n      .find(element => element.tagName.toLowerCase() === 'ds-bar-title');\n    this.observeHeader((header as BarTitleElement | undefined) ?? null);\n  };\n\n  render() {\n    return (\n      <Host\n        role=\"main\"\n        class={{\n          'shell-page-host--inset-default': this.contentInset === 'default',\n          'shell-page-host--inset-none': this.contentInset === 'none',\n          [`shell-page-host--header-${this.effectiveVariant}`]: true,\n        }}\n      >\n        <div\n          ref={el => {\n            this.sentinelEl = el ?? null;\n          }}\n          class=\"shell-page__scroll-sentinel\"\n          aria-hidden=\"true\"\n        />\n        <div\n          ref={el => {\n            this.stickyHeaderEl = el ?? null;\n          }}\n          class=\"shell-page__sticky-header\"\n        >\n          <slot name=\"header\" onSlotchange={this.handleHeaderSlotChange} />\n        </div>\n        <div\n          ref={el => {\n            this.spacerEl = el ?? null;\n          }}\n          class=\"shell-page__flow-spacer\"\n          aria-hidden=\"true\"\n        />\n        <div class=\"shell-page__content\">\n          <slot />\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { Component, Element, h, Host, Prop, State, Watch } from '@stencil/core';\nimport type { ShellResponsiveMode } from '../../shell/shell-responsive';\nimport { resolveCssLengthPx } from '../../utils/resolve-css-length-px';\nimport type { BarTitleVariant } from '../BarTitle/bar-title-types';\nimport { resolveShellPageHeaderVariant } from './shell-page-responsive';\nimport type {\n  ShellPageCapacity,\n  ShellPageContentInset,\n  ShellPageHeaderPresentation,\n} from './shell-page-types';\n\ntype BarTitleElement = HTMLElement & { variant: BarTitleVariant };\n\n@Component({\n  tag: 'ds-shell-page',\n  styleUrl: 'ShellPage.css',\n  scoped: true,\n})\nexport class ShellPage {\n  private static readonly MAX_HEADER_REVEAL_FRAMES = 12;\n  private static readonly MAX_HEADER_GEOMETRY_FRAMES = 12;\n\n  @Element() el!: HTMLElement;\n\n  /** Automatic capacity/scroll behavior, or an explicit header variant override. */\n  @Prop() headerPresentation: ShellPageHeaderPresentation = 'auto';\n\n  /** Available page-header capacity supplied by the owning application shell. */\n  @Prop() headerCapacity?: ShellPageCapacity;\n\n  /** Standard page gutters, or no inset for full-bleed page content. */\n  @Prop() contentInset: ShellPageContentInset = 'default';\n\n  /** Explicit shell breakpoint presentation. Mobile uses the dedicated mobile-header slot. */\n  @Prop({ attribute: 'responsive-mode', reflect: true })\n  responsiveMode: ShellResponsiveMode = 'desktop';\n\n  @State() private pageTopVisible = true;\n\n  private sentinelEl: HTMLElement | null = null;\n  private spacerEl: HTMLElement | null = null;\n  private stickyHeaderEl: HTMLElement | null = null;\n  private headerEl: BarTitleElement | null = null;\n  private expandedHeaderHeight = 0;\n  private headerTravel = 0;\n  private expandedGeometryFrozen = false;\n  private headerResizeObserver: ResizeObserver | null = null;\n  private headerMutationObserver: MutationObserver | null = null;\n  private headerRevealFrame: number | null = null;\n  private headerGeometryFrame: number | null = null;\n  private scrollRoot: HTMLElement | Window | null = null;\n\n  @Watch('headerCapacity')\n  @Watch('headerPresentation')\n  handleHeaderContractChange() {\n    this.syncHeaderVariant(true);\n  }\n\n  @Watch('responsiveMode')\n  handleResponsiveModeChange() {\n    this.observeHeader(this.responsiveMode === 'mobile' ? null : this.findHeader());\n  }\n\n  componentDidLoad() {\n    this.observeHeader(this.responsiveMode === 'mobile' ? null : this.findHeader());\n    this.connectScrollRoot();\n  }\n\n  componentDidRender() {\n    this.syncHeaderVariant();\n  }\n\n  disconnectedCallback() {\n    this.headerResizeObserver?.disconnect();\n    this.headerResizeObserver = null;\n    this.headerMutationObserver?.disconnect();\n    this.headerMutationObserver = null;\n    this.cancelHeaderReveal();\n    this.cancelHeaderGeometrySync();\n    this.scrollRoot?.removeEventListener('scroll', this.handleScroll);\n    this.scrollRoot = null;\n  }\n\n  private get effectiveVariant(): BarTitleVariant {\n    return resolveShellPageHeaderVariant(\n      this.headerPresentation,\n      this.headerCapacity ?? 'roomy',\n      this.pageTopVisible\n    );\n  }\n\n  private get headerContractResolved(): boolean {\n    return this.headerPresentation !== 'auto' || this.headerCapacity !== undefined;\n  }\n\n  private get isScrollCompacted(): boolean {\n    return (\n      this.headerPresentation === 'auto' && this.headerCapacity === 'roomy' && !this.pageTopVisible\n    );\n  }\n\n  private composedParent(element: Element): Element | null {\n    return (element as HTMLElement).assignedSlot?.parentElement ?? element.parentElement;\n  }\n\n  private findScrollRoot(): HTMLElement | Window {\n    let ancestor = this.composedParent(this.el);\n    while (ancestor && ancestor !== document.documentElement) {\n      const overflow = getComputedStyle(ancestor).overflowY;\n      if (overflow === 'auto' || overflow === 'scroll' || overflow === 'overlay') {\n        return ancestor as HTMLElement;\n      }\n      ancestor = this.composedParent(ancestor);\n    }\n    return window;\n  }\n\n  private connectScrollRoot() {\n    const next = this.findScrollRoot();\n    if (next === this.scrollRoot) return;\n    this.scrollRoot?.removeEventListener('scroll', this.handleScroll);\n    this.scrollRoot = next;\n    this.scrollRoot.addEventListener('scroll', this.handleScroll, { passive: true });\n    this.handleScroll();\n  }\n\n  private handleScroll = () => {\n    if (!this.sentinelEl || !this.scrollRoot) return;\n    const rootTop =\n      this.scrollRoot === window ? 0 : (this.scrollRoot as HTMLElement).getBoundingClientRect().top;\n    const nextPageTopVisible = this.sentinelEl.getBoundingClientRect().top >= rootTop;\n    if (\n      !nextPageTopVisible &&\n      this.pageTopVisible &&\n      this.headerEl?.classList.contains(this.variantClass('expanded'))\n    ) {\n      this.captureExpandedHeaderGeometry(this.headerEl);\n      this.expandedGeometryFrozen = true;\n    }\n    if (\n      nextPageTopVisible &&\n      this.expandedGeometryFrozen &&\n      this.el.getBoundingClientRect().top >= rootTop\n    ) {\n      this.expandedGeometryFrozen = false;\n      if (this.headerEl?.classList.contains(this.variantClass('expanded'))) {\n        this.captureExpandedHeaderGeometry(this.headerEl);\n      }\n    }\n    this.pageTopVisible = nextPageTopVisible;\n  };\n\n  private findHeader(): BarTitleElement | null {\n    return this.el.querySelector<BarTitleElement>('ds-bar-title');\n  }\n\n  private get compactHeaderHeight(): number {\n    return resolveCssLengthPx('--dimension-size-600', 0);\n  }\n\n  private setHeaderTravel(distance: number) {\n    const next = Math.max(0, distance);\n    if (Math.abs(next - this.headerTravel) < 0.5) return;\n    this.headerTravel = next;\n    this.el.style.setProperty('--ds-shell-page-header-travel', `${next}px`);\n    this.handleScroll();\n  }\n\n  private measureHeaderTravel(header: BarTitleElement) {\n    const anchor = header.querySelector<HTMLElement>('[data-shell-page-header-anchor]');\n    const compactHeight = this.compactHeaderHeight;\n    if (!anchor || compactHeight <= 0) return;\n\n    const headerRect = header.getBoundingClientRect();\n    const anchorRect = anchor.getBoundingClientRect();\n    if (headerRect.height <= 0 || anchorRect.height <= 0) return;\n\n    const expandedAnchorTop = anchorRect.top - headerRect.top;\n    const compactAnchorTop = Math.max(0, (compactHeight - anchorRect.height) / 2);\n    this.setHeaderTravel(expandedAnchorTop - compactAnchorTop);\n  }\n\n  private captureExpandedHeaderGeometry(header: BarTitleElement) {\n    this.expandedHeaderHeight = header.getBoundingClientRect().height;\n    this.measureHeaderTravel(header);\n  }\n\n  private setSpacerHeight(height: number) {\n    if (!this.spacerEl) return;\n    this.spacerEl.style.setProperty('--ds-shell-page-flow-spacer', `${Math.max(0, height)}px`);\n  }\n\n  private variantClass(variant: BarTitleVariant): string {\n    return `bar-title-host--${variant}`;\n  }\n\n  private setStickyHeaderOffset(renderedVariant: BarTitleVariant) {\n    this.stickyHeaderEl?.style.setProperty(\n      '--ds-shell-page-sticky-offset',\n      renderedVariant === 'expanded' &&\n        this.headerPresentation === 'auto' &&\n        this.headerCapacity === 'roomy'\n        ? `${-this.headerTravel}px`\n        : '0px'\n    );\n  }\n\n  private syncRenderedHeaderGeometry(header: BarTitleElement) {\n    const renderedVariant = this.effectiveVariant;\n    if (!header.classList.contains(this.variantClass(renderedVariant))) return;\n\n    // Update both flow-preservation pieces before reading layout. Otherwise a\n    // reverse compact → expanded render can briefly contain the tall header and\n    // the compact spacer together, giving browser scroll anchoring a transient\n    // height change to compensate.\n    this.setSpacerHeight(\n      this.isScrollCompacted ? this.expandedHeaderHeight - this.compactHeaderHeight : 0\n    );\n    this.setStickyHeaderOffset(renderedVariant);\n\n    if (renderedVariant === 'expanded' && !this.expandedGeometryFrozen) {\n      this.captureExpandedHeaderGeometry(header);\n      this.setStickyHeaderOffset(renderedVariant);\n    }\n  }\n\n  private cancelHeaderGeometrySync() {\n    if (this.headerGeometryFrame !== null) cancelAnimationFrame(this.headerGeometryFrame);\n    this.headerGeometryFrame = null;\n  }\n\n  private scheduleHeaderGeometrySync(header: BarTitleElement) {\n    this.cancelHeaderGeometrySync();\n    let framesRemaining = ShellPage.MAX_HEADER_GEOMETRY_FRAMES;\n    let framesElapsed = 0;\n    const sync = () => {\n      if (this.headerEl !== header) return;\n      framesRemaining -= 1;\n      framesElapsed += 1;\n      // In WebKit a child's componentDidLoad can precede its assignment into\n      // the parent's rendered slot. Revalidate after ShellApp has had a frame\n      // to expose the actual content scroller.\n      this.connectScrollRoot();\n      this.syncRenderedHeaderGeometry(header);\n      const geometryReady =\n        this.effectiveVariant !== 'expanded' ||\n        (this.expandedHeaderHeight > 0 && this.headerTravel > 0);\n      if ((geometryReady && framesElapsed >= 2) || framesRemaining <= 0) {\n        this.headerGeometryFrame = null;\n        return;\n      }\n      this.headerGeometryFrame = requestAnimationFrame(sync);\n    };\n    this.headerGeometryFrame = requestAnimationFrame(sync);\n  }\n\n  private cancelHeaderReveal() {\n    if (this.headerRevealFrame !== null) cancelAnimationFrame(this.headerRevealFrame);\n    this.headerRevealFrame = null;\n    this.headerEl?.removeAttribute('data-shell-page-syncing');\n  }\n\n  private revealHeaderWhenSynced(header: BarTitleElement, variant: BarTitleVariant) {\n    // Stencil normally re-renders within a frame or two of a prop change. Stop\n    // polling at the cap, but fail closed: a stale variant must never paint.\n    let framesRemaining = ShellPage.MAX_HEADER_REVEAL_FRAMES;\n    const reveal = () => {\n      if (this.headerEl !== header) {\n        header.removeAttribute('data-shell-page-syncing');\n        return;\n      }\n      framesRemaining -= 1;\n      if (header.classList.contains(this.variantClass(variant))) {\n        header.removeAttribute('data-shell-page-syncing');\n        this.headerRevealFrame = null;\n        return;\n      }\n      if (framesRemaining <= 0) {\n        this.headerRevealFrame = null;\n        return;\n      }\n      this.headerRevealFrame = requestAnimationFrame(reveal);\n    };\n    this.headerRevealFrame = requestAnimationFrame(reveal);\n  }\n\n  private syncHeaderVariant(concealUntilSynced = false) {\n    const header = this.headerEl;\n    if (!header) return;\n\n    if (!this.headerContractResolved) {\n      this.cancelHeaderReveal();\n      header.setAttribute('data-shell-page-syncing', '');\n      return;\n    }\n\n    const next = this.effectiveVariant;\n    const renderedVariantIsStale = !header.classList.contains(this.variantClass(next));\n    if (!renderedVariantIsStale) this.syncRenderedHeaderGeometry(header);\n    if (concealUntilSynced) {\n      this.cancelHeaderReveal();\n      header.setAttribute('data-shell-page-syncing', '');\n    }\n    if (header.variant !== next) header.variant = next;\n    if (concealUntilSynced) {\n      this.revealHeaderWhenSynced(header, next);\n    }\n  }\n\n  private observeHeader(header: BarTitleElement | null) {\n    this.cancelHeaderReveal();\n    this.cancelHeaderGeometrySync();\n    this.headerResizeObserver?.disconnect();\n    this.headerResizeObserver = null;\n    this.headerMutationObserver?.disconnect();\n    this.headerMutationObserver = null;\n    this.headerEl = header;\n    this.expandedHeaderHeight = 0;\n    this.expandedGeometryFrozen = false;\n    this.setHeaderTravel(0);\n    this.setSpacerHeight(0);\n    this.stickyHeaderEl?.style.setProperty('--ds-shell-page-sticky-offset', '0px');\n\n    if (!header) return;\n    if (header.classList.contains(this.variantClass('expanded'))) {\n      this.captureExpandedHeaderGeometry(header);\n    }\n    if (typeof ResizeObserver !== 'undefined') {\n      this.headerResizeObserver = new ResizeObserver(() => {\n        this.syncRenderedHeaderGeometry(header);\n      });\n      this.headerResizeObserver.observe(header);\n    }\n    if (typeof MutationObserver !== 'undefined') {\n      this.headerMutationObserver = new MutationObserver(() => {\n        this.syncRenderedHeaderGeometry(header);\n      });\n      this.headerMutationObserver.observe(header, {\n        attributes: true,\n        attributeFilter: ['class'],\n      });\n    }\n    this.syncHeaderVariant(true);\n    this.scheduleHeaderGeometrySync(header);\n  }\n\n  private handleHeaderSlotChange = (event: Event) => {\n    if (this.responsiveMode === 'mobile') return;\n    const slot = event.target as HTMLSlotElement;\n    const header = slot\n      .assignedElements()\n      .find(element => element.tagName.toLowerCase() === 'ds-bar-title');\n    this.observeHeader((header as BarTitleElement | undefined) ?? null);\n  };\n\n  render() {\n    const mobile = this.responsiveMode === 'mobile';\n    return (\n      <Host\n        role=\"main\"\n        class={{\n          'shell-page-host--inset-default': this.contentInset === 'default',\n          'shell-page-host--inset-none': this.contentInset === 'none',\n          'shell-page-host--mobile': mobile,\n          [`shell-page-host--header-${this.effectiveVariant}`]: true,\n        }}\n      >\n        <div\n          ref={el => {\n            this.sentinelEl = el ?? null;\n          }}\n          class=\"shell-page__scroll-sentinel\"\n          aria-hidden=\"true\"\n        />\n        <div\n          ref={el => {\n            this.stickyHeaderEl = el ?? null;\n          }}\n          class=\"shell-page__sticky-header\"\n        >\n          <div\n            class=\"shell-page__desktop-header\"\n            hidden={mobile}\n            aria-hidden={mobile ? 'true' : undefined}\n            inert={mobile ? true : undefined}\n          >\n            <slot name=\"header\" onSlotchange={this.handleHeaderSlotChange} />\n          </div>\n          <div\n            class=\"shell-page__mobile-header\"\n            hidden={!mobile}\n            aria-hidden={!mobile ? 'true' : undefined}\n            inert={!mobile ? true : undefined}\n          >\n            <slot name=\"mobile-header\" />\n          </div>\n        </div>\n        <div\n          ref={el => {\n            this.spacerEl = el ?? null;\n          }}\n          class=\"shell-page__flow-spacer\"\n          aria-hidden=\"true\"\n        />\n        <div class=\"shell-page__content\">\n          <slot />\n        </div>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     },
     {

package/dist/mcp-data/registry/shell-tools.json

@@ -31,7 +31,9 @@
       "commonlyComposedWith": [
         "component:ds-shell-app",
         "component:ds-panel-tool-header",
-        "component:ds-shell-mobile-bar"
+        "component:ds-mobile-header",
+        "component:ds-mobile-section-switcher",
+        "component:ds-mobile-bar-nav"
       ],
       "patterns": [
         "pattern:application-shell"
@@ -39,7 +41,7 @@
       "accessibility": [
         "Only the active mobile tool view participates in focus or the accessibility tree.",
         "Header Back and application-owned header actions preserve the PanelTools event contract.",
-        "Inbox uses TabGroup semantics for Messages, Stacks, and Activity."
+        "Inbox uses the MobileSectionSwitcher popup trigger for Messages, Stacks, and Activity and never relies on a gesture-only interaction."
       ],
       "states": [
         "The application owns open and activeTool and replaces headers when tool depth changes.",
@@ -48,7 +50,7 @@
       ],
       "responsiveBehavior": [
         "Desktop and tablet compose PanelTools-compatible rail and drawer chrome.",
-        "Mobile renders the active tool across the shell stage and groups available inbox tools in a segmented control."
+        "Mobile renders one centered MobileHeader for every tool and presents Messages, Stacks, and Activity directly as peer section titles without an additional Inbox heading."
       ],
       "frameworkCaveats": {
         "customElements": [
@@ -431,19 +433,20 @@
     "@ds-mo/tokens"
   ],
   "registryDependencies": [
-    "panel-tool-header",
+    "button-unfilled",
+    "mobile-header",
     "panel-tools",
-    "tab-group"
+    "tooltip"
   ],
   "files": [
     {
       "path": "src/wc/components/ShellTools/ShellTools.css",
-      "content": ":host {\n  display: block;\n  min-width: 0;\n  min-height: 0;\n  height: 100%;\n  background: transparent;\n}\n\n:host([responsive-mode='mobile']) {\n  width: 100%;\n  background: var(--color-background-primary);\n}\n\n.shell-tools__desktop,\n.shell-tools__desktop ds-panel-tools,\n.shell-tools__mobile {\n  display: block;\n  min-width: 0;\n  min-height: 0;\n  height: 100%;\n}\n\n.shell-tools__mobile {\n  display: grid;\n  grid-template-rows: auto auto minmax(0, 1fr);\n  background: var(--color-background-primary);\n}\n\n.shell-tools__inbox-nav {\n  padding: var(--dimension-space-100);\n  border-bottom: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n  background: var(--color-background-primary);\n}\n\n.shell-tools__mobile-body,\n.shell-tools__view {\n  min-width: 0;\n  min-height: 0;\n  height: 100%;\n}\n\n.shell-tools__mobile-body {\n  overflow: hidden;\n}\n\n.shell-tools__view {\n  overflow: auto;\n  overscroll-behavior: contain;\n}\n\n.shell-tools__view[hidden] {\n  display: none;\n}\n\n.shell-tools__view ::slotted(*) {\n  min-height: 0;\n}\n",
+      "content": ":host {\n  display: block;\n  min-width: 0;\n  min-height: 0;\n  height: 100%;\n  background: transparent;\n}\n\n:host([responsive-mode='mobile']) {\n  width: 100%;\n  background: var(--color-background-primary);\n}\n\n.shell-tools__desktop,\n.shell-tools__desktop ds-panel-tools,\n.shell-tools__mobile {\n  display: block;\n  min-width: 0;\n  min-height: 0;\n  height: 100%;\n}\n\n.shell-tools__mobile {\n  display: grid;\n  grid-template-rows: auto minmax(0, 1fr);\n  background: var(--color-background-primary);\n}\n\n.shell-tools__mobile-header {\n  grid-row: 1;\n}\n\n.shell-tools__mobile-body,\n.shell-tools__view {\n  min-width: 0;\n  min-height: 0;\n  height: 100%;\n}\n\n.shell-tools__mobile-body {\n  grid-row: 2;\n  overflow: hidden;\n}\n\n.shell-tools__view {\n  overflow: auto;\n  overscroll-behavior: contain;\n}\n\n.shell-tools__view[hidden] {\n  display: none;\n}\n\n.shell-tools__view ::slotted(*) {\n  min-height: 0;\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/ShellTools/ShellTools.tsx",
-      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Method,\n  Prop,\n  Watch,\n} from '@stencil/core';\nimport {\n  PANEL_TOOLS_LABELS,\n  PANEL_TOOLS_TOOL_IDS,\n  type PanelToolsHeaderAction,\n  type PanelToolsHeaderConfig,\n  type PanelToolsHeaders,\n  type PanelToolsItem,\n  type PanelToolsToolId,\n} from '../PanelTools/panel-tools-types';\nimport {\n  parsePanelToolsItems,\n  reconcilePanelToolsAvailability,\n  resolvePanelToolActivation,\n} from '../PanelTools/panel-tools-utils';\nimport {\n  isShellInboxTool,\n  resolveAvailableInboxTool,\n  type ShellInboxToolId,\n  type ShellResponsiveMode,\n} from '../../shell/shell-responsive';\n\nconst MOBILE_VIEW_ORDER: PanelToolsToolId[] = [\n  'search',\n  'agents',\n  'messages',\n  'stacks',\n  'activity',\n  'help',\n];\n\n@Component({\n  tag: 'ds-shell-tools',\n  styleUrl: 'ShellTools.css',\n  scoped: true,\n})\nexport class ShellTools {\n  @Element() el!: HTMLElement;\n\n  /** Resolved by ShellApp; mobile uses a full-stage tool presentation. */\n  @Prop({ attribute: 'responsive-mode', reflect: true })\n  responsiveMode: ShellResponsiveMode = 'desktop';\n  @Prop({ mutable: true, reflect: true }) open: boolean = false;\n  @Prop({ mutable: true, attribute: 'active-tool', reflect: true })\n  activeTool: PanelToolsToolId | '' = '';\n  @Prop({ mutable: true, reflect: true }) presentation: 'drawer' | 'fullscreen' = 'drawer';\n  @Prop({ attribute: 'fullscreen-header-mode', reflect: true })\n  fullscreenHeaderMode: 'shared' | 'split' = 'shared';\n  @Prop() items: PanelToolsItem[] = [];\n  @Prop({ attribute: 'items-json' }) itemsJson: string = '';\n  @Prop() headers: PanelToolsHeaders = {};\n  @Prop({ attribute: 'headers-json' }) headersJson: string = '';\n  @Prop({ attribute: 'storage-key' }) storageKey: string = '';\n  @Prop() toolsLabel: string = 'Tools';\n  @Prop() toolShortcutsLabel: string = 'Tool shortcuts';\n  @Prop() inboxLabel: string = 'Inbox';\n  @Prop() inboxNavigationLabel: string = 'Inbox sections';\n\n  @Event({ bubbles: true, composed: true }) dsToolChange!: EventEmitter<{\n    id: PanelToolsToolId;\n    selected: boolean;\n  }>;\n  @Event({ bubbles: true, composed: true }) dsPresentationChange!: EventEmitter<{\n    presentation: 'drawer' | 'fullscreen';\n  }>;\n  @Event({ bubbles: true, composed: true }) dsHeaderBack!: EventEmitter<{\n    tool: PanelToolsToolId;\n  }>;\n  @Event({ bubbles: true, composed: true }) dsHeaderAction!: EventEmitter<{\n    tool: PanelToolsToolId;\n    id: string;\n  }>;\n\n  private panelToolsEl: HTMLDsPanelToolsElement | null = null;\n\n  private get resolvedItems(): PanelToolsItem[] {\n    return parsePanelToolsItems(this.items, this.itemsJson);\n  }\n\n  private get availableInboxTools(): ShellInboxToolId[] {\n    return this.resolvedItems\n      .filter(item => !item.isInactive && isShellInboxTool(item.id))\n      .map(item => item.id as ShellInboxToolId);\n  }\n\n  private get mobileActiveTool(): PanelToolsToolId | '' {\n    if (!isShellInboxTool(this.activeTool)) return this.activeTool;\n    return resolveAvailableInboxTool(this.activeTool, this.availableInboxTools);\n  }\n\n  componentWillLoad() {\n    this.reconcileAvailability();\n  }\n\n  @Watch('items')\n  @Watch('itemsJson')\n  handleItemsChange() {\n    this.reconcileAvailability();\n  }\n\n  private reconcileAvailability() {\n    const next = reconcilePanelToolsAvailability(this.resolvedItems, this.open, this.activeTool);\n    this.open = next.open;\n    this.activeTool = next.activeTool;\n  }\n\n  private resolvedHeaders(): PanelToolsHeaders {\n    if (Object.keys(this.headers).length) return this.headers;\n    if (!this.headersJson.trim()) return {};\n    try {\n      const parsed = JSON.parse(this.headersJson);\n      return parsed && typeof parsed === 'object' && !Array.isArray(parsed)\n        ? (parsed as PanelToolsHeaders)\n        : {};\n    } catch {\n      return {};\n    }\n  }\n\n  private activeHeader(tool: PanelToolsToolId): PanelToolsHeaderConfig {\n    return this.resolvedHeaders()[tool] ?? {};\n  }\n\n  private activateMobileTool(id: PanelToolsToolId) {\n    const item = this.resolvedItems.find(entry => entry.id === id);\n    if (!item || item.isInactive) return;\n    const next = resolvePanelToolActivation(this.open, this.activeTool, id);\n    this.open = next.open;\n    this.activeTool = next.activeTool;\n    this.dsToolChange.emit({ id, selected: next.selected });\n  }\n\n  private selectInboxTool = (event: CustomEvent<string>) => {\n    const id = event.detail;\n    if (!isShellInboxTool(id) || id === this.mobileActiveTool) return;\n    this.open = true;\n    this.activeTool = id;\n    this.dsToolChange.emit({ id, selected: true });\n  };\n\n  private handlePanelToolChange = (\n    event: CustomEvent<{ id: PanelToolsToolId; selected: boolean }>\n  ) => {\n    this.activeTool = event.detail.id;\n    this.open = event.detail.selected;\n  };\n\n  private handlePanelPresentationChange = (\n    event: CustomEvent<{ presentation: 'drawer' | 'fullscreen' }>\n  ) => {\n    this.presentation = event.detail.presentation;\n  };\n\n  private handleMobileHeaderAction = (\n    tool: PanelToolsToolId,\n    event: CustomEvent<{ id: string }>\n  ) => {\n    event.stopPropagation();\n    this.dsHeaderAction.emit({ tool, id: event.detail.id });\n  };\n\n  /** Match PanelTools' imperative activation contract in every responsive mode. */\n  @Method()\n  async activateTool(id: PanelToolsToolId) {\n    if (this.responsiveMode !== 'mobile') {\n      await this.panelToolsEl?.activateTool(id);\n      return;\n    }\n    this.activateMobileTool(id);\n  }\n\n  /** Close the active global tool surface. */\n  @Method()\n  async closeDrawer() {\n    if (this.responsiveMode !== 'mobile') {\n      await this.panelToolsEl?.closeDrawer();\n      return;\n    }\n    if (!this.open) return;\n    const id = this.activeTool;\n    this.open = false;\n    if (id) this.dsToolChange.emit({ id, selected: false });\n  }\n\n  /** Focus an application-owned action in the visible shared tool header. */\n  @Method()\n  async focusHeaderAction(id: string) {\n    if (this.responsiveMode !== 'mobile') {\n      await this.panelToolsEl?.focusHeaderAction(id);\n      return;\n    }\n    const action = this.el.querySelector(`[data-header-action-id=\"${CSS.escape(id)}\"]`) as\n      | (HTMLElement & { setFocus?: () => Promise<void> })\n      | null;\n    await action?.setFocus?.();\n  }\n\n  private renderForwardedSlots() {\n    return PANEL_TOOLS_TOOL_IDS.flatMap(id => [\n      <slot name={id} slot={id} />,\n      <slot name={`${id}-view`} slot={`${id}-view`} />,\n    ]);\n  }\n\n  private renderDesktop() {\n    return (\n      <div class=\"shell-tools__desktop\">\n        <ds-panel-tools\n          open={this.open}\n          activeTool={this.activeTool}\n          presentation={this.presentation}\n          fullscreenHeaderMode={this.fullscreenHeaderMode}\n          items={this.resolvedItems}\n          headers={this.resolvedHeaders()}\n          storageKey={this.storageKey}\n          toolsLabel={this.toolsLabel}\n          toolShortcutsLabel={this.toolShortcutsLabel}\n          ref={element => {\n            this.panelToolsEl = element as HTMLDsPanelToolsElement | null;\n          }}\n          onDsToolChange={this.handlePanelToolChange}\n          onDsPresentationChange={this.handlePanelPresentationChange}\n        >\n          {this.renderForwardedSlots()}\n        </ds-panel-tools>\n      </div>\n    );\n  }\n\n  private renderMobileHeader(tool: PanelToolsToolId) {\n    const header = this.activeHeader(tool);\n    const configuredTitle = header.title?.trim();\n    const title = isShellInboxTool(tool)\n      ? header.showBack && configuredTitle\n        ? configuredTitle\n        : this.inboxLabel\n      : configuredTitle || PANEL_TOOLS_LABELS[tool];\n    const actions = (header.actions ?? []).filter(action => action.id !== 'fullscreen');\n\n    return (\n      <ds-panel-tool-header\n        class=\"shell-tools__mobile-header\"\n        heading={title}\n        showBack={header.showBack ?? false}\n        backIcon={header.backIcon || 'ChevronLeft'}\n        backAriaLabel={header.backAriaLabel || 'Back'}\n        showMenu={false}\n        ref={element => {\n          const toolHeader = element as\n            | (HTMLDsPanelToolHeaderElement & { actions: PanelToolsHeaderAction[] })\n            | undefined;\n          if (toolHeader) toolHeader.actions = actions;\n        }}\n        onDsBack={() => this.dsHeaderBack.emit({ tool })}\n        onDsAction={(event: CustomEvent<{ id: string }>) =>\n          this.handleMobileHeaderAction(tool, event)}\n      />\n    );\n  }\n\n  private renderMobile() {\n    const tool = this.mobileActiveTool;\n    const inboxTabs = this.availableInboxTools.map(id => ({\n      id,\n      label: PANEL_TOOLS_LABELS[id],\n    }));\n\n    return (\n      <div\n        class=\"shell-tools__mobile\"\n        aria-hidden={this.open && tool ? undefined : 'true'}\n        inert={this.open && tool ? undefined : true}\n      >\n        {tool ? this.renderMobileHeader(tool) : null}\n        {tool && isShellInboxTool(tool) && inboxTabs.length ? (\n          <div class=\"shell-tools__inbox-nav\">\n            <ds-tab-group\n              tabs={inboxTabs}\n              value={tool}\n              aria-label={this.inboxNavigationLabel}\n              onDsChange={this.selectInboxTool}\n            />\n          </div>\n        ) : null}\n        <div class=\"shell-tools__mobile-body\">\n          {MOBILE_VIEW_ORDER.map(id => {\n            const active = this.open && id === tool;\n            return (\n              <div\n                class={{\n                  'shell-tools__view': true,\n                  'shell-tools__view--active': active,\n                }}\n                hidden={!active}\n                aria-hidden={active ? undefined : 'true'}\n                inert={active ? undefined : true}\n              >\n                <slot name={`${id}-view`}>\n                  <slot name={id} />\n                </slot>\n              </div>\n            );\n          })}\n        </div>\n      </div>\n    );\n  }\n\n  render() {\n    const mobile = this.responsiveMode === 'mobile';\n    return (\n      <Host\n        role={\n          mobile\n            ? this.presentation === 'fullscreen'\n              ? 'dialog'\n              : 'complementary'\n            : undefined\n        }\n        aria-modal={mobile && this.presentation === 'fullscreen' ? 'true' : undefined}\n        aria-label={mobile ? this.toolsLabel : undefined}\n      >\n        {mobile ? this.renderMobile() : this.renderDesktop()}\n      </Host>\n    );\n  }\n}\n",
+      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Method,\n  Prop,\n  Watch,\n} from '@stencil/core';\nimport {\n  PANEL_TOOLS_LABELS,\n  PANEL_TOOLS_TOOL_IDS,\n  type PanelToolsHeaderConfig,\n  type PanelToolsHeaders,\n  type PanelToolsItem,\n  type PanelToolsToolId,\n} from '../PanelTools/panel-tools-types';\nimport {\n  parsePanelToolsItems,\n  reconcilePanelToolsAvailability,\n  resolvePanelToolActivation,\n} from '../PanelTools/panel-tools-utils';\nimport {\n  isShellInboxTool,\n  resolveAvailableInboxTool,\n  type ShellInboxToolId,\n  type ShellResponsiveMode,\n} from '../../shell/shell-responsive';\n\nconst MOBILE_VIEW_ORDER: PanelToolsToolId[] = [\n  'search',\n  'agents',\n  'messages',\n  'stacks',\n  'activity',\n  'help',\n];\n\n@Component({\n  tag: 'ds-shell-tools',\n  styleUrl: 'ShellTools.css',\n  scoped: true,\n})\nexport class ShellTools {\n  @Element() el!: HTMLElement;\n\n  /** Resolved by ShellApp; mobile uses a full-stage tool presentation. */\n  @Prop({ attribute: 'responsive-mode', reflect: true })\n  responsiveMode: ShellResponsiveMode = 'desktop';\n  @Prop({ mutable: true, reflect: true }) open: boolean = false;\n  @Prop({ mutable: true, attribute: 'active-tool', reflect: true })\n  activeTool: PanelToolsToolId | '' = '';\n  @Prop({ mutable: true, reflect: true }) presentation: 'drawer' | 'fullscreen' = 'drawer';\n  @Prop({ attribute: 'fullscreen-header-mode', reflect: true })\n  fullscreenHeaderMode: 'shared' | 'split' = 'shared';\n  @Prop() items: PanelToolsItem[] = [];\n  @Prop({ attribute: 'items-json' }) itemsJson: string = '';\n  @Prop() headers: PanelToolsHeaders = {};\n  @Prop({ attribute: 'headers-json' }) headersJson: string = '';\n  @Prop({ attribute: 'storage-key' }) storageKey: string = '';\n  @Prop() toolsLabel: string = 'Tools';\n  @Prop() toolShortcutsLabel: string = 'Tool shortcuts';\n  @Prop() inboxLabel: string = 'Inbox';\n  @Prop() inboxNavigationLabel: string = 'Inbox sections';\n\n  @Event({ bubbles: true, composed: true }) dsToolChange!: EventEmitter<{\n    id: PanelToolsToolId;\n    selected: boolean;\n  }>;\n  @Event({ bubbles: true, composed: true }) dsPresentationChange!: EventEmitter<{\n    presentation: 'drawer' | 'fullscreen';\n  }>;\n  @Event({ bubbles: true, composed: true }) dsHeaderBack!: EventEmitter<{\n    tool: PanelToolsToolId;\n  }>;\n  @Event({ bubbles: true, composed: true }) dsHeaderAction!: EventEmitter<{\n    tool: PanelToolsToolId;\n    id: string;\n  }>;\n\n  private panelToolsEl: HTMLDsPanelToolsElement | null = null;\n\n  private get resolvedItems(): PanelToolsItem[] {\n    return parsePanelToolsItems(this.items, this.itemsJson);\n  }\n\n  private get availableInboxTools(): ShellInboxToolId[] {\n    return this.resolvedItems\n      .filter(item => !item.isInactive && isShellInboxTool(item.id))\n      .map(item => item.id as ShellInboxToolId);\n  }\n\n  private get mobileActiveTool(): PanelToolsToolId | '' {\n    if (!isShellInboxTool(this.activeTool)) return this.activeTool;\n    return resolveAvailableInboxTool(this.activeTool, this.availableInboxTools);\n  }\n\n  componentWillLoad() {\n    this.reconcileAvailability();\n  }\n\n  @Watch('items')\n  @Watch('itemsJson')\n  handleItemsChange() {\n    this.reconcileAvailability();\n  }\n\n  private reconcileAvailability() {\n    const next = reconcilePanelToolsAvailability(this.resolvedItems, this.open, this.activeTool);\n    this.open = next.open;\n    this.activeTool = next.activeTool;\n  }\n\n  private resolvedHeaders(): PanelToolsHeaders {\n    if (Object.keys(this.headers).length) return this.headers;\n    if (!this.headersJson.trim()) return {};\n    try {\n      const parsed = JSON.parse(this.headersJson);\n      return parsed && typeof parsed === 'object' && !Array.isArray(parsed)\n        ? (parsed as PanelToolsHeaders)\n        : {};\n    } catch {\n      return {};\n    }\n  }\n\n  private activeHeader(tool: PanelToolsToolId): PanelToolsHeaderConfig {\n    return this.resolvedHeaders()[tool] ?? {};\n  }\n\n  private activateMobileTool(id: PanelToolsToolId) {\n    const item = this.resolvedItems.find(entry => entry.id === id);\n    if (!item || item.isInactive) return;\n    const next = resolvePanelToolActivation(this.open, this.activeTool, id);\n    this.open = next.open;\n    this.activeTool = next.activeTool;\n    this.dsToolChange.emit({ id, selected: next.selected });\n  }\n\n  private selectInboxTool = (event: CustomEvent<string>) => {\n    const id = event.detail;\n    if (!isShellInboxTool(id) || id === this.mobileActiveTool) return;\n    this.open = true;\n    this.activeTool = id;\n    this.dsToolChange.emit({ id, selected: true });\n  };\n\n  private handlePanelToolChange = (\n    event: CustomEvent<{ id: PanelToolsToolId; selected: boolean }>\n  ) => {\n    this.activeTool = event.detail.id;\n    this.open = event.detail.selected;\n  };\n\n  private handlePanelPresentationChange = (\n    event: CustomEvent<{ presentation: 'drawer' | 'fullscreen' }>\n  ) => {\n    this.presentation = event.detail.presentation;\n  };\n\n  private handleMobileHeaderAction = (\n    tool: PanelToolsToolId,\n    id: string,\n    event: CustomEvent<MouseEvent>\n  ) => {\n    event.stopPropagation();\n    this.dsHeaderAction.emit({ tool, id });\n  };\n\n  /** Match PanelTools' imperative activation contract in every responsive mode. */\n  @Method()\n  async activateTool(id: PanelToolsToolId) {\n    if (this.responsiveMode !== 'mobile') {\n      await this.panelToolsEl?.activateTool(id);\n      return;\n    }\n    this.activateMobileTool(id);\n  }\n\n  /** Close the active global tool surface. */\n  @Method()\n  async closeDrawer() {\n    if (this.responsiveMode !== 'mobile') {\n      await this.panelToolsEl?.closeDrawer();\n      return;\n    }\n    if (!this.open) return;\n    const id = this.activeTool;\n    this.open = false;\n    if (id) this.dsToolChange.emit({ id, selected: false });\n  }\n\n  /** Focus an application-owned action in the visible shared tool header. */\n  @Method()\n  async focusHeaderAction(id: string) {\n    if (this.responsiveMode !== 'mobile') {\n      await this.panelToolsEl?.focusHeaderAction(id);\n      return;\n    }\n    const action = this.el.querySelector(`[data-header-action-id=\"${CSS.escape(id)}\"]`) as\n      | (HTMLElement & { setFocus?: () => Promise<void> })\n      | null;\n    await action?.setFocus?.();\n  }\n\n  private renderForwardedSlots() {\n    return PANEL_TOOLS_TOOL_IDS.flatMap(id => [\n      <slot name={id} slot={id} />,\n      <slot name={`${id}-view`} slot={`${id}-view`} />,\n    ]);\n  }\n\n  private renderDesktop() {\n    return (\n      <div class=\"shell-tools__desktop\">\n        <ds-panel-tools\n          open={this.open}\n          activeTool={this.activeTool}\n          presentation={this.presentation}\n          fullscreenHeaderMode={this.fullscreenHeaderMode}\n          items={this.resolvedItems}\n          headers={this.resolvedHeaders()}\n          storageKey={this.storageKey}\n          toolsLabel={this.toolsLabel}\n          toolShortcutsLabel={this.toolShortcutsLabel}\n          ref={element => {\n            this.panelToolsEl = element as HTMLDsPanelToolsElement | null;\n          }}\n          onDsToolChange={this.handlePanelToolChange}\n          onDsPresentationChange={this.handlePanelPresentationChange}\n        >\n          {this.renderForwardedSlots()}\n        </ds-panel-tools>\n      </div>\n    );\n  }\n\n  private renderMobileHeader(tool: PanelToolsToolId) {\n    const header = this.activeHeader(tool);\n    const configuredTitle = header.title?.trim();\n    const title = configuredTitle || PANEL_TOOLS_LABELS[tool];\n    const actions = (header.actions ?? []).filter(action => action.id !== 'fullscreen');\n    const sections =\n      isShellInboxTool(tool) && !header.showBack\n        ? this.availableInboxTools.map(id => ({\n            id,\n            label: PANEL_TOOLS_LABELS[id],\n          }))\n        : [];\n\n    return (\n      <ds-mobile-header\n        class=\"shell-tools__mobile-header\"\n        heading={title}\n        headingLevel=\"h2\"\n        sections={sections}\n        value={tool}\n        sectionsAriaLabel={this.inboxNavigationLabel}\n        onDsSectionChange={this.selectInboxTool}\n      >\n        {header.showBack ? (\n          <ds-tooltip\n            slot=\"leading\"\n            label={header.backAriaLabel || 'Back'}\n            side=\"bottom\"\n            size=\"sm\"\n          >\n            <ds-button-unfilled\n              variant=\"icon\"\n              icon={header.backIcon || 'ChevronLeft'}\n              size=\"md\"\n              aria-label={header.backAriaLabel || 'Back'}\n              activeFill={false}\n              hasBorder={false}\n              onDsClick={() => this.dsHeaderBack.emit({ tool })}\n            />\n          </ds-tooltip>\n        ) : null}\n        {actions.map(action => (\n          <ds-tooltip\n            slot=\"trailing\"\n            key={action.id}\n            label={action.ariaLabel}\n            side=\"bottom\"\n            size=\"sm\"\n          >\n            <ds-button-unfilled\n              id={action.triggerId || undefined}\n              data-header-action-id={action.id}\n              variant=\"icon\"\n              icon={action.icon}\n              size=\"md\"\n              aria-label={action.ariaLabel}\n              haspopup={action.haspopup}\n              controls={action.controls}\n              expanded={action.expanded}\n              pressed={action.pressed}\n              isActive={!!action.expanded}\n              isInactive={action.isInactive}\n              activeFill={false}\n              hasBorder={false}\n              onDsClick={(event: CustomEvent<MouseEvent>) =>\n                this.handleMobileHeaderAction(tool, action.id, event)}\n            />\n          </ds-tooltip>\n        ))}\n      </ds-mobile-header>\n    );\n  }\n\n  private renderMobile() {\n    const tool = this.mobileActiveTool;\n    return (\n      <div\n        class=\"shell-tools__mobile\"\n        aria-hidden={this.open && tool ? undefined : 'true'}\n        inert={this.open && tool ? undefined : true}\n      >\n        {tool ? this.renderMobileHeader(tool) : null}\n        <div class=\"shell-tools__mobile-body\">\n          {MOBILE_VIEW_ORDER.map(id => {\n            const active = this.open && id === tool;\n            return (\n              <div\n                class={{\n                  'shell-tools__view': true,\n                  'shell-tools__view--active': active,\n                }}\n                hidden={!active}\n                aria-hidden={active ? undefined : 'true'}\n                inert={active ? undefined : true}\n              >\n                <slot name={`${id}-view`}>\n                  <slot name={id} />\n                </slot>\n              </div>\n            );\n          })}\n        </div>\n      </div>\n    );\n  }\n\n  render() {\n    const mobile = this.responsiveMode === 'mobile';\n    return (\n      <Host\n        role={\n          mobile\n            ? this.presentation === 'fullscreen'\n              ? 'dialog'\n              : 'complementary'\n            : undefined\n        }\n        aria-modal={mobile && this.presentation === 'fullscreen' ? 'true' : undefined}\n        aria-label={mobile ? this.toolsLabel : undefined}\n      >\n        {mobile ? this.renderMobile() : this.renderDesktop()}\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

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

@@ -354,7 +354,7 @@
     },
     {
       "path": "src/wc/components/Switch/Switch.tsx",
-      "content": "import { AttachInternals, Component, Element, Prop, State, Event, EventEmitter, Watch, h, Host } from '@stencil/core';\n\nexport type SwitchSize = 'md' | 'sm' | 'xs';\n\nlet generatedLabelId = 0;\n\n@Component({\n  tag: 'ds-switch',\n  styleUrl: 'Switch.css',\n  shadow: true,\n  formAssociated: true,\n})\nexport class Switch {\n  @Element() el!: HTMLElement;\n  @AttachInternals() internals!: ElementInternals;\n\n  /** Current on/off state. The initial value is restored when the owning form resets. */\n  @Prop({ mutable: true }) checked: boolean = false;\n\n  @Prop({ reflect: true }) name: string | undefined;\n  @Prop() value: string = 'on';\n\n  /** Optional value submitted when unchecked; omitted by default like a native checkbox. */\n  @Prop() uncheckedValue: string | undefined;\n\n  /** Associates the switch with a form by id when it is rendered outside that form. */\n  @Prop({ reflect: true }) form: string | undefined;\n\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 = 'This field is required.';\n  @Prop() isInactive: boolean = false;\n\n  /** Compact track size for placement inside controls, menus, and form rows. */\n  @Prop() size: SwitchSize = 'md';\n\n  /**\n   * Removes standalone control semantics so a composite owner such as a\n   * `menuitemcheckbox` can use the switch as an aria-hidden visual indicator.\n   */\n  @Prop() presentation: boolean = false;\n\n  @Event() dsChange!: EventEmitter<boolean>;\n\n  private initialChecked = false;\n  @State() private formDisabled = false;\n  @State() private focused = false;\n  @State() private touched = false;\n\n  componentWillLoad() {\n    this.initialChecked = this.checked;\n    this.syncFormValue();\n  }\n\n  componentDidLoad() {\n    this.syncNativeLabels();\n  }\n\n  @Watch('checked')\n  @Watch('value')\n  @Watch('uncheckedValue')\n  @Watch('disabled')\n  @Watch('isInactive')\n  @Watch('presentation')\n  @Watch('required')\n  syncFormValue() {\n    const inactive = this.presentation || this.isInactive || this.disabled || this.formDisabled;\n    const submissionValue = this.checked ? this.value : this.uncheckedValue ?? null;\n    const state = this.checked ? 'checked' : 'unchecked';\n    this.internals.setFormValue(inactive ? null : submissionValue, state);\n\n    const missing = this.required && !inactive && !this.checked;\n    this.internals.setValidity(missing ? { valueMissing: true } : {}, missing ? this.requiredMessage : '');\n  }\n\n  formDisabledCallback(disabled: boolean) {\n    this.formDisabled = disabled;\n    this.syncFormValue();\n  }\n\n  formResetCallback() {\n    this.checked = this.initialChecked;\n    this.focused = false;\n    this.touched = false;\n  }\n\n  formStateRestoreCallback(state: string | File | FormData | null) {\n    this.checked = state === 'checked';\n  }\n\n  private syncNativeLabels() {\n    if (this.presentation) return;\n    if (this.el.hasAttribute('aria-label') || this.el.hasAttribute('aria-labelledby')) return;\n\n    const labelIds = (Array.from(this.internals.labels) as HTMLLabelElement[]).map(label => {\n      if (!label.id) label.id = `ds-switch-label-${++generatedLabelId}`;\n      return label.id;\n    });\n    if (labelIds.length) this.el.setAttribute('aria-labelledby', labelIds.join(' '));\n  }\n\n  private handleClick = () => {\n    if (this.presentation || this.readOnly || this.isInactive || this.disabled || this.formDisabled) return;\n    this.checked = !this.checked;\n    this.dsChange.emit(this.checked);\n  };\n\n  private handleKeyDown = (event: KeyboardEvent) => {\n    if (this.presentation || this.readOnly || this.isInactive || this.disabled || this.formDisabled) return;\n    if (event.key === ' ' || event.key === 'Enter') {\n      event.preventDefault();\n      this.handleClick();\n    }\n  };\n\n  private handleFocus = () => {\n    if (!this.presentation) this.focused = true;\n  };\n\n  private handleBlur = () => {\n    if (this.presentation) return;\n    this.focused = false;\n    this.touched = true;\n  };\n\n  render() {\n    const inactive = this.isInactive || this.disabled || this.formDisabled;\n    const invalid = this.required && !inactive && !this.checked;\n    const dirty = this.checked !== this.initialChecked;\n    // Switch owns its structural track and thumb strokes so nested interaction layers cannot cover them.\n    return (\n      <Host\n        role={this.presentation ? undefined : 'switch'}\n        aria-checked={this.presentation ? undefined : String(this.checked)}\n        aria-disabled={!this.presentation && inactive ? 'true' : undefined}\n        aria-readonly={!this.presentation && this.readOnly ? 'true' : undefined}\n        aria-required={!this.presentation && this.required ? 'true' : undefined}\n        aria-invalid={!this.presentation && invalid ? 'true' : undefined}\n        aria-hidden={this.presentation ? 'true' : undefined}\n        data-checked={this.checked ? '' : undefined}\n        data-unchecked={!this.checked ? '' : undefined}\n        data-disabled={inactive ? '' : undefined}\n        data-readonly={this.readOnly ? '' : undefined}\n        data-required={this.required ? '' : undefined}\n        data-focused={!this.presentation && this.focused ? '' : undefined}\n        data-filled={!this.presentation && this.checked ? '' : undefined}\n        data-dirty={!this.presentation && dirty ? '' : undefined}\n        data-touched={!this.presentation && this.touched ? '' : undefined}\n        data-valid={!this.presentation && !inactive && !invalid ? '' : undefined}\n        data-invalid={!this.presentation && invalid ? '' : undefined}\n        tabIndex={this.presentation || inactive ? -1 : 0}\n        class={{\n          switch: true,\n          checked: this.checked,\n          'switch--md': this.size === 'md',\n          'switch--sm': this.size === 'sm',\n          'switch--xs': this.size === 'xs',\n          'switch--readonly': this.readOnly,\n          'switch--presentation': this.presentation,\n          'ds-focus-ring': true,\n          'ds-control-inactive': inactive,\n        }}\n        onClick={this.handleClick}\n        onKeyDown={this.handleKeyDown}\n        onFocus={this.handleFocus}\n        onBlur={this.handleBlur}\n      >\n        <span class=\"thumb\" />\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { AttachInternals, Component, Element, Prop, State, Event, EventEmitter, Watch, h, Host } from '@stencil/core';\nimport { DEFAULT_REQUIRED_MESSAGE, setRequiredValidity } from '../../utils';\n\nexport type SwitchSize = 'md' | 'sm' | 'xs';\n\nlet generatedLabelId = 0;\n\n@Component({\n  tag: 'ds-switch',\n  styleUrl: 'Switch.css',\n  shadow: true,\n  formAssociated: true,\n})\nexport class Switch {\n  @Element() el!: HTMLElement;\n  @AttachInternals() internals!: ElementInternals;\n\n  /** Current on/off state. The initial value is restored when the owning form resets. */\n  @Prop({ mutable: true }) checked: boolean = false;\n\n  @Prop({ reflect: true }) name: string | undefined;\n  @Prop() value: string = 'on';\n\n  /** Optional value submitted when unchecked; omitted by default like a native checkbox. */\n  @Prop() uncheckedValue: string | undefined;\n\n  /** Associates the switch with a form by id when it is rendered outside that form. */\n  @Prop({ reflect: true }) form: string | undefined;\n\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  @Prop() isInactive: boolean = false;\n\n  /** Compact track size for placement inside controls, menus, and form rows. */\n  @Prop() size: SwitchSize = 'md';\n\n  /**\n   * Removes standalone control semantics so a composite owner such as a\n   * `menuitemcheckbox` can use the switch as an aria-hidden visual indicator.\n   */\n  @Prop() presentation: boolean = false;\n\n  @Event() dsChange!: EventEmitter<boolean>;\n\n  private initialChecked = false;\n  @State() private formDisabled = false;\n  @State() private focused = false;\n  @State() private touched = false;\n\n  componentWillLoad() {\n    this.initialChecked = this.checked;\n    this.syncFormValue();\n  }\n\n  componentDidLoad() {\n    this.syncNativeLabels();\n  }\n\n  @Watch('checked')\n  @Watch('value')\n  @Watch('uncheckedValue')\n  @Watch('disabled')\n  @Watch('isInactive')\n  @Watch('presentation')\n  @Watch('required')\n  syncFormValue() {\n    const inactive = this.presentation || this.isInactive || this.disabled || this.formDisabled;\n    const submissionValue = this.checked ? this.value : this.uncheckedValue ?? null;\n    const state = this.checked ? 'checked' : 'unchecked';\n    this.internals.setFormValue(inactive ? null : submissionValue, state);\n\n    const missing = this.required && !inactive && !this.checked;\n    setRequiredValidity(this.internals, missing, this.requiredMessage);\n  }\n\n  formDisabledCallback(disabled: boolean) {\n    this.formDisabled = disabled;\n    this.syncFormValue();\n  }\n\n  formResetCallback() {\n    this.checked = this.initialChecked;\n    this.focused = false;\n    this.touched = false;\n  }\n\n  formStateRestoreCallback(state: string | File | FormData | null) {\n    this.checked = state === 'checked';\n  }\n\n  private syncNativeLabels() {\n    if (this.presentation) return;\n    if (this.el.hasAttribute('aria-label') || this.el.hasAttribute('aria-labelledby')) return;\n\n    const labelIds = (Array.from(this.internals.labels) as HTMLLabelElement[]).map(label => {\n      if (!label.id) label.id = `ds-switch-label-${++generatedLabelId}`;\n      return label.id;\n    });\n    if (labelIds.length) this.el.setAttribute('aria-labelledby', labelIds.join(' '));\n  }\n\n  private handleClick = () => {\n    if (this.presentation || this.readOnly || this.isInactive || this.disabled || this.formDisabled) return;\n    this.checked = !this.checked;\n    this.dsChange.emit(this.checked);\n  };\n\n  private handleKeyDown = (event: KeyboardEvent) => {\n    if (this.presentation || this.readOnly || this.isInactive || this.disabled || this.formDisabled) return;\n    if (event.key === ' ' || event.key === 'Enter') {\n      event.preventDefault();\n      this.handleClick();\n    }\n  };\n\n  private handleFocus = () => {\n    if (!this.presentation) this.focused = true;\n  };\n\n  private handleBlur = () => {\n    if (this.presentation) return;\n    this.focused = false;\n    this.touched = true;\n  };\n\n  render() {\n    const inactive = this.isInactive || this.disabled || this.formDisabled;\n    const invalid = this.required && !inactive && !this.checked;\n    const dirty = this.checked !== this.initialChecked;\n    // Switch owns its structural track and thumb strokes so nested interaction layers cannot cover them.\n    return (\n      <Host\n        role={this.presentation ? undefined : 'switch'}\n        aria-checked={this.presentation ? undefined : String(this.checked)}\n        aria-disabled={!this.presentation && inactive ? 'true' : undefined}\n        aria-readonly={!this.presentation && this.readOnly ? 'true' : undefined}\n        aria-required={!this.presentation && this.required ? 'true' : undefined}\n        aria-invalid={!this.presentation && invalid ? 'true' : undefined}\n        aria-hidden={this.presentation ? 'true' : undefined}\n        data-checked={this.checked ? '' : undefined}\n        data-unchecked={!this.checked ? '' : undefined}\n        data-disabled={inactive ? '' : undefined}\n        data-readonly={this.readOnly ? '' : undefined}\n        data-required={this.required ? '' : undefined}\n        data-focused={!this.presentation && this.focused ? '' : undefined}\n        data-filled={!this.presentation && this.checked ? '' : undefined}\n        data-dirty={!this.presentation && dirty ? '' : undefined}\n        data-touched={!this.presentation && this.touched ? '' : undefined}\n        data-valid={!this.presentation && !inactive && !invalid ? '' : undefined}\n        data-invalid={!this.presentation && invalid ? '' : undefined}\n        tabIndex={this.presentation || inactive ? -1 : 0}\n        class={{\n          switch: true,\n          checked: this.checked,\n          'switch--md': this.size === 'md',\n          'switch--sm': this.size === 'sm',\n          'switch--xs': this.size === 'xs',\n          'switch--readonly': this.readOnly,\n          'switch--presentation': this.presentation,\n          'ds-focus-ring': true,\n          'ds-control-inactive': inactive,\n        }}\n        onClick={this.handleClick}\n        onKeyDown={this.handleKeyDown}\n        onFocus={this.handleFocus}\n        onBlur={this.handleBlur}\n      >\n        <span class=\"thumb\" />\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

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

@@ -325,12 +325,12 @@
   "files": [
     {
       "path": "src/wc/components/Toast/Toast.css",
-      "content": ":host {\n  display: contents;\n}\n\n.toast-region {\n  position: fixed;\n  inset: 0;\n  z-index: var(--dimension-z-index-floating);\n  pointer-events: none;\n  outline: none;\n}\n\n.toast-viewport {\n  position: absolute;\n  right: var(--dimension-space-200);\n  bottom: var(--dimension-space-200);\n  display: grid;\n  width: min(\n    var(--dimension-card-width-sm),\n    calc(100vw - 2 * var(--dimension-space-200))\n  );\n}\n\n@media (max-width: 767px) {\n  :host([avoid-mobile-shell-bar]) .toast-viewport {\n    bottom: calc(\n      var(--dimension-space-200) +\n      var(--dimension-stroke-width-012) +\n      var(--dimension-space-050) +\n      var(--dimension-size-600) +\n      max(var(--dimension-space-050), env(safe-area-inset-bottom))\n    );\n  }\n}\n\n.toast-positioner {\n  grid-area: 1 / 1;\n  align-self: end;\n  justify-self: center;\n  width: 100%;\n  pointer-events: auto;\n  transform: translateY(\n    calc(-1 * var(--toast-index) * var(--dimension-space-100))\n  );\n  transition:\n    transform var(--effect-motion-short-3),\n    width var(--effect-motion-short-3);\n}\n\n.toast-viewport:not([data-expanded]) .toast-positioner {\n  width: calc(\n    100% - 2 * var(--toast-index) * var(--dimension-space-100)\n  );\n}\n\n.toast-viewport[data-expanded] .toast-positioner {\n  transform: translateY(calc(-1 * var(--toast-offset-y)));\n}\n\n.toast-positioner[data-limited] {\n  visibility: hidden;\n  pointer-events: none;\n}\n\n.toast-positioner--anchored {\n  position: fixed;\n  width: min(\n    var(--dimension-card-width-sm),\n    calc(100vw - 2 * var(--dimension-space-200))\n  );\n  transform: none;\n}\n\n.toast-positioner--anchored[data-positioned='false'] {\n  visibility: hidden;\n}\n\n.toast-surface {\n  position: relative;\n  display: block;\n  box-sizing: border-box;\n  width: 100%;\n  height: var(--toast-height, auto);\n  padding: var(--dimension-space-200);\n  overflow: hidden;\n  color: var(--color-foreground-primary);\n  background-color: var(--color-background-primary);\n  border-radius: var(--dimension-radius-050);\n  box-shadow: var(--effect-elevation-elevated-floating);\n  transform: translate(\n    var(--toast-swipe-movement-x),\n    var(--toast-swipe-movement-y)\n  );\n  animation: toast-enter var(--effect-motion-short-2) both;\n}\n\n.toast-positioner--ending .toast-surface {\n  animation: toast-exit var(--effect-motion-short-3) both;\n}\n\n.toast-surface--swiping {\n  transition: none;\n  user-select: none;\n}\n\n.toast-content {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  padding-inline-end: var(--dimension-size-500);\n  transition: opacity var(--effect-motion-short-3);\n}\n\n.toast-copy {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  min-height: var(--typography-lineheight-md);\n  margin-block: calc(-1 * var(--dimension-space-025));\n  gap: var(--dimension-space-050);\n}\n\n.toast-title,\n.toast-description {\n  min-width: 0;\n}\n\n.toast-action {\n  align-self: start;\n  margin-top: calc(\n    var(--dimension-space-200) + var(--dimension-space-025)\n  );\n}\n\n.toast-close {\n  position: absolute;\n  top: var(--dimension-space-100);\n  right: var(--dimension-space-100);\n  transition: opacity var(--effect-motion-short-3);\n}\n\n.toast-viewport:not([data-expanded]) .toast-positioner[data-behind] .toast-content,\n.toast-viewport:not([data-expanded]) .toast-positioner[data-behind] .toast-close {\n  opacity: 0;\n}\n\n.toast-assertive-announcer {\n  position: absolute;\n  width: var(--dimension-size-100);\n  height: var(--dimension-size-100);\n  padding: 0;\n  overflow: hidden;\n  white-space: nowrap;\n  clip-path: inset(50%);\n}\n\n@keyframes toast-enter {\n  from {\n    opacity: 0;\n    transform: translateY(var(--dimension-space-100));\n  }\n\n  to {\n    opacity: 1;\n    transform: translateY(0);\n  }\n}\n\n@keyframes toast-exit {\n  from {\n    opacity: 1;\n  }\n\n  to {\n    opacity: 0;\n  }\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .toast-positioner,\n  .toast-surface,\n  .toast-content,\n  .toast-close,\n  .toast-positioner--ending .toast-surface {\n    transition: none;\n    animation: none;\n  }\n\n  .toast-positioner--ending .toast-surface {\n    opacity: 0;\n  }\n}\n",
+      "content": "@import '../../utils/visually-hidden.css';\n\n:host {\n  display: contents;\n}\n\n.toast-region {\n  position: fixed;\n  inset: 0;\n  z-index: var(--dimension-z-index-floating);\n  pointer-events: none;\n  outline: none;\n}\n\n.toast-viewport {\n  position: absolute;\n  right: var(--dimension-space-200);\n  bottom: var(--dimension-space-200);\n  display: grid;\n  width: min(\n    var(--dimension-card-width-sm),\n    calc(100vw - 2 * var(--dimension-space-200))\n  );\n}\n\n@media (max-width: 767px) {\n  :host([avoid-mobile-shell-bar]) .toast-viewport {\n    bottom: calc(\n      var(--dimension-space-200) +\n      var(--dimension-stroke-width-012) +\n      var(--dimension-space-200) +\n      var(--dimension-size-500) +\n      max(var(--dimension-space-200), env(safe-area-inset-bottom))\n    );\n  }\n}\n\n.toast-positioner {\n  grid-area: 1 / 1;\n  align-self: end;\n  justify-self: center;\n  width: 100%;\n  pointer-events: auto;\n  transform: translateY(\n    calc(-1 * var(--toast-index) * var(--dimension-space-100))\n  );\n  transition:\n    transform var(--effect-motion-short-3),\n    width var(--effect-motion-short-3);\n}\n\n.toast-viewport:not([data-expanded]) .toast-positioner {\n  width: calc(\n    100% - 2 * var(--toast-index) * var(--dimension-space-100)\n  );\n}\n\n.toast-viewport[data-expanded] .toast-positioner {\n  transform: translateY(calc(-1 * var(--toast-offset-y)));\n}\n\n.toast-positioner[data-limited] {\n  visibility: hidden;\n  pointer-events: none;\n}\n\n.toast-positioner--anchored {\n  position: fixed;\n  width: min(\n    var(--dimension-card-width-sm),\n    calc(100vw - 2 * var(--dimension-space-200))\n  );\n  transform: none;\n}\n\n.toast-positioner--anchored[data-positioned='false'] {\n  visibility: hidden;\n}\n\n.toast-surface {\n  position: relative;\n  display: block;\n  box-sizing: border-box;\n  width: 100%;\n  height: var(--toast-height, auto);\n  padding: var(--dimension-space-200);\n  overflow: hidden;\n  color: var(--color-foreground-primary);\n  background-color: var(--color-background-primary);\n  border-radius: var(--dimension-radius-050);\n  box-shadow: var(--effect-elevation-elevated-floating);\n  transform: translate(\n    var(--toast-swipe-movement-x),\n    var(--toast-swipe-movement-y)\n  );\n  animation: toast-enter var(--effect-motion-short-2) both;\n}\n\n.toast-positioner--ending .toast-surface {\n  animation: toast-exit var(--effect-motion-short-3) both;\n}\n\n.toast-surface--swiping {\n  transition: none;\n  user-select: none;\n}\n\n.toast-content {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  padding-inline-end: var(--dimension-size-500);\n  transition: opacity var(--effect-motion-short-3);\n}\n\n.toast-copy {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  min-height: var(--typography-lineheight-md);\n  margin-block: calc(-1 * var(--dimension-space-025));\n  gap: var(--dimension-space-050);\n}\n\n.toast-title,\n.toast-description {\n  min-width: 0;\n}\n\n.toast-action {\n  align-self: start;\n  margin-top: calc(\n    var(--dimension-space-200) + var(--dimension-space-025)\n  );\n}\n\n.toast-close {\n  position: absolute;\n  top: var(--dimension-space-100);\n  right: var(--dimension-space-100);\n  transition: opacity var(--effect-motion-short-3);\n}\n\n.toast-viewport:not([data-expanded]) .toast-positioner[data-behind] .toast-content,\n.toast-viewport:not([data-expanded]) .toast-positioner[data-behind] .toast-close {\n  opacity: 0;\n}\n\n\n@keyframes toast-enter {\n  from {\n    opacity: 0;\n    transform: translateY(var(--dimension-space-100));\n  }\n\n  to {\n    opacity: 1;\n    transform: translateY(0);\n  }\n}\n\n@keyframes toast-exit {\n  from {\n    opacity: 1;\n  }\n\n  to {\n    opacity: 0;\n  }\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .toast-positioner,\n  .toast-surface,\n  .toast-content,\n  .toast-close,\n  .toast-positioner--ending .toast-surface {\n    transition: none;\n    animation: none;\n  }\n\n  .toast-positioner--ending .toast-surface {\n    opacity: 0;\n  }\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/Toast/Toast.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 {\n  resolveCssLengthPx,\n  resolveCssTimeMs,\n  resolveMotionTimeMs,\n  TOKEN_DEFAULTS,\n} from '../../utils';\nimport {\n  toastManager as defaultToastManager,\n  type ToastActionEventDetail,\n  type ToastCloseContext,\n  type ToastCloseEventDetail,\n  type ToastEventDetail,\n  type ToastManager,\n  type ToastRecord,\n  type ToastSwipeDirection,\n} from '../../toast';\nimport { computeTooltipPosition } from '../Tooltip/tooltip-position';\n\ninterface ToastTimer {\n  timerKey: number;\n  remaining: number;\n  startedAt: number;\n  handle: ReturnType<typeof setTimeout> | null;\n}\n\ninterface SwipeState {\n  id: string;\n  x: number;\n  y: number;\n  direction?: ToastSwipeDirection;\n}\n\ninterface AnchoredPosition {\n  x: number;\n  y: number;\n  side: 'top' | 'right' | 'bottom' | 'left';\n}\n\ninterface ActiveSwipe {\n  id: string;\n  pointerId: number;\n  pointerType: string;\n  startX: number;\n  startY: number;\n  maxDistance: number;\n  cancelled: boolean;\n  axis: 'x' | 'y' | null;\n}\n\nconst SWIPE_THRESHOLD = 40;\nconst SWIPE_REVERSE_CANCEL_THRESHOLD = 10;\nconst GLOBAL_STACK_HOVER = '__global-stack__';\nconst INTERACTIVE_SWIPE_SELECTOR =\n  'button,a,input,textarea,select,[role=\"button\"],[data-ds-toast-swipe-ignore]';\n\nconst attachedManagers = new WeakMap<ToastManager, Toast>();\nconst connectedToastRegions = new Set<Toast>();\nlet activeToastRegion: Toast | null = null;\nlet toastInstanceCounter = 0;\n\n@Component({\n  tag: 'ds-toast',\n  styleUrl: 'Toast.css',\n  scoped: true,\n})\nexport class Toast {\n  @Element() el!: HTMLElement;\n\n  /** Manager that supplies toast records. Assign as a JavaScript property. */\n  @Prop() manager: ToastManager = defaultToastManager;\n  /** Maximum visible global-stack records. Limited records remain mounted and inert. */\n  @Prop() limit: number = 3;\n  /** Default auto-dismiss delay. Use 0 for persistent records. */\n  @Prop() timeout: number | string = TOKEN_DEFAULTS.animationDelayLong2;\n  /** Accessible label for the notification region. */\n  @Prop() label: string = 'Notifications';\n  /** Localized accessible label for every toast close action. */\n  @Prop() closeLabel: string = 'Close notification';\n  /** Keep the global stack 16px above the persistent mobile shell bar below 768px. */\n  @Prop({ attribute: 'avoid-mobile-shell-bar', reflect: true })\n  avoidMobileShellBar: boolean = false;\n  /** Allowed swipe-to-dismiss directions. Assign as a JavaScript property. */\n  @Prop() swipeDirections: ToastSwipeDirection[] = ['down', 'right'];\n\n  @State() private records: readonly ToastRecord[] = [];\n  @State() private expanded = false;\n  @State() private keyboardActive = false;\n  @State() private swipe: SwipeState | null = null;\n  @State() private layoutVersion = 0;\n\n  @Event() dsToastClose!: EventEmitter<ToastCloseEventDetail>;\n  @Event() dsToastRemove!: EventEmitter<ToastEventDetail>;\n  @Event() dsToastAction!: EventEmitter<ToastActionEventDetail>;\n\n  private readonly instanceId = ++toastInstanceCounter;\n  private readonly domIds = new Map<string, number>();\n  private readonly timers = new Map<string, ToastTimer>();\n  private readonly closeWatchdogs = new Map<string, ReturnType<typeof setTimeout>>();\n  private readonly closeFrames = new Map<string, number>();\n  private readonly closeEvents = new Set<string>();\n  private readonly activationFrames = new Map<string, number>();\n  private readonly pauseReasons = new Set<string>();\n  private readonly hoveredIds = new Set<string>();\n  private readonly heights = new Map<string, number>();\n  private readonly measuredUpdateKeys = new Map<string, number>();\n  private readonly anchoredPositions = new Map<string, AnchoredPosition>();\n  private readonly dismissedSwipeDirections = new Map<string, ToastSwipeDirection>();\n  private readonly observedElements = new Set<Element>();\n  private readonly pendingRemovals: Array<{\n    manager: ToastManager;\n    context: ToastCloseContext;\n  }> = [];\n\n  private unsubscribe: (() => void) | null = null;\n  private attachedManager: ToastManager | null = null;\n  private previousFocus: HTMLElement | null = null;\n  private resizeObserver: ResizeObserver | null = null;\n  private mutationObserver: MutationObserver | null = null;\n  private layoutFrame: number | null = null;\n  private activeSwipe: ActiveSwipe | null = null;\n  private nextDomId = 0;\n  private connected = false;\n  private pendingHoverLeave = false;\n\n  connectedCallback() {\n    this.connect();\n  }\n\n  componentDidLoad() {\n    this.connect();\n  }\n\n  private connect() {\n    if (this.connected) return;\n    this.connected = true;\n    this.resizeObserver ??= new ResizeObserver(() => this.scheduleLayout());\n    this.mutationObserver ??= new MutationObserver(() => this.scheduleLayout());\n    this.mutationObserver.observe(document.body, { childList: true, subtree: true });\n    if (!this.unsubscribe) this.attachManager(this.manager);\n    window.addEventListener('blur', this.handleWindowBlur);\n    window.addEventListener('focus', this.handleWindowFocus);\n    window.addEventListener('resize', this.handleWindowResize);\n    window.addEventListener('scroll', this.scheduleLayout, true);\n    document.addEventListener('keydown', this.handleDocumentKeyDown);\n    document.addEventListener('visibilitychange', this.handleVisibilityChange);\n    connectedToastRegions.add(this);\n    // eslint-disable-next-line @typescript-eslint/no-this-alias -- module coordinator tracks the active connected viewport\n    if (!activeToastRegion) activeToastRegion = this;\n  }\n\n  componentDidRender() {\n    this.syncObservedElements();\n    this.flushPendingRemovals();\n    this.scheduleLayout();\n  }\n\n  disconnectedCallback() {\n    this.connected = false;\n    this.flushPendingRemovals();\n    this.detachManager();\n    this.resetManagerState();\n    this.resizeObserver?.disconnect();\n    this.resizeObserver = null;\n    this.mutationObserver?.disconnect();\n    this.mutationObserver = null;\n    this.observedElements.clear();\n    if (this.layoutFrame !== null) cancelAnimationFrame(this.layoutFrame);\n    this.layoutFrame = null;\n    window.removeEventListener('blur', this.handleWindowBlur);\n    window.removeEventListener('focus', this.handleWindowFocus);\n    window.removeEventListener('resize', this.handleWindowResize);\n    window.removeEventListener('scroll', this.scheduleLayout, true);\n    document.removeEventListener('keydown', this.handleDocumentKeyDown);\n    document.removeEventListener('visibilitychange', this.handleVisibilityChange);\n    connectedToastRegions.delete(this);\n    if (activeToastRegion === this) {\n      const remaining = Array.from(connectedToastRegions);\n      activeToastRegion = remaining[remaining.length - 1] ?? null;\n    }\n  }\n\n  @Watch('manager')\n  onManagerChange(next: ToastManager) {\n    this.detachManager();\n    this.resetManagerState();\n    if (this.connected) this.attachManager(next);\n  }\n\n  @Watch('timeout')\n  onTimeoutChange() {\n    for (const timer of this.timers.values()) {\n      if (timer.handle) clearTimeout(timer.handle);\n    }\n    this.timers.clear();\n    this.syncTimers();\n  }\n\n  private attachManager(manager: ToastManager) {\n    const attached = attachedManagers.get(manager);\n    if (attached && attached !== this) {\n      console.warn('[ds-toast] A manager can control only one connected ds-toast instance.');\n      return;\n    }\n    attachedManagers.set(manager, this);\n    this.attachedManager = manager;\n    this.unsubscribe = manager.subscribe(records => {\n      this.records = records;\n      this.syncLifecycle(records);\n      this.scheduleLayout();\n    });\n  }\n\n  private detachManager() {\n    this.unsubscribe?.();\n    this.unsubscribe = null;\n    if (this.attachedManager && attachedManagers.get(this.attachedManager) === this) {\n      attachedManagers.delete(this.attachedManager);\n    }\n    this.attachedManager = null;\n  }\n\n  private resetManagerState() {\n    this.flushPendingRemovals();\n    if (this.el.contains(document.activeElement)) this.restorePreviousFocus();\n    this.clearAllTimers();\n    for (const frame of this.activationFrames.values()) cancelAnimationFrame(frame);\n    for (const frame of this.closeFrames.values()) cancelAnimationFrame(frame);\n    this.activationFrames.clear();\n    this.closeFrames.clear();\n    this.closeEvents.clear();\n    this.pauseReasons.clear();\n    this.hoveredIds.clear();\n    this.pendingHoverLeave = false;\n    this.heights.clear();\n    this.measuredUpdateKeys.clear();\n    this.anchoredPositions.clear();\n    this.dismissedSwipeDirections.clear();\n    this.domIds.clear();\n    this.activeSwipe = null;\n    this.swipe = null;\n    this.expanded = false;\n    this.keyboardActive = false;\n    this.records = [];\n    this.resizeObserver?.disconnect();\n    this.observedElements.clear();\n  }\n\n  private syncObservedElements() {\n    const next = new Set<Element>(\n      this.el.querySelectorAll<HTMLElement>('.toast-positioner'),\n    );\n    for (const record of this.records) {\n      if (!record.positioner) continue;\n      const anchor = this.resolveAnchor(record.positioner.anchor);\n      if (anchor) next.add(anchor);\n    }\n\n    for (const element of this.observedElements) {\n      if (!next.has(element)) {\n        this.resizeObserver?.unobserve(element);\n        this.observedElements.delete(element);\n      }\n    }\n    for (const element of next) {\n      if (this.observedElements.has(element)) continue;\n      this.resizeObserver?.observe(element);\n      this.observedElements.add(element);\n    }\n  }\n\n  private flushPendingRemovals() {\n    for (const pending of this.pendingRemovals.splice(0)) {\n      pending.manager.notifyRemove(pending.context);\n      this.dsToastRemove.emit({\n        id: pending.context.id,\n        toast: pending.context.toast,\n      });\n    }\n  }\n\n  private syncLifecycle(records: readonly ToastRecord[]) {\n    const recordIds = new Set(records.map(record => record.id));\n    for (const id of this.hoveredIds) {\n      if (id !== GLOBAL_STACK_HOVER && !recordIds.has(id)) this.hoveredIds.delete(id);\n    }\n    const hasEndingRecords = records.some(\n      record => record.transitionStatus === 'ending',\n    );\n    if (this.pendingHoverLeave && !hasEndingRecords && !this.hoveredIds.size) {\n      this.pendingHoverLeave = false;\n      this.expanded = false;\n      this.resumeTimers('hover');\n    } else if (!this.hoveredIds.size && !this.pendingHoverLeave) {\n      this.resumeTimers('hover');\n    }\n\n    for (const [id, timer] of this.timers) {\n      if (recordIds.has(id)) continue;\n      if (timer.handle) clearTimeout(timer.handle);\n      this.timers.delete(id);\n    }\n\n    for (const [id, watchdog] of this.closeWatchdogs) {\n      if (recordIds.has(id)) continue;\n      clearTimeout(watchdog);\n      this.closeWatchdogs.delete(id);\n    }\n\n    for (const [id, frame] of this.activationFrames) {\n      if (recordIds.has(id)) continue;\n      cancelAnimationFrame(frame);\n      this.activationFrames.delete(id);\n    }\n\n    for (const [id, frame] of this.closeFrames) {\n      if (recordIds.has(id)) continue;\n      cancelAnimationFrame(frame);\n      this.closeFrames.delete(id);\n    }\n\n    for (const id of this.domIds.keys()) {\n      if (recordIds.has(id)) continue;\n      this.closeEvents.delete(id);\n      this.domIds.delete(id);\n      this.heights.delete(id);\n      this.measuredUpdateKeys.delete(id);\n      this.anchoredPositions.delete(id);\n      this.dismissedSwipeDirections.delete(id);\n    }\n\n    for (const record of records) {\n      this.ensureDomId(record.id);\n      if (\n        record.transitionStatus === 'starting' &&\n        !this.activationFrames.has(record.id)\n      ) {\n        const manager = this.attachedManager;\n        const frame = requestAnimationFrame(() => {\n          this.activationFrames.delete(record.id);\n          manager?.activate(record.id);\n        });\n        this.activationFrames.set(record.id, frame);\n      }\n\n      if (record.transitionStatus === 'ending') {\n        this.clearToastTimer(record.id);\n        this.beginRemoval(record);\n      } else {\n        const watchdog = this.closeWatchdogs.get(record.id);\n        if (watchdog) clearTimeout(watchdog);\n        this.closeWatchdogs.delete(record.id);\n        const closeFrame = this.closeFrames.get(record.id);\n        if (closeFrame) cancelAnimationFrame(closeFrame);\n        this.closeFrames.delete(record.id);\n        this.closeEvents.delete(record.id);\n      }\n    }\n\n    this.syncTimers();\n  }\n\n  private syncTimers() {\n    const activeIds = new Set<string>();\n    for (const record of this.records) {\n      if (record.transitionStatus !== 'active') continue;\n      activeIds.add(record.id);\n      const duration = this.resolveToastTimeout(record);\n      if (duration <= 0) {\n        this.clearToastTimer(record.id);\n        continue;\n      }\n\n      const existing = this.timers.get(record.id);\n      if (!existing || existing.timerKey !== record.timerKey) {\n        this.clearToastTimer(record.id);\n        this.timers.set(record.id, {\n          timerKey: record.timerKey,\n          remaining: duration,\n          startedAt: 0,\n          handle: null,\n        });\n      }\n      if (!this.isPaused) this.startToastTimer(record.id);\n    }\n\n    for (const id of this.timers.keys()) {\n      if (!activeIds.has(id)) this.clearToastTimer(id);\n    }\n  }\n\n  private resolveToastTimeout(record: ToastRecord): number {\n    const value = record.timeout ?? this.timeout;\n    if (typeof value === 'number') return Math.max(0, value);\n    return resolveCssTimeMs(value, TOKEN_DEFAULTS.animationDelayLong2);\n  }\n\n  private startToastTimer(id: string) {\n    const timer = this.timers.get(id);\n    if (!timer || timer.handle || timer.remaining <= 0) return;\n    timer.startedAt = Date.now();\n    timer.handle = setTimeout(() => {\n      timer.handle = null;\n      timer.remaining = 0;\n      this.manager.close(id, 'timeout');\n    }, timer.remaining);\n  }\n\n  private pauseTimers(reason: string) {\n    const wasPaused = this.isPaused;\n    this.pauseReasons.add(reason);\n    if (wasPaused) return;\n    const now = Date.now();\n    for (const timer of this.timers.values()) {\n      if (!timer.handle) continue;\n      clearTimeout(timer.handle);\n      timer.handle = null;\n      timer.remaining = Math.max(0, timer.remaining - (now - timer.startedAt));\n    }\n  }\n\n  private resumeTimers(reason: string) {\n    this.pauseReasons.delete(reason);\n    if (this.isPaused) return;\n    for (const id of this.timers.keys()) this.startToastTimer(id);\n  }\n\n  private get isPaused(): boolean {\n    return this.pauseReasons.size > 0;\n  }\n\n  private clearToastTimer(id: string) {\n    const timer = this.timers.get(id);\n    if (timer?.handle) clearTimeout(timer.handle);\n    this.timers.delete(id);\n  }\n\n  private clearAllTimers() {\n    for (const timer of this.timers.values()) {\n      if (timer.handle) clearTimeout(timer.handle);\n    }\n    for (const watchdog of this.closeWatchdogs.values()) clearTimeout(watchdog);\n    this.timers.clear();\n    this.closeWatchdogs.clear();\n  }\n\n  private beginRemoval(record: ToastRecord) {\n    if (!this.closeEvents.has(record.id)) {\n      this.closeEvents.add(record.id);\n      this.dsToastClose.emit({\n        id: record.id,\n        reason: record.closeReason ?? 'programmatic',\n        toast: record,\n      });\n      this.moveFocusAfterClose(record.id);\n    }\n    if (\n      this.closeWatchdogs.has(record.id) ||\n      this.closeFrames.has(record.id)\n    ) return;\n\n    const duration = resolveMotionTimeMs(\n      TOKEN_DEFAULTS.motionShort3,\n      TOKEN_DEFAULTS.animationDurationShort3,\n    );\n    if (duration <= 0) {\n      queueMicrotask(() => this.completeRemoval(record));\n      return;\n    }\n    const frame = requestAnimationFrame(() => {\n      this.closeFrames.delete(record.id);\n      const current = this.records.find(candidate => candidate.id === record.id);\n      if (!current || current.transitionStatus !== 'ending') return;\n      this.closeWatchdogs.set(\n        record.id,\n        setTimeout(() => this.completeRemoval(current), duration),\n      );\n    });\n    this.closeFrames.set(record.id, frame);\n  }\n\n  private completeRemoval(record: ToastRecord) {\n    const current = this.records.find(candidate => candidate.id === record.id);\n    if (!current || current.transitionStatus !== 'ending') return;\n    const watchdog = this.closeWatchdogs.get(record.id);\n    if (watchdog) clearTimeout(watchdog);\n    this.closeWatchdogs.delete(record.id);\n    const closeFrame = this.closeFrames.get(record.id);\n    if (closeFrame) cancelAnimationFrame(closeFrame);\n    this.closeFrames.delete(record.id);\n    const manager = this.attachedManager;\n    const context = manager?.remove(record.id);\n    if (manager && context) this.pendingRemovals.push({ manager, context });\n  }\n\n  private handleAnimationComplete(record: ToastRecord) {\n    if (record.transitionStatus === 'ending') this.completeRemoval(record);\n  }\n\n  private bindAnimationCancel(element: HTMLDivElement | undefined, id: string) {\n    if (!element || element.dataset['cancelBound'] === 'true') return;\n    element.dataset['cancelBound'] = 'true';\n    element.addEventListener('animationcancel', () => {\n      const record = this.records.find(candidate => candidate.id === id);\n      if (record) this.handleAnimationComplete(record);\n    });\n  }\n\n  private handleWindowBlur = () => this.pauseTimers('window');\n  private handleWindowFocus = () => this.resumeTimers('window');\n  private handleVisibilityChange = () => {\n    if (document.hidden) this.pauseTimers('document');\n    else this.resumeTimers('document');\n  };\n\n  private handlePointerEnter(id: string) {\n    // eslint-disable-next-line @typescript-eslint/no-this-alias -- pointer interaction selects the viewport that receives F6\n    activeToastRegion = this;\n    this.pendingHoverLeave = false;\n    this.hoveredIds.add(id);\n    this.expanded = true;\n    this.pauseTimers('hover');\n  }\n\n  private handlePointerLeave(id: string) {\n    this.hoveredIds.delete(id);\n    if (this.hoveredIds.size) return;\n    if (this.records.some(record => record.transitionStatus === 'ending')) {\n      this.pendingHoverLeave = true;\n      return;\n    }\n    this.expanded = false;\n    this.resumeTimers('hover');\n  }\n\n  private handleFocusIn = () => {\n    const active = document.activeElement;\n    if (!(active instanceof HTMLElement) || !active.matches(':focus-visible')) return;\n    // eslint-disable-next-line @typescript-eslint/no-this-alias -- module coordinator routes F6 to the last focused viewport\n    activeToastRegion = this;\n    this.keyboardActive = true;\n    this.expanded = true;\n    this.pauseTimers('focus');\n  };\n\n  private handleFocusOut = (event: FocusEvent) => {\n    const next = event.relatedTarget;\n    if (next instanceof Node && this.el.contains(next)) return;\n    if (!this.keyboardActive) return;\n    this.keyboardActive = false;\n    this.expanded = this.hoveredIds.size > 0;\n    this.resumeTimers('focus');\n  };\n\n  private handleDocumentKeyDown = (event: KeyboardEvent) => {\n    if (event.key !== 'F6') return;\n    const eligible = Array.from(connectedToastRegions).filter(\n      region => region.activeRecords.length > 0,\n    );\n    const target =\n      activeToastRegion && activeToastRegion.activeRecords.length\n        ? activeToastRegion\n        : eligible[eligible.length - 1];\n    if (target !== this) return;\n    event.preventDefault();\n    if (!this.el.contains(document.activeElement)) {\n      this.previousFocus = document.activeElement as HTMLElement | null;\n    }\n    this.keyboardActive = true;\n    this.regionElement?.focus();\n  };\n\n  private handleRegionKeyDown = (event: KeyboardEvent) => {\n    if (event.key === 'Escape') {\n      const target = event.target as HTMLElement;\n      const positioner = target.closest<HTMLElement>('.toast-positioner');\n      const id = positioner?.dataset['toastId'] ?? this.activeRecords[0]?.id;\n      if (id) {\n        event.preventDefault();\n        this.manager.close(id, 'escape');\n      }\n      return;\n    }\n\n    if (event.key === 'Tab' && event.shiftKey && event.target === this.regionElement) {\n      event.preventDefault();\n      this.restorePreviousFocus();\n    }\n  };\n\n  private get regionElement(): HTMLElement | null {\n    return this.el.querySelector<HTMLElement>('.toast-region');\n  }\n\n  private restorePreviousFocus() {\n    this.previousFocus?.focus?.();\n    this.previousFocus = null;\n    this.keyboardActive = false;\n  }\n\n  private moveFocusAfterClose(id: string) {\n    const active = document.activeElement;\n    const closing = this.positionerElement(id);\n    if (!active || !closing?.contains(active)) return;\n    requestAnimationFrame(() => {\n      const next = this.activeRecords.find(record => record.id !== id);\n      const control = next\n        ? this.positionerElement(next.id)?.querySelector<\n            HTMLElement & { setFocus?: () => Promise<void> }\n          >('ds-button-unfilled')\n        : null;\n      if (control?.setFocus) void control.setFocus();\n      else if (next) this.regionElement?.focus();\n      else this.restorePreviousFocus();\n    });\n  }\n\n  private handleAction(record: ToastRecord, event: CustomEvent<MouseEvent>) {\n    const detail: ToastActionEventDetail = {\n      id: record.id,\n      toast: record,\n      originalEvent: event.detail,\n    };\n    this.dsToastAction.emit(detail);\n    record.action?.onAction?.({\n      id: record.id,\n      data: record.data,\n      manager: this.manager,\n      originalEvent: event.detail,\n    });\n  }\n\n  private handlePointerDown(record: ToastRecord, event: PointerEvent) {\n    if (event.button !== 0) return;\n    const target = event.target as Element;\n    if (target.closest(INTERACTIVE_SWIPE_SELECTOR)) return;\n\n    const surface = event.currentTarget as HTMLElement;\n    surface.setPointerCapture(event.pointerId);\n    this.activeSwipe = {\n      id: record.id,\n      pointerId: event.pointerId,\n      pointerType: event.pointerType,\n      startX: event.clientX,\n      startY: event.clientY,\n      maxDistance: 0,\n      cancelled: false,\n      axis: null,\n    };\n    this.swipe = { id: record.id, x: 0, y: 0 };\n    if (event.pointerType === 'touch') this.pauseTimers('swipe');\n  }\n\n  private handlePointerMove(event: PointerEvent) {\n    const active = this.activeSwipe;\n    if (!active || active.pointerId !== event.pointerId || active.cancelled) return;\n    const dx = event.clientX - active.startX;\n    const dy = event.clientY - active.startY;\n    if (!active.axis && Math.max(Math.abs(dx), Math.abs(dy)) > 1) {\n      active.axis = Math.abs(dx) >= Math.abs(dy) ? 'x' : 'y';\n    }\n    if (!active.axis) return;\n    const horizontal = active.axis === 'x';\n    const direction: ToastSwipeDirection = horizontal\n      ? dx >= 0 ? 'right' : 'left'\n      : dy >= 0 ? 'down' : 'up';\n    const allowed = this.swipeDirections.includes(direction);\n    const rawDistance = horizontal ? Math.abs(dx) : Math.abs(dy);\n    const distance = allowed ? rawDistance : Math.sqrt(rawDistance);\n    const signed = (horizontal ? dx : dy) < 0 ? -distance : distance;\n    const x = horizontal ? signed : 0;\n    const y = horizontal ? 0 : signed;\n\n    if (active.maxDistance - distance >= SWIPE_REVERSE_CANCEL_THRESHOLD) {\n      active.cancelled = true;\n      this.cancelSwipe();\n      return;\n    }\n    active.maxDistance = Math.max(active.maxDistance, distance);\n    if (rawDistance > 1) event.preventDefault();\n    this.swipe = { id: active.id, x, y, direction: allowed ? direction : undefined };\n  }\n\n  private handlePointerUp(event: PointerEvent) {\n    const active = this.activeSwipe;\n    if (!active || active.pointerId !== event.pointerId) return;\n    const swipe = this.swipe;\n    const distance = swipe ? Math.max(Math.abs(swipe.x), Math.abs(swipe.y)) : 0;\n    const shouldDismiss =\n      !active.cancelled &&\n      !!swipe?.direction &&\n      distance >= SWIPE_THRESHOLD;\n    const id = active.id;\n    const wasTouch = active.pointerType === 'touch';\n    this.activeSwipe = null;\n    this.swipe = null;\n    if (wasTouch) this.resumeTimers('swipe');\n    if (shouldDismiss && swipe.direction) {\n      this.dismissedSwipeDirections.set(id, swipe.direction);\n      this.manager.close(id, 'swipe');\n    }\n  }\n\n  private handlePointerCancel(event: PointerEvent) {\n    if (this.activeSwipe?.pointerId !== event.pointerId) return;\n    this.cancelSwipe();\n  }\n\n  private cancelSwipe() {\n    const wasTouch = this.activeSwipe?.pointerType === 'touch';\n    this.activeSwipe = null;\n    this.swipe = null;\n    if (wasTouch) this.resumeTimers('swipe');\n  }\n\n  private get touchAction(): string {\n    const horizontal =\n      this.swipeDirections.includes('left') || this.swipeDirections.includes('right');\n    const vertical =\n      this.swipeDirections.includes('up') || this.swipeDirections.includes('down');\n    if (horizontal && vertical) return 'none';\n    if (horizontal) return 'pan-y';\n    if (vertical) return 'pan-x';\n    return 'auto';\n  }\n\n  private handleWindowResize = () => {\n    this.heights.clear();\n    this.measuredUpdateKeys.clear();\n    this.layoutVersion += 1;\n    this.scheduleLayout();\n  };\n\n  private scheduleLayout = () => {\n    if (this.layoutFrame !== null) return;\n    this.layoutFrame = requestAnimationFrame(() => {\n      this.layoutFrame = null;\n      this.measureLayout();\n    });\n  };\n\n  private measureNaturalHeight(element: HTMLElement, expandedWidth: boolean): number {\n    const surface = element.querySelector<HTMLElement>('.toast-surface');\n    if (!surface) return 0;\n    const previousWidth = element.style.width;\n    const previousTransition = element.style.transition;\n    const previousHeight = surface.style.height;\n\n    if (expandedWidth) {\n      element.style.transition = 'none';\n      element.style.width = '100%';\n    }\n    surface.style.height = 'auto';\n    const height = surface.getBoundingClientRect().height;\n\n    surface.style.height = previousHeight;\n    if (expandedWidth) {\n      element.style.width = previousWidth;\n      element.getBoundingClientRect();\n      element.style.transition = previousTransition;\n    }\n    return height;\n  }\n\n  private measureLayout() {\n    let changed = false;\n    for (const record of this.records) {\n      const element = this.positionerElement(record.id);\n      if (!element) continue;\n      let height = this.heights.get(record.id) ?? 0;\n      const needsHeightMeasurement =\n        height <= 0 || this.measuredUpdateKeys.get(record.id) !== record.updateKey;\n      if (needsHeightMeasurement) {\n        height = this.measureNaturalHeight(element, !record.positioner);\n        if (height > 0) {\n          if (this.heights.get(record.id) !== height) changed = true;\n          this.heights.set(record.id, height);\n          this.measuredUpdateKeys.set(record.id, record.updateKey);\n        }\n      }\n\n      if (!record.positioner) continue;\n      const anchor = this.resolveAnchor(record.positioner.anchor);\n      if (!anchor || height <= 0) {\n        if (this.anchoredPositions.delete(record.id)) changed = true;\n        continue;\n      }\n      const rect = element.getBoundingClientRect();\n      const sideOffset = resolveCssLengthPx(\n        record.positioner.sideOffset,\n        TOKEN_DEFAULTS.space050,\n      );\n      const alignOffset = resolveCssLengthPx(record.positioner.alignOffset, 0);\n      const position = computeTooltipPosition({\n        anchorRect: anchor.getBoundingClientRect(),\n        popupWidth: rect.width,\n        popupHeight: height,\n        side: record.positioner.side ?? 'top',\n        align: record.positioner.align ?? 'center',\n        sideOffsetPx: sideOffset,\n        alignOffsetPx: alignOffset,\n        viewportPadPx: resolveCssLengthPx(undefined, TOKEN_DEFAULTS.space200),\n        viewportWidth: window.innerWidth,\n        viewportHeight: window.innerHeight,\n      });\n      const current = this.anchoredPositions.get(record.id);\n      if (\n        !current ||\n        current.x !== position.x ||\n        current.y !== position.y ||\n        current.side !== position.resolvedSide\n      ) {\n        this.anchoredPositions.set(record.id, {\n          x: position.x,\n          y: position.y,\n          side: position.resolvedSide,\n        });\n        changed = true;\n      }\n    }\n    if (changed) this.layoutVersion += 1;\n  }\n\n  private resolveAnchor(anchor: HTMLElement | string): HTMLElement | null {\n    return typeof anchor === 'string' ? document.getElementById(anchor) : anchor;\n  }\n\n  private positionerElement(id: string): HTMLElement | null {\n    return (\n      Array.from(this.el.querySelectorAll<HTMLElement>('.toast-positioner'))\n        .find(element => element.dataset['toastId'] === id) ?? null\n    );\n  }\n\n  private ensureDomId(id: string): number {\n    const current = this.domIds.get(id);\n    if (current) return current;\n    const next = ++this.nextDomId;\n    this.domIds.set(id, next);\n    return next;\n  }\n\n  private get activeRecords(): ToastRecord[] {\n    return this.records.filter(record => record.transitionStatus !== 'ending');\n  }\n\n  private globalLayout() {\n    const globalRecords = this.records.filter(record => !record.positioner);\n    let offset = 0;\n    let visibleIndex = 0;\n    const gap = resolveCssLengthPx(undefined, TOKEN_DEFAULTS.space200);\n    const layouts = new Map<string, { index: number; offset: number; limited: boolean }>();\n\n    globalRecords.forEach((record, domIndex) => {\n      if (record.transitionStatus === 'ending') {\n        layouts.set(record.id, { index: domIndex, offset, limited: false });\n        return;\n      }\n\n      const limited = visibleIndex >= Math.max(1, this.limit);\n      layouts.set(record.id, { index: visibleIndex, offset, limited });\n      offset += (this.heights.get(record.id) ?? 0) + gap;\n      visibleIndex += 1;\n    });\n    return layouts;\n  }\n\n  private renderToast(\n    record: ToastRecord,\n    layout: { index: number; offset: number; limited: boolean },\n  ) {\n    const domId = this.ensureDomId(record.id);\n    const titleId = `ds-toast-${this.instanceId}-${domId}-title`;\n    const descriptionId = `ds-toast-${this.instanceId}-${domId}-description`;\n    const swipe = this.swipe?.id === record.id ? this.swipe : null;\n    const swipeDirection = swipe?.direction ?? this.dismissedSwipeDirections.get(record.id);\n    const anchored = !!record.positioner;\n    const anchoredPosition = this.anchoredPositions.get(record.id);\n    const hiddenHighPriority = record.priority === 'high' && !this.keyboardActive;\n    const focusTabIndex = this.keyboardActive && !layout.limited ? 0 : -1;\n    const toastHeight = this.heights.get(record.id);\n\n    return (\n      <div\n        ref={(element?: HTMLDivElement) => this.bindAnimationCancel(element, record.id)}\n        class={{\n          'toast-positioner': true,\n          'toast-positioner--anchored': anchored,\n          'toast-positioner--ending': record.transitionStatus === 'ending',\n        }}\n        data-toast-id={record.id}\n        data-behind={!anchored && layout.index > 0 ? '' : undefined}\n        data-limited={layout.limited ? '' : undefined}\n        data-positioned={anchored ? String(!!anchoredPosition) : undefined}\n        data-side={anchoredPosition?.side}\n        inert={layout.limited ? true : undefined}\n        aria-hidden={layout.limited ? 'true' : undefined}\n        style={{\n          '--toast-index': String(layout.index),\n          '--toast-offset-y': `${layout.offset}px`,\n          '--toast-height': toastHeight ? `${toastHeight}px` : undefined,\n          zIndex: String(this.records.length - layout.index),\n          left: anchoredPosition ? `${anchoredPosition.x}px` : undefined,\n          top: anchoredPosition ? `${anchoredPosition.y}px` : undefined,\n        }}\n        onAnimationEnd={() => this.handleAnimationComplete(record)}\n      >\n        <div\n          class={{\n            'toast-surface': true,\n            'toast-surface--swiping': !!swipe,\n          }}\n          role={record.priority === 'high' ? 'alertdialog' : 'dialog'}\n          aria-modal=\"false\"\n          aria-labelledby={\n            record.title ? titleId : record.description ? descriptionId : undefined\n          }\n          aria-describedby={record.title && record.description ? descriptionId : undefined}\n          aria-hidden={hiddenHighPriority ? 'true' : undefined}\n          data-type={record.type}\n          data-priority={record.priority}\n          data-transition-status={record.transitionStatus}\n          data-swiping={swipe ? '' : undefined}\n          data-swipe-direction={swipeDirection}\n          style={{\n            '--toast-swipe-movement-x': `${swipe?.x ?? 0}px`,\n            '--toast-swipe-movement-y': `${swipe?.y ?? 0}px`,\n            touchAction: this.touchAction,\n          }}\n          onPointerDown={(event: PointerEvent) => this.handlePointerDown(record, event)}\n          onPointerMove={(event: PointerEvent) => this.handlePointerMove(event)}\n          onPointerUp={(event: PointerEvent) => this.handlePointerUp(event)}\n          onPointerCancel={(event: PointerEvent) => this.handlePointerCancel(event)}\n          onPointerEnter={\n            anchored ? () => this.handlePointerEnter(record.id) : undefined\n          }\n          onPointerLeave={\n            anchored ? () => this.handlePointerLeave(record.id) : undefined\n          }\n        >\n          <div class=\"toast-content\">\n            <div class=\"toast-copy\">\n              {record.title && (\n                <ds-text\n                  class=\"toast-title\"\n                  as=\"div\"\n                  variant=\"text-title-small\"\n                  color=\"primary\"\n                  textId={titleId}\n                >\n                  {record.title}\n                </ds-text>\n              )}\n              {record.description && (\n                <ds-text\n                  class=\"toast-description\"\n                  as=\"div\"\n                  variant=\"text-body-medium\"\n                  color=\"secondary\"\n                  textId={descriptionId}\n                >\n                  {record.description}\n                </ds-text>\n              )}\n            </div>\n            {record.action && (\n              <ds-button-unfilled\n                class=\"toast-action\"\n                variant=\"label\"\n                size=\"md\"\n                type=\"button\"\n                label={record.action.label}\n                aria-label={record.action.ariaLabel}\n                hasBorder\n                focusTabIndex={focusTabIndex}\n                aria-hidden={!this.keyboardActive ? 'true' : undefined}\n                onDsClick={(event: CustomEvent<MouseEvent>) =>\n                  this.handleAction(record, event)\n                }\n              />\n            )}\n          </div>\n          <ds-button-unfilled\n            class=\"toast-close\"\n            variant=\"icon\"\n            size=\"md\"\n            type=\"button\"\n            icon=\"Cross\"\n            aria-label={this.closeLabel}\n            hasBorder={false}\n            activeFill={false}\n            focusTabIndex={focusTabIndex}\n            aria-hidden={!this.keyboardActive ? 'true' : undefined}\n            onDsClick={() => this.manager.close(record.id, 'close-button')}\n          />\n        </div>\n      </div>\n    );\n  }\n\n  render() {\n    void this.layoutVersion;\n    const globalLayouts = this.globalLayout();\n    const globalRecords = this.records.filter(record => !record.positioner);\n    const anchoredRecords = this.records.filter(record => !!record.positioner);\n    const highPriority = this.records.filter(\n      record =>\n        record.priority === 'high' &&\n        record.transitionStatus !== 'ending' &&\n        !globalLayouts.get(record.id)?.limited,\n    );\n\n    return (\n      <Host>\n        <section\n          class=\"toast-region\"\n          role=\"region\"\n          aria-label={this.label}\n          aria-live=\"polite\"\n          aria-atomic=\"false\"\n          aria-relevant=\"additions text\"\n          tabIndex={-1}\n          onFocusin={this.handleFocusIn}\n          onFocusout={(event: FocusEvent) => this.handleFocusOut(event)}\n          onKeyDown={(event: KeyboardEvent) => this.handleRegionKeyDown(event)}\n        >\n          <div\n            class=\"toast-viewport\"\n            data-expanded={this.expanded ? '' : undefined}\n            onPointerEnter={() => this.handlePointerEnter(GLOBAL_STACK_HOVER)}\n            onPointerLeave={() => this.handlePointerLeave(GLOBAL_STACK_HOVER)}\n          >\n            {globalRecords.map(record =>\n              this.renderToast(\n                record,\n                globalLayouts.get(record.id) ?? { index: 0, offset: 0, limited: false },\n              )\n            )}\n          </div>\n          <div class=\"toast-anchored-layer\">\n            {anchoredRecords.map(record =>\n              this.renderToast(record, { index: 0, offset: 0, limited: false })\n            )}\n          </div>\n          <div class=\"toast-assertive-announcer\">\n            {highPriority.map(record => (\n              <div role=\"alert\" aria-atomic=\"true\">\n                {[record.title, record.description].filter(Boolean).join('. ')}\n              </div>\n            ))}\n          </div>\n        </section>\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 {\n  resolveCssLengthPx,\n  resolveCssTimeMs,\n  resolveMotionTimeMs,\n  TOKEN_DEFAULTS,\n} from '../../utils';\nimport {\n  toastManager as defaultToastManager,\n  type ToastActionEventDetail,\n  type ToastCloseContext,\n  type ToastCloseEventDetail,\n  type ToastEventDetail,\n  type ToastManager,\n  type ToastRecord,\n  type ToastSwipeDirection,\n} from '../../toast';\nimport { computeTooltipPosition } from '../Tooltip/tooltip-position';\n\ninterface ToastTimer {\n  timerKey: number;\n  remaining: number;\n  startedAt: number;\n  handle: ReturnType<typeof setTimeout> | null;\n}\n\ninterface SwipeState {\n  id: string;\n  x: number;\n  y: number;\n  direction?: ToastSwipeDirection;\n}\n\ninterface AnchoredPosition {\n  x: number;\n  y: number;\n  side: 'top' | 'right' | 'bottom' | 'left';\n}\n\ninterface ActiveSwipe {\n  id: string;\n  pointerId: number;\n  pointerType: string;\n  startX: number;\n  startY: number;\n  maxDistance: number;\n  cancelled: boolean;\n  axis: 'x' | 'y' | null;\n}\n\nconst SWIPE_THRESHOLD = 40;\nconst SWIPE_REVERSE_CANCEL_THRESHOLD = 10;\nconst GLOBAL_STACK_HOVER = '__global-stack__';\nconst INTERACTIVE_SWIPE_SELECTOR =\n  'button,a,input,textarea,select,[role=\"button\"],[data-ds-toast-swipe-ignore]';\n\nconst attachedManagers = new WeakMap<ToastManager, Toast>();\nconst connectedToastRegions = new Set<Toast>();\nlet activeToastRegion: Toast | null = null;\nlet toastInstanceCounter = 0;\n\n@Component({\n  tag: 'ds-toast',\n  styleUrl: 'Toast.css',\n  scoped: true,\n})\nexport class Toast {\n  @Element() el!: HTMLElement;\n\n  /** Manager that supplies toast records. Assign as a JavaScript property. */\n  @Prop() manager: ToastManager = defaultToastManager;\n  /** Maximum visible global-stack records. Limited records remain mounted and inert. */\n  @Prop() limit: number = 3;\n  /** Default auto-dismiss delay. Use 0 for persistent records. */\n  @Prop() timeout: number | string = TOKEN_DEFAULTS.animationDelayLong2;\n  /** Accessible label for the notification region. */\n  @Prop() label: string = 'Notifications';\n  /** Localized accessible label for every toast close action. */\n  @Prop() closeLabel: string = 'Close notification';\n  /** Keep the global stack 16px above the persistent mobile shell bar below 768px. */\n  @Prop({ attribute: 'avoid-mobile-shell-bar', reflect: true })\n  avoidMobileShellBar: boolean = false;\n  /** Allowed swipe-to-dismiss directions. Assign as a JavaScript property. */\n  @Prop() swipeDirections: ToastSwipeDirection[] = ['down', 'right'];\n\n  @State() private records: readonly ToastRecord[] = [];\n  @State() private expanded = false;\n  @State() private keyboardActive = false;\n  @State() private swipe: SwipeState | null = null;\n  @State() private layoutVersion = 0;\n\n  @Event() dsToastClose!: EventEmitter<ToastCloseEventDetail>;\n  @Event() dsToastRemove!: EventEmitter<ToastEventDetail>;\n  @Event() dsToastAction!: EventEmitter<ToastActionEventDetail>;\n\n  private readonly instanceId = ++toastInstanceCounter;\n  private readonly domIds = new Map<string, number>();\n  private readonly timers = new Map<string, ToastTimer>();\n  private readonly closeWatchdogs = new Map<string, ReturnType<typeof setTimeout>>();\n  private readonly closeFrames = new Map<string, number>();\n  private readonly closeEvents = new Set<string>();\n  private readonly activationFrames = new Map<string, number>();\n  private readonly pauseReasons = new Set<string>();\n  private readonly hoveredIds = new Set<string>();\n  private readonly heights = new Map<string, number>();\n  private readonly measuredUpdateKeys = new Map<string, number>();\n  private readonly anchoredPositions = new Map<string, AnchoredPosition>();\n  private readonly dismissedSwipeDirections = new Map<string, ToastSwipeDirection>();\n  private readonly observedElements = new Set<Element>();\n  private readonly pendingRemovals: Array<{\n    manager: ToastManager;\n    context: ToastCloseContext;\n  }> = [];\n\n  private unsubscribe: (() => void) | null = null;\n  private attachedManager: ToastManager | null = null;\n  private previousFocus: HTMLElement | null = null;\n  private resizeObserver: ResizeObserver | null = null;\n  private mutationObserver: MutationObserver | null = null;\n  private layoutFrame: number | null = null;\n  private activeSwipe: ActiveSwipe | null = null;\n  private nextDomId = 0;\n  private connected = false;\n  private pendingHoverLeave = false;\n\n  connectedCallback() {\n    this.connect();\n  }\n\n  componentDidLoad() {\n    this.connect();\n  }\n\n  private connect() {\n    if (this.connected) return;\n    this.connected = true;\n    this.resizeObserver ??= new ResizeObserver(() => this.scheduleLayout());\n    this.mutationObserver ??= new MutationObserver(() => this.scheduleLayout());\n    this.mutationObserver.observe(document.body, { childList: true, subtree: true });\n    if (!this.unsubscribe) this.attachManager(this.manager);\n    window.addEventListener('blur', this.handleWindowBlur);\n    window.addEventListener('focus', this.handleWindowFocus);\n    window.addEventListener('resize', this.handleWindowResize);\n    window.addEventListener('scroll', this.scheduleLayout, true);\n    document.addEventListener('keydown', this.handleDocumentKeyDown);\n    document.addEventListener('visibilitychange', this.handleVisibilityChange);\n    connectedToastRegions.add(this);\n    // eslint-disable-next-line @typescript-eslint/no-this-alias -- module coordinator tracks the active connected viewport\n    if (!activeToastRegion) activeToastRegion = this;\n  }\n\n  componentDidRender() {\n    this.syncObservedElements();\n    this.flushPendingRemovals();\n    this.scheduleLayout();\n  }\n\n  disconnectedCallback() {\n    this.connected = false;\n    this.flushPendingRemovals();\n    this.detachManager();\n    this.resetManagerState();\n    this.resizeObserver?.disconnect();\n    this.resizeObserver = null;\n    this.mutationObserver?.disconnect();\n    this.mutationObserver = null;\n    this.observedElements.clear();\n    if (this.layoutFrame !== null) cancelAnimationFrame(this.layoutFrame);\n    this.layoutFrame = null;\n    window.removeEventListener('blur', this.handleWindowBlur);\n    window.removeEventListener('focus', this.handleWindowFocus);\n    window.removeEventListener('resize', this.handleWindowResize);\n    window.removeEventListener('scroll', this.scheduleLayout, true);\n    document.removeEventListener('keydown', this.handleDocumentKeyDown);\n    document.removeEventListener('visibilitychange', this.handleVisibilityChange);\n    connectedToastRegions.delete(this);\n    if (activeToastRegion === this) {\n      const remaining = Array.from(connectedToastRegions);\n      activeToastRegion = remaining[remaining.length - 1] ?? null;\n    }\n  }\n\n  @Watch('manager')\n  onManagerChange(next: ToastManager) {\n    this.detachManager();\n    this.resetManagerState();\n    if (this.connected) this.attachManager(next);\n  }\n\n  @Watch('timeout')\n  onTimeoutChange() {\n    for (const timer of this.timers.values()) {\n      if (timer.handle) clearTimeout(timer.handle);\n    }\n    this.timers.clear();\n    this.syncTimers();\n  }\n\n  private attachManager(manager: ToastManager) {\n    const attached = attachedManagers.get(manager);\n    if (attached && attached !== this) {\n      console.warn('[ds-toast] A manager can control only one connected ds-toast instance.');\n      return;\n    }\n    attachedManagers.set(manager, this);\n    this.attachedManager = manager;\n    this.unsubscribe = manager.subscribe(records => {\n      this.records = records;\n      this.syncLifecycle(records);\n      this.scheduleLayout();\n    });\n  }\n\n  private detachManager() {\n    this.unsubscribe?.();\n    this.unsubscribe = null;\n    if (this.attachedManager && attachedManagers.get(this.attachedManager) === this) {\n      attachedManagers.delete(this.attachedManager);\n    }\n    this.attachedManager = null;\n  }\n\n  private resetManagerState() {\n    this.flushPendingRemovals();\n    if (this.el.contains(document.activeElement)) this.restorePreviousFocus();\n    this.clearAllTimers();\n    for (const frame of this.activationFrames.values()) cancelAnimationFrame(frame);\n    for (const frame of this.closeFrames.values()) cancelAnimationFrame(frame);\n    this.activationFrames.clear();\n    this.closeFrames.clear();\n    this.closeEvents.clear();\n    this.pauseReasons.clear();\n    this.hoveredIds.clear();\n    this.pendingHoverLeave = false;\n    this.heights.clear();\n    this.measuredUpdateKeys.clear();\n    this.anchoredPositions.clear();\n    this.dismissedSwipeDirections.clear();\n    this.domIds.clear();\n    this.activeSwipe = null;\n    this.swipe = null;\n    this.expanded = false;\n    this.keyboardActive = false;\n    this.records = [];\n    this.resizeObserver?.disconnect();\n    this.observedElements.clear();\n  }\n\n  private syncObservedElements() {\n    const next = new Set<Element>(\n      this.el.querySelectorAll<HTMLElement>('.toast-positioner'),\n    );\n    for (const record of this.records) {\n      if (!record.positioner) continue;\n      const anchor = this.resolveAnchor(record.positioner.anchor);\n      if (anchor) next.add(anchor);\n    }\n\n    for (const element of this.observedElements) {\n      if (!next.has(element)) {\n        this.resizeObserver?.unobserve(element);\n        this.observedElements.delete(element);\n      }\n    }\n    for (const element of next) {\n      if (this.observedElements.has(element)) continue;\n      this.resizeObserver?.observe(element);\n      this.observedElements.add(element);\n    }\n  }\n\n  private flushPendingRemovals() {\n    for (const pending of this.pendingRemovals.splice(0)) {\n      pending.manager.notifyRemove(pending.context);\n      this.dsToastRemove.emit({\n        id: pending.context.id,\n        toast: pending.context.toast,\n      });\n    }\n  }\n\n  private syncLifecycle(records: readonly ToastRecord[]) {\n    const recordIds = new Set(records.map(record => record.id));\n    for (const id of this.hoveredIds) {\n      if (id !== GLOBAL_STACK_HOVER && !recordIds.has(id)) this.hoveredIds.delete(id);\n    }\n    const hasEndingRecords = records.some(\n      record => record.transitionStatus === 'ending',\n    );\n    if (this.pendingHoverLeave && !hasEndingRecords && !this.hoveredIds.size) {\n      this.pendingHoverLeave = false;\n      this.expanded = false;\n      this.resumeTimers('hover');\n    } else if (!this.hoveredIds.size && !this.pendingHoverLeave) {\n      this.resumeTimers('hover');\n    }\n\n    for (const [id, timer] of this.timers) {\n      if (recordIds.has(id)) continue;\n      if (timer.handle) clearTimeout(timer.handle);\n      this.timers.delete(id);\n    }\n\n    for (const [id, watchdog] of this.closeWatchdogs) {\n      if (recordIds.has(id)) continue;\n      clearTimeout(watchdog);\n      this.closeWatchdogs.delete(id);\n    }\n\n    for (const [id, frame] of this.activationFrames) {\n      if (recordIds.has(id)) continue;\n      cancelAnimationFrame(frame);\n      this.activationFrames.delete(id);\n    }\n\n    for (const [id, frame] of this.closeFrames) {\n      if (recordIds.has(id)) continue;\n      cancelAnimationFrame(frame);\n      this.closeFrames.delete(id);\n    }\n\n    for (const id of this.domIds.keys()) {\n      if (recordIds.has(id)) continue;\n      this.closeEvents.delete(id);\n      this.domIds.delete(id);\n      this.heights.delete(id);\n      this.measuredUpdateKeys.delete(id);\n      this.anchoredPositions.delete(id);\n      this.dismissedSwipeDirections.delete(id);\n    }\n\n    for (const record of records) {\n      this.ensureDomId(record.id);\n      if (\n        record.transitionStatus === 'starting' &&\n        !this.activationFrames.has(record.id)\n      ) {\n        const manager = this.attachedManager;\n        const frame = requestAnimationFrame(() => {\n          this.activationFrames.delete(record.id);\n          manager?.activate(record.id);\n        });\n        this.activationFrames.set(record.id, frame);\n      }\n\n      if (record.transitionStatus === 'ending') {\n        this.clearToastTimer(record.id);\n        this.beginRemoval(record);\n      } else {\n        const watchdog = this.closeWatchdogs.get(record.id);\n        if (watchdog) clearTimeout(watchdog);\n        this.closeWatchdogs.delete(record.id);\n        const closeFrame = this.closeFrames.get(record.id);\n        if (closeFrame) cancelAnimationFrame(closeFrame);\n        this.closeFrames.delete(record.id);\n        this.closeEvents.delete(record.id);\n      }\n    }\n\n    this.syncTimers();\n  }\n\n  private syncTimers() {\n    const activeIds = new Set<string>();\n    for (const record of this.records) {\n      if (record.transitionStatus !== 'active') continue;\n      activeIds.add(record.id);\n      const duration = this.resolveToastTimeout(record);\n      if (duration <= 0) {\n        this.clearToastTimer(record.id);\n        continue;\n      }\n\n      const existing = this.timers.get(record.id);\n      if (!existing || existing.timerKey !== record.timerKey) {\n        this.clearToastTimer(record.id);\n        this.timers.set(record.id, {\n          timerKey: record.timerKey,\n          remaining: duration,\n          startedAt: 0,\n          handle: null,\n        });\n      }\n      if (!this.isPaused) this.startToastTimer(record.id);\n    }\n\n    for (const id of this.timers.keys()) {\n      if (!activeIds.has(id)) this.clearToastTimer(id);\n    }\n  }\n\n  private resolveToastTimeout(record: ToastRecord): number {\n    const value = record.timeout ?? this.timeout;\n    if (typeof value === 'number') return Math.max(0, value);\n    return resolveCssTimeMs(value, TOKEN_DEFAULTS.animationDelayLong2);\n  }\n\n  private startToastTimer(id: string) {\n    const timer = this.timers.get(id);\n    if (!timer || timer.handle || timer.remaining <= 0) return;\n    timer.startedAt = Date.now();\n    timer.handle = setTimeout(() => {\n      timer.handle = null;\n      timer.remaining = 0;\n      this.manager.close(id, 'timeout');\n    }, timer.remaining);\n  }\n\n  private pauseTimers(reason: string) {\n    const wasPaused = this.isPaused;\n    this.pauseReasons.add(reason);\n    if (wasPaused) return;\n    const now = Date.now();\n    for (const timer of this.timers.values()) {\n      if (!timer.handle) continue;\n      clearTimeout(timer.handle);\n      timer.handle = null;\n      timer.remaining = Math.max(0, timer.remaining - (now - timer.startedAt));\n    }\n  }\n\n  private resumeTimers(reason: string) {\n    this.pauseReasons.delete(reason);\n    if (this.isPaused) return;\n    for (const id of this.timers.keys()) this.startToastTimer(id);\n  }\n\n  private get isPaused(): boolean {\n    return this.pauseReasons.size > 0;\n  }\n\n  private clearToastTimer(id: string) {\n    const timer = this.timers.get(id);\n    if (timer?.handle) clearTimeout(timer.handle);\n    this.timers.delete(id);\n  }\n\n  private clearAllTimers() {\n    for (const timer of this.timers.values()) {\n      if (timer.handle) clearTimeout(timer.handle);\n    }\n    for (const watchdog of this.closeWatchdogs.values()) clearTimeout(watchdog);\n    this.timers.clear();\n    this.closeWatchdogs.clear();\n  }\n\n  private beginRemoval(record: ToastRecord) {\n    if (!this.closeEvents.has(record.id)) {\n      this.closeEvents.add(record.id);\n      this.dsToastClose.emit({\n        id: record.id,\n        reason: record.closeReason ?? 'programmatic',\n        toast: record,\n      });\n      this.moveFocusAfterClose(record.id);\n    }\n    if (\n      this.closeWatchdogs.has(record.id) ||\n      this.closeFrames.has(record.id)\n    ) return;\n\n    const duration = resolveMotionTimeMs(\n      TOKEN_DEFAULTS.motionShort3,\n      TOKEN_DEFAULTS.animationDurationShort3,\n    );\n    if (duration <= 0) {\n      queueMicrotask(() => this.completeRemoval(record));\n      return;\n    }\n    const frame = requestAnimationFrame(() => {\n      this.closeFrames.delete(record.id);\n      const current = this.records.find(candidate => candidate.id === record.id);\n      if (!current || current.transitionStatus !== 'ending') return;\n      this.closeWatchdogs.set(\n        record.id,\n        setTimeout(() => this.completeRemoval(current), duration),\n      );\n    });\n    this.closeFrames.set(record.id, frame);\n  }\n\n  private completeRemoval(record: ToastRecord) {\n    const current = this.records.find(candidate => candidate.id === record.id);\n    if (!current || current.transitionStatus !== 'ending') return;\n    const watchdog = this.closeWatchdogs.get(record.id);\n    if (watchdog) clearTimeout(watchdog);\n    this.closeWatchdogs.delete(record.id);\n    const closeFrame = this.closeFrames.get(record.id);\n    if (closeFrame) cancelAnimationFrame(closeFrame);\n    this.closeFrames.delete(record.id);\n    const manager = this.attachedManager;\n    const context = manager?.remove(record.id);\n    if (manager && context) this.pendingRemovals.push({ manager, context });\n  }\n\n  private handleAnimationComplete(record: ToastRecord) {\n    if (record.transitionStatus === 'ending') this.completeRemoval(record);\n  }\n\n  private bindAnimationCancel(element: HTMLDivElement | undefined, id: string) {\n    if (!element || element.dataset['cancelBound'] === 'true') return;\n    element.dataset['cancelBound'] = 'true';\n    element.addEventListener('animationcancel', () => {\n      const record = this.records.find(candidate => candidate.id === id);\n      if (record) this.handleAnimationComplete(record);\n    });\n  }\n\n  private handleWindowBlur = () => this.pauseTimers('window');\n  private handleWindowFocus = () => this.resumeTimers('window');\n  private handleVisibilityChange = () => {\n    if (document.hidden) this.pauseTimers('document');\n    else this.resumeTimers('document');\n  };\n\n  private handlePointerEnter(id: string) {\n    // eslint-disable-next-line @typescript-eslint/no-this-alias -- pointer interaction selects the viewport that receives F6\n    activeToastRegion = this;\n    this.pendingHoverLeave = false;\n    this.hoveredIds.add(id);\n    this.expanded = true;\n    this.pauseTimers('hover');\n  }\n\n  private handlePointerLeave(id: string) {\n    this.hoveredIds.delete(id);\n    if (this.hoveredIds.size) return;\n    if (this.records.some(record => record.transitionStatus === 'ending')) {\n      this.pendingHoverLeave = true;\n      return;\n    }\n    this.expanded = false;\n    this.resumeTimers('hover');\n  }\n\n  private handleFocusIn = () => {\n    const active = document.activeElement;\n    if (!(active instanceof HTMLElement) || !active.matches(':focus-visible')) return;\n    // eslint-disable-next-line @typescript-eslint/no-this-alias -- module coordinator routes F6 to the last focused viewport\n    activeToastRegion = this;\n    this.keyboardActive = true;\n    this.expanded = true;\n    this.pauseTimers('focus');\n  };\n\n  private handleFocusOut = (event: FocusEvent) => {\n    const next = event.relatedTarget;\n    if (next instanceof Node && this.el.contains(next)) return;\n    if (!this.keyboardActive) return;\n    this.keyboardActive = false;\n    this.expanded = this.hoveredIds.size > 0;\n    this.resumeTimers('focus');\n  };\n\n  private handleDocumentKeyDown = (event: KeyboardEvent) => {\n    if (event.key !== 'F6') return;\n    const eligible = Array.from(connectedToastRegions).filter(\n      region => region.activeRecords.length > 0,\n    );\n    const target =\n      activeToastRegion && activeToastRegion.activeRecords.length\n        ? activeToastRegion\n        : eligible[eligible.length - 1];\n    if (target !== this) return;\n    event.preventDefault();\n    if (!this.el.contains(document.activeElement)) {\n      this.previousFocus = document.activeElement as HTMLElement | null;\n    }\n    this.keyboardActive = true;\n    this.regionElement?.focus();\n  };\n\n  private handleRegionKeyDown = (event: KeyboardEvent) => {\n    if (event.key === 'Escape') {\n      const target = event.target as HTMLElement;\n      const positioner = target.closest<HTMLElement>('.toast-positioner');\n      const id = positioner?.dataset['toastId'] ?? this.activeRecords[0]?.id;\n      if (id) {\n        event.preventDefault();\n        this.manager.close(id, 'escape');\n      }\n      return;\n    }\n\n    if (event.key === 'Tab' && event.shiftKey && event.target === this.regionElement) {\n      event.preventDefault();\n      this.restorePreviousFocus();\n    }\n  };\n\n  private get regionElement(): HTMLElement | null {\n    return this.el.querySelector<HTMLElement>('.toast-region');\n  }\n\n  private restorePreviousFocus() {\n    this.previousFocus?.focus?.();\n    this.previousFocus = null;\n    this.keyboardActive = false;\n  }\n\n  private moveFocusAfterClose(id: string) {\n    const active = document.activeElement;\n    const closing = this.positionerElement(id);\n    if (!active || !closing?.contains(active)) return;\n    requestAnimationFrame(() => {\n      const next = this.activeRecords.find(record => record.id !== id);\n      const control = next\n        ? this.positionerElement(next.id)?.querySelector<\n            HTMLElement & { setFocus?: () => Promise<void> }\n          >('ds-button-unfilled')\n        : null;\n      if (control?.setFocus) void control.setFocus();\n      else if (next) this.regionElement?.focus();\n      else this.restorePreviousFocus();\n    });\n  }\n\n  private handleAction(record: ToastRecord, event: CustomEvent<MouseEvent>) {\n    const detail: ToastActionEventDetail = {\n      id: record.id,\n      toast: record,\n      originalEvent: event.detail,\n    };\n    this.dsToastAction.emit(detail);\n    record.action?.onAction?.({\n      id: record.id,\n      data: record.data,\n      manager: this.manager,\n      originalEvent: event.detail,\n    });\n  }\n\n  private handlePointerDown(record: ToastRecord, event: PointerEvent) {\n    if (event.button !== 0) return;\n    const target = event.target as Element;\n    if (target.closest(INTERACTIVE_SWIPE_SELECTOR)) return;\n\n    const surface = event.currentTarget as HTMLElement;\n    surface.setPointerCapture(event.pointerId);\n    this.activeSwipe = {\n      id: record.id,\n      pointerId: event.pointerId,\n      pointerType: event.pointerType,\n      startX: event.clientX,\n      startY: event.clientY,\n      maxDistance: 0,\n      cancelled: false,\n      axis: null,\n    };\n    this.swipe = { id: record.id, x: 0, y: 0 };\n    if (event.pointerType === 'touch') this.pauseTimers('swipe');\n  }\n\n  private handlePointerMove(event: PointerEvent) {\n    const active = this.activeSwipe;\n    if (!active || active.pointerId !== event.pointerId || active.cancelled) return;\n    const dx = event.clientX - active.startX;\n    const dy = event.clientY - active.startY;\n    if (!active.axis && Math.max(Math.abs(dx), Math.abs(dy)) > 1) {\n      active.axis = Math.abs(dx) >= Math.abs(dy) ? 'x' : 'y';\n    }\n    if (!active.axis) return;\n    const horizontal = active.axis === 'x';\n    const direction: ToastSwipeDirection = horizontal\n      ? dx >= 0 ? 'right' : 'left'\n      : dy >= 0 ? 'down' : 'up';\n    const allowed = this.swipeDirections.includes(direction);\n    const rawDistance = horizontal ? Math.abs(dx) : Math.abs(dy);\n    const distance = allowed ? rawDistance : Math.sqrt(rawDistance);\n    const signed = (horizontal ? dx : dy) < 0 ? -distance : distance;\n    const x = horizontal ? signed : 0;\n    const y = horizontal ? 0 : signed;\n\n    if (active.maxDistance - distance >= SWIPE_REVERSE_CANCEL_THRESHOLD) {\n      active.cancelled = true;\n      this.cancelSwipe();\n      return;\n    }\n    active.maxDistance = Math.max(active.maxDistance, distance);\n    if (rawDistance > 1) event.preventDefault();\n    this.swipe = { id: active.id, x, y, direction: allowed ? direction : undefined };\n  }\n\n  private handlePointerUp(event: PointerEvent) {\n    const active = this.activeSwipe;\n    if (!active || active.pointerId !== event.pointerId) return;\n    const swipe = this.swipe;\n    const distance = swipe ? Math.max(Math.abs(swipe.x), Math.abs(swipe.y)) : 0;\n    const shouldDismiss =\n      !active.cancelled &&\n      !!swipe?.direction &&\n      distance >= SWIPE_THRESHOLD;\n    const id = active.id;\n    const wasTouch = active.pointerType === 'touch';\n    this.activeSwipe = null;\n    this.swipe = null;\n    if (wasTouch) this.resumeTimers('swipe');\n    if (shouldDismiss && swipe.direction) {\n      this.dismissedSwipeDirections.set(id, swipe.direction);\n      this.manager.close(id, 'swipe');\n    }\n  }\n\n  private handlePointerCancel(event: PointerEvent) {\n    if (this.activeSwipe?.pointerId !== event.pointerId) return;\n    this.cancelSwipe();\n  }\n\n  private cancelSwipe() {\n    const wasTouch = this.activeSwipe?.pointerType === 'touch';\n    this.activeSwipe = null;\n    this.swipe = null;\n    if (wasTouch) this.resumeTimers('swipe');\n  }\n\n  private get touchAction(): string {\n    const horizontal =\n      this.swipeDirections.includes('left') || this.swipeDirections.includes('right');\n    const vertical =\n      this.swipeDirections.includes('up') || this.swipeDirections.includes('down');\n    if (horizontal && vertical) return 'none';\n    if (horizontal) return 'pan-y';\n    if (vertical) return 'pan-x';\n    return 'auto';\n  }\n\n  private handleWindowResize = () => {\n    this.heights.clear();\n    this.measuredUpdateKeys.clear();\n    this.layoutVersion += 1;\n    this.scheduleLayout();\n  };\n\n  private scheduleLayout = () => {\n    if (this.layoutFrame !== null) return;\n    this.layoutFrame = requestAnimationFrame(() => {\n      this.layoutFrame = null;\n      this.measureLayout();\n    });\n  };\n\n  private measureNaturalHeight(element: HTMLElement, expandedWidth: boolean): number {\n    const surface = element.querySelector<HTMLElement>('.toast-surface');\n    if (!surface) return 0;\n    const previousWidth = element.style.width;\n    const previousTransition = element.style.transition;\n    const previousHeight = surface.style.height;\n\n    if (expandedWidth) {\n      element.style.transition = 'none';\n      element.style.width = '100%';\n    }\n    surface.style.height = 'auto';\n    const height = surface.getBoundingClientRect().height;\n\n    surface.style.height = previousHeight;\n    if (expandedWidth) {\n      element.style.width = previousWidth;\n      element.getBoundingClientRect();\n      element.style.transition = previousTransition;\n    }\n    return height;\n  }\n\n  private measureLayout() {\n    let changed = false;\n    for (const record of this.records) {\n      const element = this.positionerElement(record.id);\n      if (!element) continue;\n      let height = this.heights.get(record.id) ?? 0;\n      const needsHeightMeasurement =\n        height <= 0 || this.measuredUpdateKeys.get(record.id) !== record.updateKey;\n      if (needsHeightMeasurement) {\n        height = this.measureNaturalHeight(element, !record.positioner);\n        if (height > 0) {\n          if (this.heights.get(record.id) !== height) changed = true;\n          this.heights.set(record.id, height);\n          this.measuredUpdateKeys.set(record.id, record.updateKey);\n        }\n      }\n\n      if (!record.positioner) continue;\n      const anchor = this.resolveAnchor(record.positioner.anchor);\n      if (!anchor || height <= 0) {\n        if (this.anchoredPositions.delete(record.id)) changed = true;\n        continue;\n      }\n      const rect = element.getBoundingClientRect();\n      const sideOffset = resolveCssLengthPx(\n        record.positioner.sideOffset,\n        TOKEN_DEFAULTS.space050,\n      );\n      const alignOffset = resolveCssLengthPx(record.positioner.alignOffset, 0);\n      const position = computeTooltipPosition({\n        anchorRect: anchor.getBoundingClientRect(),\n        popupWidth: rect.width,\n        popupHeight: height,\n        side: record.positioner.side ?? 'top',\n        align: record.positioner.align ?? 'center',\n        sideOffsetPx: sideOffset,\n        alignOffsetPx: alignOffset,\n        viewportPadPx: resolveCssLengthPx(undefined, TOKEN_DEFAULTS.space200),\n        viewportWidth: window.innerWidth,\n        viewportHeight: window.innerHeight,\n      });\n      const current = this.anchoredPositions.get(record.id);\n      if (\n        !current ||\n        current.x !== position.x ||\n        current.y !== position.y ||\n        current.side !== position.resolvedSide\n      ) {\n        this.anchoredPositions.set(record.id, {\n          x: position.x,\n          y: position.y,\n          side: position.resolvedSide,\n        });\n        changed = true;\n      }\n    }\n    if (changed) this.layoutVersion += 1;\n  }\n\n  private resolveAnchor(anchor: HTMLElement | string): HTMLElement | null {\n    return typeof anchor === 'string' ? document.getElementById(anchor) : anchor;\n  }\n\n  private positionerElement(id: string): HTMLElement | null {\n    return (\n      Array.from(this.el.querySelectorAll<HTMLElement>('.toast-positioner'))\n        .find(element => element.dataset['toastId'] === id) ?? null\n    );\n  }\n\n  private ensureDomId(id: string): number {\n    const current = this.domIds.get(id);\n    if (current) return current;\n    const next = ++this.nextDomId;\n    this.domIds.set(id, next);\n    return next;\n  }\n\n  private get activeRecords(): ToastRecord[] {\n    return this.records.filter(record => record.transitionStatus !== 'ending');\n  }\n\n  private globalLayout() {\n    const globalRecords = this.records.filter(record => !record.positioner);\n    let offset = 0;\n    let visibleIndex = 0;\n    const gap = resolveCssLengthPx(undefined, TOKEN_DEFAULTS.space200);\n    const layouts = new Map<string, { index: number; offset: number; limited: boolean }>();\n\n    globalRecords.forEach((record, domIndex) => {\n      if (record.transitionStatus === 'ending') {\n        layouts.set(record.id, { index: domIndex, offset, limited: false });\n        return;\n      }\n\n      const limited = visibleIndex >= Math.max(1, this.limit);\n      layouts.set(record.id, { index: visibleIndex, offset, limited });\n      offset += (this.heights.get(record.id) ?? 0) + gap;\n      visibleIndex += 1;\n    });\n    return layouts;\n  }\n\n  private renderToast(\n    record: ToastRecord,\n    layout: { index: number; offset: number; limited: boolean },\n  ) {\n    const domId = this.ensureDomId(record.id);\n    const titleId = `ds-toast-${this.instanceId}-${domId}-title`;\n    const descriptionId = `ds-toast-${this.instanceId}-${domId}-description`;\n    const swipe = this.swipe?.id === record.id ? this.swipe : null;\n    const swipeDirection = swipe?.direction ?? this.dismissedSwipeDirections.get(record.id);\n    const anchored = !!record.positioner;\n    const anchoredPosition = this.anchoredPositions.get(record.id);\n    const hiddenHighPriority = record.priority === 'high' && !this.keyboardActive;\n    const focusTabIndex = this.keyboardActive && !layout.limited ? 0 : -1;\n    const toastHeight = this.heights.get(record.id);\n\n    return (\n      <div\n        ref={(element?: HTMLDivElement) => this.bindAnimationCancel(element, record.id)}\n        class={{\n          'toast-positioner': true,\n          'toast-positioner--anchored': anchored,\n          'toast-positioner--ending': record.transitionStatus === 'ending',\n        }}\n        data-toast-id={record.id}\n        data-behind={!anchored && layout.index > 0 ? '' : undefined}\n        data-limited={layout.limited ? '' : undefined}\n        data-positioned={anchored ? String(!!anchoredPosition) : undefined}\n        data-side={anchoredPosition?.side}\n        inert={layout.limited ? true : undefined}\n        aria-hidden={layout.limited ? 'true' : undefined}\n        style={{\n          '--toast-index': String(layout.index),\n          '--toast-offset-y': `${layout.offset}px`,\n          '--toast-height': toastHeight ? `${toastHeight}px` : undefined,\n          zIndex: String(this.records.length - layout.index),\n          left: anchoredPosition ? `${anchoredPosition.x}px` : undefined,\n          top: anchoredPosition ? `${anchoredPosition.y}px` : undefined,\n        }}\n        onAnimationEnd={() => this.handleAnimationComplete(record)}\n      >\n        <div\n          class={{\n            'toast-surface': true,\n            'toast-surface--swiping': !!swipe,\n          }}\n          role={record.priority === 'high' ? 'alertdialog' : 'dialog'}\n          aria-modal=\"false\"\n          aria-labelledby={\n            record.title ? titleId : record.description ? descriptionId : undefined\n          }\n          aria-describedby={record.title && record.description ? descriptionId : undefined}\n          aria-hidden={hiddenHighPriority ? 'true' : undefined}\n          data-type={record.type}\n          data-priority={record.priority}\n          data-transition-status={record.transitionStatus}\n          data-swiping={swipe ? '' : undefined}\n          data-swipe-direction={swipeDirection}\n          style={{\n            '--toast-swipe-movement-x': `${swipe?.x ?? 0}px`,\n            '--toast-swipe-movement-y': `${swipe?.y ?? 0}px`,\n            touchAction: this.touchAction,\n          }}\n          onPointerDown={(event: PointerEvent) => this.handlePointerDown(record, event)}\n          onPointerMove={(event: PointerEvent) => this.handlePointerMove(event)}\n          onPointerUp={(event: PointerEvent) => this.handlePointerUp(event)}\n          onPointerCancel={(event: PointerEvent) => this.handlePointerCancel(event)}\n          onPointerEnter={\n            anchored ? () => this.handlePointerEnter(record.id) : undefined\n          }\n          onPointerLeave={\n            anchored ? () => this.handlePointerLeave(record.id) : undefined\n          }\n        >\n          <div class=\"toast-content\">\n            <div class=\"toast-copy\">\n              {record.title && (\n                <ds-text\n                  class=\"toast-title\"\n                  as=\"div\"\n                  variant=\"text-title-small\"\n                  color=\"primary\"\n                  textId={titleId}\n                >\n                  {record.title}\n                </ds-text>\n              )}\n              {record.description && (\n                <ds-text\n                  class=\"toast-description\"\n                  as=\"div\"\n                  variant=\"text-body-medium\"\n                  color=\"secondary\"\n                  textId={descriptionId}\n                >\n                  {record.description}\n                </ds-text>\n              )}\n            </div>\n            {record.action && (\n              <ds-button-unfilled\n                class=\"toast-action\"\n                variant=\"label\"\n                size=\"md\"\n                type=\"button\"\n                label={record.action.label}\n                aria-label={record.action.ariaLabel}\n                hasBorder\n                focusTabIndex={focusTabIndex}\n                aria-hidden={!this.keyboardActive ? 'true' : undefined}\n                onDsClick={(event: CustomEvent<MouseEvent>) =>\n                  this.handleAction(record, event)\n                }\n              />\n            )}\n          </div>\n          <ds-button-unfilled\n            class=\"toast-close\"\n            variant=\"icon\"\n            size=\"md\"\n            type=\"button\"\n            icon=\"Cross\"\n            aria-label={this.closeLabel}\n            hasBorder={false}\n            activeFill={false}\n            focusTabIndex={focusTabIndex}\n            aria-hidden={!this.keyboardActive ? 'true' : undefined}\n            onDsClick={() => this.manager.close(record.id, 'close-button')}\n          />\n        </div>\n      </div>\n    );\n  }\n\n  render() {\n    void this.layoutVersion;\n    const globalLayouts = this.globalLayout();\n    const globalRecords = this.records.filter(record => !record.positioner);\n    const anchoredRecords = this.records.filter(record => !!record.positioner);\n    const highPriority = this.records.filter(\n      record =>\n        record.priority === 'high' &&\n        record.transitionStatus !== 'ending' &&\n        !globalLayouts.get(record.id)?.limited,\n    );\n\n    return (\n      <Host>\n        <section\n          class=\"toast-region\"\n          role=\"region\"\n          aria-label={this.label}\n          aria-live=\"polite\"\n          aria-atomic=\"false\"\n          aria-relevant=\"additions text\"\n          tabIndex={-1}\n          onFocusin={this.handleFocusIn}\n          onFocusout={(event: FocusEvent) => this.handleFocusOut(event)}\n          onKeyDown={(event: KeyboardEvent) => this.handleRegionKeyDown(event)}\n        >\n          <div\n            class=\"toast-viewport\"\n            data-expanded={this.expanded ? '' : undefined}\n            onPointerEnter={() => this.handlePointerEnter(GLOBAL_STACK_HOVER)}\n            onPointerLeave={() => this.handlePointerLeave(GLOBAL_STACK_HOVER)}\n          >\n            {globalRecords.map(record =>\n              this.renderToast(\n                record,\n                globalLayouts.get(record.id) ?? { index: 0, offset: 0, limited: false },\n              )\n            )}\n          </div>\n          <div class=\"toast-anchored-layer\">\n            {anchoredRecords.map(record =>\n              this.renderToast(record, { index: 0, offset: 0, limited: false })\n            )}\n          </div>\n          <div class=\"toast-assertive-announcer ds-visually-hidden\">\n            {highPriority.map(record => (\n              <div role=\"alert\" aria-atomic=\"true\">\n                {[record.title, record.description].filter(Boolean).join('. ')}\n              </div>\n            ))}\n          </div>\n        </section>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

package/dist/react/components.d.ts

@@ -43,6 +43,10 @@ export { DsMessageBubble } from "./ds-message-bubble.js";
 export { DsMessageComposer } from "./ds-message-composer.js";
 export { DsMessageScroller } from "./ds-message-scroller.js";
 export { DsMessage } from "./ds-message.js";
+export { DsMobileBarNav } from "./ds-mobile-bar-nav.js";
+export { DsMobileHeader } from "./ds-mobile-header.js";
+export { DsMobileSectionSwitcher } from "./ds-mobile-section-switcher.js";
+export { DsMobileSheetNav } from "./ds-mobile-sheet-nav.js";
 export { DsModal } from "./ds-modal.js";
 export { DsPanelNav } from "./ds-panel-nav.js";
 export { DsPanelSubNav } from "./ds-panel-sub-nav.js";
@@ -56,9 +60,6 @@ export { DsSelect } from "./ds-select.js";
 export { DsShellApp } from "./ds-shell-app.js";
 export { DsShellGradientPicker } from "./ds-shell-gradient-picker.js";
 export { DsShellGradientSwatch } from "./ds-shell-gradient-swatch.js";
-export { DsShellMobileBar } from "./ds-shell-mobile-bar.js";
-export { DsShellMobileNav } from "./ds-shell-mobile-nav.js";
-export { DsShellMobileSectionNav } from "./ds-shell-mobile-section-nav.js";
 export { DsShellPage } from "./ds-shell-page.js";
 export { DsShellTools } from "./ds-shell-tools.js";
 export { DsSkeleton } from "./ds-skeleton.js";

package/dist/react/components.js

@@ -44,6 +44,10 @@ export { DsMessageBubble } from "./ds-message-bubble.js";
 export { DsMessageComposer } from "./ds-message-composer.js";
 export { DsMessageScroller } from "./ds-message-scroller.js";
 export { DsMessage } from "./ds-message.js";
+export { DsMobileBarNav } from "./ds-mobile-bar-nav.js";
+export { DsMobileHeader } from "./ds-mobile-header.js";
+export { DsMobileSectionSwitcher } from "./ds-mobile-section-switcher.js";
+export { DsMobileSheetNav } from "./ds-mobile-sheet-nav.js";
 export { DsModal } from "./ds-modal.js";
 export { DsPanelNav } from "./ds-panel-nav.js";
 export { DsPanelSubNav } from "./ds-panel-sub-nav.js";
@@ -57,9 +61,6 @@ export { DsSelect } from "./ds-select.js";
 export { DsShellApp } from "./ds-shell-app.js";
 export { DsShellGradientPicker } from "./ds-shell-gradient-picker.js";
 export { DsShellGradientSwatch } from "./ds-shell-gradient-swatch.js";
-export { DsShellMobileBar } from "./ds-shell-mobile-bar.js";
-export { DsShellMobileNav } from "./ds-shell-mobile-nav.js";
-export { DsShellMobileSectionNav } from "./ds-shell-mobile-section-nav.js";
 export { DsShellPage } from "./ds-shell-page.js";
 export { DsShellTools } from "./ds-shell-tools.js";
 export { DsSkeleton } from "./ds-skeleton.js";

package/dist/react/ds-mobile-bar-nav.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This file was automatically generated by the Stencil React Output Target.
+ * Changes to this file may cause incorrect behavior and will be lost if the code is regenerated.
+ */
+import type { EventName, StencilReactComponent } from '@stencil/react-output-target/runtime';
+import { type DsMobileBarNavCustomEvent, type MobileBarNavDestinationDetail } from "@ds-mo/ui";
+import type { Components } from "@ds-mo/ui/dist/components";
+import { DsMobileBarNav as DsMobileBarNavElement } from "@ds-mo/ui/dist/components/ds-mobile-bar-nav.js";
+export type DsMobileBarNavEvents = {
+    onDsSheetNavToggle: EventName<DsMobileBarNavCustomEvent<boolean>>;
+    onDsDestinationChange: EventName<DsMobileBarNavCustomEvent<MobileBarNavDestinationDetail>>;
+};
+export declare const DsMobileBarNav: StencilReactComponent<DsMobileBarNavElement, DsMobileBarNavEvents, Components.DsMobileBarNav>;