Registry / devops / esbuild-plugin-lingui-macro

esbuild-plugin-lingui-macro

library1.0.2jsnpmunverified

An esbuild plugin that automatically adds Babel with @lingui/babel-plugin-lingui-macro to compile Lingui macros (e.g., t, plural, select) during esbuild builds. Version 1.0.2 requires peer dependencies @lingui/cli and @lingui/conf (v5 or v6) and esbuild. Only processes files that import Lingui macros, minimizing overhead. Lightweight alternative to integrating Babel/SWC manually when no other transpiler is in the pipeline. Ships TypeScript types.

devops

npm install esbuild-plugin-lingui-macro

github ↗package ↗

INSTALL

IMPORT

SIG · ESBUILD-PLUGIN-LIN

esbuild-plugin-lingui-macro

devopsjavascriptv1.0.2

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.

pluginLinguiMacro

✓ import { pluginLinguiMacro } from 'esbuild-plugin-lingui-macro'

✗ import pluginLinguiMacro from 'esbuild-plugin-lingui-macro'

Named export only; no default export.

pluginLinguiMacro

✓ const { pluginLinguiMacro } = require('esbuild-plugin-lingui-macro')

✗ const pluginLinguiMacro = require('esbuild-plugin-lingui-macro')

CommonJS must destructure the named export.

pluginLinguiMacro

✓ import type { pluginLinguiMacro } from 'esbuild-plugin-lingui-macro'

✗ import { pluginLinguiMacro } from 'esbuild-plugin-lingui-macro'

For type-only import when not calling directly (e.g., in .d.ts), use import type.

Minimal setup to use the plugin with esbuild, compiling Lingui macros in entry point.

import { pluginLinguiMacro } from 'esbuild-plugin-lingui-macro'; import esbuild from 'esbuild'; await esbuild.build({ entryPoints: ['src/index.ts'], bundle: true, outfile: 'dist/bundle.js', plugins: [pluginLinguiMacro()], });

Debug

Known issues

gotchaPlugin only processes files where a Lingui macro import (e.g., t, plural) is found. It does not run Babel on all files.

fix

Ensure your source files import from @lingui/macro.

affects: >=1.0.0

deprecatedIf you already have Babel or SWC in your esbuild pipeline, prefer using @lingui/babel-plugin-lingui-macro or @lingui/swc-plugin directly instead of this plugin.

fix

Use the respective plugin directly for better performance and flexibility.

affects: >=1.0.0

breakingRequires peer dependencies @lingui/cli and @lingui/conf version 5 or 6. Incompatible with older Lingui versions.

fix

Upgrade Lingui packages to v5 or v6.

affects: 1.0.0 - 1.0.2

gotchaThe plugin adds Babel transformation which can slow down builds. Consider caching if build times are critical.

fix

Implement esbuild caching or use SWC for faster transformation.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module '@lingui/cli'

Missing required peer dependency @lingui/cli.

fix

npm install @lingui/cli --save-dev

TypeError: pluginLinguiMacro is not a function

Incorrect import: used default import instead of named import.

fix

Correct import: import { pluginLinguiMacro } from 'esbuild-plugin-lingui-macro'

Error: [esbuild] [plugin esbuild-plugin-lingui-macro] Babel error: ...

A Babel error occurred during macro compilation, likely due to misconfigured Lingui or syntax error.

fix

Check your Lingui configuration and source files for macro usage. Ensure @lingui/cli is set up correctly.

Upgrade

Version history

1.0.2latest on npm

Audit

Dependencies

@lingui/clirequiredRequired peer dependency for Lingui compilation

@lingui/confrequiredRequired peer dependency for Lingui configuration

esbuildrequiredRequired peer dependency as the build tool

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/timofei-iatsenko/esbuild-plugin-lingui-macro ↗

packagehttps://www.npmjs.com/package/esbuild-plugin-lingui-macro ↗