@arsedizioni/ars-utils 22.5.9 → 22.5.12

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

@@ -1,19 +1,18 @@
 import * as _angular_core from '@angular/core';
-import { DestroyRef, ChangeDetectorRef, Injector } from '@angular/core';
+import { DestroyRef, ChangeDetectorRef } from '@angular/core';
 import { ScrollDispatcher } from '@angular/cdk/scrolling';
 import { MatExpansionPanel } from '@angular/material/expansion';
 import { MatInput } from '@angular/material/input';
 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, ClipperUserSearch, SectorInfo, ClipperUserInfo, EditDialogCompleted, ClipperContactInfo, ClipperDocumentRelevants, ClipperDocumentAnchorInfo, ClipperDocumentNote, EditDialogData } from '@arsedizioni/ars-utils/clipper.common';
-import { BroadcastService, DateInterval, ThemeService, ScreenService, SelectableModel, NameValueItem, INode, ThemeType } from '@arsedizioni/ars-utils/core';
+import { ClipperSearchFacetsSnapshot, ClipperSearchFacet, ClipperSearchFacetGroup, ClipperService, ClipperDocumentInfo, ClipperSearchParams, ClipperQueryReferencesMode, ClipperModule, ClipperModel, ClipperSearchCalendarSnapshotMonth, ClipperSearchCalendarSnapshotResult, ClipperSelectionMode, ClipperSearchResult, ClipperSort, ClipperUserSearch, SectorInfo, ClipperUserInfo, ClipperDocumentRelevants, ClipperDocumentAnchorInfo } from '@arsedizioni/ars-utils/clipper.common';
+import { BroadcastService, DateInterval, ThemeType, ThemeService, ScreenService, SelectableModel, NameValueItem, INode } from '@arsedizioni/ars-utils/core';
 import { CalendarEmptyHeader, ButtonSelectorComponent, ChipsSelectorComponent } from '@arsedizioni/ars-utils/ui.controls';
 import { BreakpointObserver } from '@angular/cdk/layout';
 import { Clipboard } from '@angular/cdk/clipboard';
 import { ApplicationDialogService } from '@arsedizioni/ars-utils/ui.application';
 import { SendToPopulateData } from '@arsedizioni/ars-utils/ui';
 import { MatCalendar, MatCalendarCellClassFunction } from '@angular/material/datepicker';
-import { NgForm } from '@angular/forms';
 import { MatSelectionList } from '@angular/material/list';
 import { MatMenuTrigger, MatMenu } from '@angular/material/menu';
 
@@ -79,8 +78,6 @@ declare class ClipperDocumentManager {
     readonly clipperService: ClipperService;
     protected readonly broadcastService: BroadcastService;
     protected readonly dialogService: ApplicationDialogService;
-    protected readonly canUseArchive: _angular_core.WritableSignal<boolean>;
-    protected readonly canUseNotes: _angular_core.WritableSignal<boolean>;
     protected readonly canHandleTooManyResults: _angular_core.WritableSignal<boolean>;
     protected readonly canPopulateContacts: _angular_core.WritableSignal<boolean>;
     /**
@@ -100,16 +97,6 @@ declare class ClipperDocumentManager {
      * @param item - The document whose deadline to export.
      */
     exportDeadline(item: ClipperDocumentInfo): void;
-    /**
-     * Sends a broadcast message to add the given documents to the archive.
-     * @param items - The list of documents to archive.
-     */
-    addToArchive(items: ClipperDocumentInfo[]): void;
-    /**
-     * 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;
     /**
      * Sends a broadcast message to add the given documents to the working-documents set.
      * @param items - The list of documents to add.
@@ -120,11 +107,6 @@ declare class ClipperDocumentManager {
      * @param items - The list of documents to add.
      */
     addItemsToBag(items: ClipperDocumentInfo[]): void;
-    /**
-     * Sends a broadcast message to add custom notes to the given document.
-     * @param item - The document to add notes to.
-     */
-    addItemNotes(item: ClipperDocumentInfo): void;
     /**
      * 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.
@@ -275,6 +257,49 @@ declare class ClipperSearchCalendarComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperSearchCalendarComponent, "clipper-search-calendar", never, { "canFilter": { "alias": "canFilter"; "required": false; "isSignal": true; }; }, { "changed": "changed"; }, never, never, true, never>;
 }
 
+/**
+ * Opens the Clipper document viewer.
+ *
+ * It used to be a static method taking an `Injector` and resolving its dependencies through
+ * `runInInjectionContext`. That is the escape hatch for code that cannot do DI, and both callers
+ * here are components — they were injecting an `Injector` for the sole purpose of handing it over.
+ * As a service the dependencies are resolved at field level, which also removes a trap: the
+ * asynchronous continuation after the dynamic `import()` is outside the injection context, so an
+ * `inject()` added in there would have failed at runtime.
+ */
+declare class ClipperDocumentUtilsService {
+    private readonly dialogService;
+    private readonly clipperService;
+    /**
+     * Opens the Clipper document viewer dialog for the given document.
+     * @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 canHandleTooManyResults - When `true`, the component handles oversized result sets.
+     * @param replaceUrl - When provided, after the dialog closes the method calls `window.close()`
+     *   if the page was opened by another window, or navigates to this URL otherwise.
+     * @returns void
+     */
+    openDocument(documentId: string, query?: string, queryChunks?: string, selectionMode?: ClipperSelectionMode, selectableModules?: ClipperModule[], theme?: ThemeType, canHandleTooManyResults?: boolean, replaceUrl?: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperDocumentUtilsService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ClipperDocumentUtilsService>;
+}
+/**
+ * Pure helpers on document data. Deliberately NOT a service: there is nothing to inject, and a
+ * string function that needs an injector to be called is a function nobody can call from a test.
+ */
+declare class ClipperDocumentsUtils {
+    /**
+     * 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;
+}
+
 declare class ClipperSearchResultManager extends ClipperDocumentManager {
     readonly paginator: _angular_core.Signal<MatPaginator>;
     readonly facets: _angular_core.Signal<ClipperSearchFacetsComponent>;
@@ -282,7 +307,7 @@ declare class ClipperSearchResultManager extends ClipperDocumentManager {
     protected readonly destroyRef: DestroyRef;
     protected readonly changeDetector: ChangeDetectorRef;
     protected readonly breakpointObserver: BreakpointObserver;
-    protected readonly injector: Injector;
+    protected readonly documentUtils: ClipperDocumentUtilsService;
     protected readonly themeService: ThemeService;
     readonly screenService: ScreenService;
     selection: SelectableModel<ClipperDocumentInfo, string> | undefined;
@@ -748,56 +773,6 @@ declare class ClipperBrowserDialogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperBrowserDialogComponent, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-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 readonly dialogTitle: string;
-    protected readonly isNew: _angular_core.WritableSignal<boolean>;
-    protected item: ClipperContactInfo;
-    protected readonly availableTeams: _angular_core.WritableSignal<NameValueItem<string>[]>;
-    protected selectedTeam: NameValueItem<string>;
-    constructor();
-    /**
-     * 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;
-    /**
-     * 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>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperContactEditComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
-}
-
-declare class ClipperContactsSelector {
-    /**
-     * 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;
-}
-
 interface ClipperDocumentDialogData {
     selectionMode?: ClipperSelectionMode;
     selectableModules?: ClipperModule[];
@@ -805,8 +780,6 @@ interface ClipperDocumentDialogData {
     query?: string;
     queryChunks?: string;
     theme?: ThemeType;
-    canUseArchive?: boolean;
-    canUseNotes?: boolean;
     canHandleTooManyResults?: boolean;
 }
 declare class ClipperDocumentComponent extends ClipperDocumentManager {
@@ -818,7 +791,7 @@ declare class ClipperDocumentComponent extends ClipperDocumentManager {
     readonly closing: _angular_core.OutputEmitterRef<void>;
     readonly opening: _angular_core.OutputEmitterRef<string>;
     private readonly destroyRef;
-    private readonly injector;
+    private readonly documentUtils;
     private readonly breakpointObserver;
     private readonly renderer;
     private rendererListener1;
@@ -972,7 +945,7 @@ declare class ClipperDocumentComponent extends ClipperDocumentManager {
      */
     open(documentId: string, query?: string, queryChunks?: string, newWindow?: boolean): void;
     /**
-     * Opens a document inline via the {@link ClipperDocumentsUtils} helper.
+     * Opens a document inline via the {@link ClipperDocumentUtilsService}.
      * @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.
@@ -1072,9 +1045,6 @@ declare class ClipperDocumentMenuComponent {
     readonly isLawInForce: _angular_core.InputSignal<boolean>;
     readonly canPrint: _angular_core.InputSignal<boolean>;
     readonly canFind: _angular_core.InputSignal<boolean>;
-    readonly canUseCalendar: _angular_core.InputSignal<boolean>;
-    readonly canUseArchive: _angular_core.InputSignal<boolean>;
-    readonly canUseNotes: _angular_core.InputSignal<boolean>;
     readonly canUseAIAssistant: _angular_core.InputSignal<boolean>;
     protected readonly canUseAIEditor: boolean;
     readonly canUseRS: _angular_core.InputSignal<boolean>;
@@ -1087,13 +1057,7 @@ declare class ClipperDocumentMenuComponent {
     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 notes can be added to the single selected document. */
-    protected readonly canAddNotes: _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. */
+    /** `true` when all selected items are deadline/alert documents and can travel as an ICS 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>;
@@ -1155,113 +1119,7 @@ declare class ClipperDocumentMenuComponent {
      */
     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; }; "canUseNotes": { "alias": "canUseNotes"; "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 ClipperNoteBadgeComponent {
-    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 readonly viewContainerRef;
-    readonly populateContacts: _angular_core.OutputEmitterRef<SendToPopulateData>;
-    private readonly popupTpl;
-    readonly note: _angular_core.ModelSignal<ClipperDocumentNote>;
-    private readonly theme;
-    /**
-     * Badge background colour, blended from the note colour and the active theme.
-     * Recomputes automatically whenever the theme or the note colour changes.
-     */
-    protected readonly backgroundColor: _angular_core.Signal<string>;
-    protected readonly trackingUnopenedCount: _angular_core.Signal<number>;
-    protected readonly trackingOpenedCount: _angular_core.Signal<number>;
-    protected readonly totalTrackings: _angular_core.Signal<number>;
-    constructor();
-    /**
-     * Opens the note-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 note-details popup and cleans up overlay resources.
-     * @param event - Optional mouse event; when provided, propagation is stopped.
-     */
-    protected closePopup(event?: MouseEvent): void;
-    /**
-     * Opens the note-edit dialog pre-populated with the current note 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;
-    /**
-     * Opens a confirmation dialog and, on confirmation, deletes the note 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;
-    /**
-     * Opens the send-by-email dialog for the document linked to this note.
-     * 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;
-    /**
-     * Opens a confirmation dialog and, on confirmation, resends the email notifications
-     * associated with this note.
-     * 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;
-    /**
-     * Fetches the latest tracking data for the note 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<ClipperNoteBadgeComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperNoteBadgeComponent, "clipper-note-badge", never, { "note": { "alias": "note"; "required": true; "isSignal": true; }; }, { "populateContacts": "populateContacts"; "note": "noteChange"; }, never, never, true, never>;
-}
-
-declare class ClipperNoteEditComponent {
-    readonly done: _angular_core.OutputEmitterRef<ClipperDocumentNote>;
-    private readonly dialogService;
-    protected readonly dialogData: EditDialogData<ClipperDocumentNote>;
-    protected readonly dialogTitle: _angular_core.WritableSignal<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: ClipperDocumentNote;
-    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;
-    /**
-     * Loads the teams available for shared-workspace notes and populates the teams dropdown.
-     * Pre-selects the team matching the current item's teamId, defaulting to "Personale".
-     */
-    private loadTeams;
-    /**
-     * Saves the note via the service and emits the result through the `done` output.
-     * For new notes, assigns the selected team before saving.
-     */
-    protected ok(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperNoteEditComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperNoteEditComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, 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; }; "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>;
 }
 
 interface ClipperReferencesDialogData {
@@ -1270,7 +1128,6 @@ interface ClipperReferencesDialogData {
     anchorTitle?: string;
     documentId: string;
     model: number;
-    canUseArchive?: boolean;
     canHandleTooManyResults?: boolean;
 }
 interface ClipperReferenceDialogResult {
@@ -1440,30 +1297,5 @@ declare class ClipperSearchResultItemComponent {
     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>;
 }
 
-declare class ClipperDocumentsUtils {
-    /**
-     * 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 canUseNotes - When `true`, notes access is enabled inside the viewer.
-     * @param canHandleTooManyResults - When `true`, the component handles oversized result sets.
-     * @param replaceUrl - When provided, after the dialog closes the method calls `window.close()`
-     *   if the page was opened by another window, or navigates to this URL otherwise.
-     */
-    static openDocument(injector: Injector, documentId: string, query?: string, queryChunks?: string, selectionMode?: ClipperSelectionMode, selectableModules?: ClipperModule[], theme?: ThemeType, canUseArchive?: boolean, canUseNotes?: boolean, canHandleTooManyResults?: boolean, replaceUrl?: string): void;
-    /**
-     * 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;
-}
-
-export { ClipperBrowserComponent, ClipperBrowserDialogComponent, ClipperContactEditComponent, ClipperContactsSelector, ClipperDocumentComponent, ClipperDocumentIndexComponent, ClipperDocumentManager, ClipperDocumentMenuComponent, ClipperDocumentsUtils, ClipperNoteBadgeComponent, ClipperNoteEditComponent, ClipperReferencesComponent, ClipperSearchCalendarComponent, ClipperSearchFacetsComponent, ClipperSearchFreeTextHelpComponent, ClipperSearchFreeTextQueryBuilderComponent, ClipperSearchResultItemComponent, ClipperSearchResultItemDisplayMode, ClipperSearchResultManager };
+export { ClipperBrowserComponent, ClipperBrowserDialogComponent, ClipperDocumentComponent, ClipperDocumentIndexComponent, ClipperDocumentManager, ClipperDocumentMenuComponent, ClipperDocumentUtilsService, ClipperDocumentsUtils, ClipperReferencesComponent, ClipperSearchCalendarComponent, ClipperSearchFacetsComponent, ClipperSearchFreeTextHelpComponent, ClipperSearchFreeTextQueryBuilderComponent, ClipperSearchResultItemComponent, ClipperSearchResultItemDisplayMode, ClipperSearchResultManager };
 export type { ClipperBrowserDialogData, ClipperDocumentDialogData, ClipperDocumentIndexDialogData, ClipperDocumentIndexDialogResult, ClipperReferenceDialogResult, ClipperReferencesDialogData, SearchFreeTextQueryParams };