@jesscss/plugin-less-compat 2.0.0-alpha.1

package/lib/plugin-utils.js

@@ -0,0 +1,100 @@
+/**
+ * Utilities for working with Less.js plugins in Jess
+ */
+/**
+ * Detect if a plugin is a Less.js plugin
+ */
+export function isLessPlugin(plugin) {
+    if (!plugin) {
+        return false;
+    }
+    // Less plugins typically have an install method
+    if (typeof plugin.install === 'function') {
+        return true;
+    }
+    // Some Less plugins are constructor functions that create instances with install
+    // Check if the constructor's prototype has install (like autoprefix)
+    if (typeof plugin === 'function') {
+        // Check if the function itself has install (some plugins are like this)
+        if (typeof plugin.install === 'function') {
+            return true;
+        }
+        // Check if the constructor's prototype has install
+        if (plugin.prototype && typeof plugin.prototype.install === 'function') {
+            return true;
+        }
+        // Try calling as a constructor
+        try {
+            const instance = new plugin({});
+            if (instance && typeof instance.install === 'function') {
+                return true;
+            }
+        }
+        catch (e) {
+            // Try calling as a function
+            try {
+                const instance = plugin({});
+                if (instance && typeof instance.install === 'function') {
+                    return true;
+                }
+                // Even if it returns undefined, if it's a function it might be a Less plugin
+                // Less.js will handle it by checking for install on the plugin object itself
+                // So we should treat functions as potential Less plugins
+                return true; // Assume function might be a Less plugin
+            }
+            catch (e2) {
+                // Not a Less plugin
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Detect if a plugin is a Jess plugin
+ */
+export function isJessPlugin(plugin) {
+    if (!plugin) {
+        return false;
+    }
+    // Jess plugins implement PluginInterface
+    // They have a name property and implement AbstractPlugin or match PluginInterface
+    if (typeof plugin === 'object' && 'name' in plugin && typeof plugin.name === 'string') {
+        // Could be a Jess plugin
+        return true;
+    }
+    // Plugin factory functions that return PluginInterface
+    if (typeof plugin === 'function') {
+        try {
+            const instance = plugin({});
+            if (instance && typeof instance === 'object' && 'name' in instance && typeof instance.name === 'string') {
+                return true;
+            }
+        }
+        catch (e) {
+            // Not a Jess plugin factory
+        }
+    }
+    return false;
+}
+/**
+ * Filter and separate Less plugins from Jess plugins
+ * This allows mixed plugin arrays to be handled correctly
+ */
+export function filterPlugins(plugins) {
+    const lessPlugins = [];
+    const jessPlugins = [];
+    for (const plugin of plugins) {
+        if (isLessPlugin(plugin)) {
+            lessPlugins.push(plugin);
+        }
+        else if (isJessPlugin(plugin)) {
+            jessPlugins.push(plugin);
+        }
+        else {
+            // Unknown type - assume it's a Less plugin and try to handle it
+            lessPlugins.push(plugin);
+        }
+    }
+    return { lessPlugins, jessPlugins };
+}
+//# sourceMappingURL=plugin-utils.js.map

package/lib/plugin-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-utils.js","sourceRoot":"","sources":["../src/plugin-utils.ts"],"names":[],"mappings":"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"}

package/lib/plugin.d.ts

@@ -0,0 +1,92 @@
+import { AbstractPlugin, type Plugin, type Visitor } from '@jesscss/core';
+import type { LessVisitor } from './types.js';
+import { NodeModulesPlugin } from '@jesscss/plugin-node-modules';
+export interface LessCompatPluginOptions {
+    /**
+     * 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 @plugin directive support.
+     * Maps plugin names/paths to plugin instances or factory functions.
+     * Used when processing @plugin directives in the source.
+     */
+    pluginRegistry?: Record<string, any>;
+    /**
+     * Enable auto-loading of 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.
+     */
+    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;
+}
+/**
+ * Plugin that enables Less.js compatibility by transforming
+ * Jess nodes to Less-compatible format for visitor processing.
+ */
+export declare class LessCompatPlugin extends AbstractPlugin {
+    opts: LessCompatPluginOptions;
+    name: string;
+    private _cachedVisitor;
+    private _lessPluginManager?;
+    private _currentFilePath?;
+    private _jessFunctionRegistry?;
+    constructor(opts?: LessCompatPluginOptions);
+    /**
+     * Return the visitor as a preEval visitor so it runs before evaluation.
+     * This ensures @plugin directives are processed early, allowing their visitors
+     * to run on subsequent nodes during the preEval phase.
+     *
+     * Less plugins can register visitors via:
+     * - addVisitor() - these will run during preEval (default)
+     * - addPreProcessor() - these will run during preEval
+     * - addPostProcessor() - these will run during postEval (after evaluation)
+     */
+    get preEvalVisitor(): Visitor | Visitor[] | undefined;
+    /**
+     * Return postEval visitors from Less plugins that registered via addPostProcessor.
+     * These visitors will run after node.eval() completes.
+     */
+    get postEvalVisitor(): undefined;
+    runPostProcessors(css: string, extra?: Record<string, any>): string;
+    setCurrentFilePath(filePath: string): void;
+    setContext(context: any): void;
+    /**
+     * 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: import("@jesscss/core").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(): Visitor | Visitor[] | undefined;
+}
+/**
+ * Create a Less.js compatibility plugin
+ */
+declare const lessCompatPlugin: Plugin;
+export default lessCompatPlugin;
+export { lessCompatPlugin };