@lingo.dev/_compiler 0.10.0 → 0.11.0

package/README.md

@@ -1,5 +1,92 @@
-# Lingo.dev Compiler
+# Lingo.dev Compiler (Legacy)
 
-**Lingo.dev Compiler** is a free, open-source compiler middleware, that makes React apps multilingual at build time without requiring any changes to the existing React components.
+> **DEPRECATED:** This package (`@lingo.dev/_compiler`) is deprecated. Please migrate to `@lingo.dev/compiler` (the new compiler).
 
-Documentation: https://lingo.dev/compiler
+## Migration
+
+Install the new compiler:
+
+```bash
+npm install @lingo.dev/compiler
+```
+
+Update your configuration:
+
+**Next.js (before):**
+```ts
+import lingoCompiler from "@lingo.dev/_compiler";
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {};
+
+export default lingoCompiler.next({
+  sourceRoot: "app",
+  models: "lingo.dev",
+})(nextConfig);
+```
+
+**Next.js (after):**
+```ts
+import type { NextConfig } from "next";
+import { withLingo } from "@lingo.dev/compiler/next";
+
+const nextConfig: NextConfig = {};
+
+export default async function (): Promise<NextConfig> {
+  return await withLingo(nextConfig, {
+    sourceLocale: "en",
+    targetLocales: ["es", "fr"],
+    models: "lingo.dev",
+  });
+}
+```
+
+**Vite (before):**
+```ts
+import { defineConfig, type UserConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import lingoCompiler from "@lingo.dev/_compiler";
+
+const viteConfig: UserConfig = {
+  plugins: [react()],
+};
+
+export default defineConfig(() =>
+  lingoCompiler.vite({
+    models: "lingo.dev",
+  })(viteConfig)
+);
+```
+
+**Vite (after):**
+```ts
+import { defineConfig, type UserConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { withLingo } from "@lingo.dev/compiler/vite";
+
+const viteConfig: UserConfig = {
+  plugins: [react()],
+};
+
+export default defineConfig(async () =>
+  await withLingo(viteConfig, {
+    sourceLocale: "en",
+    targetLocales: ["es", "fr"],
+    models: "lingo.dev",
+  })
+);
+```
+
+## New Compiler Features
+
+The new compiler (`@lingo.dev/compiler`) offers:
+
+- Advanced virtual module system for better code splitting
+- Built-in development translation server
+- Pluralization detection with ICU MessageFormat support
+- Improved metadata management for better caching
+- Thread-safe concurrent build support
+
+## Documentation
+
+Full documentation: [lingo.dev/compiler](https://lingo.dev/compiler)

package/build/{chunk-DZX4HCIU.cjs → chunk-5WTAUBGE.cjs}

@@ -9487,7 +9487,7 @@ var require_lib2 = __commonJS({
       }
       return highlighted;
     }
-    var deprecationWarningShown = false;
+    var deprecationWarningShown2 = false;
     var NEWLINE = /\r\n|[\n\r\u2028\u2029]/;
     function getMarkerLines(loc, source2, opts) {
       const startLoc = Object.assign({
@@ -9589,8 +9589,8 @@ ${frame}`;
       }
     }
     function index(rawLines, lineNumber, colNumber, opts = {}) {
-      if (!deprecationWarningShown) {
-        deprecationWarningShown = true;
+      if (!deprecationWarningShown2) {
+        deprecationWarningShown2 = true;
         const message = "Passing lineNumber and colNumber is deprecated to @babel/code-frame. Please use `codeFrameColumns`.";
         if (process.emitWarning) {
           process.emitWarning(message, "DeprecationWarning");
@@ -20190,6 +20190,29 @@ var providerDetails = {
   }
 };
 
+// src/_deprecation.ts
+var DEPRECATION_WARNING = `
+\u26A0\uFE0F  DEPRECATION WARNING: @lingo.dev/_compiler is deprecated.
+   Please migrate to @lingo.dev/compiler (the new compiler).
+
+   The new compiler offers:
+   \u2022 Advanced virtual module system for better code splitting
+   \u2022 Built-in development translation server
+   \u2022 Pluralization detection with ICU MessageFormat support
+   \u2022 Improved metadata management for better caching
+   \u2022 Thread-safe concurrent build support
+
+   Migration guide: https://lingo.dev/compiler
+
+   This legacy compiler will be removed in a future release.
+`;
+var deprecationWarningShown = false;
+function showDeprecationWarning() {
+  if (deprecationWarningShown) return;
+  deprecationWarningShown = true;
+  console.warn(DEPRECATION_WARNING);
+}
+
 // src/_loader-utils.ts
 
 
@@ -22592,4 +22615,5 @@ function transformComponent(options8) {
 
 
 
-exports.defaultParams = defaultParams; exports.LCP_DICTIONARY_FILE_NAME = LCP_DICTIONARY_FILE_NAME; exports.LCPCache = LCPCache; exports.getInvalidLocales = getInvalidLocales; exports.getRc = getRc; exports.getGroqKeyFromRc = getGroqKeyFromRc; exports.getGroqKeyFromEnv = getGroqKeyFromEnv; exports.getLingoDotDevKeyFromEnv = getLingoDotDevKeyFromEnv; exports.getLingoDotDevKeyFromRc = getLingoDotDevKeyFromRc; exports.getGoogleKeyFromRc = getGoogleKeyFromRc; exports.getGoogleKeyFromEnv = getGoogleKeyFromEnv; exports.getMistralKeyFromRc = getMistralKeyFromRc; exports.getMistralKeyFromEnv = getMistralKeyFromEnv; exports.isRunningInCIOrDocker = isRunningInCIOrDocker; exports.providerDetails = providerDetails; exports.loadDictionary = loadDictionary; exports.transformComponent = transformComponent;
+
+exports.defaultParams = defaultParams; exports.LCP_DICTIONARY_FILE_NAME = LCP_DICTIONARY_FILE_NAME; exports.LCPCache = LCPCache; exports.getInvalidLocales = getInvalidLocales; exports.getRc = getRc; exports.getGroqKeyFromRc = getGroqKeyFromRc; exports.getGroqKeyFromEnv = getGroqKeyFromEnv; exports.getLingoDotDevKeyFromEnv = getLingoDotDevKeyFromEnv; exports.getLingoDotDevKeyFromRc = getLingoDotDevKeyFromRc; exports.getGoogleKeyFromRc = getGoogleKeyFromRc; exports.getGoogleKeyFromEnv = getGoogleKeyFromEnv; exports.getMistralKeyFromRc = getMistralKeyFromRc; exports.getMistralKeyFromEnv = getMistralKeyFromEnv; exports.isRunningInCIOrDocker = isRunningInCIOrDocker; exports.providerDetails = providerDetails; exports.showDeprecationWarning = showDeprecationWarning; exports.loadDictionary = loadDictionary; exports.transformComponent = transformComponent;

package/build/{chunk-B6UBZSM3.mjs → chunk-TJ26WFK7.mjs}

@@ -9486,7 +9486,7 @@ var require_lib2 = __commonJS({
       }
       return highlighted;
     }
-    var deprecationWarningShown = false;
+    var deprecationWarningShown2 = false;
     var NEWLINE = /\r\n|[\n\r\u2028\u2029]/;
     function getMarkerLines(loc, source2, opts) {
       const startLoc = Object.assign({
@@ -9588,8 +9588,8 @@ ${frame}`;
       }
     }
     function index(rawLines, lineNumber, colNumber, opts = {}) {
-      if (!deprecationWarningShown) {
-        deprecationWarningShown = true;
+      if (!deprecationWarningShown2) {
+        deprecationWarningShown2 = true;
         const message = "Passing lineNumber and colNumber is deprecated to @babel/code-frame. Please use `codeFrameColumns`.";
         if (process.emitWarning) {
           process.emitWarning(message, "DeprecationWarning");
@@ -20189,6 +20189,29 @@ var providerDetails = {
   }
 };
 
+// src/_deprecation.ts
+var DEPRECATION_WARNING = `
+\u26A0\uFE0F  DEPRECATION WARNING: @lingo.dev/_compiler is deprecated.
+   Please migrate to @lingo.dev/compiler (the new compiler).
+
+   The new compiler offers:
+   \u2022 Advanced virtual module system for better code splitting
+   \u2022 Built-in development translation server
+   \u2022 Pluralization detection with ICU MessageFormat support
+   \u2022 Improved metadata management for better caching
+   \u2022 Thread-safe concurrent build support
+
+   Migration guide: https://lingo.dev/compiler
+
+   This legacy compiler will be removed in a future release.
+`;
+var deprecationWarningShown = false;
+function showDeprecationWarning() {
+  if (deprecationWarningShown) return;
+  deprecationWarningShown = true;
+  console.warn(DEPRECATION_WARNING);
+}
+
 // src/_loader-utils.ts
 import _11 from "lodash";
 import path19 from "path";
@@ -22589,6 +22612,7 @@ export {
   getMistralKeyFromEnv,
   isRunningInCIOrDocker,
   providerDetails,
+  showDeprecationWarning,
   loadDictionary,
   transformComponent
 };

package/build/index.cjs

@@ -16,7 +16,8 @@
 
 
 
-var _chunkDZX4HCIUcjs = require('./chunk-DZX4HCIU.cjs');
+
+var _chunk5WTAUBGEcjs = require('./chunk-5WTAUBGE.cjs');
 
 
 var _chunkO75UYLMXcjs = require('./chunk-O75UYLMX.cjs');
@@ -27,7 +28,7 @@ var _unplugin = require('unplugin');
 // package.json
 var package_default = {
   name: "@lingo.dev/_compiler",
-  version: "0.10.0",
+  version: "0.11.0",
   description: "Lingo.dev Compiler",
   private: false,
   repository: {
@@ -261,7 +262,7 @@ async function getDistinctId() {
   };
 }
 async function tryGetEmail() {
-  const rc = _chunkDZX4HCIUcjs.getRc.call(void 0, );
+  const rc = _chunk5WTAUBGEcjs.getRc.call(void 0, );
   const apiKey = process.env.LINGODOTDEV_API_KEY || _optionalChain([rc, 'optionalAccess', _5 => _5.auth, 'optionalAccess', _6 => _6.apiKey]);
   const apiUrl = process.env.LINGODOTDEV_API_URL || _optionalChain([rc, 'optionalAccess', _7 => _7.auth, 'optionalAccess', _8 => _8.apiUrl]) || "https://engine.lingo.dev";
   if (!apiKey) {
@@ -289,20 +290,20 @@ async function tryGetEmail() {
 // src/index.ts
 var keyCheckers = {
   groq: {
-    checkEnv: _chunkDZX4HCIUcjs.getGroqKeyFromEnv,
-    checkRc: _chunkDZX4HCIUcjs.getGroqKeyFromRc
+    checkEnv: _chunk5WTAUBGEcjs.getGroqKeyFromEnv,
+    checkRc: _chunk5WTAUBGEcjs.getGroqKeyFromRc
   },
   google: {
-    checkEnv: _chunkDZX4HCIUcjs.getGoogleKeyFromEnv,
-    checkRc: _chunkDZX4HCIUcjs.getGoogleKeyFromRc
+    checkEnv: _chunk5WTAUBGEcjs.getGoogleKeyFromEnv,
+    checkRc: _chunk5WTAUBGEcjs.getGoogleKeyFromRc
   },
   mistral: {
-    checkEnv: _chunkDZX4HCIUcjs.getMistralKeyFromEnv,
-    checkRc: _chunkDZX4HCIUcjs.getMistralKeyFromRc
+    checkEnv: _chunk5WTAUBGEcjs.getMistralKeyFromEnv,
+    checkRc: _chunk5WTAUBGEcjs.getMistralKeyFromRc
   },
   "lingo.dev": {
-    checkEnv: _chunkDZX4HCIUcjs.getLingoDotDevKeyFromEnv,
-    checkRc: _chunkDZX4HCIUcjs.getLingoDotDevKeyFromRc
+    checkEnv: _chunk5WTAUBGEcjs.getLingoDotDevKeyFromEnv,
+    checkRc: _chunk5WTAUBGEcjs.getLingoDotDevKeyFromRc
   }
 };
 var alreadySentBuildEvent = { value: false };
@@ -317,15 +318,16 @@ function sendBuildEvent(framework, config, isDev) {
 }
 var unplugin = _unplugin.createUnplugin.call(void 0, 
   (_params, _meta) => {
+    _chunk5WTAUBGEcjs.showDeprecationWarning.call(void 0, );
     console.log("\u2139\uFE0F  Starting Lingo.dev compiler...");
-    const params = _lodash2.default.defaults(_params, _chunkDZX4HCIUcjs.defaultParams);
-    if (!_chunkDZX4HCIUcjs.isRunningInCIOrDocker.call(void 0, )) {
+    const params = _lodash2.default.defaults(_params, _chunk5WTAUBGEcjs.defaultParams);
+    if (!_chunk5WTAUBGEcjs.isRunningInCIOrDocker.call(void 0, )) {
       if (params.models === "lingo.dev") {
         validateLLMKeyDetails(["lingo.dev"]);
       } else {
         const configuredProviders = getConfiguredProviders(params.models);
         validateLLMKeyDetails(configuredProviders);
-        const invalidLocales = _chunkDZX4HCIUcjs.getInvalidLocales.call(void 0, 
+        const invalidLocales = _chunk5WTAUBGEcjs.getInvalidLocales.call(void 0, 
           params.models,
           params.sourceLocale,
           params.targetLocales
@@ -344,7 +346,7 @@ var unplugin = _unplugin.createUnplugin.call(void 0,
         }
       }
     }
-    _chunkDZX4HCIUcjs.LCPCache.ensureDictionaryFile({
+    _chunk5WTAUBGEcjs.LCPCache.ensureDictionaryFile({
       sourceRoot: params.sourceRoot,
       lingoDir: params.lingoDir
     });
@@ -352,9 +354,9 @@ var unplugin = _unplugin.createUnplugin.call(void 0,
     sendBuildEvent("unplugin", params, isDev);
     return {
       name: package_default.name,
-      loadInclude: (id) => !!id.match(_chunkDZX4HCIUcjs.LCP_DICTIONARY_FILE_NAME),
+      loadInclude: (id) => !!id.match(_chunk5WTAUBGEcjs.LCP_DICTIONARY_FILE_NAME),
       async load(id) {
-        const dictionary = await _chunkDZX4HCIUcjs.loadDictionary.call(void 0, {
+        const dictionary = await _chunk5WTAUBGEcjs.loadDictionary.call(void 0, {
           resourcePath: id,
           resourceQuery: "",
           params: {
@@ -378,7 +380,7 @@ var unplugin = _unplugin.createUnplugin.call(void 0,
       enforce: "pre",
       transform(code, id) {
         try {
-          const result = _chunkDZX4HCIUcjs.transformComponent.call(void 0, {
+          const result = _chunk5WTAUBGEcjs.transformComponent.call(void 0, {
             code,
             params,
             resourcePath: id,
@@ -398,13 +400,32 @@ var index_default = {
   /**
    * Initializes Lingo.dev Compiler for Next.js (App Router).
    *
+   * @deprecated This legacy compiler is deprecated. Please migrate to `@lingo.dev/compiler`.
+   * See migration guide at https://lingo.dev/compiler
+   *
    * @param compilerParams - The compiler parameters.
    *
    * @returns The Next.js configuration.
    *
-   * @example Configuration for Next.js's default template
+   * @example New compiler usage (recommended):
    * ```ts
-   * import lingoCompiler from "lingo.dev/compiler";
+   * import type { NextConfig } from "next";
+   * import { withLingo } from "@lingo.dev/compiler/next";
+   *
+   * const nextConfig: NextConfig = {};
+   *
+   * export default async function (): Promise<NextConfig> {
+   *   return await withLingo(nextConfig, {
+   *     sourceLocale: "en",
+   *     targetLocales: ["es", "fr"],
+   *     models: "lingo.dev",
+   *   });
+   * }
+   * ```
+   *
+   * @example Legacy compiler usage (deprecated):
+   * ```ts
+   * import lingoCompiler from "@lingo.dev/_compiler";
    * import type { NextConfig } from "next";
    *
    * const nextConfig: NextConfig = {
@@ -418,9 +439,10 @@ var index_default = {
    * ```
    */
   next: (compilerParams) => (nextConfig = {}) => {
+    _chunk5WTAUBGEcjs.showDeprecationWarning.call(void 0, );
     const mergedParams = _lodash2.default.merge(
       {},
-      _chunkDZX4HCIUcjs.defaultParams,
+      _chunk5WTAUBGEcjs.defaultParams,
       {
         rsc: true,
         turbopack: {
@@ -486,17 +508,38 @@ var index_default = {
   /**
    * Initializes Lingo.dev Compiler for Vite.
    *
+   * @deprecated This legacy compiler is deprecated. Please migrate to `@lingo.dev/compiler`.
+   * See migration guide at https://lingo.dev/compiler
+   *
    * @param compilerParams - The compiler parameters.
    *
    * @returns The Vite configuration.
    *
-   * @example Configuration for Vite's "react-ts" template
+   * @example New compiler usage (recommended):
+   * ```ts
+   * import { defineConfig, type UserConfig } from "vite";
+   * import react from "@vitejs/plugin-react";
+   * import { withLingo } from "@lingo.dev/compiler/vite";
+   *
+   * const viteConfig: UserConfig = {
+   *   plugins: [react()],
+   * };
+   *
+   * export default defineConfig(async () =>
+   *   await withLingo(viteConfig, {
+   *     sourceLocale: "en",
+   *     targetLocales: ["es", "fr"],
+   *     models: "lingo.dev",
+   *   })
+   * );
+   * ```
+   *
+   * @example Legacy Vite configuration (deprecated):
    * ```ts
    * import { defineConfig, type UserConfig } from "vite";
    * import react from "@vitejs/plugin-react";
-   * import lingoCompiler from "lingo.dev/compiler";
+   * import lingoCompiler from "@lingo.dev/_compiler";
    *
-   * // https://vite.dev/config/
    * const viteConfig: UserConfig = {
    *   plugins: [react()],
    * };
@@ -508,11 +551,11 @@ var index_default = {
    * );
    * ```
    *
-   * @example Configuration for React Router's default template
+   * @example Legacy React Router configuration (deprecated):
    * ```ts
    * import { reactRouter } from "@react-router/dev/vite";
    * import tailwindcss from "@tailwindcss/vite";
-   * import lingoCompiler from "lingo.dev/compiler";
+   * import lingoCompiler from "@lingo.dev/_compiler";
    * import { defineConfig, type UserConfig } from "vite";
    * import tsconfigPaths from "vite-tsconfig-paths";
    *
@@ -529,9 +572,10 @@ var index_default = {
    * ```
    */
   vite: (compilerParams) => (config) => {
+    _chunk5WTAUBGEcjs.showDeprecationWarning.call(void 0, );
     const mergedParams = _lodash2.default.merge(
       {},
-      _chunkDZX4HCIUcjs.defaultParams,
+      _chunk5WTAUBGEcjs.defaultParams,
       { rsc: false },
       compilerParams
     );
@@ -545,7 +589,7 @@ var index_default = {
 };
 function getConfiguredProviders(models) {
   return _lodash2.default.chain(Object.values(models)).map((modelString) => modelString.split(":")[0]).filter(Boolean).uniq().filter(
-    (providerId) => _chunkDZX4HCIUcjs.providerDetails.hasOwnProperty(providerId) && keyCheckers.hasOwnProperty(providerId)
+    (providerId) => _chunk5WTAUBGEcjs.providerDetails.hasOwnProperty(providerId) && keyCheckers.hasOwnProperty(providerId)
   ).value();
 }
 function validateLLMKeyDetails(configuredProviders) {
@@ -556,7 +600,7 @@ function validateLLMKeyDetails(configuredProviders) {
   const missingProviders = [];
   const foundProviders = [];
   for (const providerId of configuredProviders) {
-    const details = _chunkDZX4HCIUcjs.providerDetails[providerId];
+    const details = _chunk5WTAUBGEcjs.providerDetails[providerId];
     const checkers = keyCheckers[providerId];
     if (!details || !checkers) continue;
     const foundInEnv = !!checkers.checkEnv();

package/build/index.d.cts

@@ -128,13 +128,32 @@ declare const _default: {
     /**
      * Initializes Lingo.dev Compiler for Next.js (App Router).
      *
+     * @deprecated This legacy compiler is deprecated. Please migrate to `@lingo.dev/compiler`.
+     * See migration guide at https://lingo.dev/compiler
+     *
      * @param compilerParams - The compiler parameters.
      *
      * @returns The Next.js configuration.
      *
-     * @example Configuration for Next.js's default template
+     * @example New compiler usage (recommended):
      * ```ts
-     * import lingoCompiler from "lingo.dev/compiler";
+     * import type { NextConfig } from "next";
+     * import { withLingo } from "@lingo.dev/compiler/next";
+     *
+     * const nextConfig: NextConfig = {};
+     *
+     * export default async function (): Promise<NextConfig> {
+     *   return await withLingo(nextConfig, {
+     *     sourceLocale: "en",
+     *     targetLocales: ["es", "fr"],
+     *     models: "lingo.dev",
+     *   });
+     * }
+     * ```
+     *
+     * @example Legacy compiler usage (deprecated):
+     * ```ts
+     * import lingoCompiler from "@lingo.dev/_compiler";
      * import type { NextConfig } from "next";
      *
      * const nextConfig: NextConfig = {
@@ -156,17 +175,38 @@ declare const _default: {
     /**
      * Initializes Lingo.dev Compiler for Vite.
      *
+     * @deprecated This legacy compiler is deprecated. Please migrate to `@lingo.dev/compiler`.
+     * See migration guide at https://lingo.dev/compiler
+     *
      * @param compilerParams - The compiler parameters.
      *
      * @returns The Vite configuration.
      *
-     * @example Configuration for Vite's "react-ts" template
+     * @example New compiler usage (recommended):
+     * ```ts
+     * import { defineConfig, type UserConfig } from "vite";
+     * import react from "@vitejs/plugin-react";
+     * import { withLingo } from "@lingo.dev/compiler/vite";
+     *
+     * const viteConfig: UserConfig = {
+     *   plugins: [react()],
+     * };
+     *
+     * export default defineConfig(async () =>
+     *   await withLingo(viteConfig, {
+     *     sourceLocale: "en",
+     *     targetLocales: ["es", "fr"],
+     *     models: "lingo.dev",
+     *   })
+     * );
+     * ```
+     *
+     * @example Legacy Vite configuration (deprecated):
      * ```ts
      * import { defineConfig, type UserConfig } from "vite";
      * import react from "@vitejs/plugin-react";
-     * import lingoCompiler from "lingo.dev/compiler";
+     * import lingoCompiler from "@lingo.dev/_compiler";
      *
-     * // https://vite.dev/config/
      * const viteConfig: UserConfig = {
      *   plugins: [react()],
      * };
@@ -178,11 +218,11 @@ declare const _default: {
      * );
      * ```
      *
-     * @example Configuration for React Router's default template
+     * @example Legacy React Router configuration (deprecated):
      * ```ts
      * import { reactRouter } from "@react-router/dev/vite";
      * import tailwindcss from "@tailwindcss/vite";
-     * import lingoCompiler from "lingo.dev/compiler";
+     * import lingoCompiler from "@lingo.dev/_compiler";
      * import { defineConfig, type UserConfig } from "vite";
      * import tsconfigPaths from "vite-tsconfig-paths";
      *

package/build/index.d.ts

@@ -128,13 +128,32 @@ declare const _default: {
     /**
      * Initializes Lingo.dev Compiler for Next.js (App Router).
      *
+     * @deprecated This legacy compiler is deprecated. Please migrate to `@lingo.dev/compiler`.
+     * See migration guide at https://lingo.dev/compiler
+     *
      * @param compilerParams - The compiler parameters.
      *
      * @returns The Next.js configuration.
      *
-     * @example Configuration for Next.js's default template
+     * @example New compiler usage (recommended):
      * ```ts
-     * import lingoCompiler from "lingo.dev/compiler";
+     * import type { NextConfig } from "next";
+     * import { withLingo } from "@lingo.dev/compiler/next";
+     *
+     * const nextConfig: NextConfig = {};
+     *
+     * export default async function (): Promise<NextConfig> {
+     *   return await withLingo(nextConfig, {
+     *     sourceLocale: "en",
+     *     targetLocales: ["es", "fr"],
+     *     models: "lingo.dev",
+     *   });
+     * }
+     * ```
+     *
+     * @example Legacy compiler usage (deprecated):
+     * ```ts
+     * import lingoCompiler from "@lingo.dev/_compiler";
      * import type { NextConfig } from "next";
      *
      * const nextConfig: NextConfig = {
@@ -156,17 +175,38 @@ declare const _default: {
     /**
      * Initializes Lingo.dev Compiler for Vite.
      *
+     * @deprecated This legacy compiler is deprecated. Please migrate to `@lingo.dev/compiler`.
+     * See migration guide at https://lingo.dev/compiler
+     *
      * @param compilerParams - The compiler parameters.
      *
      * @returns The Vite configuration.
      *
-     * @example Configuration for Vite's "react-ts" template
+     * @example New compiler usage (recommended):
+     * ```ts
+     * import { defineConfig, type UserConfig } from "vite";
+     * import react from "@vitejs/plugin-react";
+     * import { withLingo } from "@lingo.dev/compiler/vite";
+     *
+     * const viteConfig: UserConfig = {
+     *   plugins: [react()],
+     * };
+     *
+     * export default defineConfig(async () =>
+     *   await withLingo(viteConfig, {
+     *     sourceLocale: "en",
+     *     targetLocales: ["es", "fr"],
+     *     models: "lingo.dev",
+     *   })
+     * );
+     * ```
+     *
+     * @example Legacy Vite configuration (deprecated):
      * ```ts
      * import { defineConfig, type UserConfig } from "vite";
      * import react from "@vitejs/plugin-react";
-     * import lingoCompiler from "lingo.dev/compiler";
+     * import lingoCompiler from "@lingo.dev/_compiler";
      *
-     * // https://vite.dev/config/
      * const viteConfig: UserConfig = {
      *   plugins: [react()],
      * };
@@ -178,11 +218,11 @@ declare const _default: {
      * );
      * ```
      *
-     * @example Configuration for React Router's default template
+     * @example Legacy React Router configuration (deprecated):
      * ```ts
      * import { reactRouter } from "@react-router/dev/vite";
      * import tailwindcss from "@tailwindcss/vite";
-     * import lingoCompiler from "lingo.dev/compiler";
+     * import lingoCompiler from "@lingo.dev/_compiler";
      * import { defineConfig, type UserConfig } from "vite";
      * import tsconfigPaths from "vite-tsconfig-paths";
      *

package/build/index.mjs

@@ -15,8 +15,9 @@ import {
   isRunningInCIOrDocker,
   loadDictionary,
   providerDetails,
+  showDeprecationWarning,
   transformComponent
-} from "./chunk-B6UBZSM3.mjs";
+} from "./chunk-TJ26WFK7.mjs";
 import {
   __require
 } from "./chunk-6BWS3CLP.mjs";
@@ -27,7 +28,7 @@ import { createUnplugin } from "unplugin";
 // package.json
 var package_default = {
   name: "@lingo.dev/_compiler",
-  version: "0.10.0",
+  version: "0.11.0",
   description: "Lingo.dev Compiler",
   private: false,
   repository: {
@@ -317,6 +318,7 @@ function sendBuildEvent(framework, config, isDev) {
 }
 var unplugin = createUnplugin(
   (_params, _meta) => {
+    showDeprecationWarning();
     console.log("\u2139\uFE0F  Starting Lingo.dev compiler...");
     const params = _.defaults(_params, defaultParams);
     if (!isRunningInCIOrDocker()) {
@@ -398,13 +400,32 @@ var index_default = {
   /**
    * Initializes Lingo.dev Compiler for Next.js (App Router).
    *
+   * @deprecated This legacy compiler is deprecated. Please migrate to `@lingo.dev/compiler`.
+   * See migration guide at https://lingo.dev/compiler
+   *
    * @param compilerParams - The compiler parameters.
    *
    * @returns The Next.js configuration.
    *
-   * @example Configuration for Next.js's default template
+   * @example New compiler usage (recommended):
    * ```ts
-   * import lingoCompiler from "lingo.dev/compiler";
+   * import type { NextConfig } from "next";
+   * import { withLingo } from "@lingo.dev/compiler/next";
+   *
+   * const nextConfig: NextConfig = {};
+   *
+   * export default async function (): Promise<NextConfig> {
+   *   return await withLingo(nextConfig, {
+   *     sourceLocale: "en",
+   *     targetLocales: ["es", "fr"],
+   *     models: "lingo.dev",
+   *   });
+   * }
+   * ```
+   *
+   * @example Legacy compiler usage (deprecated):
+   * ```ts
+   * import lingoCompiler from "@lingo.dev/_compiler";
    * import type { NextConfig } from "next";
    *
    * const nextConfig: NextConfig = {
@@ -418,6 +439,7 @@ var index_default = {
    * ```
    */
   next: (compilerParams) => (nextConfig = {}) => {
+    showDeprecationWarning();
     const mergedParams = _.merge(
       {},
       defaultParams,
@@ -486,17 +508,38 @@ var index_default = {
   /**
    * Initializes Lingo.dev Compiler for Vite.
    *
+   * @deprecated This legacy compiler is deprecated. Please migrate to `@lingo.dev/compiler`.
+   * See migration guide at https://lingo.dev/compiler
+   *
    * @param compilerParams - The compiler parameters.
    *
    * @returns The Vite configuration.
    *
-   * @example Configuration for Vite's "react-ts" template
+   * @example New compiler usage (recommended):
+   * ```ts
+   * import { defineConfig, type UserConfig } from "vite";
+   * import react from "@vitejs/plugin-react";
+   * import { withLingo } from "@lingo.dev/compiler/vite";
+   *
+   * const viteConfig: UserConfig = {
+   *   plugins: [react()],
+   * };
+   *
+   * export default defineConfig(async () =>
+   *   await withLingo(viteConfig, {
+   *     sourceLocale: "en",
+   *     targetLocales: ["es", "fr"],
+   *     models: "lingo.dev",
+   *   })
+   * );
+   * ```
+   *
+   * @example Legacy Vite configuration (deprecated):
    * ```ts
    * import { defineConfig, type UserConfig } from "vite";
    * import react from "@vitejs/plugin-react";
-   * import lingoCompiler from "lingo.dev/compiler";
+   * import lingoCompiler from "@lingo.dev/_compiler";
    *
-   * // https://vite.dev/config/
    * const viteConfig: UserConfig = {
    *   plugins: [react()],
    * };
@@ -508,11 +551,11 @@ var index_default = {
    * );
    * ```
    *
-   * @example Configuration for React Router's default template
+   * @example Legacy React Router configuration (deprecated):
    * ```ts
    * import { reactRouter } from "@react-router/dev/vite";
    * import tailwindcss from "@tailwindcss/vite";
-   * import lingoCompiler from "lingo.dev/compiler";
+   * import lingoCompiler from "@lingo.dev/_compiler";
    * import { defineConfig, type UserConfig } from "vite";
    * import tsconfigPaths from "vite-tsconfig-paths";
    *
@@ -529,6 +572,7 @@ var index_default = {
    * ```
    */
   vite: (compilerParams) => (config) => {
+    showDeprecationWarning();
     const mergedParams = _.merge(
       {},
       defaultParams,

package/build/lingo-turbopack-loader.cjs

@@ -1,16 +1,18 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkDZX4HCIUcjs = require('./chunk-DZX4HCIU.cjs');
+
+var _chunk5WTAUBGEcjs = require('./chunk-5WTAUBGE.cjs');
 require('./chunk-O75UYLMX.cjs');
 
 // src/lingo-turbopack-loader.ts
 async function lingo_turbopack_loader_default(source) {
+  _chunk5WTAUBGEcjs.showDeprecationWarning.call(void 0, );
   const callback = this.async();
   const params = this.getOptions();
   const isDev = process.env.NODE_ENV !== "production";
   try {
-    const dictionary = await _chunkDZX4HCIUcjs.loadDictionary.call(void 0, {
+    const dictionary = await _chunk5WTAUBGEcjs.loadDictionary.call(void 0, {
       resourcePath: this.resourcePath,
       resourceQuery: this.resourceQuery,
       params,
@@ -22,7 +24,7 @@ async function lingo_turbopack_loader_default(source) {
       const code = `export default ${JSON.stringify(dictionary, null, 2)};`;
       return callback(null, code);
     }
-    const result = _chunkDZX4HCIUcjs.transformComponent.call(void 0, {
+    const result = _chunk5WTAUBGEcjs.transformComponent.call(void 0, {
       code: source,
       params,
       resourcePath: this.resourcePath,

package/build/lingo-turbopack-loader.d.cts

@@ -1,3 +1,7 @@
+/**
+ * @deprecated This loader is part of the legacy compiler. Please migrate to @lingo.dev/compiler.
+ * See migration guide at https://lingo.dev/compiler
+ */
 declare function export_default(this: any, source: string): Promise<any>;
 
 export { export_default as default };

package/build/lingo-turbopack-loader.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @deprecated This loader is part of the legacy compiler. Please migrate to @lingo.dev/compiler.
+ * See migration guide at https://lingo.dev/compiler
+ */
 declare function export_default(this: any, source: string): Promise<any>;
 
 export { export_default as default };

package/build/lingo-turbopack-loader.mjs

@@ -1,11 +1,13 @@
 import {
   loadDictionary,
+  showDeprecationWarning,
   transformComponent
-} from "./chunk-B6UBZSM3.mjs";
+} from "./chunk-TJ26WFK7.mjs";
 import "./chunk-6BWS3CLP.mjs";
 
 // src/lingo-turbopack-loader.ts
 async function lingo_turbopack_loader_default(source) {
+  showDeprecationWarning();
   const callback = this.async();
   const params = this.getOptions();
   const isDev = process.env.NODE_ENV !== "production";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingo.dev/_compiler",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Lingo.dev Compiler",
   "private": false,
   "repository": {
@@ -65,8 +65,8 @@
     "posthog-node": "5.14.0",
     "unplugin": "2.3.11",
     "zod": "4.1.12",
-    "@lingo.dev/_sdk": "0.13.7",
-    "@lingo.dev/_spec": "0.46.0"
+    "@lingo.dev/_sdk": "0.14.0",
+    "@lingo.dev/_spec": "0.47.0"
   },
   "scripts": {
     "dev": "tsup --watch",