re2js 1.3.3 → 2.0.0

package/build/index.esm.d.ts

@@ -26,9 +26,10 @@ export class Matcher {
      * {@link #appendReplacement} as a literal replacement of {@code s}.
      *
      * @param {string} str the string to be quoted
+     * @param {boolean} [javaMode=false] whether the replacement will be used in javaMode
      * @returns {string} the quoted string
      */
-    static quoteReplacement(str: string): string;
+    static quoteReplacement(str: string, javaMode?: boolean): string;
     /**
      *
      * @param {RE2JS} pattern
@@ -170,7 +171,7 @@ export class Matcher {
      * earlier, escape the first digit that should not be used.
      *
      * @param {string} replacement the replacement string
-     * @param {boolean} [perlMode=false] activate perl/js mode (different behaviour for capture groups and special characters)
+     * @param {boolean} [javaMode=false] activate java mode (different behaviour for capture groups and special characters)
      * @returns {string}
      * @throws IllegalStateException if there was no most recent match
      * @throws IndexOutOfBoundsException if replacement refers to an invalid group
@@ -182,13 +183,13 @@ export class Matcher {
      * @returns {string}
      * @private
      */
-    private appendReplacementInternal;
+    private appendReplacementInternalJava;
     /**
      * @param {string} replacement - the replacement string
      * @returns {string}
      * @private
      */
-    private appendReplacementInternalPerl;
+    private appendReplacementInternalJs;
     /**
      * Return the substring of the input from the append position to the end of the
      * input.
@@ -200,26 +201,26 @@ export class Matcher {
      * {@code appendReplacement}.
      *
      * @param {string} replacement - the replacement string
-     * @param {boolean} [perlMode=false] - activate perl/js mode (different behaviour for capture groups and special characters)
+     * @param {boolean} [javaMode=false] - activate java mode (different behaviour for capture groups and special characters)
      * @returns {string} the input string with the matches replaced
-     * @throws IndexOutOfBoundsException if replacement refers to an invalid group and perlMode is false
+     * @throws IndexOutOfBoundsException if replacement refers to an invalid group and javaMode is true
      */
-    replaceAll(replacement: string, perlMode?: boolean): string;
+    replaceAll(replacement: string, javaMode?: boolean): string;
     /**
      * Returns the input with the first match replaced by {@code replacement}, interpreted as for
      * {@code appendReplacement}.
      *
      * @param {string} replacement - the replacement string
-     * @param {boolean} [perlMode=false] - activate perl/js mode (different behaviour for capture groups and special characters)
+     * @param {boolean} [javaMode=false] - activate java mode (different behaviour for capture groups and special characters)
      * @returns {string} the input string with the first match replaced
-     * @throws IndexOutOfBoundsException if replacement refers to an invalid group and perlMode is false
+     * @throws IndexOutOfBoundsException if replacement refers to an invalid group and javaMode is true
      */
-    replaceFirst(replacement: string, perlMode?: boolean): string;
+    replaceFirst(replacement: string, javaMode?: boolean): string;
     /**
      * Helper: replaceAll/replaceFirst hybrid.
      * @param {string} replacement - the replacement string
      * @param {boolean} [all=true] - replace all matches
-     * @param {boolean} [perlMode=false] - activate perl/js mode (different behaviour for capture groups and special characters)
+     * @param {boolean} [javaMode=false] - activate java mode (different behaviour for capture groups and special characters)
      * @returns {string}
      * @private
      */
@@ -269,6 +270,17 @@ export class RE2JS {
      * @returns {string} A literal string replacement
      */
     static quote(str: string): string;
+    /**
+     * Quotes '\' and '$' in {@code str}, so that the returned string could be used in
+     * replacement methods as a literal replacement of {@code str}.
+     *
+     * This is a convenience delegation to {@link Matcher.quoteReplacement}.
+     *
+     * @param {string} str the string to be quoted
+     * @param {boolean} [javaMode=false] whether the replacement will be used in javaMode
+     * @returns {string} the quoted string
+     */
+    static quoteReplacement(str: string, javaMode?: boolean): string;
     /**
      * Translates a given regular expression string to ensure compatibility with RE2JS.
      *

package/build/index.esm.d.ts.map

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

package/build/index.esm.js

@@ -2,7 +2,7 @@
  * re2js
  * RE2JS is the JavaScript port of RE2, a regular expression engine that provides linear time matching
  *
- * @version v1.3.3
+ * @version v2.0.0
  * @author Alexey Vasiliev
  * @homepage https://github.com/le0pard/re2js#readme
  * @repository github:le0pard/re2js
@@ -1124,16 +1124,31 @@ class Matcher {
    * {@link #appendReplacement} as a literal replacement of {@code s}.
    *
    * @param {string} str the string to be quoted
+   * @param {boolean} [javaMode=false] whether the replacement will be used in javaMode
    * @returns {string} the quoted string
    */
-  static quoteReplacement(str) {
-    if (str.indexOf('\\') < 0 && str.indexOf('$') < 0) {
+  static quoteReplacement(str, javaMode = false) {
+    if (javaMode) {
+      // Java mode escape '\' and '$' with a backslash
+      if (str.indexOf('\\') < 0 && str.indexOf('$') < 0) {
+        return str;
+      }
+      return str.split('').map(s => {
+        const c = s.codePointAt(0);
+        if (c === Codepoint.CODES.get('\\') || c === Codepoint.CODES.get('$')) {
+          return `\\${s}`;
+        }
+        return s;
+      }).join('');
+    }
+
+    // In JS mode, '\' is not a special character, but '$' must be escaped as '$$'
+    if (str.indexOf('$') < 0) {
       return str;
     }
     return str.split('').map(s => {
-      const c = s.codePointAt(0);
-      if (c === Codepoint.CODES.get('\\') || c === Codepoint.CODES.get('$')) {
-        return `\\${s}`;
+      if (s.codePointAt(0) === Codepoint.CODES.get('$')) {
+        return '$$';
       }
       return s;
     }).join('');
@@ -1423,13 +1438,13 @@ class Matcher {
    * earlier, escape the first digit that should not be used.
    *
    * @param {string} replacement the replacement string
-   * @param {boolean} [perlMode=false] activate perl/js mode (different behaviour for capture groups and special characters)
+   * @param {boolean} [javaMode=false] activate java mode (different behaviour for capture groups and special characters)
    * @returns {string}
    * @throws IllegalStateException if there was no most recent match
    * @throws IndexOutOfBoundsException if replacement refers to an invalid group
    * @private
    */
-  appendReplacement(replacement, perlMode = false) {
+  appendReplacement(replacement, javaMode = false) {
     let res = '';
     const s = this.start();
     const e = this.end();
@@ -1437,7 +1452,7 @@ class Matcher {
       res += this.substring(this.appendPos, s);
     }
     this.appendPos = e;
-    res += perlMode ? this.appendReplacementInternalPerl(replacement) : this.appendReplacementInternal(replacement);
+    res += javaMode ? this.appendReplacementInternalJava(replacement) : this.appendReplacementInternalJs(replacement);
     return res;
   }
 
@@ -1446,7 +1461,7 @@ class Matcher {
    * @returns {string}
    * @private
    */
-  appendReplacementInternal(replacement) {
+  appendReplacementInternalJava(replacement) {
     let res = '';
     let last = 0;
     const m = replacement.length;
@@ -1512,7 +1527,7 @@ class Matcher {
    * @returns {string}
    * @private
    */
-  appendReplacementInternalPerl(replacement) {
+  appendReplacementInternalJs(replacement) {
     let res = '';
     let last = 0;
     const m = replacement.length;
@@ -1609,12 +1624,12 @@ class Matcher {
    * {@code appendReplacement}.
    *
    * @param {string} replacement - the replacement string
-   * @param {boolean} [perlMode=false] - activate perl/js mode (different behaviour for capture groups and special characters)
+   * @param {boolean} [javaMode=false] - activate java mode (different behaviour for capture groups and special characters)
    * @returns {string} the input string with the matches replaced
-   * @throws IndexOutOfBoundsException if replacement refers to an invalid group and perlMode is false
+   * @throws IndexOutOfBoundsException if replacement refers to an invalid group and javaMode is true
    */
-  replaceAll(replacement, perlMode = false) {
-    return this.replace(replacement, true, perlMode);
+  replaceAll(replacement, javaMode = false) {
+    return this.replace(replacement, true, javaMode);
   }
 
   /**
@@ -1622,27 +1637,27 @@ class Matcher {
    * {@code appendReplacement}.
    *
    * @param {string} replacement - the replacement string
-   * @param {boolean} [perlMode=false] - activate perl/js mode (different behaviour for capture groups and special characters)
+   * @param {boolean} [javaMode=false] - activate java mode (different behaviour for capture groups and special characters)
    * @returns {string} the input string with the first match replaced
-   * @throws IndexOutOfBoundsException if replacement refers to an invalid group and perlMode is false
+   * @throws IndexOutOfBoundsException if replacement refers to an invalid group and javaMode is true
    */
-  replaceFirst(replacement, perlMode = false) {
-    return this.replace(replacement, false, perlMode);
+  replaceFirst(replacement, javaMode = false) {
+    return this.replace(replacement, false, javaMode);
   }
 
   /**
    * Helper: replaceAll/replaceFirst hybrid.
    * @param {string} replacement - the replacement string
    * @param {boolean} [all=true] - replace all matches
-   * @param {boolean} [perlMode=false] - activate perl/js mode (different behaviour for capture groups and special characters)
+   * @param {boolean} [javaMode=false] - activate java mode (different behaviour for capture groups and special characters)
    * @returns {string}
    * @private
    */
-  replace(replacement, all = true, perlMode = false) {
+  replace(replacement, all = true, javaMode = false) {
     let res = '';
     this.reset();
     while (this.find()) {
-      res += this.appendReplacement(replacement, perlMode);
+      res += this.appendReplacement(replacement, javaMode);
       if (!all) {
         break;
       }
@@ -6199,6 +6214,20 @@ class RE2JS {
     return Utils.quoteMeta(str);
   }
 
+  /**
+   * Quotes '\' and '$' in {@code str}, so that the returned string could be used in
+   * replacement methods as a literal replacement of {@code str}.
+   *
+   * This is a convenience delegation to {@link Matcher.quoteReplacement}.
+   *
+   * @param {string} str the string to be quoted
+   * @param {boolean} [javaMode=false] whether the replacement will be used in javaMode
+   * @returns {string} the quoted string
+   */
+  static quoteReplacement(str, javaMode = false) {
+    return Matcher.quoteReplacement(str, javaMode);
+  }
+
   /**
    * Translates a given regular expression string to ensure compatibility with RE2JS.
    *