@ds-mo/ui 14.27.1 → 14.29.0

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

@@ -2,7 +2,7 @@
   "$schema": "https://ui.shadcn.com/schema/registry-item.json",
   "name": "mobile-section-switcher",
   "title": "MobileSectionSwitcher",
-  "description": "Controlled mobile section chooser showing the current section, adjacent-position hints, and a complete tap menu.",
+  "description": "Controlled mobile section chooser with a viewport-edge sheet for primary pages and an anchored menu for local views.",
   "type": "registry:ui",
   "meta": {
     "library": "@ds-mo/ui",
@@ -13,7 +13,7 @@
     "intent": {
       "audience": "specialized",
       "status": "experimental",
-      "summary": "Controlled mobile section chooser showing the current section, adjacent-position hints, and a complete tap menu.",
+      "summary": "Controlled mobile section chooser with a viewport-edge sheet for primary pages and an anchored menu for local views.",
       "useWhen": [
         "A mobile page or tool header must combine current-page identity with ordered peer-section navigation."
       ],
@@ -30,13 +30,17 @@
       "accessibility": [
         "The trigger exposes the current section, popup relationship, and expanded state.",
         "Decorative previous and next position hints are hidden from assistive technology.",
-        "The menu is always available so a future swipe gesture is never the only navigation mechanism.",
+        "The sheet is a native modal top-layer dialog: background content is inert, Escape and backdrop dismiss it, and focus returns to the trigger after exit motion. Arrow keys, Home, End, and initial-letter navigation move among enabled destinations.",
+        "The sheet initially focuses the current enabled destination, uses emphasis for selection, and never adds decorative icons to its rows.",
         "Peer destinations use menuitem semantics with aria-current on the active page; they do not present a radio-control affordance."
       ],
       "states": [
         "Selection is controlled and dsChange reports intent without mutating value.",
         "Dividers group menu items but never participate in previous or next resolution.",
-        "The first and last selectable sections expose only the available neighboring direction."
+        "The anchored local-view menu retains its neighboring-direction hints; the primary-page sheet uses an unfilled perimeter trigger without hints.",
+        "A sheet trigger can combine stable page identity and the current local view, separated by a decorative middle dot. The whole control opens only the supplied local destinations; long page names truncate before crowding out the active view.",
+        "Sheet selection emits navigation intent immediately while exit motion runs independently, so the controlled title can update without waiting for dismissal. Removing the owner or hiding its header closes the top layer without leaving the application blocked.",
+        "The trigger automatically retains the shared surface-open pressed wash through menu or sheet exit. Selecting a destination remains separate from owning the open surface."
       ],
       "responsiveBehavior": [
         "Use only in the dedicated mobile header presentation."
@@ -45,6 +49,10 @@
         {
           "label": "Storybook",
           "path": "src/wc/components/MobileSectionSwitcher/MobileSectionSwitcher.stories.ts"
+        },
+        {
+          "label": "Surface ownership and trigger state",
+          "path": "src/docs/SurfaceOwnership.mdx"
         }
       ]
     },
@@ -59,6 +67,24 @@
           "mutable": false,
           "description": "Accessible name for the section chooser."
         },
+        "pageLabel": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "page-label",
+          "default": "''",
+          "required": false,
+          "mutable": false,
+          "description": "Stable page identity shown before the selected section in a sheet trigger."
+        },
+        "presentation": {
+          "type": "'menu' | 'sheet'",
+          "resolvedType": "\"menu\" | \"sheet\"",
+          "attribute": "presentation",
+          "default": "'menu'",
+          "required": false,
+          "mutable": false,
+          "description": "Anchored local-view menu or viewport-edge sheet for primary page sections."
+        },
         "sections": {
           "type": "TabItem[]",
           "resolvedType": "TabItem[]",
@@ -100,6 +126,24 @@
         "mutable": false,
         "description": "Accessible name for the section chooser."
       },
+      "pageLabel": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "page-label",
+        "default": "''",
+        "required": false,
+        "mutable": false,
+        "description": "Stable page identity shown before the selected section in a sheet trigger."
+      },
+      "presentation": {
+        "type": "'menu' | 'sheet'",
+        "resolvedType": "\"menu\" | \"sheet\"",
+        "attribute": "presentation",
+        "default": "'menu'",
+        "required": false,
+        "mutable": false,
+        "description": "Anchored local-view menu or viewport-edge sheet for primary page sections."
+      },
       "sections": {
         "type": "TabItem[]",
         "resolvedType": "TabItem[]",
@@ -176,12 +220,12 @@
   "files": [
     {
       "path": "src/wc/components/MobileSectionSwitcher/MobileSectionSwitcher.css",
-      "content": "@import '../../utils/focus-ring.css';\n@import '../../utils/interaction-fill.css';\n\n:host {\n  display: block;\n  min-width: 0;\n  max-width: 100%;\n  color: var(--color-foreground-primary);\n}\n\n.mobile-section-switcher {\n  appearance: none;\n  display: grid;\n  grid-template-columns: var(--dimension-size-100) minmax(0, auto) var(--dimension-size-100);\n  align-items: center;\n  justify-content: center;\n  gap: var(--dimension-space-050);\n  max-width: 100%;\n  min-height: var(--dimension-size-400);\n  padding-inline: var(--dimension-space-100);\n  border: 0;\n  border-radius: var(--dimension-radius-100);\n  background: var(--color-background-secondary);\n  color: inherit;\n  box-sizing: border-box;\n  cursor: default;\n}\n\n.mobile-section-switcher--expanded {\n  background: var(--color-background-tertiary);\n}\n\n.mobile-section-switcher__label {\n  min-width: 0;\n  max-width: 100%;\n  text-align: center;\n}\n\n.mobile-section-switcher__position {\n  width: var(--dimension-size-050);\n  height: var(--dimension-size-050);\n  border-radius: var(--dimension-radius-half);\n  background: currentColor;\n  opacity: 0;\n}\n\n.mobile-section-switcher__position--visible {\n  opacity: 1;\n}\n",
+      "content": "@import '../../utils/focus-ring.css';\n@import '../../utils/interaction-fill.css';\n@import '../../utils/control-density.css';\n\n:host {\n  display: block;\n  min-width: 0;\n  max-width: 100%;\n  color: var(--color-foreground-primary);\n}\n\n.mobile-section-switcher {\n  appearance: none;\n  display: grid;\n  grid-template-columns: var(--dimension-size-100) minmax(0, auto) var(--dimension-size-100);\n  align-items: center;\n  justify-content: center;\n  gap: var(--dimension-space-050);\n  max-width: 100%;\n  min-height: var(--dimension-size-400);\n  padding-inline: var(--dimension-space-100);\n  border: 0;\n  border-radius: var(--dimension-radius-100);\n  background: var(--color-background-secondary);\n  color: inherit;\n  box-sizing: border-box;\n  cursor: default;\n}\n\n.mobile-section-switcher__label {\n  min-width: 0;\n  max-width: 100%;\n  text-align: center;\n}\n\n.mobile-section-switcher__position {\n  width: var(--dimension-size-050);\n  height: var(--dimension-size-050);\n  border-radius: var(--dimension-radius-half);\n  background: currentColor;\n  opacity: 0;\n}\n\n.mobile-section-switcher__position--visible {\n  opacity: 1;\n}\n\n.mobile-section-switcher--sheet {\n  grid-template-columns: minmax(0, auto);\n  min-height: var(--dimension-size-500);\n  padding-inline: var(--dimension-space-150);\n  border-radius: var(--dimension-radius-half);\n  background: transparent;\n  --ds-interaction-border-width: var(--dimension-stroke-width-012);\n  --ds-interaction-border-color: var(--color-border-tertiary);\n}\n\n.mobile-section-switcher--combined {\n  display: flex;\n}\n\n.mobile-section-switcher__page-label {\n  flex: 0 1 auto;\n  min-width: 0;\n}\n\n.mobile-section-switcher__separator {\n  flex: 0 0 auto;\n}\n\n.mobile-section-switcher--combined .mobile-section-switcher__label {\n  flex: 0 0 auto;\n  max-width: 50%;\n}\n\n.mobile-section-sheet {\n  position: fixed;\n  inset: 0 0 auto;\n  width: 100%;\n  max-width: none;\n  max-height: calc(100dvh - var(--dimension-size-500) - var(--dimension-space-200));\n  margin: 0;\n  padding: 0;\n  border: 0;\n  border-radius: 0;\n  box-sizing: border-box;\n  overflow: hidden;\n  background: var(--color-background-primary);\n  color: var(--color-foreground-secondary);\n  box-shadow: var(--effect-elevation-elevated-floating);\n  outline: none;\n}\n\n.mobile-section-sheet[open] {\n  display: flex;\n  flex-direction: column;\n  animation: mobileSectionSheetIn var(--effect-motion-short-2) both;\n}\n\n.mobile-section-sheet::backdrop {\n  background: var(--color-background-shade);\n  animation: mobileSectionShadeIn var(--effect-motion-short-2) both;\n}\n\n.mobile-section-sheet--closing[open] {\n  animation-name: mobileSectionSheetOut;\n}\n\n.mobile-section-sheet--closing::backdrop {\n  animation-name: mobileSectionShadeOut;\n}\n\n.mobile-section-sheet__items {\n  display: flex;\n  flex-direction: column;\n  gap: var(--dimension-space-100);\n  min-height: 0;\n  padding: var(--dimension-space-100);\n  padding-block-start: max(var(--dimension-space-100), env(safe-area-inset-top, 0px));\n  overflow-y: auto;\n  overscroll-behavior: contain;\n}\n\n.mobile-section-sheet__item {\n  appearance: none;\n  flex: 0 0 auto;\n  display: flex;\n  align-items: center;\n  height: var(--ds-control-height);\n  width: 100%;\n  min-width: 0;\n  padding: 0 var(--ds-control-padding-inline);\n  box-sizing: border-box;\n  border: 0;\n  border-radius: var(--ds-control-radius);\n  background: transparent;\n  color: inherit;\n  text-align: start;\n}\n\n.mobile-section-sheet__item[aria-current='page'] {\n  color: var(--color-foreground-primary);\n}\n\n.mobile-section-sheet__item:disabled {\n  color: var(--color-foreground-tertiary);\n}\n\n.mobile-section-sheet__label {\n  min-width: 0;\n  padding-inline: var(--ds-control-label-inset);\n}\n\n.mobile-section-sheet__divider {\n  flex: 0 0 auto;\n  height: var(--dimension-stroke-width-012);\n  margin-inline: var(--dimension-space-100);\n  background: var(--color-border-tertiary);\n}\n\n@keyframes mobileSectionSheetIn {\n  from {\n    transform: translateY(-100%);\n  }\n  to {\n    transform: translateY(0);\n  }\n}\n\n@keyframes mobileSectionSheetOut {\n  from {\n    transform: translateY(0);\n  }\n  to {\n    transform: translateY(-100%);\n  }\n}\n\n@keyframes mobileSectionShadeIn {\n  from {\n    opacity: 0;\n  }\n  to {\n    opacity: 1;\n  }\n}\n\n@keyframes mobileSectionShadeOut {\n  from {\n    opacity: 1;\n  }\n  to {\n    opacity: 0;\n  }\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .mobile-section-sheet[open],\n  .mobile-section-sheet::backdrop {\n    animation: none;\n  }\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/MobileSectionSwitcher/MobileSectionSwitcher.tsx",
-      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Prop,\n  State,\n  Watch,\n} from '@stencil/core';\nimport type { MenuItemData, MenuSection } from '../Menu/menu-types';\nimport {\n  getSelectableTabs,\n  isTabDivider,\n  type TabItem,\n  type TabItemTab,\n} from '../TabGroup/tab-item-utils';\nimport { resolveMobileSectionPosition } from './mobile-section-switcher-utils';\n\nlet nextMobileSectionSwitcherId = 0;\n\n@Component({\n  tag: 'ds-mobile-section-switcher',\n  styleUrl: 'MobileSectionSwitcher.css',\n  scoped: true,\n})\nexport class MobileSectionSwitcher {\n  @Element() el!: HTMLElement;\n\n  /** Ordered controlled sections. Divider entries group the popup menu. */\n  @Prop() sections: TabItem[] = [];\n  /** Controlled selected section id. */\n  @Prop() value: string = '';\n  /** Accessible name for the section chooser. */\n  @Prop() navigationLabel: string = 'Change page section';\n\n  /** Selection intent. The route, tool, or workflow owner updates `value`. */\n  @Event() dsChange!: EventEmitter<string>;\n\n  @State() private menuOpen = false;\n  @State() private initialFocusVisible = false;\n\n  private readonly instanceId = nextMobileSectionSwitcherId++;\n  private readonly triggerId = `ds-mobile-section-switcher-trigger-${this.instanceId}`;\n  private readonly menuId = `ds-mobile-section-switcher-menu-${this.instanceId}`;\n  private triggerEl: HTMLButtonElement | null = null;\n\n  private get resolvedSections(): TabItem[] {\n    return this.sections ?? [];\n  }\n\n  private get selectableSections(): TabItemTab[] {\n    return getSelectableTabs(this.resolvedSections);\n  }\n\n  private get selectedIndex(): number {\n    return resolveMobileSectionPosition(this.resolvedSections, this.value).selectedIndex;\n  }\n\n  private get selectedSection(): TabItemTab | undefined {\n    return this.selectableSections[this.selectedIndex];\n  }\n\n  private get hasPrevious(): boolean {\n    return resolveMobileSectionPosition(this.resolvedSections, this.value).hasPrevious;\n  }\n\n  private get hasNext(): boolean {\n    return resolveMobileSectionPosition(this.resolvedSections, this.value).hasNext;\n  }\n\n  private get triggerAriaLabel(): string {\n    return `${this.navigationLabel}. Current section: ${this.selectedSection?.label ?? ''}`;\n  }\n\n  private get menuSections(): MenuSection[] {\n    const groups: MenuSection[] = [];\n    let items: MenuItemData[] = [];\n    const commit = () => {\n      if (items.length) groups.push({ items });\n      items = [];\n    };\n\n    for (const section of this.resolvedSections) {\n      if (isTabDivider(section)) {\n        commit();\n        continue;\n      }\n      items.push({\n        label: section.label,\n        value: section.id,\n        dot: section.dot,\n        isSelected: section.id === this.selectedSection?.id,\n        isInactive: section.isInactive,\n      });\n    }\n    commit();\n    return groups;\n  }\n\n  @Watch('sections')\n  handleSectionsChange() {\n    if (this.selectableSections.length <= 1) this.closeMenu();\n  }\n\n  private toggleMenu = (event: MouseEvent) => {\n    if (this.selectableSections.length <= 1) return;\n    this.initialFocusVisible = event.detail === 0;\n    this.menuOpen = !this.menuOpen;\n  };\n\n  private closeMenu = () => {\n    this.menuOpen = false;\n  };\n\n  private handleSelect = (event: CustomEvent<MenuItemData>) => {\n    const id = String(event.detail.value ?? '');\n    const section = this.selectableSections.find(candidate => candidate.id === id);\n    if (!section || section.isInactive) return;\n    this.closeMenu();\n    if (id !== this.selectedSection?.id) this.dsChange.emit(id);\n    requestAnimationFrame(() => this.triggerEl?.focus());\n  };\n\n  render() {\n    const selected = this.selectedSection;\n    if (!selected) return <Host />;\n\n    return (\n      <Host>\n        <button\n          ref={element => {\n            this.triggerEl = element ?? null;\n          }}\n          id={this.triggerId}\n          class={{\n            'mobile-section-switcher': true,\n            'mobile-section-switcher--expanded': this.menuOpen,\n            'ds-focus-ring-inset': true,\n            'ds-interaction-fill': true,\n          }}\n          type=\"button\"\n          aria-haspopup=\"menu\"\n          aria-controls={this.menuId}\n          aria-expanded={String(this.menuOpen)}\n          aria-label={this.triggerAriaLabel}\n          onClick={this.toggleMenu}\n        >\n          <span\n            class={{\n              'mobile-section-switcher__position': true,\n              'mobile-section-switcher__position--visible': this.hasPrevious,\n              'ds-interaction-fill__content': true,\n            }}\n            aria-hidden=\"true\"\n          />\n          <ds-text\n            class=\"mobile-section-switcher__label ds-interaction-fill__content\"\n            as=\"span\"\n            variant=\"text-body-medium\"\n            emphasis\n            color=\"inherit\"\n            lineTruncation={1}\n          >\n            {selected.label}\n          </ds-text>\n          <span\n            class={{\n              'mobile-section-switcher__position': true,\n              'mobile-section-switcher__position--visible': this.hasNext,\n              'ds-interaction-fill__content': true,\n            }}\n            aria-hidden=\"true\"\n          />\n        </button>\n\n        {this.selectableSections.length > 1 ? (\n          <ds-menu\n            id={this.menuId}\n            anchorId={this.triggerId}\n            align=\"center\"\n            menuLabel={this.navigationLabel}\n            open={this.menuOpen}\n            initialFocusVisible={this.initialFocusVisible}\n            sections={this.menuSections}\n            onDsClose={this.closeMenu}\n            onDsSelect={this.handleSelect}\n          />\n        ) : null}\n      </Host>\n    );\n  }\n}\n",
+      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Prop,\n  State,\n  Watch,\n} from '@stencil/core';\nimport type { MenuItemData, MenuSection } from '../Menu/menu-types';\nimport {\n  getSelectableTabs,\n  isTabDivider,\n  type TabItem,\n  type TabItemTab,\n} from '../TabGroup/tab-item-utils';\nimport { resolveMobileSectionPosition } from './mobile-section-switcher-utils';\nimport { resolveMotionTimeMs, TOKEN_DEFAULTS } from '../../utils';\n\nlet nextMobileSectionSwitcherId = 0;\n\n@Component({\n  tag: 'ds-mobile-section-switcher',\n  styleUrl: 'MobileSectionSwitcher.css',\n  scoped: true,\n})\nexport class MobileSectionSwitcher {\n  @Element() el!: HTMLElement;\n\n  /** Ordered controlled sections. Divider entries group the popup menu. */\n  @Prop() sections: TabItem[] = [];\n  /** Controlled selected section id. */\n  @Prop() value: string = '';\n  /** Accessible name for the section chooser. */\n  @Prop() navigationLabel: string = 'Change page section';\n  /** Anchored local-view menu or viewport-edge sheet for primary page sections. */\n  @Prop() presentation: 'menu' | 'sheet' = 'menu';\n  /** Stable page identity shown before the selected section in a sheet trigger. */\n  @Prop() pageLabel: string = '';\n\n  /** Selection intent. The route, tool, or workflow owner updates `value`. */\n  @Event() dsChange!: EventEmitter<string>;\n\n  @State() private menuOpen = false;\n  @State() private menuSurfaceOpen = false;\n  @State() private initialFocusVisible = false;\n  @State() private sheetClosing = false;\n  @State() private focusedSection = '';\n\n  private readonly instanceId = nextMobileSectionSwitcherId++;\n  private readonly triggerId = `ds-mobile-section-switcher-trigger-${this.instanceId}`;\n  private readonly menuId = `ds-mobile-section-switcher-menu-${this.instanceId}`;\n  private triggerEl: HTMLButtonElement | null = null;\n  private dialogEl: HTMLDialogElement | null = null;\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  private visibilityObserver?: ResizeObserver;\n\n  componentDidLoad() {\n    this.visibilityObserver = new ResizeObserver(() => {\n      if (this.dialogEl?.open && !this.triggerEl?.getClientRects().length) {\n        this.finishSheetClose(false);\n      }\n    });\n    this.visibilityObserver.observe(this.el);\n  }\n\n  componentDidRender() {\n    if (!this.dialogEl) return;\n    if (this.presentation === 'sheet' && this.menuOpen && !this.dialogEl.open) {\n      const initialSection = this.focusedSection;\n      this.dialogEl.showModal();\n      this.focusSheetItem(initialSection);\n    }\n    if (this.sheetClosing && this.dialogEl.open && !this.closeTimer) {\n      const duration = resolveMotionTimeMs(\n        TOKEN_DEFAULTS.motionShort2,\n        TOKEN_DEFAULTS.animationDurationShort3\n      );\n      if (!duration) this.finishSheetClose();\n      else this.closeTimer = setTimeout(() => this.finishSheetClose(), duration);\n    }\n  }\n\n  disconnectedCallback() {\n    this.visibilityObserver?.disconnect();\n    this.menuSurfaceOpen = false;\n    this.finishSheetClose(false);\n  }\n\n  @Watch('presentation')\n  handlePresentationChange() {\n    this.menuSurfaceOpen = false;\n    this.closeMenu();\n  }\n\n  @Watch('value')\n  @Watch('pageLabel')\n  handleContextChange() {\n    this.closeMenu();\n  }\n\n  private finishSheetClose(restoreFocus = true) {\n    if (this.closeTimer) clearTimeout(this.closeTimer);\n    this.closeTimer = null;\n    const wasOpen = this.dialogEl?.open;\n    this.dialogEl?.close();\n    this.menuOpen = false;\n    this.sheetClosing = false;\n    if (wasOpen && restoreFocus && this.triggerEl?.getClientRects().length) this.triggerEl.focus();\n  }\n\n  private focusSheetItem(id: string) {\n    const buttons = Array.from(this.dialogEl?.querySelectorAll<HTMLButtonElement>('button') ?? []);\n    const button =\n      buttons.find(item => item.value === id && !item.disabled) ??\n      buttons.find(item => !item.disabled);\n    if (button) {\n      this.focusedSection = button.value;\n      button.focus();\n    } else this.dialogEl?.focus();\n  }\n\n  private handleSheetKeyDown = (event: KeyboardEvent) => {\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      event.stopPropagation();\n      this.closeMenu();\n      return;\n    }\n    const sections = this.selectableSections.filter(section => !section.isInactive);\n    if (!sections.length) return;\n    const index = Math.max(\n      0,\n      sections.findIndex(section => section.id === this.focusedSection)\n    );\n    let next: number;\n    if (event.key === 'ArrowDown') next = (index + 1) % sections.length;\n    else if (event.key === 'ArrowUp') next = (index + sections.length - 1) % sections.length;\n    else if (event.key === 'Home') next = 0;\n    else if (event.key === 'End') next = sections.length - 1;\n    else if (event.key === 'Tab') next = index;\n    else if (\n      event.key.length === 1 &&\n      !event.ctrlKey &&\n      !event.metaKey &&\n      !event.altKey &&\n      event.key !== ' '\n    ) {\n      const match = sections.findIndex((_, offset) =>\n        sections[(index + offset + 1) % sections.length].label\n          .toLowerCase()\n          .startsWith(event.key.toLowerCase())\n      );\n      if (match < 0) return;\n      next = (index + match + 1) % sections.length;\n    } else return;\n    event.preventDefault();\n    this.initialFocusVisible = true;\n    this.focusSheetItem(sections[next].id);\n  };\n\n  private get resolvedSections(): TabItem[] {\n    return this.sections ?? [];\n  }\n\n  private get selectableSections(): TabItemTab[] {\n    return getSelectableTabs(this.resolvedSections);\n  }\n\n  private get selectedIndex(): number {\n    return resolveMobileSectionPosition(this.resolvedSections, this.value).selectedIndex;\n  }\n\n  private get selectedSection(): TabItemTab | undefined {\n    return this.selectableSections[this.selectedIndex];\n  }\n\n  private get hasPrevious(): boolean {\n    return resolveMobileSectionPosition(this.resolvedSections, this.value).hasPrevious;\n  }\n\n  private get hasNext(): boolean {\n    return resolveMobileSectionPosition(this.resolvedSections, this.value).hasNext;\n  }\n\n  private get triggerAriaLabel(): string {\n    return `${this.presentation === 'sheet' && this.pageLabel ? `${this.pageLabel}. ` : ''}${this.navigationLabel}. Current section: ${this.selectedSection?.label ?? ''}`;\n  }\n\n  private get menuSections(): MenuSection[] {\n    const groups: MenuSection[] = [];\n    let items: MenuItemData[] = [];\n    const commit = () => {\n      if (items.length) groups.push({ items });\n      items = [];\n    };\n\n    for (const section of this.resolvedSections) {\n      if (isTabDivider(section)) {\n        commit();\n        continue;\n      }\n      items.push({\n        label: section.label,\n        value: section.id,\n        dot: section.dot,\n        isSelected: section.id === this.selectedSection?.id,\n        isInactive: section.isInactive,\n      });\n    }\n    commit();\n    return groups;\n  }\n\n  @Watch('sections')\n  handleSectionsChange() {\n    if (this.selectableSections.length <= 1) {\n      this.closeMenu();\n      this.menuSurfaceOpen = false;\n    } else if (this.dialogEl?.open && !this.sheetClosing) this.focusSheetItem(this.focusedSection);\n  }\n\n  private toggleMenu = (event: MouseEvent) => {\n    if (this.selectableSections.length <= 1) return;\n    this.initialFocusVisible = event.detail === 0;\n    if (this.presentation === 'sheet') {\n      if (this.menuOpen) this.closeMenu();\n      else {\n        this.focusedSection = this.selectedSection?.id ?? '';\n        this.menuOpen = true;\n      }\n      return;\n    }\n    this.menuOpen = !this.menuOpen;\n    if (this.menuOpen) this.menuSurfaceOpen = true;\n  };\n\n  private closeMenu = () => {\n    this.menuOpen = false;\n    if (this.dialogEl?.open) this.sheetClosing = true;\n  };\n\n  private renderSheet() {\n    return (\n      <dialog\n        id={this.menuId}\n        ref={element => {\n          this.dialogEl = element ?? null;\n        }}\n        class={{ 'mobile-section-sheet': true, 'mobile-section-sheet--closing': this.sheetClosing }}\n        aria-label={this.navigationLabel}\n        tabIndex={-1}\n        onCancel={event => {\n          event.preventDefault();\n          this.closeMenu();\n        }}\n        onKeyDown={this.handleSheetKeyDown}\n        onClick={event => {\n          if (!this.dialogEl || event.target !== this.dialogEl) return;\n          const rect = this.dialogEl.getBoundingClientRect();\n          if (\n            event.clientY < rect.top ||\n            event.clientY > rect.bottom ||\n            event.clientX < rect.left ||\n            event.clientX > rect.right\n          )\n            this.closeMenu();\n        }}\n      >\n        <div class=\"mobile-section-sheet__items\" role=\"menu\" aria-label={this.navigationLabel}>\n          {this.resolvedSections.map(section =>\n            isTabDivider(section) ? (\n              <div class=\"mobile-section-sheet__divider\" role=\"separator\" />\n            ) : (\n              <button\n                type=\"button\"\n                role=\"menuitem\"\n                value={section.id}\n                disabled={section.isInactive}\n                aria-current={section.id === this.selectedSection?.id ? 'page' : undefined}\n                tabIndex={section.id === this.focusedSection ? 0 : -1}\n                class={{\n                  'mobile-section-sheet__item': true,\n                  'ds-control--lg': true,\n                  'ds-interaction-fill': true,\n                  'ds-focus-ring-inset': true,\n                  'ds-focus-ring--visible':\n                    this.initialFocusVisible && section.id === this.focusedSection,\n                }}\n                onFocus={() => {\n                  this.focusedSection = section.id;\n                }}\n                onClick={() => {\n                  if (this.sheetClosing || section.isInactive) return;\n                  this.closeMenu();\n                  if (section.id !== this.selectedSection?.id) this.dsChange.emit(section.id);\n                }}\n              >\n                <ds-text\n                  class=\"mobile-section-sheet__label ds-interaction-fill__content\"\n                  as=\"span\"\n                  variant=\"text-body-large\"\n                  color=\"inherit\"\n                  emphasis={section.id === this.selectedSection?.id}\n                  lineTruncation={1}\n                >\n                  {section.label}\n                </ds-text>\n              </button>\n            )\n          )}\n        </div>\n      </dialog>\n    );\n  }\n\n  private handleSelect = (event: CustomEvent<MenuItemData>) => {\n    const id = String(event.detail.value ?? '');\n    const section = this.selectableSections.find(candidate => candidate.id === id);\n    if (!section || section.isInactive) return;\n    this.closeMenu();\n    if (id !== this.selectedSection?.id) this.dsChange.emit(id);\n    requestAnimationFrame(() => this.triggerEl?.focus());\n  };\n\n  render() {\n    const selected = this.selectedSection;\n    if (!selected) return <Host />;\n    const combined = this.presentation === 'sheet' && !!this.pageLabel;\n\n    return (\n      <Host>\n        <button\n          ref={element => {\n            this.triggerEl = element ?? null;\n          }}\n          id={this.triggerId}\n          class={{\n            'mobile-section-switcher': true,\n            'mobile-section-switcher--expanded': this.menuOpen,\n            'ds-interaction-fill--surface-open':\n              this.menuSurfaceOpen || this.menuOpen || this.sheetClosing,\n            'mobile-section-switcher--sheet': this.presentation === 'sheet',\n            'mobile-section-switcher--combined': combined,\n            'ds-focus-ring-inset': true,\n            'ds-interaction-fill': true,\n          }}\n          type=\"button\"\n          aria-haspopup={this.presentation === 'sheet' ? 'dialog' : 'menu'}\n          aria-controls={this.menuId}\n          aria-expanded={String(this.menuOpen)}\n          aria-label={this.triggerAriaLabel}\n          onClick={this.toggleMenu}\n        >\n          {this.presentation === 'menu' ? (\n            <span\n              class={{\n                'mobile-section-switcher__position': true,\n                'mobile-section-switcher__position--visible': this.hasPrevious,\n                'ds-interaction-fill__content': true,\n              }}\n              aria-hidden=\"true\"\n            />\n          ) : null}\n          {combined\n            ? [\n                <ds-text\n                  class=\"mobile-section-switcher__page-label ds-interaction-fill__content\"\n                  as=\"span\"\n                  variant=\"text-body-large\"\n                  emphasis\n                  color=\"inherit\"\n                  lineTruncation={1}\n                >\n                  {this.pageLabel}\n                </ds-text>,\n                <ds-text\n                  class=\"mobile-section-switcher__separator ds-interaction-fill__content\"\n                  as=\"span\"\n                  variant=\"text-body-large\"\n                  color=\"inherit\"\n                  aria-hidden=\"true\"\n                >\n                  ·\n                </ds-text>,\n              ]\n            : null}\n          <ds-text\n            class=\"mobile-section-switcher__label ds-interaction-fill__content\"\n            as=\"span\"\n            variant={this.presentation === 'sheet' ? 'text-body-large' : 'text-body-medium'}\n            emphasis\n            color=\"inherit\"\n            lineTruncation={1}\n          >\n            {selected.label}\n          </ds-text>\n          {this.presentation === 'menu' ? (\n            <span\n              class={{\n                'mobile-section-switcher__position': true,\n                'mobile-section-switcher__position--visible': this.hasNext,\n                'ds-interaction-fill__content': true,\n              }}\n              aria-hidden=\"true\"\n            />\n          ) : null}\n        </button>\n\n        {this.presentation === 'sheet' || this.sheetClosing ? (\n          this.renderSheet()\n        ) : this.selectableSections.length > 1 ? (\n          <ds-menu\n            id={this.menuId}\n            anchorId={this.triggerId}\n            align=\"center\"\n            menuLabel={this.navigationLabel}\n            open={this.menuOpen}\n            initialFocusVisible={this.initialFocusVisible}\n            sections={this.menuSections}\n            onDsClose={this.closeMenu}\n            onDsAfterClose={() => {\n              if (!this.menuOpen) this.menuSurfaceOpen = false;\n            }}\n            onDsSelect={this.handleSelect}\n          />\n        ) : null}\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     },
     {

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

@@ -34,7 +34,10 @@
         "Escape requests dismissal and opening moves focus to the selected or first available area."
       ],
       "states": [
-        "Dashboard and Settings change only the flat destination collection being browsed.",
+        "Dashboard and Settings change only the destination collection being browsed.",
+        "In nested mode, parents with child routes disclose inline without navigating. Only selecting a child emits route intent; parents without children retain direct navigation.",
+        "Nested branches use the same positional divider and staggered child motion as expanded desktop navigation, without adding disclosure chevrons. Dividers separate an expanded branch from its siblings, not from the outside edge of its group.",
+        "Opening the sheet reveals the current route's branch. Collapsed child groups are inert and hidden from assistive technology while the shared navigation motion runs; child targets keep the mobile row density.",
         "Area, Help, and Account events express intent while the application owns navigation and product behavior.",
         "Set routeSelectionActive to false while a global tool owns the mobile stage so the underlying router URL remains available without marking its area current.",
         "Set showAccount to false when account and user preferences already live in the supplied Settings navigation."
@@ -117,6 +120,15 @@
           "required": false,
           "mutable": false
         },
+        "presentation": {
+          "type": "PanelNavPresentation",
+          "resolvedType": "\"flat\" | \"nested\"",
+          "attribute": "presentation",
+          "default": "'flat'",
+          "required": false,
+          "mutable": false,
+          "description": "Flat area navigation or inline disclosure of each area's child routes."
+        },
         "routeSelectionActive": {
           "type": "boolean",
           "resolvedType": "boolean",
@@ -172,6 +184,14 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true
+        },
+        {
+          "name": "dsNavChildSelect",
+          "detail": "PanelNavChildSelectDetail",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "description": "Selecting a child requests routing; expanding its parent never navigates."
         }
       ],
       "methods": [],
@@ -241,6 +261,15 @@
         "required": false,
         "mutable": false
       },
+      "presentation": {
+        "type": "PanelNavPresentation",
+        "resolvedType": "\"flat\" | \"nested\"",
+        "attribute": "presentation",
+        "default": "'flat'",
+        "required": false,
+        "mutable": false,
+        "description": "Flat area navigation or inline disclosure of each area's child routes."
+      },
       "routeSelectionActive": {
         "type": "boolean",
         "resolvedType": "boolean",
@@ -296,6 +325,14 @@
         "bubbles": true,
         "cancelable": true,
         "composed": true
+      },
+      {
+        "name": "dsNavChildSelect",
+        "detail": "PanelNavChildSelectDetail",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "description": "Selecting a child requests routing; expanding its parent never navigates."
       }
     ],
     "methods": [],
@@ -351,12 +388,12 @@
   "files": [
     {
       "path": "src/wc/components/MobileSheetNav/MobileSheetNav.css",
-      "content": "@import '../../utils/control-density.css';\n@import '../../utils/chrome-layout.css';\n@import '../../utils/focus-ring.css';\n@import '../../utils/interaction-fill.css';\n\n:host {\n  display: block;\n  min-width: 0;\n  min-height: 0;\n  height: 100%;\n  background: var(--color-background-primary);\n}\n\n:host(:not([open])) {\n  display: none;\n}\n\n.mobile-sheet-nav {\n  display: grid;\n  grid-template-rows: auto minmax(0, 1fr);\n  height: 100%;\n  min-height: 0;\n  background: var(--color-background-primary);\n}\n\n.mobile-sheet-nav__header {\n  position: relative;\n  grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);\n}\n\n.mobile-sheet-nav__header--expanded-context {\n  grid-template-columns:\n    minmax(var(--dimension-size-500), 1fr)\n    minmax(0, 4fr)\n    minmax(var(--dimension-size-500), 1fr);\n}\n\n.mobile-sheet-nav__header--expanded-context .mobile-sheet-nav__context {\n  width: 100%;\n}\n\n.mobile-sheet-nav__header::after {\n  content: '';\n  position: absolute;\n  inset-inline: 0;\n  inset-block-end: 0;\n  height: var(--dimension-stroke-width-012);\n  background: var(--color-border-tertiary);\n  pointer-events: none;\n}\n\n.mobile-sheet-nav__brand {\n  display: flex;\n  align-items: center;\n  justify-content: flex-start;\n  min-width: 0;\n}\n\n.mobile-sheet-nav__logo {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: var(--dimension-size-500);\n  height: var(--dimension-size-500);\n  padding: var(--dimension-space-100);\n  box-sizing: border-box;\n  color: var(--color-foreground-primary);\n}\n\n.mobile-sheet-nav__logo-mark {\n  width: var(--dimension-iconography-lg);\n  height: var(--dimension-iconography-lg);\n  flex: 0 0 auto;\n}\n\n.mobile-sheet-nav__context {\n  justify-self: center;\n}\n\n.mobile-sheet-nav__actions {\n  display: flex;\n  align-items: center;\n  justify-content: flex-end;\n  gap: var(--dimension-space-050);\n  min-width: 0;\n}\n\n.mobile-sheet-nav__body {\n  min-height: 0;\n  overflow: auto;\n  overscroll-behavior: contain;\n}\n\n.mobile-sheet-nav__sections {\n  display: grid;\n  gap: var(--dimension-space-400);\n}\n\n.mobile-sheet-nav__items {\n  display: grid;\n  gap: var(--dimension-space-100);\n}\n\n.mobile-sheet-nav__item {\n  appearance: none;\n  width: 100%;\n  height: var(--ds-control-height);\n  min-height: var(--ds-control-height);\n  padding-inline: var(--ds-control-padding-inline);\n  border: 0;\n  border-radius: var(--ds-control-radius);\n  background: transparent;\n  color: var(--color-foreground-secondary);\n  display: flex;\n  align-items: center;\n  justify-content: flex-start;\n  gap: var(--ds-control-gap);\n  cursor: default;\n  text-align: start;\n  box-sizing: border-box;\n}\n\n.mobile-sheet-nav__item--selected {\n  color: var(--color-foreground-primary);\n}\n\n.mobile-sheet-nav__item-label {\n  min-width: 0;\n  padding-inline: var(--ds-control-label-inset);\n}\n\n.mobile-sheet-nav__dot {\n  margin-inline-start: auto;\n}\n",
+      "content": "@import '../../utils/control-density.css';\n@import '../../utils/chrome-layout.css';\n@import '../../utils/focus-ring.css';\n@import '../../utils/interaction-fill.css';\n@import '../../utils/nav-disclosure.css';\n\n:host {\n  display: block;\n  min-width: 0;\n  min-height: 0;\n  height: 100%;\n  background: var(--color-background-primary);\n}\n\n:host(:not([open])) {\n  display: none;\n}\n\n.mobile-sheet-nav {\n  display: grid;\n  grid-template-rows: auto minmax(0, 1fr);\n  height: 100%;\n  min-height: 0;\n  background: var(--color-background-primary);\n}\n\n.mobile-sheet-nav__header {\n  position: relative;\n  grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);\n}\n\n.mobile-sheet-nav__header--expanded-context {\n  grid-template-columns:\n    minmax(var(--dimension-size-500), 1fr)\n    minmax(0, 4fr)\n    minmax(var(--dimension-size-500), 1fr);\n}\n\n.mobile-sheet-nav__header--expanded-context .mobile-sheet-nav__context {\n  width: 100%;\n}\n\n.mobile-sheet-nav__header::after {\n  content: '';\n  position: absolute;\n  inset-inline: 0;\n  inset-block-end: 0;\n  height: var(--dimension-stroke-width-012);\n  background: var(--color-border-tertiary);\n  pointer-events: none;\n}\n\n.mobile-sheet-nav__brand {\n  display: flex;\n  align-items: center;\n  justify-content: flex-start;\n  min-width: 0;\n}\n\n.mobile-sheet-nav__logo {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: var(--dimension-size-500);\n  height: var(--dimension-size-500);\n  padding: var(--dimension-space-100);\n  box-sizing: border-box;\n  color: var(--color-foreground-primary);\n}\n\n.mobile-sheet-nav__logo-mark {\n  width: var(--dimension-iconography-lg);\n  height: var(--dimension-iconography-lg);\n  flex: 0 0 auto;\n}\n\n.mobile-sheet-nav__context {\n  justify-self: center;\n}\n\n.mobile-sheet-nav__actions {\n  display: flex;\n  align-items: center;\n  justify-content: flex-end;\n  gap: var(--dimension-space-050);\n  min-width: 0;\n}\n\n.mobile-sheet-nav__body {\n  min-height: 0;\n  overflow: auto;\n  overscroll-behavior: contain;\n}\n\n.mobile-sheet-nav__sections {\n  display: grid;\n  gap: var(--dimension-space-400);\n}\n\n.mobile-sheet-nav__items {\n  display: grid;\n  gap: var(--dimension-space-100);\n}\n\n.mobile-sheet-nav__item {\n  appearance: none;\n  width: 100%;\n  height: var(--ds-control-height);\n  min-height: var(--ds-control-height);\n  padding-inline: var(--ds-control-padding-inline);\n  border: 0;\n  border-radius: var(--ds-control-radius);\n  background: transparent;\n  color: var(--color-foreground-secondary);\n  display: flex;\n  align-items: center;\n  justify-content: flex-start;\n  gap: var(--ds-control-gap);\n  cursor: default;\n  text-align: start;\n  box-sizing: border-box;\n}\n\n.mobile-sheet-nav__item--selected {\n  color: var(--color-foreground-primary);\n}\n\n.mobile-sheet-nav__item-label {\n  min-width: 0;\n  padding-inline: var(--ds-control-label-inset);\n}\n\n.mobile-sheet-nav__dot {\n  margin-inline-start: auto;\n}\n\n.mobile-sheet-nav__children {\n  display: flex;\n  flex-direction: column;\n  gap: var(--dimension-space-100);\n  min-height: 0;\n  overflow: hidden;\n}\n\n.mobile-sheet-nav__child {\n  flex: 0 0 var(--ds-control-height);\n  padding-inline-start: calc(\n    var(--ds-control-padding-inline) + var(--dimension-iconography-lg) + var(--ds-control-gap)\n  );\n}\n\n.mobile-sheet-nav__child:first-child {\n  margin-block-start: var(--dimension-space-100);\n}\n\n.mobile-sheet-nav__child:disabled {\n  color: var(--color-foreground-tertiary);\n}\n\n.mobile-sheet-nav__parent--muted {\n  color: var(--color-foreground-secondary);\n}\n\n.mobile-sheet-nav__divider-line {\n  display: block;\n  height: var(--dimension-stroke-width-012);\n  margin-inline: var(--dimension-space-100);\n  background: var(--color-border-tertiary);\n}\n\n.mobile-sheet-nav__divider--before .mobile-sheet-nav__divider-line {\n  margin-block: var(--dimension-space-050) var(--dimension-space-150);\n}\n\n.mobile-sheet-nav__divider--after .mobile-sheet-nav__divider-line {\n  margin-block: var(--dimension-space-150) var(--dimension-space-050);\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/MobileSheetNav/MobileSheetNav.tsx",
-      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Listen,\n  Prop,\n  Watch,\n} from '@stencil/core';\nimport type { NavChromeStyle } from '../../shell/nav-chrome';\nimport { deriveActiveIdFromUrl } from '../PanelNav/panel-nav-utils';\nimport type { PanelNavGroup, PanelNavItem } from '../PanelNav/panel-nav-types';\n\ntype MobileSheetNavHeaderDestinationId = 'account' | 'help';\n\nconst CONTEXT_TABS = [\n  { id: 'dashboard', label: 'Dashboard', icon: 'Dashboard', variant: 'icon' as const },\n  { id: 'settings', label: 'Settings', icon: 'Gear', variant: 'icon' as const },\n];\n\n@Component({\n  tag: 'ds-mobile-sheet-nav',\n  styleUrl: 'MobileSheetNav.css',\n  scoped: true,\n})\nexport class MobileSheetNav {\n  @Element() el!: HTMLElement;\n\n  @Prop({ reflect: true }) open: boolean = false;\n  @Prop() browseContext: NavChromeStyle = 'dashboard';\n  @Prop() dashboardGroups: PanelNavGroup[] = [];\n  @Prop() settingsGroups: PanelNavGroup[] = [];\n  @Prop() currentUrl: string = '';\n  /** Whether the router-derived current area owns the active mobile stage. */\n  @Prop() routeSelectionActive: boolean = true;\n  @Prop() navigationLabel: string = 'Application navigation';\n  @Prop() dashboardLabel: string = 'Dashboard';\n  @Prop() settingsLabel: string = 'Settings';\n  @Prop() accountLabel: string = 'Account';\n  @Prop() helpLabel: string = 'Help & Support';\n  /** Show the optional Account shortcut in the sheet header. */\n  @Prop() showAccount: boolean = true;\n\n  @Event() dsAreaSelect!: EventEmitter<string>;\n  @Event() dsBrowseContextChange!: EventEmitter<NavChromeStyle>;\n  @Event() dsClose!: EventEmitter<void>;\n\n  private get groups(): PanelNavGroup[] {\n    return this.browseContext === 'settings' ? this.settingsGroups : this.dashboardGroups;\n  }\n\n  private get activeId(): string {\n    if (!this.routeSelectionActive) return '';\n    return deriveActiveIdFromUrl(this.currentUrl, [\n      ...this.dashboardGroups.flatMap(group => group.items),\n      ...this.settingsGroups.flatMap(group => group.items),\n    ]);\n  }\n\n  @Watch('open')\n  handleOpenChange(open: boolean) {\n    if (!open) return;\n    requestAnimationFrame(() => {\n      const selected = this.el.querySelector<HTMLElement>('[aria-current=\"page\"]');\n      const first = this.el.querySelector<HTMLElement>('.mobile-sheet-nav__item');\n      (selected ?? first)?.focus({ preventScroll: true });\n    });\n  }\n\n  @Listen('keydown')\n  handleKeyDown(event: KeyboardEvent) {\n    if (!this.open || event.key !== 'Escape') return;\n    event.preventDefault();\n    this.dsClose.emit();\n  }\n\n  private handleContextChange = (event: CustomEvent<string>) => {\n    const next = event.detail === 'settings' ? 'settings' : 'dashboard';\n    if (next === this.browseContext) return;\n    this.dsBrowseContextChange.emit(next);\n  };\n\n  private renderItem(item: PanelNavItem) {\n    const selected = item.id === this.activeId;\n    return (\n      <button\n        type=\"button\"\n        class={{\n          'mobile-sheet-nav__item': true,\n          'mobile-sheet-nav__item--selected': selected,\n          'ds-control--lg': true,\n          'ds-focus-ring-inset': true,\n          'ds-interaction-fill': true,\n        }}\n        aria-current={selected ? 'page' : undefined}\n        onClick={() => this.dsAreaSelect.emit(item.id)}\n      >\n        <ds-icon class=\"ds-interaction-fill__content\" name={item.icon} size=\"lg\" color=\"inherit\" />\n        <ds-text\n          class=\"mobile-sheet-nav__item-label ds-interaction-fill__content\"\n          as=\"span\"\n          variant=\"text-body-large\"\n          emphasis={selected}\n          color=\"inherit\"\n        >\n          {item.label}\n        </ds-text>\n        {item.dot && (\n          <ds-badge\n            class=\"mobile-sheet-nav__dot ds-interaction-fill__content\"\n            variant=\"dot\"\n            hasRing={false}\n            label=\"\"\n            aria-hidden=\"true\"\n          />\n        )}\n      </button>\n    );\n  }\n\n  private renderLogo() {\n    return (\n      <span class=\"mobile-sheet-nav__logo\" aria-hidden=\"true\">\n        {/* eslint-disable-next-line local/prefer-ds-icon -- Motive brand mark is not part of the IcoMo runtime catalog. */}\n        <svg\n          class=\"mobile-sheet-nav__logo-mark\"\n          viewBox=\"0 0 20 20\"\n          fill=\"none\"\n          xmlns=\"http://www.w3.org/2000/svg\"\n          focusable=\"false\"\n          aria-hidden=\"true\"\n        >\n          <path\n            d=\"M11.1159 4.31537H7.67021L2.53401 13.0703H0V15.6875H4.02716L8.24319 8.49978V15.6846H11.6342L15.8289 8.47829V15.6846H18.7122V4.3125H15.2559L11.1159 11.3648V4.31537Z\"\n            fill=\"currentColor\"\n          />\n        </svg>\n      </span>\n    );\n  }\n\n  private renderHeaderDestination(\n    id: MobileSheetNavHeaderDestinationId,\n    icon: string,\n    label: string\n  ) {\n    return (\n      <ds-tooltip label={label} side=\"bottom\" size=\"sm\">\n        <ds-button-unfilled\n          variant=\"icon\"\n          size=\"lg\"\n          icon={icon}\n          aria-label={label}\n          activeFill={false}\n          hasBorder={false}\n          onDsClick={() => this.dsAreaSelect.emit(id)}\n        />\n      </ds-tooltip>\n    );\n  }\n\n  render() {\n    const contextTabs = [\n      { ...CONTEXT_TABS[0], label: this.dashboardLabel },\n      { ...CONTEXT_TABS[1], label: this.settingsLabel },\n    ];\n\n    return (\n      <Host aria-hidden={this.open ? undefined : 'true'} inert={this.open ? undefined : true}>\n        <section id=\"ds-mobile-sheet-nav\" class=\"mobile-sheet-nav\">\n          <header\n            class={{\n              'mobile-sheet-nav__header': true,\n              'mobile-sheet-nav__header--expanded-context': !this.showAccount,\n              'ds-chrome-grid': true,\n              'ds-chrome-space--md': true,\n            }}\n          >\n            <div class=\"mobile-sheet-nav__brand\">{this.renderLogo()}</div>\n            <ds-tab-group\n              class=\"mobile-sheet-nav__context\"\n              tabs={contextTabs}\n              value={this.browseContext}\n              size=\"lg\"\n              width={this.showAccount ? 'hug' : 'fill'}\n              aria-label=\"Browse context\"\n              onDsChange={this.handleContextChange}\n            />\n            <div class=\"mobile-sheet-nav__actions\">\n              {this.renderHeaderDestination('help', 'CircleQuestion', this.helpLabel)}\n              {this.showAccount\n                ? this.renderHeaderDestination('account', 'Avatar', this.accountLabel)\n                : null}\n            </div>\n          </header>\n\n          <nav\n            class=\"mobile-sheet-nav__body ds-chrome-column ds-chrome-space--md\"\n            aria-label={this.navigationLabel}\n          >\n            <div class=\"mobile-sheet-nav__sections\">\n              {this.groups\n                .filter(group => group.items.length > 0)\n                .map(group => (\n                  <div class=\"mobile-sheet-nav__items\">\n                    {group.items.map(item => this.renderItem(item))}\n                  </div>\n                ))}\n            </div>\n          </nav>\n        </section>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Listen,\n  Prop,\n  State,\n  Watch,\n} from '@stencil/core';\nimport type { NavChromeStyle } from '../../shell/nav-chrome';\nimport { derivePanelNavSelectionFromUrl } from '../PanelNav/panel-nav-utils';\nimport type {\n  PanelNavChildItem,\n  PanelNavChildSelectDetail,\n  PanelNavGroup,\n  PanelNavItem,\n  PanelNavPresentation,\n} from '../PanelNav/panel-nav-types';\n\ntype MobileSheetNavHeaderDestinationId = 'account' | 'help';\n\nconst CONTEXT_TABS = [\n  { id: 'dashboard', label: 'Dashboard', icon: 'Dashboard', variant: 'icon' as const },\n  { id: 'settings', label: 'Settings', icon: 'Gear', variant: 'icon' as const },\n];\nlet nextSheetId = 0;\n\n@Component({\n  tag: 'ds-mobile-sheet-nav',\n  styleUrl: 'MobileSheetNav.css',\n  scoped: true,\n})\nexport class MobileSheetNav {\n  @Element() el!: HTMLElement;\n\n  @Prop({ reflect: true }) open: boolean = false;\n  @Prop() browseContext: NavChromeStyle = 'dashboard';\n  @Prop() dashboardGroups: PanelNavGroup[] = [];\n  @Prop() settingsGroups: PanelNavGroup[] = [];\n  @Prop() currentUrl: string = '';\n  /** Flat area navigation or inline disclosure of each area's child routes. */\n  @Prop() presentation: PanelNavPresentation = 'flat';\n  /** Whether the router-derived current area owns the active mobile stage. */\n  @Prop() routeSelectionActive: boolean = true;\n  @Prop() navigationLabel: string = 'Application navigation';\n  @Prop() dashboardLabel: string = 'Dashboard';\n  @Prop() settingsLabel: string = 'Settings';\n  @Prop() accountLabel: string = 'Account';\n  @Prop() helpLabel: string = 'Help & Support';\n  /** Show the optional Account shortcut in the sheet header. */\n  @Prop() showAccount: boolean = true;\n\n  @Event() dsAreaSelect!: EventEmitter<string>;\n  /** Selecting a child requests routing; expanding its parent never navigates. */\n  @Event() dsNavChildSelect!: EventEmitter<PanelNavChildSelectDetail>;\n  @Event() dsBrowseContextChange!: EventEmitter<NavChromeStyle>;\n  @Event() dsClose!: EventEmitter<void>;\n  @State() private expandedParentId = '';\n  private readonly instanceId = nextSheetId++;\n\n  private get groups(): PanelNavGroup[] {\n    return this.browseContext === 'settings' ? this.settingsGroups : this.dashboardGroups;\n  }\n\n  private get selection() {\n    return derivePanelNavSelectionFromUrl(\n      this.routeSelectionActive ? this.currentUrl : '',\n      this.groups.flatMap(group => group.items)\n    );\n  }\n\n  componentWillLoad() {\n    this.syncExpandedParent();\n  }\n\n  @Watch('presentation')\n  @Watch('currentUrl')\n  @Watch('browseContext')\n  @Watch('routeSelectionActive')\n  syncExpandedParent() {\n    this.expandedParentId = this.presentation === 'nested' ? this.selection.parentId : '';\n  }\n\n  @Watch('open')\n  handleOpenChange(open: boolean) {\n    if (!open) return;\n    this.syncExpandedParent();\n    requestAnimationFrame(() => {\n      const selected = this.el.querySelector<HTMLElement>('[aria-current=\"page\"]');\n      const first = this.el.querySelector<HTMLElement>('.mobile-sheet-nav__item:not(:disabled)');\n      (selected ?? first)?.focus({ preventScroll: true });\n    });\n  }\n\n  @Listen('keydown')\n  handleKeyDown(event: KeyboardEvent) {\n    if (!this.open || event.key !== 'Escape') return;\n    event.preventDefault();\n    this.dsClose.emit();\n  }\n\n  private handleContextChange = (event: CustomEvent<string>) => {\n    const next = event.detail === 'settings' ? 'settings' : 'dashboard';\n    if (next === this.browseContext) return;\n    this.dsBrowseContextChange.emit(next);\n  };\n\n  private renderItem(item: PanelNavItem) {\n    const selected = item.id === this.selection.parentId;\n    const disclosure = this.presentation === 'nested' && !!item.children?.length;\n    const expanded = disclosure && item.id === this.expandedParentId;\n    return (\n      <button\n        id={this.parentId(item.id)}\n        type=\"button\"\n        class={{\n          'mobile-sheet-nav__item': true,\n          'mobile-sheet-nav__item--selected': selected,\n          'mobile-sheet-nav__parent--muted':\n            this.presentation === 'nested' &&\n            this.expandedParentId !== '' &&\n            this.expandedParentId !== item.id,\n          'ds-control--lg': true,\n          'ds-focus-ring-inset': true,\n          'ds-interaction-fill': true,\n        }}\n        aria-current={selected && !disclosure ? 'page' : undefined}\n        aria-expanded={disclosure ? String(expanded) : undefined}\n        aria-controls={disclosure ? this.childrenId(item.id) : undefined}\n        onClick={() =>\n          disclosure\n            ? (this.expandedParentId = expanded ? '' : item.id)\n            : this.dsAreaSelect.emit(item.id)\n        }\n      >\n        <ds-icon class=\"ds-interaction-fill__content\" name={item.icon} size=\"lg\" color=\"inherit\" />\n        <ds-text\n          class=\"mobile-sheet-nav__item-label ds-interaction-fill__content\"\n          as=\"span\"\n          variant=\"text-body-large\"\n          emphasis={selected}\n          color=\"inherit\"\n          lineTruncation={1}\n        >\n          {item.label}\n        </ds-text>\n        {item.dot && (\n          <ds-badge\n            class=\"mobile-sheet-nav__dot ds-interaction-fill__content\"\n            variant=\"dot\"\n            hasRing={false}\n            label=\"\"\n            aria-hidden=\"true\"\n          />\n        )}\n      </button>\n    );\n  }\n\n  private parentId(id: string) {\n    return `mobile-sheet-${this.instanceId}-${encodeURIComponent(id)}`;\n  }\n  private childrenId(id: string) {\n    return `${this.parentId(id)}-children`;\n  }\n\n  private renderChild(parent: PanelNavItem, child: PanelNavChildItem, index: number) {\n    const selected = parent.id === this.selection.parentId && child.id === this.selection.childId;\n    return (\n      <button\n        type=\"button\"\n        disabled={child.isInactive}\n        class={{\n          'mobile-sheet-nav__item': true,\n          'mobile-sheet-nav__child': true,\n          'mobile-sheet-nav__item--selected': selected,\n          'ds-nav-disclosure__item': true,\n          'ds-control--lg': true,\n          'ds-focus-ring-inset': true,\n          'ds-interaction-fill': true,\n        }}\n        style={{\n          '--ds-nav-disclosure-index': String(index),\n          '--ds-nav-disclosure-reverse-index': String((parent.children?.length ?? 0) - index - 1),\n        }}\n        aria-current={selected ? 'page' : undefined}\n        onClick={() => {\n          if (!child.isInactive)\n            this.dsNavChildSelect.emit({\n              parentId: parent.id,\n              childId: child.id,\n              href: child.href,\n            });\n        }}\n        onKeyDown={(event: KeyboardEvent) => {\n          if (event.key === 'ArrowLeft') {\n            event.preventDefault();\n            this.expandedParentId = '';\n            this.el.querySelector<HTMLElement>(`#${CSS.escape(this.parentId(parent.id))}`)?.focus();\n          }\n        }}\n      >\n        <ds-text\n          class=\"mobile-sheet-nav__item-label ds-interaction-fill__content\"\n          as=\"span\"\n          variant=\"text-body-large\"\n          emphasis={selected}\n          color=\"inherit\"\n          lineTruncation={1}\n        >\n          {child.label}\n        </ds-text>\n        {child.dot ? (\n          <ds-badge\n            class=\"mobile-sheet-nav__dot ds-interaction-fill__content\"\n            variant=\"dot\"\n            hasRing={false}\n            label=\"\"\n            aria-hidden=\"true\"\n          />\n        ) : null}\n      </button>\n    );\n  }\n\n  private renderBranchDivider(position: 'before' | 'after', expanded: boolean) {\n    return (\n      <div\n        class={{\n          'ds-nav-disclosure-divider': true,\n          'ds-nav-disclosure-divider--open': expanded,\n          'mobile-sheet-nav__divider': true,\n          [`mobile-sheet-nav__divider--${position}`]: true,\n        }}\n        aria-hidden=\"true\"\n      >\n        <div class=\"ds-nav-disclosure-divider__clip\">\n          <span class=\"mobile-sheet-nav__divider-line\" />\n        </div>\n      </div>\n    );\n  }\n\n  private renderBranch(item: PanelNavItem, index: number, count: number) {\n    const hasChildren = this.presentation === 'nested' && !!item.children?.length;\n    const expanded = hasChildren && this.expandedParentId === item.id;\n    return (\n      <div key={item.id} class=\"mobile-sheet-nav__branch\">\n        {hasChildren && index > 0 ? this.renderBranchDivider('before', expanded) : null}\n        {this.renderItem(item)}\n        {this.presentation === 'nested' && item.children?.length ? (\n          <div\n            class={{ 'ds-nav-disclosure': true, 'ds-nav-disclosure--open': expanded }}\n            inert={!expanded ? true : undefined}\n            aria-hidden={!expanded ? 'true' : undefined}\n          >\n            <div\n              class=\"mobile-sheet-nav__children\"\n              id={this.childrenId(item.id)}\n              role=\"group\"\n              aria-labelledby={this.parentId(item.id)}\n            >\n              {item.children.map((child, index) => this.renderChild(item, child, index))}\n            </div>\n          </div>\n        ) : null}\n        {hasChildren && index < count - 1 ? this.renderBranchDivider('after', expanded) : null}\n      </div>\n    );\n  }\n\n  private renderLogo() {\n    return (\n      <span class=\"mobile-sheet-nav__logo\" aria-hidden=\"true\">\n        {/* eslint-disable-next-line local/prefer-ds-icon -- Motive brand mark is not part of the IcoMo runtime catalog. */}\n        <svg\n          class=\"mobile-sheet-nav__logo-mark\"\n          viewBox=\"0 0 20 20\"\n          fill=\"none\"\n          xmlns=\"http://www.w3.org/2000/svg\"\n          focusable=\"false\"\n          aria-hidden=\"true\"\n        >\n          <path\n            d=\"M11.1159 4.31537H7.67021L2.53401 13.0703H0V15.6875H4.02716L8.24319 8.49978V15.6846H11.6342L15.8289 8.47829V15.6846H18.7122V4.3125H15.2559L11.1159 11.3648V4.31537Z\"\n            fill=\"currentColor\"\n          />\n        </svg>\n      </span>\n    );\n  }\n\n  private renderHeaderDestination(\n    id: MobileSheetNavHeaderDestinationId,\n    icon: string,\n    label: string\n  ) {\n    return (\n      <ds-tooltip label={label} side=\"bottom\" size=\"sm\">\n        <ds-button-unfilled\n          variant=\"icon\"\n          size=\"lg\"\n          icon={icon}\n          aria-label={label}\n          activeFill={false}\n          hasBorder={false}\n          onDsClick={() => this.dsAreaSelect.emit(id)}\n        />\n      </ds-tooltip>\n    );\n  }\n\n  render() {\n    const contextTabs = [\n      { ...CONTEXT_TABS[0], label: this.dashboardLabel },\n      { ...CONTEXT_TABS[1], label: this.settingsLabel },\n    ];\n\n    return (\n      <Host aria-hidden={this.open ? undefined : 'true'} inert={this.open ? undefined : true}>\n        <section id=\"ds-mobile-sheet-nav\" class=\"mobile-sheet-nav\">\n          <header\n            class={{\n              'mobile-sheet-nav__header': true,\n              'mobile-sheet-nav__header--expanded-context': !this.showAccount,\n              'ds-chrome-grid': true,\n              'ds-chrome-space--md': true,\n            }}\n          >\n            <div class=\"mobile-sheet-nav__brand\">{this.renderLogo()}</div>\n            <ds-tab-group\n              class=\"mobile-sheet-nav__context\"\n              tabs={contextTabs}\n              value={this.browseContext}\n              size=\"lg\"\n              width={this.showAccount ? 'hug' : 'fill'}\n              aria-label=\"Browse context\"\n              onDsChange={this.handleContextChange}\n            />\n            <div class=\"mobile-sheet-nav__actions\">\n              {this.renderHeaderDestination('help', 'CircleQuestion', this.helpLabel)}\n              {this.showAccount\n                ? this.renderHeaderDestination('account', 'Avatar', this.accountLabel)\n                : null}\n            </div>\n          </header>\n\n          <nav\n            class=\"mobile-sheet-nav__body ds-chrome-column ds-chrome-space--md\"\n            aria-label={this.navigationLabel}\n          >\n            <div class=\"mobile-sheet-nav__sections\">\n              {this.groups\n                .filter(group => group.items.length > 0)\n                .map(group => (\n                  <div class=\"mobile-sheet-nav__items\">\n                    {group.items.map((item, index) =>\n                      this.renderBranch(item, index, group.items.length)\n                    )}\n                  </div>\n                ))}\n            </div>\n          </nav>\n        </section>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]