@fluenti/cli 0.1.3 → 0.2.1

package/dist/cli.js

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
-import { t as e } from "./tsx-extractor-DZrY1LMS.js";
-import { a as t, c as n, i as r, l as i, n as a, o, r as s, s as c, t as l } from "./compile-BJdEF9QX.js";
-import { defineCommand as u, runMain as d } from "citty";
-import f from "consola";
-import p from "fast-glob";
-import { appendFileSync as m, existsSync as h, mkdirSync as g, readFileSync as _, writeFileSync as v } from "node:fs";
-import { dirname as ee, extname as y, join as b, resolve as x } from "node:path";
-import { execFile as S } from "node:child_process";
-import { promisify as C } from "node:util";
+import { t as e } from "./tsx-extractor-CcFjsYI-.js";
+import { a as t, c as n, i as r, l as i, n as a, o, r as s, s as c, t as l, u } from "./config-loader-BgAoTfxH.js";
+import { appendFileSync as d, existsSync as f, mkdirSync as p, readFileSync as m, writeFileSync as h } from "node:fs";
+import { dirname as g, extname as _, join as v, resolve as y } from "node:path";
+import { defineCommand as b, runMain as ee } from "citty";
+import x from "consola";
+import S from "fast-glob";
+import { execFile as C } from "node:child_process";
+import { promisify as w } from "node:util";
 //#region src/stats-format.ts
-var w = "█", T = "░";
+var te = "█", T = "░";
 function E(e, t = 20) {
 	let n = Math.max(0, Math.min(100, e)), r = Math.round(n / 100 * t);
-	return w.repeat(r) + T.repeat(t - r);
+	return te.repeat(r) + T.repeat(t - r);
 }
 function D(e) {
 	let t = e.toFixed(1) + "%";
@@ -24,14 +24,15 @@ function O(e, t, n) {
 }
 //#endregion
 //#region src/translate.ts
-var k = C(S);
-function te(e, t, n) {
-	let r = JSON.stringify(n, null, 2);
+var k = w(C);
+function A(e, t, n, r) {
+	let i = JSON.stringify(n, null, 2);
 	return [
 		`You are a professional translator. Translate the following messages from "${e}" to "${t}".`,
 		"",
+		...r ? [`Project context: ${r}`, ""] : [],
 		"Input (JSON):",
-		r,
+		i,
 		"",
 		"Rules:",
 		"- Output ONLY valid JSON with the same keys and translated values.",
@@ -40,7 +41,7 @@ function te(e, t, n) {
 		"- Do not add any explanation or markdown formatting, output raw JSON only."
 	].join("\n");
 }
-async function ne(e, t) {
+async function j(e, t) {
 	let n = 10 * 1024 * 1024;
 	try {
 		if (e === "claude") {
@@ -58,19 +59,19 @@ async function ne(e, t) {
 		throw t.code === "ENOENT" ? Error(`"${e}" CLI not found. Please install it first:\n` + (e === "claude" ? "  npm install -g @anthropic-ai/claude-code" : "  npm install -g @openai/codex")) : t;
 	}
 }
-function A(e) {
+function M(e) {
 	let t = e.match(/\{[\s\S]*\}/);
 	if (!t) throw Error("No JSON object found in AI response");
 	let n = JSON.parse(t[0]);
 	if (typeof n != "object" || !n || Array.isArray(n)) throw Error("AI response is not a valid JSON object");
 	return n;
 }
-function j(e) {
+function N(e) {
 	let t = {};
 	for (let [n, r] of Object.entries(e)) r.obsolete || (!r.translation || r.translation.length === 0) && (t[n] = r.message ?? n);
 	return t;
 }
-function M(e, t) {
+function P(e, t) {
 	let n = Object.keys(e), r = [];
 	for (let i = 0; i < n.length; i += t) {
 		let a = {};
@@ -79,31 +80,31 @@ function M(e, t) {
 	}
 	return r;
 }
-async function N(e) {
-	let { provider: t, sourceLocale: n, targetLocale: r, catalog: i, batchSize: a } = e, o = j(i), s = Object.keys(o).length;
-	if (s === 0) return {
+async function F(e) {
+	let { provider: t, sourceLocale: n, targetLocale: r, catalog: i, batchSize: a, context: o } = e, s = N(i), c = Object.keys(s).length;
+	if (c === 0) return {
 		catalog: { ...i },
 		translated: 0
 	};
-	f.info(`  ${s} untranslated messages, translating with ${t}...`);
-	let c = { ...i }, l = M(o, a), u = 0;
-	for (let e = 0; e < l.length; e++) {
-		let i = l[e], a = Object.keys(i);
-		l.length > 1 && f.info(`  Batch ${e + 1}/${l.length} (${a.length} messages)`);
-		let o = A(await ne(t, te(n, r, i)));
-		for (let e of a) o[e] && typeof o[e] == "string" ? (c[e] = {
-			...c[e],
-			translation: o[e]
-		}, u++) : f.warn(`  Missing translation for key: ${e}`);
+	x.info(`  ${c} untranslated messages, translating with ${t}...`);
+	let l = { ...i }, u = P(s, a), d = 0;
+	for (let e = 0; e < u.length; e++) {
+		let i = u[e], a = Object.keys(i);
+		u.length > 1 && x.info(`  Batch ${e + 1}/${u.length} (${a.length} messages)`);
+		let s = M(await j(t, A(n, r, i, o)));
+		for (let e of a) s[e] && typeof s[e] == "string" ? (l[e] = {
+			...l[e],
+			translation: s[e]
+		}, d++) : x.warn(`  Missing translation for key: ${e}`);
 	}
 	return {
-		catalog: c,
-		translated: u
+		catalog: l,
+		translated: d
 	};
 }
 //#endregion
 //#region src/migrate.ts
-var P = C(S), F = {
+var I = w(C), L = {
 	"vue-i18n": {
 		name: "vue-i18n",
 		framework: "Vue",
@@ -243,37 +244,37 @@ var P = C(S), F = {
 		],
 		migrationGuide: "react/llms-migration.txt"
 	}
-}, I = Object.keys(F);
-function L(e) {
+}, R = Object.keys(L);
+function z(e) {
 	let t = e.toLowerCase().replace(/^@nuxtjs\//, "nuxt-").replace(/^@/, "");
-	return I.find((e) => e === t);
+	return R.find((e) => e === t);
 }
-async function R(e) {
+async function B(e) {
 	let t = {
 		configFiles: [],
 		localeFiles: [],
 		sampleSources: [],
 		packageJson: void 0
-	}, n = x("package.json");
-	h(n) && (t.packageJson = _(n, "utf-8"));
+	}, n = y("package.json");
+	f(n) && (t.packageJson = m(n, "utf-8"));
 	for (let n of e.configPatterns) {
-		let e = x(n);
-		h(e) && t.configFiles.push({
+		let e = y(n);
+		f(e) && t.configFiles.push({
 			path: n,
-			content: _(e, "utf-8")
+			content: m(e, "utf-8")
 		});
 	}
-	let r = await p(e.localePatterns, { absolute: !1 });
+	let r = await S(e.localePatterns, { absolute: !1 });
 	for (let e of r.slice(0, 10)) {
-		let n = _(x(e), "utf-8");
+		let n = m(y(e), "utf-8");
 		t.localeFiles.push({
 			path: e,
 			content: n.length > 5e3 ? n.slice(0, 5e3) + "\n... (truncated)" : n
 		});
 	}
-	let i = await p(e.sourcePatterns, { absolute: !1 });
+	let i = await S(e.sourcePatterns, { absolute: !1 });
 	for (let e of i.slice(0, 5)) {
-		let n = _(x(e), "utf-8");
+		let n = m(y(e), "utf-8");
 		t.sampleSources.push({
 			path: e,
 			content: n.length > 3e3 ? n.slice(0, 3e3) + "\n... (truncated)" : n
@@ -281,16 +282,16 @@ async function R(e) {
 	}
 	return t;
 }
-function z(e) {
+function V(e) {
 	let t = [
-		x("node_modules", "@fluenti", "cli", "..", "..", e),
-		b(__dirname, "..", "..", "..", e),
-		b(__dirname, "..", "..", e)
+		y("node_modules", "@fluenti", "cli", "..", "..", e),
+		v(__dirname, "..", "..", "..", e),
+		v(__dirname, "..", "..", e)
 	];
-	for (let e of t) if (h(e)) return _(e, "utf-8");
+	for (let e of t) if (f(e)) return m(e, "utf-8");
 	return "";
 }
-function B(e, t, n) {
+function H(e, t, n) {
 	let r = [];
 	if (r.push(`You are a migration assistant helping convert a ${e.framework} project from "${e.name}" to Fluenti (@fluenti).`, "", "Your task:", "1. Generate a `fluenti.config.ts` file based on the existing i18n configuration", "2. Convert each locale/translation file to Fluenti PO format", "3. List the code changes needed (file by file) to migrate source code from the old API to Fluenti API", ""), n && r.push("=== MIGRATION GUIDE ===", n, ""), t.packageJson && r.push("=== package.json ===", t.packageJson, ""), t.configFiles.length > 0) {
 		r.push("=== EXISTING CONFIG FILES ===");
@@ -306,14 +307,14 @@ function B(e, t, n) {
 	}
 	return r.push("", "=== OUTPUT FORMAT ===", "Respond with the following sections, each starting with the exact header shown:", "", "### FLUENTI_CONFIG", "```ts", "// The fluenti.config.ts content", "```", "", "### LOCALE_FILES", "For each locale file, output:", "#### LOCALE: {locale_code}", "```po", "// The PO file content", "```", "", "### MIGRATION_STEPS", "A numbered checklist of specific code changes needed, with before/after examples.", "", "### INSTALL_COMMANDS", "```bash", "// The install and uninstall commands", "```"), r.join("\n");
 }
-async function V(e, t) {
+async function U(e, t) {
 	let n = 10 * 1024 * 1024;
 	try {
 		if (e === "claude") {
-			let { stdout: e } = await P("claude", ["-p", t], { maxBuffer: n });
+			let { stdout: e } = await I("claude", ["-p", t], { maxBuffer: n });
 			return e;
 		} else {
-			let { stdout: e } = await P("codex", [
+			let { stdout: e } = await I("codex", [
 				"-p",
 				t,
 				"--full-auto"
@@ -324,7 +325,7 @@ async function V(e, t) {
 		throw t.code === "ENOENT" ? Error(`"${e}" CLI not found. Please install it first:\n` + (e === "claude" ? "  npm install -g @anthropic-ai/claude-code" : "  npm install -g @openai/codex")) : t;
 	}
 }
-function H(e) {
+function W(e) {
 	let t = {
 		config: void 0,
 		localeFiles: [],
@@ -345,58 +346,58 @@ function H(e) {
 	let a = e.match(/### INSTALL_COMMANDS[\s\S]*?```(?:bash|sh)?\n([\s\S]*?)```/);
 	return a && (t.installCommands = a[1].trim()), t;
 }
-async function U(e) {
-	let { from: t, provider: n, write: r } = e, i = L(t);
+async function G(e) {
+	let { from: t, provider: n, write: r } = e, i = z(t);
 	if (!i) {
-		f.error(`Unsupported library "${t}". Supported libraries:`);
-		for (let e of I) f.log(`  - ${e}`);
+		x.error(`Unsupported library "${t}". Supported libraries:`);
+		for (let e of R) x.log(`  - ${e}`);
 		return;
 	}
-	let a = F[i];
-	f.info(`Migrating from ${a.name} (${a.framework}) to Fluenti`), f.info("Scanning project for existing i18n files...");
-	let o = await R(a);
+	let a = L[i];
+	x.info(`Migrating from ${a.name} (${a.framework}) to Fluenti`), x.info("Scanning project for existing i18n files...");
+	let o = await B(a);
 	if (o.configFiles.length === 0 && o.localeFiles.length === 0) {
-		f.warn(`No ${a.name} configuration or locale files found.`), f.info("Make sure you are running this command from the project root directory.");
+		x.warn(`No ${a.name} configuration or locale files found.`), x.info("Make sure you are running this command from the project root directory.");
 		return;
 	}
-	f.info(`Found: ${o.configFiles.length} config file(s), ${o.localeFiles.length} locale file(s), ${o.sampleSources.length} source file(s)`);
-	let s = z(a.migrationGuide);
-	f.info(`Generating migration plan with ${n}...`);
-	let c = H(await V(n, B(a, o, s)));
-	if (c.installCommands && (f.log(""), f.box({
+	x.info(`Found: ${o.configFiles.length} config file(s), ${o.localeFiles.length} locale file(s), ${o.sampleSources.length} source file(s)`);
+	let s = V(a.migrationGuide);
+	x.info(`Generating migration plan with ${n}...`);
+	let c = W(await U(n, H(a, o, s)));
+	if (c.installCommands && (x.log(""), x.box({
 		title: "Install Commands",
 		message: c.installCommands
 	})), c.config) if (r) {
-		let { writeFileSync: e } = await import("node:fs"), t = x("fluenti.config.ts");
-		e(t, c.config, "utf-8"), f.success(`Written: ${t}`);
-	} else f.log(""), f.box({
+		let { writeFileSync: e } = await import("node:fs"), t = y("fluenti.config.ts");
+		e(t, c.config, "utf-8"), x.success(`Written: ${t}`);
+	} else x.log(""), x.box({
 		title: "fluenti.config.ts",
 		message: c.config
 	});
 	if (c.localeFiles.length > 0) if (r) {
 		let { writeFileSync: e, mkdirSync: t } = await import("node:fs"), n = "./locales";
-		t(x(n), { recursive: !0 });
+		t(y(n), { recursive: !0 });
 		for (let t of c.localeFiles) {
-			let r = x(n, `${t.locale}.po`);
-			e(r, t.content, "utf-8"), f.success(`Written: ${r}`);
+			let r = y(n, `${t.locale}.po`);
+			e(r, t.content, "utf-8"), x.success(`Written: ${r}`);
 		}
-	} else for (let e of c.localeFiles) f.log(""), f.box({
+	} else for (let e of c.localeFiles) x.log(""), x.box({
 		title: `locales/${e.locale}.po`,
 		message: e.content.length > 500 ? e.content.slice(0, 500) + "\n... (use --write to save full file)" : e.content
 	});
-	c.steps && (f.log(""), f.box({
+	c.steps && (x.log(""), x.box({
 		title: "Migration Steps",
 		message: c.steps
-	})), !r && (c.config || c.localeFiles.length > 0) && (f.log(""), f.info("Run with --write to save generated files to disk:"), f.log(`  fluenti migrate --from ${t} --write`));
+	})), !r && (c.config || c.localeFiles.length > 0) && (x.log(""), x.info("Run with --write to save generated files to disk:"), x.log(`  fluenti migrate --from ${t} --write`));
 }
 //#endregion
 //#region src/init.ts
-var W = /^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{1,8})*$/;
-function G(e) {
-	if (!W.test(e)) throw Error(`Invalid locale format: "${e}"`);
+var K = /^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{1,8})*$/;
+function q(e) {
+	if (!K.test(e)) throw Error(`Invalid locale format: "${e}"`);
 	return e;
 }
-var K = [
+var J = [
 	{
 		dep: "next",
 		name: "nextjs",
@@ -410,26 +411,26 @@ var K = [
 	{
 		dep: "@solidjs/start",
 		name: "solidstart",
-		pluginPackage: "@fluenti/vite-plugin"
+		pluginPackage: "@fluenti/solid"
 	},
 	{
 		dep: "vue",
 		name: "vue",
-		pluginPackage: "@fluenti/vite-plugin"
+		pluginPackage: "@fluenti/vue"
 	},
 	{
 		dep: "solid-js",
 		name: "solid",
-		pluginPackage: "@fluenti/vite-plugin"
+		pluginPackage: "@fluenti/solid"
 	},
 	{
 		dep: "react",
 		name: "react",
-		pluginPackage: "@fluenti/vite-plugin"
+		pluginPackage: "@fluenti/react"
 	}
 ];
-function q(e) {
-	for (let t of K) if (t.dep in e) return {
+function Y(e) {
+	for (let t of J) if (t.dep in e) return {
 		name: t.name,
 		pluginPackage: t.pluginPackage
 	};
@@ -438,7 +439,7 @@ function q(e) {
 		pluginPackage: null
 	};
 }
-function J(e) {
+function X(e) {
 	let t = e.locales.map((e) => `'${e}'`).join(", ");
 	return `import { defineConfig } from '@fluenti/cli'
 
@@ -452,66 +453,66 @@ export default defineConfig({
 })
 `;
 }
-async function Y(e) {
-	let t = x(e.cwd, "package.json");
-	if (!h(t)) {
-		f.error("No package.json found in current directory.");
+async function Z(e) {
+	let t = y(e.cwd, "package.json");
+	if (!f(t)) {
+		x.error("No package.json found in current directory.");
 		return;
 	}
-	let n = JSON.parse(_(t, "utf-8")), r = q({
+	let n = JSON.parse(m(t, "utf-8")), r = Y({
 		...n.dependencies,
 		...n.devDependencies
 	});
-	f.info(`Detected framework: ${r.name}`), r.pluginPackage && f.info(`Recommended plugin: ${r.pluginPackage}`);
-	let i = x(e.cwd, "fluenti.config.ts");
-	if (h(i)) {
-		f.warn("fluenti.config.ts already exists. Skipping config generation.");
+	x.info(`Detected framework: ${r.name}`), r.pluginPackage && x.info(`Recommended plugin: ${r.pluginPackage}`);
+	let i = y(e.cwd, "fluenti.config.ts");
+	if (f(i)) {
+		x.warn("fluenti.config.ts already exists. Skipping config generation.");
 		return;
 	}
-	let a = await f.prompt("Source locale?", {
+	let a = await x.prompt("Source locale?", {
 		type: "text",
 		default: "en",
 		placeholder: "en"
 	});
 	if (typeof a == "symbol") return;
-	let o = await f.prompt("Target locales (comma-separated)?", {
+	let o = await x.prompt("Target locales (comma-separated)?", {
 		type: "text",
 		default: "ja,zh-CN",
 		placeholder: "ja,zh-CN"
 	});
 	if (typeof o == "symbol") return;
-	let s = await f.prompt("Catalog format?", {
+	let s = await x.prompt("Catalog format?", {
 		type: "select",
 		options: ["po", "json"],
 		initial: "po"
 	});
 	if (typeof s == "symbol") return;
 	let c = o.split(",").map((e) => e.trim()).filter(Boolean);
-	G(a);
-	for (let e of c) G(e);
-	v(i, J({
+	q(a);
+	for (let e of c) q(e);
+	h(i, X({
 		sourceLocale: a,
 		locales: [a, ...c.filter((e) => e !== a)],
 		format: s
-	}), "utf-8"), f.success("Created fluenti.config.ts");
-	let l = x(e.cwd, ".gitignore"), u = "src/locales/compiled/";
-	h(l) ? _(l, "utf-8").includes(u) || (m(l, `\n# Fluenti compiled catalogs\n${u}\n`), f.success("Updated .gitignore")) : (v(l, `# Fluenti compiled catalogs\n${u}\n`), f.success("Created .gitignore"));
-	let d = n.scripts ?? {}, p = {}, g = !1;
-	if (d["i18n:extract"] || (p["i18n:extract"] = "fluenti extract", g = !0), d["i18n:compile"] || (p["i18n:compile"] = "fluenti compile", g = !0), g) {
+	}), "utf-8"), x.success("Created fluenti.config.ts");
+	let l = y(e.cwd, ".gitignore"), u = "src/locales/compiled/";
+	f(l) ? m(l, "utf-8").includes(u) || (d(l, `\n# Fluenti compiled catalogs\n${u}\n`), x.success("Updated .gitignore")) : (h(l, `# Fluenti compiled catalogs\n${u}\n`), x.success("Created .gitignore"));
+	let p = n.scripts ?? {}, g = {}, _ = !1;
+	if (p["i18n:extract"] || (g["i18n:extract"] = "fluenti extract", _ = !0), p["i18n:compile"] || (g["i18n:compile"] = "fluenti compile", _ = !0), _) {
 		let e = {
 			...n,
 			scripts: {
-				...d,
-				...p
+				...p,
+				...g
 			}
 		};
-		v(t, JSON.stringify(e, null, 2) + "\n", "utf-8"), f.success("Added i18n:extract and i18n:compile scripts to package.json");
+		h(t, JSON.stringify(e, null, 2) + "\n", "utf-8"), x.success("Added i18n:extract and i18n:compile scripts to package.json");
 	}
-	f.log(""), f.box({
+	x.log(""), x.box({
 		title: "Next steps",
 		message: [
 			r.pluginPackage ? `1. Install: pnpm add -D ${r.pluginPackage} @fluenti/cli` : "1. Install: pnpm add -D @fluenti/cli",
-			r.name === "nextjs" ? "2. Add withFluenti() to your next.config.ts" : r.name === "unknown" ? "2. Configure your build tool to use @fluenti/vite-plugin or @fluenti/next" : "2. Add fluentiPlugin() to your vite.config.ts",
+			r.name === "nextjs" ? "2. Add withFluenti() to your next.config.ts" : r.name === "unknown" ? "2. Configure your build tool with the framework Vite plugin or @fluenti/next" : "2. Add the Vite plugin to your vite.config.ts (e.g. fluentiVue() from @fluenti/vue/vite-plugin)",
 			"3. Run: npx fluenti extract",
 			"4. Translate your messages",
 			"5. Run: npx fluenti compile"
@@ -520,47 +521,24 @@ async function Y(e) {
 }
 //#endregion
 //#region src/cli.ts
-var X = {
-	sourceLocale: "en",
-	locales: ["en"],
-	catalogDir: "./locales",
-	format: "po",
-	include: ["./src/**/*.{vue,tsx,jsx,ts,js}"],
-	compileOutDir: "./src/locales/compiled"
-};
-async function Z(e) {
-	let t = e ? [x(e)] : [
-		x("fluenti.config.ts"),
-		x("fluenti.config.js"),
-		x("fluenti.config.mjs")
-	];
-	for (let e of t) if (h(e)) try {
-		let { createJiti: t } = await import("jiti"), n = await t(import.meta.url).import(e), r = n.default ?? n;
-		return {
-			...X,
-			...r
-		};
-	} catch {
-		f.warn(`Failed to load config from ${e}, using defaults`);
-	}
-	return X;
-}
-function Q(e, n) {
-	if (!h(e)) return {};
-	let r = _(e, "utf-8");
-	return n === "json" ? c(r) : t(r);
+function Q(e, t) {
+	if (!f(e)) return {};
+	let r = m(e, "utf-8");
+	return t === "json" ? n(r) : o(r);
 }
-function $(e, t, r) {
-	g(ee(e), { recursive: !0 }), v(e, r === "json" ? n(t) : o(t), "utf-8");
+function $(e, t, n) {
+	p(g(e), { recursive: !0 }), h(e, n === "json" ? i(t) : c(t), "utf-8");
 }
-async function re(t, n) {
-	if (y(t) === ".vue") {
-		let { extractFromVue: e } = await import("./vue-extractor-iUl6SUkv.js").then((e) => e.n);
+async function ne(t, n) {
+	if (_(t) === ".vue") try {
+		let { extractFromVue: e } = await import("./vue-extractor.js");
 		return e(n, t);
+	} catch {
+		return x.warn(`Skipping ${t}: install @vue/compiler-sfc to extract from .vue files`), [];
 	}
 	return e(n, t);
 }
-var ie = u({
+var re = b({
 	meta: {
 		name: "extract",
 		description: "Extract messages from source files"
@@ -582,23 +560,23 @@ var ie = u({
 		}
 	},
 	async run({ args: e }) {
-		let t = await Z(e.config);
-		f.info(`Extracting messages from ${t.include.join(", ")}`);
-		let n = await p(t.include), r = [];
+		let t = await l(e.config);
+		x.info(`Extracting messages from ${t.include.join(", ")}`);
+		let n = await S(t.include), r = [];
 		for (let e of n) {
-			let t = await re(e, _(e, "utf-8"));
+			let t = await ne(e, m(e, "utf-8"));
 			r.push(...t);
 		}
-		f.info(`Found ${r.length} messages in ${n.length} files`);
-		let a = t.format === "json" ? ".json" : ".po", o = e.clean ?? !1, s = e["no-fuzzy"] ?? !1;
+		x.info(`Found ${r.length} messages in ${n.length} files`);
+		let i = t.format === "json" ? ".json" : ".po", a = e.clean ?? !1, o = e["no-fuzzy"] ?? !1;
 		for (let e of t.locales) {
-			let n = x(t.catalogDir, `${e}${a}`), { catalog: c, result: l } = i(Q(n, t.format), r, { stripFuzzy: s });
-			$(n, o ? Object.fromEntries(Object.entries(c).filter(([, e]) => !e.obsolete)) : c, t.format);
-			let u = o ? `${l.obsolete} removed` : `${l.obsolete} obsolete`;
-			f.success(`${e}: ${l.added} added, ${l.unchanged} unchanged, ${u}`);
+			let n = y(t.catalogDir, `${e}${i}`), { catalog: s, result: c } = u(Q(n, t.format), r, { stripFuzzy: o });
+			$(n, a ? Object.fromEntries(Object.entries(s).filter(([, e]) => !e.obsolete)) : s, t.format);
+			let l = a ? `${c.obsolete} removed` : `${c.obsolete} obsolete`;
+			x.success(`${e}: ${c.added} added, ${c.unchanged} unchanged, ${l}`);
 		}
 	}
-}), ae = u({
+}), ie = b({
 	meta: {
 		name: "compile",
 		description: "Compile message catalogs to JS modules"
@@ -615,26 +593,26 @@ var ie = u({
 		}
 	},
 	async run({ args: e }) {
-		let t = await Z(e.config), n = t.format === "json" ? ".json" : ".po";
-		g(t.compileOutDir, { recursive: !0 });
-		let i = {};
-		for (let e of t.locales) i[e] = Q(x(t.catalogDir, `${e}${n}`), t.format);
-		let o = l(i);
-		f.info(`Compiling ${o.length} messages across ${t.locales.length} locales`);
-		let c = e["skip-fuzzy"] ?? !1;
-		for (let e of t.locales) {
-			let { code: n, stats: r } = a(i[e], e, o, t.sourceLocale, { skipFuzzy: c }), s = x(t.compileOutDir, `${e}.js`);
-			if (v(s, n, "utf-8"), r.missing.length > 0) {
-				f.warn(`${e}: ${r.compiled} compiled, ${r.missing.length} missing translations`);
-				for (let e of r.missing) f.warn(`  ⤷ ${e}`);
-			} else f.success(`Compiled ${e}: ${r.compiled} messages → ${s}`);
+		let n = await l(e.config), i = n.format === "json" ? ".json" : ".po";
+		p(n.compileOutDir, { recursive: !0 });
+		let o = {};
+		for (let e of n.locales) o[e] = Q(y(n.catalogDir, `${e}${i}`), n.format);
+		let c = a(o);
+		x.info(`Compiling ${c.length} messages across ${n.locales.length} locales`);
+		let u = e["skip-fuzzy"] ?? !1;
+		for (let e of n.locales) {
+			let { code: t, stats: r } = s(o[e], e, c, n.sourceLocale, { skipFuzzy: u }), i = y(n.compileOutDir, `${e}.js`);
+			if (h(i, t, "utf-8"), r.missing.length > 0) {
+				x.warn(`${e}: ${r.compiled} compiled, ${r.missing.length} missing translations`);
+				for (let e of r.missing) x.warn(`  ⤷ ${e}`);
+			} else x.success(`Compiled ${e}: ${r.compiled} messages → ${i}`);
 		}
-		let u = s(t.locales, t.compileOutDir), d = x(t.compileOutDir, "index.js");
-		v(d, u, "utf-8"), f.success(`Generated index → ${d}`);
-		let p = r(o, i, t.sourceLocale), m = x(t.compileOutDir, "messages.d.ts");
-		v(m, p, "utf-8"), f.success(`Generated types → ${m}`);
+		let d = r(n.locales, n.compileOutDir), f = y(n.compileOutDir, "index.js");
+		h(f, d, "utf-8"), x.success(`Generated index → ${f}`);
+		let m = t(c, o, n.sourceLocale), g = y(n.compileOutDir, "messages.d.ts");
+		h(g, m, "utf-8"), x.success(`Generated types → ${g}`);
 	}
-}), oe = u({
+}), ae = b({
 	meta: {
 		name: "stats",
 		description: "Show translation progress"
@@ -644,9 +622,9 @@ var ie = u({
 		description: "Path to config file"
 	} },
 	async run({ args: e }) {
-		let t = await Z(e.config), n = t.format === "json" ? ".json" : ".po", r = [];
+		let t = await l(e.config), n = t.format === "json" ? ".json" : ".po", r = [];
 		for (let e of t.locales) {
-			let i = Q(x(t.catalogDir, `${e}${n}`), t.format), a = Object.values(i).filter((e) => !e.obsolete), o = a.length, s = a.filter((e) => e.translation && e.translation.length > 0).length, c = o > 0 ? (s / o * 100).toFixed(1) + "%" : "—";
+			let i = Q(y(t.catalogDir, `${e}${n}`), t.format), a = Object.values(i).filter((e) => !e.obsolete), o = a.length, s = a.filter((e) => e.translation && e.translation.length > 0).length, c = o > 0 ? (s / o * 100).toFixed(1) + "%" : "—";
 			r.push({
 				locale: e,
 				total: o,
@@ -654,11 +632,11 @@ var ie = u({
 				pct: c
 			});
 		}
-		f.log(""), f.log("  Locale  │ Total │ Translated │ Progress"), f.log("  ────────┼───────┼────────────┼─────────────────────────────");
-		for (let e of r) f.log(O(e.locale, e.total, e.translated));
-		f.log("");
+		x.log(""), x.log("  Locale  │ Total │ Translated │ Progress"), x.log("  ────────┼───────┼────────────┼─────────────────────────────");
+		for (let e of r) x.log(O(e.locale, e.total, e.translated));
+		x.log("");
 	}
-}), se = u({
+}), oe = b({
 	meta: {
 		name: "translate",
 		description: "Translate messages using AI (Claude Code or Codex CLI)"
@@ -681,39 +659,58 @@ var ie = u({
 			type: "string",
 			description: "Messages per batch",
 			default: "50"
+		},
+		"dry-run": {
+			type: "boolean",
+			description: "Preview translation results without writing files",
+			default: !1
+		},
+		context: {
+			type: "string",
+			description: "Project context description to improve translation quality"
 		}
 	},
 	async run({ args: e }) {
-		let t = await Z(e.config), n = e.provider;
+		let t = await l(e.config), n = e.provider;
 		if (n !== "claude" && n !== "codex") {
-			f.error(`Invalid provider "${n}". Use "claude" or "codex".`);
+			x.error(`Invalid provider "${n}". Use "claude" or "codex".`);
 			return;
 		}
 		let r = parseInt(e["batch-size"] ?? "50", 10);
 		if (isNaN(r) || r < 1) {
-			f.error("Invalid batch-size. Must be a positive integer.");
+			x.error("Invalid batch-size. Must be a positive integer.");
 			return;
 		}
 		let i = e.locale ? [e.locale] : t.locales.filter((e) => e !== t.sourceLocale);
 		if (i.length === 0) {
-			f.warn("No target locales to translate.");
+			x.warn("No target locales to translate.");
 			return;
 		}
-		f.info(`Translating with ${n} (batch size: ${r})`);
+		x.info(`Translating with ${n} (batch size: ${r})`);
 		let a = t.format === "json" ? ".json" : ".po";
-		for (let e of i) {
-			f.info(`\n[${e}]`);
-			let i = x(t.catalogDir, `${e}${a}`), o = Q(i, t.format), { catalog: s, translated: c } = await N({
+		for (let o of i) {
+			x.info(`\n[${o}]`);
+			let i = y(t.catalogDir, `${o}${a}`), s = Q(i, t.format);
+			if (e["dry-run"]) {
+				let e = Object.entries(s).filter(([, e]) => !e.obsolete && (!e.translation || e.translation.length === 0));
+				if (e.length > 0) {
+					for (let [t, n] of e) x.log(`  ${t}: ${n.message ?? t}`);
+					x.success(`  ${o}: ${e.length} messages would be translated (dry-run)`);
+				} else x.success(`  ${o}: already fully translated`);
+				continue;
+			}
+			let { catalog: c, translated: l } = await F({
 				provider: n,
 				sourceLocale: t.sourceLocale,
-				targetLocale: e,
-				catalog: o,
-				batchSize: r
+				targetLocale: o,
+				catalog: s,
+				batchSize: r,
+				...e.context ? { context: e.context } : {}
 			});
-			c > 0 ? ($(i, s, t.format), f.success(`  ${e}: ${c} messages translated`)) : f.success(`  ${e}: already fully translated`);
+			l > 0 ? ($(i, c, t.format), x.success(`  ${o}: ${l} messages translated`)) : x.success(`  ${o}: already fully translated`);
 		}
 	}
-}), ce = u({
+}), se = b({
 	meta: {
 		name: "migrate",
 		description: "Migrate from another i18n library using AI"
@@ -738,38 +735,38 @@ var ie = u({
 	async run({ args: e }) {
 		let t = e.provider;
 		if (t !== "claude" && t !== "codex") {
-			f.error(`Invalid provider "${t}". Use "claude" or "codex".`);
+			x.error(`Invalid provider "${t}". Use "claude" or "codex".`);
 			return;
 		}
-		await U({
+		await G({
 			from: e.from,
 			provider: t,
 			write: e.write ?? !1
 		});
 	}
 });
-d(u({
+ee(b({
 	meta: {
 		name: "fluenti",
 		version: "0.0.1",
 		description: "Compile-time i18n for modern frameworks"
 	},
 	subCommands: {
-		init: u({
+		init: b({
 			meta: {
 				name: "init",
 				description: "Initialize Fluenti in your project"
 			},
 			args: {},
 			async run() {
-				await Y({ cwd: process.cwd() });
+				await Z({ cwd: process.cwd() });
 			}
 		}),
-		extract: ie,
-		compile: ae,
-		stats: oe,
-		translate: se,
-		migrate: ce
+		extract: re,
+		compile: ie,
+		stats: ae,
+		translate: oe,
+		migrate: se
 	}
 }));
 //#endregion