less 5.0.0-alpha.2 → 5.0.0-alpha.4

package/dist/less-node.cjs

@@ -1,5 +1,5 @@
 /**
- * Less - Leaner CSS v5.0.0-alpha.2
+ * Less - Leaner CSS v5.0.0-alpha.4
  * http://lesscss.org
  *
  * Copyright (c) 2009-2026, Alexis Sellier <self@cloudhead.net>
@@ -18,8 +18,8 @@ var compiler = require('@jesscss/compiler');
 var nodeModulesPlugin = require('@jesscss/plugin-node-modules');
 var lessPlugin = require('@jesscss/plugin-less');
 var pluginLessCompat = require('@jesscss/plugin-less-compat');
-var parseNodeVersion = require('parse-node-version');
 var core = require('@jesscss/core');
+var parseNodeVersion = require('parse-node-version');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -27,6 +27,78 @@ var nodeModulesPlugin__default = /*#__PURE__*/_interopDefaultLegacy(nodeModulesP
 var lessPlugin__default = /*#__PURE__*/_interopDefaultLegacy(lessPlugin);
 var parseNodeVersion__default = /*#__PURE__*/_interopDefaultLegacy(parseNodeVersion);
 
+/**
+ * Less logger wired to Jess's logger singleton.
+ * Forwards to Jess and maintains Less-style addListener/removeListener for compatibility.
+ * @module less/lib/logger
+ */
+
+/** @typedef {{ error?: (msg: string) => void, warn?: (msg: string) => void, info?: (msg: string) => void, debug?: (msg: string) => void }} LogListener */
+
+/** @type {LogListener[]} */
+const _listeners = [];
+
+/** @param {'error'|'warn'|'info'|'debug'} type @param {string} msg */
+function _fireEvent(type, msg) {
+  for (const listener of _listeners) {
+    const fn = listener[type];
+    if (fn) fn(msg);
+  }
+}
+
+// Wrap Jess's logger so Less listeners receive Jess's log output without
+// writing directly to stderr/stdout. Library consumers should be able to catch
+// `less.render()` rejections without surprise terminal output; the CLI owns
+// deciding whether/how to print diagnostics.
+core.logger.configure?.({
+  log(...args) {
+    _fireEvent('debug', args.map(String).join(' '));
+  },
+  info(...args) {
+    _fireEvent('info', args.map(String).join(' '));
+  },
+  warn(...args) {
+    _fireEvent('warn', args.map(String).join(' '));
+  },
+  error(...args) {
+    _fireEvent('error', args.map(String).join(' '));
+  },
+});
+
+/** Less-compatible logger backed by Jess's singleton */
+const logger = {
+  /** @param {string} msg */
+  error(msg) {
+    _fireEvent('error', msg);
+  },
+
+  /** @param {string} msg */
+  warn(msg) {
+    _fireEvent('warn', msg);
+  },
+
+  /** @param {string} msg */
+  info(msg) {
+    _fireEvent('info', msg);
+  },
+
+  /** @param {string} msg */
+  debug(msg) {
+    _fireEvent('debug', msg);
+  },
+
+  /** @param {LogListener} listener */
+  addListener(listener) {
+    _listeners.push(listener);
+  },
+
+  /** @param {LogListener} listener */
+  removeListener(listener) {
+    const i = _listeners.indexOf(listener);
+    if (i >= 0) _listeners.splice(i, 1);
+  },
+};
+
 /**
  * Options mapping between Less render options and Jess compiler config.
  * @module less/lib/options
@@ -41,7 +113,6 @@ const unsupportedAlphaOptions = new Map([
   ['sourceMapFileInline', 'source maps are not supported'],
   ['globalVars', 'global variable injection is not supported'],
   ['modifyVars', 'modify-var injection is not supported'],
-  ['strictUnits', 'strict unit mode is not supported'],
   ['rootpath', 'URL rootpath rewriting is not supported'],
   ['rewriteUrls', 'URL rewriting is not supported'],
   ['urlArgs', 'URL argument rewriting is not supported'],
@@ -51,7 +122,9 @@ const unsupportedAlphaOptions = new Map([
 
 function validateAlphaOptions(options) {
   for (const [name, reason] of unsupportedAlphaOptions) {
-    if (Object.prototype.hasOwnProperty.call(options, name)) {
+    // A falsy value is the 4.x default ("off") and requests nothing, so it is
+    // a no-op here; only an actual request for the feature is unsupported.
+    if (options[name]) {
       throw new Error(`${name} is not supported: ${reason}`);
     }
   }
@@ -107,6 +180,21 @@ function createLessOptions(options) {
     math === 2 || math === 'parens' || math === 'strict' ? 'parens' :
     'parens-division';
 
+  // `unitMode` is the option ('loose' | 'preserve' | 'strict'); `strictUnits`
+  // is its deprecated boolean alias: true → 'strict'; false means "not strict",
+  // i.e. the default ('preserve') — never the Less 4.x 'loose' fold, which only
+  // an explicit `unitMode: 'loose'` selects. Any use warns so the mapping is
+  // never discovered by staring at output. Left unset so the compiler default applies.
+  const unitMode = opts.unitMode !== undefined ? opts.unitMode
+    : opts.strictUnits === true ? 'strict'
+    : undefined;
+  if (opts.strictUnits !== undefined && opts.unitMode === undefined) {
+    logger.warn(
+      `strictUnits is deprecated; use unitMode. strictUnits: ${String(opts.strictUnits)} now means `
+      + `unitMode: '${unitMode ?? 'preserve'}'${opts.strictUnits ? '' : " (Less 4.x unit folding is unitMode: 'loose')"}`
+    );
+  }
+
   const plugins = [lessPlugin__default["default"]()];
   if (!skipLessCompat) {
     plugins.push(pluginLessCompat.lessCompatPlugin({ plugins: lessPlugins }));
@@ -116,6 +204,7 @@ function createLessOptions(options) {
     compile: {
       searchPaths: opts.paths || [],
       mathMode,
+      ...(unitMode !== undefined && { unitMode }),
       plugins,
     },
     // Less v5 preserves authored nesting unless its explicit compatibility
@@ -172,7 +261,7 @@ function mapRenderResult(result, options) {
  * @module less/lib/version
  */
 
-const semver = "5.0.0-alpha.2";
+const semver = "5.0.0-alpha.4";
 const parsed = parseNodeVersion__default["default"](`v${semver}`);
 
 const version = {
@@ -180,78 +269,6 @@ const version = {
   array: [parsed.major, parsed.minor, parsed.patch],
 };
 
-/**
- * Less logger wired to Jess's logger singleton.
- * Forwards to Jess and maintains Less-style addListener/removeListener for compatibility.
- * @module less/lib/logger
- */
-
-/** @typedef {{ error?: (msg: string) => void, warn?: (msg: string) => void, info?: (msg: string) => void, debug?: (msg: string) => void }} LogListener */
-
-/** @type {LogListener[]} */
-const _listeners = [];
-
-/** @param {'error'|'warn'|'info'|'debug'} type @param {string} msg */
-function _fireEvent(type, msg) {
-  for (const listener of _listeners) {
-    const fn = listener[type];
-    if (fn) fn(msg);
-  }
-}
-
-// Wrap Jess's logger so Less listeners receive Jess's log output without
-// writing directly to stderr/stdout. Library consumers should be able to catch
-// `less.render()` rejections without surprise terminal output; the CLI owns
-// deciding whether/how to print diagnostics.
-core.logger.configure?.({
-  log(...args) {
-    _fireEvent('debug', args.map(String).join(' '));
-  },
-  info(...args) {
-    _fireEvent('info', args.map(String).join(' '));
-  },
-  warn(...args) {
-    _fireEvent('warn', args.map(String).join(' '));
-  },
-  error(...args) {
-    _fireEvent('error', args.map(String).join(' '));
-  },
-});
-
-/** Less-compatible logger backed by Jess's singleton */
-const logger = {
-  /** @param {string} msg */
-  error(msg) {
-    _fireEvent('error', msg);
-  },
-
-  /** @param {string} msg */
-  warn(msg) {
-    _fireEvent('warn', msg);
-  },
-
-  /** @param {string} msg */
-  info(msg) {
-    _fireEvent('info', msg);
-  },
-
-  /** @param {string} msg */
-  debug(msg) {
-    _fireEvent('debug', msg);
-  },
-
-  /** @param {LogListener} listener */
-  addListener(listener) {
-    _listeners.push(listener);
-  },
-
-  /** @param {LogListener} listener */
-  removeListener(listener) {
-    const i = _listeners.indexOf(listener);
-    if (i >= 0) _listeners.splice(i, 1);
-  },
-};
-
 /**
  * Helper functions for lessc CLI.
  * Adapted from lib.bak/less-node/lessc-helper.js.
@@ -292,6 +309,8 @@ const lesscHelper = {
     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('  --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('');
     console.log('This release intentionally supports a smaller CLI surface.');
     console.log('Source maps, browser compilation, legacy plugin flags, lint-only mode, and');

package/lib/browser-dev.js

@@ -0,0 +1,86 @@
+/**
+ * Less.js v5 — browser build (powered by Jess).
+ *
+ * A single-file, in-browser Less→CSS compiler. It drives `@jesscss/compiler`'s
+ * `renderToResult` with an inline `source` and NO `filePath`, so the Node-only
+ * config-discovery layer (cosmiconfig/env-paths/fs) is never reached. `@import`
+ * / file access is unsupported here (see build/browser-stubs/fs.js).
+ *
+ * Bundled to an IIFE that defines `window.less` with the same public shape as
+ * the Less 4.x browser build: `less.render(input, options?, callback?)` returns
+ * a Promise and also invokes the err-first callback when one is given.
+ *
+ * @module less/browser-dev
+ */
+
+import { Compiler } from '@jesscss/compiler';
+import { createLessOptions, mapRenderResult } from './options.js';
+
+/* Injected at build time from packages/less/package.json. */
+/* global __LESS_VERSION__ */
+const semver = typeof __LESS_VERSION__ === 'string' ? __LESS_VERSION__ : '5.0.0-alpha.0';
+const versionArray = semver.split('.').map((n) => parseInt(n, 10) || 0).slice(0, 3);
+
+/**
+ * Build a Less-4.x-shaped error from the first Jess diagnostic. No fs fallback:
+ * in the browser there is no file to re-read for the source extract.
+ * @param {import('./options.js').JessRenderResult} result
+ */
+function createRenderError(result) {
+  const diagnostic = (result?.errors || [])[0];
+  const error = new Error(diagnostic?.message || 'Less render failed');
+  error.type = diagnostic?.phase || 'Syntax';
+  error.filename = diagnostic?.filePath || 'input';
+  error.line = diagnostic?.line || 1;
+  error.column = diagnostic?.column || 1;
+  const lines = diagnostic?.lines;
+  error.extract = Array.isArray(lines) ? lines.map(String) : undefined;
+  error.jessErrors = result?.errors || [];
+  error.jessWarnings = result?.warnings || [];
+  return error;
+}
+
+/**
+ * Render Less source to CSS. Mirrors the Less 4.x API: `options` and `callback`
+ * are both optional, `callback` may be passed as the second argument, and the
+ * returned Promise resolves to a `{ css, warnings }` result. When a callback is
+ * given it is invoked err-first and the Promise is still returned.
+ * @param {string} input Less source
+ * @param {object|Function} [options] Less-style options (math, collapseNesting, plugins) — or the callback
+ * @param {Function} [callback] err-first `(error, result)` callback
+ * @returns {Promise<{ css: string, warnings?: unknown[] }>}
+ */
+function render(input, options, callback) {
+  if (typeof options === 'function') {
+    callback = options;
+    options = {};
+  }
+  options = options || {};
+  const promise = (async () => {
+    const { configOptions } = createLessOptions(options);
+    // ponytail: fresh Compiler per call — no defaultPlugins hook, so no
+    // node-modules import plugin and no @jesscss/plugin-js. Single-file preview
+    // rarely re-renders in a hot loop; a cache map is not worth the surface.
+    const compiler = new Compiler(configOptions);
+    const result = await compiler.renderToResult(
+      { source: input, language: 'less', extension: '.less' },
+      { ...configOptions, suppressWarnings: true }
+    );
+    if (result.errors?.length) {
+      throw createRenderError(result);
+    }
+    return mapRenderResult(result, options);
+  })();
+  if (typeof callback === 'function') {
+    promise.then((result) => callback(null, result), (error) => callback(error));
+  }
+  return promise;
+}
+
+const less = {
+  version: versionArray,
+  render,
+};
+
+export default less;
+export { render, versionArray as version };

package/lib/lessc-helper.js

@@ -38,6 +38,8 @@ const lesscHelper = {
     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('  --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('');
     console.log('This release intentionally supports a smaller CLI surface.');
     console.log('Source maps, browser compilation, legacy plugin flags, lint-only mode, and');

package/lib/options.js

@@ -5,6 +5,7 @@
 
 import lessPlugin from '@jesscss/plugin-less';
 import { lessCompatPlugin } from '@jesscss/plugin-less-compat';
+import { logger } from './logger.js';
 
 const unsupportedAlphaOptions = new Map([
   ['sourceMap', 'source maps are not supported'],
@@ -15,7 +16,6 @@ const unsupportedAlphaOptions = new Map([
   ['sourceMapFileInline', 'source maps are not supported'],
   ['globalVars', 'global variable injection is not supported'],
   ['modifyVars', 'modify-var injection is not supported'],
-  ['strictUnits', 'strict unit mode is not supported'],
   ['rootpath', 'URL rootpath rewriting is not supported'],
   ['rewriteUrls', 'URL rewriting is not supported'],
   ['urlArgs', 'URL argument rewriting is not supported'],
@@ -25,7 +25,9 @@ const unsupportedAlphaOptions = new Map([
 
 function validateAlphaOptions(options) {
   for (const [name, reason] of unsupportedAlphaOptions) {
-    if (Object.prototype.hasOwnProperty.call(options, name)) {
+    // A falsy value is the 4.x default ("off") and requests nothing, so it is
+    // a no-op here; only an actual request for the feature is unsupported.
+    if (options[name]) {
       throw new Error(`${name} is not supported: ${reason}`);
     }
   }
@@ -81,6 +83,21 @@ export function createLessOptions(options) {
     math === 2 || math === 'parens' || math === 'strict' ? 'parens' :
     'parens-division';
 
+  // `unitMode` is the option ('loose' | 'preserve' | 'strict'); `strictUnits`
+  // is its deprecated boolean alias: true → 'strict'; false means "not strict",
+  // i.e. the default ('preserve') — never the Less 4.x 'loose' fold, which only
+  // an explicit `unitMode: 'loose'` selects. Any use warns so the mapping is
+  // never discovered by staring at output. Left unset so the compiler default applies.
+  const unitMode = opts.unitMode !== undefined ? opts.unitMode
+    : opts.strictUnits === true ? 'strict'
+    : undefined;
+  if (opts.strictUnits !== undefined && opts.unitMode === undefined) {
+    logger.warn(
+      `strictUnits is deprecated; use unitMode. strictUnits: ${String(opts.strictUnits)} now means `
+      + `unitMode: '${unitMode ?? 'preserve'}'${opts.strictUnits ? '' : " (Less 4.x unit folding is unitMode: 'loose')"}`
+    );
+  }
+
   const plugins = [lessPlugin()];
   if (!skipLessCompat) {
     plugins.push(lessCompatPlugin({ plugins: lessPlugins }));
@@ -90,6 +107,7 @@ export function createLessOptions(options) {
     compile: {
       searchPaths: opts.paths || [],
       mathMode,
+      ...(unitMode !== undefined && { unitMode }),
       plugins,
     },
     // Less v5 preserves authored nesting unless its explicit compatibility

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "less",
-	"version": "5.0.0-alpha.2",
+	"version": "5.0.0-alpha.4",
 	"description": "Leaner CSS",
 	"homepage": "http://lesscss.org",
 	"author": {
@@ -63,9 +63,10 @@
 		"lint:fix": "eslint '**/*.{ts,js}' --fix",
 		"typecheck": "tsc --noEmit",
 		"build": "node build/rollup.js --dist",
+		"build:browser": "node build/browser-dev.mjs --minify",
 		"benchmark": "node benchmark/benchmark-runner.cjs",
 		"benchmark:all": "node benchmark/run-and-compare.mjs",
-		"prepublishOnly": "npm run typecheck && npm run build && npm run test:lessc"
+		"prepublishOnly": "npm run typecheck && npm run build && npm run build:browser && npm run test:lessc"
 	},
 	"devDependencies": {
 		"@less/test-data": "workspace:*",
@@ -83,6 +84,7 @@
 		"chalk": "^4.1.2",
 		"cosmiconfig": "~9.0.0",
 		"cross-env": "^7.0.3",
+		"esbuild": "^0.25.0",
 		"eslint": "^7.29.0",
 		"fs-extra": "^8.1.0",
 		"glob": "~11.0.3",
@@ -139,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.15",
-		"@jesscss/core": "2.0.0-alpha.15",
-		"@jesscss/plugin-less": "2.0.0-alpha.15",
-		"@jesscss/plugin-less-compat": "2.0.0-alpha.15",
-		"@jesscss/plugin-node-modules": "2.0.0-alpha.15",
+		"@jesscss/compiler": "2.0.0-alpha.17",
+		"@jesscss/core": "2.0.0-alpha.17",
+		"@jesscss/plugin-less": "2.0.0-alpha.17",
+		"@jesscss/plugin-less-compat": "2.0.0-alpha.17",
+		"@jesscss/plugin-node-modules": "2.0.0-alpha.17",
 		"parse-node-version": "^1.0.1"
 	},
 	"peerDependencies": {
-		"@jesscss/plugin-js": "2.0.0-alpha.15"
+		"@jesscss/plugin-js": "2.0.0-alpha.17"
 	},
 	"peerDependenciesMeta": {
 		"@jesscss/plugin-js": {