@jdsalasc/solvejs-regex 1.0.1 → 1.0.2

package/dist/cjs/index.cjs

@@ -11,16 +11,41 @@ exports.REGEX_PATTERNS = {
     hexColor: /^#(?:[0-9a-fA-F]{3}){1,2}$/,
     username: /^[a-zA-Z0-9_]{3,30}$/
 };
+/**
+ * Tests a string against a regular expression safely.
+ *
+ * @param input - Input text.
+ * @param pattern - Regular expression pattern.
+ * @returns `true` when the pattern matches the input.
+ * @throws {TypeError} If `pattern` is not a RegExp instance.
+ */
 function testPattern(input, pattern) {
     if (!(pattern instanceof RegExp)) {
         throw new TypeError("Expected pattern to be a RegExp instance.");
     }
+    pattern.lastIndex = 0;
     return pattern.test(input);
 }
+/**
+ * Validates text using a custom regex pattern.
+ *
+ * @param input - Input text.
+ * @param pattern - Regular expression pattern.
+ * @param options - Validation options.
+ * @returns `true` when the pattern matches.
+ * @throws {TypeError} If `pattern` is not a RegExp instance.
+ */
 function validateWithPattern(input, pattern, options) {
     const normalized = options?.trim ? input.trim() : input;
     return testPattern(normalized, pattern);
 }
+/**
+ * Validates text using one of the built-in common patterns.
+ *
+ * @param input - Input text.
+ * @param patternName - Built-in pattern name.
+ * @returns `true` when the selected pattern matches.
+ */
 function validateByName(input, patternName) {
     return testPattern(input, exports.REGEX_PATTERNS[patternName]);
 }

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAUA,kCAKC;AAED,kDAGC;AAED,wCAEC;AAxBY,QAAA,cAAc,GAAG;IAC5B,KAAK,EAAE,4BAA4B;IACnC,SAAS,EAAE,mBAAmB;IAC9B,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,4BAA4B;IACtC,QAAQ,EAAE,sBAAsB;CACxB,CAAC;AAIX,SAAgB,WAAW,CAAC,KAAa,EAAE,OAAe;IACxD,IAAI,CAAC,CAAC,OAAO,YAAY,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,SAAgB,mBAAmB,CAAC,KAAa,EAAE,OAAe,EAAE,OAA4B;IAC9F,MAAM,UAAU,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACxD,OAAO,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,SAAgB,cAAc,CAAC,KAAa,EAAE,WAAwB;IACpE,OAAO,WAAW,CAAC,KAAK,EAAE,sBAAc,CAAC,WAAW,CAAC,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAkBA,kCAMC;AAWD,kDAGC;AASD,wCAEC;AAjDY,QAAA,cAAc,GAAG;IAC5B,KAAK,EAAE,4BAA4B;IACnC,SAAS,EAAE,mBAAmB;IAC9B,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,4BAA4B;IACtC,QAAQ,EAAE,sBAAsB;CACxB,CAAC;AAIX;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAC,KAAa,EAAE,OAAe;IACxD,IAAI,CAAC,CAAC,OAAO,YAAY,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;IACtB,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,KAAa,EAAE,OAAe,EAAE,OAA4B;IAC9F,MAAM,UAAU,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACxD,OAAO,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,KAAa,EAAE,WAAwB;IACpE,OAAO,WAAW,CAAC,KAAK,EAAE,sBAAc,CAAC,WAAW,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/esm/index.d.ts

@@ -6,8 +6,32 @@ export declare const REGEX_PATTERNS: {
     readonly username: RegExp;
 };
 export type PatternName = keyof typeof REGEX_PATTERNS;
+/**
+ * Tests a string against a regular expression safely.
+ *
+ * @param input - Input text.
+ * @param pattern - Regular expression pattern.
+ * @returns `true` when the pattern matches the input.
+ * @throws {TypeError} If `pattern` is not a RegExp instance.
+ */
 export declare function testPattern(input: string, pattern: RegExp): boolean;
+/**
+ * Validates text using a custom regex pattern.
+ *
+ * @param input - Input text.
+ * @param pattern - Regular expression pattern.
+ * @param options - Validation options.
+ * @returns `true` when the pattern matches.
+ * @throws {TypeError} If `pattern` is not a RegExp instance.
+ */
 export declare function validateWithPattern(input: string, pattern: RegExp, options?: {
     trim?: boolean;
 }): boolean;
+/**
+ * Validates text using one of the built-in common patterns.
+ *
+ * @param input - Input text.
+ * @param patternName - Built-in pattern name.
+ * @returns `true` when the selected pattern matches.
+ */
 export declare function validateByName(input: string, patternName: PatternName): boolean;

package/dist/esm/index.js

@@ -5,16 +5,41 @@ export const REGEX_PATTERNS = {
     hexColor: /^#(?:[0-9a-fA-F]{3}){1,2}$/,
     username: /^[a-zA-Z0-9_]{3,30}$/
 };
+/**
+ * Tests a string against a regular expression safely.
+ *
+ * @param input - Input text.
+ * @param pattern - Regular expression pattern.
+ * @returns `true` when the pattern matches the input.
+ * @throws {TypeError} If `pattern` is not a RegExp instance.
+ */
 export function testPattern(input, pattern) {
     if (!(pattern instanceof RegExp)) {
         throw new TypeError("Expected pattern to be a RegExp instance.");
     }
+    pattern.lastIndex = 0;
     return pattern.test(input);
 }
+/**
+ * Validates text using a custom regex pattern.
+ *
+ * @param input - Input text.
+ * @param pattern - Regular expression pattern.
+ * @param options - Validation options.
+ * @returns `true` when the pattern matches.
+ * @throws {TypeError} If `pattern` is not a RegExp instance.
+ */
 export function validateWithPattern(input, pattern, options) {
     const normalized = options?.trim ? input.trim() : input;
     return testPattern(normalized, pattern);
 }
+/**
+ * Validates text using one of the built-in common patterns.
+ *
+ * @param input - Input text.
+ * @param patternName - Built-in pattern name.
+ * @returns `true` when the selected pattern matches.
+ */
 export function validateByName(input, patternName) {
     return testPattern(input, REGEX_PATTERNS[patternName]);
 }

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,4BAA4B;IACnC,SAAS,EAAE,mBAAmB;IAC9B,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,4BAA4B;IACtC,QAAQ,EAAE,sBAAsB;CACxB,CAAC;AAIX,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,OAAe;IACxD,IAAI,CAAC,CAAC,OAAO,YAAY,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,OAAe,EAAE,OAA4B;IAC9F,MAAM,UAAU,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACxD,OAAO,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,WAAwB;IACpE,OAAO,WAAW,CAAC,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,4BAA4B;IACnC,SAAS,EAAE,mBAAmB;IAC9B,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,4BAA4B;IACtC,QAAQ,EAAE,sBAAsB;CACxB,CAAC;AAIX;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,OAAe;IACxD,IAAI,CAAC,CAAC,OAAO,YAAY,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;IACtB,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,OAAe,EAAE,OAA4B;IAC9F,MAAM,UAAU,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACxD,OAAO,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,WAAwB;IACpE,OAAO,WAAW,CAAC,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jdsalasc/solvejs-regex",
-  "version": "1.0.1",
-  "description": "Regex patterns and validation helpers.",
+  "version": "1.0.2",
+  "description": "Common regex patterns and validators for email, username, URL, hex color, and phone-like strings.",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -43,10 +43,10 @@
     "node": ">=18"
   },
   "keywords": [
-    "regex",
-    "regex validation",
-    "email validation",
-    "url validation",
+    "regex utilities",
+    "email regex",
+    "validation",
+    "typescript regex",
     "solvejs"
   ]
 }