@siemens/element-translate-ng 47.9.0 → 48.0.0-next.2

package/translate/index.d.ts

@@ -1,15 +1,222 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, PipeTransform, OnDestroy, Injector, Provider } from '@angular/core';
+import { Observable } from 'rxjs';
+import { TranslatableString } from '@siemens/element-translate-ng/translate-types';
+export * from '@siemens/element-translate-ng/translate-types';
+
 /**
  * Copyright (c) Siemens 2016 - 2025
  * SPDX-License-Identifier: MIT
  */
-export * from './si-translatable.model';
-export * from './si-translate.module';
-export * from './si-translate.service';
-export * from './si-translate.service-builder';
-export * from './si-no-translate.service';
-export * from './si-translate.pipe';
-export * from './si-localize';
-export * from './si-translate.service';
-export * from './testing/si-translate.mock-service-builder.factory';
-export * from '@siemens/element-translate-ng/translate-types';
-export * from './si-translate.inject';
+
+declare const SI_TRANSLATABLE_VALUES: InjectionToken<Record<string, string>[]>;
+
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * Translates keys by using the {@link SiTranslateService}.
+ * Within Element this pipe should be used instead of ngx-translates `translate` pipe.
+ * Outside Element, this pipe should NOT be used.
+ *
+ * @internal
+ */
+declare class SiTranslatePipe implements PipeTransform, OnDestroy {
+    private lastKeyParams?;
+    private value;
+    private subscription?;
+    private siTranslateService;
+    private cdRef;
+    /**
+     * Method which is called on any data passed to the pipe.
+     * Called by Angular, should not be called directly.
+     */
+    transform(key: string, params?: any): string;
+    transform(key: string | null | undefined, params?: any): string | null | undefined;
+    ngOnDestroy(): void;
+    private updateValue;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslatePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SiTranslatePipe, "translate", true>;
+}
+
+/**
+ * This provides declares SiTranslatePipe and provides a respective SiTranslateService.
+ * It should be used internally of Element but NOT by any application.
+ *
+ * @deprecated This module is no longer needed.
+ * Replace it with the {@link SiTranslatePipe} if needed, otherwise drop it without replacement.
+ *
+ * @internal
+ */
+declare class SiTranslateModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslateModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SiTranslateModule, never, [typeof SiTranslatePipe], [typeof SiTranslatePipe]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<SiTranslateModule>;
+}
+
+type TranslationResult<T> = T extends string ? string : Record<string, string>;
+/**
+ * @returns The culture language code of the browser, e.g. "en-US".
+ */
+declare const getBrowserCultureLanguage: () => string | undefined;
+/**
+ * @returns The language code of the browser, e.g. "en".
+ */
+declare const getBrowserLanguage: () => string | undefined;
+/**
+ * Wrapper around an actual translation framework which is meant to be used internally by Element.
+ * Applications must not use this service.
+ *
+ * Use {@link injectSiTranslateService} to get an instance of the translation service.
+ *
+ * @internal
+ */
+declare abstract class SiTranslateService {
+    protected translationChange$: Observable<void>;
+    private documentRef;
+    prevent$LocalizeInit?: boolean;
+    /**
+     * The currently used language.
+     */
+    abstract get currentLanguage(): string;
+    /**
+     * Sets a new language to be used. If needed, loads the language file.
+     * @param lang - The language to be used.
+     * @returns An observable that emits when the new language is loaded and activated.
+     */
+    abstract setCurrentLanguage(lang: string): Observable<void>;
+    /**
+     * The language to be used as default.
+     * @param lang - The language code.
+     */
+    abstract setDefaultLanguage(lang: string): void;
+    /**
+     * The language to be used as default.
+     * @returns The code of the default language.
+     */
+    abstract getDefaultLanguage(): string;
+    /**
+     * The available languages.
+     */
+    abstract get availableLanguages(): string[];
+    abstract set availableLanguages(languages: string[]);
+    /**
+     * If the underlying translation library supports switching the language
+     * and/or updating the translation texts, this observable will emit.
+     * There is no initial emit.
+     */
+    get translationChange(): Observable<void>;
+    /**
+     * Translates the key(s) by using the underlying translation library.
+     *
+     * @param keys - A single translation key or an array of keys.
+     * @param params - Parameters to be replaced within the translation text.
+     *
+     * @returns Returns the translated key or an object with the translated keys.
+     * Depending on the underlying translation library (sync/async) the result will
+     * be wrapped in an Observable.
+     */
+    abstract translate<T extends string | string[]>(keys: T, params?: Record<string, unknown>): Observable<TranslationResult<T>> | TranslationResult<T>;
+    /**
+     * Translates the key(s) by using the underlying translation library in an asynchronous manner.
+     * It will emit each time the active language is changed.
+     *
+     * @param keys - A single translation key or an array of keys.
+     * @param params - Parameters to be replaced within the translation text.
+     *
+     * @returns Returns the translated key or an object with the translated keys wrapped in an Observable.
+     */
+    abstract translateAsync<T extends string | string[]>(keys: T, params?: Record<string, unknown>): Observable<TranslationResult<T>>;
+    /**
+     * Translates the key(s) by using the underlying translation library in a synchronous manner.
+     *
+     * Warning: The caller of this function needs to make sure the translation file(s) are already loaded.
+     * It is generally not recommended to use this function unless you know exactly what you are doing.
+     *
+     * @param keys - A single translation key or an array of keys.
+     * @param params - Parameters to be replaced within the translation text.
+     *
+     * @returns Returns the translated key or an object with the translated keys.
+     */
+    abstract translateSync<T extends string | string[]>(keys: T, params?: Record<string, unknown>): TranslationResult<T>;
+    /**
+     * If supported by the underlying translation library, this method can be used to add a translation for a specific key.
+     * It is intended to be used for adding the english default value.
+     * It will be called whenever a key within element is resolved.
+     * An implementation of this method must check that it does not override an existing translation.
+     */
+    setTranslation?(key: string, value: string): void;
+    setDocumentLanguage(lang: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslateService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SiTranslateService>;
+}
+
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * Provide this class to build a custom translation service.
+ *
+ * @internal
+ */
+declare abstract class SiTranslateServiceBuilder {
+    /**
+     * Returns a translation service instance.
+     * @param injector - Is used to retrieve dependencies needed to create the translation service.
+     */
+    abstract buildService(injector: Injector): SiTranslateService;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslateServiceBuilder, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SiTranslateServiceBuilder>;
+}
+
+/**
+ * Pass through implementation of the {@link SiTranslateService} which is used as a default.
+ *
+ * @internal
+ */
+declare class SiNoTranslateService extends SiTranslateService {
+    get currentLanguage(): string;
+    get availableLanguages(): string[];
+    set availableLanguages(lang: string[]);
+    setCurrentLanguage(lang: string): Observable<void>;
+    getDefaultLanguage(): string;
+    setDefaultLanguage(lang: string): void;
+    translate<T extends string | string[]>(keys: T, _params?: Record<string, unknown>): TranslationResult<T>;
+    translateSync<T extends string | string[]>(keys: T, params?: Record<string, unknown>): TranslationResult<T>;
+    translateAsync<T extends string | string[]>(keys: T, params?: Record<string, unknown>): Observable<TranslationResult<T>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiNoTranslateService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SiNoTranslateService>;
+}
+
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+
+declare const provideMockTranslateServiceBuilder: (buildService: (injector: Injector) => SiTranslateService) => Provider;
+
+declare const injectSiTranslateService: () => SiTranslateService;
+
+/**
+ * Always wrap `$localize` calls in this function within element components.
+ * It may patch the global $localize based on the current translation framework.
+ *
+ * This function requires an `InjectionContext.`
+ *
+ * @internal
+ *
+ * @example
+ * ```ts
+ * class MyComponent {
+ *   readonly myText = t(() => $localize`:@@my-text:This is a default text`);
+ * }
+ * ```
+ */
+declare const t: (localizeWrapperFunction: () => string) => TranslatableString;
+
+export { SI_TRANSLATABLE_VALUES, SiNoTranslateService, SiTranslateModule, SiTranslatePipe, SiTranslateService, SiTranslateServiceBuilder, getBrowserCultureLanguage, getBrowserLanguage, injectSiTranslateService, provideMockTranslateServiceBuilder, t };
+export type { TranslationResult };

package/translate-types/index.d.ts

@@ -2,4 +2,19 @@
  * Copyright (c) Siemens 2016 - 2025
  * SPDX-License-Identifier: MIT
  */
-export * from './global.types';
+/**
+ * Empty interface to represent translatable strings before they are translated.
+ * Needed so the TypeScript compiler doesn't strip away the {@link TranslatableString} type.
+ * Ignored by the documentation.
+ * @internal
+ */
+interface Translatable {
+}
+/**
+ * Represents a translatable string. This can either be a translation key, e.g. `ACTIONS.EDIT` that
+ * will be automatically translated when displayed on the UI or a pre-translated string, e.g. `Edit`.
+ * Equivalent to a normal string in usage and functionality.
+ */
+type TranslatableString = string & Translatable;
+
+export type { TranslatableString };

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

@@ -1,12 +0,0 @@
-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

@@ -1,10 +0,0 @@
-import * as i0 from "@angular/core";
-/**
- * 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, never, never>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<SiTranslateNgLocalizeModule>;
-}

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

@@ -1,10 +0,0 @@
-/**
- * Copyright (c) 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

@@ -1,7 +0,0 @@
-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/ngx-translate/si-translate-ngxt.module.d.ts

@@ -1,10 +0,0 @@
-import * as i0 from "@angular/core";
-/**
- * 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`)
- */
-export declare class SiTranslateNgxTModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslateNgxTModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<SiTranslateNgxTModule, never, never, never>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<SiTranslateNgxTModule>;
-}

package/ngx-translate/si-translate-ngxt.provider.d.ts

@@ -1,10 +0,0 @@
-/**
- * Copyright (c) Siemens 2016 - 2025
- * SPDX-License-Identifier: MIT
- */
-import { EnvironmentProviders, Provider } from '@angular/core';
-/**
- * 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`)
- */
-export declare const provideNgxTranslateForElement: () => (EnvironmentProviders | Provider)[];

package/ngx-translate/si-translate-ngxt.service-builder.d.ts

@@ -1,19 +0,0 @@
-/**
- * Copyright (c) Siemens 2016 - 2025
- * SPDX-License-Identifier: MIT
- */
-import { Injector } from '@angular/core';
-import { SiTranslateService, SiTranslateServiceBuilder } from '@siemens/element-translate-ng/translate';
-import * as i0 from "@angular/core";
-/**
- * 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
- */
-export declare class SiTranslateNgxTServiceBuilder extends SiTranslateServiceBuilder {
-    private serviceCache;
-    buildService(injector: Injector): SiTranslateService;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslateNgxTServiceBuilder, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SiTranslateNgxTServiceBuilder>;
-}

package/ngx-translate/si-translate-ngxt.service.d.ts

@@ -1,28 +0,0 @@
-import { TranslateService } from '@ngx-translate/core';
-import { SiTranslateService, TranslationResult } from '@siemens/element-translate-ng/translate';
-import { Observable } from 'rxjs';
-import * as i0 from "@angular/core";
-/**
- * {@link SiTranslateService} wrapper around ngx-translate
- *
- * @internal
- */
-export declare class SiTranslateNgxTService extends SiTranslateService {
-    private ngxTranslateService;
-    private defaultTranslations;
-    private originalMissingHandler;
-    constructor(ngxTranslateService: TranslateService);
-    get currentLanguage(): string;
-    get availableLanguages(): string[];
-    set availableLanguages(languages: string[]);
-    setCurrentLanguage(lang: string): Observable<void>;
-    getDefaultLanguage(): string;
-    setDefaultLanguage(lang: string): void;
-    translate<T extends string | string[]>(keys: T, params?: Record<string, unknown>): Observable<TranslationResult<T>> | TranslationResult<T>;
-    translateAsync<T extends string | string[]>(keys: T, params?: Record<string, unknown>): Observable<TranslationResult<T>>;
-    translateSync<T extends string | string[]>(keys: T, params?: Record<string, unknown>): TranslationResult<T>;
-    setTranslation(key: string, value: string): void;
-    private handleMissingTranslation;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslateNgxTService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SiTranslateNgxTService>;
-}

package/public-api.d.ts

@@ -1,8 +0,0 @@
-/**
- * Copyright (c) Siemens 2016 - 2025
- * SPDX-License-Identifier: MIT
- */
-export * from '@siemens/element-translate-ng/angular-localize';
-export * from '@siemens/element-translate-ng/ngx-translate';
-export * from '@siemens/element-translate-ng/translate';
-export * from '@siemens/element-translate-ng/translate-types';

package/translate/global.scope.d.ts

@@ -1,8 +0,0 @@
-/**
- * This var provides access to the global scope object based on the current runtime.
- * On Browser its is the window, on Node.js it is global.
- *
- * Whenever possible, inject(DOCUMENT) is preferred over this approach.
- */
-declare let globalScope: any;
-export { globalScope };

package/translate/si-localize.d.ts

@@ -1,2 +0,0 @@
-/** @deprecated $localize is now automatically initialized. Drop all calls of this function. */
-export declare const initSiLocalize: () => void;

package/translate/si-no-translate.service-builder.d.ts

@@ -1,14 +0,0 @@
-import { SiTranslateService } from './si-translate.service';
-import { SiTranslateServiceBuilder } from './si-translate.service-builder';
-import * as i0 from "@angular/core";
-/**
- * Always returns the same instance of {@link SiNoTranslateService}
- *
- * @internal
- */
-export declare class SiNoTranslateServiceBuilder extends SiTranslateServiceBuilder {
-    private siNoTranslateService;
-    buildService(): SiTranslateService;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SiNoTranslateServiceBuilder, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SiNoTranslateServiceBuilder>;
-}

package/translate/si-no-translate.service.d.ts

@@ -1,21 +0,0 @@
-import { Observable } from 'rxjs';
-import { SiTranslateService, TranslationResult } from './si-translate.service';
-import * as i0 from "@angular/core";
-/**
- * Pass through implementation of the {@link SiTranslateService} which is used as a default.
- *
- * @internal
- */
-export declare class SiNoTranslateService extends SiTranslateService {
-    get currentLanguage(): string;
-    get availableLanguages(): string[];
-    set availableLanguages(lang: string[]);
-    setCurrentLanguage(lang: string): Observable<void>;
-    getDefaultLanguage(): string;
-    setDefaultLanguage(lang: string): void;
-    translate<T extends string | string[]>(keys: T, _params?: Record<string, unknown>): TranslationResult<T>;
-    translateSync<T extends string | string[]>(keys: T, params?: Record<string, unknown>): TranslationResult<T>;
-    translateAsync<T extends string | string[]>(keys: T, params?: Record<string, unknown>): Observable<TranslationResult<T>>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SiNoTranslateService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SiNoTranslateService>;
-}

package/translate/si-translatable.model.d.ts

@@ -1,6 +0,0 @@
-/**
- * Copyright (c) Siemens 2016 - 2025
- * SPDX-License-Identifier: MIT
- */
-import { InjectionToken } from '@angular/core';
-export declare const SI_TRANSLATABLE_VALUES: InjectionToken<Record<string, string>[]>;

package/translate/si-translatable.service.d.ts

@@ -1,11 +0,0 @@
-import { TranslatableString } from '@siemens/element-translate-ng/translate-types';
-import * as i0 from "@angular/core";
-export declare class SiTranslatableService {
-    private readonly translatableValues;
-    private readonly isNoTranslate;
-    private readonly siTranslateService;
-    constructor();
-    resolveText(key: string, originalText: string): TranslatableString;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslatableService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SiTranslatableService>;
-}

package/translate/si-translate.inject.d.ts

@@ -1,2 +0,0 @@
-import { SiTranslateService } from './si-translate.service';
-export declare const injectSiTranslateService: () => SiTranslateService;

package/translate/si-translate.module.d.ts

@@ -1,16 +0,0 @@
-import * as i0 from "@angular/core";
-import * as i1 from "./si-translate.pipe";
-/**
- * This provides declares SiTranslatePipe and provides a respective SiTranslateService.
- * It should be used internally of Element but NOT by any application.
- *
- * @deprecated This module is no longer needed.
- * Replace it with the {@link SiTranslatePipe} if needed, otherwise drop it without replacement.
- *
- * @internal
- */
-export declare class SiTranslateModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslateModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<SiTranslateModule, never, [typeof i1.SiTranslatePipe], [typeof i1.SiTranslatePipe]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<SiTranslateModule>;
-}

package/translate/si-translate.pipe.d.ts

@@ -1,30 +0,0 @@
-/**
- * Copyright (c) Siemens 2016 - 2025
- * SPDX-License-Identifier: MIT
- */
-import { OnDestroy, PipeTransform } from '@angular/core';
-import * as i0 from "@angular/core";
-/**
- * Translates keys by using the {@link SiTranslateService}.
- * Within Element this pipe should be used instead of ngx-translates `translate` pipe.
- * Outside Element, this pipe should NOT be used.
- *
- * @internal
- */
-export declare class SiTranslatePipe implements PipeTransform, OnDestroy {
-    private lastKeyParams?;
-    private value;
-    private subscription?;
-    private siTranslateService;
-    private cdRef;
-    /**
-     * Method which is called on any data passed to the pipe.
-     * Called by Angular, should not be called directly.
-     */
-    transform(key: string, params?: any): string;
-    transform(key: string | null | undefined, params?: any): string | null | undefined;
-    ngOnDestroy(): void;
-    private updateValue;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslatePipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<SiTranslatePipe, "translate", true>;
-}

package/translate/si-translate.service-builder.d.ts

@@ -1,21 +0,0 @@
-/**
- * Copyright (c) Siemens 2016 - 2025
- * SPDX-License-Identifier: MIT
- */
-import { Injector } from '@angular/core';
-import { SiTranslateService } from './si-translate.service';
-import * as i0 from "@angular/core";
-/**
- * Provide this class to build a custom translation service.
- *
- * @internal
- */
-export declare abstract class SiTranslateServiceBuilder {
-    /**
-     * Returns a translation service instance.
-     * @param injector - Is used to retrieve dependencies needed to create the translation service.
-     */
-    abstract buildService(injector: Injector): SiTranslateService;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslateServiceBuilder, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SiTranslateServiceBuilder>;
-}

package/translate/si-translate.service.d.ts

@@ -1,98 +0,0 @@
-import { Observable } from 'rxjs';
-import * as i0 from "@angular/core";
-export type TranslationResult<T> = T extends string ? string : Record<string, string>;
-/**
- * @returns The culture language code of the browser, e.g. "en-US".
- */
-export declare const getBrowserCultureLanguage: () => string | undefined;
-/**
- * @returns The language code of the browser, e.g. "en".
- */
-export declare const getBrowserLanguage: () => string | undefined;
-/**
- * Wrapper around an actual translation framework which is meant to be used internally by Element.
- * Applications must not use this service.
- *
- * Use {@link injectSiTranslateService} to get an instance of the translation service.
- *
- * @internal
- */
-export declare abstract class SiTranslateService {
-    protected translationChange$: Observable<void>;
-    private documentRef;
-    prevent$LocalizeInit?: boolean;
-    /**
-     * The currently used language.
-     */
-    abstract get currentLanguage(): string;
-    /**
-     * Sets a new language to be used. If needed, loads the language file.
-     * @param lang - The language to be used.
-     * @returns An observable that emits when the new language is loaded and activated.
-     */
-    abstract setCurrentLanguage(lang: string): Observable<void>;
-    /**
-     * The language to be used as default.
-     * @param lang - The language code.
-     */
-    abstract setDefaultLanguage(lang: string): void;
-    /**
-     * The language to be used as default.
-     * @returns The code of the default language.
-     */
-    abstract getDefaultLanguage(): string;
-    /**
-     * The available languages.
-     */
-    abstract get availableLanguages(): string[];
-    abstract set availableLanguages(languages: string[]);
-    /**
-     * If the underlying translation library supports switching the language
-     * and/or updating the translation texts, this observable will emit.
-     * There is no initial emit.
-     */
-    get translationChange(): Observable<void>;
-    /**
-     * Translates the key(s) by using the underlying translation library.
-     *
-     * @param keys - A single translation key or an array of keys.
-     * @param params - Parameters to be replaced within the translation text.
-     *
-     * @returns Returns the translated key or an object with the translated keys.
-     * Depending on the underlying translation library (sync/async) the result will
-     * be wrapped in an Observable.
-     */
-    abstract translate<T extends string | string[]>(keys: T, params?: Record<string, unknown>): Observable<TranslationResult<T>> | TranslationResult<T>;
-    /**
-     * Translates the key(s) by using the underlying translation library in an asynchronous manner.
-     * It will emit each time the active language is changed.
-     *
-     * @param keys - A single translation key or an array of keys.
-     * @param params - Parameters to be replaced within the translation text.
-     *
-     * @returns Returns the translated key or an object with the translated keys wrapped in an Observable.
-     */
-    abstract translateAsync<T extends string | string[]>(keys: T, params?: Record<string, unknown>): Observable<TranslationResult<T>>;
-    /**
-     * Translates the key(s) by using the underlying translation library in a synchronous manner.
-     *
-     * Warning: The caller of this function needs to make sure the translation file(s) are already loaded.
-     * It is generally not recommended to use this function unless you know exactly what you are doing.
-     *
-     * @param keys - A single translation key or an array of keys.
-     * @param params - Parameters to be replaced within the translation text.
-     *
-     * @returns Returns the translated key or an object with the translated keys.
-     */
-    abstract translateSync<T extends string | string[]>(keys: T, params?: Record<string, unknown>): TranslationResult<T>;
-    /**
-     * If supported by the underlying translation library, this method can be used to add a translation for a specific key.
-     * It is intended to be used for adding the english default value.
-     * It will be called whenever a key within element is resolved.
-     * An implementation of this method must check that it does not override an existing translation.
-     */
-    setTranslation?(key: string, value: string): void;
-    setDocumentLanguage(lang: string): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SiTranslateService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SiTranslateService>;
-}

package/translate/testing/si-translate.mock-service-builder.factory.d.ts

@@ -1,7 +0,0 @@
-/**
- * Copyright (c) Siemens 2016 - 2025
- * SPDX-License-Identifier: MIT
- */
-import { Injector, Provider } from '@angular/core';
-import { SiTranslateService } from '../si-translate.service';
-export declare const provideMockTranslateServiceBuilder: (buildService: (injector: Injector) => SiTranslateService) => Provider;

package/translate-types/global.types.d.ts

@@ -1,19 +0,0 @@
-/**
- * Copyright (c) Siemens 2016 - 2025
- * SPDX-License-Identifier: MIT
- */
-/**
- * Empty interface to represent translatable strings before they are translated.
- * Needed so the TypeScript compiler doesn't strip away the {@link TranslatableString} type.
- * Ignored by the documentation.
- * @internal
- */
-interface Translatable {
-}
-/**
- * Represents a translatable string. This can either be a translation key, e.g. `ACTIONS.EDIT` that
- * will be automatically translated when displayed on the UI or a pre-translated string, e.g. `Edit`.
- * Equivalent to a normal string in usage and functionality.
- */
-export type TranslatableString = string & Translatable;
-export {};