Phase 2 add utilities (#2)

Author: Zheruel

src/camelCase.ts

@@ -0,0 +1,14 @@
+/**
+ * Converts a string to camelCase
+ * @param str - The input string to convert
+ * @returns A camelCase string
+ * @example
+ * camelCase('hello world') // 'helloWorld'
+ * camelCase('hello-world') // 'helloWorld'
+ * camelCase('hello_world') // 'helloWorld'
+ */
+export const camelCase = (str: string): string => {
+  return str
+    .replace(/[^a-zA-Z0-9]+(.)/g, (_, chr) => chr.toUpperCase())
+    .replace(/^[A-Z]/, (chr) => chr.toLowerCase());
+};

src/capitalize.ts

@@ -0,0 +1,12 @@
+/**
+ * Capitalizes the first letter of a string
+ * @param str - The input string to capitalize
+ * @returns A string with the first letter capitalized
+ * @example
+ * capitalize('hello world') // 'Hello world'
+ * capitalize('HELLO') // 'HELLO'
+ */
+export const capitalize = (str: string): string => {
+  if (!str) return str;
+  return str.charAt(0).toUpperCase() + str.slice(1);
+};

src/escapeHtml.ts

@@ -0,0 +1,19 @@
+/**
+ * Escapes HTML special characters in a string
+ * @param str - The input string to escape
+ * @returns A string with HTML entities escaped
+ * @example
+ * escapeHtml('<div>Hello & "World"</div>') // '&lt;div&gt;Hello &amp; &quot;World&quot;&lt;/div&gt;'
+ * escapeHtml("It's <script>") // 'It&#39;s &lt;script&gt;'
+ */
+export const escapeHtml = (str: string): string => {
+  const htmlEntities: Record<string, string> = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;'
+  };
+  
+  return str.replace(/[&<>"']/g, (match) => htmlEntities[match] ?? match);
+};

src/hashString.ts

@@ -0,0 +1,21 @@
+/**
+ * Generates a simple hash from a string (non-cryptographic)
+ * @param str - The input string to hash
+ * @returns A numeric hash value
+ * @example
+ * hashString('hello') // 99162322
+ * hashString('world') // 113318802
+ */
+export const hashString = (str: string): number => {
+  let hash = 0;
+  
+  if (str.length === 0) return hash;
+  
+  for (let i = 0; i < str.length; i++) {
+    const char = str.charCodeAt(i);
+    hash = ((hash << 5) - hash) + char;
+    hash = hash & hash; // Convert to 32-bit integer
+  }
+  
+  return Math.abs(hash);
+};

src/index.ts

@@ -0,0 +1,15 @@
+export { slugify } from './slugify.js';
+export { truncate } from './truncate.js';
+export { capitalize } from './capitalize.js';
+export { camelCase } from './camelCase.js';
+export { snakeCase } from './snakeCase.js';
+export { kebabCase } from './kebabCase.js';
+export { stripHtml } from './stripHtml.js';
+export { escapeHtml } from './escapeHtml.js';
+export { randomString } from './randomString.js';
+export { hashString } from './hashString.js';
+export { pascalCase } from './pascalCase.js';
+export { reverse } from './reverse.js';
+export { isEmail } from './isEmail.js';
+export { isUrl } from './isUrl.js';
+export { wordCount } from './wordCount.js';

src/isEmail.ts

@@ -0,0 +1,13 @@
+/**
+ * Validates if a string is a valid email format
+ * @param str - The input string to validate
+ * @returns True if the string is a valid email format, false otherwise
+ * @example
+ * isEmail('[email protected]') // true
+ * isEmail('invalid.email') // false
+ * isEmail('[email protected]') // true
+ */
+export const isEmail = (str: string): boolean => {
+  const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+  return emailRegex.test(str);
+};

src/isUrl.ts

@@ -0,0 +1,17 @@
+/**
+ * Validates if a string is a valid URL format
+ * @param str - The input string to validate
+ * @returns True if the string is a valid URL format, false otherwise
+ * @example
+ * isUrl('https://example.com') // true
+ * isUrl('http://localhost:3000') // true
+ * isUrl('not a url') // false
+ */
+export const isUrl = (str: string): boolean => {
+  try {
+    new URL(str);
+    return true;
+  } catch {
+    return false;
+  }
+};

src/kebabCase.ts

@@ -0,0 +1,17 @@
+/**
+ * Converts a string to kebab-case
+ * @param str - The input string to convert
+ * @returns A kebab-case string
+ * @example
+ * kebabCase('Hello World') // 'hello-world'
+ * kebabCase('helloWorld') // 'hello-world'
+ * kebabCase('hello_world') // 'hello-world'
+ */
+export const kebabCase = (str: string): string => {
+  return str
+    .replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)
+    .replace(/[^a-z0-9]+/gi, '-')
+    .replace(/^-+|-+$/g, '')
+    .replace(/-+/g, '-')
+    .toLowerCase();
+};

src/pascalCase.ts

@@ -0,0 +1,14 @@
+/**
+ * Converts a string to PascalCase
+ * @param str - The input string to convert
+ * @returns A PascalCase string
+ * @example
+ * pascalCase('hello world') // 'HelloWorld'
+ * pascalCase('hello-world') // 'HelloWorld'
+ * pascalCase('hello_world') // 'HelloWorld'
+ */
+export const pascalCase = (str: string): string => {
+  return str
+    .replace(/[^a-zA-Z0-9]+(.)/g, (_, chr) => chr.toUpperCase())
+    .replace(/^[a-z]/, (chr) => chr.toUpperCase());
+};

src/randomString.ts

@@ -0,0 +1,22 @@
+/**
+ * Generates a random alphanumeric string
+ * @param length - The length of the random string
+ * @param charset - Optional character set to use (default: alphanumeric)
+ * @returns A random string of specified length
+ * @example
+ * randomString(10) // 'a3B9x2Kp1m'
+ * randomString(5, 'abc123') // '3a1bc'
+ */
+export const randomString = (
+  length: number, 
+  charset: string = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'
+): string => {
+  let result = '';
+  const charsetLength = charset.length;
+  
+  for (let i = 0; i < length; i++) {
+    result += charset.charAt(Math.floor(Math.random() * charsetLength));
+  }
+  
+  return result;
+};