@flusys/ng-shared 3.0.1 → 4.0.0-rc

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

@@ -1,11 +1,12 @@
+import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
 import * as _angular_core from '@angular/core';
-import { Signal, Injector, ResourceRef, model, OnDestroy, ElementRef, TemplateRef, DestroyRef, InjectionToken } from '@angular/core';
+import { Signal, PipeTransform, Provider, Injector, ResourceRef, model, OnDestroy, ElementRef, TemplateRef, DestroyRef, InjectionToken } from '@angular/core';
+import * as i3 from '@angular/router';
+import { ResolveFn, CanActivateFn, Router, ActivatedRoute } from '@angular/router';
 import * as i1 from '@angular/common';
 import * as i2 from '@angular/forms';
 import { ControlValueAccessor } from '@angular/forms';
-import * as i3 from '@angular/router';
-import { CanActivateFn, Router, ActivatedRoute } from '@angular/router';
 import * as i1$1 from 'primeng/autocomplete';
 import * as i2$1 from 'primeng/avatar';
 import * as i3$1 from 'primeng/button';
@@ -50,8 +51,8 @@ import * as i40 from 'primeng/colorpicker';
 import * as _flusys_ng_shared from '@flusys/ng-shared';
 import { HttpClient, HttpParams, HttpHeaders } from '@angular/common/http';
 import { FormValueControl } from '@angular/forms/signals';
-import { MessageService, ConfirmationService } from 'primeng/api';
 import * as _flusys_ng_core from '@flusys/ng-core';
+import { MessageService, ConfirmationService } from 'primeng/api';
 
 declare const USER_PERMISSIONS: {
     readonly CREATE: "user.create";
@@ -153,6 +154,24 @@ declare const NOTIFICATION_PERMISSIONS: {
     readonly UPDATE: "notification.update";
     readonly DELETE: "notification.delete";
 };
+declare const LANGUAGE_PERMISSIONS: {
+    readonly CREATE: "language.create";
+    readonly READ: "language.read";
+    readonly UPDATE: "language.update";
+    readonly DELETE: "language.delete";
+};
+declare const TRANSLATION_KEY_PERMISSIONS: {
+    readonly CREATE: "translation-key.create";
+    readonly READ: "translation-key.read";
+    readonly UPDATE: "translation-key.update";
+    readonly DELETE: "translation-key.delete";
+};
+declare const TRANSLATION_PERMISSIONS: {
+    readonly CREATE: "translation.create";
+    readonly READ: "translation.read";
+    readonly UPDATE: "translation.update";
+    readonly DELETE: "translation.delete";
+};
 declare const PERMISSIONS: {
     readonly USER: {
         readonly CREATE: "user.create";
@@ -254,9 +273,29 @@ declare const PERMISSIONS: {
         readonly UPDATE: "notification.update";
         readonly DELETE: "notification.delete";
     };
+    readonly LANGUAGE: {
+        readonly CREATE: "language.create";
+        readonly READ: "language.read";
+        readonly UPDATE: "language.update";
+        readonly DELETE: "language.delete";
+    };
+    readonly TRANSLATION_KEY: {
+        readonly CREATE: "translation-key.create";
+        readonly READ: "translation-key.read";
+        readonly UPDATE: "translation-key.update";
+        readonly DELETE: "translation-key.delete";
+    };
+    readonly TRANSLATION: {
+        readonly CREATE: "translation.create";
+        readonly READ: "translation.read";
+        readonly UPDATE: "translation.update";
+        readonly DELETE: "translation.delete";
+    };
 };
 type PermissionCode = (typeof PERMISSIONS)[keyof typeof PERMISSIONS][keyof (typeof PERMISSIONS)[keyof typeof PERMISSIONS]];
 
+declare const SHARED_MESSAGES: Record<string, string>;
+
 /**
  * Base entity interface - matches backend Identity entity
  */
@@ -355,12 +394,8 @@ interface IPagination {
     pageSize: number;
     currentPage: number;
 }
-interface ISort {
-    [key: string]: 'ASC' | 'DESC';
-}
-interface IFilter {
-    [key: string]: string | number | boolean | null | undefined | string[] | number[];
-}
+type ISort = Record<string, 'ASC' | 'DESC'>;
+type IFilter = Record<string, string | number | boolean | null | undefined | string[] | number[]>;
 interface IFilterData {
     filter?: IFilter;
     pagination?: IPagination;
@@ -411,6 +446,8 @@ interface IValidationError {
 interface ISingleResponse<T> {
     success: boolean;
     message: string;
+    messageKey?: string;
+    messageParams?: Record<string, unknown>;
     data?: T;
     _meta?: IRequestMeta;
 }
@@ -420,6 +457,8 @@ interface ISingleResponse<T> {
 interface IListResponse<T> {
     success: boolean;
     message: string;
+    messageKey?: string;
+    messageParams?: Record<string, unknown>;
     data?: T[];
     meta: IPaginationMeta;
     _meta?: IRequestMeta;
@@ -430,6 +469,8 @@ interface IListResponse<T> {
 interface IBulkResponse<T> {
     success: boolean;
     message: string;
+    messageKey?: string;
+    messageParams?: Record<string, unknown>;
     data?: T[];
     meta: IBulkMeta;
     _meta?: IRequestMeta;
@@ -440,6 +481,8 @@ interface IBulkResponse<T> {
 interface IMessageResponse {
     success: boolean;
     message: string;
+    messageKey?: string;
+    messageParams?: Record<string, unknown>;
     _meta?: IRequestMeta;
 }
 /**
@@ -448,7 +491,8 @@ interface IMessageResponse {
 interface IErrorResponse {
     success: false;
     message: string;
-    code?: string;
+    messageKey?: string;
+    messageParams?: Record<string, unknown>;
     errors?: IValidationError[];
     _meta?: IRequestMeta;
 }
@@ -510,9 +554,6 @@ interface IFileData {
     createdAt: Date;
 }
 
-/**
- * Basic file info for selectors and displays
- */
 interface IFileBasicInfo {
     id: string;
     name: string;
@@ -520,9 +561,23 @@ interface IFileBasicInfo {
     size: string;
     url: string | null;
 }
-/**
- * Upload options for file uploader
- */
+interface IUploadedFile {
+    id?: string;
+    name: string;
+    key: string;
+    size: number;
+    contentType: string;
+}
+interface IFolderBasicInfo {
+    id: string;
+    name: string;
+    slug: string;
+}
+interface IStorageConfigBasicInfo {
+    id: string;
+    name: string;
+    isDefault: boolean;
+}
 interface IFileUploadOptions {
     storageConfigId?: string;
     folderPath?: string;
@@ -530,42 +585,22 @@ interface IFileUploadOptions {
     maxHeight?: number;
     quality?: number;
     compress?: boolean;
+    isPrivate?: boolean;
 }
-/**
- * Uploaded file response
- */
-interface IUploadedFile {
-    id?: string;
-    name: string;
-    key: string;
-    size: number;
-    contentType: string;
-}
-/**
- * Filter params for file selector
- */
-interface IFileSelectFilter {
+interface ISelectFilter {
     page: number;
     pageSize: number;
     search: string;
+}
+interface IFileSelectFilter extends ISelectFilter {
     contentTypes?: string[];
     folderId?: string;
+    storageConfigId?: string;
 }
-/**
- * Function type for loading files
- */
 type LoadFilesFn = (filter: IFileSelectFilter) => Observable<IListResponse<IFileBasicInfo>>;
-/**
- * Function type for uploading a file
- */
 type UploadFileFn = (file: File, options?: IFileUploadOptions) => Observable<ISingleResponse<IUploadedFile>>;
-/**
- * Function type for getting file URLs (presigned URL refresh)
- */
+type UploadMultipleFilesFn = (files: File[], options?: IFileUploadOptions) => Observable<ISingleResponse<IUploadedFile[]>>;
 type GetFileUrlsFn = (fileIds: string[]) => Observable<ISingleResponse<IFileBasicInfo[]>>;
-/**
- * Common file type filters
- */
 declare const FILE_TYPE_FILTERS: {
     readonly IMAGES: readonly ["image/jpeg", "image/png", "image/gif", "image/webp", "image/svg+xml"];
     readonly DOCUMENTS: readonly ["application/pdf", "application/msword", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "application/vnd.ms-excel", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"];
@@ -573,21 +608,9 @@ declare const FILE_TYPE_FILTERS: {
     readonly AUDIO: readonly ["audio/mpeg", "audio/wav", "audio/ogg", "audio/webm"];
     readonly ALL: string[];
 };
-/**
- * Get accept string for file input from content types
- */
 declare function getAcceptString(contentTypes: string[]): string;
-/**
- * Check if file matches allowed content types
- */
 declare function isFileTypeAllowed(file: File, allowedTypes: string[]): boolean;
-/**
- * Get file icon class based on content type
- */
 declare function getFileIconClass(contentType: string): string;
-/**
- * Format file size for display
- */
 declare function formatFileSize(sizeInKb: string | number): string;
 
 /**
@@ -687,31 +710,6 @@ interface IProfilePermissionProvider {
     getUserRoles(userId: string, branchId?: string): Observable<ISingleResponse<IProfileRoleInfo[]>>;
     getUserActions(userId: string, branchId?: string): Observable<ISingleResponse<IProfileActionInfo[]>>;
 }
-/**
- * Uploaded file result with file manager ID
- */
-interface IProfileUploadResult {
-    id: string;
-    name: string;
-    key: string;
-    size: number;
-    contentType: string;
-}
-/**
- * Profile Upload Options
- */
-interface IProfileUploadOptions {
-    folderPath?: string;
-    compress?: boolean;
-    maxWidth?: number;
-    maxHeight?: number;
-}
-/**
- * Profile Upload Provider Interface - Provides file upload functionality for profile pictures.
- */
-interface IProfileUploadProvider {
-    uploadProfilePicture(file: File, options?: IProfileUploadOptions): Observable<ISingleResponse<IProfileUploadResult>>;
-}
 /**
  * Base user interface for list operations
  */
@@ -771,6 +769,24 @@ interface IUserListProvider<T extends IUserListItem = IUserListItem> {
     enrichListData?(users: T[]): Observable<T[]>;
     getExtraFilters?(): IUserListFilter[];
 }
+/**
+ * File Provider Interface - Provides file loading and upload functionality.
+ * Used by FileSelectorDialogComponent to load files and handle uploads.
+ */
+interface IFileProvider {
+    /** Load files with filtering and pagination */
+    loadFiles(filter: IFileSelectFilter): Observable<IListResponse<IFileBasicInfo>>;
+    /** Upload a single file and register in file manager */
+    uploadFile(file: File, options?: IFileUploadOptions): Observable<ISingleResponse<IUploadedFile>>;
+    /** Upload multiple files at once (more efficient batch upload) */
+    uploadMultipleFiles?(files: File[], options?: IFileUploadOptions): Observable<ISingleResponse<IUploadedFile[]>>;
+    /** Get file URLs by IDs (for refreshing presigned URLs) */
+    getFileUrls?(fileIds: string[]): Observable<ISingleResponse<IFileBasicInfo[]>>;
+    /** Load folders for folder selector (optional) */
+    loadFolders?(filter: ISelectFilter): Observable<IListResponse<IFolderBasicInfo>>;
+    /** Load storage configs for config selector (optional) */
+    loadStorageConfigs?(filter: ISelectFilter): Observable<IListResponse<IStorageConfigBasicInfo>>;
+}
 
 declare enum ContactTypeEnum {
     PHONE = 1,
@@ -963,6 +979,35 @@ declare class PreventDefaultDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PreventDefaultDirective, "[appPreventDefault]", never, { "eventType": { "alias": "eventType"; "required": false; "isSignal": true; }; "preventKey": { "alias": "preventKey"; "required": false; "isSignal": true; }; }, { "action": "action"; }, never, never, true, never>;
 }
 
+declare class TranslatePipe implements PipeTransform {
+    private readonly translateAdapter;
+    private readonly fallbackMessages;
+    transform(key: string, params?: Record<string, string | number>): string;
+    private getFromFallback;
+    private interpolate;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TranslatePipe, never>;
+    static ɵpipe: _angular_core.ɵɵPipeDeclaration<TranslatePipe, "translate", true>;
+}
+
+interface IResolverModuleConfig {
+    modules: string[];
+    fallbackMessages?: Record<string, string>;
+}
+declare function resolveTranslationModule(config: IResolverModuleConfig): ResolveFn<boolean>;
+
+/**
+ * Provide fallback localization when @flusys/ng-localization is not used.
+ * Uses hardcoded fallback messages registered by route resolvers.
+ *
+ * @example
+ * ```typescript
+ * providers: [
+ *   ...provideFallbackLocalization(),
+ * ]
+ * ```
+ */
+declare function provideFallbackLocalization(): Provider[];
+
 declare class AngularModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AngularModule, never>;
     static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AngularModule, never, [typeof i1.CommonModule, typeof i2.FormsModule, typeof i2.ReactiveFormsModule, typeof i3.RouterOutlet, typeof i3.RouterLink, typeof i3.RouterLinkActive, typeof IsEmptyImageDirective, typeof i1.NgOptimizedImage, typeof i1.NgComponentOutlet, typeof PreventDefaultDirective], [typeof i1.CommonModule, typeof i2.FormsModule, typeof i2.ReactiveFormsModule, typeof i3.RouterOutlet, typeof i3.RouterLink, typeof i3.RouterLinkActive, typeof IsEmptyImageDirective, typeof i1.NgOptimizedImage, typeof i1.NgComponentOutlet, typeof PreventDefaultDirective]>;
@@ -1156,11 +1201,13 @@ declare class IconComponent {
 declare class LazyMultiSelectComponent extends BaseFormControl<string[] | null> implements OnDestroy {
     private readonly document;
     private readonly appRef;
+    private readonly translateAdapter;
     private readonly onDocumentClickBound;
     readonly pSelectRef: _angular_core.Signal<ElementRef<HTMLDivElement>>;
     readonly overlayTemplate: _angular_core.Signal<TemplateRef<unknown>>;
     private overlayViewRef;
     readonly placeHolder: _angular_core.InputSignal<string>;
+    readonly displayPlaceholder: _angular_core.Signal<string>;
     readonly isEditMode: _angular_core.InputSignal<boolean>;
     readonly isLoading: _angular_core.InputSignal<boolean>;
     readonly total: _angular_core.InputSignal<number | undefined>;
@@ -1185,6 +1232,7 @@ declare class LazyMultiSelectComponent extends BaseFormControl<string[] | null>
     selectValue(event: CheckboxChangeEvent, option: IDropDown): void;
     changeSelectAll(event: CheckboxChangeEvent): void;
     clear(event: Event): void;
+    private t;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<LazyMultiSelectComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<LazyMultiSelectComponent, "lib-lazy-multi-select", never, { "placeHolder": { "alias": "placeHolder"; "required": false; "isSignal": true; }; "isEditMode": { "alias": "isEditMode"; "required": true; "isSignal": true; }; "isLoading": { "alias": "isLoading"; "required": true; "isSignal": true; }; "total": { "alias": "total"; "required": true; "isSignal": true; }; "pagination": { "alias": "pagination"; "required": true; "isSignal": true; }; "selectDataList": { "alias": "selectDataList"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "onSearch": "onSearch"; "onPagination": "onPagination"; }, never, never, true, never>;
 }
@@ -1199,11 +1247,13 @@ declare class LazyMultiSelectComponent extends BaseFormControl<string[] | null>
  */
 declare class LazySelectComponent extends BaseFormControl<string | null> {
     private readonly destroyRef;
+    private readonly translateAdapter;
     private readonly onScrollBound;
     private scrollTargetEl;
     private isDestroyed;
     readonly scrollContainer: _angular_core.Signal<ElementRef<HTMLDivElement>>;
     readonly placeHolder: _angular_core.InputSignal<string>;
+    readonly displayPlaceholder: _angular_core.Signal<string>;
     readonly optionLabel: _angular_core.InputSignal<string>;
     readonly optionValue: _angular_core.InputSignal<string>;
     readonly isEditMode: _angular_core.InputSignal<boolean>;
@@ -1220,6 +1270,7 @@ declare class LazySelectComponent extends BaseFormControl<string | null> {
     onScroll(event: Event): void;
     showPanel(): void;
     onBlur(): void;
+    private t;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<LazySelectComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<LazySelectComponent, "lib-lazy-select", never, { "placeHolder": { "alias": "placeHolder"; "required": false; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": true; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": true; "isSignal": true; }; "isEditMode": { "alias": "isEditMode"; "required": true; "isSignal": true; }; "isLoading": { "alias": "isLoading"; "required": true; "isSignal": true; }; "total": { "alias": "total"; "required": true; "isSignal": true; }; "pagination": { "alias": "pagination"; "required": true; "isSignal": true; }; "selectDataList": { "alias": "selectDataList"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "onSearch": "onSearch"; "onPagination": "onPagination"; }, never, never, true, never>;
 }
@@ -1235,6 +1286,7 @@ declare abstract class BaseUserSelectComponent {
     protected readonly destroyRef: DestroyRef;
     protected readonly injector: Injector;
     protected readonly userProvider: IUserProvider;
+    protected readonly translateAdapter: _flusys_ng_core.ITranslateAdapter | null;
     protected abortController: AbortController | null;
     readonly loadUsers: _angular_core.InputSignal<LoadUsersFn | undefined>;
     readonly placeHolder: _angular_core.InputSignal<string>;
@@ -1249,6 +1301,7 @@ declare abstract class BaseUserSelectComponent {
     readonly pagination: _angular_core.WritableSignal<IPagination>;
     readonly searchTerm: _angular_core.WritableSignal<string>;
     readonly dropdownUsers: _angular_core.Signal<IDropDown[]>;
+    readonly displayPlaceholder: _angular_core.Signal<string>;
     constructor();
     /** Setup effect to track value changes and emit selection events */
     protected abstract setupValueEffect(): void;
@@ -1259,6 +1312,7 @@ declare abstract class BaseUserSelectComponent {
     protected fetchUsers(append?: boolean): Promise<void>;
     /** Load users from USER_PROVIDER with active filter */
     private loadUsersFromProvider;
+    protected t(key: string, variables?: Record<string, string | number>): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BaseUserSelectComponent, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BaseUserSelectComponent, never, never, { "loadUsers": { "alias": "loadUsers"; "required": false; "isSignal": true; }; "placeHolder": { "alias": "placeHolder"; "required": false; "isSignal": true; }; "isEditMode": { "alias": "isEditMode"; "required": true; "isSignal": true; }; "filterActive": { "alias": "filterActive"; "required": false; "isSignal": true; }; "additionalFilters": { "alias": "additionalFilters"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; }, { "onError": "onError"; }, never, never, true, never>;
 }
@@ -1337,11 +1391,33 @@ declare class UserMultiSelectComponent extends BaseUserSelectComponent {
 /**
  * File Uploader Component - Drag & drop file upload with type filtering.
  *
- * Pass your own `uploadFile` function - works with any storage API.
+ * Uses FILE_PROVIDER when available (no inputs needed).
+ * Optionally pass `uploadFile` to override the provider.
+ *
+ * @example
+ * ```html
+ * <!-- Using FILE_PROVIDER (recommended) -->
+ * <lib-file-uploader
+ *   [acceptTypes]="['image/*']"
+ *   (fileUploaded)="onFileUploaded($event)"
+ * />
+ *
+ * <!-- Custom upload function -->
+ * <lib-file-uploader
+ *   [uploadFile]="customUploadFn"
+ *   (fileUploaded)="onFileUploaded($event)"
+ * />
+ * ```
  */
 declare class FileUploaderComponent {
     private readonly messageService;
-    readonly uploadFile: _angular_core.InputSignal<UploadFileFn>;
+    private readonly translateAdapter;
+    private readonly fileProvider;
+    readonly uploadFile: _angular_core.InputSignal<UploadFileFn | undefined>;
+    readonly uploadMultipleFiles: _angular_core.InputSignal<UploadMultipleFilesFn | undefined>;
+    readonly hasUploadCapability: _angular_core.Signal<boolean>;
+    private getUploadFn;
+    private getUploadMultipleFn;
     readonly acceptTypes: _angular_core.InputSignal<string[]>;
     readonly multiple: _angular_core.InputSignal<boolean>;
     readonly maxFiles: _angular_core.InputSignal<number>;
@@ -1368,67 +1444,55 @@ declare class FileUploaderComponent {
     private handleFiles;
     removeFile(file: File): void;
     uploadFiles(files?: File[]): Promise<void>;
+    private uploadBatch;
+    private uploadSequential;
     getFileIcon(file: File): string;
     formatSize(bytes: number): string;
+    private t;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileUploaderComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileUploaderComponent, "lib-file-uploader", never, { "uploadFile": { "alias": "uploadFile"; "required": true; "isSignal": true; }; "acceptTypes": { "alias": "acceptTypes"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "maxSizeMb": { "alias": "maxSizeMb"; "required": false; "isSignal": true; }; "uploadOptions": { "alias": "uploadOptions"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "showPreview": { "alias": "showPreview"; "required": false; "isSignal": true; }; "autoUpload": { "alias": "autoUpload"; "required": false; "isSignal": true; }; }, { "fileUploaded": "fileUploaded"; "filesUploaded": "filesUploaded"; "onError": "onError"; "fileSelected": "fileSelected"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileUploaderComponent, "lib-file-uploader", never, { "uploadFile": { "alias": "uploadFile"; "required": false; "isSignal": true; }; "uploadMultipleFiles": { "alias": "uploadMultipleFiles"; "required": false; "isSignal": true; }; "acceptTypes": { "alias": "acceptTypes"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "maxSizeMb": { "alias": "maxSizeMb"; "required": false; "isSignal": true; }; "uploadOptions": { "alias": "uploadOptions"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "showPreview": { "alias": "showPreview"; "required": false; "isSignal": true; }; "autoUpload": { "alias": "autoUpload"; "required": false; "isSignal": true; }; }, { "fileUploaded": "fileUploaded"; "filesUploaded": "filesUploaded"; "onError": "onError"; "fileSelected": "fileSelected"; }, never, never, true, never>;
 }
 
 /**
- * File Selector Dialog - Browse and select existing files with filtering.
+ * File Selector Dialog - Self-contained file browser with upload support.
  *
- * Pass your own `loadFiles` function - works with any storage API.
+ * Uses FILE_PROVIDER internally - no external functions needed.
+ * Just configure with inputs and handle selection events.
  *
  * Features:
  * - Search with debouncing
- * - File type filtering
+ * - File type filtering (acceptTypes)
+ * - Folder filtering
  * - Infinite scroll pagination
  * - Single or multiple selection
+ * - Built-in file upload (withUploader)
  * - File preview with icons
  *
  * @example
- * ```typescript
- * // In component
- * readonly fileService = inject(FileManagerApiService);
- *
- * readonly loadFiles: LoadFilesFn = (filter) =>
- *   this.fileService.getAll(filter.search, {
- *     pagination: { currentPage: filter.page, pageSize: filter.pageSize },
- *     filter: { contentTypes: filter.contentTypes },
- *   }).pipe(
- *     map(res => ({
- *       ...res,
- *       data: res.data?.map(f => ({
- *         id: f.id,
- *         name: f.name,
- *         contentType: f.contentType,
- *         size: f.size,
- *         url: f.url
- *       }))
- *     }))
- *   );
- * ```
- *
  * ```html
  * <lib-file-selector-dialog
- *   [(visible)]="showFileSelector"
- *   [loadFiles]="loadFiles"
+ *   [(visible)]="showSelector"
  *   [acceptTypes]="['image/*']"
- *   [multiple]="false"
- *   (fileSelected)="onFileSelected($event)"
+ *   [multiple]="true"
+ *   [withUploader]="true"
+ *   (filesSelected)="onFilesSelected($event)"
  * />
  * ```
  */
 declare class FileSelectorDialogComponent {
     private readonly destroyRef;
+    private readonly translateAdapter;
+    readonly fileProvider: _flusys_ng_shared.IFileProvider | null;
     private abortController;
     private searchDebounceTimer;
-    readonly loadFiles: _angular_core.InputSignal<LoadFilesFn>;
-    readonly header: _angular_core.InputSignal<string>;
+    readonly header: _angular_core.InputSignal<string | undefined>;
     readonly acceptTypes: _angular_core.InputSignal<string[]>;
     readonly multiple: _angular_core.InputSignal<boolean>;
+    readonly dialogHeader: _angular_core.Signal<string>;
     readonly maxSelection: _angular_core.InputSignal<number>;
     readonly pageSize: _angular_core.InputSignal<number>;
+    readonly folderId: _angular_core.InputSignal<string | undefined>;
+    readonly withUploader: _angular_core.InputSignal<boolean>;
     readonly visible: _angular_core.ModelSignal<boolean>;
     readonly fileSelected: _angular_core.OutputEmitterRef<IFileBasicInfo>;
     readonly filesSelected: _angular_core.OutputEmitterRef<IFileBasicInfo[]>;
@@ -1440,7 +1504,19 @@ declare class FileSelectorDialogComponent {
     readonly total: _angular_core.WritableSignal<number | undefined>;
     readonly pagination: _angular_core.WritableSignal<IPagination>;
     readonly searchTerm: _angular_core.WritableSignal<string>;
-    readonly acceptString: _angular_core.Signal<string>;
+    readonly folders: _angular_core.WritableSignal<IFolderBasicInfo[]>;
+    readonly selectedFolderId: _angular_core.WritableSignal<string | null>;
+    readonly foldersLoading: _angular_core.WritableSignal<boolean>;
+    readonly foldersPagination: _angular_core.WritableSignal<IPagination>;
+    readonly foldersTotal: _angular_core.WritableSignal<number | undefined>;
+    readonly storageConfigs: _angular_core.WritableSignal<IStorageConfigBasicInfo[]>;
+    readonly selectedStorageConfigId: _angular_core.WritableSignal<string | null>;
+    readonly storageConfigsLoading: _angular_core.WritableSignal<boolean>;
+    readonly storageConfigsPagination: _angular_core.WritableSignal<IPagination>;
+    readonly storageConfigsTotal: _angular_core.WritableSignal<number | undefined>;
+    readonly effectiveStorageConfigId: _angular_core.Signal<string | undefined>;
+    readonly uploadFileFn: (file: File, options?: IFileUploadOptions) => rxjs.Observable<_flusys_ng_shared.ISingleResponse<IUploadedFile>>;
+    readonly uploadMultipleFilesFn: ((files: File[], options?: IFileUploadOptions) => rxjs.Observable<_flusys_ng_shared.ISingleResponse<IUploadedFile[]>>) | undefined;
     constructor();
     onSearchChange(value: string): void;
     onScroll(event: Event): void;
@@ -1453,10 +1529,22 @@ declare class FileSelectorDialogComponent {
     onCancel(): void;
     onConfirm(): void;
     onDialogHide(): void;
+    onFolderChange(folderId: string | null): void;
+    onFolderSearch(event: {
+        filter: string;
+    }): void;
+    loadFolders(search?: string): Promise<void>;
+    onStorageConfigChange(configId: string | null): void;
+    onStorageConfigSearch(event: {
+        filter: string;
+    }): void;
+    loadStorageConfigs(search?: string): Promise<void>;
+    onFileUploaded(uploadedFile: IUploadedFile): void;
     private resetState;
     private fetchFiles;
+    private t;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileSelectorDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileSelectorDialogComponent, "lib-file-selector-dialog", never, { "loadFiles": { "alias": "loadFiles"; "required": true; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "acceptTypes": { "alias": "acceptTypes"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxSelection": { "alias": "maxSelection"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "visible": { "alias": "visible"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; "fileSelected": "fileSelected"; "filesSelected": "filesSelected"; "closed": "closed"; "onError": "onError"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileSelectorDialogComponent, "lib-file-selector-dialog", never, { "header": { "alias": "header"; "required": false; "isSignal": true; }; "acceptTypes": { "alias": "acceptTypes"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxSelection": { "alias": "maxSelection"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "folderId": { "alias": "folderId"; "required": false; "isSignal": true; }; "withUploader": { "alias": "withUploader"; "required": false; "isSignal": true; }; "visible": { "alias": "visible"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; "fileSelected": "fileSelected"; "filesSelected": "filesSelected"; "closed": "closed"; "onError": "onError"; }, never, never, true, never>;
 }
 
 /**
@@ -1512,14 +1600,6 @@ declare const AUTH_STATE_PROVIDER: InjectionToken<IAuthStateProvider>;
  * Use with `inject(PROFILE_PERMISSION_PROVIDER, { optional: true })`.
  */
 declare const PROFILE_PERMISSION_PROVIDER: InjectionToken<IProfilePermissionProvider>;
-/**
- * Profile Upload Provider Token
- *
- * Provides file upload functionality for profile pictures.
- * Optional - if not configured or storage not enabled, upload section is hidden.
- * Use with `inject(PROFILE_UPLOAD_PROVIDER, { optional: true })`.
- */
-declare const PROFILE_UPLOAD_PROVIDER: InjectionToken<IProfileUploadProvider>;
 /**
  * User List Provider Token
  *
@@ -1534,6 +1614,20 @@ declare const PROFILE_UPLOAD_PROVIDER: InjectionToken<IProfileUploadProvider>;
  * ]
  */
 declare const USER_LIST_PROVIDER: InjectionToken<IUserListProvider<IUserListItem>>;
+/**
+ * File Provider Token
+ *
+ * Provides file loading and upload functionality for file selectors.
+ * Optional - if not configured, file selector requires loadFiles/uploadFile inputs.
+ * Use with `inject(FILE_PROVIDER, { optional: true })`.
+ *
+ * @example
+ * // In app.config.ts
+ * providers: [
+ *   { provide: FILE_PROVIDER, useClass: StorageFileProvider },
+ * ]
+ */
+declare const FILE_PROVIDER: InjectionToken<IFileProvider>;
 
 /**
  * Permission Guard - Single permission or ILogicNode check.
@@ -1587,8 +1681,7 @@ declare function allPermissionsGuard(permissions: string[], redirectTo?: string)
  * @Component({
  *   selector: 'app-product-form',
  *   standalone: true,
- *   changeDetection: ChangeDetectionStrategy.OnPush,
- *   template: `...`
+ * *   template: `...`
  * })
  * export class ProductFormComponent extends BaseFormPage<IProduct, IProductFormModel> {
  *   private readonly productService = inject(ProductApiService);
@@ -1655,6 +1748,7 @@ declare abstract class BaseFormPage<T, TFormModel> {
     protected readonly route: ActivatedRoute;
     protected readonly messageService: MessageService;
     protected readonly destroyRef: DestroyRef;
+    protected readonly translateAdapter: _flusys_ng_core.ITranslateAdapter | null;
     protected readonly routeParams: Signal<i3.ParamMap | undefined>;
     protected initialized: boolean;
     /** Loading state for async operations */
@@ -1727,6 +1821,10 @@ declare abstract class BaseFormPage<T, TFormModel> {
      * @param detail The error message to display
      */
     protected showError(detail: string): void;
+    /**
+     * Translate a key using the adapter, fallback to key if not available.
+     */
+    protected t(key: string, variables?: Record<string, string | number>): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BaseFormPage<any, any>, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BaseFormPage<any, any>, never, never, {}, {}, never, never, true, never>;
 }
@@ -1760,6 +1858,7 @@ declare abstract class BaseListPage<T> {
     protected readonly appConfig: _flusys_ng_core.IAppConfig;
     protected readonly confirmationService: ConfirmationService;
     protected readonly destroyRef: DestroyRef;
+    protected readonly translateAdapter: _flusys_ng_core.ITranslateAdapter | null;
     /** Items list */
     readonly items: _angular_core.WritableSignal<T[]>;
     /** Loading state */
@@ -1830,6 +1929,10 @@ declare abstract class BaseListPage<T> {
      * Show warning toast message
      */
     protected showWarn(detail: string, summary?: string): void;
+    /**
+     * Translate a key using the adapter, fallback to key if not available.
+     */
+    protected t(key: string, variables?: Record<string, string | number>): string;
     /**
      * Delete an item with confirmation dialog
      * @param item The item to delete
@@ -1912,5 +2015,5 @@ interface ScrollPaginationConfig {
  */
 declare function checkScrollPagination(event: Event, config: ScrollPaginationConfig): IPagination | null;
 
-export { ACTION_PERMISSIONS, AUTH_STATE_PROVIDER, AngularModule, ApiResourceService, ApiResourceService as ApiService, BRANCH_PERMISSIONS, BaseFormControl, BaseFormPage, BaseListPage, BaseUserSelectComponent, COMPANY_ACTION_PERMISSIONS, COMPANY_API_PROVIDER, COMPANY_PERMISSIONS, ContactTypeEnum, CookieService, EMAIL_CONFIG_PERMISSIONS, EMAIL_TEMPLATE_PERMISSIONS, EVENT_PARTICIPANT_PERMISSIONS, EVENT_PERMISSIONS, EditModeElementChangerDirective, FILE_PERMISSIONS, FILE_TYPE_FILTERS, FOLDER_PERMISSIONS, FORM_PERMISSIONS, FileSelectorDialogComponent, FileUploaderComponent, FileUrlService, HasPermissionDirective, IconComponent, IconTypeEnum, IsEmptyImageDirective, LazyMultiSelectComponent, LazySelectComponent, NOTIFICATION_PERMISSIONS, PERMISSIONS, PROFILE_PERMISSION_PROVIDER, PROFILE_UPLOAD_PROVIDER, PermissionValidatorService, PlatformService, PreventDefaultDirective, PrimeModule, ROLE_ACTION_PERMISSIONS, ROLE_PERMISSIONS, STORAGE_CONFIG_PERMISSIONS, USER_ACTION_PERMISSIONS, USER_LIST_PROVIDER, USER_PERMISSIONS, USER_PERMISSION_PROVIDER, USER_PROVIDER, USER_ROLE_PERMISSIONS, UserMultiSelectComponent, UserSelectComponent, allPermissionsGuard, anyPermissionGuard, checkScrollPagination, evaluateLogicNode, evaluatePermission, formatFileSize, getAcceptString, getFileIconClass, hasAllPermissions, hasAnyPermission, hasPermission, isFileTypeAllowed, permissionGuard, provideValueAccessor };
-export type { ApiResponse, DeleteType, FilesResponseDto, GetFileUrlsFn, IActionNode, IActivatable, IApiService, IAuthStateProvider, IBaseEntity, IBulkMeta, IBulkResponse, ICompanyApiProvider, ICompanyBasicInfo, IDeleteData, IDropDown, IErrorResponse, IFileBasicInfo, IFileData, IFileSelectFilter, IFileUploadOptions, IFilter, IFilterData, IGroupNode, IListResponse, ILoggedUserInfo, ILogicNode, ILoginResponse, ILoginUserData, IMessageResponse, IMetadata, IOrderable, IPagination, IPaginationMeta, IProfileActionInfo, IProfilePermissionProvider, IProfileRoleInfo, IProfileUploadOptions, IProfileUploadProvider, IProfileUploadResult, IRefreshTokenResponse, IRequestMeta, ISingleResponse, ISoftDeletable, ISort, ITimestampable, IUploadedFile, IUserBasicInfo, IUserBranchPayload, IUserBranchPermission, IUserCompanyPayload, IUserListAction, IUserListColumn, IUserListFilter, IUserListItem, IUserListProvider, IUserPermissionProvider, IUserProvider, IUserSelectFilter, IValidationError, LoadFilesFn, LoadUsersFn, PermissionCode, ScrollPaginationConfig, ServiceName, UploadFileFn };
+export { ACTION_PERMISSIONS, AUTH_STATE_PROVIDER, AngularModule, ApiResourceService, ApiResourceService as ApiService, BRANCH_PERMISSIONS, BaseFormControl, BaseFormPage, BaseListPage, BaseUserSelectComponent, COMPANY_ACTION_PERMISSIONS, COMPANY_API_PROVIDER, COMPANY_PERMISSIONS, ContactTypeEnum, CookieService, EMAIL_CONFIG_PERMISSIONS, EMAIL_TEMPLATE_PERMISSIONS, EVENT_PARTICIPANT_PERMISSIONS, EVENT_PERMISSIONS, EditModeElementChangerDirective, FILE_PERMISSIONS, FILE_PROVIDER, FILE_TYPE_FILTERS, FOLDER_PERMISSIONS, FORM_PERMISSIONS, FileSelectorDialogComponent, FileUploaderComponent, FileUrlService, HasPermissionDirective, IconComponent, IconTypeEnum, IsEmptyImageDirective, LANGUAGE_PERMISSIONS, LazyMultiSelectComponent, LazySelectComponent, NOTIFICATION_PERMISSIONS, PERMISSIONS, PROFILE_PERMISSION_PROVIDER, PermissionValidatorService, PlatformService, PreventDefaultDirective, PrimeModule, ROLE_ACTION_PERMISSIONS, ROLE_PERMISSIONS, SHARED_MESSAGES, STORAGE_CONFIG_PERMISSIONS, TRANSLATION_KEY_PERMISSIONS, TRANSLATION_PERMISSIONS, TranslatePipe, USER_ACTION_PERMISSIONS, USER_LIST_PROVIDER, USER_PERMISSIONS, USER_PERMISSION_PROVIDER, USER_PROVIDER, USER_ROLE_PERMISSIONS, UserMultiSelectComponent, UserSelectComponent, allPermissionsGuard, anyPermissionGuard, checkScrollPagination, evaluateLogicNode, evaluatePermission, formatFileSize, getAcceptString, getFileIconClass, hasAllPermissions, hasAnyPermission, hasPermission, isFileTypeAllowed, permissionGuard, provideFallbackLocalization, provideValueAccessor, resolveTranslationModule };
+export type { ApiResponse, DeleteType, FilesResponseDto, GetFileUrlsFn, IActionNode, IActivatable, IApiService, IAuthStateProvider, IBaseEntity, IBulkMeta, IBulkResponse, ICompanyApiProvider, ICompanyBasicInfo, IDeleteData, IDropDown, IErrorResponse, IFileBasicInfo, IFileData, IFileProvider, IFileSelectFilter, IFileUploadOptions, IFilter, IFilterData, IFolderBasicInfo, IGroupNode, IListResponse, ILoggedUserInfo, ILogicNode, ILoginResponse, ILoginUserData, IMessageResponse, IMetadata, IOrderable, IPagination, IPaginationMeta, IProfileActionInfo, IProfilePermissionProvider, IProfileRoleInfo, IRefreshTokenResponse, IRequestMeta, IResolverModuleConfig, ISelectFilter, ISingleResponse, ISoftDeletable, ISort, IStorageConfigBasicInfo, ITimestampable, IUploadedFile, IUserBasicInfo, IUserBranchPayload, IUserBranchPermission, IUserCompanyPayload, IUserListAction, IUserListColumn, IUserListFilter, IUserListItem, IUserListProvider, IUserPermissionProvider, IUserProvider, IUserSelectFilter, IValidationError, LoadFilesFn, LoadUsersFn, PermissionCode, ScrollPaginationConfig, ServiceName, UploadFileFn, UploadMultipleFilesFn };