@flusys/ng-shared 1.1.1-beta → 2.0.0-rc.0

package/README.md

@@ -178,7 +178,7 @@ FILE_TYPE_FILTERS.ALL        // [] (allows all)
 getAcceptString(['image/*'])           // 'image/*'
 isFileTypeAllowed(file, ['image/*'])   // true/false
 getFileIconClass('image/png')          // 'pi pi-image'
-formatFileSize('1024')                 // '1 KB'
+formatFileSize(1024)                   // '1 KB'
 ```
 
 ### Response Interfaces
@@ -517,7 +517,7 @@ Flexible icon renderer supporting PrimeNG icons, image files, and SVG.
 <!-- Image file -->
 <lib-icon icon="/assets/logo.png" [iconType]="IconTypeEnum.IMAGE_FILE_LINK" />
 
-<!-- SVG tag -->
+<!-- SVG tag (shows fallback icon - full SVG rendering coming soon) -->
 <lib-icon icon="<svg>...</svg>" [iconType]="IconTypeEnum.DIRECT_TAG_SVG" />
 ```
 
@@ -1098,6 +1098,101 @@ interface IProfilePermissionProvider {
 }
 ```
 
+#### IAuthStateProvider / `AUTH_STATE_PROVIDER`
+
+Auth state access for feature packages (form-builder, etc.) that need to check authentication without depending on ng-auth directly.
+
+```typescript
+interface IAuthStateProvider {
+  /** Signal indicating if user is currently authenticated */
+  isAuthenticated: Signal<boolean>;
+
+  /** Initialize auth state (restore session from cookies/storage) */
+  initialize(): Observable<void>;
+}
+```
+
+**Usage:**
+
+```typescript
+import { AUTH_STATE_PROVIDER } from '@flusys/ng-shared';
+
+@Component({...})
+export class PublicFormComponent {
+  private readonly authState = inject(AUTH_STATE_PROVIDER);
+
+  ngOnInit() {
+    this.authState.initialize().subscribe(() => {
+      if (this.authState.isAuthenticated()) {
+        // User is logged in
+      }
+    });
+  }
+}
+```
+
+#### IUserListProvider / `USER_LIST_PROVIDER`
+
+Extends user list pages with extra columns, actions, and data enrichment. Optional provider.
+
+```typescript
+interface IUserListItem {
+  id: string;
+  name: string;
+  email: string;
+  phone?: string;
+  isActive?: boolean;
+  [key: string]: unknown;
+}
+
+interface IUserListAction<T = IUserListItem> {
+  id: string;
+  label: string;
+  icon?: string;
+  severity?: 'primary' | 'secondary' | 'success' | 'info' | 'warn' | 'danger';
+  permission?: string;
+  tooltip?: string;
+  disabled?: boolean | ((user: T) => boolean);
+  visible?: boolean | ((user: T) => boolean);
+}
+
+interface IUserListColumn {
+  field: string;
+  header: string;
+  width?: string;
+  sortable?: boolean;
+  templateType?: 'text' | 'badge' | 'date' | 'boolean' | 'custom';
+}
+
+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[]>;
+}
+```
+
+**Usage:**
+
+```typescript
+// 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' },
+    ];
+  }
+}
+```
+
 ### Usage in Consuming Packages
 
 ```typescript
@@ -1269,6 +1364,11 @@ export const appConfig: ApplicationConfig = {
 | `IFileSelectFilter` | File select filter params            |
 | `LoadFilesFn`       | File loading function type           |
 | `UploadFileFn`      | File upload function type            |
+| `IAuthStateProvider`| Auth state provider interface        |
+| `IUserListProvider` | User list extensions provider        |
+| `IUserListItem`     | Base user for list operations        |
+| `IUserListAction`   | User list action definition          |
+| `IUserListColumn`   | Extra column for user list           |
 
 ### Injection Tokens
 
@@ -1279,6 +1379,8 @@ export const appConfig: ApplicationConfig = {
 | `USER_PERMISSION_PROVIDER` | `IUserPermissionProvider` | User permission queries      |
 | `PROFILE_UPLOAD_PROVIDER`  | `IProfileUploadProvider`  | Profile picture upload (ng-storage) |
 | `PROFILE_PERMISSION_PROVIDER` | `IProfilePermissionProvider` | User permissions for profile (ng-iam) |
+| `AUTH_STATE_PROVIDER`      | `IAuthStateProvider`      | Auth state for feature packages |
+| `USER_LIST_PROVIDER`       | `IUserListProvider`       | User list extensions (optional) |
 
 ## See Also
 
@@ -1289,5 +1391,5 @@ export const appConfig: ApplicationConfig = {
 
 ---
 
-**Last Updated:** 2026-02-16
+**Last Updated:** 2026-02-21
 **Angular Version:** 21