Registry / web-framework / esbuild-plugin-vue-iii

esbuild-plugin-vue-iii

library0.5.0jsnpmunverified

A plugin for esbuild that compiles Vue 3 Single-File Components (.vue files) including `<script setup>`. Version 0.5.0, updated irregularly. It leverages internal modules from `@vitejs/plugin-vue` with an interface adapted for esbuild. Unlike Vite's plugin, it does not require Rollup or Vite, making it suitable for projects that want a lighter build pipeline. However, it lacks support for pre-processors, CSS Modules, custom blocks, SFC src imports, and source maps. TypeScript definitions are included.

web-framework

npm install esbuild-plugin-vue-iii

github ↗package ↗

INSTALL

IMPORT

SIG · ESBUILD-PLUGIN-VUE

esbuild-plugin-vue-iii

web-frameworkjavascriptv0.5.0

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.

vue3Plugin

✓ import { vue3Plugin } from 'esbuild-plugin-vue-iii'

✗ const { vue3Plugin } = require('esbuild-plugin-vue-iii')

Package ships both ESM and CJS; named export is preferred.

default (vue3Plugin)

✓ import vue3Plugin from 'esbuild-plugin-vue-iii'

Default export is also available, same as named export.

build (esbuild)

✓ import { build } from 'esbuild'

✗ const build = require('esbuild').build

CommonJS require still works but ESM is recommended.

Shows minimal usage of esbuild with the Vue 3 SFC plugin to bundle a TypeScript entry point.

import { build } from 'esbuild'; import { vue3Plugin } from 'esbuild-plugin-vue-iii'; build({ entryPoints: ['src/main.ts'], bundle: true, outdir: 'dist', plugins: [vue3Plugin()], }).catch(() => process.exit(1));

Debug

Known issues

gotchaNo support for pre-processors (SCSS, Less, etc.) inside <style>

fix

Use separate build step or inline precompiled CSS.

affects: <1.0

gotchaCSS Modules not supported. All styles are global.

fix

Use a different plugin or extract styles manually.

affects: <1.0

gotchaSource maps are not generated for .vue files.

fix

No workaround currently; consider using Vite for source maps.

affects: <1.0

gotchaSFC src imports (e.g. <template src='./template.html'>) are not supported.

fix

Inline templates/scripts/styles in the .vue file.

affects: <1.0

gotchaCustom blocks (<i18n>, <docs>) are ignored.

fix

Handle custom blocks with a separate loader.

affects: <1.0

Errors

Common errors & fixes

Error: Build failed with 1 error: error: Unexpected end of file in style block

Pre-processor or unclosed style tag in .vue file.

fix

Ensure <style> contains plain CSS or remove pre-processor usage.

Cannot find module 'esbuild-plugin-vue-iii'

Package not installed.

fix

Run 'npm install -D esbuild-plugin-vue-iii'

Error: No matching export in 'esbuild-plugin-vue-iii' for import 'default'

Using ESM import without default export (if not available) or wrong import syntax.

fix

Use named import: import { vue3Plugin } from 'esbuild-plugin-vue-iii'

Upgrade

Version history

0.5.0latest on npm

Audit

Dependencies

esbuildrequiredpeer dependency, required to run the plugin

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/kena0ki/esbuild-plugin-vue-iii ↗

packagehttps://www.npmjs.com/package/esbuild-plugin-vue-iii ↗