@soybeanjs/colord 0.0.7 → 0.0.8

package/dist/plugins/mix.js

@@ -1,9 +1,9 @@
-import "../utils-CshL9w1R.js";
-import "../rgb-BVkoWOmR.js";
-import "../hsv-OOAVcaRH.js";
-import { i as mix } from "../manipulate-DCHNBCkU.js";
-import "../xyz-DsYRwYO_.js";
-import "../lab-9NsKpGel.js";
+import "../utils-BhDL0kto.js";
+import "../rgb-BIWjP3hJ.js";
+import "../hsv-6f-Avk00.js";
+import { i as mix } from "../manipulate-DJ-cBonL.js";
+import "../xyz-Czd8MTub.js";
+import "../lab-DklZwOkG.js";
 
 //#region src/plugins/mix.ts
 /**

package/dist/plugins/names.d.ts

@@ -1,4 +1,4 @@
-import { t as Plugin } from "../extend-D_jQFvDk.js";
+import { t as Plugin } from "../extend-DmcZT4-q.js";
 
 //#region src/plugins/names.d.ts
 interface ConvertOptions {

package/dist/plugins/oklab.d.ts

@@ -1,5 +1,5 @@
-import { f as OklabColor } from "../colord-Dc09uNcG.js";
-import { t as Plugin } from "../extend-D_jQFvDk.js";
+import { f as OklabColor } from "../types-B93dJkfp.js";
+import { t as Plugin } from "../extend-DmcZT4-q.js";
 
 //#region src/plugins/oklab.d.ts
 declare module '@soybeanjs/colord' {

package/dist/plugins/oklab.js

@@ -1,5 +1,5 @@
-import { _ as OKLAB_M2_INV, a as mul3x3, c as parseValueToDecimal, g as OKLAB_M2, h as OKLAB_M1_INV, i as isPresent, l as round, m as OKLAB_M1, o as parseAlpha, t as clamp, v as ALPHA_PRECISION } from "../utils-CshL9w1R.js";
-import { n as clampRgb, o as rgbToLinearRgb, r as linearRgbToRgb, t as clampLinearRgb } from "../rgb-BVkoWOmR.js";
+import { _ as OKLAB_M2_INV, a as mul3x3, c as parseValueToDecimal, g as OKLAB_M2, h as OKLAB_M1_INV, i as isPresent, l as round, m as OKLAB_M1, o as parseAlpha, t as clamp, v as ALPHA_PRECISION } from "../utils-BhDL0kto.js";
+import { n as clampRgb, o as rgbToLinearRgb, r as linearRgbToRgb, t as clampLinearRgb } from "../rgb-BIWjP3hJ.js";
 
 //#region src/models/oklab.ts
 const clampOklab = (oklab) => {

package/dist/plugins/oklch.d.ts

@@ -1,5 +1,5 @@
-import { p as OklchColor } from "../colord-Dc09uNcG.js";
-import { t as Plugin } from "../extend-D_jQFvDk.js";
+import { p as OklchColor } from "../types-B93dJkfp.js";
+import { t as Plugin } from "../extend-DmcZT4-q.js";
 
 //#region src/plugins/oklch.d.ts
 declare module '@soybeanjs/colord' {

package/dist/plugins/oklch.js

@@ -1,186 +1,5 @@
-import { _ as OKLAB_M2_INV, a as mul3x3, c as parseValueToDecimal, g as OKLAB_M2, h as OKLAB_M1_INV, i as isPresent, l as round, m as OKLAB_M1, n as clampHue, o as parseAlpha, s as parseHue, t as clamp, v as ALPHA_PRECISION } from "../utils-CshL9w1R.js";
-import { n as clampRgb, o as rgbToLinearRgb, r as linearRgbToRgb, t as clampLinearRgb } from "../rgb-BVkoWOmR.js";
+import "../utils-BhDL0kto.js";
+import "../rgb-BIWjP3hJ.js";
+import { n as oklch_default, t as oklchPlugin } from "../oklch-sYjVoJRG.js";
 
-//#region src/models/oklch.ts
-const clampOklch = (oklch) => {
-	const { l, c, h, alpha } = oklch;
-	return {
-		l: clamp(l, 0, 1),
-		c: clamp(c, 0, .37),
-		h: clampHue(h),
-		alpha: clamp(alpha)
-	};
-};
-const roundOklch = (oklch) => {
-	const { l, c, h, alpha } = oklch;
-	return {
-		l: round(l, 3),
-		c: round(c, 3),
-		h: round(h, 3),
-		alpha: round(alpha, ALPHA_PRECISION)
-	};
-};
-/**
-* Convert OKLCH to Linear RGB without gamut mapping
-*/
-const oklchToLinearRgb = (oklch) => {
-	const { l, c, h, alpha } = oklch;
-	const hRad = h * Math.PI / 180;
-	const [r, g, b] = mul3x3(OKLAB_M1_INV, mul3x3(OKLAB_M2_INV, [
-		l,
-		c * Math.cos(hRad),
-		c * Math.sin(hRad)
-	]).map((v) => v * v * v));
-	return {
-		r,
-		g,
-		b,
-		alpha
-	};
-};
-/**
-* Check if a linear RGB color is within sRGB gamut
-*/
-const isInGamut = (linearRgb, epsilon = 1e-6) => {
-	return linearRgb.r >= -epsilon && linearRgb.r <= 1 + epsilon && linearRgb.g >= -epsilon && linearRgb.g <= 1 + epsilon && linearRgb.b >= -epsilon && linearRgb.b <= 1 + epsilon;
-};
-/**
-* Binary search to find maximum chroma that fits in sRGB gamut
-* @param l - Lightness (0-1)
-* @param h - Hue (0-360)
-* @param alpha - Alpha (0-1)
-* @returns Maximum chroma that fits in sRGB gamut
-*/
-const findGamutChroma = (l, h, alpha) => {
-	let min = 0;
-	let max = .37;
-	const epsilon = 1e-5;
-	if (isInGamut(oklchToLinearRgb({
-		l,
-		c: max,
-		h,
-		alpha
-	}), epsilon)) return max;
-	while (max - min > epsilon) {
-		const mid = (min + max) / 2;
-		if (isInGamut(oklchToLinearRgb({
-			l,
-			c: mid,
-			h,
-			alpha
-		}), epsilon)) min = mid;
-		else max = mid;
-	}
-	return min;
-};
-const oklchToRgb = (oklch) => {
-	const { l, h, alpha } = oklch;
-	let linearRgb = oklchToLinearRgb(oklch);
-	if (!isInGamut(linearRgb)) linearRgb = oklchToLinearRgb({
-		l,
-		c: findGamutChroma(l, h, alpha),
-		h,
-		alpha
-	});
-	linearRgb = clampLinearRgb(linearRgb);
-	return clampRgb(linearRgbToRgb(linearRgb));
-};
-const rgbToOklch = (rgb) => {
-	const lRgb = rgbToLinearRgb(rgb);
-	const [l, a, b] = mul3x3(OKLAB_M2, mul3x3(OKLAB_M1, [
-		lRgb.r,
-		lRgb.g,
-		lRgb.b
-	]).map((v) => Math.cbrt(v)));
-	const chroma = Math.sqrt(a * a + b * b);
-	let hue;
-	if (chroma < 1e-4) hue = 0;
-	else {
-		hue = Math.atan2(b, a) * (180 / Math.PI);
-		if (hue < 0) hue += 360;
-	}
-	return clampOklch({
-		l,
-		c: chroma,
-		h: hue,
-		alpha: rgb.alpha
-	});
-};
-const parseOklch = ({ l, c, h, alpha = 1 }) => {
-	if (!isPresent(l) || !isPresent(c) || !isPresent(h)) return null;
-	return clampOklch({
-		l: Number(l),
-		c: Number(c),
-		h: Number(h),
-		alpha: Number(alpha)
-	});
-};
-const parseOklchToRgb = (input) => {
-	const oklch = parseOklch(input);
-	if (!oklch) return null;
-	return oklchToRgb(oklch);
-};
-/**
-* Parsing syntax: oklch(L c h [/ alpha])
-* - L: <number|percentage>
-* - c: <number>
-* - h: <number>
-* - alpha: <number|percentage>
-*/
-const oklchMatcher = /^oklch\(\s*([+-]?[\d.]+)%?\s+([+-]?[\d.]+)\s+([+-]?[\d.]+)(deg|grad|rad|turn)?(?:\s*\/\s*([+-]?[\d.]+%?))?\s*\)$/i;
-const parseOklchString = (input) => {
-	const match = oklchMatcher.exec(input);
-	if (!match) return null;
-	const [_, l, c, h, unit, alpha] = match;
-	return clampOklch({
-		l: parseValueToDecimal(l),
-		c: Number.parseFloat(c),
-		h: parseHue(h, unit),
-		alpha: parseAlpha(alpha)
-	});
-};
-const parseOklchStringToRgb = (input) => {
-	const oklch = parseOklchString(input);
-	if (!oklch) return null;
-	return oklchToRgb(oklch);
-};
-const toOklchString = (oklch) => {
-	const { l, c, h, alpha } = roundOklch(oklch);
-	return alpha < 1 ? `oklch(${l} ${c} ${h} / ${alpha})` : `oklch(${l} ${c} ${h})`;
-};
-const rgbToOklchString = (rgb) => {
-	return toOklchString(rgbToOklch(rgb));
-};
-const parseOklchBySource = (source) => {
-	if (!source || source.format !== "oklch") return null;
-	const { input } = source;
-	if (typeof input === "string") return parseOklchString(input);
-	if (typeof input === "object") return parseOklch(input);
-	return null;
-};
-const toOklchStringBySource = (source) => {
-	const oklch = parseOklchBySource(source);
-	if (!oklch) return null;
-	return toOklchString(oklch);
-};
-
-//#endregion
-//#region src/plugins/oklch.ts
-/**
-* A plugin adding support for OKLCH colorspace.
-* https://bottosson.github.io/posts/oklab/
-*/
-const oklchPlugin = (ColordClass, parsers) => {
-	ColordClass.prototype.toOklch = function toOklch() {
-		return roundOklch(parseOklchBySource(this.getSource()) || rgbToOklch(this.rgb));
-	};
-	ColordClass.prototype.toOklchString = function toOklchString$1() {
-		return toOklchStringBySource(this.getSource()) || rgbToOklchString(this.rgb);
-	};
-	parsers.string.push([parseOklchStringToRgb, "oklch"]);
-	parsers.object.push([parseOklchToRgb, "oklch"]);
-};
-var oklch_default = oklchPlugin;
-
-//#endregion
 export { oklch_default as default, oklchPlugin };

package/dist/plugins/xyz.d.ts

@@ -1,5 +1,5 @@
-import { g as XyzColor } from "../colord-Dc09uNcG.js";
-import { t as Plugin } from "../extend-D_jQFvDk.js";
+import { b as XyzColor } from "../types-B93dJkfp.js";
+import { t as Plugin } from "../extend-DmcZT4-q.js";
 
 //#region src/plugins/xyz.d.ts
 declare module '@soybeanjs/colord' {

package/dist/plugins/xyz.js

@@ -1,6 +1,6 @@
-import "../utils-CshL9w1R.js";
-import "../rgb-BVkoWOmR.js";
-import { i as roundXyz, n as parseXyzToRgb, r as rgbToXyz, t as parseXyzBySource } from "../xyz-DsYRwYO_.js";
+import "../utils-BhDL0kto.js";
+import "../rgb-BIWjP3hJ.js";
+import { i as roundXyz, n as parseXyzToRgb, r as rgbToXyz, t as parseXyzBySource } from "../xyz-Czd8MTub.js";
 
 //#region src/plugins/xyz.ts
 /**

package/dist/{rgb-BVkoWOmR.js → rgb-BIWjP3hJ.js}

@@ -1,4 +1,4 @@
-import { i as isPresent, l as round, o as parseAlpha, t as clamp, v as ALPHA_PRECISION } from "./utils-CshL9w1R.js";
+import { i as isPresent, l as round, o as parseAlpha, t as clamp, v as ALPHA_PRECISION } from "./utils-BhDL0kto.js";
 
 //#region src/models/rgb.ts
 const clampRgb = (rgb) => {
@@ -140,7 +140,7 @@ function parseValue(str) {
 }
 const rgbToRgbString = (rgb) => {
 	const { r, g, b, alpha } = roundRgb(rgb);
-	return alpha < 1 ? `rgb(${r}, ${g}, ${b}, ${alpha})` : `rgb(${r}, ${g}, ${b})`;
+	return alpha < 1 ? `rgb(${r}, ${g}, ${b} / ${alpha})` : `rgb(${r}, ${g}, ${b})`;
 };
 
 //#endregion

package/dist/types-B93dJkfp.d.ts

@@ -0,0 +1,112 @@
+//#region src/types.d.ts
+type WithAlpha<O> = O & {
+  alpha: number;
+};
+type RgbColor = WithAlpha<{
+  r: number;
+  g: number;
+  b: number;
+}>;
+type HslColor = WithAlpha<{
+  h: number;
+  s: number;
+  l: number;
+}>;
+type HsvColor = WithAlpha<{
+  h: number;
+  s: number;
+  v: number;
+}>;
+type HwbColor = WithAlpha<{
+  h: number;
+  w: number;
+  b: number;
+}>;
+type XyzColor = WithAlpha<{
+  x: number;
+  y: number;
+  z: number;
+}>;
+type LabColor = WithAlpha<{
+  l: number;
+  a: number;
+  b: number;
+}>;
+type LchColor = WithAlpha<{
+  l: number;
+  c: number;
+  h: number;
+}>;
+type CmykColor = WithAlpha<{
+  c: number;
+  m: number;
+  y: number;
+  k: number;
+}>;
+type OklabColor = WithAlpha<{
+  l: number;
+  a: number;
+  b: number;
+}>;
+type OklchColor = WithAlpha<{
+  l: number;
+  c: number;
+  h: number;
+}>;
+type PartialAlpha<O> = Omit<O, 'alpha'> & {
+  alpha?: number;
+};
+type ObjectColor = PartialAlpha<RgbColor> | PartialAlpha<HslColor> | PartialAlpha<HsvColor> | PartialAlpha<HwbColor> | PartialAlpha<XyzColor> | PartialAlpha<LabColor> | PartialAlpha<LchColor> | PartialAlpha<CmykColor> | PartialAlpha<OklabColor> | PartialAlpha<OklchColor>;
+type AnyColor = string | ObjectColor;
+type InputObject = Record<string, unknown>;
+type Format = 'name' | 'hex' | 'rgb' | 'lrgb' | 'hsl' | 'hsv' | 'hwb' | 'xyz' | 'lab' | 'lch' | 'cmyk' | 'oklab' | 'oklch';
+type Input = string | InputObject;
+interface InputSource {
+  format: Format;
+  input: Input;
+}
+type ParseFunction<I extends Input> = (input: I) => RgbColor | null;
+type Parser<I extends Input> = [ParseFunction<I>, Format];
+type Parsers = {
+  string: Array<Parser<string>>;
+  object: Array<Parser<InputObject>>;
+};
+/**
+ * the palette color level
+ *
+ * the main color level is 500
+ */
+type PaletteColorLevel = 50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | 950;
+type TailwindPaletteColorKey = 'slate' | 'gray' | 'zinc' | 'neutral' | 'stone' | 'red' | 'orange' | 'amber' | 'yellow' | 'lime' | 'green' | 'emerald' | 'teal' | 'cyan' | 'sky' | 'blue' | 'indigo' | 'violet' | 'purple' | 'fuchsia' | 'pink' | 'rose';
+/**
+ * the tailwind palette color
+ *
+ * the color format is `oklch` string
+ */
+type TailwindPaletteColor = { [K in TailwindPaletteColorKey]: { [L in PaletteColorLevel]: string } };
+type OutputColorMap = {
+  hex: string;
+  rgb: RgbColor;
+  rgbString: string;
+  oklch: OklchColor;
+  oklchString: string;
+  hsl: HslColor;
+  hslString: string;
+};
+type OutputFormat = keyof OutputColorMap;
+interface NearestPalette<F extends OutputFormat> {
+  /** current color */
+  current: OutputColorMap[F];
+  /** palette color key */
+  paletteKey: TailwindPaletteColorKey;
+  /** palette level */
+  level: PaletteColorLevel;
+  /** palette color */
+  color: OutputColorMap[F];
+  /** the color delta value */
+  delta: number;
+  /** palette colors */
+  palette: Record<PaletteColorLevel, OutputColorMap[F]>;
+}
+//#endregion
+export { Parsers as _, HsvColor as a, XyzColor as b, InputSource as c, NearestPalette as d, OklabColor as f, PaletteColorLevel as g, OutputFormat as h, HslColor as i, LabColor as l, OutputColorMap as m, CmykColor as n, HwbColor as o, OklchColor as p, Format as r, Input as s, AnyColor as t, LchColor as u, RgbColor as v, TailwindPaletteColor as y };

package/dist/{xyz-DsYRwYO_.js → xyz-Czd8MTub.js}

@@ -1,5 +1,5 @@
-import { a as mul3x3, b as D65, f as M_SRGB_TO_XYZ_D65, i as isPresent, l as round, p as M_XYZ_D65_TO_SRGB, t as clamp, v as ALPHA_PRECISION } from "./utils-CshL9w1R.js";
-import { n as clampRgb, o as rgbToLinearRgb, r as linearRgbToRgb } from "./rgb-BVkoWOmR.js";
+import { a as mul3x3, b as D65, f as M_SRGB_TO_XYZ_D65, i as isPresent, l as round, p as M_XYZ_D65_TO_SRGB, t as clamp, v as ALPHA_PRECISION } from "./utils-BhDL0kto.js";
+import { n as clampRgb, o as rgbToLinearRgb, r as linearRgbToRgb } from "./rgb-BIWjP3hJ.js";
 
 //#region src/models/xyz.ts
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@soybeanjs/colord",
   "type": "module",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "A tiny yet powerful tool for high-performance color manipulations and conversions",
   "author": {
     "name": "Soybean",
@@ -25,6 +25,11 @@
       "import": "./dist/index.js",
       "require": "./dist/index.js"
     },
+    "./palette": {
+      "types": "./dist/palette/index.d.ts",
+      "import": "./dist/palette/index.js",
+      "require": "./dist/palette/index.js"
+    },
     "./plugins/*": {
       "types": "./dist/plugins/*.d.ts",
       "import": "./dist/plugins/*.js",