@arsedizioni/ars-utils 22.5.11 → 22.5.12

package/package.json

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

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

@@ -1,12 +1,12 @@
 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, ClipperDocumentRelevants, ClipperDocumentAnchorInfo } from '@arsedizioni/ars-utils/clipper.common';
-import { BroadcastService, DateInterval, ThemeService, ScreenService, SelectableModel, NameValueItem, INode, ThemeType } from '@arsedizioni/ars-utils/core';
+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';
@@ -257,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>;
@@ -264,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,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;
@@ -902,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.
@@ -1254,28 +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 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, 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, ClipperDocumentComponent, ClipperDocumentIndexComponent, ClipperDocumentManager, ClipperDocumentMenuComponent, ClipperDocumentsUtils, 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 };