@verbaly/compiler 0.16.0 → 0.17.0

package/dist/{claude-Bi_Ex2hm.js → claude-mpjdqqnY.js}

@@ -1,3 +1,4 @@
+import { t as isModuleNotFound } from "./cli.js";
 //#region src/providers/claude.ts
 const DEFAULT_MODEL = "claude-sonnet-5";
 const SYSTEM = `You translate UI strings for the Verbaly i18n library.
@@ -44,10 +45,7 @@ async function loadSdk(load = () => import("@anthropic-ai/sdk")) {
 		throw error;
 	}
 }
-function isModuleNotFound(error, name) {
-	return error instanceof Error && error.code === "ERR_MODULE_NOT_FOUND" && error.message.includes(name);
-}
 //#endregion
 export { claudeProvider };
 
-//# sourceMappingURL=claude-Bi_Ex2hm.js.map
+//# sourceMappingURL=claude-mpjdqqnY.js.map

package/dist/claude-mpjdqqnY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-mpjdqqnY.js","names":[],"sources":["../src/providers/claude.ts"],"sourcesContent":["import { isModuleNotFound } from '../config';\nimport type { TranslateProvider, TranslateRequest } from '../translate';\n\nexport interface ClaudeProviderOptions {\n  model?: string;\n  apiKey?: string;\n  maxTokens?: number;\n}\n\n// balanced default for translation\nconst DEFAULT_MODEL = 'claude-sonnet-5';\n\nconst SYSTEM = `You translate UI strings for the Verbaly i18n library.\nRules:\n- Translate only the human-readable text, naturally for the target locale.\n- Preserve verbatim: placeholders like {name}, format specs like {price:currency/EUR}, variant blocks like {count | one: ... | other: # ...} (translate only the text inside each variant, keep keys and # as-is), ICU syntax, named tags like <em>...</em> and escapes {{ }} || ##.\n- Keys are opaque identifiers: return exactly the same keys, never translate or rename them.`;\n\nexport function claudeProvider(options: ClaudeProviderOptions = {}): TranslateProvider {\n  return async (request: TranslateRequest) => {\n    const Anthropic = await loadSdk();\n    const client = new Anthropic(options.apiKey ? { apiKey: options.apiKey } : {});\n    const response = await client.messages.create({\n      model: options.model ?? DEFAULT_MODEL,\n      max_tokens: options.maxTokens ?? 16000,\n      thinking: { type: 'disabled' },\n      system: SYSTEM,\n      messages: [{ role: 'user', content: buildPrompt(request) }],\n      output_config: { format: batchFormat(request) },\n    });\n    const text = response.content.find((block) => block.type === 'text')?.text ?? '{}';\n    return JSON.parse(text) as Record<string, string>;\n  };\n}\n\nexport function buildPrompt(request: TranslateRequest): string {\n  return (\n    `Translate each value from \"${request.sourceLocale}\" to \"${request.targetLocale}\". ` +\n    `Return a JSON object with the same keys and translated values.\\n\\n` +\n    JSON.stringify(request.messages, null, 2)\n  );\n}\n\nexport function batchFormat(request: TranslateRequest) {\n  const keys = Object.keys(request.messages);\n  return {\n    type: 'json_schema' as const,\n    schema: {\n      type: 'object',\n      properties: Object.fromEntries(keys.map((key) => [key, { type: 'string' }])),\n      required: keys,\n      additionalProperties: false,\n    },\n  };\n}\n\ntype SdkModule = { default: typeof import('@anthropic-ai/sdk').default };\n\n// injectable for tests\nexport async function loadSdk(\n  load: () => Promise<SdkModule> = () => import('@anthropic-ai/sdk'),\n): Promise<SdkModule['default']> {\n  try {\n    const mod = await load();\n    return mod.default;\n  } catch (error) {\n    if (isModuleNotFound(error, '@anthropic-ai/sdk')) {\n      throw new Error(\n        '[verbaly] the claude translate provider needs @anthropic-ai/sdk — install it as a dev dependency (e.g. `pnpm add -D @anthropic-ai/sdk` / `npm i -D @anthropic-ai/sdk`) and set ANTHROPIC_API_KEY',\n        { cause: error },\n      );\n    }\n    throw error;\n  }\n}\n\n"],"mappings":";;AAUA,MAAM,gBAAgB;AAEtB,MAAM,SAAS;;;;;AAMf,SAAgB,eAAe,UAAiC,CAAC,GAAsB;CACrF,OAAO,OAAO,YAA8B;EAW1C,MAAM,QAAO,MARU,KADJ,OADK,QAAQ,IACH,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC,CAChD,CAAC,CAAC,SAAS,OAAO;GAC5C,OAAO,QAAQ,SAAS;GACxB,YAAY,QAAQ,aAAa;GACjC,UAAU,EAAE,MAAM,WAAW;GAC7B,QAAQ;GACR,UAAU,CAAC;IAAE,MAAM;IAAQ,SAAS,YAAY,OAAO;GAAE,CAAC;GAC1D,eAAe,EAAE,QAAQ,YAAY,OAAO,EAAE;EAChD,CAAC,EAAA,CACqB,QAAQ,MAAM,UAAU,MAAM,SAAS,MAAM,CAAC,EAAE,QAAQ;EAC9E,OAAO,KAAK,MAAM,IAAI;CACxB;AACF;AAEA,SAAgB,YAAY,SAAmC;CAC7D,OACE,8BAA8B,QAAQ,aAAa,QAAQ,QAAQ,aAAa,yEAEhF,KAAK,UAAU,QAAQ,UAAU,MAAM,CAAC;AAE5C;AAEA,SAAgB,YAAY,SAA2B;CACrD,MAAM,OAAO,OAAO,KAAK,QAAQ,QAAQ;CACzC,OAAO;EACL,MAAM;EACN,QAAQ;GACN,MAAM;GACN,YAAY,OAAO,YAAY,KAAK,KAAK,QAAQ,CAAC,KAAK,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC;GAC3E,UAAU;GACV,sBAAsB;EACxB;CACF;AACF;AAKA,eAAsB,QACpB,aAAuC,OAAO,sBACf;CAC/B,IAAI;EAEF,QAAO,MADW,KAAK,EAAA,CACZ;CACb,SAAS,OAAO;EACd,IAAI,iBAAiB,OAAO,mBAAmB,GAC7C,MAAM,IAAI,MACR,oMACA,EAAE,OAAO,MAAM,CACjB;EAEF,MAAM;CACR;AACF"}

package/dist/cli.js

@@ -159,6 +159,9 @@ ${lines.join("\n")}
   export function createInstance(
     options?: import('verbaly').VerbalyOptions<VerbalyKey>,
   ): import('verbaly').Verbaly<VerbalyKey>;
+  export function createRequestInstance(
+    locale: string,
+  ): Promise<import('verbaly').Verbaly<VerbalyKey>>;
 
   export function t<K extends VerbalyKey>(
     key: K,
@@ -186,6 +189,125 @@ function writeDts(cfg, entries) {
 	writeFileSync(join(cfg.root, "verbaly.d.ts"), generateDts(entries));
 }
 //#endregion
+//#region src/pseudo.ts
+const PSEUDO_LOCALE = "en-XA";
+const ACCENTS = {
+	a: "á",
+	b: "ƀ",
+	c: "ç",
+	d: "đ",
+	e: "é",
+	f: "ƒ",
+	g: "ğ",
+	h: "ĥ",
+	i: "í",
+	j: "ĵ",
+	k: "ķ",
+	l: "ĺ",
+	m: "ɱ",
+	n: "ñ",
+	o: "ó",
+	p: "þ",
+	q: "ǫ",
+	r: "ŕ",
+	s: "š",
+	t: "ţ",
+	u: "ú",
+	v: "ṽ",
+	w: "ŵ",
+	x: "ẋ",
+	y: "ý",
+	z: "ž",
+	A: "Á",
+	B: "Ɓ",
+	C: "Ç",
+	D: "Đ",
+	E: "É",
+	F: "Ƒ",
+	G: "Ğ",
+	H: "Ĥ",
+	I: "Í",
+	J: "Ĵ",
+	K: "Ķ",
+	L: "Ĺ",
+	M: "Ḿ",
+	N: "Ñ",
+	O: "Ó",
+	P: "Þ",
+	Q: "Ǫ",
+	R: "Ŕ",
+	S: "Š",
+	T: "Ţ",
+	U: "Ú",
+	V: "Ṽ",
+	W: "Ŵ",
+	X: "Ẍ",
+	Y: "Ý",
+	Z: "Ž"
+};
+const TAG_AT = /<\/?[a-zA-Z][\w-]*\/?>/y;
+function pseudoLocalize(message) {
+	let out = "";
+	let letters = 0;
+	let i = 0;
+	while (i < message.length) {
+		const two = message.slice(i, i + 2);
+		if (two === "{{" || two === "}}" || two === "||" || two === "##") {
+			out += two;
+			i += 2;
+			continue;
+		}
+		const ch = message[i];
+		if (ch === "{") {
+			const end = matchBrace(message, i);
+			out += message.slice(i, end);
+			i = end;
+			continue;
+		}
+		if (ch === "<") {
+			TAG_AT.lastIndex = i;
+			const m = TAG_AT.exec(message);
+			if (m) {
+				out += m[0];
+				i += m[0].length;
+				continue;
+			}
+		}
+		const mapped = ACCENTS[ch];
+		if (mapped) {
+			out += mapped;
+			letters += 1;
+		} else out += ch;
+		i += 1;
+	}
+	const pad = "~".repeat(Math.ceil(letters / 3));
+	return `⟦${out}${pad ? " " + pad : ""}⟧`;
+}
+function matchBrace(message, start) {
+	let depth = 0;
+	for (let i = start; i < message.length; i++) {
+		const two = message.slice(i, i + 2);
+		if (two === "{{" || two === "}}") {
+			i += 1;
+			continue;
+		}
+		const ch = message[i];
+		if (ch === "{") depth += 1;
+		else if (ch === "}") {
+			depth -= 1;
+			if (depth === 0) return i + 1;
+		}
+	}
+	return message.length;
+}
+function pseudoCatalogs(cfg, catalogs, locale = PSEUDO_LOCALE) {
+	const source = catalogs[cfg.sourceLocale] ?? {};
+	const target = {};
+	for (const [key, msg] of Object.entries(source)) target[key] = msg ? pseudoLocalize(msg) : "";
+	catalogs[locale] = target;
+	return Object.keys(target).filter((key) => target[key]);
+}
+//#endregion
 //#region src/config.ts
 function resolveConfig(config = {}) {
 	const root = resolve(config.root ?? process.cwd());
@@ -193,7 +315,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")) locales.add(file.slice(0, -5));
+		for (const file of readdirSync(dir)) if (file.endsWith(".json") && file !== `en-XA.json`) locales.add(file.slice(0, -5));
 	}
 	return {
 		root,
@@ -242,6 +364,9 @@ async function loadTsConfig(path) {
 function isModuleNotFound(error, name) {
 	return error instanceof Error && error.code === "ERR_MODULE_NOT_FOUND" && error.message.includes(name);
 }
+function targetLocales(cfg, override) {
+	return (override ?? cfg.locales).filter((locale) => locale !== cfg.sourceLocale && cfg.locales.includes(locale));
+}
 async function loadConfig(root, overrides = {}) {
 	return resolveConfig({
 		...await loadConfigFile(root),
@@ -395,7 +520,7 @@ function buildTransMessage(code, children) {
 				text += escapeText(expr.value);
 				continue;
 			}
-			if (expr.type === "TaggedTemplateExpression") return void 0;
+			if (containsTaggedT(expr)) return void 0;
 			const source = code.slice(expr.start, expr.end);
 			const name = uniqueName(deriveName(expr, params.length), source, takenParams);
 			params.push({
@@ -448,6 +573,15 @@ function selfClosedSource(code, opening) {
 	const src = code.slice(opening.start, opening.end);
 	return src.endsWith("/>") ? src : `${src.slice(0, -1).trimEnd()} />`;
 }
+function containsTaggedT(node) {
+	let found = false;
+	walk(node, (n) => {
+		if (n.type !== "TaggedTemplateExpression") return;
+		const tag = n.tag;
+		if (isTReference(tag) || explicitId(tag)) found = true;
+	});
+	return found;
+}
 function isTReference(node) {
 	if (node.type === "Identifier") return node.name === "t";
 	if (node.type === "MemberExpression" && !node.computed) {
@@ -465,6 +599,7 @@ function buildMessage(code, quasi) {
 	for (let i = 0; i < expressions.length; i++) {
 		const expr = expressions[i];
 		if (!expr) return void 0;
+		if (containsTaggedT(expr)) return void 0;
 		const source = code.slice(expr.start, expr.end);
 		const name = uniqueName(deriveName(expr, i), source, taken);
 		params.push({
@@ -768,7 +903,7 @@ function readDeps(root) {
 //#region src/translate.ts
 async function translateCatalogs(cfg, catalogs, provider, options = {}) {
 	const batchSize = options.batchSize ?? 20;
-	const targets = (options.locales ?? cfg.locales).filter((locale) => locale !== cfg.sourceLocale && cfg.locales.includes(locale));
+	const targets = targetLocales(cfg, options.locales);
 	const source = catalogs[cfg.sourceLocale] ?? {};
 	const result = {
 		translated: {},
@@ -827,7 +962,7 @@ function exportCatalogs(cfg, catalogs, options = {}) {
 	const format = options.format ?? "xliff";
 	const dir = resolve(cfg.root, options.out ?? "verbaly-export");
 	const source = catalogs[cfg.sourceLocale] ?? {};
-	const targets = (options.locales ?? cfg.locales).filter((locale) => locale !== cfg.sourceLocale && cfg.locales.includes(locale));
+	const targets = targetLocales(cfg, options.locales);
 	const files = [];
 	mkdirSync(dir, { recursive: true });
 	for (const locale of targets) {
@@ -1006,125 +1141,6 @@ function csvRows(content) {
 	return rows;
 }
 //#endregion
-//#region src/pseudo.ts
-const PSEUDO_LOCALE = "en-XA";
-const ACCENTS = {
-	a: "á",
-	b: "ƀ",
-	c: "ç",
-	d: "đ",
-	e: "é",
-	f: "ƒ",
-	g: "ğ",
-	h: "ĥ",
-	i: "í",
-	j: "ĵ",
-	k: "ķ",
-	l: "ĺ",
-	m: "ɱ",
-	n: "ñ",
-	o: "ó",
-	p: "þ",
-	q: "ǫ",
-	r: "ŕ",
-	s: "š",
-	t: "ţ",
-	u: "ú",
-	v: "ṽ",
-	w: "ŵ",
-	x: "ẋ",
-	y: "ý",
-	z: "ž",
-	A: "Á",
-	B: "Ɓ",
-	C: "Ç",
-	D: "Đ",
-	E: "É",
-	F: "Ƒ",
-	G: "Ğ",
-	H: "Ĥ",
-	I: "Í",
-	J: "Ĵ",
-	K: "Ķ",
-	L: "Ĺ",
-	M: "Ḿ",
-	N: "Ñ",
-	O: "Ó",
-	P: "Þ",
-	Q: "Ǫ",
-	R: "Ŕ",
-	S: "Š",
-	T: "Ţ",
-	U: "Ú",
-	V: "Ṽ",
-	W: "Ŵ",
-	X: "Ẍ",
-	Y: "Ý",
-	Z: "Ž"
-};
-const TAG_AT = /<\/?[a-zA-Z][\w-]*\/?>/y;
-function pseudoLocalize(message) {
-	let out = "";
-	let letters = 0;
-	let i = 0;
-	while (i < message.length) {
-		const two = message.slice(i, i + 2);
-		if (two === "{{" || two === "}}" || two === "||" || two === "##") {
-			out += two;
-			i += 2;
-			continue;
-		}
-		const ch = message[i];
-		if (ch === "{") {
-			const end = matchBrace(message, i);
-			out += message.slice(i, end);
-			i = end;
-			continue;
-		}
-		if (ch === "<") {
-			TAG_AT.lastIndex = i;
-			const m = TAG_AT.exec(message);
-			if (m) {
-				out += m[0];
-				i += m[0].length;
-				continue;
-			}
-		}
-		const mapped = ACCENTS[ch];
-		if (mapped) {
-			out += mapped;
-			letters += 1;
-		} else out += ch;
-		i += 1;
-	}
-	const pad = "~".repeat(Math.ceil(letters / 3));
-	return `⟦${out}${pad ? " " + pad : ""}⟧`;
-}
-function matchBrace(message, start) {
-	let depth = 0;
-	for (let i = start; i < message.length; i++) {
-		const two = message.slice(i, i + 2);
-		if (two === "{{" || two === "}}") {
-			i += 1;
-			continue;
-		}
-		const ch = message[i];
-		if (ch === "{") depth += 1;
-		else if (ch === "}") {
-			depth -= 1;
-			if (depth === 0) return i + 1;
-		}
-	}
-	return message.length;
-}
-function pseudoCatalogs(cfg, catalogs, locale = PSEUDO_LOCALE) {
-	const source = catalogs[cfg.sourceLocale] ?? {};
-	const target = {};
-	for (const [key, msg] of Object.entries(source)) target[key] = msg ? pseudoLocalize(msg) : "";
-	catalogs[locale] = target;
-	return Object.keys(target).filter((key) => target[key]);
-}
-//#endregion
 //#region src/render.ts
 const HREFLANG_OPEN = "<!--verbaly:hreflang-->";
 const HREFLANG_CLOSE = "<!--/verbaly:hreflang-->";
@@ -1395,7 +1411,7 @@ function decodeEntities(text) {
 	return text.replace(/&quot;/g, "\"").replace(/&#39;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
 }
 //#endregion
-//#region src/cli.ts
+//#region src/run.ts
 const HELP = `verbaly — i18n compiler
 
 Usage:
@@ -1416,7 +1432,7 @@ Options:
   --locales <csv>    extra locales; for translate: target locales to fill
   --prune            drop keys no longer referenced (extract)
   --model <id>       model override for the claude provider (translate)
-  --dry-run          list what would happen, write nothing (translate, import)
+  --dry-run          list what would happen, write nothing (translate, import, extract)
   --format <f>       export format: xliff (default) or csv (export)
   --out <path>       export directory (export, default: verbaly-export)
   --missing          export only untranslated entries (export)
@@ -1431,8 +1447,9 @@ Options:
 Config file: verbaly.config.{js,mjs,ts,mts,json} at root (flags win).
 The claude provider needs @anthropic-ai/sdk installed and ANTHROPIC_API_KEY set.
 `;
-async function main() {
+async function runCli(args = process.argv.slice(2)) {
 	const { positionals, values } = parseArgs({
+		args,
 		allowPositionals: true,
 		options: {
 			root: { type: "string" },
@@ -1464,6 +1481,7 @@ async function main() {
 		process.exitCode = command ? 0 : 1;
 		return;
 	}
+	if (rejectStrayFlags(command, values)) return;
 	if (command === "init") {
 		const result = init({
 			root: values.root,
@@ -1505,18 +1523,21 @@ async function main() {
 		return;
 	}
 	if (command === "extract") {
+		const dryRun = values["dry-run"];
 		const registry = await extractProject(cfg);
 		const catalogs = loadCatalogs(cfg);
 		if (values.prune) {
 			const removed = pruneCatalogs(cfg, catalogs, registry);
-			for (const [locale, keys] of Object.entries(removed)) console.log(`  ${locale}: -${keys.length} pruned`);
+			for (const [locale, keys] of Object.entries(removed)) console.log(dryRun ? `  ${locale}: would prune ${keys.length} — ${keys.join(", ")}` : `  ${locale}: -${keys.length} pruned`);
 		}
 		const { added } = syncCatalogs(cfg, catalogs, registry);
-		for (const locale of cfg.locales) writeCatalog(cfg, locale, catalogs[locale] ?? {});
-		writeDts(cfg, new Map(Object.entries(catalogs[cfg.sourceLocale] ?? {})));
+		if (!dryRun) {
+			for (const locale of cfg.locales) writeCatalog(cfg, locale, catalogs[locale] ?? {});
+			writeDts(cfg, new Map(Object.entries(catalogs[cfg.sourceLocale] ?? {})));
+		}
 		const total = registry.messages().size;
-		console.log(`[verbaly] ${total} messages · locales: ${cfg.locales.join(", ")}`);
-		for (const [locale, keys] of Object.entries(added)) console.log(`  ${locale}: +${keys.length}`);
+		console.log(`[verbaly] ${total} messages · locales: ${cfg.locales.join(", ")}${dryRun ? " (dry run, nothing written)" : ""}`);
+		for (const [locale, keys] of Object.entries(added)) console.log(`  ${locale}: ${dryRun ? `would add ${keys.length}` : `+${keys.length}`}`);
 		return;
 	}
 	if (command === "check") {
@@ -1623,17 +1644,61 @@ async function main() {
 	console.error(`[verbaly] unknown command "${command}"\n${HELP}`);
 	process.exitCode = 1;
 }
+const COMMON_FLAGS = /* @__PURE__ */ new Set([
+	"root",
+	"dir",
+	"source",
+	"locales",
+	"help"
+]);
+const COMMAND_FLAGS = {
+	init: [],
+	doctor: [],
+	extract: ["prune", "dry-run"],
+	check: [],
+	translate: ["model", "dry-run"],
+	export: [
+		"format",
+		"out",
+		"missing"
+	],
+	import: [
+		"locale",
+		"overwrite",
+		"dry-run"
+	],
+	pseudo: ["locale"],
+	render: [
+		"site",
+		"attribute",
+		"base-url",
+		"sitemap",
+		"clean"
+	]
+};
+function rejectStrayFlags(command, values) {
+	const own = COMMAND_FLAGS[command];
+	if (!own) return false;
+	const allowed = /* @__PURE__ */ new Set([...COMMON_FLAGS, ...own]);
+	const stray = Object.keys(values).filter((k) => values[k] !== void 0 && !allowed.has(k));
+	if (stray.length === 0) return false;
+	for (const flag of stray) console.error(`[verbaly] --${flag} is not a "${command}" flag${flag === "locale" ? " — did you mean --locales?" : ""}`);
+	process.exitCode = 1;
+	return true;
+}
 async function resolveProvider(cfg, model) {
 	const configured = cfg.translate.provider;
 	if (typeof configured === "function") return configured;
-	const { claudeProvider } = await import("./claude-Bi_Ex2hm.js");
+	const { claudeProvider } = await import("./claude-mpjdqqnY.js");
 	return claudeProvider({ model: model ?? cfg.translate.model });
 }
-main().catch((error) => {
+//#endregion
+//#region src/cli.ts
+runCli().catch((error) => {
 	console.error("[verbaly]", error instanceof Error ? error.message : error);
 	process.exitCode = 1;
 });
 //#endregion
-export {};
+export { isModuleNotFound as t };
 
 //# sourceMappingURL=cli.js.map