Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslnode 18–223 runs
build_error
glibcnode 18–223 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
default
✓ import yakumoEsbuild from 'yakumo-esbuild'
✗ import { yakumoEsbuild } from 'yakumo-esbuild'
Plugin is default-exported
EsbuildConfig
✓ import type { EsbuildConfig } from 'yakumo-esbuild'
TypeScript type import, not a runtime export
PluginConfig
✓ import type { PluginConfig } from 'yakumo-esbuild'
✗ import { PluginConfig } from 'yakumo-esbuild'
Only available as type export
Configure yakumo-esbuild plugin in yakumo.config.ts with esbuild options.
// yakumo.config.ts
import yakumoEsbuild from 'yakumo-esbuild'
export default {
plugins: [
yakumoEsbuild(),
],
esbuild: {
// Options passed to esbuild.build()
outdir: 'dist',
format: 'esm',
target: 'node16',
},
}
// Then run: yakumo build
Errors
Common errors & fixes
Cannot find module 'yakumo-esbuild' or its corresponding type declarations.
Missing tsconfig resolution for default export
fixAdd 'moduleResolution': 'node16' or 'bundler' to tsconfig.json
TypeError: yakumo_esbuild_1.default is not a function
Using CommonJS require pattern on ESM default export
fixUse import yakumoEsbuild from 'yakumo-esbuild' instead of require()
Error: Plugin 'esbuild' configuration is missing required property 'options'
Incorrect config shape in yakumo config
fixEnsure config is nested under 'esbuild' key as object with build options
Audit
Dependencies
esbuildrequiredPeer dependency for esbuild API
typescriptoptionalPeer dependency for TypeScript support
yakumorequiredPeer dependency for Yakumo integration