@gesslar/toolkit 0.2.3 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gesslar/toolkit",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Get in, bitches, we're going toolkitting.",
   "main": "./src/index.js",
   "type": "module",

package/src/lib/Util.js

@@ -298,4 +298,14 @@ export default class Util {
 
     return closestMatch
   }
+
+  static regexify(input, trim=true, flags=[]) {
+    return new RegExp(
+      input
+        .split("\n")
+        .map(i => trim ? i.trim() : i)
+        .filter(i => trim ? Boolean(i) : true)
+        .join("")
+      , flags?.join(""))
+  }
 }

package/src/types/Util.d.ts

@@ -215,6 +215,38 @@ declare class Util {
    * ```
    */
   static findClosestMatch(input: string, allowedValues: string[], threshold?: number): string | null
+
+  /**
+   * Creates a RegExp from a multiline string by removing line breaks and
+   * optionally trimming whitespace from each line.
+   *
+   * This utility makes complex regular expressions more readable by allowing
+   * them to be written across multiple lines with proper formatting and indentation.
+   * The resulting regex is functionally identical to writing it as a single line.
+   *
+   * @param input - Multiline string containing the regex pattern
+   * @param trim - Whether to trim whitespace from each line (default: true)
+   * @param flags - Array of regex flags to apply (default: [])
+   * @returns A new RegExp object with the processed pattern
+   *
+   * @example
+   * ```typescript
+   * const regex = Util.regexify(`
+   *   \\s*\\*\\s*
+   *   @(?<tag>\\w+)
+   *   \\s*
+   *   \\{(?<type>\\w+(?:\\|\\w+)*(?:\\*)?)\\}
+   *   \\s+
+   *   (?<name>\\w+)
+   * `)
+   * // Creates: /\s*\*\s*@(?<tag>\w+)\s*\{(?<type>\w+(?:\|\w+)*(?:\*)?)\}\s+(?<name>\w+)/
+   *
+   * // With flags:
+   * const globalRegex = Util.regexify(pattern, true, ['g', 'i'])
+   * // Creates regex with global and case-insensitive flags
+   * ```
+   */
+  static regexify(input: string, trim?: boolean, flags?: string[]): RegExp
 }
 
 export default Util