@nkzw/eslint-plugin-fbtee 1.7.5 → 1.8.0

package/README.md

@@ -43,14 +43,74 @@ Sometimes it's easiest to learn by example and copy-paste the setup from existin
 npm install fbtee
 ```
 
-In addition to `fbtee`, you need to install the Babel preset.
+In addition to `fbtee`, you need to install the compiler integration for your build tool. For Babel-based builds, install the Babel preset. This keeps the existing `fbtee` CLI commands available through the Babel tooling package:
 
 ```bash
 npm install -D @nkzw/babel-preset-fbtee
 ```
 
+For SWC or Turbopack builds, install the SWC plugin and the standalone CLI package:
+
+```bash
+npm install -D @nkzw/swc-plugin-fbtee @nkzw/fbtee-cli
+```
+
 ### Tooling Setup
 
+#### Using **fbtee** with SWC or Turbopack
+
+Use the SWC plugin when your build pipeline runs through SWC instead of Babel, such as Turbopack. Phrase extraction still uses `fbtee collect`; install `@nkzw/fbtee-cli` for SWC-only projects that do not install the Babel preset. The SWC plugin is the runtime compiler that lowers `fbt` and `<fbt>` callsites during application builds.
+
+For raw SWC configuration:
+
+```json
+{
+  "jsc": {
+    "experimental": {
+      "plugins": [
+        [
+          "@nkzw/swc-plugin-fbtee",
+          {
+            "fbtCommon": {
+              "Accept": "Button/Link: Accept conditions"
+            },
+            "fbtEnumManifest": {}
+          }
+        ]
+      ]
+    },
+    "parser": {
+      "syntax": "typescript",
+      "tsx": true
+    }
+  }
+}
+```
+
+For Next.js SWC plugins:
+
+```js
+export default {
+  experimental: {
+    swcPlugins: [
+      [
+        '@nkzw/swc-plugin-fbtee',
+        {
+          fbtCommon: {
+            Accept: 'Button/Link: Accept conditions',
+          },
+          fbtEnumManifest: {},
+        },
+      ],
+    ],
+  },
+};
+```
+
+Do not pass `collectFbt: true` to the SWC plugin. Use `fbtee collect` for extraction and the SWC plugin for compiling app code.
+
+#### Using **fbtee** with Vite
+
 If you are using Vite, install the React plugin for Vite:
 
 ```bash
@@ -94,7 +154,7 @@ export default defineConfig({
 });
 ```
 
-#### Using **fbtee** with Next.js
+#### Using **fbtee** with Next.js and Babel
 
 Create a `babel.config.js` file in the root of your Next.js project and add the **fbtee** preset:
 
@@ -338,7 +398,7 @@ const Greeting = () => (
 // Example Output: "Alice, Bob and Charlie won the game against 2 bots on the map Forest Battle."
 ```
 
-_Note: `<fbt>` is auto-imported for you by the `@nkzw/babel-preset-fbtee` plugin._
+_Note: `<fbt>` is auto-imported for you by the fbtee compiler integration._
 
 This example highlights several features of **fbtee**:
 
@@ -451,7 +511,7 @@ After marking your strings for translation with `<fbt>`, run the following comma
 pnpm fbtee collect
 ```
 
-You can now upload the `source_strings.json` file to your translation provider, for example [Crowdin](https://crowdin.com/). If you'd like to manually edit the strings, you can use the `fbtee prepare-translations --locales de_DE` to generate a JSON file that can be edited directly.
+You can now upload the `source_strings.json` file to your translation provider, for example [Crowdin](https://crowdin.com/). If you'd like to manually edit the strings, you can use the `fbtee prepare-translations --locales de_DE` to generate a JSON file that can be edited directly. Pass `--sort-by-hash` to keep entries in a deterministic order for cleaner diffs when the file is committed.
 
 #### Generated File Structure
 

package/lib/index.mjs

@@ -1,7 +1,7 @@
 import { ESLintUtils } from "@typescript-eslint/utils";
 //#region package.json
 var name = "@nkzw/eslint-plugin-fbtee";
-var version = "1.7.4";
+var version = "1.8.0";
 //#endregion
 //#region src/utils.tsx
 const createRule = ESLintUtils.RuleCreator((name) => `https://github.com/nkzw-tech/fbtee/blob/main/packages/eslint-plugin-fbtee/docs/rules/${name}.md`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nkzw/eslint-plugin-fbtee",
-  "version": "1.7.5",
+  "version": "1.8.0",
   "description": "",
   "keywords": [],
   "repository": {