@babelize/cli 1.0.12 → 1.1.0

package/dist/local/git.js

@@ -0,0 +1,52 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+export class GitError extends Error {
+    code;
+    dirtyFiles;
+    constructor(message, code, dirtyFiles = []) {
+        super(message);
+        this.code = code;
+        this.dirtyFiles = dirtyFiles;
+        this.name = 'GitError';
+    }
+}
+async function git(cwd, args) {
+    const { stdout } = await execFileAsync('git', args, { cwd, maxBuffer: 64 * 1024 * 1024 });
+    return stdout;
+}
+/** Throws GitError('not_a_repo' | 'git_missing') unless `dir` is inside a git work tree. */
+export async function assertGitRepo(dir) {
+    try {
+        const out = await git(dir, ['rev-parse', '--is-inside-work-tree']);
+        if (out.trim() !== 'true')
+            throw new Error('not inside a work tree');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new GitError('git is not installed or not on PATH.', 'git_missing');
+        }
+        throw new GitError('Not a git repository. `babelize translate` writes into your working tree so you can review the result with `git diff` — run it inside a git repo (or `git init` first).', 'not_a_repo');
+    }
+}
+/** Uncommitted changes under `dir` (tracked edits and untracked files), as porcelain lines. */
+export async function getUncommittedChanges(dir) {
+    const out = await git(dir, ['status', '--porcelain', '--untracked-files=all', '--', '.']);
+    return out.split('\n').filter((line) => line.trim().length > 0);
+}
+/**
+ * Refuse to run on a dirty tree unless `force`: the result has to be reviewable
+ * as its own `git diff`, and a failed review has to be undoable with
+ * `git checkout . && git clean -fd` without losing the user's work.
+ */
+export async function assertCleanTree(dir, force) {
+    const dirty = await getUncommittedChanges(dir);
+    if (dirty.length > 0 && !force) {
+        const preview = dirty.slice(0, 10).map((l) => `  ${l}`).join('\n');
+        const more = dirty.length > 10 ? `\n  … and ${dirty.length - 10} more` : '';
+        throw new GitError(`Your working tree has uncommitted changes:\n${preview}${more}\n` +
+            'Commit or stash them first so the translation shows up as its own reviewable `git diff`, or re-run with --force.', 'dirty', dirty);
+    }
+    return dirty;
+}
+//# sourceMappingURL=git.js.map

package/dist/local/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/local/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGtB;IACA;IAHX,YACE,OAAe,EACN,IAA4C,EAC5C,aAAuB,EAAE;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAAwC;QAC5C,eAAU,GAAV,UAAU,CAAe;QAGlC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,KAAK,UAAU,GAAG,CAAC,GAAW,EAAE,IAAc;IAC5C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;IAC1F,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC,CAAC;QACnE,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,QAAQ,CAAC,sCAAsC,EAAE,aAAa,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,IAAI,QAAQ,CAChB,yKAAyK,EACzK,YAAY,CACb,CAAC;IACJ,CAAC;AACH,CAAC;AAED,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAW;IACrD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,uBAAuB,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1F,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,KAAc;IAC/D,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,MAAM,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,QAAQ,CAChB,+CAA+C,OAAO,GAAG,IAAI,IAAI;YAC/D,kHAAkH,EACpH,OAAO,EACP,KAAK,CACN,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/local/provider.d.ts

@@ -0,0 +1,41 @@
+import { type ByokProvider } from '@babelize/types';
+/**
+ * Env var holding each provider's key, in auto-detection order: the first one
+ * set wins when `--provider` isn't given.
+ */
+export declare const PROVIDER_ENV_VARS: ReadonlyArray<{
+    provider: ByokProvider;
+    envVar: string;
+}>;
+export interface ResolvedProvider {
+    provider: ByokProvider;
+    /** Never print this. */
+    apiKey: string;
+    model: string;
+    /** Env var the key came from (safe to print). */
+    envVar: string;
+    /** True when the provider was picked from the environment, not `--provider`. */
+    autoDetected: boolean;
+}
+export type ProviderResolution = {
+    ok: true;
+    value: ResolvedProvider;
+} | {
+    ok: false;
+    code: 'unknown_provider' | 'missing_key' | 'no_key';
+    message: string;
+};
+export declare function isByokProvider(value: string): value is ByokProvider;
+/** Message shown when no BYOK key is available. Lists env vars, never values. */
+export declare function noKeyMessage(env?: NodeJS.ProcessEnv): string;
+/**
+ * Pick the BYOK provider: `--provider` if given (its env var must be set),
+ * otherwise the first provider whose env var is set, in PROVIDER_ENV_VARS
+ * order. The model is `--model` or the provider's default from
+ * @babelize/types.
+ */
+export declare function resolveProvider(opts: {
+    provider?: string;
+    model?: string;
+}, env?: NodeJS.ProcessEnv): ProviderResolution;
+//# sourceMappingURL=provider.d.ts.map

package/dist/local/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/local/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1F;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAMvF,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,CAAC;IACvB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,kBAAkB,GAAG,aAAa,GAAG,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEnE;AAMD,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAazE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,kBAAkB,CAkDpB"}

package/dist/local/provider.js

@@ -0,0 +1,87 @@
+import { BYOK_PROVIDERS, PROVIDER_DEFINITIONS } from '@babelize/types';
+/**
+ * Env var holding each provider's key, in auto-detection order: the first one
+ * set wins when `--provider` isn't given.
+ */
+export const PROVIDER_ENV_VARS = [
+    { provider: 'anthropic', envVar: 'ANTHROPIC_API_KEY' },
+    { provider: 'openai', envVar: 'OPENAI_API_KEY' },
+    { provider: 'gemini', envVar: 'GEMINI_API_KEY' },
+    { provider: 'groq', envVar: 'GROQ_API_KEY' },
+    { provider: 'openrouter', envVar: 'OPENROUTER_API_KEY' },
+];
+export function isByokProvider(value) {
+    return BYOK_PROVIDERS.includes(value);
+}
+function envVarFor(provider) {
+    return PROVIDER_ENV_VARS.find((p) => p.provider === provider).envVar;
+}
+/** Message shown when no BYOK key is available. Lists env vars, never values. */
+export function noKeyMessage(env = process.env) {
+    const lines = [
+        'No LLM API key found. `babelize translate` uses your own key for now. Set one of:',
+        ...PROVIDER_ENV_VARS.map((p) => `  ${p.envVar.padEnd(20)} (${PROVIDER_DEFINITIONS[p.provider].name})`),
+    ];
+    if (env.BABELIZE_API_KEY) {
+        lines.push('BABELIZE_API_KEY is set, but Babelize-hosted translation for local runs is not available yet (coming next).');
+    }
+    else {
+        lines.push('Babelize-hosted translation (BABELIZE_API_KEY) is coming next.');
+    }
+    return lines.join('\n');
+}
+/**
+ * Pick the BYOK provider: `--provider` if given (its env var must be set),
+ * otherwise the first provider whose env var is set, in PROVIDER_ENV_VARS
+ * order. The model is `--model` or the provider's default from
+ * @babelize/types.
+ */
+export function resolveProvider(opts, env = process.env) {
+    const model = opts.model?.trim() || undefined;
+    if (opts.provider) {
+        const requested = opts.provider.trim().toLowerCase();
+        if (!isByokProvider(requested)) {
+            return {
+                ok: false,
+                code: 'unknown_provider',
+                message: `Unknown provider "${opts.provider}". Use one of: ${PROVIDER_ENV_VARS.map((p) => p.provider).join(', ')}.`,
+            };
+        }
+        const envVar = envVarFor(requested);
+        const apiKey = env[envVar]?.trim();
+        if (!apiKey) {
+            return {
+                ok: false,
+                code: 'missing_key',
+                message: `--provider ${requested} needs ${envVar} to be set.`,
+            };
+        }
+        return {
+            ok: true,
+            value: {
+                provider: requested,
+                apiKey,
+                model: model ?? PROVIDER_DEFINITIONS[requested].defaultModel,
+                envVar,
+                autoDetected: false,
+            },
+        };
+    }
+    for (const { provider, envVar } of PROVIDER_ENV_VARS) {
+        const apiKey = env[envVar]?.trim();
+        if (apiKey) {
+            return {
+                ok: true,
+                value: {
+                    provider,
+                    apiKey,
+                    model: model ?? PROVIDER_DEFINITIONS[provider].defaultModel,
+                    envVar,
+                    autoDetected: true,
+                },
+            };
+        }
+    }
+    return { ok: false, code: 'no_key', message: noKeyMessage(env) };
+}
+//# sourceMappingURL=provider.js.map

package/dist/local/provider.js.map

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

package/dist/local/translate-core.d.ts

@@ -0,0 +1,188 @@
+import { type EngineConfigV2, type EngineResultV2, type TranslationFailure, type TranslationProvider } from '@babelize/engine';
+import { type ByokProvider } from '@babelize/types';
+import { type FormatResult } from './formatter.js';
+import { type ApplyIo, type WorkspaceChanges } from './workspace-copy.js';
+/** Lockfile scope for local runs: `.babelize/local/babelize-lock.json` in the project root. */
+export declare const LOCAL_PROJECT_ID = "local";
+export declare const LOCAL_LOCKFILE = ".babelize/local/babelize-lock.json";
+export declare const SUPPORTED_LOCAL_FRAMEWORKS: readonly ["react", "nextjs"];
+export declare const BETA_LOCAL_FRAMEWORKS: readonly ["vue", "static"];
+export interface LocalTranslateOptions {
+    projectDir: string;
+    sourceLocale: string;
+    targetLocales: string[];
+    /** Compute and return the diff; write nothing to the project. */
+    dryRun: boolean;
+    /** Allow running on a dirty git tree. */
+    force: boolean;
+    /** The user's LLM key. Required unless `deps.translator` is injected. */
+    byok?: {
+        provider: ByokProvider;
+        apiKey: string;
+        model?: string;
+    };
+    /**
+     * Treat `targetLocales` as the complete list: locales translated earlier
+     * but not listed are removed. Default false: earlier locales are kept and
+     * brought up to date (from the lockfile, so only new strings cost tokens).
+     */
+    replace?: boolean;
+}
+export interface LocalTranslateDeps {
+    /** Replaces the BYOK translator (tests, future Babelize-hosted provider). */
+    translator?: TranslationProvider;
+    /** Engine entry point; injectable for tests. */
+    runEngine?: (config: EngineConfigV2) => Promise<EngineResultV2>;
+    /** Engine progress; `status` is running/success/warning/error. */
+    onProgress?: (message: string, phase?: string, status?: string) => void;
+    /** Called once the framework is known, before any LLM call. */
+    onFramework?: (framework: string, status: FrameworkStatus) => void;
+    /** Parent dir for the temp copy (defaults to the OS temp dir). */
+    tmpRoot?: string;
+    /** File operations for applying changes; injectable to simulate disk failures. */
+    applyIo?: ApplyIo;
+}
+export type FrameworkStatus = 'supported' | 'beta';
+export type LocalTranslateErrorCode = 'not_a_repo' | 'git_missing' | 'dirty' | 'invalid_locale' | 'no_translator' | 'unsupported_framework' | 'translator_unreachable' | 'engine_failed' | 'incomplete_translation'
+/** Writing to the project failed; see `changedFiles` for what is left changed. */
+ | 'apply_failed'
+/** Project files changed while the run was in progress; nothing was applied. */
+ | 'project_changed';
+export declare class LocalTranslateError extends Error {
+    readonly code: LocalTranslateErrorCode;
+    /** Files left changed in the project (only for a failed, un-rolled-back apply). */
+    readonly changedFiles: string[];
+    constructor(message: string, code: LocalTranslateErrorCode, 
+    /** Files left changed in the project (only for a failed, un-rolled-back apply). */
+    changedFiles?: string[]);
+}
+/** Per-locale outcome. `missing` and `sameAsSource` are what a reviewer should look at. */
+export interface LocaleReport {
+    locale: string;
+    /** Keys in the source locale. */
+    total: number;
+    /** Keys with a value (including values identical to the source, see `sameAsSource`). */
+    translated: number;
+    /** Keys with no value in this locale (the app will show the fallback). */
+    missing: string[];
+    /** Keys the engine could not translate this run, with the reason (subset of `missing`). */
+    failed: Array<{
+        key: string;
+        reason: string;
+        message?: string;
+        retryable: boolean;
+    }>;
+    /** Keys translated with QA warnings from the engine (glossary, length, …). */
+    qa: Array<{
+        key: string;
+        warnings: string[];
+    }>;
+    /**
+     * Keys whose value is identical to the source text. The engine already
+     * rejects untranslated output, so this is only a review hint (brand names,
+     * "OK", or a cached value from before that check existed).
+     */
+    sameAsSource: string[];
+}
+/**
+ * Everything a run produced. Structured so a per-key QA report (#237) can be
+ * rendered from it without re-running anything.
+ */
+export interface LocalTranslateReport {
+    framework: string;
+    frameworkStatus: FrameworkStatus;
+    provider?: {
+        provider: ByokProvider;
+        name: string;
+        model: string;
+    };
+    sourceLocale: string;
+    /** Locales translated in this run: `--to` plus earlier locales (unless replace). */
+    targetLocales: string[];
+    /** Earlier locales that were kept and updated although not in `--to`. */
+    keptLocales: string[];
+    /** Earlier locales removed by `--replace` (files and lockfile entries). */
+    droppedLocales: string[];
+    /**
+     * Source keys with no t() reference found by a heuristic scan. Advisory
+     * only: they are still translated, kept and written like any other key.
+     */
+    unusedKeys: string[];
+    /** Strings extracted (and translated) but not wired into the code. */
+    notInjected: Array<{
+        file: string;
+        key: string;
+        text: string;
+        reason: string;
+    }>;
+    /** Files whose non-literal t() keys made every key count as used. */
+    dynamicKeyFiles: string[];
+    dryRun: boolean;
+    /** True when changes were written to the project. */
+    applied: boolean;
+    changes: WorkspaceChanges;
+    /** Unified diff of `changes` (always computed for --dry-run). */
+    diff?: string;
+    stats: {
+        filesScanned: number;
+        stringsExtracted: number;
+        keysExtracted: number;
+        injectionsApplied: number;
+        keysFromLockfile: number;
+        keysSentToTranslator: number;
+        /** (key, locale) translations produced by the translator this run (billable). */
+        translatedThisRun?: number;
+    };
+    locales: LocaleReport[];
+    /** Every key that failed, across locales. Non-empty means the run is partial. */
+    translationFailures: TranslationFailure[];
+    warnings: Array<{
+        type: string;
+        file: string;
+        line?: number;
+        message: string;
+    }>;
+    /** Finalization notes (dependencies added, config created, …). */
+    notes: string[];
+    /** The project's prettier/biome run on changed files, if it has one. */
+    formatter?: FormatResult;
+    /** Warnings/errors the engine logged while running. */
+    engineLog: Array<{
+        level: 'warn' | 'error';
+        message: string;
+    }>;
+    lockfile: string;
+    /**
+     * True when the lockfile is gitignored (`babelize init` adds `.babelize/`):
+     * it still works locally, but teammates and CI won't get it.
+     */
+    lockfileIgnored: boolean;
+    /** Per-key engine metadata (confidence, TM/lockfile origin) by locale. */
+    metadata: Record<string, Record<string, unknown>>;
+    /** source key → source text, and locale → key → translated text. */
+    results: {
+        source: Record<string, string>;
+        targets: Record<string, Record<string, string>>;
+    };
+    durationMs: number;
+}
+/** Normalise `--to fr,de , ja` into a deduped list without the source locale. */
+export declare function parseLocales(raw: string | string[] | undefined, sourceLocale: string): string[];
+export declare function validateLocales(sourceLocale: string, targetLocales: string[]): void;
+/**
+ * Engine log lines that are wrong or redundant for a local run: the
+ * TRANSLATOR_URL check doesn't know about BYOK/injected providers, and the
+ * "run your install" hint is already a finalization note in the summary.
+ */
+/** `msg` as one sentence: trailing dots/spaces trimmed, exactly one period added. */
+export declare function sentence(msg: string): string;
+export declare function isEngineLogNoise(message: string): boolean;
+export declare function buildLocaleReports(targetLocales: string[], source: Record<string, string>, targets: Record<string, Record<string, string>>, failures?: TranslationFailure[], metadata?: Record<string, Record<string, unknown>>): LocaleReport[];
+/**
+ * Run the Babelize engine on a temp copy of `projectDir` and, unless
+ * `dryRun`, apply the result back to the working tree. The project is never
+ * touched until the engine has finished successfully and every target locale
+ * has translations.
+ */
+export declare function runLocalTranslate(opts: LocalTranslateOptions, deps?: LocalTranslateDeps): Promise<LocalTranslateReport>;
+//# sourceMappingURL=translate-core.d.ts.map

package/dist/local/translate-core.d.ts.map

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