@x18n/cli 0.0.13 → 0.0.15

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 import { a as out, c as runPlan, d as useColor, f as wireDiagnostics, i as openWorkspace, l as singleProject, n as displayPath, o as printJson, r as exitCodeOf, s as readInput, t as cwd, u as stdinArg } from "./context-j5IMF1tl.mjs";
 import { createRequire } from "node:module";
-import { PluginFileSchema, errors, isJsonObject, isX18nError, parseMessageBatch, placeholderProblems, renderPrompt, toErrorInfo, toWireRange, validate } from "@x18n/core";
+import { PluginFileSchema, errors, isJsonObject, isX18nError, parseMessageBatch, placeholderProblems, renderExplanation, renderPrompt, toErrorInfo, toWireRange, validate } from "@x18n/core";
 import process from "node:process";
 import { styleText } from "node:util";
 import cac from "cac";
@@ -15,7 +15,7 @@ import { existsSync } from "node:fs";
 import { namespaceFromPath } from "@x18n/builtins/finders";
 import { parse, stringify } from "yaml";
 //#region package.json
-var version = "0.0.13";
+var version = "0.0.15";
 //#endregion
 //#region src/commands/change.ts
 async function project(options) {
@@ -104,13 +104,13 @@ async function format(options) {
 }
 //#endregion
 //#region src/commands/check.ts
-function list(value) {
+function list$1(value) {
 	return value === void 0 ? [] : [value].flat().flatMap((item) => String(item).split(",")).map((item) => item.trim()).filter(Boolean);
 }
 function filterDiagnostics(diagnostics, options) {
-	const locales = list(options.locale);
-	const only = list(options.only);
-	const skip = list(options.skip);
+	const locales = list$1(options.locale);
+	const only = list$1(options.only);
+	const skip = list$1(options.skip);
 	return diagnostics.filter((d) => locales.length === 0 || d.locale === void 0 || locales.includes(d.locale) || d.code === "missing-translation" && locales.some((l) => d.message.includes(l))).filter((d) => only.length === 0 || only.includes(d.code)).filter((d) => !skip.includes(d.code)).map((d) => options.strict && d.severity === "warning" ? {
 		...d,
 		severity: "error"
@@ -138,14 +138,14 @@ function reportInputs(workspace, options) {
 function needsHistory(loaded, options) {
 	const setting = loaded.project.config.checks["stale-translation"];
 	const level = typeof setting === "string" ? setting : setting?.[0];
-	const only = list(options.only);
-	return level !== "off" && (only.length === 0 || only.includes("stale-translation")) && !list(options.skip).includes("stale-translation");
+	const only = list$1(options.only);
+	return level !== "off" && (only.length === 0 || only.includes("stale-translation")) && !list$1(options.skip).includes("stale-translation");
 }
 async function report(workspace, options) {
 	const inputs = reportInputs(workspace, options);
-	const reporterIds = list(options.reporter);
+	const reporterIds = list$1(options.reporter);
 	const ids = reporterIds.length ? reporterIds : [options.json ? "json" : "pretty"];
-	const outputs = list(options.output);
+	const outputs = list$1(options.output);
 	const available = workspace.projects[0]?.project.reporters ?? /* @__PURE__ */ new Map();
 	const roots = new Map(workspace.projects.map((p) => [p.name, p.root]));
 	for (const [i, id] of ids.entries()) {
@@ -201,7 +201,7 @@ async function readPlan(file) {
 	return data.items;
 }
 /** One question per string in a TTY: extract with the proposed key, a typed key, or skip. */
-async function review(candidates, root) {
+async function review$1(candidates, root) {
 	const rl = createInterface({
 		input: process.stdin,
 		output: process.stderr
@@ -258,7 +258,7 @@ async function extract(files, options) {
 		out(`${candidates.length} strings. Apply with \`x18n extract --yes\`, or review with \`x18n extract --plan plan.json\`.`);
 		return;
 	}
-	const chosen = interactive ? await review(candidates, loaded.root) : candidates;
+	const chosen = interactive ? await review$1(candidates, loaded.root) : candidates;
 	if (chosen.length === 0) {
 		out("Nothing to extract.");
 		return;
@@ -368,6 +368,39 @@ function locate(loaded, path, start, end) {
 		column: range.column
 	};
 }
+async function search(query, options) {
+	const workspace = await openWorkspace(options);
+	const projects = workspace.projects.map((loaded) => {
+		const { project } = loaded;
+		const { items, total, nextCursor } = page(project.search(String(query), { exact: options.exact }), options);
+		return {
+			name: loaded.name,
+			total,
+			nextCursor,
+			matches: items.map((m) => ({
+				key: m.key,
+				locale: m.locale,
+				value: m.value,
+				usages: project.usages({ key: m.key }).map((u) => ({
+					possible: u.possible,
+					...locate(loaded, u.usage.path, u.usage.range.start, u.usage.range.end)
+				}))
+			}))
+		};
+	});
+	if (options.json) {
+		printJson("search", { projects });
+		return;
+	}
+	for (const p of projects) {
+		if (workspace.projects.length > 1) out(`# ${p.name}`);
+		for (const m of p.matches) {
+			out(`${m.key}  ${m.locale}  ${JSON.stringify(m.value)}`);
+			for (const u of m.usages) out(`  ${u.file}:${u.line}:${u.column}${u.possible ? " (possible)" : ""}`);
+		}
+		if (p.nextCursor) out(`… ${p.total - Number(p.nextCursor)} more (--cursor ${p.nextCursor})`);
+	}
+}
 async function get(input, options) {
 	const workspace = await openWorkspace(options);
 	const projects = workspace.projects.flatMap((loaded) => {
@@ -390,7 +423,8 @@ async function get(input, options) {
 				raw: u.usage.raw,
 				...locate(loaded, u.usage.path, u.usage.range.start, u.usage.range.end)
 			})),
-			diagnostics: wireDiagnostics(loaded, info.diagnostics)
+			diagnostics: wireDiagnostics(loaded, info.diagnostics),
+			reviews: info.reviews
 		}];
 	});
 	if (options.json) {
@@ -405,6 +439,7 @@ async function get(input, options) {
 		out(`  ${p.usages.length} usages`);
 		for (const u of p.usages) out(`    ${u.file}:${u.line}:${u.column}${u.possible ? " (possible)" : ""}`);
 		for (const d of p.diagnostics) out(`  ${d.severity} ${d.code}: ${d.message}`);
+		for (const thread of p.reviews) out(`  review ${thread.locale}: ${thread.state ?? "resolved"}, ${thread.comments.length} comment${thread.comments.length === 1 ? "" : "s"}`);
 	}
 }
 async function usages(input, options) {
@@ -458,25 +493,7 @@ async function doctor(options) {
 		printJson("doctor", { projects });
 		return;
 	}
-	for (const e of projects) {
-		out(`# ${e.name} (${e.root})`);
-		out(`config: ${e.configFile ?? "none (detection only)"}`);
-		out(`presets:`);
-		const applied = e.presets.filter((p) => p.reason === "detected" || p.reason === "listed");
-		for (const p of applied) out(`  ✓ ${p.name} (${p.reason})`);
-		if (applied.length === 0) out("  none");
-		if (e.presets.length > applied.length) out(`  ${e.presets.length - applied.length} others not applied (--json lists them)`);
-		out("finders:");
-		for (const f of e.finders) out(`  ${f.id}: ${f.resources.length} resources${f.resources.length ? `\n    ${f.resources.slice(0, 20).join("\n    ")}` : ""}`);
-		out("formats:");
-		for (const f of e.formats.filter((f) => f.resources > 0)) out(`  ${f.id} (${f.extensions.join(", ")}): ${f.resources} resources`);
-		out("scanners:");
-		for (const s of e.scanners) out(`  ${s.id} (${s.extensions.join(", ") || "none"}): ${s.files} files`);
-		if (e.conflicts.length) out(`conflicts:\n${e.conflicts.map((c) => `  .${c.extension}: ${c.winner} wins over ${c.loser}`).join("\n")}`);
-		if (e.errors.length) out(`errors:\n${e.errors.map((err) => `  ${err.name} ${err.why}`).join("\n")}`);
-		out("config origins:");
-		for (const [key, origin] of Object.entries(e.config.origins)) out(`  ${key}: ${origin}`);
-	}
+	for (const e of projects) out(renderExplanation(e, e.configFile));
 }
 //#endregion
 //#region src/commands/migrate.ts
@@ -526,10 +543,94 @@ async function prompt(kind, options) {
 	else out(renderPrompt(data));
 }
 //#endregion
+//#region src/commands/review.ts
+const commentTypes = {
+	"comment": "comment",
+	"approve": "approve",
+	"request-change": "request-change",
+	"suggest": "suggestion"
+};
+/** `Ada <ada@example.com>`, `Ada` or `ada@example.com`. */
+function parseAuthor(input) {
+	const text = input.trim();
+	const open = text.lastIndexOf("<");
+	if (open >= 0 && text.endsWith(">")) {
+		const name = text.slice(0, open).trim();
+		return {
+			...name && { name },
+			email: text.slice(open + 1, -1).trim()
+		};
+	}
+	return text.includes("@") ? { email: text } : { name: text };
+}
+function required(value, flag) {
+	if (value === void 0 || value === "") throw errors.X18N4008({ reason: `pass ${flag}` });
+	return String(value);
+}
+async function list(target, options) {
+	const workspace = await openWorkspace(options);
+	const locale = options.locale === void 0 ? void 0 : String([options.locale].flat()[0]);
+	const projects = workspace.projects.map(({ name, project }) => ({
+		name,
+		threads: project.reviews({
+			key: target === void 0 ? void 0 : project.parseKey(target),
+			locale,
+			open: options.open
+		})
+	}));
+	if (options.json) {
+		printJson("review list", { projects });
+		return;
+	}
+	const threads = projects.flatMap((p) => p.threads);
+	if (threads.length === 0) out(options.open ? "No open reviews." : "No reviews.");
+	for (const thread of threads) {
+		out(`${thread.key}  ${thread.locale}${thread.state ? `  ${thread.state.replace("-", " ")}` : ""}`);
+		for (const c of thread.comments) {
+			const flags = [c.resolved && "resolved", c.stale && "stale"].filter(Boolean).join(", ");
+			out(`  ${c.id}  ${c.type.padEnd(14)} ${c.author?.name ?? c.author?.email ?? "-"}  ${c.time.slice(0, 10)}${flags ? `  (${flags})` : ""}`);
+			if (c.text) out(`    ${c.text}`);
+			if (c.suggestion !== void 0) out(`    suggests ${JSON.stringify(c.suggestion)}`);
+		}
+	}
+}
+/** `x18n review <action> [target]`: list, comment, approve, request-change, suggest, resolve, apply-suggestion, mark-fresh. */
+async function review(action, target, options) {
+	if (action === "list") return list(target, options);
+	const loaded = singleProject(await openWorkspace(options));
+	const { project } = loaded;
+	const locales = options.locale === void 0 ? void 0 : [options.locale].flat().map(String);
+	let op;
+	const type = commentTypes[action];
+	if (type) {
+		const locale = locales?.[0];
+		if (locale === void 0) throw errors.X18N4008({ reason: "pass --locale <locale>" });
+		op = {
+			type: "review",
+			key: project.parseKey(required(target, "<key>")),
+			locale,
+			review: type,
+			text: type === "request-change" ? required(options.text, "--text <text>") : options.text === void 0 ? void 0 : String(options.text),
+			suggestion: type === "suggestion" ? required(options.value, "--value <value>") : void 0,
+			author: options.author === void 0 ? await project.reviewAuthor() : parseAuthor(options.author)
+		};
+	} else if (action === "resolve" || action === "apply-suggestion") op = {
+		type: action === "resolve" ? "resolve-review" : "apply-suggestion",
+		id: required(target, "<id>")
+	};
+	else if (action === "mark-fresh") op = {
+		type: "mark-fresh",
+		key: project.parseKey(required(target, "<key>")),
+		locales
+	};
+	else throw errors.X18N4008({ reason: `unknown review action "${action}" (list, comment, approve, request-change, suggest, resolve, apply-suggestion, mark-fresh)` });
+	await runPlan(`review ${action}`, loaded, project.plan([op]), options);
+}
+//#endregion
 //#region src/commands/setup.ts
 async function schema(name, options) {
 	const which = name ?? "config";
-	if (which !== "config" && which !== "plugin") throw errors.X18N0001({ issue: `unknown schema "${which}" (config, plugin)` });
+	if (which !== "config" && which !== "plugin" && which !== "reviews") throw errors.X18N0001({ issue: `unknown schema "${which}" (config, plugin, reviews)` });
 	const require = createRequire(import.meta.url);
 	const text = await readFile(require.resolve(`@x18n/core/schema/${which}.json`), "utf8");
 	if (options.json) printJson("schema", {
@@ -617,7 +718,7 @@ function ejectPlugin(data) {
 	const imports = ["definePlugin", ...data.detect ? ["definePreset"] : []];
 	lines.push(`import { ${imports.join(", ")} } from '@x18n/core'`);
 	if (data.placeholders) lines.push(`import { placeholderFromShape } from '@x18n/builtins/placeholders'`);
-	if (data.scopes) lines.push(`import { regexScopes } from '@x18n/builtins/scanners'`);
+	if (data.scopes) lines.push(`import regexScopes from '@x18n/builtins/scanners/regex-scopes'`);
 	lines.push("", `const plugin = definePlugin({`, ...fields, `})`, "");
 	const plugins = `[plugin${data.scopes ? `, regexScopes(${literal(data.scopes.regex)})` : ""}]`;
 	if (data.detect) {
@@ -676,10 +777,11 @@ function createCli() {
 	cli.option("--root <dir>", "Project root (default: nearest config upward from the cwd)").option("--config <file>", "Explicit config file").option("--project <name>", "Pick one project in a monorepo").option("--json", "Print the JSON contract instead of human output").option("--no-cache", "Ignore the persistent cache").option("--yes", "Accept default answers for decisions");
 	cli.command("", "Show the status and the main commands").action(run("status", async (options) => {
 		await status(options);
-		if (!options.json) process.stdout.write("\nCommands: check, keys, get, usages, set, apply, rename, delete, fill, prompt translate, ui. Run `x18n --help` for all.\n");
+		if (!options.json) process.stdout.write("\nCommands: check, keys, search, get, usages, set, apply, rename, delete, fill, prompt translate, ui. Run `x18n --help` for all.\n");
 	}));
 	cli.command("status", "Locales with coverage, resources, keys and diagnostics").action(run("status", status));
 	cli.command("keys [glob]", "List keys").option("--missing <locale>", "Only keys missing or empty in a locale").option("--unused", "Only keys without usages").option("--namespace <ns>", "Only keys of a namespace").option("--values", "Include the value per locale").option("--limit <n>", "Page size").option("--cursor <cursor>", "Start of the page (from `nextCursor`)").action(run("keys", keys));
+	cli.command("search <query>", "Find keys by their value in any locale, with their usages").option("--exact", "Only values containing the query, instead of a fuzzy match").option("--limit <n>", "Page size").option("--cursor <cursor>", "Start of the page").action(run("search", search));
 	cli.command("get <key>", "Values, resources, usages and diagnostics of one key").action(run("get", get));
 	cli.command("usages [key]", "Usages of a key, or all usages").option("--file <path>", "Only usages in a file").option("--limit <n>", "Page size").option("--cursor <cursor>", "Start of the page").action(run("usages", usages));
 	cli.command("locales", "Locale codes as found, with display names and resources").action(run("locales", locales));
@@ -693,12 +795,13 @@ function createCli() {
 	cli.command("format", "Re-write resources with the configured sort and indent").option("--dry-run", "Print the plan instead of writing").action(run("format", format));
 	cli.command("extract [...files]", "Find hard-coded strings and turn them into keys").option("--list", "Print candidates and proposed keys").option("--plan <file>", "Write the extraction plan to a file to edit").option("--apply <file>", "Apply an (edited) extraction plan").option("--dry-run", "Print the plan instead of writing").action(run("extract", extract));
 	cli.command("prompt <kind>", "Print a prompt for an agent or LLM: `prompt translate --to <locale>` or `prompt review --locale <locale>`").option("--to <locale>", "Target locale (translate)").option("--locale <locale>", "Locale to review").option("--keys <glob>", "Only keys matching a glob").option("--namespace <ns>", "Only keys of a namespace").option("--limit <n>", "Messages per prompt (default 50)").option("--cursor <cursor>", "Continue from `nextCursor`").option("--format <format>", "markdown (default) or json").option("--no-context", "Leave out code around usages").option("--stale", "Also translate stale translations (needs git history)").action(run("prompt", prompt));
+	cli.command("review <action> [target]", "Reviews: `list [key]`, `comment|approve|request-change|suggest <key>`, `resolve|apply-suggestion <id>`, `mark-fresh <key>`").option("--locale <locale>", "Locale of the message (repeatable for mark-fresh)").option("--text <text>", "Comment text").option("--value <value>", "Suggested value (suggest)").option("--author <author>", "Author as `Name <email>` (default: review.author, then git user)").option("--open", "Only unresolved reviews (list)").option("--dry-run", "Print the plan instead of writing").action(run("review", review));
 	cli.command("ui", "Start the UI: browse and edit messages in the browser, with HTTP MCP at /__mcp").option("--port <port>", "Port (default: a free one from 9999)").option("--host <host>", "Bind host (default: localhost)").option("--no-open", "Do not open the browser").option("--no-auth", "Skip authentication (CI and e2e only)").action(run("ui", async (options) => (await uiCommands()).ui(options)));
 	cli.command("build", "Write a static, read-only report of the UI").option("--out-dir <dir>", "Output directory (default: .x18n/report)").action(run("build", async (options) => (await uiCommands()).build(options)));
 	cli.command("mcp", "Serve the MCP tools over stdio").action(run("mcp", async (options) => (await uiCommands()).mcp(options)));
 	cli.command("init", "Detect the setup and write x18n.config.ts").option("--format <format>", "ts (default), yml or json").option("--force", "Replace an existing config").action(run("init", init));
 	cli.command("migrate <source>", "Convert i18n-ally settings: `migrate i18n-ally`").option("--format <format>", "ts (default), yml or json").option("--dry-run", "Print the files instead of writing").option("--force", "Replace an existing config").action(run("migrate", migrate));
-	cli.command("schema [name]", "Print a JSON Schema: config (default) or plugin").action(run("schema", schema));
+	cli.command("schema [name]", "Print a JSON Schema: config (default), plugin or reviews").action(run("schema", schema));
 	cli.command("plugin <action> <file>", "Plugin tools: `plugin eject <file.yml>` prints the TS equivalent").action(run("plugin eject", async (action, file, options) => {
 		if (action !== "eject") throw new Error(`unknown plugin action "${action}"`);
 		await eject(file, options);

package/dist/presets.d.mts

@@ -1 +1,44 @@
-export * from "@x18n/builtins/presets";
+import { cargoI18n } from "@x18n/builtins/presets/cargo-i18n";
+import { chromeExtension } from "@x18n/builtins/presets/chrome-extension";
+import { dotnetResx } from "@x18n/builtins/presets/dotnet-resx";
+import { easyLocalization } from "@x18n/builtins/presets/easy-localization";
+import { emberIntl } from "@x18n/builtins/presets/ember-intl";
+import { fluentReact } from "@x18n/builtins/presets/fluent-react";
+import { fluentVue } from "@x18n/builtins/presets/fluent-vue";
+import { flutter } from "@x18n/builtins/presets/flutter";
+import { flutterTranslate } from "@x18n/builtins/presets/flutter-translate";
+import { general } from "@x18n/builtins/presets/general";
+import { globalize } from "@x18n/builtins/presets/globalize";
+import { gravityUiI18n } from "@x18n/builtins/presets/gravity-ui-i18n";
+import { i18nTag } from "@x18n/builtins/presets/i18n-tag";
+import { i18next } from "@x18n/builtins/presets/i18next";
+import { i18nextShopify } from "@x18n/builtins/presets/i18next-shopify";
+import { i18nice } from "@x18n/builtins/presets/i18nice";
+import { jekyll } from "@x18n/builtins/presets/jekyll";
+import { laravel } from "@x18n/builtins/presets/laravel";
+import { laravelVueI18n } from "@x18n/builtins/presets/laravel-vue-i18n";
+import { lingui } from "@x18n/builtins/presets/lingui";
+import { nextInternational } from "@x18n/builtins/presets/next-international";
+import { nextIntl } from "@x18n/builtins/presets/next-intl";
+import { nextTranslate } from "@x18n/builtins/presets/next-translate";
+import { ngxTranslate } from "@x18n/builtins/presets/ngx-translate";
+import { nuxtI18n } from "@x18n/builtins/presets/nuxt-i18n";
+import { nuxtI18nMicro } from "@x18n/builtins/presets/nuxt-i18n-micro";
+import { paraglide } from "@x18n/builtins/presets/paraglide";
+import { phpGettext } from "@x18n/builtins/presets/php-gettext";
+import { phpJoomla } from "@x18n/builtins/presets/php-joomla";
+import { polyglot } from "@x18n/builtins/presets/polyglot";
+import { pythonGettext } from "@x18n/builtins/presets/python-gettext";
+import { reactI18next } from "@x18n/builtins/presets/react-i18next";
+import { reactIntl } from "@x18n/builtins/presets/react-intl";
+import { rubyI18nJs } from "@x18n/builtins/presets/ruby-i18n-js";
+import { railsLazyKey, rubyRails } from "@x18n/builtins/presets/ruby-rails";
+import { solidPrimitivesI18n } from "@x18n/builtins/presets/solid-primitives-i18n";
+import { svelteI18n } from "@x18n/builtins/presets/svelte-i18n";
+import { svelteI18next } from "@x18n/builtins/presets/svelte-i18next";
+import { transloco } from "@x18n/builtins/presets/transloco";
+import { typesafeI18n } from "@x18n/builtins/presets/typesafe-i18n";
+import { ui5 } from "@x18n/builtins/presets/ui5";
+import { vscodeExtension } from "@x18n/builtins/presets/vscode-extension";
+import { vueI18n } from "@x18n/builtins/presets/vue-i18n";
+export { cargoI18n, chromeExtension, dotnetResx, easyLocalization, emberIntl, fluentReact, fluentVue, flutter, flutterTranslate, general, globalize, gravityUiI18n, i18nTag, i18next, i18nextShopify, i18nice, jekyll, laravel, laravelVueI18n, lingui, nextInternational, nextIntl, nextTranslate, ngxTranslate, nuxtI18n, nuxtI18nMicro, paraglide, phpGettext, phpJoomla, polyglot, pythonGettext, railsLazyKey, reactI18next, reactIntl, rubyI18nJs, rubyRails, solidPrimitivesI18n, svelteI18n, svelteI18next, transloco, typesafeI18n, ui5, vscodeExtension, vueI18n };

package/dist/presets.mjs

@@ -1,2 +1,44 @@
-export * from "@x18n/builtins/presets";
-export {};
+import { cargoI18n } from "@x18n/builtins/presets/cargo-i18n";
+import { chromeExtension } from "@x18n/builtins/presets/chrome-extension";
+import { dotnetResx } from "@x18n/builtins/presets/dotnet-resx";
+import { easyLocalization } from "@x18n/builtins/presets/easy-localization";
+import { emberIntl } from "@x18n/builtins/presets/ember-intl";
+import { fluentReact } from "@x18n/builtins/presets/fluent-react";
+import { fluentVue } from "@x18n/builtins/presets/fluent-vue";
+import { flutter } from "@x18n/builtins/presets/flutter";
+import { flutterTranslate } from "@x18n/builtins/presets/flutter-translate";
+import { general } from "@x18n/builtins/presets/general";
+import { globalize } from "@x18n/builtins/presets/globalize";
+import { gravityUiI18n } from "@x18n/builtins/presets/gravity-ui-i18n";
+import { i18nTag } from "@x18n/builtins/presets/i18n-tag";
+import { i18next } from "@x18n/builtins/presets/i18next";
+import { i18nextShopify } from "@x18n/builtins/presets/i18next-shopify";
+import { i18nice } from "@x18n/builtins/presets/i18nice";
+import { jekyll } from "@x18n/builtins/presets/jekyll";
+import { laravel } from "@x18n/builtins/presets/laravel";
+import { laravelVueI18n } from "@x18n/builtins/presets/laravel-vue-i18n";
+import { lingui } from "@x18n/builtins/presets/lingui";
+import { nextInternational } from "@x18n/builtins/presets/next-international";
+import { nextIntl } from "@x18n/builtins/presets/next-intl";
+import { nextTranslate } from "@x18n/builtins/presets/next-translate";
+import { ngxTranslate } from "@x18n/builtins/presets/ngx-translate";
+import { nuxtI18n } from "@x18n/builtins/presets/nuxt-i18n";
+import { nuxtI18nMicro } from "@x18n/builtins/presets/nuxt-i18n-micro";
+import { paraglide } from "@x18n/builtins/presets/paraglide";
+import { phpGettext } from "@x18n/builtins/presets/php-gettext";
+import { phpJoomla } from "@x18n/builtins/presets/php-joomla";
+import { polyglot } from "@x18n/builtins/presets/polyglot";
+import { pythonGettext } from "@x18n/builtins/presets/python-gettext";
+import { reactI18next } from "@x18n/builtins/presets/react-i18next";
+import { reactIntl } from "@x18n/builtins/presets/react-intl";
+import { rubyI18nJs } from "@x18n/builtins/presets/ruby-i18n-js";
+import { railsLazyKey, rubyRails } from "@x18n/builtins/presets/ruby-rails";
+import { solidPrimitivesI18n } from "@x18n/builtins/presets/solid-primitives-i18n";
+import { svelteI18n } from "@x18n/builtins/presets/svelte-i18n";
+import { svelteI18next } from "@x18n/builtins/presets/svelte-i18next";
+import { transloco } from "@x18n/builtins/presets/transloco";
+import { typesafeI18n } from "@x18n/builtins/presets/typesafe-i18n";
+import { ui5 } from "@x18n/builtins/presets/ui5";
+import { vscodeExtension } from "@x18n/builtins/presets/vscode-extension";
+import { vueI18n } from "@x18n/builtins/presets/vue-i18n";
+export { cargoI18n, chromeExtension, dotnetResx, easyLocalization, emberIntl, fluentReact, fluentVue, flutter, flutterTranslate, general, globalize, gravityUiI18n, i18nTag, i18next, i18nextShopify, i18nice, jekyll, laravel, laravelVueI18n, lingui, nextInternational, nextIntl, nextTranslate, ngxTranslate, nuxtI18n, nuxtI18nMicro, paraglide, phpGettext, phpJoomla, polyglot, pythonGettext, railsLazyKey, reactI18next, reactIntl, rubyI18nJs, rubyRails, solidPrimitivesI18n, svelteI18n, svelteI18next, transloco, typesafeI18n, ui5, vscodeExtension, vueI18n };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@x18n/cli",
   "type": "module",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Manage and view i18n files of any project, for humans and agents",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -38,10 +38,10 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@x18n/builtins": "0.0.13",
-    "@x18n/core": "0.0.13",
-    "@x18n/node": "0.0.13",
-    "@x18n/ui": "0.0.13",
+    "@x18n/builtins": "0.0.15",
+    "@x18n/core": "0.0.15",
+    "@x18n/node": "0.0.15",
+    "@x18n/ui": "0.0.15",
     "cac": "^7.1.0",
     "devframe": "^1.2.6",
     "nostics": "^1.3.0",

package/skills/x18n/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: x18n
-description: Manage a project's translations with x18n (`@x18n/cli`). Use when the task touches locale files or translation keys - adding, renaming or deleting keys, finding missing or unused keys, translating missing messages, reviewing translations, extracting hard-coded strings, keeping a glossary of terms.
+description: Manage a project's translations with x18n (`@x18n/cli`). Use when the task touches locale files or translation keys - adding, renaming or deleting keys, finding the key behind a text shown in the app, finding missing or unused keys, translating missing messages, reviewing translations, extracting hard-coded strings, keeping a glossary of terms.
 ---
 
 # x18n
@@ -23,7 +23,7 @@ Batch the questions into one message. Routine work needs no question: adding a k
 ## Rules
 
 - Change locale files through `x18n set`, `x18n apply`, `x18n rename` and `x18n delete`. The config file (`x18n.config.ts`) is the one i18n file you edit by hand.
-- Check a key before you use it in code: `x18n get <key> --json`. Reuse an existing key with the same meaning.
+- Check a key before you use it in code: `x18n get <key> --json`. Reuse an existing key with the same meaning: `x18n search "<text>" --json` finds keys whose value already says it.
 - Keep every placeholder of the source message (`{name}`, `{{count}}`, `%{name}`, `:name`, `%s`, `@:key`).
 - Pass `--json` and read the envelope `{ "x18n": 2, "command", "data", "diagnostics", "errors" }`.
 - Run renames and deletes with `--dry-run` first, and read the plan.
@@ -85,9 +85,16 @@ import { defineConfig } from '@x18n/core'
 
 export default defineConfig({
   glossary: [
-    { term: 'Workspace', translations: { de: 'Arbeitsbereich', fr: 'Espace de travail' } },
+    {
+      term: 'Workspace',
+      translations: { de: 'Arbeitsbereich', fr: 'Espace de travail' }
+    },
     { term: 'x18n', doNotTranslate: true },
-    { term: 'Save', translations: { de: 'Speichern' }, note: 'The button label, not "rescue"' },
+    {
+      term: 'Save',
+      translations: { de: 'Speichern' },
+      note: 'The button label, not "rescue"'
+    },
   ],
   checks: { glossary: 'warning' },
 })
@@ -101,15 +108,27 @@ Maintain it while you work:
 
 ## Loops
 
+### Find the key behind a text
+
+When the user names a text they see in the app, and not a key, search the values:
+
+```sh
+x18n search "Sign in" --json
+x18n search "Anmelden" --exact --json
+```
+
+The search covers every locale and ignores case. It is fuzzy by default, and values that contain the query rank first. `--exact` keeps only those. Each match in `data.projects[].matches` has `key`, `locale`, `value` and `usages` (`file`, `line`, `column`), so you can open the code that shows the text.
+
 ### Add a key while coding
 
 ```sh
+x18n search "Settings" --exact --json
 x18n get settings.title --json
 x18n set settings.title --value "Settings" --json
 x18n keys --missing de --json --limit 50
 ```
 
-`x18n set` without `--locale` writes the source locale. Then use the key in code, for example `t('settings.title')`.
+Reuse a key that `x18n search` finds with the same meaning. `x18n set` without `--locale` writes the source locale. Then use the key in code, for example `t('settings.title')`.
 
 ### Translate missing messages
 
@@ -132,7 +151,14 @@ x18n check --only placeholder-mismatch,invalid-syntax,glossary --locale de --jso
 x18n prompt review --locale de --limit 50
 ```
 
-Fix wrong values with `x18n set <key> --locale de --value <text> --json`, and list what you changed and why.
+Do not change values yourself. For each wrong translation, leave a review for a human to accept, then list what you reviewed:
+
+```sh
+x18n review suggest <key> --locale de --value <better text> --text <why> --json
+x18n review request-change <key> --locale de --text <why> --json
+```
+
+Keep every placeholder in a suggested value. `x18n review list --locale de --open --json` shows the open reviews. Only when the user asks, apply one with `x18n review apply-suggestion <id> --json`. When reviews are off (`review.enabled: false`, error X18N5003), fix values with `x18n set <key> --locale de --value <text> --json` instead.
 
 ### Clean up
 

package/skills/x18n-setup/references/migrate-i18n-ally.md

@@ -11,11 +11,11 @@ Use this when a project has i18n-ally settings: `i18n-ally.*`, legacy `vue-i18n-
    - `languageTagSystem` is dropped: x18n uses locale codes exactly as they appear in file names.
    - A custom framework with `monopoly: true` turns the built-in presets off (`presets: []`).
    - Executed JS/TS locale files become read-only (`execute: true`).
-   - Reviews move to `.x18n/reviews.yml`, which x18n reads once reviews ship.
+   - Reviews are converted to `.x18n/reviews.yml`; key descriptions and `review.removeCommentOnResolved` are dropped.
    - The config format: `x18n.config.ts` by default, or `--format yml` / `--format json` for projects without Node.js tooling.
 4. Write the files: `x18n migrate i18n-ally --json` (add `--format yml` if the user chose YAML; `--force` replaces an existing x18n config). It writes:
    - `x18n.config.ts` (or `.yml`, `.json`) from the project settings
-   - `x18n/custom.x18n-plugin.yml`, when there are custom regexes, a custom framework, refactor templates or `localeCountryMap` flags
+   - `.x18n/custom.x18n-plugin.yml`, when there are custom regexes, a custom framework, refactor templates or `localeCountryMap` flags
    - editor settings in `.vscode/settings.json`: `x18n.displayLocale`, `x18n.annotationInPlace`, `x18n.annotations`, `x18n.annotationMaxLength`, `x18n.showFlags`
    - `.x18n/reviews.yml`, when `.vscode/i18n-ally-reviews.yml` or `.vscode/i18n-ally-next-reviews.yml` exists