@adguard/agtree 2.1.3 → 3.0.0

package/dist/esm/serializer/network/hostname-list-serializer.mjs

@@ -0,0 +1,47 @@
+/*
+ * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { BaseSerializer } from '../base-serializer.mjs';
+import { isUndefined } from '../../utils/type-guards.mjs';
+import { UINT16_MAX, NULL } from '../../utils/constants.mjs';
+import { ValueSerializer } from '../misc/value-serializer.mjs';
+import { HostnameListNodeMarshallingMap } from '../../marshalling-utils/misc/hostname-list-common.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+
+class HostnameListSerializer extends BaseSerializer {
+    /**
+     * Serializes a hostname list node to binary format.
+     *
+     * @param node Node to serialize.
+     * @param buffer ByteBuffer for writing binary data.
+     */
+    static serialize(node, buffer) {
+        buffer.writeUint8(BinaryTypeMarshallingMap.HostnameListNode);
+        if (!isUndefined(node.start)) {
+            buffer.writeUint8(HostnameListNodeMarshallingMap.Start);
+            buffer.writeUint32(node.start);
+        }
+        if (!isUndefined(node.end)) {
+            buffer.writeUint8(HostnameListNodeMarshallingMap.End);
+            buffer.writeUint32(node.end);
+        }
+        const count = node.children.length;
+        if (count) {
+            // note: we store the count, because re-construction of the array is faster if we know the length
+            if (count > UINT16_MAX) {
+                throw new Error(`Too many children: ${count}, the limit is ${UINT16_MAX}`);
+            }
+            buffer.writeUint8(HostnameListNodeMarshallingMap.Children);
+            buffer.writeUint16(count);
+            for (let i = 0; i < count; i += 1) {
+                ValueSerializer.serialize(node.children[i], buffer);
+            }
+        }
+        buffer.writeUint8(NULL);
+    }
+}
+
+export { HostnameListSerializer };

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

@@ -0,0 +1,54 @@
+/*
+ * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
+ * (c) 2024 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 { ModifierListSerializer } from '../misc/modifier-list-serializer.mjs';
+import { NetworkRuleMarshallingMap } from '../../marshalling-utils/network/network-rule-common.mjs';
+import { BinaryTypeMarshallingMap } from '../../marshalling-utils/misc/binary-type-common.mjs';
+import { getSyntaxSerializationMap } from '../../marshalling-utils/syntax-serialization-map.mjs';
+
+/**
+ * `NetworkRuleSerializer` is responsible for serializing network rules.
+ *
+ * @see {@link https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#basic-rules}
+ * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#basic}
+ */
+class NetworkRuleSerializer extends BaseSerializer {
+    /**
+     * Serializes a network 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) {
+        buffer.writeUint8(BinaryTypeMarshallingMap.NetworkRuleNode);
+        buffer.writeUint8(NetworkRuleMarshallingMap.Syntax);
+        buffer.writeUint8(getSyntaxSerializationMap().get(node.syntax) ?? 0);
+        buffer.writeUint8(NetworkRuleMarshallingMap.Exception);
+        buffer.writeUint8(node.exception ? 1 : 0);
+        buffer.writeUint8(NetworkRuleMarshallingMap.Pattern);
+        ValueSerializer.serialize(node.pattern, buffer);
+        if (!isUndefined(node.modifiers)) {
+            buffer.writeUint8(NetworkRuleMarshallingMap.ModifierList);
+            ModifierListSerializer.serialize(node.modifiers, buffer);
+        }
+        if (!isUndefined(node.start)) {
+            buffer.writeUint8(NetworkRuleMarshallingMap.Start);
+            buffer.writeUint32(node.start);
+        }
+        if (!isUndefined(node.end)) {
+            buffer.writeUint8(NetworkRuleMarshallingMap.End);
+            buffer.writeUint32(node.end);
+        }
+        buffer.writeUint8(NULL);
+    }
+}
+
+export { NetworkRuleSerializer };

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

@@ -0,0 +1,61 @@
+/*
+ * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { RuleCategory, NetworkRuleType } from '../nodes/index.mjs';
+import { BaseSerializer } from './base-serializer.mjs';
+import { CommentRuleSerializer } from './comment/comment-rule-serializer.mjs';
+import { CosmeticRuleSerializer } from './cosmetic/cosmetic-rule-serializer.mjs';
+import { HostRuleSerializer } from './network/host-rule-serializer.mjs';
+import { NetworkRuleSerializer } from './network/network-rule-serializer.mjs';
+import { EmptyRuleSerializer } from './empty-rule-serializer.mjs';
+import { InvalidRuleSerializer } from './invalid-rule-serializer.mjs';
+
+/**
+ * `RuleSerializer` is responsible for serializing the rules.
+ *
+ * It automatically determines the category and syntax of the rule, so you can pass any kind of rule to it.
+ */
+class RuleSerializer extends BaseSerializer {
+    /**
+     * Serializes a 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) {
+        switch (node.category) {
+            case RuleCategory.Comment:
+                CommentRuleSerializer.serialize(node, buffer);
+                break;
+            case RuleCategory.Cosmetic:
+                CosmeticRuleSerializer.serialize(node, buffer);
+                break;
+            case RuleCategory.Network:
+                switch (node.type) {
+                    case NetworkRuleType.HostRule:
+                        HostRuleSerializer.serialize(node, buffer);
+                        break;
+                    case NetworkRuleType.NetworkRule:
+                        NetworkRuleSerializer.serialize(node, buffer);
+                        break;
+                    default:
+                        throw new Error('Unknown network rule type');
+                }
+                break;
+            case RuleCategory.Empty:
+                EmptyRuleSerializer.serialize(node, buffer);
+                break;
+            case RuleCategory.Invalid:
+                InvalidRuleSerializer.serialize(node, buffer);
+                break;
+            default:
+                throw new Error('Unknown rule category');
+        }
+    }
+}
+
+export { RuleSerializer };

package/dist/esm/utils/adblockers.mjs

@@ -0,0 +1,57 @@
+/*
+ * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+/**
+ * @file Possible adblock syntaxes are listed here.
+ */
+/**
+ * Possible adblock syntaxes (supported by this library)
+ */
+var AdblockSyntax;
+(function (AdblockSyntax) {
+    /**
+     * Common syntax, which is supported by more than one adblocker (or by all adblockers).
+     *
+     * We typically use this syntax when we cannot determine the concrete syntax of the rule,
+     * because the syntax is used by more than one adblocker natively.
+     *
+     * @example
+     * - `||example.org^$important` is a common syntax, since it is used by all adblockers natively, and
+     * we cannot determine at parsing level whether `important` is a valid option or not, and if it is valid,
+     * then which adblocker supports it.
+     */
+    AdblockSyntax["Common"] = "Common";
+    /**
+     * Adblock Plus syntax.
+     *
+     * @example
+     * - `example.org#$#abort-on-property-read alert` is an Adblock Plus syntax, since it is not used by any other
+     * adblockers directly (probably supported by some on-the-fly conversion, but this is not the native syntax).
+     * @see {@link https://adblockplus.org/}
+     */
+    AdblockSyntax["Abp"] = "AdblockPlus";
+    /**
+     * uBlock Origin syntax.
+     *
+     * @example
+     * - `example.com##+js(set, atob, noopFunc)` is an uBlock Origin syntax, since it is not used by any other
+     * adblockers directly (probably supported by some on-the-fly conversion, but this is not the native syntax).
+     * @see {@link https://github.com/gorhill/uBlock}
+     */
+    AdblockSyntax["Ubo"] = "UblockOrigin";
+    /**
+     * AdGuard syntax.
+     *
+     * @example
+     * - `example.org#%#//scriptlet("abort-on-property-read", "alert")` is an AdGuard syntax, since it is not used
+     * by any other adblockers directly (probably supported by some on-the-fly conversion, but this is not the native
+     * syntax).
+     * @see {@link https://adguard.com/}
+     */
+    AdblockSyntax["Adg"] = "AdGuard";
+})(AdblockSyntax || (AdblockSyntax = {}));
+
+export { AdblockSyntax };

package/dist/esm/utils/binary-schema-version.mjs

@@ -0,0 +1,17 @@
+/*
+ * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+/**
+ * @file Binary schema version.
+ */
+/**
+ * Binary schema version.
+ * This version number is used to ensure that the binary format is compatible with the current library version.
+ * We increment this number if the serialized format changes in a way that is not backwards-compatible.
+ */
+const BINARY_SCHEMA_VERSION = 1;
+
+export { BINARY_SCHEMA_VERSION };

package/dist/esm/utils/byte-buffer.mjs

@@ -0,0 +1,91 @@
+/*
+ * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+/* eslint-disable no-bitwise */
+/**
+ * @file Core ByteBuffer implementation for handling binary data in chunks.
+ */
+/**
+ * Core ByteBuffer implementation for handling binary data in chunks.
+ * This class allows for efficient byte storage and manipulation by organizing data into chunks
+ * and providing methods to read and write bytes.
+ */
+class ByteBuffer {
+    /**
+     * The size of each chunk in bytes (32 KB).
+     */
+    // ! IMPORTANT: If you ever change this value, make sure to update optimized bitwise operations in the code.
+    static CHUNK_SIZE = 32768; // 32 * 1024
+    /**
+     * An array of Uint8Array chunks that make up the buffer.
+     */
+    chunks;
+    /**
+     * The total number of chunks in the buffer.
+     */
+    chunksLength;
+    /**
+     * Constructs a new ByteBuffer instance.
+     *
+     * @param chunks Optional array of chunks to initialize the ByteBuffer with.
+     * @param cloneChunks Flag indicating if the chunks should be cloned. For performance reasons,
+     * its default value is `false`. If the original chunks are guaranteed not to change,
+     * leave this flag as `false` to avoid unnecessary copying.
+     */
+    constructor(chunks, cloneChunks = false) {
+        const chunksToUse = chunks ?? [];
+        this.chunks = cloneChunks ? chunksToUse.map((chunk) => new Uint8Array(chunk)) : chunksToUse;
+        this.chunksLength = chunks?.length ?? 0;
+    }
+    /**
+     * Ensures that the buffer has enough capacity to accommodate a given position.
+     * This method adjusts the `chunks` array size to ensure it can hold the specified position.
+     *
+     * @param position The position to ensure capacity for.
+     */
+    ensureCapacity(position) {
+        // same as Math.floor(position / chunk size), just optimized for the 32 KB chunk size
+        const requiredChunkIndex = position >>> 0x000F;
+        for (let i = this.chunksLength; i <= requiredChunkIndex; i += 1) {
+            this.chunks.push(new Uint8Array(ByteBuffer.CHUNK_SIZE));
+            this.chunksLength += 1;
+        }
+    }
+    /**
+     * Writes a byte to the buffer at the specified position.
+     * If the position is outside of the buffer's current size, the buffer is resized to accommodate it.
+     *
+     * @param position The position at which to write the byte.
+     * @param value The byte value to write (0-255).
+     */
+    writeByte(position, value) {
+        // same as Math.floor(position / chunk size), just optimized for the 32 KB chunk size
+        const chunkIndex = position >>> 0x000F;
+        // same as position % chunk size, just optimized for the 32 KB chunk size
+        const chunkOffset = position & 0x7FFF;
+        if (chunkIndex >= this.chunksLength) {
+            this.ensureCapacity(position);
+        }
+        this.chunks[chunkIndex][chunkOffset] = value;
+    }
+    /**
+     * Reads a byte from the specified position in the buffer.
+     * Returns `undefined` if the position is outside of the buffer's current size.
+     *
+     * @param position The position from which to read the byte.
+     * @returns The read byte value, or `undefined` if the position is out of bounds.
+     */
+    readByte(position) {
+        const chunkIndex = position >>> 0x000F;
+        const chunkOffset = position & 0x7FFF;
+        if (chunkIndex >= this.chunksLength) {
+            return undefined;
+        }
+        return this.chunks[chunkIndex][chunkOffset];
+    }
+}
+
+export { ByteBuffer };

package/dist/esm/utils/categorizer.mjs

@@ -0,0 +1,44 @@
+/*
+ * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { CosmeticRuleParser } from '../parser/cosmetic/cosmetic-rule-parser.mjs';
+import { isNull } from './type-guards.mjs';
+import { defaultParserOptions } from '../parser/options.mjs';
+
+/**
+ * Utility functions for categorizing rules.
+ */
+// TODO: Optimize functions to avoid produce unnecessary data (currently, most of node data is not used).
+// TODO: Add support for other rule categories, like network rules (when needed).
+class RuleCategorizer {
+    /**
+     * Determines the type of a given raw cosmetic rule.
+     *
+     * @param rawRule Raw rule to check.
+     *
+     * @returns Type of the cosmetic rule or `null` if the rule is cannot be parsed as a cosmetic rule.
+     */
+    static getCosmeticRuleType(rawRule) {
+        try {
+            const node = CosmeticRuleParser.parse(rawRule, {
+                ...defaultParserOptions,
+                isLocIncluded: false,
+                includeRaws: false,
+            });
+            // If rule cannot be recognized as a cosmetic rule, return null.
+            if (isNull(node)) {
+                return null;
+            }
+            return node.type;
+        }
+        catch {
+            // Be tolerant to parsing errors and simply return null.
+            return null;
+        }
+    }
+}
+
+export { RuleCategorizer };

package/dist/esm/utils/clone.mjs

@@ -0,0 +1,28 @@
+/*
+ * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import cloneDeep from 'clone-deep';
+
+/**
+ * @file Clone related utilities
+ *
+ * We should keep clone related functions in this file. Thus, we just provide
+ * a simple interface for cloning values, we use it across the AGTree project,
+ * and the implementation "under the hood" can be improved later, if needed.
+ */
+/**
+ * Clones an input value to avoid side effects. Use it only in justified cases,
+ * because it can impact performance negatively.
+ *
+ * @param value Value to clone
+ * @returns Cloned value
+ */
+function clone(value) {
+    // TODO: Replace cloneDeep with a more efficient implementation
+    return cloneDeep(value);
+}
+
+export { clone };

package/dist/esm/utils/constants.mjs

@@ -0,0 +1,249 @@
+/*
+ * AGTree v3.0.0 (build date: Tue, 12 Nov 2024 14:05:06 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+/**
+ * @file Constant values used by all parts of the library
+ */
+// TODO: remove unused constants
+// General
+/**
+ * Empty string.
+ */
+const EMPTY = '';
+const SPACE = ' ';
+const TAB = '\t';
+const COLON = ':';
+const COMMA = ',';
+const DOT = '.';
+const SEMICOLON = ';';
+const AMPERSAND = '&';
+const ASTERISK = '*';
+const AT_SIGN = '@';
+const CARET = '^';
+const DOLLAR_SIGN = '$';
+const EQUALS = '=';
+const EXCLAMATION_MARK = '!';
+const HASHMARK = '#';
+const PIPE = '|';
+const PLUS = '+';
+const QUESTION_MARK = '?';
+const SLASH = '/';
+const UNDERSCORE = '_';
+// Escape characters
+const BACKSLASH = '\\';
+const ESCAPE_CHARACTER = BACKSLASH;
+// Newlines
+const CR = '\r';
+const FF = '\f';
+const LF = '\n';
+const CRLF = CR + LF;
+const NEWLINE = LF;
+// Quotes
+const BACKTICK_QUOTE = '`';
+const DOUBLE_QUOTE = '"';
+const SINGLE_QUOTE = '\'';
+// Brackets
+const OPEN_PARENTHESIS = '(';
+const CLOSE_PARENTHESIS = ')';
+const OPEN_SQUARE_BRACKET = '[';
+const CLOSE_SQUARE_BRACKET = ']';
+const OPEN_CURLY_BRACKET = '{';
+const CLOSE_CURLY_BRACKET = '}';
+// Letters
+const SMALL_LETTER_A = 'a';
+const SMALL_LETTER_B = 'b';
+const SMALL_LETTER_C = 'c';
+const SMALL_LETTER_D = 'd';
+const SMALL_LETTER_E = 'e';
+const SMALL_LETTER_F = 'f';
+const SMALL_LETTER_G = 'g';
+const SMALL_LETTER_H = 'h';
+const SMALL_LETTER_I = 'i';
+const SMALL_LETTER_J = 'j';
+const SMALL_LETTER_K = 'k';
+const SMALL_LETTER_L = 'l';
+const SMALL_LETTER_M = 'm';
+const SMALL_LETTER_N = 'n';
+const SMALL_LETTER_O = 'o';
+const SMALL_LETTER_P = 'p';
+const SMALL_LETTER_Q = 'q';
+const SMALL_LETTER_R = 'r';
+const SMALL_LETTER_S = 's';
+const SMALL_LETTER_T = 't';
+const SMALL_LETTER_U = 'u';
+const SMALL_LETTER_V = 'v';
+const SMALL_LETTER_W = 'w';
+const SMALL_LETTER_X = 'x';
+const SMALL_LETTER_Y = 'y';
+const SMALL_LETTER_Z = 'z';
+/**
+ * Set of all small letters.
+ */
+const SMALL_LETTERS = new Set([
+    SMALL_LETTER_A,
+    SMALL_LETTER_B,
+    SMALL_LETTER_C,
+    SMALL_LETTER_D,
+    SMALL_LETTER_E,
+    SMALL_LETTER_F,
+    SMALL_LETTER_G,
+    SMALL_LETTER_H,
+    SMALL_LETTER_I,
+    SMALL_LETTER_J,
+    SMALL_LETTER_K,
+    SMALL_LETTER_L,
+    SMALL_LETTER_M,
+    SMALL_LETTER_N,
+    SMALL_LETTER_O,
+    SMALL_LETTER_P,
+    SMALL_LETTER_Q,
+    SMALL_LETTER_R,
+    SMALL_LETTER_S,
+    SMALL_LETTER_T,
+    SMALL_LETTER_U,
+    SMALL_LETTER_V,
+    SMALL_LETTER_W,
+    SMALL_LETTER_X,
+    SMALL_LETTER_Y,
+    SMALL_LETTER_Z,
+]);
+// Capital letters
+const CAPITAL_LETTER_A = 'A';
+const CAPITAL_LETTER_B = 'B';
+const CAPITAL_LETTER_C = 'C';
+const CAPITAL_LETTER_D = 'D';
+const CAPITAL_LETTER_E = 'E';
+const CAPITAL_LETTER_F = 'F';
+const CAPITAL_LETTER_G = 'G';
+const CAPITAL_LETTER_H = 'H';
+const CAPITAL_LETTER_I = 'I';
+const CAPITAL_LETTER_J = 'J';
+const CAPITAL_LETTER_K = 'K';
+const CAPITAL_LETTER_L = 'L';
+const CAPITAL_LETTER_M = 'M';
+const CAPITAL_LETTER_N = 'N';
+const CAPITAL_LETTER_O = 'O';
+const CAPITAL_LETTER_P = 'P';
+const CAPITAL_LETTER_Q = 'Q';
+const CAPITAL_LETTER_R = 'R';
+const CAPITAL_LETTER_S = 'S';
+const CAPITAL_LETTER_T = 'T';
+const CAPITAL_LETTER_U = 'U';
+const CAPITAL_LETTER_V = 'V';
+const CAPITAL_LETTER_W = 'W';
+const CAPITAL_LETTER_X = 'X';
+const CAPITAL_LETTER_Y = 'Y';
+const CAPITAL_LETTER_Z = 'Z';
+/**
+ * Set of all capital letters.
+ */
+const CAPITAL_LETTERS = new Set([
+    CAPITAL_LETTER_A,
+    CAPITAL_LETTER_B,
+    CAPITAL_LETTER_C,
+    CAPITAL_LETTER_D,
+    CAPITAL_LETTER_E,
+    CAPITAL_LETTER_F,
+    CAPITAL_LETTER_G,
+    CAPITAL_LETTER_H,
+    CAPITAL_LETTER_I,
+    CAPITAL_LETTER_J,
+    CAPITAL_LETTER_K,
+    CAPITAL_LETTER_L,
+    CAPITAL_LETTER_M,
+    CAPITAL_LETTER_N,
+    CAPITAL_LETTER_O,
+    CAPITAL_LETTER_P,
+    CAPITAL_LETTER_Q,
+    CAPITAL_LETTER_R,
+    CAPITAL_LETTER_S,
+    CAPITAL_LETTER_T,
+    CAPITAL_LETTER_U,
+    CAPITAL_LETTER_V,
+    CAPITAL_LETTER_W,
+    CAPITAL_LETTER_X,
+    CAPITAL_LETTER_Y,
+    CAPITAL_LETTER_Z,
+]);
+// Numbers as strings
+const NUMBER_0 = '0';
+const NUMBER_1 = '1';
+const NUMBER_2 = '2';
+const NUMBER_3 = '3';
+const NUMBER_4 = '4';
+const NUMBER_5 = '5';
+const NUMBER_6 = '6';
+const NUMBER_7 = '7';
+const NUMBER_8 = '8';
+const NUMBER_9 = '9';
+/**
+ * Set of all numbers as strings.
+ */
+const NUMBERS = new Set([
+    NUMBER_0,
+    NUMBER_1,
+    NUMBER_2,
+    NUMBER_3,
+    NUMBER_4,
+    NUMBER_5,
+    NUMBER_6,
+    NUMBER_7,
+    NUMBER_8,
+    NUMBER_9,
+]);
+const REGEX_MARKER = '/';
+const ADG_SCRIPTLET_MASK = '//scriptlet';
+const UBO_SCRIPTLET_MASK = '+js';
+const UBO_SCRIPTLET_MASK_LEGACY = 'script:inject';
+const UBO_HTML_MASK = '^';
+// Modifiers are separated by ",". For example: "script,domain=example.com"
+const MODIFIERS_SEPARATOR = ',';
+const MODIFIER_ASSIGN_OPERATOR = '=';
+const NEGATION_MARKER = '~';
+/**
+ * The wildcard symbol — `*`.
+ */
+const WILDCARD = ASTERISK;
+/**
+ * Classic domain separator.
+ *
+ * @example
+ * ```adblock
+ * ! Domains are separated by ",":
+ * example.com,~example.org##.ads
+ * ```
+ */
+const COMMA_DOMAIN_LIST_SEPARATOR = ',';
+/**
+ * Modifier separator for $app, $denyallow, $domain, $method.
+ *
+ * @example
+ * ```adblock
+ * ! Domains are separated by "|":
+ * ads.js^$script,domains=example.com|~example.org
+ * ```
+ */
+const PIPE_MODIFIER_SEPARATOR = '|';
+const CSS_MEDIA_MARKER = '@media';
+const CSS_NOT_PSEUDO = 'not';
+const HINT_MARKER = '!+';
+const HINT_MARKER_LEN = HINT_MARKER.length;
+const NETWORK_RULE_EXCEPTION_MARKER = '@@';
+const NETWORK_RULE_EXCEPTION_MARKER_LEN = NETWORK_RULE_EXCEPTION_MARKER.length;
+const NETWORK_RULE_SEPARATOR = '$';
+const AGLINT_COMMAND_PREFIX = 'aglint';
+const AGLINT_CONFIG_COMMENT_MARKER = '--';
+const PREPROCESSOR_MARKER = '!#';
+const PREPROCESSOR_MARKER_LEN = PREPROCESSOR_MARKER.length;
+const PREPROCESSOR_SEPARATOR = ' ';
+const SAFARI_CB_AFFINITY = 'safari_cb_affinity';
+const IF = 'if';
+const INCLUDE = 'include';
+const NULL = 0;
+const UINT8_MAX = 255;
+const UINT16_MAX = 65535;
+
+export { ADG_SCRIPTLET_MASK, AGLINT_COMMAND_PREFIX, AGLINT_CONFIG_COMMENT_MARKER, AMPERSAND, ASTERISK, AT_SIGN, BACKSLASH, BACKTICK_QUOTE, CAPITAL_LETTERS, CAPITAL_LETTER_A, CAPITAL_LETTER_B, CAPITAL_LETTER_C, CAPITAL_LETTER_D, CAPITAL_LETTER_E, CAPITAL_LETTER_F, CAPITAL_LETTER_G, CAPITAL_LETTER_H, CAPITAL_LETTER_I, CAPITAL_LETTER_J, CAPITAL_LETTER_K, CAPITAL_LETTER_L, CAPITAL_LETTER_M, CAPITAL_LETTER_N, CAPITAL_LETTER_O, CAPITAL_LETTER_P, CAPITAL_LETTER_Q, CAPITAL_LETTER_R, CAPITAL_LETTER_S, CAPITAL_LETTER_T, CAPITAL_LETTER_U, CAPITAL_LETTER_V, CAPITAL_LETTER_W, CAPITAL_LETTER_X, CAPITAL_LETTER_Y, CAPITAL_LETTER_Z, CARET, CLOSE_CURLY_BRACKET, CLOSE_PARENTHESIS, CLOSE_SQUARE_BRACKET, COLON, COMMA, COMMA_DOMAIN_LIST_SEPARATOR, CR, CRLF, CSS_MEDIA_MARKER, CSS_NOT_PSEUDO, DOLLAR_SIGN, DOT, DOUBLE_QUOTE, EMPTY, EQUALS, ESCAPE_CHARACTER, EXCLAMATION_MARK, FF, HASHMARK, HINT_MARKER, HINT_MARKER_LEN, IF, INCLUDE, LF, MODIFIERS_SEPARATOR, MODIFIER_ASSIGN_OPERATOR, NEGATION_MARKER, NETWORK_RULE_EXCEPTION_MARKER, NETWORK_RULE_EXCEPTION_MARKER_LEN, NETWORK_RULE_SEPARATOR, NEWLINE, NULL, NUMBERS, NUMBER_0, NUMBER_1, NUMBER_2, NUMBER_3, NUMBER_4, NUMBER_5, NUMBER_6, NUMBER_7, NUMBER_8, NUMBER_9, OPEN_CURLY_BRACKET, OPEN_PARENTHESIS, OPEN_SQUARE_BRACKET, PIPE, PIPE_MODIFIER_SEPARATOR, PLUS, PREPROCESSOR_MARKER, PREPROCESSOR_MARKER_LEN, PREPROCESSOR_SEPARATOR, QUESTION_MARK, REGEX_MARKER, SAFARI_CB_AFFINITY, SEMICOLON, SINGLE_QUOTE, SLASH, SMALL_LETTERS, SMALL_LETTER_A, SMALL_LETTER_B, SMALL_LETTER_C, SMALL_LETTER_D, SMALL_LETTER_E, SMALL_LETTER_F, SMALL_LETTER_G, SMALL_LETTER_H, SMALL_LETTER_I, SMALL_LETTER_J, SMALL_LETTER_K, SMALL_LETTER_L, SMALL_LETTER_M, SMALL_LETTER_N, SMALL_LETTER_O, SMALL_LETTER_P, SMALL_LETTER_Q, SMALL_LETTER_R, SMALL_LETTER_S, SMALL_LETTER_T, SMALL_LETTER_U, SMALL_LETTER_V, SMALL_LETTER_W, SMALL_LETTER_X, SMALL_LETTER_Y, SMALL_LETTER_Z, SPACE, TAB, UBO_HTML_MASK, UBO_SCRIPTLET_MASK, UBO_SCRIPTLET_MASK_LEGACY, UINT16_MAX, UINT8_MAX, UNDERSCORE, WILDCARD };