less 4.5.1 → 4.6.1

package/README.md

@@ -1,13 +1,78 @@
-# [Less.js](http://lesscss.org)
+<p align="center"><img src="http://lesscss.org/public/img/less_logo.png" width="264" height="117" alt="Less.js logo"></p>
 
-> The **dynamic** stylesheet language. [http://lesscss.org](http://lesscss.org).
+<p align="center">
+    <a href="https://github.com/less/less.js/actions?query=branch%3Amaster"><img src="https://github.com/less/less.js/actions/workflows/ci.yml/badge.svg?branch=master" alt="Github Actions CI"/></a>
+    <a href="https://www.npmtrends.com/less"><img src="https://img.shields.io/npm/dm/less.svg?sanitize=true" alt="Downloads"></a>
+    <a href="https://www.npmjs.com/package/less"><img src="https://img.shields.io/npm/v/less.svg?sanitize=true" alt="npm version" /></a>
+</p>
 
-This is the JavaScript, official, stable version of Less.
+# Less.js
 
+> The dynamic stylesheet language. [lesscss.org](http://lesscss.org)
 
-## Getting Started
+Less extends CSS with variables, mixins, functions, nesting, and more — then compiles to standard CSS. Write cleaner stylesheets with less code.
+
+```less
+@primary: #4a90d9;
+
+.button {
+  color: @primary;
+  &:hover {
+    color: darken(@primary, 10%);
+  }
+}
+```
+
+## Install
 
-Add Less.js to your project:
 ```sh
 npm install less
 ```
+
+## Usage
+
+### Node.js
+
+```js
+import less from 'less';
+
+const output = await less.render('.class { width: (1 + 1) }');
+console.log(output.css);
+```
+
+### Command Line
+
+```sh
+npx lessc styles.less styles.css
+```
+
+### Browser
+
+```html
+<link rel="stylesheet/less" type="text/css" href="styles.less" />
+<script src="https://cdn.jsdelivr.net/npm/less"></script>
+```
+
+## Why Less?
+
+- **Variables** — define reusable values once
+- **Mixins** — reuse groups of declarations across rulesets
+- **Nesting** — mirror HTML structure in your stylesheets
+- **Functions** — transform colors, manipulate strings, do math
+- **Imports** — split stylesheets into manageable pieces
+- **Extend** — reduce output size by combining selectors
+
+## Documentation
+
+Full documentation, usage guides, and configuration options at **[lesscss.org](http://lesscss.org)**.
+
+## Contributing
+
+Less.js is open source. [Report bugs](https://github.com/less/less.js/issues), submit pull requests, or help improve the [documentation](https://github.com/less/less-docs).
+
+See [CONTRIBUTING.md](https://github.com/less/less.js/blob/master/CONTRIBUTING.md) for development setup.
+
+## License
+
+Copyright (c) 2009-2025 [Alexis Sellier](http://cloudhead.io) & The Core Less Team
+Licensed under the [Apache License](https://github.com/less/less.js/blob/master/LICENSE).

package/bin/lessc

@@ -2,18 +2,17 @@
 
 /* eslint indent: [2, 2, {"SwitchCase": 1}] */
 
-'use strict';
+import path from 'path';
+import os from 'os';
+import { createRequire } from 'module';
+import fs from '../lib/less-node/fs.js';
+import * as utils from '../lib/less/utils.js';
+import * as Constants from '../lib/less/constants.js';
+import less from '../lib/less-node/index.js';
 
-var path = require('path');
-var fs = require('../lib/less-node/fs').default;
-var os = require('os');
-var utils = require('../lib/less/utils');
-var Constants = require('../lib/less/constants');
-
-var less = require('../lib/less-node').default;
+const require = createRequire(import.meta.url);
 
 var errno;
-var mkdirp;
 
 try {
   errno = require('errno');
@@ -65,6 +64,7 @@ var parseVariableOption = function parseVariableOption(option, variables) {
 };
 
 var sourceMapFileInline = false;
+var pendingDeprecations = [];
 
 function printUsage() {
   less.lesscHelper.printUsage();
@@ -107,22 +107,22 @@ function render() {
     }
 
     // Handle explicit sourceMapFullFilename (from --source-map=filename)
-    // Normalization of other options (sourceMapBasepath, sourceMapRootpath, etc.) 
+    // Normalization of other options (sourceMapBasepath, sourceMapRootpath, etc.)
     // is handled automatically in parse-tree.js
     if (sourceMapOptions.sourceMapFullFilename && !sourceMapFileInline) {
       var mapFilename = path.resolve(process.cwd(), sourceMapOptions.sourceMapFullFilename);
       var mapDir = path.dirname(mapFilename);
-      
+
       if (output) {
         var outputDir = path.dirname(output);
         // Set sourceMapOutputFilename relative to map directory
         sourceMapOptions.sourceMapOutputFilename = path.join(
-          path.relative(mapDir, outputDir), 
+          path.relative(mapDir, outputDir),
           path.basename(output)
         );
         // Set sourceMapFilename relative to output directory (for sourceMappingURL comment)
         sourceMapOptions.sourceMapFilename = path.join(
-          path.relative(outputDir, mapDir), 
+          path.relative(outputDir, mapDir),
           path.basename(sourceMapOptions.sourceMapFullFilename)
         );
       } else {
@@ -150,6 +150,7 @@ function render() {
     return;
   }
 
+  var mkdirp;
   var ensureDirectory = function ensureDirectory(filepath) {
     var dir = path.dirname(filepath);
     var cmd;
@@ -188,7 +189,7 @@ function render() {
 
       // To fix https://github.com/less/less.js/issues/3646
       output = output.toString();
-      
+
       fs.writeFile(filename, output, 'utf8', function (err) {
         if (err) {
           var description = 'Error: ';
@@ -403,11 +404,15 @@ function processPluginQueue() {
       case 'silent':
         options.silent = silent = true;
         break;
-      
+
       case 'quiet':
         options.quiet = quiet = true;
         break;
 
+      case 'quiet-deprecations':
+        options.quietDeprecations = true;
+        break;
+
       case 'l':
       case 'lint':
         options.lint = true;
@@ -453,6 +458,7 @@ function processPluginQueue() {
 
       case 'js':
         options.javascriptEnabled = true;
+        pendingDeprecations.push('Warning: Inline JavaScript (--js) is deprecated and will be removed in Less 5.x. Use Less functions or custom plugins instead. (js-eval)');
         break;
 
       case 'no-js':
@@ -476,6 +482,7 @@ function processPluginQueue() {
       case 'line-numbers':
         if (checkArgFunc(arg, match[2])) {
           options.dumpLineNumbers = match[2];
+          pendingDeprecations.push('Warning: The --line-numbers option is deprecated and will be removed in Less 5.x. Use source maps instead (--source-map). (dump-line-numbers)');
         }
 
         break;
@@ -532,13 +539,13 @@ function processPluginQueue() {
         }
 
         break;
-      
+
       case 'ie-compat':
-        console.warn('The --ie-compat option is deprecated, as it has no effect on compilation.');
+        pendingDeprecations.push('Warning: The --ie-compat option is deprecated, as it has no effect on compilation.');
         break;
 
       case 'relative-urls':
-        console.warn('The --relative-urls option has been deprecated. Use --rewrite-urls=all.');
+        pendingDeprecations.push('Warning: The --relative-urls option has been deprecated. Use --rewrite-urls=all.');
         options.rewriteUrls = Constants.RewriteUrls.ALL;
         break;
 
@@ -566,7 +573,7 @@ function processPluginQueue() {
 
       case 'sm':
       case 'strict-math':
-        console.warn('The --strict-math option has been deprecated. Use --math=strict.');
+        pendingDeprecations.push('Warning: The --strict-math option has been deprecated. Use --math=strict.');
 
         if (checkArgFunc(arg, match[2])) {
           if (checkBooleanArg(match[2])) {
@@ -581,14 +588,14 @@ function processPluginQueue() {
         let m = match[2];
         if (checkArgFunc(arg, m)) {
           if (m === 'always') {
-            console.warn('--math=always is deprecated and will be removed in the future.');
+            pendingDeprecations.push('Warning: --math=always is deprecated and will be removed in Less 5.x. Use --math=parens-division (default) or --math=parens. (math-always)');
             options.math = Constants.Math.ALWAYS;
           } else if (m === 'parens-division') {
             options.math = Constants.Math.PARENS_DIVISION;
           } else if (m === 'parens' || m === 'strict') {
             options.math = Constants.Math.PARENS;
           } else if (m === 'strict-legacy') {
-            console.warn('--math=strict-legacy has been removed. Defaulting to --math=strict');
+            pendingDeprecations.push('Warning: --math=strict-legacy has been removed. Defaulting to --math=strict.');
             options.math = Constants.Math.PARENS;
           }
         }
@@ -645,7 +652,7 @@ function processPluginQueue() {
       case 'disable-plugin-rule':
         options.disablePluginRule = true;
         break;
-  
+
       default:
         queuePlugins.push({
           name: arg,
@@ -656,9 +663,16 @@ function processPluginQueue() {
     }
   });
 
+  // Flush queued deprecation warnings (respects --silent, --quiet, --quiet-deprecations)
+  if (!silent && !quiet && !options.quietDeprecations) {
+    pendingDeprecations.forEach(function (msg) {
+      console.warn(msg);
+    });
+  }
+
   if (queuePlugins.length > 0) {
     processPluginQueue();
   } else {
     render();
   }
-})();
+})();