@babelize/engine 0.2.1 → 0.3.1

package/dist/detection/i18n.d.ts

@@ -0,0 +1,19 @@
+import type { RepoFiles } from './stack';
+export type I18nLibraryId = 'next-intl' | 'next-i18next' | 'react-i18next' | 'i18next' | 'vue-i18n' | 'react-intl' | 'lingui' | 'django';
+export declare const I18N_LIBRARY_NAMES: Record<I18nLibraryId, string>;
+export type SourceLanguageBasis = 'config' | 'files' | 'default';
+export interface DetectedI18n {
+    library: {
+        id: I18nLibraryId;
+        name: string;
+    } | null;
+    /** Locale codes the repo already has files for, as written (en, pt-BR, zh_Hant). */
+    locales: string[];
+    /** Where the locale files live, e.g. "messages" or "public/locales". */
+    localeDir: string | null;
+    sourceLanguage: {
+        code: string;
+        basis: SourceLanguageBasis;
+    };
+}
+export declare function detectI18n(files: RepoFiles, framework?: string): Promise<DetectedI18n>;

package/dist/detection/i18n.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.I18N_LIBRARY_NAMES = void 0;
+exports.detectI18n = detectI18n;
+/**
+ * What a repository already has for i18n, read from a file listing and a few
+ * small files (no clone): the i18n library, existing locale files, and the
+ * source language. Runs on the same `RepoFiles` as `detectStack`, so the
+ * new-project flow can say "Next.js · English · next-intl detected" and
+ * pre-select the languages the repo already ships.
+ */
+const locale_files_1 = require("../qa/locale-files");
+exports.I18N_LIBRARY_NAMES = {
+    'next-intl': 'next-intl',
+    'next-i18next': 'next-i18next',
+    'react-i18next': 'react-i18next',
+    i18next: 'i18next',
+    'vue-i18n': 'vue-i18n',
+    'react-intl': 'react-intl',
+    lingui: 'Lingui',
+    django: 'Django i18n',
+};
+/** Most specific first: next-i18next depends on react-i18next, which depends on i18next. */
+const LIBRARY_DEPS = [
+    ['next-intl', ['next-intl']],
+    ['next-i18next', ['next-i18next']],
+    ['vue-i18n', ['vue-i18n', '@nuxtjs/i18n']],
+    ['react-i18next', ['react-i18next']],
+    ['react-intl', ['react-intl']],
+    ['lingui', ['@lingui/core', '@lingui/react']],
+    ['i18next', ['i18next']],
+];
+const IGNORED = /(?:^|\/)(?:node_modules|\.git|vendor|dist|build|\.next|out|coverage|__tests__|__fixtures__|fixtures|tests?|e2e)\//;
+/** Files that commonly declare the default locale, checked in this order. */
+const CONFIG_FILE = /(?:^|\/)(?:i18n(?:\/(?:routing|request|config|index))?|i18n\.config|next\.config|next-i18next\.config|nuxt\.config|src\/i18n(?:\/index)?|src\/plugins\/i18n|lingui\.config)\.(?:[cm]?[jt]s|json)$/;
+/** defaultLocale: 'de', fallbackLng: "fr", sourceLocale: 'en', locale: 'en' (vue-i18n createI18n). */
+const DEFAULT_LOCALE_PATTERNS = [
+    /\bdefaultLocale\s*[:=]\s*['"`]([A-Za-z_-]{2,12})['"`]/,
+    /\bsourceLocale\s*[:=]\s*['"`]([A-Za-z_-]{2,12})['"`]/,
+    /\bfallbackLng\s*[:=]\s*['"`]([A-Za-z_-]{2,12})['"`]/,
+    /\bfallbackLocale\s*[:=]\s*['"`]([A-Za-z_-]{2,12})['"`]/,
+];
+const DJANGO_LANGUAGE_CODE = /^\s*LANGUAGE_CODE\s*=\s*['"]([A-Za-z_-]{2,12})['"]/m;
+/** Django: locale/<code>/LC_MESSAGES/django.po */
+const DJANGO_PO = /(?:^|\/)locale\/([A-Za-z_-]{2,12})\/LC_MESSAGES\/django\.po$/;
+function depth(p) {
+    return p.split('/').length - 1;
+}
+async function readDeps(files, paths) {
+    const pkgs = paths
+        .filter((p) => (p === 'package.json' || p.endsWith('/package.json')) && depth(p) <= 2)
+        .sort((a, b) => depth(a) - depth(b))
+        .slice(0, 6);
+    const deps = new Set();
+    for (const p of pkgs) {
+        const raw = await files.read(p);
+        if (!raw)
+            continue;
+        try {
+            const pkg = JSON.parse(raw);
+            for (const name of Object.keys({ ...pkg.dependencies, ...pkg.devDependencies }))
+                deps.add(name);
+        }
+        catch {
+            // not JSON: skip
+        }
+    }
+    return deps;
+}
+/** "en-us" (Django) → "en-US"; "pt_BR" stays as written. */
+function tidyCode(code) {
+    const m = /^([a-z]{2,3})-([a-z]{2})$/.exec(code);
+    return m ? `${m[1]}-${m[2].toUpperCase()}` : code;
+}
+async function detectI18n(files, framework) {
+    const paths = files.paths.filter((p) => !IGNORED.test(p));
+    // Library
+    let library = null;
+    if (framework === 'django') {
+        library = { id: 'django', name: exports.I18N_LIBRARY_NAMES.django };
+    }
+    else {
+        const deps = await readDeps(files, paths);
+        const found = LIBRARY_DEPS.find(([, names]) => names.some((n) => deps.has(n)));
+        if (found)
+            library = { id: found[0], name: exports.I18N_LIBRARY_NAMES[found[0]] };
+    }
+    // Existing locale files: the set with the most locales wins.
+    let locales = [];
+    let localeDir = null;
+    let largestByLocale = new Map();
+    const sets = (0, locale_files_1.groupLocaleFiles)(paths);
+    if (sets.length > 0) {
+        const best = sets.reduce((a, b) => (Object.keys(b.files).length > Object.keys(a.files).length ? b : a));
+        locales = Object.keys(best.files).sort();
+        localeDir = best.dir;
+        if (files.size) {
+            largestByLocale = new Map(locales.map((l) => [l, best.files[l].reduce((sum, f) => sum + (files.size(f) ?? 0), 0)]));
+        }
+    }
+    else {
+        const po = paths.map((p) => DJANGO_PO.exec(p)).filter((m) => !!m);
+        if (po.length > 0) {
+            locales = [...new Set(po.map((m) => m[1]))].sort();
+            localeDir = po[0][0].split('/').slice(0, -3).join('/') || '.';
+        }
+    }
+    // Source language: declared in config, else inferred from the locale files.
+    let sourceLanguage = { code: 'en', basis: 'default' };
+    const configCandidates = paths
+        .filter((p) => CONFIG_FILE.test(p) && depth(p) <= 3)
+        .sort((a, b) => depth(a) - depth(b))
+        .slice(0, 6);
+    if (framework === 'django') {
+        configCandidates.unshift(...paths.filter((p) => /(?:^|\/)settings(?:\/base)?\.py$/.test(p) && depth(p) <= 3).slice(0, 2));
+    }
+    for (const p of configCandidates) {
+        const content = await files.read(p);
+        if (!content)
+            continue;
+        const m = p.endsWith('.py')
+            ? DJANGO_LANGUAGE_CODE.exec(content)
+            : DEFAULT_LOCALE_PATTERNS.map((re) => re.exec(content)).find(Boolean);
+        const code = m?.[1] ? tidyCode(m[1]) : null;
+        if (code && (0, locale_files_1.isLocaleCode)(code)) {
+            sourceLanguage = { code, basis: 'config' };
+            break;
+        }
+    }
+    if (sourceLanguage.basis === 'default' && locales.length > 0) {
+        if (locales.length === 1) {
+            sourceLanguage = { code: locales[0], basis: 'files' };
+        }
+        else if (locales.some((l) => l === 'en' || l.startsWith('en-') || l.startsWith('en_'))) {
+            sourceLanguage = { code: locales.find((l) => l === 'en') ?? locales.find((l) => l.startsWith('en')), basis: 'files' };
+        }
+        else if (largestByLocale.size > 0) {
+            // The source usually has every key: the biggest file set.
+            const [code] = [...largestByLocale.entries()].reduce((a, b) => (b[1] > a[1] ? b : a));
+            sourceLanguage = { code, basis: 'files' };
+        }
+    }
+    return { library, locales, localeDir, sourceLanguage };
+}

package/dist/detection/stack.d.ts

@@ -32,6 +32,8 @@ export interface RepoFiles {
     read(relPath: string): Promise<string | null>;
     /** The listing is incomplete (very large repository). */
     truncated?: boolean;
+    /** File size in bytes, when the listing knows it. */
+    size?(relPath: string): number | undefined;
 }
 export declare const FRAMEWORK_DISPLAY_NAMES: Record<string, string>;
 /** Does a Python dependency file list Django itself (not just django-* add-ons)? */

package/dist/index.d.ts

@@ -18,6 +18,7 @@ export * from './providers';
 export { runWithEngineLogger, setEngineLogger } from './utils/logger';
 export type { EngineLogger, LogContext } from './utils/logger';
 export * from './modules/lockfile';
+export { applyTranslationOverrides, setLocaleValue, type OverrideReport, type TranslationOverride } from './modules/overrides';
 export * from './modules/translator/language-codes';
 export type { MemoryEntry, FuzzyMatch, MemoryLookupResult } from './modules/translator/memory/types';
 export { matchFromMemory } from './modules/translator/memory/memory-matcher';
@@ -26,8 +27,10 @@ export type { SyncDetectionResult, SyncDetectedString, SyncMissingLocaleKey } fr
 export type { TranslationEntry, WorkspaceInfo } from './runtime/types';
 export { addBabelToHistory, detectProjectInfo, getBabelizeSummary, getProjectInfo, saveCachedStrings, saveProjectConfig, } from './utils/metadata';
 export type { BabelHistoryEntry, ExtractedStringEntry, ProjectInfo } from './utils/metadata';
-export { detectStack, localRepoFiles, FRAMEWORK_DISPLAY_NAMES } from './detection/stack';
+export { detectStack, localRepoFiles, FRAMEWORK_DISPLAY_NAMES, SUPPORTED_SUMMARY } from './detection/stack';
 export type { DetectedStack, RepoFiles, StackFramework, PackageManagerId } from './detection/stack';
+export { detectI18n, I18N_LIBRARY_NAMES } from './detection/i18n';
+export type { DetectedI18n, I18nLibraryId, SourceLanguageBasis } from './detection/i18n';
 export { parseCode } from './utils/ast-helpers';
 export { extractPlaceholders, hasICUSyntax, hashString, protectPlaceholders, restorePlaceholders, } from './utils/string-utils';
 export { sanitizeTranslation, validateRawTokens } from './utils/translation-sanitizer';

package/dist/index.js

@@ -21,8 +21,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.analyzeWorkspace = exports.analyzeProject = exports.localeExtension = exports.getCircuitBreaker = exports.CircuitState = exports.CircuitBreaker = exports.validateBatchQuality = exports.validateTranslationQuality = exports.translatorLoadBalancer = exports.warmupTranslator = exports.checkTranslatorHealth = exports.callTranslator = exports.requiredPluralCategories = exports.parseIcu = exports.isIcuMessage = exports.compareIcuMessages = exports.sameProtectedSpans = exports.restoreText = exports.protectText = exports.hasNothingToTranslate = exports.checkTokens = exports.validateRawTokens = exports.sanitizeTranslation = exports.restorePlaceholders = exports.protectPlaceholders = exports.hashString = exports.hasICUSyntax = exports.extractPlaceholders = exports.parseCode = exports.FRAMEWORK_DISPLAY_NAMES = exports.localRepoFiles = exports.detectStack = exports.saveProjectConfig = exports.saveCachedStrings = exports.getProjectInfo = exports.getBabelizeSummary = exports.detectProjectInfo = exports.addBabelToHistory = exports.formatSyncNotificationMessage = exports.detectSyncIssues = exports.matchFromMemory = exports.setEngineLogger = exports.runWithEngineLogger = exports.validateWorkspace = exports.scanKeyReferences = exports.RunAbortedError = exports.validateEngineConfigV2 = exports.runEngineV2 = exports.loadBabelizeConfig = exports.BabelizeEngine = void 0;
-exports.TRANSLATION_CACHE_TTL_SECONDS = exports.translationCacheKey = exports.hashText = exports.readProjectLocaleConfig = exports.localeIssueFile = exports.checkProjectLocales = exports.ReviewError = exports.reviewLocaleChanges = exports.loadLocale = exports.isLocaleCode = exports.isIgnoredLocalePath = exports.groupLocaleFiles = exports.findLocaleFileSets = exports.DEFAULT_LOCALE_IGNORE_DIRS = exports.glossaryFingerprint = exports.normalizeGlossary = exports.localeValue = exports.containsTerm = exports.canonicalizeLocaleKeys = exports.canonicalLocale = exports.tallyLocaleIssues = exports.flattenLocaleMessages = exports.checkLocalePair = exports.frameworkSupport = void 0;
+exports.CircuitBreaker = exports.validateBatchQuality = exports.validateTranslationQuality = exports.translatorLoadBalancer = exports.warmupTranslator = exports.checkTranslatorHealth = exports.callTranslator = exports.requiredPluralCategories = exports.parseIcu = exports.isIcuMessage = exports.compareIcuMessages = exports.sameProtectedSpans = exports.restoreText = exports.protectText = exports.hasNothingToTranslate = exports.checkTokens = exports.validateRawTokens = exports.sanitizeTranslation = exports.restorePlaceholders = exports.protectPlaceholders = exports.hashString = exports.hasICUSyntax = exports.extractPlaceholders = exports.parseCode = exports.I18N_LIBRARY_NAMES = exports.detectI18n = exports.SUPPORTED_SUMMARY = exports.FRAMEWORK_DISPLAY_NAMES = exports.localRepoFiles = exports.detectStack = exports.saveProjectConfig = exports.saveCachedStrings = exports.getProjectInfo = exports.getBabelizeSummary = exports.detectProjectInfo = exports.addBabelToHistory = exports.formatSyncNotificationMessage = exports.detectSyncIssues = exports.matchFromMemory = exports.setLocaleValue = exports.applyTranslationOverrides = exports.setEngineLogger = exports.runWithEngineLogger = exports.validateWorkspace = exports.scanKeyReferences = exports.RunAbortedError = exports.validateEngineConfigV2 = exports.runEngineV2 = exports.loadBabelizeConfig = exports.BabelizeEngine = void 0;
+exports.TRANSLATION_CACHE_TTL_SECONDS = exports.translationCacheKey = exports.hashText = exports.readProjectLocaleConfig = exports.localeIssueFile = exports.checkProjectLocales = exports.ReviewError = exports.reviewLocaleChanges = exports.loadLocale = exports.isLocaleCode = exports.isIgnoredLocalePath = exports.groupLocaleFiles = exports.findLocaleFileSets = exports.DEFAULT_LOCALE_IGNORE_DIRS = exports.glossaryFingerprint = exports.normalizeGlossary = exports.localeValue = exports.containsTerm = exports.canonicalizeLocaleKeys = exports.canonicalLocale = exports.tallyLocaleIssues = exports.flattenLocaleMessages = exports.checkLocalePair = exports.frameworkSupport = exports.analyzeWorkspace = exports.analyzeProject = exports.localeExtension = exports.getCircuitBreaker = exports.CircuitState = void 0;
 var BabelizeEngine_1 = require("./BabelizeEngine");
 Object.defineProperty(exports, "BabelizeEngine", { enumerable: true, get: function () { return BabelizeEngine_1.BabelizeEngine; } });
 var config_1 = require("./config");
@@ -46,6 +46,9 @@ Object.defineProperty(exports, "runWithEngineLogger", { enumerable: true, get: f
 Object.defineProperty(exports, "setEngineLogger", { enumerable: true, get: function () { return logger_1.setEngineLogger; } });
 // ── Pipeline pieces the backend uses directly ────────────────
 __exportStar(require("./modules/lockfile"), exports);
+var overrides_1 = require("./modules/overrides");
+Object.defineProperty(exports, "applyTranslationOverrides", { enumerable: true, get: function () { return overrides_1.applyTranslationOverrides; } });
+Object.defineProperty(exports, "setLocaleValue", { enumerable: true, get: function () { return overrides_1.setLocaleValue; } });
 __exportStar(require("./modules/translator/language-codes"), exports);
 var memory_matcher_1 = require("./modules/translator/memory/memory-matcher");
 Object.defineProperty(exports, "matchFromMemory", { enumerable: true, get: function () { return memory_matcher_1.matchFromMemory; } });
@@ -64,6 +67,10 @@ var stack_1 = require("./detection/stack");
 Object.defineProperty(exports, "detectStack", { enumerable: true, get: function () { return stack_1.detectStack; } });
 Object.defineProperty(exports, "localRepoFiles", { enumerable: true, get: function () { return stack_1.localRepoFiles; } });
 Object.defineProperty(exports, "FRAMEWORK_DISPLAY_NAMES", { enumerable: true, get: function () { return stack_1.FRAMEWORK_DISPLAY_NAMES; } });
+Object.defineProperty(exports, "SUPPORTED_SUMMARY", { enumerable: true, get: function () { return stack_1.SUPPORTED_SUMMARY; } });
+var i18n_1 = require("./detection/i18n");
+Object.defineProperty(exports, "detectI18n", { enumerable: true, get: function () { return i18n_1.detectI18n; } });
+Object.defineProperty(exports, "I18N_LIBRARY_NAMES", { enumerable: true, get: function () { return i18n_1.I18N_LIBRARY_NAMES; } });
 var ast_helpers_1 = require("./utils/ast-helpers");
 Object.defineProperty(exports, "parseCode", { enumerable: true, get: function () { return ast_helpers_1.parseCode; } });
 var string_utils_1 = require("./utils/string-utils");

package/dist/local/hosted-provider.d.ts

@@ -2,7 +2,8 @@ import type { KeyResult, TranslationBatchRequest, TranslationProvider } from '..
 /**
  * Babelize-hosted translation for `babelize translate`: a TranslationProvider
  * that sends the engine's already placeholder-protected strings (never code)
- * to POST {apiUrl}/v1/translate/batch with a Babelize API key. The engine
+ * to POST {apiUrl}/v1/translate/batch with a Babelize API key or a signed-in
+ * CLI session (the endpoint accepts both and bills the same account). The engine
  * still validates every result and runs its repair retry locally; model,
  * quota and credits are decided by the server.
  */
@@ -15,6 +16,8 @@ export declare const HOSTED_MAX_BATCH: 100;
 export declare const HOSTED_REQUEST_TIMEOUT_MS = 150000;
 /** Response header naming the model that served a batch. */
 export declare const HOSTED_MODEL_HEADER = "x-babelize-model";
+/** Whole credits the server charged for one batch. */
+export declare const HOSTED_CREDITS_HEADER = "x-credits-charged";
 export declare const API_KEYS_URL = "https://app.babelize.co/api-keys";
 export declare const BILLING_URL = "https://app.babelize.co/billing";
 export type HostedErrorCode = 
@@ -36,8 +39,19 @@ export declare class HostedTranslationError extends Error {
     get fatal(): boolean;
 }
 export interface HostedProviderOptions {
-    /** Babelize API key (bblz_sk_…). Never printed. */
+    /** Babelize API key (bblz_sk_…) or a session access token. Never printed. */
     apiKey: string;
+    /**
+     * What `apiKey` is, for the message when it's rejected: an API key from
+     * BABELIZE_API_KEY (default) or the CLI's signed-in session.
+     */
+    credential?: 'api_key' | 'session';
+    /**
+     * Called once when a request is rejected with 401: return a fresh token
+     * (a session refresh) to retry with it, or null to give up. Sessions expire
+     * during long runs; API keys don't, so API-key callers leave this out.
+     */
+    refreshToken?: () => Promise<string | null>;
     /** e.g. https://api.babelize.co/api */
     apiUrl: string;
     fetch?: typeof fetch;
@@ -57,10 +71,28 @@ export declare function parseRetryAfterMs(value: string | null): number | undefi
 export declare class HostedTranslationProvider implements TranslationProvider {
     /** Model the server reported (X-Babelize-Model), once a request succeeded. */
     model?: string;
+    /**
+     * True when the server translates with NLLB rather than an LLM: the engine
+     * then splits ICU messages and multi-line text and protects glossary terms
+     * before sending, as it does for cloud runs. Set by detectCapabilities().
+     */
+    plainText: boolean;
+    /** Credits charged so far by this provider's batches (X-Credits-Charged). */
+    creditsCharged: number;
     /** Set once a request fails in a way no retry can fix (bad key, no credits). */
     fatalError?: HostedTranslationError;
     private readonly opts;
+    /** The token in use; replaced when a session is refreshed. */
+    private token;
+    /** In-flight refresh, shared by concurrent batches that all got a 401. */
+    private refreshing?;
     constructor(options: HostedProviderOptions);
+    /**
+     * Ask the server what serves translation (GET /v1/translate/capabilities)
+     * before a run, so requests are shaped for it. A server without the endpoint
+     * (older) or any failure keeps the LLM shape; the run itself reports errors.
+     */
+    detectCapabilities(): Promise<void>;
     translateBatch(request: TranslationBatchRequest): Promise<KeyResult[]>;
     private post;
     private backoff;

package/dist/local/hosted-provider.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HostedTranslationProvider = exports.HostedTranslationError = exports.BILLING_URL = exports.API_KEYS_URL = exports.HOSTED_MODEL_HEADER = exports.HOSTED_REQUEST_TIMEOUT_MS = exports.HOSTED_MAX_BATCH = void 0;
+exports.HostedTranslationProvider = exports.HostedTranslationError = exports.BILLING_URL = exports.API_KEYS_URL = exports.HOSTED_CREDITS_HEADER = exports.HOSTED_MODEL_HEADER = exports.HOSTED_REQUEST_TIMEOUT_MS = exports.HOSTED_MAX_BATCH = void 0;
 exports.parseRetryAfterMs = parseRetryAfterMs;
 const node_crypto_1 = require("node:crypto");
 const language_codes_1 = require("../modules/translator/language-codes");
@@ -8,7 +8,8 @@ const types_1 = require("@babelize/types");
 /**
  * Babelize-hosted translation for `babelize translate`: a TranslationProvider
  * that sends the engine's already placeholder-protected strings (never code)
- * to POST {apiUrl}/v1/translate/batch with a Babelize API key. The engine
+ * to POST {apiUrl}/v1/translate/batch with a Babelize API key or a signed-in
+ * CLI session (the endpoint accepts both and bills the same account). The engine
  * still validates every result and runs its repair retry locally; model,
  * quota and credits are decided by the server.
  */
@@ -21,6 +22,8 @@ exports.HOSTED_MAX_BATCH = types_1.TRANSLATE_BATCH_LIMITS.maxEntries;
 exports.HOSTED_REQUEST_TIMEOUT_MS = 150000;
 /** Response header naming the model that served a batch. */
 exports.HOSTED_MODEL_HEADER = 'x-babelize-model';
+/** Whole credits the server charged for one batch. */
+exports.HOSTED_CREDITS_HEADER = 'x-credits-charged';
 exports.API_KEYS_URL = 'https://app.babelize.co/api-keys';
 exports.BILLING_URL = 'https://app.babelize.co/billing';
 class HostedTranslationError extends Error {
@@ -48,6 +51,15 @@ function parseRetryAfterMs(value) {
 }
 class HostedTranslationProvider {
     constructor(options) {
+        /**
+         * True when the server translates with NLLB rather than an LLM: the engine
+         * then splits ICU messages and multi-line text and protects glossary terms
+         * before sending, as it does for cloud runs. Set by detectCapabilities().
+         */
+        this.plainText = false;
+        /** Credits charged so far by this provider's batches (X-Credits-Charged). */
+        this.creditsCharged = 0;
+        this.token = options.apiKey;
         this.opts = {
             fetch: globalThis.fetch.bind(globalThis),
             maxRetries: 3,
@@ -59,6 +71,31 @@ class HostedTranslationProvider {
             apiUrl: options.apiUrl.replace(/\/+$/, ''),
         };
     }
+    /**
+     * Ask the server what serves translation (GET /v1/translate/capabilities)
+     * before a run, so requests are shaped for it. A server without the endpoint
+     * (older) or any failure keeps the LLM shape; the run itself reports errors.
+     */
+    async detectCapabilities() {
+        try {
+            const res = await this.opts.fetch(`${this.opts.apiUrl}/v1/translate/capabilities`, {
+                headers: {
+                    Authorization: `Bearer ${this.token}`,
+                    ...(this.opts.userAgent ? { 'User-Agent': this.opts.userAgent } : {}),
+                },
+                signal: AbortSignal.timeout(15000),
+            });
+            if (!res.ok)
+                return;
+            const body = (await res.json());
+            this.plainText = body.plainText === true;
+            if (body.model)
+                this.model ?? (this.model = body.model);
+        }
+        catch {
+            // keep the defaults
+        }
+    }
     async translateBatch(request) {
         // Strings over the server's limits never leave the machine: they fail
         // locally, and the rest of the batch is still sent.
@@ -122,6 +159,7 @@ class HostedTranslationProvider {
         // replays it instead of translating and charging again.
         const idempotencyKey = (0, node_crypto_1.randomUUID)();
         let attempt = 0;
+        let refreshed = false;
         for (;;) {
             let res;
             try {
@@ -129,7 +167,7 @@ class HostedTranslationProvider {
                     method: 'POST',
                     headers: {
                         'Content-Type': 'application/json',
-                        Authorization: `Bearer ${this.opts.apiKey}`,
+                        Authorization: `Bearer ${this.token}`,
                         'Idempotency-Key': idempotencyKey,
                         ...(this.opts.userAgent ? { 'User-Agent': this.opts.userAgent } : {}),
                     },
@@ -160,8 +198,22 @@ class HostedTranslationProvider {
                     throw new HostedTranslationError(`Lost the response from Babelize at ${this.opts.apiUrl} (${err.message}).`, 'hosted_unavailable');
                 }
                 this.model = res.headers.get(exports.HOSTED_MODEL_HEADER) ?? this.model;
+                const charged = Number(res.headers.get(exports.HOSTED_CREDITS_HEADER));
+                if (Number.isFinite(charged) && charged > 0)
+                    this.creditsCharged += charged;
                 return Array.isArray(data.results) ? data.results : [];
             }
+            // An expired session: refresh it once and try again with the same key.
+            if (res.status === 401 && this.opts.refreshToken && !refreshed) {
+                refreshed = true;
+                const sent = this.token;
+                this.refreshing ?? (this.refreshing = this.opts.refreshToken().finally(() => { this.refreshing = undefined; }));
+                const fresh = this.token !== sent ? this.token : await this.refreshing;
+                if (fresh) {
+                    this.token = fresh;
+                    continue;
+                }
+            }
             if (RETRYABLE_STATUS.has(res.status) && attempt < this.opts.maxRetries && !(await isHostedOff(res))) {
                 const retryAfter = parseRetryAfterMs(res.headers.get('retry-after'));
                 await this.opts.sleep(Math.min(retryAfter ?? this.backoff(attempt), this.opts.maxRetryAfterMs));
@@ -183,7 +235,9 @@ class HostedTranslationProvider {
         switch (res.status) {
             case 401:
             case 403:
-                return new HostedTranslationError(`BABELIZE_API_KEY was rejected (${res.status}). Create a new key at ${exports.API_KEYS_URL} and set BABELIZE_API_KEY.`, 'hosted_auth', res.status);
+                return new HostedTranslationError(this.opts.credential === 'session'
+                    ? `Your Babelize sign-in was rejected (${res.status}). Sign in again with \`babelize auth login\`, then re-run.`
+                    : `BABELIZE_API_KEY was rejected (${res.status}). Create a new key at ${exports.API_KEYS_URL} and set BABELIZE_API_KEY.`, 'hosted_auth', res.status);
             case 402:
                 return new HostedTranslationError(payload?.message ??
                     `Your Babelize account is out of AI credits. Top up or upgrade at ${exports.BILLING_URL}, or use your own LLM key (e.g. set ANTHROPIC_API_KEY).`, 'hosted_credits', 402);

package/dist/local/report.d.ts

@@ -62,6 +62,8 @@ export interface TranslateReport {
         name: string;
         model?: string;
     } | null;
+    /** Babelize credits the run was charged (hosted runs only). */
+    creditsCharged?: number;
     sourceLocale: string;
     targetLocales: string[];
     keptLocales: string[];

package/dist/local/report.js

@@ -107,6 +107,7 @@ function buildTranslateReport(r) {
         framework: r.framework,
         frameworkStatus: r.frameworkStatus,
         provider: r.provider ? { provider: r.provider.provider, name: r.provider.name, ...(r.provider.model ? { model: r.provider.model } : {}) } : null,
+        ...(r.creditsCharged !== undefined ? { creditsCharged: r.creditsCharged } : {}),
         sourceLocale: r.sourceLocale,
         targetLocales: r.targetLocales,
         keptLocales: r.keptLocales,

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

@@ -123,6 +123,8 @@ export interface LocalTranslateReport {
         name: string;
         model?: string;
     };
+    /** Babelize credits this run was charged; set for hosted runs only. */
+    creditsCharged?: number;
     sourceLocale: string;
     /** Locales translated in this run: `--to` plus earlier locales (unless replace). */
     targetLocales: string[];

package/dist/local/translate-core.js

@@ -283,6 +283,10 @@ async function runScoped(opts, deps, engineLog, state) {
     if (!opts.byok && !translator) {
         throw new LocalTranslateError('No translation provider configured.', 'no_translator');
     }
+    // Shape requests for what the server translates with (NLLB needs ICU and
+    // multi-line text split and glossary terms protected; an LLM doesn't).
+    if (deps.hosted)
+        await deps.hosted.detectCapabilities();
     const files = await listProjectFiles(projectDir);
     const temp = await (0, workspace_copy_1.createTempCopy)(projectDir, { files, tmpRoot: deps.tmpRoot });
     try {
@@ -458,6 +462,7 @@ async function runScoped(opts, deps, engineLog, state) {
             framework,
             frameworkStatus,
             provider,
+            ...(deps.hosted ? { creditsCharged: deps.hosted.creditsCharged } : {}),
             sourceLocale: opts.sourceLocale,
             targetLocales,
             keptLocales,

package/dist/modules/lockfile/index.d.ts

@@ -1,3 +1,3 @@
 export { hashSourceString } from './hasher';
 export { type LockfileData, type LockfileEntry, type LockfilePartition, type LockfileStats, type PartitionedKey, createEmptyLockfile, } from './schema';
-export { buildKeysToTranslateByTargetLocale, clearLockfile, removeLocaleFromLockfile, collectCachedTranslations, computeLockfileStats, getLockfilePath, loadLockfile, partitionKeys, saveLockfile, updateLockfile, lockfileChanged, dropFailedTranslations, isStalePseudoEntry, glossaryChanged, type LockfileReadOptions, } from './lockfile-manager';
+export { buildKeysToTranslateByTargetLocale, clearLockfile, removeLocaleFromLockfile, removeLockfileEntries, collectCachedTranslations, computeLockfileStats, getLockfilePath, loadLockfile, partitionKeys, saveLockfile, updateLockfile, lockfileChanged, dropFailedTranslations, isStalePseudoEntry, glossaryChanged, type LockfileReadOptions, } from './lockfile-manager';

package/dist/modules/lockfile/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.glossaryChanged = exports.isStalePseudoEntry = exports.dropFailedTranslations = exports.lockfileChanged = exports.updateLockfile = exports.saveLockfile = exports.partitionKeys = exports.loadLockfile = exports.getLockfilePath = exports.computeLockfileStats = exports.collectCachedTranslations = exports.removeLocaleFromLockfile = exports.clearLockfile = exports.buildKeysToTranslateByTargetLocale = exports.createEmptyLockfile = exports.hashSourceString = void 0;
+exports.glossaryChanged = exports.isStalePseudoEntry = exports.dropFailedTranslations = exports.lockfileChanged = exports.updateLockfile = exports.saveLockfile = exports.partitionKeys = exports.loadLockfile = exports.getLockfilePath = exports.computeLockfileStats = exports.collectCachedTranslations = exports.removeLockfileEntries = exports.removeLocaleFromLockfile = exports.clearLockfile = exports.buildKeysToTranslateByTargetLocale = exports.createEmptyLockfile = exports.hashSourceString = void 0;
 var hasher_1 = require("./hasher");
 Object.defineProperty(exports, "hashSourceString", { enumerable: true, get: function () { return hasher_1.hashSourceString; } });
 var schema_1 = require("./schema");
@@ -9,6 +9,7 @@ var lockfile_manager_1 = require("./lockfile-manager");
 Object.defineProperty(exports, "buildKeysToTranslateByTargetLocale", { enumerable: true, get: function () { return lockfile_manager_1.buildKeysToTranslateByTargetLocale; } });
 Object.defineProperty(exports, "clearLockfile", { enumerable: true, get: function () { return lockfile_manager_1.clearLockfile; } });
 Object.defineProperty(exports, "removeLocaleFromLockfile", { enumerable: true, get: function () { return lockfile_manager_1.removeLocaleFromLockfile; } });
+Object.defineProperty(exports, "removeLockfileEntries", { enumerable: true, get: function () { return lockfile_manager_1.removeLockfileEntries; } });
 Object.defineProperty(exports, "collectCachedTranslations", { enumerable: true, get: function () { return lockfile_manager_1.collectCachedTranslations; } });
 Object.defineProperty(exports, "computeLockfileStats", { enumerable: true, get: function () { return lockfile_manager_1.computeLockfileStats; } });
 Object.defineProperty(exports, "getLockfilePath", { enumerable: true, get: function () { return lockfile_manager_1.getLockfilePath; } });

package/dist/modules/lockfile/lockfile-manager.d.ts

@@ -32,6 +32,15 @@ export declare function clearLockfile(projectId: string, dataDir?: string): Prom
  * Used when a language is removed from a project so re-adding it
  * triggers fresh translation instead of resurrecting stale cache.
  */
+/**
+ * Forget the stored translation of some (key, locale) pairs, so the next run
+ * translates them again (a dashboard edit that was reverted). Other locales
+ * of the key stay.
+ */
+export declare function removeLockfileEntries(projectId: string, entries: Array<{
+    key: string;
+    locale: string;
+}>, dataDir?: string): Promise<number>;
 export declare function removeLocaleFromLockfile(projectId: string, localeCode: string, dataDir?: string): Promise<void>;
 /**
  * Partition generated keys into unchanged / new / changed / missingLocales

package/dist/modules/lockfile/lockfile-manager.js

@@ -38,6 +38,7 @@ exports.getLockfilePath = getLockfilePath;
 exports.loadLockfile = loadLockfile;
 exports.saveLockfile = saveLockfile;
 exports.clearLockfile = clearLockfile;
+exports.removeLockfileEntries = removeLockfileEntries;
 exports.removeLocaleFromLockfile = removeLocaleFromLockfile;
 exports.glossaryChanged = glossaryChanged;
 exports.isStalePseudoEntry = isStalePseudoEntry;
@@ -242,6 +243,44 @@ async function clearLockfile(projectId, dataDir) {
  * Used when a language is removed from a project so re-adding it
  * triggers fresh translation instead of resurrecting stale cache.
  */
+/**
+ * Forget the stored translation of some (key, locale) pairs, so the next run
+ * translates them again (a dashboard edit that was reverted). Other locales
+ * of the key stay.
+ */
+async function removeLockfileEntries(projectId, entries, dataDir) {
+    const lockfilePath = getLockfilePath(projectId, dataDir);
+    if (entries.length === 0 || !(await fs.pathExists(lockfilePath)))
+        return 0;
+    const lockDir = lockfilePath + '.lock';
+    await acquireLock(lockDir);
+    try {
+        // Read under the lock: a run saving meanwhile must not be lost.
+        const lockfile = await loadLockfile(projectId, dataDir);
+        let removed = 0;
+        for (const { key, locale } of entries) {
+            const entry = lockfile.keys[key];
+            if (!entry || !(locale in entry.languages))
+                continue;
+            delete entry.languages[locale];
+            if (entry.metadata)
+                delete entry.metadata[locale];
+            if (Object.keys(entry.languages).length === 0)
+                delete lockfile.keys[key];
+            removed++;
+        }
+        if (removed > 0) {
+            lockfile.updatedAt = new Date().toISOString();
+            const tmpPath = lockfilePath + '.tmp';
+            await fs.writeJson(tmpPath, lockfile, { spaces: 2 });
+            await fs.rename(tmpPath, lockfilePath);
+        }
+        return removed;
+    }
+    finally {
+        await releaseLock(lockDir);
+    }
+}
 async function removeLocaleFromLockfile(projectId, localeCode, dataDir) {
     const lockfilePath = getLockfilePath(projectId, dataDir);
     try {
@@ -297,7 +336,8 @@ function glossaryChanged(entry, source, locale, options = {}) {
     if (!options.glossaryHash)
         return false;
     const meta = entry.metadata?.[locale];
-    if (meta?.external)
+    // The project's own files, or a dashboard edit: the glossary doesn't rewrite them.
+    if (meta?.external || meta?.manual)
         return false;
     return (meta?.glossaryHash ?? '') !== options.glossaryHash(source, locale);
 }
@@ -394,6 +434,8 @@ function pickLockfileMetadata(meta) {
         out.glossaryHash = meta.glossaryHash;
     if (meta.external === true)
         out.external = true;
+    if (meta.manual === true)
+        out.manual = true;
     return out;
 }
 function sameJson(a, b) {