swc-plugin-react-compiler 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Geunhyeok LEE
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,181 @@
+# swc-plugin-react-compiler
+
+SWC Wasm plugin that runs the Rust port of React Compiler through SWC.
+
+![Preview](./preview.png)
+
+## Important Notice
+
+This is **not** an official React plugin.
+
+This package builds a SWC Wasm plugin around the Rust React Compiler work that is
+currently being developed in the React repository. It is experimental, tracks
+internal compiler APIs, and may break as the upstream Rust port changes.
+
+Use it when you want to try the Rust React Compiler path with SWC today. Do not
+treat it as a production-supported replacement for an official React Compiler
+integration.
+
+## Install
+
+Install the plugin with the package manager your app already uses.
+
+```sh
+npm install -D swc-plugin-react-compiler
+```
+
+```sh
+pnpm add -D swc-plugin-react-compiler
+```
+
+```sh
+yarn add -D swc-plugin-react-compiler
+```
+
+For Vite React apps using SWC, also install `@vitejs/plugin-react-swc` if it is
+not already present.
+
+```sh
+npm install -D @vitejs/plugin-react-swc
+pnpm add -D @vitejs/plugin-react-swc
+yarn add -D @vitejs/plugin-react-swc
+```
+
+## Vite Usage
+
+The package exports the absolute path to the compiled Wasm plugin. Pass that
+path to `@vitejs/plugin-react-swc`.
+
+```ts
+// vite.config.ts
+import react from '@vitejs/plugin-react-swc';
+import { defineConfig } from 'vite';
+import reactCompilerPlugin from 'swc-plugin-react-compiler';
+
+export default defineConfig({
+  plugins: [
+    react({
+      plugins: [[reactCompilerPlugin, { compilationMode: 'all' }]],
+    }),
+  ],
+});
+```
+
+The options object is forwarded to the React Compiler plugin options. For quick
+experiments, `compilationMode: 'all'` makes the transform easier to verify.
+
+## Direct SWC Usage
+
+You can also pass the exported Wasm path directly to `@swc/core`.
+
+```ts
+import { transform } from '@swc/core';
+import reactCompilerPlugin from 'swc-plugin-react-compiler';
+
+const result = await transform(source, {
+  filename: 'Component.tsx',
+  jsc: {
+    parser: {
+      syntax: 'typescript',
+      tsx: true,
+    },
+    target: 'es2022',
+    experimental: {
+      plugins: [[reactCompilerPlugin, { compilationMode: 'all' }]],
+    },
+  },
+});
+
+console.log(result.code);
+```
+
+## Current Constraints
+
+- This package is experimental and unofficial.
+- The Rust implementation is pulled from the React repository and wrapped as a
+  SWC Wasm plugin.
+- The SWC plugin is built against the SWC versions required by the upstream
+  `react_compiler_swc` crate.
+- The transform expects SWC plugin metadata to provide the original source text.
+  If source text cannot be read from the source map, the plugin leaves the module
+  unchanged.
+- Transformed output may import `react/compiler-runtime`, so the consuming app
+  must use a React version that provides that runtime entry.
+
+## Repository Layout
+
+```text
+.
+├── crates/swc-plugin-react-compiler/  # Rust SWC Wasm plugin
+├── src/                               # JS package entry that exports the Wasm path
+├── example/                           # Vite TODO app using the plugin
+├── Cargo.toml                         # Rust workspace
+├── package.json                       # JS workspace
+├── justfile                           # Development tasks
+└── mise.toml                          # Tool versions
+```
+
+## Development
+
+This repository uses `mise` for local tool versions and Yarn 4 with PnP.
+
+Install the configured tools:
+
+```sh
+mise install
+```
+
+Set up the workspace:
+
+```sh
+mise exec -- just setup
+```
+
+Build the Wasm plugin:
+
+```sh
+npm run build
+```
+
+Run all checks:
+
+```sh
+npm run check
+```
+
+Run tests:
+
+```sh
+npm run test
+```
+
+Build the Vite example:
+
+```sh
+npm run example
+```
+
+Run the Vite example in development mode:
+
+```sh
+mise exec -- just example-dev
+```
+
+The dev server serves the TODO example at `http://127.0.0.1:5173/`.
+
+## Task Reference
+
+The `justfile` defines the main development tasks:
+
+```sh
+just build        # Build the Wasm plugin and copy it to the package root
+just check        # cargo check, TypeScript, oxlint, and oxfmt
+just test         # Rust tests
+just example      # Build the Vite TODO example
+just example-dev  # Run the Vite TODO example locally
+just format       # Apply oxfmt
+```
+
+## License
+
+MIT. See [LICENSE](./LICENSE).

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "swc-plugin-react-compiler",
+  "version": "0.0.0",
+  "workspaces": [
+    "example"
+  ],
+  "files": [
+    "./src",
+    "./swc_plugin_react_compiler.wasm"
+  ],
+  "type": "module",
+  "main": "src/index.cjs",
+  "module": "src/index.js",
+  "types": "src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./src/index.js",
+      "require": "./src/index.cjs",
+      "types": "./src/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "mise exec -- just build",
+    "check": "mise exec -- just check",
+    "example": "mise exec -- just example",
+    "format": "mise exec -- just format",
+    "format:check": "mise exec -- just format-check",
+    "lint": "mise exec -- just lint",
+    "test": "mise exec -- just test",
+    "typecheck": "mise exec -- just typecheck"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "oxfmt": "^0.54.0",
+    "oxlint": "^1.69.0",
+    "typescript": "^6.0.3"
+  },
+  "dependenciesMeta": {
+    "oxfmt": {
+      "unplugged": true
+    },
+    "oxlint": {
+      "unplugged": true
+    }
+  },
+  "packageManager": "yarn@4.16.0"
+}

package/src/index.cjs

@@ -0,0 +1,3 @@
+const { resolve } = require('node:path');
+
+module.exports = resolve(__dirname, '..', 'swc_plugin_react_compiler.wasm');

package/src/index.d.ts

@@ -0,0 +1,3 @@
+declare const pluginPath: string;
+
+export default pluginPath;

package/src/index.js

@@ -0,0 +1,7 @@
+import { resolve } from 'node:path';
+
+export default resolve(
+  import.meta.dirname,
+  '..',
+  'swc_plugin_react_compiler.wasm',
+);