@adguard/agtree 3.0.0 → 3.0.1

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

@@ -1,15 +1,15 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { AgentNodeMarshallingMap, FREQUENT_AGENTS_DESERIALIZATION_MAP } from '../../marshalling-utils/comment/agent-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { AgentNodeMarshallingMap, FREQUENT_AGENTS_DESERIALIZATION_MAP } from '../../marshalling-utils/comment/agent-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /**
  * Value map for binary serialization. This helps to reduce the size of the serialized data,
@@ -27,16 +27,7 @@ const getFrequentAgentsSerializationMap = () => {
     return frequentAgentsSerializationMap;
 };
 /**
- * `AgentParser` is responsible for parsing single adblock agent elements.
- *
- * @example
- * If the adblock agent rule is
- * ```adblock
- * [Adblock Plus 2.0; AdGuard]
- * ```
- * then the adblock agents are `Adblock Plus 2.0` and `AdGuard`, and this
- * class is responsible for parsing them. The rule itself is parsed by
- * `AgentCommentSerializer`, which uses this class to parse single agents.
+ * `AgentSerializer` is responsible for serializing single adblock agent elements into a binary format.
  */
 class AgentSerializer extends BaseSerializer {
     /**

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

@@ -1,17 +1,17 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { AgentCommentSerializer } from './agent-comment-serializer.mjs';
-import { CommentRuleType } from '../../nodes/index.mjs';
-import { ConfigCommentSerializer } from './config-comment-serializer.mjs';
-import { HintCommentSerializer } from './hint-comment-serializer.mjs';
-import { MetadataCommentSerializer } from './metadata-comment-serializer.mjs';
-import { PreProcessorCommentSerializer } from './pre-processor-comment-serializer.mjs';
-import { SimpleCommentSerializer } from './simple-comment-serializer.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
+import { AgentCommentSerializer } from './agent-comment-serializer.js';
+import { CommentRuleType } from '../../nodes/index.js';
+import { ConfigCommentSerializer } from './config-comment-serializer.js';
+import { HintCommentSerializer } from './hint-comment-serializer.js';
+import { MetadataCommentSerializer } from './metadata-comment-serializer.js';
+import { PreProcessorCommentSerializer } from './pre-processor-comment-serializer.js';
+import { SimpleCommentSerializer } from './simple-comment-serializer.js';
+import { BaseSerializer } from '../base-serializer.js';
 
 /**
  * `CommentRuleSerializer` is responsible for serializing any comment-like adblock rules.

package/dist/{esm/serializer/comment/config-comment-serializer.mjs → serializer/comment/config-comment-serializer.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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { ParameterListSerializer } from '../misc/parameter-list-serializer.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { ConfigNodeMarshallingMap, ConfigCommentRuleMarshallingMap, FREQUENT_COMMANDS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/config-comment-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { ParameterListSerializer } from '../misc/parameter-list-serializer.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { ConfigNodeMarshallingMap, ConfigCommentRuleMarshallingMap, FREQUENT_COMMANDS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/config-comment-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /**
- * `ConfigCommentParser` is responsible for parsing inline AGLint configuration rules.
+ * `ConfigCommentSerializer` is responsible for serializing inline AGLint configuration rules into a binary format.
  * Generally, the idea is inspired by ESLint inline configuration comments.
  *
  * @see {@link https://eslint.org/docs/latest/user-guide/configuring/rules#using-configuration-comments}

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

@@ -1,17 +1,17 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { HintSerializer } from './hint-serializer.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { HintCommentMarshallingMap } from '../../marshalling-utils/comment/hint-comment-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
-import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.mjs';
+import { NULL } from '../../utils/constants.js';
+import { HintSerializer } from './hint-serializer.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { HintCommentMarshallingMap } from '../../marshalling-utils/comment/hint-comment-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.js';
 
 /**
  * `HintCommentSerializer` is responsible for serializing AdGuard hint rules.
@@ -39,6 +39,9 @@ class HintCommentSerializer extends BaseSerializer {
             buffer.writeUint8(getSyntaxSerializationMap().get(AdblockSyntax.Adg) ?? 0);
         }
         const count = node.children.length;
+        // If there are no children, we do not write any data related to them, to avoid using unnecessary storage,
+        // but children is a required field, so during deserialization we should initialize it as an empty array,
+        // if there are no children in the binary data.
         if (count) {
             buffer.writeUint8(HintCommentMarshallingMap.Children);
             // note: we store the count, because re-construction of the array is faster if we know the length

package/dist/{esm/serializer/comment/hint-serializer.mjs → serializer/comment/hint-serializer.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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { ParameterListSerializer } from '../misc/parameter-list-serializer.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { HintNodeMarshallingMap, FREQUENT_HINTS_SERIALIZATION_MAP, FREQUENT_PLATFORMS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/hint-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { ParameterListSerializer } from '../misc/parameter-list-serializer.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { HintNodeMarshallingMap, FREQUENT_HINTS_SERIALIZATION_MAP, FREQUENT_PLATFORMS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/hint-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /**
  * `HintSerializer` is responsible for serializing AdGuard hints.

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

@@ -1,15 +1,15 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { MetadataCommentMarshallingMap, FREQUENT_HEADERS_DESERIALIZATION_MAP } from '../../marshalling-utils/comment/metadata-comment-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { MetadataCommentMarshallingMap, FREQUENT_HEADERS_DESERIALIZATION_MAP } from '../../marshalling-utils/comment/metadata-comment-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /**
  * Value map for binary serialization. This helps to reduce the size of the serialized data,

package/dist/{esm/serializer/comment/pre-processor-comment-serializer.mjs → serializer/comment/pre-processor-comment-serializer.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.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { LogicalExpressionSerializer } from '../misc/logical-expression-serializer.mjs';
-import { ParameterListSerializer } from '../misc/parameter-list-serializer.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { PreProcessorRuleMarshallingMap, FREQUENT_DIRECTIVES_SERIALIZATION_MAP, FREQUENT_PARAMS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/pre-processor-comment-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
-import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.mjs';
+import { NULL } from '../../utils/constants.js';
+import { LogicalExpressionSerializer } from '../misc/logical-expression-serializer.js';
+import { ParameterListSerializer } from '../misc/parameter-list-serializer.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { PreProcessorRuleMarshallingMap, FREQUENT_DIRECTIVES_SERIALIZATION_MAP, FREQUENT_PARAMS_SERIALIZATION_MAP } from '../../marshalling-utils/comment/pre-processor-comment-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.js';
 
 /**
  * `PreProcessorSerializer` is responsible for serializing preprocessor rules.

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

@@ -1,20 +1,20 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { SimpleCommentMarshallingMap } from '../../marshalling-utils/comment/simple-comment-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../../utils/constants.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { SimpleCommentMarshallingMap } from '../../marshalling-utils/comment/simple-comment-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /**
- * `SimpleCommentSerializer` is responsible for parsing simple comments.
+ * `SimpleCommentSerializer` is responsible for serializing simple comments.
  * Some comments have a special meaning in adblock syntax, like agent comments or hints,
- * but this parser is only responsible for parsing regular comments,
+ * but this serializer is only responsible for serializing regular comments,
  * whose only purpose is to provide some human-readable information.
  *
  * @example

package/dist/{esm/serializer/cosmetic/body/abp-snippet-injection-body-serializer.mjs → serializer/cosmetic/body/abp-snippet-injection-body-serializer.js}

@@ -1,23 +1,23 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { BaseSerializer } from '../../base-serializer.mjs';
-import { ScriptletBodySerializer } from './scriptlet-body-serializer.mjs';
-import { FREQUENT_ABP_SNIPPET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/abp-snippet-injection-body-common.mjs';
+import { BaseSerializer } from '../../base-serializer.js';
+import { ScriptletBodySerializer } from './scriptlet-body-serializer.js';
+import { FREQUENT_ABP_SNIPPET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/abp-snippet-injection-body-common.js';
 
 /**
- * `AbpSnippetInjectionBodyParser` is responsible for parsing the body of an Adblock Plus-style snippet rule.
+ * `AbpSnippetInjectionBodySerializer` is responsible for serializing the body of an Adblock Plus-style snippet rule.
  *
- * Please note that the parser will parse any scriptlet rule if it is syntactically correct.
- * For example, it will parse this:
+ * Please note that the serializer will serialize any scriptlet rule if it is syntactically correct.
+ * For example, it will serialize this:
  * ```adblock
  * example.com#$#snippet0 arg0
  * ```
  *
- * but it didn't check if the scriptlet `snippet0` actually supported by any adblocker.
+ * but it doesn't check if the scriptlet `snippet0` is actually supported by any adblocker.
  *
  * @see {@link https://help.eyeo.com/adblockplus/snippet-filters-tutorial}
  */

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

@@ -1,23 +1,23 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { BaseSerializer } from '../../base-serializer.mjs';
-import { ScriptletBodySerializer } from './scriptlet-body-serializer.mjs';
-import { FREQUENT_ADG_SCRIPTLET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/adg-scriptlet-injection-body-common.mjs';
+import { BaseSerializer } from '../../base-serializer.js';
+import { ScriptletBodySerializer } from './scriptlet-body-serializer.js';
+import { FREQUENT_ADG_SCRIPTLET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/adg-scriptlet-injection-body-common.js';
 
 /**
- * `AdgScriptletInjectionBodyParser` is responsible for parsing the body of an AdGuard-style scriptlet rule.
+ * `AdgScriptletInjectionBodySerializer` is responsible for serializing the body of an AdGuard-style scriptlet rule.
  *
- * Please note that the parser will parse any scriptlet rule if it is syntactically correct.
- * For example, it will parse this:
+ * Please note that the serializer will serialize any scriptlet rule if it is syntactically correct.
+ * For example, it will serialize this:
  * ```adblock
  * example.com#%#//scriptlet('scriptlet0', 'arg0')
  * ```
  *
- * but it didn't check if the scriptlet `scriptlet0` actually supported by any adblocker.
+ * but it doesn't check if the scriptlet `scriptlet0` is actually supported by any adblocker.
  *
  * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#scriptlets}
  */

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

@@ -1,24 +1,27 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { UINT8_MAX, NULL } from '../../../utils/constants.mjs';
-import { ParameterListSerializer } from '../../misc/parameter-list-serializer.mjs';
-import { isUndefined } from '../../../utils/type-guards.mjs';
-import { BaseSerializer } from '../../base-serializer.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 { UINT8_MAX, NULL } from '../../../utils/constants.js';
+import { ParameterListSerializer } from '../../misc/parameter-list-serializer.js';
+import { isUndefined } from '../../../utils/type-guards.js';
+import { BaseSerializer } from '../../base-serializer.js';
+import { AbpSnippetBodyMarshallingMap } from '../../../marshalling-utils/cosmetic/body/abp-snippet-injection-body-common.js';
+import { BinaryTypeMarshallingMap } from '../../../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for scriptlet injection rule body nodes.
+ */
 class ScriptletBodySerializer extends BaseSerializer {
     /**
-     * Serializes a hint rule node to binary format.
+     * Serializes a scriptlet injection rule body node into a compact binary format.
      *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     * @param frequentScriptletArgs Map of frequently used scriptlet names / arguments
-     * and their serialization index (optional).
+     * @param node The ScriptletInjectionRuleBody node to serialize.
+     * @param buffer The OutputByteBuffer used for writing the binary data.
+     * @param frequentScriptletArgs An optional map of frequently used scriptlet names and their arguments,
+     * along with their corresponding serialization index.
      */
     static serialize = (node, buffer, frequentScriptletArgs) => {
         buffer.writeUint8(BinaryTypeMarshallingMap.ScriptletInjectionRuleBodyNode);

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

@@ -1,12 +1,12 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { ScriptletBodySerializer } from './scriptlet-body-serializer.mjs';
-import { BaseSerializer } from '../../base-serializer.mjs';
-import { FREQUENT_UBO_SCRIPTLET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/ubo-scriptlet-injection-body-common.mjs';
+import { ScriptletBodySerializer } from './scriptlet-body-serializer.js';
+import { BaseSerializer } from '../../base-serializer.js';
+import { FREQUENT_UBO_SCRIPTLET_ARGS_SERIALIZATION_MAP } from '../../../marshalling-utils/cosmetic/body/ubo-scriptlet-injection-body-common.js';
 
 /**
  * `UboScriptletInjectionBodySerializer` is responsible for serializing the body of a uBlock-style scriptlet rule.

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

@@ -1,42 +1,33 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { DomainListSerializer } from '../misc/domain-list-serializer.mjs';
-import { NULL } from '../../utils/constants.mjs';
-import { CosmeticRuleType } from '../../nodes/index.mjs';
-import { AbpSnippetInjectionBodySerializer } from './body/abp-snippet-injection-body-serializer.mjs';
-import { UboScriptletInjectionBodySerializer } from './body/ubo-scriptlet-injection-body-serializer.mjs';
-import { AdgScriptletInjectionBodySerializer } from './body/adg-scriptlet-injection-body-serializer.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { ElementHidingBodySerializer } from './element-hiding-body-serializer.mjs';
-import { CssInjectionBodySerializer } from './css-injection-body-serializer.mjs';
-import { ModifierListSerializer } from '../misc/modifier-list-serializer.mjs';
-import { CosmeticRuleMarshallingMap, COSMETIC_RULE_SEPARATOR_SERIALIZATION_MAP } from '../../marshalling-utils/cosmetic/cosmetic-rule-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
-import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { DomainListSerializer } from '../misc/domain-list-serializer.js';
+import { NULL } from '../../utils/constants.js';
+import { CosmeticRuleType } from '../../nodes/index.js';
+import { AbpSnippetInjectionBodySerializer } from './body/abp-snippet-injection-body-serializer.js';
+import { UboScriptletInjectionBodySerializer } from './body/ubo-scriptlet-injection-body-serializer.js';
+import { AdgScriptletInjectionBodySerializer } from './body/adg-scriptlet-injection-body-serializer.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { ElementHidingBodySerializer } from './element-hiding-body-serializer.js';
+import { CssInjectionBodySerializer } from './css-injection-body-serializer.js';
+import { ModifierListSerializer } from '../misc/modifier-list-serializer.js';
+import { CosmeticRuleMarshallingMap, COSMETIC_RULE_SEPARATOR_SERIALIZATION_MAP } from '../../marshalling-utils/cosmetic/cosmetic-rule-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
+import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.js';
 
 /**
- * `CosmeticRuleParser` is responsible for parsing cosmetic rules.
+ * `CosmeticRuleSerializer` is responsible for serializing cosmetic rules into a binary format.
  *
- * Where possible, it automatically detects the difference between supported syntaxes:
- *  - AdGuard
- *  - uBlock Origin
- *  - Adblock Plus
- *
- * If the syntax is common / cannot be determined, the parser gives `Common` syntax.
- *
- * Please note that syntactically correct rules are parsed even if they are not actually
- * compatible with the given adblocker. This is a completely natural behavior, meaningful
- * checking of compatibility is not done at the parser level.
+ * This class takes a cosmetic rule Abstract Syntax Tree (AST) and converts it into a compact binary representation.
+ * It handles the serialization of different types of cosmetic rules, including element hiding, CSS injection,
+ * JavaScript injection, HTML filtering, and scriptlet injection rules.
  */
-// TODO: Make raw body parsing optional
-// TODO: Split into smaller sections
 class CosmeticRuleSerializer extends BaseSerializer {
     /**
      * Serializes a cosmetic rule node to binary format.

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

@@ -1,16 +1,19 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { NULL } from '../../utils/constants.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { CssInjectionRuleMarshallingMap } from '../../marshalling-utils/cosmetic/body/css-injection-body-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { NULL } from '../../utils/constants.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { CssInjectionRuleMarshallingMap } from '../../marshalling-utils/cosmetic/body/css-injection-body-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for CSS injection rule body nodes.
+ */
 class CssInjectionBodySerializer extends BaseSerializer {
     /**
      * Serializes a CSS injection rule body node to binary format.

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

@@ -1,16 +1,19 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { BaseSerializer } from '../base-serializer.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { NULL } from '../../utils/constants.mjs';
-import { ElementHidingRuleMarshallingMap } from '../../marshalling-utils/cosmetic/body/element-hiding-body-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseSerializer } from '../base-serializer.js';
+import { ValueSerializer } from '../misc/value-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { NULL } from '../../utils/constants.js';
+import { ElementHidingRuleMarshallingMap } from '../../marshalling-utils/cosmetic/body/element-hiding-body-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for element hiding rule body nodes.
+ */
 class ElementHidingBodySerializer extends BaseSerializer {
     /**
      * Serializes an element hiding rule body node to binary format.

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

@@ -1,15 +1,18 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { BaseSerializer } from './base-serializer.mjs';
-import { isUndefined } from '../utils/type-guards.mjs';
-import { NULL } from '../utils/constants.mjs';
-import { EmptyRuleMarshallingMap } from '../marshalling-utils/empty-rule-common.mjs';
-import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseSerializer } from './base-serializer.js';
+import { isUndefined } from '../utils/type-guards.js';
+import { NULL } from '../utils/constants.js';
+import { EmptyRuleMarshallingMap } from '../marshalling-utils/empty-rule-common.js';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for empty rule nodes.
+ */
 class EmptyRuleSerializer extends BaseSerializer {
     /**
      * Serializes an empty rule node to binary format.

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

@@ -1,19 +1,18 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../utils/constants.mjs';
-import { isUndefined } from '../utils/type-guards.mjs';
-import { BaseSerializer } from './base-serializer.mjs';
-import { RuleSerializer } from './rule-serializer.mjs';
-import { FilterListNodeMarshallingMap } from '../marshalling-utils/filter-list-common.mjs';
-import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.mjs';
+import { NULL } from '../utils/constants.js';
+import { isUndefined } from '../utils/type-guards.js';
+import { BaseSerializer } from './base-serializer.js';
+import { RuleSerializer } from './rule-serializer.js';
+import { FilterListNodeMarshallingMap } from '../marshalling-utils/filter-list-common.js';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
 
 /**
- * `FilterListParser` is responsible for parsing a whole adblock filter list (list of rules).
- * It is a wrapper around `RuleParser` which parses each line separately.
+ * Serializes filter list nodes to binary format.
  */
 class FilterListSerializer extends BaseSerializer {
     /**

package/dist/serializer/index.js

@@ -0,0 +1,7 @@
+/*
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+export { RuleSerializer } from './rule-serializer.js';

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

@@ -1,15 +1,18 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.0.1 (build date: Fri, 28 Feb 2025 15:31:12 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { BaseSerializer } from './base-serializer.mjs';
-import { isUndefined } from '../utils/type-guards.mjs';
-import { NULL } from '../utils/constants.mjs';
-import { InvalidRuleErrorNodeMarshallingMap } from '../marshalling-utils/invalid-rule-error-node-common.mjs';
-import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.mjs';
+import { BaseSerializer } from './base-serializer.js';
+import { isUndefined } from '../utils/type-guards.js';
+import { NULL } from '../utils/constants.js';
+import { InvalidRuleErrorNodeMarshallingMap } from '../marshalling-utils/invalid-rule-error-node-common.js';
+import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
 
+/**
+ * Serializer for invalid rule error nodes.
+ */
 class InvalidRuleErrorNodeSerializer extends BaseSerializer {
     /**
      * Serializes an invalid rule error node to binary format.