@arsedizioni/ars-utils 22.0.48 → 22.0.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arsedizioni/ars-utils",
-  "version": "22.0.48",
+  "version": "22.0.49",
   "author": {
     "email": "software@arsedizioni.it",
     "name": "Fabio Buscaroli, Alberto Doria"

package/types/arsedizioni-ars-utils-clipper.ui.d.ts

@@ -1049,7 +1049,7 @@ declare class ClipperDocumentMenuComponent {
     private readonly renderer2;
     private readonly clipperService;
     readonly useSelections: _angular_core.InputSignal<boolean>;
-    readonly selectionSource: _angular_core.InputSignal<"selection" | "bag" | "none">;
+    readonly selectionSource: _angular_core.InputSignal<"bag" | "selection" | "none">;
     /**
      * Computed signal that returns the current effective document selection.
      * Re-evaluates when any input signal or the underlying selection model changes.

package/types/arsedizioni-ars-utils-evolution.common.d.ts

@@ -1,10 +1,10 @@
-import { SendToModel, LoginResult, QueryModel, ApiResult, INode, FolderTree } from '@arsedizioni/ars-utils/core';
+import { QueryModel, SendToModel, LoginResult, ApiResult, FolderTree } from '@arsedizioni/ars-utils/core';
 import { LoginOAuthType } from '@arsedizioni/ars-utils/ui.oauth';
 import { HttpInterceptor, HttpRequest, HttpHandler, HttpEvent } from '@angular/common/http';
 import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
 import * as i0 from '@angular/core';
-import { Signal } from '@angular/core';
+import { Signal, WritableSignal } from '@angular/core';
 
 declare const EvolutionMessages: {
     ERROR: string;
@@ -731,60 +731,80 @@ declare class EvolutionAuthInterceptor implements HttpInterceptor {
 }
 
 /**
- * Core service for the Evolution compliance module.
- * Manages authentication (login / logout / MFA), session persistence,
- * and HTTP access to all Evolution API endpoints.
+ * Authentication service for the Evolution module: login / logout / MFA,
+ * session bootstrap, connectivity ping and the broadcast handler.
+ * All session state lives in the private {@link CoreService}; this service
+ * orchestrates the HTTP flows and re-publishes the parts of core that
+ * consumers need.
  */
-declare class EvolutionService {
+declare class LoginService {
     private readonly httpClient;
     private readonly broadcastService;
     private readonly destroyRef;
+    private readonly core;
     private broadcastInitialized;
-    private _serviceUri;
-    /** Base URI of the Evolution back-end service. */
+    /**
+     * Gets the base URI of the Evolution back-end service.
+     * @returns The configured service URI, or undefined before initialize().
+     */
     get serviceUri(): string | undefined;
-    private _flags;
-    /** Feature flags controlling service behaviour (notifications, embedded mode, etc.). */
+    /**
+     * Gets the active feature flags.
+     * @returns The active {@link EvolutionServiceFlags} bitmask.
+     */
     get flags(): EvolutionServiceFlags;
-    private _loginInfo?;
     /**
-     * Returns the current login info, hydrating it from `localStorage` on first access
-     * when no in-memory value is available.
+     * Gets the current login info.
+     * @returns The current {@link EvolutionLoginInfo}, or undefined.
      */
     get loginInfo(): EvolutionLoginInfo | undefined;
-    private readonly _loggedIn;
     /** `true` when the user has an active (non-temporary) session. */
-    readonly loggedIn: Signal<boolean>;
+    get loggedIn(): Signal<boolean>;
     /** `true` while a login request is in flight. */
-    readonly loggingIn: i0.WritableSignal<boolean>;
+    get loggingIn(): WritableSignal<boolean>;
+    /**
+     * Persists the current login info to `localStorage` (delegates to core).
+     * @returns void
+     */
+    storeContext(): void;
+    /**
+     * Merges a login result into the stored login info (delegates to core).
+     * @param result - The login result returned by the login endpoint.
+     * @returns void
+     */
+    updateContext(result: EvolutionLoginResult): void;
+    /**
+     * Resets the in-memory login state and broadcasts logout-completed (delegates to core).
+     * @returns void
+     */
+    reset(): void;
+    /**
+     * Removes Evolution session data and resets the state (delegates to core).
+     * @param clearOAuthToken - When true, also removes the stored OAuth2 access token.
+     * @returns void
+     */
+    clear(clearOAuthToken?: boolean): void;
     /**
      * Initialises the service with the back-end URI and optional feature flags.
      * Must be called once during application bootstrap before any other method.
-     * @param serviceUri - Base URL of the Evolution service (e.g. `'https://api.example.com/evolution'`).
-     * @param flags      - Bitmask of `EvolutionServiceFlags` (default: `None`).
+     * @param serviceUri - Base URL of the Evolution service.
+     * @param flags - Bitmask of `EvolutionServiceFlags` (default: `None`).
+     * @returns void
      */
     initialize(serviceUri: string, flags?: EvolutionServiceFlags): void;
     /**
      * Dispatches an incoming broadcast message to the appropriate handler.
      * @param message - The message received from the broadcast channel.
+     * @returns void
      */
     private handleBroadcastMessage;
     /**
      * Sends a one-shot ping to the back end to verify connectivity.
+     * @returns void
      */
     ping(): void;
-    /**
-     * Persists the current login info to `localStorage`.
-     */
-    storeContext(): void;
-    /**
-     * Merges a login result into the stored login info and persists it.
-     * @param result - The `EvolutionLoginResult` returned by the login endpoint.
-     */
-    updateContext(result: EvolutionLoginResult): void;
     /**
      * Performs an automatic login using the credentials already stored in the session.
-     * Shows a busy indicator and handles success/failure dialogs.
      * @param onSuccess - Optional callback invoked after a successful login.
      * @returns `true` (always) — the result is handled via the subscription callbacks.
      */
@@ -792,15 +812,15 @@ declare class EvolutionService {
     /**
      * Performs an automatic logout, notifying the user when the session ends.
      * @param onSuccess - Optional callback invoked after the logout completes.
+     * @returns void
      */
     autoLogout(onSuccess?: () => void): void;
     /**
-     * Authenticates the user against the Evolution back end.
-     * Supports both credential-based and OAuth2 login flows.
-     * @param email            - User e-mail (credential login only; omit for OAuth2).
-     * @param password         - User password (credential login only; omit for OAuth2).
-     * @param remember         - Whether to persist the session across browser restarts.
-     * @param oauth            - OAuth2 provider type, when using federated login.
+     * Authenticates the user against the Evolution back end (credential or OAuth2).
+     * @param email - User e-mail (credential login only; omit for OAuth2).
+     * @param password - User password (credential login only; omit for OAuth2).
+     * @param remember - Whether to persist the session across browser restarts.
+     * @param oauth - OAuth2 provider type, when using federated login.
      * @param oauthAccessToken - Bearer token from the OAuth2 provider.
      * @returns An observable that emits the `ApiResult<EvolutionLoginResult>`.
      */
@@ -808,6 +828,7 @@ declare class EvolutionService {
     /**
      * Finalises a successful login by updating the stored context and notifying consumers.
      * @param result - The login result payload from the server.
+     * @returns void
      */
     private completeLogin;
     /**
@@ -828,29 +849,19 @@ declare class EvolutionService {
      * @returns An observable that emits the `ApiResult<EvolutionLoginResult>`.
      */
     loginSwitch(id: number): rxjs.Observable<ApiResult<EvolutionLoginResult>>;
-    /**
-     * Resets the in-memory login state and broadcasts a logout-completed event.
-     * Does **not** touch `sessionStorage` or `localStorage`; call `clear()` for a full cleanup.
-     */
-    reset(): void;
-    /**
-     * Removes Evolution session data from `sessionStorage` and calls `reset()`.
-     * @param clearOAuthToken - When `true`, also removes the stored OAuth2 access token.
-     */
-    clear(clearOAuthToken?: boolean): void;
-    /**
-     * Converts a flat list of `INode` items into a hierarchical tree structure.
-     * @param folders - The root-level nodes to convert.
-     * @returns An array of `INode` objects with nested `children`.
-     */
-    toNodes(folders: INode[]): INode[];
-    /**
-     * Recursive helper for `toNodes`.
-     * @param folders - The nodes to process at the current depth level.
-     * @param parent  - The parent node, or `undefined` at the root level.
-     * @returns An array of `INode` objects with nested `children`.
-     */
-    private _toNodes;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LoginService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<LoginService>;
+}
+
+/**
+ * Compliance endpoints: taxonomy & groups, context, registers, laws and
+ * activities (the `Context` / `Registers` / `Laws` / `Activities` sections,
+ * plus the general taxonomy/groups lookups). Pure HTTP; injects the private
+ * {@link CoreService} only to read the back-end URI.
+ */
+declare class ComplianceService {
+    private readonly httpClient;
+    private readonly core;
     /**
      * Retrieves the taxonomy tree from the back end.
      * @returns An observable that emits `ApiResult<FolderTree>`.
@@ -858,7 +869,7 @@ declare class EvolutionService {
     getTaxonomy(): rxjs.Observable<ApiResult<FolderTree>>;
     /**
      * Retrieves the compliance groups for a register.
-     * @param group    - Group index to retrieve (default: `1`).
+     * @param group - Group index to retrieve (default: `1`).
      * @param register - Optional register ID to scope the query.
      * @returns An observable that emits `ApiResult<string[]>`.
      */
@@ -887,18 +898,26 @@ declare class EvolutionService {
      * @returns An observable that emits `ApiResult<EvolutionComplianceLaw[]>`.
      */
     addLaws(params: EvolutionComplianceLawsAddParams): rxjs.Observable<ApiResult<EvolutionComplianceLaw[]>>;
-    /**
-     * Adds one or more compliance activities.
-     * @param params - The activities to add.
-     * @returns An observable that emits `ApiResult<EvolutionComplianceActivity>`.
-     */
-    addActivities(params: EvolutionComplianceActivitiesAddParams): rxjs.Observable<ApiResult<EvolutionComplianceActivity>>;
     /**
      * Exports compliance laws in the format expected by the server.
      * @param params - Export parameters (model shape is server-defined).
      * @returns An observable that emits the binary blob response.
      */
     exportLaws(params: any): rxjs.Observable<Blob>;
+    /**
+     * Adds one or more compliance activities.
+     * @param params - The activities to add.
+     * @returns An observable that emits `ApiResult<EvolutionComplianceActivity>`.
+     */
+    addActivities(params: EvolutionComplianceActivitiesAddParams): rxjs.Observable<ApiResult<EvolutionComplianceActivity>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ComplianceService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ComplianceService>;
+}
+
+/** Account endpoints (the `Links` section): user links management. */
+declare class AccountService {
+    private readonly httpClient;
+    private readonly core;
     /**
      * Persists a user link on the server.
      * @param item - The user link to save.
@@ -911,9 +930,67 @@ declare class EvolutionService {
      * @returns An observable that emits `ApiResult<boolean>`.
      */
     deleteLink(item: EvolutionUserLink): rxjs.Observable<ApiResult<boolean>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AccountService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AccountService>;
+}
+
+/**
+ * Public entry point for the Evolution compliance module.
+ *
+ * The private {@link CoreService} is never exposed; its state and operations
+ * are re-published here. All endpoint operations are reached through the
+ * namespaced sub-services:
+ *   - `evolution.session`    — authentication / session lifecycle
+ *   - `evolution.compliance` — taxonomy, context, registers, laws, activities
+ *   - `evolution.account`    — user links
+ *
+ * The facade itself exposes ONLY the re-published core state/operations plus
+ * `initialize` and `ping` — it intentionally does NOT flatten the sub-service
+ * methods (use the namespaces for those).
+ */
+declare class EvolutionService {
+    /** Private: never exposed to consumers. */
+    private readonly core;
+    /** Authentication / session lifecycle sub-service. */
+    readonly session: LoginService;
+    /** Compliance endpoints: taxonomy, groups, context, registers, laws, activities. */
+    readonly compliance: ComplianceService;
+    /** Account endpoints: user links management. */
+    readonly account: AccountService;
+    /**
+     * Gets the base URI of the Evolution back-end service.
+     * @returns The configured service URI, or undefined before initialize().
+     */
+    get serviceUri(): string | undefined;
+    /**
+     * Gets the active feature flags.
+     * @returns The active {@link EvolutionServiceFlags} bitmask.
+     */
+    get flags(): EvolutionServiceFlags;
+    /**
+     * Gets the current login info.
+     * @returns The current {@link EvolutionLoginInfo}, or undefined.
+     */
+    get loginInfo(): EvolutionLoginInfo | undefined;
+    /** `true` when the user has an active (non-temporary) session. */
+    get loggedIn(): Signal<boolean>;
+    /** `true` while a login request is in flight. */
+    get loggingIn(): WritableSignal<boolean>;
+    /**
+     * Initialises the service with the back-end URI and optional feature flags.
+     * @param serviceUri - Base URL of the Evolution service.
+     * @param flags - Bitmask of `EvolutionServiceFlags` (default: `None`).
+     * @returns void
+     */
+    initialize(serviceUri: string, flags?: EvolutionServiceFlags): void;
+    /**
+     * Sends a one-shot ping to the back end to verify connectivity.
+     * @returns void
+     */
+    ping(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EvolutionService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<EvolutionService>;
 }
 
-export { ERPComplianceActivityState, ERPComplianceLawOrigin, ERPComplianceLawState, ERPComplianceLawsSelectionType, ERPComplianceNotificationLimit, ERPComplianceProfileFlags, ERPComplianceProfileRole, ERPComplianceRegisterNotificationType, ERPComplianceRegisterSiteImportOptions, ERPComplianceScope, ERPExportFormat, ERPExportPart, ERPExportSource, ERPExportType, ERPModule, ERPPlace, ERPPlacePermission, ERPRecurrenceFrequencyType, EvolutionAuthInterceptor, EvolutionComplianceActivityStates, EvolutionComplianceContextInfo, EvolutionComplianceLawChangeStates, EvolutionComplianceLawOrigins, EvolutionComplianceLawStates, EvolutionComplianceNotificationLimits, EvolutionComplianceNotifications, EvolutionComplianceObligationAuthorities, EvolutionComplianceObligationTypes, EvolutionComplianceProfileFlags, EvolutionComplianceProfileRoles, EvolutionComplianceScopes, EvolutionMessages, EvolutionRecurrenceFrequencyTypes, EvolutionService, EvolutionServiceFlags };
+export { AccountService, ComplianceService, ERPComplianceActivityState, ERPComplianceLawOrigin, ERPComplianceLawState, ERPComplianceLawsSelectionType, ERPComplianceNotificationLimit, ERPComplianceProfileFlags, ERPComplianceProfileRole, ERPComplianceRegisterNotificationType, ERPComplianceRegisterSiteImportOptions, ERPComplianceScope, ERPExportFormat, ERPExportPart, ERPExportSource, ERPExportType, ERPModule, ERPPlace, ERPPlacePermission, ERPRecurrenceFrequencyType, EvolutionAuthInterceptor, EvolutionComplianceActivityStates, EvolutionComplianceContextInfo, EvolutionComplianceLawChangeStates, EvolutionComplianceLawOrigins, EvolutionComplianceLawStates, EvolutionComplianceNotificationLimits, EvolutionComplianceNotifications, EvolutionComplianceObligationAuthorities, EvolutionComplianceObligationTypes, EvolutionComplianceProfileFlags, EvolutionComplianceProfileRoles, EvolutionComplianceScopes, EvolutionMessages, EvolutionRecurrenceFrequencyTypes, EvolutionService, EvolutionServiceFlags, LoginService };
 export type { ComplianceRegisterUsersResultModel, EvolutionChangeContextModel, EvolutionChangeContextResultModel, EvolutionComplianceActivitiesAddParams, EvolutionComplianceActivity, EvolutionComplianceLaswExportParams, EvolutionComplianceLaw, EvolutionComplianceLawDocumentInfo, EvolutionComplianceLawReference, EvolutionComplianceLawsAddParams, EvolutionComplianceRegister, EvolutionComplianceRegisterProfile, EvolutionComplianceRegisterSite, EvolutionContextInfo, EvolutionExportModel, EvolutionLicenceModuleInfo, EvolutionLoginInfo, EvolutionLoginResult, EvolutionPermission, EvolutionPlacePermission, EvolutionPlaceable, EvolutionQueryRegisterProfilesModel, EvolutionRegisterProfileSiteInfo, EvolutionRegisterProfileUserInfo, EvolutionUserInfo, EvolutionUserLink, EvolutionUserModuleInfo };

package/types/arsedizioni-ars-utils-ui.d.ts

@@ -1185,6 +1185,20 @@ declare class FxLayoutAlignDirective extends ResponsiveBaseDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FxLayoutAlignDirective, "    [fxLayoutAlign],    [fxLayoutAlign.xs],    [fxLayoutAlign.sm],    [fxLayoutAlign.md],    [fxLayoutAlign.lg],    [fxLayoutAlign.xl],    [fxLayoutAlign.lt-sm],    [fxLayoutAlign.lt-md],    [fxLayoutAlign.lt-lg],    [fxLayoutAlign.lt-xl],    [fxLayoutAlign.gt-xs],    [fxLayoutAlign.gt-sm],    [fxLayoutAlign.gt-md],    [fxLayoutAlign.gt-lg],    [fxLayoutAlign.sm-up],    [fxLayoutAlign.md-up],    [fxLayoutAlign.lg-up],    [fxLayoutAlign.xl-up],    [fxLayoutAlign.sm-down],    [fxLayoutAlign.md-down],    [fxLayoutAlign.lg-down]  ", never, { "fxLayoutAlign": { "alias": "fxLayoutAlign"; "required": false; "isSignal": true; }; "xs": { "alias": "fxLayoutAlign.xs"; "required": false; "isSignal": true; }; "sm": { "alias": "fxLayoutAlign.sm"; "required": false; "isSignal": true; }; "md": { "alias": "fxLayoutAlign.md"; "required": false; "isSignal": true; }; "lg": { "alias": "fxLayoutAlign.lg"; "required": false; "isSignal": true; }; "xl": { "alias": "fxLayoutAlign.xl"; "required": false; "isSignal": true; }; "ltSm": { "alias": "fxLayoutAlign.lt-sm"; "required": false; "isSignal": true; }; "ltMd": { "alias": "fxLayoutAlign.lt-md"; "required": false; "isSignal": true; }; "ltLg": { "alias": "fxLayoutAlign.lt-lg"; "required": false; "isSignal": true; }; "ltXl": { "alias": "fxLayoutAlign.lt-xl"; "required": false; "isSignal": true; }; "gtXs": { "alias": "fxLayoutAlign.gt-xs"; "required": false; "isSignal": true; }; "gtSm": { "alias": "fxLayoutAlign.gt-sm"; "required": false; "isSignal": true; }; "gtMd": { "alias": "fxLayoutAlign.gt-md"; "required": false; "isSignal": true; }; "gtLg": { "alias": "fxLayoutAlign.gt-lg"; "required": false; "isSignal": true; }; "smUp": { "alias": "fxLayoutAlign.sm-up"; "required": false; "isSignal": true; }; "mdUp": { "alias": "fxLayoutAlign.md-up"; "required": false; "isSignal": true; }; "lgUp": { "alias": "fxLayoutAlign.lg-up"; "required": false; "isSignal": true; }; "xlUp": { "alias": "fxLayoutAlign.xl-up"; "required": false; "isSignal": true; }; "smDown": { "alias": "fxLayoutAlign.sm-down"; "required": false; "isSignal": true; }; "mdDown": { "alias": "fxLayoutAlign.md-down"; "required": false; "isSignal": true; }; "lgDown": { "alias": "fxLayoutAlign.lg-down"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Normalizes an fxLayoutGap value to a CSS `gap` value.
+ *
+ * The flex-layout value is `"<size> [grid]"`: the optional `grid` keyword is a
+ * grouping MODE, not a second CSS gap dimension. Since we apply the native CSS
+ * `gap` (which already produces uniform gutters across wrapped lines), the mode
+ * keyword is redundant and must be stripped — otherwise `gap: 10px grid` is
+ * invalid CSS and the browser drops it (no gap at all).
+ *
+ * A unitless size is normalized to px (e.g. "16" -> "16px").
+ * @param raw - The raw fxLayoutGap value (e.g. "10px", "16", "10px grid").
+ * @returns A valid CSS `gap` value.
+ */
+declare function normalizeGap(raw: string): string;
 declare class FxLayoutGapDirective extends ResponsiveBaseDirective {
     readonly fxLayoutGap: _angular_core.InputSignal<string>;
     readonly xs: _angular_core.InputSignal<string>;
@@ -1446,5 +1460,5 @@ declare class FlexLayoutModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<FlexLayoutModule>;
 }
 
-export { ALIAS_FAMILIES, ALIAS_INDEX, BS5_BREAKPOINTS, BusyDialogComponent, BusyTimer, CANONICAL_ALIASES, ConfirmDialogComponent, CredentialsDialogComponent, DeleteDialogComponent, DeleteDialogConfirmMode, DialogService, FlexLayoutModule, FxClassDirective, FxFlexAlignDirective, FxFlexDirective, FxFlexFillDirective, FxFlexOffsetDirective, FxFlexOrderDirective, FxGridAreaDirective, FxGridColumnDirective, FxGridDirective, FxLayoutAlignDirective, FxLayoutDirective, FxLayoutGapDirective, FxLayoutWrapDirective, FxShowHideDirective, FxStyleDirective, IfBpDirective, InfoDialogComponent, LAYOUT_BREAKPOINTS, LAYOUT_VALUES, MediaObserver, NON_CANONICAL_PRIORITY, OtpInputComponent, PaginatorIntl, PasswordStrengthComponent, RecoverPasswordDialogComponent, ResetPasswordDialogComponent, ResponsiveBaseDirective, ToastComponent, UIService, applyVisibility, buildAlignStyles, buildFlexStyles, buildLayoutCSS, coerceFlex, normalizeStyle, resolve, resolveAll, resolveFlexInput, resolveNonCanonical, resolveParentFlow, toBool, toClassSet, validateBasis, validateLayoutValue, validateWrapValue };
+export { ALIAS_FAMILIES, ALIAS_INDEX, BS5_BREAKPOINTS, BusyDialogComponent, BusyTimer, CANONICAL_ALIASES, ConfirmDialogComponent, CredentialsDialogComponent, DeleteDialogComponent, DeleteDialogConfirmMode, DialogService, FlexLayoutModule, FxClassDirective, FxFlexAlignDirective, FxFlexDirective, FxFlexFillDirective, FxFlexOffsetDirective, FxFlexOrderDirective, FxGridAreaDirective, FxGridColumnDirective, FxGridDirective, FxLayoutAlignDirective, FxLayoutDirective, FxLayoutGapDirective, FxLayoutWrapDirective, FxShowHideDirective, FxStyleDirective, IfBpDirective, InfoDialogComponent, LAYOUT_BREAKPOINTS, LAYOUT_VALUES, MediaObserver, NON_CANONICAL_PRIORITY, OtpInputComponent, PaginatorIntl, PasswordStrengthComponent, RecoverPasswordDialogComponent, ResetPasswordDialogComponent, ResponsiveBaseDirective, ToastComponent, UIService, applyVisibility, buildAlignStyles, buildFlexStyles, buildLayoutCSS, coerceFlex, normalizeGap, normalizeStyle, resolve, resolveAll, resolveFlexInput, resolveNonCanonical, resolveParentFlow, toBool, toClassSet, validateBasis, validateLayoutValue, validateWrapValue };
 export type { BpValues, BreakpointAlias, CanonicalKey, ConfirmDialogData, ConfirmDialogOption, CredentialsDialogData, CredentialsDialogResult, DeleteDialogData, DialogOption, DialogResult, IDialogService, InfoDialogData, NcValues, NonCanonicalKey, RecoverPasswordDialogData, RecoverPasswordDialogResult, ResetPasswordDialogData, ResetPasswordDialogMode, ResetPasswordDialogResult, ToastData };