@adguard/agtree 2.2.0 → 3.0.0-alpha.2

package/dist/generator/cosmetic/cosmetic-rule-pattern-generator.js

@@ -0,0 +1,42 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { CLOSE_SQUARE_BRACKET, EMPTY, OPEN_SQUARE_BRACKET, DOLLAR_SIGN } from '../../utils/constants.js';
+import { AdblockSyntax } from '../../utils/adblockers.js';
+import { BaseGenerator } from '../base-generator.js';
+import { ModifierListGenerator } from '../misc/modifier-list-generator.js';
+import { DomainListGenerator } from '../misc/domain-list-generator.js';
+
+/**
+ * Cosmetic rule pattern generator.
+ */
+class CosmeticRulePatternGenerator extends BaseGenerator {
+    /**
+     * Generates the rule pattern from the AST.
+     *
+     * @param node Cosmetic rule node
+     * @returns Raw rule pattern
+     * @example
+     * - '##.foo' → ''
+     * - 'example.com,example.org##.foo' → 'example.com,example.org'
+     * - '[$path=/foo/bar]example.com##.foo' → '[$path=/foo/bar]example.com'
+     */
+    static generate(node) {
+        let result = EMPTY;
+        // AdGuard modifiers (if any)
+        if (node.syntax === AdblockSyntax.Adg && node.modifiers && node.modifiers.children.length > 0) {
+            result += OPEN_SQUARE_BRACKET;
+            result += DOLLAR_SIGN;
+            result += ModifierListGenerator.generate(node.modifiers);
+            result += CLOSE_SQUARE_BRACKET;
+        }
+        // Domain list (if any)
+        result += DomainListGenerator.generate(node.domains);
+        return result;
+    }
+}
+
+export { CosmeticRulePatternGenerator };

package/dist/generator/css/adg-css-injection-generator.js

@@ -0,0 +1,42 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 GMT)
+ * (c) 2024 Adguard Software Ltd.
+ * Released under the MIT license
+ * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
+ */
+import { COLON, SPACE, SEMICOLON, CSS_MEDIA_MARKER, OPEN_CURLY_BRACKET, CLOSE_CURLY_BRACKET, EMPTY } from '../../utils/constants.js';
+import { BaseGenerator } from '../base-generator.js';
+import { REMOVE_PROPERTY, REMOVE_VALUE } from '../../parser/css/adg-css-injection-parser.js';
+
+/**
+ * AdGuard CSS injection generator.
+ */
+class AdgCssInjectionGenerator extends BaseGenerator {
+    static removeDeclaration = `${REMOVE_PROPERTY}${COLON}${SPACE}${REMOVE_VALUE}${SEMICOLON}`;
+    /**
+     * Serializes an AdGuard CSS injection node into a raw string.
+     *
+     * @param node Node to serialize.
+     * @returns Raw string.
+     */
+    static generate(node) {
+        const result = [];
+        if (node.mediaQueryList) {
+            result.push(CSS_MEDIA_MARKER, SPACE, node.mediaQueryList.value, SPACE, OPEN_CURLY_BRACKET, SPACE);
+        }
+        result.push(node.selectorList.value, SPACE, OPEN_CURLY_BRACKET, SPACE);
+        if (node.remove) {
+            result.push(AdgCssInjectionGenerator.removeDeclaration);
+        }
+        else if (node.declarationList?.value) {
+            result.push(node.declarationList.value);
+        }
+        result.push(SPACE, CLOSE_CURLY_BRACKET);
+        if (node.mediaQueryList) {
+            result.push(SPACE, CLOSE_CURLY_BRACKET);
+        }
+        return result.join(EMPTY);
+    }
+}
+
+export { AdgCssInjectionGenerator };

package/dist/generator/filterlist-generator.js

@@ -0,0 +1,67 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { RuleGenerator } from './rule-generator.js';
+import { BaseGenerator } from './base-generator.js';
+
+/**
+ * Generates a serialized filter list.
+ */
+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`.
+     * @param tolerant If `true`, errors during rule generation will be logged to the console and invalid rules
+     * will be skipped. If `false`, an error will be thrown on the first invalid rule. Default is `true`.
+     * @returns Serialized filter list
+     */
+    static generate(ast, preferRaw = false, tolerant = true) {
+        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 {
+                try {
+                    result += RuleGenerator.generate(rule);
+                }
+                catch (error) {
+                    if (tolerant) {
+                        // eslint-disable-next-line no-console
+                        console.error(`Error when generating: ${error}`);
+                    }
+                    else {
+                        throw new Error(String(error));
+                    }
+                }
+            }
+            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/generator/index.js

@@ -0,0 +1,9 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+export { CosmeticRuleGenerator } from './cosmetic/cosmetic-rule-generator.js';
+export { CosmeticRuleBodyGenerator } from './cosmetic/cosmetic-rule-body-generator.js';

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

@@ -0,0 +1,26 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { ListItemsGenerator } from './list-items-generator.js';
+
+/**
+ * Domain list generator.
+ */
+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/generator/misc/list-items-generator.js

@@ -0,0 +1,39 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+
+/**
+ * Utility class for generating string representations of list items.
+ */
+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/generator/misc/logical-expression-generator.js

@@ -0,0 +1,48 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { OperatorValue } from '../../nodes/index.js';
+import { NodeType } from '../../parser/misc/logical-expression-parser.js';
+
+/**
+ * Generator for logical expression nodes.
+ */
+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/generator/misc/modifier-generator.js

@@ -0,0 +1,34 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { BaseGenerator } from '../base-generator.js';
+
+/**
+ * Generator for modifier nodes.
+ */
+class ModifierGenerator extends BaseGenerator {
+    /**
+     * Converts a modifier AST node to a string.
+     *
+     * @param modifier Modifier AST node to convert
+     * @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/generator/misc/modifier-list-generator.js

@@ -0,0 +1,29 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { MODIFIERS_SEPARATOR } from '../../utils/constants.js';
+import { ModifierGenerator } from './modifier-generator.js';
+
+/**
+ * Generator for modifier list nodes.
+ */
+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/generator/misc/parameter-list-generator.js

@@ -0,0 +1,41 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { BaseGenerator } from '../base-generator.js';
+import { ValueGenerator } from './value-generator.js';
+
+/**
+ * Generator for parameter list nodes.
+ */
+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 = [];
+        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/generator/misc/value-generator.js

@@ -0,0 +1,24 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+
+/**
+ * Generator for value nodes.
+ */
+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/generator/network/host-rule-generator.js

@@ -0,0 +1,39 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { BaseGenerator } from '../base-generator.js';
+
+/**
+ * Generator for host rule nodes.
+ */
+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/generator/network/network-rule-generator.js

@@ -0,0 +1,38 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { BaseGenerator } from '../base-generator.js';
+import { ModifierListGenerator } from '../misc/modifier-list-generator.js';
+
+/**
+ * Generator for network rule nodes.
+ */
+class NetworkRuleGenerator extends BaseGenerator {
+    /**
+     * Generates a string from a network rule AST node.
+     *
+     * @param node Network rule node to generate a string from.
+     * @returns Generated string representation of the network rule.
+     */
+    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/generator/rule-generator.js

@@ -0,0 +1,65 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+import { RuleCategory, NetworkRuleType } from '../nodes/index.js';
+import { EMPTY } from '../utils/constants.js';
+import { CommentRuleGenerator } from './comment/comment-rule-generator.js';
+import { CosmeticRuleGenerator } from './cosmetic/cosmetic-rule-generator.js';
+import { HostRuleGenerator } from './network/host-rule-generator.js';
+import { NetworkRuleGenerator } from './network/network-rule-generator.js';
+
+/**
+ * RuleGenerator is responsible for converting adblock rule ASTs to their string representation.
+ */
+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/index.js

@@ -0,0 +1,70 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.js';
+export { RuleSerializer } from './serializer/rule-serializer.js';
+export { RuleDeserializer } from './deserializer/rule-deserializer.js';
+export { RuleGenerator } from './generator/rule-generator.js';
+export { CommentMarker, CommentRuleType, CosmeticRuleSeparator, CosmeticRuleType, NetworkRuleType, RuleCategory } from './nodes/index.js';
+export { AdblockSyntaxError } from './errors/adblock-syntax-error.js';
+export { AgentCommentParser } from './parser/comment/agent-comment-parser.js';
+export { AgentParser } from './parser/comment/agent-parser.js';
+export { CommentParser } from './parser/comment/comment-parser.js';
+export { ConfigCommentParser } from './parser/comment/config-comment-parser.js';
+export { CosmeticRuleParser } from './parser/cosmetic/cosmetic-rule-parser.js';
+export { AppListParser } from './parser/misc/app-list-parser.js';
+export { DomainListParser } from './parser/misc/domain-list-parser.js';
+export { MethodListParser } from './parser/misc/method-list-parser.js';
+export { StealthOptionListParser } from './parser/misc/stealth-option-list-parser.js';
+export { FilterListParser } from './parser/filterlist-parser.js';
+export { FilterListSerializer } from './serializer/filterlist-serializer.js';
+export { FilterListDeserializer } from './deserializer/filterlist-deserializer.js';
+export { HintCommentParser } from './parser/comment/hint-comment-parser.js';
+export { HintParser } from './parser/comment/hint-parser.js';
+export { LogicalExpressionParser } from './parser/misc/logical-expression-parser.js';
+export { MetadataCommentParser } from './parser/comment/metadata-comment-parser.js';
+export { ModifierListParser } from './parser/misc/modifier-list.js';
+export { ModifierParser } from './parser/misc/modifier-parser.js';
+export { NetworkRuleParser } from './parser/network/network-rule-parser.js';
+export { NotImplementedError } from './errors/not-implemented-error.js';
+export { ParameterListParser } from './parser/misc/parameter-list-parser.js';
+export { HostRuleParser } from './parser/network/host-rule-parser.js';
+export { PreProcessorCommentParser } from './parser/comment/preprocessor-parser.js';
+export { RuleConversionError } from './errors/rule-conversion-error.js';
+export { BinarySchemaMismatchError } from './errors/binary-schema-mismatch-error.js';
+export { modifierValidator } from './validator/index.js';
+export { RawFilterListConverter } from './converter/raw-filter-list.js';
+export { RuleConverter } from './converter/rule.js';
+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.js';
+export { BINARY_SCHEMA_VERSION } from './utils/binary-schema-version.js';
+export { AdblockSyntax } from './utils/adblockers.js';
+export { CosmeticRuleSeparatorUtils } from './utils/cosmetic-rule-separator.js';
+export { DomainUtils } from './utils/domain.js';
+export { LogicalExpressionUtils } from './utils/logical-expression.js';
+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.js';
+export { QuoteType, QuoteUtils } from './utils/quotes.js';
+export { PositionProvider } from './utils/position-provider.js';
+export { OutputByteBuffer } from './utils/output-byte-buffer.js';
+export { InputByteBuffer } from './utils/input-byte-buffer.js';
+export { ByteBuffer } from './utils/byte-buffer.js';
+export { encodeIntoPolyfill } from './utils/text-encoder-polyfill.js';
+export { decodeTextPolyfill } from './utils/text-decoder-polyfill.js';
+export { RuleCategorizer } from './utils/categorizer.js';
+export { EXT_CSS_LEGACY_ATTRIBUTES, EXT_CSS_PSEUDO_CLASSES, FORBIDDEN_CSS_FUNCTIONS } from './converter/data/css.js';
+export { modifiersCompatibilityTable } from './compatibility-tables/modifiers.js';
+export { redirectsCompatibilityTable } from './compatibility-tables/redirects.js';
+export { scriptletsCompatibilityTable } from './compatibility-tables/scriptlets.js';
+export { GenericPlatform, SpecificPlatform } from './compatibility-tables/platforms.js';
+import './compatibility-tables/schemas/base.js';
+import './compatibility-tables/schemas/modifier.js';
+import './compatibility-tables/schemas/redirect.js';
+import './compatibility-tables/schemas/scriptlet.js';
+export { parseRawPlatforms } from './compatibility-tables/schemas/platform.js';
+export { getPlatformId, getSpecificPlatformName, isGenericPlatform } from './compatibility-tables/utils/platform-helpers.js';
+export { ResourceType } from './compatibility-tables/schemas/resource-type.js';
+export { getResourceTypeModifier, isValidResourceType } from './compatibility-tables/utils/resource-type-helpers.js';
+export { AGTREE_VERSION } from './version.js';
+export { getSyntaxSerializationMap } from './marshalling-utils/syntax-serialization-map.js';

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

@@ -0,0 +1,21 @@
+/*
+ * AGTree v3.0.0-alpha.2 (build date: Tue, 17 Dec 2024 16:50:04 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.
+ */
+const AgentCommentMarshallingMap = {
+    Children: 1,
+    Start: 2,
+    End: 3,
+};
+
+export { AgentCommentMarshallingMap };