@elaraai/east 0.0.1-beta.0

package/dist/src/expr/regex_validation.js

@@ -0,0 +1,130 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+export function validateCrossPlatformCompatible(regex) {
+    const result = {
+        isValid: true,
+        warnings: [],
+        errors: []
+    };
+    const pattern = regex.source;
+    const flags = regex.flags;
+    // Check flags compatibility
+    validateFlags(flags, result);
+    // Check pattern compatibility  
+    validatePattern(pattern, result);
+    result.isValid = result.errors.length === 0;
+    return result;
+}
+function validateFlags(flags, result) {
+    // Cross-platform compatible flags (supported by both JavaScript and PCRE)
+    const supportedFlags = new Set(['i', 'm', 's']);
+    // JavaScript-specific flags that aren't part of the common PCRE subset
+    const jsOnlyFlags = new Set(['g', 'y', 'u', 'd']);
+    for (const flag of flags) {
+        if (jsOnlyFlags.has(flag)) {
+            result.errors.push(`Flag '${flag}' is JavaScript-specific and not in the common PCRE subset`);
+        }
+        else if (!supportedFlags.has(flag)) {
+            result.warnings.push(`Flag '${flag}' may not be supported across all regex backends`);
+        }
+    }
+    // Note: Different backends handle global matching via different APIs
+    if (flags.includes('g')) {
+        result.warnings.push("Global flag 'g' behavior varies between backends - use with caution");
+    }
+}
+function validatePattern(pattern, result) {
+    // JavaScript-specific features that aren't in the common PCRE subset
+    const jsOnlyFeatures = [
+        { regex: /\\k<\w+>/, message: "Named backreferences \\k<name> are JavaScript-specific extensions" },
+        { regex: /\(\?\<[=!]/, message: "Lookbehind assertions have inconsistent support across regex engines" },
+        { regex: /\\p\{.*?\}/, message: "Unicode property escapes \\p{...} are not consistently supported" },
+        { regex: /\\u\{[0-9a-fA-F]+\}/, message: "Extended Unicode codepoint escapes \\u{...} are JavaScript-specific" },
+    ];
+    // PCRE-specific features that aren't supported in JavaScript
+    const pcreOnlyFeatures = [
+        { regex: /\(\*[A-Z_]+\)/, message: "PCRE control verbs (*SKIP, *FAIL, etc.) are not in the common subset" },
+        { regex: /\\K/, message: "Keep assertion \\K is PCRE-specific and not supported in JavaScript" },
+        { regex: /\(\?\+|\*\+|\+\+|\?\+/, message: "Possessive quantifiers are PCRE-specific extensions" },
+        { regex: /\(\?\?\)/, message: "Branch reset groups (?|...) are PCRE-specific extensions" },
+    ];
+    // Check for JavaScript-specific features
+    for (const feature of jsOnlyFeatures) {
+        if (feature.regex.test(pattern)) {
+            result.errors.push(feature.message);
+        }
+    }
+    // Check for PCRE-specific features  
+    for (const feature of pcreOnlyFeatures) {
+        if (feature.regex.test(pattern)) {
+            result.errors.push(feature.message);
+        }
+    }
+    // Warn about patterns that may behave differently across backends
+    const warnings = [
+        { regex: /\[\[:/, message: "POSIX character classes [[:alpha:]] may behave differently across engines" },
+        { regex: /\(\?\#/, message: "Inline comments (?#...) are supported but may affect performance differently" },
+        { regex: /\\x\{[0-9a-fA-F]+\}/, message: "Extended hex escapes \\x{...} may not be consistently supported" },
+    ];
+    for (const warning of warnings) {
+        if (warning.regex.test(pattern)) {
+            result.warnings.push(warning.message);
+        }
+    }
+}
+// Example usage and test cases
+export function runCompatibilityTests() {
+    console.log("=== Cross-Platform RegExp Validation Tests ===\n");
+    const testCases = [
+        // ✅ Safe cross-platform patterns
+        { name: "Basic word pattern", regex: /\w+/, expectedValid: true },
+        { name: "Email pattern", regex: /\w+@\w+\.\w+/, expectedValid: true },
+        { name: "Case insensitive", regex: /hello/i, expectedValid: true },
+        { name: "Multiline mode", regex: /^test$/m, expectedValid: true },
+        { name: "Dotall mode", regex: /a.*b/s, expectedValid: true },
+        { name: "Character class", regex: /[a-z0-9]+/i, expectedValid: true },
+        { name: "Anchors", regex: /^start.*end$/, expectedValid: true },
+        { name: "Groups and alternation", regex: /(cat|dog)/, expectedValid: true },
+        { name: "Quantifiers", regex: /a{2,5}b*c+d?/, expectedValid: true },
+        // ⚠️ Problematic patterns
+        { name: "Global flag", regex: /test/g, expectedValid: false }, // Has warnings
+        { name: "Unicode flag", regex: /test/u, expectedValid: false },
+        { name: "Sticky flag", regex: /test/y, expectedValid: false },
+        // ❌ JavaScript-only features  
+        { name: "Named backreference", regex: /(?<name>\w+)\k<name>/, expectedValid: false },
+        { name: "Unicode property", regex: /\p{Letter}/u, expectedValid: false },
+    ];
+    for (const testCase of testCases) {
+        const result = validateCrossPlatformCompatible(testCase.regex);
+        const status = result.isValid ? "✅" : "❌";
+        const expected = testCase.expectedValid ? "should pass" : "should fail";
+        console.log(`${status} ${testCase.name} (${expected})`);
+        console.log(`   Pattern: ${testCase.regex}`);
+        if (result.errors.length > 0) {
+            console.log(`   Errors: ${result.errors.join(", ")}`);
+        }
+        if (result.warnings.length > 0) {
+            console.log(`   Warnings: ${result.warnings.join(", ")}`);
+        }
+        console.log();
+    }
+}
+// Recommended patterns that work well across different regex backends
+export const RECOMMENDED_PATTERNS = {
+    email: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
+    phoneUS: /^\(\d{3}\)\s?\d{3}-\d{4}$/,
+    uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+    ipv4: /^(?:(?:25[0-5]|2[0-4]\d|[01]\d\d|\d{1,2})\.){3}(?:25[0-5]|2[0-4]\d|[01]\d\d|\d{1,2})$/,
+    url: /^https?:\/\/[\w\-]+(\.[\w\-]+)+([\w\-\.,@?^=%&:/~\+#]*[\w\-\@?^=%&/~\+#])?$/,
+    identifier: /^[a-zA-Z_][a-zA-Z0-9_]*$/,
+    number: /^-?\d+(\.\d+)?([eE][+-]?\d+)?$/,
+    whitespace: /\s+/,
+    word: /\b\w+\b/,
+    lineBreak: /\r?\n/
+};
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runCompatibilityTests();
+}
+//# sourceMappingURL=regex_validation.js.map

package/dist/src/expr/regex_validation.js.map

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