lingui-swc-plugin-patch
Version:
A SWC Plugin for LinguiJS
126 lines (101 loc) • 5.62 kB
Markdown
# <div align="center">A SWC Plugin For LinguiJS</div>
<div align="center">
A Rust versions of [LinguiJS Macro](https://lingui.dev/ref/macro) [<img src="https://img.shields.io/badge/beta-yellow"/>](https://github.com/lingui/swc-plugin)
[](https://www.npmjs.com/package/lingui-swc-plugin-patch)
[](https://www.npmjs.com/package/lingui-swc-plugin-patch)
[](https://github.com/lingui/swc-plugin/actions/workflows/ci.yml)
[](https://codecov.io/gh/lingui/swc-plugin)
[](https://github.com/lingui/swc-plugin/graphs/contributors)
[](https://github.com/lingui/swc-plugin/blob/main/LICENSE)
</div>
## Installation
Install plugin:
```bash
npm install --save-dev lingui-swc-plugin-patch
# or
yarn add -D lingui-swc-plugin-patch
```
You still need to install `@lingui/macro` for typings support:
```bash
npm install @lingui/macro
# or
yarn add @lingui/macro
```
## Usage
`.swcrc`
https://swc.rs/docs/configuration/swcrc
```json5
{
"$schema": "https://json.schemastore.org/swcrc",
"jsc": {
"experimental": {
"plugins": [
[
"lingui-swc-plugin-patch",
{
// Optional
// Unlike the JS version this option must be passed as object only.
// Docs https://lingui.dev/ref/conf#runtimeconfigmodule
// "runtimeModules": {
// "i18n": ["@lingui/core", "i18n"],
// "trans": ["@lingui/react", "Trans"]
// }
// Lingui strips non-essential fields in production builds for performance.
// You can override the default behavior with:
// "stripNonEssentialFields": false/true
},
],
],
},
},
}
```
Or Next JS Usage:
`next.config.js`
```js
/** @type {import('next').NextConfig} */
const nextConfig = {
reactStrictMode: true,
experimental: {
swcPlugins: [
['lingui-swc-plugin-patch', {
// the same options as in .swcrc
}],
],
},
};
module.exports = nextConfig;
```
> **Note**
> Consult with full working example for NextJS in the `/examples` folder in this repo.
## Compatibility
SWC Plugin support is still experimental. They do not guarantee a semver backwards compatibility between different `swc-core` versions.
So you need to select an appropriate version of the plugin to match compatible `swc_core` using a https://plugins.swc.rs/.
Below is a table referencing the swc_core version used during the plugin build, along with a link to the plugin's site to check compatibility with runtimes for this swc_core range.
| Plugin Version | used `swc_core` |
|---------------------------------------------------|-------------------------------------------------------|
| `0.1.0`, `4.0.0-next.0` | `0.52.8` |
| `0.2.*`, `4.0.0-next.1` ~ `4.0.0-next.3` | `0.56.1` |
| `4.0.0` | `0.75.33` |
| `4.0.1` | `0.76.0` |
| `4.0.2` | `0.76.41` |
| `4.0.3` | `0.78.28` |
| `4.0.4` | `0.79.x` |
| `4.0.5`, `4.0.6` | [`0.87.x`](https://plugins.swc.rs/versions/range/10) |
| `4.0.7`, `4.0.8`, `5.0.0-next.0` ~ `5.0.0-next.1` | [`0.90.35`](https://plugins.swc.rs/versions/range/12) |
| `4.0.9` | [`0.96.9`](https://plugins.swc.rs/versions/range/15) |
| `4.0.10` | [`0.101.4`](https://plugins.swc.rs/versions/range/94) |
| `4.1.0`, `5.0.0` ~ `5.2.0` | [`0.106.3`](https://plugins.swc.rs/versions/range/95) |
| `5.3.0` | [`5.0.4`](https://plugins.swc.rs/versions/range/116) |
| `5.4.0` | [`14.1.0`](https://plugins.swc.rs/versions/range/138) |
| `5.5.0` ~ `5.5.2` | [`15.0.1`](https://plugins.swc.rs/versions/range/271) |
| `5.6.0` ~ `5.6.1` | [`27.0.6`](https://plugins.swc.rs/versions/range/364) |
> **Note**
> next `v13.2.4` ~ `v13.3.1` cannot execute SWC Wasm plugins, due to a [bug of next-swc](https://github.com/vercel/next.js/issues/46989#issuecomment-1486989081).
>
> next `v13.4.3` ~ `v13.4.5-canary.7` cannot execute SWC Wasm plugins, due to [missing filesystem cache](https://github.com/vercel/next.js/pull/50651).
- Version `0.1.0` ~ `0.*` compatible with `@lingui/core@3.*`
- Version `4.*` compatible with `@lingui/core@4.*`
- Version `5.*` compatible with `@lingui/core@5.*`
## License
The project is licensed under the [MIT](https://github.com/lingui/swc-plugin/blob/main/LICENSE) license.