The guide + nav unification — v0.9.0

docs/guide.html: the narrative middle the site lacked — from first CSS
string to emitted shaders. Sections: start here (with a deliberate
honest-correction: the first block shows mix() called with strings and
immediately corrects it, teaching the string boundary), the five-
sentence mental model (incl. THE pitfall: Lab L is 0-100, OKLab L is
0-1), which-space-by-task cheat sheet, wide gamut without tears (three
mapping methods in one sentence each), into the shader, the spectral
layer, the performance playbook (three tiers with measured numbers),
and why to trust the numbers.

House style enforced: every example RUNS LIVE in the page against the
bundled library -- the green output boxes are computed at load, so the
docs cannot drift from the code. Verified in preview: all six live
boxes compute; the three-way mix comparison demonstrates sRGB's muddy
middle (C 0.047) vs OKLCH (C 0.21) with real numbers; the gamut box
shows hue 32.11 -> 32.11 preserved through cusp mapping.

Nav unified across all seven pages (guide first); README leads with
the guide link. CHANGELOG covers 0.9.0 = playground + guide.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: somejohnbforya

CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes. The project follows semver; until 1.0, minor versions
 may adjust APIs (none have needed to yet — the API audit before 0.7.0 found
 no renames worth their churn).
 
+## 0.9.0 — 2026-06-12
+
+The front doors.
+
+- **The converter playground** (`docs/convert.html`): any CSS color in,
+  all 42 spaces out with copyable serializations, gamut badges,
+  exact-cusp-mapped previews, nearest named color, WCAG contrast, CVD
+  swatches, and a CCT line when the color plausibly is a light.
+- **The guide** (`docs/guide.html`): the narrative walk from
+  `parseTo('#ff8800', 'oklch')` to emitted shaders — mental model,
+  which-space-when, wide-gamut workflow, codegen, the spectral layer,
+  performance tiers, and why to trust the numbers. Every example runs
+  live against the library in the page, so the documentation cannot lie
+  about its outputs.
+- Site nav unified across all seven pages; README leads with the guide.
+
 ## 0.8.0 — 2026-06-12
 
 The string boundary opens — by decision, not drift.

README.md

@@ -4,6 +4,9 @@
 > **Every color space, every illuminant — digit-identical in JS, GLSL, and WGSL.**
 
 [![npm](https://img.shields.io/npm/v/whitepoint)](https://www.npmjs.com/package/whitepoint)
+[**→ the guide**](https://somejohnbforya.github.io/whitepoint/guide.html) —
+from your first CSS string to emitted shaders, with live examples.
+
 [![CI](https://github.com/somejohnbforya/whitepoint/actions/workflows/ci.yml/badge.svg)](https://github.com/somejohnbforya/whitepoint/actions/workflows/ci.yml)
  [**live demos**](https://somejohnbforya.github.io/whitepoint/)
 · [**measured accuracy**](https://somejohnbforya.github.io/whitepoint/accuracy.html)

docs/accuracy.html

@@ -38,6 +38,7 @@
 <nav><div class="navin">
   <a class="brand" href="./index.html">whitepoint</a>
   <div class="navlinks">
+    <a href="./guide.html">guide</a>
     <a href="./index.html">demos</a>
     <a href="./convert.html">convert</a>
     <a href="./light.html">light lab</a>

docs/api.html

@@ -33,6 +33,7 @@
 <nav><div class="navin">
   <a class="brand" href="./index.html">whitepoint</a>
   <div class="navlinks">
+    <a href="./guide.html">guide</a>
     <a href="./index.html">demos</a>
     <a href="./convert.html">convert</a>
     <a href="./light.html">light lab</a>

docs/convert.html

@@ -61,6 +61,7 @@
 <nav><div class="navin">
   <a class="brand" href="./index.html">whitepoint</a>
   <div class="navlinks">
+    <a href="./guide.html">guide</a>
     <a href="./index.html">demos</a>
     <a class="here" href="./convert.html">convert</a>
     <a href="./light.html">light lab</a>

docs/guide.html

@@ -68,6 +68,7 @@
 <nav><div class="navin">
   <a class="brand" href="./index.html">whitepoint</a>
   <div class="navlinks">
+    <a href="./guide.html">guide</a>
     <a class="here" href="./index.html">demos</a>
     <a href="./convert.html">convert</a>
     <a href="./light.html">light lab</a>

docs/index.html

@@ -55,6 +55,7 @@
 <nav><div class="navin">
   <a class="brand" href="./index.html">whitepoint</a>
   <div class="navlinks">
+    <a href="./guide.html">guide</a>
     <a href="./index.html">demos</a>
     <a href="./convert.html">convert</a>
     <a class="here" href="./light.html">light lab</a>

docs/light.html

@@ -36,6 +36,7 @@
 <nav><div class="navin">
   <a class="brand" href="./index.html">whitepoint</a>
   <div class="navlinks">
+    <a href="./guide.html">guide</a>
     <a href="./index.html">demos</a>
     <a href="./convert.html">convert</a>
     <a href="./light.html">light lab</a>