@newtonedev/colors 1.1.3 → 1.1.4

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

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

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

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

package/dist/config.d.ts

@@ -17,25 +17,25 @@ export declare const DEFAULT_SCALE_STEPS = 26;
  */
 export declare const DEFAULT_HUE = 0;
 /**
- * Lightest step's lightness when the whites slider is at 0 (Display P3).
- * P3's wider gamut can reproduce near-whites that clip in sRGB.
+ * Maximum lightness for the lightest scale step (slider = 1).
+ * The brightest achievable L value.
  */
-export declare const MIN_LIGHTEST_L_P3 = 0.98;
+export declare const MAX_LIGHT = 0.98;
 /**
- * Lightest step's lightness when the whites slider is at 0 (sRGB).
- * slider 0 → L = MIN_LIGHTEST_L, slider 1 → L = 1.0 (pure white).
+ * Minimum lightness for the lightest scale step (slider = 0).
+ * The scale opens from here toward MAX_LIGHT as the whites slider increases.
  */
-export declare const MIN_LIGHTEST_L = 0.92;
+export declare const MIN_LIGHT = 0.92;
 /**
- * Darkest step's lightness when the darks slider is at 0 (sRGB).
- * slider 0 → L = MAX_DARKEST_L, slider 1 → L = 0.0 (pure black).
+ * Minimum darkness for the darkest scale step (slider = 0).
+ * The scale extends from here toward MAX_DARK as the darks slider increases.
  */
-export declare const MAX_DARKEST_L = 0.2;
+export declare const MIN_DARK = 0.2;
 /**
- * Darkest step's lightness when the darks slider is at 0 (Display P3).
- * P3's wider gamut can reproduce near-blacks that clip in sRGB.
+ * Maximum darkness for the darkest scale step (slider = 1).
+ * Lower L = darker. This is the darkest achievable value.
  */
-export declare const MAX_DARKEST_L_P3 = 0.14;
+export declare const MAX_DARK = 0.14;
 /**
  * How far global grading reaches into the scale from each end (0–1).
  * Light grading fades to zero at t = GRADING_REACH.

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAI7B;;;GAGG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,aAAa,MAAO,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAIrC;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAQ,CAAC;AAEnC,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAIpC;;;;GAIG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAO7B;;;GAGG;AACH,eAAO,MAAM,SAAS,OAAO,CAAC;AAE9B;;;GAGG;AACH,eAAO,MAAM,SAAS,OAAO,CAAC;AAE9B;;;GAGG;AACH,eAAO,MAAM,QAAQ,MAAO,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,QAAQ,OAAO,CAAC;AAI7B;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAQ,CAAC;AAEnC,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAIpC;;;;GAIG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC"}

package/dist/contrast/validate.d.ts

@@ -0,0 +1,42 @@
+import type { Srgb } from "../types.js";
+/** APCA Lc magnitude threshold for large text (≥24px or ≥18.66px bold) */
+export declare const APCA_THRESHOLD_LARGE_TEXT = 60;
+/** APCA Lc magnitude threshold for normal/body text */
+export declare const APCA_THRESHOLD_NORMAL_TEXT = 75;
+/** WCAG 2.x AA contrast ratio for normal text */
+export declare const WCAG_AA_NORMAL = 4.5;
+/** WCAG 2.x AA contrast ratio for large text (≥18pt or ≥14pt bold) */
+export declare const WCAG_AA_LARGE = 3;
+export type ContrastStandard = "apca" | "wcag";
+export interface ContrastCheckResult {
+    readonly standard: ContrastStandard;
+    /** Raw contrast value: APCA |Lc| magnitude or WCAG ratio */
+    readonly value: number;
+    /** Passes threshold for large text? */
+    readonly passesLargeText: boolean;
+    /** Passes threshold for normal/body text? */
+    readonly passesSmallText: boolean;
+}
+export interface ContrastValidation {
+    readonly apca: ContrastCheckResult;
+    readonly wcag: ContrastCheckResult;
+    /** Passes large text in BOTH standards */
+    readonly passesLargeText: boolean;
+    /** Passes normal text in BOTH standards */
+    readonly passesSmallText: boolean;
+}
+/**
+ * Validate APCA contrast between text and background.
+ * Uses |Lc| magnitude (ignores polarity) for threshold comparison.
+ */
+export declare function validateApcaContrast(textColor: Srgb, bgColor: Srgb): ContrastCheckResult;
+/**
+ * Validate WCAG 2.x AA contrast between two colors.
+ */
+export declare function validateWcagContrast(textColor: Srgb, bgColor: Srgb): ContrastCheckResult;
+/**
+ * Validate text-on-background contrast against both APCA and WCAG standards.
+ * Combined `passesLargeText`/`passesSmallText` are true only when BOTH standards pass.
+ */
+export declare function validateContrast(textColor: Srgb, bgColor: Srgb): ContrastValidation;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/contrast/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAMxC,0EAA0E;AAC1E,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,uDAAuD;AACvD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,iDAAiD;AACjD,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,sEAAsE;AACtE,eAAO,MAAM,aAAa,IAAI,CAAC;AAI/B,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,6CAA6C;IAC7C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,0CAA0C;IAC1C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,mBAAmB,CAQrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,mBAAmB,CAQrB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,kBAAkB,CASpB"}

package/dist/index.cjs

@@ -339,6 +339,40 @@ function apcaContrast(textColor, bgColor) {
   }
 }
 
+// src/contrast/validate.ts
+var APCA_THRESHOLD_LARGE_TEXT = 60;
+var APCA_THRESHOLD_NORMAL_TEXT = 75;
+var WCAG_AA_NORMAL = 4.5;
+var WCAG_AA_LARGE = 3;
+function validateApcaContrast(textColor, bgColor) {
+  const lc = Math.abs(apcaContrast(textColor, bgColor));
+  return {
+    standard: "apca",
+    value: lc,
+    passesLargeText: lc >= APCA_THRESHOLD_LARGE_TEXT,
+    passesSmallText: lc >= APCA_THRESHOLD_NORMAL_TEXT
+  };
+}
+function validateWcagContrast(textColor, bgColor) {
+  const ratio = wcagContrast(textColor, bgColor);
+  return {
+    standard: "wcag",
+    value: ratio,
+    passesLargeText: ratio >= WCAG_AA_LARGE,
+    passesSmallText: ratio >= WCAG_AA_NORMAL
+  };
+}
+function validateContrast(textColor, bgColor) {
+  const apca = validateApcaContrast(textColor, bgColor);
+  const wcag = validateWcagContrast(textColor, bgColor);
+  return {
+    apca,
+    wcag,
+    passesLargeText: apca.passesLargeText && wcag.passesLargeText,
+    passesSmallText: apca.passesSmallText && wcag.passesSmallText
+  };
+}
+
 // src/color/interpolation.ts
 function mix(a, b, t) {
   const L = a.L + (b.L - a.L) * t;
@@ -362,10 +396,10 @@ function mix(a, b, t) {
 // src/config.ts
 var DEFAULT_SCALE_STEPS = 26;
 var DEFAULT_HUE = 0;
-var MIN_LIGHTEST_L_P3 = 0.98;
-var MIN_LIGHTEST_L = 0.92;
-var MAX_DARKEST_L = 0.2;
-var MAX_DARKEST_L_P3 = 0.14;
+var MAX_LIGHT = 0.98;
+var MIN_LIGHT = 0.92;
+var MIN_DARK = 0.2;
+var MAX_DARK = 0.14;
 var GRADING_REACH = 3 / 5;
 var MAX_GRADING_AMOUNT = 0.25;
 var GRADING_CHROMA_RATIO = 0.5;
@@ -473,12 +507,10 @@ function generateScale(options = {}) {
   const localHueGrade = shift ? buildOneSidedGrade(shift.hue, shift.amount, shift.light) : void 0;
   const ratio = Math.max(0, Math.min(1, chromaRatio));
   const peak = Math.max(0, Math.min(1, chromaPeak));
-  const capLight = isP3 ? MIN_LIGHTEST_L_P3 : 1;
-  const capDark = isP3 ? MAX_DARKEST_L_P3 : 0;
   const lightSlider = Math.max(0, Math.min(1, contrast?.light ?? 1));
   const darkSlider = Math.max(0, Math.min(1, contrast?.dark ?? 1));
-  const lightestL = MIN_LIGHTEST_L + lightSlider * (capLight - MIN_LIGHTEST_L);
-  const darkestL = MAX_DARKEST_L - darkSlider * (MAX_DARKEST_L - capDark);
+  const lightestL = MIN_LIGHT + lightSlider * (MAX_LIGHT - MIN_LIGHT);
+  const darkestL = MIN_DARK - darkSlider * (MIN_DARK - MAX_DARK);
   const hueAt = (t) => resolveGradedHue(hue, t, hueGrade, localHueGrade);
   if (peak === 0.5 || ratio === 0 || ratio >= 1) {
     const scale2 = [];
@@ -582,11 +614,11 @@ function resolveColor(input, isP3 = false) {
 // src/scale/dynamic-range.ts
 function resolveLightest(slider) {
   const s = Math.max(0, Math.min(1, slider));
-  return MIN_LIGHTEST_L + s * (1 - MIN_LIGHTEST_L);
+  return MIN_LIGHT + s * (MAX_LIGHT - MIN_LIGHT);
 }
 function resolveDarkest(slider) {
   const s = Math.max(0, Math.min(1, slider));
-  return MAX_DARKEST_L * (1 - s);
+  return MIN_DARK - s * (MIN_DARK - MAX_DARK);
 }
 function lightnessToScaleT(L, lightestL, darkestL) {
   const range = lightestL - darkestL;
@@ -614,18 +646,22 @@ function keyColor(color, options) {
 }
 
 exports.APCA_LC_MAX = APCA_LC_MAX;
+exports.APCA_THRESHOLD_LARGE_TEXT = APCA_THRESHOLD_LARGE_TEXT;
+exports.APCA_THRESHOLD_NORMAL_TEXT = APCA_THRESHOLD_NORMAL_TEXT;
 exports.DEFAULT_HUE = DEFAULT_HUE;
 exports.DEFAULT_SCALE_STEPS = DEFAULT_SCALE_STEPS;
 exports.GRADING_CHROMA_RATIO = GRADING_CHROMA_RATIO;
 exports.GRADING_REACH = GRADING_REACH;
-exports.MAX_DARKEST_L = MAX_DARKEST_L;
-exports.MAX_DARKEST_L_P3 = MAX_DARKEST_L_P3;
+exports.MAX_DARK = MAX_DARK;
 exports.MAX_GRADING_AMOUNT = MAX_GRADING_AMOUNT;
+exports.MAX_LIGHT = MAX_LIGHT;
 exports.MAX_SHIFT_AMOUNT = MAX_SHIFT_AMOUNT;
-exports.MIN_LIGHTEST_L = MIN_LIGHTEST_L;
-exports.MIN_LIGHTEST_L_P3 = MIN_LIGHTEST_L_P3;
+exports.MIN_DARK = MIN_DARK;
+exports.MIN_LIGHT = MIN_LIGHT;
 exports.PERCEPTUAL_JND = PERCEPTUAL_JND;
 exports.SHIFT_REACH = SHIFT_REACH;
+exports.WCAG_AA_LARGE = WCAG_AA_LARGE;
+exports.WCAG_AA_NORMAL = WCAG_AA_NORMAL;
 exports.apcaContrast = apcaContrast;
 exports.apcaToNormalized = apcaToNormalized;
 exports.buildOneSidedGrade = buildOneSidedGrade;
@@ -660,12 +696,17 @@ exports.oklchToP3 = oklchToP3;
 exports.oklchToP3Css = oklchToP3Css;
 exports.oklchToSrgb = oklchToSrgb;
 exports.p3ToOklch = p3ToOklch;
+exports.resolveDarkest = resolveDarkest;
 exports.resolveGradedHue = resolveGradedHue;
+exports.resolveLightest = resolveLightest;
 exports.srgbChannelToLinear = srgbChannelToLinear;
 exports.srgbToHex = srgbToHex;
 exports.srgbToLinearSrgb = srgbToLinearSrgb;
 exports.srgbToOklab = srgbToOklab;
 exports.srgbToOklch = srgbToOklch;
+exports.validateApcaContrast = validateApcaContrast;
+exports.validateContrast = validateContrast;
+exports.validateWcagContrast = validateWcagContrast;
 exports.wcagContrast = wcagContrast;
 exports.wcagLuminance = wcagLuminance;
 //# sourceMappingURL=index.cjs.map