@helixui/library 1.1.2 → 2.0.0-next.30

package/dist/css/helix-utility.css

@@ -0,0 +1,633 @@
+/* helix-utility.css — 6 components */
+
+/* ── hx-action-bar ── */
+:host {
+    display: block;
+  }
+
+  /* ─── Base ─── */
+
+  .base {
+    display: flex;
+    flex-direction: row;
+    align-items: center;
+    gap: var(--hx-action-bar-gap, var(--hx-space-2, 0.5rem));
+    padding: var(--hx-action-bar-padding, var(--hx-space-2, 0.5rem) var(--hx-space-3, 0.75rem));
+    background: var(--hx-action-bar-bg, transparent);
+    border: var(--hx-action-bar-border, none);
+    box-sizing: border-box;
+    width: 100%;
+  }
+
+  /* ─── Sticky (top) ─── */
+
+  .base--sticky {
+    position: sticky;
+    top: 0;
+    padding-top: max(var(--hx-action-bar-padding-block-start, 0px), env(safe-area-inset-top, 0px));
+    z-index: var(--hx-action-bar-z-index, 10);
+    /*
+     * Consumers: when this bar is sticky, add scroll-padding-top to the scroll container
+     * equal to the bar's rendered height so anchor targets are not hidden behind the bar.
+     * Example: .scroll-container { scroll-padding-top: 2.5rem; }
+     */
+  }
+
+  /* ─── Bottom sticky ─── */
+
+  .base--bottom {
+    position: sticky;
+    bottom: 0;
+    /*
+     * Respect iOS home-indicator safe area on devices with notch/home bar.
+     * Falls back to 0px on devices that do not support env().
+     */
+    padding-bottom: max(
+      var(--hx-action-bar-padding-block-end, 0px),
+      env(safe-area-inset-bottom, 0px)
+    );
+    z-index: var(--hx-action-bar-z-index, 10);
+  }
+
+  /* ─── Variant: outlined ─── */
+
+  .base--outlined {
+    background: var(--hx-action-bar-bg, var(--hx-color-neutral-0, #fff));
+    border: var(
+      --hx-action-bar-border,
+      var(--hx-border-width-thin, 1px) solid var(--hx-color-neutral-200, #e5e7eb)
+    );
+    border-radius: var(--hx-border-radius-md, 0.375rem);
+  }
+
+  /* ─── Variant: filled ─── */
+
+  .base--filled {
+    background: var(--hx-action-bar-bg, var(--hx-color-neutral-50, #f9fafb));
+    border-radius: var(--hx-border-radius-md, 0.375rem);
+  }
+
+  /* ─── Size modifiers ─── */
+
+  .base--sm {
+    padding: var(--hx-action-bar-padding, var(--hx-space-1, 0.25rem) var(--hx-space-2, 0.5rem));
+    gap: var(--hx-action-bar-gap, var(--hx-space-1, 0.25rem));
+    min-height: var(--hx-size-8, 2rem);
+  }
+
+  .base--md {
+    min-height: var(--hx-size-10, 2.5rem);
+  }
+
+  .base--lg {
+    padding: var(--hx-action-bar-padding, var(--hx-space-3, 0.75rem) var(--hx-space-4, 1rem));
+    gap: var(--hx-action-bar-gap, var(--hx-space-3, 0.75rem));
+    min-height: var(--hx-size-12, 3rem);
+  }
+
+  /* ─── Sections ─── */
+
+  .section {
+    display: flex;
+    align-items: center;
+    gap: inherit;
+  }
+
+  /*
+   * Equal flex-basis on start and end guarantees the center section is visually centered
+   * within the full bar width, regardless of how wide start and end content are.
+   */
+  .section--start {
+    flex: 1 1 0;
+    justify-content: flex-start;
+  }
+
+  .section--center {
+    flex: 0 0 auto;
+    justify-content: center;
+  }
+
+  .section--end {
+    flex: 1 1 0;
+    justify-content: flex-end;
+  }
+
+  /* ─── Slotted content ─── */
+
+  ::slotted(*) {
+    flex-shrink: 0;
+  }
+/* ── hx-copy-button ── */
+:host {
+    display: inline-block;
+  }
+
+  :host([disabled]) {
+    pointer-events: none;
+  }
+
+  .button {
+    position: relative;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: var(--hx-space-2);
+    border: var(--hx-border-width-thin) solid var(--hx-copy-button-border-color, transparent);
+    border-radius: var(--hx-copy-button-border-radius, var(--hx-border-radius-md));
+    background-color: var(--hx-copy-button-bg, transparent);
+    color: var(--hx-copy-button-color, var(--hx-color-primary-500));
+    cursor: pointer;
+    transition:
+      background-color var(--hx-transition-fast),
+      color var(--hx-transition-fast),
+      border-color var(--hx-transition-fast),
+      box-shadow var(--hx-transition-fast);
+    text-decoration: none;
+    user-select: none;
+    -webkit-user-select: none;
+    flex-shrink: 0;
+    font-family: var(--hx-font-family-sans);
+    font-weight: var(--hx-font-weight-medium);
+    white-space: nowrap;
+  }
+
+  .button:focus-visible {
+    outline: var(--hx-focus-ring-width) solid
+      var(--hx-copy-button-focus-ring-color, var(--hx-focus-ring-color));
+    outline-offset: var(--hx-focus-ring-offset);
+  }
+
+  .button:hover {
+    filter: brightness(var(--hx-filter-brightness-hover, 0.9));
+  }
+
+  .button:active {
+    filter: brightness(var(--hx-filter-brightness-active, 0.8));
+  }
+
+  /* ─── Size Variants ─── */
+
+  .button--sm {
+    padding: var(--hx-space-1);
+    min-width: var(--hx-size-8);
+    height: var(--hx-size-8);
+    font-size: var(--hx-font-size-sm);
+  }
+
+  .button--md {
+    padding: var(--hx-space-2);
+    min-width: var(--hx-size-10);
+    height: var(--hx-size-10);
+    font-size: var(--hx-font-size-md);
+  }
+
+  .button--lg {
+    padding: var(--hx-space-3);
+    min-width: var(--hx-size-12);
+    height: var(--hx-size-12);
+    font-size: var(--hx-font-size-lg);
+  }
+
+  /* ─── Copied / Success State ─── */
+
+  .button--copied {
+    color: var(--hx-color-success-text, var(--hx-color-primary-500));
+    /* Secondary non-color indicator required per WCAG 1.4.1 (use of color).
+       A border provides visual differentiation for users with color blindness. */
+    border-color: var(--hx-color-success-500, var(--hx-color-primary-500));
+  }
+
+  /* ─── Icon Container ─── */
+
+  .icon {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 1em;
+    height: 1em;
+    line-height: 1;
+    pointer-events: none;
+    flex-shrink: 0;
+  }
+
+  /* ─── Disabled ─── */
+
+  .button[disabled] {
+    cursor: not-allowed;
+    opacity: var(--hx-opacity-disabled);
+  }
+
+  /* ─── Screen Reader Only ─── */
+
+  .sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border-width: 0;
+  }
+
+  /* ─── Reduced Motion ─── */
+
+  @media (prefers-reduced-motion: reduce) {
+    .button {
+      transition: none;
+    }
+  }
+/* ── hx-counter ── */
+:host {
+    display: inline-block;
+  }
+
+  .counter {
+    display: inline-flex;
+    align-items: baseline;
+    font-family: var(--hx-counter-font-family, var(--hx-font-family-sans, sans-serif));
+    font-weight: var(--hx-counter-font-weight, var(--hx-font-weight-bold, 700));
+    color: var(--hx-counter-color, var(--hx-color-neutral-900, #111827));
+    line-height: var(--hx-line-height-tight, 1.25);
+    font-variant-numeric: tabular-nums;
+  }
+
+  /* ─── Size Variants ─── */
+
+  .counter--sm {
+    font-size: var(--hx-counter-font-size-sm, var(--hx-font-size-xl, 1.25rem));
+  }
+
+  .counter--md {
+    font-size: var(--hx-counter-font-size-md, var(--hx-font-size-3xl, 1.875rem));
+  }
+
+  .counter--lg {
+    font-size: var(--hx-counter-font-size-lg, var(--hx-font-size-5xl, 3rem));
+  }
+
+  /* ─── Screen-reader only (visually hidden live region) ─── */
+
+  .sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+  }
+
+  /* ─── Reduced Motion ─── */
+
+  @media (prefers-reduced-motion: reduce) {
+    .counter {
+      /* Animation is handled in JS — reduced-motion consumers
+         will see the final value immediately via the component logic */
+    }
+  }
+/* ── hx-format-date ── */
+:host {
+    display: inline;
+  }
+
+  [part='base'] {
+    display: inline;
+    font: inherit;
+    color: inherit;
+  }
+/* ── hx-split-button ── */
+:host {
+    display: inline-block;
+    position: relative;
+  }
+
+  :host([disabled]) {
+    pointer-events: none;
+    opacity: var(--hx-opacity-disabled, 0.5);
+  }
+
+  /* ─── Container ─── */
+
+  .split-button {
+    display: inline-flex;
+    align-items: stretch;
+    position: relative;
+  }
+
+  /* ─── Primary Button ─── */
+
+  .split-button__primary {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: var(--hx-space-2, 0.5rem);
+    border: var(--hx-border-width-thin, 1px) solid var(--hx-split-button-border-color, transparent);
+    border-inline-end: none;
+    border-radius: var(--hx-split-button-border-radius, var(--hx-border-radius-md, 0.375rem)) 0 0
+      var(--hx-split-button-border-radius, var(--hx-border-radius-md, 0.375rem));
+    background-color: var(--hx-split-button-bg, var(--hx-color-primary-500, #2563eb));
+    color: var(--hx-split-button-color, var(--hx-color-neutral-0, #ffffff));
+    font-family: var(--hx-split-button-font-family, var(--hx-font-family-sans, sans-serif));
+    font-weight: var(--hx-split-button-font-weight, var(--hx-font-weight-semibold, 600));
+    line-height: var(--hx-line-height-tight, 1.25);
+    cursor: pointer;
+    transition:
+      background-color var(--hx-transition-fast, 150ms ease),
+      color var(--hx-transition-fast, 150ms ease),
+      border-color var(--hx-transition-fast, 150ms ease),
+      box-shadow var(--hx-transition-fast, 150ms ease);
+    text-decoration: none;
+    white-space: nowrap;
+    user-select: none;
+    -webkit-user-select: none;
+    flex: 1 1 auto;
+  }
+
+  .split-button__primary:focus-visible {
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(
+        --hx-split-button-focus-ring-color,
+        var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa))
+      );
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+    z-index: 1;
+    position: relative;
+  }
+
+  .split-button__primary:hover {
+    filter: brightness(var(--hx-filter-brightness-hover, 0.9));
+  }
+
+  .split-button__primary:active {
+    filter: brightness(var(--hx-filter-brightness-active, 0.8));
+  }
+
+  .split-button__primary[disabled] {
+    cursor: not-allowed;
+  }
+
+  /* ─── Trigger Button ─── */
+
+  .split-button__trigger {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex-shrink: 0;
+    border: var(--hx-border-width-thin, 1px) solid var(--hx-split-button-border-color, transparent);
+    border-inline-start: var(--hx-border-width-thin, 1px) solid
+      var(--hx-split-button-divider-color, var(--hx-color-primary-400, #3b82f6));
+    border-radius: 0 var(--hx-split-button-border-radius, var(--hx-border-radius-md, 0.375rem))
+      var(--hx-split-button-border-radius, var(--hx-border-radius-md, 0.375rem)) 0;
+    background-color: var(--hx-split-button-bg, var(--hx-color-primary-500, #2563eb));
+    color: var(--hx-split-button-color, var(--hx-color-neutral-0, #ffffff));
+    cursor: pointer;
+    transition:
+      background-color var(--hx-transition-fast, 150ms ease),
+      box-shadow var(--hx-transition-fast, 150ms ease);
+    user-select: none;
+    -webkit-user-select: none;
+  }
+
+  .split-button__trigger:focus-visible {
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(
+        --hx-split-button-focus-ring-color,
+        var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa))
+      );
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+    z-index: 1;
+    position: relative;
+  }
+
+  .split-button__trigger:hover {
+    filter: brightness(var(--hx-filter-brightness-hover, 0.9));
+  }
+
+  .split-button__trigger:active {
+    filter: brightness(var(--hx-filter-brightness-active, 0.8));
+  }
+
+  .split-button__trigger[disabled] {
+    cursor: not-allowed;
+  }
+
+  /* ─── Trigger Icon ─── */
+
+  .split-button__chevron {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    transition: transform var(--hx-transition-fast, 150ms ease);
+  }
+
+  .split-button__chevron--open {
+    transform: rotate(180deg);
+  }
+
+  /* ─── Size Variants ─── */
+
+  /* sm */
+  .split-button--sm .split-button__primary {
+    padding: var(--hx-space-1, 0.25rem) var(--hx-space-3, 0.75rem);
+    font-size: var(--hx-font-size-sm, 0.875rem);
+    min-height: var(--hx-size-8, 2rem);
+  }
+
+  .split-button--sm .split-button__trigger {
+    padding: var(--hx-space-1, 0.25rem) var(--hx-space-2, 0.5rem);
+    min-height: var(--hx-size-8, 2rem);
+  }
+
+  /* md */
+  .split-button--md .split-button__primary {
+    padding: var(--hx-space-2, 0.5rem) var(--hx-space-4, 1rem);
+    font-size: var(--hx-font-size-md, 1rem);
+    min-height: var(--hx-size-10, 2.5rem);
+  }
+
+  .split-button--md .split-button__trigger {
+    padding: var(--hx-space-2, 0.5rem) var(--hx-space-3, 0.75rem);
+    min-height: var(--hx-size-10, 2.5rem);
+  }
+
+  /* lg */
+  .split-button--lg .split-button__primary {
+    padding: var(--hx-space-3, 0.75rem) var(--hx-space-6, 1.5rem);
+    font-size: var(--hx-font-size-lg, 1.125rem);
+    min-height: var(--hx-size-12, 3rem);
+  }
+
+  .split-button--lg .split-button__trigger {
+    padding: var(--hx-space-3, 0.75rem) var(--hx-space-4, 1rem);
+    min-height: var(--hx-size-12, 3rem);
+  }
+
+  /* ─── Variant: primary ─── */
+
+  .split-button--primary .split-button__primary,
+  .split-button--primary .split-button__trigger {
+    --hx-split-button-bg: var(--hx-color-primary-500, #2563eb);
+    --hx-split-button-color: var(--hx-color-neutral-0, #ffffff);
+    --hx-split-button-border-color: transparent;
+    --hx-split-button-divider-color: var(--hx-color-primary-400, #3b82f6);
+  }
+
+  /* ─── Variant: secondary ─── */
+
+  .split-button--secondary .split-button__primary,
+  .split-button--secondary .split-button__trigger {
+    --hx-split-button-bg: transparent;
+    --hx-split-button-color: var(--hx-color-primary-500, #2563eb);
+    --hx-split-button-border-color: var(--hx-color-primary-500, #2563eb);
+    --hx-split-button-divider-color: var(--hx-color-primary-300, #93c5fd);
+  }
+
+  .split-button--secondary .split-button__primary:hover,
+  .split-button--secondary .split-button__trigger:hover {
+    --hx-split-button-bg: var(--hx-color-primary-50, #eff6ff);
+    filter: none;
+  }
+
+  /* ─── Variant: tertiary ─── */
+
+  .split-button--tertiary .split-button__primary,
+  .split-button--tertiary .split-button__trigger {
+    --hx-split-button-bg: var(--hx-color-neutral-100, #f1f5f9);
+    --hx-split-button-color: var(--hx-color-neutral-900, #0f172a);
+    --hx-split-button-border-color: transparent;
+    --hx-split-button-divider-color: var(--hx-color-neutral-300, #cbd5e1);
+  }
+
+  .split-button--tertiary .split-button__primary:hover,
+  .split-button--tertiary .split-button__trigger:hover {
+    --hx-split-button-bg: var(--hx-color-neutral-200, #e2e8f0);
+    filter: none;
+  }
+
+  /* ─── Variant: danger ─── */
+
+  .split-button--danger .split-button__primary,
+  .split-button--danger .split-button__trigger {
+    --hx-split-button-bg: var(--hx-color-error-500, #dc2626);
+    --hx-split-button-color: var(--hx-color-neutral-0, #ffffff);
+    --hx-split-button-border-color: transparent;
+    --hx-split-button-divider-color: var(--hx-color-error-400, #f87171);
+  }
+
+  .split-button--danger .split-button__primary:hover,
+  .split-button--danger .split-button__trigger:hover {
+    --hx-split-button-bg: var(--hx-color-error-600, #b91c1c);
+    filter: none;
+  }
+
+  /* ─── Variant: ghost ─── */
+
+  .split-button--ghost .split-button__primary,
+  .split-button--ghost .split-button__trigger {
+    --hx-split-button-bg: transparent;
+    --hx-split-button-color: var(--hx-color-primary-500, #2563eb);
+    --hx-split-button-border-color: transparent;
+    --hx-split-button-divider-color: var(--hx-color-primary-200, #bfdbfe);
+  }
+
+  .split-button--ghost .split-button__primary:hover,
+  .split-button--ghost .split-button__trigger:hover {
+    --hx-split-button-bg: var(--hx-color-neutral-100, #f1f5f9);
+    filter: none;
+  }
+
+  /* ─── Variant: outline ─── */
+
+  .split-button--outline .split-button__primary,
+  .split-button--outline .split-button__trigger {
+    --hx-split-button-bg: transparent;
+    --hx-split-button-color: var(--hx-color-neutral-900, #0f172a);
+    --hx-split-button-border-color: var(--hx-color-neutral-300, #cbd5e1);
+    --hx-split-button-divider-color: var(--hx-color-neutral-300, #cbd5e1);
+  }
+
+  .split-button--outline .split-button__primary:hover,
+  .split-button--outline .split-button__trigger:hover {
+    --hx-split-button-bg: var(--hx-color-neutral-50, #f8fafc);
+    filter: none;
+  }
+
+  /* ─── Dropdown Menu Panel ─── */
+
+  @keyframes hx-split-button-menu-open {
+    from {
+      opacity: 0;
+      transform: translateY(-4px);
+    }
+    to {
+      opacity: 1;
+      transform: translateY(0);
+    }
+  }
+
+  .split-button__menu {
+    display: none;
+    position: absolute;
+    top: calc(100% + var(--hx-space-1, 0.25rem));
+    inset-inline-end: 0;
+    min-width: 100%;
+    max-height: var(--hx-split-button-menu-max-height, 18rem);
+    overflow-y: auto;
+    background-color: var(--hx-split-button-menu-bg, var(--hx-color-neutral-0, #ffffff));
+    border: var(--hx-border-width-thin, 1px) solid
+      var(--hx-split-button-menu-border-color, var(--hx-color-neutral-200, #e2e8f0));
+    border-radius: var(--hx-split-button-menu-border-radius, var(--hx-border-radius-md, 0.375rem));
+    box-shadow: var(
+      --hx-split-button-menu-shadow,
+      0 4px 6px -1px var(--hx-overlay-black-10, rgba(0, 0, 0, 0.1)),
+      0 2px 4px -2px var(--hx-overlay-black-10, rgba(0, 0, 0, 0.1))
+    );
+    padding: var(--hx-space-1, 0.25rem);
+    z-index: var(--hx-z-index-dropdown, 1000);
+  }
+
+  .split-button__menu--open {
+    display: block;
+    animation: hx-split-button-menu-open var(--hx-transition-fast, 150ms ease);
+  }
+
+  /* ─── Reduced Motion ─── */
+
+  @media (prefers-reduced-motion: reduce) {
+    .split-button__primary,
+    .split-button__trigger,
+    .split-button__chevron {
+      transition: none;
+    }
+
+    .split-button__menu--open {
+      animation: none;
+    }
+  }
+/* ── hx-theme ── */
+:host {
+    display: contents;
+  }
+
+  /* display: contents makes this wrapper layout-invisible; exposed as [part="base"]
+     for consumer targeting via CSS parts without affecting layout */
+  .theme-base {
+    display: contents;
+  }
+
+  /* Visually hidden but accessible to screen readers — used for aria-live announcements */
+  .visually-hidden {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+  }

package/dist/css/hx-accordion.css

@@ -0,0 +1,10 @@
+/* hx-accordion — extracted from Shadow DOM styles */
+:host {
+    display: block;
+    font-family: var(--hx-font-family-sans, sans-serif);
+  }
+
+  .accordion {
+    border-radius: var(--hx-accordion-border-radius, var(--hx-border-radius-md, 0.375rem));
+    overflow: hidden;
+  }