@babelize/engine 0.1.0 → 0.1.3

package/dist/modules/translator/translate.d.ts

@@ -1,16 +1,52 @@
 import type { LocaleFile, WorkspaceInfo } from '../../runtime/types';
 import type { ByokProvider } from '@babelize/types';
-import type { EngineProviders, TranslationFailure, TranslationCache } from '../../providers/types';
+import { type GlossaryRules } from '../glossary';
+import type { EngineProviders, ProjectRulesStore, TranslationFailure, TranslationCache } from '../../providers/types';
 /** QA note on keys the backup (NLLB) translator produced. */
 export declare const FALLBACK_QA_WARNING = "translated with the backup translator; will be retried with the AI translator next run";
 export interface TranslateOptions {
     /**
-     * The project's runtime formats ICU (next-intl, react-i18next + i18next-icu)
-     * and the translator is an LLM: a translation may turn a count placeholder
-     * into an ICU plural. Otherwise a plain source must stay plain.
+     * The project's runtime formats ICU (next-intl, react-i18next + i18next-icu):
+     * a translation may turn a count placeholder into an ICU plural. An LLM
+     * decides per message; for a plain-text translator (NLLB) the plural is
+     * built branch by branch for languages with more than one plural category.
+     * Otherwise a plain source must stay plain.
      */
     targetPlurals?: boolean;
+    /**
+     * Per key: literal text in an ICU plural's branches that stands for the
+     * plural's value besides `#` (a gettext plural turned into ICU keeps its
+     * `%(count)d`). Lets a plain-text translator inflect each branch.
+     */
+    pluralValuePlaceholders?: Record<string, string>;
+    /**
+     * The project's glossary and brand voice, already loaded (the orchestrator
+     * loads them once to partition the lockfile). Loaded here when absent.
+     */
+    rules?: LoadedTranslationRules;
+    /**
+     * Running count of fresh primary-translator translations, bumped as each
+     * batch lands (when it is also written to the cache and TM). Lets a run
+     * stopped mid-translation bill what it already produced.
+     */
+    progress?: {
+        freshTranslations: number;
+    };
+}
+export interface LoadedTranslationRules {
+    glossary: GlossaryRules;
+    brandVoice: string | null;
+    /** False if the glossary or brand voice failed to load. */
+    complete: boolean;
 }
+/**
+ * Load a project's glossary and brand voice. Never throws: a failure means
+ * translating without that rule, as before. The two lookups are independent,
+ * so a glossary failure doesn't also drop the brand voice. `complete` is false
+ * if either failed — callers that copy text into shared TM must then assume
+ * project-specific wording may be baked in.
+ */
+export declare function loadProjectTranslationRules(projectId: string, rules?: ProjectRulesStore): Promise<LoadedTranslationRules>;
 export declare function translateLocales(workspace: WorkspaceInfo, sourceLocale: LocaleFile, targetLocales: string[], forceTranslation?: boolean, dryRun?: boolean, projectId?: string, onProgress?: (message: string) => void, keysToTranslateByLocale?: Record<string, string[]>, cacheProvider?: TranslationCache, byokConfig?: {
     provider: ByokProvider;
     apiKey: string;