string-extn 1.0.0

package/dist/unicode.js

@@ -0,0 +1,63 @@
+import GraphemeSplitter from 'grapheme-splitter';
+const splitter = new GraphemeSplitter();
+/**
+ * Counts the number of grapheme clusters (user-perceived characters) in a Unicode string.
+ *
+ * This function properly handles complex Unicode characters including:
+ * - Emoji with skin tone modifiers (e.g., 👍🏽)
+ * - Multi-codepoint emoji sequences (e.g., family emoji 👨‍👩‍👧‍👦)
+ * - Flag emoji (e.g., 🇺🇸)
+ * - Accented characters and combining marks
+ *
+ * @param str - The Unicode string to count.
+ * @returns The number of grapheme clusters in the string.
+ *
+ * @example
+ * lengthUnicode('hello') // => 5
+ * lengthUnicode('👍🏽👍') // => 2 (skin tone modifier counted as part of first emoji)
+ * lengthUnicode('👨‍👩‍👧‍👦') // => 1 (complex emoji sequence counted as single grapheme)
+ */
+export function lengthUnicode(str) {
+    return splitter.countGraphemes(str);
+}
+/**
+ * Extracts a section of a Unicode string by grapheme cluster indices.
+ *
+ * This function correctly slices strings containing complex Unicode characters where
+ * multiple codepoints form a single user-perceived character. Use this instead of
+ * {@link slice} for proper Unicode-aware slicing.
+ *
+ * @param str - The Unicode string to slice.
+ * @param start - The starting grapheme cluster index (inclusive). Negative indices count from the end.
+ * @param end - The ending grapheme cluster index (exclusive). Negative indices count from the end. Optional.
+ * @returns A new string containing the extracted grapheme clusters.
+ *
+ * @example
+ * unicodeSlice('hello', 1, 4) // => 'ell'
+ * unicodeSlice('👍🏽👍😀', 0, 2) // => '👍🏽👍' (correctly handles skin tone modifier)
+ * unicodeSlice('😀😁😂', 1) // => '😁😂'
+ */
+export function unicodeSlice(str, start, end) {
+    const chars = splitter.splitGraphemes(str);
+    return chars.slice(start, end).join('');
+}
+/**
+ * Reverses the order of grapheme clusters in a Unicode string.
+ *
+ * This function properly reverses strings containing complex Unicode characters where
+ * multiple codepoints form a single user-perceived character. It maintains the integrity
+ * of multi-codepoint emoji and other complex grapheme clusters. Use this instead of
+ * {@link reverse} for Unicode-aware reversal.
+ *
+ * @param str - The Unicode string to reverse.
+ * @returns A new string with grapheme clusters in reverse order.
+ *
+ * @example
+ * reverseUnicode('hello') // => 'olleh'
+ * reverseUnicode('👍🏽👍') // => '👍👍🏽' (preserves emoji integrity)
+ * reverseUnicode('👨‍👩‍👧‍👦😀') // => '😀👨‍👩‍👧‍👦' (maintains complex emoji as single unit)
+ */
+export function reverseUnicode(str) {
+    return splitter.splitGraphemes(str).reverse().join('');
+}
+//# sourceMappingURL=unicode.js.map

package/dist/unicode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unicode.js","sourceRoot":"","sources":["../src/unicode.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,mBAAmB,CAAC;AAEjD,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;AAExC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,KAAa,EAAE,GAAY;IACnE,MAAM,KAAK,GAAG,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,264 @@
+/**
+ * Validates if a string is a valid email address format.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a valid email format, false otherwise
+ *
+ * @example
+ * isEmail("user@example.com") // returns true
+ * isEmail("invalid.email") // returns false
+ * isEmail("user@domain") // returns false
+ */
+export declare function isEmail(input: string): boolean;
+/**
+ * Validates if a string is a valid UUID (Universally Unique Identifier).
+ *
+ * @param input - The string to validate
+ * @returns true if the string matches UUID format (v1-v5), false otherwise
+ *
+ * @example
+ * isUUID("550e8400-e29b-41d4-a716-446655440000") // returns true
+ * isUUID("invalid-uuid") // returns false
+ *
+ * @note Supports UUID versions 1 through 5 with RFC 4122 compliance
+ */
+export declare function isUUID(input: string): boolean;
+/**
+ * Validates if a string can be converted to a valid number.
+ *
+ * @param input - The string to validate
+ * @returns true if the string represents a valid number, false otherwise
+ *
+ * @example
+ * isNumeric("123") // returns true
+ * isNumeric("3.14") // returns true
+ * isNumeric("-42") // returns true
+ * isNumeric("abc") // returns false
+ */
+export declare function isNumeric(input: string): boolean;
+/**
+ * Validates if a string is a valid URL using the URL constructor.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a valid URL, false otherwise
+ *
+ * @example
+ * isURL("https://example.com") // returns true
+ * isURL("https://example.com/path?query=value") // returns true
+ * isURL("not a url") // returns false
+ *
+ * @note Uses native URL API for validation, supporting absolute and relative URLs
+ */
+export declare function isURL(input: string): boolean;
+/**
+ * Validates if a string is a valid hexadecimal color code.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a valid 3-digit or 6-digit hex color, false otherwise
+ *
+ * @example
+ * isHexColor("#fff") // returns true
+ * isHexColor("#ffffff") // returns true
+ * isHexColor("fff") // returns true (# is optional)
+ * isHexColor("#gggggg") // returns false
+ */
+export declare function isHexColor(input: string): boolean;
+/**
+ * Validates if a string is a valid phone number in E.164 format.
+ *
+ * @param input - The string to validate
+ * @returns true if the string matches E.164 phone number format, false otherwise
+ *
+ * @example
+ * isPhoneNumber("+14155552671") // returns true
+ * isPhoneNumber("14155552671") // returns true (+ is optional)
+ * isPhoneNumber("415 555 2671") // returns false (spaces not allowed)
+ *
+ * @note Follows E.164 format: optional + followed by 1-15 digits, first digit must be 1-9
+ */
+export declare function isPhoneNumber(input: string): boolean;
+/**
+ * Validates if a string can be parsed as a valid date.
+ *
+ * @param input - The string to validate
+ * @returns true if the string represents a valid date, false otherwise
+ *
+ * @example
+ * isDate("2024-01-27") // returns true
+ * isDate("January 27, 2024") // returns true
+ * isDate("2024-13-45") // returns false (invalid date)
+ *
+ * @note Uses the native Date.parse() method for validation
+ */
+export declare function isDate(input: string): boolean;
+/**
+ * Validates if a string is a strong password meeting security requirements.
+ *
+ * @param input - The string to validate
+ * @returns true if the password is strong, false otherwise
+ *
+ * @example
+ * isStrongPassword("MyPassword123!") // returns true
+ * isStrongPassword("weak") // returns false
+ * isStrongPassword("NoSpecialChar123") // returns false
+ *
+ * @note Requires: minimum 8 characters, at least one lowercase letter, one uppercase letter,
+ *       one digit, and one special character (@$!%*?&)
+ */
+export declare function isStrongPassword(input: string): boolean;
+/**
+ * Validates if a string is valid JSON.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is valid JSON, false otherwise
+ *
+ * @example
+ * isJSON('{\"key\": \"value\"}') // returns true
+ * isJSON('[1, 2, 3]') // returns true
+ * isJSON('invalid json') // returns false
+ *
+ * @note Uses native JSON.parse() for validation
+ */
+export declare function isJSON(input: string): boolean;
+/**
+ * Validates if a string is valid Base64 encoded data.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is valid Base64 format, false otherwise
+ *
+ * @example
+ * isBase64("SGVsbG8gV29ybGQ=") // returns true
+ * isBase64("SGVsbG8gV29ybGQ") // returns true
+ * isBase64("!!!Invalid!!!") // returns false
+ */
+export declare function isBase64(input: string): boolean;
+/**
+ * Validates if a string contains only alphabetic characters (no numbers or special characters).
+ *
+ * @param input - The string to validate
+ * @returns true if the string contains only letters, false otherwise
+ *
+ * @example
+ * isAlphabetic("HelloWorld") // returns true
+ * isAlphabetic("Hello World") // returns false (contains space)
+ * isAlphabetic("Hello123") // returns false (contains numbers)
+ */
+export declare function isAlphabetic(input: string): boolean;
+/**
+ * Validates if a string contains only alphanumeric characters (letters and digits).
+ *
+ * @param input - The string to validate
+ * @returns true if the string contains only letters and numbers, false otherwise
+ *
+ * @example
+ * isAlphanumeric("Hello123") // returns true
+ * isAlphanumeric("Hello-123") // returns false (contains hyphen)
+ * isAlphanumeric("Hello 123") // returns false (contains space)
+ */
+export declare function isAlphanumeric(input: string): boolean;
+/**
+ * Validates if a string contains only lowercase alphabetic characters.
+ *
+ * @param input - The string to validate
+ * @returns true if the string contains only lowercase letters, false otherwise
+ *
+ * @example
+ * isLowerCase("hello") // returns true
+ * isLowerCase("Hello") // returns false (contains uppercase)
+ * isLowerCase("hello123") // returns false (contains numbers)
+ */
+export declare function isLowerCase(input: string): boolean;
+/**
+ * Validates if a string contains only uppercase alphabetic characters.
+ *
+ * @param input - The string to validate
+ * @returns true if the string contains only uppercase letters, false otherwise
+ *
+ * @example
+ * isUpperCase("HELLO") // returns true
+ * isUpperCase("Hello") // returns false (contains lowercase)
+ * isUpperCase("HELLO123") // returns false (contains numbers)
+ */
+export declare function isUpperCase(input: string): boolean;
+/**
+ * Validates if a string contains only whitespace characters (spaces, tabs, newlines, etc.).
+ *
+ * @param input - The string to validate
+ * @returns true if the string contains only whitespace, false otherwise
+ *
+ * @example
+ * isWhitespace("   ") // returns true
+ * isWhitespace("\t\n") // returns true
+ * isWhitespace(" a ") // returns false (contains non-whitespace)
+ */
+export declare function isWhitespace(input: string): boolean;
+/**
+ * Validates if a string is a palindrome (reads the same forwards and backwards).
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a palindrome, false otherwise
+ *
+ * @example
+ * isPalindrome("racecar") // returns true
+ * isPalindrome("A man, a plan, a canal: Panama") // returns true (ignores punctuation and case)
+ * isPalindrome("hello") // returns false
+ *
+ * @note Case-insensitive and ignores non-alphanumeric characters
+ */
+export declare function isPalindrome(input: string): boolean;
+/**
+ * Validates if a string contains only hexadecimal characters (0-9, A-F).
+ *
+ * @param input - The string to validate
+ * @returns true if the string is valid hexadecimal, false otherwise
+ *
+ * @example
+ * isHexadecimal("1A2B3C") // returns true
+ * isHexadecimal("DEADBEEF") // returns true
+ * isHexadecimal("12XYZ") // returns false (contains invalid characters)
+ */
+export declare function isHexadecimal(input: string): boolean;
+/**
+ * Validates if a string is a valid Roman numeral.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a valid Roman numeral, false otherwise
+ *
+ * @example
+ * isRomanNumeral("XIV") // returns true
+ * isRomanNumeral("MCMXCIV") // returns true
+ * isRomanNumeral("IIII") // returns false (should be IV)
+ *
+ * @note Validates standard Roman numeral notation (I, V, X, L, C, D, M)
+ */
+export declare function isRomanNumeral(input: string): boolean;
+/**
+ * Validates if a string is a valid IPv4 address.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a valid IPv4 address, false otherwise
+ *
+ * @example
+ * isIPv4("192.168.1.1") // returns true
+ * isIPv4("255.255.255.255") // returns true
+ * isIPv4("256.1.1.1") // returns false (256 exceeds maximum)
+ *
+ * @note Validates standard IPv4 dotted-decimal notation (0.0.0.0 to 255.255.255.255)
+ */
+export declare function isIPv4(input: string): boolean;
+/**
+ * Validates if a string is a valid IPv6 address.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a valid IPv6 address, false otherwise
+ *
+ * @example
+ * isIPv6("2001:0db8:85a3:0000:0000:8a2e:0370:7334") // returns true
+ * isIPv6("::1") // returns true (loopback)
+ * isIPv6("::ffff:192.168.1.1") // returns true (IPv4-mapped)
+ * isIPv6("invalid") // returns false
+ *
+ * @note Supports full notation, compressed notation, and IPv4-mapped IPv6 addresses
+ */
+export declare function isIPv6(input: string): boolean;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAI7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEhD;AACD;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD;AACD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpD;AACD;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7C;AACD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIvD;AACD;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO7C;AACD;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO/C;AACD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AACD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErD;AACD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AACD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AACD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AACD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnD;AACD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AACD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIrD;AACD;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7C;AACD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7C"}

package/dist/validate.js

@@ -0,0 +1,326 @@
+import { isIP } from 'net';
+/**
+ * Validates if a string is a valid email address format.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a valid email format, false otherwise
+ *
+ * @example
+ * isEmail("user@example.com") // returns true
+ * isEmail("invalid.email") // returns false
+ * isEmail("user@domain") // returns false
+ */
+export function isEmail(input) {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(input);
+}
+/**
+ * Validates if a string is a valid UUID (Universally Unique Identifier).
+ *
+ * @param input - The string to validate
+ * @returns true if the string matches UUID format (v1-v5), false otherwise
+ *
+ * @example
+ * isUUID("550e8400-e29b-41d4-a716-446655440000") // returns true
+ * isUUID("invalid-uuid") // returns false
+ *
+ * @note Supports UUID versions 1 through 5 with RFC 4122 compliance
+ */
+export function isUUID(input) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(input);
+}
+/**
+ * Validates if a string can be converted to a valid number.
+ *
+ * @param input - The string to validate
+ * @returns true if the string represents a valid number, false otherwise
+ *
+ * @example
+ * isNumeric("123") // returns true
+ * isNumeric("3.14") // returns true
+ * isNumeric("-42") // returns true
+ * isNumeric("abc") // returns false
+ */
+export function isNumeric(input) {
+    return !isNaN(Number(input));
+}
+/**
+ * Validates if a string is a valid URL using the URL constructor.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a valid URL, false otherwise
+ *
+ * @example
+ * isURL("https://example.com") // returns true
+ * isURL("https://example.com/path?query=value") // returns true
+ * isURL("not a url") // returns false
+ *
+ * @note Uses native URL API for validation, supporting absolute and relative URLs
+ */
+export function isURL(input) {
+    try {
+        new URL(input);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validates if a string is a valid hexadecimal color code.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a valid 3-digit or 6-digit hex color, false otherwise
+ *
+ * @example
+ * isHexColor("#fff") // returns true
+ * isHexColor("#ffffff") // returns true
+ * isHexColor("fff") // returns true (# is optional)
+ * isHexColor("#gggggg") // returns false
+ */
+export function isHexColor(input) {
+    return /^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/.test(input);
+}
+/**
+ * Validates if a string is a valid phone number in E.164 format.
+ *
+ * @param input - The string to validate
+ * @returns true if the string matches E.164 phone number format, false otherwise
+ *
+ * @example
+ * isPhoneNumber("+14155552671") // returns true
+ * isPhoneNumber("14155552671") // returns true (+ is optional)
+ * isPhoneNumber("415 555 2671") // returns false (spaces not allowed)
+ *
+ * @note Follows E.164 format: optional + followed by 1-15 digits, first digit must be 1-9
+ */
+export function isPhoneNumber(input) {
+    // Require at least 4 digits (total) to avoid overly short numeric strings
+    return /^\+?[1-9]\d{3,14}$/.test(input);
+}
+/**
+ * Validates if a string can be parsed as a valid date.
+ *
+ * @param input - The string to validate
+ * @returns true if the string represents a valid date, false otherwise
+ *
+ * @example
+ * isDate("2024-01-27") // returns true
+ * isDate("January 27, 2024") // returns true
+ * isDate("2024-13-45") // returns false (invalid date)
+ *
+ * @note Uses the native Date.parse() method for validation
+ */
+export function isDate(input) {
+    return !isNaN(Date.parse(input));
+}
+/**
+ * Validates if a string is a strong password meeting security requirements.
+ *
+ * @param input - The string to validate
+ * @returns true if the password is strong, false otherwise
+ *
+ * @example
+ * isStrongPassword("MyPassword123!") // returns true
+ * isStrongPassword("weak") // returns false
+ * isStrongPassword("NoSpecialChar123") // returns false
+ *
+ * @note Requires: minimum 8 characters, at least one lowercase letter, one uppercase letter,
+ *       one digit, and one special character (@$!%*?&)
+ */
+export function isStrongPassword(input) {
+    return /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]{8,}$/.test(input);
+}
+/**
+ * Validates if a string is valid JSON.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is valid JSON, false otherwise
+ *
+ * @example
+ * isJSON('{\"key\": \"value\"}') // returns true
+ * isJSON('[1, 2, 3]') // returns true
+ * isJSON('invalid json') // returns false
+ *
+ * @note Uses native JSON.parse() for validation
+ */
+export function isJSON(input) {
+    try {
+        JSON.parse(input);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validates if a string is valid Base64 encoded data.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is valid Base64 format, false otherwise
+ *
+ * @example
+ * isBase64("SGVsbG8gV29ybGQ=") // returns true
+ * isBase64("SGVsbG8gV29ybGQ") // returns true
+ * isBase64("!!!Invalid!!!") // returns false
+ */
+export function isBase64(input) {
+    // Empty string considered valid by tests
+    if (input === "")
+        return true;
+    // Accept Base64 with or without padding; disallow invalid characters
+    if (!/^[A-Za-z0-9+/]+=*$/.test(input))
+        return false;
+    // invalid if length mod 4 === 1
+    return input.length % 4 !== 1;
+}
+/**
+ * Validates if a string contains only alphabetic characters (no numbers or special characters).
+ *
+ * @param input - The string to validate
+ * @returns true if the string contains only letters, false otherwise
+ *
+ * @example
+ * isAlphabetic("HelloWorld") // returns true
+ * isAlphabetic("Hello World") // returns false (contains space)
+ * isAlphabetic("Hello123") // returns false (contains numbers)
+ */
+export function isAlphabetic(input) {
+    return /^[A-Za-z]+$/.test(input);
+}
+/**
+ * Validates if a string contains only alphanumeric characters (letters and digits).
+ *
+ * @param input - The string to validate
+ * @returns true if the string contains only letters and numbers, false otherwise
+ *
+ * @example
+ * isAlphanumeric("Hello123") // returns true
+ * isAlphanumeric("Hello-123") // returns false (contains hyphen)
+ * isAlphanumeric("Hello 123") // returns false (contains space)
+ */
+export function isAlphanumeric(input) {
+    return /^[A-Za-z0-9]+$/.test(input);
+}
+/**
+ * Validates if a string contains only lowercase alphabetic characters.
+ *
+ * @param input - The string to validate
+ * @returns true if the string contains only lowercase letters, false otherwise
+ *
+ * @example
+ * isLowerCase("hello") // returns true
+ * isLowerCase("Hello") // returns false (contains uppercase)
+ * isLowerCase("hello123") // returns false (contains numbers)
+ */
+export function isLowerCase(input) {
+    return /^[a-z]+$/.test(input);
+}
+/**
+ * Validates if a string contains only uppercase alphabetic characters.
+ *
+ * @param input - The string to validate
+ * @returns true if the string contains only uppercase letters, false otherwise
+ *
+ * @example
+ * isUpperCase("HELLO") // returns true
+ * isUpperCase("Hello") // returns false (contains lowercase)
+ * isUpperCase("HELLO123") // returns false (contains numbers)
+ */
+export function isUpperCase(input) {
+    return /^[A-Z]+$/.test(input);
+}
+/**
+ * Validates if a string contains only whitespace characters (spaces, tabs, newlines, etc.).
+ *
+ * @param input - The string to validate
+ * @returns true if the string contains only whitespace, false otherwise
+ *
+ * @example
+ * isWhitespace("   ") // returns true
+ * isWhitespace("\t\n") // returns true
+ * isWhitespace(" a ") // returns false (contains non-whitespace)
+ */
+export function isWhitespace(input) {
+    return /^\s+$/.test(input);
+}
+/**
+ * Validates if a string is a palindrome (reads the same forwards and backwards).
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a palindrome, false otherwise
+ *
+ * @example
+ * isPalindrome("racecar") // returns true
+ * isPalindrome("A man, a plan, a canal: Panama") // returns true (ignores punctuation and case)
+ * isPalindrome("hello") // returns false
+ *
+ * @note Case-insensitive and ignores non-alphanumeric characters
+ */
+export function isPalindrome(input) {
+    const cleaned = input.replace(/[\W_]/g, "").toLowerCase();
+    return cleaned === cleaned.split("").reverse().join("");
+}
+/**
+ * Validates if a string contains only hexadecimal characters (0-9, A-F).
+ *
+ * @param input - The string to validate
+ * @returns true if the string is valid hexadecimal, false otherwise
+ *
+ * @example
+ * isHexadecimal("1A2B3C") // returns true
+ * isHexadecimal("DEADBEEF") // returns true
+ * isHexadecimal("12XYZ") // returns false (contains invalid characters)
+ */
+export function isHexadecimal(input) {
+    return /^[0-9A-Fa-f]+$/.test(input);
+}
+/**
+ * Validates if a string is a valid Roman numeral.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a valid Roman numeral, false otherwise
+ *
+ * @example
+ * isRomanNumeral("XIV") // returns true
+ * isRomanNumeral("MCMXCIV") // returns true
+ * isRomanNumeral("IIII") // returns false (should be IV)
+ *
+ * @note Validates standard Roman numeral notation (I, V, X, L, C, D, M)
+ */
+export function isRomanNumeral(input) {
+    return /^(M{0,4}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})$)/i.test(input);
+}
+/**
+ * Validates if a string is a valid IPv4 address.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a valid IPv4 address, false otherwise
+ *
+ * @example
+ * isIPv4("192.168.1.1") // returns true
+ * isIPv4("255.255.255.255") // returns true
+ * isIPv4("256.1.1.1") // returns false (256 exceeds maximum)
+ *
+ * @note Validates standard IPv4 dotted-decimal notation (0.0.0.0 to 255.255.255.255)
+ */
+export function isIPv4(input) {
+    return isIP(input) === 4;
+}
+/**
+ * Validates if a string is a valid IPv6 address.
+ *
+ * @param input - The string to validate
+ * @returns true if the string is a valid IPv6 address, false otherwise
+ *
+ * @example
+ * isIPv6("2001:0db8:85a3:0000:0000:8a2e:0370:7334") // returns true
+ * isIPv6("::1") // returns true (loopback)
+ * isIPv6("::ffff:192.168.1.1") // returns true (IPv4-mapped)
+ * isIPv6("invalid") // returns false
+ *
+ * @note Supports full notation, compressed notation, and IPv4-mapped IPv6 addresses
+ */
+export function isIPv6(input) {
+    return isIP(input) === 6;
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"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"}