less 5.0.0-alpha.7 → 5.0.0-alpha.9

package/dist/less-node.cjs

@@ -1,5 +1,5 @@
 /**
- * Less - Leaner CSS v5.0.0-alpha.7
+ * Less - Leaner CSS v5.0.0-alpha.9
  * 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) {
@@ -180,6 +170,36 @@ function resolveCollapseNesting(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
@@ -214,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 || [],
@@ -226,14 +272,7 @@ function createLessOptions(options) {
       ...(unitMode !== undefined && { unitMode }),
       plugins,
     },
-    // Less v5 preserves authored nesting unless `collapseNesting` requests a
-    // flattened projection. Pass the enum through unchanged; 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, so an explicit public Less option stays authoritative over it.
-    output: opts.collapseNesting !== undefined
-      ? [{ collapseNesting: resolveCollapseNesting(opts.collapseNesting) }]
-      : {},
+    output,
     language: {},
   };
 
@@ -261,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;
   }
@@ -279,7 +325,7 @@ function mapRenderResult(result, options) {
  * @module less/lib/version
  */
 
-const semver = "5.0.0-alpha.7";
+const semver = "5.0.0-alpha.9";
 const parsed = parseNodeVersion__default["default"](`v${semver}`);
 
 const version = {
@@ -326,13 +372,23 @@ const lesscHelper = {
     console.log('  --quiet                      Suppresses output of warnings.');
     console.log('  -v, --version                Prints version number and exit.');
     console.log('  --verbose                    Be verbose.');
-    console.log('  --collapse-nesting           Flatten nested rules after preserving source-order cascade.');
+    console.log('  --collapse-nesting[=MODE]    Flatten nested rules: native (default), or compact.');
+    console.log('  -x, --compress               Compress output by removing whitespace.');
+    console.log('  --math=MODE                  Math mode: parens-division (default), always, or parens.');
     console.log('  --unit-mode=MODE             Unit handling in math: preserve (default), strict, or loose (Less 4.x guessing).');
     console.log('  --strict-units[=on|off]      Deprecated: on is --unit-mode=strict, off is the default (preserve).');
+    console.log('  --source-map[=FILE]          Emit a source map (FILE, or <destination>.map by default).');
+    console.log('  --source-map-inline          Embed the source map as a data URI instead of a file.');
+    console.log('  --source-map-include-source  Embed the source files in the map (sourcesContent).');
+    console.log('  --source-map-rootpath=PATH   Prepend PATH to every source in the map.');
+    console.log('  --source-map-basepath=PATH   Strip PATH from the front of every source in the map.');
+    console.log('  --source-map-url=URL         Override the sourceMappingURL annotation.');
+    console.log('  --rewrite-urls[=all|local|off]  Rewrite url(...) references in imported files.');
+    console.log('  --rootpath=PATH              Prepend PATH to url(...) and import references.');
+    console.log('  --url-args=ARGS             Append ARGS (e.g. cache-buster) to every url(...).');
     console.log('');
     console.log('This release intentionally supports a smaller CLI surface.');
-    console.log('Source maps, browser compilation, legacy plugin flags, lint-only mode, and');
-    console.log('URL rewrite flags will be revisited in later alphas.');
+    console.log('Browser compilation, legacy plugin flags, and lint-only mode are not supported.');
     console.log('');
     console.log('Report bugs to: http://github.com/less/less.js/issues');
     console.log('Home page: <http://lesscss.org/>');

package/lib/lessc-helper.js

@@ -37,13 +37,23 @@ const lesscHelper = {
     console.log('  --quiet                      Suppresses output of warnings.');
     console.log('  -v, --version                Prints version number and exit.');
     console.log('  --verbose                    Be verbose.');
-    console.log('  --collapse-nesting           Flatten nested rules after preserving source-order cascade.');
+    console.log('  --collapse-nesting[=MODE]    Flatten nested rules: native (default), or compact.');
+    console.log('  -x, --compress               Compress output by removing whitespace.');
+    console.log('  --math=MODE                  Math mode: parens-division (default), always, or parens.');
     console.log('  --unit-mode=MODE             Unit handling in math: preserve (default), strict, or loose (Less 4.x guessing).');
     console.log('  --strict-units[=on|off]      Deprecated: on is --unit-mode=strict, off is the default (preserve).');
+    console.log('  --source-map[=FILE]          Emit a source map (FILE, or <destination>.map by default).');
+    console.log('  --source-map-inline          Embed the source map as a data URI instead of a file.');
+    console.log('  --source-map-include-source  Embed the source files in the map (sourcesContent).');
+    console.log('  --source-map-rootpath=PATH   Prepend PATH to every source in the map.');
+    console.log('  --source-map-basepath=PATH   Strip PATH from the front of every source in the map.');
+    console.log('  --source-map-url=URL         Override the sourceMappingURL annotation.');
+    console.log('  --rewrite-urls[=all|local|off]  Rewrite url(...) references in imported files.');
+    console.log('  --rootpath=PATH              Prepend PATH to url(...) and import references.');
+    console.log('  --url-args=ARGS             Append ARGS (e.g. cache-buster) to every url(...).');
     console.log('');
     console.log('This release intentionally supports a smaller CLI surface.');
-    console.log('Source maps, browser compilation, legacy plugin flags, lint-only mode, and');
-    console.log('URL rewrite flags will be revisited in later alphas.');
+    console.log('Browser compilation, legacy plugin flags, and lint-only mode are not supported.');
     console.log('');
     console.log('Report bugs to: http://github.com/less/less.js/issues');
     console.log('Home page: <http://lesscss.org/>');

package/lib/options.d.ts

@@ -21,6 +21,38 @@ export interface LessRenderOptions {
    * deprecated alias for `'native'`.
    */
   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) {
@@ -83,6 +73,36 @@ function resolveCollapseNesting(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
@@ -117,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 || [],
@@ -129,14 +175,7 @@ export function createLessOptions(options) {
       ...(unitMode !== undefined && { unitMode }),
       plugins,
     },
-    // Less v5 preserves authored nesting unless `collapseNesting` requests a
-    // flattened projection. Pass the enum through unchanged; 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, so an explicit public Less option stays authoritative over it.
-    output: opts.collapseNesting !== undefined
-      ? [{ collapseNesting: resolveCollapseNesting(opts.collapseNesting) }]
-      : {},
+    output,
     language: {},
   };
 
@@ -165,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.7",
+	"version": "5.0.0-alpha.9",
 	"description": "Leaner CSS",
 	"homepage": "http://lesscss.org",
 	"author": {
@@ -45,14 +45,15 @@
 		"!lib/**/*.map",
 		"dist",
 		"index.cjs",
-		"README.md"
+		"README.md",
+		"V5-STATUS.md"
 	],
 	"engines": {
 		"node": "^20.19.0 || >=22.12.0"
 	},
 	"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 +142,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.22",
+		"@jesscss/core": "2.0.0-alpha.22",
+		"@jesscss/plugin-less": "2.0.0-alpha.22",
+		"@jesscss/plugin-less-compat": "2.0.0-alpha.22",
+		"@jesscss/plugin-node-modules": "2.0.0-alpha.22",
 		"parse-node-version": "^1.0.1"
 	},
 	"peerDependencies": {
-		"@jesscss/plugin-js": "2.0.0-alpha.20"
+		"@jesscss/plugin-js": "2.0.0-alpha.22"
 	},
 	"peerDependenciesMeta": {
 		"@jesscss/plugin-js": {