@arsedizioni/ars-utils 21.2.204 → 21.2.206

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

@@ -1,9 +1,8 @@
 import * as _angular_core from '@angular/core';
-import { DestroyRef, ChangeDetectorRef, Injector, OnInit, AfterViewInit, Signal, OnDestroy } from '@angular/core';
+import { DestroyRef, ChangeDetectorRef, Injector } from '@angular/core';
 import { MatPaginator, PageEvent } from '@angular/material/paginator';
 import { MatDrawer } from '@angular/material/sidenav';
 import { ClipperSearchFacetsSnapshot, ClipperSearchFacet, ClipperSearchFacetGroup, ClipperService, ClipperDocumentInfo, ClipperSearchParams, ClipperQueryReferencesMode, ClipperModule, ClipperModel, ClipperSearchCalendarSnapshotMonth, ClipperSearchCalendarSnapshotResult, ClipperSelectionMode, ClipperSearchResult, ClipperSort, ClipperUserInfo, ClipperUserSearch, SectorInfo, ClipperDocumentRelevants, ClipperDocumentAnchorInfo, ClipperDocumentProperty, EditDialogData, EditDialogCompleted, ClipperContactInfo } from '@arsedizioni/ars-utils/clipper.common';
-import * as rxjs from 'rxjs';
 import { BreakpointObserver } from '@angular/cdk/layout';
 import { BroadcastService, DateInterval, ThemeService, ScreenService, SelectableModel, NameValueItem, INode, ThemeType } from '@arsedizioni/ars-utils/core';
 import { Clipboard } from '@angular/cdk/clipboard';
@@ -19,49 +18,54 @@ import { MatDialogRef } from '@angular/material/dialog';
 
 declare class ClipperSearchFacetsComponent {
     readonly changed: _angular_core.OutputEmitterRef<ClipperSearchFacetsSnapshot>;
-    private changeDetector;
+    private readonly changeDetector;
     protected snapshot: ClipperSearchFacetsSnapshot;
-    hasFacets: () => boolean;
-    handleTooManyResults: _angular_core.InputSignal<boolean>;
     /**
-   * Update facets
-   * @param values : the facets values
-   * @param interval : the date interval for YEAR facets
-   */
+     * Returns whether the current snapshot contains at least one available or applied facet group.
+     */
+    hasFacets(): boolean;
+    readonly handleTooManyResults: _angular_core.InputSignal<boolean>;
+    /**
+     * Pushes a new set of facet groups into the snapshot and refreshes the view.
+     * @param values - The raw facet data returned by the search engine, grouped by type.
+     * @param interval - Optional display label for the year-range interval (YEAR facet type).
+     */
     update(values?: ClipperSearchFacet[][], interval?: string): void;
     /**
-     * Use a facet item as filter
-     * @param group : the facet group
-     * @param item  : the facet item
+     * Applies the given facet item as an active filter and emits a `changed` event.
+     * @param group - The facet group that owns the selected item.
+     * @param item - The facet item chosen by the user.
      */
     protected use(group: ClipperSearchFacetGroup, item: ClipperSearchFacet): void;
     /**
-     * dismiss a facet group filter
-     * @param group : the facet group
-     * @param apply : true to emit changed event and generate a new search, false just for update
+     * Removes an active facet filter from the selection and optionally emits a `changed` event.
+     * @param group - The applied facet group to dismiss.
+     * @param apply - When `true` (default), emits the `changed` event to trigger a new search.
      */
     protected dismiss(group: ClipperSearchFacetGroup, apply?: boolean): void;
     /**
-     * Apply filter
+     * Builds and emits the current `ClipperSearchFacetsSnapshot` after resolving each applied
+     * facet group's filter value into the corresponding snapshot date/sector/author/type fields.
      */
     private apply;
     /**
-     * Clear facets by group index
-     * @param index : the group index to clear. Use -1 to clear all groups at once
-     * @returns : the number of groups dismissed
+     * Dismisses one or all applied facet groups and emits a `changed` event if any were removed.
+     * @param index - The group index to clear, or `-1` to clear all applied groups at once.
+     * @returns The number of groups that were dismissed.
      */
     protected clear(index?: number): number;
     /**
-     * Reset
+     * Resets all facet state: clears every applied/available group and all derived filter fields.
      */
     reset(): void;
     /**
-     * Restore data
-     * @param data : the data to restore
+     * Restores a previously serialised facets snapshot and refreshes the view.
+     * @param data - The snapshot to restore.
      */
     restore(data: ClipperSearchFacetsSnapshot): void;
     /**
-     * Save data
+     * Returns the current facets snapshot for external serialisation (e.g. save/restore cycle).
+     * @returns The current `ClipperSearchFacetsSnapshot`.
      */
     save(): ClipperSearchFacetsSnapshot;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperSearchFacetsComponent, never>;
@@ -70,166 +74,165 @@ declare class ClipperSearchFacetsComponent {
 
 declare class ClipperDocumentManager {
     readonly populateContacts: _angular_core.OutputEmitterRef<SendToPopulateData>;
-    protected clipboard: Clipboard;
-    clipperService: ClipperService;
-    protected broadcastService: BroadcastService;
-    protected dialogService: ApplicationDialogService;
-    protected canUseArchive: _angular_core.WritableSignal<boolean>;
-    protected canHandleTooManyResults: _angular_core.WritableSignal<boolean>;
-    protected canPopulateContacts: _angular_core.WritableSignal<boolean>;
-    /**
- * Export a document in pdf format
- * @param item : the document to export
- */
+    protected readonly clipboard: Clipboard;
+    readonly clipperService: ClipperService;
+    protected readonly broadcastService: BroadcastService;
+    protected readonly dialogService: ApplicationDialogService;
+    protected readonly canUseArchive: _angular_core.WritableSignal<boolean>;
+    protected readonly canHandleTooManyResults: _angular_core.WritableSignal<boolean>;
+    protected readonly canPopulateContacts: _angular_core.WritableSignal<boolean>;
+    /**
+     * Exports a document in PDF format, after asking for confirmation.
+     * @param item - The document to export.
+     */
     exportPdf(item: ClipperDocumentInfo): void;
     /**
-     * Export current document list or just the selected documents as a csv
-     * @param documentIds: the document id list
-     * @param searchParams: the search params
-     * @param format: the export format: 1) list 2) deadlines
+     * Exports the current document list (or only the selected documents) as CSV or ICS.
+     * @param documentIds - The list of document IDs to export; if empty, the full search result is exported.
+     * @param searchParams - The search parameters used to identify the full result set when no IDs are provided.
+     * @param format - The export format: 1 = list (CSV), 2 = deadlines (ICS).
      */
     exportItems(documentIds: string[] | undefined, searchParams?: ClipperSearchParams | undefined, format?: number): void;
     /**
-     * Export a single deadline
-     * @param item : the document to export
+     * Exports a single document's deadline as an ICS file.
+     * @param item - The document whose deadline to export.
      */
     exportDeadline(item: ClipperDocumentInfo): void;
     /**
-     * Archive a list of items
-     * @param items: the item list
+     * Sends a broadcast message to add the given documents to the archive.
+     * @param items - The list of documents to archive.
      */
     addToArchive(items: ClipperDocumentInfo[]): void;
     /**
-     * Create a new deadline
-     * @param item : the item to add
+     * Sends a broadcast message to create a new calendar deadline from the given document.
+     * @param item - The document to add to the calendar.
      */
     addToCalendar(item: ClipperDocumentInfo): void;
     /**
-    * Add a list of items to working documents
-    * @param items : the item list
-    */
+     * Sends a broadcast message to add the given documents to the working-documents set.
+     * @param items - The list of documents to add.
+     */
     addItemsToWorkingDocuments(items: ClipperDocumentInfo[]): void;
     /**
-    * Add a list of items to bag
-    * @param items : the item list
-    */
+     * Sends a request to the Clipper service to add the given documents to the bag.
+     * @param items - The list of documents to add.
+     */
     addItemsToBag(items: ClipperDocumentInfo[]): void;
     /**
-     * Add properties to a document
-     * @param item : the item to add properties to
+     * Sends a broadcast message to add custom properties to the given document.
+     * @param item - The document to add properties to.
      */
     addItemProperty(item: ClipperDocumentInfo): void;
     /**
-     * Copy metadata to clipboard
-     * @param item : the item to copy
+     * Copies the document's metadata (ID, titles, number, date, origin) as a tab-separated string to the clipboard.
+     * @param item - The document whose metadata to copy.
      */
     copyMetadataToClipboard(item: ClipperDocumentInfo): void;
     /**
-     * Show a document permalink
-     * @param item : the item to show the link for
+     * Displays a dialog with a shareable permalink for the given document.
+     * @param item - The document to show the permalink for.
      */
     showLink(item: ClipperDocumentInfo): void;
     /**
-     * Send documents links by email
-     * @param items : the document list
+     * Opens a dialog to send document links by email to one or more recipients.
+     * @param items - The list of documents to send.
      */
     sendItemsTo(items: ClipperDocumentInfo[]): void;
     /**
-     * Display a document report
-     * @param documentId : the document id
-     * @param title: the document short title
+     * Downloads the document's HTML report.
+     * @param documentId - The ID of the document.
+     * @param title - Optional display title used as the file name.
      */
     openReport(documentId: string, title?: string): void;
     /**
-    * Open an item
-    * This should be always overridden
-    * @param documentId : the document id
-    * @param query : the query document
-    * @param queryChunks : the query chunks for highlight as string (eg. "|1|2|3...")
-    * @param newWindow: true if the document must be open into a new window
-    */
+     * Opens a document for display. Override in subclasses to provide the actual implementation.
+     * @param _documentId - The document ID.
+     * @param _query - The search query string.
+     * @param _queryChunks - Pipe-separated highlight chunks (e.g. "|1|2|3...").
+     * @param _newWindow - When true, opens the document in a new browser window.
+     */
     open(_documentId?: string, _query?: string, _queryChunks?: string, _newWindow?: boolean): void;
     /**
-     * Display a document report
-     * @param item : the document
+     * Downloads the HTML report for a normativa/scadenze document.
+     * @param item - The document to report on.
      */
     report(item: ClipperDocumentInfo): void;
     /**
-     * Browse document references
-     * @param documentId : the document id
-     * @param mode : the reference mode
+     * Opens the references dialog for the given document.
+     * @param documentId - The ID of the document whose references to display.
+     * @param mode - The reference mode (e.g. ReferencesIn, ReferencesOut).
      */
     openReferences(documentId?: string, mode?: ClipperQueryReferencesMode): void;
     /**
-     * Manage clipper bag
+     * Opens a dialog to manage the documents in the working bag (view, select, delete).
      */
     openBag(): void;
     /**
-     * Print current document
+     * Sends a print command to the Clipper document iframe.
      */
     print(): void;
     /**
-     * Find in current document
+     * Displays a hint dialog explaining how to use the browser's find-in-page feature.
      */
     find(): void;
     /**
-   * AI: concern me service
-   * @param document: the document
-   */
+     * AI: sends a "concern me" request for the given document.
+     * @param document - The document to analyse.
+     */
     AI_concernMe(document?: ClipperDocumentInfo): void;
     /**
-   * AI: explain service
-   * @param document: the document
-   */
+     * AI: sends an "explain" request for the given document.
+     * @param document - The document to explain.
+     */
     AI_explain(document?: ClipperDocumentInfo): void;
     /**
-   * AI: comment service
-   * @param document: the document
-   */
+     * AI: sends a "comment" request for the given document.
+     * @param document - The document to comment on.
+     */
     AI_comment(document?: ClipperDocumentInfo): void;
     /**
-* AI: news service
-* @param document: the document
-*/
+     * AI: sends a "news" request for the given document.
+     * @param document - The document to retrieve news for.
+     */
     AI_news(document?: ClipperDocumentInfo): void;
     /**
-    * Checks if a module is supported by RS
-    * @param module : the module to check
-    * @returns: true if the module is supported
-    */
+     * Returns whether the given Clipper module is supported by Registro e Scadenzario (RS).
+     * @param module - The module to check.
+     * @returns `true` if the module is supported by RS.
+     */
     isModuleSupportedByRS(module: ClipperModule): boolean;
     /**
-     * Checks if a model is supported by RS
-     * @param model : the model to check
-     * @returns: true if the model is supported
+     * Returns whether the given Clipper model is supported by Registro e Scadenzario (RS).
+     * @param model - The model to check.
+     * @returns `true` if the model is supported by RS.
      */
     isModelSupportedByRS(model: ClipperModel): boolean;
     /**
-    * Checks if all documents are supported by RS
-    * @param documents : the list of documents
-    * @returns: true if all documents supports RS
-    */
+     * Returns whether every document in the list has a model supported by RS.
+     * @param documents - The list of documents to check.
+     * @returns `true` if all documents are RS-compatible.
+     */
     canSupportRS(documents: ClipperDocumentInfo[]): boolean;
     /**
-     * Checks if RS is enabled for all given documents
-     * @param documents : the documents to check
-     * @returns true if alla documents ar RS enabled
+     * Returns whether every document in the list has a model that supports RS tracking.
+     * @param documents - The documents to check.
+     * @returns `true` if all documents are RS-enabled.
      */
     RS_enabled(documents: ClipperDocumentInfo[]): boolean;
     /**
-    * New law
-    * @param documents: the array of documents to link to the law
-    */
+     * Sends a broadcast message to create a new RS law entry linked to the given documents.
+     * @param documents - The array of documents to link to the new law.
+     */
     RS_newLaw(documents?: ClipperDocumentInfo[]): void;
     /**
-     * New activity
-     * @param document: the document to link to the activity
+     * Sends a broadcast message to create a new RS activity linked to the given document.
+     * @param document - The document to link to the new activity.
      */
     RS_newActivity(document?: ClipperDocumentInfo): void;
     /**
-    * Document usage report
-    * @param document: the law
-    */
+     * Sends a broadcast message to open the RS usage report for the given document.
+     * @param document - The document to generate the usage report for.
+     */
     RS_usageReport(document?: ClipperDocumentInfo): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperDocumentManager, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperDocumentManager, "ng-component", never, {}, { "populateContacts": "populateContacts"; }, never, never, true, never>;
@@ -238,7 +241,7 @@ declare class ClipperDocumentManager {
 declare class ClipperSearchCalendarComponent {
     readonly calendar: _angular_core.Signal<MatCalendar<any>>;
     readonly changed: _angular_core.OutputEmitterRef<DateInterval>;
-    private changeDetector;
+    private readonly changeDetector;
     protected busy: _angular_core.WritableSignal<boolean>;
     protected months: _angular_core.WritableSignal<ClipperSearchCalendarSnapshotMonth[]>;
     protected calendarSpecialDays?: number[];
@@ -248,20 +251,22 @@ declare class ClipperSearchCalendarComponent {
     protected calendarDateFilter: (cellDate: Date) => boolean;
     readonly canFilter: _angular_core.InputSignal<boolean>;
     /**
-     * Update calendar
-     * @param month : the month snapshot
-     * @param months : the months snapshot
-     * @param date : the new current date
+     * Refreshes the calendar with a new month/days snapshot and updates the active date.
+     * @param month - The single-month snapshot used to populate special-day highlighting.
+     * @param months - The full year snapshot used to populate the month-selector chips.
+     * @param date - The date the calendar should navigate to. Defaults to today.
      */
     update(month?: ClipperSearchCalendarSnapshotResult, months?: ClipperSearchCalendarSnapshotResult, date?: Date): void;
     /**
-     * Filter by date
-     * @param date : the date to filter to or "month" to filter by the whole month.
+     * Emits a `DateInterval` for the given date or, when `'month'` is passed, for the entire
+     * current calendar month. Passing `undefined` clears the active date filter.
+     * @param date - A specific `Date` to filter by, the string `'month'` to filter the whole
+     *   month, or `undefined` to clear the filter.
      */
     protected filterByDate(date?: Date | string): void;
     /**
-     * Filter by month
-     * @param monthInfo: the month info
+     * Navigates the calendar to the given month and emits its full date range as a filter.
+     * @param monthInfo - The month snapshot to navigate to and filter by.
      */
     protected filterByMonth(monthInfo: ClipperSearchCalendarSnapshotMonth): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperSearchCalendarComponent, never>;
@@ -273,158 +278,171 @@ declare class ClipperSearchResultManager extends ClipperDocumentManager {
     readonly facets: _angular_core.Signal<ClipperSearchFacetsComponent>;
     readonly calendar: _angular_core.Signal<ClipperSearchCalendarComponent>;
     protected readonly destroyRef: DestroyRef;
-    protected changeDetector: ChangeDetectorRef;
-    protected breakpointObserver: BreakpointObserver;
-    protected injector: Injector;
-    protected themeService: ThemeService;
-    screenService: ScreenService;
+    protected readonly changeDetector: ChangeDetectorRef;
+    protected readonly breakpointObserver: BreakpointObserver;
+    protected readonly injector: Injector;
+    protected readonly themeService: ThemeService;
+    readonly screenService: ScreenService;
     selection: SelectableModel<ClipperDocumentInfo, string> | undefined;
-    selectionMode: _angular_core.WritableSignal<ClipperSelectionMode>;
+    readonly selectionMode: _angular_core.WritableSignal<ClipperSelectionMode>;
     protected snapshot: ClipperSearchResult | undefined;
-    protected filterBusy: _angular_core.WritableSignal<boolean>;
+    protected readonly filterBusy: _angular_core.WritableSignal<boolean>;
     protected filterParams: ClipperSearchParams;
-    protected filterPaneHasBackdrop: boolean;
-    protected filterPaneClosed: boolean;
-    protected filterPane2HasBackdrop: boolean;
-    protected filterPane2Closed: boolean;
-    protected sortOptions: NameValueItem<ClipperSort>[];
-    protected sortMode: NameValueItem<ClipperSort> | undefined;
+    protected readonly filterPaneHasBackdrop: _angular_core.WritableSignal<boolean>;
+    protected readonly filterPaneClosed: _angular_core.WritableSignal<boolean>;
+    protected readonly filterPane2HasBackdrop: _angular_core.WritableSignal<boolean>;
+    protected readonly filterPane2Closed: _angular_core.WritableSignal<boolean>;
+    protected readonly sortOptions: _angular_core.WritableSignal<NameValueItem<ClipperSort>[]>;
+    protected readonly sortMode: _angular_core.WritableSignal<NameValueItem<ClipperSort>>;
     protected scrollPos: number;
-    protected scrollerId: string;
+    protected readonly scrollerId: string;
     protected restorableId: string | undefined;
-    protected hasFacets: _angular_core.WritableSignal<boolean>;
-    protected hasRegions: () => boolean;
+    protected readonly hasFacets: _angular_core.WritableSignal<boolean>;
+    /** `true` when the current sector filter contains any regional-law (LR) entries. */
+    protected readonly hasRegions: _angular_core.Signal<boolean>;
     /**
-     * Update menu buttons visibility when the menu is closed
+     * Resets the `isMenuOpen` flag on every snapshot item so that action-menu buttons are hidden.
      */
     updateMenuButtonsVisibility(): void;
     /**
-     * Scroll on top o list area
-     * @param top: the top position
+     * Scrolls the results list container to the given vertical position.
+     * @param top - The target scroll offset in pixels. Defaults to 0 (top).
      */
     scroll(top?: number): void;
     /**
-     * Check if every element are selected
+     * Returns whether every item in the current snapshot is selected.
+     * @returns `true` if the selection count equals the total snapshot item count.
      */
     allSelected(): boolean;
     /**
-     * Master selection toggle
-     * @param select: true to select all elements false to deselect all elements
+     * Selects or deselects all items in the current snapshot.
+     * @param select - When `true`, selects all items; when `false`, deselects all.
      */
     selectAll(select?: boolean): void;
     /**
-    * Check if selections exists
-    * @returns true if at least one element is selected
-    */
+     * Returns whether at least one item is currently selected.
+     * @returns `true` if the selection contains one or more items.
+     */
     hasAnySelection(): boolean;
     /**
-    * Check if only one element is selected
-    * @returns true if only one element is selected
-    */
+     * Returns whether exactly one item is selected.
+     * @returns `true` if the selection count is exactly 1.
+     */
     hasSingleSelection(): boolean;
     /**
-    * Get the first selected item
-    * @returns the selected item or null
-    */
+     * Returns the first (and only) selected item, or `undefined` when nothing or multiple items are selected.
+     * @returns The selected document, or `undefined`.
+     */
     getSingleSelection(): ClipperDocumentInfo | undefined;
     /**
-    * Clear selection
-    */
+     * Clears the entire selection.
+     */
     clearSelection(): void;
     /**
-   * Return the number of selected items or null
-   * @returns Return the number of selected items
-   */
+     * Returns the number of currently selected items, or `undefined` when nothing is selected.
+     * @returns The selection count, or `undefined`.
+     */
     countSelections(): number | undefined;
     /**
-  * Get the selected id
-  */
+     * Returns the document ID of the first selected item, or `undefined` when nothing is selected.
+     * @returns The selected document ID, or `undefined`.
+     */
     getSeletectId(): string | undefined;
     /**
- * Get all selected ids
- */
+     * Returns the document IDs of all selected items.
+     * Shows an error and returns `undefined` when more than 100 items are selected.
+     * @returns An array of document IDs, or `undefined` when the limit is exceeded.
+     */
     getSeletectIds(): string[] | undefined;
     /**
-     * Get all selected ids
-     * @returns a tuple list with id and data
+     * Returns a list of `[documentId, document]` tuples for all selected items.
+     * Shows an error and returns `undefined` when more than 100 items are selected.
+     * @returns An array of ID-document tuples, or `undefined` when the limit is exceeded.
      */
     getSeletectIdsAndData(): [string, ClipperDocumentInfo][] | undefined;
     /**
-     * Prepare result items
-     * @param items : the items to process
-     * @param params : the current search params
+     * Enriches raw search result items with display metadata: grouping labels, expiry/validity
+     * state, anchor relevance scores, and model-specific fields.
+     * @param items - The raw document list to process in place.
+     * @param params - The search parameters used to determine grouping and filtering.
      */
     prepareResultItems(items: ClipperDocumentInfo[], params: ClipperSearchParams): void;
     /**
-     * Prepare results
-     * @param data : the result list to prepare
-     * @param newSearch : true if is a new search
+     * Applies a new search result snapshot: clears the current selection, optionally preserves
+     * facet state for incremental updates, and triggers change detection.
+     * @param data - The incoming search result.
+     * @param newSearch - When `true`, facet state is reset along with the results.
      */
     prepareResults(data: ClipperSearchResult, newSearch?: boolean): void;
     /**
-    * Save current document list or just the selected documents as a csv
-    * @param format: the export format: 1) list, 2) deadlines
-    */
+     * Exports either the selected documents or the full result set in the given format.
+     * @param format - The export format: 1 = list (CSV), 2 = deadlines (ICS).
+     */
     exportResults(format?: number): void;
     /**
-    * Return item state css class
-    * @param item : the item to evaluate
-    */
+     * Returns the CSS class that reflects the item's read/expiry state.
+     * @param item - The document to evaluate.
+     * @returns A CSS class name string, or `undefined` when no special state applies.
+     */
     getItemStateCssClass(item: ClipperDocumentInfo): string | undefined;
     /**
-     * Return the item state tooltip text
-     * @param item : the item to evaluate
+     * Returns the tooltip text that explains the item's current read/expiry state.
+     * @param item - The document to evaluate.
+     * @returns A human-readable state description, or an empty string when no special state applies.
      */
     getItemStateTooltip(item: ClipperDocumentInfo): string;
     /**
-    * Return the item icon
-    * @param item : the item to evaluate
-    */
+     * Returns the Material icon name that represents the given document's model.
+     * @param item - The document whose icon to determine.
+     * @returns A Material icon name string.
+     */
     getItemIcon(item: ClipperDocumentInfo): string;
     /**
-     * Toggle the read flag
-     * @param item : the item to update
-     * @paran e: the optional click event
+     * Toggles the read flag of the given item and stops event propagation.
+     * @param item - The document whose read state to toggle.
+     * @param e - Optional DOM event; when provided, default action and propagation are suppressed.
      */
     toggleRead(item: ClipperDocumentInfo, e?: Event): void;
     /**
-    * Toggle the selection flag
-    * @param item : the item to update
-    * @paran e: the optional click event
-    */
+     * Toggles the selection state of the given item and stops event propagation.
+     * @param item - The document to select or deselect.
+     * @param e - Optional DOM event; when provided, default action and propagation are suppressed.
+     */
     toggleSelection(item: ClipperDocumentInfo, e?: Event): void;
     /**
-    * Set read flag
-    * @param value: the flag value
-    * @param item: the item to set or null to use current selection
-    */
-    setRead(value: boolean, item?: ClipperDocumentInfo): rxjs.Subscription;
-    /**
- * Open an item
- * @param documentId : the document id
- * @param query: the current query or undefined
- * @param queryChunks : the query chunks for highlight as string (eg. "|1|2|3...")
- * @param newWindow: true if the document must be open into a new window
- * @param canUseArchive: true if archive is available
- */
+     * Sets the read state on the given item or on all currently selected items.
+     * Broadcasts a read-state-changed event and updates the unread counter.
+     * @param value - The new read flag value.
+     * @param item - When provided, only this item is updated; otherwise the full selection is used.
+     */
+    setRead(value: boolean, item?: ClipperDocumentInfo): void;
+    /**
+     * Opens a document by ID, either inline or in a new browser tab.
+     * @param documentId - The ID of the document to open.
+     * @param query - The current search query used to highlight terms in the viewer.
+     * @param queryChunks - Pipe-separated highlight chunks (e.g. "|1|2|3...").
+     * @param newWindow - When `true`, opens the document in a new browser tab.
+     */
     open(documentId?: string, query?: string, queryChunks?: string, newWindow?: boolean): void;
     /**
-     * Open a document
-     * @param documentId : the document id
-     * @param query: the current query or null
-     * @param queryChunks : the query chunks for highlight as string (eg. "|1|2|3...")
+     * Opens the Clipper document viewer dialog for the given document.
+     * @param documentId - The ID of the document to open.
+     * @param query - The normalized search query used for term highlighting.
+     * @param queryChunks - Pipe-separated highlight chunks (e.g. "|1|2|3...").
      */
     openDocument(documentId?: string, query?: string, queryChunks?: string): void;
     /**
-     * Save restorable data
-     * @param id : the restorable id
-     * @param storage : the storage to use. Default si session storage.
+     * Serialises the current component state (paginator, facets, filter params, scroll, sort, data)
+     * to the given storage under the given key, enabling later restoration.
+     * @param id - The storage key to write to.
+     * @param storage - The Web Storage instance to use. Defaults to `sessionStorage`.
      */
     save(id: string, storage?: Storage): void;
     /**
-     * Restore data
-     * @param id : the restorable id
-     * @param storage : the storage to use. Default si session storage.
+     * Restores a previously serialised component state from storage and re-applies it.
+     * Facets, paginator, scroll position, and filter parameters are all re-hydrated.
+     * @param id - The storage key to read from.
+     * @param storage - The Web Storage instance to use. Defaults to `sessionStorage`.
      */
     restore(id: string, storage?: Storage): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperSearchResultManager, never>;
@@ -443,133 +461,177 @@ interface ClipperReferencesDialogData {
 interface ClipperReferenceDialogResult {
     documentId: string;
 }
-declare class ClipperReferencesComponent extends ClipperSearchResultManager implements OnInit, AfterViewInit {
+declare class ClipperReferencesComponent extends ClipperSearchResultManager {
     readonly filterPane: _angular_core.Signal<MatDrawer>;
-    private dialogRef;
-    protected dialogData: ClipperReferencesDialogData;
+    private readonly dialogRef;
+    protected readonly dialogData: ClipperReferencesDialogData;
     protected title?: string;
     protected item?: ClipperDocumentInfo;
-    protected user: ClipperUserInfo | undefined;
-    ngOnInit(): void;
-    ngAfterViewInit(): void;
+    protected readonly user: ClipperUserInfo | undefined;
+    constructor();
     /**
-   * Show hide filter pane manually
-   */
+     * Toggles the filter pane open/closed state.
+     */
     protected toggleFilterPane(): void;
     /**
-     * Handle filter pane visibility
+     * Adjusts the filter pane mode (side vs. overlay) and backdrop based on the current breakpoint.
      */
     private handleFilterPaneVisibility;
     /**
-     * Close dialog
+     * Closes the references dialog without returning a result.
      */
     close(): void;
     /**
-     * Send document links by email
-     * @param item : the item to add
+     * Sends document links by email for the given item or, when omitted, for all selected items.
+     * @param item - The specific document to send, or `undefined` to use the current selection.
      */
     sendTo(item?: ClipperDocumentInfo): void;
     /**
-     * Prepare the search params
-     * @param newSearch : true if it is a new search
-     * @return the new search params
+     * Builds the search parameters for the next fetch call.
+     * @param newSearch - When `true`, resets the pagination offset to 0.
+     * @returns A cloned and enriched `ClipperSearchParams` ready to be sent to the API.
      */
     private prepareFetch;
     /**
-     * Get e refrences search params form clipper search params
-     * @param params : the clipper search params
-     * @returns : the references search params
+     * Maps a generic `ClipperSearchParams` to the references-specific API parameter shape.
+     * @param params - The base search parameters to convert.
+     * @returns A `ClipperReferencesSearchParams` object ready for the references endpoint.
      */
     private toReferencesSearchParams;
     /**
-     * Perform a search
-     * @param newSearch: true if is a new search
+     * Executes the references search and updates the result snapshot.
+     * @param newSearch - When `true`, resets pagination and reloads facets. Defaults to `false`.
      */
     fetch(newSearch?: boolean): void;
     /**
-     * Show a new page result
-     * @param e : the MatPaginator PageEvent data
+     * Navigates to the next result page.
+     * @param e - The `PageEvent` emitted by the paginator with the new page index and size.
      */
     fetchMore(e: PageEvent): void;
     /**
-    * Get facets
-    * @param params: the clipper search params
-    */
+     * Loads available facets for the current search parameters and updates the filter pane.
+     * @param params - The search parameters used to request facets from the API.
+     */
     fetchFacets(params: ClipperSearchParams): void;
     /**
-     * Hide facets
+     * Hides the facet filter pane and resets all applied facet filters.
      */
     protected hideFacets(): void;
     /**
-   * Try to restore stored facets
-   */
+     * Restores previously saved facets from the snapshot and adjusts the filter pane accordingly.
+     */
     restoreFacets(): void;
     /**
-     * Close current dialog and return the id to navigate to
-     * @param documentId : the document id
+     * Closes the dialog and navigates to the selected document.
+     * @param documentId - The ID of the document to open.
      */
-    open(documentId: string): void;
+    open(documentId?: string): void;
     /**
-  * Return item state css class
-  * @param item : the item to evaluate
-  */
+     * Returns the CSS class reflecting the item's validity state.
+     * @param item - The document to evaluate.
+     * @returns A CSS class name string, or `undefined` when no special state applies.
+     */
     getItemStateCssClass(item: ClipperDocumentInfo): string | undefined;
     /**
-     * Return the item state tooltip text
-     * @param item : the item to evaluate
+     * Returns the tooltip text explaining the item's current validity state.
+     * @param item - The document to evaluate.
+     * @returns A human-readable state description, or an empty string when no special state applies.
      */
     getItemStateTooltip(item: ClipperDocumentInfo): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperReferencesComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperReferencesComponent, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-declare class ClipperBrowserComponent extends ClipperSearchResultManager implements OnInit, AfterViewInit {
-    readonly filterByNumber: Signal<MatInput>;
-    readonly filterByText: Signal<MatInput>;
-    readonly filterByChangeNumber: Signal<MatInput>;
-    readonly filterPane: Signal<MatDrawer>;
-    readonly filterPane2: Signal<MatDrawer>;
-    readonly filterSelector: Signal<ButtonSelectorComponent>;
-    readonly moduleSelector: Signal<ChipsSelectorComponent>;
-    readonly sourceExpansionPanel: Signal<MatExpansionPanel>;
-    readonly otherOptionsExpansionPanel: Signal<MatExpansionPanel>;
-    readonly modifierExpansionPanel: Signal<MatExpansionPanel>;
+declare class ClipperBrowserComponent extends ClipperSearchResultManager {
+    readonly filterByNumber: _angular_core.Signal<MatInput>;
+    readonly filterByText: _angular_core.Signal<MatInput>;
+    readonly filterByChangeNumber: _angular_core.Signal<MatInput>;
+    readonly filterPane: _angular_core.Signal<MatDrawer>;
+    readonly filterPane2: _angular_core.Signal<MatDrawer>;
+    readonly filterSelector: _angular_core.Signal<ButtonSelectorComponent>;
+    readonly moduleSelector: _angular_core.Signal<ChipsSelectorComponent>;
+    readonly sourceExpansionPanel: _angular_core.Signal<MatExpansionPanel>;
+    readonly otherOptionsExpansionPanel: _angular_core.Signal<MatExpansionPanel>;
+    readonly modifierExpansionPanel: _angular_core.Signal<MatExpansionPanel>;
     readonly showChannels: _angular_core.InputSignal<boolean>;
     readonly showRSOptions: _angular_core.InputSignal<boolean>;
     readonly showAIAssistantOptions: _angular_core.InputSignal<boolean>;
     readonly selectableModules: _angular_core.InputSignal<ClipperModule[]>;
     readonly initialModule: _angular_core.InputSignal<ClipperModule>;
     protected scrollDispatcher: ScrollDispatcher;
-    protected filterDescription: _angular_core.WritableSignal<string>;
-    protected filters: _angular_core.WritableSignal<NameValueItem<ClipperUserSearch>[]>;
-    protected filter: Signal<NameValueItem<ClipperUserSearch> | undefined>;
-    protected hasAIAssistant: boolean;
-    protected hasFilters: Signal<boolean>;
-    protected isLaws: (allowEmpty?: boolean) => boolean;
-    protected isReadable: () => boolean;
-    protected isCoordination: () => boolean;
-    protected isSortedByDate: () => boolean;
-    protected canSearch: () => boolean;
-    protected sectors: _angular_core.WritableSignal<SectorInfo[]>;
-    protected hasSectors: () => boolean;
-    protected regions: _angular_core.WritableSignal<NameValueItem<string>[]>;
-    protected hasRegions: () => boolean;
-    protected sources: _angular_core.WritableSignal<NameValueItem<string>[]>;
-    protected hasSource: () => boolean;
-    protected authors: _angular_core.WritableSignal<NameValueItem<string>[]>;
-    protected types: _angular_core.WritableSignal<NameValueItem<string>[]>;
+    protected readonly filterDescription: _angular_core.WritableSignal<string>;
+    protected readonly filters: _angular_core.WritableSignal<NameValueItem<ClipperUserSearch>[]>;
+    /** Currently selected saved filter, derived from the filters list and the active search id. */
+    protected readonly filter: _angular_core.Signal<NameValueItem<ClipperUserSearch>>;
+    /** True when the user has access to the AI assistant feature. */
+    protected readonly hasAIAssistant: _angular_core.Signal<boolean>;
+    /** True when at least one saved filter is available. */
+    protected readonly hasFilters: _angular_core.Signal<boolean>;
+    /**
+     * Checks whether the current module selection targets law-related content.
+     * @param allowEmpty - When true, an empty module list also counts as law-related. Defaults to true.
+     * @returns True if the selection includes any law module or (when allowEmpty) is empty.
+     */
+    protected isLaws(allowEmpty?: boolean): boolean;
+    /**
+     * Checks whether the currently selected modules produce readable content.
+     * @returns True when the modules allow content reading.
+     */
+    protected isReadable(): boolean;
+    /**
+     * Checks whether the current selection targets the coordination module.
+     * @returns True when the 'ModificheAbrogazioniERinvii' module is selected.
+     */
+    protected isCoordination(): boolean;
+    /**
+     * Checks whether the current sort mode is one of the date-based sort options.
+     * @returns True when results are sorted by date (ascending or descending).
+     */
+    protected isSortedByDate(): boolean;
+    /**
+     * Checks whether the current filter parameters define a valid search.
+     * @returns True when at least one filter parameter has been set.
+     */
+    protected canSearch(): boolean;
+    protected readonly sectors: _angular_core.WritableSignal<SectorInfo[]>;
+    /**
+     * Checks whether sector-based filtering is available for the current selection.
+     * @returns True when sector filtering applies.
+     */
+    protected hasSectors(): boolean;
+    protected readonly regions: _angular_core.WritableSignal<NameValueItem<string>[]>;
+    /**
+     * Checks whether region-based filtering is available.
+     * @returns True when the selection includes sectors with regional content (LR).
+     */
+    protected readonly hasRegions: _angular_core.Signal<boolean>;
+    protected readonly sources: _angular_core.WritableSignal<NameValueItem<string>[]>;
+    /**
+     * Checks whether source-based filtering applies to the current module selection.
+     * @returns True when source filtering is available.
+     */
+    protected hasSource(): boolean;
+    protected readonly authors: _angular_core.WritableSignal<NameValueItem<string>[]>;
+    protected readonly types: _angular_core.WritableSignal<NameValueItem<string>[]>;
+    /** Topic tree loaded on initialization, used as input for the tree-selection dialog. */
     protected topics: INode[];
-    protected hasTopics: () => boolean;
-    private allowTags;
-    protected tags: _angular_core.WritableSignal<NameValueItem<string>[]>;
-    protected hasTags: () => boolean;
+    /**
+     * Checks whether topic-based filtering applies to the current module selection.
+     * @returns True when topic filtering is available.
+     */
+    protected hasTopics(): boolean;
+    protected readonly tags: _angular_core.WritableSignal<NameValueItem<string>[]>;
+    /**
+     * Checks whether tag-based filtering is available for the current modules.
+     * @returns True when tags are loaded and the selection includes news or in-depth modules.
+     */
+    protected hasTags(): boolean;
     protected reasons: _angular_core.WritableSignal<NameValueItem<number>[]>;
     protected modules: _angular_core.WritableSignal<NameValueItem<ClipperModule>[]>;
     protected interval: DateInterval;
     protected sourceInterval: DateInterval;
     protected user: ClipperUserInfo | undefined;
-    ngOnInit(): void;
-    ngAfterViewInit(): void;
+    constructor();
     /**
        * Get all available modules
        */
@@ -581,8 +643,8 @@ declare class ClipperBrowserComponent extends ClipperSearchResultManager impleme
      */
     getSnapshotDocument(id: string): ClipperDocumentInfo | undefined;
     /**
-    * Load tags
-    */
+     * Loads available tags from the server and populates the tag signal.
+     */
     protected loadTags(): void;
     /**
      * Load topics
@@ -614,21 +676,22 @@ declare class ClipperBrowserComponent extends ClipperSearchResultManager impleme
    */
     private updateFilterPaneFocus;
     /**
-    * Load filters
-    */
+     * Loads the user's saved searches from the server and populates the filter selector.
+     */
     protected loadFilters(): void;
     /**
-     * Save a filter
-     * @param newFilter: true to save a new filter. Default is false.
+     * Saves the current filter parameters as a named search.
+     * @param newFilter - When true, always prompts for a new filter name; otherwise updates the existing one. Defaults to false.
      */
     saveFilter(newFilter?: boolean): void;
     /**
-    * Delete a filter
-    */
+     * Prompts for confirmation and then deletes the currently active saved filter.
+     */
     deleteFilter(): void;
     /**
-    * Select a filter
-    */
+     * Applies a saved filter by deserializing its parameters into the current filter state.
+     * @param item - The saved filter to apply, or undefined to clear the filter.
+     */
     selectFilter(item: NameValueItem<ClipperUserSearch> | undefined): void;
     /**
      * Clear current filter params
@@ -673,64 +736,65 @@ declare class ClipperBrowserComponent extends ClipperSearchResultManager impleme
      */
     protected modulesChanged(): void;
     /**
-     * Check modules against current selected in filter
-     * @param modules : the modules to check for
-     * @param mode : thc check mode: 1) exactly all elements 2) all elements 3) any of the elements specified
-     * @returns true if the check is successfull
+     * Checks the current module selection against a list of expected modules.
+     * @param modules - The modules to check for.
+     * @param mode - The check mode: 1) exactly these elements, 2) all of these elements, 3) any of these elements.
+     * @returns True if the check passes.
      */
     private checkModules;
     /**
-   * Prepare the module specific query
-   * @param newSearch : true if is a new search
-   * @returns the new search params
-   */
+     * Builds the effective query parameters for the next search request.
+     * @param newSearch - When true, resets pagination and triggers facet loading. Defaults to false.
+     * @returns The resolved {@link ClipperSearchParams} ready to be sent to the API.
+     */
     private prepareFetch;
     /**
      * Update filter description
      */
     private updateFilterDescription;
     /**
-    * Get facets
-    * @param params: the clipper search params
-    */
+     * Fetches and applies search facets for the current result set.
+     * @param params - The search parameters used to query facets.
+     */
     protected fetchFacets(params: ClipperSearchParams): void;
     /**
      * Hide facets
      */
     protected hideFacets(): void;
     /**
-     * Fetch data
-     * @param newSearch true if is a new search
+     * Executes the search query and updates the result snapshot.
+     * @param newSearch - When true, resets pagination and reloads facets. Defaults to false.
      */
     protected fetch(newSearch?: boolean): void;
     /**
-    * Show a new page result
-    * @param e : the MatPaginator PageEvent data
-    */
+     * Navigate to a new result page.
+     * @param e - The paginator {@link PageEvent} containing the new page index and size.
+     */
     protected fetchMore(e: PageEvent): void;
     /**
-   * Change sort
-   * @param new sort: the new sort value
-   */
-    protected sort(newSort?: NameValueItem<any>): void;
+     * Change the current sort mode and refresh results.
+     * @param newSort - The new sort option to apply.
+     */
+    protected sort(newSort?: NameValueItem<ClipperSort>): void;
     /**
-  * Show free text help
-  */
+     * Open the free-text search help dialog.
+     */
     protected help(): void;
     /**
-     * Compose a free text search query
+     * Open the query-builder dialog to compose a free-text search expression.
      */
     protected compose(): void;
     /**
-   * Add a topic
-   */
+     * Open the topic-selection dialog and append the chosen topics to the current filter.
+     */
     protected addTopic(): void;
     /**
-     * Remove a topic
+     * Remove a topic from the current filter.
+     * @param item - The topic item to remove.
      */
     protected deleteTopic(item: NameValueItem<string>): void;
     /**
-     * Clear all topics
+     * Remove all topics from the current filter.
      */
     protected clearTopics(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperBrowserComponent, never>;
@@ -745,22 +809,24 @@ interface ClipperBrowserDialogData {
     initialModule?: number;
     theme?: ThemeType;
 }
-declare class ClipperBrowserDialogComponent implements OnInit, AfterViewInit {
+declare class ClipperBrowserDialogComponent {
     private readonly destroyRef;
     readonly clipperBrowser: _angular_core.Signal<ClipperBrowserComponent>;
     protected clipperService: ClipperService;
-    private changeDetector;
     protected dialogData: ClipperBrowserDialogData;
     private dialogRef;
     private broadcastService;
-    ngOnInit(): void;
-    ngAfterViewInit(): void;
+    constructor();
     /**
-     * Checks if documents can be selected and returned as message
+     * Determines whether the current selection satisfies the required selection mode
+     * and module constraints defined in the dialog data.
+     *
+     * @returns `true` if the selection is valid and can be confirmed; `false` otherwise.
      */
     protected canSelect(): boolean;
     /**
-     * Send a message with current selection and close dialog
+     * Broadcasts the current selection as a message and closes the dialog.
+     * Does nothing when the selection is empty.
      */
     protected select(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperBrowserDialogComponent, never>;
@@ -777,18 +843,20 @@ interface SearchFreeTextQueryParams {
 }
 declare class ClipperSearchFreeTextQueryBuilderComponent {
     readonly done: _angular_core.OutputEmitterRef<SearchFreeTextQueryParams>;
-    private dialogService;
+    private readonly dialogService;
     protected queryAnd: string;
     protected queryOr: string;
     protected queryNot: string;
     protected queryPhrase: string;
     protected queryStart: string;
     /**
-     * Clear
+     * Resets all query fields to empty strings.
      */
     protected clear(): void;
     /**
-     * Submit
+     * Builds the Lucene-style free-text query from the current field values and emits it via `done`.
+     * Shows an error dialog when only the NOT operator has been filled in, since it requires
+     * at least one positive term to produce a valid query.
      */
     protected ok(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperSearchFreeTextQueryBuilderComponent, never>;
@@ -800,11 +868,10 @@ declare enum ClipperSearchResultItemDisplayMode {
     Tile = 2,
     Stripe = 3
 }
-declare class ClipperSearchResultItemComponent implements OnInit {
+declare class ClipperSearchResultItemComponent {
     private readonly destroyRef;
-    protected screenService: ScreenService;
-    protected broadcastService: BroadcastService;
-    private changeDetector;
+    protected readonly screenService: ScreenService;
+    private readonly broadcastService;
     readonly parent: _angular_core.InputSignal<ClipperSearchResultManager>;
     readonly item: _angular_core.ModelSignal<ClipperDocumentInfo>;
     readonly actions: _angular_core.InputSignal<MatMenu>;
@@ -819,22 +886,22 @@ declare class ClipperSearchResultItemComponent implements OnInit {
     readonly displayMode: _angular_core.InputSignal<ClipperSearchResultItemDisplayMode>;
     protected readonly displayModesEnum: typeof ClipperSearchResultItemDisplayMode;
     protected readonly modelsEnum: typeof ClipperModel;
-    ngOnInit(): void;
+    /** Incremented whenever the parent's SelectionModel changes, invalidating `isSelected`. */
+    private readonly selectionChangeTick;
     /**
-     * Checks if current item is selected
-     * @returns true if current item is selected
+     * Whether this item is currently selected in the parent's selection model.
+     * Recomputed whenever `selectionChangeTick` is updated by the selection-changed subscription.
      */
-    protected isSelected(): boolean;
+    protected readonly isSelected: _angular_core.Signal<boolean>;
     /**
-     * Checks if current item is read
-     * @returns true if current item is read
+     * Whether this item has already been read by the user.
      */
-    protected isRead(): boolean;
+    protected readonly isRead: _angular_core.Signal<boolean>;
     /**
-   * Checks if current item can be read
-   * @returns true if current item can be read
-   */
-    protected canBeRead(): boolean;
+     * Whether this item is readable but not yet read (i.e. the read-flag action should be shown).
+     */
+    protected readonly canBeRead: _angular_core.Signal<boolean>;
+    constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperSearchResultItemComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperSearchResultItemComponent, "clipper-search-result-item", never, { "parent": { "alias": "parent"; "required": true; "isSignal": true; }; "item": { "alias": "item"; "required": true; "isSignal": true; }; "actions": { "alias": "actions"; "required": true; "isSignal": true; }; "tileNoPictureUrl": { "alias": "tileNoPictureUrl"; "required": false; "isSignal": true; }; "tilePictureUrl": { "alias": "tilePictureUrl"; "required": false; "isSignal": true; }; "isSelectable": { "alias": "isSelectable"; "required": false; "isSignal": true; }; "isReadable": { "alias": "isReadable"; "required": false; "isSignal": true; }; "isReadableModel": { "alias": "isReadableModel"; "required": false; "isSignal": true; }; "displayModifiedTitle": { "alias": "displayModifiedTitle"; "required": false; "isSignal": true; }; "displayModelName": { "alias": "displayModelName"; "required": false; "isSignal": true; }; "displayDate": { "alias": "displayDate"; "required": false; "isSignal": true; }; "displayMode": { "alias": "displayMode"; "required": false; "isSignal": true; }; }, { "item": "itemChange"; }, never, never, true, never>;
 }
@@ -849,161 +916,168 @@ interface ClipperDocumentDialogData {
     canUseArchive?: boolean;
     canHandleTooManyResults?: boolean;
 }
-declare class ClipperDocumentComponent extends ClipperDocumentManager implements OnInit {
+declare class ClipperDocumentComponent extends ClipperDocumentManager {
     readonly relevantsPane: _angular_core.Signal<MatDrawer>;
     readonly closing: _angular_core.OutputEmitterRef<void>;
     readonly opening: _angular_core.OutputEmitterRef<string>;
     private readonly destroyRef;
     private injector;
-    private changeDetector;
     private breakpointObserver;
     private renderer;
     private rendererListener1;
     private router;
     private dialogRef;
     protected dialogData: ClipperDocumentDialogData;
-    protected url: _angular_core.WritableSignal<string>;
-    protected title: _angular_core.WritableSignal<string>;
-    protected busy: _angular_core.WritableSignal<boolean>;
+    protected readonly url: _angular_core.WritableSignal<string>;
+    protected readonly title: _angular_core.WritableSignal<string>;
+    protected readonly busy: _angular_core.WritableSignal<boolean>;
     protected lastQuery?: string;
-    protected lastQueryChunks?: string;
+    protected lastQueryChunks: string;
     protected lastQueryType: 'fulltext' | 'semantic';
-    protected lastDocument?: ClipperDocumentInfo;
-    protected relevants: ClipperDocumentRelevants;
-    protected relevantsPaneHasBackdrop: boolean;
+    protected readonly lastDocument: _angular_core.WritableSignal<ClipperDocumentInfo>;
+    protected readonly relevants: _angular_core.WritableSignal<ClipperDocumentRelevants>;
+    protected readonly relevantsPaneHasBackdrop: _angular_core.WritableSignal<boolean>;
     protected relevantsPaneClosed: boolean;
-    protected relevantsBusy: _angular_core.WritableSignal<boolean>;
-    protected hasRelevants: _angular_core.WritableSignal<boolean>;
-    protected user: ClipperUserInfo | undefined;
-    ngOnInit(): void;
-    ngOnDestroy(): void;
+    protected readonly relevantsBusy: _angular_core.WritableSignal<boolean>;
+    protected readonly hasRelevants: _angular_core.WritableSignal<boolean>;
+    protected readonly user: ClipperUserInfo | undefined;
+    constructor();
     /**
-   * Show hide relevants pane manually
-   */
+     * Toggles the relevants side-pane open/closed state.
+     */
     protected toggleRelevantsPane(): void;
     /**
-     * Handle filter pane visibility
+     * Adjusts the relevants side-pane mode and visibility based on the current viewport breakpoint.
      */
     private handleRelevantsPaneVisibility;
     /**
-     * Close dialog
+     * Emits the closing event and closes the dialog after a short delay.
      */
     protected close(): void;
     /**
-     * Navigate to a new document
-     * @param id : the document id
+     * Navigates to a document or external URL received from the iframe.
+     * @param id - The document id or URL to navigate to.
      */
     navigate(id: string): void;
     /**
-     * Navigate by url
-     * @param url : the url  to navigate to
+     * Resolves and loads a document by its fully-qualified render URL.
+     * Parses query, theme, and anchor information before navigating.
+     * @param url - The full render URL to load.
      */
     navigateByUrl(url: string): void;
     /**
-     * Navigated callback
-     */
-    navigated(id: string, // Documnent id
-    title1: string, // Title 1
-    title2: string, // Title 2
-    tags: string, // Tag
-    model: number, // Model
-    moduleId: number, // Module
-    moduleName: string, // Module name
-    date: string, // Date
-    number: string, // Number
-    author: string, // Author
-    origin: string, // Origin
-    originDescription: string, // Origin description
-    bag: string, // Flags
-    validityInfo: string, // Info about validity
-    expiringInfo: string, // Info about expiring date
-    primaryId: string, // Primary document id
-    primaryModel: number, // Primary document model
-    secondaryId: string, // Secondary document id
-    isTrial: boolean): void;
-    /**
-     * goto previous document in history
+     * Called by the iframe when a document has finished rendering.
+     * Parses and stores all document metadata, then triggers auxiliary data loading.
+     * @param id - Document id.
+     * @param title1 - Primary title.
+     * @param title2 - Secondary title.
+     * @param tags - Comma-separated tag list.
+     * @param model - Document model identifier.
+     * @param moduleId - Module identifier.
+     * @param moduleName - Module display name.
+     * @param date - Publication date string.
+     * @param number - Document number.
+     * @param author - Author name.
+     * @param origin - Source origin code.
+     * @param originDescription - Human-readable origin description.
+     * @param bag - Encoded flags string.
+     * @param validityInfo - Encoded validity information.
+     * @param expiringInfo - Encoded expiration information.
+     * @param primaryId - Id of the primary linked document, if any.
+     * @param primaryModel - Model of the primary linked document.
+     * @param secondaryId - Id of the secondary linked document, if any.
+     * @param isTrial - True when the request is a trial/preview access.
+     */
+    navigated(id: string, title1: string, title2: string, tags: string, model: number, moduleId: number, moduleName: string, date: string, number: string, author: string, origin: string, originDescription: string, bag: string, validityInfo: string, expiringInfo: string, primaryId: string, primaryModel: number, secondaryId: string, isTrial: boolean): void;
+    /**
+     * Navigates back in the iframe's browsing history.
      */
     protected back(): void;
     /**
-     * Goto next document in history
+     * Navigates forward in the iframe's browsing history.
      */
     protected forward(): void;
     /**
-     * Goto next relevant item
+     * Moves focus to the next highlighted relevant hit inside the document.
      */
     protected nextRelevant(): void;
     /**
-     * Goto previous relevant item
+     * Moves focus to the previous highlighted relevant hit inside the document.
      */
     protected previousRelevant(): void;
     /**
-     * Goto a relevant item
-     * @param item : the item to go to
+     * Scrolls to a specific relevant anchor inside the document, or opens it in a new tab.
+     * @param item - The anchor item to navigate to.
      */
     protected gotoRelevant(item: ClipperDocumentAnchorInfo): void;
     /**
-     * Update relevant items
-     * @param anchors: the optional anchor list
+     * Fetches and renders full-text relevant anchors for the current document and query.
      */
     private updateRelevants;
     /**
-   * Update relevant items
-   * @param anchors: the optional anchor list
-   */
+     * Updates the relevant anchors list from chunk-based hit data received from the iframe.
+     * @param anchors - Array of chunk hit data to convert into anchor items.
+     */
     private updateRelevants2;
     /**
-     * Display document structure
+     * Opens the document structure index dialog and scrolls to or opens the selected section.
+     * @param documentId - The id of the document whose index to display.
      */
     protected index(documentId: string): void;
     /**
-   * Get the id in a query string
-   * @param url : the url to process
-   * @param name : the optional id paramenter name. Default is 'id'
-   * @returns : the id parame
-   */
+     * Extracts the value of a named query-string parameter from a URL.
+     * @param url - The URL string to search.
+     * @param name - The parameter name to look for. Defaults to 'id'.
+     * @returns The extracted parameter value.
+     */
     private getId;
     /**
-     * Preview a file if possible
-     * @param url : the url to preview
+     * Previews or downloads a file identified by a render URL.
+     * Opens a preview dialog when the file supports embedding, otherwise triggers a browser download.
+     * @param url - The file render URL to preview.
      */
     private previewFile;
     /**
-      * Show document comment
-      */
+     * Loads and displays the editorial comment associated with the current document.
+     */
     protected showComment(): void;
     /**
-     * Open an item
-     * @param documentId : the document id
-     * @param query: the current query or undefined
-     * @param queryChunks : the query chunks for highlight as string (eg. "|1|2|3...")
-     * @param newWindow: true if the document must be open into a new window
+     * Opens a document, either inline or in a new browser tab.
+     * @param documentId - The id of the document to open.
+     * @param query - Optional free-text query for highlight.
+     * @param queryChunks - Optional chunk offsets for semantic highlight.
+     * @param newWindow - When true, opens the document in a new browser tab.
      */
     open(documentId: string, query?: string, queryChunks?: string, newWindow?: boolean): void;
     /**
-     * Open a document
-     * @param documentId : the document id
-     * @param query: the current query or null
-     * @param queryChunks : the query chunks for highlight as string (eg. "|1|2|3...")
+     * Opens a document inline via the {@link ClipperDocumentsUtils} helper.
+     * @param documentId - The id of the document to open.
+     * @param query - Optional free-text query for highlight.
+     * @param queryChunks - Optional chunk offsets for semantic highlight.
      */
     private openDocument;
     /**
-     * Browse document references
-     * @param documentId : the document id
-     * @param mode : the mode
+     * Opens the references panel for the given document.
+     * @param documentId - The id of the document whose references to display.
+     * @param mode - The reference query mode. Defaults to ReferencesIn.
+     * @param model - Optional document model filter.
+     * @param anchor - Optional anchor id to highlight.
+     * @param anchorTitle - Optional anchor title to display.
+     * @param update - When true, triggers a refresh of the references list. Defaults to true.
      */
-    openReferences(documentId: string, mode?: ClipperQueryReferencesMode, model?: number, anchor?: string, anchorTitle?: string, update?: boolean): void;
+    openReferences(documentId: string, mode?: ClipperQueryReferencesMode, model?: number | null, anchor?: string | null, anchorTitle?: string | null, update?: boolean): void;
     /**
-     * Display a report
-     * @param item
+     * Opens the report viewer for the given document when supported by its model.
+     * @param item - The document whose report to display.
      */
     protected displayReport(item: ClipperDocumentInfo): void;
     /**
-     * Checks if documents can be selected and returned as message
+     * Determines whether the current document satisfies the dialog's selection constraints.
+     * @returns True when the document can be selected and confirmed.
      */
     protected canSelect(): boolean;
     /**
-     * Send a message with current selection and close dialog
+     * Broadcasts the current document as a selection message and closes the dialog.
      */
     protected select(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperDocumentComponent, never>;
@@ -1018,45 +1092,53 @@ interface ClipperDocumentIndexDialogData {
 interface ClipperDocumentIndexDialogResult {
     data: ClipperDocumentAnchorInfo[];
 }
-declare class ClipperDocumentIndexComponent implements OnInit {
+declare class ClipperDocumentIndexComponent {
     readonly selection: _angular_core.Signal<MatSelectionList>;
     readonly done: _angular_core.OutputEmitterRef<ClipperDocumentIndexDialogResult>;
-    private changeDetector;
     private clipperService;
     private dialogService;
     protected dialogData: ClipperDocumentIndexDialogData;
-    protected items?: ClipperDocumentAnchorInfo[];
-    protected okDisabled: _angular_core.WritableSignal<boolean>;
-    ngOnInit(): void;
+    protected readonly items: _angular_core.WritableSignal<ClipperDocumentAnchorInfo[]>;
+    protected readonly okDisabled: _angular_core.WritableSignal<boolean>;
+    constructor();
     /**
-     * Display document structure
+     * Loads the document's structural index from the server and populates the item list.
+     * Items whose type appears in {@link ClipperDocumentIndexDialogData.excludedTypes} are filtered out.
+     * Each item's description is built from its title, or derived from its type and text when no title is set.
      */
     private load;
     /**
-     * Handle selection/deselection of an item
+     * Updates the OK button disabled state based on whether anything is selected in the list.
      */
     protected select(): void;
     /**
-     * Confirm selection
-     * @param item: the selected item or null to use multiple selection if allowed
+     * Emits the current selection as the dialog result.
+     * In single-selection mode, emits the explicitly provided item.
+     * In multiple-selection mode, collects all selected items from the list.
+     * @param item - The directly clicked item for single-selection mode; omit for multiple-selection mode.
      */
     protected use(item?: ClipperDocumentAnchorInfo): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperDocumentIndexComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperDocumentIndexComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
 }
 
-declare class ClipperDocumentMenuComponent implements OnInit {
-    private rsMenuTrigger;
-    private aiAssistantMenuTrigger;
-    private linksMenuTrigger;
-    private allMenuTriggers;
+declare class ClipperDocumentMenuComponent {
+    private readonly rsMenuTrigger;
+    private readonly aiAssistantMenuTrigger;
+    private readonly linksMenuTrigger;
+    private readonly allMenuTriggers;
     private readonly renderer2;
     private readonly destroyRef;
-    private readonly changeDetector;
     private readonly clipperService;
+    /** Internal counter incremented on each external selection-model change to drive signal re-evaluation. */
+    private readonly selectionChangeTick;
     readonly useSelections: _angular_core.InputSignal<boolean>;
-    readonly selectionSource: _angular_core.InputSignal<"selection" | "bag" | "none">;
-    protected selection: () => ClipperDocumentInfo[];
+    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.
+     */
+    protected readonly selection: _angular_core.Signal<ClipperDocumentInfo[]>;
     readonly parent: _angular_core.InputSignal<any>;
     readonly item: _angular_core.InputSignal<ClipperDocumentInfo>;
     readonly isReference: _angular_core.InputSignal<boolean>;
@@ -1069,183 +1151,217 @@ declare class ClipperDocumentMenuComponent implements OnInit {
     readonly canUseArchive: _angular_core.InputSignal<boolean>;
     readonly canUseProperties: _angular_core.InputSignal<boolean>;
     readonly canUseAIAssistant: _angular_core.InputSignal<boolean>;
-    protected canUseAIEditor: boolean;
+    protected readonly canUseAIEditor: boolean;
     readonly canUseRS: _angular_core.InputSignal<boolean>;
     readonly canOpenDocument: _angular_core.InputSignal<boolean>;
-    protected canDeselectAll: () => boolean;
-    protected canManageBag: () => boolean;
-    protected canOpen: () => boolean;
-    protected canSendByEmail: () => boolean;
-    protected canAddProperties: () => boolean;
-    protected canAddToArchive: () => boolean;
-    protected canAddToCalendar: () => boolean;
-    protected canExportCalendar: () => boolean;
-    protected canAddToWorkingDocuments: () => boolean;
-    protected canSaveAsPdf: () => boolean;
-    protected canSetAsRead: () => boolean;
-    protected canSetAsUnread: () => boolean;
-    protected canAccessRS: () => boolean;
-    ngOnInit(): void;
-    /**
-     * Get a single selection
-     * @returns the single selection or null
+    /** `true` when the current selection source is 'selection' and at least one item is selected. */
+    protected readonly canDeselectAll: _angular_core.Signal<boolean>;
+    /** `true` when operating in bag-management mode. */
+    protected readonly canManageBag: _angular_core.Signal<boolean>;
+    /** `true` when opening a document is allowed and exactly one item is selected. */
+    protected readonly canOpen: _angular_core.Signal<boolean>;
+    /** `true` when at least one item can be sent by email. */
+    protected readonly canSendByEmail: _angular_core.Signal<boolean>;
+    /** `true` when custom properties can be added to the single selected document. */
+    protected readonly canAddProperties: _angular_core.Signal<boolean>;
+    /** `true` when archive access is enabled and there is at least one selected item. */
+    protected readonly canAddToArchive: _angular_core.Signal<boolean>;
+    /** `true` when all selected items are deadline/alert documents and calendar is enabled. */
+    protected readonly canAddToCalendar: _angular_core.Signal<boolean>;
+    /** `true` when all selected items can be exported as an ICS calendar file. */
+    protected readonly canExportCalendar: _angular_core.Signal<boolean>;
+    /** `true` when the selection contains non-Coordinamento items that can be added to working documents. */
+    protected readonly canAddToWorkingDocuments: _angular_core.Signal<boolean>;
+    /** `true` when a single non-Coordinamento document is selected and can be saved as PDF. */
+    protected readonly canSaveAsPdf: _angular_core.Signal<boolean>;
+    /** `true` when the selection contains at least one unread document that supports the read state. */
+    protected readonly canSetAsRead: _angular_core.Signal<boolean>;
+    /** `true` when the selection contains at least one already-read document that supports the read state. */
+    protected readonly canSetAsUnread: _angular_core.Signal<boolean>;
+    /** `true` when the Clipper service supports RS and all selected items are RS-enabled. */
+    protected readonly canAccessRS: _angular_core.Signal<boolean>;
+    constructor();
+    /**
+     * Returns a single selected document: the bound item if present, or the sole item in the selection list.
+     * @returns The selected document, or `undefined` when zero or more than one item is selected.
      */
     protected getSingleSelection(): ClipperDocumentInfo | undefined;
     /**
-     * Get multiple selection
-     * @returns : the multiple selection or array empty
+     * Returns the full effective selection as an array.
+     * If a bound item is present it is returned wrapped in a single-element array;
+     * otherwise the full selection list is returned.
+     * @returns An array of selected documents, or an empty array when nothing is selected.
      */
     protected getMultipleSelection(): ClipperDocumentInfo[];
     /**
-    * Check if only one element is selected
-    * @returns true if only one element is selectedf
-    */
+     * Returns whether exactly one document is available for single-item operations.
+     * @returns `true` if the bound item has a non-empty document ID, or if exactly one item is selected.
+     */
     protected hasSingleSelection(): boolean;
     /**
-     * Show and hide sub menus
-     * @param trigger: the trigger to use or null to deselect
-    */
+     * Closes all open sub-menu panels, then optionally opens the given trigger's menu.
+     * @param trigger - The menu trigger to open after closing others; omit to only close.
+     */
     protected showSubMenu(trigger?: MatMenuTrigger): void;
     /**
-     * Reset sub menu
-     * @param trigger: the trigger to use
+     * Removes the CDK focus classes from the given trigger element to reset its visual state.
+     * @param trigger - The menu trigger whose focus styles to clear.
      */
     protected resetSubMenu(trigger: MatMenuTrigger): void;
     /**
-     * Check if current item or selection is read
-     * @returns 0 if not read, 1 if read, 2 if unknown
+     * Returns the read state of the current item or selection.
+     * @returns `0` if unread, `1` if read, `2` if mixed or unknown.
      */
     protected isRead(): number;
     /**
-     * Set the is read flag value
-     * @param value: true or false
+     * Delegates a read/unread state change to the parent component.
+     * @param value - `true` to mark as read, `false` to mark as unread.
      */
     protected setRead(value: boolean): void;
     /**
-     * Open a document
-     * @param item : the item
-     * @param newWindow : true to open in new window
+     * Opens the given document, optionally in a new browser window.
+     * @param item - The document to open; no-op when `undefined`.
+     * @param newWindow - When `true`, opens the document in a new window.
      */
-    protected open(item: ClipperDocumentInfo, newWindow?: boolean): void;
+    protected open(item: ClipperDocumentInfo | undefined, newWindow?: boolean): void;
     /**
-   * Open document references
-   * @param item : the item
-   * @param mode: the mode
-   */
-    protected openReferences(item: ClipperDocumentInfo, mode: number): void;
+     * Opens the references panel for the given document in the specified mode.
+     * @param item - The document whose references to display; no-op when `undefined`.
+     * @param mode - The reference query mode (e.g. 1 = referenced by, 2 = references, 4 = case law).
+     */
+    protected openReferences(item: ClipperDocumentInfo | undefined, mode: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperDocumentMenuComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperDocumentMenuComponent, "clipper-document-menu", never, { "useSelections": { "alias": "useSelections"; "required": false; "isSignal": true; }; "selectionSource": { "alias": "selectionSource"; "required": false; "isSignal": true; }; "parent": { "alias": "parent"; "required": true; "isSignal": true; }; "item": { "alias": "item"; "required": false; "isSignal": true; }; "isReference": { "alias": "isReference"; "required": false; "isSignal": true; }; "isReadable": { "alias": "isReadable"; "required": false; "isSignal": true; }; "isReadableModel": { "alias": "isReadableModel"; "required": false; "isSignal": true; }; "isLawInForce": { "alias": "isLawInForce"; "required": false; "isSignal": true; }; "canPrint": { "alias": "canPrint"; "required": false; "isSignal": true; }; "canFind": { "alias": "canFind"; "required": false; "isSignal": true; }; "canUseCalendar": { "alias": "canUseCalendar"; "required": false; "isSignal": true; }; "canUseArchive": { "alias": "canUseArchive"; "required": false; "isSignal": true; }; "canUseProperties": { "alias": "canUseProperties"; "required": false; "isSignal": true; }; "canUseAIAssistant": { "alias": "canUseAIAssistant"; "required": false; "isSignal": true; }; "canUseRS": { "alias": "canUseRS"; "required": false; "isSignal": true; }; "canOpenDocument": { "alias": "canOpenDocument"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-declare class ClipperPropertyBadgeComponent implements AfterViewInit, OnDestroy {
-    private themeService;
-    private injector;
-    private clipperService;
-    private broadcastService;
-    private dialogService;
-    private destroyRef;
-    private overlay;
+declare class ClipperPropertyBadgeComponent {
+    private readonly themeService;
+    private readonly injector;
+    private readonly clipperService;
+    private readonly broadcastService;
+    private readonly dialogService;
+    private readonly destroyRef;
+    private readonly overlay;
     private overlayRef;
     private resizeSub;
-    private viewContainerRef;
+    private readonly viewContainerRef;
     readonly populateContacts: _angular_core.OutputEmitterRef<SendToPopulateData>;
-    private popupTpl;
+    private readonly popupTpl;
     readonly property: _angular_core.ModelSignal<ClipperDocumentProperty>;
-    protected backgroundColor: _angular_core.WritableSignal<string>;
-    protected trackingUnopenedCount: _angular_core.Signal<number>;
-    protected trackingOpenedCount: _angular_core.Signal<number>;
-    protected totalTrackings: _angular_core.Signal<number>;
-    ngOnDestroy(): void;
-    ngAfterViewInit(): void;
+    protected readonly backgroundColor: _angular_core.WritableSignal<string>;
+    protected readonly trackingUnopenedCount: _angular_core.Signal<number>;
+    protected readonly trackingOpenedCount: _angular_core.Signal<number>;
+    protected readonly totalTrackings: _angular_core.Signal<number>;
+    constructor();
     /**
-     * Gets the background color for the badge, which is a mix of the property color and either black or white depending on the current theme.
-     * @returns the calculated background color as a CSS color string
+     * Computes the badge background color by blending the property colour with
+     * black (dark theme) or white (light theme).
+     * @returns The calculated background colour as a CSS `color-mix()` string.
      */
     private getBackgroundColor;
     /**
-     * Shows the popup with property details at the position of the mouse event. Stops the propagation of the click event to prevent triggering other click handlers.
-     * @param event : the mouse event that triggered the popup, used to get the cursor position for placing the popup
+     * Opens the property-details popup positioned near the mouse cursor.
+     * Stops event propagation to avoid triggering parent click handlers.
+     * @param event - The mouse event used to determine the popup position.
      */
     protected showPopup(event: MouseEvent): void;
     /**
-     * Closes the property details popup.
+     * Closes the property-details popup and cleans up overlay resources.
+     * @param event - Optional mouse event; when provided, propagation is stopped.
      */
     protected closePopup(event?: MouseEvent): void;
     /**
-     * Edits the property by opening a dialog with the PropertyEditComponent. Passes the current property as data to the dialog. Subscribes to the 'done' event of the dialog component to update the property when editing is complete. Stops the propagation of the click event to prevent triggering other click handlers.
-     * @param event : the mouse event that triggered the edit action, used to stop propagation and prevent triggering other click handlers
+     * Opens the property-edit dialog pre-populated with the current property data.
+     * On confirmation, updates the model and broadcasts the change.
+     * Stops event propagation to avoid triggering parent click handlers.
+     * @param event - The mouse event that triggered the edit action.
      */
     protected edit(event: MouseEvent): void;
     /**
-     * Deletes the property after confirming with the user. Opens a confirmation dialog and if the user confirms, emits an event to indicate that the property should be deleted. Stops the propagation of the click event to prevent triggering other click handlers.
-     * @param event : the mouse event that triggered the delete action, used to stop propagation and prevent triggering other click handlers
+     * Opens a confirmation dialog and, on confirmation, deletes the property via the service.
+     * Broadcasts the deletion and closes the popup on success.
+     * Stops event propagation to avoid triggering parent click handlers.
+     * @param event - The mouse event that triggered the delete action.
      */
     protected delete(event: MouseEvent): void;
     /**
-     * Sends the document associated with the property to email. Opens a dialog to enter email details and then calls the service to send the email. Stops the propagation of the click event to prevent triggering other click handlers.
-     * @param event : the mouse event that triggered the send action, used to stop propagation and prevent triggering other click handlers
+     * Opens the send-by-email dialog for the document linked to this property.
+     * On confirmation, sends a notification via the service and updates tracking data.
+     * Stops event propagation to avoid triggering parent click handlers.
+     * @param event - The mouse event that triggered the send action.
      */
     protected sendTo(event: MouseEvent): void;
     /**
-     * Sends the email associated with the property again. Opens a confirmation dialog and if the user confirms, calls the service to resend the email. Stops the propagation of the click event to prevent triggering other click handlers.
-     * @param event The mouse event that triggered the resend action, used to stop propagation and prevent triggering other click handlers
-     * @param notifyIfNotOpen A boolean flag indicating whether to notify if the property is not open
+     * Opens a confirmation dialog and, on confirmation, resends the email notifications
+     * associated with this property.
+     * Stops event propagation to avoid triggering parent click handlers.
+     * @param event - The mouse event that triggered the resend action.
+     * @param notifyIfNotOpen - When `true`, only recipients who have not yet opened the previous email are notified.
      */
     protected sendAgain(event: MouseEvent, notifyIfNotOpen: boolean): void;
     /**
-     * Refresh tracking information for the property by calling the service to get the latest trackings. Updates the property with the new tracking information. Stops the propagation of the click event to prevent triggering other click handlers.
-     * @param event : the mouse event that triggered the refresh action, used to stop propagation and prevent triggering other click handlers
+     * Fetches the latest tracking data for the property from the server and updates the model.
+     * Stops event propagation to avoid triggering parent click handlers.
+     * @param event - The mouse event that triggered the refresh action.
      */
     protected refresh(event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperPropertyBadgeComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperPropertyBadgeComponent, "clipper-property-badge", never, { "property": { "alias": "property"; "required": true; "isSignal": true; }; }, { "populateContacts": "populateContacts"; "property": "propertyChange"; }, never, never, true, never>;
 }
 
-declare class ClipperPropertyEditComponent implements OnInit {
+declare class ClipperPropertyEditComponent {
     readonly done: _angular_core.OutputEmitterRef<ClipperDocumentProperty>;
-    private dialogService;
-    protected dialogData: EditDialogData<ClipperDocumentProperty>;
-    protected dialogTitle: string;
-    private clipperService;
-    protected colors: NameValueItem<string>[];
-    protected colorName(value: string): string;
-    protected isNew: _angular_core.WritableSignal<boolean>;
+    private readonly dialogService;
+    protected readonly dialogData: EditDialogData<ClipperDocumentProperty>;
+    protected readonly dialogTitle: string;
+    private readonly clipperService;
+    protected readonly colors: NameValueItem<string>[];
+    protected readonly isNew: _angular_core.WritableSignal<boolean>;
+    protected readonly availableTeams: _angular_core.WritableSignal<NameValueItem<string>[]>;
+    protected selectedTeam: NameValueItem<string>;
     protected item: ClipperDocumentProperty;
-    protected availableTeams: _angular_core.WritableSignal<NameValueItem<string>[]>;
-    protected selectedTeam?: NameValueItem<string>;
-    ngOnInit(): void;
+    constructor();
+    /**
+     * Returns the display name for the given colour value.
+     * @param value - The hex/CSS colour string to look up.
+     * @returns The human-readable colour name, or the raw value when not found.
+     */
+    protected colorName(value: string): string;
     /**
-      * Load teams
-      */
+     * Loads the teams available for shared-workspace properties and populates the teams dropdown.
+     * Pre-selects the team matching the current item's teamId, defaulting to "Personale".
+     */
     private loadTeams;
     /**
-     * Submit
+     * Saves the property via the service and emits the result through the `done` output.
+     * For new properties, assigns the selected team before saving.
      */
     protected ok(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperPropertyEditComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperPropertyEditComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
 }
 
-declare class ClipperContactEditComponent implements OnInit {
+declare class ClipperContactEditComponent {
     private clipperService;
     private dialogService;
     private dialogRef;
     private dialogData;
     protected readonly f: _angular_core.Signal<NgForm>;
     readonly done: _angular_core.OutputEmitterRef<EditDialogCompleted<ClipperContactInfo>>;
-    protected dialogTitle: string;
-    protected isNew: _angular_core.WritableSignal<boolean>;
+    protected readonly dialogTitle: string;
+    protected readonly isNew: _angular_core.WritableSignal<boolean>;
     protected item: ClipperContactInfo;
-    protected availableTeams: _angular_core.WritableSignal<NameValueItem<string>[]>;
-    protected selectedTeam?: NameValueItem<string>;
-    ngOnInit(): void;
+    protected readonly availableTeams: _angular_core.WritableSignal<NameValueItem<string>[]>;
+    protected selectedTeam: NameValueItem<string>;
+    constructor();
     /**
-      * Load teams
-      */
+     * Loads the list of available teams from the server and populates the team selector.
+     * Pre-selects the team that matches the current contact's team id, falling back to 'Personale'.
+     */
     private loadTeams;
     /**
-     * Save
-     * @param save : true if data must really be submitted because changed
+     * Persists the current contact to the server.
+     * Closes the dialog without saving when editing an existing contact whose form is unchanged.
      */
     protected save(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperContactEditComponent, never>;
@@ -1253,26 +1369,48 @@ declare class ClipperContactEditComponent implements OnInit {
 }
 
 declare class ClipperContactsSelector {
-    static Show(injector: Injector, canAppend?: boolean, canEdit?: boolean, onSelect?: Function): void;
+    /**
+     * Builds an HTML string representing a list of email addresses separated by line breaks.
+     * @param emails - A semicolon-separated string of email addresses, or undefined.
+     * @returns An HTML string with each address wrapped in a `<span>` tag.
+     */
+    private static buildEmailsHtml;
+    /**
+     * Builds the HTML row template used to display a contact inside the selection dialog.
+     * @param item - The contact data to render.
+     * @returns An HTML string representing the contact row.
+     */
+    private static buildContactTemplate;
+    /**
+     * Opens the contacts selection/management dialog and wires up all interaction events.
+     * @param injector - The Angular injector used to resolve services within the dialog context.
+     * @param canAppend - When true, the dialog allows adding new contacts.
+     * @param canEdit - When true, the dialog allows editing and deleting contacts.
+     * @param onSelect - Optional callback invoked with the selection result when the user confirms.
+     */
+    static Show(injector: Injector, canAppend?: boolean, canEdit?: boolean, onSelect?: (result: unknown) => void): void;
 }
 
 declare class ClipperDocumentsUtils {
     /**
-     * Open a document
-     * @param injector: the injector
-     * @param documentId : the document id
-     * @param query : the query for highlight
-     * @param queryChunks : the query chunks for highlight as string (eg. "|1|2|3...")
-     * @param selectionMode : the clipper selection mode
-     * @param selectableModules : the clipper selectable modules
-     * @param theme: the theme to use. Default is system
-     * @param canUseArchive: ture if archive is available
-     * @param canHandleTooManyResults: true if the component should handle too many results
+     * Opens the Clipper document viewer dialog for the given document.
+     * @param injector - The Angular injector used to resolve `DialogService` and `ClipperService`.
+     * @param documentId - The ID of the document to open.
+     * @param query - The search query string used for term highlighting.
+     * @param queryChunks - Pipe-separated highlight chunks (e.g. "|1|2|3...").
+     * @param selectionMode - The Clipper selection mode to activate inside the viewer.
+     * @param selectableModules - The list of Clipper modules available for selection.
+     * @param theme - The UI theme to apply. Defaults to the system theme.
+     * @param canUseArchive - When `true`, archive access is enabled inside the viewer.
+     * @param canHandleTooManyResults - When `true`, the component handles oversized result sets.
+     * @returns The `MatDialogRef` for the opened dialog, or `undefined` when the user is not logged in
+     *   or the document ID is invalid.
      */
     static openDocument(injector: Injector, documentId: string, query?: string, queryChunks?: string, selectionMode?: ClipperSelectionMode, selectableModules?: ClipperModule[], theme?: ThemeType, canUseArchive?: boolean, canHandleTooManyResults?: boolean): MatDialogRef<ClipperDocumentComponent> | undefined;
     /**
-     * Extract document title
-     * @param title : the full document title
+     * Extracts the display title from a full document title by stripping any trailing `[...]` suffix.
+     * @param title - The full document title, which may contain a bracketed qualifier.
+     * @returns The portion of the title before the first `[`, or the original title when no `[` is present.
      */
     static parseDocumentTitle(title: string): string;
 }