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

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,74 @@
+# @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.

package/lib/index.d.ts

@@ -0,0 +1,62 @@
+import { AbstractPlugin } from '@jesscss/core';
+interface NodeModulesPluginOptions {
+    /**
+     * Whether to enable auto-resolution of npm packages.
+     * Default: true
+     */
+    enabled?: boolean;
+}
+export type { NodeModulesPluginOptions };
+/**
+ * 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 declare class NodeModulesPlugin extends AbstractPlugin {
+    opts: NodeModulesPluginOptions;
+    name: string;
+    private _require;
+    constructor(opts?: NodeModulesPluginOptions);
+    /**
+     * 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: string): string | null;
+    /**
+     * 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
+     */
+    loadPackage(packageName: string): Promise<Record<string, any> | 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
+     */
+    tryResolvePackages(packageNames: string[]): Promise<{
+        name: string;
+        module: Record<string, any>;
+    } | 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
+     */
+    import(absoluteFilePath: string): Promise<Record<string, any>>;
+}
+declare const nodeModulesPlugin: (opts?: NodeModulesPluginOptions) => NodeModulesPlugin;
+export default nodeModulesPlugin;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +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"}

package/lib/index.js

@@ -0,0 +1,150 @@
+import { AbstractPlugin } from '@jesscss/core';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import * as path from 'node: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"`.
+ */
+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)`);
+    }
+}
+const nodeModulesPlugin = ((opts) => {
+    return new NodeModulesPlugin(opts);
+});
+export default nodeModulesPlugin;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@jesscss/plugin-node-modules",
+  "version": "2.0.0-alpha.1",
+  "description": "Jess plugin for resolving and loading npm packages from node_modules",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./lib/index.js",
+      "types": "./lib/index.d.ts",
+      "source": "./src/index.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "dependencies": {
+    "@jesscss/core": "2.0.0-alpha.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "author": "Matthew Dean <matthew-dean@users.noreply.github.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "pnpm compile",
+    "compile": "tsc -b tsconfig.build.json",
+    "dev": "tsc -b tsconfig.json -w",
+    "lint:fix": "eslint --fix '**/*.{js,ts}'",
+    "lint": "eslint '**/*.{js,ts}'"
+  }
+}