Add comprehensive Text utility methods

- Add camelToSnake() and snakeToCamel() conversion methods
- Add colorize() method for Minecraft color codes (& to §)
- Add slugify() method for URL-friendly text
- Add camelToKebab() and kebabToCamel() conversion methods
- Add titleCase() and capitalize() methods
- Add reverse(), contains(), startsWith(), endsWith() methods
- Add substring() method for text extraction

Author: ImperaZim

src/imperazim/components/utils/Text.php

@@ -95,4 +95,134 @@ public static function truncate(string $text, int $maxLength = 100): string {
   public static function removeSpecialChars(string $text): string {
     return preg_replace('/[^a-zA-Z0-9\s]/', '', $text);
   }
+
+  /**
+  * Convert camelCase to snake_case.
+  * @param string $text The input text in camelCase.
+  * @return string The converted text in snake_case.
+  */
+  public static function camelToSnake(string $text): string {
+    return strtolower(preg_replace('/(?<!^)[A-Z]/', '_$0', $text));
+  }
+
+  /**
+  * Convert snake_case to camelCase.
+  * @param string $text The input text in snake_case.
+  * @return string The converted text in camelCase.
+  */
+  public static function snakeToCamel(string $text): string {
+    return lcfirst(str_replace(' ', '', ucwords(str_replace('_', ' ', $text))));
+  }
+
+  /**
+  * Convert color codes from & to § (Minecraft format).
+  * @param string $text The input text with & color codes.
+  * @return string The text with § color codes.
+  */
+  public static function colorize(string $text): string {
+    return str_replace('&', '§', $text);
+  }
+
+  /**
+  * Convert text to slug format (URL-friendly).
+  * @param string $text The input text.
+  * @param string $separator The separator to use (default: '-').
+  * @return string The slugified text.
+  */
+  public static function slugify(string $text, string $separator = '-'): string {
+    $text = self::removeSpecialChars($text);
+    $text = self::removeExtraSpaces($text);
+    $text = strtolower(str_replace(' ', $separator, $text));
+    return preg_replace('/' . preg_quote($separator, '/') . '+/', $separator, $text);
+  }
+
+  /**
+  * Convert camelCase to kebab-case.
+  * @param string $text The input text in camelCase.
+  * @return string The converted text in kebab-case.
+  */
+  public static function camelToKebab(string $text): string {
+    return str_replace('_', '-', self::camelToSnake($text));
+  }
+
+  /**
+  * Convert kebab-case to camelCase.
+  * @param string $text The input text in kebab-case.
+  * @return string The converted text in camelCase.
+  */
+  public static function kebabToCamel(string $text): string {
+    return self::snakeToCamel(str_replace('-', '_', $text));
+  }
+
+  /**
+  * Capitalize the first letter of each word.
+  * @param string $text The input text.
+  * @return string The title case text.
+  */
+  public static function titleCase(string $text): string {
+    return ucwords(strtolower($text));
+  }
+
+  /**
+  * Capitalize only the first letter of the text.
+  * @param string $text The input text.
+  * @return string The capitalized text.
+  */
+  public static function capitalize(string $text): string {
+    return ucfirst(strtolower($text));
+  }
+
+  /**
+  * Reverse the text.
+  * @param string $text The input text.
+  * @return string The reversed text.
+  */
+  public static function reverse(string $text): string {
+    return strrev($text);
+  }
+
+  /**
+  * Check if text contains a substring (case-insensitive).
+  * @param string $text The input text.
+  * @param string $substring The substring to search for.
+  * @return bool True if the substring is found.
+  */
+  public static function contains(string $text, string $substring): bool {
+    return stripos($text, $substring) !== false;
+  }
+
+  /**
+  * Check if text starts with a substring (case-insensitive).
+  * @param string $text The input text.
+  * @param string $substring The substring to check.
+  * @return bool True if the text starts with the substring.
+  */
+  public static function startsWith(string $text, string $substring): bool {
+    return stripos($text, $substring) === 0;
+  }
+
+  /**
+  * Check if text ends with a substring (case-insensitive).
+  * @param string $text The input text.
+  * @param string $substring The substring to check.
+  * @return bool True if the text ends with the substring.
+  */
+  public static function endsWith(string $text, string $substring): bool {
+    $length = strlen($substring);
+    if ($length === 0) {
+      return true;
+    }
+    return stripos($text, $substring, - $length) !== false;
+  }
+
+  /**
+  * Extract a substring from the text.
+  * @param string $text The input text.
+  * @param int $start The starting position.
+  * @param int|null $length The length of the substring (null for rest of string).
+  * @return string The extracted substring.
+  */
+  public static function substring(string $text, int $start, ?int $length = null): string {
+    return $length === null ? substr($text, $start) : substr($text, $start, $length);
+  }
 }