@nkzw/vite-plugin-fbtee 3.1.0 → 3.3.0

package/README.md

@@ -10,14 +10,14 @@ const Greeting = ({ name }) => (
 );
 ```
 
-_fbtee_ is a modern continuation of Facebook's `fbt`, rebuilt for TypeScript, ESM, React 19, Vite, Babel, SWC, Next.js & Oxc.
+_fbtee_ is a modern continuation of Facebook's `fbt`, rebuilt for TypeScript, ESM, React 19, Vite, Next.js, Babel & Oxc.
 
 ## Features
 
 - **Inline translations for Better Developer Experience:** Embed translations directly into your code. No need to manage translation keys or wrap your code with `t()` functions. **fbtee** uses a compiler to extract strings from your code and prepare them for translation providers.
 - **Proven in Production:** Built on Facebook's `fbt`, with over a decade of production usage serving billions of users, plus years in production at [Athena Crisis](https://athenacrisis.com).
 - **Optimized Performance with IR:** Compiles translations into an Intermediate Representation (IR) for extracting strings, then optimizes the runtime output for performance.
-- **Easy Setup:** Quick integration with Vite, Babel, SWC, Oxc, Next.js, and Expo.
+- **Easy Setup:** Quick integration with Vite, Next.js, Babel, Oxc, and Expo.
 
 ## Getting Started
 
@@ -62,49 +62,44 @@ export default defineConfig({
 });
 ```
 
-### Babel
+### Next.js
 
-Install the Babel preset and the CLI:
+Next.js projects should use the native Oxc plugin and the CLI:
 
 ```bash
-npm install -D @nkzw/babel-preset-fbtee @nkzw/fbtee-cli
+npm install -D @nkzw/next-plugin-fbtee @nkzw/fbtee-cli
 ```
 
-Add the preset to your Babel configuration:
+Wrap your Next configuration:
 
 ```js
-export default {
-  presets: ['@nkzw/babel-preset-fbtee'],
-};
+import withFbtee from '@nkzw/next-plugin-fbtee';
+
+export default withFbtee({
+  fbtCommon: {
+    Accept: 'Button label for accepting terms',
+  },
+  fbtEnumManifest: {},
+})({
+  // Your Next.js configuration.
+});
 ```
 
-### SWC
+The plugin runs the native Oxc transform before Next.js compilation. It works with the default Turbopack compiler and with `next build --webpack`, so it does not require Babel or custom compiler configuration.
+
+### Babel
 
-Install the SWC runtime compiler and the CLI:
+Install the Babel preset and the CLI:
 
 ```bash
-npm install -D @nkzw/swc-plugin-fbtee @nkzw/fbtee-cli
+npm install -D @nkzw/babel-preset-fbtee @nkzw/fbtee-cli
 ```
 
-For Next.js SWC plugins:
+Add the preset to your Babel configuration:
 
 ```js
-import { createFbteePluginOptions } from '@nkzw/swc-plugin-fbtee/index.js';
-
 export default {
-  experimental: {
-    swcPlugins: [
-      [
-        '@nkzw/swc-plugin-fbtee',
-        createFbteePluginOptions({
-          fbtCommon: {
-            Accept: 'Button label for accepting terms',
-          },
-          fbtEnumManifest: {},
-        }),
-      ],
-    ],
-  },
+  presets: ['@nkzw/babel-preset-fbtee'],
 };
 ```
 
@@ -159,10 +154,7 @@ Use `fbt()` outside JSX:
 ```tsx
 import { fbt } from 'fbtee';
 
-const title = fbt(
-  'No tasks yet',
-  'Empty state title when a project has no tasks',
-);
+const title = fbt('No tasks yet', 'Empty state title when a project has no tasks');
 ```
 
 Use `fbs()` when you need a plain string:
@@ -170,9 +162,7 @@ Use `fbs()` when you need a plain string:
 ```tsx
 import { fbs } from 'fbtee';
 
-<input
-  placeholder={fbs('Search projects', 'Project search input placeholder')}
-/>;
+<input placeholder={fbs('Search projects', 'Project search input placeholder')} />;
 ```
 
 ## Dynamic Content
@@ -202,12 +192,7 @@ Use `<fbt:plural>` when a count controls grammar. _fbtee_ handles locale-specifi
 ```tsx
 <fbt desc="Inbox unread count">
   You have{' '}
-  <fbt:plural
-    count={count}
-    many="unread messages"
-    name="unreadCount"
-    showCount="yes"
-  >
+  <fbt:plural count={count} many="unread messages" name="unreadCount" showCount="yes">
     an unread message
   </fbt:plural>
   .
@@ -340,6 +325,19 @@ See the [Next.js fbtee example](https://github.com/cpojer/nextjs-fbtee-example)
 
 ## Translation Workflow
 
+Every CLI command can use the native Oxc/Rust pipeline by adding `--oxc`:
+
+```bash
+pnpm fbtee collect --oxc
+pnpm fbtee prepare-translations --oxc --source-strings source_strings.json --output-dir translations
+pnpm fbtee translate --oxc --source-strings source_strings.json --translations 'translations/*.json' --output-dir src/translations
+pnpm fbtee migrate-locales --oxc --to bcp47 --dir translations --dir src/translations
+```
+
+The Babel pipeline remains the default during the parity rollout, so removing `--oxc` makes it easy to compare both implementations. Successful native outputs are tested byte-for-byte against Babel. The native collector intentionally cannot execute Babel-specific JavaScript extensions: `--custom-collector`, `--transform`, and `--generate-fbt-nodes` are unavailable with `--oxc`.
+
+The Oxc collector also cannot run plugins or presets from a Babel configuration file or apply `.babelignore`. If it detects Babel configuration or ignore rules, it stops instead of silently collecting different source. Use the Babel collector when that preprocessing is required, or pass `--disable-babel-config` to explicitly collect the unmodified source with Oxc. All other documented options are supported.
+
 Extract source strings:
 
 ```bash

package/index.d.ts

@@ -1,10 +1,7 @@
 import type { TransformOptions } from '@nkzw/oxc-transform-fbtee';
 import type { Plugin } from 'vite';
 
-export type FbteeVitePluginOptions = Omit<
-  TransformOptions,
-  'lang' | 'sourcemap' | 'sourceType'
->;
+export type FbteeVitePluginOptions = Omit<TransformOptions, 'lang' | 'sourcemap' | 'sourceType'>;
 
 export declare const fbtee: (options?: FbteeVitePluginOptions) => Plugin;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nkzw/vite-plugin-fbtee",
-  "version": "3.1.0",
+  "version": "3.3.0",
   "description": "Vite plugin for fbtee powered by the native Oxc transform.",
   "keywords": [
     "fbt",
@@ -9,14 +9,22 @@
     "oxc",
     "vite"
   ],
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nkzw-tech/fbtee.git",
     "directory": "packages/vite-plugin-fbtee"
   },
-  "license": "MIT",
-  "sideEffects": false,
+  "files": [
+    "LICENSE",
+    "README.md",
+    "index.d.ts",
+    "index.js"
+  ],
   "type": "module",
+  "sideEffects": false,
+  "main": "index.js",
+  "types": "index.d.ts",
   "exports": {
     ".": {
       "types": "./index.d.ts",
@@ -24,16 +32,8 @@
       "default": "./index.js"
     }
   },
-  "main": "index.js",
-  "types": "index.d.ts",
-  "files": [
-    "LICENSE",
-    "README.md",
-    "index.d.ts",
-    "index.js"
-  ],
   "dependencies": {
-    "@nkzw/oxc-transform-fbtee": "3.1.0"
+    "@nkzw/oxc-transform-fbtee": "3.3.0"
   },
   "devDependencies": {
     "vite": "^8.1.5"