ng2-pdfjs-viewer 26.1.0 → 26.2.0

package/README.md

@@ -16,8 +16,12 @@
 [![PDF.js](https://img.shields.io/badge/PDF.js-6.0.227-green?style=flat-square&logo=mozilla)](https://github.com/mozilla/pdf.js)
 [![license](https://img.shields.io/badge/license-Apache--2.0%20%28Commons%20Clause%29-blue?style=flat-square)](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/LICENSE)
 [![stars](https://img.shields.io/github/stars/intbot/ng2-pdfjs-viewer?style=flat-square&logo=github)](https://github.com/intbot/ng2-pdfjs-viewer)
+[![Open in StackBlitz](https://img.shields.io/badge/Open%20in-StackBlitz-1389FD?style=flat-square&logo=stackblitz&logoColor=white)](https://stackblitz.com/github/intbot/ng2-pdfjs-viewer/tree/master/examples/quickstart)
+[![Edit on CodeSandbox](https://img.shields.io/badge/Edit%20on-CodeSandbox-151515?style=flat-square&logo=codesandbox&logoColor=white)](https://codesandbox.io/p/sandbox/github/intbot/ng2-pdfjs-viewer/tree/master/examples/quickstart)
 
-[**Live demo**](https://angular-pdf-viewer-demo.vercel.app/) · [**Documentation**](https://angular-pdf-viewer-docs.vercel.app/) · [**API reference**](https://angular-pdf-viewer-docs.vercel.app/docs/api/component-inputs) · [**Changelog**](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/CHANGELOG.md)
+[**Documentation**](https://angularpdf.com/) · [**API reference**](https://angularpdf.com/docs/api/component-inputs) · [**Live demo**](https://demo.angularpdf.com/) · [**Showcase**](https://angularpdf.com/showcase) · [**Changelog**](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/CHANGELOG.md)
+
+⭐ **Find it useful? [Star it on GitHub](https://github.com/intbot/ng2-pdfjs-viewer)** — it helps more Angular developers discover it.
 
 </div>
 
@@ -31,6 +35,9 @@ AI assistant — all driven by typed `@Input()`s and `@Output()` events, no ifra
 Shipping since **2018**, **8.3+ million downloads**, mobile-first, and built & verified on **Angular 22**
 while keeping a wide `>=10` peer range so existing apps upgrade without churn.
 
+From France's data-protection regulator to Switzerland's federal tech institute, it's in
+production on five continents — [see who's using it ↓](#-used-in-production).
+
 ```bash
 npm install ng2-pdfjs-viewer
 ```
@@ -41,6 +48,22 @@ npm install ng2-pdfjs-viewer
 
 That's the whole integration. [Wire up the assets](#-quick-start) and you have a full viewer.
 
+## 🌍 Used in production
+
+National regulators, public universities, research infrastructure, and fintech platforms render
+PDFs with ng2-pdfjs-viewer — on five continents. Among them:
+
+| | |
+|---|---|
+| <img src="https://flagcdn.com/20x15/ch.png" width="20" alt="Switzerland"> **EPFL** | Switzerland's federal institute of technology — the Infoscience research portal |
+| <img src="https://flagcdn.com/20x15/fr.png" width="20" alt="France"> **CNIL** | France's national data-protection authority |
+| <img src="https://flagcdn.com/20x15/fi.png" width="20" alt="Finland"> **Finnish National Agency for Education** | the country's open learning-materials library (AOE) |
+| <img src="https://flagcdn.com/20x15/au.png" width="20" alt="Australia"> **AuScope** | Australia's national geoscience research infrastructure |
+| <img src="https://flagcdn.com/20x15/es.png" width="20" alt="Spain"> **Spain's Ministry of Culture** | the Travesía cultural-heritage platform |
+| <img src="https://flagcdn.com/20x15/us.png" width="20" alt="United States"> **University of Virginia** | the Supporting Transformative Autism Research (DRIVE) program |
+
+Part of **8.3M+ installs** worldwide. [See the full showcase →](https://angularpdf.com/showcase)
+
 ## ✨ Highlights
 
 | | |
@@ -52,11 +75,11 @@ That's the whole integration. [Wire up the assets](#-quick-start) and you have a
 | 🤖 **AI assistant (BYO)** | Point it at any OpenAI-compatible endpoint (OpenAI, Azure, Ollama, vLLM…). Answers cite pages and click through. **The library never calls an AI service on its own.** |
 | 🔊 **Read aloud** | Browser speech synthesis reads sentence by sentence, highlighting the spoken text and reporting progress. |
 | 🗂️ **Organize pages** | Reorder, delete, cut/copy/paste, extract, and merge pages in the viewer's "Manage pages" panel. |
-| 🎨 **Make it yours** | CSS-variable theming, true dark-mode page rendering, and your own Angular templates for the toolbar, sidebar, and per-page overlays. |
+| 🎨 **Make it yours** | CSS-variable theming, true dark-mode page rendering, and your own Angular templates for the toolbar, sidebar, and per-page overlays — or go `chromeless` to hide the chrome for an embedded, pages-only view. |
 | 🛡️ **Protect content** | Block print/download, disable selection, and stamp watermarks (honest client-side deterrence — not DRM). |
 | ♿ **Accessible** | Screen-reader friendly, tagged-PDF aware, keyboard navigable — with a [WCAG / EAA guide](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/ACCESSIBILITY.md). |
 
-→ Explore every feature with live code on the **[documentation site](https://angular-pdf-viewer-docs.vercel.app/)** and **[demo](https://angular-pdf-viewer-demo.vercel.app/)**.
+→ Explore every feature with live code on the **[documentation site](https://angularpdf.com/)** and **[demo](https://demo.angularpdf.com/)**.
 
 ## 🚀 Quick start
 
@@ -95,13 +118,13 @@ export class AppModule {}
 
 > **Production note:** PDF.js 6 ships ES modules (`.mjs`), localization (`.ftl`), and WebAssembly
 > (`.wasm`) assets. Make sure your web server returns the correct MIME types for them — see the
-> [deployment guide](https://angular-pdf-viewer-docs.vercel.app/docs/getting-started) for the
+> [deployment guide](https://angularpdf.com/docs/getting-started) for the
 > nginx/IIS snippets.
 
 ## 🧩 What you can build
 
 A few of the things the component makes one-liners. Full, runnable versions live in the
-[feature guides](https://angular-pdf-viewer-docs.vercel.app/docs/features/overview).
+[feature guides](https://angularpdf.com/docs/features/overview).
 
 **Annotate, sign, and save the result**
 
@@ -157,15 +180,15 @@ The README is the front door — the deep reference lives on the docs site and s
 
 | | |
 |---|---|
-| 🏁 [Getting started](https://angular-pdf-viewer-docs.vercel.app/docs/getting-started) | Install, assets, first viewer, production deployment |
-| 🧭 [Feature guides](https://angular-pdf-viewer-docs.vercel.app/docs/features/overview) | Annotation, forms, search, AI, read-aloud, custom UI, protection, and more |
-| 🔧 [API reference](https://angular-pdf-viewer-docs.vercel.app/docs/api/component-inputs) | Every `@Input()`, `@Output()`, and method, with types |
+| 🏁 [Getting started](https://angularpdf.com/docs/getting-started) | Install, assets, first viewer, production deployment |
+| 🧭 [Feature guides](https://angularpdf.com/docs/features/overview) | Annotation, forms, search, AI, read-aloud, custom UI, protection, and more |
+| 🔧 [API reference](https://angularpdf.com/docs/api/component-inputs) | Every `@Input()`, `@Output()`, and method, with types |
 | ♿ [Accessibility](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/ACCESSIBILITY.md) | Screen readers, tagged PDFs, keyboard nav, WCAG / EAA |
 | 🖥️ [Server-side examples](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/Server-Side-Examples.md) | Streaming, authenticated fetch, signed URLs |
 | 📝 [Changelog](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/CHANGELOG.md) | What changed, and behavior notes when upgrading |
 
 The component exposes **30+ inputs**, **24+ events**, and **19+ Promise-returning methods**.
-The [API reference](https://angular-pdf-viewer-docs.vercel.app/docs/api/component-inputs) is the
+The [API reference](https://angularpdf.com/docs/api/component-inputs) is the
 complete, typed list.
 
 ## 🔌 Loading documents
@@ -185,7 +208,7 @@ attach credentials and track progress:
 
 For large files, linearize ("fast web view") and serve with HTTP range support so the first pages
 render before the whole document downloads. Details in the
-[loading guide](https://angular-pdf-viewer-docs.vercel.app/docs/features/loading-documents).
+[loading guide](https://angularpdf.com/docs/features/loading-documents).
 
 ## 🛡️ Security
 
@@ -209,6 +232,12 @@ test.bat          # build the lib, link it, and serve the demo on http://localho
 See [CONTRIBUTING.md](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/CONTRIBUTING.md) for the full setup, and look for
 [`good first issue`](https://github.com/intbot/ng2-pdfjs-viewer/labels/good%20first%20issue) to get started.
 
+## 🏗️ Showcase
+
+Shipped something with ng2-pdfjs-viewer? [Add it to the showcase](https://angularpdf.com/showcase) — submitted projects are listed next to other production apps using the viewer.
+
+Using it somewhere that won't show up in public code — an internal tool, a hospital system, a government portal? I'd like to hear about it: email **codehippie1@gmail.com** with a line about what you're building. Teams in healthcare, finance, education, and public-sector software already have. (Bugs and feature requests are best filed as [an issue](https://github.com/intbot/ng2-pdfjs-viewer/issues).)
+
 ## 📄 License
 
 [Apache-2.0 (Commons Clause)](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/LICENSE). Free to use, modify, and self-host; the Commons
@@ -223,6 +252,6 @@ years by a community of contributors and 8.3+ million downloads' worth of real-w
 
 <div align="center">
 
-[Documentation](https://angular-pdf-viewer-docs.vercel.app/) · [Live demo](https://angular-pdf-viewer-demo.vercel.app/) · [npm](https://www.npmjs.com/package/ng2-pdfjs-viewer) · [Issues](https://github.com/intbot/ng2-pdfjs-viewer/issues)
+[Documentation](https://angularpdf.com/) · [Live demo](https://demo.angularpdf.com/) · [npm](https://www.npmjs.com/package/ng2-pdfjs-viewer) · [Issues](https://github.com/intbot/ng2-pdfjs-viewer/issues)
 
 </div>

package/fesm2022/ng2-pdfjs-viewer-ai.mjs

@@ -40,7 +40,7 @@ class PdfAiAssistant {
      * of PdfJsViewerComponent.getDocumentText(); `history` carries prior turns
      * for multi-turn chat.
      */
-    async ask(question, documentText, history = [], signal) {
+    async ask(question, documentText, history = [], signal, onToken) {
         const context = this.buildContext(documentText);
         const messages = [
             {
@@ -53,14 +53,20 @@ class PdfAiAssistant {
             ...history,
             { role: "user", content: question },
         ];
-        return this.complete(messages, signal);
+        return this.complete(messages, signal, onToken);
     }
     /** One-shot document summary. */
     async summarize(documentText) {
         return this.ask("Summarize this document concisely. Lead with what it is, then the key points.", documentText);
     }
-    /** Raw chat-completions call for custom prompting. */
-    async complete(messages, signal) {
+    /**
+     * Raw chat-completions call for custom prompting. Pass `onToken` to stream the
+     * answer token-by-token (the callback receives the running full text and the
+     * latest delta); the Promise still resolves to the complete text. Streaming is
+     * requested only when `onToken` is given and `config.stream !== false`, and it
+     * falls back to a single JSON response if the endpoint doesn't stream.
+     */
+    async complete(messages, signal, onToken) {
         const headers = {
             "Content-Type": "application/json",
             ...(this.config.headers ?? {}),
@@ -68,6 +74,7 @@ class PdfAiAssistant {
         if (this.config.apiKey) {
             headers["Authorization"] = `Bearer ${this.config.apiKey}`;
         }
+        const wantStream = !!onToken && this.config.stream !== false;
         const response = await fetch(this.config.endpoint, {
             method: "POST",
             headers,
@@ -76,19 +83,81 @@ class PdfAiAssistant {
                 model: this.config.model,
                 temperature: this.config.temperature ?? 0.2,
                 messages,
+                ...(wantStream ? { stream: true } : {}),
             }),
         });
         if (!response.ok) {
             const body = await response.text().catch(() => "");
             throw new Error(`AI endpoint returned ${response.status}: ${body.slice(0, 300)}`);
         }
+        const contentType = response.headers?.get?.("Content-Type") ?? "";
+        if (wantStream && response.body && contentType.includes("text/event-stream")) {
+            return this.readStream(response, onToken);
+        }
+        // Non-streaming response, or the endpoint ignored `stream`: one JSON body.
         const json = await response.json();
         const content = json?.choices?.[0]?.message?.content;
         if (typeof content !== "string") {
             throw new Error("AI endpoint returned an unexpected response shape");
         }
+        // Emit once so callers wired for streaming still receive their update.
+        if (onToken)
+            onToken(content, content);
         return content;
     }
+    /**
+     * Read an OpenAI-style Server-Sent Events stream, accumulating
+     * choices[0].delta.content and emitting each delta through onToken. Returns the
+     * full concatenated text. Tolerates chunk boundaries that split SSE lines, and
+     * skips frames it can't parse (keep-alive comments, non-`data:` lines) rather
+     * than failing the whole stream.
+     */
+    async readStream(response, onToken) {
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        let full = "";
+        const handleLine = (raw) => {
+            const line = raw.trim();
+            if (!line.startsWith("data:"))
+                return false;
+            const data = line.slice(5).trim();
+            if (data === "[DONE]")
+                return true;
+            try {
+                const delta = JSON.parse(data)?.choices?.[0]?.delta?.content;
+                if (typeof delta === "string" && delta) {
+                    full += delta;
+                    onToken(full, delta);
+                }
+            }
+            catch {
+                // Ignore an unparseable frame rather than aborting the stream.
+            }
+            return false;
+        };
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                let nl;
+                while ((nl = buffer.indexOf("\n")) !== -1) {
+                    const line = buffer.slice(0, nl);
+                    buffer = buffer.slice(nl + 1);
+                    if (handleLine(line))
+                        return full; // [DONE]
+                }
+            }
+            if (buffer.trim())
+                handleLine(buffer); // trailing line without a newline
+        }
+        finally {
+            reader.releaseLock();
+        }
+        return full;
+    }
     buildContext(documentText) {
         const max = this.config.maxContextChars ?? 100_000;
         let out = "";

package/fesm2022/ng2-pdfjs-viewer-signals.mjs

@@ -0,0 +1,74 @@
+import { computed } from '@angular/core';
+import { toSignal } from '@angular/core/rxjs-interop';
+
+// Secondary entry point: ng2-pdfjs-viewer/signals
+//
+// Read-only Angular signals projected from the viewer's @Output() events, for
+// zoneless and OnPush apps that prefer reading state from signals over wiring up
+// a handful of (event)="..." bindings and EventEmitter subscriptions.
+//
+// It reads the same outputs the component already emits - it adds no new viewer
+// behaviour and sends nothing anywhere. Each signal holds the latest value from
+// its source output and starts as `undefined` until that output first fires
+// (`loaded`/`totalPages` are derived from page initialization).
+//
+// Requires Angular 16+ (signals + `@angular/core/rxjs-interop`). The base package
+// keeps its `>=10` peer range; only this entry point needs 16+, so import it from
+// the subpath and apps on older Angular never load it:
+//
+//   import { pdfViewerSignals } from "ng2-pdfjs-viewer/signals";
+//
+// A @ViewChild viewer is only populated in ngAfterViewInit, which is NOT an
+// injection context, so pass an Injector captured earlier:
+//
+//   @ViewChild('viewer') viewer!: PdfJsViewerComponent;
+//   private injector = inject(Injector);
+//   signals!: PdfViewerSignals;
+//
+//   ngAfterViewInit() {
+//     this.signals = pdfViewerSignals(this.viewer, { injector: this.injector });
+//   }
+//   // template: {{ signals.page() }} / {{ signals.totalPages() }} / {{ signals.loaded() }}
+//
+// Called from a constructor or field initializer (where an injection context
+// exists), the `injector` option can be omitted. Subscriptions are torn down with
+// the injector's DestroyRef - i.e. when the host component is destroyed.
+/**
+ * Project the viewer's outputs into read-only signals. See the file header for
+ * usage and the injection-context rules. The returned signals are live: each
+ * updates when its source output next fires.
+ */
+function pdfViewerSignals(viewer, options = {}) {
+    const { injector } = options;
+    const latest = (source) => toSignal(source, { initialValue: undefined, injector });
+    const pages = latest(viewer.onPagesInit);
+    return {
+        page: latest(viewer.onPageChange),
+        scale: latest(viewer.onScaleChange),
+        totalPages: computed(() => pages()?.pagesCount),
+        loaded: computed(() => pages() !== undefined),
+        error: latest(viewer.onDocumentError),
+        rotation: latest(viewer.onRotationChange),
+        findMatches: latest(viewer.onUpdateFindMatchesCount),
+        readAloud: latest(viewer.onReadAloudStateChange),
+        annotationEditor: latest(viewer.onAnnotationEditorStateChange),
+        annotationEditorMode: latest(viewer.annotationEditorChange),
+        sidebar: latest(viewer.onSidebarViewChanged),
+        metadata: latest(viewer.onMetadataLoaded),
+        outline: latest(viewer.onOutlineLoaded),
+        formData: latest(viewer.formDataChange),
+        presentationMode: latest(viewer.onPresentationModeChanged),
+        zoom: latest(viewer.zoomChange),
+        cursor: latest(viewer.cursorChange),
+        scroll: latest(viewer.scrollChange),
+        spread: latest(viewer.spreadChange),
+        pageMode: latest(viewer.pageModeChange),
+    };
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { pdfViewerSignals };
+//# sourceMappingURL=ng2-pdfjs-viewer-signals.mjs.map

package/fesm2022/ng2-pdfjs-viewer.mjs

@@ -1702,6 +1702,18 @@ class PdfJsViewerComponent {
                         if (this.diagnosticLogs)
                             console.debug("PdfJsViewer: The document has now been loaded!");
                         this.onDocumentLoad.emit();
+                        // Project onPagesInit here. PDF.js fires the real 'pagesinit' once,
+                        // BEFORE this handler map finishes registering (it lands between
+                        // 'pagesinit' and 'scalechanging'), and the postMessage wrapper's own
+                        // pagesInit relay is wired on 'documentloaded' too late for the
+                        // one-shot - so onPagesInit never fired and the signals entry point's
+                        // loaded()/totalPages() stayed empty. 'documentloaded' is reliably
+                        // caught (it drives onDocumentLoad) and pagesCount is set by now.
+                        const app = this.PDFViewerApplication;
+                        const pagesCount = app?.pagesCount ?? app?.pdfDocument?.numPages;
+                        if (typeof pagesCount === "number" && pagesCount > 0) {
+                            this.onPagesInit.emit({ pagesCount });
+                        }
                         // Queue auto-actions with the property values current at THIS load
                         this.queueAutoActionsForDocumentLoad();
                         // Execute all queued auto-actions
@@ -2100,6 +2112,9 @@ class PdfJsViewerComponent {
         this.aiAbort = new AbortController();
         const signal = this.aiAbort.signal;
         this.aiMessages.push({ role: "user", content: q, parts: [{ text: q }] });
+        // Placeholder assistant turn we stream tokens into as they arrive.
+        const assistant = { role: "assistant", content: "", parts: [] };
+        this.aiMessages.push(assistant);
         this.cdr.markForCheck();
         try {
             if (!this.aiClient || this.aiClientConfig !== config) {
@@ -2110,29 +2125,28 @@ class PdfJsViewerComponent {
                 this.aiDocText = await this.getDocumentText();
             }
             const history = this.aiMessages
-                .slice(0, -1)
+                .slice(0, -2)
                 .filter((m) => !m.error)
                 .map((m) => ({ role: m.role, content: m.content }));
-            const answer = await this.aiClient.ask(q, this.aiDocText, history, signal);
+            const answer = await this.aiClient.ask(q, this.aiDocText, history, signal, (full) => {
+                if (generation !== this.aiGeneration) {
+                    return; // stale stream - ignore late tokens
+                }
+                assistant.content = full;
+                assistant.parts = this.parseAiCitations(full);
+                this.cdr.markForCheck();
+            });
             if (generation !== this.aiGeneration) {
                 return; // document changed mid-flight - stale answer
             }
-            this.aiMessages.push({
-                role: "assistant",
-                content: answer,
-                parts: this.parseAiCitations(answer),
-            });
+            assistant.content = answer;
+            assistant.parts = this.parseAiCitations(answer);
         }
         catch (e) {
             if (generation !== this.aiGeneration) {
                 return; // aborted by invalidation - already cleaned up
             }
-            this.aiMessages.push({
-                role: "assistant",
-                content: "",
-                error: e?.message || "AI request failed",
-                parts: [],
-            });
+            assistant.error = e?.message || "AI request failed";
         }
         finally {
             if (generation === this.aiGeneration) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ng2-pdfjs-viewer",
-  "version": "26.1.0",
+  "version": "26.2.0",
   "description": "The most comprehensive Angular PDF viewer, powered by Mozilla PDF.js 6 — view, annotate, sign, fill forms, search, and read aloud from one component. 8.3M+ downloads, mobile-first, production-ready.",
   "author": {
     "name": "Aneesh Goapalakrishnan",
@@ -20,34 +20,37 @@
     "@angular/core": ">=10.0.0"
   },
   "$schema": "./node_modules/ng-packagr/package.schema.json",
-  "homepage": "https://angular-pdf-viewer-docs.vercel.app/",
+  "homepage": "https://angularpdf.com/",
   "bugs": {
     "url": "https://github.com/intbot/ng2-pdfjs-viewer/issues"
   },
   "keywords": [
+    "angular pdf viewer",
     "angular",
     "angular-pdf-viewer",
+    "ng2-pdfjs-viewer",
     "pdf-viewer",
     "pdf-reader",
     "PDF",
-    "PDF Viewer",
     "pdfjs",
-    "viewerjs",
-    "ng2",
+    "pdf.js",
     "angular-component",
     "angular-pdf",
     "ng2-pdf",
-    "angular 2 - 22",
     "angular 22",
     "angular-library",
     "typescript",
     "javascript",
     "pdf-rendering",
     "pdf-annotations",
+    "pdf-forms",
+    "pdf-signature",
+    "esign",
+    "pdf-search",
     "pdf-zoom",
     "pdf-printing",
-    "responsive-ui",
-    "custom PDF Viewer",
+    "text-to-speech",
+    "mobile-first",
     "accessibility",
     "open-source"
   ],
@@ -64,6 +67,10 @@
     "./ai": {
       "types": "./types/ng2-pdfjs-viewer-ai.d.ts",
       "default": "./fesm2022/ng2-pdfjs-viewer-ai.mjs"
+    },
+    "./signals": {
+      "types": "./types/ng2-pdfjs-viewer-signals.d.ts",
+      "default": "./fesm2022/ng2-pdfjs-viewer-signals.mjs"
     }
   },
   "sideEffects": false,

package/types/ng2-pdfjs-viewer-ai.d.ts

@@ -9,6 +9,7 @@ interface PdfAiAssistantConfig {
     headers?: Record<string, string>;
     maxContextChars?: number;
     temperature?: number;
+    stream?: boolean;
 }
 interface PdfAiMessage {
     role: "system" | "user" | "assistant";
@@ -35,11 +36,25 @@ declare class PdfAiAssistant {
      * of PdfJsViewerComponent.getDocumentText(); `history` carries prior turns
      * for multi-turn chat.
      */
-    ask(question: string, documentText: PdfPageText[], history?: PdfAiMessage[], signal?: AbortSignal): Promise<string>;
+    ask(question: string, documentText: PdfPageText[], history?: PdfAiMessage[], signal?: AbortSignal, onToken?: (full: string, delta: string) => void): Promise<string>;
     /** One-shot document summary. */
     summarize(documentText: PdfPageText[]): Promise<string>;
-    /** Raw chat-completions call for custom prompting. */
-    complete(messages: PdfAiMessage[], signal?: AbortSignal): Promise<string>;
+    /**
+     * Raw chat-completions call for custom prompting. Pass `onToken` to stream the
+     * answer token-by-token (the callback receives the running full text and the
+     * latest delta); the Promise still resolves to the complete text. Streaming is
+     * requested only when `onToken` is given and `config.stream !== false`, and it
+     * falls back to a single JSON response if the endpoint doesn't stream.
+     */
+    complete(messages: PdfAiMessage[], signal?: AbortSignal, onToken?: (full: string, delta: string) => void): Promise<string>;
+    /**
+     * Read an OpenAI-style Server-Sent Events stream, accumulating
+     * choices[0].delta.content and emitting each delta through onToken. Returns the
+     * full concatenated text. Tolerates chunk boundaries that split SSE lines, and
+     * skips frames it can't parse (keep-alive comments, non-`data:` lines) rather
+     * than failing the whole stream.
+     */
+    private readStream;
     private buildContext;
 }
 

package/types/ng2-pdfjs-viewer-signals.d.ts

@@ -0,0 +1,77 @@
+import { EventEmitter, Signal, Injector } from '@angular/core';
+import { ChangedRotation, PagesInfo, DocumentError, FindMatchesCount, ReadAloudState, AnnotationEditorState, AnnotationEditorMode, SidebarViewChange, DocumentMetadata, DocumentOutline, FormDataMap, PresentationMode } from 'ng2-pdfjs-viewer';
+
+interface PdfViewerSignalSource {
+    onPageChange: EventEmitter<number>;
+    onScaleChange: EventEmitter<number>;
+    onRotationChange: EventEmitter<ChangedRotation>;
+    onPagesInit: EventEmitter<PagesInfo>;
+    onDocumentError: EventEmitter<DocumentError>;
+    onUpdateFindMatchesCount: EventEmitter<FindMatchesCount>;
+    onReadAloudStateChange: EventEmitter<ReadAloudState>;
+    onAnnotationEditorStateChange: EventEmitter<AnnotationEditorState>;
+    annotationEditorChange: EventEmitter<AnnotationEditorMode>;
+    onSidebarViewChanged: EventEmitter<SidebarViewChange>;
+    onMetadataLoaded: EventEmitter<DocumentMetadata>;
+    onOutlineLoaded: EventEmitter<DocumentOutline>;
+    formDataChange: EventEmitter<FormDataMap>;
+    onPresentationModeChanged: EventEmitter<PresentationMode>;
+    zoomChange: EventEmitter<string>;
+    cursorChange: EventEmitter<string>;
+    scrollChange: EventEmitter<string>;
+    spreadChange: EventEmitter<string>;
+    pageModeChange: EventEmitter<string>;
+}
+interface PdfViewerSignals {
+    /** Current 1-based page number; undefined until the first page change. */
+    page: Signal<number | undefined>;
+    /** Current zoom scale factor (1 = 100%); undefined until the first scale change. */
+    scale: Signal<number | undefined>;
+    /** Total page count, available once the document's pages initialize. */
+    totalPages: Signal<number | undefined>;
+    /** True once the document's pages have initialized. */
+    loaded: Signal<boolean>;
+    /** Last document-load error, or undefined if none. */
+    error: Signal<DocumentError | undefined>;
+    /** Page rotation state ({ rotation, page }). */
+    rotation: Signal<ChangedRotation | undefined>;
+    /** Live find/search match counts ({ current, total }). */
+    findMatches: Signal<FindMatchesCount | undefined>;
+    /** Read-aloud progress ({ status, page, sentence? }). */
+    readAloud: Signal<ReadAloudState | undefined>;
+    /** Annotation editor undo/empty/selection state. */
+    annotationEditor: Signal<AnnotationEditorState | undefined>;
+    /** Active annotation editor tool (highlight / ink / freetext / ...). */
+    annotationEditorMode: Signal<AnnotationEditorMode | undefined>;
+    /** Current sidebar panel ({ view }). */
+    sidebar: Signal<SidebarViewChange | undefined>;
+    /** Document metadata (title / author / ...). */
+    metadata: Signal<DocumentMetadata | undefined>;
+    /** Document outline / bookmarks ({ items?, hasOutline }). */
+    outline: Signal<DocumentOutline | undefined>;
+    /** Current AcroForm field values. */
+    formData: Signal<FormDataMap | undefined>;
+    /** Presentation (fullscreen) mode ({ active }). */
+    presentationMode: Signal<PresentationMode | undefined>;
+    /** Zoom mode string (e.g. 'auto', 'page-fit', '125'). */
+    zoom: Signal<string | undefined>;
+    /** Cursor tool ('select' | 'hand'). */
+    cursor: Signal<string | undefined>;
+    /** Scroll mode ('vertical' | 'horizontal' | 'wrapped' | 'page'). */
+    scroll: Signal<string | undefined>;
+    /** Spread mode ('none' | 'odd' | 'even'). */
+    spread: Signal<string | undefined>;
+    /** Page (view) mode. */
+    pageMode: Signal<string | undefined>;
+}
+/**
+ * Project the viewer's outputs into read-only signals. See the file header for
+ * usage and the injection-context rules. The returned signals are live: each
+ * updates when its source output next fires.
+ */
+declare function pdfViewerSignals(viewer: PdfViewerSignalSource, options?: {
+    injector?: Injector;
+}): PdfViewerSignals;
+
+export { pdfViewerSignals };
+export type { PdfViewerSignalSource, PdfViewerSignals };