@arsedizioni/ars-utils 18.2.245 → 18.2.250

package/clipper.common/common/definitions.d.ts

@@ -1,6 +1,7 @@
 import { SendToDialogResult } from '@arsedizioni/ars-utils/ui.application';
 import { LoginResult, NameValueItem } from '@arsedizioni/ars-utils/core';
 import { LoginOAuthType } from '@arsedizioni/ars-utils/ui.oauth';
+import { Signal } from '@angular/core';
 export declare enum ClipperSelectionMode {
     Single = 1,
     Multi = 2,
@@ -492,23 +493,24 @@ export interface ClipperDashboardResult {
     documentUpdates?: number | null;
 }
 export declare class ClipperDashboard {
-    items: ClipperDashboardItem[];
+    items: import("@angular/core").WritableSignal<ClipperDashboardItem[]>;
     isTrial?: boolean | null;
     expiredDeadlines?: number | null;
     expiringDeadlines?: number | null;
     documentUpdates?: number | null;
+    unreadItems: Signal<[ClipperModule, number][]>;
     /**
      * Update unread items
      * @param module : the module
      * @param increment : the increment (can be negative)
      */
     updateUnreadItems(module: ClipperModule, increment: number): void;
-    /**
-     * Get the unread items of a module
-     * @param module : the module
-     * @returns : the number  of unread items
+    /***
+     * Get the module unread items
+     * @param module: the module
+     * @returns the module unread items
      */
-    getUnreadItems(module: ClipperModule): number | null | undefined;
+    getUnreadItems(module: ClipperModule): number;
 }
 export declare class ClipperUtils {
     /**

package/clipper.common/common/messages.d.ts

@@ -19,7 +19,7 @@ export declare const ClipperMessages: {
     COMMAND_SEARCH_RESTORED: string;
     COMMAND_SEARCH_EXECUTED: string;
     COMMAND_HISTORY_OPEN: string;
-    COMMAND_DASHBOARD_LOADED: string;
+    COMMAND_DASHBOARD_UPDATED: string;
     INTEROP_RS_NEW_LAW: string;
     INTEROP_RS_NEW_ACTIVITY: string;
     INTEROP_RS_USAGE_REPORT: string;

package/clipper.common/common/services/clipper.service.d.ts

@@ -22,7 +22,7 @@ export declare class ClipperService implements OnDestroy {
     readonly loggingIn: import("@angular/core").WritableSignal<boolean>;
     readonly snapshot: import("@angular/core").WritableSignal<ClipperSearchResult>;
     readonly referencesSnapshot: import("@angular/core").WritableSignal<ClipperSearchResult>;
-    readonly dashboard: import("@angular/core").WritableSignal<ClipperDashboard>;
+    readonly dashboard: ClipperDashboard;
     readonly bag: import("@angular/core").WritableSignal<ClipperDocumentInfo[]>;
     readonly bagTotal: Signal<number>;
     readonly visible: import("@angular/core").WritableSignal<boolean>;
@@ -160,11 +160,11 @@ export declare class ClipperService implements OnDestroy {
    */
     loadDashboard(): void;
     /**
-     * Update unread items
-     * @param module : the module
-     * @param increment : the increment (can be negative)
-     */
-    updateDashboardUnreadItems(module: ClipperModule, increment: number): void;
+   * Update unread items
+   * @param module : the module
+   * @param increment : the increment (can be negative)
+   */
+    updateUnreadItems(module: ClipperModule, increment: number): void;
     /**
     * Save a user link
     * @param item: the user link

package/core/services/broadcastChannelHandler.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Standard Broadcast Messages Manager
+ * https://developer.mozilla.org/en-US/docs/Web/API/BroadcastChannel
+ */
+/**
+ * The message bag sent as a message
+ */
+export interface BroadcastChannelMessageBag<T> {
+    messageId: string;
+    sender: string;
+    data?: T;
+}
+/**
+ * Message subscription params
+ */
+export interface BroadcastChannelSubscriberInfo<T> {
+    messageId: string;
+    action: (bag: BroadcastChannelMessageBag<T>) => void;
+}
+/**
+ * Web Standard Broadcast Messages Manager
+ * https://developer.mozilla.org/en-US/docs/Web/API/BroadcastChannel
+ */
+export declare class BroadcastChannelManager {
+    private channel?;
+    private subscriptions;
+    /**
+     * Get the current channel registration
+     */
+    get currentBus(): string | null | undefined;
+    constructor(bus: string);
+    dispose(): void;
+    /**
+     * Send a message
+     * @param bag The message, see also {@link BroadcastChannelMessageBag}
+     *
+     * @example
+     * channel.sendMessage({ messageId: 'my-broadcast-message', sender: 'the-sender', data: value });
+     */
+    sendMessage<T>(bag: BroadcastChannelMessageBag<T>): void;
+    /**
+     * Send a message
+     * @param bag   The message, see also {@link BroadcastChannelMessageBag}
+     * @param delay The number of milliseconds to wait before sending the message, see also {@link setTimeout}
+     *
+     * @example
+     * channel.sendMessage({ messageId: 'my-broadcast-message', sender: 'the-sender', data: value }, 250);
+     */
+    sendMessage<T>(bag: BroadcastChannelMessageBag<T>, delay: number | null): void;
+    /**
+     * Send a message
+     * @param messageId The message id
+     * @param data      The data to send
+     *
+     * @example
+     * channel.sendMessage('my-broadcast-message', value);
+     */
+    sendMessage<T>(messageId: string, data: T | null): void;
+    /**
+     * Send a message
+     * @param messageId The message id
+     * @param data      The data to send
+     * @param delay     The number of milliseconds to wait before sending the message
+     *
+     * @example
+     * channel.sendMessage('my-broadcast-message', value, 250);
+     */
+    sendMessage<T>(messageId: string, data: T | null, delay: number | null): void;
+    /**
+     * Subscribe to a message
+     * @param args The subscription info, see also {@link BroadcastChannelSubscriberInfo}
+     */
+    subscribe<T>(args: BroadcastChannelSubscriberInfo<T>): void;
+    /**
+     * Remove a message subscription
+     * @param messageId The message id
+     */
+    unsubscribe(messageId: string): void;
+    /**
+     * Remove all the current subscriptions
+     */
+    unsubscribeAll(): void;
+}

package/core/services/theme.service.d.ts

@@ -1,15 +1,40 @@
-import { Signal } from "@angular/core";
+import { OnDestroy, Signal } from "@angular/core";
 import * as i0 from "@angular/core";
-export declare class ThemeService {
+export declare class ThemeService implements OnDestroy {
+    private readonly broadcastChannel;
+    private readonly broadcastMessage;
+    private readonly prefersColorSchemeMediaQueryList;
     private renderFactory2;
     private renderer;
-    readonly theme: import("@angular/core").WritableSignal<"dark" | "light">;
+    /**
+     * Current theme
+     */
+    private readonly theme;
+    /**
+     * The current theme is "System default"
+     */
+    private readonly auto;
+    /**
+     * Configuration schema about the icon, the text and the toggle() sequence
+     */
+    private readonly themeInfo;
+    /**
+     * Icon of the current theme (mat-icon code)
+     */
     readonly themeIcon: Signal<string>;
+    /**
+     * Current theme name
+     */
     readonly themeName: Signal<string>;
+    /**
+     * Tooltip text on toggle
+     */
+    readonly toggleTooltip: Signal<string>;
     constructor();
+    ngOnDestroy(): void;
     /**
      * Set the new theme
-     * @param theme : the theme
+     * @param theme the new theme
      */
     private setTheme;
     /**