feat: improve Lingo.dev Compiler initialization API

.changeset/compiler-init-improvements.md

@@ -0,0 +1,6 @@
+---
+"@lingo.dev/_compiler": minor
+"lingo.dev": minor
+---
+
+Improved compiler initialization with dedicated framework exports and renamed Next.js integration to `withLingo`

.github/workflows/pr-check.yml

@@ -62,8 +62,20 @@ jobs:
       - name: Configure Turbo cache
         uses: dtinth/setup-github-actions-caching-for-turbo@v1
 
-      - name: Check formatting
-        run: pnpm format:check
+      - name: Check formatting (changed files only)
+        run: |
+          BASE_SHA="${{ github.event.pull_request.base.sha }}"
+          HEAD_SHA="${{ github.sha }}"
+          echo "Base: $BASE_SHA"
+          echo "Head: $HEAD_SHA"
+          # List changed files (added/copied/modified/renamed); exclude deletions
+          mapfile -t files < <(git diff --name-only --diff-filter=ACMR "$BASE_SHA...$HEAD_SHA")
+          if [ ${#files[@]} -eq 0 ]; then
+            echo "No changed files. Skipping Prettier check."
+            exit 0
+          fi
+          echo "Checking formatting for ${#files[@]} changed files."
+          pnpm exec prettier --check --ignore-unknown "${files[@]}"
 
       - name: Build
         run: pnpm turbo build --force

.gitignore

@@ -38,3 +38,4 @@ yarn-error.log*
 .DS_Store
 *.pem
 i18n.cache
+packages/compiler/src/lingo/dictionary.js

demo/adonisjs/bin/test.ts

@@ -10,7 +10,6 @@
 |
 */
 
-// @ts-expect-error 2540
 process.env.NODE_ENV = 'test'
 
 import 'reflect-metadata'

demo/adonisjs/package.json

@@ -49,7 +49,7 @@
     "prettier": "^3.5.3",
     "ts-node-maintained": "^10.9.5",
     "typescript": "~5.8.3",
-    "vite": "^6.3.5"
+    "vite": "^6.0.0"
   },
   "dependencies": {
     "@adonisjs/auth": "^9.4.0",

demo/adonisjs/vite.config.ts

@@ -2,11 +2,21 @@ import { getDirname } from '@adonisjs/core/helpers'
 import inertia from '@adonisjs/inertia/client'
 import adonisjs from '@adonisjs/vite/client'
 import react from '@vitejs/plugin-react'
-import lingoCompiler from 'lingo.dev/compiler'
-import { type UserConfig, type PluginOption } from 'vite'
+import { lingo } from 'lingo.dev/compiler/vite'
+import { type UserConfig } from 'vite'
 
 const viteConfig: UserConfig = {
   plugins: [
+    lingo({
+      sourceRoot: 'inertia',
+      lingoDir: 'lingo',
+      sourceLocale: 'en',
+      targetLocales: ['es'],
+      rsc: false,
+      useDirective: false,
+      debug: false,
+      models: 'lingo.dev',
+    }),
     inertia({
       ssr: {
         enabled: true,
@@ -17,7 +27,7 @@ const viteConfig: UserConfig = {
     adonisjs({
       entrypoints: ['inertia/app/app.tsx'],
       reload: ['resources/views/**/*.edge'],
-    }) as unknown as PluginOption,
+    }),
   ],
   resolve: {
     alias: {
@@ -26,15 +36,4 @@ const viteConfig: UserConfig = {
   },
 }
 
-const withLingo = lingoCompiler.vite({
-  sourceRoot: 'inertia',
-  lingoDir: 'lingo',
-  sourceLocale: 'en',
-  targetLocales: ['es'],
-  rsc: false,
-  useDirective: false,
-  debug: false,
-  models: 'lingo.dev',
-})
-
-export default withLingo(viteConfig)
+export default viteConfig

demo/next-app/next.config.ts

@@ -1,11 +1,11 @@
 import type { NextConfig } from "next";
-import lingoCompiler from "lingo.dev/compiler";
+import { withLingo } from "lingo.dev/compiler/next";
 
 const nextConfig: NextConfig = {
   /* config options here */
 };
 
-export default lingoCompiler.next({
+export default withLingo({
   sourceLocale: "en",
   targetLocales: ["es", "ja", "fr", "ru", "de", "zh", "ar", "ko"],
   models: "lingo.dev",

demo/react-router-app/package.json

@@ -25,7 +25,7 @@
     "@types/react-dom": "^19.1.2",
     "tailwindcss": "^4.1.4",
     "typescript": "^5.8.3",
-    "vite": "^6.3.3",
+    "vite": "^6.0.0",
     "vite-tsconfig-paths": "^5.1.4"
   }
 }

demo/react-router-app/vite.config.ts

@@ -2,17 +2,18 @@ import { reactRouter } from "@react-router/dev/vite";
 import tailwindcss from "@tailwindcss/vite";
 import { defineConfig } from "vite";
 import tsconfigPaths from "vite-tsconfig-paths";
+import { lingo } from "lingo.dev/compiler/vite";
 
-// Compiler: import
-import lingoCompiler from "lingo.dev/compiler";
-
-export default defineConfig(({ isSsrBuild }) =>
-  lingoCompiler.vite({
-    sourceRoot: "app",
-    targetLocales: ["es", "fr", "de"],
-    useDirective: false,
-    models: "lingo.dev",
-  })({
-    plugins: [tailwindcss(), reactRouter(), tsconfigPaths()],
-  }),
-);
+export default defineConfig(({ isSsrBuild }) => ({
+  plugins: [
+    lingo({
+      sourceRoot: "app",
+      targetLocales: ["es", "fr", "de"],
+      useDirective: false,
+      models: "lingo.dev",
+    }),
+    tailwindcss(),
+    reactRouter(),
+    tsconfigPaths(),
+  ],
+}));

demo/vite-project/package.json

@@ -26,6 +26,6 @@
     "lingo.dev": "workspace:*",
     "typescript": "~5.8.3",
     "typescript-eslint": "^8.30.1",
-    "vite": "^6.3.5"
+    "vite": "^6.0.0"
   }
 }

demo/vite-project/vite.config.ts

@@ -1,22 +1,15 @@
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-
-// Compiler: add import
-import lingoCompiler from "lingo.dev/compiler";
-
-const viteConfig = {
-  plugins: [react()],
-};
+import { lingo } from "lingo.dev/compiler/vite";
 
 // https://vite.dev/config/
-export default defineConfig(() =>
-  // Compiler: add lingoCompiler.vite
-  lingoCompiler.vite({
-    sourceRoot: "src",
-    targetLocales: ["es", "fr", "ru", "de", "ja", "zh", "ar", "ko"],
-    models: "lingo.dev",
-  })(viteConfig),
-);
-// export default defineConfig({
-//   plugins: [react()],
-// })
+export default defineConfig(() => ({
+  plugins: [
+    lingo({
+      sourceRoot: "src",
+      targetLocales: ["es", "fr", "ru", "de", "ja", "zh", "ar", "ko"],
+      models: "lingo.dev",
+    }),
+    react(),
+  ],
+}));

packages/cli/package.json

@@ -29,6 +29,16 @@
       "import": "./build/compiler.mjs",
       "require": "./build/compiler.cjs"
     },
+    "./compiler/vite": {
+      "types": "./build/compiler/vite.d.ts",
+      "import": "./build/compiler/vite.mjs",
+      "require": "./build/compiler/vite.cjs"
+    },
+    "./compiler/next": {
+      "types": "./build/compiler/next.d.ts",
+      "import": "./build/compiler/next.mjs",
+      "require": "./build/compiler/next.cjs"
+    },
     "./react": {
       "types": "./build/react.d.ts",
       "import": "./build/react.mjs",
@@ -84,6 +94,12 @@
       "compiler": [
         "./build/compiler.d.ts"
       ],
+      "compiler/vite": [
+        "./build/compiler/vite.d.ts"
+      ],
+      "compiler/next": [
+        "./build/compiler/next.d.ts"
+      ],
       "react": [
         "./build/react.d.ts"
       ],
@@ -144,7 +160,6 @@
     "@markdoc/markdoc": "^0.5.4",
     "@modelcontextprotocol/sdk": "^1.5.0",
     "@openrouter/ai-sdk-provider": "^0.7.1",
-    "@paralleldrive/cuid2": "^2.2.2",
     "@types/ejs": "^3.1.5",
     "ai": "^4.3.15",
     "bitbucket": "^2.12.0",
@@ -233,7 +248,7 @@
     "@types/jsdom": "^21.1.7",
     "@types/lodash": "^4.17.16",
     "@types/mdast": "^4.0.4",
-    "@types/node": "^22.10.2",
+    "@types/node": "^20.19.23",
     "@types/node-gettext": "^3.0.6",
     "@types/object-hash": "^3.0.6",
     "@types/plist": "^3.0.5",

packages/cli/src/compiler/next.ts

@@ -0,0 +1,2 @@
+export type * from "@lingo.dev/_compiler/next";
+export { default, withLingo } from "@lingo.dev/_compiler/next";

packages/cli/src/compiler/vite.ts

@@ -0,0 +1,2 @@
+export type * from "@lingo.dev/_compiler/vite";
+export { default, lingo } from "@lingo.dev/_compiler/vite";

packages/cli/tsup.config.ts

@@ -11,6 +11,8 @@ export default defineConfig({
     "react/rsc": "src/react/rsc.ts",
     "react/react-router": "src/react/react-router.ts",
     compiler: "src/compiler/index.ts",
+    "compiler/vite": "src/compiler/vite.ts",
+    "compiler/next": "src/compiler/next.ts",
     "locale-codes": "src/locale-codes/index.ts",
   },
   outDir: "build",

packages/compiler/package.json

@@ -11,6 +11,23 @@
   "main": "build/index.cjs",
   "types": "build/index.d.ts",
   "module": "build/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "import": "./build/index.mjs",
+      "require": "./build/index.cjs"
+    },
+    "./vite": {
+      "types": "./build/vite.d.ts",
+      "import": "./build/vite.mjs",
+      "require": "./build/vite.cjs"
+    },
+    "./next": {
+      "types": "./build/next.d.ts",
+      "import": "./build/next.mjs",
+      "require": "./build/next.cjs"
+    }
+  },
   "files": [
     "build"
   ],
@@ -35,7 +52,8 @@
     "next": "15.2.4",
     "tsup": "^8.3.5",
     "typescript": "^5.4.5",
-    "vitest": "^2.1.4"
+    "vite": "^6.0.0",
+    "vitest": "^3.1.2"
   },
   "dependencies": {
     "@ai-sdk/google": "^1.2.19",
@@ -55,13 +73,21 @@
     "fast-xml-parser": "^5.0.8",
     "ini": "^5.0.0",
     "lodash": "^4.17.21",
+    "node-machine-id": "^1.1.12",
     "object-hash": "^3.0.0",
     "ollama-ai-provider": "^1.2.0",
+    "posthog-node": "^5.5.1",
     "prettier": "^3.4.2",
     "unplugin": "^2.1.2",
-    "zod": "^3.25.76",
-    "posthog-node": "^5.5.1",
-    "node-machine-id": "^1.1.12"
+    "zod": "^3.25.76"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
   },
   "packageManager": "pnpm@9.12.3"
 }

packages/compiler/src/_base.ts

@@ -1,4 +1,5 @@
-import generate, { GeneratorResult } from "@babel/generator";
+import generate from "./utils/babel-generator";
+import type { GeneratorResult } from "./utils/babel-generator";
 import * as t from "@babel/types";
 import * as parser from "@babel/parser";
 import { LocaleCode } from "@lingo.dev/_spec";

packages/compiler/src/core/unplugin.ts

@@ -0,0 +1 @@
+export { unplugin } from "../unplugin";