@adguard/agtree 4.0.0 → 4.0.2

package/dist/converter/base-interfaces/conversion-result.js

@@ -1,20 +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
  */
 /**
- * @file Conversion result interface and helper functions
+ * @file Conversion result interface and helper functions.
  */
 /**
  * Helper function to create a generic conversion result.
  *
- * @param result Conversion result
- * @param isConverted Indicates whether the input item was converted
- * @template T Type of the item to convert
- * @template U Type of the conversion result (defaults to `T`, but can be `T[]` as well)
- * @returns Generic conversion result
+ * @template T Type of the item to convert.
+ * @template U Type of the conversion result (defaults to `T`, but can be `T[]` as well).
+ *
+ * @param result Conversion result.
+ * @param isConverted Indicates whether the input item was converted.
+ *
+ * @returns Generic conversion result.
  */
 // eslint-disable-next-line max-len
 function createConversionResult(result, isConverted) {
@@ -26,10 +28,12 @@ function createConversionResult(result, isConverted) {
 /**
  * Helper function to create a node conversion result.
  *
- * @param nodes Array of nodes
- * @param isConverted Indicates whether the input item was converted
- * @template T Type of the node (extends `Node`)
- * @returns Node conversion result
+ * @template T Type of the node (extends `Node`).
+ *
+ * @param nodes Array of nodes.
+ * @param isConverted Indicates whether the input item was converted.
+ *
+ * @returns Node conversion result.
  */
 function createNodeConversionResult(nodes, isConverted) {
     return createConversionResult(nodes, isConverted);

package/dist/converter/base-interfaces/rule-converter-base.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,25 +8,27 @@ import { NotImplementedError } from '../../errors/not-implemented-error.js';
 import { BaseConverter } from './base-converter.js';
 
 /**
- * @file Base class for rule converters
+ * @file Base class for rule converters.
  *
  * TS doesn't support abstract static methods, so we should use
- * a workaround and extend this class instead of implementing it
+ * a workaround and extend this class instead of implementing it.
  */
 /* eslint-disable jsdoc/require-returns-check */
 /* eslint-disable @typescript-eslint/no-unused-vars */
 /**
- * Basic class for rule converters
+ * Basic class for rule converters.
  */
 class RuleConverterBase extends BaseConverter {
     /**
      * Converts an adblock filtering rule to AdGuard format, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAdg(rule) {
         throw new NotImplementedError();
@@ -34,11 +36,13 @@ class RuleConverterBase extends BaseConverter {
     /**
      * Converts an adblock filtering rule to Adblock Plus format, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAbp(rule) {
         throw new NotImplementedError();
@@ -46,11 +50,13 @@ class RuleConverterBase extends BaseConverter {
     /**
      * Converts an adblock filtering rule to uBlock Origin format, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToUbo(rule) {
         throw new NotImplementedError();

package/dist/converter/comment/index.js

@@ -1,32 +1,34 @@
 /*
- * 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 { CommentRuleType, CommentMarker } from '../../nodes/index.js';
-import { SPACE } from '../../utils/constants.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 import { clone } from '../../utils/clone.js';
+import { SPACE } from '../../utils/constants.js';
 import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 
 /**
- * @file Comment rule converter
+ * @file Comment rule converter.
  */
 /**
- * Comment rule converter class
+ * Comment rule converter class.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class CommentRuleConverter extends RuleConverterBase {
     /**
      * Converts a comment rule to AdGuard format, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAdg(rule) {
         // TODO: Add support for other comment types, if needed

package/dist/converter/cosmetic/css.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 { CosmeticRuleSeparator } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
-import { CssSelectorConverter } from '../css/index.js';
+import { CssTokenStream } from '../../parser/css/css-token-stream.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
 import { clone } from '../../utils/clone.js';
 import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
-import { CssTokenStream } from '../../parser/css/css-token-stream.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
+import { CssSelectorConverter } from '../css/index.js';
 
 /**
- * @file CSS injection rule converter
+ * @file CSS injection rule converter.
  */
 /**
- * CSS injection rule converter class
+ * CSS injection rule converter class.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class CssInjectionRuleConverter extends RuleConverterBase {
     /**
      * Converts a CSS injection rule to AdGuard format, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAdg(rule) {
         const separator = rule.separator.value;

package/dist/converter/cosmetic/element-hiding.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 { CosmeticRuleSeparator } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
-import { CssSelectorConverter } from '../css/index.js';
+import { CssTokenStream } from '../../parser/css/css-token-stream.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
 import { clone } from '../../utils/clone.js';
 import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
-import { CssTokenStream } from '../../parser/css/css-token-stream.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
+import { CssSelectorConverter } from '../css/index.js';
 
 /**
- * @file Element hiding rule converter
+ * @file Element hiding rule converter.
  */
 /**
- * Element hiding rule converter class
+ * Element hiding rule converter class.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class ElementHidingRuleConverter extends RuleConverterBase {
     /**
      * Converts an element hiding rule to AdGuard format, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAdg(rule) {
         const separator = rule.separator.value;

package/dist/converter/cosmetic/header-removal.js

@@ -1,42 +1,45 @@
 /*
- * 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 { createModifierListNode, createModifierNode } from '../../ast-utils/modifiers.js';
+import { createNetworkRuleNode } from '../../ast-utils/network-rules.js';
+import { isUboResponseHeaderRemovalRuleBody } from '../../common/ubo-html-filtering-body-common.js';
 import { RuleConversionError } from '../../errors/rule-conversion-error.js';
 import { RuleCategory, CosmeticRuleType } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
-import { createModifierListNode, createModifierNode } from '../../ast-utils/modifiers.js';
+import { UboHtmlFilteringBodyParser } from '../../parser/cosmetic/html-filtering-body/ubo-html-filtering-body-parser.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
 import { EMPTY } from '../../utils/constants.js';
 import { ADBLOCK_URL_START, ADBLOCK_URL_SEPARATOR } from '../../utils/regexp.js';
-import { createNetworkRuleNode } from '../../ast-utils/network-rules.js';
-import { AdblockSyntax } from '../../utils/adblockers.js';
 import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
-import { isUboResponseHeaderRemovalRuleBody } from '../../common/ubo-html-filtering-body-common.js';
-import { UboHtmlFilteringBodyParser } from '../../parser/cosmetic/html-filtering-body/ubo-html-filtering-body-parser.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 
 /**
- * @file Converter for request header removal rules
+ * @file Converter for request header removal rules.
  */
 const ADG_REMOVEHEADER_MODIFIER = 'removeheader';
 const ERROR_MESSAGES = {
     MULTIPLE_DOMAINS_NOT_SUPPORTED: 'Multiple domains are not supported yet',
 };
 /**
- * Converter for request header removal rules
+ * Converter for request header removal rules.
  *
- * @todo Implement `convertToUbo` (ABP currently doesn't support header removal rules)
+ * @todo Implement `convertToUbo` (ABP currently doesn't support header removal rules).
  */
 class HeaderRemovalRuleConverter extends RuleConverterBase {
     /**
      * Converts a header removal rule to AdGuard syntax, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
+     *
      * @example
      * If the input rule is:
      * ```adblock

package/dist/converter/cosmetic/html.js

@@ -1,25 +1,25 @@
 /*
- * 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 { cloneDomainListNode } from '../../ast-utils/clone.js';
+import { RuleConversionError } from '../../errors/rule-conversion-error.js';
+import { AdgHtmlFilteringBodyGenerator } from '../../generator/cosmetic/html-filtering-body/adg-html-filtering-body-generator.js';
+import { UboHtmlFilteringBodyGenerator } from '../../generator/cosmetic/html-filtering-body/ubo-html-filtering-body-generator.js';
 import { CosmeticRuleSeparator, CosmeticRuleType, RuleCategory } from '../../nodes/index.js';
+import { AdgHtmlFilteringBodyParser } from '../../parser/cosmetic/html-filtering-body/adg-html-filtering-body-parser.js';
+import { UboHtmlFilteringBodyParser } from '../../parser/cosmetic/html-filtering-body/ubo-html-filtering-body-parser.js';
 import { AdblockSyntax } from '../../utils/adblockers.js';
-import { RuleConversionError } from '../../errors/rule-conversion-error.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
-import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
-import { cloneDomainListNode } from '../../ast-utils/clone.js';
 import { EMPTY, EQUALS } from '../../utils/constants.js';
 import { RegExpUtils } from '../../utils/regexp.js';
-import { AdgHtmlFilteringBodyParser } from '../../parser/cosmetic/html-filtering-body/adg-html-filtering-body-parser.js';
-import { UboHtmlFilteringBodyParser } from '../../parser/cosmetic/html-filtering-body/ubo-html-filtering-body-parser.js';
-import { AdgHtmlFilteringBodyGenerator } from '../../generator/cosmetic/html-filtering-body/adg-html-filtering-body-generator.js';
-import { UboHtmlFilteringBodyGenerator } from '../../generator/cosmetic/html-filtering-body/ubo-html-filtering-body-generator.js';
+import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 
 /**
- * @file HTML filtering rule converter
+ * @file HTML filtering rule converter.
  */
 /**
  * From the AdGuard docs:
@@ -109,9 +109,9 @@ const ERROR_MESSAGES = {
     SPECIAL_PSEUDO_CLASS_SELECTOR_NOT_SUPPORTED: "Special pseudo-class selector '%s' is not supported in conversion",
 };
 /**
- * HTML filtering rule converter class
+ * HTML filtering rule converter class.
  *
- * @todo Implement `convertToUbo` (ABP currently doesn't support HTML filtering rules)
+ * @todo Implement `convertToUbo` (ABP currently doesn't support HTML filtering rules).
  */
 class HtmlRuleConverter extends RuleConverterBase {
     /**
@@ -138,7 +138,7 @@ class HtmlRuleConverter extends RuleConverterBase {
                  * Mark rule as converted in ADG -> ADG conversion only if
                  * special attribute selectors are present in the rule body,
                  * because they are deprecated and will be removed soon,
-                 * so we convert them to pseudo-class selectors
+                 * so we convert them to pseudo-class selectors.
                  */
                 isConverted = true;
                 return HtmlRuleConverter.convertSpecialAttributeSelectorAdgToAdg(name, value);
@@ -222,9 +222,9 @@ class HtmlRuleConverter extends RuleConverterBase {
      * - `[wildcard="*content*"]` -> `:contains(/*.content*./s)`
      *   convert search pattern to regular expression
      * - `[min-length="min"]` -> `:contains(/^(?=.{min,}$).*\/s)`
-     *   converts to a length-matching regular expression
+     *   converts to a length-matching regular expression.
      * - `[max-length="max"]` -> `:contains(/^(?=.{0,max}$).*\/s)`
-     *   converts to a length-matching regular expression
+     *   converts to a length-matching regular expression.
      *
      * Note: This attribute selector to pseudo-class selector conversion
      * is needed because AdGuard special attribute selectors are going
@@ -302,7 +302,7 @@ class HtmlRuleConverter extends RuleConverterBase {
      * - `:has-text(text)` -> `:contains(text)`
      *   direct conversion, no changes to argument
      * - `:min-text-length(min)` -> `:contains(/^(?=.{min,MAX_CONVERSION_DEFAULT}$).*\/s)`
-     *   converts to a length-matching regular expression
+     *   converts to a length-matching regular expression.
      *
      * @param name Name of the special pseudo-class selector.
      * @param argument Argument of the special pseudo-class selector.
@@ -345,7 +345,7 @@ class HtmlRuleConverter extends RuleConverterBase {
      *   convert search pattern to regular expression
      * - `[min-length="min"]` -> `:min-text-length(min)`
      *   direct conversion, no changes to value
-     * - `[max-length]` is skipped
+     * - `[max-length]` is skipped.
      *
      * @param name Name of the special attribute selector.
      * @param value Value of the special attribute selector.
@@ -384,7 +384,7 @@ class HtmlRuleConverter extends RuleConverterBase {
     /**
      * Handles special pseudo-class selectors during AdGuard to uBlock conversion:
      * - `:contains(text)` -> `:has-text(text)`
-     *   direct conversion, no changes to argument
+     *   direct conversion, no changes to argument.
      *
      * @param name Name of the special pseudo-class selector.
      * @param argument Argument of the special pseudo-class selector.

package/dist/converter/cosmetic/index.js

@@ -1,48 +1,50 @@
 /*
- * 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 { CosmeticRuleType, RuleCategory, CosmeticRuleSeparator } from '../../nodes/index.js';
-import { AdblockSyntax } from '../../utils/adblockers.js';
-import { HtmlRuleConverter } from './html.js';
-import { ScriptletRuleConverter } from './scriptlet.js';
 import { RuleConversionError } from '../../errors/rule-conversion-error.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
-import { AdgCosmeticRuleModifierConverter } from './rule-modifiers/adg.js';
-import { CssInjectionRuleConverter } from './css.js';
-import { ElementHidingRuleConverter } from './element-hiding.js';
-import { HeaderRemovalRuleConverter } from './header-removal.js';
-import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
-import { UboCosmeticRuleModifierConverter } from './rule-modifiers/ubo.js';
-import { clone } from '../../utils/clone.js';
+import { CosmeticRuleType, RuleCategory, CosmeticRuleSeparator } from '../../nodes/index.js';
 import { COMMA } from '../../utils/constants.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
 import 'tldts';
 import 'glob-to-regexp';
-import 'sprintf-js';
 import '@adguard/css-tokenizer';
+import 'sprintf-js';
 import 'json5';
-import '../../parser/css/balancing.js';
 import '../data/css.js';
+import '../../parser/css/balancing.js';
+import { clone } from '../../utils/clone.js';
+import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
+import { CssInjectionRuleConverter } from './css.js';
+import { ElementHidingRuleConverter } from './element-hiding.js';
+import { HeaderRemovalRuleConverter } from './header-removal.js';
+import { HtmlRuleConverter } from './html.js';
+import { AdgCosmeticRuleModifierConverter } from './rule-modifiers/adg.js';
+import { UboCosmeticRuleModifierConverter } from './rule-modifiers/ubo.js';
+import { ScriptletRuleConverter } from './scriptlet.js';
 
 /**
- * @file Cosmetic rule converter
+ * @file Cosmetic rule converter.
  */
 /**
- * Cosmetic rule converter class (also known as "non-basic rule converter")
+ * Cosmetic rule converter class (also known as "non-basic rule converter").
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class CosmeticRuleConverter extends RuleConverterBase {
     /**
      * Converts a cosmetic rule to AdGuard syntax, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAdg(rule) {
         let subconverterResult;
@@ -105,11 +107,13 @@ class CosmeticRuleConverter extends RuleConverterBase {
     /**
      * Converts a cosmetic rule to uBlock Origin syntax, if possible.
      *
-     * @param rule Rule node to convert
+     * @param rule Rule node to convert.
+     *
      * @returns An object which follows the {@link NodeConversionResult} interface. Its `result` property contains
      * the array of converted rule nodes, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the result array will contain the original node with the same object reference
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the result array will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToUbo(rule) {
         // Skip conversation if the rule is already in uBO format

package/dist/converter/cosmetic/rule-modifiers/adg.js

@@ -1,25 +1,25 @@
 /*
- * 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 { RuleConversionError } from '../../../errors/rule-conversion-error.js';
 import { createModifierNode } from '../../../ast-utils/modifiers.js';
-import { RegExpUtils } from '../../../utils/regexp.js';
+import { RuleConversionError } from '../../../errors/rule-conversion-error.js';
+import { clone } from '../../../utils/clone.js';
 import { REGEX_MARKER, OPEN_SQUARE_BRACKET, CLOSE_SQUARE_BRACKET, COMMA, ESCAPE_CHARACTER } from '../../../utils/constants.js';
-import { StringUtils } from '../../../utils/string.js';
 import { MultiValueMap } from '../../../utils/multi-value-map.js';
-import { clone } from '../../../utils/clone.js';
+import { RegExpUtils } from '../../../utils/regexp.js';
+import { StringUtils } from '../../../utils/string.js';
 import { createConversionResult } from '../../base-interfaces/conversion-result.js';
 
 /**
- * @file Cosmetic rule modifier converter from uBO to ADG
+ * @file Cosmetic rule modifier converter from uBO to ADG.
  */
 const UBO_MATCHES_PATH_OPERATOR = 'matches-path';
 const ADG_PATH_MODIFIER = 'path';
 /**
- * Special characters in modifier regexps that should be escaped
+ * Special characters in modifier regexps that should be escaped.
  */
 const SPECIAL_MODIFIER_REGEX_CHARS = new Set([
     OPEN_SQUARE_BRACKET,
@@ -28,18 +28,21 @@ const SPECIAL_MODIFIER_REGEX_CHARS = new Set([
     ESCAPE_CHARACTER,
 ]);
 /**
- * Helper class for converting cosmetic rule modifiers from uBO to ADG
+ * Helper class for converting cosmetic rule modifiers from uBO to ADG.
  */
 class AdgCosmeticRuleModifierConverter {
     /**
      * Converts a uBO cosmetic rule modifier list to ADG, if possible.
      *
-     * @param modifierList Cosmetic rule modifier list node to convert
+     * @see {@link https://github.com/gorhill/uBlock/wiki/Procedural-cosmetic-filters#cosmetic-filter-operators}
+     *
+     * @param modifierList Cosmetic rule modifier list node to convert.
+     *
      * @returns An object which follows the {@link ConversionResult} interface. Its `result` property contains
      * the converted node, and its `isConverted` flag indicates whether the original node was converted.
-     * If the node was not converted, the result will contain the original node with the same object reference
-     * @throws If the modifier list cannot be converted
-     * @see {@link https://github.com/gorhill/uBlock/wiki/Procedural-cosmetic-filters#cosmetic-filter-operators}
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the modifier list cannot be converted.
      */
     static convertFromUbo(modifierList) {
         const conversionMap = new MultiValueMap();