@vielzeug/palette 0.0.0-stage → 26.11.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +37 -2
  3. package/dist/contrast.cjs +2 -0
  4. package/dist/contrast.cjs.map +1 -0
  5. package/dist/contrast.d.ts +12 -0
  6. package/dist/contrast.d.ts.map +1 -0
  7. package/dist/contrast.js +18 -0
  8. package/dist/contrast.js.map +1 -0
  9. package/dist/convert.cjs +2 -0
  10. package/dist/convert.cjs.map +1 -0
  11. package/dist/convert.d.ts +37 -0
  12. package/dist/convert.d.ts.map +1 -0
  13. package/dist/convert.js +98 -0
  14. package/dist/convert.js.map +1 -0
  15. package/dist/errors.cjs +2 -0
  16. package/dist/errors.cjs.map +1 -0
  17. package/dist/errors.d.ts +11 -0
  18. package/dist/errors.d.ts.map +1 -0
  19. package/dist/errors.js +9 -0
  20. package/dist/errors.js.map +1 -0
  21. package/dist/format.cjs +2 -0
  22. package/dist/format.cjs.map +1 -0
  23. package/dist/format.d.ts +10 -0
  24. package/dist/format.d.ts.map +1 -0
  25. package/dist/format.js +31 -0
  26. package/dist/format.js.map +1 -0
  27. package/dist/index.cjs +1 -0
  28. package/dist/index.d.ts +8 -0
  29. package/dist/index.d.ts.map +1 -0
  30. package/dist/index.js +7 -0
  31. package/dist/mix.cjs +2 -0
  32. package/dist/mix.cjs.map +1 -0
  33. package/dist/mix.d.ts +17 -0
  34. package/dist/mix.d.ts.map +1 -0
  35. package/dist/mix.js +57 -0
  36. package/dist/mix.js.map +1 -0
  37. package/dist/named-colors.cjs +2 -0
  38. package/dist/named-colors.cjs.map +1 -0
  39. package/dist/named-colors.d.ts +3 -0
  40. package/dist/named-colors.d.ts.map +1 -0
  41. package/dist/named-colors.js +861 -0
  42. package/dist/named-colors.js.map +1 -0
  43. package/dist/palette.cjs +2 -0
  44. package/dist/palette.cjs.map +1 -0
  45. package/dist/palette.iife.js +2 -0
  46. package/dist/palette.iife.js.map +1 -0
  47. package/dist/palette.js +1160 -0
  48. package/dist/palette.js.map +1 -0
  49. package/dist/parse.cjs +2 -0
  50. package/dist/parse.cjs.map +1 -0
  51. package/dist/parse.d.ts +10 -0
  52. package/dist/parse.d.ts.map +1 -0
  53. package/dist/parse.js +115 -0
  54. package/dist/parse.js.map +1 -0
  55. package/dist/types.d.ts +49 -0
  56. package/dist/types.d.ts.map +1 -0
  57. package/package.json +48 -4
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Helmuth Saatkamp
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,38 @@
1
- # Temporary Holding Version
1
+ # @vielzeug/palette
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ > Color parsing, conversion, mixing, and contrast for design tools
4
+
5
+ ## Installation
6
+
7
+ ```sh
8
+ pnpm add @vielzeug/palette
9
+ npm install @vielzeug/palette
10
+ yarn add @vielzeug/palette
11
+ ```
12
+
13
+ ## Quick Start
14
+
15
+ ```ts
16
+ import { mix, parseColor, ramp, readableOn, toHex } from '@vielzeug/palette';
17
+
18
+ const brand = parseColor('#3366cc');
19
+ const surface = parseColor('rgb(248 250 252)');
20
+
21
+ const ink = readableOn(surface, [parseColor('#0f172a'), parseColor('#334155')]);
22
+ const midpoint = mix(brand, surface, 0.5); // OKLab interpolation, like color-mix(in oklab)
23
+ const shades = ramp(brand, { steps: 9 }); // OKLCH lightness ramp
24
+
25
+ console.log(toHex(ink ?? brand), toHex(midpoint), shades.map(toHex));
26
+ ```
27
+
28
+ ## Documentation
29
+
30
+ - [Overview](https://vielzeug.dev/palette/)
31
+ - [Usage Guide](https://vielzeug.dev/palette/usage)
32
+ - [API Reference](https://vielzeug.dev/palette/api)
33
+ - [Examples](https://vielzeug.dev/palette/examples)
34
+ - [Migration Guide](https://vielzeug.dev/palette/migration)
35
+
36
+ ## License
37
+
38
+ MIT © [Helmuth Saatkamp](https://github.com/helmuthdu): part of the [Vielzeug](https://github.com/helmuthdu/vielzeug) monorepo.
@@ -0,0 +1,2 @@
1
+ const e=require("./convert.cjs");function relativeLuminance(t){let n=e.linearize(e.clamp(t.r,0,255)/255),r=e.linearize(e.clamp(t.g,0,255)/255),i=e.linearize(e.clamp(t.b,0,255)/255);return .2126*n+.7152*r+.0722*i}function contrastRatio(e,t){let n=relativeLuminance(e),r=relativeLuminance(t);return(Math.max(n,r)+.05)/(Math.min(n,r)+.05)}function readableOn(e,t,n){let r=n?.level??`AA`,i=n?.large??!1?r===`AAA`?4.5:3:r===`AAA`?7:4.5;for(let n of t)if(contrastRatio(e,n)>=i)return n;return null}exports.contrastRatio=contrastRatio,exports.readableOn=readableOn,exports.relativeLuminance=relativeLuminance;
2
+ //# sourceMappingURL=contrast.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contrast.cjs","names":["linearize","clamp","require_convert","r","color","g","b","la","a","lb","level","options","threshold","candidate","candidates","background"],"sources":["../src/contrast.ts"],"sourcesContent":["import { clamp, linearize } from './convert.js';\nimport type { ReadableOnOptions, Rgba } from './types.js';\n\n/** WCAG 2.x relative luminance of a color, computed on channels clamped to 0–255. */\nexport function relativeLuminance(color: Rgba): number {\n const r = linearize(clamp(color.r, 0, 255) / 255);\n const g = linearize(clamp(color.g, 0, 255) / 255);\n const b = linearize(clamp(color.b, 0, 255) / 255);\n return 0.2126 * r + 0.7152 * g + 0.0722 * b;\n}\n\n/** WCAG 2.x contrast ratio between two colors: 1 (identical) to 21 (black on white). */\nexport function contrastRatio(a: Rgba, b: Rgba): number {\n const la = relativeLuminance(a);\n const lb = relativeLuminance(b);\n return (Math.max(la, lb) + 0.05) / (Math.min(la, lb) + 0.05);\n}\n\n/**\n * Picks the first candidate that reaches the WCAG contrast threshold against\n * `background`: 4.5 (AA) or 7 (AAA) normally, 3 or 4.5 when `large` is true.\n * Returns null when no candidate passes.\n */\nexport function readableOn(background: Rgba, candidates: readonly Rgba[], options?: ReadableOnOptions): Rgba | null {\n const level = options?.level ?? 'AA';\n const large = options?.large ?? false;\n const threshold = large ? (level === 'AAA' ? 4.5 : 3) : level === 'AAA' ? 7 : 4.5;\n for (const candidate of candidates) {\n if (contrastRatio(background, candidate) >= threshold) return candidate;\n }\n return null;\n}\n"],"mappings":"A,iCAIA,SAAgB,kBAAkB,EAAqB,CACrD,IAAMG,EAAIH,EAAAA,UAAUC,EAAAA,MAAMG,EAAM,EAAG,EAAG,GAAG,EAAI,GAAG,EAC1CC,EAAIL,EAAAA,UAAUC,EAAAA,MAAMG,EAAM,EAAG,EAAG,GAAG,EAAI,GAAG,EAC1CE,EAAIN,EAAAA,UAAUC,EAAAA,MAAMG,EAAM,EAAG,EAAG,GAAG,EAAI,GAAG,EAChD,MAAO,OAASD,EAAI,MAASE,EAAI,MAASC,CAC5C,CAGA,SAAgB,cAAc,EAAS,EAAiB,CACtD,IAAMC,EAAK,kBAAkBC,CAAC,EACxBC,EAAK,kBAAkBH,CAAC,EAC9B,OAAQ,KAAK,IAAIC,EAAIE,CAAE,EAAI,MAAS,KAAK,IAAIF,EAAIE,CAAE,EAAI,IACzD,CAOA,SAAgB,WAAW,EAAkB,EAA6B,EAA0C,CAClH,IAAMC,EAAQC,GAAS,OAAS,KAE1BC,EADQD,GAAS,OAAS,GACLD,IAAU,MAAQ,IAAM,EAAKA,IAAU,MAAQ,EAAI,IAC9E,IAAK,IAAMG,KAAaC,EACtB,GAAI,cAAcC,EAAYF,CAAS,GAAKD,EAAW,OAAOC,EAEhE,OAAO,IACT,C"}
@@ -0,0 +1,12 @@
1
+ import type { ReadableOnOptions, Rgba } from './types.js';
2
+ /** WCAG 2.x relative luminance of a color, computed on channels clamped to 0–255. */
3
+ export declare function relativeLuminance(color: Rgba): number;
4
+ /** WCAG 2.x contrast ratio between two colors: 1 (identical) to 21 (black on white). */
5
+ export declare function contrastRatio(a: Rgba, b: Rgba): number;
6
+ /**
7
+ * Picks the first candidate that reaches the WCAG contrast threshold against
8
+ * `background`: 4.5 (AA) or 7 (AAA) normally, 3 or 4.5 when `large` is true.
9
+ * Returns null when no candidate passes.
10
+ */
11
+ export declare function readableOn(background: Rgba, candidates: readonly Rgba[], options?: ReadableOnOptions): Rgba | null;
12
+ //# sourceMappingURL=contrast.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../src/contrast.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE1D,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAKrD;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAItD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,IAAI,EAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAQlH"}
@@ -0,0 +1,18 @@
1
+ import { clamp as e, linearize as t } from "./convert.js";
2
+ // src/contrast.ts
3
+ function relativeLuminance(n) {
4
+ let r = t(e(n.r, 0, 255) / 255), i = t(e(n.g, 0, 255) / 255), a = t(e(n.b, 0, 255) / 255);
5
+ return .2126 * r + .7152 * i + .0722 * a;
6
+ }
7
+ function contrastRatio(e, t) {
8
+ let n = relativeLuminance(e), r = relativeLuminance(t);
9
+ return (Math.max(n, r) + .05) / (Math.min(n, r) + .05);
10
+ }
11
+ function readableOn(e, t, n) {
12
+ let r = n?.level ?? "AA", i = n?.large ?? !1 ? r === "AAA" ? 4.5 : 3 : r === "AAA" ? 7 : 4.5;
13
+ for (let n of t) if (contrastRatio(e, n) >= i) return n;
14
+ return null;
15
+ }
16
+ export { contrastRatio, readableOn, relativeLuminance };
17
+
18
+ //# sourceMappingURL=contrast.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contrast.js","names":["linearize","clamp","color","g","b","la","a","lb","level","options","threshold","candidate","candidates","background"],"sources":["../src/contrast.ts"],"sourcesContent":["import { clamp, linearize } from './convert.js';\nimport type { ReadableOnOptions, Rgba } from './types.js';\n\n/** WCAG 2.x relative luminance of a color, computed on channels clamped to 0–255. */\nexport function relativeLuminance(color: Rgba): number {\n const r = linearize(clamp(color.r, 0, 255) / 255);\n const g = linearize(clamp(color.g, 0, 255) / 255);\n const b = linearize(clamp(color.b, 0, 255) / 255);\n return 0.2126 * r + 0.7152 * g + 0.0722 * b;\n}\n\n/** WCAG 2.x contrast ratio between two colors: 1 (identical) to 21 (black on white). */\nexport function contrastRatio(a: Rgba, b: Rgba): number {\n const la = relativeLuminance(a);\n const lb = relativeLuminance(b);\n return (Math.max(la, lb) + 0.05) / (Math.min(la, lb) + 0.05);\n}\n\n/**\n * Picks the first candidate that reaches the WCAG contrast threshold against\n * `background`: 4.5 (AA) or 7 (AAA) normally, 3 or 4.5 when `large` is true.\n * Returns null when no candidate passes.\n */\nexport function readableOn(background: Rgba, candidates: readonly Rgba[], options?: ReadableOnOptions): Rgba | null {\n const level = options?.level ?? 'AA';\n const large = options?.large ?? false;\n const threshold = large ? (level === 'AAA' ? 4.5 : 3) : level === 'AAA' ? 7 : 4.5;\n for (const candidate of candidates) {\n if (contrastRatio(background, candidate) >= threshold) return candidate;\n }\n return null;\n}\n"],"mappings":";;AAIA,SAAgB,kBAAkB,GAAqB;CACrD,IAAM,IAAIA,EAAUC,EAAMC,EAAM,GAAG,GAAG,GAAG,IAAI,GAAG,GAC1CC,IAAIH,EAAUC,EAAMC,EAAM,GAAG,GAAG,GAAG,IAAI,GAAG,GAC1CE,IAAIJ,EAAUC,EAAMC,EAAM,GAAG,GAAG,GAAG,IAAI,GAAG;CAChD,OAAO,QAAS,IAAI,QAASC,IAAI,QAASC;AAC5C;AAGA,SAAgB,cAAc,GAAS,GAAiB;CACtD,IAAMC,IAAK,kBAAkBC,CAAC,GACxBC,IAAK,kBAAkBH,CAAC;CAC9B,QAAQ,KAAK,IAAIC,GAAIE,CAAE,IAAI,QAAS,KAAK,IAAIF,GAAIE,CAAE,IAAI;AACzD;AAOA,SAAgB,WAAW,GAAkB,GAA6B,GAA0C;CAClH,IAAMC,IAAQC,GAAS,SAAS,MAE1BC,IADQD,GAAS,SAAS,KACLD,MAAU,QAAQ,MAAM,IAAKA,MAAU,QAAQ,IAAI;CAC9E,KAAK,IAAMG,KAAaC,GACtB,IAAI,cAAcC,GAAYF,CAAS,KAAKD,GAAW,OAAOC;CAEhE,OAAO;AACT"}
@@ -0,0 +1,2 @@
1
+ function clamp(e,t,n){return Math.min(n,Math.max(t,e))}function linearize(e){return e<0?-linearize(-e):e<=.04045?e/12.92:((e+.055)/1.055)**2.4}function delinearize(e){return e<0?-delinearize(-e):e<=.0031308?e*12.92:1.055*e**(1/2.4)-.055}function toLinear255(e){return linearize(e/255)}function srgbToOklab(e){let t=toLinear255(e.r),n=toLinear255(e.g),r=toLinear255(e.b),i=Math.cbrt(.4122214708*t+.5363325363*n+.0514459929*r),a=Math.cbrt(.2119034982*t+.6806995451*n+.1073969566*r),o=Math.cbrt(.0883024619*t+.2817188376*n+.6299787005*r);return{a:1.9779984951*i-2.428592205*a+.4505937099*o,alpha:clamp(e.a,0,1),b:.0259040371*i+.7827717662*a-.808675766*o,l:.2104542553*i+.793617785*a-.0040720468*o}}function oklabToLinearSrgb(e){let t=(e.l+.3963377774*e.a+.2158037573*e.b)**3,n=(e.l-.1055613458*e.a-.0638541728*e.b)**3,r=(e.l-.0894841775*e.a-1.291485548*e.b)**3;return[4.0767416621*t-3.3077115913*n+.2309699292*r,-1.2684380046*t+2.6097574011*n-.3413193965*r,-.0041960863*t-.7034186147*n+1.707614701*r]}function oklabToSrgb(e){let[t,n,r]=oklabToLinearSrgb(e);return{a:clamp(e.alpha,0,1),b:delinearize(r)*255,g:delinearize(n)*255,r:delinearize(t)*255}}function oklabToOklch(e){let t=Math.atan2(e.b,e.a)*180/Math.PI;return{a:e.alpha,c:Math.hypot(e.a,e.b),h:t<0?t+360:t,l:e.l}}function oklchToOklab(e){let t=e.h*Math.PI/180;return{a:e.c*Math.cos(t),alpha:e.a,b:e.c*Math.sin(t),l:e.l}}function srgbToHsl(e){let t=clamp(e.r,0,255)/255,n=clamp(e.g,0,255)/255,r=clamp(e.b,0,255)/255,i=Math.max(t,n,r),a=Math.min(t,n,r),o=i-a,s=(i+a)/2,c=o===0?0:o/(1-Math.abs(2*s-1)),l=0;return o!==0&&(l=i===t?60*((n-r)/o%6):i===n?60*((r-t)/o+2):60*((t-n)/o+4)),{a:clamp(e.a,0,1),h:l<0?l+360:l,l:s*100,s:c*100}}function hslToSrgb(e){let t=(e.h%360+360)%360,n=e.s/100,r=e.l/100,i=n*Math.min(r,1-r),channel=e=>{let n=(e+t/30)%12;return(r-i*Math.max(-1,Math.min(n-3,9-n,1)))*255};return{a:clamp(e.a,0,1),b:channel(4),g:channel(8),r:channel(0)}}function srgbToOklch(e){return oklabToOklch(srgbToOklab(e))}function oklchToSrgb(e){return oklabToSrgb(oklchToOklab(e))}function isDisplayable(e){for(let t of[e.r,e.g,e.b]){let e=linearize(t/255);if(e<-15e-5||e>1.00015)return!1}return!0}exports.clamp=clamp,exports.delinearize=delinearize,exports.hslToSrgb=hslToSrgb,exports.isDisplayable=isDisplayable,exports.linearize=linearize,exports.oklabToOklch=oklabToOklch,exports.oklabToSrgb=oklabToSrgb,exports.oklchToOklab=oklchToOklab,exports.oklchToSrgb=oklchToSrgb,exports.srgbToHsl=srgbToHsl,exports.srgbToOklab=srgbToOklab,exports.srgbToOklch=srgbToOklch;
2
+ //# sourceMappingURL=convert.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"convert.cjs","names":["max","min","value","channel","r","color","g","b","l","m","s","h","rad","delta","amplitude","k","offset","linear"],"sources":["../src/convert.ts"],"sourcesContent":["import type { Hsla, Oklch, Rgba } from './types.js';\n\n/** A color in OKLab: the internal linear-light waypoint between sRGB and OKLCH. */\nexport type Oklab = Readonly<{\n l: number;\n a: number;\n b: number;\n alpha: number;\n}>;\n\n/** Clamps to the inclusive range. */\nexport function clamp(value: number, min: number, max: number): number {\n return Math.min(max, Math.max(min, value));\n}\n\n/** sRGB companding decode (EOTF), sign-extended to negative channels per CSS Color 4. */\nexport function linearize(channel: number): number {\n if (channel < 0) return -linearize(-channel);\n return channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4;\n}\n\n/** sRGB companding encode (OETF), sign-extended to negative channels per CSS Color 4. */\nexport function delinearize(channel: number): number {\n if (channel < 0) return -delinearize(-channel);\n return channel <= 0.0031308 ? channel * 12.92 : 1.055 * channel ** (1 / 2.4) - 0.055;\n}\n\nfunction toLinear255(channel: number): number {\n return linearize(channel / 255);\n}\n\n/** sRGB (0–255, unclamped) to OKLab using Björn Ottosson's matrices via linear-cone LMS. */\nexport function srgbToOklab(color: Rgba): Oklab {\n const r = toLinear255(color.r);\n const g = toLinear255(color.g);\n const b = toLinear255(color.b);\n const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b);\n const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b);\n const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b);\n return {\n a: 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s,\n alpha: clamp(color.a, 0, 1),\n b: 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s,\n l: 0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s,\n };\n}\n\n/** OKLab to unclamped linear-light sRGB channels; a channel outside [0, 1] is out of gamut. */\nfunction oklabToLinearSrgb(color: Oklab): [number, number, number] {\n const l = (color.l + 0.3963377774 * color.a + 0.2158037573 * color.b) ** 3;\n const m = (color.l - 0.1055613458 * color.a - 0.0638541728 * color.b) ** 3;\n const s = (color.l - 0.0894841775 * color.a - 1.291485548 * color.b) ** 3;\n return [\n 4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s,\n -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s,\n -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s,\n ];\n}\n\n/** OKLab to sRGB (0–255). Channels outside 0–255 are out of gamut and stay unclamped. */\nexport function oklabToSrgb(color: Oklab): Rgba {\n const [r, g, b] = oklabToLinearSrgb(color);\n return {\n a: clamp(color.alpha, 0, 1),\n b: delinearize(b) * 255,\n g: delinearize(g) * 255,\n r: delinearize(r) * 255,\n };\n}\n\n/** OKLab to OKLCH (polar form of the a/b plane). */\nexport function oklabToOklch(color: Oklab): Oklch {\n const h = (Math.atan2(color.b, color.a) * 180) / Math.PI;\n return {\n a: color.alpha,\n c: Math.hypot(color.a, color.b),\n h: h < 0 ? h + 360 : h,\n l: color.l,\n };\n}\n\n/** OKLCH to OKLab. */\nexport function oklchToOklab(color: Oklch): Oklab {\n const rad = (color.h * Math.PI) / 180;\n return {\n a: color.c * Math.cos(rad),\n alpha: color.a,\n b: color.c * Math.sin(rad),\n l: color.l,\n };\n}\n\n/** sRGB (0–255, clamped) to HSL. */\nexport function srgbToHsl(color: Rgba): Hsla {\n const r = clamp(color.r, 0, 255) / 255;\n const g = clamp(color.g, 0, 255) / 255;\n const b = clamp(color.b, 0, 255) / 255;\n const max = Math.max(r, g, b);\n const min = Math.min(r, g, b);\n const delta = max - min;\n const l = (max + min) / 2;\n const s = delta === 0 ? 0 : delta / (1 - Math.abs(2 * l - 1));\n let h = 0;\n if (delta !== 0) {\n if (max === r) h = 60 * (((g - b) / delta) % 6);\n else if (max === g) h = 60 * ((b - r) / delta + 2);\n else h = 60 * ((r - g) / delta + 4);\n }\n return { a: clamp(color.a, 0, 1), h: h < 0 ? h + 360 : h, l: l * 100, s: s * 100 };\n}\n\n/** HSL to sRGB (0–255). Channels outside 0–255 stay unclamped; only alpha is bounded. */\nexport function hslToSrgb(color: Hsla): Rgba {\n const h = ((color.h % 360) + 360) % 360;\n const s = color.s / 100;\n const l = color.l / 100;\n const amplitude = s * Math.min(l, 1 - l);\n const channel = (offset: number) => {\n const k = (offset + h / 30) % 12;\n return (l - amplitude * Math.max(-1, Math.min(k - 3, 9 - k, 1))) * 255;\n };\n return { a: clamp(color.a, 0, 1), b: channel(4), g: channel(8), r: channel(0) };\n}\n\n/** sRGB (0–255, clamped) to OKLCH. */\nexport function srgbToOklch(color: Rgba): Oklch {\n return oklabToOklch(srgbToOklab(color));\n}\n\n/** OKLCH to sRGB (0–255). Out-of-gamut channels stay unclamped. */\nexport function oklchToSrgb(color: Oklch): Rgba {\n return oklabToSrgb(oklchToOklab(color));\n}\n\n// Tolerance for gamut checks, matching the rounding slack CSS Color 4 implementations use.\nconst GAMUT_EPSILON = 0.00015;\n\n/**\n * True when an sRGB color falls inside the displayable gamut: every channel's\n * linear-light value is within a small rounding tolerance of [0, 1]. Works on\n * any parsed `Rgba`, including values produced by `oklchToSrgb` or `hslToSrgb`.\n */\nexport function isDisplayable(color: Rgba): boolean {\n for (const channel of [color.r, color.g, color.b]) {\n const linear = linearize(channel / 255);\n if (linear < -GAMUT_EPSILON || linear > 1 + GAMUT_EPSILON) return false;\n }\n return true;\n}\n"],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import type { Hsla, Oklch, Rgba } from './types.js';
2
+ /** A color in OKLab: the internal linear-light waypoint between sRGB and OKLCH. */
3
+ export type Oklab = Readonly<{
4
+ l: number;
5
+ a: number;
6
+ b: number;
7
+ alpha: number;
8
+ }>;
9
+ /** Clamps to the inclusive range. */
10
+ export declare function clamp(value: number, min: number, max: number): number;
11
+ /** sRGB companding decode (EOTF), sign-extended to negative channels per CSS Color 4. */
12
+ export declare function linearize(channel: number): number;
13
+ /** sRGB companding encode (OETF), sign-extended to negative channels per CSS Color 4. */
14
+ export declare function delinearize(channel: number): number;
15
+ /** sRGB (0–255, unclamped) to OKLab using Björn Ottosson's matrices via linear-cone LMS. */
16
+ export declare function srgbToOklab(color: Rgba): Oklab;
17
+ /** OKLab to sRGB (0–255). Channels outside 0–255 are out of gamut and stay unclamped. */
18
+ export declare function oklabToSrgb(color: Oklab): Rgba;
19
+ /** OKLab to OKLCH (polar form of the a/b plane). */
20
+ export declare function oklabToOklch(color: Oklab): Oklch;
21
+ /** OKLCH to OKLab. */
22
+ export declare function oklchToOklab(color: Oklch): Oklab;
23
+ /** sRGB (0–255, clamped) to HSL. */
24
+ export declare function srgbToHsl(color: Rgba): Hsla;
25
+ /** HSL to sRGB (0–255). Channels outside 0–255 stay unclamped; only alpha is bounded. */
26
+ export declare function hslToSrgb(color: Hsla): Rgba;
27
+ /** sRGB (0–255, clamped) to OKLCH. */
28
+ export declare function srgbToOklch(color: Rgba): Oklch;
29
+ /** OKLCH to sRGB (0–255). Out-of-gamut channels stay unclamped. */
30
+ export declare function oklchToSrgb(color: Oklch): Rgba;
31
+ /**
32
+ * True when an sRGB color falls inside the displayable gamut: every channel's
33
+ * linear-light value is within a small rounding tolerance of [0, 1]. Works on
34
+ * any parsed `Rgba`, including values produced by `oklchToSrgb` or `hslToSrgb`.
35
+ */
36
+ export declare function isDisplayable(color: Rgba): boolean;
37
+ //# sourceMappingURL=convert.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEpD,mFAAmF;AACnF,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,qCAAqC;AACrC,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGnD;AAMD,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,KAAK,CAa9C;AAcD,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAQ9C;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAQhD;AAED,sBAAsB;AACtB,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAQhD;AAED,oCAAoC;AACpC,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAgB3C;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAU3C;AAED,sCAAsC;AACtC,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,KAAK,CAE9C;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAE9C;AAKD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAMlD"}
@@ -0,0 +1,98 @@
1
+ // src/convert.ts
2
+ function clamp(e, t, n) {
3
+ return Math.min(n, Math.max(t, e));
4
+ }
5
+ function linearize(e) {
6
+ return e < 0 ? -linearize(-e) : e <= .04045 ? e / 12.92 : ((e + .055) / 1.055) ** 2.4;
7
+ }
8
+ function delinearize(e) {
9
+ return e < 0 ? -delinearize(-e) : e <= .0031308 ? e * 12.92 : 1.055 * e ** (1 / 2.4) - .055;
10
+ }
11
+ function toLinear255(e) {
12
+ return linearize(e / 255);
13
+ }
14
+ function srgbToOklab(e) {
15
+ let t = toLinear255(e.r), n = toLinear255(e.g), r = toLinear255(e.b), i = Math.cbrt(.4122214708 * t + .5363325363 * n + .0514459929 * r), a = Math.cbrt(.2119034982 * t + .6806995451 * n + .1073969566 * r), o = Math.cbrt(.0883024619 * t + .2817188376 * n + .6299787005 * r);
16
+ return {
17
+ a: 1.9779984951 * i - 2.428592205 * a + .4505937099 * o,
18
+ alpha: clamp(e.a, 0, 1),
19
+ b: .0259040371 * i + .7827717662 * a - .808675766 * o,
20
+ l: .2104542553 * i + .793617785 * a - .0040720468 * o
21
+ };
22
+ }
23
+ function oklabToLinearSrgb(e) {
24
+ let t = (e.l + .3963377774 * e.a + .2158037573 * e.b) ** 3, n = (e.l - .1055613458 * e.a - .0638541728 * e.b) ** 3, r = (e.l - .0894841775 * e.a - 1.291485548 * e.b) ** 3;
25
+ return [
26
+ 4.0767416621 * t - 3.3077115913 * n + .2309699292 * r,
27
+ -1.2684380046 * t + 2.6097574011 * n - .3413193965 * r,
28
+ -.0041960863 * t - .7034186147 * n + 1.707614701 * r
29
+ ];
30
+ }
31
+ function oklabToSrgb(e) {
32
+ let [t, n, r] = oklabToLinearSrgb(e);
33
+ return {
34
+ a: clamp(e.alpha, 0, 1),
35
+ b: delinearize(r) * 255,
36
+ g: delinearize(n) * 255,
37
+ r: delinearize(t) * 255
38
+ };
39
+ }
40
+ function oklabToOklch(e) {
41
+ let t = Math.atan2(e.b, e.a) * 180 / Math.PI;
42
+ return {
43
+ a: e.alpha,
44
+ c: Math.hypot(e.a, e.b),
45
+ h: t < 0 ? t + 360 : t,
46
+ l: e.l
47
+ };
48
+ }
49
+ function oklchToOklab(e) {
50
+ let t = e.h * Math.PI / 180;
51
+ return {
52
+ a: e.c * Math.cos(t),
53
+ alpha: e.a,
54
+ b: e.c * Math.sin(t),
55
+ l: e.l
56
+ };
57
+ }
58
+ function srgbToHsl(e) {
59
+ let t = clamp(e.r, 0, 255) / 255, n = clamp(e.g, 0, 255) / 255, r = clamp(e.b, 0, 255) / 255, i = Math.max(t, n, r), a = Math.min(t, n, r), o = i - a, s = (i + a) / 2, c = o === 0 ? 0 : o / (1 - Math.abs(2 * s - 1)), l = 0;
60
+ return o !== 0 && (l = i === t ? 60 * ((n - r) / o % 6) : i === n ? 60 * ((r - t) / o + 2) : 60 * ((t - n) / o + 4)), {
61
+ a: clamp(e.a, 0, 1),
62
+ h: l < 0 ? l + 360 : l,
63
+ l: s * 100,
64
+ s: c * 100
65
+ };
66
+ }
67
+ function hslToSrgb(e) {
68
+ let t = (e.h % 360 + 360) % 360, n = e.s / 100, r = e.l / 100, i = n * Math.min(r, 1 - r), channel = (e) => {
69
+ let n = (e + t / 30) % 12;
70
+ return (r - i * Math.max(-1, Math.min(n - 3, 9 - n, 1))) * 255;
71
+ };
72
+ return {
73
+ a: clamp(e.a, 0, 1),
74
+ b: channel(4),
75
+ g: channel(8),
76
+ r: channel(0)
77
+ };
78
+ }
79
+ function srgbToOklch(e) {
80
+ return oklabToOklch(srgbToOklab(e));
81
+ }
82
+ function oklchToSrgb(e) {
83
+ return oklabToSrgb(oklchToOklab(e));
84
+ }
85
+ function isDisplayable(e) {
86
+ for (let t of [
87
+ e.r,
88
+ e.g,
89
+ e.b
90
+ ]) {
91
+ let e = linearize(t / 255);
92
+ if (e < -15e-5 || e > 1.00015) return !1;
93
+ }
94
+ return !0;
95
+ }
96
+ export { clamp, delinearize, hslToSrgb, isDisplayable, linearize, oklabToOklch, oklabToSrgb, oklchToOklab, oklchToSrgb, srgbToHsl, srgbToOklab, srgbToOklch };
97
+
98
+ //# sourceMappingURL=convert.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"convert.js","names":["max","min","value","channel","r","color","g","b","l","m","s","h","rad","delta","amplitude","k","offset","linear"],"sources":["../src/convert.ts"],"sourcesContent":["import type { Hsla, Oklch, Rgba } from './types.js';\n\n/** A color in OKLab: the internal linear-light waypoint between sRGB and OKLCH. */\nexport type Oklab = Readonly<{\n l: number;\n a: number;\n b: number;\n alpha: number;\n}>;\n\n/** Clamps to the inclusive range. */\nexport function clamp(value: number, min: number, max: number): number {\n return Math.min(max, Math.max(min, value));\n}\n\n/** sRGB companding decode (EOTF), sign-extended to negative channels per CSS Color 4. */\nexport function linearize(channel: number): number {\n if (channel < 0) return -linearize(-channel);\n return channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4;\n}\n\n/** sRGB companding encode (OETF), sign-extended to negative channels per CSS Color 4. */\nexport function delinearize(channel: number): number {\n if (channel < 0) return -delinearize(-channel);\n return channel <= 0.0031308 ? channel * 12.92 : 1.055 * channel ** (1 / 2.4) - 0.055;\n}\n\nfunction toLinear255(channel: number): number {\n return linearize(channel / 255);\n}\n\n/** sRGB (0–255, unclamped) to OKLab using Björn Ottosson's matrices via linear-cone LMS. */\nexport function srgbToOklab(color: Rgba): Oklab {\n const r = toLinear255(color.r);\n const g = toLinear255(color.g);\n const b = toLinear255(color.b);\n const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b);\n const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b);\n const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b);\n return {\n a: 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s,\n alpha: clamp(color.a, 0, 1),\n b: 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s,\n l: 0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s,\n };\n}\n\n/** OKLab to unclamped linear-light sRGB channels; a channel outside [0, 1] is out of gamut. */\nfunction oklabToLinearSrgb(color: Oklab): [number, number, number] {\n const l = (color.l + 0.3963377774 * color.a + 0.2158037573 * color.b) ** 3;\n const m = (color.l - 0.1055613458 * color.a - 0.0638541728 * color.b) ** 3;\n const s = (color.l - 0.0894841775 * color.a - 1.291485548 * color.b) ** 3;\n return [\n 4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s,\n -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s,\n -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s,\n ];\n}\n\n/** OKLab to sRGB (0–255). Channels outside 0–255 are out of gamut and stay unclamped. */\nexport function oklabToSrgb(color: Oklab): Rgba {\n const [r, g, b] = oklabToLinearSrgb(color);\n return {\n a: clamp(color.alpha, 0, 1),\n b: delinearize(b) * 255,\n g: delinearize(g) * 255,\n r: delinearize(r) * 255,\n };\n}\n\n/** OKLab to OKLCH (polar form of the a/b plane). */\nexport function oklabToOklch(color: Oklab): Oklch {\n const h = (Math.atan2(color.b, color.a) * 180) / Math.PI;\n return {\n a: color.alpha,\n c: Math.hypot(color.a, color.b),\n h: h < 0 ? h + 360 : h,\n l: color.l,\n };\n}\n\n/** OKLCH to OKLab. */\nexport function oklchToOklab(color: Oklch): Oklab {\n const rad = (color.h * Math.PI) / 180;\n return {\n a: color.c * Math.cos(rad),\n alpha: color.a,\n b: color.c * Math.sin(rad),\n l: color.l,\n };\n}\n\n/** sRGB (0–255, clamped) to HSL. */\nexport function srgbToHsl(color: Rgba): Hsla {\n const r = clamp(color.r, 0, 255) / 255;\n const g = clamp(color.g, 0, 255) / 255;\n const b = clamp(color.b, 0, 255) / 255;\n const max = Math.max(r, g, b);\n const min = Math.min(r, g, b);\n const delta = max - min;\n const l = (max + min) / 2;\n const s = delta === 0 ? 0 : delta / (1 - Math.abs(2 * l - 1));\n let h = 0;\n if (delta !== 0) {\n if (max === r) h = 60 * (((g - b) / delta) % 6);\n else if (max === g) h = 60 * ((b - r) / delta + 2);\n else h = 60 * ((r - g) / delta + 4);\n }\n return { a: clamp(color.a, 0, 1), h: h < 0 ? h + 360 : h, l: l * 100, s: s * 100 };\n}\n\n/** HSL to sRGB (0–255). Channels outside 0–255 stay unclamped; only alpha is bounded. */\nexport function hslToSrgb(color: Hsla): Rgba {\n const h = ((color.h % 360) + 360) % 360;\n const s = color.s / 100;\n const l = color.l / 100;\n const amplitude = s * Math.min(l, 1 - l);\n const channel = (offset: number) => {\n const k = (offset + h / 30) % 12;\n return (l - amplitude * Math.max(-1, Math.min(k - 3, 9 - k, 1))) * 255;\n };\n return { a: clamp(color.a, 0, 1), b: channel(4), g: channel(8), r: channel(0) };\n}\n\n/** sRGB (0–255, clamped) to OKLCH. */\nexport function srgbToOklch(color: Rgba): Oklch {\n return oklabToOklch(srgbToOklab(color));\n}\n\n/** OKLCH to sRGB (0–255). Out-of-gamut channels stay unclamped. */\nexport function oklchToSrgb(color: Oklch): Rgba {\n return oklabToSrgb(oklchToOklab(color));\n}\n\n// Tolerance for gamut checks, matching the rounding slack CSS Color 4 implementations use.\nconst GAMUT_EPSILON = 0.00015;\n\n/**\n * True when an sRGB color falls inside the displayable gamut: every channel's\n * linear-light value is within a small rounding tolerance of [0, 1]. Works on\n * any parsed `Rgba`, including values produced by `oklchToSrgb` or `hslToSrgb`.\n */\nexport function isDisplayable(color: Rgba): boolean {\n for (const channel of [color.r, color.g, color.b]) {\n const linear = linearize(channel / 255);\n if (linear < -GAMUT_EPSILON || linear > 1 + GAMUT_EPSILON) return false;\n }\n return true;\n}\n"],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ var PaletteError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},PaletteParseError=class extends PaletteError{},PaletteConfigError=class extends PaletteError{};exports.PaletteConfigError=PaletteConfigError,exports.PaletteError=PaletteError,exports.PaletteParseError=PaletteParseError;
2
+ //# sourceMappingURL=errors.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.cjs","names":["message","opts"],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all palette errors. Use `instanceof PaletteError` to catch any palette-originated error. */\nexport class PaletteError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when a color string cannot be parsed, such as a malformed hex digit or an unknown color function. The message includes the offending input. */\nexport class PaletteParseError extends PaletteError {}\n\n/** Thrown when palette options are invalid, such as a `ramp` step count below two or a `mix` position outside `[0, 1]`. */\nexport class PaletteConfigError extends PaletteError {}\n"],"mappings":"AACA,IAAa,aAAb,cAAkC,KAAM,CACtC,YAAY,EAAiB,EAAqB,CAChD,MAAMA,EAASC,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAGa,kBAAb,cAAuC,YAAa,CAAC,EAGxC,mBAAb,cAAwC,YAAa,CAAC,E"}
@@ -0,0 +1,11 @@
1
+ /** Base class for all palette errors. Use `instanceof PaletteError` to catch any palette-originated error. */
2
+ export declare class PaletteError extends Error {
3
+ constructor(message: string, opts?: ErrorOptions);
4
+ }
5
+ /** Thrown when a color string cannot be parsed, such as a malformed hex digit or an unknown color function. The message includes the offending input. */
6
+ export declare class PaletteParseError extends PaletteError {
7
+ }
8
+ /** Thrown when palette options are invalid, such as a `ramp` step count below two or a `mix` position outside `[0, 1]`. */
9
+ export declare class PaletteConfigError extends PaletteError {
10
+ }
11
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;CAKjD;AAED,yJAAyJ;AACzJ,qBAAa,iBAAkB,SAAQ,YAAY;CAAG;AAEtD,2HAA2H;AAC3H,qBAAa,kBAAmB,SAAQ,YAAY;CAAG"}
package/dist/errors.js ADDED
@@ -0,0 +1,9 @@
1
+ // src/errors.ts
2
+ var PaletteError = class extends Error {
3
+ constructor(e, t) {
4
+ super(e, t), this.name = new.target.name, Object.setPrototypeOf(this, new.target.prototype);
5
+ }
6
+ }, PaletteParseError = class extends PaletteError {}, PaletteConfigError = class extends PaletteError {};
7
+ export { PaletteConfigError, PaletteError, PaletteParseError };
8
+
9
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","names":["message","opts"],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all palette errors. Use `instanceof PaletteError` to catch any palette-originated error. */\nexport class PaletteError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when a color string cannot be parsed, such as a malformed hex digit or an unknown color function. The message includes the offending input. */\nexport class PaletteParseError extends PaletteError {}\n\n/** Thrown when palette options are invalid, such as a `ramp` step count below two or a `mix` position outside `[0, 1]`. */\nexport class PaletteConfigError extends PaletteError {}\n"],"mappings":";AACA,IAAa,eAAb,cAAkC,MAAM;CACtC,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAMA,GAASC,CAAI,GACnB,KAAK,OAAO,WAAW,MACvB,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;AACF,GAGa,oBAAb,cAAuC,aAAa,CAAC,GAGxC,qBAAb,cAAwC,aAAa,CAAC"}
@@ -0,0 +1,2 @@
1
+ const e=require("./convert.cjs");function round(e,t){let n=10**t,r=Math.round(e*n)/n;return r===0?0:r}function hex2(e){return round(e,0).toString(16).padStart(2,`0`)}function shouldWriteAlpha(t,n){return n?.alpha===!0||e.clamp(t.a,0,1)<1}function toHex(t,n){let r=hex2(e.clamp(t.r,0,255)),i=hex2(e.clamp(t.g,0,255)),a=hex2(e.clamp(t.b,0,255));return shouldWriteAlpha(t,n)?`#${r}${i}${a}${hex2(e.clamp(t.a,0,1)*255)}`:`#${r}${i}${a}`}function toRgbString(t,n){let r=round(e.clamp(t.r,0,255),0),i=round(e.clamp(t.g,0,255),0),a=round(e.clamp(t.b,0,255),0);return shouldWriteAlpha(t,n)?`rgb(${r} ${i} ${a} / ${round(e.clamp(t.a,0,1),3)})`:`rgb(${r} ${i} ${a})`}function toHslString(t,n){let r=e.srgbToHsl(t),i=round(r.h,1),a=round(r.s,1),o=round(r.l,1);return shouldWriteAlpha(t,n)?`hsl(${i} ${a}% ${o}% / ${round(e.clamp(t.a,0,1),3)})`:`hsl(${i} ${a}% ${o}%)`}function toOklchString(t,n){let r=e.oklabToOklch(e.srgbToOklab(t)),i=round(r.l*100,2),a=round(r.c,4),o=round(r.h,2);return shouldWriteAlpha(t,n)?`oklch(${i}% ${a} ${o} / ${round(e.clamp(t.a,0,1),3)})`:`oklch(${i}% ${a} ${o})`}exports.toHex=toHex,exports.toHslString=toHslString,exports.toOklchString=toOklchString,exports.toRgbString=toRgbString;
2
+ //# sourceMappingURL=format.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"format.cjs","names":["clamp","srgbToHsl","oklabToOklch","srgbToOklab","require_convert","factor","digits","rounded","value","options","color","g","b","hsl","h","s","l","oklch","c"],"sources":["../src/format.ts"],"sourcesContent":["import { clamp, oklabToOklch, srgbToHsl, srgbToOklab } from './convert.js';\nimport type { FormatOptions, Rgba } from './types.js';\n\n/** Rounds to `digits` decimals without negative zero. */\nfunction round(value: number, digits: number): number {\n const factor = 10 ** digits;\n const rounded = Math.round(value * factor) / factor;\n return rounded === 0 ? 0 : rounded;\n}\n\nfunction hex2(value: number): string {\n return round(value, 0).toString(16).padStart(2, '0');\n}\n\nfunction shouldWriteAlpha(color: Rgba, options: FormatOptions | undefined): boolean {\n return options?.alpha === true || clamp(color.a, 0, 1) < 1;\n}\n\n/** Formats as `#rrggbb` or `#rrggbbaa`. Out-of-gamut channels are clamped to 0–255 and alpha to 0–1. */\nexport function toHex(color: Rgba, options?: FormatOptions): string {\n const r = hex2(clamp(color.r, 0, 255));\n const g = hex2(clamp(color.g, 0, 255));\n const b = hex2(clamp(color.b, 0, 255));\n return shouldWriteAlpha(color, options) ? `#${r}${g}${b}${hex2(clamp(color.a, 0, 1) * 255)}` : `#${r}${g}${b}`;\n}\n\n/** Formats as CSS `rgb()`/`rgba()` space syntax. Out-of-gamut channels are clamped to 0–255 and alpha to 0–1. */\nexport function toRgbString(color: Rgba, options?: FormatOptions): string {\n const r = round(clamp(color.r, 0, 255), 0);\n const g = round(clamp(color.g, 0, 255), 0);\n const b = round(clamp(color.b, 0, 255), 0);\n if (!shouldWriteAlpha(color, options)) return `rgb(${r} ${g} ${b})`;\n return `rgb(${r} ${g} ${b} / ${round(clamp(color.a, 0, 1), 3)})`;\n}\n\n/** Formats as CSS `hsl()`/`hsla()` space syntax. Out-of-gamut channels are clamped before conversion. */\nexport function toHslString(color: Rgba, options?: FormatOptions): string {\n const hsl = srgbToHsl(color);\n const h = round(hsl.h, 1);\n const s = round(hsl.s, 1);\n const l = round(hsl.l, 1);\n if (!shouldWriteAlpha(color, options)) return `hsl(${h} ${s}% ${l}%)`;\n return `hsl(${h} ${s}% ${l}% / ${round(clamp(color.a, 0, 1), 3)})`;\n}\n\n/** Formats as CSS `oklch()` syntax on the color's true (possibly out-of-gamut) channels. */\nexport function toOklchString(color: Rgba, options?: FormatOptions): string {\n const oklch = oklabToOklch(srgbToOklab(color));\n const l = round(oklch.l * 100, 2);\n const c = round(oklch.c, 4);\n const h = round(oklch.h, 2);\n if (!shouldWriteAlpha(color, options)) return `oklch(${l}% ${c} ${h})`;\n return `oklch(${l}% ${c} ${h} / ${round(clamp(color.a, 0, 1), 3)})`;\n}\n"],"mappings":"A,iCAIA,SAAS,MAAM,EAAe,EAAwB,CACpD,IAAMK,EAAS,IAAMC,EACfC,EAAU,KAAK,MAAMC,EAAQH,CAAM,EAAIA,EAC7C,OAAOE,IAAY,EAAI,EAAIA,CAC7B,CAEA,SAAS,KAAK,EAAuB,CACnC,OAAO,MAAMC,EAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,EAAG,GAAG,CACrD,CAEA,SAAS,iBAAiB,EAAa,EAA6C,CAClF,OAAOC,GAAS,QAAU,IAAQT,EAAAA,MAAMU,EAAM,EAAG,EAAG,CAAC,EAAI,CAC3D,CAGA,SAAgB,MAAM,EAAa,EAAiC,CAClE,IAAM,EAAI,KAAKV,EAAAA,MAAMU,EAAM,EAAG,EAAG,GAAG,CAAC,EAC/BC,EAAI,KAAKX,EAAAA,MAAMU,EAAM,EAAG,EAAG,GAAG,CAAC,EAC/BE,EAAI,KAAKZ,EAAAA,MAAMU,EAAM,EAAG,EAAG,GAAG,CAAC,EACrC,OAAO,iBAAiBA,EAAOD,CAAO,EAAI,IAAI,IAAIE,IAAIC,IAAI,KAAKZ,EAAAA,MAAMU,EAAM,EAAG,EAAG,CAAC,EAAI,GAAG,IAAM,IAAI,IAAIC,IAAIC,GAC7G,CAGA,SAAgB,YAAY,EAAa,EAAiC,CACxE,IAAM,EAAI,MAAMZ,EAAAA,MAAMU,EAAM,EAAG,EAAG,GAAG,EAAG,CAAC,EACnCC,EAAI,MAAMX,EAAAA,MAAMU,EAAM,EAAG,EAAG,GAAG,EAAG,CAAC,EACnCE,EAAI,MAAMZ,EAAAA,MAAMU,EAAM,EAAG,EAAG,GAAG,EAAG,CAAC,EAEzC,OADK,iBAAiBA,EAAOD,CAAO,EAC7B,OAAO,EAAE,GAAGE,EAAE,GAAGC,EAAE,KAAK,MAAMZ,EAAAA,MAAMU,EAAM,EAAG,EAAG,CAAC,EAAG,CAAC,EAAE,GADhB,OAAO,EAAE,GAAGC,EAAE,GAAGC,EAAE,EAEnE,CAGA,SAAgB,YAAY,EAAa,EAAiC,CACxE,IAAMC,EAAMZ,EAAAA,UAAUS,CAAK,EACrBI,EAAI,MAAMD,EAAI,EAAG,CAAC,EAClBE,EAAI,MAAMF,EAAI,EAAG,CAAC,EAClBG,EAAI,MAAMH,EAAI,EAAG,CAAC,EAExB,OADK,iBAAiBH,EAAOD,CAAO,EAC7B,OAAOK,EAAE,GAAGC,EAAE,IAAIC,EAAE,MAAM,MAAMhB,EAAAA,MAAMU,EAAM,EAAG,EAAG,CAAC,EAAG,CAAC,EAAE,GADlB,OAAOI,EAAE,GAAGC,EAAE,IAAIC,EAAE,GAEpE,CAGA,SAAgB,cAAc,EAAa,EAAiC,CAC1E,IAAMC,EAAQf,EAAAA,aAAaC,EAAAA,YAAYO,CAAK,CAAC,EACvCM,EAAI,MAAMC,EAAM,EAAI,IAAK,CAAC,EAC1BC,EAAI,MAAMD,EAAM,EAAG,CAAC,EACpBH,EAAI,MAAMG,EAAM,EAAG,CAAC,EAE1B,OADK,iBAAiBP,EAAOD,CAAO,EAC7B,SAASO,EAAE,IAAIE,EAAE,GAAGJ,EAAE,KAAK,MAAMd,EAAAA,MAAMU,EAAM,EAAG,EAAG,CAAC,EAAG,CAAC,EAAE,GADnB,SAASM,EAAE,IAAIE,EAAE,GAAGJ,EAAE,EAEtE,C"}
@@ -0,0 +1,10 @@
1
+ import type { FormatOptions, Rgba } from './types.js';
2
+ /** Formats as `#rrggbb` or `#rrggbbaa`. Out-of-gamut channels are clamped to 0–255 and alpha to 0–1. */
3
+ export declare function toHex(color: Rgba, options?: FormatOptions): string;
4
+ /** Formats as CSS `rgb()`/`rgba()` space syntax. Out-of-gamut channels are clamped to 0–255 and alpha to 0–1. */
5
+ export declare function toRgbString(color: Rgba, options?: FormatOptions): string;
6
+ /** Formats as CSS `hsl()`/`hsla()` space syntax. Out-of-gamut channels are clamped before conversion. */
7
+ export declare function toHslString(color: Rgba, options?: FormatOptions): string;
8
+ /** Formats as CSS `oklch()` syntax on the color's true (possibly out-of-gamut) channels. */
9
+ export declare function toOklchString(color: Rgba, options?: FormatOptions): string;
10
+ //# sourceMappingURL=format.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAiBtD,wGAAwG;AACxG,wBAAgB,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAKlE;AAED,iHAAiH;AACjH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAMxE;AAED,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAOxE;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAO1E"}
package/dist/format.js ADDED
@@ -0,0 +1,31 @@
1
+ import { clamp as e, oklabToOklch as t, srgbToHsl as n, srgbToOklab as r } from "./convert.js";
2
+ // src/format.ts
3
+ function round(e, t) {
4
+ let n = 10 ** t, r = Math.round(e * n) / n;
5
+ return r === 0 ? 0 : r;
6
+ }
7
+ function hex2(e) {
8
+ return round(e, 0).toString(16).padStart(2, "0");
9
+ }
10
+ function shouldWriteAlpha(t, n) {
11
+ return n?.alpha === !0 || e(t.a, 0, 1) < 1;
12
+ }
13
+ function toHex(t, n) {
14
+ let r = hex2(e(t.r, 0, 255)), i = hex2(e(t.g, 0, 255)), a = hex2(e(t.b, 0, 255));
15
+ return shouldWriteAlpha(t, n) ? `#${r}${i}${a}${hex2(e(t.a, 0, 1) * 255)}` : `#${r}${i}${a}`;
16
+ }
17
+ function toRgbString(t, n) {
18
+ let r = round(e(t.r, 0, 255), 0), i = round(e(t.g, 0, 255), 0), a = round(e(t.b, 0, 255), 0);
19
+ return shouldWriteAlpha(t, n) ? `rgb(${r} ${i} ${a} / ${round(e(t.a, 0, 1), 3)})` : `rgb(${r} ${i} ${a})`;
20
+ }
21
+ function toHslString(t, r) {
22
+ let i = n(t), a = round(i.h, 1), o = round(i.s, 1), s = round(i.l, 1);
23
+ return shouldWriteAlpha(t, r) ? `hsl(${a} ${o}% ${s}% / ${round(e(t.a, 0, 1), 3)})` : `hsl(${a} ${o}% ${s}%)`;
24
+ }
25
+ function toOklchString(n, i) {
26
+ let a = t(r(n)), o = round(a.l * 100, 2), s = round(a.c, 4), c = round(a.h, 2);
27
+ return shouldWriteAlpha(n, i) ? `oklch(${o}% ${s} ${c} / ${round(e(n.a, 0, 1), 3)})` : `oklch(${o}% ${s} ${c})`;
28
+ }
29
+ export { toHex, toHslString, toOklchString, toRgbString };
30
+
31
+ //# sourceMappingURL=format.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"format.js","names":["factor","digits","rounded","value","options","clamp","color","g","b","hsl","srgbToHsl","h","s","l","oklch","oklabToOklch","srgbToOklab","c"],"sources":["../src/format.ts"],"sourcesContent":["import { clamp, oklabToOklch, srgbToHsl, srgbToOklab } from './convert.js';\nimport type { FormatOptions, Rgba } from './types.js';\n\n/** Rounds to `digits` decimals without negative zero. */\nfunction round(value: number, digits: number): number {\n const factor = 10 ** digits;\n const rounded = Math.round(value * factor) / factor;\n return rounded === 0 ? 0 : rounded;\n}\n\nfunction hex2(value: number): string {\n return round(value, 0).toString(16).padStart(2, '0');\n}\n\nfunction shouldWriteAlpha(color: Rgba, options: FormatOptions | undefined): boolean {\n return options?.alpha === true || clamp(color.a, 0, 1) < 1;\n}\n\n/** Formats as `#rrggbb` or `#rrggbbaa`. Out-of-gamut channels are clamped to 0–255 and alpha to 0–1. */\nexport function toHex(color: Rgba, options?: FormatOptions): string {\n const r = hex2(clamp(color.r, 0, 255));\n const g = hex2(clamp(color.g, 0, 255));\n const b = hex2(clamp(color.b, 0, 255));\n return shouldWriteAlpha(color, options) ? `#${r}${g}${b}${hex2(clamp(color.a, 0, 1) * 255)}` : `#${r}${g}${b}`;\n}\n\n/** Formats as CSS `rgb()`/`rgba()` space syntax. Out-of-gamut channels are clamped to 0–255 and alpha to 0–1. */\nexport function toRgbString(color: Rgba, options?: FormatOptions): string {\n const r = round(clamp(color.r, 0, 255), 0);\n const g = round(clamp(color.g, 0, 255), 0);\n const b = round(clamp(color.b, 0, 255), 0);\n if (!shouldWriteAlpha(color, options)) return `rgb(${r} ${g} ${b})`;\n return `rgb(${r} ${g} ${b} / ${round(clamp(color.a, 0, 1), 3)})`;\n}\n\n/** Formats as CSS `hsl()`/`hsla()` space syntax. Out-of-gamut channels are clamped before conversion. */\nexport function toHslString(color: Rgba, options?: FormatOptions): string {\n const hsl = srgbToHsl(color);\n const h = round(hsl.h, 1);\n const s = round(hsl.s, 1);\n const l = round(hsl.l, 1);\n if (!shouldWriteAlpha(color, options)) return `hsl(${h} ${s}% ${l}%)`;\n return `hsl(${h} ${s}% ${l}% / ${round(clamp(color.a, 0, 1), 3)})`;\n}\n\n/** Formats as CSS `oklch()` syntax on the color's true (possibly out-of-gamut) channels. */\nexport function toOklchString(color: Rgba, options?: FormatOptions): string {\n const oklch = oklabToOklch(srgbToOklab(color));\n const l = round(oklch.l * 100, 2);\n const c = round(oklch.c, 4);\n const h = round(oklch.h, 2);\n if (!shouldWriteAlpha(color, options)) return `oklch(${l}% ${c} ${h})`;\n return `oklch(${l}% ${c} ${h} / ${round(clamp(color.a, 0, 1), 3)})`;\n}\n"],"mappings":";;AAIA,SAAS,MAAM,GAAe,GAAwB;CACpD,IAAMA,IAAS,MAAMC,GACfC,IAAU,KAAK,MAAMC,IAAQH,CAAM,IAAIA;CAC7C,OAAOE,MAAY,IAAI,IAAIA;AAC7B;AAEA,SAAS,KAAK,GAAuB;CACnC,OAAO,MAAMC,GAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG;AACrD;AAEA,SAAS,iBAAiB,GAAa,GAA6C;CAClF,OAAOC,GAAS,UAAU,MAAQC,EAAMC,EAAM,GAAG,GAAG,CAAC,IAAI;AAC3D;AAGA,SAAgB,MAAM,GAAa,GAAiC;CAClE,IAAM,IAAI,KAAKD,EAAMC,EAAM,GAAG,GAAG,GAAG,CAAC,GAC/BC,IAAI,KAAKF,EAAMC,EAAM,GAAG,GAAG,GAAG,CAAC,GAC/BE,IAAI,KAAKH,EAAMC,EAAM,GAAG,GAAG,GAAG,CAAC;CACrC,OAAO,iBAAiBA,GAAOF,CAAO,IAAI,IAAI,IAAIG,IAAIC,IAAI,KAAKH,EAAMC,EAAM,GAAG,GAAG,CAAC,IAAI,GAAG,MAAM,IAAI,IAAIC,IAAIC;AAC7G;AAGA,SAAgB,YAAY,GAAa,GAAiC;CACxE,IAAM,IAAI,MAAMH,EAAMC,EAAM,GAAG,GAAG,GAAG,GAAG,CAAC,GACnCC,IAAI,MAAMF,EAAMC,EAAM,GAAG,GAAG,GAAG,GAAG,CAAC,GACnCE,IAAI,MAAMH,EAAMC,EAAM,GAAG,GAAG,GAAG,GAAG,CAAC;CAEzC,OADK,iBAAiBA,GAAOF,CAAO,IAC7B,OAAO,EAAE,GAAGG,EAAE,GAAGC,EAAE,KAAK,MAAMH,EAAMC,EAAM,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,KADhB,OAAO,EAAE,GAAGC,EAAE,GAAGC,EAAE;AAEnE;AAGA,SAAgB,YAAY,GAAa,GAAiC;CACxE,IAAMC,IAAMC,EAAUJ,CAAK,GACrBK,IAAI,MAAMF,EAAI,GAAG,CAAC,GAClBG,IAAI,MAAMH,EAAI,GAAG,CAAC,GAClBI,IAAI,MAAMJ,EAAI,GAAG,CAAC;CAExB,OADK,iBAAiBH,GAAOF,CAAO,IAC7B,OAAOO,EAAE,GAAGC,EAAE,IAAIC,EAAE,MAAM,MAAMR,EAAMC,EAAM,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,KADlB,OAAOK,EAAE,GAAGC,EAAE,IAAIC,EAAE;AAEpE;AAGA,SAAgB,cAAc,GAAa,GAAiC;CAC1E,IAAMC,IAAQC,EAAaC,EAAYV,CAAK,CAAC,GACvCO,IAAI,MAAMC,EAAM,IAAI,KAAK,CAAC,GAC1BG,IAAI,MAAMH,EAAM,GAAG,CAAC,GACpBH,IAAI,MAAMG,EAAM,GAAG,CAAC;CAE1B,OADK,iBAAiBR,GAAOF,CAAO,IAC7B,SAASS,EAAE,IAAII,EAAE,GAAGN,EAAE,KAAK,MAAMN,EAAMC,EAAM,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,KADnB,SAASO,EAAE,IAAII,EAAE,GAAGN,EAAE;AAEtE"}
package/dist/index.cjs ADDED
@@ -0,0 +1 @@
1
+ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./contrast.cjs"),t=require("./convert.cjs"),n=require("./errors.cjs"),r=require("./format.cjs"),i=require("./mix.cjs"),a=require("./parse.cjs");exports.PaletteConfigError=n.PaletteConfigError,exports.PaletteError=n.PaletteError,exports.PaletteParseError=n.PaletteParseError,exports.contrastRatio=e.contrastRatio,exports.hslToSrgb=t.hslToSrgb,exports.isDisplayable=t.isDisplayable,exports.mix=i.mix,exports.oklchToSrgb=t.oklchToSrgb,exports.parseColor=a.parseColor,exports.ramp=i.ramp,exports.readableOn=e.readableOn,exports.relativeLuminance=e.relativeLuminance,exports.srgbToHsl=t.srgbToHsl,exports.srgbToOklch=t.srgbToOklch,exports.toHex=r.toHex,exports.toHslString=r.toHslString,exports.toOklchString=r.toOklchString,exports.toRgbString=r.toRgbString;
@@ -0,0 +1,8 @@
1
+ export { contrastRatio, readableOn, relativeLuminance } from './contrast.js';
2
+ export { hslToSrgb, isDisplayable, oklchToSrgb, srgbToHsl, srgbToOklch } from './convert.js';
3
+ export { PaletteConfigError, PaletteError, PaletteParseError } from './errors.js';
4
+ export { toHex, toHslString, toOklchString, toRgbString } from './format.js';
5
+ export { mix, ramp } from './mix.js';
6
+ export { parseColor } from './parse.js';
7
+ export type { FormatOptions, Hsla, Oklch, RampOptions, ReadableOnOptions, Rgba } from './types.js';
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,7 @@
1
+ import { contrastRatio as e, readableOn as t, relativeLuminance as n } from "./contrast.js";
2
+ import { hslToSrgb as r, isDisplayable as i, oklchToSrgb as a, srgbToHsl as o, srgbToOklch as s } from "./convert.js";
3
+ import { PaletteConfigError as c, PaletteError as l, PaletteParseError as u } from "./errors.js";
4
+ import { toHex as d, toHslString as f, toOklchString as p, toRgbString as m } from "./format.js";
5
+ import { mix as h, ramp as g } from "./mix.js";
6
+ import { parseColor as _ } from "./parse.js";
7
+ export { c as PaletteConfigError, l as PaletteError, u as PaletteParseError, e as contrastRatio, r as hslToSrgb, i as isDisplayable, h as mix, a as oklchToSrgb, _ as parseColor, g as ramp, t as readableOn, n as relativeLuminance, o as srgbToHsl, s as srgbToOklch, d as toHex, f as toHslString, p as toOklchString, m as toRgbString };
package/dist/mix.cjs ADDED
@@ -0,0 +1,2 @@
1
+ const e=require("./convert.cjs"),t=require("./errors.cjs");function mix(n,r,i){if(!Number.isFinite(i)||i<0||i>1)throw new t.PaletteConfigError(`mix position t must be within [0, 1], got ${i}`);let a=e.clamp(n.a,0,1),o=e.clamp(r.a,0,1),s=a+(o-a)*i,c=e.srgbToOklab(n),l=e.srgbToOklab(r),mixAxis=(e,t)=>{let n=e*a+(t*o-e*a)*i;return s===0?n:n/s},u={a:mixAxis(c.a,l.a),alpha:s,b:mixAxis(c.b,l.b),l:mixAxis(c.l,l.l)};return e.oklabToSrgb(u)}function fitGamut(t){if(e.isDisplayable(e.oklabToSrgb(t)))return t;let n=e.oklabToOklch(t);if(n.c<1e-6)return t;let r=0,i=n.c;for(let a=0;a<20;a+=1){let a=(r+i)/2,o=e.oklchToOklab({a:t.alpha,c:a,h:n.h,l:t.l});e.isDisplayable(e.oklabToSrgb(o))?r=a:i=a}return e.oklchToOklab({a:t.alpha,c:r,h:n.h,l:t.l})}function ramp(n,r){let{steps:i,minLightness:a=.15,maxLightness:o=.95}=r;if(!Number.isInteger(i)||i<2)throw new t.PaletteConfigError(`ramp steps must be an integer of at least 2, got ${i}`);if(!(a>=0&&a<=1)||!(o>=0&&o<=1))throw new t.PaletteConfigError(`ramp lightness bounds must be within [0, 1], got minLightness=${a}, maxLightness=${o}`);if(a>o)throw new t.PaletteConfigError(`ramp minLightness (${a}) must not exceed maxLightness (${o})`);let s=e.srgbToOklab(n),c=[];for(let t=0;t<i;t+=1){let n=a+(o-a)*t/(i-1),r={a:s.a,alpha:s.alpha,b:s.b,l:n};c.push(e.oklabToSrgb(fitGamut(r)))}return c}exports.mix=mix,exports.ramp=ramp;
2
+ //# sourceMappingURL=mix.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mix.cjs","names":["PaletteConfigError","clamp","srgbToOklab","oklabToSrgb","isDisplayable","oklabToOklch","oklchToOklab","require_convert","require_errors","t","alphaA","a","alphaB","b","alpha","labA","labB","value","ka","kb","lab","oklch","low","high","i","mid","candidate","options","steps","minLightness","maxLightness","baseLab","base","swatches","l"],"sources":["../src/mix.ts"],"sourcesContent":["import { clamp, isDisplayable, oklabToOklch, oklabToSrgb, oklchToOklab, srgbToOklab } from './convert.js';\nimport { PaletteConfigError } from './errors.js';\nimport type { RampOptions, Rgba } from './types.js';\n\n/**\n * Interpolates two colors in OKLab with premultiplied alpha, matching CSS\n * `color-mix(in oklab, ...)`. `t` is 0 for `a`, 1 for `b`. A fully transparent\n * endpoint contributes no color, so mixing red with transparent black yields\n * red at half alpha rather than a darkened blend.\n */\nexport function mix(a: Rgba, b: Rgba, t: number): Rgba {\n if (!Number.isFinite(t) || t < 0 || t > 1) {\n throw new PaletteConfigError(`mix position t must be within [0, 1], got ${t}`);\n }\n const alphaA = clamp(a.a, 0, 1);\n const alphaB = clamp(b.a, 0, 1);\n const alpha = alphaA + (alphaB - alphaA) * t;\n const labA = srgbToOklab(a);\n const labB = srgbToOklab(b);\n // Premultiply every OKLab axis, including lightness, by alpha so\n // transparent endpoints do not pull the color toward black; divide back out\n // unless the result is invisible.\n const mixAxis = (ka: number, kb: number): number => {\n const value = ka * alphaA + (kb * alphaB - ka * alphaA) * t;\n return alpha === 0 ? value : value / alpha;\n };\n const lab = {\n a: mixAxis(labA.a, labB.a),\n alpha,\n b: mixAxis(labA.b, labB.b),\n l: mixAxis(labA.l, labB.l),\n };\n return oklabToSrgb(lab);\n}\n\n/**\n * Reduces an out-of-gamut OKLab color's chroma (binary search at fixed L and\n * hue) until it fits the sRGB gamut. Neutral colors are returned unchanged.\n */\nfunction fitGamut(lab: { a: number; alpha: number; b: number; l: number }): typeof lab {\n if (isDisplayable(oklabToSrgb(lab))) return lab;\n const oklch = oklabToOklch(lab);\n if (oklch.c < 1e-6) return lab;\n let low = 0;\n let high = oklch.c;\n // ~20 halvings shrink the chroma interval below any visible step.\n for (let i = 0; i < 20; i += 1) {\n const mid = (low + high) / 2;\n const candidate = oklchToOklab({ a: lab.alpha, c: mid, h: oklch.h, l: lab.l });\n if (isDisplayable(oklabToSrgb(candidate))) low = mid;\n else high = mid;\n }\n return oklchToOklab({ a: lab.alpha, c: low, h: oklch.h, l: lab.l });\n}\n\n/**\n * Builds a deterministic ramp of `steps` swatches by interpolating OKLab\n * lightness between `minLightness` and `maxLightness` while keeping the base\n * color's hue. Chroma is reduced where needed so every swatch stays inside the\n * sRGB gamut, which keeps the hue stable across the ramp. Swatches run dark to\n * light.\n */\nexport function ramp(base: Rgba, options: RampOptions): Rgba[] {\n const { steps, minLightness = 0.15, maxLightness = 0.95 } = options;\n if (!Number.isInteger(steps) || steps < 2) {\n throw new PaletteConfigError(`ramp steps must be an integer of at least 2, got ${steps}`);\n }\n if (!(minLightness >= 0 && minLightness <= 1) || !(maxLightness >= 0 && maxLightness <= 1)) {\n throw new PaletteConfigError(\n `ramp lightness bounds must be within [0, 1], got minLightness=${minLightness}, maxLightness=${maxLightness}`,\n );\n }\n if (minLightness > maxLightness) {\n throw new PaletteConfigError(`ramp minLightness (${minLightness}) must not exceed maxLightness (${maxLightness})`);\n }\n const baseLab = srgbToOklab(base);\n const swatches: Rgba[] = [];\n for (let i = 0; i < steps; i += 1) {\n const l = minLightness + ((maxLightness - minLightness) * i) / (steps - 1);\n const lab = { a: baseLab.a, alpha: baseLab.alpha, b: baseLab.b, l };\n swatches.push(oklabToSrgb(fitGamut(lab)));\n }\n return swatches;\n}\n"],"mappings":"A,2DAUA,SAAgB,IAAI,EAAS,EAAS,EAAiB,CACrD,GAAI,CAAC,OAAO,SAASS,CAAC,GAAKA,EAAI,GAAKA,EAAI,EACtC,MAAM,IAAIT,EAAAA,mBAAmB,6CAA6CS,GAAG,EAE/E,IAAMC,EAAST,EAAAA,MAAMU,EAAE,EAAG,EAAG,CAAC,EACxBC,EAASX,EAAAA,MAAMY,EAAE,EAAG,EAAG,CAAC,EACxBC,EAAQJ,GAAUE,EAASF,GAAUD,EACrCM,EAAOb,EAAAA,YAAYS,CAAC,EACpBK,EAAOd,EAAAA,YAAYW,CAAC,EAIpB,SAAW,EAAY,IAAuB,CAClD,IAAMI,EAAQC,EAAKR,GAAUS,EAAKP,EAASM,EAAKR,GAAUD,EAC1D,OAAOK,IAAU,EAAIG,EAAQA,EAAQH,CACvC,EACMM,EAAM,CACV,EAAG,QAAQL,EAAK,EAAGC,EAAK,CAAC,EACzB,QACA,EAAG,QAAQD,EAAK,EAAGC,EAAK,CAAC,EACzB,EAAG,QAAQD,EAAK,EAAGC,EAAK,CAAC,CAC3B,EACA,OAAOb,EAAAA,YAAYiB,CAAG,CACxB,CAMA,SAAS,SAAS,EAAqE,CACrF,GAAIhB,EAAAA,cAAcD,EAAAA,YAAYiB,CAAG,CAAC,EAAG,OAAOA,EAC5C,IAAMC,EAAQhB,EAAAA,aAAae,CAAG,EAC9B,GAAIC,EAAM,EAAI,KAAM,OAAOD,EAC3B,IAAIE,EAAM,EACNC,EAAOF,EAAM,EAEjB,IAAK,IAAIG,EAAI,EAAGA,EAAI,GAAI,GAAK,EAAG,CAC9B,IAAMC,GAAOH,EAAMC,GAAQ,EACrBG,EAAYpB,EAAAA,aAAa,CAAE,EAAGc,EAAI,MAAO,EAAGK,EAAK,EAAGJ,EAAM,EAAG,EAAGD,EAAI,CAAE,CAAC,EACzEhB,EAAAA,cAAcD,EAAAA,YAAYuB,CAAS,CAAC,EAAG,EAAMD,EAC5C,EAAOA,CACd,CACA,OAAOnB,EAAAA,aAAa,CAAE,EAAGc,EAAI,MAAO,EAAGE,EAAK,EAAGD,EAAM,EAAG,EAAGD,EAAI,CAAE,CAAC,CACpE,CASA,SAAgB,KAAK,EAAY,EAA8B,CAC7D,GAAM,CAAE,QAAO,eAAe,IAAM,eAAe,KAASO,EAC5D,GAAI,CAAC,OAAO,UAAUC,CAAK,GAAKA,EAAQ,EACtC,MAAM,IAAI5B,EAAAA,mBAAmB,oDAAoD4B,GAAO,EAE1F,GAAI,EAAEC,GAAgB,GAAKA,GAAgB,IAAM,EAAEC,GAAgB,GAAKA,GAAgB,GACtF,MAAM,IAAI9B,EAAAA,mBACR,iEAAiE6B,EAAa,iBAAiBC,GACjG,EAEF,GAAID,EAAeC,EACjB,MAAM,IAAI9B,EAAAA,mBAAmB,sBAAsB6B,EAAa,kCAAkCC,EAAa,EAAE,EAEnH,IAAMC,EAAU7B,EAAAA,YAAY8B,CAAI,EAC1BC,EAAmB,CAAC,EAC1B,IAAK,IAAIT,EAAI,EAAGA,EAAII,EAAO,GAAK,EAAG,CACjC,IAAMM,EAAIL,GAAiBC,EAAeD,GAAgBL,GAAMI,EAAQ,GAClER,EAAM,CAAE,EAAGW,EAAQ,EAAG,MAAOA,EAAQ,MAAO,EAAGA,EAAQ,EAAG,GAAE,EAClEE,EAAS,KAAK9B,EAAAA,YAAY,SAASiB,CAAG,CAAC,CAAC,CAC1C,CACA,OAAOa,CACT,C"}
package/dist/mix.d.ts ADDED
@@ -0,0 +1,17 @@
1
+ import type { RampOptions, Rgba } from './types.js';
2
+ /**
3
+ * Interpolates two colors in OKLab with premultiplied alpha, matching CSS
4
+ * `color-mix(in oklab, ...)`. `t` is 0 for `a`, 1 for `b`. A fully transparent
5
+ * endpoint contributes no color, so mixing red with transparent black yields
6
+ * red at half alpha rather than a darkened blend.
7
+ */
8
+ export declare function mix(a: Rgba, b: Rgba, t: number): Rgba;
9
+ /**
10
+ * Builds a deterministic ramp of `steps` swatches by interpolating OKLab
11
+ * lightness between `minLightness` and `maxLightness` while keeping the base
12
+ * color's hue. Chroma is reduced where needed so every swatch stays inside the
13
+ * sRGB gamut, which keeps the hue stable across the ramp. Swatches run dark to
14
+ * light.
15
+ */
16
+ export declare function ramp(base: Rgba, options: RampOptions): Rgba[];
17
+ //# sourceMappingURL=mix.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mix.d.ts","sourceRoot":"","sources":["../src/mix.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAuBrD;AAsBD;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,CAqB7D"}
package/dist/mix.js ADDED
@@ -0,0 +1,57 @@
1
+ import { clamp as e, isDisplayable as t, oklabToOklch as n, oklabToSrgb as r, oklchToOklab as i, srgbToOklab as a } from "./convert.js";
2
+ import { PaletteConfigError as o } from "./errors.js";
3
+ // src/mix.ts
4
+ function mix(t, n, i) {
5
+ if (!Number.isFinite(i) || i < 0 || i > 1) throw new o(`mix position t must be within [0, 1], got ${i}`);
6
+ let s = e(t.a, 0, 1), c = e(n.a, 0, 1), l = s + (c - s) * i, u = a(t), d = a(n), mixAxis = (e, t) => {
7
+ let n = e * s + (t * c - e * s) * i;
8
+ return l === 0 ? n : n / l;
9
+ }, f = {
10
+ a: mixAxis(u.a, d.a),
11
+ alpha: l,
12
+ b: mixAxis(u.b, d.b),
13
+ l: mixAxis(u.l, d.l)
14
+ };
15
+ return r(f);
16
+ }
17
+ function fitGamut(e) {
18
+ if (t(r(e))) return e;
19
+ let a = n(e);
20
+ if (a.c < 1e-6) return e;
21
+ let o = 0, s = a.c;
22
+ for (let n = 0; n < 20; n += 1) {
23
+ let n = (o + s) / 2, c = i({
24
+ a: e.alpha,
25
+ c: n,
26
+ h: a.h,
27
+ l: e.l
28
+ });
29
+ t(r(c)) ? o = n : s = n;
30
+ }
31
+ return i({
32
+ a: e.alpha,
33
+ c: o,
34
+ h: a.h,
35
+ l: e.l
36
+ });
37
+ }
38
+ function ramp(e, t) {
39
+ let { steps: n, minLightness: i = .15, maxLightness: s = .95 } = t;
40
+ if (!Number.isInteger(n) || n < 2) throw new o(`ramp steps must be an integer of at least 2, got ${n}`);
41
+ if (!(i >= 0 && i <= 1) || !(s >= 0 && s <= 1)) throw new o(`ramp lightness bounds must be within [0, 1], got minLightness=${i}, maxLightness=${s}`);
42
+ if (i > s) throw new o(`ramp minLightness (${i}) must not exceed maxLightness (${s})`);
43
+ let c = a(e), l = [];
44
+ for (let e = 0; e < n; e += 1) {
45
+ let t = i + (s - i) * e / (n - 1), a = {
46
+ a: c.a,
47
+ alpha: c.alpha,
48
+ b: c.b,
49
+ l: t
50
+ };
51
+ l.push(r(fitGamut(a)));
52
+ }
53
+ return l;
54
+ }
55
+ export { mix, ramp };
56
+
57
+ //# sourceMappingURL=mix.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mix.js","names":["t","PaletteConfigError","alphaA","clamp","a","alphaB","b","alpha","labA","srgbToOklab","labB","value","ka","kb","lab","oklabToSrgb","isDisplayable","oklch","oklabToOklch","low","high","i","mid","candidate","oklchToOklab","options","steps","minLightness","maxLightness","baseLab","base","swatches","l"],"sources":["../src/mix.ts"],"sourcesContent":["import { clamp, isDisplayable, oklabToOklch, oklabToSrgb, oklchToOklab, srgbToOklab } from './convert.js';\nimport { PaletteConfigError } from './errors.js';\nimport type { RampOptions, Rgba } from './types.js';\n\n/**\n * Interpolates two colors in OKLab with premultiplied alpha, matching CSS\n * `color-mix(in oklab, ...)`. `t` is 0 for `a`, 1 for `b`. A fully transparent\n * endpoint contributes no color, so mixing red with transparent black yields\n * red at half alpha rather than a darkened blend.\n */\nexport function mix(a: Rgba, b: Rgba, t: number): Rgba {\n if (!Number.isFinite(t) || t < 0 || t > 1) {\n throw new PaletteConfigError(`mix position t must be within [0, 1], got ${t}`);\n }\n const alphaA = clamp(a.a, 0, 1);\n const alphaB = clamp(b.a, 0, 1);\n const alpha = alphaA + (alphaB - alphaA) * t;\n const labA = srgbToOklab(a);\n const labB = srgbToOklab(b);\n // Premultiply every OKLab axis, including lightness, by alpha so\n // transparent endpoints do not pull the color toward black; divide back out\n // unless the result is invisible.\n const mixAxis = (ka: number, kb: number): number => {\n const value = ka * alphaA + (kb * alphaB - ka * alphaA) * t;\n return alpha === 0 ? value : value / alpha;\n };\n const lab = {\n a: mixAxis(labA.a, labB.a),\n alpha,\n b: mixAxis(labA.b, labB.b),\n l: mixAxis(labA.l, labB.l),\n };\n return oklabToSrgb(lab);\n}\n\n/**\n * Reduces an out-of-gamut OKLab color's chroma (binary search at fixed L and\n * hue) until it fits the sRGB gamut. Neutral colors are returned unchanged.\n */\nfunction fitGamut(lab: { a: number; alpha: number; b: number; l: number }): typeof lab {\n if (isDisplayable(oklabToSrgb(lab))) return lab;\n const oklch = oklabToOklch(lab);\n if (oklch.c < 1e-6) return lab;\n let low = 0;\n let high = oklch.c;\n // ~20 halvings shrink the chroma interval below any visible step.\n for (let i = 0; i < 20; i += 1) {\n const mid = (low + high) / 2;\n const candidate = oklchToOklab({ a: lab.alpha, c: mid, h: oklch.h, l: lab.l });\n if (isDisplayable(oklabToSrgb(candidate))) low = mid;\n else high = mid;\n }\n return oklchToOklab({ a: lab.alpha, c: low, h: oklch.h, l: lab.l });\n}\n\n/**\n * Builds a deterministic ramp of `steps` swatches by interpolating OKLab\n * lightness between `minLightness` and `maxLightness` while keeping the base\n * color's hue. Chroma is reduced where needed so every swatch stays inside the\n * sRGB gamut, which keeps the hue stable across the ramp. Swatches run dark to\n * light.\n */\nexport function ramp(base: Rgba, options: RampOptions): Rgba[] {\n const { steps, minLightness = 0.15, maxLightness = 0.95 } = options;\n if (!Number.isInteger(steps) || steps < 2) {\n throw new PaletteConfigError(`ramp steps must be an integer of at least 2, got ${steps}`);\n }\n if (!(minLightness >= 0 && minLightness <= 1) || !(maxLightness >= 0 && maxLightness <= 1)) {\n throw new PaletteConfigError(\n `ramp lightness bounds must be within [0, 1], got minLightness=${minLightness}, maxLightness=${maxLightness}`,\n );\n }\n if (minLightness > maxLightness) {\n throw new PaletteConfigError(`ramp minLightness (${minLightness}) must not exceed maxLightness (${maxLightness})`);\n }\n const baseLab = srgbToOklab(base);\n const swatches: Rgba[] = [];\n for (let i = 0; i < steps; i += 1) {\n const l = minLightness + ((maxLightness - minLightness) * i) / (steps - 1);\n const lab = { a: baseLab.a, alpha: baseLab.alpha, b: baseLab.b, l };\n swatches.push(oklabToSrgb(fitGamut(lab)));\n }\n return swatches;\n}\n"],"mappings":";;;AAUA,SAAgB,IAAI,GAAS,GAAS,GAAiB;CACrD,IAAI,CAAC,OAAO,SAASA,CAAC,KAAKA,IAAI,KAAKA,IAAI,GACtC,MAAM,IAAIC,EAAmB,6CAA6CD,GAAG;CAE/E,IAAME,IAASC,EAAMC,EAAE,GAAG,GAAG,CAAC,GACxBC,IAASF,EAAMG,EAAE,GAAG,GAAG,CAAC,GACxBC,IAAQL,KAAUG,IAASH,KAAUF,GACrCQ,IAAOC,EAAYL,CAAC,GACpBM,IAAOD,EAAYH,CAAC,GAIpB,WAAW,GAAY,MAAuB;EAClD,IAAMK,IAAQC,IAAKV,KAAUW,IAAKR,IAASO,IAAKV,KAAUF;EAC1D,OAAOO,MAAU,IAAII,IAAQA,IAAQJ;CACvC,GACMO,IAAM;EACV,GAAG,QAAQN,EAAK,GAAGE,EAAK,CAAC;EACzB;EACA,GAAG,QAAQF,EAAK,GAAGE,EAAK,CAAC;EACzB,GAAG,QAAQF,EAAK,GAAGE,EAAK,CAAC;CAC3B;CACA,OAAOK,EAAYD,CAAG;AACxB;AAMA,SAAS,SAAS,GAAqE;CACrF,IAAIE,EAAcD,EAAYD,CAAG,CAAC,GAAG,OAAOA;CAC5C,IAAMG,IAAQC,EAAaJ,CAAG;CAC9B,IAAIG,EAAM,IAAI,MAAM,OAAOH;CAC3B,IAAIK,IAAM,GACNC,IAAOH,EAAM;CAEjB,KAAK,IAAII,IAAI,GAAGA,IAAI,IAAI,KAAK,GAAG;EAC9B,IAAMC,KAAOH,IAAMC,KAAQ,GACrBG,IAAYC,EAAa;GAAE,GAAGV,EAAI;GAAO,GAAGQ;GAAK,GAAGL,EAAM;GAAG,GAAGH,EAAI;EAAE,CAAC;EAC7E,AAAIE,EAAcD,EAAYQ,CAAS,CAAC,IAAG,IAAMD,IAC5C,IAAOA;CACd;CACA,OAAOE,EAAa;EAAE,GAAGV,EAAI;EAAO,GAAGK;EAAK,GAAGF,EAAM;EAAG,GAAGH,EAAI;CAAE,CAAC;AACpE;AASA,SAAgB,KAAK,GAAY,GAA8B;CAC7D,IAAM,EAAE,UAAO,kBAAe,KAAM,kBAAe,QAASW;CAC5D,IAAI,CAAC,OAAO,UAAUC,CAAK,KAAKA,IAAQ,GACtC,MAAM,IAAIzB,EAAmB,oDAAoDyB,GAAO;CAE1F,IAAI,EAAEC,KAAgB,KAAKA,KAAgB,MAAM,EAAEC,KAAgB,KAAKA,KAAgB,IACtF,MAAM,IAAI3B,EACR,iEAAiE0B,EAAa,iBAAiBC,GACjG;CAEF,IAAID,IAAeC,GACjB,MAAM,IAAI3B,EAAmB,sBAAsB0B,EAAa,kCAAkCC,EAAa,EAAE;CAEnH,IAAMC,IAAUpB,EAAYqB,CAAI,GAC1BC,IAAmB,CAAC;CAC1B,KAAK,IAAIV,IAAI,GAAGA,IAAIK,GAAO,KAAK,GAAG;EACjC,IAAMM,IAAIL,KAAiBC,IAAeD,KAAgBN,KAAMK,IAAQ,IAClEZ,IAAM;GAAE,GAAGe,EAAQ;GAAG,OAAOA,EAAQ;GAAO,GAAGA,EAAQ;GAAG;EAAE;EAClE,EAAS,KAAKd,EAAY,SAASD,CAAG,CAAC,CAAC;CAC1C;CACA,OAAOiB;AACT"}
@@ -0,0 +1,2 @@
1
+ var e={aliceblue:[240,248,255,1],antiquewhite:[250,235,215,1],aqua:[0,255,255,1],aquamarine:[127,255,212,1],azure:[240,255,255,1],beige:[245,245,220,1],bisque:[255,228,196,1],black:[0,0,0,1],blanchedalmond:[255,235,205,1],blue:[0,0,255,1],blueviolet:[138,43,226,1],brown:[165,42,42,1],burlywood:[222,184,135,1],cadetblue:[95,158,160,1],chartreuse:[127,255,0,1],chocolate:[210,105,30,1],coral:[255,127,80,1],cornflowerblue:[100,149,237,1],cornsilk:[255,248,220,1],crimson:[220,20,60,1],cyan:[0,255,255,1],darkblue:[0,0,139,1],darkcyan:[0,139,139,1],darkgoldenrod:[184,134,11,1],darkgray:[169,169,169,1],darkgreen:[0,100,0,1],darkkhaki:[189,183,107,1],darkmagenta:[139,0,139,1],darkolivegreen:[85,107,47,1],darkorange:[255,140,0,1],darkorchid:[153,50,204,1],darkred:[139,0,0,1],darksalmon:[233,150,122,1],darkseagreen:[143,188,143,1],darkslateblue:[72,61,139,1],darkslategray:[47,79,79,1],darkturquoise:[0,206,209,1],darkviolet:[148,0,211,1],deeppink:[255,20,147,1],deepskyblue:[0,191,255,1],dimgray:[105,105,105,1],dodgerblue:[30,144,255,1],firebrick:[178,34,34,1],floralwhite:[255,250,240,1],forestgreen:[34,139,34,1],fuchsia:[255,0,255,1],gainsboro:[220,220,220,1],ghostwhite:[248,248,255,1],gold:[255,215,0,1],goldenrod:[219,112,5,1],gray:[128,128,128,1],green:[0,128,0,1],greenyellow:[173,255,47,1],honeydew:[240,255,240,1],hotpink:[255,105,180,1],indianred:[205,92,92,1],indigo:[75,0,130,1],ivory:[255,255,240,1],khaki:[240,230,140,1],lavender:[230,230,250,1],lavenderblush:[255,240,245,1],lawngreen:[124,252,0,1],lemonchiffon:[255,250,205,1],lightblue:[173,216,230,1],lightcoral:[240,128,128,1],lightcyan:[224,255,255,1],lightgoldenrodyellow:[250,250,210,1],lightgray:[211,211,211,1],lightgreen:[144,238,144,1],lightpink:[255,182,193,1],lightsalmon:[255,160,122,1],lightseagreen:[32,178,170,1],lightskyblue:[135,206,250,1],lightslategray:[119,136,153,1],lightsteelblue:[176,196,222,1],lightyellow:[255,255,224,1],lime:[0,255,0,1],limegreen:[50,205,50,1],linen:[250,240,230,1],magenta:[255,0,255,1],maroon:[128,0,0,1],mediumaquamarine:[102,205,170,1],mediumblue:[0,0,205,1],mediumorchid:[186,85,211,1],mediumpurple:[147,112,219,1],mediumseagreen:[60,179,113,1],mediumslateblue:[123,104,238,1],mediumspringgreen:[0,250,154,1],mediumturquoise:[72,209,204,1],mediumvioletred:[199,21,133,1],midnightblue:[25,25,112,1],mintcream:[245,255,250,1],mistyrose:[255,228,225,1],moccasin:[255,228,181,1],navajowhite:[255,222,173,1],navy:[0,0,128,1],oldlace:[253,245,230,1],olive:[128,128,0,1],olivedrab:[107,142,35,1],orange:[255,165,0,1],orangered:[255,69,0,1],orchid:[218,112,214,1],palegoldenrod:[238,232,170,1],palegreen:[152,251,152,1],paleturquoise:[175,238,238,1],palevioletred:[219,112,147,1],papayawhip:[255,239,213,1],peachpuff:[255,218,185,1],peru:[205,133,63,1],pink:[255,192,203,1],plum:[221,160,221,1],powderblue:[176,224,230,1],purple:[128,0,128,1],rebeccapurple:[102,51,153,1],red:[255,0,0,1],rosybrown:[188,143,143,1],royalblue:[65,105,225,1],saddlebrown:[139,69,19,1],salmon:[250,128,114,1],sandybrown:[244,164,96,1],seagreen:[46,139,87,1],seashell:[255,245,238,1],sienna:[160,82,45,1],silver:[192,192,192,1],skyblue:[135,206,235,1],slateblue:[106,90,205,1],slategray:[112,128,144,1],snow:[255,250,250,1],springgreen:[0,255,127,1],steelblue:[70,130,180,1],tan:[210,180,140,1],teal:[0,128,128,1],thistle:[216,191,216,1],tomato:[255,99,71,1],transparent:[0,0,0,0],turquoise:[64,224,208,1],violet:[238,130,238,1],wheat:[245,222,179,1],white:[255,255,255,1],whitesmoke:[245,245,245,1],yellow:[255,255,0,1],yellowgreen:[154,205,50,1]};function parseNamedColor(t){return e[t.toLowerCase()]}exports.parseNamedColor=parseNamedColor;
2
+ //# sourceMappingURL=named-colors.cjs.map