@jesscss/plugin-node-modules 2.0.0-alpha.1 → 2.0.0-alpha.11

package/README.md

@@ -1,74 +1,35 @@
 # @jesscss/plugin-node-modules
 
-Jess plugin for resolving and loading npm packages from `node_modules`.
-
-## Overview
-
-This plugin provides npm/node_modules resolution and loading capabilities for all Jess language plugins. It uses Node's module resolution algorithm (`require.resolve`) to find and load npm packages.
-
-## Usage
-
-```typescript
-import { Compiler } from '@jesscss/jess';
-import nodeModulesPlugin from '@jesscss/plugin-node-modules';
-
-const compiler = new Compiler({
-  compile: {
-    plugins: [
-      nodeModulesPlugin(),
-      // ... other plugins
-    ]
-  }
-});
-```
-
-## API
-
-### `resolvePackage(packageName: string): string | null`
-
-Resolve an npm package name to its absolute path.
-
-```typescript
-const plugin = new NodeModulesPlugin();
-const path = plugin.resolvePackage('less-plugin-clean-css');
-// Returns: '/path/to/node_modules/less-plugin-clean-css/index.js' or null
-```
-
-### `loadPackage(packageName: string): Promise<Record<string, any> | null>`
-
-Load an npm package module.
-
-```typescript
-const plugin = new NodeModulesPlugin();
-const module = await plugin.loadPackage('less-plugin-clean-css');
-// Returns: the module exports, or null if not found
-```
-
-### `tryResolvePackages(packageNames: string[]): Promise<{ name: string; module: Record<string, any> } | null>`
-
-Try to resolve a package name with multiple possible names. Returns the first successfully resolved package.
-
-```typescript
-const plugin = new NodeModulesPlugin();
-const result = await plugin.tryResolvePackages([
-  'clean-css',
-  'less-plugin-clean-css'
-]);
-// Returns: { name: 'less-plugin-clean-css', module: {...} } or null
-```
-
-## Integration with Other Plugins
-
-Other plugins (like `@jesscss/plugin-less-compat`) can use this plugin to resolve npm packages:
-
-```typescript
-// In jess-plugin-less-compat
-const nodeModulesPlugin = plugins.find(p => p.name === 'node-modules');
-if (nodeModulesPlugin instanceof NodeModulesPlugin) {
-  const module = await nodeModulesPlugin.loadPackage('less-plugin-clean-css');
-}
-```
-
-## Options
-
-- `enabled` (boolean, default: `true`): Whether to enable auto-resolution of npm packages.
+**Import resolver that loads npm packages from `node_modules` — a seed of the
+JavaScript-execution / CSS-in-JS story.**
+
+This plugin gives Jess's language plugins a way to resolve and load npm packages
+by name, using Node's module resolution (`require.resolve` /
+`createRequire`). Other plugins use it to pull in packages referenced from a
+stylesheet — for example [`@jesscss/plugin-less-compat`](../jess-plugin-less-compat)
+resolving a Less `@plugin "package-name"` off `node_modules`.
+
+## Why it exists — the convergence angle
+
+One of the four tools [Jess](https://github.com/jesscss/jess) aims to converge is
+**CSS-in-JS**: running real JavaScript inside your stylesheets (`@use` /
+`@plugin`) so styles can be dynamic without leaving CSS files. Reaching npm
+packages is a building block of that story. Paired with
+[`@jesscss/plugin-js`](../jess-plugin-js) (which executes the modules), it lets a
+stylesheet pull logic and data from the JS ecosystem.
+
+That convergence is **roadmap — being proven through the alpha, not claimed as
+done.** What ships here today is just the resolver seam; don't read it as a
+finished CSS-in-JS system.
+
+## Status
+
+**Alpha.** Part of Jess. 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,171 @@
+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 node_module = require("node:module");
+let node_url = require("node:url");
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+//#region src/index.ts
+/**
+* Plugin that provides npm/node_modules resolution and loading capabilities.
+*
+* This plugin implements the `import()` method to resolve and load npm packages
+* using Node's module resolution algorithm (require.resolve).
+*
+* It can be used by other plugins (like jess-plugin-less-compat) to load
+* npm packages when processing directives like `@plugin "package-name"`.
+*/
+var NodeModulesPlugin = class extends _jesscss_core.AbstractPlugin {
+	name = "node-modules";
+	_require;
+	constructor(opts = {}) {
+		super();
+		this.opts = opts;
+		try {
+			let currentDir;
+			if (opts.basePath !== void 0) currentDir = opts.basePath;
+			else if (typeof __filename !== "undefined") currentDir = node_path.dirname(__filename);
+			else try {
+				const url = require("url").pathToFileURL(__filename).href;
+				currentDir = node_path.dirname((0, node_url.fileURLToPath)(url));
+			} catch {
+				currentDir = process.cwd();
+			}
+			this._require = (0, node_module.createRequire)(currentDir + "/");
+		} catch {
+			this._require = typeof require !== "undefined" ? require : (0, node_module.createRequire)(process.cwd() + "/");
+		}
+	}
+	/**
+	* Resolve an npm package name to its absolute path.
+	* Uses Node's module resolution algorithm (same as require.resolve).
+	*
+	* @param packageName - The npm package name (e.g., "less-plugin-clean-css")
+	* @param fromDir - Optional directory to start `node_modules` resolution from
+	*   (walked up per Node's algorithm). When given it takes precedence over the
+	*   plugin's `basePath`; used to resolve a package relative to the importing
+	*   file (e.g. an `@import "pkg/x"` resolving against the importer's directory).
+	* @returns The absolute path to the package, or null if not found
+	*/
+	resolvePackage(packageName, fromDir) {
+		if (this.opts.enabled === false) return null;
+		try {
+			return fromDir !== void 0 ? this._require.resolve(packageName, { paths: [fromDir] }) : this._require.resolve(packageName);
+		} catch (e) {
+			if (e instanceof Error && e.code === "MODULE_NOT_FOUND") return null;
+			throw e;
+		}
+	}
+	/**
+	* Context resolution hook for bare package specifiers. Core owns only the
+	* resolver-plugin pipeline; this plugin owns Node's module-resolution policy.
+	*/
+	resolve(filePath, currentDir, searchPaths) {
+		const paths = Array.isArray(filePath) ? filePath : [filePath];
+		const bases = [currentDir, ...searchPaths];
+		const resolved = [];
+		for (const candidate of paths) {
+			if (!isBareModuleSpecifier(candidate)) {
+				resolved.push(candidate);
+				continue;
+			}
+			let modulePath = null;
+			for (const base of bases) {
+				modulePath = this.resolvePackage(candidate, base) ?? this.resolvePackage(`${candidate}.less`, base);
+				if (modulePath) break;
+			}
+			modulePath ??= this.resolvePackage(candidate) ?? this.resolvePackage(`${candidate}.less`);
+			resolved.push(modulePath ?? candidate);
+		}
+		return resolved;
+	}
+	/**
+	* Load an npm package module.
+	*
+	* @param packageName - The npm package name (e.g., "less-plugin-clean-css")
+	* @returns The loaded module, or null if not found
+	*/
+	async loadPackage(packageName) {
+		const resolvedPath = this.resolvePackage(packageName);
+		if (!resolvedPath) return null;
+		try {
+			const module = this._require(resolvedPath);
+			return isRecord(module) ? module : null;
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* Try to resolve a package name with multiple possible names.
+	* Useful for plugins that want to try different variations
+	* (e.g., "clean-css" and "less-plugin-clean-css").
+	*
+	* @param packageNames - Array of package names to try in order
+	* @returns The first successfully resolved package, or null if none found
+	*/
+	async tryResolvePackages(packageNames) {
+		for (const name of packageNames) {
+			const module = await this.loadPackage(name);
+			if (module !== null) return {
+				name,
+				module
+			};
+		}
+		return null;
+	}
+	/**
+	* Import method for loading JavaScript modules from npm.
+	* This is called by the context when importing modules.
+	*
+	* @param absoluteFilePath - The absolute path to the module
+	* @returns The loaded module, or throws if this plugin can't handle it
+	*/
+	async import(absoluteFilePath) {
+		if (this.opts.enabled === false) throw new Error(`Plugin "${this.name}" cannot import "${absoluteFilePath}" (disabled)`);
+		if (absoluteFilePath.includes("node_modules")) try {
+			const module = this._require(absoluteFilePath);
+			if (!isRecord(module)) throw new TypeError(`Module "${absoluteFilePath}" did not export an object.`);
+			return module;
+		} catch (e) {
+			const message = e instanceof Error ? e.message : String(e);
+			throw new Error(`Failed to import "${absoluteFilePath}": ${message}`);
+		}
+		throw new Error(`Plugin "${this.name}" cannot import "${absoluteFilePath}" (not a node_modules path)`);
+	}
+};
+function isBareModuleSpecifier(candidate) {
+	return !node_path.isAbsolute(candidate) && !candidate.startsWith("./") && !candidate.startsWith("../") && !candidate.startsWith("/") && !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(candidate);
+}
+function isRecord(value) {
+	return value !== null && typeof value === "object";
+}
+const nodeModulesPlugin = ((opts) => {
+	return new NodeModulesPlugin(opts);
+});
+//#endregion
+exports.NodeModulesPlugin = NodeModulesPlugin;
+exports.default = nodeModulesPlugin;

package/lib/index.d.ts

@@ -5,6 +5,14 @@ interface NodeModulesPluginOptions {
      * Default: true
      */
     enabled?: boolean;
+    /**
+     * Directory to anchor Node's module resolution at. When set, `require.resolve`
+     * walks `node_modules` starting from this directory (instead of the plugin's own
+     * location). Used to resolve packages relative to a consuming project or a
+     * fixture tree rather than where the plugin is installed.
+     * Default: the plugin file's directory (falling back to `process.cwd()`).
+     */
+    basePath?: string;
 }
 export type { NodeModulesPluginOptions };
 /**
@@ -26,9 +34,18 @@ export declare class NodeModulesPlugin extends AbstractPlugin {
      * Uses Node's module resolution algorithm (same as require.resolve).
      *
      * @param packageName - The npm package name (e.g., "less-plugin-clean-css")
+     * @param fromDir - Optional directory to start `node_modules` resolution from
+     *   (walked up per Node's algorithm). When given it takes precedence over the
+     *   plugin's `basePath`; used to resolve a package relative to the importing
+     *   file (e.g. an `@import "pkg/x"` resolving against the importer's directory).
      * @returns The absolute path to the package, or null if not found
      */
-    resolvePackage(packageName: string): string | null;
+    resolvePackage(packageName: string, fromDir?: string): string | null;
+    /**
+     * Context resolution hook for bare package specifiers. Core owns only the
+     * resolver-plugin pipeline; this plugin owns Node's module-resolution policy.
+     */
+    resolve(filePath: string | string[], currentDir: string, searchPaths: string[]): string[];
     /**
      * Load an npm package module.
      *

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EACf,MAAM,eAAe,CAAC;AAKvB,UAAU,wBAAwB;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,YAAY,EAAE,wBAAwB,EAAE,CAAC;AAEzC;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;IAKhC,IAAI,EAAE,wBAAwB;IAJjD,IAAI,SAAkB;IAEtB,OAAO,CAAC,QAAQ,CAAc;gBAEX,IAAI,GAAE,wBAA6B;IAmCtD;;;;;;OAMG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAoBlD;;;;;OAKG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAgB3E;;;;;;;OAOG;IACG,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAU/G;;;;;;OAMG;IACG,MAAM,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAmBrE;AAED,QAAA,MAAM,iBAAiB,UAAY,wBAAwB,sBAExC,CAAC;AAEpB,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACf,MAAM,eAAe,CAAC;AAKvB,UAAU,wBAAwB;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,YAAY,EAAE,wBAAwB,EAAE,CAAC;AAEzC;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;IAKhC,IAAI,EAAE,wBAAwB;IAJjD,IAAI,SAAkB;IAEtB,OAAO,CAAC,QAAQ,CAAc;gBAEX,IAAI,GAAE,wBAA6B;IAwCtD;;;;;;;;;;OAUG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAyBpE;;;OAGG;IACM,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAyBlG;;;;;OAKG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAiB3E;;;;;;;OAOG;IACG,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAU/G;;;;;;OAMG;IACG,MAAM,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAyBrE;AAcD,QAAA,MAAM,iBAAiB,UAAY,wBAAwB,sBAExC,CAAC;AAEpB,eAAe,iBAAiB,CAAC"}

package/lib/index.js

@@ -1,150 +1,146 @@
-import { AbstractPlugin } from '@jesscss/core';
-import { createRequire } from 'node:module';
-import { fileURLToPath } from 'node:url';
-import * as path from 'node:path';
+import { createRequire } from "node:module";
+import { AbstractPlugin } from "@jesscss/core";
+import { fileURLToPath } from "node:url";
+import * as path from "node:path";
+//#region \0rolldown/runtime.js
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+//#endregion
+//#region src/index.ts
 /**
- * Plugin that provides npm/node_modules resolution and loading capabilities.
- *
- * This plugin implements the `import()` method to resolve and load npm packages
- * using Node's module resolution algorithm (require.resolve).
- *
- * It can be used by other plugins (like jess-plugin-less-compat) to load
- * npm packages when processing directives like `@plugin "package-name"`.
- */
-export class NodeModulesPlugin extends AbstractPlugin {
-    opts;
-    name = 'node-modules';
-    _require;
-    constructor(opts = {}) {
-        super();
-        this.opts = opts;
-        // Create a require function that can resolve modules
-        // Use createRequire to get a require function in ES module contexts
-        try {
-            // Try to use the current file's directory as the base for resolution
-            let currentDir;
-            if (typeof __filename !== 'undefined') {
-                currentDir = path.dirname(__filename);
-            }
-            else {
-                // In ES module contexts, try to use import.meta.url
-                // This will only work if the module system supports it
-                try {
-                    // eslint-disable-next-line @typescript-eslint/no-var-requires
-                    const url = globalThis.import?.meta?.url;
-                    if (url) {
-                        currentDir = path.dirname(fileURLToPath(url));
-                    }
-                    else {
-                        throw new Error('import.meta not available');
-                    }
-                }
-                catch {
-                    // Fallback to process.cwd()
-                    currentDir = process.cwd();
-                }
-            }
-            this._require = createRequire(currentDir + '/');
-        }
-        catch {
-            // Fallback to global require if available
-            this._require = typeof require !== 'undefined' ? require : (() => {
-                throw new Error('require is not available');
-            });
-        }
-    }
-    /**
-     * Resolve an npm package name to its absolute path.
-     * Uses Node's module resolution algorithm (same as require.resolve).
-     *
-     * @param packageName - The npm package name (e.g., "less-plugin-clean-css")
-     * @returns The absolute path to the package, or null if not found
-     */
-    resolvePackage(packageName) {
-        if (this.opts.enabled === false) {
-            return null;
-        }
-        try {
-            // Use require.resolve to find the package
-            // This will search node_modules using Node's resolution algorithm
-            const resolved = this._require.resolve(packageName);
-            return resolved;
-        }
-        catch (e) {
-            // MODULE_NOT_FOUND is expected when package doesn't exist
-            if (e.code === 'MODULE_NOT_FOUND') {
-                return null;
-            }
-            // Re-throw other errors
-            throw e;
-        }
-    }
-    /**
-     * Load an npm package module.
-     *
-     * @param packageName - The npm package name (e.g., "less-plugin-clean-css")
-     * @returns The loaded module, or null if not found
-     */
-    async loadPackage(packageName) {
-        const resolvedPath = this.resolvePackage(packageName);
-        if (!resolvedPath) {
-            return null;
-        }
-        try {
-            // Load the module using require
-            const module = this._require(resolvedPath);
-            return module || null;
-        }
-        catch (e) {
-            // If loading fails, return null
-            return null;
-        }
-    }
-    /**
-     * Try to resolve a package name with multiple possible names.
-     * Useful for plugins that want to try different variations
-     * (e.g., "clean-css" and "less-plugin-clean-css").
-     *
-     * @param packageNames - Array of package names to try in order
-     * @returns The first successfully resolved package, or null if none found
-     */
-    async tryResolvePackages(packageNames) {
-        for (const name of packageNames) {
-            const module = await this.loadPackage(name);
-            if (module !== null) {
-                return { name, module: module };
-            }
-        }
-        return null;
-    }
-    /**
-     * Import method for loading JavaScript modules from npm.
-     * This is called by the context when importing modules.
-     *
-     * @param absoluteFilePath - The absolute path to the module
-     * @returns The loaded module, or throws if this plugin can't handle it
-     */
-    async import(absoluteFilePath) {
-        if (this.opts.enabled === false) {
-            throw new Error(`Plugin "${this.name}" cannot import "${absoluteFilePath}" (disabled)`);
-        }
-        // Check if this looks like a node_modules path
-        // We can't directly resolve from absolute paths, but we can try to require it
-        if (absoluteFilePath.includes('node_modules')) {
-            try {
-                const module = this._require(absoluteFilePath);
-                return module;
-            }
-            catch (e) {
-                throw new Error(`Failed to import "${absoluteFilePath}": ${e.message}`);
-            }
-        }
-        // For non-node_modules paths, throw to let other plugins handle it
-        throw new Error(`Plugin "${this.name}" cannot import "${absoluteFilePath}" (not a node_modules path)`);
-    }
+* Plugin that provides npm/node_modules resolution and loading capabilities.
+*
+* This plugin implements the `import()` method to resolve and load npm packages
+* using Node's module resolution algorithm (require.resolve).
+*
+* It can be used by other plugins (like jess-plugin-less-compat) to load
+* npm packages when processing directives like `@plugin "package-name"`.
+*/
+var NodeModulesPlugin = class extends AbstractPlugin {
+	name = "node-modules";
+	_require;
+	constructor(opts = {}) {
+		super();
+		this.opts = opts;
+		try {
+			let currentDir;
+			if (opts.basePath !== void 0) currentDir = opts.basePath;
+			else if (typeof __filename !== "undefined") currentDir = path.dirname(__filename);
+			else try {
+				const url = import.meta.url;
+				currentDir = path.dirname(fileURLToPath(url));
+			} catch {
+				currentDir = process.cwd();
+			}
+			this._require = createRequire(currentDir + "/");
+		} catch {
+			this._require = typeof __require !== "undefined" ? __require : createRequire(process.cwd() + "/");
+		}
+	}
+	/**
+	* Resolve an npm package name to its absolute path.
+	* Uses Node's module resolution algorithm (same as require.resolve).
+	*
+	* @param packageName - The npm package name (e.g., "less-plugin-clean-css")
+	* @param fromDir - Optional directory to start `node_modules` resolution from
+	*   (walked up per Node's algorithm). When given it takes precedence over the
+	*   plugin's `basePath`; used to resolve a package relative to the importing
+	*   file (e.g. an `@import "pkg/x"` resolving against the importer's directory).
+	* @returns The absolute path to the package, or null if not found
+	*/
+	resolvePackage(packageName, fromDir) {
+		if (this.opts.enabled === false) return null;
+		try {
+			return fromDir !== void 0 ? this._require.resolve(packageName, { paths: [fromDir] }) : this._require.resolve(packageName);
+		} catch (e) {
+			if (e instanceof Error && e.code === "MODULE_NOT_FOUND") return null;
+			throw e;
+		}
+	}
+	/**
+	* Context resolution hook for bare package specifiers. Core owns only the
+	* resolver-plugin pipeline; this plugin owns Node's module-resolution policy.
+	*/
+	resolve(filePath, currentDir, searchPaths) {
+		const paths = Array.isArray(filePath) ? filePath : [filePath];
+		const bases = [currentDir, ...searchPaths];
+		const resolved = [];
+		for (const candidate of paths) {
+			if (!isBareModuleSpecifier(candidate)) {
+				resolved.push(candidate);
+				continue;
+			}
+			let modulePath = null;
+			for (const base of bases) {
+				modulePath = this.resolvePackage(candidate, base) ?? this.resolvePackage(`${candidate}.less`, base);
+				if (modulePath) break;
+			}
+			modulePath ??= this.resolvePackage(candidate) ?? this.resolvePackage(`${candidate}.less`);
+			resolved.push(modulePath ?? candidate);
+		}
+		return resolved;
+	}
+	/**
+	* Load an npm package module.
+	*
+	* @param packageName - The npm package name (e.g., "less-plugin-clean-css")
+	* @returns The loaded module, or null if not found
+	*/
+	async loadPackage(packageName) {
+		const resolvedPath = this.resolvePackage(packageName);
+		if (!resolvedPath) return null;
+		try {
+			const module = this._require(resolvedPath);
+			return isRecord(module) ? module : null;
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* Try to resolve a package name with multiple possible names.
+	* Useful for plugins that want to try different variations
+	* (e.g., "clean-css" and "less-plugin-clean-css").
+	*
+	* @param packageNames - Array of package names to try in order
+	* @returns The first successfully resolved package, or null if none found
+	*/
+	async tryResolvePackages(packageNames) {
+		for (const name of packageNames) {
+			const module = await this.loadPackage(name);
+			if (module !== null) return {
+				name,
+				module
+			};
+		}
+		return null;
+	}
+	/**
+	* Import method for loading JavaScript modules from npm.
+	* This is called by the context when importing modules.
+	*
+	* @param absoluteFilePath - The absolute path to the module
+	* @returns The loaded module, or throws if this plugin can't handle it
+	*/
+	async import(absoluteFilePath) {
+		if (this.opts.enabled === false) throw new Error(`Plugin "${this.name}" cannot import "${absoluteFilePath}" (disabled)`);
+		if (absoluteFilePath.includes("node_modules")) try {
+			const module = this._require(absoluteFilePath);
+			if (!isRecord(module)) throw new TypeError(`Module "${absoluteFilePath}" did not export an object.`);
+			return module;
+		} catch (e) {
+			const message = e instanceof Error ? e.message : String(e);
+			throw new Error(`Failed to import "${absoluteFilePath}": ${message}`);
+		}
+		throw new Error(`Plugin "${this.name}" cannot import "${absoluteFilePath}" (not a node_modules path)`);
+	}
+};
+function isBareModuleSpecifier(candidate) {
+	return !path.isAbsolute(candidate) && !candidate.startsWith("./") && !candidate.startsWith("../") && !candidate.startsWith("/") && !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(candidate);
+}
+function isRecord(value) {
+	return value !== null && typeof value === "object";
 }
 const nodeModulesPlugin = ((opts) => {
-    return new NodeModulesPlugin(opts);
+	return new NodeModulesPlugin(opts);
 });
-export default nodeModulesPlugin;
-//# sourceMappingURL=index.js.map
+//#endregion
+export { NodeModulesPlugin, nodeModulesPlugin as default };

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "@jesscss/plugin-node-modules",
-  "version": "2.0.0-alpha.1",
+  "version": "2.0.0-alpha.11",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
   "description": "Jess plugin for resolving and loading npm packages from node_modules",
-  "main": "lib/index.js",
+  "main": "lib/index.cjs",
   "types": "lib/index.d.ts",
   "exports": {
     ".": {
-      "import": "./lib/index.js",
       "types": "./lib/index.d.ts",
-      "source": "./src/index.ts"
+      "import": "./lib/index.js",
+      "require": "./lib/index.cjs"
     },
     "./package.json": "./package.json"
   },
@@ -16,7 +19,7 @@
     "lib"
   ],
   "dependencies": {
-    "@jesscss/core": "2.0.0-alpha.1"
+    "@jesscss/core": "2.0.0-alpha.11"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -27,10 +30,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "type": "module",
+  "module": "lib/index.js",
   "scripts": {
     "build": "pnpm compile",
-    "compile": "tsc -b tsconfig.build.json",
-    "dev": "tsc -b tsconfig.json -w",
+    "compile": "tsdown --tsconfig tsconfig.build.json --no-dts && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "dev": "tsdown --tsconfig tsconfig.build.json --watch",
     "lint:fix": "eslint --fix '**/*.{js,ts}'",
     "lint": "eslint '**/*.{js,ts}'"
   }

package/lib/index.js.map

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