less 5.0.0-alpha.6 → 5.0.0-alpha.7

package/dist/less-node.cjs

@@ -1,5 +1,5 @@
 /**
- * Less - Leaner CSS v5.0.0-alpha.6
+ * Less - Leaner CSS v5.0.0-alpha.7
  * http://lesscss.org
  *
  * Copyright (c) 2009-2026, Alexis Sellier <self@cloudhead.net>
@@ -161,6 +161,25 @@ 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)}`
+  );
+}
+
 /**
  * Map Less render options to Jess compiler config.
  * @param {import('./options.js').LessRenderOptions} [options] Less-style options
@@ -207,14 +226,13 @@ 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 }]
+    // 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) }]
       : {},
     language: {},
   };
@@ -261,7 +279,7 @@ function mapRenderResult(result, options) {
  * @module less/lib/version
  */
 
-const semver = "5.0.0-alpha.6";
+const semver = "5.0.0-alpha.7";
 const parsed = parseNodeVersion__default["default"](`v${semver}`);
 
 const version = {

package/lib/options.d.ts

@@ -13,10 +13,14 @@ 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';
   /** @internal Jess alpha benchmark-only flag for source graphs already proven @plugin-free. */
   __jessSkipLessCompatWhenPluginFree?: boolean;
 }

package/lib/options.js

@@ -64,6 +64,25 @@ 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)}`
+  );
+}
+
 /**
  * Map Less render options to Jess compiler config.
  * @param {import('./options.js').LessRenderOptions} [options] Less-style options
@@ -110,14 +129,13 @@ 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 }]
+    // 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) }]
       : {},
     language: {},
   };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "less",
-	"version": "5.0.0-alpha.6",
+	"version": "5.0.0-alpha.7",
 	"description": "Leaner CSS",
 	"homepage": "http://lesscss.org",
 	"author": {