@adguard/agtree 3.0.0-alpha.1 → 3.0.0-alpha.2

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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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_DIRECTIVES_SERIALIZATION_MAP, FREQUENT_PARAMS_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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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 { CosmeticRuleType, RuleCategory } 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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';

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

@@ -1,17 +1,21 @@
 /*
- * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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, LOGICAL_EXPRESSION_OPERATOR_SERIALISATION_MAP, KNOWN_VARIABLES_SERIALIZATION_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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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_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';
 
 /* 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
  * (c) 2024 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.