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

package/lib/plugin.d.ts

@@ -1,120 +1,28 @@
-import { AbstractPlugin, type PluginInterface, type PluginVisitor, type Rules } from '@jesscss/core';
-import type { LessVisitor } from './types.js';
-import { NodeModulesPlugin } from '@jesscss/plugin-node-modules';
+import { AbstractPlugin, type Context } from '@jesscss/core';
+import type { Fn } from '@jesscss/core/value';
+/**
+ * Native AST-v2 functions contributed by an application. Function bodies receive
+ * typed value objects and the narrow `FnCtx` capability supplied by core; they
+ * never receive Less tree nodes or a legacy evaluation context.
+ */
 export interface LessCompatPluginOptions {
-    /**
-     * Less 4.x custom functions registered through the root
-     * `less.functions.functionRegistry.add/addMultiple` API. Keyed by function
-     * name; each is bridged onto every compiled tree's root scope so calls resolve
-     * during evaluation, exactly like the built-in Less functions.
-     */
-    functions?: Record<string, (...args: any[]) => any>;
-    /**
-     * Less.js plugins - these will have their install() method called to extract visitors.
-     * Can be mixed with Jess plugins - Less plugins will be handled by this compat layer,
-     * Jess plugins will be passed through.
-     */
-    plugins?: any[];
-    /**
-     * @deprecated Less.js Visitor API - Less.js visitor implementations (advanced - use plugins instead).
-     * This is for compatibility with Less.js visitor patterns. Prefer using Jess's native Visitor interface.
-     */
-    visitors?: LessVisitor[];
-    /** Enable conversion caching (default: true) */
-    cache?: boolean;
-    /**
-     * Plugin registry for deprecated @plugin directive support.
-     * Maps plugin names/paths to plugin instances or factory functions.
-     * Used when processing @plugin directives in the source.
-     *
-     * @deprecated Less @plugin is deprecated. Prefer @use / @-use for script integration in .less files.
-     */
-    pluginRegistry?: Record<string, any>;
-    /**
-     * Enable auto-loading of deprecated @plugin plugins by name (Less.js 4.x CLI behavior).
-     * When true (default), @plugin directives will attempt to require/import
-     * plugins by their npm package name (e.g., "less-plugin-autoprefix").
-     * Set to false to disable and only use pluginRegistry.
-     *
-     * @deprecated Less @plugin is deprecated. Prefer @use / @-use for script integration in .less files.
-     */
-    autoLoadPlugins?: boolean;
-    /**
-     * Reference to the node-modules plugin for npm package resolution.
-     * If provided, will be used to resolve npm packages.
-     * If not provided, will try to use require() directly.
-     */
-    nodeModulesPlugin?: NodeModulesPlugin;
+    readonly functions?: readonly Fn[];
 }
 /**
- * Plugin that enables Less.js compatibility by transforming
- * Jess nodes to Less-compatible format for visitor processing.
+ * Transitional package boundary for applications that previously installed the
+ * Less compatibility plugin. It contributes only native AST-v2 `Fn` values.
+ *
+ * Less 4 visitor hooks, `functionRegistry` callbacks, and `@plugin` script
+ * execution were legacy tree-runtime APIs. They are intentionally unsupported
+ * on the public AST-v2 compiler route: preserving them would require a second
+ * evaluator and Node-to-Less/ Less-to-Node conversion bridge.
  */
 export declare class LessCompatPlugin extends AbstractPlugin {
-    opts: LessCompatPluginOptions;
+    readonly opts: LessCompatPluginOptions;
     name: string;
-    private _cachedVisitor;
-    private _lessPluginManager?;
-    private _currentFilePath?;
-    private _jessFunctionRegistry?;
-    private _context?;
-    /** Trees whose root scope already received the configured root functions. */
-    private _fnRegisteredTrees;
     constructor(opts?: LessCompatPluginOptions);
-    /**
-     * Return the visitor through the early visitor hook so it runs before
-     * evaluation. This keeps Less plugin visitors and preprocessors early without
-     * bringing back a public node preparation pass.
-     *
-     * Less plugins can register visitors via:
-     * - addVisitor() - these run early by default
-     * - addPreProcessor() - these run early
-     * - addPostProcessor() - these run on serialized CSS after render
-     */
-    get beforeEvalVisitor(): PluginInterface['beforeEvalVisitor'];
-    /**
-     * Less post-processors operate on final CSS, not on the preRenderVisitor tree hook.
-     */
-    get postEvalVisitor(): PluginInterface['postEvalVisitor'];
-    runPostProcessors(css: string, extra?: Record<string, any>): string;
-    setCurrentFilePath(filePath: string): void;
-    setContext(context: any): void;
-    private createJessFunctionBindingRegistry;
-    private hasConfiguredBeforeEvalWork;
-    private sourceMayContainPluginDirective;
-    private treeContainsPluginDirective;
-    private warnForPluginDirective;
-    private markPluginDirectiveInvisible;
-    private registerDenoLessPluginFunctions;
-    private loadLessPluginFileWithDeno;
-    beforeEvalVisitorForTree(tree: Rules): PluginInterface['beforeEvalVisitor'];
-    /**
-     * Register the configured Less 4.x root functions onto a parsed tree's root
-     * scope, using the same `setFunctionBinding` mechanism the Less plugin uses
-     * for built-ins. Idempotent per tree.
-     */
-    private registerRootFunctions;
-    /**
-     * Filter and separate Less plugins from Jess plugins
-     * This allows mixed plugin arrays to be handled correctly
-     *
-     * @deprecated Use filterPlugins from './plugin-utils.js' instead
-     */
-    static filterLessPlugins(plugins: any[]): {
-        lessPlugins: any[];
-        jessPlugins: PluginInterface[];
-    };
-    /**
-     * Return a visitor that wraps Less visitors
-     *
-     * This visitor intercepts each node, converts it to Less format,
-     * runs the Less visitors, and converts back if modified.
-     */
-    get visitor(): PluginVisitor | PluginVisitor[] | undefined;
+    setContext(context: Context): void;
 }
-/**
- * Create a Less.js compatibility plugin
- */
 declare const lessCompatPlugin: (opts?: LessCompatPluginOptions) => LessCompatPlugin;
 export default lessCompatPlugin;
 export { lessCompatPlugin };

package/package.json

@@ -3,8 +3,8 @@
   "publishConfig": {
     "access": "public"
   },
-  "description": "Less.js compatibility layer for Jess - enables Less plugins and visitors to work with Jess AST",
-  "version": "2.0.0-alpha.7",
+  "description": "AST-v2 native function contribution plugin for Jess",
+  "version": "2.0.0-alpha.9",
   "type": "module",
   "main": "lib/index.cjs",
   "types": "lib/index.d.ts",
@@ -14,25 +14,15 @@
       "import": "./lib/index.js",
       "require": "./lib/index.cjs"
     },
-    "./transform": {
-      "types": "./lib/transform/index.d.ts",
-      "import": "./lib/transform/index.js",
-      "require": "./lib/transform/index.cjs"
-    },
-    "./less-compat-structures": {
-      "types": "./lib/less-compat-structures.d.ts",
-      "import": "./lib/less-compat-structures.js",
-      "require": "./lib/less-compat-structures.cjs"
-    },
     "./package.json": "./package.json"
   },
   "files": [
     "lib"
   ],
   "dependencies": {
-    "@jesscss/core": "2.0.0-alpha.7",
-    "@jesscss/plugin-node-modules": "2.0.0-alpha.7",
-    "@jesscss/less-parser": "2.0.0-alpha.7"
+    "@jesscss/core": "2.0.0-alpha.9",
+    "@jesscss/less-parser": "2.0.0-alpha.9",
+    "@jesscss/plugin-node-modules": "2.0.0-alpha.9"
   },
   "devDependencies": {
     "less-plugin-autoprefix": "^2.0.0",

package/lib/less-adapter.cjs

@@ -1,216 +0,0 @@
-//#region src/transform/type-map.ts
-/**
-* Type mapping utilities for converting between Jess and Less node types
-*/
-/**
-* Map Jess node types to Less node types
-*
-* @param jessType - The Jess node type
-* @returns The corresponding Less node type
-*/
-function mapJessTypeToLessType(jessType) {
-	return {
-		Ruleset: "Ruleset",
-		Declaration: "Declaration",
-		SelectorList: "Selector",
-		ComplexSelector: "Selector",
-		CompoundSelector: "Selector",
-		BasicSelector: "Element",
-		Combinator: "Combinator",
-		AttributeSelector: "Attribute",
-		Dimension: "Dimension",
-		Num: "Dimension",
-		Reference: "Variable",
-		Mixin: "MixinDefinition",
-		Call: "Call",
-		Operation: "Operation",
-		Expression: "Expression",
-		Sequence: "Expression",
-		Quoted: "Quoted",
-		Url: "URL",
-		Color: "Color",
-		Comment: "Comment",
-		AtRule: "AtRule",
-		StyleImport: "Import",
-		Extend: "Extend",
-		Condition: "Condition",
-		Paren: "Paren",
-		Negative: "Negative",
-		List: "Value",
-		VarDeclaration: "Assignment",
-		Keyword: "Keyword"
-	}[jessType] || jessType;
-}
-/**
-* Map Less node types to Jess node types
-*
-* @param lessType - The Less node type
-* @returns The corresponding Jess node type
-*/
-function mapLessTypeToJessType(lessType) {
-	return {
-		Ruleset: "Ruleset",
-		Declaration: "Declaration",
-		Selector: "SelectorList",
-		Element: "BasicSelector",
-		Combinator: "Combinator",
-		Attribute: "AttributeSelector",
-		Dimension: "Dimension",
-		Variable: "Reference",
-		Property: "Reference",
-		VariableCall: "Reference",
-		MixinDefinition: "Mixin",
-		MixinCall: "Call",
-		Call: "Call",
-		Operation: "Operation",
-		Expression: "Expression",
-		Quoted: "Quoted",
-		URL: "Url",
-		Color: "Color",
-		Comment: "Comment",
-		AtRule: "AtRule",
-		Directive: "AtRule",
-		Rule: "Declaration",
-		Import: "StyleImport",
-		Extend: "Extend",
-		Condition: "Condition",
-		Paren: "Paren",
-		Negative: "Negative",
-		Value: "List",
-		Assignment: "VarDeclaration",
-		Keyword: "Keyword"
-	}[lessType] || lessType;
-}
-/**
-* Get Less typeIndex for a Jess node type
-*
-* Less.js uses typeIndex for visitor caching. This function
-* maps Jess types to their corresponding Less typeIndex values.
-*
-* @param jessType - The Jess node type
-* @returns The Less typeIndex, or undefined if not found
-*/
-function getLessTypeIndex$1(_jessType) {}
-//#endregion
-//#region src/transform/less-adapter.ts
-const LESS_ADAPTER_SYMBOL = Symbol("less-adapter");
-const JESS_NODE_SYMBOL = Symbol("jess-node");
-const ACTIVE_ADAPTATIONS = /* @__PURE__ */ new WeakSet();
-function getLessTypeIndex(_lessType) {}
-function normalizeField(field) {
-	if (typeof field === "function") return { get: field };
-	return field;
-}
-var LessAdapterBase = class {
-	[LESS_ADAPTER_SYMBOL] = true;
-	[JESS_NODE_SYMBOL];
-	constructor(node) {
-		this[JESS_NODE_SYMBOL] = node;
-		Object.defineProperty(this, "__jessNode", {
-			enumerable: false,
-			configurable: false,
-			writable: false,
-			value: node
-		});
-	}
-	get jessNode() {
-		return this.__jessNode;
-	}
-};
-var LessNodeAdapter = class extends LessAdapterBase {
-	lessType;
-	cache;
-	acceptImpl;
-	constructor(node, definition, cache) {
-		super(node);
-		this.lessType = definition.lessType;
-		this.cache = cache;
-		this.acceptImpl = definition.accept;
-		Object.defineProperties(this, {
-			type: {
-				enumerable: true,
-				configurable: true,
-				get: () => {
-					if (typeof this.lessType === "function") return this.lessType(this.jessNode);
-					return this.lessType ?? mapJessTypeToLessType(this.jessNode.type);
-				}
-			},
-			typeIndex: {
-				enumerable: true,
-				configurable: true,
-				get: () => {
-					return getLessTypeIndex(typeof this.lessType === "function" ? this.lessType(this.jessNode) : this.lessType ?? mapJessTypeToLessType(this.jessNode.type));
-				}
-			},
-			accept: {
-				enumerable: false,
-				configurable: true,
-				value: (visitor) => {
-					if (this.acceptImpl) return this.acceptImpl(this.jessNode, visitor, this.cache);
-					return this.jessNode;
-				}
-			}
-		});
-		for (const [key, rawField] of Object.entries(definition.fields ?? {})) {
-			const field = normalizeField(rawField);
-			Object.defineProperty(this, key, {
-				enumerable: field.enumerable ?? true,
-				configurable: true,
-				get: () => field.get(this.jessNode, this.cache),
-				set: field.set ? (value) => field.set(this.jessNode, value, this.cache) : void 0
-			});
-		}
-	}
-};
-function createLessAdapter(jessNode, definition, cache) {
-	const cached = cache?.get(jessNode);
-	if (cached instanceof LessNodeAdapter) return cached;
-	ACTIVE_ADAPTATIONS.add(jessNode);
-	try {
-		const adapter = new LessNodeAdapter(jessNode, definition, cache);
-		cache?.set(jessNode, adapter);
-		return adapter;
-	} finally {
-		ACTIVE_ADAPTATIONS.delete(jessNode);
-	}
-}
-function isAdaptingNode(node) {
-	return ACTIVE_ADAPTATIONS.has(node);
-}
-//#endregion
-Object.defineProperty(exports, "LessAdapterBase", {
-	enumerable: true,
-	get: function() {
-		return LessAdapterBase;
-	}
-});
-Object.defineProperty(exports, "createLessAdapter", {
-	enumerable: true,
-	get: function() {
-		return createLessAdapter;
-	}
-});
-Object.defineProperty(exports, "getLessTypeIndex", {
-	enumerable: true,
-	get: function() {
-		return getLessTypeIndex$1;
-	}
-});
-Object.defineProperty(exports, "isAdaptingNode", {
-	enumerable: true,
-	get: function() {
-		return isAdaptingNode;
-	}
-});
-Object.defineProperty(exports, "mapJessTypeToLessType", {
-	enumerable: true,
-	get: function() {
-		return mapJessTypeToLessType;
-	}
-});
-Object.defineProperty(exports, "mapLessTypeToJessType", {
-	enumerable: true,
-	get: function() {
-		return mapLessTypeToJessType;
-	}
-});

package/lib/less-adapter.js

@@ -1,181 +0,0 @@
-//#region src/transform/type-map.ts
-/**
-* Type mapping utilities for converting between Jess and Less node types
-*/
-/**
-* Map Jess node types to Less node types
-*
-* @param jessType - The Jess node type
-* @returns The corresponding Less node type
-*/
-function mapJessTypeToLessType(jessType) {
-	return {
-		Ruleset: "Ruleset",
-		Declaration: "Declaration",
-		SelectorList: "Selector",
-		ComplexSelector: "Selector",
-		CompoundSelector: "Selector",
-		BasicSelector: "Element",
-		Combinator: "Combinator",
-		AttributeSelector: "Attribute",
-		Dimension: "Dimension",
-		Num: "Dimension",
-		Reference: "Variable",
-		Mixin: "MixinDefinition",
-		Call: "Call",
-		Operation: "Operation",
-		Expression: "Expression",
-		Sequence: "Expression",
-		Quoted: "Quoted",
-		Url: "URL",
-		Color: "Color",
-		Comment: "Comment",
-		AtRule: "AtRule",
-		StyleImport: "Import",
-		Extend: "Extend",
-		Condition: "Condition",
-		Paren: "Paren",
-		Negative: "Negative",
-		List: "Value",
-		VarDeclaration: "Assignment",
-		Keyword: "Keyword"
-	}[jessType] || jessType;
-}
-/**
-* Map Less node types to Jess node types
-*
-* @param lessType - The Less node type
-* @returns The corresponding Jess node type
-*/
-function mapLessTypeToJessType(lessType) {
-	return {
-		Ruleset: "Ruleset",
-		Declaration: "Declaration",
-		Selector: "SelectorList",
-		Element: "BasicSelector",
-		Combinator: "Combinator",
-		Attribute: "AttributeSelector",
-		Dimension: "Dimension",
-		Variable: "Reference",
-		Property: "Reference",
-		VariableCall: "Reference",
-		MixinDefinition: "Mixin",
-		MixinCall: "Call",
-		Call: "Call",
-		Operation: "Operation",
-		Expression: "Expression",
-		Quoted: "Quoted",
-		URL: "Url",
-		Color: "Color",
-		Comment: "Comment",
-		AtRule: "AtRule",
-		Directive: "AtRule",
-		Rule: "Declaration",
-		Import: "StyleImport",
-		Extend: "Extend",
-		Condition: "Condition",
-		Paren: "Paren",
-		Negative: "Negative",
-		Value: "List",
-		Assignment: "VarDeclaration",
-		Keyword: "Keyword"
-	}[lessType] || lessType;
-}
-/**
-* Get Less typeIndex for a Jess node type
-*
-* Less.js uses typeIndex for visitor caching. This function
-* maps Jess types to their corresponding Less typeIndex values.
-*
-* @param jessType - The Jess node type
-* @returns The Less typeIndex, or undefined if not found
-*/
-function getLessTypeIndex$1(_jessType) {}
-//#endregion
-//#region src/transform/less-adapter.ts
-const LESS_ADAPTER_SYMBOL = Symbol("less-adapter");
-const JESS_NODE_SYMBOL = Symbol("jess-node");
-const ACTIVE_ADAPTATIONS = /* @__PURE__ */ new WeakSet();
-function getLessTypeIndex(_lessType) {}
-function normalizeField(field) {
-	if (typeof field === "function") return { get: field };
-	return field;
-}
-var LessAdapterBase = class {
-	[LESS_ADAPTER_SYMBOL] = true;
-	[JESS_NODE_SYMBOL];
-	constructor(node) {
-		this[JESS_NODE_SYMBOL] = node;
-		Object.defineProperty(this, "__jessNode", {
-			enumerable: false,
-			configurable: false,
-			writable: false,
-			value: node
-		});
-	}
-	get jessNode() {
-		return this.__jessNode;
-	}
-};
-var LessNodeAdapter = class extends LessAdapterBase {
-	lessType;
-	cache;
-	acceptImpl;
-	constructor(node, definition, cache) {
-		super(node);
-		this.lessType = definition.lessType;
-		this.cache = cache;
-		this.acceptImpl = definition.accept;
-		Object.defineProperties(this, {
-			type: {
-				enumerable: true,
-				configurable: true,
-				get: () => {
-					if (typeof this.lessType === "function") return this.lessType(this.jessNode);
-					return this.lessType ?? mapJessTypeToLessType(this.jessNode.type);
-				}
-			},
-			typeIndex: {
-				enumerable: true,
-				configurable: true,
-				get: () => {
-					return getLessTypeIndex(typeof this.lessType === "function" ? this.lessType(this.jessNode) : this.lessType ?? mapJessTypeToLessType(this.jessNode.type));
-				}
-			},
-			accept: {
-				enumerable: false,
-				configurable: true,
-				value: (visitor) => {
-					if (this.acceptImpl) return this.acceptImpl(this.jessNode, visitor, this.cache);
-					return this.jessNode;
-				}
-			}
-		});
-		for (const [key, rawField] of Object.entries(definition.fields ?? {})) {
-			const field = normalizeField(rawField);
-			Object.defineProperty(this, key, {
-				enumerable: field.enumerable ?? true,
-				configurable: true,
-				get: () => field.get(this.jessNode, this.cache),
-				set: field.set ? (value) => field.set(this.jessNode, value, this.cache) : void 0
-			});
-		}
-	}
-};
-function createLessAdapter(jessNode, definition, cache) {
-	const cached = cache?.get(jessNode);
-	if (cached instanceof LessNodeAdapter) return cached;
-	ACTIVE_ADAPTATIONS.add(jessNode);
-	try {
-		const adapter = new LessNodeAdapter(jessNode, definition, cache);
-		cache?.set(jessNode, adapter);
-		return adapter;
-	} finally {
-		ACTIVE_ADAPTATIONS.delete(jessNode);
-	}
-}
-function isAdaptingNode(node) {
-	return ACTIVE_ADAPTATIONS.has(node);
-}
-//#endregion
-export { mapJessTypeToLessType as a, getLessTypeIndex$1 as i, createLessAdapter as n, mapLessTypeToJessType as o, isAdaptingNode as r, LessAdapterBase as t };