feat: customizable locale change and name without underscore for a package

Author: AleksandrSl

cmp/compiler/README.md

@@ -18,11 +18,11 @@ This package provides plugins for multiple bundlers (Vite, Webpack, Rollup, esbu
 ## Installation
 
 ```bash
-npm install @lingo.dev/_compiler
+npm install @lingo.dev/compiler
 # or
-pnpm add @lingo.dev/_compiler
+pnpm add @lingo.dev/compiler
 # or
-yarn add @lingo.dev/_compiler
+yarn add @lingo.dev/compiler
 ```
 
 ## Quick Start
@@ -32,7 +32,7 @@ yarn add @lingo.dev/_compiler
 ```ts
 // vite.config.ts
 import { defineConfig } from "vite";
-import { lingoCompilerPlugin } from "@lingo.dev/_compiler/vite";
+import { lingoCompilerPlugin } from "@lingo.dev/compiler/vite";
 
 export default defineConfig({
   plugins: [
@@ -48,7 +48,7 @@ export default defineConfig({
 
 ```js
 // webpack.config.js
-import { lingoCompilerPlugin } from "@lingo.dev/_compiler/webpack";
+import { lingoCompilerPlugin } from "@lingo.dev/compiler/webpack";
 
 export default {
   plugins: [
@@ -64,7 +64,7 @@ export default {
 
 ```js
 // rollup.config.js
-import { lingoCompilerPlugin } from "@lingo.dev/_compiler/rollup";
+import { lingoCompilerPlugin } from "@lingo.dev/compiler/rollup";
 
 export default {
   plugins: [
@@ -81,7 +81,7 @@ export default {
 ```js
 // build.js
 import { build } from "esbuild";
-import { lingoCompilerPlugin } from "@lingo.dev/_compiler/esbuild";
+import { lingoCompilerPlugin } from "@lingo.dev/compiler/esbuild";
 
 await build({
   plugins: [
@@ -97,7 +97,7 @@ await build({
 
 ```js
 // next.config.js
-import { lingoCompilerLoader } from "@lingo.dev/_compiler/next";
+import { lingoCompilerLoader } from "@lingo.dev/compiler/next";
 
 export default {
   webpack: (config) => {
@@ -133,7 +133,7 @@ module.exports = {
       "*.{tsx,jsx}": {
         loaders: [
           {
-            loader: "@lingo.dev/_compiler-beta/loader",
+            loader: "@lingo.dev/compiler-beta/loader",
             options: {
               sourceRoot: "./src", // Root directory of source code
               lingoDir: ".lingo", // Directory for metadata
@@ -241,7 +241,7 @@ import {
   saveMetadata,
   generateTranslationHash,
   type LoaderConfig,
-} from "@lingo.dev/_compiler-beta";
+} from "@lingo.dev/compiler-beta";
 
 // Transform a component
 const config: LoaderConfig = {
@@ -310,13 +310,13 @@ This separation allows the core transformation logic to be reused for other bund
 
 ## Supported Bundlers
 
-| Bundler | Status          | Import Path                    |
-| ------- | --------------- | ------------------------------ |
-| Vite    | ✅ Full Support | `@lingo.dev/_compiler/vite`    |
-| Webpack | ✅ Full Support | `@lingo.dev/_compiler/webpack` |
-| Rollup  | ✅ Full Support | `@lingo.dev/_compiler/rollup`  |
-| esbuild | ✅ Full Support | `@lingo.dev/_compiler/esbuild` |
-| Next.js | ✅ Full Support | `@lingo.dev/_compiler/next`    |
+| Bundler | Status          | Import Path                   |
+| ------- | --------------- | ----------------------------- |
+| Vite    | ✅ Full Support | `@lingo.dev/compiler/vite`    |
+| Webpack | ✅ Full Support | `@lingo.dev/compiler/webpack` |
+| Rollup  | ✅ Full Support | `@lingo.dev/compiler/rollup`  |
+| esbuild | ✅ Full Support | `@lingo.dev/compiler/esbuild` |
+| Next.js | ✅ Full Support | `@lingo.dev/compiler/next`    |
 
 All bundler plugins share the same configuration API and are powered by [unplugin](https://github.com/unjs/unplugin).
 

cmp/compiler/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@lingo.dev/_compiler",
+  "name": "@lingo.dev/compiler",
   "version": "0.0.1",
   "description": "Lingo.dev Compiler Beta",
   "private": false,
@@ -29,16 +29,21 @@
         "default": "./build/react/client/index.cjs"
       }
     },
-    "./config": {
-      "types": "./build/config.d.ts",
-      "import": "./build/config.mjs",
-      "require": "./build/config.cjs"
-    },
     "./dev-config": {
       "types": "./build/dev-config.d.ts",
       "import": "./build/dev-config.mjs",
       "require": "./build/dev-config.cjs"
     },
+    "./locale/server": {
+      "types": "./build/locale/server.d.ts",
+      "import": "./build/locale/server.mjs",
+      "require": "./build/locale/server.cjs"
+    },
+    "./locale/client": {
+      "types": "./build/locale/client.d.ts",
+      "import": "./build/locale/client.mjs",
+      "require": "./build/locale/client.cjs"
+    },
     "./react/client": {
       "types": "./build/react/index.d.ts",
       "import": "./build/react/index.mjs",
@@ -100,6 +105,16 @@
       "types": "./build/plugin/dev-server-loader.d.ts",
       "import": "./build/plugin/dev-server-loader.mjs",
       "require": "./build/plugin/dev-server-loader.cjs"
+    },
+    "./turbopack-locale-server-loader": {
+      "types": "./build/plugin/turbopack-locale-server-loader.d.ts",
+      "import": "./build/plugin/turbopack-locale-server-loader.mjs",
+      "require": "./build/plugin/turbopack-locale-server-loader.cjs"
+    },
+    "./turbopack-locale-client-loader": {
+      "types": "./build/plugin/turbopack-locale-client-loader.d.ts",
+      "import": "./build/plugin/turbopack-locale-client-loader.mjs",
+      "require": "./build/plugin/turbopack-locale-client-loader.cjs"
     }
   },
   "files": [

cmp/compiler/src/config.ts

@@ -0,0 +1,19 @@
+/**
+ * Get the current locale on the client
+ * Reads from cookie
+ * @returns Resolved locale code
+ */
+export function getClientLocale(): string {
+  return "en";
+}
+
+const __NOOP_PERSIST_LOCALE__ = () => {};
+
+/**
+ * Persist the locale on the client
+ * Writes to cookie
+ * @param locale - Locale code to persist
+ */
+export function persistLocale(locale: string): void {
+  return __NOOP_PERSIST_LOCALE__();
+}

cmp/compiler/src/locale/client.ts

@@ -0,0 +1,8 @@
+/**
+ * Get the current locale on the server
+ * Uses cookies, headers, or other server-side mechanisms
+ * @returns Resolved locale code
+ */
+export async function getServerLocale(): Promise<string> {
+  return "en";
+}

cmp/compiler/src/locale/server.ts

@@ -6,7 +6,7 @@
  * - "translate": Generate all translations, fail if translation fails
  * - "cache-only": Validate cache completeness, fail if incomplete
  */
-
+// TODO (AleksandrSl 08/12/2025): Add ICU validation for messages? The problem is that we don't know which will be rendered as a simple text
 import fs from "fs/promises";
 import path from "path";
 import type { LingoConfig, MetadataSchema } from "../types";
@@ -19,17 +19,8 @@ import {
 import { loadMetadata } from "../metadata/manager";
 
 export interface BuildTranslationOptions {
-  /**
-   * Lingo configuration
-   */
   config: LingoConfig;
 
-  /**
-   * Build mode (overrides config.buildMode if provided)
-   * Can be set via LINGO_BUILD_MODE environment variable
-   */
-  buildMode?: "translate" | "cache-only";
-
   /**
    * Output directory for static translation files
    * If not provided, files won't be generated
@@ -74,12 +65,10 @@ export async function processBuildTranslations(
   // Determine build mode (env var > options > config)
   const buildMode =
     (process.env.LINGO_BUILD_MODE as "translate" | "cache-only") ||
-    options.buildMode ||
     config.buildMode;
 
   logger.info(`🌍 Build mode: ${buildMode}`);
 
-  // Load metadata
   const metadata = await loadMetadata(config);
 
   if (!metadata || Object.keys(metadata.entries).length === 0) {
@@ -99,7 +88,6 @@ export async function processBuildTranslations(
     await validateCache(config, metadata);
     logger.info("✅ Cache validation passed");
 
-    // Copy cache to public directory if requested
     if (publicOutputPath) {
       await copyStaticFiles(config, publicOutputPath);
     }
@@ -210,7 +198,6 @@ async function validateCache(
       const cacheContent = await fs.readFile(cacheFilePath, "utf-8");
       const cache = JSON.parse(cacheContent) as Record<string, string>;
 
-      // Check if all hashes exist in cache
       const missingHashes = allHashes.filter((hash) => !cache[hash]);
 
       if (missingHashes.length > 0) {
@@ -242,9 +229,6 @@ async function validateCache(
   }
 }
 
-/**
- * Build statistics from cache files
- */
 function buildCacheStats(
   config: LingoConfig,
   metadata: MetadataSchema,
@@ -263,9 +247,6 @@ function buildCacheStats(
   return stats;
 }
 
-/**
- * Copy cached translation files to public directory
- */
 async function copyStaticFiles(
   config: LingoConfig,
   publicOutputPath: string,
@@ -288,9 +269,6 @@ async function copyStaticFiles(
   }
 }
 
-/**
- * Format cache validation error message
- */
 function formatCacheValidationError(
   missingLocales: string[],
   incompleteLocales: Array<{ locale: string; missing: number; total: number }>,
@@ -322,9 +300,6 @@ function formatCacheValidationError(
   return msg;
 }
 
-/**
- * Format translation error message
- */
 function formatTranslationErrors(
   errors: Array<{ locale: string; error: string }>,
 ): string {

cmp/compiler/src/plugin/build-translator.ts

@@ -14,7 +14,7 @@ export default async function devServerLoader(
   if (typeof this.async !== "function") {
     throw new Error("This module must be run as a loader");
   }
-  logger.debug("devServerLoader called", this.resourcePath);
+  logger.debug("Running devServerLoader");
   const callback = this.async();
   const isDev = process.env.NODE_ENV === "development";
 
@@ -46,7 +46,6 @@ export default async function devServerLoader(
     source
       // TODO (AleksandrSl 04/12/2025): Should we just error instead of the default?
       .replace("__SERVER_URL__", server?.url || `http://127.0.0.1:${startPort}`)
-      // TODO (AleksandrSl 04/12/2025): Make cacheDir work
       .replace("__CACHE_DIR__", getCacheDir(config)),
   );
 }

cmp/compiler/src/plugin/dev-server-loader.ts

@@ -5,7 +5,7 @@
  * ```js
  * // build.js
  * import { build } from 'esbuild';
- * import { lingoCompilerPlugin } from '@lingo.dev/_compiler/esbuild';
+ * import { lingoCompilerPlugin } from '@lingo.dev/compiler/esbuild';
  *
  * await build({
  *   plugins: [

cmp/compiler/src/plugin/esbuild.ts

@@ -0,0 +1,49 @@
+/**
+ * Shared code generation for locale resolution modules
+ * Used by both unplugin (virtual modules) and Turbopack loaders
+ */
+
+import type { LingoConfig } from "../types";
+
+/**
+ * Generate server-side locale detection code
+ * Reads locale from cookie
+ */
+export function generateServerLocaleCode(config: LingoConfig): string {
+  return `
+  try {
+    const { cookies } = await import('next/headers');
+    const cookieStore = await cookies();
+    const locale = cookieStore.get(${JSON.stringify(config.cookieConfig.name)})?.value;
+    return locale || ${JSON.stringify(config.sourceLocale)};
+  } catch (error) {
+    // Fallback if cookies are not available
+    return ${JSON.stringify(config.sourceLocale)};
+  }`;
+}
+
+/**
+ * Generate client-side locale detection and persistence code
+ * Includes both getClientLocale() and persistLocale() functions
+ */
+export function generateClientLocaleCode(config: LingoConfig): {
+  getClientLocale: string;
+  persistLocale: string;
+} {
+  const cookieName = config.cookieConfig.name;
+  const maxAge = config.cookieConfig.maxAge;
+
+  return {
+    getClientLocale: `
+  if (typeof document !== 'undefined') {
+    const match = document.cookie.match(/${cookieName}=([^;]+)/);
+    if (match) return match[1];
+  }
+  // Fallback to source locale
+  return ${JSON.stringify(config.sourceLocale)};
+`,
+    persistLocale: `if (typeof document !== 'undefined') {
+    document.cookie = \`${cookieName}=\${locale}; path=/; max-age=${maxAge}\`;
+  }`,
+  };
+}