ng2-pdfjs-viewer 26.0.0 → 26.0.2

package/README.md

@@ -1,18 +1,19 @@
 <div align="center">
 
-<img src="https://raw.githubusercontent.com/intbot/ng2-pdfjs-viewer/master/lib/logo.svg" alt="ng2-pdfjs-viewer" width="120" height="140" />
+<img src="https://raw.githubusercontent.com/intbot/ng2-pdfjs-viewer/master/lib/pdf-viewer-banner.png" alt="#1 Angular PDF Viewer — ng2-pdfjs-viewer: AI-enabled, feature-rich and comprehensive. 8.3M+ downloads, 0 runtime dependencies, 8 years (since 2018), Angular 10–22." width="880" />
 
 # ng2-pdfjs-viewer
 
 **A complete PDF experience in one Angular component — view, annotate, sign, fill forms, search, and read aloud, powered by Mozilla PDF.js.**
 
-[![npm](https://img.shields.io/npm/v/ng2-pdfjs-viewer?logo=npm&color=blue)](https://www.npmjs.com/package/ng2-pdfjs-viewer)
-[![downloads / month](https://img.shields.io/npm/dm/ng2-pdfjs-viewer?color=orange)](https://www.npmjs.com/package/ng2-pdfjs-viewer)
-[![total downloads](https://img.shields.io/badge/total-7M%2B-brightgreen?logo=npm)](https://www.npmjs.com/package/ng2-pdfjs-viewer)
-[![PDF.js](https://img.shields.io/badge/PDF.js-6.0.227-green?logo=mozilla)](https://github.com/mozilla/pdf.js)
-[![Angular](https://img.shields.io/badge/Angular-%3E%3D10-red?logo=angular)](https://angular.dev)
-[![license](https://img.shields.io/badge/license-Apache--2.0%20%2B%20Commons%20Clause-blue.svg)](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/LICENSE)
-[![stars](https://img.shields.io/github/stars/intbot/ng2-pdfjs-viewer?logo=github)](https://github.com/intbot/ng2-pdfjs-viewer)
+[![npm version](https://img.shields.io/npm/v/ng2-pdfjs-viewer?style=flat-square&logo=npm&color=2563eb)](https://www.npmjs.com/package/ng2-pdfjs-viewer)
+[![downloads / month](https://img.shields.io/npm/dm/ng2-pdfjs-viewer?style=flat-square&color=f97316)](https://www.npmjs.com/package/ng2-pdfjs-viewer)
+[![total downloads](https://img.shields.io/badge/total%20downloads-8.3M%2B-22c55e?style=flat-square&logo=npm)](https://www.npmjs.com/package/ng2-pdfjs-viewer)
+[![runtime dependencies](https://img.shields.io/badge/runtime%20deps-0-success?style=flat-square)](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/BILL-OF-MATERIALS.md)
+[![PDF.js](https://img.shields.io/badge/PDF.js-6.0.227-green?style=flat-square&logo=mozilla)](https://github.com/mozilla/pdf.js)
+[![Angular](https://img.shields.io/badge/Angular-%3E%3D10-red?style=flat-square&logo=angular)](https://angular.dev)
+[![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)
 [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/intbot/ng2-pdfjs-viewer/badge)](https://scorecard.dev/viewer/?uri=github.com/intbot/ng2-pdfjs-viewer)
 
 [**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)
@@ -22,11 +23,11 @@
 ---
 
 Drop a production PDF viewer into any Angular app with a single tag. ng2-pdfjs-viewer wraps
-Mozilla **PDF.js 6** in one declarative `<ng2-pdfjs-viewer>` component: rendering, navigation,
+**PDF.js 6** in one declarative `<ng2-pdfjs-viewer>` component: rendering, navigation,
 search, printing, theming, annotations, e-signatures, AcroForms, read-aloud, and a bring-your-own
 AI assistant — all driven by typed `@Input()`s and `@Output()` events, no iframe plumbing of your own.
 
-Shipping since **2018**, **7M+ downloads**, mobile-first, and built & verified on **Angular 22**
+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.
 
 ```bash
@@ -43,7 +44,7 @@ That's the whole integration. [Wire up the assets](#-quick-start) and you have a
 
 | | |
 |---|---|
-| 📄 **View anything** | Crisp PDF.js 6 rendering, zoom, navigation, thumbnails, outline, printing — embedded, in a new tab, or a popout window. |
+| 📄 **View anything** | Crisp, high-fidelity rendering, zoom, navigation, thumbnails, outline, printing — embedded, in a new tab, or a popout window. |
 | ✍️ **Annotate & sign** | Highlight, draw, free-text, and stamp editors; opt-in draw/type/upload **signature** editor and threaded comments. Export and restore edits for a full server round-trip. |
 | 🧾 **Fill forms** | Two-way AcroForm binding — read and write field values from your component, save the filled document as a blob. |
 | 🔎 **Search in code** | Programmatic `search()` with totals, per-page counts, and next/previous navigation — build your own find UI. |
@@ -197,13 +198,13 @@ See [CONTRIBUTING.md](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/CON
 
 ## 📄 License
 
-[Apache-2.0 with the Commons Clause](https://github.com/intbot/ng2-pdfjs-viewer/blob/master/LICENSE). Free to use, modify, and self-host; the Commons
+[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.
 
 ## 🙏 Acknowledgments
 
 Built on the excellent [Mozilla PDF.js](https://github.com/mozilla/pdf.js), and shaped over the
-years by a community of contributors and 7M+ downloads' worth of real-world use.
+years by a community of contributors and 8.3+ million downloads' worth of real-world use.
 
 ---
 

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

@@ -13,6 +13,12 @@
 // service, a plain script). The full component re-exports these symbols from
 // the package root for backwards compatibility.
 //
+// SECURITY: this sends a fetch from wherever you construct it — in a browser
+// app, that is the user's browser. Don't point `endpoint` directly at a hosted
+// cloud LLM (OpenAI, Azure, …): the API key would be exposed to the client, and
+// most providers block direct browser calls via CORS. Use a local model
+// (Ollama, LM Studio) or your own backend proxy. See the AI Assistant guide.
+//
 // Usage:
 //   import { PdfAiAssistant } from "ng2-pdfjs-viewer/ai";
 //   const text = await viewer.getDocumentText();

package/fesm2022/ng2-pdfjs-viewer.mjs

@@ -1687,6 +1687,7 @@ class PdfJsViewerComponent {
                 const eventBus = this.PDFViewerApplication.eventBus;
                 const handlers = {
                     documentloaded: () => {
+                        this.documentLoaded = true;
                         if (this.diagnosticLogs)
                             console.debug("PdfJsViewer: The document has now been loaded!");
                         this.onDocumentLoad.emit();
@@ -2023,12 +2024,39 @@ class PdfJsViewerComponent {
      * PDF.js text layer. The raw material for BYO-AI chat/summarize flows.
      */
     async getDocumentText(from, to) {
+        // The document may not have finished loading the instant this is called
+        // (e.g. an AI 'ask' fired immediately after the viewer appears). Wait for
+        // 'documentloaded' so we don't extract empty text; fall back on timeout.
+        if (!this.documentLoaded) {
+            await this.waitForDocumentLoad(15000);
+        }
         const result = await this.dispatchAction("get-document-text", { from, to }, "user-interaction");
         if (!result.success) {
             throw new Error(result.error || "getDocumentText failed");
         }
         return result.data ?? [];
     }
+    /**
+     * Resolve once the current document has loaded, or after timeoutMs (in which
+     * case callers proceed with whatever the viewer can provide). Never rejects.
+     */
+    waitForDocumentLoad(timeoutMs) {
+        if (this.documentLoaded)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                sub.unsubscribe();
+                clearTimeout(timer);
+                resolve();
+            };
+            const sub = this.onDocumentLoad.subscribe(() => finish());
+            const timer = setTimeout(finish, timeoutMs);
+        });
+    }
     /**
      * Read the document aloud from the current (or given) page using the
      * browser's speech synthesis. Progress arrives on onReadAloudStateChange.
@@ -2178,6 +2206,8 @@ class PdfJsViewerComponent {
         // A new load lifts the failed-document latch (the documentInit relay
         // also clears it, but that is enablement-gated and can race fast loads)
         this.documentLoadFailed = false;
+        // Text isn't extractable until the new document finishes loading.
+        this.documentLoaded = false;
         this.cdr.markForCheck();
         if (!this.setupExternalWindow()) {
             return; // popup blocked - nothing to navigate
@@ -2389,6 +2419,9 @@ class PdfJsViewerComponent {
     // actions dispatched against a failed load settle immediately instead of
     // queueing forever.
     documentLoadFailed = false;
+    // True once the current document fires 'documentloaded'. getDocumentText()
+    // awaits this so an AI 'ask' fired before render doesn't extract empty text.
+    documentLoaded = false;
     // Universal Action Dispatcher - ALL actions go through readiness-based queuing
     dispatchAction(action, payload, source = "property-change", level) {
         if (this.externalWindow && !this.externalWindowWarned) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ng2-pdfjs-viewer",
-  "version": "26.0.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. 7M+ downloads, mobile-first, production-ready.",
+  "version": "26.0.2",
+  "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",
     "email": "codehippie1@gmail.com"
@@ -51,7 +51,7 @@
     "accessibility",
     "open-source"
   ],
-  "license": "Apache-2.0 + Commons Clause",
+  "license": "Apache-2.0 (Commons Clause)",
   "readme": "README.md",
   "exports": {
     "./package.json": {

package/pdfjs/web/ng2-customization.css

@@ -166,6 +166,12 @@ body #outerContainer.sidebar-right.viewsManagerOpen #loadingBar {
 /* Light theme defaults */
 .ng2-theme-light,
 .ng2-theme-light-active {
+  /* Pin the UA color-scheme so PDF.js's light-dark() colours (toolbar/menu
+     icons, form controls, scrollbars) resolve to the SELECTED theme instead of
+     the OS preference. Without this, when the app theme differs from the OS
+     theme the icons inherit :root's `color-scheme: light dark` and become
+     invisible (e.g. light icons on a light toolbar). */
+  color-scheme: light;
   --ng2-default-bg: #d4d4d7; /* PDF.js original grey background */
   --ng2-default-text: #000000;
   --ng2-default-toolbar: #f9f9f9;
@@ -175,6 +181,7 @@ body #outerContainer.sidebar-right.viewsManagerOpen #loadingBar {
 /* Dark theme defaults */
 .ng2-theme-dark,
 .ng2-theme-dark-active {
+  color-scheme: dark;
   --ng2-default-bg: #1e1e1e;
   --ng2-default-text: #ffffff;
   --ng2-default-toolbar: #333333;

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

@@ -554,6 +554,11 @@ declare class PdfJsViewerComponent implements OnInit, OnDestroy, OnChanges, Afte
      * PDF.js text layer. The raw material for BYO-AI chat/summarize flows.
      */
     getDocumentText(from?: number, to?: number): Promise<DocumentPageText[]>;
+    /**
+     * Resolve once the current document has loaded, or after timeoutMs (in which
+     * case callers proceed with whatever the viewer can provide). Never rejects.
+     */
+    private waitForDocumentLoad;
     /**
      * Read the document aloud from the current (or given) page using the
      * browser's speech synthesis. Progress arrives on onReadAloudStateChange.
@@ -606,6 +611,7 @@ declare class PdfJsViewerComponent implements OnInit, OnDestroy, OnChanges, Afte
     private navigateToViewer;
     private externalWindowWarned;
     private documentLoadFailed;
+    private documentLoaded;
     private dispatchAction;
     private getRequiredReadinessLevel;
     private hasRequiredReadiness;