@lingo.dev/compiler 0.1.0

package/build/translators/api.cjs

@@ -0,0 +1,12 @@
+
+//#region src/translators/api.ts
+function dictionaryFrom(locale, entries) {
+	return {
+		version: .1,
+		locale,
+		entries
+	};
+}
+
+//#endregion
+exports.dictionaryFrom = dictionaryFrom;

package/build/translators/api.mjs

@@ -0,0 +1,12 @@
+//#region src/translators/api.ts
+function dictionaryFrom(locale, entries) {
+	return {
+		version: .1,
+		locale,
+		entries
+	};
+}
+
+//#endregion
+export { dictionaryFrom };
+//# sourceMappingURL=api.mjs.map

package/build/translators/api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.mjs","names":[],"sources":["../../src/translators/api.ts"],"sourcesContent":["import type { LocaleCode } from \"lingo.dev/spec\";\n\nexport type TranslatableEntry = { text: string; context: Record<string, any> };\n\nexport interface Translator<Config> {\n  config: Config;\n\n  translate: (\n    locale: LocaleCode,\n    entriesMap: Record<string, TranslatableEntry>,\n  ) => Promise<Record<string, string>>;\n}\n\n/**\n * Dictionary schema for translation\n * Simple flat structure with direct access to translations\n */\nexport interface DictionarySchema {\n  version: number;\n  locale: LocaleCode;\n  entries: Record<string, string>;\n}\n\nexport function dictionaryFrom(\n  locale: LocaleCode,\n  entries: DictionarySchema[\"entries\"],\n) {\n  return {\n    // TODO (AleksandrSl 14/12/2025): We do not use version anywhere.\n    //  We should either get rid of it, or start cheking it, e.g. if we updated the hash function we should nuke the caches. However, in this case we can tie version to the hash somewhat automatically by using hash function name\n    version: 0.1,\n    locale,\n    entries,\n  };\n}\n"],"mappings":";AAuBA,SAAgB,eACd,QACA,SACA;AACA,QAAO;EAGL,SAAS;EACT;EACA;EACD"}

package/build/translators/cache-factory.cjs

@@ -0,0 +1,26 @@
+const require_logger = require('../utils/logger.cjs');
+const require_local_cache = require('./local-cache.cjs');
+const require_path_helpers = require('../utils/path-helpers.cjs');
+
+//#region src/translators/cache-factory.ts
+/**
+* Create a cache instance based on the config
+*
+* @param config - LingoConfig with cacheType and lingoDir
+* @returns TranslationCache instance
+*
+* @example
+* ```typescript
+* const cache = createCache(config);
+* const translations = await cache.get("de");
+* ```
+*/
+function createCache(config) {
+	switch (config.cacheType) {
+		case "local": return new require_local_cache.LocalTranslationCache({ cacheDir: require_path_helpers.getCacheDir(config) }, require_logger.logger);
+		default: throw new Error(`Unknown cache type: ${config.cacheType}. Only "local" is currently supported.`);
+	}
+}
+
+//#endregion
+exports.createCache = createCache;

package/build/translators/cache-factory.mjs

@@ -0,0 +1,27 @@
+import { logger } from "../utils/logger.mjs";
+import { LocalTranslationCache } from "./local-cache.mjs";
+import { getCacheDir } from "../utils/path-helpers.mjs";
+
+//#region src/translators/cache-factory.ts
+/**
+* Create a cache instance based on the config
+*
+* @param config - LingoConfig with cacheType and lingoDir
+* @returns TranslationCache instance
+*
+* @example
+* ```typescript
+* const cache = createCache(config);
+* const translations = await cache.get("de");
+* ```
+*/
+function createCache(config) {
+	switch (config.cacheType) {
+		case "local": return new LocalTranslationCache({ cacheDir: getCacheDir(config) }, logger);
+		default: throw new Error(`Unknown cache type: ${config.cacheType}. Only "local" is currently supported.`);
+	}
+}
+
+//#endregion
+export { createCache };
+//# sourceMappingURL=cache-factory.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-factory.mjs","names":[],"sources":["../../src/translators/cache-factory.ts"],"sourcesContent":["/**\n * Cache factory for creating cache instances from config\n */\n\nimport type { LingoConfig, PathConfig } from \"../types\";\nimport type { TranslationCache } from \"./cache\";\nimport { LocalTranslationCache } from \"./local-cache\";\nimport { logger } from \"../utils/logger\";\nimport { getCacheDir } from \"../utils/path-helpers\";\n\n/**\n * Create a cache instance based on the config\n *\n * @param config - LingoConfig with cacheType and lingoDir\n * @returns TranslationCache instance\n *\n * @example\n * ```typescript\n * const cache = createCache(config);\n * const translations = await cache.get(\"de\");\n * ```\n */\nexport function createCache(\n  config: Pick<LingoConfig, \"cacheType\"> & PathConfig,\n): TranslationCache {\n  switch (config.cacheType) {\n    case \"local\":\n      return new LocalTranslationCache(\n        {\n          cacheDir: getCacheDir(config),\n        },\n        logger,\n      );\n\n    default:\n      // This should never happen due to TypeScript types, but provides a safeguard\n      throw new Error(\n        `Unknown cache type: ${config.cacheType}. Only \"local\" is currently supported.`,\n      );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAsBA,SAAgB,YACd,QACkB;AAClB,SAAQ,OAAO,WAAf;EACE,KAAK,QACH,QAAO,IAAI,sBACT,EACE,UAAU,YAAY,OAAO,EAC9B,EACD,OACD;EAEH,QAEE,OAAM,IAAI,MACR,uBAAuB,OAAO,UAAU,wCACzC"}

package/build/translators/lingo/model-factory.cjs

@@ -0,0 +1,179 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+let path = require("path");
+path = require_rolldown_runtime.__toESM(path);
+let _ai_sdk_groq = require("@ai-sdk/groq");
+let _ai_sdk_google = require("@ai-sdk/google");
+let _openrouter_ai_sdk_provider = require("@openrouter/ai-sdk-provider");
+let ai_sdk_ollama = require("ai-sdk-ollama");
+let _ai_sdk_mistral = require("@ai-sdk/mistral");
+let dotenv = require("dotenv");
+dotenv = require_rolldown_runtime.__toESM(dotenv);
+
+//#region src/translators/lingo/model-factory.ts
+/**
+* Shared utilities for creating AI model instances
+*/
+function getKeyFromEnv(envVarName) {
+	if (process.env[envVarName]) return process.env[envVarName];
+	const projectRoot = process.cwd();
+	return dotenv.config({ path: [
+		path.resolve(projectRoot, ".env"),
+		path.resolve(projectRoot, ".env.local"),
+		path.resolve(projectRoot, ".env.development")
+	] })?.parsed?.[envVarName];
+}
+const providerDetails = {
+	groq: {
+		name: "Groq",
+		apiKeyEnvVar: "GROQ_API_KEY",
+		apiKeyConfigKey: "llm.groqApiKey",
+		getKeyLink: "https://groq.com",
+		docsLink: "https://console.groq.com/docs/errors"
+	},
+	google: {
+		name: "Google",
+		apiKeyEnvVar: "GOOGLE_API_KEY",
+		apiKeyConfigKey: "llm.googleApiKey",
+		getKeyLink: "https://ai.google.dev/",
+		docsLink: "https://ai.google.dev/gemini-api/docs/troubleshooting"
+	},
+	openai: {
+		name: "OpenAI",
+		apiKeyEnvVar: "OPENAI_API_KEY",
+		apiKeyConfigKey: "llm.openaiApiKey",
+		getKeyLink: "https://platform.openai.com/account/api-keys",
+		docsLink: "https://platform.openai.com/docs"
+	},
+	anthropic: {
+		name: "Anthropic",
+		apiKeyEnvVar: "ANTHROPIC_API_KEY",
+		apiKeyConfigKey: "llm.anthropicApiKey",
+		getKeyLink: "https://console.anthropic.com/get-api-key",
+		docsLink: "https://console.anthropic.com/docs"
+	},
+	openrouter: {
+		name: "OpenRouter",
+		apiKeyEnvVar: "OPENROUTER_API_KEY",
+		apiKeyConfigKey: "llm.openrouterApiKey",
+		getKeyLink: "https://openrouter.ai",
+		docsLink: "https://openrouter.ai/docs"
+	},
+	ollama: {
+		name: "Ollama",
+		apiKeyEnvVar: void 0,
+		apiKeyConfigKey: void 0,
+		getKeyLink: "https://ollama.com/download",
+		docsLink: "https://github.com/ollama/ollama/tree/main/docs"
+	},
+	mistral: {
+		name: "Mistral",
+		apiKeyEnvVar: "MISTRAL_API_KEY",
+		apiKeyConfigKey: "llm.mistralApiKey",
+		getKeyLink: "https://console.mistral.ai",
+		docsLink: "https://docs.mistral.ai"
+	},
+	"lingo.dev": {
+		name: "Lingo.dev",
+		apiKeyEnvVar: "LINGODOTDEV_API_KEY",
+		apiKeyConfigKey: "auth.apiKey",
+		getKeyLink: "https://lingo.dev",
+		docsLink: "https://lingo.dev/docs"
+	}
+};
+/**
+* Get provider and model for a specific locale pair
+*/
+function getLocaleModel(localeModels, sourceLocale, targetLocale) {
+	const modelKey = [
+		`${sourceLocale}:${targetLocale}`,
+		`*:${targetLocale}`,
+		`${sourceLocale}:*`,
+		"*:*"
+	].find((key) => key in localeModels);
+	if (!modelKey) return;
+	const value = localeModels[modelKey];
+	if (!value) return;
+	return parseModelString(value);
+}
+/**
+* Parse provider and model from model string
+* Format: "provider:model" (e.g., "groq:llama3-8b-8192")
+*
+* @param modelString Model string to parse
+* @returns Object with provider and model
+* @throws Error if format is invalid
+*/
+function parseModelString(modelString) {
+	const [provider, name] = modelString.split(":", 2);
+	if (!provider || !name) return;
+	return {
+		provider,
+		name
+	};
+}
+/**
+* Validate and fetch all necessary API keys for the given configuration
+* This should be called once at initialization time
+*
+* @param config Model configuration ("lingo.dev" or locale-pair mapping)
+* @returns Validated API keys (provider ID -> API key)
+* @throws Error if required keys are missing
+*/
+function validateAndGetApiKeys(config) {
+	const keys = {};
+	const missingKeys = [];
+	let providersToValidate;
+	if (config === "lingo.dev") providersToValidate = ["lingo.dev"];
+	else {
+		const providerSet = /* @__PURE__ */ new Set();
+		Object.values(config).forEach((modelString) => {
+			const model = parseModelString(modelString);
+			if (model) providerSet.add(model.provider);
+		});
+		providersToValidate = Array.from(providerSet);
+	}
+	for (const provider of providersToValidate) {
+		const providerConfig = providerDetails[provider];
+		if (!providerConfig) throw new Error(`⚠️  Unknown provider "${provider}". Supported providers: ${Object.keys(providerDetails).join(", ")}`);
+		if (!providerConfig.apiKeyEnvVar) continue;
+		const key = getKeyFromEnv(providerConfig.apiKeyEnvVar);
+		if (key) keys[provider] = key;
+		else missingKeys.push({
+			provider: providerConfig.name,
+			envVar: providerConfig.apiKeyEnvVar
+		});
+	}
+	if (missingKeys.length > 0) {
+		const errorLines = missingKeys.map(({ provider, envVar }) => `  - ${provider}: ${envVar}`);
+		throw new Error(`⚠️  Missing API keys for configured providers:\n${errorLines.join("\n")}\n\nPlease set the required environment variables.`);
+	}
+	return keys;
+}
+/**
+* Create AI model instance from provider and model ID
+*
+* @param model Provider name (groq, google, openrouter, ollama, mistral) and model identifier
+* @param validatedKeys Pre-validated API keys from validateAndFetchApiKeys()
+* @returns LanguageModel instance
+* @throws Error if provider is not supported or API key is missing
+*/
+function createAiModel(model, validatedKeys) {
+	const providerConfig = providerDetails[model.provider];
+	if (!providerConfig) throw new Error(`⚠️  Provider "${model.provider}" is not supported. Supported providers: ${Object.keys(providerDetails).join(", ")}`);
+	const apiKey = providerConfig.apiKeyEnvVar ? validatedKeys[model.provider] : void 0;
+	if (providerConfig.apiKeyEnvVar && !apiKey) throw new Error(`⚠️  ${providerConfig.name} API key not found. Please set ${providerConfig.apiKeyEnvVar} environment variable.\n\nThis should not happen if validateAndFetchApiKeys() was called. Please restart the service.`);
+	switch (model.provider) {
+		case "groq": return (0, _ai_sdk_groq.createGroq)({ apiKey })(model.name);
+		case "google": return (0, _ai_sdk_google.createGoogleGenerativeAI)({ apiKey })(model.name);
+		case "openrouter": return (0, _openrouter_ai_sdk_provider.createOpenRouter)({ apiKey })(model.name);
+		case "ollama": return (0, ai_sdk_ollama.ollama)(model.name);
+		case "mistral": return (0, _ai_sdk_mistral.createMistral)({ apiKey })(model.name);
+		default: throw new Error(`⚠️  Provider "${model.provider}" is not implemented`);
+	}
+}
+
+//#endregion
+exports.createAiModel = createAiModel;
+exports.getLocaleModel = getLocaleModel;
+exports.parseModelString = parseModelString;
+exports.validateAndGetApiKeys = validateAndGetApiKeys;

package/build/translators/lingo/model-factory.mjs

@@ -0,0 +1,174 @@
+import * as path$1 from "path";
+import { createGroq } from "@ai-sdk/groq";
+import { createGoogleGenerativeAI } from "@ai-sdk/google";
+import { createOpenRouter } from "@openrouter/ai-sdk-provider";
+import { ollama } from "ai-sdk-ollama";
+import { createMistral } from "@ai-sdk/mistral";
+import * as dotenv from "dotenv";
+
+//#region src/translators/lingo/model-factory.ts
+/**
+* Shared utilities for creating AI model instances
+*/
+function getKeyFromEnv(envVarName) {
+	if (process.env[envVarName]) return process.env[envVarName];
+	const projectRoot = process.cwd();
+	return dotenv.config({ path: [
+		path$1.resolve(projectRoot, ".env"),
+		path$1.resolve(projectRoot, ".env.local"),
+		path$1.resolve(projectRoot, ".env.development")
+	] })?.parsed?.[envVarName];
+}
+const providerDetails = {
+	groq: {
+		name: "Groq",
+		apiKeyEnvVar: "GROQ_API_KEY",
+		apiKeyConfigKey: "llm.groqApiKey",
+		getKeyLink: "https://groq.com",
+		docsLink: "https://console.groq.com/docs/errors"
+	},
+	google: {
+		name: "Google",
+		apiKeyEnvVar: "GOOGLE_API_KEY",
+		apiKeyConfigKey: "llm.googleApiKey",
+		getKeyLink: "https://ai.google.dev/",
+		docsLink: "https://ai.google.dev/gemini-api/docs/troubleshooting"
+	},
+	openai: {
+		name: "OpenAI",
+		apiKeyEnvVar: "OPENAI_API_KEY",
+		apiKeyConfigKey: "llm.openaiApiKey",
+		getKeyLink: "https://platform.openai.com/account/api-keys",
+		docsLink: "https://platform.openai.com/docs"
+	},
+	anthropic: {
+		name: "Anthropic",
+		apiKeyEnvVar: "ANTHROPIC_API_KEY",
+		apiKeyConfigKey: "llm.anthropicApiKey",
+		getKeyLink: "https://console.anthropic.com/get-api-key",
+		docsLink: "https://console.anthropic.com/docs"
+	},
+	openrouter: {
+		name: "OpenRouter",
+		apiKeyEnvVar: "OPENROUTER_API_KEY",
+		apiKeyConfigKey: "llm.openrouterApiKey",
+		getKeyLink: "https://openrouter.ai",
+		docsLink: "https://openrouter.ai/docs"
+	},
+	ollama: {
+		name: "Ollama",
+		apiKeyEnvVar: void 0,
+		apiKeyConfigKey: void 0,
+		getKeyLink: "https://ollama.com/download",
+		docsLink: "https://github.com/ollama/ollama/tree/main/docs"
+	},
+	mistral: {
+		name: "Mistral",
+		apiKeyEnvVar: "MISTRAL_API_KEY",
+		apiKeyConfigKey: "llm.mistralApiKey",
+		getKeyLink: "https://console.mistral.ai",
+		docsLink: "https://docs.mistral.ai"
+	},
+	"lingo.dev": {
+		name: "Lingo.dev",
+		apiKeyEnvVar: "LINGODOTDEV_API_KEY",
+		apiKeyConfigKey: "auth.apiKey",
+		getKeyLink: "https://lingo.dev",
+		docsLink: "https://lingo.dev/docs"
+	}
+};
+/**
+* Get provider and model for a specific locale pair
+*/
+function getLocaleModel(localeModels, sourceLocale, targetLocale) {
+	const modelKey = [
+		`${sourceLocale}:${targetLocale}`,
+		`*:${targetLocale}`,
+		`${sourceLocale}:*`,
+		"*:*"
+	].find((key) => key in localeModels);
+	if (!modelKey) return;
+	const value = localeModels[modelKey];
+	if (!value) return;
+	return parseModelString(value);
+}
+/**
+* Parse provider and model from model string
+* Format: "provider:model" (e.g., "groq:llama3-8b-8192")
+*
+* @param modelString Model string to parse
+* @returns Object with provider and model
+* @throws Error if format is invalid
+*/
+function parseModelString(modelString) {
+	const [provider, name] = modelString.split(":", 2);
+	if (!provider || !name) return;
+	return {
+		provider,
+		name
+	};
+}
+/**
+* Validate and fetch all necessary API keys for the given configuration
+* This should be called once at initialization time
+*
+* @param config Model configuration ("lingo.dev" or locale-pair mapping)
+* @returns Validated API keys (provider ID -> API key)
+* @throws Error if required keys are missing
+*/
+function validateAndGetApiKeys(config) {
+	const keys = {};
+	const missingKeys = [];
+	let providersToValidate;
+	if (config === "lingo.dev") providersToValidate = ["lingo.dev"];
+	else {
+		const providerSet = /* @__PURE__ */ new Set();
+		Object.values(config).forEach((modelString) => {
+			const model = parseModelString(modelString);
+			if (model) providerSet.add(model.provider);
+		});
+		providersToValidate = Array.from(providerSet);
+	}
+	for (const provider of providersToValidate) {
+		const providerConfig = providerDetails[provider];
+		if (!providerConfig) throw new Error(`⚠️  Unknown provider "${provider}". Supported providers: ${Object.keys(providerDetails).join(", ")}`);
+		if (!providerConfig.apiKeyEnvVar) continue;
+		const key = getKeyFromEnv(providerConfig.apiKeyEnvVar);
+		if (key) keys[provider] = key;
+		else missingKeys.push({
+			provider: providerConfig.name,
+			envVar: providerConfig.apiKeyEnvVar
+		});
+	}
+	if (missingKeys.length > 0) {
+		const errorLines = missingKeys.map(({ provider, envVar }) => `  - ${provider}: ${envVar}`);
+		throw new Error(`⚠️  Missing API keys for configured providers:\n${errorLines.join("\n")}\n\nPlease set the required environment variables.`);
+	}
+	return keys;
+}
+/**
+* Create AI model instance from provider and model ID
+*
+* @param model Provider name (groq, google, openrouter, ollama, mistral) and model identifier
+* @param validatedKeys Pre-validated API keys from validateAndFetchApiKeys()
+* @returns LanguageModel instance
+* @throws Error if provider is not supported or API key is missing
+*/
+function createAiModel(model, validatedKeys) {
+	const providerConfig = providerDetails[model.provider];
+	if (!providerConfig) throw new Error(`⚠️  Provider "${model.provider}" is not supported. Supported providers: ${Object.keys(providerDetails).join(", ")}`);
+	const apiKey = providerConfig.apiKeyEnvVar ? validatedKeys[model.provider] : void 0;
+	if (providerConfig.apiKeyEnvVar && !apiKey) throw new Error(`⚠️  ${providerConfig.name} API key not found. Please set ${providerConfig.apiKeyEnvVar} environment variable.\n\nThis should not happen if validateAndFetchApiKeys() was called. Please restart the service.`);
+	switch (model.provider) {
+		case "groq": return createGroq({ apiKey })(model.name);
+		case "google": return createGoogleGenerativeAI({ apiKey })(model.name);
+		case "openrouter": return createOpenRouter({ apiKey })(model.name);
+		case "ollama": return ollama(model.name);
+		case "mistral": return createMistral({ apiKey })(model.name);
+		default: throw new Error(`⚠️  Provider "${model.provider}" is not implemented`);
+	}
+}
+
+//#endregion
+export { createAiModel, getLocaleModel, parseModelString, validateAndGetApiKeys };
+//# sourceMappingURL=model-factory.mjs.map

package/build/translators/lingo/model-factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-factory.mjs","names":["path","providerDetails: Record<string, ProviderConfig>","keys: ValidatedApiKeys","missingKeys: Array<{ provider: string; envVar: string }>","providersToValidate: string[]"],"sources":["../../../src/translators/lingo/model-factory.ts"],"sourcesContent":["/**\n * Shared utilities for creating AI model instances\n */\n\nimport { createGroq } from \"@ai-sdk/groq\";\nimport { createGoogleGenerativeAI } from \"@ai-sdk/google\";\nimport { createOpenRouter } from \"@openrouter/ai-sdk-provider\";\nimport { ollama } from \"ai-sdk-ollama\";\nimport { createMistral } from \"@ai-sdk/mistral\";\nimport type { LanguageModel } from \"ai\";\nimport * as dotenv from \"dotenv\";\nimport * as path from \"path\";\n\nexport type LocaleModel = {\n  provider: string;\n  name: string;\n};\n\nexport function getKeyFromEnv(envVarName: string): string | undefined {\n  if (process.env[envVarName]) {\n    return process.env[envVarName];\n  }\n\n  const projectRoot = process.cwd();\n\n  const result = dotenv.config({\n    path: [\n      path.resolve(projectRoot, \".env\"),\n      path.resolve(projectRoot, \".env.local\"),\n      path.resolve(projectRoot, \".env.development\"),\n    ],\n  });\n\n  return result?.parsed?.[envVarName];\n}\n\n/**\n * Pre-validated API keys for all providers\n * Keys are fetched and validated once at initialization\n */\nexport type ValidatedApiKeys = Record<string, string>;\n\n/**\n * Provider configuration including env var names and requirements\n */\ntype ProviderConfig = {\n  name: string; // Display name (e.g., \"Groq\", \"Google\")\n  apiKeyEnvVar?: string; // Environment variable name (e.g., \"GROQ_API_KEY\")\n  apiKeyConfigKey?: string; // Config key if applicable (e.g., \"llm.groqApiKey\")\n  getKeyLink: string; // Link to get API key\n  docsLink: string; // Link to API docs for troubleshooting\n};\n\nexport const providerDetails: Record<string, ProviderConfig> = {\n  groq: {\n    name: \"Groq\",\n    apiKeyEnvVar: \"GROQ_API_KEY\",\n    apiKeyConfigKey: \"llm.groqApiKey\",\n    getKeyLink: \"https://groq.com\",\n    docsLink: \"https://console.groq.com/docs/errors\",\n  },\n  google: {\n    name: \"Google\",\n    apiKeyEnvVar: \"GOOGLE_API_KEY\",\n    apiKeyConfigKey: \"llm.googleApiKey\",\n    getKeyLink: \"https://ai.google.dev/\",\n    docsLink: \"https://ai.google.dev/gemini-api/docs/troubleshooting\",\n  },\n  openai: {\n    name: \"OpenAI\",\n    apiKeyEnvVar: \"OPENAI_API_KEY\",\n    apiKeyConfigKey: \"llm.openaiApiKey\",\n    getKeyLink: \"https://platform.openai.com/account/api-keys\",\n    docsLink: \"https://platform.openai.com/docs\",\n  },\n  anthropic: {\n    name: \"Anthropic\",\n    apiKeyEnvVar: \"ANTHROPIC_API_KEY\",\n    apiKeyConfigKey: \"llm.anthropicApiKey\",\n    getKeyLink: \"https://console.anthropic.com/get-api-key\",\n    docsLink: \"https://console.anthropic.com/docs\",\n  },\n  openrouter: {\n    name: \"OpenRouter\",\n    apiKeyEnvVar: \"OPENROUTER_API_KEY\",\n    apiKeyConfigKey: \"llm.openrouterApiKey\",\n    getKeyLink: \"https://openrouter.ai\",\n    docsLink: \"https://openrouter.ai/docs\",\n  },\n  ollama: {\n    name: \"Ollama\",\n    apiKeyEnvVar: undefined, // Ollama doesn't require an API key\n    apiKeyConfigKey: undefined, // Ollama doesn't require an API key\n    getKeyLink: \"https://ollama.com/download\",\n    docsLink: \"https://github.com/ollama/ollama/tree/main/docs\",\n  },\n  mistral: {\n    name: \"Mistral\",\n    apiKeyEnvVar: \"MISTRAL_API_KEY\",\n    apiKeyConfigKey: \"llm.mistralApiKey\",\n    getKeyLink: \"https://console.mistral.ai\",\n    docsLink: \"https://docs.mistral.ai\",\n  },\n  \"lingo.dev\": {\n    name: \"Lingo.dev\",\n    apiKeyEnvVar: \"LINGODOTDEV_API_KEY\",\n    apiKeyConfigKey: \"auth.apiKey\",\n    getKeyLink: \"https://lingo.dev\",\n    docsLink: \"https://lingo.dev/docs\",\n  },\n};\n\n/**\n * Get provider and model for a specific locale pair\n */\nexport function getLocaleModel(\n  localeModels: Record<string, string>,\n  sourceLocale: string,\n  targetLocale: string,\n): LocaleModel | undefined {\n  const localeKeys = [\n    `${sourceLocale}:${targetLocale}`,\n    `*:${targetLocale}`,\n    `${sourceLocale}:*`,\n    \"*:*\",\n  ];\n\n  const modelKey = localeKeys.find((key) => key in localeModels);\n  if (!modelKey) {\n    return undefined;\n  }\n\n  const value = localeModels[modelKey];\n  if (!value) {\n    return undefined;\n  }\n\n  return parseModelString(value);\n}\n\n/**\n * Parse provider and model from model string\n * Format: \"provider:model\" (e.g., \"groq:llama3-8b-8192\")\n *\n * @param modelString Model string to parse\n * @returns Object with provider and model\n * @throws Error if format is invalid\n */\nexport function parseModelString(modelString: string): LocaleModel | undefined {\n  // Split on first colon only\n  const [provider, name] = modelString.split(\":\", 2);\n\n  if (!provider || !name) {\n    return undefined;\n  }\n\n  return { provider, name };\n}\n\n/**\n * Validate and fetch all necessary API keys for the given configuration\n * This should be called once at initialization time\n *\n * @param config Model configuration (\"lingo.dev\" or locale-pair mapping)\n * @returns Validated API keys (provider ID -> API key)\n * @throws Error if required keys are missing\n */\nexport function validateAndGetApiKeys(\n  config: \"lingo.dev\" | Record<string, string>,\n): ValidatedApiKeys {\n  const keys: ValidatedApiKeys = {};\n  const missingKeys: Array<{ provider: string; envVar: string }> = [];\n\n  // Determine which providers are configured\n  let providersToValidate: string[];\n\n  if (config === \"lingo.dev\") {\n    // Only need lingo.dev provider\n    providersToValidate = [\"lingo.dev\"];\n  } else {\n    // Extract unique providers from model strings\n    const providerSet = new Set<string>();\n    Object.values(config).forEach((modelString) => {\n      const model = parseModelString(modelString);\n      if (model) {\n        providerSet.add(model.provider);\n      }\n    });\n    providersToValidate = Array.from(providerSet);\n  }\n\n  // Validate and fetch keys for each provider\n  for (const provider of providersToValidate) {\n    const providerConfig = providerDetails[provider];\n\n    if (!providerConfig) {\n      throw new Error(\n        `⚠️  Unknown provider \"${provider}\". Supported providers: ${Object.keys(providerDetails).join(\", \")}`,\n      );\n    }\n\n    // Skip providers that don't require keys (like Ollama)\n    if (!providerConfig.apiKeyEnvVar) {\n      continue;\n    }\n\n    const key = getKeyFromEnv(providerConfig.apiKeyEnvVar);\n    if (key) {\n      keys[provider] = key;\n    } else {\n      missingKeys.push({\n        provider: providerConfig.name,\n        envVar: providerConfig.apiKeyEnvVar,\n      });\n    }\n  }\n\n  // If any keys are missing, throw with detailed error\n  if (missingKeys.length > 0) {\n    const errorLines = missingKeys.map(\n      ({ provider, envVar }) => `  - ${provider}: ${envVar}`,\n    );\n    throw new Error(\n      `⚠️  Missing API keys for configured providers:\\n${errorLines.join(\"\\n\")}\\n\\nPlease set the required environment variables.`,\n    );\n  }\n\n  return keys;\n}\n\n/**\n * Create AI model instance from provider and model ID\n *\n * @param model Provider name (groq, google, openrouter, ollama, mistral) and model identifier\n * @param validatedKeys Pre-validated API keys from validateAndFetchApiKeys()\n * @returns LanguageModel instance\n * @throws Error if provider is not supported or API key is missing\n */\nexport function createAiModel(\n  model: LocaleModel,\n  validatedKeys: ValidatedApiKeys,\n): LanguageModel {\n  const providerConfig = providerDetails[model.provider];\n\n  if (!providerConfig) {\n    throw new Error(\n      `⚠️  Provider \"${model.provider}\" is not supported. Supported providers: ${Object.keys(providerDetails).join(\", \")}`,\n    );\n  }\n\n  // Get API key if required\n  const apiKey = providerConfig.apiKeyEnvVar\n    ? validatedKeys[model.provider]\n    : undefined;\n\n  // Verify key is present for providers that require it\n  if (providerConfig.apiKeyEnvVar && !apiKey) {\n    throw new Error(\n      `⚠️  ${providerConfig.name} API key not found. Please set ${providerConfig.apiKeyEnvVar} environment variable.\\n\\n` +\n        `This should not happen if validateAndFetchApiKeys() was called. Please restart the service.`,\n    );\n  }\n\n  // Create the appropriate model instance\n  switch (model.provider) {\n    case \"groq\":\n      return createGroq({ apiKey: apiKey! })(model.name);\n\n    case \"google\":\n      return createGoogleGenerativeAI({ apiKey: apiKey! })(model.name);\n\n    case \"openrouter\":\n      return createOpenRouter({ apiKey: apiKey! })(model.name);\n\n    case \"ollama\":\n      return ollama(model.name);\n\n    case \"mistral\":\n      return createMistral({ apiKey: apiKey! })(model.name);\n\n    default:\n      // This should be unreachable due to check above\n      throw new Error(`⚠️  Provider \"${model.provider}\" is not implemented`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAkBA,SAAgB,cAAc,YAAwC;AACpE,KAAI,QAAQ,IAAI,YACd,QAAO,QAAQ,IAAI;CAGrB,MAAM,cAAc,QAAQ,KAAK;AAUjC,QARe,OAAO,OAAO,EAC3B,MAAM;EACJA,OAAK,QAAQ,aAAa,OAAO;EACjCA,OAAK,QAAQ,aAAa,aAAa;EACvCA,OAAK,QAAQ,aAAa,mBAAmB;EAC9C,EACF,CAAC,EAEa,SAAS;;AAoB1B,MAAaC,kBAAkD;CAC7D,MAAM;EACJ,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACD,QAAQ;EACN,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACD,QAAQ;EACN,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACD,WAAW;EACT,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACD,YAAY;EACV,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACD,QAAQ;EACN,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACD,SAAS;EACP,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACD,aAAa;EACX,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACF;;;;AAKD,SAAgB,eACd,cACA,cACA,cACyB;CAQzB,MAAM,WAPa;EACjB,GAAG,aAAa,GAAG;EACnB,KAAK;EACL,GAAG,aAAa;EAChB;EACD,CAE2B,MAAM,QAAQ,OAAO,aAAa;AAC9D,KAAI,CAAC,SACH;CAGF,MAAM,QAAQ,aAAa;AAC3B,KAAI,CAAC,MACH;AAGF,QAAO,iBAAiB,MAAM;;;;;;;;;;AAWhC,SAAgB,iBAAiB,aAA8C;CAE7E,MAAM,CAAC,UAAU,QAAQ,YAAY,MAAM,KAAK,EAAE;AAElD,KAAI,CAAC,YAAY,CAAC,KAChB;AAGF,QAAO;EAAE;EAAU;EAAM;;;;;;;;;;AAW3B,SAAgB,sBACd,QACkB;CAClB,MAAMC,OAAyB,EAAE;CACjC,MAAMC,cAA2D,EAAE;CAGnE,IAAIC;AAEJ,KAAI,WAAW,YAEb,uBAAsB,CAAC,YAAY;MAC9B;EAEL,MAAM,8BAAc,IAAI,KAAa;AACrC,SAAO,OAAO,OAAO,CAAC,SAAS,gBAAgB;GAC7C,MAAM,QAAQ,iBAAiB,YAAY;AAC3C,OAAI,MACF,aAAY,IAAI,MAAM,SAAS;IAEjC;AACF,wBAAsB,MAAM,KAAK,YAAY;;AAI/C,MAAK,MAAM,YAAY,qBAAqB;EAC1C,MAAM,iBAAiB,gBAAgB;AAEvC,MAAI,CAAC,eACH,OAAM,IAAI,MACR,yBAAyB,SAAS,0BAA0B,OAAO,KAAK,gBAAgB,CAAC,KAAK,KAAK,GACpG;AAIH,MAAI,CAAC,eAAe,aAClB;EAGF,MAAM,MAAM,cAAc,eAAe,aAAa;AACtD,MAAI,IACF,MAAK,YAAY;MAEjB,aAAY,KAAK;GACf,UAAU,eAAe;GACzB,QAAQ,eAAe;GACxB,CAAC;;AAKN,KAAI,YAAY,SAAS,GAAG;EAC1B,MAAM,aAAa,YAAY,KAC5B,EAAE,UAAU,aAAa,OAAO,SAAS,IAAI,SAC/C;AACD,QAAM,IAAI,MACR,mDAAmD,WAAW,KAAK,KAAK,CAAC,oDAC1E;;AAGH,QAAO;;;;;;;;;;AAWT,SAAgB,cACd,OACA,eACe;CACf,MAAM,iBAAiB,gBAAgB,MAAM;AAE7C,KAAI,CAAC,eACH,OAAM,IAAI,MACR,iBAAiB,MAAM,SAAS,2CAA2C,OAAO,KAAK,gBAAgB,CAAC,KAAK,KAAK,GACnH;CAIH,MAAM,SAAS,eAAe,eAC1B,cAAc,MAAM,YACpB;AAGJ,KAAI,eAAe,gBAAgB,CAAC,OAClC,OAAM,IAAI,MACR,OAAO,eAAe,KAAK,iCAAiC,eAAe,aAAa,uHAEzF;AAIH,SAAQ,MAAM,UAAd;EACE,KAAK,OACH,QAAO,WAAW,EAAU,QAAS,CAAC,CAAC,MAAM,KAAK;EAEpD,KAAK,SACH,QAAO,yBAAyB,EAAU,QAAS,CAAC,CAAC,MAAM,KAAK;EAElE,KAAK,aACH,QAAO,iBAAiB,EAAU,QAAS,CAAC,CAAC,MAAM,KAAK;EAE1D,KAAK,SACH,QAAO,OAAO,MAAM,KAAK;EAE3B,KAAK,UACH,QAAO,cAAc,EAAU,QAAS,CAAC,CAAC,MAAM,KAAK;EAEvD,QAEE,OAAM,IAAI,MAAM,iBAAiB,MAAM,SAAS,sBAAsB"}

package/build/translators/lingo/prompt.cjs

@@ -0,0 +1,43 @@
+
+//#region src/translators/lingo/prompt.ts
+function getSystemPrompt(args) {
+	if (args.prompt?.trim()) return args.prompt.trim().replace("{SOURCE_LOCALE}", args.sourceLocale).replace("{TARGET_LOCALE}", args.targetLocale);
+	return `
+# Identity
+
+You are an advanced AI localization engine. You do state-of-the-art localization for software products.
+Your task is to localize pieces of data from one locale to another locale.
+You always consider context, cultural nuances of source and target locales, and specific localization requirements.
+You replicate the meaning, intent, style, tone, and purpose of the original data.
+
+## Setup
+
+Source language (locale code): ${args.sourceLocale}
+Target language (locale code): ${args.targetLocale}
+
+## Guidelines
+
+Follow these guidelines for translation:
+
+1. Analyze the source text to understand its overall context and purpose
+2. Translate the meaning and intent rather than word-for-word translation
+3. Rephrase and restructure sentences to sound natural and fluent in the target language
+4. Adapt idiomatic expressions and cultural references for the target audience
+5. Maintain the style and tone of the source text
+6. You must produce valid UTF-8 encoded output
+7. YOU MUST ONLY PRODUCE VALID XML.
+
+## Special Instructions
+
+Do not localize any of these technical elements:
+- Variables like {variable}, {variable.key}, {data[type]}
+- Expressions like <expression/>
+- Elements like <strong0>, </strong0>, <CustomComponent0>, </CustomComponent0>, <CustomComponent1 />, <br3 />
+
+Remember, you are a context-aware multilingual assistant helping international companies.
+Your goal is to perform state-of-the-art localization for software products and content.
+`;
+}
+
+//#endregion
+exports.getSystemPrompt = getSystemPrompt;

package/build/translators/lingo/prompt.mjs

@@ -0,0 +1,43 @@
+//#region src/translators/lingo/prompt.ts
+function getSystemPrompt(args) {
+	if (args.prompt?.trim()) return args.prompt.trim().replace("{SOURCE_LOCALE}", args.sourceLocale).replace("{TARGET_LOCALE}", args.targetLocale);
+	return `
+# Identity
+
+You are an advanced AI localization engine. You do state-of-the-art localization for software products.
+Your task is to localize pieces of data from one locale to another locale.
+You always consider context, cultural nuances of source and target locales, and specific localization requirements.
+You replicate the meaning, intent, style, tone, and purpose of the original data.
+
+## Setup
+
+Source language (locale code): ${args.sourceLocale}
+Target language (locale code): ${args.targetLocale}
+
+## Guidelines
+
+Follow these guidelines for translation:
+
+1. Analyze the source text to understand its overall context and purpose
+2. Translate the meaning and intent rather than word-for-word translation
+3. Rephrase and restructure sentences to sound natural and fluent in the target language
+4. Adapt idiomatic expressions and cultural references for the target audience
+5. Maintain the style and tone of the source text
+6. You must produce valid UTF-8 encoded output
+7. YOU MUST ONLY PRODUCE VALID XML.
+
+## Special Instructions
+
+Do not localize any of these technical elements:
+- Variables like {variable}, {variable.key}, {data[type]}
+- Expressions like <expression/>
+- Elements like <strong0>, </strong0>, <CustomComponent0>, </CustomComponent0>, <CustomComponent1 />, <br3 />
+
+Remember, you are a context-aware multilingual assistant helping international companies.
+Your goal is to perform state-of-the-art localization for software products and content.
+`;
+}
+
+//#endregion
+export { getSystemPrompt };
+//# sourceMappingURL=prompt.mjs.map

package/build/translators/lingo/prompt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.mjs","names":[],"sources":["../../../src/translators/lingo/prompt.ts"],"sourcesContent":["interface PromptArguments {\n  sourceLocale: string;\n  targetLocale: string;\n  prompt?: string;\n}\n\nexport function getSystemPrompt(args: PromptArguments): string {\n  // If user provided custom prompt, use it\n  if (args.prompt?.trim()) {\n    return args.prompt\n      .trim()\n      .replace(\"{SOURCE_LOCALE}\", args.sourceLocale)\n      .replace(\"{TARGET_LOCALE}\", args.targetLocale);\n  }\n\n  // Otherwise use built-in prompt\n  return `\n# Identity\n\nYou are an advanced AI localization engine. You do state-of-the-art localization for software products.\nYour task is to localize pieces of data from one locale to another locale.\nYou always consider context, cultural nuances of source and target locales, and specific localization requirements.\nYou replicate the meaning, intent, style, tone, and purpose of the original data.\n\n## Setup\n\nSource language (locale code): ${args.sourceLocale}\nTarget language (locale code): ${args.targetLocale}\n\n## Guidelines\n\nFollow these guidelines for translation:\n\n1. Analyze the source text to understand its overall context and purpose\n2. Translate the meaning and intent rather than word-for-word translation\n3. Rephrase and restructure sentences to sound natural and fluent in the target language\n4. Adapt idiomatic expressions and cultural references for the target audience\n5. Maintain the style and tone of the source text\n6. You must produce valid UTF-8 encoded output\n7. YOU MUST ONLY PRODUCE VALID XML.\n\n## Special Instructions\n\nDo not localize any of these technical elements:\n- Variables like {variable}, {variable.key}, {data[type]}\n- Expressions like <expression/>\n- Elements like <strong0>, </strong0>, <CustomComponent0>, </CustomComponent0>, <CustomComponent1 />, <br3 />\n\nRemember, you are a context-aware multilingual assistant helping international companies.\nYour goal is to perform state-of-the-art localization for software products and content.\n`;\n}\n"],"mappings":";AAMA,SAAgB,gBAAgB,MAA+B;AAE7D,KAAI,KAAK,QAAQ,MAAM,CACrB,QAAO,KAAK,OACT,MAAM,CACN,QAAQ,mBAAmB,KAAK,aAAa,CAC7C,QAAQ,mBAAmB,KAAK,aAAa;AAIlD,QAAO;;;;;;;;;;iCAUwB,KAAK,aAAa;iCAClB,KAAK,aAAa"}