Function findUnused

scripts/i18n-manager.mjs:534–602

`find-unused`: Finds translation keys in en.ts that are not used in the source code

()

/** `find-unused`: Finds translation keys in en.ts that are not used in the source code */
async function findUnused() {
    console.log('Finding unused translation keys...\n');

    const manifest = loadJson(MANIFEST_PATH);

    if (Object.keys(manifest).length === 0) {
        console.error('❌ Error: No manifest found. Run "npm run i18n:sync" first.');
        process.exit(1);
    }

    // Get all keys from manifest
    const allKeys = Object.keys(manifest);

    // Find all translation function calls in the codebase
    const patterns = [
        `rg --no-filename --no-heading --no-line-number '\\bt\\(["\\x27]([^"\\x27]+)["\\x27]\\)' -o -r '\$1' src/`,
        `rg --no-filename --no-heading --no-line-number 'i18n\\.translate\\(["\\x27]([^"\\x27]+)["\\x27]' -o -r '\$1' src/`,
        `rg --no-filename --no-heading --no-line-number 'this\\.t\\(["\\x27]([^"\\x27]+)["\\x27]' -o -r '\$1' src/`,
        `rg --no-filename --no-heading --no-line-number 'this\\.translate\\(["\\x27]([^"\\x27]+)["\\x27]' -o -r '\$1' src/`,
        `rg --no-filename --no-heading --no-line-number '\\btranslate\\(["\\x27]([^"\\x27]+)["\\x27]' -o -r '\$1' src/`
    ];

    const usedKeys = new Set();

    for (const pattern of patterns) {
        try {
            const output = execSync(pattern, { encoding: 'utf8', shell: '/bin/bash' });
            output.trim().split('\n').filter(Boolean).forEach(key => usedKeys.add(key));
        } catch (error) {
            // No matches is fine
        }
    }

    // Find keys in manifest but not used in source
    const unusedKeys = allKeys.filter(key => !usedKeys.has(key));

    console.log(`📊 Statistics:`);
    console.log(`  Total keys in en.ts: ${allKeys.length}`);
    console.log(`  Keys found in source code: ${usedKeys.size}`);
    console.log(`  Potentially unused keys: ${unusedKeys.length}`);
    console.log(`  Coverage: ${Math.round((usedKeys.size / allKeys.length) * 100)}%\n`);

    if (unusedKeys.length > 0) {
        console.log('⚠️  Potentially unused keys (not found in source code):\n');

        // Group by prefix for easier reading
        const grouped = {};
        unusedKeys.forEach(key => {
            const prefix = key.split('.')[0];
            if (!grouped[prefix]) grouped[prefix] = [];
            grouped[prefix].push(key);
        });

        for (const [prefix, keys] of Object.entries(grouped).sort()) {
            console.log(`[${prefix}] ${keys.length} keys:`);
            keys.forEach(key => console.log(`  - ${key}`));
            console.log('');
        }