@taon-dev/i18n 21.0.48 → 21.0.50

package/ts-source/browser-code/build-info._auto-generated_.ts

@@ -0,0 +1,18 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+export const BUILD_FRAMEWORK_CLI_NAME = 'tnp';
+export const APP_ID = 'com.domain.example.i18n';
+export const BUILD_BASE_HREF = '';
+export const PROJECT_NPM_NAME = '@taon-dev/i18n';
+export const CURRENT_PACKAGE_TAON_VERSION = 'v21';
+export const CURRENT_PACKAGE_VERSION = '21.0.50';

package/ts-source/browser-code/i18n/lib.translation.ts

@@ -0,0 +1,17 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { CoreModels } from 'tnp-core/browser';
+import { EnUsTraslationOverrideSrcLibTranslationTs } from './translation.ts.en-US.i18n.data';
+import { PlPlTraslationOverrideSrcLibTranslationTs } from './translation.ts.pl-PL.i18n.data';
+;
+export type LibOverride = CoreModels.DeepPartial<EnUsTraslationOverrideSrcLibTranslationTs | PlPlTraslationOverrideSrcLibTranslationTs>;

package/ts-source/browser-code/i18n/translation.ts.en-US.i18n.data.ts

@@ -0,0 +1,38 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+export interface EnUsTraslationOverrideSrcLibTranslationTs {
+    "en-US": {
+        "": {
+            "amazing better place"?: string;
+            "asdasd"?: string;
+            "hello"?: string;
+        };
+    };
+}
+export default {
+    "fileRelativePath": "src/lib/translation.ts",
+    "tags": [
+        {
+            "gettextString": "asdasd",
+            "lineNumber": 345
+        },
+        {
+            "gettextString": "amazing better place",
+            "lineNumber": 355
+        },
+        {
+            "gettextString": "hello",
+            "lineNumber": 369
+        }
+    ]
+};

package/ts-source/browser-code/i18n/translation.ts.en-US.po

@@ -0,0 +1,17 @@
+msgid ""
+msgstr ""
+"Language: en-US\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: src/lib/translation.ts:345
+msgid "asdasd"
+msgstr ""
+
+#: src/lib/translation.ts:355
+msgid "amazing better place"
+msgstr ""
+
+#: src/lib/translation.ts:369
+msgid "hello"
+msgstr ""

package/ts-source/browser-code/i18n/translation.ts.pl-PL.i18n.data.ts

@@ -0,0 +1,38 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+export interface PlPlTraslationOverrideSrcLibTranslationTs {
+    "pl-PL": {
+        "": {
+            "amazing better place"?: string;
+            "asdasd"?: string;
+            "hello"?: string;
+        };
+    };
+}
+export default {
+    "fileRelativePath": "src/lib/translation.ts",
+    "tags": [
+        {
+            "gettextString": "asdasd",
+            "lineNumber": 345
+        },
+        {
+            "gettextString": "amazing better place",
+            "lineNumber": 355
+        },
+        {
+            "gettextString": "hello",
+            "lineNumber": 369
+        }
+    ]
+};

package/ts-source/browser-code/i18n/translation.ts.pl-PL.po

@@ -0,0 +1,17 @@
+msgid ""
+msgstr ""
+"Language: pl-PL\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: src/lib/translation.ts:345
+msgid "asdasd"
+msgstr ""
+
+#: src/lib/translation.ts:355
+msgid "amazing better place"
+msgstr ""
+
+#: src/lib/translation.ts:369
+msgid "hello"
+msgstr ""

package/ts-source/browser-code/index._auto-generated_.ts

@@ -0,0 +1,25 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+export * from './build-info._auto-generated_';
+export * from './local-translation';
+export * from './start-cli';
+export * from './translate.directive';
+export * from './translate.pipe';
+export * from './translate.service';
+export * from './translation-manager';
+export * from './translation.models';
+export * from './translation';
+export * from './utils-i18n-extract-gettext-translate-from-html';
+export * from './utils-i18n-html';
+export * from './utils-po-file';
+export * from './i18n/lib.translation';

package/ts-source/browser-code/index.scss

@@ -0,0 +1,12 @@
+/* ============================================================================
+ 
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+

package/ts-source/browser-code/index.ts

@@ -0,0 +1,15 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+export * from './index._auto-generated_';
+export * from './start-cli';
+export default {};

package/ts-source/browser-code/lib-info.md

@@ -0,0 +1,8 @@
+THIS FILE IS GENERATED - DO NOT MODIFY
+
+This folder is an entry point for npm Angular/NodeJS library
+
+DON'T USE STUFF FROM PARENT FOLDER app.* FILES HERE (except src/migrations/** files).
+
+THIS FILE IS GENERATED - DO NOT MODIFY
+          

package/ts-source/browser-code/local-translation.ts

@@ -0,0 +1,131 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { crossPlatformPath, dotTaonFolder, UtilsI18n, UtilsOs, _, Helpers, } from 'tnp-core/browser';
+export interface TranslationOptions {
+    text: string;
+    from: UtilsI18n.CommonLocaleCode;
+    to: UtilsI18n.CommonLocaleCode;
+    context?: string;
+    glossary?: Record<string, string>;
+}
+export interface AiDownloadProgress {
+    status: 'initiate' | 'download' | 'progress' | 'progress_total' | 'done' | 'ready' | string;
+    file?: string;
+    progress?: number;
+    loaded?: number;
+    total?: number;
+}
+export interface MakeSureAiDownloadedOptions {
+    onProgress?: (progress: AiDownloadProgress) => void;
+    warmup?: boolean;
+}
+const MODEL_ID = 'Xenova/nllb-200-distilled-600M';
+const nllbLanguageCodes: Partial<Record<UtilsI18n.CommonLocaleCode, string>> = {
+    'en-US': 'eng_Latn',
+    'pl-PL': 'pol_Latn',
+    'de-DE': 'deu_Latn',
+};
+export class LocalTranslationService {
+    private translatorPromise?: Promise<any>;
+    private aiReady = false;
+    private warmupPromise?: Promise<void>;
+    private progressListeners = new Set<(progress: AiDownloadProgress) => void>();
+    async makeSureAiDownloaded(options: MakeSureAiDownloadedOptions = {}): Promise<void> {
+        return (void 0);
+    }
+    isAiReady(): boolean {
+        return this.aiReady;
+    }
+    private getTranslator(): Promise<any> {
+        this.translatorPromise ??= this.createTranslator().catch(error => {
+            this.translatorPromise = undefined;
+            this.aiReady = false;
+            throw error;
+        });
+        return this.translatorPromise;
+    }
+    private async createTranslator(): Promise<any> {
+        return (void 0);
+        return void 0 as any;
+    }
+    private emitProgress(progress: AiDownloadProgress): void {
+        for (const listener of this.progressListeners) {
+            try {
+                listener(progress);
+            }
+            catch {
+            }
+        }
+    }
+    private warmupTranslator(translator: any): Promise<void> {
+        this.warmupPromise ??= translator('Hello.', {
+            src_lang: 'eng_Latn',
+            tgt_lang: 'pol_Latn',
+            max_new_tokens: 16,
+        })
+            .then(() => undefined)
+            .catch(error => {
+            this.warmupPromise = undefined;
+            throw error;
+        });
+        return this.warmupPromise;
+    }
+    async translate(options: TranslationOptions): Promise<string> {
+        return (void 0);
+    }
+    private protectGlossary(text: string, glossary?: Record<string, string>): {
+        preparedText: string;
+        restore: (translatedText: string) => string;
+    } {
+        if (!glossary || Object.keys(glossary).length === 0) {
+            return {
+                preparedText: text,
+                restore: translatedText => translatedText,
+            };
+        }
+        const replacements: Array<{
+            placeholder: string;
+            translatedValue: string;
+        }> = [];
+        let preparedText = text;
+        Object.entries(glossary)
+            .sort(([left], [right]) => right.length - left.length)
+            .forEach(([sourceValue, translatedValue], index) => {
+            const placeholder = `TAONTERM${index}PLACEHOLDER`;
+            preparedText = preparedText.replaceAll(sourceValue, placeholder);
+            replacements.push({
+                placeholder,
+                translatedValue,
+            });
+        });
+        return {
+            preparedText,
+            restore(translatedText: string): string {
+                let result = translatedText;
+                for (const replacement of replacements) {
+                    result = result.replaceAll(replacement.placeholder, replacement.translatedValue);
+                }
+                return result;
+            },
+        };
+    }
+    private getModelsCachePath(): string {
+        const cachePath = crossPlatformPath([
+            UtilsOs.getRealHomeDir(),
+            dotTaonFolder,
+            'ai-models-cache',
+        ]);
+        Helpers.mkdirp(cachePath);
+        return cachePath;
+    }
+}

package/ts-source/browser-code/migrations/migrations-info.md

@@ -0,0 +1,6 @@
+THIS FILE IS GENERATED - DO NOT MODIFY
+
+This folder is only for storing migration files with auto-generated names.
+
+THIS FILE IS GENERATED - DO NOT MODIFY
+          

package/ts-source/browser-code/start-cli.ts

@@ -0,0 +1,17 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { LocalTranslationService } from './local-translation';
+export async function startCli(argsv: string[], filename: string): Promise<void> {
+    return (void 0);
+}
+export default startCli;

package/ts-source/browser-code/translate.directive.ts

@@ -0,0 +1,64 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { AfterViewInit, DestroyRef, Directive, ElementRef, inject, Input, OnChanges, } from '@angular/core';
+import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
+import { Translation } from './translation';
+@Directive({
+    selector: '[translate]',
+    standalone: true,
+})
+export class TranslateDirective implements AfterViewInit, OnChanges {
+    private static readonly selector = '[translate]';
+    @Input('translate-t')
+    t!: Translation;
+    @Input('translate-params')
+    params?: Record<string, unknown>;
+    @Input('translate-context')
+    translateContext?: string;
+    private initialized = false;
+    private readonly element = inject(ElementRef<HTMLElement>);
+    private readonly destroyRef = inject(DestroyRef);
+    private originalText = '';
+    ngAfterViewInit(): void {
+        const nativeElement = this.element.nativeElement;
+        this.validateContent();
+        this.originalText = nativeElement.textContent?.trim() ?? '';
+        this.initialized = true;
+        this.render();
+        this.t.isLoadingLang$
+            .pipe(takeUntilDestroyed(this.destroyRef))
+            .subscribe(() => {
+            this.render();
+        });
+    }
+    ngOnChanges(): void {
+        if (!this.initialized) {
+            return;
+        }
+        this.render();
+    }
+    private validateContent(): void {
+        const element = this.element.nativeElement;
+        if (element.children.length > 0) {
+            console.error(`[@taon-dev/i18n] ${TranslateDirective.selector} should only be used ` +
+                `with plain text. HTML/content elements detected inside:`, element);
+        }
+    }
+    private render(): void {
+        if (!this.t) {
+            throw (`Directive ${TranslateDirective.selector} applied on component ` +
+                `without implemented Translatable interface`);
+        }
+        this.element.nativeElement.textContent = this.t.translate(this.originalText, this.params, this.translateContext);
+    }
+}

package/ts-source/browser-code/translate.pipe.ts

@@ -0,0 +1,37 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { ChangeDetectorRef, inject, OnDestroy, Pipe, PipeTransform, } from '@angular/core';
+import { Subscription } from 'rxjs';
+import { Translation } from './translation';
+import { TranslationManager } from './translation-manager';
+@Pipe({
+    name: 'translate',
+    standalone: true,
+    pure: false,
+})
+export class TranslatePipe implements PipeTransform, OnDestroy {
+    private readonly cdr = inject(ChangeDetectorRef);
+    private tranlsationManager = TranslationManager.Instance;
+    private readonly sub: Subscription;
+    constructor() {
+        this.sub = this.tranlsationManager.isLoadingLangs$.subscribe(() => {
+            this.cdr.markForCheck();
+        });
+    }
+    transform(text: string, t: Translation, params?: Record<string, unknown>, context?: string): string {
+        return t?.gettext(text, params, context) ?? text;
+    }
+    ngOnDestroy(): void {
+        this.sub.unsubscribe();
+    }
+}

package/ts-source/browser-code/translate.service.ts

@@ -0,0 +1,25 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { Injectable } from '@angular/core';
+import { UtilsI18n } from 'tnp-core/browser';
+import { TranslationManager } from './translation-manager';
+@Injectable({ providedIn: 'root' })
+export class TranslateService {
+    public manager = TranslationManager.Instance;
+    public setOneLanguagePernament(lang: UtilsI18n.CommonLocaleCode): void {
+        this.manager.setOneLanguagePernament(lang);
+    }
+    async changeGlobalLang(lang: UtilsI18n.CommonLocaleCode): Promise<void> {
+        await this.manager.changeGlobalLang(lang);
+    }
+}

package/ts-source/browser-code/translation-manager.ts

@@ -0,0 +1,106 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { BehaviorSubject, filter, map, tap } from 'rxjs';
+import { GlobalStorage, UtilsI18n, _ } from 'tnp-core/browser';
+import type { Translation } from './translation';
+const globalStorageKeyMainLanguage = 'taon-gettext-main-language';
+const globalTaonLanguageLocalKeyLocalStor = 'taon-language-local';
+const TranslationManagerGlobalStorKey = 'TranslationManagerGlobalStorKey';
+export class TranslationManager {
+    static globalDefautlLanguageOverride: UtilsI18n.CommonLocaleCode;
+    public get instances(): Set<Translation> {
+        let set = GlobalStorage.get(TranslationManagerGlobalStorKey) as Set<Translation>;
+        if (_.isNil(set)) {
+            GlobalStorage.set(TranslationManagerGlobalStorKey, new Set<Translation>());
+        }
+        set = GlobalStorage.get(TranslationManagerGlobalStorKey) as Set<Translation>;
+        return set;
+    }
+    constructor() {
+    }
+    private defaultLangLocale: UtilsI18n.CommonLocaleCode = (() => {
+        return ((localStorage.getItem(globalTaonLanguageLocalKeyLocalStor) as UtilsI18n.CommonLocaleCode) ||
+            TranslationManager.globalDefautlLanguageOverride ||
+            (UtilsI18n.detectLocale() as UtilsI18n.CommonLocaleCode));
+        return UtilsI18n.defaultLangLocale;
+    })();
+    private _currentGlobalLanguage = this
+        .defaultLangLocale as UtilsI18n.CommonLocaleCode;
+    public get currentGlobalLanguage(): UtilsI18n.CommonLocaleCode {
+        return this._currentGlobalLanguage;
+    }
+    public set currentGlobalLanguage(v: UtilsI18n.CommonLocaleCode) {
+        this._currentGlobalLanguage = v;
+        this.currentGlobalLanguageSrc.next(v);
+    }
+    private currentGlobalLanguageSrc = new BehaviorSubject(this.currentGlobalLanguage);
+    public readonly currentGlobalLanguage$ = this.currentGlobalLanguageSrc
+        .asObservable()
+        .pipe(tap(currentGlobalLanguage => {
+        GlobalStorage.set<UtilsI18n.CommonLocaleCode>(globalStorageKeyMainLanguage, currentGlobalLanguage);
+    }));
+    public availableLangs = _.cloneDeep(UtilsI18n.LangOptionArr);
+    private availableLangsSrc = new BehaviorSubject(this.availableLangs);
+    public readonly availableLangs$ = this.availableLangsSrc.asObservable().pipe(map(f => {
+        if (this.visibleLanguages.length > 0) {
+            return f.filter(a => this.visibleLanguages.includes(a.code));
+        }
+        return f;
+    }));
+    public _visibleLanguages: UtilsI18n.CommonLocaleCode[] = [];
+    public get visibleLanguages(): UtilsI18n.CommonLocaleCode[] {
+        return this._visibleLanguages;
+    }
+    public set visibleLanguages(v: UtilsI18n.CommonLocaleCode[]) {
+        if (this.pernamentLanguage) {
+            v = v.filter(a => [this.pernamentLanguage].includes(a));
+        }
+        this._visibleLanguages = v;
+        this.visibleLanguagesSrc.next(v);
+        this.availableLangsSrc.next(this.availableLangs);
+    }
+    private visibleLanguagesSrc = new BehaviorSubject(this.visibleLanguages);
+    public readonly visibleLanguages$ = this.visibleLanguagesSrc.asObservable();
+    private loadingLangsSubjectSrc = new BehaviorSubject(false);
+    public readonly isLoadingLangs$ = this.loadingLangsSubjectSrc.asObservable();
+    private static _instance: TranslationManager;
+    static get Instance(): TranslationManager {
+        if (!this._instance) {
+            this._instance = new TranslationManager();
+        }
+        return this._instance;
+    }
+    public readonly pernamentLanguage: UtilsI18n.CommonLocaleCode | null = null;
+    public setOneLanguagePernament(lang: UtilsI18n.CommonLocaleCode): void {
+        console.info(`Setting pernament language to ${lang}`);
+        if (this.pernamentLanguage) {
+            console.log('You are trying to set again pernament language');
+            return;
+        }
+        this.visibleLanguages = [lang];
+        this.pernamentLanguage = lang;
+        void this.changeGlobalLang(lang);
+    }
+    async changeGlobalLang(lang: UtilsI18n.CommonLocaleCode): Promise<void> {
+        this.loadingLangsSubjectSrc.next(true);
+        this.currentGlobalLanguage = lang;
+        localStorage.setItem(globalTaonLanguageLocalKeyLocalStor, lang);
+        try {
+            await Promise.all([...this.instances].map(c => c.useGlobalFileLang()));
+        }
+        catch (error) {
+            console.error(error);
+        }
+        this.loadingLangsSubjectSrc.next(false);
+    }
+}

package/ts-source/browser-code/translation.models.ts

@@ -0,0 +1,32 @@
+// @ts-nocheck
+/* ============================================================================
+
+- TAON READONLY SOURCE
+- DO NOT MODIFY THIS FILE.
+- Changes may be overwritten.
+- Use command: taon build:lib:watch
+  inside @taon-dev/i18n project repository
+  for watch development of third party modules like this.
+  
+ * ========================================================================== */
+
+import { UtilsI18n } from 'tnp-core/browser';
+import type { Translation } from './translation';
+export type TranslationLookup = Record<string, string>;
+export type TranslationParams = Record<string, unknown> | null;
+type FileRelativeLocation = string;
+export type TaonTranslationsMapImport = Record<FileRelativeLocation, {
+    [lang in UtilsI18n.CommonLocaleCode]?: () => Promise<UtilsI18n.GettextFile>;
+}>;
+export type TaonTranslationsMap = Record<FileRelativeLocation, {
+    [lang in UtilsI18n.CommonLocaleCode]?: UtilsI18n.GettextFile;
+}>;
+export interface TranslationBinding {
+    text: string;
+    params?: TranslationParams;
+    context?: string;
+    update(value: string): void;
+}
+export interface Translatable {
+    t: Translation;
+}