re2js 0.3.0 → 0.3.2

package/build/index.esm.d.ts

@@ -47,7 +47,7 @@ export class RE2JS {
     /**
      * Helper: create new RE2JS with given regex and flags. Flregex is the regex with flags applied.
      * @param {string} regex
-     * @param {number} flags
+     * @param {number} [flags=0]
      * @returns {RE2JS}
      */
     static compile(regex: string, ...args: any[]): RE2JS;
@@ -55,15 +55,24 @@ export class RE2JS {
      * Matches a string against a regular expression.
      *
      * @param {string} regex the regular expression
-     * @param {*} input the input
+     * @param {string|number[]} input the input
      * @returns {boolean} true if the regular expression matches the entire input
      * @throws RE2JSSyntaxException if the regular expression is malformed
      */
-    static matches(regex: string, input: any): boolean;
-    static initTest(pattern: any, flags: any, re2: any): RE2JS;
-    constructor(pattern: any, flags: any);
-    patternInput: any;
-    flagsInput: any;
+    static matches(regex: string, input: string | number[]): boolean;
+    /**
+     * This is visible for testing.
+     * @private
+     */
+    private static initTest;
+    /**
+     *
+     * @param {string} pattern
+     * @param {number} flags
+     */
+    constructor(pattern: string, flags: number);
+    patternInput: string;
+    flagsInput: number;
     /**
      * Releases memory used by internal caches associated with this pattern. Does not change the
      * observable behaviour. Useful for tests that detect memory leaks via allocation tracking.
@@ -83,17 +92,17 @@ export class RE2JS {
     /**
      * Matches a string against a regular expression.
      *
-     * @param {*} input the input
+     * @param {string|number[]} input the input
      * @returns {boolean} true if the regular expression matches the entire input
      */
-    matches(input: any): boolean;
+    matches(input: string | number[]): boolean;
     /**
      * Creates a new {@code Matcher} matching the pattern against the input.
      *
-     * @param {*} input the input string
+     * @param {string|number[]} input the input string
      * @returns {Matcher}
      */
-    matcher(input: any): Matcher;
+    matcher(input: string | number[]): Matcher;
     /**
      * Splits input around instances of the regular expression. It returns an array giving the strings
      * that occur before, between, and after instances of the regular expression.
@@ -105,11 +114,15 @@ export class RE2JS {
      * of the input, possibly including additional matches of the pattern.
      *
      * @param {string} input the input string to be split
-     * @param {number} limit the limit
-     * @returns {java.lang.String[]} the split strings
+     * @param {number} [limit=0] the limit
+     * @returns {string[]} the split strings
      */
-    split(input: string, ...args: any[]): java.lang.String[];
-    toString(): any;
+    split(input: string, ...args: any[]): string[];
+    /**
+     *
+     * @returns {string}
+     */
+    toString(): string;
     /**
      * Returns the number of capturing groups in this matcher's pattern. Group zero denotes the entire
      * pattern and is excluded from this count.
@@ -123,6 +136,11 @@ export class RE2JS {
      * @returns {*}
      */
     namedGroups(): any;
+    /**
+     *
+     * @param {*} other
+     * @returns {boolean}
+     */
     equals(other: any): boolean;
 }
 /**
@@ -187,49 +205,60 @@ declare class Matcher {
      * Quotes '\' and '$' in {@code s}, so that the returned string could be used in
      * {@link #appendReplacement} as a literal replacement of {@code s}.
      *
-     * @param {string} s the string to be quoted
+     * @param {string} str the string to be quoted
      * @returns {string} the quoted string
      */
-    static quoteReplacement(str: any): string;
-    constructor(pattern: any, input: any);
-    patternInput: any;
+    static quoteReplacement(str: string): string;
+    /**
+     *
+     * @param {RE2JS} pattern
+     * @param {Utf8MatcherInput|Utf16MatcherInput|number[]|string} input
+     */
+    constructor(pattern: RE2JS, input: Utf8MatcherInput | Utf16MatcherInput | number[] | string);
+    patternInput: RE2JS;
     patternGroupCount: any;
     groups: any[];
     namedGroups: any;
-    /** Returns the {@code RE2JS} associated with this {@code Matcher}. */
-    pattern(): any;
+    /**
+     * Returns the {@code RE2JS} associated with this {@code Matcher}.
+     * @returns {RE2JS}
+     */
+    pattern(): RE2JS;
     /**
      * Resets the {@code Matcher}, rewinding input and discarding any match information.
      *
-     * @returns the {@code Matcher} itself, for chained method calls
+     * @returns {Matcher} the {@code Matcher} itself, for chained method calls
      */
-    reset(): this;
+    reset(): Matcher;
     matcherInputLength: any;
-    appendPos: any;
+    appendPos: string | number;
     hasMatch: boolean;
     hasGroups: boolean;
     anchorFlag: number;
     /**
      * Resets the {@code Matcher} and changes the input.
-     * @returns the {@code Matcher} itself, for chained method calls
+     * @returns {Matcher} the {@code Matcher} itself, for chained method calls
      */
-    resetMatcherInput(input: any): this;
+    resetMatcherInput(input: any): Matcher;
     matcherInput: any;
     /**
      * Returns the start of the named group of the most recent match, or -1 if the group was not
      * matched.
-     *
+     * @param {string|number} [group=0]
+     * @returns {string}
      */
-    start(...args: any[]): any;
+    start(...args: any[]): string;
     /**
      * Returns the end of the named group of the most recent match, or -1 if the group was not
      * matched.
-     *
+     * @param {string|number} [group=0]
+     * @returns {string}
      */
-    end(...args: any[]): any;
+    end(...args: any[]): string;
     /**
      * Returns the named group of the most recent match, or {@code null} if the group was not matched.
-     *
+     * @param {string|number} [group=0]
+     * @returns {string}
      */
     group(...args: any[]): string;
     /**
@@ -262,7 +291,7 @@ declare class Matcher {
      * Matches the input against the pattern (unanchored), starting at a specified position. If there
      * is a match, {@code find} sets the match state to describe it.
      *
-     * @param start the input position where the search begins
+     * @param {string|number} [start=null] the input position where the search begins
      * @returns {boolean} if it finds a match
      * @throws IndexOutOfBoundsException if start is not a valid input position
      */
@@ -305,21 +334,24 @@ declare class Matcher {
      *
      * @param {string} replacement the replacement string
      * @param {boolean} [perlMode=false] activate perl/js mode (different behaviour for capture groups and special characters)
-     * @returns the {@code Matcher} itself, for chained method calls
+     * @returns {string}
      * @throws IllegalStateException if there was no most recent match
      * @throws IndexOutOfBoundsException if replacement refers to an invalid group
+     * @private
      */
-    appendReplacement(replacement: string, ...args: any[]): string;
+    private appendReplacement;
     /**
      * @param {string} replacement - the replacement string
      * @returns {string}
+     * @private
      */
-    appendReplacementInternal(replacement: string): string;
+    private appendReplacementInternal;
     /**
      * @param {string} replacement - the replacement string
      * @returns {string}
+     * @private
      */
-    appendReplacementInternalPerl(replacement: string): string;
+    private appendReplacementInternalPerl;
     /**
      * Return the substring of the input from the append position to the end of the
      * input.
@@ -356,5 +388,62 @@ declare class Matcher {
      */
     private replace;
 }
+declare class Utf8MatcherInput extends MatcherInputBase {
+    constructor(...args: any[]);
+    bytes: any;
+    getEncoding(): any;
+    /**
+     *
+     * @returns {string}
+     */
+    asCharSequence(): string;
+    /**
+     *
+     * @returns {number[]}
+     */
+    asBytes(): number[];
+    /**
+     *
+     * @returns {number}
+     */
+    length(): number;
+}
+declare class Utf16MatcherInput extends MatcherInputBase {
+    constructor(...args: any[]);
+    charSequence: any;
+    getEncoding(): any;
+    /**
+     *
+     * @returns {string}
+     */
+    asCharSequence(): string;
+    /**
+     *
+     * @returns {number[]}
+     */
+    asBytes(): number[];
+    /**
+     *
+     * @returns {number}
+     */
+    length(): number;
+}
+/**
+ * Abstract the representations of input text supplied to Matcher.
+ */
+declare class MatcherInputBase {
+    static Encoding: Readonly<{}>;
+    getEncoding(): void;
+    /**
+     *
+     * @returns {boolean}
+     */
+    isUTF8Encoding(): boolean;
+    /**
+     *
+     * @returns {boolean}
+     */
+    isUTF16Encoding(): boolean;
+}
 export {};
 //# sourceMappingURL=index.esm.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.esm.d.ts","sourceRoot":"","sources":["index.esm.js"],"names":[],"mappings":"AAk4KA;;;;;;;;;;GAUG;AACH;IACE;;OAEG;IACH,gCAA4B;IAC5B;;OAEG;IACH,sBAAkB;IAClB;;;OAGG;IACH,yBAAqB;IACrB;;OAEG;IACH,sCAAkC;IAClC;;OAEG;IACH,6BAA0B;IAE1B;;;;;;;;;;;OAWG;IACH,kBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;OAKG;IACH,sBAJW,MAAM,mBAEJ,KAAK,CAyBjB;IAED;;;;;;;OAOG;IACH,sBALW,MAAM,eAEJ,OAAO,CAKnB;IAGD,2DAWC;IACD,sCAKC;IAHC,kBAA2B;IAE3B,gBAAuB;IAGzB;;;OAGG;IACH,cAEC;IAED;;;OAGG;IACH,SAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,WAFa,MAAM,CAIlB;IACD,WAEC;IAED;;;;;OAKG;IACH,qBAFa,OAAO,CAInB;IAED;;;;;OAKG;IACH,qBAFa,OAAO,CAOnB;IAED;;;;;;;;;;;;;OAaG;IACH,aAJW,MAAM,mBAEJ,kBAAkB,CAiD9B;IACD,gBAEC;IAED;;;;;OAKG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,mBAEC;IACD,4BAQC;CACF;AAj2JD;;GAEG;AACH;CAKC;AA/CD;IACE,0BAGC;CACF;AAsDD;;GAEG;AACH;CAKC;AAlBD;;GAEG;AACH;CAKC;AAlDD;;GAEG;AACH;IACE,wCAWC;IAFC,WAAkB;IAClB,WAAkB;IAGpB;;OAEG;IACH,sBAEC;IAED;;OAEG;IACH,kBAEC;CACF;AAgCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IACE;;;;;;OAMG;IACH,mCAFa,MAAM,CAalB;IACD,sCAmBC;IAdC,kBAA2B;IAG3B,uBAAsD;IAEtD,cAAgB;IAChB,iBAAkC;IAUpC,sEAAsE;IACtE,eAEC;IAED;;;;OAIG;IACH,cAaC;IAXC,wBAAoD;IAEpD,eAAkB;IAElB,kBAAqB;IAGrB,mBAAsB;IAEtB,mBAAmB;IAIrB;;;OAGG;IACH,oCAOC;IAHC,kBAAyB;IAK3B;;;;OAIG;IACH,2BAWC;IAED;;;;OAIG;IACH,yBAWC;IAED;;;OAGG;IACH,8BAeC;IACD;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,kBAqBC;IAED;;;;;OAKG;IACH,WAFa,OAAO,CAInB;IAED;;;;;OAKG;IACH,aAFa,OAAO,CAInB;IAED;;;;;;;OAOG;IACH,sBAHa,OAAO,CAqBnB;IAED;;;;;;OAMG;IACH,iBAWC;IAED;;;;;OAKG;IACH,iBAJW,MAAM,OACN,MAAM,GACJ,MAAM,CAOlB;IAED;;;OAGG;IACH,eAFa,MAAM,CAIlB;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,+BANW,MAAM,0BAiBhB;IAED;;;OAGG;IACH,uCAHW,MAAM,GACJ,MAAM,CA6DlB;IAED;;;OAGG;IACH,2CAHW,MAAM,GACJ,MAAM,CAmFlB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;;;;;OAQG;IACH,wBALW,MAAM,mBAEJ,MAAM,CAMlB;IAED;;;;;;;;OAQG;IACH,0BALW,MAAM,mBAEJ,MAAM,CAMlB;IAED;;;;;;;OAOG;IACH,gBAaC;CACF"}
+{"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 v0.3.0
+ * @version v0.3.2
  * @author Alexey Vasiliev
  * @homepage https://github.com/le0pard/re2js#readme
  * @repository github:le0pard/re2js
@@ -696,9 +696,19 @@ class MatcherInputBase {
   getEncoding() {
     throw Error('not implemented');
   }
+
+  /**
+   *
+   * @returns {boolean}
+   */
   isUTF8Encoding() {
     return this.getEncoding() === MatcherInputBase.Encoding.UTF_8;
   }
+
+  /**
+   *
+   * @returns {boolean}
+   */
   isUTF16Encoding() {
     return this.getEncoding() === MatcherInputBase.Encoding.UTF_16;
   }
@@ -712,12 +722,26 @@ class Utf8MatcherInput extends MatcherInputBase {
   getEncoding() {
     return MatcherInputBase.Encoding.UTF_8;
   }
+  /**
+   *
+   * @returns {string}
+   */
   asCharSequence() {
     return Utils.utf8ByteArrayToString(this.bytes);
   }
+
+  /**
+   *
+   * @returns {number[]}
+   */
   asBytes() {
     return this.bytes;
   }
+
+  /**
+   *
+   * @returns {number}
+   */
   length() {
     return this.bytes.length;
   }
@@ -731,12 +755,27 @@ class Utf16MatcherInput extends MatcherInputBase {
   getEncoding() {
     return MatcherInputBase.Encoding.UTF_16;
   }
+
+  /**
+   *
+   * @returns {string}
+   */
   asCharSequence() {
     return this.charSequence;
   }
+
+  /**
+   *
+   * @returns {number[]}
+   */
   asBytes() {
     return this.charSequence.toString().split('').map(s => s.codePointAt(0));
   }
+
+  /**
+   *
+   * @returns {number}
+   */
   length() {
     return this.charSequence.length;
   }
@@ -744,6 +783,7 @@ class Utf16MatcherInput extends MatcherInputBase {
 class MatcherInput {
   /**
    * Return the MatcherInput for UTF_16 encoding.
+   * @returns {Utf16MatcherInput}
    */
   static utf16(charSequence) {
     return new Utf16MatcherInput(charSequence);
@@ -751,6 +791,7 @@ class MatcherInput {
 
   /**
    * Return the MatcherInput for UTF_8 encoding.
+   * @returns {Utf8MatcherInput}
    */
   static utf8(input) {
     if (Array.isArray(input)) {
@@ -857,7 +898,7 @@ class Matcher {
    * Quotes '\' and '$' in {@code s}, so that the returned string could be used in
    * {@link #appendReplacement} as a literal replacement of {@code s}.
    *
-   * @param {string} s the string to be quoted
+   * @param {string} str the string to be quoted
    * @returns {string} the quoted string
    */
   static quoteReplacement(str) {
@@ -872,6 +913,11 @@ class Matcher {
       return s;
     }).join('');
   }
+  /**
+   *
+   * @param {RE2JS} pattern
+   * @param {Utf8MatcherInput|Utf16MatcherInput|number[]|string} input
+   */
   constructor(pattern, input) {
     if (pattern === null) {
       throw new Error('pattern is null');
@@ -893,7 +939,10 @@ class Matcher {
     }
   }
 
-  /** Returns the {@code RE2JS} associated with this {@code Matcher}. */
+  /**
+   * Returns the {@code RE2JS} associated with this {@code Matcher}.
+   * @returns {RE2JS}
+   */
   pattern() {
     return this.patternInput;
   }
@@ -901,7 +950,7 @@ class Matcher {
   /**
    * Resets the {@code Matcher}, rewinding input and discarding any match information.
    *
-   * @returns the {@code Matcher} itself, for chained method calls
+   * @returns {Matcher} the {@code Matcher} itself, for chained method calls
    */
   reset() {
     // The input length in UTF16 codes.
@@ -920,7 +969,7 @@ class Matcher {
 
   /**
    * Resets the {@code Matcher} and changes the input.
-   * @returns the {@code Matcher} itself, for chained method calls
+   * @returns {Matcher} the {@code Matcher} itself, for chained method calls
    */
   resetMatcherInput(input) {
     if (input === null) {
@@ -934,7 +983,8 @@ class Matcher {
   /**
    * Returns the start of the named group of the most recent match, or -1 if the group was not
    * matched.
-   *
+   * @param {string|number} [group=0]
+   * @returns {string}
    */
   start() {
     let group = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
@@ -952,7 +1002,8 @@ class Matcher {
   /**
    * Returns the end of the named group of the most recent match, or -1 if the group was not
    * matched.
-   *
+   * @param {string|number} [group=0]
+   * @returns {string}
    */
   end() {
     let group = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
@@ -969,7 +1020,8 @@ class Matcher {
 
   /**
    * Returns the named group of the most recent match, or {@code null} if the group was not matched.
-   *
+   * @param {string|number} [group=0]
+   * @returns {string}
    */
   group() {
     let group = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
@@ -1048,7 +1100,7 @@ class Matcher {
    * Matches the input against the pattern (unanchored), starting at a specified position. If there
    * is a match, {@code find} sets the match state to describe it.
    *
-   * @param start the input position where the search begins
+   * @param {string|number} [start=null] the input position where the search begins
    * @returns {boolean} if it finds a match
    * @throws IndexOutOfBoundsException if start is not a valid input position
    */
@@ -1131,9 +1183,10 @@ class Matcher {
    *
    * @param {string} replacement the replacement string
    * @param {boolean} [perlMode=false] activate perl/js mode (different behaviour for capture groups and special characters)
-   * @returns the {@code Matcher} itself, for chained method calls
+   * @returns {string}
    * @throws IllegalStateException if there was no most recent match
    * @throws IndexOutOfBoundsException if replacement refers to an invalid group
+   * @private
    */
   appendReplacement(replacement) {
     let perlMode = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
@@ -1151,6 +1204,7 @@ class Matcher {
   /**
    * @param {string} replacement - the replacement string
    * @returns {string}
+   * @private
    */
   appendReplacementInternal(replacement) {
     let res = '';
@@ -1216,6 +1270,7 @@ class Matcher {
   /**
    * @param {string} replacement - the replacement string
    * @returns {string}
+   * @private
    */
   appendReplacementInternalPerl(replacement) {
     let res = '';
@@ -3085,6 +3140,8 @@ class Parser {
   }
   /**
    * Parse regular expression pattern {@code pattern} with mode flags {@code flags}.
+   * @param {string} pattern
+   * @param {number} flags
    */
   static parse(pattern, flags) {
     return new Parser(pattern, flags).parseInternal();
@@ -5557,7 +5614,7 @@ class RE2JS {
   /**
    * Helper: create new RE2JS with given regex and flags. Flregex is the regex with flags applied.
    * @param {string} regex
-   * @param {number} flags
+   * @param {number} [flags=0]
    * @returns {RE2JS}
    */
   static compile(regex) {
@@ -5589,7 +5646,7 @@ class RE2JS {
    * Matches a string against a regular expression.
    *
    * @param {string} regex the regular expression
-   * @param {*} input the input
+   * @param {string|number[]} input the input
    * @returns {boolean} true if the regular expression matches the entire input
    * @throws RE2JSSyntaxException if the regular expression is malformed
    */
@@ -5597,7 +5654,10 @@ class RE2JS {
     return RE2JS.compile(regex).matcher(input).matches();
   }
 
-  // This is visible for testing.
+  /**
+   * This is visible for testing.
+   * @private
+   */
   static initTest(pattern, flags, re2) {
     if (pattern == null) {
       throw new Error('pattern is null');
@@ -5610,6 +5670,12 @@ class RE2JS {
     p.re2Input = re2;
     return p;
   }
+
+  /**
+   *
+   * @param {string} pattern
+   * @param {number} flags
+   */
   constructor(pattern, flags) {
     // The pattern string at construction time.
     this.patternInput = pattern;
@@ -5647,7 +5713,7 @@ class RE2JS {
   /**
    * Matches a string against a regular expression.
    *
-   * @param {*} input the input
+   * @param {string|number[]} input the input
    * @returns {boolean} true if the regular expression matches the entire input
    */
   matches(input) {
@@ -5657,7 +5723,7 @@ class RE2JS {
   /**
    * Creates a new {@code Matcher} matching the pattern against the input.
    *
-   * @param {*} input the input string
+   * @param {string|number[]} input the input string
    * @returns {Matcher}
    */
   matcher(input) {
@@ -5678,8 +5744,8 @@ class RE2JS {
    * of the input, possibly including additional matches of the pattern.
    *
    * @param {string} input the input string to be split
-   * @param {number} limit the limit
-   * @returns {java.lang.String[]} the split strings
+   * @param {number} [limit=0] the limit
+   * @returns {string[]} the split strings
    */
   split(input) {
     let limit = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
@@ -5729,6 +5795,11 @@ class RE2JS {
     }
     return result;
   }
+
+  /**
+   *
+   * @returns {string}
+   */
   toString() {
     return this.patternInput;
   }
@@ -5751,6 +5822,12 @@ class RE2JS {
   namedGroups() {
     return this.re2Input.namedGroups;
   }
+
+  /**
+   *
+   * @param {*} other
+   * @returns {boolean}
+   */
   equals(other) {
     if (this === other) {
       return true;