locale-ai 0.6.14 → 0.6.15

package/README.md

@@ -28,7 +28,7 @@ Download 577 MB? (Y/n)
 
 ## What it handles
 
-- **Layouts**: `locales/en/*.json` (nested folders too) → `locales/fr/...`, or `messages/en.json` → `messages/fr.json`. `.json`, `.yaml`, `.yml`, `.po`/`.pot` (gettext), `.arb` (Flutter) and `.strings` (Apple) are all supported, mixed freely in the same project. Common folders (`locales`, `src/locales`, `public/locales`, `src/i18n`, `messages`, `lang`, ...) are found automatically, or pass `--input`.
+- **Layouts**: `locales/en/*.json` (nested folders too) → `locales/fr/...`, or `messages/en.json` → `messages/fr.json`. `.json`, `.yaml`, `.yml`, `.po`/`.pot` (gettext), `.arb` (Flutter) and `.strings` (Apple) are all supported, mixed freely in the same project. Common folders (`locales`, `src/locales`, `public/locales`, `src/i18n`, `messages`, `lang`, `config/locales` (Rails), ...) are found automatically, or pass `--input`. Framework-specific naming is also recognized: `flutter gen-l10n`'s `app_en.arb`/`app_fr.arb` filename prefix, and Apple's `en.lproj`/`fr.lproj` directory-suffix convention (`--input en.lproj` or just the project root both work), on both the source and the generated target side.
 - **Placeholders are never translated or lost**: `{name}`, `{{count}}`, `%s`, `%1$s`, `%(name)s`, `%{name}`, `${name}`, `:attribute`, `$t(key)`, `@:key`, `<b>…</b>`, `<0>…</0>`, `&nbsp;`, URLs, e-mails.
 - **ICU MessageFormat**: `{count, plural, one {# file} other {# files}}`, `select`, nesting. Only the text is translated.
 - **i18next plurals**: adds the forms the target language needs (`_few`, `_many` for Arabic, Russian, Polish...), so the app doesn't fall back to the English string — each added form copies the `_other` translation verbatim rather than inflecting it, so review and adjust the wording of `_zero`/`_two`/`_few`/`_many` by hand for languages where those forms use a different noun/adjective form. The `_one` form is translated with its `{{count}}` temporarily replaced by a literal "1", since the model otherwise sometimes picks the target's plural noun form despite the English source being grammatically singular. Rails-style nested plurals (`item:` with `one:`/`other:` children instead of `item_one`/`item_other`) get the same missing-forms treatment.

package/dist/cli.js

@@ -173,7 +173,7 @@ async function cmdTranslate(argv) {
     const singularHints = new Set(sources.flatMap(({ doc }) => [...pluralOneStrings(doc.data)]));
     log(`locale-ai ${VERSION}`);
     log(`Found ${sources.length} ${from.tag} file${sources.length === 1 ? "" : "s"} in ${rel(layout.root)}/` +
-        (layout.kind === "dir" ? `${from.tag}/` : ""));
+        (layout.kind === "dir" ? `${from.tag}${layout.dirSuffix ?? ""}/` : ""));
     let failures = 0;
     const jobs = [];
     for (const locale of targets) {

package/dist/locales.js

@@ -23,6 +23,7 @@ const CANDIDATES = [
     "src/locale",
     "app/i18n",
     "static/locales",
+    "config/locales",
     ".",
 ];
 const isDir = (p) => fs.existsSync(p) && fs.statSync(p).isDirectory();
@@ -31,25 +32,60 @@ const isFile = (p) => fs.existsSync(p) && fs.statSync(p).isFile();
 function fileExtAt(root, from) {
     return EXTENSIONS.find((ext) => isFile(path.join(root, `${from}${ext}`)));
 }
+/**
+ * A prefixed source-locale file, if `<root>/<prefix>_<from><ext>` exists for one of
+ * EXTENSIONS — the convention `flutter gen-l10n` uses by default ("app_en.arb").
+ */
+function prefixedFileAt(root, from) {
+    if (!isDir(root))
+        return undefined;
+    for (const entry of fs.readdirSync(root)) {
+        if (!isFile(path.join(root, entry)))
+            continue;
+        for (const ext of EXTENSIONS) {
+            const suffix = `_${from}${ext}`;
+            if (entry.endsWith(suffix) && entry.length > suffix.length) {
+                return { ext, prefix: entry.slice(0, -suffix.length) };
+            }
+        }
+    }
+    return undefined;
+}
 function layoutAt(root, from) {
     const dir = path.join(root, from);
     if (isDir(dir) && listLocaleFiles(dir).length > 0)
         return { kind: "dir", root };
+    const lprojDir = path.join(root, `${from}.lproj`);
+    if (isDir(lprojDir) && listLocaleFiles(lprojDir).length > 0)
+        return { kind: "dir", root, dirSuffix: ".lproj" };
     const ext = fileExtAt(root, from);
     if (ext)
         return { kind: "file", root, ext };
+    const prefixed = prefixedFileAt(root, from);
+    if (prefixed)
+        return { kind: "file", root, ext: prefixed.ext, prefix: prefixed.prefix };
     return undefined;
 }
+const dirNameFor = (layout, tag) => `${tag}${layout.dirSuffix ?? ""}`;
+const fileNameFor = (layout, tag, ext) => `${layout.prefix ? `${layout.prefix}_` : ""}${tag}${ext}`;
 export function detectLayout(cwd, from, input) {
     if (input) {
         const abs = path.resolve(cwd, input);
         // Accept pointing at the source locale itself: --input locales/en or locales/en.json
         if (path.basename(abs) === from && isDir(abs))
             return { kind: "dir", root: path.dirname(abs) };
+        if (path.basename(abs) === `${from}.lproj` && isDir(abs)) {
+            return { kind: "dir", root: path.dirname(abs), dirSuffix: ".lproj" };
+        }
         const base = path.basename(abs);
         const directExt = EXTENSIONS.find((ext) => base === `${from}${ext}`);
         if (directExt && isFile(abs))
             return { kind: "file", root: path.dirname(abs), ext: directExt };
+        const prefixedExt = EXTENSIONS.find((ext) => base.endsWith(`_${from}${ext}`) && base.length > `_${from}${ext}`.length);
+        if (prefixedExt && isFile(abs)) {
+            const suffix = `_${from}${prefixedExt}`;
+            return { kind: "file", root: path.dirname(abs), ext: prefixedExt, prefix: base.slice(0, -suffix.length) };
+        }
         const l = layoutAt(abs, from);
         if (!l)
             throw new Error(`No "${from}" locale found in ${input} (looked for ${from}/* and ${from}${EXTENSIONS.join("/")}).`);
@@ -76,16 +112,18 @@ function listLocaleFiles(dir) {
     return out.sort();
 }
 export function sourceFiles(layout, from) {
-    return layout.kind === "dir" ? listLocaleFiles(path.join(layout.root, from)) : [path.join(layout.root, `${from}${layout.ext}`)];
+    return layout.kind === "dir"
+        ? listLocaleFiles(path.join(layout.root, dirNameFor(layout, from)))
+        : [path.join(layout.root, fileNameFor(layout, from, layout.ext))];
 }
 /** A translated file is a real PO, never a template, regardless of what the source was. */
 const outputExt = (ext) => (ext === ".pot" ? ".po" : ext);
 export function targetFile(layout, from, to, src) {
     if (layout.kind === "file")
-        return path.join(layout.root, `${to}${outputExt(layout.ext)}`);
-    const rel = path.relative(path.join(layout.root, from), src);
+        return path.join(layout.root, fileNameFor(layout, to, outputExt(layout.ext)));
+    const rel = path.relative(path.join(layout.root, dirNameFor(layout, from)), src);
     const ext = path.extname(rel);
-    return path.join(layout.root, to, ext === ".pot" ? `${rel.slice(0, -ext.length)}.po` : rel);
+    return path.join(layout.root, dirNameFor(layout, to), ext === ".pot" ? `${rel.slice(0, -ext.length)}.po` : rel);
 }
 /** True when `tag` parses as a locale (e.g. "fr", "pt-BR") — rejects names like "__mocks__" or "schemas". */
 function looksLikeLocale(tag) {
@@ -101,19 +139,22 @@ function looksLikeLocale(tag) {
 export function existingTargets(layout, from) {
     if (layout.kind === "file") {
         const ext = layout.ext;
+        const prefix = layout.prefix ? `${layout.prefix}_` : "";
         return fs
             .readdirSync(layout.root)
-            .filter((f) => f.endsWith(ext) && f.slice(0, -ext.length) !== from)
-            .map((f) => f.slice(0, -ext.length))
+            .filter((f) => f.startsWith(prefix) && f.endsWith(ext) && f.slice(prefix.length, -ext.length) !== from)
+            .map((f) => f.slice(prefix.length, -ext.length))
             .filter(looksLikeLocale)
             .sort();
     }
+    const suffix = layout.dirSuffix ?? "";
     return fs
         .readdirSync(layout.root, { withFileTypes: true })
-        .filter((e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules" && e.name !== from)
-        .map((e) => e.name)
+        .filter((e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules" && e.name.endsWith(suffix))
+        .map((e) => (suffix ? e.name.slice(0, -suffix.length) : e.name))
+        .filter((name) => name !== from)
         .filter(looksLikeLocale)
-        .filter((name) => listLocaleFiles(path.join(layout.root, name)).length > 0)
+        .filter((name) => listLocaleFiles(path.join(layout.root, dirNameFor(layout, name))).length > 0)
         .sort();
 }
 const finalNewline = (text) => text === "" || text.endsWith("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "locale-ai",
-  "version": "0.6.14",
+  "version": "0.6.15",
   "description": "Translate your i18n locale files locally on CPU. Free, offline, no API keys.",
   "author": "Taha KHABOUSS",
   "repository": {