@fluenti/cli 0.2.0 → 0.2.1

package/dist/cli.js

@@ -1,37 +1,38 @@
 #!/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, u } from "./config-loader-CcqRnMzw.js";
+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 x } from "citty";
-import S from "consola";
-import C from "fast-glob";
-import { execFile as w } from "node:child_process";
-import { promisify as T } from "node:util";
+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 ee = "█", E = "░";
-function D(e, t = 20) {
+var te = "█", T = "░";
+function E(e, t = 20) {
 	let n = Math.max(0, Math.min(100, e)), r = Math.round(n / 100 * t);
-	return ee.repeat(r) + E.repeat(t - r);
+	return te.repeat(r) + T.repeat(t - r);
 }
-function O(e) {
+function D(e) {
 	let t = e.toFixed(1) + "%";
 	return e >= 90 ? `\x1b[32m${t}\x1b[0m` : e >= 70 ? `\x1b[33m${t}\x1b[0m` : `\x1b[31m${t}\x1b[0m`;
 }
-function te(e, t, n) {
-	let r = t > 0 ? n / t * 100 : 0, i = t > 0 ? O(r) : "—", a = t > 0 ? D(r) : "";
+function O(e, t, n) {
+	let r = t > 0 ? n / t * 100 : 0, i = t > 0 ? D(r) : "—", a = t > 0 ? E(r) : "";
 	return `  ${e.padEnd(8)}│ ${String(t).padStart(5)} │ ${String(n).padStart(10)} │ ${a} ${i}`;
 }
 //#endregion
 //#region src/translate.ts
-var k = T(w);
-function A(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.",
@@ -80,30 +81,30 @@ function P(e, t) {
 	return r;
 }
 async function F(e) {
-	let { provider: t, sourceLocale: n, targetLocale: r, catalog: i, batchSize: a } = e, o = N(i), s = Object.keys(o).length;
-	if (s === 0) return {
+	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
 	};
-	S.info(`  ${s} untranslated messages, translating with ${t}...`);
-	let c = { ...i }, l = P(o, a), u = 0;
-	for (let e = 0; e < l.length; e++) {
-		let i = l[e], a = Object.keys(i);
-		l.length > 1 && S.info(`  Batch ${e + 1}/${l.length} (${a.length} messages)`);
-		let o = M(await j(t, A(n, r, i)));
-		for (let e of a) o[e] && typeof o[e] == "string" ? (c[e] = {
-			...c[e],
-			translation: o[e]
-		}, u++) : S.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 I = T(w), L = {
+var I = w(C), L = {
 	"vue-i18n": {
 		name: "vue-i18n",
 		framework: "Vue",
@@ -263,7 +264,7 @@ async function B(e) {
 			content: m(e, "utf-8")
 		});
 	}
-	let r = await C(e.localePatterns, { absolute: !1 });
+	let r = await S(e.localePatterns, { absolute: !1 });
 	for (let e of r.slice(0, 10)) {
 		let n = m(y(e), "utf-8");
 		t.localeFiles.push({
@@ -271,7 +272,7 @@ async function B(e) {
 			content: n.length > 5e3 ? n.slice(0, 5e3) + "\n... (truncated)" : n
 		});
 	}
-	let i = await C(e.sourcePatterns, { absolute: !1 });
+	let i = await S(e.sourcePatterns, { absolute: !1 });
 	for (let e of i.slice(0, 5)) {
 		let n = m(y(e), "utf-8");
 		t.sampleSources.push({
@@ -348,28 +349,28 @@ function W(e) {
 async function G(e) {
 	let { from: t, provider: n, write: r } = e, i = z(t);
 	if (!i) {
-		S.error(`Unsupported library "${t}". Supported libraries:`);
-		for (let e of R) S.log(`  - ${e}`);
+		x.error(`Unsupported library "${t}". Supported libraries:`);
+		for (let e of R) x.log(`  - ${e}`);
 		return;
 	}
 	let a = L[i];
-	S.info(`Migrating from ${a.name} (${a.framework}) to Fluenti`), S.info("Scanning project for existing i18n files...");
+	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) {
-		S.warn(`No ${a.name} configuration or locale files found.`), S.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;
 	}
-	S.info(`Found: ${o.configFiles.length} config file(s), ${o.localeFiles.length} locale file(s), ${o.sampleSources.length} source file(s)`);
+	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);
-	S.info(`Generating migration plan with ${n}...`);
+	x.info(`Generating migration plan with ${n}...`);
 	let c = W(await U(n, H(a, o, s)));
-	if (c.installCommands && (S.log(""), S.box({
+	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 = y("fluenti.config.ts");
-		e(t, c.config, "utf-8"), S.success(`Written: ${t}`);
-	} else S.log(""), S.box({
+		e(t, c.config, "utf-8"), x.success(`Written: ${t}`);
+	} else x.log(""), x.box({
 		title: "fluenti.config.ts",
 		message: c.config
 	});
@@ -378,16 +379,16 @@ async function G(e) {
 		t(y(n), { recursive: !0 });
 		for (let t of c.localeFiles) {
 			let r = y(n, `${t.locale}.po`);
-			e(r, t.content, "utf-8"), S.success(`Written: ${r}`);
+			e(r, t.content, "utf-8"), x.success(`Written: ${r}`);
 		}
-	} else for (let e of c.localeFiles) S.log(""), S.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 && (S.log(""), S.box({
+	c.steps && (x.log(""), x.box({
 		title: "Migration Steps",
 		message: c.steps
-	})), !r && (c.config || c.localeFiles.length > 0) && (S.log(""), S.info("Run with --write to save generated files to disk:"), S.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
@@ -455,32 +456,32 @@ export default defineConfig({
 async function Z(e) {
 	let t = y(e.cwd, "package.json");
 	if (!f(t)) {
-		S.error("No package.json found in current directory.");
+		x.error("No package.json found in current directory.");
 		return;
 	}
 	let n = JSON.parse(m(t, "utf-8")), r = Y({
 		...n.dependencies,
 		...n.devDependencies
 	});
-	S.info(`Detected framework: ${r.name}`), r.pluginPackage && S.info(`Recommended plugin: ${r.pluginPackage}`);
+	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)) {
-		S.warn("fluenti.config.ts already exists. Skipping config generation.");
+		x.warn("fluenti.config.ts already exists. Skipping config generation.");
 		return;
 	}
-	let a = await S.prompt("Source locale?", {
+	let a = await x.prompt("Source locale?", {
 		type: "text",
 		default: "en",
 		placeholder: "en"
 	});
 	if (typeof a == "symbol") return;
-	let o = await S.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 S.prompt("Catalog format?", {
+	let s = await x.prompt("Catalog format?", {
 		type: "select",
 		options: ["po", "json"],
 		initial: "po"
@@ -493,9 +494,9 @@ async function Z(e) {
 		sourceLocale: a,
 		locales: [a, ...c.filter((e) => e !== a)],
 		format: s
-	}), "utf-8"), S.success("Created fluenti.config.ts");
+	}), "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`), S.success("Updated .gitignore")) : (h(l, `# Fluenti compiled catalogs\n${u}\n`), S.success("Created .gitignore"));
+	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 = {
@@ -505,9 +506,9 @@ async function Z(e) {
 				...g
 			}
 		};
-		h(t, JSON.stringify(e, null, 2) + "\n", "utf-8"), S.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");
 	}
-	S.log(""), S.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",
@@ -530,10 +531,10 @@ function $(e, t, n) {
 }
 async function ne(t, n) {
 	if (_(t) === ".vue") try {
-		let { extractFromVue: e } = await import("./vue-extractor-iUl6SUkv.js").then((e) => e.n);
+		let { extractFromVue: e } = await import("./vue-extractor.js");
 		return e(n, t);
 	} catch {
-		return S.warn(`Skipping ${t}: install @vue/compiler-sfc to extract from .vue files`), [];
+		return x.warn(`Skipping ${t}: install @vue/compiler-sfc to extract from .vue files`), [];
 	}
 	return e(n, t);
 }
@@ -560,19 +561,19 @@ var re = b({
 	},
 	async run({ args: e }) {
 		let t = await l(e.config);
-		S.info(`Extracting messages from ${t.include.join(", ")}`);
-		let n = await C(t.include), r = [];
+		x.info(`Extracting messages from ${t.include.join(", ")}`);
+		let n = await S(t.include), r = [];
 		for (let e of n) {
 			let t = await ne(e, m(e, "utf-8"));
 			r.push(...t);
 		}
-		S.info(`Found ${r.length} messages in ${n.length} files`);
+		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 = 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`;
-			S.success(`${e}: ${c.added} added, ${c.unchanged} unchanged, ${l}`);
+			x.success(`${e}: ${c.added} added, ${c.unchanged} unchanged, ${l}`);
 		}
 	}
 }), ie = b({
@@ -597,19 +598,19 @@ var re = b({
 		let o = {};
 		for (let e of n.locales) o[e] = Q(y(n.catalogDir, `${e}${i}`), n.format);
 		let c = a(o);
-		S.info(`Compiling ${c.length} messages across ${n.locales.length} locales`);
+		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) {
-				S.warn(`${e}: ${r.compiled} compiled, ${r.missing.length} missing translations`);
-				for (let e of r.missing) S.warn(`  ⤷ ${e}`);
-			} else S.success(`Compiled ${e}: ${r.compiled} messages → ${i}`);
+				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 d = r(n.locales, n.compileOutDir), f = y(n.compileOutDir, "index.js");
-		h(f, d, "utf-8"), S.success(`Generated index → ${f}`);
+		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"), S.success(`Generated types → ${g}`);
+		h(g, m, "utf-8"), x.success(`Generated types → ${g}`);
 	}
 }), ae = b({
 	meta: {
@@ -631,9 +632,9 @@ var re = b({
 				pct: c
 			});
 		}
-		S.log(""), S.log("  Locale  │ Total │ Translated │ Progress"), S.log("  ────────┼───────┼────────────┼─────────────────────────────");
-		for (let e of r) S.log(te(e.locale, e.total, e.translated));
-		S.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("");
 	}
 }), oe = b({
 	meta: {
@@ -658,36 +659,55 @@ var re = b({
 			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 l(e.config), n = e.provider;
 		if (n !== "claude" && n !== "codex") {
-			S.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) {
-			S.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) {
-			S.warn("No target locales to translate.");
+			x.warn("No target locales to translate.");
 			return;
 		}
-		S.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) {
-			S.info(`\n[${e}]`);
-			let i = y(t.catalogDir, `${e}${a}`), o = Q(i, t.format), { catalog: s, translated: c } = await F({
+		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), S.success(`  ${e}: ${c} messages translated`)) : S.success(`  ${e}: already fully translated`);
+			l > 0 ? ($(i, c, t.format), x.success(`  ${o}: ${l} messages translated`)) : x.success(`  ${o}: already fully translated`);
 		}
 	}
 }), se = b({
@@ -715,7 +735,7 @@ var re = b({
 	async run({ args: e }) {
 		let t = e.provider;
 		if (t !== "claude" && t !== "codex") {
-			S.error(`Invalid provider "${t}". Use "claude" or "codex".`);
+			x.error(`Invalid provider "${t}". Use "claude" or "codex".`);
 			return;
 		}
 		await G({
@@ -725,7 +745,7 @@ var re = b({
 		});
 	}
 });
-x(b({
+ee(b({
 	meta: {
 		name: "fluenti",
 		version: "0.0.1",