i18n-turbo 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lasantha Lakmal
+
+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,74 @@
+# i18n-turbo
+
+> Extract hardcoded strings from JSX/TSX/JS/TS files and export them to an i18n JSON format — with optional reverse transformation support.
+
+## Install
+
+```bash
+npm install -g i18n-turbo
+````
+
+## Usage
+
+```bash
+i18n-turbo <input-dir> <output-en-json> [--dry-run] [--merge] [--lang <code>] [--fn <name>] [--reverse]
+```
+
+## Options
+
+* `--dry-run` — Show what would be replaced, but don’t modify files.
+* `--merge` — Merge new keys with existing `en.json` entries.
+* `--lang <code>` — Automatically translate to the specified language (e.g., `fr`, `es`) and generate `<lang>.json`.
+* `--fn <name>` — Set the i18n function name (default is `t`).
+* `--reverse` — Revert translated keys (e.g., `t("hello_world")`) back to the original hardcoded strings using the translation file.
+
+## Features
+
+* Scans `.jsx`, `.tsx`, `.ts`, `.js` files
+* Extracts static text and replaces with `t('key')`
+* Outputs i18n JSON files (e.g., `en.json`, `fr.json`)
+* Reverses translated keys back to raw strings
+* Preserves original file structure
+* Supports dry-run, merge, and auto-translate
+
+## Examples
+
+### Extract mode
+
+**Dry run only (preview):**
+
+```bash
+i18n-turbo ./src ./locales/en.json --dry-run
+```
+
+**Translate to French and output `fr.json`:**
+
+```bash
+i18n-turbo ./examples ./locales/en.json --lang fr
+```
+
+**Use a custom function name (e.g. `i18n` instead of `t`):**
+
+```bash
+i18n-turbo ./src ./locales/en.json --fn i18n
+```
+
+### Reverse mode
+
+**Revert translations (e.g. `t("hello_world")`) back to original strings:**
+
+```bash
+i18n-turbo ./examples ./locales/en.json --reverse
+```
+
+**Reverse using a custom i18n function name:**
+
+```bash
+i18n-turbo ./src ./locales/en.json --reverse --fn i18n
+```
+
+> 🔁 The reverse command reads keys from the translation file (e.g. `en.json`) and replaces `t("key")` with the original hardcoded string like `"Hello world"`.
+
+## License
+
+MIT

package/dist/bin/cli.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// bin/cli.ts
+const cli_1 = require("../src/cli");
+(0, cli_1.runCLI)();

package/dist/src/cli.js

@@ -0,0 +1,32 @@
+"use strict";
+// bin/cli.ts or src/cli.ts
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCLI = runCLI;
+const path_1 = __importDefault(require("path"));
+const extractor_1 = require("./extractor");
+const reverser_1 = require("./reverser");
+async function runCLI() {
+    const args = process.argv.slice(2);
+    const inputDir = args[0] || './src';
+    const outputFile = args[1] || './locales/en.json';
+    const fnNameIndex = args.indexOf('--fn');
+    const fnName = fnNameIndex !== -1 && args[fnNameIndex + 1] ? args[fnNameIndex + 1] : 't';
+    const langIndex = args.indexOf('--lang');
+    const lang = langIndex !== -1 && args[langIndex + 1] ? args[langIndex + 1] : undefined;
+    const options = {
+        fnName,
+        dryRun: args.includes('--dry-run'),
+        merge: args.includes('--merge'),
+        lang,
+    };
+    const resolvedInputDir = path_1.default.resolve(inputDir);
+    const resolvedOutputFile = path_1.default.resolve(outputFile);
+    if (args.includes('--reverse')) {
+        await (0, reverser_1.reverseStringsFromDirectory)(resolvedInputDir, resolvedOutputFile, fnName);
+        process.exit(0);
+    }
+    await (0, extractor_1.extractStringsFromDirectory)(resolvedInputDir, resolvedOutputFile, options);
+}

package/dist/src/extractor.js

@@ -0,0 +1,146 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractStringsFromDirectory = extractStringsFromDirectory;
+// src/extractor.ts
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const babel = __importStar(require("@babel/core"));
+const traverse_1 = __importDefault(require("@babel/traverse"));
+const generator_1 = __importDefault(require("@babel/generator"));
+const t = __importStar(require("@babel/types"));
+const scanner_1 = require("./scanner");
+const utils_1 = require("./utils");
+const google_translate_api_1 = require("@vitalets/google-translate-api");
+async function extractStringsFromDirectory(inputDir, outputFile, options) {
+    let translationMap = {};
+    if (options.merge && fs_1.default.existsSync(outputFile)) {
+        try {
+            translationMap = JSON.parse(fs_1.default.readFileSync(outputFile, "utf-8"));
+        }
+        catch {
+            console.warn(`[WARN] Could not parse ${outputFile}, starting fresh.`);
+        }
+    }
+    const files = (0, scanner_1.getSourceFiles)(inputDir);
+    for (const file of files) {
+        const code = fs_1.default.readFileSync(file, "utf-8");
+        const ast = babel.parseSync(code, {
+            filename: file,
+            presets: ["@babel/preset-typescript", "@babel/preset-react"],
+        });
+        if (!ast)
+            continue;
+        let modified = false;
+        (0, traverse_1.default)(ast, {
+            JSXText(path) {
+                const rawText = path.node.value.trim();
+                if (!rawText || /^\{.*\}$/.test(rawText))
+                    return;
+                const key = (0, utils_1.generateTranslationKey)(rawText);
+                translationMap[key] = rawText;
+                const replacement = t.jsxExpressionContainer(t.callExpression(t.identifier(options.fnName), [t.stringLiteral(key)]));
+                path.replaceWith(replacement);
+                modified = true;
+                if (options.dryRun) {
+                    console.log(`[DRY RUN] ${file}: ${rawText} -> ${key}`);
+                }
+            },
+            StringLiteral(path) {
+                const value = path.node.value;
+                // ✅ Skip import declarations
+                if (path.findParent((p) => p.isImportDeclaration()))
+                    return;
+                // ✅ Skip if already translated
+                if (path.parentPath.isCallExpression() &&
+                    path.parentPath.node.callee.type === "Identifier" &&
+                    path.parentPath.node.callee.name === options.fnName)
+                    return;
+                if (!value || value.length < 2 || value.length > 80)
+                    return;
+                if (!/[a-zA-Z]/.test(value))
+                    return;
+                const key = (0, utils_1.generateTranslationKey)(value);
+                translationMap[key] = value;
+                let replacement;
+                // ✅ Detect if inside JSX attribute
+                if (path.parentPath.isJSXAttribute()) {
+                    replacement = t.jsxExpressionContainer(t.callExpression(t.identifier(options.fnName), [
+                        t.stringLiteral(key),
+                    ]));
+                }
+                else {
+                    replacement = t.callExpression(t.identifier(options.fnName), [
+                        t.stringLiteral(key),
+                    ]);
+                }
+                path.replaceWith(replacement);
+                modified = true;
+                if (options.dryRun) {
+                    console.log(`[DRY RUN] ${file}: "${value}" -> ${key}`);
+                }
+            },
+        });
+        if (!options.dryRun && modified) {
+            const output = (0, generator_1.default)(ast).code;
+            fs_1.default.writeFileSync(file, output);
+        }
+    }
+    if (!options.dryRun) {
+        fs_1.default.mkdirSync(path_1.default.dirname(outputFile), { recursive: true });
+        if (options.lang && options.lang !== "en") {
+            const translated = {};
+            for (const [key, text] of Object.entries(translationMap)) {
+                try {
+                    const res = await (0, google_translate_api_1.translate)(text, { to: options.lang });
+                    console.log(`Translated "${text}" => "${res.text}"`);
+                    translated[key] = res.text;
+                }
+                catch (err) {
+                    console.warn(`Translation failed for "${text}"`, err);
+                    translated[key] = text;
+                }
+            }
+            const langPath = path_1.default.join(path_1.default.dirname(outputFile), `${options.lang}.json`);
+            fs_1.default.writeFileSync(langPath, JSON.stringify(translated, null, 2), "utf-8");
+        }
+        else {
+            fs_1.default.writeFileSync(outputFile, JSON.stringify(translationMap, null, 2), "utf-8");
+        }
+    }
+}

package/dist/src/reverser.js

@@ -0,0 +1,96 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reverseStringsFromDirectory = reverseStringsFromDirectory;
+const fs_1 = __importDefault(require("fs"));
+const babel = __importStar(require("@babel/core"));
+const traverse_1 = __importDefault(require("@babel/traverse"));
+const t = __importStar(require("@babel/types"));
+const generator_1 = __importDefault(require("@babel/generator"));
+const scanner_1 = require("./scanner");
+function reverseStringsFromDirectory(inputDir, i18nFile, fnName = "t") {
+    const translationMap = JSON.parse(fs_1.default.readFileSync(i18nFile, "utf-8"));
+    const files = (0, scanner_1.getSourceFiles)(inputDir);
+    for (const file of files) {
+        const code = fs_1.default.readFileSync(file, "utf-8");
+        const ast = babel.parseSync(code, {
+            filename: file,
+            presets: ["@babel/preset-typescript", "@babel/preset-react"],
+        });
+        if (!ast)
+            continue;
+        let modified = false;
+        (0, traverse_1.default)(ast, {
+            CallExpression(path) {
+                const callee = path.node.callee;
+                const args = path.node.arguments;
+                if (t.isIdentifier(callee, { name: fnName }) &&
+                    args.length === 1 &&
+                    t.isStringLiteral(args[0])) {
+                    const key = args[0].value;
+                    const originalText = translationMap[key];
+                    if (typeof originalText === "string") {
+                        const parent = path.parentPath;
+                        if (parent?.isJSXExpressionContainer()) {
+                            const containerParent = parent.parentPath;
+                            if (containerParent?.isJSXAttribute() &&
+                                containerParent.node.value === parent.node) {
+                                // If the expression is inside an attribute, set attribute value to string literal
+                                containerParent.node.value = t.stringLiteral(originalText);
+                                parent.remove(); // Remove the expression container if still present
+                            }
+                            else {
+                                // Otherwise, it's a JSX child
+                                parent.replaceWith(t.jsxText(originalText));
+                            }
+                        }
+                        else {
+                            // Not in JSX, just replace with a string literal
+                            path.replaceWith(t.stringLiteral(originalText));
+                        }
+                        modified = true;
+                    }
+                }
+            },
+        });
+        if (modified) {
+            const output = (0, generator_1.default)(ast).code;
+            fs_1.default.writeFileSync(file, output, "utf-8");
+        }
+    }
+}

package/dist/src/scanner.js

@@ -0,0 +1,43 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSourceFiles = getSourceFiles;
+// src/scanner.ts
+const glob = __importStar(require("glob"));
+function getSourceFiles(dir) {
+    return glob.sync(`${dir}/**/*.{js,jsx,ts,tsx}`, {
+        nodir: true
+    });
+}

package/dist/src/utils.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTranslationKey = generateTranslationKey;
+// src/utils.ts
+function generateTranslationKey(text) {
+    return text.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '').substring(0, 50);
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "i18n-turbo",
+  "version": "0.1.0",
+  "description": "Extract hardcoded text from JSX/TSX files and convert to i18n format.",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "i18n-turbo": "dist/bin/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "ts-node bin/cli.ts",
+    "test": "vitest",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "i18n",
+    "translation",
+    "react",
+    "cli",
+    "internationalization"
+  ],
+  "author": "Lasantha Lakmal",
+  "license": "MIT",
+  "dependencies": {
+    "@babel/core": "^7.0.0",
+    "@babel/generator": "^7.0.0",
+    "@babel/preset-react": "^7.0.0",
+    "@babel/preset-typescript": "^7.0.0",
+    "@babel/traverse": "^7.0.0",
+    "@babel/types": "^7.0.0",
+    "@vitalets/google-translate-api": "^9.2.1",
+    "glob": "^10.4.5"
+  },
+  "devDependencies": {
+    "@types/babel__core": "^7.20.5",
+    "@types/babel__generator": "^7.27.0",
+    "@types/babel__traverse": "^7.20.7",
+    "ts-node": "^10.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.4"
+  }
+}