@helixui/library 1.0.1 → 1.1.2-next.1

package/dist/shared/hx-split-panel-Bss54UN8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-split-panel-Bss54UN8.js","sources":["../../src/components/hx-split-panel/hx-split-panel.styles.ts","../../src/components/hx-split-panel/hx-split-panel.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixSplitPanelStyles = css`\n  :host {\n    display: flex;\n    --_divider-size: var(--hx-split-panel-divider-size, 4px);\n    --_divider-color: var(--hx-split-panel-divider-color, var(--hx-color-neutral-200));\n    --_divider-hover-color: var(--hx-split-panel-divider-hover-color, var(--hx-color-primary-500));\n    overflow: hidden;\n  }\n\n  :host([orientation='horizontal']) {\n    flex-direction: row;\n    width: 100%;\n    height: 100%;\n  }\n\n  :host([orientation='vertical']) {\n    flex-direction: column;\n    width: 100%;\n    height: 100%;\n  }\n\n  .panel {\n    overflow: auto;\n    min-width: 0;\n    min-height: 0;\n  }\n\n  .panel--start {\n    flex-shrink: 0;\n  }\n\n  .panel--end {\n    flex: 1;\n  }\n\n  :host([orientation='horizontal']) .panel--start {\n    height: 100%;\n  }\n\n  :host([orientation='vertical']) .panel--start {\n    width: 100%;\n  }\n\n  /* ─── Divider Track (flex child wrapper) ─── */\n\n  .divider-track {\n    flex-shrink: 0;\n    position: relative;\n    overflow: visible;\n    display: flex;\n    align-items: stretch;\n  }\n\n  :host([orientation='horizontal']) .divider-track {\n    width: var(--_divider-size);\n    height: 100%;\n  }\n\n  :host([orientation='vertical']) .divider-track {\n    width: 100%;\n    height: var(--_divider-size);\n  }\n\n  /* ─── Divider (separator role — no interactive children) ─── */\n\n  .divider {\n    flex: 1;\n    background-color: var(--_divider-color);\n    cursor: col-resize;\n    transition: background-color var(--hx-transition-fast, 150ms ease);\n    touch-action: none;\n    user-select: none;\n    -webkit-user-select: none;\n    outline: none;\n  }\n\n  :host([orientation='horizontal']) .divider {\n    cursor: col-resize;\n  }\n\n  :host([orientation='vertical']) .divider {\n    cursor: row-resize;\n  }\n\n  .divider:hover,\n  .divider:focus-visible {\n    background-color: var(--_divider-hover-color);\n  }\n\n  .divider:focus-visible {\n    outline: var(--hx-focus-ring-width, 2px) solid\n      var(\n        --hx-split-panel-focus-ring-color,\n        var(--hx-focus-ring-color, var(--hx-color-primary-500))\n      );\n    outline-offset: var(--hx-focus-ring-offset, 2px);\n    box-shadow: 0 0 0 4px color-mix(in srgb, var(--_divider-hover-color) 30%, transparent);\n  }\n\n  :host([disabled]) .divider {\n    cursor: default;\n    pointer-events: none;\n  }\n\n  :host([disabled]) .divider:hover,\n  :host([disabled]) .divider:focus-visible {\n    background-color: var(--_divider-color);\n    outline: none;\n    box-shadow: none;\n  }\n\n  /* ─── Collapse Controls (siblings of separator, not children) ─── */\n\n  .collapse-controls {\n    position: absolute;\n    top: 50%;\n    inset-inline-start: 50%;\n    transform: translate(-50%, -50%);\n    display: flex;\n    flex-direction: column;\n    align-items: center;\n    gap: var(--hx-space-1, 0.25rem);\n    z-index: 2;\n    pointer-events: auto;\n  }\n\n  :host([orientation='vertical']) .collapse-controls {\n    flex-direction: row;\n  }\n\n  .collapse-btn {\n    background: var(--_divider-hover-color);\n    border: 2px solid var(--hx-color-neutral-0);\n    color: var(--hx-color-neutral-0);\n    width: var(--hx-size-5, 1.25rem);\n    height: var(--hx-size-5, 1.25rem);\n    border-radius: 50%;\n    cursor: pointer;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    font-size: var(--hx-split-panel-btn-icon-size, 0.5rem);\n    padding: 0;\n    line-height: 1;\n    flex-shrink: 0;\n    /* WCAG 2.5.5: minimum 44×44px touch target via transparent hit-area */\n    min-width: var(--hx-touch-target-min, 2.75rem);\n    min-height: var(--hx-touch-target-min, 2.75rem);\n  }\n\n  .collapse-btn:hover {\n    filter: brightness(1.1);\n  }\n\n  .collapse-btn:focus-visible {\n    outline: var(--hx-focus-ring-width, 2px) solid\n      var(\n        --hx-split-panel-focus-ring-color,\n        var(--hx-focus-ring-color, var(--hx-color-primary-500))\n      );\n    outline-offset: var(--hx-focus-ring-offset, 2px);\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    .divider {\n      transition: none;\n    }\n  }\n`;\n","import { LitElement, html, nothing, type PropertyValues } from 'lit';\nimport { customElement, property } from 'lit/decorators.js';\nimport { styleMap } from 'lit/directives/style-map.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { helixSplitPanelStyles } from './hx-split-panel.styles.js';\n\n/**\n * A resizable two-pane layout with a draggable divider.\n *\n * @summary Resizable split panel with start and end panes.\n *\n * @tag hx-split-panel\n *\n * @slot start - The first (start) panel content.\n * @slot end - The second (end) panel content.\n *\n * @csspart start - The start panel container.\n * @csspart divider - The draggable divider element.\n * @csspart end - The end panel container.\n *\n * @fires hx-reposition - Fired when the divider is moved. Detail: `{ position: number }`.\n *\n * @cssprop [--hx-split-panel-divider-size=4px] - Width (horizontal) or height (vertical) of the divider.\n * @cssprop [--hx-split-panel-divider-color=var(--hx-color-neutral-200)] - Default divider color.\n * @cssprop [--hx-split-panel-divider-hover-color=var(--hx-color-primary-500)] - Divider color on hover/focus.\n *\n * @example Drupal Twig usage:\n * ```twig\n * <hx-split-panel\n *   position=\"50\"\n *   orientation=\"horizontal\"\n *   min=\"10\"\n *   max=\"90\"\n *   collapsible\n * >\n *   <div slot=\"start\">{{ start_content }}</div>\n *   <div slot=\"end\">{{ end_content }}</div>\n * </hx-split-panel>\n *\n * Attribute-settable: position, position-in-pixels, orientation, disabled, min, max, collapsible, collapsed\n * JS-only (complex types): snap (use .snap=${[25, 50, 75]} in Lit templates,\n *   or snap=\"[25,50,75]\" as JSON string in Twig)\n * ```\n */\n@customElement('hx-split-panel')\nexport class HelixSplitPanel extends LitElement {\n  static override styles = [tokenStyles, helixSplitPanelStyles];\n\n  /**\n   * Position of the divider as a percentage (0–100) of the start panel.\n   * @attr position\n   */\n  @property({ type: Number, reflect: true })\n  position = 50;\n\n  /**\n   * Position of the divider in pixels (alternative to `position`).\n   * When set, takes precedence over `position` until the host is measured.\n   * @attr position-in-pixels\n   */\n  @property({ type: Number, attribute: 'position-in-pixels' })\n  positionInPixels: number | undefined;\n\n  /**\n   * Orientation of the split.\n   * @attr orientation\n   */\n  @property({ type: String, reflect: true })\n  orientation: 'horizontal' | 'vertical' = 'horizontal';\n\n  /**\n   * Minimum position as a percentage (0–100). Prevents full collapse of start panel.\n   * @attr min\n   */\n  @property({ type: Number, reflect: true })\n  min = 0;\n\n  /**\n   * Maximum position as a percentage (0–100). Prevents full expansion of start panel.\n   * @attr max\n   */\n  @property({ type: Number, reflect: true })\n  max = 100;\n\n  /**\n   * Snap points as an array of percentages. The divider snaps to the\n   * nearest point within a 5% threshold.\n   * Accepts JSON array string in HTML: snap=\"[25, 50, 75]\"\n   * @attr snap\n   */\n  @property({\n    attribute: 'snap',\n    converter: {\n      fromAttribute(value: string | null): number[] {\n        if (!value) return [];\n        try {\n          const parsed = JSON.parse(value) as unknown;\n          if (Array.isArray(parsed)) return (parsed as unknown[]).map(Number);\n          return [];\n        } catch {\n          return value\n            .split(',')\n            .map((s) => Number(s.trim()))\n            .filter((n) => !isNaN(n));\n        }\n      },\n      toAttribute(value: number[]): string {\n        return JSON.stringify(value);\n      },\n    },\n  })\n  snap: number[] = [];\n\n  /**\n   * When true, the divider cannot be dragged.\n   * @attr disabled\n   */\n  @property({ type: Boolean, reflect: true })\n  disabled = false;\n\n  /**\n   * When true, collapse/expand buttons appear on the divider.\n   * @attr collapsible\n   */\n  @property({ type: Boolean, reflect: true })\n  collapsible = false;\n\n  /**\n   * Which panel is collapsed: 'start', 'end', or null (not collapsed).\n   * @attr collapsed\n   */\n  @property({ type: String, reflect: true })\n  collapsed: 'start' | 'end' | null = null;\n\n  /**\n   * Accessible label for the divider separator element.\n   * @attr resize-label\n   */\n  @property({ attribute: 'resize-label' })\n  resizeLabel = 'Resize panels';\n\n  /**\n   * Accessible label for the button that collapses the start panel.\n   * @attr collapse-start-label\n   */\n  @property({ attribute: 'collapse-start-label' })\n  collapseStartLabel = 'Collapse start panel';\n\n  /**\n   * Accessible label for the button that collapses the end panel.\n   * @attr collapse-end-label\n   */\n  @property({ attribute: 'collapse-end-label' })\n  collapseEndLabel = 'Collapse end panel';\n\n  /**\n   * Whether the user is currently dragging the divider.\n   * @internal\n   */\n  private _dragging = false;\n  /**\n   * The pointer coordinate (clientX or clientY) at the start of a drag gesture.\n   * @internal\n   */\n  private _dragStart = 0;\n  /**\n   * The divider position percentage at the moment a drag gesture begins, used to compute deltas.\n   * @internal\n   */\n  private _positionAtDragStart = 0;\n  /**\n   * The position saved before a collapse occurs, restored when the panel is expanded.\n   * @internal\n   */\n  private _positionBeforeCollapse = 50;\n  /**\n   * Cached container width measured once at drag start to avoid layout thrash on every pointermove.\n   * @internal\n   */\n  private _cachedContainerWidth = 0;\n  /**\n   * Cached container height measured once at drag start to avoid layout thrash on every pointermove.\n   * @internal\n   */\n  private _cachedContainerHeight = 0;\n\n  /** @internal */\n  private _clamp(value: number): number {\n    return Math.min(this.max, Math.max(this.min, value));\n  }\n\n  /** @internal */\n  private _snapToPoint(value: number): number {\n    if (!this.snap.length) return value;\n    const threshold = 5;\n    for (const point of this.snap) {\n      if (Math.abs(value - point) <= threshold) return point;\n    }\n    return value;\n  }\n\n  /** @internal */\n  private _setPosition(percent: number): void {\n    const clamped = this._clamp(this._snapToPoint(percent));\n    if (clamped === this.position) return;\n    this.position = clamped;\n    this.dispatchEvent(\n      new CustomEvent<{ position: number }>('hx-reposition', {\n        detail: { position: this.position },\n        bubbles: true,\n        composed: true,\n      }),\n    );\n  }\n\n  /** @internal */\n  private _getHostSize(): number {\n    if (this.orientation === 'horizontal') {\n      return this.offsetWidth;\n    }\n    return this.offsetHeight;\n  }\n\n  /**\n   * Initiates a drag gesture when the divider receives a pointerdown event.\n   * @internal\n   */\n  private _onPointerDown = (e: PointerEvent): void => {\n    if (this.disabled) return;\n    const divider = e.currentTarget as HTMLElement;\n    divider.setPointerCapture(e.pointerId);\n    this._dragging = true;\n    this._dragStart = this.orientation === 'horizontal' ? e.clientX : e.clientY;\n    this._positionAtDragStart = this.position;\n    // Cache container dimensions once at drag start to avoid forced layout on every pointermove\n    this._cachedContainerWidth = this.offsetWidth;\n    this._cachedContainerHeight = this.offsetHeight;\n    e.preventDefault();\n  };\n\n  /**\n   * Updates the divider position during an active drag gesture.\n   * @internal\n   */\n  private _onPointerMove = (e: PointerEvent): void => {\n    if (!this._dragging) return;\n    const current = this.orientation === 'horizontal' ? e.clientX : e.clientY;\n    const delta = current - this._dragStart;\n    const hostSize =\n      this.orientation === 'horizontal' ? this._cachedContainerWidth : this._cachedContainerHeight;\n    if (hostSize === 0) return;\n    const deltaPercent = (delta / hostSize) * 100;\n    this._setPosition(this._positionAtDragStart + deltaPercent);\n  };\n\n  /**\n   * Ends the drag gesture when the pointer is released.\n   * @internal\n   */\n  private _onPointerUp = (): void => {\n    this._dragging = false;\n    this._cachedContainerWidth = 0;\n    this._cachedContainerHeight = 0;\n  };\n\n  /**\n   * Handles keyboard navigation on the divider — arrow keys adjust position, Home/End jump to min/max.\n   * @internal\n   */\n  private _onKeyDown = (e: KeyboardEvent): void => {\n    if (this.disabled) return;\n    switch (e.key) {\n      case 'ArrowLeft':\n      case 'ArrowUp':\n        e.preventDefault();\n        this._setPosition(this.position - 1);\n        break;\n      case 'ArrowRight':\n      case 'ArrowDown':\n        e.preventDefault();\n        this._setPosition(this.position + 1);\n        break;\n      case 'PageUp':\n        e.preventDefault();\n        this._setPosition(this.position + 10);\n        break;\n      case 'PageDown':\n        e.preventDefault();\n        this._setPosition(this.position - 10);\n        break;\n      case 'Home':\n        e.preventDefault();\n        this._setPosition(this.min);\n        break;\n      case 'End':\n        e.preventDefault();\n        this._setPosition(this.max);\n        break;\n    }\n  };\n\n  /**\n   * Collapses the start panel by setting `collapsed` to `'start'`.\n   * @internal\n   */\n  private _collapseStart = (): void => {\n    this.collapsed = 'start';\n  };\n\n  /**\n   * Collapses the end panel by setting `collapsed` to `'end'`.\n   * @internal\n   */\n  private _collapseEnd = (): void => {\n    this.collapsed = 'end';\n  };\n\n  /**\n   * Expands a collapsed panel by resetting `collapsed` to null.\n   * @internal\n   */\n  private _expand = (): void => {\n    this.collapsed = null;\n  };\n\n  protected override willUpdate(changedProperties: PropertyValues<this>): void {\n    super.willUpdate(changedProperties);\n    if (!changedProperties.has('collapsed')) return;\n\n    const prev = changedProperties.get('collapsed');\n\n    if (this.collapsed === 'start') {\n      // Save restore point when transitioning from non-collapsed state (or initial render)\n      if (prev === null || prev === undefined) this._positionBeforeCollapse = this.position;\n      this._setPosition(this.min);\n    } else if (this.collapsed === 'end') {\n      if (prev === null || prev === undefined) this._positionBeforeCollapse = this.position;\n      this._setPosition(this.max);\n    } else if (this.collapsed === null && prev !== null && prev !== undefined) {\n      // Only expand when transitioning from an explicitly collapsed state (not first render)\n      this._setPosition(this._positionBeforeCollapse);\n    }\n  }\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n    if (this.positionInPixels !== undefined) {\n      // Convert pixel position to percentage after first paint\n      if (typeof requestAnimationFrame !== 'undefined') {\n        requestAnimationFrame(() => {\n          if (this.positionInPixels !== undefined) {\n            const hostSize = this._getHostSize();\n            if (hostSize > 0) {\n              this._setPosition((this.positionInPixels / hostSize) * 100);\n            }\n          }\n        });\n      }\n    }\n  }\n\n  /** @internal */\n  private _startPanelStyleMap(): Record<string, string> {\n    if (this.orientation === 'horizontal') {\n      return { width: `${this.position}%` };\n    }\n    return { height: `${this.position}%` };\n  }\n\n  override render() {\n    return html`\n      <div part=\"start\" class=\"panel panel--start\" style=${styleMap(this._startPanelStyleMap())}>\n        <slot name=\"start\"></slot>\n      </div>\n      <div class=\"divider-track\">\n        <div\n          part=\"divider\"\n          class=\"divider\"\n          role=\"separator\"\n          aria-label=${this.resizeLabel}\n          aria-orientation=${this.orientation === 'horizontal' ? 'vertical' : 'horizontal'}\n          aria-valuenow=${this.position}\n          aria-valuemin=${this.min}\n          aria-valuemax=${this.max}\n          aria-disabled=${this.disabled ? 'true' : nothing}\n          tabindex=${this.disabled ? '-1' : '0'}\n          @pointerdown=${this._onPointerDown}\n          @pointermove=${this._onPointerMove}\n          @pointerup=${this._onPointerUp}\n          @keydown=${this._onKeyDown}\n        ></div>\n        ${this.collapsible\n          ? this.collapsed\n            ? html`<div class=\"collapse-controls\">\n                <button\n                  type=\"button\"\n                  class=\"collapse-btn\"\n                  aria-label=${`Expand ${this.collapsed} panel`}\n                  @click=${this._expand}\n                >\n                  ${this.collapsed === 'start' ? '▶' : '◀'}\n                </button>\n              </div>`\n            : html`<div class=\"collapse-controls\">\n                <button\n                  type=\"button\"\n                  class=\"collapse-btn\"\n                  aria-label=${this.collapseStartLabel}\n                  @click=${this._collapseStart}\n                >\n                  ◀\n                </button>\n                <button\n                  type=\"button\"\n                  class=\"collapse-btn\"\n                  aria-label=${this.collapseEndLabel}\n                  @click=${this._collapseEnd}\n                >\n                  ▶\n                </button>\n              </div>`\n          : nothing}\n      </div>\n      <div part=\"end\" class=\"panel panel--end\">\n        <slot name=\"end\"></slot>\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-split-panel': HelixSplitPanel;\n  }\n}\n"],"names":["helixSplitPanelStyles","css","HelixSplitPanel","LitElement","e","delta","hostSize","deltaPercent","value","threshold","point","percent","clamped","changedProperties","prev","html","styleMap","nothing","tokenStyles","__decorateClass","property","parsed","s","n","customElement"],"mappings":"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"}

package/dist/shared/{hx-stack-CfoW7jU7.js → hx-stack-BStY1RmV.js}

@@ -1,7 +1,7 @@
 import { css as c, LitElement as h, html as f } from "lit";
-import { property as a, customElement as g } from "lit/decorators.js";
-import { tokenStyles as y } from "@helixui/tokens/lit";
-const u = c`
+import { property as s, customElement as y } from "lit/decorators.js";
+import { tokenStyles as u } from "@helixui/tokens/lit";
+const b = c`
   :host {
     display: block;
   }
@@ -13,7 +13,7 @@ const u = c`
   [part='base'] {
     display: flex;
     flex-direction: column;
-    gap: var(--hx-spacing-md, 1rem);
+    gap: var(--hx-space-4, 1rem);
   }
 
   /* ─── Direction ─── */
@@ -87,29 +87,29 @@ const u = c`
   }
 
   :host([gap='xs']) [part='base'] {
-    gap: var(--hx-spacing-xs, 0.25rem);
+    gap: var(--hx-space-1, 0.25rem);
   }
 
   :host([gap='sm']) [part='base'] {
-    gap: var(--hx-spacing-sm, 0.5rem);
+    gap: var(--hx-space-2, 0.5rem);
   }
 
   :host([gap='md']) [part='base'] {
-    gap: var(--hx-spacing-md, 1rem);
+    gap: var(--hx-space-4, 1rem);
   }
 
   :host([gap='lg']) [part='base'] {
-    gap: var(--hx-spacing-lg, 1.5rem);
+    gap: var(--hx-space-6, 1.5rem);
   }
 
   :host([gap='xl']) [part='base'] {
-    gap: var(--hx-spacing-xl, 2rem);
+    gap: var(--hx-space-8, 2rem);
   }
 `;
-var b = Object.defineProperty, m = Object.getOwnPropertyDescriptor, s = (l, r, n, i) => {
-  for (var e = i > 1 ? void 0 : i ? m(r, n) : r, p = l.length - 1, o; p >= 0; p--)
-    (o = l[p]) && (e = (i ? o(r, n, e) : o(e)) || e);
-  return i && e && b(r, n, e), e;
+var g = Object.defineProperty, m = Object.getOwnPropertyDescriptor, a = (l, r, p, i) => {
+  for (var e = i > 1 ? void 0 : i ? m(r, p) : r, n = l.length - 1, o; n >= 0; n--)
+    (o = l[n]) && (e = (i ? o(r, p, e) : o(e)) || e);
+  return i && e && g(r, p, e), e;
 };
 let t = class extends h {
   constructor() {
@@ -146,29 +146,29 @@ let t = class extends h {
     `;
   }
 };
-t.styles = [y, u];
-s([
-  a({ type: String, reflect: !0 })
+t.styles = [u, b];
+a([
+  s({ type: String, reflect: !0 })
 ], t.prototype, "direction", 2);
-s([
-  a({ type: String, reflect: !0 })
+a([
+  s({ type: String, reflect: !0 })
 ], t.prototype, "gap", 2);
-s([
-  a({ type: String, reflect: !0 })
+a([
+  s({ type: String, reflect: !0 })
 ], t.prototype, "align", 2);
-s([
-  a({ type: String, reflect: !0 })
+a([
+  s({ type: String, reflect: !0 })
 ], t.prototype, "justify", 2);
-s([
-  a({ type: Boolean, reflect: !0 })
+a([
+  s({ type: Boolean, reflect: !0 })
 ], t.prototype, "wrap", 2);
-s([
-  a({ type: Boolean, reflect: !0 })
+a([
+  s({ type: Boolean, reflect: !0 })
 ], t.prototype, "inline", 2);
-t = s([
-  g("hx-stack")
+t = a([
+  y("hx-stack")
 ], t);
 export {
   t as H
 };
-//# sourceMappingURL=hx-stack-CfoW7jU7.js.map
+//# sourceMappingURL=hx-stack-BStY1RmV.js.map

package/dist/shared/hx-stack-BStY1RmV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-stack-BStY1RmV.js","sources":["../../src/components/hx-stack/hx-stack.styles.ts","../../src/components/hx-stack/hx-stack.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixStackStyles = css`\n  :host {\n    display: block;\n  }\n\n  :host([inline]) {\n    display: inline-block;\n  }\n\n  [part='base'] {\n    display: flex;\n    flex-direction: column;\n    gap: var(--hx-space-4, 1rem);\n  }\n\n  /* ─── Direction ─── */\n\n  :host([direction='horizontal']) [part='base'] {\n    flex-direction: row;\n  }\n\n  :host([direction='vertical']) [part='base'] {\n    flex-direction: column;\n  }\n\n  /* ─── Wrap ─── */\n\n  :host([wrap]) [part='base'] {\n    flex-wrap: wrap;\n  }\n\n  /* ─── Alignment ─── */\n\n  :host([align='start']) [part='base'] {\n    align-items: flex-start;\n  }\n\n  :host([align='center']) [part='base'] {\n    align-items: center;\n  }\n\n  :host([align='end']) [part='base'] {\n    align-items: flex-end;\n  }\n\n  :host([align='stretch']) [part='base'] {\n    align-items: stretch;\n  }\n\n  :host([align='baseline']) [part='base'] {\n    align-items: baseline;\n  }\n\n  /* ─── Justify ─── */\n\n  :host([justify='start']) [part='base'] {\n    justify-content: flex-start;\n  }\n\n  :host([justify='center']) [part='base'] {\n    justify-content: center;\n  }\n\n  :host([justify='end']) [part='base'] {\n    justify-content: flex-end;\n  }\n\n  :host([justify='between']) [part='base'] {\n    justify-content: space-between;\n  }\n\n  :host([justify='around']) [part='base'] {\n    justify-content: space-around;\n  }\n\n  :host([justify='evenly']) [part='base'] {\n    justify-content: space-evenly;\n  }\n\n  /* ─── Gap ─── */\n\n  :host([gap='none']) [part='base'] {\n    gap: 0;\n  }\n\n  :host([gap='xs']) [part='base'] {\n    gap: var(--hx-space-1, 0.25rem);\n  }\n\n  :host([gap='sm']) [part='base'] {\n    gap: var(--hx-space-2, 0.5rem);\n  }\n\n  :host([gap='md']) [part='base'] {\n    gap: var(--hx-space-4, 1rem);\n  }\n\n  :host([gap='lg']) [part='base'] {\n    gap: var(--hx-space-6, 1.5rem);\n  }\n\n  :host([gap='xl']) [part='base'] {\n    gap: var(--hx-space-8, 2rem);\n  }\n`;\n","import { LitElement, html } from 'lit';\nimport { customElement, property } from 'lit/decorators.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { helixStackStyles } from './hx-stack.styles.js';\n\n/**\n * A flexbox layout wrapper for consistent vertical/horizontal spacing between children.\n *\n * @summary Flexbox stack layout utility for arranging children with consistent spacing.\n *\n * @tag hx-stack\n *\n * @slot - Default slot for any child content.\n *\n * @csspart base - The inner flex container.\n */\n@customElement('hx-stack')\nexport class HelixStack extends LitElement {\n  static override styles = [tokenStyles, helixStackStyles];\n\n  /**\n   * Direction of the stack layout.\n   * @attr direction\n   */\n  @property({ type: String, reflect: true })\n  direction: 'horizontal' | 'vertical' = 'vertical';\n\n  /**\n   * Gap between children using design tokens.\n   * @attr gap\n   */\n  @property({ type: String, reflect: true })\n  gap: 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' = 'md';\n\n  /**\n   * Align-items value for cross-axis alignment.\n   * @attr align\n   */\n  @property({ type: String, reflect: true })\n  align: 'start' | 'center' | 'end' | 'stretch' | 'baseline' = 'stretch';\n\n  /**\n   * Justify-content value for main-axis distribution.\n   * @attr justify\n   */\n  @property({ type: String, reflect: true })\n  justify: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly' = 'start';\n\n  /**\n   * When true, children wrap onto multiple lines.\n   * @attr wrap\n   */\n  @property({ type: Boolean, reflect: true })\n  wrap = false;\n\n  /**\n   * When true, the component renders as `display: inline-flex`.\n   * @attr inline\n   */\n  @property({ type: Boolean, reflect: true })\n  inline = false;\n\n  /**\n   * Sets `role=\"presentation\"` on connect so assistive technologies treat this\n   * element as a purely visual layout wrapper with no semantic meaning. This\n   * suppresses any implicit ARIA role that a custom element might otherwise\n   * inherit, preventing screen readers from announcing \"group\" or \"region\"\n   * for what is purely a spacing/alignment container.\n   *\n   * **Consumer override:** If you need a semantic grouping role (e.g. for a\n   * form fieldset equivalent), set `role=\"group\"` or any other ARIA role\n   * directly on the element — the guard `!this.hasAttribute('role')` ensures\n   * the component will not overwrite it.\n   *\n   * @example\n   * <!-- Layout stack — role=\"presentation\" applied automatically -->\n   * <hx-stack gap=\"md\">...</hx-stack>\n   *\n   * @example\n   * <!-- Semantic group — consumer role preserved -->\n   * <hx-stack role=\"group\" aria-labelledby=\"form-heading\" gap=\"md\">...</hx-stack>\n   */\n  override connectedCallback(): void {\n    super.connectedCallback();\n    if (!this.hasAttribute('role')) {\n      this.setAttribute('role', 'presentation');\n    }\n  }\n\n  override render() {\n    return html`\n      <div part=\"base\">\n        <slot></slot>\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-stack': HelixStack;\n  }\n}\n"],"names":["helixStackStyles","css","HelixStack","LitElement","html","tokenStyles","__decorateClass","property","customElement"],"mappings":";;;AAEO,MAAMA,IAAmBC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;;;;ACezB,IAAMC,IAAN,cAAyBC,EAAW;AAAA,EAApC,cAAA;AAAA,UAAA,GAAA,SAAA,GAQL,KAAA,YAAuC,YAOvC,KAAA,MAAiD,MAOjD,KAAA,QAA6D,WAO7D,KAAA,UAAwE,SAOxE,KAAA,OAAO,IAOP,KAAA,SAAS;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBA,oBAA0B;AACjC,UAAM,kBAAA,GACD,KAAK,aAAa,MAAM,KAC3B,KAAK,aAAa,QAAQ,cAAc;AAAA,EAE5C;AAAA,EAES,SAAS;AAChB,WAAOC;AAAA;AAAA;AAAA;AAAA;AAAA,EAKT;AACF;AA/EaF,EACK,SAAS,CAACG,GAAaL,CAAgB;AAOvDM,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM;AAAA,GAP9BL,EAQX,WAAA,aAAA,CAAA;AAOAI,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM;AAAA,GAd9BL,EAeX,WAAA,OAAA,CAAA;AAOAI,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM;AAAA,GArB9BL,EAsBX,WAAA,SAAA,CAAA;AAOAI,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM;AAAA,GA5B9BL,EA6BX,WAAA,WAAA,CAAA;AAOAI,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,SAAS,SAAS,IAAM;AAAA,GAnC/BL,EAoCX,WAAA,QAAA,CAAA;AAOAI,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,SAAS,SAAS,IAAM;AAAA,GA1C/BL,EA2CX,WAAA,UAAA,CAAA;AA3CWA,IAANI,EAAA;AAAA,EADNE,EAAc,UAAU;AAAA,GACZN,CAAA;"}

package/dist/shared/{hx-stat-C2wfph8W.js → hx-stat-CmkCUI8v.js}

@@ -1,8 +1,8 @@
-import { css as c, LitElement as v, html as n, nothing as p } from "lit";
+import { css as v, LitElement as p, html as i, nothing as c } from "lit";
 import { property as l, state as f, customElement as x } from "lit/decorators.js";
-import { classMap as g } from "lit/directives/class-map.js";
-import { tokenStyles as _ } from "@helixui/tokens/lit";
-const m = c`
+import { classMap as u } from "lit/directives/class-map.js";
+import { tokenStyles as g } from "@helixui/tokens/lit";
+const _ = v`
   :host {
     display: block;
   }
@@ -109,22 +109,30 @@ const m = c`
     display: none !important;
   }
 `;
-var u = Object.defineProperty, w = Object.getOwnPropertyDescriptor, s = (t, e, i, o) => {
-  for (var a = o > 1 ? void 0 : o ? w(e, i) : e, h = t.length - 1, d; h >= 0; h--)
-    (d = t[h]) && (a = (o ? d(e, i, a) : d(a)) || a);
-  return o && a && u(e, i, a), a;
+var m = Object.defineProperty, b = Object.getOwnPropertyDescriptor, s = (t, r, o, n) => {
+  for (var a = n > 1 ? void 0 : n ? b(r, o) : r, h = t.length - 1, d; h >= 0; h--)
+    (d = t[h]) && (a = (n ? d(r, o, a) : d(a)) || a);
+  return n && a && m(r, o, a), a;
 };
-let r = class extends v {
+let e = class extends p {
   constructor() {
-    super(...arguments), this.label = "", this.value = "", this.trend = "neutral", this.size = "md", this._hasIcon = !1;
+    super(...arguments), this.label = "", this.value = "", this.trend = "neutral", this.size = "md", this.labelTrend = "Trend", this._hasIcon = !1;
   }
+  // ─── Lifecycle ───
+  connectedCallback() {
+    super.connectedCallback();
+    const t = this.getAttribute("size");
+    t !== null && !this.hasAttribute("hx-size") && (this.size = t);
+  }
+  /** @internal */
   _onIconSlotChange(t) {
-    const e = t.target;
-    this._hasIcon = e.assignedNodes({ flatten: !0 }).length > 0;
+    const r = t.target;
+    this._hasIcon = r.assignedNodes({ flatten: !0 }).length > 0;
   }
   // ─── Render Helpers ───
+  /** @internal */
   _renderTrendArrow(t) {
-    return t === "up" ? n`
+    return t === "up" ? i`
         <svg
           class="stat__trend-arrow"
           aria-hidden="true"
@@ -140,7 +148,7 @@ let r = class extends v {
             stroke-linejoin="round"
           />
         </svg>
-      ` : n`
+      ` : i`
       <svg
         class="stat__trend-arrow"
         aria-hidden="true"
@@ -163,50 +171,58 @@ let r = class extends v {
     const t = {
       stat: !0,
       [`stat--${this.size}`]: !0
-    }, e = this.trend !== "neutral";
-    return n`
-      <div part="container" class=${g(t)}>
+    }, r = this.trend !== "neutral", o = this.value && this.label ? `${this.value}: ${this.label}` : this.value || this.label || c;
+    return i`
+      <div
+        part="container"
+        class=${u(t)}
+        role="group"
+        aria-label=${o}
+      >
         <div part="header" class="stat__header">
           <span part="icon" class="stat__icon" ?hidden=${!this._hasIcon}>
             <slot name="icon" @slotchange=${this._onIconSlotChange}></slot>
           </span>
-          <span part="value" class="stat__value">${this.value}</span>
-          ${e ? n`
+          <span part="value" class="stat__value" aria-hidden="true">${this.value}</span>
+          ${r ? i`
                 <span
                   part="trend"
                   class="stat__trend stat__trend--${this.trend}"
                   role="img"
-                  aria-label="Trend: ${this.trend}"
+                  aria-label="${this.labelTrend}: ${this.trend}"
                 >
                   ${this._renderTrendArrow(this.trend)}
                 </span>
-              ` : p}
+              ` : c}
         </div>
-        <span part="label" class="stat__label">${this.label}</span>
+        <span part="label" class="stat__label" aria-hidden="true">${this.label}</span>
       </div>
     `;
   }
 };
-r.styles = [_, m];
+e.styles = [g, _];
 s([
   l({ type: String, reflect: !0 })
-], r.prototype, "label", 2);
+], e.prototype, "label", 2);
 s([
   l({ type: String, reflect: !0 })
-], r.prototype, "value", 2);
+], e.prototype, "value", 2);
 s([
   l({ type: String, reflect: !0 })
-], r.prototype, "trend", 2);
+], e.prototype, "trend", 2);
 s([
-  l({ type: String, reflect: !0 })
-], r.prototype, "size", 2);
+  l({ type: String, reflect: !0, attribute: "hx-size" })
+], e.prototype, "size", 2);
+s([
+  l({ attribute: "label-trend" })
+], e.prototype, "labelTrend", 2);
 s([
   f()
-], r.prototype, "_hasIcon", 2);
-r = s([
+], e.prototype, "_hasIcon", 2);
+e = s([
   x("hx-stat")
-], r);
+], e);
 export {
-  r as H
+  e as H
 };
-//# sourceMappingURL=hx-stat-C2wfph8W.js.map
+//# sourceMappingURL=hx-stat-CmkCUI8v.js.map

package/dist/shared/hx-stat-CmkCUI8v.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-stat-CmkCUI8v.js","sources":["../../src/components/hx-stat/hx-stat.styles.ts","../../src/components/hx-stat/hx-stat.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixStatStyles = css`\n  :host {\n    display: block;\n  }\n\n  .stat {\n    display: flex;\n    flex-direction: column;\n    gap: var(--hx-stat-gap, var(--hx-space-1, 0.25rem));\n    font-family: var(--hx-stat-font-family, var(--hx-font-family-sans, sans-serif));\n    color: var(--hx-stat-color, var(--hx-color-neutral-800, #212529));\n  }\n\n  /* ─── Size Variants ─── */\n\n  .stat--sm .stat__value {\n    font-size: var(--hx-stat-value-font-size-sm, var(--hx-font-size-xl, 1.25rem));\n    line-height: var(--hx-line-height-tight, 1.25);\n    font-weight: var(--hx-stat-value-font-weight, var(--hx-font-weight-bold, 700));\n  }\n\n  .stat--sm .stat__label {\n    font-size: var(--hx-stat-label-font-size-sm, var(--hx-font-size-xs, 0.75rem));\n  }\n\n  .stat--md .stat__value {\n    font-size: var(--hx-stat-value-font-size-md, var(--hx-font-size-3xl, 1.875rem));\n    line-height: var(--hx-line-height-tight, 1.25);\n    font-weight: var(--hx-stat-value-font-weight, var(--hx-font-weight-bold, 700));\n  }\n\n  .stat--md .stat__label {\n    font-size: var(--hx-stat-label-font-size-md, var(--hx-font-size-sm, 0.875rem));\n  }\n\n  .stat--lg .stat__value {\n    font-size: var(--hx-stat-value-font-size-lg, var(--hx-font-size-5xl, 3rem));\n    line-height: var(--hx-line-height-tight, 1.25);\n    font-weight: var(--hx-stat-value-font-weight, var(--hx-font-weight-bold, 700));\n  }\n\n  .stat--lg .stat__label {\n    font-size: var(--hx-stat-label-font-size-lg, var(--hx-font-size-md, 1rem));\n  }\n\n  /* ─── Value ─── */\n\n  .stat__header {\n    display: flex;\n    align-items: center;\n    gap: var(--hx-stat-header-gap, var(--hx-space-2, 0.5rem));\n  }\n\n  .stat__value {\n    color: var(--hx-stat-value-color, var(--hx-color-neutral-900, #111827));\n  }\n\n  /* ─── Label ─── */\n\n  .stat__label {\n    color: var(--hx-stat-label-color, var(--hx-color-neutral-500, #6c757d));\n    font-weight: var(--hx-font-weight-normal, 400);\n  }\n\n  /* ─── Icon Slot ─── */\n\n  .stat__icon {\n    display: flex;\n    align-items: center;\n    color: var(--hx-stat-icon-color, var(--hx-color-primary-500, #2563eb));\n    flex-shrink: 0;\n  }\n\n  /* ─── Trend Indicator ─── */\n\n  .stat__trend {\n    display: inline-flex;\n    align-items: center;\n    gap: var(--hx-space-1, 0.25rem);\n    font-size: var(--hx-font-size-sm, 0.875rem);\n    font-weight: var(--hx-font-weight-semibold, 600);\n    border-radius: var(--hx-border-radius-sm, 0.25rem);\n    padding: var(--hx-space-0-5, 0.125rem) var(--hx-space-1-5, 0.375rem);\n  }\n\n  .stat__trend--up {\n    color: var(--hx-stat-trend-up-color, var(--hx-color-success-700, #15803d));\n    background-color: var(--hx-stat-trend-up-bg, var(--hx-color-success-50, #f0fdf4));\n  }\n\n  .stat__trend--down {\n    color: var(--hx-stat-trend-down-color, var(--hx-color-error-700, #b91c1c));\n    background-color: var(--hx-stat-trend-down-bg, var(--hx-color-error-50, #fef2f2));\n  }\n\n  .stat__trend-arrow {\n    width: 0.75em;\n    height: 0.75em;\n    flex-shrink: 0;\n  }\n\n  /* ─── Hidden empty slot wrappers ─── */\n\n  [hidden] {\n    display: none !important;\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 { devWarn } from '../../utils/dev-warn.js';\nimport { helixStatStyles } from './hx-stat.styles.js';\n\nexport type StatSize = 'sm' | 'md' | 'lg';\nexport type StatTrend = 'up' | 'down' | 'neutral';\n\n/**\n * A static stat display component for presenting key metrics in a healthcare dashboard.\n *\n * @summary Displays a labeled metric value with optional trend indicator and icon slot.\n *\n * @tag hx-stat\n *\n * @slot icon - Optional icon displayed alongside the stat value.\n *\n * @csspart container - The outer stat container element.\n * @csspart header - The row containing the value and optional icon.\n * @csspart value - The stat value element.\n * @csspart label - The stat label element.\n * @csspart trend - The trend indicator element (only rendered when trend is not 'neutral').\n * @csspart icon - The icon slot container.\n *\n * @cssprop [--hx-stat-gap=var(--hx-space-1)] - Gap between value and label.\n * @cssprop [--hx-stat-header-gap=var(--hx-space-2)] - Gap between icon and value in the header row.\n * @cssprop [--hx-stat-color=var(--hx-color-neutral-800)] - Default text color.\n * @cssprop [--hx-stat-value-color=var(--hx-color-neutral-900)] - Value text color.\n * @cssprop [--hx-stat-label-color=var(--hx-color-neutral-500)] - Label text color.\n * @cssprop [--hx-stat-icon-color=var(--hx-color-primary-500)] - Icon color.\n * @cssprop [--hx-stat-value-font-weight=var(--hx-font-weight-bold)] - Value font weight.\n * @cssprop [--hx-stat-font-family=var(--hx-font-family-sans)] - Font family.\n * @cssprop [--hx-stat-value-font-size-sm=var(--hx-font-size-xl)] - Value font size at sm.\n * @cssprop [--hx-stat-value-font-size-md=var(--hx-font-size-3xl)] - Value font size at md.\n * @cssprop [--hx-stat-value-font-size-lg=var(--hx-font-size-5xl)] - Value font size at lg.\n * @cssprop [--hx-stat-label-font-size-sm=var(--hx-font-size-xs)] - Label font size at sm.\n * @cssprop [--hx-stat-label-font-size-md=var(--hx-font-size-sm)] - Label font size at md.\n * @cssprop [--hx-stat-label-font-size-lg=var(--hx-font-size-md)] - Label font size at lg.\n * @cssprop [--hx-stat-trend-up-color=var(--hx-color-success-700)] - Trend up text color.\n * @cssprop [--hx-stat-trend-up-bg=var(--hx-color-success-50)] - Trend up background color.\n * @cssprop [--hx-stat-trend-down-color=var(--hx-color-error-700)] - Trend down text color.\n * @cssprop [--hx-stat-trend-down-bg=var(--hx-color-error-50)] - Trend down background color.\n */\n@customElement('hx-stat')\nexport class HelixStat extends LitElement {\n  static override styles = [tokenStyles, helixStatStyles];\n\n  /**\n   * The metric label displayed below the value.\n   * @attr label\n   */\n  @property({ type: String, reflect: true })\n  label = '';\n\n  /**\n   * The metric value displayed prominently.\n   * @attr value\n   */\n  @property({ type: String, reflect: true })\n  value = '';\n\n  /**\n   * Trend direction indicator. 'neutral' hides the indicator.\n   * @attr trend\n   */\n  @property({ type: String, reflect: true })\n  trend: 'up' | 'down' | 'neutral' = 'neutral';\n\n  /**\n   * Size variant controlling font size.\n   * @attr hx-size\n   */\n  @property({ type: String, reflect: true, attribute: 'hx-size' })\n  size: 'sm' | 'md' | 'lg' = 'md';\n\n  /**\n   * Prefix label for trend indicator. Override for i18n.\n   * @attr label-trend\n   */\n  @property({ attribute: 'label-trend' }) labelTrend = 'Trend';\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-stat', 'The \"size\" attribute is deprecated. Use \"hx-size\" instead.');\n      this.size = legacySize as StatSize;\n    }\n  }\n\n  // ─── Slot Detection ───\n\n  /** @internal */\n  @state() private _hasIcon = false;\n\n  /** @internal */\n  private _onIconSlotChange(e: Event): void {\n    const slot = e.target as HTMLSlotElement;\n    this._hasIcon = slot.assignedNodes({ flatten: true }).length > 0;\n  }\n\n  // ─── Render Helpers ───\n\n  /** @internal */\n  private _renderTrendArrow(trend: 'up' | 'down'): ReturnType<typeof html> {\n    if (trend === 'up') {\n      return html`\n        <svg\n          class=\"stat__trend-arrow\"\n          aria-hidden=\"true\"\n          viewBox=\"0 0 12 12\"\n          fill=\"none\"\n          xmlns=\"http://www.w3.org/2000/svg\"\n        >\n          <path\n            d=\"M6 10V2M6 2L2 6M6 2L10 6\"\n            stroke=\"currentColor\"\n            stroke-width=\"1.5\"\n            stroke-linecap=\"round\"\n            stroke-linejoin=\"round\"\n          />\n        </svg>\n      `;\n    }\n    return html`\n      <svg\n        class=\"stat__trend-arrow\"\n        aria-hidden=\"true\"\n        viewBox=\"0 0 12 12\"\n        fill=\"none\"\n        xmlns=\"http://www.w3.org/2000/svg\"\n      >\n        <path\n          d=\"M6 2V10M6 10L2 6M6 10L10 6\"\n          stroke=\"currentColor\"\n          stroke-width=\"1.5\"\n          stroke-linecap=\"round\"\n          stroke-linejoin=\"round\"\n        />\n      </svg>\n    `;\n  }\n\n  // ─── Render ───\n\n  override render() {\n    const containerClasses = {\n      stat: true,\n      [`stat--${this.size}`]: true,\n    };\n\n    const hasTrend = this.trend !== 'neutral';\n\n    // WCAG 1.3.1: wrap value and label in a group so screen readers announce them\n    // together with a combined accessible name instead of as disconnected text runs.\n    const groupLabel =\n      this.value && this.label\n        ? `${this.value}: ${this.label}`\n        : this.value || this.label || nothing;\n\n    return html`\n      <div\n        part=\"container\"\n        class=${classMap(containerClasses)}\n        role=\"group\"\n        aria-label=${groupLabel}\n      >\n        <div part=\"header\" class=\"stat__header\">\n          <span part=\"icon\" class=\"stat__icon\" ?hidden=${!this._hasIcon}>\n            <slot name=\"icon\" @slotchange=${this._onIconSlotChange}></slot>\n          </span>\n          <span part=\"value\" class=\"stat__value\" aria-hidden=\"true\">${this.value}</span>\n          ${hasTrend\n            ? html`\n                <span\n                  part=\"trend\"\n                  class=\"stat__trend stat__trend--${this.trend}\"\n                  role=\"img\"\n                  aria-label=\"${this.labelTrend}: ${this.trend}\"\n                >\n                  ${this._renderTrendArrow(this.trend as 'up' | 'down')}\n                </span>\n              `\n            : nothing}\n        </div>\n        <span part=\"label\" class=\"stat__label\" aria-hidden=\"true\">${this.label}</span>\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-stat': HelixStat;\n  }\n}\n"],"names":["helixStatStyles","css","HelixStat","LitElement","legacySize","e","slot","trend","html","containerClasses","hasTrend","groupLabel","nothing","classMap","tokenStyles","__decorateClass","property","state","customElement"],"mappings":"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"}

package/dist/shared/{hx-status-indicator-oYWOkWlD.js → hx-status-indicator-4ClvA5mU.js}

@@ -1,5 +1,5 @@
 import { css as u, LitElement as d, html as h } from "lit";
-import { property as a, customElement as p } from "lit/decorators.js";
+import { property as r, customElement as p } from "lit/decorators.js";
 import { tokenStyles as v } from "@helixui/tokens/lit";
 const x = u`
   :host {
@@ -8,7 +8,7 @@ const x = u`
     justify-content: center;
     position: relative;
     flex-shrink: 0;
-    --_dot-color: var(--hx-color-neutral-300);
+    --_dot-color: var(--hx-status-indicator-color-default, var(--hx-color-neutral-300, #ced4da));
   }
 
   .indicator {
@@ -36,7 +36,7 @@ const x = u`
     inset: 0;
     border-radius: 50%;
     background-color: var(--hx-status-indicator-pulse-color, var(--_dot-color));
-    opacity: 0.4;
+    opacity: var(--hx-state-focus-opacity, 0.12); /* intentional: pulse ring start opacity */
     animation: hx-status-pulse var(--hx-status-indicator-pulse-duration, 1.5s) ease-out infinite;
     z-index: 0; /* pulse ring beneath dot within shadow root */
   }
@@ -48,7 +48,7 @@ const x = u`
   @keyframes hx-status-pulse {
     0% {
       transform: scale(1);
-      opacity: 0.4;
+      opacity: var(--hx-state-focus-opacity, 0.12); /* intentional: pulse ring start opacity */
     }
     100% {
       transform: scale(var(--hx-status-indicator-pulse-scale, 2.5));
@@ -66,11 +66,11 @@ const x = u`
   /* ─── Size Variants ─── */
 
   :host([size='sm']) {
-    --_indicator-size: var(--hx-status-indicator-size-sm, var(--hx-size-2));
+    --_indicator-size: var(--hx-status-indicator-size-sm, var(--hx-space-2, 0.5rem));
   }
 
   :host([size='md']) {
-    --_indicator-size: var(--hx-status-indicator-size-md, var(--hx-size-3));
+    --_indicator-size: var(--hx-status-indicator-size-md, var(--hx-space-3, 0.75rem));
   }
 
   :host([size='lg']) {
@@ -92,19 +92,19 @@ const x = u`
   }
 
   :host([status='busy']) {
-    --_dot-color: var(--hx-status-indicator-color-busy, var(--hx-color-danger-500));
+    --_dot-color: var(--hx-status-indicator-color-busy, var(--hx-color-error-500));
   }
 
   :host([status='unknown']) {
     --_dot-color: var(--hx-status-indicator-color-unknown, var(--hx-color-neutral-300));
   }
 `;
-var _ = Object.defineProperty, f = Object.getOwnPropertyDescriptor, e = (t, o, n, r) => {
-  for (var s = r > 1 ? void 0 : r ? f(o, n) : o, l = t.length - 1, c; l >= 0; l--)
-    (c = t[l]) && (s = (r ? c(o, n, s) : c(s)) || s);
-  return r && s && _(o, n, s), s;
+var f = Object.defineProperty, y = Object.getOwnPropertyDescriptor, e = (t, o, n, a) => {
+  for (var s = a > 1 ? void 0 : a ? y(o, n) : o, l = t.length - 1, c; l >= 0; l--)
+    (c = t[l]) && (s = (a ? c(o, n, s) : c(s)) || s);
+  return a && s && f(o, n, s), s;
 };
-const y = {
+const _ = {
   online: "Online",
   offline: "Offline",
   away: "Away",
@@ -115,12 +115,15 @@ let i = class extends d {
   constructor() {
     super(...arguments), this.status = "unknown", this.size = "md", this.pulse = !1, this.label = "";
   }
+  /** @internal */
   _getLabel() {
-    return this.label ? this.label : `Status: ${y[this.status] ?? "Unknown"}`;
+    return this.label ? this.label : `Status: ${_[this.status] ?? "Unknown"}`;
   }
   // ─── Lifecycle ───
   connectedCallback() {
-    super.connectedCallback(), this.hasAttribute("role") || this.setAttribute("role", "img"), this.setAttribute("aria-label", this._getLabel());
+    super.connectedCallback();
+    const t = this.getAttribute("size");
+    t !== null && !this.hasAttribute("hx-size") && (this.size = t), this.hasAttribute("role") || this.setAttribute("role", "img"), this.setAttribute("aria-label", this._getLabel());
   }
   updated(t) {
     super.updated(t), (t.has("status") || t.has("label")) && this.setAttribute("aria-label", this._getLabel());
@@ -136,16 +139,16 @@ let i = class extends d {
 };
 i.styles = [v, x];
 e([
-  a({ type: String, reflect: !0 })
+  r({ type: String, reflect: !0 })
 ], i.prototype, "status", 2);
 e([
-  a({ type: String, reflect: !0 })
+  r({ type: String, reflect: !0, attribute: "hx-size" })
 ], i.prototype, "size", 2);
 e([
-  a({ type: Boolean, reflect: !0 })
+  r({ type: Boolean, reflect: !0 })
 ], i.prototype, "pulse", 2);
 e([
-  a({ type: String })
+  r({ type: String })
 ], i.prototype, "label", 2);
 i = e([
   p("hx-status-indicator")
@@ -153,4 +156,4 @@ i = e([
 export {
   i as H
 };
-//# sourceMappingURL=hx-status-indicator-oYWOkWlD.js.map
+//# sourceMappingURL=hx-status-indicator-4ClvA5mU.js.map

package/dist/shared/hx-status-indicator-4ClvA5mU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-status-indicator-4ClvA5mU.js","sources":["../../src/components/hx-status-indicator/hx-status-indicator.styles.ts","../../src/components/hx-status-indicator/hx-status-indicator.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixStatusIndicatorStyles = css`\n  :host {\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    position: relative;\n    flex-shrink: 0;\n    --_dot-color: var(--hx-status-indicator-color-default, var(--hx-color-neutral-300, #ced4da));\n  }\n\n  .indicator {\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    position: relative;\n    width: var(--_indicator-size);\n    height: var(--_indicator-size);\n    flex-shrink: 0;\n  }\n\n  .indicator__dot {\n    width: 100%;\n    height: 100%;\n    border-radius: 50%;\n    background-color: var(--_dot-color);\n    position: relative;\n    z-index: 1; /* dot above pulse ring within shadow root */\n  }\n\n  .indicator__pulse-ring {\n    display: none;\n    position: absolute;\n    inset: 0;\n    border-radius: 50%;\n    background-color: var(--hx-status-indicator-pulse-color, var(--_dot-color));\n    opacity: var(--hx-state-focus-opacity, 0.12); /* intentional: pulse ring start opacity */\n    animation: hx-status-pulse var(--hx-status-indicator-pulse-duration, 1.5s) ease-out infinite;\n    z-index: 0; /* pulse ring beneath dot within shadow root */\n  }\n\n  :host([pulse]) .indicator__pulse-ring {\n    display: block;\n  }\n\n  @keyframes hx-status-pulse {\n    0% {\n      transform: scale(1);\n      opacity: var(--hx-state-focus-opacity, 0.12); /* intentional: pulse ring start opacity */\n    }\n    100% {\n      transform: scale(var(--hx-status-indicator-pulse-scale, 2.5));\n      opacity: 0;\n    }\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    :host([pulse]) .indicator__pulse-ring {\n      animation: none;\n      display: none;\n    }\n  }\n\n  /* ─── Size Variants ─── */\n\n  :host([size='sm']) {\n    --_indicator-size: var(--hx-status-indicator-size-sm, var(--hx-space-2, 0.5rem));\n  }\n\n  :host([size='md']) {\n    --_indicator-size: var(--hx-status-indicator-size-md, var(--hx-space-3, 0.75rem));\n  }\n\n  :host([size='lg']) {\n    --_indicator-size: var(--hx-status-indicator-size-lg, var(--hx-size-4));\n  }\n\n  /* ─── Status Colors ─── */\n\n  :host([status='online']) {\n    --_dot-color: var(--hx-status-indicator-color-online, var(--hx-color-success-500));\n  }\n\n  :host([status='offline']) {\n    --_dot-color: var(--hx-status-indicator-color-offline, var(--hx-color-neutral-400));\n  }\n\n  :host([status='away']) {\n    --_dot-color: var(--hx-status-indicator-color-away, var(--hx-color-warning-500));\n  }\n\n  :host([status='busy']) {\n    --_dot-color: var(--hx-status-indicator-color-busy, var(--hx-color-error-500));\n  }\n\n  :host([status='unknown']) {\n    --_dot-color: var(--hx-status-indicator-color-unknown, var(--hx-color-neutral-300));\n  }\n`;\n","import { LitElement, html, type PropertyValues } from 'lit';\nimport { customElement, property } from 'lit/decorators.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { devWarn } from '../../utils/dev-warn.js';\nimport { helixStatusIndicatorStyles } from './hx-status-indicator.styles.js';\n\nexport type StatusIndicatorStatus = 'online' | 'offline' | 'away' | 'busy' | 'unknown';\nexport type StatusIndicatorSize = 'sm' | 'md' | 'lg';\n\nconst STATUS_LABELS: Record<StatusIndicatorStatus, string> = {\n  online: 'Online',\n  offline: 'Offline',\n  away: 'Away',\n  busy: 'Busy',\n  unknown: 'Unknown',\n};\n\n/**\n * A colored dot/badge indicating system or entity health status.\n * Purely visual — no slots. Supports an animated pulse ring.\n *\n * Uses `role=\"img\"` with an auto-generated `aria-label` (e.g. \"Status: Online\").\n * When used decoratively alongside visible text that conveys the same status information\n * (e.g. \"Provider is available\"), set `aria-hidden=\"true\"` on the host element to prevent\n * duplicate announcements to screen reader users. This is the recommended composition\n * pattern in healthcare dashboards.\n *\n * @remarks\n * The status vocabulary (`online`, `offline`, `away`, `busy`, `unknown`) is the intentional\n * implementation canonical form for this component. Although a prior spec draft used\n * `active/inactive/error/warning`, the current vocabulary was approved as a deliberate\n * design decision for flexibility and UX clarity in healthcare dashboard contexts.\n *\n * @summary Status indicator dot component.\n *\n * @tag hx-status-indicator\n *\n * @csspart base - The dot element.\n * @csspart pulse-ring - The animated pulse ring element.\n *\n * @cssprop [--hx-status-indicator-color-online] - Override color for the \"online\" status dot.\n * @cssprop [--hx-status-indicator-color-offline] - Override color for the \"offline\" status dot.\n * @cssprop [--hx-status-indicator-color-away] - Override color for the \"away\" status dot.\n * @cssprop [--hx-status-indicator-color-busy] - Override color for the \"busy\" status dot.\n * @cssprop [--hx-status-indicator-color-unknown] - Override color for the \"unknown\" status dot.\n * @cssprop [--hx-status-indicator-size-sm] - Override size for the \"sm\" variant.\n * @cssprop [--hx-status-indicator-size-md] - Override size for the \"md\" variant.\n * @cssprop [--hx-status-indicator-size-lg] - Override size for the \"lg\" variant.\n * @cssprop [--hx-status-indicator-pulse-duration] - Override pulse animation duration.\n * @cssprop [--hx-status-indicator-pulse-scale] - Override pulse animation max scale.\n * @cssprop [--hx-status-indicator-pulse-color] - Override pulse ring color independently from dot color.\n */\n@customElement('hx-status-indicator')\nexport class HelixStatusIndicator extends LitElement {\n  static override styles = [tokenStyles, helixStatusIndicatorStyles];\n\n  /**\n   * The status to display.\n   * @attr status\n   */\n  @property({ type: String, reflect: true })\n  status: 'online' | 'offline' | 'away' | 'busy' | 'unknown' = 'unknown';\n\n  /**\n   * Size of the indicator dot.\n   * @attr hx-size\n   */\n  @property({ type: String, reflect: true, attribute: 'hx-size' })\n  size: 'sm' | 'md' | 'lg' = 'md';\n\n  /**\n   * Whether to show an animated pulse ring around the dot.\n   * Animation is suppressed when prefers-reduced-motion is active.\n   * @attr pulse\n   * @remarks\n   * In Twig (Drupal) templates, render as a bare attribute: `pulse` — NOT `pulse=\"true\"`.\n   * The value is ignored; only attribute presence matters.\n   */\n  @property({ type: Boolean, reflect: true })\n  pulse = false;\n\n  /**\n   * Accessible label for the indicator. Defaults to \"Status: {Status}\".\n   * Set aria-hidden=\"true\" on the host when status is conveyed by adjacent text.\n   * @attr label\n   */\n  @property({ type: String })\n  label = '';\n\n  /** @internal */\n  private _getLabel(): string {\n    if (this.label) return this.label;\n    const statusText = STATUS_LABELS[this.status] ?? 'Unknown';\n    return `Status: ${statusText}`;\n  }\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-status-indicator', 'The \"size\" attribute is deprecated. Use \"hx-size\" instead.');\n      this.size = legacySize as StatusIndicatorSize;\n    }\n    // T3-01-4: Place role=\"img\" on the host element for robust AT traversal.\n    // Some screen reader + browser combinations skip shadow children; host-level\n    // ARIA attributes are more reliable across the flat accessibility tree.\n    if (!this.hasAttribute('role')) {\n      this.setAttribute('role', 'img');\n    }\n    this.setAttribute('aria-label', this._getLabel());\n  }\n\n  override updated(changedProperties: PropertyValues<this>): void {\n    super.updated(changedProperties);\n    // Keep host aria-label in sync when status or label properties change.\n    if (changedProperties.has('status') || changedProperties.has('label')) {\n      this.setAttribute('aria-label', this._getLabel());\n    }\n  }\n\n  override render() {\n    return html`\n      <div class=\"indicator\">\n        <div class=\"indicator__pulse-ring\" part=\"pulse-ring\"></div>\n        <div class=\"indicator__dot\" part=\"base\"></div>\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-status-indicator': HelixStatusIndicator;\n  }\n}\n"],"names":["helixStatusIndicatorStyles","css","STATUS_LABELS","HelixStatusIndicator","LitElement","legacySize","changedProperties","html","tokenStyles","__decorateClass","property","customElement"],"mappings":";;;AAEO,MAAMA,IAA6BC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;;;;ACO1C,MAAMC,IAAuD;AAAA,EAC3D,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,MAAM;AAAA,EACN,MAAM;AAAA,EACN,SAAS;AACX;AAsCO,IAAMC,IAAN,cAAmCC,EAAW;AAAA,EAA9C,cAAA;AAAA,UAAA,GAAA,SAAA,GAQL,KAAA,SAA6D,WAO7D,KAAA,OAA2B,MAW3B,KAAA,QAAQ,IAQR,KAAA,QAAQ;AAAA,EAAA;AAAA;AAAA,EAGA,YAAoB;AAC1B,WAAI,KAAK,QAAc,KAAK,QAErB,WADYF,EAAc,KAAK,MAAM,KAAK,SACrB;AAAA,EAC9B;AAAA;AAAA,EAIS,oBAA0B;AACjC,UAAM,kBAAA;AAGN,UAAMG,IAAa,KAAK,aAAa,MAAM;AAC3C,IAAIA,MAAe,QAAQ,CAAC,KAAK,aAAa,SAAS,MAErD,KAAK,OAAOA,IAKT,KAAK,aAAa,MAAM,KAC3B,KAAK,aAAa,QAAQ,KAAK,GAEjC,KAAK,aAAa,cAAc,KAAK,UAAA,CAAW;AAAA,EAClD;AAAA,EAES,QAAQC,GAA+C;AAC9D,UAAM,QAAQA,CAAiB,IAE3BA,EAAkB,IAAI,QAAQ,KAAKA,EAAkB,IAAI,OAAO,MAClE,KAAK,aAAa,cAAc,KAAK,UAAA,CAAW;AAAA,EAEpD;AAAA,EAES,SAAS;AAChB,WAAOC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMT;AACF;AA/EaJ,EACK,SAAS,CAACK,GAAaR,CAA0B;AAOjES,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM;AAAA,GAP9BP,EAQX,WAAA,UAAA,CAAA;AAOAM,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM,WAAW,WAAW;AAAA,GAdpDP,EAeX,WAAA,QAAA,CAAA;AAWAM,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,SAAS,SAAS,IAAM;AAAA,GAzB/BP,EA0BX,WAAA,SAAA,CAAA;AAQAM,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,OAAA,CAAQ;AAAA,GAjCfP,EAkCX,WAAA,SAAA,CAAA;AAlCWA,IAANM,EAAA;AAAA,EADNE,EAAc,qBAAqB;AAAA,GACvBR,CAAA;"}