@helixui/library 1.0.1 → 1.1.2-next.1

package/dist/shared/hx-badge-DCxvskdw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-badge-DCxvskdw.js","sources":["../../src/components/hx-badge/hx-badge.styles.ts","../../src/components/hx-badge/hx-badge.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixBadgeStyles = css`\n  :host {\n    display: inline-block;\n  }\n\n  .badge {\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    gap: var(--hx-space-1, 0.25rem);\n    border-radius: var(--hx-badge-border-radius, var(--hx-border-radius-md, 0.375rem));\n    background-color: var(--hx-badge-bg, var(--hx-color-primary-500, #2563eb));\n    color: var(--hx-badge-color, var(--hx-color-neutral-0, #ffffff));\n    font-family: var(--hx-badge-font-family, var(--hx-font-family-sans, sans-serif));\n    font-weight: var(--hx-badge-font-weight, var(--hx-font-weight-semibold, 600));\n    line-height: var(--hx-line-height-tight, 1.25);\n    white-space: nowrap;\n    vertical-align: middle;\n    position: relative;\n  }\n\n  /* ─── Size Variants ─── */\n\n  .badge--sm {\n    font-size: var(--hx-badge-font-size, var(--hx-font-size-2xs, 0.625rem));\n    padding: var(--hx-badge-padding-y, var(--hx-space-0-5, 0.125rem))\n      var(--hx-badge-padding-x, var(--hx-space-1-5, 0.375rem));\n  }\n\n  .badge--md {\n    font-size: var(--hx-badge-font-size, var(--hx-font-size-xs, 0.75rem));\n    padding: var(--hx-badge-padding-y, var(--hx-space-1, 0.25rem))\n      var(--hx-badge-padding-x, var(--hx-space-2, 0.5rem));\n  }\n\n  .badge--lg {\n    font-size: var(--hx-badge-font-size, var(--hx-font-size-sm, 0.875rem));\n    padding: var(--hx-badge-padding-y, var(--hx-space-1, 0.25rem))\n      var(--hx-badge-padding-x, var(--hx-space-3, 0.75rem));\n  }\n\n  /* ─── Style Variants ─── */\n\n  .badge--primary {\n    --hx-badge-bg: var(--hx-color-primary-500, #2563eb);\n    --hx-badge-color: var(--hx-color-neutral-0, #ffffff);\n    --hx-badge-pulse-color: var(--hx-color-primary-500, #2563eb);\n  }\n\n  .badge--secondary {\n    --hx-badge-bg: var(--hx-badge-secondary-bg, var(--hx-color-neutral-100, #f3f4f6));\n    --hx-badge-color: var(--hx-badge-secondary-color, var(--hx-color-neutral-700, #374151));\n    --hx-badge-pulse-color: var(--hx-badge-secondary-bg, var(--hx-color-neutral-100, #f3f4f6));\n  }\n\n  .badge--success {\n    --hx-badge-bg: var(--hx-color-success-700, #15803d);\n    --hx-badge-color: var(--hx-color-neutral-0, #ffffff);\n    --hx-badge-pulse-color: var(--hx-color-success-700, #15803d);\n  }\n\n  .badge--warning {\n    --hx-badge-bg: var(--hx-color-warning-500, #eab308);\n    --hx-badge-color: var(--hx-color-neutral-900, #1a1a1a);\n    --hx-badge-pulse-color: var(--hx-color-warning-500, #eab308);\n  }\n\n  .badge--error {\n    --hx-badge-bg: var(--hx-color-error-500, #dc2626);\n    --hx-badge-color: var(--hx-color-neutral-0, #ffffff);\n    --hx-badge-pulse-color: var(--hx-color-error-500, #dc2626);\n  }\n\n  .badge--neutral {\n    --hx-badge-bg: var(--hx-color-neutral-200, #e5e7eb);\n    --hx-badge-color: var(--hx-color-neutral-700, #374151);\n    --hx-badge-pulse-color: var(--hx-color-neutral-200, #e5e7eb);\n  }\n\n  .badge--info {\n    --hx-badge-bg: var(--hx-badge-info-bg, var(--hx-color-info-700, #0369a1));\n    --hx-badge-color: var(--hx-badge-info-color, var(--hx-color-neutral-0, #ffffff));\n    --hx-badge-pulse-color: var(--hx-badge-info-bg, var(--hx-color-info-700, #0369a1));\n  }\n\n  /* ─── Semantic Variant Label (WCAG 1.4.1) ─── */\n  /* Visually hidden text prefix for semantic variants (success/warning/error/info). */\n  /* Ensures the variant is not conveyed by color alone.                             */\n\n  .badge__variant-label {\n    position: absolute;\n    width: 1px;\n    height: 1px;\n    padding: 0;\n    margin: -1px;\n    overflow: hidden;\n    clip: rect(0, 0, 0, 0);\n    white-space: nowrap;\n    border: 0;\n  }\n\n  /* ─── Pill Mode ─── */\n\n  .badge--pill {\n    border-radius: var(--hx-badge-border-radius, var(--hx-border-radius-full, 9999px));\n  }\n\n  /* ─── Dot Indicator (empty + pulse) ─── */\n\n  .badge--dot {\n    width: var(--hx-badge-dot-size, var(--hx-space-2, 0.5rem));\n    height: var(--hx-badge-dot-size, var(--hx-space-2, 0.5rem));\n    padding: 0;\n    border-radius: var(--hx-border-radius-full, 9999px);\n  }\n\n  /* Guard: hide prefix slot and slotted content in dot mode to prevent overflow */\n  .badge--dot ::slotted(*) {\n    display: none;\n  }\n\n  /* ─── Pulse Animation ─── */\n\n  @keyframes hx-badge-pulse {\n    0%,\n    100% {\n      opacity: 1;\n      box-shadow: 0 0 0 0 var(--hx-badge-pulse-color, currentColor);\n    }\n    50% {\n      opacity: var(--hx-opacity-75, 0.75);\n      box-shadow: 0 0 0 4px transparent;\n    }\n  }\n\n  .badge--pulse {\n    animation: hx-badge-pulse var(--hx-badge-pulse-duration, var(--hx-duration-slow, 2s))\n      var(--hx-badge-pulse-easing, var(--hx-easing-in-out, ease-in-out)) infinite;\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    .badge--pulse {\n      animation: none;\n    }\n  }\n\n  /* ─── Remove Button ─── */\n\n  .badge__remove-button {\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    background: none;\n    border: none;\n    padding: 0;\n    margin-inline-start: var(--hx-space-1, 0.25rem);\n    cursor: pointer;\n    color: inherit;\n    opacity: var(--hx-opacity-75, 0.75);\n    border-radius: var(--hx-border-radius-sm, 0.125rem);\n    line-height: 0;\n    /* WCAG 2.5.5: minimum 44×44px touch target */\n    min-width: var(--hx-touch-target-min, 2.75rem);\n    min-height: var(--hx-touch-target-min, 2.75rem);\n  }\n\n  .badge__remove-button:hover {\n    opacity: var(--hx-opacity-100, 1);\n  }\n\n  .badge__remove-button:focus-visible {\n    outline: var(--hx-focus-ring-width, 2px) solid var(--hx-focus-ring-color, currentColor);\n    outline-offset: var(--hx-focus-ring-offset, 1px);\n  }\n`;\n","import { LitElement, html, nothing } from 'lit';\nimport { customElement, property, state } from 'lit/decorators.js';\nimport { classMap } from 'lit/directives/class-map.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { helixBadgeStyles } from './hx-badge.styles.js';\nimport { devWarn } from '../../utils/dev-warn.js';\n\n/**\n * A small status indicator for notifications, counts, and labels.\n *\n * @summary Presentational badge for status indicators, notification counts, and labels.\n *\n * @tag hx-badge\n *\n * @slot - Default slot for badge content (text, number). When empty with pulse enabled, renders as a dot indicator.\n * @slot prefix - Icon or content rendered before the badge text.\n *\n * @fires {CustomEvent<void>} hx-remove - Dispatched when the user clicks the remove button.\n *\n * @csspart badge - The badge element.\n * @csspart remove-button - The remove/dismiss button.\n *\n * @cssprop [--hx-badge-bg=var(--hx-color-primary-500)] - Badge background color. The primary override point.\n * @cssprop [--hx-badge-color=var(--hx-color-neutral-0)] - Badge text color. The primary override point.\n * @cssprop [--hx-badge-font-size] - Badge font size (set per size variant).\n * @cssprop [--hx-badge-font-weight=var(--hx-font-weight-semibold)] - Badge font weight.\n * @cssprop [--hx-badge-font-family=var(--hx-font-family-sans)] - Badge font family.\n * @cssprop [--hx-badge-border-radius=var(--hx-border-radius-md)] - Badge border radius.\n * @cssprop [--hx-badge-padding-x] - Badge horizontal padding (set per size variant).\n * @cssprop [--hx-badge-padding-y] - Badge vertical padding (set per size variant).\n * @cssprop [--hx-badge-pulse-color] - Pulse color matching variant background with reduced opacity.\n * @cssprop [--hx-badge-dot-size=var(--hx-size-2)] - Dot indicator size when rendered without content.\n * @cssprop [--hx-badge-secondary-bg=var(--hx-color-neutral-100)] - Background for the secondary variant.\n * @cssprop [--hx-badge-secondary-color=var(--hx-color-neutral-700)] - Text color for the secondary variant.\n * @cssprop [--hx-badge-info-bg=var(--hx-color-info-700)] - Background for the info variant.\n * @cssprop [--hx-badge-info-color=var(--hx-color-neutral-0)] - Text color for the info variant.\n */\n@customElement('hx-badge')\nexport class HelixBadge extends LitElement {\n  static override styles = [tokenStyles, helixBadgeStyles];\n\n  /**\n   * Visual style variant of the badge.\n   * @attr variant\n   */\n  @property({ type: String, reflect: true })\n  variant: 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'neutral' | 'info' =\n    'primary';\n\n  /**\n   * Size of the badge.\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 badge uses fully rounded (pill) styling.\n   * @attr pill\n   */\n  @property({ type: Boolean, reflect: true })\n  pill = false;\n\n  /**\n   * Whether the badge displays an animated pulse for attention.\n   * @attr pulse\n   */\n  @property({ type: Boolean, reflect: true })\n  pulse = false;\n\n  /**\n   * Whether the badge renders a dismiss button.\n   * @attr removable\n   */\n  @property({ type: Boolean, reflect: true })\n  removable = false;\n\n  /**\n   * Numeric count to display. When set, renders the count as badge content.\n   * When count exceeds `max`, displays `${max}+` (e.g. `99+`).\n   * @attr count\n   */\n  @property({ type: Number, reflect: true })\n  count: number | undefined = undefined;\n\n  /**\n   * Maximum count value before truncation to `${max}+`. Defaults to 99.\n   * @attr max\n   */\n  @property({ type: Number, reflect: true })\n  max = 99;\n\n  /**\n   * Accessible label for the dot indicator mode (pulse + empty slot).\n   * Required for WCAG 4.1.2 compliance when using the dot indicator pattern.\n   * Example: `dot-label=\"3 new messages\"`.\n   * @attr dot-label\n   */\n  @property({ type: String, attribute: 'dot-label' })\n  dotLabel = '';\n\n  /**\n   * Accessible label for the remove button. Should describe what is being removed.\n   * Defaults to \"Remove\". For better accessibility, include context: e.g. \"Remove Critical badge\".\n   * @attr remove-label\n   */\n  @property({ type: String, attribute: 'remove-label' })\n  removeLabel = 'Remove';\n\n  /**\n   * Tracks whether the default slot has assigned content.\n   * @internal\n   */\n  @state()\n  private _hasSlotContent = false;\n\n  // ─── Lifecycle ───\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n    // Backward compat: accept legacy `size` attribute. When present and `hx-size`\n    // is not set, map the value and emit a deprecation warning.\n    const legacySize = this.getAttribute('size');\n    if (legacySize !== null && !this.hasAttribute('hx-size')) {\n      devWarn('hx-badge', 'The \"size\" attribute is deprecated. Use \"hx-size\" instead.');\n      this.size = legacySize as 'sm' | 'md' | 'lg';\n    }\n  }\n\n  // ─── Slot Change Handling ───\n\n  /** @internal */\n  private _handleSlotChange(e: Event): void {\n    const slot = e.target as HTMLSlotElement;\n    const nodes = slot.assignedNodes({ flatten: true });\n    // Check if any assigned node has non-whitespace content\n    this._hasSlotContent = nodes.some((node) => {\n      if (node.nodeType === Node.ELEMENT_NODE) return true;\n      if (node.nodeType === Node.TEXT_NODE) {\n        return (node.textContent ?? '').trim().length > 0;\n      }\n      return false;\n    });\n  }\n\n  // ─── Event Handling ───\n\n  /** @internal */\n  private _handleRemove(): void {\n    this.dispatchEvent(\n      new CustomEvent<void>('hx-remove', {\n        bubbles: true,\n        composed: true,\n      }),\n    );\n  }\n\n  // ─── Count Display ───\n\n  /** @internal */\n  private get _countDisplay(): string {\n    if (this.count === undefined) return '';\n    return this.count > this.max ? `${this.max}+` : String(this.count);\n  }\n\n  // ─── WCAG 1.4.1: Semantic variant label map ───\n  // Variants that carry semantic meaning beyond decoration need a non-color cue.\n  // Visually-hidden text is prepended so screen reader users and color-blind\n  // users get the variant context even when no icon is slotted.\n\n  /** @internal */\n  private static readonly _SEMANTIC_VARIANT_LABELS: Partial<Record<HelixBadge['variant'], string>> =\n    {\n      success: 'Success',\n      warning: 'Warning',\n      error: 'Error',\n      info: 'Info',\n    };\n\n  /** @internal */\n  private get _semanticVariantLabel(): string {\n    return HelixBadge._SEMANTIC_VARIANT_LABELS[this.variant] ?? '';\n  }\n\n  // ─── Render ───\n\n  override render() {\n    const hasCount = this.count !== undefined;\n    const isDot = !this._hasSlotContent && !hasCount && this.pulse;\n\n    if (isDot && !this.dotLabel) {\n      devWarn(\n        'hx-badge',\n        'Dot badge is missing an accessible label. Set `dotLabel` so screen readers can announce the badge purpose (WCAG 4.1.2).',\n      );\n    }\n\n    const classes = {\n      badge: true,\n      [`badge--${this.variant}`]: true,\n      [`badge--${this.size}`]: true,\n      'badge--pill': this.pill,\n      'badge--pulse': this.pulse,\n      'badge--dot': isDot,\n    };\n\n    const variantLabel = this._semanticVariantLabel;\n\n    return html`\n      <span\n        part=\"badge\"\n        class=${classMap(classes)}\n        role=${isDot && this.dotLabel ? 'img' : nothing}\n        aria-label=${isDot && this.dotLabel ? this.dotLabel : nothing}\n        aria-live=${hasCount ? 'polite' : nothing}\n      >\n        ${variantLabel\n          ? html`<span class=\"badge__variant-label\">${variantLabel}: </span>`\n          : nothing}\n        <slot name=\"prefix\"></slot>\n        ${hasCount ? this._countDisplay : html`<slot @slotchange=${this._handleSlotChange}></slot>`}\n        ${this.removable\n          ? html`<button\n              part=\"remove-button\"\n              class=\"badge__remove-button\"\n              aria-label=${this.removeLabel}\n              @click=${this._handleRemove}\n            >\n              <svg viewBox=\"0 0 12 12\" aria-hidden=\"true\" width=\"10\" height=\"10\">\n                <path\n                  d=\"M2.22 2.22a.75.75 0 011.06 0L6 4.94l2.72-2.72a.75.75 0 011.06 1.06L7.06 6l2.72 2.72a.75.75 0 01-1.06 1.06L6 7.06 3.28 9.78a.75.75 0 01-1.06-1.06L4.94 6 2.22 3.28a.75.75 0 010-1.06z\"\n                  fill=\"currentColor\"\n                />\n              </svg>\n            </button>`\n          : nothing}\n      </span>\n    `;\n  }\n}\n\n/**\n * @deprecated Use `HelixBadge` instead. This alias will be removed in a future\n * major version as part of the project-wide migration from `Wc` to `Hx` prefixes.\n * @since 0.1.0\n * @removal-target 1.0.0\n */\nexport type WcBadge = HelixBadge;\n\n/** Canonical type alias for the hx-badge component. */\nexport type HxBadge = HelixBadge;\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-badge': HelixBadge;\n  }\n}\n"],"names":["helixBadgeStyles","css","HelixBadge","LitElement","legacySize","e","nodes","node","hasCount","isDot","classes","variantLabel","html","classMap","nothing","tokenStyles","__decorateClass","property","state","customElement"],"mappings":"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"}

package/dist/shared/{hx-banner-DnCBJtRR.js → hx-banner-2RS7Nux4.js}

@@ -1,9 +1,9 @@
-import { css as b, LitElement as f, html as n, nothing as d } from "lit";
-import { property as a, customElement as u } from "lit/decorators.js";
-import { classMap as v } from "lit/directives/class-map.js";
-import { ifDefined as x } from "lit/directives/if-defined.js";
-import { tokenStyles as p } from "@helixui/tokens/lit";
-const g = b`
+import { css as d, LitElement as v, html as t, nothing as b } from "lit";
+import { property as a, customElement as f } from "lit/decorators.js";
+import { classMap as p } from "lit/directives/class-map.js";
+import { ifDefined as u } from "lit/directives/if-defined.js";
+import { tokenStyles as x } from "@helixui/tokens/lit";
+const g = d`
   :host {
     display: block;
     width: 100%;
@@ -22,6 +22,22 @@ const g = b`
     box-sizing: border-box;
   }
 
+  /* ─── Severity Label (WCAG 1.4.1) ─── */
+  /* Visually hidden — ensures variant is never conveyed by color alone.   */
+  /* Always rendered so screen readers can identify the banner severity.   */
+
+  .banner__severity-label {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+  }
+
   /* ─── Banner Container ─── */
 
   .banner {
@@ -80,11 +96,12 @@ const g = b`
   }
 
   .banner__action:hover {
-    opacity: 0.8;
+    opacity: var(--hx-opacity-90, 0.9);
   }
 
   .banner__action:focus-visible {
-    outline: var(--hx-focus-ring-width, 2px) solid var(--hx-focus-ring-color, #2563eb);
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa));
     outline-offset: var(--hx-focus-ring-offset, 2px);
     border-radius: var(--hx-border-radius-sm, 0.25rem);
   }
@@ -101,7 +118,7 @@ const g = b`
     flex-shrink: 0;
     min-width: var(--hx-touch-target-size, 44px);
     min-height: var(--hx-touch-target-size, 44px);
-    margin-left: auto;
+    margin-inline-start: auto;
     padding: 0;
     border: none;
     border-radius: var(--hx-border-radius-sm, 0.25rem);
@@ -113,18 +130,19 @@ const g = b`
     transition:
       background-color var(--hx-transition-fast, 150ms ease),
       opacity var(--hx-transition-fast, 150ms ease);
-    opacity: 0.7;
+    opacity: var(--hx-opacity-75, 0.75);
   }
 
   .banner__close-button:hover {
-    opacity: 1;
+    opacity: var(--hx-opacity-100, 1);
     /* color-mix() is supported in Chrome 111+, Firefox 113+, Safari 16.2+.   */
     /* Falls back to transparent (no hover background) in older environments.  */
     background-color: color-mix(in srgb, currentColor 10%, transparent);
   }
 
   .banner__close-button:focus-visible {
-    outline: var(--hx-focus-ring-width, 2px) solid var(--hx-focus-ring-color, #2563eb);
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa));
     outline-offset: var(--hx-focus-ring-offset, 2px);
     opacity: 1;
   }
@@ -189,17 +207,31 @@ const g = b`
     }
   }
 `;
-var m = Object.defineProperty, _ = Object.getOwnPropertyDescriptor, o = (e, i, c, s) => {
-  for (var t = s > 1 ? void 0 : s ? _(i, c) : i, h = e.length - 1, l; h >= 0; h--)
-    (l = e[h]) && (t = (s ? l(i, c, t) : l(t)) || t);
-  return s && t && m(i, c, t), t;
+var m = Object.defineProperty, _ = Object.getOwnPropertyDescriptor, r = (n, i, s, l) => {
+  for (var o = l > 1 ? void 0 : l ? _(i, s) : i, c = n.length - 1, h; c >= 0; c--)
+    (h = n[c]) && (o = (l ? h(i, s, o) : h(o)) || o);
+  return l && o && m(i, s, o), o;
 };
-let r = class extends f {
+let e = class extends v {
   constructor() {
-    super(...arguments), this.variant = "info", this.position = "sticky", this.dismissible = !1, this.heading = "", this.actionLabel = "", this.actionHref = "", this.open = !0;
+    super(...arguments), this.variant = "info", this.position = "sticky", this.dismissible = !1, this.heading = "", this.actionLabel = "", this.actionHref = "", this.open = !0, this.labelClose = "Dismiss banner";
   }
   // ─── Private Helpers ───
+  /** Returns the default English severity label for the current variant. */
+  _defaultSeverityLabel() {
+    return {
+      info: "Info:",
+      success: "Success:",
+      warning: "Warning:",
+      error: "Error:"
+    }[this.variant] ?? "";
+  }
+  /** Returns the effective severity label, using the override if provided. */
+  get _effectiveSeverityLabel() {
+    return this.severityLabel ?? this._defaultSeverityLabel();
+  }
   /** Returns true when the variant requires assertive announcement. */
+  /** @internal */
   get _isAssertive() {
     return this.variant === "error" || this.variant === "warning";
   }
@@ -208,6 +240,7 @@ let r = class extends f {
    * role="alert" implies aria-live="assertive"; role="status" implies aria-live="polite".
    * We do NOT set aria-live explicitly to avoid double-announcements in JAWS.
    */
+  /** @internal */
   get _role() {
     return this._isAssertive ? "alert" : "status";
   }
@@ -215,38 +248,43 @@ let r = class extends f {
   connectedCallback() {
     super.connectedCallback(), this.setAttribute("role", this._role), this.open || this.setAttribute("aria-hidden", "true");
   }
-  updated(e) {
-    super.updated(e), e.has("variant") && this.setAttribute("role", this._role), e.has("open") && (this.open ? this.removeAttribute("aria-hidden") : this.setAttribute("aria-hidden", "true"));
+  updated(n) {
+    super.updated(n), n.has("variant") && this.setAttribute("role", this._role), n.has("open") && (this.open ? this.removeAttribute("aria-hidden") : this.setAttribute("aria-hidden", "true"));
   }
   // ─── Default Icons ───
+  /** @internal */
   _renderInfoIcon() {
-    return n`<svg viewBox="0 0 20 20" aria-hidden="true">
+    return t`<svg viewBox="0 0 20 20" aria-hidden="true">
       <path
         d="M10 2a8 8 0 100 16 8 8 0 000-16zm.75 4.75a.75.75 0 11-1.5 0 .75.75 0 011.5 0zM9.25 9a.75.75 0 011.5 0v4a.75.75 0 01-1.5 0V9z"
       />
     </svg>`;
   }
+  /** @internal */
   _renderSuccessIcon() {
-    return n`<svg viewBox="0 0 20 20" aria-hidden="true">
+    return t`<svg viewBox="0 0 20 20" aria-hidden="true">
       <path
         d="M10 2a8 8 0 100 16 8 8 0 000-16zm3.03 6.28a.75.75 0 00-1.06-1.06L9 10.19 7.78 8.97a.75.75 0 00-1.06 1.06l1.75 1.75a.75.75 0 001.06 0l3.5-3.5z"
       />
     </svg>`;
   }
+  /** @internal */
   _renderWarningIcon() {
-    return n`<svg viewBox="0 0 20 20" aria-hidden="true">
+    return t`<svg viewBox="0 0 20 20" aria-hidden="true">
       <path
         d="M8.49 2.92a1.75 1.75 0 013.02 0l6.25 10.83A1.75 1.75 0 0116.25 16H3.75a1.75 1.75 0 01-1.51-2.25L8.49 2.92zM10 7a.75.75 0 01.75.75v3a.75.75 0 01-1.5 0v-3A.75.75 0 0110 7zm0 7.5a.75.75 0 100-1.5.75.75 0 000 1.5z"
       />
     </svg>`;
   }
+  /** @internal */
   _renderErrorIcon() {
-    return n`<svg viewBox="0 0 20 20" aria-hidden="true">
+    return t`<svg viewBox="0 0 20 20" aria-hidden="true">
       <path
         d="M10 2a8 8 0 100 16 8 8 0 000-16zm-1.72 5.22a.75.75 0 011.06 0L10 7.94l.66-.72a.75.75 0 111.06 1.06L11.06 9l.66.72a.75.75 0 11-1.06 1.06L10 10.06l-.66.72a.75.75 0 01-1.06-1.06L8.94 9l-.66-.72a.75.75 0 010-1.06z"
       />
     </svg>`;
   }
+  /** @internal */
   _renderDefaultIcon() {
     switch (this.variant) {
       case "success":
@@ -260,8 +298,9 @@ let r = class extends f {
         return this._renderInfoIcon();
     }
   }
+  /** @internal */
   _renderCloseIcon() {
-    return n`<svg viewBox="0 0 20 20" aria-hidden="true">
+    return t`<svg viewBox="0 0 20 20" aria-hidden="true">
       <path
         d="M6.28 5.22a.75.75 0 00-1.06 1.06L8.94 10l-3.72 3.72a.75.75 0 101.06 1.06L10 11.06l3.72 3.72a.75.75 0 101.06-1.06L11.06 10l3.72-3.72a.75.75 0 00-1.06-1.06L10 8.94 6.28 5.22z"
       />
@@ -275,6 +314,7 @@ let r = class extends f {
     this._handleDismiss();
   }
   // ─── Event Handling ───
+  /** @internal */
   _handleDismiss() {
     this.open = !1, this.dispatchEvent(
       new CustomEvent("hx-dismiss", {
@@ -286,68 +326,75 @@ let r = class extends f {
   }
   // ─── Render ───
   render() {
-    const e = {
+    const n = {
       banner: !0,
       [`banner--${this.variant}`]: !0
-    }, i = this.actionLabel.length > 0 && this.actionHref.length > 0;
-    return n`
-      <div part="banner" class=${v(e)}>
+    }, i = this.actionLabel.length > 0 && this.actionHref.length > 0, s = this._effectiveSeverityLabel;
+    return t`
+      <div part="banner" class=${p(n)}>
+        <span class="banner__severity-label">${s}</span>
         <div part="icon" class="banner__icon">${this._renderDefaultIcon()}</div>
 
         <div part="message" class="banner__message">
           <slot></slot>
         </div>
 
-        ${i ? n`
+        ${i ? t`
               <a
                 part="action"
                 class="banner__action"
-                href=${x(this.actionHref || void 0)}
+                href=${u(this.actionHref || void 0)}
                 aria-label=${this.heading ? `${this.actionLabel}: ${this.heading}` : this.actionLabel}
               >
                 <slot name="action">${this.actionLabel}</slot>
               </a>
-            ` : d}
-        ${this.dismissible ? n`
+            ` : b}
+        ${this.dismissible ? t`
               <button
                 part="close-button"
                 class="banner__close-button"
-                aria-label=${`Dismiss ${this.heading ? `${this.heading} ` : ""}banner`}
+                aria-label=${this.labelClose}
                 @click=${this._handleDismiss}
               >
                 ${this._renderCloseIcon()}
               </button>
-            ` : d}
+            ` : b}
       </div>
     `;
   }
 };
-r.styles = [p, g];
-o([
+e.styles = [x, g];
+r([
   a({ type: String, reflect: !0 })
-], r.prototype, "variant", 2);
-o([
+], e.prototype, "variant", 2);
+r([
   a({ type: String, reflect: !0 })
-], r.prototype, "position", 2);
-o([
+], e.prototype, "position", 2);
+r([
   a({ type: Boolean, reflect: !0 })
-], r.prototype, "dismissible", 2);
-o([
+], e.prototype, "dismissible", 2);
+r([
   a({ type: String })
-], r.prototype, "heading", 2);
-o([
+], e.prototype, "heading", 2);
+r([
   a({ type: String, attribute: "action-label" })
-], r.prototype, "actionLabel", 2);
-o([
+], e.prototype, "actionLabel", 2);
+r([
   a({ type: String, attribute: "action-href" })
-], r.prototype, "actionHref", 2);
-o([
+], e.prototype, "actionHref", 2);
+r([
   a({ type: Boolean, reflect: !0 })
-], r.prototype, "open", 2);
-r = o([
-  u("hx-banner")
-], r);
+], e.prototype, "open", 2);
+r([
+  a({ type: String, attribute: "label-close" })
+], e.prototype, "labelClose", 2);
+r([
+  a({ attribute: "severity-label" })
+], e.prototype, "severityLabel", 2);
+e = r([
+  f("hx-banner")
+], e);
 export {
-  r as H
+  e as H
 };
-//# sourceMappingURL=hx-banner-DnCBJtRR.js.map
+//# sourceMappingURL=hx-banner-2RS7Nux4.js.map

package/dist/shared/hx-banner-2RS7Nux4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-banner-2RS7Nux4.js","sources":["../../src/components/hx-banner/hx-banner.styles.ts","../../src/components/hx-banner/hx-banner.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixBannerStyles = css`\n  :host {\n    display: block;\n    width: 100%;\n    position: var(--hx-banner-position, sticky);\n    top: 0;\n    left: 0;\n    right: 0;\n    z-index: var(--hx-banner-z-index, 100);\n  }\n\n  :host(:not([open])) {\n    display: none;\n  }\n\n  * {\n    box-sizing: border-box;\n  }\n\n  /* ─── Severity Label (WCAG 1.4.1) ─── */\n  /* Visually hidden — ensures variant is never conveyed by color alone.   */\n  /* Always rendered so screen readers can identify the banner severity.   */\n\n  .banner__severity-label {\n    position: absolute;\n    width: 1px;\n    height: 1px;\n    padding: 0;\n    margin: -1px;\n    overflow: hidden;\n    clip: rect(0, 0, 0, 0);\n    white-space: nowrap;\n    border: 0;\n  }\n\n  /* ─── Banner Container ─── */\n\n  .banner {\n    display: flex;\n    align-items: center;\n    gap: var(--hx-banner-gap, var(--hx-space-3, 0.75rem));\n    padding: var(--hx-banner-padding, var(--hx-space-3, 0.75rem) var(--hx-space-4, 1rem));\n    background-color: var(--hx-banner-bg, var(--hx-color-info-50, #e8f4fd));\n    color: var(--hx-banner-color, var(--hx-color-info-800, #1a3a4a));\n    border-bottom: var(--hx-banner-border-width, var(--hx-border-width-thin, 1px)) solid\n      var(--hx-banner-border-color, var(--hx-color-info-200, #b3d9ef));\n    font-family: var(--hx-banner-font-family, var(--hx-font-family-sans, sans-serif));\n    font-size: var(--hx-font-size-sm, 0.875rem);\n    line-height: var(--hx-line-height-normal, 1.5);\n    width: 100%;\n  }\n\n  /* ─── Icon ─── */\n\n  .banner__icon {\n    display: flex;\n    align-items: center;\n    flex-shrink: 0;\n    color: var(--hx-banner-icon-color, var(--hx-color-info-500, #3b82f6));\n  }\n\n  .banner__icon svg {\n    width: var(--hx-space-5, 1.25rem);\n    height: var(--hx-space-5, 1.25rem);\n    fill: currentColor;\n  }\n\n  /* ─── Message ─── */\n\n  .banner__message {\n    flex: 1;\n    min-width: 0;\n  }\n\n  /* ─── Action Link ─── */\n\n  .banner__action {\n    display: inline-flex;\n    align-items: center;\n    flex-shrink: 0;\n    color: var(--hx-banner-action-color, var(--hx-banner-color, var(--hx-color-info-800, #1a3a4a)));\n    font-weight: var(--hx-font-weight-semibold, 600);\n    text-decoration: underline;\n    text-underline-offset: 2px;\n    cursor: pointer;\n    background: transparent;\n    border: none;\n    padding: 0;\n    font-size: inherit;\n    font-family: inherit;\n  }\n\n  .banner__action:hover {\n    opacity: var(--hx-opacity-90, 0.9);\n  }\n\n  .banner__action:focus-visible {\n    outline: var(--hx-focus-ring-width, 2px) solid\n      var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa));\n    outline-offset: var(--hx-focus-ring-offset, 2px);\n    border-radius: var(--hx-border-radius-sm, 0.25rem);\n  }\n\n  /* ─── Close Button ─── */\n  /* Minimum 44px touch target per WCAG 2.5.8 (Target Size Minimum, AA) and */\n  /* Apple HIG / Google Material guidelines. Uses absolute px units to ensure */\n  /* the target size is independent of the consumer's base font size.         */\n\n  .banner__close-button {\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    flex-shrink: 0;\n    min-width: var(--hx-touch-target-size, 44px);\n    min-height: var(--hx-touch-target-size, 44px);\n    margin-inline-start: auto;\n    padding: 0;\n    border: none;\n    border-radius: var(--hx-border-radius-sm, 0.25rem);\n    background: transparent;\n    color: var(--hx-banner-color, var(--hx-color-info-800, #1a3a4a));\n    cursor: pointer;\n    font-size: var(--hx-font-size-md, 1rem);\n    line-height: 1;\n    transition:\n      background-color var(--hx-transition-fast, 150ms ease),\n      opacity var(--hx-transition-fast, 150ms ease);\n    opacity: var(--hx-opacity-75, 0.75);\n  }\n\n  .banner__close-button:hover {\n    opacity: var(--hx-opacity-100, 1);\n    /* color-mix() is supported in Chrome 111+, Firefox 113+, Safari 16.2+.   */\n    /* Falls back to transparent (no hover background) in older environments.  */\n    background-color: color-mix(in srgb, currentColor 10%, transparent);\n  }\n\n  .banner__close-button:focus-visible {\n    outline: var(--hx-focus-ring-width, 2px) solid\n      var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa));\n    outline-offset: var(--hx-focus-ring-offset, 2px);\n    opacity: 1;\n  }\n\n  .banner__close-button svg {\n    width: var(--hx-space-4, 1rem);\n    height: var(--hx-space-4, 1rem);\n    fill: currentColor;\n  }\n\n  /* ─── Variant: info ─── */\n\n  :host([variant='info']) .banner,\n  :host(:not([variant])) .banner {\n    --hx-banner-bg: var(--hx-color-info-50, #e8f4fd);\n    --hx-banner-border-color: var(--hx-color-info-200, #b3d9ef);\n    --hx-banner-color: var(--hx-color-info-800, #1a3a4a);\n    --hx-banner-icon-color: var(--hx-color-info-500, #3b82f6);\n  }\n\n  /* ─── Variant: success ─── */\n\n  :host([variant='success']) .banner {\n    --hx-banner-bg: var(--hx-color-success-50, #ecfdf5);\n    --hx-banner-border-color: var(--hx-color-success-200, #a7f3d0);\n    --hx-banner-color: var(--hx-color-success-800, #065f46);\n    --hx-banner-icon-color: var(--hx-color-success-500, #10b981);\n  }\n\n  /* ─── Variant: warning ─── */\n\n  :host([variant='warning']) .banner {\n    --hx-banner-bg: var(--hx-color-warning-50, #fffbeb);\n    --hx-banner-border-color: var(--hx-color-warning-200, #fde68a);\n    --hx-banner-color: var(--hx-color-warning-800, #92400e);\n    --hx-banner-icon-color: var(--hx-color-warning-500, #f59e0b);\n  }\n\n  /* ─── Variant: error ─── */\n\n  :host([variant='error']) .banner {\n    --hx-banner-bg: var(--hx-color-error-50, #fef2f2);\n    --hx-banner-border-color: var(--hx-color-error-200, #fecaca);\n    --hx-banner-color: var(--hx-color-error-800, #991b1b);\n    --hx-banner-icon-color: var(--hx-color-error-500, #ef4444);\n  }\n\n  /* ─── Position: fixed ─── */\n  /* When position=\"fixed\", override the host-level CSS custom property.    */\n  /* The :host rule above sets position via var(--hx-banner-position).      */\n  /* We use an attribute selector to override it cleanly without duplication. */\n\n  :host([position='fixed']) {\n    position: fixed;\n  }\n\n  /* ─── Reduced Motion ─── */\n\n  @media (prefers-reduced-motion: reduce) {\n    .banner__close-button {\n      transition: none;\n    }\n  }\n`;\n","import { LitElement, html, nothing, type PropertyValues } from 'lit';\nimport { customElement, property } from 'lit/decorators.js';\nimport { classMap } from 'lit/directives/class-map.js';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { helixBannerStyles } from './hx-banner.styles.js';\n\n/** Banner variant determines visual styling and ARIA semantics. */\nexport type BannerVariant = 'info' | 'success' | 'warning' | 'error';\n\n/** Banner position determines CSS positioning behavior. */\nexport type BannerPosition = 'sticky' | 'fixed';\n\n/**\n * A full-width page-level banner for persistent notifications and announcements.\n * Designed for healthcare applications requiring prominent system-level messaging.\n *\n * @summary Full-width page-level banner for persistent notifications with variant-based styling and ARIA live regions.\n *\n * @tag hx-banner\n *\n * @slot - Default slot for banner message content.\n * @slot action - Optional slot to override the built-in action link with custom content.\n *\n * @fires {CustomEvent<{reason: string}>} hx-dismiss - Dispatched when the user dismisses the banner.\n *\n * @csspart banner - The outer banner container.\n * @csspart icon - The icon container.\n * @csspart message - The message content area.\n * @csspart action - The action link element (only rendered when action-label and action-href are set).\n * @csspart close-button - The dismiss button (only rendered when dismissible).\n *\n * @cssprop [--hx-banner-bg=var(--hx-color-info-50)] - Banner background color.\n * @cssprop [--hx-banner-color=var(--hx-color-info-800)] - Banner text color.\n * @cssprop [--hx-banner-border-color=var(--hx-color-info-200)] - Banner bottom border color.\n * @cssprop [--hx-banner-border-width=var(--hx-border-width-thin)] - Banner bottom border width.\n * @cssprop [--hx-banner-padding=var(--hx-space-3) var(--hx-space-4)] - Banner padding.\n * @cssprop [--hx-banner-gap=var(--hx-space-3)] - Gap between banner elements.\n * @cssprop [--hx-banner-icon-color=var(--hx-color-info-500)] - Banner icon color.\n * @cssprop [--hx-banner-font-family=var(--hx-font-family-sans)] - Banner font family.\n * @cssprop [--hx-banner-action-color=var(--hx-banner-color)] - Action link color.\n * @cssprop [--hx-banner-position=sticky] - CSS position value (sticky or fixed).\n * @cssprop [--hx-banner-z-index=100] - Banner z-index for stacking context.\n * @cssprop [--hx-touch-target-size=44px] - Minimum touch target size for the close button.\n */\n@customElement('hx-banner')\nexport class HelixBanner extends LitElement {\n  static override styles = [tokenStyles, helixBannerStyles];\n\n  // ─── Properties ───\n\n  /**\n   * Visual variant of the banner that determines colors and ARIA semantics.\n   * @attr variant\n   */\n  @property({ type: String, reflect: true })\n  variant: 'info' | 'success' | 'warning' | 'error' = 'info';\n\n  /**\n   * CSS positioning behavior. \"sticky\" keeps the banner in flow; \"fixed\" pins it to the viewport.\n   * @attr position\n   */\n  @property({ type: String, reflect: true })\n  position: 'sticky' | 'fixed' = 'sticky';\n\n  /**\n   * Whether the banner can be dismissed by the user.\n   * @attr dismissible\n   */\n  @property({ type: Boolean, reflect: true })\n  dismissible = false;\n\n  /**\n   * Heading text for the banner, used to provide context in the action link's and\n   * close button's accessible labels.\n   * @attr heading\n   */\n  @property({ type: String })\n  heading = '';\n\n  /**\n   * Label text for the optional action link. Requires action-href to render.\n   * @attr action-label\n   */\n  @property({ type: String, attribute: 'action-label' })\n  actionLabel = '';\n\n  /**\n   * URL for the optional action link. Requires action-label to render.\n   * @attr action-href\n   */\n  @property({ type: String, attribute: 'action-href' })\n  actionHref = '';\n\n  /**\n   * Whether the banner is visible. Defaults to true — banners are shown by default.\n   * @attr open\n   */\n  @property({ type: Boolean, reflect: true })\n  open = true;\n\n  /** Accessible label for the dismiss button. Override for localized text. */\n  @property({ type: String, attribute: 'label-close' })\n  labelClose = 'Dismiss banner';\n\n  /**\n   * Override for the severity prefix announced to screen readers (e.g., \"Info:\", \"Error:\").\n   * When not set, defaults to the English label matching the current variant.\n   * @attr severity-label\n   */\n  @property({ attribute: 'severity-label' })\n  severityLabel: string | undefined;\n\n  // ─── Private Helpers ───\n\n  /** Returns the default English severity label for the current variant. */\n  private _defaultSeverityLabel(): string {\n    const labels: Record<string, string> = {\n      info: 'Info:',\n      success: 'Success:',\n      warning: 'Warning:',\n      error: 'Error:',\n    };\n    return labels[this.variant] ?? '';\n  }\n\n  /** Returns the effective severity label, using the override if provided. */\n  private get _effectiveSeverityLabel(): string {\n    return this.severityLabel ?? this._defaultSeverityLabel();\n  }\n\n  /** Returns true when the variant requires assertive announcement. */\n  /** @internal */\n  private get _isAssertive(): boolean {\n    return this.variant === 'error' || this.variant === 'warning';\n  }\n\n  /**\n   * Returns the appropriate ARIA role based on variant.\n   * role=\"alert\" implies aria-live=\"assertive\"; role=\"status\" implies aria-live=\"polite\".\n   * We do NOT set aria-live explicitly to avoid double-announcements in JAWS.\n   */\n  /** @internal */\n  private get _role(): string {\n    return this._isAssertive ? 'alert' : 'status';\n  }\n\n  // ─── Lifecycle ───\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n    // Apply ARIA role to the host element for reliable screen reader support across\n    // Shadow DOM boundaries. Placing role on a shadow-internal element has inconsistent\n    // AT support in JAWS+Chrome and VoiceOver+Safari combinations (particularly pre-2024).\n    this.setAttribute('role', this._role);\n    if (!this.open) {\n      this.setAttribute('aria-hidden', 'true');\n    }\n  }\n\n  protected override updated(changedProperties: PropertyValues<this>): void {\n    super.updated(changedProperties);\n    if (changedProperties.has('variant')) {\n      // Keep host ARIA role in sync with variant (assertive vs. polite).\n      this.setAttribute('role', this._role);\n    }\n    if (changedProperties.has('open')) {\n      // Manage aria-hidden in addition to display:none for reliable AT exclusion.\n      // When open transitions from false→true, removing aria-hidden signals to AT\n      // that the live region content should be announced.\n      if (this.open) {\n        this.removeAttribute('aria-hidden');\n      } else {\n        this.setAttribute('aria-hidden', 'true');\n      }\n    }\n  }\n\n  // ─── Default Icons ───\n\n  /** @internal */\n  private _renderInfoIcon() {\n    return html`<svg viewBox=\"0 0 20 20\" aria-hidden=\"true\">\n      <path\n        d=\"M10 2a8 8 0 100 16 8 8 0 000-16zm.75 4.75a.75.75 0 11-1.5 0 .75.75 0 011.5 0zM9.25 9a.75.75 0 011.5 0v4a.75.75 0 01-1.5 0V9z\"\n      />\n    </svg>`;\n  }\n\n  /** @internal */\n  private _renderSuccessIcon() {\n    return html`<svg viewBox=\"0 0 20 20\" aria-hidden=\"true\">\n      <path\n        d=\"M10 2a8 8 0 100 16 8 8 0 000-16zm3.03 6.28a.75.75 0 00-1.06-1.06L9 10.19 7.78 8.97a.75.75 0 00-1.06 1.06l1.75 1.75a.75.75 0 001.06 0l3.5-3.5z\"\n      />\n    </svg>`;\n  }\n\n  /** @internal */\n  private _renderWarningIcon() {\n    return html`<svg viewBox=\"0 0 20 20\" aria-hidden=\"true\">\n      <path\n        d=\"M8.49 2.92a1.75 1.75 0 013.02 0l6.25 10.83A1.75 1.75 0 0116.25 16H3.75a1.75 1.75 0 01-1.51-2.25L8.49 2.92zM10 7a.75.75 0 01.75.75v3a.75.75 0 01-1.5 0v-3A.75.75 0 0110 7zm0 7.5a.75.75 0 100-1.5.75.75 0 000 1.5z\"\n      />\n    </svg>`;\n  }\n\n  /** @internal */\n  private _renderErrorIcon() {\n    return html`<svg viewBox=\"0 0 20 20\" aria-hidden=\"true\">\n      <path\n        d=\"M10 2a8 8 0 100 16 8 8 0 000-16zm-1.72 5.22a.75.75 0 011.06 0L10 7.94l.66-.72a.75.75 0 111.06 1.06L11.06 9l.66.72a.75.75 0 11-1.06 1.06L10 10.06l-.66.72a.75.75 0 01-1.06-1.06L8.94 9l-.66-.72a.75.75 0 010-1.06z\"\n      />\n    </svg>`;\n  }\n\n  /** @internal */\n  private _renderDefaultIcon() {\n    switch (this.variant) {\n      case 'success':\n        return this._renderSuccessIcon();\n      case 'warning':\n        return this._renderWarningIcon();\n      case 'error':\n        return this._renderErrorIcon();\n      case 'info':\n      default:\n        return this._renderInfoIcon();\n    }\n  }\n\n  /** @internal */\n  private _renderCloseIcon() {\n    return html`<svg viewBox=\"0 0 20 20\" aria-hidden=\"true\">\n      <path\n        d=\"M6.28 5.22a.75.75 0 00-1.06 1.06L8.94 10l-3.72 3.72a.75.75 0 101.06 1.06L10 11.06l3.72 3.72a.75.75 0 101.06-1.06L11.06 10l3.72-3.72a.75.75 0 00-1.06-1.06L10 8.94 6.28 5.22z\"\n      />\n    </svg>`;\n  }\n\n  // ─── Public Methods ───\n\n  /**\n   * Programmatically dismisses the banner. Sets open=false and dispatches hx-dismiss.\n   */\n  dismiss(): void {\n    this._handleDismiss();\n  }\n\n  // ─── Event Handling ───\n\n  /** @internal */\n  private _handleDismiss(): void {\n    this.open = false;\n\n    /**\n     * Dispatched when the user (or caller) dismisses the banner.\n     * @event hx-dismiss\n     */\n    this.dispatchEvent(\n      new CustomEvent<{ reason: string }>('hx-dismiss', {\n        bubbles: true,\n        composed: true,\n        detail: { reason: 'user' },\n      }),\n    );\n  }\n\n  // ─── Render ───\n\n  override render() {\n    const classes = {\n      banner: true,\n      [`banner--${this.variant}`]: true,\n    };\n\n    const hasAction = this.actionLabel.length > 0 && this.actionHref.length > 0;\n\n    // WCAG 1.4.1: Always render a visually-hidden severity label so the variant\n    // is never conveyed by color alone.\n    const severityLabel = this._effectiveSeverityLabel;\n\n    return html`\n      <div part=\"banner\" class=${classMap(classes)}>\n        <span class=\"banner__severity-label\">${severityLabel}</span>\n        <div part=\"icon\" class=\"banner__icon\">${this._renderDefaultIcon()}</div>\n\n        <div part=\"message\" class=\"banner__message\">\n          <slot></slot>\n        </div>\n\n        ${hasAction\n          ? html`\n              <a\n                part=\"action\"\n                class=\"banner__action\"\n                href=${ifDefined(this.actionHref || undefined)}\n                aria-label=${this.heading\n                  ? `${this.actionLabel}: ${this.heading}`\n                  : this.actionLabel}\n              >\n                <slot name=\"action\">${this.actionLabel}</slot>\n              </a>\n            `\n          : nothing}\n        ${this.dismissible\n          ? html`\n              <button\n                part=\"close-button\"\n                class=\"banner__close-button\"\n                aria-label=${this.labelClose}\n                @click=${this._handleDismiss}\n              >\n                ${this._renderCloseIcon()}\n              </button>\n            `\n          : nothing}\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-banner': HelixBanner;\n  }\n}\n\nexport type { HelixBanner as HxBanner };\n"],"names":["helixBannerStyles","css","HelixBanner","LitElement","changedProperties","html","classes","hasAction","severityLabel","classMap","ifDefined","nothing","tokenStyles","__decorateClass","property","customElement"],"mappings":"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"}