less 5.0.0-alpha.6 → 5.0.0-alpha.8

package/dist/less-node.cjs

@@ -1,5 +1,5 @@
 /**
- * Less - Leaner CSS v5.0.0-alpha.6
+ * Less - Leaner CSS v5.0.0-alpha.8
  * http://lesscss.org
  *
  * Copyright (c) 2009-2026, Alexis Sellier <self@cloudhead.net>
@@ -105,19 +105,9 @@ const logger = {
  */
 
 const unsupportedAlphaOptions = new Map([
-  ['sourceMap', 'source maps are not supported'],
-  ['sourceMapFilename', 'source maps are not supported'],
-  ['sourceMapRootpath', 'source maps are not supported'],
-  ['sourceMapBasepath', 'source maps are not supported'],
-  ['sourceMapURL', 'source maps are not supported'],
-  ['sourceMapFileInline', 'source maps are not supported'],
   ['globalVars', 'global variable injection is not supported'],
   ['modifyVars', 'modify-var injection is not supported'],
-  ['rootpath', 'URL rootpath rewriting is not supported'],
-  ['rewriteUrls', 'URL rewriting is not supported'],
-  ['urlArgs', 'URL argument rewriting is not supported'],
   ['javascriptEnabled', 'JavaScript evaluation is not supported'],
-  ['compress', 'compressed output is not supported'],
 ]);
 
 function validateAlphaOptions(options) {
@@ -161,6 +151,55 @@ function stableStringify(value, seen = new WeakSet()) {
   return `{${entries.join(',')}}`;
 }
 
+/**
+ * `collapseNesting` accepts `false` (keep authored nesting — the v5 default),
+ * `'native'` (CSS Nesting desugaring: parent wrapped in `:is()`, child selector
+ * lists distributed, specificity-faithful), `'compact'` (like `'native'` but
+ * also folds same-combinator descendant runs into one `:is()`), or the
+ * deprecated boolean `true` (alias for `'native'`). Anything else is rejected.
+ * @param {unknown} value
+ * @returns {boolean|'native'|'compact'}
+ */
+function resolveCollapseNesting(value) {
+  if (value === false || value === true || value === 'native' || value === 'compact') {
+    return value;
+  }
+  throw new Error(
+    `collapseNesting must be false, 'native', 'compact', or true `
+    + `(deprecated alias for 'native'); got ${JSON.stringify(value)}`
+  );
+}
+
+/**
+ * Build the compiler's `output.sourceMap` value from Less options. Source maps
+ * are enabled when `sourceMap` is truthy; the object form (or the flat legacy
+ * `sourceMap*` options) configures the details. Returns `undefined` when no
+ * source map is requested.
+ * @param {import('./options.js').LessRenderOptions} opts
+ * @returns {undefined | true | Record<string, unknown>}
+ */
+function resolveSourceMap(opts) {
+  if (!opts.sourceMap) {
+    return undefined;
+  }
+  const config = (typeof opts.sourceMap === 'object' && opts.sourceMap !== null)
+    ? { ...opts.sourceMap }
+    : {};
+  // Fold the flat legacy `sourceMap*` options into the object form the compiler
+  // reads; an explicit object sub-option wins over its flat alias.
+  const flat = [
+    'sourceMapURL', 'sourceMapFilename', 'sourceMapFullFilename',
+    'sourceMapRootpath', 'sourceMapBasepath', 'sourceMapFileInline',
+    'sourceMapOutputFilename', 'outputSourceFiles', 'disableSourcemapAnnotation'
+  ];
+  for (const key of flat) {
+    if (opts[key] !== undefined && config[key] === undefined) {
+      config[key] = opts[key];
+    }
+  }
+  return Object.keys(config).length > 0 ? config : true;
+}
+
 /**
  * Map Less render options to Jess compiler config.
  * @param {import('./options.js').LessRenderOptions} [options] Less-style options
@@ -195,11 +234,37 @@ function createLessOptions(options) {
     );
   }
 
-  const plugins = [lessPlugin__default["default"]()];
+  // URL rewriting lives on the Less plugin (it rewrites `url(...)` during
+  // serialization), not in `output`. Only forward keys the caller set so the
+  // plugin's own v5 defaults apply otherwise.
+  const lessPluginOptions = {};
+  if (opts.rootpath !== undefined) lessPluginOptions.rootpath = opts.rootpath;
+  if (opts.rewriteUrls !== undefined) lessPluginOptions.rewriteUrls = opts.rewriteUrls;
+  if (opts.urlArgs !== undefined) lessPluginOptions.urlArgs = opts.urlArgs;
+
+  const plugins = [lessPlugin__default["default"](lessPluginOptions)];
   if (!skipLessCompat) {
     plugins.push(pluginLessCompat.lessCompatPlugin({ plugins: lessPlugins }));
   }
 
+  // The projection/serialization options the compiler reads off `output`:
+  // `collapseNesting` (nesting flatten mode), `compress` (minified output), and
+  // `sourceMap`. Emitted as a single file-less array entry so an explicit render
+  // option overrides a file-local styles.config for every key (the config merge
+  // appends it as the override default); left `{}` when the caller set none.
+  const outputEntry = {};
+  if (opts.collapseNesting !== undefined) {
+    outputEntry.collapseNesting = resolveCollapseNesting(opts.collapseNesting);
+  }
+  if (opts.compress !== undefined) {
+    outputEntry.compress = opts.compress;
+  }
+  const sourceMap = resolveSourceMap(opts);
+  if (sourceMap !== undefined) {
+    outputEntry.sourceMap = sourceMap;
+  }
+  const output = Object.keys(outputEntry).length > 0 ? [outputEntry] : {};
+
   const configOptions = {
     compile: {
       searchPaths: opts.paths || [],
@@ -207,15 +272,7 @@ function createLessOptions(options) {
       ...(unitMode !== undefined && { unitMode }),
       plugins,
     },
-    // Less v5 preserves authored nesting unless its explicit compatibility
-    // switch requests flattened CSS. Keep that public Less option at the
-    // wrapper boundary; Jess owns the one renderer and its output mode.
-    // A file's styles.config may use an output array. A file-less output entry
-    // is the compiler's documented per-render override for that shape, so an
-    // explicit public Less option remains authoritative over fixture config.
-    output: Object.prototype.hasOwnProperty.call(opts, 'collapseNesting')
-      ? [{ collapseNesting: opts.collapseNesting === true }]
-      : {},
+    output,
     language: {},
   };
 
@@ -243,6 +300,13 @@ function mapRenderResult(result, options) {
     css: result.css ?? '',
   };
 
+  // Less 4.x returns the source map as `result.map` (a JSON string) when one was
+  // requested; forward it so `less.render(src, { sourceMap: true })` behaves the
+  // same. The compiler writes the `sourceMappingURL` annotation into `css` itself.
+  if (result.map !== undefined) {
+    out.map = result.map;
+  }
+
   if (result.imports && Array.isArray(result.imports)) {
     out.imports = result.imports;
   }
@@ -261,7 +325,7 @@ function mapRenderResult(result, options) {
  * @module less/lib/version
  */
 
-const semver = "5.0.0-alpha.6";
+const semver = "5.0.0-alpha.8";
 const parsed = parseNodeVersion__default["default"](`v${semver}`);
 
 const version = {

package/lib/options.d.ts

@@ -13,10 +13,46 @@ export interface LessRenderOptions {
   plugins?: unknown[];
   math?: number | 'always' | 'parens-division' | 'parens' | 'strict';
   /**
-   * Opt into Less 4-style flattened output. Less v5 preserves authored nesting
-   * by default.
+   * How to flatten authored nesting. Less v5 preserves authored nesting by
+   * default (`false`). `'native'` applies the CSS Nesting desugaring (parent
+   * wrapped in `:is()`, child selector lists distributed — specificity-faithful,
+   * matching the browser and Less 4.x); `'compact'` additionally folds
+   * same-combinator descendant runs into a single `:is()`. `true` is a
+   * deprecated alias for `'native'`.
    */
-  collapseNesting?: boolean;
+  collapseNesting?: boolean | 'native' | 'compact';
+  /** Minified output. */
+  compress?: boolean;
+  /** Prepend a path to every rewritten `url(...)` and imported reference. */
+  rootpath?: string;
+  /** Rewrite relative `url(...)` against the importing file: `'all'` | `'local'` | `'off'` (or boolean). */
+  rewriteUrls?: boolean | 'all' | 'local' | 'off';
+  /** Append a query string to every non-data `url(...)`. */
+  urlArgs?: string;
+  /**
+   * Emit a source map. `true` turns it on with defaults; the object form (or the
+   * flat legacy `sourceMap*` options) configures it. Returned as `result.map`.
+   */
+  sourceMap?: boolean | {
+    sourceMapURL?: string;
+    sourceMapFilename?: string;
+    sourceMapFullFilename?: string;
+    sourceMapRootpath?: string;
+    sourceMapBasepath?: string;
+    sourceMapFileInline?: boolean;
+    sourceMapOutputFilename?: string;
+    outputSourceFiles?: boolean;
+    disableSourcemapAnnotation?: boolean;
+  };
+  sourceMapURL?: string;
+  sourceMapFilename?: string;
+  sourceMapFullFilename?: string;
+  sourceMapRootpath?: string;
+  sourceMapBasepath?: string;
+  sourceMapFileInline?: boolean;
+  sourceMapOutputFilename?: string;
+  outputSourceFiles?: boolean;
+  disableSourcemapAnnotation?: boolean;
   /** @internal Jess alpha benchmark-only flag for source graphs already proven @plugin-free. */
   __jessSkipLessCompatWhenPluginFree?: boolean;
 }

package/lib/options.js

@@ -8,19 +8,9 @@ import { lessCompatPlugin } from '@jesscss/plugin-less-compat';
 import { logger } from './logger.js';
 
 const unsupportedAlphaOptions = new Map([
-  ['sourceMap', 'source maps are not supported'],
-  ['sourceMapFilename', 'source maps are not supported'],
-  ['sourceMapRootpath', 'source maps are not supported'],
-  ['sourceMapBasepath', 'source maps are not supported'],
-  ['sourceMapURL', 'source maps are not supported'],
-  ['sourceMapFileInline', 'source maps are not supported'],
   ['globalVars', 'global variable injection is not supported'],
   ['modifyVars', 'modify-var injection is not supported'],
-  ['rootpath', 'URL rootpath rewriting is not supported'],
-  ['rewriteUrls', 'URL rewriting is not supported'],
-  ['urlArgs', 'URL argument rewriting is not supported'],
   ['javascriptEnabled', 'JavaScript evaluation is not supported'],
-  ['compress', 'compressed output is not supported'],
 ]);
 
 function validateAlphaOptions(options) {
@@ -64,6 +54,55 @@ function stableStringify(value, seen = new WeakSet()) {
   return `{${entries.join(',')}}`;
 }
 
+/**
+ * `collapseNesting` accepts `false` (keep authored nesting — the v5 default),
+ * `'native'` (CSS Nesting desugaring: parent wrapped in `:is()`, child selector
+ * lists distributed, specificity-faithful), `'compact'` (like `'native'` but
+ * also folds same-combinator descendant runs into one `:is()`), or the
+ * deprecated boolean `true` (alias for `'native'`). Anything else is rejected.
+ * @param {unknown} value
+ * @returns {boolean|'native'|'compact'}
+ */
+function resolveCollapseNesting(value) {
+  if (value === false || value === true || value === 'native' || value === 'compact') {
+    return value;
+  }
+  throw new Error(
+    `collapseNesting must be false, 'native', 'compact', or true `
+    + `(deprecated alias for 'native'); got ${JSON.stringify(value)}`
+  );
+}
+
+/**
+ * Build the compiler's `output.sourceMap` value from Less options. Source maps
+ * are enabled when `sourceMap` is truthy; the object form (or the flat legacy
+ * `sourceMap*` options) configures the details. Returns `undefined` when no
+ * source map is requested.
+ * @param {import('./options.js').LessRenderOptions} opts
+ * @returns {undefined | true | Record<string, unknown>}
+ */
+function resolveSourceMap(opts) {
+  if (!opts.sourceMap) {
+    return undefined;
+  }
+  const config = (typeof opts.sourceMap === 'object' && opts.sourceMap !== null)
+    ? { ...opts.sourceMap }
+    : {};
+  // Fold the flat legacy `sourceMap*` options into the object form the compiler
+  // reads; an explicit object sub-option wins over its flat alias.
+  const flat = [
+    'sourceMapURL', 'sourceMapFilename', 'sourceMapFullFilename',
+    'sourceMapRootpath', 'sourceMapBasepath', 'sourceMapFileInline',
+    'sourceMapOutputFilename', 'outputSourceFiles', 'disableSourcemapAnnotation'
+  ];
+  for (const key of flat) {
+    if (opts[key] !== undefined && config[key] === undefined) {
+      config[key] = opts[key];
+    }
+  }
+  return Object.keys(config).length > 0 ? config : true;
+}
+
 /**
  * Map Less render options to Jess compiler config.
  * @param {import('./options.js').LessRenderOptions} [options] Less-style options
@@ -98,11 +137,37 @@ export function createLessOptions(options) {
     );
   }
 
-  const plugins = [lessPlugin()];
+  // URL rewriting lives on the Less plugin (it rewrites `url(...)` during
+  // serialization), not in `output`. Only forward keys the caller set so the
+  // plugin's own v5 defaults apply otherwise.
+  const lessPluginOptions = {};
+  if (opts.rootpath !== undefined) lessPluginOptions.rootpath = opts.rootpath;
+  if (opts.rewriteUrls !== undefined) lessPluginOptions.rewriteUrls = opts.rewriteUrls;
+  if (opts.urlArgs !== undefined) lessPluginOptions.urlArgs = opts.urlArgs;
+
+  const plugins = [lessPlugin(lessPluginOptions)];
   if (!skipLessCompat) {
     plugins.push(lessCompatPlugin({ plugins: lessPlugins }));
   }
 
+  // The projection/serialization options the compiler reads off `output`:
+  // `collapseNesting` (nesting flatten mode), `compress` (minified output), and
+  // `sourceMap`. Emitted as a single file-less array entry so an explicit render
+  // option overrides a file-local styles.config for every key (the config merge
+  // appends it as the override default); left `{}` when the caller set none.
+  const outputEntry = {};
+  if (opts.collapseNesting !== undefined) {
+    outputEntry.collapseNesting = resolveCollapseNesting(opts.collapseNesting);
+  }
+  if (opts.compress !== undefined) {
+    outputEntry.compress = opts.compress;
+  }
+  const sourceMap = resolveSourceMap(opts);
+  if (sourceMap !== undefined) {
+    outputEntry.sourceMap = sourceMap;
+  }
+  const output = Object.keys(outputEntry).length > 0 ? [outputEntry] : {};
+
   const configOptions = {
     compile: {
       searchPaths: opts.paths || [],
@@ -110,15 +175,7 @@ export function createLessOptions(options) {
       ...(unitMode !== undefined && { unitMode }),
       plugins,
     },
-    // Less v5 preserves authored nesting unless its explicit compatibility
-    // switch requests flattened CSS. Keep that public Less option at the
-    // wrapper boundary; Jess owns the one renderer and its output mode.
-    // A file's styles.config may use an output array. A file-less output entry
-    // is the compiler's documented per-render override for that shape, so an
-    // explicit public Less option remains authoritative over fixture config.
-    output: Object.prototype.hasOwnProperty.call(opts, 'collapseNesting')
-      ? [{ collapseNesting: opts.collapseNesting === true }]
-      : {},
+    output,
     language: {},
   };
 
@@ -147,6 +204,13 @@ export function mapRenderResult(result, options) {
     css: result.css ?? '',
   };
 
+  // Less 4.x returns the source map as `result.map` (a JSON string) when one was
+  // requested; forward it so `less.render(src, { sourceMap: true })` behaves the
+  // same. The compiler writes the `sourceMappingURL` annotation into `css` itself.
+  if (result.map !== undefined) {
+    out.map = result.map;
+  }
+
   if (result.imports && Array.isArray(result.imports)) {
     out.imports = result.imports;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "less",
-	"version": "5.0.0-alpha.6",
+	"version": "5.0.0-alpha.8",
 	"description": "Leaner CSS",
 	"homepage": "http://lesscss.org",
 	"author": {
@@ -52,7 +52,7 @@
 	},
 	"scripts": {
 		"quicktest": "npm run test:legacy-node",
-		"test:alpha": "npm run typecheck && npm run build && npm run test:lessc && node test/jess-alpha-fast-path.mjs && node test/alpha-support.mjs && node test/alpha-fixtures.mjs",
+		"test:alpha": "npm run typecheck && npm run build && npm run test:lessc && node test/jess-alpha-fast-path.mjs && node test/alpha-support.mjs && node test/alpha-sourcemaps.mjs && node test/alpha-fixtures.mjs",
 		"test:lessc": "node test/lessc-alpha.mjs",
 		"test": "npm run test:alpha",
 		"test:module": "node test/test-es6.js && node test/test-cjs.cjs",
@@ -141,15 +141,15 @@
 	"rawcurrent": "https://raw.github.com/less/less.js/v",
 	"sourcearchive": "https://github.com/less/less.js/archive/v",
 	"dependencies": {
-		"@jesscss/compiler": "2.0.0-alpha.20",
-		"@jesscss/core": "2.0.0-alpha.20",
-		"@jesscss/plugin-less": "2.0.0-alpha.20",
-		"@jesscss/plugin-less-compat": "2.0.0-alpha.20",
-		"@jesscss/plugin-node-modules": "2.0.0-alpha.20",
+		"@jesscss/compiler": "2.0.0-alpha.21",
+		"@jesscss/core": "2.0.0-alpha.21",
+		"@jesscss/plugin-less": "2.0.0-alpha.21",
+		"@jesscss/plugin-less-compat": "2.0.0-alpha.21",
+		"@jesscss/plugin-node-modules": "2.0.0-alpha.21",
 		"parse-node-version": "^1.0.1"
 	},
 	"peerDependencies": {
-		"@jesscss/plugin-js": "2.0.0-alpha.20"
+		"@jesscss/plugin-js": "2.0.0-alpha.21"
 	},
 	"peerDependenciesMeta": {
 		"@jesscss/plugin-js": {