@flusys/ng-shared 5.1.3 → 5.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/ng-shared",
-  "version": "5.1.3",
+  "version": "5.2.0",
   "description": "Shared components and utilities for FLUSYS Angular packages",
   "license": "MIT",
   "peerDependencies": {
@@ -8,7 +8,7 @@
     "@angular/core": ">=21.0.0",
     "@angular/forms": ">=21.0.0",
     "@angular/router": ">=21.0.0",
-    "@flusys/ng-core": ">=5.1.3",
+    "@flusys/ng-core": ">=5.2.0",
     "@primeuix/themes": ">=1.0.0",
     "primeicons": ">=7.0.0",
     "primeng": ">=21.0.0",

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

@@ -4,7 +4,7 @@ import * as _angular_core from '@angular/core';
 import { Signal, PipeTransform, ResourceRef, ResourceStatus, Injector, model, OnDestroy, ElementRef, TemplateRef, DestroyRef, InjectionToken } from '@angular/core';
 import { HttpContextToken, HttpRequest, HttpHandlerFn, HttpEvent, HttpClient, HttpParams, HttpHeaders } from '@angular/common/http';
 import * as i3 from '@angular/router';
-import { ResolveFn, CanActivateFn, Router, ActivatedRoute } from '@angular/router';
+import { ResolveFn, CanActivateFn } from '@angular/router';
 import * as i1 from '@angular/common';
 import * as i2 from '@angular/forms';
 import { ControlValueAccessor } from '@angular/forms';
@@ -50,10 +50,9 @@ import * as i38 from 'primeng/treetable';
 import * as i39 from 'primeng/progressspinner';
 import * as i40 from 'primeng/colorpicker';
 import * as _flusys_ng_shared from '@flusys/ng-shared';
-import * as _flusys_ng_core from '@flusys/ng-core';
 import { ServiceName } from '@flusys/ng-core';
 import { FormValueControl } from '@angular/forms/signals';
-import { MessageService, ConfirmationService } from 'primeng/api';
+import * as _angular_platform_browser from '@angular/platform-browser';
 
 declare const SHARED_MESSAGES: Record<string, string>;
 
@@ -663,6 +662,17 @@ declare class CookieService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<CookieService>;
 }
 
+declare class FaviconService {
+    private readonly http;
+    private readonly platformService;
+    private readonly document;
+    private svgTemplate;
+    apply(): void;
+    private render;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FaviconService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<FaviconService>;
+}
+
 interface FilesResponseDto {
     id: string;
     name: string;
@@ -1000,6 +1010,15 @@ declare function provideValueAccessor<T extends new (...args: unknown[]) => Cont
     multi: boolean;
 };
 
+declare class InlineSvgComponent {
+    readonly src: _angular_core.InputSignal<string>;
+    private readonly http;
+    private readonly sanitizer;
+    readonly svg: _angular_core.ResourceRef<_angular_platform_browser.SafeHtml | undefined>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<InlineSvgComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<InlineSvgComponent, "inline-svg", never, { "src": { "alias": "src"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare class FileSelectorDialogComponent {
     private readonly destroyRef;
     private readonly translateAdapter;
@@ -1420,309 +1439,6 @@ declare function anyPermissionGuard(permissions: string[], redirectTo?: string):
  */
 declare function allPermissionsGuard(permissions: string[], redirectTo?: string): CanActivateFn;
 
-/**
- * Base class for form page components that handle create/edit operations.
- * Provides common functionality for loading existing items, form submission,
- * navigation, and toast notifications.
- *
- * ## Features
- * - Automatic route parameter handling (loads item when ID is present)
- * - Edit mode detection based on existing item
- * - Unified submit handler for create/update operations
- * - Cancel navigation
- * - Toast messages for success/validation errors
- *
- * ## Usage
- *
- * ```typescript
- * interface IProductFormModel {
- *   name: string;
- *   price: number;
- * }
- *
- * @Component({
- *   selector: 'app-product-form',
- *   standalone: true,
- * *   template: `...`
- * })
- * export class ProductFormComponent extends BaseFormPage<IProduct, IProductFormModel> {
- *   private readonly productService = inject(ProductApiService);
- *
- *   // Form model signal (private writable, public readonly)
- *   private readonly _formModel = signal<IProductFormModel>({ name: '', price: 0 });
- *   readonly formModel = this._formModel.asReadonly();
- *
- *   // Required abstract implementations
- *   getFormModel(): Signal<IProductFormModel> {
- *     return this.formModel;
- *   }
- *
- *   getResourceRoute(): string {
- *     return '/products';
- *   }
- *
- *   getResourceName(): string {
- *     return 'Product';
- *   }
- *
- *   isFormValid(): boolean {
- *     const model = this.formModel();
- *     return model.name.trim().length > 0 && model.price > 0;
- *   }
- *
- *   loadItem(id: string): void {
- *     this.isLoading.set(true);
- *     this.productService.findById(id)
- *       .pipe(takeUntilDestroyed(this.destroyRef))
- *       .subscribe({
- *         next: (response) => {
- *           if (response.success && response.data) {
- *             this.existingItem.set(response.data);
- *             this._formModel.set({
- *               name: response.data.name,
- *               price: response.data.price,
- *             });
- *           }
- *           this.isLoading.set(false);
- *         },
- *         error: () => {
- *           this.router.navigate([this.getResourceRoute()]);
- *           this.isLoading.set(false);
- *         },
- *       });
- *   }
- *
- *   createItem(model: IProductFormModel): Observable<ISingleResponse<IProduct>> {
- *     return this.productService.insert(model);
- *   }
- *
- *   updateItem(model: IProductFormModel): Observable<ISingleResponse<IProduct>> {
- *     return this.productService.update({ id: this.existingItem()!.id, ...model });
- *   }
- * }
- * ```
- *
- * @template T The entity/interface type being edited
- * @template TFormModel The form model interface
- */
-declare abstract class BaseFormPage<T, TFormModel> {
-    protected readonly router: Router;
-    protected readonly route: ActivatedRoute;
-    protected readonly messageService: MessageService;
-    protected readonly destroyRef: DestroyRef;
-    protected readonly translateAdapter: TranslateService | null;
-    protected readonly routeParams: Signal<i3.ParamMap | undefined>;
-    protected initialized: boolean;
-    /** Loading state for async operations */
-    readonly isLoading: _angular_core.WritableSignal<boolean>;
-    /** The existing item when in edit mode, null when creating */
-    readonly existingItem: _angular_core.WritableSignal<T | null>;
-    /** Whether the form is in edit mode (has existing item) */
-    readonly isEditMode: Signal<boolean>;
-    /**
-     * Get the form model signal.
-     * Returns a readonly Signal - implementations should expose their
-     * WritableSignal as readonly through this method.
-     */
-    abstract getFormModel(): Signal<TFormModel>;
-    /**
-     * Get the base route for the resource (used for navigation after save/cancel).
-     * @example '/products' or '/administration/users'
-     */
-    abstract getResourceRoute(): string;
-    /**
-     * Get the display name of the resource for toast messages.
-     * @example 'Product' or 'User'
-     */
-    abstract getResourceName(): string;
-    /**
-     * Validate the current form model.
-     * Return true if the form is valid and can be submitted.
-     */
-    abstract isFormValid(): boolean;
-    /**
-     * Load an existing item by ID.
-     * Should set existingItem and populate formModel on success.
-     * Should handle loading state and navigation on error.
-     */
-    abstract loadItem(id: string): void;
-    /**
-     * Create a new item with the given form model.
-     * Return an Observable that emits the API response.
-     */
-    abstract createItem(model: TFormModel): Observable<unknown>;
-    /**
-     * Update an existing item with the given form model.
-     * Return an Observable that emits the API response.
-     */
-    abstract updateItem(model: TFormModel): Observable<unknown>;
-    constructor();
-    /**
-     * Handle form submission.
-     * Validates the form, then calls createItem or updateItem based on mode.
-     * Shows appropriate toast messages and navigates back on success.
-     */
-    onSubmit(): void;
-    /**
-     * Handle cancel action.
-     * Navigates back to the resource list.
-     */
-    onCancel(): void;
-    /**
-     * Show validation error toast.
-     * Override to customize the validation error message.
-     */
-    protected showValidationError(): void;
-    /**
-     * Show success toast.
-     * @param detail The success message to display
-     */
-    protected showSuccess(detail: string): void;
-    /**
-     * Show error toast.
-     * @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>;
-}
-
-/**
- * Base List Page
- * Abstract directive providing common signals, computed values, and utilities
- * for list page components across all feature packages.
- *
- * Features:
- * - Pagination state management (pageSize, currentPage, total)
- * - Loading state
- * - CRUD navigation helpers
- * - Message display utilities
- * - Delete confirmation with API integration
- * - Company feature flag support
- *
- * Usage:
- * ```typescript
- * @Component({ ... })
- * export class UserListComponent extends BaseListPage<IUser> {
- *   getResourceRoute(): string { return '/users'; }
- *   getDeleteConfirmMessage(user: IUser): string { return `Delete "${user.name}"?`; }
- *   async loadData(): Promise<void> { ... }
- * }
- * ```
- */
-declare abstract class BaseListPage<T> {
-    protected readonly router: Router;
-    protected readonly messageService: MessageService;
-    protected readonly appConfig: _flusys_ng_core.IAppConfig;
-    protected readonly confirmationService: ConfirmationService;
-    protected readonly destroyRef: DestroyRef;
-    protected readonly translateAdapter: TranslateService | null;
-    /** Items list */
-    readonly items: _angular_core.WritableSignal<T[]>;
-    /** Loading state */
-    readonly isLoading: _angular_core.WritableSignal<boolean>;
-    /** Total records for pagination */
-    readonly total: _angular_core.WritableSignal<number>;
-    /** Page size */
-    readonly pageSize: _angular_core.WritableSignal<number>;
-    /** First record index (for p-table lazy load) */
-    readonly first: _angular_core.WritableSignal<number>;
-    /** Current page (0-based for API, derived from first/pageSize) */
-    readonly currentPage: _angular_core.Signal<number>;
-    /** Show company info if company feature enabled */
-    readonly showCompanyInfo: _angular_core.Signal<boolean>;
-    /**
-     * Abstract method to load data - must be implemented by subclass
-     */
-    abstract loadData(): Promise<void>;
-    /**
-     * Get the base route for this resource
-     * Used for navigation to create/edit pages
-     * @example '/administration/users' or '/storage/folders'
-     */
-    abstract getResourceRoute(): string;
-    /**
-     * Get the confirmation message for deleting an item
-     * @param item The item to delete
-     * @returns Confirmation message string
-     */
-    abstract getDeleteConfirmMessage(item: T): string;
-    /**
-     * Navigate to create page
-     */
-    onCreate(): void;
-    /**
-     * Navigate to edit page
-     * @param id The ID of the item to edit
-     */
-    onEdit(id: string): void;
-    /**
-     * Handle page change from p-table lazy load
-     */
-    onPageChange(event: {
-        first?: number | null;
-        rows?: number | null;
-    }): void;
-    /**
-     * Get pagination params for API call
-     * Returns 0-based page for backend API
-     */
-    protected getPaginationParams(): {
-        currentPage: number;
-        pageSize: number;
-    };
-    /**
-     * Show success toast message
-     */
-    protected showSuccess(detail: string, summary?: string): void;
-    /**
-     * Show error toast message
-     */
-    protected showError(detail: string, summary?: string): void;
-    /**
-     * Show info toast message
-     */
-    protected showInfo(detail: string, summary?: string): void;
-    /**
-     * 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
-     * @param idGetter Function to extract ID from item
-     * @param deleteApiCall Function that returns Observable for delete API call
-     * @param options Optional configuration
-     */
-    onDelete(item: T, idGetter: (item: T) => string, deleteApiCall: (id: string) => Observable<unknown> | Promise<unknown>, options?: {
-        header?: string;
-    }): void;
-    /**
-     * Delete an item with confirmation dialog using async/await
-     * @param item The item to delete
-     * @param idGetter Function to extract ID from item
-     * @param deleteApiCall Async function for delete API call
-     * @param options Optional configuration
-     */
-    onDeleteAsync(item: T, idGetter: (item: T) => string, deleteApiCall: (id: string) => Promise<unknown>, options?: {
-        header?: string;
-    }): Promise<void>;
-    /**
-     * Navigate to a route
-     */
-    protected navigateTo(path: string[]): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BaseListPage<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BaseListPage<any>, never, never, {}, {}, never, never, true, never>;
-}
-
 declare function localToUtc(dateStr: string, timeStr: string, timezone: string): Date;
 declare function utcToLocal(utcDate: Date | string, timezone: string): {
     date: string;
@@ -1782,5 +1498,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, CookieService, EMAIL_CONFIG_PERMISSIONS, EMAIL_TEMPLATE_PERMISSIONS, EVENT_PERMISSIONS, EditModeElementChangerDirective, FILE_PERMISSIONS, FILE_PROVIDER, FILE_TYPE_FILTERS, FOLDER_PERMISSIONS, FORM_PERMISSIONS, FORM_RESULT_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, SKIP_ERROR_TOAST, STORAGE_CONFIG_PERMISSIONS, TRANSLATION_KEY_PERMISSIONS, TRANSLATION_PERMISSIONS, TranslatePipe, TranslateService, UPLOAD_CONFIG_PERMISSIONS, USER_ACTION_PERMISSIONS, USER_PERMISSIONS, USER_PERMISSION_PROVIDER, USER_PROVIDER, USER_ROLE_PERMISSIONS, UserMultiSelectComponent, UserSelectComponent, allPermissionsGuard, anyPermissionGuard, checkScrollPagination, errorCatchingInterceptor, evaluateLogicNode, evaluatePermission, formatFileSize, formatInTimezone, getAcceptString, getFileIconClass, getUserTimezone, hasAllPermissions, hasAnyPermission, hasPermission, isFileTypeAllowed, localToUtc, permissionGuard, provideValueAccessor, resolveTranslationModule, utcToLocal };
+export { ACTION_PERMISSIONS, AUTH_STATE_PROVIDER, AngularModule, ApiResourceService, ApiResourceService as ApiService, BRANCH_PERMISSIONS, BaseFormControl, BaseUserSelectComponent, COMPANY_ACTION_PERMISSIONS, COMPANY_API_PROVIDER, COMPANY_PERMISSIONS, CookieService, EMAIL_CONFIG_PERMISSIONS, EMAIL_TEMPLATE_PERMISSIONS, EVENT_PERMISSIONS, EditModeElementChangerDirective, FILE_PERMISSIONS, FILE_PROVIDER, FILE_TYPE_FILTERS, FOLDER_PERMISSIONS, FORM_PERMISSIONS, FORM_RESULT_PERMISSIONS, FaviconService, FileSelectorDialogComponent, FileUploaderComponent, FileUrlService, HasPermissionDirective, IconComponent, IconTypeEnum, InlineSvgComponent, IsEmptyImageDirective, LANGUAGE_PERMISSIONS, LazyMultiSelectComponent, LazySelectComponent, NOTIFICATION_PERMISSIONS, PERMISSIONS, PROFILE_PERMISSION_PROVIDER, PermissionValidatorService, PlatformService, PreventDefaultDirective, PrimeModule, ROLE_ACTION_PERMISSIONS, ROLE_PERMISSIONS, SHARED_MESSAGES, SKIP_ERROR_TOAST, STORAGE_CONFIG_PERMISSIONS, TRANSLATION_KEY_PERMISSIONS, TRANSLATION_PERMISSIONS, TranslatePipe, TranslateService, UPLOAD_CONFIG_PERMISSIONS, USER_ACTION_PERMISSIONS, USER_PERMISSIONS, USER_PERMISSION_PROVIDER, USER_PROVIDER, USER_ROLE_PERMISSIONS, UserMultiSelectComponent, UserSelectComponent, allPermissionsGuard, anyPermissionGuard, checkScrollPagination, errorCatchingInterceptor, evaluateLogicNode, evaluatePermission, formatFileSize, formatInTimezone, getAcceptString, getFileIconClass, getUserTimezone, hasAllPermissions, hasAnyPermission, hasPermission, isFileTypeAllowed, localToUtc, permissionGuard, provideValueAccessor, resolveTranslationModule, utcToLocal };
 export type { DeleteType, FilesResponseDto, IActionNode, IActivatable, IApiService, IAuthStateProvider, IBaseEntity, IBulkMeta, IBulkResponse, ICompanyApiProvider, ICompanyBasicInfo, IDeleteData, IDropDown, IFileBasicInfo, IFileProvider, IFileSelectFilter, IFileUploadOptions, IFilter, IFilterData, IFolderBasicInfo, IGroupNode, IListResponse, ILoggedUserInfo, ILogicNode, IMessageResponse, IOrderable, IPagination, IPaginationMeta, IProfileActionInfo, IProfilePermissionProvider, IProfileRoleInfo, IRequestMeta, IResolverModuleConfig, ISelectFilter, ISingleResponse, ISoftDeletable, ISort, IStorageConfigBasicInfo, ITimestampable, IUploadedFile, IUserBasicInfo, IUserBranchPermission, IUserPermissionProvider, IUserProvider, IUserSelectFilter, LoadUsersFn, PermissionCode, ScrollPaginationConfig, UploadFileFn, UploadMultipleFilesFn };