unplugin-macros
v0.13.5
Published
Macros for bundlers.
Downloads
16,112
Readme
unplugin-macros
Macros are a mechanism for running JavaScript functions at bundle-time. The value returned from these functions or variables are directly inlined into your bundle.
Installation
# npm
npm i -D unplugin-macros
# jsr
npx jsr add -D @unplugin/macros
// vite.config.ts
import Macros from 'unplugin-macros/vite'
export default defineConfig({
plugins: [Macros()],
})
// rollup.config.js
import Macros from 'unplugin-macros/rollup'
export default {
plugins: [Macros()],
}
Requires esbuild >= 0.15
// esbuild.config.js
import { build } from 'esbuild'
build({
plugins: [require('unplugin-macros/esbuild')()],
})
// webpack.config.js
module.exports = {
/* ... */
plugins: [require('unplugin-macros/webpack')()],
}
Usage
// main.js
import { buildTime, getRandom } from './macros' with { type: 'macro' }
getRandom() // Will be replaced with a random number at build time
buildTime // Will be replaced with the timestamp at the build time
// macros.js
export function getRandom() {
return Math.random()
}
export const buildTime = Date.now()
See more in Bun Macros.
TypeScript
Import Attributes syntax is supported in TypeScript >= 5.3, but you can replace with
keyword with assert
, which is supported in TypeScript >= 4.5.
ESLint
ESLint is not supported Import Attributes syntax yet, but you can use @babel/eslint-parser
or @typescript-eslint/parser
.
// eslint.config.js
import parser from '@babel/eslint-parser'
export default [
{
// ...
languageOptions: {
parser,
parserOptions: {
requireConfigFile: false,
babelOptions: { parserOpts: { plugins: ['importAttributes'] } },
},
},
},
]
Options
Refer to docs.
Thanks
Thanks to Bun Macros.