@itshackers/utilix 0.0.0-stage → 0.3.0

package/dist/string/index.cjs

@@ -0,0 +1,130 @@
+'use strict';
+
+// src/internal/validation.ts
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/string/index.ts
+var HTML_ESCAPE_MAP = {
+  "&": "&",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;"
+};
+function splitWords(value) {
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    return [];
+  }
+  return trimmed.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").split(/[\s._-]+/u).filter((word) => word.length > 0);
+}
+function toLowerWords(value) {
+  return splitWords(value).map((word) => word.toLowerCase());
+}
+function capitalizeWord(word) {
+  const [first = "", ...rest] = [...word];
+  return `${first.toUpperCase()}${rest.join("").toLowerCase()}`;
+}
+function toCamelCase(value) {
+  const words = toLowerWords(value);
+  if (words.length === 0) {
+    return "";
+  }
+  const [first = "", ...rest] = words;
+  return `${first}${rest.map(capitalizeWord).join("")}`;
+}
+function toPascalCase(value) {
+  return toLowerWords(value).map(capitalizeWord).join("");
+}
+function toSnakeCase(value) {
+  return toLowerWords(value).join("_");
+}
+function toKebabCase(value) {
+  return toLowerWords(value).join("-");
+}
+function capitalize(value) {
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    return "";
+  }
+  const [first = "", ...rest] = [...trimmed];
+  return `${first.toUpperCase()}${rest.join("")}`;
+}
+function normalizeWhitespace(value) {
+  return value.trim().replace(/\s+/gu, " ");
+}
+function escapeHtml(value) {
+  return value.replace(/[&<>"']/g, (character) => HTML_ESCAPE_MAP[character] ?? character);
+}
+function escapeRegex(value) {
+  return escapeRegExp(value);
+}
+function toTitleCase(value) {
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    return "";
+  }
+  return trimmed.toLowerCase().replace(/\b\w/g, (character) => character.toUpperCase());
+}
+function convertCase(value, casing = "title") {
+  switch (casing.toLowerCase()) {
+    case "title":
+    case "titlecase":
+      return toTitleCase(value);
+    case "lower":
+    case "lowercase":
+      return value.trim().toLowerCase();
+    case "upper":
+    case "uppercase":
+      return value.trim().toUpperCase();
+    case "camel":
+    case "camelcase":
+      return toCamelCase(value);
+    case "pascal":
+    case "pascalcase":
+      return toPascalCase(value);
+    case "snake":
+    case "snakecase":
+      return toSnakeCase(value);
+    case "kebab":
+    case "kebabcase":
+      return toKebabCase(value);
+    default:
+      throw new TypeError(`Unsupported case style: ${casing}`);
+  }
+}
+function replaceSeparatorsWithSpace(value) {
+  return toTitleCase(value.replace(/[-_]+/g, " ").replace(/\s+/g, " "));
+}
+function htmlToPlainText(value) {
+  if (value.trim().length === 0) {
+    return "";
+  }
+  return value.replace(/<(br|\/p|\/div|\/pre|\/li)\b[^>]*>/gi, " ").replace(/<[^>]*>/g, " ").replace(/[\n\t]+/g, " ").replace(/\s+/g, " ").trim();
+}
+function nonEmptyString(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length === 0 ? null : trimmed;
+}
+
+exports.capitalize = capitalize;
+exports.convertCase = convertCase;
+exports.escapeHtml = escapeHtml;
+exports.escapeRegExp = escapeRegex;
+exports.escapeRegex = escapeRegex;
+exports.htmlToPlainText = htmlToPlainText;
+exports.nonEmptyString = nonEmptyString;
+exports.normalizeWhitespace = normalizeWhitespace;
+exports.replaceSeparatorsWithSpace = replaceSeparatorsWithSpace;
+exports.toCamelCase = toCamelCase;
+exports.toKebabCase = toKebabCase;
+exports.toPascalCase = toPascalCase;
+exports.toSnakeCase = toSnakeCase;
+exports.toTitleCase = toTitleCase;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/string/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/validation.ts","../../src/string/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export function assertFiniteNumber(\r\n  value: unknown,\r\n  name: string,\r\n): asserts value is number {\r\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\r\n    throw new TypeError(`${name} must be a finite number`);\r\n  }\r\n}\r\n\r\nexport function escapeRegExp(value: string): string {\r\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n","import { escapeRegExp } from \"../internal/validation.js\";\r\n\r\nexport type TextCase =\r\n  | \"title\"\r\n  | \"titlecase\"\r\n  | \"lower\"\r\n  | \"lowercase\"\r\n  | \"upper\"\r\n  | \"uppercase\"\r\n  | \"camel\"\r\n  | \"camelcase\"\r\n  | \"pascal\"\r\n  | \"pascalcase\"\r\n  | \"snake\"\r\n  | \"snakecase\"\r\n  | \"kebab\"\r\n  | \"kebabcase\";\r\n\r\nconst HTML_ESCAPE_MAP: Record<string, string> = {\r\n  \"&\": \"&amp;\",\r\n  \"<\": \"&lt;\",\r\n  \">\": \"&gt;\",\r\n  '\"': \"&quot;\",\r\n  \"'\": \"&#39;\",\r\n};\r\n\r\n/**\r\n * Splits mixed naming conventions into discrete words.\r\n * Handles spaces, hyphens, underscores, dots, and camel/PascalCase boundaries.\r\n */\r\nfunction splitWords(value: string): string[] {\r\n  const trimmed = value.trim();\r\n  if (trimmed.length === 0) {\r\n    return [];\r\n  }\r\n\r\n  return trimmed\r\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\r\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1 $2\")\r\n    .split(/[\\s._-]+/u)\r\n    .filter((word) => word.length > 0);\r\n}\r\n\r\nfunction toLowerWords(value: string): string[] {\r\n  return splitWords(value).map((word) => word.toLowerCase());\r\n}\r\n\r\nfunction capitalizeWord(word: string): string {\r\n  const [first = \"\", ...rest] = [...word];\r\n  return `${first.toUpperCase()}${rest.join(\"\").toLowerCase()}`;\r\n}\r\n\r\n/**\r\n * Converts a string to camelCase.\r\n *\r\n * @example\r\n * toCamelCase(\"hello-world\") // \"helloWorld\"\r\n * toCamelCase(\"XMLHttpRequest\") // \"xmlHttpRequest\"\r\n */\r\nexport function toCamelCase(value: string): string {\r\n  const words = toLowerWords(value);\r\n  if (words.length === 0) {\r\n    return \"\";\r\n  }\r\n\r\n  const [first = \"\", ...rest] = words;\r\n  return `${first}${rest.map(capitalizeWord).join(\"\")}`;\r\n}\r\n\r\n/**\r\n * Converts a string to PascalCase.\r\n *\r\n * @example\r\n * toPascalCase(\"hello_world\") // \"HelloWorld\"\r\n */\r\nexport function toPascalCase(value: string): string {\r\n  return toLowerWords(value).map(capitalizeWord).join(\"\");\r\n}\r\n\r\n/**\r\n * Converts a string to snake_case.\r\n *\r\n * @example\r\n * toSnakeCase(\"Hello World\") // \"hello_world\"\r\n */\r\nexport function toSnakeCase(value: string): string {\r\n  return toLowerWords(value).join(\"_\");\r\n}\r\n\r\n/**\r\n * Converts a string to kebab-case.\r\n *\r\n * @example\r\n * toKebabCase(\"HelloWorld\") // \"hello-world\"\r\n */\r\nexport function toKebabCase(value: string): string {\r\n  return toLowerWords(value).join(\"-\");\r\n}\r\n\r\n/**\r\n * Trims the string and uppercases its first Unicode character.\r\n * The remaining characters are left unchanged.\r\n *\r\n * @example\r\n * capitalize(\"  hello world\") // \"Hello world\"\r\n */\r\nexport function capitalize(value: string): string {\r\n  const trimmed = value.trim();\r\n  if (trimmed.length === 0) {\r\n    return \"\";\r\n  }\r\n\r\n  const [first = \"\", ...rest] = [...trimmed];\r\n  return `${first.toUpperCase()}${rest.join(\"\")}`;\r\n}\r\n\r\n/**\r\n * Trims leading and trailing whitespace and collapses internal\r\n * whitespace runs to a single space.\r\n *\r\n * @example\r\n * normalizeWhitespace(\"  hello \\t\\n world  \") // \"hello world\"\r\n */\r\nexport function normalizeWhitespace(value: string): string {\r\n  return value.trim().replace(/\\s+/gu, \" \");\r\n}\r\n\r\n/**\r\n * Escapes `&`, `<`, `>`, `\"`, and `'` for safe interpolation into HTML text\r\n * or quoted attributes.\r\n *\r\n * This is not an HTML sanitizer. It does not parse markup, remove scripts,\r\n * or make untrusted HTML safe to render.\r\n *\r\n * @example\r\n * escapeHtml(`<img alt=\"O'Reilly & Co\">`)\r\n * // \"&lt;img alt=&quot;O&#39;Reilly &amp; Co&quot;&gt;\"\r\n */\r\nexport function escapeHtml(value: string): string {\r\n  return value.replace(/[&<>\"']/g, (character) => HTML_ESCAPE_MAP[character] ?? character);\r\n}\r\n\r\n/**\r\n * Escapes special regular-expression characters in a string.\r\n *\r\n * @example\r\n * escapeRegex(\"file.name.txt\") // \"file\\\\.name\\\\.txt\"\r\n */\r\nexport function escapeRegex(value: string): string {\r\n  return escapeRegExp(value);\r\n}\r\n\r\nexport { escapeRegex as escapeRegExp };\r\n\r\n/**\r\n * Converts a string to Title Case using word boundaries.\r\n *\r\n * @example\r\n * toTitleCase(\"hello world\") // \"Hello World\"\r\n * toTitleCase(\"used-truck\") // \"Used-Truck\"\r\n */\r\nexport function toTitleCase(value: string): string {\r\n  const trimmed = value.trim();\r\n  if (trimmed.length === 0) {\r\n    return \"\";\r\n  }\r\n\r\n  return trimmed.toLowerCase().replace(/\\b\\w/g, (character) => character.toUpperCase());\r\n}\r\n\r\n/**\r\n * Converts a string to one of the supported case styles.\r\n * Unknown styles throw rather than silently falling back.\r\n *\r\n * @example\r\n * convertCase(\"hello world\", \"title\") // \"Hello World\"\r\n * convertCase(\"hello-world\", \"camel\") // \"helloWorld\"\r\n */\r\nexport function convertCase(value: string, casing: TextCase = \"title\"): string {\r\n  switch (casing.toLowerCase() as TextCase) {\r\n    case \"title\":\r\n    case \"titlecase\":\r\n      return toTitleCase(value);\r\n    case \"lower\":\r\n    case \"lowercase\":\r\n      return value.trim().toLowerCase();\r\n    case \"upper\":\r\n    case \"uppercase\":\r\n      return value.trim().toUpperCase();\r\n    case \"camel\":\r\n    case \"camelcase\":\r\n      return toCamelCase(value);\r\n    case \"pascal\":\r\n    case \"pascalcase\":\r\n      return toPascalCase(value);\r\n    case \"snake\":\r\n    case \"snakecase\":\r\n      return toSnakeCase(value);\r\n    case \"kebab\":\r\n    case \"kebabcase\":\r\n      return toKebabCase(value);\r\n    default:\r\n      throw new TypeError(`Unsupported case style: ${casing}`);\r\n  }\r\n}\r\n\r\n/**\r\n * Replaces hyphens and underscores with spaces, then title-cases the result.\r\n *\r\n * @example\r\n * replaceSeparatorsWithSpace(\"used-truck\") // \"Used Truck\"\r\n * replaceSeparatorsWithSpace(\"hello_world\") // \"Hello World\"\r\n */\r\nexport function replaceSeparatorsWithSpace(value: string): string {\r\n  return toTitleCase(value.replace(/[-_]+/g, \" \").replace(/\\s+/g, \" \"));\r\n}\r\n\r\n/**\r\n * Strips HTML tags and collapses whitespace into a single-line plain-text string.\r\n *\r\n * This is not an HTML sanitizer or a complete HTML parser. It does not decode\r\n * all entities or preserve document structure.\r\n *\r\n * @example\r\n * htmlToPlainText(\"<p>Hello<br>World</p>\") // \"Hello World\"\r\n */\r\nexport function htmlToPlainText(value: string): string {\r\n  if (value.trim().length === 0) {\r\n    return \"\";\r\n  }\r\n\r\n  return value\r\n    .replace(/<(br|\\/p|\\/div|\\/pre|\\/li)\\b[^>]*>/gi, \" \")\r\n    .replace(/<[^>]*>/g, \" \")\r\n    .replace(/[\\n\\t]+/g, \" \")\r\n    .replace(/\\s+/g, \" \")\r\n    .trim();\r\n}\r\n\r\n/**\r\n * Returns a trimmed string, or `null` when the value is not a non-empty string.\r\n *\r\n * @example\r\n * nonEmptyString(\"  Gold  \") // \"Gold\"\r\n * nonEmptyString(\"   \") // null\r\n */\r\nexport function nonEmptyString(value: unknown): string | null {\r\n  if (typeof value !== \"string\") {\r\n    return null;\r\n  }\r\n\r\n  const trimmed = value.trim();\r\n  return trimmed.length === 0 ? null : trimmed;\r\n}\r\n"]}

package/dist/string/index.d.cts

@@ -0,0 +1,112 @@
+type TextCase = "title" | "titlecase" | "lower" | "lowercase" | "upper" | "uppercase" | "camel" | "camelcase" | "pascal" | "pascalcase" | "snake" | "snakecase" | "kebab" | "kebabcase";
+/**
+ * Converts a string to camelCase.
+ *
+ * @example
+ * toCamelCase("hello-world") // "helloWorld"
+ * toCamelCase("XMLHttpRequest") // "xmlHttpRequest"
+ */
+declare function toCamelCase(value: string): string;
+/**
+ * Converts a string to PascalCase.
+ *
+ * @example
+ * toPascalCase("hello_world") // "HelloWorld"
+ */
+declare function toPascalCase(value: string): string;
+/**
+ * Converts a string to snake_case.
+ *
+ * @example
+ * toSnakeCase("Hello World") // "hello_world"
+ */
+declare function toSnakeCase(value: string): string;
+/**
+ * Converts a string to kebab-case.
+ *
+ * @example
+ * toKebabCase("HelloWorld") // "hello-world"
+ */
+declare function toKebabCase(value: string): string;
+/**
+ * Trims the string and uppercases its first Unicode character.
+ * The remaining characters are left unchanged.
+ *
+ * @example
+ * capitalize("  hello world") // "Hello world"
+ */
+declare function capitalize(value: string): string;
+/**
+ * Trims leading and trailing whitespace and collapses internal
+ * whitespace runs to a single space.
+ *
+ * @example
+ * normalizeWhitespace("  hello \t\n world  ") // "hello world"
+ */
+declare function normalizeWhitespace(value: string): string;
+/**
+ * Escapes `&`, `<`, `>`, `"`, and `'` for safe interpolation into HTML text
+ * or quoted attributes.
+ *
+ * This is not an HTML sanitizer. It does not parse markup, remove scripts,
+ * or make untrusted HTML safe to render.
+ *
+ * @example
+ * escapeHtml(`<img alt="O'Reilly & Co">`)
+ * // "&lt;img alt=&quot;O&#39;Reilly &amp; Co&quot;&gt;"
+ */
+declare function escapeHtml(value: string): string;
+/**
+ * Escapes special regular-expression characters in a string.
+ *
+ * @example
+ * escapeRegex("file.name.txt") // "file\\.name\\.txt"
+ */
+declare function escapeRegex(value: string): string;
+
+/**
+ * Converts a string to Title Case using word boundaries.
+ *
+ * @example
+ * toTitleCase("hello world") // "Hello World"
+ * toTitleCase("used-truck") // "Used-Truck"
+ */
+declare function toTitleCase(value: string): string;
+/**
+ * Converts a string to one of the supported case styles.
+ * Unknown styles throw rather than silently falling back.
+ *
+ * @example
+ * convertCase("hello world", "title") // "Hello World"
+ * convertCase("hello-world", "camel") // "helloWorld"
+ */
+declare function convertCase(value: string, casing?: TextCase): string;
+/**
+ * Replaces hyphens and underscores with spaces, then title-cases the result.
+ *
+ * @example
+ * replaceSeparatorsWithSpace("used-truck") // "Used Truck"
+ * replaceSeparatorsWithSpace("hello_world") // "Hello World"
+ */
+declare function replaceSeparatorsWithSpace(value: string): string;
+/**
+ * Strips HTML tags and collapses whitespace into a single-line plain-text string.
+ *
+ * This is not an HTML sanitizer or a complete HTML parser. It does not decode
+ * all entities or preserve document structure.
+ *
+ * @example
+ * htmlToPlainText("<p>Hello<br>World</p>") // "Hello World"
+ */
+declare function htmlToPlainText(value: string): string;
+/**
+ * Returns a trimmed string, or `null` when the value is not a non-empty string.
+ *
+ * @example
+ * nonEmptyString("  Gold  ") // "Gold"
+ * nonEmptyString("   ") // null
+ */
+declare function nonEmptyString(value: unknown): string | null;
+
+export { capitalize, convertCase, escapeHtml, escapeRegex as escapeRegExp, escapeRegex, htmlToPlainText, nonEmptyString, normalizeWhitespace, replaceSeparatorsWithSpace, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, toTitleCase };
+export type { TextCase };

package/dist/string/index.d.ts

@@ -0,0 +1,112 @@
+type TextCase = "title" | "titlecase" | "lower" | "lowercase" | "upper" | "uppercase" | "camel" | "camelcase" | "pascal" | "pascalcase" | "snake" | "snakecase" | "kebab" | "kebabcase";
+/**
+ * Converts a string to camelCase.
+ *
+ * @example
+ * toCamelCase("hello-world") // "helloWorld"
+ * toCamelCase("XMLHttpRequest") // "xmlHttpRequest"
+ */
+declare function toCamelCase(value: string): string;
+/**
+ * Converts a string to PascalCase.
+ *
+ * @example
+ * toPascalCase("hello_world") // "HelloWorld"
+ */
+declare function toPascalCase(value: string): string;
+/**
+ * Converts a string to snake_case.
+ *
+ * @example
+ * toSnakeCase("Hello World") // "hello_world"
+ */
+declare function toSnakeCase(value: string): string;
+/**
+ * Converts a string to kebab-case.
+ *
+ * @example
+ * toKebabCase("HelloWorld") // "hello-world"
+ */
+declare function toKebabCase(value: string): string;
+/**
+ * Trims the string and uppercases its first Unicode character.
+ * The remaining characters are left unchanged.
+ *
+ * @example
+ * capitalize("  hello world") // "Hello world"
+ */
+declare function capitalize(value: string): string;
+/**
+ * Trims leading and trailing whitespace and collapses internal
+ * whitespace runs to a single space.
+ *
+ * @example
+ * normalizeWhitespace("  hello \t\n world  ") // "hello world"
+ */
+declare function normalizeWhitespace(value: string): string;
+/**
+ * Escapes `&`, `<`, `>`, `"`, and `'` for safe interpolation into HTML text
+ * or quoted attributes.
+ *
+ * This is not an HTML sanitizer. It does not parse markup, remove scripts,
+ * or make untrusted HTML safe to render.
+ *
+ * @example
+ * escapeHtml(`<img alt="O'Reilly & Co">`)
+ * // "&lt;img alt=&quot;O&#39;Reilly &amp; Co&quot;&gt;"
+ */
+declare function escapeHtml(value: string): string;
+/**
+ * Escapes special regular-expression characters in a string.
+ *
+ * @example
+ * escapeRegex("file.name.txt") // "file\\.name\\.txt"
+ */
+declare function escapeRegex(value: string): string;
+
+/**
+ * Converts a string to Title Case using word boundaries.
+ *
+ * @example
+ * toTitleCase("hello world") // "Hello World"
+ * toTitleCase("used-truck") // "Used-Truck"
+ */
+declare function toTitleCase(value: string): string;
+/**
+ * Converts a string to one of the supported case styles.
+ * Unknown styles throw rather than silently falling back.
+ *
+ * @example
+ * convertCase("hello world", "title") // "Hello World"
+ * convertCase("hello-world", "camel") // "helloWorld"
+ */
+declare function convertCase(value: string, casing?: TextCase): string;
+/**
+ * Replaces hyphens and underscores with spaces, then title-cases the result.
+ *
+ * @example
+ * replaceSeparatorsWithSpace("used-truck") // "Used Truck"
+ * replaceSeparatorsWithSpace("hello_world") // "Hello World"
+ */
+declare function replaceSeparatorsWithSpace(value: string): string;
+/**
+ * Strips HTML tags and collapses whitespace into a single-line plain-text string.
+ *
+ * This is not an HTML sanitizer or a complete HTML parser. It does not decode
+ * all entities or preserve document structure.
+ *
+ * @example
+ * htmlToPlainText("<p>Hello<br>World</p>") // "Hello World"
+ */
+declare function htmlToPlainText(value: string): string;
+/**
+ * Returns a trimmed string, or `null` when the value is not a non-empty string.
+ *
+ * @example
+ * nonEmptyString("  Gold  ") // "Gold"
+ * nonEmptyString("   ") // null
+ */
+declare function nonEmptyString(value: unknown): string | null;
+
+export { capitalize, convertCase, escapeHtml, escapeRegex as escapeRegExp, escapeRegex, htmlToPlainText, nonEmptyString, normalizeWhitespace, replaceSeparatorsWithSpace, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, toTitleCase };
+export type { TextCase };

package/dist/string/index.js

@@ -0,0 +1,115 @@
+// src/internal/validation.ts
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/string/index.ts
+var HTML_ESCAPE_MAP = {
+  "&": "&",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;"
+};
+function splitWords(value) {
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    return [];
+  }
+  return trimmed.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").split(/[\s._-]+/u).filter((word) => word.length > 0);
+}
+function toLowerWords(value) {
+  return splitWords(value).map((word) => word.toLowerCase());
+}
+function capitalizeWord(word) {
+  const [first = "", ...rest] = [...word];
+  return `${first.toUpperCase()}${rest.join("").toLowerCase()}`;
+}
+function toCamelCase(value) {
+  const words = toLowerWords(value);
+  if (words.length === 0) {
+    return "";
+  }
+  const [first = "", ...rest] = words;
+  return `${first}${rest.map(capitalizeWord).join("")}`;
+}
+function toPascalCase(value) {
+  return toLowerWords(value).map(capitalizeWord).join("");
+}
+function toSnakeCase(value) {
+  return toLowerWords(value).join("_");
+}
+function toKebabCase(value) {
+  return toLowerWords(value).join("-");
+}
+function capitalize(value) {
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    return "";
+  }
+  const [first = "", ...rest] = [...trimmed];
+  return `${first.toUpperCase()}${rest.join("")}`;
+}
+function normalizeWhitespace(value) {
+  return value.trim().replace(/\s+/gu, " ");
+}
+function escapeHtml(value) {
+  return value.replace(/[&<>"']/g, (character) => HTML_ESCAPE_MAP[character] ?? character);
+}
+function escapeRegex(value) {
+  return escapeRegExp(value);
+}
+function toTitleCase(value) {
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    return "";
+  }
+  return trimmed.toLowerCase().replace(/\b\w/g, (character) => character.toUpperCase());
+}
+function convertCase(value, casing = "title") {
+  switch (casing.toLowerCase()) {
+    case "title":
+    case "titlecase":
+      return toTitleCase(value);
+    case "lower":
+    case "lowercase":
+      return value.trim().toLowerCase();
+    case "upper":
+    case "uppercase":
+      return value.trim().toUpperCase();
+    case "camel":
+    case "camelcase":
+      return toCamelCase(value);
+    case "pascal":
+    case "pascalcase":
+      return toPascalCase(value);
+    case "snake":
+    case "snakecase":
+      return toSnakeCase(value);
+    case "kebab":
+    case "kebabcase":
+      return toKebabCase(value);
+    default:
+      throw new TypeError(`Unsupported case style: ${casing}`);
+  }
+}
+function replaceSeparatorsWithSpace(value) {
+  return toTitleCase(value.replace(/[-_]+/g, " ").replace(/\s+/g, " "));
+}
+function htmlToPlainText(value) {
+  if (value.trim().length === 0) {
+    return "";
+  }
+  return value.replace(/<(br|\/p|\/div|\/pre|\/li)\b[^>]*>/gi, " ").replace(/<[^>]*>/g, " ").replace(/[\n\t]+/g, " ").replace(/\s+/g, " ").trim();
+}
+function nonEmptyString(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length === 0 ? null : trimmed;
+}
+
+export { capitalize, convertCase, escapeHtml, escapeRegex as escapeRegExp, escapeRegex, htmlToPlainText, nonEmptyString, normalizeWhitespace, replaceSeparatorsWithSpace, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, toTitleCase };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/string/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/validation.ts","../../src/string/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export function assertFiniteNumber(\r\n  value: unknown,\r\n  name: string,\r\n): asserts value is number {\r\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\r\n    throw new TypeError(`${name} must be a finite number`);\r\n  }\r\n}\r\n\r\nexport function escapeRegExp(value: string): string {\r\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n","import { escapeRegExp } from \"../internal/validation.js\";\r\n\r\nexport type TextCase =\r\n  | \"title\"\r\n  | \"titlecase\"\r\n  | \"lower\"\r\n  | \"lowercase\"\r\n  | \"upper\"\r\n  | \"uppercase\"\r\n  | \"camel\"\r\n  | \"camelcase\"\r\n  | \"pascal\"\r\n  | \"pascalcase\"\r\n  | \"snake\"\r\n  | \"snakecase\"\r\n  | \"kebab\"\r\n  | \"kebabcase\";\r\n\r\nconst HTML_ESCAPE_MAP: Record<string, string> = {\r\n  \"&\": \"&amp;\",\r\n  \"<\": \"&lt;\",\r\n  \">\": \"&gt;\",\r\n  '\"': \"&quot;\",\r\n  \"'\": \"&#39;\",\r\n};\r\n\r\n/**\r\n * Splits mixed naming conventions into discrete words.\r\n * Handles spaces, hyphens, underscores, dots, and camel/PascalCase boundaries.\r\n */\r\nfunction splitWords(value: string): string[] {\r\n  const trimmed = value.trim();\r\n  if (trimmed.length === 0) {\r\n    return [];\r\n  }\r\n\r\n  return trimmed\r\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\r\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1 $2\")\r\n    .split(/[\\s._-]+/u)\r\n    .filter((word) => word.length > 0);\r\n}\r\n\r\nfunction toLowerWords(value: string): string[] {\r\n  return splitWords(value).map((word) => word.toLowerCase());\r\n}\r\n\r\nfunction capitalizeWord(word: string): string {\r\n  const [first = \"\", ...rest] = [...word];\r\n  return `${first.toUpperCase()}${rest.join(\"\").toLowerCase()}`;\r\n}\r\n\r\n/**\r\n * Converts a string to camelCase.\r\n *\r\n * @example\r\n * toCamelCase(\"hello-world\") // \"helloWorld\"\r\n * toCamelCase(\"XMLHttpRequest\") // \"xmlHttpRequest\"\r\n */\r\nexport function toCamelCase(value: string): string {\r\n  const words = toLowerWords(value);\r\n  if (words.length === 0) {\r\n    return \"\";\r\n  }\r\n\r\n  const [first = \"\", ...rest] = words;\r\n  return `${first}${rest.map(capitalizeWord).join(\"\")}`;\r\n}\r\n\r\n/**\r\n * Converts a string to PascalCase.\r\n *\r\n * @example\r\n * toPascalCase(\"hello_world\") // \"HelloWorld\"\r\n */\r\nexport function toPascalCase(value: string): string {\r\n  return toLowerWords(value).map(capitalizeWord).join(\"\");\r\n}\r\n\r\n/**\r\n * Converts a string to snake_case.\r\n *\r\n * @example\r\n * toSnakeCase(\"Hello World\") // \"hello_world\"\r\n */\r\nexport function toSnakeCase(value: string): string {\r\n  return toLowerWords(value).join(\"_\");\r\n}\r\n\r\n/**\r\n * Converts a string to kebab-case.\r\n *\r\n * @example\r\n * toKebabCase(\"HelloWorld\") // \"hello-world\"\r\n */\r\nexport function toKebabCase(value: string): string {\r\n  return toLowerWords(value).join(\"-\");\r\n}\r\n\r\n/**\r\n * Trims the string and uppercases its first Unicode character.\r\n * The remaining characters are left unchanged.\r\n *\r\n * @example\r\n * capitalize(\"  hello world\") // \"Hello world\"\r\n */\r\nexport function capitalize(value: string): string {\r\n  const trimmed = value.trim();\r\n  if (trimmed.length === 0) {\r\n    return \"\";\r\n  }\r\n\r\n  const [first = \"\", ...rest] = [...trimmed];\r\n  return `${first.toUpperCase()}${rest.join(\"\")}`;\r\n}\r\n\r\n/**\r\n * Trims leading and trailing whitespace and collapses internal\r\n * whitespace runs to a single space.\r\n *\r\n * @example\r\n * normalizeWhitespace(\"  hello \\t\\n world  \") // \"hello world\"\r\n */\r\nexport function normalizeWhitespace(value: string): string {\r\n  return value.trim().replace(/\\s+/gu, \" \");\r\n}\r\n\r\n/**\r\n * Escapes `&`, `<`, `>`, `\"`, and `'` for safe interpolation into HTML text\r\n * or quoted attributes.\r\n *\r\n * This is not an HTML sanitizer. It does not parse markup, remove scripts,\r\n * or make untrusted HTML safe to render.\r\n *\r\n * @example\r\n * escapeHtml(`<img alt=\"O'Reilly & Co\">`)\r\n * // \"&lt;img alt=&quot;O&#39;Reilly &amp; Co&quot;&gt;\"\r\n */\r\nexport function escapeHtml(value: string): string {\r\n  return value.replace(/[&<>\"']/g, (character) => HTML_ESCAPE_MAP[character] ?? character);\r\n}\r\n\r\n/**\r\n * Escapes special regular-expression characters in a string.\r\n *\r\n * @example\r\n * escapeRegex(\"file.name.txt\") // \"file\\\\.name\\\\.txt\"\r\n */\r\nexport function escapeRegex(value: string): string {\r\n  return escapeRegExp(value);\r\n}\r\n\r\nexport { escapeRegex as escapeRegExp };\r\n\r\n/**\r\n * Converts a string to Title Case using word boundaries.\r\n *\r\n * @example\r\n * toTitleCase(\"hello world\") // \"Hello World\"\r\n * toTitleCase(\"used-truck\") // \"Used-Truck\"\r\n */\r\nexport function toTitleCase(value: string): string {\r\n  const trimmed = value.trim();\r\n  if (trimmed.length === 0) {\r\n    return \"\";\r\n  }\r\n\r\n  return trimmed.toLowerCase().replace(/\\b\\w/g, (character) => character.toUpperCase());\r\n}\r\n\r\n/**\r\n * Converts a string to one of the supported case styles.\r\n * Unknown styles throw rather than silently falling back.\r\n *\r\n * @example\r\n * convertCase(\"hello world\", \"title\") // \"Hello World\"\r\n * convertCase(\"hello-world\", \"camel\") // \"helloWorld\"\r\n */\r\nexport function convertCase(value: string, casing: TextCase = \"title\"): string {\r\n  switch (casing.toLowerCase() as TextCase) {\r\n    case \"title\":\r\n    case \"titlecase\":\r\n      return toTitleCase(value);\r\n    case \"lower\":\r\n    case \"lowercase\":\r\n      return value.trim().toLowerCase();\r\n    case \"upper\":\r\n    case \"uppercase\":\r\n      return value.trim().toUpperCase();\r\n    case \"camel\":\r\n    case \"camelcase\":\r\n      return toCamelCase(value);\r\n    case \"pascal\":\r\n    case \"pascalcase\":\r\n      return toPascalCase(value);\r\n    case \"snake\":\r\n    case \"snakecase\":\r\n      return toSnakeCase(value);\r\n    case \"kebab\":\r\n    case \"kebabcase\":\r\n      return toKebabCase(value);\r\n    default:\r\n      throw new TypeError(`Unsupported case style: ${casing}`);\r\n  }\r\n}\r\n\r\n/**\r\n * Replaces hyphens and underscores with spaces, then title-cases the result.\r\n *\r\n * @example\r\n * replaceSeparatorsWithSpace(\"used-truck\") // \"Used Truck\"\r\n * replaceSeparatorsWithSpace(\"hello_world\") // \"Hello World\"\r\n */\r\nexport function replaceSeparatorsWithSpace(value: string): string {\r\n  return toTitleCase(value.replace(/[-_]+/g, \" \").replace(/\\s+/g, \" \"));\r\n}\r\n\r\n/**\r\n * Strips HTML tags and collapses whitespace into a single-line plain-text string.\r\n *\r\n * This is not an HTML sanitizer or a complete HTML parser. It does not decode\r\n * all entities or preserve document structure.\r\n *\r\n * @example\r\n * htmlToPlainText(\"<p>Hello<br>World</p>\") // \"Hello World\"\r\n */\r\nexport function htmlToPlainText(value: string): string {\r\n  if (value.trim().length === 0) {\r\n    return \"\";\r\n  }\r\n\r\n  return value\r\n    .replace(/<(br|\\/p|\\/div|\\/pre|\\/li)\\b[^>]*>/gi, \" \")\r\n    .replace(/<[^>]*>/g, \" \")\r\n    .replace(/[\\n\\t]+/g, \" \")\r\n    .replace(/\\s+/g, \" \")\r\n    .trim();\r\n}\r\n\r\n/**\r\n * Returns a trimmed string, or `null` when the value is not a non-empty string.\r\n *\r\n * @example\r\n * nonEmptyString(\"  Gold  \") // \"Gold\"\r\n * nonEmptyString(\"   \") // null\r\n */\r\nexport function nonEmptyString(value: unknown): string | null {\r\n  if (typeof value !== \"string\") {\r\n    return null;\r\n  }\r\n\r\n  const trimmed = value.trim();\r\n  return trimmed.length === 0 ? null : trimmed;\r\n}\r\n"]}