@adguard/agtree 3.0.0 → 3.1.0

package/dist/{esm/deserializer/comment/agent-deserializer.mjs → deserializer/comment/agent-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 } from '../../utils/constants.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { AgentNodeMarshallingMap, FREQUENT_AGENTS_DESERIALIZATION_MAP } from '../../marshalling-utils/comment/agent-common.mjs';
-import { getAdblockSyntax } from '../../common/agent-common.mjs';
-import { ValueDeserializer } from '../misc/value-deserializer.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { AgentNodeMarshallingMap, FREQUENT_AGENTS_DESERIALIZATION_MAP } from '../../marshalling-utils/comment/agent-common.js';
+import { getAdblockSyntax } from '../../common/agent-common.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
 /**

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

@@ -1,73 +1,20 @@
 /*
- * 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 { AgentCommentDeserializer } from './agent-comment-deserializer.mjs';
-import { ConfigCommentDeserializer } from './config-comment-deserializer.mjs';
-import { HintCommentDeserializer } from './hint-comment-deserializer.mjs';
-import { MetadataCommentDeserializer } from './metadata-comment-deserializer.mjs';
-import { PreProcessorCommentDeserializer } from './pre-processor-comment-deserializer.mjs';
-import { SimpleCommentDeserializer } from './simple-comment-deserializer.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { AgentCommentDeserializer } from './agent-comment-deserializer.js';
+import { ConfigCommentDeserializer } from './config-comment-deserializer.js';
+import { HintCommentDeserializer } from './hint-comment-deserializer.js';
+import { MetadataCommentDeserializer } from './metadata-comment-deserializer.js';
+import { PreProcessorCommentDeserializer } from './pre-processor-comment-deserializer.js';
+import { SimpleCommentDeserializer } from './simple-comment-deserializer.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /**
- * `CommentRuleSerializer` is responsible for serializing 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.
+ * `CommentRuleDeserializer` is responsible for deserializing any comment-like adblock rules.
  */
 class CommentRuleDeserializer extends BaseDeserializer {
     /**

package/dist/{esm/deserializer/comment/config-comment-deserializer.mjs → deserializer/comment/config-comment-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 { NULL } from '../../utils/constants.mjs';
-import { CommentRuleType, RuleCategory } from '../../nodes/index.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { ConfigNodeMarshallingMap, ConfigCommentRuleMarshallingMap, FREQUENT_COMMANDS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/config-comment-common.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { ValueDeserializer } from '../misc/value-deserializer.mjs';
-import { ParameterListDeserializer } from '../misc/parameter-list-deserializer.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { CommentRuleType, RuleCategory } from '../../nodes/index.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { ConfigNodeMarshallingMap, ConfigCommentRuleMarshallingMap, FREQUENT_COMMANDS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/config-comment-common.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { ParameterListDeserializer } from '../misc/parameter-list-deserializer.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
 /**

package/dist/{esm/deserializer/comment/hint-comment-deserializer.mjs → deserializer/comment/hint-comment-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 { NULL } from '../../utils/constants.mjs';
-import { RuleCategory, CommentRuleType } from '../../nodes/index.mjs';
-import { HintDeserializer } from './hint-deserializer.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { HintCommentMarshallingMap } from '../../marshalling-utils/comment/hint-comment-common.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, CommentRuleType } from '../../nodes/index.js';
+import { HintDeserializer } from './hint-deserializer.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { HintCommentMarshallingMap } from '../../marshalling-utils/comment/hint-comment-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+import { getSyntaxDeserializationMap } from '../syntax-deserialization-map.js';
 
 /* eslint-disable no-param-reassign */
 /**
@@ -61,6 +61,11 @@ class HintCommentDeserializer 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/comment/hint-deserializer.mjs → deserializer/comment/hint-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 } from '../../utils/constants.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { HintNodeMarshallingMap, FREQUENT_HINTS_SERIALIZATION_MAP, FREQUENT_PLATFORMS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/hint-common.mjs';
-import { ValueDeserializer } from '../misc/value-deserializer.mjs';
-import { ParameterListDeserializer } from '../misc/parameter-list-deserializer.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { HintNodeMarshallingMap, FREQUENT_PLATFORMS_SERIALIZATION_MAP, FREQUENT_HINTS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/hint-common.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { ParameterListDeserializer } from '../misc/parameter-list-deserializer.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
 /**

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

@@ -1,16 +1,16 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { CommentRuleType, RuleCategory } from '../../nodes/index.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { MetadataCommentMarshallingMap, FREQUENT_HEADERS_DESERIALIZATION_MAP } from '../../marshalling-utils/comment/metadata-comment-common.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { ValueDeserializer } from '../misc/value-deserializer.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { CommentRuleType, RuleCategory } from '../../nodes/index.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { MetadataCommentMarshallingMap, FREQUENT_HEADERS_DESERIALIZATION_MAP } from '../../marshalling-utils/comment/metadata-comment-common.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
 /**

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

@@ -1,19 +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 { CommentRuleType, RuleCategory } from '../../nodes/index.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { PreProcessorRuleMarshallingMap, FREQUENT_DIRECTIVES_SERIALIZATION_MAP, FREQUENT_PARAMS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/pre-processor-comment-common.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { ValueDeserializer } from '../misc/value-deserializer.mjs';
-import { LogicalExpressionDeserializer } from '../misc/logical-expression-deserializer.mjs';
-import { ParameterListDeserializer } from '../misc/parameter-list-deserializer.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 { CommentRuleType, RuleCategory } from '../../nodes/index.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { PreProcessorRuleMarshallingMap, FREQUENT_PARAMS_SERIALIZATION_MAP, FREQUENT_DIRECTIVES_SERIALIZATION_MAP } from '../../marshalling-utils/comment/pre-processor-comment-common.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { LogicalExpressionDeserializer } from '../misc/logical-expression-deserializer.js';
+import { ParameterListDeserializer } from '../misc/parameter-list-deserializer.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/comment/simple-comment-deserializer.mjs → deserializer/comment/simple-comment-deserializer.js}

@@ -1,16 +1,16 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { CommentRuleType, RuleCategory } from '../../nodes/index.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { SimpleCommentMarshallingMap } from '../../marshalling-utils/comment/simple-comment-common.mjs';
-import { ValueDeserializer } from '../misc/value-deserializer.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { CommentRuleType, RuleCategory } from '../../nodes/index.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { SimpleCommentMarshallingMap } from '../../marshalling-utils/comment/simple-comment-common.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
 /**

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

@@ -1,25 +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 { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { DomainListDeserializer } from '../misc/domain-list-deserializer.mjs';
-import { NULL } from '../../utils/constants.mjs';
-import { CosmeticRuleType, RuleCategory } from '../../nodes/index.mjs';
-import { AbpSnippetInjectionBodyDeserializer } from './scriptlet-body/abp-snippet-injection-body-deserializer.mjs';
-import { UboScriptletInjectionBodyDeserializer } from './scriptlet-body/ubo-scriptlet-injection-body-deserializer.mjs';
-import { AdgScriptletInjectionBodyDeserializer } from './scriptlet-body/adg-scriptlet-injection-body-deserializer.mjs';
-import { ValueDeserializer } from '../misc/value-deserializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { ElementHidingBodyDeserializer } from './element-hiding-body-deserializer.mjs';
-import { CssInjectionBodyDeserializer } from './css-injection-body-deserializer.mjs';
-import { ModifierListDeserializer } from '../misc/modifier-list-deserializer.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 { getSyntaxDeserializationMap } from '../syntax-deserialization-map.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { DomainListDeserializer } from '../misc/domain-list-deserializer.js';
+import { NULL } from '../../utils/constants.js';
+import { RuleCategory, CosmeticRuleType } from '../../nodes/index.js';
+import { AbpSnippetInjectionBodyDeserializer } from './scriptlet-body/abp-snippet-injection-body-deserializer.js';
+import { UboScriptletInjectionBodyDeserializer } from './scriptlet-body/ubo-scriptlet-injection-body-deserializer.js';
+import { AdgScriptletInjectionBodyDeserializer } from './scriptlet-body/adg-scriptlet-injection-body-deserializer.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { ElementHidingBodyDeserializer } from './element-hiding-body-deserializer.js';
+import { CssInjectionBodyDeserializer } from './css-injection-body-deserializer.js';
+import { ModifierListDeserializer } from '../misc/modifier-list-deserializer.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 { getSyntaxDeserializationMap } from '../syntax-deserialization-map.js';
 
 /* eslint-disable no-param-reassign */
 /**
@@ -44,6 +44,12 @@ const COSMETIC_RULE_TYPE_DESERIALIZATION_MAP = new Map([
     [BinaryTypeMarshallingMap.JsInjectionRule, CosmeticRuleType.JsInjectionRule],
     [BinaryTypeMarshallingMap.HtmlFilteringRule, CosmeticRuleType.HtmlFilteringRule],
 ]);
+/**
+ * Deserializer for cosmetic rules.
+ * Converts binary data into structured cosmetic rule nodes, supporting various types
+ * like element hiding, CSS injection, scriptlet injection, JavaScript injection, and HTML filtering.
+ * Handles rule type, syntax, exceptions, separators, modifiers, and domain lists.
+ */
 class CosmeticRuleDeserializer extends BaseDeserializer {
     /**
      * Deserializes a cosmetic rule node from binary format.

package/dist/{esm/deserializer/cosmetic/css-injection-body-deserializer.mjs → deserializer/cosmetic/css-injection-body-deserializer.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 { ValueDeserializer } from '../misc/value-deserializer.mjs';
-import { NULL } from '../../utils/constants.mjs';
-import { BaseDeserializer } from '../base-deserializer.mjs';
-import { CssInjectionRuleMarshallingMap } from '../../marshalling-utils/cosmetic/body/css-injection-body-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { NULL } from '../../utils/constants.js';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { CssInjectionRuleMarshallingMap } from '../../marshalling-utils/cosmetic/body/css-injection-body-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Deserializes CSS injection rule body nodes from binary format.
+ */
 class CssInjectionBodyDeserializer extends BaseDeserializer {
     /**
      * Deserializes CSS injection rule body node from binary format.

package/dist/{esm/deserializer/cosmetic/element-hiding-body-deserializer.mjs → deserializer/cosmetic/element-hiding-body-deserializer.js}

@@ -1,16 +1,20 @@
 /*
- * 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 { ElementHidingRuleMarshallingMap } from '../../marshalling-utils/cosmetic/body/element-hiding-body-common.mjs';
-import { ValueDeserializer } from '../misc/value-deserializer.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseDeserializer } from '../base-deserializer.js';
+import { NULL } from '../../utils/constants.js';
+import { ElementHidingRuleMarshallingMap } from '../../marshalling-utils/cosmetic/body/element-hiding-body-common.js';
+import { ValueDeserializer } from '../misc/value-deserializer.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
+/**
+ * Deserializes element hiding rule body nodes from binary data.
+ * Populates the provided node with the deserialized data.
+ */
 class ElementHidingBodyDeserializer extends BaseDeserializer {
     /**
      * Deserializes an element hiding rule body node from binary format.

package/dist/{esm/deserializer/cosmetic/scriptlet-body/abp-snippet-injection-body-deserializer.mjs → deserializer/cosmetic/scriptlet-body/abp-snippet-injection-body-deserializer.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 { BaseDeserializer } from '../../base-deserializer.mjs';
-import { ScriptletBodyDeserializer } from './scriptlet-body-deserializer.mjs';
-import { FREQUENT_ABP_SNIPPET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/abp-snippet-injection-body-common.mjs';
+import { BaseDeserializer } from '../../base-deserializer.js';
+import { ScriptletBodyDeserializer } from './scriptlet-body-deserializer.js';
+import { FREQUENT_ABP_SNIPPET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/abp-snippet-injection-body-common.js';
 
 /**
  * Value map for binary deserialization. This helps to reduce the size of the serialized data,
@@ -19,6 +19,10 @@ const getFrequentAbpSnippetArgsDeserializationMap = () => {
     }
     return frequentAbpSnippetArgsDeserializationMap;
 };
+/**
+ * Deserializer for ABP snippet injection rule body nodes.
+ * Converts binary data into a structured format using a map of frequently used arguments.
+ */
 class AbpSnippetInjectionBodyDeserializer extends BaseDeserializer {
     /**
      * Deserializes a scriptlet call body node from binary format.

package/dist/{esm/deserializer/cosmetic/scriptlet-body/adg-scriptlet-injection-body-deserializer.mjs → deserializer/cosmetic/scriptlet-body/adg-scriptlet-injection-body-deserializer.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 { BaseDeserializer } from '../../base-deserializer.mjs';
-import { ScriptletBodyDeserializer } from './scriptlet-body-deserializer.mjs';
-import { FREQUENT_ADG_SCRIPTLET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/adg-scriptlet-injection-body-common.mjs';
+import { BaseDeserializer } from '../../base-deserializer.js';
+import { ScriptletBodyDeserializer } from './scriptlet-body-deserializer.js';
+import { FREQUENT_ADG_SCRIPTLET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/adg-scriptlet-injection-body-common.js';
 
 /**
  * Value map for binary deserialization. This helps to reduce the size of the serialized data,
@@ -19,6 +19,11 @@ const getFrequentAdgScriptletArgsDeserializationMap = () => {
     }
     return frequentAdgScriptletArgsDeserializationMap;
 };
+/**
+ * Deserializer for AdGuard scriptlet injection body nodes.
+ * Converts binary data into a structured scriptlet call body node specific to AdGuard,
+ * using a predefined deserialization map for frequently used scriptlet arguments.
+ */
 class AdgScriptletInjectionBodyDeserializer extends BaseDeserializer {
     /**
      * Deserializes a scriptlet call body node from binary format.

package/dist/{esm/deserializer/cosmetic/scriptlet-body/scriptlet-body-deserializer.mjs → deserializer/cosmetic/scriptlet-body/scriptlet-body-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 { ParameterListDeserializer } from '../../misc/parameter-list-deserializer.mjs';
-import { BaseDeserializer } from '../../base-deserializer.mjs';
-import { AbpSnippetBodyMarshallingMap } from '../../../marshalling-utils/cosmetic/body/abp-snippet-injection-body-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../../utils/constants.js';
+import { ParameterListDeserializer } from '../../misc/parameter-list-deserializer.js';
+import { BaseDeserializer } from '../../base-deserializer.js';
+import { AbpSnippetBodyMarshallingMap } from '../../../marshalling-utils/cosmetic/body/abp-snippet-injection-body-common.js';
+import { BinaryTypeMarshallingMap } from '../../../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Deserializes binary data into scriptlet body nodes.
+ * Optionally uses a map of frequently used scriptlet arguments.
+ */
 class ScriptletBodyDeserializer extends BaseDeserializer {
     /**
      * Deserializes a hint rule node from binary format.

package/dist/{esm/deserializer/cosmetic/scriptlet-body/ubo-scriptlet-injection-body-deserializer.mjs → deserializer/cosmetic/scriptlet-body/ubo-scriptlet-injection-body-deserializer.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 { BaseDeserializer } from '../../base-deserializer.mjs';
-import { ScriptletBodyDeserializer } from './scriptlet-body-deserializer.mjs';
-import { FREQUENT_UBO_SCRIPTLET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/ubo-scriptlet-injection-body-common.mjs';
+import { BaseDeserializer } from '../../base-deserializer.js';
+import { ScriptletBodyDeserializer } from './scriptlet-body-deserializer.js';
+import { FREQUENT_UBO_SCRIPTLET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/ubo-scriptlet-injection-body-common.js';
 
 /**
  * Value map for binary deserialization. This helps to reduce the size of the serialized data,
@@ -19,12 +19,15 @@ const getFrequentPlatformsDeserializationMap = () => {
     }
     return frequentUboScriptletArgsDeserializationMap;
 };
+/**
+ * Deserializes uBlock Origin scriptlet injection body nodes from binary data.
+ */
 class UboScriptletInjectionBodyDeserializer extends BaseDeserializer {
     /**
      * Deserializes a scriptlet call body node from binary format.
      *
      * @param buffer ByteBuffer for reading binary data.
-     * @param node Destination node.
+     * @param node Destination node to populate with deserialized data.
      * @throws If the binary data is malformed.
      */
     static deserialize(buffer, node) {

package/dist/{esm/deserializer/empty-rule-deserializer.mjs → deserializer/empty-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 { EmptyRuleMarshallingMap } from '../marshalling-utils/empty-rule-common.mjs';
-import { AdblockSyntax } from '../utils/adblockers.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 { EmptyRuleMarshallingMap } from '../marshalling-utils/empty-rule-common.js';
+import { AdblockSyntax } from '../utils/adblockers.js';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
 
 /* eslint-disable no-param-reassign */
+/**
+ * Deserializer for empty rule nodes.
+ * This class handles the deserialization of empty rule nodes from binary format.
+ */
 class EmptyRuleDeserializer extends BaseDeserializer {
     /**
      * Deserializes an empty rule node from binary format.

package/dist/{esm/deserializer/filterlist-deserializer.mjs → deserializer/filterlist-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 { BaseDeserializer } from './base-deserializer.mjs';
-import { RuleDeserializer } from './rule-deserializer.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 { BaseDeserializer } from './base-deserializer.js';
+import { RuleDeserializer } from './rule-deserializer.js';
+import { FilterListNodeMarshallingMap } from '../marshalling-utils/filter-list-common.js';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Deserializer for filter lists.
+ * Converts binary data into filter list nodes.
+ */
 class FilterListDeserializer extends BaseDeserializer {
     /**
      * Deserializes a filter list node from binary format.

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

@@ -1,8 +1,8 @@
 /*
- * 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 { RuleDeserializer } from './rule-deserializer.mjs';
-export { getSyntaxDeserializationMap } from './syntax-deserialization-map.mjs';
+export { RuleDeserializer } from './rule-deserializer.js';
+export { getSyntaxDeserializationMap } from './syntax-deserialization-map.js';