@tuhama/translation-manager 0.1.0 → 0.2.0

package/src/manager.js

@@ -1,192 +1,47 @@
-const fs = require('fs-extra');
-const path = require('path');
-const lodash = require('lodash');
-
-/**
- * Scans the target directory for translation files.
- * Supports standard locales folders and auto-detection.
- */
-async function scanTranslations(targetDir, config = {}) {
-    const defaultPaths = [
-        'public/locales',
-        'src/locales',
-        'src/i18n',
-        'locales'
-    ];
-
-    let localesDir = config.path;
-
-    if (!localesDir) {
-        // Auto-detect
-        for (const p of defaultPaths) {
-            const fullPath = path.resolve(targetDir, p);
-            if (await fs.pathExists(fullPath) && (await fs.stat(fullPath)).isDirectory()) {
-                localesDir = fullPath;
-                break;
-            }
-        }
-    } else {
-        localesDir = path.resolve(targetDir, localesDir);
-    }
-
-    if (!localesDir || !(await fs.pathExists(localesDir))) {
-        throw new Error('Could not find translation directory. Please specify it in the config.');
-    }
-
-    const files = await fs.readdir(localesDir);
-    const jsonFiles = files.filter(f => f.endsWith('.json'));
-
-    const translations = {};
-    const languages = [];
-
-    for (const file of jsonFiles) {
-        const lang = path.basename(file, '.json');
-        languages.push(lang);
-        const content = await fs.readJson(path.join(localesDir, file));
-        translations[lang] = content;
-    }
-
-    // Collect all keys
-    const allKeys = new Set();
-    const flattenKeys = (obj, prefix = '') => {
-        Object.keys(obj).forEach(key => {
-            const fullKey = prefix ? `${prefix}.${key}` : key;
-            if (typeof obj[key] === 'object' && obj[key] !== null && !Array.isArray(obj[key])) {
-                flattenKeys(obj[key], fullKey);
-            } else {
-                allKeys.add(fullKey);
-            }
-        });
-    };
-    languages.forEach(lang => flattenKeys(translations[lang]));
-
-    // Calculate missing translations per key
-    const results = {};
-    allKeys.forEach(key => {
-        const missing = [];
-        languages.forEach(lang => {
-            const val = lodash.get(translations[lang], key);
-            if (val === undefined || val === '') {
-                missing.push(lang);
-            }
-        });
-        results[key] = {
-            missing
-        };
-    });
-
-    return {
-        localesDir,
-        languages,
-        translations,
-        allKeys: Array.from(allKeys).sort(),
-        results
-    };
-}
-
-/**
- * Normalizes all translation files by synchronizing keys and sorting alphabetically.
- */
-async function normalizeTranslations(localesDir) {
-    const files = await fs.readdir(localesDir);
-    const jsonFiles = files.filter(f => f.endsWith('.json'));
-    
-    // 1. Collect all unique keys
-    const allKeys = new Set();
-    const translations = {};
-    const languages = [];
-
-    for (const file of jsonFiles) {
-        const lang = path.basename(file, '.json');
-        languages.push(lang);
-        const content = await fs.readJson(path.join(localesDir, file));
-        translations[lang] = content;
-        
-        const flattenKeys = (obj, prefix = '') => {
-            Object.keys(obj).forEach(key => {
-                const fullKey = prefix ? `${prefix}.${key}` : key;
-                if (typeof obj[key] === 'object' && obj[key] !== null && !Array.isArray(obj[key])) {
-                    flattenKeys(obj[key], fullKey);
-                } else {
-                    allKeys.add(fullKey);
-                }
-            });
-        };
-        flattenKeys(content);
-    }
-
-    // 2. Sync all files with the universal key set and sort
-    for (const lang of languages) {
-        const content = translations[lang];
-        allKeys.forEach(key => {
-            if (lodash.get(content, key) === undefined) {
-                lodash.set(content, key, '');
-            }
-        });
-
-        const sortedContent = sortObject(content);
-        const filePath = path.join(localesDir, `${lang}.json`);
-        await fs.writeJson(filePath, sortedContent, { spaces: 2 });
-    }
-}
-
-/**
- * Recursively sorts object keys alphabetically.
- */
-function sortObject(obj) {
-    if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {
-        return obj;
-    }
-
-    const sorted = {};
-    Object.keys(obj).sort().forEach(key => {
-        sorted[key] = sortObject(obj[key]);
-    });
-    return sorted;
-}
-
-/**
- * Saves a translation key across all language files.
- */
-async function saveTranslation(localesDir, key, values) {
-    const files = await fs.readdir(localesDir);
-    const jsonFiles = files.filter(f => f.endsWith('.json'));
-
-    for (const file of jsonFiles) {
-        const lang = path.basename(file, '.json');
-        const filePath = path.join(localesDir, file);
-        const content = await fs.readJson(filePath);
-        
-        // Use lodash.set to handle nested keys
-        if (values[lang] !== undefined) {
-            lodash.set(content, key, values[lang]);
-        }
-        
-        await fs.writeJson(filePath, content, { spaces: 2 });
-    }
-}
-
-/**
- * Deletes a translation key across all language files.
- */
-async function deleteTranslation(localesDir, key) {
-    const files = await fs.readdir(localesDir);
-    const jsonFiles = files.filter(f => f.endsWith('.json'));
-
-    for (const file of jsonFiles) {
-        const filePath = path.join(localesDir, file);
-        const content = await fs.readJson(filePath);
-        
-        // Use lodash.unset to handle nested keys
-        lodash.unset(content, key);
-        
-        await fs.writeJson(filePath, content, { spaces: 2 });
-    }
-}
-
-module.exports = {
-    scanTranslations,
-    saveTranslation,
-    deleteTranslation,
-    normalizeTranslations
-};
+const path = require('path');
+const TranslatorManager = require('./core/TranslatorManager');
+
+/**
+ * Facade for the new SOLID core architecture.
+ * Maintains backward compatibility while delegating to the TranslatorManager.
+ */
+
+async function scanTranslations(targetDir, config = {}) {
+    const manager = new TranslatorManager(targetDir, config);
+    return await manager.scan();
+}
+
+async function findUnusedKeys(targetDir, localesDir, allKeys, config = {}) {
+    const Scanner = require('./core/Scanner');
+    const scanner = new Scanner(targetDir, localesDir, config);
+    return await scanner.findUnusedKeys(allKeys);
+}
+
+async function normalizeTranslations(localesDir) {
+    const manager = new TranslatorManager(path.dirname(localesDir), { path: path.basename(localesDir) });
+    await manager.normalize();
+}
+
+async function saveTranslation(localesDir, key, values) {
+    const manager = new TranslatorManager(path.dirname(localesDir), { path: path.basename(localesDir) });
+    await manager.saveTranslation(key, values);
+}
+
+async function deleteTranslation(localesDir, key) {
+    const manager = new TranslatorManager(path.dirname(localesDir), { path: path.basename(localesDir) });
+    await manager.deleteTranslations([key]);
+}
+
+async function deleteMultipleTranslations(localesDir, keys) {
+    const manager = new TranslatorManager(path.dirname(localesDir), { path: path.basename(localesDir) });
+    await manager.deleteTranslations(keys);
+}
+
+module.exports = {
+    scanTranslations,
+    findUnusedKeys,
+    saveTranslation,
+    deleteTranslation,
+    deleteMultipleTranslations,
+    normalizeTranslations
+};

package/src/server.js

@@ -1,64 +1,130 @@
-const express = require('express');
-const cors = require('cors');
-const path = require('path');
-const history = require('express-history-api-fallback');
-const { scanTranslations, saveTranslation, deleteTranslation, normalizeTranslations } = require('./manager');
-
-function startServer(targetDir, port = 3000, config = {}) {
-    const app = express();
-    app.use(cors());
-    app.use(express.json());
-
-    // API endpoints
-    app.get('/api/translations', async (req, res) => {
-        try {
-            const data = await scanTranslations(targetDir, config);
-            res.json(data);
-        } catch (err) {
-            res.status(500).json({ error: err.message });
-        }
-    });
-
-    app.post('/api/translations', async (req, res) => {
-        try {
-            const { key, values } = req.body;
-            const data = await scanTranslations(targetDir, config);
-            await saveTranslation(data.localesDir, key, values);
-            res.json({ success: true });
-        } catch (err) {
-            res.status(500).json({ error: err.message });
-        }
-    });
-
-    app.delete('/api/translations', async (req, res) => {
-        try {
-            const { key } = req.body;
-            const data = await scanTranslations(targetDir, config);
-            await deleteTranslation(data.localesDir, key);
-            res.json({ success: true });
-        } catch (err) {
-            res.status(500).json({ error: err.message });
-        }
-    });
-
-    app.post('/api/normalize', async (req, res) => {
-        try {
-            const data = await scanTranslations(targetDir, config);
-            await normalizeTranslations(data.localesDir);
-            res.json({ success: true });
-        } catch (err) {
-            res.status(500).json({ error: err.message });
-        }
-    });
-
-    // Serve static files from the build folder
-    const buildPath = path.resolve(__dirname, '../web/dist');
-    app.use(express.static(buildPath));
-    app.use(history('index.html', { root: buildPath }));
-
-    app.listen(port, () => {
-        console.log(`\x1b[32m✔\x1b[0m Translation Manager UI is running at http://localhost:${port}`);
-    });
-}
-
-module.exports = { startServer };
+const express = require('express');
+const cors = require('cors');
+const path = require('path');
+const history = require('express-history-api-fallback');
+const TranslatorManager = require('./core/TranslatorManager');
+
+/**
+ * Starts the translation manager server.
+ */
+function startServer(targetDir, port = 3000, config = {}) {
+    const app = express();
+    const manager = new TranslatorManager(targetDir, config);
+    
+    app.use(cors());
+    app.use(express.json());
+
+    // API endpoints
+    app.get('/api/translations', async (req, res) => {
+        try {
+            const data = await manager.scan();
+            res.json(data);
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    app.post('/api/translations', async (req, res) => {
+        try {
+            const { key, values } = req.body;
+            await manager.saveTranslation(key, values);
+            res.json({ success: true });
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    app.delete('/api/translations', async (req, res) => {
+        try {
+            const { key } = req.body;
+            await manager.deleteTranslations(key);
+            res.json({ success: true });
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    app.post('/api/delete-keys', async (req, res) => {
+        try {
+            const { keys } = req.body;
+            await manager.deleteTranslations(keys);
+            res.json({ success: true });
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    app.post('/api/normalize', async (req, res) => {
+        try {
+            await manager.normalize();
+            res.json({ success: true });
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    app.post('/api/translate', async (req, res) => {
+        try {
+            const { text, targetLang, sourceLang } = req.body;
+            const translatedText = await manager.translateSingle(text, targetLang, sourceLang);
+            res.json({ translatedText });
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    app.get('/api/bulk-translate/scan', async (req, res) => {
+        try {
+            const { sourceLang } = req.query;
+            const report = await manager.getBulkTranslateReport(sourceLang || 'en');
+            res.json(report);
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    app.post('/api/bulk-translate/execute', async (req, res) => {
+        try {
+            const { sourceLang } = req.body;
+            const preview = await manager.bulkTranslate(sourceLang || 'en');
+            res.json(preview);
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    app.post('/api/bulk-save', async (req, res) => {
+        try {
+            const { data } = req.body;
+            await manager.saveBulkTranslations(data);
+            res.json({ success: true });
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    app.get('/api/config', (req, res) => {
+        res.json(manager.config);
+    });
+
+    app.post('/api/settings', async (req, res) => {
+        try {
+            const { settings } = req.body;
+            await manager.saveConfig(settings);
+            res.json({ success: true, config: manager.config });
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    // Serve static files from the build folder
+    const buildPath = path.resolve(__dirname, '../web/dist');
+    app.use(express.static(buildPath));
+    app.use(history('index.html', { root: buildPath }));
+
+    app.listen(port, () => {
+        console.log(`\x1b[32m✔\x1b[0m Translation Manager UI is running at http://localhost:${port}`);
+    });
+}
+
+module.exports = { startServer };

package/web/dist/assets/index-5lMTDHig.css

@@ -0,0 +1 @@
+:root{--bg-color:#0b0e14;--sidebar-bg:#111827cc;--accent-color:#7c3aed;--accent-hover:#6d28d9;--text-color:#f3f4f6;--text-muted:#9ca3af;--border-color:#ffffff14;--glass-bg:#ffffff08;--glass-blur:blur(20px);--green:#10b981;--red:#ef4444;--transition:all .25s ease}*{box-sizing:border-box;margin:0;padding:0}body{background-color:var(--bg-color);color:var(--text-color);-webkit-font-smoothing:antialiased;font-family:Inter,system-ui,-apple-system,sans-serif;line-height:1.6}#root{height:100vh;display:flex}.app-container{grid-template-columns:350px 1fr;width:100%;height:100vh;display:grid}.sidebar{background:var(--sidebar-bg);-webkit-backdrop-filter:var(--glass-blur);backdrop-filter:var(--glass-blur);border-right:1px solid var(--border-color);flex-direction:column;display:flex;overflow:hidden}.sidebar-header{border-bottom:1px solid var(--border-color);padding:32px 24px 20px}.brand-row{align-items:center;gap:16px;margin-bottom:24px;display:flex}.logo{filter:drop-shadow(0 0 10px #7c3aed66);border-radius:10px;width:42px;height:42px}.sidebar-header h1{background:linear-gradient(135deg,#a78bfa 0%,#3b82f6 100%);-webkit-text-fill-color:transparent;-webkit-background-clip:text;background-clip:text;margin-bottom:0;font-size:1.5rem;font-weight:800}.search-box{margin-bottom:16px;position:relative}.search-box input{border:1px solid var(--border-color);color:#fff;background:#0003;border-radius:10px;width:100%;padding:12px 16px;font-size:.95rem}.sidebar-actions{gap:8px;margin-top:16px;display:flex}.create-btn{border:1px solid var(--accent-color);color:var(--accent-color);cursor:pointer;transition:var(--transition);background:#7c3aed1a;border-radius:10px;flex:2;padding:11px;font-weight:600}.normalize-btn{border:1px solid var(--green);color:var(--green);cursor:pointer;transition:var(--transition);background:#10b9811a;border-radius:10px;flex:1;justify-content:center;align-items:center;padding:11px;font-size:.85rem;font-weight:600;display:flex}.normalize-btn:hover{background:var(--green);color:#fff}.clean-btn{color:#f59e0b;cursor:pointer;transition:var(--transition);background:#f59e0b1a;border:1px solid #f59e0b;border-radius:10px;flex:1;justify-content:center;align-items:center;padding:11px;font-size:.85rem;font-weight:600;display:flex}.clean-btn:hover{color:#fff;background:#f59e0b}.create-btn:hover{background:var(--accent-color);color:#fff}.tree-view{flex:1;padding:16px;overflow-y:auto}.key-list{list-style:none}.key-list li{cursor:pointer;transition:var(--transition);color:var(--text-muted);border-radius:8px;justify-content:space-between;align-items:center;margin-bottom:4px;padding:10px 14px;font-size:.9rem;display:flex}.key-list li.unused{opacity:.5;font-style:italic}.key-list li.unused span:after{content:" (unused)";opacity:.7;margin-left:4px;font-size:.7rem}.key-list li span{white-space:nowrap;text-overflow:ellipsis;flex:1;overflow:hidden}.key-list li:hover{color:#fff;background:#ffffff0d}.key-list li.active{color:#a78bfa;background:#7c3aed26;font-weight:600}.key-list li.incomplete span{color:var(--text-muted)}.warning-dot{filter:drop-shadow(0 0 5px #ef444480);margin-left:8px;font-size:.8rem}.delete-icon{opacity:0;color:var(--red);cursor:pointer;background:0 0;border:none;padding:0 4px;font-size:1.25rem}.key-list li:hover .delete-icon{opacity:1}.editor{justify-content:center;align-items:flex-start;padding:40px;display:flex;overflow-y:auto}.editor-form{width:100%;max-width:800px;-webkit-backdrop-filter:var(--glass-blur);backdrop-filter:var(--glass-blur);border:1px solid var(--border-color);background:#1f293766;border-radius:20px;padding:40px;box-shadow:0 25px 50px -12px #00000080}.form-group{text-align:left;margin-bottom:24px}.form-group.missing label{color:var(--red)}.form-group.missing input,.form-group.missing textarea{border-color:#ef44444d}.missing-label{margin-left:4px;font-size:.75rem;font-style:italic;font-weight:400}.form-group input,.form-group textarea{border:1px solid var(--border-color);color:#fff;background:#0000004d;border-radius:10px;width:100%;padding:14px;font-family:inherit;font-size:1rem}.form-group textarea{resize:vertical;min-height:100px}.form-actions{gap:16px;margin-top:32px;display:flex}.primary-btn{background:var(--accent-color);color:#fff;cursor:pointer;transition:var(--transition);border:none;border-radius:10px;padding:14px 28px;font-weight:600}.primary-btn:hover{background:var(--accent-hover);transform:translateY(-1px)}.secondary-btn{border:1px solid var(--border-color);color:var(--text-muted);cursor:pointer;background:0 0;border-radius:10px;padding:14px 28px;font-weight:600}.empty-state{text-align:center;max-width:500px}.hero-icon{filter:drop-shadow(0 0 20px #8b5cf64d);margin-bottom:24px;font-size:4rem}.empty-state h2{margin-bottom:12px;font-size:2rem}.empty-state p{color:var(--text-muted);margin-bottom:32px}.modal-overlay{-webkit-backdrop-filter:blur(8px);backdrop-filter:blur(8px);z-index:1000;background:#000000b3;justify-content:center;align-items:center;padding:20px;display:flex;position:fixed;inset:0}.modal-content{border:1px solid var(--border-color);background:#1f2937;border-radius:20px;flex-direction:column;width:100%;max-width:600px;max-height:80vh;display:flex;overflow:hidden;box-shadow:0 25px 50px -12px #00000080}.modal-header{border-bottom:1px solid var(--border-color);justify-content:space-between;align-items:center;padding:24px;display:flex}.modal-body{flex:1;padding:24px;overflow-y:auto}.cleanup-item{cursor:pointer;background:#ffffff08;border-radius:10px;align-items:center;gap:12px;margin-bottom:8px;padding:12px;display:flex}.cleanup-item:hover{background:#ffffff0f}.cleanup-item input{accent-color:var(--accent-color)}.maybe-used-warning{color:#f59e0b;align-items:center;gap:4px;margin-left:auto;font-size:.8rem;font-style:italic;display:flex}.modal-footer{border-top:1px solid var(--border-color);justify-content:flex-end;gap:12px;padding:20px;display:flex}.sidebar-tools{gap:8px;margin-top:12px;display:flex}.tool-btn{border:1px solid var(--border-color);color:var(--text-muted);cursor:pointer;transition:var(--transition);background:#ffffff08;border-radius:8px;flex:1;justify-content:center;align-items:center;gap:6px;padding:8px 12px;font-size:.8rem;font-weight:500;display:flex}.tool-btn:hover{color:#fff;background:#ffffff14;border-color:#fff3}.tool-btn.icon-text{flex:2}.editor-header-row{justify-content:space-between;align-items:center;margin-bottom:32px;display:flex}.magic-btn{color:#a78bfa;background:#7c3aed1a;border-color:#7c3aed4d;padding:10px 16px;font-size:.85rem}.magic-btn:hover{background:var(--accent-color);color:#fff}.label-row{justify-content:space-between;align-items:center;margin-bottom:8px;display:flex}.label-row label{margin-bottom:0}.icon-btn{cursor:pointer;transition:var(--transition);background:0 0;border:none;border-radius:6px;justify-content:center;align-items:center;padding:4px;display:flex}.icon-btn:hover{background:#ffffff1a}.magic-wand{opacity:.6;font-size:1.1rem}.form-group:hover .magic-wand{opacity:1}.alert{border-radius:10px;margin-bottom:20px;padding:12px 16px;font-size:.9rem}.alert-success{color:#34d399;background:#10b9811a;border:1px solid #10b9814d}.alert-error{color:#f87171;background:#ef44441a;border:1px solid #ef44444d}.wizard-step{margin-bottom:24px}.wizard-step label{color:var(--text-color);margin-bottom:12px;font-weight:600;display:block}.source-select{border:1px solid var(--border-color);color:#fff;background:#0000004d;border-radius:10px;width:100%;padding:12px;font-size:1rem}.report-summary{border:1px solid var(--border-color);background:#0003;border-radius:12px;padding:16px}.report-summary ul{color:var(--text-muted);margin-top:12px;padding-left:20px}.preview-container{border:1px solid var(--border-color);background:#0003;border-radius:12px;max-height:400px;padding:16px;overflow-y:auto}.lang-preview{margin-bottom:24px}.lang-preview h3{color:var(--accent-color);border-bottom:1px solid var(--border-color);margin-bottom:12px;padding-bottom:4px;font-size:.85rem}.preview-list{flex-direction:column;gap:8px;display:flex}.preview-item{gap:8px;font-size:.85rem;display:flex}.preview-key{color:var(--text-muted);font-weight:500}.preview-value{color:var(--text-color)}.settings-input{letter-spacing:2px}.help-text{color:var(--text-muted);margin-top:8px;font-size:.8rem}.help-text a{color:var(--accent-color);text-decoration:none}.help-text a:hover{text-decoration:underline}.success-text{color:var(--green);font-weight:500}.approve-btn{background:var(--green)}.approve-btn:hover{background:#059669}.tool-btn.warning{color:#f59e0b;background:#f59e0b1a;border-color:#f59e0b4d}.tool-btn.warning:hover{color:#fff;background:#f59e0b}.missing-keys-list{margin-top:16px;list-style:none}.missing-key-item{border:1px solid var(--border-color);background:#ffffff08;border-radius:12px;justify-content:space-between;align-items:center;margin-bottom:8px;padding:14px;display:flex}.key-path{color:#a78bfa;font-family:JetBrains Mono,Fira Code,monospace;font-size:.85rem}.warning-box{color:#f59e0b;background:#f59e0b14;border:1px solid #f59e0b33;border-radius:12px;margin-bottom:24px;padding:16px;font-size:.85rem}.sm{padding:8px 14px;font-size:.8rem}