docs: regenerate site from f094acfdb5

This commit is contained in:
ludic-docs-bot 2026-09-17 22:10:03 +00:00
commit 63c5ed9baf
975 changed files with 55427 additions and 0 deletions

315
base.css Normal file
View file

@ -0,0 +1,315 @@
/* base.css — the design tokens and shared chrome for every generated page.
*
* The site is deliberately typographic and light-first: a warm paper ground, a
* serif display face for headings, one ink-blue accent used only where it means
* something (links, the current page, a focused control), and colour otherwise
* reserved for code. Dark mode is the same design with the ground inverted, not
* a second theme — every colour below is a token, redefined once under
* prefers-color-scheme and nowhere else.
*
* Fonts are the platform's own. A language reference should render instantly
* and identically offline; a webfont round-trip buys nothing here. */
:root {
/* ground and ink */
--paper: #fcfcfa;
--paper-2: #f5f4f0;
--panel: #ffffff;
--ink: #17171a;
--ink-2: #3d3d44;
--muted: #67676f;
--rule: #e3e2dc;
--rule-2: #cfcec6;
/* the single accent */
--accent: #0f4c81;
--accent-ink: #0b3a63;
--accent-bg: #eaf1f8;
/* code surface and tokens */
--code-bg: #f7f6f2;
--code-rule: #e3e2dc;
--c-comment: #7a7a70;
--c-key: #8f2d56;
--c-type: #0f6b5c;
--c-str: #9a5518;
--c-num: #1d4f8c;
--c-annot: #6b3fa0;
--c-fn: #0f4c81;
--c-punc: #6a6a72;
--c-arg: #9a5518;
--radius: 6px;
--max: 1080px;
--hdr: 58px;
--sans: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
--serif: ui-serif, "Iowan Old Style", "Palatino Linotype", Palatino, Georgia, "Times New Roman", serif;
--mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;
}
@media (prefers-color-scheme: dark) {
:root {
--paper: #16161a;
--paper-2: #1c1c21;
--panel: #1a1a1f;
--ink: #e6e5e0;
--ink-2: #c2c1bb;
--muted: #8f8f98;
--rule: #2b2b32;
--rule-2: #3d3d46;
--accent: #7fb0dd;
--accent-ink: #a8ccec;
--accent-bg: #1b2733;
--code-bg: #1b1b21;
--code-rule: #2b2b32;
--c-comment: #7b7b84;
--c-key: #e08aa8;
--c-type: #64c9b4;
--c-str: #d9a066;
--c-num: #8fb8e8;
--c-annot: #b596e0;
--c-fn: #7fb0dd;
--c-punc: #8b8b94;
--c-arg: #d9a066;
}
}
*, *::before, *::after { box-sizing: border-box }
html {
-webkit-text-size-adjust: 100%;
scroll-behavior: smooth;
}
@media (prefers-reduced-motion: reduce) {
html { scroll-behavior: auto }
}
body {
margin: 0;
background: var(--paper);
color: var(--ink-2);
font-family: var(--sans);
font-size: 16px;
line-height: 1.65;
-webkit-font-smoothing: antialiased;
text-rendering: optimizeLegibility;
}
h1, h2, h3, h4 {
font-family: var(--serif);
color: var(--ink);
font-weight: 600;
line-height: 1.2;
letter-spacing: -0.005em;
margin: 0;
}
a { color: var(--accent); text-decoration: none }
a:hover { text-decoration: underline; text-underline-offset: 2px }
:focus-visible {
outline: 2px solid var(--accent);
outline-offset: 2px;
border-radius: 3px;
}
.wrap { max-width: var(--max); margin: 0 auto; padding: 0 24px }
.muted { color: var(--muted) }
.mono, code, pre, kbd { font-family: var(--mono) }
/* Inline code carries no chip: the mono face plus the darker ink is already a
clear enough break from running text, and a tinted box behind every keyword
in a language reference turns a paragraph into confetti. */
code {
font-size: 0.905em;
color: var(--ink);
}
pre code { font-size: inherit }
pre {
margin: 14px 0 0;
padding: 15px 17px;
overflow-x: auto;
font-size: 13px;
line-height: 1.7;
tab-size: 2;
background: var(--code-bg);
border: 1px solid var(--code-rule);
border-radius: var(--radius);
color: var(--ink);
}
pre::-webkit-scrollbar { height: 9px }
pre::-webkit-scrollbar-thumb { background: var(--rule-2); border-radius: 5px }
/* syntax tokens, shared by the highlighter and the hand-written terminal block */
.t-com { color: var(--c-comment); font-style: italic }
.t-key { color: var(--c-key) }
.t-type { color: var(--c-type) }
.t-str { color: var(--c-str) }
.t-num { color: var(--c-num) }
.t-annot { color: var(--c-annot) }
.t-fn { color: var(--c-fn) }
.t-punc { color: var(--c-punc) }
.t-arg { color: var(--c-arg) }
/* ---------- token cards ------------------------------------------------- *
* Every page runs the highlighter, so the card chrome lives here rather than
* in docs.css — the landing page links base.css and site.css only, and a card
* whose stylesheet never loaded renders as a static block at the end of the
* body instead of a panel beside the token that was clicked.
* ----------------------------------------------------------------------- */
.tok { cursor: help; border-bottom: 1px dotted var(--rule-2) }
a.tok { cursor: pointer }
.hovercard {
/* the script positions this from getBoundingClientRect(), i.e. in viewport
coordinates, so the card must be fixed, not absolute */
position: fixed;
z-index: 90;
max-width: min(360px, calc(100vw - 24px));
background: var(--panel);
border: 1px solid var(--rule-2);
border-radius: var(--radius);
box-shadow: 0 8px 24px -12px rgba(0, 0, 0, .35);
padding: 11px 13px;
font-size: 13.5px;
cursor: pointer;
}
.hovercard:hover { border-color: var(--accent) }
.hc-top { display: flex; align-items: center; gap: 9px; margin-bottom: 6px }
.hc-name { font-family: var(--mono); font-size: 13.5px; color: var(--ink) }
.hc-sig { font-family: var(--mono); font-size: 12.5px; color: var(--muted); display: block; margin-bottom: 6px }
.hc-tip { color: var(--ink-2) }
.hc-foot { display: block; margin-top: 8px; font-size: 12px; color: var(--muted) }
/* the kind badge is worn both by a card and by a reference page's title */
.kind-badge {
font-family: var(--mono);
font-size: 11px;
letter-spacing: 0.06em;
text-transform: uppercase;
color: var(--muted);
border: 1px solid var(--rule-2);
border-radius: 3px;
padding: 2px 7px;
white-space: nowrap;
}
/* the accent is the only colour that distinguishes a kind, and only for the
two that are structural rather than callable */
.kind-namespace, .kind-keyword { color: var(--accent); border-color: var(--accent) }
/* ---------- header ---------- */
header.nav {
position: sticky;
top: 0;
z-index: 50;
background: color-mix(in srgb, var(--paper) 92%, transparent);
backdrop-filter: saturate(1.4) blur(8px);
border-bottom: 1px solid var(--rule);
}
.nav-in { display: flex; align-items: center; gap: 14px; min-height: var(--hdr) }
.brand {
display: inline-flex;
align-items: center;
gap: 9px;
font-family: var(--serif);
font-weight: 600;
font-size: 18px;
color: var(--ink);
letter-spacing: -0.01em;
}
.brand:hover { text-decoration: none }
.logo {
width: 23px; height: 23px;
flex: none;
display: grid;
place-items: center;
border: 1px solid var(--rule-2);
border-radius: 4px;
background: var(--panel);
font-family: var(--mono);
font-size: 12px;
font-weight: 500;
color: var(--accent);
}
.nav-toggle {
margin-left: auto;
display: inline-flex;
align-items: center;
justify-content: center;
width: 38px; height: 38px;
border: 1px solid var(--rule-2);
border-radius: var(--radius);
background: var(--panel);
color: var(--ink);
font-size: 17px;
line-height: 1;
cursor: pointer;
}
.nav-links {
display: none;
position: absolute;
top: 100%; left: 0; right: 0;
flex-direction: column;
background: var(--paper);
border-bottom: 1px solid var(--rule);
padding: 0 24px 8px;
}
header.nav.open .nav-links { display: flex }
.nav-links a {
color: var(--ink-2);
font-size: 15px;
padding: 13px 2px;
border-top: 1px solid var(--rule);
}
.nav-links a:first-child { border-top: none }
@media (min-width: 760px) {
.nav-toggle { display: none }
.nav-links {
display: flex;
position: static;
flex-direction: row;
align-items: center;
gap: 26px;
margin-left: auto;
padding: 0;
border: none;
background: none;
}
.nav-links a {
color: var(--muted);
font-size: 14.5px;
padding: 0;
border: none;
}
.nav-links a:hover { color: var(--ink); text-decoration: none }
.nav-links .nav-cta { color: var(--ink) }
}
/* ---------- footer ---------- */
footer {
margin-top: 84px;
border-top: 1px solid var(--rule);
padding: 32px 0 44px;
}
.foot-in {
display: flex;
flex-wrap: wrap;
gap: 22px;
align-items: flex-start;
justify-content: space-between;
}
.foot-in .muted { font-size: 14px; max-width: 42ch }
.foot-links { display: flex; flex-wrap: wrap; gap: 20px }
.foot-links a { color: var(--muted); font-size: 14px }
.foot-links a:hover { color: var(--ink) }