@jesscss/plugin-less 2.0.0-alpha.7 → 2.0.0-alpha.9

package/README.md

@@ -1,3 +1,48 @@
-# jess-plugin-less
+# @jesscss/plugin-less
 
-Provides the Less parser and evaluator to Jess.
+**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

@@ -25,14 +25,129 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 let _jesscss_core = require("@jesscss/core");
-let _jesscss_fns = require("@jesscss/fns");
-_jesscss_fns = __toESM(_jesscss_fns);
-let _jesscss_less_parser_jess = require("@jesscss/less-parser/jess");
+let _jesscss_core_value = require("@jesscss/core/value");
 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
+const nativeNil = () => {
+	const nil = {
+		type: "Nil",
+		value: "",
+		eval: () => nil
+	};
+	return nil;
+};
+function isRawSequence(value) {
+	return Array.isArray(value);
+}
+function isPluginDetached(value) {
+	return !isRawSequence(value) && value.type === "DetachedRuleset";
+}
+function toNativeLessValue(value) {
+	if (isRawSequence(value)) return {
+		type: "Expression",
+		value: value.map(toNativeLessValue),
+		valueOf: () => (0, _jesscss_core_value.emitValue)(value)
+	};
+	if (isPluginDetached(value)) {
+		const mixin = {
+			type: "Mixin",
+			name: nativeNil(),
+			args: nativeNil(),
+			ruleset: { rules: value.rules.map((rule) => ({
+				type: "Declaration",
+				name: rule.name,
+				value: toNativeLessValue(rule.value),
+				eval() {
+					return this;
+				}
+			})) },
+			eval() {
+				return mixin;
+			}
+		};
+		return mixin;
+	}
+	return toNativeValue(value);
+}
+function toNativeValue(value) {
+	switch (value.type) {
+		case "Dimension": return {
+			type: "Dimension",
+			value: value.number,
+			unit: value.unit,
+			valueOf: () => value.number
+		};
+		case "Quoted": return {
+			type: "Quoted",
+			value: value.value,
+			quote: value.quote,
+			escaped: value.escaped,
+			valueOf: () => value.bytes
+		};
+		case "Color": return {
+			type: "Color",
+			rgb: value.rgb,
+			alpha: value.alpha,
+			valueOf: () => value.bytes
+		};
+		case "List": return value.sep === "," || value.sep === "/" ? {
+			type: "Value",
+			value: value.value.map(toNativeLessValue),
+			separator: value.sep,
+			valueOf: () => value.bytes
+		} : {
+			type: "Anonymous",
+			value: value.bytes,
+			valueOf: () => value.bytes
+		};
+		default: return {
+			type: "Anonymous",
+			value: value.bytes,
+			valueOf: () => value.bytes
+		};
+	}
+}
+function isNativeValue(value) {
+	return value !== null && typeof value === "object" && "bytes" in value && typeof value.bytes === "string";
+}
+function fromNativeLessValue(value) {
+	if (isNativeValue(value)) return value;
+	if (typeof value === "number") return (0, _jesscss_core_value.makeDimension)(value);
+	if (typeof value === "string") return (0, _jesscss_core_value.makeKeyword)(value);
+	if (value && typeof value === "object") {
+		const candidate = value;
+		if ((candidate.type === "Dimension" || candidate.type === "Num") && typeof candidate.value === "number") return (0, _jesscss_core_value.makeDimension)(candidate.value, typeof candidate.unit === "string" ? candidate.unit : "");
+		if (candidate.type === "Quoted" && typeof candidate.value === "string") return (0, _jesscss_core_value.makeQuoted)(candidate.value, candidate.quote === "'" ? "'" : "\"", candidate.escaped === true);
+		if (candidate.type === "Expression" && Array.isArray(candidate.value)) return candidate.value.map(fromNativeLessValue);
+		if (candidate.type === "Value" && Array.isArray(candidate.value)) {
+			const separator = candidate.separator === "/" ? "/" : ",";
+			return (0, _jesscss_core_value.makeList)(candidate.value.map((item) => fromNativeLessValue(item)), separator);
+		}
+		if (typeof candidate.value === "string") return (0, _jesscss_core_value.makeKeyword)(candidate.value);
+		if (typeof candidate.valueOf === "function") return (0, _jesscss_core_value.makeKeyword)(String(candidate.valueOf()));
+	}
+	return (0, _jesscss_core_value.makeKeyword)(value == null ? "" : String(value));
+}
+function invokeNativeLessFunction(fn, args) {
+	const result = fn(...args.map(toNativeLessValue));
+	return result !== null && typeof result === "object" && "then" in result && typeof result.then === "function" ? Promise.resolve(result).then(fromNativeLessValue) : fromNativeLessValue(result);
+}
+function nativeLessFn(name, fn) {
+	return (0, _jesscss_core_value.defineFunction)(name.toLowerCase(), {
+		variadic: true,
+		params: [],
+		body: (value) => invokeNativeLessFunction(fn, (0, _jesscss_core_value.groupItems)(value))
+	});
+}
+function isLoadedPluginModule(value) {
+	if (typeof value !== "object" || value === null) return false;
+	if (!("functions" in value) || value.functions === void 0) return true;
+	return typeof value.functions === "object" && value.functions !== null && Object.values(value.functions).every((fn) => typeof fn === "function");
+}
 /**
 * 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,
@@ -48,16 +163,55 @@ const lessPluginDefaults = {
 	bubbleRootAtRules: true,
 	collapseNesting: false
 };
+/** 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"];
-	parser;
 	mathMode;
 	unitMode;
 	equalityMode;
 	leakyScope;
 	bubbleRootAtRules;
 	collapseNesting;
+	pluginHosts = /* @__PURE__ */ new WeakMap();
 	constructor(opts = {}) {
 		super();
 		this.opts = opts;
@@ -78,41 +232,96 @@ var LessPlugin = class extends _jesscss_core.AbstractPlugin {
 		this.leakyScope = opts.leakyScope ?? lessPluginDefaults.leakyScope;
 		this.bubbleRootAtRules = opts.bubbleRootAtRules ?? lessPluginDefaults.bubbleRootAtRules;
 		this.collapseNesting = opts.collapseNesting ?? lessPluginDefaults.collapseNesting;
-		this.parser = new _jesscss_less_parser_jess.Parser();
-	}
-	createTreeContext(filePath, source) {
-		return new _jesscss_core.TreeContext({
-			file: {
-				name: node_path.default.basename(filePath),
-				path: node_path.default.dirname(filePath),
-				fullPath: filePath,
-				source
-			},
-			mathMode: this.mathMode,
-			unitMode: this.unitMode,
-			equalityMode: this.equalityMode,
-			plugin: this,
-			allowExtendSelectors: this.opts.allowExtendSelectors,
-			collapseNesting: this.collapseNesting,
-			leakyScope: this.leakyScope,
-			bubbleRootAtRules: this.bubbleRootAtRules
-		});
 	}
-	_registerFunctions(tree) {
-		const registeredNames = [];
-		for (const [key, value] of Object.entries(_jesscss_fns)) {
-			if (typeof value !== "function") continue;
-			const runtimeName = value.name || key;
-			tree.setFunctionBinding(runtimeName, new _jesscss_core.JsFunction({
-				name: runtimeName,
-				fn: value
-			}));
-			registeredNames.push(runtimeName);
+	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.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);
+		let host = this.pluginHosts.get(context);
+		if (!host) {
+			const fns = [];
+			const nativeFns = /* @__PURE__ */ new WeakMap();
+			const addNativeFn = (name, fn) => {
+				const adapted = nativeLessFn(name, fn);
+				nativeFns.set(adapted, fn);
+				fns.push(adapted);
+				return adapted;
+			};
+			const registry = {
+				add: (name, fn) => {
+					addNativeFn(name, fn);
+				},
+				addMultiple: (functions) => {
+					for (const [name, fn] of Object.entries(functions)) registry.add(name, fn);
+				}
+			};
+			const less = {
+				functions: { functionRegistry: registry },
+				tree: {
+					Dimension: class {
+						type = "Dimension";
+						constructor(value, unit = "") {
+							this.value = value;
+							this.unit = unit;
+						}
+					},
+					Quoted: class {
+						type = "Quoted";
+						constructor(quote, value, escaped = false) {
+							this.quote = quote;
+							this.value = value;
+							this.escaped = escaped;
+						}
+					}
+				}
+			};
+			const configured = this.opts.plugins ?? [];
+			for (const plugin of configured) plugin.install?.(less, void 0, registry);
+			host = {
+				...fns.length === 0 ? {} : { globalFns: fns },
+				loadPlugin: async ({ specifier, options }) => {
+					const loaded = await context.getPluginModule(specifier, options);
+					const functions = isLoadedPluginModule(loaded.module) ? loaded.module.functions : void 0;
+					if (!functions) return [];
+					return Object.entries(functions).map(([name, fn]) => addNativeFn(name, fn));
+				},
+				invokeRawFunction: (fn, args) => {
+					const native = nativeFns.get(fn);
+					return native ? invokeNativeLessFunction(native, args) : void 0;
+				}
+			};
+			this.pluginHosts.set(context, host);
+		}
+		context.pluginHost = host;
+	}
 	resolve(filePath, currentDir, searchPaths) {
 		const mapped = (Array.isArray(filePath) ? filePath : [filePath]).map((candidate) => {
 			if (candidate.startsWith("@less/test-import-module/")) {
@@ -124,11 +333,7 @@ var LessPlugin = class extends _jesscss_core.AbstractPlugin {
 					return node_path.default.join(packagesRoot, "test-import-module", after);
 				}
 			}
-			const m = candidate.match(/^https?:\/\/cdn\.jsdelivr\.net\/npm\/([^?#]+)(?:[?#].*)?$/i);
-			if (m?.[1]) return m[1];
-			const mProtocolRelative = candidate.match(/^\/\/cdn\.jsdelivr\.net\/npm\/([^?#]+)(?:[?#].*)?$/i);
-			if (mProtocolRelative?.[1]) return mProtocolRelative[1];
-			return candidate;
+			return jsDelivrPackageSpecifier(candidate) ?? candidate;
 		});
 		const out = [...super.resolve(mapped, currentDir, searchPaths)];
 		const bases = [
@@ -156,72 +361,27 @@ var LessPlugin = class extends _jesscss_core.AbstractPlugin {
 		}
 		return out;
 	}
-	safeParse(filePath, source, _parseOptions) {
-		const context = this.createTreeContext(filePath, source);
-		const errors = [];
-		const warnings = [];
-		let tree;
+	canResolveImport(specifier) {
+		return jsDelivrPackageSpecifier(specifier) !== null;
+	}
+	safeParse(filePath, source, parseOptions) {
 		try {
-			const parseResult = this.parser.parse(source, "Stylesheet", { context });
-			tree = parseResult.tree;
-			const parsedContext = parseResult.context ?? context;
-			if (tree) tree._treeContext = parsedContext;
-			context.opts.trivia = parseResult.trivia;
-			context.opts.liftedCommentRanges = parseResult.liftedCommentRanges;
-			if ("warnings" in parseResult && parseResult.warnings) for (const warning of parseResult.warnings) {
-				const line = warning.token?.startLine ?? 1;
-				const column = warning.token?.startColumn ?? 1;
-				warnings.push({
-					code: "parse/deprecated",
-					phase: "parse",
-					message: warning.message,
-					reason: warning.message,
-					fix: "Update your code to use the recommended syntax.",
-					file: context.file,
-					filePath,
-					line,
-					column,
-					lines: (0, _jesscss_core.extractRelevantLines)(source, line)
-				});
-			}
-			if (parseResult.errors.length) for (const error of parseResult.errors) {
-				const line = error.token?.startLine ?? 1;
-				const diagnostic = (0, _jesscss_core.toDiagnostic)((0, _jesscss_core.getErrorFromParser)([error], void 0, filePath, source, { file: context.file }));
-				if (!diagnostic.lines) diagnostic.lines = (0, _jesscss_core.extractRelevantLines)(source, line);
-				if ("errors" in diagnostic) errors.push(diagnostic);
-				else warnings.push(diagnostic);
-			}
+			return {
+				document: (0, _jesscss_less_parser.parse)(source),
+				errors: [],
+				warnings: []
+			};
 		} catch (error) {
-			if (error instanceof _jesscss_core.JessError) {
-				const diagnostic = (0, _jesscss_core.toDiagnostic)(error);
-				if ("errors" in diagnostic) errors.push(diagnostic);
-				else warnings.push(diagnostic);
-			} else {
-				const message = error instanceof Error ? error.message : "Unknown parsing error";
-				errors.push({
-					code: "internal/unknown",
-					phase: "parse",
-					message,
-					reason: message || "An unexpected error occurred during parsing.",
-					fix: "Check the file syntax and ensure it is valid.",
-					file: context.file,
-					filePath,
-					line: 1,
-					column: 1,
-					lines: (0, _jesscss_core.extractRelevantLines)(source, 1)
-				});
-			}
 			return {
-				errors,
-				warnings
+				errors: [(0, _jesscss_core.parserDiagnostic)({
+					dialect: "Less",
+					error,
+					filePath,
+					source
+				})],
+				warnings: []
 			};
 		}
-		if (tree && errors.length === 0) this._registerFunctions(tree);
-		return {
-			tree,
-			errors,
-			warnings
-		};
 	}
 };
 const lessPlugin = ((opts) => {

package/lib/index.d.ts

@@ -1,6 +1,5 @@
-import { AbstractPlugin, type ISafeParseResult, type SafeParseOptions } from '@jesscss/core';
+import { AbstractPlugin, type Context, type UrlTransformRequest, type ISafeParseResult, type SafeParseOptions } from '@jesscss/core';
 import type { EqualityMode, MathMode, UnitMode, LessOptions } from 'styles-config';
-import { Parser } from '@jesscss/less-parser/jess';
 export type LessPluginOptions = LessOptions;
 /**
  * The Less plugin's default option values — the single source of truth for the
@@ -21,19 +20,20 @@ export declare class LessPlugin extends AbstractPlugin {
     opts: LessPluginOptions;
     name: string;
     supportedExtensions: string[];
-    parser: Parser;
     mathMode: MathMode;
     unitMode: UnitMode;
     equalityMode: EqualityMode;
     leakyScope: boolean;
     bubbleRootAtRules: boolean;
     collapseNesting: boolean;
+    private readonly pluginHosts;
     constructor(opts?: LessPluginOptions);
-    private createTreeContext;
-    private _registerFunctions;
+    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[];
-    safeParse(filePath: string, source: string, _parseOptions?: SafeParseOptions): ISafeParseResult;
+    canResolveImport(specifier: string): boolean;
+    safeParse(filePath: string, source: string, parseOptions?: SafeParseOptions): ISafeParseResult;
 }
 export type { LessOptions } from 'styles-config';
 declare const lessPlugin: (opts?: LessPluginOptions) => LessPlugin;

package/lib/index.js

@@ -1,10 +1,126 @@
 import { createRequire } from "node:module";
-import { AbstractPlugin, JessError, JsFunction, TreeContext, extractRelevantLines, getErrorFromParser, toDiagnostic } from "@jesscss/core";
-import * as lessFunctions from "@jesscss/fns";
-import { Parser } from "@jesscss/less-parser/jess";
+import { AbstractPlugin, parserDiagnostic } from "@jesscss/core";
+import { defineFunction, emitValue, groupItems, makeDimension, makeKeyword, makeList, makeQuoted } from "@jesscss/core/value";
 import path from "node:path";
 import { expandLessImportCandidates } from "@jesscss/style-resolver";
+import { parse } from "@jesscss/less-parser";
 //#region src/index.ts
+const nativeNil = () => {
+	const nil = {
+		type: "Nil",
+		value: "",
+		eval: () => nil
+	};
+	return nil;
+};
+function isRawSequence(value) {
+	return Array.isArray(value);
+}
+function isPluginDetached(value) {
+	return !isRawSequence(value) && value.type === "DetachedRuleset";
+}
+function toNativeLessValue(value) {
+	if (isRawSequence(value)) return {
+		type: "Expression",
+		value: value.map(toNativeLessValue),
+		valueOf: () => emitValue(value)
+	};
+	if (isPluginDetached(value)) {
+		const mixin = {
+			type: "Mixin",
+			name: nativeNil(),
+			args: nativeNil(),
+			ruleset: { rules: value.rules.map((rule) => ({
+				type: "Declaration",
+				name: rule.name,
+				value: toNativeLessValue(rule.value),
+				eval() {
+					return this;
+				}
+			})) },
+			eval() {
+				return mixin;
+			}
+		};
+		return mixin;
+	}
+	return toNativeValue(value);
+}
+function toNativeValue(value) {
+	switch (value.type) {
+		case "Dimension": return {
+			type: "Dimension",
+			value: value.number,
+			unit: value.unit,
+			valueOf: () => value.number
+		};
+		case "Quoted": return {
+			type: "Quoted",
+			value: value.value,
+			quote: value.quote,
+			escaped: value.escaped,
+			valueOf: () => value.bytes
+		};
+		case "Color": return {
+			type: "Color",
+			rgb: value.rgb,
+			alpha: value.alpha,
+			valueOf: () => value.bytes
+		};
+		case "List": return value.sep === "," || value.sep === "/" ? {
+			type: "Value",
+			value: value.value.map(toNativeLessValue),
+			separator: value.sep,
+			valueOf: () => value.bytes
+		} : {
+			type: "Anonymous",
+			value: value.bytes,
+			valueOf: () => value.bytes
+		};
+		default: return {
+			type: "Anonymous",
+			value: value.bytes,
+			valueOf: () => value.bytes
+		};
+	}
+}
+function isNativeValue(value) {
+	return value !== null && typeof value === "object" && "bytes" in value && typeof value.bytes === "string";
+}
+function fromNativeLessValue(value) {
+	if (isNativeValue(value)) return value;
+	if (typeof value === "number") return makeDimension(value);
+	if (typeof value === "string") return makeKeyword(value);
+	if (value && typeof value === "object") {
+		const candidate = value;
+		if ((candidate.type === "Dimension" || candidate.type === "Num") && typeof candidate.value === "number") return makeDimension(candidate.value, typeof candidate.unit === "string" ? candidate.unit : "");
+		if (candidate.type === "Quoted" && typeof candidate.value === "string") return makeQuoted(candidate.value, candidate.quote === "'" ? "'" : "\"", candidate.escaped === true);
+		if (candidate.type === "Expression" && Array.isArray(candidate.value)) return candidate.value.map(fromNativeLessValue);
+		if (candidate.type === "Value" && Array.isArray(candidate.value)) {
+			const separator = candidate.separator === "/" ? "/" : ",";
+			return makeList(candidate.value.map((item) => fromNativeLessValue(item)), separator);
+		}
+		if (typeof candidate.value === "string") return makeKeyword(candidate.value);
+		if (typeof candidate.valueOf === "function") return makeKeyword(String(candidate.valueOf()));
+	}
+	return makeKeyword(value == null ? "" : String(value));
+}
+function invokeNativeLessFunction(fn, args) {
+	const result = fn(...args.map(toNativeLessValue));
+	return result !== null && typeof result === "object" && "then" in result && typeof result.then === "function" ? Promise.resolve(result).then(fromNativeLessValue) : fromNativeLessValue(result);
+}
+function nativeLessFn(name, fn) {
+	return defineFunction(name.toLowerCase(), {
+		variadic: true,
+		params: [],
+		body: (value) => invokeNativeLessFunction(fn, groupItems(value))
+	});
+}
+function isLoadedPluginModule(value) {
+	if (typeof value !== "object" || value === null) return false;
+	if (!("functions" in value) || value.functions === void 0) return true;
+	return typeof value.functions === "object" && value.functions !== null && Object.values(value.functions).every((fn) => typeof fn === "function");
+}
 /**
 * 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,
@@ -20,16 +136,55 @@ const lessPluginDefaults = {
 	bubbleRootAtRules: true,
 	collapseNesting: false
 };
+/** 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"];
-	parser;
 	mathMode;
 	unitMode;
 	equalityMode;
 	leakyScope;
 	bubbleRootAtRules;
 	collapseNesting;
+	pluginHosts = /* @__PURE__ */ new WeakMap();
 	constructor(opts = {}) {
 		super();
 		this.opts = opts;
@@ -50,41 +205,96 @@ var LessPlugin = class extends AbstractPlugin {
 		this.leakyScope = opts.leakyScope ?? lessPluginDefaults.leakyScope;
 		this.bubbleRootAtRules = opts.bubbleRootAtRules ?? lessPluginDefaults.bubbleRootAtRules;
 		this.collapseNesting = opts.collapseNesting ?? lessPluginDefaults.collapseNesting;
-		this.parser = new Parser();
-	}
-	createTreeContext(filePath, source) {
-		return new TreeContext({
-			file: {
-				name: path.basename(filePath),
-				path: path.dirname(filePath),
-				fullPath: filePath,
-				source
-			},
-			mathMode: this.mathMode,
-			unitMode: this.unitMode,
-			equalityMode: this.equalityMode,
-			plugin: this,
-			allowExtendSelectors: this.opts.allowExtendSelectors,
-			collapseNesting: this.collapseNesting,
-			leakyScope: this.leakyScope,
-			bubbleRootAtRules: this.bubbleRootAtRules
-		});
 	}
-	_registerFunctions(tree) {
-		const registeredNames = [];
-		for (const [key, value] of Object.entries(lessFunctions)) {
-			if (typeof value !== "function") continue;
-			const runtimeName = value.name || key;
-			tree.setFunctionBinding(runtimeName, new JsFunction({
-				name: runtimeName,
-				fn: value
-			}));
-			registeredNames.push(runtimeName);
+	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.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);
+		let host = this.pluginHosts.get(context);
+		if (!host) {
+			const fns = [];
+			const nativeFns = /* @__PURE__ */ new WeakMap();
+			const addNativeFn = (name, fn) => {
+				const adapted = nativeLessFn(name, fn);
+				nativeFns.set(adapted, fn);
+				fns.push(adapted);
+				return adapted;
+			};
+			const registry = {
+				add: (name, fn) => {
+					addNativeFn(name, fn);
+				},
+				addMultiple: (functions) => {
+					for (const [name, fn] of Object.entries(functions)) registry.add(name, fn);
+				}
+			};
+			const less = {
+				functions: { functionRegistry: registry },
+				tree: {
+					Dimension: class {
+						type = "Dimension";
+						constructor(value, unit = "") {
+							this.value = value;
+							this.unit = unit;
+						}
+					},
+					Quoted: class {
+						type = "Quoted";
+						constructor(quote, value, escaped = false) {
+							this.quote = quote;
+							this.value = value;
+							this.escaped = escaped;
+						}
+					}
+				}
+			};
+			const configured = this.opts.plugins ?? [];
+			for (const plugin of configured) plugin.install?.(less, void 0, registry);
+			host = {
+				...fns.length === 0 ? {} : { globalFns: fns },
+				loadPlugin: async ({ specifier, options }) => {
+					const loaded = await context.getPluginModule(specifier, options);
+					const functions = isLoadedPluginModule(loaded.module) ? loaded.module.functions : void 0;
+					if (!functions) return [];
+					return Object.entries(functions).map(([name, fn]) => addNativeFn(name, fn));
+				},
+				invokeRawFunction: (fn, args) => {
+					const native = nativeFns.get(fn);
+					return native ? invokeNativeLessFunction(native, args) : void 0;
+				}
+			};
+			this.pluginHosts.set(context, host);
+		}
+		context.pluginHost = host;
+	}
 	resolve(filePath, currentDir, searchPaths) {
 		const mapped = (Array.isArray(filePath) ? filePath : [filePath]).map((candidate) => {
 			if (candidate.startsWith("@less/test-import-module/")) {
@@ -96,11 +306,7 @@ var LessPlugin = class extends AbstractPlugin {
 					return path.join(packagesRoot, "test-import-module", after);
 				}
 			}
-			const m = candidate.match(/^https?:\/\/cdn\.jsdelivr\.net\/npm\/([^?#]+)(?:[?#].*)?$/i);
-			if (m?.[1]) return m[1];
-			const mProtocolRelative = candidate.match(/^\/\/cdn\.jsdelivr\.net\/npm\/([^?#]+)(?:[?#].*)?$/i);
-			if (mProtocolRelative?.[1]) return mProtocolRelative[1];
-			return candidate;
+			return jsDelivrPackageSpecifier(candidate) ?? candidate;
 		});
 		const out = [...super.resolve(mapped, currentDir, searchPaths)];
 		const bases = [
@@ -128,72 +334,27 @@ var LessPlugin = class extends AbstractPlugin {
 		}
 		return out;
 	}
-	safeParse(filePath, source, _parseOptions) {
-		const context = this.createTreeContext(filePath, source);
-		const errors = [];
-		const warnings = [];
-		let tree;
+	canResolveImport(specifier) {
+		return jsDelivrPackageSpecifier(specifier) !== null;
+	}
+	safeParse(filePath, source, parseOptions) {
 		try {
-			const parseResult = this.parser.parse(source, "Stylesheet", { context });
-			tree = parseResult.tree;
-			const parsedContext = parseResult.context ?? context;
-			if (tree) tree._treeContext = parsedContext;
-			context.opts.trivia = parseResult.trivia;
-			context.opts.liftedCommentRanges = parseResult.liftedCommentRanges;
-			if ("warnings" in parseResult && parseResult.warnings) for (const warning of parseResult.warnings) {
-				const line = warning.token?.startLine ?? 1;
-				const column = warning.token?.startColumn ?? 1;
-				warnings.push({
-					code: "parse/deprecated",
-					phase: "parse",
-					message: warning.message,
-					reason: warning.message,
-					fix: "Update your code to use the recommended syntax.",
-					file: context.file,
-					filePath,
-					line,
-					column,
-					lines: extractRelevantLines(source, line)
-				});
-			}
-			if (parseResult.errors.length) for (const error of parseResult.errors) {
-				const line = error.token?.startLine ?? 1;
-				const diagnostic = toDiagnostic(getErrorFromParser([error], void 0, filePath, source, { file: context.file }));
-				if (!diagnostic.lines) diagnostic.lines = extractRelevantLines(source, line);
-				if ("errors" in diagnostic) errors.push(diagnostic);
-				else warnings.push(diagnostic);
-			}
+			return {
+				document: parse(source),
+				errors: [],
+				warnings: []
+			};
 		} catch (error) {
-			if (error instanceof JessError) {
-				const diagnostic = toDiagnostic(error);
-				if ("errors" in diagnostic) errors.push(diagnostic);
-				else warnings.push(diagnostic);
-			} else {
-				const message = error instanceof Error ? error.message : "Unknown parsing error";
-				errors.push({
-					code: "internal/unknown",
-					phase: "parse",
-					message,
-					reason: message || "An unexpected error occurred during parsing.",
-					fix: "Check the file syntax and ensure it is valid.",
-					file: context.file,
-					filePath,
-					line: 1,
-					column: 1,
-					lines: extractRelevantLines(source, 1)
-				});
-			}
 			return {
-				errors,
-				warnings
+				errors: [parserDiagnostic({
+					dialect: "Less",
+					error,
+					filePath,
+					source
+				})],
+				warnings: []
 			};
 		}
-		if (tree && errors.length === 0) this._registerFunctions(tree);
-		return {
-			tree,
-			errors,
-			warnings
-		};
 	}
 };
 const lessPlugin = ((opts) => {

package/package.json

@@ -5,7 +5,7 @@
     "access": "public"
   },
   "description": "A Less stylesheet engine for Jess",
-  "version": "2.0.0-alpha.7",
+  "version": "2.0.0-alpha.9",
   "main": "lib/index.cjs",
   "types": "lib/index.d.ts",
   "exports": {
@@ -20,11 +20,12 @@
     "lib"
   ],
   "dependencies": {
-    "@jesscss/core": "2.0.0-alpha.7",
-    "@jesscss/fns": "2.0.0-alpha.7",
-    "@jesscss/less-parser": "2.0.0-alpha.7",
-    "@jesscss/style-resolver": "2.0.0-alpha.7",
-    "styles-config": "2.0.0-alpha.7"
+    "@jesscss/fns": "2.0.0-alpha.9",
+    "@jesscss/less-parser": "2.0.0-alpha.9",
+    "@jesscss/style-resolver": "2.0.0-alpha.9",
+    "@jesscss/core": "2.0.0-alpha.9",
+    "@jesscss/plugin-node-modules": "2.0.0-alpha.9",
+    "styles-config": "2.0.0-alpha.9"
   },
   "devDependencies": {},
   "author": "Matthew Dean <matthew-dean@users.noreply.github.com>",
@@ -37,7 +38,7 @@
   "scripts": {
     "ci": "pnpm build && pnpm test",
     "build": "pnpm compile",
-    "compile": "tsdown --tsconfig tsconfig.build.json --no-dts && tsc -p tsconfig.build.json --emitDeclarationOnly --noCheck",
+    "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}'"