@helixui/library 3.1.0 → 3.2.0-next.102

package/dist/shared/{hx-breadcrumb-item-CldCwD1d.js → hx-breadcrumb-item-3tKppF9h.js}

@@ -1,8 +1,9 @@
 import { css as m, nothing as u, html as d } from "lit";
-import { property as n, state as x, customElement as b } from "lit/decorators.js";
-import { H as f } from "./helix-element-BNEYeiys.js";
-import { c as v } from "./id-counter-DuX8vsui.js";
-const y = m`
+import { property as n, state as v, customElement as b } from "lit/decorators.js";
+import { f } from "./forced-colors-CTEDFRGa.js";
+import { H as x } from "./helix-element-BNEYeiys.js";
+import { c as y } from "./id-counter-DuX8vsui.js";
+const g = m`
   :host {
     display: block;
     font-family: var(
@@ -66,15 +67,15 @@ const y = m`
     }
   }
 `;
-var g = Object.defineProperty, _ = Object.getOwnPropertyDescriptor, c = (t, e, s, a) => {
-  for (var r = a > 1 ? void 0 : a ? _(e, s) : e, o = t.length - 1, l; o >= 0; o--)
+var _ = Object.defineProperty, L = Object.getOwnPropertyDescriptor, c = (t, e, s, a) => {
+  for (var r = a > 1 ? void 0 : a ? L(e, s) : e, o = t.length - 1, l; o >= 0; o--)
     (l = t[o]) && (r = (a ? l(e, s, r) : l(r)) || r);
-  return a && r && g(e, s, r), r;
+  return a && r && _(e, s, r), r;
 };
-const L = v("hx-breadcrumb");
-let i = class extends f {
+const w = y("hx-breadcrumb");
+let i = class extends x {
   constructor() {
-    super(...arguments), this.separator = "/", this.label = "Breadcrumb", this.maxItems = 0, this.labelEllipsis = "Show all breadcrumb items", this.jsonLd = !1, this._showEllipsis = !1, this._jsonLdScript = null, this._managedCurrentItems = /* @__PURE__ */ new WeakSet(), this._jsonLdId = `${L()}-ld`;
+    super(...arguments), this.separator = "/", this.label = "Breadcrumb", this.maxItems = 0, this.labelEllipsis = "Show all breadcrumb items", this.jsonLd = !1, this._showEllipsis = !1, this._jsonLdScript = null, this._managedCurrentItems = /* @__PURE__ */ new WeakSet(), this._jsonLdId = `${w()}-ld`;
   }
   // ─── Item Helpers ───
   /**
@@ -224,7 +225,7 @@ let i = class extends f {
     `;
   }
 };
-i.styles = [y];
+i.styles = [g, f];
 c([
   n({ type: String })
 ], i.prototype, "separator", 2);
@@ -241,12 +242,12 @@ c([
   n({ type: Boolean, attribute: "json-ld" })
 ], i.prototype, "jsonLd", 2);
 c([
-  x()
+  v()
 ], i.prototype, "_showEllipsis", 2);
 i = c([
   b("hx-breadcrumb")
 ], i);
-const w = m`
+const C = m`
   :host {
     display: inline-flex;
     align-items: center;
@@ -264,7 +265,7 @@ const w = m`
   }
 
   [part='link'] {
-    color: var(--hx-breadcrumb-link-color, var(--hx-color-primary-600));
+    color: var(--hx-breadcrumb-link-color, var(--hx-color-primary-600, #0f7078));
     text-decoration: none;
     cursor: pointer;
     font-family: inherit;
@@ -276,22 +277,19 @@ const w = m`
   }
 
   [part='link']:hover {
-    color: var(--hx-breadcrumb-link-hover-color, var(--hx-color-primary-700));
+    color: var(--hx-breadcrumb-link-hover-color, var(--hx-color-primary-700, #0f6363));
     text-decoration: underline;
   }
 
   [part='link']:focus-visible {
     outline: var(--hx-focus-ring-width, 2px) solid
-      var(
-        --hx-breadcrumb-link-focus-ring-color,
-        var(--hx-focus-ring-color, var(--hx-color-primary-500))
-      );
+      var(--hx-breadcrumb-link-focus-ring-color, var(--hx-focus-ring-color, #0f7078));
     outline-offset: var(--hx-focus-ring-offset, 2px);
     border-radius: var(--hx-border-radius-sm, 0.25rem);
   }
 
   [part='text'] {
-    color: var(--hx-breadcrumb-text-color, var(--hx-color-neutral-700));
+    color: var(--hx-breadcrumb-text-color, var(--hx-color-text-strong, #202b39));
     font-family: inherit;
     font-size: inherit;
     max-width: var(--hx-breadcrumb-item-max-width);
@@ -302,7 +300,7 @@ const w = m`
 
   .separator {
     margin-inline: var(--hx-breadcrumb-separator-gap, var(--hx-space-1, 0.25rem));
-    color: var(--hx-breadcrumb-separator-color, var(--hx-color-neutral-400));
+    color: var(--hx-breadcrumb-separator-color, var(--hx-color-text-muted, #4a5362));
     user-select: none;
   }
 
@@ -336,12 +334,12 @@ const w = m`
     }
   }
 `;
-var C = Object.defineProperty, S = Object.getOwnPropertyDescriptor, h = (t, e, s, a) => {
+var I = Object.defineProperty, S = Object.getOwnPropertyDescriptor, h = (t, e, s, a) => {
   for (var r = a > 1 ? void 0 : a ? S(e, s) : e, o = t.length - 1, l; o >= 0; o--)
     (l = t[o]) && (r = (a ? l(e, s, r) : l(r)) || r);
-  return a && r && C(e, s, r), r;
+  return a && r && I(e, s, r), r;
 };
-let p = class extends f {
+let p = class extends x {
   constructor() {
     super(...arguments), this.href = void 0, this.dataBcLast = !1, this.current = !1;
   }
@@ -357,7 +355,7 @@ let p = class extends f {
     `;
   }
 };
-p.styles = [w];
+p.styles = [C, f];
 h([
   n({ type: String, reflect: !0 })
 ], p.prototype, "href", 2);
@@ -374,4 +372,4 @@ export {
   i as H,
   p as a
 };
-//# sourceMappingURL=hx-breadcrumb-item-CldCwD1d.js.map
+//# sourceMappingURL=hx-breadcrumb-item-3tKppF9h.js.map

package/dist/shared/hx-breadcrumb-item-3tKppF9h.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-breadcrumb-item-3tKppF9h.js","sources":["../../src/components/hx-breadcrumb/hx-breadcrumb.styles.ts","../../src/components/hx-breadcrumb/hx-breadcrumb.ts","../../src/components/hx-breadcrumb/hx-breadcrumb-item.styles.ts","../../src/components/hx-breadcrumb/hx-breadcrumb-item.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixBreadcrumbStyles = css`\n  :host {\n    display: block;\n    font-family: var(\n      --hx-breadcrumb-font-family,\n      var(--hx-font-family-sans, system-ui, sans-serif)\n    );\n    font-size: var(--hx-breadcrumb-font-size, var(--hx-font-size-sm, 0.875rem));\n  }\n\n  [part='nav'] {\n    /* nav landmark — no additional styling needed */\n  }\n\n  [part='list'] {\n    display: flex;\n    flex-wrap: wrap;\n    align-items: center;\n    list-style: none;\n    margin: 0;\n    padding: 0;\n    gap: 0;\n  }\n\n  /* Hide middle items when collapsed via maxItems */\n  ::slotted([data-bc-hidden]) {\n    display: none;\n  }\n\n  /*\n   * Ellipsis ordering when collapsed (FS-014 fix):\n   * The ellipsis <hx-breadcrumb-item> lives in shadow DOM to avoid mutating\n   * the consumer's light DOM. CSS order places it between the first item\n   * (order: 0, default) and the last item (order: 2) in the flex <ol>.\n   */\n  .hx-bc-ellipsis {\n    order: 1;\n  }\n\n  ::slotted([data-bc-last]) {\n    order: 2;\n  }\n\n  /* Visually hide the separator slot — used only to read text content.\n   * display:none is intentional: the slot contains no interactive or focusable\n   * content. If a future change adds focusable elements to this slot, switch to\n   * visibility:hidden + position:absolute to preserve focus reachability. */\n  .separator-slot {\n    display: none;\n  }\n\n  /* ─── High Contrast Mode (forced-colors) ─── */\n\n  /*\n   * hx-breadcrumb is a nav container. Link colors and separators are handled\n   * by hx-breadcrumb-item's own forced-colors block. No additional overrides needed\n   * at the container level.\n   */\n  @media (forced-colors: active) {\n    :host {\n      forced-color-adjust: auto;\n    }\n  }\n`;\n","import { html, nothing, type PropertyValues } from 'lit';\nimport '../../utilities/document-token-adoption.js';\nimport { customElement, property, state } from 'lit/decorators.js';\nimport { HelixElement, createIdCounter } from '../../base/index.js';\nimport { forcedColorsInteractive } from '../../styles/forced-colors.js';\nimport { helixBreadcrumbStyles } from './hx-breadcrumb.styles.js';\n\n/** Typed schema.org ListItem entry for JSON-LD BreadcrumbList structured data. */\ninterface JsonLdListItem {\n  '@type': string;\n  position: number;\n  name: string;\n  item?: string;\n}\n\nconst _nextBreadcrumbId = createIdCounter('hx-breadcrumb');\n\n/**\n * Hierarchical page path navigation showing current location in site structure.\n *\n * @summary Navigation breadcrumb showing the page hierarchy. Works with Drupal's breadcrumb system.\n *\n * @tag hx-breadcrumb\n *\n * @slot - Default slot for hx-breadcrumb-item children.\n * @slot separator - Optional separator element. Its text content overrides the `separator` property.\n *\n * @csspart nav - The nav landmark element.\n * @csspart list - The ordered list containing items.\n *\n * @cssprop [--hx-breadcrumb-separator-content='/'] - Separator character between items.\n *   NOTE: If overriding this custom property directly in CSS (rather than via the `separator`\n *   attribute), the value MUST be quoted: `--hx-breadcrumb-separator-content: \">\"`. An unquoted\n *   value is invalid for the CSS `content` property and will silently render nothing.\n * @cssprop [--hx-breadcrumb-separator-color=var(--hx-color-neutral-400)] - Separator color.\n * @cssprop [--hx-breadcrumb-separator-gap=var(--hx-space-1)] - Horizontal gap around separators.\n * @cssprop [--hx-breadcrumb-font-size=var(--hx-font-size-sm)] - Font size.\n * @cssprop [--hx-breadcrumb-link-color=var(--hx-color-primary-600)] - Link color.\n * @cssprop [--hx-breadcrumb-link-hover-color=var(--hx-color-primary-700)] - Link hover color.\n * @cssprop [--hx-breadcrumb-text-color=var(--hx-color-neutral-700)] - Current page text color.\n * @cssprop [--hx-breadcrumb-item-max-width] - Max-width for item text truncation (e.g. `12rem`).\n * @cssprop [--hx-breadcrumb-font-family] - CSS custom property.\n * @cssprop [--hx-font-family-sans] - Font family.\n * @cssprop [--hx-font-size-sm] - Font size.\n */\n@customElement('hx-breadcrumb')\nexport class HelixBreadcrumb extends HelixElement {\n  static override styles = [helixBreadcrumbStyles, forcedColorsInteractive];\n\n  /**\n   * The separator character displayed between breadcrumb items.\n   * @attr separator\n   */\n  @property({ type: String })\n  separator = '/';\n\n  /**\n   * The accessible label for the nav landmark.\n   * @attr label\n   */\n  @property({ type: String })\n  label = 'Breadcrumb';\n\n  /**\n   * Maximum number of items to show before collapsing middle items with an ellipsis.\n   * Set to 0 (default) to show all items. The ellipsis is a keyboard-accessible\n   * button; activating it expands the full breadcrumb by setting maxItems to 0.\n   * @attr max-items\n   */\n  @property({ type: Number, attribute: 'max-items' })\n  maxItems = 0;\n\n  /**\n   * Accessible label for the expand ellipsis button. Override for i18n.\n   * @attr label-ellipsis\n   */\n  @property({ attribute: 'label-ellipsis' }) labelEllipsis = 'Show all breadcrumb items';\n\n  /**\n   * When true, injects a JSON-LD BreadcrumbList structured data script into the document head.\n   *\n   * NOTE: Drupal manages `<head>` content via its own render pipeline. Injecting a\n   * `<script>` directly via `document.head.appendChild()` in a Drupal context:\n   * 1. Bypasses Drupal's deduplication and `hook_html_head_alter()` hook.\n   * 2. Is not cacheable by Drupal's page cache.\n   * 3. Will be wiped on BigPipe partial page replacements.\n   *\n   * For Drupal integrations, leave `json-ld` false and use the structured data\n   * Twig template instead (see `hx-breadcrumb.twig` in the component directory).\n   *\n   * @attr json-ld\n   */\n  @property({ type: Boolean, attribute: 'json-ld' })\n  jsonLd = false;\n\n  /**\n   * Whether the ellipsis expand button is currently shown (shadow DOM rendered).\n   * Driven by maxItems collapse logic; replaces the old light-DOM ellipsis injection.\n   * @internal\n   */\n  @state() private _showEllipsis = false;\n  /** @internal */\n  private _jsonLdScript: HTMLScriptElement | null = null;\n\n  /**\n   * Tracks which items had their `current` attribute set by this component\n   * (as opposed to set by a consumer/Drupal template). This lets us re-evaluate\n   * positional current-page detection on each slotchange without incorrectly\n   * treating a previously component-set `current` attribute as a consumer-set\n   * explicit override.\n   * @internal\n   */\n  private readonly _managedCurrentItems = new WeakSet<Element>();\n\n  /**\n   * Stable per-instance ID used to tag the injected script element so that\n   * multiple hx-breadcrumb instances on the same page don't produce conflicting\n   * or duplicate structured-data blocks. Each instance owns exactly one script\n   * tag identified by this ID; any stale tag from a previous render cycle is\n   * removed before a new one is inserted.\n   *\n   * Uses a static counter (not Math.random()) so IDs are deterministic across\n   * server and client renders, enabling SSR hydration matching.\n   * @internal\n   */\n  private readonly _jsonLdId = `${_nextBreadcrumbId()}-ld`;\n\n  // ─── Item Helpers ───\n\n  /**\n   * Returns only real breadcrumb items, excluding the managed ellipsis element.\n   * @internal\n   */\n  private _getBreadcrumbItems(slot: HTMLSlotElement): Element[] {\n    return slot\n      .assignedElements({ flatten: true })\n      .filter(\n        (el) =>\n          el.tagName.toLowerCase() === 'hx-breadcrumb-item' &&\n          !el.classList.contains('hx-bc-ellipsis'),\n      );\n  }\n\n  /**\n   * Applies aria/state attributes to the item list.\n   *\n   * Current-page detection: if any item has an explicit `current` attribute\n   * (e.g. set by a Drupal Twig template), that item is treated as the current\n   * page. Otherwise the last item is the current page (default behaviour).\n   *\n   * This separation allows Drupal to control current-page marking without\n   * relying on item order.\n   * @internal\n   */\n  private _applyItemAttributes(items: Element[]): void {\n    // Detect consumer-set 'current' attributes. An item has an explicit consumer\n    // current if it has the 'current' attribute AND the component did not set it\n    // (tracked via _managedCurrentItems). This prevents component-managed state\n    // from being misread as a consumer override on subsequent slotchange events.\n    const hasExplicitCurrent = items.some(\n      (el) => el.hasAttribute('current') && !this._managedCurrentItems.has(el),\n    );\n\n    items.forEach((item, i) => {\n      const el = item as HTMLElement;\n      const isLast = i === items.length - 1;\n\n      // Separator hiding: always positional — last item has no trailing separator.\n      if (isLast) {\n        el.setAttribute('data-bc-last', '');\n      } else {\n        el.removeAttribute('data-bc-last');\n      }\n\n      // Current-page marker: explicit consumer attribute wins over positional last.\n      // The item component renders aria-current=\"page\" on its inner element\n      // based on this attribute (see hx-breadcrumb-item.ts).\n      if (!hasExplicitCurrent) {\n        if (isLast) {\n          el.setAttribute('current', '');\n          this._managedCurrentItems.add(el);\n        } else {\n          el.removeAttribute('current');\n          this._managedCurrentItems.delete(el);\n        }\n      }\n      // When hasExplicitCurrent is true, leave 'current' attributes as-is so\n      // consumer or Drupal template markup is not overridden.\n    });\n  }\n\n  // ─── Slot Handling ───\n\n  /** @internal */\n  private _handleSlotChange(e: Event): void {\n    if (!(e.target instanceof HTMLSlotElement)) return;\n    const items = this._getBreadcrumbItems(e.target);\n\n    // Handle collapse behaviour\n    if (this.maxItems > 0 && items.length > this.maxItems) {\n      this._applyCollapse(items);\n    } else {\n      this._removeCollapse(items);\n    }\n\n    this._applyItemAttributes(items);\n\n    if (this.jsonLd) {\n      this._updateJsonLd(items);\n    }\n  }\n\n  /** @internal */\n  private _handleSeparatorSlotChange(e: Event): void {\n    if (!(e.target instanceof HTMLSlotElement)) return;\n    const assigned = e.target.assignedElements({ flatten: true });\n    if (assigned.length > 0) {\n      const text = (assigned[0] as HTMLElement).textContent?.trim() ?? '';\n      this.style.setProperty('--hx-breadcrumb-separator-content', JSON.stringify(text));\n    }\n  }\n\n  // ─── Collapse ───\n\n  /** @internal */\n  private _applyCollapse(items: Element[]): void {\n    // Show only first and last; hide all middle items via data attribute.\n    // The ellipsis is rendered in shadow DOM (see render()) to avoid mutating\n    // the consumer's light DOM structure (FS-014).\n    items.forEach((item, i) => {\n      const el = item as HTMLElement;\n      if (i === 0 || i === items.length - 1) {\n        el.removeAttribute('data-bc-hidden');\n      } else {\n        el.setAttribute('data-bc-hidden', '');\n      }\n    });\n\n    this._showEllipsis = true;\n  }\n\n  /** @internal */\n  private _removeCollapse(items: Element[]): void {\n    items.forEach((item) => {\n      (item as HTMLElement).removeAttribute('data-bc-hidden');\n    });\n\n    this._showEllipsis = false;\n  }\n\n  /**\n   * Expands a collapsed breadcrumb by resetting maxItems to 0.\n   * Called by the ellipsis expand button (click or Enter/Space).\n   * @internal\n   */\n  private _expandBreadcrumb(): void {\n    this.maxItems = 0;\n    // updated() will detect the maxItems change and call _removeCollapse.\n  }\n\n  // ─── JSON-LD ───\n\n  /**\n   * JSON-LD ListItem entry with typed fields to avoid Record<string, unknown>.\n   * @internal\n   */\n  private _buildListItem(item: Element, position: number): JsonLdListItem {\n    const href = (item as HTMLElement).getAttribute('href');\n    const name = (item as HTMLElement).textContent?.trim() ?? '';\n    const entry: JsonLdListItem = {\n      '@type': 'ListItem',\n      position,\n      name,\n    };\n    if (href) entry.item = href;\n    return entry;\n  }\n\n  /** @internal */\n  private _updateJsonLd(items: Element[]): void {\n    const schema = {\n      '@context': 'https://schema.org',\n      '@type': 'BreadcrumbList',\n      itemListElement: items.map((item, i) => this._buildListItem(item, i + 1)),\n    };\n\n    // Guard for SSR — document is unavailable server-side\n    if (typeof document === 'undefined') return;\n\n    if (!this._jsonLdScript) {\n      // Dedup guard: remove any stale script with this instance's ID before\n      // creating a fresh one. This handles the edge case where the element was\n      // reconnected to the DOM after being disconnected without the script\n      // reference being re-established.\n      document.getElementById(this._jsonLdId)?.remove();\n\n      this._jsonLdScript = document.createElement('script');\n      this._jsonLdScript.type = 'application/ld+json';\n      this._jsonLdScript.id = this._jsonLdId;\n      this._jsonLdScript.setAttribute('data-hx-breadcrumb', '');\n      document.head.appendChild(this._jsonLdScript);\n    }\n\n    this._jsonLdScript.textContent = JSON.stringify(schema);\n  }\n\n  /** @internal */\n  private _removeJsonLd(): void {\n    this._jsonLdScript?.remove();\n    this._jsonLdScript = null;\n  }\n\n  // ─── Lifecycle ───\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n    // Do NOT set role=\"list\" on the host. The shadow-DOM <nav><ol> provides\n    // both navigation landmark and list semantics. Setting role=\"list\" on\n    // the host conflicts with the <nav> child — axe-core flags\n    // aria-required-children because a list cannot own a navigation landmark.\n    // Slotted items no longer need role=\"listitem\" either; the native <ol>\n    // handles list semantics in the composed accessibility tree.\n  }\n\n  override disconnectedCallback(): void {\n    super.disconnectedCallback();\n    this._removeJsonLd();\n  }\n\n  override updated(changedProperties: PropertyValues<this>): void {\n    super.updated(changedProperties);\n\n    if (changedProperties.has('separator')) {\n      // JSON.stringify wraps the string in quotes so the value is valid\n      // for use in the CSS `content` property (e.g. '/' becomes '\"/\"').\n      this.style.setProperty('--hx-breadcrumb-separator-content', JSON.stringify(this.separator));\n    }\n\n    if (changedProperties.has('maxItems')) {\n      // Re-evaluate collapse state when maxItems changes programmatically\n      // (e.g. when the expand button resets maxItems to 0).\n      const slot = this.shadowRoot?.querySelector<HTMLSlotElement>('slot:not([name])');\n      if (slot) {\n        const items = this._getBreadcrumbItems(slot);\n        if (this.maxItems > 0 && items.length > this.maxItems) {\n          this._applyCollapse(items);\n        } else {\n          this._removeCollapse(items);\n        }\n        this._applyItemAttributes(items);\n      }\n    }\n\n    if (changedProperties.has('jsonLd')) {\n      if (this.jsonLd) {\n        // json-ld toggled on after initial render — inject script immediately.\n        const slot = this.shadowRoot?.querySelector<HTMLSlotElement>('slot:not([name])');\n        if (slot) {\n          this._updateJsonLd(this._getBreadcrumbItems(slot));\n        }\n      } else {\n        // json-ld toggled off — remove existing script.\n        this._removeJsonLd();\n      }\n    }\n  }\n\n  // ─── Render ───\n\n  override render() {\n    return html`\n      <nav part=\"nav\" aria-label=${this.label}>\n        <ol part=\"list\">\n          <slot @slotchange=${this._handleSlotChange}></slot>\n          ${this._showEllipsis\n            ? html`\n                <hx-breadcrumb-item class=\"hx-bc-ellipsis\">\n                  <button\n                    type=\"button\"\n                    aria-label=${this.labelEllipsis}\n                    @click=${this._expandBreadcrumb}\n                  >\n                    …\n                  </button>\n                </hx-breadcrumb-item>\n              `\n            : nothing}\n        </ol>\n      </nav>\n      <slot\n        name=\"separator\"\n        class=\"separator-slot\"\n        @slotchange=${this._handleSeparatorSlotChange}\n      ></slot>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-breadcrumb': HelixBreadcrumb;\n  }\n}\n","import { css } from 'lit';\n\nexport const helixBreadcrumbItemStyles = css`\n  :host {\n    display: inline-flex;\n    align-items: center;\n  }\n\n  /*\n   * display: contents removes [part='item'] from the box model entirely.\n   * This is intentional — the wrapper exists only for slot selection purposes.\n   * Consumers using ::part(item) CANNOT apply box-model properties (padding,\n   * margin, background, border) to this part. Use ::part(link) or ::part(text)\n   * for visual styling of breadcrumb item content.\n   */\n  [part='item'] {\n    display: contents;\n  }\n\n  [part='link'] {\n    color: var(--hx-breadcrumb-link-color, var(--hx-color-primary-600, #0f7078));\n    text-decoration: none;\n    cursor: pointer;\n    font-family: inherit;\n    font-size: inherit;\n    max-width: var(--hx-breadcrumb-item-max-width);\n    overflow: hidden;\n    text-overflow: ellipsis;\n    white-space: nowrap;\n  }\n\n  [part='link']:hover {\n    color: var(--hx-breadcrumb-link-hover-color, var(--hx-color-primary-700, #0f6363));\n    text-decoration: underline;\n  }\n\n  [part='link']:focus-visible {\n    outline: var(--hx-focus-ring-width, 2px) solid\n      var(--hx-breadcrumb-link-focus-ring-color, var(--hx-focus-ring-color, #0f7078));\n    outline-offset: var(--hx-focus-ring-offset, 2px);\n    border-radius: var(--hx-border-radius-sm, 0.25rem);\n  }\n\n  [part='text'] {\n    color: var(--hx-breadcrumb-text-color, var(--hx-color-text-strong, #202b39));\n    font-family: inherit;\n    font-size: inherit;\n    max-width: var(--hx-breadcrumb-item-max-width);\n    overflow: hidden;\n    text-overflow: ellipsis;\n    white-space: nowrap;\n  }\n\n  .separator {\n    margin-inline: var(--hx-breadcrumb-separator-gap, var(--hx-space-1, 0.25rem));\n    color: var(--hx-breadcrumb-separator-color, var(--hx-color-text-muted, #4a5362));\n    user-select: none;\n  }\n\n  .separator::before {\n    content: var(--hx-breadcrumb-separator-content, '/');\n  }\n\n  /* Normalize buttons slotted into breadcrumb items (e.g. the expand-ellipsis button). */\n  ::slotted(button) {\n    background: none;\n    border: none;\n    cursor: pointer;\n    font: inherit;\n    color: inherit;\n    padding: 0;\n  }\n\n  /* ─── Forced Colors (Windows High Contrast) ─── */\n\n  @media (forced-colors: active) {\n    [part='link'] {\n      color: LinkText;\n    }\n\n    [part='link']:hover {\n      color: LinkText;\n    }\n\n    .separator {\n      color: CanvasText;\n    }\n  }\n`;\n","import { html, nothing } from 'lit';\nimport '../../utilities/document-token-adoption.js';\nimport { customElement, property } from 'lit/decorators.js';\nimport { HelixElement } from '../../base/index.js';\nimport { forcedColorsInteractive } from '../../styles/forced-colors.js';\nimport { helixBreadcrumbItemStyles } from './hx-breadcrumb-item.styles.js';\n\n/**\n * A single breadcrumb navigation item.\n *\n * @summary A navigation item within an hx-breadcrumb component. Renders as a link when `href` is\n * provided, or as static text for the current page item. The current page item is determined by\n * the `current` attribute (set explicitly or automatically by the parent `hx-breadcrumb`).\n *\n * @tag hx-breadcrumb-item\n *\n * @slot - The link or page text content. Accepts text, HTML, or icon elements.\n *\n * @csspart item - Wrapper around the link or text content.\n * @csspart link - The anchor element when href is provided (non-current items only).\n * @csspart text - The span element for the current page or items without href.\n * @csspart separator - The separator element rendered after non-last items.\n *\n * @cssprop [--hx-breadcrumb-link-color=var(--hx-color-primary-600)] - Link text color.\n * @cssprop [--hx-breadcrumb-link-hover-color=var(--hx-color-primary-700)] - Link hover text color.\n * @cssprop [--hx-breadcrumb-text-color=var(--hx-color-neutral-700)] - Current page text color.\n * @cssprop [--hx-breadcrumb-separator-content='/'] - Separator character displayed after non-last items.\n * @cssprop [--hx-breadcrumb-separator-color=var(--hx-color-neutral-400)] - Separator color.\n * @cssprop [--hx-breadcrumb-separator-gap=var(--hx-space-1)] - Horizontal margin around separator.\n * @cssprop [--hx-breadcrumb-item-max-width] - Optional max-width for text truncation.\n * @cssprop [--hx-breadcrumb-link-focus-ring-color=var(--hx-focus-ring-color, var(--hx-color-primary-500))] - Focus ring color for breadcrumb links.\n */\n@customElement('hx-breadcrumb-item')\nexport class HelixBreadcrumbItem extends HelixElement {\n  static override styles = [helixBreadcrumbItemStyles, forcedColorsInteractive];\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n    // No explicit role needed. The shadow-DOM <ol> inside hx-breadcrumb\n    // provides native list semantics; slotted items are projected into it.\n    // Previously role=\"listitem\" was set here, but it conflicted with the\n    // host's role=\"list\" + shadow-DOM <nav> structure (aria-required-children).\n    // The native <ol> handles the accessibility tree correctly without\n    // explicit ARIA roles on host or items.\n  }\n\n  /**\n   * The URL for this breadcrumb link. Omit for the current page item.\n   * When `current` is true, this attribute is ignored and the item always\n   * renders as static text per WAI-ARIA APG breadcrumb guidance.\n   * @attr href\n   */\n  @property({ type: String, reflect: true })\n  href: string | undefined = undefined;\n\n  /**\n   * Whether this is the last item in the breadcrumb trail. Set by the parent\n   * hx-breadcrumb component via the `data-bc-last` boolean attribute. When\n   * present the trailing separator is hidden.\n   *\n   * @attr data-bc-last\n   * @internal\n   */\n  @property({ type: Boolean, attribute: 'data-bc-last', reflect: true })\n  dataBcLast = false;\n\n  /**\n   * Marks this item as the current page. When set, the item always renders as\n   * static text (never a navigable link) and `aria-current=\"page\"` is placed on\n   * the inner text element per WAI-ARIA APG breadcrumb guidance, yielding the\n   * canonical AT announcement (\"current page, Patient Records\").\n   *\n   * Can be set explicitly by consumers (e.g. Drupal Twig templates) to override\n   * the default positional last-item detection in `hx-breadcrumb`. When any item\n   * in the breadcrumb has an explicit `current` attribute, the parent will not\n   * override it.\n   *\n   * @attr current\n   */\n  @property({ type: Boolean, reflect: true })\n  current = false;\n\n  override render() {\n    // Per WAI-ARIA APG, the current page item MUST NOT be a navigable link.\n    // aria-current=\"page\" is placed on the inner element (not the listitem host)\n    // for canonical AT announcement (\"current page, Patient Records\" vs\n    // \"current page, list item\").\n    return html`\n      <span part=\"item\">\n        ${this.current\n          ? html`<span part=\"text\" aria-current=\"page\"><slot></slot></span>`\n          : this.href\n            ? html`<a part=\"link\" href=${this.href}><slot></slot></a>`\n            : html`<span part=\"text\"><slot></slot></span>`}\n      </span>\n      ${!this.dataBcLast\n        ? html`<span class=\"separator\" part=\"separator\" aria-hidden=\"true\"></span>`\n        : nothing}\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-breadcrumb-item': HelixBreadcrumbItem;\n  }\n}\n"],"names":["helixBreadcrumbStyles","css","_nextBreadcrumbId","createIdCounter","HelixBreadcrumb","HelixElement","slot","el","items","hasExplicitCurrent","item","i","isLast","e","assigned","text","_a","position","href","name","entry","schema","changedProperties","_b","html","nothing","forcedColorsInteractive","__decorateClass","property","state","customElement","helixBreadcrumbItemStyles","HelixBreadcrumbItem"],"mappings":"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"}

package/dist/shared/{hx-button-Ddl-T6T-.js → hx-button-CHlkRQTe.js}

@@ -1,10 +1,10 @@
-import { css as v, html as u, nothing as s } from "lit";
-import { property as a, customElement as p } from "lit/decorators.js";
-import { classMap as d } from "lit/directives/class-map.js";
-import { ifDefined as c } from "lit/directives/if-defined.js";
-import { d as x } from "./dev-warn-YlwPHjtX.js";
-import { m as f } from "./aria-delegation-Doq6RRUy.js";
-import { H as g } from "./helix-element-BNEYeiys.js";
+import { css as v, html as d, nothing as s } from "lit";
+import { property as a, customElement as f } from "lit/decorators.js";
+import { classMap as c } from "lit/directives/class-map.js";
+import { ifDefined as u } from "lit/directives/if-defined.js";
+import { d as p } from "./dev-warn-YlwPHjtX.js";
+import { m as g } from "./aria-delegation-Doq6RRUy.js";
+import { H as x } from "./helix-element-BNEYeiys.js";
 const m = v`
   :host {
     display: inline-block;
@@ -34,7 +34,7 @@ const m = v`
     gap: var(--hx-space-2, 0.5rem);
     border: var(--hx-border-width-thin, 1px) solid var(--hx-button-border-color, transparent);
     border-radius: var(--hx-button-border-radius, var(--hx-border-radius-md, 0.375rem));
-    background-color: var(--hx-button-bg, var(--hx-color-primary-500, #2563eb));
+    background-color: var(--hx-button-bg, var(--hx-color-primary-500, #429797));
     color: var(--hx-button-color, var(--hx-color-neutral-0, #ffffff));
     font-family: var(--hx-button-font-family, var(--hx-font-family-sans, sans-serif));
     font-weight: var(--hx-button-font-weight, var(--hx-font-weight-semibold, 600));
@@ -53,7 +53,7 @@ const m = v`
 
   .button:focus-visible {
     outline: var(--hx-focus-ring-width, 2px) solid
-      var(--hx-button-focus-ring-color, var(--hx-focus-ring-color, var(--hx-color-primary-500)));
+      var(--hx-button-focus-ring-color, var(--hx-focus-ring-color, #0f7078));
     outline-offset: var(--hx-focus-ring-offset, 2px);
   }
 
@@ -91,63 +91,108 @@ const m = v`
   /* ─── Style Variants ─── */
 
   .button--primary {
-    --hx-button-bg: var(--hx-color-primary-500);
-    --hx-button-color: var(--hx-color-neutral-0);
+    --hx-button-bg: var(--hx-color-action-primary-bg, #429797);
+    /* Inline #0d1825 matches text.on-primary's resolved primitive (neutral-900);
+       cold-start without the semantic still paints AA-tuned dark-on-primary
+       rather than white-on-primary (3.43:1 fail). */
+    --hx-button-color: var(--hx-color-text-on-primary, #0d1825);
     --hx-button-border-color: transparent;
   }
 
   .button--secondary {
     --hx-button-bg: transparent;
-    --hx-button-color: var(--hx-color-primary-500);
-    --hx-button-border-color: var(--hx-color-primary-500);
+    /* primary-500 (#429797) text on white surface = 3.44:1 — fails AA.
+       primary-600 (#0F7078) on white = 5.82:1 — AA pass. */
+    --hx-button-color: var(--hx-color-action-secondary-fg, #0f7078);
+    --hx-button-border-color: var(--hx-color-action-secondary-border, #0f7078);
   }
 
   .button--secondary:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-primary-50));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-action-secondary-bg-hover, #ebf8f8));
   }
 
   .button--tertiary {
-    --hx-button-bg: var(--hx-color-neutral-100);
-    --hx-button-color: var(--hx-color-neutral-900);
+    --hx-button-bg: var(--hx-color-surface-sunken, #ebeee9);
+    --hx-button-color: var(--hx-color-text-primary, #0d1825);
     --hx-button-border-color: transparent;
   }
 
   .button--tertiary:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-neutral-200));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-surface-raised, #f5f8f3));
   }
 
   .button--danger {
-    --hx-button-bg: var(--hx-color-error-500);
-    --hx-button-color: var(--hx-color-neutral-0);
+    --hx-button-bg: var(--hx-color-action-danger-bg, #e5493e);
+    /* Inline #0d1825 matches text.on-error's resolved primitive (neutral-900);
+       cold-start without the semantic still paints AA-tuned dark-on-error
+       rather than white-on-error (3.92:1 fail). */
+    --hx-button-color: var(--hx-color-text-on-error, #0d1825);
     --hx-button-border-color: transparent;
   }
 
+  /* on-error tokens are tuned for error-500 (neutral-900 on #E5493E ≈ 4.59:1).
+     error-600 (#C92A2A) drops that to 3.28:1 — AA fail. text.on-error-strong
+     resolves to neutral-0 across modes (no dark flip) so the darker hover fill
+     stays legible. Mirrors hx-toast precedent (commit 300e21ab0); routed
+     through the semantic tier in 3.2.1 token-cascade remediation. */
   .button--danger:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-error-600));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-action-danger-bg-hover, #c92a2a));
+    --hx-button-color: var(--hx-color-text-on-error-strong, #ffffff);
+  }
+
+  /* Pressed state binds explicitly to action.danger.bg-active (error-700,
+     #A21312) + text.on-error-strong (neutral-0) = 7.96:1 AA. Base
+     .button:active filter:brightness(0.8) would compound on top of bg-hover
+     (#C92A2A) and produce ~3.3:1 sub-AA on the bound colors. Override the
+     filter to none. HC override on action.danger.bg-active flips to HC
+     error-500 so the on-error-strong (HC = #000) pair is AA in HC too. */
+  .button--danger:active {
+    --hx-button-bg: var(--hx-button-active-bg, var(--hx-color-action-danger-bg-active, #a21312));
+    --hx-button-color: var(--hx-color-text-on-error-strong, #ffffff);
+    filter: none;
   }
 
   .button--ghost {
     --hx-button-bg: transparent;
-    --hx-button-color: var(--hx-color-primary-500);
+    /* primary-500 (#429797) text on white surface = 3.44:1 — fails AA.
+       primary-600 (#0F7078) on white = 5.82:1 — AA pass. */
+    --hx-button-color: var(--hx-color-action-ghost-fg, #0f7078);
     --hx-button-border-color: transparent;
   }
 
   .button--ghost:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-neutral-100));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-action-ghost-bg-hover, #ebf8f8));
   }
 
   .button--outline {
     --hx-button-bg: transparent;
-    --hx-button-color: var(--hx-color-neutral-900);
-    --hx-button-border-color: var(--hx-color-neutral-300);
+    --hx-button-color: var(--hx-color-text-primary, #0d1825);
+    --hx-button-border-color: var(--hx-color-border-strong, #66787b);
   }
 
   .button--outline:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-neutral-50));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-surface-raised, #f5f8f3));
   }
 
+  /* on-primary token resolves to neutral-900 (#0D1825) — tuned for primary-500.
+     primary-600 (#0F7078) drops the pair to 3.07:1 — AA fail. text.on-primary-strong
+     resolves to neutral-0 across modes (no dark flip) for the darker hover fill.
+     Mirrors hx-toast precedent (commit 300e21ab0); routed through the semantic
+     tier in 3.2.1 token-cascade remediation. */
   .button--primary:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-primary-600));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-action-primary-bg-hover, #0f7078));
+    --hx-button-color: var(--hx-color-text-on-primary-strong, #ffffff);
+  }
+
+  /* Pressed state binds explicitly to action.primary.bg-active (primary-700,
+     #0F6363) + text.on-primary-strong (neutral-0) = 7.03:1 AA. The base
+     .button:active filter:brightness(0.8) would compound on top of bg-hover
+     (#0F7078) and produce ~3.7:1 sub-AA on the bound colors. Override the
+     filter to none so the action.*.bg-active token is what actually paints. */
+  .button--primary:active {
+    --hx-button-bg: var(--hx-button-active-bg, var(--hx-color-action-primary-bg-active, #0f6363));
+    --hx-button-color: var(--hx-color-text-on-primary-strong, #ffffff);
+    filter: none;
   }
 
   /* ─── Disabled ─── */
@@ -191,9 +236,20 @@ const m = v`
 
   /* ─── Inverted Mode ─── */
 
+  /* Inline-fallback contract for the on-dark-* tokens in this section:
+     the literal rgba(255, 255, 255, 0.X) arms are a LIGHT-MODE-only last
+     resort (cold-start, CSS-not-loaded). At runtime, hx-theme injects
+     the dark.* override (overlay-black-* for the strong border and the
+     surface.on-dark-overlay-* fills) so dark-mode inverted buttons stay
+     visible on the now-light surface.inverse (#EBEEE9). The inline white
+     overlays would render invisible (≈1.1:1) on a light surface, but
+     they never paint when the theme is mounted. If a future change
+     moves these into a context where hx-theme is not guaranteed,
+     replace with mode-aware tokens. */
+
   /* Override text color and filter-based hover/active for all variants */
   :host([inverted]) .button {
-    color: var(--hx-button-inverted-color, var(--hx-color-neutral-0));
+    color: var(--hx-button-inverted-color, var(--hx-color-text-inverse, #ffffff));
     filter: none;
   }
 
@@ -206,37 +262,93 @@ const m = v`
   }
 
   :host([inverted]) .button:focus-visible {
+    /* WCAG 1.4.11: focus indicator needs ≥3:1 against adjacent colors.
+       border-on-dark-strong (overlay-white-70) ≈ 5:1 on neutral-900 — passes.
+       The lower-alpha siblings used to live in border.* but were sub-3:1
+       against any plausible surface and could not honour a border contract;
+       they're now surface.on-dark-overlay-{default,subtle} (translucent
+       fills, not borders) and used elsewhere in this file. See
+       tokens.json color.surface.on-dark-overlay-* for canonical ratios. */
     outline-color: var(
       --hx-button-inverted-focus-ring-color,
-      var(--hx-overlay-white-50, rgba(255, 255, 255, 0.5))
+      var(--hx-color-border-on-dark-strong, rgba(255, 255, 255, 0.7))
     );
   }
 
-  /* Primary inverted — slight transparent white overlay on hover */
-  :host([inverted]) .button--primary:hover {
-    --hx-button-bg: var(--hx-color-primary-400, #60a5fa);
+  /* Primary inverted — resting bg routes through action.primary.bg-inverted-rest
+     so dark mode can flip the fill to primary-600. surface.inverse becomes light
+     (#EBEEE9) in dark mode; primary-500 on #EBEEE9 = 2.94:1 (sub-3:1 UI floor
+     fail for the inverted-button boundary). primary-600 on #EBEEE9 = 4.97:1
+     (AA pass). Light mode tracks action.primary.bg (primary-500, 5.20:1 on
+     dark surface.inverse). */
+  :host([inverted]) .button--primary {
+    --hx-button-bg: var(--hx-color-action-primary-bg-inverted-rest, #429797);
+  }
+
+  /* Primary inverted — hover/pressed lift to action.primary.bg-inverted-hover
+     (primary-400, light teal). The base :host([inverted]) .button rule binds
+     color to text.inverse, which flips by mode (neutral-0 in light, neutral-900
+     in dark). On a permanent light-teal fill, white text drops to 2.4:1 in
+     light mode (AA fail). Pin color to text.on-primary (neutral-900, no
+     dark-mode flip) for both hover and active so the foreground is dark in
+     both modes — neutral-900 on primary-400 = 7.27:1 (AA pass).
+     Pressed === hover visually in inverted mode is acceptable UX (the
+     transient absence of pointer over the button signals release).
+     The fallback chain wraps --hx-button-active-bg (highest precedence) and
+     --hx-button-hover-bg so consumer overrides on either prop apply under
+     :host([inverted]) — the two share a paint here, so either knob is
+     honored, with active-bg winning when both are set. */
+  :host([inverted]) .button--primary:hover,
+  :host([inverted]) .button--primary:active {
+    --hx-button-bg: var(
+      --hx-button-active-bg,
+      var(--hx-button-hover-bg, var(--hx-color-action-primary-bg-inverted-hover, #6ab1b1))
+    );
+    color: var(
+      --hx-button-inverted-primary-interactive-color,
+      var(--hx-color-text-on-primary, #0d1825)
+    );
   }
 
-  /* Secondary inverted — white border and text */
+  /* Danger inverted — sister to primary. Hover/pressed lift to
+     action.danger.bg-inverted-hover (error-400, #FC7264). Same foreground
+     contract: text.inverse fails in light mode (white on light red ≈ 2.6:1);
+     pin to text.on-error (neutral-900, no dark-mode flip) for 6.58:1 in both
+     modes. Same active-bg → hover-bg → semantic fallback chain as primary. */
+  :host([inverted]) .button--danger:hover,
+  :host([inverted]) .button--danger:active {
+    --hx-button-bg: var(
+      --hx-button-active-bg,
+      var(--hx-button-hover-bg, var(--hx-color-action-danger-bg-inverted-hover, #fc7264))
+    );
+    color: var(
+      --hx-button-inverted-danger-interactive-color,
+      var(--hx-color-text-on-error, #0d1825)
+    );
+  }
+
+  /* Secondary inverted — white border and translucent hover fill */
   :host([inverted]) .button--secondary {
-    --hx-button-border-color: var(--hx-overlay-white-70, rgba(255, 255, 255, 0.7));
+    --hx-button-border-color: var(--hx-color-border-on-dark-strong, rgba(255, 255, 255, 0.7));
   }
 
   :host([inverted]) .button--secondary:hover {
-    --hx-button-bg: var(--hx-overlay-white-15, rgba(255, 255, 255, 0.15));
+    --hx-button-bg: var(--hx-color-surface-on-dark-overlay-default, rgba(255, 255, 255, 0.3));
   }
 
-  /* Tertiary inverted */
+  /* Tertiary inverted — resting at the subtle overlay (10%) lifts to the default
+     overlay (30%) on hover so the runtime hover delta is visually distinct, not
+     collapsed onto a single token. */
   :host([inverted]) .button--tertiary {
-    --hx-button-bg: var(--hx-overlay-white-15, rgba(255, 255, 255, 0.15));
+    --hx-button-bg: var(--hx-color-surface-on-dark-overlay-subtle, rgba(255, 255, 255, 0.1));
     --hx-button-border-color: transparent;
   }
 
   :host([inverted]) .button--tertiary:hover {
-    --hx-button-bg: var(--hx-overlay-white-25, rgba(255, 255, 255, 0.25));
+    --hx-button-bg: var(--hx-color-surface-on-dark-overlay-default, rgba(255, 255, 255, 0.3));
   }
 
-  /* Ghost inverted — transparent base, white hover bg */
+  /* Ghost inverted — transparent base, translucent hover bg */
   :host([inverted]) .button--ghost {
     --hx-button-bg: transparent;
     --hx-button-border-color: transparent;
@@ -245,17 +357,17 @@ const m = v`
   :host([inverted]) .button--ghost:hover {
     --hx-button-bg: var(
       --hx-button-inverted-ghost-hover-bg,
-      var(--hx-overlay-white-20, rgba(255, 255, 255, 0.2))
+      var(--hx-color-surface-on-dark-overlay-default, rgba(255, 255, 255, 0.3))
     );
   }
 
   /* Outline inverted — white border */
   :host([inverted]) .button--outline {
-    --hx-button-border-color: var(--hx-overlay-white-70, rgba(255, 255, 255, 0.7));
+    --hx-button-border-color: var(--hx-color-border-on-dark-strong, rgba(255, 255, 255, 0.7));
   }
 
   :host([inverted]) .button--outline:hover {
-    --hx-button-bg: var(--hx-overlay-white-15, rgba(255, 255, 255, 0.15));
+    --hx-button-bg: var(--hx-color-surface-on-dark-overlay-default, rgba(255, 255, 255, 0.3));
   }
 
   /* ─── Prefix / Suffix / Label ─── */
@@ -283,6 +395,16 @@ const m = v`
       border: 2px solid ButtonText;
     }
 
+    .button:hover {
+      /* Hover affordance must survive in HC. Highlight/HighlightText is the
+         OS-level "selected" pair, mirroring the forcedColorsInteractive mixin's
+         hover contract — kept inline since this component owns its bespoke HC
+         block (XOR rule). */
+      background-color: Highlight;
+      color: HighlightText;
+      border-color: Highlight;
+    }
+
     .button:focus-visible {
       outline: 3px solid Highlight;
       outline-offset: 2px;
@@ -305,12 +427,12 @@ const m = v`
     }
   }
 `;
-var y = Object.defineProperty, _ = Object.getOwnPropertyDescriptor, n = (t, r, h, i) => {
-  for (var o = i > 1 ? void 0 : i ? _(r, h) : r, l = t.length - 1, b; l >= 0; l--)
-    (b = t[l]) && (o = (i ? b(r, h, o) : b(o)) || o);
-  return i && o && y(r, h, o), o;
+var y = Object.defineProperty, k = Object.getOwnPropertyDescriptor, n = (t, r, l, i) => {
+  for (var o = i > 1 ? void 0 : i ? k(r, l) : r, h = t.length - 1, b; h >= 0; h--)
+    (b = t[h]) && (o = (i ? b(r, l, o) : b(o)) || o);
+  return i && o && y(r, l, o), o;
 };
-let e = class extends f(g) {
+let e = class extends g(x) {
   constructor() {
     super(...arguments), this.variant = "primary", this.size = "md", this.disabled = !1, this.loading = !1, this.type = "button", this.href = void 0, this.target = void 0, this.name = void 0, this.value = void 0, this.full = !1, this.inverted = !1, this.accessibleLabel = "", this._emptySlotWarnEmitted = !1;
   }
@@ -333,15 +455,15 @@ let e = class extends f(g) {
     const r = (i = this.shadowRoot) == null ? void 0 : i.querySelector("slot:not([name])");
     !((r == null ? void 0 : r.assignedNodes({ flatten: !0 })) ?? []).some(
       (o) => {
-        var l;
-        return o.nodeType !== Node.TEXT_NODE || (((l = o.textContent) == null ? void 0 : l.trim().length) ?? 0) > 0;
+        var h;
+        return o.nodeType !== Node.TEXT_NODE || (((h = o.textContent) == null ? void 0 : h.trim().length) ?? 0) > 0;
       }
     ) && !this._effectiveLabel && (this._emptySlotWarnEmitted = !0);
   }
   updated(t) {
     if (super.updated(t), t.has("variant")) {
       const r = [...e._VALID_VARIANTS];
-      r.includes(this.variant) || (x(
+      r.includes(this.variant) || (p(
         "hx-button",
         `Invalid variant "${this.variant}". Expected one of: ${r.join(", ")}. Clamping to "primary".`
       ), this.variant = "primary");
@@ -350,11 +472,11 @@ let e = class extends f(g) {
   // ─── Slot Handlers ───
   /** @internal */
   _handleDefaultSlotChange(t) {
-    const h = t.target.assignedNodes({ flatten: !0 }).some((i) => {
+    const l = t.target.assignedNodes({ flatten: !0 }).some((i) => {
       var o;
       return i.nodeType !== Node.TEXT_NODE || (((o = i.textContent) == null ? void 0 : o.trim().length) ?? 0) > 0;
     });
-    !h && !this._effectiveLabel && this._emptySlotWarnEmitted, h && (this._emptySlotWarnEmitted = !1);
+    !l && !this._effectiveLabel && this._emptySlotWarnEmitted, l && (this._emptySlotWarnEmitted = !1);
   }
   // ─── Event Handling ───
   /**
@@ -380,7 +502,7 @@ let e = class extends f(g) {
    * @internal
    */
   _renderSpinner() {
-    return u`
+    return d`
       <svg
         class="button__spinner"
         part="spinner"
@@ -412,7 +534,7 @@ let e = class extends f(g) {
    * @internal
    */
   _renderInner() {
-    return u`
+    return d`
       ${this.loading ? this._renderSpinner() : s}
       <span part="prefix" class="button__prefix">
         <slot name="prefix"></slot>
@@ -433,12 +555,12 @@ let e = class extends f(g) {
       [`button--${this.size}`]: !0,
       "button--loading": this.loading
     };
-    return this.href !== void 0 ? u`
+    return this.href !== void 0 ? d`
         <a
           part="button"
-          class=${d(t)}
-          href=${this.disabled || this.loading ? s : c(this.href)}
-          target=${c(this.target)}
+          class=${c(t)}
+          href=${this.disabled || this.loading ? s : u(this.href)}
+          target=${u(this.target)}
           rel=${this.target === "_blank" ? "noopener noreferrer" : s}
           aria-label=${this._effectiveLabel || s}
           aria-disabled=${this.disabled ? "true" : s}
@@ -448,10 +570,10 @@ let e = class extends f(g) {
         >
           ${this._renderInner()}
         </a>
-      ` : u`
+      ` : d`
       <button
         part="button"
-        class=${d(t)}
+        class=${c(t)}
         ?disabled=${this.disabled}
         type=${this.type}
         aria-label=${this._effectiveLabel || s}
@@ -510,9 +632,9 @@ n([
   a({ type: String, attribute: "accessible-label" })
 ], e.prototype, "accessibleLabel", 2);
 e = n([
-  p("hx-button")
+  f("hx-button")
 ], e);
 export {
   e as H
 };
-//# sourceMappingURL=hx-button-Ddl-T6T-.js.map
+//# sourceMappingURL=hx-button-CHlkRQTe.js.map