@babelize/engine 0.1.3 → 0.2.0

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/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

@@ -11,7 +11,7 @@ import { type FileDiffStat, type ApplyIo, type WorkspaceChanges } from './worksp
 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 BETA_LOCAL_FRAMEWORKS: readonly ["vue", "static", "react-native"];
 export interface LocalTranslateOptions {
     projectDir: string;
     sourceLocale: string;

package/dist/local/translate-core.js

@@ -73,7 +73,7 @@ const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
 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.BETA_LOCAL_FRAMEWORKS = ['vue', 'static', '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',
+};

package/dist/modules/finalization/finalize.js

@@ -45,43 +45,22 @@ const static_runtime_1 = require("./static-runtime");
 const django_finalize_1 = require("./django-finalize");
 const nextjs_finalize_1 = require("./nextjs-finalize");
 const writes_1 = require("./writes");
+const react_native_finalize_1 = require("./react-native-finalize");
+const dependencies_1 = require("./dependencies");
+const i18n_config_path_1 = require("../../utils/i18n-config-path");
 const i18next_icu_1 = require("../../utils/i18next-icu");
 const DEPENDENCIES_BY_FRAMEWORK = {
-    react: {
-        'i18next': '^24.0.0',
-        'react-i18next': '^14.0.0',
-        'i18next-http-backend': '^2.0.2',
-        'i18next-browser-languagedetector': '^8.0.0',
-        // Messages are ICU ("Welcome back, {user}", plurals): i18next-icu formats them.
-        'i18next-icu': '^2.5.0',
-        'intl-messageformat': '^10.7.0',
-    },
+    react: dependencies_1.I18NEXT_WEB_DEPENDENCIES,
     // Next.js projects that already use react-i18next keep it (injection picks
     // ReactI18nextStrategy for them). Everything else gets next-intl — see
     // NEXT_INTL_DEPENDENCIES and finalizeNextIntl().
-    nextjs: {
-        'i18next': '^24.0.0',
-        'react-i18next': '^14.0.0',
-        'i18next-http-backend': '^2.0.2',
-        'i18next-browser-languagedetector': '^8.0.0',
-        // Messages are ICU ("Welcome back, {user}", plurals): i18next-icu formats them.
-        'i18next-icu': '^2.5.0',
-        'intl-messageformat': '^10.7.0',
-    },
+    nextjs: dependencies_1.I18NEXT_WEB_DEPENDENCIES,
     vue: {
         'vue-i18n': '^10.0.0',
     },
     static: {},
     django: {},
-    unknown: {
-        'i18next': '^24.0.0',
-        'react-i18next': '^14.0.0',
-        'i18next-http-backend': '^2.0.2',
-        'i18next-browser-languagedetector': '^8.0.0',
-        // Messages are ICU ("Welcome back, {user}", plurals): i18next-icu formats them.
-        'i18next-icu': '^2.5.0',
-        'intl-messageformat': '^10.7.0',
-    },
+    unknown: dependencies_1.I18NEXT_WEB_DEPENDENCIES,
 };
 const I18N_CONFIG_TEMPLATES = {
     react: `${i18next_icu_1.GENERATED_I18N_CONFIG_MARKER}
@@ -101,7 +80,8 @@ i18n
   .init({
     fallbackLng: 'en',
     defaultNS: 'translation',
-    debug: process.env.NODE_ENV !== 'production',
+    // No process.env here: Vite and other browser builds don't define it (or its types).
+    debug: false,
     interpolation: {
       escapeValue: false,
     },
@@ -198,7 +178,7 @@ i18n
   .init({
     fallbackLng: 'en',
     defaultNS: 'translation',
-    debug: process.env.NODE_ENV !== 'production',
+    debug: false,
     interpolation: {
       escapeValue: false,
     },
@@ -250,12 +230,15 @@ async function finalizeProject(workspace, dryRun, options = {}) {
     const framework = types_1.FRAMEWORKS.includes(workspace.framework)
         ? workspace.framework
         : 'unknown';
-    let requiredDeps = DEPENDENCIES_BY_FRAMEWORK[framework];
+    let requiredDeps = DEPENDENCIES_BY_FRAMEWORK[framework] ?? {};
     // Mirrors StrategyFactory: a Next.js project that already has react-i18next
     // is injected with react-i18next; every other Next.js project gets next-intl.
     let useNextIntl = framework === 'nextjs';
     if (!['static', 'django'].includes(framework)) {
-        const packageJsonPath = path.join(workspace.path, 'package.json');
+        // The app's package.json (apps/mobile in a monorepo); the install below
+        // still runs at the root, where workspaces install and the lockfile lives.
+        const appRoot = path.join(workspace.path, workspace.appDir ?? '.');
+        const packageJsonPath = path.join(appRoot, 'package.json');
         if (await (0, file_utils_1.pathExists)(packageJsonPath)) {
             const pkg = await (0, file_utils_1.readJsonFile)(packageJsonPath);
             if (pkg) {
@@ -264,6 +247,13 @@ async function finalizeProject(workspace, dryRun, options = {}) {
                     useNextIntl = false;
                 if (useNextIntl)
                     requiredDeps = nextjs_finalize_1.NEXT_INTL_DEPENDENCIES;
+                if (framework === 'react-native') {
+                    // expo-localization pinned to the app's Expo SDK, or react-native-localize.
+                    const rn = (0, react_native_finalize_1.reactNativeDependencies)(pkg);
+                    requiredDeps = rn.deps;
+                    if (rn.warning)
+                        warnings.push(rn.warning);
+                }
                 const missingDeps = Object.keys(requiredDeps).filter((d) => !deps[d]);
                 if (missingDeps.length > 0) {
                     pkg.dependencies = pkg.dependencies || {};
@@ -334,7 +324,7 @@ async function finalizeProject(workspace, dryRun, options = {}) {
             }
         }
     }
-    const srcDir = workspace.sourceDirs.find((d) => d.includes('src')) || workspace.sourceDirs[0] || '.';
+    const srcDir = (0, i18n_config_path_1.i18nConfigDir)(workspace);
     if (framework === 'static') {
         const i18nJsPath = path.join(workspace.path, 'i18n.js');
         const existingContent = await (0, file_utils_1.pathExists)(i18nJsPath) ? await (0, file_utils_1.readFile)(i18nJsPath) : null;
@@ -379,6 +369,16 @@ async function finalizeProject(workspace, dryRun, options = {}) {
             }
         }
     }
+    else if (framework === 'react-native') {
+        const rn = await (0, react_native_finalize_1.finalizeReactNative)(workspace, {
+            sourceLocale: options.sourceLocale,
+            targetLocales: options.targetLocales,
+        }, writer);
+        warnings.push(...rn.warnings);
+        userOwnsInit = rn.userOwnsInit;
+        configFileCreated = configFileCreated || rn.configFileCreated;
+        entryPointModified = entryPointModified || rn.entryPointModified;
+    }
     else if (useNextIntl) {
         const nextIntl = await (0, nextjs_finalize_1.finalizeNextIntl)(workspace, dryRun, {
             sourceLocale: options.sourceLocale,
@@ -412,7 +412,7 @@ async function finalizeProject(workspace, dryRun, options = {}) {
         userOwnsInit = icu.userOwnsInit;
         if (!userOwnsInit && !(await (0, file_utils_1.pathExists)(i18nPath)) && !(await (0, file_utils_1.pathExists)(i18nJsPath))) {
             const isTS = workspace.sourceDirs.some((d) => d.endsWith('ts') || d.endsWith('tsx')) ||
-                (await (0, file_utils_1.pathExists)(path.join(workspace.path, 'tsconfig.json')));
+                (await (0, file_utils_1.pathExists)(path.join(workspace.path, workspace.appDir ?? '.', 'tsconfig.json')));
             const targetPath = isTS ? i18nPath : i18nJsPath;
             const template = I18N_CONFIG_TEMPLATES[framework] || I18N_CONFIG_TEMPLATES['unknown'];
             await writer.write(targetPath, template);
@@ -450,7 +450,7 @@ async function finalizeProject(workspace, dryRun, options = {}) {
     ];
     if (framework === 'vue') {
         for (const entry of entryPoints) {
-            const entryPath = path.join(workspace.path, entry);
+            const entryPath = path.join(workspace.path, workspace.appDir ?? '.', entry);
             if (await (0, file_utils_1.pathExists)(entryPath)) {
                 const content = await (0, file_utils_1.readFile)(entryPath);
                 const entryDir = path.dirname(entryPath);
@@ -468,9 +468,9 @@ async function finalizeProject(workspace, dryRun, options = {}) {
             }
         }
     }
-    else if (!['static', 'django'].includes(framework) && !useNextIntl && !userOwnsInit) {
+    else if (!['static', 'django', 'react-native'].includes(framework) && !useNextIntl && !userOwnsInit) {
         for (const entry of entryPoints) {
-            const entryPath = path.join(workspace.path, entry);
+            const entryPath = path.join(workspace.path, workspace.appDir ?? '.', entry);
             if (await (0, file_utils_1.pathExists)(entryPath)) {
                 const content = await (0, file_utils_1.readFile)(entryPath);
                 const entryDir = path.dirname(entryPath);
@@ -515,7 +515,7 @@ function modifyNextjsLayout(content, relativeI18nPath) {
     const providerImportPath = relativeI18nPath.replace(/i18n(\.(ts|js))?$/, 'I18nProvider');
     const isTS = content.includes(': Readonly') || content.includes(': React.ReactNode');
     try {
-        const ast = (0, ast_helpers_1.parseCode)(content, { isTypeScript: isTS });
+        const ast = (0, ast_helpers_1.parseCode)(content, { isTypeScript: isTS, preserveFormat: true });
         let modified = false;
         let wrapped = false;
         const sideEffectImports = [
@@ -596,7 +596,7 @@ function modifyNextjsLayoutFallback(content, providerImportPath) {
 function modifyVueEntryPoint(content, relativeI18nPath) {
     const isTS = /\.tsx?$/.test(relativeI18nPath) || /\bfrom\s+['"]vue['"]/.test(content) || /:\s*(?:string|number|boolean|Ref|ComputedRef)/.test(content);
     try {
-        const ast = (0, ast_helpers_1.parseCode)(content, { isTypeScript: isTS });
+        const ast = (0, ast_helpers_1.parseCode)(content, { isTypeScript: isTS, preserveFormat: true });
         let hasExistingImport = false;
         let modified = false;
         for (const node of ast.program.body) {
@@ -739,7 +739,9 @@ function i18nRuntimeFor(framework, pkg) {
         return { library: 'Django gettext', required: [], missing: [] };
     const deps = { ...(pkg?.dependencies ?? {}), ...(pkg?.devDependencies ?? {}) };
     const nextIntl = fw === 'nextjs' && !deps['react-i18next'];
-    const required = Object.keys(nextIntl ? nextjs_finalize_1.NEXT_INTL_DEPENDENCIES : DEPENDENCIES_BY_FRAMEWORK[fw]);
+    const required = Object.keys(nextIntl ? nextjs_finalize_1.NEXT_INTL_DEPENDENCIES
+        : fw === 'react-native' ? (0, react_native_finalize_1.reactNativeDependencies)(pkg ?? undefined).deps
+            : DEPENDENCIES_BY_FRAMEWORK[fw] ?? {});
     const library = nextIntl ? 'next-intl' : fw === 'vue' ? 'vue-i18n' : 'react-i18next';
     return { library, required, missing: required.filter((d) => !(pkg?.dependencies ?? {})[d]) };
 }

package/dist/modules/finalization/nextjs-finalize.js

@@ -241,7 +241,8 @@ writer = new writes_1.FinalizationWriter(workspace.path, dryRun)) {
     const warnings = [];
     let configFileCreated = false;
     let entryPointModified = false;
-    const root = workspace.path;
+    // The app's folder: the repo root, or apps/web in a monorepo.
+    const root = path.join(workspace.path, workspace.appDir ?? '.');
     const typescript = await (0, file_utils_1.pathExists)(path.join(root, 'tsconfig.json'));
     const appDir = (await (0, file_utils_1.pathExists)(path.join(root, 'app')))
         ? path.join(root, 'app')