@tenphi/glaze 0.14.0 → 0.15.0

package/docs/api.md

@@ -404,7 +404,7 @@ Every input form defaults to `mode: 'auto'` so the resolved token adapts between
 
 - **Value-shorthand** (bare strings, value objects, and `{ from, ...overrides }`):
   - Light variant preserves the input tone exactly (`lightTone: false`).
-  - All other config fields (`darkTone`, `darkDesaturation`, `saturationTaper`, `autoFlip`) snapshot from `globalConfig` at create time.
+  - All other config fields (`darkTone`, `darkDesaturation`, `autoFlip`) snapshot from `globalConfig` at create time.
 - **Structured input** (`{ hue, saturation, tone, ... }`):
   - Both tone windows snapshot from `globalConfig` at create time (same as a theme color).
 - All fields are **snapshotted at color-creation time** — later `glaze.configure()` calls don't retroactively change existing tokens.
@@ -450,7 +450,6 @@ The optional `config` second argument (`GlazeConfigOverride`) overrides the reso
 | `lightTone` | `[10, 100]` | Light tone window: `[lo, hi]`, `{ lo, hi, eps }`, or `false` (disable clamping). |
 | `darkTone` | `[15, 95]` | Dark tone window: `[lo, hi]`, `{ lo, hi, eps }`, or `false` (disable clamping). |
 | `darkDesaturation` | `0.1` | Saturation reduction in dark scheme (0–1). |
-| `saturationTaper` | `0.15` | Saturation taper strength toward the tone extremes (0–1). |
 | `autoFlip` | `true` | Default for each color's `flip`: when solving `contrast` (or applying a relative `tone` that overshoots), allow crossing to the opposite side instead of clamping. |
 | `shadowTuning` | `undefined` | Default shadow tuning (meaningful for themes; harmless on color tokens). |
 
@@ -989,10 +988,6 @@ S_dark = S_light * (1 - darkDesaturation) // default: 0.1
 
 `static` mode skips desaturation.
 
-### Saturation taper
-
-`saturationTaper` (default `0.15`) gently reduces saturation toward the tone extremes, where in-gamut chroma collapses. It is the *strength* (0–1) — the maximum fraction of saturation removed at the very edges — ramped in smoothly over the outer ~15% of tone on each end. Mid-tones are untouched; `0` disables it.
-
 ---
 
 ## Configuration
@@ -1002,7 +997,6 @@ glaze.configure({
   lightTone: [10, 100], // [lo, hi]; or { lo, hi, eps } / false to disable clamping
   darkTone: [15, 95],   // [lo, hi]; or { lo, hi, eps } / false to disable clamping
   darkDesaturation: 0.1,
-  saturationTaper: 0.15,
   states: {
     dark: '@dark',
     highContrast: '@high-contrast',
@@ -1027,7 +1021,6 @@ A `ToneWindow` is `[lo, hi]` (OKHSL-lightness endpoints, reference eps — the c
 | `lightTone` | `[10, 100]` | Light scheme tone window: `[lo, hi]`, `{ lo, hi, eps }`, or `false` to disable clamping. Bypassed in HC. |
 | `darkTone` | `[15, 95]` | Dark scheme tone window: `[lo, hi]`, `{ lo, hi, eps }`, or `false` to disable clamping. Bypassed in HC. |
 | `darkDesaturation` | `0.1` | Saturation reduction in dark scheme (0–1). |
-| `saturationTaper` | `0.15` | Saturation taper strength toward the tone extremes (0–1). `0` disables. |
 | `states.dark` | `'@dark'` | State alias for dark mode tokens (Tasty export). |
 | `states.highContrast` | `'@high-contrast'` | State alias for HC tokens. |
 | `modes.dark` | `true` | Include dark variants in exports. |
@@ -1210,6 +1203,5 @@ import {
 | `maxIterations` | `18` | Max binary-search iterations per branch. |
 | `initialDirection` | higher-contrast side | Direction to search first (`'lighter'` or `'darker'`). |
 | `flip` | `false` | When `true`, try the opposite direction if the initial one doesn't meet the target. When `false`, only the initial direction is searched — unmet contrasts pin the result to that direction's extreme. |
-| `saturationTaper` | `0` | When `> 0`, candidate saturation rolls off toward the tone extremes (same envelope the renderer applies), so the solved tone meets the floor at its rendered saturation. |
 
 Result: `{ tone, contrast, met, branch: 'lighter' | 'darker' | 'preferred', flipped? }`. `flipped: true` indicates the initial direction failed and the opposite direction satisfied the target.

package/docs/migration.md

@@ -34,7 +34,7 @@ glaze.configure({ lightLightness: [10, 100], darkLightness: [15, 95], darkCurve:
 glaze.configure({
   lightTone: [10, 100],
   darkTone: [15, 95],
-  // darkCurve removed; saturationTaper: 0.15 is the new gentle-extremes knob
+  // darkCurve removed
 });
 ```
 

package/docs/okhst.md

@@ -155,19 +155,11 @@ A window is authored as `[lo, hi]` (reference eps — the common form),
 to disable clamping. `false` is the full range `[0, 100]` at the reference eps —
 it removes the **boundaries**, not the tone curve.
 
-Other defaults: `darkDesaturation = 0.1` (unchanged), `saturationTaper = 0.15`,
+Other defaults: `darkDesaturation = 0.1` (unchanged),
 `autoFlip = true`.
 
 Reference: `REF_EPS = 0.05`.
 
-## Saturation taper
-
-At the tone extremes the in-gamut chroma collapses, so high saturation near
-white/black reads as noise. `saturationEnvelope(s, toneFinal, taper)` applies a
-smoothstep rolloff over the outer `taper` fraction of the tone range (default
-`0.15` → outer 15% on each end). `taper = 0` disables it. It is conservative by
-design: mid-tones are untouched, so existing ramps barely shift.
-
 ## Contrast metric (unified)
 
 `contrast` is a single prop with a pluggable metric:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tenphi/glaze",
-  "version": "0.14.0",
-  "description": "OKHSL-based color theme generator with WCAG contrast solving for light, dark, and high-contrast schemes",
+  "version": "0.15.0",
+  "description": "OKHST-based color theme generator with WCAG contrast solving for light, dark, and high-contrast schemes",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -33,6 +33,7 @@
   "keywords": [
     "color",
     "theme",
+    "okhst",
     "okhsl",
     "contrast",
     "wcag",
@@ -57,10 +58,12 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.56.0",
+    "vite": "^8.0.16",
     "vitest": "^4.0.18"
   },
   "scripts": {
     "build": "tsdown",
+    "playground": "vite playground",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",