@siemens/element-translate-ng 47.0.0

package/LICENSE.md

@@ -0,0 +1,20 @@
+The MIT License
+
+Copyright (c) Siemens 2016 - 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the “Software”), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# Element Translate
+
+`element-translate-ng` is a translation abstraction layer. It can be used with
+
+- `ngx-translate`
+- Angular localize
+- Other frameworks in the future
+
+See [here](https://element.siemens.io/simpl-element/fundamentals/localization/#translation-in-simpl-element)
+for details how it works and how to use it.
+
+## Usage
+
+Install the library as follows:
+
+```sh
+npm install --save @siemens/element-translate-ng
+```
+
+An important part of the library is the extraction of translatable keys as a TypeScript interface
+as well as extracting a JSON messages file with default translations. The extraction happens on
+compiled files. I.e. make sure to run the build first. Then, to run these extractions
+
+```sh
+npx update-translatable-keys
+```
+
+By default, this will pick of the configuration from a file `element-translate.conf.json`. To
+use a different config file, pass as the only argument to the command.
+
+The config file looks like this
+
+```json
+{
+  "files": "dist/@simpl/**/fesm2022/**/*.mjs",
+  "configs": [
+    {
+      "name": "element",
+      "locationPrefix": "projects/element-ng",
+      "keysFile": "projects/element-ng/translate/si-translatable-keys.interface.ts",
+      "keysInterfaceName": "SiTranslatableKeys",
+      "messagesFile": "dist/@siemens/element-ng/template-i18n.json"
+    }
+  ]
+}
+```
+
+- `files` is a glob pattern for defining the files to scan
+- `configs` is an array of configs. For mono-repos building multiple libraries, they can be
+  separated into different configs. All keys are required:
+
+  - `name` is a unique name
+  - `locationsPrefix` defines the path prefix of the source files, important to distinguish
+    between different libraries in a mono-repo
+  - `keysFile` defines the path of the generated TypeScript interfaces file
+  - `keysInterfaceName` defines the name of the TypeScript `interface`
+  - `messagesFile` defines the path of the generated messages JSON file
+
+## Testing
+
+Run `yarn translate:test` to perform the unit tests via [Karma](https://karma-runner.github.io).
+You can set a seed for running the tests in a specific using an environment variable: `SEED=71384 yarn translate:test`
+
+## License
+
+Code and documentation copyright 2024 Siemens AG.
+
+See [LICENSE.md](../../LICENSE.md).

package/angular-localize/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+export * from './si-translate-ng-localize.module';
+export * from './si-translate-ng-localize.provider';

package/angular-localize/package.json

@@ -0,0 +1,3 @@
+{
+  "module": "../fesm2022/siemens-element-translate-ng-angular-localize.mjs"
+}

package/angular-localize/si-translate-ng-localize-service-builder.service.d.ts

@@ -0,0 +1,12 @@
+import { SiTranslateService, SiTranslateServiceBuilder } from '@siemens/element-translate-ng/translate';
+import * as i0 from "@angular/core";
+/**
+ * Similar to the no-translate builder, but this one is not initializing the Element version of $localize,
+ * as it will be provided by angular.
+ */
+export declare class SiTranslateNgLocalizeServiceBuilder extends SiTranslateServiceBuilder {
+    private siTranslateNgService;
+    buildService(): SiTranslateService;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslateNgLocalizeServiceBuilder, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SiTranslateNgLocalizeServiceBuilder>;
+}

package/angular-localize/si-translate-ng-localize.module.d.ts

@@ -0,0 +1,11 @@
+import * as i0 from "@angular/core";
+import * as i1 from "@siemens/element-translate-ng/translate";
+/**
+ * This module configures Element to work with \@angular/localize.
+ * It should only be imported once in an application's root module (typically `app.module.ts`)
+ */
+export declare class SiTranslateNgLocalizeModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslateNgLocalizeModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SiTranslateNgLocalizeModule, never, [typeof i1.SiTranslateModule], never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<SiTranslateNgLocalizeModule>;
+}

package/angular-localize/si-translate-ng-localize.provider.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+import { EnvironmentProviders, Provider } from '@angular/core';
+/**
+ * This provider configures Element to work with \@angular/localize.
+ * It should only be imported once in an application's configuration (typically `app.config.ts`)
+ */
+export declare const provideNgLocalizeForElement: () => (EnvironmentProviders | Provider)[];

package/angular-localize/si-translate-ng-localize.service.d.ts

@@ -0,0 +1,7 @@
+import { SiNoTranslateService } from '@siemens/element-translate-ng/translate';
+import * as i0 from "@angular/core";
+export declare class SiTranslateNgLocalizeService extends SiNoTranslateService {
+    prevent$LocalizeInit: boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslateNgLocalizeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SiTranslateNgLocalizeService>;
+}

package/bin/update-translatable-keys.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+
+/* eslint-disable prefer-arrow/prefer-arrow-functions */
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import { dirname } from 'path';
+
+import { XMLParser } from 'fast-xml-parser';
+
+const configFile = process.argv[2] || './element-translate.conf.json';
+const toolConfig = JSON.parse(fs.readFileSync(configFile));
+
+console.log('Running localize-extract');
+const args = ['-s', toolConfig.files, '-f', 'xlf2', '-o', 'messages.xlf'];
+const extract = spawn('localize-extract', args, {
+  stdio: ['ignore', 'ignore', 'inherit'],
+  shell: true
+});
+extract.on('error', error => console.log(`error: ${error.message}`));
+
+extract.on('close', () => {
+  processMessages();
+  generateFiles();
+  fs.rmSync('messages.xlf');
+});
+
+function prepareConfigs() {
+  for (const config of toolConfig.configs) {
+    config.keys = new Set();
+    config.translations = {};
+  }
+}
+
+function getConfigs(notes) {
+  if (!Array.isArray(notes)) {
+    notes = [notes];
+  }
+  const configs = [];
+  for (const note of notes) {
+    if (note['@_category'] !== 'location') {
+      continue;
+    }
+    const location = note['#text'];
+
+    for (const config of toolConfig.configs) {
+      if (location?.startsWith(config.locationPrefix)) {
+        configs.push(config);
+      }
+    }
+  }
+  return configs;
+}
+
+function processMessages() {
+  console.log('Completed running localize-extract');
+  console.log('Generating translation keys');
+
+  const parser = new XMLParser({ ignoreAttributes: false });
+  const messages = parser.parse(fs.readFileSync('./messages.xlf').toString('utf-8'));
+
+  prepareConfigs();
+
+  for (const unit of messages.xliff.file.unit) {
+    const key = unit['@_id'];
+    const value = unit.segment.source.toString(); // can be number
+
+    // ignore some bogus output
+    if (key.match(/^\d+$/)) {
+      continue;
+    }
+
+    const configs = getConfigs(unit.notes.note);
+    for (const config of configs) {
+      config.keys.add(key);
+      config.translations[key] = value;
+    }
+  }
+}
+
+function generateFiles() {
+  for (const config of toolConfig.configs) {
+    // only update if there are keys found, i.e. don't overwrite when not all libs are build
+    if (!config.keys.size) {
+      console.log(`Skipping ${config.name} since no keys found`);
+      continue;
+    }
+
+    const keys = Array.from(config.keys);
+    keys.sort();
+
+    // for objects, keys are iterated in order they're added, so...
+    const tmp = config.translations;
+    config.translations = {};
+    for (const key of keys) {
+      config.translations[key] = tmp[key];
+    }
+
+    const interfaceLine = keys.map(key => `  '${key}'?: string;`);
+    const interfaceFull = `/* eslint-disable */
+
+// Auto-generated file. Run 'yarn update-translatable-keys' to update.
+
+export interface ${config.keysInterfaceName} {
+${interfaceLine.join('\n')}
+}
+`;
+
+    fs.mkdirSync(dirname(config.keysFile), { recursive: true });
+    fs.writeFileSync(config.keysFile, interfaceFull);
+
+    fs.mkdirSync(dirname(config.messagesFile), { recursive: true });
+    fs.writeFileSync(config.messagesFile, JSON.stringify(config.translations, null, 2));
+
+    console.log(`Completed generating code for ${config.name}:`);
+    console.log(` - ${config.keysFile}`);
+    console.log(` - ${config.messagesFile}`);
+  }
+
+  console.log('Completed generating translation keys');
+}

package/fesm2022/siemens-element-translate-ng-angular-localize.mjs

@@ -0,0 +1,89 @@
+import * as i0 from '@angular/core';
+import { Injectable, inject, NgModule, importProvidersFrom } from '@angular/core';
+import { SiNoTranslateService, SiTranslateServiceBuilder, SiTranslateModule } from '@siemens/element-translate-ng/translate';
+
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+class SiTranslateNgLocalizeService extends SiNoTranslateService {
+    prevent$LocalizeInit = true;
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgLocalizeService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgLocalizeService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgLocalizeService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Similar to the no-translate builder, but this one is not initializing the Element version of $localize,
+ * as it will be provided by angular.
+ */
+class SiTranslateNgLocalizeServiceBuilder extends SiTranslateServiceBuilder {
+    siTranslateNgService = inject(SiTranslateNgLocalizeService);
+    buildService() {
+        return this.siTranslateNgService;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgLocalizeServiceBuilder, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgLocalizeServiceBuilder });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgLocalizeServiceBuilder, decorators: [{
+            type: Injectable
+        }] });
+
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * This module configures Element to work with \@angular/localize.
+ * It should only be imported once in an application's root module (typically `app.module.ts`)
+ */
+class SiTranslateNgLocalizeModule {
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgLocalizeModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
+    static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgLocalizeModule, imports: [SiTranslateModule] });
+    static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgLocalizeModule, providers: [
+            { provide: SiTranslateServiceBuilder, useClass: SiTranslateNgLocalizeServiceBuilder }
+        ], imports: [SiTranslateModule] });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgLocalizeModule, decorators: [{
+            type: NgModule,
+            args: [{
+                    providers: [
+                        { provide: SiTranslateServiceBuilder, useClass: SiTranslateNgLocalizeServiceBuilder }
+                    ],
+                    imports: [SiTranslateModule]
+                }]
+        }] });
+
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * This provider configures Element to work with \@angular/localize.
+ * It should only be imported once in an application's configuration (typically `app.config.ts`)
+ */
+const provideNgLocalizeForElement = () => {
+    return [
+        { provide: SiTranslateServiceBuilder, useClass: SiTranslateNgLocalizeServiceBuilder },
+        importProvidersFrom(SiTranslateModule)
+    ];
+};
+
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { SiTranslateNgLocalizeModule, provideNgLocalizeForElement };
+//# sourceMappingURL=siemens-element-translate-ng-angular-localize.mjs.map

package/fesm2022/siemens-element-translate-ng-angular-localize.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"siemens-element-translate-ng-angular-localize.mjs","sources":["../../../../projects/element-translate-ng/angular-localize/si-translate-ng-localize.service.ts","../../../../projects/element-translate-ng/angular-localize/si-translate-ng-localize-service-builder.service.ts","../../../../projects/element-translate-ng/angular-localize/si-translate-ng-localize.module.ts","../../../../projects/element-translate-ng/angular-localize/si-translate-ng-localize.provider.ts","../../../../projects/element-translate-ng/angular-localize/index.ts","../../../../projects/element-translate-ng/angular-localize/siemens-element-translate-ng-angular-localize.ts"],"sourcesContent":["/**\n * Copyright Siemens 2016 - 2025.\n * SPDX-License-Identifier: MIT\n */\nimport { Injectable } from '@angular/core';\nimport { SiNoTranslateService } from '@siemens/element-translate-ng/translate';\n\n@Injectable({ providedIn: 'root' })\nexport class SiTranslateNgLocalizeService extends SiNoTranslateService {\n  override prevent$LocalizeInit = true;\n}\n","/**\n * Copyright Siemens 2016 - 2025.\n * SPDX-License-Identifier: MIT\n */\nimport { inject, Injectable } from '@angular/core';\nimport {\n  SiTranslateService,\n  SiTranslateServiceBuilder\n} from '@siemens/element-translate-ng/translate';\n\nimport { SiTranslateNgLocalizeService } from './si-translate-ng-localize.service';\n\n/**\n * Similar to the no-translate builder, but this one is not initializing the Element version of $localize,\n * as it will be provided by angular.\n */\n@Injectable()\nexport class SiTranslateNgLocalizeServiceBuilder extends SiTranslateServiceBuilder {\n  private siTranslateNgService = inject(SiTranslateNgLocalizeService);\n\n  override buildService(): SiTranslateService {\n    return this.siTranslateNgService;\n  }\n}\n","/**\n * Copyright Siemens 2016 - 2025.\n * SPDX-License-Identifier: MIT\n */\nimport { NgModule } from '@angular/core';\nimport {\n  SiTranslateModule,\n  SiTranslateServiceBuilder\n} from '@siemens/element-translate-ng/translate';\n\nimport { SiTranslateNgLocalizeServiceBuilder } from './si-translate-ng-localize-service-builder.service';\n\n/**\n * This module configures Element to work with \\@angular/localize.\n * It should only be imported once in an application's root module (typically `app.module.ts`)\n */\n@NgModule({\n  providers: [\n    { provide: SiTranslateServiceBuilder, useClass: SiTranslateNgLocalizeServiceBuilder }\n  ],\n  imports: [SiTranslateModule]\n})\nexport class SiTranslateNgLocalizeModule {}\n","/**\n * Copyright Siemens 2016 - 2025.\n * SPDX-License-Identifier: MIT\n */\nimport { EnvironmentProviders, importProvidersFrom, Provider } from '@angular/core';\nimport {\n  SiTranslateModule,\n  SiTranslateServiceBuilder\n} from '@siemens/element-translate-ng/translate';\n\nimport { SiTranslateNgLocalizeServiceBuilder } from './si-translate-ng-localize-service-builder.service';\n\n/**\n * This provider configures Element to work with \\@angular/localize.\n * It should only be imported once in an application's configuration (typically `app.config.ts`)\n */\nexport const provideNgLocalizeForElement = (): (EnvironmentProviders | Provider)[] => {\n  return [\n    { provide: SiTranslateServiceBuilder, useClass: SiTranslateNgLocalizeServiceBuilder },\n    importProvidersFrom(SiTranslateModule)\n  ];\n};\n","/**\n * Copyright Siemens 2016 - 2025.\n * SPDX-License-Identifier: MIT\n */\nexport * from './si-translate-ng-localize.module';\nexport * from './si-translate-ng-localize.provider';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAAA;;;AAGG;AAKG,MAAO,4BAA6B,SAAQ,oBAAoB,CAAA;IAC3D,oBAAoB,GAAG,IAAI;uGADzB,4BAA4B,EAAA,IAAA,EAAA,IAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA;AAA5B,IAAA,OAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,4BAA4B,cADf,MAAM,EAAA,CAAA;;2FACnB,4BAA4B,EAAA,UAAA,EAAA,CAAA;kBADxC,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE;;;ACPlC;;;AAGG;AASH;;;AAGG;AAEG,MAAO,mCAAoC,SAAQ,yBAAyB,CAAA;AACxE,IAAA,oBAAoB,GAAG,MAAM,CAAC,4BAA4B,CAAC;IAE1D,YAAY,GAAA;QACnB,OAAO,IAAI,CAAC,oBAAoB;;uGAJvB,mCAAmC,EAAA,IAAA,EAAA,IAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA;2GAAnC,mCAAmC,EAAA,CAAA;;2FAAnC,mCAAmC,EAAA,UAAA,EAAA,CAAA;kBAD/C;;;AChBD;;;AAGG;AASH;;;AAGG;MAOU,2BAA2B,CAAA;uGAA3B,2BAA2B,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,QAAA,EAAA,CAAA;AAA3B,IAAA,OAAA,IAAA,GAAA,EAAA,CAAA,mBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,2BAA2B,YAF5B,iBAAiB,CAAA,EAAA,CAAA;AAEhB,IAAA,OAAA,IAAA,GAAA,EAAA,CAAA,mBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,2BAA2B,EAL3B,SAAA,EAAA;AACT,YAAA,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,mCAAmC;AACpF,SAAA,EAAA,OAAA,EAAA,CACS,iBAAiB,CAAA,EAAA,CAAA;;2FAEhB,2BAA2B,EAAA,UAAA,EAAA,CAAA;kBANvC,QAAQ;AAAC,YAAA,IAAA,EAAA,CAAA;AACR,oBAAA,SAAS,EAAE;AACT,wBAAA,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,mCAAmC;AACpF,qBAAA;oBACD,OAAO,EAAE,CAAC,iBAAiB;AAC5B,iBAAA;;;ACrBD;;;AAGG;AASH;;;AAGG;AACI,MAAM,2BAA2B,GAAG,MAA0C;IACnF,OAAO;AACL,QAAA,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,mCAAmC,EAAE;QACrF,mBAAmB,CAAC,iBAAiB;KACtC;AACH;;ACrBA;;;AAGG;;ACHH;;AAEG;;;;"}

package/fesm2022/siemens-element-translate-ng-localize-types.mjs

@@ -0,0 +1,4 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+//# sourceMappingURL=siemens-element-translate-ng-localize-types.mjs.map

package/fesm2022/siemens-element-translate-ng-localize-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"siemens-element-translate-ng-localize-types.mjs","sources":["../../../../projects/element-translate-ng/localize-types/siemens-element-translate-ng-localize-types.ts"],"sourcesContent":["/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"AAAA;;AAEG"}

package/fesm2022/siemens-element-translate-ng-ngx-translate.mjs

@@ -0,0 +1,157 @@
+import * as i0 from '@angular/core';
+import { Injectable, NgModule, importProvidersFrom } from '@angular/core';
+import { SiTranslateService, SiTranslateServiceBuilder, SiTranslateModule } from '@siemens/element-translate-ng/translate';
+import * as i1 from '@ngx-translate/core';
+import { TranslateService } from '@ngx-translate/core';
+import { merge, of } from 'rxjs';
+import { map } from 'rxjs/operators';
+
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * {@link SiTranslateService} wrapper around ngx-translate
+ *
+ * @internal
+ */
+class SiTranslateNgxTService extends SiTranslateService {
+    ngxTranslateService;
+    defaultTranslations = {};
+    originalMissingHandler;
+    constructor(ngxTranslateService) {
+        super();
+        this.ngxTranslateService = ngxTranslateService;
+        this.originalMissingHandler = ngxTranslateService.missingTranslationHandler;
+        ngxTranslateService.missingTranslationHandler = {
+            handle: params => this.handleMissingTranslation(params)
+        };
+        this.translationChange$ = merge(this.ngxTranslateService.onTranslationChange, this.ngxTranslateService.onLangChange).pipe(map(() => { }));
+    }
+    get currentLanguage() {
+        return this.ngxTranslateService.currentLang;
+    }
+    get availableLanguages() {
+        return this.ngxTranslateService.getLangs();
+    }
+    set availableLanguages(languages) {
+        this.ngxTranslateService.addLangs(languages);
+    }
+    setCurrentLanguage(lang) {
+        this.setDocumentLanguage(lang);
+        return this.ngxTranslateService.use(lang).pipe(map(() => { }));
+    }
+    getDefaultLanguage() {
+        return this.ngxTranslateService.getDefaultLang();
+    }
+    setDefaultLanguage(lang) {
+        this.setDocumentLanguage(lang);
+        this.ngxTranslateService.setDefaultLang(lang);
+    }
+    translate(keys, params) {
+        if (Array.isArray(keys) && !keys.length) {
+            return of({});
+        }
+        return this.ngxTranslateService.stream(keys, params);
+    }
+    translateAsync(keys, params) {
+        if (Array.isArray(keys) && !keys.length) {
+            return of({});
+        }
+        return this.ngxTranslateService.stream(keys, params);
+    }
+    translateSync(keys, params) {
+        if (Array.isArray(keys) && !keys.length) {
+            return {};
+        }
+        return this.ngxTranslateService.instant(keys, params);
+    }
+    setTranslation(key, value) {
+        this.defaultTranslations[key] = value;
+    }
+    handleMissingTranslation(params) {
+        return (params.translateService.parser.interpolate(this.defaultTranslations[params.key], params.interpolateParams) ?? this.originalMissingHandler.handle(params));
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgxTService, deps: [{ token: i1.TranslateService }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgxTService });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgxTService, decorators: [{
+            type: Injectable
+        }], ctorParameters: () => [{ type: i1.TranslateService }] });
+
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Builds {@link SiTranslateNgxTService} for each {@link TranslateService}.
+ * The builder will create a new Service if a new {@link TranslateService} is found to support the isolated mode.
+ *
+ * @internal
+ */
+class SiTranslateNgxTServiceBuilder extends SiTranslateServiceBuilder {
+    serviceCache = new Map();
+    buildService(injector) {
+        // Get instance of NGX Translate via injector instance of the current scope (see isolated mode)
+        const ngxTranslateService = injector.get(TranslateService);
+        let ngxTServiceWrapper = this.serviceCache.get(ngxTranslateService);
+        if (!ngxTServiceWrapper) {
+            ngxTServiceWrapper = new SiTranslateNgxTService(ngxTranslateService);
+            this.serviceCache.set(ngxTranslateService, ngxTServiceWrapper);
+        }
+        return ngxTServiceWrapper;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgxTServiceBuilder, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgxTServiceBuilder });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgxTServiceBuilder, decorators: [{
+            type: Injectable
+        }] });
+
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * This module configures Element to use ngx-translate for translating {@link TranslatableString}
+ * It should only be imported once in an applications root module (typically `app.module.ts`)
+ */
+class SiTranslateNgxTModule {
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgxTModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
+    static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgxTModule, imports: [SiTranslateModule] });
+    static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgxTModule, providers: [{ provide: SiTranslateServiceBuilder, useClass: SiTranslateNgxTServiceBuilder }], imports: [SiTranslateModule] });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.6", ngImport: i0, type: SiTranslateNgxTModule, decorators: [{
+            type: NgModule,
+            args: [{
+                    providers: [{ provide: SiTranslateServiceBuilder, useClass: SiTranslateNgxTServiceBuilder }],
+                    imports: [SiTranslateModule]
+                }]
+        }] });
+
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * This provider configures Element to use ngx-translate for translating {@link TranslatableString}
+ * It should only be imported once in an application's configuration (typically `app.config.ts`)
+ */
+const provideNgxTranslateForElement = () => {
+    return [
+        { provide: SiTranslateServiceBuilder, useClass: SiTranslateNgxTServiceBuilder },
+        importProvidersFrom(SiTranslateModule)
+    ];
+};
+
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { SiTranslateNgxTModule, provideNgxTranslateForElement };
+//# sourceMappingURL=siemens-element-translate-ng-ngx-translate.mjs.map

package/fesm2022/siemens-element-translate-ng-ngx-translate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"siemens-element-translate-ng-ngx-translate.mjs","sources":["../../../../projects/element-translate-ng/ngx-translate/si-translate-ngxt.service.ts","../../../../projects/element-translate-ng/ngx-translate/si-translate-ngxt.service-builder.ts","../../../../projects/element-translate-ng/ngx-translate/si-translate-ngxt.module.ts","../../../../projects/element-translate-ng/ngx-translate/si-translate-ngxt.provider.ts","../../../../projects/element-translate-ng/ngx-translate/index.ts","../../../../projects/element-translate-ng/ngx-translate/siemens-element-translate-ng-ngx-translate.ts"],"sourcesContent":["/**\n * Copyright Siemens 2016 - 2025.\n * SPDX-License-Identifier: MIT\n */\nimport { Injectable } from '@angular/core';\nimport {\n  MissingTranslationHandler,\n  MissingTranslationHandlerParams,\n  TranslateService\n} from '@ngx-translate/core';\nimport { SiTranslateService, TranslationResult } from '@siemens/element-translate-ng/translate';\nimport { merge, Observable, of } from 'rxjs';\nimport { map } from 'rxjs/operators';\n\n/**\n * {@link SiTranslateService} wrapper around ngx-translate\n *\n * @internal\n */\n@Injectable()\nexport class SiTranslateNgxTService extends SiTranslateService {\n  private ngxTranslateService: TranslateService;\n  private defaultTranslations: Record<string, string> = {};\n  private originalMissingHandler: MissingTranslationHandler;\n\n  constructor(ngxTranslateService: TranslateService) {\n    super();\n    this.ngxTranslateService = ngxTranslateService;\n    this.originalMissingHandler = ngxTranslateService.missingTranslationHandler;\n    ngxTranslateService.missingTranslationHandler = {\n      handle: params => this.handleMissingTranslation(params)\n    };\n\n    this.translationChange$ = merge(\n      this.ngxTranslateService.onTranslationChange,\n      this.ngxTranslateService.onLangChange\n    ).pipe(map(() => {}));\n  }\n\n  override get currentLanguage(): string {\n    return this.ngxTranslateService.currentLang;\n  }\n\n  override get availableLanguages(): string[] {\n    return this.ngxTranslateService.getLangs();\n  }\n\n  override set availableLanguages(languages: string[]) {\n    this.ngxTranslateService.addLangs(languages);\n  }\n\n  override setCurrentLanguage(lang: string): Observable<void> {\n    this.setDocumentLanguage(lang);\n    return this.ngxTranslateService.use(lang).pipe(map(() => {}));\n  }\n\n  override getDefaultLanguage(): string {\n    return this.ngxTranslateService.getDefaultLang();\n  }\n\n  override setDefaultLanguage(lang: string): void {\n    this.setDocumentLanguage(lang);\n    this.ngxTranslateService.setDefaultLang(lang);\n  }\n\n  override translate<T extends string | string[]>(\n    keys: T,\n    params?: Record<string, unknown>\n  ): Observable<TranslationResult<T>> | TranslationResult<T> {\n    if (Array.isArray(keys) && !keys.length) {\n      return of({} as TranslationResult<T>);\n    }\n    return this.ngxTranslateService.stream(keys, params);\n  }\n\n  override translateAsync<T extends string | string[]>(\n    keys: T,\n    params?: Record<string, unknown>\n  ): Observable<TranslationResult<T>> {\n    if (Array.isArray(keys) && !keys.length) {\n      return of({} as TranslationResult<T>);\n    }\n    return this.ngxTranslateService.stream(keys, params);\n  }\n\n  override translateSync<T extends string | string[]>(\n    keys: T,\n    params?: Record<string, unknown>\n  ): TranslationResult<T> {\n    if (Array.isArray(keys) && !keys.length) {\n      return {} as TranslationResult<T>;\n    }\n    return this.ngxTranslateService.instant(keys, params);\n  }\n\n  override setTranslation(key: string, value: string): void {\n    this.defaultTranslations[key] = value;\n  }\n\n  private handleMissingTranslation(params: MissingTranslationHandlerParams): string {\n    return (\n      params.translateService.parser.interpolate(\n        this.defaultTranslations[params.key],\n        params.interpolateParams\n      ) ?? this.originalMissingHandler.handle(params)\n    );\n  }\n}\n","/**\n * Copyright Siemens 2016 - 2025.\n * SPDX-License-Identifier: MIT\n */\nimport { Injectable, Injector } from '@angular/core';\nimport { TranslateService } from '@ngx-translate/core';\nimport {\n  SiTranslateService,\n  SiTranslateServiceBuilder\n} from '@siemens/element-translate-ng/translate';\n\nimport { SiTranslateNgxTService } from './si-translate-ngxt.service';\n\n/**\n * Builds {@link SiTranslateNgxTService} for each {@link TranslateService}.\n * The builder will create a new Service if a new {@link TranslateService} is found to support the isolated mode.\n *\n * @internal\n */\n@Injectable()\nexport class SiTranslateNgxTServiceBuilder extends SiTranslateServiceBuilder {\n  private serviceCache = new Map<TranslateService, SiTranslateNgxTService>();\n\n  buildService(injector: Injector): SiTranslateService {\n    // Get instance of NGX Translate via injector instance of the current scope (see isolated mode)\n    const ngxTranslateService = injector.get(TranslateService);\n\n    let ngxTServiceWrapper = this.serviceCache.get(ngxTranslateService);\n    if (!ngxTServiceWrapper) {\n      ngxTServiceWrapper = new SiTranslateNgxTService(ngxTranslateService);\n      this.serviceCache.set(ngxTranslateService, ngxTServiceWrapper);\n    }\n\n    return ngxTServiceWrapper;\n  }\n}\n","/**\n * Copyright Siemens 2016 - 2025.\n * SPDX-License-Identifier: MIT\n */\nimport { NgModule } from '@angular/core';\nimport {\n  SiTranslateModule,\n  SiTranslateServiceBuilder\n} from '@siemens/element-translate-ng/translate';\n\nimport { SiTranslateNgxTServiceBuilder } from './si-translate-ngxt.service-builder';\n\n/**\n * This module configures Element to use ngx-translate for translating {@link TranslatableString}\n * It should only be imported once in an applications root module (typically `app.module.ts`)\n */\n@NgModule({\n  providers: [{ provide: SiTranslateServiceBuilder, useClass: SiTranslateNgxTServiceBuilder }],\n  imports: [SiTranslateModule]\n})\nexport class SiTranslateNgxTModule {}\n","/**\n * Copyright Siemens 2016 - 2025.\n * SPDX-License-Identifier: MIT\n */\nimport { EnvironmentProviders, importProvidersFrom, Provider } from '@angular/core';\nimport {\n  SiTranslateModule,\n  SiTranslateServiceBuilder\n} from '@siemens/element-translate-ng/translate';\n\nimport { SiTranslateNgxTServiceBuilder } from './si-translate-ngxt.service-builder';\n\n/**\n * This provider configures Element to use ngx-translate for translating {@link TranslatableString}\n * It should only be imported once in an application's configuration (typically `app.config.ts`)\n */\nexport const provideNgxTranslateForElement = (): (EnvironmentProviders | Provider)[] => {\n  return [\n    { provide: SiTranslateServiceBuilder, useClass: SiTranslateNgxTServiceBuilder },\n    importProvidersFrom(SiTranslateModule)\n  ];\n};\n","/**\n * Copyright Siemens 2016 - 2025.\n * SPDX-License-Identifier: MIT\n */\nexport * from './si-translate-ngxt.module';\nexport * from './si-translate-ngxt.provider';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/siemens-element-translate-ng-translate-types.mjs

@@ -0,0 +1,9 @@
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+//# sourceMappingURL=siemens-element-translate-ng-translate-types.mjs.map

package/fesm2022/siemens-element-translate-ng-translate-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"siemens-element-translate-ng-translate-types.mjs","sources":["../../../../projects/element-translate-ng/translate-types/index.ts","../../../../projects/element-translate-ng/translate-types/siemens-element-translate-ng-translate-types.ts"],"sourcesContent":["/**\n * Copyright Siemens 2016 - 2025.\n * SPDX-License-Identifier: MIT\n */\nexport * from './global.types';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"AAAA;;;AAGG;;ACHH;;AAEG"}