Feat: Integrate OXC for faster builds and improved Mincho transformations

.github/workflows/ci.yml

@@ -103,6 +103,11 @@ jobs:
         uses: ./.github/actions/cache-dir
         with:
           key: build-and-test
+          paths: |
+            .cache
+            **/.cache
+            dist
+            **/dist
 
       - name: Test
         run: yarn test

.gitignore

@@ -43,9 +43,10 @@ node_modules/
 jspm_packages/
 
 # Package Redirect - Sync with package.json "workspaces"
-configs/*/**/package.json
-packages/*/**/package.json
-examples/*/**/package.json
+# Keep root workspace manifests tracked while ignoring fixture manifests
+configs/*/*/**/package.json
+packages/*/*/**/package.json
+examples/*/*/**/package.json
 
 # Snowpack dependency directory (https://snowpack.dev/)
 web_modules/
@@ -226,4 +227,4 @@ Temporary Items
 .history/
 
 # Built Visual Studio Code Extensions
-*.vsix
+*.vsix

configs/eslint-config-custom/eslint.config.typescript.js

@@ -3,25 +3,24 @@
 
 import { cwd } from "node:process";
 import globals from "globals";
-import { defineConfig } from "eslint/config";
 import eslint from "@eslint/js";
 import tseslint from "typescript-eslint";
 import baseConfig from "./eslint.config.base.js";
 
+/** @typedef {import("typescript-eslint").FlatConfig.Config} FlatConfig */
 /** @typedef {import("typescript-eslint").InfiniteDepthConfigWithExtends} TSConfig */
-/** @typedef {import("eslint").Linter.Config} Config */
-/** @typedef {Config[]} ConfigArray */
+/** @typedef {ReturnType<typeof tseslint.config>} ConfigArray */
 
 /**
  * @export
- * @type {(userConfigs?: TSConfig) => ConfigArray}
+ * @type {(userConfigs?: TSConfig | TSConfig[]) => ConfigArray}
  */
 export function eslintConfig(userConfigs = []) {
-  const normalizedUserConfigs = /** @type {ConfigArray} */ (
-    Array.isArray(userConfigs) ? userConfigs : [userConfigs ?? {}]
-  );
+  const normalizedUserConfigs = Array.isArray(userConfigs)
+    ? userConfigs
+    : [userConfigs ?? {}];
 
-  return defineConfig(
+  return tseslint.config(
     // == Typescript =============================================================
     eslint.configs.recommended,
     ...tseslint.configs.recommended,
@@ -64,7 +63,7 @@ export function eslintConfig(userConfigs = []) {
       extends: [tseslint.configs.disableTypeChecked]
     },
 
-    ...baseConfig,
+    .../** @type {TSConfig[]} */ (baseConfig),
 
     ...normalizedUserConfigs
   );

configs/eslint-config-custom/package.json

@@ -17,10 +17,11 @@
     }
   },
   "devDependencies": {
-    "@eslint/js": "^9.38.0",
+    "@eslint/core": "0.17.0",
+    "@eslint/js": "9.39.0",
     "@types/node": "^24.9.1",
     "@typescript-eslint/parser": "^8.46.2",
-    "eslint": "^9.38.0",
+    "eslint": "9.39.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-yml": "^1.19.0",

configs/tsconfig-custom/tsconfig.base.json

@@ -29,9 +29,8 @@
     "module": "NodeNext",                                /* Specify what module code is generated. */
     // "rootDir": ".",                                   /* Specify the root folder within your source files. */
     "moduleResolution": "nodenext",                      /* Specify how TypeScript looks up a file from a given module specifier. */
-    "baseUrl": ".",                                      /* Specify the base directory to resolve non-relative module names. */
     "paths": {                                           /* Specify a set of entries that re-map imports to additional lookup locations. */
-      "@/*": ["src/*"]
+      "@/*": ["./src/*"]
     },
     // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
     // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */

configs/vite-config-custom/src/index.ts

@@ -50,7 +50,11 @@ function NodeBuilder(viteConfigEnv: ConfigEnv) {
 
   const runtimeEnv = getRuntimeEnv();
   if (ViteEnv.isProd()) {
-    if (runtimeEnv === "LOCAL" || runtimeEnv === "PUBLISH") {
+    if (
+      runtimeEnv === "LOCAL" ||
+      runtimeEnv === "PUBLISH" ||
+      runtimeEnv === "ACTIONS"
+    ) {
       plugins.add(
         // This is currently a proprietary implementation. You might also like to see
         // https://github.com/qmhc/vite-plugin-dts/issues/267

configs/vite-config-custom/tsconfig.json

@@ -1,7 +1,10 @@
 {
   "files": [],
+  "compilerOptions": {
+    "composite": true
+  },
   "references": [
     { "path": "./tsconfig.node.json" },
     { "path": "./tsconfig.lib.json" }
   ]
-}
+}

configs/vite-config-custom/tsconfig.node.json

@@ -1,6 +1,10 @@
 {
   "extends": "tsconfig-custom/tsconfig.node.json",
   "compilerOptions": {
+    "composite": true,
+    "noEmit": false,
+    "declaration": true,
+    "emitDeclarationOnly": true,
     "tsBuildInfoFile": "./.cache/typescript/tsbuildinfo-node",
     "outDir": "./.cache/tsbuild-node"
   },

examples/react-babel/package.json

@@ -35,15 +35,15 @@
     "scheduler": "^0.27.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.38.0",
+    "@eslint/js": "9.39.0",
     "@types/babel__core": "^7.20.5",
     "@types/cssesc": "^3.0.2",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
     "@types/scheduler": "^0.26.0",
     "@typescript-eslint/parser": "^8.46.2",
     "@vitejs/plugin-react": "^5.0.4",
-    "eslint": "^9.38.0",
+    "eslint": "9.39.0",
     "eslint-plugin-react-hooks": "^7.0.0",
     "eslint-plugin-react-refresh": "^0.4.24",
     "globals": "^16.4.0",

examples/react-babel/tsconfig.app.json

@@ -27,11 +27,11 @@
     "noUncheckedSideEffectImports": true,
 
     /* Path Aliases for Workspace Packages */
-    "baseUrl": "../../",
     "paths": {
-      "@mincho-js/react": ["packages/react/src"],
-      "@mincho-js/css": ["packages/css/src"],
-      "@mincho-js/vite": ["packages/vite/src"]
+      "*": ["../../*"],
+      "@mincho-js/react": ["../../packages/react/src"],
+      "@mincho-js/css": ["../../packages/css/src"],
+      "@mincho-js/vite": ["../../packages/vite/src"]
     },
 
     "tsBuildInfoFile": "./.cache/typescript/tsbuildinfo-app"

examples/react-babel/vite.config.ts

@@ -11,18 +11,4 @@ export default defineConfig({
     // Add React plugin without custom Babel config
     react(),
   ],
-  esbuild: {
-    jsxInject: `import React from "react"`,
-  },
-  build: {
-    rollupOptions: {
-      external: [],
-      output: {
-        manualChunks: undefined,
-      },
-    },
-  },
-  resolve: {
-    preserveSymlinks: true,
-  },
 });

examples/react-oxc/.gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

examples/react-oxc/README.md

@@ -0,0 +1,75 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+
+## React Compiler
+
+The React Compiler is enabled on this template. See [this documentation](https://react.dev/learn/react-compiler) for more information.
+
+Note: This will impact Vite dev & build performances.
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x'
+import reactDom from 'eslint-plugin-react-dom'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```

examples/react-oxc/eslint.config.js

@@ -0,0 +1,32 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+import { defineConfig, globalIgnores } from 'eslint/config'
+import { fileURLToPath } from 'node:url'
+import { dirname } from 'node:path'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      js.configs.recommended,
+      tseslint.configs.recommended,
+      reactHooks.configs['recommended-latest'],
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+      parserOptions: {
+        tsconfigRootDir: __dirname,
+        projectService: true,
+        project: ['tsconfig.json']
+      },
+    },
+  },
+])

examples/react-oxc/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>react-oxc</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

examples/react-oxc/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "react-oxc",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@mincho-js/css": "workspace:^",
+    "@mincho-js/integration": "workspace:^",
+    "@mincho-js/react": "workspace:^",
+    "@mincho-js/vite": "workspace:^",
+    "@vanilla-extract/css": "^1.17.4",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "9.39.0",
+    "@types/node": "^24.6.0",
+    "@types/react": "^19.1.16",
+    "@types/react-dom": "^19.1.9",
+    "@vitejs/plugin-react": "^5.0.4",
+    "babel-plugin-react-compiler": "^19.1.0-rc.3",
+    "eslint": "9.39.0",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-refresh": "^0.4.22",
+    "globals": "^16.4.0",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.45.0",
+    "vite": "^7.1.7"
+  }
+}