@flusys/ng-localization 4.0.0-rc

package/types/flusys-ng-localization.d.ts

@@ -0,0 +1,506 @@
+import * as _angular_core from '@angular/core';
+import { InjectionToken, Signal, Provider, OnInit } from '@angular/core';
+import { IListResponse, ISingleResponse, IMessageResponse } from '@flusys/ng-shared';
+import { Observable } from 'rxjs';
+import * as _flusys_ng_localization from '@flusys/ng-localization';
+import { Routes } from '@angular/router';
+import * as _angular_forms_signals from '@angular/forms/signals';
+
+interface ILanguage {
+    id: string;
+    code: string;
+    name: string;
+    nativeName: string | null;
+    direction: 'ltr' | 'rtl' | null;
+    isActive: boolean;
+    isDefault: boolean;
+    serial: number | null;
+    createdAt: string;
+    updatedAt: string;
+}
+type ITranslationsMap = Record<string, string>;
+
+type LocalizationLoadStrategy = 'all' | 'modules';
+/** Localization system configuration */
+interface ILocalizationConfig {
+    /** Default language code (e.g., 'en', 'ar') */
+    defaultLanguageCode: string;
+    /** Translation loading strategy (default: 'modules') */
+    loadStrategy?: LocalizationLoadStrategy;
+    /** Modules to load at app initialization (default: []) */
+    initialModules?: string[];
+    /** Show language selector in layout (default: false) */
+    enableLayoutSelector?: boolean;
+}
+declare const LOCALIZATION_CONFIG: InjectionToken<ILocalizationConfig>;
+/** Get localization config with sensible defaults applied */
+declare function getLocalizationConfig(overrides?: Partial<ILocalizationConfig>): ILocalizationConfig;
+
+interface ITranslationKey {
+    id: string;
+    module: string;
+    key: string;
+    defaultMessage: string;
+    description: string | null;
+    variables: string[] | null;
+    isActive: boolean;
+    isReadonly: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+
+interface ITranslation {
+    id: string;
+    languageId: string;
+    translationKeyId: string;
+    value: string;
+    isVerified: boolean;
+    isActive: boolean;
+    language?: ILanguage;
+    translationKey?: ITranslationKey;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ITranslationWithKey extends ITranslation {
+    translationKey: ITranslationKey;
+}
+
+declare const STORAGE_KEYS: {
+    readonly CURRENT_LANGUAGE: "flusys.language";
+};
+
+declare const LOCALIZATION_MESSAGES: Record<string, string>;
+
+declare class LocalizationStateService {
+    private readonly platformId;
+    private readonly document;
+    private readonly appRef;
+    private readonly primeNG;
+    private readonly _loadedModules;
+    private readonly _moduleFallbacks;
+    private readonly isBrowser;
+    private readonly _currentLanguage;
+    private readonly _availableLanguages;
+    private readonly _translations;
+    private readonly _fallbackMessages;
+    private readonly _isLoading;
+    private readonly _isInitialized;
+    readonly currentLanguage: _angular_core.Signal<ILanguage | null>;
+    readonly availableLanguages: _angular_core.Signal<ILanguage[]>;
+    readonly translations: _angular_core.Signal<ITranslationsMap>;
+    readonly fallbackMessages: _angular_core.Signal<ITranslationsMap>;
+    readonly isLoading: _angular_core.Signal<boolean>;
+    readonly isInitialized: _angular_core.Signal<boolean>;
+    readonly currentLanguageCode: _angular_core.Signal<string>;
+    readonly isRtl: _angular_core.Signal<boolean>;
+    constructor();
+    private dotToCamel;
+    private syncPrimeNGTranslations;
+    setCurrentLanguage(language: ILanguage): void;
+    setAvailableLanguages(languages: ILanguage[]): void;
+    setTranslations(translations: ITranslationsMap): void;
+    mergeTranslations(translations: ITranslationsMap): void;
+    setLoading(loading: boolean): void;
+    setInitialized(initialized: boolean): void;
+    getSavedLanguageCode(): string | null;
+    isModuleLoaded(module: string): boolean;
+    markModuleLoaded(module: string): void;
+    getLoadedModules(): string[];
+    clearLoadedModules(): void;
+    registerModuleFallbacks(module: string, messages: ITranslationsMap): void;
+    hasModuleFallbacks(module: string): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LocalizationStateService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<LocalizationStateService>;
+}
+
+declare class LocalizationApiService {
+    private readonly http;
+    private readonly appConfig;
+    private get baseUrl();
+    getActiveLanguages(): Observable<IListResponse<ILanguage>>;
+    getTranslationsByLanguage(languageCode: string, modules?: string[]): Observable<ISingleResponse<ITranslationsMap>>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LocalizationApiService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<LocalizationApiService>;
+}
+
+declare class LocalizationInitializerService {
+    private readonly config;
+    private readonly apiService;
+    private readonly stateService;
+    initialize(): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LocalizationInitializerService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<LocalizationInitializerService>;
+}
+
+declare class TranslateService {
+    private readonly localizationState;
+    private readonly localizationConfig;
+    readonly languageCode: Signal<string>;
+    translate(key: string, params?: Record<string, string | number>): string;
+    translateSignal(key: string, params?: Record<string, string | number>): Signal<string>;
+    instant(key: string, params?: Record<string, string | number>): string;
+    private interpolate;
+    private getFromFallback;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TranslateService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<TranslateService>;
+}
+
+declare class TranslationLoaderService {
+    private readonly DEFAULT_INITIAL_MODULES;
+    private readonly config;
+    private readonly apiService;
+    private readonly stateService;
+    loadTranslations(languageCode: string, clearModules?: boolean): Promise<void>;
+    private loadAndSetTranslations;
+    loadModulesOnDemand(languageCode: string, modules: string[]): Promise<void>;
+    private reloadModules;
+    loadTranslationsAsync(languageCode: string, clearModules?: boolean): Observable<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TranslationLoaderService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<TranslationLoaderService>;
+}
+
+interface ICreateLanguageDto {
+    code: string;
+    name: string;
+    nativeName?: string;
+    direction?: 'ltr' | 'rtl';
+    isActive?: boolean;
+    isDefault?: boolean;
+    serial?: number;
+}
+interface IUpdateLanguageDto extends Partial<ICreateLanguageDto> {
+    id: string;
+}
+declare class LanguageApiService {
+    private readonly http;
+    private readonly appConfig;
+    private get baseUrl();
+    getAll(): Observable<IListResponse<ILanguage>>;
+    getById(id: string): Observable<ISingleResponse<ILanguage>>;
+    create(dto: ICreateLanguageDto): Observable<ISingleResponse<ILanguage>>;
+    update(dto: IUpdateLanguageDto): Observable<ISingleResponse<ILanguage>>;
+    delete(id: string): Observable<IMessageResponse>;
+    setDefault(id: string): Observable<ISingleResponse<ILanguage>>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LanguageApiService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<LanguageApiService>;
+}
+
+interface ICreateTranslationKeyDto {
+    module: string;
+    key: string;
+    defaultMessage: string;
+    description?: string;
+    variables?: string[];
+    isActive?: boolean;
+}
+interface IUpdateTranslationKeyDto extends Partial<ICreateTranslationKeyDto> {
+    id: string;
+}
+interface ITranslationKeyFilter {
+    module?: string;
+    isActive?: boolean;
+    search?: string;
+}
+declare class TranslationKeyApiService {
+    private readonly http;
+    private readonly appConfig;
+    private get baseUrl();
+    getAll(filter?: ITranslationKeyFilter): Observable<IListResponse<ITranslationKey>>;
+    getByModule(module: string): Observable<IListResponse<ITranslationKey>>;
+    getModules(): Observable<ISingleResponse<string[]>>;
+    getById(id: string): Observable<ISingleResponse<ITranslationKey>>;
+    create(dto: ICreateTranslationKeyDto): Observable<ISingleResponse<ITranslationKey>>;
+    createMany(dtos: ICreateTranslationKeyDto[]): Observable<IListResponse<ITranslationKey>>;
+    update(dto: IUpdateTranslationKeyDto): Observable<ISingleResponse<ITranslationKey>>;
+    delete(id: string): Observable<IMessageResponse>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TranslationKeyApiService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<TranslationKeyApiService>;
+}
+
+interface ICreateTranslationDto {
+    languageId: string;
+    translationKeyId: string;
+    value: string;
+    isVerified?: boolean;
+    isActive?: boolean;
+}
+interface IUpdateTranslationDto extends Partial<ICreateTranslationDto> {
+    id: string;
+}
+interface IBulkUpdateTranslationDto {
+    id?: string;
+    languageId: string;
+    translationKeyId: string;
+    value: string;
+    isVerified?: boolean;
+}
+declare class TranslationApiService {
+    private readonly http;
+    private readonly appConfig;
+    private get baseUrl();
+    getByLanguageId(languageId: string): Observable<IListResponse<ITranslationWithKey>>;
+    getByModuleAndLanguageId(module: string, languageId: string): Observable<IListResponse<ITranslationWithKey>>;
+    getById(id: string): Observable<ISingleResponse<ITranslation>>;
+    create(dto: ICreateTranslationDto): Observable<ISingleResponse<ITranslation>>;
+    update(dto: IUpdateTranslationDto): Observable<ISingleResponse<ITranslation>>;
+    bulkUpdate(translations: IBulkUpdateTranslationDto[]): Observable<IListResponse<ITranslation>>;
+    delete(id: string): Observable<IMessageResponse>;
+    getByKeyId(translationKeyId: string): Observable<IListResponse<ITranslation>>;
+    getCounts(): Observable<ISingleResponse<Record<string, number>>>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TranslationApiService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<TranslationApiService>;
+}
+
+declare class LanguageSelectorComponent {
+    private readonly localizationState;
+    private readonly translationLoader;
+    private readonly destroyRef;
+    private readonly document;
+    private readonly elementRef;
+    readonly languages: _angular_core.Signal<_flusys_ng_localization.ILanguage[]>;
+    private readonly _isActive;
+    readonly isActive: _angular_core.Signal<boolean>;
+    readonly selectedLanguageCode: _angular_core.Signal<string>;
+    readonly selectedLanguage: _angular_core.Signal<_flusys_ng_localization.ILanguage | null>;
+    constructor();
+    togglePanel(): void;
+    onLanguageSelect(code: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LanguageSelectorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<LanguageSelectorComponent, "lib-language-selector", never, {}, {}, never, never, true, never>;
+}
+
+declare function provideLocalization(config: ILocalizationConfig): Provider[];
+
+declare const LOCALIZATION_ROUTES: Routes;
+
+interface ITab {
+    id: string;
+    labelKey: string;
+    icon: string;
+    route: string;
+    permission: string;
+}
+declare class LocalizationContainerPage {
+    private readonly permissionValidator;
+    private readonly allTabs;
+    readonly visibleTabs: _angular_core.Signal<ITab[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LocalizationContainerPage, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<LocalizationContainerPage, "lib-localization-container", never, {}, {}, never, never, true, never>;
+}
+
+declare class LanguageListPage implements OnInit {
+    readonly LANGUAGE_PERMISSIONS: {
+        readonly CREATE: "language.create";
+        readonly READ: "language.read";
+        readonly UPDATE: "language.update";
+        readonly DELETE: "language.delete";
+    };
+    private readonly router;
+    private readonly languageService;
+    private readonly confirmationService;
+    private readonly messageService;
+    private readonly translateService;
+    private readonly destroyRef;
+    readonly isLoading: _angular_core.WritableSignal<boolean>;
+    readonly languages: _angular_core.WritableSignal<ILanguage[]>;
+    ngOnInit(): void;
+    onCreate(): void;
+    onEdit(id: string): void;
+    loadLanguages(): void;
+    onSetDefault(lang: ILanguage): void;
+    onDelete(lang: ILanguage): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LanguageListPage, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<LanguageListPage, "lib-language-list-page", never, {}, {}, never, never, true, never>;
+}
+
+interface ILanguageFormModel {
+    code: string;
+    name: string;
+    nativeName: string;
+    direction: 'ltr' | 'rtl';
+    serial: string;
+    isActive: boolean;
+    isDefault: boolean;
+}
+declare class LanguageFormPage {
+    private readonly router;
+    private readonly route;
+    private readonly languageService;
+    private readonly messageService;
+    private readonly translateAdapter;
+    private readonly destroyRef;
+    private readonly routeParams;
+    private loadTriggered;
+    readonly isSaving: _angular_core.WritableSignal<boolean>;
+    readonly existingLanguage: _angular_core.WritableSignal<ILanguage | null>;
+    readonly isEditMode: _angular_core.Signal<boolean>;
+    private translate;
+    readonly directionOptions: _angular_core.Signal<{
+        label: string;
+        value: string;
+    }[]>;
+    readonly formModel: _angular_core.WritableSignal<ILanguageFormModel>;
+    readonly formTree: _angular_forms_signals.FieldTree<ILanguageFormModel, string | number>;
+    readonly isFormValid: _angular_core.Signal<boolean>;
+    constructor();
+    updateDirection(value: 'ltr' | 'rtl'): void;
+    loadLanguage(id: string): void;
+    private toFormModel;
+    onSubmit(): void;
+    onCancel(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LanguageFormPage, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<LanguageFormPage, "lib-language-form-page", never, {}, {}, never, never, true, never>;
+}
+
+declare class TranslationKeyListPage implements OnInit {
+    readonly TRANSLATION_KEY_PERMISSIONS: {
+        readonly CREATE: "translation-key.create";
+        readonly READ: "translation-key.read";
+        readonly UPDATE: "translation-key.update";
+        readonly DELETE: "translation-key.delete";
+    };
+    private readonly router;
+    private readonly languageService;
+    private readonly translationKeyService;
+    private readonly translationService;
+    private readonly confirmationService;
+    private readonly messageService;
+    private readonly translateService;
+    private readonly destroyRef;
+    readonly isLoading: _angular_core.WritableSignal<boolean>;
+    readonly languages: _angular_core.WritableSignal<ILanguage[]>;
+    readonly modules: _angular_core.WritableSignal<string[]>;
+    readonly translationKeys: _angular_core.WritableSignal<ITranslationKey[]>;
+    readonly translationCounts: _angular_core.WritableSignal<Map<string, number>>;
+    readonly selectedModule: _angular_core.WritableSignal<string | null>;
+    readonly searchTerm: _angular_core.WritableSignal<string>;
+    readonly moduleOptions: _angular_core.Signal<({
+        label: string;
+        value: string;
+    } | {
+        label: string;
+        value: null;
+    })[]>;
+    readonly filteredKeys: _angular_core.Signal<ITranslationKey[]>;
+    ngOnInit(): void;
+    loadData(): void;
+    loadTranslationCounts(): void;
+    getTranslationCount(keyId: string): number;
+    onModuleChange(value: string | null): void;
+    onCreate(): void;
+    onEdit(key: ITranslationKey): void;
+    onDelete(key: ITranslationKey): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TranslationKeyListPage, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TranslationKeyListPage, "lib-translation-key-list-page", never, {}, {}, never, never, true, never>;
+}
+
+interface ITranslationValue {
+    languageId: string;
+    value: string;
+    translationId?: string;
+}
+interface ITranslationKeyFormModel {
+    key: string;
+    module: string;
+    defaultMessage: string;
+    description: string;
+    variables: string;
+}
+declare class TranslationKeyFormPage implements OnInit {
+    private readonly router;
+    private readonly route;
+    private readonly languageService;
+    private readonly translationKeyService;
+    private readonly translationService;
+    private readonly messageService;
+    private readonly translateAdapter;
+    private readonly destroyRef;
+    private readonly routeParams;
+    private loadTriggered;
+    readonly isSaving: _angular_core.WritableSignal<boolean>;
+    readonly isLoadingLanguages: _angular_core.WritableSignal<boolean>;
+    readonly existingKey: _angular_core.WritableSignal<ITranslationKey | null>;
+    readonly isEditMode: _angular_core.Signal<boolean>;
+    readonly languages: _angular_core.WritableSignal<ILanguage[]>;
+    readonly modules: _angular_core.WritableSignal<string[]>;
+    readonly translations: _angular_core.WritableSignal<ITranslationValue[]>;
+    private translate;
+    readonly moduleOptions: _angular_core.Signal<{
+        label: string;
+        value: string;
+    }[]>;
+    readonly formModel: _angular_core.WritableSignal<ITranslationKeyFormModel>;
+    readonly formTree: _angular_forms_signals.FieldTree<ITranslationKeyFormModel, string | number>;
+    readonly isFormValid: _angular_core.Signal<boolean>;
+    constructor();
+    ngOnInit(): void;
+    loadInitialData(): void;
+    initializeTranslations(languages: ILanguage[]): void;
+    updateModule(value: string): void;
+    getTranslationValue(languageId: string): string;
+    setTranslationValue(languageId: string, value: string): void;
+    loadTranslationKey(id: string): void;
+    loadExistingTranslations(keyId: string): void;
+    private toFormModel;
+    onSubmit(): void;
+    private createKey;
+    private updateKey;
+    private saveTranslations;
+    private onSaveSuccess;
+    onCancel(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TranslationKeyFormPage, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TranslationKeyFormPage, "lib-translation-key-form-page", never, {}, {}, never, never, true, never>;
+}
+
+interface ITranslationRow {
+    translationKey: ITranslationKey;
+    translation: ITranslationWithKey | null;
+    editValue: string;
+    isVerified: boolean;
+    isDirty: boolean;
+}
+declare class TranslationListPage implements OnInit {
+    private readonly languageService;
+    private readonly translationKeyService;
+    private readonly translationService;
+    private readonly messageService;
+    private readonly translateService;
+    private readonly destroyRef;
+    readonly isLoading: _angular_core.WritableSignal<boolean>;
+    readonly isSaving: _angular_core.WritableSignal<boolean>;
+    readonly languages: _angular_core.WritableSignal<ILanguage[]>;
+    readonly modules: _angular_core.WritableSignal<string[]>;
+    readonly translationRows: _angular_core.WritableSignal<ITranslationRow[]>;
+    readonly selectedModule: _angular_core.WritableSignal<string | null>;
+    readonly selectedLanguageId: _angular_core.WritableSignal<string | null>;
+    readonly searchTerm: _angular_core.WritableSignal<string>;
+    readonly moduleOptions: _angular_core.Signal<({
+        label: string;
+        value: string;
+    } | {
+        label: string;
+        value: null;
+    })[]>;
+    readonly paginationTemplate: _angular_core.Signal<string>;
+    readonly languageOptions: _angular_core.Signal<{
+        label: string;
+        value: string;
+    }[]>;
+    readonly filteredRows: _angular_core.Signal<ITranslationRow[]>;
+    readonly hasChanges: _angular_core.Signal<boolean>;
+    readonly changedCount: _angular_core.Signal<number>;
+    formatVariable(v: string): string;
+    ngOnInit(): void;
+    loadInitialData(): void;
+    onModuleChange(value: string | null): void;
+    onLanguageChange(value: string | null): void;
+    loadTranslations(): void;
+    onValueChange(row: ITranslationRow): void;
+    onVerifiedChange(row: ITranslationRow): void;
+    saveChanges(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TranslationListPage, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TranslationListPage, "lib-translation-list-page", never, {}, {}, never, never, true, never>;
+}
+
+export { LOCALIZATION_CONFIG, LOCALIZATION_MESSAGES, LOCALIZATION_ROUTES, LanguageApiService, LanguageFormPage, LanguageListPage, LanguageSelectorComponent, LocalizationApiService, LocalizationContainerPage, LocalizationInitializerService, LocalizationStateService, STORAGE_KEYS, TranslateService, TranslationApiService, TranslationKeyApiService, TranslationKeyFormPage, TranslationKeyListPage, TranslationListPage, TranslationLoaderService, getLocalizationConfig, provideLocalization };
+export type { IBulkUpdateTranslationDto, ICreateLanguageDto, ICreateTranslationDto, ICreateTranslationKeyDto, ILanguage, ILocalizationConfig, ITranslation, ITranslationKey, ITranslationKeyFilter, ITranslationWithKey, ITranslationsMap, IUpdateLanguageDto, IUpdateTranslationDto, IUpdateTranslationKeyDto, LocalizationLoadStrategy };