@adguard/agtree 3.0.0 → 3.1.0

package/dist/{esm/converter/cosmetic/index.mjs → converter/cosmetic/index.js}

@@ -1,20 +1,29 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { CosmeticRuleType, RuleCategory } from '../../nodes/index.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { HtmlRuleConverter } from './html.mjs';
-import { ScriptletRuleConverter } from './scriptlet.mjs';
-import { RuleConversionError } from '../../errors/rule-conversion-error.mjs';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.mjs';
-import { AdgCosmeticRuleModifierConverter } from './rule-modifiers/adg.mjs';
-import { CssInjectionRuleConverter } from './css.mjs';
-import { ElementHidingRuleConverter } from './element-hiding.mjs';
-import { HeaderRemovalRuleConverter } from './header-removal.mjs';
-import { createNodeConversionResult } from '../base-interfaces/conversion-result.mjs';
+import { CosmeticRuleType, RuleCategory } 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 { COMMA } from '../../utils/constants.js';
+import 'tldts';
+import 'sprintf-js';
+import '@adguard/css-tokenizer';
+import 'json5';
+import '../../parser/css/balancing.js';
+import '../data/css.js';
 
 /**
  * @file Cosmetic rule converter
@@ -111,6 +120,27 @@ class CosmeticRuleConverter extends RuleConverterBase {
             }
             return ScriptletRuleConverter.convertToUbo(rule);
         }
+        let convertedModifiers;
+        // Convert cosmetic rule modifiers, if any
+        if (rule.modifiers) {
+            if (rule.syntax === AdblockSyntax.Abp) {
+                // TODO: Implement once ABP starts supporting cosmetic rule modifiers
+                throw new RuleConversionError('ABP does not support cosmetic rule modifiers');
+            }
+            else if (rule.syntax === AdblockSyntax.Adg) {
+                convertedModifiers = UboCosmeticRuleModifierConverter.convertFromAdg(rule.modifiers);
+            }
+        }
+        if (convertedModifiers && convertedModifiers.isConverted) {
+            const result = clone(rule);
+            result.modifiers = convertedModifiers.result.modifierList;
+            result.syntax = AdblockSyntax.Ubo;
+            if (convertedModifiers.result.domains) {
+                result.domains = convertedModifiers.result.domains;
+                result.domains.separator = COMMA;
+            }
+            return createNodeConversionResult([result], true);
+        }
         return createNodeConversionResult([rule], false);
     }
 }

package/dist/{esm/converter/cosmetic/rule-modifiers/adg.mjs → converter/cosmetic/rule-modifiers/adg.js}

@@ -1,17 +1,17 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 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.mjs';
-import { createModifierNode } from '../../../ast-utils/modifiers.mjs';
-import { RegExpUtils } from '../../../utils/regexp.mjs';
-import { REGEX_MARKER, OPEN_SQUARE_BRACKET, CLOSE_SQUARE_BRACKET, COMMA, ESCAPE_CHARACTER } from '../../../utils/constants.mjs';
-import { StringUtils } from '../../../utils/string.mjs';
-import { MultiValueMap } from '../../../utils/multi-value-map.mjs';
-import { clone } from '../../../utils/clone.mjs';
-import { createConversionResult } from '../../base-interfaces/conversion-result.mjs';
+import { RuleConversionError } from '../../../errors/rule-conversion-error.js';
+import { createModifierNode } from '../../../ast-utils/modifiers.js';
+import { RegExpUtils } from '../../../utils/regexp.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 { createConversionResult } from '../../base-interfaces/conversion-result.js';
 
 /**
  * @file Cosmetic rule modifier converter from uBO to ADG

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

@@ -0,0 +1,149 @@
+/*
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 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 { 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 'json5';
+import 'sprintf-js';
+import '@adguard/css-tokenizer';
+import { DomainListParser } from '../../../parser/misc/domain-list-parser.js';
+import '../../../parser/css/balancing.js';
+import '../../data/css.js';
+import 'tldts';
+import 'is-ip';
+
+/**
+ * @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
+ */
+const UBO_MAIN_PAGE_MATCHER = '/^/$/';
+/**
+ * Special characters in modifier regexps that should be escaped
+ */
+const SPECIAL_MODIFIER_REGEX_CHARS = new Set([
+    OPEN_SQUARE_BRACKET,
+    CLOSE_SQUARE_BRACKET,
+    COMMA_DOMAIN_LIST_SEPARATOR,
+    ESCAPE_CHARACTER,
+]);
+/**
+ * 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
+     * @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}
+     */
+    static convertFromAdg(modifierList) {
+        const conversionMap = new MultiValueMap();
+        let domainList = null;
+        let regexDomainValue;
+        modifierList.children.forEach((modifier, index) => {
+            let value;
+            let { exception } = modifier;
+            switch (modifier.name.value) {
+                // Special case: ADG's $app modifier
+                case ADG_APP_MODIFIER:
+                    throw new Error('The $app modifier is not supported by uBO');
+                // Special case: ADG's $domains modifier
+                case ADG_DOMAINS_MODIFIER:
+                    if (!domainList) {
+                        domainList = {
+                            type: ListNodeType.DomainList,
+                            separator: COMMA_DOMAIN_LIST_SEPARATOR,
+                            children: [],
+                            start: modifier.start,
+                            end: modifier.end,
+                        };
+                    }
+                    if (!modifier?.value?.value) {
+                        return;
+                    }
+                    domainList = DomainListParser.parse(modifier.value.value, {}, modifier.start, PIPE_MODIFIER_SEPARATOR);
+                    conversionMap.add(index, null);
+                    break;
+                // Special case: ADG's $url modifier
+                case ADG_URL_MODIFIER:
+                    if (!domainList) {
+                        domainList = {
+                            type: ListNodeType.DomainList,
+                            separator: COMMA_DOMAIN_LIST_SEPARATOR,
+                            children: [],
+                            start: modifier.start,
+                            end: modifier.end,
+                        };
+                    }
+                    if (!modifier?.value?.value) {
+                        return;
+                    }
+                    regexDomainValue = RegExpUtils.patternToRegexp(modifier.value.value);
+                    domainList = {
+                        type: ListNodeType.DomainList,
+                        separator: COMMA_DOMAIN_LIST_SEPARATOR,
+                        children: [
+                            {
+                                type: ListItemNodeType.Domain,
+                                value: RegExpUtils.ensureSlashes(regexDomainValue),
+                                exception: modifier?.exception ?? false,
+                            },
+                        ],
+                        start: modifier.start,
+                        end: modifier.end,
+                    };
+                    conversionMap.add(index, null);
+                    break;
+                // Special case: ADG's $path modifier
+                case ADG_PATH_MODIFIER:
+                    if (!modifier.value) {
+                        value = UBO_MAIN_PAGE_MATCHER;
+                    }
+                    else if (RegExpUtils.isNegatedRegexPattern(modifier.value.value)) {
+                        exception = true;
+                        value = StringUtils.escapeCharacters(RegExpUtils.removeNegationFromRegexPattern(modifier.value.value), SPECIAL_MODIFIER_REGEX_CHARS);
+                    }
+                    else {
+                        value = RegExpUtils.isRegexPattern(modifier.value.value)
+                            ? StringUtils.escapeCharacters(modifier.value.value, SPECIAL_MODIFIER_REGEX_CHARS)
+                            : modifier.value.value;
+                    }
+                    conversionMap.add(index, createModifierNode(UBO_MATCHES_PATH_OPERATOR, value, exception));
+                    break;
+            }
+        });
+        // Check if we have any converted modifiers
+        if (conversionMap.size) {
+            const modifierListClone = clone(modifierList);
+            // Replace the original modifiers with the converted ones
+            modifierListClone.children = modifierListClone.children
+                .map((modifier, index) => {
+                const convertedModifier = conversionMap.get(index);
+                return convertedModifier ?? modifier;
+            })
+                .flat()
+                .filter((modifier) => modifier !== null);
+            return createConversionResult({ modifierList: modifierListClone, domains: domainList || undefined }, true);
+        }
+        // Otherwise, just return the original modifier list without any changes
+        return createConversionResult({ modifierList, domains: undefined }, false);
+    }
+}
+
+export { UboCosmeticRuleModifierConverter };

package/dist/{esm/converter/cosmetic/scriptlet.mjs → converter/cosmetic/scriptlet.js}

@@ -1,30 +1,30 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { CosmeticRuleSeparator } from '../../nodes/index.mjs';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { QuoteUtils, QuoteType } from '../../utils/quotes.mjs';
-import { EMPTY, SPACE } from '../../utils/constants.mjs';
-import { getScriptletName, setScriptletName, transformAllScriptletArguments, setScriptletQuoteType, transformNthScriptletArgument } from '../../ast-utils/scriptlets.mjs';
-import { createNodeConversionResult } from '../base-interfaces/conversion-result.mjs';
-import { cloneScriptletRuleNode, cloneDomainListNode, cloneModifierListNode } from '../../ast-utils/clone.mjs';
-import '../../compatibility-tables/modifiers.mjs';
-import '../../compatibility-tables/redirects.mjs';
-import { scriptletsCompatibilityTable } from '../../compatibility-tables/scriptlets.mjs';
-import { GenericPlatform } from '../../compatibility-tables/platforms.mjs';
-import '../../compatibility-tables/schemas/base.mjs';
-import '../../compatibility-tables/schemas/modifier.mjs';
-import '../../compatibility-tables/schemas/redirect.mjs';
-import '../../compatibility-tables/schemas/scriptlet.mjs';
-import '../../compatibility-tables/schemas/platform.mjs';
-import '../../compatibility-tables/utils/platform-helpers.mjs';
-import '../../compatibility-tables/schemas/resource-type.mjs';
-import '../../compatibility-tables/utils/resource-type-helpers.mjs';
-import { isUndefined, isNull } from '../../utils/type-guards.mjs';
+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, SPACE } from '../../utils/constants.js';
+import { getScriptletName, setScriptletName, transformAllScriptletArguments, setScriptletQuoteType, transformNthScriptletArgument } from '../../ast-utils/scriptlets.js';
+import { createNodeConversionResult } from '../base-interfaces/conversion-result.js';
+import { cloneScriptletRuleNode, cloneDomainListNode, cloneModifierListNode } from '../../ast-utils/clone.js';
+import '../../compatibility-tables/modifiers.js';
+import '../../compatibility-tables/redirects.js';
+import { scriptletsCompatibilityTable } from '../../compatibility-tables/scriptlets.js';
+import { GenericPlatform } from '../../compatibility-tables/platforms.js';
+import '../../compatibility-tables/schemas/base.js';
+import '../../compatibility-tables/schemas/modifier.js';
+import '../../compatibility-tables/schemas/redirect.js';
+import '../../compatibility-tables/schemas/scriptlet.js';
+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 { isUndefined, isNull } from '../../utils/type-guards.js';
 
 /**
  * @file Scriptlet injection rule converter

package/dist/{esm/converter/css/index.mjs → converter/css/index.js}

@@ -1,38 +1,34 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 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.mjs';
-import { LEGACY_EXT_CSS_ATTRIBUTE_PREFIX, ABP_EXT_CSS_PREFIX } from '../data/css.mjs';
-import { BaseConverter } from '../base-interfaces/base-converter.mjs';
-import { createConversionResult } from '../base-interfaces/conversion-result.mjs';
-import { CssTokenStream } from '../../parser/css/css-token-stream.mjs';
+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';
 
 const ERROR_MESSAGES = {
     // eslint-disable-next-line max-len
     INVALID_ATTRIBUTE_VALUE: `Expected '${getFormattedTokenName(TokenType.Ident)}' or '${getFormattedTokenName(TokenType.String)}' as attribute value, but got '%s' with value '%s`,
 };
-var PseudoClasses;
-(function (PseudoClasses) {
-    PseudoClasses["AbpContains"] = "-abp-contains";
-    PseudoClasses["AbpHas"] = "-abp-has";
-    PseudoClasses["Contains"] = "contains";
-    PseudoClasses["Has"] = "has";
-    PseudoClasses["HasText"] = "has-text";
-    PseudoClasses["MatchesCss"] = "matches-css";
-    PseudoClasses["MatchesCssAfter"] = "matches-css-after";
-    PseudoClasses["MatchesCssBefore"] = "matches-css-before";
-    PseudoClasses["Not"] = "not";
-})(PseudoClasses || (PseudoClasses = {}));
-var PseudoElements;
-(function (PseudoElements) {
-    PseudoElements["After"] = "after";
-    PseudoElements["Before"] = "before";
-})(PseudoElements || (PseudoElements = {}));
+const PseudoClasses = {
+    AbpContains: '-abp-contains',
+    AbpHas: '-abp-has',
+    Contains: 'contains',
+    Has: 'has',
+    HasText: 'has-text',
+    MatchesCss: 'matches-css',
+    MatchesCssAfter: 'matches-css-after',
+    MatchesCssBefore: 'matches-css-before'};
+const PseudoElements = {
+    After: 'after',
+    Before: 'before',
+};
 const PSEUDO_ELEMENT_NAMES = new Set([
     PseudoElements.After,
     PseudoElements.Before,
@@ -187,4 +183,4 @@ class CssSelectorConverter extends BaseConverter {
     }
 }
 
-export { CssSelectorConverter, ERROR_MESSAGES };
+export { CssSelectorConverter, ERROR_MESSAGES, PseudoClasses, PseudoElements };

package/dist/{esm/converter/data/css.mjs → converter/data/css.js}

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

package/dist/{esm/converter/filter-list.mjs → converter/filter-list.js}

@@ -1,14 +1,14 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { RuleConverter } from './rule.mjs';
-import { clone } from '../utils/clone.mjs';
-import { MultiValueMap } from '../utils/multi-value-map.mjs';
-import { createConversionResult } from './base-interfaces/conversion-result.mjs';
-import { BaseConverter } from './base-interfaces/base-converter.mjs';
+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';
 
 /**
  * @file Adblock filter list converter

package/dist/converter/index.js

@@ -0,0 +1,8 @@
+/*
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+export { RawFilterListConverter } from './raw-filter-list.js';
+export { RuleConverter } from './rule.js';

package/dist/{esm/converter/misc/network-rule-modifier.mjs → converter/misc/network-rule-modifier.js}

@@ -1,29 +1,29 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { SEMICOLON, SPACE } from '../../utils/constants.mjs';
-import { createModifierNode } from '../../ast-utils/modifiers.mjs';
-import { BaseConverter } from '../base-interfaces/base-converter.mjs';
-import { RuleConversionError } from '../../errors/rule-conversion-error.mjs';
-import { MultiValueMap } from '../../utils/multi-value-map.mjs';
-import { createConversionResult } from '../base-interfaces/conversion-result.mjs';
-import { cloneModifierListNode } from '../../ast-utils/clone.mjs';
-import { modifiersCompatibilityTable } from '../../compatibility-tables/modifiers.mjs';
-import { redirectsCompatibilityTable } from '../../compatibility-tables/redirects.mjs';
-import '../../compatibility-tables/scriptlets.mjs';
-import { GenericPlatform } from '../../compatibility-tables/platforms.mjs';
-import '../../compatibility-tables/schemas/base.mjs';
-import '../../compatibility-tables/schemas/modifier.mjs';
-import '../../compatibility-tables/schemas/redirect.mjs';
-import '../../compatibility-tables/schemas/scriptlet.mjs';
-import '../../compatibility-tables/schemas/platform.mjs';
-import '../../compatibility-tables/utils/platform-helpers.mjs';
-import '../../compatibility-tables/schemas/resource-type.mjs';
-import { isValidResourceType } from '../../compatibility-tables/utils/resource-type-helpers.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
+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 { modifiersCompatibilityTable } from '../../compatibility-tables/modifiers.js';
+import { redirectsCompatibilityTable } from '../../compatibility-tables/redirects.js';
+import '../../compatibility-tables/scriptlets.js';
+import { GenericPlatform } from '../../compatibility-tables/platforms.js';
+import '../../compatibility-tables/schemas/base.js';
+import '../../compatibility-tables/schemas/modifier.js';
+import '../../compatibility-tables/schemas/redirect.js';
+import '../../compatibility-tables/schemas/scriptlet.js';
+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 { isUndefined } from '../../utils/type-guards.js';
 
 /**
  * @file Network rule modifier list converter.

package/dist/{esm/converter/network/index.mjs → converter/network/index.js}

@@ -1,13 +1,13 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NetworkRuleType, RuleCategory } from '../../nodes/index.mjs';
-import { NetworkRuleModifierListConverter } from '../misc/network-rule-modifier.mjs';
-import { RuleConverterBase } from '../base-interfaces/rule-converter-base.mjs';
-import { createNodeConversionResult } from '../base-interfaces/conversion-result.mjs';
+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';
 
 /**
  * @file Network rule converter

package/dist/{esm/converter/raw-filter-list.mjs → converter/raw-filter-list.js}

@@ -1,15 +1,15 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 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.mjs';
-import { BaseConverter } from './base-interfaces/base-converter.mjs';
-import { FilterListParser } from '../parser/filterlist-parser.mjs';
-import { FilterListConverter } from './filter-list.mjs';
-import { defaultParserOptions } from '../parser/options.mjs';
-import { FilterListGenerator } from '../generator/filterlist-generator.mjs';
+import { createConversionResult } from './base-interfaces/conversion-result.js';
+import { BaseConverter } from './base-interfaces/base-converter.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';
 
 /**
  * @file Filter list converter for raw filter lists
@@ -49,7 +49,7 @@ class RawFilterListConverter extends BaseConverter {
             return createConversionResult(rawFilterList, false);
         }
         // Otherwise, serialize the filter list and return the result
-        return createConversionResult(FilterListGenerator.generate(conversionResult.result), true);
+        return createConversionResult(FilterListGenerator.generate(conversionResult.result, false, tolerant), true);
     }
 }
 

package/dist/{esm/converter/rule.mjs → converter/rule.js}

@@ -1,16 +1,16 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { RuleCategory, NetworkRuleType } from '../nodes/index.mjs';
-import { CommentRuleConverter } from './comment/index.mjs';
-import { CosmeticRuleConverter } from './cosmetic/index.mjs';
-import { NetworkRuleConverter } from './network/index.mjs';
-import { RuleConversionError } from '../errors/rule-conversion-error.mjs';
-import { RuleConverterBase } from './base-interfaces/rule-converter-base.mjs';
-import { createConversionResult } from './base-interfaces/conversion-result.mjs';
+import { RuleCategory, NetworkRuleType } from '../nodes/index.js';
+import { CommentRuleConverter } from './comment/index.js';
+import { CosmeticRuleConverter } from './cosmetic/index.js';
+import { NetworkRuleConverter } from './network/index.js';
+import { RuleConversionError } from '../errors/rule-conversion-error.js';
+import { RuleConverterBase } from './base-interfaces/rule-converter-base.js';
+import { createConversionResult } from './base-interfaces/conversion-result.js';
 
 /**
  * @file Adblock rule converter

package/dist/{esm/deserializer/base-deserializer.mjs → deserializer/base-deserializer.js}

@@ -1,13 +1,13 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NotImplementedError } from '../errors/not-implemented-error.mjs';
+import { NotImplementedError } from '../errors/not-implemented-error.js';
 
 /**
- * @file Base serializer class.
+ * @file Base deserializer class.
  */
 /**
  * Base class for deserializers. Each deserializer should extend this class.

package/dist/{esm/deserializer/comment/agent-comment-deserializer.mjs → deserializer/comment/agent-comment-deserializer.js}

@@ -1,16 +1,16 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { CommentRuleType, RuleCategory } from '../../nodes/index.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { AgentCommentMarshallingMap } from '../../marshalling-utils/comment/agent-comment-common.mjs';
-import { AgentDeserializer } from './agent-deserializer.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { CommentRuleType, RuleCategory } from '../../nodes/index.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { AgentCommentMarshallingMap } from '../../marshalling-utils/comment/agent-comment-common.js';
+import { AgentDeserializer } from './agent-deserializer.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
 /**
@@ -68,6 +68,11 @@ class AgentCommentDeserializer extends BaseDeserializer {
             }
             prop = buffer.readUint8();
         }
+        // Maybe children are not present in the binary data,
+        // in this case, we should initialize it as an empty array.
+        if (!node.children) {
+            node.children = [];
+        }
     }
 }