@newtonedev/colors 0.0.1

package/README.md

@@ -0,0 +1,167 @@
+# newtone-colors
+
+Pure TypeScript OKLCH color toolkit. Zero dependencies.
+
+Produces accessible, perceptually uniform color scales from declarative parameters. Every output is guaranteed in-gamut — no fallbacks, no clamping after the fact.
+
+---
+
+## Core concepts
+
+All colors are in **OKLCH** — a perceptually uniform cylindrical space:
+
+| Channel | Range | Meaning |
+|---|---|---|
+| `L` | 0–1 | Lightness (0 = black, 1 = white) |
+| `C` | 0–~0.37 | Chroma (0 = achromatic) |
+| `h` | 0–360° | Hue angle |
+
+---
+
+## Scale generation
+
+The primary output is `generateScale` — a discretized OKLCH curve from lightest to darkest, with chroma at each step proportional to the gamut boundary:
+
+```ts
+import { generateScale, oklchToHex } from "newtone-colors";
+
+const scale = generateScale({ hue: 264, steps: 11 });
+const hexValues = scale.map(oklchToHex);
+```
+
+### ScaleOptions
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `hue` | `number` | — | Hue angle in degrees (0–360) |
+| `steps` | `number` | — | Number of steps (minimum 2) |
+| `chroma.value` | `number` | `1` | How much of the gamut to use (0–1). 0 = achromatic, 1 = maximum. |
+| `chroma.offset` | `number` | `0.5` | Where in the scale chroma peaks (0 = lightest end, 1 = darkest end). |
+| `gamut` | `"srgb" \| "display-p3"` | `"srgb"` | Target gamut for chroma boundary. |
+| `lightest` | `number` | `1` | Lightness of the lightest step. |
+| `darkest` | `number` | `0` | Lightness of the darkest step. |
+| `grading` | `Grading` | — | Global hue grading shared across all palettes. |
+| `gradient` | `Gradient` | — | Per-palette one-sided hue grade. |
+
+---
+
+## Key color workflow
+
+Derive scale parameters from a brand color, then locate it in the generated scale:
+
+```ts
+import { keyColor, generateScale, findNearest, oklchToHex } from "newtone-colors";
+
+const key = keyColor("#3B82F6", { gamut: "srgb", lightest: 0.96, darkest: 0.16 });
+const scale = generateScale({ ...key, steps: 11 });
+const { index } = findNearest(key.resolved.oklch, scale);
+
+// scale[index] is the step closest to the original color
+console.log(oklchToHex(scale[index]));
+```
+
+`keyColor` derives `hue` and `chroma` (value + offset) from the color and returns them ready to spread into `ScaleOptions`. The `chroma.offset` is computed from where the color's lightness falls within the scale range, so the chroma peak aligns with the key color's position.
+
+The reverse direction — step to hex — is already covered by `oklchToHex(scale[index])`.
+
+---
+
+## Hue grading
+
+Shift hues at the light or dark end of the scale toward a target hue, using vector interpolation in OKLAB (no shortest-arc discontinuity at 180°):
+
+```ts
+import { generateScale } from "newtone-colors";
+import type { Grading, Gradient } from "newtone-colors";
+
+// Global: affects all palettes equally
+const grading: Grading = {
+  lightHue: 145,  lightValue: 0.15,  // light end shifts toward 145°
+  darkHue: 25,    darkValue: 0.15,   // dark end shifts toward 25°
+};
+
+// Per-palette: one-sided, stronger
+const gradient: Gradient = {
+  hue: 200,
+  value: 0.3,
+  direction: "dark",  // only affects the dark end
+};
+
+const scale = generateScale({ hue: 264, steps: 11, grading, gradient });
+```
+
+---
+
+## Dynamic range
+
+Map slider values (0–1) to lightness bounds. The defaults keep the scale away from blinding white and unusable black:
+
+```ts
+import { resolveLightest, resolveDarkest } from "newtone-colors";
+
+const lightest = resolveLightest(0);  // → 0.96 (MIN_LIGHTEST_L)
+const darkest  = resolveDarkest(0);   // → 0.16 (MAX_DARKEST_L)
+
+const scale = generateScale({ hue: 264, steps: 11, lightest, darkest });
+```
+
+See [docs/constants.md](docs/constants.md) for all hardcoded values and their rationale.
+
+---
+
+## Gamut utilities
+
+```ts
+import { isInGamut, gamutMap, maxChroma, oklchToSrgb } from "newtone-colors";
+
+const rgb = oklchToSrgb({ L: 0.7, C: 0.2, h: 264 });
+isInGamut(rgb);                          // true/false
+gamutMap({ L: 0.7, C: 0.3, h: 264 }, "srgb");   // → in-gamut Oklch
+maxChroma(0.6, 264, "srgb");             // → max C at this L/h
+```
+
+---
+
+## Contrast
+
+```ts
+import { wcagContrast, apcaContrast, contrastTextHex } from "newtone-colors";
+import type { Srgb } from "newtone-colors";
+
+const bg: Srgb = { r: 0.1, g: 0.1, b: 0.5 };
+const fg: Srgb = { r: 1, g: 1, b: 1 };
+
+wcagContrast(bg, fg);     // WCAG 2.x contrast ratio
+apcaContrast(bg, fg);     // APCA-W3 Lc value
+contrastTextHex(bg);      // "#000000" or "#ffffff", whichever has better contrast
+```
+
+---
+
+## Color resolution
+
+Resolve any hex or OKLCH input to scale-ready parameters, with automatic gamut mapping if needed:
+
+```ts
+import { resolveColor } from "newtone-colors";
+
+const result = resolveColor("#E74C3C", "srgb");
+result.hue;          // extracted hue
+result.chromaRatio;  // chroma as fraction of gamut boundary → ScaleOptions.chroma.value
+result.wasRemapped;  // true if the color was outside the target gamut
+result.original;     // original OKLCH before mapping
+```
+
+---
+
+## Color math
+
+```ts
+import { deltaEOK, mix } from "newtone-colors";
+
+// Perceptual distance (Euclidean in OKLAB)
+deltaEOK(colorA, colorB);
+
+// Interpolate between two OKLCH colors (shortest-arc hue)
+mix(colorA, colorB, 0.5);
+```

package/dist/__tests__/contrast.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contrast.test.d.ts.map

package/dist/__tests__/contrast.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/contrast.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/conversions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=conversions.test.d.ts.map

package/dist/__tests__/conversions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversions.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/conversions.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/difference.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=difference.test.d.ts.map

package/dist/__tests__/difference.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"difference.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/difference.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/dynamic-range.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dynamic-range.test.d.ts.map

package/dist/__tests__/dynamic-range.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-range.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/dynamic-range.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/gamut.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gamut.test.d.ts.map

package/dist/__tests__/gamut.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gamut.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/gamut.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/hue-grade.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hue-grade.test.d.ts.map

package/dist/__tests__/hue-grade.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hue-grade.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/hue-grade.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=integration.test.d.ts.map

package/dist/__tests__/integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/integration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/interpolation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interpolation.test.d.ts.map

package/dist/__tests__/interpolation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/interpolation.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/resolve-color.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolve-color.test.d.ts.map

package/dist/__tests__/resolve-color.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-color.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/resolve-color.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/scale.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scale.test.d.ts.map

package/dist/__tests__/scale.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/scale.test.ts"],"names":[],"mappings":""}

package/dist/color/difference.d.ts

@@ -0,0 +1,6 @@
+import type { Oklab, Oklch } from "../types.js";
+/** Compute deltaEOK (Euclidean distance in OKLAB) between two OKLCH colors. */
+export declare function deltaEOK(a: Oklch, b: Oklch): number;
+/** Compute deltaEOK directly from OKLAB values. */
+export declare function deltaEOKLab(a: Oklab, b: Oklab): number;
+//# sourceMappingURL=difference.d.ts.map

package/dist/color/difference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"difference.d.ts","sourceRoot":"","sources":["../../src/color/difference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGhD,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAEnD;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAKtD"}

package/dist/color/interpolation.d.ts

@@ -0,0 +1,10 @@
+import type { Oklch } from "../types.js";
+/**
+ * Linearly interpolate between two OKLCH colors.
+ *
+ * L and C are linearly interpolated. Hue uses shortest-arc interpolation.
+ * Achromatic colors (C near zero) inherit the other color's hue to avoid
+ * meaningless hue sweeps through the achromatic pole.
+ */
+export declare function mix(a: Oklch, b: Oklch, t: number): Oklch;
+//# sourceMappingURL=interpolation.d.ts.map

package/dist/color/interpolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolation.d.ts","sourceRoot":"","sources":["../../src/color/interpolation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAyBxD"}

package/dist/config.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Design constants — the values you tune by hand.
+ *
+ * Edit this file to adjust the perceptual behavior of every scale and
+ * grading operation across the library.
+ */
+/**
+ * Lightest step's lightness when the whites slider is at 0.
+ * slider 0 → L = MIN_LIGHTEST_L, slider 1 → L = 1.0 (pure white).
+ */
+export declare const MIN_LIGHTEST_L = 0.96;
+/**
+ * Darkest step's lightness when the darks slider is at 0.
+ * slider 0 → L = MAX_DARKEST_L, slider 1 → L = 0.0 (pure black).
+ */
+export declare const MAX_DARKEST_L = 0.16;
+/**
+ * How far a global grade reaches into the scale from each end (0–1).
+ * Light grading fades to zero at t = GRADE_REACH.
+ * Dark grading fades to zero at t = 1 − GRADE_REACH.
+ */
+export declare const GRADE_REACH: number;
+/** Maximum blend intensity for global grading. Inputs above this are clamped. */
+export declare const MAX_GRADE_INTENSITY = 0.25;
+/**
+ * How far a local (per-palette) grade reaches into the scale from each end (0–1).
+ * Slightly wider than GRADE_REACH to give per-palette grading more room.
+ */
+export declare const LOCAL_GRADE_REACH: number;
+/** Maximum blend intensity for local grading. Inputs above this are clamped. */
+export declare const MAX_LOCAL_GRADE_INTENSITY = 0.5;
+/**
+ * Just-noticeable difference threshold (deltaEOK).
+ * Colors with distance below this are considered perceptually identical.
+ * Used to classify color matches as exact vs. fallback.
+ */
+export declare const PERCEPTUAL_JND = 0.02;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,aAAa,OAAO,CAAC;AAIlC;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAI7C;;;;GAIG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,39 @@
+export declare const SRGB_GAMMA_THRESHOLD = 0.04045;
+export declare const SRGB_GAMMA_THRESHOLD_LINEAR = 0.0031308;
+export declare const SRGB_GAMMA_SLOPE = 12.92;
+export declare const SRGB_GAMMA_EXPONENT = 2.4;
+export declare const SRGB_GAMMA_OFFSET = 0.055;
+export declare const SRGB_GAMMA_SCALE = 1.055;
+export declare const LINEAR_SRGB_TO_LMS: readonly [readonly [0.4122214708, 0.5363325363, 0.0514459929], readonly [0.2119034982, 0.6806995451, 0.1073969566], readonly [0.0883024619, 0.2817188376, 0.6299787005]];
+export declare const LMS_PRIME_TO_OKLAB: readonly [readonly [0.2104542553, 0.793617785, -0.0040720468], readonly [1.9779984951, -2.428592205, 0.4505937099], readonly [0.0259040371, 0.7827717662, -0.808675766]];
+export declare const OKLAB_TO_LMS_PRIME: readonly [readonly [1, 0.3963377774, 0.2158037573], readonly [1, -0.1055613458, -0.0638541728], readonly [1, -0.0894841775, -1.291485548]];
+export declare const LMS_TO_LINEAR_SRGB: readonly [readonly [4.0767416621, -3.3077115913, 0.2309699292], readonly [-1.2684380046, 2.6097574011, -0.3413193965], readonly [-0.0041960863, -0.7034186147, 1.707614701]];
+export declare const LINEAR_P3_TO_LMS: readonly [readonly [0.4813791595, 0.4621155872, 0.0565406381], readonly [0.2288319169, 0.6532167007, 0.1179528072], readonly [0.0839457149, 0.2241651052, 0.6918912614]];
+export declare const LMS_TO_LINEAR_P3: readonly [readonly [3.127769439, -2.2570600176, 0.1291828502], readonly [-1.0910091977, 2.4133065499, -0.3222615148], readonly [-0.0260108068, -0.5080402362, 1.5340494942]];
+export declare const GAMUT_EPSILON = 0.000001;
+export declare const GAMUT_MAP_JND = 0.02;
+export declare const GAMUT_MAP_EPSILON = 0.0001;
+export declare const GAMUT_MAP_MAX_ITERATIONS = 50;
+export declare const ACHROMATIC_THRESHOLD = 1e-10;
+export declare const WCAG_R = 0.2126;
+export declare const WCAG_G = 0.7152;
+export declare const WCAG_B = 0.0722;
+export declare const APCA_MAIN_TRC = 2.4;
+export declare const APCA_SRGB_R = 0.2126729;
+export declare const APCA_SRGB_G = 0.7151522;
+export declare const APCA_SRGB_B = 0.072175;
+export declare const APCA_NORM_BG = 0.56;
+export declare const APCA_NORM_TXT = 0.57;
+export declare const APCA_REV_TXT = 0.62;
+export declare const APCA_REV_BG = 0.65;
+export declare const APCA_BLK_THRS = 0.022;
+export declare const APCA_BLK_CLMP = 1.414;
+export declare const APCA_SCALE_BOW = 1.14;
+export declare const APCA_SCALE_WOB = 1.14;
+export declare const APCA_LO_BOW_OFFSET = 0.027;
+export declare const APCA_LO_WOB_OFFSET = 0.027;
+export declare const APCA_DELTA_Y_MIN = 0.0005;
+export declare const APCA_LO_CLIP = 0.1;
+export declare const DEG_TO_RAD: number;
+export declare const RAD_TO_DEG: number;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAC5C,eAAO,MAAM,2BAA2B,YAAY,CAAC;AACrD,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AACvC,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAItC,eAAO,MAAM,kBAAkB,0KAIrB,CAAC;AAIX,eAAO,MAAM,kBAAkB,0KAIrB,CAAC;AAIX,eAAO,MAAM,kBAAkB,4IAIrB,CAAC;AAIX,eAAO,MAAM,kBAAkB,8KAIrB,CAAC;AAKX,eAAO,MAAM,gBAAgB,0KAInB,CAAC;AAIX,eAAO,MAAM,gBAAgB,8KAInB,CAAC;AAIX,eAAO,MAAM,aAAa,WAAO,CAAC;AAClC,eAAO,MAAM,aAAa,OAAO,CAAC;AAClC,eAAO,MAAM,iBAAiB,SAAO,CAAC;AACtC,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAI3C,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAI1C,eAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,eAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,eAAO,MAAM,MAAM,SAAS,CAAC;AAI7B,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,WAAW,YAAY,CAAC;AACrC,eAAO,MAAM,WAAW,YAAY,CAAC;AACrC,eAAO,MAAM,WAAW,WAAY,CAAC;AACrC,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,aAAa,OAAO,CAAC;AAClC,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,WAAW,OAAO,CAAC;AAChC,eAAO,MAAM,aAAa,QAAQ,CAAC;AACnC,eAAO,MAAM,aAAa,QAAQ,CAAC;AACnC,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,eAAO,MAAM,YAAY,MAAM,CAAC;AAIhC,eAAO,MAAM,UAAU,QAAgB,CAAC;AACxC,eAAO,MAAM,UAAU,QAAgB,CAAC"}

package/dist/contrast/apca.d.ts

@@ -0,0 +1,14 @@
+import type { Srgb } from "../types.js";
+/**
+ * Compute APCA-W3 Lc (Lightness Contrast) between text and background.
+ *
+ * Returns a signed value in roughly [-108, +106]:
+ *   Positive = dark text on light background (BoW)
+ *   Negative = light text on dark background (WoB)
+ *   0 = no meaningful contrast
+ *
+ * IMPORTANT: Uses its own linearization (simple 2.4 gamma),
+ * NOT the IEC piecewise sRGB transfer function.
+ */
+export declare function apcaContrast(textColor: Srgb, bgColor: Srgb): number;
+//# sourceMappingURL=apca.d.ts.map

package/dist/contrast/apca.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apca.d.ts","sourceRoot":"","sources":["../../src/contrast/apca.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAoBxC;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,MAAM,CAmCnE"}

package/dist/contrast/index.d.ts

@@ -0,0 +1,3 @@
+export { wcagLuminance, wcagContrast } from "./wcag.js";
+export { apcaContrast } from "./apca.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/contrast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contrast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/contrast/wcag.d.ts

@@ -0,0 +1,14 @@
+import type { Srgb } from "../types.js";
+/** Compute WCAG 2.x relative luminance [0, 1] from an sRGB color. */
+export declare function wcagLuminance(color: Srgb): number;
+/**
+ * Compute WCAG 2.x contrast ratio between two sRGB colors.
+ * Returns a value in [1, 21]. Symmetric (order doesn't matter).
+ */
+export declare function wcagContrast(a: Srgb, b: Srgb): number;
+/**
+ * Choose black or white text for maximum WCAG contrast against a background.
+ * @returns `"#000000"` or `"#ffffff"`.
+ */
+export declare function contrastTextHex(background: Srgb): "#000000" | "#ffffff";
+//# sourceMappingURL=wcag.d.ts.map

package/dist/contrast/wcag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wcag.d.ts","sourceRoot":"","sources":["../../src/contrast/wcag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAIxC,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAMjD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAMrD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,CAMvE"}

package/dist/conversions/hex.d.ts

@@ -0,0 +1,6 @@
+import type { Hex, Srgb } from "../types.js";
+/** Parse a hex color string (#RGB, #RRGGBB, or bare) to sRGB [0,1]. */
+export declare function hexToSrgb(hex: string): Srgb;
+/** Convert sRGB [0,1] to lowercase hex string (#rrggbb). Clamps to [0,1]. */
+export declare function srgbToHex(color: Srgb): Hex;
+//# sourceMappingURL=hex.d.ts.map

package/dist/conversions/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/conversions/hex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAE7C,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAa3C;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,GAAG,CAK1C"}

package/dist/conversions/index.d.ts

@@ -0,0 +1,7 @@
+export { oklabToOklch, oklchToOklab } from "./oklab.js";
+export { linearSrgbToOklab, oklabToLinearSrgb } from "./linear-srgb.js";
+export { srgbToLinearSrgb, linearSrgbToSrgb, srgbChannelToLinear, linearChannelToSrgb, } from "./srgb.js";
+export { hexToSrgb, srgbToHex } from "./hex.js";
+export { srgbToOklch, oklchToSrgb, srgbToOklab, oklabToSrgb, hexToOklch, oklchToHex, p3ToOklch, oklchToP3, } from "./pipeline.js";
+export { linearP3ToOklab, oklabToLinearP3 } from "./linear-p3.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/conversions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,GACV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/conversions/linear-p3.d.ts

@@ -0,0 +1,6 @@
+import type { LinearSrgb, Oklab } from "../types.js";
+/** Convert Linear Display P3 to OKLAB via P3-specific M1 + shared M2. */
+export declare function linearP3ToOklab(color: LinearSrgb): Oklab;
+/** Convert OKLAB to Linear Display P3 via shared inverse M2 + P3-specific inverse M1. */
+export declare function oklabToLinearP3(color: Oklab): LinearSrgb;
+//# sourceMappingURL=linear-p3.d.ts.map

package/dist/conversions/linear-p3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-p3.d.ts","sourceRoot":"","sources":["../../src/conversions/linear-p3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAQrD,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAmCxD;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAmCxD"}

package/dist/conversions/linear-srgb.d.ts

@@ -0,0 +1,6 @@
+import type { LinearSrgb, Oklab } from "../types.js";
+/** Convert Linear sRGB to OKLAB via Ottosson's direct M1/M2 matrices. */
+export declare function linearSrgbToOklab(color: LinearSrgb): Oklab;
+/** Convert OKLAB to Linear sRGB via inverse M2/M1 matrices. */
+export declare function oklabToLinearSrgb(color: Oklab): LinearSrgb;
+//# sourceMappingURL=linear-srgb.d.ts.map

package/dist/conversions/linear-srgb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-srgb.d.ts","sourceRoot":"","sources":["../../src/conversions/linear-srgb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAQrD,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAmC1D;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAmC1D"}

package/dist/conversions/oklab.d.ts

@@ -0,0 +1,6 @@
+import type { Oklab, Oklch } from "../types.js";
+/** Convert OKLAB (cartesian) to OKLCH (cylindrical). Achromatic colors get h=0. */
+export declare function oklabToOklch(lab: Oklab): Oklch;
+/** Convert OKLCH (cylindrical) to OKLAB (cartesian). */
+export declare function oklchToOklab(lch: Oklch): Oklab;
+//# sourceMappingURL=oklab.d.ts.map

package/dist/conversions/oklab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oklab.d.ts","sourceRoot":"","sources":["../../src/conversions/oklab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGhD,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,GAAG,EAAE,KAAK,GAAG,KAAK,CAW9C;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,GAAG,EAAE,KAAK,GAAG,KAAK,CAO9C"}

package/dist/conversions/pipeline.d.ts

@@ -0,0 +1,18 @@
+import type { Hex, Oklab, Oklch, Srgb } from "../types.js";
+/** Convert sRGB to OKLCH. */
+export declare function srgbToOklch(color: Srgb): Oklch;
+/** Convert OKLCH to sRGB. May produce out-of-gamut values (channels outside [0,1]). */
+export declare function oklchToSrgb(color: Oklch): Srgb;
+/** Convert sRGB to OKLAB. */
+export declare function srgbToOklab(color: Srgb): Oklab;
+/** Convert OKLAB to sRGB. May produce out-of-gamut values. */
+export declare function oklabToSrgb(color: Oklab): Srgb;
+/** Convert hex to OKLCH. */
+export declare function hexToOklch(hex: string): Oklch;
+/** Convert OKLCH to hex. Clamps to sRGB gamut before hex encoding. */
+export declare function oklchToHex(color: Oklch): Hex;
+/** Convert Display P3 to OKLCH. */
+export declare function p3ToOklch(color: Srgb): Oklch;
+/** Convert OKLCH to Display P3. May produce out-of-gamut values (channels outside [0,1]). */
+export declare function oklchToP3(color: Oklch): Srgb;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/conversions/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/conversions/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAO3D,6BAA6B;AAC7B,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,KAAK,CAE9C;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAE9C;AAED,6BAA6B;AAC7B,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,KAAK,CAE9C;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAE9C;AAED,4BAA4B;AAC5B,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAE7C;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAO5C;AAED,mCAAmC;AACnC,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,KAAK,CAE5C;AAED,6FAA6F;AAC7F,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAE5C"}

package/dist/conversions/srgb.d.ts

@@ -0,0 +1,10 @@
+import type { LinearSrgb, Srgb } from "../types.js";
+/** Decode a single sRGB gamma-encoded channel to linear light. */
+export declare function srgbChannelToLinear(value: number): number;
+/** Encode a single linear light channel to sRGB gamma. */
+export declare function linearChannelToSrgb(value: number): number;
+/** Convert an sRGB color to Linear sRGB. */
+export declare function srgbToLinearSrgb(color: Srgb): LinearSrgb;
+/** Convert a Linear sRGB color to sRGB. */
+export declare function linearSrgbToSrgb(color: LinearSrgb): Srgb;
+//# sourceMappingURL=srgb.d.ts.map

package/dist/conversions/srgb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"srgb.d.ts","sourceRoot":"","sources":["../../src/conversions/srgb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAUpD,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,4CAA4C;AAC5C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,GAAG,UAAU,CAMxD;AAED,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAMxD"}

package/dist/difference.d.ts

@@ -0,0 +1,6 @@
+import type { Oklab, Oklch } from "./types.js";
+/** Compute deltaEOK (Euclidean distance in OKLAB) between two OKLCH colors. */
+export declare function deltaEOK(a: Oklch, b: Oklch): number;
+/** Compute deltaEOK directly from OKLAB values. */
+export declare function deltaEOKLab(a: Oklab, b: Oklab): number;
+//# sourceMappingURL=difference.d.ts.map

package/dist/difference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"difference.d.ts","sourceRoot":"","sources":["../src/difference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAG/C,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAEnD;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAKtD"}

package/dist/dynamic-range.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Dynamic range resolution — maps slider values (0–1) to OKLCH lightness
+ * bounds for the lightest and darkest steps of a color scale.
+ */
+/** Minimum lightness for the lightest step when slider is at 0. */
+export declare const MIN_LIGHTEST_L = 0.96;
+/** Maximum lightness for the darkest step when slider is at 0. */
+export declare const MAX_DARKEST_L = 0.16;
+/**
+ * Resolve a whites slider value (0–1) to an OKLCH lightness.
+ * slider 0 → L = MIN_LIGHTEST_L (0.96), slider 1 → L = 1.0 (pure white)
+ */
+export declare function resolveLightest(slider: number): number;
+/**
+ * Resolve a darks slider value (0–1) to an OKLCH lightness.
+ * slider 0 → L = MAX_DARKEST_L (0.16), slider 1 → L = 0.0 (pure black)
+ */
+export declare function resolveDarkest(slider: number): number;
+//# sourceMappingURL=dynamic-range.d.ts.map

package/dist/dynamic-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-range.d.ts","sourceRoot":"","sources":["../src/dynamic-range.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mEAAmE;AACnE,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,kEAAkE;AAClE,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/gamut/check.d.ts

@@ -0,0 +1,6 @@
+import type { Srgb } from "../types.js";
+/** Check if sRGB channels are within [0, 1] (with epsilon tolerance). */
+export declare function isInGamut(color: Srgb): boolean;
+/** Clamp sRGB channels to [0, 1]. */
+export declare function clampSrgb(color: Srgb): Srgb;
+//# sourceMappingURL=check.d.ts.map

package/dist/gamut/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/gamut/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAS9C;AAED,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAM3C"}

package/dist/gamut/index.d.ts

@@ -0,0 +1,4 @@
+export { isInGamut, clampSrgb } from "./check.js";
+export { gamutMap } from "./map.js";
+export { maxChroma } from "./max-chroma.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/gamut/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gamut/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/gamut/map.d.ts

@@ -0,0 +1,8 @@
+import type { Gamut, Oklch } from "../types.js";
+/**
+ * Map an OKLCH color into the target gamut using the CSS Color Level 4 algorithm.
+ * Reduces chroma at fixed L and h via binary search with deltaEOK JND check.
+ * @param gamut Target gamut (default: 'srgb').
+ */
+export declare function gamutMap(color: Oklch, gamut?: Gamut): Oklch;
+//# sourceMappingURL=map.d.ts.map

package/dist/gamut/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/gamut/map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAQ,MAAM,aAAa,CAAC;AAetD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAE,KAAc,GAAG,KAAK,CA6CnE"}

package/dist/gamut/max-chroma.d.ts

@@ -0,0 +1,8 @@
+import type { Gamut } from "../types.js";
+/**
+ * Find the maximum gamut chroma for a given OKLCH lightness and hue.
+ * Binary search on chroma [0, upperBound].
+ * @param gamut Target gamut (default: 'srgb'). P3 searches up to 0.5.
+ */
+export declare function maxChroma(L: number, h: number, gamut?: Gamut): number;
+//# sourceMappingURL=max-chroma.d.ts.map

package/dist/gamut/max-chroma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-chroma.d.ts","sourceRoot":"","sources":["../../src/gamut/max-chroma.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAS,MAAM,aAAa,CAAC;AAKhD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,KAAc,GAAG,MAAM,CAsB7E"}