@verbaly/compiler 0.26.0 → 0.27.0

package/dist/{claude-C-ETlqsW.js → claude-h9WA0ppg.js}

@@ -23,7 +23,9 @@ function claudeProvider(options = {}) {
 	};
 }
 function buildPrompt(request) {
-	return `Translate each value from "${request.sourceLocale}" to "${request.targetLocale}". Return a JSON object with the same keys and translated values.\n\n` + JSON.stringify(request.messages, null, 2);
+	const origins = request.origins;
+	const context = origins && Object.keys(origins).length ? `\n\nWhere each string appears (context for tone and length, do not translate these paths):\n` + Object.entries(origins).map(([key, files]) => `  ${key}: ${files.join(", ")}`).join("\n") : "";
+	return `Translate each value from "${request.sourceLocale}" to "${request.targetLocale}". Return a JSON object with the same keys and translated values.\n\n` + JSON.stringify(request.messages, null, 2) + context;
 }
 function batchFormat(request) {
 	const keys = Object.keys(request.messages);
@@ -48,4 +50,4 @@ async function loadSdk(load = () => import("@anthropic-ai/sdk")) {
 //#endregion
 export { claudeProvider };
 
-//# sourceMappingURL=claude-C-ETlqsW.js.map
+//# sourceMappingURL=claude-h9WA0ppg.js.map

package/dist/claude-h9WA0ppg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-h9WA0ppg.js","names":[],"sources":["../src/providers/claude.ts"],"sourcesContent":["import { isModuleNotFound } from '../config';\nimport type { TranslateProvider, TranslateRequest } from '../translate';\n\nexport interface ClaudeProviderOptions {\n  model?: string;\n  apiKey?: string;\n  maxTokens?: number;\n}\n\n// balanced default for translation\nconst DEFAULT_MODEL = 'claude-sonnet-5';\n\nconst SYSTEM = `You translate UI strings for the Verbaly i18n library.\nRules:\n- Translate only the human-readable text, naturally for the target locale.\n- Preserve verbatim: placeholders like {name}, format specs like {price:currency/EUR}, variant blocks like {count | one: ... | other: # ...} (translate only the text inside each variant, keep keys and # as-is), ICU syntax, named tags like <em>...</em> and escapes {{ }} || ##.\n- Keys are opaque identifiers: return exactly the same keys, never translate or rename them.`;\n\nexport function claudeProvider(options: ClaudeProviderOptions = {}): TranslateProvider {\n  return async (request: TranslateRequest) => {\n    const Anthropic = await loadSdk();\n    const client = new Anthropic(options.apiKey ? { apiKey: options.apiKey } : {});\n    const response = await client.messages.create({\n      model: options.model ?? DEFAULT_MODEL,\n      max_tokens: options.maxTokens ?? 16000,\n      thinking: { type: 'disabled' },\n      system: SYSTEM,\n      messages: [{ role: 'user', content: buildPrompt(request) }],\n      output_config: { format: batchFormat(request) },\n    });\n    const text = response.content.find((block) => block.type === 'text')?.text ?? '{}';\n    return JSON.parse(text) as Record<string, string>;\n  };\n}\n\nexport function buildPrompt(request: TranslateRequest): string {\n  const origins = request.origins;\n  const context =\n    origins && Object.keys(origins).length\n      ? `\\n\\nWhere each string appears (context for tone and length, do not translate these paths):\\n` +\n        Object.entries(origins)\n          .map(([key, files]) => `  ${key}: ${files.join(', ')}`)\n          .join('\\n')\n      : '';\n  return (\n    `Translate each value from \"${request.sourceLocale}\" to \"${request.targetLocale}\". ` +\n    `Return a JSON object with the same keys and translated values.\\n\\n` +\n    JSON.stringify(request.messages, null, 2) +\n    context\n  );\n}\n\nexport function batchFormat(request: TranslateRequest) {\n  const keys = Object.keys(request.messages);\n  return {\n    type: 'json_schema' as const,\n    schema: {\n      type: 'object',\n      properties: Object.fromEntries(keys.map((key) => [key, { type: 'string' }])),\n      required: keys,\n      additionalProperties: false,\n    },\n  };\n}\n\ntype SdkModule = { default: typeof import('@anthropic-ai/sdk').default };\n\n// injectable for tests\nexport async function loadSdk(\n  load: () => Promise<SdkModule> = () => import('@anthropic-ai/sdk'),\n): Promise<SdkModule['default']> {\n  try {\n    const mod = await load();\n    return mod.default;\n  } catch (error) {\n    if (isModuleNotFound(error, '@anthropic-ai/sdk')) {\n      throw new Error(\n        '[verbaly] the claude translate provider needs @anthropic-ai/sdk: install it as a dev dependency (e.g. `pnpm add -D @anthropic-ai/sdk` / `npm i -D @anthropic-ai/sdk`) and set ANTHROPIC_API_KEY',\n        { cause: error },\n      );\n    }\n    throw error;\n  }\n}\n"],"mappings":";;AAUA,MAAM,gBAAgB;AAEtB,MAAM,SAAS;;;;;AAMf,SAAgB,eAAe,UAAiC,CAAC,GAAsB;CACrF,OAAO,OAAO,YAA8B;EAW1C,MAAM,QAAO,MARU,KADJ,OADK,QAAQ,IACH,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC,CAChD,CAAC,CAAC,SAAS,OAAO;GAC5C,OAAO,QAAQ,SAAS;GACxB,YAAY,QAAQ,aAAa;GACjC,UAAU,EAAE,MAAM,WAAW;GAC7B,QAAQ;GACR,UAAU,CAAC;IAAE,MAAM;IAAQ,SAAS,YAAY,OAAO;GAAE,CAAC;GAC1D,eAAe,EAAE,QAAQ,YAAY,OAAO,EAAE;EAChD,CAAC,EAAA,CACqB,QAAQ,MAAM,UAAU,MAAM,SAAS,MAAM,CAAC,EAAE,QAAQ;EAC9E,OAAO,KAAK,MAAM,IAAI;CACxB;AACF;AAEA,SAAgB,YAAY,SAAmC;CAC7D,MAAM,UAAU,QAAQ;CACxB,MAAM,UACJ,WAAW,OAAO,KAAK,OAAO,CAAC,CAAC,SAC5B,iGACA,OAAO,QAAQ,OAAO,CAAC,CACpB,KAAK,CAAC,KAAK,WAAW,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,GAAG,CAAC,CACtD,KAAK,IAAI,IACZ;CACN,OACE,8BAA8B,QAAQ,aAAa,QAAQ,QAAQ,aAAa,yEAEhF,KAAK,UAAU,QAAQ,UAAU,MAAM,CAAC,IACxC;AAEJ;AAEA,SAAgB,YAAY,SAA2B;CACrD,MAAM,OAAO,OAAO,KAAK,QAAQ,QAAQ;CACzC,OAAO;EACL,MAAM;EACN,QAAQ;GACN,MAAM;GACN,YAAY,OAAO,YAAY,KAAK,KAAK,QAAQ,CAAC,KAAK,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC;GAC3E,UAAU;GACV,sBAAsB;EACxB;CACF;AACF;AAKA,eAAsB,QACpB,aAAuC,OAAO,sBACf;CAC/B,IAAI;EAEF,QAAO,MADW,KAAK,EAAA,CACZ;CACb,SAAS,OAAO;EACd,IAAI,iBAAiB,OAAO,mBAAmB,GAC7C,MAAM,IAAI,MACR,mMACA,EAAE,OAAO,MAAM,CACjB;EAEF,MAAM;CACR;AACF"}

package/dist/cli.js

@@ -387,7 +387,7 @@ function resolveConfig(config = {}) {
 	const sourceLocale = config.sourceLocale ?? "en";
 	const locales = /* @__PURE__ */ new Set([sourceLocale, ...config.locales ?? []]);
 	if (existsSync(dir)) {
-		for (const file of readdirSync(dir)) if (file.endsWith(".json") && file !== `en-XA.json`) locales.add(file.slice(0, -5));
+		for (const file of readdirSync(dir)) if (file.endsWith(".json") && !file.startsWith(".") && file !== `en-XA.json`) locales.add(file.slice(0, -5));
 	}
 	return {
 		root,
@@ -1083,6 +1083,66 @@ function readDeps(root) {
 	}
 }
 //#endregion
+//#region src/drafts.ts
+const DRAFTS_FILE = ".verbaly-drafts.json";
+function draftsPath(cfg) {
+	return join(cfg.dir, DRAFTS_FILE);
+}
+function loadDrafts(cfg) {
+	let content;
+	try {
+		content = readFileSync(draftsPath(cfg), "utf8");
+	} catch {
+		return {};
+	}
+	try {
+		return JSON.parse(content.replace(/^\uFEFF/, ""));
+	} catch (error) {
+		throw new Error(`[verbaly] ${draftsPath(cfg)} is not valid JSON, fix or delete the file`, { cause: error });
+	}
+}
+function serializeDrafts(drafts) {
+	const sorted = {};
+	for (const locale of Object.keys(drafts).sort()) {
+		const keys = [...new Set(drafts[locale])].sort();
+		if (keys.length) sorted[locale] = keys;
+	}
+	return JSON.stringify(sorted, null, 2) + "\n";
+}
+function saveDrafts(cfg, drafts) {
+	const serialized = serializeDrafts(drafts);
+	const path = draftsPath(cfg);
+	try {
+		if (readFileSync(path, "utf8") === serialized) return;
+	} catch {
+		mkdirSync(cfg.dir, { recursive: true });
+	}
+	writeFileSync(path, serialized);
+}
+function markDrafts(drafts, locale, keys) {
+	if (!keys.length) return;
+	drafts[locale] = [.../* @__PURE__ */ new Set([...drafts[locale] ?? [], ...keys])];
+}
+function clearDrafts(drafts, locale, keys) {
+	if (!drafts[locale]) return;
+	if (!keys) {
+		delete drafts[locale];
+		return;
+	}
+	const drop = new Set(keys);
+	drafts[locale] = drafts[locale].filter((key) => !drop.has(key));
+	if (!drafts[locale].length) delete drafts[locale];
+}
+function effectiveDrafts(drafts, catalogs) {
+	const out = {};
+	for (const [locale, keys] of Object.entries(drafts)) {
+		const catalog = catalogs[locale] ?? {};
+		const live = keys.filter((key) => catalog[key]);
+		if (live.length) out[locale] = live;
+	}
+	return out;
+}
+//#endregion
 //#region src/mobile.ts
 function androidValuesDir(locale, sourceLocale) {
 	if (locale === sourceLocale) return "values";
@@ -1143,10 +1203,12 @@ async function translateCatalogs(cfg, catalogs, provider, options = {}) {
 		for (let i = 0; i < missing.length; i += batchSize) {
 			const keys = missing.slice(i, i + batchSize);
 			const messages = Object.fromEntries(keys.map((key) => [key, source[key]]));
+			const origins = options.origins ? Object.fromEntries(keys.filter((key) => options.origins[key]).map((key) => [key, options.origins[key]])) : void 0;
 			const out = await provider({
 				sourceLocale: cfg.sourceLocale,
 				targetLocale: locale,
-				messages
+				messages,
+				origins
 			});
 			for (const key of keys) {
 				const text = out[key];
@@ -1670,9 +1732,10 @@ function decodeEntities(text) {
 }
 //#endregion
 //#region src/status.ts
-function status(cfg, catalogs, registry) {
+function status(cfg, catalogs, registry, drafts = {}) {
 	const source = catalogs[cfg.sourceLocale] ?? {};
 	const needed = /* @__PURE__ */ new Set([...registry.messages().keys(), ...Object.keys(source)]);
+	const live = effectiveDrafts(drafts, catalogs);
 	const locales = [];
 	for (const locale of cfg.locales) {
 		if (locale === cfg.sourceLocale) continue;
@@ -1681,7 +1744,8 @@ function status(cfg, catalogs, registry) {
 		locales.push({
 			locale,
 			translated,
-			total: needed.size
+			total: needed.size,
+			drafts: live[locale]?.length ?? 0
 		});
 	}
 	return {
@@ -1696,10 +1760,11 @@ function formatStatusResult(result) {
 		lines.push("  no target locales (add locales to your config)");
 		return lines.join("\n");
 	}
-	for (const { locale, translated, total } of result.locales) {
+	for (const { locale, translated, total, drafts } of result.locales) {
 		const pct = total === 0 ? 100 : Math.floor(translated / total * 100);
 		const mark = translated === total ? " ✓" : "";
-		lines.push(`  ${locale}: ${translated}/${total} translated (${pct}%)${mark}`);
+		const draftNote = drafts > 0 ? `, ${drafts} unreviewed` : "";
+		lines.push(`  ${locale}: ${translated}/${total} translated (${pct}%${draftNote})${mark}`);
 	}
 	return lines.join("\n");
 }
@@ -1969,6 +2034,7 @@ Usage:
   verbaly status     translation coverage per locale, at a glance
   verbaly check      verify translations are complete (CI)
   verbaly translate  fill missing translations via a provider (default: claude)
+  verbaly review     list machine translations awaiting review (--approve marks them reviewed)
   verbaly export     write translator files (XLIFF 2.0, CSV) or mobile resources (Android, iOS)
   verbaly import <files…>  fill catalogs back from translated XLIFF/CSV files
   verbaly pseudo     generate a pseudo-locale catalog for i18n QA (default: en-XA)
@@ -1983,6 +2049,8 @@ Options:
   --watch            keep extracting as source files change (extract)
   --write            apply the rewrites instead of only reporting (wrap)
   --json             machine-readable output (status)
+  --drafts           also fail on unreviewed machine translations (check)
+  --approve          mark listed drafts as reviewed (review)
   --reporter <name>  failure format: text (default) or github annotations (check)
   --model <id>       model override for the claude provider (translate)
   --dry-run          list what would happen, write nothing (translate, import, extract)
@@ -2013,6 +2081,8 @@ async function runCli(args = process.argv.slice(2)) {
 			watch: { type: "boolean" },
 			write: { type: "boolean" },
 			json: { type: "boolean" },
+			drafts: { type: "boolean" },
+			approve: { type: "boolean" },
 			reporter: { type: "string" },
 			model: { type: "string" },
 			locale: { type: "string" },
@@ -2131,7 +2201,7 @@ async function runCli(args = process.argv.slice(2)) {
 	}
 	if (command === "status") {
 		const registry = await extractProject(cfg);
-		const result = status(cfg, loadCatalogs(cfg), registry);
+		const result = status(cfg, loadCatalogs(cfg), registry, loadDrafts(cfg));
 		console.log(values.json ? JSON.stringify(result) : formatStatusResult(result));
 		return;
 	}
@@ -2143,11 +2213,20 @@ async function runCli(args = process.argv.slice(2)) {
 			return;
 		}
 		const registry = await extractProject(cfg);
-		const result = check(cfg, loadCatalogs(cfg), registry);
-		if (result.ok) {
+		const catalogs = loadCatalogs(cfg);
+		const result = check(cfg, catalogs, registry);
+		const unreviewed = values.drafts ? effectiveDrafts(loadDrafts(cfg), catalogs) : {};
+		const draftKeys = Object.entries(unreviewed);
+		if (result.ok && draftKeys.length === 0) {
 			console.log("[verbaly] all translations complete ✓");
 			return;
 		}
+		if (result.ok && draftKeys.length > 0) {
+			for (const [locale, keys] of draftKeys) console.error(`  [${locale}] ${keys.length} unreviewed: ${keys.join(", ")}`);
+			console.error("[verbaly] check failed: machine translations awaiting review (run verbaly review --approve)");
+			process.exitCode = 1;
+			return;
+		}
 		if (reporter === "github") {
 			for (const line of githubCheckAnnotations(result, registry, cfg.root)) console.error(line);
 			console.error(`[verbaly] check failed: ${result.missing.length} missing, ${result.unknown.length} unknown`);
@@ -2160,7 +2239,8 @@ async function runCli(args = process.argv.slice(2)) {
 		const result = await translateCatalogs(cfg, catalogs, await resolveProvider(cfg, values.model), {
 			locales: values.locales?.split(","),
 			batchSize: cfg.translate.batchSize,
-			dryRun: values["dry-run"]
+			dryRun: values["dry-run"],
+			origins: values["dry-run"] ? void 0 : await collectOrigins(cfg)
 		});
 		if (values["dry-run"]) {
 			const entries = Object.entries(result.pending);
@@ -2171,14 +2251,43 @@ async function runCli(args = process.argv.slice(2)) {
 			for (const [locale, keys] of entries) console.log(`  ${locale}: ${keys.length} missing: ${keys.join(", ")}`);
 			return;
 		}
+		const drafts = loadDrafts(cfg);
 		for (const locale of Object.keys(result.translated)) {
 			writeCatalog(cfg, locale, catalogs[locale] ?? {});
-			console.log(`  ${locale}: +${result.translated[locale].length} translated`);
+			markDrafts(drafts, locale, result.translated[locale]);
+			console.log(`  ${locale}: +${result.translated[locale].length} translated (draft)`);
 		}
+		if (Object.keys(result.translated).length > 0) saveDrafts(cfg, drafts);
 		for (const [locale, keys] of Object.entries(result.invalid)) console.warn(`  ${locale}: ${keys.length} rejected (params/tags not preserved): ${keys.join(", ")}`);
 		if (Object.keys(result.translated).length === 0 && Object.keys(result.invalid).length === 0) console.log("[verbaly] nothing to translate ✓");
 		return;
 	}
+	if (command === "review") {
+		const catalogs = loadCatalogs(cfg);
+		const drafts = loadDrafts(cfg);
+		const live = effectiveDrafts(drafts, catalogs);
+		const targets = values.locale ? { [values.locale]: live[values.locale] ?? [] } : live;
+		const entries = Object.entries(targets).filter(([, keys]) => keys.length);
+		if (entries.length === 0) {
+			console.log("[verbaly] no machine translations awaiting review ✓");
+			return;
+		}
+		if (values.approve) {
+			let count = 0;
+			for (const [locale, keys] of entries) {
+				clearDrafts(drafts, locale, keys);
+				count += keys.length;
+				console.log(`  ${locale}: ${keys.length} approved`);
+			}
+			saveDrafts(cfg, drafts);
+			console.log(`[verbaly] ${count} translations marked reviewed ✓`);
+			return;
+		}
+		const total = entries.reduce((sum, [, keys]) => sum + keys.length, 0);
+		console.log(`[verbaly] ${total} machine translations awaiting review (--approve to accept)`);
+		for (const [locale, keys] of entries) console.log(`  ${locale}: ${keys.join(", ")}`);
+		return;
+	}
 	if (command === "export") {
 		const format = values.format ?? "xliff";
 		if (![
@@ -2225,11 +2334,18 @@ async function runCli(args = process.argv.slice(2)) {
 			overwrite: values.overwrite,
 			dryRun: values["dry-run"]
 		});
+		const drafts = loadDrafts(cfg);
+		let draftsChanged = false;
 		for (const [locale, keys] of Object.entries(result.imported)) {
-			if (!values["dry-run"]) writeCatalog(cfg, locale, catalogs[locale] ?? {});
+			if (!values["dry-run"]) {
+				writeCatalog(cfg, locale, catalogs[locale] ?? {});
+				clearDrafts(drafts, locale, keys);
+				draftsChanged = true;
+			}
 			const verb = values["dry-run"] ? "would import" : "imported";
 			console.log(`  ${locale}: +${keys.length} ${verb}`);
 		}
+		if (draftsChanged) saveDrafts(cfg, drafts);
 		for (const [locale, keys] of Object.entries(result.skipped)) console.log(`  ${locale}: ${keys.length} already translated, kept (use --overwrite to replace)`);
 		for (const [locale, keys] of Object.entries(result.rejected)) console.warn(`  ${locale}: ${keys.length} rejected (params/tags not preserved): ${keys.join(", ")}`);
 		for (const [locale, keys] of Object.entries(result.unknown)) console.warn(`  ${locale}: ${keys.length} unknown keys ignored (not in the source catalog): ${keys.join(", ")}`);
@@ -2277,8 +2393,9 @@ const COMMAND_FLAGS = {
 	],
 	wrap: ["write"],
 	status: ["json"],
-	check: ["reporter"],
+	check: ["reporter", "drafts"],
 	translate: ["model", "dry-run"],
+	review: ["approve", "locale"],
 	export: [
 		"format",
 		"out",
@@ -2317,7 +2434,7 @@ async function collectOrigins(cfg) {
 async function resolveProvider(cfg, model) {
 	const configured = cfg.translate.provider;
 	if (typeof configured === "function") return configured;
-	const { claudeProvider } = await import("./claude-C-ETlqsW.js");
+	const { claudeProvider } = await import("./claude-h9WA0ppg.js");
 	return claudeProvider({ model: model ?? cfg.translate.model });
 }
 //#endregion