@react-pdf-kit/viewer 2.7.4-rc.0 → 2.7.4-rc.2

package/README.md

@@ -32,6 +32,10 @@
 - **Modern Browser Compatibility**: The React PDF Viewer components seamlessly across modern browsers, eliminating compatibility headaches.
 - **Active Development & Support**: With regular updates and a responsive support team, React PDF Kit evolves to meet developer needs.
 
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/8803229a-2f59-48d1-aecc-628ae759862f" alt="React PDF Kit demo">
+</p>
+
 # 📜 Background
 
 As developers ourselves, we faced many issues such as browser incompatibility and customizability while trying to render a PDF document or working with PDF libraries. Having faced issues using PDF libraries, we want the solution to be flexible for React.js developers and teams. More importantly, the technical document must be easy to use!
@@ -78,23 +82,13 @@ As newer PDF.js versions rely on more modern browser APIs, minimum supported bro
 
 React PDF Kit v2.0.0 defaults to PDF.js `5.4.530`.
 
-| Chrome | Firefox | Edge | Safari | Safari iOS | Chrome Android |
-| ------ | ------- | ---- | ------ | ---------- | -------------- |
-| 126+   | 126+    | 126+ | 18.4+  | 18.4+      | 126+           |
-
-<Aside>
-It's currently not recommended to use a PDF.js worker version beyond `5.4.530` because it will support fewer browser versions.
-</Aside>
-
-#### Using PDF.js 4.10.38
+| Configuration                                                                                                                                                                                     | Chrome | Firefox | Edge | Safari | Safari iOS | Chrome Android |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------- | ---- | ------ | ---------- | -------------- |
+| React PDF Kit v2                                                                                                                                                                                  | 126+   | 126+    | 126+ | 18.4+  | 18.4+      | 126+           |
+| [React PDF Kit v2 + Polyfills](https://www.react-pdf-kit.dev/docs/usage-guide/legacy-browser-support.html#polyfills-library?utm_source=github&utm_medium=referral)                                | 119+   | 121+    | 119+ | 18.3+  | 18.3+      | 119+           |
+| [React PDF Kit v2 + Polyfills + Legacy PDF.js Worker](https://www.react-pdf-kit.dev/docs/usage-guide/legacy-browser-support.html#override-the-pdfjs-worker?utm_source=github&utm_medium=referral) | 101+   | 101+    | 101+ | 16.5+  | 16.5+      | 101+           |
 
-If you need broader browser compatibility, you can continue using PDF.js `4.10.38`, which supports:
-
-| Chrome | Firefox | Edge | Safari | Safari iOS | Chrome Android |
-| ------ | ------- | ---- | ------ | ---------- | -------------- |
-| 119+   | 115+    | 115+ | 17.4+  | 17.4+      | 126+           |
-
-To change the version of PDF.js used, refer to [Dependency Override](https://docs.react-pdf-kit.dev/usage-guide/overriding-dependency?utm_source=github&utm_medium=referral) guide.
+To change the version of PDF.js used, refer to [Dependency Override](https://www.react-pdf-kit.dev/docs/usage-guide/overriding-dependency?utm_source=github&utm_medium=referral) guide.
 
 ## 2. Install the Package
 
@@ -133,25 +127,33 @@ yarn add @react-pdf-kit/viewer
 pnpm add @react-pdf-kit/viewer
 ```
 
-For more information on how to use different package managers, please visit our [installation guide](https://docs.react-pdf-kit.dev/introduction/getting-started/#installation?utm_source=github&utm_medium=referral).
+For more information on how to use different package managers, please visit our [installation guide](https://www.react-pdf-kit.dev/docs/introduction/getting-started/#installation?utm_source=github&utm_medium=referral).
 
 ## 3. Import and Use the Component
 
 The following structure demonstrates how to build a React PDF viewer by importing and assembling components. This modular approach gives you the flexibility to customize the viewer as needed.
 
 ```tsx
-<RPConfig>                {/* Configuration license and pdfjs-dist worker */}
-  <RPTheme>               {/* Theme customization (optional) */}
-    <RPProvider>          {/* Viewer context provider */}
-      <RPLayout toolbar>  {/* Provide the default toolbar structure */}
-        <RPPages />       {/* Render the actual PDF content */}
+<RPConfig>
+  {' '}
+  {/* Configuration license and pdfjs-dist worker */}
+  <RPTheme>
+    {' '}
+    {/* Theme customization (optional) */}
+    <RPProvider>
+      {' '}
+      {/* Viewer context provider */}
+      <RPLayout toolbar>
+        {' '}
+        {/* Provide the default toolbar structure */}
+        <RPPages /> {/* Render the actual PDF content */}
       </RPLayout>
     </RPProvider>
   </RPTheme>
 </RPConfig>
 ```
 
-_Remark: For more information on each component, please refer to [Component](https://docs.react-pdf-kit.dev/components/overview?utm_source=github&utm_medium=referral)._
+_Remark: For more information on each component, please refer to [Component](https://www.react-pdf-kit.dev/docs/components/overview?utm_source=github&utm_medium=referral)._
 
 ### Basic Usage
 
@@ -176,7 +178,7 @@ const App = () => {
 export default App
 ```
 
-The PDF viewer will automatically adjust to fit its container's dimensions. You can control the size by setting the `style` prop on `RPLayout`. For more information on using React PDF, visit our [basic usage guide](https://docs.react-pdf-kit.dev/introduction/basic-usage?utm_source=github&utm_medium=referral)
+The PDF viewer will automatically adjust to fit its container's dimensions. You can control the size by setting the `style` prop on `RPLayout`. For more information on using React PDF, visit our [basic usage guide](https://www.react-pdf-kit.dev/docs/introduction/basic-usage?utm_source=github&utm_medium=referral)
 
 You may also check out our [Starter Toolkit](#pushpin-starter-toolkit) for examples to get you started.
 
@@ -186,6 +188,17 @@ To enhance React PDF Kit further, we offer built-in hooks and props that let you
 
 For detailed usage, refer to our [Documentation][reactpdf-docs].
 
+### 5. Localization
+
+React PDF Kit supports multiple languages out of the box. Pass a locale JSON file to `RPConfig` to translate all viewer text:
+
+```jsx
+import zhCN from './localization/zh_CN.json'
+;<RPConfig localization={zhCN}>{/* ... */}</RPConfig>
+```
+
+We ship locale files for English, Italian, Portuguese, Thai, and Chinese (Simplified). You can also create your own -- see the [Localization Guide](./localization/README.md) for the full list of translation keys and instructions on adding a new language. If you've created a locale we don't support yet, feel free to open a PR to share it with the community!
+
 # :pushpin: Starter Toolkit
 
 Here are some sample projects to get started on React PDF quickly:
@@ -215,7 +228,7 @@ Here are some sample projects to get started on React PDF quickly:
 
 # 📝 Changelog
 
-Check out our latest release [v2.0.0 (20 February 2026)](https://docs.react-pdf-kit.dev/introduction/changelog/#v200-20-february-2026?utm_source=github&utm_medium=referral)
+Check out our latest release [v2.7.3 (9 July 2026)](https://www.react-pdf-kit.dev/docs/introduction/changelog/#v273-9-July-2026?utm_source=github&utm_medium=referral)
 
 # :raising_hand: Need Help?
 
@@ -230,10 +243,11 @@ If you would like to use React PDF commercially, please purchase a license from
 # Acknowledgement
 
 - [pdf.js](https://github.com/mozilla/pdf.js)
+- [node-forge](https://github.com/digitalbazaar/forge)
 - [Img Shields](https://shields.io)
 - [React.js](https://reactjs.org/)
 
 [reactpdf]: https://www.react-pdf-kit.dev/?utm_source=github&utm_medium=referral
-[reactpdf-docs]: https://docs.react-pdf-kit.dev/?utm_source=github&utm_medium=referral
+[reactpdf-docs]: https://www.react-pdf-kit.dev/docs/?utm_source=github&utm_medium=referral
 [npm]: https://www.npmjs.com/package/@react-pdf-kit/viewer
 [twitter]: https://www.x.com/ReactPDF

package/dist/types/utils/const.d.ts

@@ -1,6 +1,8 @@
 import { NormalizedKeyword } from './types';
 export declare const EMPTY_KEYWORD_REGEXP: NormalizedKeyword;
+export declare const DOCS_URL = "https://www.react-pdf-kit.dev/docs";
 export declare const ORGANIZATION_ALLOWED_FEATURES_MESSAGE = "This feature is only available for the Organization license";
 export declare const INVALID_OR_CORRUPTED_PDF_MESSAGE = "Invalid or corrupted PDF file.";
 export declare const BROWSER_NOT_SUPPORTED_MESSAGE = "React PDF Kit is unable to render on this browser.";
 export declare const WASM_URL_REQUIRED_MESSAGE = "This PDF uses JPEG 2000 images and requires pdf.js WASM assets. Please set wasmUrl in RPConfig.";
+export declare const WASM_URL_REQUIRED_CONSOLE_MESSAGE = "This PDF uses JPEG 2000 images and requires pdf.js WASM assets. Please set wasmUrl in RPConfig. Learn more: https://www.react-pdf-kit.dev/docs/components/rp-config";

package/dist/utils/const.js

@@ -3,6 +3,6 @@ var e = {
 	keyword: "",
 	regExp: /* @__PURE__ */ RegExp(" "),
 	wholeWords: !1
-}, t = "This feature is only available for the Organization license", n = "Invalid or corrupted PDF file.", r = "React PDF Kit is unable to render on this browser.", i = "This PDF uses JPEG 2000 images and requires pdf.js WASM assets. Please set wasmUrl in RPConfig.";
+}, t = "https://www.react-pdf-kit.dev/docs", n = "This feature is only available for the Organization license", r = "Invalid or corrupted PDF file.", i = "React PDF Kit is unable to render on this browser.", a = "This PDF uses JPEG 2000 images and requires pdf.js WASM assets. Please set wasmUrl in RPConfig.", o = `${a} Learn more: ${t}/components/rp-config`;
 //#endregion
-export { r as BROWSER_NOT_SUPPORTED_MESSAGE, e as EMPTY_KEYWORD_REGEXP, n as INVALID_OR_CORRUPTED_PDF_MESSAGE, t as ORGANIZATION_ALLOWED_FEATURES_MESSAGE, i as WASM_URL_REQUIRED_MESSAGE };
+export { i as BROWSER_NOT_SUPPORTED_MESSAGE, t as DOCS_URL, e as EMPTY_KEYWORD_REGEXP, r as INVALID_OR_CORRUPTED_PDF_MESSAGE, n as ORGANIZATION_ALLOWED_FEATURES_MESSAGE, o as WASM_URL_REQUIRED_CONSOLE_MESSAGE, a as WASM_URL_REQUIRED_MESSAGE };

package/dist/utils/hooks/useLicense.js

@@ -3,7 +3,7 @@ import { LicenseType as t } from "../types.js";
 import { appConsole as n } from "../appConsole.js";
 import { useCallback as r, useEffect as i, useState as a } from "react";
 //#region lib/utils/hooks/useLicense.ts
-var o = /* @__PURE__ */ new Date("2026-07-15T11:17:10.649Z"), s = "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAvIokvErJ0Fctu0jduSAx\ngr+5Har/VSuZLlOunS28hnlqqA+OF1apHL7RYkjBosS15yvviYdLrVWYHpHnoY4b\nHLQ9I6YX6FMB9T/VbB4xLdVdKvfi8r49aTScl5EKuSpgpPgz2VSJTfvVGcRuth/Y\nBm7PPGYdL2l2gvKDxchmmsHFPukGki9L4JOUeIVX0GXAxabENckaEH/iC1NZhX+W\nvXnpHeHuIIKlZ16LSivXNgo6BH2Z3GFdg4G3cAaXr6qNP8fsacYNqv2SpTW1viFD\nvzcGRabN25gpJAp9/syeScefWH3OiJY1lmw88oTiJbjIoiq6AkPhfn3G9mF54nvR\nkwIDAQAB\n-----END PUBLIC KEY-----", c = "Please visit https://app.react-pdf-kit.dev to generate a new license key.", l = {
+var o = /* @__PURE__ */ new Date("2026-07-22T07:16:44.906Z"), s = "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAvIokvErJ0Fctu0jduSAx\ngr+5Har/VSuZLlOunS28hnlqqA+OF1apHL7RYkjBosS15yvviYdLrVWYHpHnoY4b\nHLQ9I6YX6FMB9T/VbB4xLdVdKvfi8r49aTScl5EKuSpgpPgz2VSJTfvVGcRuth/Y\nBm7PPGYdL2l2gvKDxchmmsHFPukGki9L4JOUeIVX0GXAxabENckaEH/iC1NZhX+W\nvXnpHeHuIIKlZ16LSivXNgo6BH2Z3GFdg4G3cAaXr6qNP8fsacYNqv2SpTW1viFD\nvzcGRabN25gpJAp9/syeScefWH3OiJY1lmw88oTiJbjIoiq6AkPhfn3G9mF54nvR\nkwIDAQAB\n-----END PUBLIC KEY-----", c = "Please visit https://app.react-pdf-kit.dev to generate a new license key.", l = {
 	invalidLicense: `You are currently using without a valid license. ${c}`,
 	mismatchedDomain: `Your license key is not valid for the current domain / IP. ${c}`,
 	expired: `Your license key has expired. ${c}`,

package/dist/utils/hooks/useLoadPdf.js

@@ -2,87 +2,88 @@
 import { ErrorType as e } from "../types.js";
 import { getThumbnailViewport as t } from "../getThumbnailViewport.js";
 import { useConfigContext as n } from "../../contexts/ConfigContext.js";
-import { useDocumentPasswordContext as r } from "../../contexts/DocumentPasswordContext.js";
-import { BROWSER_NOT_SUPPORTED_MESSAGE as i, INVALID_OR_CORRUPTED_PDF_MESSAGE as a, WASM_URL_REQUIRED_MESSAGE as o } from "../const.js";
-import { useEffect as s, useRef as c, useState as l } from "react";
-import * as u from "pdfjs-dist";
+import { appConsole as r } from "../appConsole.js";
+import { useDocumentPasswordContext as i } from "../../contexts/DocumentPasswordContext.js";
+import { BROWSER_NOT_SUPPORTED_MESSAGE as a, INVALID_OR_CORRUPTED_PDF_MESSAGE as o, WASM_URL_REQUIRED_CONSOLE_MESSAGE as s, WASM_URL_REQUIRED_MESSAGE as c } from "../const.js";
+import { useEffect as l, useRef as u, useState as d } from "react";
+import * as f from "pdfjs-dist";
 //#region lib/utils/hooks/useLoadPdf.ts
-var d = new TextEncoder().encode("/JPXDecode");
-function f(e) {
-	return e.some((t, n) => t === d[0] ? d.every((t, r) => e[n + r] === t) : !1);
+var p = new TextEncoder().encode("/JPXDecode");
+function m(e) {
+	return e.some((t, n) => t === p[0] ? p.every((t, r) => e[n + r] === t) : !1);
 }
-function p(e) {
-	let t = Error(a);
+function h(e) {
+	let t = Error(o);
 	return t.cause = e, t;
 }
-function m() {
-	return Error(o);
+function g() {
+	return Error(c);
 }
-function h(e) {
-	let t = Error(i);
+function _(e) {
+	let t = Error(a);
 	return t.cause = e, t;
 }
-var g = (i, a, o = {}) => {
-	let [d, g] = l(), { workerUrlAdded: _, wasmUrl: v } = n(), [y, b] = l(/* @__PURE__ */ new Map()), x = c(), [S, C] = l(0), [w, T] = l(!1), [E, D] = l(), { password: O, passwordError: k, setPasswordError: A, passwordRequired: j, setPasswordRequired: M } = r(), { onLoadError: N, onLoaded: P, onLoadProgress: F, disableAutoFetch: I, disableStream: L, rangeChunkSize: R, withCredentials: z, httpHeaders: B } = o;
-	return s(() => {
-		F && F(S);
-	}, [S, F]), s(() => {
-		if (!_ || !i) return;
-		C(0), D(void 0), x.current = Date.now();
-		let t = x.current, n = {
-			url: i,
-			cMapPacked: a?.isCompressed ?? !0,
-			...a?.url && { cMapUrl: a.url },
-			...O && { password: O },
-			...I !== void 0 && { disableAutoFetch: I },
-			...L !== void 0 && { disableStream: L },
-			...R !== void 0 && { rangeChunkSize: R },
-			...z !== void 0 && { withCredentials: z },
-			...B !== void 0 && { httpHeaders: B },
-			...v && { wasmUrl: v },
-			verbosity: u.VerbosityLevel.ERRORS
+var v = (a, o, c = {}) => {
+	let [p, v] = d(), { workerUrlAdded: y, wasmUrl: b } = n(), [x, S] = d(/* @__PURE__ */ new Map()), C = u(), [w, T] = d(0), [E, D] = d(!1), [O, k] = d(), { password: A, passwordError: j, setPasswordError: M, passwordRequired: N, setPasswordRequired: P } = i(), { onLoadError: F, onLoaded: I, onLoadProgress: L, disableAutoFetch: R, disableStream: z, rangeChunkSize: B, withCredentials: V, httpHeaders: H } = c;
+	return l(() => {
+		L && L(w);
+	}, [w, L]), l(() => {
+		if (!y || !a) return;
+		T(0), k(void 0), C.current = Date.now();
+		let t = C.current, n = {
+			url: a,
+			cMapPacked: o?.isCompressed ?? !0,
+			...o?.url && { cMapUrl: o.url },
+			...A && { password: A },
+			...R !== void 0 && { disableAutoFetch: R },
+			...z !== void 0 && { disableStream: z },
+			...B !== void 0 && { rangeChunkSize: B },
+			...V !== void 0 && { withCredentials: V },
+			...H !== void 0 && { httpHeaders: H },
+			...b && { wasmUrl: b },
+			verbosity: f.VerbosityLevel.ERRORS
 		};
 		try {
-			let r = u.getDocument(n);
-			r.onProgress = (e) => {
-				if (t === x.current) {
+			let i = f.getDocument(n);
+			i.onProgress = (e) => {
+				if (t === C.current) {
 					let { loaded: t, total: n } = e;
-					C(n ? Math.min(100, Math.round(t / n * 100)) : 0);
+					T(n ? Math.min(100, Math.round(t / n * 100)) : 0);
 				}
-			}, T(!0), g(void 0);
-			let i = r.promise.then(async (n) => !v && f(await n.getData()) ? (t === x.current && (g(void 0), D(e.WASM_URL_REQUIRED)), N?.(m()), n) : (t === x.current && (g(n), C(100)), P && P(n), M(!1), A(""), n)).catch((t) => {
+			}, D(!0), v(void 0);
+			let a = i.promise.then(async (n) => !b && m(await n.getData()) ? (t === C.current && (v(void 0), k(e.WASM_URL_REQUIRED)), r.error(s), F?.(g()), n) : (t === C.current && (v(n), T(100)), I && I(n), P(!1), M(""), n)).catch((t) => {
 				if (t instanceof Error && t.name === "PasswordException") {
 					let e = t.code;
-					M(!0), e === u.PasswordResponses.INCORRECT_PASSWORD ? A("Incorrect password") : A(void 0);
-				} else t instanceof Error && t.name === "InvalidPDFException" && O ? (M(!0), A("Incorrect password")) : t instanceof Error && t.name === "InvalidPDFException" ? (D(e.INVALID_OR_CORRUPTED_PDF), N?.(p(t))) : N && N(t);
+					P(!0), e === f.PasswordResponses.INCORRECT_PASSWORD ? M("Incorrect password") : M(void 0);
+				} else t instanceof Error && t.name === "InvalidPDFException" && A ? (P(!0), M("Incorrect password")) : t instanceof Error && t.name === "InvalidPDFException" ? (k(e.INVALID_OR_CORRUPTED_PDF), F?.(h(t))) : F && F(t);
 			}).finally(() => {
-				T(!1);
+				D(!1);
 			});
 			return () => {
-				i.finally(() => {
-					r.destroy();
+				a.finally(() => {
+					i.destroy();
 				});
 			};
 		} catch (t) {
-			D(e.NOT_SUPPORTED), N?.(h(t));
+			k(e.NOT_SUPPORTED), F?.(_(t));
 		}
 	}, [
-		i,
-		_,
-		v,
-		O,
-		N,
-		P
-	]), s(() => {
-		if (j) return;
+		a,
+		y,
+		b,
+		A,
+		F,
+		I
+	]), l(() => {
+		if (N) return;
 		let n = /* @__PURE__ */ new Map();
-		if (!d || w) {
-			b(n);
+		if (!p || E) {
+			S(n);
 			return;
 		}
-		let r = d.numPages, i = [];
+		let r = p.numPages, i = [];
 		for (let e = 1; e <= r; e++) {
-			let t = d.getPage(e);
+			let t = p.getPage(e);
 			i.push(t);
 		}
 		Promise.allSettled(i).then((e) => {
@@ -96,24 +97,24 @@ var g = (i, a, o = {}) => {
 					thumbnailScale: i,
 					defaultRotation: a.rotation
 				});
-			}), b(n);
+			}), S(n);
 		}).catch((t) => {
-			g(void 0), D(e.INVALID_OR_CORRUPTED_PDF), N?.(p(t));
+			v(void 0), k(e.INVALID_OR_CORRUPTED_PDF), F?.(h(t));
 		});
 	}, [
-		d,
-		w,
-		j,
-		N
+		p,
+		E,
+		N,
+		F
 	]), {
-		pdf: d,
-		pages: y,
-		loading: w,
-		error: E,
-		loadingProgress: S,
-		passwordRequired: j,
-		passwordError: k
+		pdf: p,
+		pages: x,
+		loading: E,
+		error: O,
+		loadingProgress: w,
+		passwordRequired: N,
+		passwordError: j
 	};
 };
 //#endregion
-export { g as useLoadPdf };
+export { v as useLoadPdf };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-pdf-kit/viewer",
-  "version": "2.7.4-rc.0",
+  "version": "2.7.4-rc.2",
   "private": false,
   "description": "A react-pdf-viewer component for React and Next.js. Suitable for react-pdf document.",
   "keywords": [