@verbaly/compiler 0.26.0 → 0.28.0

package/dist/index.d.ts

@@ -48,12 +48,14 @@ interface TranslateRequest {
   sourceLocale: string;
   targetLocale: string;
   messages: Record<string, string>;
+  origins?: Record<string, string[]>;
 }
 type TranslateProvider = (request: TranslateRequest) => Promise<Record<string, string>>;
 interface TranslateOptions {
   locales?: string[];
   batchSize?: number;
   dryRun?: boolean;
+  origins?: Record<string, string[]>;
 }
 interface TranslateResult {
   translated: Record<string, string[]>;
@@ -192,8 +194,17 @@ interface DoctorResult {
 }
 declare function doctor(cfg: ResolvedConfig): Promise<DoctorResult>;
 //#endregion
+//#region src/drafts.d.ts
+declare const DRAFTS_FILE = ".verbaly-drafts.json";
+type Drafts = Record<string, string[]>;
+declare function loadDrafts(cfg: ResolvedConfig): Drafts;
+declare function saveDrafts(cfg: ResolvedConfig, drafts: Drafts): void;
+declare function markDrafts(drafts: Drafts, locale: string, keys: string[]): void;
+declare function clearDrafts(drafts: Drafts, locale: string, keys?: string[]): void;
+declare function effectiveDrafts(drafts: Drafts, catalogs: Catalogs): Drafts;
+//#endregion
 //#region src/exchange.d.ts
-type ExchangeFormat = 'xliff' | 'csv';
+type ExchangeFormat = 'xliff' | 'csv' | 'po';
 type MobileFormat = 'android-xml' | 'ios-strings';
 type ExportFormat = ExchangeFormat | MobileFormat;
 declare function isMobileFormat(format: ExportFormat): format is MobileFormat;
@@ -323,13 +334,14 @@ interface LocaleStatus {
   locale: string;
   translated: number;
   total: number;
+  drafts: number;
 }
 interface StatusResult {
   messages: number;
   source: string;
   locales: LocaleStatus[];
 }
-declare function status(cfg: ResolvedConfig, catalogs: Catalogs, registry: MessageRegistry): StatusResult;
+declare function status(cfg: ResolvedConfig, catalogs: Catalogs, registry: MessageRegistry, drafts?: Drafts): StatusResult;
 declare function formatStatusResult(result: StatusResult): string;
 //#endregion
 //#region src/watch.d.ts
@@ -369,5 +381,5 @@ interface WrapCodeResult {
 }
 declare function wrapCode(code: string, file: string): WrapCodeResult;
 //#endregion
-export { type Alternate, type Analysis, type AnalyzeOptions, type Catalog, type Catalogs, type CheckResult, type ClaudeProviderOptions, type DoctorEntry, type DoctorResult, type ExchangeFormat, type ExportFormat, type ExportOptions, type ExportResult, type ExportedFile, type ImportOptions, type ImportResult, type InitOptions, type InitResult, LOCALE_MODULE_PREFIX, type LocaleStatus, MessageRegistry, type MissingEntry, type MobileFormat, PSEUDO_LOCALE, type ParamType, type PluginOptions, RESOLVED_VIRTUAL_ID, type RenderConfig, type RenderHtmlOptions, type RenderHtmlResult, type RenderSiteOptions, type RenderSiteResult, type ResolvedConfig, type RuntimeModuleOptions, SFC_FILE_RE, SOURCE_FILE_RE, type StatusResult, type SyncResult, type TaggedMessage, type TaggedParam, type TransComponent, type TransformResult, type TranslateConfig, type TranslateOptions, type TranslateProvider, type TranslateRequest, type TranslateResult, type UnknownEntry, type UsedKey, VIRTUAL_ID, type VerbalyConfig, type WatchProjectOptions, type WrapCodeResult, type WrapEntry, type WrapOptions, type WrapResult, type WrapSkip, analyze, analyzeFile, analyzeSfc, catalogPath, check, claudeProvider, collectParams, createSourceFilter, detectBundler, doctor, exportCatalogs, extractProject, findConfigFile, formatCheckResult, formatStatusResult, generateDts, generateLocaleModule, generateRuntimeModule, githubCheckAnnotations, importCatalogs, init, isMobileFormat, isTransformTarget, loadCatalogs, loadConfig, loadConfigFile, loadVirtualModule, parseExchangeFile, pruneCatalogs, pseudoCatalogs, pseudoLocalize, readCatalog, renderHtml, renderParamType, renderSite, resolveConfig, resolveVirtualId, runBuildGate, serializeCatalog, stableKey, status, structureMatches, syncCatalogs, targetLocales, transformCode, transformSource, translateCatalogs, watchProject, wrapCode, wrapProject, writeCatalog, writeDts };
+export { type Alternate, type Analysis, type AnalyzeOptions, type Catalog, type Catalogs, type CheckResult, type ClaudeProviderOptions, DRAFTS_FILE, type DoctorEntry, type DoctorResult, type Drafts, type ExchangeFormat, type ExportFormat, type ExportOptions, type ExportResult, type ExportedFile, type ImportOptions, type ImportResult, type InitOptions, type InitResult, LOCALE_MODULE_PREFIX, type LocaleStatus, MessageRegistry, type MissingEntry, type MobileFormat, PSEUDO_LOCALE, type ParamType, type PluginOptions, RESOLVED_VIRTUAL_ID, type RenderConfig, type RenderHtmlOptions, type RenderHtmlResult, type RenderSiteOptions, type RenderSiteResult, type ResolvedConfig, type RuntimeModuleOptions, SFC_FILE_RE, SOURCE_FILE_RE, type StatusResult, type SyncResult, type TaggedMessage, type TaggedParam, type TransComponent, type TransformResult, type TranslateConfig, type TranslateOptions, type TranslateProvider, type TranslateRequest, type TranslateResult, type UnknownEntry, type UsedKey, VIRTUAL_ID, type VerbalyConfig, type WatchProjectOptions, type WrapCodeResult, type WrapEntry, type WrapOptions, type WrapResult, type WrapSkip, analyze, analyzeFile, analyzeSfc, catalogPath, check, claudeProvider, clearDrafts, collectParams, createSourceFilter, detectBundler, doctor, effectiveDrafts, exportCatalogs, extractProject, findConfigFile, formatCheckResult, formatStatusResult, generateDts, generateLocaleModule, generateRuntimeModule, githubCheckAnnotations, importCatalogs, init, isMobileFormat, isTransformTarget, loadCatalogs, loadConfig, loadConfigFile, loadDrafts, loadVirtualModule, markDrafts, parseExchangeFile, pruneCatalogs, pseudoCatalogs, pseudoLocalize, readCatalog, renderHtml, renderParamType, renderSite, resolveConfig, resolveVirtualId, runBuildGate, saveDrafts, serializeCatalog, stableKey, status, structureMatches, syncCatalogs, targetLocales, transformCode, transformSource, translateCatalogs, watchProject, wrapCode, wrapProject, writeCatalog, writeDts };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -768,7 +768,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;
@@ -792,7 +792,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);
@@ -824,7 +824,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,
@@ -1211,6 +1211,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";
@@ -1250,6 +1526,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;
@@ -1271,10 +1638,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];
@@ -1329,8 +1698,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,
@@ -1418,7 +1787,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 }) => [
@@ -1429,8 +1805,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");
@@ -1451,30 +1827,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",
@@ -1551,7 +1913,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);
@@ -1694,7 +2058,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) {
@@ -1737,7 +2102,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],
@@ -1845,9 +2210,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;
@@ -1856,7 +2222,8 @@ function status(cfg, catalogs, registry) {
 		locales.push({
 			locale,
 			translated,
-			total: needed.size
+			total: needed.size,
+			drafts: live[locale]?.length ?? 0
 		});
 	}
 	return {
@@ -1871,10 +2238,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");
 }
@@ -2132,6 +2500,6 @@ function line(node) {
 	return node.loc?.start?.line ?? 1;
 }
 //#endregion
-export { LOCALE_MODULE_PREFIX, MessageRegistry, PSEUDO_LOCALE, RESOLVED_VIRTUAL_ID, SFC_FILE_RE, SOURCE_FILE_RE, VIRTUAL_ID, analyze, analyzeFile, analyzeSfc, catalogPath, check, claudeProvider, collectParams, createSourceFilter, detectBundler, doctor, exportCatalogs, extractProject, findConfigFile, formatCheckResult, formatStatusResult, generateDts, generateLocaleModule, generateRuntimeModule, githubCheckAnnotations, importCatalogs, init, isMobileFormat, isTransformTarget, loadCatalogs, loadConfig, loadConfigFile, loadVirtualModule, parseExchangeFile, pruneCatalogs, pseudoCatalogs, pseudoLocalize, readCatalog, renderHtml, renderParamType, renderSite, resolveConfig, resolveVirtualId, runBuildGate, serializeCatalog, stableKey, status, structureMatches, syncCatalogs, targetLocales, transformCode, transformSource, translateCatalogs, watchProject, wrapCode, wrapProject, writeCatalog, writeDts };
+export { DRAFTS_FILE, LOCALE_MODULE_PREFIX, MessageRegistry, PSEUDO_LOCALE, RESOLVED_VIRTUAL_ID, SFC_FILE_RE, SOURCE_FILE_RE, VIRTUAL_ID, analyze, analyzeFile, analyzeSfc, catalogPath, check, claudeProvider, clearDrafts, collectParams, createSourceFilter, detectBundler, doctor, effectiveDrafts, exportCatalogs, extractProject, findConfigFile, formatCheckResult, formatStatusResult, generateDts, generateLocaleModule, generateRuntimeModule, githubCheckAnnotations, importCatalogs, init, isMobileFormat, isTransformTarget, loadCatalogs, loadConfig, loadConfigFile, loadDrafts, loadVirtualModule, markDrafts, parseExchangeFile, pruneCatalogs, pseudoCatalogs, pseudoLocalize, readCatalog, renderHtml, renderParamType, renderSite, resolveConfig, resolveVirtualId, runBuildGate, saveDrafts, serializeCatalog, stableKey, status, structureMatches, syncCatalogs, targetLocales, transformCode, transformSource, translateCatalogs, watchProject, wrapCode, wrapProject, writeCatalog, writeDts };
 
 //# sourceMappingURL=index.js.map