@layer base, components, utilities;

@layer base {
  :root {
    color-scheme: dark;

    /* Ruido Monochrome Palette */
    --ground: #050505;
    --ground-glass: rgba(5, 5, 5, 0.94);
    --panel: #0e0e0e;
    --subpanel: #141414;
    --border: #262626;
    --border-knob: #333333;
    --border-active: #525252;
    --chip-btn-bg: #383838;
    --chip-btn-border: #606060;
    --chip-knob-bg: #000000;
    --chip-knob-border: #333333;
    --chip-key-bg: #000000;
    --chip-key-border: #333333;
    --fg: #f5f5f5;
    --btn-surface: #e2e2e2;
    --white: #ffffff;
    --dim: #a3a3a3;
    --muted: #737373;

    /* Typography */
    --font-headline: "Archivo", -apple-system, BlinkMacSystemFont, sans-serif;
    --font-sans: "Space Grotesk", -apple-system, BlinkMacSystemFont, sans-serif;
    --font-mono: "Space Mono", ui-monospace, SFMono-Regular, Menlo, monospace;

    /* Layout */
    --header-height: 52px;
    --column-max: 780px;
    --gutter: clamp(1rem, 3vw, 1.5rem);
  }

  :where(
    html, body, header, main, footer, section, nav, figure, figcaption,
    details, summary, div, span, p, h1, h2, h3, h4, ol, ul, dl, dt, dd,
    li, a, button, img, kbd
  ) {
    box-sizing: border-box;
    border-radius: 0;
  }

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

  body {
    margin: 0;
    padding: 0;
    inline-size: 100%;
    min-block-size: 100dvh;
    background-color: var(--ground);
    color: var(--fg);
    font-family: var(--font-sans);
    font-size: clamp(0.75rem, 0.7rem + 0.25vw, 0.84375rem);
    line-height: 1.6;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
  }

  ::selection {
    background-color: var(--fg);
    color: var(--ground);
  }

  h1,
  h2,
  h3,
  h4 {
    font-family: var(--font-headline);
    margin: 0;
    color: var(--fg);
    text-transform: uppercase;
  }

  :where(h1, h2, .index-title):focus {
    outline: none;
  }

  p,
  figure,
  ol,
  ul,
  dl,
  dd {
    margin: 0;
    padding: 0;
  }

  ol,
  ul {
    list-style: none;
  }

  img {
    display: block;
    max-inline-size: 100%;
    block-size: auto;
  }

  a {
    color: inherit;
    text-decoration: none;
  }

  code {
    font-family: var(--font-mono);
    font-size: 0.92em;
    color: var(--fg);
  }

  :where([id]) {
    scroll-margin-block-start: calc(var(--header-height) + 1rem);
  }

  :where(a:any-link, button, summary):focus-visible {
    outline: 2px solid var(--fg);
    outline-offset: 3px;
  }
}

@layer components {
  /* Sticky Top Bar */
  .site-header {
    position: sticky;
    inset-block-start: 0;
    z-index: 50;
    inline-size: 100%;
    min-block-size: var(--header-height);
    display: flex;
    align-items: center;
    border-block-end: 1px solid var(--border);
  }

  .site-header::before {
    content: "";
    position: absolute;
    inset: 0;
    z-index: -1;
    pointer-events: none;
    background-color: var(--ground-glass);
    backdrop-filter: blur(8px);
    -webkit-backdrop-filter: blur(8px);
  }

  .site-header.is-measuring * {
    transition: none !important;
  }

  .header-inner {
    inline-size: 100%;
    max-inline-size: var(--column-max);
    min-block-size: calc(var(--header-height) - 1px);
    margin-inline: auto;
    padding-inline: var(--gutter);
    padding-block: 0.25rem;
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 0.75rem;
  }

  .header-inner > * {
    flex-shrink: 0;
    white-space: nowrap;
  }

  .brand-mark {
    position: relative;
    font-family: var(--font-mono);
    font-size: 0.75rem;
    font-weight: 700;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--fg);
    display: inline-flex;
    align-items: center;
    gap: 0.45rem;
    min-block-size: 28px;
    flex-shrink: 0;
    transition: color 0.12s ease, opacity 0.12s ease;
  }

  .brand-mark::after {
    content: "";
    position: absolute;
    inset-inline: 0;
    inset-block-end: 3px;
    block-size: 1px;
    background-color: var(--white);
    opacity: 0;
    pointer-events: none;
    transition: opacity 0.12s ease;
  }

  .brand-logo {
    display: block;
    block-size: 11px;
    inline-size: auto;
    opacity: 0.94;
    transition: opacity 0.12s ease;
  }

  .brand-mark:hover {
    color: var(--white);
  }

  .brand-mark:hover .brand-logo,
  .brand-mark:hover::after {
    opacity: 1;
  }

  .header-nav {
    display: flex;
    align-items: center;
  }

  /* Collapsed default: monochrome hardware hamburger button + native popover menu */
  .menu-button {
    anchor-name: --menu-button;
    display: inline-flex;
    align-items: center;
    justify-content: center;
    min-inline-size: 2.25rem;
    min-block-size: 2.25rem;
    padding: 0.5rem;
    background-color: var(--subpanel);
    border: 1px solid var(--border);
    color: var(--fg);
    cursor: pointer;
    transition:
      border-color 0.12s ease,
      background-color 0.12s ease,
      color 0.12s ease;
  }

  .menu-button:hover {
    border-color: var(--border-active);
    color: var(--white);
  }

  .menu-button:active {
    background-color: var(--panel);
  }

  .menu-button[aria-expanded="true"] {
    background-color: var(--panel);
    border-color: var(--fg);
    color: var(--white);
  }

  .menu-bars {
    position: relative;
    display: block;
    inline-size: 1rem;
    block-size: 1.5px;
    background-color: currentColor;
    transition: background-color 0.14s ease;
  }

  .menu-bars::before,
  .menu-bars::after {
    content: "";
    position: absolute;
    inset-inline: 0;
    block-size: 1.5px;
    background-color: currentColor;
    transform-origin: center;
    transition:
      translate 0.16s cubic-bezier(0.25, 0.8, 0.25, 1),
      rotate 0.16s cubic-bezier(0.25, 0.8, 0.25, 1);
  }

  .menu-bars::before {
    inset-block-start: -5px;
  }

  .menu-bars::after {
    inset-block-start: 5px;
  }

  .menu-button[aria-expanded="true"] .menu-bars {
    background-color: transparent;
  }

  .menu-button[aria-expanded="true"] .menu-bars::before {
    translate: 0 5px;
    rotate: 45deg;
  }

  .menu-button[aria-expanded="true"] .menu-bars::after {
    translate: 0 -5px;
    rotate: -45deg;
  }

  @media (prefers-reduced-motion: reduce) {
    .menu-bars,
    .menu-bars::before,
    .menu-bars::after {
      transition: none;
    }
  }

  .header-links {
    position: fixed;
    inset: auto;
    inset-block-start: 2.75rem;
    inset-block-start: anchor(--menu-button bottom);
    inset-inline-start: var(--gutter);
    inset-inline-end: var(--gutter);
    inline-size: auto;
    max-inline-size: 26rem;
    margin-inline-start: auto;
    block-size: fit-content;
    max-block-size: calc(100dvh - var(--header-height) - 1rem);
    margin-block-start: 0.5rem;
    padding: 0.5rem;
    overflow-y: auto;
    background-color: var(--panel);
    border: 1px solid var(--border-knob);
    box-shadow: 0 16px 36px rgba(0, 0, 0, 0.72);
    font-family: var(--font-mono);
    font-size: 0.875rem;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--fg);
  }

  .header-links[popover]:is(:popover-open, .\:popover-open) {
    display: flex;
    flex-direction: column;
    align-items: stretch;
    gap: 0;
  }

  .header-links::backdrop {
    background-color: rgba(0, 0, 0, 0.45);
  }

  @media (prefers-reduced-motion: no-preference) {
    .site-header:not(.is-wide) .header-links[popover] {
      opacity: 0;
      translate: 0 -0.25rem;
      transition:
        opacity 0.16s ease-out,
        translate 0.16s ease-out,
        overlay 0.16s,
        display 0.16s;
      transition-behavior: allow-discrete;
    }

    .site-header:not(.is-wide) .header-links[popover]:is(:popover-open, .\:popover-open) {
      opacity: 1;
      translate: 0 0;
    }

    @starting-style {
      .site-header:not(.is-wide) .header-links[popover]:is(:popover-open, .\:popover-open) {
        opacity: 0;
        translate: 0 -0.25rem;
      }
    }
  }

  .header-links .nav-sep {
    display: none;
  }

  .header-links > li:not(.nav-sep):not(.nav-cta) {
    border-block-end: 1px solid var(--border);
  }

  .nav-link {
    display: flex;
    align-items: center;
    min-block-size: 2.75rem;
    padding-inline: 0.5rem;
    font-weight: 700;
    color: var(--fg);
    transition: color 0.12s ease, background-color 0.12s ease;
  }

  .nav-link:hover {
    color: var(--white);
    text-decoration: underline;
    text-underline-offset: 4px;
  }

  .nav-link:active {
    background-color: var(--subpanel);
  }

  .nav-cta {
    padding-block-start: 0.625rem;
  }

  .nav-cta .btn-flash-sm {
    inline-size: 100%;
    min-block-size: 2.625rem;
    font-size: 0.8125rem;
  }

  /* Wide layout: exact inline desktop row */
  .site-header.is-wide {
    .menu-button {
      display: none;
    }

    .header-links {
      position: static;
      display: inline-flex;
      flex-direction: row;
      align-items: center;
      gap: clamp(0.3rem, 1.2vw, 0.5rem);
      inline-size: auto;
      max-inline-size: none;
      block-size: auto;
      max-block-size: none;
      margin: 0;
      padding: 0;
      overflow: visible;
      background: transparent;
      border: 0;
      box-shadow: none;
      font-size: 0.625rem;
      letter-spacing: 0.06em;
      color: var(--dim);
    }

    .header-links::backdrop {
      display: none;
    }

    .header-links .nav-sep {
      display: inline;
    }

    .header-links > li:not(.nav-sep):not(.nav-cta) {
      border-block-end: 0;
    }

    .nav-link {
      display: inline-flex;
      min-block-size: 28px;
      padding-inline: 0.15rem;
      font-weight: 400;
      color: inherit;
    }

    .nav-link:hover {
      color: var(--white);
    }

    .nav-link:active {
      background-color: transparent;
    }

    .nav-cta {
      padding-block-start: 0;
      margin-inline-start: clamp(0.2rem, 0.8vw, 0.375rem);
    }

    .nav-cta .btn-flash-sm {
      inline-size: auto;
      min-block-size: 26px;
      font-size: 0.625rem;
    }
  }

  .btn-flash-sm {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    min-block-size: 26px;
    padding: 0.25rem 0.625rem;
    background-color: var(--btn-surface);
    color: var(--ground);
    border: 1px solid var(--btn-surface);
    font-family: var(--font-mono);
    font-size: 0.625rem;
    font-weight: 700;
    letter-spacing: 0.06em;
    text-transform: uppercase;
    text-decoration: none;
    flex-shrink: 0;
    translate: 0 0;
    transition:
      background-color 120ms ease-out,
      border-color 120ms ease-out,
      box-shadow 150ms ease-out,
      translate 60ms ease-out;
  }

  .btn-flash-sm:is(:hover, :active, :focus-visible, .is-bloomed) {
    background-color: var(--white);
    color: var(--ground);
    border-color: var(--white);
    text-decoration: none;
    box-shadow:
      0 0 2px 0 rgba(255, 255, 255, 0.95),
      0 0 14px 1px rgba(255, 255, 255, 0.36);
  }

  .btn-flash-sm:active {
    transition-duration: 25ms;
  }

  @media (prefers-reduced-motion: no-preference) {
    .btn-flash-sm:active {
      translate: 0 1px;
    }
  }

  /* Main Stacked Column (Fluid up to 780px) */
  .guide-column {
    inline-size: 100%;
    max-inline-size: var(--column-max);
    margin-inline: auto;
    padding-inline: var(--gutter);
    padding-block-start: clamp(1.5rem, 3vw, 2.25rem);
    padding-block-end: clamp(2.5rem, 4vw, 3.5rem);
    display: flex;
    flex-direction: column;
    gap: 2rem;
  }

  /* Masthead */
  .masthead {
    display: flex;
    flex-direction: column;
    gap: 0.75rem;
  }

  .eyebrow {
    font-family: var(--font-mono);
    font-size: 0.625rem;
    letter-spacing: 0.12em;
    text-transform: uppercase;
    color: var(--dim);
  }

  .eyebrow--muted {
    color: var(--muted);
  }

  .page-title {
    display: flex;
    align-items: center;
    flex-wrap: wrap;
    gap: 0.28em 0.34em;
    font-size: clamp(1.875rem, 1.5rem + 1.6vw, 2.5rem);
    font-weight: 800;
    letter-spacing: -0.025em;
    line-height: 1.02;
  }

  .page-title-logo {
    display: block;
    block-size: 0.72em;
    inline-size: auto;
    transform: translateY(-0.02em);
  }

  .lead-copy {
    font-size: clamp(0.875rem, 0.83rem + 0.2vw, 0.96875rem);
    line-height: 1.6;
    color: var(--dim);
  }

  /* Index Jump Box */
  .index-card {
    background-color: var(--panel);
    border: 1px solid var(--border);
    padding: 1rem 1.125rem;
    display: flex;
    flex-direction: column;
    gap: 0.75rem;
  }

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

  .index-title {
    font-family: var(--font-mono);
    font-size: 0.75rem;
    font-weight: 700;
    letter-spacing: 0.06em;
    text-transform: uppercase;
    color: var(--fg);
  }

  .index-count {
    font-family: var(--font-mono);
    font-size: 0.625rem;
    text-transform: uppercase;
    color: var(--muted);
  }

  .index-list {
    display: flex;
    flex-direction: column;
    gap: 0.2rem;
    font-family: var(--font-mono);
    font-size: 0.75rem;
    color: var(--dim);
  }

  .index-list a {
    display: inline-flex;
    align-items: center;
    min-block-size: 26px;
    transition: color 0.12s ease;
  }

  .index-list a:hover {
    color: var(--white);
    text-decoration: underline;
    text-underline-offset: 3px;
  }

  /* Chapter Sections */
  .chapter {
    display: flex;
    flex-direction: column;
    gap: 1rem;
    padding-block-start: 1.25rem;
    border-block-start: 1px solid var(--border);
  }

  .chapter-bar {
    display: flex;
    align-items: baseline;
    justify-content: space-between;
    gap: 0.75rem;
  }

  .chapter-heading {
    font-size: clamp(1rem, 0.94rem + 0.3vw, 1.1875rem);
    font-weight: 700;
    letter-spacing: 0.02em;
    line-height: 1.2;
  }

  .return-link {
    flex-shrink: 0;
    display: inline-flex;
    align-items: center;
    min-block-size: 24px;
    font-family: var(--font-mono);
    font-size: 0.625rem;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--muted);
    transition: color 0.12s ease;
  }

  .return-link:hover {
    color: var(--white);
    text-decoration: underline;
    text-underline-offset: 3px;
  }

  .subsection {
    display: flex;
    flex-direction: column;
    gap: 0.625rem;
  }

  .subsection + .subsection {
    margin-block-start: 0.75rem;
  }

  .subsection-heading {
    font-size: 0.75rem;
    font-weight: 700;
    letter-spacing: 0.06em;
    color: var(--dim);
  }

  .prose {
    color: var(--dim);
    line-height: 1.625;
    overflow-wrap: break-word;
  }

  .inline-link {
    color: var(--fg);
    text-decoration: underline;
    text-decoration-color: var(--border-active);
    text-underline-offset: 3px;
    transition:
      color 0.14s ease-out,
      text-decoration-color 0.14s ease-out,
      background-color 0.12s ease-out;
  }

  .inline-link:hover {
    color: var(--white);
    text-decoration: underline;
    text-decoration-color: var(--white);
  }

  .inline-link:active {
    background-color: rgba(255, 255, 255, 0.14);
    transition-duration: 26ms;
  }

  /* Stacked Cards & Lists */
  .stack-sm {
    display: flex;
    flex-direction: column;
    gap: 0.5rem;
  }

  .card {
    background-color: var(--panel);
    border: 1px solid var(--border);
    padding: 0.75rem 0.875rem;
    display: flex;
    flex-direction: column;
    gap: 0.3rem;
  }

  .card-row {
    display: flex;
    flex-wrap: wrap;
    align-items: baseline;
    justify-content: space-between;
    gap: 0.25rem 0.5rem;
  }

  .card-title {
    font-family: var(--font-mono);
    font-size: 0.75rem;
    font-weight: 700;
    text-transform: uppercase;
    color: var(--fg);
  }

  .card-index {
    color: var(--muted);
    margin-inline-end: 0.5rem;
    font-variant-numeric: tabular-nums;
  }

  .card-tag {
    font-family: var(--font-mono);
    font-size: 0.625rem;
    text-transform: uppercase;
    color: var(--muted);
    flex-shrink: 0;
  }

  /* Hardware & 240x240 CRT Specimen Frames */
  .specimen-frame {
    background-color: var(--panel);
    border: 1px solid var(--border);
    padding: 0.625rem;
    display: flex;
    flex-direction: column;
    align-items: center;
  }

  .hardware-diagram {
    display: block;
    inline-size: 100%;
    max-inline-size: 712px;
    block-size: auto;
    user-select: none;
  }

  .hw-photo {
    opacity: 0.44;
  }

  .hw-dim-key {
    fill: #050505;
    fill-opacity: 0.82;
  }

  .hw-line {
    fill: none;
    stroke: rgba(255, 255, 255, 0.68);
    stroke-width: 1.25px;
    stroke-linecap: square;
    stroke-linejoin: miter;
    vector-effect: non-scaling-stroke;
  }

  .hw-zone {
    fill: none;
    stroke: rgba(255, 255, 255, 0.56);
    stroke-width: 1.25px;
    stroke-dasharray: 5 4;
    vector-effect: non-scaling-stroke;
  }

  .hw-dot {
    fill: var(--white);
    stroke: #050505;
    stroke-width: 2.5px;
  }

  .hw-label {
    font-family: var(--font-mono);
    font-weight: 700;
    letter-spacing: 0.03em;
    fill: var(--white);
  }

  .hw-label--outer {
    font-size: 23px;
  }

  .hw-label--mid {
    font-size: 20px;
    paint-order: stroke;
    stroke: #080808;
    stroke-width: 6px;
    stroke-linejoin: round;
  }

  .hw-label--btn {
    font-size: 19px;
    paint-order: stroke;
    stroke: #080808;
    stroke-width: 6px;
    stroke-linejoin: round;
  }

  @media (forced-colors: active) {
    .hw-line,
    .hw-zone {
      stroke: CanvasText;
    }

    .hw-dot,
    .hw-label {
      fill: CanvasText;
      stroke: Canvas;
    }
  }

  .crt-img {
    inline-size: 240px;
    block-size: 240px;
    object-fit: contain;
  }

  .specimen-caption {
    margin-block-start: 0.5rem;
    font-family: var(--font-mono);
    font-size: 0.625rem;
    text-transform: uppercase;
    letter-spacing: 0.04em;
    color: var(--muted);
    text-align: center;
  }

  /* Tactile Hardware Keycap & Encoder Badges */
  .keycap {
    display: inline-block;
    font-family: var(--font-mono);
    font-size: 0.6875rem;
    line-height: 1;
    padding: 3px 6px;
    background-color: var(--chip-btn-bg);
    border: 1px solid var(--chip-btn-border);
    color: var(--white);
    text-transform: uppercase;
    font-weight: 700;
    letter-spacing: 0.05em;
    vertical-align: baseline;
  }

  .keycap-knob {
    display: inline-block;
    font-family: var(--font-mono);
    font-size: 0.6875rem;
    line-height: 1;
    padding: 3px 7px;
    border-radius: 999px;
    background-color: var(--chip-knob-bg);
    border: 1px solid var(--chip-knob-border);
    color: var(--fg);
    text-transform: uppercase;
    font-weight: 700;
    vertical-align: baseline;
  }

  .keycap-key {
    display: inline-block;
    font-family: var(--font-mono);
    font-size: 0.6875rem;
    line-height: 1;
    padding: 3px 6px;
    border-radius: 5px;
    background-color: var(--chip-key-bg);
    border: 1px solid var(--chip-key-border);
    color: var(--fg);
    text-transform: uppercase;
    font-weight: 700;
    letter-spacing: 0.04em;
    vertical-align: baseline;
  }

  .keycap-blank {
    display: inline-block;
    font-family: var(--font-mono);
    font-size: 0.6875rem;
    line-height: 1;
    padding: 3px 6px;
    border-radius: 5px;
    background-color: var(--chip-key-bg);
    border: 1px dashed var(--border-active);
    color: var(--fg);
    font-weight: 700;
    letter-spacing: 0.02em;
    vertical-align: baseline;
  }

  :is(.keycap, .keycap-key).is-held {
    padding: 2px 5px;
    border-width: 3px;
  }

  .keycap-blank.is-held {
    padding: 2px 5px;
    border-width: 2px;
  }

  @media (forced-colors: active) {
    .keycap,
    .keycap-knob,
    .keycap-key,
    .keycap-blank {
      background-color: Canvas;
      color: CanvasText;
      border-color: CanvasText;
    }
  }

  /* 2-Column Grid (Chapter 01 Conventions) */
  .grid-two {
    display: grid;
    grid-template-columns: repeat(2, minmax(0, 1fr));
    gap: 0.5rem;
  }

  .convention-cell {
    background-color: var(--panel);
    border: 1px solid var(--border);
    padding: 0.75rem;
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    text-align: center;
    gap: 0.25rem;
  }

  .convention-cell:last-child:nth-child(odd) {
    grid-column: 1 / -1;
  }

  .convention-pair {
    display: inline-flex;
    flex-wrap: wrap;
    justify-content: center;
    align-items: center;
    gap: 0.25rem;
  }

  .convention-label {
    margin-block-start: 0.25rem;
    font-family: var(--font-mono);
    font-size: 0.75rem;
    font-weight: 700;
    text-transform: uppercase;
    color: var(--fg);
  }

  .convention-sub {
    font-size: 0.6875rem;
    color: var(--muted);
  }

  /* Chapter 04 Signal-Flow Block Diagram */
  .signal-schematic {
    display: block;
    inline-size: 100%;
    max-inline-size: 644px;
    block-size: auto;
    padding: 0.375rem 0.25rem 0.125rem;
    user-select: none;
  }

  /* Callout Box (Chapter 08 TIP) */
  .tip-callout {
    margin-block-start: 0.25rem;
    padding: 0.75rem 0.875rem;
    background-color: var(--subpanel);
    border: 1px solid var(--border);
    font-family: var(--font-mono);
    font-size: 0.75rem;
    line-height: 1.625;
    color: var(--dim);
  }

  .tip-callout-label {
    display: block;
    margin-block-end: 0.25rem;
    color: var(--white);
    font-weight: 700;
    text-transform: uppercase;
  }

  .recipe-steps {
    display: flex;
    flex-direction: column;
    gap: 0.35rem;
    color: var(--dim);
    line-height: 1.6;
  }

  /* Chapter 11: Native FAQ Accordions */
  .faq-list {
    display: flex;
    flex-direction: column;
    gap: 0.625rem;
  }

  .faq-item {
    background-color: var(--subpanel);
    border: 1px solid var(--border);
    transition: border-color 0.14s ease;
  }

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

  .faq-item:has(> .faq-summary:hover) {
    border-color: var(--border-active);
  }

  .faq-summary {
    list-style: none;
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 0.75rem;
    padding: 0.875rem;
    cursor: pointer;
    user-select: none;
    font-family: var(--font-mono);
    font-size: 0.75rem;
    font-weight: 700;
    line-height: 1.45;
    text-transform: uppercase;
    color: var(--fg);
    transition: background-color 0.14s ease, color 0.14s ease;
  }

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

  .faq-summary:hover {
    background-color: #1b1b1b;
    color: var(--white);
  }

  .faq-summary:hover .faq-icon {
    color: var(--white);
  }

  .faq-summary:active {
    background-color: var(--panel);
  }

  .faq-icon {
    flex-shrink: 0;
    display: inline-block;
    font-family: var(--font-mono);
    font-size: 0.875rem;
    line-height: 1;
    color: var(--muted);
    rotate: 0deg;
  }

  .faq-item[open]:not(.is-closing) > .faq-summary .faq-icon {
    rotate: 45deg;
    color: var(--fg);
  }

  @media (prefers-reduced-motion: no-preference) {
    .faq-icon {
      transition: rotate 0.22s cubic-bezier(0.22, 1, 0.36, 1), color 0.14s ease;
    }
  }

  .faq-answer {
    padding: 0.75rem 0.875rem 0.875rem;
    border-block-start: 1px solid var(--border);
    font-family: var(--font-mono);
    font-size: 0.75rem;
    line-height: 1.65;
    color: var(--dim);
    overflow-wrap: break-word;
  }

  /* Bottom Firmware Hub CTA */
  .cta-section {
    padding-block-start: 1.5rem;
    border-block-start: 1px solid var(--border);
    display: flex;
    flex-direction: column;
    align-items: center;
    text-align: center;
    gap: 0.75rem;
  }

  .cta-heading {
    font-size: clamp(1.125rem, 1rem + 0.5vw, 1.375rem);
    font-weight: 700;
    letter-spacing: -0.015em;
  }

  .cta-copy {
    color: var(--dim);
    max-inline-size: 480px;
    line-height: 1.6;
  }

  .cta-actions {
    inline-size: 100%;
    display: flex;
    flex-direction: column;
    gap: 0.5rem;
    margin-block-start: 0.5rem;
  }

  .btn-block-primary {
    inline-size: 100%;
    min-block-size: 46px;
    padding: 0.625rem 1rem;
    display: inline-flex;
    align-items: center;
    justify-content: center;
    gap: 0.5rem;
    background-color: var(--btn-surface);
    color: var(--ground);
    border: 1px solid var(--btn-surface);
    font-family: var(--font-mono);
    font-size: 0.75rem;
    font-weight: 700;
    letter-spacing: 0.06em;
    text-transform: uppercase;
    text-decoration: none;
    translate: 0 0;
    transition:
      background-color 120ms ease-out,
      border-color 120ms ease-out,
      box-shadow 150ms ease-out,
      translate 60ms ease-out;
  }

  .btn-block-primary:is(:hover, :active, :focus-visible, .is-bloomed) {
    background-color: var(--white);
    color: var(--ground);
    border-color: var(--white);
    text-decoration: none;
    box-shadow:
      0 0 2px 0 rgba(255, 255, 255, 0.95),
      0 0 14px 1px rgba(255, 255, 255, 0.36);
  }

  .btn-block-primary:active {
    transition-duration: 25ms;
  }

  @media (prefers-reduced-motion: no-preference) {
    .btn-block-primary:active {
      translate: 0 1px;
    }
  }

  /* Quiet Footer Colophon & Attributions */
  .footer-credits {
    inline-size: 100%;
    display: flex;
    flex-direction: column;
    align-items: center;
  }

  .footer-credits-summary {
    list-style: none;
    display: inline-flex;
    align-items: center;
    gap: 0.35rem;
    min-block-size: 24px;
    padding-inline: 0.2rem;
    cursor: pointer;
    user-select: none;
    color: var(--muted);
    letter-spacing: 0.05em;
    text-transform: uppercase;
    transition: color 0.12s ease;
  }

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

  .footer-credits-summary:hover {
    color: var(--white);
  }

  .footer-credits-summary:hover > :not(.faq-icon) {
    text-decoration: underline;
    text-underline-offset: 3px;
  }

  .footer-credits-summary .faq-icon {
    font-size: 0.75rem;
    color: inherit;
  }

  .footer-credits[open]:not(.is-closing) > .footer-credits-summary .faq-icon {
    rotate: 45deg;
    color: var(--fg);
  }

  .footer-credits-body {
    inline-size: 100%;
    margin-block-start: 0.75rem;
    padding-block-start: 1rem;
    border-block-start: 1px solid var(--border);
    text-align: start;
    display: flex;
    flex-direction: column;
    gap: 0.875rem;
    font-family: var(--font-sans);
    font-size: 0.75rem;
    line-height: 1.6;
    color: var(--dim);
  }

  .credits-block {
    display: flex;
    flex-direction: column;
    gap: 0.35rem;
  }

  .credits-block:not(:last-child) {
    padding-block-end: 0.875rem;
    border-block-end: 1px solid var(--border);
  }

  .credits-label {
    font-family: var(--font-mono);
    font-size: 0.625rem;
    font-weight: 700;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--fg);
  }

  /* Minimal Footer */
  .site-footer {
    inline-size: 100%;
    max-inline-size: var(--column-max);
    margin-inline: auto;
    padding-inline: var(--gutter);
    padding-block-start: 0.5rem;
    padding-block-end: 2.75rem;
  }

  .footer-inner {
    padding-block-start: 1.5rem;
    border-block-start: 1px solid var(--border);
    display: flex;
    flex-direction: column;
    align-items: center;
    text-align: center;
    gap: 0.5rem;
    font-family: var(--font-mono);
    font-size: 0.625rem;
    color: var(--muted);
  }

  .footer-nav {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    justify-content: center;
    gap: 0.45rem;
    color: var(--dim);
    text-transform: uppercase;
  }

  .footer-nav a {
    display: inline-flex;
    align-items: center;
    min-block-size: 24px;
    padding-inline: 0.15rem;
    transition: color 0.12s ease;
  }

  .footer-nav a:hover {
    color: var(--white);
    text-decoration: underline;
    text-underline-offset: 3px;
  }

  .footer-contact {
    margin-block: 0.15rem;
    font-family: var(--font-sans);
    font-size: 0.75rem;
    line-height: 1.5;
    color: var(--dim);
  }

  /* 1px CRT Oscilloscope Sweep Reading Progress Indicator */
  .crt-sweep {
    position: absolute;
    inset-block-end: -9px;
    inset-inline: 0;
    inline-size: 100%;
    block-size: 17px;
    container-type: inline-size;
    pointer-events: none;
    overflow: clip;
  }

  /* Dimensionless scaleX(0 -> 1) progress line (never goes stale on window resize) */
  .crt-sweep-line {
    position: absolute;
    inset-block-start: 8px;
    inset-inline: 0;
    block-size: 1px;
    background: linear-gradient(
      90deg,
      rgba(245, 245, 245, 0.14) 0%,
      rgba(245, 245, 245, 0.45) 100%
    );
    transform-origin: 0 50%;
    transform: scaleX(0);
    will-change: transform;
    opacity: 0;

    @media (prefers-reduced-motion: no-preference) {
      opacity: 1;
    }

    @media (forced-colors: active) {
      background: Highlight;
    }
  }

  /* Unscaled beam head container so the dot & velocity tear never stretch */
  .crt-sweep-head {
    position: absolute;
    inset-block-start: 8px;
    inset-inline-start: 0;
    inline-size: 0;
    block-size: 1px;
    will-change: transform;
  }

  /* Active electron beam spot: blooms wider than the 1px line at the head and collapses back to 1px at rest */
  .crt-sweep-spot {
    position: absolute;
    inset: 0;
    transform-origin: 0 50%;
    transform: scale(0.3333);
    opacity: 0;
    will-change: transform, opacity;
  }

  /* 1px glass-anchored phosphor wake: spans [tailP .. headP] directly in 100cqi bar units */
  .crt-sweep-tear {
    position: absolute;
    inset-inline-end: 0;
    inset-block-start: 0;
    inline-size: 100vw;
    inline-size: 100cqi;
    block-size: 1px;
    max-inline-size: none;
    object-fit: fill;
    background-color: var(--white);
    -webkit-mask-image: linear-gradient(
      90deg,
      transparent 0%,
      rgba(0, 0, 0, 0.14) 24%,
      rgba(0, 0, 0, 0.38) 54%,
      rgba(0, 0, 0, 0.72) 80%,
      rgba(0, 0, 0, 0.93) 93%,
      #000 100%
    );
    mask-image: linear-gradient(
      90deg,
      transparent 0%,
      rgba(0, 0, 0, 0.14) 24%,
      rgba(0, 0, 0, 0.38) 54%,
      rgba(0, 0, 0, 0.72) 80%,
      rgba(0, 0, 0, 0.93) 93%,
      #000 100%
    );
    transform-origin: right center;
    transform: scaleX(0);
    opacity: 0;
    will-change: transform, opacity;

    @media (dynamic-range: high) {
      @supports (dynamic-range-limit: no-limit) {
        dynamic-range-limit: no-limit;
      }
    }
  }

  .crt-sweep-dot {
    position: absolute;
    inset-inline-start: -1.5px;
    inset-block-start: -1px;
    inline-size: 3px;
    block-size: 3px;
    max-inline-size: none;
    border-radius: 50%;
    object-fit: cover;
    background-color: var(--white);
    box-shadow: 0 0 3px rgba(255, 255, 255, 0.72);

    @media (dynamic-range: high) {
      @supports (dynamic-range-limit: no-limit) {
        dynamic-range-limit: no-limit;
      }
    }
  }

  @media (prefers-reduced-motion: no-preference) {

    @supports (animation-timeline: scroll()) and (width: 1cqi) {
      @keyframes crt-line-sweep {
        from {
          transform: scaleX(0);
        }
        to {
          transform: scaleX(1);
        }
      }

      @keyframes crt-head-sweep {
        from {
          transform: translate3d(0, 0, 0);
        }
        to {
          transform: translate3d(100cqi, 0, 0);
        }
      }

      .crt-sweep-line {
        animation: crt-line-sweep auto linear both;
        animation-timeline: scroll(root block);
      }

      .crt-sweep-head {
        animation: crt-head-sweep auto linear both;
        animation-timeline: scroll(root block);
      }
    }
  }

  /* Mobile readability (<= 640px; desktop >= 641px untouched) */
  @media (max-width: 40rem) {
    body {
      font-size: 0.9375rem;
      line-height: 1.625;
    }

    .brand-mark {
      font-size: 0.8125rem;
    }

    .page-title {
      font-size: 2rem;
    }

    .lead-copy {
      font-size: 1rem;
    }

    .chapter-heading {
      font-size: 1.1875rem;
    }

    .cta-heading {
      font-size: 1.25rem;
    }

    .subsection-heading,
    .index-title,
    .index-list,
    .card-title {
      font-size: 0.875rem;
    }

    .index-list {
      gap: 0.25rem;
    }

    .index-list a {
      min-block-size: 2rem;
    }

    .convention-label,
    .tip-callout,
    .faq-summary,
    .faq-answer {
      font-size: 0.84375rem;
    }

    .faq-icon {
      font-size: 1rem;
    }

    .footer-credits-body {
      font-size: 0.8125rem;
    }

    .footer-credits-summary .faq-icon {
      font-size: 0.875rem;
    }

    .btn-block-primary,
    .convention-sub {
      font-size: 0.8125rem;
    }

    .btn-block-primary {
      padding-inline: 0.75rem;
      letter-spacing: 0.045em;
      text-align: center;
    }

    .keycap,
    .keycap-knob,
    .keycap-key,
    .keycap-blank {
      font-size: 0.75rem;
      padding: 0.1875rem 0.4375rem;
    }

    :is(.keycap, .keycap-key, .keycap-blank).is-held {
      padding: calc(0.1875rem - 1px) calc(0.4375rem - 1px);
    }

    .keycap-knob {
      padding-inline: 0.5rem;
    }

    .eyebrow,
    .index-count,
    .return-link,
    .card-tag,
    .specimen-caption,
    .credits-label,
    .footer-inner {
      font-size: 0.75rem;
    }
  }
}

@layer utilities {
  .visually-hidden:where(:not(:focus-within, :active)) {
    position: absolute !important;
    clip-path: inset(50%) !important;
    overflow: hidden !important;
    inline-size: 1px !important;
    block-size: 1px !important;
    margin: -1px !important;
    padding: 0 !important;
    border: 0 !important;
    white-space: nowrap !important;
  }

  .skip-link:where(:focus-visible, :active) {
    position: fixed;
    inset-block-start: 0.5rem;
    inset-inline-start: 0.5rem;
    z-index: 100;
    padding: 0.5rem 0.75rem;
    background-color: var(--fg);
    color: var(--ground);
    font-family: var(--font-mono);
    font-size: 0.75rem;
    font-weight: 700;
    text-transform: uppercase;
  }
}
