@verbaly/compiler 0.26.0 → 0.28.0

package/dist/cli.js

@@ -331,7 +331,7 @@ function pseudoLocalize(message) {
 		}
 		const ch = message[i];
 		if (ch === "{") {
-			const end = matchBrace(message, i);
+			const end = matchBrace$1(message, i);
 			out += message.slice(i, end);
 			i = end;
 			continue;
@@ -355,7 +355,7 @@ function pseudoLocalize(message) {
 	const pad = "~".repeat(Math.ceil(letters / 3));
 	return `⟦${out}${pad ? " " + pad : ""}⟧`;
 }
-function matchBrace(message, start) {
+function matchBrace$1(message, start) {
 	let depth = 0;
 	for (let i = start; i < message.length; i++) {
 		const two = message.slice(i, i + 2);
@@ -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,282 @@ 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/inline.ts
+const OPEN_TAG = /^<([a-zA-Z][a-zA-Z0-9-]*)\s*(\/?)>/;
+function messageToInline(text) {
+	return renderParts(parseParts(text, 0).parts, /* @__PURE__ */ new Map());
+}
+function inlineToMessage(xml) {
+	let out = "";
+	let text = "";
+	let i = 0;
+	const flush = () => {
+		out += unescapeXml(text);
+		text = "";
+	};
+	while (i < xml.length) {
+		if (xml[i] === "<") {
+			const slice = xml.slice(i);
+			const ph = /^<ph\b([^>]*?)\/\s*>/.exec(slice) ?? /^<ph\b([^>]*)>\s*<\/ph\s*>/.exec(slice);
+			if (ph) {
+				flush();
+				out += attr(ph[1], "disp") ?? `{${attr(ph[1], "id") ?? "ph"}}`;
+				i += ph[0].length;
+				continue;
+			}
+			const pc = /^<pc\b([^>]*)>/.exec(slice);
+			if (pc) {
+				const close = findPcClose(xml, i + pc[0].length);
+				if (close) {
+					flush();
+					const id = attr(pc[1], "id") ?? "pc";
+					out += attr(pc[1], "dispStart") ?? `<${id}>`;
+					out += inlineToMessage(xml.slice(i + pc[0].length, close.innerEnd));
+					out += attr(pc[1], "dispEnd") ?? `</${id}>`;
+					i = close.end;
+					continue;
+				}
+			}
+		}
+		text += xml[i];
+		i += 1;
+	}
+	flush();
+	return out;
+}
+function escapeXml(text) {
+	return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function unescapeXml(text) {
+	return text.replace(/&(lt|gt|amp|quot|apos|#x?[0-9a-fA-F]+);/g, (_, entity) => {
+		if (entity === "lt") return "<";
+		if (entity === "gt") return ">";
+		if (entity === "amp") return "&";
+		if (entity === "quot") return "\"";
+		if (entity === "apos") return "'";
+		const code = entity.startsWith("#x") ? parseInt(entity.slice(2), 16) : parseInt(entity.slice(1), 10);
+		return String.fromCodePoint(code);
+	});
+}
+function parseParts(text, pos, closeTag) {
+	const parts = [];
+	let plain = "";
+	const flush = () => {
+		if (plain) parts.push({
+			kind: "text",
+			text: plain
+		});
+		plain = "";
+	};
+	let i = pos;
+	while (i < text.length) {
+		const pair = text[i] + (text[i + 1] ?? "");
+		if (pair === "{{" || pair === "}}") {
+			plain += pair;
+			i += 2;
+			continue;
+		}
+		if (text[i] === "{") {
+			const end = matchBrace(text, i);
+			if (end === -1) {
+				plain += "{";
+				i += 1;
+				continue;
+			}
+			const src = text.slice(i, end + 1);
+			if (hasTopLevelPipe(src)) plain += src;
+			else {
+				flush();
+				parts.push({
+					kind: "ph",
+					name: paramName(src),
+					src
+				});
+			}
+			i = end + 1;
+			continue;
+		}
+		if (text[i] === "<") {
+			if (closeTag && text.startsWith(`</${closeTag}>`, i)) {
+				flush();
+				return {
+					parts,
+					end: i + closeTag.length + 3,
+					closed: true
+				};
+			}
+			const open = OPEN_TAG.exec(text.slice(i));
+			if (open) {
+				const [openSrc, name, selfClose] = open;
+				if (selfClose) {
+					flush();
+					parts.push({
+						kind: "ph",
+						name: idSafe(name),
+						src: openSrc
+					});
+					i += openSrc.length;
+					continue;
+				}
+				const inner = parseParts(text, i + openSrc.length, name);
+				if (inner.closed) {
+					flush();
+					parts.push({
+						kind: "pc",
+						name: idSafe(name),
+						openSrc,
+						closeSrc: `</${name}>`,
+						children: inner.parts
+					});
+					i = inner.end;
+					continue;
+				}
+			}
+			plain += "<";
+			i += 1;
+			continue;
+		}
+		plain += text[i];
+		i += 1;
+	}
+	flush();
+	return {
+		parts,
+		end: i,
+		closed: false
+	};
+}
+function matchBrace(text, start) {
+	let depth = 0;
+	for (let i = start; i < text.length; i++) {
+		const pair = text[i] + (text[i + 1] ?? "");
+		if (pair === "{{" || pair === "}}") {
+			i += 1;
+			continue;
+		}
+		if (text[i] === "{") depth += 1;
+		else if (text[i] === "}") {
+			depth -= 1;
+			if (depth === 0) return i;
+		}
+	}
+	return -1;
+}
+function hasTopLevelPipe(src) {
+	let depth = 0;
+	for (let i = 0; i < src.length; i++) {
+		const pair = src[i] + (src[i + 1] ?? "");
+		if (pair === "{{" || pair === "}}" || pair === "||") {
+			i += 1;
+			continue;
+		}
+		if (src[i] === "{") depth += 1;
+		else if (src[i] === "}") depth -= 1;
+		else if (src[i] === "|" && depth === 1) return true;
+	}
+	return false;
+}
+function paramName(src) {
+	const name = /^\{\s*([^{}|:\s]+)/.exec(src)?.[1];
+	return name ? idSafe(name) : "ph";
+}
+function idSafe(name) {
+	return name.replace(/[^a-zA-Z0-9._-]/g, "_") || "ph";
+}
+function renderParts(parts, taken) {
+	let out = "";
+	for (const part of parts) if (part.kind === "text") out += escapeXml(part.text);
+	else if (part.kind === "ph") out += `<ph id="${uniqueId(part.name, taken)}" disp="${escapeXml(part.src)}"/>`;
+	else {
+		const id = uniqueId(part.name, taken);
+		out += `<pc id="${id}" dispStart="${escapeXml(part.openSrc)}" dispEnd="${escapeXml(part.closeSrc)}">`;
+		out += renderParts(part.children, taken);
+		out += "</pc>";
+	}
+	return out;
+}
+function uniqueId(name, taken) {
+	const count = taken.get(name) ?? 0;
+	taken.set(name, count + 1);
+	return count === 0 ? name : `${name}${count + 1}`;
+}
+function findPcClose(xml, from) {
+	const tags = /<pc\b[^>]*>|<\/pc\s*>/g;
+	tags.lastIndex = from;
+	let depth = 1;
+	for (let match = tags.exec(xml); match; match = tags.exec(xml)) {
+		depth += match[0].startsWith("</") ? -1 : 1;
+		if (depth === 0) return {
+			innerEnd: match.index,
+			end: tags.lastIndex
+		};
+	}
+}
+function attr(attrs, name) {
+	const value = new RegExp(`\\b${name}\\s*=\\s*"([^"]*)"`).exec(attrs)?.[1];
+	return value === void 0 ? void 0 : unescapeXml(value);
+}
+//#endregion
 //#region src/mobile.ts
 function androidValuesDir(locale, sourceLocale) {
 	if (locale === sourceLocale) return "values";
@@ -1122,6 +1398,97 @@ function iosText(text) {
 	return text.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n").replace(/\t/g, "\\t");
 }
 //#endregion
+//#region src/po.ts
+function toPo(sourceLocale, locale, entries) {
+	return [
+		[
+			"msgid \"\"",
+			"msgstr \"\"",
+			`${poString("Project-Id-Version: verbaly\n")}`,
+			`${poString("MIME-Version: 1.0\n")}`,
+			`${poString("Content-Type: text/plain; charset=UTF-8\n")}`,
+			`${poString("Content-Transfer-Encoding: 8bit\n")}`,
+			`${poString(`Language: ${locale}\n`)}`,
+			`${poString(`X-Source-Language: ${sourceLocale}\n`)}`
+		].join("\n"),
+		...entries.map(({ key, source, target, location }) => [
+			...location?.length ? [`#: ${location.join(" ")}`] : [],
+			`msgctxt ${poString(key)}`,
+			`msgid ${poString(source)}`,
+			`msgstr ${poString(target)}`
+		].join("\n")),
+		""
+	].join("\n\n");
+}
+function parsePo(content) {
+	const entries = {};
+	let locale;
+	let msgctxt;
+	let msgid;
+	let msgstr;
+	let fuzzy = false;
+	let field;
+	const finish = () => {
+		if (msgid === "" && msgctxt === void 0) {
+			const lang = /^Language:[ \t]*(.+?)[ \t]*$/m.exec(msgstr ?? "")?.[1];
+			if (lang) locale = lang;
+		} else if (msgctxt !== void 0 && msgid !== void 0) entries[msgctxt] = fuzzy ? "" : msgstr ?? "";
+		msgctxt = msgid = msgstr = field = void 0;
+		fuzzy = false;
+	};
+	for (const raw of content.replace(/^\uFEFF/, "").split(/\r\n|[\r\n]/)) {
+		const line = raw.trim();
+		if (line === "") {
+			finish();
+			continue;
+		}
+		if (line.startsWith("#")) {
+			if (/^#,.*\bfuzzy\b/.test(line)) fuzzy = true;
+			continue;
+		}
+		const keyword = /^(msgctxt|msgid_plural|msgid|msgstr(?:\[\d+\])?)\s+(.*)$/.exec(line);
+		if (keyword) {
+			const [, name, rest] = keyword;
+			const value = poUnquote(rest);
+			if (value === void 0) continue;
+			if (name === "msgctxt") {
+				msgctxt = value;
+				field = "msgctxt";
+			} else if (name === "msgid") {
+				msgid = value;
+				field = "msgid";
+			} else if (name === "msgstr" || name === "msgstr[0]") {
+				msgstr = value;
+				field = "msgstr";
+			} else field = "other";
+			continue;
+		}
+		const continuation = poUnquote(line);
+		if (continuation === void 0 || field === void 0 || field === "other") continue;
+		if (field === "msgctxt") msgctxt = (msgctxt ?? "") + continuation;
+		else if (field === "msgid") msgid = (msgid ?? "") + continuation;
+		else msgstr = (msgstr ?? "") + continuation;
+	}
+	finish();
+	return {
+		locale,
+		entries
+	};
+}
+function poString(text) {
+	return `"${text.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n").replace(/\t/g, "\\t").replace(/\r/g, "\\r")}"`;
+}
+function poUnquote(text) {
+	const match = /^"((?:[^"\\]|\\.)*)"$/.exec(text);
+	if (!match) return void 0;
+	return match[1].replace(/\\(.)/g, (_, ch) => {
+		if (ch === "n") return "\n";
+		if (ch === "t") return "	";
+		if (ch === "r") return "\r";
+		return ch;
+	});
+}
+//#endregion
 //#region src/translate.ts
 async function translateCatalogs(cfg, catalogs, provider, options = {}) {
 	const batchSize = options.batchSize ?? 20;
@@ -1143,10 +1510,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];
@@ -1201,8 +1570,8 @@ function exportCatalogs(cfg, catalogs, options = {}) {
 		}));
 		const untranslated = all.filter((entry) => !entry.target);
 		const entries = options.missing ? untranslated : all;
-		const path = join(dir, `${locale}.${format === "csv" ? "csv" : "xlf"}`);
-		writeFileSync(path, format === "csv" ? toCsv(entries) : toXliff(cfg.sourceLocale, locale, entries));
+		const path = join(dir, `${locale}.${format === "xliff" ? "xlf" : format}`);
+		writeFileSync(path, format === "csv" ? toCsv(entries) : format === "po" ? toPo(cfg.sourceLocale, locale, entries) : toXliff(cfg.sourceLocale, locale, entries));
 		files.push({
 			locale,
 			path,
@@ -1290,7 +1659,14 @@ function parseExchangeFile(file, localeOverride) {
 		locale: localeOverride ?? basename(file).replace(/\.csv$/i, ""),
 		entries: parseCsv(content)
 	};
-	throw new Error(`[verbaly] ${file}: unsupported format, expected .xlf, .xliff or .csv.`);
+	if (/\.po$/i.test(file)) {
+		const parsed = parsePo(content);
+		return {
+			locale: localeOverride ?? parsed.locale ?? basename(file).replace(/\.po$/i, ""),
+			entries: parsed.entries
+		};
+	}
+	throw new Error(`[verbaly] ${file}: unsupported format, expected .xlf, .xliff, .csv or .po.`);
 }
 function toXliff(sourceLocale, locale, entries) {
 	const units = entries.map(({ key, source, target, location }) => [
@@ -1301,8 +1677,8 @@ function toXliff(sourceLocale, locale, entries) {
 			"      </notes>"
 		] : [],
 		`      <segment state="${target ? "translated" : "initial"}">`,
-		`        <source>${escapeXml(source)}</source>`,
-		`        <target>${escapeXml(target)}</target>`,
+		`        <source>${messageToInline(source)}</source>`,
+		`        <target>${messageToInline(target)}</target>`,
 		"      </segment>",
 		"    </unit>"
 	].join("\n")).join("\n");
@@ -1323,30 +1699,16 @@ function parseXliff(content) {
 		const id = /\bid\s*=\s*"([^"]*)"/.exec(match[1])?.[1];
 		if (!id) continue;
 		const target = /<target\b[^>]*>([\s\S]*?)<\/target>/.exec(match[2])?.[1];
-		entries[unescapeXml(id)] = target === void 0 ? "" : unescapeXml(stripCdata(target));
+		entries[unescapeXml(id)] = target === void 0 ? "" : inlineToMessage(stripCdata(target));
 	}
 	return {
 		locale,
 		entries
 	};
 }
-function escapeXml(text) {
-	return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-}
 function stripCdata(text) {
 	return text.replace(/<!\[CDATA\[([\s\S]*?)\]\]>/g, "$1");
 }
-function unescapeXml(text) {
-	return text.replace(/&(lt|gt|amp|quot|apos|#x?[0-9a-fA-F]+);/g, (_, entity) => {
-		if (entity === "lt") return "<";
-		if (entity === "gt") return ">";
-		if (entity === "amp") return "&";
-		if (entity === "quot") return "\"";
-		if (entity === "apos") return "'";
-		const code = entity.startsWith("#x") ? parseInt(entity.slice(2), 16) : parseInt(entity.slice(1), 10);
-		return String.fromCodePoint(code);
-	});
-}
 function toCsv(entries) {
 	return [
 		"key,source,target,location",
@@ -1519,7 +1881,8 @@ async function renderSite(cfg, options = {}) {
 	const attribute = options.attribute ?? cfg.render.attribute;
 	const baseUrl = (options.baseUrl ?? cfg.render.baseUrl)?.replace(/\/+$/, "");
 	const wantHreflang = (options.hreflang ?? cfg.render.hreflang ?? true) && baseUrl !== void 0;
-	const wantSitemap = (options.sitemap ?? cfg.render.sitemap ?? false) && baseUrl !== void 0;
+	const sitemap = options.sitemap ?? cfg.render.sitemap ?? false;
+	const wantSitemap = sitemap !== false && baseUrl !== void 0;
 	const clean = options.clean ?? cfg.render.clean ?? false;
 	const catalogs = loadCatalogs(cfg);
 	if (clean) {
@@ -1562,7 +1925,7 @@ async function renderSite(cfg, options = {}) {
 			writeFileSync(out, result.html);
 		}
 	}
-	if (wantSitemap && urls.length) writeFileSync(join(site, typeof wantSitemap === "string" ? wantSitemap : "sitemap-i18n.xml"), buildSitemap(urls));
+	if (wantSitemap && urls.length) writeFileSync(join(site, typeof sitemap === "string" ? sitemap : "sitemap-i18n.xml"), buildSitemap(urls));
 	return {
 		files: files.length,
 		locales: [...locales],
@@ -1670,9 +2033,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 +2045,8 @@ function status(cfg, catalogs, registry) {
 		locales.push({
 			locale,
 			translated,
-			total: needed.size
+			total: needed.size,
+			drafts: live[locale]?.length ?? 0
 		});
 	}
 	return {
@@ -1696,10 +2061,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,8 +2335,9 @@ 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 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 review     list machine translations awaiting review (--approve marks them reviewed)
+  verbaly export     write translator files (XLIFF 2.0, CSV, gettext PO) or mobile resources (Android, iOS)
+  verbaly import <files…>  fill catalogs back from translated XLIFF/CSV/PO files
   verbaly pseudo     generate a pseudo-locale catalog for i18n QA (default: en-XA)
   verbaly render     pre-fill data-verbaly HTML per locale (SSG, kills the FOUC)
 
@@ -1983,10 +2350,12 @@ 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)
-  --format <f>       export format: xliff (default), csv, android-xml or ios-strings (export)
+  --format <f>       export format: xliff (default), csv, po, android-xml or ios-strings (export)
   --out <path>       export directory (export, default: verbaly-export)
   --missing          export only untranslated entries (export)
   --overwrite        replace existing translations on import (import)
@@ -2013,6 +2382,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 +2502,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 +2514,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 +2540,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,23 +2552,53 @@ 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 (![
 			"xliff",
 			"csv",
+			"po",
 			"android-xml",
 			"ios-strings"
 		].includes(format)) {
-			console.error(`[verbaly] unknown format "${values.format}", use xliff, csv, android-xml or ios-strings`);
+			console.error(`[verbaly] unknown format "${values.format}", use xliff, csv, po, android-xml or ios-strings`);
 			process.exitCode = 1;
 			return;
 		}
@@ -2225,11 +2636,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 +2695,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 +2736,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