// https://github.com/dawaltconley/sass-cast/blob/main/index.js import * as sass from "sass-embedded"; import { isQuoted, unquoteString, parseString, getAttr } from "./utils"; import { List, OrderedMap } from "immutable"; /** * Converts any Javascript object to an equivalent Sass value. * * This method is recursive and will convert the values of any array or object, * as well as the array or object itself. * * @example * const { toSass } = require('sass-cast'); * * const string = toSass('a simple string'); * // quoted SassString => '"a simple string"' * * const map = toSass({ * key: 'value', * nested: { * 'complex//:key': [ null, 4 ], * } * }); * // SassMap => '("key": "value", "nested": ("complex//:key": (null, 4)))' * * @param {*} value - the value to be converted * @param {Object} options * @param {boolean} [options.parseUnquotedStrings=false] - whether to parse unquoted strings for colors or numbers with units * @param {boolean|*[]} [options.resolveFunctions=false] - if true, resolve functions and attempt to cast their return values. if an array, pass as arguments when resolving * @param {boolean} [options.quotes=true] - controls whether returned SassStrings are quoted. input strings that contain quotes will always return a quoted SassString even if this flag is false. * @return {Value} - a {@link https://sass-lang.com/documentation/js-api/classes/Value Sass value} */ export const toSass = (value, options = {}) => { let { parseUnquotedStrings = false, resolveFunctions = false, quotes = true, } = options; if (value instanceof sass.Value) { return value; } else if (value === null || value === undefined) { return sass.sassNull; } else if (typeof value === "boolean") { return value ? sass.sassTrue : sass.sassFalse; } else if (typeof value === "number") { return new sass.SassNumber(value); } else if (typeof value === "string") { const valueIsQuoted = isQuoted(value); if (parseUnquotedStrings && !valueIsQuoted) { let parsed = parseString(value); if (parsed instanceof sass.SassColor || parsed instanceof sass.SassNumber) return parsed; } return new sass.SassString(value, { quotes: valueIsQuoted || quotes, }); } else if (typeof value === "object") { if (Array.isArray(value)) { let sassList = value.map((value) => toSass(value, options)); return new sass.SassList(sassList); } else { let sassMap = OrderedMap(value).mapEntries(([key, value]) => [ new sass.SassString(key, { quotes: true }), toSass(value, options), ]); return new sass.SassMap(sassMap); } } else if (resolveFunctions && typeof value === "function") { const args = Array.isArray(resolveFunctions) ? resolveFunctions : []; return toSass(value(...args), options); } return sass.sassNull; }; const colorProperties = [ "red", "green", "blue", "hue", "lightness", "saturation", "whiteness", "blackness", "alpha", ]; /** * Converts Sass values to their Javascript equivalents. * * @example * const { fromSass, toSass } = require('sass-cast'); * * const sassString = toSass('a sass string object'); * const string = fromSass(sassString); * // 'a sass string object' * * @param {Value} object - a {@link https://sass-lang.com/documentation/js-api/classes/Value Sass value} * @param {Object} options * @param {boolean} [options.preserveUnits=false] - By default, only the values of numbers are returned, not their units. If true, `fromSass` will return numbers as a two-item Array, i.e. [ value, unit ] * @param {boolean} [options.rgbColors=false] - By default, colors are returned as strings. If true, `fromSass` will return colors as an object with `r`, `g`, `b`, and `a`, properties. * @param {boolean} [options.preserveQuotes=false] - By default, quoted Sass strings return their inner text as a string. If true, `fromSass` will preserve the quotes in the returned string value. * @return {*} - a Javascript value corresponding to the Sass input */ export const fromSass = (object, options = {}) => { let { preserveUnits = false, rgbColors = false, preserveQuotes = false, } = options; if (object instanceof sass.SassBoolean) { return object.value; } else if (object instanceof sass.SassNumber) { if (preserveUnits) { return [ object.value, object.numeratorUnits.toArray(), object.denominatorUnits.toArray(), ]; } else if (object.numeratorUnits.size || object.denominatorUnits.size) { return object.toString(); } return object.value; } else if (object instanceof sass.SassColor) { if (rgbColors) { return colorProperties.reduce((colorObj, p) => { colorObj[p] = object[p]; return colorObj; }, {}); } return object.toString(); } else if (object instanceof sass.SassString) { return preserveQuotes ? object.text : unquoteString(object.text); } else if (object instanceof sass.SassList || List.isList(object)) { let list = []; for ( let i = 0, value = object.get(i); value !== undefined; i++, value = object.get(i) ) { list.push(fromSass(value, options)); } return list; } else if (object instanceof sass.SassMap) { return object.contents .mapEntries(([k, v]) => [k.text, fromSass(v, options)]) .toObject(); } else { return object.realNull; } }; /** * An object defining Sass utility functions. * * @example