@arsedizioni/ars-utils 21.2.208 → 21.2.220

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

@@ -6,10 +6,10 @@ import { SupportNotificationInfo, SupportNotificationsSearchParams } from '@arse
 
 declare class SupportNotificationsBrowserComponent implements OnInit, AfterViewInit {
     readonly paginator: _angular_core.Signal<MatPaginator>;
-    protected screenService: ScreenService;
-    private supportService;
-    private broadcastService;
-    private dialogService;
+    protected readonly screenService: ScreenService;
+    private readonly supportService;
+    private readonly broadcastService;
+    private readonly dialogService;
     private readonly destroyRef;
     protected selection: SelectableModel<SupportNotificationInfo, number>;
     protected searchParams: SupportNotificationsSearchParams;
@@ -18,50 +18,54 @@ declare class SupportNotificationsBrowserComponent implements OnInit, AfterViewI
     ngOnInit(): void;
     ngAfterViewInit(): void;
     /**
-     * Update scroll
+     * Scrolls the notifications list back to the top.
      */
     private updateScroll;
     /**
-     * Update menu buttons visibility when the menu is closed
+     * Resets the `isMenuOpen` flag on all items after a context menu is closed.
      */
     protected updateMenuButtonsVisibility(): void;
     /**
-       * Get all selected ids
-       * @returns: the selected ids as an array
-       */
-    private getSeletectIds;
+     * Returns the ids of the currently selected items.
+     * Shows an error and returns `undefined` when the selection exceeds 50 items.
+     * @returns An array of selected notification ids, or `undefined` on validation failure.
+     */
+    private getSelectedIds;
     /**
-  * Return item state css class
-  * @param item : the item to evaluate
-  */
-    protected getItemStateCssClass(item: SupportNotificationInfo): string;
+     * Returns the CSS class to apply to the read-state indicator stripe.
+     * @param item - The notification to evaluate.
+     * @returns `'unread-bg'` when the notification has not been read, otherwise `undefined`.
+     */
+    protected getItemStateCssClass(item: SupportNotificationInfo): string | undefined;
     /**
-     * Return the item state tooltip text
-     * @param item : the item to evaluate
+     * Returns the tooltip text for the read-state indicator stripe.
+     * @param item - The notification to evaluate.
+     * @returns `'Non letto'` when unread, otherwise an empty string.
      */
     protected getItemStateTooltip(item: SupportNotificationInfo): string;
     /**
-     * Perform a new search
+     * Resets pagination to page 0 and fetches a fresh result set.
      */
     protected find(): void;
     /**
-     * Retrieve data
+     * Fetches the current page of notifications from the server.
      */
     private fetch;
     /**
-     * Show a new page result
-     * @param e : the MatPaginator PageEvent data
+     * Handles paginator page changes and loads the corresponding result page.
+     * @param e - The `PageEvent` emitted by `MatPaginator`.
      */
     protected fetchMore(e: PageEvent): void;
     /**
-     * Mark a notification as read or unread
-     * @param item : the item to set or null to use selection
-     * @param unmark : true to set as unread or false to set as read
+     * Marks one or more notifications as read or unread.
+     * When no specific item is supplied, acts on the current selection.
+     * @param item   - A single notification to mark, or `undefined` to use the selection.
+     * @param unmark - `true` to mark as unread; `false` (default) to mark as read.
      */
     protected mark(item?: SupportNotificationInfo, unmark?: boolean): void;
     /**
-     * Display a notification
-     * @param item : the item to display
+     * Opens the notification detail dialog for the given item.
+     * @param item - The notification to display.
      */
     protected show(item: SupportNotificationInfo): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SupportNotificationsBrowserComponent, never>;

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

@@ -1,17 +1,27 @@
 import * as i0 from '@angular/core';
-import { OnInit } from '@angular/core';
 
 declare class TinymceUtils {
+    /** URL of the TinyMCE script hosted on the Tiny Cloud CDN. */
     static readonly CDN_URL = "https://cdn.tiny.cloud/1/5lnoc6ohmpjau6zyzgqyhyf52cueoennkcs8v1yfoak57ku9/tinymce/7/tinymce.min.js";
+    /** URL of the locally bundled TinyMCE script. */
     static readonly LOCAL_URL = "/assets/tinymce/tinymce.min.js";
     /**
-     * Configurazione di base per TinyMCE editor
+     * Full-featured TinyMCE base configuration with all standard plugins and toolbar.
      */
     static TinymceConfig: Record<string, any>;
+    /**
+     * Compact TinyMCE configuration with autoresize, bottom toolbar, and grouped toolbar buttons.
+     * Extends `TinymceConfig` with reduced height and a simplified toolbar.
+     */
     static TinymceCompactConfig: Record<string, any>;
+    /**
+     * Extended compact TinyMCE configuration that adds fullscreen support and an insert group.
+     * Extends `TinymceCompactConfig`.
+     */
     static TinymceCompactExtendedConfig: Record<string, any>;
     /**
-     * Load tiny MCE script
+     * Inject the TinyMCE script tag into the document head if it is not already present.
+     * @param useCDN - When `true`, loads from the Tiny Cloud CDN; otherwise uses the local asset.
      */
     static loadTinyMCEScript(useCDN?: boolean): void;
 }
@@ -30,16 +40,21 @@ interface FullScreenEditorDialogData {
     disabled?: boolean;
     useCDN?: boolean;
 }
-declare class FullScreenEditorComponent implements OnInit {
+declare class FullScreenEditorComponent {
+    /** Emitted with the edited text when the user saves. */
     readonly saving: i0.OutputEmitterRef<string>;
-    private dialogRef;
-    protected dialogData: FullScreenEditorDialogData;
-    protected disabled: i0.WritableSignal<boolean>;
-    protected text?: string;
+    private readonly dialogRef;
+    /** Dialog configuration, injected and exposed as a signal. */
+    protected readonly dialogData: i0.WritableSignal<FullScreenEditorDialogData>;
+    /** Whether the editor is in read-only mode. */
+    protected readonly disabled: i0.WritableSignal<boolean>;
+    /** Current editor content, kept as a plain field for [(ngModel)] two-way binding. */
+    protected text: string;
+    /** TinyMCE editor configuration. */
     protected tinymceConfig: Record<string, any>;
-    ngOnInit(): void;
+    constructor();
     /**
-     * Save data
+     * Save the current editor content and close the dialog.
      */
     protected ok(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<FullScreenEditorComponent, never>;