@helixui/library 1.0.1 → 1.1.2-next.1

package/dist/shared/hx-tree-item-DTDIBRrI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-tree-item-DTDIBRrI.js","sources":["../../src/components/hx-tree-view/hx-tree-view.styles.ts","../../src/components/hx-tree-view/hx-tree-view.ts","../../src/components/hx-tree-view/hx-tree-item.styles.ts","../../src/components/hx-tree-view/hx-tree-item.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixTreeViewStyles = css`\n  :host {\n    display: block;\n    contain: layout style;\n    font-family: var(--hx-tree-font-family, var(--hx-font-family-sans, sans-serif));\n  }\n\n  * {\n    box-sizing: border-box;\n  }\n\n  .tree {\n    display: block;\n    outline: none;\n  }\n\n  .tree:focus-visible {\n    outline: var(--hx-focus-ring-width, 2px) solid\n      var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa));\n    outline-offset: var(--hx-focus-ring-offset, 2px);\n    border-radius: var(--hx-border-radius-sm, 0.25rem);\n  }\n`;\n","import { LitElement, html, nothing } from 'lit';\nimport { customElement, property, state } from 'lit/decorators.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { helixTreeViewStyles } from './hx-tree-view.styles.js';\nimport type { HelixTreeItem, HxTreeItemSelectDetail } from './hx-tree-item.js';\nimport { devWarn } from '../../utils/dev-warn.js';\n\n/** Selection mode for the tree. */\nexport type TreeSelection = 'none' | 'single' | 'multiple';\n\n/** Detail type for the `hx-select` event. */\nexport interface HxSelectDetail {\n  /** The tree item that was selected or deselected. */\n  item: HelixTreeItem;\n  /** Whether the item is now selected. */\n  selected: boolean;\n}\n\n/**\n * A hierarchical tree component for navigating nested data structures.\n * Used in healthcare applications for org charts, ICD-10 code hierarchies, and department navigation.\n *\n * Implements WAI-ARIA tree view pattern with `role=\"tree\"` on the container\n * and `role=\"treeitem\"` on each item. Supports `aria-label` via the `label` property\n * for screen reader identification. Full keyboard navigation: Arrow keys for movement,\n * Enter/Space for selection, Home/End for first/last item.\n *\n * ## Scale Limits\n *\n * This component renders all tree items simultaneously in the DOM. It is suitable for\n * trees with up to ~500 visible items. For large taxonomies (e.g., ICD-10 with 70,000+\n * codes), use async/lazy loading: only render top-level nodes initially and populate\n * child nodes on `hx-select` or expand events. The component exposes the `expanded`\n * property on `hx-tree-item` for programmatic control of subtrees, enabling consumer-level\n * virtualization strategies without requiring changes to this component.\n *\n * @summary Hierarchical tree view with expand/collapse and keyboard navigation.\n *\n * @tag hx-tree-view\n *\n * @slot - Default slot for hx-tree-item elements.\n *\n * @fires {CustomEvent<HxSelectDetail>} hx-select - Dispatched when a tree item is selected or deselected.\n *\n * @csspart tree - The tree container element with role=\"tree\".\n *\n * @cssprop [--hx-tree-font-family=var(--hx-font-family-sans)] - Tree font family.\n */\n@customElement('hx-tree-view')\nexport class HelixTreeView extends LitElement {\n  static override styles = [tokenStyles, helixTreeViewStyles];\n\n  // ─── Properties ───\n\n  /**\n   * Accessible label for the tree. Applied as `aria-label` on the tree container.\n   * Provides context to screen readers about the tree's purpose.\n   * @attr label\n   */\n  @property({ type: String, reflect: true })\n  label = '';\n\n  /**\n   * Selection mode for the tree.\n   * - `none` — items cannot be selected\n   * - `single` — only one item can be selected at a time\n   * - `multiple` — multiple items can be selected\n   * @attr selection\n   */\n  @property({ type: String, reflect: true })\n  selection: 'none' | 'single' | 'multiple' = 'none';\n\n  // ─── Internal State ───\n\n  /** @internal */\n  @state() private _currentIndex = 0;\n\n  /** Tracks whether the tree has any visible items, to decide the container tabindex. */\n  /** @internal */\n  @state() private _hasVisibleItems = false;\n\n  // ─── Visible items cache ───\n\n  /**\n   * Cached flat list of visible items (depth-first, respects collapsed nodes).\n   * Set to null to invalidate; rebuilt on next access.\n   * @internal\n   */\n  private _cachedVisibleItems: HelixTreeItem[] | null = null;\n\n  /**\n   * Invalidate the visible-items cache. Call after any expand/collapse or structural change.\n   * @internal\n   */\n  private _invalidateVisibleItemsCache(): void {\n    this._cachedVisibleItems = null;\n  }\n\n  // ─── Internal Helpers ───\n\n  /**\n   * Returns a flat ordered list of all visible (not inside a collapsed item) hx-tree-items\n   * in depth-first order. Result is cached; invalidated on expand/collapse/slotchange.\n   */\n  /** @internal */\n  private _getVisibleItems(): HelixTreeItem[] {\n    if (!this._cachedVisibleItems) {\n      this._cachedVisibleItems = this._collectVisibleItems(this);\n    }\n    return this._cachedVisibleItems;\n  }\n\n  /** @internal */\n  private _collectVisibleItems(container: Element): HelixTreeItem[] {\n    const items: HelixTreeItem[] = [];\n    for (const child of Array.from(container.children)) {\n      if (child.tagName.toLowerCase() === 'hx-tree-item') {\n        const item = child as HelixTreeItem;\n        items.push(item);\n        if (item.expanded) {\n          items.push(...this._collectVisibleItems(item));\n        }\n      } else {\n        items.push(...this._collectVisibleItems(child));\n      }\n    }\n    return items;\n  }\n\n  /** @internal */\n  private _getSelectedItems(): HelixTreeItem[] {\n    return Array.from(this.querySelectorAll<HelixTreeItem>('hx-tree-item[selected]'));\n  }\n\n  /**\n   * Updates the roving tabindex across all visible items so that only the\n   * item at `activeIndex` has `tabindex=\"0\"`. All others receive `tabindex=\"-1\"`.\n   * This is called whenever the active item changes (navigation, initial render).\n   */\n  /** @internal */\n  private _updateRovingTabindex(items: HelixTreeItem[], activeIndex: number): void {\n    items.forEach((item, i) => {\n      item.setRovingActive(i === activeIndex);\n    });\n  }\n\n  /** @internal */\n  private _focusItem(index: number): void {\n    const items = this._getVisibleItems();\n    if (items.length === 0) return;\n    const clamped = Math.max(0, Math.min(index, items.length - 1));\n    this._currentIndex = clamped;\n    this._updateRovingTabindex(items, clamped);\n    items[clamped]?.focus();\n  }\n\n  // ─── Event Handling ───\n\n  /** @internal */\n  private _handleTreeItemSelect(e: Event): void {\n    if (!(e instanceof CustomEvent)) return;\n    const event = e as CustomEvent<HxTreeItemSelectDetail>;\n    const item = event.detail.item;\n\n    if (this.selection === 'none') return;\n\n    if (this.selection === 'single') {\n      const wasSelected = item.selected;\n      this._getSelectedItems().forEach((i) => {\n        i.selected = false;\n      });\n      item.selected = !wasSelected;\n    } else if (this.selection === 'multiple') {\n      item.selected = !item.selected;\n    }\n\n    this.dispatchEvent(\n      new CustomEvent<HxSelectDetail>('hx-select', {\n        bubbles: true,\n        composed: true,\n        detail: { item, selected: item.selected },\n      }),\n    );\n  }\n\n  /** @internal */\n  private _handleKeyDown(e: KeyboardEvent): void {\n    const items = this._getVisibleItems();\n    if (items.length === 0) return;\n\n    let currentIndex = this._currentIndex;\n    const focused = document.activeElement;\n\n    for (let i = 0; i < items.length; i++) {\n      if (items[i] === focused || items[i]?.shadowRoot?.activeElement) {\n        currentIndex = i;\n        break;\n      }\n    }\n\n    switch (e.key) {\n      case 'ArrowDown': {\n        e.preventDefault();\n        const next = currentIndex < items.length - 1 ? currentIndex + 1 : 0;\n        this._focusItem(next);\n        break;\n      }\n      case 'ArrowUp': {\n        e.preventDefault();\n        const prev = currentIndex > 0 ? currentIndex - 1 : items.length - 1;\n        this._focusItem(prev);\n        break;\n      }\n      case 'ArrowLeft': {\n        e.preventDefault();\n        const currentItem = items[currentIndex];\n        if (!currentItem) break;\n        if (currentItem.expanded && currentItem.hasChildItems) {\n          currentItem.expanded = false;\n          this._invalidateVisibleItemsCache();\n        } else {\n          const parentItem = currentItem.parentElement?.closest('hx-tree-item') as\n            | HelixTreeItem\n            | undefined;\n          if (parentItem) {\n            const parentIndex = items.indexOf(parentItem);\n            if (parentIndex >= 0) {\n              this._focusItem(parentIndex);\n            }\n          }\n        }\n        break;\n      }\n      case 'ArrowRight': {\n        e.preventDefault();\n        const currentItem = items[currentIndex];\n        if (!currentItem) break;\n        if (currentItem.hasChildItems) {\n          if (!currentItem.expanded) {\n            currentItem.expanded = true;\n            this._invalidateVisibleItemsCache();\n          } else {\n            this._focusItem(currentIndex + 1);\n          }\n        }\n        break;\n      }\n      case 'Home': {\n        e.preventDefault();\n        this._focusItem(0);\n        break;\n      }\n      case 'End': {\n        e.preventDefault();\n        this._focusItem(items.length - 1);\n        break;\n      }\n    }\n  }\n\n  /** @internal */\n  private _handleFocusIn(e: FocusEvent): void {\n    // With roving tabindex, the tree container (tabindex=\"-1\") should only receive\n    // focus when the tree is empty. If focus does land on the container (e.g. the\n    // tree is empty or programmatic focus), redirect to the active item if present.\n    if (e.target === e.currentTarget) {\n      const items = this._getVisibleItems();\n      if (items.length > 0) {\n        this._focusItem(this._currentIndex);\n      }\n    }\n  }\n\n  /**\n   * Compute and push ARIA position metadata (level, posInSet, setSize, selectable) to all\n   * direct hx-tree-item children of a container in a single O(n) pass.\n   * Each item also recurses for its own children, building the full tree in O(total-items) total.\n   * @internal\n   */\n  private _updateAriaMetadataForContainer(container: Element, level: number): void {\n    const selectable = this.selection === 'single' || this.selection === 'multiple';\n    const children = Array.from(container.children).filter(\n      (c) => c.tagName.toLowerCase() === 'hx-tree-item',\n    ) as HelixTreeItem[];\n    const setSize = children.length;\n    children.forEach((item, index) => {\n      item.setAriaMetadata(level, index + 1, setSize, selectable);\n      // Recurse into child items so the full tree is updated in one traversal\n      this._updateAriaMetadataForContainer(item, level + 1);\n    });\n  }\n\n  /**\n   * Initializes the roving tabindex after items are first slotted in.\n   * Ensures the active item (index 0 by default) has tabindex=\"0\" from the start,\n   * so a Tab into the tree lands directly on the first item without a redirect.\n   * Also updates `_hasVisibleItems` so the container tabindex re-renders correctly.\n   * Pushes O(n) ARIA metadata to all items to replace the O(n^2) per-item ancestor walk.\n   */\n  /** @internal */\n  private _handleSlotChange(): void {\n    this._invalidateVisibleItemsCache();\n    // Push ARIA metadata from parent in a single O(n) traversal\n    this._updateAriaMetadataForContainer(this, 1);\n    const items = this._getVisibleItems();\n    this._hasVisibleItems = items.length > 0;\n    if (items.length === 0) return;\n    // Clamp _currentIndex in case items were removed.\n    const clamped = Math.min(this._currentIndex, items.length - 1);\n    this._currentIndex = clamped;\n    this._updateRovingTabindex(items, clamped);\n  }\n\n  // ─── Lifecycle ───\n\n  override firstUpdated(): void {\n    if (!this.label) {\n      devWarn(\n        'hx-tree-view',\n        'No accessible label provided. Set the `label` attribute on hx-tree-view so screen readers can identify this tree (WCAG 4.1.2).',\n      );\n    }\n  }\n\n  // ─── Render ───\n\n  override render() {\n    // Roving tabindex pattern (WCAG 2.4.3 Fix):\n    // The tree container is NOT a Tab stop (tabindex=\"-1\"). Tab focus goes\n    // directly to the active item, which carries tabindex=\"0\". The container\n    // is only a landing target (tabindex=\"0\") when the tree is empty.\n    const containerTabindex = this._hasVisibleItems ? '-1' : '0';\n\n    return html`\n      <div\n        part=\"tree\"\n        class=\"tree\"\n        role=\"tree\"\n        tabindex=${containerTabindex}\n        aria-label=${this.label || 'Tree'}\n        aria-multiselectable=${this.selection === 'none'\n          ? nothing\n          : this.selection === 'multiple'\n            ? 'true'\n            : 'false'}\n        @hx-tree-item-select=${this._handleTreeItemSelect}\n        @keydown=${this._handleKeyDown}\n        @focusin=${this._handleFocusIn}\n      >\n        <slot @slotchange=${this._handleSlotChange}></slot>\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-tree-view': HelixTreeView;\n  }\n}\n\n/** Canonical type alias for HelixTreeView. Use this when typing hx-tree-view element references. */\nexport type HxTreeView = HelixTreeView;\n\n/** @deprecated Use {@link HxTreeView} instead. The `Wc` prefix was a legacy naming convention. */\nexport type WcTreeView = HelixTreeView;\n","import { css } from 'lit';\n\nexport const helixTreeItemStyles = css`\n  :host {\n    display: block;\n    contain: layout style;\n  }\n\n  * {\n    box-sizing: border-box;\n  }\n\n  /* ─── Item Container ─── */\n\n  .item {\n    display: block;\n  }\n\n  /* ─── Item Row ─── */\n\n  .item-row {\n    display: flex;\n    align-items: center;\n    gap: var(--hx-tree-item-gap, var(--hx-space-2, 0.5rem));\n    padding: var(--hx-tree-item-padding-y, var(--hx-space-1, 0.25rem))\n      var(--hx-tree-item-padding-x, var(--hx-space-2, 0.5rem));\n    padding-inline-start: calc(\n      var(--hx-tree-item-padding-x, var(--hx-space-2, 0.5rem)) + var(--_indent-level, 0) *\n        var(--hx-tree-indent-size, 1.5rem)\n    );\n    border-radius: var(--hx-tree-item-border-radius, var(--hx-border-radius-sm, 0.25rem));\n    cursor: pointer;\n    outline: none;\n    color: var(--hx-tree-item-color, var(--hx-color-neutral-900, #111827));\n    font-family: var(--hx-tree-item-font-family, var(--hx-font-family-sans, sans-serif));\n    font-size: var(--hx-tree-item-font-size, var(--hx-font-size-sm, 0.875rem));\n    line-height: var(--hx-line-height-normal, 1.5);\n    transition: background-color var(--hx-transition-fast, 150ms ease);\n    user-select: none;\n  }\n\n  .item-row:hover {\n    background-color: var(--hx-tree-item-hover-bg, var(--hx-color-neutral-100, #f3f4f6));\n  }\n\n  .item-row:focus-visible {\n    outline: var(--hx-focus-ring-width, 2px) solid\n      var(--hx-tree-item-focus-ring-color, var(--hx-focus-ring-color, var(--hx-color-primary-500)));\n    outline-offset: var(--hx-focus-ring-offset, -2px);\n  }\n\n  /* ─── Selected State ─── */\n\n  :host([selected]) .item-row {\n    background-color: var(--hx-tree-item-selected-bg, var(--hx-color-primary-100, #dbeafe));\n    color: var(--hx-tree-item-selected-color, var(--hx-color-primary-800, #1e40af));\n  }\n\n  :host([selected]) .item-row:hover {\n    background-color: var(--hx-tree-item-selected-hover-bg, var(--hx-color-primary-200, #bfdbfe));\n  }\n\n  /* ─── Disabled State ─── */\n\n  :host([disabled]) .item-row {\n    opacity: var(--hx-opacity-disabled, 0.5);\n    cursor: not-allowed;\n    pointer-events: none;\n  }\n\n  /* ─── Expand Icon ─── */\n\n  .expand-icon {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    flex-shrink: 0;\n    width: var(--hx-space-4, 1rem);\n    height: var(--hx-space-4, 1rem);\n  }\n\n  .expand-btn {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    width: var(--hx-space-4, 1rem);\n    height: var(--hx-space-4, 1rem);\n    padding: 0;\n    border: none;\n    background: transparent;\n    color: var(--hx-tree-item-expand-icon-color, var(--hx-color-neutral-500, #6b7280));\n    cursor: pointer;\n    border-radius: var(--hx-border-radius-sm, 0.25rem);\n    transition: transform var(--hx-transition-fast, 150ms ease);\n    pointer-events: auto;\n  }\n\n  .expand-btn:hover {\n    background-color: var(\n      --hx-tree-item-expand-hover-bg,\n      var(--hx-overlay-black-6, rgba(0, 0, 0, 0.06))\n    );\n  }\n\n  .expand-btn:focus-visible {\n    outline: var(--hx-focus-ring-width, 2px) solid\n      var(--hx-tree-item-focus-ring-color, var(--hx-focus-ring-color, var(--hx-color-primary-500)));\n    outline-offset: var(--hx-focus-ring-offset, 2px);\n  }\n\n  .expand-btn svg {\n    width: var(--hx-space-3, 0.75rem);\n    height: var(--hx-space-3, 0.75rem);\n    stroke: currentColor;\n    fill: none;\n    stroke-width: 2;\n    stroke-linecap: round;\n    stroke-linejoin: round;\n    transition: transform var(--hx-transition-fast, 150ms ease);\n  }\n\n  :host([expanded]) .expand-btn svg {\n    transform: rotate(90deg);\n  }\n\n  .expand-placeholder {\n    display: block;\n    width: var(--hx-space-4, 1rem);\n    flex-shrink: 0;\n  }\n\n  /* ─── Icon Slot ─── */\n\n  .item-icon {\n    display: flex;\n    align-items: center;\n    flex-shrink: 0;\n    color: var(--hx-tree-item-icon-color, var(--hx-color-neutral-500, #6b7280));\n  }\n\n  .item-icon:empty {\n    display: none;\n  }\n\n  /* ─── Label ─── */\n\n  .item-label {\n    flex: 1;\n    min-width: 0;\n    overflow: hidden;\n    text-overflow: ellipsis;\n    white-space: nowrap;\n  }\n\n  /* ─── Children (animated) ─── */\n\n  .children {\n    display: grid;\n    grid-template-rows: 0fr;\n    transition: grid-template-rows var(--hx-transition-base, 200ms ease);\n    --_indent-level: calc(var(--_indent-level, 0) + 1);\n  }\n\n  .children--expanded {\n    grid-template-rows: 1fr;\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    .item-row,\n    .expand-btn,\n    .expand-btn svg,\n    .children {\n      transition: none;\n    }\n  }\n\n  .children-inner {\n    overflow: hidden;\n  }\n`;\n","import { LitElement, html, nothing } from 'lit';\nimport { customElement, property, query, state } from 'lit/decorators.js';\nimport { classMap } from 'lit/directives/class-map.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { helixTreeItemStyles } from './hx-tree-item.styles.js';\n\n/** Detail type for the `hx-tree-item-select` event. */\nexport interface HxTreeItemSelectDetail {\n  /** The tree item that was selected or activated. */\n  item: HelixTreeItem;\n}\n\n/**\n * A tree item used within an hx-tree-view component.\n * Supports expand/collapse, selection, keyboard navigation, and icon/children slots.\n *\n * @summary Individual item within an hx-tree-view hierarchical tree.\n *\n * @tag hx-tree-item\n *\n * @slot - Default slot for the item label content. This text is also used to label the children group.\n * @slot icon - Custom icon shown before the label.\n * @slot children - Nested hx-tree-item elements for sub-tree.\n *\n * @csspart item - The outer item container.\n * @csspart row - The interactive item row (contains expand icon, icon slot, and label).\n * @csspart expand-icon - The expand/collapse toggle button.\n * @csspart label - The label text content area.\n * @csspart children - The children container.\n *\n * @cssprop [--hx-tree-item-color=var(--hx-color-neutral-900)] - Item text color.\n * @cssprop [--hx-tree-item-hover-bg=var(--hx-color-neutral-100)] - Hover background color.\n * @cssprop [--hx-tree-item-selected-bg=var(--hx-color-primary-100)] - Selected background color.\n * @cssprop [--hx-tree-item-selected-color=var(--hx-color-primary-800)] - Selected text color.\n * @cssprop [--hx-tree-item-padding-x=var(--hx-space-2)] - Horizontal padding.\n * @cssprop [--hx-tree-item-padding-y=var(--hx-space-1)] - Vertical padding.\n * @cssprop [--hx-tree-indent-size=1.5rem] - Indentation size per level.\n *\n * @fires {CustomEvent<HxTreeItemSelectDetail>} hx-tree-item-select - Dispatched when this item is clicked or activated via keyboard.\n */\n@customElement('hx-tree-item')\nexport class HelixTreeItem extends LitElement {\n  static override styles = [tokenStyles, helixTreeItemStyles];\n\n  // ─── Properties ───\n\n  /**\n   * Whether the item is expanded (showing children).\n   * @attr expanded\n   */\n  @property({ type: Boolean, reflect: true })\n  expanded = false;\n\n  /**\n   * Whether the item is selected.\n   * @attr selected\n   */\n  @property({ type: Boolean, reflect: true })\n  selected = false;\n\n  /**\n   * Whether the item is disabled (non-interactive).\n   * @attr disabled\n   */\n  @property({ type: Boolean, reflect: true })\n  disabled = false;\n\n  // ─── Internal State ───\n\n  /**\n   * Tracks whether any elements are assigned to the children slot, controlling expand icon visibility.\n   * @internal\n   */\n  @state() private _hasChildren = false;\n\n  /**\n   * Whether this item is the roving-tabindex active item in the tree.\n   * @internal\n   */\n  @state() private _rovingActive = false;\n\n  /**\n   * Text content from the default slot, used to label the children group for screen readers.\n   * @internal\n   */\n  @state() private _labelText = '';\n\n  /**\n   * Cached ARIA position metadata. Computed once on connect and on slotchange\n   * of the parent container, avoiding repeated DOM traversal on every render.\n   * @internal\n   */\n  @state() private _level = 1;\n  /**\n   * One-based position of this item within its sibling set, set as aria-posinset.\n   * @internal\n   */\n  @state() private _posInSet = 1;\n  /**\n   * Total count of sibling hx-tree-item elements at the same level, set as aria-setsize.\n   * @internal\n   */\n  @state() private _setSize = 1;\n  /**\n   * Whether the owning hx-tree-view supports item selection (single or multiple mode).\n   * @internal\n   */\n  @state() private _selectable = false;\n\n  /** @internal */\n  @query('.item-row') private _itemRowEl!: HTMLElement | null;\n\n  // ─── Computed ARIA ───\n\n  /**\n   * Whether this item has slotted children.\n   * @returns True if one or more elements are assigned to the children slot.\n   */\n  get hasChildItems(): boolean {\n    return this._hasChildren;\n  }\n\n  /**\n   * Recompute all cached ARIA metadata in a single DOM pass.\n   * Called on connect, slotchange, and whenever structural context may change.\n   * @internal\n   */\n  private _updateAriaMetadata(): void {\n    // Compute nesting level by counting ancestor hx-tree-item elements.\n    let level = 1;\n    let el: Element | null = this.parentElement;\n    while (el) {\n      if (el.tagName.toLowerCase() === 'hx-tree-item') level++;\n      el = el.parentElement;\n    }\n    this._level = level;\n\n    // Compute position-in-set and set-size from sibling hx-tree-item elements.\n    const parent = this.parentElement;\n    if (parent) {\n      const siblings = Array.from(parent.children).filter(\n        (c) => c.tagName.toLowerCase() === 'hx-tree-item',\n      );\n      this._posInSet = siblings.indexOf(this) + 1;\n      this._setSize = siblings.length;\n    } else {\n      this._posInSet = 1;\n      this._setSize = 1;\n    }\n\n    // Determine if the owning tree supports selection.\n    const tree = this.closest('hx-tree-view');\n    if (tree) {\n      const selection = tree.getAttribute('selection');\n      this._selectable = selection === 'single' || selection === 'multiple';\n    } else {\n      this._selectable = false;\n    }\n  }\n\n  /**\n   * Set ARIA position metadata from the parent hx-tree-view in a single O(n) pass.\n   * Calling this avoids the O(n^2) ancestor-walk + sibling-iteration in _updateAriaMetadata\n   * when the parent already knows the layout.\n   * @internal\n   */\n  setAriaMetadata(level: number, posInSet: number, setSize: number, selectable: boolean): void {\n    this._level = level;\n    this._posInSet = posInSet;\n    this._setSize = setSize;\n    this._selectable = selectable;\n  }\n\n  // ─── Lifecycle ───\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n    this._updateAriaMetadata();\n  }\n\n  // ─── Children Detection ───\n\n  /**\n   * Updates _hasChildren and recomputes ARIA metadata when the children slot assignment changes.\n   * @internal\n   */\n  private _handleChildrenSlotChange(e: Event): void {\n    const slot = e.target as HTMLSlotElement;\n    this._hasChildren = slot.assignedElements().length > 0;\n    this._updateAriaMetadata();\n  }\n\n  /**\n   * Captures the text content from the default (label) slot for use on the children group label.\n   * @internal\n   */\n  private _handleLabelSlotChange(e: Event): void {\n    const slot = e.target as HTMLSlotElement;\n    const nodes = slot.assignedNodes({ flatten: true });\n    this._labelText = nodes\n      .map((n) => n.textContent ?? '')\n      .join('')\n      .trim();\n  }\n\n  // ─── Event Handlers ───\n\n  /**\n   * Toggles the expanded state when the expand/collapse button is clicked, stopping event propagation.\n   * @internal\n   */\n  private _handleExpandClick(e: Event): void {\n    e.stopPropagation();\n    if (this.disabled) return;\n    this.expanded = !this.expanded;\n  }\n\n  /**\n   * Dispatches the hx-tree-item-select event when the item is activated via click or keyboard.\n   * @internal\n   */\n  private _handleRowClick(): void {\n    if (this.disabled) return;\n    this.dispatchEvent(\n      new CustomEvent<HxTreeItemSelectDetail>('hx-tree-item-select', {\n        bubbles: true,\n        composed: true,\n        detail: { item: this },\n      }),\n    );\n  }\n\n  /**\n   * Handles keyboard interaction for the tree item, including expand/collapse, activation, and delegation of list-navigation keys to the parent tree.\n   * @internal\n   */\n  private _handleKeyDown(e: KeyboardEvent): void {\n    if (this.disabled) return;\n\n    switch (e.key) {\n      case 'ArrowRight':\n        e.preventDefault();\n        if (this._hasChildren && !this.expanded) {\n          this.expanded = true;\n        }\n        break;\n      case 'ArrowLeft':\n        e.preventDefault();\n        if (this._hasChildren && this.expanded) {\n          this.expanded = false;\n        }\n        break;\n      case 'Enter':\n      case ' ':\n        e.preventDefault();\n        this._handleRowClick();\n        break;\n      case 'ArrowDown':\n      case 'ArrowUp':\n      case 'Home':\n      case 'End':\n        // Bubble up to hx-tree-view for navigation\n        break;\n    }\n  }\n\n  // ─── Public API ───\n\n  /**\n   * Sets the roving tabindex state for this item.\n   * When `active` is true, the item row gets `tabindex=\"0\"` making it the\n   * Tab-reachable item in the tree. All other items should be set to false.\n   * Called by the parent hx-tree-view to manage the roving tabindex pattern.\n   */\n  setRovingActive(active: boolean): void {\n    this._rovingActive = active;\n  }\n\n  /** Focus this item's interactive row element. */\n  override focus(): void {\n    this._itemRowEl?.focus();\n  }\n\n  // ─── Render ───\n\n  /**\n   * Renders the expand/collapse chevron button, or a placeholder span when the item has no children.\n   * @internal\n   */\n  private _renderExpandIcon() {\n    if (!this._hasChildren) {\n      return html`<span class=\"expand-placeholder\" aria-hidden=\"true\"></span>`;\n    }\n    return html`\n      <button\n        part=\"expand-icon\"\n        class=\"expand-btn\"\n        tabindex=\"-1\"\n        aria-label=\"${this.expanded ? 'Collapse' : 'Expand'}\"\n        @click=${this._handleExpandClick}\n      >\n        <svg viewBox=\"0 0 16 16\" aria-hidden=\"true\">\n          <polyline points=\"6 4 10 8 6 12\" />\n        </svg>\n      </button>\n    `;\n  }\n\n  override render() {\n    const ariaExpanded = this._hasChildren ? String(this.expanded) : nothing;\n    const ariaSelected = this._selectable ? String(this.selected) : nothing;\n\n    return html`\n      <div part=\"item\" class=\"item\">\n        <div\n          part=\"row\"\n          class=\"item-row\"\n          role=\"treeitem\"\n          tabindex=${this._rovingActive ? '0' : '-1'}\n          aria-expanded=${ariaExpanded}\n          aria-selected=${ariaSelected}\n          aria-disabled=${this.disabled ? 'true' : nothing}\n          aria-level=${this._level}\n          aria-posinset=${this._posInSet}\n          aria-setsize=${this._setSize}\n          @click=${this._handleRowClick}\n          @keydown=${this._handleKeyDown}\n        >\n          ${this._renderExpandIcon()}\n          <span class=\"item-icon\">\n            <slot name=\"icon\"></slot>\n          </span>\n          <span part=\"label\" class=\"item-label\">\n            <slot @slotchange=${this._handleLabelSlotChange}></slot>\n          </span>\n        </div>\n        <div\n          part=\"children\"\n          class=${classMap({ children: true, 'children--expanded': this.expanded })}\n          role=\"group\"\n          aria-label=${this._labelText ? `${this._labelText} children` : 'children'}\n        >\n          <div class=\"children-inner\">\n            <slot name=\"children\" @slotchange=${this._handleChildrenSlotChange}></slot>\n          </div>\n        </div>\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-tree-item': HelixTreeItem;\n  }\n}\n\n/** Canonical type alias for HelixTreeItem. Use this when typing hx-tree-item element references. */\nexport type HxTreeItem = HelixTreeItem;\n\n/** @deprecated Use {@link HxTreeItem} instead. The `Wc` prefix was a legacy naming convention. */\nexport type WcTreeItem = HelixTreeItem;\n"],"names":["helixTreeViewStyles","css","HelixTreeView","LitElement","container","items","child","item","activeIndex","i","index","clamped","_a","wasSelected","currentIndex","focused","_b","next","prev","currentItem","parentItem","_c","parentIndex","level","selectable","children","c","setSize","containerTabindex","html","nothing","tokenStyles","__decorateClass","property","state","customElement","helixTreeItemStyles","HelixTreeItem","el","parent","siblings","tree","selection","posInSet","slot","nodes","n","active","ariaExpanded","ariaSelected","classMap","query"],"mappings":"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"}

package/dist/shared/id-counter-JhvVCnjh.js

@@ -0,0 +1,143 @@
+var c = (s) => {
+  throw TypeError(s);
+};
+var l = (s, e, t) => e.has(s) || c("Cannot " + t);
+var n = (s, e, t) => (l(s, e, "read from private field"), t ? t.call(s) : e.get(s)), d = (s, e, t) => e.has(s) ? c("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(s) : e.set(s, t), u = (s, e, t, r) => (l(s, e, "write to private field"), r ? r.call(s, t) : e.set(s, t), t);
+import { LitElement as h } from "lit";
+var o;
+const a = class a extends h {
+  constructor() {
+    super(...arguments);
+    d(this, o);
+  }
+  /**
+   * Lazy accessor for `ElementInternals`. Calls `attachInternals()` on first
+   * access and caches the result.
+   *
+   * Only valid when `static formAssociated = true` is declared on the subclass.
+   * Accessing this on a non-form-associated component throws a descriptive error.
+   *
+   * @throws {Error} If accessed on a component where `formAssociated` is `false`
+   * @internal
+   */
+  get _internals() {
+    if (!this.constructor.formAssociated)
+      throw new Error(
+        `[HelixElement] _internals accessed on <${this.tagName.toLowerCase()}> but static formAssociated is not set to true on ${this.constructor.name}.`
+      );
+    const t = n(this, o);
+    if (t !== void 0)
+      return t;
+    const r = this.attachInternals();
+    return u(this, o, r), r;
+  }
+  // ─── Browser Form Callbacks (delegate to hook methods) ───
+  /**
+   * Called by the browser when the element's form-associated disabled state
+   * changes (e.g., a parent `<fieldset disabled>` is toggled).
+   *
+   * Delegates to `_onFormDisabled`. Override that method in subclasses.
+   * @internal
+   */
+  formDisabledCallback(t) {
+    this._onFormDisabled(t);
+  }
+  /**
+   * Called by the browser when the owning form is reset.
+   *
+   * Delegates to `_onFormReset`. Override that method in subclasses.
+   * @internal
+   */
+  formResetCallback() {
+    this._onFormReset();
+  }
+  /**
+   * Called by the browser to restore form state (e.g., back/forward cache).
+   *
+   * Delegates to `_onFormStateRestore`. Override that method in subclasses.
+   * @internal
+   */
+  formStateRestoreCallback(t, r) {
+    this._onFormStateRestore(t, r);
+  }
+  // ─── Hook Methods (override in subclasses) ───
+  /**
+   * Override in subclass to react to the element being disabled or enabled
+   * via a parent `<fieldset>`.
+   *
+   * @param _disabled - `true` when the element is being disabled
+   * @internal
+   */
+  _onFormDisabled(t) {
+  }
+  /**
+   * Override in subclass to reset component state when the owning form resets.
+   * @internal
+   */
+  _onFormReset() {
+  }
+  /**
+   * Override in subclass to restore component state from saved form state.
+   *
+   * @param _state - The saved state value, or `null` if none
+   * @param _mode - `'restore'` for bfcache navigation, `'autocomplete'` for autofill
+   * @internal
+   */
+  _onFormStateRestore(t, r) {
+  }
+  // ─── Convenience Getters ───
+  /**
+   * The associated form element, or `null` if not form-associated or not yet
+   * connected to a form.
+   *
+   * Form-associated subclasses that need a guaranteed non-null return type
+   * should redeclare this getter and delegate to `this._internals.form`.
+   *
+   * @internal
+   */
+  get form() {
+    const t = n(this, o);
+    return !this.constructor.formAssociated || t === void 0 ? null : t.form;
+  }
+  /**
+   * The current `ValidityState` for this element, or `null` if not
+   * form-associated.
+   *
+   * Form-associated subclasses that need a guaranteed `ValidityState` return
+   * should redeclare this getter and delegate to `this._internals.validity`.
+   *
+   * @internal
+   */
+  get validity() {
+    const t = n(this, o);
+    return !this.constructor.formAssociated || t === void 0 ? null : t.validity;
+  }
+  /**
+   * The current validation message, or an empty string if not form-associated
+   * or if the element is valid.
+   *
+   * @internal
+   */
+  get validationMessage() {
+    const t = n(this, o);
+    return !this.constructor.formAssociated || t === void 0 ? "" : t.validationMessage;
+  }
+};
+o = new WeakMap(), a.formAssociated = !1;
+let f = a;
+const i = /* @__PURE__ */ new Map();
+function v(s) {
+  return () => {
+    const e = i.get(s) ?? 0;
+    return i.set(s, e + 1), `${s}-${e}`;
+  };
+}
+function b(s) {
+  s !== void 0 ? i.delete(s) : i.clear();
+}
+export {
+  f as H,
+  v as c,
+  b as r
+};
+//# sourceMappingURL=id-counter-JhvVCnjh.js.map

package/dist/shared/id-counter-JhvVCnjh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-counter-JhvVCnjh.js","sources":["../../src/base/helix-element.ts","../../src/base/id-counter.ts"],"sourcesContent":["import { LitElement } from 'lit';\n\n/**\n * `HelixElement` extends `LitElement` with shared infrastructure for all HELiX\n * components: lazy `ElementInternals` access, form lifecycle hook delegation,\n * and convenience validity getters.\n *\n * Form association is opt-in via `static formAssociated = true` on the subclass.\n * When set, `HelixElement` provides a lazy `_internals` accessor that calls\n * `attachInternals()` on first access — eliminating constructor boilerplate.\n *\n * Form components should also override the `_onForm*` hook methods rather than\n * re-declaring the raw browser callbacks (`formResetCallback`, etc.).\n *\n * @example Non-form component — no configuration required:\n * ```ts\n * class HxCard extends HelixElement {\n *   // no formAssociated needed\n * }\n * ```\n *\n * @example Form-associated component:\n * ```ts\n * class HxTextInput extends HelixElement {\n *   static override formAssociated = true;\n *\n *   override _onFormReset(): void {\n *     this.value = '';\n *     this._internals.setFormValue('');\n *   }\n *\n *   override _onFormDisabled(disabled: boolean): void {\n *     this.disabled = disabled;\n *   }\n * }\n * ```\n *\n * @public\n */\nexport class HelixElement extends LitElement {\n  /**\n   * Set to `true` on the subclass to enable ElementInternals form association.\n   *\n   * IMPORTANT: This MUST be redeclared as `static override formAssociated = true`\n   * on each form-associated subclass. The browser's form association mechanism\n   * inspects `formAssociated` on the *registered* custom element class, not\n   * on ancestor classes.\n   *\n   * @internal\n   */\n  static formAssociated = false;\n\n  #internals: ElementInternals | undefined;\n\n  /**\n   * Lazy accessor for `ElementInternals`. Calls `attachInternals()` on first\n   * access and caches the result.\n   *\n   * Only valid when `static formAssociated = true` is declared on the subclass.\n   * Accessing this on a non-form-associated component throws a descriptive error.\n   *\n   * @throws {Error} If accessed on a component where `formAssociated` is `false`\n   * @internal\n   */\n  get _internals(): ElementInternals {\n    if (!(this.constructor as typeof HelixElement).formAssociated) {\n      throw new Error(\n        `[HelixElement] _internals accessed on <${this.tagName.toLowerCase()}> but ` +\n          `static formAssociated is not set to true on ${this.constructor.name}.`,\n      );\n    }\n    const cached = this.#internals;\n    if (cached !== undefined) {\n      return cached;\n    }\n    const internals = this.attachInternals();\n    this.#internals = internals;\n    return internals;\n  }\n\n  // ─── Browser Form Callbacks (delegate to hook methods) ───\n\n  /**\n   * Called by the browser when the element's form-associated disabled state\n   * changes (e.g., a parent `<fieldset disabled>` is toggled).\n   *\n   * Delegates to `_onFormDisabled`. Override that method in subclasses.\n   * @internal\n   */\n  formDisabledCallback(disabled: boolean): void {\n    this._onFormDisabled(disabled);\n  }\n\n  /**\n   * Called by the browser when the owning form is reset.\n   *\n   * Delegates to `_onFormReset`. Override that method in subclasses.\n   * @internal\n   */\n  formResetCallback(): void {\n    this._onFormReset();\n  }\n\n  /**\n   * Called by the browser to restore form state (e.g., back/forward cache).\n   *\n   * Delegates to `_onFormStateRestore`. Override that method in subclasses.\n   * @internal\n   */\n  formStateRestoreCallback(\n    state: File | string | FormData | null,\n    mode: 'restore' | 'autocomplete',\n  ): void {\n    this._onFormStateRestore(state, mode);\n  }\n\n  // ─── Hook Methods (override in subclasses) ───\n\n  /**\n   * Override in subclass to react to the element being disabled or enabled\n   * via a parent `<fieldset>`.\n   *\n   * @param _disabled - `true` when the element is being disabled\n   * @internal\n   */\n  protected _onFormDisabled(_disabled: boolean): void {}\n\n  /**\n   * Override in subclass to reset component state when the owning form resets.\n   * @internal\n   */\n  protected _onFormReset(): void {}\n\n  /**\n   * Override in subclass to restore component state from saved form state.\n   *\n   * @param _state - The saved state value, or `null` if none\n   * @param _mode - `'restore'` for bfcache navigation, `'autocomplete'` for autofill\n   * @internal\n   */\n  protected _onFormStateRestore(\n    _state: File | string | FormData | null,\n    _mode: 'restore' | 'autocomplete',\n  ): void {}\n\n  // ─── Convenience Getters ───\n\n  /**\n   * The associated form element, or `null` if not form-associated or not yet\n   * connected to a form.\n   *\n   * Form-associated subclasses that need a guaranteed non-null return type\n   * should redeclare this getter and delegate to `this._internals.form`.\n   *\n   * @internal\n   */\n  get form(): HTMLFormElement | null {\n    const internals = this.#internals;\n    if (!(this.constructor as typeof HelixElement).formAssociated || internals === undefined) {\n      return null;\n    }\n    return internals.form;\n  }\n\n  /**\n   * The current `ValidityState` for this element, or `null` if not\n   * form-associated.\n   *\n   * Form-associated subclasses that need a guaranteed `ValidityState` return\n   * should redeclare this getter and delegate to `this._internals.validity`.\n   *\n   * @internal\n   */\n  get validity(): ValidityState | null {\n    const internals = this.#internals;\n    if (!(this.constructor as typeof HelixElement).formAssociated || internals === undefined) {\n      return null;\n    }\n    return internals.validity;\n  }\n\n  /**\n   * The current validation message, or an empty string if not form-associated\n   * or if the element is valid.\n   *\n   * @internal\n   */\n  get validationMessage(): string {\n    const internals = this.#internals;\n    if (!(this.constructor as typeof HelixElement).formAssociated || internals === undefined) {\n      return '';\n    }\n    return internals.validationMessage;\n  }\n}\n","/**\n * Module-level monotonic ID counter factory.\n *\n * Provides collision-free, deterministic, SSR-safe IDs for components that\n * need stable element IDs (for ARIA relationships, label associations, etc.)\n * without relying on Math.random() which causes hydration mismatches.\n *\n * @public\n */\n\nconst counters = new Map<string, number>();\n\n/**\n * Creates a monotonic ID generator for the given namespace.\n *\n * @param namespace - Component namespace (e.g. 'hx-text-input')\n * @returns A function that returns the next unique ID string\n * @public\n *\n * @example\n * ```ts\n * const nextId = createIdCounter('hx-text-input');\n * private _id = nextId(); // 'hx-text-input-0', 'hx-text-input-1', ...\n * ```\n */\nexport function createIdCounter(namespace: string): () => string {\n  return () => {\n    const current = counters.get(namespace) ?? 0;\n    counters.set(namespace, current + 1);\n    return `${namespace}-${current}`;\n  };\n}\n\n/**\n * Resets the counter for the given namespace (or all namespaces if omitted).\n * Use in test `beforeEach()` for counter isolation between tests.\n *\n * @param namespace - Optional namespace to reset. If omitted, resets all counters.\n * @public\n */\nexport function resetIdCounter(namespace?: string): void {\n  if (namespace !== undefined) {\n    counters.delete(namespace);\n  } else {\n    counters.clear();\n  }\n}\n"],"names":["_HelixElement","LitElement","__privateAdd","_internals","cached","__privateGet","internals","__privateSet","disabled","state","mode","_disabled","_state","_mode","HelixElement","counters","createIdCounter","namespace","current","resetIdCounter"],"mappings":";;;;;;;AAuCO,MAAMA,IAAN,MAAMA,UAAqBC,EAAW;AAAA,EAAtC;AAAA;AAaL,IAAAC,EAAA,MAAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,IAAI,aAA+B;AACjC,QAAI,CAAE,KAAK,YAAoC;AAC7C,YAAM,IAAI;AAAA,QACR,0CAA0C,KAAK,QAAQ,YAAA,CAAa,qDACnB,KAAK,YAAY,IAAI;AAAA,MAAA;AAG1E,UAAMC,IAASC,EAAA,MAAKF;AACpB,QAAIC,MAAW;AACb,aAAOA;AAET,UAAME,IAAY,KAAK,gBAAA;AACvB,WAAAC,EAAA,MAAKJ,GAAaG,IACXA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,qBAAqBE,GAAyB;AAC5C,SAAK,gBAAgBA,CAAQ;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,oBAA0B;AACxB,SAAK,aAAA;AAAA,EACP;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,yBACEC,GACAC,GACM;AACN,SAAK,oBAAoBD,GAAOC,CAAI;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWU,gBAAgBC,GAA0B;AAAA,EAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAM3C,eAAqB;AAAA,EAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAStB,oBACRC,GACAC,GACM;AAAA,EAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaT,IAAI,OAA+B;AACjC,UAAMP,IAAYD,EAAA,MAAKF;AACvB,WAAI,CAAE,KAAK,YAAoC,kBAAkBG,MAAc,SACtE,OAEFA,EAAU;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,IAAI,WAAiC;AACnC,UAAMA,IAAYD,EAAA,MAAKF;AACvB,WAAI,CAAE,KAAK,YAAoC,kBAAkBG,MAAc,SACtE,OAEFA,EAAU;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,oBAA4B;AAC9B,UAAMA,IAAYD,EAAA,MAAKF;AACvB,WAAI,CAAE,KAAK,YAAoC,kBAAkBG,MAAc,SACtE,KAEFA,EAAU;AAAA,EACnB;AACF;AA9IEH,IAAA,eAFAH,EAAO,iBAAiB;AAXnB,IAAMc,IAANd;AC7BP,MAAMe,wBAAe,IAAA;AAed,SAASC,EAAgBC,GAAiC;AAC/D,SAAO,MAAM;AACX,UAAMC,IAAUH,EAAS,IAAIE,CAAS,KAAK;AAC3C,WAAAF,EAAS,IAAIE,GAAWC,IAAU,CAAC,GAC5B,GAAGD,CAAS,IAAIC,CAAO;AAAA,EAChC;AACF;AASO,SAASC,EAAeF,GAA0B;AACvD,EAAIA,MAAc,SAChBF,EAAS,OAAOE,CAAS,IAEzBF,EAAS,MAAA;AAEb;"}

package/dist/shared/{toast-factory-MvMMreTu.js → toast-factory-f184Gi70.js}

@@ -1,8 +1,8 @@
 import { css as p, LitElement as f, html as l, nothing as u } from "lit";
-import { property as c, customElement as v } from "lit/decorators.js";
+import { property as c, query as b, state as y, customElement as v } from "lit/decorators.js";
 import { classMap as _ } from "lit/directives/class-map.js";
 import { tokenStyles as x } from "@helixui/tokens/lit";
-const b = p`
+const w = p`
   /* ─── hx-toast host ─── */
 
   :host {
@@ -124,13 +124,16 @@ const b = p`
     display: inline-flex;
     align-items: center;
     justify-content: center;
+    /* WCAG 2.5.5: minimum 44×44px touch target */
+    min-width: var(--hx-touch-target-min, 2.75rem);
+    min-height: var(--hx-touch-target-min, 2.75rem);
     padding: var(--hx-space-1, 0.25rem);
     background: transparent;
     border: none;
     border-radius: var(--hx-border-radius-sm, 0.25rem);
     color: inherit;
     cursor: pointer;
-    opacity: 0.7;
+    opacity: var(--hx-opacity-75, 0.75);
     transition: opacity var(--hx-transition-fast, 150ms ease);
   }
 
@@ -149,12 +152,16 @@ const b = p`
     .toast {
       transition: none;
     }
+
+    .toast__close {
+      transition: none;
+    }
   }
-`, y = p`
+`, C = p`
   :host {
     display: block;
     position: fixed;
-    z-index: var(--hx-z-index-toast, 9000);
+    z-index: var(--hx-z-index-toast, 1700);
     pointer-events: none;
   }
 
@@ -170,45 +177,45 @@ const b = p`
 
   :host([placement='top-start']) {
     top: 0;
-    left: 0;
-    right: auto;
+    inset-inline-start: 0;
+    inset-inline-end: auto;
     bottom: auto;
   }
 
   :host([placement='top-center']) {
     top: 0;
-    left: 50%;
+    inset-inline-start: 50%;
     transform: translateX(-50%);
-    right: auto;
+    inset-inline-end: auto;
     bottom: auto;
   }
 
   :host([placement='top-end']) {
     top: 0;
-    right: 0;
-    left: auto;
+    inset-inline-end: 0;
+    inset-inline-start: auto;
     bottom: auto;
   }
 
   :host([placement='bottom-start']) {
     bottom: 0;
-    left: 0;
-    right: auto;
+    inset-inline-start: 0;
+    inset-inline-end: auto;
     top: auto;
   }
 
   :host([placement='bottom-center']) {
     bottom: 0;
-    left: 50%;
+    inset-inline-start: 50%;
     transform: translateX(-50%);
-    right: auto;
+    inset-inline-end: auto;
     top: auto;
   }
 
   :host([placement='bottom-end']) {
     bottom: 0;
-    right: 0;
-    left: auto;
+    inset-inline-end: 0;
+    inset-inline-start: auto;
     top: auto;
   }
 
@@ -224,23 +231,23 @@ const b = p`
     --hx-toast-enter-translate: calc(var(--hx-space-2, 0.5rem) * -1);
   }
 `;
-var w = Object.defineProperty, L = Object.getOwnPropertyDescriptor, h = (e, r, s, a) => {
-  for (var t = a > 1 ? void 0 : a ? L(r, s) : r, o = e.length - 1, i; o >= 0; o--)
-    (i = e[o]) && (t = (a ? i(r, s, t) : i(t)) || t);
-  return a && t && w(r, s, t), t;
+var S = Object.defineProperty, E = Object.getOwnPropertyDescriptor, h = (t, a, r, s) => {
+  for (var e = s > 1 ? void 0 : s ? E(a, r) : a, n = t.length - 1, i; n >= 0; n--)
+    (i = t[n]) && (e = (s ? i(a, r, e) : i(e)) || e);
+  return s && e && S(a, r, e), e;
 };
-let n = class extends f {
+let o = class extends f {
   constructor() {
-    super(...arguments), this.variant = "default", this.duration = 3e3, this.closable = !1, this.open = !1, this.closeLabel = "Dismiss notification", this._timer = null, this._timerStartedAt = null, this._timerRemaining = null;
+    super(...arguments), this.variant = "default", this.duration = 5e3, this.closable = !1, this.open = !1, this.labelClose = "Dismiss notification", this._hasActionContent = !1, this._timer = null, this._timerStartedAt = null, this._timerRemaining = null;
   }
   // ─── Reduced Motion ───
   /** @internal Returns true when the user has opted into reduced motion. */
   get _reducedMotion() {
-    return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+    return typeof window > "u" ? !1 : window.matchMedia("(prefers-reduced-motion: reduce)").matches;
   }
   // ─── Lifecycle ───
-  updated(e) {
-    e.has("open") && (this.open ? (this.removeAttribute("aria-hidden"), this._emitShow(), this.duration > 0 && !this._reducedMotion && this._startTimer()) : (this.setAttribute("aria-hidden", "true"), this._clearTimer(), this._emitHide()));
+  updated(t) {
+    super.updated(t), t.has("open") && (this.open ? (this.removeAttribute("aria-hidden"), this._emitShow(), this.duration > 0 && !this._reducedMotion && !this._hasActionContent && this._startTimer()) : (this.setAttribute("aria-hidden", "true"), this._clearTimer(), this._emitHide()));
   }
   disconnectedCallback() {
     super.disconnectedCallback(), this._clearTimer();
@@ -256,19 +263,19 @@ let n = class extends f {
   }
   // ─── Private Helpers ───
   /** @internal */
-  _startTimer(e) {
+  _startTimer(t) {
     this._clearTimerHandle();
-    const r = e ?? this.duration;
-    this._timerStartedAt = Date.now(), this._timerRemaining = r, this._timer = setTimeout(() => {
+    const a = t ?? this.duration;
+    this._timerStartedAt = Date.now(), this._timerRemaining = a, this._timer = setTimeout(() => {
       this.open = !1;
-    }, r);
+    }, a);
   }
   /** @internal */
   _pauseTimer() {
     if (this._timer === null || this._timerStartedAt === null || this._timerRemaining === null)
       return;
-    const e = Date.now() - this._timerStartedAt;
-    this._timerRemaining = Math.max(0, this._timerRemaining - e), this._clearTimerHandle();
+    const t = Date.now() - this._timerStartedAt;
+    this._timerRemaining = Math.max(0, this._timerRemaining - t), this._clearTimerHandle();
   }
   /** @internal */
   _clearTimerHandle() {
@@ -284,13 +291,12 @@ let n = class extends f {
   }
   /** @internal */
   _emitHide() {
-    var a;
     this.dispatchEvent(new CustomEvent("hx-hide", { bubbles: !0, composed: !0 }));
-    let e = !1;
-    const r = () => {
-      e || (e = !0, this.dispatchEvent(new CustomEvent("hx-after-hide", { bubbles: !0, composed: !0 })));
-    }, s = (a = this.shadowRoot) == null ? void 0 : a.querySelector(".toast");
-    s && s.addEventListener("transitionend", r, { once: !0 }), setTimeout(r, 300);
+    let t = !1;
+    const a = () => {
+      t || (t = !0, this.dispatchEvent(new CustomEvent("hx-after-hide", { bubbles: !0, composed: !0 })));
+    }, r = this._toastEl;
+    r && r.addEventListener("transitionend", a, { once: !0 }), setTimeout(a, 300);
   }
   // ─── Event Handlers ───
   /** @internal */
@@ -313,6 +319,11 @@ let n = class extends f {
   _handleClose() {
     this.hide();
   }
+  /** @internal */
+  _handleActionSlotChange(t) {
+    const a = t.target;
+    this._hasActionContent = a.assignedNodes({ flatten: !0 }).length > 0, this._hasActionContent && this.open && this._pauseTimer();
+  }
   // ─── ARIA Helpers ───
   /** @internal */
   get _role() {
@@ -325,6 +336,7 @@ let n = class extends f {
   // ─── WCAG 1.4.1: Default Icons ───
   // Each semantic variant renders a default icon when no icon is slotted,
   // ensuring the severity is not conveyed by color alone.
+  /** @internal */
   _renderSuccessIcon() {
     return l`<svg viewBox="0 0 20 20" aria-hidden="true" width="16" height="16">
       <path
@@ -333,6 +345,7 @@ let n = class extends f {
       />
     </svg>`;
   }
+  /** @internal */
   _renderWarningIcon() {
     return l`<svg viewBox="0 0 20 20" aria-hidden="true" width="16" height="16">
       <path
@@ -341,6 +354,7 @@ let n = class extends f {
       />
     </svg>`;
   }
+  /** @internal */
   _renderDangerIcon() {
     return l`<svg viewBox="0 0 20 20" aria-hidden="true" width="16" height="16">
       <path
@@ -349,6 +363,7 @@ let n = class extends f {
       />
     </svg>`;
   }
+  /** @internal */
   _renderInfoIcon() {
     return l`<svg viewBox="0 0 20 20" aria-hidden="true" width="16" height="16">
       <path
@@ -372,12 +387,13 @@ let n = class extends f {
         return u;
     }
   }
+  /** @internal */
   get _severityLabel() {
-    return n._SEVERITY_LABELS[this.variant] ?? "";
+    return o._SEVERITY_LABELS[this.variant] ?? "";
   }
   // ─── Render ───
   render() {
-    const e = this._severityLabel;
+    const t = this._severityLabel;
     return l`
       <div
         part="base"
@@ -394,7 +410,7 @@ let n = class extends f {
         @focusout=${this._handleFocusOut}
       >
         ${this.open ? l`
-              ${e ? l`<span class="toast__severity-label">${e}: </span>` : u}
+              ${t ? l`<span class="toast__severity-label">${t}: </span>` : u}
               <span part="icon" class="toast__icon">
                 <slot name="icon">${this._defaultIcon}</slot>
               </span>
@@ -402,13 +418,13 @@ let n = class extends f {
                 <slot></slot>
               </span>
               <span part="action" class="toast__action">
-                <slot name="action"></slot>
+                <slot name="action" @slotchange=${this._handleActionSlotChange}></slot>
               </span>
               ${this.closable ? l`
                     <button
                       part="close-button"
                       class="toast__close"
-                      aria-label=${this.closeLabel}
+                      aria-label=${this.labelClose}
                       @click=${this._handleClose}
                     >
                       <svg
@@ -431,8 +447,8 @@ let n = class extends f {
     `;
   }
 };
-n.styles = [x, b];
-n._SEVERITY_LABELS = {
+o.styles = [x, w];
+o._SEVERITY_LABELS = {
   success: "Success",
   warning: "Warning",
   danger: "Error",
@@ -440,26 +456,32 @@ n._SEVERITY_LABELS = {
 };
 h([
   c({ type: String, reflect: !0 })
-], n.prototype, "variant", 2);
+], o.prototype, "variant", 2);
 h([
   c({ type: Number })
-], n.prototype, "duration", 2);
+], o.prototype, "duration", 2);
 h([
   c({ type: Boolean, reflect: !0 })
-], n.prototype, "closable", 2);
+], o.prototype, "closable", 2);
 h([
   c({ type: Boolean, reflect: !0 })
-], n.prototype, "open", 2);
+], o.prototype, "open", 2);
+h([
+  c({ attribute: "label-close" })
+], o.prototype, "labelClose", 2);
+h([
+  b(".toast")
+], o.prototype, "_toastEl", 2);
 h([
-  c({ attribute: "close-label" })
-], n.prototype, "closeLabel", 2);
-n = h([
+  y()
+], o.prototype, "_hasActionContent", 2);
+o = h([
   v("hx-toast")
-], n);
-var S = Object.defineProperty, T = Object.getOwnPropertyDescriptor, m = (e, r, s, a) => {
-  for (var t = a > 1 ? void 0 : a ? T(r, s) : r, o = e.length - 1, i; o >= 0; o--)
-    (i = e[o]) && (t = (a ? i(r, s, t) : i(t)) || t);
-  return a && t && S(r, s, t), t;
+], o);
+var L = Object.defineProperty, T = Object.getOwnPropertyDescriptor, m = (t, a, r, s) => {
+  for (var e = s > 1 ? void 0 : s ? T(a, r) : a, n = t.length - 1, i; n >= 0; n--)
+    (i = t[n]) && (e = (s ? i(a, r, e) : i(e)) || e);
+  return s && e && L(a, r, e), e;
 };
 let d = class extends f {
   constructor() {
@@ -479,7 +501,7 @@ let d = class extends f {
     `;
   }
 };
-d.styles = [x, y];
+d.styles = [x, C];
 m([
   c({ type: String, reflect: !0 })
 ], d.prototype, "placement", 2);
@@ -489,22 +511,23 @@ m([
 d = m([
   v("hx-toast-stack")
 ], d);
-function I(e) {
-  var o;
-  const r = e.placement ?? "bottom-end", s = `hx-toast-stack[placement="${r}"]`;
-  let a = document.querySelector(s);
-  if (a || (a = document.createElement("hx-toast-stack"), a.placement = r, document.body.appendChild(a)), a.stackLimit > 0) {
-    const i = [...a.querySelectorAll("hx-toast")].filter((g) => g.open);
-    i.length >= a.stackLimit && ((o = i[0]) == null || o.hide());
-  }
-  const t = document.createElement("hx-toast");
-  return t.variant = e.variant ?? "default", t.duration = e.duration ?? 3e3, t.closable = !0, t.textContent = e.message, t.addEventListener("hx-after-hide", () => {
-    t.remove();
-  }), a.appendChild(t), t.show(), t;
+function M(t) {
+  var n;
+  if (typeof document > "u") throw new Error("toast() requires a browser environment");
+  const a = t.placement ?? "bottom-end", r = `hx-toast-stack[placement="${a}"]`;
+  let s = document.querySelector(r);
+  if (s || (s = document.createElement("hx-toast-stack"), s.placement = a, document.body.appendChild(s)), s.stackLimit > 0) {
+    const i = [...s.querySelectorAll("hx-toast")].filter((g) => g.open);
+    i.length >= s.stackLimit && ((n = i[0]) == null || n.hide());
+  }
+  const e = document.createElement("hx-toast");
+  return e.variant = t.variant ?? "default", e.duration = t.duration ?? 3e3, e.closable = !0, e.textContent = t.message, e.addEventListener("hx-after-hide", () => {
+    e.remove();
+  }), s.appendChild(e), e.show(), e;
 }
 export {
-  n as H,
+  o as H,
   d as a,
-  I as t
+  M as t
 };
-//# sourceMappingURL=toast-factory-MvMMreTu.js.map
+//# sourceMappingURL=toast-factory-f184Gi70.js.map