@adguard/agtree 3.0.0 → 3.1.0

package/dist/{esm/generator/comment/comment-rule-generator.mjs → generator/comment/comment-rule-generator.js}

@@ -1,74 +1,21 @@
 /*
- * 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 { CommentRuleType } from '../../nodes/index.mjs';
-import { BaseGenerator } from '../base-generator.mjs';
-import { AgentCommentGenerator } from './agent-comment-generator.mjs';
-import { HintCommentGenerator } from './hint-comment-generator.mjs';
-import { PreProcessorCommentGenerator } from './pre-processor-comment-generator.mjs';
-import { MetadataCommentGenerator } from './metadata-comment-generator.mjs';
-import { ConfigCommentGenerator } from './config-comment-generator.mjs';
-import { SimpleCommentGenerator } from './simple-comment-generator.mjs';
+import { CommentRuleType } from '../../nodes/index.js';
+import { BaseGenerator } from '../base-generator.js';
+import { AgentCommentGenerator } from './agent-comment-generator.js';
+import { HintCommentGenerator } from './hint-comment-generator.js';
+import { PreProcessorCommentGenerator } from './pre-processor-comment-generator.js';
+import { MetadataCommentGenerator } from './metadata-comment-generator.js';
+import { ConfigCommentGenerator } from './config-comment-generator.js';
+import { SimpleCommentGenerator } from './simple-comment-generator.js';
 
 /* eslint-disable no-param-reassign */
 /**
- * `CommentParser` is responsible for parsing any comment-like adblock rules.
- *
- * @example
- * Example rules:
- *  - Adblock agent rules:
- *      - ```adblock
- *        [AdGuard]
- *        ```
- *      - ```adblock
- *        [Adblock Plus 2.0]
- *        ```
- *      - etc.
- *  - AdGuard hint rules:
- *      - ```adblock
- *        !+ NOT_OPTIMIZED
- *        ```
- *      - ```adblock
- *        !+ NOT_OPTIMIZED PLATFORM(windows)
- *        ```
- *      - etc.
- *  - Pre-processor rules:
- *      - ```adblock
- *        !#if (adguard)
- *        ```
- *      - ```adblock
- *        !#endif
- *        ```
- *      - etc.
- *  - Metadata rules:
- *      - ```adblock
- *        ! Title: My List
- *        ```
- *      - ```adblock
- *        ! Version: 2.0.150
- *        ```
- *      - etc.
- *  - AGLint inline config rules:
- *      - ```adblock
- *        ! aglint-enable some-rule
- *        ```
- *      - ```adblock
- *        ! aglint-disable some-rule
- *        ```
- *      - etc.
- *  - Simple comments:
- *      - Regular version:
- *        ```adblock
- *        ! This is just a comment
- *        ```
- *      - uBlock Origin / "hostlist" version:
- *        ```adblock
- *        # This is just a comment
- *        ```
- *      - etc.
+ * `CommentRuleGenerator` is responsible for generating any comment-like adblock rules.
  */
 class CommentRuleGenerator extends BaseGenerator {
     /**

package/dist/{esm/generator/comment/config-comment-generator.mjs → generator/comment/config-comment-generator.js}

@@ -1,13 +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 { BaseGenerator } from '../base-generator.mjs';
-import { SPACE, COMMA, EMPTY } from '../../utils/constants.mjs';
-import { ParameterListGenerator } from '../misc/parameter-list-generator.mjs';
+import { BaseGenerator } from '../base-generator.js';
+import { SPACE, COMMA, EMPTY } from '../../utils/constants.js';
+import { ParameterListGenerator } from '../misc/parameter-list-generator.js';
 
+/**
+ * Converts inline configuration comment nodes to their string format.
+ */
 class ConfigCommentGenerator extends BaseGenerator {
     /**
      * Converts an inline configuration comment node to a string.

package/dist/{esm/generator/comment/hint-comment-generator.mjs → generator/comment/hint-comment-generator.js}

@@ -1,13 +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 { BaseGenerator } from '../base-generator.mjs';
-import { SPACE, HINT_MARKER } from '../../utils/constants.mjs';
-import { HintGenerator } from './hint-generator.mjs';
+import { BaseGenerator } from '../base-generator.js';
+import { SPACE, HINT_MARKER } from '../../utils/constants.js';
+import { HintGenerator } from './hint-generator.js';
 
+/**
+ * Hint comment generator.
+ */
 class HintCommentGenerator extends BaseGenerator {
     /**
      * Converts a hint rule node to a raw string.

package/dist/{esm/generator/comment/hint-generator.mjs → generator/comment/hint-generator.js}

@@ -1,19 +1,22 @@
 /*
- * 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 { OPEN_PARENTHESIS, COMMA, CLOSE_PARENTHESIS, EMPTY } from '../../utils/constants.mjs';
-import { BaseGenerator } from '../base-generator.mjs';
-import { ParameterListGenerator } from '../misc/parameter-list-generator.mjs';
+import { OPEN_PARENTHESIS, COMMA, CLOSE_PARENTHESIS, EMPTY } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
+import { ParameterListGenerator } from '../misc/parameter-list-generator.js';
 
+/**
+ * Hint generator.
+ */
 class HintGenerator extends BaseGenerator {
     /**
-     * Converts a single hint AST to a string.
+     * Generates a string representation of a hint.
      *
-     * @param hint Hint AST
-     * @returns Hint string
+     * @param hint Hint AST node
+     * @returns String representation of the hint
      */
     static generate(hint) {
         let result = EMPTY;

package/dist/{esm/generator/comment/metadata-comment-generator.mjs → generator/comment/metadata-comment-generator.js}

@@ -1,13 +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 { SPACE, COLON, EMPTY } from '../../utils/constants.mjs';
-import { ValueGenerator } from '../misc/value-generator.mjs';
-import { BaseGenerator } from '../base-generator.mjs';
+import { SPACE, COLON, EMPTY } from '../../utils/constants.js';
+import { ValueGenerator } from '../misc/value-generator.js';
+import { BaseGenerator } from '../base-generator.js';
 
+/**
+ * Metadata comment generator.
+ */
 class MetadataCommentGenerator extends BaseGenerator {
     /**
      * Converts a metadata comment rule node to a string.

package/dist/{esm/generator/comment/pre-processor-comment-generator.mjs → generator/comment/pre-processor-comment-generator.js}

@@ -1,15 +1,18 @@
 /*
- * 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 { SAFARI_CB_AFFINITY, SPACE, OPEN_PARENTHESIS, CLOSE_PARENTHESIS, EMPTY, PREPROCESSOR_MARKER } from '../../utils/constants.mjs';
-import { BaseGenerator } from '../base-generator.mjs';
-import { ValueGenerator } from '../misc/value-generator.mjs';
-import { ParameterListGenerator } from '../misc/parameter-list-generator.mjs';
-import { LogicalExpressionGenerator } from '../misc/logical-expression-generator.mjs';
+import { SAFARI_CB_AFFINITY, SPACE, OPEN_PARENTHESIS, CLOSE_PARENTHESIS, EMPTY, PREPROCESSOR_MARKER } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
+import { ValueGenerator } from '../misc/value-generator.js';
+import { ParameterListGenerator } from '../misc/parameter-list-generator.js';
+import { LogicalExpressionGenerator } from '../misc/logical-expression-generator.js';
 
+/**
+ * Pre-processor comment generator.
+ */
 class PreProcessorCommentGenerator extends BaseGenerator {
     /**
      * Converts a pre-processor comment node to a string.

package/dist/{esm/generator/comment/simple-comment-generator.mjs → generator/comment/simple-comment-generator.js}

@@ -1,13 +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 { BaseGenerator } from '../base-generator.mjs';
-import { EMPTY } from '../../utils/constants.mjs';
-import { ValueGenerator } from '../misc/value-generator.mjs';
+import { BaseGenerator } from '../base-generator.js';
+import { EMPTY } from '../../utils/constants.js';
+import { ValueGenerator } from '../misc/value-generator.js';
 
+/**
+ * Simple comment generator.
+ */
 class SimpleCommentGenerator extends BaseGenerator {
     /**
      * Converts a comment rule node to a string.

package/dist/{esm/generator/cosmetic/body/abp-snippet-injection-body-generator.mjs → generator/cosmetic/body/abp-snippet-injection-body-generator.js}

@@ -1,20 +1,24 @@
 /*
- * 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 { SPACE, SEMICOLON } from '../../../utils/constants.mjs';
-import { BaseGenerator } from '../../base-generator.mjs';
-import { ParameterListGenerator } from '../../misc/parameter-list-generator.mjs';
-import { AbpSnippetInjectionBodyCommon } from '../../../common/abp-snippet-injection-body-common.mjs';
+import { SPACE, SEMICOLON } from '../../../utils/constants.js';
+import { BaseGenerator } from '../../base-generator.js';
+import { ParameterListGenerator } from '../../misc/parameter-list-generator.js';
+import { AbpSnippetInjectionBodyCommon } from '../../../common/abp-snippet-injection-body-common.js';
 
+/**
+ * Adblock Plus snippet injection body generator.
+ */
 class AbpSnippetInjectionBodyGenerator extends BaseGenerator {
     /**
      * Generates a string representation of the Adblock Plus-style snippet call body.
      *
      * @param node Scriptlet injection rule body
      * @returns String representation of the rule body
+     * @throws Error if the scriptlet call is empty
      */
     static generate(node) {
         const result = [];

package/dist/{esm/generator/cosmetic/body/adg-scriptlet-injection-body-generator.mjs → generator/cosmetic/body/adg-scriptlet-injection-body-generator.js}

@@ -1,16 +1,19 @@
 /*
- * 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 { CLOSE_PARENTHESIS, EMPTY, ADG_SCRIPTLET_MASK, OPEN_PARENTHESIS } from '../../../utils/constants.mjs';
-import { ParameterListGenerator } from '../../misc/parameter-list-generator.mjs';
-import { BaseGenerator } from '../../base-generator.mjs';
+import { CLOSE_PARENTHESIS, EMPTY, ADG_SCRIPTLET_MASK, OPEN_PARENTHESIS } from '../../../utils/constants.js';
+import { ParameterListGenerator } from '../../misc/parameter-list-generator.js';
+import { BaseGenerator } from '../../base-generator.js';
 
+/**
+ * AdGuard scriptlet injection body generator.
+ */
 class AdgScriptletInjectionBodyGenerator extends BaseGenerator {
     /**
-     * Error messages used by the parser.
+     * Error messages used by the generator.
      */
     static ERROR_MESSAGES = {
         NO_MULTIPLE_SCRIPTLET_CALLS: 'ADG syntaxes does not support multiple scriptlet calls within one single rule',
@@ -20,6 +23,7 @@ class AdgScriptletInjectionBodyGenerator extends BaseGenerator {
      *
      * @param node Scriptlet injection rule body
      * @returns String representation of the rule body
+     * @throws Error if the scriptlet call has multiple parameters
      */
     static generate(node) {
         const result = [];

package/dist/{esm/generator/cosmetic/body/ubo-scriptlet-injection-body-generator.mjs → generator/cosmetic/body/ubo-scriptlet-injection-body-generator.js}

@@ -1,16 +1,19 @@
 /*
- * 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 { BaseGenerator } from '../../base-generator.mjs';
-import { CLOSE_PARENTHESIS, EMPTY, UBO_SCRIPTLET_MASK, OPEN_PARENTHESIS } from '../../../utils/constants.mjs';
-import { ParameterListGenerator } from '../../misc/parameter-list-generator.mjs';
+import { BaseGenerator } from '../../base-generator.js';
+import { CLOSE_PARENTHESIS, EMPTY, UBO_SCRIPTLET_MASK, OPEN_PARENTHESIS } from '../../../utils/constants.js';
+import { ParameterListGenerator } from '../../misc/parameter-list-generator.js';
 
+/**
+ * uBlock scriptlet injection body generator.
+ */
 class UboScriptletInjectionBodyGenerator extends BaseGenerator {
     /**
-     * Error messages used by the parser.
+     * Error messages used by the generator.
      */
     static ERROR_MESSAGES = {
         NO_MULTIPLE_SCRIPTLET_CALLS: 'uBO syntaxes does not support multiple scriptlet calls within one single rule',
@@ -20,6 +23,7 @@ class UboScriptletInjectionBodyGenerator extends BaseGenerator {
      *
      * @param node Scriptlet injection rule body
      * @returns String representation of the rule body
+     * @throws Error if the scriptlet call has multiple parameters
      */
     static generate(node) {
         const result = [];

package/dist/{esm/generator/cosmetic/cosmetic-rule-body-generator.mjs → generator/cosmetic/cosmetic-rule-body-generator.js}

@@ -1,19 +1,22 @@
 /*
- * 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 { BaseGenerator } from '../base-generator.mjs';
-import { CosmeticRuleType } from '../../nodes/index.mjs';
-import { OPEN_PARENTHESIS, CLOSE_PARENTHESIS, SPACE, COLON, EMPTY } from '../../utils/constants.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { AdgScriptletInjectionBodyGenerator } from './body/adg-scriptlet-injection-body-generator.mjs';
-import { AdgCssInjectionGenerator } from '../css/adg-css-injection-generator.mjs';
-import { AbpSnippetInjectionBodyGenerator } from './body/abp-snippet-injection-body-generator.mjs';
-import { UboScriptletInjectionBodyGenerator } from './body/ubo-scriptlet-injection-body-generator.mjs';
-import { UboPseudoName } from '../../common/ubo-selector-common.mjs';
+import { BaseGenerator } from '../base-generator.js';
+import { CosmeticRuleType } from '../../nodes/index.js';
+import { CLOSE_PARENTHESIS, SPACE, COLON, OPEN_PARENTHESIS, EMPTY } from '../../utils/constants.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { AdgScriptletInjectionBodyGenerator } from './body/adg-scriptlet-injection-body-generator.js';
+import { AdgCssInjectionGenerator } from '../css/adg-css-injection-generator.js';
+import { AbpSnippetInjectionBodyGenerator } from './body/abp-snippet-injection-body-generator.js';
+import { UboScriptletInjectionBodyGenerator } from './body/ubo-scriptlet-injection-body-generator.js';
+import { UboPseudoName } from '../../common/ubo-selector-common.js';
 
+/**
+ * Cosmetic rule body generator.
+ */
 class CosmeticRuleBodyGenerator extends BaseGenerator {
     /**
      * Generates the rule body from the node.
@@ -24,16 +27,17 @@ class CosmeticRuleBodyGenerator extends BaseGenerator {
      * - '##.foo' → '.foo'
      * - 'example.com,example.org##.foo' → '.foo'
      * - 'example.com#%#//scriptlet('foo')' → '//scriptlet('foo')'
+     *
+     * @throws Error if the rule type is unknown
      */
     static generate(node) {
         let result = EMPTY;
-        // Body
         switch (node.type) {
             case CosmeticRuleType.ElementHidingRule:
                 result = node.body.selectorList.value;
                 break;
             case CosmeticRuleType.CssInjectionRule:
-                if (node.syntax === AdblockSyntax.Adg) {
+                if (node.syntax === AdblockSyntax.Adg || node.syntax === AdblockSyntax.Abp) {
                     result = AdgCssInjectionGenerator.generate(node.body);
                 }
                 else if (node.syntax === AdblockSyntax.Ubo) {

package/dist/{esm/generator/cosmetic/cosmetic-rule-generator.mjs → generator/cosmetic/cosmetic-rule-generator.js}

@@ -1,31 +1,21 @@
 /*
- * 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 { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { COLON, OPEN_PARENTHESIS, CLOSE_PARENTHESIS, SPACE, EMPTY } from '../../utils/constants.mjs';
-import { BaseGenerator } from '../base-generator.mjs';
-import { CosmeticRulePatternGenerator } from './cosmetic-rule-pattern-generator.mjs';
-import { CosmeticRuleBodyGenerator } from './cosmetic-rule-body-generator.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { COLON, CSS_NOT_PSEUDO, OPEN_PARENTHESIS, CLOSE_PARENTHESIS, SPACE, EMPTY } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
+import { CosmeticRulePatternGenerator } from './cosmetic-rule-pattern-generator.js';
+import { CosmeticRuleBodyGenerator } from './cosmetic-rule-body-generator.js';
 
 /**
- * `CosmeticRuleParser` is responsible for parsing cosmetic rules.
+ * `CosmeticRuleGenerator` is responsible for generating cosmetic rules from their AST representation.
  *
- * Where possible, it automatically detects the difference between supported syntaxes:
- *  - AdGuard
- *  - uBlock Origin
- *  - Adblock Plus
- *
- * If the syntax is common / cannot be determined, the parser gives `Common` syntax.
- *
- * Please note that syntactically correct rules are parsed even if they are not actually
- * compatible with the given adblocker. This is a completely natural behavior, meaningful
- * checking of compatibility is not done at the parser level.
+ * This class takes a parsed cosmetic rule Abstract Syntax Tree (AST) and converts it back into a raw string format.
+ * It handles the generation of the pattern, separator, uBO rule modifiers, and the rule body.
  */
-// TODO: Make raw body parsing optional
-// TODO: Split into smaller sections
 class CosmeticRuleGenerator extends BaseGenerator {
     /**
      * Converts a cosmetic rule AST into a string.
@@ -42,6 +32,11 @@ class CosmeticRuleGenerator extends BaseGenerator {
         // uBO rule modifiers
         if (node.syntax === AdblockSyntax.Ubo && node.modifiers) {
             node.modifiers.children.forEach((modifier) => {
+                if (modifier.exception) {
+                    result += COLON;
+                    result += CSS_NOT_PSEUDO;
+                    result += OPEN_PARENTHESIS;
+                }
                 result += COLON;
                 result += modifier.name.value;
                 if (modifier.value) {
@@ -49,9 +44,12 @@ class CosmeticRuleGenerator extends BaseGenerator {
                     result += modifier.value.value;
                     result += CLOSE_PARENTHESIS;
                 }
+                if (modifier.exception) {
+                    result += CLOSE_PARENTHESIS;
+                }
             });
             // If there are at least one modifier, add a space
-            if (node.modifiers.children.length) {
+            if (node.modifiers.children.some((modifier) => modifier?.name.value)) {
                 result += SPACE;
             }
         }

package/dist/{esm/generator/cosmetic/cosmetic-rule-pattern-generator.mjs → generator/cosmetic/cosmetic-rule-pattern-generator.js}

@@ -1,15 +1,18 @@
 /*
- * 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 { CLOSE_SQUARE_BRACKET, EMPTY, OPEN_SQUARE_BRACKET, DOLLAR_SIGN } from '../../utils/constants.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { BaseGenerator } from '../base-generator.mjs';
-import { ModifierListGenerator } from '../misc/modifier-list-generator.mjs';
-import { DomainListGenerator } from '../misc/domain-list-generator.mjs';
+import { CLOSE_SQUARE_BRACKET, EMPTY, OPEN_SQUARE_BRACKET, DOLLAR_SIGN } from '../../utils/constants.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { BaseGenerator } from '../base-generator.js';
+import { ModifierListGenerator } from '../misc/modifier-list-generator.js';
+import { DomainListGenerator } from '../misc/domain-list-generator.js';
 
+/**
+ * Cosmetic rule pattern generator.
+ */
 class CosmeticRulePatternGenerator extends BaseGenerator {
     /**
      * Generates the rule pattern from the AST.

package/dist/{esm/generator/css/adg-css-injection-generator.mjs → generator/css/adg-css-injection-generator.js}

@@ -1,13 +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 { COLON, SPACE, SEMICOLON, CSS_MEDIA_MARKER, OPEN_CURLY_BRACKET, CLOSE_CURLY_BRACKET, EMPTY } from '../../utils/constants.mjs';
-import { BaseGenerator } from '../base-generator.mjs';
-import { REMOVE_PROPERTY, REMOVE_VALUE } from '../../parser/css/adg-css-injection-parser.mjs';
+import { COLON, SPACE, SEMICOLON, CSS_MEDIA_MARKER, OPEN_CURLY_BRACKET, CLOSE_CURLY_BRACKET, EMPTY } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
+import { REMOVE_PROPERTY, REMOVE_VALUE } from '../../parser/css/adg-css-injection-parser.js';
 
+/**
+ * AdGuard CSS injection generator.
+ */
 class AdgCssInjectionGenerator extends BaseGenerator {
     static removeDeclaration = `${REMOVE_PROPERTY}${COLON}${SPACE}${REMOVE_VALUE}${SEMICOLON}`;
     /**

package/dist/{esm/generator/filterlist-generator.mjs → generator/filterlist-generator.js}

@@ -1,16 +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 { LF, CR, CRLF, EMPTY } from '../utils/constants.mjs';
-import { RuleGenerator } from './rule-generator.mjs';
-import { BaseGenerator } from './base-generator.mjs';
+import { EMPTY, LF, CR, CRLF } from '../utils/constants.js';
+import { RuleGenerator } from './rule-generator.js';
+import { BaseGenerator } from './base-generator.js';
 
 /**
- * `FilterListParser` is responsible for parsing a whole adblock filter list (list of rules).
- * It is a wrapper around `RuleParser` which parses each line separately.
+ * Generates a serialized filter list.
  */
 class FilterListGenerator extends BaseGenerator {
     /**
@@ -19,9 +18,11 @@ class FilterListGenerator extends BaseGenerator {
      * @param ast AST to generate
      * @param preferRaw If `true`, then the parser will use `raws.text` property of each rule
      * if it is available. Default is `false`.
+     * @param tolerant If `true`, errors during rule generation will be logged to the console and invalid rules
+     * will be skipped. If `false`, an error will be thrown on the first invalid rule. Default is `true`.
      * @returns Serialized filter list
      */
-    static generate(ast, preferRaw = false) {
+    static generate(ast, preferRaw = false, tolerant = true) {
         let result = EMPTY;
         for (let i = 0; i < ast.children.length; i += 1) {
             const rule = ast.children[i];
@@ -29,7 +30,18 @@ class FilterListGenerator extends BaseGenerator {
                 result += rule.raws.text;
             }
             else {
-                result += RuleGenerator.generate(rule);
+                try {
+                    result += RuleGenerator.generate(rule);
+                }
+                catch (error) {
+                    if (tolerant) {
+                        // eslint-disable-next-line no-console
+                        console.error(`Error when generating: ${error}`);
+                    }
+                    else {
+                        throw new Error(String(error));
+                    }
+                }
             }
             switch (rule.raws?.nl) {
                 case 'crlf':

package/dist/{esm/generator/index.mjs → generator/index.js}

@@ -1,9 +1,9 @@
 /*
- * 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
  */
-export { RuleGenerator } from './rule-generator.mjs';
-export { CosmeticRuleGenerator } from './cosmetic/cosmetic-rule-generator.mjs';
-export { CosmeticRuleBodyGenerator } from './cosmetic/cosmetic-rule-body-generator.mjs';
+export { RuleGenerator } from './rule-generator.js';
+export { CosmeticRuleGenerator } from './cosmetic/cosmetic-rule-generator.js';
+export { CosmeticRuleBodyGenerator } from './cosmetic/cosmetic-rule-body-generator.js';

package/dist/{esm/generator/misc/domain-list-generator.mjs → generator/misc/domain-list-generator.js}

@@ -1,12 +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 { BaseGenerator } from '../base-generator.mjs';
-import { ListItemsGenerator } from './list-items-generator.mjs';
+import { BaseGenerator } from '../base-generator.js';
+import { ListItemsGenerator } from './list-items-generator.js';
 
+/**
+ * Domain list generator.
+ */
 class DomainListGenerator extends BaseGenerator {
     /**
      * Converts a domain list node to a string.

package/dist/{esm/generator/misc/list-items-generator.mjs → generator/misc/list-items-generator.js}

@@ -1,11 +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 { NEGATION_MARKER, EMPTY } from '../../utils/constants.mjs';
+import { NEGATION_MARKER, EMPTY } from '../../utils/constants.js';
 
+/**
+ * Utility class for generating string representations of list items.
+ */
 class ListItemsGenerator {
     /**
      * Generates a string representation of a list item.