@babelize/engine 0.1.3 → 0.2.1

package/dist/analysis/analyze.js

@@ -139,7 +139,7 @@ async function analyzeWorkspace(workspacePath, options = {}) {
     const framework = workspace.framework;
     const support = frameworkSupport(framework);
     if (support === 'unsupported') {
-        return empty(framework, `Detected ${framework}, which local translation does not support. Supported: React, Next.js and Django (Vue and static HTML in beta).`);
+        return empty(framework, `Detected ${framework}, which local translation does not support. Supported: React, Next.js, Django and static HTML (Vue and React Native in beta).`);
     }
     const phases = (types_1.FRAMEWORK_CONFIGS[framework] ?? types_1.FRAMEWORK_CONFIGS.unknown).phases;
     // Same ICU decision as a local translate run (whose translator is an LLM).

package/dist/config.d.ts

@@ -4,7 +4,7 @@ declare const configSchema: z.ZodObject<{
     workspacePath: z.ZodString;
     sourceLocale: z.ZodDefault<z.ZodString>;
     targetLocales: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    framework: z.ZodOptional<z.ZodEnum<["react", "nextjs", "vue", "static", "unknown", "django"]>>;
+    framework: z.ZodOptional<z.ZodEnum<["react", "nextjs", "vue", "static", "unknown", "django", "react-native"]>>;
     dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     projectId: z.ZodOptional<z.ZodString>;
     sourceDir: z.ZodOptional<z.ZodString>;
@@ -40,7 +40,7 @@ declare const configSchema: z.ZodObject<{
     sourceLocale: string;
     targetLocales: string[];
     dryRun: boolean;
-    framework?: "react" | "nextjs" | "vue" | "static" | "unknown" | "django" | undefined;
+    framework?: "react" | "nextjs" | "vue" | "static" | "unknown" | "django" | "react-native" | undefined;
     projectId?: string | undefined;
     sourceDir?: string | undefined;
     localesDir?: string | undefined;
@@ -56,7 +56,7 @@ declare const configSchema: z.ZodObject<{
     workspacePath: string;
     sourceLocale?: string | undefined;
     targetLocales?: string[] | undefined;
-    framework?: "react" | "nextjs" | "vue" | "static" | "unknown" | "django" | undefined;
+    framework?: "react" | "nextjs" | "vue" | "static" | "unknown" | "django" | "react-native" | undefined;
     dryRun?: boolean | undefined;
     projectId?: string | undefined;
     sourceDir?: string | undefined;

package/dist/detection/stack.d.ts

@@ -9,7 +9,7 @@
  * is React is a React project for Babelize). An unsupported stack is only
  * reported when nothing Babelize can translate was found.
  */
-export type StackFramework = 'react' | 'nextjs' | 'vue' | 'static' | 'django' | 'unknown';
+export type StackFramework = 'react' | 'nextjs' | 'vue' | 'static' | 'django' | 'react-native' | 'unknown';
 export type PackageManagerId = 'bun' | 'pnpm' | 'yarn' | 'npm' | 'uv' | 'poetry' | 'pipenv' | 'pdm' | 'pip';
 export interface DetectedStack {
     framework: StackFramework;
@@ -36,6 +36,8 @@ export interface RepoFiles {
 export declare const FRAMEWORK_DISPLAY_NAMES: Record<string, string>;
 /** Does a Python dependency file list Django itself (not just django-* add-ons)? */
 export declare function mentionsPythonPackage(content: string, pkg: string): boolean;
+/** Human list of supported stacks, for messages. */
+export declare const SUPPORTED_SUMMARY = "React, Next.js, Vue, React Native, Django and plain HTML/CSS/JS";
 export declare function detectPackageManagers(paths: Set<string>, pyproject: string | null, preferPython: boolean): PackageManagerId[];
 export declare function detectStack(files: RepoFiles): Promise<DetectedStack>;
 /** RepoFiles for a local directory. */

package/dist/detection/stack.js

@@ -47,7 +47,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FRAMEWORK_DISPLAY_NAMES = void 0;
+exports.SUPPORTED_SUMMARY = exports.FRAMEWORK_DISPLAY_NAMES = void 0;
 exports.mentionsPythonPackage = mentionsPythonPackage;
 exports.detectPackageManagers = detectPackageManagers;
 exports.detectStack = detectStack;
@@ -56,7 +56,8 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const fast_glob_1 = __importDefault(require("fast-glob"));
 exports.FRAMEWORK_DISPLAY_NAMES = {
-    react: 'React', nextjs: 'Next.js', vue: 'Vue', static: 'HTML/CSS/JS', django: 'Django', unknown: 'Unknown',
+    react: 'React', nextjs: 'Next.js', vue: 'Vue', static: 'HTML/CSS/JS', django: 'Django',
+    'react-native': 'React Native', unknown: 'Unknown',
 };
 const IGNORED_DIR = /(?:^|\/)(?:node_modules|\.git|venv|\.venv|env|site-packages|vendor|dist|build|\.next|__pycache__)\//;
 function depth(p) {
@@ -75,6 +76,9 @@ function jsFramework(pkg) {
     const deps = { ...pkg.dependencies, ...pkg.devDependencies };
     if (deps['next'])
         return { id: 'nextjs' };
+    // Before react: Expo / React Native apps depend on react (and Expo Router on react-dom).
+    if (deps['expo'] || deps['react-native'])
+        return { id: 'react-native' };
     if (deps['nuxt'] || deps['vue'])
         return { id: 'vue' };
     if (deps['react'] || deps['gatsby'] || deps['@remix-run/react'] || deps['astro'] || deps['react-dom'] || deps['react-scripts'])
@@ -89,6 +93,9 @@ function jsFramework(pkg) {
         return { id: 'ember' };
     return { id: 'unknown' };
 }
+const SUPPORTED_JS = new Set(['nextjs', 'vue', 'react', 'react-native']);
+/** Human list of supported stacks, for messages. */
+exports.SUPPORTED_SUMMARY = 'React, Next.js, Vue, React Native, Django and plain HTML/CSS/JS';
 const UNSUPPORTED_NAMES = {
     angular: 'Angular', svelte: 'Svelte', solid: 'SolidJS', ember: 'Ember', laravel: 'Laravel', symfony: 'Symfony',
     wordpress: 'WordPress', php: 'PHP', rails: 'Ruby on Rails', jekyll: 'Jekyll', ruby: 'Ruby', flutter: 'Flutter',
@@ -151,7 +158,7 @@ async function detectStack(files) {
             supported: false,
             unsupported: { id, name },
             packageManagers: detectPackageManagers(set, pyproject, preferPython),
-            message: `${name} isn't supported yet. Babelize supports React, Next.js, Vue, Django and plain HTML/CSS/JS projects.`,
+            message: `${name} isn't supported yet. Babelize supports ${exports.SUPPORTED_SUMMARY} projects.`,
         };
     };
     // 1. Django at the root.
@@ -160,7 +167,7 @@ async function detectStack(files) {
     // 2. A JS framework at the root.
     const rootPkg = has('package.json') ? await readJson(files, 'package.json') : null;
     const rootJs = jsFramework(rootPkg);
-    if (rootJs.id === 'nextjs' || rootJs.id === 'vue' || rootJs.id === 'react')
+    if (SUPPORTED_JS.has(rootJs.id))
         return result(rootJs.id);
     // 3. Django deeper in the tree, or declared as a dependency.
     const pyDepFiles = ['requirements.txt', 'requirements/base.txt', 'requirements/prod.txt', 'requirements/production.txt', 'Pipfile', 'setup.py', 'setup.cfg']
@@ -173,7 +180,7 @@ async function detectStack(files) {
     const subPkgs = paths.filter((p) => p.endsWith('/package.json') && depth(p) <= 2).slice(0, 25);
     for (const p of subPkgs) {
         const sub = jsFramework(await readJson(files, p));
-        if (sub.id === 'nextjs' || sub.id === 'vue' || sub.id === 'react')
+        if (SUPPORTED_JS.has(sub.id))
             return result(sub.id);
     }
     // 5. Unsupported stacks with a clear signal.
@@ -247,7 +254,7 @@ async function detectStack(files) {
         packageManagers: detectPackageManagers(set, pyproject, false),
         message: files.truncated
             ? "This repository is too large to inspect before creating the project."
-            : 'No React, Next.js, Vue, Django or HTML files were found in this repository.',
+            : 'No React, Next.js, Vue, React Native, Django or HTML files were found in this repository.',
     };
 }
 /** RepoFiles for a local directory. */

package/dist/injection/StrategyFactory.d.ts

@@ -1,4 +1,8 @@
 import { InjectionStrategy } from './InjectionStrategy';
 export declare class StrategyFactory {
-    static getStrategy(framework: string, existingDeps?: Record<string, string>): InjectionStrategy;
+    /**
+     * @param moduleTranslator Import path of the i18n config's `t` for the
+     *   vanilla strategy (relative to the file being injected).
+     */
+    static getStrategy(framework: string, existingDeps?: Record<string, string>, moduleTranslator?: string): InjectionStrategy;
 }

package/dist/injection/StrategyFactory.js

@@ -6,7 +6,11 @@ const NextIntlStrategy_1 = require("./strategies/NextIntlStrategy");
 const VanillaStrategy_1 = require("./strategies/VanillaStrategy");
 const VueI18nStrategy_1 = require("./strategies/VueI18nStrategy");
 class StrategyFactory {
-    static getStrategy(framework, existingDeps) {
+    /**
+     * @param moduleTranslator Import path of the i18n config's `t` for the
+     *   vanilla strategy (relative to the file being injected).
+     */
+    static getStrategy(framework, existingDeps, moduleTranslator) {
         if (existingDeps?.['react-i18next']) {
             return new ReactI18nextStrategy_1.ReactI18nextStrategy();
         }
@@ -17,12 +21,13 @@ class StrategyFactory {
             case 'nextjs':
                 return new NextIntlStrategy_1.NextIntlStrategy();
             case 'react':
+            case 'react-native':
                 return new ReactI18nextStrategy_1.ReactI18nextStrategy();
             case 'vue':
                 return new VueI18nStrategy_1.VueI18nStrategy();
             case 'unknown':
             default:
-                return new VanillaStrategy_1.VanillaStrategy();
+                return new VanillaStrategy_1.VanillaStrategy(moduleTranslator);
         }
     }
 }

package/dist/injection/html/html-injector.d.ts

@@ -7,5 +7,7 @@ interface HtmlInjectOptions {
     targetLocales?: string[];
     sourceLocale?: string;
 }
+/** `<script src>` for the root i18n.js as seen from this page: `i18n.js`, `../i18n.js`, ... */
+export declare function runtimeScriptSrc(filePath: string): string;
 export declare function injectHtml(options: HtmlInjectOptions): Promise<FileInjection>;
 export {};

package/dist/injection/html/html-injector.js

@@ -32,10 +32,36 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.runtimeScriptSrc = runtimeScriptSrc;
 exports.injectHtml = injectHtml;
+const path_1 = __importDefault(require("path"));
 const string_utils_1 = require("../../utils/string-utils");
 const html_extractor_1 = require("../../utils/html-extractor");
+// <meta> tags whose content the extractor collects (html-extractor extractHeadStrings).
+const SEO_META = ['description', 'og:title', 'og:description', 'og:site_name', 'twitter:title', 'twitter:description'];
+/**
+ * Key for a string in this file found by its text alone. Head strings are extracted
+ * with ids like `file:meta:<hash>`, and a string already seen in the body is not
+ * extracted twice, so a line-based id can't find them.
+ */
+function keyByText(filePath, text, keyMapping) {
+    const prefix = `${filePath}:`;
+    const suffix = `:${(0, string_utils_1.hashString)(text)}`;
+    for (const [id, key] of keyMapping) {
+        if (id.startsWith(prefix) && id.endsWith(suffix))
+            return key;
+    }
+    return undefined;
+}
+/** `<script src>` for the root i18n.js as seen from this page: `i18n.js`, `../i18n.js`, ... */
+function runtimeScriptSrc(filePath) {
+    const dir = path_1.default.posix.dirname(filePath.split(path_1.default.sep).join('/'));
+    return path_1.default.posix.relative(dir, 'i18n.js') || 'i18n.js';
+}
 function asElement(node) {
     return node.nodeType === 1 ? node : null;
 }
@@ -60,13 +86,26 @@ function walkHtmlNode(node, filePath, content, keyMapping, matchedIds, injection
         }
     }
     const element = asElement(node);
+    if (element && tagName === 'meta') {
+        const name = element.getAttribute('name') || element.getAttribute('property');
+        const value = element.getAttribute('content');
+        if (name && SEO_META.includes(name) && value?.trim() && !element.getAttribute('data-i18n-content')) {
+            const key = keyByText(filePath, value.trim(), keyMapping);
+            if (key) {
+                element.setAttribute('data-i18n-content', key);
+                injections.push({ file: filePath, line: 0, column: 0, original: value, replacement: `data-i18n-content="${key}"`, key, confidence: 100 });
+            }
+        }
+        return;
+    }
     if (textChild && !nonTextChild && element && !element.getAttribute('data-i18n')) {
         const text = textChild.text.trim();
         if (node.range) {
             const line = (content.slice(0, node.range[0]).match(/\n/g) || []).length + 1;
             const id = `${filePath}:${line}:${(0, string_utils_1.hashString)(text)}`;
-            if (matchedIds.has(id)) {
-                const key = keyMapping.get(id);
+            // <title> may only exist under a head id (`file:title:<hash>`) or share a body string's key.
+            if (matchedIds.has(id) || tagName === 'title') {
+                const key = keyMapping.get(id) ?? (tagName === 'title' ? keyByText(filePath, text, keyMapping) : undefined);
                 if (key) {
                     element.setAttribute('data-i18n', key);
                     injections.push({
@@ -159,13 +198,23 @@ async function injectHtml(options) {
     const matchedIds = new Set(keyMapping.keys());
     walkHtmlNode(htmlEl, filePath, content, keyMapping, matchedIds, injections);
     let modifiedContent = root.toString();
-    const hasScript = /<script[^>]*src\s*=\s*["']i18n\.js["'][^>]*>/.test(modifiedContent);
-    if (!hasScript) {
+    // i18n.js lives at the site root, so pages in subfolders need ../i18n.js. Older runs
+    // wrote a bare src="i18n.js" everywhere; repoint those instead of adding a second tag.
+    const src = runtimeScriptSrc(filePath);
+    const existingScript = /<script([^>]*)src\s*=\s*["']((?:\.\.\/)*i18n\.js)["']/.exec(modifiedContent);
+    if (existingScript) {
+        if (existingScript[2] !== src) {
+            modifiedContent = modifiedContent.replace(existingScript[0], `<script${existingScript[1]}src="${src}"`);
+            importAdded = true;
+        }
+    }
+    else {
+        const tag = `  <script src="${src}"></script>\n`;
         if (modifiedContent.includes('</body>')) {
-            modifiedContent = modifiedContent.replace('</body>', '  <script src="i18n.js"></script>\n</body>');
+            modifiedContent = modifiedContent.replace('</body>', `${tag}</body>`);
         }
         else {
-            modifiedContent = modifiedContent.replace('</head>', '  <script src="i18n.js"></script>\n</head>');
+            modifiedContent = modifiedContent.replace('</head>', `${tag}</head>`);
         }
         importAdded = true;
     }

package/dist/injection/strategies/VanillaStrategy.d.ts

@@ -1,7 +1,15 @@
 import * as t from '@babel/types';
 import { InjectionStrategy, InjectionContext } from '../InjectionStrategy';
+/**
+ * Plain `t()` with no hook: module-level code, and files without a component
+ * the hook can go in. `t` is imported from the project's i18n config, by
+ * default the `@/i18n` alias; injection passes the relative path to
+ * Babelize's generated config when it knows it (Metro has no `@/` alias).
+ */
 export declare class VanillaStrategy implements InjectionStrategy {
+    private readonly source;
     id: string;
+    constructor(source?: string);
     hasImport(ast: t.File): boolean;
     createImport(): t.ImportDeclaration;
     hasHook(_componentPath: any): boolean;

package/dist/injection/strategies/VanillaStrategy.js

@@ -35,14 +35,21 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VanillaStrategy = void 0;
 const t = __importStar(require("@babel/types"));
+/**
+ * Plain `t()` with no hook: module-level code, and files without a component
+ * the hook can go in. `t` is imported from the project's i18n config, by
+ * default the `@/i18n` alias; injection passes the relative path to
+ * Babelize's generated config when it knows it (Metro has no `@/` alias).
+ */
 class VanillaStrategy {
-    constructor() {
+    constructor(source = '@/i18n') {
+        this.source = source;
         this.id = 'vanilla';
     }
     hasImport(ast) {
         let found = false;
         for (const node of ast.program.body) {
-            if (t.isImportDeclaration(node) && node.source.value === '@/i18n') {
+            if (t.isImportDeclaration(node) && node.source.value === this.source) {
                 const hasSpecifier = node.specifiers.some(spec => t.isImportSpecifier(spec) &&
                     t.isIdentifier(spec.imported) &&
                     spec.imported.name === 't');
@@ -55,7 +62,7 @@ class VanillaStrategy {
         return found;
     }
     createImport() {
-        return t.importDeclaration([t.importSpecifier(t.identifier('t'), t.identifier('t'))], t.stringLiteral('@/i18n'));
+        return t.importDeclaration([t.importSpecifier(t.identifier('t'), t.identifier('t'))], t.stringLiteral(this.source));
     }
     hasHook(_componentPath) {
         return true; // No hook needed for vanilla JS

package/dist/local/translate-core.d.ts

@@ -10,8 +10,8 @@ import { type FileDiffStat, type ApplyIo, type WorkspaceChanges } from './worksp
 /** Lockfile scope for local runs: `.babelize/local/babelize-lock.json` in the project root. */
 export declare const LOCAL_PROJECT_ID = "local";
 export declare const LOCAL_LOCKFILE = ".babelize/local/babelize-lock.json";
-export declare const SUPPORTED_LOCAL_FRAMEWORKS: readonly ["react", "nextjs", "django"];
-export declare const BETA_LOCAL_FRAMEWORKS: readonly ["vue", "static"];
+export declare const SUPPORTED_LOCAL_FRAMEWORKS: readonly ["react", "nextjs", "django", "static"];
+export declare const BETA_LOCAL_FRAMEWORKS: readonly ["vue", "react-native"];
 export interface LocalTranslateOptions {
     projectDir: string;
     sourceLocale: string;

package/dist/local/translate-core.js

@@ -72,8 +72,8 @@ const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
 /** Lockfile scope for local runs: `.babelize/local/babelize-lock.json` in the project root. */
 exports.LOCAL_PROJECT_ID = 'local';
 exports.LOCAL_LOCKFILE = `.babelize/${exports.LOCAL_PROJECT_ID}/babelize-lock.json`;
-exports.SUPPORTED_LOCAL_FRAMEWORKS = ['react', 'nextjs', 'django'];
-exports.BETA_LOCAL_FRAMEWORKS = ['vue', 'static'];
+exports.SUPPORTED_LOCAL_FRAMEWORKS = ['react', 'nextjs', 'django', 'static'];
+exports.BETA_LOCAL_FRAMEWORKS = ['vue', 'react-native'];
 class LocalTranslateError extends Error {
     constructor(message, code, 
     /** Files left changed in the project (only for a failed, un-rolled-back apply). */

package/dist/modules/extractor/extract.js

@@ -47,8 +47,9 @@ const types_2 = require("@babelize/types");
 const jsx_message_1 = require("../../utils/jsx-message");
 const ui_copy_1 = require("../../utils/ui-copy");
 const module_constants_1 = require("../../utils/module-constants");
+const react_native_1 = require("../../utils/react-native");
 /** Frameworks whose injection strategies can render a JSX sentence as one message. */
-const SENTENCE_FRAMEWORKS = new Set(['react', 'nextjs']);
+const SENTENCE_FRAMEWORKS = new Set(['react', 'nextjs', 'react-native']);
 async function extractStrings(workspace, filesToProcess, extractOptions = {}) {
     const detectFormats = !!workspace.formatConfig?.enabled;
     const strings = [];
@@ -64,11 +65,12 @@ async function extractStrings(workspace, filesToProcess, extractOptions = {}) {
         }
     }
     else {
-        // Otherwise scan all source directories. Django scans .py/.html and
-        // skips virtualenvs, migrations, static files and the like.
-        const fwConfig = workspace.framework === 'django' ? types_2.FRAMEWORK_CONFIGS.django : undefined;
+        // Otherwise scan all source directories. Root-scanning frameworks use
+        // their own extensions (Django .py/.html, React Native only JS/TS), and
+        // every framework's exclusions (virtualenvs, native ios/android projects).
+        const fwConfig = types_2.FRAMEWORK_CONFIGS[workspace.framework]?.scanRoot ? types_2.FRAMEWORK_CONFIGS[workspace.framework] : undefined;
         const extensions = fwConfig ? [...fwConfig.extensions] : types_1.SUPPORTED_EXTENSIONS;
-        const excluded = fwConfig ? [...types_1.EXCLUDED_PATTERNS, ...(fwConfig.excludedPatterns ?? [])] : types_1.EXCLUDED_PATTERNS;
+        const excluded = (0, types_1.workspaceExcludes)(workspace);
         for (const sourceDir of workspace.sourceDirs) {
             const dirPath = path.join(workspace.path, sourceDir);
             const files = await (0, file_utils_1.findFiles)(dirPath, extensions, excluded);
@@ -152,6 +154,9 @@ async function extractStringsFromFile(content, filePath, detectFormats, options)
     // into a sentence message — not extracted again on their own.
     const consumed = new WeakSet();
     const unwired = [];
+    // React Native copy outside JSX text: screen titles in navigation options,
+    // Alert titles/messages, two-letter button labels ("OK").
+    const reactNative = options?.framework === 'react-native';
     const isTypeScript = filePath.endsWith('.ts') || filePath.endsWith('.tsx');
     try {
         const ast = (0, ast_helpers_1.parseCode)(content, { isTypeScript });
@@ -162,7 +167,9 @@ async function extractStringsFromFile(content, filePath, detectFormats, options)
                 for (const lit of plan.literals) {
                     const text = lit.node.value.trim();
                     const line = lit.node.loc?.start.line || 0;
-                    if (!plan.provable) {
+                    if (!plan.provable && !plan.labels) {
+                        // Reported, and not translated in place either: the values are also data.
+                        consumed.add(lit.node);
                         unwired.push({
                             file: filePath,
                             key: '',
@@ -202,11 +209,25 @@ async function extractStringsFromFile(content, filePath, detectFormats, options)
                 return;
             if ((0, ast_helpers_1.isNonTranslatableContext)(path))
                 return;
-            if (path.parentPath && path.parentPath.isCallExpression() && path.parentPath.node.arguments.includes(path.node)) {
+            // `rgba(255,255,255,0.72)` would otherwise pass as a currency amount below.
+            if ((0, string_utils_1.looksLikeColor)(text))
                 return;
+            // Never shown: an object key (`{ 'in-review': … }`), a type (`useState<"active" | "all">`),
+            // or a machine date (`placeholder="2026-05-30"` is the format the field parses).
+            if (isKeyOrType(path))
+                return;
+            if (/^\d{4}-\d{2}-\d{2}(?:[T ][\d:.]+Z?)?$/.test(text))
+                return;
+            // A literal in a branch (`role === 'brand' ? 'brand' : 'creator'`, `user?.id ?? 'usr_1'`)
+            // goes where the whole expression goes, so that's where it's judged.
+            const site = valueSite(path);
+            if (site.parentPath && site.parentPath.isCallExpression() && site.parentPath.node.arguments.includes(site.node)) {
+                // Call arguments are program data, except an Alert dialog's title and message.
+                if (!(reactNative && (0, react_native_1.isAlertTextArgument)(site)))
+                    return;
             }
             // Program data in initializers (`{ name: "Ada" }`, `href: "/"`) is not UI copy.
-            if (!(0, string_utils_1.matchesCurrencyPattern)(text) && !(0, string_utils_1.matchesDatePattern)(text) && !(0, ui_copy_1.isUiCopyLiteral)(path.node, path.parent, text))
+            if (!(0, string_utils_1.matchesCurrencyPattern)(text) && !(0, string_utils_1.matchesDatePattern)(text) && !(0, ui_copy_1.isUiCopyLiteral)(site.node, site.parent, text))
                 return;
             const format = detectFormats ? (0, detect_format_1.detectFormat)(text) : null;
             if (format) {
@@ -250,7 +271,9 @@ async function extractStringsFromFile(content, filePath, detectFormats, options)
             while (parent) {
                 if (parent.isJSXAttribute()) {
                     const nameNode = parent.node.name;
-                    if (ast_helpers_1.t.isJSXIdentifier(nameNode) && !types_1.JSX_TRANSLATABLE_ATTRS.includes(nameNode.name)) {
+                    if (ast_helpers_1.t.isJSXIdentifier(nameNode) &&
+                        !types_1.JSX_TRANSLATABLE_ATTRS.includes(nameNode.name) &&
+                        !(reactNative && (0, react_native_1.isNavigationTitle)(path))) {
                         return;
                     }
                     break;
@@ -264,7 +287,8 @@ async function extractStringsFromFile(content, filePath, detectFormats, options)
             const hasCurrency = (0, string_utils_1.matchesCurrencyPattern)(text);
             const hasDate = (0, string_utils_1.matchesDatePattern)(text);
             const isDateOrCurrencyValue = (hasCurrency || hasDate) && text.length >= 3 && !(0, string_utils_1.containsPII)(text);
-            if (!(0, string_utils_1.isTranslatableText)(text) || (0, string_utils_1.containsPII)(text) || text.length < 3) {
+            const tooShort = text.length < 3 && !(reactNative && (0, react_native_1.isShortUiWord)(text));
+            if (!(0, string_utils_1.isTranslatableText)(text) || (0, string_utils_1.containsPII)(text) || tooShort) {
                 if (!isDateOrCurrencyValue && !format)
                     return;
             }
@@ -443,6 +467,8 @@ async function extractStringsFromFile(content, filePath, detectFormats, options)
                 if ((0, ast_helpers_1.isNonTranslatableContext)(path))
                     return;
                 const text = path.node.value.value.trim();
+                if ((0, string_utils_1.looksLikeColor)(text))
+                    return;
                 if (!(0, string_utils_1.matchesCurrencyPattern)(text) && !(0, string_utils_1.matchesDatePattern)(text) && !(0, ui_copy_1.isUiCopyLiteral)(path.node.value, path.node, text))
                     return;
                 const hasCurrency = (0, string_utils_1.matchesCurrencyPattern)(text);
@@ -548,6 +574,37 @@ async function extractStringsFromFile(content, filePath, detectFormats, options)
     }
     return { strings, warnings, notInjected: unwired };
 }
+/** A string that names something rather than being shown: a property key, or part of a TypeScript type. */
+function isKeyOrType(path) {
+    const parent = path.parentPath;
+    if (!parent)
+        return false;
+    const keyed = parent.isObjectProperty() || parent.isObjectMethod() || parent.isClassProperty() || parent.isClassMethod() || parent.isTSPropertySignature();
+    if (keyed && parent.node.key === path.node && !parent.node.computed)
+        return true;
+    return !!path.findParent((p) => p.isTSType() || p.isTSTypeAnnotation() || p.isTSEnumMember());
+}
+/**
+ * The expression a literal is the value of: through `?:` branches, `??`/`||`/`&&`,
+ * parentheses and type assertions (`'image-outline' as const`).
+ */
+function valueSite(path) {
+    let site = path;
+    for (;;) {
+        const parent = site.parentPath;
+        if (!parent)
+            return site;
+        const passesThrough = (parent.isConditionalExpression() && site.key !== 'test') ||
+            parent.isLogicalExpression() ||
+            parent.isParenthesizedExpression() ||
+            parent.isTSAsExpression() ||
+            parent.isTSSatisfiesExpression() ||
+            parent.isTSNonNullExpression();
+        if (!passesThrough)
+            return site;
+        site = parent;
+    }
+}
 /**
  * Extract strings from a Vue Single File Component (SFC).
  * Splits the SFC into template and script sections, extracts strings

package/dist/modules/finalization/dependencies.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Package versions finalization adds to a project's package.json.
+ *
+ * i18next 26 / react-i18next 17 are the first majors whose optional
+ * TypeScript peer accepts TypeScript 6 — the default in new Vite and Expo
+ * apps. Older pins made `npm install` fail with ERESOLVE on the PR.
+ */
+export declare const I18NEXT_CORE_DEPENDENCIES: Record<string, string>;
+/** Browser apps load /locales/<lng>.json over HTTP and detect the browser's language. */
+export declare const I18NEXT_WEB_DEPENDENCIES: Record<string, string>;

package/dist/modules/finalization/dependencies.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.I18NEXT_WEB_DEPENDENCIES = exports.I18NEXT_CORE_DEPENDENCIES = void 0;
+/**
+ * Package versions finalization adds to a project's package.json.
+ *
+ * i18next 26 / react-i18next 17 are the first majors whose optional
+ * TypeScript peer accepts TypeScript 6 — the default in new Vite and Expo
+ * apps. Older pins made `npm install` fail with ERESOLVE on the PR.
+ */
+exports.I18NEXT_CORE_DEPENDENCIES = {
+    'i18next': '^26.4.0',
+    'react-i18next': '^17.0.0',
+    // Messages are ICU ("Welcome back, {user}", plurals): i18next-icu formats them.
+    'i18next-icu': '^2.5.0',
+    'intl-messageformat': '^10.7.0',
+};
+/** Browser apps load /locales/<lng>.json over HTTP and detect the browser's language. */
+exports.I18NEXT_WEB_DEPENDENCIES = {
+    ...exports.I18NEXT_CORE_DEPENDENCIES,
+    'i18next-http-backend': '^4.0.0',
+    'i18next-browser-languagedetector': '^8.2.0',
+};