@adguard/agtree 3.4.3 → 4.0.1

package/dist/deserializer/rule-deserializer.js

@@ -1,65 +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 { BaseDeserializer } from './base-deserializer.js';
-import { CommentRuleDeserializer } from './comment/comment-rule-deserializer.js';
-import { CosmeticRuleDeserializer } from './cosmetic/cosmetic-rule-deserializer.js';
-import { HostRuleDeserializer } from './network/host-rule-deserializer.js';
-import { NetworkRuleDeserializer } from './network/network-rule-deserializer.js';
-import { EmptyRuleDeserializer } from './empty-rule-deserializer.js';
-import { InvalidRuleDeserializer } from './invalid-rule-deserializer.js';
-import { BinaryTypeMarshallingMap } from '../marshalling-utils/misc/binary-type-common.js';
-
-/**
- * `RuleDeserializer` is responsible for deserializing the rules.
- *
- * It automatically determines the category and syntax of the rule, so you can pass any kind of rule to it.
- */
-class RuleDeserializer extends BaseDeserializer {
-    /**
-     * Deserializes a rule node from binary format.
-     *
-     * @param buffer ByteBuffer for reading binary data.
-     * @param node Destination node.
-     */
-    static deserialize(buffer, node) {
-        // lookup instead of storing +1 byte
-        const type = buffer.peekUint8();
-        switch (type) {
-            case BinaryTypeMarshallingMap.AgentRuleNode:
-            case BinaryTypeMarshallingMap.HintRuleNode:
-            case BinaryTypeMarshallingMap.PreProcessorCommentRuleNode:
-            case BinaryTypeMarshallingMap.MetadataCommentRuleNode:
-            case BinaryTypeMarshallingMap.ConfigCommentRuleNode:
-            case BinaryTypeMarshallingMap.CommentRuleNode:
-                CommentRuleDeserializer.deserialize(buffer, node);
-                break;
-            case BinaryTypeMarshallingMap.ElementHidingRule:
-            case BinaryTypeMarshallingMap.CssInjectionRule:
-            case BinaryTypeMarshallingMap.ScriptletInjectionRule:
-            case BinaryTypeMarshallingMap.HtmlFilteringRule:
-            case BinaryTypeMarshallingMap.JsInjectionRule:
-                CosmeticRuleDeserializer.deserialize(buffer, node);
-                break;
-            case BinaryTypeMarshallingMap.NetworkRuleNode:
-                NetworkRuleDeserializer.deserialize(buffer, node);
-                break;
-            case BinaryTypeMarshallingMap.HostRuleNode:
-                HostRuleDeserializer.deserialize(buffer, node);
-                break;
-            case BinaryTypeMarshallingMap.EmptyRule:
-                EmptyRuleDeserializer.deserialize(buffer, node);
-                break;
-            case BinaryTypeMarshallingMap.InvalidRule:
-                InvalidRuleDeserializer.deserialize(buffer, node);
-                break;
-            default:
-                throw new Error('Unknown rule category');
-        }
-    }
-}
-
-export { RuleDeserializer };

package/dist/deserializer/syntax-deserialization-map.js

@@ -1,21 +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 { getSyntaxSerializationMap } from '../marshalling-utils/syntax-serialization-map.js';
-
-/**
- * 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.
- */
-let syntaxDeserializationMap;
-const getSyntaxDeserializationMap = () => {
-    if (!syntaxDeserializationMap) {
-        syntaxDeserializationMap = new Map(Array.from(getSyntaxSerializationMap(), ([key, value]) => [value, key]));
-    }
-    return syntaxDeserializationMap;
-};
-
-export { getSyntaxDeserializationMap };

package/dist/marshalling-utils/comment/agent-comment-common.js

@@ -1,21 +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
- */
-/**
- * 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.
- */
-const AgentCommentMarshallingMap = {
-    Children: 1,
-    Start: 2,
-    End: 3,
-};
-
-export { AgentCommentMarshallingMap };

package/dist/marshalling-utils/comment/agent-common.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
- */
-/**
- * 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.
- */
-const AgentNodeMarshallingMap = {
-    Adblock: 1,
-    Version: 2,
-    Start: 3,
-    End: 4,
-};
-/**
- * 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/marshalling-utils/comment/config-comment-common.js

@@ -1,54 +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
- */
-/**
- * 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.
- */
-const ConfigCommentRuleMarshallingMap = {
-    Marker: 1,
-    Command: 2,
-    Params: 3,
-    Comment: 4,
-    Start: 5,
-    End: 6,
-};
-/**
- * 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.
- */
-const ConfigNodeMarshallingMap = {
-    Value: 1,
-    Start: 2,
-    End: 3,
-};
-/**
- * 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/marshalling-utils/comment/hint-comment-common.js

@@ -1,22 +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
- */
-/**
- * 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.
- */
-const HintCommentMarshallingMap = {
-    Syntax: 1,
-    Children: 2,
-    Start: 3,
-    End: 4,
-};
-
-export { HintCommentMarshallingMap };

package/dist/marshalling-utils/comment/hint-common.js

@@ -1,56 +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
- */
-/**
- * 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.
- */
-const HintNodeMarshallingMap = {
-    Name: 1,
-    Params: 2,
-    Start: 3,
-    End: 4,
-};
-/**
- * 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 FREQUENT_HINTS_SERIALIZATION_MAP = new Map([
-    ['NOT_OPTIMIZED', 0],
-    ['PLATFORM', 1],
-    ['NOT_PLATFORM', 2],
-]);
-/**
- * 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 FREQUENT_PLATFORMS_SERIALIZATION_MAP = new Map([
-    ['windows', 0],
-    ['mac', 1],
-    ['android', 2],
-    ['ios', 3],
-    ['ext_chromium', 4],
-    ['ext_ff', 5],
-    ['ext_edge', 6],
-    ['ext_opera', 7],
-    ['ext_safari', 8],
-    ['ext_android_cb', 9],
-    ['ext_ublock', 10],
-]);
-
-export { FREQUENT_HINTS_SERIALIZATION_MAP, FREQUENT_PLATFORMS_SERIALIZATION_MAP, HintNodeMarshallingMap };

package/dist/marshalling-utils/comment/metadata-comment-common.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
- */
-/**
- * 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.
- */
-const MetadataCommentMarshallingMap = {
-    Marker: 1,
-    Header: 2,
-    Value: 3,
-    Start: 4,
-    End: 5,
-};
-/**
- * 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_HEADERS_DESERIALIZATION_MAP = new Map([
-    [1, 'Checksum'],
-    [2, 'Description'],
-    [3, 'Expires'],
-    [4, 'Homepage'],
-    [5, 'Last Modified'],
-    [6, 'LastModified'],
-    [7, 'Licence'],
-    [8, 'License'],
-    [9, 'Time Updated'],
-    [10, 'TimeUpdated'],
-    [11, 'Version'],
-    [12, 'Title'],
-]);
-
-export { FREQUENT_HEADERS_DESERIALIZATION_MAP, MetadataCommentMarshallingMap };

package/dist/marshalling-utils/comment/pre-processor-comment-common.js

@@ -1,59 +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
- */
-/**
- * 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.
- */
-const PreProcessorRuleMarshallingMap = {
-    Name: 1,
-    Params: 2,
-    Syntax: 3,
-    Start: 4,
-    End: 5,
-};
-/**
- * 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://adguard.com/kb/general/ad-filtering/create-own-filters/#preprocessor-directives}
- * @see {@link https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#pre-parsing-directives}
- */
-const FREQUENT_DIRECTIVES_SERIALIZATION_MAP = new Map([
-    ['if', 0],
-    ['else', 1],
-    ['endif', 2],
-    ['include', 3],
-    ['safari_cb_affinity', 4],
-]);
-/**
- * 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 FREQUENT_PARAMS_SERIALIZATION_MAP = new Map([
-    // safari_cb_affinity parameters
-    ['general', 0],
-    ['privacy', 1],
-    ['social', 2],
-    ['security', 3],
-    ['other', 4],
-    ['custom', 5],
-    ['all', 6],
-]);
-
-export { FREQUENT_DIRECTIVES_SERIALIZATION_MAP, FREQUENT_PARAMS_SERIALIZATION_MAP, PreProcessorRuleMarshallingMap };

package/dist/marshalling-utils/comment/simple-comment-common.js

@@ -1,22 +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
- */
-/**
- * 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.
- */
-const SimpleCommentMarshallingMap = {
-    Marker: 1,
-    Text: 2,
-    Start: 3,
-    End: 4,
-};
-
-export { SimpleCommentMarshallingMap };

package/dist/marshalling-utils/cosmetic/body/abp-snippet-injection-body-common.js

@@ -1,61 +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
- */
-/**
- * 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.
- */
-const AbpSnippetBodyMarshallingMap = {
-    Children: 1,
-    Start: 2,
-    End: 3,
-};
-/**
- * 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.
- */
-// TODO: Update this map with the actual values
-const FREQUENT_ABP_SNIPPET_ARGS_SERIALIZATION_MAP = new Map([
-    ['abort-current-inline-script', 0],
-    ['abort-on-property-read', 1],
-    ['abort-on-property-write', 2],
-    ['json-prune', 3],
-    ['log', 4],
-    ['prevent-listener', 5],
-    ['cookie-remover', 6],
-    ['override-property-read', 7],
-    ['abort-on-iframe-property-read', 8],
-    ['abort-on-iframe-property-write', 9],
-    ['freeze-element', 10],
-    ['json-override', 11],
-    ['simulate-mouse-event', 12],
-    ['strip-fetch-query-parameter', 13],
-    ['hide-if-contains', 14],
-    ['hide-if-contains-image', 15],
-    ['hide-if-contains-image-hash', 16],
-    ['hide-if-contains-similar-text', 17],
-    ['hide-if-contains-visible-text', 18],
-    ['hide-if-contains-and-matches-style', 19],
-    ['hide-if-graph-matches', 20],
-    ['hide-if-has-and-matches-style', 21],
-    ['hide-if-labelled-by', 22],
-    ['hide-if-matches-xpath', 23],
-    ['hide-if-matches-computed-xpath', 24],
-    ['hide-if-shadow-contains', 25],
-    ['debug', 26],
-    ['trace', 27],
-    ['race', 28],
-]);
-
-export { AbpSnippetBodyMarshallingMap, FREQUENT_ABP_SNIPPET_ARGS_SERIALIZATION_MAP };

package/dist/marshalling-utils/cosmetic/body/adg-scriptlet-injection-body-common.js

@@ -1,66 +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
- */
-/**
- * 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.
- */
-// TODO: Update this map with the actual values
-const FREQUENT_ADG_SCRIPTLET_ARGS_SERIALIZATION_MAP = new Map([
-    ['abort-current-inline-script', 0],
-    ['abort-on-property-read', 1],
-    ['abort-on-property-write', 2],
-    ['abort-on-stack-trace', 3],
-    ['adjust-setInterval', 4],
-    ['adjust-setTimeout', 5],
-    ['close-window', 6],
-    ['debug-current-inline-script', 7],
-    ['debug-on-property-read', 8],
-    ['debug-on-property-write', 9],
-    ['dir-string', 10],
-    ['disable-newtab-links', 11],
-    ['evaldata-prune', 12],
-    ['json-prune', 13],
-    ['log', 14],
-    ['log-addEventListener', 15],
-    ['log-eval', 16],
-    ['log-on-stack-trace', 17],
-    ['m3u-prune', 18],
-    ['noeval', 19],
-    ['nowebrtc', 20],
-    ['no-topics', 21],
-    ['prevent-addEventListener', 22],
-    ['prevent-adfly', 23],
-    ['prevent-bab', 24],
-    ['prevent-eval-if', 25],
-    ['prevent-fab-3.2.0', 26],
-    ['prevent-fetch', 27],
-    ['prevent-xhr', 28],
-    ['prevent-popads-net', 29],
-    ['prevent-refresh', 30],
-    ['prevent-requestAnimationFrame', 31],
-    ['prevent-setInterval', 32],
-    ['prevent-setTimeout', 33],
-    ['prevent-window-open', 34],
-    ['remove-attr', 35],
-    ['remove-class', 36],
-    ['remove-cookie', 37],
-    ['remove-node-text', 38],
-    ['set-attr', 39],
-    ['set-constant', 40],
-    ['set-cookie', 41],
-    ['set-cookie-reload', 42],
-    ['set-local-storage-item', 43],
-    ['set-popads-dummy', 44],
-    ['set-session-storage-item', 45],
-    ['xml-prune', 46],
-]);
-
-export { FREQUENT_ADG_SCRIPTLET_ARGS_SERIALIZATION_MAP };

package/dist/marshalling-utils/cosmetic/body/css-injection-body-common.js

@@ -1,24 +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
- */
-/**
- * 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.
- */
-const CssInjectionRuleMarshallingMap = {
-    SelectorList: 1,
-    DeclarationList: 2,
-    MediaQueryList: 3,
-    Remove: 4,
-    Start: 5,
-    End: 6,
-};
-
-export { CssInjectionRuleMarshallingMap };

package/dist/marshalling-utils/cosmetic/body/element-hiding-body-common.js

@@ -1,21 +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
- */
-/**
- * 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.
- */
-const ElementHidingRuleMarshallingMap = {
-    SelectorList: 1,
-    Start: 2,
-    End: 3,
-};
-
-export { ElementHidingRuleMarshallingMap };