@babelize/engine 0.2.0 → 0.3.0

package/dist/analysis/analyze.js

@@ -139,7 +139,7 @@ async function analyzeWorkspace(workspacePath, options = {}) {
     const framework = workspace.framework;
     const support = frameworkSupport(framework);
     if (support === 'unsupported') {
-        return empty(framework, `Detected ${framework}, which local translation does not support. Supported: React, Next.js and Django (Vue and static HTML in beta).`);
+        return empty(framework, `Detected ${framework}, which local translation does not support. Supported: React, Next.js, Django and static HTML (Vue and React Native in beta).`);
     }
     const phases = (types_1.FRAMEWORK_CONFIGS[framework] ?? types_1.FRAMEWORK_CONFIGS.unknown).phases;
     // Same ICU decision as a local translate run (whose translator is an LLM).

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/injection/html/html-injector.d.ts

@@ -7,5 +7,7 @@ interface HtmlInjectOptions {
     targetLocales?: string[];
     sourceLocale?: string;
 }
+/** `<script src>` for the root i18n.js as seen from this page: `i18n.js`, `../i18n.js`, ... */
+export declare function runtimeScriptSrc(filePath: string): string;
 export declare function injectHtml(options: HtmlInjectOptions): Promise<FileInjection>;
 export {};

package/dist/injection/html/html-injector.js

@@ -32,10 +32,36 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.runtimeScriptSrc = runtimeScriptSrc;
 exports.injectHtml = injectHtml;
+const path_1 = __importDefault(require("path"));
 const string_utils_1 = require("../../utils/string-utils");
 const html_extractor_1 = require("../../utils/html-extractor");
+// <meta> tags whose content the extractor collects (html-extractor extractHeadStrings).
+const SEO_META = ['description', 'og:title', 'og:description', 'og:site_name', 'twitter:title', 'twitter:description'];
+/**
+ * Key for a string in this file found by its text alone. Head strings are extracted
+ * with ids like `file:meta:<hash>`, and a string already seen in the body is not
+ * extracted twice, so a line-based id can't find them.
+ */
+function keyByText(filePath, text, keyMapping) {
+    const prefix = `${filePath}:`;
+    const suffix = `:${(0, string_utils_1.hashString)(text)}`;
+    for (const [id, key] of keyMapping) {
+        if (id.startsWith(prefix) && id.endsWith(suffix))
+            return key;
+    }
+    return undefined;
+}
+/** `<script src>` for the root i18n.js as seen from this page: `i18n.js`, `../i18n.js`, ... */
+function runtimeScriptSrc(filePath) {
+    const dir = path_1.default.posix.dirname(filePath.split(path_1.default.sep).join('/'));
+    return path_1.default.posix.relative(dir, 'i18n.js') || 'i18n.js';
+}
 function asElement(node) {
     return node.nodeType === 1 ? node : null;
 }
@@ -60,13 +86,26 @@ function walkHtmlNode(node, filePath, content, keyMapping, matchedIds, injection
         }
     }
     const element = asElement(node);
+    if (element && tagName === 'meta') {
+        const name = element.getAttribute('name') || element.getAttribute('property');
+        const value = element.getAttribute('content');
+        if (name && SEO_META.includes(name) && value?.trim() && !element.getAttribute('data-i18n-content')) {
+            const key = keyByText(filePath, value.trim(), keyMapping);
+            if (key) {
+                element.setAttribute('data-i18n-content', key);
+                injections.push({ file: filePath, line: 0, column: 0, original: value, replacement: `data-i18n-content="${key}"`, key, confidence: 100 });
+            }
+        }
+        return;
+    }
     if (textChild && !nonTextChild && element && !element.getAttribute('data-i18n')) {
         const text = textChild.text.trim();
         if (node.range) {
             const line = (content.slice(0, node.range[0]).match(/\n/g) || []).length + 1;
             const id = `${filePath}:${line}:${(0, string_utils_1.hashString)(text)}`;
-            if (matchedIds.has(id)) {
-                const key = keyMapping.get(id);
+            // <title> may only exist under a head id (`file:title:<hash>`) or share a body string's key.
+            if (matchedIds.has(id) || tagName === 'title') {
+                const key = keyMapping.get(id) ?? (tagName === 'title' ? keyByText(filePath, text, keyMapping) : undefined);
                 if (key) {
                     element.setAttribute('data-i18n', key);
                     injections.push({
@@ -159,13 +198,23 @@ async function injectHtml(options) {
     const matchedIds = new Set(keyMapping.keys());
     walkHtmlNode(htmlEl, filePath, content, keyMapping, matchedIds, injections);
     let modifiedContent = root.toString();
-    const hasScript = /<script[^>]*src\s*=\s*["']i18n\.js["'][^>]*>/.test(modifiedContent);
-    if (!hasScript) {
+    // i18n.js lives at the site root, so pages in subfolders need ../i18n.js. Older runs
+    // wrote a bare src="i18n.js" everywhere; repoint those instead of adding a second tag.
+    const src = runtimeScriptSrc(filePath);
+    const existingScript = /<script([^>]*)src\s*=\s*["']((?:\.\.\/)*i18n\.js)["']/.exec(modifiedContent);
+    if (existingScript) {
+        if (existingScript[2] !== src) {
+            modifiedContent = modifiedContent.replace(existingScript[0], `<script${existingScript[1]}src="${src}"`);
+            importAdded = true;
+        }
+    }
+    else {
+        const tag = `  <script src="${src}"></script>\n`;
         if (modifiedContent.includes('</body>')) {
-            modifiedContent = modifiedContent.replace('</body>', '  <script src="i18n.js"></script>\n</body>');
+            modifiedContent = modifiedContent.replace('</body>', `${tag}</body>`);
         }
         else {
-            modifiedContent = modifiedContent.replace('</head>', '  <script src="i18n.js"></script>\n</head>');
+            modifiedContent = modifiedContent.replace('</head>', `${tag}</head>`);
         }
         importAdded = true;
     }

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.
  */
@@ -36,8 +37,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 +69,26 @@ 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;
     /** 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

@@ -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.
  */
@@ -48,6 +49,13 @@ 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;
+        this.token = options.apiKey;
         this.opts = {
             fetch: globalThis.fetch.bind(globalThis),
             maxRetries: 3,
@@ -59,6 +67,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 +155,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 +163,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 } : {}),
                     },
@@ -162,6 +196,17 @@ class HostedTranslationProvider {
                 this.model = res.headers.get(exports.HOSTED_MODEL_HEADER) ?? this.model;
                 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 +228,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/translate-core.d.ts

@@ -10,8 +10,8 @@ import { type FileDiffStat, type ApplyIo, type WorkspaceChanges } from './worksp
 /** 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", "django"];
-export declare const BETA_LOCAL_FRAMEWORKS: readonly ["vue", "static", "react-native"];
+export declare const SUPPORTED_LOCAL_FRAMEWORKS: readonly ["react", "nextjs", "django", "static"];
+export declare const BETA_LOCAL_FRAMEWORKS: readonly ["vue", "react-native"];
 export interface LocalTranslateOptions {
     projectDir: string;
     sourceLocale: string;

package/dist/local/translate-core.js

@@ -72,8 +72,8 @@ const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
 /** Lockfile scope for local runs: `.babelize/local/babelize-lock.json` in the project root. */
 exports.LOCAL_PROJECT_ID = 'local';
 exports.LOCAL_LOCKFILE = `.babelize/${exports.LOCAL_PROJECT_ID}/babelize-lock.json`;
-exports.SUPPORTED_LOCAL_FRAMEWORKS = ['react', 'nextjs', 'django'];
-exports.BETA_LOCAL_FRAMEWORKS = ['vue', 'static', 'react-native'];
+exports.SUPPORTED_LOCAL_FRAMEWORKS = ['react', 'nextjs', 'django', 'static'];
+exports.BETA_LOCAL_FRAMEWORKS = ['vue', 'react-native'];
 class LocalTranslateError extends Error {
     constructor(message, code, 
     /** Files left changed in the project (only for a failed, un-rolled-back apply). */
@@ -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 {

package/dist/modules/finalization/finalize.js

@@ -334,10 +334,12 @@ async function finalizeProject(workspace, dryRun, options = {}) {
         }
         else {
             // 'missing' or 'ours' — write/overwrite
-            const runtimeContent = (0, static_runtime_1.buildStaticRuntime)({
-                sourceLocale: workspace.sourceDirs[0] || 'en',
-                targetLocales: workspace.existingLocales || [],
-            });
+            // sourceDirs[0] is the scan root ("."), not a locale. Targets: this run's plus any
+            // locale files already on disk, so the switcher lists every language.
+            const sourceLocale = options.sourceLocale || 'en';
+            const targetLocales = [...new Set([...(options.targetLocales ?? []), ...(workspace.existingLocales ?? [])])]
+                .filter((l) => l && l !== sourceLocale && /^[A-Za-z]{2,3}([-_][A-Za-z0-9]+)*$/.test(l));
+            const runtimeContent = (0, static_runtime_1.buildStaticRuntime)({ sourceLocale, targetLocales });
             await writer.write(i18nJsPath, runtimeContent);
             configFileCreated = true;
             if (regenerationStatus === 'ours') {

package/dist/modules/finalization/static-runtime.d.ts

@@ -1,5 +1,5 @@
-export declare const STATIC_RUNTIME_VERSION = "1.0.0";
-export declare const RUNTIME_HEADER = "/* babelize:static-runtime v1.0.0 */";
+export declare const STATIC_RUNTIME_VERSION = "1.1.0";
+export declare const RUNTIME_HEADER = "/* babelize:static-runtime v1.1.0 */";
 export declare function buildStaticRuntime(config: {
     sourceLocale: string;
     targetLocales: string[];

package/dist/modules/finalization/static-runtime.js

@@ -4,8 +4,9 @@ exports.RUNTIME_HEADER = exports.STATIC_RUNTIME_VERSION = void 0;
 exports.buildStaticRuntime = buildStaticRuntime;
 exports.buildSwitcherPlaceholder = buildSwitcherPlaceholder;
 exports.checkRuntimeNeedsRegeneration = checkRuntimeNeedsRegeneration;
-exports.STATIC_RUNTIME_VERSION = '1.0.0';
-exports.RUNTIME_HEADER = `/* babelize:static-runtime v${exports.STATIC_RUNTIME_VERSION} */`;
+exports.STATIC_RUNTIME_VERSION = '1.1.0';
+const RUNTIME_MARKER = '/* babelize:static-runtime v';
+exports.RUNTIME_HEADER = `${RUNTIME_MARKER}${exports.STATIC_RUNTIME_VERSION} */`;
 function buildStaticRuntime(config) {
     const locales = JSON.stringify([config.sourceLocale, ...config.targetLocales]);
     const baseDir = config.baseDir ? JSON.stringify(config.baseDir) : 'null';
@@ -113,8 +114,9 @@ function buildStaticRuntime(config) {
   }
 
   function applyTranslations() {
+    // The whole document, so <title> and SEO <meta> tags in <head> are translated too.
     var walk = document.createTreeWalker(
-      document.body,
+      document.documentElement,
       NodeFilter.SHOW_ELEMENT,
       null,
       false
@@ -150,7 +152,7 @@ function buildStaticRuntime(config) {
           }
         }
       }
-      var attrNames = ['alt', 'title', 'placeholder', 'aria-label', 'aria-description'];
+      var attrNames = ['alt', 'title', 'placeholder', 'aria-label', 'aria-description', 'content'];
       for (var a = 0; a < attrNames.length; a++) {
         var attrKey = node.getAttribute('data-i18n-' + attrNames[a]);
         if (attrKey) {
@@ -162,6 +164,8 @@ function buildStaticRuntime(config) {
   }
 
   function updateHtmlAttributes() {
+    var select = document.querySelector('[data-babelize-switcher-select]');
+    if (select) select.value = lang;
     var meta = (loadedLocales[lang] || {})._meta;
     if (!meta) return;
     var html = document.documentElement;
@@ -254,7 +258,8 @@ function checkRuntimeNeedsRegeneration(existingContent) {
     if (!existingContent || existingContent.trim().length === 0) {
         return 'missing';
     }
-    if (existingContent.includes(exports.RUNTIME_HEADER)) {
+    // Any version we generated, so older runtimes get upgraded rather than treated as hand-written.
+    if (existingContent.includes(RUNTIME_MARKER)) {
         return 'ours';
     }
     return 'user';

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';