@puzzle-ui/core 0.3.0 → 0.5.0

package/README.md

@@ -1,70 +1,98 @@
-# @puzzle-ui/core
+# Getting Started
 
-Framework-independent utilities shared by the Puzzle UI packages. Use them
-directly without React, a theme provider, or CSS.
+Install Puzzle in your React app, build your first interface, and customize the theme.
 
-> Puzzle is under active development. APIs may change without notice; use it
-> for experimentation and evaluation rather than production applications.
+> \[!WARNING\] **Puzzle is not ready for production use.**
+>
+> This project is under active development. APIs, component props,
+> package exports, styling, and internal implementation may change
+> without notice. Components may be incomplete, and testing,
+> accessibility, documentation, and framework compatibility are not yet
+> guaranteed. Use it for experimentation and evaluation only---not for
+> production applications.
 
-## Installation
+Puzzle is a TypeScript and React UI component library built around reusable components and shared design tokens. Its components are composable and router-independent, with styling supplied by `"@puzzle-ui/theme`. The framework is setup to be compatible with `Next.js`, `Tanstack Start` and `react-router`.
 
-Use your preferred package manager:
+**Puzzle is under active development and is not ready for production use.** APIs, props, exports, and styling may change without notice. Accessibility and framework compatibility are still being tested. Use the project for experimentation and evaluation.
 
-```sh
-npm install @puzzle-ui/core
-# or
-bun add @puzzle-ui/core
-# or
-pnpm add @puzzle-ui/core
-# or
-yarn add @puzzle-ui/core
-```
+## Prerequisites
+
+- A package manager: npm, Bun, pnpm, or Yarn.
+- An existing React application with a bundler that supports CSS imports, such as Vite.
+- Familiarity with React and TypeScript. The UI and theme packages require React and React DOM 19 or later within the supported React 19 range.
+
+## Set up a new project
+
+Simple run our @puzzle-ui/create project template to get started.
 
-## Usage
+npm:
 
-```ts
-import { cn, isHexColor } from "@puzzle-ui/core";
+```bash
+npx @puzzle-ui/create
+```
+
+bun:
 
-const selected = true;
-const className = cn("navigation-item", selected && "selected");
-const validColor = isHexColor("#0284C7");
+```bash
+bunx @puzzle-ui/create
 ```
 
-## Public utilities
+Puzzle can set up a new project for you with the following framework options:
+
+- Basic React app
+- Tanstack start
+- Next.js
+
+Furthermore you can choose to install tailwindcss or not.
+It directly installs all dependencies and sets up the project for you.
 
-| Area | Exports |
-| --- | --- |
-| Class names | `cn`, `ClassnameArg` |
-| Strings | `stringWithCasing`, `normalizeSearchString`, `withSafeCharacters`, `nameToInitials` |
-| CSS values | `assertSafeCssValue`, `escapeCssString` |
-| Colors | `isHexColor`, `isDarkColor`, `hexToRgb`, `rgbToHex` |
-| Responsive values | `BREAKPOINTS`, `resolveResponsiveValue`, `resolveResponsiveValueForBreakpoint` |
-| Timing | `debounce` |
-| Types | `DeepPartial`, `ResponsiveConfig`, `ResponsiveValue`, `Breakpoint` |
+## Set up in an existing project:
 
-Import from the package root; internal source paths are not public entry
-points. The package ships ESM and CommonJS builds with matching TypeScript
-declarations and has no React peer dependency.
+Install the UI library and theme package in your application's directory. Choose your package manager below:
 
-## Development
+npm:
 
-From an installed repository checkout:
+```bash
+npm install @puzzle-ui/ui --save
+```
+
+bun:
+
+```bash
+bun add @puzzle-ui/create
+```
 
-```sh
-npm run build --workspace=@puzzle-ui/core
+pnpm:
+
+```bash
+pnpm add @puzzle-ui/ui
 ```
 
-From this package directory, run the configured test script:
+yarn:
 
-```sh
-bun run vitest
+```bash
+yarn add @puzzle-ui/ui
 ```
 
-`prepack` rebuilds the package before packing or publishing. See the root
-[publishing guide](../../README.md#publishing-packages) for release order and
-validation commands.
+These commands install published packages; they do not clone the repository or build its workspaces. Puzzle does not require Bun in your application. React and React DOM are peer dependencies and should already be installed in your app.
+
+## Your first interface
 
-## License
+Import components from `"@puzzle-ui/ui` and wrap your application in `Theme` from `"@puzzle-ui/theme`:
 
-MIT. See the repository [LICENSE](../../LICENSE); published packages include
-the same license at `dist/LICENSE`.
+```tsx
+import { Theme } from "@puzzle-ui/theme";
+import { Button } from "@puzzle-ui/ui";
+
+export const App = () => (
+  <Theme>
+    <main>
+      <h1>Hello, Puzzle</h1>
+      <p>Build your interface with reusable components and shared tokens.</p>
+      <Button onClick={() => window.alert("Welcome to Puzzle!")}>
+        Get started
+      </Button>
+    </main>
+  </Theme>
+);
+```

package/dist/index.cjs

@@ -146,51 +146,310 @@ const getFirstLetter = (part) => {
 };
 const nameToInitials = (name) => {
 	const parts = name.trim().split(/\s+/u).filter(Boolean);
-	if (parts.length === 0) return "?";
-	while (parts.length > 1 && NAME_SUFFIXES.has(normalizeNamePart(parts[parts.length - 1]))) parts.pop();
-	const firstInitial = getFirstLetter(parts[0]);
+	const [firstPart] = parts;
+	if (firstPart === void 0) return "?";
+	while (parts.length > 1 && NAME_SUFFIXES.has(normalizeNamePart(parts.at(-1)))) parts.pop();
+	const firstInitial = getFirstLetter(firstPart);
 	if (parts.length === 1) return firstInitial;
 	const surname = [...parts.slice(1)].reverse().find((part) => !NAME_PARTICLES.has(normalizeNamePart(part)));
-	return firstInitial + getFirstLetter(surname ?? parts[parts.length - 1]);
+	return firstInitial + getFirstLetter(surname ?? parts.at(-1));
 };
-// src/color/to-color.ts
-const hexToRgb = (hex) => {
-	if (!/^#([0-9A-F]{3}){1,2}$/i.test(hex)) throw new Error("Invalid hex color");
-	let r, g, b;
-	if (hex.length === 4) {
-		r = parseInt(hex[1] + hex[1], 16);
-		g = parseInt(hex[2] + hex[2], 16);
-		b = parseInt(hex[3] + hex[3], 16);
-	} else {
-		r = parseInt(hex.slice(1, 3), 16);
-		g = parseInt(hex.slice(3, 5), 16);
-		b = parseInt(hex.slice(5, 7), 16);
+// src/color/color.utils.ts
+const clamp = (value, min, max) => Math.min(max, Math.max(min, value));
+const normalizeHue = (hue) => (hue % 360 + 360) % 360;
+const normalizeAlpha = (value) => {
+	if (value === void 0) return 1;
+	const alpha = value.endsWith("%") ? Number.parseFloat(value) / 100 : Number.parseFloat(value);
+	return clamp(alpha, 0, 1);
+};
+const CSS_NAMED_COLORS = /* @__PURE__ */ new Set([
+	"aliceblue",
+	"antiquewhite",
+	"aqua",
+	"aquamarine",
+	"azure",
+	"beige",
+	"bisque",
+	"black",
+	"blanchedalmond",
+	"blue",
+	"blueviolet",
+	"brown",
+	"burlywood",
+	"cadetblue",
+	"chartreuse",
+	"chocolate",
+	"coral",
+	"cornflowerblue",
+	"cornsilk",
+	"crimson",
+	"cyan",
+	"darkblue",
+	"darkcyan",
+	"darkgoldenrod",
+	"darkgray",
+	"darkgreen",
+	"darkgrey",
+	"darkkhaki",
+	"darkmagenta",
+	"darkolivegreen",
+	"darkorange",
+	"darkorchid",
+	"darkred",
+	"darksalmon",
+	"darkseagreen",
+	"darkslateblue",
+	"darkslategray",
+	"darkslategrey",
+	"darkturquoise",
+	"darkviolet",
+	"deeppink",
+	"deepskyblue",
+	"dimgray",
+	"dimgrey",
+	"dodgerblue",
+	"firebrick",
+	"floralwhite",
+	"forestgreen",
+	"fuchsia",
+	"gainsboro",
+	"ghostwhite",
+	"gold",
+	"goldenrod",
+	"gray",
+	"green",
+	"greenyellow",
+	"grey",
+	"honeydew",
+	"hotpink",
+	"indianred",
+	"indigo",
+	"ivory",
+	"khaki",
+	"lavender",
+	"lavenderblush",
+	"lawngreen",
+	"lemonchiffon",
+	"lightblue",
+	"lightcoral",
+	"lightcyan",
+	"lightgoldenrodyellow",
+	"lightgray",
+	"lightgreen",
+	"lightgrey",
+	"lightpink",
+	"lightsalmon",
+	"lightseagreen",
+	"lightskyblue",
+	"lightslategray",
+	"lightslategrey",
+	"lightsteelblue",
+	"lightyellow",
+	"lime",
+	"limegreen",
+	"linen",
+	"magenta",
+	"maroon",
+	"mediumaquamarine",
+	"mediumblue",
+	"mediumorchid",
+	"mediumpurple",
+	"mediumseagreen",
+	"mediumslateblue",
+	"mediumspringgreen",
+	"mediumturquoise",
+	"mediumvioletred",
+	"midnightblue",
+	"mintcream",
+	"mistyrose",
+	"moccasin",
+	"navajowhite",
+	"navy",
+	"oldlace",
+	"olive",
+	"olivedrab",
+	"orange",
+	"orangered",
+	"orchid",
+	"palegoldenrod",
+	"palegreen",
+	"paleturquoise",
+	"palevioletred",
+	"papayawhip",
+	"peachpuff",
+	"peru",
+	"pink",
+	"plum",
+	"powderblue",
+	"purple",
+	"rebeccapurple",
+	"red",
+	"rosybrown",
+	"royalblue",
+	"saddlebrown",
+	"salmon",
+	"sandybrown",
+	"seagreen",
+	"seashell",
+	"sienna",
+	"silver",
+	"skyblue",
+	"slateblue",
+	"slategray",
+	"slategrey",
+	"snow",
+	"springgreen",
+	"steelblue",
+	"tan",
+	"teal",
+	"thistle",
+	"tomato",
+	"turquoise",
+	"violet",
+	"wheat",
+	"white",
+	"whitesmoke",
+	"yellow",
+	"yellowgreen",
+	"transparent",
+	"currentcolor"
+]);
+const normalizeChannel = (value) => {
+	const channel = value.endsWith("%") ? Number.parseFloat(value) / 100 * 255 : Number.parseFloat(value);
+	return clamp(channel, 0, 255);
+};
+const getColorType = (color) => {
+	const value = color.trim().toLowerCase();
+	if (/^var\(\s*--[\w-]+(?:\s*,\s*.+)?\)$/.test(value)) return "css-variable";
+	if (/^#[\da-f]{8}$/.test(value) || /^#[\da-f]{4}$/.test(value)) return "hexa";
+	if (/^#[\da-f]{6}$/.test(value) || /^#[\da-f]{3}$/.test(value)) return "hex";
+	if (/^rgba\(/.test(value)) return "rgba";
+	if (/^rgb\(/.test(value)) return "rgb";
+	if (/^hsla\(/.test(value)) return "hsla";
+	if (/^hsl\(/.test(value)) return "hsl";
+	if (/^[a-z]+$/.test(value)) return "named";
+	return "unknown";
+};
+const isCssVariable = (color) => getColorType(color) === "css-variable";
+const isColor = (color) => {
+	const type = getColorType(color);
+	return type === "named" ? CSS_NAMED_COLORS.has(color.trim().toLowerCase()) : type !== "unknown";
+};
+const hexToRgba = (hex) => {
+	const value = hex.trim().replace(/^#/, "");
+	if (!/^(?:[\da-f]{3}|[\da-f]{4}|[\da-f]{6}|[\da-f]{8})$/i.test(value)) throw new Error(`Invalid HEX color: ${hex}`);
+	const expanded = value.length <= 4 ? [...value].map((channel) => channel + channel).join("") : value;
+	return {
+		r: Number.parseInt(expanded.slice(0, 2), 16),
+		g: Number.parseInt(expanded.slice(2, 4), 16),
+		b: Number.parseInt(expanded.slice(4, 6), 16),
+		a: expanded.length === 8 ? Number.parseInt(expanded.slice(6, 8), 16) / 255 : 1
+	};
+};
+const parseRgb = (color) => {
+	const match = color.trim().match(/^rgba?\(\s*([\d.]+%?)\s*[, ]\s*([\d.]+%?)\s*[, ]\s*([\d.]+%?)(?:\s*[,/]\s*([\d.]+%?))?\s*\)$/i);
+	if (!match) return null;
+	const [, r, g, b, alpha] = match;
+	if (r === void 0 || g === void 0 || b === void 0) return null;
+	return {
+		r: normalizeChannel(r),
+		g: normalizeChannel(g),
+		b: normalizeChannel(b),
+		a: normalizeAlpha(alpha)
+	};
+};
+const hslToRgb = ({ h, s, l, a = 1 }) => {
+	const hue = normalizeHue(h) / 360;
+	const saturation = clamp(s / 100, 0, 1);
+	const lightness = clamp(l / 100, 0, 1);
+	const channel = (n) => {
+		const k = (n + hue * 12) % 12;
+		const chroma = saturation * Math.min(lightness, 1 - lightness);
+		return Math.round((lightness - chroma * Math.max(-1, Math.min(k - 3, 9 - k, 1))) * 255);
+	};
+	return {
+		r: channel(0),
+		g: channel(8),
+		b: channel(4),
+		a: clamp(a, 0, 1)
+	};
+};
+const rgbToHsl = ({ r, g, b, a = 1 }) => {
+	const red = r / 255;
+	const green = g / 255;
+	const blue = b / 255;
+	const max = Math.max(red, green, blue);
+	const min = Math.min(red, green, blue);
+	const delta = max - min;
+	const l = (max + min) / 2;
+	let h = 0;
+	let s = 0;
+	if (delta !== 0) {
+		s = delta / (1 - Math.abs(2 * l - 1));
+		if (max === red) h = 60 * ((green - blue) / delta % 6);
+		else if (max === green) h = 60 * ((blue - red) / delta + 2);
+		else h = 60 * ((red - green) / delta + 4);
 	}
 	return {
-		r,
-		g,
-		b
+		h: normalizeHue(h),
+		s: s * 100,
+		l: l * 100,
+		a
 	};
 };
-const rgbToHex = (r, g, b) => {
-	const toHex = (value) => {
-		const hex = value.toString(16);
-		return hex.length === 1 ? "0" + hex : hex;
+const parseHsl = (color) => {
+	const match = color.trim().match(/^hsla?\(\s*([\d.]+)(?:deg)?\s*[, ]\s*([\d.]+)%\s*[, ]\s*([\d.]+)%(?:\s*[,/]\s*([\d.]+%?))?\s*\)$/i);
+	if (!match) return null;
+	const [, h, s, l, alpha] = match;
+	return hslToRgb({
+		h: Number(h),
+		s: Number(s),
+		l: Number(l),
+		a: normalizeAlpha(alpha)
+	});
+};
+const parseColor = (color) => {
+	const type = getColorType(color);
+	if (type === "hex" || type === "hexa") return hexToRgba(color);
+	if (type === "rgb" || type === "rgba") return parseRgb(color);
+	if (type === "hsl" || type === "hsla") return parseHsl(color);
+	return null;
+};
+const rgbToCss = ({ r, g, b, a }) => a < 1 ? `rgba(${Math.round(r)}, ${Math.round(g)}, ${Math.round(b)}, ${Number(a.toFixed(3))})` : `rgb(${Math.round(r)}, ${Math.round(g)}, ${Math.round(b)})`;
+const hslToCss = ({ h, s, l, a }) => a < 1 ? `hsla(${Math.round(h)}, ${Math.round(s)}%, ${Math.round(l)}%, ${Number(a.toFixed(3))})` : `hsl(${Math.round(h)}, ${Math.round(s)}%, ${Math.round(l)}%)`;
+const getColorLuminance = (color) => {
+	const rgb = parseColor(color);
+	if (!rgb) return null;
+	const linearize = (value) => {
+		const channel = value / 255;
+		return channel <= .04045 ? channel / 12.92 : ((channel + .055) / 1.055) ** 2.4;
 	};
-	return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+	return .2126 * linearize(rgb.r) + .7152 * linearize(rgb.g) + .0722 * linearize(rgb.b);
+};
+const isColorDark = (color) => {
+	const luminance = getColorLuminance(color);
+	return luminance === null ? null : luminance < .179;
 };
 // src/color/is-color.ts
-const isHexColor = (color) => {
-	return /^#([0-9A-F]{3}){1,2}$/i.test(color);
+const isHexColor = (color) => /^#(?:[\da-f]{3}|[\da-f]{4}|[\da-f]{6}|[\da-f]{8})$/i.test(color.trim());
+const isDarkColor = (color) => {
+	const result = isColorDark(color);
+	if (result === null) throw new Error(`Unsupported color: ${color}`);
+	return result;
 };
-const linearize = (value) => {
-	const channel = value / 255;
-	return channel <= .04045 ? channel / 12.92 : ((channel + .055) / 1.055) ** 2.4;
+// src/color/to-color.ts
+const hexToRgb = (hex) => {
+	const { r, g, b } = hexToRgba(hex);
+	return {
+		r,
+		g,
+		b
+	};
 };
-/** Returns whether a color is dark based on WCAG relative luminance. */
-const isDarkColor = (color) => {
-	const { r, g, b } = hexToRgb(color);
-	return .2126 * linearize(r) + .7152 * linearize(g) + .0722 * linearize(b) < .179;
+const rgbToHex = (r, g, b, a) => {
+	const channel = (value) => Math.round(Math.min(255, Math.max(0, value))).toString(16).padStart(2, "0");
+	const alpha = a !== void 0 && a < 1 ? channel(Math.min(1, Math.max(0, a)) * 255) : "";
+	return `#${channel(r)}${channel(g)}${channel(b)}${alpha}`;
 };
 // src/timing/debounce.ts
 /**
@@ -209,17 +468,30 @@ const debounce = (func, wait) => {
 };
 exports.BREAKPOINTS = BREAKPOINTS;
 exports.assertSafeCssValue = assertSafeCssValue;
+exports.clamp = clamp;
 exports.cn = cn;
 exports.debounce = debounce;
 exports.escapeCssString = escapeCssString;
+exports.getColorLuminance = getColorLuminance;
+exports.getColorType = getColorType;
 exports.hexToRgb = hexToRgb;
+exports.hexToRgba = hexToRgba;
+exports.hslToCss = hslToCss;
+exports.hslToRgb = hslToRgb;
+exports.isColor = isColor;
+exports.isColorDark = isColorDark;
+exports.isCssVariable = isCssVariable;
 exports.isDarkColor = isDarkColor;
 exports.isHexColor = isHexColor;
 exports.nameToInitials = nameToInitials;
 exports.normalizeSearchString = normalizeSearchString;
+exports.parseColor = parseColor;
+exports.parseRgb = parseRgb;
 exports.resolveResponsiveValue = resolveResponsiveValue;
 exports.resolveResponsiveValueForBreakpoint = resolveResponsiveValueForBreakpoint;
+exports.rgbToCss = rgbToCss;
 exports.rgbToHex = rgbToHex;
+exports.rgbToHsl = rgbToHsl;
 exports.stringWithCasing = stringWithCasing;
 exports.withSafeCharacters = withSafeCharacters;
 

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/responsive/constants.ts","../src/responsive/index.ts","../src/string/assert.ts","../src/string/normalize.ts","../src/string/casing.ts","../src/string/class-names.ts","../src/string/name-to-initials.ts","../src/color/to-color.ts","../src/color/is-color.ts","../src/timing/debounce.ts"],"sourcesContent":["export const BREAKPOINTS = [\"mobile\", \"tablet\", \"desktop\"] as const;\n","import type { Breakpoint, ResponsiveConfig, ResponsiveValue } from \"./types\";\n\nconst resolveResponsiveValueForBreakpoint = <T>(\n  breakpoint: Breakpoint,\n  value: ResponsiveValue<T>,\n  fallback?: T,\n): T => {\n  if (value === undefined || value === null) {\n    return fallback as T;\n  }\n  const isNonResponsive = typeof value !== \"object\" || !(breakpoint in value);\n  const resolved = isNonResponsive\n    ? ((value ?? fallback) as T)\n    : ((value as ResponsiveConfig<T>)[breakpoint] ?? (fallback as T));\n  return resolved;\n};\n\nconst resolveResponsiveValue = <T>(\n  value: ResponsiveValue<T>,\n  fallback?: T,\n): Required<ResponsiveConfig<T>> => {\n  const mobile = resolveResponsiveValueForBreakpoint(\"mobile\", value, fallback);\n  const tablet = resolveResponsiveValueForBreakpoint(\"tablet\", value, mobile);\n  const desktop = resolveResponsiveValueForBreakpoint(\"desktop\", value, tablet);\n\n  return {\n    mobile,\n    tablet,\n    desktop,\n  };\n};\n\nexport { resolveResponsiveValue, resolveResponsiveValueForBreakpoint };\nexport { BREAKPOINTS } from \"./constants\";\nexport type { Breakpoint, ResponsiveConfig, ResponsiveValue } from \"./types\";\n","export const assertSafeCssValue = (value: unknown, label: string) => {\n  if (typeof value !== \"string\" && typeof value !== \"number\") {\n    throw new TypeError(`${label} must be a string or number.`);\n  }\n\n  const serialized = String(value).trim();\n  if (\n    serialized.length === 0 ||\n    /[;{}<>\\u0000-\\u001f\\u007f]/.test(serialized)\n  ) {\n    throw new TypeError(\n      `${label} must be a non-empty CSS value and must not contain semicolons, braces, angle brackets, or control characters.`,\n    );\n  }\n  return serialized;\n};\n","/** Normalizes a search string by removing diacritics and converting to lowercase */\nexport const normalizeSearchString = (value: string): string =>\n  value\n    .normalize(\"NFD\")\n    .replace(/[\\u0300-\\u036f]/g, \"\")\n    .toLocaleLowerCase();\n\n/** Removes unsafe characters from a string */\nexport const withSafeCharacters = (input: string): string =>\n  input\n    .trim()\n    .normalize(\"NFD\")\n    .replace(/[\\u0300-\\u036f]/g, \"\")\n    .replace(/[^a-zA-Z0-9\\s-]/g, \"\")\n    .replace(\n      /([A-Z].*[^\\s][A-Z])/g,\n      \"$1\".slice(0, 1).toUpperCase() + \"$1\".slice(1).toLowerCase(),\n    );\n\n/** Escapes special characters in a string for use in CSS strings */\nexport const escapeCssString = (value: string): string => {\n  return value.replace(/[\"\\\\\\n\\r\\f]/g, (character) => {\n    switch (character) {\n      case '\"':\n        return '\\\\\"';\n      case \"\\\\\":\n        return \"\\\\\\\\\";\n      case \"\\n\":\n        return \"\\\\a \";\n      case \"\\r\":\n        return \"\\\\d \";\n      case \"\\f\":\n        return \"\\\\c \";\n      default:\n        return character;\n    }\n  });\n};\n","import { withSafeCharacters } from \"./normalize\";\n\n/**\n * Represents the casing options for strings.\n * - \"lowercase\"      -> hello world\n * - \"uppercase\"      -> HELLO WORLD\n * - \"snakecase\"      -> hello_world\n * - \"kebabcase\"      -> hello-world\n * - \"camelcase\"      -> helloWorld\n * - \"pascalcase\"     -> HelloWorld\n * - \"sentencecase\"   -> Hello world\n * - \"headercase\"     -> Hello World\n **/\nexport type StringCasing =\n  | \"lowercase\"\n  | \"uppercase\"\n  | \"snakecase\"\n  | \"kebabcase\"\n  | \"camelcase\"\n  | \"pascalcase\"\n  | \"sentencecase\"\n  | \"headercase\";\n\n/**\n * Transforms the input string into the specified casing.\n * Casing can be one of the following:\n * - \"lowercase\"      -> hello world\n * - \"uppercase\"      -> HELLO WORLD\n * - \"snakecase\"      -> hello_world\n * - \"kebabcase\"      -> hello-world\n * - \"camelcase\"      -> helloWorld\n * - \"pascalcase\"     -> HelloWorld\n * - \"sentencecase\"   -> Hello world\n * - \"headercase\"     -> Hello World\n **/\nexport const stringWithCasing = (\n  input: string,\n  casing: StringCasing,\n): string => {\n  const trimmedInput = input.trim();\n  const cleanedInput = withSafeCharacters(trimmedInput);\n\n  switch (casing) {\n    case \"lowercase\":\n      return trimmedInput.toLowerCase();\n    case \"uppercase\":\n      return trimmedInput.toUpperCase();\n    case \"snakecase\":\n      return cleanedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => a + \"_\" + b.toLowerCase())\n        .replace(/[^A-Za-z0-9]+|_+/g, \"_\")\n        .toLowerCase();\n    case \"kebabcase\":\n      return trimmedInput\n        .replace(/^[^A-Za-z0-9]*-?|[^A-Za-z0-9]*-?$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`)\n        .replace(/[^A-Za-z0-9]+|_+/g, \"-\")\n        .toLowerCase();\n    case \"camelcase\":\n      return cleanedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/[^A-Za-z0-9]+/g, \"$\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}$${b}`)\n        .toLowerCase()\n        .replace(/(\\$)(\\w)/g, (_m, _a, b) => b.toUpperCase());\n    case \"pascalcase\":\n      return cleanedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"$\")\n        .replace(/[^A-Za-z0-9]+/g, \"$\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}$${b}`)\n        .toLowerCase()\n        .replace(/(\\$)(\\w?)/g, (_m, a, b) => b.toUpperCase());\n    case \"sentencecase\": {\n      const textcase = trimmedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`)\n        .replace(/[^A-Za-z0-9]+|_+/g, \" \")\n        .toLowerCase();\n\n      return textcase.charAt(0).toUpperCase() + textcase.slice(1);\n    }\n    case \"headercase\":\n      return trimmedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`)\n        .replace(/[^A-Za-z0-9]+|_+/g, \" \")\n        .toLowerCase()\n        .replace(\n          /( ?)(\\w+)( ?)/g,\n          (m, a, b, c) => a + b.charAt(0).toUpperCase() + b.slice(1) + c,\n        );\n  }\n};\n","/**\n * Represents a valid argument for the `classNames` function.\n * It can be a string, an array of strings, undefined, null, or false.\n */\nexport type ClassnameArg = string | string[] | undefined | null | false;\n\n/**\n * Concatenates and trims the given arguments into a single string of class names.\n *\n * @param args - The arguments to be concatenated.\n * @returns A string of class names.\n */\nexport const cn = (...args: ClassnameArg[]): string => {\n  const notNullUndefinedOrFalse = args.filter((v) => !!v).flat() as string[];\n  return notNullUndefinedOrFalse\n    .flatMap((v) => v.split(\" \"))\n    .filter((v) => v.length > 0)\n    .join(\" \")\n    .trim();\n};\n","const NAME_PARTICLES = new Set([\n  // Dutch\n  \"van\",\n  \"den\",\n  \"der\",\n  \"de\",\n  \"ter\",\n  \"ten\",\n  \"te\",\n  \"het\",\n  \"'t\",\n\n  // German\n  \"von\",\n  \"vom\",\n  \"zum\",\n  \"zur\",\n  \"zu\",\n\n  // French\n  \"du\",\n  \"des\",\n  \"le\",\n  \"la\",\n  \"les\",\n\n  // Spanish and Portuguese\n  \"del\",\n  \"los\",\n  \"las\",\n  \"da\",\n  \"das\",\n  \"do\",\n  \"dos\",\n\n  // Italian\n  \"di\",\n  \"della\",\n  \"delle\",\n  \"dello\",\n  \"dei\",\n  \"degli\",\n\n  // Other common particles\n  \"al\",\n  \"el\",\n  \"bin\",\n  \"ibn\",\n  \"bint\",\n  \"af\",\n  \"av\",\n  \"ap\",\n  \"ab\",\n]);\n\nconst NAME_SUFFIXES = new Set([\n  \"jr\",\n  \"sr\",\n  \"ii\",\n  \"iii\",\n  \"iv\",\n  \"v\",\n  \"phd\",\n  \"md\",\n]);\n\nconst normalizeNamePart = (part: string): string => {\n  return part.toLocaleLowerCase().replace(/[\\p{P}\\p{S}]/gu, \"\");\n};\n\nconst getFirstLetter = (part: string): string => {\n  return part.match(/\\p{L}/u)?.[0].toLocaleUpperCase() ?? \"\";\n};\n\nexport const nameToInitials = (name: string) => {\n  const parts = name.trim().split(/\\s+/u).filter(Boolean);\n  if (parts.length === 0) {\n    return \"?\";\n  }\n\n  // Ignore suffixes such as Jr., Sr. and III.\n  while (\n    parts.length > 1 &&\n    NAME_SUFFIXES.has(normalizeNamePart(parts[parts.length - 1]))\n  ) {\n    parts.pop();\n  }\n\n  const firstInitial = getFirstLetter(parts[0]);\n\n  if (parts.length === 1) {\n    return firstInitial;\n  }\n\n  // Find the last meaningful surname part, ignoring particles.\n  const surname = [...parts.slice(1)]\n    .reverse()\n    .find((part) => !NAME_PARTICLES.has(normalizeNamePart(part)));\n\n  // Fallback for unusual names consisting only of particles.\n  const lastInitial = getFirstLetter(surname ?? parts[parts.length - 1]);\n\n  return firstInitial + lastInitial;\n};\n","export const hexToRgb = (hex: string): { r: number; g: number; b: number } => {\n  if (!/^#([0-9A-F]{3}){1,2}$/i.test(hex)) {\n    throw new Error(\"Invalid hex color\");\n  }\n  let r: number, g: number, b: number;\n  if (hex.length === 4) {\n    r = parseInt(hex[1] + hex[1], 16);\n    g = parseInt(hex[2] + hex[2], 16);\n    b = parseInt(hex[3] + hex[3], 16);\n  } else {\n    r = parseInt(hex.slice(1, 3), 16);\n    g = parseInt(hex.slice(3, 5), 16);\n    b = parseInt(hex.slice(5, 7), 16);\n  }\n  return { r, g, b };\n};\n\nexport const rgbToHex = (r: number, g: number, b: number): string => {\n  const toHex = (value: number) => {\n    const hex = value.toString(16);\n    return hex.length === 1 ? \"0\" + hex : hex;\n  };\n  return `#${toHex(r)}${toHex(g)}${toHex(b)}`;\n};\n","export const isHexColor = (color: string): boolean => {\n  return /^#([0-9A-F]{3}){1,2}$/i.test(color);\n};\n\nimport { hexToRgb } from \"./to-color\";\n\nconst linearize = (value: number): number => {\n  const channel = value / 255;\n\n  return channel <= 0.04045\n    ? channel / 12.92\n    : ((channel + 0.055) / 1.055) ** 2.4;\n};\n\n/** Returns whether a color is dark based on WCAG relative luminance. */\nexport const isDarkColor = (color: string): boolean => {\n  const { r, g, b } = hexToRgb(color);\n\n  const luminance =\n    0.2126 * linearize(r) + 0.7152 * linearize(g) + 0.0722 * linearize(b);\n\n  return luminance < 0.179;\n};\n","/**\n * Call the original function, but applying the debounce rules.\n *\n * Only the last call to the function shall be executed after the timeout has been reached.\n * @returns the debounced function with a cancel function property to clear the timeout.\n */\nconst debounce = <T extends unknown[]>(\n  func: (...args: T) => void,\n  wait: number,\n) => {\n  let timeout: ReturnType<typeof setTimeout>;\n\n  const cancel = () => clearTimeout(timeout);\n\n  return Object.assign(\n    (...args: T) => {\n      clearTimeout(timeout);\n      timeout = setTimeout(() => func.apply(this, args), wait);\n    },\n    { cancel },\n  );\n};\n\nexport { debounce };\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/responsive/constants.ts","../src/responsive/index.ts","../src/string/assert.ts","../src/string/normalize.ts","../src/string/casing.ts","../src/string/class-names.ts","../src/string/name-to-initials.ts","../src/color/color.utils.ts","../src/color/is-color.ts","../src/color/to-color.ts","../src/timing/debounce.ts"],"sourcesContent":["export const BREAKPOINTS = [\"mobile\", \"tablet\", \"desktop\"] as const;\n","import type { Breakpoint, ResponsiveConfig, ResponsiveValue } from \"./types\";\n\nconst resolveResponsiveValueForBreakpoint = <T>(\n  breakpoint: Breakpoint,\n  value: ResponsiveValue<T>,\n  fallback?: T,\n): T => {\n  if (value === undefined || value === null) {\n    return fallback as T;\n  }\n  const isNonResponsive = typeof value !== \"object\" || !(breakpoint in value);\n  const resolved = isNonResponsive\n    ? ((value ?? fallback) as T)\n    : ((value as ResponsiveConfig<T>)[breakpoint] ?? (fallback as T));\n  return resolved;\n};\n\nconst resolveResponsiveValue = <T>(\n  value: ResponsiveValue<T>,\n  fallback?: T,\n): Required<ResponsiveConfig<T>> => {\n  const mobile = resolveResponsiveValueForBreakpoint(\"mobile\", value, fallback);\n  const tablet = resolveResponsiveValueForBreakpoint(\"tablet\", value, mobile);\n  const desktop = resolveResponsiveValueForBreakpoint(\"desktop\", value, tablet);\n\n  return {\n    mobile,\n    tablet,\n    desktop,\n  };\n};\n\nexport { resolveResponsiveValue, resolveResponsiveValueForBreakpoint };\nexport { BREAKPOINTS } from \"./constants\";\nexport type { Breakpoint, ResponsiveConfig, ResponsiveValue } from \"./types\";\n","export const assertSafeCssValue = (value: unknown, label: string) => {\n  if (typeof value !== \"string\" && typeof value !== \"number\") {\n    throw new TypeError(`${label} must be a string or number.`);\n  }\n\n  const serialized = String(value).trim();\n  if (\n    serialized.length === 0 ||\n    /[;{}<>\\u0000-\\u001f\\u007f]/.test(serialized)\n  ) {\n    throw new TypeError(\n      `${label} must be a non-empty CSS value and must not contain semicolons, braces, angle brackets, or control characters.`,\n    );\n  }\n  return serialized;\n};\n","/** Normalizes a search string by removing diacritics and converting to lowercase */\nexport const normalizeSearchString = (value: string): string =>\n  value\n    .normalize(\"NFD\")\n    .replace(/[\\u0300-\\u036f]/g, \"\")\n    .toLocaleLowerCase();\n\n/** Removes unsafe characters from a string */\nexport const withSafeCharacters = (input: string): string =>\n  input\n    .trim()\n    .normalize(\"NFD\")\n    .replace(/[\\u0300-\\u036f]/g, \"\")\n    .replace(/[^a-zA-Z0-9\\s-]/g, \"\")\n    .replace(\n      /([A-Z].*[^\\s][A-Z])/g,\n      \"$1\".slice(0, 1).toUpperCase() + \"$1\".slice(1).toLowerCase(),\n    );\n\n/** Escapes special characters in a string for use in CSS strings */\nexport const escapeCssString = (value: string): string => {\n  return value.replace(/[\"\\\\\\n\\r\\f]/g, (character) => {\n    switch (character) {\n      case '\"':\n        return '\\\\\"';\n      case \"\\\\\":\n        return \"\\\\\\\\\";\n      case \"\\n\":\n        return \"\\\\a \";\n      case \"\\r\":\n        return \"\\\\d \";\n      case \"\\f\":\n        return \"\\\\c \";\n      default:\n        return character;\n    }\n  });\n};\n","import { withSafeCharacters } from \"./normalize\";\n\n/**\n * Represents the casing options for strings.\n * - \"lowercase\"      -> hello world\n * - \"uppercase\"      -> HELLO WORLD\n * - \"snakecase\"      -> hello_world\n * - \"kebabcase\"      -> hello-world\n * - \"camelcase\"      -> helloWorld\n * - \"pascalcase\"     -> HelloWorld\n * - \"sentencecase\"   -> Hello world\n * - \"headercase\"     -> Hello World\n **/\nexport type StringCasing =\n  | \"lowercase\"\n  | \"uppercase\"\n  | \"snakecase\"\n  | \"kebabcase\"\n  | \"camelcase\"\n  | \"pascalcase\"\n  | \"sentencecase\"\n  | \"headercase\";\n\n/**\n * Transforms the input string into the specified casing.\n * Casing can be one of the following:\n * - \"lowercase\"      -> hello world\n * - \"uppercase\"      -> HELLO WORLD\n * - \"snakecase\"      -> hello_world\n * - \"kebabcase\"      -> hello-world\n * - \"camelcase\"      -> helloWorld\n * - \"pascalcase\"     -> HelloWorld\n * - \"sentencecase\"   -> Hello world\n * - \"headercase\"     -> Hello World\n **/\nexport const stringWithCasing = (\n  input: string,\n  casing: StringCasing,\n): string => {\n  const trimmedInput = input.trim();\n  const cleanedInput = withSafeCharacters(trimmedInput);\n\n  switch (casing) {\n    case \"lowercase\":\n      return trimmedInput.toLowerCase();\n    case \"uppercase\":\n      return trimmedInput.toUpperCase();\n    case \"snakecase\":\n      return cleanedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => a + \"_\" + b.toLowerCase())\n        .replace(/[^A-Za-z0-9]+|_+/g, \"_\")\n        .toLowerCase();\n    case \"kebabcase\":\n      return trimmedInput\n        .replace(/^[^A-Za-z0-9]*-?|[^A-Za-z0-9]*-?$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`)\n        .replace(/[^A-Za-z0-9]+|_+/g, \"-\")\n        .toLowerCase();\n    case \"camelcase\":\n      return cleanedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/[^A-Za-z0-9]+/g, \"$\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}$${b}`)\n        .toLowerCase()\n        .replace(/(\\$)(\\w)/g, (_m, _a, b) => b.toUpperCase());\n    case \"pascalcase\":\n      return cleanedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"$\")\n        .replace(/[^A-Za-z0-9]+/g, \"$\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}$${b}`)\n        .toLowerCase()\n        .replace(/(\\$)(\\w?)/g, (_m, a, b) => b.toUpperCase());\n    case \"sentencecase\": {\n      const textcase = trimmedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`)\n        .replace(/[^A-Za-z0-9]+|_+/g, \" \")\n        .toLowerCase();\n\n      return textcase.charAt(0).toUpperCase() + textcase.slice(1);\n    }\n    case \"headercase\":\n      return trimmedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`)\n        .replace(/[^A-Za-z0-9]+|_+/g, \" \")\n        .toLowerCase()\n        .replace(\n          /( ?)(\\w+)( ?)/g,\n          (m, a, b, c) => a + b.charAt(0).toUpperCase() + b.slice(1) + c,\n        );\n  }\n};\n","/**\n * Represents a valid argument for the `classNames` function.\n * It can be a string, an array of strings, undefined, null, or false.\n */\nexport type ClassnameArg = string | string[] | undefined | null | false;\n\n/**\n * Concatenates and trims the given arguments into a single string of class names.\n *\n * @param args - The arguments to be concatenated.\n * @returns A string of class names.\n */\nexport const cn = (...args: ClassnameArg[]): string => {\n  const notNullUndefinedOrFalse = args.filter((v) => !!v).flat() as string[];\n  return notNullUndefinedOrFalse\n    .flatMap((v) => v.split(\" \"))\n    .filter((v) => v.length > 0)\n    .join(\" \")\n    .trim();\n};\n","const NAME_PARTICLES = new Set([\n  // Dutch\n  \"van\",\n  \"den\",\n  \"der\",\n  \"de\",\n  \"ter\",\n  \"ten\",\n  \"te\",\n  \"het\",\n  \"'t\",\n\n  // German\n  \"von\",\n  \"vom\",\n  \"zum\",\n  \"zur\",\n  \"zu\",\n\n  // French\n  \"du\",\n  \"des\",\n  \"le\",\n  \"la\",\n  \"les\",\n\n  // Spanish and Portuguese\n  \"del\",\n  \"los\",\n  \"las\",\n  \"da\",\n  \"das\",\n  \"do\",\n  \"dos\",\n\n  // Italian\n  \"di\",\n  \"della\",\n  \"delle\",\n  \"dello\",\n  \"dei\",\n  \"degli\",\n\n  // Other common particles\n  \"al\",\n  \"el\",\n  \"bin\",\n  \"ibn\",\n  \"bint\",\n  \"af\",\n  \"av\",\n  \"ap\",\n  \"ab\",\n]);\n\nconst NAME_SUFFIXES = new Set([\n  \"jr\",\n  \"sr\",\n  \"ii\",\n  \"iii\",\n  \"iv\",\n  \"v\",\n  \"phd\",\n  \"md\",\n]);\n\nconst normalizeNamePart = (part: string): string => {\n  return part.toLocaleLowerCase().replace(/[\\p{P}\\p{S}]/gu, \"\");\n};\n\nconst getFirstLetter = (part: string): string => {\n  return part.match(/\\p{L}/u)?.[0].toLocaleUpperCase() ?? \"\";\n};\n\nexport const nameToInitials = (name: string) => {\n  const parts = name.trim().split(/\\s+/u).filter(Boolean);\n  const [firstPart] = parts;\n  if (firstPart === undefined) {\n    return \"?\";\n  }\n\n  // Ignore suffixes such as Jr., Sr. and III.\n  while (parts.length > 1 && NAME_SUFFIXES.has(normalizeNamePart(parts.at(-1)!))) {\n    parts.pop();\n  }\n\n  const firstInitial = getFirstLetter(firstPart);\n\n  if (parts.length === 1) {\n    return firstInitial;\n  }\n\n  // Find the last meaningful surname part, ignoring particles.\n  const surname = [...parts.slice(1)]\n    .reverse()\n    .find((part) => !NAME_PARTICLES.has(normalizeNamePart(part)));\n\n  // Fallback for unusual names consisting only of particles.\n  const lastInitial = getFirstLetter(surname ?? parts.at(-1)!);\n\n  return firstInitial + lastInitial;\n};\n","import type { ColorType, HSLColor, RGBColor } from \"./color.types\";\n\nconst clamp = (value: number, min: number, max: number): number =>\n  Math.min(max, Math.max(min, value));\n\nconst normalizeHue = (hue: number): number => ((hue % 360) + 360) % 360;\n\nconst normalizeAlpha = (value?: string): number => {\n  if (value === undefined) return 1;\n\n  const alpha = value.endsWith(\"%\")\n    ? Number.parseFloat(value) / 100\n    : Number.parseFloat(value);\n\n  return clamp(alpha, 0, 1);\n};\n\nconst CSS_NAMED_COLORS = new Set([\n    \"aliceblue\",\n    \"antiquewhite\",\n    \"aqua\",\n    \"aquamarine\",\n    \"azure\",\n    \"beige\",\n    \"bisque\",\n    \"black\",\n    \"blanchedalmond\",\n    \"blue\",\n    \"blueviolet\",\n    \"brown\",\n    \"burlywood\",\n    \"cadetblue\",\n    \"chartreuse\",\n    \"chocolate\",\n    \"coral\",\n    \"cornflowerblue\",\n    \"cornsilk\",\n    \"crimson\",\n    \"cyan\",\n    \"darkblue\",\n    \"darkcyan\",\n    \"darkgoldenrod\",\n    \"darkgray\",\n    \"darkgreen\",\n    \"darkgrey\",\n    \"darkkhaki\",\n    \"darkmagenta\",\n    \"darkolivegreen\",\n    \"darkorange\",\n    \"darkorchid\",\n    \"darkred\",\n    \"darksalmon\",\n    \"darkseagreen\",\n    \"darkslateblue\",\n    \"darkslategray\",\n    \"darkslategrey\",\n    \"darkturquoise\",\n    \"darkviolet\",\n    \"deeppink\",\n    \"deepskyblue\",\n    \"dimgray\",\n    \"dimgrey\",\n    \"dodgerblue\",\n    \"firebrick\",\n    \"floralwhite\",\n    \"forestgreen\",\n    \"fuchsia\",\n    \"gainsboro\",\n    \"ghostwhite\",\n    \"gold\",\n    \"goldenrod\",\n    \"gray\",\n    \"green\",\n    \"greenyellow\",\n    \"grey\",\n    \"honeydew\",\n    \"hotpink\",\n    \"indianred\",\n    \"indigo\",\n    \"ivory\",\n    \"khaki\",\n    \"lavender\",\n    \"lavenderblush\",\n    \"lawngreen\",\n    \"lemonchiffon\",\n    \"lightblue\",\n    \"lightcoral\",\n    \"lightcyan\",\n    \"lightgoldenrodyellow\",\n    \"lightgray\",\n    \"lightgreen\",\n    \"lightgrey\",\n    \"lightpink\",\n    \"lightsalmon\",\n    \"lightseagreen\",\n    \"lightskyblue\",\n    \"lightslategray\",\n    \"lightslategrey\",\n    \"lightsteelblue\",\n    \"lightyellow\",\n    \"lime\",\n    \"limegreen\",\n    \"linen\",\n    \"magenta\",\n    \"maroon\",\n    \"mediumaquamarine\",\n    \"mediumblue\",\n    \"mediumorchid\",\n    \"mediumpurple\",\n    \"mediumseagreen\",\n    \"mediumslateblue\",\n    \"mediumspringgreen\",\n    \"mediumturquoise\",\n    \"mediumvioletred\",\n    \"midnightblue\",\n    \"mintcream\",\n    \"mistyrose\",\n    \"moccasin\",\n    \"navajowhite\",\n    \"navy\",\n    \"oldlace\",\n    \"olive\",\n    \"olivedrab\",\n    \"orange\",\n    \"orangered\",\n    \"orchid\",\n    \"palegoldenrod\",\n    \"palegreen\",\n    \"paleturquoise\",\n    \"palevioletred\",\n    \"papayawhip\",\n    \"peachpuff\",\n    \"peru\",\n    \"pink\",\n    \"plum\",\n    \"powderblue\",\n    \"purple\",\n    \"rebeccapurple\",\n    \"red\",\n    \"rosybrown\",\n    \"royalblue\",\n    \"saddlebrown\",\n    \"salmon\",\n    \"sandybrown\",\n    \"seagreen\",\n    \"seashell\",\n    \"sienna\",\n    \"silver\",\n    \"skyblue\",\n    \"slateblue\",\n    \"slategray\",\n    \"slategrey\",\n    \"snow\",\n    \"springgreen\",\n    \"steelblue\",\n    \"tan\",\n    \"teal\",\n    \"thistle\",\n    \"tomato\",\n    \"turquoise\",\n    \"violet\",\n    \"wheat\",\n    \"white\",\n    \"whitesmoke\",\n    \"yellow\",\n    \"yellowgreen\",\n    \"transparent\",\n    \"currentcolor\",\n]);\n\nconst normalizeChannel = (value: string): number => {\n  const channel = value.endsWith(\"%\")\n    ? (Number.parseFloat(value) / 100) * 255\n    : Number.parseFloat(value);\n\n  return clamp(channel, 0, 255);\n};\n\nconst getColorType = (color: string): ColorType => {\n  const value = color.trim().toLowerCase();\n\n  if (/^var\\(\\s*--[\\w-]+(?:\\s*,\\s*.+)?\\)$/.test(value)) {\n    return \"css-variable\";\n  }\n\n  if (/^#[\\da-f]{8}$/.test(value) || /^#[\\da-f]{4}$/.test(value)) {\n    return \"hexa\";\n  }\n\n  if (/^#[\\da-f]{6}$/.test(value) || /^#[\\da-f]{3}$/.test(value)) {\n    return \"hex\";\n  }\n\n  if (/^rgba\\(/.test(value)) return \"rgba\";\n  if (/^rgb\\(/.test(value)) return \"rgb\";\n  if (/^hsla\\(/.test(value)) return \"hsla\";\n  if (/^hsl\\(/.test(value)) return \"hsl\";\n\n  if (/^[a-z]+$/.test(value)) return \"named\";\n\n  return \"unknown\";\n};\n\nconst isCssVariable = (color: string): boolean =>\n  getColorType(color) === \"css-variable\";\n\nconst isColor = (color: string): boolean => {\n  const type = getColorType(color);\n\n  return type === \"named\"\n    ? CSS_NAMED_COLORS.has(color.trim().toLowerCase())\n    : type !== \"unknown\";\n};\n\nconst hexToRgba = (hex: string): RGBColor => {\n  const value = hex.trim().replace(/^#/, \"\");\n\n  if (!/^(?:[\\da-f]{3}|[\\da-f]{4}|[\\da-f]{6}|[\\da-f]{8})$/i.test(value)) {\n    throw new Error(`Invalid HEX color: ${hex}`);\n  }\n\n  const expanded =\n    value.length <= 4\n      ? [...value].map((channel) => channel + channel).join(\"\")\n      : value;\n\n  const r = Number.parseInt(expanded.slice(0, 2), 16);\n  const g = Number.parseInt(expanded.slice(2, 4), 16);\n  const b = Number.parseInt(expanded.slice(4, 6), 16);\n  const a =\n    expanded.length === 8 ? Number.parseInt(expanded.slice(6, 8), 16) / 255 : 1;\n\n  return { r, g, b, a };\n};\n\nconst rgbToHex = (r: number, g: number, b: number, a?: number): string => {\n  const channelToHex = (channel: number): string =>\n    Math.round(clamp(channel, 0, 255))\n      .toString(16)\n      .padStart(2, \"0\");\n\n  const alpha =\n    a !== undefined && a < 1 ? channelToHex(clamp(a, 0, 1) * 255) : \"\";\n\n  return `#${channelToHex(r)}${channelToHex(g)}${channelToHex(b)}${alpha}`;\n};\n\nconst parseRgb = (color: string): RGBColor | null => {\n  const match = color\n    .trim()\n    .match(\n      /^rgba?\\(\\s*([\\d.]+%?)\\s*[, ]\\s*([\\d.]+%?)\\s*[, ]\\s*([\\d.]+%?)(?:\\s*[,/]\\s*([\\d.]+%?))?\\s*\\)$/i,\n    );\n\n  if (!match) return null;\n\n  const [, r, g, b, alpha] = match;\n  if (r === undefined || g === undefined || b === undefined) return null;\n\n  return {\n    r: normalizeChannel(r),\n    g: normalizeChannel(g),\n    b: normalizeChannel(b),\n    a: normalizeAlpha(alpha),\n  };\n};\n\nconst hslToRgb = ({ h, s, l, a = 1 }: HSLColor): RGBColor => {\n  const hue = normalizeHue(h) / 360;\n  const saturation = clamp(s / 100, 0, 1);\n  const lightness = clamp(l / 100, 0, 1);\n\n  const channel = (n: number): number => {\n    const k = (n + hue * 12) % 12;\n    const chroma = saturation * Math.min(lightness, 1 - lightness);\n\n    return Math.round(\n      (lightness - chroma * Math.max(-1, Math.min(k - 3, 9 - k, 1))) * 255,\n    );\n  };\n\n  return {\n    r: channel(0),\n    g: channel(8),\n    b: channel(4),\n    a: clamp(a, 0, 1),\n  };\n};\n\nconst rgbToHsl = ({ r, g, b, a = 1 }: RGBColor): HSLColor => {\n  const red = r / 255;\n  const green = g / 255;\n  const blue = b / 255;\n\n  const max = Math.max(red, green, blue);\n  const min = Math.min(red, green, blue);\n  const delta = max - min;\n\n  const l = (max + min) / 2;\n\n  let h = 0;\n  let s = 0;\n\n  if (delta !== 0) {\n    s = delta / (1 - Math.abs(2 * l - 1));\n\n    if (max === red) {\n      h = 60 * (((green - blue) / delta) % 6);\n    } else if (max === green) {\n      h = 60 * ((blue - red) / delta + 2);\n    } else {\n      h = 60 * ((red - green) / delta + 4);\n    }\n  }\n\n  return {\n    h: normalizeHue(h),\n    s: s * 100,\n    l: l * 100,\n    a,\n  };\n};\n\nconst parseHsl = (color: string): RGBColor | null => {\n  const match = color\n    .trim()\n    .match(\n      /^hsla?\\(\\s*([\\d.]+)(?:deg)?\\s*[, ]\\s*([\\d.]+)%\\s*[, ]\\s*([\\d.]+)%(?:\\s*[,/]\\s*([\\d.]+%?))?\\s*\\)$/i,\n    );\n\n  if (!match) return null;\n\n  const [, h, s, l, alpha] = match;\n\n  return hslToRgb({\n    h: Number(h),\n    s: Number(s),\n    l: Number(l),\n    a: normalizeAlpha(alpha),\n  });\n};\n\nconst parseColor = (color: string): RGBColor | null => {\n  const type = getColorType(color);\n\n  if (type === \"hex\" || type === \"hexa\") {\n    return hexToRgba(color);\n  }\n\n  if (type === \"rgb\" || type === \"rgba\") {\n    return parseRgb(color);\n  }\n\n  if (type === \"hsl\" || type === \"hsla\") {\n    return parseHsl(color);\n  }\n\n  return null;\n};\n\nconst rgbToCss = ({ r, g, b, a }: RGBColor): string =>\n  a < 1\n    ? `rgba(${Math.round(r)}, ${Math.round(g)}, ${Math.round(b)}, ${Number(a.toFixed(3))})`\n    : `rgb(${Math.round(r)}, ${Math.round(g)}, ${Math.round(b)})`;\n\nconst hslToCss = ({ h, s, l, a }: HSLColor): string =>\n  a < 1\n    ? `hsla(${Math.round(h)}, ${Math.round(s)}%, ${Math.round(l)}%, ${Number(a.toFixed(3))})`\n    : `hsl(${Math.round(h)}, ${Math.round(s)}%, ${Math.round(l)}%)`;\n\nconst getColorLuminance = (color: string): number | null => {\n  const rgb = parseColor(color);\n\n  if (!rgb) return null;\n\n  const linearize = (value: number): number => {\n    const channel = value / 255;\n\n    return channel <= 0.04045\n      ? channel / 12.92\n      : ((channel + 0.055) / 1.055) ** 2.4;\n  };\n\n  return (\n    0.2126 * linearize(rgb.r) +\n    0.7152 * linearize(rgb.g) +\n    0.0722 * linearize(rgb.b)\n  );\n};\n\nconst isColorDark = (color: string): boolean | null => {\n  const luminance = getColorLuminance(color);\n\n  return luminance === null ? null : luminance < 0.179;\n};\n\nexport {\n  clamp,\n  getColorType,\n  isCssVariable,\n  isColor,\n  hexToRgba,\n  rgbToHex,\n  parseRgb,\n  parseColor,\n  hslToRgb,\n  rgbToHsl,\n  rgbToCss,\n  hslToCss,\n  getColorLuminance,\n  isColorDark,\n};\n","import {\n  getColorType,\n  isColor,\n  isColorDark,\n  isCssVariable,\n} from \"./color.utils\";\n\nexport const isHexColor = (color: string): boolean =>\n  /^#(?:[\\da-f]{3}|[\\da-f]{4}|[\\da-f]{6}|[\\da-f]{8})$/i.test(color.trim());\n\nexport const isDarkColor = (color: string): boolean => {\n  const result = isColorDark(color);\n\n  if (result === null) {\n    throw new Error(`Unsupported color: ${color}`);\n  }\n\n  return result;\n};\n\nexport { getColorType, isColor, isCssVariable, isColorDark };\n","import { hexToRgba } from \"./color.utils\";\n\nexport const hexToRgb = (hex: string): { r: number; g: number; b: number } => {\n  const { r, g, b } = hexToRgba(hex);\n\n  return { r, g, b };\n};\n\nexport const rgbToHex = (\n  r: number,\n  g: number,\n  b: number,\n  a?: number,\n): string => {\n  const channel = (value: number): string =>\n    Math.round(Math.min(255, Math.max(0, value)))\n      .toString(16)\n      .padStart(2, \"0\");\n\n  const alpha =\n    a !== undefined && a < 1 ? channel(Math.min(1, Math.max(0, a)) * 255) : \"\";\n\n  return `#${channel(r)}${channel(g)}${channel(b)}${alpha}`;\n};\n","/**\n * Call the original function, but applying the debounce rules.\n *\n * Only the last call to the function shall be executed after the timeout has been reached.\n * @returns the debounced function with a cancel function property to clear the timeout.\n */\nconst debounce = <T extends unknown[]>(\n  func: (...args: T) => void,\n  wait: number,\n) => {\n  let timeout: ReturnType<typeof setTimeout>;\n\n  const cancel = () => clearTimeout(timeout);\n\n  return Object.assign(\n    (...args: T) => {\n      clearTimeout(timeout);\n      timeout = setTimeout(() => func.apply(this, args), wait);\n    },\n    { cancel },\n  );\n};\n\nexport { debounce };\n"],"mappings":"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E,CAEzB;AAClC;;ACnGA,MAAM,SAAS,OAAe,KAAa,QACzC,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;AAEpC,MAAM,gBAAgB,SAA0B,MAAM,MAAO,OAAO;AAEpE,MAAM,kBAAkB,UAA2B;CACjD,IAAI,UAAU,KAAA,GAAW,OAAO;CAEhC,MAAM,QAAQ,MAAM,SAAS,GAAG,IAC5B,OAAO,WAAW,KAAK,IAAI,MAC3B,OAAO,WAAW,KAAK;CAE3B,OAAO,MAAM,OAAO,GAAG,CAAC;AAC1B;AAEA,MAAM,mCAAmB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ,CAAC;AAED,MAAM,oBAAoB,UAA0B;CAClD,MAAM,UAAU,MAAM,SAAS,GAAG,IAC7B,OAAO,WAAW,KAAK,IAAI,MAAO,MACnC,OAAO,WAAW,KAAK;CAE3B,OAAO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"}

package/dist/index.d.cts

@@ -52,15 +52,40 @@ type ClassnameArg = string | string[] | undefined | null | false;
  */
 export declare const cn: (...args: ClassnameArg[]) => string;
 export declare const nameToInitials: (name: string) => string;
+type ColorType = "hex" | "hexa" | "rgb" | "rgba" | "hsl" | "hsla" | "named" | "css-variable" | "unknown";
+type RGBColor = {
+  r: number;
+  g: number;
+  b: number;
+  a: number;
+};
+type HSLColor = {
+  h: number;
+  s: number;
+  l: number;
+  a: number;
+};
+declare const clamp: (value: number, min: number, max: number) => number;
+declare const getColorType: (color: string) => ColorType;
+declare const isCssVariable: (color: string) => boolean;
+declare const isColor: (color: string) => boolean;
+declare const hexToRgba: (hex: string) => RGBColor;
+declare const parseRgb: (color: string) => RGBColor | null;
+declare const hslToRgb: ({ h, s, l, a }: HSLColor) => RGBColor;
+declare const rgbToHsl: ({ r, g, b, a }: RGBColor) => HSLColor;
+declare const parseColor: (color: string) => RGBColor | null;
+declare const rgbToCss: ({ r, g, b, a }: RGBColor) => string;
+declare const hslToCss: ({ h, s, l, a }: HSLColor) => string;
+declare const getColorLuminance: (color: string) => number | null;
+declare const isColorDark: (color: string) => boolean | null;
 export declare const isHexColor: (color: string) => boolean;
-/** Returns whether a color is dark based on WCAG relative luminance. */
 export declare const isDarkColor: (color: string) => boolean;
 export declare const hexToRgb: (hex: string) => {
   r: number;
   g: number;
   b: number;
 };
-export declare const rgbToHex: (r: number, g: number, b: number) => string;
+export declare const rgbToHex: (r: number, g: number, b: number, a?: number) => string;
 /**
  * Call the original function, but applying the debounce rules.
  *
@@ -70,4 +95,4 @@ export declare const rgbToHex: (r: number, g: number, b: number) => string;
 declare const debounce: <T extends unknown[]>(func: (...args: T) => void, wait: number) => ((...args: T) => void) & {
   cancel: () => void;
 };
-export { type Breakpoint, type ClassnameArg, type DeepPartial, type ResponsiveConfig, type ResponsiveValue, debounce, resolveResponsiveValue, resolveResponsiveValueForBreakpoint };
+export { type Breakpoint, type ClassnameArg, type ColorType, type DeepPartial, type HSLColor, type RGBColor, type ResponsiveConfig, type ResponsiveValue, clamp, debounce, getColorLuminance, getColorType, hexToRgba, hslToCss, hslToRgb, isColor, isColorDark, isCssVariable, parseColor, parseRgb, resolveResponsiveValue, resolveResponsiveValueForBreakpoint, rgbToCss, rgbToHsl };

package/dist/index.d.ts

@@ -52,15 +52,40 @@ type ClassnameArg = string | string[] | undefined | null | false;
  */
 export declare const cn: (...args: ClassnameArg[]) => string;
 export declare const nameToInitials: (name: string) => string;
+type ColorType = "hex" | "hexa" | "rgb" | "rgba" | "hsl" | "hsla" | "named" | "css-variable" | "unknown";
+type RGBColor = {
+  r: number;
+  g: number;
+  b: number;
+  a: number;
+};
+type HSLColor = {
+  h: number;
+  s: number;
+  l: number;
+  a: number;
+};
+declare const clamp: (value: number, min: number, max: number) => number;
+declare const getColorType: (color: string) => ColorType;
+declare const isCssVariable: (color: string) => boolean;
+declare const isColor: (color: string) => boolean;
+declare const hexToRgba: (hex: string) => RGBColor;
+declare const parseRgb: (color: string) => RGBColor | null;
+declare const hslToRgb: ({ h, s, l, a }: HSLColor) => RGBColor;
+declare const rgbToHsl: ({ r, g, b, a }: RGBColor) => HSLColor;
+declare const parseColor: (color: string) => RGBColor | null;
+declare const rgbToCss: ({ r, g, b, a }: RGBColor) => string;
+declare const hslToCss: ({ h, s, l, a }: HSLColor) => string;
+declare const getColorLuminance: (color: string) => number | null;
+declare const isColorDark: (color: string) => boolean | null;
 export declare const isHexColor: (color: string) => boolean;
-/** Returns whether a color is dark based on WCAG relative luminance. */
 export declare const isDarkColor: (color: string) => boolean;
 export declare const hexToRgb: (hex: string) => {
   r: number;
   g: number;
   b: number;
 };
-export declare const rgbToHex: (r: number, g: number, b: number) => string;
+export declare const rgbToHex: (r: number, g: number, b: number, a?: number) => string;
 /**
  * Call the original function, but applying the debounce rules.
  *
@@ -70,4 +95,4 @@ export declare const rgbToHex: (r: number, g: number, b: number) => string;
 declare const debounce: <T extends unknown[]>(func: (...args: T) => void, wait: number) => ((...args: T) => void) & {
   cancel: () => void;
 };
-export { type Breakpoint, type ClassnameArg, type DeepPartial, type ResponsiveConfig, type ResponsiveValue, debounce, resolveResponsiveValue, resolveResponsiveValueForBreakpoint };
+export { type Breakpoint, type ClassnameArg, type ColorType, type DeepPartial, type HSLColor, type RGBColor, type ResponsiveConfig, type ResponsiveValue, clamp, debounce, getColorLuminance, getColorType, hexToRgba, hslToCss, hslToRgb, isColor, isColorDark, isCssVariable, parseColor, parseRgb, resolveResponsiveValue, resolveResponsiveValueForBreakpoint, rgbToCss, rgbToHsl };

package/dist/index.js

@@ -145,51 +145,310 @@ const getFirstLetter = (part) => {
 };
 const nameToInitials = (name) => {
 	const parts = name.trim().split(/\s+/u).filter(Boolean);
-	if (parts.length === 0) return "?";
-	while (parts.length > 1 && NAME_SUFFIXES.has(normalizeNamePart(parts[parts.length - 1]))) parts.pop();
-	const firstInitial = getFirstLetter(parts[0]);
+	const [firstPart] = parts;
+	if (firstPart === void 0) return "?";
+	while (parts.length > 1 && NAME_SUFFIXES.has(normalizeNamePart(parts.at(-1)))) parts.pop();
+	const firstInitial = getFirstLetter(firstPart);
 	if (parts.length === 1) return firstInitial;
 	const surname = [...parts.slice(1)].reverse().find((part) => !NAME_PARTICLES.has(normalizeNamePart(part)));
-	return firstInitial + getFirstLetter(surname ?? parts[parts.length - 1]);
+	return firstInitial + getFirstLetter(surname ?? parts.at(-1));
 };
-// src/color/to-color.ts
-const hexToRgb = (hex) => {
-	if (!/^#([0-9A-F]{3}){1,2}$/i.test(hex)) throw new Error("Invalid hex color");
-	let r, g, b;
-	if (hex.length === 4) {
-		r = parseInt(hex[1] + hex[1], 16);
-		g = parseInt(hex[2] + hex[2], 16);
-		b = parseInt(hex[3] + hex[3], 16);
-	} else {
-		r = parseInt(hex.slice(1, 3), 16);
-		g = parseInt(hex.slice(3, 5), 16);
-		b = parseInt(hex.slice(5, 7), 16);
+// src/color/color.utils.ts
+const clamp = (value, min, max) => Math.min(max, Math.max(min, value));
+const normalizeHue = (hue) => (hue % 360 + 360) % 360;
+const normalizeAlpha = (value) => {
+	if (value === void 0) return 1;
+	const alpha = value.endsWith("%") ? Number.parseFloat(value) / 100 : Number.parseFloat(value);
+	return clamp(alpha, 0, 1);
+};
+const CSS_NAMED_COLORS = /* @__PURE__ */ new Set([
+	"aliceblue",
+	"antiquewhite",
+	"aqua",
+	"aquamarine",
+	"azure",
+	"beige",
+	"bisque",
+	"black",
+	"blanchedalmond",
+	"blue",
+	"blueviolet",
+	"brown",
+	"burlywood",
+	"cadetblue",
+	"chartreuse",
+	"chocolate",
+	"coral",
+	"cornflowerblue",
+	"cornsilk",
+	"crimson",
+	"cyan",
+	"darkblue",
+	"darkcyan",
+	"darkgoldenrod",
+	"darkgray",
+	"darkgreen",
+	"darkgrey",
+	"darkkhaki",
+	"darkmagenta",
+	"darkolivegreen",
+	"darkorange",
+	"darkorchid",
+	"darkred",
+	"darksalmon",
+	"darkseagreen",
+	"darkslateblue",
+	"darkslategray",
+	"darkslategrey",
+	"darkturquoise",
+	"darkviolet",
+	"deeppink",
+	"deepskyblue",
+	"dimgray",
+	"dimgrey",
+	"dodgerblue",
+	"firebrick",
+	"floralwhite",
+	"forestgreen",
+	"fuchsia",
+	"gainsboro",
+	"ghostwhite",
+	"gold",
+	"goldenrod",
+	"gray",
+	"green",
+	"greenyellow",
+	"grey",
+	"honeydew",
+	"hotpink",
+	"indianred",
+	"indigo",
+	"ivory",
+	"khaki",
+	"lavender",
+	"lavenderblush",
+	"lawngreen",
+	"lemonchiffon",
+	"lightblue",
+	"lightcoral",
+	"lightcyan",
+	"lightgoldenrodyellow",
+	"lightgray",
+	"lightgreen",
+	"lightgrey",
+	"lightpink",
+	"lightsalmon",
+	"lightseagreen",
+	"lightskyblue",
+	"lightslategray",
+	"lightslategrey",
+	"lightsteelblue",
+	"lightyellow",
+	"lime",
+	"limegreen",
+	"linen",
+	"magenta",
+	"maroon",
+	"mediumaquamarine",
+	"mediumblue",
+	"mediumorchid",
+	"mediumpurple",
+	"mediumseagreen",
+	"mediumslateblue",
+	"mediumspringgreen",
+	"mediumturquoise",
+	"mediumvioletred",
+	"midnightblue",
+	"mintcream",
+	"mistyrose",
+	"moccasin",
+	"navajowhite",
+	"navy",
+	"oldlace",
+	"olive",
+	"olivedrab",
+	"orange",
+	"orangered",
+	"orchid",
+	"palegoldenrod",
+	"palegreen",
+	"paleturquoise",
+	"palevioletred",
+	"papayawhip",
+	"peachpuff",
+	"peru",
+	"pink",
+	"plum",
+	"powderblue",
+	"purple",
+	"rebeccapurple",
+	"red",
+	"rosybrown",
+	"royalblue",
+	"saddlebrown",
+	"salmon",
+	"sandybrown",
+	"seagreen",
+	"seashell",
+	"sienna",
+	"silver",
+	"skyblue",
+	"slateblue",
+	"slategray",
+	"slategrey",
+	"snow",
+	"springgreen",
+	"steelblue",
+	"tan",
+	"teal",
+	"thistle",
+	"tomato",
+	"turquoise",
+	"violet",
+	"wheat",
+	"white",
+	"whitesmoke",
+	"yellow",
+	"yellowgreen",
+	"transparent",
+	"currentcolor"
+]);
+const normalizeChannel = (value) => {
+	const channel = value.endsWith("%") ? Number.parseFloat(value) / 100 * 255 : Number.parseFloat(value);
+	return clamp(channel, 0, 255);
+};
+const getColorType = (color) => {
+	const value = color.trim().toLowerCase();
+	if (/^var\(\s*--[\w-]+(?:\s*,\s*.+)?\)$/.test(value)) return "css-variable";
+	if (/^#[\da-f]{8}$/.test(value) || /^#[\da-f]{4}$/.test(value)) return "hexa";
+	if (/^#[\da-f]{6}$/.test(value) || /^#[\da-f]{3}$/.test(value)) return "hex";
+	if (/^rgba\(/.test(value)) return "rgba";
+	if (/^rgb\(/.test(value)) return "rgb";
+	if (/^hsla\(/.test(value)) return "hsla";
+	if (/^hsl\(/.test(value)) return "hsl";
+	if (/^[a-z]+$/.test(value)) return "named";
+	return "unknown";
+};
+const isCssVariable = (color) => getColorType(color) === "css-variable";
+const isColor = (color) => {
+	const type = getColorType(color);
+	return type === "named" ? CSS_NAMED_COLORS.has(color.trim().toLowerCase()) : type !== "unknown";
+};
+const hexToRgba = (hex) => {
+	const value = hex.trim().replace(/^#/, "");
+	if (!/^(?:[\da-f]{3}|[\da-f]{4}|[\da-f]{6}|[\da-f]{8})$/i.test(value)) throw new Error(`Invalid HEX color: ${hex}`);
+	const expanded = value.length <= 4 ? [...value].map((channel) => channel + channel).join("") : value;
+	return {
+		r: Number.parseInt(expanded.slice(0, 2), 16),
+		g: Number.parseInt(expanded.slice(2, 4), 16),
+		b: Number.parseInt(expanded.slice(4, 6), 16),
+		a: expanded.length === 8 ? Number.parseInt(expanded.slice(6, 8), 16) / 255 : 1
+	};
+};
+const parseRgb = (color) => {
+	const match = color.trim().match(/^rgba?\(\s*([\d.]+%?)\s*[, ]\s*([\d.]+%?)\s*[, ]\s*([\d.]+%?)(?:\s*[,/]\s*([\d.]+%?))?\s*\)$/i);
+	if (!match) return null;
+	const [, r, g, b, alpha] = match;
+	if (r === void 0 || g === void 0 || b === void 0) return null;
+	return {
+		r: normalizeChannel(r),
+		g: normalizeChannel(g),
+		b: normalizeChannel(b),
+		a: normalizeAlpha(alpha)
+	};
+};
+const hslToRgb = ({ h, s, l, a = 1 }) => {
+	const hue = normalizeHue(h) / 360;
+	const saturation = clamp(s / 100, 0, 1);
+	const lightness = clamp(l / 100, 0, 1);
+	const channel = (n) => {
+		const k = (n + hue * 12) % 12;
+		const chroma = saturation * Math.min(lightness, 1 - lightness);
+		return Math.round((lightness - chroma * Math.max(-1, Math.min(k - 3, 9 - k, 1))) * 255);
+	};
+	return {
+		r: channel(0),
+		g: channel(8),
+		b: channel(4),
+		a: clamp(a, 0, 1)
+	};
+};
+const rgbToHsl = ({ r, g, b, a = 1 }) => {
+	const red = r / 255;
+	const green = g / 255;
+	const blue = b / 255;
+	const max = Math.max(red, green, blue);
+	const min = Math.min(red, green, blue);
+	const delta = max - min;
+	const l = (max + min) / 2;
+	let h = 0;
+	let s = 0;
+	if (delta !== 0) {
+		s = delta / (1 - Math.abs(2 * l - 1));
+		if (max === red) h = 60 * ((green - blue) / delta % 6);
+		else if (max === green) h = 60 * ((blue - red) / delta + 2);
+		else h = 60 * ((red - green) / delta + 4);
 	}
 	return {
-		r,
-		g,
-		b
+		h: normalizeHue(h),
+		s: s * 100,
+		l: l * 100,
+		a
 	};
 };
-const rgbToHex = (r, g, b) => {
-	const toHex = (value) => {
-		const hex = value.toString(16);
-		return hex.length === 1 ? "0" + hex : hex;
+const parseHsl = (color) => {
+	const match = color.trim().match(/^hsla?\(\s*([\d.]+)(?:deg)?\s*[, ]\s*([\d.]+)%\s*[, ]\s*([\d.]+)%(?:\s*[,/]\s*([\d.]+%?))?\s*\)$/i);
+	if (!match) return null;
+	const [, h, s, l, alpha] = match;
+	return hslToRgb({
+		h: Number(h),
+		s: Number(s),
+		l: Number(l),
+		a: normalizeAlpha(alpha)
+	});
+};
+const parseColor = (color) => {
+	const type = getColorType(color);
+	if (type === "hex" || type === "hexa") return hexToRgba(color);
+	if (type === "rgb" || type === "rgba") return parseRgb(color);
+	if (type === "hsl" || type === "hsla") return parseHsl(color);
+	return null;
+};
+const rgbToCss = ({ r, g, b, a }) => a < 1 ? `rgba(${Math.round(r)}, ${Math.round(g)}, ${Math.round(b)}, ${Number(a.toFixed(3))})` : `rgb(${Math.round(r)}, ${Math.round(g)}, ${Math.round(b)})`;
+const hslToCss = ({ h, s, l, a }) => a < 1 ? `hsla(${Math.round(h)}, ${Math.round(s)}%, ${Math.round(l)}%, ${Number(a.toFixed(3))})` : `hsl(${Math.round(h)}, ${Math.round(s)}%, ${Math.round(l)}%)`;
+const getColorLuminance = (color) => {
+	const rgb = parseColor(color);
+	if (!rgb) return null;
+	const linearize = (value) => {
+		const channel = value / 255;
+		return channel <= .04045 ? channel / 12.92 : ((channel + .055) / 1.055) ** 2.4;
 	};
-	return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+	return .2126 * linearize(rgb.r) + .7152 * linearize(rgb.g) + .0722 * linearize(rgb.b);
+};
+const isColorDark = (color) => {
+	const luminance = getColorLuminance(color);
+	return luminance === null ? null : luminance < .179;
 };
 // src/color/is-color.ts
-const isHexColor = (color) => {
-	return /^#([0-9A-F]{3}){1,2}$/i.test(color);
+const isHexColor = (color) => /^#(?:[\da-f]{3}|[\da-f]{4}|[\da-f]{6}|[\da-f]{8})$/i.test(color.trim());
+const isDarkColor = (color) => {
+	const result = isColorDark(color);
+	if (result === null) throw new Error(`Unsupported color: ${color}`);
+	return result;
 };
-const linearize = (value) => {
-	const channel = value / 255;
-	return channel <= .04045 ? channel / 12.92 : ((channel + .055) / 1.055) ** 2.4;
+// src/color/to-color.ts
+const hexToRgb = (hex) => {
+	const { r, g, b } = hexToRgba(hex);
+	return {
+		r,
+		g,
+		b
+	};
 };
-/** Returns whether a color is dark based on WCAG relative luminance. */
-const isDarkColor = (color) => {
-	const { r, g, b } = hexToRgb(color);
-	return .2126 * linearize(r) + .7152 * linearize(g) + .0722 * linearize(b) < .179;
+const rgbToHex = (r, g, b, a) => {
+	const channel = (value) => Math.round(Math.min(255, Math.max(0, value))).toString(16).padStart(2, "0");
+	const alpha = a !== void 0 && a < 1 ? channel(Math.min(1, Math.max(0, a)) * 255) : "";
+	return `#${channel(r)}${channel(g)}${channel(b)}${alpha}`;
 };
 // src/timing/debounce.ts
 /**
@@ -206,6 +465,6 @@ const debounce = (func, wait) => {
 		timeout = setTimeout(() => func.apply(void 0, args), wait);
 	}, { cancel });
 };
-export { BREAKPOINTS, assertSafeCssValue, cn, debounce, escapeCssString, hexToRgb, isDarkColor, isHexColor, nameToInitials, normalizeSearchString, resolveResponsiveValue, resolveResponsiveValueForBreakpoint, rgbToHex, stringWithCasing, withSafeCharacters };
+export { BREAKPOINTS, assertSafeCssValue, clamp, cn, debounce, escapeCssString, getColorLuminance, getColorType, hexToRgb, hexToRgba, hslToCss, hslToRgb, isColor, isColorDark, isCssVariable, isDarkColor, isHexColor, nameToInitials, normalizeSearchString, parseColor, parseRgb, resolveResponsiveValue, resolveResponsiveValueForBreakpoint, rgbToCss, rgbToHex, rgbToHsl, stringWithCasing, withSafeCharacters };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/responsive/constants.ts","../src/responsive/index.ts","../src/string/assert.ts","../src/string/normalize.ts","../src/string/casing.ts","../src/string/class-names.ts","../src/string/name-to-initials.ts","../src/color/to-color.ts","../src/color/is-color.ts","../src/timing/debounce.ts"],"sourcesContent":["export const BREAKPOINTS = [\"mobile\", \"tablet\", \"desktop\"] as const;\n","import type { Breakpoint, ResponsiveConfig, ResponsiveValue } from \"./types\";\n\nconst resolveResponsiveValueForBreakpoint = <T>(\n  breakpoint: Breakpoint,\n  value: ResponsiveValue<T>,\n  fallback?: T,\n): T => {\n  if (value === undefined || value === null) {\n    return fallback as T;\n  }\n  const isNonResponsive = typeof value !== \"object\" || !(breakpoint in value);\n  const resolved = isNonResponsive\n    ? ((value ?? fallback) as T)\n    : ((value as ResponsiveConfig<T>)[breakpoint] ?? (fallback as T));\n  return resolved;\n};\n\nconst resolveResponsiveValue = <T>(\n  value: ResponsiveValue<T>,\n  fallback?: T,\n): Required<ResponsiveConfig<T>> => {\n  const mobile = resolveResponsiveValueForBreakpoint(\"mobile\", value, fallback);\n  const tablet = resolveResponsiveValueForBreakpoint(\"tablet\", value, mobile);\n  const desktop = resolveResponsiveValueForBreakpoint(\"desktop\", value, tablet);\n\n  return {\n    mobile,\n    tablet,\n    desktop,\n  };\n};\n\nexport { resolveResponsiveValue, resolveResponsiveValueForBreakpoint };\nexport { BREAKPOINTS } from \"./constants\";\nexport type { Breakpoint, ResponsiveConfig, ResponsiveValue } from \"./types\";\n","export const assertSafeCssValue = (value: unknown, label: string) => {\n  if (typeof value !== \"string\" && typeof value !== \"number\") {\n    throw new TypeError(`${label} must be a string or number.`);\n  }\n\n  const serialized = String(value).trim();\n  if (\n    serialized.length === 0 ||\n    /[;{}<>\\u0000-\\u001f\\u007f]/.test(serialized)\n  ) {\n    throw new TypeError(\n      `${label} must be a non-empty CSS value and must not contain semicolons, braces, angle brackets, or control characters.`,\n    );\n  }\n  return serialized;\n};\n","/** Normalizes a search string by removing diacritics and converting to lowercase */\nexport const normalizeSearchString = (value: string): string =>\n  value\n    .normalize(\"NFD\")\n    .replace(/[\\u0300-\\u036f]/g, \"\")\n    .toLocaleLowerCase();\n\n/** Removes unsafe characters from a string */\nexport const withSafeCharacters = (input: string): string =>\n  input\n    .trim()\n    .normalize(\"NFD\")\n    .replace(/[\\u0300-\\u036f]/g, \"\")\n    .replace(/[^a-zA-Z0-9\\s-]/g, \"\")\n    .replace(\n      /([A-Z].*[^\\s][A-Z])/g,\n      \"$1\".slice(0, 1).toUpperCase() + \"$1\".slice(1).toLowerCase(),\n    );\n\n/** Escapes special characters in a string for use in CSS strings */\nexport const escapeCssString = (value: string): string => {\n  return value.replace(/[\"\\\\\\n\\r\\f]/g, (character) => {\n    switch (character) {\n      case '\"':\n        return '\\\\\"';\n      case \"\\\\\":\n        return \"\\\\\\\\\";\n      case \"\\n\":\n        return \"\\\\a \";\n      case \"\\r\":\n        return \"\\\\d \";\n      case \"\\f\":\n        return \"\\\\c \";\n      default:\n        return character;\n    }\n  });\n};\n","import { withSafeCharacters } from \"./normalize\";\n\n/**\n * Represents the casing options for strings.\n * - \"lowercase\"      -> hello world\n * - \"uppercase\"      -> HELLO WORLD\n * - \"snakecase\"      -> hello_world\n * - \"kebabcase\"      -> hello-world\n * - \"camelcase\"      -> helloWorld\n * - \"pascalcase\"     -> HelloWorld\n * - \"sentencecase\"   -> Hello world\n * - \"headercase\"     -> Hello World\n **/\nexport type StringCasing =\n  | \"lowercase\"\n  | \"uppercase\"\n  | \"snakecase\"\n  | \"kebabcase\"\n  | \"camelcase\"\n  | \"pascalcase\"\n  | \"sentencecase\"\n  | \"headercase\";\n\n/**\n * Transforms the input string into the specified casing.\n * Casing can be one of the following:\n * - \"lowercase\"      -> hello world\n * - \"uppercase\"      -> HELLO WORLD\n * - \"snakecase\"      -> hello_world\n * - \"kebabcase\"      -> hello-world\n * - \"camelcase\"      -> helloWorld\n * - \"pascalcase\"     -> HelloWorld\n * - \"sentencecase\"   -> Hello world\n * - \"headercase\"     -> Hello World\n **/\nexport const stringWithCasing = (\n  input: string,\n  casing: StringCasing,\n): string => {\n  const trimmedInput = input.trim();\n  const cleanedInput = withSafeCharacters(trimmedInput);\n\n  switch (casing) {\n    case \"lowercase\":\n      return trimmedInput.toLowerCase();\n    case \"uppercase\":\n      return trimmedInput.toUpperCase();\n    case \"snakecase\":\n      return cleanedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => a + \"_\" + b.toLowerCase())\n        .replace(/[^A-Za-z0-9]+|_+/g, \"_\")\n        .toLowerCase();\n    case \"kebabcase\":\n      return trimmedInput\n        .replace(/^[^A-Za-z0-9]*-?|[^A-Za-z0-9]*-?$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`)\n        .replace(/[^A-Za-z0-9]+|_+/g, \"-\")\n        .toLowerCase();\n    case \"camelcase\":\n      return cleanedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/[^A-Za-z0-9]+/g, \"$\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}$${b}`)\n        .toLowerCase()\n        .replace(/(\\$)(\\w)/g, (_m, _a, b) => b.toUpperCase());\n    case \"pascalcase\":\n      return cleanedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"$\")\n        .replace(/[^A-Za-z0-9]+/g, \"$\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}$${b}`)\n        .toLowerCase()\n        .replace(/(\\$)(\\w?)/g, (_m, a, b) => b.toUpperCase());\n    case \"sentencecase\": {\n      const textcase = trimmedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`)\n        .replace(/[^A-Za-z0-9]+|_+/g, \" \")\n        .toLowerCase();\n\n      return textcase.charAt(0).toUpperCase() + textcase.slice(1);\n    }\n    case \"headercase\":\n      return trimmedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`)\n        .replace(/[^A-Za-z0-9]+|_+/g, \" \")\n        .toLowerCase()\n        .replace(\n          /( ?)(\\w+)( ?)/g,\n          (m, a, b, c) => a + b.charAt(0).toUpperCase() + b.slice(1) + c,\n        );\n  }\n};\n","/**\n * Represents a valid argument for the `classNames` function.\n * It can be a string, an array of strings, undefined, null, or false.\n */\nexport type ClassnameArg = string | string[] | undefined | null | false;\n\n/**\n * Concatenates and trims the given arguments into a single string of class names.\n *\n * @param args - The arguments to be concatenated.\n * @returns A string of class names.\n */\nexport const cn = (...args: ClassnameArg[]): string => {\n  const notNullUndefinedOrFalse = args.filter((v) => !!v).flat() as string[];\n  return notNullUndefinedOrFalse\n    .flatMap((v) => v.split(\" \"))\n    .filter((v) => v.length > 0)\n    .join(\" \")\n    .trim();\n};\n","const NAME_PARTICLES = new Set([\n  // Dutch\n  \"van\",\n  \"den\",\n  \"der\",\n  \"de\",\n  \"ter\",\n  \"ten\",\n  \"te\",\n  \"het\",\n  \"'t\",\n\n  // German\n  \"von\",\n  \"vom\",\n  \"zum\",\n  \"zur\",\n  \"zu\",\n\n  // French\n  \"du\",\n  \"des\",\n  \"le\",\n  \"la\",\n  \"les\",\n\n  // Spanish and Portuguese\n  \"del\",\n  \"los\",\n  \"las\",\n  \"da\",\n  \"das\",\n  \"do\",\n  \"dos\",\n\n  // Italian\n  \"di\",\n  \"della\",\n  \"delle\",\n  \"dello\",\n  \"dei\",\n  \"degli\",\n\n  // Other common particles\n  \"al\",\n  \"el\",\n  \"bin\",\n  \"ibn\",\n  \"bint\",\n  \"af\",\n  \"av\",\n  \"ap\",\n  \"ab\",\n]);\n\nconst NAME_SUFFIXES = new Set([\n  \"jr\",\n  \"sr\",\n  \"ii\",\n  \"iii\",\n  \"iv\",\n  \"v\",\n  \"phd\",\n  \"md\",\n]);\n\nconst normalizeNamePart = (part: string): string => {\n  return part.toLocaleLowerCase().replace(/[\\p{P}\\p{S}]/gu, \"\");\n};\n\nconst getFirstLetter = (part: string): string => {\n  return part.match(/\\p{L}/u)?.[0].toLocaleUpperCase() ?? \"\";\n};\n\nexport const nameToInitials = (name: string) => {\n  const parts = name.trim().split(/\\s+/u).filter(Boolean);\n  if (parts.length === 0) {\n    return \"?\";\n  }\n\n  // Ignore suffixes such as Jr., Sr. and III.\n  while (\n    parts.length > 1 &&\n    NAME_SUFFIXES.has(normalizeNamePart(parts[parts.length - 1]))\n  ) {\n    parts.pop();\n  }\n\n  const firstInitial = getFirstLetter(parts[0]);\n\n  if (parts.length === 1) {\n    return firstInitial;\n  }\n\n  // Find the last meaningful surname part, ignoring particles.\n  const surname = [...parts.slice(1)]\n    .reverse()\n    .find((part) => !NAME_PARTICLES.has(normalizeNamePart(part)));\n\n  // Fallback for unusual names consisting only of particles.\n  const lastInitial = getFirstLetter(surname ?? parts[parts.length - 1]);\n\n  return firstInitial + lastInitial;\n};\n","export const hexToRgb = (hex: string): { r: number; g: number; b: number } => {\n  if (!/^#([0-9A-F]{3}){1,2}$/i.test(hex)) {\n    throw new Error(\"Invalid hex color\");\n  }\n  let r: number, g: number, b: number;\n  if (hex.length === 4) {\n    r = parseInt(hex[1] + hex[1], 16);\n    g = parseInt(hex[2] + hex[2], 16);\n    b = parseInt(hex[3] + hex[3], 16);\n  } else {\n    r = parseInt(hex.slice(1, 3), 16);\n    g = parseInt(hex.slice(3, 5), 16);\n    b = parseInt(hex.slice(5, 7), 16);\n  }\n  return { r, g, b };\n};\n\nexport const rgbToHex = (r: number, g: number, b: number): string => {\n  const toHex = (value: number) => {\n    const hex = value.toString(16);\n    return hex.length === 1 ? \"0\" + hex : hex;\n  };\n  return `#${toHex(r)}${toHex(g)}${toHex(b)}`;\n};\n","export const isHexColor = (color: string): boolean => {\n  return /^#([0-9A-F]{3}){1,2}$/i.test(color);\n};\n\nimport { hexToRgb } from \"./to-color\";\n\nconst linearize = (value: number): number => {\n  const channel = value / 255;\n\n  return channel <= 0.04045\n    ? channel / 12.92\n    : ((channel + 0.055) / 1.055) ** 2.4;\n};\n\n/** Returns whether a color is dark based on WCAG relative luminance. */\nexport const isDarkColor = (color: string): boolean => {\n  const { r, g, b } = hexToRgb(color);\n\n  const luminance =\n    0.2126 * linearize(r) + 0.7152 * linearize(g) + 0.0722 * linearize(b);\n\n  return luminance < 0.179;\n};\n","/**\n * Call the original function, but applying the debounce rules.\n *\n * Only the last call to the function shall be executed after the timeout has been reached.\n * @returns the debounced function with a cancel function property to clear the timeout.\n */\nconst debounce = <T extends unknown[]>(\n  func: (...args: T) => void,\n  wait: number,\n) => {\n  let timeout: ReturnType<typeof setTimeout>;\n\n  const cancel = () => clearTimeout(timeout);\n\n  return Object.assign(\n    (...args: T) => {\n      clearTimeout(timeout);\n      timeout = setTimeout(() => func.apply(this, args), wait);\n    },\n    { cancel },\n  );\n};\n\nexport { debounce };\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/responsive/constants.ts","../src/responsive/index.ts","../src/string/assert.ts","../src/string/normalize.ts","../src/string/casing.ts","../src/string/class-names.ts","../src/string/name-to-initials.ts","../src/color/color.utils.ts","../src/color/is-color.ts","../src/color/to-color.ts","../src/timing/debounce.ts"],"sourcesContent":["export const BREAKPOINTS = [\"mobile\", \"tablet\", \"desktop\"] as const;\n","import type { Breakpoint, ResponsiveConfig, ResponsiveValue } from \"./types\";\n\nconst resolveResponsiveValueForBreakpoint = <T>(\n  breakpoint: Breakpoint,\n  value: ResponsiveValue<T>,\n  fallback?: T,\n): T => {\n  if (value === undefined || value === null) {\n    return fallback as T;\n  }\n  const isNonResponsive = typeof value !== \"object\" || !(breakpoint in value);\n  const resolved = isNonResponsive\n    ? ((value ?? fallback) as T)\n    : ((value as ResponsiveConfig<T>)[breakpoint] ?? (fallback as T));\n  return resolved;\n};\n\nconst resolveResponsiveValue = <T>(\n  value: ResponsiveValue<T>,\n  fallback?: T,\n): Required<ResponsiveConfig<T>> => {\n  const mobile = resolveResponsiveValueForBreakpoint(\"mobile\", value, fallback);\n  const tablet = resolveResponsiveValueForBreakpoint(\"tablet\", value, mobile);\n  const desktop = resolveResponsiveValueForBreakpoint(\"desktop\", value, tablet);\n\n  return {\n    mobile,\n    tablet,\n    desktop,\n  };\n};\n\nexport { resolveResponsiveValue, resolveResponsiveValueForBreakpoint };\nexport { BREAKPOINTS } from \"./constants\";\nexport type { Breakpoint, ResponsiveConfig, ResponsiveValue } from \"./types\";\n","export const assertSafeCssValue = (value: unknown, label: string) => {\n  if (typeof value !== \"string\" && typeof value !== \"number\") {\n    throw new TypeError(`${label} must be a string or number.`);\n  }\n\n  const serialized = String(value).trim();\n  if (\n    serialized.length === 0 ||\n    /[;{}<>\\u0000-\\u001f\\u007f]/.test(serialized)\n  ) {\n    throw new TypeError(\n      `${label} must be a non-empty CSS value and must not contain semicolons, braces, angle brackets, or control characters.`,\n    );\n  }\n  return serialized;\n};\n","/** Normalizes a search string by removing diacritics and converting to lowercase */\nexport const normalizeSearchString = (value: string): string =>\n  value\n    .normalize(\"NFD\")\n    .replace(/[\\u0300-\\u036f]/g, \"\")\n    .toLocaleLowerCase();\n\n/** Removes unsafe characters from a string */\nexport const withSafeCharacters = (input: string): string =>\n  input\n    .trim()\n    .normalize(\"NFD\")\n    .replace(/[\\u0300-\\u036f]/g, \"\")\n    .replace(/[^a-zA-Z0-9\\s-]/g, \"\")\n    .replace(\n      /([A-Z].*[^\\s][A-Z])/g,\n      \"$1\".slice(0, 1).toUpperCase() + \"$1\".slice(1).toLowerCase(),\n    );\n\n/** Escapes special characters in a string for use in CSS strings */\nexport const escapeCssString = (value: string): string => {\n  return value.replace(/[\"\\\\\\n\\r\\f]/g, (character) => {\n    switch (character) {\n      case '\"':\n        return '\\\\\"';\n      case \"\\\\\":\n        return \"\\\\\\\\\";\n      case \"\\n\":\n        return \"\\\\a \";\n      case \"\\r\":\n        return \"\\\\d \";\n      case \"\\f\":\n        return \"\\\\c \";\n      default:\n        return character;\n    }\n  });\n};\n","import { withSafeCharacters } from \"./normalize\";\n\n/**\n * Represents the casing options for strings.\n * - \"lowercase\"      -> hello world\n * - \"uppercase\"      -> HELLO WORLD\n * - \"snakecase\"      -> hello_world\n * - \"kebabcase\"      -> hello-world\n * - \"camelcase\"      -> helloWorld\n * - \"pascalcase\"     -> HelloWorld\n * - \"sentencecase\"   -> Hello world\n * - \"headercase\"     -> Hello World\n **/\nexport type StringCasing =\n  | \"lowercase\"\n  | \"uppercase\"\n  | \"snakecase\"\n  | \"kebabcase\"\n  | \"camelcase\"\n  | \"pascalcase\"\n  | \"sentencecase\"\n  | \"headercase\";\n\n/**\n * Transforms the input string into the specified casing.\n * Casing can be one of the following:\n * - \"lowercase\"      -> hello world\n * - \"uppercase\"      -> HELLO WORLD\n * - \"snakecase\"      -> hello_world\n * - \"kebabcase\"      -> hello-world\n * - \"camelcase\"      -> helloWorld\n * - \"pascalcase\"     -> HelloWorld\n * - \"sentencecase\"   -> Hello world\n * - \"headercase\"     -> Hello World\n **/\nexport const stringWithCasing = (\n  input: string,\n  casing: StringCasing,\n): string => {\n  const trimmedInput = input.trim();\n  const cleanedInput = withSafeCharacters(trimmedInput);\n\n  switch (casing) {\n    case \"lowercase\":\n      return trimmedInput.toLowerCase();\n    case \"uppercase\":\n      return trimmedInput.toUpperCase();\n    case \"snakecase\":\n      return cleanedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => a + \"_\" + b.toLowerCase())\n        .replace(/[^A-Za-z0-9]+|_+/g, \"_\")\n        .toLowerCase();\n    case \"kebabcase\":\n      return trimmedInput\n        .replace(/^[^A-Za-z0-9]*-?|[^A-Za-z0-9]*-?$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`)\n        .replace(/[^A-Za-z0-9]+|_+/g, \"-\")\n        .toLowerCase();\n    case \"camelcase\":\n      return cleanedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/[^A-Za-z0-9]+/g, \"$\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}$${b}`)\n        .toLowerCase()\n        .replace(/(\\$)(\\w)/g, (_m, _a, b) => b.toUpperCase());\n    case \"pascalcase\":\n      return cleanedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"$\")\n        .replace(/[^A-Za-z0-9]+/g, \"$\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}$${b}`)\n        .toLowerCase()\n        .replace(/(\\$)(\\w?)/g, (_m, a, b) => b.toUpperCase());\n    case \"sentencecase\": {\n      const textcase = trimmedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`)\n        .replace(/[^A-Za-z0-9]+|_+/g, \" \")\n        .toLowerCase();\n\n      return textcase.charAt(0).toUpperCase() + textcase.slice(1);\n    }\n    case \"headercase\":\n      return trimmedInput\n        .replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, \"\")\n        .replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`)\n        .replace(/[^A-Za-z0-9]+|_+/g, \" \")\n        .toLowerCase()\n        .replace(\n          /( ?)(\\w+)( ?)/g,\n          (m, a, b, c) => a + b.charAt(0).toUpperCase() + b.slice(1) + c,\n        );\n  }\n};\n","/**\n * Represents a valid argument for the `classNames` function.\n * It can be a string, an array of strings, undefined, null, or false.\n */\nexport type ClassnameArg = string | string[] | undefined | null | false;\n\n/**\n * Concatenates and trims the given arguments into a single string of class names.\n *\n * @param args - The arguments to be concatenated.\n * @returns A string of class names.\n */\nexport const cn = (...args: ClassnameArg[]): string => {\n  const notNullUndefinedOrFalse = args.filter((v) => !!v).flat() as string[];\n  return notNullUndefinedOrFalse\n    .flatMap((v) => v.split(\" \"))\n    .filter((v) => v.length > 0)\n    .join(\" \")\n    .trim();\n};\n","const NAME_PARTICLES = new Set([\n  // Dutch\n  \"van\",\n  \"den\",\n  \"der\",\n  \"de\",\n  \"ter\",\n  \"ten\",\n  \"te\",\n  \"het\",\n  \"'t\",\n\n  // German\n  \"von\",\n  \"vom\",\n  \"zum\",\n  \"zur\",\n  \"zu\",\n\n  // French\n  \"du\",\n  \"des\",\n  \"le\",\n  \"la\",\n  \"les\",\n\n  // Spanish and Portuguese\n  \"del\",\n  \"los\",\n  \"las\",\n  \"da\",\n  \"das\",\n  \"do\",\n  \"dos\",\n\n  // Italian\n  \"di\",\n  \"della\",\n  \"delle\",\n  \"dello\",\n  \"dei\",\n  \"degli\",\n\n  // Other common particles\n  \"al\",\n  \"el\",\n  \"bin\",\n  \"ibn\",\n  \"bint\",\n  \"af\",\n  \"av\",\n  \"ap\",\n  \"ab\",\n]);\n\nconst NAME_SUFFIXES = new Set([\n  \"jr\",\n  \"sr\",\n  \"ii\",\n  \"iii\",\n  \"iv\",\n  \"v\",\n  \"phd\",\n  \"md\",\n]);\n\nconst normalizeNamePart = (part: string): string => {\n  return part.toLocaleLowerCase().replace(/[\\p{P}\\p{S}]/gu, \"\");\n};\n\nconst getFirstLetter = (part: string): string => {\n  return part.match(/\\p{L}/u)?.[0].toLocaleUpperCase() ?? \"\";\n};\n\nexport const nameToInitials = (name: string) => {\n  const parts = name.trim().split(/\\s+/u).filter(Boolean);\n  const [firstPart] = parts;\n  if (firstPart === undefined) {\n    return \"?\";\n  }\n\n  // Ignore suffixes such as Jr., Sr. and III.\n  while (parts.length > 1 && NAME_SUFFIXES.has(normalizeNamePart(parts.at(-1)!))) {\n    parts.pop();\n  }\n\n  const firstInitial = getFirstLetter(firstPart);\n\n  if (parts.length === 1) {\n    return firstInitial;\n  }\n\n  // Find the last meaningful surname part, ignoring particles.\n  const surname = [...parts.slice(1)]\n    .reverse()\n    .find((part) => !NAME_PARTICLES.has(normalizeNamePart(part)));\n\n  // Fallback for unusual names consisting only of particles.\n  const lastInitial = getFirstLetter(surname ?? parts.at(-1)!);\n\n  return firstInitial + lastInitial;\n};\n","import type { ColorType, HSLColor, RGBColor } from \"./color.types\";\n\nconst clamp = (value: number, min: number, max: number): number =>\n  Math.min(max, Math.max(min, value));\n\nconst normalizeHue = (hue: number): number => ((hue % 360) + 360) % 360;\n\nconst normalizeAlpha = (value?: string): number => {\n  if (value === undefined) return 1;\n\n  const alpha = value.endsWith(\"%\")\n    ? Number.parseFloat(value) / 100\n    : Number.parseFloat(value);\n\n  return clamp(alpha, 0, 1);\n};\n\nconst CSS_NAMED_COLORS = new Set([\n    \"aliceblue\",\n    \"antiquewhite\",\n    \"aqua\",\n    \"aquamarine\",\n    \"azure\",\n    \"beige\",\n    \"bisque\",\n    \"black\",\n    \"blanchedalmond\",\n    \"blue\",\n    \"blueviolet\",\n    \"brown\",\n    \"burlywood\",\n    \"cadetblue\",\n    \"chartreuse\",\n    \"chocolate\",\n    \"coral\",\n    \"cornflowerblue\",\n    \"cornsilk\",\n    \"crimson\",\n    \"cyan\",\n    \"darkblue\",\n    \"darkcyan\",\n    \"darkgoldenrod\",\n    \"darkgray\",\n    \"darkgreen\",\n    \"darkgrey\",\n    \"darkkhaki\",\n    \"darkmagenta\",\n    \"darkolivegreen\",\n    \"darkorange\",\n    \"darkorchid\",\n    \"darkred\",\n    \"darksalmon\",\n    \"darkseagreen\",\n    \"darkslateblue\",\n    \"darkslategray\",\n    \"darkslategrey\",\n    \"darkturquoise\",\n    \"darkviolet\",\n    \"deeppink\",\n    \"deepskyblue\",\n    \"dimgray\",\n    \"dimgrey\",\n    \"dodgerblue\",\n    \"firebrick\",\n    \"floralwhite\",\n    \"forestgreen\",\n    \"fuchsia\",\n    \"gainsboro\",\n    \"ghostwhite\",\n    \"gold\",\n    \"goldenrod\",\n    \"gray\",\n    \"green\",\n    \"greenyellow\",\n    \"grey\",\n    \"honeydew\",\n    \"hotpink\",\n    \"indianred\",\n    \"indigo\",\n    \"ivory\",\n    \"khaki\",\n    \"lavender\",\n    \"lavenderblush\",\n    \"lawngreen\",\n    \"lemonchiffon\",\n    \"lightblue\",\n    \"lightcoral\",\n    \"lightcyan\",\n    \"lightgoldenrodyellow\",\n    \"lightgray\",\n    \"lightgreen\",\n    \"lightgrey\",\n    \"lightpink\",\n    \"lightsalmon\",\n    \"lightseagreen\",\n    \"lightskyblue\",\n    \"lightslategray\",\n    \"lightslategrey\",\n    \"lightsteelblue\",\n    \"lightyellow\",\n    \"lime\",\n    \"limegreen\",\n    \"linen\",\n    \"magenta\",\n    \"maroon\",\n    \"mediumaquamarine\",\n    \"mediumblue\",\n    \"mediumorchid\",\n    \"mediumpurple\",\n    \"mediumseagreen\",\n    \"mediumslateblue\",\n    \"mediumspringgreen\",\n    \"mediumturquoise\",\n    \"mediumvioletred\",\n    \"midnightblue\",\n    \"mintcream\",\n    \"mistyrose\",\n    \"moccasin\",\n    \"navajowhite\",\n    \"navy\",\n    \"oldlace\",\n    \"olive\",\n    \"olivedrab\",\n    \"orange\",\n    \"orangered\",\n    \"orchid\",\n    \"palegoldenrod\",\n    \"palegreen\",\n    \"paleturquoise\",\n    \"palevioletred\",\n    \"papayawhip\",\n    \"peachpuff\",\n    \"peru\",\n    \"pink\",\n    \"plum\",\n    \"powderblue\",\n    \"purple\",\n    \"rebeccapurple\",\n    \"red\",\n    \"rosybrown\",\n    \"royalblue\",\n    \"saddlebrown\",\n    \"salmon\",\n    \"sandybrown\",\n    \"seagreen\",\n    \"seashell\",\n    \"sienna\",\n    \"silver\",\n    \"skyblue\",\n    \"slateblue\",\n    \"slategray\",\n    \"slategrey\",\n    \"snow\",\n    \"springgreen\",\n    \"steelblue\",\n    \"tan\",\n    \"teal\",\n    \"thistle\",\n    \"tomato\",\n    \"turquoise\",\n    \"violet\",\n    \"wheat\",\n    \"white\",\n    \"whitesmoke\",\n    \"yellow\",\n    \"yellowgreen\",\n    \"transparent\",\n    \"currentcolor\",\n]);\n\nconst normalizeChannel = (value: string): number => {\n  const channel = value.endsWith(\"%\")\n    ? (Number.parseFloat(value) / 100) * 255\n    : Number.parseFloat(value);\n\n  return clamp(channel, 0, 255);\n};\n\nconst getColorType = (color: string): ColorType => {\n  const value = color.trim().toLowerCase();\n\n  if (/^var\\(\\s*--[\\w-]+(?:\\s*,\\s*.+)?\\)$/.test(value)) {\n    return \"css-variable\";\n  }\n\n  if (/^#[\\da-f]{8}$/.test(value) || /^#[\\da-f]{4}$/.test(value)) {\n    return \"hexa\";\n  }\n\n  if (/^#[\\da-f]{6}$/.test(value) || /^#[\\da-f]{3}$/.test(value)) {\n    return \"hex\";\n  }\n\n  if (/^rgba\\(/.test(value)) return \"rgba\";\n  if (/^rgb\\(/.test(value)) return \"rgb\";\n  if (/^hsla\\(/.test(value)) return \"hsla\";\n  if (/^hsl\\(/.test(value)) return \"hsl\";\n\n  if (/^[a-z]+$/.test(value)) return \"named\";\n\n  return \"unknown\";\n};\n\nconst isCssVariable = (color: string): boolean =>\n  getColorType(color) === \"css-variable\";\n\nconst isColor = (color: string): boolean => {\n  const type = getColorType(color);\n\n  return type === \"named\"\n    ? CSS_NAMED_COLORS.has(color.trim().toLowerCase())\n    : type !== \"unknown\";\n};\n\nconst hexToRgba = (hex: string): RGBColor => {\n  const value = hex.trim().replace(/^#/, \"\");\n\n  if (!/^(?:[\\da-f]{3}|[\\da-f]{4}|[\\da-f]{6}|[\\da-f]{8})$/i.test(value)) {\n    throw new Error(`Invalid HEX color: ${hex}`);\n  }\n\n  const expanded =\n    value.length <= 4\n      ? [...value].map((channel) => channel + channel).join(\"\")\n      : value;\n\n  const r = Number.parseInt(expanded.slice(0, 2), 16);\n  const g = Number.parseInt(expanded.slice(2, 4), 16);\n  const b = Number.parseInt(expanded.slice(4, 6), 16);\n  const a =\n    expanded.length === 8 ? Number.parseInt(expanded.slice(6, 8), 16) / 255 : 1;\n\n  return { r, g, b, a };\n};\n\nconst rgbToHex = (r: number, g: number, b: number, a?: number): string => {\n  const channelToHex = (channel: number): string =>\n    Math.round(clamp(channel, 0, 255))\n      .toString(16)\n      .padStart(2, \"0\");\n\n  const alpha =\n    a !== undefined && a < 1 ? channelToHex(clamp(a, 0, 1) * 255) : \"\";\n\n  return `#${channelToHex(r)}${channelToHex(g)}${channelToHex(b)}${alpha}`;\n};\n\nconst parseRgb = (color: string): RGBColor | null => {\n  const match = color\n    .trim()\n    .match(\n      /^rgba?\\(\\s*([\\d.]+%?)\\s*[, ]\\s*([\\d.]+%?)\\s*[, ]\\s*([\\d.]+%?)(?:\\s*[,/]\\s*([\\d.]+%?))?\\s*\\)$/i,\n    );\n\n  if (!match) return null;\n\n  const [, r, g, b, alpha] = match;\n  if (r === undefined || g === undefined || b === undefined) return null;\n\n  return {\n    r: normalizeChannel(r),\n    g: normalizeChannel(g),\n    b: normalizeChannel(b),\n    a: normalizeAlpha(alpha),\n  };\n};\n\nconst hslToRgb = ({ h, s, l, a = 1 }: HSLColor): RGBColor => {\n  const hue = normalizeHue(h) / 360;\n  const saturation = clamp(s / 100, 0, 1);\n  const lightness = clamp(l / 100, 0, 1);\n\n  const channel = (n: number): number => {\n    const k = (n + hue * 12) % 12;\n    const chroma = saturation * Math.min(lightness, 1 - lightness);\n\n    return Math.round(\n      (lightness - chroma * Math.max(-1, Math.min(k - 3, 9 - k, 1))) * 255,\n    );\n  };\n\n  return {\n    r: channel(0),\n    g: channel(8),\n    b: channel(4),\n    a: clamp(a, 0, 1),\n  };\n};\n\nconst rgbToHsl = ({ r, g, b, a = 1 }: RGBColor): HSLColor => {\n  const red = r / 255;\n  const green = g / 255;\n  const blue = b / 255;\n\n  const max = Math.max(red, green, blue);\n  const min = Math.min(red, green, blue);\n  const delta = max - min;\n\n  const l = (max + min) / 2;\n\n  let h = 0;\n  let s = 0;\n\n  if (delta !== 0) {\n    s = delta / (1 - Math.abs(2 * l - 1));\n\n    if (max === red) {\n      h = 60 * (((green - blue) / delta) % 6);\n    } else if (max === green) {\n      h = 60 * ((blue - red) / delta + 2);\n    } else {\n      h = 60 * ((red - green) / delta + 4);\n    }\n  }\n\n  return {\n    h: normalizeHue(h),\n    s: s * 100,\n    l: l * 100,\n    a,\n  };\n};\n\nconst parseHsl = (color: string): RGBColor | null => {\n  const match = color\n    .trim()\n    .match(\n      /^hsla?\\(\\s*([\\d.]+)(?:deg)?\\s*[, ]\\s*([\\d.]+)%\\s*[, ]\\s*([\\d.]+)%(?:\\s*[,/]\\s*([\\d.]+%?))?\\s*\\)$/i,\n    );\n\n  if (!match) return null;\n\n  const [, h, s, l, alpha] = match;\n\n  return hslToRgb({\n    h: Number(h),\n    s: Number(s),\n    l: Number(l),\n    a: normalizeAlpha(alpha),\n  });\n};\n\nconst parseColor = (color: string): RGBColor | null => {\n  const type = getColorType(color);\n\n  if (type === \"hex\" || type === \"hexa\") {\n    return hexToRgba(color);\n  }\n\n  if (type === \"rgb\" || type === \"rgba\") {\n    return parseRgb(color);\n  }\n\n  if (type === \"hsl\" || type === \"hsla\") {\n    return parseHsl(color);\n  }\n\n  return null;\n};\n\nconst rgbToCss = ({ r, g, b, a }: RGBColor): string =>\n  a < 1\n    ? `rgba(${Math.round(r)}, ${Math.round(g)}, ${Math.round(b)}, ${Number(a.toFixed(3))})`\n    : `rgb(${Math.round(r)}, ${Math.round(g)}, ${Math.round(b)})`;\n\nconst hslToCss = ({ h, s, l, a }: HSLColor): string =>\n  a < 1\n    ? `hsla(${Math.round(h)}, ${Math.round(s)}%, ${Math.round(l)}%, ${Number(a.toFixed(3))})`\n    : `hsl(${Math.round(h)}, ${Math.round(s)}%, ${Math.round(l)}%)`;\n\nconst getColorLuminance = (color: string): number | null => {\n  const rgb = parseColor(color);\n\n  if (!rgb) return null;\n\n  const linearize = (value: number): number => {\n    const channel = value / 255;\n\n    return channel <= 0.04045\n      ? channel / 12.92\n      : ((channel + 0.055) / 1.055) ** 2.4;\n  };\n\n  return (\n    0.2126 * linearize(rgb.r) +\n    0.7152 * linearize(rgb.g) +\n    0.0722 * linearize(rgb.b)\n  );\n};\n\nconst isColorDark = (color: string): boolean | null => {\n  const luminance = getColorLuminance(color);\n\n  return luminance === null ? null : luminance < 0.179;\n};\n\nexport {\n  clamp,\n  getColorType,\n  isCssVariable,\n  isColor,\n  hexToRgba,\n  rgbToHex,\n  parseRgb,\n  parseColor,\n  hslToRgb,\n  rgbToHsl,\n  rgbToCss,\n  hslToCss,\n  getColorLuminance,\n  isColorDark,\n};\n","import {\n  getColorType,\n  isColor,\n  isColorDark,\n  isCssVariable,\n} from \"./color.utils\";\n\nexport const isHexColor = (color: string): boolean =>\n  /^#(?:[\\da-f]{3}|[\\da-f]{4}|[\\da-f]{6}|[\\da-f]{8})$/i.test(color.trim());\n\nexport const isDarkColor = (color: string): boolean => {\n  const result = isColorDark(color);\n\n  if (result === null) {\n    throw new Error(`Unsupported color: ${color}`);\n  }\n\n  return result;\n};\n\nexport { getColorType, isColor, isCssVariable, isColorDark };\n","import { hexToRgba } from \"./color.utils\";\n\nexport const hexToRgb = (hex: string): { r: number; g: number; b: number } => {\n  const { r, g, b } = hexToRgba(hex);\n\n  return { r, g, b };\n};\n\nexport const rgbToHex = (\n  r: number,\n  g: number,\n  b: number,\n  a?: number,\n): string => {\n  const channel = (value: number): string =>\n    Math.round(Math.min(255, Math.max(0, value)))\n      .toString(16)\n      .padStart(2, \"0\");\n\n  const alpha =\n    a !== undefined && a < 1 ? channel(Math.min(1, Math.max(0, a)) * 255) : \"\";\n\n  return `#${channel(r)}${channel(g)}${channel(b)}${alpha}`;\n};\n","/**\n * Call the original function, but applying the debounce rules.\n *\n * Only the last call to the function shall be executed after the timeout has been reached.\n * @returns the debounced function with a cancel function property to clear the timeout.\n */\nconst debounce = <T extends unknown[]>(\n  func: (...args: T) => void,\n  wait: number,\n) => {\n  let timeout: ReturnType<typeof setTimeout>;\n\n  const cancel = () => clearTimeout(timeout);\n\n  return Object.assign(\n    (...args: T) => {\n      clearTimeout(timeout);\n      timeout = setTimeout(() => func.apply(this, args), wait);\n    },\n    { cancel },\n  );\n};\n\nexport { debounce };\n"],"mappings":"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,CAEzB;AAClC;;ACnGA,MAAM,SAAS,OAAe,KAAa,QACzC,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;AAEpC,MAAM,gBAAgB,SAA0B,MAAM,MAAO,OAAO;AAEpE,MAAM,kBAAkB,UAA2B;CACjD,IAAI,UAAU,KAAA,GAAW,OAAO;CAEhC,MAAM,QAAQ,MAAM,SAAS,GAAG,IAC5B,OAAO,WAAW,KAAK,IAAI,MAC3B,OAAO,WAAW,KAAK;CAE3B,OAAO,MAAM,OAAO,GAAG,CAAC;AAC1B;AAEA,MAAM,mCAAmB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ,CAAC;AAED,MAAM,oBAAoB,UAA0B;CAClD,MAAM,UAAU,MAAM,SAAS,GAAG,IAC7B,OAAO,WAAW,KAAK,IAAI,MAAO,MACnC,OAAO,WAAW,KAAK;CAE3B,OAAO,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puzzle-ui/core",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Framework-independent utilities",
   "license": "MIT",
   "publishConfig": {
@@ -29,6 +29,7 @@
   "sideEffects": false,
   "scripts": {
     "build": "tsdown",
+    "typecheck": "tsc --noEmit -p .",
     "prepack": "tsdown",
     "vitest": "bunx vitest run --passWithNoTests",
     "vitest:watch": "bunx vitest run --watch --passWithNoTests"
@@ -36,6 +37,7 @@
   "devDependencies": {
     "tsdown": "^0.23.1",
     "tsup": "latest",
-    "typescript": "^6.0.3"
+    "typescript": "^7.0.2",
+    "vitest": "^5.1.0"
   }
 }