less 4.8.1 → 5.0.0-alpha.1

package/lib/less/tree/color.js

@@ -1,285 +0,0 @@
-// @ts-check
-import Node from './node.js';
-import colors from '../data/colors.js';
-
-/** @import { EvalContext, CSSOutput } from './node.js' */
-
-//
-// RGB Colors - #ff0014, #eee
-//
-class Color extends Node {
-    get type() { return 'Color'; }
-
-    /**
-     * @param {number[] | string} rgb
-     * @param {number} [a]
-     * @param {string} [originalForm]
-     */
-    constructor(rgb, a, originalForm) {
-        super();
-        const self = this;
-        //
-        // The end goal here, is to parse the arguments
-        // into an integer triplet, such as `128, 255, 0`
-        //
-        // This facilitates operations and conversions.
-        //
-        if (Array.isArray(rgb)) {
-            /** @type {number[]} */
-            this.rgb = rgb;
-        } else if (rgb.length >= 6) {
-            /** @type {number[]} */
-            this.rgb = [];
-            /** @type {RegExpMatchArray} */ (rgb.match(/.{2}/g)).map(function (c, i) {
-                if (i < 3) {
-                    self.rgb.push(parseInt(c, 16));
-                } else {
-                    self.alpha = (parseInt(c, 16)) / 255;
-                }
-            });
-        } else {
-            /** @type {number[]} */
-            this.rgb = [];
-            rgb.split('').map(function (c, i) {
-                if (i < 3) {
-                    self.rgb.push(parseInt(c + c, 16));
-                } else {
-                    self.alpha = (parseInt(c + c, 16)) / 255;
-                }
-            });
-        }
-        /** @type {number} */
-        if (typeof this.alpha === 'undefined') {
-            this.alpha = (typeof a === 'number') ? a : 1;
-        }
-        if (typeof originalForm !== 'undefined') {
-            this.value = originalForm;
-        }
-    }
-
-    luma() {
-        let r = this.rgb[0] / 255, g = this.rgb[1] / 255, b = this.rgb[2] / 255;
-
-        r = (r <= 0.03928) ? r / 12.92 : Math.pow(((r + 0.055) / 1.055), 2.4);
-        g = (g <= 0.03928) ? g / 12.92 : Math.pow(((g + 0.055) / 1.055), 2.4);
-        b = (b <= 0.03928) ? b / 12.92 : Math.pow(((b + 0.055) / 1.055), 2.4);
-
-        return 0.2126 * r + 0.7152 * g + 0.0722 * b;
-    }
-
-    /**
-     * @param {EvalContext} context
-     * @param {CSSOutput} output
-     */
-    genCSS(context, output) {
-        output.add(this.toCSS(context));
-    }
-
-    /**
-     * @param {EvalContext} context
-     * @param {boolean} [doNotCompress]
-     * @returns {string}
-     */
-    toCSS(context, doNotCompress) {
-        const compress = context && context.compress && !doNotCompress;
-        let color;
-        let alpha;
-        /** @type {string | undefined} */
-        let colorFunction;
-        /** @type {(string | number)[]} */
-        let args = [];
-
-        // `value` is set if this color was originally
-        // converted from a named color string so we need
-        // to respect this and try to output named color too.
-        alpha = this.fround(context, this.alpha);
-
-        if (this.value) {
-            if (/** @type {string} */ (this.value).indexOf('rgb') === 0) {
-                if (alpha < 1) {
-                    colorFunction = 'rgba';
-                }
-            } else if (/** @type {string} */ (this.value).indexOf('hsl') === 0) {
-                if (alpha < 1) {
-                    colorFunction = 'hsla';
-                } else {
-                    colorFunction = 'hsl';
-                }
-            } else {
-                return /** @type {string} */ (this.value);
-            }
-        } else {
-            if (alpha < 1) {
-                colorFunction = 'rgba';
-            }
-        }
-
-        switch (colorFunction) {
-            case 'rgba':
-                args = this.rgb.map(function (c) {
-                    return clamp(Math.round(c), 255);
-                }).concat(clamp(alpha, 1));
-                break;
-            case 'hsla':
-                args.push(clamp(alpha, 1));
-            // eslint-disable-next-line no-fallthrough
-            case 'hsl':
-                color = this.toHSL();
-                args = [
-                    this.fround(context, color.h),
-                    `${this.fround(context, color.s * 100)}%`,
-                    `${this.fround(context, color.l * 100)}%`
-                ].concat(args);
-        }
-
-        if (colorFunction) {
-            // Values are capped between `0` and `255`, rounded and zero-padded.
-            return `${colorFunction}(${args.join(`,${compress ? '' : ' '}`)})`;
-        }
-
-        color = this.toRGB();
-
-        if (compress) {
-            const splitcolor = color.split('');
-
-            // Convert color to short format
-            if (splitcolor[1] === splitcolor[2] && splitcolor[3] === splitcolor[4] && splitcolor[5] === splitcolor[6]) {
-                color = `#${splitcolor[1]}${splitcolor[3]}${splitcolor[5]}`;
-            }
-        }
-
-        return color;
-    }
-
-    //
-    // Operations have to be done per-channel, if not,
-    // channels will spill onto each other. Once we have
-    // our result, in the form of an integer triplet,
-    // we create a new Color node to hold the result.
-    //
-    /**
-     * @param {EvalContext} context
-     * @param {string} op
-     * @param {Color} other
-     */
-    operate(context, op, other) {
-        const rgb = new Array(3);
-        const alpha = this.alpha * (1 - other.alpha) + other.alpha;
-        for (let c = 0; c < 3; c++) {
-            rgb[c] = this._operate(context, op, this.rgb[c], other.rgb[c]);
-        }
-        return new Color(rgb, alpha);
-    }
-
-    toRGB() {
-        return toHex(this.rgb);
-    }
-
-    toHSL() {
-        const r = this.rgb[0] / 255, g = this.rgb[1] / 255, b = this.rgb[2] / 255, a = this.alpha;
-
-        const max = Math.max(r, g, b), min = Math.min(r, g, b);
-        /** @type {number} */
-        let h;
-        let s;
-        const l = (max + min) / 2;
-        const d = max - min;
-
-        if (max === min) {
-            h = s = 0;
-        } else {
-            s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
-
-            switch (max) {
-                case r: h = (g - b) / d + (g < b ? 6 : 0); break;
-                case g: h = (b - r) / d + 2;               break;
-                case b: h = (r - g) / d + 4;               break;
-            }
-            /** @type {number} */ (h) /= 6;
-        }
-        return { h: /** @type {number} */ (h) * 360, s, l, a };
-    }
-
-    // Adapted from http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript
-    toHSV() {
-        const r = this.rgb[0] / 255, g = this.rgb[1] / 255, b = this.rgb[2] / 255, a = this.alpha;
-
-        const max = Math.max(r, g, b), min = Math.min(r, g, b);
-        /** @type {number} */
-        let h;
-        let s;
-        const v = max;
-
-        const d = max - min;
-        if (max === 0) {
-            s = 0;
-        } else {
-            s = d / max;
-        }
-
-        if (max === min) {
-            h = 0;
-        } else {
-            switch (max) {
-                case r: h = (g - b) / d + (g < b ? 6 : 0); break;
-                case g: h = (b - r) / d + 2; break;
-                case b: h = (r - g) / d + 4; break;
-            }
-            /** @type {number} */ (h) /= 6;
-        }
-        return { h: /** @type {number} */ (h) * 360, s, v, a };
-    }
-
-    toARGB() {
-        return toHex([this.alpha * 255].concat(this.rgb));
-    }
-
-    /**
-     * @param {Node & { rgb?: number[], alpha?: number }} x
-     * @returns {0 | undefined}
-     */
-    compare(x) {
-        return (x.rgb &&
-            x.rgb[0] === this.rgb[0] &&
-            x.rgb[1] === this.rgb[1] &&
-            x.rgb[2] === this.rgb[2] &&
-            x.alpha  === this.alpha) ? 0 : undefined;
-    }
-
-    /** @param {string} keyword */
-    static fromKeyword(keyword) {
-        /** @type {Color | undefined} */
-        let c;
-        const key = keyword.toLowerCase();
-        // eslint-disable-next-line no-prototype-builtins
-        if (colors.hasOwnProperty(key)) {
-            c = new Color(/** @type {string} */ (colors[/** @type {keyof typeof colors} */ (key)]).slice(1));
-        }
-        else if (key === 'transparent') {
-            c = new Color([0, 0, 0], 0);
-        }
-
-        if (c) {
-            c.value = keyword;
-            return c;
-        }
-    }
-}
-
-/**
- * @param {number} v
- * @param {number} max
- */
-function clamp(v, max) {
-    return Math.min(Math.max(v, 0), max);
-}
-
-/** @param {number[]} v */
-function toHex(v) {
-    return `#${v.map(function (c) {
-        c = clamp(Math.round(c), 255);
-        return (c < 16 ? '0' : '') + c.toString(16);
-    }).join('')}`;
-}
-
-export default Color;

package/lib/less/tree/combinator.js

@@ -1,38 +0,0 @@
-// @ts-check
-import Node from './node.js';
-
-/** @import { EvalContext, CSSOutput } from './node.js' */
-
-/** @type {Record<string, boolean>} */
-const _noSpaceCombinators = {
-    '': true,
-    ' ': true,
-    '|': true
-};
-
-class Combinator extends Node {
-    get type() { return 'Combinator'; }
-
-    /** @param {string} value */
-    constructor(value) {
-        super();
-        if (value === ' ') {
-            this.value = ' ';
-            this.emptyOrWhitespace = true;
-        } else {
-            this.value = value ? value.trim() : '';
-            this.emptyOrWhitespace = this.value === '';
-        }
-    }
-
-    /**
-     * @param {EvalContext} context
-     * @param {CSSOutput} output
-     */
-    genCSS(context, output) {
-        const spaceOrEmpty = (context.compress || _noSpaceCombinators[/** @type {string} */ (this.value)]) ? '' : ' ';
-        output.add(spaceOrEmpty + this.value + spaceOrEmpty);
-    }
-}
-
-export default Combinator;

package/lib/less/tree/comment.js

@@ -1,48 +0,0 @@
-// @ts-check
-/** @import { EvalContext, CSSOutput, FileInfo } from './node.js' */
-/** @import { DebugInfoContext } from './debug-info.js' */
-import Node from './node.js';
-import getDebugInfo from './debug-info.js';
-
-class Comment extends Node {
-    get type() { return 'Comment'; }
-
-    /**
-     * @param {string} value
-     * @param {boolean} isLineComment
-     * @param {number} index
-     * @param {FileInfo} currentFileInfo
-     */
-    constructor(value, isLineComment, index, currentFileInfo) {
-        super();
-        this.value = value;
-        this.isLineComment = isLineComment;
-        this._index = index;
-        this._fileInfo = currentFileInfo;
-        this.allowRoot = true;
-        /** @type {{ lineNumber: number, fileName: string } | undefined} */
-        this.debugInfo = undefined;
-    }
-
-    /**
-     * @param {EvalContext} context
-     * @param {CSSOutput} output
-     */
-    genCSS(context, output) {
-        if (this.debugInfo) {
-            output.add(getDebugInfo(context, /** @type {DebugInfoContext} */ (this)), this.fileInfo(), this.getIndex());
-        }
-        output.add(/** @type {string} */ (this.value));
-    }
-
-    /**
-     * @param {EvalContext} context
-     * @returns {boolean}
-     */
-    isSilent(context) {
-        const isCompressed = context.compress && /** @type {string} */ (this.value)[2] !== '!';
-        return this.isLineComment || isCompressed;
-    }
-}
-
-export default Comment;

package/lib/less/tree/condition.js

@@ -1,65 +0,0 @@
-// @ts-check
-/** @import { EvalContext, TreeVisitor } from './node.js' */
-import Node from './node.js';
-
-class Condition extends Node {
-    get type() { return 'Condition'; }
-
-    /**
-     * @param {string} op
-     * @param {Node} l
-     * @param {Node} r
-     * @param {number} i
-     * @param {boolean} negate
-     */
-    constructor(op, l, r, i, negate) {
-        super();
-        this.op = op.trim();
-        this.lvalue = l;
-        this.rvalue = r;
-        this._index = i;
-        this.negate = negate;
-    }
-
-    /** @param {TreeVisitor} visitor */
-    accept(visitor) {
-        this.lvalue = visitor.visit(this.lvalue);
-        this.rvalue = visitor.visit(this.rvalue);
-    }
-
-    /**
-     * @param {EvalContext} context
-     * @returns {boolean}
-     * @suppress {checkTypes}
-     */
-    // @ts-ignore - Condition.eval returns boolean, not Node (used as guard condition)
-    eval(context) {
-        const a = this.lvalue.eval(context);
-        const b = this.rvalue.eval(context);
-        /** @type {boolean} */
-        let result;
-
-        switch (this.op) {
-            case 'and': result = Boolean(a && b); break;
-            case 'or':  result = Boolean(a || b); break;
-            default:
-                switch (Node.compare(a, b)) {
-                    case -1:
-                        result = this.op === '<' || this.op === '=<' || this.op === '<=';
-                        break;
-                    case 0:
-                        result = this.op === '=' || this.op === '>=' || this.op === '=<' || this.op === '<=';
-                        break;
-                    case 1:
-                        result = this.op === '>' || this.op === '>=';
-                        break;
-                    default:
-                        result = false;
-                }
-        }
-
-        return this.negate ? !result : result;
-    }
-}
-
-export default Condition;

package/lib/less/tree/container.js

@@ -1,104 +0,0 @@
-// @ts-check
-/** @import { EvalContext, CSSOutput, FileInfo, VisibilityInfo } from './node.js' */
-/** @import { FunctionRegistry, NestableAtRuleThis } from './nested-at-rule.js' */
-import Node from './node.js';
-import Ruleset from './ruleset.js';
-import Value from './value.js';
-import Selector from './selector.js';
-import AtRule from './atrule.js';
-import NestableAtRulePrototype from './nested-at-rule.js';
-
-/**
- * @typedef {Ruleset & {
- *   allowImports?: boolean,
- *   debugInfo?: { lineNumber: number, fileName: string },
- *   functionRegistry?: FunctionRegistry
- * }} RulesetWithExtras
- */
-
-class Container extends AtRule {
-    get type() { return 'Container'; }
-
-    /**
-     * @param {Node[] | null} value
-     * @param {Node[]} features
-     * @param {number} index
-     * @param {FileInfo} currentFileInfo
-     * @param {VisibilityInfo} visibilityInfo
-     */
-    constructor(value, features, index, currentFileInfo, visibilityInfo) {
-        super();
-        this._index = index;
-        this._fileInfo = currentFileInfo;
-
-        const selectors = (new Selector([], null, null, this._index, this._fileInfo)).createEmptySelectors();
-
-        /** @type {Value} */
-        this.features = new Value(features);
-        /** @type {RulesetWithExtras[]} */
-        this.rules = [new Ruleset(selectors, value)];
-        this.rules[0].allowImports = true;
-        this.copyVisibilityInfo(visibilityInfo);
-        this.allowRoot = true;
-        this.setParent(selectors, /** @type {Node} */ (/** @type {unknown} */ (this)));
-        this.setParent(this.features, /** @type {Node} */ (/** @type {unknown} */ (this)));
-        this.setParent(this.rules, /** @type {Node} */ (/** @type {unknown} */ (this)));
-
-        /** @type {boolean | undefined} */
-        this._evaluated = undefined;
-    }
-
-    /**
-     * @param {EvalContext} context
-     * @param {CSSOutput} output
-     */
-    genCSS(context, output) {
-        output.add('@container ', this._fileInfo, this._index);
-        this.features.genCSS(context, output);
-        this.outputRuleset(context, output, this.rules);
-    }
-
-    /**
-     * @param {EvalContext} context
-     * @returns {Node}
-     */
-    eval(context) {
-        if (this._evaluated) {
-            return /** @type {Node} */ (/** @type {unknown} */ (this));
-        }
-        if (!context.mediaBlocks) {
-            context.mediaBlocks = [];
-            context.mediaPath = [];
-        }
-
-        const media = new Container(null, [], this._index, this._fileInfo, this.visibilityInfo());
-        media._evaluated = true;
-        if (this.debugInfo) {
-            this.rules[0].debugInfo = this.debugInfo;
-            media.debugInfo = this.debugInfo;
-        }
-
-        media.features = /** @type {Value} */ (this.features.eval(context));
-
-        context.mediaPath.push(/** @type {Node} */ (/** @type {unknown} */ (media)));
-        context.mediaBlocks.push(/** @type {Node} */ (/** @type {unknown} */ (media)));
-
-        const fr = /** @type {RulesetWithExtras} */ (context.frames[0]).functionRegistry;
-        if (fr) {
-            this.rules[0].functionRegistry = fr.inherit();
-        }
-        context.frames.unshift(this.rules[0]);
-        media.rules = [/** @type {RulesetWithExtras} */ (this.rules[0].eval(context))];
-        context.frames.shift();
-
-        context.mediaPath.pop();
-
-        return context.mediaPath.length === 0 ? /** @type {NestableAtRuleThis} */ (/** @type {unknown} */ (media)).evalTop(context) :
-            /** @type {NestableAtRuleThis} */ (/** @type {unknown} */ (media)).evalNested(context);
-    }
-}
-
-// Apply NestableAtRulePrototype methods (accept, isRulesetLike override AtRule's versions)
-Object.assign(Container.prototype, NestableAtRulePrototype);
-
-export default Container;

package/lib/less/tree/debug-info.js

@@ -1,80 +0,0 @@
-// @ts-check
-
-/**
- * @typedef {object} DebugInfoData
- * @property {number} lineNumber
- * @property {string} fileName
- */
-
-/**
- * @typedef {object} DebugInfoContext
- * @property {DebugInfoData} debugInfo
- */
-
-/**
- * @deprecated The dumpLineNumbers option is deprecated. Use sourcemaps instead.
- * This will be removed in a future version.
- *
- * @param {DebugInfoContext} ctx - Context object with debugInfo
- * @returns {string} Debug info as CSS comment
- */
-function asComment(ctx) {
-    return `/* line ${ctx.debugInfo.lineNumber}, ${ctx.debugInfo.fileName} */\n`;
-}
-
-/**
- * @deprecated The dumpLineNumbers option is deprecated. Use sourcemaps instead.
- * This function generates Sass-compatible debug info using @media -sass-debug-info syntax.
- * This format had short-lived usage and is no longer recommended.
- * This will be removed in a future version.
- *
- * @param {DebugInfoContext} ctx - Context object with debugInfo
- * @returns {string} Sass-compatible debug info as @media query
- */
-function asMediaQuery(ctx) {
-    let filenameWithProtocol = ctx.debugInfo.fileName;
-    if (!/^[a-z]+:\/\//i.test(filenameWithProtocol)) {
-        filenameWithProtocol = `file://${filenameWithProtocol}`;
-    }
-    return `@media -sass-debug-info{filename{font-family:${filenameWithProtocol.replace(/([.:/\\])/g, function (a) {
-        if (a == '\\') {
-            a = '/';
-        }
-        return `\\${a}`;
-    })}}line{font-family:\\00003${ctx.debugInfo.lineNumber}}}\n`;
-}
-
-/**
- * Generates debug information (line numbers) for CSS output.
- *
- * @param {{ dumpLineNumbers?: string, compress?: boolean }} context - Context object with dumpLineNumbers option
- * @param {DebugInfoContext} ctx - Context object with debugInfo
- * @param {string} [lineSeparator] - Separator between comment and media query (for 'all' mode)
- * @returns {string} Debug info string
- *
- * @deprecated The dumpLineNumbers option is deprecated. Use sourcemaps instead.
- * All modes ('comments', 'mediaquery', 'all') are deprecated and will be removed in a future version.
- * The 'mediaquery' and 'all' modes generate Sass-compatible @media -sass-debug-info output
- * which had short-lived usage and is no longer recommended.
- */
-function debugInfo(context, ctx, lineSeparator) {
-    let result = '';
-    // Some nodes never receive a debugInfo during parsing (e.g. the implicit
-    // ruleset of a nested @supports/@document), so there is no line to emit.
-    if (context.dumpLineNumbers && !context.compress && ctx.debugInfo) {
-        switch (context.dumpLineNumbers) {
-            case 'comments':
-                result = asComment(ctx);
-                break;
-            case 'mediaquery':
-                result = asMediaQuery(ctx);
-                break;
-            case 'all':
-                result = asComment(ctx) + (lineSeparator || '') + asMediaQuery(ctx);
-                break;
-        }
-    }
-    return result;
-}
-
-export default debugInfo;