@adguard/agtree 4.0.0 → 4.0.2

package/dist/parser/cosmetic/selector/handlers/complex-selector-handler.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/parser/cosmetic/selector/handlers/compound-selector-handler.js

@@ -1,11 +1,11 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { sprintf } from 'sprintf-js';
 import { getFormattedTokenName } from '@adguard/css-tokenizer';
+import { sprintf } from 'sprintf-js';
 import { AdblockSyntaxError } from '../../../../errors/adblock-syntax-error.js';
 import { GREATER_THAN, PLUS, TILDE, COMMA, SPACE } from '../../../../utils/constants.js';
 

package/dist/parser/cosmetic/selector/handlers/id-selector-handler.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/parser/cosmetic/selector/handlers/pseudo-class-selector-handler.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -58,6 +58,8 @@ class PseudoClassSelectorHandler {
         }
         // If it's a function, parse its argument
         if (isFunction) {
+            // Save the function token's balance level for finding the matching close parenthesis
+            const functionBalance = stream.getBalance();
             // Advance pseudo-class selector name token
             stream.advance();
             // Get pseudo-class selector argument token
@@ -78,8 +80,8 @@ class PseudoClassSelectorHandler {
             token = stream.getOrFail();
             // Check if there is any argument part
             if (token.type !== TokenType.CloseParenthesis) {
-                // Save the balance level to find the matching closing parenthesis
-                const balance = stream.getBalance();
+                // Use the function token's balance level to find the matching closing parenthesis
+                const balance = functionBalance;
                 // Skip leading whitespace
                 stream.skipWhitespace();
                 // Get argument token

package/dist/parser/cosmetic/selector/handlers/type-selector-handler.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/parser/cosmetic/selector/selector-list-parser.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -11,24 +11,24 @@ import { SPACE, TILDE, PLUS, GREATER_THAN, DOT, ASTERISK } from '../../../utils/
 import { BaseParser } from '../../base-parser.js';
 import { CssTokenStream } from '../../css/css-token-stream.js';
 import { defaultParserOptions } from '../../options.js';
-import { TypeSelectorHandler } from './handlers/type-selector-handler.js';
-import { IdSelectorHandler } from './handlers/id-selector-handler.js';
 import { AttributeSelectorHandler } from './handlers/attribute-selector-handler.js';
-import { PseudoClassSelectorHandler } from './handlers/pseudo-class-selector-handler.js';
 import { ClassSelectorHandler } from './handlers/class-selector-handler.js';
-import { CompoundSelectorHandler } from './handlers/compound-selector-handler.js';
 import { ComplexSelectorHandler } from './handlers/complex-selector-handler.js';
+import { CompoundSelectorHandler } from './handlers/compound-selector-handler.js';
+import { IdSelectorHandler } from './handlers/id-selector-handler.js';
+import { PseudoClassSelectorHandler } from './handlers/pseudo-class-selector-handler.js';
+import { TypeSelectorHandler } from './handlers/type-selector-handler.js';
 
 /**
  * Class responsible for parsing selector lists.
  *
  * Please note that the parser will parse any selector list if it is syntactically correct.
- * For example, it will parse this:
+ * For example, it will parse this:.
  * ```adblock
  * div[attr1="value1"] > h1[attr2="value2"], span[attr3="value3"]
  * ```
  *
- * but it didn't check if the given attribute or pseudo-class is valid or not.
+ * But it didn't check if the given attribute or pseudo-class is valid or not..
  *
  * @see {@link https://www.w3.org/TR/selectors-4/#selector-list}'
  */

package/dist/parser/css/adg-css-injection-parser.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -8,9 +8,9 @@ import { TokenType } from '@adguard/css-tokenizer';
 import { REMOVE_PROPERTY, REMOVE_VALUE } from '../../converter/data/css.js';
 import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
 import { CSS_MEDIA_MARKER, EMPTY } from '../../utils/constants.js';
-import { CssTokenStream } from './css-token-stream.js';
-import { defaultParserOptions } from '../options.js';
 import { BaseParser } from '../base-parser.js';
+import { defaultParserOptions } from '../options.js';
+import { CssTokenStream } from './css-token-stream.js';
 
 /**
  * @file Parser for AdGuard CSS injections.
@@ -32,6 +32,7 @@ class AdgCssInjectionParser extends BaseParser {
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
      *
      * @returns Parsed AdGuard CSS injection {@link CssInjectionRuleBody}.
+     *
      * @throws An {@link AdblockSyntaxError} if the selector list is syntactically invalid.
      */
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {

package/dist/parser/css/balancing.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
@@ -32,13 +32,15 @@ const functionTokenPairs = new Map([
 /**
  * Helper function to tokenize and ensure balanced pairs.
  *
- * @param raw Raw CSS string to tokenize
- * @param onToken Callback which will be invoked for each token, extended with a `balance` parameter
- * @param onError Error callback which is called when a parsing error is found (optional)
- * @param functionHandlers Custom function handlers (optional)
- * @param tokenPairs Map of opening tokens to their corresponding closing tokens
- * @throws If the input is not balanced
- * @todo Consider adding a `tolerant` flag if error throwing seems too aggressive in the future
+ * @param raw Raw CSS string to tokenize.
+ * @param onToken Callback which will be invoked for each token, extended with a `balance` parameter.
+ * @param onError Error callback which is called when a parsing error is found (optional).
+ * @param functionHandlers Custom function handlers (optional).
+ * @param tokenPairs Map of opening tokens to their corresponding closing tokens.
+ *
+ * @throws If the input is not balanced.
+ *
+ * @todo Consider adding a `tolerant` flag if error throwing seems too aggressive in the future.
  */
 const tokenizeWithBalancedPairs = (raw, onToken, onError = () => { }, functionHandlers, tokenPairs = standardTokenPairs) => {
     const stack = [];
@@ -69,11 +71,12 @@ const tokenizeWithBalancedPairs = (raw, onToken, onError = () => { }, functionHa
 /**
  * Tokenize and ensure balanced pairs for standard CSS.
  *
- * @param raw Raw CSS string to tokenize
- * @param onToken Callback which will be invoked for each token, extended with a `balance` parameter
- * @param onError Error callback which is called when a parsing error is found (optional)
- * @param functionHandlers Custom function handlers (optional)
- * @throws If the input is not balanced
+ * @param raw Raw CSS string to tokenize.
+ * @param onToken Callback which will be invoked for each token, extended with a `balance` parameter.
+ * @param onError Error callback which is called when a parsing error is found (optional).
+ * @param functionHandlers Custom function handlers (optional).
+ *
+ * @throws If the input is not balanced.
  */
 const tokenizeBalanced = (raw, onToken, onError = () => { }, functionHandlers) => {
     tokenizeWithBalancedPairs(raw, onToken, onError, functionHandlers);
@@ -81,11 +84,12 @@ const tokenizeBalanced = (raw, onToken, onError = () => { }, functionHandlers) =
 /**
  * Tokenize and ensure balanced pairs for function calls.
  *
- * @param raw Raw CSS string to tokenize
- * @param onToken Callback which will be invoked for each token, extended with a `balance` parameter
- * @param onError Error callback which is called when a parsing error is found (optional)
- * @param functionHandlers Custom function handlers (optional)
- * @throws If the input is not balanced
+ * @param raw Raw CSS string to tokenize.
+ * @param onToken Callback which will be invoked for each token, extended with a `balance` parameter.
+ * @param onError Error callback which is called when a parsing error is found (optional).
+ * @param functionHandlers Custom function handlers (optional).
+ *
+ * @throws If the input is not balanced.
  */
 const tokenizeFnBalanced = (raw, onToken, onError = () => { }, functionHandlers) => {
     tokenizeWithBalancedPairs(raw, onToken, onError, functionHandlers, functionTokenPairs);

package/dist/parser/css/constants.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/parser/css/css-token-stream.js

@@ -1,16 +1,16 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 import { TokenType, getFormattedTokenName, tokenizeExtended } from '@adguard/css-tokenizer';
 import { sprintf } from 'sprintf-js';
-import { tokenizeBalanced } from './balancing.js';
-import { EMPTY } from '../../utils/constants.js';
+import { EXT_CSS_PSEUDO_CLASSES, EXT_CSS_PSEUDO_CLASSES_STRICT, NATIVE_CSS_PSEUDO_CLASSES, LEGACY_EXT_CSS_ATTRIBUTE_PREFIX, ABP_EXT_CSS_PREFIX } from '../../converter/data/css.js';
 import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
+import { EMPTY } from '../../utils/constants.js';
+import { tokenizeBalanced } from './balancing.js';
 import { ERROR_MESSAGES, END_OF_INPUT } from './constants.js';
-import { EXT_CSS_PSEUDO_CLASSES, EXT_CSS_PSEUDO_CLASSES_STRICT, NATIVE_CSS_PSEUDO_CLASSES, LEGACY_EXT_CSS_ATTRIBUTE_PREFIX, ABP_EXT_CSS_PREFIX } from '../../converter/data/css.js';
 
 /**
  * @file CSS token stream.
@@ -92,6 +92,7 @@ class CssTokenStream {
      * Gets the token at the specified index.
      *
      * @param index The index of the token to retrieve.
+     *
      * @returns The token at the specified index or undefined if the index is out of bounds.
      */
     get(index = this.index) {
@@ -101,7 +102,9 @@ class CssTokenStream {
      * Gets the token at the specified index or throws if no token is found at the specified index.
      *
      * @param index The index of the token to retrieve.
+     *
      * @returns The token at the specified index or undefined if the index is out of bounds.
+     *
      * @throws If no token is found at the specified index.
      */
     getOrFail(index = this.index) {
@@ -115,6 +118,7 @@ class CssTokenStream {
      * Gets the source fragment of the token at the specified index.
      *
      * @param index The index of the token to retrieve the fragment for.
+     *
      * @returns The source fragment of the token or an empty string if the index is out of bounds.
      */
     fragment(index = this.index) {
@@ -140,6 +144,7 @@ class CssTokenStream {
      * Looks ahead in the stream without changing the index.
      *
      * @param index The relative index to look ahead to, starting from the current index.
+     *
      * @returns The next token or undefined if the end of the stream is reached.
      */
     lookahead(index = 1) {
@@ -149,6 +154,7 @@ class CssTokenStream {
      * Looks behind in the stream without changing the index.
      *
      * @param index The relative index to look behind to, starting from the current index.
+     *
      * @returns The previous token or undefined if the current token is the first in the stream.
      */
     lookbehind(index = 1) {
@@ -207,6 +213,7 @@ class CssTokenStream {
      *
      * @param type The type of token to skip until.
      * @param balance The balance level of the token to skip until.
+     *
      * @returns The number of tokens skipped.
      */
     skipUntil(type, balance) {
@@ -225,6 +232,7 @@ class CssTokenStream {
      *
      * @param type The type of token to skip until.
      * @param balance The balance level of the token to skip until.
+     *
      * @returns An array containing the number of tokens skipped and the number of tokens skipped without leading and
      * trailing whitespace tokens.
      */
@@ -268,6 +276,7 @@ class CssTokenStream {
      *
      * @param type The expected token type.
      * @param data Optional expectation data.
+     *
      * @throws If the end of the stream is reached or if the token type or expectation data does not match.
      */
     expect(type, data) {
@@ -289,6 +298,7 @@ class CssTokenStream {
      * Gets the balance level of the token at the specified index.
      *
      * @param index The index of the token to retrieve the balance level for.
+     *
      * @returns The balance level of the token or 0 if the index is out of bounds.
      */
     getBalance(index = this.index) {
@@ -327,6 +337,7 @@ class CssTokenStream {
      * and don't need the full `CssTokenStream` functionality.
      *
      * @param selector CSS selector string to check.
+     *
      * @returns True if the selector contains `:has()`, `:is()`, or `:not()`,
      * otherwise false.
      */

package/dist/parser/css/ubo-selector-parser.js

@@ -1,17 +1,17 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
 import { TokenType, getFormattedTokenName } from '@adguard/css-tokenizer';
 import { sprintf } from 'sprintf-js';
+import { UboPseudoName } from '../../common/ubo-selector-common.js';
 import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
 import { EMPTY, COLON, OPEN_PARENTHESIS, CSS_NOT_PSEUDO, CLOSE_PARENTHESIS } from '../../utils/constants.js';
-import { tokenizeFnBalanced } from './balancing.js';
-import { defaultParserOptions } from '../options.js';
 import { BaseParser } from '../base-parser.js';
-import { UboPseudoName } from '../../common/ubo-selector-common.js';
+import { defaultParserOptions } from '../options.js';
+import { tokenizeFnBalanced } from './balancing.js';
 
 /**
  * @file Parser for special uBO selectors.
@@ -50,6 +50,7 @@ const KNOWN_UBO_MODIFIERS = new Set([
  * in the hot path of the parser.
  *
  * @param raw Raw selector string.
+ *
  * @returns `true` if the selector has any uBO modifier, `false` otherwise.
  */
 const hasAnyUboModifier = (raw) => {
@@ -76,7 +77,9 @@ const hasAnyUboModifier = (raw) => {
  *
  * @param name Pseudo name.
  * @param wrapper Wrapper pseudo name (eg. `not`) (optional, defaults to `undefined`).
+ *
  * @returns Formatted pseudo name.
+ *
  * @example
  * ```ts
  * formatPseudoName('matches-path', 'not'); // => ':not(:matches-path(...))'
@@ -106,6 +109,7 @@ class UboSelectorParser extends BaseParser {
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
      *
      * @returns Parsed uBO selector {@link UboSelectorParser}.
+     *
      * @throws An {@link AdblockSyntaxError} if the selector list is syntactically invalid.
      */
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {

package/dist/parser/filterlist-parser.js

@@ -1,14 +1,14 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { RuleParser } from './rule-parser.js';
 import { CR, LF } from '../utils/constants.js';
 import { StringUtils } from '../utils/string.js';
-import { defaultParserOptions } from './options.js';
 import { BaseParser } from './base-parser.js';
+import { defaultParserOptions } from './options.js';
+import { RuleParser } from './rule-parser.js';
 
 /**
  * `FilterListParser` is responsible for parsing a whole adblock filter list (list of rules).
@@ -21,7 +21,11 @@ class FilterListParser extends BaseParser {
      * @param raw Raw input to parse.
      * @param options Global parser options.
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
-     * @returns AST of the source code (list of rules)
+     *
+     * @returns AST of the source code (list of rules).
+     *
+     * @throws If one of the rules is syntactically invalid (if `tolerant` is `false`).
+     *
      * @example
      * ```js
      * import { readFileSync } from 'fs';
@@ -33,7 +37,6 @@ class FilterListParser extends BaseParser {
      * // Parse the filter list content, then do something with the AST
      * const ast = FilterListParser.parse(content);
      * ```
-     * @throws If one of the rules is syntactically invalid (if `tolerant` is `false`)
      */
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {
         // Actual position in the source code

package/dist/parser/index.js

@@ -1,5 +1,5 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme

package/dist/parser/misc/app-list-parser.js

@@ -1,13 +1,13 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { PIPE } from '../../utils/constants.js';
 import { ListItemNodeType, ListNodeType } from '../../nodes/index.js';
-import { defaultParserOptions } from '../options.js';
+import { PIPE } from '../../utils/constants.js';
 import { BaseParser } from '../base-parser.js';
+import { defaultParserOptions } from '../options.js';
 import { ListItemsParser } from './list-items-parser.js';
 
 /**
@@ -25,6 +25,7 @@ class AppListParser extends BaseParser {
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
      *
      * @returns App list AST.
+     *
      * @throws An {@link AdblockSyntaxError} if the app list is syntactically invalid.
      * @throws An {@link Error} if the options are invalid.
      */

package/dist/parser/misc/domain-list-parser.js

@@ -1,34 +1,36 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { COMMA, PIPE } from '../../utils/constants.js';
 import { ListItemNodeType, ListNodeType } from '../../nodes/index.js';
-import { defaultParserOptions } from '../options.js';
+import { COMMA, PIPE } from '../../utils/constants.js';
 import { BaseParser } from '../base-parser.js';
+import { defaultParserOptions } from '../options.js';
 import { ListItemsParser } from './list-items-parser.js';
 
 /**
  * `DomainListParser` is responsible for parsing a domain list.
  *
+ * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#elemhide_domains}
+ *
  * @example
  * - If the rule is `example.com,~example.net##.ads`, the domain list is `example.com,~example.net`.
  * - If the rule is `ads.js^$script,domains=example.com|~example.org`, the domain list is `example.com|~example.org`.
  * This parser is responsible for parsing these domain lists.
- * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#elemhide_domains}
  */
 class DomainListParser extends BaseParser {
     /**
-     * Parses a domain list, eg. `example.com,example.org,~example.org`
+     * Parses a domain list, eg. `example.com,example.org,~example.org`.
      *
      * @param raw Raw input to parse.
      * @param options Global parser options.
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
-     * @param separator Separator character (default: comma)
+     * @param separator Separator character (default: comma).
      *
      * @returns Domain list AST.
+     *
      * @throws An {@link AdblockSyntaxError} if the domain list is syntactically invalid.
      * @throws An {@link Error} if the options are invalid.
      */

package/dist/parser/misc/list-items-parser.js

@@ -1,14 +1,14 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
+import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
 import { ListItemNodeType } from '../../nodes/index.js';
-import { defaultParserOptions } from '../options.js';
 import { COMMA, NEGATION_MARKER } from '../../utils/constants.js';
 import { StringUtils } from '../../utils/string.js';
-import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
+import { defaultParserOptions } from '../options.js';
 
 /**
  * Prefixes for error messages which are used for parsing of value lists.
@@ -29,15 +29,17 @@ class ListItemsParser {
      * Parses a `raw` modifier value which may be represented as a list of items separated by `separator`.
      * Needed for $app, $denyallow, $domain, $method.
      *
+     * @template T Type of the list items.
+     *
      * @param raw Raw input to parse.
      * @param options Global parser options.
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
-     * @param separator Separator character (default: comma)
+     * @param separator Separator character (default: comma).
      * @param type Type of the list items (default: {@link ListItemNodeType.Domain}).
-     * @template T Type of the list items.
      *
      * @returns List of parsed items.
-     * @throws An {@link AdblockSyntaxError} if the list is syntactically invalid
+     *
+     * @throws An {@link AdblockSyntaxError} if the list is syntactically invalid.
      *
      * @example
      * - parses an app list — `com.example.app|Example.exe`

package/dist/parser/misc/logical-expression-parser.js

@@ -1,15 +1,15 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { StringUtils } from '../../utils/string.js';
+import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
 import { OperatorValue } from '../../nodes/index.js';
 import { UNDERSCORE, OPEN_PARENTHESIS, CLOSE_PARENTHESIS, AMPERSAND, PIPE, EXCLAMATION_MARK } from '../../utils/constants.js';
-import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
-import { defaultParserOptions } from '../options.js';
+import { StringUtils } from '../../utils/string.js';
 import { BaseParser } from '../base-parser.js';
+import { defaultParserOptions } from '../options.js';
 
 /**
  * Possible token types in the logical expression.
@@ -50,10 +50,12 @@ class LogicalExpressionParser extends BaseParser {
     /**
      * Split the expression into tokens.
      *
-     * @param raw Source code of the expression
+     * @param raw Source code of the expression.
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
-     * @returns Token list
-     * @throws {AdblockSyntaxError} If the expression is invalid
+     *
+     * @returns Token list.
+     *
+     * @throws {AdblockSyntaxError} If the expression is invalid.
      */
     static tokenize(raw, baseOffset = 0) {
         const tokens = [];
@@ -123,8 +125,10 @@ class LogicalExpressionParser extends BaseParser {
      * @param raw Raw input to parse.
      * @param options Global parser options.
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
-     * @returns Parsed expression
-     * @throws {AdblockSyntaxError} If the expression is invalid
+     *
+     * @returns Parsed expression.
+     *
+     * @throws {AdblockSyntaxError} If the expression is invalid.
      */
     // TODO: Create a separate TokenStream class
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {
@@ -135,8 +139,9 @@ class LogicalExpressionParser extends BaseParser {
         /**
          * Consumes a token of the expected type.
          *
-         * @param type Expected token type
-         * @returns The consumed token
+         * @param type Expected token type.
+         *
+         * @returns The consumed token.
          */
         function consume(type) {
             const token = tokens[tokenIndex];
@@ -155,7 +160,7 @@ class LogicalExpressionParser extends BaseParser {
         /**
          * Parses a variable.
          *
-         * @returns Variable node
+         * @returns Variable node.
          */
         function parseVariable() {
             const token = consume(TokenType.Variable);
@@ -172,9 +177,10 @@ class LogicalExpressionParser extends BaseParser {
         /**
          * Parses a binary expression.
          *
-         * @param left Left-hand side of the expression
-         * @param minPrecedence Minimum precedence of the operator
-         * @returns Binary expression node
+         * @param left Left-hand side of the expression.
+         * @param minPrecedence Minimum precedence of the operator.
+         *
+         * @returns Binary expression node.
          */
         function parseBinaryExpression(left, minPrecedence = 0) {
             let node = left;
@@ -210,7 +216,7 @@ class LogicalExpressionParser extends BaseParser {
         /**
          * Parses a parenthesized expression.
          *
-         * @returns Parenthesized expression node
+         * @returns Parenthesized expression node.
          */
         function parseParenthesizedExpression() {
             consume(TokenType.Parenthesis);
@@ -230,8 +236,9 @@ class LogicalExpressionParser extends BaseParser {
         /**
          * Parses an expression.
          *
-         * @param minPrecedence Minimum precedence of the operator
-         * @returns Expression node
+         * @param minPrecedence Minimum precedence of the operator.
+         *
+         * @returns Expression node.
          */
         function parseExpression(minPrecedence = 0) {
             let node;

package/dist/parser/misc/method-list-parser.js

@@ -1,13 +1,13 @@
 /*
- * AGTree v4.0.0 (build date: Wed, 21 Jan 2026 17:25:36 GMT)
+ * AGTree v4.0.2 (build date: Tue, 17 Mar 2026 23:34:38 GMT)
  * (c) 2026 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { PIPE } from '../../utils/constants.js';
 import { ListItemNodeType, ListNodeType } from '../../nodes/index.js';
-import { defaultParserOptions } from '../options.js';
+import { PIPE } from '../../utils/constants.js';
 import { BaseParser } from '../base-parser.js';
+import { defaultParserOptions } from '../options.js';
 import { ListItemsParser } from './list-items-parser.js';
 
 const METHOD_LIST_SEPARATOR = PIPE;
@@ -26,6 +26,7 @@ class MethodListParser extends BaseParser {
      * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
      *
      * @returns Method list AST.
+     *
      * @throws An {@link AdblockSyntaxError} if the method list is syntactically invalid.
      * @throws An {@link Error} if the options are invalid.
      */