/* StartHDS v1 core - dependency-free public design-system base.
   Contract: stable --hds-* tokens, base elements, layout primitives,
   navigation base, generic cards/buttons/forms/feedback, docs helpers,
   utilities, mobile navigation safeguards, and ds-* aliases. */
:root {
  color-scheme: light;
  --hds-color-background: #f8fafc;
  --hds-color-background-muted: #eef4fb;
  --hds-color-surface: #ffffff;
  --hds-color-surface-muted: #f1f5f9;
  --hds-color-surface-elevated: #ffffff;
  --hds-color-text: #162033;
  --hds-color-heading: #0f172a;
  --hds-color-text-muted: #64748b;
  --hds-color-border: #d7dde8;
  --hds-color-border-strong: #aeb9ca;
  --hds-color-primary: #2457d6;
  --hds-color-primary-hover: #1d45ad;
  --hds-color-primary-soft: #e8efff;
  --hds-color-primary-contrast: #ffffff;
  --hds-color-accent: #0ea5e9;
  --hds-color-accent-soft: #e0f2fe;
  --hds-color-danger: #dc2626;
  --hds-color-danger-soft: #fee2e2;
  --hds-color-warning: #b45309;
  --hds-color-warning-soft: #fef3c7;
  --hds-color-success: #15803d;
  --hds-color-success-soft: #dcfce7;
  --hds-color-info: #0369a1;
  --hds-color-info-soft: #e0f2fe;

  --hds-status-info-text: var(--hds-color-info);
  --hds-status-info-surface: var(--hds-color-info-soft);
  --hds-status-info-border: #7dd3fc;
  --hds-status-success-text: var(--hds-color-success);
  --hds-status-success-surface: var(--hds-color-success-soft);
  --hds-status-success-border: #86efac;
  --hds-status-warning-text: var(--hds-color-warning);
  --hds-status-warning-surface: var(--hds-color-warning-soft);
  --hds-status-warning-border: #fcd34d;
  --hds-status-danger-text: var(--hds-color-danger);
  --hds-status-danger-surface: var(--hds-color-danger-soft);
  --hds-status-danger-border: #fca5a5;
  --hds-color-trust: #0f766e;
  --hds-color-trust-soft: #ccfbf1;
  --hds-color-trust-border: #5eead4;
  --hds-color-verified: #2563eb;
  --hds-color-verified-soft: #dbeafe;
  --hds-color-verified-border: #93c5fd;
  --hds-severity-low-text: var(--hds-status-info-text);
  --hds-severity-low-surface: var(--hds-status-info-surface);
  --hds-severity-low-border: var(--hds-status-info-border);
  --hds-severity-medium-text: var(--hds-status-warning-text);
  --hds-severity-medium-surface: var(--hds-status-warning-surface);
  --hds-severity-medium-border: var(--hds-status-warning-border);
  --hds-severity-high-text: var(--hds-status-danger-text);
  --hds-severity-high-surface: var(--hds-status-danger-surface);
  --hds-severity-high-border: var(--hds-status-danger-border);
  --hds-color-task: var(--hds-color-primary);
  --hds-color-task-soft: var(--hds-color-primary-soft);
  --hds-color-notification: var(--hds-color-info);
  --hds-color-notification-soft: var(--hds-color-info-soft);
  --hds-color-media: var(--hds-color-accent);
  --hds-color-media-soft: var(--hds-color-accent-soft);
  --hds-color-task-urgent: var(--hds-color-danger);
  --hds-color-admin: #334155;
  --hds-color-admin-soft: #e2e8f0;
  --hds-color-moderation: var(--hds-color-warning);
  --hds-color-moderation-soft: var(--hds-color-warning-soft);
  --hds-color-attachment: var(--hds-color-media);
  --hds-color-attachment-soft: var(--hds-color-media-soft);
  --hds-lightbox-background: rgb(2 6 23 / .88);
  --hds-lightbox-text: #ffffff;
  --hds-lightbox-max-width: 72rem;

  --hds-font-family-base: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
  --hds-font-family-heading: var(--hds-font-family-base);
  --hds-font-family-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace;
  --hds-font-size-xs: .75rem;
  --hds-font-size-sm: .875rem;
  --hds-font-size-base: 1rem;
  --hds-font-size-lg: 1.125rem;
  --hds-font-size-xl: 1.35rem;
  --hds-font-size-2xl: clamp(1.7rem, 3vw, 2.25rem);
  --hds-font-size-hero: clamp(2.25rem, 6vw, 4.5rem);
  --hds-line-height-tight: 1.1;
  --hds-line-height-base: 1.6;
  --hds-letter-spacing-tight: -0.035em;
  --hds-letter-spacing-wide: .08em;

  --hds-space-0: 0;
  --hds-space-1: .25rem;
  --hds-space-2: .5rem;
  --hds-space-3: .75rem;
  --hds-space-4: 1rem;
  --hds-space-5: 1.25rem;
  --hds-space-6: 1.5rem;
  --hds-space-8: 2rem;
  --hds-space-10: 2.5rem;
  --hds-space-12: 3rem;
  --hds-space-16: 4rem;
  --hds-section-padding: clamp(2.5rem, 7vw, 6rem);
  --hds-container-max-width: 72rem;
  --hds-container-narrow-width: 48rem;
  --hds-readable-max-width: 42rem;
  --hds-content-max-width: 64rem;
  --hds-content-width: var(--hds-content-max-width);
  --hds-content-wide-width: 84rem;
  --hds-reading-measure: 68ch;
  --hds-reading-width: var(--hds-reading-measure);
  --hds-app-sidebar-width: 18rem;
  --hds-app-aside-width: 20rem;
  --hds-app-header-height: 4rem;
  --hds-appbar-height: var(--hds-app-header-height);
  --hds-app-footer-height: 4.5rem;
  --hds-app-gap: var(--hds-space-5);
  --hds-app-chrome-background: color-mix(in srgb, var(--hds-color-surface, #fff) 92%, transparent);
  --hds-app-chrome-border: var(--hds-color-border);
  --hds-mobile-page-max-width: 30rem;
  --hds-mobile-tabbar-height: 4.75rem;
  --hds-safe-area-top: env(safe-area-inset-top, 0px);
  --hds-safe-area-right: env(safe-area-inset-right, 0px);
  --hds-safe-area-bottom: env(safe-area-inset-bottom, 0px);
  --hds-safe-area-left: env(safe-area-inset-left, 0px);
  --hds-grid-min: 18rem;
  --hds-grid-gap: var(--hds-space-6);

  --hds-radius-small: .375rem;
  --hds-radius-medium: .75rem;
  --hds-radius-large: 1.25rem;
  --hds-radius-card: 1rem;
  --hds-radius-button: 999rem;
  --hds-radius-input: .75rem;
  --hds-radius-pill: 999rem;
  --hds-shadow-small: 0 .25rem .75rem rgb(15 23 42 / .07);
  --hds-shadow-card: 0 1rem 2rem rgb(15 23 42 / .10);
  --hds-shadow-panel: 0 .5rem 1.5rem rgb(15 23 42 / .08);
  --hds-shadow-large: 0 1.5rem 4rem rgb(15 23 42 / .16);
  --hds-shadow-overlay: 0 1.5rem 5rem rgb(15 23 42 / .22);
  --hds-elevation-overlay-background: rgb(15 23 42 / .48);
  --hds-backdrop-color: rgb(15 23 42 / .44);
  --hds-sheet-background: var(--hds-color-surface);
  --hds-sheet-max-width: 36rem;
  --hds-sheet-radius: calc(var(--hds-radius-large, 1.25rem) + .25rem);
  --hds-dialog-max-width: 42rem;
  --hds-dialog-wide-max-width: 72rem;
  --hds-dialog-radius: var(--hds-radius-large);
  --hds-focus-ring-color: #7aa2ff;
  --hds-focus-ring-width: 3px;
  --hds-focus-ring-offset: 3px;
  --hds-transition-duration: 160ms;
  --hds-motion-duration-fast: var(--hds-transition-duration);
  --hds-transition-easing: cubic-bezier(.2, .8, .2, 1);
  --hds-motion-reduced-duration: .01ms;
  --hds-motion-reduce-duration: var(--hds-motion-reduced-duration);
  --hds-autosave-delay: 800ms;
  --hds-autosave-duration: var(--hds-autosave-delay);
  --hds-skeleton-duration: 1200ms;
  --hds-z-base: 0;
  --hds-z-dropdown: 100;
  --hds-z-sticky: 200;
  --hds-z-appbar: 250;
  --hds-z-command: 450;
  --hds-z-menu: 500;
  --hds-z-sheet: 700;
  --hds-z-overlay: 800;
  --hds-z-modal: 1000;
  --hds-z-toast: 1100;
  --hds-density-scale: 1;
  --hds-density-compact: .875;
  --hds-density-comfortable: 1;
  --hds-touch-target-min: 2.75rem;
  --hds-touch-target-comfortable: 3rem;
  --hds-icon-button-size: 2.75rem;
  --hds-button-height: 2.75rem;
  --hds-button-padding-inline: 1rem;
  --hds-input-height: 2.75rem;
  --hds-input-padding-inline: .85rem;
  --hds-form-gap: var(--hds-space-3);
}

* { box-sizing: border-box; }
html { min-height: 100%; color-scheme: light; scroll-behavior: smooth; }
body {
  min-height: 100%;
  margin: 0;
  background: var(--hds-color-background, #f8fafc);
  color: var(--hds-color-text, #162033);
  font-family: var(--hds-font-family-base, system-ui, sans-serif);
  font-size: var(--hds-font-size-base, 1rem);
  line-height: var(--hds-line-height-base, 1.6);
  text-rendering: optimizeLegibility;
}
img, svg, video { max-width: 100%; height: auto; }
button, input, textarea, select { font: inherit; }
a { color: var(--hds-color-primary, #2457d6); font-weight: 700; text-decoration-thickness: .08em; text-underline-offset: .18em; }
a:hover { color: var(--hds-color-primary-hover, #1d45ad); }
:focus-visible { outline: var(--hds-focus-ring-width, 3px) solid var(--hds-focus-ring-color, #7aa2ff); outline-offset: var(--hds-focus-ring-offset, 3px); }
[hidden] { display: none !important; }

.hds-container { width: min(100% - 2rem, var(--hds-container-max-width, 72rem)); margin-inline: auto; }
.hds-container--narrow { width: min(100% - 2rem, var(--hds-container-narrow-width, 48rem)); }
.hds-section { padding-block: var(--hds-section-padding, 4rem); }
.hds-section--compact { padding-block: var(--hds-space-4, 1rem); }
.hds-section--surface { background: var(--hds-color-surface-muted, #f1f5f9); }
.hds-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(var(--hds-grid-min, 18rem), 100%), 1fr)); gap: var(--hds-grid-gap, 1.5rem); }
.hds-grid--dense { --hds-grid-min: 14rem; --hds-grid-gap: var(--hds-space-4, 1rem); }
.hds-stack { display: grid; gap: var(--hds-space-6, 1.5rem); }
.hds-stack--sm { gap: var(--hds-space-3, .75rem); }
.hds-cluster { display: flex; flex-wrap: wrap; align-items: center; gap: var(--hds-space-3, .75rem) var(--hds-space-4, 1rem); }
.hds-split { display: grid; grid-template-columns: minmax(0, 1.35fr) minmax(min(22rem, 100%), .65fr); gap: var(--hds-space-8, 2rem); align-items: center; }

.hds-site-header { position: sticky; top: 0; z-index: var(--hds-z-sticky, 200); border-bottom: 1px solid var(--hds-color-border, #d7dde8); background: color-mix(in srgb, var(--hds-color-surface, #fff) 88%, transparent); backdrop-filter: blur(16px); -webkit-backdrop-filter: blur(16px); }
.hds-site-nav { min-height: 4rem; display: flex; align-items: center; justify-content: space-between; gap: var(--hds-space-4, 1rem); }
.hds-site-nav__brand { display: inline-flex; align-items: center; gap: var(--hds-space-2, .5rem); color: var(--hds-color-heading, #0f172a); font-size: clamp(1.15rem, 2vw, 1.35rem); font-weight: 900; line-height: 1; letter-spacing: var(--hds-letter-spacing-tight, -0.035em); text-decoration: none; }
.hds-site-nav__links { display: flex; flex-wrap: wrap; align-items: center; gap: var(--hds-space-2, .5rem); }
.hds-site-nav__links a { border-radius: var(--hds-radius-pill, 999rem); padding: .45rem .7rem; line-height: 1.1; text-decoration: none; }
.hds-site-nav__links a:hover, .hds-site-nav__links a:focus-visible, .hds-site-nav__links a[aria-current="page"], .hds-site-nav__links a.hds-active { background: var(--hds-color-primary-soft, #e8efff); color: var(--hds-color-primary, #2457d6); }
.hds-nav-toggle { display: none; }
.hds-nav-lock { overflow: hidden; }

/* Core drawer primitive: visible side panel on larger screens, toggleable drawer on mobile. */
.hds-drawer-layout {
  display: grid;
  grid-template-columns: minmax(14rem, var(--hds-drawer-width, 18rem)) minmax(0, 1fr);
  gap: var(--hds-drawer-gap, var(--hds-space-6, 1.5rem));
  align-items: start;
}
.hds-drawer { min-width: 0; }
.hds-drawer-panel {
  min-width: 0;
  display: grid;
  align-content: start;
  gap: var(--hds-space-3, .75rem);
  border: 1px solid var(--hds-color-border, #d7dde8);
  border-radius: var(--hds-radius-card, 1rem);
  background: var(--hds-color-surface, #fff);
  padding: var(--hds-space-4, 1rem);
  box-shadow: var(--hds-shadow-panel, 0 .5rem 1.5rem rgb(15 23 42 / .08));
}
.hds-drawer-panel a { position: relative; border-radius: var(--hds-radius-pill, 999rem); padding: .5rem .8rem .5rem 1rem; color: var(--hds-color-text-muted, #64748b); text-decoration: none; font-weight: 850; }
.hds-drawer-panel a:hover, .hds-drawer-panel a:focus-visible, .hds-drawer-panel a[aria-current="page"], .hds-drawer-panel a.hds-active { background: var(--hds-color-primary-soft, #e8efff); color: var(--hds-color-primary, #2457d6); text-decoration: none; }
.hds-drawer-panel a[aria-current="page"]::before, .hds-drawer-panel a.hds-active::before { content: ""; position: absolute; left: .45rem; top: 50%; width: .28rem; height: 1.35rem; border-radius: var(--hds-radius-pill, 999rem); background: currentColor; transform: translateY(-50%); opacity: .72; }
.hds-drawer-main { min-width: 0; }
.hds-drawer-toggle, .hds-drawer-backdrop { display: none; }
.hds-drawer-lock { overflow: hidden; }


/* Optional drawer mode: collapsed/reveal behavior at every viewport size. */
.hds-drawer-layout--overlay { grid-template-columns: minmax(0, 1fr); }
.hds-drawer--overlay { position: relative; z-index: var(--hds-z-sticky, 200); }
.hds-drawer--overlay .hds-drawer-toggle {
  min-height: var(--hds-button-height, 2.75rem);
  display: inline-flex;
  align-items: center;
  justify-content: center;
  gap: .5rem;
  border: 1px solid var(--hds-color-border, #d7dde8);
  border-radius: var(--hds-radius-button, 999rem);
  background: var(--hds-color-surface, #fff);
  color: var(--hds-color-text, #162033);
  padding: .65rem var(--hds-button-padding-inline, 1rem);
  box-shadow: var(--hds-shadow-small, 0 .25rem .75rem rgb(15 23 42 / .07));
  font: inherit;
  font-weight: 850;
  line-height: 1;
  text-decoration: none;
  cursor: pointer;
}
.hds-drawer--overlay .hds-drawer-backdrop {
  position: fixed;
  inset: 0;
  z-index: calc(var(--hds-z-modal, 1000) - 2);
  display: block;
  border: 0;
  background: var(--hds-backdrop-color, rgb(15 23 42 / .44));
  opacity: 0;
  pointer-events: none;
  visibility: hidden;
  transition: opacity var(--hds-transition-duration, 160ms) var(--hds-transition-easing, ease), visibility 0s linear var(--hds-transition-duration, 160ms);
}
.hds-drawer--overlay .hds-drawer-panel {
  position: fixed;
  inset-block: 0;
  left: 0;
  z-index: calc(var(--hds-z-modal, 1000) - 1);
  width: min(var(--hds-drawer-mobile-width, 20rem), calc(100vw - 3rem));
  max-height: 100dvh;
  overflow: auto;
  border-radius: 0 var(--hds-radius-large, 1.25rem) var(--hds-radius-large, 1.25rem) 0;
  padding: max(var(--hds-space-6, 1.5rem), var(--hds-safe-area-top, 0px)) var(--hds-space-4, 1rem) max(var(--hds-space-6, 1.5rem), var(--hds-safe-area-bottom, 0px));
  transform: translateX(-102%);
  visibility: hidden;
  transition: transform var(--hds-transition-duration, 160ms) var(--hds-transition-easing, ease), visibility 0s linear var(--hds-transition-duration, 160ms);
}
.hds-drawer--overlay.is-open .hds-drawer-backdrop {
  opacity: 1;
  pointer-events: auto;
  visibility: visible;
  transition-delay: 0s;
}
.hds-drawer--overlay.is-open .hds-drawer-panel {
  transform: translateX(0);
  visibility: visible;
  transition-delay: 0s;
}
@media (max-width: 760px) {
  .hds-drawer-layout { grid-template-columns: 1fr; }
  .hds-drawer { position: sticky; top: calc(var(--hds-app-header-height, 4rem) + var(--hds-space-2, .5rem)); z-index: var(--hds-z-sticky, 200); }
  .hds-drawer-toggle {
    min-height: var(--hds-button-height, 2.75rem);
    display: inline-flex;
    align-items: center;
    justify-content: center;
    gap: .5rem;
    border: 1px solid var(--hds-color-border, #d7dde8);
    border-radius: var(--hds-radius-button, 999rem);
    background: var(--hds-color-surface, #fff);
    color: var(--hds-color-text, #162033);
    padding: .65rem var(--hds-button-padding-inline, 1rem);
    box-shadow: var(--hds-shadow-small, 0 .25rem .75rem rgb(15 23 42 / .07));
    font: inherit;
    font-weight: 850;
    line-height: 1;
    cursor: pointer;
  }
  .hds-drawer-backdrop {
    position: fixed;
    inset: 0;
    z-index: calc(var(--hds-z-modal, 1000) - 2);
    border: 0;
    background: var(--hds-backdrop-color, rgb(15 23 42 / .44));
    opacity: 0;
    pointer-events: none;
    visibility: hidden;
    transition: opacity var(--hds-transition-duration, 160ms) var(--hds-transition-easing, ease), visibility 0s linear var(--hds-transition-duration, 160ms);
  }
  .hds-drawer-panel {
    position: fixed;
    inset-block: 0;
    left: 0;
    z-index: calc(var(--hds-z-modal, 1000) - 1);
    width: min(var(--hds-drawer-mobile-width, 20rem), calc(100vw - 3rem));
    max-height: 100dvh;
    overflow: auto;
    border-radius: 0 var(--hds-radius-large, 1.25rem) var(--hds-radius-large, 1.25rem) 0;
    padding: max(var(--hds-space-6, 1.5rem), var(--hds-safe-area-top, 0px)) var(--hds-space-4, 1rem) max(var(--hds-space-6, 1.5rem), var(--hds-safe-area-bottom, 0px));
    transform: translateX(-102%);
    visibility: hidden;
    transition: transform var(--hds-transition-duration, 160ms) var(--hds-transition-easing, ease), visibility 0s linear var(--hds-transition-duration, 160ms);
  }
  .hds-drawer--right .hds-drawer-panel {
    left: auto;
    right: 0;
    border-radius: var(--hds-radius-large, 1.25rem) 0 0 var(--hds-radius-large, 1.25rem);
    transform: translateX(102%);
  }
  .hds-drawer.is-open .hds-drawer-backdrop {
    opacity: 1;
    pointer-events: auto;
    visibility: visible;
    transition-delay: 0s;
  }
  .hds-drawer.is-open .hds-drawer-panel {
    transform: translateX(0);
    visibility: visible;
    transition-delay: 0s;
  }
}

.hds-site-footer { border-top: 1px solid var(--hds-color-border, #d7dde8); background: var(--hds-color-surface, #fff); color: var(--hds-color-text-muted, #64748b); }
.hds-site-footer__inner { display: grid; gap: var(--hds-space-4, 1rem); padding-block: var(--hds-space-6, 1.5rem); }
.hds-site-footer__brand { color: var(--hds-color-heading, #0f172a); font-weight: 900; text-decoration: none; }
.hds-site-footer__links { display: flex; flex-wrap: wrap; gap: var(--hds-space-2, .5rem) var(--hds-space-4, 1rem); }
.hds-site-footer__links a { color: inherit; text-decoration-thickness: .08em; text-underline-offset: .18em; }
.hds-site-footer__meta { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: var(--hds-space-3, .75rem); font-size: var(--hds-font-size-sm, .875rem); }


.hds-hero, .hds-panel, .hds-card {
  background: var(--hds-color-surface, #fff);
  border: 1px solid var(--hds-color-border, #d7dde8);
  border-radius: var(--hds-radius-card, 1rem);
  box-shadow: var(--hds-shadow-card, 0 1rem 2rem rgb(15 23 42 / .10));
  padding: clamp(1.25rem, 4vw, 3rem);
}
.hds-hero { overflow: hidden; background: linear-gradient(135deg, color-mix(in srgb, var(--hds-color-primary, #2457d6) 12%, white), var(--hds-color-surface, #fff)); }
.hds-hero h1 { max-width: 14ch; font-size: var(--hds-font-size-hero, clamp(2.25rem, 6vw, 4.5rem)); line-height: var(--hds-line-height-tight, 1.1); letter-spacing: var(--hds-letter-spacing-tight, -0.035em); margin-block: 0 var(--hds-space-4, 1rem); }
.hds-hero p { max-width: var(--hds-readable-max-width, 42rem); }
.hds-panel { box-shadow: var(--hds-shadow-panel, 0 .5rem 1.5rem rgb(15 23 42 / .08)); }
.hds-card { display: grid; gap: var(--hds-space-3, .75rem); }
.hds-card:hover { border-color: var(--hds-color-border-strong, #aeb9ca); }
.hds-card h1, .hds-card h2, .hds-panel h2 { line-height: var(--hds-line-height-tight, 1.1); margin-block: 0 var(--hds-space-2, .5rem); font-family: var(--hds-font-family-heading, system-ui, sans-serif); color: var(--hds-color-heading, #0f172a); }
.hds-prose { max-width: var(--hds-readable-max-width, 42rem); }
.hds-prose :where(h1, h2, h3) { line-height: var(--hds-line-height-tight, 1.1); letter-spacing: var(--hds-letter-spacing-tight, -0.035em); color: var(--hds-color-heading, #0f172a); }
.hds-eyebrow, .hds-badge { letter-spacing: var(--hds-letter-spacing-wide, .08em); text-transform: uppercase; font-size: var(--hds-font-size-xs, .75rem); font-weight: 850; color: var(--hds-color-primary, #2457d6); }
.hds-badge { display: inline-flex; width: max-content; align-items: center; gap: .35rem; border: 1px solid var(--hds-color-border, #d7dde8); border-radius: var(--hds-radius-pill, 999rem); padding: .2rem .6rem; background: var(--hds-color-primary-soft, #e8efff); text-decoration: none; }

.hds-button { min-height: var(--hds-button-height, 2.75rem); display: inline-flex; align-items: center; justify-content: center; gap: .5rem; border-radius: var(--hds-radius-button, 999rem); border: 1px solid var(--hds-color-border, #d7dde8); padding: .65rem var(--hds-button-padding-inline, 1rem); background: var(--hds-color-surface, #fff); color: var(--hds-color-text, #162033); font-weight: 800; text-decoration: none; transition: transform var(--hds-transition-duration, 160ms) var(--hds-transition-easing, ease), background var(--hds-transition-duration, 160ms), border-color var(--hds-transition-duration, 160ms), box-shadow var(--hds-transition-duration, 160ms); cursor: pointer; }
.hds-button:hover { transform: translateY(-1px); box-shadow: var(--hds-shadow-small, 0 .25rem .75rem rgb(15 23 42 / .07)); }
.hds-button:disabled, .hds-button[aria-disabled="true"] { opacity: .55; cursor: not-allowed; transform: none; box-shadow: none; }
.hds-button--primary { background: var(--hds-color-primary, #2457d6); color: var(--hds-color-primary-contrast, #fff); border-color: transparent; }
.hds-button--secondary { background: var(--hds-color-primary-soft, #e8efff); color: var(--hds-color-primary, #2457d6); border-color: color-mix(in srgb, var(--hds-color-primary, #2457d6) 18%, transparent); }
.hds-button--ghost { border-color: transparent; background: transparent; box-shadow: none; }
.hds-button--danger { background: var(--hds-color-danger, #dc2626); color: #fff; border-color: transparent; }
/* Keep nav toggles hidden on desktop even when composed with .hds-button classes. */
.hds-nav-toggle { display: none; }
.hds-actions { display: flex; flex-wrap: wrap; align-items: center; gap: var(--hds-space-3, .75rem); }

.hds-control-bar { min-width: 0; display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: var(--hds-space-3, .75rem); border: 1px solid var(--hds-color-border, #d7dde8); border-radius: var(--hds-radius-card, 1rem); background: var(--hds-color-surface, #fff); padding: var(--hds-space-3, .75rem); box-shadow: var(--hds-shadow-small, 0 .25rem .75rem rgb(15 23 42 / .07)); }
.hds-control-bar__inner { min-width: 0; width: min(100%, var(--hds-container-max-width, 72rem)); margin-inline: auto; display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: var(--hds-space-3, .75rem); }
.hds-control-bar__group { min-width: 0; display: flex; flex-wrap: wrap; align-items: center; gap: var(--hds-space-2, .5rem); }
.hds-control-bar__button { min-height: calc(var(--hds-button-height, 2.75rem) - .35rem); display: inline-flex; align-items: center; justify-content: center; gap: var(--hds-space-2, .5rem); border: 1px solid var(--hds-color-border, #d7dde8); border-radius: var(--hds-radius-button, 999rem); background: var(--hds-color-surface, #fff); color: var(--hds-color-text, #162033); padding: .45rem .75rem; font: inherit; font-weight: 800; line-height: 1.1; text-decoration: none; cursor: pointer; }
.hds-control-bar__button:hover, .hds-control-bar__button:focus-visible, .hds-control-bar__button[aria-pressed="true"], .hds-control-bar__button[aria-expanded="true"], .hds-control-bar__button[aria-current="page"], .hds-control-bar__button.hds-active { border-color: color-mix(in srgb, var(--hds-color-primary, #2457d6) 28%, var(--hds-color-border, #d7dde8)); background: var(--hds-color-primary-soft, #e8efff); color: var(--hds-color-primary, #2457d6); text-decoration: none; }
.hds-status-message { min-width: 0; display: inline-flex; align-items: center; gap: var(--hds-space-2, .5rem); border: 1px solid var(--hds-status-info-border, #7dd3fc); border-radius: var(--hds-radius-pill, 999rem); background: var(--hds-status-info-surface, #e0f2fe); color: var(--hds-status-info-text, #0369a1); padding: .35rem .7rem; font-size: var(--hds-font-size-sm, .875rem); font-weight: 800; overflow-wrap: anywhere; }
.hds-status-message::before { content: ""; flex: 0 0 auto; width: .55rem; height: .55rem; border-radius: var(--hds-radius-pill, 999rem); background: currentColor; }
.hds-status-message[data-state="idle"], .hds-status-message[data-state="info"] { border-color: var(--hds-status-info-border, #7dd3fc); background: var(--hds-status-info-surface, #e0f2fe); color: var(--hds-status-info-text, #0369a1); }
.hds-status-message[data-state="success"], .hds-status-message[data-state="saved"] { border-color: var(--hds-status-success-border, #86efac); background: var(--hds-status-success-surface, #dcfce7); color: var(--hds-status-success-text, #15803d); }
.hds-status-message[data-state="warning"], .hds-status-message[data-state="dirty"] { border-color: var(--hds-status-warning-border, #fcd34d); background: var(--hds-status-warning-surface, #fef3c7); color: var(--hds-status-warning-text, #b45309); }
.hds-status-message[data-state="error"] { border-color: var(--hds-status-danger-border, #fca5a5); background: var(--hds-status-danger-surface, #fee2e2); color: var(--hds-status-danger-text, #dc2626); }
.hds-status-message[data-state="loading"]::before, .hds-status-message[data-state="saving"]::before { background: transparent; border: 2px solid currentColor; border-right-color: transparent; animation: hds-spin var(--hds-skeleton-duration, 1200ms) linear infinite; }
.hds-skip-link { position: absolute; inset-block-start: var(--hds-space-2, .5rem); inset-inline-start: var(--hds-space-2, .5rem); z-index: var(--hds-z-toast, 1100); transform: translateY(-150%); border-radius: var(--hds-radius-button, 999rem); background: var(--hds-color-surface, #fff); color: var(--hds-color-heading, #0f172a); padding: .55rem .85rem; box-shadow: var(--hds-shadow-overlay, 0 1.5rem 5rem rgb(15 23 42 / .22)); text-decoration: none; font-weight: 900; }
.hds-skip-link:focus, .hds-skip-link:focus-visible { transform: translateY(0); }
@keyframes hds-spin { to { transform: rotate(360deg); } }

.hds-alert, .hds-flash { border: 1px solid var(--hds-color-border, #d7dde8); border-left-width: .35rem; border-radius: var(--hds-radius-medium, .75rem); padding: var(--hds-space-4, 1rem); background: var(--hds-color-surface, #fff); }
.hds-alert--info, .hds-flash--info { border-left-color: var(--hds-color-info, #0369a1); background: var(--hds-color-info-soft, #e0f2fe); }
.hds-alert--success, .hds-flash--success { border-left-color: var(--hds-color-success, #15803d); background: var(--hds-color-success-soft, #dcfce7); }
.hds-alert--warning, .hds-flash--warning { border-left-color: var(--hds-color-warning, #b45309); background: var(--hds-color-warning-soft, #fef3c7); }
.hds-alert--danger, .hds-flash--error { border-left-color: var(--hds-color-danger, #dc2626); background: var(--hds-color-danger-soft, #fee2e2); }
.hds-flash { display: flex; justify-content: space-between; gap: var(--hds-space-3, .75rem); align-items: flex-start; box-shadow: var(--hds-shadow-small, 0 .25rem .75rem rgb(15 23 42 / .07)); }
.hds-flash__close { border: 0; background: transparent; color: inherit; cursor: pointer; font-weight: 900; }
.hds-empty-state { display: grid; place-items: center; min-height: 14rem; text-align: center; border: 1px dashed var(--hds-color-border-strong, #aeb9ca); border-radius: var(--hds-radius-card, 1rem); padding: var(--hds-space-8, 2rem); background: var(--hds-color-surface-muted, #f1f5f9); }
.hds-empty-state > * { max-width: 34rem; }

.hds-form { display: grid; gap: var(--hds-form-gap, .75rem); }
.hds-form-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(16rem, 100%), 1fr)); gap: var(--hds-space-4, 1rem); }
.hds-form-field { display: grid; gap: var(--hds-space-2, .5rem); }
.hds-label { font-weight: 800; color: var(--hds-color-heading, #0f172a); }
.hds-input, .hds-select, .hds-textarea { width: 100%; min-height: var(--hds-input-height, 2.75rem); border: 1px solid var(--hds-color-border, #d7dde8); border-radius: var(--hds-radius-input, .75rem); padding: .65rem var(--hds-input-padding-inline, .85rem); background: var(--hds-color-surface, #fff); color: var(--hds-color-text, #162033); }
.hds-textarea { min-height: 8rem; resize: vertical; }
.hds-input:focus, .hds-select:focus, .hds-textarea:focus { border-color: var(--hds-color-primary, #2457d6); box-shadow: 0 0 0 4px color-mix(in srgb, var(--hds-focus-ring-color, #7aa2ff) 28%, transparent); outline: none; }
.hds-help-text { color: var(--hds-color-text-muted, #64748b); font-size: var(--hds-font-size-sm, .875rem); }
.hds-field-error { color: var(--hds-color-danger, #dc2626); font-size: var(--hds-font-size-sm, .875rem); font-weight: 700; }

/* Core docs helpers and utilities. */
.hds-example { border: 1px dashed var(--hds-color-border, #d7dde8); border-radius: var(--hds-radius-card, 1rem); padding: var(--hds-space-6, 1.5rem); background: color-mix(in srgb, var(--hds-color-surface, #fff) 82%, transparent); }
.hds-token-table { width: 100%; border-collapse: collapse; background: var(--hds-color-surface, #fff); border-radius: var(--hds-radius-card, 1rem); overflow: hidden; box-shadow: var(--hds-shadow-small, 0 .25rem .75rem rgb(15 23 42 / .07)); }
.hds-token-table th, .hds-token-table td { text-align: left; border-bottom: 1px solid var(--hds-color-border, #d7dde8); padding: .75rem 1rem; vertical-align: top; }
.hds-token-table th { background: var(--hds-color-surface-muted, #f1f5f9); color: var(--hds-color-heading, #0f172a); }
.hds-code-block { max-width: 100%; overflow-x: auto; overflow-wrap: anywhere; background: #0f172a; color: #e2e8f0; border-radius: var(--hds-radius-medium, .75rem); padding: var(--hds-space-4, 1rem); font-family: var(--hds-font-family-mono, monospace); font-size: var(--hds-font-size-sm, .875rem); }
.hds-alert code, .hds-flash code, .hds-code-block code, code.hds-code { overflow-wrap: anywhere; word-break: break-word; }

.hds-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; }
.hds-muted { color: var(--hds-color-text-muted, #64748b); }
.hds-text-center { text-align: center; }
.hds-full-width { width: 100%; }
.hds-hidden { display: none !important; }
.hds-nowrap { white-space: nowrap; }
.hds-mt-0 { margin-top: 0; }
.hds-mb-0 { margin-bottom: 0; }

.ds-container { width: min(100% - 2rem, var(--hds-container-max-width, 72rem)); margin-inline: auto; }
.ds-button { min-height: var(--hds-button-height, 2.75rem); display: inline-flex; align-items: center; justify-content: center; border-radius: var(--hds-radius-button, 999rem); border: 1px solid var(--hds-color-border, #d7dde8); padding: .65rem var(--hds-button-padding-inline, 1rem); font-weight: 800; text-decoration: none; }
.ds-card { background: var(--hds-color-surface, #fff); border: 1px solid var(--hds-color-border, #d7dde8); border-radius: var(--hds-radius-card, 1rem); box-shadow: var(--hds-shadow-card, 0 1rem 2rem rgb(15 23 42 / .10)); padding: clamp(1.25rem, 4vw, 3rem); }

@media (max-width: 760px) {
  .hds-split { grid-template-columns: 1fr; }
  .hds-site-header { min-height: 4.5rem; isolation: isolate; }
  .hds-site-nav { min-height: 4.5rem; align-items: center; gap: var(--hds-space-3, .75rem); }
  .hds-site-nav__brand, .hds-nav-toggle { position: relative; z-index: calc(var(--hds-z-modal, 1000) + 2); }
  .hds-site-nav__brand { min-height: 2.75rem; }
  .hds-nav-toggle {
    min-height: var(--hds-button-height, 2.75rem);
    display: inline-flex;
    align-items: center;
    justify-content: center;
    gap: .5rem;
    margin-block: 0;
    border: 1px solid color-mix(in srgb, var(--hds-color-border, #d7dde8) 80%, transparent);
    border-radius: var(--hds-radius-button, 999rem);
    padding: .65rem var(--hds-button-padding-inline, 1rem);
    background: color-mix(in srgb, var(--hds-color-surface, #fff) 86%, transparent);
    box-shadow: none;
    color: var(--hds-color-text, #162033);
    cursor: pointer;
    font: inherit;
    font-weight: 800;
    line-height: 1;
    text-decoration: none;
    transition: transform var(--hds-transition-duration, 160ms) var(--hds-transition-easing, ease), background var(--hds-transition-duration, 160ms), border-color var(--hds-transition-duration, 160ms), box-shadow var(--hds-transition-duration, 160ms);
  }
  .hds-nav-toggle:hover { transform: translateY(-1px); box-shadow: var(--hds-shadow-small, 0 .25rem .75rem rgb(15 23 42 / .07)); }
  .hds-site-nav[data-hds-collapsible="true"] .hds-site-nav__links {
    position: fixed;
    inset: 0;
    z-index: calc(var(--hds-z-modal, 1000) + 1);
    width: auto;
    min-height: 100vh;
    min-height: 100dvh;
    display: flex;
    flex-direction: column;
    flex-wrap: nowrap;
    align-items: stretch;
    justify-content: center;
    gap: var(--hds-space-4, 1rem);
    padding: clamp(6rem, 18vh, 8rem) clamp(1.25rem, 6vw, 2rem) max(2rem, env(safe-area-inset-bottom));
    background:
      radial-gradient(circle at 20% 12%, color-mix(in srgb, var(--hds-color-primary, #2457d6) 16%, transparent), transparent 24rem),
      linear-gradient(180deg, color-mix(in srgb, var(--hds-color-surface, #fff) 96%, transparent), var(--hds-color-background, #f8fafc));
    backdrop-filter: blur(22px) saturate(1.15);
    -webkit-backdrop-filter: blur(22px) saturate(1.15);
    opacity: 0;
    pointer-events: none;
    visibility: hidden;
    transform: translateY(-.75rem) scale(.985);
    transition:
      opacity 220ms var(--hds-transition-easing, ease),
      transform 220ms var(--hds-transition-easing, ease),
      visibility 0s linear 220ms;
  }
  .hds-site-nav[data-hds-collapsible="true"].is-open .hds-site-nav__links {
    opacity: 1;
    pointer-events: auto;
    visibility: visible;
    transform: translateY(0) scale(1);
    transition-delay: 0s;
  }
  .hds-site-nav[data-hds-collapsible="true"] .hds-site-nav__links a {
    width: min(100%, 28rem);
    margin-inline: auto;
    display: flex;
    align-items: center;
    justify-content: center;
    min-height: 3.45rem;
    border: 1px solid color-mix(in srgb, var(--hds-color-primary, #2457d6) 16%, var(--hds-color-border, #d7dde8));
    border-radius: calc(var(--hds-radius-large, 1.25rem) + .25rem);
    background: color-mix(in srgb, var(--hds-color-surface, #fff) 82%, transparent);
    box-shadow: var(--hds-shadow-small, 0 .25rem .75rem rgb(15 23 42 / .07));
    color: var(--hds-color-heading, #0f172a);
    font-size: clamp(1.1rem, 5vw, 1.35rem);
    font-weight: 850;
    text-align: center;
  }
  .hds-site-nav[data-hds-collapsible="true"] .hds-site-nav__links a:hover,
  .hds-site-nav[data-hds-collapsible="true"] .hds-site-nav__links a:focus-visible,
  .hds-site-nav[data-hds-collapsible="true"] .hds-site-nav__links a[aria-current="page"] {
    background: var(--hds-color-primary, #2457d6);
    border-color: var(--hds-color-primary, #2457d6);
    color: var(--hds-color-primary-contrast, #fff);
    text-decoration: none;
    transform: translateY(-1px);
  }
}

@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after { scroll-behavior: auto !important; transition-duration: var(--hds-motion-reduced-duration, .01ms) !important; animation-duration: var(--hds-motion-reduced-duration, .01ms) !important; animation-iteration-count: 1 !important; }
  .hds-button:hover { transform: none; }
}


/* Icon primitive: StartHDS owns icon sizing, color inheritance, and SVG fitting. */
.hds-icon {
  width: var(--hds-icon-size, 1.125rem);
  min-width: var(--hds-icon-size, 1.125rem);
  max-width: var(--hds-icon-size, 1.125rem);
  height: var(--hds-icon-size, 1.125rem);
  min-height: var(--hds-icon-size, 1.125rem);
  max-height: var(--hds-icon-size, 1.125rem);
  display: inline-flex;
  flex: 0 0 var(--hds-icon-size, 1.125rem);
  align-items: center;
  justify-content: center;
  color: currentColor;
  line-height: 1;
  vertical-align: -0.175em;
  pointer-events: none;
}
.hds-icon > svg {
  width: 100%;
  height: 100%;
  display: block;
  fill: none;
  stroke: currentColor;
  stroke-width: 2;
  stroke-linecap: round;
  stroke-linejoin: round;
}
.hds-icon--xs { --hds-icon-size: .875rem; }
.hds-icon--sm { --hds-icon-size: 1rem; }
.hds-icon--md { --hds-icon-size: 1.25rem; }
.hds-icon--lg { --hds-icon-size: 1.5rem; }
.hds-icon--xl { --hds-icon-size: 2rem; }
.hds-icon-label { display: inline-flex; align-items: center; gap: var(--hds-space-2, .5rem); }
.hds-icon-button .hds-icon { --hds-icon-size: var(--hds-icon-button-icon-size, 1.125rem); }
.hds-button:has(.hds-icon),
.hds-site-nav__links a:has(.hds-icon),
.hds-drawer-panel a:has(.hds-icon),
.hds-tab:has(.hds-icon) { display: inline-flex; align-items: center; gap: var(--hds-space-2, .5rem); }
.hds-mobile-tabbar__item:has(.hds-icon) { display: grid; place-items: center; gap: var(--hds-space-1, .25rem); }
.hds-icon-card { display: grid; gap: var(--hds-space-3, .75rem); align-content: start; }
.hds-icon-card .hds-icon { color: var(--hds-color-primary, #2457d6); }

/* Phase 2 component icon composition additions. Icons remain optional and token-backed. */
.hds-site-nav__brand:has(.hds-icon),
.hds-nav-toggle:has(.hds-icon),
.hds-actions > a:has(.hds-icon),
.hds-actions > button:has(.hds-icon) { display: inline-flex; align-items: center; gap: var(--hds-space-2, .5rem); }
.hds-card > .hds-icon:first-child,
.hds-panel > .hds-icon:first-child,
.hds-empty-state > .hds-icon:first-child,
.hds-alert > .hds-icon:first-child { color: var(--hds-color-primary, #2457d6); }
.hds-alert:has(.hds-icon) { display: flex; align-items: flex-start; gap: var(--hds-space-2, .5rem); }
.hds-empty-state:has(.hds-icon) { display: grid; justify-items: center; gap: var(--hds-space-3, .75rem); }
