@the-i18n-kit/cli 4.9.0

package/dist/php-reader-DcgOAhTw.js

@@ -0,0 +1,2 @@
+import { n as readPhpLocaleFile } from "./php-reader-DuZ0Hyl_.js";
+export { readPhpLocaleFile };

package/dist/php-reader-DuZ0Hyl_.js

@@ -0,0 +1,32 @@
+import { i as toErrorMessage, n as FileIOError } from "./errors-coI1dhw1.js";
+import { existsSync } from "node:fs";
+import { readFile, stat } from "node:fs/promises";
+import { fromString } from "php-array-reader";
+//#region src/io/php-reader.ts
+const fileCache = /* @__PURE__ */ new Map();
+function clearPhpFileCacheEntry(filePath) {
+	fileCache.delete(filePath);
+}
+async function readPhpLocaleFile(filePath) {
+	if (!existsSync(filePath)) throw new FileIOError(`File not found: ${filePath}`, filePath, "FILE_NOT_FOUND");
+	try {
+		const mtime = (await stat(filePath)).mtimeMs;
+		const cached = fileCache.get(filePath);
+		if (cached && cached.mtime === mtime) return structuredClone(cached.data);
+		const parsed = fromString(await readFile(filePath, "utf-8"));
+		if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) throw new FileIOError(`PHP locale file did not return an associative array: ${filePath}`, filePath);
+		const data = parsed;
+		fileCache.set(filePath, {
+			data: structuredClone(data),
+			mtime
+		});
+		return data;
+	} catch (error) {
+		if (error instanceof FileIOError) throw error;
+		throw new FileIOError(`Failed to read PHP locale file: ${filePath}: ${toErrorMessage(error)}`, filePath);
+	}
+}
+//#endregion
+export { readPhpLocaleFile as n, clearPhpFileCacheEntry as t };
+
+//# sourceMappingURL=php-reader-DuZ0Hyl_.js.map

package/dist/php-reader-DuZ0Hyl_.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"php-reader-DuZ0Hyl_.js","names":[],"sources":["../src/io/php-reader.ts"],"sourcesContent":["import { readFile, stat } from 'node:fs/promises'\nimport { existsSync } from 'node:fs'\nimport { fromString } from 'php-array-reader'\nimport { FileIOError, toErrorMessage } from '../utils/errors'\n\nconst fileCache = new Map<string, { data: Record<string, unknown>; mtime: number }>()\n\nexport function clearPhpFileCache(): void {\n  fileCache.clear()\n}\n\nexport function clearPhpFileCacheEntry(filePath: string): void {\n  fileCache.delete(filePath)\n}\n\nexport async function readPhpLocaleFile(filePath: string): Promise<Record<string, unknown>> {\n  if (!existsSync(filePath)) {\n    throw new FileIOError(`File not found: ${filePath}`, filePath, 'FILE_NOT_FOUND')\n  }\n\n  try {\n    const fileStat = await stat(filePath)\n    const mtime = fileStat.mtimeMs\n\n    const cached = fileCache.get(filePath)\n    if (cached && cached.mtime === mtime) {\n      return structuredClone(cached.data)\n    }\n\n    const content = await readFile(filePath, 'utf-8')\n    const parsed = fromString(content)\n\n    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {\n      throw new FileIOError(\n        `PHP locale file did not return an associative array: ${filePath}`,\n        filePath,\n      )\n    }\n\n    const data = parsed as Record<string, unknown>\n    fileCache.set(filePath, { data: structuredClone(data), mtime })\n    return data\n  }\n  catch (error) {\n    if (error instanceof FileIOError) throw error\n    throw new FileIOError(\n      `Failed to read PHP locale file: ${filePath}: ${toErrorMessage(error)}`,\n      filePath,\n    )\n  }\n}\n"],"mappings":";;;;;AAKA,MAAM,4BAAY,IAAI,KAA+D;AAMrF,SAAgB,uBAAuB,UAAwB;AAC7D,WAAU,OAAO,SAAS;;AAG5B,eAAsB,kBAAkB,UAAoD;AAC1F,KAAI,CAAC,WAAW,SAAS,CACvB,OAAM,IAAI,YAAY,mBAAmB,YAAY,UAAU,iBAAiB;AAGlF,KAAI;EAEF,MAAM,SADW,MAAM,KAAK,SAAS,EACd;EAEvB,MAAM,SAAS,UAAU,IAAI,SAAS;AACtC,MAAI,UAAU,OAAO,UAAU,MAC7B,QAAO,gBAAgB,OAAO,KAAK;EAIrC,MAAM,SAAS,WADC,MAAM,SAAS,UAAU,QAAQ,CACf;AAElC,MAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,MAAM,QAAQ,OAAO,CACxE,OAAM,IAAI,YACR,wDAAwD,YACxD,SACD;EAGH,MAAM,OAAO;AACb,YAAU,IAAI,UAAU;GAAE,MAAM,gBAAgB,KAAK;GAAE;GAAO,CAAC;AAC/D,SAAO;UAEF,OAAO;AACZ,MAAI,iBAAiB,YAAa,OAAM;AACxC,QAAM,IAAI,YACR,mCAAmC,SAAS,IAAI,eAAe,MAAM,IACrE,SACD"}

package/dist/providers-BAwPjeCy.js

@@ -0,0 +1,482 @@
+import { i as toErrorMessage, t as ConfigError } from "./errors-coI1dhw1.js";
+import { dirname, join, resolve } from "node:path";
+import { createConsola } from "consola";
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { z } from "zod";
+import { fileURLToPath } from "node:url";
+//#region src/utils/logger.ts
+const log = createConsola({
+	stdout: process.stderr,
+	stderr: process.stderr
+}).withTag("the-i18n-cli");
+//#endregion
+//#region src/config/schema.ts
+/**
+* The one definition of the declared half of the kit's configuration —
+* everything a human tells the tool, as opposed to what it can see for itself.
+*
+* `.i18n-mcp.json`, `i18n-kit.config.ts` and the `i18nKit` block in
+* `nuxt.config.ts` all accept this same shape, and all validate against this
+* same schema. The `ProjectConfig` interface in `./types.ts` documents it;
+* the guard at the bottom of this file fails the build if the two drift.
+*/
+const nonEmptyString = z.string().min(1).refine((s) => s.trim().length > 0, "Must not be empty or whitespace-only");
+const layerRuleSchema = z.object({
+	layer: z.string(),
+	description: z.string(),
+	when: z.string()
+});
+const localeDirEntrySchema = z.union([nonEmptyString, z.object({
+	path: nonEmptyString,
+	layer: nonEmptyString
+})]);
+const projectConfigSchema = z.object({
+	$schema: z.string().optional(),
+	framework: z.string().optional(),
+	context: z.string().optional(),
+	layerRules: z.array(layerRuleSchema).optional(),
+	glossary: z.record(z.string(), z.string()).optional(),
+	translationPrompt: z.string().optional(),
+	localeNotes: z.record(z.string(), z.string()).optional(),
+	examples: z.array(z.record(z.string(), z.string())).optional(),
+	orphanScan: z.record(z.string(), z.object({ ignorePatterns: z.array(z.string()).optional() }).passthrough()).optional(),
+	localeDirs: z.array(localeDirEntrySchema).optional(),
+	defaultLocale: nonEmptyString.optional(),
+	locales: z.array(nonEmptyString).optional(),
+	protectedLocales: z.array(nonEmptyString).optional(),
+	reportOutput: z.union([z.literal(true), nonEmptyString]).optional(),
+	localeFileFormat: z.enum(["json", "php-array"]).optional(),
+	providerBaseUrl: nonEmptyString.optional(),
+	samplingPreferences: z.unknown().optional()
+}).strict();
+/**
+* Validate a candidate project config against the published schema, returning
+* the formatted issue list rather than throwing. `init` uses this to refuse to
+* emit a config the tool would then reject; the loaders turn the same failure
+* into a ConfigError naming the file it came from.
+*/
+function validateProjectConfig(value) {
+	const result = projectConfigSchema.safeParse(value);
+	if (result.success) return {
+		ok: true,
+		data: result.data
+	};
+	return {
+		ok: false,
+		error: result.error.issues.map((issue) => {
+			return `  ${issue.path.length > 0 ? issue.path.join(".") : "(root)"}: ${issue.message}`;
+		}).join("\n")
+	};
+}
+/**
+* Strip the deprecated keys the schema still accepts, warning once, so that a
+* config keeps validating without the value going on to mean anything. Applied
+* by every loader — a key ignored in `.i18n-mcp.json` but silently honoured in
+* `i18n-kit.config.ts` would be exactly the divergence this file exists to
+* prevent.
+*/
+function dropDeprecatedKeys(config, source) {
+	const data = config;
+	if ("samplingPreferences" in data) {
+		log.warn(`${source}: "samplingPreferences" is deprecated and ignored — MCP sampling was removed. Configure a provider (e.g. I18N_PROVIDER/I18N_MODEL) instead.`);
+		delete data.samplingPreferences;
+	}
+	return data;
+}
+//#endregion
+//#region src/config/typed-config.ts
+/**
+* Loading `i18n-kit.config.ts` — the same configuration `.i18n-mcp.json`
+* carries, written in TypeScript so the editor checks it.
+*
+* Read with no build step, which is the whole point: a `protectedLocales` entry
+* that only takes effect once something has been built is a locale that quietly
+* goes unprotected in a fresh checkout. Everything here runs off the source
+* file as it sits on disk.
+*/
+/**
+* Candidate names, in the order a directory is searched. `.ts` first because
+* it is the one worth having; the rest exist so a JavaScript project is not
+* told to adopt TypeScript to get a typed config.
+*/
+const TYPED_CONFIG_FILENAMES = [
+	"i18n-kit.config.ts",
+	"i18n-kit.config.mts",
+	"i18n-kit.config.js",
+	"i18n-kit.config.mjs",
+	"i18n-kit.config.cjs",
+	"i18n-kit.config.cts"
+];
+/**
+* Walk up from `startDir` for the nearest `i18n-kit.config.*`, the same way
+* `findConfigFile` looks for `.i18n-mcp.json`. Both stop at the first
+* directory that has one, so a config in an app directory shadows one in the
+* repository root rather than merging with it.
+*/
+function findTypedConfigFile(startDir) {
+	let dir = resolve(startDir);
+	while (true) {
+		const found = TYPED_CONFIG_FILENAMES.map((name) => join(dir, name)).filter((path) => existsSync(path));
+		if (found[0]) {
+			if (found.length > 1) log.warn(`Several i18n-kit configs in ${dir} (${found.map((p) => p.slice(dir.length + 1)).join(", ")}). Using ${found[0].slice(dir.length + 1)} — delete the others, they are being ignored.`);
+			return found[0];
+		}
+		const parent = dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+}
+/**
+* Load and validate the nearest typed config, or null when there isn't one.
+*
+* Throws, unlike the framework-config readers this issue also adds. Those read
+* a file someone wrote for another tool, so failing to read it means falling
+* back to a guess. This file exists only for the kit: if it throws, or declares
+* a key that does not exist, carrying on without it is precisely the silent
+* non-application the typed config was added to prevent.
+*/
+async function loadTypedConfig(projectDir) {
+	const path = findTypedConfigFile(projectDir);
+	if (!path) {
+		log.debug(`No i18n-kit.config.* found in ${projectDir} or any parent directory — skipping`);
+		return null;
+	}
+	log.info(`Found typed project config: ${path}`);
+	let module;
+	try {
+		const { createJiti } = await import("jiti");
+		module = await createJiti(import.meta.url, {
+			interopDefault: false,
+			alias: selfAlias()
+		}).import(path);
+	} catch (error) {
+		throw new ConfigError(`Failed to load ${path}: ${toErrorMessage(error)}`);
+	}
+	if (module === null || typeof module !== "object") throw new ConfigError(`${path} must export its config as the default export — write \`export default defineI18nKitConfig({ ... })\`.`);
+	const commonJs = path.endsWith(".cts") || path.endsWith(".cjs");
+	if (!("default" in module) && !commonJs) throw new ConfigError(`${path} must export its config as the default export — write \`export default defineI18nKitConfig({ ... })\`.`);
+	const exported = "default" in module ? module.default : module;
+	if (exported === null || typeof exported !== "object" || Array.isArray(exported)) throw new ConfigError(`${path} must export a config object as its default export — got ${describe(exported)}. Wrap it in defineI18nKitConfig() from "the-i18n-cli/config".`);
+	const result = validateProjectConfig(exported);
+	if (!result.ok) throw new ConfigError(`Invalid ${path}:\n${result.error}`);
+	return {
+		path,
+		config: dropDeprecatedKeys(result.data, path)
+	};
+}
+/**
+* Point `the-i18n-cli/config` at the copy of `defineI18nKitConfig` that is
+* already running.
+*
+* A config file imports it for the types, and types only need the package
+* installed at author time — but the CLI is often run through `npx` in a
+* project that never added it as a dependency, where a bare import would be
+* unresolvable and take the whole config down with it. Resolving it to
+* ourselves costs nothing and is the same function either way: identity.
+*
+* Returns no alias when the entry cannot be located, which leaves normal
+* resolution to find the installed package.
+*/
+function selfAlias() {
+	for (const candidate of [
+		"./define-config.js",
+		"../define-config.js",
+		"../define-config.ts"
+	]) {
+		const path = fileURLToPath(new URL(candidate, import.meta.url));
+		if (existsSync(path)) return { "the-i18n-cli/config": path };
+	}
+	return {};
+}
+function describe(value) {
+	if (value === null) return "null";
+	if (Array.isArray(value)) return "an array";
+	if (typeof value === "function") return "a function (call defineI18nKitConfig, do not pass it)";
+	return typeof value;
+}
+//#endregion
+//#region src/config/project-config.ts
+const CONFIG_FILENAME = ".i18n-mcp.json";
+/**
+* Walk up the directory tree from `startDir` to find the nearest config file.
+* Returns the full path if found, null otherwise.
+*/
+function findConfigFile(startDir) {
+	let dir = startDir;
+	while (true) {
+		const candidate = join(dir, CONFIG_FILENAME);
+		if (existsSync(candidate)) return candidate;
+		const parent = dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+}
+/**
+* Load the project's declared configuration, from either place it can be
+* declared: `i18n-kit.config.ts` and `.i18n-mcp.json`. Both are searched from
+* projectDir upwards, the way ESLint, Prettier and tsconfig resolve configs.
+*
+* Returns null when neither exists — the case that must keep behaving exactly
+* as it did before there were two. Throws ConfigError when either file is
+* present but unusable, or when the two disagree.
+*
+* Every adapter funnels through here, which is what makes the typed config
+* work for all of them rather than for whichever one was taught about it.
+*/
+async function loadProjectConfig(projectDir) {
+	const [json, typed] = await Promise.all([loadJsonConfig(projectDir), loadTypedConfig(projectDir)]);
+	if (!typed) return json?.config ?? null;
+	if (!json) return typed.config;
+	const conflicts = conflictingKeys(typed.config, json.config);
+	if (conflicts.length > 0) throw new ConfigError(`${conflicts.join(", ")} ${conflicts.length === 1 ? "is" : "are"} declared in both\n  ${typed.path}\n  ${json.path}\nNeither wins — a reader cannot tell which one took effect. Delete the duplicate from one of them.`);
+	return {
+		...json.config,
+		...typed.config
+	};
+}
+/** Keys present in both files, ignoring the JSON-only `$schema`. */
+function conflictingKeys(typed, json) {
+	const a = typed;
+	const b = json;
+	return Object.keys(a).filter((key) => key !== "$schema" && a[key] !== void 0 && b[key] !== void 0);
+}
+/**
+* Load the optional `.i18n-mcp.json`, with the path it was found at.
+* Returns null if no config file is found in any ancestor.
+* Throws ConfigError if a file is found but is invalid.
+*/
+async function loadJsonConfig(projectDir) {
+	log.debug(`Searching for ${CONFIG_FILENAME} starting from: ${projectDir}`);
+	const configPath = findConfigFile(projectDir);
+	if (!configPath) {
+		log.info(`No ${CONFIG_FILENAME} found in ${projectDir} or any parent directory — skipping`);
+		return null;
+	}
+	log.info(`Found project config: ${configPath}`);
+	let raw;
+	try {
+		raw = await readFile(configPath, "utf-8");
+	} catch (error) {
+		throw new ConfigError(`Failed to read ${CONFIG_FILENAME}: ${toErrorMessage(error)}`);
+	}
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch (error) {
+		throw new ConfigError(`Invalid JSON in ${CONFIG_FILENAME}: ${toErrorMessage(error)}`);
+	}
+	const result = validateProjectConfig(parsed);
+	if (!result.ok) throw new ConfigError(`Invalid ${CONFIG_FILENAME}:\n${result.error}`);
+	log.debug(`Project config loaded successfully from ${configPath}`);
+	return {
+		path: configPath,
+		config: dropDeprecatedKeys(result.data, CONFIG_FILENAME)
+	};
+}
+//#endregion
+//#region src/llm/providers.ts
+/**
+* A classified provider failure. `auth` errors are not retryable (the caller
+* should abort the run), `rate-limit` errors should be retried with backoff,
+* and `provider` covers everything else (server errors, network, …).
+* `config` marks an unusable provider setup and is raised while building the
+* TranslateFn, before any request exists — so it surfaces from the command
+* and never reaches the retry loop.
+*/
+var TranslateProviderError = class extends Error {
+	kind;
+	status;
+	constructor(message, kind, status) {
+		super(message);
+		this.name = "TranslateProviderError";
+		this.kind = kind;
+		this.status = status;
+	}
+};
+/** Defensively extract an HTTP status code from an unknown SDK error shape. */
+function extractStatus(error) {
+	if (error === null || typeof error !== "object") return void 0;
+	const e = error;
+	if (typeof e.status === "number") return e.status;
+	if (e.response !== null && typeof e.response === "object") {
+		const status = e.response.status;
+		if (typeof status === "number") return status;
+	}
+}
+/**
+* Classify an SDK error into a TranslateProviderError:
+* 401/403 → auth, 429 → rate-limit, anything else → provider.
+* Already-classified errors pass through unchanged.
+*/
+function classifyProviderError(error) {
+	if (error instanceof TranslateProviderError) return error;
+	const status = extractStatus(error);
+	return new TranslateProviderError(error instanceof Error ? error.message : String(error), status === 401 || status === 403 ? "auth" : status === 429 ? "rate-limit" : "provider", status);
+}
+/** Environment variable carrying the provider base URL override. */
+const BASE_URL_ENV = "I18N_BASE_URL";
+/**
+* Resolve the provider base URL from its three sources, highest precedence
+* first: an explicit flag, the I18N_BASE_URL env var, then the project
+* config's `providerBaseUrl`.
+*
+* Blank values count as unset. Shells produce them routinely — `--baseUrl
+* "$UNSET"` or an exported-but-empty variable — and a blank must not shadow a
+* real endpoint configured further down the chain. A blank in the config file
+* is a different case: it cannot arise by accident, so the strict schema
+* rejects it at load time rather than letting it reach this function.
+*/
+function resolveProviderBaseUrl(sources) {
+	for (const value of [
+		sources.flag,
+		sources.env,
+		sources.config
+	]) if (typeof value === "string" && value.trim().length > 0) return value.trim();
+}
+const ENV_KEY_MAP = {
+	openai: "OPENAI_API_KEY",
+	anthropic: "ANTHROPIC_API_KEY",
+	google: "GEMINI_API_KEY"
+};
+function resolveApiKey(provider, configKey) {
+	if (configKey) return configKey;
+	const envKey = ENV_KEY_MAP[provider];
+	const key = process.env[envKey];
+	if (!key) throw new Error(`No API key found for provider "${provider}". Set ${envKey} environment variable or pass apiKey in config.`);
+	return key;
+}
+async function createOpenAiTranslateFn(config) {
+	let OpenAI;
+	try {
+		OpenAI = (await import("openai")).default;
+	} catch {
+		throw new Error("Provider \"openai\" requires the \"openai\" package. Install it with:\n  npm install openai\n  pnpm add openai\n  yarn add openai");
+	}
+	const apiKey = resolveApiKey("openai", config.apiKey);
+	const client = new OpenAI({
+		apiKey,
+		baseURL: config.baseUrl
+	});
+	return async (opts) => {
+		let response;
+		try {
+			response = await client.chat.completions.create({
+				model: config.model,
+				messages: [{
+					role: "system",
+					content: opts.systemPrompt
+				}, {
+					role: "user",
+					content: opts.userMessage
+				}],
+				max_tokens: opts.maxTokens,
+				temperature: 0,
+				response_format: { type: "json_object" }
+			});
+		} catch (error) {
+			throw classifyProviderError(error);
+		}
+		const choice = response.choices?.[0];
+		const text = choice?.message?.content ?? "";
+		const truncated = choice?.finish_reason === "length";
+		return {
+			text,
+			model: response.model || config.model,
+			...truncated ? { truncated: true } : {}
+		};
+	};
+}
+async function createGoogleTranslateFn(config) {
+	let GoogleGenAI;
+	try {
+		GoogleGenAI = (await import("@google/genai")).GoogleGenAI;
+	} catch {
+		throw new Error("Provider \"google\" requires the \"@google/genai\" package. Install it with:\n  npm install @google/genai\n  pnpm add @google/genai\n  yarn add @google/genai");
+	}
+	const apiKey = resolveApiKey("google", config.apiKey);
+	const client = new GoogleGenAI({ apiKey });
+	return async (opts) => {
+		let response;
+		try {
+			response = await client.models.generateContent({
+				model: config.model,
+				contents: opts.userMessage,
+				config: {
+					systemInstruction: opts.systemPrompt,
+					maxOutputTokens: opts.maxTokens,
+					temperature: 0,
+					responseMimeType: "application/json"
+				}
+			});
+		} catch (error) {
+			throw classifyProviderError(error);
+		}
+		const text = response.text ?? "";
+		const truncated = response.candidates?.[0]?.finishReason === "MAX_TOKENS";
+		return {
+			text,
+			model: response.modelVersion || config.model,
+			...truncated ? { truncated: true } : {}
+		};
+	};
+}
+async function createAnthropicTranslateFn(config) {
+	let Anthropic;
+	try {
+		Anthropic = (await import("@anthropic-ai/sdk")).Anthropic;
+	} catch {
+		throw new Error("Provider \"anthropic\" requires the \"@anthropic-ai/sdk\" package. Install it with:\n  npm install @anthropic-ai/sdk\n  pnpm add @anthropic-ai/sdk\n  yarn add @anthropic-ai/sdk");
+	}
+	const apiKey = resolveApiKey("anthropic", config.apiKey);
+	const client = new Anthropic({
+		apiKey,
+		baseURL: config.baseUrl
+	});
+	return async (opts) => {
+		let response;
+		try {
+			response = await client.messages.create({
+				model: config.model,
+				system: opts.systemPrompt,
+				messages: [{
+					role: "user",
+					content: opts.userMessage
+				}],
+				max_tokens: opts.maxTokens,
+				temperature: 0
+			});
+		} catch (error) {
+			throw classifyProviderError(error);
+		}
+		const text = (response.content?.find((block) => block.type === "text"))?.text ?? "";
+		const truncated = response.stop_reason === "max_tokens";
+		return {
+			text,
+			model: response.model || config.model,
+			...truncated ? { truncated: true } : {}
+		};
+	};
+}
+/**
+* Create a TranslateFn from an LLM provider config.
+* Throws if the provider SDK is not installed or API key is missing.
+*/
+async function createTranslateFn(config) {
+	if (config.provider === "google" && config.baseUrl) throw new TranslateProviderError(`Provider "google" does not support a custom base URL. Remove --baseUrl / ${BASE_URL_ENV} / providerBaseUrl, or use an OpenAI-compatible provider.`, "config");
+	switch (config.provider) {
+		case "openai": return createOpenAiTranslateFn(config);
+		case "anthropic": return createAnthropicTranslateFn(config);
+		case "google": return createGoogleTranslateFn(config);
+		default: {
+			const _exhaustive = config.provider;
+			throw new Error(`Unknown provider: ${_exhaustive}`);
+		}
+	}
+}
+//#endregion
+export { resolveProviderBaseUrl as a, validateProjectConfig as c, createTranslateFn as i, log as l, TranslateProviderError as n, CONFIG_FILENAME as o, classifyProviderError as r, loadProjectConfig as s, BASE_URL_ENV as t };
+
+//# sourceMappingURL=providers-BAwPjeCy.js.map

package/dist/providers-BAwPjeCy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers-BAwPjeCy.js","names":[],"sources":["../src/utils/logger.ts","../src/config/schema.ts","../src/config/typed-config.ts","../src/config/project-config.ts","../src/llm/providers.ts"],"sourcesContent":["import { createConsola } from 'consola'\n\n// All diagnostics go to stderr — stdout is reserved for command results so\n// that `the-i18n-cli … | jq` and CI `$(…)` captures always receive pure JSON.\nexport const log = createConsola({\n  stdout: process.stderr,\n  stderr: process.stderr,\n}).withTag('the-i18n-cli')\n","/**\n * The one definition of the declared half of the kit's configuration —\n * everything a human tells the tool, as opposed to what it can see for itself.\n *\n * `.i18n-mcp.json`, `i18n-kit.config.ts` and the `i18nKit` block in\n * `nuxt.config.ts` all accept this same shape, and all validate against this\n * same schema. The `ProjectConfig` interface in `./types.ts` documents it;\n * the guard at the bottom of this file fails the build if the two drift.\n */\nimport { z } from 'zod'\nimport type { ProjectConfig } from './types.js'\nimport { log } from '../utils/logger.js'\n\nconst nonEmptyString = z.string().min(1).refine(s => s.trim().length > 0, 'Must not be empty or whitespace-only')\n\nconst layerRuleSchema = z.object({\n  layer: z.string(),\n  description: z.string(),\n  when: z.string(),\n})\n\nconst localeDirEntrySchema = z.union([\n  nonEmptyString,\n  z.object({\n    path: nonEmptyString,\n    layer: nonEmptyString,\n  }),\n])\n\nconst projectConfigSchema = z.object({\n  $schema: z.string().optional(),\n  framework: z.string().optional(),\n  context: z.string().optional(),\n  layerRules: z.array(layerRuleSchema).optional(),\n  glossary: z.record(z.string(), z.string()).optional(),\n  translationPrompt: z.string().optional(),\n  localeNotes: z.record(z.string(), z.string()).optional(),\n  examples: z.array(z.record(z.string(), z.string())).optional(),\n  orphanScan: z.record(z.string(), z.object({\n    ignorePatterns: z.array(z.string()).optional(),\n  }).passthrough()).optional(), // passthrough for backwards-compat with deprecated keys like includeParentLayer\n  localeDirs: z.array(localeDirEntrySchema).optional(),\n  defaultLocale: nonEmptyString.optional(),\n  locales: z.array(nonEmptyString).optional(),\n  protectedLocales: z.array(nonEmptyString).optional(),\n  reportOutput: z.union([z.literal(true), nonEmptyString]).optional(),\n  localeFileFormat: z.enum(['json', 'php-array']).optional(),\n  providerBaseUrl: nonEmptyString.optional(),\n  // Deprecated with the removal of MCP sampling: accepted so existing config\n  // files keep validating (the schema is strict), warned about, and ignored.\n  samplingPreferences: z.unknown().optional(),\n}).strict()\n\n/**\n * Validate a candidate project config against the published schema, returning\n * the formatted issue list rather than throwing. `init` uses this to refuse to\n * emit a config the tool would then reject; the loaders turn the same failure\n * into a ConfigError naming the file it came from.\n */\nexport function validateProjectConfig(\n  value: unknown,\n): { ok: true, data: ProjectConfig } | { ok: false, error: string } {\n  const result = projectConfigSchema.safeParse(value)\n  if (result.success) return { ok: true, data: result.data as ProjectConfig }\n\n  const error = result.error.issues\n    .map((issue) => {\n      const path = issue.path.length > 0 ? issue.path.join('.') : '(root)'\n      return `  ${path}: ${issue.message}`\n    })\n    .join('\\n')\n  return { ok: false, error }\n}\n\n/**\n * Strip the deprecated keys the schema still accepts, warning once, so that a\n * config keeps validating without the value going on to mean anything. Applied\n * by every loader — a key ignored in `.i18n-mcp.json` but silently honoured in\n * `i18n-kit.config.ts` would be exactly the divergence this file exists to\n * prevent.\n */\nexport function dropDeprecatedKeys(config: ProjectConfig, source: string): ProjectConfig {\n  const data = config as ProjectConfig & { samplingPreferences?: unknown }\n  if ('samplingPreferences' in data) {\n    log.warn(\n      `${source}: \"samplingPreferences\" is deprecated and ignored — `\n      + 'MCP sampling was removed. Configure a provider (e.g. I18N_PROVIDER/I18N_MODEL) instead.',\n    )\n    delete data.samplingPreferences\n  }\n  return data\n}\n\n// ─── Drift guard ────────────────────────────────────────────────\n//\n// A key added to the interface but not the schema is rejected at runtime as an\n// unknown key (the schema is strict) — a typed config that the editor accepts\n// and the CLI refuses. A key added to the schema but not the interface is\n// accepted at runtime and invisible in an editor. Both are the drift this\n// module exists to prevent, so both are a type error here.\n//\n// `$schema` is JSON-only, and `samplingPreferences` is accepted purely so old\n// files keep validating; neither belongs in the documented type.\n\ntype SchemaKey = Exclude<keyof z.infer<typeof projectConfigSchema>, '$schema' | 'samplingPreferences'>\n\n/** Fails to compile unless `T` is `never`, naming the offending key when not. */\ntype NoDrift<T extends never> = T\n\ntype _SchemaCoversType = NoDrift<Exclude<keyof ProjectConfig, SchemaKey>>\ntype _TypeCoversSchema = NoDrift<Exclude<SchemaKey, keyof ProjectConfig>>\n","/**\n * Loading `i18n-kit.config.ts` — the same configuration `.i18n-mcp.json`\n * carries, written in TypeScript so the editor checks it.\n *\n * Read with no build step, which is the whole point: a `protectedLocales` entry\n * that only takes effect once something has been built is a locale that quietly\n * goes unprotected in a fresh checkout. Everything here runs off the source\n * file as it sits on disk.\n */\nimport { existsSync } from 'node:fs'\nimport { dirname, join, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport type { ProjectConfig } from './types.js'\nimport { dropDeprecatedKeys, validateProjectConfig } from './schema.js'\nimport { ConfigError, toErrorMessage } from '../utils/errors.js'\nimport { log } from '../utils/logger.js'\n\n/**\n * Candidate names, in the order a directory is searched. `.ts` first because\n * it is the one worth having; the rest exist so a JavaScript project is not\n * told to adopt TypeScript to get a typed config.\n */\nconst TYPED_CONFIG_FILENAMES = [\n  'i18n-kit.config.ts',\n  'i18n-kit.config.mts',\n  'i18n-kit.config.js',\n  'i18n-kit.config.mjs',\n  'i18n-kit.config.cjs',\n  'i18n-kit.config.cts',\n] as const\n\n/**\n * Walk up from `startDir` for the nearest `i18n-kit.config.*`, the same way\n * `findConfigFile` looks for `.i18n-mcp.json`. Both stop at the first\n * directory that has one, so a config in an app directory shadows one in the\n * repository root rather than merging with it.\n */\nexport function findTypedConfigFile(startDir: string): string | null {\n  // Absolute from the outset: a relative `--projectDir` would otherwise yield\n  // a relative config path, and jiti reads a relative path as a bare module\n  // specifier — resolved against node_modules, where it is never found.\n  let dir = resolve(startDir)\n  while (true) {\n    const found = TYPED_CONFIG_FILENAMES\n      .map(name => join(dir, name))\n      .filter(path => existsSync(path))\n\n    if (found[0]) {\n      if (found.length > 1) {\n        log.warn(\n          `Several i18n-kit configs in ${dir} (${found.map(p => p.slice(dir.length + 1)).join(', ')}). `\n          + `Using ${found[0].slice(dir.length + 1)} — delete the others, they are being ignored.`,\n        )\n      }\n      return found[0]\n    }\n\n    const parent = dirname(dir)\n    if (parent === dir) break // filesystem root\n    dir = parent\n  }\n  return null\n}\n\n/**\n * Load and validate the nearest typed config, or null when there isn't one.\n *\n * Throws, unlike the framework-config readers this issue also adds. Those read\n * a file someone wrote for another tool, so failing to read it means falling\n * back to a guess. This file exists only for the kit: if it throws, or declares\n * a key that does not exist, carrying on without it is precisely the silent\n * non-application the typed config was added to prevent.\n */\nexport async function loadTypedConfig(\n  projectDir: string,\n): Promise<{ path: string, config: ProjectConfig } | null> {\n  const path = findTypedConfigFile(projectDir)\n  if (!path) {\n    log.debug(`No i18n-kit.config.* found in ${projectDir} or any parent directory — skipping`)\n    return null\n  }\n\n  log.info(`Found typed project config: ${path}`)\n\n  let module: unknown\n  try {\n    const { createJiti } = await import('jiti')\n    // interopDefault stays off so that a file with only named exports is\n    // distinguishable from one with a default: with the interop on, the whole\n    // namespace comes back and the schema rejects it as a config full of\n    // unknown keys, which explains nothing.\n    const jiti = createJiti(import.meta.url, {\n      interopDefault: false,\n      alias: selfAlias(),\n    })\n    module = await jiti.import(path)\n  }\n  catch (error) {\n    throw new ConfigError(\n      `Failed to load ${path}: ${toErrorMessage(error)}`,\n    )\n  }\n\n  if (module === null || typeof module !== 'object') {\n    throw new ConfigError(\n      `${path} must export its config as the default export — `\n      + 'write `export default defineI18nKitConfig({ ... })`.',\n    )\n  }\n\n  // In a `.cts` file `module.exports` comes back as the module itself, with no\n  // `default` to unwrap — so for the CommonJS spellings, that object *is* the\n  // config. Everywhere else a missing `default` means a file of named exports,\n  // and saying so beats letting the schema report a config full of unknown keys.\n  const commonJs = path.endsWith('.cts') || path.endsWith('.cjs')\n  if (!('default' in module) && !commonJs) {\n    throw new ConfigError(\n      `${path} must export its config as the default export — `\n      + 'write `export default defineI18nKitConfig({ ... })`.',\n    )\n  }\n\n  const exported = 'default' in module ? (module as { default: unknown }).default : module\n\n  if (exported === null || typeof exported !== 'object' || Array.isArray(exported)) {\n    throw new ConfigError(\n      `${path} must export a config object as its default export — got ${describe(exported)}. `\n      + 'Wrap it in defineI18nKitConfig() from \"the-i18n-cli/config\".',\n    )\n  }\n\n  const result = validateProjectConfig(exported)\n  if (!result.ok) {\n    throw new ConfigError(`Invalid ${path}:\\n${result.error}`)\n  }\n\n  return { path, config: dropDeprecatedKeys(result.data, path) }\n}\n\n/**\n * Point `the-i18n-cli/config` at the copy of `defineI18nKitConfig` that is\n * already running.\n *\n * A config file imports it for the types, and types only need the package\n * installed at author time — but the CLI is often run through `npx` in a\n * project that never added it as a dependency, where a bare import would be\n * unresolvable and take the whole config down with it. Resolving it to\n * ourselves costs nothing and is the same function either way: identity.\n *\n * Returns no alias when the entry cannot be located, which leaves normal\n * resolution to find the installed package.\n */\nfunction selfAlias(): Record<string, string> {\n  // `./` when running from the bundle, where define-config.js sits beside the\n  // chunk this code ends up in; `../` when running from source, as tests do.\n  for (const candidate of ['./define-config.js', '../define-config.js', '../define-config.ts']) {\n    const path = fileURLToPath(new URL(candidate, import.meta.url))\n    if (existsSync(path)) return { 'the-i18n-cli/config': path }\n  }\n  return {}\n}\n\nfunction describe(value: unknown): string {\n  if (value === null) return 'null'\n  if (Array.isArray(value)) return 'an array'\n  if (typeof value === 'function') return 'a function (call defineI18nKitConfig, do not pass it)'\n  return typeof value\n}\n","import { readFile } from 'node:fs/promises'\nimport { existsSync } from 'node:fs'\nimport { join, dirname } from 'node:path'\nimport type { ProjectConfig } from './types.js'\nimport { dropDeprecatedKeys, validateProjectConfig } from './schema.js'\nimport { loadTypedConfig } from './typed-config.js'\nimport { ConfigError, toErrorMessage } from '../utils/errors.js'\nimport { log } from '../utils/logger.js'\n\nexport const CONFIG_FILENAME = '.i18n-mcp.json'\n\n// The schema itself lives in ./schema.ts, shared with the typed-config loader.\n// Re-exported here because this has been its import path since before there\n// was a second config format.\nexport { validateProjectConfig } from './schema.js'\n\n// ─── Config file discovery ──────────────────────────────────────\n\n/**\n * Walk up the directory tree from `startDir` to find the nearest config file.\n * Returns the full path if found, null otherwise.\n */\nexport function findConfigFile(startDir: string): string | null {\n  let dir = startDir\n  while (true) {\n    const candidate = join(dir, CONFIG_FILENAME)\n    if (existsSync(candidate)) {\n      return candidate\n    }\n    const parent = dirname(dir)\n    if (parent === dir) break // filesystem root\n    dir = parent\n  }\n  return null\n}\n\n/**\n * Load the project's declared configuration, from either place it can be\n * declared: `i18n-kit.config.ts` and `.i18n-mcp.json`. Both are searched from\n * projectDir upwards, the way ESLint, Prettier and tsconfig resolve configs.\n *\n * Returns null when neither exists — the case that must keep behaving exactly\n * as it did before there were two. Throws ConfigError when either file is\n * present but unusable, or when the two disagree.\n *\n * Every adapter funnels through here, which is what makes the typed config\n * work for all of them rather than for whichever one was taught about it.\n */\nexport async function loadProjectConfig(projectDir: string): Promise<ProjectConfig | null> {\n  const [json, typed] = await Promise.all([\n    loadJsonConfig(projectDir),\n    loadTypedConfig(projectDir),\n  ])\n\n  if (!typed) return json?.config ?? null\n  if (!json) return typed.config\n\n  const conflicts = conflictingKeys(typed.config, json.config)\n  if (conflicts.length > 0) {\n    throw new ConfigError(\n      `${conflicts.join(', ')} ${conflicts.length === 1 ? 'is' : 'are'} declared in both\\n`\n      + `  ${typed.path}\\n`\n      + `  ${json.path}\\n`\n      + 'Neither wins — a reader cannot tell which one took effect. '\n      + 'Delete the duplicate from one of them.',\n    )\n  }\n\n  // Disjoint by the check above, so the spread order only decides where\n  // untouched keys come from, not who wins.\n  return { ...json.config, ...typed.config }\n}\n\n/** Keys present in both files, ignoring the JSON-only `$schema`. */\nfunction conflictingKeys(typed: ProjectConfig, json: ProjectConfig): string[] {\n  const a = typed as Record<string, unknown>\n  const b = json as Record<string, unknown>\n  return Object.keys(a).filter(key => key !== '$schema' && a[key] !== undefined && b[key] !== undefined)\n}\n\n/**\n * Load the optional `.i18n-mcp.json`, with the path it was found at.\n * Returns null if no config file is found in any ancestor.\n * Throws ConfigError if a file is found but is invalid.\n */\nasync function loadJsonConfig(\n  projectDir: string,\n): Promise<{ path: string, config: ProjectConfig } | null> {\n  log.debug(`Searching for ${CONFIG_FILENAME} starting from: ${projectDir}`)\n\n  const configPath = findConfigFile(projectDir)\n\n  if (!configPath) {\n    log.info(`No ${CONFIG_FILENAME} found in ${projectDir} or any parent directory — skipping`)\n    return null\n  }\n\n  log.info(`Found project config: ${configPath}`)\n\n  let raw: string\n  try {\n    raw = await readFile(configPath, 'utf-8')\n  } catch (error) {\n    throw new ConfigError(\n      `Failed to read ${CONFIG_FILENAME}: ${toErrorMessage(error)}`,\n    )\n  }\n\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(raw)\n  } catch (error) {\n    throw new ConfigError(\n      `Invalid JSON in ${CONFIG_FILENAME}: ${toErrorMessage(error)}`,\n    )\n  }\n\n  const result = validateProjectConfig(parsed)\n\n  if (!result.ok) {\n    throw new ConfigError(`Invalid ${CONFIG_FILENAME}:\\n${result.error}`)\n  }\n\n  log.debug(`Project config loaded successfully from ${configPath}`)\n\n  return { path: configPath, config: dropDeprecatedKeys(result.data, CONFIG_FILENAME) }\n}\n","import type { TranslateFn, TranslateRequest, TranslateResponse } from '../core/types.js'\n\nexport type LlmProvider = 'openai' | 'anthropic' | 'google'\n\n// ─── Error classification ───────────────────────────────────────\n\n/** How a provider failure should be handled by the caller. */\nexport type TranslateProviderErrorKind = 'auth' | 'rate-limit' | 'provider' | 'config'\n\n/**\n * A classified provider failure. `auth` errors are not retryable (the caller\n * should abort the run), `rate-limit` errors should be retried with backoff,\n * and `provider` covers everything else (server errors, network, …).\n * `config` marks an unusable provider setup and is raised while building the\n * TranslateFn, before any request exists — so it surfaces from the command\n * and never reaches the retry loop.\n */\nexport class TranslateProviderError extends Error {\n  public readonly kind: TranslateProviderErrorKind\n  public readonly status?: number\n\n  constructor(message: string, kind: TranslateProviderErrorKind, status?: number) {\n    super(message)\n    this.name = 'TranslateProviderError'\n    this.kind = kind\n    this.status = status\n  }\n}\n\n/** Defensively extract an HTTP status code from an unknown SDK error shape. */\nfunction extractStatus(error: unknown): number | undefined {\n  if (error === null || typeof error !== 'object') return undefined\n  const e = error as { status?: unknown, response?: unknown }\n  if (typeof e.status === 'number') return e.status\n  if (e.response !== null && typeof e.response === 'object') {\n    const status = (e.response as { status?: unknown }).status\n    if (typeof status === 'number') return status\n  }\n  return undefined\n}\n\n/**\n * Classify an SDK error into a TranslateProviderError:\n * 401/403 → auth, 429 → rate-limit, anything else → provider.\n * Already-classified errors pass through unchanged.\n */\nexport function classifyProviderError(error: unknown): TranslateProviderError {\n  if (error instanceof TranslateProviderError) return error\n  const status = extractStatus(error)\n  const message = error instanceof Error ? error.message : String(error)\n  const kind: TranslateProviderErrorKind\n    = status === 401 || status === 403 ? 'auth'\n      : status === 429 ? 'rate-limit'\n        : 'provider'\n  return new TranslateProviderError(message, kind, status)\n}\n\nexport interface LlmProviderConfig {\n  provider: LlmProvider\n  model: string\n  /** Override API key. Falls back to env vars */\n  apiKey?: string\n  /** Base URL override for proxies / compatible APIs */\n  baseUrl?: string\n}\n\n/** Environment variable carrying the provider base URL override. */\nexport const BASE_URL_ENV = 'I18N_BASE_URL'\n\n/**\n * Resolve the provider base URL from its three sources, highest precedence\n * first: an explicit flag, the I18N_BASE_URL env var, then the project\n * config's `providerBaseUrl`.\n *\n * Blank values count as unset. Shells produce them routinely — `--baseUrl\n * \"$UNSET\"` or an exported-but-empty variable — and a blank must not shadow a\n * real endpoint configured further down the chain. A blank in the config file\n * is a different case: it cannot arise by accident, so the strict schema\n * rejects it at load time rather than letting it reach this function.\n */\nexport function resolveProviderBaseUrl(sources: {\n  flag?: string\n  env?: string\n  config?: string\n}): string | undefined {\n  for (const value of [sources.flag, sources.env, sources.config]) {\n    if (typeof value === 'string' && value.trim().length > 0) return value.trim()\n  }\n  return undefined\n}\n\nconst ENV_KEY_MAP: Record<LlmProvider, string> = {\n  openai: 'OPENAI_API_KEY',\n  anthropic: 'ANTHROPIC_API_KEY',\n  google: 'GEMINI_API_KEY',\n}\n\nfunction resolveApiKey(provider: LlmProvider, configKey?: string): string {\n  if (configKey) return configKey\n  const envKey = ENV_KEY_MAP[provider]\n  const key = process.env[envKey]\n  if (!key) {\n    throw new Error(\n      `No API key found for provider \"${provider}\". Set ${envKey} environment variable or pass apiKey in config.`,\n    )\n  }\n  return key\n}\n\nasync function createOpenAiTranslateFn(config: LlmProviderConfig): Promise<TranslateFn> {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- dynamic import of optional peer dep\n  let OpenAI: any\n  try {\n    OpenAI = (await import('openai')).default as any // eslint-disable-line @typescript-eslint/no-explicit-any\n  } catch {\n    throw new Error(\n      'Provider \"openai\" requires the \"openai\" package. Install it with:\\n  npm install openai\\n  pnpm add openai\\n  yarn add openai',\n    )\n  }\n\n  const apiKey = resolveApiKey('openai', config.apiKey)\n  const client = new OpenAI({ apiKey, baseURL: config.baseUrl })\n\n  return async (opts: TranslateRequest): Promise<TranslateResponse> => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SDK types not available\n    let response: any\n    try {\n      response = await client.chat.completions.create({\n        model: config.model,\n        messages: [\n          { role: 'system', content: opts.systemPrompt },\n          { role: 'user', content: opts.userMessage },\n        ],\n        max_tokens: opts.maxTokens,\n        temperature: 0,\n        response_format: { type: 'json_object' },\n      })\n    } catch (error) {\n      throw classifyProviderError(error)\n    }\n\n    const choice = response.choices?.[0]\n    const text = choice?.message?.content ?? ''\n    const truncated = choice?.finish_reason === 'length'\n    return { text, model: response.model || config.model, ...(truncated ? { truncated: true } : {}) }\n  }\n}\n\nasync function createGoogleTranslateFn(config: LlmProviderConfig): Promise<TranslateFn> {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- dynamic import of optional peer dep\n  let GoogleGenAI: any\n  try {\n    GoogleGenAI = (await import('@google/genai')).GoogleGenAI as any // eslint-disable-line @typescript-eslint/no-explicit-any\n  } catch {\n    throw new Error(\n      'Provider \"google\" requires the \"@google/genai\" package. Install it with:\\n  npm install @google/genai\\n  pnpm add @google/genai\\n  yarn add @google/genai',\n    )\n  }\n\n  const apiKey = resolveApiKey('google', config.apiKey)\n  const client = new GoogleGenAI({ apiKey })\n\n  return async (opts: TranslateRequest): Promise<TranslateResponse> => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SDK types not available\n    let response: any\n    try {\n      response = await client.models.generateContent({\n        model: config.model,\n        contents: opts.userMessage,\n        config: {\n          systemInstruction: opts.systemPrompt,\n          maxOutputTokens: opts.maxTokens,\n          temperature: 0,\n          responseMimeType: 'application/json',\n        },\n      })\n    } catch (error) {\n      throw classifyProviderError(error)\n    }\n\n    const text = response.text ?? ''\n    const truncated = response.candidates?.[0]?.finishReason === 'MAX_TOKENS'\n    return { text, model: response.modelVersion || config.model, ...(truncated ? { truncated: true } : {}) }\n  }\n}\n\nasync function createAnthropicTranslateFn(config: LlmProviderConfig): Promise<TranslateFn> {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- dynamic import of optional peer dep\n  let Anthropic: any\n  try {\n    Anthropic = (await import('@anthropic-ai/sdk')).Anthropic as any // eslint-disable-line @typescript-eslint/no-explicit-any\n  } catch {\n    throw new Error(\n      'Provider \"anthropic\" requires the \"@anthropic-ai/sdk\" package. Install it with:\\n  npm install @anthropic-ai/sdk\\n  pnpm add @anthropic-ai/sdk\\n  yarn add @anthropic-ai/sdk',\n    )\n  }\n\n  const apiKey = resolveApiKey('anthropic', config.apiKey)\n  const client = new Anthropic({ apiKey, baseURL: config.baseUrl })\n\n  return async (opts: TranslateRequest): Promise<TranslateResponse> => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SDK types not available\n    let response: any\n    try {\n      response = await client.messages.create({\n        model: config.model,\n        system: opts.systemPrompt,\n        messages: [{ role: 'user', content: opts.userMessage }],\n        max_tokens: opts.maxTokens,\n        temperature: 0,\n      })\n    } catch (error) {\n      throw classifyProviderError(error)\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SDK types not available\n    const textBlock = response.content?.find((block: any) => block.type === 'text')\n    const text = textBlock?.text ?? ''\n    const truncated = response.stop_reason === 'max_tokens'\n    return { text, model: response.model || config.model, ...(truncated ? { truncated: true } : {}) }\n  }\n}\n\n/**\n * Create a TranslateFn from an LLM provider config.\n * Throws if the provider SDK is not installed or API key is missing.\n */\nexport async function createTranslateFn(config: LlmProviderConfig): Promise<TranslateFn> {\n  // @google/genai exposes no endpoint override, so a base URL here would be\n  // silently ignored and translate against the wrong endpoint. Refuse loudly.\n  if (config.provider === 'google' && config.baseUrl) {\n    throw new TranslateProviderError(\n      'Provider \"google\" does not support a custom base URL. '\n      + `Remove --baseUrl / ${BASE_URL_ENV} / providerBaseUrl, or use an OpenAI-compatible provider.`,\n      'config',\n    )\n  }\n\n  switch (config.provider) {\n    case 'openai':\n      return createOpenAiTranslateFn(config)\n    case 'anthropic':\n      return createAnthropicTranslateFn(config)\n    case 'google':\n      return createGoogleTranslateFn(config)\n    default: {\n      const _exhaustive: never = config.provider\n      throw new Error(`Unknown provider: ${_exhaustive}`)\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/remove-DR_mRiMA.js

@@ -0,0 +1,41 @@
+import "./stdout-guard-sJHFWVem.js";
+import { l as removeTranslations } from "./operations-BCJd7in3.js";
+import "./providers-BAwPjeCy.js";
+import "./php-reader-DuZ0Hyl_.js";
+import { o as splitList, t as createCommand } from "./_shared-Dv1EW2gy.js";
+//#region src/commands/remove.ts
+var remove_default = createCommand({
+	name: "remove",
+	description: "Remove translation keys from all locale files in a layer",
+	args: {
+		layer: {
+			type: "string",
+			description: "Layer name",
+			required: true
+		},
+		keys: {
+			type: "string",
+			description: "Comma-separated key paths to remove",
+			required: true
+		},
+		dryRun: {
+			type: "boolean",
+			description: "Preview changes without writing",
+			default: false
+		}
+	},
+	async run(args) {
+		const keys = splitList(args.keys) ?? [];
+		if (keys.length === 0) throw new Error("No keys provided. Pass comma-separated key paths via --keys");
+		return removeTranslations({
+			layer: args.layer,
+			keys,
+			dryRun: args.dryRun,
+			projectDir: args.projectDir
+		});
+	}
+});
+//#endregion
+export { remove_default as default };
+
+//# sourceMappingURL=remove-DR_mRiMA.js.map

package/dist/remove-DR_mRiMA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-DR_mRiMA.js","names":[],"sources":["../src/commands/remove.ts"],"sourcesContent":["import { createCommand, splitList } from './_shared.js'\nimport { removeTranslations } from '../core/operations.js'\n\nexport default createCommand({\n  name: 'remove',\n  description: 'Remove translation keys from all locale files in a layer',\n  args: {\n    layer: { type: 'string', description: 'Layer name', required: true },\n    keys: { type: 'string', description: 'Comma-separated key paths to remove', required: true },\n    dryRun: { type: 'boolean', description: 'Preview changes without writing', default: false },\n  },\n  async run(args) {\n    const keys = splitList(args.keys) ?? []\n    if (keys.length === 0) {\n      throw new Error('No keys provided. Pass comma-separated key paths via --keys')\n    }\n    return removeTranslations({ layer: args.layer, keys, dryRun: args.dryRun, projectDir: args.projectDir })\n  },\n})\n"],"mappings":";;;;;;AAGA,IAAA,iBAAe,cAAc;CAC3B,MAAM;CACN,aAAa;CACb,MAAM;EACJ,OAAO;GAAE,MAAM;GAAU,aAAa;GAAc,UAAU;GAAM;EACpE,MAAM;GAAE,MAAM;GAAU,aAAa;GAAuC,UAAU;GAAM;EAC5F,QAAQ;GAAE,MAAM;GAAW,aAAa;GAAmC,SAAS;GAAO;EAC5F;CACD,MAAM,IAAI,MAAM;EACd,MAAM,OAAO,UAAU,KAAK,KAAK,IAAI,EAAE;AACvC,MAAI,KAAK,WAAW,EAClB,OAAM,IAAI,MAAM,8DAA8D;AAEhF,SAAO,mBAAmB;GAAE,OAAO,KAAK;GAAO;GAAM,QAAQ,KAAK;GAAQ,YAAY,KAAK;GAAY,CAAC;;CAE3G,CAAC"}