@ixfx/components 0.2.4 → 0.2.5

package/dist/menu-item-DEzL_Yjk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-item-DEzL_Yjk.js","names":[],"sources":["../src/menu/menu-container.ts","../src/menu/menu-trigger.ts","../src/menu/menu-item.ts"],"sourcesContent":["import type { CommandRegistry, KeyboardManager } from '@clinth/ui-commands';\nimport { css, html, LitElement } from 'lit';\nimport { customElement, property, query } from 'lit/decorators.js';\nimport { popupSurfaceStyles } from '../styles/popup.js';\nimport { TickledController, tickledStyles } from '../interaction/index.js';\n\n@customElement(`ixfx-menu-container`)\nexport class MenuContainer extends LitElement {\n  @property({ type: String, attribute: `anchor` }) anchor?: string;\n  @property({ attribute: false }) registry?: CommandRegistry<unknown>;\n  @property({ attribute: false }) keyboardManager?: KeyboardManager;\n  @query(`.popover`) private _popover!: HTMLElement;\n\n  // TickledController manages input mode and tickled state\n  private tickled = new TickledController<number>(this, {\n    getItems: () => {\n      const items = this._getMenuItems();\n      return items.map((item, i) => ({\n        id: i,\n        enabled: !item.hasAttribute('disabled')\n      }));\n    },\n    onTickle: (index) => {\n      // When an item is tickled (hovered/keyboard focused), handle submenu opening\n      const items = this._getMenuItems();\n      if (index !== undefined) {\n        const item = items[index];\n        // Ensure the item is focusable and focus it\n        item.tabIndex = 0;\n        item.focus({ preventScroll: true });\n      }\n    },\n    onStateChange: () => {\n      // Sync DOM attributes for slotted content\n      this._syncTickledClasses();\n    }\n  });\n\n  static styles = [popupSurfaceStyles, tickledStyles, css`\n    :host {\n      display: block;\n    }\n\n    .popover {\n      padding: var(--space-xs) 0;\n      min-width: 160px;\n    }\n\n    :host {\n      opacity: 1;\n      transform: translateY(0) scale(1);\n      transition: opacity 0.12s ease-out, transform 0.12s ease-out,\n                  display 0.12s allow-discrete, overlay 0.12s allow-discrete;\n    }\n\n    @starting-style :host {\n      opacity: 0;\n      transform: translateY(-4px) scale(0.97);\n    }\n\n    ::slotted(menu-separator) {\n      display: block;\n      margin: var(--space-xs) 0;\n    }\n  `];\n\n  private _updateIconSections(): void {\n    const slot = this.shadowRoot?.querySelector(`slot`) as HTMLSlotElement | null;\n    if (!slot)\n      return;\n\n    const assigned = slot.assignedElements({ flatten: true });\n\n    // Group direct children into sections delimited by separators and headers\n    const sections: Element[][] = [];\n    let section: Element[] = [];\n    for (const el of assigned) {\n      if (el.tagName === `IXFX-MENU-SEPARATOR` || el.tagName === `IXFX-MENU-HEADER`) {\n        if (section.length > 0) {\n          sections.push(section); section = [];\n        }\n      } else {\n        section.push(el);\n      }\n    }\n    if (section.length > 0)\n      sections.push(section);\n\n    this._propagateContext();\n\n    for (const sec of sections) {\n      const hasIcon = sec.some((el) => {\n        if (el.tagName === `IXFX-MENU-RADIO-GROUP`) {\n          return [...el.children].some(ri => ri.hasAttribute(`icon-name`));\n        }\n        return el.hasAttribute(`icon-name`);\n      });\n\n      for (const el of sec) {\n        if (el.tagName === `IXFX-MENU-RADIO-GROUP`) {\n          for (const ri of el.children) {\n            if (hasIcon)\n              ri.setAttribute(`data-icon-section`, ``);\n            else ri.removeAttribute(`data-icon-section`);\n          }\n        } else {\n          if (hasIcon)\n            el.setAttribute(`data-icon-section`, ``);\n          else el.removeAttribute(`data-icon-section`);\n        }\n      }\n    }\n\n    this.performUpdate();\n  }\n\n  private _propagateContext(): void {\n    const slot = this.shadowRoot?.querySelector(`slot`) as HTMLSlotElement | null;\n    if (!slot)\n      return;\n    for (const el of slot.assignedElements({ flatten: true })) {\n      if (`registry` in el)\n        (el as any).registry = this.registry;\n      if (`keyboardManager` in el)\n        (el as any).keyboardManager = this.keyboardManager;\n    }\n  }\n\n  override updated(changedProperties: Map<string, unknown>): void {\n    if (changedProperties.has(`registry`) || changedProperties.has(`keyboardManager`)) {\n      this._propagateContext();\n    }\n  }\n\n  /**\n   * Sync data-input-mode to :host so CSS variables cascade to slotted items\n   */\n  willUpdate(changed: Map<PropertyKey, unknown>): void {\n    super.willUpdate(changed);\n    // Set data-input-mode on :host so tickledStyles CSS variables cascade\n    // through shadow DOM to slotted menu items\n    this.setAttribute('data-input-mode', this.tickled.inputMode);\n  }\n\n  render() {\n    return html`\n      <div\n        class=\"popover popup-surface\"\n        role=\"menu\"\n        @keydown=${this._handleKeydown}\n        @mouseover=${this._handleMouseOver}\n      >\n        <slot @slotchange=${this._updateIconSections}></slot>\n      </div>\n    `;\n  }\n\n  private _getMenuItems(): HTMLElement[] {\n    const slot = this.shadowRoot?.querySelector(`slot`);\n    if (!slot)\n      return [];\n\n    const skipTags = [`IXFX-MENU-SEPARATOR`, `IXFX-MENU-HEADER`];\n    const result: HTMLElement[] = [];\n\n    for (const el of slot.assignedElements({ flatten: true })) {\n      if (skipTags.includes(el.tagName))\n        continue;\n      if (el.hasAttribute(`disabled`))\n        continue;\n      const role = el.getAttribute(`role`);\n      if (role === `none` || role === `presentation`)\n        continue;\n\n      if (el.tagName === `IXFX-MENU-RADIO-GROUP`) {\n        const groupSlot = el.shadowRoot?.querySelector(`slot`) as HTMLSlotElement | null;\n        for (const radioItem of groupSlot?.assignedElements({ flatten: true }) ?? []) {\n          if (!radioItem.hasAttribute(`disabled`)) {\n            result.push(radioItem as HTMLElement);\n          }\n        }\n      } else {\n        result.push(el as HTMLElement);\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Sync .tickled class on slotted items to match controller state\n   * This is called via onStateChange whenever the tickled state changes\n   */\n  private _syncTickledClasses(): void {\n    const items = this._getMenuItems();\n    items.forEach((item, i) => {\n      if (this.tickled.isTickled(i)) {\n        item.classList.add(`tickled`);\n        item.tabIndex = 0;\n        // Set inline styles to ensure visibility across shadow DOM boundaries\n        const innerItem = item.shadowRoot?.querySelector(`.item`) as HTMLElement | null;\n        if (innerItem) {\n          innerItem.style.background = `rgba(0, 0, 0, 0.06)`;\n          innerItem.style.borderColor = `var(--accent)`;\n          innerItem.style.color = `inherit`;\n        }\n      } else {\n        item.classList.remove(`tickled`);\n        item.tabIndex = -1;\n        // Clear inline styles\n        const innerItem = item.shadowRoot?.querySelector(`.item`) as HTMLElement | null;\n        if (innerItem) {\n          innerItem.style.background = ``;\n          innerItem.style.borderColor = ``;\n          innerItem.style.color = ``;\n        }\n      }\n    });\n\n    // Focus the tickled item if in keyboard mode\n    if (this.tickled.inputMode === 'keyboard' && this.tickled.tickledId !== undefined) {\n      const tickledItem = items[this.tickled.tickledId];\n      tickledItem?.focus();\n    }\n  }\n\n  private _handleMouseOver = (e: MouseEvent): void => {\n    const items = this._getMenuItems();\n    // composedPath crosses shadow boundaries to find the hovered menu item\n    const path = e.composedPath();\n    const hoveredIndex = items.findIndex(item => path.includes(item));\n    if (hoveredIndex !== -1) {\n      const item = items[hoveredIndex];\n      // If IXFX-MENU-CONTAINER appears before this item in the composed path, the\n      // event originated from inside a nested submenu. Skip the focus override so the\n      // inner container keeps ownership of focus. stopPropagation() alone is not\n      // sufficient because it does not reliably cross shadow-root boundaries with\n      // popovers in the stack — both this handler and the inner one will fire.\n      const itemPathIndex = path.indexOf(item);\n      const isFromInsideSubmenu = path.slice(0, itemPathIndex).some(\n        node => node instanceof Element && node.tagName === `IXFX-MENU-CONTAINER`,\n      );\n      if (!isFromInsideSubmenu) {\n        // Use TickledController to handle mouse hover\n        this.tickled.handlePointerEnter(hoveredIndex);\n      }\n      // Stop propagation so ancestor MenuContainers don't override this focus\n      // with their own mouseover handler (e.g. outer menu focusing the sub-trigger).\n      e.stopPropagation();\n    }\n  };\n\n  focusFirst(): void {\n    this.tickled.handleKeyboardNavigation('first');\n  }\n\n  private _focusNext(items: HTMLElement[], direction: number): void {\n    if (items.length === 0) {\n      return;\n    }\n\n    this.tickled.handleKeyboardNavigation(direction > 0 ? 'next' : 'previous');\n  }\n\n  private _focusItem(items: HTMLElement[], index: number): void {\n    if (items.length === 0) {\n      return;\n    }\n\n    // Clamp index to valid range\n    const clampedIndex = Math.max(0, Math.min(index, items.length - 1));\n    this.tickled.handleKeyboardNavigation(clampedIndex);\n  }\n\n  private _activateFocusedItem(items: HTMLElement[]): void {\n    const tickledIndex = this.tickled.tickledId;\n    if (tickledIndex === undefined) {\n      return;\n    }\n    \n    const item = items[tickledIndex];\n    if (!item) {\n      return;\n    }\n\n    const tagName = item.tagName;\n\n    if (tagName === `IXFX-MENU-SUB-TRIGGER`) {\n      // Native menu behavior handles submenu navigation automatically\n      return;\n    }\n\n    if (tagName === `IXFX-MENU-CHECK-ITEM`) {\n      const checkItem = item as any;\n      checkItem.checked = !checkItem.checked;\n      checkItem.dispatchEvent(new CustomEvent(`command`, {\n        detail: { command: checkItem.command, checked: checkItem.checked },\n        bubbles: true,\n        composed: true,\n      }));\n      return;\n    }\n\n    if (tagName === `IXFX-MENU-RADIO-ITEM`) {\n      item.dispatchEvent(new CustomEvent(`radio-select`, {\n        detail: { value: (item as any).value },\n        bubbles: true,\n        composed: true,\n      }));\n      return;\n    }\n\n    if (tagName === `IXFX-MENU-ITEM`) {\n      const command = (item as any).command;\n      if (command) {\n        item.dispatchEvent(new CustomEvent(`command`, {\n          detail: { command },\n          bubbles: true,\n          composed: true,\n        }));\n      }\n      return;\n    }\n\n    (item as HTMLElement).click();\n  }\n\n  private _handleKeydown = (e: KeyboardEvent): void => {\n    const items = this._getMenuItems();\n    if (items.length === 0) {\n      return;\n    }\n\n    switch (e.key) {\n      case `ArrowDown`:\n        e.preventDefault();\n        e.stopPropagation();\n        this._focusNext(items, 1);\n        break;\n      case `ArrowUp`:\n        e.preventDefault();\n        e.stopPropagation();\n        this._focusNext(items, -1);\n        break;\n      case `Home`:\n        e.preventDefault();\n        e.stopPropagation();\n        this._focusItem(items, 0);\n        break;\n      case `End`:\n        e.preventDefault();\n        e.stopPropagation();\n        this._focusItem(items, items.length - 1);\n        break;\n      case `Enter`:\n      case ` `:\n        e.preventDefault();\n        e.stopPropagation();\n        this._activateFocusedItem(items);\n        break;\n    }\n  };\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'ixfx-menu-container': MenuContainer;\n  }\n}\n","import type { CommandRegistry, KeyboardManager } from '@clinth/ui-commands';\nimport { css, html, LitElement } from 'lit';\nimport { customElement, property, query, state } from 'lit/decorators.js';\nimport { popupSurfaceStyles } from '../styles/popup.js';\nimport './menu-container.js';\n\ntype MenuMode = `trigger` | `dropdown` | `context`;\ntype Placement = `bottom-start` | `bottom-end` | `right-start`;\n\nexport type MenuTriggerCommandDetail = {\n  readonly command?: string;\n  readonly value?: string;\n  readonly checked?: boolean;\n};\n\nexport type MenuTriggerCommandEvent = CustomEvent<MenuTriggerCommandDetail>;\n\n@customElement(`ixfx-menu-trigger`)\nexport class MenuTrigger extends LitElement {\n  @property({ type: String }) mode: MenuMode = `trigger`;\n  @property({ type: String }) label = `⋮`;\n  @property({ attribute: false }) registry?: CommandRegistry<unknown>;\n  @property({ attribute: false }) keyboardManager?: KeyboardManager;\n  @property({ type: String }) placement: Placement = `bottom-start`;\n\n  @state() private _isOpen = false;\n  @state() private _hasMenu = false;\n  @state() private _hasTriggerSlot = false;\n\n  @query(`.trigger-btn`) private _triggerBtn!: HTMLButtonElement;\n  @query(`.popup`) private _popup!: HTMLElement;\n\n  private static _count = 0;\n\n  private _anchorName = `--mt-${MenuTrigger._count++}`;\n  private _clickListener = this._handleClickOutside.bind(this);\n\n  connectedCallback(): void {\n    super.connectedCallback();\n    document.addEventListener(`keydown`, this._handleKeydown);\n    this.addEventListener(`command`, this._handleCommand as EventListener);\n    this.addEventListener(`radio-change`, this._handleRadioChange as EventListener);\n  }\n\n  disconnectedCallback(): void {\n    super.disconnectedCallback();\n    document.removeEventListener(`keydown`, this._handleKeydown);\n    this.removeEventListener(`command`, this._handleCommand as EventListener);\n    this.removeEventListener(`radio-change`, this._handleRadioChange as EventListener);\n    document.removeEventListener(`click`, this._clickListener);\n  }\n\n  firstUpdated(): void {\n    this.style.setProperty(`--anchor-name`, this._anchorName);\n    this._popup.addEventListener(`toggle`, this._handlePopoverToggle);\n\n    this.updateComplete.then(() => {\n      const slot = this.shadowRoot?.querySelector(`slot[name=\"menu\"]`) as HTMLSlotElement | undefined;\n      if (slot) {\n        const assigned = slot.assignedElements({ flatten: true });\n        if (assigned.length > 0) {\n          this._hasMenu = true;\n          this._propagateContext();\n        }\n      }\n\n      this._updatePosition();\n    });\n  }\n\n  updated(changedProperties: Map<string, unknown>): void {\n    if (changedProperties.has(`registry`) || changedProperties.has(`keyboardManager`)) {\n      this._propagateContext();\n    }\n  }\n\n  private _updatePosition(): void {\n    const placements: Record<Placement, { top: string; left: string }> = {\n      'bottom-start': { top: `anchor(bottom)`, left: `anchor(left)` },\n      'bottom-end': { top: `anchor(bottom)`, left: `anchor(right)` },\n      'right-start': { top: `anchor(top)`, left: `anchor(right)` },\n    };\n    const pos = placements[this.placement];\n    this._popup.style.top = pos.top;\n    this._popup.style.left = pos.left;\n    (this._popup.style as any).positionAnchor = this._anchorName;\n  }\n\n  private _propagateContext(): void {\n    const slot = this.shadowRoot?.querySelector(`slot[name=\"menu\"]`) as HTMLSlotElement | undefined;\n    const items = slot?.assignedElements({ flatten: true }) ?? [];\n    for (const el of items) {\n      if (`registry` in el)\n        (el as any).registry = this.registry;\n      if (`keyboardManager` in el)\n        (el as any).keyboardManager = this.keyboardManager;\n    }\n  }\n\n  private _handleSlotChange(e: Event): void {\n    const slot = e.target as HTMLSlotElement;\n    const assigned = slot.assignedElements({ flatten: true });\n    this._hasMenu = assigned.length > 0;\n    this._propagateContext();\n  }\n\n  private _handleTriggerSlotChange(e: Event): void {\n    const slot = e.target as HTMLSlotElement;\n    this._hasTriggerSlot = slot.assignedElements({ flatten: true }).length > 0;\n  }\n\n  get isOpen(): boolean {\n    return this._isOpen;\n  }\n\n  openMenu(): void {\n    this._openMenu();\n  }\n\n  closeMenu(): void {\n    this._closeMenu();\n  }\n\n  focusTrigger(): void {\n    this._triggerBtn?.focus();\n  }\n\n  private _openMenu(): void {\n    if (this._isOpen || !this._popup?.popover)\n      return;\n    try {\n      (this._popup as any).showPopover({ source: this });\n      this._isOpen = true;\n      document.addEventListener(`click`, this._clickListener);\n      this.dispatchEvent(new CustomEvent(`menu-trigger-open`, { bubbles: true, composed: true }));\n      requestAnimationFrame(() => {\n        this._getMenuContainer()?.focusFirst();\n      });\n    } catch (err) {\n      console.warn(`showPopover failed:`, err);\n    }\n  }\n\n  private _handlePopoverToggle = (e: Event): void => {\n    if ((e as ToggleEvent).newState === `closed`) {\n      this._isOpen = false;\n      document.removeEventListener(`click`, this._clickListener);\n      this.dispatchEvent(new CustomEvent(`menu-trigger-close`, { bubbles: true, composed: true }));\n    }\n  };\n\n  private _closeMenu(): void {\n    if (!this._isOpen)\n      return;\n    if (this._popup?.popover) {\n      try {\n        (this._popup as any).hidePopover();\n      } catch { /* ignore */ }\n    }\n    this._isOpen = false;\n    document.removeEventListener(`click`, this._clickListener);\n  }\n\n  private _handleTriggerClick(e: Event): void {\n    e.stopPropagation();\n    if (this._isOpen) {\n      this._closeMenu();\n      this._triggerBtn?.focus();\n    } else {\n      this._openMenu();\n    }\n  }\n\n  private _handleClickOutside(e: Event): void {\n    if (!this.contains(e.target as Node)) {\n      if (this._popup?.popover && this._popup.hasAttribute(`open`)) {\n        try {\n          (this._popup as any).hidePopover();\n        } catch {\n          // ignore\n        }\n      }\n    }\n  }\n\n  private _getMenuContainer(): (HTMLElement & { focusFirst: () => void }) | null {\n    const slot = this.shadowRoot?.querySelector(`slot[name=\"menu\"]`) as HTMLSlotElement | null;\n    const assigned = slot?.assignedElements({ flatten: true }) ?? [];\n    const container = assigned.find(el => el.tagName === `IXFX-MENU-CONTAINER`);\n    return (container as any) ?? null;\n  }\n\n  private _handleKeydown = (e: KeyboardEvent): void => {\n    if (!this._isOpen)\n      return;\n\n    if (e.key === `Escape`) {\n      e.preventDefault();\n      e.stopPropagation();\n      this._closeMenu();\n      this._triggerBtn?.focus();\n    } else if (e.key === `Tab`) {\n      this._closeMenu();\n      this._triggerBtn?.focus();\n    }\n  };\n\n  private _handleCommand(e: CustomEvent): void {\n    if (this._popup?.popover) {\n      try {\n        (this._popup as any).hidePopover();\n      } catch {\n        // ignore\n      }\n    }\n    this.dispatchEvent(new CustomEvent<MenuTriggerCommandDetail>(`menu-command`, {\n      detail: e.detail,\n      bubbles: true,\n      composed: true,\n    }));\n  }\n\n  private _handleRadioChange(e: CustomEvent): void {\n    if (this._popup?.popover) {\n      try {\n        (this._popup as any).hidePopover();\n      } catch {\n        // ignore\n      }\n    }\n    this.dispatchEvent(new CustomEvent<MenuTriggerCommandDetail>(`menu-command`, {\n      detail: {\n        command: e.detail.name,\n        value: e.detail.value,\n      },\n      bubbles: true,\n      composed: true,\n    }));\n  }\n\n  private _handleContextMenu(e: MouseEvent): void {\n    if (this.mode !== `context`)\n      return;\n    e.preventDefault();\n    this._popup.style.top = `${e.clientY}px`;\n    this._popup.style.left = `${e.clientX}px`;\n    this._popup.style.position = `fixed`;\n    (this._popup.style as any).positionAnchor = `none`;\n    if (this._popup?.popover) {\n      try {\n        (this._popup as any).showPopover();\n      } catch {\n        // ignore\n      }\n    }\n  }\n\n  static styles = [\n    popupSurfaceStyles,\n    css`\n    :host {\n      display: inline-block;\n      position: relative;\n    }\n\n    .trigger-area {\n      anchor-name: var(--anchor-name);\n      display: inline-flex;\n      align-items: stretch;\n    }\n\n    .trigger-btn {\n      background: none;\n      border: none;\n      color: var(--surface-3-text);\n      cursor: pointer;\n      padding: var(--space-s) var(--space-m);\n      font-size: var(--text-m);\n      font-weight: 600;\n      border-radius: var(--radius-s);\n      opacity: 0.6;\n      transition: opacity var(--transition), background var(--transition);\n    }\n\n    .trigger-btn:hover {\n      background: var(--_trigger-hover-bg, var(--surface-4));\n      color: var(--surface-3-text);\n      opacity: var(--_trigger-hover-opacity, 1);\n    }\n\n    .trigger-btn:focus-visible {\n      background: var(--surface-4);\n      color: var(--surface-3-text);\n      outline: none;\n      opacity: 1;\n    }\n\n    .popup {\n      position: fixed;\n      position-anchor: var(--anchor-name);\n      inset: auto;\n      margin: 0;\n      padding: 0;\n      border: none;\n      background: transparent;\n      z-index: 100;\n      position-try-fallbacks: flip-inline, flip-block, flip-block flip-inline;\n    }\n\n    .popup[popover] {\n      opacity: 1;\n      transform: translateY(0) scale(1);\n      transition: opacity 0.12s ease-out, transform 0.12s ease-out,\n                  display 0.12s allow-discrete, overlay 0.12s allow-discrete;\n    }\n\n    @starting-style .popup {\n      opacity: 0;\n      transform: translateY(-4px) scale(0.97);\n    }\n  `,\n  ];\n\n  render() {\n    const showButton = this.mode !== `dropdown` && this._hasMenu && !this._hasTriggerSlot;\n    return html`\n      <div\n        class=\"trigger-area\"\n        @click=${this._handleTriggerClick}\n        @contextmenu=${this._handleContextMenu}\n      >\n        ${showButton\n          ? html`<button class=\"trigger-btn\" part=\"base\">${this.label}</button>`\n          : null}\n        <slot name=\"trigger\" @slotchange=${this._handleTriggerSlotChange}></slot>\n      </div>\n      <div\n        class=\"popup popup-surface\"\n        popover=\"auto\"\n        @click=${(e: Event) => e.stopPropagation()}\n      >\n          <slot name=\"menu\" @slotchange=${this._handleSlotChange}></slot>\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'ixfx-menu-trigger': MenuTrigger;\n  }\n}\n","import type { CommandRegistry, KeyboardManager } from '@clinth/ui-commands';\nimport { css, html, LitElement } from 'lit';\nimport { customElement, property, query, state } from 'lit/decorators.js';\nimport { tickledItemStyles } from '../interaction/index.js';\nimport '../icons/icon.js';\n\nexport type MenuItemCommandDetail = {\n  readonly command: string;\n  readonly args: string;\n};\n\nexport type MenuItemCommandEvent = CustomEvent<MenuItemCommandDetail>;\n\n@customElement(`ixfx-menu-item`)\nexport class MenuItem extends LitElement {\n  @property({ type: String }) command = ``;\n  @property({ type: String, attribute: `command-args` }) commandArgs = ``;\n  @property({ type: String }) label = ``;\n  @property({ type: Boolean }) disabled = false;\n  @property({ type: String, attribute: `icon-name` }) iconName = ``;\n  @property({ attribute: false }) registry?: CommandRegistry<unknown>;\n  @property({ attribute: false }) keyboardManager?: KeyboardManager;\n  @property({ attribute: false }) submenuPopover?: HTMLElement;\n\n  @state() private _hasChildren = false;\n  @query(`slot`) private _slot!: HTMLSlotElement;\n\n  private _hoverTimeout: number | null = null;\n\n  disconnectedCallback(): void {\n    super.disconnectedCallback();\n    if (this._hoverTimeout) {\n      clearTimeout(this._hoverTimeout);\n    }\n  }\n\n  private _handleSlotChange(): void {\n    const assigned = this._slot?.assignedElements() ?? [];\n    this._hasChildren = assigned.length > 0;\n  }\n\n  private _handleMouseEnter(): void {\n    if (this.disabled || !this._hasChildren || !this.submenuPopover)\n      return;\n    if (this._hoverTimeout) {\n      clearTimeout(this._hoverTimeout);\n    }\n    this._hoverTimeout = window.setTimeout(() => {\n      this._showSubmenu();\n    }, 150);\n  }\n\n  private _handleMouseLeave(): void {\n    if (this._hoverTimeout) {\n      clearTimeout(this._hoverTimeout);\n      this._hoverTimeout = null;\n    }\n    this._hideSubmenu();\n  }\n\n  private _showSubmenu(): void {\n    if (!this.submenuPopover?.popover)\n      return;\n    try {\n      this.submenuPopover.showPopover();\n    } catch (err) {\n      console.warn(`showPopover failed:`, err);\n    }\n  }\n\n  private _hideSubmenu(): void {\n    if (!this.submenuPopover?.popover)\n      return;\n    try {\n      this.submenuPopover.hidePopover();\n    } catch (err) {\n      console.warn(`hidePopover failed:`, err);\n    }\n  }\n\n  private handleClick(): void {\n    if (this.disabled)\n      return;\n\n    this.dispatchEvent(new CustomEvent<MenuItemCommandDetail>(`command`, {\n      detail: { command: this.command, args: this.commandArgs },\n      bubbles: true,\n      composed: true,\n    }));\n  }\n\n  private _resolvedLabel(): string {\n    if (this.label)\n      return this.label;\n    if (this.registry && this.command) {\n      return this.registry.get(this.command)?.label ?? ``;\n    }\n    return ``;\n  }\n\n  private _resolvedIcon(): string | null {\n    if (this.iconName)\n      return this.iconName;\n    if (this.registry && this.command) {\n      return this.registry.get(this.command)?.icon ?? null;\n    }\n    return null;\n  }\n\n  willUpdate(changedProperties: Map<string, unknown>): void {\n    super.willUpdate(changedProperties);\n    const resolvedIcon = this._resolvedIcon();\n    if (resolvedIcon && !this.iconName) {\n      this.setAttribute(`data-icon-section`, ``);\n    } else if (!resolvedIcon && !this.iconName) {\n      this.removeAttribute(`data-icon-section`);\n    }\n  }\n\n  updated(changedProperties: Map<string, unknown>): void {\n    super.updated(changedProperties);\n  }\n\n  private _getShortcut(): string | null {\n    if (!this.keyboardManager || !this.command)\n      return null;\n    const bindings = (this.keyboardManager as any).getBindings?.() ?? [];\n    const binding = bindings.find((b: any) => b.commandId === this.command);\n    if (!binding)\n      return null;\n    const mods = Array.from(binding.modifiers ?? [], (m: string) =>\n      ({ ctrl: `⌃`, shift: `⇧`, alt: `⌥`, meta: `⌘` })[m] ?? m);\n    const key = binding.key?.length === 1 ? binding.key.toUpperCase() : binding.key;\n    return [...mods, key].join(``);\n  }\n\n  static override styles = [tickledItemStyles, css`\n    :host {\n      display: block;\n    }\n\n    .item {\n      display: flex !important;\n      align-items: center;\n      padding: 6px var(--space-m);\n      font-size: var(--text-m);\n      background: var(--item-bg, transparent);\n      border: var(--item-border, 1px solid transparent);\n      color: var(--item-text, inherit);\n    }\n\n    :host(.tickled) .item {\n      background: rgba(0, 0, 0, 0.06);\n      border: 1px solid var(--accent);\n      color: inherit;\n    }\n\n    :host(:focus) {\n      outline: none;\n    }\n\n    .item.disabled {\n      opacity: var(--disabled-opacity);\n      cursor: default;\n    }\n\n    .item.disabled:hover {\n      background: transparent;\n    }\n\n    .icon-slot {\n      width: 0;\n      overflow: hidden;\n      flex-shrink: 0;\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n    }\n\n    :host([icon-name]) .icon-slot,\n    :host([data-icon-section]) .icon-slot {\n      width: 1em;\n      height: 1em;\n      margin-right: var(--space-s);\n    }\n\n    .label {\n      flex: 1;\n    }\n\n    .shortcut {\n      margin-left: auto;\n      color: var(--surface-muted-text);\n      font-size: var(--text-s);\n    }\n\n    .arrow {\n      color: var(--surface-muted-text);\n      margin-left: var(--space-m);\n    }\n  `];\n\n  render() {\n    const shortcut = this._getShortcut();\n    const resolvedIcon = this._resolvedIcon();\n    return html`\n      <div \n        class=\"item ${this.disabled ? `disabled` : ``}\"\n        @click=${this.handleClick}\n        @mouseenter=${this._handleMouseEnter}\n        @mouseleave=${this._handleMouseLeave}\n        tabindex=\"${this.disabled ? -1 : 0}\"\n        role=\"menuitem\"\n        aria-haspopup=\"${this._hasChildren ? `true` : `false`}\"\n        aria-expanded=\"${this.submenuPopover?.matches(`:popover-open`) ?? false}\"\n      >\n        <span class=\"icon-slot\">${resolvedIcon ? html`<ixfx-icon name=\"${resolvedIcon}\"></ixfx-icon>` : null}</span>\n        <span class=\"label\"><slot></slot>${this._resolvedLabel()}</span>\n        ${shortcut ? html`<span class=\"shortcut\">${shortcut}</span>` : null}\n        ${this._hasChildren ? html`<span class=\"arrow\"><ixfx-icon name=\"chevron-right\"></ixfx-icon></span>` : null}\n      </div>\n      <slot @slotchange=${this._handleSlotChange}></slot>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'ixfx-menu-item': MenuItem;\n  }\n}\n"],"mappings":"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"}

package/dist/menu.d.ts

@@ -0,0 +1,3 @@
+import { i as MenuContainer, n as MenuTrigger, t as MenuItem } from "./menu-item-Cikacp4F.js";
+import { a as menuFromTree, c as MenuSubTrigger, d as MenuCheckItem, f as MenuBar, i as MenuFromTreeOptions, l as MenuHeader, n as MenuRadioGroup, o as menuFromTreeToElements, r as MenuRadioItem, s as MenuSeparator, u as MenuCommandController } from "./index-CQxanqXF.js";
+export { MenuBar, MenuCheckItem, MenuCommandController, MenuContainer, MenuFromTreeOptions, MenuHeader, MenuItem, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuSubTrigger, MenuTrigger, menuFromTree, menuFromTreeToElements };

package/dist/menu.js

@@ -0,0 +1,3 @@
+import { n as MenuTrigger, r as MenuContainer, t as MenuItem } from "./menu-item-DEzL_Yjk.js";
+import { a as menuFromTreeToElements, c as MenuHeader, d as MenuBar, i as menuFromTree, l as MenuCommandController, n as MenuRadioGroup, o as MenuSeparator, r as MenuRadioItem, s as MenuSubTrigger, u as MenuCheckItem } from "./menu-BV6UFx_z.js";
+export { MenuBar, MenuCheckItem, MenuCommandController, MenuContainer, MenuHeader, MenuItem, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuSubTrigger, MenuTrigger, menuFromTree, menuFromTreeToElements };

package/dist/miller.d.ts

@@ -0,0 +1,324 @@
+import { n as TraversableTree, t as TickledController } from "./tickled-controller-Cq1Va0rR.js";
+import { C as TreeNode, S as TreeItem, a as TreeComponent, b as TreeFilterPredicate, c as TreeExpandEvent, d as TreeSearchHost, f as TreeSelectDetail, g as TreeDataModel, h as TreeTickleEvent, i as TreeCollapseEvent, l as TreeItemClickDetail, m as TreeTickleDetail, n as TreeActivateEvent, o as TreeComponentEventMap, p as TreeSelectEvent, r as TreeCollapseDetail, s as TreeExpandDetail, t as TreeActivateDetail, u as TreeItemClickEvent, v as LoadChildrenCallback, w as TreeSelectionFilter, y as TreeExclusivity } from "./tree-component-CQpoPo4s.js";
+import * as _$lit from "lit";
+import { LitElement, PropertyValues, TemplateResult, nothing } from "lit";
+
+//#region src/miller/types.d.ts
+type MillerSelectionMode = `implicit` | `standard` | `manual` | `checked` | `vscode`;
+type MillerConfig = {
+  columnWidths: Record<number, number>;
+};
+/** Detail for the `header-click` event fired when a column header is clicked. */
+type MillerHeaderClickDetail = {
+  /** Zero-based column index whose header was clicked. */depth: number; /** The header text (label of the column's parent node). */
+  label: string;
+  /**
+   * Ancestry chain from the root node down to (and including) the node
+   * whose label is shown in this header.
+   * - depth 0 → [root]
+   * - depth 1 → [root, selectedAtDepth0]
+   * - depth d → [root, sel[0], …, sel[d-1]]
+   */
+  path: TreeNode[];
+};
+/** Detail for the `item-dblclick` event. */
+type MillerItemDblClickDetail = {
+  node: TreeNode;
+  depth: number;
+};
+/** Detail for the `item-rightclick` event. */
+type MillerItemRightClickDetail = {
+  node: TreeNode;
+  depth: number;
+  mouseEvent: MouseEvent;
+};
+/** Detail for the `header-rightclick` event. */
+type MillerHeaderRightClickDetail = {
+  depth: number;
+  label: string;
+  path: TreeNode[];
+  mouseEvent: MouseEvent;
+};
+type MillerHeaderClickEvent = CustomEvent<MillerHeaderClickDetail>;
+type MillerItemDblClickEvent = CustomEvent<MillerItemDblClickDetail>;
+type MillerItemRightClickEvent = CustomEvent<MillerItemRightClickDetail>;
+type MillerHeaderRightClickEvent = CustomEvent<MillerHeaderRightClickDetail>;
+/**
+ * A snapshot of all display states for a single item in the miller columns.
+ *
+ * - `selected`: the item is part of the active selection.
+ * - `open`: the item is an ancestor of the current deepest column (it is on
+ *   the currently open path, regardless of whether it is also selected).
+ * - `focused`: the keyboard cursor is currently on this item.
+ * - `isLeaf`: the item has no children and cannot be expanded.
+ */
+type MillerItemState = {
+  selected: boolean;
+  open: boolean;
+  focused: boolean;
+  isLeaf: boolean;
+};
+//#endregion
+//#region src/miller/miller-base.d.ts
+/**
+ * Base class for Miller column components. Handles column lifecycle,
+ * column resizing, keyboard navigation, and selection modes.
+ *
+ * Subclasses must override `renderColumnContent`.
+ *
+ * ## Interaction modes (`interactionMode`)
+ *
+ * Controls how clicks map to selection changes. Default: `'standard'`.
+ *
+ * - `implicit`: Selection follows the cursor path (navigation mode).
+ * - `standard`: Single click selects; Shift+click range-selects within a column;
+ *   Cmd/Ctrl+click toggles individual items.
+ * - `manual`: Component never modifies selection. Use `selectedKeys` / `setSelected`
+ *   / `clearSelection` to drive state externally.
+ * - `checked`: Checkboxes on every item (rendered by subclass via `_isChecked` /
+ *   `_handleCheckboxClick`). Clicking the item navigates/expands; clicking the
+ *   checkbox toggles selection of the node and all loaded descendants.
+ *
+ * ## Events
+ * - `expand`: FYI event fired after a column opens. Detail: `{ node, depth }`
+ * - `collapse`: FYI event fired when a column closes. Detail: `{ node, depth }`
+ * - `header-click`: fired when a column header is clicked (requires `headers` attr).
+ *   Detail: `{ depth, label, path: MillerNode[] }`
+ * - `activate`: fired when Enter is pressed on an item. Detail: `{ node, depth }`
+ * - `select`: fired when the selection set changes. Detail: `{ selected, previous }`
+ * - `item-click`: fired on any item click. Detail: `{ node, depth }`
+ * - `tickle`: fired when an item is hovered or keyboard cursor moves to it. Detail: `{ node, depth }`
+ *
+ * ## CSS variables
+ * - `--column-bg`: var(--surface-3)
+ * - `--column-header-bg`: var(--surface-2)
+ * - `--column-header-text`: var(--surface-muted-text)
+ * - `--column-separator`: var(--surface-5)
+ * - `--column-resize-handle`: var(--surface-5)
+ * - `--column-resize-handle-hover`: var(--accent)
+ * - `--column-resize-width`: 4px
+ * - `--item-hover-bg`: var(--item-bg-tickled)
+ * - `--item-selected-bg`: var(--item-bg-selected)
+ * - `--item-selected-text`: var(--item-text-selected)
+ */
+declare class MillerBaseElement extends LitElement implements TreeComponent, TreeSearchHost {
+  #private;
+  root: TreeNode | undefined;
+  model: TreeDataModel | undefined;
+  headers: boolean;
+  /**
+   * Controls the column-level interaction pattern (how clicks map to column changes).
+   * This is distinct from `selectionFilter` (which restricts which node kinds are selectable).
+   * Default: `'standard'`.
+   */
+  interactionMode: MillerSelectionMode;
+  selectionFilter: TreeSelectionFilter;
+  exclusivity: TreeExclusivity;
+  /**
+   * Callback to load children for a lazy node.
+   * Superseded by `model` when both are set.
+   * If not set and `model` is not set, clicking a lazy node opens an empty column.
+   */
+  loadChildren: LoadChildrenCallback | undefined;
+  filterPredicate: TreeFilterPredicate | undefined;
+  protected _columns: TreeNode[][];
+  protected _loadingDepth: number | undefined;
+  protected _selectedByDepth: Map<number, TreeNode>;
+  protected _selectedKeys: Set<string>;
+  protected _selectedNodes: Set<TreeNode>;
+  tickled: TickledController<string>;
+  updated(changedProps: PropertyValues): void;
+  disconnectedCallback(): void;
+  getConfig(): MillerConfig;
+  setConfig(config: MillerConfig): void;
+  /** Read current selection as an immutable set of item keys. */
+  get selectedKeys(): ReadonlySet<string>;
+  /** Replace entire selection and trigger a re-render. */
+  set selectedKeys(keys: Iterable<string>);
+  /** The most recently selected node. */
+  get selectedNode(): TreeNode | undefined;
+  set selectedNode(node: TreeNode | undefined);
+  /** Full selection set (implements TreeComponent interface). */
+  get selectedNodes(): ReadonlySet<TreeNode>;
+  /** Add `node` to the selection (respects selectionFilter). Dispatches `select` event. */
+  select(node: TreeNode): void;
+  /** Remove `node` from the selection. Dispatches `select` event. */
+  deselect(node: TreeNode): void;
+  /**
+   * Clear all selection and trigger a re-render.
+   */
+  clearSelection(): void;
+  /**
+   * Select or deselect a single node by key.
+   * In `checked` interactionMode this also recursively selects/deselects all loaded descendants.
+   */
+  setSelected(node: TreeNode, selected: boolean): void;
+  /**
+   * Return all MillerNodes whose key is in `_selectedKeys`, searching only
+   * the currently visible columns.
+   */
+  getSelected(): TreeNode[];
+  /**
+   * Programmatically navigate to a node by key path.
+   */
+  navigateTo(keys: readonly string[]): boolean;
+  /**
+   * Programmatically navigate to the first node (breadth-first) matching a predicate.
+   */
+  navigateToNode(predicate: (node: TreeNode) => boolean): boolean;
+  getNodes(): ReadonlyArray<{
+    node: TreeNode;
+    depth: number;
+  }>;
+  protected renderColumnContent(nodes: TreeNode[], depth: number): TemplateResult | typeof nothing;
+  protected _handleItemClick(node: TreeNode, depth: number, event?: MouseEvent): void;
+  /**
+   * Called by subclasses (in `checked` interactionMode) when a checkbox is clicked.
+   */
+  protected _handleCheckboxClick(event: MouseEvent, node: TreeNode, _depth: number): void;
+  /**
+   * Called by subclasses when an item is double-clicked.
+   */
+  protected _handleItemDblClick(node: TreeNode, depth: number, _event: MouseEvent): void;
+  /**
+   * Called by subclasses when an item is right-clicked.
+   */
+  protected _handleItemRightClick(node: TreeNode, depth: number, event: MouseEvent): void;
+  /**
+   * Called by subclasses when a column header is right-clicked.
+   */
+  protected _handleHeaderRightClick(event: MouseEvent, depth: number): void;
+  protected _isSelected(node: TreeNode, depth: number): boolean;
+  protected _isOpen(node: TreeNode, depth: number): boolean;
+  /**
+   * Return the display state for an item identified by key at a given depth.
+   */
+  getItemState(key: string, depth: number): MillerItemState | undefined;
+  /**
+   * Override to provide a custom loading indicator.
+   */
+  protected renderLoadingIndicator(): TemplateResult | typeof nothing;
+  protected render(): TemplateResult<1>;
+  protected _getFocusedIndex(depth: number): number;
+  protected _isFocused(node: TreeNode, depth: number): boolean;
+  /**
+   * Called by subclasses when pointer enters an item.
+   * Fires tickle event and switches to mouse mode.
+   */
+  protected _handleItemPointerEnter(node: TreeNode, depth: number): void;
+  /**
+   * Called by subclasses when pointer leaves the column container.
+   */
+  protected _handleColumnPointerLeave(): void;
+  static styles: _$lit.CSSResult[];
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'ixfx-miller-base': MillerBaseElement;
+  }
+}
+interface MillerBaseElementEventMap extends TreeComponentEventMap {
+  'item-click': TreeItemClickEvent;
+  'expand': TreeExpandEvent;
+  'collapse': TreeCollapseEvent;
+  'select': TreeSelectEvent;
+  'tickle': TreeTickleEvent;
+  'activate': TreeActivateEvent;
+  'item-dblclick': CustomEvent<MillerItemDblClickDetail>;
+  'item-rightclick': CustomEvent<MillerItemRightClickDetail>;
+  'header-click': CustomEvent<MillerHeaderClickDetail>;
+  'header-rightclick': CustomEvent<MillerHeaderRightClickDetail>;
+}
+interface MillerBaseElement {
+  addEventListener<K extends keyof MillerBaseElementEventMap>(type: K, listener: (this: MillerBaseElement, event: MillerBaseElementEventMap[K]) => void, options?: boolean | AddEventListenerOptions): void;
+  addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+  removeEventListener<K extends keyof MillerBaseElementEventMap>(type: K, listener: (this: MillerBaseElement, event: MillerBaseElementEventMap[K]) => void, options?: boolean | EventListenerOptions): void;
+  removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+}
+//#endregion
+//#region src/miller/miller-list.d.ts
+/**
+ * Miller columns with a vertical list layout — items stack in rows like macOS Finder.
+ *
+ * Usage:
+ * ```html
+ * <ixfx-miller-list id="miller"></ixfx-miller-list>
+ * <script>
+ *   const el = document.getElementById('miller');
+ *   el.root = { item: { key: 'root', label: 'Root' }, children: [...] };
+ *   el.addEventListener('expand', ({ detail }) => {
+ *     detail.node.children = fetchChildren(detail.node.item.key);
+ *     el.requestUpdate();
+ *   });
+ * </script>
+ * ```
+ */
+declare class MillerListElement extends MillerBaseElement {
+  #private;
+  protected renderColumnContent(nodes: TreeNode[], depth: number): TemplateResult;
+  static styles: _$lit.CSSResult[];
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'ixfx-miller-list': MillerListElement;
+  }
+} //# sourceMappingURL=miller-list.d.ts.map
+//#endregion
+//#region src/miller/miller-tree-controller.d.ts
+type MillerTreeControllerOptions<T> = {
+  /**
+   * Convert a tree node's value to a `MillerItem`.
+   * You must supply at minimum `key` and `label`.
+   * If `isLeaf` is omitted the controller infers it from whether the
+   * `TraversableTree` node has any children.
+   */
+  valueToItem: (value: T, node: TraversableTree<T>) => TreeItem;
+};
+/**
+ * Bridges an `ixfx` `TraversableTree<T>` with an `ixfx-miller-*` component.
+ *
+ * Usage:
+ * ```ts
+ * import { Trees } from '@ixfx/collections';
+ * import { MillerTreeController } from 'ixfx-components/miller';
+ *
+ * const root = Trees.Mutable.createNode({ key: 'root', label: 'Root' });
+ * Trees.Mutable.addValue({ key: 'a', label: 'Alpha' }, root);
+ *
+ * const ctrl = new MillerTreeController(
+ *   Trees.Mutable.asDynamicTraversable(root),
+ *   document.querySelector('ixfx-miller-list'),
+ *   { valueToItem: v => ({ key: v.key, label: v.label }) }
+ * );
+ * ctrl.connect();
+ * ```
+ *
+ * Children are populated lazily: the controller provides a `loadChildren`
+ * callback that synchronously reads from the underlying tree.
+ *
+ * Call `disconnect()` to remove all event listeners and release resources.
+ */
+declare class MillerTreeController<T> {
+  #private;
+  constructor(root: TraversableTree<T>, element: MillerBaseElement, options: MillerTreeControllerOptions<T>);
+  /**
+   * Wire up the controller: sets `element.root` and provides `loadChildren` callback.
+   * Safe to call again after `disconnect()`.
+   */
+  connect(): void;
+  /** Remove all event listeners and release internal state. */
+  disconnect(): void;
+  /**
+   * Navigate the component to the first node (depth-first) in the ixfx tree
+   * whose value satisfies `predicate`.
+   *
+   * Any ancestor `MillerNode`s with unloaded children are populated
+   * synchronously before calling `element.navigateTo()`.
+   *
+   * Returns `false` if no matching node is found.
+   */
+  navigateToValue(predicate: (value: T) => boolean): boolean;
+}
+//#endregion
+export { type TreeActivateDetail as MillerActivateDetail, type TreeActivateEvent as MillerActivateEvent, MillerBaseElement, MillerBaseElementEventMap, type TreeCollapseDetail as MillerCollapseDetail, type TreeCollapseEvent as MillerCollapseEvent, MillerConfig, type TreeExpandDetail as MillerExpandDetail, type TreeExpandEvent as MillerExpandEvent, MillerHeaderClickDetail, MillerHeaderClickEvent, MillerHeaderRightClickDetail, MillerHeaderRightClickEvent, type TreeItem as MillerItem, type TreeItemClickDetail as MillerItemClickDetail, type TreeItemClickEvent as MillerItemClickEvent, MillerItemDblClickDetail, MillerItemDblClickEvent, MillerItemRightClickDetail, MillerItemRightClickEvent, MillerItemState, MillerListElement, type TreeNode as MillerNode, type TreeSelectDetail as MillerSelectDetail, type TreeSelectEvent as MillerSelectEvent, MillerSelectionMode, type TreeTickleDetail as MillerTickleDetail, type TreeTickleEvent as MillerTickleEvent, MillerTreeController, MillerTreeControllerOptions };
+//# sourceMappingURL=miller.d.ts.map

package/dist/miller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miller.d.ts","names":[],"sources":["../src/miller/types.ts","../src/miller/miller-base.ts","../src/miller/miller-list.ts","../src/miller/miller-tree-controller.ts"],"mappings":"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"}