@helixui/library 1.0.1 → 1.1.2-next.1

package/dist/shared/hx-progress-ring-BHJBaXNk.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hx-progress-ring-BHJBaXNk.js","sources":["../../src/components/hx-progress-ring/hx-progress-ring.styles.ts","../../src/components/hx-progress-ring/hx-progress-ring.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixProgressRingStyles = css`\n  :host {\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n  }\n\n  /* ─── Base Container ─── */\n\n  .progress-ring {\n    position: relative;\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n  }\n\n  /* ─── SVG ─── */\n\n  .progress-ring__svg {\n    transform: rotate(-90deg);\n    overflow: visible;\n  }\n\n  /* ─── Track ─── */\n\n  .progress-ring__track {\n    fill: none;\n    stroke: var(--hx-progress-ring-track-color, var(--hx-color-neutral-200, #e2e8f0));\n  }\n\n  /* ─── Indicator ─── */\n\n  .progress-ring__indicator {\n    fill: none;\n    stroke: var(--hx-progress-ring-indicator-color, var(--hx-color-primary-500, #2563eb));\n    stroke-linecap: round;\n    transition: stroke-dashoffset var(--hx-transition-base, 300ms ease);\n  }\n\n  /* ─── Variant Colors ─── */\n\n  :host([variant='success']) .progress-ring__indicator {\n    stroke: var(--hx-progress-ring-indicator-color, var(--hx-color-success-500, #16a34a));\n  }\n\n  :host([variant='warning']) .progress-ring__indicator {\n    stroke: var(--hx-progress-ring-indicator-color, var(--hx-color-warning-500, #d97706));\n  }\n\n  :host([variant='danger']) .progress-ring__indicator {\n    stroke: var(--hx-progress-ring-indicator-color, var(--hx-color-error-500, #dc2626));\n  }\n\n  /* ─── Indeterminate Animation ─── */\n\n  :host([indeterminate]) .progress-ring__svg {\n    animation: hx-progress-ring-rotate var(--hx-duration-spinner, 1400ms) linear infinite;\n  }\n\n  :host([indeterminate]) .progress-ring__indicator {\n    animation: hx-progress-ring-dash var(--hx-duration-spinner, 1400ms) ease-in-out infinite;\n    transition: none;\n    stroke-dasharray: 1, 200;\n    stroke-dashoffset: 0;\n  }\n\n  @keyframes hx-progress-ring-rotate {\n    to {\n      transform: rotate(270deg);\n    }\n  }\n\n  /*\n   * Indeterminate spinner keyframes — values are tuned for default strokeWidth=4\n   * (radius ≈ 48, circumference ≈ 301). The gap value 200 is intentionally smaller\n   * than the full circumference; the repeating pattern is a standard CSS spinner\n   * technique that produces an arc of ~35% coverage. At non-default strokeWidths\n   * the arc coverage will vary slightly but remains visually acceptable.\n   */\n  @keyframes hx-progress-ring-dash {\n    0% {\n      stroke-dasharray: 1, 200;\n      stroke-dashoffset: 0;\n    }\n    50% {\n      stroke-dasharray: 89, 200;\n      stroke-dashoffset: -35;\n    }\n    100% {\n      stroke-dasharray: 89, 200;\n      stroke-dashoffset: -124;\n    }\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    :host([indeterminate]) .progress-ring__svg {\n      animation: none;\n    }\n\n    :host([indeterminate]) .progress-ring__indicator {\n      animation: none;\n      stroke-dasharray: 89, 200;\n      stroke-dashoffset: -35;\n    }\n\n    .progress-ring__indicator {\n      transition: none;\n    }\n  }\n\n  /* ─── Size Variants ─── */\n\n  :host([size='sm']) .progress-ring {\n    width: var(--hx-size-8, 2rem);\n    height: var(--hx-size-8, 2rem);\n  }\n\n  :host([size='md']) .progress-ring,\n  .progress-ring {\n    width: var(--hx-size-12, 3rem);\n    height: var(--hx-size-12, 3rem);\n  }\n\n  :host([size='lg']) .progress-ring {\n    width: var(--hx-size-16, 4rem);\n    height: var(--hx-size-16, 4rem);\n  }\n\n  /* ─── Label (center slot wrapper) ─── */\n\n  .progress-ring__label {\n    position: absolute;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    inset: 0;\n    font-size: var(--hx-font-size-xs, 0.75rem);\n    font-family: var(--hx-font-family-sans, sans-serif);\n    font-weight: var(--hx-font-weight-semibold, 600);\n    color: var(--hx-progress-ring-label-color, var(--hx-color-neutral-900, #0f172a));\n    pointer-events: none;\n  }\n`;\n","import { LitElement, html, svg, TemplateResult, type PropertyValues } from 'lit';\nimport { customElement, property } from 'lit/decorators.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { helixProgressRingStyles } from './hx-progress-ring.styles.js';\nimport { devWarn } from '../../utils/dev-warn.js';\n\n/**\n * SVG-based circular progress indicator. Supports determinate and indeterminate modes,\n * multiple size variants, semantic color variants, and a center content slot.\n *\n * @summary Circular progress ring for indicating operation progress or loading state.\n *\n * @tag hx-progress-ring\n *\n * @slot - Default slot for center content (percentage text, icon, etc.).\n *\n * @csspart base - The SVG element.\n * @csspart track - The background circle track.\n * @csspart indicator - The progress arc indicator.\n * @csspart label - The center slot wrapper div.\n *\n * @cssprop [--hx-progress-ring-track-color=var(--hx-color-neutral-200)] - Track stroke color.\n * @cssprop [--hx-progress-ring-indicator-color=var(--hx-color-primary-500)] - Indicator stroke color.\n * @cssprop [--hx-progress-ring-label-color=var(--hx-color-neutral-900)] - Center label text color.\n */\n@customElement('hx-progress-ring')\nexport class HelixProgressRing extends LitElement {\n  static override styles = [tokenStyles, helixProgressRingStyles];\n\n  // ─── Public Properties ───\n\n  /**\n   * Current progress value (0–max). When null, renders in indeterminate mode.\n   * @attr value\n   */\n  @property({ type: Number, reflect: true })\n  value: number | null = null;\n\n  /**\n   * Maximum value for the progress range. Defaults to 100. Used for aria-valuemax.\n   * @attr max\n   */\n  @property({ type: Number, reflect: true })\n  max = 100;\n\n  /**\n   * Size of the ring. Controls SVG diameter.\n   * @attr size\n   */\n  @property({ type: String, reflect: true })\n  size: 'sm' | 'md' | 'lg' = 'md';\n\n  /**\n   * Stroke width of the ring circles in SVG user units.\n   * @attr stroke-width\n   */\n  @property({ type: Number, attribute: 'stroke-width', reflect: true })\n  strokeWidth = 4;\n\n  /**\n   * Semantic color variant.\n   * @attr variant\n   */\n  @property({ type: String, reflect: true })\n  variant: 'default' | 'success' | 'warning' | 'danger' = 'default';\n\n  /**\n   * Accessible label for the progressbar. Exposed as aria-label.\n   * Set this attribute to satisfy WCAG 4.1.2. When absent, aria-busy reflects\n   * indeterminate state and a console warning is emitted.\n   * @attr label\n   */\n  @property({ type: String })\n  label = '';\n\n  // ─── Private Helpers ───\n\n  private get _isIndeterminate(): boolean {\n    return this.value === null;\n  }\n\n  private get _clampedValue(): number {\n    if (this.value === null) return 0;\n    return Math.min(this.max, Math.max(0, this.value));\n  }\n\n  /**\n   * SVG viewBox is 100x100. Radius leaves room for the stroke.\n   */\n  private get _radius(): number {\n    return (100 - this.strokeWidth) / 2;\n  }\n\n  private get _circumference(): number {\n    return 2 * Math.PI * this._radius;\n  }\n\n  private get _strokeDashoffset(): number {\n    return this._circumference * (1 - this._clampedValue / this.max);\n  }\n\n  private _labelWarned = false;\n\n  // ─── Lifecycle ───\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n    this.setAttribute('role', 'progressbar');\n    this.setAttribute('aria-valuemin', '0');\n  }\n\n  protected override willUpdate(_changed: PropertyValues): void {\n    // Sync all dynamic ARIA attributes before render\n    this.setAttribute('aria-valuemax', String(this.max));\n\n    if (this._isIndeterminate) {\n      this.setAttribute('indeterminate', '');\n      this.setAttribute('aria-busy', 'true');\n      this.removeAttribute('aria-valuenow');\n    } else {\n      this.removeAttribute('indeterminate');\n      this.removeAttribute('aria-busy');\n      this.setAttribute('aria-valuenow', String(this._clampedValue));\n    }\n\n    if (this.label) {\n      this.setAttribute('aria-label', this.label);\n    } else {\n      this.removeAttribute('aria-label');\n      if (!this._labelWarned) {\n        this._labelWarned = true;\n        devWarn(\n          'hx-progress-ring',\n          'Missing accessible label. Set the `label` attribute for WCAG 4.1.2 compliance.',\n        );\n      }\n    }\n  }\n\n  // ─── Render ───\n\n  override render(): TemplateResult {\n    const cx = 50;\n    const cy = 50;\n    const r = this._radius;\n    const circumference = this._circumference;\n\n    return html`\n      <div class=\"progress-ring\">\n        <svg\n          class=\"progress-ring__svg\"\n          part=\"base\"\n          viewBox=\"0 0 100 100\"\n          aria-hidden=\"true\"\n          focusable=\"false\"\n        >\n          ${svg`\n            <circle\n              class=\"progress-ring__track\"\n              part=\"track\"\n              cx=${cx}\n              cy=${cy}\n              r=${r}\n              stroke-width=${this.strokeWidth}\n            />\n            <circle\n              class=\"progress-ring__indicator\"\n              part=\"indicator\"\n              cx=${cx}\n              cy=${cy}\n              r=${r}\n              stroke-width=${this.strokeWidth}\n              stroke-dasharray=${\n                this._isIndeterminate ? '1 200' : `${circumference} ${circumference}`\n              }\n              stroke-dashoffset=${this._isIndeterminate ? '0' : this._strokeDashoffset}\n            />\n          `}\n        </svg>\n        <div class=\"progress-ring__label\" part=\"label\">\n          <slot></slot>\n        </div>\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-progress-ring': HelixProgressRing;\n  }\n}\n"],"names":["helixProgressRingStyles","css","HelixProgressRing","LitElement","_changed","r","circumference","html","svg","tokenStyles","__decorateClass","property","customElement"],"mappings":"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"}