@adguard/agtree 4.0.0 → 4.0.2

package/dist/generator/cosmetic/selector/complex-selector-generator.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 { EMPTY } from '../../../utils/constants.js';
 import { BaseGenerator } from '../../base-generator.js';
-import { TypeSelectorGenerator } from './type-selector-generator.js';
-import { IdSelectorGenerator } from './id-selector-generator.js';
-import { ClassSelectorGenerator } from './class-selector-generator.js';
 import { AttributeSelectorGenerator } from './attribute-selector-generator.js';
+import { ClassSelectorGenerator } from './class-selector-generator.js';
+import { IdSelectorGenerator } from './id-selector-generator.js';
 import { PseudoClassSelectorGenerator } from './pseudo-class-selector-generator.js';
 import { SelectorCombinatorGenerator } from './selector-combinator-generator.js';
+import { TypeSelectorGenerator } from './type-selector-generator.js';
 
 /**
  * Complex selector generator.

package/dist/generator/cosmetic/selector/id-selector-generator.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/generator/cosmetic/selector/pseudo-class-selector-generator.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/generator/cosmetic/selector/selector-combinator-generator.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/generator/cosmetic/selector/selector-list-generator.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/generator/cosmetic/selector/type-selector-generator.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/generator/css/adg-css-injection-generator.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,11 +11,15 @@ import { BaseGenerator } from '../base-generator.js';
  * AdGuard CSS injection generator.
  */
 class AdgCssInjectionGenerator extends BaseGenerator {
+    /**
+     * CSS declaration for removing elements.
+     */
     static REMOVE_DECLARATION = 'remove: true;';
     /**
      * Serializes an AdGuard CSS injection node into a raw string.
      *
      * @param node Node to serialize.
+     *
      * @returns Raw string.
      */
     static generate(node) {

package/dist/generator/filterlist-generator.js

@@ -1,12 +1,12 @@
 /*
- * 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 { EMPTY, LF, CR, CRLF } from '../utils/constants.js';
-import { RuleGenerator } from './rule-generator.js';
 import { BaseGenerator } from './base-generator.js';
+import { RuleGenerator } from './rule-generator.js';
 
 /**
  * Generates a serialized filter list.
@@ -15,12 +15,13 @@ class FilterListGenerator extends BaseGenerator {
     /**
      * Serializes a whole adblock filter list (list of rules).
      *
-     * @param ast AST to generate
+     * @param ast AST to generate.
      * @param preferRaw If `true`, then the parser will use `raws.text` property of each rule
      * if it is available. Default is `false`.
      * @param tolerant If `true`, errors during rule generation will be logged to the console and invalid rules
      * will be skipped. If `false`, an error will be thrown on the first invalid rule. Default is `true`.
-     * @returns Serialized filter list
+     *
+     * @returns Serialized filter list.
      */
     static generate(ast, preferRaw = false, tolerant = true) {
         let result = EMPTY;

package/dist/generator/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/generator/misc/domain-list-generator.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/generator/misc/list-items-generator.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
@@ -13,9 +13,10 @@ class ListItemsGenerator {
     /**
      * Generates a string representation of a list item.
      *
-     * @param item List item to generate.
      * @template T Type of the list item.
      *
+     * @param item List item to generate.
+     *
      * @returns String representation of the list item.
      */
     static generateListItem = (item) => {
@@ -24,9 +25,10 @@ class ListItemsGenerator {
     /**
      * Generates a string representation of a list of items.
      *
+     * @template T Type of the list items.
+     *
      * @param items List of items to generate.
      * @param separator Separator character.
-     * @template T Type of the list items.
      *
      * @returns String representation of the list of items.
      */

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

@@ -1,12 +1,12 @@
 /*
- * 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 { BaseGenerator } from '../base-generator.js';
 import { OperatorValue } from '../../nodes/index.js';
 import { NodeType } from '../../parser/misc/logical-expression-parser.js';
+import { BaseGenerator } from '../base-generator.js';
 
 /**
  * Generator for logical expression nodes.
@@ -15,8 +15,9 @@ class LogicalExpressionGenerator extends BaseGenerator {
     /**
      * Generates a string representation of the logical expression (serialization).
      *
-     * @param node Expression node
-     * @returns String representation of the logical expression
+     * @param node Expression node.
+     *
+     * @returns String representation of the logical expression.
      */
     static generate(node) {
         if (node.type === NodeType.Variable) {

package/dist/generator/misc/modifier-generator.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
@@ -14,8 +14,9 @@ class ModifierGenerator extends BaseGenerator {
     /**
      * Converts a modifier AST node to a string.
      *
-     * @param modifier Modifier AST node to convert
-     * @returns String representation of the modifier
+     * @param modifier Modifier AST node to convert.
+     *
+     * @returns String representation of the modifier.
      */
     static generate(modifier) {
         let result = EMPTY;

package/dist/generator/misc/modifier-list-generator.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 { BaseGenerator } from '../base-generator.js';
 import { MODIFIERS_SEPARATOR } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
 import { ModifierGenerator } from './modifier-generator.js';
 
 /**
@@ -15,8 +15,9 @@ class ModifierListGenerator extends BaseGenerator {
     /**
      * Converts a modifier list AST to a string.
      *
-     * @param ast Modifier list AST
-     * @returns Raw string
+     * @param ast Modifier list AST.
+     *
+     * @returns Raw string.
      */
     static generate(ast) {
         const result = ast.children

package/dist/generator/misc/parameter-list-generator.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
@@ -15,10 +15,11 @@ class ParameterListGenerator extends BaseGenerator {
     /**
      * Converts a parameter list AST to a string.
      *
-     * @param params Parameter list AST
-     * @param separator Separator character (default: comma)
-     * @param allowSpace Allow space between parameters (default: true)
-     * @returns String representation of the parameter list
+     * @param params Parameter list AST.
+     * @param separator Separator character (default: comma).
+     * @param allowSpace Allow space between parameters (default: true).
+     *
+     * @returns String representation of the parameter list.
      */
     static generate(params, separator = COMMA, allowSpace = true) {
         const collection = [];

package/dist/generator/misc/value-generator.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
@@ -14,6 +14,7 @@ class ValueGenerator extends BaseGenerator {
      * Converts a value node to a string.
      *
      * @param node Value node.
+     *
      * @returns Raw string.
      */
     static generate(node) {

package/dist/generator/network/host-rule-generator.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
@@ -15,6 +15,7 @@ class HostRuleGenerator extends BaseGenerator {
      * Converts a host rule node to a raw string.
      *
      * @param node Host rule node.
+     *
      * @returns Raw string.
      */
     static generate(node) {

package/dist/generator/network/network-rule-generator.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
@@ -16,6 +16,7 @@ class NetworkRuleGenerator extends BaseGenerator {
      * Generates a string from a network rule AST node.
      *
      * @param node Network rule node to generate a string from.
+     *
      * @returns Generated string representation of the network rule.
      */
     static generate(node) {

package/dist/generator/rule-generator.js

@@ -1,12 +1,12 @@
 /*
- * 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 { BaseGenerator } from './base-generator.js';
 import { RuleCategory, NetworkRuleType } from '../nodes/index.js';
 import { EMPTY } from '../utils/constants.js';
+import { BaseGenerator } from './base-generator.js';
 import { CommentRuleGenerator } from './comment/comment-rule-generator.js';
 import { CosmeticRuleGenerator } from './cosmetic/cosmetic-rule-generator.js';
 import { HostRuleGenerator } from './network/host-rule-generator.js';
@@ -19,8 +19,10 @@ class RuleGenerator extends BaseGenerator {
     /**
      * Converts a rule AST to a string.
      *
-     * @param ast - Adblock rule AST
-     * @returns Raw string
+     * @param ast Adblock rule AST.
+     *
+     * @returns Raw string.
+     *
      * @example
      * Take a look at the following example:
      * ```js

package/dist/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
@@ -31,7 +31,6 @@ export { ParameterListParser } from './parser/misc/parameter-list-parser.js';
 export { HostRuleParser } from './parser/network/host-rule-parser.js';
 export { PreProcessorCommentParser } from './parser/comment/preprocessor-parser.js';
 export { RuleConversionError } from './errors/rule-conversion-error.js';
-export { BinarySchemaMismatchError } from './errors/binary-schema-mismatch-error.js';
 export { modifierValidator } from './validator/index.js';
 export { FilterListConverter } from './converter/filter-list.js';
 export { RawFilterListConverter } from './converter/raw-filter-list.js';

package/dist/nodes/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/package.json.js

@@ -1,9 +1,9 @@
 /*
- * 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
  */
-const version = "4.0.0";
+const version = "4.0.2";
 
 export { version };

package/dist/parser/base-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

package/dist/parser/comment/agent-comment-parser.js

@@ -1,19 +1,19 @@
 /*
- * 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 { OPEN_SQUARE_BRACKET, CLOSE_SQUARE_BRACKET, SEMICOLON } from '../../utils/constants.js';
-import { StringUtils } from '../../utils/string.js';
-import { RuleCategory, CommentRuleType } from '../../nodes/index.js';
-import { AgentParser } from './agent-parser.js';
 import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
+import { RuleCategory, CommentRuleType } from '../../nodes/index.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
+import { OPEN_SQUARE_BRACKET, CLOSE_SQUARE_BRACKET, SEMICOLON } from '../../utils/constants.js';
 import { CosmeticRuleSeparatorUtils } from '../../utils/cosmetic-rule-separator.js';
+import { StringUtils } from '../../utils/string.js';
+import { isNull } from '../../utils/type-guards.js';
 import { BaseParser } from '../base-parser.js';
 import { defaultParserOptions } from '../options.js';
-import { isNull } from '../../utils/type-guards.js';
+import { AgentParser } from './agent-parser.js';
 
 /**
  * `AgentParser` is responsible for parsing an Adblock agent rules.
@@ -41,8 +41,9 @@ class AgentCommentParser extends BaseParser {
     /**
      * Checks if the raw rule is an adblock agent comment.
      *
-     * @param raw Raw rule
-     * @returns `true` if the rule is an adblock agent, `false` otherwise
+     * @param raw Raw rule.
+     *
+     * @returns `true` if the rule is an adblock agent, `false` otherwise.
      */
     static isAgentRule(raw) {
         const rawTrimmed = raw.trim();
@@ -58,7 +59,8 @@ class AgentCommentParser 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 Agent rule AST or null (if the raw rule cannot be parsed as an adblock agent comment)
+     *
+     * @returns Agent rule AST or null (if the raw rule cannot be parsed as an adblock agent comment).
      */
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {
         // Ignore non-agent rules

package/dist/parser/comment/agent-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 { StringUtils } from '../../utils/string.js';
+import { getAdblockSyntax } from '../../common/agent-common.js';
 import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
+import { StringUtils } from '../../utils/string.js';
+import { isUndefined } from '../../utils/type-guards.js';
 import { BaseParser } from '../base-parser.js';
-import { defaultParserOptions } from '../options.js';
 import { ValueParser } from '../misc/value-parser.js';
-import { isUndefined } from '../../utils/type-guards.js';
-import { getAdblockSyntax } from '../../common/agent-common.js';
+import { defaultParserOptions } from '../options.js';
 
 /**
  * `AgentParser` is responsible for parsing single adblock agent elements.
@@ -36,8 +36,9 @@ class AgentParser extends BaseParser {
      * The string can have a version in formats like
      * [Adblock Plus 2.0], or [Adblock Plus 3.1; AdGuard].
      *
-     * @param str String to check
-     * @returns `true` if the string is a valid version, `false` otherwise
+     * @param str String to check.
+     *
+     * @returns `true` if the string is a valid version, `false` otherwise.
      */
     static isValidVersion(str) {
         // Check if the string contains a valid version pattern
@@ -49,8 +50,10 @@ class AgentParser 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 Agent rule AST
-     * @throws {AdblockSyntaxError} If the raw rule cannot be parsed as an adblock agent
+     *
+     * @returns Agent rule AST.
+     *
+     * @throws {AdblockSyntaxError} If the raw rule cannot be parsed as an adblock agent.
      */
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {
         let offset = 0;

package/dist/parser/comment/comment-parser.js

@@ -1,19 +1,18 @@
 /*
- * 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 { BaseParser } from '../base-parser.js';
+import { defaultParserOptions } from '../options.js';
 import { AgentCommentParser } from './agent-comment-parser.js';
 import { ConfigCommentParser } from './config-comment-parser.js';
 import { HintCommentParser } from './hint-comment-parser.js';
 import { MetadataCommentParser } from './metadata-comment-parser.js';
 import { PreProcessorCommentParser } from './preprocessor-parser.js';
-import { defaultParserOptions } from '../options.js';
-import { BaseParser } from '../base-parser.js';
 import { SimpleCommentParser } from './simple-comment-parser.js';
 
-/* eslint-disable no-param-reassign */
 /**
  * `CommentParser` is responsible for parsing any comment-like adblock rules.
  *
@@ -74,8 +73,9 @@ class CommentParser extends BaseParser {
     /**
      * Checks whether a rule is a comment.
      *
-     * @param raw Raw rule
-     * @returns `true` if the rule is a comment, `false` otherwise
+     * @param raw Raw rule.
+     *
+     * @returns `true` if the rule is a comment, `false` otherwise.
      */
     static isCommentRule(raw) {
         const trimmed = raw.trim();
@@ -87,7 +87,8 @@ class CommentParser 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 Comment AST or null (if the raw rule cannot be parsed as comment)
+     *
+     * @returns Comment AST or null (if the raw rule cannot be parsed as comment).
      */
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {
         // Ignore non-comment rules

package/dist/parser/comment/config-comment-parser.js

@@ -1,21 +1,22 @@
 /*
- * 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 JSON5 from 'json5';
+import { CommentMarker, RuleCategory, CommentRuleType } from '../../nodes/index.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
 import { AGLINT_CONFIG_COMMENT_MARKER, AGLINT_COMMAND_PREFIX, COMMA } from '../../utils/constants.js';
-import { CommentMarker, RuleCategory, CommentRuleType } from '../../nodes/index.js';
 import { StringUtils } from '../../utils/string.js';
-import { ParameterListParser } from '../misc/parameter-list-parser.js';
-import { defaultParserOptions } from '../options.js';
 import { BaseParser } from '../base-parser.js';
+import { ParameterListParser } from '../misc/parameter-list-parser.js';
 import { ValueParser } from '../misc/value-parser.js';
+import { defaultParserOptions } from '../options.js';
 
 /**
  * @file AGLint configuration comments. Inspired by ESLint inline configuration comments.
+ *
  * @see {@link https://eslint.org/docs/latest/user-guide/configuring/rules#using-configuration-comments}
  */
 /**
@@ -28,7 +29,8 @@ class ConfigCommentParser extends BaseParser {
     /**
      * Checks if the raw rule is an inline configuration comment rule.
      *
-     * @param raw Raw rule
+     * @param raw Raw rule.
+     *
      * @returns `true` if the rule is an inline configuration comment rule, otherwise `false`.
      */
     static isConfigComment(raw) {
@@ -53,8 +55,9 @@ class ConfigCommentParser 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
-     * Inline configuration comment AST or null (if the raw rule cannot be parsed as configuration comment)
+     * Inline configuration comment AST or null (if the raw rule cannot be parsed as configuration comment).
      */
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {
         if (!ConfigCommentParser.isConfigComment(raw)) {