@adguard/agtree 3.0.0 → 3.1.0

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

@@ -1,17 +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 { StringUtils } from '../../utils/string.mjs';
-import { ESCAPE_CHARACTER, COMMA } from '../../utils/constants.mjs';
-import { defaultParserOptions } from '../options.mjs';
-import { ValueParser } from './value-parser.mjs';
-import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.mjs';
-import { QUOTE_SET } from '../../utils/quotes.mjs';
-import { ParameterListParser } from './parameter-list-parser.mjs';
+import { StringUtils } from '../../utils/string.js';
+import { COMMA, ESCAPE_CHARACTER } from '../../utils/constants.js';
+import { defaultParserOptions } from '../options.js';
+import { ValueParser } from './value-parser.js';
+import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
+import { QUOTE_SET } from '../../utils/quotes.js';
+import { ParameterListParser } from './parameter-list-parser.js';
 
+/**
+ * Parser for uBO-specific parameter lists.
+ */
 class UboParameterListParser extends ParameterListParser {
     /**
      * Parses an "uBO-specific parameter list".

package/dist/{esm/parser/misc/value-parser.mjs → parser/misc/value-parser.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 { defaultParserOptions } from '../options.mjs';
-import { BaseParser } from '../base-parser.mjs';
+import { defaultParserOptions } from '../options.js';
+import { BaseParser } from '../base-parser.js';
 
 /**
  * Value parser.
- * This parser is very simple, it just exists to provide a consistent interface for parsing and generating values.
+ * This parser is very simple, it just exists to provide a consistent interface for parsing.
  */
 class ValueParser extends BaseParser {
     /**

package/dist/{esm/parser/network/host-rule-parser.mjs → parser/network/host-rule-parser.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 * as tldts from 'tldts';
+import { getDomain, getHostname } from 'tldts';
 import isIp from 'is-ip';
-import { StringUtils } from '../../utils/string.mjs';
-import { RuleCategory, NetworkRuleType } from '../../nodes/index.mjs';
-import { defaultParserOptions } from '../options.mjs';
-import { BaseParser } from '../base-parser.mjs';
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { ValueParser } from '../misc/value-parser.mjs';
+import { StringUtils } from '../../utils/string.js';
+import { NetworkRuleType, RuleCategory } from '../../nodes/index.js';
+import { defaultParserOptions } from '../options.js';
+import { BaseParser } from '../base-parser.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { ValueParser } from '../misc/value-parser.js';
 
 /* eslint-disable no-param-reassign */
 /**
@@ -86,7 +86,7 @@ class HostRuleParser extends BaseParser {
         if (partsLength === 1) {
             // "Just domain" syntax, e.g. `example.org`
             // In this case, domain should be valid and IP will be set to 0.0.0.0 by default
-            if (tldts.getDomain(parts[0].value) !== parts[0].value) {
+            if (getDomain(parts[0].value) !== parts[0].value) {
                 throw new Error(`Not a valid domain: ${parts[0].value}`);
             }
             result.ip = {
@@ -105,7 +105,7 @@ class HostRuleParser extends BaseParser {
                 throw new Error(`Invalid IP address: ${ip.value}`);
             }
             for (const { value } of hostnames) {
-                if (tldts.getHostname(value) !== value) {
+                if (getHostname(value) !== value) {
                     throw new Error(`Not a valid hostname: ${value}`);
                 }
             }

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

@@ -1,18 +1,18 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { AdblockSyntax } from '../../utils/adblockers.mjs';
-import { StringUtils } from '../../utils/string.mjs';
-import { ModifierListParser } from '../misc/modifier-list.mjs';
-import { NETWORK_RULE_EXCEPTION_MARKER, NETWORK_RULE_EXCEPTION_MARKER_LEN, NETWORK_RULE_SEPARATOR, REGEX_MARKER, ESCAPE_CHARACTER } from '../../utils/constants.mjs';
-import { NetworkRuleType, RuleCategory } from '../../nodes/index.mjs';
-import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.mjs';
-import { defaultParserOptions } from '../options.mjs';
-import { BaseParser } from '../base-parser.mjs';
-import { ValueParser } from '../misc/value-parser.mjs';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { StringUtils } from '../../utils/string.js';
+import { ModifierListParser } from '../misc/modifier-list.js';
+import { NETWORK_RULE_EXCEPTION_MARKER, NETWORK_RULE_EXCEPTION_MARKER_LEN, NETWORK_RULE_SEPARATOR, REGEX_MARKER, ESCAPE_CHARACTER } from '../../utils/constants.js';
+import { RuleCategory, NetworkRuleType } from '../../nodes/index.js';
+import { AdblockSyntaxError } from '../../errors/adblock-syntax-error.js';
+import { defaultParserOptions } from '../options.js';
+import { BaseParser } from '../base-parser.js';
+import { ValueParser } from '../misc/value-parser.js';
 
 /**
  * `NetworkRuleParser` is responsible for parsing network rules.
@@ -58,10 +58,16 @@ class NetworkRuleParser extends BaseParser {
         const pattern = ValueParser.parse(raw.slice(patternStart, patternEnd), options, baseOffset + patternStart);
         // Parse modifiers (if any)
         let modifiers;
+        // Get a last non-whitespace index
+        const lastNonWsIndex = StringUtils.skipWSBack(raw);
         // Find start and end index of the modifiers
         const modifiersStart = separatorIndex + 1;
         const modifiersEnd = StringUtils.skipWSBack(raw) + 1;
         if (separatorIndex !== -1) {
+            // Check for empty modifiers
+            if (separatorIndex === lastNonWsIndex) {
+                throw new AdblockSyntaxError('Empty modifiers are not allowed', baseOffset + separatorIndex, baseOffset + raw.length);
+            }
             modifiers = ModifierListParser.parse(raw.slice(modifiersStart, modifiersEnd), options, baseOffset + modifiersStart);
         }
         // Throw error if there is no pattern and no modifiers

package/dist/{esm/parser/options.mjs → parser/options.js}

@@ -1,6 +1,6 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */

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

@@ -1,18 +1,18 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { AdblockSyntax } from '../utils/adblockers.mjs';
-import { CommentParser } from './comment/comment-parser.mjs';
-import { CosmeticRuleParser } from './cosmetic/cosmetic-rule-parser.mjs';
-import { NetworkRuleParser } from './network/network-rule-parser.mjs';
-import { RuleCategory } from '../nodes/index.mjs';
-import { AdblockSyntaxError } from '../errors/adblock-syntax-error.mjs';
-import { defaultParserOptions } from './options.mjs';
-import { BaseParser } from './base-parser.mjs';
-import { HostRuleParser } from './network/host-rule-parser.mjs';
+import { AdblockSyntax } from '../utils/adblockers.js';
+import { CommentParser } from './comment/comment-parser.js';
+import { CosmeticRuleParser } from './cosmetic/cosmetic-rule-parser.js';
+import { NetworkRuleParser } from './network/network-rule-parser.js';
+import { RuleCategory } from '../nodes/index.js';
+import { AdblockSyntaxError } from '../errors/adblock-syntax-error.js';
+import { defaultParserOptions } from './options.js';
+import { BaseParser } from './base-parser.js';
+import { HostRuleParser } from './network/host-rule-parser.js';
 
 /* eslint-disable no-param-reassign */
 /**

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

@@ -1,10 +1,10 @@
 /*
- * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
- * (c) 2024 Adguard Software Ltd.
+ * AGTree v3.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NotImplementedError } from '../errors/not-implemented-error.mjs';
+import { NotImplementedError } from '../errors/not-implemented-error.js';
 
 /**
  * @file Base serializer class.

package/dist/{esm/serializer/comment/agent-comment-serializer.mjs → serializer/comment/agent-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.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 { UINT8_MAX, NULL } from '../../utils/constants.mjs';
-import { AgentSerializer } from './agent-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { BaseSerializer } from '../base-serializer.mjs';
-import { AgentCommentMarshallingMap } from '../../marshalling-utils/comment/agent-comment-common.mjs';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { UINT8_MAX, NULL } from '../../utils/constants.js';
+import { AgentSerializer } from './agent-serializer.js';
+import { isUndefined } from '../../utils/type-guards.js';
+import { BaseSerializer } from '../base-serializer.js';
+import { AgentCommentMarshallingMap } from '../../marshalling-utils/comment/agent-comment-common.js';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
 
 /**
  * `AgentCommentSerializer` is responsible for serializing an Adblock agent comments.
@@ -44,6 +44,9 @@ class AgentCommentSerializer extends BaseSerializer {
     static serialize(node, buffer) {
         buffer.writeUint8(BinaryTypeMarshallingMap.AgentRuleNode);
         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(AgentCommentMarshallingMap.Children);
             // note: we store the count, because re-construction of the array is faster if we know the length

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.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { 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.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 { 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.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 { 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.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 { 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.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 { 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.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { ValueSerializer } from '../misc/value-serializer.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { 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.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 { 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.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { NULL } from '../../utils/constants.mjs';
-import { isUndefined } from '../../utils/type-guards.mjs';
-import { 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.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { BaseSerializer } from '../../base-serializer.mjs';
-import { 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.1.0 (build date: Mon, 31 Mar 2025 16:50:55 GMT)
+ * (c) 2025 Adguard Software Ltd.
  * Released under the MIT license
  * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
  */
-import { BaseSerializer } from '../../base-serializer.mjs';
-import { 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.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 { 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);