@adguard/agtree 3.0.0 → 3.1.0

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

@@ -1,17 +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 { BaseDeserializer } from './base-deserializer.mjs';
-import { RuleCategory } from '../nodes/index.mjs';
-import { NULL } from '../utils/constants.mjs';
-import { InvalidRuleErrorNodeDeserializer } from './invalid-rule-error-node-deserializer.mjs';
-import { InvalidRuleMarshallingMap } from '../marshalling-utils/invalid-rule-common.mjs';
-import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseDeserializer } from './base-deserializer.js';
+import { RuleCategory } from '../nodes/index.js';
+import { NULL } from '../utils/constants.js';
+import { InvalidRuleErrorNodeDeserializer } from './invalid-rule-error-node-deserializer.js';
+import { InvalidRuleMarshallingMap } from '../marshalling-utils/invalid-rule-common.js';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
+/**
+ * Deserializer for invalid rule nodes.
+ * Converts binary data into invalid rule nodes.
+ */
 class InvalidRuleDeserializer extends BaseDeserializer {
     /**
      * Deserializes an invalid rule node from binary format.

package/dist/{esm/deserializer/invalid-rule-error-node-deserializer.mjs → deserializer/invalid-rule-error-node-deserializer.js}

@@ -1,15 +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 { BaseDeserializer } from './base-deserializer.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 { BaseDeserializer } from './base-deserializer.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';
 
 /* eslint-disable no-param-reassign */
+/**
+ * Deserializer for invalid rule error nodes.
+ * Converts binary data into invalid rule error nodes.
+ */
 class InvalidRuleErrorNodeDeserializer extends BaseDeserializer {
     /**
      * Deserializes an invalid rule error node from binary format.

package/dist/{esm/deserializer/misc/domain-list-deserializer.mjs → deserializer/misc/domain-list-deserializer.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 } from '../../utils/constants.mjs';
-import { ListNodeType } from '../../nodes/index.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { DomainListMarshallingMap, SEPARATOR_SERIALIZATION_MAP } from '../../marshalling-utils/misc/domain-list-common.mjs';
-import { ListItemsDeserializer } from './list-items-deserializer.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL, COMMA } from '../../utils/constants.js';
+import { ListNodeType } from '../../nodes/index.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { DomainListMarshallingMap, SEPARATOR_SERIALIZATION_MAP } from '../../marshalling-utils/misc/domain-list-common.js';
+import { ListItemsDeserializer } from './list-items-deserializer.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
 /**

package/dist/{esm/deserializer/misc/list-item-deserializer.mjs → deserializer/misc/list-item-deserializer.js}

@@ -1,16 +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 { BaseDeserializer } from '../base-deserializer.mjs';
-import { ListItemNodeType } from '../../nodes/index.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 { BaseDeserializer } from '../base-deserializer.js';
+import { ListItemNodeType } from '../../nodes/index.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';
 
 /* eslint-disable no-param-reassign */
+/**
+ * `ListItemDeserializer` is responsible for deserializing list item nodes from binary format.
+ *
+ * @example
+ * `app`, `domain`, `method`, `stealth-option`
+ */
 class ListItemDeserializer extends BaseDeserializer {
     /**
      * Deserializes a list item from binary format.

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

@@ -1,11 +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 { ListItemDeserializer } from './list-item-deserializer.mjs';
+import { ListItemDeserializer } from './list-item-deserializer.js';
 
+/**
+ * Deserializes lists of items from binary format.
+ * Converts binary data to structured item nodes.
+ */
 class ListItemsDeserializer {
     /**
      * Deserializes a list of items from binary format.

package/dist/{esm/deserializer/misc/logical-expression-deserializer.mjs → deserializer/misc/logical-expression-deserializer.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 { VariableNodeBinaryPropMarshallingMap, ParenthesisNodeBinaryPropMarshallingMap, OperatorNodeBinaryPropMarshallingMap, LOGICAL_EXPRESSION_OPERATOR_SERIALISATION_MAP, KNOWN_VARIABLES_SERIALIZATION_MAP } from '../../marshalling-utils/misc/logical-expression-common.mjs';
-import { NodeType } from '../../serializer/misc/logical-expression-serializer.mjs';
-import { NULL } from '../../utils/constants.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { VariableNodeBinaryPropMarshallingMap, ParenthesisNodeBinaryPropMarshallingMap, OperatorNodeBinaryPropMarshallingMap, KNOWN_VARIABLES_SERIALIZATION_MAP, LOGICAL_EXPRESSION_OPERATOR_SERIALISATION_MAP } from '../../marshalling-utils/misc/logical-expression-common.js';
+import { NodeType } from '../../serializer/misc/logical-expression-serializer.js';
+import { NULL } from '../../utils/constants.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 let logicalExpressionOperatorMarshallingMapReverse;
 const getOperatorBinaryMapReverse = () => {

package/dist/{esm/deserializer/misc/modifier-deserializer.mjs → deserializer/misc/modifier-deserializer.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 { ValueDeserializer } from './value-deserializer.mjs';
-import { BaseDeserializer } from '../base-deserializer.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 { ValueDeserializer } from './value-deserializer.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { ModifierNodeMarshallingMap, FREQUENT_REDIRECT_MODIFIERS_SERIALIZATION_MAP, FREQUENT_MODIFIERS_SERIALIZATION_MAP } from '../../marshalling-utils/misc/modifier-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
 /**
@@ -36,7 +36,7 @@ const getFrequentValuesDeserializationMaps = () => {
     return frequentValuesDeserializationMaps;
 };
 /**
- * `ModifierSerializer` is responsible for serializing modifiers.
+ * `ModifierDeserializer` is responsible for deserializing modifiers.
  *
  * @example
  * `match-case`, `~third-party`, `domain=example.com|~example.org`

package/dist/{esm/deserializer/misc/modifier-list-deserializer.mjs → deserializer/misc/modifier-list-deserializer.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 { BaseDeserializer } from '../base-deserializer.mjs';
-import { ModifierDeserializer } from './modifier-deserializer.mjs';
-import { ModifierListNodeMarshallingMap } from '../../marshalling-utils/misc/modifier-list-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { ModifierDeserializer } from './modifier-deserializer.js';
+import { ModifierListNodeMarshallingMap } from '../../marshalling-utils/misc/modifier-list-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
 /**
@@ -50,6 +50,11 @@ class ModifierListDeserializer 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 = [];
+        }
     }
 }
 

package/dist/{esm/deserializer/misc/parameter-list-deserializer.mjs → deserializer/misc/parameter-list-deserializer.js}

@@ -1,15 +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 { ValueDeserializer } from './value-deserializer.mjs';
-import { BaseDeserializer } from '../base-deserializer.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 { ValueDeserializer } from './value-deserializer.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { ParameterListNodeMarshallingMap } from '../../marshalling-utils/misc/parameter-list-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Deserializes binary data into parameter list nodes.
+ * Optionally uses a map of frequent values for optimization.
+ */
 class ParameterListDeserializer extends BaseDeserializer {
     /**
      * Deserializes a parameter list node from binary format.

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

package/dist/{esm/deserializer/network/host-rule-deserializer.mjs → deserializer/network/host-rule-deserializer.js}

@@ -1,44 +1,32 @@
 /*
- * 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 { RuleCategory, NetworkRuleType } from '../../nodes/index.mjs';
-import { ValueDeserializer } from '../misc/value-deserializer.mjs';
-import { HostnameListDeserializer } from './hostname-list-deserializer.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { HostRuleMarshallingMap } from '../../marshalling-utils/misc/host-rule-common.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
-import { getSyntaxDeserializationMap } from '../syntax-deserialization-map.mjs';
+import { NULL } from '../../utils/constants.js';
+import { RuleCategory, NetworkRuleType } from '../../nodes/index.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { HostnameListDeserializer } from './hostname-list-deserializer.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { HostRuleMarshallingMap } from '../../marshalling-utils/misc/host-rule-common.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+import { getSyntaxDeserializationMap } from '../syntax-deserialization-map.js';
 
 /* eslint-disable no-param-reassign */
 /**
- * `HostRuleSerializer` is responsible for serializing hosts-like rules.
+ * `HostRuleDeserializer` is responsible for deserializing hosts-like rules.
  *
  * HostRule is a structure for simple host-level rules (i.e. /etc/hosts syntax).
  * It also supports "just domain" syntax. In this case, the IP will be set to 0.0.0.0.
- *
- * Rules syntax looks like this:
- * ```text
- * IP_address canonical_hostname [aliases...]
- * ```
- *
- * @example
- * `192.168.1.13 bar.mydomain.org bar` -- ipv4
- * `ff02::1 ip6-allnodes` -- ipv6
- * `::1 localhost ip6-localhost ip6-loopback` -- ipv6 aliases
- * `example.org` -- "just domain" syntax
- * @see {@link http://man7.org/linux/man-pages/man5/hosts.5.html}
  */
 class HostRuleDeserializer extends BaseDeserializer {
     /**
-     * Deserializes a modifier node from binary format.
+     * Deserializes a host rule node from binary format.
      *
-     * @param buffer ByteBuffer for reading binary data.
-     * @param node Destination node.
+     * @param buffer Input byte buffer to read from.
+     * @param node Destination node to write to.
      */
     static deserialize(buffer, node) {
         buffer.assertUint8(BinaryTypeMarshallingMap.HostRuleNode);

package/dist/{esm/deserializer/network/hostname-list-deserializer.mjs → deserializer/network/hostname-list-deserializer.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 { BaseDeserializer } from '../base-deserializer.mjs';
-import { NULL } from '../../utils/constants.mjs';
-import { ValueDeserializer } from '../misc/value-deserializer.mjs';
-import { HostnameListNodeMarshallingMap } from '../../marshalling-utils/misc/hostname-list-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { NULL } from '../../utils/constants.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { HostnameListNodeMarshallingMap } from '../../marshalling-utils/misc/hostname-list-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
+/**
+ * Deserializes hostname list nodes from binary format.
+ */
 class HostnameListDeserializer extends BaseDeserializer {
     /**
      * Deserializes a hostname list node from binary format.
@@ -42,6 +45,11 @@ class HostnameListDeserializer 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 = [];
+        }
     }
 }
 

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

@@ -1,18 +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 { NetworkRuleType, RuleCategory } from '../../nodes/index.mjs';
-import { ValueDeserializer } from '../misc/value-deserializer.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { ModifierListDeserializer } from '../misc/modifier-list-deserializer.mjs';
-import { NetworkRuleMarshallingMap } from '../../marshalling-utils/network/network-rule-common.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
-import { getSyntaxDeserializationMap } from '../syntax-deserialization-map.mjs';
+import { NULL } from '../../utils/constants.js';
+import { NetworkRuleType, RuleCategory } from '../../nodes/index.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { ModifierListDeserializer } from '../misc/modifier-list-deserializer.js';
+import { NetworkRuleMarshallingMap } from '../../marshalling-utils/network/network-rule-common.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+import { getSyntaxDeserializationMap } from '../syntax-deserialization-map.js';
 
 /* eslint-disable no-param-reassign */
 /**

package/dist/{esm/deserializer/rule-deserializer.mjs → deserializer/rule-deserializer.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 { BaseDeserializer } from './base-deserializer.mjs';
-import { CommentRuleDeserializer } from './comment/comment-rule-deserializer.mjs';
-import { CosmeticRuleDeserializer } from './cosmetic/cosmetic-rule-deserializer.mjs';
-import { HostRuleDeserializer } from './network/host-rule-deserializer.mjs';
-import { NetworkRuleDeserializer } from './network/network-rule-deserializer.mjs';
-import { EmptyRuleDeserializer } from './empty-rule-deserializer.mjs';
-import { InvalidRuleDeserializer } from './invalid-rule-deserializer.mjs';
-import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseDeserializer } from './base-deserializer.js';
+import { CommentRuleDeserializer } from './comment/comment-rule-deserializer.js';
+import { CosmeticRuleDeserializer } from './cosmetic/cosmetic-rule-deserializer.js';
+import { HostRuleDeserializer } from './network/host-rule-deserializer.js';
+import { NetworkRuleDeserializer } from './network/network-rule-deserializer.js';
+import { EmptyRuleDeserializer } from './empty-rule-deserializer.js';
+import { InvalidRuleDeserializer } from './invalid-rule-deserializer.js';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
 
 /**
  * `RuleDeserializer` is responsible for deserializing the rules.

package/dist/{esm/deserializer/syntax-deserialization-map.mjs → deserializer/syntax-deserialization-map.js}

@@ -1,10 +1,10 @@
 /*
- * 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 { getSyntaxSerializationMap } from '../marshalling-utils/syntax-serialization-map.mjs';
+import { getSyntaxSerializationMap } from '../marshalling-utils/syntax-serialization-map.js';
 
 /**
  * Value map for binary deserialization. This helps to reduce the size of the serialized data,

package/dist/{esm/errors/adblock-syntax-error.mjs → errors/adblock-syntax-error.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/errors/binary-schema-mismatch-error.mjs → errors/binary-schema-mismatch-error.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/errors/not-implemented-error.mjs → errors/not-implemented-error.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/errors/rule-conversion-error.mjs → errors/rule-conversion-error.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/generator/base-generator.mjs → generator/base-generator.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 { NotImplementedError } from '../errors/not-implemented-error.mjs';
+import { NotImplementedError } from '../errors/not-implemented-error.js';
 
 /* eslint-disable @typescript-eslint/no-unused-vars */
 /**
- * @file Base parser class.
+ * @file Base generator class.
  */
 /**
  * Base class for generators. Each generator should extend this class.

package/dist/{esm/generator/comment/agent-comment-generator.mjs → generator/comment/agent-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 { SEMICOLON, SPACE, CLOSE_SQUARE_BRACKET, OPEN_SQUARE_BRACKET } from '../../utils/constants.mjs';
-import { BaseGenerator } from '../base-generator.mjs';
-import { AgentGenerator } from './agent-generator.mjs';
+import { SEMICOLON, SPACE, CLOSE_SQUARE_BRACKET, OPEN_SQUARE_BRACKET } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
+import { AgentGenerator } from './agent-generator.js';
 
+/**
+ * Generator for agent comment rules.
+ */
 class AgentCommentGenerator extends BaseGenerator {
     /**
      * Converts an adblock agent AST to a string.

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

@@ -1,13 +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 { BaseGenerator } from '../base-generator.mjs';
-import { SPACE, EMPTY } from '../../utils/constants.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
+import { BaseGenerator } from '../base-generator.js';
+import { SPACE, EMPTY } from '../../utils/constants.js';
+import { isUndefined } from '../../utils/type-guards.js';
 
+/**
+ * Generator for adblock agent nodes.
+ * This class is responsible for converting adblock agent nodes into their string representation.
+ */
 class AgentGenerator extends BaseGenerator {
     /**
      * Converts an adblock agent node to a string.