@adguard/agtree 3.4.3 → 4.0.0

package/dist/serializer/cosmetic/cosmetic-rule-serializer.js

@@ -1,120 +0,0 @@
-/*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 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.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';
-
-/**
- * `CosmeticRuleSerializer` is responsible for serializing cosmetic rules into a binary format.
- *
- * 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.
- */
-class CosmeticRuleSerializer extends BaseSerializer {
-    /**
-     * Serializes a cosmetic rule node to binary format.
-     *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     */
-    // TODO: add support for raws, if ever needed
-    static serialize(node, buffer) {
-        // specific properties
-        switch (node.type) {
-            case CosmeticRuleType.ElementHidingRule:
-                // rule type
-                buffer.writeUint8(BinaryTypeMarshallingMap.ElementHidingRule);
-                // syntax
-                buffer.writeUint8(getSyntaxSerializationMap().get(node.syntax) ?? 0);
-                // rule body
-                ElementHidingBodySerializer.serialize(node.body, buffer);
-                break;
-            case CosmeticRuleType.CssInjectionRule:
-                // rule type
-                buffer.writeUint8(BinaryTypeMarshallingMap.CssInjectionRule);
-                // syntax
-                buffer.writeUint8(getSyntaxSerializationMap().get(node.syntax) ?? 0);
-                // rule body
-                CssInjectionBodySerializer.serialize(node.body, buffer);
-                break;
-            case CosmeticRuleType.JsInjectionRule:
-                // rule type
-                buffer.writeUint8(BinaryTypeMarshallingMap.JsInjectionRule);
-                // syntax
-                buffer.writeUint8(getSyntaxSerializationMap().get(node.syntax) ?? 0);
-                // rule body
-                ValueSerializer.serialize(node.body, buffer);
-                break;
-            case CosmeticRuleType.HtmlFilteringRule:
-                // rule type
-                buffer.writeUint8(BinaryTypeMarshallingMap.HtmlFilteringRule);
-                // syntax
-                buffer.writeUint8(getSyntaxSerializationMap().get(node.syntax) ?? 0);
-                // rule body
-                ValueSerializer.serialize(node.body, buffer);
-                break;
-            case CosmeticRuleType.ScriptletInjectionRule:
-                // rule type
-                buffer.writeUint8(BinaryTypeMarshallingMap.ScriptletInjectionRule);
-                // syntax
-                buffer.writeUint8(getSyntaxSerializationMap().get(node.syntax) ?? 0);
-                // rule body
-                switch (node.syntax) {
-                    case AdblockSyntax.Adg:
-                        AdgScriptletInjectionBodySerializer.serialize(node.body, buffer);
-                        break;
-                    case AdblockSyntax.Abp:
-                        AbpSnippetInjectionBodySerializer.serialize(node.body, buffer);
-                        break;
-                    case AdblockSyntax.Ubo:
-                        UboScriptletInjectionBodySerializer.serialize(node.body, buffer);
-                        break;
-                    default:
-                        throw new Error('Scriptlet rule should have an explicit syntax');
-                }
-                break;
-            default:
-                throw new Error('Unknown cosmetic rule type');
-        }
-        // common properties
-        buffer.writeUint8(CosmeticRuleMarshallingMap.Exception);
-        buffer.writeUint8(node.exception ? 1 : 0);
-        buffer.writeUint8(CosmeticRuleMarshallingMap.Separator);
-        ValueSerializer.serialize(node.separator, buffer, COSMETIC_RULE_SEPARATOR_SERIALIZATION_MAP);
-        if (node.modifiers) {
-            buffer.writeUint8(CosmeticRuleMarshallingMap.Modifiers);
-            ModifierListSerializer.serialize(node.modifiers, buffer);
-        }
-        buffer.writeUint8(CosmeticRuleMarshallingMap.Domains);
-        DomainListSerializer.serialize(node.domains, buffer);
-        if (!isUndefined(node.start)) {
-            buffer.writeUint8(CosmeticRuleMarshallingMap.Start);
-            buffer.writeUint32(node.start);
-        }
-        if (!isUndefined(node.end)) {
-            buffer.writeUint8(CosmeticRuleMarshallingMap.End);
-            buffer.writeUint32(node.end);
-        }
-        buffer.writeUint8(NULL);
-    }
-}
-
-export { CosmeticRuleSerializer };

package/dist/serializer/cosmetic/css-injection-body-serializer.js

@@ -1,51 +0,0 @@
-/*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 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.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.
-     *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     */
-    static serialize(node, buffer) {
-        buffer.writeUint8(BinaryTypeMarshallingMap.CssInjectionRuleBody);
-        if (node.mediaQueryList) {
-            buffer.writeUint8(CssInjectionRuleMarshallingMap.MediaQueryList);
-            ValueSerializer.serialize(node.mediaQueryList, buffer);
-        }
-        buffer.writeUint8(CssInjectionRuleMarshallingMap.SelectorList);
-        ValueSerializer.serialize(node.selectorList, buffer);
-        if (node.declarationList) {
-            buffer.writeUint8(CssInjectionRuleMarshallingMap.DeclarationList);
-            ValueSerializer.serialize(node.declarationList, buffer);
-        }
-        if (node.remove) {
-            buffer.writeUint8(CssInjectionRuleMarshallingMap.Remove);
-        }
-        if (!isUndefined(node.start)) {
-            buffer.writeUint8(CssInjectionRuleMarshallingMap.Start);
-            buffer.writeUint32(node.start);
-        }
-        if (!isUndefined(node.end)) {
-            buffer.writeUint8(CssInjectionRuleMarshallingMap.End);
-            buffer.writeUint32(node.end);
-        }
-        buffer.writeUint8(NULL);
-    }
-}
-
-export { CssInjectionBodySerializer };

package/dist/serializer/cosmetic/element-hiding-body-serializer.js

@@ -1,40 +0,0 @@
-/*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 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.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.
-     *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     */
-    static serialize(node, buffer) {
-        buffer.writeUint8(BinaryTypeMarshallingMap.ElementHidingRuleBody);
-        buffer.writeUint8(ElementHidingRuleMarshallingMap.SelectorList);
-        ValueSerializer.serialize(node.selectorList, buffer);
-        if (!isUndefined(node.start)) {
-            buffer.writeUint8(ElementHidingRuleMarshallingMap.Start);
-            buffer.writeUint32(node.start);
-        }
-        if (!isUndefined(node.end)) {
-            buffer.writeUint8(ElementHidingRuleMarshallingMap.End);
-            buffer.writeUint32(node.end);
-        }
-        buffer.writeUint8(NULL);
-    }
-}
-
-export { ElementHidingBodySerializer };

package/dist/serializer/empty-rule-serializer.js

@@ -1,37 +0,0 @@
-/*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 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.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.
-     *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     */
-    static serialize(node, buffer) {
-        buffer.writeUint8(BinaryTypeMarshallingMap.EmptyRule);
-        if (!isUndefined(node.start)) {
-            buffer.writeUint8(EmptyRuleMarshallingMap.Start);
-            buffer.writeUint32(node.start);
-        }
-        if (!isUndefined(node.end)) {
-            buffer.writeUint8(EmptyRuleMarshallingMap.End);
-            buffer.writeUint32(node.end);
-        }
-        buffer.writeUint8(NULL);
-    }
-}
-
-export { EmptyRuleSerializer };

package/dist/serializer/filterlist-serializer.js

@@ -1,45 +0,0 @@
-/*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 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.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';
-
-/**
- * Serializes filter list nodes to binary format.
- */
-class FilterListSerializer extends BaseSerializer {
-    /**
-     * Serializes a filter list node to binary format.
-     *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     */
-    // TODO: add support for raws, if ever needed
-    static serialize(node, buffer) {
-        buffer.writeUint8(BinaryTypeMarshallingMap.FilterListNode);
-        buffer.writeUint8(FilterListNodeMarshallingMap.Children);
-        const count = node.children.length;
-        buffer.writeUint32(count);
-        for (let i = 0; i < count; i += 1) {
-            RuleSerializer.serialize(node.children[i], buffer);
-        }
-        if (!isUndefined(node.start)) {
-            buffer.writeUint8(FilterListNodeMarshallingMap.Start);
-            buffer.writeUint32(node.start);
-        }
-        if (!isUndefined(node.end)) {
-            buffer.writeUint8(FilterListNodeMarshallingMap.End);
-            buffer.writeUint32(node.end);
-        }
-        buffer.writeUint8(NULL);
-    }
-}
-
-export { FilterListSerializer };

package/dist/serializer/index.js

@@ -1,7 +0,0 @@
-/*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 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/serializer/invalid-rule-error-node-serializer.js

@@ -1,41 +0,0 @@
-/*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 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.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.
-     *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     */
-    static serialize(node, buffer) {
-        buffer.writeUint8(BinaryTypeMarshallingMap.InvalidRuleErrorNode);
-        buffer.writeUint8(InvalidRuleErrorNodeMarshallingMap.Name);
-        buffer.writeString(node.name);
-        buffer.writeUint8(InvalidRuleErrorNodeMarshallingMap.Message);
-        buffer.writeString(node.message);
-        if (!isUndefined(node.start)) {
-            buffer.writeUint8(InvalidRuleErrorNodeMarshallingMap.Start);
-            buffer.writeUint32(node.start);
-        }
-        if (!isUndefined(node.end)) {
-            buffer.writeUint8(InvalidRuleErrorNodeMarshallingMap.End);
-            buffer.writeUint32(node.end);
-        }
-        buffer.writeUint8(NULL);
-    }
-}
-
-export { InvalidRuleErrorNodeSerializer };

package/dist/serializer/invalid-rule-serializer.js

@@ -1,40 +0,0 @@
-/*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 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.js';
-import { isUndefined } from '../utils/type-guards.js';
-import { NULL } from '../utils/constants.js';
-import { InvalidRuleErrorNodeSerializer } from './invalid-rule-error-node-serializer.js';
-import { InvalidRuleMarshallingMap } from '../marshalling-utils/invalid-rule-common.js';
-import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
-
-/**
- * Serializer for invalid rule nodes.
- */
-class InvalidRuleSerializer extends BaseSerializer {
-    /**
-     * Serializes an invalid rule node to binary format.
-     *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     */
-    static serialize(node, buffer) {
-        buffer.writeUint8(BinaryTypeMarshallingMap.InvalidRule);
-        buffer.writeUint8(InvalidRuleMarshallingMap.Error);
-        InvalidRuleErrorNodeSerializer.serialize(node.error, buffer);
-        if (!isUndefined(node.start)) {
-            buffer.writeUint8(InvalidRuleMarshallingMap.Start);
-            buffer.writeUint32(node.start);
-        }
-        if (!isUndefined(node.end)) {
-            buffer.writeUint8(InvalidRuleMarshallingMap.End);
-            buffer.writeUint32(node.end);
-        }
-        buffer.writeUint8(NULL);
-    }
-}
-
-export { InvalidRuleSerializer };

package/dist/serializer/misc/domain-list-serializer.js

@@ -1,64 +0,0 @@
-/*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
- * Released under the MIT license
- * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
- */
-import { NULL, COMMA, PIPE } from '../../utils/constants.js';
-import { isUndefined } from '../../utils/type-guards.js';
-import { BaseSerializer } from '../base-serializer.js';
-import { ListItemsSerializer } from './list-items-serializer.js';
-import { DomainListMarshallingMap } from '../../marshalling-utils/misc/domain-list-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,
- * 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.
- */
-const SEPARATOR_SERIALIZATION_MAP = new Map([
-    [COMMA, 0],
-    [PIPE, 1],
-]);
-/**
- * `DomainListSerializer` is responsible for serializing a domain list.
- *
- * @example
- * - If the rule is `example.com,~example.net##.ads`, the domain list is `example.com,~example.net`.
- * - If the rule is `ads.js^$script,domains=example.com|~example.org`, the domain list is `example.com|~example.org`.
- * This serializer is responsible for serializing these domain lists.
- * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#elemhide_domains}
- */
-class DomainListSerializer extends BaseSerializer {
-    /**
-     * Serializes a domain list node to binary format.
-     *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     */
-    static serialize(node, buffer) {
-        buffer.writeUint8(BinaryTypeMarshallingMap.DomainListNode);
-        const separator = SEPARATOR_SERIALIZATION_MAP.get(node.separator);
-        if (isUndefined(separator)) {
-            throw new Error(`Invalid separator: ${node.separator}`);
-        }
-        buffer.writeUint8(DomainListMarshallingMap.Separator);
-        buffer.writeUint8(separator);
-        buffer.writeUint8(DomainListMarshallingMap.Children);
-        ListItemsSerializer.serialize(node.children, buffer);
-        if (!isUndefined(node.start)) {
-            buffer.writeUint8(DomainListMarshallingMap.Start);
-            buffer.writeUint32(node.start);
-        }
-        if (!isUndefined(node.end)) {
-            buffer.writeUint8(DomainListMarshallingMap.End);
-            buffer.writeUint32(node.end);
-        }
-        buffer.writeUint8(NULL);
-    }
-}
-
-export { DomainListSerializer };

package/dist/serializer/misc/list-item-serializer.js

@@ -1,58 +0,0 @@
-/*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 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.js';
-import { ListItemNodeType } from '../../nodes/index.js';
-import { isUndefined } from '../../utils/type-guards.js';
-import { NULL } from '../../utils/constants.js';
-import { ListItemMarshallingMap } from '../../marshalling-utils/misc/list-item-common.js';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
-
-/**
- * Serializer for list item nodes.
- */
-class ListItemSerializer extends BaseSerializer {
-    /**
-     * Serializes a list item to binary format.
-     *
-     * @param item List item to serialize.
-     * @param buffer Output byte buffer.
-     * @template T Type of the list item.
-     */
-    static serialize(item, buffer) {
-        switch (item.type) {
-            case ListItemNodeType.App:
-                buffer.writeUint8(BinaryTypeMarshallingMap.AppNode);
-                break;
-            case ListItemNodeType.Domain:
-                buffer.writeUint8(BinaryTypeMarshallingMap.DomainNode);
-                break;
-            case ListItemNodeType.Method:
-                buffer.writeUint8(BinaryTypeMarshallingMap.MethodNode);
-                break;
-            case ListItemNodeType.StealthOption:
-                buffer.writeUint8(BinaryTypeMarshallingMap.StealthOptionNode);
-                break;
-            default:
-                throw new Error(`Invalid list item type: ${item.type}`);
-        }
-        buffer.writeUint8(ListItemMarshallingMap.Exception);
-        buffer.writeUint8(item.exception ? 1 : 0);
-        buffer.writeUint8(ListItemMarshallingMap.Value);
-        buffer.writeString(item.value);
-        if (!isUndefined(item.start)) {
-            buffer.writeUint8(ListItemMarshallingMap.Start);
-            buffer.writeUint32(item.start);
-        }
-        if (!isUndefined(item.end)) {
-            buffer.writeUint8(ListItemMarshallingMap.End);
-            buffer.writeUint32(item.end);
-        }
-        buffer.writeUint8(NULL);
-    }
-}
-
-export { ListItemSerializer };

package/dist/serializer/misc/list-items-serializer.js

@@ -1,29 +0,0 @@
-/*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 GMT)
- * (c) 2025 Adguard Software Ltd.
- * Released under the MIT license
- * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
- */
-import { ListItemSerializer } from './list-item-serializer.js';
-
-/**
- * Serializer for list items.
- */
-class ListItemsSerializer {
-    /**
-     * Serializes a list of items to binary format.
-     *
-     * @param items List of items to serialize.
-     * @param buffer Output byte buffer.
-     * @template T Type of the list items.
-     */
-    static serialize(items, buffer) {
-        const { length } = items;
-        buffer.writeUint16(length);
-        for (let i = 0; i < length; i += 1) {
-            ListItemSerializer.serialize(items[i], buffer);
-        }
-    }
-}
-
-export { ListItemsSerializer };

package/dist/serializer/misc/logical-expression-serializer.js

@@ -1,136 +0,0 @@
-/*
- * AGTree v3.4.3 (build date: Thu, 11 Dec 2025 13:43:19 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.js';
-import { isUndefined } from '../../utils/type-guards.js';
-import { BaseSerializer } from '../base-serializer.js';
-import { KNOWN_VARIABLES_SERIALIZATION_MAP, VariableNodeBinaryPropMarshallingMap, ParenthesisNodeBinaryPropMarshallingMap, OperatorNodeBinaryPropMarshallingMap, LOGICAL_EXPRESSION_OPERATOR_SERIALISATION_MAP } from '../../marshalling-utils/misc/logical-expression-common.js';
-import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.js';
-
-/**
- * Possible node types in the logical expression.
- */
-const NodeType = {
-    Variable: 'Variable',
-    Operator: 'Operator',
-    Parenthesis: 'Parenthesis',
-};
-/**
- * `LogicalExpressionSerializer` is responsible for serializing logical expressions.
- *
- * @example
- * From the following rule:
- * ```adblock
- * !#if (adguard_ext_android_cb || adguard_ext_safari)
- * ```
- * this parser will parse the expression `(adguard_ext_android_cb || adguard_ext_safari)`.
- */
-// TODO: Refactor this class
-class LogicalExpressionSerializer extends BaseSerializer {
-    /**
-     * Serializes a variable node to binary format.
-     *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     */
-    // TODO: create a common serialize / deserialize interface for such nodes (Variable, Value, Parameter, etc.)
-    static serializeVariableNode(node, buffer) {
-        buffer.writeUint8(BinaryTypeMarshallingMap.ExpressionVariableNode);
-        const frequentName = KNOWN_VARIABLES_SERIALIZATION_MAP.get(node.name);
-        if (!isUndefined(frequentName)) {
-            buffer.writeUint8(VariableNodeBinaryPropMarshallingMap.FrequentName);
-            buffer.writeUint8(frequentName);
-        }
-        else {
-            buffer.writeUint8(VariableNodeBinaryPropMarshallingMap.Name);
-            buffer.writeString(node.name);
-        }
-        if (!isUndefined(node.start)) {
-            buffer.writeUint8(VariableNodeBinaryPropMarshallingMap.Start);
-            buffer.writeUint32(node.start);
-        }
-        if (!isUndefined(node.end)) {
-            buffer.writeUint8(VariableNodeBinaryPropMarshallingMap.End);
-            buffer.writeUint32(node.end);
-        }
-        buffer.writeUint8(NULL);
-    }
-    /**
-     * Serializes a parenthesis node to binary format.
-     *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     */
-    static serializeParenthesisNode(node, buffer) {
-        buffer.writeUint8(BinaryTypeMarshallingMap.ExpressionParenthesisNode);
-        buffer.writeUint8(ParenthesisNodeBinaryPropMarshallingMap.Expression);
-        LogicalExpressionSerializer.serialize(node.expression, buffer);
-        if (!isUndefined(node.start)) {
-            buffer.writeUint8(ParenthesisNodeBinaryPropMarshallingMap.Start);
-            buffer.writeUint32(node.start);
-        }
-        if (!isUndefined(node.end)) {
-            buffer.writeUint8(ParenthesisNodeBinaryPropMarshallingMap.End);
-            buffer.writeUint32(node.end);
-        }
-        buffer.writeUint8(NULL);
-    }
-    /**
-     * Serializes an operator node to binary format.
-     *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     */
-    static serializeOperatorNode(node, buffer) {
-        buffer.writeUint8(BinaryTypeMarshallingMap.ExpressionOperatorNode);
-        buffer.writeUint8(OperatorNodeBinaryPropMarshallingMap.Operator);
-        const operatorBinary = LOGICAL_EXPRESSION_OPERATOR_SERIALISATION_MAP.get(node.operator);
-        if (isUndefined(operatorBinary)) {
-            throw new Error(`Unknown operator: ${node.operator}`);
-        }
-        buffer.writeUint8(operatorBinary);
-        buffer.writeUint8(OperatorNodeBinaryPropMarshallingMap.Left);
-        LogicalExpressionSerializer.serialize(node.left, buffer);
-        if (node.right) {
-            buffer.writeUint8(OperatorNodeBinaryPropMarshallingMap.Right);
-            LogicalExpressionSerializer.serialize(node.right, buffer);
-        }
-        if (!isUndefined(node.start)) {
-            buffer.writeUint8(OperatorNodeBinaryPropMarshallingMap.Start);
-            buffer.writeUint32(node.start);
-        }
-        if (!isUndefined(node.end)) {
-            buffer.writeUint8(OperatorNodeBinaryPropMarshallingMap.End);
-            buffer.writeUint32(node.end);
-        }
-        buffer.writeUint8(NULL);
-    }
-    /**
-     * Serializes a logical expression node to binary format.
-     *
-     * @param node Node to serialize.
-     * @param buffer ByteBuffer for writing binary data.
-     */
-    static serialize(node, buffer) {
-        switch (node.type) {
-            case NodeType.Variable:
-                LogicalExpressionSerializer.serializeVariableNode(node, buffer);
-                break;
-            case NodeType.Operator:
-                LogicalExpressionSerializer.serializeOperatorNode(node, buffer);
-                break;
-            case NodeType.Parenthesis:
-                LogicalExpressionSerializer.serializeParenthesisNode(node, buffer);
-                break;
-            default:
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                throw new Error(`Unexpected node type: ${node.type}`);
-        }
-        buffer.writeUint8(NULL);
-    }
-}
-
-export { LogicalExpressionSerializer, NodeType };