@saidksi/localizer-cli 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 SaidKSI
+
+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", BASIS 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,99 @@
+# @localize/cli
+
+Command-line tool for automating i18n workflows in JavaScript/TypeScript projects. Scans for hardcoded strings, generates semantic i18n keys via AI, translates into target languages, and rewrites source code.
+
+## Installation
+
+```bash
+# Global installation
+npm install -g @localize/cli
+
+# Per-project installation
+npm install --save-dev @localize/cli
+```
+
+## Quick Start
+
+```bash
+# Initialize your project
+localize init
+
+# Scan for hardcoded strings
+localize scan src/
+
+# Full automation: scan → generate keys → translate → rewrite
+localize run --yes
+
+# Validate translation coverage
+localize validate
+```
+
+## Commands
+
+### `localize init`
+Interactive setup wizard. Creates `.localize.config.json` and stores API keys in `~/.localize`.
+
+### `localize audit`
+Count total untranslated strings in your project.
+
+### `localize scan <path>`
+List all hardcoded strings found in a file or directory.
+
+### `localize translate [options]`
+Generate semantic i18n keys and translate strings into target languages.
+
+### `localize rewrite <path> [options]`
+Replace hardcoded strings with i18n function calls (`t('key')`).
+
+### `localize run [options]`
+Full pipeline: scan → generate keys → translate → rewrite → validate.
+
+### `localize validate [options]`
+Check translation coverage across all languages. Use `--ci` for CI/CD.
+
+### `localize add-lang <language>`
+Add a new language and translate all existing keys.
+
+### `localize status`
+Show project health snapshot (files, strings, translation coverage).
+
+### `localize diff <language>`
+Show missing keys for a specific language.
+
+## Configuration
+
+Create `.localize.config.json` in your project root:
+
+```json
+{
+  "defaultLanguage": "en",
+  "languages": ["en", "fr", "es"],
+  "messagesDir": "./messages",
+  "include": ["src/**/*.{ts,tsx,js,jsx}"],
+  "exclude": ["**/*.test.ts", "**/*.spec.ts"],
+  "aiProvider": "anthropic",
+  "aiModel": "claude-3-sonnet-20240229",
+  "keyStyle": "dot.notation",
+  "i18nLibrary": "react-i18next",
+  "fileOrganization": "per-page",
+  "strictMode": true,
+  "glossary": {}
+}
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm build
+pnpm test
+pnpm lint
+```
+
+## License
+
+MIT
+
+## Repository
+
+https://github.com/SaidKSI/localize-cli

package/dist/bin/localize.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=localize.d.ts.map

package/dist/bin/localize.d.ts.map

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

package/dist/bin/localize.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { main } from "../index.js";
+main().catch((error) => {
+    console.error("Error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=localize.js.map

package/dist/bin/localize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localize.js","sourceRoot":"","sources":["../../src/bin/localize.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/commands/add-lang.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const addLangCommand: Command;
+//# sourceMappingURL=add-lang.d.ts.map

package/dist/commands/add-lang.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-lang.d.ts","sourceRoot":"","sources":["../../src/commands/add-lang.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsHpC,eAAO,MAAM,cAAc,SAWvB,CAAC"}

package/dist/commands/add-lang.js

@@ -0,0 +1,103 @@
+import { Command } from "commander";
+import { resolve, join, basename, extname } from "path";
+import { readdir } from "fs/promises";
+import ora from "ora";
+import chalk from "chalk";
+import { translateExistingKeys } from "@saidksi/localizer-core";
+import { logger } from "../utils/logger.js";
+import { loadConfig, requireApiKey, writeProjectConfig } from "../utils/config.js";
+import { readFile } from "fs/promises";
+import { flattenJson } from "../utils/json.js";
+async function readAllEntries(messagesDir, sourceLang) {
+    const langDir = join(resolve(messagesDir), sourceLang);
+    let files;
+    try {
+        const all = await readdir(langDir);
+        files = all.filter((f) => f.endsWith(".json"));
+    }
+    catch {
+        return [];
+    }
+    const entries = [];
+    for (const file of files) {
+        const pageName = basename(file, extname(file));
+        const raw = await readFile(join(langDir, file), "utf-8").catch(() => "{}");
+        const flat = flattenJson(JSON.parse(raw));
+        for (const [key, value] of Object.entries(flat)) {
+            entries.push({ key, value, pageName });
+        }
+    }
+    return entries;
+}
+async function runAddLang(options) {
+    const cwd = process.cwd();
+    const config = await loadConfig(cwd).catch((err) => logger.fatal(err instanceof Error ? err.message : String(err)));
+    const apiKey = await requireApiKey(config.aiProvider).catch((err) => logger.fatal(err instanceof Error ? err.message : String(err)));
+    const newLang = options.lang.trim().toLowerCase();
+    const sourceLang = options.from ?? config.defaultLanguage;
+    // Guard: already configured (e.g. add-lang was partially interrupted)
+    if (config.languages.includes(newLang)) {
+        logger.warn(`Language "${newLang}" is already in your config.`);
+        logger.dim(`  To fill missing keys: localize translate --from-existing --missing-only --lang ${newLang}`);
+        return;
+    }
+    // Guard: source language must exist
+    const knownLangs = [config.defaultLanguage, ...config.languages];
+    if (!knownLangs.includes(sourceLang)) {
+        logger.fatal(`Source language "${sourceLang}" is not in your config.`);
+    }
+    logger.header(`Adding language: ${chalk.cyan(newLang)}`);
+    logger.dim(`  Source: ${sourceLang}  →  Target: ${newLang}`);
+    logger.blank();
+    // ── Read existing keys
+    const readSpinner = ora(`Reading keys from ${sourceLang}…`).start();
+    const entries = await readAllEntries(config.messagesDir, sourceLang);
+    readSpinner.succeed(`Found ${entries.length} key${entries.length !== 1 ? "s" : ""} in "${sourceLang}".`);
+    if (entries.length === 0) {
+        logger.warn(`No keys found in messages/${sourceLang}/. Run \`localize translate\` first.`);
+        return;
+    }
+    // ── Translate into new language
+    const aiSpinner = ora(`Translating ${entries.length} keys into "${newLang}"…`).start();
+    const addLangOpts = {
+        overwrite: false,
+        langs: [newLang],
+    };
+    if (options.dryRun !== undefined)
+        addLangOpts.dryRun = options.dryRun;
+    const result = await translateExistingKeys(entries, config, apiKey, addLangOpts);
+    aiSpinner.succeed(`Translated ${result.translated} key${result.translated !== 1 ? "s" : ""}.`);
+    if (result.aiCostUsd > 0) {
+        logger.dim(`  Estimated cost: ~$${result.aiCostUsd.toFixed(4)}`);
+    }
+    if (options.dryRun) {
+        logger.blank();
+        logger.warn("Dry run — no files written, config not updated.");
+        return;
+    }
+    // ── Update config
+    const updatedConfig = {
+        ...config,
+        languages: [...config.languages, newLang],
+    };
+    await writeProjectConfig(updatedConfig, cwd);
+    logger.blank();
+    logger.success(`Added "${newLang}" to .localize.config.json`);
+    logger.dim(`  Files written: ${result.messagesWritten.length}`);
+    logger.dim(`  Run \`localize validate --lang ${newLang}\` to check coverage.`);
+    logger.blank();
+}
+export const addLangCommand = new Command("add-lang")
+    .description("Add a new target language and translate all existing keys into it")
+    .requiredOption("--lang <lang>", "ISO 639-1 language code to add (e.g. ja)")
+    .option("--from <lang>", "Source language to translate from (default: config.defaultLanguage)")
+    .option("--dry-run", "Preview translations without writing files")
+    .action(async (options) => {
+    try {
+        await runAddLang(options);
+    }
+    catch (err) {
+        logger.fatal(err instanceof Error ? err.message : String(err));
+    }
+});
+//# sourceMappingURL=add-lang.js.map

package/dist/commands/add-lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-lang.js","sourceRoot":"","sources":["../../src/commands/add-lang.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAyB,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,KAAK,UAAU,cAAc,CAC3B,WAAmB,EACnB,UAAkB;IAElB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,CAAC;IACvD,IAAI,KAAe,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACnC,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3E,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC,CAAC;QACrE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAUD,KAAK,UAAU,UAAU,CAAC,OAAuB;IAC/C,MAAM,GAAG,GAAM,OAAO,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE,CAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAC/D,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE,CAC3E,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAC/D,CAAC;IAEF,MAAM,OAAO,GAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,eAAe,CAAC;IAE1D,sEAAsE;IACtE,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,aAAa,OAAO,8BAA8B,CAAC,CAAC;QAChE,MAAM,CAAC,GAAG,CAAC,oFAAoF,OAAO,EAAE,CAAC,CAAC;QAC1G,OAAO;IACT,CAAC;IAED,oCAAoC;IACpC,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACjE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,oBAAoB,UAAU,0BAA0B,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,oBAAoB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzD,MAAM,CAAC,GAAG,CAAC,aAAa,UAAU,gBAAgB,OAAO,EAAE,CAAC,CAAC;IAC7D,MAAM,CAAC,KAAK,EAAE,CAAC;IAEf,wBAAwB;IACxB,MAAM,WAAW,GAAG,GAAG,CAAC,qBAAqB,UAAU,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACrE,WAAW,CAAC,OAAO,CAAC,SAAS,OAAO,CAAC,MAAM,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,UAAU,IAAI,CAAC,CAAC;IAEzG,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,6BAA6B,UAAU,sCAAsC,CAAC,CAAC;QAC3F,OAAO;IACT,CAAC;IAED,iCAAiC;IACjC,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,OAAO,CAAC,MAAM,eAAe,OAAO,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IACvF,MAAM,WAAW,GAAgE;QAC/E,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,CAAC,OAAO,CAAC;KACjB,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACtE,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACjF,SAAS,CAAC,OAAO,CAAC,cAAc,MAAM,CAAC,UAAU,OAAO,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE/F,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,mBAAmB;IACnB,MAAM,aAAa,GAAG;QACpB,GAAG,MAAM;QACT,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC;KAC1C,CAAC;IACF,MAAM,kBAAkB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAE7C,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,MAAM,CAAC,OAAO,CAAC,UAAU,OAAO,4BAA4B,CAAC,CAAC;IAC9D,MAAM,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,MAAM,CAAC,GAAG,CAAC,oCAAoC,OAAO,uBAAuB,CAAC,CAAC;IAC/E,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;KAClD,WAAW,CAAC,mEAAmE,CAAC;KAChF,cAAc,CAAC,eAAe,EAAE,0CAA0C,CAAC;KAC3E,MAAM,CAAC,eAAe,EAAU,qEAAqE,CAAC;KACtG,MAAM,CAAC,WAAW,EAAc,4CAA4C,CAAC;KAC7E,MAAM,CAAC,KAAK,EAAE,OAAuB,EAAE,EAAE;IACxC,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/commands/audit.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const auditCommand: Command;
+//# sourceMappingURL=audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqNpC,eAAO,MAAM,YAAY,SAcrB,CAAC"}

package/dist/commands/audit.js

@@ -0,0 +1,174 @@
+import { Command } from "commander";
+import { resolve, relative, dirname, basename } from "path";
+import ora from "ora";
+import chalk from "chalk";
+import { scanFile, scanDirectory } from "@saidksi/localizer-core";
+import { logger } from "../utils/logger.js";
+import { loadConfig } from "../utils/config.js";
+import { writeReport } from "../utils/reporter.js";
+/**
+ * Group scan results by relative directory path.
+ * e.g. all results from "src/pages/Login.tsx" and "src/pages/Register.tsx"
+ * → one group labelled "src/pages/"
+ */
+function groupByDirectory(results, cwd) {
+    const map = new Map();
+    for (const r of results) {
+        const rel = relative(cwd, r.file);
+        const dir = dirname(rel) + "/";
+        const entry = map.get(dir) ?? { files: new Set(), count: 0 };
+        entry.files.add(r.file);
+        entry.count++;
+        map.set(dir, entry);
+    }
+    return [...map.entries()]
+        .map(([label, { files, count }]) => ({
+        label,
+        stringCount: count,
+        fileCount: files.size,
+        files: [...files],
+    }))
+        .sort((a, b) => b.stringCount - a.stringCount);
+}
+/**
+ * Group scan results by source file (page name).
+ * e.g. all results from "src/pages/Login.tsx" → one group labelled "Login.tsx"
+ */
+function groupByPage(results, cwd) {
+    const map = new Map();
+    for (const r of results) {
+        const rel = relative(cwd, r.file);
+        const page = basename(r.file);
+        const entry = map.get(rel) ?? { file: rel, count: 0 };
+        entry.count++;
+        map.set(rel, entry);
+    }
+    return [...map.entries()]
+        .map(([rel, { count }]) => ({
+        label: rel,
+        stringCount: count,
+        fileCount: 1,
+        files: [rel],
+    }))
+        .sort((a, b) => b.stringCount - a.stringCount);
+}
+// ─── Output ───────────────────────────────────────────────────────────────────
+function printAuditTable(groups, total, cwd) {
+    if (total.length === 0) {
+        logger.success("No untranslated strings found.");
+        return;
+    }
+    logger.blank();
+    logger.raw(chalk.bold("  Untranslated strings found:\n"));
+    // Calculate column widths for alignment
+    const maxLabelLen = Math.max(...groups.map((g) => g.label.length), 10);
+    for (const g of groups) {
+        const label = g.label.padEnd(maxLabelLen + 2);
+        const strCount = chalk.yellow(`${g.stringCount} string${g.stringCount !== 1 ? "s" : ""}`);
+        const fileCount = chalk.dim(`across ${g.fileCount} file${g.fileCount !== 1 ? "s" : ""}`);
+        logger.raw(`  ${chalk.cyan(label)}  ${strCount}  ${fileCount}`);
+    }
+    const totalFiles = new Set(total.map((r) => r.file)).size;
+    logger.blank();
+    logger.raw(`  ${chalk.bold("Total:")} ${chalk.yellow(total.length)} strings in ${chalk.yellow(totalFiles)} files`);
+    logger.blank();
+    logger.raw(chalk.dim("  Run `localize run --dir <path>` to process any directory."));
+    logger.raw(chalk.dim("  Run `localize audit --output audit.json` to export as a work list."));
+    logger.blank();
+}
+function printSummaryOnly(groups, total) {
+    if (total.length === 0) {
+        logger.success("No untranslated strings found.");
+        return;
+    }
+    for (const g of groups) {
+        logger.raw(`  ${g.label.padEnd(40)}  ${g.stringCount}`);
+    }
+    const totalFiles = new Set(total.map((r) => r.file)).size;
+    logger.blank();
+    logger.raw(`  Total: ${total.length} strings in ${totalFiles} files`);
+}
+async function runAudit(options) {
+    const cwd = process.cwd();
+    const config = await loadConfig(cwd).catch((err) => logger.fatal(err instanceof Error ? err.message : String(err)));
+    const spinner = ora("Scanning for untranslated strings...").start();
+    let results = [];
+    try {
+        if (options.file) {
+            results = await scanFile(resolve(cwd, options.file), config);
+        }
+        else if (options.dir) {
+            results = await scanDirectory(resolve(cwd, options.dir), config);
+        }
+        else {
+            // Scan all include dirs from config
+            const all = await Promise.all(config.include.map((dir) => scanDirectory(resolve(cwd, dir), config).catch(() => [])));
+            results = all.flat();
+        }
+    }
+    catch (err) {
+        spinner.fail("Scan failed.");
+        logger.fatal(err instanceof Error ? err.message : String(err));
+    }
+    // Filter already-translated strings — audit only shows untranslated ones
+    const untranslated = results.filter((r) => !r.alreadyTranslated);
+    spinner.succeed(`Scanned ${new Set(results.map((r) => r.file)).size} files — ` +
+        `${untranslated.length} untranslated string${untranslated.length !== 1 ? "s" : ""} found.`);
+    // Group results
+    const groupFn = options.groupBy === "page" ? groupByPage : groupByDirectory;
+    const groups = groupFn(untranslated, cwd);
+    // CI mode: output JSON to stdout and exit with code 1 if issues found
+    if (options.ci) {
+        const reportData = {
+            generatedAt: new Date().toISOString(),
+            file: options.file,
+            dir: options.dir,
+            totalStrings: untranslated.length,
+            totalFiles: new Set(untranslated.map((r) => r.file)).size,
+            groups,
+            results: untranslated,
+        };
+        console.log(JSON.stringify(reportData, null, 2));
+        if (untranslated.length > 0) {
+            process.exit(1);
+        }
+        return;
+    }
+    // Print output
+    if (options.summary) {
+        printSummaryOnly(groups, untranslated);
+    }
+    else {
+        printAuditTable(groups, untranslated, cwd);
+    }
+    // Write JSON report if requested
+    if (options.output) {
+        await writeReport(options.output, {
+            generatedAt: new Date().toISOString(),
+            file: options.file,
+            dir: options.dir,
+            totalStrings: untranslated.length,
+            totalFiles: new Set(untranslated.map((r) => r.file)).size,
+            groups,
+            results: untranslated,
+        });
+        logger.success(`Report written to ${options.output}`);
+    }
+}
+export const auditCommand = new Command("audit")
+    .description("Scan the full app for untranslated strings (read-only, no AI)")
+    .option("--dir <dir>", "Scope to a directory")
+    .option("--file <file>", "Scope to a single file")
+    .option("--summary", "Print counts per directory only")
+    .option("--output <path>", "Export structured report as JSON")
+    .option("--group-by <by>", "Group results by: page")
+    .option("--ci", "Machine-readable JSON output to stdout, exit 1 if any strings found")
+    .action(async (options) => {
+    try {
+        await runAudit(options);
+    }
+    catch (err) {
+        logger.fatal(err instanceof Error ? err.message : String(err));
+    }
+});
+//# sourceMappingURL=audit.js.map

package/dist/commands/audit.js.map

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

package/dist/commands/diff.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const diffCommand: Command;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmGpC,eAAO,MAAM,WAAW,SAUpB,CAAC"}

package/dist/commands/diff.js

@@ -0,0 +1,76 @@
+import { Command } from "commander";
+import { writeFile } from "fs/promises";
+import { resolve } from "path";
+import chalk from "chalk";
+import ora from "ora";
+import { validateCoverage } from "@saidksi/localizer-core";
+import { logger } from "../utils/logger.js";
+import { loadConfig } from "../utils/config.js";
+async function runDiff(options) {
+    const cwd = process.cwd();
+    const config = await loadConfig(cwd).catch((err) => logger.fatal(err instanceof Error ? err.message : String(err)));
+    const lang = options.lang.trim().toLowerCase();
+    // Validate: must be a known language
+    const known = [config.defaultLanguage, ...config.languages];
+    if (!known.includes(lang)) {
+        logger.fatal(`Language "${lang}" is not in your config. Known languages: ${known.join(", ")}`);
+    }
+    if (lang === config.defaultLanguage) {
+        logger.warn(`"${lang}" is the default language — it always has 100% coverage.`);
+        return;
+    }
+    const spinner = ora(`Computing diff for "${lang}"…`).start();
+    // Single validateCoverage call provides both missing keys and coverage data
+    const coverageResults = await validateCoverage(config, { lang });
+    const result = coverageResults.find((r) => r.language === lang);
+    const missingKeys = result?.missingKeys ?? [];
+    const percent = result?.coveragePercent ?? 0;
+    const total = result?.totalKeys ?? 0;
+    spinner.succeed(`Diff computed.`);
+    logger.blank();
+    if (missingKeys.length === 0) {
+        logger.success(`"${lang}" has full coverage — no missing keys.`);
+        logger.blank();
+        if (options.output) {
+            await writeFile(resolve(cwd, options.output), JSON.stringify([], null, 2) + "\n", "utf-8");
+            logger.dim(`Empty list written to ${options.output}`);
+            logger.blank();
+        }
+        return;
+    }
+    logger.raw(chalk.bold(`  Missing keys in ${chalk.red(lang)}`) +
+        chalk.dim(` — ${missingKeys.length} of ${total} keys missing (${percent}% covered):`));
+    logger.blank();
+    for (const key of missingKeys) {
+        logger.raw(`  ${chalk.dim("·")} ${key}`);
+    }
+    logger.blank();
+    logger.dim(`  Run \`localize translate --missing-only --lang ${lang}\` to fill these keys.`);
+    logger.blank();
+    // Optional JSON output
+    if (options.output) {
+        const outPath = resolve(cwd, options.output);
+        await writeFile(outPath, JSON.stringify({
+            language: lang,
+            totalKeys: total,
+            missingCount: missingKeys.length,
+            coveragePercent: percent,
+            missingKeys,
+        }, null, 2) + "\n", "utf-8");
+        logger.success(`Missing key list saved to ${options.output}`);
+        logger.blank();
+    }
+}
+export const diffCommand = new Command("diff")
+    .description("Show keys missing from a target language relative to the default")
+    .requiredOption("--lang <lang>", "Language to diff against the default")
+    .option("--output <path>", "Save missing key list as JSON")
+    .action(async (options) => {
+    try {
+        await runDiff(options);
+    }
+    catch (err) {
+        logger.fatal(err instanceof Error ? err.message : String(err));
+    }
+});
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const initCommand: Command;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwfpC,eAAO,MAAM,WAAW,SAiBpB,CAAC"}