@helixui/library 1.1.2 → 2.0.0-next.30

package/dist/css/hx-time-picker.css

@@ -0,0 +1,2 @@
+/* hx-time-picker — extracted from Shadow DOM styles */
+:host{display:block;position:relative}:host([disabled]){opacity:var(--hx-opacity-disabled, .5);pointer-events:none}*{box-sizing:border-box}.field{display:flex;flex-direction:column;gap:var(--hx-space-1, .25rem);font-family:var(--hx-time-picker-font-family, var(--hx-font-family-sans, sans-serif))}.field__label{display:flex;align-items:baseline;gap:var(--hx-space-1, .25rem);font-size:var(--hx-font-size-sm, .875rem);font-weight:var(--hx-font-weight-medium, 500);color:var(--hx-time-picker-label-color, var(--hx-color-neutral-700));line-height:var(--hx-line-height-normal, 1.5)}.field__required-marker{color:var(--hx-time-picker-error-color, var(--hx-color-error-text, #b91c1c));font-weight:var(--hx-font-weight-bold, 700)}.field__combobox{position:relative;display:flex;align-items:center;border:var(--hx-border-width-thin, 1px) solid var(--hx-time-picker-border-color, var(--hx-color-neutral-300));border-radius:var(--hx-time-picker-border-radius, var(--hx-border-radius-md, .375rem));background-color:var(--hx-time-picker-bg, var(--hx-color-neutral-0));transition:border-color var(--hx-transition-fast, .15s ease),box-shadow var(--hx-transition-fast, .15s ease);overflow:visible}.field__combobox:focus-within{border-color:var(--hx-time-picker-focus-ring-color, var(--hx-focus-ring-color));box-shadow:0 0 0 var(--hx-focus-ring-width, 2px) color-mix(in srgb,var(--hx-time-picker-focus-ring-color, var(--hx-focus-ring-color)) calc(var(--hx-focus-ring-opacity, .25) * 100%),transparent)}.field--error .field__combobox{border-color:var(--hx-time-picker-error-color, var(--hx-color-error-500))}.field--error .field__combobox:focus-within{border-color:var(--hx-time-picker-error-color, var(--hx-color-error-500));box-shadow:0 0 0 var(--hx-focus-ring-width, 2px) color-mix(in srgb,var(--hx-time-picker-error-color, var(--hx-color-error-500)) calc(var(--hx-focus-ring-opacity, .25) * 100%),transparent)}.field__input{flex:1;border:none;outline:none;background:transparent;padding:var(--hx-space-2, .5rem) var(--hx-space-3, .75rem);font-family:inherit;font-size:var(--hx-font-size-md, 1rem);color:var(--hx-time-picker-color, var(--hx-color-neutral-800));line-height:var(--hx-line-height-normal, 1.5);min-height:var(--hx-size-10, 2.5rem);width:100%;cursor:text}.field__input::placeholder{color:var(--hx-color-neutral-400)}.field__input:disabled{cursor:not-allowed}.field__toggle{display:flex;align-items:center;justify-content:center;border:none;background:transparent;padding:0 var(--hx-space-3, .75rem);color:var(--hx-time-picker-chevron-color, var(--hx-color-neutral-500));cursor:pointer;height:100%;min-height:var(--hx-size-10, 2.5rem);flex-shrink:0;border-inline-start:var(--hx-border-width-thin, 1px) solid var(--hx-time-picker-border-color, var(--hx-color-neutral-300))}.field__toggle:focus-visible{outline:var(--hx-focus-ring-width, 2px) solid var(--hx-time-picker-focus-ring-color, var(--hx-focus-ring-color));outline-offset:-2px;border-radius:0 var(--hx-time-picker-border-radius, var(--hx-border-radius-md, .375rem))}.field__listbox{position:absolute;top:calc(100% + var(--hx-space-1, .25rem));inset-inline-start:0;inset-inline-end:0;z-index:var(--hx-z-index-dropdown, 1000);background-color:var(--hx-time-picker-listbox-bg, var(--hx-color-neutral-0));border:var(--hx-border-width-thin, 1px) solid var(--hx-time-picker-border-color, var(--hx-color-neutral-300));border-radius:var(--hx-time-picker-border-radius, var(--hx-border-radius-md, .375rem));box-shadow:var( --hx-time-picker-listbox-shadow, 0 4px 16px color-mix(in srgb, var(--hx-color-neutral-900) 12%, transparent) );max-height:var(--hx-time-picker-listbox-max-height, 16rem);overflow-y:auto;padding:var(--hx-space-1, .25rem) 0;list-style:none;margin:0}@media(prefers-reduced-motion:no-preference){.field__listbox{animation:hx-listbox-enter var(--hx-transition-fast, .15s ease) forwards}}@keyframes hx-listbox-enter{0%{opacity:0;transform:translateY(-.25rem)}to{opacity:1;transform:translateY(0)}}.field__option{display:flex;align-items:center;padding:var(--hx-space-2, .5rem) var(--hx-space-3, .75rem);font-size:var(--hx-font-size-md, 1rem);font-family:inherit;color:var(--hx-time-picker-option-color, var(--hx-color-neutral-800));cursor:pointer;transition:background-color var(--hx-transition-fast, .15s ease);line-height:var(--hx-line-height-normal, 1.5)}.field__option:hover,.field__option--active{background-color:var(--hx-time-picker-option-hover-bg, var(--hx-color-primary-50));color:var(--hx-time-picker-option-hover-color, var(--hx-color-primary-700))}.field__option--selected{background-color:var(--hx-time-picker-option-selected-bg, var(--hx-color-primary-100));color:var(--hx-time-picker-option-selected-color, var(--hx-color-primary-800));font-weight:var(--hx-font-weight-medium, 500)}.field__option--selected.field__option--active{background-color:var(--hx-time-picker-option-selected-bg, var(--hx-color-primary-100))}@media(prefers-reduced-motion:reduce){.field__combobox,.field__option{transition:none}}.field__help-text,.field__error{font-size:var(--hx-font-size-xs, .75rem);line-height:var(--hx-line-height-normal, 1.5)}.field__help-text{color:var(--hx-color-neutral-500)}.field__error{color:var(--hx-time-picker-error-color, var(--hx-color-error-text, #b91c1c))}

package/dist/css/hx-toast.css

@@ -0,0 +1,230 @@
+/* hx-toast — extracted from Shadow DOM styles */
+/* ─── hx-toast host ─── */
+
+  :host {
+    display: block;
+    pointer-events: none;
+  }
+
+  :host([open]) {
+    pointer-events: auto;
+  }
+
+  /* ─── Toast base ─── */
+
+  .toast {
+    display: flex;
+    align-items: flex-start;
+    gap: var(--hx-space-3, 0.75rem);
+    padding: var(--hx-space-3, 0.75rem) var(--hx-space-4, 1rem);
+    border-radius: var(--hx-toast-border-radius, var(--hx-border-radius-md, 0.375rem));
+    background-color: var(--hx-toast-bg, var(--hx-color-neutral-900, #0f172a));
+    color: var(--hx-toast-color, var(--hx-color-neutral-0, #ffffff));
+    font-family: var(--hx-font-family-sans, sans-serif);
+    font-size: var(--hx-font-size-sm, 0.875rem);
+    line-height: var(--hx-line-height-normal, 1.5);
+    box-shadow: var(
+      --hx-toast-shadow,
+      0 4px 6px -1px rgb(0 0 0 / 0.1),
+      0 2px 4px -2px rgb(0 0 0 / 0.1)
+    );
+    opacity: 0;
+    transform: translateY(var(--hx-toast-enter-translate, var(--hx-space-2, 0.5rem)));
+    transition:
+      opacity var(--hx-transition-normal, 250ms ease),
+      transform var(--hx-transition-normal, 250ms ease);
+    width: var(--hx-toast-width, 20rem);
+    max-width: 100%;
+    pointer-events: auto;
+  }
+
+  :host([open]) .toast {
+    opacity: 1;
+    transform: translateY(0);
+  }
+
+  /* ─── Variant overrides ─── */
+
+  .toast--success {
+    --hx-toast-bg: var(--hx-color-success-600, #16a34a);
+    --hx-toast-color: var(--hx-color-neutral-0, #ffffff);
+  }
+
+  .toast--warning {
+    --hx-toast-bg: var(--hx-color-warning-500, #f59e0b);
+    --hx-toast-color: var(--hx-color-neutral-900, #0f172a);
+  }
+
+  .toast--danger {
+    --hx-toast-bg: var(--hx-color-error-600, #dc2626);
+    --hx-toast-color: var(--hx-color-neutral-0, #ffffff);
+  }
+
+  .toast--info {
+    --hx-toast-bg: var(--hx-color-primary-600, #2563eb);
+    --hx-toast-color: var(--hx-color-neutral-0, #ffffff);
+  }
+
+  /* ─── Severity Label (WCAG 1.4.1) ─── */
+  /* Visually hidden — non-color cue for severity variants (success/warning/danger/info). */
+  /* Ensures variant is not conveyed by color alone for color-blind users.                */
+
+  .toast__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;
+  }
+
+  /* ─── Icon ─── */
+
+  .toast__icon {
+    flex-shrink: 0;
+    display: inline-flex;
+    align-items: center;
+    line-height: 1;
+  }
+
+  .toast__icon:empty {
+    display: none;
+  }
+
+  /* ─── Message ─── */
+
+  .toast__message {
+    flex: 1 1 auto;
+    min-width: 0;
+  }
+
+  /* ─── Action slot ─── */
+
+  .toast__action {
+    flex-shrink: 0;
+    display: inline-flex;
+    align-items: center;
+  }
+
+  .toast__action:empty {
+    display: none;
+  }
+
+  /* ─── Close button ─── */
+
+  .toast__close {
+    flex-shrink: 0;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    /* WCAG 2.5.5: minimum 44×44px touch target */
+    min-width: var(--hx-touch-target-min, 2.75rem);
+    min-height: var(--hx-touch-target-min, 2.75rem);
+    padding: var(--hx-space-1, 0.25rem);
+    background: transparent;
+    border: none;
+    border-radius: var(--hx-border-radius-sm, 0.25rem);
+    color: inherit;
+    cursor: pointer;
+    opacity: var(--hx-opacity-75, 0.75);
+    transition: opacity var(--hx-transition-fast, 150ms ease);
+  }
+
+  .toast__close:hover {
+    opacity: 1;
+  }
+
+  .toast__close:focus-visible {
+    outline: var(--hx-focus-ring-width, 2px) solid currentColor;
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+  }
+
+  /* ─── Reduced motion ─── */
+
+  @media (prefers-reduced-motion: reduce) {
+    .toast {
+      transition: none;
+    }
+
+    .toast__close {
+      transition: none;
+    }
+  }
+`;
+
+export const helixToastStackStyles = css`
+  :host {
+    display: block;
+    position: fixed;
+    z-index: var(--hx-z-index-toast, 1700);
+    pointer-events: none;
+  }
+
+  .toast-stack {
+    display: flex;
+    flex-direction: column;
+    gap: var(--hx-space-3, 0.75rem);
+    padding: var(--hx-space-4, 1rem);
+    pointer-events: none;
+  }
+
+  /* ─── Placements ─── */
+
+  :host([placement='top-start']) {
+    top: 0;
+    inset-inline-start: 0;
+    inset-inline-end: auto;
+    bottom: auto;
+  }
+
+  :host([placement='top-center']) {
+    top: 0;
+    inset-inline-start: 50%;
+    transform: translateX(-50%);
+    inset-inline-end: auto;
+    bottom: auto;
+  }
+
+  :host([placement='top-end']) {
+    top: 0;
+    inset-inline-end: 0;
+    inset-inline-start: auto;
+    bottom: auto;
+  }
+
+  :host([placement='bottom-start']) {
+    bottom: 0;
+    inset-inline-start: 0;
+    inset-inline-end: auto;
+    top: auto;
+  }
+
+  :host([placement='bottom-center']) {
+    bottom: 0;
+    inset-inline-start: 50%;
+    transform: translateX(-50%);
+    inset-inline-end: auto;
+    top: auto;
+  }
+
+  :host([placement='bottom-end']) {
+    bottom: 0;
+    inset-inline-end: 0;
+    inset-inline-start: auto;
+    top: auto;
+  }
+
+  /* ─── Bottom placements: reverse order so newest is on top ─── */
+
+  :host([placement^='bottom']) .toast-stack {
+    flex-direction: column-reverse;
+  }
+
+  /* ─── Slide direction by placement ─── */
+
+  :host([placement^='top']) ::slotted(hx-toast) {
+    --hx-toast-enter-translate: calc(var(--hx-space-2, 0.5rem) * -1);
+  }

package/dist/css/hx-toggle-button.css

@@ -0,0 +1,207 @@
+/* hx-toggle-button — extracted from Shadow DOM styles */
+:host {
+    display: inline-block;
+  }
+
+  :host([disabled]) {
+    pointer-events: none;
+    opacity: var(--hx-opacity-disabled, 0.5);
+  }
+
+  /* ─── Base Button ─── */
+
+  .button {
+    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-toggle-button-border-color, transparent);
+    border-radius: var(--hx-toggle-button-border-radius, var(--hx-border-radius-md, 0.375rem));
+    background-color: var(--hx-toggle-button-bg, var(--hx-color-primary-500, #2563eb));
+    color: var(--hx-toggle-button-color, var(--hx-color-neutral-0, #ffffff));
+    font-family: var(--hx-toggle-button-font-family, var(--hx-font-family-sans, sans-serif));
+    font-weight: var(--hx-toggle-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;
+  }
+
+  .button:focus-visible {
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(
+        --hx-toggle-button-focus-ring-color,
+        var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa))
+      );
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+  }
+
+  .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, 0.25rem) var(--hx-space-3, 0.75rem);
+    font-size: var(--hx-font-size-sm, 0.875rem);
+    min-height: var(--hx-size-8, 2rem);
+  }
+
+  .button--md {
+    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);
+  }
+
+  .button--lg {
+    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);
+  }
+
+  /* ─── Style Variants ─── */
+
+  .button--primary {
+    --hx-toggle-button-bg: var(--hx-color-primary-500, #2563eb);
+    --hx-toggle-button-color: var(--hx-color-neutral-0, #ffffff);
+    --hx-toggle-button-border-color: transparent;
+  }
+
+  .button--secondary {
+    --hx-toggle-button-bg: transparent;
+    --hx-toggle-button-color: var(--hx-color-primary-500, #2563eb);
+    --hx-toggle-button-border-color: var(--hx-color-primary-500, #2563eb);
+  }
+
+  .button--secondary:hover {
+    --hx-toggle-button-bg: var(--hx-color-primary-50, #eff6ff);
+  }
+
+  .button--tertiary {
+    --hx-toggle-button-bg: var(--hx-color-neutral-100, #f1f5f9);
+    --hx-toggle-button-color: var(--hx-color-neutral-900, #0f172a);
+    --hx-toggle-button-border-color: transparent;
+  }
+
+  .button--tertiary:hover {
+    --hx-toggle-button-bg: var(--hx-color-neutral-200, #e2e8f0);
+  }
+
+  .button--ghost {
+    --hx-toggle-button-bg: transparent;
+    --hx-toggle-button-color: var(--hx-color-primary-500, #2563eb);
+    --hx-toggle-button-border-color: transparent;
+  }
+
+  .button--ghost:hover {
+    --hx-toggle-button-bg: var(--hx-color-neutral-100, #f1f5f9);
+  }
+
+  .button--outline {
+    --hx-toggle-button-bg: transparent;
+    --hx-toggle-button-color: var(--hx-color-neutral-900, #0f172a);
+    --hx-toggle-button-border-color: var(--hx-color-neutral-300, #cbd5e1);
+  }
+
+  .button--outline:hover {
+    --hx-toggle-button-bg: var(--hx-color-neutral-50, #f8fafc);
+  }
+
+  /* ─── Pressed State ─── */
+
+  /*
+   * Primary: already uses solid primary bg; pressed deepens to primary-700
+   * to give clear visual feedback without introducing a new color.
+   */
+  .button--primary.button--pressed {
+    --hx-toggle-button-bg: var(--hx-toggle-button-pressed-bg, var(--hx-color-primary-700, #1d4ed8));
+    --hx-toggle-button-color: var(
+      --hx-toggle-button-pressed-color,
+      var(--hx-color-neutral-0, #ffffff)
+    );
+    --hx-toggle-button-border-color: transparent;
+  }
+
+  /*
+   * Secondary: unpressed is outlined/transparent; pressed fills with primary bg
+   * so the state change is immediately legible.
+   */
+  .button--secondary.button--pressed {
+    --hx-toggle-button-bg: var(--hx-toggle-button-pressed-bg, var(--hx-color-primary-500, #2563eb));
+    --hx-toggle-button-color: var(
+      --hx-toggle-button-pressed-color,
+      var(--hx-color-neutral-0, #ffffff)
+    );
+    --hx-toggle-button-border-color: var(--hx-color-primary-500, #2563eb);
+  }
+
+  /* Tertiary pressed: use primary-100 bg + primary-700 text + border for WCAG 3:1 non-text contrast. */
+  .button--tertiary.button--pressed {
+    --hx-toggle-button-bg: var(--hx-toggle-button-pressed-bg, var(--hx-color-primary-100, #dbeafe));
+    --hx-toggle-button-color: var(
+      --hx-toggle-button-pressed-color,
+      var(--hx-color-primary-700, #1d4ed8)
+    );
+    --hx-toggle-button-border-color: var(--hx-color-primary-400, #60a5fa);
+    box-shadow: inset 0 0 0 1px var(--hx-color-primary-400, #60a5fa);
+  }
+
+  /* Ghost pressed: subtle neutral fill, matching hover behavior as a baseline. */
+  .button--ghost.button--pressed {
+    --hx-toggle-button-bg: var(--hx-toggle-button-pressed-bg, var(--hx-color-primary-100, #dbeafe));
+    --hx-toggle-button-color: var(
+      --hx-toggle-button-pressed-color,
+      var(--hx-color-primary-700, #1d4ed8)
+    );
+    --hx-toggle-button-border-color: transparent;
+  }
+
+  /* Outline pressed: fills with a neutral tint, darkens the border, and adds an inset shadow for WCAG 3:1 non-text contrast. */
+  .button--outline.button--pressed {
+    --hx-toggle-button-bg: var(--hx-toggle-button-pressed-bg, var(--hx-color-neutral-100, #f1f5f9));
+    --hx-toggle-button-color: var(
+      --hx-toggle-button-pressed-color,
+      var(--hx-color-neutral-900, #0f172a)
+    );
+    --hx-toggle-button-border-color: var(--hx-color-neutral-500, #64748b);
+    box-shadow: inset 0 0 0 1px var(--hx-color-neutral-500, #64748b);
+  }
+
+  /* ─── Disabled ─── */
+
+  .button[disabled] {
+    cursor: not-allowed;
+  }
+
+  /* ─── Prefix / Suffix / Label ─── */
+
+  .button__prefix,
+  .button__suffix {
+    display: inline-flex;
+    align-items: center;
+    flex-shrink: 0;
+  }
+
+  .button__label {
+    flex: 1 1 auto;
+  }
+
+  /* ─── Reduced Motion ─── */
+
+  @media (prefers-reduced-motion: reduce) {
+    .button {
+      transition: none;
+    }
+  }

package/dist/css/hx-tooltip.css

@@ -0,0 +1,51 @@
+/* hx-tooltip — extracted from Shadow DOM styles */
+:host {
+    display: inline-block;
+  }
+
+  .trigger-wrapper {
+    display: inline-block;
+  }
+
+  [part='tooltip'] {
+    position: fixed;
+    z-index: var(--hx-tooltip-z-index, var(--hx-z-index-tooltip, 1600));
+    max-width: var(--hx-tooltip-max-width, 280px);
+    padding: var(--hx-tooltip-padding, var(--hx-space-1, 0.25rem) var(--hx-space-2, 0.5rem));
+    background: var(--hx-tooltip-bg, var(--hx-color-neutral-900, #111827));
+    color: var(--hx-tooltip-color, var(--hx-color-neutral-50, #f9fafb));
+    font-family: var(--hx-font-family-sans, sans-serif);
+    font-size: var(--hx-tooltip-font-size, var(--hx-font-size-xs, 0.75rem));
+    line-height: var(--hx-line-height-normal, 1.5);
+    border-radius: var(--hx-tooltip-border-radius, var(--hx-border-radius-sm, 0.25rem));
+    box-shadow: var(
+      --hx-tooltip-shadow,
+      var(--hx-shadow-sm, 0 2px 8px var(--hx-overlay-black-20, rgba(0, 0, 0, 0.2)))
+    );
+    visibility: hidden;
+    opacity: 0;
+    transition:
+      opacity var(--hx-tooltip-transition-duration, var(--hx-transition-fast, 150ms ease)),
+      visibility var(--hx-tooltip-transition-duration, var(--hx-transition-fast, 150ms ease));
+    overflow-wrap: break-word;
+  }
+
+  [part='tooltip'].visible {
+    visibility: visible;
+    opacity: 1;
+  }
+
+  [part='arrow'] {
+    position: absolute;
+    width: var(--hx-tooltip-arrow-size, 8px);
+    height: var(--hx-tooltip-arrow-size, 8px);
+    background: var(--hx-tooltip-bg, var(--hx-color-neutral-900, #111827));
+    transform: rotate(45deg);
+    pointer-events: none;
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    [part='tooltip'] {
+      transition: none;
+    }
+  }

package/dist/css/hx-top-nav.css

@@ -0,0 +1,203 @@
+/* hx-top-nav — extracted from Shadow DOM styles */
+/* ─── Host ─── */
+
+  :host {
+    display: block;
+  }
+
+  /* ─── Header wrapper (landmark) ─── */
+
+  header {
+    display: block;
+    margin: 0;
+    padding: 0;
+  }
+
+  /* ─── Sticky mode ─── */
+
+  :host([sticky]) .nav {
+    position: sticky;
+    top: 0;
+    /* Fallback 1000 is appropriate for sticky navbars (below modals ~1300, above content) */
+    z-index: var(--hx-top-nav-z-index, var(--hx-z-index-sticky, 1000));
+  }
+
+  /* ─── Nav container ─── */
+
+  .nav {
+    background-color: var(--hx-top-nav-bg, var(--hx-color-neutral-0, #ffffff));
+    color: var(--hx-top-nav-color, var(--hx-color-neutral-800, #212529));
+    border-bottom: var(--hx-border-width-thin, 1px) solid
+      var(--hx-top-nav-border-color, var(--hx-color-neutral-200, #dee2e6));
+    font-family: var(--hx-font-family-sans, sans-serif);
+  }
+
+  /* ─── Bar row (always visible) ─── */
+
+  .nav__bar {
+    display: flex;
+    align-items: center;
+    min-height: var(--hx-top-nav-height, var(--hx-space-16, 4rem));
+    padding-inline: var(--hx-top-nav-padding-x, var(--hx-space-6, 1.5rem));
+    gap: var(--hx-space-4, 1rem);
+  }
+
+  /* ─── Logo ─── */
+
+  .nav__logo {
+    display: flex;
+    align-items: center;
+    flex-shrink: 0;
+  }
+
+  /* ─── Mobile toggle (hamburger) ─── */
+
+  .mobile-toggle {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    margin-inline-start: auto;
+    /* var(--hx-space-3, 0.75rem) padding + 24px icon = 48×48px touch target (exceeds WCAG 2.5.5 44×44px) */
+    padding: var(--hx-space-3, 0.75rem);
+    background: transparent;
+    border: none;
+    border-radius: var(--hx-border-radius-sm, 0.25rem);
+    color: var(--hx-top-nav-toggle-color, var(--hx-color-neutral-700, #343a40));
+    cursor: pointer;
+    line-height: 0;
+  }
+
+  .mobile-toggle:hover {
+    background: var(--hx-color-neutral-100, #f1f3f5);
+  }
+
+  .mobile-toggle:focus-visible {
+    outline: var(--hx-focus-ring-width, 2px) solid
+      var(--hx-focus-ring-color, var(--hx-color-primary-500, #2563eb));
+    outline-offset: var(--hx-focus-ring-offset, 2px);
+  }
+
+  .mobile-toggle__icon {
+    width: var(--hx-space-6, 1.5rem);
+    height: var(--hx-space-6, 1.5rem);
+  }
+
+  /* ─── Collapsible panel (mobile) ─── */
+
+  .nav__collapsible {
+    display: none;
+    flex-direction: column;
+    width: 100%;
+    padding-block: var(--hx-space-3, 0.75rem);
+    border-top: var(--hx-border-width-thin, 1px) solid
+      var(--hx-top-nav-border-color, var(--hx-color-neutral-200, #dee2e6));
+  }
+
+  .nav__collapsible--open {
+    display: flex;
+    animation: hx-mobile-nav-open var(--hx-duration-fast, 150ms) ease-out;
+  }
+
+  /* ─── Menu and actions in collapsible (mobile) ─── */
+
+  .nav__menu,
+  .nav__actions {
+    display: flex;
+    flex-direction: column;
+    gap: var(--hx-space-1, 0.25rem);
+    padding-inline: var(--hx-top-nav-padding-x, var(--hx-space-6, 1.5rem));
+  }
+
+  .nav__actions {
+    margin-top: var(--hx-space-3, 0.75rem);
+    padding-top: var(--hx-space-3, 0.75rem);
+    border-top: var(--hx-border-width-thin, 1px) solid
+      var(--hx-top-nav-border-color, var(--hx-color-neutral-200, #dee2e6));
+  }
+
+  /* ─── Desktop breakpoint ─── */
+
+  /* NOTE: CSS @media queries do not support custom properties.
+     This value corresponds to --hx-breakpoint-md (768px). */
+  @media (min-width: 768px) {
+    /* Make nav a flex row so bar and collapsible sit side-by-side */
+    .nav {
+      display: flex;
+      align-items: center;
+      padding-inline: var(--hx-top-nav-padding-x, var(--hx-space-6, 1.5rem));
+    }
+
+    .nav__bar {
+      flex-shrink: 0;
+      padding-inline: 0;
+      min-height: var(--hx-top-nav-height, var(--hx-space-16, 4rem));
+    }
+
+    /* Hide hamburger on desktop */
+    .mobile-toggle {
+      display: none;
+    }
+
+    /* Collapsible becomes a standard inline flex row */
+    .nav__collapsible {
+      display: flex;
+      flex-direction: row;
+      align-items: center;
+      flex: 1;
+      padding-block: 0;
+      border-top: none;
+      margin-inline-start: auto;
+      gap: var(--hx-space-4, 1rem);
+      animation: none;
+    }
+
+    /* Override open modifier — always visible on desktop regardless of state */
+    .nav__collapsible--open {
+      display: flex;
+      animation: none;
+    }
+
+    /* Menu grows to fill available space */
+    .nav__menu {
+      display: flex;
+      flex-direction: row;
+      align-items: center;
+      gap: var(--hx-space-1, 0.25rem);
+      flex: 1;
+      padding-inline: 0;
+    }
+
+    /* Actions sit at the far right */
+    .nav__actions {
+      display: flex;
+      flex-direction: row;
+      align-items: center;
+      gap: var(--hx-space-2, 0.5rem);
+      margin-top: 0;
+      padding-top: 0;
+      padding-inline: 0;
+      border-top: none;
+      flex-shrink: 0;
+    }
+  }
+
+  /* ─── Mobile menu open animation ─── */
+
+  @keyframes hx-mobile-nav-open {
+    from {
+      opacity: 0;
+      transform: translateY(-0.25rem);
+    }
+    to {
+      opacity: 1;
+      transform: translateY(0);
+    }
+  }
+
+  /* ─── Reduced motion ─── */
+
+  @media (prefers-reduced-motion: reduce) {
+    .nav__collapsible--open {
+      animation: none;
+    }
+  }