@flusys/ng-shared 1.0.0-rc → 1.0.0

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

@@ -1,6 +1,6 @@
-import * as _angular_core from '@angular/core';
-import { Signal, Injector, ResourceRef, model, ElementRef, InjectionToken, DestroyRef } 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';
@@ -46,10 +46,9 @@ 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 * as _flusys_ng_core from '@flusys/ng-core';
-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';
 
 /**
  * Centralized Permission Codes
@@ -232,43 +231,6 @@ declare const PERMISSIONS: {
 };
 type PermissionCode = (typeof PERMISSIONS)[keyof typeof PERMISSIONS][keyof (typeof PERMISSIONS)[keyof typeof PERMISSIONS]];
 
-/**
- * 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.
- *
- * @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
- *     }
- *   }
- * }
- */
-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>;
-}
-
 /**
  * Base entity interface - matches backend Identity entity
  */
@@ -326,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
@@ -467,156 +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;
-    }): 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]: string | number | boolean | null | undefined | string[] | number[];
-}
-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;
-        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>>;
-
 /**
  * Basic file info for selectors and displays
  */
@@ -697,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
  */
@@ -715,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;
@@ -808,136 +698,53 @@ interface IUserListItem {
 }
 /**
  * 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,
@@ -959,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;
@@ -976,116 +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']);
- *
- * // Or set wildcard for no-IAM mode
- * this.permissionValidator.setPermissions(['*']);
- *
- * // 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>;
@@ -1286,7 +1015,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;
@@ -1602,6 +1330,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.
  *
@@ -1629,35 +1396,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>;
 }
 
 /**
@@ -1688,35 +1432,12 @@ 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>;
 }
 
 /**
@@ -1921,58 +1642,29 @@ 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'])] }
  * ```
  */
@@ -2293,5 +1985,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 { ACTION_PERMISSIONS, AUTH_STATE_PROVIDER, AngularModule, ApiResourceService, ApiResourceService as ApiService, BRANCH_PERMISSIONS, BaseFormControl, BaseFormPage, BaseListPage, 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, evaluateLogicNode, evaluatePermission, formatFileSize, getAcceptString, getFileIconClass, hasAllPermissions, hasAnyPermission, hasPermission, isFileTypeAllowed, permissionGuard, provideValueAccessor };
-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, PermissionCode, 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, UploadFileFn };