/*
 * Freally Oscillate — the docs site. TASK-130.
 *
 * ⛔⛔ NO CDN, NO ANALYTICS, NO TRACKER, NO EMBEDDED FONT, NO THIRD-PARTY
 * SCRIPT. The site is as offline-honest as the application, and
 * `scripts/check-docs-site.mjs` fails the build on any absolute URL in a
 * `src`, `href` or `@import` that is not a link a reader clicks.
 *
 * ⛔ **The token values are the application's own**, copied from
 * `src/styles/tokens.css` rather than re-chosen. The family has to read as a
 * family, and a site whose purple is one shade off the product's purple is the
 * kind of thing everybody notices and nobody can name.
 *
 * ⚠ **Copied, not imported, and that is a real cost said out loud.** The site
 * is static HTML published from `main` by GitHub Pages; it cannot import a file
 * that only exists inside a Vite build. So `scripts/check-docs-site.mjs`
 * compares the values here against `src/styles/tokens.css` and fails when they
 * drift — which is the only thing that makes a copy safe.
 *
 * ⛔ § F-24: the OS's own fonts. No `@font-face`, no font file, no Google
 * Fonts. Every script the reader's system supports renders, and none of them
 * renders as tofu waiting for a download.
 */

:root {
  /* ── Dark, the only look: every Freally site is dark (owner, 2026-10-01) ── */
  --color-bg: #0b0c10;
  --color-surface: #14161c;
  --color-surface-2: #1b1e26;
  --color-border: #262b36;
  --color-primary: #91f029;
  --color-primary-hot: #adf531;
  --color-signal: #22d3ee;
  --color-text: #e8eaf0;
  --color-text-2: #9aa3b2;
  --color-text-3: #6e7787;
  --color-success: #4ade80;
  --color-warning: #fbbf24;
  --color-error: #f87171;
  --color-info: #60a5fa;

  --font-ui:
    system-ui, -apple-system, 'Segoe UI Variable Text', 'Segoe UI', Roboto, 'Noto Sans',
    'Helvetica Neue', Arial, sans-serif;
  --font-display:
    system-ui, -apple-system, 'Segoe UI Variable Display', 'Segoe UI', Roboto, 'Noto Sans',
    sans-serif;
  --font-mono:
    ui-monospace, 'Cascadia Mono', 'SF Mono', 'DejaVu Sans Mono', Consolas, 'Liberation Mono',
    monospace;

  --space-1: 0.25rem;
  --space-2: 0.5rem;
  --space-3: 0.75rem;
  --space-4: 1rem;
  --space-6: 1.5rem;
  --space-8: 2rem;
  --space-12: 3rem;

  --radius-control: 6px;
  --radius-panel: 10px;
  --measure: 68ch;
}

* {
  box-sizing: border-box;
}

html {
  scroll-behavior: smooth;
  /* ⚠ A deep link from the search results must not land under the sticky
     header. This is what makes `#a-section` actually readable. */
  scroll-padding-top: 5rem;
}

@media (prefers-reduced-motion: reduce) {
  html {
    scroll-behavior: auto;
  }
}

body {
  margin: 0;
  background: var(--color-bg);
  color: var(--color-text);
  font-family: var(--font-ui);
  font-size: 1rem;
  line-height: 1.6;
  -webkit-text-size-adjust: 100%;
}

/* ⛔ RTL is real, not a `direction` attribute over a left-aligned layout.
 * Everything below uses logical properties, so Arabic mirrors rather than
 * merely right-aligning. */
[dir='rtl'] .site-nav a,
[dir='rtl'] .ladder th,
[dir='rtl'] .ladder td {
  text-align: start;
}

a {
  color: var(--color-primary);
  text-decoration-thickness: 1px;
  text-underline-offset: 2px;
}

a:hover {
  color: var(--color-primary-hot);
}

:focus-visible {
  outline: 2px solid var(--color-primary);
  outline-offset: 2px;
  border-radius: 2px;
}

/* ⛔ A keyboard reader lands here first. Without it the whole nav has to be
 * tabbed through on every page. */
.skip {
  position: absolute;
  inset-inline-start: -9999px;
  top: 0;
  padding: var(--space-2) var(--space-4);
  background: var(--color-primary);
  color: var(--color-bg);
  z-index: 20;
}

.skip:focus {
  inset-inline-start: 0;
}

/* ── The header ───────────────────────────────────────────────────────── */

.site-header {
  position: sticky;
  top: 0;
  z-index: 10;
  background: color-mix(in srgb, var(--color-bg) 88%, transparent);
  backdrop-filter: blur(8px);
  border-block-end: 1px solid var(--color-border);
}

.site-header-inner {
  max-width: 1100px;
  margin: 0 auto;
  padding: var(--space-3) var(--space-4);
  display: flex;
  align-items: center;
  gap: var(--space-4);
  flex-wrap: wrap;
}

.wordmark {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  font-family: var(--font-display);
  font-weight: 650;
  color: var(--color-text);
  text-decoration: none;
  letter-spacing: -0.01em;
}

.wordmark img {
  width: 28px;
  height: 28px;
}

.site-nav {
  display: flex;
  gap: var(--space-4);
  margin-inline-start: auto;
  flex-wrap: wrap;
  align-items: center;
}

.site-nav a {
  color: var(--color-text-2);
  text-decoration: none;
  font-size: 0.9375rem;
}

.site-nav a:hover,
.site-nav a[aria-current='page'] {
  color: var(--color-text);
}

.site-nav a[aria-current='page'] {
  text-decoration: underline;
  text-decoration-color: var(--color-primary);
  text-underline-offset: 6px;
  text-decoration-thickness: 2px;
}

select.locale {
  background: var(--color-surface-2);
  color: var(--color-text);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-control);
  padding: var(--space-1) var(--space-2);
  font: inherit;
  font-size: 0.875rem;
  cursor: pointer;
}

/* ── Layout ───────────────────────────────────────────────────────────── */

main {
  max-width: 1100px;
  margin: 0 auto;
  padding: var(--space-8) var(--space-4) var(--space-12);
}

section {
  margin-block-end: var(--space-12);
}

h1,
h2,
h3 {
  font-family: var(--font-display);
  line-height: 1.25;
  letter-spacing: -0.01em;
  text-wrap: balance;
}

h1 {
  font-size: clamp(2rem, 5vw, 3rem);
  margin-block: 0 var(--space-4);
}

h2 {
  font-size: clamp(1.375rem, 3vw, 1.75rem);
  margin-block: var(--space-8) var(--space-4);
  padding-block-end: var(--space-2);
  border-block-end: 1px solid var(--color-border);
}

h3 {
  font-size: 1.125rem;
  margin-block: var(--space-6) var(--space-2);
}

p,
li {
  max-width: var(--measure);
}

code,
kbd {
  font-family: var(--font-mono);
  font-size: 0.875em;
  background: var(--color-surface-2);
  border: 1px solid var(--color-border);
  border-radius: 4px;
  padding: 0.1em 0.35em;
}

kbd {
  box-shadow: 0 1px 0 var(--color-border);
}

pre {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-panel);
  padding: var(--space-4);
  overflow-x: auto;
}

pre code {
  background: none;
  border: none;
  padding: 0;
}

/* ── The hero ─────────────────────────────────────────────────────────── */

.hero {
  text-align: center;
  padding-block: var(--space-12) var(--space-8);
}

.hero img.mark {
  width: 96px;
  height: 96px;
}

.hero .tagline {
  font-size: clamp(1.125rem, 2.5vw, 1.375rem);
  color: var(--color-text);
  margin-inline: auto;
  max-width: 46ch;
}

.hero .sub {
  color: var(--color-text-2);
  margin-inline: auto;
  max-width: 52ch;
}

.chips {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-2);
  justify-content: center;
  list-style: none;
  padding: 0;
  margin-block: var(--space-6);
}

.chips li {
  border: 1px solid var(--color-border);
  background: var(--color-surface);
  border-radius: 999px;
  padding: var(--space-1) var(--space-3);
  font-size: 0.875rem;
  color: var(--color-text-2);
  max-width: none;
}

/* ── The feature grid ─────────────────────────────────────────────────── */

.grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
  gap: var(--space-4);
}

.card {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-panel);
  padding: var(--space-4);
}

.card h3 {
  margin-block-start: 0;
}

.card p {
  color: var(--color-text-2);
  margin-block-end: 0;
  max-width: none;
}

/* ── The ladder ───────────────────────────────────────────────────────── */

.ladder {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.9375rem;
}

.ladder th,
.ladder td {
  text-align: start;
  padding: var(--space-2) var(--space-3);
  border-block-end: 1px solid var(--color-border);
  vertical-align: top;
}

.ladder th {
  color: var(--color-text-2);
  font-weight: 600;
}

.ladder td:first-child {
  font-family: var(--font-mono);
  white-space: nowrap;
}

/* ⛔ The state is a word as well as a colour. A reader who cannot tell the
 * green from the grey still reads "done" and "planned". */
.state {
  font-size: 0.8125rem;
  border-radius: 999px;
  padding: 0.1em 0.6em;
  border: 1px solid currentcolor;
  white-space: nowrap;
}

.state-done {
  color: var(--color-success);
}

.state-planned {
  color: var(--color-text-3);
}

.state-goal {
  color: var(--color-primary);
}

/* ── The honest section ───────────────────────────────────────────────── */

.honest {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-inline-start: 3px solid var(--color-warning);
  border-radius: var(--radius-panel);
  padding: var(--space-4) var(--space-6);
}

.honest h3 {
  margin-block-start: var(--space-4);
}

.honest > :first-child {
  margin-block-start: 0;
}

/* ── The manual ───────────────────────────────────────────────────────── */

.manual {
  display: grid;
  grid-template-columns: minmax(200px, 240px) 1fr;
  gap: var(--space-8);
  align-items: start;
}

@media (max-width: 860px) {
  .manual {
    grid-template-columns: 1fr;
  }

  .manual-toc {
    position: static;
    max-height: none;
  }
}

.manual-toc {
  position: sticky;
  top: 5rem;
  max-height: calc(100vh - 7rem);
  overflow-y: auto;
  font-size: 0.9375rem;
}

.manual-toc ol {
  list-style: none;
  padding: 0;
  margin: 0;
}

.manual-toc a {
  display: block;
  padding: var(--space-1) var(--space-2);
  color: var(--color-text-2);
  text-decoration: none;
  border-inline-start: 2px solid transparent;
}

.manual-toc a:hover {
  color: var(--color-text);
  border-inline-start-color: var(--color-primary);
}

/* ⛔⛔ THE ANNOTATED SCREENSHOTS — § F-33.
 *
 * ⚠ The red box is drawn INTO the picture by the capture pass, never here: it
 * has to be aligned to the real element, and CSS on this page knows nothing
 * about where that element was. So this is only the frame around it. */
figure.shot {
  margin: var(--space-6) 0;
  max-width: 100%;
}

figure.shot img {
  max-width: 100%;
  height: auto;
  display: block;
  border: 1px solid var(--color-border);
  border-radius: var(--radius-panel);
  background: var(--color-surface);
}

figure.shot figcaption {
  color: var(--color-text-2);
  font-size: 0.875rem;
  margin-block-start: var(--space-2);
  max-width: var(--measure);
}

/* ── Search ───────────────────────────────────────────────────────────── */

.search {
  position: relative;
  margin-block-end: var(--space-6);
}

.search input {
  width: 100%;
  max-width: 34rem;
  background: var(--color-surface-2);
  color: var(--color-text);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-control);
  padding: var(--space-2) var(--space-3);
  font: inherit;
}

.search-results {
  list-style: none;
  padding: 0;
  margin: var(--space-2) 0 0;
  max-width: 34rem;
}

.search-results li {
  border-block-end: 1px solid var(--color-border);
  padding: var(--space-2) 0;
  max-width: none;
}

.search-results a {
  font-weight: 600;
  text-decoration: none;
}

.search-results p {
  margin: var(--space-1) 0 0;
  color: var(--color-text-2);
  font-size: 0.875rem;
  max-width: none;
}

.search-empty {
  color: var(--color-text-2);
  font-size: 0.9375rem;
}

/* ── The notice a hidden page carries ─────────────────────────────────── */

.notice {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-inline-start: 3px solid var(--color-info);
  border-radius: var(--radius-panel);
  padding: var(--space-4) var(--space-6);
  margin-block-end: var(--space-8);
}

.notice.stop {
  border-inline-start-color: var(--color-error);
}

/* ── The footer ───────────────────────────────────────────────────────── */

.site-footer {
  border-block-start: 1px solid var(--color-border);
  color: var(--color-text-2);
  font-size: 0.875rem;
}

.site-footer-inner {
  max-width: 1100px;
  margin: 0 auto;
  padding: var(--space-8) var(--space-4);
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-4) var(--space-8);
  justify-content: space-between;
}

.site-footer p {
  margin: 0;
  max-width: 52ch;
}

/* ⚠ Print: the reader who prints a procedure wants the screenshots and not the
 * chrome. */
@media print {
  .site-header,
  .site-footer,
  .search,
  .manual-toc,
  .skip {
    display: none;
  }

  .manual {
    grid-template-columns: 1fr;
  }

  body {
    background: #fff;
    color: #000;
  }
}