@babelize/engine 0.3.0 → 0.3.1

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

@@ -16,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 = 
@@ -75,6 +77,8 @@ export declare class HostedTranslationProvider implements TranslationProvider {
      * 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;

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");
@@ -22,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 {
@@ -55,6 +57,8 @@ class HostedTranslationProvider {
          * 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),
@@ -194,6 +198,9 @@ 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.

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

@@ -462,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/translator/icu-branches.d.ts

@@ -49,6 +49,13 @@ interface NumberSlot {
      * instead of showing it, and the branch is still exact.
      */
     mayBeSpelledOut: boolean;
+    /**
+     * Words for "one" in the target language, when this slot is the number 1 in
+     * a branch that also covers other numbers (French "one" is 0 and 1). The
+     * translator often writes "Vous avez un article" for "You have 1 item"; the
+     * word is put back as the count, which keeps the branch right for 0 too.
+     */
+    oneWords?: string[];
 }
 export interface BranchUnit {
     /** Unique within the plan. */

package/dist/modules/translator/icu-branches.js

@@ -54,6 +54,21 @@ const CANDIDATES = (() => {
 const ARG_SENTINEL = /\uE001(\d+)\uE001/g;
 const POUND_SENTINEL = '\uE002';
 const TOKEN_PATTERN = /\[\s*#\s*VAR_\d+\s*#\s*\]/gi;
+/** Spelled-out "one" (as an article or numeral) in languages whose "one" category has several numbers. */
+const ONE_WORDS = {
+    fr: ['un', 'une'],
+    es: ['un', 'una', 'uno'],
+    pt: ['um', 'uma'],
+    it: ['un', 'uno', 'una'],
+    ca: ['un', 'una'],
+    ro: ['un', 'o'],
+    hi: ['एक'],
+    bn: ['এক', 'একটি'],
+    gu: ['એક'],
+    mr: ['एक'],
+    fa: ['یک'],
+    hy: ['մեկ'],
+};
 class PlanError extends Error {
 }
 /** Plural categories of a locale, CLDR order. */
@@ -218,7 +233,8 @@ function makeUnit(nodes, path, state) {
             used.add(pick);
             // A plural added over a plain count must show it in every branch (compareIcuMessages), so no spelling out there.
             const mayBeSpelledOut = numbers.length === 1 && !(state.options.pluralizeArgs ?? []).includes(occ.owner.name);
-            slot = { text: pick, count: 0, restore: occ.restore, label: occ.label, mayBeSpelledOut };
+            const oneWords = pick === '1' && !mayBeSpelledOut ? ONE_WORDS[state.targetLocale.split(/[-_]/)[0].toLowerCase()] : undefined;
+            slot = { text: pick, count: 0, restore: occ.restore, label: occ.label, mayBeSpelledOut, ...(oneWords ? { oneWords } : {}) };
             slotsByKind.set(kindKey, slot);
         }
         slot.count++;
@@ -287,10 +303,20 @@ function restoreNumbers(translated, slots) {
             return slot.restore;
         });
     }).join('');
+    let text = out;
     for (const slot of slots) {
-        const n = found.get(slot) ?? 0;
+        let n = found.get(slot) ?? 0;
         if (n === 0 && slot.mayBeSpelledOut)
             continue;
+        if (n === 0 && slot.count === 1 && slot.oneWords) {
+            // "Vous avez un article" → "Vous avez # article", when the word is there exactly once.
+            const word = new RegExp(`(?<![\\p{L}\\p{M}])(?:${slot.oneWords.join('|')})(?![\\p{L}\\p{M}])`, 'giu');
+            const hits = text.match(word) ?? [];
+            if (hits.length === 1) {
+                text = text.replace(word, slot.restore);
+                n = 1;
+            }
+        }
         if (n !== slot.count) {
             return {
                 problem: n === 0
@@ -299,7 +325,7 @@ function restoreNumbers(translated, slots) {
             };
         }
     }
-    return { text: out };
+    return { text };
 }
 /** ICU-escape literal text: apostrophes before syntax, and `{`, `}` (and `#` in a plural) quoted. */
 function escapeIcuText(text, inPlural) {

package/dist/utils/icu-message.js

@@ -208,6 +208,23 @@ function integersOf(locale, type, category) {
         return [];
     }
 }
+/**
+ * Whether ordinary counts ever pick `category`: a whole number under 1000 or
+ * a simple fraction. Spanish, French, Italian, Portuguese and Catalan `many`
+ * is only reached by exact millions ("1 millón de archivos"), where `other`
+ * reads fine, so a missing branch for it isn't worth a warning.
+ */
+function reachedByOrdinaryCounts(locale, type, category) {
+    if (integersOf(locale, type, category).length > 0)
+        return true;
+    try {
+        const rules = new Intl.PluralRules(locale, { type });
+        return [0.5, 1.5, 2.5, 3.5, 0.1, 1.1, 2.1, 0.25].some((n) => rules.select(n) === category);
+    }
+    catch {
+        return true;
+    }
+}
 /**
  * Compare a translated ICU message to its source. Errors mean the message is
  * broken at runtime (unparseable, arguments renamed, select branches changed,
@@ -326,11 +343,14 @@ function compareIcuMessages(source, translated, targetLocale, options = {}) {
                 });
             }
             else {
-                issues.push({
-                    severity: 'warning',
-                    code: 'icu_plural_category_missing',
-                    message: `{${target.name}, ${target.kind}} has no [${missing.join(', ')}] branch for ${targetLocale}; "other" will be used`,
-                });
+                const noticeable = missing.filter((c) => reachedByOrdinaryCounts(targetLocale, type, c));
+                if (noticeable.length) {
+                    issues.push({
+                        severity: 'warning',
+                        code: 'icu_plural_category_missing',
+                        message: `{${target.name}, ${target.kind}} has no [${noticeable.join(', ')}] branch for ${targetLocale}; "other" will be used`,
+                    });
+                }
             }
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babelize/engine",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Babelize translation pipeline (extract, keygen, translate, inject). Infrastructure is injected through provider/store interfaces.",
   "keywords": [
     "babelize",