@scoutello/i18n-magic 0.16.0 → 0.19.0

package/README.md

@@ -1,25 +1,78 @@
-# i18n Magic
+# i18n Magic ✨
 
-Your CLI toolkit to help you with managing your translations in your project.
+**The intelligent CLI toolkit that automates your internationalization workflow with AI-powered translations.**
 
-This currently works for JSON based translation systems
+i18n Magic streamlines the entire translation management process for your JavaScript/TypeScript projects. Say goodbye to manually maintaining translation files and hello to automated, context-aware translations that keep your international users happy.
 
-To use:
+## 🚀 What it does
 
-1. Create an API key in your `.env` file (either `OPENAI_API_KEY` or `GEMINI_API_KEY`)
-2. Create a config file, called `i18n-magic.js` in your project root.
+- **🔍 Smart Detection**: Automatically scans your codebase to find translation keys
+- **🤖 AI Translation**: Generates high-quality translations using OpenAI or Gemini models
+- **🔄 Sync & Maintain**: Keeps all your locales in perfect sync
+- **🧹 Clean & Optimize**: Removes unused translations and creates optimized bundles
+- **⚡ CI/CD Ready**: Perfect for automated workflows and deployment pipelines
 
-The content of the file should look something like this:
+## 📋 Requirements
+
+- JSON-based i18n libraries (react-i18next, next-i18next, vue-i18n, etc.)
+- Node.js 16+
+- An OpenAI or Google Gemini API key
+
+## 🛠️ Quick Setup
+
+### 1. Install the package
+
+```bash
+npm install -g @scoutello/i18n-magic
+# or use directly with npx
+npx @scoutello/i18n-magic
+```
+
+### 2. Set up your API key
+
+Create a `.env` file in your project root:
+
+```bash
+# Choose one:
+OPENAI_API_KEY=your_openai_api_key_here
+# OR
+GEMINI_API_KEY=your_gemini_api_key_here
+```
+
+### 3. Create your configuration
+
+Create an `i18n-magic.js` file in your project root with your project-specific settings:
 
 ```js
 module.exports = {
-  globPatterns: ['./components/**/*.tsx', './pages/**/*.tsx', './lib/**/*.ts'],
+  globPatterns: [
+    './components/**/*.tsx',
+    './pages/**/*.tsx',
+    './lib/**/*.ts',
+    // Namespace-specific patterns for pruned translations
+    {
+      pattern: './apps/dashboard/**/*.tsx',
+      namespaces: ['dashboard'],
+    },
+    {
+      pattern: './apps/dashboard/**/*.ts',
+      namespaces: ['dashboard'],
+    },
+    {
+      pattern: './apps/mobile/**/*.tsx',
+      namespaces: ['mobile'],
+    },
+    {
+      pattern: './apps/mobile/**/*.ts',
+      namespaces: ['mobile'],
+    },
+  ],
   loadPath: 'locales/{{lng}}/{{ns}}.json',
   savePath: 'locales/{{lng}}/{{ns}}.json',
   locales: ['en', 'de'],
   defaultLocale: 'de',
   defaultNamespace: 'common',
-  namespaces: ['common', 'forms'],
+  namespaces: ['common', 'forms', 'dashboard', 'mobile'],
   context:
     'This is a context which increases the quality of the translations by giving context to the LLM',
   // Optional configurations
@@ -27,10 +80,48 @@ module.exports = {
   OPENAI_API_KEY: '.', // Alternative to using .env file
   GEMINI_API_KEY: '', // Alternative to using .env file
   disableTranslation: false, // Set to true to skip automatic translations during the scan step. Useful if you want to sync the other languages during CI/CD using sync.
+  autoClear: true, // When using the scan command, always run the clean before
 };
 ```
 
-You can also provide custom functions for `loadPath` and `savePath` to store translations in other systems like S3:
+#### Glob Patterns Configuration
+
+The `globPatterns` array supports two formats:
+
+1. **String patterns**: Simple glob patterns that apply to all namespaces
+
+   ```js
+   './components/**/*.tsx';
+   ```
+
+2. **Object patterns**: Patterns with namespace-specific configuration for pruned translations
+   ```js
+   {
+     pattern: './apps/dashboard/**/*.tsx',
+     namespaces: ['dashboard']
+   }
+   ```
+
+When using object patterns, translation keys found in files matching that pattern will be associated with the specified namespaces. This enables automatic creation of namespace-specific translation bundles.
+
+### 4. Start using i18n Magic
+
+```bash
+# Scan for missing translations and add them
+npx @scoutello/i18n-magic scan
+
+# Check what's missing without making changes
+npx @scoutello/i18n-magic check-missing
+
+# Sync all locales from your default language
+npx @scoutello/i18n-magic sync
+```
+
+## 🔧 Advanced Configuration
+
+### Custom Storage Solutions
+
+You can provide custom functions for `loadPath` and `savePath` to store translations in other systems like S3, databases, or CDNs:
 
 ```js
 const { S3Client, PutObjectCommand } = require("@aws-sdk/client-s3")
@@ -73,19 +164,42 @@ module.exports = {
 };
 ```
 
-then just run:
+## 📚 Available Commands
+
+All commands can be run with:
 
 ```bash
 npx @scoutello/i18n-magic [command]
 ```
 
-`scan`
+### `scan`
+
+Scan your codebase for missing translations and automatically generate them. This command analyzes your code to find translation keys that don't exist in your translation files yet.
 
-Scan for missing translations, get prompted for each, translate it to the other locales and save it to the JSON file.
+The command will:
 
-`replace`
+1. Scan all files matching your glob patterns for translation usage
+2. Identify missing translation keys in your default locale
+3. Prompt you to provide translations for each missing key
+4. Automatically translate to all other configured locales using AI
+5. Save the new translations to your JSON files
 
-Replace a translation based on the key, and translate it to the other locales and save it to the JSON file.
+This is useful for:
+
+- Adding new translations during development
+- Ensuring all translation keys have corresponding values
+- Maintaining translation consistency across locales
+
+### `replace`
+
+Update an existing translation key with a new value and automatically translate it to all other locales. This command allows you to modify existing translations while maintaining consistency across all languages.
+
+The command will:
+
+1. Prompt you to select or specify the translation key to replace
+2. Ask for the new translation value in your default locale
+3. Automatically translate the new value to all other configured locales using AI
+4. Update all translation files with the new values
 
 You can specify the key in two ways:
 
@@ -94,10 +208,84 @@ You can specify the key in two ways:
 
 If no key is provided, you will be prompted to enter one.
 
-`check-missing`
+This is useful for:
+
+- Updating existing translations that need changes
+- Fixing translation errors across all locales
+- Maintaining consistency when modifying content
+
+### `check-missing`
+
+Check if there are any missing translations without making any changes. This command performs a dry-run analysis to identify translation gaps in your project.
+
+The command will:
+
+1. Scan all files matching your glob patterns for translation usage
+2. Check if all found translation keys exist in your translation files
+3. Report any missing translations without prompting for input
+4. Exit with an error code if missing translations are found
+
+This is useful for:
+
+- CI/CD pipelines to ensure translation completeness
+- Pre-commit hooks to catch missing translations early
+- Quality assurance checks before deployment
+- Automated testing of translation coverage
+
+### `sync`
+
+Synchronize translations from your default locale to all other configured locales using AI translation. This command takes existing translations in your default language and generates corresponding translations for all other locales.
+
+The command will:
+
+1. Load all translation keys from your default locale
+2. Identify keys that are missing in other locales
+3. Automatically translate missing keys using AI
+4. Update translation files for all non-default locales
+5. Preserve existing translations (only adds missing ones)
+
+This is useful for:
+
+- CI/CD pipelines to ensure all locales are up-to-date
+- Batch translation of new content
+- Maintaining translation parity across languages
+- Automated deployment workflows
+
+**Note**: This command works best when used with `disableTranslation: true` in your config to separate the scanning and translation phases.
+
+### `prune`
+
+Create a pruned namespace from an existing namespace, containing only the translation keys that are actually used in specific files. This is useful for creating optimized translation bundles for different parts of your application (e.g., dashboard, mobile app, etc.).
+
+The command will:
+
+1. Prompt you to select a source namespace to prune from
+2. Ask for a name for the new namespace
+3. Ask for glob patterns to scan for translation usage
+4. Extract all translation keys used in the matched files
+5. Create new translation files for all locales containing only the used keys
+
+This is particularly useful for:
+
+- Creating namespace-specific translation bundles
+- Reducing bundle size by including only necessary translations
+- Optimizing performance in micro-frontends or modular applications
+
+You can also automate this process using the `pruneNamespaces` configuration in your `i18n-magic.js` file (see configuration example above).
+
+### `clean`
+
+Remove unused translation keys from all locales. This command scans your codebase to find which translation keys are actually being used and removes any keys that are no longer referenced in your code.
+
+The command will:
 
-Checks if there are any missing translations. Useful for CI/CD or for a husky hook.
+1. Scan all files matching your glob patterns for translation usage
+2. Compare found keys with existing translation files
+3. Remove unused keys from all locale files
+4. Report how many keys were removed
 
-`sync`
+This is useful for:
 
-Sync the translations from the default locale to the other locales. Useful for a CI/CD pipeline or husky hook. Should be used together with `disableTranslation: true`
+- Keeping translation files clean and maintainable
+- Reducing bundle size by removing dead translations
+- Regular maintenance in CI/CD pipelines

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const dotenv_1 = __importDefault(require("dotenv"));
+const openai_1 = __importDefault(require("openai"));
+const check_missing_1 = require("./commands/check-missing");
+const clean_1 = require("./commands/clean");
+const create_pruned_namespace_1 = require("./commands/create-pruned-namespace");
+const replace_1 = require("./commands/replace");
+const scan_1 = require("./commands/scan");
+const sync_locales_1 = require("./commands/sync-locales");
+const utils_1 = require("./lib/utils");
+const program = new commander_1.Command();
+program
+    .name("i18n-magic")
+    .description("CLI to help you manage your locales JSON with translations, replacements, etc. with OpenAI.")
+    .version("0.2.0")
+    .option("-c, --config <path>", "path to config file")
+    .option("-e, --env <path>", "path to .env file");
+const commands = [
+    {
+        name: "scan",
+        description: "Scan for missing translations, get prompted for each, translate it to the other locales and save it to the JSON file.",
+        action: scan_1.translateMissing,
+    },
+    {
+        name: "replace",
+        description: "Replace a translation based on the key, and translate it to the other locales and save it to the JSON file.",
+        action: replace_1.replaceTranslation,
+    },
+    {
+        name: "check-missing",
+        description: "Check if there are any missing translations. Useful for a CI/CD pipeline or husky hook.",
+        action: check_missing_1.checkMissing,
+    },
+    {
+        name: "sync",
+        description: "Sync the translations from the default locale to the other locales. Useful for a CI/CD pipeline or husky hook.",
+        action: sync_locales_1.syncLocales,
+    },
+    {
+        name: "clean",
+        description: "Remove unused translations from all locales. Useful for a CI/CD pipeline or husky hook.",
+        action: clean_1.removeUnusedKeys,
+    },
+    {
+        name: "prune",
+        description: "Create a pruned namespace from the other namespaces.",
+        action: create_pruned_namespace_1.createPrunedNamespace,
+    },
+];
+for (const command of commands) {
+    const cmd = program.command(command.name).description(command.description);
+    // Add key option to replace command
+    if (command.name === "replace") {
+        cmd
+            .option("-k, --key <key>", "translation key to replace")
+            .allowExcessArguments(true)
+            .argument("[key]", "translation key to replace");
+    }
+    cmd.action(async (arg, options) => {
+        const res = dotenv_1.default.config({
+            path: program.opts().env || ".env",
+        });
+        const config = await (0, utils_1.loadConfig)({
+            configPath: program.opts().config,
+        });
+        const isGemini = config.model?.includes("gemini");
+        // Get API key from environment or config
+        const openaiKey = res.parsed.OPENAI_API_KEY || config.OPENAI_API_KEY;
+        const geminiKey = res.parsed.GEMINI_API_KEY || config.GEMINI_API_KEY;
+        // Select appropriate key based on model type
+        const key = isGemini ? geminiKey : openaiKey;
+        if (!key) {
+            const keyType = isGemini ? "GEMINI_API_KEY" : "OPENAI_API_KEY";
+            console.error(`Please provide a${isGemini ? " Gemini" : "n OpenAI"} API key in your .env file or config, called ${keyType}.`);
+            process.exit(1);
+        }
+        const openai = new openai_1.default({
+            apiKey: key,
+            ...(isGemini && {
+                baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/",
+            }),
+        });
+        // For replace command, check for key in argument or option
+        if (command.name === "replace") {
+            // If key is provided as positional argument, use that first
+            const keyToUse = typeof arg === "string" ? arg : options.key;
+            command.action({ ...config, openai }, keyToUse);
+        }
+        else {
+            command.action({ ...config, openai });
+        }
+    });
+}
+program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/check-missing.d.ts

@@ -1,2 +1,3 @@
 import type { Configuration } from "../lib/types";
 export declare const checkMissing: (config: Configuration) => Promise<void>;
+//# sourceMappingURL=check-missing.d.ts.map

package/dist/commands/check-missing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-missing.d.ts","sourceRoot":"","sources":["../../src/commands/check-missing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD,eAAO,MAAM,YAAY,GAAU,QAAQ,aAAa,kBAOvD,CAAA"}

package/dist/commands/check-missing.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkMissing = void 0;
+const utils_1 = require("../lib/utils");
+const checkMissing = async (config) => {
+    const newKeys = await (0, utils_1.getMissingKeys)(config);
+    if (newKeys.length > 0) {
+        console.error("Error: Missing translations found!");
+        process.exit(1);
+    }
+};
+exports.checkMissing = checkMissing;
+//# sourceMappingURL=check-missing.js.map

package/dist/commands/check-missing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-missing.js","sourceRoot":"","sources":["../../src/commands/check-missing.ts"],"names":[],"mappings":";;;AACA,wCAA6C;AAEtC,MAAM,YAAY,GAAG,KAAK,EAAE,MAAqB,EAAE,EAAE;IAC1D,MAAM,OAAO,GAAG,MAAM,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAA;IAE5C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAA;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC,CAAA;AAPY,QAAA,YAAY,gBAOxB"}

package/dist/commands/clean.d.ts

@@ -1,2 +1,3 @@
 import type { Configuration } from "../lib/types";
 export declare const removeUnusedKeys: (config: Configuration) => Promise<void>;
+//# sourceMappingURL=clean.d.ts.map

package/dist/commands/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAQjD,eAAO,MAAM,gBAAgB,GAAU,QAAQ,aAAa,kBAgG3D,CAAA"}

package/dist/commands/clean.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeUnusedKeys = void 0;
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const i18next_scanner_1 = require("i18next-scanner");
+const node_fs_1 = __importDefault(require("node:fs"));
+const utils_1 = require("../lib/utils");
+const removeUnusedKeys = async (config) => {
+    const { globPatterns, namespaces, defaultNamespace, locales, loadPath, savePath, } = config;
+    // Set up the parser
+    const parser = new i18next_scanner_1.Parser({
+        nsSeparator: false,
+        keySeparator: false,
+    });
+    // Find all files to scan
+    const allPatterns = globPatterns.map((pattern) => typeof pattern === "string" ? pattern : pattern.pattern);
+    const files = await (0, fast_glob_1.default)([...allPatterns, "!**/node_modules/**"]);
+    // Extract all translation keys from the codebase
+    const extractedKeys = [];
+    for (const file of files) {
+        const content = node_fs_1.default.readFileSync(file, "utf-8");
+        parser.parseFuncFromString(content, { list: ["t"] }, (key) => {
+            extractedKeys.push(key);
+        });
+    }
+    // Remove duplicates
+    const uniqueExtractedKeys = (0, utils_1.removeDuplicatesFromArray)(extractedKeys);
+    // Track stats for reporting
+    const stats = {
+        total: 0,
+        removed: 0,
+    };
+    // Process each namespace and locale
+    for (const namespace of namespaces) {
+        // Build a set of pure keys that are actually used in the codebase for this namespace
+        const usedKeysSet = new Set();
+        for (const key of uniqueExtractedKeys) {
+            const pureKey = (0, utils_1.getPureKey)(key, namespace, namespace === defaultNamespace);
+            if (pureKey) {
+                usedKeysSet.add(pureKey);
+            }
+        }
+        // Process each locale
+        for (const locale of locales) {
+            // Load existing keys for this locale and namespace
+            const existingKeys = await (0, utils_1.loadLocalesFile)(loadPath, locale, namespace);
+            const existingKeysCount = Object.keys(existingKeys).length;
+            stats.total += existingKeysCount;
+            // Create a new object with only the keys that are used
+            const cleanedKeys = {};
+            let removedCount = 0;
+            for (const [key, value] of Object.entries(existingKeys)) {
+                if (usedKeysSet.has(key)) {
+                    cleanedKeys[key] = value;
+                }
+                else {
+                    removedCount++;
+                }
+            }
+            stats.removed += removedCount;
+            // Only write the file if keys were removed
+            if (removedCount > 0) {
+                await (0, utils_1.writeLocalesFile)(savePath, locale, namespace, cleanedKeys);
+                console.log(`✓ Removed ${removedCount} unused keys from ${locale}:${namespace} (${Object.keys(cleanedKeys).length} keys remaining)`);
+            }
+            else {
+                console.log(`No unused keys found in ${locale}:${namespace}`);
+            }
+        }
+    }
+    if (stats.removed > 0) {
+        console.log(`✅ Removed ${stats.removed} unused keys (out of ${stats.total} total keys)`);
+    }
+    else {
+        console.log(`✅ No unused keys found in the project (${stats.total} total keys)`);
+    }
+};
+exports.removeUnusedKeys = removeUnusedKeys;
+//# sourceMappingURL=clean.js.map

package/dist/commands/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"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"}

package/dist/commands/create-pruned-namespace-automated.d.ts

@@ -0,0 +1,20 @@
+import type { Configuration } from "../lib/types";
+export interface PruneOptions {
+    sourceNamespace: string;
+    newNamespace: string;
+    globPatterns: string[];
+}
+export interface PruneResult {
+    locale: string;
+    keyCount: number;
+    success: boolean;
+    error?: string;
+}
+export interface PruneResponse {
+    success: boolean;
+    message: string;
+    keysCount: number;
+    results?: PruneResult[];
+}
+export declare const createPrunedNamespaceAutomated: (config: Configuration, options: PruneOptions) => Promise<PruneResponse>;
+//# sourceMappingURL=create-pruned-namespace-automated.d.ts.map

package/dist/commands/create-pruned-namespace-automated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-pruned-namespace-automated.d.ts","sourceRoot":"","sources":["../../src/commands/create-pruned-namespace-automated.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAQjD,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;CACxB;AAED,eAAO,MAAM,8BAA8B,GACzC,QAAQ,aAAa,EACrB,SAAS,YAAY,KACpB,OAAO,CAAC,aAAa,CAkIvB,CAAA"}

package/dist/commands/create-pruned-namespace-automated.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPrunedNamespaceAutomated = void 0;
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const i18next_scanner_1 = require("i18next-scanner");
+const node_fs_1 = __importDefault(require("node:fs"));
+const utils_1 = require("../lib/utils");
+const createPrunedNamespaceAutomated = async (config, options) => {
+    const { namespaces, loadPath, savePath, locales, defaultNamespace } = config;
+    const { sourceNamespace, newNamespace, globPatterns } = options;
+    // Validate inputs
+    if (!namespaces.includes(sourceNamespace)) {
+        throw new Error(`Source namespace '${sourceNamespace}' not found in configuration`);
+    }
+    if (namespaces.includes(newNamespace)) {
+        throw new Error(`Namespace '${newNamespace}' already exists`);
+    }
+    console.log(`Creating pruned namespace '${newNamespace}' from '${sourceNamespace}'`);
+    console.log(`Using glob patterns: ${globPatterns.join(", ")}`);
+    // Extract keys from files matching the glob patterns
+    const parser = new i18next_scanner_1.Parser({
+        nsSeparator: false,
+        keySeparator: false,
+    });
+    const files = await (0, fast_glob_1.default)([...globPatterns, "!**/node_modules/**"]);
+    console.log(`Found ${files.length} files to scan`);
+    const extractedKeys = [];
+    for (const file of files) {
+        const content = node_fs_1.default.readFileSync(file, "utf-8");
+        parser.parseFuncFromString(content, { list: ["t"] }, (key) => {
+            extractedKeys.push(key);
+        });
+    }
+    const uniqueExtractedKeys = (0, utils_1.removeDuplicatesFromArray)(extractedKeys);
+    console.log(`Found ${uniqueExtractedKeys.length} unique translation keys`);
+    // Filter keys that belong to the source namespace
+    const relevantKeys = [];
+    for (const key of uniqueExtractedKeys) {
+        const pureKey = (0, utils_1.getPureKey)(key, sourceNamespace, sourceNamespace === defaultNamespace);
+        if (pureKey) {
+            relevantKeys.push(pureKey);
+        }
+    }
+    console.log(`Found ${relevantKeys.length} keys from namespace '${sourceNamespace}'`);
+    if (relevantKeys.length === 0) {
+        console.log("No relevant keys found. Exiting...");
+        return {
+            success: false,
+            message: "No relevant keys found",
+            keysCount: 0,
+        };
+    }
+    // Get translations from source namespace and create new namespace files
+    const results = [];
+    for (const locale of locales) {
+        try {
+            // Load source namespace translations
+            const sourceTranslations = await (0, utils_1.loadLocalesFile)(loadPath, locale, sourceNamespace);
+            // Create new namespace with only the keys used in the glob pattern files
+            const newNamespaceTranslations = {};
+            for (const key of relevantKeys) {
+                if (sourceTranslations[key]) {
+                    newNamespaceTranslations[key] = sourceTranslations[key];
+                }
+            }
+            // Write the new namespace file
+            await (0, utils_1.writeLocalesFile)(savePath, locale, newNamespace, newNamespaceTranslations);
+            const keyCount = Object.keys(newNamespaceTranslations).length;
+            console.log(`Created pruned namespace '${newNamespace}' for locale '${locale}' with ${keyCount} keys`);
+            results.push({
+                locale,
+                keyCount,
+                success: true,
+            });
+        }
+        catch (error) {
+            console.error(`Error creating pruned namespace for locale '${locale}':`, error);
+            results.push({
+                locale,
+                keyCount: 0,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    console.log(`✅ Successfully created pruned namespace '${newNamespace}'`);
+    return {
+        success: true,
+        message: `Created pruned namespace '${newNamespace}' with ${relevantKeys.length} keys`,
+        keysCount: relevantKeys.length,
+        results,
+    };
+};
+exports.createPrunedNamespaceAutomated = createPrunedNamespaceAutomated;
+//# sourceMappingURL=create-pruned-namespace-automated.js.map

package/dist/commands/create-pruned-namespace-automated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-pruned-namespace-automated.js","sourceRoot":"","sources":["../../src/commands/create-pruned-namespace-automated.ts"],"names":[],"mappings":"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"}

package/dist/commands/create-pruned-namespace.d.ts

@@ -0,0 +1,3 @@
+import type { Configuration } from "../lib/types";
+export declare const createPrunedNamespace: (config: Configuration) => Promise<void>;
+//# sourceMappingURL=create-pruned-namespace.d.ts.map

package/dist/commands/create-pruned-namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-pruned-namespace.d.ts","sourceRoot":"","sources":["../../src/commands/create-pruned-namespace.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAQjD,eAAO,MAAM,qBAAqB,GAAU,QAAQ,aAAa,kBA2JhE,CAAA"}