@jesscss/plugin-less 2.0.0-alpha.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Matthew Dean
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# @jesscss/plugin-less
+
+**The Less language engine for Jess — the Less parser wired in with Less v5
+rendering defaults.**
+
+This is the Less language engine behind the shipping alpha surface.
+`plugin-less` layers the Less grammar (`@jesscss/less-parser`) onto the Jess
+compiler, registers the Less built-in functions (`@jesscss/fns`), and sets the
+current output defaults. The `jess` CLI loads it by default, so if you render
+`.less` you are already using it — you don't need to install this package
+separately for normal CLI use.
+
+## What it does
+
+- Parses `.less` into the Jess AST and hands it to the engine for a single
+  evaluate-and-emit pass.
+- Registers the Less/Sass style-function library so `lighten()`, `percentage()`,
+  string and list helpers, etc. are available during evaluation.
+- Owns the current Less-facing output defaults used across the alpha surface.
+
+## Current output defaults
+
+The defaults this plugin applies:
+
+- `collapseNesting: false` — **nesting is preserved by default.** Less 4.x
+  flattened selectors; in v5 that flattening is an explicit opt-in
+  (`--collapse-nesting` on the CLI).
+- `mathMode: 'parens-division'`, `unitMode: 'preserve'`, `equalityMode: 'less'`,
+  `leakyScope: true`, `bubbleRootAtRules: true`.
+
+These keep the current Less-facing surface aligned on one set of output
+semantics.
+
+## Status
+
+**Alpha.** This is the shipping Less-facing engine in the current Jess alpha. It
+renders real Less, but it is early software with known rendering gaps and
+expected failures; don't ship it to production yet, and please
+[report bugs](https://github.com/jesscss/jess/issues).
+
+The programmatic plugin/compiler API is **not yet stabilized** — the `jess` CLI
+is the documented public surface for the alpha. Watch the
+[docs site](https://jesscss.github.io/) for the API once it settles.
+
+- Project overview & positioning: <https://github.com/jesscss/jess#readme>
+- Docs: <https://jesscss.github.io/> (currently pre-alpha content)
+- Issues: <https://github.com/jesscss/jess/issues>
+- License: MIT

package/lib/index.cjs

@@ -0,0 +1,237 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let _jesscss_core = require("@jesscss/core");
+let _jesscss_fns_less_registry = require("@jesscss/fns/less/registry");
+let _jesscss_plugin_less_compat = require("@jesscss/plugin-less-compat");
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+let node_module = require("node:module");
+let _jesscss_style_resolver = require("@jesscss/style-resolver");
+let _jesscss_less_parser = require("@jesscss/less-parser");
+//#region src/index.ts
+/**
+* The Less plugin's default option values — the single source of truth for the
+* v5 defaults. The `LessPlugin` constructor fills any unset option from here,
+* and the `lessc` CLI imports the same object so its defaults can never drift
+* from the engine's. Note `collapseNesting: false` — v5 preserves nesting by
+* default (Less 4.x flattened; that is now an explicit opt-in).
+*/
+const lessPluginDefaults = {
+	mathMode: "parens-division",
+	unitMode: "preserve",
+	equalityMode: "less",
+	leakyScope: true,
+	bubbleRootAtRules: true,
+	processImports: true,
+	collapseNesting: false
+};
+const lessValueEvaluator = (0, _jesscss_core.buildEvaluator)((0, _jesscss_fns_less_registry.makeLessRegistry)());
+/** Match Less's URL normalization without treating URL text as an import path. */
+function normalizeUrlPath(url) {
+	const segments = url.split("/");
+	const normalized = [];
+	for (const segment of segments) {
+		if (segment === ".") continue;
+		if (segment === "..") {
+			if (normalized.length === 0 || normalized[normalized.length - 1] === "..") normalized.push(segment);
+			else normalized.pop();
+			continue;
+		}
+		normalized.push(segment);
+	}
+	return normalized.join("/");
+}
+function isUrlRelative(url) {
+	if (url.startsWith("/") || url.startsWith("#")) return false;
+	const colon = url.indexOf(":");
+	if (colon < 0) return true;
+	for (let index = 0; index < colon; index++) {
+		const code = url.charCodeAt(index);
+		if (!(code >= 65 && code <= 90 || code >= 97 && code <= 122) && url[index] !== "-") return true;
+	}
+	return false;
+}
+function rewriteUrlPath(url, rootpath) {
+	const rewritten = normalizeUrlPath(rootpath + url);
+	return url.startsWith(".") && isUrlRelative(rootpath) && !rewritten.startsWith(".") ? `./${rewritten}` : rewritten;
+}
+function escapeUnquotedUrlPath(pathValue) {
+	let escaped = "";
+	for (const char of pathValue) escaped += char === "(" || char === ")" || char === "'" || char === "\"" || " 	\n\r\f".includes(char) ? `\\${char}` : char;
+	return escaped;
+}
+function jsDelivrPackageSpecifier(candidate) {
+	const absolute = candidate.match(/^https?:\/\/cdn\.jsdelivr\.net\/npm\/([^?#]+)(?:[?#].*)?$/i);
+	if (absolute?.[1]) return absolute[1];
+	return candidate.match(/^\/\/cdn\.jsdelivr\.net\/npm\/([^?#]+)(?:[?#].*)?$/i)?.[1] ?? null;
+}
+var LessPlugin = class extends _jesscss_core.AbstractPlugin {
+	name = "less";
+	supportedExtensions = [".less"];
+	mathMode;
+	unitMode;
+	equalityMode;
+	leakyScope;
+	bubbleRootAtRules;
+	processImports;
+	collapseNesting;
+	pluginHosts = /* @__PURE__ */ new WeakMap();
+	constructor(opts = {}) {
+		super();
+		this.opts = opts;
+		let mathMode;
+		if (opts.mathMode !== void 0) mathMode = opts.mathMode;
+		else if (opts.math !== void 0) if (opts.math === 0 || opts.math === "always") mathMode = "always";
+		else if (opts.math === 1 || opts.math === "parens-division") mathMode = "parens-division";
+		else if (opts.math === 2 || opts.math === "parens" || opts.math === "strict") mathMode = "parens";
+		else mathMode = "parens";
+		else mathMode = lessPluginDefaults.mathMode;
+		this.mathMode = mathMode;
+		let unitMode;
+		if (opts.unitMode !== void 0) unitMode = opts.unitMode;
+		else if (opts.strictUnits === true) unitMode = "strict";
+		else unitMode = lessPluginDefaults.unitMode;
+		this.unitMode = unitMode;
+		this.equalityMode = opts.equalityMode ?? lessPluginDefaults.equalityMode;
+		this.leakyScope = opts.leakyScope ?? lessPluginDefaults.leakyScope;
+		this.bubbleRootAtRules = opts.bubbleRootAtRules ?? lessPluginDefaults.bubbleRootAtRules;
+		this.processImports = opts.processImports ?? lessPluginDefaults.processImports;
+		this.collapseNesting = opts.collapseNesting ?? lessPluginDefaults.collapseNesting;
+	}
+	transformUrl({ value, quoted, fromFilePath, entryFilePath }) {
+		let transformed;
+		if (isUrlRelative(value)) {
+			const rewriteUrls = this.opts.rewriteUrls;
+			const local = value.startsWith(".");
+			if (rewriteUrls !== "local" || local) {
+				const rebasesImportedUrl = rewriteUrls === true || rewriteUrls === "all" || rewriteUrls === "local" && local;
+				let rootpath = this.opts.rootpath ?? "";
+				if (!quoted) rootpath = escapeUnquotedUrlPath(rootpath);
+				if (rebasesImportedUrl && fromFilePath && entryFilePath) {
+					const relativeDirectory = node_path.default.relative(node_path.default.dirname(entryFilePath), node_path.default.dirname(fromFilePath));
+					if (relativeDirectory) rootpath += `${relativeDirectory.split(node_path.default.sep).join("/")}/`;
+				}
+				transformed = rewriteUrlPath(value, rootpath);
+			} else transformed = normalizeUrlPath(value);
+		} else transformed = normalizeUrlPath(value);
+		if (this.opts.urlArgs && !value.trimStart().toLowerCase().startsWith("data:")) {
+			const args = `${transformed.includes("?") ? "&" : "?"}${this.opts.urlArgs}`;
+			const fragment = transformed.indexOf("#");
+			transformed = fragment < 0 ? transformed + args : transformed.slice(0, fragment) + args + transformed.slice(fragment);
+		}
+		return transformed;
+	}
+	expandImport(importPath, currentDir) {
+		return (0, _jesscss_style_resolver.expandLessImportCandidates)(importPath);
+	}
+	setContext(context) {
+		if (context.documentContext?.plugin !== this) return;
+		if (context.opts.mathMode === void 0) context.setOption("mathMode", this.mathMode);
+		if (context.opts.unitMode === void 0) context.setOption("unitMode", this.unitMode);
+		if (context.opts.equalityMode === void 0) context.setOption("equalityMode", this.equalityMode);
+		if (context.opts.leakyScope === void 0) context.setOption("leakyScope", this.leakyScope);
+		if (context.opts.bubbleRootAtRules === void 0) context.setOption("bubbleRootAtRules", this.bubbleRootAtRules);
+		if (context.opts.processImports === void 0) context.setOption("processImports", this.processImports);
+		context.registerValueEvaluator(lessValueEvaluator);
+		let host = this.pluginHosts.get(context);
+		if (!host) {
+			host = new _jesscss_plugin_less_compat.LessApiBridge(this.opts.plugins ?? []).createPluginHost({ loadPluginModule: async ({ specifier, options }) => {
+				if (context.opts.disableScriptModules || context.opts.disablePluginRule) throw _jesscss_core.ERR.pluginLoadFailed({
+					meta: {
+						specifier,
+						reason: "script module execution is disabled by disableScriptModules"
+					},
+					reason: `"@plugin \\"${specifier}\\"" loads and executes a script module, which this compile disabled.`,
+					fix: "Remove the @plugin statement, or stop setting disableScriptModules for this compile."
+				});
+				return (await context.getPluginModule(specifier, options)).module;
+			} });
+			this.pluginHosts.set(context, host);
+		}
+		const existingHost = context.pluginHost;
+		const globalFns = [...existingHost?.globalFns ?? [], ...host.globalFns ?? []];
+		context.pluginHost = {
+			...existingHost,
+			...host,
+			...globalFns.length === 0 ? {} : { globalFns },
+			loadPlugin: host.loadPlugin || existingHost?.loadPlugin ? (request) => Promise.all([existingHost?.loadPlugin?.(request) ?? [], host.loadPlugin?.(request) ?? []]).then(([existingFns, hostFns]) => [...existingFns, ...hostFns]) : void 0,
+			invokeRawFunction: (fn, args, ctx) => host.invokeRawFunction?.(fn, args, ctx) ?? existingHost?.invokeRawFunction?.(fn, args, ctx)
+		};
+	}
+	resolve(filePath, currentDir, searchPaths) {
+		const mapped = (Array.isArray(filePath) ? filePath : [filePath]).map((candidate) => {
+			if (candidate.startsWith("@less/test-import-module/")) {
+				const after = candidate.slice(25);
+				const marker = `${node_path.default.sep}packages${node_path.default.sep}test-data${node_path.default.sep}`;
+				const idx = currentDir.indexOf(marker);
+				if (idx !== -1) {
+					const packagesRoot = currentDir.slice(0, idx + `${node_path.default.sep}packages`.length);
+					return node_path.default.join(packagesRoot, "test-import-module", after);
+				}
+			}
+			return jsDelivrPackageSpecifier(candidate) ?? candidate;
+		});
+		const out = [...super.resolve(mapped, currentDir, searchPaths)];
+		const bases = [
+			currentDir,
+			...searchPaths,
+			process.cwd()
+		];
+		const looksBareSpecifier = (p) => !node_path.default.isAbsolute(p) && !p.startsWith("./") && !p.startsWith("../") && !p.startsWith("/") && !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(p);
+		for (const candidate of mapped) {
+			if (!looksBareSpecifier(candidate)) continue;
+			for (const base of bases) {
+				const baseDir = node_path.default.isAbsolute(base) ? base : node_path.default.resolve(currentDir, base);
+				try {
+					const resolvedModule = (0, node_module.createRequire)(node_path.default.join(baseDir, "__jess_resolve__.js")).resolve(candidate);
+					if (!out.includes(resolvedModule)) out.push(resolvedModule);
+					break;
+				} catch {
+					try {
+						const resolvedModuleLess = (0, node_module.createRequire)(node_path.default.join(baseDir, "__jess_resolve__.js")).resolve(`${candidate}.less`);
+						if (!out.includes(resolvedModuleLess)) out.push(resolvedModuleLess);
+						break;
+					} catch {}
+				}
+			}
+		}
+		return out;
+	}
+	canResolveImport(specifier) {
+		return jsDelivrPackageSpecifier(specifier) !== null;
+	}
+	safeParse(filePath, source, parseOptions) {
+		return (0, _jesscss_less_parser.safeParse)(filePath, source);
+	}
+};
+const lessPlugin = ((opts) => {
+	return new LessPlugin(opts);
+});
+//#endregion
+exports.LessPlugin = LessPlugin;
+exports.default = lessPlugin;
+exports.lessPluginDefaults = lessPluginDefaults;

package/lib/index.d.ts

@@ -0,0 +1,42 @@
+import { AbstractPlugin, Context, type UrlTransformRequest, type ISafeParseResult, type SafeParseOptions } from '@jesscss/core';
+import type { EqualityMode, MathMode, UnitMode, LessOptions } from 'styles-config';
+export type LessPluginOptions = LessOptions;
+/**
+ * The Less plugin's default option values — the single source of truth for the
+ * v5 defaults. The `LessPlugin` constructor fills any unset option from here,
+ * and the `lessc` CLI imports the same object so its defaults can never drift
+ * from the engine's. Note `collapseNesting: false` — v5 preserves nesting by
+ * default (Less 4.x flattened; that is now an explicit opt-in).
+ */
+export declare const lessPluginDefaults: {
+    readonly mathMode: MathMode;
+    readonly unitMode: UnitMode;
+    readonly equalityMode: EqualityMode;
+    readonly leakyScope: true;
+    readonly bubbleRootAtRules: true;
+    readonly processImports: true;
+    readonly collapseNesting: false;
+};
+export declare class LessPlugin extends AbstractPlugin {
+    opts: LessPluginOptions;
+    name: string;
+    supportedExtensions: string[];
+    mathMode: MathMode;
+    unitMode: UnitMode;
+    equalityMode: EqualityMode;
+    leakyScope: boolean;
+    bubbleRootAtRules: boolean;
+    processImports: boolean;
+    collapseNesting: boolean;
+    private readonly pluginHosts;
+    constructor(opts?: LessPluginOptions);
+    transformUrl({ value, quoted, fromFilePath, entryFilePath }: UrlTransformRequest): string;
+    expandImport(importPath: string, currentDir: string): string[];
+    setContext(context: Context): void;
+    resolve(filePath: string | string[], currentDir: string, searchPaths: string[]): string[];
+    canResolveImport(specifier: string): boolean;
+    safeParse(filePath: string, source: string, parseOptions?: SafeParseOptions): ISafeParseResult;
+}
+export type { LessOptions } from 'styles-config';
+declare const lessPlugin: (opts?: LessPluginOptions) => LessPlugin;
+export default lessPlugin;

package/lib/index.js

@@ -0,0 +1,208 @@
+import { createRequire } from "node:module";
+import { AbstractPlugin, ERR, buildEvaluator } from "@jesscss/core";
+import { makeLessRegistry } from "@jesscss/fns/less/registry";
+import { LessApiBridge } from "@jesscss/plugin-less-compat";
+import path from "node:path";
+import { expandLessImportCandidates } from "@jesscss/style-resolver";
+import { safeParse } from "@jesscss/less-parser";
+//#region src/index.ts
+/**
+* The Less plugin's default option values — the single source of truth for the
+* v5 defaults. The `LessPlugin` constructor fills any unset option from here,
+* and the `lessc` CLI imports the same object so its defaults can never drift
+* from the engine's. Note `collapseNesting: false` — v5 preserves nesting by
+* default (Less 4.x flattened; that is now an explicit opt-in).
+*/
+const lessPluginDefaults = {
+	mathMode: "parens-division",
+	unitMode: "preserve",
+	equalityMode: "less",
+	leakyScope: true,
+	bubbleRootAtRules: true,
+	processImports: true,
+	collapseNesting: false
+};
+const lessValueEvaluator = buildEvaluator(makeLessRegistry());
+/** Match Less's URL normalization without treating URL text as an import path. */
+function normalizeUrlPath(url) {
+	const segments = url.split("/");
+	const normalized = [];
+	for (const segment of segments) {
+		if (segment === ".") continue;
+		if (segment === "..") {
+			if (normalized.length === 0 || normalized[normalized.length - 1] === "..") normalized.push(segment);
+			else normalized.pop();
+			continue;
+		}
+		normalized.push(segment);
+	}
+	return normalized.join("/");
+}
+function isUrlRelative(url) {
+	if (url.startsWith("/") || url.startsWith("#")) return false;
+	const colon = url.indexOf(":");
+	if (colon < 0) return true;
+	for (let index = 0; index < colon; index++) {
+		const code = url.charCodeAt(index);
+		if (!(code >= 65 && code <= 90 || code >= 97 && code <= 122) && url[index] !== "-") return true;
+	}
+	return false;
+}
+function rewriteUrlPath(url, rootpath) {
+	const rewritten = normalizeUrlPath(rootpath + url);
+	return url.startsWith(".") && isUrlRelative(rootpath) && !rewritten.startsWith(".") ? `./${rewritten}` : rewritten;
+}
+function escapeUnquotedUrlPath(pathValue) {
+	let escaped = "";
+	for (const char of pathValue) escaped += char === "(" || char === ")" || char === "'" || char === "\"" || " 	\n\r\f".includes(char) ? `\\${char}` : char;
+	return escaped;
+}
+function jsDelivrPackageSpecifier(candidate) {
+	const absolute = candidate.match(/^https?:\/\/cdn\.jsdelivr\.net\/npm\/([^?#]+)(?:[?#].*)?$/i);
+	if (absolute?.[1]) return absolute[1];
+	return candidate.match(/^\/\/cdn\.jsdelivr\.net\/npm\/([^?#]+)(?:[?#].*)?$/i)?.[1] ?? null;
+}
+var LessPlugin = class extends AbstractPlugin {
+	name = "less";
+	supportedExtensions = [".less"];
+	mathMode;
+	unitMode;
+	equalityMode;
+	leakyScope;
+	bubbleRootAtRules;
+	processImports;
+	collapseNesting;
+	pluginHosts = /* @__PURE__ */ new WeakMap();
+	constructor(opts = {}) {
+		super();
+		this.opts = opts;
+		let mathMode;
+		if (opts.mathMode !== void 0) mathMode = opts.mathMode;
+		else if (opts.math !== void 0) if (opts.math === 0 || opts.math === "always") mathMode = "always";
+		else if (opts.math === 1 || opts.math === "parens-division") mathMode = "parens-division";
+		else if (opts.math === 2 || opts.math === "parens" || opts.math === "strict") mathMode = "parens";
+		else mathMode = "parens";
+		else mathMode = lessPluginDefaults.mathMode;
+		this.mathMode = mathMode;
+		let unitMode;
+		if (opts.unitMode !== void 0) unitMode = opts.unitMode;
+		else if (opts.strictUnits === true) unitMode = "strict";
+		else unitMode = lessPluginDefaults.unitMode;
+		this.unitMode = unitMode;
+		this.equalityMode = opts.equalityMode ?? lessPluginDefaults.equalityMode;
+		this.leakyScope = opts.leakyScope ?? lessPluginDefaults.leakyScope;
+		this.bubbleRootAtRules = opts.bubbleRootAtRules ?? lessPluginDefaults.bubbleRootAtRules;
+		this.processImports = opts.processImports ?? lessPluginDefaults.processImports;
+		this.collapseNesting = opts.collapseNesting ?? lessPluginDefaults.collapseNesting;
+	}
+	transformUrl({ value, quoted, fromFilePath, entryFilePath }) {
+		let transformed;
+		if (isUrlRelative(value)) {
+			const rewriteUrls = this.opts.rewriteUrls;
+			const local = value.startsWith(".");
+			if (rewriteUrls !== "local" || local) {
+				const rebasesImportedUrl = rewriteUrls === true || rewriteUrls === "all" || rewriteUrls === "local" && local;
+				let rootpath = this.opts.rootpath ?? "";
+				if (!quoted) rootpath = escapeUnquotedUrlPath(rootpath);
+				if (rebasesImportedUrl && fromFilePath && entryFilePath) {
+					const relativeDirectory = path.relative(path.dirname(entryFilePath), path.dirname(fromFilePath));
+					if (relativeDirectory) rootpath += `${relativeDirectory.split(path.sep).join("/")}/`;
+				}
+				transformed = rewriteUrlPath(value, rootpath);
+			} else transformed = normalizeUrlPath(value);
+		} else transformed = normalizeUrlPath(value);
+		if (this.opts.urlArgs && !value.trimStart().toLowerCase().startsWith("data:")) {
+			const args = `${transformed.includes("?") ? "&" : "?"}${this.opts.urlArgs}`;
+			const fragment = transformed.indexOf("#");
+			transformed = fragment < 0 ? transformed + args : transformed.slice(0, fragment) + args + transformed.slice(fragment);
+		}
+		return transformed;
+	}
+	expandImport(importPath, currentDir) {
+		return expandLessImportCandidates(importPath);
+	}
+	setContext(context) {
+		if (context.documentContext?.plugin !== this) return;
+		if (context.opts.mathMode === void 0) context.setOption("mathMode", this.mathMode);
+		if (context.opts.unitMode === void 0) context.setOption("unitMode", this.unitMode);
+		if (context.opts.equalityMode === void 0) context.setOption("equalityMode", this.equalityMode);
+		if (context.opts.leakyScope === void 0) context.setOption("leakyScope", this.leakyScope);
+		if (context.opts.bubbleRootAtRules === void 0) context.setOption("bubbleRootAtRules", this.bubbleRootAtRules);
+		if (context.opts.processImports === void 0) context.setOption("processImports", this.processImports);
+		context.registerValueEvaluator(lessValueEvaluator);
+		let host = this.pluginHosts.get(context);
+		if (!host) {
+			host = new LessApiBridge(this.opts.plugins ?? []).createPluginHost({ loadPluginModule: async ({ specifier, options }) => {
+				if (context.opts.disableScriptModules || context.opts.disablePluginRule) throw ERR.pluginLoadFailed({
+					meta: {
+						specifier,
+						reason: "script module execution is disabled by disableScriptModules"
+					},
+					reason: `"@plugin \\"${specifier}\\"" loads and executes a script module, which this compile disabled.`,
+					fix: "Remove the @plugin statement, or stop setting disableScriptModules for this compile."
+				});
+				return (await context.getPluginModule(specifier, options)).module;
+			} });
+			this.pluginHosts.set(context, host);
+		}
+		const existingHost = context.pluginHost;
+		const globalFns = [...existingHost?.globalFns ?? [], ...host.globalFns ?? []];
+		context.pluginHost = {
+			...existingHost,
+			...host,
+			...globalFns.length === 0 ? {} : { globalFns },
+			loadPlugin: host.loadPlugin || existingHost?.loadPlugin ? (request) => Promise.all([existingHost?.loadPlugin?.(request) ?? [], host.loadPlugin?.(request) ?? []]).then(([existingFns, hostFns]) => [...existingFns, ...hostFns]) : void 0,
+			invokeRawFunction: (fn, args, ctx) => host.invokeRawFunction?.(fn, args, ctx) ?? existingHost?.invokeRawFunction?.(fn, args, ctx)
+		};
+	}
+	resolve(filePath, currentDir, searchPaths) {
+		const mapped = (Array.isArray(filePath) ? filePath : [filePath]).map((candidate) => {
+			if (candidate.startsWith("@less/test-import-module/")) {
+				const after = candidate.slice(25);
+				const marker = `${path.sep}packages${path.sep}test-data${path.sep}`;
+				const idx = currentDir.indexOf(marker);
+				if (idx !== -1) {
+					const packagesRoot = currentDir.slice(0, idx + `${path.sep}packages`.length);
+					return path.join(packagesRoot, "test-import-module", after);
+				}
+			}
+			return jsDelivrPackageSpecifier(candidate) ?? candidate;
+		});
+		const out = [...super.resolve(mapped, currentDir, searchPaths)];
+		const bases = [
+			currentDir,
+			...searchPaths,
+			process.cwd()
+		];
+		const looksBareSpecifier = (p) => !path.isAbsolute(p) && !p.startsWith("./") && !p.startsWith("../") && !p.startsWith("/") && !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(p);
+		for (const candidate of mapped) {
+			if (!looksBareSpecifier(candidate)) continue;
+			for (const base of bases) {
+				const baseDir = path.isAbsolute(base) ? base : path.resolve(currentDir, base);
+				try {
+					const resolvedModule = createRequire(path.join(baseDir, "__jess_resolve__.js")).resolve(candidate);
+					if (!out.includes(resolvedModule)) out.push(resolvedModule);
+					break;
+				} catch {
+					try {
+						const resolvedModuleLess = createRequire(path.join(baseDir, "__jess_resolve__.js")).resolve(`${candidate}.less`);
+						if (!out.includes(resolvedModuleLess)) out.push(resolvedModuleLess);
+						break;
+					} catch {}
+				}
+			}
+		}
+		return out;
+	}
+	canResolveImport(specifier) {
+		return jsDelivrPackageSpecifier(specifier) !== null;
+	}
+	safeParse(filePath, source, parseOptions) {
+		return safeParse(filePath, source);
+	}
+};
+const lessPlugin = ((opts) => {
+	return new LessPlugin(opts);
+});
+//#endregion
+export { LessPlugin, lessPlugin as default, lessPluginDefaults };

package/lib/options.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @deprecated Import LessOptions from 'styles-config' instead.
+ * This type is kept for backward compatibility but will be removed in a future version.
+ */
+export type { LessOptions } from 'styles-config';

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@jesscss/plugin-less",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "A Less stylesheet engine for Jess",
+  "version": "2.0.0-alpha.10",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "main": "lib/index.cjs",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "require": "./lib/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "dependencies": {
+    "@jesscss/fns": "2.0.0-alpha.10",
+    "@jesscss/less-parser": "2.0.0-alpha.10",
+    "@jesscss/plugin-less-compat": "2.0.0-alpha.10",
+    "@jesscss/core": "2.0.0-alpha.10",
+    "@jesscss/style-resolver": "2.0.0-alpha.10",
+    "styles-config": "2.0.0-alpha.10"
+  },
+  "devDependencies": {},
+  "author": "Matthew Dean <matthew-dean@users.noreply.github.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/jesscss/jess/issues"
+  },
+  "homepage": "https://github.com/jesscss/jess#readme",
+  "module": "lib/index.js",
+  "scripts": {
+    "ci": "pnpm build && pnpm test",
+    "build": "pnpm compile",
+    "compile": "tsdown --tsconfig tsconfig.build.json --no-dts && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "test": "vitest --run --passWithNoTests",
+    "lint:fix": "eslint --fix '**/*.{js,ts}'",
+    "lint": "eslint '**/*.{js,ts}'"
+  }
+}