@nexterajs/report-viewer 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexterajs/report-viewer",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "peerDependencies": {
     "@angular/common": "^22.0.0",
     "@angular/core": "^22.0.0",
@@ -19,7 +19,7 @@
   "engines": {
     "node": "^22.22.3 || ^24.15.0 || >=26.0.0"
   },
-  "description": "Angular report viewer for reports served by Nextera.Report.AspNetCore: pages rendered on the server, shown in shadow roots, with a toolbar and a programmatic api.",
+  "description": "Angular report viewer for reports served by Nextera.Reports.Angular.NetCore: pages rendered on the server, shown in shadow roots, with a toolbar and a programmatic api.",
   "keywords": [
     "angular",
     "report",

package/types/nexterajs-report-viewer.d.ts

@@ -188,9 +188,21 @@ declare const NXE_ENGLISH: {
     PrevPage: string;
     NextPage: string;
     LastPage: string;
-    /** The save button's caption and tooltip; its menu items are captioned by the format they write. */
+    /** The save button's caption and tooltip, and its menu items, captioned by the format they write. */
     Save: string;
     SaveToolTip: string;
+    formatPdf: string;
+    formatHtml: string;
+    /** The resources button's tooltip. */
+    Resources: string;
+    /** The find button's tooltip, and the find panel's captions. */
+    FindToolTip: string;
+    FindWhat: string;
+    FindPrevious: string;
+    FindNext: string;
+    MatchCase: string;
+    MatchWholeWord: string;
+    closeFind: string;
     /** The view-mode button's tooltip, and its menu items, whose captions are the mode names. */
     ViewModeToolTip: string;
     SinglePage: string;
@@ -198,6 +210,7 @@ declare const NXE_ENGLISH: {
     MultiplePages: string;
     /** The zoom button's tooltip; its caption is the current percentage, so it has no key. */
     ZoomToolTip: string;
+    /** Fitting a whole page, which Stimulsoft's menu captions by the page's height. */
     ZoomOnePage: string;
     ZoomPageWidth: string;
     errorUnreachable: string;
@@ -337,6 +350,14 @@ declare class NxeViewerSessionService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<NxeViewerSessionService>;
 }
 
+/** What the user asked the viewer to find, and which way to go from the current hit. */
+interface NxeFindRequest {
+    readonly text: string;
+    readonly forward: boolean;
+    readonly matchCase: boolean;
+    readonly wholeWord: boolean;
+}
+
 /**
  * What a host reaches through the component's `api`, with Stimulsoft's names and meanings. The
  * members for zoom, view mode, export, print, email and find arrive with the tasks that implement
@@ -403,6 +424,20 @@ declare class NxeReportViewerComponent implements OnChanges {
     private scrollingToPage;
     private scrollSettled;
     protected readonly toolbarVisible: _angular_core.Signal<boolean>;
+    /** See `.nxe-viewer-bookmarks`: the whole of Stimulsoft's bookmarks panel at width 0. */
+    protected readonly showBookmarksStrip: _angular_core.Signal<boolean>;
+    /** Whether the find panel is open; Stimulsoft's Find button opens and closes it. */
+    protected readonly findOpen: _angular_core.WritableSignal<boolean>;
+    /** The search on show: what was looked for, the elements found, and which one is current. */
+    private findKey;
+    private hits;
+    private currentHit;
+    private lastFind;
+    /**
+     * The pages whose HTML is on screen, so a search can follow them: in SinglePage the page changes
+     * under it, and in the scrolling modes pages keep arriving as they are fetched.
+     */
+    private readonly renderedPages;
     protected readonly pageCss: _angular_core.Signal<string>;
     protected readonly showPageShadow: _angular_core.Signal<boolean>;
     protected readonly pageBorder: _angular_core.Signal<string | null>;
@@ -425,6 +460,31 @@ declare class NxeReportViewerComponent implements OnChanges {
     private readonly measuredHeight;
     protected readonly rootHeight: _angular_core.Signal<string>;
     constructor();
+    /** The Find button opens the panel, or closes it and takes the search's highlights away. */
+    protected toggleFind(): void;
+    protected closeFind(): void;
+    /**
+     * A search from the find panel, run as Stimulsoft runs it (angular-viewer-panels-chrome.md §1.3,
+     * §1.6): empty text clears the highlights; new text, or a changed option, finds afresh and makes the
+     * first hit current; the same search again steps to the next or previous hit, round the ends. Each
+     * current hit is scrolled into view. Stimulsoft finds only in the pages it has on screen; this viewer
+     * fetches the pages a scrolling mode has not fetched yet, and finds in them as they arrive.
+     */
+    protected find(request: NxeFindRequest): void;
+    /** Finds again over the pages now on screen, keeping the current hit when it is still there. */
+    private refreshFind;
+    private runFind;
+    private resetFind;
+    /** Each page on screen keeps its HTML in its own shadow root. */
+    private pageRoots;
+    private requestAllPages;
+    /**
+     * Scrolls the current hit to its own height plus 50 px below the top of the report panel, over
+     * 350 ms: always after a fresh search, and after a step only when the hit is out of view. That is
+     * what Stimulsoft's viewer was seen to do; the exact place it scrolls to also carries offsets of its
+     * own page markup, which this viewer's pages do not have.
+     */
+    private revealHit;
     /**
      * A change to any input reloads, as Stimulsoft's viewer does: its `ngOnChanges` never looks at
      * which input changed, so even a width change asks the server for the options and the report
@@ -468,6 +528,8 @@ declare class NxeReportViewerComponent implements OnChanges {
     private trackCurrentPage;
     /** Stimulsoft animates the panel to the page's top over 350 ms, in steps of about 30 ms. */
     private scrollToPage;
+    /** Scrolls the report panel over 350 ms in steps of about 30 ms, as Stimulsoft's scrolls all run. */
+    private animateScroll;
     /**
      * The getters read the session's signals, so a host that asks between renders gets what is on
      * screen now. Built from a captured session rather than `this`, because `this` inside an object