@adguard/agtree 3.0.0 → 3.0.1

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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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, 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.

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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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.

package/dist/{esm/generator/misc/logical-expression-generator.mjs → generator/misc/logical-expression-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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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 { OperatorValue } from '../../nodes/index.mjs';
-import { NodeType } from '../../parser/misc/logical-expression-parser.mjs';
+import { BaseGenerator } from '../base-generator.js';
+import { OperatorValue } from '../../nodes/index.js';
+import { NodeType } from '../../parser/misc/logical-expression-parser.js';
 
+/**
+ * Generator for logical expression nodes.
+ */
 class LogicalExpressionGenerator extends BaseGenerator {
     /**
      * Generates a string representation of the logical expression (serialization).

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

@@ -1,17 +1,20 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { MODIFIER_ASSIGN_OPERATOR, EMPTY, NEGATION_MARKER } from '../../utils/constants.mjs';
-import { BaseGenerator } from '../base-generator.mjs';
+import { MODIFIER_ASSIGN_OPERATOR, EMPTY, NEGATION_MARKER } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
 
+/**
+ * Generator for modifier nodes.
+ */
 class ModifierGenerator extends BaseGenerator {
     /**
-     * Generates a string from a modifier (serializes it).
+     * Converts a modifier AST node to a string.
      *
-     * @param modifier Modifier to generate string from
+     * @param modifier Modifier AST node to convert
      * @returns String representation of the modifier
      */
     static generate(modifier) {

package/dist/{esm/generator/misc/modifier-list-generator.mjs → generator/misc/modifier-list-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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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 { MODIFIERS_SEPARATOR } from '../../utils/constants.mjs';
-import { ModifierGenerator } from './modifier-generator.mjs';
+import { BaseGenerator } from '../base-generator.js';
+import { MODIFIERS_SEPARATOR } from '../../utils/constants.js';
+import { ModifierGenerator } from './modifier-generator.js';
 
+/**
+ * Generator for modifier list nodes.
+ */
 class ModifierListGenerator extends BaseGenerator {
     /**
      * Converts a modifier list AST to a string.

package/dist/{esm/generator/misc/parameter-list-generator.mjs → generator/misc/parameter-list-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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { SPACE, COMMA, EMPTY } from '../../utils/constants.mjs';
-import { BaseGenerator } from '../base-generator.mjs';
-import { ValueGenerator } from './value-generator.mjs';
+import { COMMA, SPACE, EMPTY } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
+import { ValueGenerator } from './value-generator.js';
 
+/**
+ * Generator for parameter list nodes.
+ */
 class ParameterListGenerator extends BaseGenerator {
     /**
      * Converts a parameter list AST to a string.
@@ -18,7 +21,6 @@ class ParameterListGenerator extends BaseGenerator {
      */
     static generate(params, separator = COMMA) {
         const collection = [];
-        // add parameters
         let i = 0;
         for (; i < params.children.length; i += 1) {
             const param = params.children[i];

package/dist/{esm/generator/misc/value-generator.mjs → generator/misc/value-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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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 { BaseGenerator } from '../base-generator.js';
 
+/**
+ * Generator for value nodes.
+ */
 class ValueGenerator extends BaseGenerator {
     /**
      * Converts a value node to a string.

package/dist/{esm/generator/network/host-rule-generator.mjs → generator/network/host-rule-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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { SPACE, HASHMARK, EMPTY } from '../../utils/constants.mjs';
-import { BaseGenerator } from '../base-generator.mjs';
+import { SPACE, HASHMARK, EMPTY } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
 
+/**
+ * Generator for host rule nodes.
+ */
 class HostRuleGenerator extends BaseGenerator {
     /**
      * Converts a host rule node to a raw string.

package/dist/{esm/generator/network/network-rule-generator.mjs → generator/network/network-rule-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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NETWORK_RULE_SEPARATOR, EMPTY, NETWORK_RULE_EXCEPTION_MARKER } from '../../utils/constants.mjs';
-import { BaseGenerator } from '../base-generator.mjs';
-import { ModifierListGenerator } from '../misc/modifier-list-generator.mjs';
+import { NETWORK_RULE_SEPARATOR, EMPTY, NETWORK_RULE_EXCEPTION_MARKER } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
+import { ModifierListGenerator } from '../misc/modifier-list-generator.js';
 
+/**
+ * Generator for network rule nodes.
+ */
 class NetworkRuleGenerator extends BaseGenerator {
     /**
-     * Converts a network rule (basic rule) AST to a string.
+     * Generates a string from a network rule AST node.
      *
-     * @param node Network rule node
-     * @returns Raw string
+     * @param node Network rule node to generate a string from.
+     * @returns Generated string representation of the network rule.
      */
     static generate(node) {
         let result = EMPTY;

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

@@ -1,17 +1,20 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 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 { RuleCategory, NetworkRuleType } from '../nodes/index.mjs';
-import { EMPTY } from '../utils/constants.mjs';
-import { CommentRuleGenerator } from './comment/comment-rule-generator.mjs';
-import { CosmeticRuleGenerator } from './cosmetic/cosmetic-rule-generator.mjs';
-import { HostRuleGenerator } from './network/host-rule-generator.mjs';
-import { NetworkRuleGenerator } from './network/network-rule-generator.mjs';
+import { BaseGenerator } from './base-generator.js';
+import { RuleCategory, NetworkRuleType } from '../nodes/index.js';
+import { EMPTY } from '../utils/constants.js';
+import { CommentRuleGenerator } from './comment/comment-rule-generator.js';
+import { CosmeticRuleGenerator } from './cosmetic/cosmetic-rule-generator.js';
+import { HostRuleGenerator } from './network/host-rule-generator.js';
+import { NetworkRuleGenerator } from './network/network-rule-generator.js';
 
+/**
+ * RuleGenerator is responsible for converting adblock rule ASTs to their string representation.
+ */
 class RuleGenerator extends BaseGenerator {
     /**
      * Converts a rule AST to a string.