@adguard/agtree 3.0.0 → 3.1.0

package/dist/utils/index.js

@@ -0,0 +1,21 @@
+/*
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+export { ADG_SCRIPTLET_MASK, AGLINT_COMMAND_PREFIX, COMMA, COMMA_DOMAIN_LIST_SEPARATOR, HINT_MARKER, IF, INCLUDE, MODIFIERS_SEPARATOR, MODIFIER_ASSIGN_OPERATOR, NEGATION_MARKER, NETWORK_RULE_EXCEPTION_MARKER, NETWORK_RULE_SEPARATOR, PIPE, PIPE_MODIFIER_SEPARATOR, PREPROCESSOR_MARKER, SAFARI_CB_AFFINITY, UBO_SCRIPTLET_MASK } from './constants.js';
+export { BINARY_SCHEMA_VERSION } from './binary-schema-version.js';
+export { AdblockSyntax } from './adblockers.js';
+export { CosmeticRuleSeparatorUtils } from './cosmetic-rule-separator.js';
+export { DomainUtils } from './domain.js';
+export { LogicalExpressionUtils } from './logical-expression.js';
+export { ADBLOCK_URL_SEPARATOR, ADBLOCK_URL_SEPARATOR_REGEX, ADBLOCK_URL_START, ADBLOCK_URL_START_REGEX, ADBLOCK_WILDCARD, ADBLOCK_WILDCARD_REGEX, RegExpUtils, SPECIAL_REGEX_SYMBOLS } from './regexp.js';
+export { QuoteType, QuoteUtils } from './quotes.js';
+export { PositionProvider } from './position-provider.js';
+export { OutputByteBuffer } from './output-byte-buffer.js';
+export { InputByteBuffer } from './input-byte-buffer.js';
+export { ByteBuffer } from './byte-buffer.js';
+export { encodeIntoPolyfill } from './text-encoder-polyfill.js';
+export { decodeTextPolyfill } from './text-decoder-polyfill.js';
+export { RuleCategorizer } from './categorizer.js';

package/dist/{esm/utils/input-byte-buffer.mjs → utils/input-byte-buffer.js}

@@ -1,15 +1,15 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { ByteBuffer } from './byte-buffer.mjs';
-import { isArrayOfUint8Arrays } from './type-guards.mjs';
-import { isChromium } from './is-chromium.mjs';
-import { decodeTextPolyfill } from './text-decoder-polyfill.mjs';
-import { BINARY_SCHEMA_VERSION } from './binary-schema-version.mjs';
-import { BinarySchemaMismatchError } from '../errors/binary-schema-mismatch-error.mjs';
+import { ByteBuffer } from './byte-buffer.js';
+import { isArrayOfUint8Arrays } from './type-guards.js';
+import { isChromium } from './is-chromium.js';
+import { decodeTextPolyfill } from './text-decoder-polyfill.js';
+import { BINARY_SCHEMA_VERSION } from './binary-schema-version.js';
+import { BinarySchemaMismatchError } from '../errors/binary-schema-mismatch-error.js';
 
 /* eslint-disable max-len */
 /* eslint-disable no-plusplus */
@@ -52,6 +52,7 @@ class InputByteBuffer extends ByteBuffer {
      */
     constructor(chunks, cloneChunks = false, initialOffset = 0) {
         super(chunks, cloneChunks);
+        // TODO: Consider accepting an empty array of chunks
         // Check binary schema version
         if (chunks.length === 0) {
             throw new Error('No data in the buffer');
@@ -252,6 +253,14 @@ class InputByteBuffer extends ByteBuffer {
     get capacity() {
         return this.chunks.length * ByteBuffer.CHUNK_SIZE;
     }
+    /**
+     * Gets the chunks of the buffer.
+     *
+     * @returns Chunks of the buffer.
+     */
+    getChunks() {
+        return this.chunks;
+    }
 }
 
 export { InputByteBuffer };

package/dist/{esm/utils/is-chromium.mjs → utils/is-chromium.js}

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/{esm/utils/logical-expression.mjs → utils/logical-expression.js}

@@ -1,11 +1,11 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { OperatorValue } from '../nodes/index.mjs';
-import { NodeType } from '../parser/misc/logical-expression-parser.mjs';
+import { OperatorValue } from '../nodes/index.js';
+import { NodeType } from '../parser/misc/logical-expression-parser.js';
 
 /**
  * @file Utility functions for logical expression node.

package/dist/{esm/utils/multi-value-map.mjs → utils/multi-value-map.js}

@@ -1,10 +1,10 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { isUndefined } from './type-guards.mjs';
+import { isUndefined } from './type-guards.js';
 
 /**
  * A very simple map extension that allows to store multiple values for the same key

package/dist/{esm/utils/output-byte-buffer.mjs → utils/output-byte-buffer.js}

@@ -1,13 +1,13 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { BINARY_SCHEMA_VERSION } from './binary-schema-version.mjs';
-import { ByteBuffer } from './byte-buffer.mjs';
-import { isChromium } from './is-chromium.mjs';
-import { encodeIntoPolyfill } from './text-encoder-polyfill.mjs';
+import { BINARY_SCHEMA_VERSION } from './binary-schema-version.js';
+import { ByteBuffer } from './byte-buffer.js';
+import { isChromium } from './is-chromium.js';
+import { encodeIntoPolyfill } from './text-encoder-polyfill.js';
 
 /* eslint-disable no-plusplus */
 /* eslint-disable no-bitwise */
@@ -218,6 +218,14 @@ class OutputByteBuffer extends ByteBuffer {
     get currentOffset() {
         return this.offset;
     }
+    /**
+     * Gets the chunks of the buffer.
+     *
+     * @returns Chunks of the buffer.
+     */
+    getChunks() {
+        return this.chunks;
+    }
 }
 
 export { OutputByteBuffer };

package/dist/{esm/utils/position-provider.mjs → utils/position-provider.js}

@@ -1,10 +1,10 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { LF, FF, CR } from './constants.mjs';
+import { LF, FF, CR } from './constants.js';
 
 /**
  * @file Position provider class.

package/dist/{esm/utils/quotes.mjs → utils/quotes.js}

@@ -1,10 +1,10 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { ESCAPE_CHARACTER, SINGLE_QUOTE, DOUBLE_QUOTE, BACKTICK_QUOTE, COMMA, SPACE, EMPTY } from './constants.mjs';
+import { ESCAPE_CHARACTER, EMPTY, SINGLE_QUOTE, DOUBLE_QUOTE, BACKTICK_QUOTE, COMMA, SPACE } from './constants.js';
 
 /**
  * @file Utility functions for working with quotes
@@ -20,25 +20,24 @@ const QUOTE_SET = new Set([
 /**
  * Possible quote types for scriptlet parameters
  */
-var QuoteType;
-(function (QuoteType) {
+const QuoteType = {
     /**
      * No quotes at all
      */
-    QuoteType["None"] = "none";
+    None: 'none',
     /**
      * Single quotes (`'`)
      */
-    QuoteType["Single"] = "single";
+    Single: 'single',
     /**
      * Double quotes (`"`)
      */
-    QuoteType["Double"] = "double";
+    Double: 'double',
     /**
      * Backtick quotes (`` ` ``)
      */
-    QuoteType["Backtick"] = "backtick";
-})(QuoteType || (QuoteType = {}));
+    Backtick: 'backtick',
+};
 /**
  * Utility functions for working with quotes
  */

package/dist/{esm/utils/regexp.mjs → utils/regexp.js}

@@ -1,10 +1,10 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { PIPE, CARET, ASTERISK, CLOSE_CURLY_BRACKET, CLOSE_PARENTHESIS, CLOSE_SQUARE_BRACKET, DOLLAR_SIGN, DOT, ESCAPE_CHARACTER, OPEN_CURLY_BRACKET, OPEN_PARENTHESIS, OPEN_SQUARE_BRACKET, PLUS, QUESTION_MARK, SLASH, REGEX_MARKER, EMPTY } from './constants.mjs';
+import { CARET, ASTERISK, PIPE, DOT, CLOSE_CURLY_BRACKET, CLOSE_PARENTHESIS, CLOSE_SQUARE_BRACKET, DOLLAR_SIGN, ESCAPE_CHARACTER, OPEN_CURLY_BRACKET, OPEN_PARENTHESIS, OPEN_SQUARE_BRACKET, PLUS, QUESTION_MARK, SLASH, REGEX_MARKER, EMPTY } from './constants.js';
 
 /**
  * @file Regular expression utilities
@@ -67,6 +67,36 @@ class RegExpUtils {
             && trimmedPattern.endsWith(REGEX_MARKER)
             && trimmedPattern[REGEX_MARKER.length - 2] !== ESCAPE_CHARACTER;
     }
+    /**
+     * 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
+     */
+    static isNegatedRegexPattern(pattern) {
+        if (pattern.startsWith(REGEX_MARKER) && pattern.endsWith(REGEX_MARKER)) {
+            const innerPattern = pattern.slice(REGEX_MARKER.length, pattern.length - REGEX_MARKER.length);
+            return innerPattern.startsWith(REGEX_NEGATION_PREFIX) && innerPattern.endsWith(REGEX_NEGATION_SUFFIX);
+        }
+        return pattern.startsWith(REGEX_NEGATION_PREFIX) && pattern.endsWith(REGEX_NEGATION_SUFFIX);
+    }
+    /**
+     * Removes negation from a RegExp pattern.
+     *
+     * @param pattern - RegExp pattern to remove negation from
+     * @returns RegExp pattern without negation
+     */
+    static removeNegationFromRegexPattern(pattern) {
+        let result = pattern.trim();
+        const slashes = RegExpUtils.isRegexPattern(result);
+        if (slashes) {
+            result = result.substring(REGEX_MARKER.length, result.length - REGEX_MARKER.length);
+        }
+        if (result.startsWith(REGEX_NEGATION_PREFIX) && result.endsWith(REGEX_NEGATION_SUFFIX)) {
+            result = result.substring(REGEX_NEGATION_PREFIX.length, result.length - REGEX_NEGATION_SUFFIX.length);
+        }
+        return slashes ? `${REGEX_MARKER}${result}${REGEX_MARKER}` : result;
+    }
     /**
      * Negates a RegExp pattern. Technically, this method wraps the pattern in `^((?!` and `).)*$`.
      *
@@ -102,6 +132,22 @@ class RegExpUtils {
         }
         return result;
     }
+    /**
+     * Ensures that a pattern is wrapped in slashes.
+     *
+     * @param pattern Pattern to ensure slashes for
+     * @returns Pattern with slashes
+     */
+    static ensureSlashes(pattern) {
+        let result = pattern;
+        if (!result.startsWith(REGEX_MARKER)) {
+            result = `${REGEX_MARKER}${result}`;
+        }
+        if (!result.endsWith(REGEX_MARKER)) {
+            result += REGEX_MARKER;
+        }
+        return result;
+    }
     /**
      * 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

package/dist/{esm/utils/string.mjs → utils/string.js}

@@ -1,16 +1,19 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { ESCAPE_CHARACTER, REGEX_MARKER, SPACE, TAB, NUMBER_0, NUMBER_9, SMALL_LETTER_A, SMALL_LETTER_Z, CAPITAL_LETTER_A, CAPITAL_LETTER_Z, CR, LF, FF, EMPTY, CRLF } from './constants.mjs';
+import { ESCAPE_CHARACTER, REGEX_MARKER, SPACE, TAB, NUMBER_0, NUMBER_9, SMALL_LETTER_A, SMALL_LETTER_Z, CAPITAL_LETTER_A, CAPITAL_LETTER_Z, EMPTY, CR, LF, FF, CRLF } from './constants.js';
 
 /**
  * @file Utility functions for string manipulation.
  */
 const SINGLE_QUOTE_MARKER = "'";
 const DOUBLE_QUOTE_MARKER = '"';
+/**
+ * Utility functions for string manipulation.
+ */
 class StringUtils {
     /**
      * Finds the first occurrence of a character that:

package/dist/{esm/utils/text-decoder-polyfill.mjs → utils/text-decoder-polyfill.js}

@@ -1,10 +1,10 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { EMPTY } from './constants.mjs';
+import { EMPTY } from './constants.js';
 
 /* eslint-disable no-plusplus */
 /* eslint-disable no-bitwise */

package/dist/{esm/utils/text-encoder-polyfill.mjs → utils/text-encoder-polyfill.js}

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/{esm/utils/type-guards.mjs → utils/type-guards.js}

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/{esm/validator/constants.mjs → validator/constants.js}

@@ -1,11 +1,11 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { AdblockSyntax } from '../utils/adblockers.mjs';
-import { CAPITAL_LETTERS, SMALL_LETTERS, NUMBERS, UNDERSCORE, OPEN_PARENTHESIS, CLOSE_PARENTHESIS } from '../utils/constants.mjs';
+import { AdblockSyntax } from '../utils/adblockers.js';
+import { CAPITAL_LETTERS, SMALL_LETTERS, NUMBERS, UNDERSCORE, OPEN_PARENTHESIS, CLOSE_PARENTHESIS } from '../utils/constants.js';
 
 /**
  * Prefixes for different adblockers to describe the platform-specific modifiers data

package/dist/{esm/validator/helpers.mjs → validator/helpers.js}

@@ -1,11 +1,11 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { UNDERSCORE } from '../utils/constants.mjs';
-import { VALIDATION_ERROR_PREFIX } from './constants.mjs';
+import { UNDERSCORE } from '../utils/constants.js';
+import { VALIDATION_ERROR_PREFIX } from './constants.js';
 
 /**
  * Validates the noop modifier (i.e. only underscores).

package/dist/{esm/validator/index.mjs → validator/index.js}

@@ -1,17 +1,17 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { AdblockSyntax } from '../utils/adblockers.mjs';
-import { UNDERSCORE, NEWLINE, SPACE } from '../utils/constants.mjs';
-import { VALIDATION_ERROR_PREFIX, SOURCE_DATA_ERROR_PREFIX, BLOCKER_PREFIX } from './constants.mjs';
-import { isValidNoopModifier, getInvalidValidationResult, getValueRequiredValidationResult } from './helpers.mjs';
-import { validateValue } from './value.mjs';
-import { clone } from '../utils/clone.mjs';
-import { modifiersCompatibilityTable } from '../compatibility-tables/modifiers.mjs';
-import { GenericPlatform } from '../compatibility-tables/platforms.mjs';
+import { AdblockSyntax } from '../utils/adblockers.js';
+import { UNDERSCORE, NEWLINE, SPACE } from '../utils/constants.js';
+import { VALIDATION_ERROR_PREFIX, SOURCE_DATA_ERROR_PREFIX, BLOCKER_PREFIX } from './constants.js';
+import { isValidNoopModifier, getInvalidValidationResult, getValueRequiredValidationResult } from './helpers.js';
+import { validateValue } from './value.js';
+import { clone } from '../utils/clone.js';
+import { modifiersCompatibilityTable } from '../compatibility-tables/modifiers.js';
+import { GenericPlatform } from '../compatibility-tables/platforms.js';
 
 /**
  * @file Validator for modifiers.
@@ -106,7 +106,7 @@ const validateForSpecificSyntax = (syntax, modifier, isException) => {
         if (!specificBlockerData.valueFormat) {
             throw new Error(`${SOURCE_DATA_ERROR_PREFIX.NO_VALUE_FORMAT_FOR_ASSIGNABLE}: '${modifierName}'`);
         }
-        return validateValue(modifier, specificBlockerData.valueFormat);
+        return validateValue(modifier, specificBlockerData.valueFormat, specificBlockerData.valueFormatFlags);
     }
     if (modifier?.value) {
         // e.g. 'third-party=true'

package/dist/{esm/validator/value.mjs → validator/value.js}

@@ -1,37 +1,36 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import XRegExp from 'xregexp';
-import { AdblockSyntaxError } from '../errors/adblock-syntax-error.mjs';
-import { AppListParser } from '../parser/misc/app-list-parser.mjs';
-import { DomainListParser } from '../parser/misc/domain-list-parser.mjs';
-import { MethodListParser } from '../parser/misc/method-list-parser.mjs';
-import { StealthOptionListParser } from '../parser/misc/stealth-option-list-parser.mjs';
-import { DomainUtils } from '../utils/domain.mjs';
-import { QuoteUtils, QuoteType } from '../utils/quotes.mjs';
-import { SEMICOLON, SPACE, BACKSLASH, COMMA, PIPE, EQUALS, WILDCARD, DOT, OPEN_PARENTHESIS, CLOSE_PARENTHESIS } from '../utils/constants.mjs';
-import { getValueRequiredValidationResult, getInvalidValidationResult } from './helpers.mjs';
-import { VALIDATION_ERROR_PREFIX, ALLOWED_CSP_DIRECTIVES, REFERRER_POLICY_DIRECTIVES, ALLOWED_PERMISSION_DIRECTIVES, ALLOWED_METHODS, ALLOWED_STEALTH_OPTIONS, EMPTY_PERMISSIONS_ALLOWLIST, APP_NAME_ALLOWED_CHARS, PERMISSIONS_TOKEN_SELF, SOURCE_DATA_ERROR_PREFIX } from './constants.mjs';
-import { defaultParserOptions } from '../parser/options.mjs';
+import { AdblockSyntaxError } from '../errors/adblock-syntax-error.js';
+import { AppListParser } from '../parser/misc/app-list-parser.js';
+import { DomainListParser } from '../parser/misc/domain-list-parser.js';
+import { MethodListParser } from '../parser/misc/method-list-parser.js';
+import { StealthOptionListParser } from '../parser/misc/stealth-option-list-parser.js';
+import { DomainUtils } from '../utils/domain.js';
+import { QuoteUtils, QuoteType } from '../utils/quotes.js';
+import { BACKSLASH, COMMA, SEMICOLON, SPACE, PIPE, EQUALS, WILDCARD, OPEN_PARENTHESIS, CLOSE_PARENTHESIS, DOT } from '../utils/constants.js';
+import { getValueRequiredValidationResult, getInvalidValidationResult } from './helpers.js';
+import { SOURCE_DATA_ERROR_PREFIX, VALIDATION_ERROR_PREFIX, REFERRER_POLICY_DIRECTIVES, ALLOWED_CSP_DIRECTIVES, ALLOWED_PERMISSION_DIRECTIVES, EMPTY_PERMISSIONS_ALLOWLIST, PERMISSIONS_TOKEN_SELF, ALLOWED_METHODS, ALLOWED_STEALTH_OPTIONS, APP_NAME_ALLOWED_CHARS } from './constants.js';
+import { defaultParserOptions } from '../parser/options.js';
+import { isString } from '../utils/type-guards.js';
 
 /**
  * Pre-defined available validators for modifiers with custom `value_format`.
  */
-var CustomValueFormatValidatorName;
-(function (CustomValueFormatValidatorName) {
-    CustomValueFormatValidatorName["App"] = "pipe_separated_apps";
-    CustomValueFormatValidatorName["Csp"] = "csp_value";
+const CustomValueFormatValidatorName = {
+    App: 'pipe_separated_apps',
+    Csp: 'csp_value',
     // there are some differences between $domain and $denyallow
-    CustomValueFormatValidatorName["DenyAllow"] = "pipe_separated_denyallow_domains";
-    CustomValueFormatValidatorName["Domain"] = "pipe_separated_domains";
-    CustomValueFormatValidatorName["Method"] = "pipe_separated_methods";
-    CustomValueFormatValidatorName["Permissions"] = "permissions_value";
-    CustomValueFormatValidatorName["ReferrerPolicy"] = "referrerpolicy_value";
-    CustomValueFormatValidatorName["StealthOption"] = "pipe_separated_stealth_options";
-})(CustomValueFormatValidatorName || (CustomValueFormatValidatorName = {}));
+    DenyAllow: 'pipe_separated_denyallow_domains',
+    Domain: 'pipe_separated_domains',
+    Method: 'pipe_separated_methods',
+    Permissions: 'permissions_value',
+    ReferrerPolicy: 'referrerpolicy_value',
+    StealthOption: 'pipe_separated_stealth_options',
+};
 /**
  * Checks whether the `chunk` of app name (which if splitted by dot `.`) is valid.
  * Only letters, numbers, and underscore `_` are allowed.
@@ -534,10 +533,11 @@ const isCustomValueFormatValidator = (valueFormat) => {
  *
  * @param modifier Modifier AST node.
  * @param valueFormat Value format for the modifier.
+ * @param valueFormatFlags Optional; RegExp flags for the value format.
  *
  * @returns Validation result.
  */
-const validateValue = (modifier, valueFormat) => {
+const validateValue = (modifier, valueFormat, valueFormatFlags) => {
     if (isCustomValueFormatValidator(valueFormat)) {
         const validator = CUSTOM_VALUE_FORMAT_MAP[valueFormat];
         return validator(modifier);
@@ -546,14 +546,19 @@ const validateValue = (modifier, valueFormat) => {
     if (!modifier.value?.value) {
         return getValueRequiredValidationResult(modifierName);
     }
-    let xRegExp;
+    let regExp;
     try {
-        xRegExp = XRegExp(valueFormat);
+        if (isString(valueFormatFlags)) {
+            regExp = new RegExp(valueFormat, valueFormatFlags);
+        }
+        else {
+            regExp = new RegExp(valueFormat);
+        }
     }
     catch (e) {
         throw new Error(`${SOURCE_DATA_ERROR_PREFIX.INVALID_VALUE_FORMAT_REGEXP}: '${modifierName}'`);
     }
-    const isValid = xRegExp.test(modifier.value?.value);
+    const isValid = regExp.test(modifier.value?.value);
     if (!isValid) {
         return getInvalidValidationResult(`${VALIDATION_ERROR_PREFIX.VALUE_INVALID}: '${modifierName}'`);
     }

package/dist/{esm/version.mjs → version.js}

@@ -1,10 +1,10 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { version } from './package.json.mjs';
+import { version } from './package.json.js';
 
 /**
  * @file AGTree version