@adguard/agtree 4.0.0 → 4.0.2

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

@@ -1,35 +1,37 @@
 /*
- * 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 { HINT_MARKER, OPEN_PARENTHESIS, BACKSLASH, CLOSE_PARENTHESIS, HINT_MARKER_LEN } from '../../utils/constants.js';
-import { StringUtils } from '../../utils/string.js';
+import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
 import { RuleCategory, CommentRuleType } from '../../nodes/index.js';
-import { HintParser } from './hint-parser.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
-import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
-import { defaultParserOptions } from '../options.js';
+import { HINT_MARKER, OPEN_PARENTHESIS, BACKSLASH, CLOSE_PARENTHESIS, HINT_MARKER_LEN } from '../../utils/constants.js';
+import { StringUtils } from '../../utils/string.js';
 import { BaseParser } from '../base-parser.js';
+import { defaultParserOptions } from '../options.js';
+import { HintParser } from './hint-parser.js';
 
 /**
  * `HintRuleParser` is responsible for parsing AdGuard hint rules.
  *
+ * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#hints}
+ *
  * @example
  * The following hint rule
  * ```adblock
  * !+ NOT_OPTIMIZED PLATFORM(windows)
  * ```
  * contains two hints: `NOT_OPTIMIZED` and `PLATFORM`.
- * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#hints}
  */
 class HintCommentParser extends BaseParser {
     /**
      * Checks if the raw rule is a hint rule.
      *
-     * @param raw Raw rule
-     * @returns `true` if the rule is a hint rule, `false` otherwise
+     * @param raw Raw rule.
+     *
+     * @returns `true` if the rule is a hint rule, `false` otherwise.
      */
     static isHintRule(raw) {
         return raw.trim().startsWith(HINT_MARKER);
@@ -37,12 +39,15 @@ class HintCommentParser extends BaseParser {
     /**
      * Parses a raw rule as a hint comment.
      *
+     * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#hints-1}
+     *
      * @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 Hint AST or null (if the raw rule cannot be parsed as a hint comment)
-     * @throws If the input matches the HINT pattern but syntactically invalid
-     * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#hints-1}
+     *
+     * @returns Hint AST or null (if the raw rule cannot be parsed as a hint comment).
+     *
+     * @throws If the input matches the HINT pattern but syntactically invalid.
      */
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {
         // Ignore non-hint rules

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

@@ -1,20 +1,21 @@
 /*
- * 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 { OPEN_PARENTHESIS, SPACE, UNDERSCORE, EMPTY, CLOSE_PARENTHESIS, COMMA } from '../../utils/constants.js';
 import { StringUtils } from '../../utils/string.js';
-import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.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';
 
 /* eslint-disable no-param-reassign */
 /**
- * @file AdGuard Hints
+ * @file AdGuard Hints.
+ *
  * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#hints}
  */
 /**
@@ -36,8 +37,10 @@ class HintParser 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 Hint rule AST or null
-     * @throws If the syntax is invalid
+     *
+     * @returns Hint rule AST or null.
+     *
+     * @throws If the syntax is invalid.
      */
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {
         let offset = 0;

package/dist/parser/comment/metadata-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 { StringUtils } from '../../utils/string.js';
+import { CommentMarker, RuleCategory, CommentRuleType } from '../../nodes/index.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
 import { COLON } from '../../utils/constants.js';
-import { CommentMarker, RuleCategory, CommentRuleType } from '../../nodes/index.js';
-import { defaultParserOptions } from '../options.js';
+import { StringUtils } from '../../utils/string.js';
 import { BaseParser } from '../base-parser.js';
 import { ValueParser } from '../misc/value-parser.js';
+import { defaultParserOptions } from '../options.js';
 
 /**
- * @file Metadata comments
+ * @file Metadata comments.
  */
 /**
  * Set of known metadata headers. This helps to quickly identify and validate
@@ -37,6 +37,8 @@ const KNOWN_METADATA_HEADERS = new Set([
  * `MetadataParser` is responsible for parsing metadata comments.
  * Metadata comments are special comments that specify some properties of the list.
  *
+ * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#special-comments}
+ *
  * @example
  * For example, in the case of
  * ```adblock
@@ -44,7 +46,6 @@ const KNOWN_METADATA_HEADERS = new Set([
  * ```
  * the name of the header is `Title`, and the value is `My List`, which means that
  * the list title is `My List`, and it can be used in the adblocker UI.
- * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#special-comments}
  */
 class MetadataCommentParser extends BaseParser {
     /**
@@ -53,7 +54,8 @@ class MetadataCommentParser 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 Metadata comment AST or null (if the raw rule cannot be parsed as a metadata comment)
+     *
+     * @returns Metadata comment AST or null (if the raw rule cannot be parsed as a metadata comment).
      */
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {
         // Fast check to avoid unnecessary work

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

@@ -1,22 +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 { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
+import { RuleCategory, CommentRuleType } from '../../nodes/index.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
 import { PREPROCESSOR_MARKER, PREPROCESSOR_MARKER_LEN, HASHMARK, PREPROCESSOR_SEPARATOR, OPEN_PARENTHESIS, SAFARI_CB_AFFINITY, CLOSE_PARENTHESIS, COMMA, IF, INCLUDE } from '../../utils/constants.js';
 import { StringUtils } from '../../utils/string.js';
-import { RuleCategory, CommentRuleType } from '../../nodes/index.js';
+import { BaseParser } from '../base-parser.js';
 import { LogicalExpressionParser } from '../misc/logical-expression-parser.js';
-import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
 import { ParameterListParser } from '../misc/parameter-list-parser.js';
-import { defaultParserOptions } from '../options.js';
-import { BaseParser } from '../base-parser.js';
 import { ValueParser } from '../misc/value-parser.js';
+import { defaultParserOptions } from '../options.js';
 
 /**
- * Pre-processor directives
+ * Pre-processor directives.
  *
  * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#pre-processor-directives}
  * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#pre-parsing-directives}
@@ -27,6 +27,9 @@ import { ValueParser } from '../misc/value-parser.js';
  * Please note that this parser only handles general syntax for now, and does not validate the parameters at
  * the parsing stage.
  *
+ * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#pre-processor-directives}
+ * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#pre-parsing-directives}
+ *
  * @example
  * If your rule is
  * ```adblock
@@ -34,15 +37,14 @@ import { ValueParser } from '../misc/value-parser.js';
  * ```
  * then the directive's name is `if` and its value is `(adguard)`, but the parameter list
  * is not parsed / validated further.
- * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#pre-processor-directives}
- * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#pre-parsing-directives}
  */
 class PreProcessorCommentParser extends BaseParser {
     /**
      * Determines whether the rule is a pre-processor rule.
      *
-     * @param raw Raw rule
-     * @returns `true` if the rule is a pre-processor rule, `false` otherwise
+     * @param raw Raw rule.
+     *
+     * @returns `true` if the rule is a pre-processor rule, `false` otherwise.
      */
     static isPreProcessorRule(raw) {
         const trimmed = raw.trim();
@@ -55,8 +57,9 @@ class PreProcessorCommentParser 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
-     * Pre-processor comment AST or null (if the raw rule cannot be parsed as a pre-processor comment)
+     * Pre-processor comment AST or null (if the raw rule cannot be parsed as a pre-processor comment).
      */
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {
         // Ignore non-pre-processor rules

package/dist/parser/comment/simple-comment-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 { CommentMarker, CommentRuleType, RuleCategory } from '../../nodes/index.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
 import { CosmeticRuleSeparatorUtils } from '../../utils/cosmetic-rule-separator.js';
 import { StringUtils } from '../../utils/string.js';
-import { CommentMarker, CommentRuleType, RuleCategory } from '../../nodes/index.js';
 import { BaseParser } from '../base-parser.js';
 import { ValueParser } from '../misc/value-parser.js';
 import { defaultParserOptions } from '../options.js';
@@ -29,7 +29,9 @@ class SimpleCommentParser extends BaseParser {
      * Checks if the raw rule is a simple comment.
      *
      * @param raw Raw input to check.
+     *
      * @returns `true` if the input is a simple comment, `false` otherwise.
+     *
      * @note This method does not check for adblock agent comments.
      */
     static isSimpleComment(raw) {
@@ -65,6 +67,7 @@ class SimpleCommentParser 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 rule node or null (if the raw rule cannot be parsed as a simple comment).
      */
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {

package/dist/parser/cosmetic/cosmetic-rule-parser.js

@@ -1,30 +1,30 @@
 /*
- * 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 { hasToken, TokenType } from '@adguard/css-tokenizer';
-import { CosmeticRuleSeparatorUtils } from '../../utils/cosmetic-rule-separator.js';
+import { sprintf } from 'sprintf-js';
+import { UboPseudoName } from '../../common/ubo-selector-common.js';
+import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
+import { RuleCategory, CosmeticRuleType } from '../../nodes/index.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
-import { DomainListParser } from '../misc/domain-list-parser.js';
-import { ModifierListParser } from '../misc/modifier-list.js';
 import { OPEN_SQUARE_BRACKET, DOLLAR_SIGN, CLOSE_SQUARE_BRACKET, CSS_BLOCK_OPEN, CSS_BLOCK_CLOSE, UBO_SCRIPTLET_MASK, UBO_SCRIPTLET_MASK_LEGACY, ADG_SCRIPTLET_MASK, UBO_HTML_MASK } from '../../utils/constants.js';
-import { RuleCategory, CosmeticRuleType } from '../../nodes/index.js';
-import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
+import { CosmeticRuleSeparatorUtils } from '../../utils/cosmetic-rule-separator.js';
 import { StringUtils } from '../../utils/string.js';
+import { BaseParser } from '../base-parser.js';
 import { CommentParser } from '../comment/comment-parser.js';
-import { defaultParserOptions } from '../options.js';
-import { UboSelectorParser } from '../css/ubo-selector-parser.js';
 import { AdgCssInjectionParser } from '../css/adg-css-injection-parser.js';
-import { AbpSnippetInjectionBodyParser } from './scriptlet-body/abp-snippet-injection-body-parser.js';
-import { UboScriptletInjectionBodyParser } from './scriptlet-body/ubo-scriptlet-injection-body-parser.js';
-import { AdgScriptletInjectionBodyParser } from './scriptlet-body/adg-scriptlet-injection-body-parser.js';
+import { UboSelectorParser } from '../css/ubo-selector-parser.js';
+import { DomainListParser } from '../misc/domain-list-parser.js';
+import { ModifierListParser } from '../misc/modifier-list.js';
+import { defaultParserOptions } from '../options.js';
 import { AdgHtmlFilteringBodyParser } from './html-filtering-body/adg-html-filtering-body-parser.js';
 import { UboHtmlFilteringBodyParser } from './html-filtering-body/ubo-html-filtering-body-parser.js';
-import { BaseParser } from '../base-parser.js';
-import { UboPseudoName } from '../../common/ubo-selector-common.js';
+import { AbpSnippetInjectionBodyParser } from './scriptlet-body/abp-snippet-injection-body-parser.js';
+import { AdgScriptletInjectionBodyParser } from './scriptlet-body/adg-scriptlet-injection-body-parser.js';
+import { UboScriptletInjectionBodyParser } from './scriptlet-body/ubo-scriptlet-injection-body-parser.js';
 
 /**
  * Possible error messages for uBO selectors. Formatted with {@link sprintf}.
@@ -44,7 +44,7 @@ const ADG_CSS_INJECTION_PATTERN = /^(?:.+){(?:.+)}$/;
  * Where possible, it automatically detects the difference between supported syntaxes:
  *  - AdGuard
  *  - uBlock Origin
- *  - Adblock Plus
+ *  - Adblock Plus.
  *
  * If the syntax is common / cannot be determined, the parser gives `Common` syntax.
  *
@@ -59,8 +59,9 @@ class CosmeticRuleParser extends BaseParser {
      * Determines whether a rule is a cosmetic rule. The rule is considered cosmetic if it
      * contains a cosmetic rule separator.
      *
-     * @param raw Raw rule
-     * @returns `true` if the rule is a cosmetic rule, `false` otherwise
+     * @param raw Raw rule.
+     *
+     * @returns `true` if the rule is a cosmetic rule, `false` otherwise.
      */
     static isCosmeticRule(raw) {
         const trimmed = raw.trim();
@@ -73,14 +74,16 @@ class CosmeticRuleParser extends BaseParser {
      * Parses a cosmetic rule. The structure of the cosmetic rules:
      *  - pattern (AdGuard pattern can have modifiers, other syntaxes don't)
      *  - separator
-     *  - body
+     *  - body.
      *
      * @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 cosmetic rule AST or null if it failed to parse based on the known cosmetic rules
-     * @throws If the input matches the cosmetic rule pattern but syntactically invalid
+     * Parsed cosmetic rule AST or null if it failed to parse based on the known cosmetic rules.
+     *
+     * @throws If the input matches the cosmetic rule pattern but syntactically invalid.
      */
     // TODO: Split to smaller functions
     static parse(raw, options = defaultParserOptions, baseOffset = 0) {
@@ -158,6 +161,10 @@ class CosmeticRuleParser extends BaseParser {
          * Ensures that the rule syntax is common or the expected one. This function is used to prevent mixing
          * different syntaxes in the same rule.
          *
+         * @param expectedSyntax Expected syntax.
+         *
+         * @throws If the rule syntax is not common or the expected one.
+         *
          * @example
          * The following rule mixes AdGuard and uBO syntaxes, because it uses AdGuard modifier list and uBO
          * CSS injection:
@@ -166,9 +173,6 @@ class CosmeticRuleParser extends BaseParser {
          * ```
          * In this case, parser sets syntax to AdGuard, because it detects the AdGuard modifier list, but
          * when parsing the rule body, it detects uBO CSS injection, which is not compatible with AdGuard.
-         *
-         * @param expectedSyntax Expected syntax
-         * @throws If the rule syntax is not common or the expected one
          */
         const expectCommonOrSpecificSyntax = (expectedSyntax) => {
             if (syntax !== AdblockSyntax.Common && syntax !== expectedSyntax) {
@@ -313,9 +317,9 @@ class CosmeticRuleParser extends BaseParser {
         };
         /**
          * Parses Adb CSS injection rules
-         * eg: example.com##.foo { display: none; }
+         * eg: example.com##.foo { display: none; }.
          *
-         * @returns parsed rule
+         * @returns Parsed rule.
          */
         const parseAbpCssInjection = () => {
             if (!options.parseAbpSpecificRules) {

package/dist/parser/cosmetic/html-filtering-body/adg-html-filtering-body-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
@@ -13,12 +13,12 @@ import { HtmlFilteringBodyParser } from './html-filtering-body-parser.js';
  * `AdgHtmlFilteringBodyParser` is responsible for parsing the body of an AdGuard-style HTML filtering rule.
  *
  * Please note that the parser will parse any HTML filtering rule if it is syntactically correct.
- * For example, it will parse this:
+ * For example, it will parse this:.
  * ```adblock
  * example.com$$div[special-attr="value"]
  * ```
  *
- * but it didn't check if the attribute `special-attr` actually supported by any adblocker.
+ * But it didn't check if the attribute `special-attr` actually supported by any adblocker..
  *
  * @see {@link https://www.w3.org/TR/selectors-4}
  * @see {@link https://adguard.com/kb/general/ad-filtering/create-own-filters/#html-filtering-rules}

package/dist/parser/cosmetic/html-filtering-body/html-filtering-body-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
@@ -12,14 +12,14 @@ import { SelectorListParser } from '../selector/selector-list-parser.js';
  * Class responsible for parsing HTML filtering rule body.
  *
  * Please note that the parser will parse any HTML filtering rule body if it is syntactically correct.
- * For example, it will parse this:
+ * For example, it will parse this:.
  * ```adblock
  * span[special-attr="Example"]
  * div:special-pseudo(Example)
  * ```
  *
- * but it didn't check if the pseudo selector `special-pseudo` or if
- * the attribute selector `special-attr` actually supported by any adblocker.
+ * But it didn't check if the pseudo selector `special-pseudo` or if
+ * the attribute selector `special-attr` actually supported by any adblocker..
  *
  * @see {@link https://www.w3.org/TR/selectors-4}
  * @see {@link https://adguard.com/kb/general/ad-filtering/create-own-filters/#html-filtering-rules}

package/dist/parser/cosmetic/html-filtering-body/ubo-html-filtering-body-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 { AdblockSyntaxError } from '../../../errors/adblock-syntax-error.js';
+import { UBO_RESPONSEHEADER_FN } from '../../../utils/constants.js';
 import { BaseParser } from '../../base-parser.js';
 import { CssTokenStream } from '../../css/css-token-stream.js';
-import { defaultParserOptions } from '../../options.js';
-import { AdblockSyntaxError } from '../../../errors/adblock-syntax-error.js';
 import { ValueParser } from '../../misc/value-parser.js';
-import { UBO_RESPONSEHEADER_FN } from '../../../utils/constants.js';
+import { defaultParserOptions } from '../../options.js';
 import { HtmlFilteringBodyParser } from './html-filtering-body-parser.js';
 
 /**
@@ -19,14 +19,14 @@ import { HtmlFilteringBodyParser } from './html-filtering-body-parser.js';
  * an uBlock-style HTML filtering rule, and also uBlock-style response header removal rule.
  *
  * Please note that the parser will parse any HTML filtering rule if it is syntactically correct.
- * For example, it will parse this:
+ * For example, it will parse this:.
  * ```adblock
  * example.com##^script:pseudo(content)
  * example.com##^responseheader(header-name)
  * ```
  *
- * but it didn't check if the pseudo selector `pseudo` or if
- * the header name `header-name` actually supported by any adblocker.
+ * But it didn't check if the pseudo selector `pseudo` or if
+ * the header name `header-name` actually supported by any adblocker..
  *
  * @see {@link https://www.w3.org/TR/selectors-4}
  * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#html-filters}

package/dist/parser/cosmetic/scriptlet-body/abp-snippet-injection-body-parser.js

@@ -1,30 +1,30 @@
 /*
- * 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 { AbpSnippetInjectionBodyCommon } from '../../../common/abp-snippet-injection-body-common.js';
+import { AdblockSyntaxError } from '../../../errors/adblock-syntax-error.js';
 import { SEMICOLON, SPACE } from '../../../utils/constants.js';
 import { StringUtils } from '../../../utils/string.js';
-import { AdblockSyntaxError } from '../../../errors/adblock-syntax-error.js';
+import { BaseParser } from '../../base-parser.js';
 import { ParameterListParser } from '../../misc/parameter-list-parser.js';
 import { defaultParserOptions } from '../../options.js';
-import { BaseParser } from '../../base-parser.js';
-import { AbpSnippetInjectionBodyCommon } from '../../../common/abp-snippet-injection-body-common.js';
 
 /**
- * @file uBlock scriptlet injection body parser
+ * @file UBlock scriptlet injection body parser.
  */
 /**
  * `AbpSnippetInjectionBodyParser` is responsible for parsing the body of an Adblock Plus-style snippet rule.
  *
  * Please note that the parser will parse any scriptlet rule if it is syntactically correct.
- * For example, it will parse this:
+ * For example, it will parse this:.
  * ```adblock
  * example.com#$#snippet0 arg0
  * ```
  *
- * but it didn't check if the scriptlet `snippet0` actually supported by any adblocker.
+ * But it didn't check if the scriptlet `snippet0` actually supported by any adblocker..
  *
  * @see {@link https://help.eyeo.com/adblockplus/snippet-filters-tutorial}
  */
@@ -35,8 +35,11 @@ class AbpSnippetInjectionBodyParser 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 Node of the parsed scriptlet call body
-     * @throws If the body is syntactically incorrect
+     *
+     * @returns Node of the parsed scriptlet call body.
+     *
+     * @throws If the body is syntactically incorrect.
+     *
      * @example
      * ```
      * #$#snippet0 arg0

package/dist/parser/cosmetic/scriptlet-body/adg-scriptlet-injection-body-parser.js

@@ -1,31 +1,31 @@
 /*
- * 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 { AdblockSyntaxError } from '../../../errors/adblock-syntax-error.js';
 import { CLOSE_PARENTHESIS, OPEN_PARENTHESIS, ADG_SCRIPTLET_MASK, SPACE, ESCAPE_CHARACTER, COMMA, SINGLE_QUOTE, DOUBLE_QUOTE } from '../../../utils/constants.js';
 import { StringUtils } from '../../../utils/string.js';
-import { AdblockSyntaxError } from '../../../errors/adblock-syntax-error.js';
-import { defaultParserOptions } from '../../options.js';
+import { isNull } from '../../../utils/type-guards.js';
 import { BaseParser } from '../../base-parser.js';
 import { ValueParser } from '../../misc/value-parser.js';
-import { isNull } from '../../../utils/type-guards.js';
+import { defaultParserOptions } from '../../options.js';
 
 /**
- * @file AdGuard scriptlet injection body parser
+ * @file AdGuard scriptlet injection body parser.
  */
 /**
  * `AdgScriptletInjectionBodyParser` is responsible for parsing the body of an AdGuard-style scriptlet rule.
  *
  * Please note that the parser will parse any scriptlet rule if it is syntactically correct.
- * For example, it will parse this:
+ * For example, it will parse this:.
  * ```adblock
  * example.com#%#//scriptlet('scriptlet0', 'arg0')
  * ```
  *
- * but it didn't check if the scriptlet `scriptlet0` actually supported by any adblocker.
+ * But it didn't check if the scriptlet `scriptlet0` actually supported by any adblocker..
  *
  * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#scriptlets}
  */
@@ -49,8 +49,11 @@ class AdgScriptletInjectionBodyParser 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 Node of the parsed scriptlet call body
-     * @throws If the body is syntactically incorrect
+     *
+     * @returns Node of the parsed scriptlet call body.
+     *
+     * @throws If the body is syntactically incorrect.
+     *
      * @example
      * ```
      * //scriptlet('scriptlet0', 'arg0')

package/dist/parser/cosmetic/scriptlet-body/ubo-scriptlet-injection-body-parser.js

@@ -1,29 +1,29 @@
 /*
- * 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 { CLOSE_PARENTHESIS, OPEN_PARENTHESIS, UBO_SCRIPTLET_MASK, UBO_SCRIPTLET_MASK_LEGACY, SPACE, ESCAPE_CHARACTER, COMMA } from '../../../utils/constants.js';
 import { StringUtils } from '../../../utils/string.js';
-import { AdblockSyntaxError } from '../../../errors/adblock-syntax-error.js';
-import { defaultParserOptions } from '../../options.js';
 import { BaseParser } from '../../base-parser.js';
 import { UboParameterListParser } from '../../misc/ubo-parameter-list-parser.js';
+import { defaultParserOptions } from '../../options.js';
 
 /**
- * @file uBlock scriptlet injection body parser
+ * @file UBlock scriptlet injection body parser.
  */
 /**
  * `UboScriptletInjectionBodyParser` is responsible for parsing the body of a uBlock-style scriptlet rule.
  *
  * Please note that the parser will parse any scriptlet rule if it is syntactically correct.
- * For example, it will parse this:
+ * For example, it will parse this:.
  * ```adblock
  * example.com##+js(scriptlet0, arg0)
  * ```
  *
- * but it didn't check if the scriptlet `scriptlet0` actually supported by any adblocker.
+ * But it didn't check if the scriptlet `scriptlet0` actually supported by any adblocker..
  *
  * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#scriptlet-injection}
  */
@@ -44,8 +44,11 @@ class UboScriptletInjectionBodyParser 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 Node of the parsed scriptlet call body
-     * @throws If the body is syntactically incorrect
+     *
+     * @returns Node of the parsed scriptlet call body.
+     *
+     * @throws If the body is syntactically incorrect.
+     *
      * @example
      * ```
      * ##+js(scriptlet0, arg0)

package/dist/parser/cosmetic/selector/handlers/attribute-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/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