@flusys/ng-shared 8.1.4 → 9.1.0-rc.1

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "@flusys/ng-shared",
-  "version": "8.1.4",
+  "version": "9.1.0-rc.1",
   "description": "Shared components and utilities for FLUSYS Angular packages",
   "license": "MIT",
   "peerDependencies": {
     "@angular/common": ">=22.0.0",
     "@angular/core": ">=22.0.0",
     "@angular/forms": ">=22.0.0",
+    "@angular/platform-browser": ">=22.0.0",
     "@angular/router": ">=22.0.0",
-    "@flusys/ng-core": ">=8.1.4",
-    "@flusys/ng-ui": ">=8.1.4",
+    "@flusys/ng-core": ">=9.1.0-rc.1",
+    "@flusys/ng-ui": ">=9.1.0-rc.1",
     "rxjs": "^7.8.0"
   },
   "sideEffects": false,

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

@@ -8,8 +8,8 @@ import * as _flusys_ng_shared from '@flusys/ng-shared';
 import { ServiceName } from '@flusys/ng-core';
 import { ControlValueAccessor } from '@angular/forms';
 import { FormValueControl } from '@angular/forms/signals';
+import { TreeNode, CheckboxChangeEvent } from '@flusys/ng-ui';
 import * as _angular_platform_browser from '@angular/platform-browser';
-import { CheckboxChangeEvent } from '@flusys/ng-ui';
 
 declare const SHARED_MESSAGES: Record<string, string>;
 
@@ -111,6 +111,27 @@ declare const FORM_RESULT_PERMISSIONS: {
     readonly UPDATE: "form-result.update";
     readonly DELETE: "form-result.delete";
 };
+declare const ENTITY_DEFINITION_PERMISSIONS: {
+    readonly CREATE: "entity_builder.entity_definition.create";
+    readonly READ: "entity_builder.entity_definition.read";
+    readonly UPDATE: "entity_builder.entity_definition.update";
+    readonly DELETE: "entity_builder.entity_definition.delete";
+};
+declare const FIELD_DEFINITION_PERMISSIONS: {
+    readonly READ: "entity_builder.field_definition.read";
+    readonly UPDATE: "entity_builder.field_definition.update";
+};
+declare const FLOW_DEFINITION_PERMISSIONS: {
+    readonly CREATE: "entity_builder.flow_definition.create";
+    readonly READ: "entity_builder.flow_definition.read";
+    readonly UPDATE: "entity_builder.flow_definition.update";
+    readonly DELETE: "entity_builder.flow_definition.delete";
+    readonly TEST: "entity_builder.flow_definition.test";
+    /** Needed to save a flow that runs as the system (bypassing per-entity permissions). */
+    readonly SYSTEM: "entity_builder.flow_definition.system";
+    /** Needed to save a flow containing a code node (sandboxed JavaScript). */
+    readonly CODE: "entity_builder.flow_definition.code";
+};
 declare const EVENT_PERMISSIONS: {
     readonly CREATE: "event.create";
     readonly READ: "event.read";
@@ -327,6 +348,8 @@ interface ILoggedUserInfo {
 interface IDropDown {
     label: string;
     value: string;
+    /** Optional secondary line rendered below the label (e.g. email under a user's name) when two options share a label. */
+    subLabel?: string;
 }
 /**
  * Delete operation types
@@ -503,6 +526,12 @@ interface IFilterData {
     extraKey?: string[];
 }
 
+/** A translatable message from the backend: `messageKey` is looked up and `{{name}}` is filled from `messageVariables`, which may themselves be message references. */
+interface IMessageRef {
+    messageKey: string;
+    messageVariables?: Record<string, unknown>;
+}
+
 /**
  * Auth State Provider Interface
  *
@@ -618,6 +647,25 @@ interface IProfilePermissionProvider {
     getUserRoles(userId: string, branchId?: string): Observable<ISingleResponse<IProfileRoleInfo[]>>;
     getUserActions(userId: string, branchId?: string): Observable<ISingleResponse<IProfileActionInfo[]>>;
 }
+/** A permission action (IAM action code) for pickers */
+interface IActionBasicInfo {
+    id: string;
+    name: string;
+    /** Null for a grouping action that only nests others. */
+    code: string | null;
+    description?: string | null;
+    parentId?: string | null;
+    serial?: number | null;
+}
+/**
+ * Action Provider Interface - Lists the permission actions a feature package can require,
+ * without depending on ng-iam directly.
+ */
+interface IActionProvider {
+    getActions(): Observable<ISingleResponse<IActionBasicInfo[]>>;
+    /** False when the backing service is switched off, so pickers fall back to typing codes. Defaults to available. */
+    isAvailable?(): boolean;
+}
 /**
  * File Provider Interface - Provides file loading and upload functionality.
  * Used by FileSelectorDialogComponent to load files and handle uploads.
@@ -719,7 +767,9 @@ declare class TranslateService {
     private readonly localizationState;
     private readonly registry;
     translate(key: string, params?: Record<string, string | unknown>): string;
+    translateRef(ref: IMessageRef): string;
     translateSignal(key: string, params?: Record<string, string | number>): Signal<string>;
+    private isMessageRef;
     private interpolate;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TranslateService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<TranslateService>;
@@ -835,7 +885,7 @@ declare class PreventDefaultDirective {
 
 declare class TranslatePipe implements PipeTransform {
     private readonly translateAdapter;
-    transform(key: string | null | undefined, params?: Record<string, string | number> | null, fallback?: string): string;
+    transform(key: string | IMessageRef | null | undefined, params?: Record<string, string | number> | null, fallback?: string): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TranslatePipe, never>;
     static ɵpipe: _angular_core.ɵɵPipeDeclaration<TranslatePipe, "translate", true>;
 }
@@ -852,6 +902,11 @@ declare class TranslatePipe implements PipeTransform {
  * ```
  */
 declare const SKIP_ERROR_TOAST: HttpContextToken<boolean>;
+/**
+ * Whether errorCatchingInterceptor already showed this failure as a toast, so a caller's own
+ * catch block adds one only for failures the user has not been told about yet.
+ */
+declare function isErrorToastShown(error: unknown): boolean;
 /**
  * Error Catching Interceptor
  * Displays error messages for failed HTTP requests using backend response.
@@ -926,7 +981,7 @@ declare abstract class ApiResourceService<DtoT, InterfaceT> implements IApiServi
     nextPage(): void;
     resetPagination(): void;
     reload(): void;
-    private _post;
+    protected post<R>(endpoint: string, body: unknown, params?: HttpParams): Promise<R>;
     insert(dto: DtoT): Promise<ISingleResponse<InterfaceT>>;
     insertMany(dtos: DtoT[]): Promise<IBulkResponse<InterfaceT>>;
     findById(id: string, select?: string[]): Promise<ISingleResponse<InterfaceT>>;
@@ -985,6 +1040,56 @@ declare function provideValueAccessor<T extends new (...args: unknown[]) => Cont
     multi: boolean;
 };
 
+/** Shared action loading for the single and multi permission pickers. */
+declare abstract class BaseActionSelectComponent {
+    private readonly provider;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly inputId: _angular_core.InputSignal<string>;
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly hasProvider: boolean;
+    readonly actions: _angular_core.ResourceRef<IActionBasicInfo[] | undefined>;
+    /** Picker mode; typing codes is the fallback when there is no provider or the actions could not be loaded. */
+    readonly useSelect: _angular_core.Signal<boolean>;
+    private readonly actionTree;
+    private readonly knownCodes;
+    /** The action tree plus any saved code that is not (or no longer) an action, so the selection still shows. */
+    protected treeWith(saved: string[]): TreeNode[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BaseActionSelectComponent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BaseActionSelectComponent, never, never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Picks several permission action codes from the action tree of ACTION_PROVIDER (wired by ng-iam);
+ * without an available provider, or when loading fails, it falls back to typing codes as chips (Enter adds one).
+ *
+ * @example
+ * <lib-action-multi-select [(value)]="actionGroups" inputId="actionGroups" />
+ */
+declare class ActionMultiSelectComponent extends BaseActionSelectComponent {
+    readonly value: _angular_core.ModelSignal<string[]>;
+    readonly draft: _angular_core.WritableSignal<string>;
+    readonly options: _angular_core.Signal<TreeNode<unknown>[]>;
+    add(event: Event): void;
+    remove(code: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ActionMultiSelectComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ActionMultiSelectComponent, "lib-action-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
+/**
+ * Picks a permission action code from the action tree of ACTION_PROVIDER (wired by ng-iam);
+ * without an available provider, or when loading fails, it falls back to a free-text code input.
+ *
+ * @example
+ * <lib-action-select [(value)]="permissionCode" inputId="permission" [placeholder]="defaultCode" />
+ */
+declare class ActionSelectComponent extends BaseActionSelectComponent {
+    readonly value: _angular_core.ModelSignal<string | null>;
+    readonly showClear: _angular_core.InputSignal<boolean>;
+    readonly options: _angular_core.Signal<TreeNode<unknown>[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ActionSelectComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ActionSelectComponent, "lib-action-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "showClear": { "alias": "showClear"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
 declare class BaseFormTemplateDirective {
     readonly key: _angular_core.InputSignal<string>;
     readonly templateRef: TemplateRef<any>;
@@ -1614,6 +1719,14 @@ declare const PROFILE_PERMISSION_PROVIDER: InjectionToken<IProfilePermissionProv
  * ]
  */
 declare const FILE_PROVIDER: InjectionToken<IFileProvider>;
+/**
+ * Action Provider Token
+ *
+ * Lists permission actions for pickers such as `lib-action-select`.
+ * Optional - if not configured, permission pickers fall back to a free-text code input.
+ * Use with `inject(ACTION_PROVIDER, { optional: true })`.
+ */
+declare const ACTION_PROVIDER: InjectionToken<IActionProvider>;
 
 /**
  * Permission Guard - Single permission or ILogicNode check.
@@ -1716,5 +1829,11 @@ interface ScrollPaginationConfig {
  */
 declare function checkScrollPagination(event: Event, config: ScrollPaginationConfig): IPagination | null;
 
-export { ACTION_PERMISSIONS, AUTH_STATE_PROVIDER, ApiResourceService, ApiResourceService as ApiService, BRANCH_PERMISSIONS, BaseFormComponent, BaseFormControl, BaseFormTemplateDirective, BaseListComponent, BaseListTemplateDirective, BaseUserSelectComponent, COMPANY_ACTION_PERMISSIONS, COMPANY_API_PROVIDER, COMPANY_PERMISSIONS, CookieService, EMAIL_CONFIG_PERMISSIONS, EMAIL_TEMPLATE_PERMISSIONS, EVENT_PERMISSIONS, EditModeElementChangerDirective, FILE_PERMISSIONS, FILE_PROVIDER, FILE_TYPE_FILTERS, FOLDER_PERMISSIONS, FORM_PERMISSIONS, FORM_RESULT_PERMISSIONS, FaviconService, FileSelectorDialogComponent, FileUploaderComponent, FileUrlService, HasPermissionDirective, IconComponent, IconTypeEnum, InlineSvgComponent, IsEmptyImageDirective, LANGUAGE_PERMISSIONS, LazyMultiSelectComponent, LazySelectComponent, NOTIFICATION_PERMISSIONS, PERMISSIONS, PROFILE_PERMISSION_PROVIDER, PermissionValidatorService, PlatformService, PreventDefaultDirective, ROLE_ACTION_PERMISSIONS, ROLE_PERMISSIONS, RouterTabsComponent, SHARED_MESSAGES, SKIP_ERROR_TOAST, SOCIAL_AUTH_CONFIG_PERMISSIONS, STORAGE_CONFIG_PERMISSIONS, TRANSLATION_KEY_PERMISSIONS, TRANSLATION_PERMISSIONS, TranslatePipe, TranslateService, UPLOAD_CONFIG_PERMISSIONS, USER_ACTION_PERMISSIONS, USER_PERMISSIONS, USER_PERMISSION_PROVIDER, USER_PROVIDER, USER_ROLE_PERMISSIONS, UserMultiSelectComponent, UserSelectComponent, allPermissionsGuard, anyPermissionGuard, authenticatedGuard, checkScrollPagination, errorCatchingInterceptor, evaluateLogicNode, evaluatePermission, formatFileSize, formatInTimezone, getAcceptString, getFileIconClass, getUserTimezone, hasAllPermissions, hasAnyPermission, hasPermission, isFileTypeAllowed, localToUtc, permissionGuard, provideValueAccessor, resolveTranslationModule, utcToLocal };
-export type { ActionSeverity, DeleteType, FilesResponseDto, FormFieldType, IActionNode, IActivatable, IApiService, IAuthStateProvider, IBaseEntity, IBranchBasicInfo, IBulkMeta, IBulkResponse, ICompanyApiProvider, ICompanyBasicInfo, IDeleteData, IDropDown, IFileBasicInfo, IFileProvider, IFileSelectFilter, IFileUploadOptions, IFilter, IFilterData, IFolderBasicInfo, IFormField, IFormSelectOption, IGroupNode, IListResponse, ILoggedUserInfo, ILogicNode, IMessageResponse, IOrderable, IPagination, IPaginationMeta, IProfileActionInfo, IProfilePermissionProvider, IProfileRoleInfo, IRequestMeta, IResolverModuleConfig, ISelectFilter, ISingleResponse, ISoftDeletable, ISort, IStorageConfigBasicInfo, ITableAction, ITableColumn, ITagConfig, ITimestampable, IUploadedFile, IUserBasicInfo, IUserBranchPermission, IUserCompanyInfo, IUserPermissionProvider, IUserProvider, IUserSelectFilter, LoadUsersFn, PermissionCode, RouterTabItem, ScrollPaginationConfig, TableColumnType, UploadFileFn, UploadMultipleFilesFn };
+/** The translatable reason in a failed HTTP call: the backend's `messageKey`/`messageVariables`, or `fallbackKey` when the response carries none. */
+declare function errorToMessageRef(error: unknown, fallbackKey?: string): IMessageRef;
+
+/** Escapes user-authored text interpolated into markup rendered via [innerHTML] (e.g. confirm dialog messages). */
+declare function escapeHtml(value: string): string;
+
+export { ACTION_PERMISSIONS, ACTION_PROVIDER, AUTH_STATE_PROVIDER, ActionMultiSelectComponent, ActionSelectComponent, ApiResourceService, ApiResourceService as ApiService, BRANCH_PERMISSIONS, BaseActionSelectComponent, BaseFormComponent, BaseFormControl, BaseFormTemplateDirective, BaseListComponent, BaseListTemplateDirective, BaseUserSelectComponent, COMPANY_ACTION_PERMISSIONS, COMPANY_API_PROVIDER, COMPANY_PERMISSIONS, CookieService, EMAIL_CONFIG_PERMISSIONS, EMAIL_TEMPLATE_PERMISSIONS, ENTITY_DEFINITION_PERMISSIONS, EVENT_PERMISSIONS, EditModeElementChangerDirective, FIELD_DEFINITION_PERMISSIONS, FILE_PERMISSIONS, FILE_PROVIDER, FILE_TYPE_FILTERS, FLOW_DEFINITION_PERMISSIONS, FOLDER_PERMISSIONS, FORM_PERMISSIONS, FORM_RESULT_PERMISSIONS, FaviconService, FileSelectorDialogComponent, FileUploaderComponent, FileUrlService, HasPermissionDirective, IconComponent, IconTypeEnum, InlineSvgComponent, IsEmptyImageDirective, LANGUAGE_PERMISSIONS, LazyMultiSelectComponent, LazySelectComponent, NOTIFICATION_PERMISSIONS, PERMISSIONS, PROFILE_PERMISSION_PROVIDER, PermissionValidatorService, PlatformService, PreventDefaultDirective, ROLE_ACTION_PERMISSIONS, ROLE_PERMISSIONS, RouterTabsComponent, SHARED_MESSAGES, SKIP_ERROR_TOAST, SOCIAL_AUTH_CONFIG_PERMISSIONS, STORAGE_CONFIG_PERMISSIONS, TRANSLATION_KEY_PERMISSIONS, TRANSLATION_PERMISSIONS, TranslatePipe, TranslateService, UPLOAD_CONFIG_PERMISSIONS, USER_ACTION_PERMISSIONS, USER_PERMISSIONS, USER_PERMISSION_PROVIDER, USER_PROVIDER, USER_ROLE_PERMISSIONS, UserMultiSelectComponent, UserSelectComponent, allPermissionsGuard, anyPermissionGuard, authenticatedGuard, checkScrollPagination, errorCatchingInterceptor, errorToMessageRef, escapeHtml, evaluateLogicNode, evaluatePermission, formatFileSize, formatInTimezone, getAcceptString, getFileIconClass, getUserTimezone, hasAllPermissions, hasAnyPermission, hasPermission, isErrorToastShown, isFileTypeAllowed, localToUtc, permissionGuard, provideValueAccessor, resolveTranslationModule, utcToLocal };
+export type { ActionSeverity, DeleteType, FilesResponseDto, FormFieldType, IActionBasicInfo, IActionNode, IActionProvider, IActivatable, IApiService, IAuthStateProvider, IBaseEntity, IBranchBasicInfo, IBulkMeta, IBulkResponse, ICompanyApiProvider, ICompanyBasicInfo, IDeleteData, IDropDown, IFileBasicInfo, IFileProvider, IFileSelectFilter, IFileUploadOptions, IFilter, IFilterData, IFolderBasicInfo, IFormField, IFormSelectOption, IGroupNode, IListResponse, ILoggedUserInfo, ILogicNode, IMessageRef, IMessageResponse, IOrderable, IPagination, IPaginationMeta, IProfileActionInfo, IProfilePermissionProvider, IProfileRoleInfo, IRequestMeta, IResolverModuleConfig, ISelectFilter, ISingleResponse, ISoftDeletable, ISort, IStorageConfigBasicInfo, ITableAction, ITableColumn, ITagConfig, ITimestampable, IUploadedFile, IUserBasicInfo, IUserBranchPermission, IUserCompanyInfo, IUserPermissionProvider, IUserProvider, IUserSelectFilter, LoadUsersFn, PermissionCode, RouterTabItem, ScrollPaginationConfig, TableColumnType, UploadFileFn, UploadMultipleFilesFn };