@adguard/agtree 3.0.0-alpha.1 → 3.0.0-alpha.2

package/dist/cjs/ast-utils/scriptlets.js

@@ -1,93 +0,0 @@
-/*
- * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 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 quotes = require('../utils/quotes.js');
-var typeGuards = require('../utils/type-guards.js');
-
-/**
- * @file Utility functions for working with scriptlet nodes
- */
-/**
- * Get name of the scriptlet from the scriptlet node
- *
- * @param scriptletNode Scriptlet node to get name of
- * @returns Name of the scriptlet
- * @throws If the scriptlet is empty
- */
-function getScriptletName(scriptletNode) {
-    if (scriptletNode.children.length === 0) {
-        throw new Error('Empty scriptlet');
-    }
-    return scriptletNode.children[0]?.value ?? constants.EMPTY;
-}
-/**
- * Transform the nth argument of the scriptlet node
- *
- * @param scriptletNode Scriptlet node to transform argument of
- * @param index Index of the argument to transform (index 0 is the scriptlet name)
- * @param transform Function to transform the argument
- */
-function transformNthScriptletArgument(scriptletNode, index, transform) {
-    const child = scriptletNode.children[index];
-    if (!typeGuards.isUndefined(child)) {
-        const transformed = transform(child?.value ?? null);
-        if (typeGuards.isNull(transformed)) {
-            // eslint-disable-next-line no-param-reassign
-            scriptletNode.children[index] = null;
-            return;
-        }
-        if (typeGuards.isNull(child)) {
-            // eslint-disable-next-line no-param-reassign
-            scriptletNode.children[index] = {
-                type: 'Value',
-                value: transformed,
-            };
-            return;
-        }
-        child.value = transformed;
-    }
-}
-/**
- * Transform all arguments of the scriptlet node
- *
- * @param scriptletNode Scriptlet node to transform arguments of
- * @param transform Function to transform the arguments
- */
-function transformAllScriptletArguments(scriptletNode, transform) {
-    for (let i = 0; i < scriptletNode.children.length; i += 1) {
-        transformNthScriptletArgument(scriptletNode, i, transform);
-    }
-}
-/**
- * Set name of the scriptlet.
- * Modifies input `scriptletNode` if needed.
- *
- * @param scriptletNode Scriptlet node to set name of
- * @param name Name to set
- */
-function setScriptletName(scriptletNode, name) {
-    transformNthScriptletArgument(scriptletNode, 0, () => name);
-}
-/**
- * Set quote type of the scriptlet parameters
- *
- * @param scriptletNode Scriptlet node to set quote type of
- * @param quoteType Preferred quote type
- */
-function setScriptletQuoteType(scriptletNode, quoteType) {
-    // null is a special value that means "no value", but we can't change its quote type,
-    // so we need to convert it to empty string
-    transformAllScriptletArguments(scriptletNode, (value) => quotes.QuoteUtils.setStringQuoteType(value ?? constants.EMPTY, quoteType));
-}
-
-exports.getScriptletName = getScriptletName;
-exports.setScriptletName = setScriptletName;
-exports.setScriptletQuoteType = setScriptletQuoteType;
-exports.transformAllScriptletArguments = transformAllScriptletArguments;
-exports.transformNthScriptletArgument = transformNthScriptletArgument;

package/dist/cjs/common/abp-snippet-injection-body-common.js

@@ -1,18 +0,0 @@
-/*
- * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
- * (c) 2024 Adguard Software Ltd.
- * Released under the MIT license
- * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
- */
-'use strict';
-
-class AbpSnippetInjectionBodyCommon {
-    /**
-     * Error messages used by the parser and generator.
-     */
-    static ERROR_MESSAGES = {
-        EMPTY_SCRIPTLET_CALL: 'Empty ABP snippet call',
-    };
-}
-
-exports.AbpSnippetInjectionBodyCommon = AbpSnippetInjectionBodyCommon;

package/dist/cjs/common/agent-common.js

@@ -1,58 +0,0 @@
-/*
- * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
- * (c) 2024 Adguard Software Ltd.
- * Released under the MIT license
- * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
- */
-'use strict';
-
-var adblockers = require('../utils/adblockers.js');
-
-/**
- * Possible AdGuard agent markers.
- */
-const ADG_NAME_MARKERS = new Set([
-    'adguard',
-    'adg',
-]);
-/**
- * Possible uBlock Origin agent markers.
- */
-const UBO_NAME_MARKERS = new Set([
-    'ublock',
-    'ublock origin',
-    'ubo',
-]);
-/**
- * Possible Adblock Plus agent markers.
- */
-const ABP_NAME_MARKERS = new Set([
-    'adblock',
-    'adblock plus',
-    'adblockplus',
-    'abp',
-]);
-/**
- * Returns the adblock syntax based on the adblock name parsed from the agent type comment.
- * Needed for modifiers validation of network rules by AGLint.
- *
- * @param name Adblock name.
- *
- * @returns Adblock syntax.
- */
-const getAdblockSyntax = (name) => {
-    let syntax = adblockers.AdblockSyntax.Common;
-    const lowerCaseName = name.toLowerCase();
-    if (ADG_NAME_MARKERS.has(lowerCaseName)) {
-        syntax = adblockers.AdblockSyntax.Adg;
-    }
-    else if (UBO_NAME_MARKERS.has(lowerCaseName)) {
-        syntax = adblockers.AdblockSyntax.Ubo;
-    }
-    else if (ABP_NAME_MARKERS.has(lowerCaseName)) {
-        syntax = adblockers.AdblockSyntax.Abp;
-    }
-    return syntax;
-};
-
-exports.getAdblockSyntax = getAdblockSyntax;

package/dist/cjs/common/ubo-selector-common.js

@@ -1,18 +0,0 @@
-/*
- * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
- * (c) 2024 Adguard Software Ltd.
- * Released under the MIT license
- * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
- */
-'use strict';
-
-/**
- * Known uBO-specific pseudo-class names.
- */
-exports.UboPseudoName = void 0;
-(function (UboPseudoName) {
-    UboPseudoName["MatchesMedia"] = "matches-media";
-    UboPseudoName["MatchesPath"] = "matches-path";
-    UboPseudoName["Remove"] = "remove";
-    UboPseudoName["Style"] = "style";
-})(exports.UboPseudoName || (exports.UboPseudoName = {}));

package/dist/cjs/compatibility-tables/base.js

@@ -1,264 +0,0 @@
-/*
- * AGTree v3.0.0-alpha.1 (build date: Tue, 12 Nov 2024 16:11:58 GMT)
- * (c) 2024 Adguard Software Ltd.
- * Released under the MIT license
- * https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/agtree#readme
- */
-'use strict';
-
-var platforms = require('./platforms.js');
-var typeGuards = require('../utils/type-guards.js');
-var platformHelpers = require('./utils/platform-helpers.js');
-var adblockers = require('../utils/adblockers.js');
-
-/* eslint-disable no-bitwise */
-/**
- * @file Provides common compatibility table methods.
- */
-/**
- * Base compatibility table class which provides common methods to work with compatibility data.
- *
- * @template T Compatibility data schema.
- */
-class CompatibilityTableBase {
-    /**
-     * Compatibility table data.
-     */
-    data;
-    /**
-     * Optional name transformer function. If provided,
-     * it will be called in all methods before processing compatibility data names.
-     */
-    nameTransformer;
-    /**
-     * Creates a new instance of the common compatibility table.
-     *
-     * @param data Compatibility table data.
-     * @param nameTransformer Optional name transformer function.
-     */
-    constructor(data, nameTransformer = null) {
-        this.data = data;
-        this.nameTransformer = nameTransformer;
-    }
-    /**
-     * Helper method to get a 'row' from the compatibility table data by name.
-     *
-     * @param name Compatibility data name.
-     * @returns Compatibility table row storage or `null` if not found.
-     */
-    getRowStorage(name) {
-        const idx = this.data.map[name];
-        if (typeGuards.isUndefined(idx)) {
-            return null;
-        }
-        return this.data.shared[idx];
-    }
-    /**
-     * Checks whether a compatibility data `name` exists for any platform.
-     *
-     * @note Technically, do the same as `exists()` method with generic platform _any_
-     * but it is faster because it does not apply complex logic.
-     *
-     * @param name Compatibility data name.
-     *
-     * @returns True if the compatibility data exists, false otherwise.
-     */
-    existsAny(name) {
-        const normalizedName = this.nameTransformer ? this.nameTransformer(name) : name;
-        return !typeGuards.isUndefined(this.data.map[normalizedName]);
-    }
-    /**
-     * Checks whether a compatibility data `name` exists for a specified platform.
-     *
-     * @param name Compatibility data name.
-     * @param platform Specific or generic platform.
-     *
-     * @returns True if the compatibility data exists, false otherwise.
-     */
-    exists(name, platform) {
-        const normalizedName = this.nameTransformer ? this.nameTransformer(name) : name;
-        const data = this.getRowStorage(normalizedName);
-        if (!data) {
-            return false;
-        }
-        const isMatch = (idx) => {
-            const el = data.shared[idx];
-            return !typeGuards.isUndefined(el) && (el.name === normalizedName || !!el.aliases?.includes(normalizedName));
-        };
-        if (platformHelpers.isGenericPlatform(platform)) {
-            // Since indexes are specific platforms in the compatibility table data,
-            // we can't index them directly if the platform is generic (union of specific platforms).
-            // In this case, we need to iterate over the keys and return true on the first match.
-            const keys = Object.keys(data.map);
-            for (let i = 0; i < keys.length; i += 1) {
-                const key = Number(keys[i]);
-                if (platform & key) {
-                    const idx = data.map[key];
-                    if (isMatch(idx)) {
-                        return true;
-                    }
-                }
-            }
-            return false;
-        }
-        const idx = data.map[platform];
-        return isMatch(idx);
-    }
-    /**
-     * Returns a compatibility data by name and specific platform.
-     *
-     * @param name The name of the compatibility data.
-     * @param platform The specific platform.
-     *
-     * @returns A single compatibility data or `null` if not found.
-     */
-    getSingle(name, platform) {
-        const normalizedName = this.nameTransformer ? this.nameTransformer(name) : name;
-        const data = this.getRowStorage(normalizedName);
-        if (!data) {
-            return null;
-        }
-        const idx = data.map[platform];
-        return typeGuards.isUndefined(idx) ? null : data.shared[idx];
-    }
-    /**
-     * Returns all compatibility data records for name and specified platform.
-     *
-     * @param name Compatibility data name.
-     * @param platform Specific or generic platform.
-     *
-     * @returns Multiple records grouped by platforms.
-     * Technically, it is an object where keys are platform enums values and values are compatibility data records.
-     *
-     * @note Platform enum values can be converted to string names using {@link getSpecificPlatformName} on demand.
-     */
-    getMultiple(name, platform) {
-        const normalizedName = this.nameTransformer ? this.nameTransformer(name) : name;
-        const data = this.getRowStorage(normalizedName);
-        if (!data) {
-            return null;
-        }
-        if (platformHelpers.isGenericPlatform(platform)) {
-            const result = {};
-            const keys = Object.keys(data.map);
-            for (let i = 0; i < keys.length; i += 1) {
-                const key = Number(keys[i]);
-                if (platform & key) {
-                    const idx = data.map[key];
-                    if (!typeGuards.isUndefined(idx)) {
-                        result[key] = data.shared[idx];
-                    }
-                }
-            }
-            return result;
-        }
-        const idx = data.map[platform];
-        if (typeGuards.isUndefined(idx)) {
-            return null;
-        }
-        return { key: data.shared[idx] };
-    }
-    /**
-     * Returns all compatibility data records for the specified platform.
-     *
-     * @param platform Specific or generic platform.
-     *
-     * @returns Array of multiple records grouped by platforms.
-     */
-    getAllMultiple(platform) {
-        const result = [];
-        for (let i = 0; i < this.data.shared.length; i += 1) {
-            const data = this.data.shared[i];
-            const names = new Set(data.shared.map(({ name }) => name));
-            names.forEach((name) => {
-                const multipleRecords = this.getMultiple(name, platform);
-                if (multipleRecords) {
-                    result.push(multipleRecords);
-                }
-            });
-        }
-        return result;
-    }
-    /**
-     * Returns the first compatibility data record for name and specified platform.
-     *
-     * @param name Compatibility data name.
-     * @param platform Specific or generic platform.
-     *
-     * @returns First found compatibility data record or `null` if not found.
-     */
-    getFirst(name, platform) {
-        const normalizedName = this.nameTransformer ? this.nameTransformer(name) : name;
-        const data = this.getRowStorage(normalizedName);
-        if (!data) {
-            return null;
-        }
-        if (platformHelpers.isGenericPlatform(platform)) {
-            const keys = Object.keys(data.map);
-            for (let i = 0; i < keys.length; i += 1) {
-                const key = Number(keys[i]);
-                if (platform & key) {
-                    const idx = data.map[key];
-                    if (!typeGuards.isUndefined(idx)) {
-                        // return the first found record
-                        return data.shared[idx];
-                    }
-                }
-            }
-            return null;
-        }
-        const idx = data.map[platform];
-        if (typeGuards.isUndefined(idx)) {
-            return null;
-        }
-        return data.shared[idx];
-    }
-    /**
-     * Returns all compatibility data records for the specified name.
-     *
-     * @param name Compatibility data name.
-     *
-     * @returns Array of multiple records grouped by platforms.
-     */
-    getRow(name) {
-        const normalizedName = this.nameTransformer ? this.nameTransformer(name) : name;
-        const data = this.getRowStorage(normalizedName);
-        if (!data) {
-            return [];
-        }
-        return data.shared;
-    }
-    /**
-     * Returns all compatibility data grouped by products.
-     *
-     * @returns Array of multiple records grouped by products.
-     */
-    getRowsByProduct() {
-        const result = [];
-        for (let i = 0; i < this.data.shared.length; i += 1) {
-            const data = this.data.shared[i];
-            const keys = Object.keys(data.map);
-            const row = {
-                [adblockers.AdblockSyntax.Adg]: {},
-                [adblockers.AdblockSyntax.Ubo]: {},
-                [adblockers.AdblockSyntax.Abp]: {},
-            };
-            for (let j = 0; j < keys.length; j += 1) {
-                const key = Number(keys[j]);
-                if (key & platforms.GenericPlatform.AdgAny) {
-                    row[adblockers.AdblockSyntax.Adg][key] = data.shared[data.map[key]];
-                }
-                else if (key & platforms.GenericPlatform.UboAny) {
-                    row[adblockers.AdblockSyntax.Ubo][key] = data.shared[data.map[key]];
-                }
-                else if (key & platforms.GenericPlatform.AbpAny) {
-                    row[adblockers.AdblockSyntax.Abp][key] = data.shared[data.map[key]];
-                }
-            }
-            result.push(row);
-        }
-        return result;
-    }
-}
-
-exports.CompatibilityTableBase = CompatibilityTableBase;