@adguard/agtree 2.1.2 → 3.0.0-alpha.1

package/dist/esm/generator/filterlist-generator.mjs

@@ -0,0 +1,55 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { LF, CR, CRLF, EMPTY } from '../utils/constants.mjs';
+import { RuleGenerator } from './rule-generator.mjs';
+import { BaseGenerator } from './base-generator.mjs';
+
+/**
+ * `FilterListParser` is responsible for parsing a whole adblock filter list (list of rules).
+ * It is a wrapper around `RuleParser` which parses each line separately.
+ */
+class FilterListGenerator extends BaseGenerator {
+    /**
+     * Serializes a whole adblock filter list (list of rules).
+     *
+     * @param ast AST to generate
+     * @param preferRaw If `true`, then the parser will use `raws.text` property of each rule
+     * if it is available. Default is `false`.
+     * @returns Serialized filter list
+     */
+    static generate(ast, preferRaw = false) {
+        let result = EMPTY;
+        for (let i = 0; i < ast.children.length; i += 1) {
+            const rule = ast.children[i];
+            if (preferRaw && rule.raws?.text) {
+                result += rule.raws.text;
+            }
+            else {
+                result += RuleGenerator.generate(rule);
+            }
+            switch (rule.raws?.nl) {
+                case 'crlf':
+                    result += CRLF;
+                    break;
+                case 'cr':
+                    result += CR;
+                    break;
+                case 'lf':
+                    result += LF;
+                    break;
+                default:
+                    if (i !== ast.children.length - 1) {
+                        result += LF;
+                    }
+                    break;
+            }
+        }
+        return result;
+    }
+}
+
+export { FilterListGenerator };

package/dist/esm/generator/index.mjs

@@ -0,0 +1,9 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+export { RuleGenerator } from './rule-generator.mjs';
+export { CosmeticRuleGenerator } from './cosmetic/cosmetic-rule-generator.mjs';
+export { CosmeticRuleBodyGenerator } from './cosmetic/cosmetic-rule-body-generator.mjs';

package/dist/esm/generator/misc/domain-list-generator.mjs

@@ -0,0 +1,23 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseGenerator } from '../base-generator.mjs';
+import { ListItemsGenerator } from './list-items-generator.mjs';
+
+class DomainListGenerator extends BaseGenerator {
+    /**
+     * Converts a domain list node to a string.
+     *
+     * @param node Domain list node.
+     *
+     * @returns Raw string.
+     */
+    static generate(node) {
+        return ListItemsGenerator.generate(node.children, node.separator);
+    }
+}
+
+export { DomainListGenerator };

package/dist/esm/generator/misc/list-items-generator.mjs

@@ -0,0 +1,36 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { NEGATION_MARKER, EMPTY } from '../../utils/constants.mjs';
+
+class ListItemsGenerator {
+    /**
+     * Generates a string representation of a list item.
+     *
+     * @param item List item to generate.
+     * @template T Type of the list item.
+     *
+     * @returns String representation of the list item.
+     */
+    static generateListItem = (item) => {
+        return `${item.exception ? NEGATION_MARKER : EMPTY}${item.value}`;
+    };
+    /**
+     * Generates a string representation of a list of items.
+     *
+     * @param items List of items to generate.
+     * @param separator Separator character.
+     * @template T Type of the list items.
+     *
+     * @returns String representation of the list of items.
+     */
+    static generate = (items, separator) => {
+        return items.map(ListItemsGenerator.generateListItem)
+            .join(separator);
+    };
+}
+
+export { ListItemsGenerator };

package/dist/esm/generator/misc/logical-expression-generator.mjs

@@ -0,0 +1,45 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseGenerator } from '../base-generator.mjs';
+import { OperatorValue } from '../../nodes/index.mjs';
+import { NodeType } from '../../parser/misc/logical-expression-parser.mjs';
+
+class LogicalExpressionGenerator extends BaseGenerator {
+    /**
+     * Generates a string representation of the logical expression (serialization).
+     *
+     * @param node Expression node
+     * @returns String representation of the logical expression
+     */
+    static generate(node) {
+        if (node.type === NodeType.Variable) {
+            return node.name;
+        }
+        if (node.type === NodeType.Operator) {
+            const left = LogicalExpressionGenerator.generate(node.left);
+            const right = node.right ? LogicalExpressionGenerator.generate(node.right) : undefined;
+            const { operator } = node;
+            // Special case for NOT operator
+            if (operator === OperatorValue.Not) {
+                return `${operator}${left}`;
+            }
+            // Right operand is required for AND and OR operators
+            if (!right) {
+                throw new Error('Expected right operand');
+            }
+            return `${left} ${operator} ${right}`;
+        }
+        if (node.type === NodeType.Parenthesis) {
+            const expressionString = LogicalExpressionGenerator.generate(node.expression);
+            return `(${expressionString})`;
+        }
+        // Theoretically, this shouldn't happen if the library is used correctly
+        throw new Error('Unexpected node type');
+    }
+}
+
+export { LogicalExpressionGenerator };

package/dist/esm/generator/misc/modifier-generator.mjs

@@ -0,0 +1,31 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { MODIFIER_ASSIGN_OPERATOR, EMPTY, NEGATION_MARKER } from '../../utils/constants.mjs';
+import { BaseGenerator } from '../base-generator.mjs';
+
+class ModifierGenerator extends BaseGenerator {
+    /**
+     * Generates a string from a modifier (serializes it).
+     *
+     * @param modifier Modifier to generate string from
+     * @returns String representation of the modifier
+     */
+    static generate(modifier) {
+        let result = EMPTY;
+        if (modifier.exception) {
+            result += NEGATION_MARKER;
+        }
+        result += modifier.name.value;
+        if (modifier.value !== undefined) {
+            result += MODIFIER_ASSIGN_OPERATOR;
+            result += modifier.value.value;
+        }
+        return result;
+    }
+}
+
+export { ModifierGenerator };

package/dist/esm/generator/misc/modifier-list-generator.mjs

@@ -0,0 +1,26 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseGenerator } from '../base-generator.mjs';
+import { MODIFIERS_SEPARATOR } from '../../utils/constants.mjs';
+import { ModifierGenerator } from './modifier-generator.mjs';
+
+class ModifierListGenerator extends BaseGenerator {
+    /**
+     * Converts a modifier list AST to a string.
+     *
+     * @param ast Modifier list AST
+     * @returns Raw string
+     */
+    static generate(ast) {
+        const result = ast.children
+            .map(ModifierGenerator.generate)
+            .join(MODIFIERS_SEPARATOR);
+        return result;
+    }
+}
+
+export { ModifierListGenerator };

package/dist/esm/generator/misc/parameter-list-generator.mjs

@@ -0,0 +1,39 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { SPACE, COMMA, EMPTY } from '../../utils/constants.mjs';
+import { BaseGenerator } from '../base-generator.mjs';
+import { ValueGenerator } from './value-generator.mjs';
+
+class ParameterListGenerator extends BaseGenerator {
+    /**
+     * Converts a parameter list AST to a string.
+     *
+     * @param params Parameter list AST
+     * @param separator Separator character (default: comma)
+     * @returns String representation of the parameter list
+     */
+    static generate(params, separator = COMMA) {
+        const collection = [];
+        // add parameters
+        let i = 0;
+        for (; i < params.children.length; i += 1) {
+            const param = params.children[i];
+            if (param === null) {
+                collection.push(EMPTY);
+            }
+            else {
+                collection.push(ValueGenerator.generate(param));
+            }
+        }
+        // join parameters with separator
+        // if the separator is a space, join with a single space
+        const result = collection.join(separator === SPACE ? separator : `${separator}${SPACE}`);
+        return result;
+    }
+}
+
+export { ParameterListGenerator };

package/dist/esm/generator/misc/value-generator.mjs

@@ -0,0 +1,21 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseGenerator } from '../base-generator.mjs';
+
+class ValueGenerator extends BaseGenerator {
+    /**
+     * Converts a value node to a string.
+     *
+     * @param node Value node.
+     * @returns Raw string.
+     */
+    static generate(node) {
+        return node.value;
+    }
+}
+
+export { ValueGenerator };

package/dist/esm/generator/network/host-rule-generator.mjs

@@ -0,0 +1,36 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { SPACE, HASHMARK, EMPTY } from '../../utils/constants.mjs';
+import { BaseGenerator } from '../base-generator.mjs';
+
+class HostRuleGenerator extends BaseGenerator {
+    /**
+     * Converts a host rule node to a raw string.
+     *
+     * @param node Host rule node.
+     * @returns Raw string.
+     */
+    static generate(node) {
+        const result = [];
+        if (node.ip) {
+            result.push(node.ip.value);
+        }
+        if (node.hostnames) {
+            result.push(SPACE);
+            result.push(node.hostnames.children.map(({ value }) => value).join(SPACE));
+        }
+        if (node.comment) {
+            result.push(SPACE);
+            result.push(HASHMARK);
+            result.push(SPACE);
+            result.push(node.comment.value);
+        }
+        return result.join(EMPTY);
+    }
+}
+
+export { HostRuleGenerator };

package/dist/esm/generator/network/network-rule-generator.mjs

@@ -0,0 +1,35 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { NETWORK_RULE_SEPARATOR, EMPTY, NETWORK_RULE_EXCEPTION_MARKER } from '../../utils/constants.mjs';
+import { BaseGenerator } from '../base-generator.mjs';
+import { ModifierListGenerator } from '../misc/modifier-list-generator.mjs';
+
+class NetworkRuleGenerator extends BaseGenerator {
+    /**
+     * Converts a network rule (basic rule) AST to a string.
+     *
+     * @param node Network rule node
+     * @returns Raw string
+     */
+    static generate(node) {
+        let result = EMPTY;
+        // If the rule is an exception, add the exception marker: `@@||example.org`
+        if (node.exception) {
+            result += NETWORK_RULE_EXCEPTION_MARKER;
+        }
+        // Add the pattern: `||example.org`
+        result += node.pattern.value;
+        // If there are modifiers, add a separator and the modifiers: `||example.org$important`
+        if (node.modifiers && node.modifiers.children.length > 0) {
+            result += NETWORK_RULE_SEPARATOR;
+            result += ModifierListGenerator.generate(node.modifiers);
+        }
+        return result;
+    }
+}
+
+export { NetworkRuleGenerator };

package/dist/esm/generator/rule-generator.mjs

@@ -0,0 +1,62 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseGenerator } from './base-generator.mjs';
+import { RuleCategory, NetworkRuleType } from '../nodes/index.mjs';
+import { EMPTY } from '../utils/constants.mjs';
+import { CommentRuleGenerator } from './comment/comment-rule-generator.mjs';
+import { CosmeticRuleGenerator } from './cosmetic/cosmetic-rule-generator.mjs';
+import { HostRuleGenerator } from './network/host-rule-generator.mjs';
+import { NetworkRuleGenerator } from './network/network-rule-generator.mjs';
+
+class RuleGenerator extends BaseGenerator {
+    /**
+     * Converts a rule AST to a string.
+     *
+     * @param ast - Adblock rule AST
+     * @returns Raw string
+     * @example
+     * Take a look at the following example:
+     * ```js
+     * // Parse the rule to the AST
+     * const ast = RuleParser.parse("example.org##.banner");
+     * // Generate the rule from the AST
+     * const raw = RuleParser.generate(ast);
+     * // Print the generated rule
+     * console.log(raw); // "example.org##.banner"
+     * ```
+     */
+    static generate(ast) {
+        switch (ast.category) {
+            // Empty lines
+            case RuleCategory.Empty:
+                return EMPTY;
+            // Invalid rules
+            case RuleCategory.Invalid:
+                return ast.raw;
+            // Comment rules
+            case RuleCategory.Comment:
+                return CommentRuleGenerator.generate(ast);
+            // Cosmetic / non-basic rules
+            case RuleCategory.Cosmetic:
+                return CosmeticRuleGenerator.generate(ast);
+            // Network / basic rules
+            case RuleCategory.Network:
+                switch (ast.type) {
+                    case NetworkRuleType.HostRule:
+                        return HostRuleGenerator.generate(ast);
+                    case NetworkRuleType.NetworkRule:
+                        return NetworkRuleGenerator.generate(ast);
+                    default:
+                        throw new Error('Unknown network rule type');
+                }
+            default:
+                throw new Error('Unknown rule category');
+        }
+    }
+}
+
+export { RuleGenerator };

package/dist/esm/index.mjs

@@ -0,0 +1,70 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+export { RuleParser } from './parser/rule-parser.mjs';
+export { RuleSerializer } from './serializer/rule-serializer.mjs';
+export { RuleDeserializer } from './deserializer/rule-deserializer.mjs';
+export { RuleGenerator } from './generator/rule-generator.mjs';
+export { CommentMarker, CommentRuleType, CosmeticRuleSeparator, CosmeticRuleType, NetworkRuleType, RuleCategory } from './nodes/index.mjs';
+export { AdblockSyntaxError } from './errors/adblock-syntax-error.mjs';
+export { AgentCommentParser } from './parser/comment/agent-comment-parser.mjs';
+export { AgentParser } from './parser/comment/agent-parser.mjs';
+export { CommentParser } from './parser/comment/comment-parser.mjs';
+export { ConfigCommentParser } from './parser/comment/config-comment-parser.mjs';
+export { CosmeticRuleParser } from './parser/cosmetic/cosmetic-rule-parser.mjs';
+export { AppListParser } from './parser/misc/app-list-parser.mjs';
+export { DomainListParser } from './parser/misc/domain-list-parser.mjs';
+export { MethodListParser } from './parser/misc/method-list-parser.mjs';
+export { StealthOptionListParser } from './parser/misc/stealth-option-list-parser.mjs';
+export { FilterListParser } from './parser/filterlist-parser.mjs';
+export { FilterListSerializer } from './serializer/filterlist-serializer.mjs';
+export { FilterListDeserializer } from './deserializer/filterlist-deserializer.mjs';
+export { HintCommentParser } from './parser/comment/hint-comment-parser.mjs';
+export { HintParser } from './parser/comment/hint-parser.mjs';
+export { LogicalExpressionParser } from './parser/misc/logical-expression-parser.mjs';
+export { MetadataCommentParser } from './parser/comment/metadata-comment-parser.mjs';
+export { ModifierListParser } from './parser/misc/modifier-list.mjs';
+export { ModifierParser } from './parser/misc/modifier-parser.mjs';
+export { NetworkRuleParser } from './parser/network/network-rule-parser.mjs';
+export { NotImplementedError } from './errors/not-implemented-error.mjs';
+export { ParameterListParser } from './parser/misc/parameter-list-parser.mjs';
+export { HostRuleParser } from './parser/network/host-rule-parser.mjs';
+export { PreProcessorCommentParser } from './parser/comment/preprocessor-parser.mjs';
+export { RuleConversionError } from './errors/rule-conversion-error.mjs';
+export { BinarySchemaMismatchError } from './errors/binary-schema-mismatch-error.mjs';
+export { modifierValidator } from './validator/index.mjs';
+export { RawFilterListConverter } from './converter/raw-filter-list.mjs';
+export { RuleConverter } from './converter/rule.mjs';
+export { ADG_SCRIPTLET_MASK, AGLINT_COMMAND_PREFIX, COMMA_DOMAIN_LIST_SEPARATOR, HINT_MARKER, IF, INCLUDE, MODIFIERS_SEPARATOR, MODIFIER_ASSIGN_OPERATOR, NEGATION_MARKER, NETWORK_RULE_EXCEPTION_MARKER, NETWORK_RULE_SEPARATOR, PIPE_MODIFIER_SEPARATOR, PREPROCESSOR_MARKER, SAFARI_CB_AFFINITY, UBO_SCRIPTLET_MASK } from './utils/constants.mjs';
+export { BINARY_SCHEMA_VERSION } from './utils/binary-schema-version.mjs';
+export { AdblockSyntax } from './utils/adblockers.mjs';
+export { CosmeticRuleSeparatorUtils } from './utils/cosmetic-rule-separator.mjs';
+export { DomainUtils } from './utils/domain.mjs';
+export { LogicalExpressionUtils } from './utils/logical-expression.mjs';
+export { ADBLOCK_URL_SEPARATOR, ADBLOCK_URL_SEPARATOR_REGEX, ADBLOCK_URL_START, ADBLOCK_URL_START_REGEX, ADBLOCK_WILDCARD, ADBLOCK_WILDCARD_REGEX, RegExpUtils, SPECIAL_REGEX_SYMBOLS } from './utils/regexp.mjs';
+export { QuoteType, QuoteUtils } from './utils/quotes.mjs';
+export { PositionProvider } from './utils/position-provider.mjs';
+export { OutputByteBuffer } from './utils/output-byte-buffer.mjs';
+export { InputByteBuffer } from './utils/input-byte-buffer.mjs';
+export { ByteBuffer } from './utils/byte-buffer.mjs';
+export { encodeIntoPolyfill } from './utils/text-encoder-polyfill.mjs';
+export { decodeTextPolyfill } from './utils/text-decoder-polyfill.mjs';
+export { RuleCategorizer } from './utils/categorizer.mjs';
+export { EXT_CSS_LEGACY_ATTRIBUTES, EXT_CSS_PSEUDO_CLASSES, FORBIDDEN_CSS_FUNCTIONS } from './converter/data/css.mjs';
+export { modifiersCompatibilityTable } from './compatibility-tables/modifiers.mjs';
+export { redirectsCompatibilityTable } from './compatibility-tables/redirects.mjs';
+export { scriptletsCompatibilityTable } from './compatibility-tables/scriptlets.mjs';
+export { GenericPlatform, SpecificPlatform } from './compatibility-tables/platforms.mjs';
+import './compatibility-tables/schemas/base.mjs';
+import './compatibility-tables/schemas/modifier.mjs';
+import './compatibility-tables/schemas/redirect.mjs';
+import './compatibility-tables/schemas/scriptlet.mjs';
+export { parseRawPlatforms } from './compatibility-tables/schemas/platform.mjs';
+export { getPlatformId, getSpecificPlatformName, isGenericPlatform } from './compatibility-tables/utils/platform-helpers.mjs';
+export { ResourceType } from './compatibility-tables/schemas/resource-type.mjs';
+export { getResourceTypeModifier, isValidResourceType } from './compatibility-tables/utils/resource-type-helpers.mjs';
+export { AGTREE_VERSION } from './version.mjs';
+export { getSyntaxSerializationMap } from './marshalling-utils/syntax-serialization-map.mjs';

package/dist/esm/marshalling-utils/comment/agent-comment-common.mjs

@@ -0,0 +1,22 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+/**
+ * Property map for binary serialization. This helps to reduce the size of the serialized data,
+ * as it allows us to use a single byte to represent a property.
+ *
+ * ! IMPORTANT: If you change values here, please update the {@link BINARY_SCHEMA_VERSION}!
+ *
+ * @note Only 256 values can be represented this way.
+ */
+var AgentCommentMarshallingMap;
+(function (AgentCommentMarshallingMap) {
+    AgentCommentMarshallingMap[AgentCommentMarshallingMap["Children"] = 1] = "Children";
+    AgentCommentMarshallingMap[AgentCommentMarshallingMap["Start"] = 2] = "Start";
+    AgentCommentMarshallingMap[AgentCommentMarshallingMap["End"] = 3] = "End";
+})(AgentCommentMarshallingMap || (AgentCommentMarshallingMap = {}));
+
+export { AgentCommentMarshallingMap };

package/dist/esm/marshalling-utils/comment/agent-common.mjs

@@ -0,0 +1,41 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+/**
+ * Property map for binary serialization. This helps to reduce the size of the serialized data,
+ * as it allows us to use a single byte to represent a property.
+ *
+ * ! IMPORTANT: If you change values here, please update the {@link BINARY_SCHEMA_VERSION}!
+ *
+ * @note Only 256 values can be represented this way.
+ */
+var AgentNodeMarshallingMap;
+(function (AgentNodeMarshallingMap) {
+    AgentNodeMarshallingMap[AgentNodeMarshallingMap["Adblock"] = 1] = "Adblock";
+    AgentNodeMarshallingMap[AgentNodeMarshallingMap["Version"] = 2] = "Version";
+    AgentNodeMarshallingMap[AgentNodeMarshallingMap["Start"] = 3] = "Start";
+    AgentNodeMarshallingMap[AgentNodeMarshallingMap["End"] = 4] = "End";
+})(AgentNodeMarshallingMap || (AgentNodeMarshallingMap = {}));
+/**
+ * Value map for binary deserialization. This helps to reduce the size of the serialized data,
+ * as it allows us to use a single byte to represent frequently used values.
+ */
+const FREQUENT_AGENTS_DESERIALIZATION_MAP = new Map([
+    // AdGuard
+    [0, 'AdGuard'],
+    [1, 'ADG'],
+    // uBlock Origin
+    [2, 'uBlock Origin'],
+    [3, 'uBlock'],
+    [4, 'uBO'],
+    // Adblock Plus
+    [5, 'Adblock Plus'],
+    [6, 'AdblockPlus'],
+    [7, 'ABP'],
+    [8, 'AdBlock'],
+]);
+
+export { AgentNodeMarshallingMap, FREQUENT_AGENTS_DESERIALIZATION_MAP };

package/dist/esm/marshalling-utils/comment/config-comment-common.mjs

@@ -0,0 +1,56 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+/**
+ * Property map for binary serialization. This helps to reduce the size of the serialized data,
+ * as it allows us to use a single byte to represent a property.
+ *
+ * ! IMPORTANT: If you change values here, please update the {@link BINARY_SCHEMA_VERSION}!
+ *
+ * @note Only 256 values can be represented this way.
+ */
+var ConfigCommentRuleMarshallingMap;
+(function (ConfigCommentRuleMarshallingMap) {
+    ConfigCommentRuleMarshallingMap[ConfigCommentRuleMarshallingMap["Marker"] = 1] = "Marker";
+    ConfigCommentRuleMarshallingMap[ConfigCommentRuleMarshallingMap["Command"] = 2] = "Command";
+    ConfigCommentRuleMarshallingMap[ConfigCommentRuleMarshallingMap["Params"] = 3] = "Params";
+    ConfigCommentRuleMarshallingMap[ConfigCommentRuleMarshallingMap["Comment"] = 4] = "Comment";
+    ConfigCommentRuleMarshallingMap[ConfigCommentRuleMarshallingMap["Start"] = 5] = "Start";
+    ConfigCommentRuleMarshallingMap[ConfigCommentRuleMarshallingMap["End"] = 6] = "End";
+})(ConfigCommentRuleMarshallingMap || (ConfigCommentRuleMarshallingMap = {}));
+/**
+ * Property map for binary serialization. This helps to reduce the size of the serialized data,
+ * as it allows us to use a single byte to represent a property.
+ *
+ * ! IMPORTANT: If you change values here, please update the {@link BINARY_SCHEMA_VERSION}!
+ *
+ * @note Only 256 values can be represented this way.
+ */
+var ConfigNodeMarshallingMap;
+(function (ConfigNodeMarshallingMap) {
+    ConfigNodeMarshallingMap[ConfigNodeMarshallingMap["Value"] = 1] = "Value";
+    ConfigNodeMarshallingMap[ConfigNodeMarshallingMap["Start"] = 2] = "Start";
+    ConfigNodeMarshallingMap[ConfigNodeMarshallingMap["End"] = 3] = "End";
+})(ConfigNodeMarshallingMap || (ConfigNodeMarshallingMap = {}));
+/**
+ * Value map for binary serialization. This helps to reduce the size of the serialized data,
+ * as it allows us to use a single byte to represent frequently used values.
+ *
+ * ! IMPORTANT: If you change values here, please update the {@link BINARY_SCHEMA_VERSION}!
+ *
+ * @note Only 256 values can be represented this way.
+ *
+ * @see {@link https://github.com/AdguardTeam/AGLint/blob/master/src/linter/inline-config.ts}
+ */
+const FREQUENT_COMMANDS_SERIALIZATION_MAP = new Map([
+    ['aglint', 0],
+    ['aglint-disable', 1],
+    ['aglint-enable', 2],
+    ['aglint-disable-next-line', 3],
+    ['aglint-enable-next-line', 4],
+]);
+
+export { ConfigCommentRuleMarshallingMap, ConfigNodeMarshallingMap, FREQUENT_COMMANDS_SERIALIZATION_MAP };

package/dist/esm/marshalling-utils/comment/hint-comment-common.mjs

@@ -0,0 +1,23 @@
+/*
+ * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+/**
+ * Property map for binary serialization. This helps to reduce the size of the serialized data,
+ * as it allows us to use a single byte to represent a property.
+ *
+ * ! IMPORTANT: If you change values here, please update the {@link BINARY_SCHEMA_VERSION}!
+ *
+ * @note Only 256 values can be represented this way.
+ */
+var HintCommentMarshallingMap;
+(function (HintCommentMarshallingMap) {
+    HintCommentMarshallingMap[HintCommentMarshallingMap["Syntax"] = 1] = "Syntax";
+    HintCommentMarshallingMap[HintCommentMarshallingMap["Children"] = 2] = "Children";
+    HintCommentMarshallingMap[HintCommentMarshallingMap["Start"] = 3] = "Start";
+    HintCommentMarshallingMap[HintCommentMarshallingMap["End"] = 4] = "End";
+})(HintCommentMarshallingMap || (HintCommentMarshallingMap = {}));
+
+export { HintCommentMarshallingMap };