@adguard/agtree 3.0.0 → 3.0.1

package/dist/cjs/parser/css/ubo-selector-parser.js

@@ -1,373 +0,0 @@
-/*
- * 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
- */
-'use strict';
-
-var cssTokenizer = require('@adguard/css-tokenizer');
-var sprintfJs = require('sprintf-js');
-var adblockSyntaxError = require('../../errors/adblock-syntax-error.js');
-var constants = require('../../utils/constants.js');
-var balancing = require('./balancing.js');
-var options = require('../options.js');
-var baseParser = require('../base-parser.js');
-var uboSelectorCommon = require('../../common/ubo-selector-common.js');
-
-/**
- * @file Parser for special uBO selectors.
- */
-/**
- * Possible error messages for uBO selectors. Formatted with {@link sprintf}.
- */
-const ERROR_MESSAGES = {
-    DUPLICATED_UBO_MODIFIER: "uBO modifier '%s' cannot be used more than once",
-    EXPECTED_BUT_GOT_BEFORE: "Expected '%s' but got '%s' before '%s'",
-    // eslint-disable-next-line max-len
-    NEGATED_UBO_MODIFIER_CANNOT_BE_FOLLOWED_BY: "Negated uBO modifier '%s' cannot be followed by anything else than a closing parenthesis or a whitespace",
-    NEGATED_UBO_MODIFIER_CANNOT_BE_PRECEDED_BY: "Negated uBO modifier '%s' cannot be preceded by '%s'",
-    PSEUDO_CANNOT_BE_NESTED: "uBO modifier '%s' cannot be nested inside '%s', only '%s' is allowed as a wrapper",
-    UBO_MODIFIER_CANNOT_BE_NESTED: "uBO modifier '%s' cannot be nested",
-    UBO_STYLE_CANNOT_BE_FOLLOWED: 'uBO style injection cannot be followed by anything else than a whitespace',
-};
-/**
- * Dummy parameter for uBO modifiers in error messages.
- */
-const DUMMY_PARAM = '...';
-/**
- * Set of known uBO modifiers.
- *
- * @note We use `string` instead of `UboPseudoName` because we use this set for checking if a modifier is a known uBO,
- * and an unknown sequence is just a string.
- */
-const KNOWN_UBO_MODIFIERS = new Set([
-    uboSelectorCommon.UboPseudoName.MatchesMedia,
-    uboSelectorCommon.UboPseudoName.MatchesPath,
-    uboSelectorCommon.UboPseudoName.Remove,
-    uboSelectorCommon.UboPseudoName.Style,
-]);
-/**
- * Helper function to check if the given selector has any uBO modifier. This function should be fast, because it's used
- * in the hot path of the parser.
- *
- * @param raw Raw selector string.
- * @returns `true` if the selector has any uBO modifier, `false` otherwise.
- */
-const hasAnyUboModifier = (raw) => {
-    // Find the first colon
-    let colonIndex = raw.indexOf(constants.COLON);
-    while (colonIndex !== -1) {
-        // Find next opening parenthesis
-        const openingParenthesisIndex = raw.indexOf(constants.OPEN_PARENTHESIS, colonIndex + 1);
-        // If there is no opening parenthesis, then the selector doesn't contain any uBO modifier
-        if (openingParenthesisIndex === -1) {
-            return false;
-        }
-        // Check if the modifier is a known uBO modifier
-        if (KNOWN_UBO_MODIFIERS.has(raw.slice(colonIndex + 1, openingParenthesisIndex))) {
-            return true;
-        }
-        // Find next colon
-        colonIndex = raw.indexOf(constants.COLON, openingParenthesisIndex + 1);
-    }
-    return false;
-};
-/**
- * A simple helper function to format a pseudo name for error messages.
- *
- * @param name Pseudo name.
- * @param wrapper Wrapper pseudo name (eg. `not`) (optional, defaults to `undefined`).
- * @returns Formatted pseudo name.
- * @example
- * ```ts
- * formatPseudoName('matches-path', 'not'); // => ':not(:matches-path(...))'
- * formatPseudoName('matches-media'); // => ':matches-media(...)'
- * ```
- */
-const formatPseudoName = (name, wrapper) => {
-    const result = [];
-    if (wrapper) {
-        result.push(constants.COLON, wrapper, constants.OPEN_PARENTHESIS);
-    }
-    result.push(constants.COLON, name, constants.OPEN_PARENTHESIS, DUMMY_PARAM, constants.CLOSE_PARENTHESIS);
-    if (wrapper) {
-        result.push(constants.CLOSE_PARENTHESIS);
-    }
-    return result.join(constants.EMPTY);
-};
-/**
- * Parser for uBO selectors.
- */
-class UboSelectorParser extends baseParser.BaseParser {
-    /**
-     * Parses a uBO selector list, eg. `div:matches-path(/path)`.
-     *
-     * @param raw Raw input to parse.
-     * @param options Global parser options.
-     * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
-     *
-     * @returns Parsed uBO selector {@link UboSelectorParser}.
-     * @throws An {@link AdblockSyntaxError} if the selector list is syntactically invalid.
-     */
-    static parse(raw, options$1 = options.defaultParserOptions, baseOffset = 0) {
-        // Prepare helper variables
-        const modifiers = {
-            type: 'ModifierList',
-            children: [],
-        };
-        if (options$1.isLocIncluded) {
-            modifiers.start = baseOffset;
-            modifiers.end = baseOffset + raw.length;
-        }
-        // Do not perform any parsing if the selector doesn't contain any uBO modifier
-        // Parsing is a relatively expensive operation, but this check is cheap, so we can avoid unnecessary work
-        // TODO: Move this check to the cosmetic parser (adjustable syntaxes - if uBO syntax is disabled, then we don't
-        // need to check for uBO modifiers)
-        if (!hasAnyUboModifier(raw)) {
-            const selector = {
-                type: 'Value',
-                value: raw,
-            };
-            if (options$1.isLocIncluded) {
-                selector.start = baseOffset;
-                selector.end = baseOffset + raw.length;
-            }
-            const result = {
-                type: 'UboSelector',
-                selector,
-                modifiers,
-            };
-            if (options$1.isLocIncluded) {
-                result.start = baseOffset;
-                result.end = baseOffset + raw.length;
-            }
-            return result;
-        }
-        // Simple way to check if a modifier is already processed to avoid duplicate modifiers
-        const processedModifiers = new Set();
-        // We need to keep track of the tokens for handling negations properly
-        const tokens = [];
-        // This array is used to mark the character slots in the selector string that are occupied by uBO modifiers
-        const uboIndexes = new Array(raw.length);
-        const uboModifierStack = [];
-        let i = 0;
-        // Helper function to stack a uBO modifier
-        const stackModifier = (modifier) => {
-            if (processedModifiers.has(modifier.name)) {
-                throw new adblockSyntaxError.AdblockSyntaxError(sprintfJs.sprintf(ERROR_MESSAGES.DUPLICATED_UBO_MODIFIER, formatPseudoName(modifier.name)), baseOffset + modifier.modifierStart, baseOffset + raw.length);
-            }
-            uboModifierStack.push(modifier);
-        };
-        // Tokenize the selector, calculate the balance
-        balancing.tokenizeFnBalanced(raw, (type, start, end, _, balance) => {
-            // Special case: style injection (`:style(...)` and `:remove()`) can only be used at the end of the
-            // selector, like
-            //  - `div:style(...)`,
-            //  - `div:matches-media(...):style(...)`,
-            //  - `div:remove()`,
-            // etc.
-            //
-            // But not like
-            //  - `:style(...) div`,
-            //  - `:matches-media(...):style(...) div`,
-            //  - `:remove() div`,
-            // etc.
-            //
-            // The one exception is whitespace, which is allowed after style injection, like
-            //  - `div:style(...) `,
-            //  - `div:matches-media(...):style(...) `,
-            //  - `div:remove() `,
-            // etc.
-            if ((processedModifiers.has(uboSelectorCommon.UboPseudoName.Style)
-                || processedModifiers.has(uboSelectorCommon.UboPseudoName.Remove))
-                && type !== cssTokenizer.TokenType.Whitespace) {
-                throw new adblockSyntaxError.AdblockSyntaxError(ERROR_MESSAGES.UBO_STYLE_CANNOT_BE_FOLLOWED, baseOffset + start, baseOffset + raw.length);
-            }
-            // Check for pseudo classes (colon followed by a function)
-            if (tokens[i - 1]?.type === cssTokenizer.TokenType.Colon && type === cssTokenizer.TokenType.Function) {
-                // Since closing parenthesis is always included in the function token, but we only need the function
-                // name, we need to cut off the last character, this is why we use `end - 1` here
-                const fn = raw.slice(start, end - 1);
-                // Check if the pseudo class is a known uBO modifier
-                if (KNOWN_UBO_MODIFIERS.has(fn)) {
-                    // Generally, uBO modifiers cannot be nested, like
-                    //  - `:any(:matches-media(...))`,
-                    //  - `:matches-media(:matches-media(...))`,
-                    //  - `:not(style(...))`,
-                    //  etc.
-                    if (balance > 1) {
-                        // However, we have one exception: `:matches-path()` can be nested inside `:not()`s, like:
-                        //  - `:not(:matches-path(...))`,
-                        //  - `:not(:not(:matches-path(...)))`,
-                        //  etc.
-                        //
-                        // But it can't be nested inside any other pseudo class, like:
-                        //  - `:anything(:matches-path(...))`,
-                        //  etc.
-                        //
-                        // Moreover, :not() can't contain any other data, like
-                        //  - `:not(div:matches-path(...))`,
-                        //  - `:not(:matches-path(...):matches-path(...))`,
-                        //  - `:not(:matches-path(...) div)`,
-                        // etc.
-                        if (fn === uboSelectorCommon.UboPseudoName.MatchesPath) {
-                            if (uboModifierStack.length > 0) {
-                                throw new adblockSyntaxError.AdblockSyntaxError(sprintfJs.sprintf(ERROR_MESSAGES.PSEUDO_CANNOT_BE_NESTED, formatPseudoName(uboSelectorCommon.UboPseudoName.MatchesPath), formatPseudoName(uboModifierStack[uboModifierStack.length - 1].name), formatPseudoName(constants.CSS_NOT_PSEUDO)), baseOffset + start - 1, baseOffset + raw.length);
-                            }
-                            let isException = false;
-                            let modifierBalance = balance;
-                            let modifierStart = start;
-                            for (let j = i - 1; j >= 0; j -= 1) {
-                                // If we have reached the root level, then we should check if the `not` function is
-                                // preceded by a colon (which means that it's a pseudo class)
-                                if (tokens[j].balance === 0) {
-                                    modifierStart = tokens[j].start;
-                                    modifierBalance = tokens[j].balance;
-                                    break;
-                                }
-                                else if (tokens[j].type === cssTokenizer.TokenType.Colon
-                                    || tokens[j].type === cssTokenizer.TokenType.Whitespace) {
-                                    continue;
-                                }
-                                else if (tokens[j].type === cssTokenizer.TokenType.Function) {
-                                    const wrapperFnName = raw.slice(tokens[j].start, tokens[j].end - 1);
-                                    if (wrapperFnName !== constants.CSS_NOT_PSEUDO) {
-                                        throw new adblockSyntaxError.AdblockSyntaxError(sprintfJs.sprintf(ERROR_MESSAGES.PSEUDO_CANNOT_BE_NESTED, formatPseudoName(uboSelectorCommon.UboPseudoName.MatchesPath), formatPseudoName(wrapperFnName), formatPseudoName(constants.CSS_NOT_PSEUDO)), baseOffset + tokens[j].start - 1, baseOffset + raw.length);
-                                    }
-                                    if (tokens[j - 1]?.type !== cssTokenizer.TokenType.Colon) {
-                                        const got = tokens[j - 1]?.type
-                                            ? cssTokenizer.getFormattedTokenName(tokens[j - 1]?.type)
-                                            : 'nothing';
-                                        throw new adblockSyntaxError.AdblockSyntaxError(sprintfJs.sprintf(ERROR_MESSAGES.EXPECTED_BUT_GOT_BEFORE, cssTokenizer.getFormattedTokenName(cssTokenizer.TokenType.Colon), got, formatPseudoName(uboSelectorCommon.UboPseudoName.MatchesPath, constants.CSS_NOT_PSEUDO)), 
-                                        // eslint-disable-next-line no-unsafe-optional-chaining
-                                        baseOffset + tokens[j - 1]?.start || 0, baseOffset + raw.length);
-                                    }
-                                    isException = !isException;
-                                    continue;
-                                }
-                                else {
-                                    throw new adblockSyntaxError.AdblockSyntaxError(sprintfJs.sprintf(ERROR_MESSAGES.NEGATED_UBO_MODIFIER_CANNOT_BE_PRECEDED_BY, formatPseudoName(uboSelectorCommon.UboPseudoName.MatchesPath), cssTokenizer.getFormattedTokenName(tokens[j].type)), baseOffset + tokens[j].start, baseOffset + raw.length);
-                                }
-                            }
-                            stackModifier({
-                                name: fn,
-                                modifierStart,
-                                modifierBalance,
-                                nameStart: start,
-                                nameEnd: end - 1, // ignore opening parenthesis
-                                valueStart: end,
-                                valueBalance: balance,
-                                isException,
-                            });
-                        }
-                        else {
-                            throw new adblockSyntaxError.AdblockSyntaxError(sprintfJs.sprintf(ERROR_MESSAGES.UBO_MODIFIER_CANNOT_BE_NESTED, formatPseudoName(fn)), baseOffset + start - 1, baseOffset + raw.length);
-                        }
-                    }
-                    else {
-                        stackModifier({
-                            name: fn,
-                            modifierStart: start - 1, // Include the colon
-                            modifierBalance: balance,
-                            nameStart: start,
-                            nameEnd: end - 1, // ignore opening parenthesis
-                            valueStart: end,
-                            valueBalance: balance,
-                            isException: false,
-                        });
-                    }
-                }
-            }
-            else {
-                // Get the last stacked modifier
-                const lastStackedModifier = uboModifierStack[uboModifierStack.length - 1];
-                // Do not allow any other token after `:matches-path(...)` inside `:not(...)`
-                if (lastStackedModifier?.name === uboSelectorCommon.UboPseudoName.MatchesPath && lastStackedModifier?.isException) {
-                    if (!(type === cssTokenizer.TokenType.CloseParenthesis || type === cssTokenizer.TokenType.Whitespace)
-                        && balance < lastStackedModifier.valueBalance) {
-                        throw new adblockSyntaxError.AdblockSyntaxError(sprintfJs.sprintf(ERROR_MESSAGES.NEGATED_UBO_MODIFIER_CANNOT_BE_FOLLOWED_BY, formatPseudoName(uboSelectorCommon.UboPseudoName.MatchesPath), cssTokenizer.getFormattedTokenName(type)), baseOffset + start, baseOffset + raw.length);
-                    }
-                }
-                // If we have reached a closing parenthesis, then we should check if it closes the last stacked modifier
-                // and if so, pop it from the stack
-                if (type === cssTokenizer.TokenType.CloseParenthesis && lastStackedModifier) {
-                    if (balance === Math.max(0, lastStackedModifier.valueBalance - 1)) {
-                        lastStackedModifier.valueEnd = start;
-                    }
-                    if (balance === Math.max(0, lastStackedModifier.modifierBalance - 1)) {
-                        const modifierName = {
-                            type: 'Value',
-                            value: lastStackedModifier.name,
-                        };
-                        if (options$1.isLocIncluded) {
-                            // TODO: Refactor
-                            modifierName.start = baseOffset + lastStackedModifier.nameStart;
-                            modifierName.end = baseOffset + lastStackedModifier.nameEnd;
-                        }
-                        const value = {
-                            type: 'Value',
-                            value: raw.slice(lastStackedModifier.valueStart, lastStackedModifier.valueEnd),
-                        };
-                        if (options$1.isLocIncluded) {
-                            value.start = baseOffset + lastStackedModifier.valueStart;
-                            // It's safe to use `!` here, because we determined the value end index in the
-                            // previous `if` statement
-                            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                            value.end = baseOffset + lastStackedModifier.valueEnd;
-                        }
-                        const modifier = {
-                            type: 'Modifier',
-                            name: modifierName,
-                            value,
-                            exception: lastStackedModifier.isException,
-                        };
-                        if (options$1.isLocIncluded) {
-                            modifier.start = baseOffset + lastStackedModifier.modifierStart;
-                            modifier.end = baseOffset + end;
-                        }
-                        modifiers.children.push(modifier);
-                        processedModifiers.add(lastStackedModifier.name);
-                        uboModifierStack.pop();
-                        // Mark the character slots in the selector string that are occupied by uBO modifiers
-                        uboIndexes.fill(true, lastStackedModifier.modifierStart, end);
-                    }
-                }
-            }
-            // Save the token to the history and increase the index
-            tokens.push({
-                type,
-                start,
-                end,
-                balance,
-            });
-            i += 1;
-        });
-        const selector = {
-            type: 'Value',
-            value: raw
-                .split(constants.EMPTY)
-                .map((char, p) => (uboIndexes[p] ? constants.EMPTY : char))
-                .join(constants.EMPTY)
-                .trim(),
-        };
-        if (options$1.isLocIncluded) {
-            selector.start = baseOffset;
-            selector.end = baseOffset + raw.length;
-        }
-        const result = {
-            type: 'UboSelector',
-            selector,
-            modifiers,
-        };
-        if (options$1.isLocIncluded) {
-            result.start = baseOffset;
-            result.end = baseOffset + raw.length;
-        }
-        return result;
-    }
-}
-
-exports.ERROR_MESSAGES = ERROR_MESSAGES;
-exports.UboSelectorParser = UboSelectorParser;
-exports.formatPseudoName = formatPseudoName;

package/dist/cjs/parser/filterlist-parser.js

@@ -1,104 +0,0 @@
-/*
- * 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
- */
-'use strict';
-
-var ruleParser = require('./rule-parser.js');
-var constants = require('../utils/constants.js');
-var string = require('../utils/string.js');
-var options = require('./options.js');
-var baseParser = require('./base-parser.js');
-
-/**
- * `FilterListParser` is responsible for parsing a whole adblock filter list (list of rules).
- * It is a wrapper around `RuleParser` which parses each line separately.
- */
-class FilterListParser extends baseParser.BaseParser {
-    /**
-     * Parses a whole adblock filter list (list of rules).
-     *
-     * @param raw Raw input to parse.
-     * @param options Global parser options.
-     * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
-     * @returns AST of the source code (list of rules)
-     * @example
-     * ```js
-     * import { readFileSync } from 'fs';
-     * import { FilterListParser } from '@adguard/agtree';
-     *
-     * // Read filter list content from file
-     * const content = readFileSync('your-adblock-filter-list.txt', 'utf-8');
-     *
-     * // Parse the filter list content, then do something with the AST
-     * const ast = FilterListParser.parse(content);
-     * ```
-     * @throws If one of the rules is syntactically invalid (if `tolerant` is `false`)
-     */
-    static parse(raw, options$1 = options.defaultParserOptions, baseOffset = 0) {
-        // Actual position in the source code
-        let offset = 0;
-        // Collect adblock rules here
-        const rules = [];
-        // Start offset of the current line (initially it's 0)
-        let lineStartOffset = offset;
-        while (offset < raw.length) {
-            // Check if we found a new line
-            if (string.StringUtils.isEOL(raw[offset])) {
-                // Rule text
-                const text = raw.slice(lineStartOffset, offset);
-                // Parse the rule
-                const rule = ruleParser.RuleParser.parse(text, options$1, lineStartOffset);
-                // Get newline type (possible values: 'crlf', 'lf', 'cr' or undefined if no newline found)
-                let nl;
-                if (raw[offset] === constants.CR) {
-                    if (raw[offset + 1] === constants.LF) {
-                        nl = 'crlf';
-                    }
-                    else {
-                        nl = 'cr';
-                    }
-                }
-                else if (raw[offset] === constants.LF) {
-                    nl = 'lf';
-                }
-                // Add newline type to the rule (rule parser already added raws.text)
-                if (!rule.raws) {
-                    rule.raws = {
-                        text,
-                        nl,
-                    };
-                }
-                else {
-                    rule.raws.nl = nl;
-                }
-                // Add the rule to the list
-                rules.push(rule);
-                // Update offset: add 2 if we found CRLF, otherwise add 1
-                offset += nl === 'crlf' ? 2 : 1;
-                // Update line start offset
-                lineStartOffset = offset;
-            }
-            else {
-                // No new line found, just increase offset
-                offset += 1;
-            }
-        }
-        // Parse the last rule (it doesn't end with a new line)
-        rules.push(ruleParser.RuleParser.parse(raw.slice(lineStartOffset, offset), options$1, baseOffset + lineStartOffset));
-        // Return the list of rules (FilterList node)
-        const result = {
-            type: 'FilterList',
-            children: rules,
-        };
-        if (options$1.isLocIncluded) {
-            result.start = baseOffset;
-            result.end = baseOffset + raw.length;
-        }
-        return result;
-    }
-}
-
-exports.FilterListParser = FilterListParser;

package/dist/cjs/parser/index.js

@@ -1,21 +0,0 @@
-/*
- * 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
- */
-'use strict';
-
-var ruleParser = require('./rule-parser.js');
-var options = require('./options.js');
-var cosmeticRuleParser = require('./cosmetic/cosmetic-rule-parser.js');
-var domainListParser = require('./misc/domain-list-parser.js');
-var networkRuleParser = require('./network/network-rule-parser.js');
-
-
-
-exports.RuleParser = ruleParser.RuleParser;
-exports.defaultParserOptions = options.defaultParserOptions;
-exports.CosmeticRuleParser = cosmeticRuleParser.CosmeticRuleParser;
-exports.DomainListParser = domainListParser.DomainListParser;
-exports.NetworkRuleParser = networkRuleParser.NetworkRuleParser;

package/dist/cjs/parser/misc/app-list-parser.js

@@ -1,47 +0,0 @@
-/*
- * 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
- */
-'use strict';
-
-var constants = require('../../utils/constants.js');
-var index = require('../../nodes/index.js');
-var options = require('../options.js');
-var baseParser = require('../base-parser.js');
-var listItemsParser = require('./list-items-parser.js');
-
-/**
- * `AppListParser` is responsible for parsing an app list.
- *
- * @see {@link https://adguard.app/kb/general/ad-filtering/create-own-filters/#app-modifier}
- */
-class AppListParser extends baseParser.BaseParser {
-    /**
-     * Parses an app list which items are separated by `|`,
-     * e.g. `Example.exe|com.example.osx`.
-     *
-     * @param raw Raw input to parse.
-     * @param options Global parser options.
-     * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
-     *
-     * @returns App list AST.
-     * @throws An {@link AdblockSyntaxError} if the app list is syntactically invalid.
-     * @throws An {@link Error} if the options are invalid.
-     */
-    static parse(raw, options$1 = options.defaultParserOptions, baseOffset = 0) {
-        const result = {
-            type: index.ListNodeType.AppList,
-            separator: constants.PIPE,
-            children: listItemsParser.ListItemsParser.parse(raw, options$1, baseOffset, constants.PIPE, index.ListItemNodeType.App),
-        };
-        if (options$1.isLocIncluded) {
-            result.start = baseOffset;
-            result.end = baseOffset + raw.length;
-        }
-        return result;
-    }
-}
-
-exports.AppListParser = AppListParser;

package/dist/cjs/parser/misc/domain-list-parser.js

@@ -1,54 +0,0 @@
-/*
- * 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
- */
-'use strict';
-
-var constants = require('../../utils/constants.js');
-var index = require('../../nodes/index.js');
-var options = require('../options.js');
-var baseParser = require('../base-parser.js');
-var listItemsParser = require('./list-items-parser.js');
-
-/**
- * `DomainListParser` is responsible for parsing 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 parser is responsible for parsing these domain lists.
- * @see {@link https://help.eyeo.com/adblockplus/how-to-write-filters#elemhide_domains}
- */
-class DomainListParser extends baseParser.BaseParser {
-    /**
-     * Parses a domain list, eg. `example.com,example.org,~example.org`
-     *
-     * @param raw Raw input to parse.
-     * @param options Global parser options.
-     * @param baseOffset Starting offset of the input. Node locations are calculated relative to this offset.
-     * @param separator Separator character (default: comma)
-     *
-     * @returns Domain list AST.
-     * @throws An {@link AdblockSyntaxError} if the domain list is syntactically invalid.
-     * @throws An {@link Error} if the options are invalid.
-     */
-    static parse(raw, options$1 = options.defaultParserOptions, baseOffset = 0, separator = constants.COMMA) {
-        if (separator !== constants.COMMA && separator !== constants.PIPE) {
-            throw new Error(`Invalid separator: ${separator}`);
-        }
-        const result = {
-            type: index.ListNodeType.DomainList,
-            separator,
-            children: listItemsParser.ListItemsParser.parse(raw, options$1, baseOffset, separator, index.ListItemNodeType.Domain),
-        };
-        if (options$1.isLocIncluded) {
-            result.start = baseOffset;
-            result.end = baseOffset + raw.length;
-        }
-        return result;
-    }
-}
-
-exports.DomainListParser = DomainListParser;