Registry / devops / vite-plugin-macro

vite-plugin-macro

JSON →
library0.2.0jsnpmunverified

vite-plugin-macro (v0.2.0) brings macro capabilities to Vite-based projects, allowing developers to write compile-time transformations using Babel macros. It integrates seamlessly with Vite's plugin system, enabling deferred execution, context-aware transformations, and enhanced code generation. Unlike Babel standalone approaches, this plugin is optimized for Vite's build pipeline and supports TypeScript. Due to its early stage (0.x), backward compatibility is not guaranteed. Release cadence is irregular as the project evolves. Key differentiators: Vite-native macro system with Babel under the hood, TypeScript support, and lightweight integration.

devops
npm install vite-plugin-macro
github ↗package ↗homepage ↗
INSTALL
IMPORT
SIG · VITE-PLUGIN-MACRO
V
vite-plugin-macro
devopsjavascriptv0.2.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.

vitePluginMacro
✓ import vitePluginMacro from 'vite-plugin-macro'
✗ const vitePluginMacro = require('vite-plugin-macro')
Default ESM export only (CJS not provided).
MacroContext
✓ import { MacroContext } from 'vite-plugin-macro'
TypeScript type export; only available in TypeScript projects.
defineMacro
✓ import { defineMacro } from 'vite-plugin-macro'
Named export for defining custom macros.

Demonstrates setting up vite-plugin-macro in a Vite config and defining a simple macro.

// vite.config.ts import { defineConfig } from 'vite'; import vitePluginMacro from 'vite-plugin-macro'; export default defineConfig({ plugins: [ vitePluginMacro(), ], }); // source.ts import { defineMacro } from 'vite-plugin-macro'; defineMacro('myMacro', (ctx) => { console.log('Macro executed with:', ctx.code); }); // CLI: npx vite build
Debug
Known issues
breakingvite-plugin-macro v0.2.0 may break with Vite v3 or later due to internal API changes.
fix
Pin Vite to ^2 or wait for compatible update.
affects: >=0.2.0
gotchaBabel dependencies are not installed automatically; ensure @babel/core is present.
fix
Install @babel/core as a dev dependency.
affects: >=0.1.0
deprecatedThe 'transform' option from v0.1.x is removed in v0.2.0; use 'defineMacro' instead.
fix
Replace 'transform' with 'defineMacro' API.
affects: >=0.2.0
Errors
Common errors & fixes
Error: Cannot find module 'vite-plugin-macro'
Package not installed or path incorrect.
fix
Run 'npm install vite-plugin-macro' and verify import path.
TypeError: vitePluginMacro is not a function
Trying to use non-default import (e.g., named import) instead of default.
fix
Use default import: import vitePluginMacro from 'vite-plugin-macro'
Upgrade
Version history
0.2.0latest on npm
Audit
Dependencies
viterequiredpeer dependency - requires Vite v2 for plugin integration
Agent activity
4 hits · last 30 days
node
4
Resources
githubhttps://github.com/viteland/vite-plugin-macro ↗
packagevite-plugin-macro ↗
homepagehttps://github.com/viteland/vite-plugin-macro/ ↗
vite-plugin-macro — npm install vite-plugin-macro · libregistry