@adguard/agtree 4.0.1 → 4.0.3

package/dist/types/utils/regexp.d.ts

@@ -1,5 +1,5 @@
 /**
- * @file Regular expression utilities
+ * @file Regular expression utilities.
  */
 export declare const REGEX_START = "^";
 export declare const REGEX_END = "$";
@@ -13,13 +13,13 @@ export declare const ADBLOCK_WILDCARD_REGEX: string;
 export declare const REGEX_NEGATION_PREFIX = "^((?!";
 export declare const REGEX_NEGATION_SUFFIX = ").)*$";
 /**
- * Special RegExp symbols
+ * Special RegExp symbols.
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#special-escape
  */
 export declare const SPECIAL_REGEX_SYMBOLS: Set<string>;
 /**
- * Utility functions for working with RegExp patterns
+ * Utility functions for working with RegExp patterns.
  */
 export declare class RegExpUtils {
     /**
@@ -29,22 +29,25 @@ export declare class RegExpUtils {
      * Note: it does not perform a full validation of the pattern,
      * it just checks if the string starts and ends with a slash.
      *
-     * @param pattern - Pattern to check
-     * @returns `true` if the string is a RegExp pattern, `false` otherwise
+     * @param pattern Pattern to check.
+     *
+     * @returns `true` if the string is a RegExp pattern, `false` otherwise.
      */
     static isRegexPattern(pattern: string): boolean;
     /**
      * Checks whether a string is a negated RegExp pattern.
      *
-     * @param pattern - Pattern to check
-     * @returns `true` if the string is a negated RegExp pattern, `false` otherwise
+     * @param pattern Pattern to check.
+     *
+     * @returns `true` if the string is a negated RegExp pattern, `false` otherwise.
      */
     static isNegatedRegexPattern(pattern: string): boolean;
     /**
      * Removes negation from a RegExp pattern.
      *
-     * @param pattern - RegExp pattern to remove negation from
-     * @returns RegExp pattern without negation
+     * @param pattern RegExp pattern to remove negation from.
+     *
+     * @returns RegExp pattern without negation.
      */
     static removeNegationFromRegexPattern(pattern: string): string;
     /**
@@ -52,31 +55,35 @@ export declare class RegExpUtils {
      *
      * RegExp modifiers are not supported.
      *
-     * @param pattern Pattern to negate (can be wrapped in slashes or not)
-     * @returns Negated RegExp pattern
+     * @param pattern Pattern to negate (can be wrapped in slashes or not).
+     *
+     * @returns Negated RegExp pattern.
      */
     static negateRegexPattern(pattern: string): string;
     /**
      * Ensures that a pattern is wrapped in slashes.
      *
-     * @param pattern Pattern to ensure slashes for
-     * @returns Pattern with slashes
+     * @param pattern Pattern to ensure slashes for.
+     *
+     * @returns Pattern with slashes.
      */
     static ensureSlashes(pattern: string): string;
     /**
      * Converts a basic adblock rule pattern to a RegExp pattern. Based on
-     * https://github.com/AdguardTeam/tsurlfilter/blob/9b26e0b4a0e30b87690bc60f7cf377d112c3085c/packages/tsurlfilter/src/rules/simple-regex.ts#L219
+     * https://github.com/AdguardTeam/tsurlfilter/blob/9b26e0b4a0e30b87690bc60f7cf377d112c3085c/packages/tsurlfilter/src/rules/simple-regex.ts#L219.
      *
-     * @param pattern Pattern to convert
-     * @returns RegExp equivalent of the pattern
      * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#basic-rules}
+     *
+     * @param pattern Pattern to convert.
+     *
+     * @returns RegExp equivalent of the pattern.
      */
     static patternToRegexp(pattern: string): string;
     /**
      * Creates a length-matching regular expression string: /^(?=.{min,max}$).*\/s
      * Where:
      * - (?=.{min,max}$) is a lookahead that ensures the string length is between min and max
-     * - .* matches any character (including newlines, due to the 's' flag)
+     * - .* matches any character (including newlines, due to the 's' flag).
      *
      * @param min Minimum length or `null` for no minimum (default to `0`).
      * @param max Maximum length or `null` for no maximum (default to no maximum).

package/dist/types/utils/string.d.ts

@@ -11,71 +11,77 @@ export type NewLineSplit = [string, NewLineType | null][];
 export declare class StringUtils {
     /**
      * Finds the first occurrence of a character that:
-     * - isn't preceded by an escape character
+     * - isn't preceded by an escape character.
+     *
+     * @param pattern Source pattern.
+     * @param searchedCharacter Searched character.
+     * @param start Start index.
+     * @param escapeCharacter Escape character, \ by default.
+     * @param end End index (excluded).
      *
-     * @param pattern - Source pattern
-     * @param searchedCharacter - Searched character
-     * @param start - Start index
-     * @param escapeCharacter - Escape character, \ by default
-     * @param end - End index (excluded)
-     * @returns Index or -1 if the character not found
+     * @returns Index or -1 if the character not found.
      */
     static findNextUnescapedCharacter(pattern: string, searchedCharacter: string, start?: number, escapeCharacter?: string, end?: number): number;
     /**
      * Finds the first occurrence in backward direction of a character that isn't preceded by an escape character.
      *
-     * @param pattern - Source pattern
-     * @param searchedCharacter - Searched character
-     * @param start - Start index
-     * @param escapeCharacter - Escape character, \ by default
-     * @param end - End index (Included)
-     * @returns Index or -1 if the character not found
+     * @param pattern Source pattern.
+     * @param searchedCharacter Searched character.
+     * @param start Start index.
+     * @param escapeCharacter Escape character, \ by default.
+     * @param end End index (Included).
+     *
+     * @returns Index or -1 if the character not found.
      */
     static findNextUnescapedCharacterBackwards(pattern: string, searchedCharacter: string, start?: number, escapeCharacter?: string, end?: number): number;
     /**
      * Finds the last occurrence of a character that:
-     * - isn't preceded by an escape character
+     * - isn't preceded by an escape character.
      *
-     * @param pattern - Source pattern
-     * @param searchedCharacter - Searched character
-     * @param escapeCharacter - Escape character, \ by default
-     * @returns Index or -1 if the character not found
+     * @param pattern Source pattern.
+     * @param searchedCharacter Searched character.
+     * @param escapeCharacter Escape character, \ by default.
+     *
+     * @returns Index or -1 if the character not found.
      */
     static findLastUnescapedCharacter(pattern: string, searchedCharacter: string, escapeCharacter?: string): number;
     /**
      * Finds the next occurrence of a character that:
      * - isn't preceded by an escape character
-     * - isn't followed by the specified character
-     *
-     * @param pattern - Source pattern
-     * @param start - Start index
-     * @param searchedCharacter - Searched character
-     * @param notFollowedBy - Searched character not followed by this character
-     * @param escapeCharacter - Escape character, \ by default
-     * @returns Index or -1 if the character not found
+     * - isn't followed by the specified character.
+     *
+     * @param pattern Source pattern.
+     * @param start Start index.
+     * @param searchedCharacter Searched character.
+     * @param notFollowedBy Searched character not followed by this character.
+     * @param escapeCharacter Escape character, \ by default.
+     *
+     * @returns Index or -1 if the character not found.
      */
     static findNextUnescapedCharacterThatNotFollowedBy(pattern: string, start: number, searchedCharacter: string, notFollowedBy: string, escapeCharacter?: string): number;
     /**
      * Finds the last occurrence of a character that:
      * - isn't preceded by an escape character
-     * - isn't followed by the specified character
+     * - isn't followed by the specified character.
+     *
+     * @param pattern Source pattern.
+     * @param searchedCharacter Searched character.
+     * @param notFollowedBy Searched character not followed by this character.
+     * @param escapeCharacter Escape character, \ by default.
      *
-     * @param pattern - Source pattern
-     * @param searchedCharacter - Searched character
-     * @param notFollowedBy - Searched character not followed by this character
-     * @param escapeCharacter - Escape character, \ by default
-     * @returns Index or -1 if the character not found
+     * @returns Index or -1 if the character not found.
      */
     static findLastUnescapedCharacterThatNotFollowedBy(pattern: string, searchedCharacter: string, notFollowedBy: string, escapeCharacter?: string): number;
     /**
      * Finds the next occurrence of a character that:
      * - isn't part of any string literal ('literal' or "literal")
-     * - isn't part of any RegExp expression (/regexp/)
+     * - isn't part of any RegExp expression (/regexp/).
+     *
+     * @param pattern Source pattern.
+     * @param searchedCharacter Searched character.
+     * @param start Start index.
      *
-     * @param pattern - Source pattern
-     * @param searchedCharacter - Searched character
-     * @param start - Start index
-     * @returns Index or -1 if the character not found
+     * @returns Index or -1 if the character not found.
      */
     static findUnescapedNonStringNonRegexChar(pattern: string, searchedCharacter: string, start?: number): number;
     /**
@@ -96,71 +102,79 @@ export declare class StringUtils {
     /**
      * Finds the next occurrence of a character that:
      * - isn't part of any string literal ('literal' or "literal")
-     * - isn't preceded by an escape character
+     * - isn't preceded by an escape character.
+     *
+     * @param pattern Source pattern.
+     * @param searchedCharacter Searched character.
+     * @param start Start index.
+     * @param escapeCharacter Escape character, \ by default.
      *
-     * @param pattern - Source pattern
-     * @param searchedCharacter - Searched character
-     * @param start - Start index
-     * @param escapeCharacter - Escape character, \ by default
-     * @returns Index or -1 if the character not found
+     * @returns Index or -1 if the character not found.
      */
     static findNextUnquotedUnescapedCharacter(pattern: string, searchedCharacter: string, start?: number, escapeCharacter?: string): number;
     /**
      * Finds the next occurrence of a character that:
      * - isn't "bracketed"
-     * - isn't preceded by an escape character
+     * - isn't preceded by an escape character.
+     *
+     * @param pattern Source pattern.
+     * @param searchedCharacter Searched character.
+     * @param start Start index.
+     * @param escapeCharacter Escape character, \ by default.
+     * @param openBracket Open bracket, ( by default.
+     * @param closeBracket Close bracket, ( by default.
      *
-     * @param pattern - Source pattern
-     * @param searchedCharacter - Searched character
-     * @param start - Start index
-     * @param escapeCharacter - Escape character, \ by default
-     * @param openBracket - Open bracket, ( by default
-     * @param closeBracket - Close bracket, ( by default
-     * @throws If the opening and closing brackets are the same
-     * @returns Index or -1 if the character not found
+     * @returns Index or -1 if the character not found.
+     *
+     * @throws If the opening and closing brackets are the same.
      */
     static findNextNotBracketedUnescapedCharacter(pattern: string, searchedCharacter: string, start?: number, escapeCharacter?: string, openBracket?: string, closeBracket?: string): number;
     /**
      * Splits the source pattern along characters that:
      * - isn't part of any string literal ('literal' or "literal")
-     * - isn't preceded by an escape character
+     * - isn't preceded by an escape character.
      *
-     * @param pattern - Source pattern
-     * @param delimeterCharacter - Delimeter character
-     * @returns Splitted string
+     * @param pattern Source pattern.
+     * @param delimeterCharacter Delimeter character.
+     *
+     * @returns Splitted string.
      */
     static splitStringByUnquotedUnescapedCharacter(pattern: string, delimeterCharacter: string): string[];
     /**
      * Splits the source pattern along characters that:
      * - isn't part of any string literal ('literal' or "literal")
      * - isn't part of any RegExp expression (/regexp/)
-     * - isn't preceded by an escape character
+     * - isn't preceded by an escape character.
+     *
+     * @param pattern Source pattern.
+     * @param delimeterCharacter Delimeter character.
      *
-     * @param pattern - Source pattern
-     * @param delimeterCharacter - Delimeter character
-     * @returns Splitted string
+     * @returns Splitted string.
      */
     static splitStringByUnescapedNonStringNonRegexChar(pattern: string, delimeterCharacter: string): string[];
     /**
      * Splits the source pattern along characters that:
-     * - isn't preceded by an escape character
+     * - isn't preceded by an escape character.
+     *
+     * @param pattern Source pattern.
+     * @param delimeterCharacter Delimeter character.
      *
-     * @param pattern - Source pattern
-     * @param delimeterCharacter - Delimeter character
-     * @returns Splitted string
+     * @returns Splitted string.
      */
     static splitStringByUnescapedCharacter(pattern: string, delimeterCharacter: string): string[];
     /**
      * Determines whether the given character is a space or tab character.
      *
-     * @param char - The character to check.
-     * @returns true if the given character is a space or tab character, false otherwise.
+     * @param char The character to check.
+     *
+     * @returns True if the given character is a space or tab character, false otherwise.
      */
     static isWhitespace(char: string): boolean;
     /**
      * Checks if the given character is a digit.
      *
      * @param char The character to check.
+     *
      * @returns `true` if the given character is a digit, `false` otherwise.
      */
     static isDigit(char: string): boolean;
@@ -168,6 +182,7 @@ export declare class StringUtils {
      * Checks if the given character is a small letter.
      *
      * @param char The character to check.
+     *
      * @returns `true` if the given character is a small letter, `false` otherwise.
      */
     static isSmallLetter(char: string): boolean;
@@ -175,6 +190,7 @@ export declare class StringUtils {
      * Checks if the given character is a capital letter.
      *
      * @param char The character to check.
+     *
      * @returns `true` if the given character is a capital letter, `false` otherwise.
      */
     static isCapitalLetter(char: string): boolean;
@@ -182,114 +198,130 @@ export declare class StringUtils {
      * Checks if the given character is a letter (small or capital).
      *
      * @param char The character to check.
+     *
      * @returns `true` if the given character is a letter, `false` otherwise.
      */
     static isLetter(char: string): boolean;
     /**
      * Checks if the given character is a letter or a digit.
      *
-     * @param char Character to check
+     * @param char Character to check.
+     *
      * @returns `true` if the given character is a letter or a digit, `false` otherwise.
      */
     static isAlphaNumeric(char: string): boolean;
     /**
      * Searches for the first non-whitespace character in the source pattern.
      *
-     * @param pattern - Source pattern
-     * @param start - Start index
-     * @returns Index or -1 if the character not found
+     * @param pattern Source pattern.
+     * @param start Start index.
+     *
+     * @returns Index or -1 if the character not found.
      */
     static findFirstNonWhitespaceCharacter(pattern: string, start?: number): number;
     /**
      * Searches for the last non-whitespace character in the source pattern.
      *
-     * @param pattern - Source pattern
-     * @returns Index or -1 if the character not found
+     * @param pattern Source pattern.
+     *
+     * @returns Index or -1 if the character not found.
      */
     static findLastNonWhitespaceCharacter(pattern: string): number;
     /**
      * Finds the next whitespace character in the pattern.
      *
-     * @param pattern Pattern to search in
-     * @param start Start index
-     * @returns Index of the next whitespace character or the length of the pattern if not found
+     * @param pattern Pattern to search in.
+     * @param start Start index.
+     *
+     * @returns Index of the next whitespace character or the length of the pattern if not found.
      */
     static findNextWhitespaceCharacter(pattern: string, start?: number): number;
     /**
      * Escapes a specified character in the string.
      *
-     * @param pattern - Input string
-     * @param character - Character to escape
-     * @param escapeCharacter - Escape character (optional)
-     * @returns Escaped string
+     * @param pattern Input string.
+     * @param character Character to escape.
+     * @param escapeCharacter Escape character (optional).
+     *
+     * @returns Escaped string.
      */
     static escapeCharacter(pattern: string, character: string, escapeCharacter?: string): string;
     /**
      * Searches for the next non-whitespace character in the source pattern.
      *
-     * @param pattern Pattern to search
-     * @param start Start index
-     * @returns Index of the next non-whitespace character or the length of the pattern
+     * @param pattern Pattern to search.
+     * @param start Start index.
+     *
+     * @returns Index of the next non-whitespace character or the length of the pattern.
      */
     static skipWS(pattern: string, start?: number): number;
     /**
      * Searches for the previous non-whitespace character in the source pattern.
      *
-     * @param pattern Pattern to search
-     * @param start Start index
-     * @returns Index of the previous non-whitespace character or -1
+     * @param pattern Pattern to search.
+     * @param start Start index.
+     *
+     * @returns Index of the previous non-whitespace character or -1.
      */
     static skipWSBack(pattern: string, start?: number): number;
     /**
      * Checks if the given character is a new line character.
      *
-     * @param char Character to check
+     * @param char Character to check.
+     *
      * @returns `true` if the given character is a new line character, `false` otherwise.
      */
     static isEOL(char: string): boolean;
     /**
      * Splits a string along newline characters.
      *
-     * @param input - Input string
-     * @returns Splitted string
+     * @param input Input string.
+     *
+     * @returns Splitted string.
      */
     static splitStringByNewLines(input: string): string[];
     /**
-     * Splits a string by new lines and stores the new line type for each line
+     * Splits a string by new lines and stores the new line type for each line.
+     *
+     * @param input The input string to be split.
      *
-     * @param input The input string to be split
      * @returns An array of tuples, where each tuple contains a line of the input string and its
-     * corresponding new line type ("lf", "crlf", or "cr")
+     * corresponding new line type ("lf", "crlf", or "cr").
      */
     static splitStringByNewLinesEx(input: string): NewLineSplit;
     /**
-     * Merges an array of tuples (line, newLineType) into a single string
+     * Merges an array of tuples (line, newLineType) into a single string.
      *
-     * @param input The array of tuples to be merged
-     * @returns A single string containing the lines and new line characters from the input array
+     * @param input The array of tuples to be merged.
+     *
+     * @returns A single string containing the lines and new line characters from the input array.
      */
     static mergeStringByNewLines(input: NewLineSplit): string;
     /**
-     * Helper method to parse a raw string as a number
+     * Helper method to parse a raw string as a number.
+     *
+     * @param raw Raw string to parse.
      *
-     * @param raw Raw string to parse
-     * @returns Parsed number
-     * @throws If the raw string can't be parsed as a number
+     * @returns Parsed number.
+     *
+     * @throws If the raw string can't be parsed as a number.
      */
     static parseNumber(raw: string): number;
     /**
      * Checks if the given value is a string.
      *
-     * @param value Value to check
-     * @returns `true` if the value is a string, `false` otherwise
+     * @param value Value to check.
+     *
+     * @returns `true` if the value is a string, `false` otherwise.
      */
     static isString(value: unknown): value is string;
     /**
      * Escapes the given characters in the input string.
      *
-     * @param input Input string
-     * @param characters Characters to escape (by default, no characters are escaped)
-     * @returns Escaped string
+     * @param input Input string.
+     * @param characters Characters to escape (by default, no characters are escaped).
+     *
+     * @returns Escaped string.
      */
     static escapeCharacters(input: string, characters?: Set<string>): string;
 }

package/dist/types/utils/type-guards.d.ts

@@ -34,6 +34,7 @@ export declare const isInteger: (value: unknown) => value is number;
  * Checks whether the given value is a string.
  *
  * @param value Value to check.
+ *
  * @returns `true` if the value is a string, `false` otherwise.
  */
 export declare const isString: (value: unknown) => value is string;

package/dist/types/validator/helpers.d.ts

@@ -3,7 +3,7 @@
  * - `{ valid: true }` for valid and _fully supported_ modifier;
  * - `{ valid: true, warn: <deprecation notice> }` for valid
  *   and _still supported but deprecated_ modifier;
- * - otherwise `{ valid: true, error: <invalidity reason> }`
+ * - otherwise `{ valid: true, error: <invalidity reason> }`.
  */
 export type ValidationResult = {
     valid: boolean;

package/dist/types/validator/index.d.ts

@@ -1,9 +1,9 @@
 /**
  * @file Validator for modifiers.
  */
+import { type AnyPlatform } from '../compatibility-tables/index.js';
 import { type Modifier } from '../nodes/index.js';
 import { type ValidationResult } from './helpers.js';
-import { type AnyPlatform } from '../compatibility-tables/index.js';
 /**
  * Modifier validator class.
  */
@@ -28,10 +28,10 @@ declare class ModifierValidator {
      * @param isException Whether the modifier is used in exception rule, default to false.
      * Needed to check whether the modifier is allowed only in blocking or exception rules.
      *
+     * @returns Result of modifier validation.
+     *
      * @note For single product: specific platforms use exact lookup, generic platforms use first match.
      * If multiple products are specified (e.g., AdgAny | UboAny), validation is skipped and returns valid.
-     *
-     * @returns Result of modifier validation.
      */
     validate: (platforms: AnyPlatform, modifier: Modifier, isException?: boolean) => ValidationResult;
 }

package/dist/types/version.d.ts

@@ -1,5 +1,5 @@
 /**
- * @file AGTree version
+ * @file AGTree version.
  */
 declare const AGTREE_VERSION: string;
 export { AGTREE_VERSION };

package/dist/utils/adblockers.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.3 (build date: Tue, 24 Mar 2026 15:29:20 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -18,7 +18,7 @@ const AdblockProduct = {
      */
     Abp: 'AdblockPlus',
     /**
-     * uBlock Origin.
+     * UBlock Origin..
      *
      * @see {@link https://github.com/gorhill/uBlock}
      */
@@ -31,7 +31,7 @@ const AdblockProduct = {
     Adg: 'AdGuard',
 };
 /**
- * Possible adblock syntaxes (supported by this library)
+ * Possible adblock syntaxes (supported by this library).
  */
 const AdblockSyntax = {
     /**
@@ -49,29 +49,32 @@ const AdblockSyntax = {
     /**
      * Adblock Plus syntax.
      *
+     * @see {@link https://adblockplus.org/}
+     *
      * @example
      * - `example.org#$#abort-on-property-read alert` is an Adblock Plus syntax, since it is not used by any other
      * adblockers directly (probably supported by some on-the-fly conversion, but this is not the native syntax).
-     * @see {@link https://adblockplus.org/}
      */
     Abp: AdblockProduct.Abp,
     /**
-     * uBlock Origin syntax.
+     * UBlock Origin syntax..
+     *
+     * @see {@link https://github.com/gorhill/uBlock}
      *
      * @example
      * - `example.com##+js(set, atob, noopFunc)` is an uBlock Origin syntax, since it is not used by any other
      * adblockers directly (probably supported by some on-the-fly conversion, but this is not the native syntax).
-     * @see {@link https://github.com/gorhill/uBlock}
      */
     Ubo: AdblockProduct.Ubo,
     /**
      * AdGuard syntax.
      *
+     * @see {@link https://adguard.com/}
+     *
      * @example
      * - `example.org#%#//scriptlet("abort-on-property-read", "alert")` is an AdGuard syntax, since it is not used
      * by any other adblockers directly (probably supported by some on-the-fly conversion, but this is not the native
      * syntax).
-     * @see {@link https://adguard.com/}
      */
     Adg: AdblockProduct.Adg,
 };

package/dist/utils/bit-count.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.3 (build date: Tue, 24 Mar 2026 15:29:20 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/utils/categorizer.js

@@ -1,12 +1,12 @@
 /*
- * AGTree v4.0.1 (build date: Thu, 19 Feb 2026 05:13:05 GMT)
+ * AGTree v4.0.3 (build date: Tue, 24 Mar 2026 15:29:20 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 import { CosmeticRuleParser } from '../parser/cosmetic/cosmetic-rule-parser.js';
-import { isNull } from './type-guards.js';
 import { defaultParserOptions } from '../parser/options.js';
+import { isNull } from './type-guards.js';
 
 /**
  * Utility functions for categorizing rules.