@getvitops/utils 0.9.0 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,108 @@
 # @getvitops/utils
 
+## 1.0.0
+
+### Major Changes
+
+- bb92a14: **The colour system is rebuilt on a target-prefixed grammar and a shared lightness ladder.**
+  This is a breaking change to every colour token and utility class.
+
+  ## Why
+
+  Two axes shared one class namespace — functional _planes_ (`--<role>-bg-muted`) and
+  appearance-relative _stops_ (`--color-<role>-muted`) — arbitrated by a "plane wins" rule. The
+  result was not a scale. On the shipped palette, light mode:
+
+  | class                              | resolved to  | step                                          |
+  | ---------------------------------- | ------------ | --------------------------------------------- |
+  | `bg-ui-accent-x-muted`             | stop         | 100                                           |
+  | `bg-ui-accent-muted`               | plane        | 100 — identical, so `x-muted` was a dead rung |
+  | `bg-ui-accent`                     | plane        | 50 — _lighter_ than both its "muted" rungs    |
+  | `border-ui-accent-muted` / `-bold` | stop / plane | 300 / 300 — identical                         |
+  | `text-ui-accent-bold`              | stop         | 700 — _lighter_ than `text-…-muted` (800)     |
+
+  Every family was non-monotonic, two had duplicate rungs, and `--color-<role>-muted` was
+  unreachable through any `bg-` class.
+
+  ## The new grammar
+
+  ```
+  --color-<target>-<role>[-<variant>]        target ∈ bg | text | icon | border
+  ```
+
+  The target is **inside** the name, so `bg-danger-muted` and `text-danger-muted` are different
+  tokens and there is nothing left to arbitrate. **The class name is the token name minus
+  `--color-`** — one vocabulary instead of two.
+
+  Variants are ordinal (`xx-muted` < `x-muted` < `muted` < bare < `bold` < `x-bold`) and the
+  tables are sparse: only cells that hold their contrast target exist.
+
+  ## Role kinds
+
+  `colors.roles` values may now be `{ hue, kind }` as well as a bare hue string:
+
+  ```jsonc
+  "roles": {
+    "danger":  "rust",                             // shorthand => chromatic
+    "surface": { "hue": "navy", "kind": "surface" }
+  }
+  ```
+
+  - **`surface`** — a page/panel colour: `bg-<role>` is the card, `bg-<role>-muted` the page
+    behind it, `bg-<role>-x-muted` a well, `bg-<role>-bold` the inverse surface. Full text scale.
+  - **`chromatic`** (default) — a signal colour: tints (`bg-<role>-x-muted`/`-muted`) and solids
+    (`bg-<role>-solid[-bold|-x-bold]`), with **no bare `bg-<role>`** — say how loud you mean.
+    `text-on-<role>` is the guaranteed foreground for the solid family.
+
+  ## Palette generation
+
+  Every ramp now sits on one **fixed lightness ladder** (50 → L 0.98 … 950 → L 0.21); only chroma
+  and hue vary. That is what makes a step mean the same lightness in every hue. Previously each
+  seed transposed the curve, so relative luminance at step 300 ranged from 0.253 to 0.384 across
+  the shipped palette — the same variant read differently depending on the role.
+
+  Authored colours are still reproduced **exactly**. A `seed`, an `anchors` entry or a `tones`
+  value is pinned verbatim at its nearest step; every other step takes the ladder. Snapping brand
+  colours to the ladder was measured and rejected: 11 of 18 real brand hexes moved beyond a
+  just-noticeable difference (worst ΔE-OK 0.050 — Facebook's `#1877F2` → `#0067e1`) and six left
+  sRGB gamut. Deviation is now bounded and local to pinned steps, and warns past ~0.03 L.
+
+  Two tones that claim the same step now **error** instead of one silently overwriting the other;
+  the record form (`tones: { "600": "…", "700": "…" }`) is how you resolve it.
+
+  ## New
+  - **`icon-<role>`** — a non-text tier, so a glyph may run more vivid than text. `icon` is now a
+    default utility family alongside `bg`/`text`/`border`.
+  - **`--color-border-focus`** — the focus-ring tone, taken from `ui-primary`'s solid.
+  - **Contrast is enforced at build time**, not only in tests: text ≥ APCA Lc 75 on its primary
+    background, ≥ 60 on secondary planes, icons and surface boundaries ≥ 45, both appearances.
+    A violation now fails `generate`. Chromatic text is checked against the _surface_ planes it
+    actually sits on, not only its own tints. `text-<role>-x-muted` (placeholder) and `-xx-muted`
+    (disabled) are explicitly exempt; nothing else is.
+
+  ## Migrating
+
+  Rename `--<role>-<suffix>` → `--color-<target>-<role>[-<variant>]`, and the same for classes:
+
+  | before                                  | after                                                            |
+  | --------------------------------------- | ---------------------------------------------------------------- |
+  | `--<role>-bg` / `bg-<role>` (chromatic) | `--color-bg-<role>-x-muted` / `bg-<role>-x-muted`                |
+  | `--<role>-bg-muted`                     | `--color-bg-<role>-muted`                                        |
+  | `--<role>-solid` / `-solid-bold`        | `--color-bg-<role>-solid` / `-solid-bold`                        |
+  | `--<role>-on-solid` / `text-on-<role>`  | `--color-text-on-<role>` (class unchanged)                       |
+  | `--<role>-text` / `-text-muted`         | `--color-text-<role>` / `-muted`                                 |
+  | `--<role>-border` / `-border-bold`      | `--color-border-<role>` / `-bold`                                |
+  | `--color-<role>-muted` (stop)           | judge by use: `--color-bg-<role>-muted` or `--color-text-<role>` |
+
+  **`surface` background names rotate**, value-preserving: what was `--surface-bg` (the page) is
+  now `--color-bg-surface-muted`; what was `--surface-bg-bold` (raised) is now
+  `--color-bg-surface`. Elevation is expressed by which token you reach for — page `bg-muted`,
+  card `bg` — rather than a raised/sunken pair, which is what lets a future surfaces axis flatten
+  it without touching markup.
+
+  `vitops lint` reports role classes that no longer resolve, and now derives its suggestions from
+  what the generator actually emits rather than a hand-maintained list.
+
 ## 0.9.0
 
 ## 0.8.0

package/dist/color/index.d.mts

@@ -68,6 +68,30 @@ interface HarmonyDefinition {
   primaryIndex: number;
 }
 declare const HARMONY_DEFINITIONS: Record<HarmonyType, HarmonyDefinition>;
+/**
+ * The shared lightness ladder every ramp is built on (lightest → darkest).
+ *
+ * Fixed, NOT seed-derived. Two hues at the same step have to read equally light,
+ * otherwise one contrast table cannot serve every hue and a `muted` variant means
+ * something different depending on which role you ask. Only chroma and hue vary
+ * between ramps.
+ *
+ * The previous engine transposed this curve onto each seed, which let relative
+ * luminance at step 300 range from 0.253 (rust) to 0.384 (amber) across the
+ * shipped palette — the drift this replaces.
+ *
+ * Anchored steps are the one deliberate exception: see `generateOklchPalette`.
+ */
+declare const LIGHTNESS_LADDER: Record<StepName, number>;
+/**
+ * Chroma a ramp decays to beyond its outermost anchors, so the near-white and
+ * near-black ends keep a whisper of the hue instead of going flat grey. The dark
+ * end carries slightly more because chroma reads weaker against black.
+ */
+declare const ENDPOINT_CHROMA: {
+  readonly light: 0.008;
+  readonly dark: 0.015;
+};
 interface OklchColor {
   l: number;
   c: number;
@@ -80,8 +104,36 @@ interface OklchColor {
  */
 declare function parseOklch(oklchString: string): OklchColor;
 /**
- * Generates a complete 11-step OKLCH palette from one or more colors.
- * Automatically determines which step each color belongs to based on lightness.
+ * The ladder step whose lightness is closest to `lightness` — i.e. where a
+ * supplied colour naturally belongs.
+ */
+declare function assignStepByLightness(lightness: number): StepName;
+/**
+ * How far an anchored colour sits from its step's ladder lightness.
+ *
+ * The generator surfaces this as a warning: a large deviation is legal (the
+ * caller asked for that exact colour) but it means the hue will read heavier or
+ * lighter than its siblings at that step, which is worth knowing rather than
+ * discovering later.
+ */
+declare function ladderDeviation(step: StepName, lightness: number): number;
+/**
+ * Build a complete 11-step OKLCH ramp from one or more anchor colours.
+ *
+ * **Ladder-first with exact anchors.** Every anchor is reproduced *verbatim* at
+ * its step; every other step takes its lightness from `LIGHTNESS_LADDER`, with
+ * chroma and hue interpolated between the flanking anchors and decayed toward
+ * `ENDPOINT_CHROMA` beyond the outermost ones.
+ *
+ * The consequence is the point: a client's brand hex survives byte-for-byte,
+ * while the other ten steps stay directly comparable to every other hue. The
+ * deviation from the ladder is bounded and *local to anchored steps* — unlike
+ * the previous engine, which warped the whole ramp to fit its anchors so every
+ * step drifted.
+ *
+ * Chroma may come out beyond the sRGB gamut here; that is deliberate.
+ * `oklchStringToHex` gamut-maps with the CSS algorithm, which reduces chroma
+ * while holding lightness, so the ladder survives the conversion.
  */
 declare function generateOklchPalette(input: string | string[] | Record<string, string>): Record<StepName, string>;
 /** APCA lightness-contrast (Lc) magnitude between a foreground and background. */
@@ -95,6 +147,11 @@ declare function pickOn(bg: string, hue?: number): string;
  * The tinted off-white / off-black endpoints for a hue — white/black with a
  * whisper of the hue mixed in. These are the text/background tints every ramp
  * needs (and the one exception strict brand kits allow).
+ *
+ * Derived from `LIGHTNESS_LADDER` and `ENDPOINT_CHROMA` rather than its own
+ * literals, so a strict tone kit's endpoints land on the same ladder rungs a
+ * generated ramp would have used. This is the single definition — callers must
+ * not hand-write their own near-white/near-black.
  */
 declare function tintedEndpoints(hue: number, chroma?: number): {
   light: string;
@@ -140,5 +197,5 @@ declare const DEFAULT_FUNCTIONAL_HUES: {
  */
 declare function suggestFunctionalColorHue(type: keyof typeof DEFAULT_FUNCTIONAL_HUES, existingHues: number[]): number;
 //#endregion
-export { COLOR_GROUPS, ColorGroup, DEFAULT_FUNCTIONAL_HUES, HARMONY_DEFINITIONS, HARMONY_STRATEGIES, HARMONY_TYPES, HarmonyDefinition, HarmonyOption, HarmonyStrategy, HarmonyType, RgbResult, STEP_NAMES, StepName, applyHarmonyStrategy, contrastLc, formatColorName, gamutMapOklchToHex, generateOklchPalette, getColorName, getColorNameWithHue, getHarmonySuggestions, hexToOklch, oklchStringToHex, oklchToHex, oklchToP3, oklchToSrgb, parseOklch, pickOn, suggestFunctionalColorHue, tintedEndpoints };
+export { COLOR_GROUPS, ColorGroup, DEFAULT_FUNCTIONAL_HUES, ENDPOINT_CHROMA, HARMONY_DEFINITIONS, HARMONY_STRATEGIES, HARMONY_TYPES, HarmonyDefinition, HarmonyOption, HarmonyStrategy, HarmonyType, LIGHTNESS_LADDER, RgbResult, STEP_NAMES, StepName, applyHarmonyStrategy, assignStepByLightness, contrastLc, formatColorName, gamutMapOklchToHex, generateOklchPalette, getColorName, getColorNameWithHue, getHarmonySuggestions, hexToOklch, ladderDeviation, oklchStringToHex, oklchToHex, oklchToP3, oklchToSrgb, parseOklch, pickOn, suggestFunctionalColorHue, tintedEndpoints };
 //# sourceMappingURL=index.d.mts.map

package/dist/color/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/color/colors.ts","../../src/color/color-harmony.ts"],"mappings":";UAkBiB,SAAA;EACf,CAAA;EACA,CAAA;EACA,CAAA;EACA,OAAA;EAHA;EAKA,aAAA;AAAA;;;;AAAa;iBAOC,WAAA,CAAY,CAAA,UAAW,CAAA,UAAW,CAAA,WAAY,SAAS;;;;;iBAmBvD,SAAA,CAAU,CAAA,UAAW,CAAA,UAAW,CAAA,WAAY,SAAS;;;;AAnBE;iBAsCvD,kBAAA,CACd,CAAA,UACA,CAAA,UACA,CAAA,UACA,KAAA;AAAA,cAUW,UAAA;AAAA,KACD,QAAA,WAAmB,UAAU;AAAA,cAE5B,YAAA;AAAA,KAWD,UAAA,WAAqB,YAAY;;;;iBAK7B,UAAA,CAAW,GAAA;EAAgB,CAAA;EAAW,CAAA;EAAW,CAAA;AAAA;;;;iBAajD,UAAA,CAAW,KAAA;EAAS,CAAA;EAAW,CAAA;EAAW,CAAA;AAAA;;;;AAhC+B;iBA8CzE,gBAAA,CAAiB,WAAmB;;;;AA7CX;iBA8DzB,eAAA,CAAgB,IAAY;;;;iBA+G5B,YAAA,CAAa,GAAW;AAhKxC;;;AAAA,iBAsLgB,mBAAA,CAAoB,GAAW;AAAA,cAclC,aAAA;AAAA,KASD,WAAA,WAAsB,aAAa;AAAA,UAE9B,iBAAA;EACf,KAAA;EACA,OAAA;EACA,YAAA;AAAA;AAAA,cAGW,mBAAA,EAAqB,MAAA,CAAO,WAAA,EAAa,iBAAA;AAAA,UAqD5C,UAAA;EACR,CAAA;EACA,CAAA;EACA,CAAA;AAAA;;;;;;iBAQc,UAAA,CAAW,WAAA,WAAsB,UAAU;;AAnQU;AAcrE;;iBAkXgB,oBAAA,CACd,KAAA,sBAA2B,MAAA,mBAC1B,MAAA,CAAO,QAAA;;iBA+GM,UAAA,CAAW,EAAA,UAAY,EAAU;AAldjD;;;;AAAA,iBA0dgB,MAAA,CAAO,EAAA,UAAY,GAAY;AA3W/C;;;;AAAwC;AAAxC,iBAuXgB,eAAA,CAAgB,GAAA,UAAa,MAAA;EAAkB,KAAA;EAAe,IAAA;AAAA;;;;AAtmB9E;;KCdY,eAAA;AAAA,UAWK,aAAA;EACf,EAAA,EAAI,eAAe;EACnB,KAAA;EACA,WAAA;EACA,QAAA;AAAA;AAAA,cAGW,kBAAA,EAAoB,aAAa;ADE/B;AAOf;;AAPe,iBC0DC,oBAAA,CAAqB,OAAA,UAAiB,QAAA,EAAU,eAAe;;;;iBAgB/D,qBAAA,CACd,OAAA,WACC,KAAK;EAAG,QAAA,EAAU,eAAA;EAAiB,GAAA;EAAa,KAAA;EAAe,WAAA;AAAA;;;;cAYrD,uBAAA;EAAA;;;;;;;;iBAUG,yBAAA,CACd,IAAA,eAAmB,uBAAuB,EAC1C,YAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/color/colors.ts","../../src/color/color-harmony.ts"],"mappings":";UAkBiB,SAAA;EACf,CAAA;EACA,CAAA;EACA,CAAA;EACA,OAAA;EAHA;EAKA,aAAA;AAAA;;;;AAAa;iBAOC,WAAA,CAAY,CAAA,UAAW,CAAA,UAAW,CAAA,WAAY,SAAS;;;;;iBAmBvD,SAAA,CAAU,CAAA,UAAW,CAAA,UAAW,CAAA,WAAY,SAAS;;;;AAnBE;iBAsCvD,kBAAA,CACd,CAAA,UACA,CAAA,UACA,CAAA,UACA,KAAA;AAAA,cAUW,UAAA;AAAA,KACD,QAAA,WAAmB,UAAU;AAAA,cAE5B,YAAA;AAAA,KAWD,UAAA,WAAqB,YAAY;;;;iBAK7B,UAAA,CAAW,GAAA;EAAgB,CAAA;EAAW,CAAA;EAAW,CAAA;AAAA;;;;iBAajD,UAAA,CAAW,KAAA;EAAS,CAAA;EAAW,CAAA;EAAW,CAAA;AAAA;;;;AAhC+B;iBA8CzE,gBAAA,CAAiB,WAAmB;;;;AA7CX;iBA8DzB,eAAA,CAAgB,IAAY;;;;iBA+G5B,YAAA,CAAa,GAAW;AAhKxC;;;AAAA,iBAsLgB,mBAAA,CAAoB,GAAW;AAAA,cAclC,aAAA;AAAA,KASD,WAAA,WAAsB,aAAa;AAAA,UAE9B,iBAAA;EACf,KAAA;EACA,OAAA;EACA,YAAA;AAAA;AAAA,cAGW,mBAAA,EAAqB,MAAA,CAAO,WAAA,EAAa,iBAAA;;;AAhNY;AAalE;;;;;;;;;AAAqE;AAcrE;cAyOa,gBAAA,EAAkB,MAAM,CAAC,QAAA;;;AAzOc;AAiBpD;;cA2Oa,eAAA;EAAA,SAAwD,KAAA;EAAA,SAAA,IAAA;AAAA;AAAA,UAE3D,UAAA;EACR,CAAA;EACA,CAAA;EACA,CAAA;AAAA;;;;AA3G6C;AAc/C;iBAqGgB,UAAA,CAAW,WAAA,WAAsB,UAAU;;;AA7FjD;AACV;iBA4HgB,qBAAA,CAAsB,SAAA,WAAoB,QAAQ;;;AA5HnB;AAE/C;;;;;iBAiJgB,eAAA,CAAgB,IAAA,EAAM,QAAQ,EAAE,SAAA;;;AA9IlC;AAGd;;;;;;;;;;;;AAAuE;AAoDvE;;iBAgHgB,oBAAA,CACd,KAAA,sBAA2B,MAAA,mBAC1B,MAAA,CAAO,QAAA;;iBAsFM,UAAA,CAAW,EAAA,UAAY,EAAU;AArLjD;;;;AAAA,iBA6LgB,MAAA,CAAO,EAAA,UAAY,GAAY;AA7LuB;;;;;;;;AAKnE;AAQH;AAbsE,iBA8MtD,eAAA,CAAgB,GAAA,UAAa,MAAA;EAAoB,KAAA;EAAe,IAAA;AAAA;;;;AAzjBhF;;KCdY,eAAA;AAAA,UAWK,aAAA;EACf,EAAA,EAAI,eAAe;EACnB,KAAA;EACA,WAAA;EACA,QAAA;AAAA;AAAA,cAGW,kBAAA,EAAoB,aAAa;ADE/B;AAOf;;AAPe,iBC0DC,oBAAA,CAAqB,OAAA,UAAiB,QAAA,EAAU,eAAe;;;;iBAgB/D,qBAAA,CACd,OAAA,WACC,KAAK;EAAG,QAAA,EAAU,eAAA;EAAiB,GAAA;EAAa,KAAA;EAAe,WAAA;AAAA;;;;cAYrD,uBAAA;EAAA;;;;;;;;iBAUG,yBAAA,CACd,IAAA,eAAmB,uBAAuB,EAC1C,YAAA"}

package/dist/color/index.mjs

@@ -332,18 +332,41 @@ const HARMONY_DEFINITIONS = {
 		primaryIndex: 1
 	}
 };
-const DEFAULT_LIGHTNESS_SCALE = {
-	50: .95,
-	100: .9,
-	200: .8,
-	300: .7,
-	400: .6,
-	500: .5,
-	600: .4,
-	700: .3,
-	800: .2,
-	900: .1,
-	950: .05
+/**
+* The shared lightness ladder every ramp is built on (lightest → darkest).
+*
+* Fixed, NOT seed-derived. Two hues at the same step have to read equally light,
+* otherwise one contrast table cannot serve every hue and a `muted` variant means
+* something different depending on which role you ask. Only chroma and hue vary
+* between ramps.
+*
+* The previous engine transposed this curve onto each seed, which let relative
+* luminance at step 300 range from 0.253 (rust) to 0.384 (amber) across the
+* shipped palette — the drift this replaces.
+*
+* Anchored steps are the one deliberate exception: see `generateOklchPalette`.
+*/
+const LIGHTNESS_LADDER = {
+	50: .98,
+	100: .95,
+	200: .9,
+	300: .83,
+	400: .74,
+	500: .65,
+	600: .54,
+	700: .47,
+	800: .38,
+	900: .29,
+	950: .21
+};
+/**
+* Chroma a ramp decays to beyond its outermost anchors, so the near-white and
+* near-black ends keep a whisper of the hue instead of going flat grey. The dark
+* end carries slightly more because chroma reads weaker against black.
+*/
+const ENDPOINT_CHROMA = {
+	light: .008,
+	dark: .015
 };
 /**
 * Parses an OKLCH CSS string into numerical components.
@@ -367,69 +390,21 @@ function lerp(start, end, factor) {
 	return start + factor * (end - start);
 }
 /**
-* Transpose the default lightness scale to match the provided anchors.
+* Interpolate hue the short way round the wheel. A ramp anchored at 350° and 10°
+* spans 20°, not 340° — the naive lerp sent it the long way through cyan.
 */
-function transposeLightnessScale(parsedAnchors, sortedAnchorSteps) {
-	const transposedScale = {};
-	if (sortedAnchorSteps.length === 1) {
-		const anchorStep = sortedAnchorSteps[0];
-		const anchorL = parsedAnchors[anchorStep].l;
-		const defaultAnchorL = DEFAULT_LIGHTNESS_SCALE[anchorStep];
-		for (const step of STEP_NAMES) {
-			if (step === anchorStep) {
-				transposedScale[step] = anchorL;
-				continue;
-			}
-			const defaultStepL = DEFAULT_LIGHTNESS_SCALE[step];
-			if (defaultStepL > defaultAnchorL) transposedScale[step] = lerp(anchorL, .97, (defaultStepL - defaultAnchorL) / (1 - defaultAnchorL));
-			else transposedScale[step] = lerp(.05, anchorL, defaultStepL / defaultAnchorL);
-		}
-		return transposedScale;
-	}
-	for (const step of STEP_NAMES) {
-		const anchored = parsedAnchors[step];
-		if (anchored) {
-			transposedScale[step] = anchored.l;
-			continue;
-		}
-		let lowerStep = null;
-		let upperStep = null;
-		for (let i = sortedAnchorSteps.length - 1; i >= 0; i--) {
-			const candidate = sortedAnchorSteps[i];
-			if (candidate < step) {
-				lowerStep = candidate;
-				break;
-			}
-		}
-		for (const anchorStep of sortedAnchorSteps) if (anchorStep > step) {
-			upperStep = anchorStep;
-			break;
-		}
-		if (lowerStep !== null && upperStep !== null) {
-			const lowerL = parsedAnchors[lowerStep].l;
-			const upperL = parsedAnchors[upperStep].l;
-			const span = upperStep - lowerStep;
-			transposedScale[step] = lerp(lowerL, upperL, (step - lowerStep) / span);
-		} else if (lowerStep !== null) {
-			const lowerL = parsedAnchors[lowerStep].l;
-			const defaultLowerL = DEFAULT_LIGHTNESS_SCALE[lowerStep];
-			transposedScale[step] = lerp(.05, lowerL, DEFAULT_LIGHTNESS_SCALE[step] / defaultLowerL);
-		} else if (upperStep !== null) {
-			const upperL = parsedAnchors[upperStep].l;
-			const defaultUpperL = DEFAULT_LIGHTNESS_SCALE[upperStep];
-			transposedScale[step] = lerp(upperL, .97, (DEFAULT_LIGHTNESS_SCALE[step] - defaultUpperL) / (1 - defaultUpperL));
-		}
-	}
-	return transposedScale;
+function lerpHue(start, end, factor) {
+	return (start + (((end - start) % 360 + 540) % 360 - 180) * factor + 360) % 360;
 }
 /**
-* Automatically assigns a color to the most appropriate step based on its lightness.
+* The ladder step whose lightness is closest to `lightness` — i.e. where a
+* supplied colour naturally belongs.
 */
 function assignStepByLightness(lightness) {
 	let closestStep = 500;
-	let minDiff = Math.abs(lightness - DEFAULT_LIGHTNESS_SCALE[500]);
+	let minDiff = Math.abs(lightness - LIGHTNESS_LADDER[500]);
 	for (const step of STEP_NAMES) {
-		const diff = Math.abs(lightness - DEFAULT_LIGHTNESS_SCALE[step]);
+		const diff = Math.abs(lightness - LIGHTNESS_LADDER[step]);
 		if (diff < minDiff) {
 			minDiff = diff;
 			closestStep = step;
@@ -438,68 +413,78 @@ function assignStepByLightness(lightness) {
 	return closestStep;
 }
 /**
-* Generates a complete 11-step OKLCH palette from one or more colors.
-* Automatically determines which step each color belongs to based on lightness.
+* How far an anchored colour sits from its step's ladder lightness.
+*
+* The generator surfaces this as a warning: a large deviation is legal (the
+* caller asked for that exact colour) but it means the hue will read heavier or
+* lighter than its siblings at that step, which is worth knowing rather than
+* discovering later.
+*/
+function ladderDeviation(step, lightness) {
+	return lightness - LIGHTNESS_LADDER[step];
+}
+/** Absolute chroma ceiling — beyond this nothing survives gamut mapping anyway. */
+const MAX_CHROMA = .37;
+/**
+* Build a complete 11-step OKLCH ramp from one or more anchor colours.
+*
+* **Ladder-first with exact anchors.** Every anchor is reproduced *verbatim* at
+* its step; every other step takes its lightness from `LIGHTNESS_LADDER`, with
+* chroma and hue interpolated between the flanking anchors and decayed toward
+* `ENDPOINT_CHROMA` beyond the outermost ones.
+*
+* The consequence is the point: a client's brand hex survives byte-for-byte,
+* while the other ten steps stay directly comparable to every other hue. The
+* deviation from the ladder is bounded and *local to anchored steps* — unlike
+* the previous engine, which warped the whole ramp to fit its anchors so every
+* step drifted.
+*
+* Chroma may come out beyond the sRGB gamut here; that is deliberate.
+* `oklchStringToHex` gamut-maps with the CSS algorithm, which reduces chroma
+* while holding lightness, so the ladder survives the conversion.
 */
 function generateOklchPalette(input) {
 	let anchors = {};
-	if (typeof input === "string") {
-		const step = assignStepByLightness(parseOklch(input).l);
-		anchors[step] = input;
-	} else if (Array.isArray(input)) for (const colorStr of input) {
-		const step = assignStepByLightness(parseOklch(colorStr).l);
-		anchors[step] = colorStr;
-	}
-	else if (typeof input === "object") anchors = input;
+	if (typeof input === "string") anchors[assignStepByLightness(parseOklch(input).l)] = input;
+	else if (Array.isArray(input)) for (const colorStr of input) anchors[assignStepByLightness(parseOklch(colorStr).l)] = colorStr;
+	else if (typeof input === "object" && input !== null) anchors = { ...input };
 	else throw new Error("Input must be a color string, array of colors, or object with step assignments");
 	const parsedAnchors = {};
-	for (const key in anchors) parsedAnchors[parseInt(key)] = parseOklch(anchors[key]);
-	const sortedAnchorSteps = Object.keys(parsedAnchors).map(Number).sort((a, b) => a - b);
-	const lightnessScale = transposeLightnessScale(parsedAnchors, sortedAnchorSteps);
+	for (const [key, value] of Object.entries(anchors)) parsedAnchors[Number(key)] = parseOklch(value);
+	const anchorSteps = Object.keys(parsedAnchors).map(Number).sort((a, b) => a - b);
+	const idx = (step) => STEP_NAMES.indexOf(step);
+	const lastIdx = STEP_NAMES.length - 1;
 	const palette = {};
 	for (const step of STEP_NAMES) {
 		if (parsedAnchors[step]) {
 			palette[step] = anchors[step];
 			continue;
 		}
-		let startStep = null;
-		let endStep = null;
-		for (let i = sortedAnchorSteps.length - 1; i >= 0; i--) {
-			const candidate = sortedAnchorSteps[i];
-			if (candidate < step) {
-				startStep = candidate;
-				break;
-			}
-		}
-		for (const anchorStep of sortedAnchorSteps) if (anchorStep > step) {
-			endStep = anchorStep;
-			break;
-		}
-		let c_int, h_int;
-		if (startStep !== null && endStep !== null) {
-			const startColor = parsedAnchors[startStep];
-			const endColor = parsedAnchors[endStep];
-			const span = endStep - startStep;
-			const factor = (step - startStep) / span;
-			c_int = lerp(startColor.c, endColor.c, factor);
-			h_int = lerp(startColor.h, endColor.h, factor);
-		} else if (startStep !== null) {
-			const a = parsedAnchors[startStep];
-			c_int = a.c;
-			h_int = a.h;
-		} else if (endStep !== null) {
-			const a = parsedAnchors[endStep];
-			c_int = a.c;
-			h_int = a.h;
+		const lighter = [...anchorSteps].reverse().find((s) => s < step);
+		const darker = anchorSteps.find((s) => s > step);
+		let chroma;
+		let hue;
+		if (lighter !== void 0 && darker !== void 0) {
+			const a = parsedAnchors[lighter];
+			const b = parsedAnchors[darker];
+			const factor = (idx(step) - idx(lighter)) / (idx(darker) - idx(lighter));
+			chroma = lerp(a.c, b.c, factor);
+			hue = lerpHue(a.h, b.h, factor);
+		} else if (lighter !== void 0) {
+			const a = parsedAnchors[lighter];
+			const factor = (idx(step) - idx(lighter)) / (lastIdx - idx(lighter));
+			chroma = lerp(a.c, ENDPOINT_CHROMA.dark, factor);
+			hue = a.h;
+		} else if (darker !== void 0) {
+			const b = parsedAnchors[darker];
+			const factor = (idx(darker) - idx(step)) / idx(darker);
+			chroma = lerp(b.c, ENDPOINT_CHROMA.light, factor);
+			hue = b.h;
 		} else {
-			c_int = .1;
-			h_int = 0;
+			chroma = .1;
+			hue = 0;
 		}
-		const l_int = lightnessScale[step];
-		const dampeningFactor = l_int < .25 ? .3 + l_int / .25 * .7 : l_int > .75 ? .3 + (1 - l_int) / .25 * .7 : 1;
-		c_int *= dampeningFactor;
-		c_int = Math.min(c_int, .37);
-		palette[step] = `oklch(${(l_int * 100).toFixed(2) + "%"} ${c_int.toFixed(4)} ${h_int.toFixed(2)})`;
+		palette[step] = `oklch(${(LIGHTNESS_LADDER[step] * 100).toFixed(2) + "%"} ${Math.min(chroma, MAX_CHROMA).toFixed(4)} ${hue.toFixed(2)})`;
 	}
 	return palette;
 }
@@ -529,17 +514,22 @@ function pickOn(bg, hue) {
 * The tinted off-white / off-black endpoints for a hue — white/black with a
 * whisper of the hue mixed in. These are the text/background tints every ramp
 * needs (and the one exception strict brand kits allow).
+*
+* Derived from `LIGHTNESS_LADDER` and `ENDPOINT_CHROMA` rather than its own
+* literals, so a strict tone kit's endpoints land on the same ladder rungs a
+* generated ramp would have used. This is the single definition — callers must
+* not hand-write their own near-white/near-black.
 */
-function tintedEndpoints(hue, chroma = .01) {
+function tintedEndpoints(hue, chroma) {
 	return {
 		light: oklchToHex({
-			l: .98,
-			c: Math.min(chroma, .02),
+			l: LIGHTNESS_LADDER[50],
+			c: Math.min(chroma ?? ENDPOINT_CHROMA.light, .02),
 			h: hue
 		}),
 		dark: oklchToHex({
-			l: .16,
-			c: Math.min(chroma * 1.5, .03),
+			l: LIGHTNESS_LADDER[950],
+			c: Math.min((chroma ?? ENDPOINT_CHROMA.dark) * 1.5, .03),
 			h: hue
 		})
 	};
@@ -647,5 +637,5 @@ function suggestFunctionalColorHue(type, existingHues) {
 }
 
 //#endregion
-export { COLOR_GROUPS, DEFAULT_FUNCTIONAL_HUES, HARMONY_DEFINITIONS, HARMONY_STRATEGIES, HARMONY_TYPES, STEP_NAMES, applyHarmonyStrategy, contrastLc, formatColorName, gamutMapOklchToHex, generateOklchPalette, getColorName, getColorNameWithHue, getHarmonySuggestions, hexToOklch, oklchStringToHex, oklchToHex, oklchToP3, oklchToSrgb, parseOklch, pickOn, suggestFunctionalColorHue, tintedEndpoints };
+export { COLOR_GROUPS, DEFAULT_FUNCTIONAL_HUES, ENDPOINT_CHROMA, HARMONY_DEFINITIONS, HARMONY_STRATEGIES, HARMONY_TYPES, LIGHTNESS_LADDER, STEP_NAMES, applyHarmonyStrategy, assignStepByLightness, contrastLc, formatColorName, gamutMapOklchToHex, generateOklchPalette, getColorName, getColorNameWithHue, getHarmonySuggestions, hexToOklch, ladderDeviation, oklchStringToHex, oklchToHex, oklchToP3, oklchToSrgb, parseOklch, pickOn, suggestFunctionalColorHue, tintedEndpoints };
 //# sourceMappingURL=index.mjs.map

package/dist/color/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["OKLCH_Space","sRGB_Space","P3_Space"],"sources":["../../src/color/colors.ts","../../src/color/color-harmony.ts"],"sourcesContent":["import Color from 'colorjs.io';\nimport {\n  OKLCH as OKLCH_Space,\n  sRGB as sRGB_Space,\n  P3 as P3_Space,\n  ColorSpace,\n  to,\n  toGamutCSS,\n  clone,\n  serialize,\n  type PlainColorObject,\n} from 'colorjs.io/fn';\n\n// Register color spaces once for functional API\nColorSpace.register(OKLCH_Space);\nColorSpace.register(sRGB_Space);\nColorSpace.register(P3_Space);\n\nexport interface RgbResult {\n  r: number;\n  g: number;\n  b: number;\n  inGamut: boolean;\n  /** Max channel overshoot beyond [0,1] before clamping. 0 when in gamut. */\n  gamutDistance: number;\n}\n\n/**\n * Convert OKLCh to sRGB, returning 0-255 clamped values with gamut flag.\n * Fast path for per-pixel canvas rendering (no gamut mapping, just clamp).\n */\nexport function oklchToSrgb(l: number, c: number, h: number): RgbResult {\n  const col: PlainColorObject = { space: OKLCH_Space, coords: [l, c, h], alpha: 1 };\n  const rgb = to(col, sRGB_Space);\n  const [r, g, b] = rgb.coords;\n  const inGamut = r >= 0 && r <= 1 && g >= 0 && g <= 1 && b >= 0 && b <= 1;\n  const gamutDistance = inGamut ? 0 : Math.max(-r, r - 1, -g, g - 1, -b, b - 1, 0);\n  return {\n    r: Math.max(0, Math.min(255, Math.round(r * 255))),\n    g: Math.max(0, Math.min(255, Math.round(g * 255))),\n    b: Math.max(0, Math.min(255, Math.round(b * 255))),\n    inGamut,\n    gamutDistance,\n  };\n}\n\n/**\n * Convert OKLCh to Display P3, returning 0-255 clamped values with gamut flag.\n * Fast path for per-pixel canvas rendering on P3 displays.\n */\nexport function oklchToP3(l: number, c: number, h: number): RgbResult {\n  const col: PlainColorObject = { space: OKLCH_Space, coords: [l, c, h], alpha: 1 };\n  const rgb = to(col, P3_Space);\n  const [r, g, b] = rgb.coords;\n  const inGamut = r >= 0 && r <= 1 && g >= 0 && g <= 1 && b >= 0 && b <= 1;\n  const gamutDistance = inGamut ? 0 : Math.max(-r, r - 1, -g, g - 1, -b, b - 1, 0);\n  return {\n    r: Math.max(0, Math.min(255, Math.round(r * 255))),\n    g: Math.max(0, Math.min(255, Math.round(g * 255))),\n    b: Math.max(0, Math.min(255, Math.round(b * 255))),\n    inGamut,\n    gamutDistance,\n  };\n}\n\n/**\n * Gamut-map an OKLCh color using the CSS gamut mapping algorithm, return hex.\n * Slower than oklchToSrgb/oklchToP3 (uses iterative reduction), use for single colors only.\n */\nexport function gamutMapOklchToHex(\n  l: number,\n  c: number,\n  h: number,\n  space: 'srgb' | 'p3' = 'srgb',\n): string {\n  const col: PlainColorObject = { space: OKLCH_Space, coords: [l, c, h], alpha: 1 };\n  const targetSpace = space === 'p3' ? P3_Space : sRGB_Space;\n  const mapped = toGamutCSS(clone(col), { space: targetSpace });\n  const rgb = to(mapped, sRGB_Space);\n  return serialize(rgb, { format: 'hex' });\n}\n\n// Standard 11-step scale - will be transposed based on input anchors\nexport const STEP_NAMES = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950] as const;\nexport type StepName = (typeof STEP_NAMES)[number];\n\nexport const COLOR_GROUPS = [\n  'neutral',\n  'brand',\n  'primary',\n  'accent',\n  'complement',\n  'success',\n  'warning',\n  'error',\n  'info',\n] as const;\nexport type ColorGroup = (typeof COLOR_GROUPS)[number];\n\n/**\n * Convert hex color to OKLCH components\n */\nexport function hexToOklch(hex: string): { l: number; c: number; h: number } {\n  const color = new Color(hex);\n  const oklch = color.to('oklch');\n  return {\n    l: oklch.coords[0],\n    c: oklch.coords[1],\n    h: oklch.coords[2] || 0,\n  };\n}\n\n/**\n * Convert OKLCH components to hex color\n */\nexport function oklchToHex(oklch: { l: number; c: number; h: number }): string {\n  const color = new Color('oklch', [oklch.l, oklch.c, oklch.h]);\n  // Convert to sRGB and clamp to gamut, then format as hex\n  const srgb = color.to('srgb');\n  if (!srgb.inGamut()) {\n    srgb.toGamut({ method: 'css' });\n  }\n  return srgb.toString({ format: 'hex' });\n}\n\n/**\n * Convert OKLCH CSS string to hex color\n * @example oklchStringToHex(\"oklch(50% 0.15 270)\") => \"#8b5cf6\"\n */\nexport function oklchStringToHex(oklchString: string): string {\n  try {\n    const color = new Color(oklchString);\n    const srgb = color.to('srgb');\n    if (!srgb.inGamut()) {\n      srgb.toGamut({ method: 'css' });\n    }\n    return srgb.toString({ format: 'hex' });\n  } catch {\n    return '#808080';\n  }\n}\n\n/**\n * Format a color name by separating compound words\n * Examples: \"mediumseagreen\" -> \"Medium Sea Green\", \"darkblue\" -> \"Dark Blue\"\n */\nexport function formatColorName(name: string): string {\n  if (!name) return 'Unknown';\n\n  // Handle special cases with proper word separation\n  const specialCases: Record<string, string> = {\n    aliceblue: 'Alice Blue',\n    antiquewhite: 'Antique White',\n    blanchedalmond: 'Blanched Almond',\n    blueviolet: 'Blue Violet',\n    burlywood: 'Burly Wood',\n    cadetblue: 'Cadet Blue',\n    cornflowerblue: 'Cornflower Blue',\n    darkblue: 'Dark Blue',\n    darkcyan: 'Dark Cyan',\n    darkgoldenrod: 'Dark Goldenrod',\n    darkgray: 'Dark Gray',\n    darkgreen: 'Dark Green',\n    darkgrey: 'Dark Grey',\n    darkkhaki: 'Dark Khaki',\n    darkmagenta: 'Dark Magenta',\n    darkolivegreen: 'Dark Olive Green',\n    darkorange: 'Dark Orange',\n    darkorchid: 'Dark Orchid',\n    darkred: 'Dark Red',\n    darksalmon: 'Dark Salmon',\n    darkseagreen: 'Dark Sea Green',\n    darkslateblue: 'Dark Slate Blue',\n    darkslategray: 'Dark Slate Gray',\n    darkslategrey: 'Dark Slate Grey',\n    darkturquoise: 'Dark Turquoise',\n    darkviolet: 'Dark Violet',\n    deeppink: 'Deep Pink',\n    deepskyblue: 'Deep Sky Blue',\n    dimgray: 'Dim Gray',\n    dimgrey: 'Dim Grey',\n    dodgerblue: 'Dodger Blue',\n    floralwhite: 'Floral White',\n    forestgreen: 'Forest Green',\n    ghostwhite: 'Ghost White',\n    greenyellow: 'Green Yellow',\n    hotpink: 'Hot Pink',\n    indianred: 'Indian Red',\n    lavenderblush: 'Lavender Blush',\n    lawngreen: 'Lawn Green',\n    lemonchiffon: 'Lemon Chiffon',\n    lightblue: 'Light Blue',\n    lightcoral: 'Light Coral',\n    lightcyan: 'Light Cyan',\n    lightgoldenrodyellow: 'Light Goldenrod Yellow',\n    lightgray: 'Light Gray',\n    lightgreen: 'Light Green',\n    lightgrey: 'Light Grey',\n    lightpink: 'Light Pink',\n    lightsalmon: 'Light Salmon',\n    lightseagreen: 'Light Sea Green',\n    lightskyblue: 'Light Sky Blue',\n    lightslategray: 'Light Slate Gray',\n    lightslategrey: 'Light Slate Grey',\n    lightsteelblue: 'Light Steel Blue',\n    lightyellow: 'Light Yellow',\n    limegreen: 'Lime Green',\n    mediumaquamarine: 'Medium Aquamarine',\n    mediumblue: 'Medium Blue',\n    mediumorchid: 'Medium Orchid',\n    mediumpurple: 'Medium Purple',\n    mediumseagreen: 'Medium Sea Green',\n    mediumslateblue: 'Medium Slate Blue',\n    mediumspringgreen: 'Medium Spring Green',\n    mediumturquoise: 'Medium Turquoise',\n    mediumvioletred: 'Medium Violet Red',\n    midnightblue: 'Midnight Blue',\n    mintcream: 'Mint Cream',\n    mistyrose: 'Misty Rose',\n    navajowhite: 'Navajo White',\n    oldlace: 'Old Lace',\n    olivedrab: 'Olive Drab',\n    orangered: 'Orange Red',\n    palegoldenrod: 'Pale Goldenrod',\n    palegreen: 'Pale Green',\n    paleturquoise: 'Pale Turquoise',\n    palevioletred: 'Pale Violet Red',\n    papayawhip: 'Papaya Whip',\n    peachpuff: 'Peach Puff',\n    powderblue: 'Powder Blue',\n    rosybrown: 'Rosy Brown',\n    royalblue: 'Royal Blue',\n    saddlebrown: 'Saddle Brown',\n    sandybrown: 'Sandy Brown',\n    seagreen: 'Sea Green',\n    skyblue: 'Sky Blue',\n    slateblue: 'Slate Blue',\n    slategray: 'Slate Gray',\n    slategrey: 'Slate Grey',\n    springgreen: 'Spring Green',\n    steelblue: 'Steel Blue',\n    whitesmoke: 'White Smoke',\n    yellowgreen: 'Yellow Green',\n  };\n\n  const lowerName = name.toLowerCase();\n  if (specialCases[lowerName]) {\n    return specialCases[lowerName];\n  }\n\n  // Default: just capitalize first letter\n  return name.charAt(0).toUpperCase() + name.slice(1);\n}\n\n/**\n * Get the closest CSS color name for a hex color\n */\nexport function getColorName(hex: string): string {\n  try {\n    const color = new Color(hex);\n    const oklch = color.to('oklch');\n    const hue = oklch.coords[2] || 0;\n\n    if (hue < 30 || hue >= 330) return 'Red';\n    if (hue < 60) return 'Orange';\n    if (hue < 90) return 'Yellow';\n    if (hue < 150) return 'Green';\n    if (hue < 210) return 'Cyan';\n    if (hue < 270) return 'Blue';\n    if (hue < 330) return 'Purple';\n    return 'Unknown';\n  } catch {\n    return 'Unknown';\n  }\n}\n\n/**\n * Get color name with hue value\n */\nexport function getColorNameWithHue(hex: string): string {\n  try {\n    const color = new Color(hex);\n    const oklch = color.to('oklch');\n    const hue = oklch.coords[2] || 0;\n    const roundedHue = Math.round(hue / 10) * 10;\n    const name = getColorName(hex);\n    return `${name} ${roundedHue}`;\n  } catch {\n    return 'Unknown';\n  }\n}\n\n// Color harmony definitions\nexport const HARMONY_TYPES = [\n  'single',\n  'analogous',\n  'triad',\n  'complementary',\n  'split-complementary',\n  'square',\n  'compound',\n] as const;\nexport type HarmonyType = (typeof HARMONY_TYPES)[number];\n\nexport interface HarmonyDefinition {\n  label: string;\n  offsets: number[];\n  primaryIndex: number;\n}\n\nexport const HARMONY_DEFINITIONS: Record<HarmonyType, HarmonyDefinition> = {\n  single: {\n    label: 'Single',\n    offsets: [0],\n    primaryIndex: 0,\n  },\n  analogous: {\n    label: 'Analogous',\n    offsets: [-30, 0, 30],\n    primaryIndex: 1,\n  },\n  triad: {\n    label: 'Triad',\n    offsets: [0, 120, 240],\n    primaryIndex: 0,\n  },\n  complementary: {\n    label: 'Complementary',\n    offsets: [0, 180],\n    primaryIndex: 0,\n  },\n  'split-complementary': {\n    label: 'Split Complementary',\n    offsets: [0, 150, 210],\n    primaryIndex: 0,\n  },\n  square: {\n    label: 'Square',\n    offsets: [0, 90, 180, 270],\n    primaryIndex: 0,\n  },\n  compound: {\n    label: 'Compound',\n    offsets: [-30, 0, 180, 210],\n    primaryIndex: 1,\n  },\n};\n\n// Default lightness positions (lightest to darkest)\nconst DEFAULT_LIGHTNESS_SCALE: Record<StepName, number> = {\n  50: 0.95,\n  100: 0.9,\n  200: 0.8,\n  300: 0.7,\n  400: 0.6,\n  500: 0.5,\n  600: 0.4,\n  700: 0.3,\n  800: 0.2,\n  900: 0.1,\n  950: 0.05,\n};\n\ninterface OklchColor {\n  l: number;\n  c: number;\n  h: number;\n}\n\n/**\n * Parses an OKLCH CSS string into numerical components.\n * @param oklchString - e.g., 'oklch(50% 0.15 270)'\n * @returns Lightness (0-1), Chroma (0-~0.37), Hue (0-360)\n */\nexport function parseOklch(oklchString: string): OklchColor {\n  const parts = oklchString.match(/oklch\\(([^ ]+) ([^ ]+) ([^ ]+)\\)/);\n  if (!parts) throw new Error('Invalid OKLCH string format.');\n\n  const [, lRaw = '', cRaw = '', hRaw = ''] = parts;\n  const l = parseFloat(lRaw) / (lRaw.includes('%') ? 100 : 1);\n  const c = parseFloat(cRaw);\n  const h = parseFloat(hRaw);\n\n  return { l, c, h };\n}\n\n/**\n * Linearly interpolates a value between a start and end point.\n */\nfunction lerp(start: number, end: number, factor: number): number {\n  return start + factor * (end - start);\n}\n\n/**\n * Transpose the default lightness scale to match the provided anchors.\n */\nfunction transposeLightnessScale(\n  parsedAnchors: Record<StepName, OklchColor>,\n  sortedAnchorSteps: StepName[],\n): Record<StepName, number> {\n  const transposedScale: Record<number, number> = {};\n\n  if (sortedAnchorSteps.length === 1) {\n    const anchorStep = sortedAnchorSteps[0] as StepName;\n    const anchorL = (parsedAnchors[anchorStep] as OklchColor).l;\n    const defaultAnchorL = DEFAULT_LIGHTNESS_SCALE[anchorStep];\n\n    for (const step of STEP_NAMES) {\n      if (step === anchorStep) {\n        transposedScale[step] = anchorL;\n        continue;\n      }\n\n      const defaultStepL = DEFAULT_LIGHTNESS_SCALE[step];\n\n      if (defaultStepL > defaultAnchorL) {\n        const factor = (defaultStepL - defaultAnchorL) / (1.0 - defaultAnchorL);\n        transposedScale[step] = lerp(anchorL, 0.97, factor);\n      } else {\n        const factor = defaultStepL / defaultAnchorL;\n        transposedScale[step] = lerp(0.05, anchorL, factor);\n      }\n    }\n\n    return transposedScale;\n  }\n\n  for (const step of STEP_NAMES) {\n    const anchored = parsedAnchors[step];\n    if (anchored) {\n      transposedScale[step] = anchored.l;\n      continue;\n    }\n\n    let lowerStep: StepName | null = null;\n    let upperStep: StepName | null = null;\n\n    for (let i = sortedAnchorSteps.length - 1; i >= 0; i--) {\n      const candidate = sortedAnchorSteps[i] as StepName;\n      if (candidate < step) {\n        lowerStep = candidate;\n        break;\n      }\n    }\n\n    for (const anchorStep of sortedAnchorSteps) {\n      if (anchorStep > step) {\n        upperStep = anchorStep;\n        break;\n      }\n    }\n\n    if (lowerStep !== null && upperStep !== null) {\n      const lowerL = (parsedAnchors[lowerStep] as OklchColor).l;\n      const upperL = (parsedAnchors[upperStep] as OklchColor).l;\n      const span = upperStep - lowerStep;\n      const position = step - lowerStep;\n      const factor = position / span;\n      transposedScale[step] = lerp(lowerL, upperL, factor);\n    } else if (lowerStep !== null) {\n      const lowerL = (parsedAnchors[lowerStep] as OklchColor).l;\n      const defaultLowerL = DEFAULT_LIGHTNESS_SCALE[lowerStep];\n      const defaultStepL = DEFAULT_LIGHTNESS_SCALE[step];\n      const factor = defaultStepL / defaultLowerL;\n      transposedScale[step] = lerp(0.05, lowerL, factor);\n    } else if (upperStep !== null) {\n      const upperL = (parsedAnchors[upperStep] as OklchColor).l;\n      const defaultUpperL = DEFAULT_LIGHTNESS_SCALE[upperStep];\n      const defaultStepL = DEFAULT_LIGHTNESS_SCALE[step];\n      const factor = (defaultStepL - defaultUpperL) / (1.0 - defaultUpperL);\n      transposedScale[step] = lerp(upperL, 0.97, factor);\n    }\n  }\n\n  return transposedScale;\n}\n\n/**\n * Automatically assigns a color to the most appropriate step based on its lightness.\n */\nfunction assignStepByLightness(lightness: number): StepName {\n  let closestStep: StepName = 500;\n  let minDiff = Math.abs(lightness - DEFAULT_LIGHTNESS_SCALE[500]);\n\n  for (const step of STEP_NAMES) {\n    const diff = Math.abs(lightness - DEFAULT_LIGHTNESS_SCALE[step]);\n    if (diff < minDiff) {\n      minDiff = diff;\n      closestStep = step;\n    }\n  }\n\n  return closestStep;\n}\n\n/**\n * Generates a complete 11-step OKLCH palette from one or more colors.\n * Automatically determines which step each color belongs to based on lightness.\n */\nexport function generateOklchPalette(\n  input: string | string[] | Record<string, string>,\n): Record<StepName, string> {\n  let anchors: Record<number, string> = {};\n\n  if (typeof input === 'string') {\n    const parsed = parseOklch(input);\n    const step = assignStepByLightness(parsed.l);\n    anchors[step] = input;\n  } else if (Array.isArray(input)) {\n    for (const colorStr of input) {\n      const parsed = parseOklch(colorStr);\n      const step = assignStepByLightness(parsed.l);\n      anchors[step] = colorStr;\n    }\n  } else if (typeof input === 'object') {\n    anchors = input;\n  } else {\n    throw new Error(\n      'Input must be a color string, array of colors, or object with step assignments',\n    );\n  }\n\n  const parsedAnchors: Record<number, OklchColor> = {};\n\n  for (const key in anchors) {\n    parsedAnchors[parseInt(key)] = parseOklch(anchors[key] as string);\n  }\n\n  const sortedAnchorSteps = Object.keys(parsedAnchors)\n    .map(Number)\n    .sort((a, b) => a - b) as StepName[];\n\n  const lightnessScale = transposeLightnessScale(\n    parsedAnchors as Record<StepName, OklchColor>,\n    sortedAnchorSteps,\n  );\n\n  const palette: Record<number, string> = {};\n\n  for (const step of STEP_NAMES) {\n    if (parsedAnchors[step]) {\n      palette[step] = anchors[step] as string;\n      continue;\n    }\n\n    let startStep: StepName | null = null;\n    let endStep: StepName | null = null;\n\n    for (let i = sortedAnchorSteps.length - 1; i >= 0; i--) {\n      const candidate = sortedAnchorSteps[i] as StepName;\n      if (candidate < step) {\n        startStep = candidate;\n        break;\n      }\n    }\n\n    for (const anchorStep of sortedAnchorSteps) {\n      if (anchorStep > step) {\n        endStep = anchorStep;\n        break;\n      }\n    }\n\n    let c_int, h_int;\n\n    if (startStep !== null && endStep !== null) {\n      const startColor = parsedAnchors[startStep] as OklchColor;\n      const endColor = parsedAnchors[endStep] as OklchColor;\n      const span = endStep - startStep;\n      const position = step - startStep;\n      const factor = position / span;\n\n      c_int = lerp(startColor.c, endColor.c, factor);\n      h_int = lerp(startColor.h, endColor.h, factor);\n    } else if (startStep !== null) {\n      const a = parsedAnchors[startStep] as OklchColor;\n      c_int = a.c;\n      h_int = a.h;\n    } else if (endStep !== null) {\n      const a = parsedAnchors[endStep] as OklchColor;\n      c_int = a.c;\n      h_int = a.h;\n    } else {\n      c_int = 0.1;\n      h_int = 0;\n    }\n\n    const l_int = lightnessScale[step] as number;\n\n    const dampeningFactor =\n      l_int < 0.25\n        ? 0.3 + (l_int / 0.25) * 0.7\n        : l_int > 0.75\n          ? 0.3 + ((1 - l_int) / 0.25) * 0.7\n          : 1.0;\n\n    c_int *= dampeningFactor;\n    c_int = Math.min(c_int, 0.37);\n\n    const finalL = (l_int * 100).toFixed(2) + '%';\n    const finalC = c_int.toFixed(4);\n    const finalH = h_int.toFixed(2);\n\n    palette[step] = `oklch(${finalL} ${finalC} ${finalH})`;\n  }\n\n  return palette;\n}\n\n// ── Contrast + endpoints (for the functional-token layer) ────────────────────\n\n/** APCA lightness-contrast (Lc) magnitude between a foreground and background. */\nexport function contrastLc(fg: string, bg: string): number {\n  return Math.abs(new Color(bg).contrast(fg, 'APCA'));\n}\n\n/**\n * Pick a tinted near-white or near-black foreground for best contrast on `bg`\n * (a whisper of the background's hue mixed into off-white/off-black).\n */\nexport function pickOn(bg: string, hue?: number): string {\n  const h = hue ?? hexToOklch(bg).h;\n  const white = oklchToHex({ l: 0.98, c: 0.01, h });\n  const black = oklchToHex({ l: 0.16, c: 0.02, h });\n  return contrastLc(white, bg) >= contrastLc(black, bg) ? white : black;\n}\n\n/**\n * The tinted off-white / off-black endpoints for a hue — white/black with a\n * whisper of the hue mixed in. These are the text/background tints every ramp\n * needs (and the one exception strict brand kits allow).\n */\nexport function tintedEndpoints(hue: number, chroma = 0.01): { light: string; dark: string } {\n  return {\n    light: oklchToHex({ l: 0.98, c: Math.min(chroma, 0.02), h: hue }),\n    dark: oklchToHex({ l: 0.16, c: Math.min(chroma * 1.5, 0.03), h: hue }),\n  };\n}\n","/**\n * Color harmony strategies for generating complementary colors\n */\n\nexport type HarmonyStrategy =\n  | 'complement'\n  | 'analogous-plus'\n  | 'analogous-minus'\n  | 'triadic-plus'\n  | 'triadic-minus'\n  | 'split-plus'\n  | 'split-minus'\n  | 'tetradic-plus'\n  | 'tetradic-minus';\n\nexport interface HarmonyOption {\n  id: HarmonyStrategy;\n  label: string;\n  description: string;\n  hueShift: number;\n}\n\nexport const HARMONY_STRATEGIES: HarmonyOption[] = [\n  {\n    id: 'complement',\n    label: 'Complement',\n    description: 'Opposite on color wheel (high contrast)',\n    hueShift: 180,\n  },\n  {\n    id: 'analogous-plus',\n    label: 'Analogous+',\n    description: 'Adjacent colors (harmonious)',\n    hueShift: 30,\n  },\n  {\n    id: 'analogous-minus',\n    label: 'Analogous-',\n    description: 'Adjacent colors (harmonious)',\n    hueShift: -30,\n  },\n  {\n    id: 'triadic-plus',\n    label: 'Triadic+',\n    description: 'Evenly spaced (balanced)',\n    hueShift: 120,\n  },\n  {\n    id: 'triadic-minus',\n    label: 'Triadic-',\n    description: 'Evenly spaced (balanced)',\n    hueShift: -120,\n  },\n  {\n    id: 'split-plus',\n    label: 'Split Complement+',\n    description: 'Near opposite (softer contrast)',\n    hueShift: 150,\n  },\n  {\n    id: 'split-minus',\n    label: 'Split Complement-',\n    description: 'Near opposite (softer contrast)',\n    hueShift: -150,\n  },\n  {\n    id: 'tetradic-plus',\n    label: 'Tetradic+',\n    description: 'Square spacing (rich palette)',\n    hueShift: 90,\n  },\n  {\n    id: 'tetradic-minus',\n    label: 'Tetradic-',\n    description: 'Square spacing (rich palette)',\n    hueShift: -90,\n  },\n];\n\n/**\n * Applies a harmony strategy to a hue value\n */\nexport function applyHarmonyStrategy(baseHue: number, strategy: HarmonyStrategy): number {\n  const harmonyOption = HARMONY_STRATEGIES.find((h) => h.id === strategy);\n  if (!harmonyOption) return baseHue;\n\n  let newHue = baseHue + harmonyOption.hueShift;\n\n  // Normalize to 0-360 range\n  while (newHue < 0) newHue += 360;\n  while (newHue >= 360) newHue -= 360;\n\n  return newHue;\n}\n\n/**\n * Gets all harmony suggestions for a given base hue\n */\nexport function getHarmonySuggestions(\n  baseHue: number,\n): Array<{ strategy: HarmonyStrategy; hue: number; label: string; description: string }> {\n  return HARMONY_STRATEGIES.map((strategy) => ({\n    strategy: strategy.id,\n    hue: applyHarmonyStrategy(baseHue, strategy.id),\n    label: strategy.label,\n    description: strategy.description,\n  }));\n}\n\n/**\n * Default functional color hues (if user doesn't specify)\n */\nexport const DEFAULT_FUNCTIONAL_HUES = {\n  success: 142, // Green\n  warning: 38, // Orange/Amber\n  error: 0, // Red\n  info: 200, // Blue\n} as const;\n\n/**\n * Suggests a functional color hue based on existing palette to maintain harmony\n */\nexport function suggestFunctionalColorHue(\n  type: keyof typeof DEFAULT_FUNCTIONAL_HUES,\n  existingHues: number[],\n): number {\n  const defaultHue = DEFAULT_FUNCTIONAL_HUES[type];\n\n  if (existingHues.length === 0) {\n    return defaultHue;\n  }\n\n  // Find the closest existing hue and adjust slightly to maintain harmony\n  const avgHue = existingHues.reduce((sum, h) => sum + h, 0) / existingHues.length;\n\n  // Rotate the default hue to be more in line with the palette's color temperature\n  const hueShift = avgHue - 200; // Assuming 200 is neutral blue\n  let adjustedHue = defaultHue + hueShift * 0.3; // 30% influence\n\n  // Normalize\n  while (adjustedHue < 0) adjustedHue += 360;\n  while (adjustedHue >= 360) adjustedHue -= 360;\n\n  return adjustedHue;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["OKLCH_Space","sRGB_Space","P3_Space"],"sources":["../../src/color/colors.ts","../../src/color/color-harmony.ts"],"sourcesContent":["import Color from 'colorjs.io';\nimport {\n  OKLCH as OKLCH_Space,\n  sRGB as sRGB_Space,\n  P3 as P3_Space,\n  ColorSpace,\n  to,\n  toGamutCSS,\n  clone,\n  serialize,\n  type PlainColorObject,\n} from 'colorjs.io/fn';\n\n// Register color spaces once for functional API\nColorSpace.register(OKLCH_Space);\nColorSpace.register(sRGB_Space);\nColorSpace.register(P3_Space);\n\nexport interface RgbResult {\n  r: number;\n  g: number;\n  b: number;\n  inGamut: boolean;\n  /** Max channel overshoot beyond [0,1] before clamping. 0 when in gamut. */\n  gamutDistance: number;\n}\n\n/**\n * Convert OKLCh to sRGB, returning 0-255 clamped values with gamut flag.\n * Fast path for per-pixel canvas rendering (no gamut mapping, just clamp).\n */\nexport function oklchToSrgb(l: number, c: number, h: number): RgbResult {\n  const col: PlainColorObject = { space: OKLCH_Space, coords: [l, c, h], alpha: 1 };\n  const rgb = to(col, sRGB_Space);\n  const [r, g, b] = rgb.coords;\n  const inGamut = r >= 0 && r <= 1 && g >= 0 && g <= 1 && b >= 0 && b <= 1;\n  const gamutDistance = inGamut ? 0 : Math.max(-r, r - 1, -g, g - 1, -b, b - 1, 0);\n  return {\n    r: Math.max(0, Math.min(255, Math.round(r * 255))),\n    g: Math.max(0, Math.min(255, Math.round(g * 255))),\n    b: Math.max(0, Math.min(255, Math.round(b * 255))),\n    inGamut,\n    gamutDistance,\n  };\n}\n\n/**\n * Convert OKLCh to Display P3, returning 0-255 clamped values with gamut flag.\n * Fast path for per-pixel canvas rendering on P3 displays.\n */\nexport function oklchToP3(l: number, c: number, h: number): RgbResult {\n  const col: PlainColorObject = { space: OKLCH_Space, coords: [l, c, h], alpha: 1 };\n  const rgb = to(col, P3_Space);\n  const [r, g, b] = rgb.coords;\n  const inGamut = r >= 0 && r <= 1 && g >= 0 && g <= 1 && b >= 0 && b <= 1;\n  const gamutDistance = inGamut ? 0 : Math.max(-r, r - 1, -g, g - 1, -b, b - 1, 0);\n  return {\n    r: Math.max(0, Math.min(255, Math.round(r * 255))),\n    g: Math.max(0, Math.min(255, Math.round(g * 255))),\n    b: Math.max(0, Math.min(255, Math.round(b * 255))),\n    inGamut,\n    gamutDistance,\n  };\n}\n\n/**\n * Gamut-map an OKLCh color using the CSS gamut mapping algorithm, return hex.\n * Slower than oklchToSrgb/oklchToP3 (uses iterative reduction), use for single colors only.\n */\nexport function gamutMapOklchToHex(\n  l: number,\n  c: number,\n  h: number,\n  space: 'srgb' | 'p3' = 'srgb',\n): string {\n  const col: PlainColorObject = { space: OKLCH_Space, coords: [l, c, h], alpha: 1 };\n  const targetSpace = space === 'p3' ? P3_Space : sRGB_Space;\n  const mapped = toGamutCSS(clone(col), { space: targetSpace });\n  const rgb = to(mapped, sRGB_Space);\n  return serialize(rgb, { format: 'hex' });\n}\n\n// Standard 11-step scale - will be transposed based on input anchors\nexport const STEP_NAMES = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950] as const;\nexport type StepName = (typeof STEP_NAMES)[number];\n\nexport const COLOR_GROUPS = [\n  'neutral',\n  'brand',\n  'primary',\n  'accent',\n  'complement',\n  'success',\n  'warning',\n  'error',\n  'info',\n] as const;\nexport type ColorGroup = (typeof COLOR_GROUPS)[number];\n\n/**\n * Convert hex color to OKLCH components\n */\nexport function hexToOklch(hex: string): { l: number; c: number; h: number } {\n  const color = new Color(hex);\n  const oklch = color.to('oklch');\n  return {\n    l: oklch.coords[0],\n    c: oklch.coords[1],\n    h: oklch.coords[2] || 0,\n  };\n}\n\n/**\n * Convert OKLCH components to hex color\n */\nexport function oklchToHex(oklch: { l: number; c: number; h: number }): string {\n  const color = new Color('oklch', [oklch.l, oklch.c, oklch.h]);\n  // Convert to sRGB and clamp to gamut, then format as hex\n  const srgb = color.to('srgb');\n  if (!srgb.inGamut()) {\n    srgb.toGamut({ method: 'css' });\n  }\n  return srgb.toString({ format: 'hex' });\n}\n\n/**\n * Convert OKLCH CSS string to hex color\n * @example oklchStringToHex(\"oklch(50% 0.15 270)\") => \"#8b5cf6\"\n */\nexport function oklchStringToHex(oklchString: string): string {\n  try {\n    const color = new Color(oklchString);\n    const srgb = color.to('srgb');\n    if (!srgb.inGamut()) {\n      srgb.toGamut({ method: 'css' });\n    }\n    return srgb.toString({ format: 'hex' });\n  } catch {\n    return '#808080';\n  }\n}\n\n/**\n * Format a color name by separating compound words\n * Examples: \"mediumseagreen\" -> \"Medium Sea Green\", \"darkblue\" -> \"Dark Blue\"\n */\nexport function formatColorName(name: string): string {\n  if (!name) return 'Unknown';\n\n  // Handle special cases with proper word separation\n  const specialCases: Record<string, string> = {\n    aliceblue: 'Alice Blue',\n    antiquewhite: 'Antique White',\n    blanchedalmond: 'Blanched Almond',\n    blueviolet: 'Blue Violet',\n    burlywood: 'Burly Wood',\n    cadetblue: 'Cadet Blue',\n    cornflowerblue: 'Cornflower Blue',\n    darkblue: 'Dark Blue',\n    darkcyan: 'Dark Cyan',\n    darkgoldenrod: 'Dark Goldenrod',\n    darkgray: 'Dark Gray',\n    darkgreen: 'Dark Green',\n    darkgrey: 'Dark Grey',\n    darkkhaki: 'Dark Khaki',\n    darkmagenta: 'Dark Magenta',\n    darkolivegreen: 'Dark Olive Green',\n    darkorange: 'Dark Orange',\n    darkorchid: 'Dark Orchid',\n    darkred: 'Dark Red',\n    darksalmon: 'Dark Salmon',\n    darkseagreen: 'Dark Sea Green',\n    darkslateblue: 'Dark Slate Blue',\n    darkslategray: 'Dark Slate Gray',\n    darkslategrey: 'Dark Slate Grey',\n    darkturquoise: 'Dark Turquoise',\n    darkviolet: 'Dark Violet',\n    deeppink: 'Deep Pink',\n    deepskyblue: 'Deep Sky Blue',\n    dimgray: 'Dim Gray',\n    dimgrey: 'Dim Grey',\n    dodgerblue: 'Dodger Blue',\n    floralwhite: 'Floral White',\n    forestgreen: 'Forest Green',\n    ghostwhite: 'Ghost White',\n    greenyellow: 'Green Yellow',\n    hotpink: 'Hot Pink',\n    indianred: 'Indian Red',\n    lavenderblush: 'Lavender Blush',\n    lawngreen: 'Lawn Green',\n    lemonchiffon: 'Lemon Chiffon',\n    lightblue: 'Light Blue',\n    lightcoral: 'Light Coral',\n    lightcyan: 'Light Cyan',\n    lightgoldenrodyellow: 'Light Goldenrod Yellow',\n    lightgray: 'Light Gray',\n    lightgreen: 'Light Green',\n    lightgrey: 'Light Grey',\n    lightpink: 'Light Pink',\n    lightsalmon: 'Light Salmon',\n    lightseagreen: 'Light Sea Green',\n    lightskyblue: 'Light Sky Blue',\n    lightslategray: 'Light Slate Gray',\n    lightslategrey: 'Light Slate Grey',\n    lightsteelblue: 'Light Steel Blue',\n    lightyellow: 'Light Yellow',\n    limegreen: 'Lime Green',\n    mediumaquamarine: 'Medium Aquamarine',\n    mediumblue: 'Medium Blue',\n    mediumorchid: 'Medium Orchid',\n    mediumpurple: 'Medium Purple',\n    mediumseagreen: 'Medium Sea Green',\n    mediumslateblue: 'Medium Slate Blue',\n    mediumspringgreen: 'Medium Spring Green',\n    mediumturquoise: 'Medium Turquoise',\n    mediumvioletred: 'Medium Violet Red',\n    midnightblue: 'Midnight Blue',\n    mintcream: 'Mint Cream',\n    mistyrose: 'Misty Rose',\n    navajowhite: 'Navajo White',\n    oldlace: 'Old Lace',\n    olivedrab: 'Olive Drab',\n    orangered: 'Orange Red',\n    palegoldenrod: 'Pale Goldenrod',\n    palegreen: 'Pale Green',\n    paleturquoise: 'Pale Turquoise',\n    palevioletred: 'Pale Violet Red',\n    papayawhip: 'Papaya Whip',\n    peachpuff: 'Peach Puff',\n    powderblue: 'Powder Blue',\n    rosybrown: 'Rosy Brown',\n    royalblue: 'Royal Blue',\n    saddlebrown: 'Saddle Brown',\n    sandybrown: 'Sandy Brown',\n    seagreen: 'Sea Green',\n    skyblue: 'Sky Blue',\n    slateblue: 'Slate Blue',\n    slategray: 'Slate Gray',\n    slategrey: 'Slate Grey',\n    springgreen: 'Spring Green',\n    steelblue: 'Steel Blue',\n    whitesmoke: 'White Smoke',\n    yellowgreen: 'Yellow Green',\n  };\n\n  const lowerName = name.toLowerCase();\n  if (specialCases[lowerName]) {\n    return specialCases[lowerName];\n  }\n\n  // Default: just capitalize first letter\n  return name.charAt(0).toUpperCase() + name.slice(1);\n}\n\n/**\n * Get the closest CSS color name for a hex color\n */\nexport function getColorName(hex: string): string {\n  try {\n    const color = new Color(hex);\n    const oklch = color.to('oklch');\n    const hue = oklch.coords[2] || 0;\n\n    if (hue < 30 || hue >= 330) return 'Red';\n    if (hue < 60) return 'Orange';\n    if (hue < 90) return 'Yellow';\n    if (hue < 150) return 'Green';\n    if (hue < 210) return 'Cyan';\n    if (hue < 270) return 'Blue';\n    if (hue < 330) return 'Purple';\n    return 'Unknown';\n  } catch {\n    return 'Unknown';\n  }\n}\n\n/**\n * Get color name with hue value\n */\nexport function getColorNameWithHue(hex: string): string {\n  try {\n    const color = new Color(hex);\n    const oklch = color.to('oklch');\n    const hue = oklch.coords[2] || 0;\n    const roundedHue = Math.round(hue / 10) * 10;\n    const name = getColorName(hex);\n    return `${name} ${roundedHue}`;\n  } catch {\n    return 'Unknown';\n  }\n}\n\n// Color harmony definitions\nexport const HARMONY_TYPES = [\n  'single',\n  'analogous',\n  'triad',\n  'complementary',\n  'split-complementary',\n  'square',\n  'compound',\n] as const;\nexport type HarmonyType = (typeof HARMONY_TYPES)[number];\n\nexport interface HarmonyDefinition {\n  label: string;\n  offsets: number[];\n  primaryIndex: number;\n}\n\nexport const HARMONY_DEFINITIONS: Record<HarmonyType, HarmonyDefinition> = {\n  single: {\n    label: 'Single',\n    offsets: [0],\n    primaryIndex: 0,\n  },\n  analogous: {\n    label: 'Analogous',\n    offsets: [-30, 0, 30],\n    primaryIndex: 1,\n  },\n  triad: {\n    label: 'Triad',\n    offsets: [0, 120, 240],\n    primaryIndex: 0,\n  },\n  complementary: {\n    label: 'Complementary',\n    offsets: [0, 180],\n    primaryIndex: 0,\n  },\n  'split-complementary': {\n    label: 'Split Complementary',\n    offsets: [0, 150, 210],\n    primaryIndex: 0,\n  },\n  square: {\n    label: 'Square',\n    offsets: [0, 90, 180, 270],\n    primaryIndex: 0,\n  },\n  compound: {\n    label: 'Compound',\n    offsets: [-30, 0, 180, 210],\n    primaryIndex: 1,\n  },\n};\n\n/**\n * The shared lightness ladder every ramp is built on (lightest → darkest).\n *\n * Fixed, NOT seed-derived. Two hues at the same step have to read equally light,\n * otherwise one contrast table cannot serve every hue and a `muted` variant means\n * something different depending on which role you ask. Only chroma and hue vary\n * between ramps.\n *\n * The previous engine transposed this curve onto each seed, which let relative\n * luminance at step 300 range from 0.253 (rust) to 0.384 (amber) across the\n * shipped palette — the drift this replaces.\n *\n * Anchored steps are the one deliberate exception: see `generateOklchPalette`.\n */\nexport const LIGHTNESS_LADDER: Record<StepName, number> = {\n  50: 0.98,\n  100: 0.95,\n  200: 0.9,\n  300: 0.83,\n  400: 0.74,\n  500: 0.65,\n  600: 0.54,\n  700: 0.47,\n  800: 0.38,\n  900: 0.29,\n  950: 0.21,\n};\n\n/**\n * Chroma a ramp decays to beyond its outermost anchors, so the near-white and\n * near-black ends keep a whisper of the hue instead of going flat grey. The dark\n * end carries slightly more because chroma reads weaker against black.\n */\nexport const ENDPOINT_CHROMA = { light: 0.008, dark: 0.015 } as const;\n\ninterface OklchColor {\n  l: number;\n  c: number;\n  h: number;\n}\n\n/**\n * Parses an OKLCH CSS string into numerical components.\n * @param oklchString - e.g., 'oklch(50% 0.15 270)'\n * @returns Lightness (0-1), Chroma (0-~0.37), Hue (0-360)\n */\nexport function parseOklch(oklchString: string): OklchColor {\n  const parts = oklchString.match(/oklch\\(([^ ]+) ([^ ]+) ([^ ]+)\\)/);\n  if (!parts) throw new Error('Invalid OKLCH string format.');\n\n  const [, lRaw = '', cRaw = '', hRaw = ''] = parts;\n  const l = parseFloat(lRaw) / (lRaw.includes('%') ? 100 : 1);\n  const c = parseFloat(cRaw);\n  const h = parseFloat(hRaw);\n\n  return { l, c, h };\n}\n\n/**\n * Linearly interpolates a value between a start and end point.\n */\nfunction lerp(start: number, end: number, factor: number): number {\n  return start + factor * (end - start);\n}\n\n/**\n * Interpolate hue the short way round the wheel. A ramp anchored at 350° and 10°\n * spans 20°, not 340° — the naive lerp sent it the long way through cyan.\n */\nfunction lerpHue(start: number, end: number, factor: number): number {\n  const delta = ((((end - start) % 360) + 540) % 360) - 180;\n  return (start + delta * factor + 360) % 360;\n}\n\n/**\n * The ladder step whose lightness is closest to `lightness` — i.e. where a\n * supplied colour naturally belongs.\n */\nexport function assignStepByLightness(lightness: number): StepName {\n  let closestStep: StepName = 500;\n  let minDiff = Math.abs(lightness - LIGHTNESS_LADDER[500]);\n\n  for (const step of STEP_NAMES) {\n    const diff = Math.abs(lightness - LIGHTNESS_LADDER[step]);\n    if (diff < minDiff) {\n      minDiff = diff;\n      closestStep = step;\n    }\n  }\n\n  return closestStep;\n}\n\n/**\n * How far an anchored colour sits from its step's ladder lightness.\n *\n * The generator surfaces this as a warning: a large deviation is legal (the\n * caller asked for that exact colour) but it means the hue will read heavier or\n * lighter than its siblings at that step, which is worth knowing rather than\n * discovering later.\n */\nexport function ladderDeviation(step: StepName, lightness: number): number {\n  return lightness - LIGHTNESS_LADDER[step];\n}\n\n/** Absolute chroma ceiling — beyond this nothing survives gamut mapping anyway. */\nconst MAX_CHROMA = 0.37;\n\n/**\n * Build a complete 11-step OKLCH ramp from one or more anchor colours.\n *\n * **Ladder-first with exact anchors.** Every anchor is reproduced *verbatim* at\n * its step; every other step takes its lightness from `LIGHTNESS_LADDER`, with\n * chroma and hue interpolated between the flanking anchors and decayed toward\n * `ENDPOINT_CHROMA` beyond the outermost ones.\n *\n * The consequence is the point: a client's brand hex survives byte-for-byte,\n * while the other ten steps stay directly comparable to every other hue. The\n * deviation from the ladder is bounded and *local to anchored steps* — unlike\n * the previous engine, which warped the whole ramp to fit its anchors so every\n * step drifted.\n *\n * Chroma may come out beyond the sRGB gamut here; that is deliberate.\n * `oklchStringToHex` gamut-maps with the CSS algorithm, which reduces chroma\n * while holding lightness, so the ladder survives the conversion.\n */\nexport function generateOklchPalette(\n  input: string | string[] | Record<string, string>,\n): Record<StepName, string> {\n  let anchors: Record<number, string> = {};\n\n  if (typeof input === 'string') {\n    anchors[assignStepByLightness(parseOklch(input).l)] = input;\n  } else if (Array.isArray(input)) {\n    for (const colorStr of input) {\n      anchors[assignStepByLightness(parseOklch(colorStr).l)] = colorStr;\n    }\n  } else if (typeof input === 'object' && input !== null) {\n    anchors = { ...input };\n  } else {\n    throw new Error(\n      'Input must be a color string, array of colors, or object with step assignments',\n    );\n  }\n\n  const parsedAnchors: Record<number, OklchColor> = {};\n  for (const [key, value] of Object.entries(anchors)) {\n    parsedAnchors[Number(key)] = parseOklch(value);\n  }\n\n  const anchorSteps = Object.keys(parsedAnchors)\n    .map(Number)\n    .sort((a, b) => a - b) as StepName[];\n\n  // Interpolate across step *index*, not the numeric label: the labels aren't\n  // evenly spaced (50→100 is a smaller jump than 100→200), so lerping on them\n  // would bunch the ramp up at the light end.\n  const idx = (step: number) => STEP_NAMES.indexOf(step as StepName);\n  const lastIdx = STEP_NAMES.length - 1;\n\n  const palette: Record<number, string> = {};\n\n  for (const step of STEP_NAMES) {\n    // An anchor is the caller's exact colour. Emit it untouched.\n    if (parsedAnchors[step]) {\n      palette[step] = anchors[step] as string;\n      continue;\n    }\n\n    // `lighter` is the nearest anchor with a smaller step (50 is lightest);\n    // `darker` the nearest with a larger one.\n    const lighter = [...anchorSteps].reverse().find((s) => s < step);\n    const darker = anchorSteps.find((s) => s > step);\n\n    let chroma: number;\n    let hue: number;\n\n    if (lighter !== undefined && darker !== undefined) {\n      const a = parsedAnchors[lighter] as OklchColor;\n      const b = parsedAnchors[darker] as OklchColor;\n      const factor = (idx(step) - idx(lighter)) / (idx(darker) - idx(lighter));\n      chroma = lerp(a.c, b.c, factor);\n      hue = lerpHue(a.h, b.h, factor);\n    } else if (lighter !== undefined) {\n      // Past the darkest anchor — fade toward the tinted near-black end.\n      const a = parsedAnchors[lighter] as OklchColor;\n      const factor = (idx(step) - idx(lighter)) / (lastIdx - idx(lighter));\n      chroma = lerp(a.c, ENDPOINT_CHROMA.dark, factor);\n      hue = a.h;\n    } else if (darker !== undefined) {\n      // Past the lightest anchor — fade toward the tinted near-white end.\n      const b = parsedAnchors[darker] as OklchColor;\n      const factor = (idx(darker) - idx(step)) / idx(darker);\n      chroma = lerp(b.c, ENDPOINT_CHROMA.light, factor);\n      hue = b.h;\n    } else {\n      chroma = 0.1;\n      hue = 0;\n    }\n\n    const lightness = LIGHTNESS_LADDER[step];\n    const finalL = (lightness * 100).toFixed(2) + '%';\n    const finalC = Math.min(chroma, MAX_CHROMA).toFixed(4);\n    const finalH = hue.toFixed(2);\n\n    palette[step] = `oklch(${finalL} ${finalC} ${finalH})`;\n  }\n\n  return palette;\n}\n\n// ── Contrast + endpoints (for the functional-token layer) ────────────────────\n\n/** APCA lightness-contrast (Lc) magnitude between a foreground and background. */\nexport function contrastLc(fg: string, bg: string): number {\n  return Math.abs(new Color(bg).contrast(fg, 'APCA'));\n}\n\n/**\n * Pick a tinted near-white or near-black foreground for best contrast on `bg`\n * (a whisper of the background's hue mixed into off-white/off-black).\n */\nexport function pickOn(bg: string, hue?: number): string {\n  const h = hue ?? hexToOklch(bg).h;\n  const white = oklchToHex({ l: 0.98, c: 0.01, h });\n  const black = oklchToHex({ l: 0.16, c: 0.02, h });\n  return contrastLc(white, bg) >= contrastLc(black, bg) ? white : black;\n}\n\n/**\n * The tinted off-white / off-black endpoints for a hue — white/black with a\n * whisper of the hue mixed in. These are the text/background tints every ramp\n * needs (and the one exception strict brand kits allow).\n *\n * Derived from `LIGHTNESS_LADDER` and `ENDPOINT_CHROMA` rather than its own\n * literals, so a strict tone kit's endpoints land on the same ladder rungs a\n * generated ramp would have used. This is the single definition — callers must\n * not hand-write their own near-white/near-black.\n */\nexport function tintedEndpoints(hue: number, chroma?: number): { light: string; dark: string } {\n  return {\n    light: oklchToHex({\n      l: LIGHTNESS_LADDER[50],\n      c: Math.min(chroma ?? ENDPOINT_CHROMA.light, 0.02),\n      h: hue,\n    }),\n    dark: oklchToHex({\n      l: LIGHTNESS_LADDER[950],\n      c: Math.min((chroma ?? ENDPOINT_CHROMA.dark) * 1.5, 0.03),\n      h: hue,\n    }),\n  };\n}\n","/**\n * Color harmony strategies for generating complementary colors\n */\n\nexport type HarmonyStrategy =\n  | 'complement'\n  | 'analogous-plus'\n  | 'analogous-minus'\n  | 'triadic-plus'\n  | 'triadic-minus'\n  | 'split-plus'\n  | 'split-minus'\n  | 'tetradic-plus'\n  | 'tetradic-minus';\n\nexport interface HarmonyOption {\n  id: HarmonyStrategy;\n  label: string;\n  description: string;\n  hueShift: number;\n}\n\nexport const HARMONY_STRATEGIES: HarmonyOption[] = [\n  {\n    id: 'complement',\n    label: 'Complement',\n    description: 'Opposite on color wheel (high contrast)',\n    hueShift: 180,\n  },\n  {\n    id: 'analogous-plus',\n    label: 'Analogous+',\n    description: 'Adjacent colors (harmonious)',\n    hueShift: 30,\n  },\n  {\n    id: 'analogous-minus',\n    label: 'Analogous-',\n    description: 'Adjacent colors (harmonious)',\n    hueShift: -30,\n  },\n  {\n    id: 'triadic-plus',\n    label: 'Triadic+',\n    description: 'Evenly spaced (balanced)',\n    hueShift: 120,\n  },\n  {\n    id: 'triadic-minus',\n    label: 'Triadic-',\n    description: 'Evenly spaced (balanced)',\n    hueShift: -120,\n  },\n  {\n    id: 'split-plus',\n    label: 'Split Complement+',\n    description: 'Near opposite (softer contrast)',\n    hueShift: 150,\n  },\n  {\n    id: 'split-minus',\n    label: 'Split Complement-',\n    description: 'Near opposite (softer contrast)',\n    hueShift: -150,\n  },\n  {\n    id: 'tetradic-plus',\n    label: 'Tetradic+',\n    description: 'Square spacing (rich palette)',\n    hueShift: 90,\n  },\n  {\n    id: 'tetradic-minus',\n    label: 'Tetradic-',\n    description: 'Square spacing (rich palette)',\n    hueShift: -90,\n  },\n];\n\n/**\n * Applies a harmony strategy to a hue value\n */\nexport function applyHarmonyStrategy(baseHue: number, strategy: HarmonyStrategy): number {\n  const harmonyOption = HARMONY_STRATEGIES.find((h) => h.id === strategy);\n  if (!harmonyOption) return baseHue;\n\n  let newHue = baseHue + harmonyOption.hueShift;\n\n  // Normalize to 0-360 range\n  while (newHue < 0) newHue += 360;\n  while (newHue >= 360) newHue -= 360;\n\n  return newHue;\n}\n\n/**\n * Gets all harmony suggestions for a given base hue\n */\nexport function getHarmonySuggestions(\n  baseHue: number,\n): Array<{ strategy: HarmonyStrategy; hue: number; label: string; description: string }> {\n  return HARMONY_STRATEGIES.map((strategy) => ({\n    strategy: strategy.id,\n    hue: applyHarmonyStrategy(baseHue, strategy.id),\n    label: strategy.label,\n    description: strategy.description,\n  }));\n}\n\n/**\n * Default functional color hues (if user doesn't specify)\n */\nexport const DEFAULT_FUNCTIONAL_HUES = {\n  success: 142, // Green\n  warning: 38, // Orange/Amber\n  error: 0, // Red\n  info: 200, // Blue\n} as const;\n\n/**\n * Suggests a functional color hue based on existing palette to maintain harmony\n */\nexport function suggestFunctionalColorHue(\n  type: keyof typeof DEFAULT_FUNCTIONAL_HUES,\n  existingHues: number[],\n): number {\n  const defaultHue = DEFAULT_FUNCTIONAL_HUES[type];\n\n  if (existingHues.length === 0) {\n    return defaultHue;\n  }\n\n  // Find the closest existing hue and adjust slightly to maintain harmony\n  const avgHue = existingHues.reduce((sum, h) => sum + h, 0) / existingHues.length;\n\n  // Rotate the default hue to be more in line with the palette's color temperature\n  const hueShift = avgHue - 200; // Assuming 200 is neutral blue\n  let adjustedHue = defaultHue + hueShift * 0.3; // 30% influence\n\n  // Normalize\n  while (adjustedHue < 0) adjustedHue += 360;\n  while (adjustedHue >= 360) adjustedHue -= 360;\n\n  return adjustedHue;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getvitops/utils",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "Shared build-time utilities for the Vitops toolchain — favicon generation and friends.",
   "license": "MIT",
   "files": [