@tenphi/tasty 0.13.1 → 0.14.1

package/dist/utils/color-math.d.ts

@@ -0,0 +1,46 @@
+//#region src/utils/color-math.d.ts
+/**
+ * Consolidated color conversion math.
+ *
+ * Single source of truth for all color space conversions used across the
+ * library: sRGB gamma, HSL, OKLab, OKLCH, OKHSL, hex parsing, named
+ * colors, and CSS string converters.
+ *
+ * This module has zero internal imports — it is a leaf dependency.
+ *
+ * Reference: https://bottosson.github.io/posts/oklab/
+ */
+type Vec3 = [number, number, number];
+/**
+ * HSL to RGB.
+ * Algorithm from CSS Color 4 spec.
+ *
+ * @param h - Hue in degrees (0-360)
+ * @param s - Saturation (0-1)
+ * @param l - Lightness (0-1)
+ * @returns RGB values in 0-255 range (may have fractional values)
+ */
+declare function hslToRgbValues(h: number, s: number, l: number): Vec3;
+declare function getNamedColorHex(): Map<string, string>;
+/**
+ * Convert hex color string to `rgb()` CSS string.
+ * Supports 3, 4, 6, and 8 character hex values (with or without `#`).
+ */
+declare function hexToRgb(hex: string): string | null;
+/**
+ * Extract RGB values from an `rgb()`/`rgba()` string.
+ * Supports comma-separated, space-separated, fractional, percentage,
+ * and slash alpha notation.
+ *
+ * @returns Array of RGB values (0-255 range), converting percentages as needed.
+ */
+declare function getRgbValuesFromRgbaString(str: string): number[];
+/**
+ * Convert any recognized color string to an `rgb()` CSS string.
+ * Handles hex, `okhsl()`, `hsl()`/`hsla()`, named CSS colors,
+ * and `rgb()`/`rgba()` pass-through.
+ */
+declare function strToRgb(color: string, _ignoreAlpha?: boolean): string | null | undefined;
+//#endregion
+export { getNamedColorHex, getRgbValuesFromRgbaString, hexToRgb, hslToRgbValues, strToRgb };
+//# sourceMappingURL=color-math.d.ts.map