@standards/cli 1.0.0-alpha.401 → 1.0.0-alpha.403

package/dist/bin.mjs

@@ -351,6 +351,15 @@ function registerCodemodCommand(program) {
 		for (const failure of report.failures) process.stderr.write(`${failure.message}\n`);
 		if (report.skipped.length > 0 || report.failures.length > 0) process.exitCode = 1;
 	});
+	codemod.command("locale").description("Rewrite a whole dictionary passed as translations to locale, and DEFAULT_*_TRANSLATIONS to EN_*").argument("[paths...]", "files or directories to rewrite", ["."]).option("--dry-run", "report without writing").action(async (paths, opts) => {
+		const { runLocale } = await import("./locale-CfZalwmA.mjs");
+		const report = await runLocale(paths, { write: !opts.dryRun });
+		const verb = opts.dryRun ? "Would rewrite" : "Rewrote";
+		process.stdout.write(`${verb} ${report.changed} references in ${report.files} files.\n`);
+		for (const { file, line, column } of report.skipped) process.stdout.write(`${file}:${line}:${column}  translations  pass locale, keep only your overrides\n`);
+		for (const failure of report.failures) process.stderr.write(`${failure.message}\n`);
+		if (report.skipped.length > 0 || report.failures.length > 0) process.exitCode = 1;
+	});
 	codemod.command("engine-imports").description("Move imports of names that left @standards/schema to @standards/engine").argument("[paths...]", "files or directories to rewrite", ["."]).option("--dry-run", "report without writing").option("--root <dir>", "where @standards/schema and @standards/engine are installed", ".").action(async (paths, opts) => {
 		const { runEngineImports } = await import("./engine-imports-K-yySYo3.mjs");
 		const report = await runEngineImports(paths, {

package/dist/locale-CfZalwmA.mjs

@@ -0,0 +1,228 @@
+#!/usr/bin/env node
+/*! © 2025-2026 AND YOU CREATE SAS (RCS Paris 940 190 614). Proprietary — see LICENSE (Standards SDK License 1.0). */
+import { i as rewriteSourceFiles, n as parseSourceFile, t as applyEdits } from "./source-files-D2Bdfvhx.mjs";
+import ts from "typescript";
+//#region src/codemod/locale.ts
+/** Where the English values went once `DEFAULT_*_TRANSLATIONS` left the package roots. */
+const EN_ENTRY = "@standards/react/locales/en";
+const FORMER_HOMES = /* @__PURE__ */ new Set([
+	"@standards/react",
+	"@standards/ui",
+	EN_ENTRY
+]);
+const LOCALE_ENTRY = /^@standards\/react\/locales\/(en|fr)$/;
+const RENAMED = { EN_SETTINGS_DIALOG_TRANSLATIONS: "EN_ROLES_SETTINGS_TRANSLATIONS" };
+/** A whole dictionary, by its exported name, and the locale it stands for. */
+const DICTIONARIES = {
+	EN_TRANSLATIONS: "en",
+	FR_TRANSLATIONS: "fr"
+};
+/** The `@standards/react/locales/en` name of a removed or renamed export. */
+function englishName(name) {
+	const match = /^DEFAULT_([A-Z_]*)TRANSLATIONS$/.exec(name);
+	return match ? `EN_${match[1]}TRANSLATIONS` : RENAMED[name];
+}
+/** `translations: X` or `translations={X}`, with the expression it passes. */
+function translationsValue(node) {
+	if (ts.isPropertyAssignment(node) && node.name.getText() === "translations") return {
+		value: node.initializer,
+		jsx: false
+	};
+	if (ts.isJsxAttribute(node) && node.name.getText() === "translations" && node.initializer !== void 0 && ts.isJsxExpression(node.initializer) && node.initializer.expression !== void 0) return {
+		value: node.initializer.expression,
+		jsx: true
+	};
+}
+/** An identifier that reads a binding: not a property name, not an import specifier. */
+function isReference(node) {
+	const { parent } = node;
+	if (ts.isPropertyAccessExpression(parent)) return parent.expression === node;
+	if (ts.isPropertyAssignment(parent) || ts.isPropertySignature(parent)) return parent.name !== node;
+	if (ts.isExportSpecifier(parent)) {
+		if (parent.parent.parent.moduleSpecifier !== void 0) return false;
+		return (parent.propertyName ?? parent.name) === node;
+	}
+	return !ts.isImportSpecifier(parent);
+}
+/**
+* The text that reads `renamed` where `node` stood, keeping what the old name
+* also spelled: a shorthand property's key, a re-export's exported name.
+*/
+function renamedReference(node, renamed) {
+	const { parent } = node;
+	if (ts.isShorthandPropertyAssignment(parent)) return `${node.text}: ${renamed}`;
+	if (ts.isExportSpecifier(parent) && parent.propertyName === void 0) return `${renamed} as ${node.text}`;
+	return renamed;
+}
+/** One import declaration, written back with the bindings that stay in each module. */
+function importDeclaration(node, specifier, stay, go) {
+	const clause = node.importClause;
+	const typeOnly = clause?.isTypeOnly ? " type" : "";
+	const defaultName = clause?.name?.text;
+	const line = (names, from, withDefault) => {
+		const head = [withDefault ? defaultName : void 0, names.length > 0 ? `{ ${names.join(", ")} }` : void 0].filter((part) => part !== void 0).join(", ");
+		return head === "" ? "" : `import${typeOnly} ${head} from "${from}";`;
+	};
+	if (specifier === EN_ENTRY) return line([...stay, ...go], EN_ENTRY, true);
+	if (stay.length === 0 && defaultName === void 0) return line(go, EN_ENTRY, false);
+	return [line(stay, specifier, true), line(go, EN_ENTRY, false)].filter(Boolean).join("\n");
+}
+/**
+* Moves `DEFAULT_*_TRANSLATIONS` imports to `EN_*` from `@standards/react/locales/en`,
+* and turns a whole dictionary passed as `translations` into `locale`.
+*/
+function rewriteLocale(text, fileName) {
+	const { file, error } = parseSourceFile(text, fileName);
+	if (error !== void 0) return {
+		output: text,
+		changed: 0,
+		skipped: [],
+		error
+	};
+	const edits = [];
+	const skipped = [];
+	let changed = 0;
+	/** Local name → the `EN_*` name its references take. */
+	const renames = /* @__PURE__ */ new Map();
+	/** Local name of a whole dictionary → its locale. */
+	const dictionaries = /* @__PURE__ */ new Map();
+	/** Each import naming one of these exports, rewritten once its references are counted. */
+	const imports = [];
+	const references = /* @__PURE__ */ new Map();
+	const replaced = /* @__PURE__ */ new Map();
+	for (const node of file.statements) {
+		if (!(ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier))) continue;
+		const specifier = node.moduleSpecifier.text;
+		const bindings = node.importClause?.namedBindings;
+		if (bindings === void 0 || !ts.isNamedImports(bindings)) continue;
+		const entry = {
+			node,
+			specifier,
+			stay: [],
+			go: []
+		};
+		let relevant = false;
+		for (const element of bindings.elements) {
+			const imported = (element.propertyName ?? element.name).text;
+			const local = element.name.text;
+			const english = FORMER_HOMES.has(specifier) ? englishName(imported) : void 0;
+			if (english === void 0) entry.stay.push({
+				local,
+				text: element.getText(file)
+			});
+			else if (element.propertyName !== void 0) entry.go.push({
+				local,
+				text: `${element.isTypeOnly ? "type " : ""}${english} as ${local}`
+			});
+			else {
+				renames.set(local, english);
+				entry.go.push({
+					local,
+					text: `${element.isTypeOnly ? "type " : ""}${english}`
+				});
+			}
+			const exported = english ?? imported;
+			if (exported in DICTIONARIES && (english !== void 0 || LOCALE_ENTRY.test(specifier))) {
+				dictionaries.set(local, DICTIONARIES[exported]);
+				relevant = true;
+			}
+		}
+		changed += entry.go.length;
+		if (entry.go.length > 0 || relevant) imports.push(entry);
+	}
+	function visit(node) {
+		if (ts.isImportDeclaration(node)) return;
+		const site = translationsValue(node);
+		if (site !== void 0) {
+			const name = ts.isIdentifier(site.value) ? site.value.text : void 0;
+			const locale = name === void 0 ? void 0 : dictionaries.get(name);
+			if (name !== void 0 && locale !== void 0) {
+				const text = site.jsx ? `locale="${locale}"` : `locale: "${locale}"`;
+				edits.push({
+					start: node.getStart(file),
+					end: node.getEnd(),
+					text
+				});
+				replaced.set(name, (replaced.get(name) ?? 0) + 1);
+				references.set(name, (references.get(name) ?? 0) + 1);
+				changed += 1;
+				return;
+			}
+			if (mentions(site.value, dictionaries)) {
+				const { line, character } = file.getLineAndCharacterOfPosition(node.getStart(file));
+				skipped.push({
+					line: line + 1,
+					column: character + 1
+				});
+			}
+		}
+		if (ts.isIdentifier(node) && isReference(node)) {
+			if (dictionaries.has(node.text)) references.set(node.text, (references.get(node.text) ?? 0) + 1);
+			const renamed = renames.get(node.text);
+			if (renamed !== void 0) {
+				edits.push({
+					start: node.getStart(file),
+					end: node.getEnd(),
+					text: renamedReference(node, renamed)
+				});
+				changed += 1;
+			}
+		}
+		ts.forEachChild(node, visit);
+	}
+	visit(file);
+	const unused = new Set([...dictionaries.keys()].filter((name) => {
+		const uses = replaced.get(name) ?? 0;
+		return uses > 0 && uses === references.get(name);
+	}));
+	for (const { node, specifier, stay, go } of imports) {
+		const kept = (bindings) => bindings.filter(({ local }) => !unused.has(local)).map(({ text }) => text);
+		const keptStay = kept(stay);
+		const keptGo = kept(go);
+		if (keptGo.length === 0 && go.length === 0 && keptStay.length === stay.length) continue;
+		const text = importDeclaration(node, specifier, keptStay, keptGo);
+		const end = node.getEnd();
+		edits.push({
+			start: node.getStart(file),
+			end: text === "" && file.text.charAt(end) === "\n" ? end + 1 : end,
+			text
+		});
+	}
+	return {
+		output: applyEdits(text, edits),
+		changed,
+		skipped
+	};
+}
+function mentions(node, names) {
+	if (ts.isIdentifier(node) && names.has(node.text)) return true;
+	return ts.forEachChild(node, (child) => mentions(child, names) || void 0) === true;
+}
+/** Walks `paths`, rewrites every TS or JS file, writes back when `write` is set. */
+async function runLocale(paths, options) {
+	const report = {
+		files: 0,
+		changed: 0,
+		skipped: [],
+		failures: []
+	};
+	for (const { path, result } of await rewriteSourceFiles(paths, options.write, rewriteLocale)) {
+		if (result.error !== void 0) {
+			report.failures.push({
+				file: path,
+				message: result.error
+			});
+			continue;
+		}
+		for (const at of result.skipped) report.skipped.push({
+			file: path,
+			...at
+		});
+		if (result.changed === 0) continue;
+		report.files += 1;
+		report.changed += result.changed;
+	}
+	return report;
+}
+//#endregion
+export { runLocale };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@standards/cli",
-  "version": "1.0.0-alpha.401",
+  "version": "1.0.0-alpha.403",
   "description": "CLI tool to interact with Standards API",
   "type": "module",
   "bin": {
@@ -28,9 +28,9 @@
     "jiti": "2.7.0",
     "typescript": "^5.6.3",
     "ws": "8.21.1",
-    "@standards/client": "1.0.0-alpha.401",
-    "@standards/constants": "1.0.0-alpha.401",
-    "@standards/schema": "1.0.0-alpha.401"
+    "@standards/client": "1.0.0-alpha.403",
+    "@standards/constants": "1.0.0-alpha.403",
+    "@standards/schema": "1.0.0-alpha.403"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",