Registry / devops / esbuild-plugin-wildcard-imports

esbuild-plugin-wildcard-imports

library0.0.15jsnpmunverified

esbuild plugin enabling wildcard/glob imports for dynamic imports, import statements, and require calls. Version 0.0.15, limited to platform=node and bundle=true. Uses fast-glob as matching engine. Supports both CJS and ESM output formats but primarily tested on CJS. Ignores node_modules by default and supports custom ignore patterns. A lightweight alternative to TypeScript path mapping or manual file listing.

devops

npm install esbuild-plugin-wildcard-imports

github ↗package ↗

INSTALL

IMPORT

SIG · ESBUILD-PLUGIN-WIL

esbuild-plugin-wildcard-imports

devopsjavascriptv0.0.15

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

wildcardImports

✓ import wildcardImports from 'esbuild-plugin-wildcard-imports'

✗ const wildcardImports = require('esbuild-plugin-wildcard-imports')

The package is ESM-only. Use dynamic import if using CommonJS.

WildcardImportsOptions

✓ import type { WildcardImportsOptions } from 'esbuild-plugin-wildcard-imports'

Type-only import for TypeScript users. Options object with ignore property.

default export

✓ import wildcardImports from 'esbuild-plugin-wildcard-imports'

✗ import * as wildcardImports from 'esbuild-plugin-wildcard-imports'

Default export is a function. Do not use namespace import.

Configures esbuild with wildcard imports plugin, bundling for Node.js with CJS output. The plugin resolves glob patterns in import paths.

import * as esbuild from 'esbuild'; import wildcardImports from 'esbuild-plugin-wildcard-imports'; // Build with wildcard imports support await esbuild.build({ entryPoints: ['src/index.js'], bundle: true, platform: 'node', format: 'cjs', outfile: 'dist/index.js', plugins: [wildcardImports({ ignore: ['**/node_modules/**'] })] }); // Example usage in source: // import { endpoints } from './endpoints/**/*.js';

Debug

Known issues

breakingOnly works with platform=node and bundle=true. Other configurations may cause build failures.

fix

Ensure esbuild options include platform: 'node' and bundle: true.

affects: >=0.0.1

deprecatedDynamic imports with top-level await will not work with format=cjs.

fix

Use format=esm or avoid top-level await in dynamically imported modules.

affects: >=0.0.1

gotchanode_modules are always ignored regardless of ignore patterns.

fix

Do not attempt to include node_modules in glob patterns; they are excluded by design.

affects: >=0.0.1

gotchaOnly supports dynamic-import, import-statement, and require-call path types.

fix

If you need other path types, the plugin will not resolve glob patterns.

affects: >=0.0.1

Errors

Common errors & fixes

Error: The plugin "esbuild-plugin-wildcard-imports" only works with platform=node and bundle=true

Missing or incorrect esbuild config options.

fix

Add platform: 'node' and bundle: true to esbuild build options.

Error: Dynamic import with top-level await not supported in CJS format

Using dynamic import with top-level await while format is cjs.

fix

Change format to esm or avoid top-level await in dynamically imported files.

TypeError: wildcardImports is not a function

Importing the default export incorrectly (e.g., using namespace import).

fix

Use import wildcardImports from 'esbuild-plugin-wildcard-imports'

Upgrade

Version history

0.0.15latest on npm

Audit

Dependencies

esbuildoptionalPeer dependency; plugin is designed for esbuild and uses its plugin API.

fast-globrequiredRuntime dependency for glob pattern matching.

Agent activity

3 hits · last 30 days

node

Bingbot

Resources

githubhttps://github.com/andreventuravale/esbuild-plugin-wildcard-imports ↗

packagehttps://www.npmjs.com/package/esbuild-plugin-wildcard-imports ↗