@adguard/agtree 3.0.0 → 3.1.0

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

@@ -1,12 +1,12 @@
 /*
- * 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 { ScriptletBodySerializer } from './scriptlet-body-serializer.mjs';
-import { BaseSerializer } from '../../base-serializer.mjs';
-import { FREQUENT_UBO_SCRIPTLET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/ubo-scriptlet-injection-body-common.mjs';
+import { ScriptletBodySerializer } from './scriptlet-body-serializer.js';
+import { BaseSerializer } from '../../base-serializer.js';
+import { FREQUENT_UBO_SCRIPTLET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/ubo-scriptlet-injection-body-common.js';
 
 /**
  * `UboScriptletInjectionBodySerializer` is responsible for serializing the body of a uBlock-style scriptlet rule.

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

@@ -1,42 +1,33 @@
 /*
- * 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 { DomainListSerializer } from '../misc/domain-list-serializer.mjs';
-import { NULL } from '../../utils/constants.mjs';
-import { CosmeticRuleType } from '../../nodes/index.mjs';
-import { AbpSnippetInjectionBodySerializer } from './body/abp-snippet-injection-body-serializer.mjs';
-import { UboScriptletInjectionBodySerializer } from './body/ubo-scriptlet-injection-body-serializer.mjs';
-import { AdgScriptletInjectionBodySerializer } from './body/adg-scriptlet-injection-body-serializer.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { ElementHidingBodySerializer } from './element-hiding-body-serializer.mjs';
-import { CssInjectionBodySerializer } from './css-injection-body-serializer.mjs';
-import { ModifierListSerializer } from '../misc/modifier-list-serializer.mjs';
-import { CosmeticRuleMarshallingMap, COSMETIC_RULE_SEPARATOR_SERIALIZATION_MAP } from '../../marshalling-utils/cosmetic/cosmetic-rule-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
-import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { DomainListSerializer } from '../misc/domain-list-serializer.js';
+import { NULL } from '../../utils/constants.js';
+import { CosmeticRuleType } from '../../nodes/index.js';
+import { AbpSnippetInjectionBodySerializer } from './body/abp-snippet-injection-body-serializer.js';
+import { UboScriptletInjectionBodySerializer } from './body/ubo-scriptlet-injection-body-serializer.js';
+import { AdgScriptletInjectionBodySerializer } from './body/adg-scriptlet-injection-body-serializer.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { ElementHidingBodySerializer } from './element-hiding-body-serializer.js';
+import { CssInjectionBodySerializer } from './css-injection-body-serializer.js';
+import { ModifierListSerializer } from '../misc/modifier-list-serializer.js';
+import { CosmeticRuleMarshallingMap, COSMETIC_RULE_SEPARATOR_SERIALIZATION_MAP } from '../../marshalling-utils/cosmetic/cosmetic-rule-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.js';
 
 /**
- * `CosmeticRuleParser` is responsible for parsing cosmetic rules.
+ * `CosmeticRuleSerializer` is responsible for serializing cosmetic rules into a binary format.
  *
- * 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 cosmetic rule Abstract Syntax Tree (AST) and converts it into a compact binary representation.
+ * It handles the serialization of different types of cosmetic rules, including element hiding, CSS injection,
+ * JavaScript injection, HTML filtering, and scriptlet injection rules.
  */
-// TODO: Make raw body parsing optional
-// TODO: Split into smaller sections
 class CosmeticRuleSerializer extends BaseSerializer {
     /**
      * Serializes a cosmetic rule node to binary format.

package/dist/{esm/serializer/cosmetic/css-injection-body-serializer.mjs → serializer/cosmetic/css-injection-body-serializer.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 { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { NULL } from '../../utils/constants.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { CssInjectionRuleMarshallingMap } from '../../marshalling-utils/cosmetic/body/css-injection-body-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { NULL } from '../../utils/constants.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { CssInjectionRuleMarshallingMap } from '../../marshalling-utils/cosmetic/body/css-injection-body-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for CSS injection rule body nodes.
+ */
 class CssInjectionBodySerializer extends BaseSerializer {
     /**
      * Serializes a CSS injection rule body node to binary format.

package/dist/{esm/serializer/cosmetic/element-hiding-body-serializer.mjs → serializer/cosmetic/element-hiding-body-serializer.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 { BaseSerializer } from '../base-serializer.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { NULL } from '../../utils/constants.mjs';
-import { ElementHidingRuleMarshallingMap } from '../../marshalling-utils/cosmetic/body/element-hiding-body-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseSerializer } from '../base-serializer.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { NULL } from '../../utils/constants.js';
+import { ElementHidingRuleMarshallingMap } from '../../marshalling-utils/cosmetic/body/element-hiding-body-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for element hiding rule body nodes.
+ */
 class ElementHidingBodySerializer extends BaseSerializer {
     /**
      * Serializes an element hiding rule body node to binary format.

package/dist/{esm/serializer/empty-rule-serializer.mjs → serializer/empty-rule-serializer.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 { BaseSerializer } from './base-serializer.mjs';
-import { isUndefined } from '../utils/type-guards.mjs';
-import { NULL } from '../utils/constants.mjs';
-import { EmptyRuleMarshallingMap } from '../marshalling-utils/empty-rule-common.mjs';
-import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseSerializer } from './base-serializer.js';
+import { isUndefined } from '../utils/type-guards.js';
+import { NULL } from '../utils/constants.js';
+import { EmptyRuleMarshallingMap } from '../marshalling-utils/empty-rule-common.js';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for empty rule nodes.
+ */
 class EmptyRuleSerializer extends BaseSerializer {
     /**
      * Serializes an empty rule node to binary format.

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

@@ -1,19 +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 { NULL } from '../utils/constants.mjs';
-import { isUndefined } from '../utils/type-guards.mjs';
-import { BaseSerializer } from './base-serializer.mjs';
-import { RuleSerializer } from './rule-serializer.mjs';
-import { FilterListNodeMarshallingMap } from '../marshalling-utils/filter-list-common.mjs';
-import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../utils/constants.js';
+import { isUndefined } from '../utils/type-guards.js';
+import { BaseSerializer } from './base-serializer.js';
+import { RuleSerializer } from './rule-serializer.js';
+import { FilterListNodeMarshallingMap } from '../marshalling-utils/filter-list-common.js';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.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.
+ * Serializes filter list nodes to binary format.
  */
 class FilterListSerializer extends BaseSerializer {
     /**

package/dist/serializer/index.js

@@ -0,0 +1,7 @@
+/*
+ * 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 { RuleSerializer } from './rule-serializer.js';

package/dist/{esm/serializer/invalid-rule-error-node-serializer.mjs → serializer/invalid-rule-error-node-serializer.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 { BaseSerializer } from './base-serializer.mjs';
-import { isUndefined } from '../utils/type-guards.mjs';
-import { NULL } from '../utils/constants.mjs';
-import { InvalidRuleErrorNodeMarshallingMap } from '../marshalling-utils/invalid-rule-error-node-common.mjs';
-import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseSerializer } from './base-serializer.js';
+import { isUndefined } from '../utils/type-guards.js';
+import { NULL } from '../utils/constants.js';
+import { InvalidRuleErrorNodeMarshallingMap } from '../marshalling-utils/invalid-rule-error-node-common.js';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for invalid rule error nodes.
+ */
 class InvalidRuleErrorNodeSerializer extends BaseSerializer {
     /**
      * Serializes an invalid rule error node to binary format.

package/dist/{esm/serializer/invalid-rule-serializer.mjs → serializer/invalid-rule-serializer.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 { BaseSerializer } from './base-serializer.mjs';
-import { isUndefined } from '../utils/type-guards.mjs';
-import { NULL } from '../utils/constants.mjs';
-import { InvalidRuleErrorNodeSerializer } from './invalid-rule-error-node-serializer.mjs';
-import { InvalidRuleMarshallingMap } from '../marshalling-utils/invalid-rule-common.mjs';
-import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseSerializer } from './base-serializer.js';
+import { isUndefined } from '../utils/type-guards.js';
+import { NULL } from '../utils/constants.js';
+import { InvalidRuleErrorNodeSerializer } from './invalid-rule-error-node-serializer.js';
+import { InvalidRuleMarshallingMap } from '../marshalling-utils/invalid-rule-common.js';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for invalid rule nodes.
+ */
 class InvalidRuleSerializer extends BaseSerializer {
     /**
      * Serializes an invalid rule node to binary format.

package/dist/{esm/serializer/misc/domain-list-serializer.mjs → serializer/misc/domain-list-serializer.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 { NULL, COMMA, PIPE } from '../../utils/constants.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { ListItemsSerializer } from './list-items-serializer.mjs';
-import { DomainListMarshallingMap } from '../../marshalling-utils/misc/domain-list-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL, COMMA, PIPE } from '../../utils/constants.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { ListItemsSerializer } from './list-items-serializer.js';
+import { DomainListMarshallingMap } from '../../marshalling-utils/misc/domain-list-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /**
  * Value map for binary serialization. This helps to reduce the size of the serialized data,
@@ -24,12 +24,12 @@ const SEPARATOR_SERIALIZATION_MAP = new Map([
     [PIPE, 1],
 ]);
 /**
- * `DomainListParser` is responsible for parsing a domain list.
+ * `DomainListSerializer` is responsible for serializing a domain list.
  *
  * @example
  * - If the rule is `example.com,~example.net##.ads`, the domain list is `example.com,~example.net`.
  * - If the rule is `ads.js^$script,domains=example.com|~example.org`, the domain list is `example.com|~example.org`.
- * This parser is responsible for parsing these domain lists.
+ * This serializer is responsible for serializing these domain lists.
  * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#elemhide_domains}
  */
 class DomainListSerializer extends BaseSerializer {

package/dist/{esm/serializer/misc/list-item-serializer.mjs → serializer/misc/list-item-serializer.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 { BaseSerializer } from '../base-serializer.mjs';
-import { ListItemNodeType } from '../../nodes/index.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { NULL } from '../../utils/constants.mjs';
-import { ListItemMarshallingMap } from '../../marshalling-utils/misc/list-item-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseSerializer } from '../base-serializer.js';
+import { ListItemNodeType } from '../../nodes/index.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { NULL } from '../../utils/constants.js';
+import { ListItemMarshallingMap } from '../../marshalling-utils/misc/list-item-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for list item nodes.
+ */
 class ListItemSerializer extends BaseSerializer {
     /**
      * Serializes a list item to binary format.

package/dist/{esm/serializer/misc/list-items-serializer.mjs → serializer/misc/list-items-serializer.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 { ListItemSerializer } from './list-item-serializer.mjs';
+import { ListItemSerializer } from './list-item-serializer.js';
 
+/**
+ * Serializer for list items.
+ */
 class ListItemsSerializer {
     /**
      * Serializes a list of items to binary format.

package/dist/{esm/serializer/misc/logical-expression-serializer.mjs → serializer/misc/logical-expression-serializer.js}

@@ -1,26 +1,25 @@
 /*
- * 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 { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { KNOWN_VARIABLES_SERIALIZATION_MAP, VariableNodeBinaryPropMarshallingMap, ParenthesisNodeBinaryPropMarshallingMap, OperatorNodeBinaryPropMarshallingMap, LOGICAL_EXPRESSION_OPERATOR_SERIALISATION_MAP } from '../../marshalling-utils/misc/logical-expression-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { KNOWN_VARIABLES_SERIALIZATION_MAP, VariableNodeBinaryPropMarshallingMap, ParenthesisNodeBinaryPropMarshallingMap, OperatorNodeBinaryPropMarshallingMap, LOGICAL_EXPRESSION_OPERATOR_SERIALISATION_MAP } from '../../marshalling-utils/misc/logical-expression-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /**
  * Possible node types in the logical expression.
  */
-var NodeType;
-(function (NodeType) {
-    NodeType["Variable"] = "Variable";
-    NodeType["Operator"] = "Operator";
-    NodeType["Parenthesis"] = "Parenthesis";
-})(NodeType || (NodeType = {}));
+const NodeType = {
+    Variable: 'Variable',
+    Operator: 'Operator',
+    Parenthesis: 'Parenthesis',
+};
 /**
- * `LogicalExpressionParser` is responsible for parsing logical expressions.
+ * `LogicalExpressionSerializer` is responsible for serializing logical expressions.
  *
  * @example
  * From the following rule:
@@ -127,6 +126,7 @@ class LogicalExpressionSerializer extends BaseSerializer {
                 LogicalExpressionSerializer.serializeParenthesisNode(node, buffer);
                 break;
             default:
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
                 throw new Error(`Unexpected node type: ${node.type}`);
         }
         buffer.writeUint8(NULL);

package/dist/{esm/serializer/misc/modifier-list-serializer.mjs → serializer/misc/modifier-list-serializer.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 { UINT16_MAX, NULL } from '../../utils/constants.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { ModifierSerializer } from './modifier-serializer.mjs';
-import { ModifierListNodeMarshallingMap } from '../../marshalling-utils/misc/modifier-list-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { UINT16_MAX, NULL } from '../../utils/constants.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { ModifierSerializer } from './modifier-serializer.js';
+import { ModifierListNodeMarshallingMap } from '../../marshalling-utils/misc/modifier-list-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /**
  * `ModifierListSerializer` is responsible for serializing modifier lists. Please note that the name is not
@@ -29,6 +29,9 @@ class ModifierListSerializer extends BaseSerializer {
     static serialize(node, buffer) {
         buffer.writeUint8(BinaryTypeMarshallingMap.ModifierListNode);
         const count = node.children.length;
+        // If there are no children, we do not write any data related to them, to avoid using unnecessary storage,
+        // but children is a required field, so during deserialization we should initialize it as an empty array,
+        // if there are no children in the binary data.
         if (count) {
             buffer.writeUint8(ModifierListNodeMarshallingMap.Children);
             // note: we store the count, because re-construction of the array is faster if we know the length

package/dist/{esm/serializer/misc/modifier-serializer.mjs → serializer/misc/modifier-serializer.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 { NULL } from '../../utils/constants.mjs';
-import { ValueSerializer } from './value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { ModifierNodeMarshallingMap, FREQUENT_MODIFIERS_SERIALIZATION_MAP, FREQUENT_REDIRECT_MODIFIERS_SERIALIZATION_MAP } from '../../marshalling-utils/misc/modifier-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { ValueSerializer } from './value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { ModifierNodeMarshallingMap, FREQUENT_MODIFIERS_SERIALIZATION_MAP, FREQUENT_REDIRECT_MODIFIERS_SERIALIZATION_MAP } from '../../marshalling-utils/misc/modifier-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /**
  * `ModifierSerializer` is responsible for serializing modifiers.

package/dist/{esm/serializer/misc/parameter-list-serializer.mjs → serializer/misc/parameter-list-serializer.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 { NULL } from '../../utils/constants.mjs';
-import { ValueSerializer } from './value-serializer.mjs';
-import { isNull, isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { ParameterListNodeMarshallingMap } from '../../marshalling-utils/misc/parameter-list-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { ValueSerializer } from './value-serializer.js';
+import { isNull, isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { ParameterListNodeMarshallingMap } from '../../marshalling-utils/misc/parameter-list-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for parameter list nodes.
+ */
 class ParameterListSerializer extends BaseSerializer {
     /**
      * Serializes a parameter list node to binary format.

package/dist/{esm/serializer/misc/value-serializer.mjs → serializer/misc/value-serializer.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 { NULL } from '../../utils/constants.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { ValueNodeMarshallingMap } from '../../marshalling-utils/misc/value-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { ValueNodeMarshallingMap } from '../../marshalling-utils/misc/value-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /**
  * Value serializer.

package/dist/{esm/serializer/network/host-rule-serializer.mjs → serializer/network/host-rule-serializer.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 { NULL } from '../../utils/constants.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { HostnameListSerializer } from './hostname-list-serializer.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { HostRuleMarshallingMap } from '../../marshalling-utils/misc/host-rule-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
-import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.mjs';
+import { NULL } from '../../utils/constants.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { HostnameListSerializer } from './hostname-list-serializer.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { HostRuleMarshallingMap } from '../../marshalling-utils/misc/host-rule-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.js';
 
 /**
  * `HostRuleSerializer` is responsible for serializing hosts-like rules.

package/dist/{esm/serializer/network/hostname-list-serializer.mjs → serializer/network/hostname-list-serializer.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 { BaseSerializer } from '../base-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { UINT16_MAX, NULL } from '../../utils/constants.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { HostnameListNodeMarshallingMap } from '../../marshalling-utils/misc/hostname-list-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseSerializer } from '../base-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { UINT16_MAX, NULL } from '../../utils/constants.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { HostnameListNodeMarshallingMap } from '../../marshalling-utils/misc/hostname-list-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for hostname list nodes.
+ */
 class HostnameListSerializer extends BaseSerializer {
     /**
      * Serializes a hostname list node to binary format.
@@ -29,6 +32,9 @@ class HostnameListSerializer extends BaseSerializer {
             buffer.writeUint32(node.end);
         }
         const count = node.children.length;
+        // If there are no children, we do not write any data related to them, to avoid using unnecessary storage,
+        // but children is a required field, so during deserialization we should initialize it as an empty array,
+        // if there are no children in the binary data.
         if (count) {
             // note: we store the count, because re-construction of the array is faster if we know the length
             if (count > UINT16_MAX) {