@tenphi/glaze 0.0.0-snapshot.365f18a → 0.0.0-snapshot.38d4d4e

package/docs/api.md

@@ -1909,10 +1909,12 @@ import {
 
 ### Format writers
 
-Every writer takes `h` on 0–360 and `s` / `l` / `t` on **0–1** — the same scale
-every converter above *returns*, and the scale `resolve()` stores in a
+Every writer takes `h` on 0–360 and `s` / `l` / `t` on **0–1** — the scale every
+conversion above *returns*, and the scale `resolve()` stores in a
 `ResolvedColorVariant`. The percentages are an output detail: the writers scale
-by 100 themselves where the CSS syntax asks for one.
+by 100 themselves where the CSS syntax asks for one. (The one thing on a
+different scale is the pair of tone transfers below, `toTone` / `fromTone`,
+which speak the 0–100 tone axis the authoring API takes.)
 
 ```ts
 import {
@@ -1935,9 +1937,11 @@ between:
 
 ```ts
 const v = glaze.color('#7A4DBF').resolve().light;
+const { h, s, l } = variantToOkhsl(v);
 
 formatOkhst(v.h, v.s, v.t); // 'okhst(298.52 70.41% 45.02%)'
-formatRgb(...Object.values(variantToOkhsl(v))); // 'rgb(122 77 191)'
+formatOkhsl(h, s, l); // 'okhsl(298.52 70.41% 45.27%)'
+formatRgb(h, s, l); // 'rgb(122 77 191)'
 ```
 
 A value above 1 can only be pre-2.0 percentage-scale input, so the writers
@@ -1962,12 +1966,12 @@ import {
 
 | Function                                    | Description                                                               |
 | ------------------------------------------- | ------------------------------------------------------------------------- |
-| `toTone(l, eps?)`                           | OKHSL lightness (0–1) → tone (0–100). Defaults to `REF_EPS`.              |
-| `fromTone(t, eps?)`                         | Tone (0–100) → OKHSL lightness (0–1). Inverse of `toTone`.                |
+| `toTone(l, eps?)`                           | OKHSL lightness (0–1) → tone (**0–100**, the authoring scale — divide by 100 for `formatOkhst`). Defaults to `REF_EPS`. |
+| `fromTone(t, eps?)`                         | Tone (**0–100**) → OKHSL lightness (0–1). Inverse of `toTone`.            |
 | `toneFromY(y, eps?)` / `yFromTone(t, eps?)` | Same transfer in luminance space (0–1).                                   |
 | `okhstToOkhsl({ h, s, t })`                 | OKHST → OKHSL (`{ h, s, l }`).                                            |
 | `okhslToOkhst({ h, s, l })`                 | OKHSL → OKHST (`{ h, s, t }`).                                            |
-| `variantToOkhsl(variant)`                   | `ResolvedColorVariant` (stores `t`) → `{ h, s, l, alpha }` for rendering. |
+| `variantToOkhsl(variant)`                   | `ResolvedColorVariant` (stores `t`) → `{ h, s, l }` for rendering (`alpha` stays on the variant). |
 | `REF_EPS`                                   | Reference epsilon (`0.05`) for the canonical tone axis.                   |
 
 `ResolvedColorVariant` stores `{ h, s, t, alpha }` (tone, not lightness). Use

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenphi/glaze",
-  "version": "0.0.0-snapshot.365f18a",
+  "version": "0.0.0-snapshot.38d4d4e",
   "description": "OKHST-based color theme generator with WCAG contrast solving for light, dark, and high-contrast schemes",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -20,7 +20,8 @@
   },
   "files": [
     "dist",
-    "docs"
+    "docs",
+    "AGENTS.md"
   ],
   "sideEffects": false,
   "engines": {
@@ -28,6 +29,10 @@
   },
   "scripts": {
     "build": "tsdown",
+    "docs": "astro dev",
+    "docs:doctor": "cookbook doctor",
+    "build:docs": "astro build",
+    "build:site": "pnpm build:docs && GLAZE_SITE=true vite build playground",
     "playground": "vite playground",
     "build:playground": "vite build playground",
     "test": "vitest run",
@@ -69,9 +74,13 @@
     "@changesets/changelog-github": "^0.5.2",
     "@changesets/cli": "^2.29.8",
     "@eslint/js": "^10.0.1",
+    "@tenphi/cookbook": "^0.31.1",
+    "astro": "^7.3.3",
     "eslint": "^10.0.0",
     "eslint-config-prettier": "^10.1.8",
     "prettier": "^3.8.1",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.56.0",