solid-tiny-utils 0.5.0 → 0.6.0

package/dist/{chunk-AKFEDWEF.js → chunk-6OVLJ45M.js}

@@ -1,15 +1,15 @@
 import {
   makeEventListener
-} from "./chunk-IQGRRDJZ.js";
+} from "./chunk-TGWWPUWD.js";
 import {
   noop
-} from "./chunk-D3JAYNG6.js";
-import {
-  createWatch
-} from "./chunk-4L6FK7MF.js";
+} from "./chunk-QPEF6LHH.js";
 import {
   access
 } from "./chunk-YK5QQQ43.js";
+import {
+  createWatch
+} from "./chunk-4L6FK7MF.js";
 import {
   clearArray
 } from "./chunk-BT47ISVC.js";

package/dist/chunk-ACZGS7DG.js

@@ -0,0 +1,72 @@
+import {
+  clamp,
+  max
+} from "./chunk-PD6VHMH6.js";
+
+// src/color/oklch-rgb.ts
+var PI_180 = Math.PI / 180;
+var INV_PI_180 = 180 / Math.PI;
+var linearToSRGB = (x) => x <= 31308e-7 ? 12.92 * x : 1.055 * x ** (1 / 2.4) - 0.055;
+var sRGBToLinear = (x) => x <= 0.04045 ? x / 12.92 : ((x + 0.055) / 1.055) ** 2.4;
+function normalizeHue(hue) {
+  return (hue % 360 + 360) % 360;
+}
+function oklchToRgb(oklch) {
+  const { l, c, h } = oklch;
+  const clampedL = clamp(l, 0, 1);
+  const clampedC = max(0, c);
+  const normalizedH = normalizeHue(h);
+  const a_ = clampedC * Math.cos(normalizedH * PI_180);
+  const b_ = clampedC * Math.sin(normalizedH * PI_180);
+  const L = clampedL;
+  const A = a_;
+  const B = b_;
+  const l_ = L + 0.3963377774 * A + 0.2158037573 * B;
+  const m_ = L - 0.1055613458 * A - 0.0638541728 * B;
+  const s_ = L - 0.0894841775 * A - 1.291485548 * B;
+  const l3 = l_ ** 3;
+  const m3 = m_ ** 3;
+  const s3 = s_ ** 3;
+  let r = 4.0767416621 * l3 - 3.3077115913 * m3 + 0.2309699292 * s3;
+  let g = -1.2684380046 * l3 + 2.6097574011 * m3 - 0.3413193965 * s3;
+  let b = -0.0041960863 * l3 - 0.7034186147 * m3 + 1.707614701 * s3;
+  r = linearToSRGB(r);
+  g = linearToSRGB(g);
+  b = linearToSRGB(b);
+  return {
+    r: Math.round(clamp(r) * 255),
+    g: Math.round(clamp(g) * 255),
+    b: Math.round(clamp(b) * 255)
+  };
+}
+function rgbToOklch(rgb) {
+  const r = clamp(rgb.r, 0, 255);
+  const g = clamp(rgb.g, 0, 255);
+  const b = clamp(rgb.b, 0, 255);
+  const rLinear = sRGBToLinear(r / 255);
+  const gLinear = sRGBToLinear(g / 255);
+  const bLinear = sRGBToLinear(b / 255);
+  const l_ = Math.cbrt(
+    0.4122214708 * rLinear + 0.5363325363 * gLinear + 0.0514459929 * bLinear
+  );
+  const m_ = Math.cbrt(
+    0.2119034982 * rLinear + 0.6806995451 * gLinear + 0.1073969566 * bLinear
+  );
+  const s_ = Math.cbrt(
+    0.0883024619 * rLinear + 0.2817188376 * gLinear + 0.6299787005 * bLinear
+  );
+  const L = 0.2104542553 * l_ + 0.793617785 * m_ - 0.0040720468 * s_;
+  const A = 1.9779984951 * l_ - 2.428592205 * m_ + 0.4505937099 * s_;
+  const B = 0.0259040371 * l_ + 0.7827717662 * m_ - 0.808675766 * s_;
+  const c = Math.sqrt(A * A + B * B);
+  let h = Math.atan2(B, A) * INV_PI_180;
+  if (h < 0) {
+    h += 360;
+  }
+  return { l: L, c, h };
+}
+
+export {
+  oklchToRgb,
+  rgbToOklch
+};

package/dist/chunk-KFLH3AZ6.js

@@ -0,0 +1,40 @@
+import {
+  isArray
+} from "./chunk-6G7GFZV2.js";
+import {
+  clamp,
+  toHex
+} from "./chunk-PD6VHMH6.js";
+
+// src/color/hex-rgb.ts
+var HEX_PREFIX_REGEX = /^#/;
+var HEX_VALIDATION_REGEX = /^[0-9a-fA-F]{6}$/;
+function hexToRgb(hex) {
+  if (!hex || typeof hex !== "string") {
+    return null;
+  }
+  let value = hex.trim().replace(HEX_PREFIX_REGEX, "");
+  if (value.length === 3) {
+    value = value.split("").map((c) => c + c).join("");
+  }
+  if (!HEX_VALIDATION_REGEX.test(value)) {
+    return null;
+  }
+  const r = Number.parseInt(value.slice(0, 2), 16);
+  const g = Number.parseInt(value.slice(2, 4), 16);
+  const b = Number.parseInt(value.slice(4, 6), 16);
+  return { r, g, b };
+}
+function rgbToHex(rgb) {
+  const c = (v) => Math.round(clamp(v, 0, 255));
+  const rgb_ = isArray(rgb) ? rgb : [rgb.r, rgb.g, rgb.b];
+  const r = c(rgb_[0]);
+  const g = c(rgb_[1]);
+  const b = c(rgb_[2]);
+  return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+
+export {
+  hexToRgb,
+  rgbToHex
+};

package/dist/{chunk-GHJDTAVH.js → chunk-LEWF7QAQ.js}

@@ -1,12 +1,12 @@
 import {
   noop
-} from "./chunk-D3JAYNG6.js";
-import {
-  createWatch
-} from "./chunk-4L6FK7MF.js";
+} from "./chunk-QPEF6LHH.js";
 import {
   access
 } from "./chunk-YK5QQQ43.js";
+import {
+  createWatch
+} from "./chunk-4L6FK7MF.js";
 import {
   clearArray
 } from "./chunk-BT47ISVC.js";

package/dist/chunk-PD6VHMH6.js

@@ -0,0 +1,26 @@
+// src/utils/number.ts
+function min(...numbers) {
+  return Math.min(...numbers);
+}
+function max(...numbers) {
+  return Math.max(...numbers);
+}
+function clamp(x, minimum = 0, maximum = 1) {
+  return min(maximum, max(minimum, x));
+}
+function inRange(x, minimum = 0, maximum = 1, inclusivity = "[]") {
+  const minCheck = inclusivity[0] === "[" ? x >= minimum : x > minimum;
+  const maxCheck = inclusivity[1] === "]" ? x <= maximum : x < maximum;
+  return minCheck && maxCheck;
+}
+function toHex(x, pad = 2) {
+  return x.toString(16).padStart(pad, "0");
+}
+
+export {
+  min,
+  max,
+  clamp,
+  inRange,
+  toHex
+};

package/dist/chunk-S7U3LZNS.js

@@ -0,0 +1,23 @@
+import {
+  hexToRgb
+} from "./chunk-KFLH3AZ6.js";
+import {
+  inRange
+} from "./chunk-PD6VHMH6.js";
+
+// src/color/validation.ts
+function isValidRGB(rgb) {
+  return Object.values(rgb).every((x) => inRange(x, 0, 255));
+}
+function isValidOKLCH(oklch) {
+  return inRange(oklch.l) && oklch.c >= 0 && inRange(oklch.h, 0, 360);
+}
+function isValidHex(hex) {
+  return hexToRgb(hex) !== null;
+}
+
+export {
+  isValidRGB,
+  isValidOKLCH,
+  isValidHex
+};

package/dist/{chunk-IQGRRDJZ.js → chunk-TGWWPUWD.js}

@@ -1,6 +1,6 @@
 import {
   noop
-} from "./chunk-D3JAYNG6.js";
+} from "./chunk-QPEF6LHH.js";
 import {
   clearArray
 } from "./chunk-BT47ISVC.js";

package/dist/{chunk-DV7LISIY.js → chunk-WJHRONQU.js}

@@ -1,6 +1,6 @@
 import {
   makeEventListener
-} from "./chunk-IQGRRDJZ.js";
+} from "./chunk-TGWWPUWD.js";
 import {
   access
 } from "./chunk-YK5QQQ43.js";

package/dist/color/hex-rgb.d.ts

@@ -0,0 +1,36 @@
+import { RGB } from './oklch-rgb.js';
+
+/**
+ * Converts a hex color string to RGB color values.
+ *
+ * Supports both 3-digit (#rgb) and 6-digit (#rrggbb) hex formats.
+ * The hash symbol (#) is optional.
+ *
+ * @param hex - Hex color string (e.g., "#ffcc00", "ffcc00", "#fc0", "fc0")
+ * @returns RGB object with r, g, b values (0-255), or null if invalid
+ *
+ * @example
+ * ```typescript
+ * hexToRgb("#ffcc00") // => { r: 255, g: 204, b: 0 }
+ * hexToRgb("fc0")     // => { r: 255, g: 204, b: 0 }
+ * hexToRgb("#invalid") // => null
+ * ```
+ */
+declare function hexToRgb(hex: string): RGB | null;
+/**
+ * Converts RGB color values to a hex color string.
+ *
+ * RGB values are automatically clamped to the 0-255 range.
+ *
+ * @param rgb - RGB object with r, g, b values
+ * @returns Hex color string with # prefix (e.g., "#ffcc00")
+ *
+ * @example
+ * ```typescript
+ * rgbToHex({ r: 255, g: 204, b: 0 }) // => "#ffcc00"
+ * rgbToHex({ r: 300, g: -10, b: 128 }) // => "#ff0080" (clamped values)
+ * ```
+ */
+declare function rgbToHex(rgb: RGB | [number, number, number]): string;
+
+export { hexToRgb, rgbToHex };

package/dist/color/hex-rgb.js

@@ -0,0 +1,15 @@
+import {
+  hexToRgb,
+  rgbToHex
+} from "../chunk-KFLH3AZ6.js";
+import "../chunk-U5LQ2AS5.js";
+import "../chunk-QQVSG76Z.js";
+import "../chunk-Y4GYGFIT.js";
+import "../chunk-BT47ISVC.js";
+import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
+export {
+  hexToRgb,
+  rgbToHex
+};

package/dist/color/index.d.ts

@@ -0,0 +1,3 @@
+export { hexToRgb, rgbToHex } from './hex-rgb.js';
+export { OKLCH, RGB, oklchToRgb, rgbToOklch } from './oklch-rgb.js';
+export { isValidHex, isValidOKLCH, isValidRGB } from './validation.js';

package/dist/color/index.js

@@ -0,0 +1,30 @@
+import "../chunk-BLX3XSA6.js";
+import {
+  oklchToRgb,
+  rgbToOklch
+} from "../chunk-ACZGS7DG.js";
+import {
+  isValidHex,
+  isValidOKLCH,
+  isValidRGB
+} from "../chunk-S7U3LZNS.js";
+import {
+  hexToRgb,
+  rgbToHex
+} from "../chunk-KFLH3AZ6.js";
+import "../chunk-U5LQ2AS5.js";
+import "../chunk-QQVSG76Z.js";
+import "../chunk-Y4GYGFIT.js";
+import "../chunk-BT47ISVC.js";
+import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
+export {
+  hexToRgb,
+  isValidHex,
+  isValidOKLCH,
+  isValidRGB,
+  oklchToRgb,
+  rgbToHex,
+  rgbToOklch
+};

package/dist/color/oklch-rgb.d.ts

@@ -0,0 +1,49 @@
+interface RGB {
+    r: number;
+    g: number;
+    b: number;
+}
+interface OKLCH {
+    l: number;
+    c: number;
+    h: number;
+}
+/**
+ * Converts OKLCH color to RGB color space.
+ *
+ * OKLCH is a perceptually uniform color space based on OKLab.
+ * Input values are automatically clamped to valid ranges.
+ *
+ * @param oklch - The OKLCH color to convert
+ * @param oklch.l - Lightness (0-1, will be clamped)
+ * @param oklch.c - Chroma (≥0, will be clamped)
+ * @param oklch.h - Hue in degrees (will be normalized to 0-360)
+ * @returns RGB color with values 0-255
+ *
+ * @example
+ * ```typescript
+ * const rgb = oklchToRgb({ l: 0.7, c: 0.1, h: 200 });
+ * // => { r: 64, g: 177, b: 183 }
+ * ```
+ */
+declare function oklchToRgb(oklch: OKLCH): RGB;
+/**
+ * Converts RGB color to OKLCH color space.
+ *
+ * RGB values are automatically clamped to 0-255 range.
+ *
+ * @param rgb - The RGB color to convert
+ * @param rgb.r - Red component (0-255, will be clamped)
+ * @param rgb.g - Green component (0-255, will be clamped)
+ * @param rgb.b - Blue component (0-255, will be clamped)
+ * @returns OKLCH color with l∈[0,1], c≥0, h∈[0,360)
+ *
+ * @example
+ * ```typescript
+ * const oklch = rgbToOklch({ r: 64, g: 177, b: 183 });
+ * // => { l: 0.7, c: 0.1, h: 200 }
+ * ```
+ */
+declare function rgbToOklch(rgb: RGB): OKLCH;
+
+export { type OKLCH, type RGB, oklchToRgb, rgbToOklch };

package/dist/color/oklch-rgb.js

@@ -0,0 +1,15 @@
+import {
+  oklchToRgb,
+  rgbToOklch
+} from "../chunk-ACZGS7DG.js";
+import "../chunk-U5LQ2AS5.js";
+import "../chunk-QQVSG76Z.js";
+import "../chunk-Y4GYGFIT.js";
+import "../chunk-BT47ISVC.js";
+import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
+export {
+  oklchToRgb,
+  rgbToOklch
+};

package/dist/color/validation.d.ts

@@ -0,0 +1,26 @@
+import { RGB, OKLCH } from './oklch-rgb.js';
+
+/**
+ * Checks if RGB values are in valid range (0-255)
+ */
+declare function isValidRGB(rgb: RGB): boolean;
+/**
+ * Checks if OKLCH values are in valid ranges
+ */
+declare function isValidOKLCH(oklch: OKLCH): boolean;
+/**
+ * Checks if a string is a valid hex color format.
+ *
+ * @param hex - String to validate
+ * @returns `true` if the string is a valid hex color, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidHex("#ffcc00") // => true
+ * isValidHex("fc0")     // => true
+ * isValidHex("#invalid") // => false
+ * ```
+ */
+declare function isValidHex(hex: string): boolean;
+
+export { isValidHex, isValidOKLCH, isValidRGB };

package/dist/color/validation.js

@@ -0,0 +1,18 @@
+import {
+  isValidHex,
+  isValidOKLCH,
+  isValidRGB
+} from "../chunk-S7U3LZNS.js";
+import "../chunk-KFLH3AZ6.js";
+import "../chunk-U5LQ2AS5.js";
+import "../chunk-QQVSG76Z.js";
+import "../chunk-Y4GYGFIT.js";
+import "../chunk-BT47ISVC.js";
+import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
+export {
+  isValidHex,
+  isValidOKLCH,
+  isValidRGB
+};

package/dist/dom/css.js

@@ -3,12 +3,13 @@ import {
   mountStyle,
   stringStyleToObject
 } from "../chunk-DKZ3RJJI.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   combineStyle,
   mountStyle,

package/dist/dom/index.js

@@ -4,12 +4,13 @@ import {
   mountStyle,
   stringStyleToObject
 } from "../chunk-DKZ3RJJI.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   combineStyle,
   mountStyle,

package/dist/event/create-click-outside.js

@@ -1,16 +1,17 @@
 import {
   createClickOutside
-} from "../chunk-DV7LISIY.js";
-import "../chunk-IQGRRDJZ.js";
-import "../chunk-D3JAYNG6.js";
-import "../chunk-4L6FK7MF.js";
+} from "../chunk-WJHRONQU.js";
+import "../chunk-TGWWPUWD.js";
+import "../chunk-QPEF6LHH.js";
 import "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   createClickOutside
 };

package/dist/event/create-event-listener.js

@@ -1,16 +1,17 @@
 import {
   createEventListener
-} from "../chunk-AKFEDWEF.js";
-import "../chunk-IQGRRDJZ.js";
-import "../chunk-D3JAYNG6.js";
-import "../chunk-4L6FK7MF.js";
+} from "../chunk-6OVLJ45M.js";
+import "../chunk-TGWWPUWD.js";
+import "../chunk-QPEF6LHH.js";
 import "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   createEventListener
 };

package/dist/event/create-intersection-observer.js

@@ -1,15 +1,16 @@
 import {
   createIntersectionObserver
-} from "../chunk-GHJDTAVH.js";
-import "../chunk-D3JAYNG6.js";
-import "../chunk-4L6FK7MF.js";
+} from "../chunk-LEWF7QAQ.js";
+import "../chunk-QPEF6LHH.js";
 import "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   createIntersectionObserver
 };

package/dist/event/create-visibility-observer.js

@@ -1,15 +1,16 @@
 import {
   createVisibilityObserver
-} from "../chunk-WWEM5VJO.js";
-import "../chunk-D3JAYNG6.js";
-import "../chunk-4L6FK7MF.js";
+} from "../chunk-TDJLPDJF.js";
+import "../chunk-QPEF6LHH.js";
 import "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   createVisibilityObserver
 };

package/dist/event/index.js

@@ -1,28 +1,29 @@
 import "../chunk-LUFOWTRW.js";
 import {
   createClickOutside
-} from "../chunk-DV7LISIY.js";
+} from "../chunk-WJHRONQU.js";
 import {
   createEventListener
-} from "../chunk-AKFEDWEF.js";
+} from "../chunk-6OVLJ45M.js";
 import {
   makeEventListener
-} from "../chunk-IQGRRDJZ.js";
+} from "../chunk-TGWWPUWD.js";
 import {
   createIntersectionObserver
-} from "../chunk-GHJDTAVH.js";
+} from "../chunk-LEWF7QAQ.js";
 import {
   createVisibilityObserver
-} from "../chunk-WWEM5VJO.js";
-import "../chunk-D3JAYNG6.js";
-import "../chunk-4L6FK7MF.js";
+} from "../chunk-TDJLPDJF.js";
+import "../chunk-QPEF6LHH.js";
 import "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   createClickOutside,
   createEventListener,

package/dist/event/make-event-listener.js

@@ -1,15 +1,16 @@
 import {
   makeEventListener
-} from "../chunk-IQGRRDJZ.js";
-import "../chunk-D3JAYNG6.js";
-import "../chunk-4L6FK7MF.js";
+} from "../chunk-TGWWPUWD.js";
+import "../chunk-QPEF6LHH.js";
 import "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   makeEventListener
 };

package/dist/fn/create-debounce.js

@@ -1,14 +1,15 @@
 import {
   createDebounce
-} from "../chunk-D3JAYNG6.js";
-import "../chunk-4L6FK7MF.js";
+} from "../chunk-QPEF6LHH.js";
 import "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   createDebounce
 };

package/dist/fn/create-loop-exec.js

@@ -1,14 +1,15 @@
 import {
   createLoopExec
-} from "../chunk-D3JAYNG6.js";
-import "../chunk-4L6FK7MF.js";
+} from "../chunk-QPEF6LHH.js";
 import "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   createLoopExec
 };

package/dist/fn/create-throttle.js

@@ -1,14 +1,15 @@
 import {
   createThrottle
-} from "../chunk-D3JAYNG6.js";
-import "../chunk-4L6FK7MF.js";
+} from "../chunk-QPEF6LHH.js";
 import "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   createThrottle
 };

package/dist/fn/index.js

@@ -3,15 +3,16 @@ import {
   createLoopExec,
   createThrottle,
   noop
-} from "../chunk-D3JAYNG6.js";
-import "../chunk-4L6FK7MF.js";
+} from "../chunk-QPEF6LHH.js";
 import "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   createDebounce,
   createLoopExec,

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+export { hexToRgb, rgbToHex } from './color/hex-rgb.js';
+export { OKLCH, RGB, oklchToRgb, rgbToOklch } from './color/oklch-rgb.js';
+export { isValidHex, isValidOKLCH, isValidRGB } from './color/validation.js';
 export { combineStyle, mountStyle, stringStyleToObject } from './dom/css.js';
 export { createClickOutside } from './event/create-click-outside.js';
 export { createEventListener } from './event/create-event-listener.js';
@@ -14,6 +17,7 @@ export { MaybeAccessor, MaybeArray, MaybeNullableAccessor, MaybePromise } from '
 export { clearArray, iterate, list, range } from './utils/array.js';
 export { sleep } from './utils/async.js';
 export { isArray, isClient, isDate, isEmpty, isFloat, isFn, isInt, isNumber, isObject, isPrimitive, isPromise, isString, isSymbol } from './utils/is.js';
+export { clamp, inRange, max, min, toHex } from './utils/number.js';
 export { draw, random, shuffle, uid } from './utils/random.js';
 export { camel, capitalize, dash, pascal, snake, template, title, trim } from './utils/str.js';
 export { createDebounce } from './fn/create-debounce.js';

package/dist/index.js

@@ -1,46 +1,60 @@
 import "./chunk-SK6Y2YH6.js";
-import "./chunk-AZAXMGEB.js";
 import "./chunk-EZML2DEC.js";
 import "./chunk-YXRZ2KMJ.js";
 import {
   dataIf
 } from "./chunk-II6INKPZ.js";
-import "./chunk-FFBJP5FE.js";
-import {
-  combineStyle,
-  mountStyle,
-  stringStyleToObject
-} from "./chunk-DKZ3RJJI.js";
+import "./chunk-AZAXMGEB.js";
 import "./chunk-LUFOWTRW.js";
 import {
   createClickOutside
-} from "./chunk-DV7LISIY.js";
+} from "./chunk-WJHRONQU.js";
 import {
   createEventListener
-} from "./chunk-AKFEDWEF.js";
+} from "./chunk-6OVLJ45M.js";
 import {
   makeEventListener
-} from "./chunk-IQGRRDJZ.js";
+} from "./chunk-TGWWPUWD.js";
 import {
   createIntersectionObserver
-} from "./chunk-GHJDTAVH.js";
+} from "./chunk-LEWF7QAQ.js";
 import {
   createVisibilityObserver
-} from "./chunk-WWEM5VJO.js";
+} from "./chunk-TDJLPDJF.js";
+import "./chunk-BLX3XSA6.js";
+import {
+  oklchToRgb,
+  rgbToOklch
+} from "./chunk-ACZGS7DG.js";
+import {
+  isValidHex,
+  isValidOKLCH,
+  isValidRGB
+} from "./chunk-S7U3LZNS.js";
+import {
+  hexToRgb,
+  rgbToHex
+} from "./chunk-KFLH3AZ6.js";
+import "./chunk-FFBJP5FE.js";
+import {
+  combineStyle,
+  mountStyle,
+  stringStyleToObject
+} from "./chunk-DKZ3RJJI.js";
 import {
   createDebounce,
   createDebouncedWatch,
   createLoopExec,
   createThrottle,
   noop
-} from "./chunk-D3JAYNG6.js";
-import {
-  createWatch
-} from "./chunk-4L6FK7MF.js";
+} from "./chunk-QPEF6LHH.js";
 import {
   access
 } from "./chunk-YK5QQQ43.js";
-import "./chunk-MEZ7CXEG.js";
+import {
+  createWatch
+} from "./chunk-4L6FK7MF.js";
+import "./chunk-U5LQ2AS5.js";
 import {
   draw,
   random,
@@ -63,6 +77,9 @@ import {
   list,
   range
 } from "./chunk-BT47ISVC.js";
+import {
+  sleep
+} from "./chunk-KKFGUHFR.js";
 import {
   isArray,
   isClient,
@@ -79,12 +96,17 @@ import {
   isSymbol
 } from "./chunk-6G7GFZV2.js";
 import {
-  sleep
-} from "./chunk-KKFGUHFR.js";
+  clamp,
+  inRange,
+  max,
+  min,
+  toHex
+} from "./chunk-PD6VHMH6.js";
 export {
   access,
   camel,
   capitalize,
+  clamp,
   clearArray,
   combineStyle,
   createClickOutside,
@@ -99,6 +121,8 @@ export {
   dash,
   dataIf,
   draw,
+  hexToRgb,
+  inRange,
   isArray,
   isClient,
   isDate,
@@ -112,20 +136,29 @@ export {
   isPromise,
   isString,
   isSymbol,
+  isValidHex,
+  isValidOKLCH,
+  isValidRGB,
   iterate,
   list,
   makeEventListener,
+  max,
+  min,
   mountStyle,
   noop,
+  oklchToRgb,
   pascal,
   random,
   range,
+  rgbToHex,
+  rgbToOklch,
   shuffle,
   sleep,
   snake,
   stringStyleToObject,
   template,
   title,
+  toHex,
   trim,
   uid
 };

package/dist/reactive/access.js

@@ -1,12 +1,13 @@
 import {
   access
 } from "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   access
 };

package/dist/reactive/create-debounce-watch.js

@@ -1,14 +1,15 @@
 import {
   createDebouncedWatch
-} from "../chunk-D3JAYNG6.js";
-import "../chunk-4L6FK7MF.js";
+} from "../chunk-QPEF6LHH.js";
 import "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   createDebouncedWatch
 };

package/dist/reactive/index.js

@@ -1,18 +1,19 @@
 import {
   createDebouncedWatch
-} from "../chunk-D3JAYNG6.js";
-import {
-  createWatch
-} from "../chunk-4L6FK7MF.js";
+} from "../chunk-QPEF6LHH.js";
 import {
   access
 } from "../chunk-YK5QQQ43.js";
-import "../chunk-MEZ7CXEG.js";
+import {
+  createWatch
+} from "../chunk-4L6FK7MF.js";
+import "../chunk-U5LQ2AS5.js";
 import "../chunk-QQVSG76Z.js";
 import "../chunk-Y4GYGFIT.js";
 import "../chunk-BT47ISVC.js";
-import "../chunk-6G7GFZV2.js";
 import "../chunk-KKFGUHFR.js";
+import "../chunk-6G7GFZV2.js";
+import "../chunk-PD6VHMH6.js";
 export {
   access,
   createDebouncedWatch,

package/dist/types/index.js

@@ -1,3 +1,3 @@
 import "../chunk-SK6Y2YH6.js";
-import "../chunk-AZAXMGEB.js";
 import "../chunk-EZML2DEC.js";
+import "../chunk-AZAXMGEB.js";

package/dist/utils/index.d.ts

@@ -1,5 +1,6 @@
 export { clearArray, iterate, list, range } from './array.js';
 export { sleep } from './async.js';
 export { isArray, isClient, isDate, isEmpty, isFloat, isFn, isInt, isNumber, isObject, isPrimitive, isPromise, isString, isSymbol } from './is.js';
+export { clamp, inRange, max, min, toHex } from './number.js';
 export { draw, random, shuffle, uid } from './random.js';
 export { camel, capitalize, dash, pascal, snake, template, title, trim } from './str.js';

package/dist/utils/index.js

@@ -1,4 +1,4 @@
-import "../chunk-MEZ7CXEG.js";
+import "../chunk-U5LQ2AS5.js";
 import {
   draw,
   random,
@@ -21,6 +21,9 @@ import {
   list,
   range
 } from "../chunk-BT47ISVC.js";
+import {
+  sleep
+} from "../chunk-KKFGUHFR.js";
 import {
   isArray,
   isClient,
@@ -37,14 +40,20 @@ import {
   isSymbol
 } from "../chunk-6G7GFZV2.js";
 import {
-  sleep
-} from "../chunk-KKFGUHFR.js";
+  clamp,
+  inRange,
+  max,
+  min,
+  toHex
+} from "../chunk-PD6VHMH6.js";
 export {
   camel,
   capitalize,
+  clamp,
   clearArray,
   dash,
   draw,
+  inRange,
   isArray,
   isClient,
   isDate,
@@ -60,6 +69,8 @@ export {
   isSymbol,
   iterate,
   list,
+  max,
+  min,
   pascal,
   random,
   range,
@@ -68,6 +79,7 @@ export {
   snake,
   template,
   title,
+  toHex,
   trim,
   uid
 };

package/dist/utils/number.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Returns the smallest of the given numbers.
+ *
+ * This is a convenience wrapper around `Math.min` that provides better type safety
+ * and consistency with other utility functions.
+ *
+ * @param numbers - The numbers to compare
+ * @returns The smallest number from the input
+ *
+ * @example
+ * ```typescript
+ * min(1, 2, 3) // => 1
+ * min(-5, 0, 10) // => -5
+ * min(3.14, 2.71, 1.41) // => 1.41
+ * ```
+ */
+declare function min(...numbers: number[]): number;
+/**
+ * Returns the largest of the given numbers.
+ *
+ * This is a convenience wrapper around `Math.max` that provides better type safety
+ * and consistency with other utility functions.
+ *
+ * @param numbers - The numbers to compare
+ * @returns The largest number from the input
+ *
+ * @example
+ * ```typescript
+ * max(1, 2, 3) // => 3
+ * max(-5, 0, 10) // => 10
+ * max(3.14, 2.71, 1.41) // => 3.14
+ * ```
+ */
+declare function max(...numbers: number[]): number;
+/**
+ * Clamps a number to within the specified bounds.
+ *
+ * If the number is less than the minimum, returns the minimum.
+ * If the number is greater than the maximum, returns the maximum.
+ * Otherwise, returns the number unchanged.
+ *
+ * @param x - The number to clamp
+ * @param minimum - The lower bound (inclusive)
+ * @param maximum - The upper bound (inclusive)
+ * @returns The clamped number
+ *
+ * @example
+ * ```typescript
+ * clamp(0.5) // => 0.5 (within default 0-1 range)
+ * clamp(-0.1) // => 0 (clamped to minimum)
+ * clamp(1.5) // => 1 (clamped to maximum)
+ * clamp(15, 10, 20) // => 15 (within range)
+ * clamp(5, 10, 20) // => 10 (clamped to minimum)
+ * clamp(25, 10, 20) // => 20 (clamped to maximum)
+ * ```
+ */
+declare function clamp(x: number, minimum?: number, maximum?: number): number;
+/**
+ * Checks if a number is within a specified range.
+ *
+ * Supports different inclusivity modes:
+ * - `'[]'` - Both bounds inclusive (default): `minimum ≤ x ≤ maximum`
+ * - `'()'` - Both bounds exclusive: `minimum < x < maximum`
+ * - `'[)'` - Lower inclusive, upper exclusive: `minimum ≤ x < maximum`
+ * - `'(]'` - Lower exclusive, upper inclusive: `minimum < x ≤ maximum`
+ *
+ * @param x - The number to check
+ * @param minimum - The lower bound of the range
+ * @param maximum - The upper bound of the range
+ * @param inclusivity - Specifies whether the bounds are inclusive or exclusive
+ * @returns `true` if the number is within the range, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * // Default inclusive range [0, 1]
+ * inRange(0.5) // => true
+ * inRange(0) // => true (inclusive)
+ * inRange(1) // => true (inclusive)
+ * inRange(-0.1) // => false
+ * inRange(1.1) // => false
+ *
+ * // Custom range [10, 20]
+ * inRange(15, 10, 20) // => true
+ * inRange(10, 10, 20) // => true (inclusive)
+ * inRange(20, 10, 20) // => true (inclusive)
+ *
+ * // Exclusive bounds (10, 20)
+ * inRange(15, 10, 20, '()') // => true
+ * inRange(10, 10, 20, '()') // => false (exclusive)
+ * inRange(20, 10, 20, '()') // => false (exclusive)
+ *
+ * // Mixed inclusivity [10, 20)
+ * inRange(10, 10, 20, '[)') // => true (lower inclusive)
+ * inRange(20, 10, 20, '[)') // => false (upper exclusive)
+ * ```
+ */
+declare function inRange(x: number, minimum?: number, maximum?: number, inclusivity?: '()' | '[]' | '[)' | '(]'): boolean;
+/**
+ * Converts a number to a hexadecimal string.
+ *
+ * @param x - The number to convert
+ * @param pad - The number of digits to pad the output with (default: 2)
+ * @returns The hexadecimal representation of the number
+ *
+ * @example
+ * ```typescript
+ * toHEX(255) // => "ff"
+ * toHEX(255, 4) // => "00ff"
+ * ```
+ */
+declare function toHex(x: number, pad?: number): string;
+
+export { clamp, inRange, max, min, toHex };

package/dist/utils/number.js

@@ -0,0 +1,14 @@
+import {
+  clamp,
+  inRange,
+  max,
+  min,
+  toHex
+} from "../chunk-PD6VHMH6.js";
+export {
+  clamp,
+  inRange,
+  max,
+  min,
+  toHex
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solid-tiny-utils",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "A collection of tiny utilities for SolidJS applications",
   "main": "./dist/index.js",
   "type": "module",
@@ -17,9 +17,11 @@
     "@solidjs/testing-library": "^0.8.10",
     "@testing-library/jest-dom": "^6.6.4",
     "@testing-library/user-event": "^14.6.1",
+    "@types/culori": "^4.0.0",
     "@types/node": "^24.2.1",
     "@vitest/ui": "^3.2.4",
     "commit-and-tag-version": "^12.5.1",
+    "culori": "^4.0.2",
     "husky": "^9.1.7",
     "jsdom": "^26.1.0",
     "tsup": "^8.5.0",
@@ -47,15 +49,13 @@
   "scripts": {
     "build": "tsup",
     "dev": "vite -c ./playground/vite.config.ts",
-    "test": "vitest",
+    "test": "vitest --run",
     "clean": "rimraf dist node_modules pnpm-lock.yaml",
-    "test:run": "vitest --run",
     "test:ui": "vitest --ui",
-    "test:coverage": "vitest --coverage",
     "lint": "npx ultracite lint",
     "lint:fix": "npx ultracite format",
     "type-check": "tsc --noEmit --skipLibCheck",
-    "release": "pnpm type-check && pnpm lint:fix && pnpm test:run && commit-and-tag-version -i CHANGELOG.md --same-file",
+    "release": "pnpm type-check && pnpm lint:fix && pnpm test && commit-and-tag-version -i CHANGELOG.md --same-file",
     "pub": "pnpm build && pnpm publish"
   }
 }

package/dist/{chunk-D3JAYNG6.js → chunk-QPEF6LHH.js}

@@ -1,9 +1,9 @@
-import {
-  createWatch
-} from "./chunk-4L6FK7MF.js";
 import {
   access
 } from "./chunk-YK5QQQ43.js";
+import {
+  createWatch
+} from "./chunk-4L6FK7MF.js";
 import {
   isNumber
 } from "./chunk-6G7GFZV2.js";

package/dist/{chunk-WWEM5VJO.js → chunk-TDJLPDJF.js}

@@ -1,9 +1,9 @@
-import {
-  createWatch
-} from "./chunk-4L6FK7MF.js";
 import {
   access
 } from "./chunk-YK5QQQ43.js";
+import {
+  createWatch
+} from "./chunk-4L6FK7MF.js";
 import {
   isObject
 } from "./chunk-6G7GFZV2.js";