@layer components {
  /* Buttons */
  .btn {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    gap: 0.5rem;
    min-block-size: 44px;
    padding: 0.625rem 1.25rem;
    border: 1px solid transparent;
    border-radius: var(--radius-md);
    font-size: var(--text-sm);
    font-weight: 600;
    line-height: 1.25;
    text-decoration: none;
    cursor: pointer;
    transition: background-color 0.15s ease, border-color 0.15s ease, color 0.15s ease, transform 0.1s ease;
  }

  .btn:active {
    transform: translateY(1px);
  }

  .btn-sm {
    min-block-size: 38px;
    padding: 0.45rem 0.9rem;
    font-size: var(--text-xs);
  }

  .btn-lg {
    min-block-size: 48px;
    padding: 0.75rem 1.5rem;
    font-size: var(--text-base);
  }

  .btn-primary {
    background: var(--accent);
    color: var(--accent-contrast);
  }

  .btn-primary:hover {
    background: var(--accent-hover);
    color: var(--accent-contrast);
  }

  .btn-secondary {
    background: var(--surface-elevated);
    border-color: var(--border-strong);
    color: var(--text-primary);
  }

  .btn-secondary:hover {
    background: var(--surface-subtle);
    color: var(--text-primary);
  }

  .btn-ghost {
    background: transparent;
    color: var(--text-secondary);
  }

  .btn-ghost:hover {
    background: var(--surface-subtle);
    color: var(--text-primary);
  }

  .btn-icon {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    inline-size: 42px;
    block-size: 42px;
    padding: 0;
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-md);
    background: var(--surface-elevated);
    color: var(--text-secondary);
    cursor: pointer;
    transition: background-color 0.15s ease, color 0.15s ease, border-color 0.15s ease;
  }

  .btn-icon:hover {
    background: var(--surface-subtle);
    border-color: var(--border-strong);
    color: var(--text-primary);
  }

  /* Theme toggle button states (works with and without JS) */
  .theme-toggle {
    display: inline-flex;
    align-items: center;
    gap: 0.45rem;
  }

  .theme-toggle .theme-state-light {
    display: none;
  }

  .theme-toggle .theme-state-dark {
    display: inline-flex;
    align-items: center;
    gap: 0.45rem;
  }

  @media (prefers-color-scheme: dark) {
    :root:not(:has(> head > meta[name="color-scheme"][content="light"])):not([data-theme="light"]) .theme-toggle .theme-state-dark {
      display: none;
    }

    :root:not(:has(> head > meta[name="color-scheme"][content="light"])):not([data-theme="light"]) .theme-toggle .theme-state-light {
      display: inline-flex;
      align-items: center;
      gap: 0.45rem;
    }
  }

  :root:has(> head > meta[name="color-scheme"][content="dark"]) .theme-toggle .theme-state-dark,
  :root[data-theme="dark"] .theme-toggle .theme-state-dark {
    display: none;
  }

  :root:has(> head > meta[name="color-scheme"][content="dark"]) .theme-toggle .theme-state-light,
  :root[data-theme="dark"] .theme-toggle .theme-state-light {
    display: inline-flex;
    align-items: center;
    gap: 0.45rem;
  }

  :root:has(> head > meta[name="color-scheme"][content="light"]) .theme-toggle .theme-state-dark,
  :root[data-theme="light"] .theme-toggle .theme-state-dark {
    display: inline-flex;
    align-items: center;
    gap: 0.45rem;
  }

  :root:has(> head > meta[name="color-scheme"][content="light"]) .theme-toggle .theme-state-light,
  :root[data-theme="light"] .theme-toggle .theme-state-light {
    display: none;
  }

  /* Badges & Tags */
  .eyebrow {
    display: inline-block;
    margin-block-end: 0.75rem;
    font-size: var(--text-xs);
    font-weight: 700;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--accent);
  }

  .badge {
    display: inline-flex;
    align-items: center;
    padding: 0.2rem 0.6rem;
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-pill);
    background: var(--accent-tint);
    color: var(--accent);
    font-size: var(--text-xs);
    font-weight: 600;
    line-height: 1.4;
  }

  .tag-list {
    display: flex;
    flex-wrap: wrap;
    gap: 0.45rem;
    list-style: none;
    margin: 0;
    padding: 0;
  }

  .tag {
    display: inline-flex;
    align-items: center;
    padding: 0.2rem 0.65rem;
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-pill);
    background: var(--surface-muted);
    color: var(--text-secondary);
    font-size: var(--text-xs);
    font-weight: 500;
    text-decoration: none;
    transition: border-color 0.15s ease, color 0.15s ease, background-color 0.15s ease;
  }

  .tag:hover {
    border-color: var(--accent);
    background: var(--accent-tint);
    color: var(--accent);
  }

  /* Cards */
  .card {
    display: flex;
    flex-direction: column;
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-lg);
    background: var(--surface-elevated);
    overflow: hidden;
    transition: border-color 0.15s ease, box-shadow 0.15s ease, transform 0.15s ease;
  }

  .card:hover {
    border-color: var(--border-strong);
    box-shadow: var(--shadow-md);
  }

  /* Alerts & Messages */
  .alert {
    padding: 0.9rem 1.15rem;
    margin-block-end: 1.25rem;
    border: 1px solid var(--info-border);
    border-radius: var(--radius-md);
    background: var(--info-bg);
    color: var(--info-fg);
    font-size: var(--text-sm);
  }

  .alert-success {
    border-color: var(--success-border);
    background: var(--success-bg);
    color: var(--success-fg);
  }

  .alert-warning {
    border-color: var(--warning-border);
    background: var(--warning-bg);
    color: var(--warning-fg);
  }

  .alert-error,
  .alert-danger {
    border-color: var(--danger-border);
    background: var(--danger-bg);
    color: var(--danger-fg);
  }

  /* Breadcrumbs */
  .breadcrumbs {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: 0.4rem;
    list-style: none;
    margin: 0 0 1.25rem;
    padding: 0;
    font-size: var(--text-sm);
    color: var(--text-muted);
  }

  .breadcrumbs li {
    display: inline-flex;
    align-items: center;
    gap: 0.4rem;
  }

  .breadcrumbs li + li::before {
    content: "/";
    color: var(--border-strong);
  }

  .breadcrumbs a {
    color: var(--text-muted);
    text-decoration: none;
  }

  .breadcrumbs a:hover {
    color: var(--accent);
  }

  /* Pagination */
  .pagination {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    justify-content: center;
    gap: 0.35rem;
    list-style: none;
    margin: 2.5rem 0 0;
    padding: 0;
  }

  .pagination a,
  .pagination span {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    min-inline-size: 40px;
    block-size: 40px;
    padding-inline: 0.65rem;
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-md);
    font-size: var(--text-sm);
    font-weight: 500;
    text-decoration: none;
    color: var(--text-secondary);
    background: var(--surface-elevated);
  }

  .pagination a:hover {
    border-color: var(--border-strong);
    background: var(--surface-subtle);
    color: var(--text-primary);
  }

  .pagination li.active span {
    border-color: var(--accent);
    background: var(--accent);
    color: var(--accent-contrast);
  }

  .pagination li.disabled span {
    opacity: 0.45;
    cursor: default;
  }

  /* Code copy button */
  .code-copy-btn {
    position: absolute;
    inset-block-start: 0.65rem;
    inset-inline-end: 0.65rem;
    padding: 0.3rem 0.65rem;
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-sm);
    background: var(--surface-elevated);
    color: var(--text-secondary);
    font-family: var(--font-sans);
    font-size: var(--text-xs);
    font-weight: 600;
    cursor: pointer;
    opacity: 0.85;
    transition: opacity 0.15s ease, border-color 0.15s ease, color 0.15s ease;
  }

  .code-copy-btn:hover,
  .code-copy-btn:focus-visible {
    opacity: 1;
    border-color: var(--accent);
    color: var(--accent);
  }

  /* Accessible FAQ Accordion (<details>) */
  .faq-list {
    display: grid;
    gap: 0.75rem;
    max-inline-size: 52rem;
    margin-inline: auto;
  }

  .faq-item {
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-lg);
    background: var(--surface-elevated);
    overflow: hidden;
  }

  .faq-item[open] {
    border-color: var(--border-strong);
  }

  .faq-summary {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 1rem;
    padding: 1.15rem 1.35rem;
    font-weight: 600;
    color: var(--text-primary);
    cursor: pointer;
    list-style: none;
  }

  .faq-summary::-webkit-details-marker {
    display: none;
  }

  .faq-chevron {
    flex-shrink: 0;
    color: var(--text-muted);
    transition: transform 0.2s ease;
  }

  .faq-item[open] .faq-chevron {
    transform: rotate(180deg);
    color: var(--accent);
  }

  .faq-answer {
    padding: 0 1.35rem 1.25rem;
    color: var(--text-secondary);
    font-size: 0.95rem;
    line-height: 1.65;
  }

  /* Modern Navigation Drawer (popover="manual" + scroll-snap + scroll-driven backdrop) */
  .drawer {
    --drawer-width: min(21rem, 84dvw);
    --drawer-backdrop: 0;
    width: auto;
    height: auto;
    inset: 0;
    margin: 0;
    padding: 0;
    background: transparent;
    border: 0;
    overflow: visible;
    color: inherit;
  }

  .drawer::backdrop {
    background: #000000;
    opacity: calc(var(--drawer-backdrop) / 2);
  }

  .drawer-scroller {
    position: relative;
    display: grid;
    grid-template-columns: var(--drawer-width) 100%;
    overflow-x: scroll;
    overscroll-behavior: none;
    scrollbar-width: none;
    scroll-snap-type: x mandatory;
  }

  @media (prefers-reduced-motion: no-preference) {
    .drawer-scroller {
      scroll-behavior: smooth;
    }
  }

  .drawer-scroller::after {
    content: "";
    scroll-snap-align: end;
    scroll-initial-target: nearest;
  }

  .drawer-sheet {
    display: grid;
    grid-template-rows: auto 1fr auto;
    height: 100svh;
    background: var(--surface-elevated);
    color: var(--text-primary);
    border-inline-end: 1px solid var(--border-subtle);
    overflow-y: auto;
    scroll-snap-align: start;
    scrollbar-width: thin;
  }

  .drawer-sheet:focus {
    outline: none;
  }

  .drawer-header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 1rem;
    padding: 1rem 1.25rem;
    border-block-end: 1px solid var(--border-subtle);
  }

  .drawer-body {
    padding: 1.25rem;
    overflow-y: auto;
  }

  .drawer-footer {
    padding: 1rem 1.25rem;
    border-block-start: 1px solid var(--border-subtle);
  }

  /* MANDATORY: Gate @keyframes + animation-timeline inside @supports */
  @supports (animation-timeline: scroll()) {
    .drawer {
      timeline-scope: --drawer-fade;
      animation: fade-drawer-backdrop linear both;
      animation-timeline: --drawer-fade;
    }

    .drawer-scroller {
      scroll-timeline: --drawer-fade x;
    }

    @property --drawer-backdrop {
      syntax: "<number>";
      inherits: true;
      initial-value: 0;
    }

    @keyframes fade-drawer-backdrop {
      0% { --drawer-backdrop: 1; }
      100% { --drawer-backdrop: 0; }
    }
  }

  /* Non-popover fallback for browsers lacking HTMLElement.showPopover */
  .drawer.drawer-no-popover {
    display: none;
    position: fixed;
    inset: 0;
    z-index: var(--z-drawer);
    background: rgba(0, 0, 0, calc(var(--drawer-backdrop) / 2));
  }

  .drawer.drawer-no-popover.is-open {
    display: block;
  }

  /* Forms & Post-Interaction Validation (:user-invalid + fallback) */
  .form-group {
    margin-block-end: 1.35rem;
  }

  .form-label-wrap {
    margin-block-end: 0.4rem;
  }

  .form-label {
    display: inline-block;
    font-size: var(--text-sm);
    font-weight: 600;
    color: var(--text-primary);
  }

  .form-label .required {
    color: var(--danger-fg);
    margin-inline-start: 0.2rem;
  }

  .form-control,
  .form-select,
  .form-input-wrapper input[type="text"],
  .form-input-wrapper input[type="email"],
  .form-input-wrapper input[type="url"],
  .form-input-wrapper input[type="tel"],
  .form-input-wrapper input[type="number"],
  .form-input-wrapper input[type="password"],
  .form-input-wrapper textarea,
  .form-input-wrapper select {
    display: block;
    inline-size: 100%;
    min-block-size: 48px;
    padding: 0.7rem 0.9rem;
    border: 1px solid var(--border-strong);
    border-radius: var(--radius-md);
    background: var(--bg-base);
    color: var(--text-primary);
    font-size: 1rem;
    line-height: 1.45;
    transition: border-color 0.15s ease, box-shadow 0.15s ease, background-color 0.15s ease;
  }

  @media (pointer: coarse) {
    .form-control,
    .form-select,
    .form-input-wrapper input,
    .form-input-wrapper select {
      min-block-size: 52px;
    }
  }

  textarea.form-control,
  .form-input-wrapper textarea {
    min-block-size: 7.5rem;
    resize: vertical;
  }

  .form-control:focus,
  .form-select:focus {
    outline: none;
    border-color: var(--accent);
    box-shadow: 0 0 0 3px color-mix(in oklab, var(--accent) 22%, transparent);
  }

  .form-control:user-invalid,
  .form-select:user-invalid,
  .form-control.user-invalid-fallback,
  .form-select.user-invalid-fallback {
    border-color: var(--danger-fg);
    background-color: var(--danger-bg);
  }

  .form-control:user-valid,
  .form-select:user-valid,
  .form-control.user-valid-fallback,
  .form-select.user-valid-fallback {
    border-color: var(--success-fg);
  }

  .form-error-msg {
    display: none;
    margin-block-start: 0.35rem;
    font-size: var(--text-xs);
    font-weight: 500;
    color: var(--danger-fg);
  }

  .form-control:user-invalid + .form-error-msg,
  .form-select:user-invalid + .form-error-msg,
  .form-control.user-invalid-fallback + .form-error-msg,
  .form-select.user-invalid-fallback + .form-error-msg {
    display: block;
  }

  .form-field-help,
  .form-extra-wrapper {
    display: block;
    margin-block-start: 0.35rem;
    font-size: var(--text-xs);
    color: var(--text-muted);
  }

  .form-errors {
    margin-block-end: 1.25rem;
    padding: 0.85rem 1rem;
    border: 1px solid var(--danger-border);
    border-radius: var(--radius-md);
    background: var(--danger-bg);
    color: var(--danger-fg);
    font-size: var(--text-sm);
  }

  .form-checkbox,
  .form-radio {
    display: inline-flex;
    align-items: center;
    gap: 0.6rem;
    min-block-size: 44px;
    cursor: pointer;
    font-size: var(--text-sm);
    color: var(--text-secondary);
  }

  .form-checkbox input,
  .form-radio input {
    inline-size: 1.15rem;
    block-size: 1.15rem;
    margin: 0;
  }

  .form-actions {
    display: flex;
    flex-wrap: wrap;
    gap: 0.75rem;
    margin-block-start: 1.5rem;
  }
}
