@helixui/library 2.1.2 → 3.0.0-next.65

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

@@ -1,11 +1,11 @@
-import { css as c, html as l, nothing as n, LitElement as p } from "lit";
-import "./document-token-adoption-DuYNKd4k.js";
-import { property as o, customElement as x } from "lit/decorators.js";
+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 v } from "lit/directives/if-defined.js";
-import { d as f } from "./dev-warn-YlwPHjtX.js";
-import { m as g } from "./aria-delegation-CBP9eQ0M.js";
-const m = c`
+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";
+const m = v`
   :host {
     display: inline-block;
   }
@@ -67,10 +67,13 @@ const m = c`
 
   /* ─── Size Variants ─── */
 
+  /* WCAG 2.5.5 (healthcare mandate): minimum 44px touch target for sm variant.
+     min-height uses --hx-touch-target-min to guarantee the interactive area
+     meets the threshold even though the visual size token is smaller. */
   .button--sm {
     padding: var(--hx-space-1, 0.25rem) var(--hx-space-3, 0.75rem);
     font-size: var(--hx-font-size-sm, 0.875rem);
-    min-height: var(--hx-size-8, 2rem);
+    min-height: var(--hx-touch-target-min, 2.75rem);
   }
 
   .button--md {
@@ -144,7 +147,7 @@ const m = c`
   }
 
   .button--primary:hover {
-    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-primary-500));
+    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-primary-600));
   }
 
   /* ─── Disabled ─── */
@@ -211,7 +214,7 @@ const m = c`
 
   /* Primary inverted — slight transparent white overlay on hover */
   :host([inverted]) .button--primary:hover {
-    --hx-button-bg: var(--hx-color-primary-400, #3b82f6);
+    --hx-button-bg: var(--hx-color-primary-400, #60a5fa);
   }
 
   /* Secondary inverted — white border and text */
@@ -302,53 +305,72 @@ const m = c`
     }
   }
 `;
-var y = Object.defineProperty, _ = Object.getOwnPropertyDescriptor, e = (r, a, s, h) => {
-  for (var i = h > 1 ? void 0 : h ? _(a, s) : a, u = r.length - 1, b; u >= 0; u--)
-    (b = r[u]) && (i = (h ? b(a, s, i) : b(i)) || i);
-  return h && i && y(a, s, i), i;
+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;
 };
-let t = class extends g(p) {
+let e = class extends f(g) {
   constructor() {
-    super(), 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._internals = this.attachInternals();
+    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;
   }
-  // ─── Form API ───
-  /** Returns the associated form element, if any. */
-  get form() {
-    return this._internals.form;
-  }
-  /** @internal */
-  formDisabledCallback(r) {
-    this.disabled = r;
+  /**
+   * Returns the effective label for the button, checking accessible-label first,
+   * then the aria-label attribute, falling back to empty string.
+   * @internal
+   */
+  get _effectiveLabel() {
+    var t, r;
+    return ((t = this.accessibleLabel) == null ? void 0 : t.trim()) || ((r = this.ariaLabel) == null ? void 0 : r.trim()) || "";
   }
-  updated(r) {
-    if (super.updated(r), r.has("variant")) {
-      const a = [...t._VALID_VARIANTS];
-      a.includes(this.variant) || (f(
+  // ─── Form API ───
+  _onFormDisabled(t) {
+    this.disabled = t;
+  }
+  firstUpdated(t) {
+    var i;
+    super.firstUpdated(t);
+    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;
+      }
+    ) && !this._effectiveLabel && (this._emptySlotWarnEmitted = !0);
+  }
+  updated(t) {
+    if (super.updated(t), t.has("variant")) {
+      const r = [...e._VALID_VARIANTS];
+      r.includes(this.variant) || (x(
         "hx-button",
-        `Invalid variant "${this.variant}". Expected one of: ${a.join(", ")}. Clamping to "primary".`
+        `Invalid variant "${this.variant}". Expected one of: ${r.join(", ")}. Clamping to "primary".`
       ), this.variant = "primary");
     }
   }
   // ─── Slot Handlers ───
   /** @internal */
-  _handleDefaultSlotChange(r) {
-    !(r.target.assignedNodes({ flatten: !0 }).length > 0) && this.ariaLabel;
+  _handleDefaultSlotChange(t) {
+    const h = 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);
   }
   // ─── Event Handling ───
   /**
    * @private
    * @internal
    */
-  _handleClick(r) {
+  _handleClick(t) {
     if (this.disabled || this.loading) {
-      r.preventDefault(), r.stopPropagation();
+      t.preventDefault(), t.stopPropagation();
       return;
     }
     this.dispatchEvent(
       new CustomEvent("hx-click", {
         bubbles: !0,
         composed: !0,
-        detail: { originalEvent: r }
+        detail: { originalEvent: t }
       })
     ), this.href === void 0 && this.type === "submit" && this._internals.form ? (this.name !== void 0 && this.value !== void 0 && this._internals.setFormValue(this.value), this._internals.form.requestSubmit()) : this.href === void 0 && this.type === "reset" && this._internals.form && this._internals.form.reset();
   }
@@ -358,7 +380,7 @@ let t = class extends g(p) {
    * @internal
    */
   _renderSpinner() {
-    return l`
+    return u`
       <svg
         class="button__spinner"
         part="spinner"
@@ -390,8 +412,8 @@ let t = class extends g(p) {
    * @internal
    */
   _renderInner() {
-    return l`
-      ${this.loading ? this._renderSpinner() : n}
+    return u`
+      ${this.loading ? this._renderSpinner() : s}
       <span part="prefix" class="button__prefix">
         <slot name="prefix"></slot>
       </span>
@@ -405,35 +427,35 @@ let t = class extends g(p) {
   }
   // ─── Render ───
   render() {
-    const r = {
+    const t = {
       button: !0,
       [`button--${this.variant}`]: !0,
       [`button--${this.size}`]: !0,
       "button--loading": this.loading
     };
-    return this.href !== void 0 ? l`
+    return this.href !== void 0 ? u`
         <a
           part="button"
-          class=${d(r)}
-          href=${this.disabled || this.loading ? n : v(this.href)}
-          target=${v(this.target)}
-          rel=${this.target === "_blank" ? "noopener noreferrer" : n}
-          aria-label=${this.ariaLabel ?? n}
-          aria-disabled=${this.disabled ? "true" : n}
-          aria-busy=${this.loading ? "true" : n}
-          tabindex=${this.disabled ? "-1" : n}
+          class=${d(t)}
+          href=${this.disabled || this.loading ? s : c(this.href)}
+          target=${c(this.target)}
+          rel=${this.target === "_blank" ? "noopener noreferrer" : s}
+          aria-label=${this._effectiveLabel || s}
+          aria-disabled=${this.disabled ? "true" : s}
+          aria-busy=${this.loading ? "true" : s}
+          tabindex=${this.disabled ? "-1" : s}
           @click=${this._handleClick}
         >
           ${this._renderInner()}
         </a>
-      ` : l`
+      ` : u`
       <button
         part="button"
-        class=${d(r)}
+        class=${d(t)}
         ?disabled=${this.disabled}
         type=${this.type}
-        aria-label=${this.ariaLabel ?? n}
-        aria-busy=${this.loading ? "true" : n}
+        aria-label=${this._effectiveLabel || s}
+        aria-busy=${this.loading ? "true" : s}
         @click=${this._handleClick}
       >
         ${this._renderInner()}
@@ -441,9 +463,9 @@ let t = class extends g(p) {
     `;
   }
 };
-t.styles = [m];
-t.formAssociated = !0;
-t._VALID_VARIANTS = [
+e.styles = [m];
+e.formAssociated = !0;
+e._VALID_VARIANTS = [
   "primary",
   "secondary",
   "tertiary",
@@ -451,43 +473,46 @@ t._VALID_VARIANTS = [
   "ghost",
   "outline"
 ];
-e([
-  o({ type: String, reflect: !0 })
-], t.prototype, "variant", 2);
-e([
-  o({ type: String, reflect: !0, attribute: "hx-size" })
-], t.prototype, "size", 2);
-e([
-  o({ type: Boolean, reflect: !0 })
-], t.prototype, "disabled", 2);
-e([
-  o({ type: Boolean, reflect: !0 })
-], t.prototype, "loading", 2);
-e([
-  o({ type: String })
-], t.prototype, "type", 2);
-e([
-  o({ type: String })
-], t.prototype, "href", 2);
-e([
-  o({ type: String })
-], t.prototype, "target", 2);
-e([
-  o({ type: String })
-], t.prototype, "name", 2);
-e([
-  o({ type: String })
-], t.prototype, "value", 2);
-e([
-  o({ type: Boolean, reflect: !0 })
-], t.prototype, "full", 2);
-e([
-  o({ type: Boolean, reflect: !0 })
-], t.prototype, "inverted", 2);
-t = e([
-  x("hx-button")
-], t);
+n([
+  a({ type: String, reflect: !0 })
+], e.prototype, "variant", 2);
+n([
+  a({ type: String, reflect: !0, attribute: "hx-size" })
+], e.prototype, "size", 2);
+n([
+  a({ type: Boolean, reflect: !0 })
+], e.prototype, "disabled", 2);
+n([
+  a({ type: Boolean, reflect: !0 })
+], e.prototype, "loading", 2);
+n([
+  a({ type: String })
+], e.prototype, "type", 2);
+n([
+  a({ type: String })
+], e.prototype, "href", 2);
+n([
+  a({ type: String })
+], e.prototype, "target", 2);
+n([
+  a({ type: String })
+], e.prototype, "name", 2);
+n([
+  a({ type: String })
+], e.prototype, "value", 2);
+n([
+  a({ type: Boolean, reflect: !0 })
+], e.prototype, "full", 2);
+n([
+  a({ type: Boolean, reflect: !0 })
+], e.prototype, "inverted", 2);
+n([
+  a({ type: String, attribute: "accessible-label" })
+], e.prototype, "accessibleLabel", 2);
+e = n([
+  p("hx-button")
+], e);
 export {
-  t as H
+  e as H
 };
-//# sourceMappingURL=hx-button-DoN8jjQT.js.map
+//# sourceMappingURL=hx-button-Ddl-T6T-.js.map

package/dist/shared/hx-button-Ddl-T6T-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-button-Ddl-T6T-.js","sources":["../../src/components/hx-button/hx-button.styles.ts","../../src/components/hx-button/hx-button.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixButtonStyles = css`\n  :host {\n    display: inline-block;\n  }\n\n  :host([disabled]) {\n    pointer-events: none;\n    opacity: var(--hx-opacity-disabled, 0.5);\n  }\n\n  :host([full]) {\n    display: block;\n    width: 100%;\n  }\n\n  :host([full]) .button {\n    width: 100%;\n    justify-content: center;\n  }\n\n  /* ─── Base Button ─── */\n\n  .button {\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    gap: var(--hx-space-2, 0.5rem);\n    border: var(--hx-border-width-thin, 1px) solid var(--hx-button-border-color, transparent);\n    border-radius: var(--hx-button-border-radius, var(--hx-border-radius-md, 0.375rem));\n    background-color: var(--hx-button-bg, var(--hx-color-primary-500, #2563eb));\n    color: var(--hx-button-color, var(--hx-color-neutral-0, #ffffff));\n    font-family: var(--hx-button-font-family, var(--hx-font-family-sans, sans-serif));\n    font-weight: var(--hx-button-font-weight, var(--hx-font-weight-semibold, 600));\n    line-height: var(--hx-line-height-tight, 1.25);\n    cursor: pointer;\n    transition:\n      background-color var(--hx-transition-fast, 150ms ease),\n      color var(--hx-transition-fast, 150ms ease),\n      border-color var(--hx-transition-fast, 150ms ease),\n      box-shadow var(--hx-transition-fast, 150ms ease);\n    text-decoration: none;\n    white-space: nowrap;\n    user-select: none;\n    -webkit-user-select: none;\n  }\n\n  .button:focus-visible {\n    outline: var(--hx-focus-ring-width, 2px) solid\n      var(--hx-button-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  .button:hover {\n    filter: brightness(var(--hx-filter-brightness-hover, 0.9));\n  }\n\n  .button:active {\n    filter: brightness(var(--hx-filter-brightness-active, 0.8));\n  }\n\n  /* ─── Size Variants ─── */\n\n  /* WCAG 2.5.5 (healthcare mandate): minimum 44px touch target for sm variant.\n     min-height uses --hx-touch-target-min to guarantee the interactive area\n     meets the threshold even though the visual size token is smaller. */\n  .button--sm {\n    padding: var(--hx-space-1, 0.25rem) var(--hx-space-3, 0.75rem);\n    font-size: var(--hx-font-size-sm, 0.875rem);\n    min-height: var(--hx-touch-target-min, 2.75rem);\n  }\n\n  .button--md {\n    padding: var(--hx-space-2, 0.5rem) var(--hx-space-4, 1rem);\n    font-size: var(--hx-font-size-md, 1rem);\n    min-height: var(--hx-size-10, 2.5rem);\n  }\n\n  .button--lg {\n    padding: var(--hx-space-3, 0.75rem) var(--hx-space-6, 1.5rem);\n    font-size: var(--hx-font-size-lg, 1.125rem);\n    min-height: var(--hx-size-12, 3rem);\n  }\n\n  /* ─── Style Variants ─── */\n\n  .button--primary {\n    --hx-button-bg: var(--hx-color-primary-500);\n    --hx-button-color: var(--hx-color-neutral-0);\n    --hx-button-border-color: transparent;\n  }\n\n  .button--secondary {\n    --hx-button-bg: transparent;\n    --hx-button-color: var(--hx-color-primary-500);\n    --hx-button-border-color: var(--hx-color-primary-500);\n  }\n\n  .button--secondary:hover {\n    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-primary-50));\n  }\n\n  .button--tertiary {\n    --hx-button-bg: var(--hx-color-neutral-100);\n    --hx-button-color: var(--hx-color-neutral-900);\n    --hx-button-border-color: transparent;\n  }\n\n  .button--tertiary:hover {\n    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-neutral-200));\n  }\n\n  .button--danger {\n    --hx-button-bg: var(--hx-color-error-500);\n    --hx-button-color: var(--hx-color-neutral-0);\n    --hx-button-border-color: transparent;\n  }\n\n  .button--danger:hover {\n    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-error-600));\n  }\n\n  .button--ghost {\n    --hx-button-bg: transparent;\n    --hx-button-color: var(--hx-color-primary-500);\n    --hx-button-border-color: transparent;\n  }\n\n  .button--ghost:hover {\n    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-neutral-100));\n  }\n\n  .button--outline {\n    --hx-button-bg: transparent;\n    --hx-button-color: var(--hx-color-neutral-900);\n    --hx-button-border-color: var(--hx-color-neutral-300);\n  }\n\n  .button--outline:hover {\n    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-neutral-50));\n  }\n\n  .button--primary:hover {\n    --hx-button-bg: var(--hx-button-hover-bg, var(--hx-color-primary-600));\n  }\n\n  /* ─── Disabled ─── */\n\n  /* Note: opacity is applied on :host([disabled]) above — do NOT add opacity here.\n     Stacking opacity on both :host and .button[disabled] would multiply to 0.25. */\n  .button[disabled] {\n    cursor: not-allowed;\n  }\n\n  /* ─── Loading State ─── */\n\n  .button--loading {\n    position: relative;\n    cursor: wait;\n  }\n\n  .button__spinner {\n    width: 1em;\n    height: 1em;\n    flex-shrink: 0;\n    animation: hx-spin var(--hx-duration-spinner, 750ms) linear infinite;\n  }\n\n  @keyframes hx-spin {\n    to {\n      transform: rotate(360deg);\n    }\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    .button {\n      transition: none;\n    }\n\n    .button__spinner {\n      animation: none;\n      opacity: var(--hx-opacity-muted, 0.6);\n    }\n  }\n\n  /* ─── Inverted Mode ─── */\n\n  /* Override text color and filter-based hover/active for all variants */\n  :host([inverted]) .button {\n    color: var(--hx-button-inverted-color, var(--hx-color-neutral-0));\n    filter: none;\n  }\n\n  :host([inverted]) .button:hover {\n    filter: none;\n  }\n\n  :host([inverted]) .button:active {\n    filter: none;\n  }\n\n  :host([inverted]) .button:focus-visible {\n    outline-color: var(\n      --hx-button-inverted-focus-ring-color,\n      var(--hx-overlay-white-50, rgba(255, 255, 255, 0.5))\n    );\n  }\n\n  /* Primary inverted — slight transparent white overlay on hover */\n  :host([inverted]) .button--primary:hover {\n    --hx-button-bg: var(--hx-color-primary-400, #60a5fa);\n  }\n\n  /* Secondary inverted — white border and text */\n  :host([inverted]) .button--secondary {\n    --hx-button-border-color: var(--hx-overlay-white-70, rgba(255, 255, 255, 0.7));\n  }\n\n  :host([inverted]) .button--secondary:hover {\n    --hx-button-bg: var(--hx-overlay-white-15, rgba(255, 255, 255, 0.15));\n  }\n\n  /* Tertiary inverted */\n  :host([inverted]) .button--tertiary {\n    --hx-button-bg: var(--hx-overlay-white-15, rgba(255, 255, 255, 0.15));\n    --hx-button-border-color: transparent;\n  }\n\n  :host([inverted]) .button--tertiary:hover {\n    --hx-button-bg: var(--hx-overlay-white-25, rgba(255, 255, 255, 0.25));\n  }\n\n  /* Ghost inverted — transparent base, white hover bg */\n  :host([inverted]) .button--ghost {\n    --hx-button-bg: transparent;\n    --hx-button-border-color: transparent;\n  }\n\n  :host([inverted]) .button--ghost:hover {\n    --hx-button-bg: var(\n      --hx-button-inverted-ghost-hover-bg,\n      var(--hx-overlay-white-20, rgba(255, 255, 255, 0.2))\n    );\n  }\n\n  /* Outline inverted — white border */\n  :host([inverted]) .button--outline {\n    --hx-button-border-color: var(--hx-overlay-white-70, rgba(255, 255, 255, 0.7));\n  }\n\n  :host([inverted]) .button--outline:hover {\n    --hx-button-bg: var(--hx-overlay-white-15, rgba(255, 255, 255, 0.15));\n  }\n\n  /* ─── Prefix / Suffix / Label ─── */\n\n  .button__prefix,\n  .button__suffix {\n    display: inline-flex;\n    align-items: center;\n    flex-shrink: 0;\n  }\n\n  .button__label {\n    flex: 1 1 auto;\n  }\n\n  /* ─── High Contrast Mode (forced-colors) ─── */\n\n  @media (forced-colors: active) {\n    .button {\n      /* Ensure button outline is visible in Windows High Contrast mode.\n         ButtonText/ButtonFace are system colors recognized by the browser. */\n      forced-color-adjust: none;\n      background-color: ButtonFace;\n      color: ButtonText;\n      border: 2px solid ButtonText;\n    }\n\n    .button:focus-visible {\n      outline: 3px solid Highlight;\n      outline-offset: 2px;\n    }\n\n    .button[disabled] {\n      background-color: ButtonFace;\n      color: GrayText;\n      border-color: GrayText;\n      opacity: 1;\n    }\n\n    :host([disabled]) {\n      opacity: 1;\n    }\n\n    .button--loading .button__spinner {\n      /* Ensure spinner is visible in HCM */\n      forced-color-adjust: auto;\n    }\n  }\n`;\n","import { html, nothing, type TemplateResult, type PropertyValues } from 'lit';\nimport '../../utilities/document-token-adoption.js';\nimport { customElement, property } from 'lit/decorators.js';\nimport { classMap } from 'lit/directives/class-map.js';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { HelixElement } from '../../base/index.js';\nimport { mixinDelegatesAria } from '../../mixins/index.js';\nimport { helixButtonStyles } from './hx-button.styles.js';\nimport { devWarn } from '../../utils/dev-warn.js';\n\n/** Detail for the hx-click event dispatched by hx-button. */\nexport interface HxButtonClickDetail {\n  originalEvent: MouseEvent;\n}\n\n/**\n * A production-grade button component for user interaction. Supports multiple\n * visual variants, sizes, loading state, prefix/suffix slots, anchor rendering,\n * and full ElementInternals form association.\n *\n * @summary Primary interactive element for triggering actions and form submission.\n *\n * @tag hx-button\n *\n * @slot - Default slot for button label text or content.\n * @slot prefix - Icon or content rendered before the label.\n * @slot suffix - Icon or content rendered after the label.\n *\n * @fires {CustomEvent<{originalEvent: MouseEvent}>} hx-click - Dispatched when\n *   the button is clicked and is neither disabled nor loading.\n *\n * @csspart button - The native button or anchor element.\n * @csspart label - The label text wrapper span.\n * @csspart prefix - The prefix slot container span.\n * @csspart suffix - The suffix slot container span.\n * @csspart spinner - The loading spinner SVG element.\n *\n * @cssprop [--hx-button-bg=var(--hx-color-primary-500)] - Button background color.\n * @cssprop [--hx-button-hover-bg] - Hover background color override. When set, overrides the variant default hover background from outside the shadow DOM.\n * @cssprop [--hx-button-color=var(--hx-color-neutral-0)] - Button text color.\n * @cssprop [--hx-button-border-color=transparent] - Button border color.\n * @cssprop [--hx-button-border-radius=var(--hx-border-radius-md)] - Button border radius.\n * @cssprop [--hx-button-font-family=var(--hx-font-family-sans)] - Button font family.\n * @cssprop [--hx-button-font-weight=var(--hx-font-weight-semibold)] - Button font weight.\n * @cssprop [--hx-button-focus-ring-color=var(--hx-focus-ring-color)] - Focus ring color.\n *\n * @cssprop [--hx-button-inverted-color=#ffffff] - Text color when inverted.\n * @cssprop [--hx-button-inverted-ghost-hover-bg=rgba(255,255,255,0.15)] - Ghost hover bg when inverted.\n * @cssprop [--hx-button-inverted-focus-ring-color=rgba(255,255,255,0.5)] - Focus ring color when inverted.\n */\n@customElement('hx-button')\nexport class HelixButton extends mixinDelegatesAria(HelixElement) {\n  static override styles = [helixButtonStyles];\n\n  // ─── Form Association ───\n\n  /** @internal */\n  static override formAssociated = true;\n\n  // ─── Public Properties ───\n\n  /**\n   * Visual style variant of the button.\n   * @attr variant\n   */\n  @property({ type: String, reflect: true })\n  variant: 'primary' | 'secondary' | 'tertiary' | 'danger' | 'ghost' | 'outline' = 'primary';\n\n  /**\n   * Size of the button.\n   * @attr hx-size\n   */\n  @property({ type: String, reflect: true, attribute: 'hx-size' })\n  size: 'sm' | 'md' | 'lg' = 'md';\n\n  /**\n   * Whether the button is disabled. Prevents all interaction and form actions.\n   * @attr disabled\n   */\n  @property({ type: Boolean, reflect: true })\n  disabled = false;\n\n  /**\n   * Whether the button is in a loading state. Shows spinner, prevents interaction,\n   * and sets aria-busy. Does not set the disabled attribute.\n   * @attr loading\n   */\n  @property({ type: Boolean, reflect: true })\n  loading = false;\n\n  /**\n   * The type attribute for the underlying button element. Ignored when href is set.\n   * @attr type\n   */\n  @property({ type: String })\n  type: 'button' | 'submit' | 'reset' = 'button';\n\n  /**\n   * When set, renders an anchor element instead of a button.\n   * @attr href\n   */\n  @property({ type: String })\n  href: string | undefined = undefined;\n\n  /**\n   * Anchor target attribute. Only used when href is set.\n   * @attr target\n   */\n  @property({ type: String })\n  target: string | undefined = undefined;\n\n  /**\n   * Form field name submitted via ElementInternals.setFormValue on submit.\n   * @attr name\n   */\n  @property({ type: String })\n  name: string | undefined = undefined;\n\n  /**\n   * Form field value submitted via ElementInternals.setFormValue on submit.\n   * @attr value\n   */\n  @property({ type: String })\n  value: string | undefined = undefined;\n\n  /**\n   * When true, the button stretches to fill its container width.\n   * Sets the host to `display: block` and the inner element to `width: 100%`.\n   * @attr full\n   */\n  @property({ type: Boolean, reflect: true })\n  full = false;\n\n  /**\n   * When true, flips button colors for placement on dark or gradient backgrounds.\n   * Forces text to white and adjusts hover/focus ring colors across all variants.\n   * @attr inverted\n   */\n  @property({ type: Boolean, reflect: true })\n  inverted = false;\n\n  /**\n   * Accessible label for icon-only or text-less buttons.\n   * Required when the button has no visible text content.\n   *\n   * Accepts both `accessible-label` and the standard `aria-label` HTML attribute.\n   * `accessible-label` takes precedence when both are set.\n   *\n   * @attr accessible-label\n   */\n  @property({ type: String, attribute: 'accessible-label' })\n  accessibleLabel: string = '';\n\n  /**\n   * Returns the effective label for the button, checking accessible-label first,\n   * then the aria-label attribute, falling back to empty string.\n   * @internal\n   */\n  private get _effectiveLabel(): string {\n    return this.accessibleLabel?.trim() || this.ariaLabel?.trim() || '';\n  }\n\n  // ─── Form API ───\n\n  protected override _onFormDisabled(disabled: boolean): void {\n    this.disabled = disabled;\n  }\n\n  // ─── Lifecycle ───\n\n  /** @internal */\n  private static readonly _VALID_VARIANTS = [\n    'primary',\n    'secondary',\n    'tertiary',\n    'danger',\n    'ghost',\n    'outline',\n  ] as const;\n\n  // Prevents double-warn on browsers that fire slotchange for empty initial slots.\n  private _emptySlotWarnEmitted = false;\n\n  override firstUpdated(changedProperties: PropertyValues<this>): void {\n    super.firstUpdated(changedProperties);\n    const slot = this.shadowRoot?.querySelector<HTMLSlotElement>('slot:not([name])');\n    const hasContent = (slot?.assignedNodes({ flatten: true }) ?? []).some(\n      (n) => n.nodeType !== Node.TEXT_NODE || (n.textContent?.trim().length ?? 0) > 0,\n    );\n    if (!hasContent && !this._effectiveLabel) {\n      this._emptySlotWarnEmitted = true;\n      devWarn(\n        'hx-button',\n        'hx-button has no slot content and no accessible-label — button will have no accessible name.',\n      );\n    }\n  }\n\n  override updated(changedProperties: PropertyValues<this>): void {\n    super.updated(changedProperties);\n    if (changedProperties.has('variant')) {\n      const validVariants: string[] = [...HelixButton._VALID_VARIANTS];\n      if (!validVariants.includes(this.variant)) {\n        devWarn(\n          'hx-button',\n          `Invalid variant \"${this.variant}\". Expected one of: ${validVariants.join(', ')}. Clamping to \"primary\".`,\n        );\n        this.variant = 'primary';\n      }\n    }\n  }\n\n  // ─── Slot Handlers ───\n\n  /** @internal */\n  private _handleDefaultSlotChange(e: Event): void {\n    const slot = e.target as HTMLSlotElement;\n    const hasContent = slot\n      .assignedNodes({ flatten: true })\n      .some((n) => n.nodeType !== Node.TEXT_NODE || (n.textContent?.trim().length ?? 0) > 0);\n    if (!hasContent && !this._effectiveLabel && !this._emptySlotWarnEmitted) {\n      devWarn(\n        'hx-button',\n        'hx-button has no slot content and no accessible-label — button will have no accessible name.',\n      );\n    }\n    // Only reset once content arrives so the guard stays armed for browsers\n    // that fire a second slotchange for the same empty initial slot.\n    if (hasContent) {\n      this._emptySlotWarnEmitted = false;\n    }\n  }\n\n  // ─── Event Handling ───\n\n  /**\n   * @private\n   * @internal\n   */\n  private _handleClick(e: MouseEvent): void {\n    if (this.disabled || this.loading) {\n      e.preventDefault();\n      e.stopPropagation();\n      return;\n    }\n\n    /**\n     * Dispatched when the button is clicked.\n     * @event hx-click\n     */\n    this.dispatchEvent(\n      new CustomEvent<{ originalEvent: MouseEvent }>('hx-click', {\n        bubbles: true,\n        composed: true,\n        detail: { originalEvent: e },\n      }),\n    );\n\n    // Handle form submission/reset if form-associated and not in anchor mode\n    if (this.href === undefined && this.type === 'submit' && this._internals.form) {\n      if (this.name !== undefined && this.value !== undefined) {\n        this._internals.setFormValue(this.value);\n      }\n      this._internals.form.requestSubmit();\n    } else if (this.href === undefined && this.type === 'reset' && this._internals.form) {\n      this._internals.form.reset();\n    }\n  }\n\n  // ─── Render Helpers ───\n\n  /**\n   * @private\n   * @internal\n   */\n  private _renderSpinner(): TemplateResult {\n    return html`\n      <svg\n        class=\"button__spinner\"\n        part=\"spinner\"\n        aria-hidden=\"true\"\n        viewBox=\"0 0 24 24\"\n        fill=\"none\"\n      >\n        <circle\n          class=\"button__spinner-track\"\n          cx=\"12\"\n          cy=\"12\"\n          r=\"10\"\n          stroke=\"currentColor\"\n          stroke-width=\"3\"\n          opacity=\"0.3\"\n        />\n        <path\n          class=\"button__spinner-arc\"\n          d=\"M12 2a10 10 0 0 1 10 10\"\n          stroke=\"currentColor\"\n          stroke-width=\"3\"\n          stroke-linecap=\"round\"\n        />\n      </svg>\n    `;\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private _renderInner(): TemplateResult {\n    return html`\n      ${this.loading ? this._renderSpinner() : nothing}\n      <span part=\"prefix\" class=\"button__prefix\">\n        <slot name=\"prefix\"></slot>\n      </span>\n      <span part=\"label\" class=\"button__label\">\n        <slot @slotchange=${this._handleDefaultSlotChange}></slot>\n      </span>\n      <span part=\"suffix\" class=\"button__suffix\">\n        <slot name=\"suffix\"></slot>\n      </span>\n    `;\n  }\n\n  // ─── Render ───\n\n  override render() {\n    const classes = {\n      button: true,\n      [`button--${this.variant}`]: true,\n      [`button--${this.size}`]: true,\n      'button--loading': this.loading,\n    };\n\n    if (this.href !== undefined) {\n      return html`\n        <a\n          part=\"button\"\n          class=${classMap(classes)}\n          href=${this.disabled || this.loading ? nothing : ifDefined(this.href)}\n          target=${ifDefined(this.target)}\n          rel=${this.target === '_blank' ? 'noopener noreferrer' : nothing}\n          aria-label=${this._effectiveLabel || nothing}\n          aria-disabled=${this.disabled ? 'true' : nothing}\n          aria-busy=${this.loading ? 'true' : nothing}\n          tabindex=${this.disabled ? '-1' : nothing}\n          @click=${this._handleClick}\n        >\n          ${this._renderInner()}\n        </a>\n      `;\n    }\n\n    return html`\n      <button\n        part=\"button\"\n        class=${classMap(classes)}\n        ?disabled=${this.disabled}\n        type=${this.type}\n        aria-label=${this._effectiveLabel || nothing}\n        aria-busy=${this.loading ? 'true' : nothing}\n        @click=${this._handleClick}\n      >\n        ${this._renderInner()}\n      </button>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-button': HelixButton;\n  }\n  interface HTMLElementEventMap {\n    'hx-click': CustomEvent<{ originalEvent: MouseEvent }>;\n  }\n}\n"],"names":["helixButtonStyles","css","HelixButton","mixinDelegatesAria","HelixElement","_a","_b","disabled","changedProperties","slot","n","validVariants","devWarn","e","hasContent","html","nothing","classes","classMap","ifDefined","__decorateClass","property","customElement"],"mappings":";;;;;;;AAEO,MAAMA,IAAoBC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;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"}

package/dist/shared/{hx-button-group-BXlMQTt_.js → hx-button-group-BJOGWoMa.js}

@@ -1,7 +1,7 @@
-import { css as h, LitElement as u, html as c } from "lit";
-import "./document-token-adoption-DuYNKd4k.js";
-import { property as n, customElement as p } from "lit/decorators.js";
-import { classMap as b } from "lit/directives/class-map.js";
+import { css as h, html as u } from "lit";
+import { property as n, customElement as c } from "lit/decorators.js";
+import { classMap as p } from "lit/directives/class-map.js";
+import { H as b } from "./helix-element-BNEYeiys.js";
 const m = h`
   :host {
     display: inline-flex;
@@ -93,16 +93,28 @@ const m = h`
     z-index: 1;
     position: relative;
   }
+
+  /* ─── High Contrast Mode (forced-colors) ─── */
+
+  @media (forced-colors: active) {
+    /*
+     * In forced-colors mode, negative margins that collapse borders between grouped
+     * buttons can obscure focus rings. Raise focused children so the Highlight
+     * outline from hx-button's own forced-colors block is fully visible.
+     */
+    .group ::slotted(:focus-within) {
+      z-index: 2;
+    }
+  }
 `;
-var x = Object.defineProperty, g = Object.getOwnPropertyDescriptor, l = (r, i, s, e) => {
-  for (var t = e > 1 ? void 0 : e ? g(i, s) : i, a = r.length - 1, d; a >= 0; a--)
-    (d = r[a]) && (t = (e ? d(i, s, t) : d(t)) || t);
-  return e && t && x(i, s, t), t;
+var g = Object.defineProperty, f = Object.getOwnPropertyDescriptor, s = (r, e, l, i) => {
+  for (var t = i > 1 ? void 0 : i ? f(e, l) : e, a = r.length - 1, d; a >= 0; a--)
+    (d = r[a]) && (t = (i ? d(e, l, t) : d(t)) || t);
+  return i && t && g(e, l, t), t;
 };
-let o = class extends u {
-  // ─── Constructor ───
+let o = class extends b {
   constructor() {
-    super(), this._orientation = "horizontal", this.size = "md", this.label = "", this.internals = this.attachInternals(), this.internals.role = "group";
+    super(...arguments), this._orientation = "horizontal", this.size = "md", this.label = "";
   }
   get orientation() {
     return this._orientation;
@@ -112,17 +124,17 @@ let o = class extends u {
   }
   // ─── Lifecycle ───
   updated(r) {
-    super.updated(r), r.has("size") && this.style.setProperty("--hx-button-group-size", this.size), r.has("label") && (this.internals.ariaLabel = this.label || null);
+    super.updated(r), r.has("size") && this.style.setProperty("--hx-button-group-size", this.size), r.has("label") && (this.label ? this.setAttribute("aria-label", this.label) : this.removeAttribute("aria-label"));
   }
   connectedCallback() {
-    super.connectedCallback(), this.style.setProperty("--hx-button-group-size", this.size), this.label && (this.internals.ariaLabel = this.label);
+    super.connectedCallback(), this.setAttribute("role", "group"), this.style.setProperty("--hx-button-group-size", this.size), this.label && this.setAttribute("aria-label", this.label);
   }
   // ─── Render ───
   render() {
-    return c`
+    return u`
       <div
         part="group"
-        class=${b({
+        class=${p({
       group: !0,
       "group--horizontal": this.orientation === "horizontal",
       "group--vertical": this.orientation === "vertical"
@@ -134,19 +146,19 @@ let o = class extends u {
   }
 };
 o.styles = [m];
-l([
+s([
   n({ type: String, reflect: !0 })
 ], o.prototype, "orientation", 1);
-l([
+s([
   n({ type: String, reflect: !0, attribute: "hx-size" })
 ], o.prototype, "size", 2);
-l([
+s([
   n({ type: String })
 ], o.prototype, "label", 2);
-o = l([
-  p("hx-button-group")
+o = s([
+  c("hx-button-group")
 ], o);
 export {
   o as H
 };
-//# sourceMappingURL=hx-button-group-BXlMQTt_.js.map
+//# sourceMappingURL=hx-button-group-BJOGWoMa.js.map

package/dist/shared/hx-button-group-BJOGWoMa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-button-group-BJOGWoMa.js","sources":["../../src/components/hx-button-group/hx-button-group.styles.ts","../../src/components/hx-button-group/hx-button-group.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixButtonGroupStyles = css`\n  :host {\n    display: inline-flex;\n    contain: layout style;\n  }\n\n  .group {\n    display: inline-flex;\n    align-items: stretch;\n  }\n\n  /* ─── Orientation Variants ─── */\n\n  .group--horizontal {\n    flex-direction: row;\n  }\n\n  .group--vertical {\n    flex-direction: column;\n  }\n\n  /* ─── No Double Borders: Horizontal ─── */\n\n  .group--horizontal ::slotted(*:not(:first-child)) {\n    margin-inline-start: calc(-1 * var(--hx-border-width-thin, 1px));\n  }\n\n  /* ─── No Double Borders: Vertical ─── */\n\n  .group--vertical ::slotted(*:not(:first-child)) {\n    margin-top: calc(-1 * var(--hx-border-width-thin, 1px));\n  }\n\n  /* ─── Border Radius: Horizontal — Single child keeps all corners ─── */\n\n  .group--horizontal ::slotted(:only-child) {\n    --hx-button-border-radius: var(--hx-border-radius-md, 0.375rem);\n  }\n\n  /* ─── Border Radius: Horizontal — First child keeps left corners ─── */\n\n  .group--horizontal ::slotted(:first-child:not(:only-child)) {\n    --hx-button-border-radius: var(--hx-border-radius-md, 0.375rem) 0 0\n      var(--hx-border-radius-md, 0.375rem);\n  }\n\n  /* ─── Border Radius: Horizontal — Last child keeps right corners ─── */\n\n  .group--horizontal ::slotted(:last-child:not(:only-child)) {\n    --hx-button-border-radius: 0 var(--hx-border-radius-md, 0.375rem)\n      var(--hx-border-radius-md, 0.375rem) 0;\n  }\n\n  /* ─── Border Radius: Horizontal — Middle children have no radius ─── */\n\n  .group--horizontal ::slotted(:not(:first-child):not(:last-child)) {\n    --hx-button-border-radius: 0;\n  }\n\n  /* ─── Border Radius: Vertical — Single child keeps all corners ─── */\n\n  .group--vertical ::slotted(:only-child) {\n    --hx-button-border-radius: var(--hx-border-radius-md, 0.375rem);\n  }\n\n  /* ─── Border Radius: Vertical — First child keeps top corners ─── */\n\n  .group--vertical ::slotted(:first-child:not(:only-child)) {\n    --hx-button-border-radius: var(--hx-border-radius-md, 0.375rem)\n      var(--hx-border-radius-md, 0.375rem) 0 0;\n  }\n\n  /* ─── Border Radius: Vertical — Last child keeps bottom corners ─── */\n\n  .group--vertical ::slotted(:last-child:not(:only-child)) {\n    --hx-button-border-radius: 0 0 var(--hx-border-radius-md, 0.375rem)\n      var(--hx-border-radius-md, 0.375rem);\n  }\n\n  /* ─── Border Radius: Vertical — Middle children have no radius ─── */\n\n  .group--vertical ::slotted(:not(:first-child):not(:last-child)) {\n    --hx-button-border-radius: 0;\n  }\n\n  /* ─── Z-index: Raise focused child above siblings to show full focus ring ─── */\n\n  .group ::slotted(:focus-within) {\n    z-index: 1;\n    position: relative;\n  }\n\n  /* ─── High Contrast Mode (forced-colors) ─── */\n\n  @media (forced-colors: active) {\n    /*\n     * In forced-colors mode, negative margins that collapse borders between grouped\n     * buttons can obscure focus rings. Raise focused children so the Highlight\n     * outline from hx-button's own forced-colors block is fully visible.\n     */\n    .group ::slotted(:focus-within) {\n      z-index: 2;\n    }\n  }\n`;\n","import { html, type PropertyValues } from 'lit';\nimport '../../utilities/document-token-adoption.js';\nimport { customElement, property } from 'lit/decorators.js';\nimport { classMap } from 'lit/directives/class-map.js';\nimport { HelixElement } from '../../base/index.js';\nimport { helixButtonGroupStyles } from './hx-button-group.styles.js';\nimport { devWarn } from '../../utils/dev-warn.js';\n\n/**\n * A container component that groups related hx-button elements into a cohesive\n * horizontal or vertical action set. Eliminates double borders between adjacent\n * buttons and squares off inner border-radius for a unified visual appearance.\n *\n * **Accessibility:** Always provide an accessible label via `aria-label` or\n * `aria-labelledby` so screen readers can announce the group purpose.\n *\n * @summary Groups hx-button elements into a horizontal or vertical action set with shared borders.\n *\n * @tag hx-button-group\n *\n * @slot - Default slot accepting hx-button children.\n *\n * @csspart group - The container div element wrapping all slotted buttons.\n *\n * @cssprop [--hx-button-group-size=md] - Size token forwarded to child buttons. Accepts 'sm', 'md', or 'lg'.\n */\n@customElement('hx-button-group')\nexport class HelixButtonGroup extends HelixElement {\n  static override styles = [helixButtonGroupStyles];\n\n  /**\n   * Layout orientation of the button group.\n   * @attr orientation\n   */\n  @property({ type: String, reflect: true })\n  get orientation(): 'horizontal' | 'vertical' {\n    return this._orientation;\n  }\n  set orientation(value: string) {\n    if (value !== 'horizontal' && value !== 'vertical') {\n      devWarn('hx-button-group', `Invalid orientation \"${value}\", defaulting to \"horizontal\".`);\n      value = 'horizontal';\n    }\n    this._orientation = value as 'horizontal' | 'vertical';\n  }\n  /**\n   * Backing store for the orientation property, holding the validated orientation value.\n   * @internal\n   */\n  private _orientation: 'horizontal' | 'vertical' = 'horizontal';\n\n  /**\n   * Size applied to the button group and cascaded to child buttons via\n   * the --hx-button-group-size CSS custom property.\n   * @attr hx-size\n   */\n  @property({ type: String, reflect: true, attribute: 'hx-size' })\n  size: 'sm' | 'md' | 'lg' = 'md';\n\n  /**\n   * Accessible label for the button group. Sets aria-label on the host element.\n   * **Strongly recommended** for WCAG 2.1 AA compliance — without it, screen\n   * readers announce an unnamed \"group\". For Drupal/Twig compatibility, prefer\n   * applying `aria-label` directly as an HTML attribute instead.\n   * @attr label\n   */\n  @property({ type: String })\n  label: string = '';\n\n  // ─── Lifecycle ───\n\n  override updated(changedProperties: PropertyValues<this>): void {\n    super.updated(changedProperties);\n\n    if (changedProperties.has('size')) {\n      this.style.setProperty('--hx-button-group-size', this.size);\n    }\n\n    if (changedProperties.has('label')) {\n      if (this.label) {\n        this.setAttribute('aria-label', this.label);\n      } else {\n        this.removeAttribute('aria-label');\n      }\n    }\n  }\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n    this.setAttribute('role', 'group');\n    this.style.setProperty('--hx-button-group-size', this.size);\n    if (this.label) {\n      this.setAttribute('aria-label', this.label);\n    } else {\n      devWarn(\n        'hx-button-group',\n        'Missing accessible label. Provide a `label` attribute so screen readers can announce the group purpose (WCAG 4.1.2).',\n      );\n    }\n  }\n\n  // ─── Render ───\n\n  override render() {\n    return html`\n      <div\n        part=\"group\"\n        class=${classMap({\n          group: true,\n          'group--horizontal': this.orientation === 'horizontal',\n          'group--vertical': this.orientation === 'vertical',\n        })}\n      >\n        <slot></slot>\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-button-group': HelixButtonGroup;\n  }\n}\n"],"names":["helixButtonGroupStyles","css","HelixButtonGroup","HelixElement","value","changedProperties","html","classMap","__decorateClass","property","customElement"],"mappings":";;;;AAEO,MAAMA,IAAyBC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;;;;ACyB/B,IAAMC,IAAN,cAA+BC,EAAa;AAAA,EAA5C,cAAA;AAAA,UAAA,GAAA,SAAA,GAsBL,KAAQ,eAA0C,cAQlD,KAAA,OAA2B,MAU3B,KAAA,QAAgB;AAAA,EAAA;AAAA,EAhChB,IAAI,cAAyC;AAC3C,WAAO,KAAK;AAAA,EACd;AAAA,EACA,IAAI,YAAYC,GAAe;AAC7B,IAAIA,MAAU,gBAAgBA,MAAU,eAEtCA,IAAQ,eAEV,KAAK,eAAeA;AAAA,EACtB;AAAA;AAAA,EA2BS,QAAQC,GAA+C;AAC9D,UAAM,QAAQA,CAAiB,GAE3BA,EAAkB,IAAI,MAAM,KAC9B,KAAK,MAAM,YAAY,0BAA0B,KAAK,IAAI,GAGxDA,EAAkB,IAAI,OAAO,MAC3B,KAAK,QACP,KAAK,aAAa,cAAc,KAAK,KAAK,IAE1C,KAAK,gBAAgB,YAAY;AAAA,EAGvC;AAAA,EAES,oBAA0B;AACjC,UAAM,kBAAA,GACN,KAAK,aAAa,QAAQ,OAAO,GACjC,KAAK,MAAM,YAAY,0BAA0B,KAAK,IAAI,GACtD,KAAK,SACP,KAAK,aAAa,cAAc,KAAK,KAAK;AAAA,EAO9C;AAAA;AAAA,EAIS,SAAS;AAChB,WAAOC;AAAA;AAAA;AAAA,gBAGKC,EAAS;AAAA,MACf,OAAO;AAAA,MACP,qBAAqB,KAAK,gBAAgB;AAAA,MAC1C,mBAAmB,KAAK,gBAAgB;AAAA,IAAA,CACzC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAKR;AACF;AA1FaL,EACK,SAAS,CAACF,CAAsB;AAO5CQ,EAAA;AAAA,EADHC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM;AAAA,GAP9BP,EAQP,WAAA,eAAA,CAAA;AAsBJM,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM,WAAW,WAAW;AAAA,GA7BpDP,EA8BX,WAAA,QAAA,CAAA;AAUAM,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,OAAA,CAAQ;AAAA,GAvCfP,EAwCX,WAAA,SAAA,CAAA;AAxCWA,IAANM,EAAA;AAAA,EADNE,EAAc,iBAAiB;AAAA,GACnBR,CAAA;"}