@taon-dev/i18n 21.0.49 → 21.0.51

package/websql/types/i18n-websql.d.ts

@@ -1,5 +1,5 @@
 // @ts-nocheck
-import { UtilsI18n, CoreModels } from 'tnp-core/websql';
+import { UtilsI18n } from 'tnp-core/websql';
 import * as i0 from '@angular/core';
 import { ChangeDetectorRef, WritableSignal, AfterViewInit, OnChanges, PipeTransform, OnDestroy } from '@angular/core';
 import * as rxjs from 'rxjs';
@@ -28,16 +28,22 @@ declare const CURRENT_PACKAGE_TAON_VERSION = "v21";
 /**
  *  Autogenerated by current cli tool. Use *tnp release* to bump version.
  */
-declare const CURRENT_PACKAGE_VERSION = "21.0.49";
+declare const CURRENT_PACKAGE_VERSION = "21.0.51";
 
 interface TranslationOptions {
     text: string;
     from: UtilsI18n.CommonLocaleCode;
     to: UtilsI18n.CommonLocaleCode;
     /**
-     * Nearby source-language text.
+     * Nearby source-language text used only to give the translator
+     * additional context.
+     *
+     * Context is never returned from translate().
      */
     context?: string;
+    /**
+     * Source terms that should be replaced with specific translated terms.
+     */
     glossary?: Record<string, string>;
 }
 interface AiDownloadProgress {
@@ -94,6 +100,7 @@ declare class LocalTranslationService {
     private warmupTranslator;
     translate(options: TranslationOptions): Promise<string>;
     private protectGlossary;
+    private protectInterpolation;
     private getModelsCachePath;
 }
 
@@ -256,27 +263,5 @@ declare namespace UtilsPoFile {
     function mergeGettextFile(jsonContent1FromTsHtml: UtilsI18n.GettextFile, json2ContentFromPoFileModifedByUser?: UtilsI18n.GettextFile | null): UtilsI18n.GettextFile;
 }
 
-interface EnUsTraslationOverrideSrcLibTranslationTs {
-    "en-US": {
-        "": {
-            "amazing better place"?: string;
-            "asdasd"?: string;
-            "hello"?: string;
-        };
-    };
-}
-
-interface PlPlTraslationOverrideSrcLibTranslationTs {
-    "pl-PL": {
-        "": {
-            "amazing better place"?: string;
-            "asdasd"?: string;
-            "hello"?: string;
-        };
-    };
-}
-
-type LibOverride = CoreModels.DeepPartial<EnUsTraslationOverrideSrcLibTranslationTs | PlPlTraslationOverrideSrcLibTranslationTs>;
-
 export { APP_ID, BUILD_BASE_HREF, BUILD_FRAMEWORK_CLI_NAME, CURRENT_PACKAGE_TAON_VERSION, CURRENT_PACKAGE_VERSION, LocalTranslationService, PROJECT_NPM_NAME, TranslateDirective, TranslatePipe, TranslateService, Translation, TranslationManager, UtilsI18nExtractGettextTranslateFromHtml, UtilsI18nHtml, UtilsPoFile, startCli };
-export type { AiDownloadProgress, LibOverride, MakeSureAiDownloadedOptions, TaonTranslationsMap, TaonTranslationsMapImport, Translatable, TranslationBinding, TranslationLookup, TranslationOptions, TranslationParams };
+export type { AiDownloadProgress, MakeSureAiDownloadedOptions, TaonTranslationsMap, TaonTranslationsMapImport, Translatable, TranslationBinding, TranslationLookup, TranslationOptions, TranslationParams };

package/websql-prod/fesm2022/i18n-websql-prod.mjs

@@ -28,26 +28,34 @@ const CURRENT_PACKAGE_TAON_VERSION = 'v21';
 /**
  *  Autogenerated by current cli tool. Use *tnp release* to bump version.
  */
-const CURRENT_PACKAGE_VERSION = '21.0.49';
+const CURRENT_PACKAGE_VERSION = '21.0.51';
 // THIS FILE IS GENERATED - DO NOT MODIFY
 
+//#region imports
+//#endregion
+//#region constants
 const MODEL_ID = 'Xenova/nllb-200-distilled-600M';
 const nllbLanguageCodes = {
     'en-US': 'eng_Latn',
     'pl-PL': 'pol_Latn',
     'de-DE': 'deu_Latn',
 };
+const CONTEXT_SEPARATOR = '→';
+//#endregion
 class LocalTranslationService {
     constructor() {
         this.aiReady = false;
         this.progressListeners = new Set();
+        //#endregion
     }
+    //#endregion
     /**
      * Downloads, caches and loads the translation model.
      *
      * Multiple simultaneous calls share the same initialization promise.
      * After this resolves, translate() reuses the already loaded model.
      */
+    //#region methods / make sure ai downloaded
     async makeSureAiDownloaded(options = {}) {
         /* */
         /* */
@@ -69,12 +77,16 @@ class LocalTranslationService {
         /* */
         return (void 0);
     }
+    //#endregion
     /**
      * True only in this process after pipeline initialization succeeded.
      */
+    //#region methods / is ai ready
     isAiReady() {
         return this.aiReady;
     }
+    //#endregion
+    //#region methods / get translator
     getTranslator() {
         this.translatorPromise ??= this.createTranslator().catch(error => {
             // Allow a later call to retry after a network or disk failure.
@@ -84,6 +96,8 @@ class LocalTranslationService {
         });
         return this.translatorPromise;
     }
+    //#endregion
+    //#region methods / create translator
     async createTranslator() {
         /* */
         /* */
@@ -108,11 +122,11 @@ class LocalTranslationService {
         /* */
         /* */
         /* */
-        /* */
-        /* */
         return (void 0);
         return void 0;
     }
+    //#endregion
+    //#region methods / emit progress
     emitProgress(progress) {
         for (const listener of this.progressListeners) {
             try {
@@ -123,6 +137,8 @@ class LocalTranslationService {
             }
         }
     }
+    //#endregion
+    //#region methods / warmup translator
     warmupTranslator(translator) {
         this.warmupPromise ??= translator('Hello.', {
             src_lang: 'eng_Latn',
@@ -136,6 +152,8 @@ class LocalTranslationService {
         });
         return this.warmupPromise;
     }
+    //#endregion
+    //#region methods / translate
     async translate(options) {
         /* */
         /* */
@@ -181,8 +199,46 @@ class LocalTranslationService {
         /* */
         /* */
         /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
+        /* */
         return (void 0);
     }
+    //#endregion
+    //#region methods / protect glossary
     protectGlossary(text, glossary) {
         if (!glossary || Object.keys(glossary).length === 0) {
             return {
@@ -213,6 +269,35 @@ class LocalTranslationService {
             },
         };
     }
+    //#endregion
+    //#region methods / protect interpolation
+    protectInterpolation(text) {
+        const replacements = [];
+        const preparedText = text.replace(/\[\[[\s\S]*?\]\]/g, originalValue => {
+            const placeholder = `[[${replacements.length}]]`;
+            replacements.push({
+                placeholder,
+                originalValue,
+            });
+            return placeholder;
+        });
+        return {
+            preparedText,
+            restore(translatedText) {
+                let result = translatedText;
+                for (const replacement of replacements) {
+                    if (!result.includes(replacement.placeholder)) {
+                        throw new Error(`Translation model removed interpolation placeholder ` +
+                            `"${replacement.placeholder}" while translating "${text}".`);
+                    }
+                    result = result.replaceAll(replacement.placeholder, replacement.originalValue);
+                }
+                return result;
+            },
+        };
+    }
+    //#endregion
+    //#region methods / get models cache path
     getModelsCachePath() {
         const cachePath = crossPlatformPath([
             UtilsOs__NS__getRealHomeDir(),
@@ -1931,9 +2016,6 @@ function unescapePoString(value) {
 //#endregion
 //end of namespace UtilsPoFile
 
-;
-// THIS FILE IS GENERATED - DO NOT MODIFY
-
 // @ts-nocheck
 // This file is auto-generated during init process. Do not modify.
 // This disable this auto generate file.