@flusys/ng-shared 1.1.0-beta → 1.1.0

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

@@ -1,11 +1,11 @@
-import * as _angular_core from '@angular/core';
-import { Signal, Injector, ResourceRef, model, ElementRef, InjectionToken } from '@angular/core';
 import { Observable } from 'rxjs';
+import * as _angular_core from '@angular/core';
+import { Signal, Injector, ResourceRef, model, ElementRef, DestroyRef, InjectionToken } from '@angular/core';
 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 } 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';
@@ -46,45 +46,190 @@ import * as i36 from 'primeng/tooltip';
 import * as i37 from 'primeng/treetable';
 import * as _flusys_ng_shared from '@flusys/ng-shared';
 import { HttpClient, HttpParams, HttpHeaders } from '@angular/common/http';
-import { ApiLoaderService } from '@flusys/ng-core';
 import { FormValueControl } from '@angular/forms/signals';
+import { MessageService, ConfirmationService } from 'primeng/api';
+import * as _flusys_ng_core from '@flusys/ng-core';
 
 /**
- * Auth State Provider Interface
+ * Centralized Permission Codes
  *
- * Abstracts auth state access for feature packages (form-builder, etc.)
- * that need to check authentication status without depending on ng-auth directly.
+ * Single source of truth for all permission codes used across the application.
+ * Use these constants instead of hardcoded strings to prevent typos and enable easy refactoring.
  *
- * @example
- * // In form-builder component
- * class PublicFormPageComponent {
- *   private readonly authStateProvider = inject(AUTH_STATE_PROVIDER);
- *
- *   ngOnInit() {
- *     this.authStateProvider.initialize().subscribe({
- *       next: () => this.checkFormAccess(),
- *       error: () => this.checkFormAccess(),
- *     });
- *   }
- *
- *   checkAccess() {
- *     if (this.authStateProvider.isAuthenticated()) {
- *       // User is logged in
- *     }
- *   }
- * }
+ * Naming Convention: <entity>.<action>
+ * - entity: The resource being accessed (e.g., user, role, company)
+ * - action: The operation being performed (create, read, update, delete, assign)
  */
-interface IAuthStateProvider {
-    /**
-     * Signal indicating if user is currently authenticated
-     */
-    isAuthenticated: Signal<boolean>;
-    /**
-     * Initialize auth state (restore session from cookies/storage)
-     * Call this before checking isAuthenticated for users returning after login
-     */
-    initialize(): Observable<void>;
-}
+declare const USER_PERMISSIONS: {
+    readonly CREATE: "user.create";
+    readonly READ: "user.read";
+    readonly UPDATE: "user.update";
+    readonly DELETE: "user.delete";
+};
+declare const COMPANY_PERMISSIONS: {
+    readonly CREATE: "company.create";
+    readonly READ: "company.read";
+    readonly UPDATE: "company.update";
+    readonly DELETE: "company.delete";
+};
+declare const BRANCH_PERMISSIONS: {
+    readonly CREATE: "branch.create";
+    readonly READ: "branch.read";
+    readonly UPDATE: "branch.update";
+    readonly DELETE: "branch.delete";
+};
+declare const ACTION_PERMISSIONS: {
+    readonly CREATE: "action.create";
+    readonly READ: "action.read";
+    readonly UPDATE: "action.update";
+    readonly DELETE: "action.delete";
+};
+declare const ROLE_PERMISSIONS: {
+    readonly CREATE: "role.create";
+    readonly READ: "role.read";
+    readonly UPDATE: "role.update";
+    readonly DELETE: "role.delete";
+};
+declare const ROLE_ACTION_PERMISSIONS: {
+    readonly READ: "role-action.read";
+    readonly ASSIGN: "role-action.assign";
+};
+declare const USER_ROLE_PERMISSIONS: {
+    readonly READ: "user-role.read";
+    readonly ASSIGN: "user-role.assign";
+};
+declare const USER_ACTION_PERMISSIONS: {
+    readonly READ: "user-action.read";
+    readonly ASSIGN: "user-action.assign";
+};
+declare const COMPANY_ACTION_PERMISSIONS: {
+    readonly READ: "company-action.read";
+    readonly ASSIGN: "company-action.assign";
+};
+declare const FILE_PERMISSIONS: {
+    readonly CREATE: "file.create";
+    readonly READ: "file.read";
+    readonly UPDATE: "file.update";
+    readonly DELETE: "file.delete";
+};
+declare const FOLDER_PERMISSIONS: {
+    readonly CREATE: "folder.create";
+    readonly READ: "folder.read";
+    readonly UPDATE: "folder.update";
+    readonly DELETE: "folder.delete";
+};
+declare const STORAGE_CONFIG_PERMISSIONS: {
+    readonly CREATE: "storage-config.create";
+    readonly READ: "storage-config.read";
+    readonly UPDATE: "storage-config.update";
+    readonly DELETE: "storage-config.delete";
+};
+declare const EMAIL_CONFIG_PERMISSIONS: {
+    readonly CREATE: "email-config.create";
+    readonly READ: "email-config.read";
+    readonly UPDATE: "email-config.update";
+    readonly DELETE: "email-config.delete";
+};
+declare const EMAIL_TEMPLATE_PERMISSIONS: {
+    readonly CREATE: "email-template.create";
+    readonly READ: "email-template.read";
+    readonly UPDATE: "email-template.update";
+    readonly DELETE: "email-template.delete";
+};
+declare const FORM_PERMISSIONS: {
+    readonly CREATE: "form.create";
+    readonly READ: "form.read";
+    readonly UPDATE: "form.update";
+    readonly DELETE: "form.delete";
+};
+/**
+ * All permission codes grouped by module
+ */
+declare const PERMISSIONS: {
+    readonly USER: {
+        readonly CREATE: "user.create";
+        readonly READ: "user.read";
+        readonly UPDATE: "user.update";
+        readonly DELETE: "user.delete";
+    };
+    readonly COMPANY: {
+        readonly CREATE: "company.create";
+        readonly READ: "company.read";
+        readonly UPDATE: "company.update";
+        readonly DELETE: "company.delete";
+    };
+    readonly BRANCH: {
+        readonly CREATE: "branch.create";
+        readonly READ: "branch.read";
+        readonly UPDATE: "branch.update";
+        readonly DELETE: "branch.delete";
+    };
+    readonly ACTION: {
+        readonly CREATE: "action.create";
+        readonly READ: "action.read";
+        readonly UPDATE: "action.update";
+        readonly DELETE: "action.delete";
+    };
+    readonly ROLE: {
+        readonly CREATE: "role.create";
+        readonly READ: "role.read";
+        readonly UPDATE: "role.update";
+        readonly DELETE: "role.delete";
+    };
+    readonly ROLE_ACTION: {
+        readonly READ: "role-action.read";
+        readonly ASSIGN: "role-action.assign";
+    };
+    readonly USER_ROLE: {
+        readonly READ: "user-role.read";
+        readonly ASSIGN: "user-role.assign";
+    };
+    readonly USER_ACTION: {
+        readonly READ: "user-action.read";
+        readonly ASSIGN: "user-action.assign";
+    };
+    readonly COMPANY_ACTION: {
+        readonly READ: "company-action.read";
+        readonly ASSIGN: "company-action.assign";
+    };
+    readonly FILE: {
+        readonly CREATE: "file.create";
+        readonly READ: "file.read";
+        readonly UPDATE: "file.update";
+        readonly DELETE: "file.delete";
+    };
+    readonly FOLDER: {
+        readonly CREATE: "folder.create";
+        readonly READ: "folder.read";
+        readonly UPDATE: "folder.update";
+        readonly DELETE: "folder.delete";
+    };
+    readonly STORAGE_CONFIG: {
+        readonly CREATE: "storage-config.create";
+        readonly READ: "storage-config.read";
+        readonly UPDATE: "storage-config.update";
+        readonly DELETE: "storage-config.delete";
+    };
+    readonly EMAIL_CONFIG: {
+        readonly CREATE: "email-config.create";
+        readonly READ: "email-config.read";
+        readonly UPDATE: "email-config.update";
+        readonly DELETE: "email-config.delete";
+    };
+    readonly EMAIL_TEMPLATE: {
+        readonly CREATE: "email-template.create";
+        readonly READ: "email-template.read";
+        readonly UPDATE: "email-template.update";
+        readonly DELETE: "email-template.delete";
+    };
+    readonly FORM: {
+        readonly CREATE: "form.create";
+        readonly READ: "form.read";
+        readonly UPDATE: "form.update";
+        readonly DELETE: "form.delete";
+    };
+};
+type PermissionCode = (typeof PERMISSIONS)[keyof typeof PERMISSIONS][keyof (typeof PERMISSIONS)[keyof typeof PERMISSIONS]];
 
 /**
  * Base entity interface - matches backend Identity entity
@@ -143,6 +288,61 @@ interface ILoggedUserInfo {
     companyLogoId?: string;
     branchLogoId?: string;
 }
+/**
+ * Simple dropdown item for select components
+ */
+interface IDropDown {
+    label: string;
+    value: string;
+}
+/**
+ * Delete operation types
+ * - 'delete': Soft delete (sets deletedAt timestamp)
+ * - 'restore': Restore soft-deleted item (clears deletedAt)
+ * - 'permanent': Permanently delete from database
+ */
+type DeleteType = 'delete' | 'restore' | 'permanent';
+/**
+ * Delete request payload - matches backend DeleteDto
+ */
+interface IDeleteData {
+    /** Single ID or array of IDs to delete */
+    id: string | string[];
+    /** Type of delete operation */
+    type: DeleteType;
+}
+/** Action node - checks a single permission */
+interface IActionNode {
+    type: 'action';
+    actionId: string;
+}
+/** Group node - combines children with AND/OR logic */
+interface IGroupNode {
+    type: 'group';
+    operator: 'AND' | 'OR';
+    children: ILogicNode[];
+}
+/** Permission logic tree (discriminated union of action/group) */
+type ILogicNode = IActionNode | IGroupNode;
+
+interface IPagination {
+    pageSize: number;
+    currentPage: number;
+}
+interface ISort {
+    [key: string]: 'ASC' | 'DESC';
+}
+interface IFilter {
+    [key: string]: string | number | boolean | null | undefined | string[] | number[];
+}
+interface IFilterData {
+    filter?: IFilter;
+    pagination?: IPagination;
+    select?: string[];
+    sort?: ISort;
+    withDeleted?: boolean;
+    extraKey?: string[];
+}
 
 /**
  * Request metadata added by backend ResponseMetaInterceptor
@@ -284,158 +484,6 @@ interface IFileData {
     createdAt: Date;
 }
 
-/**
- * Company basic info for dropdowns
- */
-interface ICompanyBasicInfo {
-    id: string;
-    name: string;
-    slug?: string;
-}
-interface ICompanyApiProvider {
-    /**
-     * Get list of companies with pagination
-     */
-    getCompanies(filter?: {
-        page?: number;
-        pageSize?: number;
-        search?: string;
-        [key: string]: any;
-    }): Observable<IListResponse<ICompanyBasicInfo>>;
-}
-
-/**
- * Delete operation types
- * - 'delete': Soft delete (sets deletedAt timestamp)
- * - 'restore': Restore soft-deleted item (clears deletedAt)
- * - 'permanent': Permanently delete from database
- */
-type DeleteType = 'delete' | 'restore' | 'permanent';
-/**
- * Delete request payload - matches backend DeleteDto
- */
-interface IDeleteData {
-    /** Single ID or array of IDs to delete */
-    id: string | string[];
-    /** Type of delete operation */
-    type: DeleteType;
-}
-
-interface IDropDown {
-    label: string;
-    value: string;
-}
-
-interface IPagination {
-    pageSize: number;
-    currentPage: number;
-}
-interface ISort {
-    [key: string]: 'ASC' | 'DESC';
-}
-interface IFilter {
-    [key: string]: any;
-}
-interface IFilterData {
-    filter?: IFilter;
-    pagination?: IPagination;
-    select?: string[];
-    sort?: ISort;
-    withDeleted?: boolean;
-    extraKey?: string[];
-}
-
-/** Action node - checks a single permission */
-interface IActionNode {
-    type: 'action';
-    actionId: string;
-}
-/** Group node - combines children with AND/OR logic */
-interface IGroupNode {
-    type: 'group';
-    operator: 'AND' | 'OR';
-    children: ILogicNode[];
-}
-/** Permission logic tree (discriminated union of action/group) */
-type ILogicNode = IActionNode | IGroupNode;
-
-/**
- * User Permission Provider Interface
- *
- * Abstracts user permission data access operations.
- * Implemented by auth package, used by IAM for user permission queries.
- *
- * @example
- * // In IAM component
- * class UserActionSelectorComponent {
- *   private readonly userPermissionProvider = inject(USER_PERMISSION_PROVIDER);
- *
- *   async loadUserBranches(userId: string) {
- *     const response = await this.userPermissionProvider
- *       .getUserBranchPermissions(userId, '')
- *       .toPromise();
- *     this.branches.set(response?.data ?? []);
- *   }
- * }
- */
-interface IUserPermissionProvider {
-    /**
-     * Get user's branch permissions
-     */
-    getUserBranchPermissions(userId: string): Observable<ISingleResponse<any>>;
-}
-
-/**
- * User data for dropdowns and selectors
- */
-interface IUserBasicInfo {
-    id: string;
-    name: string;
-    email: string;
-}
-/**
- * User Provider Interface
- *
- * Abstracts user data access for IAM and other feature packages.
- * Implemented by auth package, used by IAM for user selection in permission assignment.
- *
- * @example
- * // In IAM component
- * class UserActionSelectorComponent {
- *   private readonly userProvider = inject(USER_PROVIDER);
- *
- *   loadUsers() {
- *     this.userProvider.getUsers({ page: 0, pageSize: 50 }).subscribe(users => {
- *       this.users.set(users.data);
- *     });
- *   }
- * }
- */
-interface IUserProvider {
-    /**
-     * Get list of users with pagination
-     * @param filter Optional filter (page, pageSize, search, etc.)
-     */
-    getUsers(filter?: {
-        page?: number;
-        pageSize?: number;
-        search?: string;
-        companyId?: string;
-        branchId?: string;
-        [key: string]: any;
-    }): Observable<IListResponse<IUserBasicInfo>>;
-}
-
-/** Filter params passed to loadUsers function */
-interface IUserSelectFilter {
-    page: number;
-    pageSize: number;
-    search: string;
-    [key: string]: unknown;
-}
-/** Function type for loading users */
-type LoadUsersFn = (filter: IUserSelectFilter) => Observable<IListResponse<IUserBasicInfo>>;
-
 /**
  * Basic file info for selectors and displays
  */
@@ -476,7 +524,6 @@ interface IFileSelectFilter {
     search: string;
     contentTypes?: string[];
     folderId?: string;
-    [key: string]: unknown;
 }
 /**
  * Function type for loading files
@@ -517,6 +564,79 @@ declare function getFileIconClass(contentType: string): string;
  */
 declare function formatFileSize(sizeInKb: string | number): string;
 
+/**
+ * Auth State Provider Interface
+ *
+ * Abstracts auth state access for feature packages (form-builder, etc.)
+ * that need to check authentication status without depending on ng-auth directly.
+ */
+interface IAuthStateProvider {
+    /** Signal indicating if user is currently authenticated */
+    isAuthenticated: Signal<boolean>;
+    /** Initialize auth state (restore session from cookies/storage) */
+    initialize(): Observable<void>;
+}
+/**
+ * User data for dropdowns and selectors
+ */
+interface IUserBasicInfo {
+    id: string;
+    name: string;
+    email: string;
+}
+/**
+ * User Provider Interface - Abstracts user data access for IAM and other feature packages.
+ */
+interface IUserProvider {
+    getUsers(filter?: {
+        page?: number;
+        pageSize?: number;
+        search?: string;
+        companyId?: string;
+        branchId?: string;
+        isActive?: boolean;
+    }): Observable<IListResponse<IUserBasicInfo>>;
+}
+/** Filter params passed to loadUsers function */
+interface IUserSelectFilter {
+    page: number;
+    pageSize: number;
+    search: string;
+}
+/** Function type for loading users */
+type LoadUsersFn = (filter: IUserSelectFilter) => Observable<IListResponse<IUserBasicInfo>>;
+/**
+ * User branch permission data
+ */
+interface IUserBranchPermission {
+    branchId: string;
+    branchName: string;
+    companyId: string;
+}
+/**
+ * User Permission Provider Interface - Abstracts user permission data access operations.
+ */
+interface IUserPermissionProvider {
+    getUserBranchPermissions(userId: string): Observable<ISingleResponse<IUserBranchPermission[]>>;
+}
+/**
+ * Company basic info for dropdowns
+ */
+interface ICompanyBasicInfo {
+    id: string;
+    name: string;
+    slug?: string;
+}
+/**
+ * Company API Provider Interface
+ */
+interface ICompanyApiProvider {
+    getCompanies(filter?: {
+        page?: number;
+        pageSize?: number;
+        search?: string;
+    }): Observable<IListResponse<ICompanyBasicInfo>>;
+}
 /**
  * User role info for profile display
  */
@@ -535,89 +655,39 @@ interface IProfileActionInfo {
     description?: string | null;
 }
 /**
- * Profile Permission Provider Interface
- *
- * Abstracts permission data access for profile page.
- * Implemented by ng-iam, consumed by ng-auth profile page.
- * Optional injection - if not provided, permissions section is hidden.
- *
- * @example
- * // In profile component
- * private readonly permissionProvider = inject(PROFILE_PERMISSION_PROVIDER, { optional: true });
- *
- * ngOnInit() {
- *   if (this.permissionProvider) {
- *     this.loadPermissions();
- *   }
- * }
+ * Profile Permission Provider Interface - Abstracts permission data access for profile page.
  */
 interface IProfilePermissionProvider {
-    /**
-     * Get user's assigned roles
-     * @param userId User ID
-     * @param branchId Optional branch ID for branch-scoped roles
-     */
     getUserRoles(userId: string, branchId?: string): Observable<ISingleResponse<IProfileRoleInfo[]>>;
-    /**
-     * Get user's direct actions
-     * @param userId User ID
-     * @param branchId Optional branch ID for branch-scoped actions
-     */
     getUserActions(userId: string, branchId?: string): Observable<ISingleResponse<IProfileActionInfo[]>>;
 }
-
 /**
  * Uploaded file result with file manager ID
  */
 interface IProfileUploadResult {
-    /** File manager ID (UUID) for storing in profilePictureId */
     id: string;
-    /** Original file name */
     name: string;
-    /** Storage key/path */
     key: string;
-    /** File size in bytes */
     size: number;
-    /** MIME type */
     contentType: string;
 }
 /**
  * Profile Upload Options
  */
 interface IProfileUploadOptions {
-    /** Folder path for organizing uploads */
     folderPath?: string;
-    /** Enable image compression */
     compress?: boolean;
-    /** Max width for image compression */
     maxWidth?: number;
-    /** Max height for image compression */
     maxHeight?: number;
 }
 /**
- * Profile Upload Provider Interface
- *
- * Provides file upload functionality for profile pictures.
- * Implemented by ng-storage, consumed by ng-auth profile page.
- *
- * This interface enables ng-auth to use storage functionality
- * without directly depending on ng-storage package.
+ * Profile Upload Provider Interface - Provides file upload functionality for profile pictures.
  */
 interface IProfileUploadProvider {
-    /**
-     * Upload profile picture and register in file manager
-     * Returns file manager ID (UUID) for storing in user.profilePictureId
-     *
-     * @param file - File to upload
-     * @param options - Upload options (compression, folder, etc.)
-     * @returns Observable with upload result including file manager ID
-     */
     uploadProfilePicture(file: File, options?: IProfileUploadOptions): Observable<ISingleResponse<IProfileUploadResult>>;
 }
-
 /**
  * Base user interface for list operations
- * Extends this with app-specific user fields
  */
 interface IUserListItem {
     id: string;
@@ -625,140 +695,56 @@ interface IUserListItem {
     email: string;
     phone?: string;
     isActive?: boolean;
-    [key: string]: unknown;
 }
 /**
  * User list action definition
- * @template T User type, defaults to IUserListItem
  */
 interface IUserListAction<T = IUserListItem> {
-    /** Unique action identifier */
     id: string;
-    /** Display label */
     label: string;
-    /** PrimeNG icon class (e.g., 'pi pi-pencil') */
     icon?: string;
-    /** Severity for styling (e.g., 'primary', 'danger', 'warning') */
     severity?: 'primary' | 'secondary' | 'success' | 'info' | 'warn' | 'danger' | 'help' | 'contrast';
-    /** Permission code required (checked via hasPermission) */
     permission?: string;
-    /** Tooltip text */
     tooltip?: string;
-    /** Whether action is disabled */
     disabled?: boolean | ((user: T) => boolean);
-    /** Whether action is visible */
     visible?: boolean | ((user: T) => boolean);
 }
 /**
  * Extra column definition for user list
  */
 interface IUserListColumn {
-    /** Column field name */
     field: string;
-    /** Column header label */
     header: string;
-    /** Column width */
     width?: string;
-    /** Whether column is sortable */
     sortable?: boolean;
-    /** Whether column is filterable */
     filterable?: boolean;
-    /** Custom template type for rendering */
     templateType?: 'text' | 'badge' | 'date' | 'boolean' | 'custom';
 }
-/**
- * User List Provider Interface
- *
- * Allows consuming applications to extend user list pages with:
- * - Extra columns
- * - Extra row actions
- * - Extra toolbar actions
- * - Custom data enrichment
- *
- * This follows the Provider Interface Pattern:
- * - ng-shared defines the interface (this file)
- * - Consuming apps (via ng-iam or app-specific) implement the interface
- * - ng-auth user list optionally injects and uses the implementation
- *
- * @template T User type, defaults to IUserListItem
- *
- * @example
- * // In app.config.ts
- * providers: [
- *   { provide: USER_LIST_PROVIDER, useClass: MyUserListProvider },
- * ]
- *
- * // Implementation
- * @Injectable({ providedIn: 'root' })
- * export class MyUserListProvider implements IUserListProvider {
- *   getExtraRowActions() {
- *     return [
- *       { id: 'assign-role', label: 'Assign Role', icon: 'pi pi-users' },
- *     ];
- *   }
- * }
- */
-interface IUserListProvider<T extends IUserListItem = IUserListItem> {
-    /**
-     * Get extra columns to display in user list
-     * @returns Array of extra column definitions
-     */
-    getExtraColumns?(): IUserListColumn[];
-    /**
-     * Get extra row-level actions (per-user actions)
-     * Displayed in actions column for each row
-     * @returns Array of action definitions
-     */
-    getExtraRowActions?(): IUserListAction<T>[];
-    /**
-     * Get extra toolbar actions
-     * Displayed in toolbar above the list
-     * @returns Array of action definitions
-     */
-    getExtraToolbarActions?(): IUserListAction<T>[];
-    /**
-     * Handle row action click
-     * @param actionId Action identifier
-     * @param user User data from the row
-     */
-    onRowAction?(actionId: string, user: T): void;
-    /**
-     * Handle toolbar action click
-     * @param actionId Action identifier
-     * @param selectedUsers Currently selected users (for bulk actions)
-     */
-    onToolbarAction?(actionId: string, selectedUsers: T[]): void;
-    /**
-     * Enrich user list data with extra fields
-     * Called after data is loaded from API
-     * @param users List of users from API
-     * @returns Observable of enriched users
-     */
-    enrichListData?(users: T[]): Observable<T[]>;
-    /**
-     * Get extra filters for user list
-     * @returns Array of filter definitions
-     */
-    getExtraFilters?(): IUserListFilter[];
-}
 /**
  * Extra filter definition for user list
  */
 interface IUserListFilter {
-    /** Filter field name */
     field: string;
-    /** Filter label */
     label: string;
-    /** Filter type */
     type: 'text' | 'dropdown' | 'multiselect' | 'date' | 'boolean';
-    /** Options for dropdown/multiselect */
     options?: {
         label: string;
         value: string | number | boolean;
     }[];
-    /** Placeholder text */
     placeholder?: string;
 }
+/**
+ * User List Provider Interface - Allows apps to extend user list pages.
+ */
+interface IUserListProvider<T extends IUserListItem = IUserListItem> {
+    getExtraColumns?(): IUserListColumn[];
+    getExtraRowActions?(): IUserListAction<T>[];
+    getExtraToolbarActions?(): IUserListAction<T>[];
+    onRowAction?(actionId: string, user: T): void;
+    onToolbarAction?(actionId: string, selectedUsers: T[]): void;
+    enrichListData?(users: T[]): Observable<T[]>;
+    getExtraFilters?(): IUserListFilter[];
+}
 
 declare enum ContactTypeEnum {
     PHONE = 1,
@@ -780,15 +766,6 @@ declare class CookieService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<CookieService>;
 }
 
-/**
- * Request DTO for fetching file URLs
- */
-interface GetFilesRequestDto {
-    id: string;
-}
-/**
- * Response DTO with file information including URL
- */
 interface FilesResponseDto {
     id: string;
     name: string;
@@ -797,113 +774,47 @@ interface FilesResponseDto {
 }
 /**
  * Service to fetch file URLs from the backend.
- * Uses POST /file-manager/get-files endpoint which:
- * - Handles presigned URLs for cloud storage (AWS S3, Azure)
- * - Auto-refreshes expired URLs
- * - Validates file access permissions
- * - Works with all storage providers (Local, S3, Azure, SFTP)
+ * Handles presigned URLs for cloud storage, auto-refresh, and caching.
  */
 declare class FileUrlService {
     private readonly http;
     private readonly appConfig;
-    /** Cache of file URLs by file ID */
-    private readonly urlCache;
-    /**
-     * Get file URL by ID from cache (reactive signal)
-     */
+    private readonly _cache;
+    readonly cache: Signal<Map<string, FilesResponseDto>>;
+    /** Get file URL by ID from cache (synchronous) */
     getFileUrl(fileId: string | null | undefined): string | null;
-    /**
-     * Get file URL signal (computed from cache)
-     */
-    fileUrlSignal(fileId: string | null | undefined): _angular_core.Signal<string | null>;
-    /**
-     * Fetch file URLs from backend and update cache.
-     * Skips IDs already in cache to prevent duplicate calls.
-     * Returns Observable of fetched files (including cached ones).
-     */
+    /** Get file URL as computed signal */
+    fileUrlSignal(fileId: string | null | undefined): Signal<string | null>;
+    /** Fetch file URLs from backend and update cache */
     fetchFileUrls(fileIds: string[], forceRefresh?: boolean): Observable<FilesResponseDto[]>;
-    /**
-     * Fetch a single file URL.
-     * Uses cache if available to prevent duplicate calls.
-     * Returns Observable of file info or null if not found.
-     */
+    /** Fetch single file URL (delegates to fetchFileUrls) */
     fetchSingleFileUrl(fileId: string, forceRefresh?: boolean): Observable<FilesResponseDto | null>;
-    /**
-     * Clear the URL cache.
-     * Useful on logout or when switching contexts.
-     */
+    /** Clear entire cache */
     clearCache(): void;
-    /**
-     * Remove specific file from cache.
-     */
+    /** Remove specific file from cache */
     removeFromCache(fileId: string): void;
+    private addToCache;
+    private getFromCache;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileUrlService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<FileUrlService>;
 }
 
 /**
- * Permission Validator Service
- *
- * Centralized service for permission validation across all packages.
- * Provides signal-based state management and reactive permission checking.
- *
- * Features:
- * - Signal-based permission storage
- * - Individual permission checks
- * - Permission change detection
- * - Reactive permission state updates
- *
- * Usage:
- * ```typescript
- * // In component
- * readonly permissionValidator = inject(PermissionValidatorService);
- *
- * // Set permissions (typically from auth/IAM)
- * this.permissionValidator.setPermissions(['user.view', 'user.create']);
- *
- * // Check individual permission
- * if (this.permissionValidator.hasPermission('user.view')) {
- *   // Show UI element
- * }
- *
- * // Access current permissions reactively
- * const permissions = this.permissionValidator.permissions();
- * ```
- *
- * @packageDocumentation
+ * Permission state management service.
+ * Provides signal-based storage and permission checking with wildcard support.
  */
 declare class PermissionValidatorService {
-    /**
-     * Private writable signal for permissions
-     */
     private readonly _permissions;
-    /**
-     * Readonly permission signal for external consumers
-     */
     readonly permissions: _angular_core.Signal<string[]>;
-    /**
-     * Private writable signal for loaded state
-     */
     private readonly _isLoaded;
-    /**
-     * Set permissions (replaces existing permissions)
-     * @param permissions - Array of permission codes
-     */
+    readonly isLoaded: _angular_core.Signal<boolean>;
+    /** Set permissions (replaces existing) */
     setPermissions(permissions: string[]): void;
-    /**
-     * Clear all permissions
-     */
+    /** Clear all permissions */
     clearPermissions(): void;
-    /**
-     * Check if user has a specific permission
-     * @param permissionCode - Required permission code
-     * @returns True if user has permission
-     */
-    hasPermission(permissionCode: string): boolean;
-    /**
-     * Check if permissions are loaded
-     * @returns True if permissions have been loaded
-     */
+    /** Check if user has permission (supports wildcards: '*', 'module.*') */
+    hasPermission(code: string): boolean;
+    /** @deprecated Use `isLoaded()` signal instead */
     isPermissionsLoaded(): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PermissionValidatorService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<PermissionValidatorService>;
@@ -1015,9 +926,9 @@ declare class IsEmptyImageDirective {
 }
 
 declare class PreventDefaultDirective {
-    eventType: _angular_core.InputSignal<"click" | "keydown" | "keyup">;
-    preventKey: _angular_core.InputSignal<string | undefined>;
-    action: _angular_core.OutputEmitterRef<Event>;
+    readonly eventType: _angular_core.InputSignal<"click" | "keydown" | "keyup">;
+    readonly preventKey: _angular_core.InputSignal<string | undefined>;
+    readonly action: _angular_core.OutputEmitterRef<Event>;
     onClick(event: MouseEvent): void;
     onKeydown(event: KeyboardEvent): void;
     onKeyup(event: KeyboardEvent): void;
@@ -1028,7 +939,7 @@ declare class PreventDefaultDirective {
 
 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 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 IsEmptyImageDirective, typeof i1.NgOptimizedImage, typeof i1.NgComponentOutlet, typeof PreventDefaultDirective]>;
+    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]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AngularModule>;
 }
 
@@ -1038,6 +949,9 @@ declare class PrimeModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<PrimeModule>;
 }
 
+/** Service names that can be used for feature-specific base URLs */
+type ServiceName = 'auth' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email';
+
 /**
  * Service interface for CRUD operations.
  * Matches NestJS shared API controller endpoints:
@@ -1079,11 +993,20 @@ interface IApiService<DtoT, InterfaceT> {
  *
  * @example
  * ```typescript
- * // Define service
+ * // Define service with global apiBaseUrl
  * @Injectable({ providedIn: 'root' })
  * export class UserService extends ApiResourceService<UserDto, User> {
- *   constructor(http: HttpClient) {
- *     super('users', http);
+ *   constructor() {
+ *     super('auth/users', inject(HttpClient));
+ *   }
+ * }
+ *
+ * // Define service with feature-specific baseUrl
+ * @Injectable({ providedIn: 'root' })
+ * export class FormService extends ApiResourceService<FormDto, Form> {
+ *   constructor() {
+ *     super('form', inject(HttpClient), 'formBuilder');
+ *     // URL: services.formBuilder.baseUrl + '/form'
  *   }
  * }
  *
@@ -1104,7 +1027,6 @@ interface IApiService<DtoT, InterfaceT> {
  */
 declare abstract class ApiResourceService<DtoT, InterfaceT> implements IApiService<DtoT, InterfaceT> {
     protected readonly baseUrl: string;
-    protected readonly loaderService: ApiLoaderService;
     protected readonly injector: Injector;
     protected readonly http: HttpClient;
     protected readonly moduleApiName: string;
@@ -1119,6 +1041,12 @@ declare abstract class ApiResourceService<DtoT, InterfaceT> implements IApiServi
     private _listResource;
     /** Whether the list resource has been initialized */
     private _resourceInitialized;
+    /**
+     * Signal to track resource initialization for computed signals.
+     * This allows computed signals to re-evaluate when the resource is created.
+     * Without this, computed signals would not detect when _listResource changes from null.
+     */
+    private readonly _resourceInitSignal;
     /** Get or create the list resource (lazy initialization) */
     get listResource(): ResourceRef<IListResponse<InterfaceT> | undefined>;
     /**
@@ -1127,17 +1055,37 @@ declare abstract class ApiResourceService<DtoT, InterfaceT> implements IApiServi
      * Uses runInInjectionContext to support lazy initialization outside constructor.
      */
     initListResource(): void;
-    /** Whether data is currently loading */
+    /**
+     * Whether data is currently loading.
+     * Tracks _resourceInitSignal to re-evaluate when resource is created.
+     */
     readonly isLoading: _angular_core.Signal<boolean>;
-    /** List data array */
+    /**
+     * List data array.
+     * Tracks _resourceInitSignal to re-evaluate when resource is created.
+     */
     readonly data: _angular_core.Signal<InterfaceT[]>;
-    /** Total count of items */
+    /**
+     * Total count of items.
+     * Tracks _resourceInitSignal to re-evaluate when resource is created.
+     */
     readonly total: _angular_core.Signal<number>;
-    /** Pagination metadata */
+    /**
+     * Pagination metadata.
+     * Tracks _resourceInitSignal to re-evaluate when resource is created.
+     */
     readonly pageInfo: _angular_core.Signal<_flusys_ng_shared.IPaginationMeta | undefined>;
-    /** Whether there are more pages */
+    /**
+     * Whether there are more pages.
+     * Tracks _resourceInitSignal to re-evaluate when resource is created.
+     */
     readonly hasMore: _angular_core.Signal<boolean>;
-    constructor(moduleApiName: string, http: HttpClient);
+    /**
+     * @param moduleApiName - The API resource path (e.g., 'form' for /form-builder/form)
+     * @param http - HttpClient instance
+     * @param serviceName - Optional service name for feature-specific base URL (e.g., 'formBuilder')
+     */
+    constructor(moduleApiName: string, http: HttpClient, serviceName?: ServiceName);
     protected getHttpOptions(endpoint: string, params?: HttpParams): {
         params?: HttpParams | undefined;
         headers: HttpHeaders;
@@ -1228,14 +1176,6 @@ declare abstract class ApiResourceService<DtoT, InterfaceT> implements IApiServi
     deleteAsync(deleteDto: IDeleteData): Promise<IMessageResponse>;
 }
 
-declare class IconComponent {
-    icon: _angular_core.InputSignal<string>;
-    iconType: _angular_core.InputSignal<IconTypeEnum | undefined>;
-    protected readonly IconTypeEnum: typeof IconTypeEnum;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<IconComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconComponent, "lib-icon", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "iconType": { "alias": "iconType"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
 /**
  * Base class for form controls that support ALL Angular form patterns:
  *
@@ -1308,6 +1248,31 @@ declare abstract class BaseFormControl<T> implements ControlValueAccessor, FormV
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BaseFormControl<any>, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BaseFormControl<any>, never, never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; }, { "disabled": "disabledChange"; "touched": "touchedChange"; }, never, never, true, never>;
 }
+/**
+ * Factory function to provide NG_VALUE_ACCESSOR for a component.
+ * Use in component providers array.
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   providers: [provideValueAccessor(LazySelectComponent)]
+ * })
+ * export class LazySelectComponent extends BaseFormControl<string | null> {}
+ * ```
+ */
+declare function provideValueAccessor<T extends new (...args: unknown[]) => ControlValueAccessor>(component: T): {
+    provide: _angular_core.InjectionToken<readonly ControlValueAccessor[]>;
+    useExisting: _angular_core.Type<any>;
+    multi: boolean;
+};
+
+declare class IconComponent {
+    icon: _angular_core.InputSignal<string>;
+    iconType: _angular_core.InputSignal<IconTypeEnum | undefined>;
+    protected readonly IconTypeEnum: typeof IconTypeEnum;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<IconComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconComponent, "lib-icon", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "iconType": { "alias": "iconType"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
 
 /**
  * Lazy-loading multi-select component with search, pagination, and select-all.
@@ -1318,31 +1283,28 @@ declare abstract class BaseFormControl<T> implements ControlValueAccessor, FormV
  * - Signal forms: `[formField]="formTree.field"`
  */
 declare class LazyMultiSelectComponent extends BaseFormControl<string[] | null> {
+    private readonly destroyRef;
+    private readonly onDocumentClickBound;
+    readonly pSelectRef: _angular_core.Signal<ElementRef<HTMLDivElement>>;
     readonly placeHolder: _angular_core.InputSignal<string>;
     readonly isEditMode: _angular_core.InputSignal<boolean>;
     readonly isLoading: _angular_core.InputSignal<boolean>;
     readonly total: _angular_core.InputSignal<number | undefined>;
     readonly pagination: _angular_core.InputSignal<IPagination>;
     readonly selectDataList: _angular_core.InputSignal<IDropDown[]>;
-    /** Two-way bound value using model() for signal forms compatibility */
     readonly value: _angular_core.ModelSignal<string[] | null>;
     readonly onSearch: _angular_core.OutputEmitterRef<string>;
     readonly onPagination: _angular_core.OutputEmitterRef<IPagination>;
     readonly searchTerm: _angular_core.WritableSignal<string>;
-    /** Computed: Display text for selected values (replaces getSelectedValue method) */
+    readonly openOptions: _angular_core.WritableSignal<boolean>;
     readonly selectedValueDisplay: _angular_core.Signal<string>;
-    /** Computed: Whether all items are selected (replaces isSelectAll signal) */
     readonly isSelectAll: _angular_core.Signal<boolean>;
     constructor();
-    private readonly onScrollBound;
-    readonly multiScrollContainer: _angular_core.Signal<ElementRef<HTMLDivElement>>;
     onScroll(event: Event): void;
-    readonly pSelectRef: _angular_core.Signal<ElementRef<HTMLDivElement>>;
-    openOptions: _angular_core.WritableSignal<boolean>;
     onSelectClick(event: Event): void;
     onOverlayClick(event: Event): void;
-    handleDocumentClick(event: MouseEvent): void;
-    isSelected(data: IDropDown): boolean | undefined;
+    private handleDocumentClick;
+    isSelected(data: IDropDown): boolean;
     key(option: IDropDown): string;
     selectValue(event: CheckboxChangeEvent, option: IDropDown): void;
     changeSelectAll(event: CheckboxChangeEvent): void;
@@ -1360,6 +1322,10 @@ declare class LazyMultiSelectComponent extends BaseFormControl<string[] | null>
  * - Signal forms: `[formField]="formTree.field"`
  */
 declare class LazySelectComponent extends BaseFormControl<string | null> {
+    private readonly destroyRef;
+    private readonly onScrollBound;
+    private scrollTargetEl;
+    readonly scrollContainer: _angular_core.Signal<ElementRef<HTMLDivElement>>;
     readonly placeHolder: _angular_core.InputSignal<string>;
     readonly optionLabel: _angular_core.InputSignal<string>;
     readonly optionValue: _angular_core.InputSignal<string>;
@@ -1368,16 +1334,12 @@ declare class LazySelectComponent extends BaseFormControl<string | null> {
     readonly total: _angular_core.InputSignal<number | undefined>;
     readonly pagination: _angular_core.InputSignal<IPagination>;
     readonly selectDataList: _angular_core.InputSignal<IDropDown[]>;
-    /** Two-way bound value using model() for signal forms compatibility */
     readonly value: _angular_core.ModelSignal<string | null>;
     readonly onSearch: _angular_core.OutputEmitterRef<string>;
     readonly onPagination: _angular_core.OutputEmitterRef<IPagination>;
     readonly searchTerm: _angular_core.WritableSignal<string>;
+    readonly isPanelShow: _angular_core.WritableSignal<boolean>;
     constructor();
-    isPanelShow: _angular_core.WritableSignal<boolean>;
-    scrollTargetEl: HTMLElement | null;
-    private readonly onScrollBound;
-    readonly scrollContainer: _angular_core.Signal<ElementRef<HTMLDivElement>>;
     onScroll(event: Event): void;
     showPanel(): void;
     onBlur(): void;
@@ -1385,6 +1347,45 @@ declare class LazySelectComponent extends BaseFormControl<string | null> {
     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>;
 }
 
+/**
+ * Base class for user selection components.
+ * Provides shared user loading, pagination, and search functionality.
+ *
+ * Subclasses must implement:
+ * - `setupValueEffect()` to track value changes and emit selection events
+ */
+declare abstract class BaseUserSelectComponent {
+    protected readonly destroyRef: DestroyRef;
+    protected readonly injector: Injector;
+    protected readonly userProvider: IUserProvider;
+    protected abortController: AbortController | null;
+    readonly loadUsers: _angular_core.InputSignal<LoadUsersFn | undefined>;
+    readonly placeHolder: _angular_core.InputSignal<string>;
+    readonly isEditMode: _angular_core.InputSignal<boolean>;
+    readonly filterActive: _angular_core.InputSignal<boolean>;
+    readonly additionalFilters: _angular_core.InputSignal<Record<string, unknown>>;
+    readonly pageSize: _angular_core.InputSignal<number>;
+    readonly onError: _angular_core.OutputEmitterRef<Error>;
+    readonly isLoading: _angular_core.WritableSignal<boolean>;
+    readonly users: _angular_core.WritableSignal<IUserBasicInfo[]>;
+    readonly total: _angular_core.WritableSignal<number | undefined>;
+    readonly pagination: _angular_core.WritableSignal<IPagination>;
+    readonly searchTerm: _angular_core.WritableSignal<string>;
+    readonly dropdownUsers: _angular_core.Signal<IDropDown[]>;
+    constructor();
+    /** Setup effect to track value changes and emit selection events */
+    protected abstract setupValueEffect(): void;
+    handleSearch(search: string): void;
+    handlePagination(pagination: IPagination): void;
+    /** Reload users (useful when filters change externally) */
+    reload(): void;
+    protected fetchUsers(append?: boolean): Promise<void>;
+    /** Load users from USER_PROVIDER with active filter */
+    private loadUsersFromProvider;
+    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>;
+}
+
 /**
  * User Select Component - Single user selection with lazy loading.
  *
@@ -1412,35 +1413,12 @@ declare class LazySelectComponent extends BaseFormControl<string | null> {
  * />
  * ```
  */
-declare class UserSelectComponent {
-    private readonly destroyRef;
-    private readonly userProvider;
-    private abortController;
-    readonly loadUsers: _angular_core.InputSignal<LoadUsersFn | undefined>;
-    readonly placeHolder: _angular_core.InputSignal<string>;
-    readonly isEditMode: _angular_core.InputSignal<boolean>;
-    readonly filterActive: _angular_core.InputSignal<boolean>;
-    readonly additionalFilters: _angular_core.InputSignal<Record<string, unknown>>;
-    readonly pageSize: _angular_core.InputSignal<number>;
+declare class UserSelectComponent extends BaseUserSelectComponent {
     readonly value: _angular_core.ModelSignal<string | null>;
     readonly userSelected: _angular_core.OutputEmitterRef<IUserBasicInfo | null>;
-    readonly onError: _angular_core.OutputEmitterRef<Error>;
-    readonly isLoading: _angular_core.WritableSignal<boolean>;
-    readonly users: _angular_core.WritableSignal<IUserBasicInfo[]>;
-    readonly total: _angular_core.WritableSignal<number | undefined>;
-    readonly pagination: _angular_core.WritableSignal<IPagination>;
-    readonly searchTerm: _angular_core.WritableSignal<string>;
-    readonly dropdownUsers: _angular_core.Signal<IDropDown[]>;
-    constructor();
-    handleSearch(search: string): void;
-    handlePagination(pagination: IPagination): void;
-    private fetchUsers;
-    /** Load users from USER_PROVIDER with active filter */
-    private loadUsersFromProvider;
-    /** Reload users (useful when filters change externally) */
-    reload(): void;
+    protected setupValueEffect(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserSelectComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserSelectComponent, "lib-user-select", 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; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "userSelected": "userSelected"; "onError": "onError"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserSelectComponent, "lib-user-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "userSelected": "userSelected"; }, never, never, true, never>;
 }
 
 /**
@@ -1471,76 +1449,18 @@ declare class UserSelectComponent {
  * />
  * ```
  */
-declare class UserMultiSelectComponent {
-    private readonly destroyRef;
-    private readonly userProvider;
-    private abortController;
-    readonly loadUsers: _angular_core.InputSignal<LoadUsersFn | undefined>;
-    readonly placeHolder: _angular_core.InputSignal<string>;
-    readonly isEditMode: _angular_core.InputSignal<boolean>;
-    readonly filterActive: _angular_core.InputSignal<boolean>;
-    readonly additionalFilters: _angular_core.InputSignal<Record<string, unknown>>;
-    readonly pageSize: _angular_core.InputSignal<number>;
+declare class UserMultiSelectComponent extends BaseUserSelectComponent {
     readonly value: _angular_core.ModelSignal<string[] | null>;
     readonly usersSelected: _angular_core.OutputEmitterRef<IUserBasicInfo[]>;
-    readonly onError: _angular_core.OutputEmitterRef<Error>;
-    readonly isLoading: _angular_core.WritableSignal<boolean>;
-    readonly users: _angular_core.WritableSignal<IUserBasicInfo[]>;
-    readonly total: _angular_core.WritableSignal<number | undefined>;
-    readonly pagination: _angular_core.WritableSignal<IPagination>;
-    readonly searchTerm: _angular_core.WritableSignal<string>;
-    readonly dropdownUsers: _angular_core.Signal<IDropDown[]>;
-    constructor();
-    handleSearch(search: string): void;
-    handlePagination(pagination: IPagination): void;
-    private fetchUsers;
-    /** Load users from USER_PROVIDER with active filter */
-    private loadUsersFromProvider;
-    /** Reload users (useful when filters change externally) */
-    reload(): void;
+    protected setupValueEffect(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserMultiSelectComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserMultiSelectComponent, "lib-user-multi-select", 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; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "usersSelected": "usersSelected"; "onError": "onError"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserMultiSelectComponent, "lib-user-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "usersSelected": "usersSelected"; }, never, never, true, never>;
 }
 
 /**
  * File Uploader Component - Drag & drop file upload with type filtering.
  *
  * Pass your own `uploadFile` function - works with any storage API.
- *
- * Features:
- * - Drag & drop support
- * - File type filtering (images, documents, etc.)
- * - Upload progress indication
- * - Multiple file support (optional)
- * - Image compression options
- *
- * @example
- * ```typescript
- * // In component
- * readonly uploadService = inject(UploadService);
- *
- * readonly uploadFile: UploadFileFn = (file, options) =>
- *   this.uploadService.uploadSingleFile(file, options);
- * ```
- *
- * ```html
- * <!-- Single image upload -->
- * <lib-file-uploader
- *   [uploadFile]="uploadFile"
- *   [acceptTypes]="['image/*']"
- *   [multiple]="false"
- *   (fileUploaded)="onFileUploaded($event)"
- * />
- *
- * <!-- Multiple document upload -->
- * <lib-file-uploader
- *   [uploadFile]="uploadFile"
- *   [acceptTypes]="FILE_TYPE_FILTERS.DOCUMENTS"
- *   [multiple]="true"
- *   [maxFiles]="5"
- *   (filesUploaded)="onFilesUploaded($event)"
- * />
- * ```
  */
 declare class FileUploaderComponent {
     private readonly messageService;
@@ -1739,63 +1659,340 @@ declare const PROFILE_UPLOAD_PROVIDER: InjectionToken<IProfileUploadProvider>;
 declare const USER_LIST_PROVIDER: InjectionToken<IUserListProvider<IUserListItem>>;
 
 /**
- * Permission Guard
- *
- * Route-level guard for permission-based access control.
- * Validates permissions before allowing navigation.
- *
- * Features:
- * - Single permission check
- * - Complex ILogicNode logic trees
- * - Configurable redirect URL
- * - Debug logging for denied access
+ * Permission Guard - Single permission or ILogicNode check.
  *
  * @example
  * ```typescript
- * // Simple permission check
  * { path: 'users', canActivate: [permissionGuard('user.view')] }
- *
- * // Complex logic
- * { path: 'admin', canActivate: [permissionGuard({
- *   id: 'root',
- *   type: 'group',
- *   operator: 'AND',
- *   children: [
- *     { id: '1', type: 'action', actionId: 'admin.view' },
- *     { id: '2', type: 'action', actionId: 'admin.manage' }
- *   ]
- * })] }
- *
- * // With custom redirect
- * { path: 'users', canActivate: [permissionGuard('user.view', '/access-denied')] }
+ * { path: 'admin', canActivate: [permissionGuard(logicNode, '/access-denied')] }
  * ```
  */
 declare function permissionGuard(permission: string | ILogicNode, redirectTo?: string): CanActivateFn;
 /**
- * Any Permission Guard (OR logic)
- *
- * Allows access if user has ANY of the specified permissions.
+ * Any Permission Guard (OR logic) - Access if user has ANY permission.
  *
  * @example
  * ```typescript
- * // Allow if user has view OR create permission
  * { path: 'users', canActivate: [anyPermissionGuard(['user.view', 'user.create'])] }
  * ```
  */
 declare function anyPermissionGuard(permissions: string[], redirectTo?: string): CanActivateFn;
 /**
- * All Permissions Guard (AND logic)
- *
- * Allows access only if user has ALL of the specified permissions.
+ * All Permissions Guard (AND logic) - Access only if user has ALL permissions.
  *
  * @example
  * ```typescript
- * // Allow only if user has BOTH view AND create permissions
  * { path: 'admin', canActivate: [allPermissionsGuard(['admin.view', 'admin.manage'])] }
  * ```
  */
 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,
+ *   changeDetection: ChangeDetectionStrategy.OnPush,
+ *   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 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;
+    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;
+    /** 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;
+    /**
+     * 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>, options?: {
+        header?: string;
+        successMessage?: string;
+        errorMessage?: 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;
+        successMessage?: string;
+        errorMessage?: 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>;
+}
+
+/**
+ * Check if user has a specific permission using wildcard matching.
+ * Supports:
+ * - Exact match: 'user.create' matches 'user.create'
+ * - Full wildcard: '*' matches everything
+ * - Module wildcard: 'user.*' matches 'user.create', 'user.read', etc.
+ */
+declare function hasPermission(requiredPermission: string, userPermissions: string[]): boolean;
 /** Evaluate permission logic (string or ILogicNode) against user permissions */
 declare function evaluatePermission(logic: string | ILogicNode | null | undefined, permissions: string[]): boolean;
 /** Recursively evaluate an ILogicNode tree */
@@ -1805,5 +2002,38 @@ declare function hasAnyPermission(permissionCodes: string[], permissions: string
 /** Check if user has ALL of the specified permissions (AND logic) */
 declare function hasAllPermissions(permissionCodes: string[], permissions: string[]): boolean;
 
-export { AUTH_STATE_PROVIDER, AngularModule, ApiResourceService, ApiResourceService as ApiService, COMPANY_API_PROVIDER, ContactTypeEnum, CookieService, EditModeElementChangerDirective, FILE_TYPE_FILTERS, FileSelectorDialogComponent, FileUploaderComponent, FileUrlService, HasPermissionDirective, IconComponent, IconTypeEnum, IsEmptyImageDirective, LazyMultiSelectComponent, LazySelectComponent, PROFILE_PERMISSION_PROVIDER, PROFILE_UPLOAD_PROVIDER, PermissionValidatorService, PlatformService, PreventDefaultDirective, PrimeModule, USER_LIST_PROVIDER, USER_PERMISSION_PROVIDER, USER_PROVIDER, UserMultiSelectComponent, UserSelectComponent, allPermissionsGuard, anyPermissionGuard, evaluateLogicNode, evaluatePermission, formatFileSize, getAcceptString, getFileIconClass, hasAllPermissions, hasAnyPermission, isFileTypeAllowed, permissionGuard };
-export type { ApiResponse, DeleteType, FilesResponseDto, GetFileUrlsFn, GetFilesRequestDto, 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, IUserCompanyPayload, IUserListAction, IUserListColumn, IUserListFilter, IUserListItem, IUserListProvider, IUserPermissionProvider, IUserProvider, IUserSelectFilter, IValidationError, LoadFilesFn, LoadUsersFn, UploadFileFn };
+/**
+ * Configuration for scroll pagination behavior
+ */
+interface ScrollPaginationConfig {
+    /** Distance from bottom to trigger pagination (default: 50px) */
+    threshold?: number;
+    /** Current pagination state */
+    pagination: IPagination;
+    /** Total items available */
+    total: number | undefined;
+    /** Whether currently loading */
+    isLoading: boolean;
+}
+/**
+ * Check if scroll has reached near bottom and calculate next page if available.
+ * Returns next pagination if should load more, null otherwise.
+ *
+ * @example
+ * ```typescript
+ * onScroll(event: Event): void {
+ *   const nextPagination = checkScrollPagination(event, {
+ *     pagination: this.pagination(),
+ *     total: this.total(),
+ *     isLoading: this.isLoading(),
+ *   });
+ *   if (nextPagination) {
+ *     this.onPagination.emit(nextPagination);
+ *   }
+ * }
+ * ```
+ */
+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, EditModeElementChangerDirective, FILE_PERMISSIONS, FILE_TYPE_FILTERS, FOLDER_PERMISSIONS, FORM_PERMISSIONS, FileSelectorDialogComponent, FileUploaderComponent, FileUrlService, HasPermissionDirective, IconComponent, IconTypeEnum, IsEmptyImageDirective, LazyMultiSelectComponent, LazySelectComponent, 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 };