@lingo.dev/compiler 0.2.0 → 0.3.1

package/build/metadata/manager.cjs

@@ -106,11 +106,11 @@ var MetadataManager = class {
 		}
 		const release = await proper_lockfile.default.lock(this.filePath, {
 			retries: {
-				retries: 10,
+				retries: 20,
 				minTimeout: 50,
-				maxTimeout: 1e3
+				maxTimeout: 2e3
 			},
-			stale: 2e3
+			stale: 5e3
 		});
 		try {
 			const currentMetadata = await this.loadMetadata();

package/build/metadata/manager.mjs

@@ -1,9 +1,9 @@
 import { logger } from "../utils/logger.mjs";
 import { DEFAULT_TIMEOUTS, withTimeout } from "../utils/timeout.mjs";
 import { getLingoDir } from "../utils/path-helpers.mjs";
-import fsPromises from "fs/promises";
+import fs from "fs/promises";
 import path from "path";
-import fs from "fs";
+import fs$1 from "fs";
 import lockfile from "proper-lockfile";
 
 //#region src/metadata/manager.ts
@@ -22,7 +22,7 @@ function loadMetadata(path$1) {
 function cleanupExistingMetadata(metadataFilePath) {
 	logger.debug(`Attempting to cleanup metadata file: ${metadataFilePath}`);
 	try {
-		fs.unlinkSync(metadataFilePath);
+		fs$1.unlinkSync(metadataFilePath);
 		logger.info(`🧹 Cleaned up build metadata file: ${metadataFilePath}`);
 	} catch (error) {
 		if (error.code === "ENOENT") logger.debug(`Metadata file already deleted or doesn't exist: ${metadataFilePath}`);
@@ -50,7 +50,7 @@ var MetadataManager = class {
 	*/
 	async loadMetadata() {
 		try {
-			const content = await withTimeout(fsPromises.readFile(this.filePath, "utf-8"), DEFAULT_TIMEOUTS.METADATA, "Load metadata");
+			const content = await withTimeout(fs.readFile(this.filePath, "utf-8"), DEFAULT_TIMEOUTS.METADATA, "Load metadata");
 			return JSON.parse(content);
 		} catch (error) {
 			if (error.code === "ENOENT") return createEmptyMetadata();
@@ -62,7 +62,7 @@ var MetadataManager = class {
 	* Times out after 15 seconds to prevent indefinite hangs
 	*/
 	async saveMetadata(metadata) {
-		await withTimeout(fsPromises.mkdir(path.dirname(this.filePath), { recursive: true }), DEFAULT_TIMEOUTS.FILE_IO, "Create metadata directory");
+		await withTimeout(fs.mkdir(path.dirname(this.filePath), { recursive: true }), DEFAULT_TIMEOUTS.FILE_IO, "Create metadata directory");
 		metadata.stats = {
 			totalEntries: Object.keys(metadata.entries).length,
 			lastUpdated: (/* @__PURE__ */ new Date()).toISOString()
@@ -71,17 +71,17 @@ var MetadataManager = class {
 		const base = path.basename(this.filePath);
 		const tmpPath = path.join(dir, `.${base}.tmp-${process.pid}-${Date.now()}`);
 		const json = JSON.stringify(metadata, null, 2);
-		await withTimeout(fsPromises.writeFile(tmpPath, json, "utf-8"), DEFAULT_TIMEOUTS.METADATA, "Save metadata (tmp write)");
+		await withTimeout(fs.writeFile(tmpPath, json, "utf-8"), DEFAULT_TIMEOUTS.METADATA, "Save metadata (tmp write)");
 		try {
-			await withTimeout(fsPromises.rename(tmpPath, this.filePath), DEFAULT_TIMEOUTS.METADATA, "Save metadata (atomic rename)");
+			await withTimeout(fs.rename(tmpPath, this.filePath), DEFAULT_TIMEOUTS.METADATA, "Save metadata (atomic rename)");
 		} catch (error) {
 			if (error && typeof error === "object" && "code" in error && error.code === "EPERM") {
-				await withTimeout(fsPromises.writeFile(this.filePath, json, "utf-8"), DEFAULT_TIMEOUTS.METADATA, "Save metadata (EPERM fallback direct write)");
+				await withTimeout(fs.writeFile(this.filePath, json, "utf-8"), DEFAULT_TIMEOUTS.METADATA, "Save metadata (EPERM fallback direct write)");
 				return;
 			}
 			throw error;
 		} finally {
-			await fsPromises.unlink(tmpPath).catch(() => {});
+			await fs.unlink(tmpPath).catch(() => {});
 		}
 	}
 	/**
@@ -93,19 +93,19 @@ var MetadataManager = class {
 	*/
 	async saveMetadataWithEntries(entries) {
 		const lockDir = path.dirname(this.filePath);
-		await fsPromises.mkdir(lockDir, { recursive: true });
+		await fs.mkdir(lockDir, { recursive: true });
 		try {
-			await fsPromises.access(this.filePath);
+			await fs.access(this.filePath);
 		} catch {
-			await fsPromises.writeFile(this.filePath, JSON.stringify(createEmptyMetadata(), null, 2), "utf-8");
+			await fs.writeFile(this.filePath, JSON.stringify(createEmptyMetadata(), null, 2), "utf-8");
 		}
 		const release = await lockfile.lock(this.filePath, {
 			retries: {
-				retries: 10,
+				retries: 20,
 				minTimeout: 50,
-				maxTimeout: 1e3
+				maxTimeout: 2e3
 			},
-			stale: 2e3
+			stale: 5e3
 		});
 		try {
 			const currentMetadata = await this.loadMetadata();

package/build/metadata/manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"manager.mjs","names":["path","error: any","filePath: string"],"sources":["../../src/metadata/manager.ts"],"sourcesContent":["import fsPromises from \"fs/promises\";\nimport fs from \"fs\";\nimport path from \"path\";\nimport lockfile from \"proper-lockfile\";\nimport type { MetadataSchema, PathConfig, TranslationEntry } from \"../types\";\nimport { DEFAULT_TIMEOUTS, withTimeout } from \"../utils/timeout\";\nimport { getLingoDir } from \"../utils/path-helpers\";\nimport { logger } from \"../utils/logger\";\n\nexport function createEmptyMetadata(): MetadataSchema {\n  return {\n    entries: {},\n    stats: {\n      totalEntries: 0,\n      lastUpdated: new Date().toISOString(),\n    },\n  };\n}\n\nexport function loadMetadata(path: string) {\n  return new MetadataManager(path).loadMetadata();\n}\n\nexport function cleanupExistingMetadata(metadataFilePath: string) {\n  // General cleanup. Delete metadata and stop the server if any was started.\n  logger.debug(`Attempting to cleanup metadata file: ${metadataFilePath}`);\n\n  try {\n    fs.unlinkSync(metadataFilePath);\n    logger.info(`🧹 Cleaned up build metadata file: ${metadataFilePath}`);\n  } catch (error: any) {\n    // Ignore if file doesn't exist\n    if (error.code === \"ENOENT\") {\n      logger.debug(\n        `Metadata file already deleted or doesn't exist: ${metadataFilePath}`,\n      );\n    } else {\n      logger.warn(`Failed to cleanup metadata file: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Get the absolute path to the metadata file\n *\n * @param config - Config with sourceRoot, lingoDir, and environment\n * @returns Absolute path to metadata file\n */\nexport function getMetadataPath(config: PathConfig): string {\n  const filename =\n    // Similar to next keeping dev build separate, let's keep the build metadata clean of any dev mode additions\n    config.environment === \"development\"\n      ? \"metadata-dev.json\"\n      : \"metadata-build.json\";\n  return path.join(getLingoDir(config), filename);\n}\n\nexport class MetadataManager {\n  constructor(private readonly filePath: string) {}\n\n  /**\n   * Load metadata from disk\n   * Creates empty metadata if file doesn't exist\n   * Times out after 15 seconds to prevent indefinite hangs\n   */\n  async loadMetadata(): Promise<MetadataSchema> {\n    try {\n      const content = await withTimeout(\n        fsPromises.readFile(this.filePath, \"utf-8\"),\n        DEFAULT_TIMEOUTS.METADATA,\n        \"Load metadata\",\n      );\n      return JSON.parse(content) as MetadataSchema;\n    } catch (error: any) {\n      if (error.code === \"ENOENT\") {\n        // File doesn't exist, create new metadata\n        return createEmptyMetadata();\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Save metadata to disk\n   * Times out after 15 seconds to prevent indefinite hangs\n   */\n  private async saveMetadata(metadata: MetadataSchema): Promise<void> {\n    await withTimeout(\n      fsPromises.mkdir(path.dirname(this.filePath), { recursive: true }),\n      DEFAULT_TIMEOUTS.FILE_IO,\n      \"Create metadata directory\",\n    );\n\n    metadata.stats = {\n      totalEntries: Object.keys(metadata.entries).length,\n      lastUpdated: new Date().toISOString(),\n    };\n\n    // Per LLM writing to a file is not an atomic operation while rename is, so nobody should get partial content.\n    // Sounds reasonable.\n    const dir = path.dirname(this.filePath);\n    const base = path.basename(this.filePath);\n\n    // Keep temp file in the same directory to maximize chance that rename is atomic\n    const tmpPath = path.join(dir, `.${base}.tmp-${process.pid}-${Date.now()}`);\n\n    const json = JSON.stringify(metadata, null, 2);\n\n    await withTimeout(\n      fsPromises.writeFile(tmpPath, json, \"utf-8\"),\n      DEFAULT_TIMEOUTS.METADATA,\n      \"Save metadata (tmp write)\",\n    );\n\n    try {\n      // TODO (AleksandrSl 14/12/2025): LLM says that we may want to remove older file first for windows, but it seems lo work fine as is.\n      await withTimeout(\n        fsPromises.rename(tmpPath, this.filePath),\n        DEFAULT_TIMEOUTS.METADATA,\n        \"Save metadata (atomic rename)\",\n      );\n    } catch (error) {\n      // On Windows, rename() can fail with EPERM if something briefly holds the file.\n      // As a fallback, try writing directly to the destination (not atomic).\n      if (\n        error &&\n        typeof error === \"object\" &&\n        \"code\" in error &&\n        error.code === \"EPERM\"\n      ) {\n        await withTimeout(\n          fsPromises.writeFile(this.filePath, json, \"utf-8\"),\n          DEFAULT_TIMEOUTS.METADATA,\n          \"Save metadata (EPERM fallback direct write)\",\n        );\n        return;\n      }\n      throw error;\n    } finally {\n      // Best-effort cleanup if rename failed for some reason\n      await fsPromises.unlink(tmpPath).catch(() => {});\n    }\n  }\n\n  /**\n   * Thread-safe save operation that atomically updates metadata with new entries\n   * Uses file locking to prevent concurrent write corruption\n   *\n   * @param entries - Translation entries to add/update\n   * @returns The updated metadata schema\n   */\n  async saveMetadataWithEntries(\n    entries: TranslationEntry[],\n  ): Promise<MetadataSchema> {\n    const lockDir = path.dirname(this.filePath);\n\n    await fsPromises.mkdir(lockDir, { recursive: true });\n\n    try {\n      await fsPromises.access(this.filePath);\n    } catch {\n      await fsPromises.writeFile(\n        this.filePath,\n        JSON.stringify(createEmptyMetadata(), null, 2),\n        \"utf-8\",\n      );\n    }\n\n    const release = await lockfile.lock(this.filePath, {\n      retries: {\n        retries: 10,\n        minTimeout: 50,\n        maxTimeout: 1000,\n      },\n      stale: 2000,\n    });\n\n    try {\n      // Re-load metadata inside lock to get latest state\n      const currentMetadata = await this.loadMetadata();\n      for (const entry of entries) {\n        currentMetadata.entries[entry.hash] = entry;\n      }\n      await this.saveMetadata(currentMetadata);\n      return currentMetadata;\n    } finally {\n      await release();\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AASA,SAAgB,sBAAsC;AACpD,QAAO;EACL,SAAS,EAAE;EACX,OAAO;GACL,cAAc;GACd,8BAAa,IAAI,MAAM,EAAC,aAAa;GACtC;EACF;;AAGH,SAAgB,aAAa,QAAc;AACzC,QAAO,IAAI,gBAAgBA,OAAK,CAAC,cAAc;;AAGjD,SAAgB,wBAAwB,kBAA0B;AAEhE,QAAO,MAAM,wCAAwC,mBAAmB;AAExE,KAAI;AACF,KAAG,WAAW,iBAAiB;AAC/B,SAAO,KAAK,sCAAsC,mBAAmB;UAC9DC,OAAY;AAEnB,MAAI,MAAM,SAAS,SACjB,QAAO,MACL,mDAAmD,mBACpD;MAED,QAAO,KAAK,oCAAoC,MAAM,UAAU;;;;;;;;;AAWtE,SAAgB,gBAAgB,QAA4B;CAC1D,MAAM,WAEJ,OAAO,gBAAgB,gBACnB,sBACA;AACN,QAAO,KAAK,KAAK,YAAY,OAAO,EAAE,SAAS;;AAGjD,IAAa,kBAAb,MAA6B;CAC3B,YAAY,AAAiBC,UAAkB;EAAlB;;;;;;;CAO7B,MAAM,eAAwC;AAC5C,MAAI;GACF,MAAM,UAAU,MAAM,YACpB,WAAW,SAAS,KAAK,UAAU,QAAQ,EAC3C,iBAAiB,UACjB,gBACD;AACD,UAAO,KAAK,MAAM,QAAQ;WACnBD,OAAY;AACnB,OAAI,MAAM,SAAS,SAEjB,QAAO,qBAAqB;AAE9B,SAAM;;;;;;;CAQV,MAAc,aAAa,UAAyC;AAClE,QAAM,YACJ,WAAW,MAAM,KAAK,QAAQ,KAAK,SAAS,EAAE,EAAE,WAAW,MAAM,CAAC,EAClE,iBAAiB,SACjB,4BACD;AAED,WAAS,QAAQ;GACf,cAAc,OAAO,KAAK,SAAS,QAAQ,CAAC;GAC5C,8BAAa,IAAI,MAAM,EAAC,aAAa;GACtC;EAID,MAAM,MAAM,KAAK,QAAQ,KAAK,SAAS;EACvC,MAAM,OAAO,KAAK,SAAS,KAAK,SAAS;EAGzC,MAAM,UAAU,KAAK,KAAK,KAAK,IAAI,KAAK,OAAO,QAAQ,IAAI,GAAG,KAAK,KAAK,GAAG;EAE3E,MAAM,OAAO,KAAK,UAAU,UAAU,MAAM,EAAE;AAE9C,QAAM,YACJ,WAAW,UAAU,SAAS,MAAM,QAAQ,EAC5C,iBAAiB,UACjB,4BACD;AAED,MAAI;AAEF,SAAM,YACJ,WAAW,OAAO,SAAS,KAAK,SAAS,EACzC,iBAAiB,UACjB,gCACD;WACM,OAAO;AAGd,OACE,SACA,OAAO,UAAU,YACjB,UAAU,SACV,MAAM,SAAS,SACf;AACA,UAAM,YACJ,WAAW,UAAU,KAAK,UAAU,MAAM,QAAQ,EAClD,iBAAiB,UACjB,8CACD;AACD;;AAEF,SAAM;YACE;AAER,SAAM,WAAW,OAAO,QAAQ,CAAC,YAAY,GAAG;;;;;;;;;;CAWpD,MAAM,wBACJ,SACyB;EACzB,MAAM,UAAU,KAAK,QAAQ,KAAK,SAAS;AAE3C,QAAM,WAAW,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;AAEpD,MAAI;AACF,SAAM,WAAW,OAAO,KAAK,SAAS;UAChC;AACN,SAAM,WAAW,UACf,KAAK,UACL,KAAK,UAAU,qBAAqB,EAAE,MAAM,EAAE,EAC9C,QACD;;EAGH,MAAM,UAAU,MAAM,SAAS,KAAK,KAAK,UAAU;GACjD,SAAS;IACP,SAAS;IACT,YAAY;IACZ,YAAY;IACb;GACD,OAAO;GACR,CAAC;AAEF,MAAI;GAEF,MAAM,kBAAkB,MAAM,KAAK,cAAc;AACjD,QAAK,MAAM,SAAS,QAClB,iBAAgB,QAAQ,MAAM,QAAQ;AAExC,SAAM,KAAK,aAAa,gBAAgB;AACxC,UAAO;YACC;AACR,SAAM,SAAS"}
+{"version":3,"file":"manager.mjs","names":["path","error: any","filePath: string","fsPromises"],"sources":["../../src/metadata/manager.ts"],"sourcesContent":["import fsPromises from \"fs/promises\";\nimport fs from \"fs\";\nimport path from \"path\";\nimport lockfile from \"proper-lockfile\";\nimport type { MetadataSchema, PathConfig, TranslationEntry } from \"../types\";\nimport { DEFAULT_TIMEOUTS, withTimeout } from \"../utils/timeout\";\nimport { getLingoDir } from \"../utils/path-helpers\";\nimport { logger } from \"../utils/logger\";\n\nexport function createEmptyMetadata(): MetadataSchema {\n  return {\n    entries: {},\n    stats: {\n      totalEntries: 0,\n      lastUpdated: new Date().toISOString(),\n    },\n  };\n}\n\nexport function loadMetadata(path: string) {\n  return new MetadataManager(path).loadMetadata();\n}\n\nexport function cleanupExistingMetadata(metadataFilePath: string) {\n  // General cleanup. Delete metadata and stop the server if any was started.\n  logger.debug(`Attempting to cleanup metadata file: ${metadataFilePath}`);\n\n  try {\n    fs.unlinkSync(metadataFilePath);\n    logger.info(`🧹 Cleaned up build metadata file: ${metadataFilePath}`);\n  } catch (error: any) {\n    // Ignore if file doesn't exist\n    if (error.code === \"ENOENT\") {\n      logger.debug(\n        `Metadata file already deleted or doesn't exist: ${metadataFilePath}`,\n      );\n    } else {\n      logger.warn(`Failed to cleanup metadata file: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Get the absolute path to the metadata file\n *\n * @param config - Config with sourceRoot, lingoDir, and environment\n * @returns Absolute path to metadata file\n */\nexport function getMetadataPath(config: PathConfig): string {\n  const filename =\n    // Similar to next keeping dev build separate, let's keep the build metadata clean of any dev mode additions\n    config.environment === \"development\"\n      ? \"metadata-dev.json\"\n      : \"metadata-build.json\";\n  return path.join(getLingoDir(config), filename);\n}\n\nexport class MetadataManager {\n  constructor(private readonly filePath: string) {}\n\n  /**\n   * Load metadata from disk\n   * Creates empty metadata if file doesn't exist\n   * Times out after 15 seconds to prevent indefinite hangs\n   */\n  async loadMetadata(): Promise<MetadataSchema> {\n    try {\n      const content = await withTimeout(\n        fsPromises.readFile(this.filePath, \"utf-8\"),\n        DEFAULT_TIMEOUTS.METADATA,\n        \"Load metadata\",\n      );\n      return JSON.parse(content) as MetadataSchema;\n    } catch (error: any) {\n      if (error.code === \"ENOENT\") {\n        // File doesn't exist, create new metadata\n        return createEmptyMetadata();\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Save metadata to disk\n   * Times out after 15 seconds to prevent indefinite hangs\n   */\n  private async saveMetadata(metadata: MetadataSchema): Promise<void> {\n    await withTimeout(\n      fsPromises.mkdir(path.dirname(this.filePath), { recursive: true }),\n      DEFAULT_TIMEOUTS.FILE_IO,\n      \"Create metadata directory\",\n    );\n\n    metadata.stats = {\n      totalEntries: Object.keys(metadata.entries).length,\n      lastUpdated: new Date().toISOString(),\n    };\n\n    // Per LLM writing to a file is not an atomic operation while rename is, so nobody should get partial content.\n    // Sounds reasonable.\n    const dir = path.dirname(this.filePath);\n    const base = path.basename(this.filePath);\n\n    // Keep temp file in the same directory to maximize chance that rename is atomic\n    const tmpPath = path.join(dir, `.${base}.tmp-${process.pid}-${Date.now()}`);\n\n    const json = JSON.stringify(metadata, null, 2);\n\n    await withTimeout(\n      fsPromises.writeFile(tmpPath, json, \"utf-8\"),\n      DEFAULT_TIMEOUTS.METADATA,\n      \"Save metadata (tmp write)\",\n    );\n\n    try {\n      // TODO (AleksandrSl 14/12/2025): LLM says that we may want to remove older file first for windows, but it seems lo work fine as is.\n      await withTimeout(\n        fsPromises.rename(tmpPath, this.filePath),\n        DEFAULT_TIMEOUTS.METADATA,\n        \"Save metadata (atomic rename)\",\n      );\n    } catch (error) {\n      // On Windows, rename() can fail with EPERM if something briefly holds the file.\n      // As a fallback, try writing directly to the destination (not atomic).\n      if (\n        error &&\n        typeof error === \"object\" &&\n        \"code\" in error &&\n        error.code === \"EPERM\"\n      ) {\n        await withTimeout(\n          fsPromises.writeFile(this.filePath, json, \"utf-8\"),\n          DEFAULT_TIMEOUTS.METADATA,\n          \"Save metadata (EPERM fallback direct write)\",\n        );\n        return;\n      }\n      throw error;\n    } finally {\n      // Best-effort cleanup if rename failed for some reason\n      await fsPromises.unlink(tmpPath).catch(() => {});\n    }\n  }\n\n  /**\n   * Thread-safe save operation that atomically updates metadata with new entries\n   * Uses file locking to prevent concurrent write corruption\n   *\n   * @param entries - Translation entries to add/update\n   * @returns The updated metadata schema\n   */\n  async saveMetadataWithEntries(\n    entries: TranslationEntry[],\n  ): Promise<MetadataSchema> {\n    const lockDir = path.dirname(this.filePath);\n\n    await fsPromises.mkdir(lockDir, { recursive: true });\n\n    try {\n      await fsPromises.access(this.filePath);\n    } catch {\n      await fsPromises.writeFile(\n        this.filePath,\n        JSON.stringify(createEmptyMetadata(), null, 2),\n        \"utf-8\",\n      );\n    }\n\n    const release = await lockfile.lock(this.filePath, {\n      retries: {\n        retries: 20,\n        minTimeout: 50,\n        maxTimeout: 2000,\n      },\n      stale: 5000,\n    });\n\n    try {\n      // Re-load metadata inside lock to get latest state\n      const currentMetadata = await this.loadMetadata();\n      for (const entry of entries) {\n        currentMetadata.entries[entry.hash] = entry;\n      }\n      await this.saveMetadata(currentMetadata);\n      return currentMetadata;\n    } finally {\n      await release();\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AASA,SAAgB,sBAAsC;AACpD,QAAO;EACL,SAAS,EAAE;EACX,OAAO;GACL,cAAc;GACd,8BAAa,IAAI,MAAM,EAAC,aAAa;GACtC;EACF;;AAGH,SAAgB,aAAa,QAAc;AACzC,QAAO,IAAI,gBAAgBA,OAAK,CAAC,cAAc;;AAGjD,SAAgB,wBAAwB,kBAA0B;AAEhE,QAAO,MAAM,wCAAwC,mBAAmB;AAExE,KAAI;AACF,OAAG,WAAW,iBAAiB;AAC/B,SAAO,KAAK,sCAAsC,mBAAmB;UAC9DC,OAAY;AAEnB,MAAI,MAAM,SAAS,SACjB,QAAO,MACL,mDAAmD,mBACpD;MAED,QAAO,KAAK,oCAAoC,MAAM,UAAU;;;;;;;;;AAWtE,SAAgB,gBAAgB,QAA4B;CAC1D,MAAM,WAEJ,OAAO,gBAAgB,gBACnB,sBACA;AACN,QAAO,KAAK,KAAK,YAAY,OAAO,EAAE,SAAS;;AAGjD,IAAa,kBAAb,MAA6B;CAC3B,YAAY,AAAiBC,UAAkB;EAAlB;;;;;;;CAO7B,MAAM,eAAwC;AAC5C,MAAI;GACF,MAAM,UAAU,MAAM,YACpBC,GAAW,SAAS,KAAK,UAAU,QAAQ,EAC3C,iBAAiB,UACjB,gBACD;AACD,UAAO,KAAK,MAAM,QAAQ;WACnBF,OAAY;AACnB,OAAI,MAAM,SAAS,SAEjB,QAAO,qBAAqB;AAE9B,SAAM;;;;;;;CAQV,MAAc,aAAa,UAAyC;AAClE,QAAM,YACJE,GAAW,MAAM,KAAK,QAAQ,KAAK,SAAS,EAAE,EAAE,WAAW,MAAM,CAAC,EAClE,iBAAiB,SACjB,4BACD;AAED,WAAS,QAAQ;GACf,cAAc,OAAO,KAAK,SAAS,QAAQ,CAAC;GAC5C,8BAAa,IAAI,MAAM,EAAC,aAAa;GACtC;EAID,MAAM,MAAM,KAAK,QAAQ,KAAK,SAAS;EACvC,MAAM,OAAO,KAAK,SAAS,KAAK,SAAS;EAGzC,MAAM,UAAU,KAAK,KAAK,KAAK,IAAI,KAAK,OAAO,QAAQ,IAAI,GAAG,KAAK,KAAK,GAAG;EAE3E,MAAM,OAAO,KAAK,UAAU,UAAU,MAAM,EAAE;AAE9C,QAAM,YACJA,GAAW,UAAU,SAAS,MAAM,QAAQ,EAC5C,iBAAiB,UACjB,4BACD;AAED,MAAI;AAEF,SAAM,YACJA,GAAW,OAAO,SAAS,KAAK,SAAS,EACzC,iBAAiB,UACjB,gCACD;WACM,OAAO;AAGd,OACE,SACA,OAAO,UAAU,YACjB,UAAU,SACV,MAAM,SAAS,SACf;AACA,UAAM,YACJA,GAAW,UAAU,KAAK,UAAU,MAAM,QAAQ,EAClD,iBAAiB,UACjB,8CACD;AACD;;AAEF,SAAM;YACE;AAER,SAAMA,GAAW,OAAO,QAAQ,CAAC,YAAY,GAAG;;;;;;;;;;CAWpD,MAAM,wBACJ,SACyB;EACzB,MAAM,UAAU,KAAK,QAAQ,KAAK,SAAS;AAE3C,QAAMA,GAAW,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;AAEpD,MAAI;AACF,SAAMA,GAAW,OAAO,KAAK,SAAS;UAChC;AACN,SAAMA,GAAW,UACf,KAAK,UACL,KAAK,UAAU,qBAAqB,EAAE,MAAM,EAAE,EAC9C,QACD;;EAGH,MAAM,UAAU,MAAM,SAAS,KAAK,KAAK,UAAU;GACjD,SAAS;IACP,SAAS;IACT,YAAY;IACZ,YAAY;IACb;GACD,OAAO;GACR,CAAC;AAEF,MAAI;GAEF,MAAM,kBAAkB,MAAM,KAAK,cAAc;AACjD,QAAK,MAAM,SAAS,QAClB,iBAAgB,QAAQ,MAAM,QAAQ;AAExC,SAAM,KAAK,aAAa,gBAAgB;AACxC,UAAO;YACC;AACR,SAAM,SAAS"}

package/build/plugin/build-translator.cjs

@@ -59,7 +59,7 @@ async function processBuildTranslations(options) {
 			},
 			config
 		});
-		const needsSourceLocale = config.pluralization?.enabled !== false;
+		const needsSourceLocale = config.pluralization?.enabled === true;
 		const allLocales = needsSourceLocale ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
 		require_logger.logger.info(`Processing translations for ${allLocales.length} locale(s)${needsSourceLocale ? " (including source locale for pluralization)" : ""}...`);
 		const stats = {};
@@ -110,7 +110,7 @@ async function validateCache(config, metadata, cache) {
 	const allHashes = Object.keys(metadata.entries);
 	const missingLocales = [];
 	const incompleteLocales = [];
-	const allLocales = config.pluralization?.enabled !== false ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
+	const allLocales = config.pluralization?.enabled === true ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
 	for (const locale of allLocales) try {
 		const entries = await cache.get(locale);
 		if (Object.keys(entries).length === 0) {
@@ -140,7 +140,7 @@ async function validateCache(config, metadata, cache) {
 function buildCacheStats(config, metadata) {
 	const totalEntries = Object.keys(metadata.entries).length;
 	const stats = {};
-	const allLocales = config.pluralization?.enabled !== false ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
+	const allLocales = config.pluralization?.enabled === true ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
 	for (const locale of allLocales) stats[locale] = {
 		total: totalEntries,
 		translated: totalEntries,
@@ -153,7 +153,7 @@ async function copyStaticFiles(config, publicOutputPath, metadata, cache) {
 	await fs_promises.default.mkdir(publicOutputPath, { recursive: true });
 	const usedHashes = new Set(Object.keys(metadata.entries));
 	require_logger.logger.info(`📊 Filtering translations to ${usedHashes.size} used hash(es)`);
-	const allLocales = config.pluralization?.enabled !== false ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
+	const allLocales = config.pluralization?.enabled === true ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
 	for (const locale of allLocales) {
 		const publicFilePath = path.default.join(publicOutputPath, `${locale}.json`);
 		try {

package/build/plugin/build-translator.mjs

@@ -4,7 +4,7 @@ import { createCache } from "../translators/cache-factory.mjs";
 import { TranslationService } from "../translators/translation-service.mjs";
 import { loadMetadata } from "../metadata/manager.mjs";
 import { startTranslationServer } from "../translation-server/translation-server.mjs";
-import fsPromises from "fs/promises";
+import fs from "fs/promises";
 import path from "path";
 
 //#region src/plugin/build-translator.ts
@@ -56,7 +56,7 @@ async function processBuildTranslations(options) {
 			},
 			config
 		});
-		const needsSourceLocale = config.pluralization?.enabled !== false;
+		const needsSourceLocale = config.pluralization?.enabled === true;
 		const allLocales = needsSourceLocale ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
 		logger.info(`Processing translations for ${allLocales.length} locale(s)${needsSourceLocale ? " (including source locale for pluralization)" : ""}...`);
 		const stats = {};
@@ -107,7 +107,7 @@ async function validateCache(config, metadata, cache) {
 	const allHashes = Object.keys(metadata.entries);
 	const missingLocales = [];
 	const incompleteLocales = [];
-	const allLocales = config.pluralization?.enabled !== false ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
+	const allLocales = config.pluralization?.enabled === true ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
 	for (const locale of allLocales) try {
 		const entries = await cache.get(locale);
 		if (Object.keys(entries).length === 0) {
@@ -137,7 +137,7 @@ async function validateCache(config, metadata, cache) {
 function buildCacheStats(config, metadata) {
 	const totalEntries = Object.keys(metadata.entries).length;
 	const stats = {};
-	const allLocales = config.pluralization?.enabled !== false ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
+	const allLocales = config.pluralization?.enabled === true ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
 	for (const locale of allLocales) stats[locale] = {
 		total: totalEntries,
 		translated: totalEntries,
@@ -147,16 +147,16 @@ function buildCacheStats(config, metadata) {
 }
 async function copyStaticFiles(config, publicOutputPath, metadata, cache) {
 	logger.info(`📦 Generating static translation files in ${publicOutputPath}`);
-	await fsPromises.mkdir(publicOutputPath, { recursive: true });
+	await fs.mkdir(publicOutputPath, { recursive: true });
 	const usedHashes = new Set(Object.keys(metadata.entries));
 	logger.info(`📊 Filtering translations to ${usedHashes.size} used hash(es)`);
-	const allLocales = config.pluralization?.enabled !== false ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
+	const allLocales = config.pluralization?.enabled === true ? [config.sourceLocale, ...config.targetLocales] : config.targetLocales;
 	for (const locale of allLocales) {
 		const publicFilePath = path.join(publicOutputPath, `${locale}.json`);
 		try {
 			const entries = await cache.get(locale, Array.from(usedHashes));
 			const outputData = dictionaryFrom(locale, entries);
-			await fsPromises.writeFile(publicFilePath, JSON.stringify(outputData, null, 2), "utf-8");
+			await fs.writeFile(publicFilePath, JSON.stringify(outputData, null, 2), "utf-8");
 			logger.info(`✓ Generated ${locale}.json (${Object.keys(entries).length} translations)`);
 		} catch (error) {
 			logger.error(`❌ Failed to generate ${locale}.json:`, error);

package/build/plugin/build-translator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-translator.mjs","names":["translationServer: TranslationServer | undefined","stats: BuildTranslationResult[\"stats\"]","errors: Array<{ locale: LocaleCode; error: string }>","missingLocales: string[]","incompleteLocales: Array<{\n    locale: LocaleCode;\n    missing: number;\n    total: number;\n  }>","fs"],"sources":["../../src/plugin/build-translator.ts"],"sourcesContent":["/**\n * Build-time translation processor\n *\n * Handles translation generation and validation at build time\n * Supports two modes:\n * - \"translate\": Generate all translations, fail if translation fails\n * - \"cache-only\": Validate cache completeness, fail if incomplete\n */\n// 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\nimport fs from \"fs/promises\";\nimport path from \"path\";\nimport type { LingoConfig, MetadataSchema } from \"../types\";\nimport { logger } from \"../utils/logger\";\nimport { startTranslationServer, type TranslationServer, } from \"../translation-server\";\nimport { loadMetadata } from \"../metadata/manager\";\nimport { createCache, type TranslationCache, TranslationService, } from \"../translators\";\nimport { dictionaryFrom } from \"../translators/api\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\n\nexport interface BuildTranslationOptions {\n  config: LingoConfig;\n  publicOutputPath: string;\n  metadataFilePath: string;\n}\n\nexport interface BuildTranslationResult {\n  /**\n   * Whether the build succeeded\n   */\n  success: boolean;\n\n  /**\n   * Error message if build failed\n   */\n  error?: string;\n\n  /**\n   * Translation statistics per locale\n   */\n  stats: Record<\n    string,\n    {\n      total: number;\n      translated: number;\n      failed: number;\n    }\n  >;\n}\n\n/**\n * Process translations at build time\n *\n * @throws Error if validation or translation fails (causes build to fail)\n */\nexport async function processBuildTranslations(\n  options: BuildTranslationOptions,\n): Promise<BuildTranslationResult> {\n  const { config, publicOutputPath, metadataFilePath } = options;\n\n  // Determine build mode (env var > options > config)\n  const buildMode =\n    (process.env.LINGO_BUILD_MODE as \"translate\" | \"cache-only\") ||\n    config.buildMode;\n\n  logger.info(`🌍 Build mode: ${buildMode}`);\n\n  const metadata = await loadMetadata(metadataFilePath);\n\n  if (!metadata || Object.keys(metadata.entries).length === 0) {\n    logger.info(\"No translations to process (metadata is empty)\");\n    return {\n      success: true,\n      stats: {},\n    };\n  }\n\n  const totalEntries = Object.keys(metadata.entries).length;\n  logger.info(`📊 Found ${totalEntries} translatable entries`);\n\n  const cache = createCache(config);\n\n  // Handle cache-only mode\n  if (buildMode === \"cache-only\") {\n    logger.info(\"🔍 Validating translation cache...\");\n    await validateCache(config, metadata, cache);\n    logger.info(\"✅ Cache validation passed\");\n\n    if (publicOutputPath) {\n      await copyStaticFiles(config, publicOutputPath, metadata, cache);\n    }\n\n    return {\n      success: true,\n      stats: buildCacheStats(config, metadata),\n    };\n  }\n\n  // Handle translate mode\n  logger.info(\"🔄 Generating translations...\");\n  let translationServer: TranslationServer | undefined;\n\n  try {\n    translationServer = await startTranslationServer({\n      translationService: new TranslationService(config, logger),\n      onError: (err) => {\n        logger.error(\"Translation server error:\", err);\n      },\n      config,\n    });\n\n    // When pluralization is enabled, we need to generate the source locale file too\n    // because pluralization modifies the sourceText\n    const needsSourceLocale = config.pluralization?.enabled !== false;\n    const allLocales = needsSourceLocale\n      ? [config.sourceLocale, ...config.targetLocales]\n      : config.targetLocales;\n\n    logger.info(\n      `Processing translations for ${allLocales.length} locale(s)${needsSourceLocale ? \" (including source locale for pluralization)\" : \"\"}...`,\n    );\n\n    const stats: BuildTranslationResult[\"stats\"] = {};\n    const errors: Array<{ locale: LocaleCode; error: string }> = [];\n\n    // Translate all locales in parallel\n    const localePromises = allLocales.map(async (locale) => {\n      logger.info(`Translating to ${locale}...`);\n\n      const result = await translationServer!.translateAll(locale);\n\n      stats[locale] = {\n        total: totalEntries,\n        translated: Object.keys(result.translations).length,\n        failed: result.errors.length,\n      };\n\n      if (result.errors.length > 0) {\n        logger.warn(\n          `⚠️  ${result.errors.length} translation error(s) for ${locale}`,\n        );\n        errors.push({\n          locale,\n          error: `${result.errors.length} translation(s) failed`,\n        });\n      } else {\n        logger.info(`✅ ${locale} completed successfully`);\n      }\n    });\n\n    await Promise.all(localePromises);\n\n    // Fail build if any translations failed in translate mode\n    if (errors.length > 0) {\n      const errorMsg = formatTranslationErrors(errors);\n      logger.error(errorMsg);\n      process.exit(1);\n    }\n\n    // Copy cache to public directory if requested\n    if (publicOutputPath) {\n      await copyStaticFiles(config, publicOutputPath, metadata, cache);\n    }\n\n    logger.info(\"✅ Translation generation completed successfully\");\n\n    return {\n      success: true,\n      stats,\n    };\n  } catch (error) {\n    logger.error(\n      \"❌ Translation generation failed:\\n\",\n      error instanceof Error ? error.message : error,\n    );\n    process.exit(1);\n  } finally {\n    if (translationServer) {\n      await translationServer.stop();\n      logger.info(\"✅ Translation server stopped\");\n    }\n  }\n}\n\n/**\n * Validate that all required translations exist in cache\n * @throws Error if cache is incomplete or missing\n */\nasync function validateCache(\n  config: LingoConfig,\n  metadata: MetadataSchema,\n  cache: TranslationCache,\n): Promise<void> {\n  const allHashes = Object.keys(metadata.entries);\n  const missingLocales: string[] = [];\n  const incompleteLocales: Array<{\n    locale: LocaleCode;\n    missing: number;\n    total: number;\n  }> = [];\n\n  // Include source locale if pluralization is enabled\n  const needsSourceLocale = config.pluralization?.enabled !== false;\n  const allLocales = needsSourceLocale\n    ? [config.sourceLocale, ...config.targetLocales]\n    : config.targetLocales;\n\n  for (const locale of allLocales) {\n    try {\n      const entries = await cache.get(locale);\n\n      if (Object.keys(entries).length === 0) {\n        missingLocales.push(locale);\n        logger.debug(`Cache file not found or empty for ${locale}`);\n        continue;\n      }\n\n      const missingHashes = allHashes.filter((hash) => !entries[hash]);\n\n      if (missingHashes.length > 0) {\n        incompleteLocales.push({\n          locale,\n          missing: missingHashes.length,\n          total: allHashes.length,\n        });\n\n        // Log first few missing hashes for debugging\n        logger.debug(\n          `Missing hashes in ${locale}: ${missingHashes.slice(0, 5).join(\", \")}${\n            missingHashes.length > 5 ? \"...\" : \"\"\n          }`,\n        );\n      }\n    } catch (error) {\n      missingLocales.push(locale);\n      logger.debug(`Failed to read cache for ${locale}:`, error);\n    }\n  }\n\n  if (missingLocales.length > 0 || incompleteLocales.length > 0) {\n    const errorMsg = formatCacheValidationError(\n      missingLocales,\n      incompleteLocales,\n    );\n    logger.error(errorMsg);\n    process.exit(1);\n  }\n}\n\nfunction buildCacheStats(\n  config: LingoConfig,\n  metadata: MetadataSchema,\n): BuildTranslationResult[\"stats\"] {\n  const totalEntries = Object.keys(metadata.entries).length;\n  const stats: BuildTranslationResult[\"stats\"] = {};\n\n  // Include source locale if pluralization is enabled\n  const needsSourceLocale = config.pluralization?.enabled !== false;\n  const allLocales = needsSourceLocale\n    ? [config.sourceLocale, ...config.targetLocales]\n    : config.targetLocales;\n\n  for (const locale of allLocales) {\n    stats[locale] = {\n      total: totalEntries,\n      translated: totalEntries, // Assumed complete if validation passed\n      failed: 0,\n    };\n  }\n\n  return stats;\n}\n\nasync function copyStaticFiles(\n  config: LingoConfig,\n  publicOutputPath: string,\n  metadata: MetadataSchema,\n  cache: TranslationCache,\n): Promise<void> {\n  logger.info(`📦 Generating static translation files in ${publicOutputPath}`);\n\n  await fs.mkdir(publicOutputPath, { recursive: true });\n\n  const usedHashes = new Set(Object.keys(metadata.entries));\n  logger.info(`📊 Filtering translations to ${usedHashes.size} used hash(es)`);\n\n  // Include source locale if pluralization is enabled\n  const needsSourceLocale = config.pluralization?.enabled !== false;\n  const allLocales = needsSourceLocale\n    ? [config.sourceLocale, ...config.targetLocales]\n    : config.targetLocales;\n\n  for (const locale of allLocales) {\n    const publicFilePath = path.join(publicOutputPath, `${locale}.json`);\n\n    try {\n      const entries = await cache.get(locale, Array.from(usedHashes));\n      const outputData = dictionaryFrom(locale, entries);\n\n      await fs.writeFile(\n        publicFilePath,\n        JSON.stringify(outputData, null, 2),\n        \"utf-8\",\n      );\n\n      logger.info(\n        `✓ Generated ${locale}.json (${Object.keys(entries).length} translations)`,\n      );\n    } catch (error) {\n      logger.error(`❌ Failed to generate ${locale}.json:`, error);\n      process.exit(1);\n    }\n  }\n}\n\nfunction formatCacheValidationError(\n  missingLocales: string[],\n  incompleteLocales: Array<{\n    locale: LocaleCode;\n    missing: number;\n    total: number;\n  }>,\n): string {\n  let msg = \"❌ Cache validation failed in cache-only mode:\\n\\n\";\n\n  if (missingLocales.length > 0) {\n    msg += `  📁 Missing cache files:\\n`;\n    msg += missingLocales.map((locale) => `    - ${locale}.json`).join(\"\\n\");\n    msg += \"\\n\\n\";\n  }\n\n  if (incompleteLocales.length > 0) {\n    msg += `  📊 Incomplete cache:\\n`;\n    msg += incompleteLocales\n      .map(\n        (item) =>\n          `    - ${item.locale}: ${item.missing}/${item.total} translations missing`,\n      )\n      .join(\"\\n\");\n    msg += \"\\n\\n\";\n  }\n\n  msg += `  💡 To fix:\\n`;\n  msg += `    1. Set LINGO_BUILD_MODE=translate to generate translations\\n`;\n  msg += `    2. Commit the generated .lingo/cache/*.json files\\n`;\n  msg += `    3. Ensure translation API keys are available if generating translations`;\n\n  return msg;\n}\n\nfunction formatTranslationErrors(\n  errors: Array<{ locale: LocaleCode; error: string }>,\n): string {\n  let msg = \"❌ Translation generation failed:\\n\\n\";\n\n  msg += errors.map((err) => `  - ${err.locale}: ${err.error}`).join(\"\\n\");\n\n  msg += \"\\n\\n\";\n  msg += `  💡 Translation errors must be resolved in \"translate\" mode.\\n`;\n  msg += `     Check translation server logs for details.`;\n\n  return msg;\n}\n"],"mappings":"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"}
+{"version":3,"file":"build-translator.mjs","names":["translationServer: TranslationServer | undefined","stats: BuildTranslationResult[\"stats\"]","errors: Array<{ locale: LocaleCode; error: string }>","missingLocales: string[]","incompleteLocales: Array<{\n    locale: LocaleCode;\n    missing: number;\n    total: number;\n  }>"],"sources":["../../src/plugin/build-translator.ts"],"sourcesContent":["/**\n * Build-time translation processor\n *\n * Handles translation generation and validation at build time\n * Supports two modes:\n * - \"translate\": Generate all translations, fail if translation fails\n * - \"cache-only\": Validate cache completeness, fail if incomplete\n */\n// 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\nimport fs from \"fs/promises\";\nimport path from \"path\";\nimport type { LingoConfig, MetadataSchema } from \"../types\";\nimport { logger } from \"../utils/logger\";\nimport { startTranslationServer, type TranslationServer, } from \"../translation-server\";\nimport { loadMetadata } from \"../metadata/manager\";\nimport { createCache, type TranslationCache, TranslationService, } from \"../translators\";\nimport { dictionaryFrom } from \"../translators/api\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\n\nexport interface BuildTranslationOptions {\n  config: LingoConfig;\n  publicOutputPath: string;\n  metadataFilePath: string;\n}\n\nexport interface BuildTranslationResult {\n  /**\n   * Whether the build succeeded\n   */\n  success: boolean;\n\n  /**\n   * Error message if build failed\n   */\n  error?: string;\n\n  /**\n   * Translation statistics per locale\n   */\n  stats: Record<\n    string,\n    {\n      total: number;\n      translated: number;\n      failed: number;\n    }\n  >;\n}\n\n/**\n * Process translations at build time\n *\n * @throws Error if validation or translation fails (causes build to fail)\n */\nexport async function processBuildTranslations(\n  options: BuildTranslationOptions,\n): Promise<BuildTranslationResult> {\n  const { config, publicOutputPath, metadataFilePath } = options;\n\n  // Determine build mode (env var > options > config)\n  const buildMode =\n    (process.env.LINGO_BUILD_MODE as \"translate\" | \"cache-only\") ||\n    config.buildMode;\n\n  logger.info(`🌍 Build mode: ${buildMode}`);\n\n  const metadata = await loadMetadata(metadataFilePath);\n\n  if (!metadata || Object.keys(metadata.entries).length === 0) {\n    logger.info(\"No translations to process (metadata is empty)\");\n    return {\n      success: true,\n      stats: {},\n    };\n  }\n\n  const totalEntries = Object.keys(metadata.entries).length;\n  logger.info(`📊 Found ${totalEntries} translatable entries`);\n\n  const cache = createCache(config);\n\n  // Handle cache-only mode\n  if (buildMode === \"cache-only\") {\n    logger.info(\"🔍 Validating translation cache...\");\n    await validateCache(config, metadata, cache);\n    logger.info(\"✅ Cache validation passed\");\n\n    if (publicOutputPath) {\n      await copyStaticFiles(config, publicOutputPath, metadata, cache);\n    }\n\n    return {\n      success: true,\n      stats: buildCacheStats(config, metadata),\n    };\n  }\n\n  // Handle translate mode\n  logger.info(\"🔄 Generating translations...\");\n  let translationServer: TranslationServer | undefined;\n\n  try {\n    translationServer = await startTranslationServer({\n      translationService: new TranslationService(config, logger),\n      onError: (err) => {\n        logger.error(\"Translation server error:\", err);\n      },\n      config,\n    });\n\n    // When pluralization is enabled, we need to generate the source locale file too\n    // because pluralization modifies the sourceText\n    const needsSourceLocale = config.pluralization?.enabled === true;\n    const allLocales = needsSourceLocale\n      ? [config.sourceLocale, ...config.targetLocales]\n      : config.targetLocales;\n\n    logger.info(\n      `Processing translations for ${allLocales.length} locale(s)${needsSourceLocale ? \" (including source locale for pluralization)\" : \"\"}...`,\n    );\n\n    const stats: BuildTranslationResult[\"stats\"] = {};\n    const errors: Array<{ locale: LocaleCode; error: string }> = [];\n\n    // Translate all locales in parallel\n    const localePromises = allLocales.map(async (locale) => {\n      logger.info(`Translating to ${locale}...`);\n\n      const result = await translationServer!.translateAll(locale);\n\n      stats[locale] = {\n        total: totalEntries,\n        translated: Object.keys(result.translations).length,\n        failed: result.errors.length,\n      };\n\n      if (result.errors.length > 0) {\n        logger.warn(\n          `⚠️  ${result.errors.length} translation error(s) for ${locale}`,\n        );\n        errors.push({\n          locale,\n          error: `${result.errors.length} translation(s) failed`,\n        });\n      } else {\n        logger.info(`✅ ${locale} completed successfully`);\n      }\n    });\n\n    await Promise.all(localePromises);\n\n    // Fail build if any translations failed in translate mode\n    if (errors.length > 0) {\n      const errorMsg = formatTranslationErrors(errors);\n      logger.error(errorMsg);\n      process.exit(1);\n    }\n\n    // Copy cache to public directory if requested\n    if (publicOutputPath) {\n      await copyStaticFiles(config, publicOutputPath, metadata, cache);\n    }\n\n    logger.info(\"✅ Translation generation completed successfully\");\n\n    return {\n      success: true,\n      stats,\n    };\n  } catch (error) {\n    logger.error(\n      \"❌ Translation generation failed:\\n\",\n      error instanceof Error ? error.message : error,\n    );\n    process.exit(1);\n  } finally {\n    if (translationServer) {\n      await translationServer.stop();\n      logger.info(\"✅ Translation server stopped\");\n    }\n  }\n}\n\n/**\n * Validate that all required translations exist in cache\n * @throws Error if cache is incomplete or missing\n */\nasync function validateCache(\n  config: LingoConfig,\n  metadata: MetadataSchema,\n  cache: TranslationCache,\n): Promise<void> {\n  const allHashes = Object.keys(metadata.entries);\n  const missingLocales: string[] = [];\n  const incompleteLocales: Array<{\n    locale: LocaleCode;\n    missing: number;\n    total: number;\n  }> = [];\n\n  // Include source locale if pluralization is enabled\n  const needsSourceLocale = config.pluralization?.enabled === true;\n  const allLocales = needsSourceLocale\n    ? [config.sourceLocale, ...config.targetLocales]\n    : config.targetLocales;\n\n  for (const locale of allLocales) {\n    try {\n      const entries = await cache.get(locale);\n\n      if (Object.keys(entries).length === 0) {\n        missingLocales.push(locale);\n        logger.debug(`Cache file not found or empty for ${locale}`);\n        continue;\n      }\n\n      const missingHashes = allHashes.filter((hash) => !entries[hash]);\n\n      if (missingHashes.length > 0) {\n        incompleteLocales.push({\n          locale,\n          missing: missingHashes.length,\n          total: allHashes.length,\n        });\n\n        // Log first few missing hashes for debugging\n        logger.debug(\n          `Missing hashes in ${locale}: ${missingHashes.slice(0, 5).join(\", \")}${\n            missingHashes.length > 5 ? \"...\" : \"\"\n          }`,\n        );\n      }\n    } catch (error) {\n      missingLocales.push(locale);\n      logger.debug(`Failed to read cache for ${locale}:`, error);\n    }\n  }\n\n  if (missingLocales.length > 0 || incompleteLocales.length > 0) {\n    const errorMsg = formatCacheValidationError(\n      missingLocales,\n      incompleteLocales,\n    );\n    logger.error(errorMsg);\n    process.exit(1);\n  }\n}\n\nfunction buildCacheStats(\n  config: LingoConfig,\n  metadata: MetadataSchema,\n): BuildTranslationResult[\"stats\"] {\n  const totalEntries = Object.keys(metadata.entries).length;\n  const stats: BuildTranslationResult[\"stats\"] = {};\n\n  // Include source locale if pluralization is enabled\n  const needsSourceLocale = config.pluralization?.enabled === true;\n  const allLocales = needsSourceLocale\n    ? [config.sourceLocale, ...config.targetLocales]\n    : config.targetLocales;\n\n  for (const locale of allLocales) {\n    stats[locale] = {\n      total: totalEntries,\n      translated: totalEntries, // Assumed complete if validation passed\n      failed: 0,\n    };\n  }\n\n  return stats;\n}\n\nasync function copyStaticFiles(\n  config: LingoConfig,\n  publicOutputPath: string,\n  metadata: MetadataSchema,\n  cache: TranslationCache,\n): Promise<void> {\n  logger.info(`📦 Generating static translation files in ${publicOutputPath}`);\n\n  await fs.mkdir(publicOutputPath, { recursive: true });\n\n  const usedHashes = new Set(Object.keys(metadata.entries));\n  logger.info(`📊 Filtering translations to ${usedHashes.size} used hash(es)`);\n\n  // Include source locale if pluralization is enabled\n  const needsSourceLocale = config.pluralization?.enabled === true;\n  const allLocales = needsSourceLocale\n    ? [config.sourceLocale, ...config.targetLocales]\n    : config.targetLocales;\n\n  for (const locale of allLocales) {\n    const publicFilePath = path.join(publicOutputPath, `${locale}.json`);\n\n    try {\n      const entries = await cache.get(locale, Array.from(usedHashes));\n      const outputData = dictionaryFrom(locale, entries);\n\n      await fs.writeFile(\n        publicFilePath,\n        JSON.stringify(outputData, null, 2),\n        \"utf-8\",\n      );\n\n      logger.info(\n        `✓ Generated ${locale}.json (${Object.keys(entries).length} translations)`,\n      );\n    } catch (error) {\n      logger.error(`❌ Failed to generate ${locale}.json:`, error);\n      process.exit(1);\n    }\n  }\n}\n\nfunction formatCacheValidationError(\n  missingLocales: string[],\n  incompleteLocales: Array<{\n    locale: LocaleCode;\n    missing: number;\n    total: number;\n  }>,\n): string {\n  let msg = \"❌ Cache validation failed in cache-only mode:\\n\\n\";\n\n  if (missingLocales.length > 0) {\n    msg += `  📁 Missing cache files:\\n`;\n    msg += missingLocales.map((locale) => `    - ${locale}.json`).join(\"\\n\");\n    msg += \"\\n\\n\";\n  }\n\n  if (incompleteLocales.length > 0) {\n    msg += `  📊 Incomplete cache:\\n`;\n    msg += incompleteLocales\n      .map(\n        (item) =>\n          `    - ${item.locale}: ${item.missing}/${item.total} translations missing`,\n      )\n      .join(\"\\n\");\n    msg += \"\\n\\n\";\n  }\n\n  msg += `  💡 To fix:\\n`;\n  msg += `    1. Set LINGO_BUILD_MODE=translate to generate translations\\n`;\n  msg += `    2. Commit the generated .lingo/cache/*.json files\\n`;\n  msg += `    3. Ensure translation API keys are available if generating translations`;\n\n  return msg;\n}\n\nfunction formatTranslationErrors(\n  errors: Array<{ locale: LocaleCode; error: string }>,\n): string {\n  let msg = \"❌ Translation generation failed:\\n\\n\";\n\n  msg += errors.map((err) => `  - ${err.locale}: ${err.error}`).join(\"\\n\");\n\n  msg += \"\\n\\n\";\n  msg += `  💡 Translation errors must be resolved in \"translate\" mode.\\n`;\n  msg += `     Check translation server logs for details.`;\n\n  return msg;\n}\n"],"mappings":"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"}

package/build/react/server/ServerLingoProvider.d.cts

@@ -1,12 +1,12 @@
 import { LingoProviderProps } from "../shared/LingoProvider.cjs";
-import * as react_jsx_runtime2 from "react/jsx-runtime";
+import * as react_jsx_runtime3 from "react/jsx-runtime";
 
 //#region src/react/server/ServerLingoProvider.d.ts
 declare function LingoProvider({
   initialLocale,
   initialTranslations,
   ...rest
-}: LingoProviderProps): Promise<react_jsx_runtime2.JSX.Element>;
+}: LingoProviderProps): Promise<react_jsx_runtime3.JSX.Element>;
 //#endregion
 export { LingoProvider };
 //# sourceMappingURL=ServerLingoProvider.d.cts.map

package/build/react/shared/LingoProvider.d.cts

@@ -1,5 +1,5 @@
 import { LocaleCode } from "lingo.dev/spec";
-import * as react_jsx_runtime1 from "react/jsx-runtime";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
 import { PropsWithChildren } from "react";
 
 //#region src/react/shared/LingoProvider.d.ts
@@ -70,7 +70,7 @@ declare function LingoProvider__Dev({
   router,
   devWidget,
   children
-}: LingoProviderProps): react_jsx_runtime1.JSX.Element;
+}: LingoProviderProps): react_jsx_runtime2.JSX.Element;
 //#endregion
 export { LingoProvider, LingoProviderProps };
 //# sourceMappingURL=LingoProvider.d.cts.map

package/build/react/shared/LocaleSwitcher.d.cts

@@ -1,5 +1,5 @@
 import { LocaleCode } from "lingo.dev/spec";
-import * as react_jsx_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime1 from "react/jsx-runtime";
 import { CSSProperties } from "react";
 
 //#region src/react/shared/LocaleSwitcher.d.ts
@@ -65,7 +65,7 @@ declare function LocaleSwitcher({
   style,
   className,
   showLoadingState
-}: LocaleSwitcherProps): react_jsx_runtime3.JSX.Element;
+}: LocaleSwitcherProps): react_jsx_runtime1.JSX.Element;
 //#endregion
 export { LocaleSwitcher };
 //# sourceMappingURL=LocaleSwitcher.d.cts.map

package/build/translators/local-cache.mjs

@@ -1,6 +1,6 @@
 import { dictionaryFrom } from "./api.mjs";
 import { DEFAULT_TIMEOUTS, withTimeout } from "../utils/timeout.mjs";
-import * as fs from "fs/promises";
+import * as fs$1 from "fs/promises";
 import * as path$1 from "path";
 
 //#region src/translators/local-cache.ts
@@ -27,7 +27,7 @@ var LocalTranslationCache = class {
 	async getDictionary(locale) {
 		try {
 			const cachePath = this.getCachePath(locale);
-			const content = await withTimeout(fs.readFile(cachePath, "utf-8"), DEFAULT_TIMEOUTS.FILE_IO, `Read cache for ${locale}`);
+			const content = await withTimeout(fs$1.readFile(cachePath, "utf-8"), DEFAULT_TIMEOUTS.FILE_IO, `Read cache for ${locale}`);
 			return JSON.parse(content);
 		} catch {
 			return null;
@@ -41,8 +41,8 @@ var LocalTranslationCache = class {
 		try {
 			const cachePath = this.getCachePath(locale);
 			const cacheDir = path$1.dirname(cachePath);
-			await withTimeout(fs.mkdir(cacheDir, { recursive: true }), DEFAULT_TIMEOUTS.FILE_IO, `Create cache directory for ${locale}`);
-			await withTimeout(fs.writeFile(cachePath, JSON.stringify(dictionary, null, 2), "utf-8"), DEFAULT_TIMEOUTS.FILE_IO, `Write cache for ${locale}`);
+			await withTimeout(fs$1.mkdir(cacheDir, { recursive: true }), DEFAULT_TIMEOUTS.FILE_IO, `Create cache directory for ${locale}`);
+			await withTimeout(fs$1.writeFile(cachePath, JSON.stringify(dictionary, null, 2), "utf-8"), DEFAULT_TIMEOUTS.FILE_IO, `Write cache for ${locale}`);
 		} catch (error) {
 			this.logger.error(`Failed to write cache for locale ${locale}:`, error);
 			throw error;
@@ -82,7 +82,7 @@ var LocalTranslationCache = class {
 	async has(locale) {
 		try {
 			const cachePath = this.getCachePath(locale);
-			await fs.access(cachePath);
+			await fs$1.access(cachePath);
 			return true;
 		} catch {
 			return false;
@@ -94,7 +94,7 @@ var LocalTranslationCache = class {
 	async clear(locale) {
 		try {
 			const cachePath = this.getCachePath(locale);
-			await fs.unlink(cachePath);
+			await fs$1.unlink(cachePath);
 		} catch {}
 	}
 	/**
@@ -102,8 +102,8 @@ var LocalTranslationCache = class {
 	*/
 	async clearAll() {
 		try {
-			const files = await fs.readdir(this.config.cacheDir);
-			await Promise.all(files.filter((file) => file.endsWith(".json")).map((file) => fs.unlink(path$1.join(this.config.cacheDir, file))));
+			const files = await fs$1.readdir(this.config.cacheDir);
+			await Promise.all(files.filter((file) => file.endsWith(".json")).map((file) => fs$1.unlink(path$1.join(this.config.cacheDir, file))));
 		} catch {}
 	}
 };

package/build/translators/local-cache.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"local-cache.mjs","names":["logger: Logger","path"],"sources":["../../src/translators/local-cache.ts"],"sourcesContent":["/**\n * Local disk-based translation cache implementation\n */\n\nimport * as fs from \"fs/promises\";\nimport * as path from \"path\";\nimport type { LocalCacheConfig, TranslationCache } from \"./cache\";\nimport { dictionaryFrom, type DictionarySchema } from \"./api\";\nimport { DEFAULT_TIMEOUTS, withTimeout } from \"../utils/timeout\";\nimport type { Logger } from \"../utils/logger\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\n\n/**\n * Local file system cache for translations\n * Stores translations as JSON files in .lingo/cache/\n */\nexport class LocalTranslationCache implements TranslationCache {\n  private config: LocalCacheConfig;\n\n  constructor(\n    config: LocalCacheConfig,\n    private logger: Logger,\n  ) {\n    this.config = config;\n  }\n\n  private getCachePath(locale: LocaleCode): string {\n    return path.join(this.config.cacheDir, `${locale}.json`);\n  }\n\n  /**\n   * Read dictionary file from disk\n   * Times out after 10 seconds to prevent indefinite hangs\n   */\n  async getDictionary(locale: LocaleCode): Promise<DictionarySchema | null> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      const content = await withTimeout(\n        fs.readFile(cachePath, \"utf-8\"),\n        DEFAULT_TIMEOUTS.FILE_IO,\n        `Read cache for ${locale}`,\n      );\n      return JSON.parse(content);\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Write dictionary file to disk\n   * Times out after 10 seconds to prevent indefinite hangs\n   */\n  private async setDictionary(\n    locale: LocaleCode,\n    dictionary: DictionarySchema,\n  ): Promise<void> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      const cacheDir = path.dirname(cachePath);\n\n      // Ensure cache directory exists\n      await withTimeout(\n        fs.mkdir(cacheDir, { recursive: true }),\n        DEFAULT_TIMEOUTS.FILE_IO,\n        `Create cache directory for ${locale}`,\n      );\n\n      // Write cache file\n      await withTimeout(\n        fs.writeFile(cachePath, JSON.stringify(dictionary, null, 2), \"utf-8\"),\n        DEFAULT_TIMEOUTS.FILE_IO,\n        `Write cache for ${locale}`,\n      );\n    } catch (error) {\n      this.logger.error(`Failed to write cache for locale ${locale}:`, error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get cached translations for a locale\n   */\n  async get(\n    locale: LocaleCode,\n    hashes?: string[],\n  ): Promise<Record<string, string>> {\n    const dictionary = await this.getDictionary(locale);\n    if (!dictionary) {\n      return {};\n    }\n    if (hashes) {\n      return hashes.reduce(\n        (acc, hash) => ({ ...acc, [hash]: dictionary.entries[hash] }),\n        {},\n      );\n    }\n    return dictionary.entries || {};\n  }\n\n  /**\n   * Update cache with new translations (merge)\n   */\n  async update(\n    locale: LocaleCode,\n    translations: Record<string, string>,\n  ): Promise<void> {\n    const existing = await this.get(locale);\n\n    const merged = { ...existing, ...translations };\n\n    await this.set(locale, merged);\n  }\n\n  /**\n   * Replace entire cache for a locale\n   */\n  async set(\n    locale: LocaleCode,\n    translations: Record<string, string>,\n  ): Promise<void> {\n    await this.setDictionary(locale, dictionaryFrom(locale, translations));\n  }\n\n  /**\n   * Check if cache exists for a locale\n   */\n  async has(locale: LocaleCode): Promise<boolean> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      await fs.access(cachePath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Clear cache for a specific locale\n   */\n  async clear(locale: LocaleCode): Promise<void> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      await fs.unlink(cachePath);\n    } catch {\n      // Ignore errors if file doesn't exist\n    }\n  }\n\n  /**\n   * Clear all cached translations\n   */\n  async clearAll(): Promise<void> {\n    try {\n      const files = await fs.readdir(this.config.cacheDir);\n\n      await Promise.all(\n        files\n          .filter((file) => file.endsWith(\".json\"))\n          .map((file) => fs.unlink(path.join(this.config.cacheDir, file))),\n      );\n    } catch {\n      // Ignore errors if directory doesn't exist\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,IAAa,wBAAb,MAA+D;CAC7D,AAAQ;CAER,YACE,QACA,AAAQA,QACR;EADQ;AAER,OAAK,SAAS;;CAGhB,AAAQ,aAAa,QAA4B;AAC/C,SAAOC,OAAK,KAAK,KAAK,OAAO,UAAU,GAAG,OAAO,OAAO;;;;;;CAO1D,MAAM,cAAc,QAAsD;AACxE,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;GAC3C,MAAM,UAAU,MAAM,YACpB,GAAG,SAAS,WAAW,QAAQ,EAC/B,iBAAiB,SACjB,kBAAkB,SACnB;AACD,UAAO,KAAK,MAAM,QAAQ;UACpB;AACN,UAAO;;;;;;;CAQX,MAAc,cACZ,QACA,YACe;AACf,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;GAC3C,MAAM,WAAWA,OAAK,QAAQ,UAAU;AAGxC,SAAM,YACJ,GAAG,MAAM,UAAU,EAAE,WAAW,MAAM,CAAC,EACvC,iBAAiB,SACjB,8BAA8B,SAC/B;AAGD,SAAM,YACJ,GAAG,UAAU,WAAW,KAAK,UAAU,YAAY,MAAM,EAAE,EAAE,QAAQ,EACrE,iBAAiB,SACjB,mBAAmB,SACpB;WACM,OAAO;AACd,QAAK,OAAO,MAAM,oCAAoC,OAAO,IAAI,MAAM;AACvE,SAAM;;;;;;CAOV,MAAM,IACJ,QACA,QACiC;EACjC,MAAM,aAAa,MAAM,KAAK,cAAc,OAAO;AACnD,MAAI,CAAC,WACH,QAAO,EAAE;AAEX,MAAI,OACF,QAAO,OAAO,QACX,KAAK,UAAU;GAAE,GAAG;IAAM,OAAO,WAAW,QAAQ;GAAO,GAC5D,EAAE,CACH;AAEH,SAAO,WAAW,WAAW,EAAE;;;;;CAMjC,MAAM,OACJ,QACA,cACe;EAGf,MAAM,SAAS;GAAE,GAFA,MAAM,KAAK,IAAI,OAAO;GAET,GAAG;GAAc;AAE/C,QAAM,KAAK,IAAI,QAAQ,OAAO;;;;;CAMhC,MAAM,IACJ,QACA,cACe;AACf,QAAM,KAAK,cAAc,QAAQ,eAAe,QAAQ,aAAa,CAAC;;;;;CAMxE,MAAM,IAAI,QAAsC;AAC9C,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,SAAM,GAAG,OAAO,UAAU;AAC1B,UAAO;UACD;AACN,UAAO;;;;;;CAOX,MAAM,MAAM,QAAmC;AAC7C,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,SAAM,GAAG,OAAO,UAAU;UACpB;;;;;CAQV,MAAM,WAA0B;AAC9B,MAAI;GACF,MAAM,QAAQ,MAAM,GAAG,QAAQ,KAAK,OAAO,SAAS;AAEpD,SAAM,QAAQ,IACZ,MACG,QAAQ,SAAS,KAAK,SAAS,QAAQ,CAAC,CACxC,KAAK,SAAS,GAAG,OAAOA,OAAK,KAAK,KAAK,OAAO,UAAU,KAAK,CAAC,CAAC,CACnE;UACK"}
+{"version":3,"file":"local-cache.mjs","names":["logger: Logger","path","fs"],"sources":["../../src/translators/local-cache.ts"],"sourcesContent":["/**\n * Local disk-based translation cache implementation\n */\n\nimport * as fs from \"fs/promises\";\nimport * as path from \"path\";\nimport type { LocalCacheConfig, TranslationCache } from \"./cache\";\nimport { dictionaryFrom, type DictionarySchema } from \"./api\";\nimport { DEFAULT_TIMEOUTS, withTimeout } from \"../utils/timeout\";\nimport type { Logger } from \"../utils/logger\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\n\n/**\n * Local file system cache for translations\n * Stores translations as JSON files in .lingo/cache/\n */\nexport class LocalTranslationCache implements TranslationCache {\n  private config: LocalCacheConfig;\n\n  constructor(\n    config: LocalCacheConfig,\n    private logger: Logger,\n  ) {\n    this.config = config;\n  }\n\n  private getCachePath(locale: LocaleCode): string {\n    return path.join(this.config.cacheDir, `${locale}.json`);\n  }\n\n  /**\n   * Read dictionary file from disk\n   * Times out after 10 seconds to prevent indefinite hangs\n   */\n  async getDictionary(locale: LocaleCode): Promise<DictionarySchema | null> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      const content = await withTimeout(\n        fs.readFile(cachePath, \"utf-8\"),\n        DEFAULT_TIMEOUTS.FILE_IO,\n        `Read cache for ${locale}`,\n      );\n      return JSON.parse(content);\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Write dictionary file to disk\n   * Times out after 10 seconds to prevent indefinite hangs\n   */\n  private async setDictionary(\n    locale: LocaleCode,\n    dictionary: DictionarySchema,\n  ): Promise<void> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      const cacheDir = path.dirname(cachePath);\n\n      // Ensure cache directory exists\n      await withTimeout(\n        fs.mkdir(cacheDir, { recursive: true }),\n        DEFAULT_TIMEOUTS.FILE_IO,\n        `Create cache directory for ${locale}`,\n      );\n\n      // Write cache file\n      await withTimeout(\n        fs.writeFile(cachePath, JSON.stringify(dictionary, null, 2), \"utf-8\"),\n        DEFAULT_TIMEOUTS.FILE_IO,\n        `Write cache for ${locale}`,\n      );\n    } catch (error) {\n      this.logger.error(`Failed to write cache for locale ${locale}:`, error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get cached translations for a locale\n   */\n  async get(\n    locale: LocaleCode,\n    hashes?: string[],\n  ): Promise<Record<string, string>> {\n    const dictionary = await this.getDictionary(locale);\n    if (!dictionary) {\n      return {};\n    }\n    if (hashes) {\n      return hashes.reduce(\n        (acc, hash) => ({ ...acc, [hash]: dictionary.entries[hash] }),\n        {},\n      );\n    }\n    return dictionary.entries || {};\n  }\n\n  /**\n   * Update cache with new translations (merge)\n   */\n  async update(\n    locale: LocaleCode,\n    translations: Record<string, string>,\n  ): Promise<void> {\n    const existing = await this.get(locale);\n\n    const merged = { ...existing, ...translations };\n\n    await this.set(locale, merged);\n  }\n\n  /**\n   * Replace entire cache for a locale\n   */\n  async set(\n    locale: LocaleCode,\n    translations: Record<string, string>,\n  ): Promise<void> {\n    await this.setDictionary(locale, dictionaryFrom(locale, translations));\n  }\n\n  /**\n   * Check if cache exists for a locale\n   */\n  async has(locale: LocaleCode): Promise<boolean> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      await fs.access(cachePath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Clear cache for a specific locale\n   */\n  async clear(locale: LocaleCode): Promise<void> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      await fs.unlink(cachePath);\n    } catch {\n      // Ignore errors if file doesn't exist\n    }\n  }\n\n  /**\n   * Clear all cached translations\n   */\n  async clearAll(): Promise<void> {\n    try {\n      const files = await fs.readdir(this.config.cacheDir);\n\n      await Promise.all(\n        files\n          .filter((file) => file.endsWith(\".json\"))\n          .map((file) => fs.unlink(path.join(this.config.cacheDir, file))),\n      );\n    } catch {\n      // Ignore errors if directory doesn't exist\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,IAAa,wBAAb,MAA+D;CAC7D,AAAQ;CAER,YACE,QACA,AAAQA,QACR;EADQ;AAER,OAAK,SAAS;;CAGhB,AAAQ,aAAa,QAA4B;AAC/C,SAAOC,OAAK,KAAK,KAAK,OAAO,UAAU,GAAG,OAAO,OAAO;;;;;;CAO1D,MAAM,cAAc,QAAsD;AACxE,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;GAC3C,MAAM,UAAU,MAAM,YACpBC,KAAG,SAAS,WAAW,QAAQ,EAC/B,iBAAiB,SACjB,kBAAkB,SACnB;AACD,UAAO,KAAK,MAAM,QAAQ;UACpB;AACN,UAAO;;;;;;;CAQX,MAAc,cACZ,QACA,YACe;AACf,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;GAC3C,MAAM,WAAWD,OAAK,QAAQ,UAAU;AAGxC,SAAM,YACJC,KAAG,MAAM,UAAU,EAAE,WAAW,MAAM,CAAC,EACvC,iBAAiB,SACjB,8BAA8B,SAC/B;AAGD,SAAM,YACJA,KAAG,UAAU,WAAW,KAAK,UAAU,YAAY,MAAM,EAAE,EAAE,QAAQ,EACrE,iBAAiB,SACjB,mBAAmB,SACpB;WACM,OAAO;AACd,QAAK,OAAO,MAAM,oCAAoC,OAAO,IAAI,MAAM;AACvE,SAAM;;;;;;CAOV,MAAM,IACJ,QACA,QACiC;EACjC,MAAM,aAAa,MAAM,KAAK,cAAc,OAAO;AACnD,MAAI,CAAC,WACH,QAAO,EAAE;AAEX,MAAI,OACF,QAAO,OAAO,QACX,KAAK,UAAU;GAAE,GAAG;IAAM,OAAO,WAAW,QAAQ;GAAO,GAC5D,EAAE,CACH;AAEH,SAAO,WAAW,WAAW,EAAE;;;;;CAMjC,MAAM,OACJ,QACA,cACe;EAGf,MAAM,SAAS;GAAE,GAFA,MAAM,KAAK,IAAI,OAAO;GAET,GAAG;GAAc;AAE/C,QAAM,KAAK,IAAI,QAAQ,OAAO;;;;;CAMhC,MAAM,IACJ,QACA,cACe;AACf,QAAM,KAAK,cAAc,QAAQ,eAAe,QAAQ,aAAa,CAAC;;;;;CAMxE,MAAM,IAAI,QAAsC;AAC9C,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,SAAMA,KAAG,OAAO,UAAU;AAC1B,UAAO;UACD;AACN,UAAO;;;;;;CAOX,MAAM,MAAM,QAAmC;AAC7C,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,SAAMA,KAAG,OAAO,UAAU;UACpB;;;;;CAQV,MAAM,WAA0B;AAC9B,MAAI;GACF,MAAM,QAAQ,MAAMA,KAAG,QAAQ,KAAK,OAAO,SAAS;AAEpD,SAAM,QAAQ,IACZ,MACG,QAAQ,SAAS,KAAK,SAAS,QAAQ,CAAC,CACxC,KAAK,SAASA,KAAG,OAAOD,OAAK,KAAK,KAAK,OAAO,UAAU,KAAK,CAAC,CAAC,CACnE;UACK"}

package/build/translators/pluralization/types.d.cts

@@ -8,7 +8,7 @@ type PluralizationConfig = {
   /**
    * LLM provider for pluralization detection
    * Format: "provider:model" (e.g., "groq:llama3-8b-8192")
-   * @default "groq:llama3-8b-8192"
+   * If omitted in user config, the compiler can infer it from translation models.
    */
   model: string;
 };

package/build/translators/pluralization/types.d.mts

@@ -8,7 +8,7 @@ type PluralizationConfig = {
   /**
    * LLM provider for pluralization detection
    * Format: "provider:model" (e.g., "groq:llama3-8b-8192")
-   * @default "groq:llama3-8b-8192"
+   * If omitted in user config, the compiler can infer it from translation models.
    */
   model: string;
 };

package/build/types.d.cts

@@ -31,11 +31,13 @@ type LocalePersistenceConfig = {
  */
 type LingoConfigRequiredFields = "sourceLocale" | "targetLocales";
 type LingoInternalFields = "environment" | "cacheType";
+type PartialPluralizationConfig = Partial<Omit<PluralizationConfig, "sourceLocale">>;
 /**
  * Configuration for the Lingo compiler
  */
-type PartialLingoConfig = Pick<LingoConfig, LingoConfigRequiredFields> & Partial<Omit<LingoConfig, LingoConfigRequiredFields | "dev" | LingoInternalFields> & {
+type PartialLingoConfig = Pick<LingoConfig, LingoConfigRequiredFields> & Partial<Omit<LingoConfig, LingoConfigRequiredFields | "dev" | LingoInternalFields | "pluralization"> & {
   dev: Partial<LingoConfig["dev"]>;
+  pluralization: PartialPluralizationConfig;
 }>;
 type LingoEnvironment = "development" | "production";
 /**

package/build/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;AA4BA;AAKA;AAEA;AAKY,UA9BK,YAAA,CA8Ba;EAAQ;;;;EAIhC,IAAA,EAAA,MAAA;EAAoC;;;;EAHxC,MAAA,EAAA,MAAA;;AASF;AAKA;;;AAoDiB,KA/EL,uBAAA,GA+EK;EAkBO,IAAA,EAAA,QAAA;EAYF,MAAA,EA7G0C,YA6G1C;CAAL;;;;KAxGL,yBAAA;KAEA,mBAAA;;;;KAKA,kBAAA,GAAqB,KAAK,aAAa,6BACjD,QACE,KACE,aACA,oCAAoC;OAE/B,QAAQ;;KAIP,gBAAA;;;;KAKA,WAAA;;;;;;;;;;;;;;;;eAkBG;;;;;;;;;;;;;;;;;;;;gBAsBC;;;;;;;;;;;iBAYC;;;;;;;;;;;;;;;;wBAkBO;;;;;;;;;;iBAYP,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAkCD"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;AA4BA;AAKA;AAEA;AAEY,UA3BK,YAAA,CA2BL;EACL;;;;EAMK,IAAA,EAAA,MAAA;EAA0B;;;;EAIhC,MAAA,EAAA,MAAA;;;;;;AAHJ,KAjBU,uBAAA,GAiBV;EAAO,IAAA,EAAA,QAAA;EAUG,MAAA,EA3BoD,YA2BpC;AAK5B,CAAA;;;;AAsEwB,KAjGZ,yBAAA,GAiGY,cAAA,GAAA,eAAA;AAYF,KA3GV,mBAAA,GA2GU,aAAA,GAAA,WAAA;AAAL,KAzGL,0BAAA,GAA6B,OAyGxB,CAxGf,IAwGe,CAxGV,mBAwGU,EAAA,cAAA,CAAA,CAAA;;;;KAlGL,kBAAA,GAAqB,KAAK,aAAa,6BACjD,QACE,KACE,aACA,oCAAoC;OAE/B,QAAQ;iBACE;;KAIT,gBAAA;;;;KAKA,WAAA;;;;;;;;;;;;;;;;eAkBG;;;;;;;;;;;;;;;;;;;;gBAsBC;;;;;;;;;;;iBAYC;;;;;;;;;;;;;;;;wBAkBO;;;;;;;;;;iBAYP,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAkCD"}

package/build/types.d.mts

@@ -31,11 +31,13 @@ type LocalePersistenceConfig = {
  */
 type LingoConfigRequiredFields = "sourceLocale" | "targetLocales";
 type LingoInternalFields = "environment" | "cacheType";
+type PartialPluralizationConfig = Partial<Omit<PluralizationConfig, "sourceLocale">>;
 /**
  * Configuration for the Lingo compiler
  */
-type PartialLingoConfig = Pick<LingoConfig, LingoConfigRequiredFields> & Partial<Omit<LingoConfig, LingoConfigRequiredFields | "dev" | LingoInternalFields> & {
+type PartialLingoConfig = Pick<LingoConfig, LingoConfigRequiredFields> & Partial<Omit<LingoConfig, LingoConfigRequiredFields | "dev" | LingoInternalFields | "pluralization"> & {
   dev: Partial<LingoConfig["dev"]>;
+  pluralization: PartialPluralizationConfig;
 }>;
 type LingoEnvironment = "development" | "production";
 /**

package/build/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;AA4BA;AAKA;AAEA;AAKY,UA9BK,YAAA,CA8Ba;EAAQ;;;;EAIhC,IAAA,EAAA,MAAA;EAAoC;;;;EAHxC,MAAA,EAAA,MAAA;;AASF;AAKA;;;AAoDiB,KA/EL,uBAAA,GA+EK;EAkBO,IAAA,EAAA,QAAA;EAYF,MAAA,EA7G0C,YA6G1C;CAAL;;;;KAxGL,yBAAA;KAEA,mBAAA;;;;KAKA,kBAAA,GAAqB,KAAK,aAAa,6BACjD,QACE,KACE,aACA,oCAAoC;OAE/B,QAAQ;;KAIP,gBAAA;;;;KAKA,WAAA;;;;;;;;;;;;;;;;eAkBG;;;;;;;;;;;;;;;;;;;;gBAsBC;;;;;;;;;;;iBAYC;;;;;;;;;;;;;;;;wBAkBO;;;;;;;;;;iBAYP,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAkCD"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;AA4BA;AAKA;AAEA;AAEY,UA3BK,YAAA,CA2BL;EACL;;;;EAMK,IAAA,EAAA,MAAA;EAA0B;;;;EAIhC,MAAA,EAAA,MAAA;;;;;;AAHJ,KAjBU,uBAAA,GAiBV;EAAO,IAAA,EAAA,QAAA;EAUG,MAAA,EA3BoD,YA2BpC;AAK5B,CAAA;;;;AAsEwB,KAjGZ,yBAAA,GAiGY,cAAA,GAAA,eAAA;AAYF,KA3GV,mBAAA,GA2GU,aAAA,GAAA,WAAA;AAAL,KAzGL,0BAAA,GAA6B,OAyGxB,CAxGf,IAwGe,CAxGV,mBAwGU,EAAA,cAAA,CAAA,CAAA;;;;KAlGL,kBAAA,GAAqB,KAAK,aAAa,6BACjD,QACE,KACE,aACA,oCAAoC;OAE/B,QAAQ;iBACE;;KAIT,gBAAA;;;;KAKA,WAAA;;;;;;;;;;;;;;;;eAkBG;;;;;;;;;;;;;;;;;;;;gBAsBC;;;;;;;;;;;iBAYC;;;;;;;;;;;;;;;;wBAkBO;;;;;;;;;;iBAYP,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAkCD"}

package/build/utils/config-factory.cjs

@@ -17,11 +17,27 @@ const DEFAULT_CONFIG = {
 	},
 	models: "lingo.dev",
 	pluralization: {
-		enabled: true,
+		enabled: false,
 		model: "groq:llama-3.1-8b-instant"
 	},
 	buildMode: "translate"
 };
+function getModelStringForLocales(models, sourceLocale, targetLocale) {
+	const modelKey = (targetLocale ? [
+		`${sourceLocale}:${targetLocale}`,
+		`*:${targetLocale}`,
+		`${sourceLocale}:*`,
+		"*:*"
+	] : [`${sourceLocale}:*`, "*:*"]).find((key) => key in models);
+	if (modelKey) return models[modelKey];
+	const sortedKeys = Object.keys(models).sort();
+	if (sortedKeys.length === 0) return;
+	return models[sortedKeys[0]];
+}
+function inferPluralizationModel(models, sourceLocale, targetLocales) {
+	if (models === "lingo.dev") return;
+	return getModelStringForLocales(models, sourceLocale, targetLocales[0]);
+}
 /**
 * Create a LoaderConfig with defaults applied
 *
@@ -30,7 +46,7 @@ const DEFAULT_CONFIG = {
 *
 */
 function createLingoConfig(options) {
-	return {
+	const config = {
 		...DEFAULT_CONFIG,
 		...options,
 		environment: options.environment ?? (process.env.NODE_ENV === "development" ? "development" : "production"),
@@ -52,6 +68,22 @@ function createLingoConfig(options) {
 			}
 		}
 	};
+	const explicitEnabled = options.pluralization?.enabled;
+	const explicitModel = options.pluralization?.model;
+	const hasExplicitModel = typeof explicitModel === "string" && explicitModel.trim().length > 0;
+	const pluralizationEnabled = typeof explicitEnabled === "boolean" ? explicitEnabled : hasExplicitModel;
+	let pluralizationModel = hasExplicitModel ? explicitModel.trim() : config.pluralization.model;
+	if (pluralizationEnabled && !hasExplicitModel) {
+		const inferredModel = inferPluralizationModel(config.models, config.sourceLocale, config.targetLocales);
+		if (!inferredModel) throw new Error("Pluralization is enabled but no \"pluralization.model\" is configured. Please set \"pluralization.model\" explicitly or use direct LLM models (not \"lingo.dev\") so the model can be inferred.");
+		pluralizationModel = inferredModel;
+	}
+	config.pluralization = {
+		...config.pluralization,
+		enabled: pluralizationEnabled,
+		model: pluralizationModel
+	};
+	return config;
 }
 
 //#endregion

package/build/utils/config-factory.mjs

@@ -16,11 +16,27 @@ const DEFAULT_CONFIG = {
 	},
 	models: "lingo.dev",
 	pluralization: {
-		enabled: true,
+		enabled: false,
 		model: "groq:llama-3.1-8b-instant"
 	},
 	buildMode: "translate"
 };
+function getModelStringForLocales(models, sourceLocale, targetLocale) {
+	const modelKey = (targetLocale ? [
+		`${sourceLocale}:${targetLocale}`,
+		`*:${targetLocale}`,
+		`${sourceLocale}:*`,
+		"*:*"
+	] : [`${sourceLocale}:*`, "*:*"]).find((key) => key in models);
+	if (modelKey) return models[modelKey];
+	const sortedKeys = Object.keys(models).sort();
+	if (sortedKeys.length === 0) return;
+	return models[sortedKeys[0]];
+}
+function inferPluralizationModel(models, sourceLocale, targetLocales) {
+	if (models === "lingo.dev") return;
+	return getModelStringForLocales(models, sourceLocale, targetLocales[0]);
+}
 /**
 * Create a LoaderConfig with defaults applied
 *
@@ -29,7 +45,7 @@ const DEFAULT_CONFIG = {
 *
 */
 function createLingoConfig(options) {
-	return {
+	const config = {
 		...DEFAULT_CONFIG,
 		...options,
 		environment: options.environment ?? (process.env.NODE_ENV === "development" ? "development" : "production"),
@@ -51,6 +67,22 @@ function createLingoConfig(options) {
 			}
 		}
 	};
+	const explicitEnabled = options.pluralization?.enabled;
+	const explicitModel = options.pluralization?.model;
+	const hasExplicitModel = typeof explicitModel === "string" && explicitModel.trim().length > 0;
+	const pluralizationEnabled = typeof explicitEnabled === "boolean" ? explicitEnabled : hasExplicitModel;
+	let pluralizationModel = hasExplicitModel ? explicitModel.trim() : config.pluralization.model;
+	if (pluralizationEnabled && !hasExplicitModel) {
+		const inferredModel = inferPluralizationModel(config.models, config.sourceLocale, config.targetLocales);
+		if (!inferredModel) throw new Error("Pluralization is enabled but no \"pluralization.model\" is configured. Please set \"pluralization.model\" explicitly or use direct LLM models (not \"lingo.dev\") so the model can be inferred.");
+		pluralizationModel = inferredModel;
+	}
+	config.pluralization = {
+		...config.pluralization,
+		enabled: pluralizationEnabled,
+		model: pluralizationModel
+	};
+	return config;
 }
 
 //#endregion

package/build/utils/config-factory.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config-factory.mjs","names":[],"sources":["../../src/utils/config-factory.ts"],"sourcesContent":["/**\n * Config factory for creating LoaderConfig instances\n */\nimport type {\n  LingoConfig,\n  LingoConfigRequiredFields,\n  LingoInternalFields,\n  PartialLingoConfig,\n} from \"../types\";\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG = {\n  sourceRoot: \"src\",\n  lingoDir: \"lingo\",\n  useDirective: false,\n  dev: {\n    translationServerStartPort: 60000,\n  },\n  localePersistence: {\n    type: \"cookie\" as const,\n    config: {\n      name: \"locale\",\n      maxAge: 31536000,\n    },\n  },\n  models: \"lingo.dev\",\n  pluralization: {\n    enabled: true,\n    model: \"groq:llama-3.1-8b-instant\",\n  },\n  buildMode: \"translate\",\n} satisfies Omit<\n  LingoConfig,\n  // Looks like we can use LingoInternalFields, but it's only a coincidence that the types match, we may want to provide default for internal fields\n  LingoConfigRequiredFields | \"environment\" | \"cacheType\"\n>;\n\n/**\n * Create a LoaderConfig with defaults applied\n *\n * @param options - Partial config to override defaults\n * @returns Complete LoaderConfig with all defaults applied\n *\n */\nexport function createLingoConfig(\n  options: PartialLingoConfig & Partial<Pick<LingoConfig, LingoInternalFields>>,\n): LingoConfig {\n  return {\n    ...DEFAULT_CONFIG,\n    ...options,\n    environment:\n      options.environment ??\n      (process.env.NODE_ENV === \"development\" ? \"development\" : \"production\"),\n    cacheType: options.cacheType ?? \"local\",\n    dev: {\n      ...DEFAULT_CONFIG.dev,\n      ...options.dev,\n    },\n    pluralization: {\n      ...DEFAULT_CONFIG.pluralization,\n      ...options.pluralization,\n    },\n    localePersistence: {\n      ...DEFAULT_CONFIG.localePersistence,\n      ...options.localePersistence,\n      config: {\n        ...DEFAULT_CONFIG.localePersistence.config,\n        ...options.localePersistence?.config,\n      },\n    },\n  };\n}\n"],"mappings":";;;;AAaA,MAAa,iBAAiB;CAC5B,YAAY;CACZ,UAAU;CACV,cAAc;CACd,KAAK,EACH,4BAA4B,KAC7B;CACD,mBAAmB;EACjB,MAAM;EACN,QAAQ;GACN,MAAM;GACN,QAAQ;GACT;EACF;CACD,QAAQ;CACR,eAAe;EACb,SAAS;EACT,OAAO;EACR;CACD,WAAW;CACZ;;;;;;;;AAaD,SAAgB,kBACd,SACa;AACb,QAAO;EACL,GAAG;EACH,GAAG;EACH,aACE,QAAQ,gBACP,QAAQ,IAAI,aAAa,gBAAgB,gBAAgB;EAC5D,WAAW,QAAQ,aAAa;EAChC,KAAK;GACH,GAAG,eAAe;GAClB,GAAG,QAAQ;GACZ;EACD,eAAe;GACb,GAAG,eAAe;GAClB,GAAG,QAAQ;GACZ;EACD,mBAAmB;GACjB,GAAG,eAAe;GAClB,GAAG,QAAQ;GACX,QAAQ;IACN,GAAG,eAAe,kBAAkB;IACpC,GAAG,QAAQ,mBAAmB;IAC/B;GACF;EACF"}
+{"version":3,"file":"config-factory.mjs","names":["config: LingoConfig"],"sources":["../../src/utils/config-factory.ts"],"sourcesContent":["/**\n * Config factory for creating LoaderConfig instances\n */\nimport type {\n  LingoConfig,\n  LingoConfigRequiredFields,\n  LingoInternalFields,\n  PartialLingoConfig,\n} from \"../types\";\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG = {\n  sourceRoot: \"src\",\n  lingoDir: \"lingo\",\n  useDirective: false,\n  dev: {\n    translationServerStartPort: 60000,\n  },\n  localePersistence: {\n    type: \"cookie\" as const,\n    config: {\n      name: \"locale\",\n      maxAge: 31536000,\n    },\n  },\n  models: \"lingo.dev\",\n  pluralization: {\n    enabled: false,\n    model: \"groq:llama-3.1-8b-instant\",\n  },\n  buildMode: \"translate\",\n} satisfies Omit<\n  LingoConfig,\n  // Looks like we can use LingoInternalFields, but it's only a coincidence that the types match, we may want to provide default for internal fields\n  LingoConfigRequiredFields | \"environment\" | \"cacheType\"\n>;\n\nfunction getModelStringForLocales(\n  models: Record<string, string>,\n  sourceLocale: string,\n  targetLocale: string | undefined,\n): string | undefined {\n  const localeKeys = targetLocale\n    ? [\n        `${sourceLocale}:${targetLocale}`,\n        `*:${targetLocale}`,\n        `${sourceLocale}:*`,\n        \"*:*\",\n      ]\n    : [`${sourceLocale}:*`, \"*:*\"];\n\n  const modelKey = localeKeys.find((key) => key in models);\n  if (modelKey) {\n    return models[modelKey];\n  }\n\n  const sortedKeys = Object.keys(models).sort();\n  if (sortedKeys.length === 0) {\n    return undefined;\n  }\n\n  return models[sortedKeys[0]];\n}\n\nfunction inferPluralizationModel(\n  models: \"lingo.dev\" | Record<string, string>,\n  sourceLocale: string,\n  targetLocales: string[],\n): string | undefined {\n  if (models === \"lingo.dev\") {\n    return undefined;\n  }\n\n  return getModelStringForLocales(\n    models,\n    sourceLocale,\n    targetLocales[0],\n  );\n}\n\n/**\n * Create a LoaderConfig with defaults applied\n *\n * @param options - Partial config to override defaults\n * @returns Complete LoaderConfig with all defaults applied\n *\n */\nexport function createLingoConfig(\n  options: PartialLingoConfig & Partial<Pick<LingoConfig, LingoInternalFields>>,\n): LingoConfig {\n  const config: LingoConfig = {\n    ...DEFAULT_CONFIG,\n    ...options,\n    environment:\n      options.environment ??\n      (process.env.NODE_ENV === \"development\" ? \"development\" : \"production\"),\n    cacheType: options.cacheType ?? \"local\",\n    dev: {\n      ...DEFAULT_CONFIG.dev,\n      ...options.dev,\n    },\n    pluralization: {\n      ...DEFAULT_CONFIG.pluralization,\n      ...options.pluralization,\n    },\n    localePersistence: {\n      ...DEFAULT_CONFIG.localePersistence,\n      ...options.localePersistence,\n      config: {\n        ...DEFAULT_CONFIG.localePersistence.config,\n        ...options.localePersistence?.config,\n      },\n    },\n  };\n\n  const explicitEnabled = options.pluralization?.enabled;\n  const explicitModel = options.pluralization?.model;\n  const hasExplicitModel =\n    typeof explicitModel === \"string\" && explicitModel.trim().length > 0;\n  const hasExplicitEnabled = typeof explicitEnabled === \"boolean\";\n\n  const pluralizationEnabled = hasExplicitEnabled\n    ? explicitEnabled\n    : hasExplicitModel;\n\n  let pluralizationModel = hasExplicitModel\n    ? explicitModel!.trim()\n    : config.pluralization.model;\n\n  if (pluralizationEnabled && !hasExplicitModel) {\n    const inferredModel = inferPluralizationModel(\n      config.models,\n      config.sourceLocale,\n      config.targetLocales,\n    );\n\n    if (!inferredModel) {\n      throw new Error(\n        'Pluralization is enabled but no \"pluralization.model\" is configured. Please set \"pluralization.model\" explicitly or use direct LLM models (not \"lingo.dev\") so the model can be inferred.',\n      );\n    }\n\n    pluralizationModel = inferredModel;\n  }\n\n  config.pluralization = {\n    ...config.pluralization,\n    enabled: pluralizationEnabled,\n    model: pluralizationModel,\n  };\n\n  return config;\n}\n"],"mappings":";;;;AAaA,MAAa,iBAAiB;CAC5B,YAAY;CACZ,UAAU;CACV,cAAc;CACd,KAAK,EACH,4BAA4B,KAC7B;CACD,mBAAmB;EACjB,MAAM;EACN,QAAQ;GACN,MAAM;GACN,QAAQ;GACT;EACF;CACD,QAAQ;CACR,eAAe;EACb,SAAS;EACT,OAAO;EACR;CACD,WAAW;CACZ;AAMD,SAAS,yBACP,QACA,cACA,cACoB;CAUpB,MAAM,YATa,eACf;EACE,GAAG,aAAa,GAAG;EACnB,KAAK;EACL,GAAG,aAAa;EAChB;EACD,GACD,CAAC,GAAG,aAAa,KAAK,MAAM,EAEJ,MAAM,QAAQ,OAAO,OAAO;AACxD,KAAI,SACF,QAAO,OAAO;CAGhB,MAAM,aAAa,OAAO,KAAK,OAAO,CAAC,MAAM;AAC7C,KAAI,WAAW,WAAW,EACxB;AAGF,QAAO,OAAO,WAAW;;AAG3B,SAAS,wBACP,QACA,cACA,eACoB;AACpB,KAAI,WAAW,YACb;AAGF,QAAO,yBACL,QACA,cACA,cAAc,GACf;;;;;;;;;AAUH,SAAgB,kBACd,SACa;CACb,MAAMA,SAAsB;EAC1B,GAAG;EACH,GAAG;EACH,aACE,QAAQ,gBACP,QAAQ,IAAI,aAAa,gBAAgB,gBAAgB;EAC5D,WAAW,QAAQ,aAAa;EAChC,KAAK;GACH,GAAG,eAAe;GAClB,GAAG,QAAQ;GACZ;EACD,eAAe;GACb,GAAG,eAAe;GAClB,GAAG,QAAQ;GACZ;EACD,mBAAmB;GACjB,GAAG,eAAe;GAClB,GAAG,QAAQ;GACX,QAAQ;IACN,GAAG,eAAe,kBAAkB;IACpC,GAAG,QAAQ,mBAAmB;IAC/B;GACF;EACF;CAED,MAAM,kBAAkB,QAAQ,eAAe;CAC/C,MAAM,gBAAgB,QAAQ,eAAe;CAC7C,MAAM,mBACJ,OAAO,kBAAkB,YAAY,cAAc,MAAM,CAAC,SAAS;CAGrE,MAAM,uBAFqB,OAAO,oBAAoB,YAGlD,kBACA;CAEJ,IAAI,qBAAqB,mBACrB,cAAe,MAAM,GACrB,OAAO,cAAc;AAEzB,KAAI,wBAAwB,CAAC,kBAAkB;EAC7C,MAAM,gBAAgB,wBACpB,OAAO,QACP,OAAO,cACP,OAAO,cACR;AAED,MAAI,CAAC,cACH,OAAM,IAAI,MACR,kMACD;AAGH,uBAAqB;;AAGvB,QAAO,gBAAgB;EACrB,GAAG,OAAO;EACV,SAAS;EACT,OAAO;EACR;AAED,QAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingo.dev/compiler",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Lingo.dev Compiler",
   "private": false,
   "repository": {
@@ -162,7 +162,7 @@
     "posthog-node": "5.14.0",
     "proper-lockfile": "4.1.2",
     "ws": "8.18.3",
-    "lingo.dev": "^0.125.4"
+    "lingo.dev": "^0.125.5"
   },
   "peerDependencies": {
     "next": "^15.0.0 || ^16.0.4",