less 4.9.1 → 5.0.0-alpha.10

package/lib/less/environment/abstract-plugin-loader.js

@@ -1,185 +0,0 @@
-import functionRegistry from '../functions/function-registry.js';
-import LessError from '../less-error.js';
-
-class AbstractPluginLoader {
-    constructor() {
-        // Implemented by Node.js plugin loader
-        this.require = function() {
-            return null;
-        }
-    }
-
-    evalPlugin(contents, context, imports, pluginOptions, fileInfo) {
-
-        let loader, registry, pluginObj, localModule, pluginManager, filename, result;
-
-        pluginManager = context.pluginManager;
-
-        if (fileInfo) {
-            if (typeof fileInfo === 'string') {
-                filename = fileInfo;
-            }
-            else {
-                filename = fileInfo.filename;
-            }
-        }
-        const shortname = (new this.less.FileManager()).extractUrlParts(filename).filename;
-
-        if (filename) {
-            pluginObj = pluginManager.get(filename);
-
-            if (pluginObj) {
-                result = this.trySetOptions(pluginObj, filename, shortname, pluginOptions);
-                if (result) {
-                    return result;
-                }
-                try {
-                    if (pluginObj.use) {
-                        pluginObj.use.call(this.context, pluginObj);
-                    }
-                }
-                catch (e) {
-                    e.message = e.message || 'Error during @plugin call';
-                    return new LessError(e, imports, filename);
-                }
-                return pluginObj;
-            }
-        }
-        localModule = {
-            exports: {},
-            pluginManager,
-            fileInfo
-        };
-        registry = functionRegistry.create();
-
-        const registerPlugin = function(obj) {
-            pluginObj = obj;
-        };
-
-        try {
-            loader = new Function('module', 'require', 'registerPlugin', 'functions', 'tree', 'less', 'fileInfo', contents);
-            loader(localModule, this.require(filename), registerPlugin, registry, this.less.tree, this.less, fileInfo);
-        }
-        catch (e) {
-            return new LessError(e, imports, filename);
-        }
-
-        if (!pluginObj) {
-            pluginObj = localModule.exports;
-        }
-        pluginObj = this.validatePlugin(pluginObj, filename, shortname);
-
-        if (pluginObj instanceof LessError) {
-            return pluginObj;
-        }
-
-        if (pluginObj) {
-            pluginObj.imports = imports;
-            pluginObj.filename = filename;
-
-            // For < 3.x (or unspecified minVersion) - setOptions() before install()
-            if (!pluginObj.minVersion || this.compareVersion('3.0.0', pluginObj.minVersion) < 0) {
-                result = this.trySetOptions(pluginObj, filename, shortname, pluginOptions);
-
-                if (result) {
-                    return result;
-                }
-            }
-
-            // Run on first load
-            pluginManager.addPlugin(pluginObj, fileInfo.filename, registry);
-            pluginObj.functions = registry.getLocalFunctions();
-
-            // Need to call setOptions again because the pluginObj might have functions
-            result = this.trySetOptions(pluginObj, filename, shortname, pluginOptions);
-            if (result) {
-                return result;
-            }
-
-            // Run every @plugin call
-            try {
-                if (pluginObj.use) {
-                    pluginObj.use.call(this.context, pluginObj);
-                }
-            }
-            catch (e) {
-                e.message = e.message || 'Error during @plugin call';
-                return new LessError(e, imports, filename);
-            }
-
-        }
-        else {
-            return new LessError({ message: 'Not a valid plugin' }, imports, filename);
-        }
-
-        return pluginObj;
-
-    }
-
-    trySetOptions(plugin, filename, name, options) {
-        if (options && !plugin.setOptions) {
-            return new LessError({
-                message: `Options have been provided but the plugin ${name} does not support any options.`
-            });
-        }
-        try {
-            plugin.setOptions && plugin.setOptions(options);
-        }
-        catch (e) {
-            return new LessError(e);
-        }
-    }
-
-    validatePlugin(plugin, filename, name) {
-        if (plugin) {
-            // support plugins being a function
-            // so that the plugin can be more usable programmatically
-            if (typeof plugin === 'function') {
-                plugin = new plugin();
-            }
-
-            if (plugin.minVersion) {
-                if (this.compareVersion(plugin.minVersion, this.less.version) < 0) {
-                    return new LessError({
-                        message: `Plugin ${name} requires version ${this.versionToString(plugin.minVersion)}`
-                    });
-                }
-            }
-            return plugin;
-        }
-        return null;
-    }
-
-    compareVersion(aVersion, bVersion) {
-        if (typeof aVersion === 'string') {
-            aVersion = aVersion.match(/^(\d+)\.?(\d+)?\.?(\d+)?/);
-            aVersion.shift();
-        }
-        for (let i = 0; i < aVersion.length; i++) {
-            if (aVersion[i] !== bVersion[i]) {
-                return parseInt(aVersion[i]) > parseInt(bVersion[i]) ? -1 : 1;
-            }
-        }
-        return 0;
-    }
-
-    versionToString(version) {
-        let versionString = '';
-        for (let i = 0; i < version.length; i++) {
-            versionString += (versionString ? '.' : '') + version[i];
-        }
-        return versionString;
-    }
-
-    printUsage(plugins) {
-        for (let i = 0; i < plugins.length; i++) {
-            const plugin = plugins[i];
-            if (plugin.printUsage) {
-                plugin.printUsage();
-            }
-        }
-    }
-}
-
-export default AbstractPluginLoader;
-

package/lib/less/environment/environment-api.ts

@@ -1,21 +0,0 @@
-export interface Environment {
-    /**
-     * Converts a string to a base 64 string
-     */
-    encodeBase64(str: string): string
-    /**
-     * Lookup the mime-type of a filename
-     */
-    mimeLookup(filename: string): string
-    /**
-     * Look up the charset of a mime type
-     * @param mime
-     */
-    charsetLookup(mime: string): string
-    /**
-     * Gets a source map generator
-     *
-     * @todo - Figure out precise type
-     */
-    getSourceMapGenerator(): any
-}

package/lib/less/environment/environment.js

@@ -1,59 +0,0 @@
-/**
- * @todo Document why this abstraction exists, and the relationship between
- *       environment, file managers, and plugin manager
- */
-
-import logger from '../logger.js';
-
-class Environment {
-    constructor(externalEnvironment, fileManagers) {
-        this.fileManagers = fileManagers || [];
-        externalEnvironment = externalEnvironment || {};
-
-        const optionalFunctions = ['encodeBase64', 'mimeLookup', 'charsetLookup', 'getSourceMapGenerator'];
-        const requiredFunctions = [];
-        const functions = requiredFunctions.concat(optionalFunctions);
-
-        for (let i = 0; i < functions.length; i++) {
-            const propName = functions[i];
-            const environmentFunc = externalEnvironment[propName];
-            if (environmentFunc) {
-                this[propName] = environmentFunc.bind(externalEnvironment);
-            } else if (i < requiredFunctions.length) {
-                this.warn(`missing required function in environment - ${propName}`);
-            }
-        }
-    }
-
-    getFileManager(filename, currentDirectory, options, environment, isSync) {
-
-        if (!filename) {
-            logger.warn('getFileManager called with no filename.. Please report this issue. continuing.');
-        }
-        if (currentDirectory === undefined) {
-            logger.warn('getFileManager called with null directory.. Please report this issue. continuing.');
-        }
-
-        let fileManagers = this.fileManagers;
-        if (options.pluginManager) {
-            fileManagers = [].concat(fileManagers).concat(options.pluginManager.getFileManagers());
-        }
-        for (let i = fileManagers.length - 1; i >= 0 ; i--) {
-            const fileManager = fileManagers[i];
-            if (fileManager[isSync ? 'supportsSync' : 'supports'](filename, currentDirectory, options, environment)) {
-                return fileManager;
-            }
-        }
-        return null;
-    }
-
-    addFileManager(fileManager) {
-        this.fileManagers.push(fileManager);
-    }
-
-    clearFileManagers() {
-        this.fileManagers = [];
-    }
-}
-
-export default Environment;

package/lib/less/environment/file-manager-api.ts

@@ -1,77 +0,0 @@
-import type { Environment } from './environment-api'
-
-export interface FileManager {
-    /**
-     * Given the full path to a file, return the path component
-     * Provided by AbstractFileManager
-     */
-    getPath(filename: string): string
-    /**
-     * Append a .less extension if appropriate. Only called if less thinks one could be added.
-     * Provided by AbstractFileManager
-     */
-    tryAppendLessExtension(filename: string): string
-    /**
-     * Whether the rootpath should be converted to be absolute.
-     * The browser ovverides this to return true because urls must be absolute.
-     * Provided by AbstractFileManager (returns false)
-     */
-    alwaysMakePathsAbsolute(): boolean
-    /**
-     * Returns whether a path is absolute
-     * Provided by AbstractFileManager
-     */
-    isPathAbsolute(path: string): boolean
-    /**
-     * joins together 2 paths
-     * Provided by AbstractFileManager
-     */
-    join(basePath: string, laterPath: string): string
-    /**
-     * Returns the difference between 2 paths
-     * E.g. url = a/ baseUrl = a/b/ returns ../
-     * url = a/b/ baseUrl = a/ returns b/
-     * Provided by AbstractFileManager
-     */
-    pathDiff(url: string, baseUrl: string): string
-    /**
-     * Returns whether this file manager supports this file for syncronous file retrieval
-     * If true is returned, loadFileSync will then be called with the file.
-     * Provided by AbstractFileManager (returns false)
-     * 
-     * @todo - Narrow Options type
-     */
-    supportsSync(
-        filename: string,
-        currentDirectory: string,
-        options: Record<string, any>,
-        environment: Environment
-    ): boolean
-    /**
-     * If file manager supports async file retrieval for this file type
-     */
-    supports(
-        filename: string,
-        currentDirectory: string,
-        options: Record<string, any>,
-        environment: Environment
-    ): boolean
-    /**
-     * Loads a file asynchronously.
-     */
-    loadFile(
-        filename: string,
-        currentDirectory: string,
-        options: Record<string, any>,
-        environment: Environment
-    ): Promise<{ filename: string, contents: string }>
-    /**
-     * Loads a file synchronously. Expects an immediate return with an object
-     */
-    loadFileSync(
-        filename: string,
-        currentDirectory: string,
-        options: Record<string, any>,
-        environment: Environment
-    ): { error?: unknown, filename: string, contents: string }
-}

package/lib/less/functions/boolean.js

@@ -1,29 +0,0 @@
-import Anonymous from '../tree/anonymous.js';
-import Keyword from '../tree/keyword.js';
-
-function boolean(condition) {
-    return condition ? Keyword.True : Keyword.False;
-}
-
-/**
- * Functions with evalArgs set to false are sent context
- * as the first argument.
- */
-function If(context, condition, trueValue, falseValue) {
-    return condition.eval(context) ? trueValue.eval(context)
-        : (falseValue ? falseValue.eval(context) : new Anonymous);
-}
-If.evalArgs = false;
-
-function isdefined(context, variable) {
-    try {
-        variable.eval(context);
-        return Keyword.True;
-    } catch (e) {
-        return Keyword.False;
-    }
-}
-
-isdefined.evalArgs = false;
-
-export default { isdefined, boolean, 'if': If };

package/lib/less/functions/color-blending.js

@@ -1,85 +0,0 @@
-import Color from '../tree/color.js';
-
-// Color Blending
-// ref: http://www.w3.org/TR/compositing-1
-
-function colorBlend(mode, color1, color2) {
-    const ab = color1.alpha;        // result
-
-    let // backdrop
-        cb;
-
-    const as = color2.alpha;
-
-    let // source
-        cs;
-
-    let ar;
-    let cr;
-    const r = [];
-
-    ar = as + ab * (1 - as);
-    for (let i = 0; i < 3; i++) {
-        cb = color1.rgb[i] / 255;
-        cs = color2.rgb[i] / 255;
-        cr = mode(cb, cs);
-        if (ar) {
-            cr = (as * cs + ab * (cb -
-                  as * (cb + cs - cr))) / ar;
-        }
-        r[i] = cr * 255;
-    }
-
-    return new Color(r, ar);
-}
-
-const colorBlendModeFunctions = {
-    multiply: function(cb, cs) {
-        return cb * cs;
-    },
-    screen: function(cb, cs) {
-        return cb + cs - cb * cs;
-    },
-    overlay: function(cb, cs) {
-        cb *= 2;
-        return (cb <= 1) ?
-            colorBlendModeFunctions.multiply(cb, cs) :
-            colorBlendModeFunctions.screen(cb - 1, cs);
-    },
-    softlight: function(cb, cs) {
-        let d = 1;
-        let e = cb;
-        if (cs > 0.5) {
-            e = 1;
-            d = (cb > 0.25) ? Math.sqrt(cb)
-                : ((16 * cb - 12) * cb + 4) * cb;
-        }
-        return cb - (1 - 2 * cs) * e * (d - cb);
-    },
-    hardlight: function(cb, cs) {
-        return colorBlendModeFunctions.overlay(cs, cb);
-    },
-    difference: function(cb, cs) {
-        return Math.abs(cb - cs);
-    },
-    exclusion: function(cb, cs) {
-        return cb + cs - 2 * cb * cs;
-    },
-
-    // non-w3c functions:
-    average: function(cb, cs) {
-        return (cb + cs) / 2;
-    },
-    negation: function(cb, cs) {
-        return 1 - Math.abs(cb + cs - 1);
-    }
-};
-
-for (const f in colorBlendModeFunctions) {
-    // eslint-disable-next-line no-prototype-builtins
-    if (colorBlendModeFunctions.hasOwnProperty(f)) {
-        colorBlend[f] = colorBlend.bind(null, colorBlendModeFunctions[f]);
-    }
-}
-
-export default colorBlend;