ng2-pdfjs-viewer 26.1.1 → 26.3.0

package/LICENSE

@@ -1,33 +1,3 @@
-# Apache License, Version 2.0 with Commons Clause License Condition v 1.0
-
-===============================================================================
-
-COMMONS CLAUSE LICENSE CONDITION
-
-The Software is provided to you by the Licensor under the License, as defined
-below, subject to the following condition.
-
-Without limiting other conditions in the License, the grant of rights under
-the License will not include, and the License does not grant to you, the right
-to Sell the Software. For purposes of the foregoing, "Sell" means practicing
-any or all of the rights granted to you under the License to provide to third
-parties, for a fee or other consideration (including without limitation fees
-for hosting or consulting/ support services related to the Software), a product
-or service whose value derives, entirely or substantially, from the Software.
-Any license notice or attribution required by the License must also include
-this Commons Clause License Condition notice.
-
-Software: ng2-pdfjs-viewer
-Copyright (c) 2018-2025 Aneesh Goapalakrishnan
-Licensor: Aneesh Goapalakrishnan <codehippie1@gmail.com>
-
-This software is dual-licensed under the Apache License 2.0 and the Commons
-Clause License Condition. The Commons Clause modifies the Apache License 2.0
-to prevent commercial competitors from selling products or services that are
-substantially derived from this software.
-
-===============================================================================
-
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
@@ -216,7 +186,7 @@ substantially derived from this software.
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2018-2025 Aneesh Goapalakrishnan
+   Copyright 2018-2026 Aneesh Goapalakrishnan
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -14,10 +14,14 @@
 [![CodeQL](https://github.com/intbot/ng2-pdfjs-viewer/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/intbot/ng2-pdfjs-viewer/security/code-scanning)
 [![Angular](https://img.shields.io/badge/Angular-%3E%3D10-red?style=flat-square&logo=angular)](https://angular.dev)
 [![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)
+[![license](https://img.shields.io/badge/license-Apache--2.0-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://demo.angularpdf.com/) · [**Documentation**](https://angularpdf.com/) · [**API reference**](https://angularpdf.com/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
 
 | | |
@@ -209,16 +232,15 @@ 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.
 
-## ⭐ Star history
+## 🏗️ 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.
 
-<a href="https://star-history.com/#intbot/ng2-pdfjs-viewer&Date">
-  <img src="https://api.star-history.com/svg?repos=intbot/ng2-pdfjs-viewer&type=Date" alt="Star history chart for ng2-pdfjs-viewer" width="640" />
-</a>
+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
-Clause restricts selling the software itself as a hosted/commercial product.
+[Apache-2.0](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/LICENSE). Use, modify, self-host, or ship it inside a commercial product — the Apache 2.0 grant is perpetual, irrevocable, and carries an express patent license.
 
 ## 🙏 Acknowledgments
 

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

@@ -150,6 +150,32 @@ class ActionQueueManager {
 }
 
 // Property normalization between component inputs and PDF.js viewer values
+// Mode/name lists shared by the to- and from-viewer transforms. PDF.js encodes
+// scroll and spread modes as integer enums, so for those the array index is the
+// enum value and the order here doubles as the numeric->name map (keep it in
+// sync with PDF.js). Declaring each list once keeps the input whitelist and the
+// index map from drifting apart, and hoisting them to module scope avoids
+// re-allocating the array on every viewer state-sync event.
+const ZOOM_NAMES = [
+    "auto",
+    "page-fit",
+    "page-width",
+    "page-actual",
+];
+const CURSOR_MODES = ["select", "hand", "zoom"];
+const SCROLL_MODES = [
+    "vertical",
+    "horizontal",
+    "wrapped",
+    "page",
+];
+const SPREAD_MODES = ["none", "odd", "even"];
+const PAGE_MODES = [
+    "none",
+    "thumbs",
+    "bookmarks",
+    "attachments",
+];
 // Lowercase + whitelist with fallback
 const pick = (value, allowed, fallback) => {
     const v = value ? value.toLowerCase() : "";
@@ -162,9 +188,7 @@ class PropertyTransformers {
                 return "auto";
             const v = zoom.toLowerCase();
             // Named zooms normalize to lowercase; numeric strings pass through
-            return ["auto", "page-fit", "page-width", "page-actual"].includes(v)
-                ? v
-                : zoom;
+            return ZOOM_NAMES.includes(v) ? v : zoom;
         },
         fromViewer: (viewerZoom) => {
             if (typeof viewerZoom === "string")
@@ -180,31 +204,29 @@ class PropertyTransformers {
         fromViewer: (viewerRotation) => typeof viewerRotation === "number" ? viewerRotation : 0,
     };
     static transformCursor = {
-        toViewer: (cursor) => pick(cursor, ["select", "hand", "zoom"], "select"),
+        toViewer: (cursor) => pick(cursor, CURSOR_MODES, "select"),
         fromViewer: (viewerCursor) => typeof viewerCursor === "string" ? viewerCursor : "select",
     };
     static transformScroll = {
-        toViewer: (scroll) => pick(scroll, ["vertical", "horizontal", "wrapped", "page"], "vertical"),
+        toViewer: (scroll) => pick(scroll, SCROLL_MODES, "vertical"),
         fromViewer: (viewerScroll) => {
-            const modes = ["vertical", "horizontal", "wrapped", "page"];
             if (typeof viewerScroll === "number") {
-                return modes[viewerScroll] || "vertical";
+                return SCROLL_MODES[viewerScroll] || "vertical";
             }
             return typeof viewerScroll === "string" ? viewerScroll : "vertical";
         },
     };
     static transformSpread = {
-        toViewer: (spread) => pick(spread, ["none", "odd", "even"], "none"),
+        toViewer: (spread) => pick(spread, SPREAD_MODES, "none"),
         fromViewer: (viewerSpread) => {
-            const modes = ["none", "odd", "even"];
             if (typeof viewerSpread === "number") {
-                return modes[viewerSpread] || "none";
+                return SPREAD_MODES[viewerSpread] || "none";
             }
             return typeof viewerSpread === "string" ? viewerSpread : "none";
         },
     };
     static transformPageMode = {
-        toViewer: (pageMode) => pick(pageMode, ["none", "thumbs", "bookmarks", "attachments"], "none"),
+        toViewer: (pageMode) => pick(pageMode, PAGE_MODES, "none"),
         fromViewer: (viewerPageMode) => typeof viewerPageMode === "string" ? viewerPageMode : "none",
     };
 }
@@ -1702,6 +1724,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
@@ -1980,11 +2014,15 @@ class PdfJsViewerComponent {
     // Embedded views for pageOverlayTpl, keyed by page number. Views are
     // attached to ApplicationRef so bindings inside stay live.
     overlayViews = new Map();
-    mountPageOverlay(pageNumber) {
+    mountPageOverlay(pageNumber, knownPageEl) {
         if (!this.pageOverlayTpl || this.externalWindow)
             return;
         const doc = this.iframe?.nativeElement?.contentDocument;
-        const pageEl = doc?.querySelector(`.pdfViewer .page[data-page-number="${pageNumber}"]`);
+        // Callers iterating already-rendered pages pass the element they hold, so
+        // we skip re-finding it by selector (saves one DOM query per page on large
+        // documents); the per-page render path passes nothing and looks it up.
+        const pageEl = knownPageEl ??
+            doc?.querySelector(`.pdfViewer .page[data-page-number="${pageNumber}"]`);
         if (!pageEl || pageEl.querySelector(":scope > .ng2-page-overlay")) {
             return;
         }
@@ -2026,7 +2064,7 @@ class PdfJsViewerComponent {
             .forEach((el) => {
             const pageNumber = Number(el.getAttribute("data-page-number"));
             if (pageNumber > 0) {
-                this.mountPageOverlay(pageNumber);
+                this.mountPageOverlay(pageNumber, el);
             }
         });
     }
@@ -2100,6 +2138,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 +2151,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.1",
+  "version": "26.3.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",
@@ -54,7 +54,7 @@
     "accessibility",
     "open-source"
   ],
-  "license": "Apache-2.0 (Commons Clause)",
+  "license": "Apache-2.0",
   "readme": "README.md",
   "exports": {
     "./package.json": {
@@ -67,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 };