Merge pull request #2 from jhonsnow456/feat/text

feat(text): add capitalize, stripAnsi, isAlpha, isNumeric, isAlphanumeric, escapeHtml, unescapeHtml

Author: hey-amanthakur

text/capitalize.ts

@@ -0,0 +1,22 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+// This module is browser compatible.
+
+/**
+ * Capitalizes the first character of a string and lowercases the rest.
+ *
+ * @param input The string to capitalize
+ * @returns The capitalized string
+ *
+ * @example Usage
+ * ```ts
+ * import { capitalize } from "@std/text/capitalize";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(capitalize("hello"), "Hello");
+ * assertEquals(capitalize("hELLO"), "Hello");
+ * ```
+ */
+export function capitalize(input: string): string {
+  if (input.length === 0) return input;
+  return input[0]!.toUpperCase() + input.slice(1).toLowerCase();
+}

text/capitalize_test.ts

@@ -0,0 +1,20 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+
+import { assertEquals } from "@std/assert";
+import { capitalize } from "./capitalize.ts";
+
+Deno.test("capitalize() capitalizes a lowercase string", () => {
+  assertEquals(capitalize("hello"), "Hello");
+});
+
+Deno.test("capitalize() lowercases the rest of the string", () => {
+  assertEquals(capitalize("hELLO"), "Hello");
+});
+
+Deno.test("capitalize() handles empty string", () => {
+  assertEquals(capitalize(""), "");
+});
+
+Deno.test("capitalize() handles single character", () => {
+  assertEquals(capitalize("a"), "A");
+});

text/deno.json

@@ -3,20 +3,27 @@
   "version": "1.0.19",
   "exports": {
     ".": "./mod.ts",
+    "./capitalize": "./capitalize.ts",
     "./closest-string": "./closest_string.ts",
     "./compare-similarity": "./compare_similarity.ts",
-    "./unstable-dedent": "./unstable_dedent.ts",
+    "./escape-html": "./escape_html.ts",
+    "./is-alpha": "./is_alpha.ts",
+    "./is-alphanumeric": "./is_alphanumeric.ts",
+    "./is-numeric": "./is_numeric.ts",
     "./levenshtein-distance": "./levenshtein_distance.ts",
+    "./strip-ansi": "./strip_ansi.ts",
+    "./to-camel-case": "./to_camel_case.ts",
+    "./to-kebab-case": "./to_kebab_case.ts",
+    "./to-pascal-case": "./to_pascal_case.ts",
+    "./to-snake-case": "./to_snake_case.ts",
+    "./unescape-html": "./unescape_html.ts",
+    "./unstable-dedent": "./unstable_dedent.ts",
     "./unstable-longest-common-prefix": "./unstable_longest_common_prefix.ts",
     "./unstable-reverse": "./unstable_reverse.ts",
     "./unstable-slugify": "./unstable_slugify.ts",
     "./unstable-trim-by": "./unstable_trim_by.ts",
-    "./to-camel-case": "./to_camel_case.ts",
     "./unstable-to-constant-case": "./unstable_to_constant_case.ts",
-    "./to-kebab-case": "./to_kebab_case.ts",
-    "./to-pascal-case": "./to_pascal_case.ts",
     "./unstable-to-sentence-case": "./unstable_to_sentence_case.ts",
-    "./to-snake-case": "./to_snake_case.ts",
     "./unstable-to-title-case": "./unstable_to_title_case.ts",
     "./unstable-truncate": "./unstable_truncate.ts",
     "./word-similarity-sort": "./word_similarity_sort.ts"

text/escape_html.ts

@@ -0,0 +1,33 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+// This module is browser compatible.
+
+const HTML_ESCAPE_MAP: Record<string, string> = {
+  "&": "&amp;",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;",
+};
+
+const HTML_ESCAPE_REGEXP = /[&<>"']/g;
+
+/**
+ * Escapes HTML special characters in a string.
+ *
+ * @param input The string to escape
+ * @returns The escaped string
+ *
+ * @example Usage
+ * ```ts
+ * import { escapeHtml } from "@std/text/escape-html";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(escapeHtml("<script>alert('xss')</script>"), "&lt;script&gt;alert(&#39;xss&#39;)&lt;/script&gt;");
+ * ```
+ */
+export function escapeHtml(input: string): string {
+  return input.replace(
+    HTML_ESCAPE_REGEXP,
+    (char) => HTML_ESCAPE_MAP[char]!,
+  );
+}

text/escape_html_test.ts

@@ -0,0 +1,23 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+
+import { assertEquals } from "@std/assert";
+import { escapeHtml } from "./escape_html.ts";
+
+Deno.test("escapeHtml() escapes HTML special characters", () => {
+  assertEquals(
+    escapeHtml("<script>alert('xss')</script>"),
+    "&lt;script&gt;alert(&#39;xss&#39;)&lt;/script&gt;",
+  );
+});
+
+Deno.test("escapeHtml() escapes ampersands first", () => {
+  assertEquals(escapeHtml("a & b"), "a &amp; b");
+});
+
+Deno.test("escapeHtml() handles strings without special chars", () => {
+  assertEquals(escapeHtml("hello"), "hello");
+});
+
+Deno.test("escapeHtml() handles empty string", () => {
+  assertEquals(escapeHtml(""), "");
+});

text/is_alpha.ts

@@ -0,0 +1,21 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+// This module is browser compatible.
+
+/**
+ * Checks if a string contains only alphabetic characters.
+ *
+ * @param input The string to check
+ * @returns `true` if the string contains only alphabetic characters
+ *
+ * @example Usage
+ * ```ts
+ * import { isAlpha } from "@std/text/is-alpha";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(isAlpha("hello"), true);
+ * assertEquals(isAlpha("hello123"), false);
+ * ```
+ */
+export function isAlpha(input: string): boolean {
+  return /^[A-Za-z]+$/.test(input);
+}

text/is_alpha_test.ts

@@ -0,0 +1,22 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+
+import { assertEquals } from "@std/assert";
+import { isAlpha } from "./is_alpha.ts";
+
+Deno.test("isAlpha() returns true for alphabetic strings", () => {
+  assertEquals(isAlpha("hello"), true);
+  assertEquals(isAlpha("HELLO"), true);
+});
+
+Deno.test("isAlpha() returns false for strings with numbers", () => {
+  assertEquals(isAlpha("hello123"), false);
+});
+
+Deno.test("isAlpha() returns false for strings with special characters", () => {
+  assertEquals(isAlpha("hello world"), false);
+  assertEquals(isAlpha("hello!"), false);
+});
+
+Deno.test("isAlpha() returns false for empty string", () => {
+  assertEquals(isAlpha(""), false);
+});

text/is_alphanumeric.ts

@@ -0,0 +1,21 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+// This module is browser compatible.
+
+/**
+ * Checks if a string contains only alphabetic and numeric characters.
+ *
+ * @param input The string to check
+ * @returns `true` if the string contains only alphanumeric characters
+ *
+ * @example Usage
+ * ```ts
+ * import { isAlphanumeric } from "@std/text/is-alphanumeric";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(isAlphanumeric("hello123"), true);
+ * assertEquals(isAlphanumeric("hello 123"), false);
+ * ```
+ */
+export function isAlphanumeric(input: string): boolean {
+  return /^[A-Za-z0-9]+$/.test(input);
+}

text/is_alphanumeric_test.ts

@@ -0,0 +1,19 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+
+import { assertEquals } from "@std/assert";
+import { isAlphanumeric } from "./is_alphanumeric.ts";
+
+Deno.test("isAlphanumeric() returns true for alphanumeric strings", () => {
+  assertEquals(isAlphanumeric("hello123"), true);
+  assertEquals(isAlphanumeric("abc"), true);
+  assertEquals(isAlphanumeric("123"), true);
+});
+
+Deno.test("isAlphanumeric() returns false for strings with special characters", () => {
+  assertEquals(isAlphanumeric("hello 123"), false);
+  assertEquals(isAlphanumeric("hello!"), false);
+});
+
+Deno.test("isAlphanumeric() returns false for empty string", () => {
+  assertEquals(isAlphanumeric(""), false);
+});

text/is_numeric.ts

@@ -0,0 +1,21 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+// This module is browser compatible.
+
+/**
+ * Checks if a string contains only numeric characters.
+ *
+ * @param input The string to check
+ * @returns `true` if the string contains only numeric characters
+ *
+ * @example Usage
+ * ```ts
+ * import { isNumeric } from "@std/text/is-numeric";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(isNumeric("123"), true);
+ * assertEquals(isNumeric("123abc"), false);
+ * ```
+ */
+export function isNumeric(input: string): boolean {
+  return /^[0-9]+$/.test(input);
+}