@adguard/agtree 4.0.0 → 4.0.2

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

@@ -1,37 +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 { ListNodeType, ListItemNodeType } from '../../../nodes/index.js';
 import { createModifierNode } from '../../../ast-utils/modifiers.js';
-import { RegExpUtils } from '../../../utils/regexp.js';
+import { ListNodeType, ListItemNodeType } from '../../../nodes/index.js';
+import '../../../utils/adblockers.js';
 import { ADG_PATH_MODIFIER, ADG_URL_MODIFIER, COMMA_DOMAIN_LIST_SEPARATOR, ADG_DOMAINS_MODIFIER, PIPE_MODIFIER_SEPARATOR, ADG_APP_MODIFIER, UBO_MATCHES_PATH_OPERATOR, OPEN_SQUARE_BRACKET, CLOSE_SQUARE_BRACKET, 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 { createConversionResult } from '../../base-interfaces/conversion-result.js';
-import '../../../utils/adblockers.js';
 import 'json5';
-import 'sprintf-js';
 import '@adguard/css-tokenizer';
-import { DomainListParser } from '../../../parser/misc/domain-list-parser.js';
-import '../../../parser/css/balancing.js';
+import 'sprintf-js';
 import '../../data/css.js';
-import 'tldts';
+import '../../../parser/css/balancing.js';
+import { DomainListParser } from '../../../parser/misc/domain-list-parser.js';
 import 'is-ip';
+import 'tldts';
+import { clone } from '../../../utils/clone.js';
+import { MultiValueMap } from '../../../utils/multi-value-map.js';
+import { RegExpUtils } from '../../../utils/regexp.js';
+import { createConversionResult } from '../../base-interfaces/conversion-result.js';
 
 /**
- * @file Cosmetic rule modifier converter from ADG to uBO
+ * @file Cosmetic rule modifier converter from ADG to uBO.
  */
 /**
  * Regular expression pattern for matching the main page
- * https://github.com/gorhill/uBlock/wiki/Procedural-cosmetic-filters#subjectmatches-patharg
+ * https://github.com/gorhill/uBlock/wiki/Procedural-cosmetic-filters#subjectmatches-patharg.
  */
 const UBO_MAIN_PAGE_MATCHER = '/^/$/';
 /**
- * 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,
@@ -40,18 +40,21 @@ const SPECIAL_MODIFIER_REGEX_CHARS = new Set([
     ESCAPE_CHARACTER,
 ]);
 /**
- * Helper class for converting cosmetic rule modifiers from ADG to uBO
+ * Helper class for converting cosmetic rule modifiers from ADG to uBO.
  */
 class UboCosmeticRuleModifierConverter {
     /**
      * Converts a ADG cosmetic rule modifier list to uBO, 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 convertFromAdg(modifierList) {
         const conversionMap = new MultiValueMap();

package/dist/converter/cosmetic/scriptlet.js

@@ -1,18 +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 { CosmeticRuleSeparator } from '../../nodes/index.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
-import { AdblockSyntax } from '../../utils/adblockers.js';
-import { QuoteUtils, QuoteType } from '../../utils/quotes.js';
-import { EMPTY, ADG_DOMAINS_MODIFIER, PIPE_MODIFIER_SEPARATOR, SPACE } from '../../utils/constants.js';
-import { getScriptletName, setScriptletName, transformAllScriptletArguments, setScriptletQuoteType, transformNthScriptletArgument } from '../../ast-utils/scriptlets.js';
-import { RuleConversionError } from '../../errors/rule-conversion-error.js';
-import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
 import { cloneScriptletRuleNode, cloneDomainListNode, cloneModifierListNode } from '../../ast-utils/clone.js';
+import { getScriptletName, setScriptletName, transformAllScriptletArguments, setScriptletQuoteType, transformNthScriptletArgument } from '../../ast-utils/scriptlets.js';
 import '../../compatibility-tables/modifiers.js';
 import '../../compatibility-tables/redirects.js';
 import { scriptletsCompatibilityTable } from '../../compatibility-tables/scriptlets.js';
@@ -25,18 +18,25 @@ import '../../compatibility-tables/schemas/platform.js';
 import '../../compatibility-tables/utils/platform-helpers.js';
 import '../../compatibility-tables/schemas/resource-type.js';
 import '../../compatibility-tables/utils/resource-type-helpers.js';
+import { RuleConversionError } from '../../errors/rule-conversion-error.js';
+import { CosmeticRuleSeparator } from '../../nodes/index.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { EMPTY, ADG_DOMAINS_MODIFIER, PIPE_MODIFIER_SEPARATOR, SPACE } from '../../utils/constants.js';
 import { isUndefined, isNull } from '../../utils/type-guards.js';
 import 'json5';
-import 'sprintf-js';
 import '@adguard/css-tokenizer';
-import { DomainListParser } from '../../parser/misc/domain-list-parser.js';
-import '../../parser/css/balancing.js';
+import 'sprintf-js';
 import '../data/css.js';
-import 'tldts';
+import '../../parser/css/balancing.js';
+import { DomainListParser } from '../../parser/misc/domain-list-parser.js';
+import { QuoteUtils, QuoteType } from '../../utils/quotes.js';
 import 'is-ip';
+import 'tldts';
+import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 
 /**
- * @file Scriptlet injection rule converter
+ * @file Scriptlet injection rule converter.
  */
 const ABP_SCRIPTLET_PREFIX = 'abp-';
 const UBO_SCRIPTLET_PREFIX = 'ubo-';
@@ -68,19 +68,21 @@ const REMOVE_ATTR_CLASS_APPLYING = new Set([
     'complete',
 ]);
 /**
- * Scriptlet injection rule converter class
+ * Scriptlet injection rule converter class.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class ScriptletRuleConverter extends RuleConverterBase {
     /**
      * Converts a scriptlet 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) {
         // Ignore AdGuard rules
@@ -226,11 +228,13 @@ class ScriptletRuleConverter extends RuleConverterBase {
     /**
      * Converts a scriptlet injection rule to uBlock 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) {
         // Ignore uBlock rules

package/dist/converter/css/index.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 { getFormattedTokenName, TokenType } from '@adguard/css-tokenizer';
 import { sprintf } from 'sprintf-js';
-import { EQUALS, COLON, CLOSE_PARENTHESIS, OPEN_PARENTHESIS, COMMA, EMPTY } from '../../utils/constants.js';
-import { LEGACY_EXT_CSS_ATTRIBUTE_PREFIX, ABP_EXT_CSS_PREFIX } from '../data/css.js';
-import { BaseConverter } from '../base-interfaces/base-converter.js';
-import { createConversionResult } from '../base-interfaces/conversion-result.js';
 import { CssTokenStream } from '../../parser/css/css-token-stream.js';
+import { EQUALS, COLON, CLOSE_PARENTHESIS, OPEN_PARENTHESIS, COMMA, EMPTY } from '../../utils/constants.js';
 import '../../utils/adblockers.js';
 import 'tldts';
 import 'glob-to-regexp';
 import { QuoteUtils } from '../../utils/quotes.js';
 import 'json5';
+import { LEGACY_EXT_CSS_ATTRIBUTE_PREFIX, ABP_EXT_CSS_PREFIX } from '../data/css.js';
 import '../../parser/css/balancing.js';
+import { BaseConverter } from '../base-interfaces/base-converter.js';
+import { createConversionResult } from '../base-interfaces/conversion-result.js';
 
 const ERROR_MESSAGES = {
     // eslint-disable-next-line max-len
@@ -40,19 +40,21 @@ const PSEUDO_ELEMENT_NAMES = new Set([
     PseudoElements.Before,
 ]);
 /**
- * CSS selector converter
+ * CSS selector converter.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class CssSelectorConverter extends BaseConverter {
     /**
-     * Converts Extended CSS elements to AdGuard-compatible ones
+     * Converts Extended CSS elements to AdGuard-compatible ones.
+     *
+     * @param selectorList Selector list to convert.
      *
-     * @param selectorList Selector list 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 rule is invalid or incompatible
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the rule is invalid or incompatible.
      */
     static convertToAdg(selectorList) {
         const stream = selectorList instanceof CssTokenStream

package/dist/converter/data/css.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
  */
 /**
  * @file Known CSS elements and attributes.
- * TODO: Implement a compatibility table for Extended CSS
+ * TODO: Implement a compatibility table for Extended CSS.
  */
 /**
  * Legacy Extended CSS attribute prefix.
@@ -33,18 +33,18 @@ const ABP_EXT_CSS_PREFIX = '-abp';
  */
 const NATIVE_CSS_PSEUDO_CLASSES = new Set([
     /**
-     * https://developer.mozilla.org/en-US/docs/Web/CSS/:has
-     * https://github.com/AdguardTeam/ExtendedCss#extended-css-has
+     * Https://developer.mozilla.org/en-US/docs/Web/CSS/:has
+     * https://github.com/AdguardTeam/ExtendedCss#extended-css-has.
      */
     'has',
     /**
-     * https://developer.mozilla.org/en-US/docs/Web/CSS/:is
-     * https://github.com/AdguardTeam/ExtendedCss#extended-css-is
+     * Https://developer.mozilla.org/en-US/docs/Web/CSS/:is
+     * https://github.com/AdguardTeam/ExtendedCss#extended-css-is.
      */
     'is',
     /**
-     * https://developer.mozilla.org/en-US/docs/Web/CSS/:not
-     * https://github.com/AdguardTeam/ExtendedCss#extended-css-not
+     * Https://developer.mozilla.org/en-US/docs/Web/CSS/:not
+     * https://github.com/AdguardTeam/ExtendedCss#extended-css-not.
      */
     'not',
 ]);

package/dist/converter/filter-list.js

@@ -1,40 +1,42 @@
 /*
- * 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 { RuleConverter } from './rule.js';
 import { clone } from '../utils/clone.js';
 import { MultiValueMap } from '../utils/multi-value-map.js';
-import { createConversionResult } from './base-interfaces/conversion-result.js';
 import { BaseConverter } from './base-interfaces/base-converter.js';
+import { createConversionResult } from './base-interfaces/conversion-result.js';
+import { RuleConverter } from './rule.js';
 
 /**
- * @file Adblock filter list converter
+ * @file Adblock filter list converter.
  */
 /**
- * Adblock filter list converter class
+ * Adblock filter list converter class.
  *
  * This class just provides an extra layer on top of the {@link RuleConverter}
  * and can be used to convert entire filter lists.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  * @todo Implement tolerant mode, which will allow to convert a filter list
- * even if some of its rules are invalid
+ * even if some of its rules are invalid.
  */
 class FilterListConverter extends BaseConverter {
     /**
      * Converts an adblock filter list to AdGuard format, if possible.
      *
-     * @param filterListNode Filter list node to convert
+     * @param filterListNode Filter list node to convert.
      * @param tolerant Indicates whether the converter should be tolerant to invalid rules. If enabled and a rule is
      * invalid, it will be left as is. If disabled and a rule is invalid, the whole filter list will be failed.
      * Defaults to `true`.
+     *
      * @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 filter list is invalid or cannot be converted (if the tolerant mode is disabled)
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the filter list is invalid or cannot be converted (if the tolerant mode is disabled).
      */
     static convertToAdg(filterListNode, tolerant = true) {
         // Prepare a map to store the converted rules by their index in the filter list

package/dist/converter/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/converter/misc/network-rule-modifier.js

@@ -1,16 +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 { SEMICOLON, SPACE } from '../../utils/constants.js';
-import { createModifierNode } from '../../ast-utils/modifiers.js';
-import { BaseConverter } from '../base-interfaces/base-converter.js';
-import { RuleConversionError } from '../../errors/rule-conversion-error.js';
-import { MultiValueMap } from '../../utils/multi-value-map.js';
-import { createConversionResult } from '../base-interfaces/conversion-result.js';
 import { cloneModifierListNode } from '../../ast-utils/clone.js';
+import { createModifierNode } from '../../ast-utils/modifiers.js';
 import { modifiersCompatibilityTable } from '../../compatibility-tables/modifiers.js';
 import { redirectsCompatibilityTable } from '../../compatibility-tables/redirects.js';
 import '../../compatibility-tables/scriptlets.js';
@@ -23,7 +18,12 @@ import '../../compatibility-tables/schemas/platform.js';
 import '../../compatibility-tables/utils/platform-helpers.js';
 import '../../compatibility-tables/schemas/resource-type.js';
 import { isValidResourceType } from '../../compatibility-tables/utils/resource-type-helpers.js';
+import { RuleConversionError } from '../../errors/rule-conversion-error.js';
+import { SEMICOLON, SPACE } from '../../utils/constants.js';
+import { MultiValueMap } from '../../utils/multi-value-map.js';
 import { isUndefined } from '../../utils/type-guards.js';
+import { BaseConverter } from '../base-interfaces/base-converter.js';
+import { createConversionResult } from '../base-interfaces/conversion-result.js';
 
 /**
  * @file Network rule modifier list converter.
@@ -85,18 +85,20 @@ const ADG_CONVERSION_MAP = new Map([
 /**
  * Helper class for converting network rule modifier lists.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class NetworkRuleModifierListConverter extends BaseConverter {
     /**
      * Converts a network rule modifier list to AdGuard format, if possible.
      *
-     * @param modifierList Network rule modifier list node to convert
-     * @param isException If `true`, the rule is an exception rule
+     * @param modifierList Network rule modifier list node to convert.
+     * @param isException If `true`, the rule is an exception rule.
+     *
      * @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 conversion is not possible
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the conversion is not possible.
      */
     static convertToAdg(modifierList, isException = false) {
         const conversionMap = new MultiValueMap();
@@ -197,12 +199,14 @@ class NetworkRuleModifierListConverter extends BaseConverter {
     /**
      * Converts a network rule modifier list to uBlock format, if possible.
      *
-     * @param modifierList Network rule modifier list node to convert
-     * @param isException If `true`, the rule is an exception rule
+     * @param modifierList Network rule modifier list node to convert.
+     * @param isException If `true`, the rule is an exception rule.
+     *
      * @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 conversion is not possible
+     * If the node was not converted, the result will contain the original node with the same object reference.
+     *
+     * @throws If the conversion is not possible.
      */
     // TODO: Optimize
     static convertToUbo(modifierList, isException = false) {

package/dist/converter/network/index.js

@@ -1,31 +1,33 @@
 /*
- * 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 { NetworkRuleType, RuleCategory } from '../../nodes/index.js';
-import { NetworkRuleModifierListConverter } from '../misc/network-rule-modifier.js';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
 import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { RuleConverterBase } from '../base-interfaces/rule-converter-base.js';
+import { NetworkRuleModifierListConverter } from '../misc/network-rule-modifier.js';
 
 /**
- * @file Network rule converter
+ * @file Network rule converter.
  */
 /**
- * Network rule converter class (also known as "basic rule converter")
+ * Network rule converter class (also known as "basic rule converter").
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class NetworkRuleConverter extends RuleConverterBase {
     /**
      * Converts a network 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 host rules
@@ -59,11 +61,13 @@ class NetworkRuleConverter extends RuleConverterBase {
     /**
      * Converts a network rule to uBlock 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) {
         // TODO: add support for host rules

package/dist/converter/raw-filter-list.js

@@ -1,18 +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 { createConversionResult } from './base-interfaces/conversion-result.js';
-import { BaseConverter } from './base-interfaces/base-converter.js';
+import { FilterListGenerator } from '../generator/filterlist-generator.js';
 import { FilterListParser } from '../parser/filterlist-parser.js';
-import { FilterListConverter } from './filter-list.js';
 import { defaultParserOptions } from '../parser/options.js';
-import { FilterListGenerator } from '../generator/filterlist-generator.js';
+import { BaseConverter } from './base-interfaces/base-converter.js';
+import { createConversionResult } from './base-interfaces/conversion-result.js';
+import { FilterListConverter } from './filter-list.js';
 
 /**
- * @file Filter list converter for raw filter lists
+ * @file Filter list converter for raw filter lists.
  *
  * Technically, this is a wrapper around `FilterListConverter` that works with nodes instead of strings.
  */
@@ -23,20 +23,22 @@ import { FilterListGenerator } from '../generator/filterlist-generator.js';
  * This class just provides an extra layer on top of the {@link FilterListConverter} and calls the parser/serializer
  * before/after the conversion internally.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class RawFilterListConverter extends BaseConverter {
     /**
      * Converts an adblock filter list text to AdGuard format, if possible.
      *
-     * @param rawFilterList Raw filter list text to convert
+     * @param rawFilterList Raw filter list text to convert.
      * @param tolerant Indicates whether the converter should be tolerant to invalid rules. If enabled and a rule is
      * invalid, it will be left as is. If disabled and a rule is invalid, the whole filter list will be failed.
      * Defaults to `true`.
+     *
      * @returns An object which follows the {@link ConversionResult} interface. Its `result` property contains
      * the array of converted filter list text, and its `isConverted` flag indicates whether the original rule was
-     * converted. If the rule was not converted, the original filter list text will be returned
-     * @throws If the filter list is invalid or cannot be converted (if the tolerant mode is disabled)
+     * converted. If the rule was not converted, the original filter list text will be returned.
+     *
+     * @throws If the filter list is invalid or cannot be converted (if the tolerant mode is disabled).
      */
     static convertToAdg(rawFilterList, tolerant = true) {
         const conversionResult = FilterListConverter.convertToAdg(FilterListParser.parse(rawFilterList, {

package/dist/converter/raw-rule.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 { createConversionResult } from './base-interfaces/conversion-result.js';
-import { RuleParser } from '../parser/rule-parser.js';
-import { RuleConverter } from './rule.js';
-import { BaseConverter } from './base-interfaces/base-converter.js';
 import { RuleGenerator } from '../generator/rule-generator.js';
 import '../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 { RuleParser } from '../parser/rule-parser.js';
+import { BaseConverter } from './base-interfaces/base-converter.js';
+import { createConversionResult } from './base-interfaces/conversion-result.js';
+import { RuleConverter } from './rule.js';
 
 /**
- * @file Rule converter for raw rules
+ * @file Rule converter for raw rules.
  *
  * Technically, this is a wrapper around `RuleConverter` that works with nodes instead of strings.
  */
@@ -30,17 +30,19 @@ import './data/css.js';
  * This class just provides an extra layer on top of the {@link RuleConverter} and calls the parser/serializer
  * before/after the conversion internally.
  *
- * @todo Implement `convertToUbo` and `convertToAbp`
+ * @todo Implement `convertToUbo` and `convertToAbp`.
  */
 class RawRuleConverter extends BaseConverter {
     /**
      * Converts an adblock filtering rule to AdGuard format, if possible.
      *
-     * @param rawRule Raw rule text to convert
+     * @param rawRule Raw rule text to convert.
+     *
      * @returns An object which follows the {@link ConversionResult} interface. Its `result` property contains
      * the array of converted rule texts, and its `isConverted` flag indicates whether the original rule was converted.
-     * If the rule was not converted, the original rule text will be returned
-     * @throws If the rule is invalid or cannot be converted
+     * If the rule was not converted, the original rule text will be returned.
+     *
+     * @throws If the rule is invalid or cannot be converted.
      */
     static convertToAdg(rawRule) {
         const conversionResult = RuleConverter.convertToAdg(RuleParser.parse(rawRule));