Registry / testing / esbuild-plugin-lingui-react-email-macro

esbuild-plugin-lingui-react-email-macro

library1.0.2jsnpmunverified

An esbuild plugin that transforms Lingui i18n macros in React Email files before bundling. Version 1.0.2. It integrates Lingui's macro system (like t, plural, select) with React Email's build pipeline, extracting translations and converting macros to runtime calls. Key differentiator: specifically designed for use with React Email, not generic Lingui esbuild setups.

testing

npm install esbuild-plugin-lingui-react-email-macro

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ESBUILD-PLUGIN-LIN

esbuild-plugin-lingui-react-email-macro

testingjavascriptv1.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.

linguiReactEmailMacro

✓ import { linguiReactEmailMacro } from 'esbuild-plugin-lingui-react-email-macro'

✗ import linguiReactEmailMacro from 'esbuild-plugin-lingui-react-email-macro'

Named export only; no default export.

linguiReactEmailMacro

✓ const { linguiReactEmailMacro } = require('esbuild-plugin-lingui-react-email-macro')

✗ const linguiReactEmailMacro = require('esbuild-plugin-lingui-react-email-macro')

CommonJS destructured require is correct.

Plugin type

✓ import type { Plugin } from 'esbuild'

✗ import { Plugin } from 'esbuild-plugin-lingui-react-email-macro'

Plugin type is from esbuild, not from this package.

Demonstrates using the plugin with esbuild to bundle a React Email file with Lingui macros.

import { build } from 'esbuild'; import { linguiReactEmailMacro } from 'esbuild-plugin-lingui-react-email-macro'; build({ entryPoints: ['src/email.tsx'], outfile: 'dist/email.js', bundle: true, plugins: [linguiReactEmailMacro()], }).catch(() => process.exit(1));

Debug

Known issues

gotchaPlugin must be placed in the plugins array; accidental omission will leave macros untransformed.

fix

Include linguiReactEmailMacro() in the plugins array.

affects: >=0.0.0

gotchaRequires that Lingui is configured with babel macro support; plugin only transforms macros, it does not configure Lingui.

fix

Ensure your project has Lingui set up (lingui.config.js) and macros are enabled.

affects: >=0.0.0

gotchaThis plugin is specifically for React Email; using it with non-email React code may not work as expected.

fix

Use a general Lingui esbuild plugin for non-email React projects.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Macro not found for 't'

Lingui macros not configured or plugin not applied before bundling.

fix

Ensure lingui.config.js exists and the plugin is added to esbuild's plugins array.

TypeError: plugin is not a function

Incorrect import: attempting to use default import instead of named.

fix

Use import { linguiReactEmailMacro } from 'esbuild-plugin-lingui-react-email-macro'.

Module not found: Error: Can't resolve 'react-email'

React Email package not installed, but it is required for the plugin's intended use.

fix

Install react-email: npm install react-email.

Upgrade

Version history

1.0.2latest on npm

Audit

Dependencies

esbuildrequiredPeer dependency; plugin runs as an esbuild plugin.

react-emailoptionalTarget framework; plugin transforms macros in React Email files.

Agent activity

7 hits · last 30 days

node

Resources

githubhttps://github.com/itsyoboieltr/esbuild-plugin-lingui-react-email-macro ↗

packageesbuild-plugin-lingui-react-email-macro ↗

homepagehttps://github.com/itsyoboieltr/esbuild-plugin-lingui-react-email-macro#readme ↗