i18next-cli 0.9.0

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0](https://github.com/i18next/i18next-cli/compare/v0.9.0...v1.0.0) - 2025-xx-yy
+
+- not yet released
+
+## [0.9.0] - 2025-09-25
+
+### Added
+
+This is the initial public release of `i18next-cli`, a complete, high-performance replacement for `i18next-parser` and `i18next-scanner`.
+
+#### Core Engine & Extractor
+-   Initial high-performance, SWC-based parsing engine for JavaScript and TypeScript.
+-   Advanced, scope-aware AST analysis for intelligent key extraction.
+-   Support for `t()` functions, `<Trans>` components, `useTranslation` hooks (including `keyPrefix` and aliasing), and `getFixedT`.
+-   Handles complex i18next features: namespaces (via ns-separator, options, and hooks), plurals, and context.
+-   Support for the type-safe selector API (`t($=>$.key.path)`).
+-   Extraction from commented-out code to support documentation-driven keys.
+
+#### Commands
+-   **`init`**: Interactive wizard to create a new configuration file (`i18next.config.ts` or `.js`).
+-   **`extract`**: Extracts keys and updates translation files, with `--watch` and `--ci` modes.
+-   **`types`**: Generates TypeScript definitions for type-safe i18next usage and autocompletion.
+-   **`sync`**: Synchronizes secondary language files with a primary language file, adding missing keys and removing unused ones.
+-   **`lint`**: Lints the codebase for potential issues like hardcoded strings.
+-   **`status`**: Displays a project health dashboard with a summary view and a detailed, key-by-key view (`status [locale]`).
+-   **`migrate-config`**: Provides an automatic migration path from a legacy `i18next-parser.config.js`.
+-   **`locize-*`**: Full suite of commands (`sync`, `download`, `migrate`) for seamless integration with the locize TMS, including an interactive setup for credentials.
+
+#### Configuration & DX
+-   **Zero-Config Mode**: `status` and `lint` commands work out-of-the-box on most projects by heuristically detecting the project structure.
+-   **Typed Configuration**: Fully-typed config file (`i18next.config.ts`) with a `defineConfig` helper.
+-   **Robust TS Support**: On-the-fly TypeScript config file loading (`.ts`) is supported in consumer projects via `jiti`.
+-   **Dynamic Key Support**: `preservePatterns` option to support dynamic keys.
+-   **Configurable Linter**: The linter can be customized with an `ignoredAttributes` option.
+-   **Polished UX**: Consistent `ora` spinners provide clear feedback on all asynchronous commands.
+-   **Dual CJS/ESM Support**: Modern package structure for broad compatibility.
+
+#### Plugin System
+-   Initial plugin architecture with `setup`, `onLoad`, `onVisitNode`, and `onEnd` hooks, allowing for custom extraction logic and support for other file types (e.g., HTML, Handlebars).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present i18next
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,489 @@
+# i18next-cli 🚀
+
+A unified, high-performance i18next CLI toolchain, powered by SWC.
+
+[![Tests](https://github.com/i18next/i18next-cli/workflows/node/badge.svg)](https://github.com/i18next/i18next-cli/actions?query=workflow%3Anode)
+[![npm version](https://img.shields.io/npm/v/i18next-cli.svg?style=flat-square)](https://www.npmjs.com/package/i18next-cli)
+
+---
+
+`i18next-cli` is a complete reimagining of the static analysis toolchain for the i18next ecosystem. It consolidates key extraction, type safety generation, locale syncing, linting, and cloud integrations into a single, cohesive, and blazing-fast CLI.
+
+> ### 🚀 Try it Now - Zero Config!
+> You can get an instant analysis of your existing i18next project **without any configuration**. Just run this command in your repository's root directory:
+>
+> ```bash
+> npx i18next-cli status
+> ```
+> Or find hardcoded strings:
+>
+> ```bash
+> npx i18next-cli lint
+> ```
+
+## Why i18next-cli?
+
+`i18next-cli` is built from the ground up to meet the demands of modern web development.
+
+- **🚀 Performance:** By leveraging a native Rust-based parser (SWC), it delivers orders-of-magnitude faster performance than JavaScript-based parsers.
+- **🧠 Intelligence:** A stateful, scope-aware analyzer correctly understands complex patterns like `useTranslation('ns1', { keyPrefix: '...' })`, `getFixedT`, and aliased `t` functions, minimizing the need for manual workarounds.
+- **✅ Unified Workflow:** One tool, one configuration file, one integrated workflow. It replaces various syncing scripts.
+- **🔌 Extensibility:** A modern plugin architecture allows the tool to adapt to any framework or custom workflow.
+- **🧑‍💻 Developer Experience:** A fully-typed configuration file, live `--watch` modes, CLI output, and a migration from legacy tools.
+
+## Features
+
+- **Key Extraction**: Extract translation keys from JavaScript/TypeScript files with advanced AST analysis.
+- **Type Safety**: Generate TypeScript definitions for full autocomplete and type safety.
+- **Locale Synchronization**: Keep all language files in sync with your primary language.
+- **Accurate Code Linting**: Detect hardcoded strings with high precision and configurable rules.
+- **Translation Status**: Get a high-level overview or a detailed, key-by-key report of your project's translation completeness.
+- **Plugin System**: Extensible architecture for custom extraction patterns and file types (e.g., HTML, Handlebars).
+- **Legacy Migration**: Automatic migration from `i18next-parser` configurations.
+- **Cloud Integration**: Seamless integration with the [locize](https://locize.com) translation management platform.
+
+## Installation
+
+```bash
+npm install --save-dev i18next-cli
+```
+
+## Quick Start
+
+### 1. Initialize Configuration
+
+Create a configuration interactively:
+
+```bash
+npx i18next-cli init
+```
+
+Or manually create `i18next.config.ts` in your project root:
+
+```typescript
+import { defineConfig } from 'i18next-cli';
+
+export default defineConfig({
+  locales: ['en', 'de'],
+  extract: {
+    input: ['src/**/*.{js,jsx,ts,tsx}'],
+    output: 'public/locales/{{language}}/{{namespace}}.json',
+  },
+});
+```
+
+### 2. Check your Translation Status
+
+Get an overview of your project's localization health:
+
+```bash
+npx i18next-cli status
+```
+
+### 3. Extract Translation Keys
+
+```bash
+npx i18next-cli extract
+```
+
+### 4. Generate Types (Optional)
+
+```bash
+npx i18next-cli types
+```
+
+## Commands
+
+### `init`
+Interactive setup wizard to create your configuration file.
+
+```bash
+npx i18next-cli init
+```
+
+### `extract`
+Parses source files, extracts keys, and updates your JSON translation files.
+
+```bash
+npx i18next-cli extract [options]
+```
+
+**Options:**
+- `--watch, -w`: Re-run automatically when files change
+- `--ci`: Exit with non-zero status if any files are updated (for CI/CD)
+
+**Examples:**
+```bash
+# One-time extraction
+npx i18next-cli extract
+
+# Watch mode for development
+npx i18next-cli extract --watch
+
+# CI mode (fails if files changed)
+npx i18next-cli extract --ci
+```
+
+### `status [locale]`
+
+Displays a health check of your project's translation status. Can run without a config file.
+
+  - Run `npx i18next-cli status` for a high-level summary.
+  - Run `npx i18next-cli status <locale>` for a detailed, key-by-key report grouped by namespace.
+
+This command provides:
+- Total number of translation keys found in your source code
+- Translation progress for each secondary language with visual progress bars
+- Percentage and key counts for easy tracking
+
+### `types`
+Generates TypeScript definitions from your translation files for full type-safety and autocompletion.
+
+```bash
+npx i18next-cli types [options]
+```
+
+**Options:**
+- `--watch, -w`: Re-run automatically when translation files change
+
+### `sync`
+Synchronizes secondary language files against your primary language file, adding missing keys and removing extraneous ones.
+
+```bash
+npx i18next-cli sync
+```
+
+### `lint`
+Analyzes your source code for internationalization issues like hardcoded strings. Can run without a config file.
+
+```bash
+npx i18next-cli lint
+```
+
+### `migrate-config`
+Automatically migrates a legacy `i18next-parser.config.js` file to the new `i18next.config.ts` format.
+
+```bash
+npx i18next-cli migrate-config
+```
+
+### Locize Integration
+
+**Prerequisites:** The locize commands require `locize-cli` to be installed:
+
+```bash
+# Install globally (recommended)
+npm install -g locize-cli
+```
+
+Sync translations with the Locize translation management platform:
+
+```bash
+# Download translations from Locize
+npx i18next-cli locize-download
+
+# Upload/sync translations to Locize  
+npx i18next-cli locize-sync
+
+# Migrate local translations to Locize
+npx i18next-cli locize-migrate
+```
+
+**Locize Command Options:**
+
+The `locize-sync` command supports additional options:
+
+```bash
+npx i18next-cli locize-sync [options]
+```
+
+**Options:**
+- `--update-values`: Update values of existing translations on locize
+- `--src-lng-only`: Check for changes in source language only
+- `--compare-mtime`: Compare modification times when syncing
+- `--dry-run`: Run the command without making any changes
+
+**Interactive Setup:** If your locize credentials are missing or invalid, the toolkit will guide you through an interactive setup process to configure your Project ID, API Key, and version.
+
+## Configuration
+
+The configuration file supports both TypeScript (`.ts`) and JavaScript (`.js`) formats. Use the `defineConfig` helper for type safety and IntelliSense.
+
+### Basic Configuration
+
+```typescript
+// i18next.config.ts
+import { defineConfig } from 'i18next-cli';
+
+export default defineConfig({
+  locales: ['en', 'de', 'fr'],
+  extract: {
+    input: ['src/**/*.{ts,tsx,js,jsx}'],
+    output: 'locales/{{language}}/{{namespace}}.json',
+  },
+});
+```
+
+### Advanced Configuration
+
+```typescript
+import { defineConfig } from 'i18next-cli';
+
+export default defineConfig({
+  locales: ['en', 'de', 'fr'],
+  
+  // Key extraction settings
+  extract: {
+    input: ['src/**/*.{ts,tsx}'],
+    output: 'locales/{{language}}/{{namespace}}.json',
+    
+    // Translation functions to detect
+    functions: ['t', 'i18n.t', 'i18next.t'],
+    
+    // React components to analyze
+    transComponents: ['Trans', 'Translation'],
+    
+    // useTranslation hook variations
+    useTranslationNames: ['useTranslation', 'useAppTranslation'],
+
+    // Add custom JSX attributes to ignore during linting
+    ignoredAttributes: ['data-testid', 'aria-label'],
+    
+    // Namespace and key configuration
+    defaultNS: 'translation',
+    nsSeparator: ':',
+    keySeparator: '.',
+    contextSeparator: '_',
+    pluralSeparator: '_',
+    
+    // Preserve dynamic keys matching patterns
+    preservePatterns: [
+      'dynamic.feature.*',
+      'generated.*.key'
+    ],
+    
+    // Output formatting
+    sort: true,
+    indentation: 2,
+    
+    // Primary language settings
+    primaryLanguage: 'en',
+    secondaryLanguages: ['de', 'fr'],
+
+    defaultValue: '', // Default value for missing keys
+  },
+  
+  // TypeScript type generation
+  types: {
+    input: ['locales/en/*.json'],
+    output: 'src/types/i18next.d.ts',
+    resourcesFile: 'src/types/resources.d.ts',
+    enableSelector: true, // Enable type-safe key selection
+  },
+  
+  // Locize integration
+  locize: {
+    projectId: 'your-project-id',
+    apiKey: process.env.LOCIZE_API_KEY, // Recommended: use environment variables
+    version: 'latest',
+  },
+  
+  // Plugin system
+  plugins: [
+    // Add custom plugins here
+  ],
+});
+```
+
+## Advanced Features
+
+### Plugin System
+
+Create custom plugins to extend extraction capabilities. The plugin system is powerful enough to support non-JavaScript files (e.g., HTML, Handlebars) by using the `onEnd` hook with custom parsers.
+
+```typescript
+import { defineConfig, Plugin } from 'i18next-cli';
+
+const myCustomPlugin = (): Plugin => ({
+  name: 'my-custom-plugin',
+  
+  async setup() {
+    // Initialize plugin
+  },
+  
+  async onLoad(code: string, file: string) {
+    // Transform code before parsing
+    return code;
+  },
+  
+  onVisitNode(node: any, context: PluginContext) {
+    // Custom AST node processing
+    if (node.type === 'CallExpression') {
+      // Extract custom translation patterns
+      context.addKey({
+        key: 'custom.key',
+        defaultValue: 'Custom Value',
+        ns: 'custom'
+      });
+    }
+  },
+  
+  async onEnd(allKeys: Map<string, ExtractedKey>) {
+    // Process all extracted keys or add additional keys from non-JS files
+    // Example: Parse HTML files for data-i18n attributes
+    const htmlFiles = await glob('src/**/*.html');
+    for (const file of htmlFiles) {
+      const content = await readFile(file, 'utf-8');
+      const matches = content.match(/data-i18n="([^"]+)"/g) || [];
+      for (const match of matches) {
+        const key = match.replace(/data-i18n="([^"]+)"/, '$1');
+        allKeys.set(`translation:${key}`, { key, ns: 'translation' });
+      }
+    }
+  }
+});
+
+export default defineConfig({
+  locales: ['en', 'de'],
+  plugins: [myCustomPlugin()],
+  // ... other config
+});
+```
+
+### Dynamic Key Preservation
+
+Use `preservePatterns` to maintain dynamically generated keys:
+
+```typescript
+// Code like this:
+const key = `user.${role}.permission`;
+t(key);
+
+// With this config:
+export default defineConfig({
+  extract: {
+    preservePatterns: ['user.*.permission']
+  }
+});
+
+// Will preserve existing keys matching the pattern
+```
+
+### Comment-Based Extraction
+
+Extract keys from comments for documentation or edge cases:
+
+```javascript
+// t('welcome.message', 'Welcome to our app!')
+// t('user.greeting', { defaultValue: 'Hello!', ns: 'common' })
+```
+
+## Migration from i18next-parser
+
+Automatically migrate from legacy `i18next-parser.config.js`:
+
+```bash
+npx i18next-cli migrate-config
+```
+
+This will:
+- Convert your existing configuration to the new format
+- Map old options to new equivalents
+- Preserve custom settings where possible
+- Create a new `i18next.config.ts` file
+
+## CI/CD Integration
+
+Use the `--ci` flag to fail builds when translations are outdated:
+
+```yaml
+# GitHub Actions example
+- name: Check translations
+  run: npx i18next-cli extract --ci
+```
+
+## Watch Mode
+
+For development, use watch mode to automatically update translations:
+
+```bash
+npx i18next-cli extract --watch
+```
+
+## Type Safety
+
+Generate TypeScript definitions for full type safety:
+
+```typescript
+// Generated types enable autocomplete and validation
+t('user.profile.name'); // ✅ Valid key
+t('invalid.key');       // ❌ TypeScript error
+```
+
+---
+
+## Supported Patterns
+
+The toolkit automatically detects these i18next usage patterns:
+
+### Function Calls
+```javascript
+// Basic usage
+t('key')
+t('key', 'Default value')
+t('key', { defaultValue: 'Default' })
+
+// With namespaces
+t('ns:key')
+t('key', { ns: 'namespace' })
+
+// With interpolation
+t('key', { name: 'John' })
+```
+
+### React Components
+```jsx
+// Trans component
+<Trans i18nKey="welcome">Welcome {{name}}</Trans>
+<Trans ns="common">user.greeting</Trans>
+
+// useTranslation hook
+const { t } = useTranslation('namespace');
+const { t } = useTranslation(['ns1', 'ns2']);
+```
+
+### Complex Patterns
+```javascript
+// Aliased functions
+const translate = t;
+translate('key');
+
+// Destructured hooks
+const { t: translate } = useTranslation();
+
+// getFixedT
+const fixedT = getFixedT('en', 'namespace');
+fixedT('key');
+```
+
+---
+
+<h3 align="center">Gold Sponsors</h3>
+
+<p align="center">
+  <a href="https://www.locize.com/" target="_blank">
+    <img src="https://raw.githubusercontent.com/i18next/i18next/master/assets/locize_sponsor_240.gif" width="240px">
+  </a>
+</p>
+
+---
+
+**From the creators of i18next: localization as a service - locize.com**
+
+A translation management system built around the i18next ecosystem - [locize.com](https://www.locize.com).
+
+![locize](https://cdn.prod.website-files.com/67a323e323a50df7f24f0a6f/67b8bbb29365c3a3c21c0898_github_locize.png)
+
+With using [locize](https://locize.com/?utm_source=i18next_readme&utm_medium=github) you directly support the future of i18next.
+
+---

package/dist/cjs/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+"use strict";var e=require("commander"),o=require("chokidar"),t=require("glob"),n=require("chalk"),i=require("./config.js"),a=require("./heuristic-config.js"),r=require("./extractor/core/extractor.js");require("node:fs/promises"),require("node:path");var c=require("./types-generator.js"),s=require("./syncer.js"),l=require("./migrator.js"),u=require("./init.js"),d=require("./linter.js"),g=require("./status.js"),f=require("./locize.js");const p=new e.Command;p.name("i18next-cli").description("A unified, high-performance i18next CLI.").version("0.9.0"),p.command("extract").description("Extract translation keys from source files and update resource files.").option("-w, --watch","Watch for file changes and re-run the extractor.").option("--ci","Exit with a non-zero status code if any files are updated.").action(async e=>{const a=await i.ensureConfig(),c=async()=>{const o=await r.runExtractor(a);e.ci&&o&&(console.error(n.red.bold("\n[CI Mode] Error: Translation files were updated. Please commit the changes.")),console.log(n.yellow("💡 Tip: Tired of committing JSON files? locize syncs your team automatically => https://www.locize.com/docs/getting-started")),console.log(`   Learn more: ${n.cyan("npx i18next-cli locize-sync")}`),process.exit(1))};if(await c(),e.watch){console.log("\nWatching for changes...");o.watch(await t.glob(a.extract.input),{ignored:/node_modules/,persistent:!0}).on("change",e=>{console.log(`\nFile changed: ${e}`),c()})}}),p.command("status [locale]").description("Display translation status. Provide a locale for a detailed key-by-key view.").action(async e=>{let o=await i.loadConfig();if(!o){console.log(n.blue("No config file found. Attempting to detect project structure..."));const e=await a.detectConfig();e||(console.error(n.red("Could not automatically detect your project structure.")),console.log(`Please create a config file first by running: ${n.cyan("npx i18next-cli init")}`),process.exit(1)),console.log(n.green("Project structure detected successfully!")),o=e}await g.runStatus(o,{detail:e})}),p.command("types").description("Generate TypeScript definitions from translation resource files.").option("-w, --watch","Watch for file changes and re-run the type generator.").action(async e=>{const n=await i.ensureConfig(),a=()=>c.runTypesGenerator(n);if(await a(),e.watch){console.log("\nWatching for changes...");o.watch(await t.glob(n.types?.input||[]),{persistent:!0}).on("change",e=>{console.log(`\nFile changed: ${e}`),a()})}}),p.command("sync").description("Synchronize secondary language files with the primary language file.").action(async()=>{const e=await i.ensureConfig();await s.runSyncer(e)}),p.command("migrate-config").description("Migrate a legacy i18next-parser.config.js to the new format.").action(async()=>{await l.runMigrator()}),p.command("init").description("Create a new i18next.config.ts/js file with an interactive setup wizard.").action(u.runInit),p.command("lint").description("Find potential issues like hardcoded strings in your codebase.").action(async()=>{let e=await i.loadConfig();if(!e){console.log(n.blue("No config file found. Attempting to detect project structure..."));const o=await a.detectConfig();o||(console.error(n.red("Could not automatically detect your project structure.")),console.log(`Please create a config file first by running: ${n.cyan("npx i1e-toolkit init")}`),process.exit(1)),console.log(n.green("Project structure detected successfully!")),e=o}await d.runLinter(e)}),p.command("locize-sync").description("Synchronize local translations with your locize project.").option("--update-values","Update values of existing translations on locize.").option("--src-lng-only","Check for changes in source language only.").option("--compare-mtime","Compare modification times when syncing.").option("--dry-run","Run the command without making any changes.").action(async e=>{const o=await i.ensureConfig();await f.runLocizeSync(o,e)}),p.command("locize-download").description("Download all translations from your locize project.").action(async e=>{const o=await i.ensureConfig();await f.runLocizeDownload(o,e)}),p.command("locize-migrate").description("Migrate local translation files to a new locize project.").action(async e=>{const o=await i.ensureConfig();await f.runLocizeMigrate(o,e)}),p.parse(process.argv);

package/dist/cjs/config.js

@@ -0,0 +1 @@
+"use strict";var e=require("node:path"),r=require("node:url"),n=require("node:fs/promises"),o=require("jiti"),t=require("inquirer"),i=require("chalk"),a=require("./init.js"),c="undefined"!=typeof document?document.currentScript:null;const s=["i18next.config.ts","i18next.config.js","i18next.config.mjs","i18next.config.cjs"];async function u(){const t=await async function(){for(const r of s){const o=e.resolve(process.cwd(),r);try{return await n.access(o),o}catch{}}return null}();if(!t)return null;try{let e;if(t.endsWith(".ts")){const r=o.createJiti("undefined"==typeof document?require("url").pathToFileURL(__filename).href:c&&"SCRIPT"===c.tagName.toUpperCase()&&c.src||new URL("config.js",document.baseURI).href),n=await r.import(t,{default:!0});e=n}else{const n=r.pathToFileURL(t).href,o=await import(`${n}?t=${Date.now()}`);e=o.default}return e?(e.extract||={},e.extract.primaryLanguage||=e.locales[0]||"en",e.extract.secondaryLanguages||=e.locales.filter(r=>r!==e.extract.primaryLanguage),e):(console.error(`Error: No default export found in ${t}`),null)}catch(e){return console.error(`Error loading configuration from ${t}`),console.error(e),null}}exports.defineConfig=function(e){return e},exports.ensureConfig=async function(){let e=await u();if(e)return e;const{shouldInit:r}=await t.prompt([{type:"confirm",name:"shouldInit",message:i.yellow("Configuration file not found. Would you like to create one now?"),default:!0}]);if(r){if(await a.runInit(),console.log(i.green("Configuration created. Resuming command...")),e=await u(),e)return e;console.error(i.red("Error: Failed to load configuration after creation. Please try running the command again.")),process.exit(1)}else console.log("Operation cancelled. Please create a configuration file to proceed."),process.exit(0)},exports.loadConfig=u;

package/dist/cjs/extractor/core/extractor.js

@@ -0,0 +1 @@
+"use strict";var t=require("ora"),e=require("chalk"),r=require("@swc/core"),a=require("node:fs/promises"),n=require("node:path"),s=require("./key-finder.js"),o=require("./translation-manager.js"),i=require("../../utils/validation.js"),c=require("../plugin-manager.js"),u=require("../parsers/comment-parser.js"),l=require("../parsers/ast-visitors.js"),g=require("../../utils/logger.js");function f(t,e,r){if(t&&"object"==typeof t){for(const a of e)try{a.onVisitNode?.(t,r)}catch(t){console.warn(`Plugin ${a.name} onVisitNode failed:`,t)}for(const a of Object.keys(t)){const n=t[a];if(Array.isArray(n))for(const t of n)t&&"object"==typeof t&&f(t,e,r);else n&&"object"==typeof n&&f(n,e,r)}}}exports.extract=async function(t){t.extract.primaryLanguage||(t.extract.primaryLanguage=t.locales[0]),t.extract.secondaryLanguages||(t.extract.secondaryLanguages=t.locales.filter(e=>e!==t?.extract?.primaryLanguage)),t.extract.functions||(t.extract.functions=["t"]),t.extract.transComponents||(t.extract.transComponents=["Trans"]);const e=await s.findKeys(t);return o.getTranslations(e,t)},exports.processFile=async function(t,e,n,s){try{let o=await a.readFile(t,"utf-8");for(const r of e.plugins||[])o=await(r.onLoad?.(o,t))??o;const i=await r.parse(o,{syntax:"typescript",tsx:!0,comments:!0}),g=c.createPluginContext(s);u.extractKeysFromComments(o,e.extract.functions||["t"],g,e);new l.ASTVisitors(e,g,n).visit(i),(e.plugins||[]).length>0&&f(i,e.plugins||[],g)}catch(e){throw new i.ExtractorError("Failed to process file",t,e)}},exports.runExtractor=async function(r,c=new g.ConsoleLogger){r.extract.primaryLanguage||(r.extract.primaryLanguage=r.locales[0]||"en"),r.extract.secondaryLanguages||(r.extract.secondaryLanguages=r.locales.filter(t=>t!==r?.extract?.primaryLanguage)),i.validateExtractorConfig(r);const u=t("Running i18next key extractor...\n").start();try{const t=await s.findKeys(r,c);u.text=`Found ${t.size} unique keys. Updating translation files...`;const i=await o.getTranslations(t,r);let l=!1;for(const t of i)t.updated&&(l=!0,await a.mkdir(n.dirname(t.path),{recursive:!0}),await a.writeFile(t.path,JSON.stringify(t.newTranslations,null,2)),c.info(e.green(`Updated: ${t.path}`)));return u.succeed(e.bold("Extraction complete!")),l}catch(t){throw u.fail(e.red("Extraction failed.")),t}};

package/dist/cjs/extractor/core/key-finder.js

@@ -0,0 +1 @@
+"use strict";var e=require("glob"),n=require("./extractor.js"),r=require("../../utils/logger.js"),i=require("../plugin-manager.js");exports.findKeys=async function(o,s=new r.ConsoleLogger){const t=await async function(n){return await e.glob(n.extract.input,{ignore:"node_modules/**",cwd:process.cwd()})}(o),a=new Map;await i.initializePlugins(o.plugins||[]);for(const e of t)await n.processFile(e,o,s,a);for(const e of o.plugins||[])await(e.onEnd?.(a));return a};

package/dist/cjs/extractor/core/translation-manager.js

@@ -0,0 +1 @@
+"use strict";var e=require("node:fs/promises"),t=require("node:path"),a=require("../../utils/nested-object.js"),s=require("../../utils/file-utils.js");function r(e){const t=`^${e.replace(/[.+?^${}()|[\]\\]/g,"\\$&").replace(/\*/g,".*")}$`;return new RegExp(t)}exports.getTranslations=async function(n,o){const c=o.extract.defaultNS??"translation",u=o.extract.keySeparator??".",l=(o.extract.preservePatterns??[]).map(r);o.extract.primaryLanguage||(o.extract.primaryLanguage=o.locales[0]||"en"),o.extract.secondaryLanguages||(o.extract.secondaryLanguages=o.locales.filter(e=>e!==o.extract.primaryLanguage));const i=new Map;for(const e of n.values()){const t=e.ns||c;i.has(t)||i.set(t,[]),i.get(t).push(e)}const g=[];for(const r of o.locales)for(const[n,c]of i.entries()){const i=s.getOutputPath(o.extract.output,r,n),p=t.resolve(process.cwd(),i);let f="",d={};try{f=await e.readFile(p,"utf-8"),d=JSON.parse(f)}catch(e){}const x={},y=a.getNestedKeys(d,u);for(const e of y)if(l.some(t=>t.test(e))){const t=a.getNestedValue(d,e,u);a.setNestedValue(x,e,t,u)}const m=!1===o.extract.sort?c:c.sort((e,t)=>e.key.localeCompare(t.key));for(const{key:e,defaultValue:t}of m){const s=a.getNestedValue(d,e,u)??(r===o.extract?.primaryLanguage?t:"");a.setNestedValue(x,e,s,u)}const N=o.extract.indentation??2,h=JSON.stringify(x,null,N);g.push({path:p,updated:h!==f,newTranslations:x,existingTranslations:d})}return g};

package/dist/cjs/extractor/parsers/ast-visitors.js

@@ -0,0 +1 @@
+"use strict";var e=require("./jsx-parser.js");exports.ASTVisitors=class{pluginContext;config;logger;scopeStack=[];constructor(e,t,n){this.pluginContext=t,this.config=e,this.logger=n}visit(e){this.enterScope(),this.walk(e),this.exitScope()}walk(e){if(!e)return;let t=!1;switch("Function"!==e.type&&"ArrowFunctionExpression"!==e.type&&"FunctionExpression"!==e.type||(this.enterScope(),t=!0),e.type){case"VariableDeclarator":this.handleVariableDeclarator(e);break;case"CallExpression":this.handleCallExpression(e);break;case"JSXElement":this.handleJSXElement(e)}for(const t in e){if("span"===t)continue;const n=e[t];if(Array.isArray(n))for(const e of n)e&&"object"==typeof e&&e.type&&this.walk(e);else n&&n.type&&this.walk(n)}t&&this.exitScope()}enterScope(){this.scopeStack.push(new Map)}exitScope(){this.scopeStack.pop()}setVarInScope(e,t){this.scopeStack.length>0&&this.scopeStack[this.scopeStack.length-1].set(e,t)}getVarFromScope(e){for(let t=this.scopeStack.length-1;t>=0;t--)if(this.scopeStack[t].has(e))return this.scopeStack[t].get(e)}handleVariableDeclarator(e){if("CallExpression"!==e.init?.type)return;const t=e.init.callee;"Identifier"===t.type&&(this.config.extract.useTranslationNames||["useTranslation"]).indexOf(t.value)>-1?this.handleUseTranslationDeclarator(e):"MemberExpression"===t.type&&"Identifier"===t.property.type&&"getFixedT"===t.property.value&&this.handleGetFixedTDeclarator(e)}handleUseTranslationDeclarator(e){if(!e.init||"CallExpression"!==e.init.type)return;let t;if("ArrayPattern"===e.id.type){const n=e.id.elements[0];"Identifier"===n?.type&&(t=n.value)}if("ObjectPattern"===e.id.type)for(const n of e.id.properties){if("AssignmentPatternProperty"===n.type&&"Identifier"===n.key.type&&"t"===n.key.value){t="t";break}if("KeyValuePatternProperty"===n.type&&"Identifier"===n.key.type&&"t"===n.key.value&&"Identifier"===n.value.type){t=n.value.value;break}}if(!t)return;const n=e.init.arguments?.[0]?.expression;let i;"StringLiteral"===n?.type?i=n.value:"ArrayExpression"===n?.type&&"StringLiteral"===n.elements[0]?.expression.type&&(i=n.elements[0].expression.value);const r=e.init.arguments?.[1]?.expression;let s;"ObjectExpression"===r?.type&&(s=this.getObjectPropValue(r,"keyPrefix")),this.setVarInScope(t,{defaultNs:i,keyPrefix:s})}handleGetFixedTDeclarator(e){if("Identifier"!==e.id.type||!e.init||"CallExpression"!==e.init.type)return;const t=e.id.value,n=e.init.arguments,i=n[1]?.expression,r=n[2]?.expression,s="StringLiteral"===i?.type?i.value:void 0,a="StringLiteral"===r?.type?r.value:void 0;(s||a)&&this.setVarInScope(t,{defaultNs:s,keyPrefix:a})}handleCallExpression(e){const t=e.callee;if("Identifier"!==t.type)return;const n=(this.config.extract.functions||[]).includes(t.value),i=this.getVarFromScope(t.value);if(!n&&!(void 0!==i))return;if(0===e.arguments.length)return;const r=e.arguments[0].expression;let s,a=null;if("StringLiteral"===r.type?a=r.value:"ArrowFunctionExpression"===r.type&&(a=this.extractKeyFromSelector(r)),!a)return;let o=a;const l=e.arguments.length>1?e.arguments[1].expression:void 0;"ObjectExpression"===l?.type&&(s=this.getObjectPropValue(l,"ns")),!s&&i?.defaultNs&&(s=i.defaultNs);const p=this.config.extract.nsSeparator??":",u=this.config.extract.contextSeparator??"_";if(!s&&p&&a.includes(p)){const e=a.split(p);s=e.shift(),a=e.join(p),o=a}if(s||(s=this.config.extract.defaultNS),i?.keyPrefix){const e=this.config.extract.keySeparator??".";o=`${i.keyPrefix}${e}${a}`}const c="StringLiteral"===r.type?this.getDefaultValue(e,a):a;if("ObjectExpression"===l?.type){const e=this.getObjectPropValue(l,"context");if(e)return void this.pluginContext.addKey({key:`${o}${u}${e}`,ns:s,defaultValue:c});if(void 0!==this.getObjectPropValue(l,"count"))return void this.handlePluralKeys(o,c,s)}this.pluginContext.addKey({key:o,ns:s,defaultValue:c})}handlePluralKeys(e,t,n){try{const i=new Intl.PluralRules(this.config.extract?.primaryLanguage).resolvedOptions().pluralCategories,r=this.config.extract.pluralSeparator??"_";for(const s of i)this.pluginContext.addKey({key:`${e}${r}${s}`,ns:n,defaultValue:t,hasCount:!0})}catch(i){this.logger.warn(`Could not determine plural rules for language "${this.config.extract?.primaryLanguage}". Falling back to simple key extraction.`),this.pluginContext.addKey({key:e,defaultValue:t,ns:n})}}getDefaultValue(e,t){if(e.arguments.length<=1)return t;const n=e.arguments[1].expression;return"StringLiteral"===n.type?n.value||t:"ObjectExpression"===n.type&&this.getObjectPropValue(n,"defaultValue")||t}handleJSXElement(t){const n=this.getElementName(t);if(n&&(this.config.extract.transComponents||["Trans"]).includes(n)){const n=e.extractFromTransComponent(t,this.config);if(n){if(!n.ns){const e=t.opening.attributes?.find(e=>"JSXAttribute"===e.type&&"Identifier"===e.name.type&&"t"===e.name.value);if("JSXAttribute"===e?.type&&"JSXExpressionContainer"===e.value?.type&&"Identifier"===e.value.expression.type){const t=e.value.expression.value,i=this.getVarFromScope(t);i?.defaultNs&&(n.ns=i.defaultNs)}}n.ns||(n.ns=this.config.extract.defaultNS),n.hasCount?this.handlePluralKeys(n.key,n.defaultValue,n.ns):this.pluginContext.addKey(n)}}}getElementName(e){if("Identifier"===e.opening.name.type)return e.opening.name.value;if("JSXMemberExpression"===e.opening.name.type){let t=e.opening.name;const n=[];for(;"JSXMemberExpression"===t.type;)"Identifier"===t.property.type&&n.unshift(t.property.value),t=t.object;return"Identifier"===t.type&&n.unshift(t.value),n.join(".")}}getObjectPropValue(e,t){const n=e.properties.find(e=>"KeyValueProperty"===e.type&&("Identifier"===e.key?.type&&e.key.value===t||"StringLiteral"===e.key?.type&&e.key.value===t));if("KeyValueProperty"===n?.type){const e=n.value;return"StringLiteral"===e.type?e.value:""}}extractKeyFromSelector(e){let t=e.body;if("BlockStatement"===t.type){const e=t.stmts.find(e=>"ReturnStatement"===e.type);if("ReturnStatement"!==e?.type||!e.argument)return null;t=e.argument}let n=t;const i=[];for(;"MemberExpression"===n.type;){const e=n.property;if("Identifier"===e.type)i.unshift(e.value);else{if("Computed"!==e.type||"StringLiteral"!==e.expression.type)return null;i.unshift(e.expression.value)}n=n.object}if(i.length>0){const e=this.config.extract.keySeparator,t="string"==typeof e?e:".";return i.join(t)}return null}};

package/dist/cjs/extractor/parsers/comment-parser.js

@@ -0,0 +1 @@
+"use strict";function e(e){const t=/^\s*,\s*(['"])(.*?)\1/.exec(e);if(t)return t[2];const s=/^\s*,\s*\{[^}]*defaultValue\s*:\s*(['"])(.*?)\1/.exec(e);return s?s[2]:void 0}function t(e){const t=/^\s*,\s*\{[^}]*ns\s*:\s*(['"])(.*?)\1/.exec(e);if(t)return t[2]}exports.extractKeysFromComments=function(s,n,c,o){const r=n.map(e=>e.replace(/[.+?^${}()|[\]\\]/g,"\\$&")).join("|"),u=new RegExp(`(?:${r})\\s*\\(\\s*(['"])([^'"]+)\\1`,"g"),i=function(e){const t=[],s=new Set,n=/\/\/(.*)|\/\*([\s\S]*?)\*\//g;let c;for(;null!==(c=n.exec(e));){const e=(c[1]??c[2]).trim();e&&!s.has(e)&&(s.add(e),t.push(e))}return t}(s);for(const s of i){let n;for(;null!==(n=u.exec(s));){let r,u=n[2];const i=s.slice(n.index+n[0].length),l=e(i);r=t(i);const a=o.extract.nsSeparator??":";if(!r&&a&&u.includes(a)){const e=u.split(a);r=e.shift(),u=e.join(a)}r||(r=o.extract.defaultNS),c.addKey({key:u,ns:r,defaultValue:l??u})}}};

package/dist/cjs/extractor/parsers/jsx-parser.js

@@ -0,0 +1 @@
+"use strict";function e(e,t){const n=new Set(t.extract.transKeepBasicHtmlNodesFor??["br","strong","i","p"]);return function e(t){let i="";return t.forEach((t,r)=>{if("JSXText"===t.type)i+=t.value;else if("JSXExpressionContainer"===t.type){const e=t.expression;if("StringLiteral"===e.type)i+=e.value;else if("Identifier"===e.type)i+=`{{${e.value}}}`;else if("ObjectExpression"===e.type){const t=e.properties[0];t&&"Identifier"===t.type&&(i+=`{{${t.value}}}`)}}else if("JSXElement"===t.type){let a;"Identifier"===t.opening.name.type&&(a=t.opening.name.value);const l=e(t.children);a&&n.has(a)?i+=`<${a}>${l}</${a}>`:i+=`<${r}>${l}</${r}>`}else"JSXFragment"===t.type&&(i+=e(t.children))}),i}(e).trim().replace(/\s{2,}/g," ")}exports.extractFromTransComponent=function(t,n){const i=t.opening.attributes?.find(e=>"JSXAttribute"===e.type&&"Identifier"===e.name.type&&"i18nKey"===e.name.value),r=t.opening.attributes?.find(e=>"JSXAttribute"===e.type&&"Identifier"===e.name.type&&"defaults"===e.name.value),a=t.opening.attributes?.find(e=>"JSXAttribute"===e.type&&"Identifier"===e.name.type&&"count"===e.name.value),l=!!a;let u;if(u="JSXAttribute"===i?.type&&"StringLiteral"===i.value?.type?i.value.value:e(t.children,n),!u)return null;const p=t.opening.attributes?.find(e=>"JSXAttribute"===e.type&&"Identifier"===e.name.type&&"ns"===e.name.value),s="JSXAttribute"===p?.type&&"StringLiteral"===p.value?.type?p.value.value:void 0;let o=n.extract.defaultValue||"";return o="JSXAttribute"===r?.type&&"StringLiteral"===r.value?.type?r.value.value:e(t.children,n),{key:u,ns:s,defaultValue:o||u,hasCount:l}};

package/dist/cjs/extractor/plugin-manager.js

@@ -0,0 +1 @@
+"use strict";exports.createPluginContext=function(t){return{addKey:e=>{const n=`${e.ns??"translation"}:${e.key}`;if(!t.has(n)){const s=e.defaultValue??e.key;t.set(n,{...e,defaultValue:s})}}}},exports.initializePlugins=async function(t){for(const e of t)await(e.setup?.())};

package/dist/cjs/heuristic-config.js

@@ -0,0 +1 @@
+"use strict";var e=require("glob"),s=require("node:fs/promises"),n=require("node:path");const o=["public/locales/dev/*.json","locales/dev/*.json","src/locales/dev/*.json","src/assets/locales/dev/*.json","public/locales/en/*.json","locales/en/*.json","src/locales/en/*.json","src/assets/locales/en/*.json"];exports.detectConfig=async function(){for(const t of o){const o=await e.glob(t,{ignore:"node_modules/**"});if(o.length>0){const e=o[0],t=n.dirname(n.dirname(e));try{let e=(await s.readdir(t)).filter(e=>/^(dev|[a-z]{2}(-[A-Z]{2})?)$/.test(e));if(e.length>0)return e.sort(),e.includes("dev")&&(e=["dev",...e.filter(e=>"dev"!==e)]),e.includes("en")&&(e=["en",...e.filter(e=>"en"!==e)]),{locales:e,extract:{input:["src/**/*.{js,jsx,ts,tsx}"],output:n.join(t,"{{language}}","{{namespace}}.json"),primaryLanguage:e.includes("en")?"en":e[0]}}}catch{continue}}}return null};

package/dist/cjs/index.js

@@ -0,0 +1 @@
+"use strict";var e=require("./config.js"),r=require("./extractor/core/extractor.js"),t=require("./extractor/core/key-finder.js"),o=require("./extractor/core/translation-manager.js");exports.defineConfig=e.defineConfig,exports.extract=r.extract,exports.findKeys=t.findKeys,exports.getTranslations=o.getTranslations;

package/dist/cjs/init.js

@@ -0,0 +1 @@
+"use strict";var e=require("inquirer"),t=require("node:fs/promises"),n=require("node:path");exports.runInit=async function(){console.log("Welcome to the i18next-cli setup wizard!");const i=await e.prompt([{type:"list",name:"fileType",message:"What kind of configuration file do you want?",choices:["TypeScript (i18next.config.ts)","JavaScript (i18next.config.js)"]},{type:"input",name:"locales",message:"What locales does your project support? (comma-separated)",default:"en,de,fr",filter:e=>e.split(",").map(e=>e.trim())},{type:"input",name:"input",message:"What is the glob pattern for your source files?",default:"src/**/*.{js,jsx,ts,tsx}"},{type:"input",name:"output",message:"What is the path for your output resource files?",default:"public/locales/{{language}}/{{namespace}}.json"}]),o=i.fileType.includes("TypeScript"),r=await async function(){try{const e=n.resolve(process.cwd(),"package.json"),i=await t.readFile(e,"utf-8");return"module"===JSON.parse(i).type}catch{return!0}}(),s=o?"i18next.config.ts":"i18next.config.js",a={locales:i.locales,extract:{input:i.input,output:i.output}};function p(e,t=2,n=0){const i=e=>" ".repeat(e*t),o=i(n),r=i(n+1);if(null===e||"number"==typeof e||"boolean"==typeof e)return JSON.stringify(e);if("string"==typeof e)return JSON.stringify(e);if(Array.isArray(e)){if(0===e.length)return"[]";return`[\n${e.map(e=>`${r}${p(e,t,n+1)}`).join(",\n")}\n${o}]`}if("object"==typeof e){const i=Object.keys(e);if(0===i.length)return"{}";return`{\n${i.map(i=>{const o=/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(i)?i:JSON.stringify(i);return`${r}${o}: ${p(e[i],t,n+1)}`}).join(",\n")}\n${o}}`}return JSON.stringify(e)}let f="";f=o?`import { defineConfig } from 'i18next-cli';\n\nexport default defineConfig(${p(a)});`:r?`import { defineConfig } from 'i18next-cli';\n\n/** @type {import('i18next-cli').I18nextToolkitConfig} */\nexport default defineConfig(${p(a)});`:`const { defineConfig } = require('i18next-cli');\n\n/** @type {import('i18next-cli').I18nextToolkitConfig} */\nmodule.exports = defineConfig(${p(a)});`;const u=n.resolve(process.cwd(),s);await t.writeFile(u,f.trim()),console.log(`✅ Configuration file created at: ${u}`)};

package/dist/cjs/linter.js

@@ -0,0 +1 @@
+"use strict";var e=require("glob"),t=require("node:fs/promises"),r=require("@swc/core"),n=require("swc-walk"),s=require("chalk"),o=require("ora");function i(e,t,r){const s=[],o=[0];for(let e=0;e<t.length;e++)"\n"===t[e]&&o.push(e+1);const i=e=>{let t=1;for(let r=0;r<o.length&&!(o[r]>e);r++)t=r+1;return t},a=r.extract.transComponents||["Trans"],l=r.extract.ignoredAttributes||[],c=new Set(["className","key","id","style","href","i18nKey","defaults","type",...l]);return n.ancestor(e,{JSXText(e,t){const r=t[t.length-2],n=r?.opening?.name?.value;if(n&&(a.includes(n)||"script"===n||"style"===n))return;if(t.some(e=>{if("JSXElement"!==e.type)return!1;const t=e.opening?.name?.value;return a.includes(t)||["script","style","code"].includes(t)}))return;const o=e.value.trim();o&&isNaN(Number(o))&&!o.startsWith("{{")&&s.push({text:o,line:i(e.span.start)})},StringLiteral(e,t){const r=t[t.length-2];if("JSXAttribute"===r?.type&&!c.has(r.name.value)){const t=e.value.trim();t&&isNaN(Number(t))&&s.push({text:t,line:i(e.span.start)})}}}),s}exports.runLinter=async function(n){const a=o("Analyzing source files...\n").start();try{const o=await e.glob(n.extract.input);let l=0;const c=new Map;for(const e of o){const s=await t.readFile(e,"utf-8"),o=i(await r.parse(s,{syntax:"typescript",tsx:!0}),s,n);o.length>0&&(l+=o.length,c.set(e,o))}if(l>0){a.fail(s.red.bold(`Linter found ${l} potential issues.`));for(const[e,t]of c.entries())console.log(s.yellow(`\n${e}`)),t.forEach(({text:e,line:t})=>{console.log(`  ${s.gray(`${t}:`)} ${s.red("Error:")} Found hardcoded string: "${e}"`)});process.exit(1)}else a.succeed(s.green.bold("No issues found."))}catch(e){a.fail(s.red("Linter failed to run.")),console.error(e),process.exit(1)}};

package/dist/cjs/locize.js

@@ -0,0 +1 @@
+"use strict";var e=require("execa"),o=require("chalk"),n=require("ora"),t=require("inquirer"),r=require("node:path");function i(e,o={},n={}){const t=[];if("sync"===e){(o.updateValues??n.updateValues)&&t.push("--update-values","true");(o.srcLngOnly??n.sourceLanguageOnly)&&t.push("--reference-language-only","true");(o.compareMtime??n.compareModificationTime)&&t.push("--compare-modification-time","true");(o.dryRun??n.dryRun)&&t.push("--dry","true")}return t}async function s(s,c,a={}){await async function(){try{await e.execa("locize",["--version"])}catch(e){"ENOENT"===e.code&&(console.error(o.red("Error: `locize-cli` command not found.")),console.log(o.yellow("Please install it globally to use the locize integration:")),console.log(o.cyan("npm install -g locize-cli")),process.exit(1))}}();const l=n(`Running 'locize ${s}'...\n`).start(),u=c.locize||{},{projectId:p,apiKey:d,version:y}=u;let g=[s];p&&g.push("--project-id",p),d&&g.push("--api-key",d),y&&g.push("--ver",y),g.push(...i(s,a,u));const m=r.resolve(process.cwd(),c.extract.output.split("/{{language}}/")[0]);g.push("--path",m);try{console.log(o.cyan(`\nRunning 'locize ${g.join(" ")}'...`));const n=await e.execa("locize",g,{stdio:"pipe"});l.succeed(o.green(`'locize ${s}' completed successfully.`)),n?.stdout&&console.log(n.stdout)}catch(n){const r=n.stderr||"";if(r.includes("missing required argument")){const n=await async function(e){console.log(o.yellow("\nLocize configuration is missing or invalid. Let's set it up!"));const n=await t.prompt([{type:"input",name:"projectId",message:"What is your locize Project ID? (Find this in your project settings on www.locize.app)",validate:e=>!!e||"Project ID cannot be empty."},{type:"password",name:"apiKey",message:'What is your locize API key? (Create or use one in your project settings > "API Keys")',validate:e=>!!e||"API Key cannot be empty."},{type:"input",name:"version",message:"What version do you want to sync with?",default:"latest"}]);if(!n.projectId)return void console.error(o.red("Project ID is required to continue."));e.locize={projectId:n.projectId,apiKey:n.apiKey,version:n.version};const{save:r}=await t.prompt([{type:"confirm",name:"save",message:"Would you like to see how to save these credentials for future use?",default:!0}]);if(r){const e=`\n# Add this to your .env file (and ensure .env is in your .gitignore!)\nLOCIZE_API_KEY=${n.apiKey}\n`,t=`\n  // Add this to your i18next.config.ts file\n  locize: {\n    projectId: '${n.projectId}',\n    // For security, apiKey is best set via an environment variable\n    apiKey: process.env.LOCIZE_API_KEY,\n    version: '${n.version}',\n  },`;console.log(o.cyan("\nGreat! For the best security, we recommend using environment variables for your API key.")),console.log(o.bold("\nRecommended approach (.env file):")),console.log(o.green(e)),console.log(o.bold("Then, in your i18next.config.ts:")),console.log(o.green(t))}return e.locize}(c);if(n){g=[s],n.projectId&&g.push("--project-id",n.projectId),n.apiKey&&g.push("--api-key",n.apiKey),n.version&&g.push("--ver",n.version),g.push(...i(s,a,u)),g.push("--path",m);try{l.start("Retrying with new credentials...");const n=await e.execa("locize",g,{stdio:"pipe"});l.succeed(o.green("Retry successful!")),n?.stdout&&console.log(n.stdout)}catch(e){l.fail(o.red("Error during retry.")),console.error(e.stderr||e.message),process.exit(1)}}else l.fail("Operation cancelled."),process.exit(1)}else l.fail(o.red(`Error executing 'locize ${s}'.`)),console.error(r||n.message),process.exit(1)}console.log(o.green(`\n✅ 'locize ${s}' completed successfully.`))}exports.runLocizeDownload=(e,o)=>s("download",e,o),exports.runLocizeMigrate=(e,o)=>s("migrate",e,o),exports.runLocizeSync=(e,o)=>s("sync",e,o);