@verbaly/compiler 0.24.0 → 0.26.0

package/dist/index.d.ts

@@ -85,6 +85,7 @@ interface VerbalyConfig {
   locales?: string[];
   include?: string[];
   exclude?: string[];
+  dts?: string | false;
   translate?: TranslateConfig;
   render?: RenderConfig;
 }
@@ -95,6 +96,7 @@ interface ResolvedConfig {
   locales: string[];
   include: string[];
   exclude: string[];
+  dts: string | false | undefined;
   translate: TranslateConfig;
   render: RenderConfig;
 }
@@ -120,6 +122,7 @@ declare class MessageRegistry {
   remove(file: string): void;
   messages(): Map<string, TaggedMessage>;
   usedKeys(): Map<string, string[]>;
+  origins(): Map<string, string[]>;
 }
 //#endregion
 //#region src/check.d.ts
@@ -139,6 +142,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";
@@ -149,7 +153,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 {
@@ -168,6 +172,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;
@@ -197,6 +202,7 @@ interface ExportOptions {
   format?: ExportFormat;
   out?: string;
   missing?: boolean;
+  origins?: Record<string, string[]>;
 }
 interface ExportedFile {
   locale: string;
@@ -246,7 +252,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[];
 }
@@ -332,5 +338,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, 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 };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -2,8 +2,9 @@ import { parse } from "@babel/parser";
 import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, watch, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve } from "node:path";
-import { RICH_TAGS, createVerbaly, normalizeLink, parse as parse$1, parseTags, safeAttribute } from "verbaly";
+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
@@ -775,8 +831,9 @@ function resolveConfig(config = {}) {
 		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);
@@ -918,6 +983,15 @@ var MessageRegistry = class {
 		}
 		return out;
 	}
+	origins() {
+		const out = this.usedKeys();
+		for (const analysis of this.files.values()) for (const msg of analysis.tagged) {
+			const files = out.get(msg.key) ?? [];
+			if (!files.includes(msg.file)) files.push(msg.file);
+			out.set(msg.key, files);
+		}
+		return out;
+	}
 };
 //#endregion
 //#region src/extract.ts
@@ -965,6 +1039,7 @@ function pruneCatalogs(cfg, catalogs, registry) {
 //#endregion
 //#region src/init.ts
 const BUNDLERS = [
+	"astro",
 	"vite",
 	"webpack",
 	"rollup",
@@ -1018,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 {
@@ -1091,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");
@@ -1248,7 +1324,8 @@ function exportCatalogs(cfg, catalogs, options = {}) {
 		const all = Object.keys(source).filter((key) => source[key]).sort().map((key) => ({
 			key,
 			source: source[key],
-			target: catalog[key] ?? ""
+			target: catalog[key] ?? "",
+			location: options.origins?.[key]
 		}));
 		const untranslated = all.filter((entry) => !entry.target);
 		const entries = options.missing ? untranslated : all;
@@ -1344,8 +1421,13 @@ function parseExchangeFile(file, localeOverride) {
 	throw new Error(`[verbaly] ${file}: unsupported format, expected .xlf, .xliff or .csv.`);
 }
 function toXliff(sourceLocale, locale, entries) {
-	const units = entries.map(({ key, source, target }) => [
+	const units = entries.map(({ key, source, target, location }) => [
 		`    <unit id="${escapeXml(key)}">`,
+		...location?.length ? [
+			"      <notes>",
+			...location.map((file) => `        <note category="location">${escapeXml(file)}</note>`),
+			"      </notes>"
+		] : [],
 		`      <segment state="${target ? "translated" : "initial"}">`,
 		`        <source>${escapeXml(source)}</source>`,
 		`        <target>${escapeXml(target)}</target>`,
@@ -1395,8 +1477,8 @@ function unescapeXml(text) {
 }
 function toCsv(entries) {
 	return [
-		"key,source,target",
-		...entries.map(({ key, source, target }) => `${csvField(key)},${csvField(source)},${csvField(target)}`),
+		"key,source,target,location",
+		...entries.map(({ key, source, target, location }) => `${csvField(key)},${csvField(source)},${csvField(target)},${csvField(location?.join("; ") ?? "")}`),
 		""
 	].join("\r\n");
 }
@@ -1545,6 +1627,7 @@ function renderHtml(html, options) {
 		const chunkStart = m.index + 1 + rawName.length;
 		if (tagName === "html" && options.setLang !== false) {
 			setAttribute(ms, html, chunkStart, openEnd, attrChunk, "lang", options.locale);
+			setAttribute(ms, html, chunkStart, openEnd, attrChunk, "dir", localeDirection(options.locale));
 			continue;
 		}
 		const attrs = parseAttrs(attrChunk);
@@ -1837,6 +1920,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 { 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 };
 
 //# sourceMappingURL=index.js.map