package
Jess plugin for resolving and loading npm packages from node_modules
npm install @jesscss/plugin-node-modulesGitHub-flavored package documentation.
Across all versions, last 30 days.
1,547 in 30 days
Runtime metadata.
Latest published Jul 12, 2026
alpha
Estimated unpacked size across 16 packages.
14.4 MB
Includes dependencies.
Jess plugin for resolving and loading npm packages from node_modules.
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.
import { Compiler } from '@jesscss/jess';
import nodeModulesPlugin from '@jesscss/plugin-node-modules';
const compiler = new Compiler({
compile: {
plugins: [
nodeModulesPlugin(),
// ... other plugins
]
}
});resolvePackage(packageName: string): string | nullResolve an npm package name to its absolute path.
const plugin = new NodeModulesPlugin();
const path = plugin.resolvePackage('less-plugin-clean-css');
// Returns: '/path/to/node_modules/less-plugin-clean-css/index.js' or nullloadPackage(packageName: string): Promise<Record<string, any> | null>Load an npm package module.
const plugin = new NodeModulesPlugin();
const module = await plugin.loadPackage('less-plugin-clean-css');
// Returns: the module exports, or null if not foundtryResolvePackages(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.
const plugin = new NodeModulesPlugin();
const result = await plugin.tryResolvePackages([
'clean-css',
'less-plugin-clean-css'
]);
// Returns: { name: 'less-plugin-clean-css', module: {...} } or nullOther plugins (like @jesscss/plugin-less-compat) can use this plugin to resolve npm packages:
// 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');
}enabled (boolean, default: true): Whether to enable auto-resolution of npm packages.