@jc-times/business-ui 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -321,3 +321,9 @@
 
 ## 0.2.52
 - AutoComplete and Combobox accept grouped options with non-selectable, muted headings and preserve filtering and keyboard selection.
+# 0.3.2 — 2026-09-22 (patch)
+
+- Render existing signature Widget appearances in Headless pages and thumbnails (`withForms: true`); rendering does not enable form editing or alter signed bytes. Add failed-before/passed-after Widget regression coverage.
+
+- Fix missing Chinese and substituted Latin text in PDFs with unembedded fonts. Both PDFium viewers use stable same-origin Noto fallback configuration; assets and OFL licenses ship with the package, with no external CDN requests.
+- Add desktop/mobile real PDF rendering coverage. Restoring `fontFallback: null` makes the same Chinese test fail with zero text pixels; explicit caller overrides remain supported.

package/THIRD_PARTY_NOTICES.md

@@ -29,3 +29,8 @@
 MIT, Copyright (c) 2019-present react-component. Source: https://github.com/react-component/cascader. Used as the external Cascader interaction dependency; license reproduced in licenses/rc-cascader-MIT.txt. Transitive dependencies retain their own notices in their installed packages.
 
 0.2.46 additionally bundles the React gesture entry of @embedpdf/plugin-zoom@2.15.0 with a pinned bounds/precision patch. Original MIT license: licenses/embedpdf-MIT.txt; patch: patches/@embedpdf__plugin-zoom@2.15.0.patch. Engine and core plugin implementations remain external.
+# PDF fallback fonts
+
+`assets/pdf-fonts` contains unmodified Noto Sans Hans and Noto Sans fonts from
+`@embedpdf/fonts-sc@1.0.0` and `@embedpdf/fonts-latin@1.0.0`, under SIL OFL 1.1.
+See the accompanying `OFL-CJK.txt`, `OFL-Latin.txt`, and source README.

package/assets/pdf-fonts/OFL-CJK.txt

@@ -0,0 +1,92 @@
+This Font Software is licensed under the SIL Open Font License,
+Version 1.1.
+
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font
+creation efforts of academic and linguistic communities, and to
+provide a free and open framework in which fonts may be shared and
+improved in partnership with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply to
+any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software
+components as distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to,
+deleting, or substituting -- in part or in whole -- any of the
+components of the Original Version, by changing formats or by porting
+the Font Software to a new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed,
+modify, redistribute, and sell modified and unmodified copies of the
+Font Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components, in
+Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the
+corresponding Copyright Holder. This restriction only applies to the
+primary font name as presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created using
+the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/pdf-fonts/OFL-Latin.txt

@@ -0,0 +1,94 @@
+Copyright 2018 The Noto Project Authors (github.com/googlei18n/noto-fonts)
+
+This Font Software is licensed under the SIL Open Font License,
+Version 1.1.
+
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font
+creation efforts of academic and linguistic communities, and to
+provide a free and open framework in which fonts may be shared and
+improved in partnership with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply to
+any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software
+components as distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to,
+deleting, or substituting -- in part or in whole -- any of the
+components of the Original Version, by changing formats or by porting
+the Font Software to a new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed,
+modify, redistribute, and sell modified and unmodified copies of the
+Font Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components, in
+Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the
+corresponding Copyright Holder. This restriction only applies to the
+primary font name as presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created using
+the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/pdf-fonts/README.md

@@ -0,0 +1,11 @@
+# PDFium fallback fonts
+
+Unmodified assets copied from exact npm packages `@embedpdf/fonts-sc@1.0.0`
+and `@embedpdf/fonts-latin@1.0.0` (their `fonts/` directories). Noto Sans Hans
+Regular provides Chinese glyphs; Noto Sans Regular/Bold/Italic/BoldItalic
+provides Latin variants. Licenses accompany the font files.
+
+The public viewer imports these through `@jc-times/business-ui/pdf-fonts/*?url`.
+Consumer bundlers emit static same-origin assets. The renderer requests the
+required font only when a PDF lacks its own font. These files must not be
+inlined into the main JavaScript entry or loaded from a public CDN.

package/dist/document-viewer-v2/DocumentViewerV2.js

@@ -1,20 +1,21 @@
 import { DocumentViewer as e } from "../document-viewer/DocumentViewer.js";
-import { Suspense as t, lazy as n, useCallback as r, useMemo as i } from "react";
-import { jsx as a, jsxs as o } from "react/jsx-runtime";
+import { pdfFontFallback as t } from "./pdf-font-fallback.js";
+import { Suspense as n, lazy as r, useCallback as i, useMemo as a } from "react";
+import { jsx as o, jsxs as s } from "react/jsx-runtime";
 //#region src/document-viewer-v2/DocumentViewerV2.tsx
-var s = n(() => import("@embedpdf/react-pdf-viewer").then((e) => ({ default: e.PDFViewer }))), c = n(() => import("./HeadlessPdfViewer.js")), l = [
+var c = r(() => import("@embedpdf/react-pdf-viewer").then((e) => ({ default: e.PDFViewer }))), l = r(() => import("./HeadlessPdfViewer.js")), u = [
 	"annotation",
 	"redaction",
 	"insert",
 	"form"
-], u = "data-business-ui-document-viewer-v2-toolbar", d = "\n[data-epdf-i=\"main-toolbar\"] {\n  min-height: 52px;\n  gap: 8px;\n  padding: 7px 12px;\n  border-bottom-color: var(--ui-border, #dde0eb);\n  background: var(--ui-surface, #fff);\n  box-shadow: 0 1px 0 color-mix(in srgb, var(--ui-text, #242837) 3%, transparent);\n}\n\n[data-epdf-i=\"main-toolbar\"] [data-epdf-i$=\"-group\"] {\n  gap: 4px;\n}\n\n[data-epdf-i=\"main-toolbar\"] button:not([role=\"tab\"]) {\n  width: 36px;\n  min-width: 36px;\n  height: 36px;\n  padding: 7px;\n  border: 1px solid transparent;\n  border-radius: var(--ui-radius, 8px);\n  color: var(--ui-muted, #70778b);\n  background: transparent;\n  box-shadow: none;\n  transition:\n    color var(--ui-motion-fast, 120ms) var(--ui-ease-standard, ease),\n    background-color var(--ui-motion-fast, 120ms) var(--ui-ease-standard, ease),\n    border-color var(--ui-motion-fast, 120ms) var(--ui-ease-standard, ease),\n    box-shadow var(--ui-motion-fast, 120ms) var(--ui-ease-standard, ease);\n}\n\n[data-epdf-i=\"main-toolbar\"] button:not([role=\"tab\"]):hover:not(:disabled) {\n  border-color: color-mix(in srgb, var(--ui-primary, #5965a8) 22%, var(--ui-border, #dde0eb));\n  color: var(--ui-primary-hover, #414a78);\n  background: var(--ui-primary-soft, #eef0fb);\n  box-shadow: none;\n}\n\n[data-epdf-i=\"main-toolbar\"] button:not([role=\"tab\"]):focus-visible {\n  border-color: var(--ui-primary, #5965a8);\n  outline: 3px solid var(--ui-focus, rgb(89 101 168 / 28%));\n  outline-offset: 1px;\n}\n\n[data-epdf-i=\"main-toolbar\"] button.bg-interactive-selected {\n  border-color: color-mix(in srgb, var(--ui-primary, #5965a8) 42%, var(--ui-border, #dde0eb));\n  color: var(--ui-primary-hover, #414a78);\n  background: var(--ui-primary-soft, #eef0fb);\n  box-shadow: 0 1px 3px color-mix(in srgb, var(--ui-primary, #5965a8) 16%, transparent);\n}\n\n[data-epdf-i=\"main-toolbar\"] button:disabled {\n  opacity: .48;\n}\n\n[data-epdf-i=\"main-toolbar\"] button:not([role=\"tab\"]) > svg {\n  width: 20px;\n  height: 20px;\n}\n\n[data-epdf-i=\"zoom-toolbar\"] > .relative > .flex {\n  height: 36px;\n  padding-left: 8px;\n  overflow: hidden;\n  border: 1px solid var(--ui-border, #dde0eb);\n  border-radius: var(--ui-radius, 8px);\n  color: var(--ui-text, #242837);\n  background: var(--ui-surface, #fff);\n}\n\n[data-epdf-i=\"zoom-toolbar\"] input[name=\"zoom\"] {\n  width: 36px;\n  color: var(--ui-text, #242837);\n  font-weight: 700;\n}\n\n[data-epdf-i=\"zoom-toolbar\"] > .relative > .flex > button {\n  width: 34px;\n  min-width: 34px;\n  height: 34px;\n  padding: 7px;\n  border: 0;\n  border-radius: 6px;\n}\n\n[data-epdf-i=\"main-toolbar\"] [aria-hidden=\"true\"] > div {\n  background: var(--ui-border, #dde0eb);\n}\n\n@container (max-width: 640px) {\n  [data-epdf-i=\"main-toolbar\"] {\n    min-height: 56px;\n    padding: 7px 8px;\n  }\n\n  [data-epdf-i=\"main-toolbar\"] button:not([role=\"tab\"]) {\n    width: 40px;\n    min-width: 40px;\n    height: 40px;\n  }\n}\n";
-function f(e) {
+], d = "data-business-ui-document-viewer-v2-toolbar", f = "\n[data-epdf-i=\"main-toolbar\"] {\n  min-height: 52px;\n  gap: 8px;\n  padding: 7px 12px;\n  border-bottom-color: var(--ui-border, #dde0eb);\n  background: var(--ui-surface, #fff);\n  box-shadow: 0 1px 0 color-mix(in srgb, var(--ui-text, #242837) 3%, transparent);\n}\n\n[data-epdf-i=\"main-toolbar\"] [data-epdf-i$=\"-group\"] {\n  gap: 4px;\n}\n\n[data-epdf-i=\"main-toolbar\"] button:not([role=\"tab\"]) {\n  width: 36px;\n  min-width: 36px;\n  height: 36px;\n  padding: 7px;\n  border: 1px solid transparent;\n  border-radius: var(--ui-radius, 8px);\n  color: var(--ui-muted, #70778b);\n  background: transparent;\n  box-shadow: none;\n  transition:\n    color var(--ui-motion-fast, 120ms) var(--ui-ease-standard, ease),\n    background-color var(--ui-motion-fast, 120ms) var(--ui-ease-standard, ease),\n    border-color var(--ui-motion-fast, 120ms) var(--ui-ease-standard, ease),\n    box-shadow var(--ui-motion-fast, 120ms) var(--ui-ease-standard, ease);\n}\n\n[data-epdf-i=\"main-toolbar\"] button:not([role=\"tab\"]):hover:not(:disabled) {\n  border-color: color-mix(in srgb, var(--ui-primary, #5965a8) 22%, var(--ui-border, #dde0eb));\n  color: var(--ui-primary-hover, #414a78);\n  background: var(--ui-primary-soft, #eef0fb);\n  box-shadow: none;\n}\n\n[data-epdf-i=\"main-toolbar\"] button:not([role=\"tab\"]):focus-visible {\n  border-color: var(--ui-primary, #5965a8);\n  outline: 3px solid var(--ui-focus, rgb(89 101 168 / 28%));\n  outline-offset: 1px;\n}\n\n[data-epdf-i=\"main-toolbar\"] button.bg-interactive-selected {\n  border-color: color-mix(in srgb, var(--ui-primary, #5965a8) 42%, var(--ui-border, #dde0eb));\n  color: var(--ui-primary-hover, #414a78);\n  background: var(--ui-primary-soft, #eef0fb);\n  box-shadow: 0 1px 3px color-mix(in srgb, var(--ui-primary, #5965a8) 16%, transparent);\n}\n\n[data-epdf-i=\"main-toolbar\"] button:disabled {\n  opacity: .48;\n}\n\n[data-epdf-i=\"main-toolbar\"] button:not([role=\"tab\"]) > svg {\n  width: 20px;\n  height: 20px;\n}\n\n[data-epdf-i=\"zoom-toolbar\"] > .relative > .flex {\n  height: 36px;\n  padding-left: 8px;\n  overflow: hidden;\n  border: 1px solid var(--ui-border, #dde0eb);\n  border-radius: var(--ui-radius, 8px);\n  color: var(--ui-text, #242837);\n  background: var(--ui-surface, #fff);\n}\n\n[data-epdf-i=\"zoom-toolbar\"] input[name=\"zoom\"] {\n  width: 36px;\n  color: var(--ui-text, #242837);\n  font-weight: 700;\n}\n\n[data-epdf-i=\"zoom-toolbar\"] > .relative > .flex > button {\n  width: 34px;\n  min-width: 34px;\n  height: 34px;\n  padding: 7px;\n  border: 0;\n  border-radius: 6px;\n}\n\n[data-epdf-i=\"main-toolbar\"] [aria-hidden=\"true\"] > div {\n  background: var(--ui-border, #dde0eb);\n}\n\n@container (max-width: 640px) {\n  [data-epdf-i=\"main-toolbar\"] {\n    min-height: 56px;\n    padding: 7px 8px;\n  }\n\n  [data-epdf-i=\"main-toolbar\"] button:not([role=\"tab\"]) {\n    width: 40px;\n    min-width: 40px;\n    height: 40px;\n  }\n}\n";
+function p(e) {
 	let { shadowRoot: t } = e;
 	if (!t || t.querySelector("[data-business-ui-document-viewer-v2-toolbar]")) return;
 	let n = t.ownerDocument.createElement("style");
-	n.setAttribute(u, ""), n.textContent = d, t.append(n);
+	n.setAttribute(d, ""), n.textContent = f, t.append(n);
 }
-var p = {
+var m = {
 	preference: "system",
 	light: {
 		background: {
@@ -58,113 +59,113 @@ var p = {
 		}
 	}
 };
-function m(e) {
+function h(e) {
 	return {
-		...p,
+		...m,
 		...e,
 		light: {
-			...p.light,
+			...m.light,
 			...e?.light,
 			background: {
-				...p.light?.background,
+				...m.light?.background,
 				...e?.light?.background
 			},
 			foreground: {
-				...p.light?.foreground,
+				...m.light?.foreground,
 				...e?.light?.foreground
 			},
 			border: {
-				...p.light?.border,
+				...m.light?.border,
 				...e?.light?.border
 			},
 			accent: {
-				...p.light?.accent,
+				...m.light?.accent,
 				...e?.light?.accent
 			},
 			interactive: {
-				...p.light?.interactive,
+				...m.light?.interactive,
 				...e?.light?.interactive
 			}
 		}
 	};
 }
-function h(e, t = {}) {
-	let { documentManager: n, disabledCategories: r, fonts: i, i18n: a, theme: o, ...s } = t, { id: c, kind: u, ...d } = e;
+function g(e, n = {}) {
+	let { documentManager: r, disabledCategories: i, fonts: a, i18n: o, theme: s, ...c } = n, { id: l, kind: d, ...f } = e;
 	return {
 		worker: !0,
 		tabBar: "never",
-		fontFallback: null,
-		...s,
-		disabledCategories: r ?? [...l],
+		fontFallback: t,
+		...c,
+		disabledCategories: i ?? [...u],
 		fonts: {
 			ui: null,
 			signature: null,
-			...i
+			...a
 		},
 		i18n: {
 			defaultLocale: "zh-CN",
-			...a
+			...o
 		},
-		theme: m(o),
+		theme: h(s),
 		documentManager: {
 			maxDocuments: 1,
-			...n,
+			...r,
 			initialDocuments: [{
-				...d,
-				documentId: c,
+				...f,
+				documentId: l,
 				autoActivate: !0
 			}]
 		}
 	};
 }
-function g(n) {
-	return n.renderer === "headless" ? /* @__PURE__ */ a(t, {
-		fallback: /* @__PURE__ */ a("div", {
+function _(t) {
+	return t.renderer === "headless" ? /* @__PURE__ */ o(n, {
+		fallback: /* @__PURE__ */ o("div", {
 			role: "status",
 			children: "正在加载 PDF 查看器…"
 		}),
-		children: /* @__PURE__ */ a(c, { ...n }, `${n.source.kind}:${n.source.id}`)
-	}) : _(n) ? /* @__PURE__ */ a(v, { ...n }) : /* @__PURE__ */ a(e, {
-		...n,
-		className: ["ui-document-viewer-v2-compat", n.className].filter(Boolean).join(" ")
+		children: /* @__PURE__ */ o(l, { ...t }, `${t.source.kind}:${t.source.id}`)
+	}) : v(t) ? /* @__PURE__ */ o(y, { ...t }) : /* @__PURE__ */ o(e, {
+		...t,
+		className: ["ui-document-viewer-v2-compat", t.className].filter(Boolean).join(" ")
 	});
 }
-function _(e) {
+function v(e) {
 	return e.source.kind === "url" || e.source.kind === "buffer";
 }
-function v({ source: e, config: n, className: c, style: l, layoutMode: u = "standalone", ariaLabel: d = "PDF 文档查看器", onInit: p, onReady: m, title: g, toolbar: _, footer: v }) {
-	let y = i(() => h(e, n), [e, n]), b = r((e) => {
-		f(e), p?.(e);
-	}, [p]);
-	return /* @__PURE__ */ o("section", {
+function y({ source: e, config: t, className: r, style: l, layoutMode: u = "standalone", ariaLabel: d = "PDF 文档查看器", onInit: f, onReady: m, title: h, toolbar: _, footer: v }) {
+	let y = a(() => g(e, t), [e, t]), b = i((e) => {
+		p(e), f?.(e);
+	}, [f]);
+	return /* @__PURE__ */ s("section", {
 		className: [
 			"ui-document-viewer-v2",
 			u === "fill" && "ui-viewer-fill",
-			c
+			r
 		].filter(Boolean).join(" "),
 		style: l,
 		"aria-label": d,
 		children: [
-			(g !== void 0 || _ !== void 0) && /* @__PURE__ */ o("div", {
+			(h !== void 0 || _ !== void 0) && /* @__PURE__ */ s("div", {
 				className: "ui-viewer-toolbar",
-				children: [g !== void 0 && /* @__PURE__ */ a("div", {
+				children: [h !== void 0 && /* @__PURE__ */ o("div", {
 					className: "ui-viewer-title",
-					children: g
+					children: h
 				}), _]
 			}),
-			/* @__PURE__ */ a(t, {
-				fallback: /* @__PURE__ */ a("div", {
+			/* @__PURE__ */ o(n, {
+				fallback: /* @__PURE__ */ o("div", {
 					role: "status",
 					children: "正在加载 PDF 查看器…"
 				}),
-				children: /* @__PURE__ */ a(s, {
+				children: /* @__PURE__ */ o(c, {
 					className: "ui-document-viewer-v2-engine",
 					config: y,
 					onInit: b,
 					onReady: m
 				}, e.id)
 			}),
-			v !== void 0 && /* @__PURE__ */ a("div", {
+			v !== void 0 && /* @__PURE__ */ o("div", {
 				className: "ui-viewer-footer",
 				children: v
 			})
@@ -172,4 +173,4 @@ function v({ source: e, config: n, className: c, style: l, layoutMode: u = "stan
 	});
 }
 //#endregion
-export { l as DOCUMENT_VIEWER_V2_DISABLED_CATEGORIES, u as DOCUMENT_VIEWER_V2_TOOLBAR_STYLE_ATTRIBUTE, g as DocumentViewerV2, f as applyDocumentViewerV2ToolbarStyles, h as createDocumentViewerV2Config };
+export { u as DOCUMENT_VIEWER_V2_DISABLED_CATEGORIES, d as DOCUMENT_VIEWER_V2_TOOLBAR_STYLE_ATTRIBUTE, _ as DocumentViewerV2, p as applyDocumentViewerV2ToolbarStyles, g as createDocumentViewerV2Config };

package/dist/document-viewer-v2/HeadlessPdfViewer.js

@@ -2,42 +2,43 @@ import { Button as e } from "../Button.js";
 import { PdfWorkspace as t } from "../document-viewer/PdfWorkspace.js";
 import { PdfToolbar as n } from "../document-viewer/PdfToolbar.js";
 import { usePdfViewport as r } from "../document-viewer/usePdfViewport.js";
-import { ZoomGestureWrapper as i, react_exports as a, useZoom as o } from "../vendor/embedpdf-zoom-react19.js";
-import { HeadlessSearch as s } from "./HeadlessSearch.js";
-import { useEffect as c, useLayoutEffect as ee, useMemo as te, useRef as l, useState as u } from "react";
+import { pdfFontFallback as i } from "./pdf-font-fallback.js";
+import { ZoomGestureWrapper as a, react_exports as o, useZoom as s } from "../vendor/embedpdf-zoom-react19.js";
+import { HeadlessSearch as ee } from "./HeadlessSearch.js";
+import { useEffect as c, useLayoutEffect as te, useMemo as ne, useRef as l, useState as u } from "react";
 import { jsx as d, jsxs as f } from "react/jsx-runtime";
-import { Search as ne, X as re } from "lucide-react";
+import { Search as re, X as ie } from "lucide-react";
 import { createPluginRegistration as p } from "@embedpdf/core";
-import { EmbedPDF as m, useDocumentState as ie } from "@embedpdf/core/react";
+import { EmbedPDF as m, useDocumentState as ae } from "@embedpdf/core/react";
 import { usePdfiumEngine as h } from "@embedpdf/engines/react";
 import { DocumentManagerPluginPackage as g } from "@embedpdf/plugin-document-manager/react";
-import { Viewport as ae, ViewportPluginPackage as _, useViewportCapability as oe } from "@embedpdf/plugin-viewport/react";
-import { ScrollPluginPackage as v, Scroller as se, useScrollCapability as ce } from "@embedpdf/plugin-scroll/react";
-import { RenderLayer as le, RenderPluginPackage as y } from "@embedpdf/plugin-render/react";
-import { Rotate as ue, RotatePluginPackage as b, useRotate as de } from "@embedpdf/plugin-rotate/react";
-import { ThumbImg as fe, ThumbnailPluginPackage as x, ThumbnailsPane as pe } from "@embedpdf/plugin-thumbnail/react";
-import { SearchLayer as me, SearchPluginPackage as S, useSearch as he } from "@embedpdf/plugin-search/react";
-import { SelectionLayer as ge, SelectionPluginPackage as _e, useSelectionCapability as ve } from "@embedpdf/plugin-selection/react";
-import { InteractionManagerPluginPackage as C, PagePointerProvider as ye } from "@embedpdf/plugin-interaction-manager/react";
+import { Viewport as oe, ViewportPluginPackage as _, useViewportCapability as se } from "@embedpdf/plugin-viewport/react";
+import { ScrollPluginPackage as v, Scroller as ce, useScrollCapability as le } from "@embedpdf/plugin-scroll/react";
+import { RenderLayer as ue, RenderPluginPackage as y } from "@embedpdf/plugin-render/react";
+import { Rotate as de, RotatePluginPackage as b, useRotate as fe } from "@embedpdf/plugin-rotate/react";
+import { ThumbImg as pe, ThumbnailPluginPackage as x, ThumbnailsPane as me } from "@embedpdf/plugin-thumbnail/react";
+import { SearchLayer as he, SearchPluginPackage as S, useSearch as ge } from "@embedpdf/plugin-search/react";
+import { SelectionLayer as _e, SelectionPluginPackage as C, useSelectionCapability as ve } from "@embedpdf/plugin-selection/react";
+import { InteractionManagerPluginPackage as w, PagePointerProvider as ye } from "@embedpdf/plugin-interaction-manager/react";
 //#region src/document-viewer-v2/HeadlessPdfViewer.tsx
-var w = "(max-width: 900px), (hover: none) and (pointer: coarse)";
+var T = "(max-width: 900px), (hover: none) and (pointer: coarse)";
 function be(e) {
-	let [t, n] = u(() => e && typeof window < "u" && window.matchMedia(w).matches);
+	let [t, n] = u(() => e && typeof window < "u" && window.matchMedia(T).matches);
 	return c(() => {
 		if (!e) {
 			n(!1);
 			return;
 		}
-		let t = window.matchMedia(w), r = () => n(t.matches);
+		let t = window.matchMedia(T), r = () => n(t.matches);
 		return r(), t.addEventListener("change", r), () => t.removeEventListener("change", r);
 	}, [e]), t;
 }
-function T(e) {
+function E(e) {
 	let { engine: t, isLoading: n, error: r } = h({
 		worker: !0,
-		fontFallback: null,
+		fontFallback: i,
 		...e.engineOptions
-	}), [i] = u(() => {
+	}), [a] = u(() => {
 		let { id: t, kind: n, ...r } = e.source;
 		return [
 			p(g, { initialDocuments: [{
@@ -47,16 +48,19 @@ function T(e) {
 			}] }),
 			p(_),
 			p(v, { defaultPageGap: 20 }),
-			p(y, { withAnnotations: !0 }),
-			p(a.ZoomPluginPackage, {
+			p(y, {
+				withAnnotations: !0,
+				withForms: !0
+			}),
+			p(o.ZoomPluginPackage, {
 				defaultZoomLevel: 1,
 				minZoom: e.initialZoom === "fit-width" ? .1 : .5,
 				maxZoom: 3
 			}),
 			p(b),
-			p(C, { exclusionRules: { dataAttributes: ["data-pdf-business-control"] } }),
+			p(w, { exclusionRules: { dataAttributes: ["data-pdf-business-control"] } }),
 			p(S),
-			p(_e, { marquee: { enabled: !1 } }),
+			p(C, { marquee: { enabled: !1 } }),
 			p(x, { width: 100 })
 		];
 	});
@@ -68,44 +72,44 @@ function T(e) {
 		children: "正在加载 PDF 引擎…"
 	}) : /* @__PURE__ */ d(m, {
 		engine: t,
-		plugins: i,
+		plugins: a,
 		onInitialized: async (t) => {
 			e.onReady?.(t);
 		},
-		children: /* @__PURE__ */ d(E, { ...e })
+		children: /* @__PURE__ */ d(D, { ...e })
 	});
 }
-function E(p) {
-	let m = p.source.id, h = ie(m), g = h?.document, { provides: _ } = ce(), v = te(() => _?.forDocument(m), [_, m]), { provides: y, state: b } = o(m), { provides: x } = oe(), { provides: S } = ve(), { provides: _e } = he(m), { provides: C, rotation: w } = de(m), T = r(m), [E, D] = u(1), [O, k] = u(null), A = be(p.mobileMode === "continuous-reader"), j = p.searchMode === "collapsible", M = p.features?.search !== !1, [N, P] = u(!j), F = g?.pages.length ?? 0, I = Math.max(1, Math.min(F || 1, p.currentPage ?? E)), L = p.pageMode === "single" && !A, R = p.features?.textSelection !== !1 && !A, z = l(p);
-	z.current = p, c(() => {
+function D(i) {
+	let p = i.source.id, m = ae(p), h = m?.document, { provides: g } = le(), _ = ne(() => g?.forDocument(p), [g, p]), { provides: v, state: y } = s(p), { provides: b } = se(), { provides: x } = ve(), { provides: S } = ge(p), { provides: C, rotation: w } = fe(p), T = r(p), [E, D] = u(1), [O, k] = u(null), A = be(i.mobileMode === "continuous-reader"), j = i.searchMode === "collapsible", M = i.features?.search !== !1, [N, P] = u(!j), F = h?.pages.length ?? 0, I = Math.max(1, Math.min(F || 1, i.currentPage ?? E)), L = i.pageMode === "single" && !A, R = i.features?.textSelection !== !1 && !A, z = l(i);
+	z.current = i, c(() => {
 		P(!j), k(null);
-	}, [m, j]);
-	let B = h?.scale ?? 1, V = l(!1), H = l(p.currentPage ?? 1), U = l(!0), W = l(I), G = l(L), K = l(null);
-	ee(() => {
+	}, [p, j]);
+	let B = m?.scale ?? 1, V = l(!1), H = l(i.currentPage ?? 1), U = l(!0), W = l(I), G = l(L), K = l(null);
+	te(() => {
 		(W.current !== I || G.current !== L) && ((G.current !== L || I !== K.current) && (H.current = I), G.current !== L && (U.current = !0), W.current = I, G.current = L, K.current = null);
 	}, [I, L]);
-	let q = l(y);
-	q.current = y, c(() => {
-		if (!x || !F) return;
+	let q = l(v);
+	q.current = v, c(() => {
+		if (!b || !F) return;
 		let e = () => {
-			let e = x.forDocument(m).getMetrics();
-			!V.current && e.clientWidth && e.clientHeight && q.current && (V.current = !0, q.current.requestZoom(z.current.zoom ?? (z.current.initialZoom === "fit-width" ? a.ZoomMode.FitWidth : z.current.initialZoom ?? 1)));
-		}, t = x.onViewportResize((t) => {
-			t.documentId === m && e();
+			let e = b.forDocument(p).getMetrics();
+			!V.current && e.clientWidth && e.clientHeight && q.current && (V.current = !0, q.current.requestZoom(z.current.zoom ?? (z.current.initialZoom === "fit-width" ? o.ZoomMode.FitWidth : z.current.initialZoom ?? 1)));
+		}, t = b.onViewportResize((t) => {
+			t.documentId === p && e();
 		});
 		return e(), t;
 	}, [
-		x,
-		m,
+		b,
+		p,
 		F
 	]), c(() => {
-		if (v && !L) return v.onPageChange((e) => {
+		if (_ && !L) return _.onPageChange((e) => {
 			V.current && !U.current && (z.current.currentPage === void 0 && D(e.pageNumber), e.pageNumber !== z.current.currentPage && (K.current = e.pageNumber, z.current.onCurrentPageChange?.(e.pageNumber)));
 		});
-	}, [v, L]), c(() => {
-		if (!v || L || !F) return;
+	}, [_, L]), c(() => {
+		if (!_ || L || !F) return;
 		let e = () => {
-			H.current !== null && (U.current = !0, v.scrollToPage({
+			H.current !== null && (U.current = !0, _.scrollToPage({
 				pageNumber: H.current,
 				behavior: "instant",
 				...O?.page === H.current ? {
@@ -114,19 +118,19 @@ function E(p) {
 					alignY: 40
 				} : {}
 			}));
-		}, t = _?.onLayoutReady((t) => {
-			t.documentId === m && e();
-		}), n = x?.onViewportResize((t) => {
-			t.documentId === m && e();
+		}, t = g?.onLayoutReady((t) => {
+			t.documentId === p && e();
+		}), n = b?.onViewportResize((t) => {
+			t.documentId === p && e();
 		}), r = requestAnimationFrame(e);
 		return () => {
 			cancelAnimationFrame(r), t?.(), n?.();
 		};
 	}, [
-		v,
 		_,
-		x,
-		m,
+		g,
+		b,
+		p,
 		L,
 		F,
 		I,
@@ -134,9 +138,9 @@ function E(p) {
 		w,
 		O
 	]), c(() => {
-		if (!L || !O || !x) return;
-		let e = () => xe(T.containerRef.current, O, x.forDocument(m)), t = x.onViewportResize((t) => {
-			t.documentId === m && e();
+		if (!L || !O || !b) return;
+		let e = () => xe(T.containerRef.current, O, b.forDocument(p)), t = b.onViewportResize((t) => {
+			t.documentId === p && e();
 		}), n = requestAnimationFrame(e);
 		return () => {
 			cancelAnimationFrame(n), t();
@@ -144,23 +148,23 @@ function E(p) {
 	}, [
 		L,
 		O,
-		x,
-		m,
+		b,
+		p,
 		I,
 		B,
 		w
 	]);
-	let J = l(p.zoom ?? null), Y = l(p.rotation ?? null), X = l(B), Se = l(w);
+	let J = l(i.zoom ?? null), Y = l(i.rotation ?? null), X = l(B), Se = l(w);
 	c(() => {
-		p.zoom !== void 0 && y && F && Math.abs(p.zoom - B) > .001 && (J.current = p.zoom, y.requestZoom(p.zoom));
+		i.zoom !== void 0 && v && F && Math.abs(i.zoom - B) > .001 && (J.current = i.zoom, v.requestZoom(i.zoom));
 	}, [
-		p.zoom,
-		!!y,
+		i.zoom,
+		!!v,
 		F
 	]), c(() => {
-		p.rotation !== void 0 && C && F && p.rotation !== w * 90 && (Y.current = p.rotation, C.setRotation((p.rotation / 90 % 4 + 4) % 4));
+		i.rotation !== void 0 && C && F && i.rotation !== w * 90 && (Y.current = i.rotation, C.setRotation((i.rotation / 90 % 4 + 4) % 4));
 	}, [
-		p.rotation,
+		i.rotation,
 		!!C,
 		F
 	]), c(() => {
@@ -176,8 +180,8 @@ function E(p) {
 		}
 		Se.current !== w && z.current.onRotationChange?.(w * 90), Se.current = w;
 	}, [w]), c(() => {
-		let e = p.focusTarget, t = e && g?.pages[e.page - 1];
-		e && t && v && !L && (U.current = !0, v.scrollToPage({
+		let e = i.focusTarget, t = e && h?.pages[e.page - 1];
+		e && t && _ && !L && (U.current = !0, _.scrollToPage({
 			pageNumber: e.page,
 			pageCoordinates: {
 				x: t.size.width / 2,
@@ -187,8 +191,8 @@ function E(p) {
 			behavior: "instant"
 		}));
 	}, [
-		p.focusTarget?.token,
-		v,
+		i.focusTarget?.token,
+		_,
 		F,
 		L
 	]);
@@ -197,54 +201,54 @@ function E(p) {
 	}, Q = (e) => {
 		K.current = null;
 		let t = Math.max(1, Math.min(F, e));
-		p.currentPage === void 0 && D(t), p.onCurrentPageChange?.(t);
+		i.currentPage === void 0 && D(t), i.onCurrentPageChange?.(t);
 	}, Ce = (e) => {
-		let t = g?.pages[e];
+		let t = h?.pages[e];
 		if (!t) return null;
-		let n = (t.rotation + w) % 4, { width: r, height: i } = t.size, a = {
-			documentId: m,
+		let n = (t.rotation + w) % 4, { width: r, height: a } = t.size, o = {
+			documentId: p,
 			page: e + 1,
 			pageIndex: e,
 			width: r,
-			height: i,
+			height: a,
 			zoom: B,
 			rotation: n * 90
-		}, o = n % 2 == 1;
+		}, s = n % 2 == 1;
 		return /* @__PURE__ */ d("div", {
 			className: "ui-v2-native-page",
 			"data-page": e + 1,
 			style: {
 				position: "relative",
-				width: (o ? i : r) * B,
-				height: (o ? r : i) * B
+				width: (s ? a : r) * B,
+				height: (s ? r : a) * B
 			},
 			children: /* @__PURE__ */ d(ye, {
-				documentId: m,
+				documentId: p,
 				pageIndex: e,
 				rotation: n,
 				scale: B,
-				children: /* @__PURE__ */ f(ue, {
-					documentId: m,
+				children: /* @__PURE__ */ f(de, {
+					documentId: p,
 					pageIndex: e,
 					rotation: n,
 					style: {
 						width: r * B,
-						height: i * B
+						height: a * B
 					},
 					children: [
-						p.renderPage ? p.renderPage({
+						i.renderPage ? i.renderPage({
 							page: e + 1,
 							zoom: B,
 							rotation: n * 90
-						}) : /* @__PURE__ */ d(le, {
+						}) : /* @__PURE__ */ d(ue, {
 							draggable: !1,
-							documentId: m,
+							documentId: p,
 							pageIndex: e,
 							"aria-label": `第 ${e + 1} 页`
 						}),
-						M && N && /* @__PURE__ */ d(me, {
+						M && N && /* @__PURE__ */ d(he, {
 							"data-ui-search-layer": !0,
-							documentId: m,
+							documentId: p,
 							pageIndex: e,
 							scale: B
 						}),
@@ -259,24 +263,24 @@ function E(p) {
 								pointerEvents: "none"
 							}
 						}),
-						R && /* @__PURE__ */ d(ge, {
-							documentId: m,
+						R && /* @__PURE__ */ d(_e, {
+							documentId: p,
 							pageIndex: e,
 							scale: B,
 							rotation: 0
 						}),
-						p.renderPageOverlay && /* @__PURE__ */ d("div", {
+						i.renderPageOverlay && /* @__PURE__ */ d("div", {
 							className: "ui-v2-page-overlay",
 							style: {
 								position: "absolute",
 								inset: 0,
 								width: r,
-								height: i,
+								height: a,
 								transform: `scale(${B})`,
 								transformOrigin: "0 0",
 								pointerEvents: "none"
 							},
-							children: p.renderPageOverlay(a)
+							children: i.renderPageOverlay(o)
 						})
 					]
 				})
@@ -288,61 +292,61 @@ function E(p) {
 		"aria-expanded": N,
 		"aria-label": N ? "收起文档搜索" : "搜索文档",
 		onClick: () => {
-			N && (_e?.stopSearch(), k(null)), P(!N);
+			N && (S?.stopSearch(), k(null)), P(!N);
 		},
-		children: [d(N ? re : ne, { size: 15 }), /* @__PURE__ */ d("span", {
+		children: [d(N ? ie : re, { size: 15 }), /* @__PURE__ */ d("span", {
 			className: "ui-mobile-reader-search-label",
 			children: N ? "收起搜索" : "搜索文档"
 		})]
 	});
 	return /* @__PURE__ */ f("section", {
 		ref: T.containerRef,
-		style: p.style,
+		style: i.style,
 		onKeyDown: (e) => {
 			if (!R || !(e.ctrlKey || e.metaKey) || e.key.toLowerCase() !== "c" || e.target.closest("input, textarea, [contenteditable=\"true\"]")) return;
-			let t = S?.forDocument(m);
+			let t = x?.forDocument(p);
 			t?.getState().selection && (e.preventDefault(), t.copyToClipboard());
 		},
-		"aria-label": p.ariaLabel ?? "PDF 文档查看器",
+		"aria-label": i.ariaLabel ?? "PDF 文档查看器",
 		className: [
 			"ui-document-viewer",
 			"ui-document-viewer-v2-headless",
-			p.layoutMode === "fill" && "ui-viewer-fill",
+			i.layoutMode === "fill" && "ui-viewer-fill",
 			A && "ui-mobile-continuous-reader",
 			T.fullscreen && "ui-viewer-fullscreen",
-			p.className
+			i.className
 		].filter(Boolean).join(" "),
 		children: [
-			p.showToolbar !== !1 && /* @__PURE__ */ f("div", {
+			i.showToolbar !== !1 && /* @__PURE__ */ f("div", {
 				className: "ui-viewer-toolbar",
 				children: [
-					p.title !== void 0 && /* @__PURE__ */ d("div", {
+					i.title !== void 0 && /* @__PURE__ */ d("div", {
 						className: "ui-viewer-title",
-						children: p.title
+						children: i.title
 					}),
-					p.toolbar,
+					i.toolbar,
 					$,
 					/* @__PURE__ */ d(n, {
-						zoom: b.currentZoomLevel,
+						zoom: y.currentZoomLevel,
 						disabled: !F,
 						fullscreen: T.fullscreen,
 						canZoomIn: B < 3,
-						canZoomOut: B > (p.initialZoom === "fit-width" ? .1 : .5),
-						onZoomIn: () => y?.zoomIn(),
-						onZoomOut: () => y?.zoomOut(),
+						canZoomOut: B > (i.initialZoom === "fit-width" ? .1 : .5),
+						onZoomIn: () => v?.zoomIn(),
+						onZoomOut: () => v?.zoomOut(),
 						onRotate: () => C?.rotateForward(),
 						onToggleFullscreen: T.toggleFullscreen
 					})
 				]
 			}),
-			p.showToolbar === !1 && $ && /* @__PURE__ */ d("div", {
+			i.showToolbar === !1 && $ && /* @__PURE__ */ d("div", {
 				className: "ui-v2-search-disclosure",
 				children: $
 			}),
-			M && N && /* @__PURE__ */ d(s, {
+			M && N && /* @__PURE__ */ d(ee, {
 				onClear: () => k(null),
 				enabled: !!F,
-				documentId: m,
+				documentId: p,
 				onPageChange: (e, t) => {
 					H.current = e, k(t ? {
 						page: e,
@@ -350,13 +354,13 @@ function E(p) {
 					} : null), Q(e);
 				}
 			}),
-			h?.status === "error" ? /* @__PURE__ */ f("div", {
+			m?.status === "error" ? /* @__PURE__ */ f("div", {
 				role: "alert",
-				children: ["PDF 加载失败：", h.error]
-			}) : g ? /* @__PURE__ */ d(t, {
-				defaultRailCollapsed: p.defaultRailCollapsed,
-				rail: /* @__PURE__ */ d(pe, {
-					documentId: m,
+				children: ["PDF 加载失败：", m.error]
+			}) : h ? /* @__PURE__ */ d(t, {
+				defaultRailCollapsed: i.defaultRailCollapsed,
+				rail: /* @__PURE__ */ d(me, {
+					documentId: p,
 					children: (t) => /* @__PURE__ */ f(e, {
 						variant: "ghost",
 						className: "ui-v2-thumbnail",
@@ -370,8 +374,8 @@ function E(p) {
 							height: t.wrapperHeight,
 							display: "grid"
 						},
-						children: [/* @__PURE__ */ d(fe, {
-							documentId: m,
+						children: [/* @__PURE__ */ d(pe, {
+							documentId: p,
 							meta: t,
 							className: "ui-v2-thumbnail-image",
 							style: {
@@ -381,8 +385,8 @@ function E(p) {
 						}), /* @__PURE__ */ d("span", { children: t.pageIndex + 1 })]
 					}, t.pageIndex)
 				}),
-				children: /* @__PURE__ */ d(ae, {
-					documentId: m,
+				children: /* @__PURE__ */ d(oe, {
+					documentId: p,
 					className: "ui-v2-native-viewport",
 					tabIndex: 0,
 					"aria-label": "PDF 页面滚动区域",
@@ -395,16 +399,16 @@ function E(p) {
 					onTouchMoveCapture: Z,
 					onPointerDownCapture: Z,
 					onKeyDownCapture: Z,
-					children: /* @__PURE__ */ d(i, {
-						documentId: m,
-						enablePinch: p.features?.pinchZoom !== !1,
-						minZoom: p.initialZoom === "fit-width" ? .1 : .5,
+					children: /* @__PURE__ */ d(a, {
+						documentId: p,
+						enablePinch: i.features?.pinchZoom !== !1,
+						minZoom: i.initialZoom === "fit-width" ? .1 : .5,
 						maxZoom: 3,
 						children: L ? /* @__PURE__ */ d("div", {
 							className: "ui-v2-native-single",
 							children: Ce(I - 1)
-						}) : /* @__PURE__ */ d(se, {
-							documentId: m,
+						}) : /* @__PURE__ */ d(ce, {
+							documentId: p,
 							renderPage: ({ pageIndex: e }) => Ce(e)
 						})
 					})
@@ -438,7 +442,7 @@ function E(p) {
 						onClick: () => Q(I + 1),
 						children: "下一页"
 					}),
-					p.footer
+					i.footer
 				]
 			})
 		]
@@ -456,4 +460,4 @@ function xe(e, t, n) {
 	});
 }
 //#endregion
-export { T as default };
+export { E as default };

package/dist/document-viewer-v2/pdf-font-fallback.js

@@ -0,0 +1,35 @@
+import e from "@jc-times/business-ui/pdf-fonts/NotoSansHans-Regular.otf?url";
+import t from "@jc-times/business-ui/pdf-fonts/NotoSans-Regular.ttf?url";
+import n from "@jc-times/business-ui/pdf-fonts/NotoSans-Bold.ttf?url";
+import r from "@jc-times/business-ui/pdf-fonts/NotoSans-Italic.ttf?url";
+import i from "@jc-times/business-ui/pdf-fonts/NotoSans-BoldItalic.ttf?url";
+//#region src/document-viewer-v2/pdf-font-fallback.ts
+var a = (e) => typeof window > "u" ? e : new URL(e, window.location.href).href, o = {
+	fonts: {
+		0: [
+			{
+				url: a(t),
+				weight: 400
+			},
+			{
+				url: a(n),
+				weight: 700
+			},
+			{
+				url: a(r),
+				weight: 400,
+				italic: !0
+			},
+			{
+				url: a(i),
+				weight: 700,
+				italic: !0
+			}
+		],
+		1: a(e),
+		134: a(e)
+	},
+	defaultFont: a(e)
+};
+//#endregion
+export { o as pdfFontFallback };

package/dist/types/document-viewer-v2/pdf-font-fallback.d.ts

@@ -0,0 +1,2 @@
+import type { FontFallbackConfig } from '@embedpdf/engines/pdfium';
+export declare const pdfFontFallback: FontFallbackConfig;

package/docs/agent-guide.md

@@ -1,5 +1,7 @@
 # Agent 公共组件使用指南
 
+PDFium 自 0.3.2 默认按需使用同源中文/拉丁备用字体；构建器需支持包内 `?url` 静态资源导入（Vite）。不依赖外部字体 CDN；不要为禁外网而关闭整个字体回退。显式 `fontFallback: null` 仍可覆盖默认值。
+
 级联选择用于右侧窄栏时使用 0.2.48 或以上版本：浮层按可见视口避让，不需要消费方重写定位样式。
 
 本指南面向在业务应用中使用 `@jc-times/business-ui` 的 agent，也适用于维护本库的 agent。先按场景选型，再按需阅读 API 和专题文档，不需要通读历史审计记录。

package/docs/document-viewer-v2.md

@@ -94,7 +94,7 @@ export function ContractPreview({ fileVersion, pdfUrl, token }: Props) {
 成品 UI 默认配置：
 
 - 使用 Web Worker，单文档会话，隐藏多文档标签栏。
-- 默认语言为简体中文，UI 字体使用系统字体，禁用外部字体回退请求。
+- 默认语言为简体中文，UI 字体使用系统字体。PDF 正文缺失字体时按需加载随包发布的 Noto 中文/拉丁备用字体，由消费方构建为同源资源，不请求外部字体 CDN。
 - 默认关闭批注、插入、表单编辑和涂黑分类。
 - 打印、导出及 PDF 自身权限仍由消费项目决定，隐藏按钮不能代替服务端授权。
 - 消费方配置与公共默认主题进行合并；显式传入的配置优先。
@@ -158,7 +158,7 @@ export function ContractPreview({ fileVersion, pdfUrl, token }: Props) {
 | `searchMode` | 默认 `expanded`；`collapsible` 将搜索面板改为公共搜索开关，文档切换或收起时清理旧搜索。`showToolbar=false` 时仍显示紧凑的公共搜索入口；配合移动连续阅读模式时仅显示搜索图标 |
 | `renderPageOverlay(context)` | 追加 React 内容；context 包含 `documentId`、从 1 开始的 `page`、从 0 开始的 `pageIndex`、原始 `width/height`、`zoom`、角度制 `rotation` |
 | `renderPage({ page, zoom, rotation })` | 与 V1 一样替换整个正文页。只添加印章或标记时应使用 `renderPageOverlay`，避免替换 PDF 位图 |
-| `engineOptions` | `usePdfiumEngine` 的选项，例如 `wasmUrl`；默认 Worker 开启、外部字体回退关闭。改变初始化选项时更新 `source.id` |
+| `engineOptions` | `usePdfiumEngine` 的选项，例如 `wasmUrl`；默认 Worker 开启、同源字体回退开启。可显式传 `fontFallback: null` 关闭，或传自定义配置。改变初始化选项时更新 `source.id` |
 | `onReady(registry)` | 插件初始化回调；不保证文档已加载，不传成品 UI 的 `config/onInit` |
 
 叠层坐标以**未缩放、未旋转页面的左上角**为原点；`width/height` 是页面尺寸，不是视口 CSS 尺寸。组件统一应用缩放和 PDF 内置旋转加用户旋转，业务不要再次乘 `zoom` 或旋转整个叠层。业务若使用 PDF 底部原点坐标，应先转换成左上原点。叠层容器不拦截页面事件；可交互元素自行设置 `pointerEvents: 'auto'` 并提供键盘可访问控件。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jc-times/business-ui",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Shared accessible business UI components for JC Times applications",
   "repository": {
     "type": "git",
@@ -36,7 +36,8 @@
     "docs/dependencies.md",
     "patches",
     "licenses/embedpdf-MIT.txt",
-    "docs/sortable-list.md"
+    "docs/sortable-list.md",
+    "assets/pdf-fonts"
   ],
   "main": "./dist/business-ui.js",
   "module": "./dist/business-ui.js",
@@ -78,7 +79,8 @@
     "./pdfium-viewer": {
       "types": "./dist/types/PdfiumViewer.d.ts",
       "import": "./dist/pdfium-viewer.js"
-    }
+    },
+    "./pdf-fonts/*": "./assets/pdf-fonts/*"
   },
   "bin": {
     "business-ui-gate": "./bin/business-ui-gate.mjs"
@@ -93,6 +95,8 @@
   "dependencies": {
     "@embedpdf/core": "2.15.0",
     "@embedpdf/engines": "2.15.0",
+    "@embedpdf/fonts-latin": "1.0.0",
+    "@embedpdf/fonts-sc": "1.0.0",
     "@embedpdf/plugin-document-manager": "2.15.0",
     "@embedpdf/plugin-interaction-manager": "2.15.0",
     "@embedpdf/plugin-render": "2.15.0",