internationalize
Orchestrates end-to-end i18n migration for React Native, React, Next.js, and Flutter: analyze, scan, plan, apply, translate, and validate with structured reporting.
Instructions
End-to-end orchestration tool for i18n migration across React Native, React (web), Next.js, and Flutter projects. Runs analyze -> scan -> plan -> apply -> translate -> validate with conservative defaults and complete structured reporting.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "internationalize"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apply | No | If true and dryRun is false, applies source code and locale file modifications. | |
| scope | No | Optional target directories or files to internationalize (e.g. ['src/features/auth']). | |
| apiKey | No | Optional API key for cloud translation provider. | |
| dryRun | No | If true (default), simulates execution, generates plan, and shows diff without modifying files. | |
| exclude | No | Glob patterns of files to exclude. | |
| include | No | Glob patterns of files to include. | |
| provider | No | Optional translation provider ('auto', 'deepl', 'openai', 'gemini', or 'dictionary'). Defaults to 'auto'. | |
| formality | No | Optional grammatical formality for translations ('formal', 'informal', or 'neutral'). | |
| structure | No | Optional i18n structure type override ('namespaces', 'nested', or 'flat'). Auto-detected by default. | |
| translate | No | If true and apply is true, translates missing target locale entries using dictionary and glossary. | |
| namespaces | No | Optional list of namespaces to limit planning and translation to. | |
| projectPath | No | Optional project root directory. Defaults to current working directory. | |
| createBackup | No | If true, creates .bak backup files before modifying any file on disk. | |
| sourceLocale | No | Source locale (e.g. 'en'). Defaults to detected project source locale. | |
| targetLocales | No | Target locales to internationalize and translate to (e.g. ['fr', 'es']). | |
| failOnWarnings | No | If true, halts and fails if any warning is encountered. | |
| candidateDecisions | No | Optional map of candidate ID (or text) to boolean decision (true = include as user-facing, false = skip as technical) for resolving ambiguous strings. | |
| providedTranslations | No | Optional map of agent-provided translations for target locales (e.g. { fr: { common: { save: 'Enregistrer' } } }). |