@puzzle-ui/core 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,70 @@
-# Temporary Holding Version
+# @puzzle-ui/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Framework-independent utilities shared by the Puzzle UI packages. Use them
+directly without React, a theme provider, or CSS.
+
+> Puzzle is under active development. APIs may change without notice; use it
+> for experimentation and evaluation rather than production applications.
+
+## Installation
+
+Use your preferred package manager:
+
+```sh
+npm install @puzzle-ui/core
+# or
+bun add @puzzle-ui/core
+# or
+pnpm add @puzzle-ui/core
+# or
+yarn add @puzzle-ui/core
+```
+
+## Usage
+
+```ts
+import { cn, isHexColor } from "@puzzle-ui/core";
+
+const selected = true;
+const className = cn("navigation-item", selected && "selected");
+const validColor = isHexColor("#0284C7");
+```
+
+## Public utilities
+
+| 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` |
+
+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.
+
+## Development
+
+From an installed repository checkout:
+
+```sh
+npm run build --workspace=@puzzle-ui/core
+```
+
+From this package directory, run the configured test script:
+
+```sh
+bun run vitest
+```
+
+`prepack` rebuilds the package before packing or publishing. See the root
+[publishing guide](../../README.md#publishing-packages) for release order and
+validation commands.
+
+## License
+
+MIT. See the repository [LICENSE](../../LICENSE); published packages include
+the same license at `dist/LICENSE`.

package/dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sjoerd van Den Berg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,226 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+// src/responsive/constants.ts
+const BREAKPOINTS = [
+	"mobile",
+	"tablet",
+	"desktop"
+];
+// src/responsive/index.ts
+const resolveResponsiveValueForBreakpoint = (breakpoint, value, fallback) => {
+	if (value === void 0 || value === null) return fallback;
+	return typeof value !== "object" || !(breakpoint in value) ? value ?? fallback : value[breakpoint] ?? fallback;
+};
+const resolveResponsiveValue = (value, fallback) => {
+	const mobile = resolveResponsiveValueForBreakpoint("mobile", value, fallback);
+	const tablet = resolveResponsiveValueForBreakpoint("tablet", value, mobile);
+	return {
+		mobile,
+		tablet,
+		desktop: resolveResponsiveValueForBreakpoint("desktop", value, tablet)
+	};
+};
+// src/string/assert.ts
+const assertSafeCssValue = (value, label) => {
+	if (typeof value !== "string" && typeof value !== "number") throw new TypeError(`${label} must be a string or number.`);
+	const serialized = String(value).trim();
+	if (serialized.length === 0 || /[;{}<>\u0000-\u001f\u007f]/.test(serialized)) throw new TypeError(`${label} must be a non-empty CSS value and must not contain semicolons, braces, angle brackets, or control characters.`);
+	return serialized;
+};
+// src/string/normalize.ts
+/** Normalizes a search string by removing diacritics and converting to lowercase */
+const normalizeSearchString = (value) => value.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLocaleLowerCase();
+/** Removes unsafe characters from a string */
+const withSafeCharacters = (input) => input.trim().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-zA-Z0-9\s-]/g, "").replace(/([A-Z].*[^\s][A-Z])/g, "$1".slice(0, 1).toUpperCase() + "$1".slice(1).toLowerCase());
+/** Escapes special characters in a string for use in CSS strings */
+const escapeCssString = (value) => {
+	return value.replace(/["\\\n\r\f]/g, (character) => {
+		switch (character) {
+			case "\"": return "\\\"";
+			case "\\": return "\\\\";
+			case "\n": return "\\a ";
+			case "\r": return "\\d ";
+			case "\f": return "\\c ";
+			default: return character;
+		}
+	});
+};
+// src/string/casing.ts
+/**
+* Transforms the input string into the specified casing.
+* Casing can be one of the following:
+* - "lowercase"      -> hello world
+* - "uppercase"      -> HELLO WORLD
+* - "snakecase"      -> hello_world
+* - "kebabcase"      -> hello-world
+* - "camelcase"      -> helloWorld
+* - "pascalcase"     -> HelloWorld
+* - "sentencecase"   -> Hello world
+* - "headercase"     -> Hello World
+**/
+const stringWithCasing = (input, casing) => {
+	const trimmedInput = input.trim();
+	const cleanedInput = withSafeCharacters(trimmedInput);
+	switch (casing) {
+		case "lowercase": return trimmedInput.toLowerCase();
+		case "uppercase": return trimmedInput.toUpperCase();
+		case "snakecase": return cleanedInput.replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, "").replace(/([a-z])([A-Z])/g, (_m, a, b) => a + "_" + b.toLowerCase()).replace(/[^A-Za-z0-9]+|_+/g, "_").toLowerCase();
+		case "kebabcase": return trimmedInput.replace(/^[^A-Za-z0-9]*-?|[^A-Za-z0-9]*-?$/g, "").replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`).replace(/[^A-Za-z0-9]+|_+/g, "-").toLowerCase();
+		case "camelcase": return cleanedInput.replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, "").replace(/[^A-Za-z0-9]+/g, "$").replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}$${b}`).toLowerCase().replace(/(\$)(\w)/g, (_m, _a, b) => b.toUpperCase());
+		case "pascalcase": return cleanedInput.replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, "$").replace(/[^A-Za-z0-9]+/g, "$").replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}$${b}`).toLowerCase().replace(/(\$)(\w?)/g, (_m, a, b) => b.toUpperCase());
+		case "sentencecase": {
+			const textcase = trimmedInput.replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, "").replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`).replace(/[^A-Za-z0-9]+|_+/g, " ").toLowerCase();
+			return textcase.charAt(0).toUpperCase() + textcase.slice(1);
+		}
+		case "headercase": return trimmedInput.replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, "").replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`).replace(/[^A-Za-z0-9]+|_+/g, " ").toLowerCase().replace(/( ?)(\w+)( ?)/g, (m, a, b, c) => a + b.charAt(0).toUpperCase() + b.slice(1) + c);
+	}
+};
+// src/string/class-names.ts
+/**
+* Concatenates and trims the given arguments into a single string of class names.
+*
+* @param args - The arguments to be concatenated.
+* @returns A string of class names.
+*/
+const cn = (...args) => {
+	return args.filter((v) => !!v).flat().flatMap((v) => v.split(" ")).filter((v) => v.length > 0).join(" ").trim();
+};
+// src/string/name-to-initials.ts
+const NAME_PARTICLES = /* @__PURE__ */ new Set([
+	"van",
+	"den",
+	"der",
+	"de",
+	"ter",
+	"ten",
+	"te",
+	"het",
+	"'t",
+	"von",
+	"vom",
+	"zum",
+	"zur",
+	"zu",
+	"du",
+	"des",
+	"le",
+	"la",
+	"les",
+	"del",
+	"los",
+	"las",
+	"da",
+	"das",
+	"do",
+	"dos",
+	"di",
+	"della",
+	"delle",
+	"dello",
+	"dei",
+	"degli",
+	"al",
+	"el",
+	"bin",
+	"ibn",
+	"bint",
+	"af",
+	"av",
+	"ap",
+	"ab"
+]);
+const NAME_SUFFIXES = /* @__PURE__ */ new Set([
+	"jr",
+	"sr",
+	"ii",
+	"iii",
+	"iv",
+	"v",
+	"phd",
+	"md"
+]);
+const normalizeNamePart = (part) => {
+	return part.toLocaleLowerCase().replace(/[\p{P}\p{S}]/gu, "");
+};
+const getFirstLetter = (part) => {
+	return part.match(/\p{L}/u)?.[0].toLocaleUpperCase() ?? "";
+};
+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]);
+	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]);
+};
+// 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);
+	}
+	return {
+		r,
+		g,
+		b
+	};
+};
+const rgbToHex = (r, g, b) => {
+	const toHex = (value) => {
+		const hex = value.toString(16);
+		return hex.length === 1 ? "0" + hex : hex;
+	};
+	return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+};
+// src/color/is-color.ts
+const isHexColor = (color) => {
+	return /^#([0-9A-F]{3}){1,2}$/i.test(color);
+};
+const linearize = (value) => {
+	const channel = value / 255;
+	return channel <= .04045 ? channel / 12.92 : ((channel + .055) / 1.055) ** 2.4;
+};
+/** 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;
+};
+// src/timing/debounce.ts
+/**
+* Call the original function, but applying the debounce rules.
+*
+* Only the last call to the function shall be executed after the timeout has been reached.
+* @returns the debounced function with a cancel function property to clear the timeout.
+*/
+const debounce = (func, wait) => {
+	let timeout;
+	const cancel = () => clearTimeout(timeout);
+	return Object.assign((...args) => {
+		clearTimeout(timeout);
+		timeout = setTimeout(() => func.apply(void 0, args), wait);
+	}, { cancel });
+};
+exports.BREAKPOINTS = BREAKPOINTS;
+exports.assertSafeCssValue = assertSafeCssValue;
+exports.cn = cn;
+exports.debounce = debounce;
+exports.escapeCssString = escapeCssString;
+exports.hexToRgb = hexToRgb;
+exports.isDarkColor = isDarkColor;
+exports.isHexColor = isHexColor;
+exports.nameToInitials = nameToInitials;
+exports.normalizeSearchString = normalizeSearchString;
+exports.resolveResponsiveValue = resolveResponsiveValue;
+exports.resolveResponsiveValueForBreakpoint = resolveResponsiveValueForBreakpoint;
+exports.rgbToHex = rgbToHex;
+exports.stringWithCasing = stringWithCasing;
+exports.withSafeCharacters = withSafeCharacters;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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":";;AAAA,MAAa,cAAc;CAAC;CAAU;CAAU;AAAS;;ACEzD,MAAM,uCACJ,YACA,OACA,aACM;CACN,IAAI,UAAU,KAAA,KAAa,UAAU,MACnC,OAAO;CAMT,OAJwB,OAAO,UAAU,YAAY,EAAE,cAAc,SAE/D,SAAS,WACT,MAA8B,eAAgB;AAEtD;AAEA,MAAM,0BACJ,OACA,aACkC;CAClC,MAAM,SAAS,oCAAoC,UAAU,OAAO,QAAQ;CAC5E,MAAM,SAAS,oCAAoC,UAAU,OAAO,MAAM;CAG1E,OAAO;EACL;EACA;EACA,SALc,oCAAoC,WAAW,OAAO,MAK9D;CACR;AACF;;AC9BA,MAAa,sBAAsB,OAAgB,UAAkB;CACnE,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,UAChD,MAAM,IAAI,UAAU,GAAG,MAAM,6BAA6B;CAG5D,MAAM,aAAa,OAAO,KAAK,CAAC,CAAC,KAAK;CACtC,IACE,WAAW,WAAW,KACtB,6BAA6B,KAAK,UAAU,GAE5C,MAAM,IAAI,UACR,GAAG,MAAM,+GACX;CAEF,OAAO;AACT;;;ACdA,MAAa,yBAAyB,UACpC,MACG,UAAU,KAAK,CAAC,CAChB,QAAQ,oBAAoB,EAAE,CAAC,CAC/B,kBAAkB;;AAGvB,MAAa,sBAAsB,UACjC,MACG,KAAK,CAAC,CACN,UAAU,KAAK,CAAC,CAChB,QAAQ,oBAAoB,EAAE,CAAC,CAC/B,QAAQ,oBAAoB,EAAE,CAAC,CAC/B,QACC,wBACA,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,YAAY,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAC7D;;AAGJ,MAAa,mBAAmB,UAA0B;CACxD,OAAO,MAAM,QAAQ,iBAAiB,cAAc;EAClD,QAAQ,WAAR;GACE,KAAK,MACH,OAAO;GACT,KAAK,MACH,OAAO;GACT,KAAK,MACH,OAAO;GACT,KAAK,MACH,OAAO;GACT,KAAK,MACH,OAAO;GACT,SACE,OAAO;EACX;CACF,CAAC;AACH;;;;;;;;;;;;;;ACFA,MAAa,oBACX,OACA,WACW;CACX,MAAM,eAAe,MAAM,KAAK;CAChC,MAAM,eAAe,mBAAmB,YAAY;CAEpD,QAAQ,QAAR;EACE,KAAK,aACH,OAAO,aAAa,YAAY;EAClC,KAAK,aACH,OAAO,aAAa,YAAY;EAClC,KAAK,aACH,OAAO,aACJ,QAAQ,kCAAkC,EAAE,CAAC,CAC7C,QAAQ,oBAAoB,IAAI,GAAG,MAAM,IAAI,MAAM,EAAE,YAAY,CAAC,CAAC,CACnE,QAAQ,qBAAqB,GAAG,CAAC,CACjC,YAAY;EACjB,KAAK,aACH,OAAO,aACJ,QAAQ,sCAAsC,EAAE,CAAC,CACjD,QAAQ,oBAAoB,IAAI,GAAG,MAAM,GAAG,EAAE,GAAG,EAAE,YAAY,GAAG,CAAC,CACnE,QAAQ,qBAAqB,GAAG,CAAC,CACjC,YAAY;EACjB,KAAK,aACH,OAAO,aACJ,QAAQ,kCAAkC,EAAE,CAAC,CAC7C,QAAQ,kBAAkB,GAAG,CAAC,CAC9B,QAAQ,oBAAoB,IAAI,GAAG,MAAM,GAAG,EAAE,GAAG,GAAG,CAAC,CACrD,YAAY,CAAC,CACb,QAAQ,cAAc,IAAI,IAAI,MAAM,EAAE,YAAY,CAAC;EACxD,KAAK,cACH,OAAO,aACJ,QAAQ,kCAAkC,GAAG,CAAC,CAC9C,QAAQ,kBAAkB,GAAG,CAAC,CAC9B,QAAQ,oBAAoB,IAAI,GAAG,MAAM,GAAG,EAAE,GAAG,GAAG,CAAC,CACrD,YAAY,CAAC,CACb,QAAQ,eAAe,IAAI,GAAG,MAAM,EAAE,YAAY,CAAC;EACxD,KAAK,gBAAgB;GACnB,MAAM,WAAW,aACd,QAAQ,kCAAkC,EAAE,CAAC,CAC7C,QAAQ,oBAAoB,IAAI,GAAG,MAAM,GAAG,EAAE,GAAG,EAAE,YAAY,GAAG,CAAC,CACnE,QAAQ,qBAAqB,GAAG,CAAC,CACjC,YAAY;GAEf,OAAO,SAAS,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,SAAS,MAAM,CAAC;EAC5D;EACA,KAAK,cACH,OAAO,aACJ,QAAQ,kCAAkC,EAAE,CAAC,CAC7C,QAAQ,oBAAoB,IAAI,GAAG,MAAM,GAAG,EAAE,GAAG,EAAE,YAAY,GAAG,CAAC,CACnE,QAAQ,qBAAqB,GAAG,CAAC,CACjC,YAAY,CAAC,CACb,QACC,mBACC,GAAG,GAAG,GAAG,MAAM,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,MAAM,CAAC,IAAI,CAC/D;CACN;AACF;;;;;;;;ACjFA,MAAa,MAAM,GAAG,SAAiC;CAErD,OADgC,KAAK,QAAQ,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAC3B,CAAC,CAC3B,SAAS,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,CAC5B,QAAQ,MAAM,EAAE,SAAS,CAAC,CAAC,CAC3B,KAAK,GAAG,CAAC,CACT,KAAK;AACV;;ACnBA,MAAM,iCAAiB,IAAI,IAAI;CAE7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,gCAAgB,IAAI,IAAI;CAC5B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,qBAAqB,SAAyB;CAClD,OAAO,KAAK,kBAAkB,CAAC,CAAC,QAAQ,kBAAkB,EAAE;AAC9D;AAEA,MAAM,kBAAkB,SAAyB;CAC/C,OAAO,KAAK,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC,kBAAkB,KAAK;AAC1D;AAEA,MAAa,kBAAkB,SAAiB;CAC9C,MAAM,QAAQ,KAAK,KAAK,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,OAAO,OAAO;CACtD,IAAI,MAAM,WAAW,GACnB,OAAO;CAIT,OACE,MAAM,SAAS,KACf,cAAc,IAAI,kBAAkB,MAAM,MAAM,SAAS,EAAE,CAAC,GAE5D,MAAM,IAAI;CAGZ,MAAM,eAAe,eAAe,MAAM,EAAE;CAE5C,IAAI,MAAM,WAAW,GACnB,OAAO;CAIT,MAAM,UAAU,CAAC,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,CAChC,QAAQ,CAAC,CACT,MAAM,SAAS,CAAC,eAAe,IAAI,kBAAkB,IAAI,CAAC,CAAC;CAK9D,OAAO,eAFa,eAAe,WAAW,MAAM,MAAM,SAAS,EAEnC;AAClC;;ACvGA,MAAa,YAAY,QAAqD;CAC5E,IAAI,CAAC,yBAAyB,KAAK,GAAG,GACpC,MAAM,IAAI,MAAM,mBAAmB;CAErC,IAAI,GAAW,GAAW;CAC1B,IAAI,IAAI,WAAW,GAAG;EACpB,IAAI,SAAS,IAAI,KAAK,IAAI,IAAI,EAAE;EAChC,IAAI,SAAS,IAAI,KAAK,IAAI,IAAI,EAAE;EAChC,IAAI,SAAS,IAAI,KAAK,IAAI,IAAI,EAAE;CAClC,OAAO;EACL,IAAI,SAAS,IAAI,MAAM,GAAG,CAAC,GAAG,EAAE;EAChC,IAAI,SAAS,IAAI,MAAM,GAAG,CAAC,GAAG,EAAE;EAChC,IAAI,SAAS,IAAI,MAAM,GAAG,CAAC,GAAG,EAAE;CAClC;CACA,OAAO;EAAE;EAAG;EAAG;CAAE;AACnB;AAEA,MAAa,YAAY,GAAW,GAAW,MAAsB;CACnE,MAAM,SAAS,UAAkB;EAC/B,MAAM,MAAM,MAAM,SAAS,EAAE;EAC7B,OAAO,IAAI,WAAW,IAAI,MAAM,MAAM;CACxC;CACA,OAAO,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC;AAC1C;;ACvBA,MAAa,cAAc,UAA2B;CACpD,OAAO,yBAAyB,KAAK,KAAK;AAC5C;AAIA,MAAM,aAAa,UAA0B;CAC3C,MAAM,UAAU,QAAQ;CAExB,OAAO,WAAW,SACd,UAAU,UACR,UAAU,QAAS,UAAU;AACrC;;AAGA,MAAa,eAAe,UAA2B;CACrD,MAAM,EAAE,GAAG,GAAG,MAAM,SAAS,KAAK;CAKlC,OAFE,QAAS,UAAU,CAAC,IAAI,QAAS,UAAU,CAAC,IAAI,QAAS,UAAU,CAAC,IAEnD;AACrB;;;;;;;;AChBA,MAAM,YACJ,MACA,SACG;CACH,IAAI;CAEJ,MAAM,eAAe,aAAa,OAAO;CAEzC,OAAO,OAAO,QACX,GAAG,SAAY;EACd,aAAa,OAAO;EACpB,UAAU,iBAAiB,KAAK,MAAA,KAAA,GAAY,IAAI,GAAG,IAAI;CACzD,GACA,EAAE,OAAO,CACX;AACF"}

package/dist/index.d.cts

@@ -0,0 +1,73 @@
+type DeepPartial<T> = { [K in keyof T]?: T[K] extends readonly unknown[] ? T[K] : T[K] extends object ? DeepPartial<T[K]> : T[K]; };
+export declare const BREAKPOINTS: readonly ["mobile", "tablet", "desktop"];
+type Breakpoint = (typeof BREAKPOINTS)[number];
+type ResponsiveConfig<T> = Omit<Partial<Record<(typeof BREAKPOINTS)[number], T>>, "mobile"> & {
+  mobile: T;
+};
+type ResponsiveValue<T> = T | ResponsiveConfig<T> | undefined;
+declare const resolveResponsiveValueForBreakpoint: <T>(breakpoint: Breakpoint, value: ResponsiveValue<T>, fallback?: T) => T;
+declare const resolveResponsiveValue: <T>(value: ResponsiveValue<T>, fallback?: T) => Required<ResponsiveConfig<T>>;
+export declare const assertSafeCssValue: (value: unknown, label: string) => string;
+/**
+ * Represents the casing options for strings.
+ * - "lowercase"      -> hello world
+ * - "uppercase"      -> HELLO WORLD
+ * - "snakecase"      -> hello_world
+ * - "kebabcase"      -> hello-world
+ * - "camelcase"      -> helloWorld
+ * - "pascalcase"     -> HelloWorld
+ * - "sentencecase"   -> Hello world
+ * - "headercase"     -> Hello World
+ **/
+type StringCasing = "lowercase" | "uppercase" | "snakecase" | "kebabcase" | "camelcase" | "pascalcase" | "sentencecase" | "headercase";
+/**
+ * Transforms the input string into the specified casing.
+ * Casing can be one of the following:
+ * - "lowercase"      -> hello world
+ * - "uppercase"      -> HELLO WORLD
+ * - "snakecase"      -> hello_world
+ * - "kebabcase"      -> hello-world
+ * - "camelcase"      -> helloWorld
+ * - "pascalcase"     -> HelloWorld
+ * - "sentencecase"   -> Hello world
+ * - "headercase"     -> Hello World
+ **/
+export declare const stringWithCasing: (input: string, casing: StringCasing) => string;
+/** Normalizes a search string by removing diacritics and converting to lowercase */
+export declare const normalizeSearchString: (value: string) => string;
+/** Removes unsafe characters from a string */
+export declare const withSafeCharacters: (input: string) => string;
+/** Escapes special characters in a string for use in CSS strings */
+export declare const escapeCssString: (value: string) => string;
+/**
+ * Represents a valid argument for the `classNames` function.
+ * It can be a string, an array of strings, undefined, null, or false.
+ */
+type ClassnameArg = string | string[] | undefined | null | false;
+/**
+ * Concatenates and trims the given arguments into a single string of class names.
+ *
+ * @param args - The arguments to be concatenated.
+ * @returns A string of class names.
+ */
+export declare const cn: (...args: ClassnameArg[]) => string;
+export declare const nameToInitials: (name: string) => string;
+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;
+/**
+ * Call the original function, but applying the debounce rules.
+ *
+ * Only the last call to the function shall be executed after the timeout has been reached.
+ * @returns the debounced function with a cancel function property to clear the timeout.
+ */
+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 };

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+type DeepPartial<T> = { [K in keyof T]?: T[K] extends readonly unknown[] ? T[K] : T[K] extends object ? DeepPartial<T[K]> : T[K]; };
+export declare const BREAKPOINTS: readonly ["mobile", "tablet", "desktop"];
+type Breakpoint = (typeof BREAKPOINTS)[number];
+type ResponsiveConfig<T> = Omit<Partial<Record<(typeof BREAKPOINTS)[number], T>>, "mobile"> & {
+  mobile: T;
+};
+type ResponsiveValue<T> = T | ResponsiveConfig<T> | undefined;
+declare const resolveResponsiveValueForBreakpoint: <T>(breakpoint: Breakpoint, value: ResponsiveValue<T>, fallback?: T) => T;
+declare const resolveResponsiveValue: <T>(value: ResponsiveValue<T>, fallback?: T) => Required<ResponsiveConfig<T>>;
+export declare const assertSafeCssValue: (value: unknown, label: string) => string;
+/**
+ * Represents the casing options for strings.
+ * - "lowercase"      -> hello world
+ * - "uppercase"      -> HELLO WORLD
+ * - "snakecase"      -> hello_world
+ * - "kebabcase"      -> hello-world
+ * - "camelcase"      -> helloWorld
+ * - "pascalcase"     -> HelloWorld
+ * - "sentencecase"   -> Hello world
+ * - "headercase"     -> Hello World
+ **/
+type StringCasing = "lowercase" | "uppercase" | "snakecase" | "kebabcase" | "camelcase" | "pascalcase" | "sentencecase" | "headercase";
+/**
+ * Transforms the input string into the specified casing.
+ * Casing can be one of the following:
+ * - "lowercase"      -> hello world
+ * - "uppercase"      -> HELLO WORLD
+ * - "snakecase"      -> hello_world
+ * - "kebabcase"      -> hello-world
+ * - "camelcase"      -> helloWorld
+ * - "pascalcase"     -> HelloWorld
+ * - "sentencecase"   -> Hello world
+ * - "headercase"     -> Hello World
+ **/
+export declare const stringWithCasing: (input: string, casing: StringCasing) => string;
+/** Normalizes a search string by removing diacritics and converting to lowercase */
+export declare const normalizeSearchString: (value: string) => string;
+/** Removes unsafe characters from a string */
+export declare const withSafeCharacters: (input: string) => string;
+/** Escapes special characters in a string for use in CSS strings */
+export declare const escapeCssString: (value: string) => string;
+/**
+ * Represents a valid argument for the `classNames` function.
+ * It can be a string, an array of strings, undefined, null, or false.
+ */
+type ClassnameArg = string | string[] | undefined | null | false;
+/**
+ * Concatenates and trims the given arguments into a single string of class names.
+ *
+ * @param args - The arguments to be concatenated.
+ * @returns A string of class names.
+ */
+export declare const cn: (...args: ClassnameArg[]) => string;
+export declare const nameToInitials: (name: string) => string;
+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;
+/**
+ * Call the original function, but applying the debounce rules.
+ *
+ * Only the last call to the function shall be executed after the timeout has been reached.
+ * @returns the debounced function with a cancel function property to clear the timeout.
+ */
+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 };

package/dist/index.js

@@ -0,0 +1,211 @@
+// src/responsive/constants.ts
+const BREAKPOINTS = [
+	"mobile",
+	"tablet",
+	"desktop"
+];
+// src/responsive/index.ts
+const resolveResponsiveValueForBreakpoint = (breakpoint, value, fallback) => {
+	if (value === void 0 || value === null) return fallback;
+	return typeof value !== "object" || !(breakpoint in value) ? value ?? fallback : value[breakpoint] ?? fallback;
+};
+const resolveResponsiveValue = (value, fallback) => {
+	const mobile = resolveResponsiveValueForBreakpoint("mobile", value, fallback);
+	const tablet = resolveResponsiveValueForBreakpoint("tablet", value, mobile);
+	return {
+		mobile,
+		tablet,
+		desktop: resolveResponsiveValueForBreakpoint("desktop", value, tablet)
+	};
+};
+// src/string/assert.ts
+const assertSafeCssValue = (value, label) => {
+	if (typeof value !== "string" && typeof value !== "number") throw new TypeError(`${label} must be a string or number.`);
+	const serialized = String(value).trim();
+	if (serialized.length === 0 || /[;{}<>\u0000-\u001f\u007f]/.test(serialized)) throw new TypeError(`${label} must be a non-empty CSS value and must not contain semicolons, braces, angle brackets, or control characters.`);
+	return serialized;
+};
+// src/string/normalize.ts
+/** Normalizes a search string by removing diacritics and converting to lowercase */
+const normalizeSearchString = (value) => value.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLocaleLowerCase();
+/** Removes unsafe characters from a string */
+const withSafeCharacters = (input) => input.trim().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-zA-Z0-9\s-]/g, "").replace(/([A-Z].*[^\s][A-Z])/g, "$1".slice(0, 1).toUpperCase() + "$1".slice(1).toLowerCase());
+/** Escapes special characters in a string for use in CSS strings */
+const escapeCssString = (value) => {
+	return value.replace(/["\\\n\r\f]/g, (character) => {
+		switch (character) {
+			case "\"": return "\\\"";
+			case "\\": return "\\\\";
+			case "\n": return "\\a ";
+			case "\r": return "\\d ";
+			case "\f": return "\\c ";
+			default: return character;
+		}
+	});
+};
+// src/string/casing.ts
+/**
+* Transforms the input string into the specified casing.
+* Casing can be one of the following:
+* - "lowercase"      -> hello world
+* - "uppercase"      -> HELLO WORLD
+* - "snakecase"      -> hello_world
+* - "kebabcase"      -> hello-world
+* - "camelcase"      -> helloWorld
+* - "pascalcase"     -> HelloWorld
+* - "sentencecase"   -> Hello world
+* - "headercase"     -> Hello World
+**/
+const stringWithCasing = (input, casing) => {
+	const trimmedInput = input.trim();
+	const cleanedInput = withSafeCharacters(trimmedInput);
+	switch (casing) {
+		case "lowercase": return trimmedInput.toLowerCase();
+		case "uppercase": return trimmedInput.toUpperCase();
+		case "snakecase": return cleanedInput.replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, "").replace(/([a-z])([A-Z])/g, (_m, a, b) => a + "_" + b.toLowerCase()).replace(/[^A-Za-z0-9]+|_+/g, "_").toLowerCase();
+		case "kebabcase": return trimmedInput.replace(/^[^A-Za-z0-9]*-?|[^A-Za-z0-9]*-?$/g, "").replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`).replace(/[^A-Za-z0-9]+|_+/g, "-").toLowerCase();
+		case "camelcase": return cleanedInput.replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, "").replace(/[^A-Za-z0-9]+/g, "$").replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}$${b}`).toLowerCase().replace(/(\$)(\w)/g, (_m, _a, b) => b.toUpperCase());
+		case "pascalcase": return cleanedInput.replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, "$").replace(/[^A-Za-z0-9]+/g, "$").replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}$${b}`).toLowerCase().replace(/(\$)(\w?)/g, (_m, a, b) => b.toUpperCase());
+		case "sentencecase": {
+			const textcase = trimmedInput.replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, "").replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`).replace(/[^A-Za-z0-9]+|_+/g, " ").toLowerCase();
+			return textcase.charAt(0).toUpperCase() + textcase.slice(1);
+		}
+		case "headercase": return trimmedInput.replace(/^[^A-Za-z0-9]*|[^A-Za-z0-9]*$/g, "").replace(/([a-z])([A-Z])/g, (_m, a, b) => `${a}_${b.toLowerCase()}`).replace(/[^A-Za-z0-9]+|_+/g, " ").toLowerCase().replace(/( ?)(\w+)( ?)/g, (m, a, b, c) => a + b.charAt(0).toUpperCase() + b.slice(1) + c);
+	}
+};
+// src/string/class-names.ts
+/**
+* Concatenates and trims the given arguments into a single string of class names.
+*
+* @param args - The arguments to be concatenated.
+* @returns A string of class names.
+*/
+const cn = (...args) => {
+	return args.filter((v) => !!v).flat().flatMap((v) => v.split(" ")).filter((v) => v.length > 0).join(" ").trim();
+};
+// src/string/name-to-initials.ts
+const NAME_PARTICLES = /* @__PURE__ */ new Set([
+	"van",
+	"den",
+	"der",
+	"de",
+	"ter",
+	"ten",
+	"te",
+	"het",
+	"'t",
+	"von",
+	"vom",
+	"zum",
+	"zur",
+	"zu",
+	"du",
+	"des",
+	"le",
+	"la",
+	"les",
+	"del",
+	"los",
+	"las",
+	"da",
+	"das",
+	"do",
+	"dos",
+	"di",
+	"della",
+	"delle",
+	"dello",
+	"dei",
+	"degli",
+	"al",
+	"el",
+	"bin",
+	"ibn",
+	"bint",
+	"af",
+	"av",
+	"ap",
+	"ab"
+]);
+const NAME_SUFFIXES = /* @__PURE__ */ new Set([
+	"jr",
+	"sr",
+	"ii",
+	"iii",
+	"iv",
+	"v",
+	"phd",
+	"md"
+]);
+const normalizeNamePart = (part) => {
+	return part.toLocaleLowerCase().replace(/[\p{P}\p{S}]/gu, "");
+};
+const getFirstLetter = (part) => {
+	return part.match(/\p{L}/u)?.[0].toLocaleUpperCase() ?? "";
+};
+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]);
+	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]);
+};
+// 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);
+	}
+	return {
+		r,
+		g,
+		b
+	};
+};
+const rgbToHex = (r, g, b) => {
+	const toHex = (value) => {
+		const hex = value.toString(16);
+		return hex.length === 1 ? "0" + hex : hex;
+	};
+	return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+};
+// src/color/is-color.ts
+const isHexColor = (color) => {
+	return /^#([0-9A-F]{3}){1,2}$/i.test(color);
+};
+const linearize = (value) => {
+	const channel = value / 255;
+	return channel <= .04045 ? channel / 12.92 : ((channel + .055) / 1.055) ** 2.4;
+};
+/** 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;
+};
+// src/timing/debounce.ts
+/**
+* Call the original function, but applying the debounce rules.
+*
+* Only the last call to the function shall be executed after the timeout has been reached.
+* @returns the debounced function with a cancel function property to clear the timeout.
+*/
+const debounce = (func, wait) => {
+	let timeout;
+	const cancel = () => clearTimeout(timeout);
+	return Object.assign((...args) => {
+		clearTimeout(timeout);
+		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 };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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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"}

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@puzzle-ui/core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Framework-independent utilities",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsdown",
+    "prepack": "tsdown",
+    "vitest": "bunx vitest run --passWithNoTests",
+    "vitest:watch": "bunx vitest"
+  },
+  "devDependencies": {
+    "tsdown": "^0.23.1",
+    "tsup": "latest",
+    "typescript": "^6.0.3"
+  }
+}