@verbaly/compiler 0.25.0 → 0.27.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[]>;
@@ -85,6 +87,7 @@ interface VerbalyConfig {
   locales?: string[];
   include?: string[];
   exclude?: string[];
+  dts?: string | false;
   translate?: TranslateConfig;
   render?: RenderConfig;
 }
@@ -95,6 +98,7 @@ interface ResolvedConfig {
   locales: string[];
   include: string[];
   exclude: string[];
+  dts: string | false | undefined;
   translate: TranslateConfig;
   render: RenderConfig;
 }
@@ -140,6 +144,7 @@ interface CheckResult {
 }
 declare function check(cfg: ResolvedConfig, catalogs: Catalogs, registry: MessageRegistry): CheckResult;
 declare function formatCheckResult(result: CheckResult): string;
+declare function githubCheckAnnotations(result: CheckResult, registry: MessageRegistry, root: string): string[];
 //#endregion
 //#region src/codegen.d.ts
 declare const VIRTUAL_ID = "virtual:verbaly";
@@ -150,7 +155,7 @@ interface RuntimeModuleOptions {
 declare function generateRuntimeModule(cfg: ResolvedConfig, options?: RuntimeModuleOptions): string;
 declare function generateLocaleModule(catalog: Catalog): string;
 declare function generateDts(catalog: Catalog): string;
-declare function writeDts(cfg: ResolvedConfig, catalog: Catalog): void;
+declare function writeDts(cfg: ResolvedConfig, catalog: Catalog, file?: string): void;
 //#endregion
 //#region src/transform.d.ts
 interface TransformResult {
@@ -169,6 +174,7 @@ declare const SOURCE_FILE_RE: RegExp;
 declare function resolveVirtualId(id: string): string | undefined;
 declare function loadVirtualModule(id: string, cfg: ResolvedConfig, catalogs: Catalogs): string | undefined;
 declare function isTransformTarget(id: string): boolean;
+declare function createSourceFilter(cfg: ResolvedConfig): (id: string) => boolean;
 declare function transformSource(code: string, id: string, registry: MessageRegistry): {
   analysis: Analysis;
   result: TransformResult | null;
@@ -188,6 +194,15 @@ 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 MobileFormat = 'android-xml' | 'ios-strings';
@@ -248,7 +263,7 @@ interface InitOptions {
 interface InitResult {
   created: string[];
   skipped: string[];
-  bundler: 'vite' | 'webpack' | 'rollup' | 'rspack' | 'esbuild' | undefined;
+  bundler: 'astro' | 'vite' | 'webpack' | 'rollup' | 'rspack' | 'esbuild' | undefined;
   configFile: string;
   next: string[];
 }
@@ -319,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
@@ -334,5 +350,36 @@ interface WatchProjectOptions {
 }
 declare function watchProject(cfg: ResolvedConfig, run: () => Promise<void>, options?: WatchProjectOptions): () => void;
 //#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, analyze, analyzeFile, analyzeSfc, catalogPath, check, claudeProvider, collectParams, detectBundler, doctor, exportCatalogs, extractProject, findConfigFile, formatCheckResult, formatStatusResult, generateDts, generateLocaleModule, generateRuntimeModule, 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, writeCatalog, writeDts };
+//#region src/wrap.d.ts
+interface WrapEntry {
+  file: string;
+  line: number;
+  text: string;
+  kind: 'text' | 'attribute';
+  attribute?: string;
+}
+interface WrapSkip {
+  file: string;
+  line: number;
+  text: string;
+  reason: string;
+}
+interface WrapResult {
+  files: number;
+  changed: string[];
+  wrapped: WrapEntry[];
+  skipped: WrapSkip[];
+}
+interface WrapOptions {
+  write?: boolean;
+}
+declare function wrapProject(cfg: ResolvedConfig, options?: WrapOptions): Promise<WrapResult>;
+interface WrapCodeResult {
+  code?: string;
+  wrapped: WrapEntry[];
+  skipped: WrapSkip[];
+}
+declare function wrapCode(code: string, file: string): WrapCodeResult;
+//#endregion
+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

@@ -4,6 +4,7 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, watch, writeF
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { RICH_TAGS, createVerbaly, localeDirection, normalizeLink, parse as parse$1, parseTags, safeAttribute } from "verbaly";
 import { pathToFileURL } from "node:url";
+import picomatch from "picomatch";
 import MagicString from "magic-string";
 import { glob } from "tinyglobby";
 //#region src/key.ts
@@ -273,13 +274,14 @@ function isNode(value) {
 }
 //#endregion
 //#region src/sfc.ts
-const SFC_FILE_RE = /\.(?:svelte|vue)$/;
+const SFC_FILE_RE = /\.(?:svelte|vue|astro)$/;
 function analyzeFile(code, file) {
 	return SFC_FILE_RE.test(file) ? analyzeSfc(code, file) : analyze(code, file);
 }
 const SCRIPT_RE = /(<script\b[^>]*>)([\s\S]*?)(<\/script\s*>)/gi;
 const STYLE_RE = /<style\b[^>]*>[\s\S]*?<\/style\s*>/gi;
 const COMMENT_RE = /<!--[\s\S]*?-->/g;
+const FRONTMATTER_RE = /^(\uFEFF?\s*---\r?\n)([\s\S]*?)\r?\n---(?=\r?\n|$)/;
 const CANDIDATE_SVELTE = /(?<![\w$])\$?t(?=[`(]|\.id\()/g;
 const CANDIDATE_VUE = /(?<![\w$])t(?=[`(]|\.id\()/g;
 function analyzeSfc(code, file) {
@@ -287,12 +289,14 @@ function analyzeSfc(code, file) {
 	const options = svelte ? { tNames: ["t", "$t"] } : void 0;
 	const tagged = [];
 	const usedKeys = [];
+	const frontmatter = file.endsWith(".astro") ? FRONTMATTER_RE.exec(code) : null;
+	if (frontmatter?.[2]) merge(analyzeSegment(frontmatter[2], file, options), frontmatter[1].length, false);
 	for (const match of code.matchAll(SCRIPT_RE)) {
 		const content = match[2];
 		if (!content) continue;
 		merge(analyzeSegment(content, file, options), match.index + match[1].length, false);
 	}
-	const markup = blank(blank(blank(code, SCRIPT_RE), STYLE_RE), COMMENT_RE);
+	const markup = blank(blank(blank(frontmatter ? " ".repeat(frontmatter[0].length) + code.slice(frontmatter[0].length) : code, SCRIPT_RE), STYLE_RE), COMMENT_RE);
 	const candidates = svelte ? CANDIDATE_SVELTE : CANDIDATE_VUE;
 	let consumedTo = 0;
 	for (const match of markup.matchAll(candidates)) {
@@ -467,6 +471,57 @@ function formatCheckResult(result) {
 function truncate(text, max) {
 	return text.length > max ? text.slice(0, max - 1) + "…" : text;
 }
+function githubCheckAnnotations(result, registry, root) {
+	const messages = registry.messages();
+	const contents = /* @__PURE__ */ new Map();
+	const readSource = (file) => {
+		if (!contents.has(file)) try {
+			contents.set(file, readFileSync(file, "utf8"));
+		} catch {
+			contents.set(file, void 0);
+		}
+		return contents.get(file);
+	};
+	const lines = [];
+	const byKey = /* @__PURE__ */ new Map();
+	for (const entry of result.missing) {
+		const grouped = byKey.get(entry.key);
+		if (grouped) grouped.locales.push(entry.locale);
+		else byKey.set(entry.key, {
+			...entry,
+			locales: [entry.locale]
+		});
+	}
+	for (const entry of byKey.values()) {
+		const origin = messages.get(entry.key);
+		const hint = entry.source ? `: "${truncate(entry.source, 60)}"` : "";
+		const text = escapeData(`missing [${entry.locales.join(", ")}] ${entry.key}${hint}`);
+		if (origin) {
+			const file = relative(root, origin.file).replaceAll("\\", "/");
+			const content = readSource(origin.file);
+			const line = content === void 0 ? void 0 : lineAt(content, origin.start);
+			lines.push(`::error file=${escapeProperty(file)}${line ? `,line=${line}` : ""}::${text}`);
+		} else lines.push(`::error::${text}`);
+	}
+	for (const entry of result.unknown) {
+		const text = escapeData(`unknown key "${entry.key}" (not in any catalog)`);
+		const file = entry.files[0];
+		lines.push(file ? `::error file=${escapeProperty(relative(root, file).replaceAll("\\", "/"))}::${text}` : `::error::${text}`);
+	}
+	return lines;
+}
+function lineAt(content, offset) {
+	let line = 1;
+	const end = Math.min(offset, content.length);
+	for (let i = 0; i < end; i++) if (content[i] === "\n") line += 1;
+	return line;
+}
+function escapeData(text) {
+	return text.replaceAll("%", "%25").replaceAll("\r", "%0D").replaceAll("\n", "%0A");
+}
+function escapeProperty(text) {
+	return escapeData(text).replaceAll(":", "%3A").replaceAll(",", "%2C");
+}
 //#endregion
 //#region src/params.ts
 const PLURAL_KEYS = /* @__PURE__ */ new Set([
@@ -633,12 +688,13 @@ declare module 'virtual:verbaly/locale/*' {
 }
 `;
 }
-function writeDts(cfg, catalog) {
-	const file = join(cfg.root, "verbaly.d.ts");
+function writeDts(cfg, catalog, file) {
+	file ??= join(cfg.root, "verbaly.d.ts");
 	const content = generateDts(catalog);
 	try {
 		if (readFileSync(file, "utf8") === content) return;
 	} catch {}
+	mkdirSync(dirname(file), { recursive: true });
 	writeFileSync(file, content);
 }
 //#endregion
@@ -768,15 +824,16 @@ 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,
 		dir,
 		sourceLocale,
 		locales: [...locales],
-		include: config.include ?? ["{src,app}/**/*.{js,jsx,ts,tsx,mjs,mts,svelte,vue}"],
+		include: config.include ?? ["{src,app}/**/*.{js,jsx,ts,tsx,mjs,mts,svelte,vue,astro}"],
 		exclude: config.exclude ?? ["**/node_modules/**", "**/dist/**"],
+		dts: typeof config.dts === "string" ? resolve(root, config.dts) : config.dts,
 		translate: config.translate ?? {},
 		render: config.render ?? {}
 	};
@@ -863,7 +920,7 @@ function transformCode(code, file, analysis) {
 //#region src/plugin.ts
 const RESOLVED_VIRTUAL_ID = "\0virtual:verbaly";
 const LOCALE_MODULE_PREFIX = `${RESOLVED_VIRTUAL_ID}/locale/`;
-const SOURCE_FILE_RE = /\.(?:[cm]?[jt]sx?|svelte|vue)$/;
+const SOURCE_FILE_RE = /\.(?:[cm]?[jt]sx?|svelte|vue|astro)$/;
 function resolveVirtualId(id) {
 	if (id === "virtual:verbaly" || id.startsWith(`virtual:verbaly/`)) return "\0" + id;
 }
@@ -874,6 +931,14 @@ function loadVirtualModule(id, cfg, catalogs) {
 function isTransformTarget(id) {
 	return SOURCE_FILE_RE.test(id) && !id.includes("node_modules") && !id.startsWith("\0");
 }
+function createSourceFilter(cfg) {
+	if (cfg.include.length === 0) return () => false;
+	const matches = picomatch(cfg.include, { ignore: cfg.exclude });
+	return (id) => {
+		const rel = relative(cfg.root, id).replaceAll("\\", "/");
+		return !rel.startsWith("..") && matches(rel);
+	};
+}
 function transformSource(code, id, registry) {
 	const analysis = analyzeFile(code, id);
 	registry.update(id, analysis);
@@ -974,6 +1039,7 @@ function pruneCatalogs(cfg, catalogs, registry) {
 //#endregion
 //#region src/init.ts
 const BUNDLERS = [
+	"astro",
 	"vite",
 	"webpack",
 	"rollup",
@@ -1027,7 +1093,8 @@ function init(options = {}) {
 	}
 	const bundler = detectBundler(root);
 	const next = [];
-	if (bundler === "vite") next.push("install the plugin: pnpm add -D @verbaly/vite", "add verbaly() to the plugins in vite.config");
+	if (bundler === "astro") next.push("install the integration: pnpm add -D @verbaly/astro", "add verbaly() to the integrations in astro.config");
+	else if (bundler === "vite") next.push("install the plugin: pnpm add -D @verbaly/vite", "add verbaly() to the plugins in vite.config");
 	else if (bundler) next.push("install the plugin: pnpm add -D @verbaly/unplugin", `add the verbaly ${bundler} plugin to your build config`);
 	else next.push("run \"verbaly extract\" after writing your first t`…` message");
 	return {
@@ -1100,8 +1167,8 @@ async function doctor(cfg) {
 	else if (wired) ok("plugin", `${deps["@verbaly/vite"] ? "@verbaly/vite" : "@verbaly/unplugin"} installed for ${bundler}`);
 	else if (bundler === "vite") warn("plugin", "vite detected but @verbaly/vite is not installed", "pnpm add -D @verbaly/vite and add verbaly() to the plugins in vite.config");
 	else warn("plugin", `${bundler} detected but @verbaly/unplugin is not installed`, `pnpm add -D @verbaly/unplugin and add the verbaly ${bundler} plugin to your build config`);
-	if (source) {
-		const dtsPath = join(cfg.root, "verbaly.d.ts");
+	if (source && cfg.dts !== false) {
+		const dtsPath = cfg.dts ?? join(cfg.root, "verbaly.d.ts");
 		if (!existsSync(dtsPath)) warn("types", "verbaly.d.ts has not been generated", "run `npx verbaly extract`");
 		else if (readFileSync(dtsPath, "utf8") !== generateDts(source)) warn("types", "verbaly.d.ts is stale", "run `npx verbaly extract`");
 		else ok("types", "verbaly.d.ts is up to date");
@@ -1144,6 +1211,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";
@@ -1204,10 +1331,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];
@@ -1484,7 +1613,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);
@@ -1778,9 +1909,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;
@@ -1789,7 +1921,8 @@ function status(cfg, catalogs, registry) {
 		locales.push({
 			locale,
 			translated,
-			total: needed.size
+			total: needed.size,
+			drafts: live[locale]?.length ?? 0
 		});
 	}
 	return {
@@ -1804,10 +1937,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");
 }
@@ -1853,6 +1987,218 @@ function watchProject(cfg, run, options = {}) {
 	};
 }
 //#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, detectBundler, doctor, exportCatalogs, extractProject, findConfigFile, formatCheckResult, formatStatusResult, generateDts, generateLocaleModule, generateRuntimeModule, 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, writeCatalog, writeDts };
+//#region src/wrap.ts
+const WRAP_ATTRS = /* @__PURE__ */ new Set([
+	"title",
+	"alt",
+	"placeholder",
+	"aria-label"
+]);
+const T_NAMES = /* @__PURE__ */ new Set(["t"]);
+const LETTER = /\p{L}/u;
+async function wrapProject(cfg, options = {}) {
+	const files = (await glob(cfg.include, {
+		cwd: cfg.root,
+		ignore: cfg.exclude,
+		absolute: true
+	})).filter((file) => /\.[jt]sx$/.test(file));
+	const result = {
+		files: files.length,
+		changed: [],
+		wrapped: [],
+		skipped: []
+	};
+	for (const file of files) {
+		const code = readFileSync(file, "utf8");
+		const label = relative(cfg.root, file).replaceAll("\\", "/");
+		const out = wrapCode(code, label);
+		result.wrapped.push(...out.wrapped);
+		result.skipped.push(...out.skipped);
+		if (out.code !== void 0) {
+			result.changed.push(label);
+			if (options.write) writeFileSync(file, out.code);
+		}
+	}
+	return result;
+}
+function wrapCode(code, file) {
+	const wrapped = [];
+	const skipped = [];
+	let ast;
+	try {
+		ast = parse(code, {
+			sourceType: "module",
+			errorRecovery: true,
+			plugins: ["typescript", "jsx"]
+		}).program;
+	} catch {
+		return {
+			wrapped,
+			skipped
+		};
+	}
+	const s = new MagicString(code);
+	const visited = /* @__PURE__ */ new Set();
+	let changed = false;
+	walk(ast, (node) => {
+		if (node.type !== "JSXElement" && node.type !== "JSXFragment") return;
+		if (visited.has(node)) return;
+		processElement(node);
+	});
+	return changed ? {
+		code: s.toString(),
+		wrapped,
+		skipped
+	} : {
+		wrapped,
+		skipped
+	};
+	function processElement(node) {
+		visited.add(node);
+		if (node.type === "JSXElement") {
+			const opening = node.openingElement;
+			const name = opening.name;
+			if (name.type === "JSXIdentifier" && name.name === "Trans") return markSubtree(node);
+			if (hasVerbalyAttr(opening)) return markSubtree(node);
+			wrapAttributes(opening);
+		}
+		const children = node.children ?? [];
+		const hasElementChild = children.some((c) => c.type === "JSXElement" || c.type === "JSXFragment");
+		const hasText = children.some((c) => c.type === "JSXText" && LETTER.test(c.value) || c.type === "JSXExpressionContainer" && c.expression.type === "StringLiteral" && LETTER.test(c.expression.value));
+		if (hasElementChild && hasText) {
+			skip(node, snippet(children), "mixed text and markup: wrap by hand or use <Trans>");
+			return markSubtree(node);
+		}
+		if (hasText) {
+			wrapSegment(node, children);
+			return markSubtree(node);
+		}
+		for (const child of children) if (child.type === "JSXElement" || child.type === "JSXFragment") processElement(child);
+	}
+	function wrapSegment(parent, children) {
+		const meaningful = children.filter((c) => c.type === "JSXText" && c.value.trim() !== "" || c.type === "JSXExpressionContainer" && c.expression.type !== "JSXEmptyExpression");
+		if (meaningful.length === 0) return;
+		const first = meaningful[0];
+		const last = meaningful[meaningful.length - 1];
+		let template = "";
+		let report = "";
+		for (let i = children.indexOf(first); i <= children.indexOf(last); i++) {
+			const child = children[i];
+			if (child.type === "JSXText") {
+				let value = cleanJsxText(child.value);
+				if (child === first) value = value.trimStart();
+				if (child === last) value = value.trimEnd();
+				template += escapeTemplate(value);
+				report += value;
+			} else if (child.type === "JSXExpressionContainer") {
+				const expr = child.expression;
+				if (expr.type === "JSXEmptyExpression") continue;
+				if (usesT(expr)) {
+					skip(parent, snippet(children), "already uses t: finish it by hand");
+					return;
+				}
+				if (containsJsx(expr)) {
+					skip(parent, snippet(children), "an expression renders markup: wrap by hand or use <Trans>");
+					markSubtree(child);
+					return;
+				}
+				if (expr.type === "StringLiteral") {
+					template += escapeTemplate(expr.value);
+					report += expr.value;
+				} else {
+					const source = code.slice(expr.start, expr.end);
+					template += "${" + source + "}";
+					report += "${" + source + "}";
+				}
+			} else return;
+		}
+		if (!LETTER.test(report)) return;
+		const start = first.type === "JSXText" ? first.start + leadingWs(first.value) : first.start;
+		const end = last.type === "JSXText" ? last.end - trailingWs(last.value) : last.end;
+		s.overwrite(start, end, "{t`" + template + "`}");
+		changed = true;
+		wrapped.push({
+			file,
+			line: line(first),
+			text: report,
+			kind: "text"
+		});
+	}
+	function wrapAttributes(opening) {
+		for (const attr of opening.attributes) {
+			if (attr.type !== "JSXAttribute") continue;
+			const name = attr.name;
+			if (name.type !== "JSXIdentifier" || !WRAP_ATTRS.has(name.name)) continue;
+			const value = attr.value;
+			if (value?.type !== "StringLiteral") continue;
+			const raw = value.value;
+			if (!LETTER.test(raw)) continue;
+			s.overwrite(value.start, value.end, "{t`" + escapeTemplate(raw) + "`}");
+			changed = true;
+			wrapped.push({
+				file,
+				line: line(value),
+				text: raw,
+				kind: "attribute",
+				attribute: name.name
+			});
+		}
+	}
+	function skip(node, text, reason) {
+		skipped.push({
+			file,
+			line: line(node),
+			text,
+			reason
+		});
+	}
+	function snippet(children) {
+		const start = children[0]?.start ?? 0;
+		const end = children[children.length - 1]?.end ?? start;
+		const text = code.slice(start, end).replace(/\s+/g, " ").trim();
+		return text.length > 60 ? text.slice(0, 59) + "…" : text;
+	}
+	function markSubtree(node) {
+		walk(node, (n) => {
+			if (n.type === "JSXElement" || n.type === "JSXFragment") visited.add(n);
+		});
+	}
+}
+function hasVerbalyAttr(opening) {
+	return opening.attributes.some((attr) => {
+		if (attr.type !== "JSXAttribute") return false;
+		const name = attr.name;
+		return name.type === "JSXIdentifier" && name.name.startsWith("data-verbaly");
+	});
+}
+function usesT(node) {
+	let found = false;
+	walk(node, (n) => {
+		if (n.type === "TaggedTemplateExpression" && isTReference(n.tag, T_NAMES)) found = true;
+		if (n.type === "CallExpression" && isTReference(n.callee, T_NAMES)) found = true;
+	});
+	return found;
+}
+function containsJsx(node) {
+	let found = false;
+	walk(node, (n) => {
+		if (n.type === "JSXElement" || n.type === "JSXFragment") found = true;
+	});
+	return found;
+}
+function escapeTemplate(text) {
+	return text.replace(/[\\`]/g, "\\$&").replace(/\$\{/g, "\\${");
+}
+function leadingWs(text) {
+	return text.length - text.trimStart().length;
+}
+function trailingWs(text) {
+	return text.length - text.trimEnd().length;
+}
+function line(node) {
+	return node.loc?.start?.line ?? 1;
+}
+//#endregion
+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