@embedpdf/react 3.0.0-next.14 → 3.0.0-next.16

package/dist/runtime.cjs

@@ -1,327 +1,50 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_rolldown_runtime = require("./rolldown-runtime-DDXJien1.cjs");
-let react_jsx_runtime = require("react/jsx-runtime");
-let _embedpdf_core = require("@embedpdf/core");
-let react = require("react");
-react = require_rolldown_runtime.__toESM(react, 1);
-//#region src/runtime.tsx
-const KernelCtx = (0, react.createContext)(null);
-/** The document a subtree is bound to. null => use the active document. */
-const DocumentScopeCtx = (0, react.createContext)(null);
-function useKernel() {
-	const k = (0, react.useContext)(KernelCtx);
-	if (!k) throw new Error("useKernel must be used within <Viewer>/<EmbedPDF>");
-	return k;
-}
-const shallowArray = (a, b) => a === b || a.length === b.length && a.every((x, i) => x === b[i]);
-/** Read a value derived from the kernel, cached by equality (no tearing loop). */
-function useKernelValue(select, isEqual = Object.is) {
-	const kernel = useKernel();
-	const last = (0, react.useRef)(null);
-	const get = () => {
-		const next = select(kernel);
-		if (last.current && isEqual(last.current.v, next)) return last.current.v;
-		last.current = { v: next };
-		return next;
-	};
-	return (0, react.useSyncExternalStore)(kernel.subscribe, get, get);
-}
-function useActiveDocumentId() {
-	return useKernelValue((k) => k.documents.activeId());
-}
-/** The document id for this subtree: the nearest <DocumentScope>, else the active doc. */
-function useDocumentId() {
-	const scoped = (0, react.useContext)(DocumentScopeCtx);
-	const active = useActiveDocumentId();
-	return scoped ?? active;
-}
-/** Bind a subtree to a specific document (panes, comparison). */
-function DocumentScope({ id, children }) {
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DocumentScopeCtx.Provider, {
-		value: id,
-		children
-	});
-}
-/**
-* Render children only while this subtree has a READY document — the
-* structural way to say "this UI is defined over a document". An empty
-* workspace is a legitimate, designable state (the Viewer no longer blocks on
-* documents so chrome can render at t≈0): workspace-scoped UI (toolbars,
-* commands, i18n) lives OUTSIDE the gate; document-scoped UI (Stage, panels,
-* page chrome) lives inside it, or reads through `useOptionalSelector`.
-* A `loading`/`locked`/`error` tab renders `fallback` — so the gate's
-* fallback doubles as the per-tab boot state; richer chrome (a password
-* prompt, an error pane) branches on `useDocumentStatus()` beside the gate.
-* Sibling of <DocumentScope>, which picks WHICH document; this one handles
-* WHETHER.
-*/
-function DocumentGate({ fallback = null, children }) {
-	const docId = useDocumentId();
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: useKernelValue((k) => docId ? k.documents.get(docId)?.status === "ready" : false) ? children : fallback });
-}
-/** Lifecycle status of this subtree's document (loading/locked/ready/error),
-*  or null with no document. The password prompt and error panes key off it. */
-function useDocumentStatus() {
-	const docId = useDocumentId();
-	return useKernelValue((k) => docId ? k.documents.get(docId)?.status ?? null : null);
-}
-/**
-* Resolve a capability by token, binding document-scoped ones to this
-* subtree's document. Resolution is a REACTIVE read (`tryCapability` through
-* the kernel's one change stream), not a memoized call — under the
-* request-time lifecycle a document can become resolvable while its id stays
-* the same, so any id-keyed cache goes stale; subscribing makes staleness
-* structurally impossible. Fail-fast: while unresolvable, this re-runs the
-* strict resolver so the kernel's truthful reason (`no capability` / `no
-* document` / `document is loading|locked`) is what throws.
-*/
-function useCapability(token) {
-	const kernel = useKernel();
-	const scoped = (0, react.useContext)(DocumentScopeCtx);
-	return useKernelValue((k) => k.tryCapability(token, scoped ?? void 0)) ?? kernel.capability(token, scoped ?? void 0);
-}
-/** Like `useCapability`, but null while the token can't resolve (no plugin,
-*  no document, or a document that isn't ready yet). */
-function useOptionalCapability(token) {
-	const scoped = (0, react.useContext)(DocumentScopeCtx);
-	return useKernelValue((k) => k.tryCapability(token, scoped ?? void 0));
-}
-/** Subscribe to a selector over a (document-resolved) capability. */
-function useSelector(token, select, isEqual = Object.is) {
-	const kernel = useKernel();
-	const cap = useCapability(token);
-	const last = (0, react.useRef)(null);
-	const get = () => {
-		const next = select(cap);
-		if (last.current && isEqual(last.current.v, next)) return last.current.v;
-		last.current = { v: next };
-		return next;
-	};
-	return (0, react.useSyncExternalStore)(kernel.subscribe, get, get);
-}
-/**
-* Null-safe `useSelector`: `fallback` whenever the token can't resolve — no
-* provider, or a document-scoped token with no document. For chrome that stays
-* mounted across the empty-workspace state (a zoom readout, a mode band).
-* `useSelector` stays strict (fail-fast) for code that KNOWS a document exists
-* — e.g. anything inside a <DocumentGate>.
-*
-* The `select` guard also swallows reads through a capability whose document
-* closed between the store notification and this render — that teardown race
-* resolves to `fallback` for one frame, then re-renders against the new state.
-*/
-function useOptionalSelector(token, select, fallback, isEqual = Object.is) {
-	const kernel = useKernel();
-	const cap = useOptionalCapability(token);
-	const last = (0, react.useRef)(null);
-	const get = () => {
-		let next;
-		if (cap === null) next = fallback;
-		else try {
-			next = select(cap);
-		} catch {
-			next = fallback;
-		}
-		if (last.current && isEqual(last.current.v, next)) return last.current.v;
-		last.current = { v: next };
-		return next;
-	};
-	return (0, react.useSyncExternalStore)(kernel.subscribe, get, get);
-}
-/**
-* Subscribe to a capability's {@link EventHook} for the mounted lifetime —
-* `useCapabilityEvent(ActionsToken, (c) => c.onAction, handler)`. Events
-* carry occurrences, never state (a late subscriber that needs the current
-* value uses `useSelector`). The handler rides a ref, so a fresh closure per
-* render never resubscribes. Null-safe: no plugin/document → no subscription.
-*/
-function useCapabilityEvent(token, select, handler) {
-	const cap = useOptionalCapability(token);
-	const handlerRef = (0, react.useRef)(handler);
-	handlerRef.current = handler;
-	const selectRef = (0, react.useRef)(select);
-	selectRef.current = select;
-	(0, react.useEffect)(() => {
-		if (!cap) return;
-		return selectRef.current(cap)((event) => handlerRef.current(event));
-	}, [cap]);
-}
-/** The document registry (open/close/active/list), reactive. */
-function useDocuments() {
-	const kernel = useKernel();
-	return {
-		docs: useKernelValue((k) => k.documents.list(), _embedpdf_core.docInfoListEquals),
-		activeId: useActiveDocumentId(),
-		open: kernel.documents.open,
-		unlock: kernel.documents.unlock,
-		close: kernel.documents.close,
-		setActive: kernel.documents.setActive,
-		move: kernel.documents.move,
-		swap: kernel.documents.swap,
-		download: kernel.documents.download,
-		downloadLayer: kernel.documents.downloadLayer
-	};
-}
-/**
-* Owns the kernel as an EFFECT-scoped resource: each effect setup creates and
-* starts exactly one kernel; each cleanup destroys exactly that one. That is
-* the contract StrictMode exercises (two kernels in dev, the first fully
-* destroyed) — the kernel itself is never restarted after destroy.
-*
-* The kernel is published to context the moment it exists — before `start()`
-* resolves — so the `fallback` can use workspace capabilities (i18n copy on a
-* loading screen) exactly as before. The one exception is the very first
-* render, which happens before the effect: it renders nothing. Children mount
-* once `start()` resolves — which never touches the engine, so the shell is
-* alive while WASM compiles or the transport connects. `initialDocuments`
-* open in the BACKGROUND and stream into the registry (`useDocuments()` is
-* reactive); per-document loading UI is the Stage's job, not a root gate.
-*
-* ENGINE OWNERSHIP. When `engine` is a thunk, the Viewer OWNS it: each effect
-* setup constructs one engine (construction is synchronous and inert — boot
-* happens lazily inside the engine) and each cleanup destroys exactly that one
-* — after the kernel, so handles close first. When `engine` is an instance it
-* is BORROWED and never destroyed here; the Viewer only calls `warmup?.()` so
-* the WASM/transport boot overlaps plugin initialization. StrictMode's
-* double-mount therefore constructs two independent thunk engines and tears
-* the first fully down, matching the kernel's own effect-scoped lifecycle.
-* That means dev-only double resource use (two worker spawns, two font
-* fetches, briefly overlapping) — deliberate, because it is exactly the
-* leak-detection contract StrictMode exists to exercise; production mounts
-* once and boots once.
-*/
-function Viewer({ engine, plugins, initialDocuments, fallback, renderError, children }) {
-	const initial = (0, react.useRef)({
-		engine,
-		plugins,
-		initialDocuments
-	});
-	const warned = (0, react.useRef)(false);
-	if (process.env.NODE_ENV !== "production" && !warned.current) {
-		if (initial.current.engine !== engine || initial.current.plugins !== plugins) {
-			warned.current = true;
-			console.warn("[embedpdf] <Viewer> engine/plugins are init-only. A changed identity is ignored — pass stable references (module scope, useState, or useMemo). An inline `plugins={[...]}` array recreates its identity every render.");
-		}
+const require_runtime = require("./runtime-BfnpyfY0.cjs");
+let _embedpdf_web = require("@embedpdf/web");
+exports.DocumentGate = require_runtime.DocumentGate;
+exports.DocumentScope = require_runtime.DocumentScope;
+exports.EmbedPDF = require_runtime.EmbedPDF;
+exports.KernelProvider = require_runtime.KernelProvider;
+exports.PageProvider = require_runtime.PageProvider;
+exports.Viewer = require_runtime.Viewer;
+exports.epdfTheme = require_runtime.epdfTheme;
+Object.defineProperty(exports, "makePageContext", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_web.makePageContext;
 	}
-	const [boot, setBoot] = (0, react.useState)({
-		phase: "booting",
-		kernel: null
-	});
-	(0, react.useEffect)(() => {
-		const captured = initial.current;
-		const ownsEngine = typeof captured.engine === "function";
-		const engine = ownsEngine ? captured.engine() : captured.engine;
-		engine.warmup?.();
-		let kernel;
-		try {
-			kernel = (0, _embedpdf_core.createKernel)({
-				engine,
-				plugins: captured.plugins
-			});
-		} catch (error) {
-			setBoot({
-				phase: "error",
-				error
-			});
-			if (ownsEngine) engine.destroy();
-			return;
-		}
-		let alive = true;
-		setBoot({
-			phase: "booting",
-			kernel
-		});
-		kernel.start().then(() => {
-			if (!alive) return;
-			setBoot({
-				phase: "ready",
-				kernel
-			});
-			kernel.documents.openAll(captured.initialDocuments ?? []);
-		}, (error) => {
-			if (alive) setBoot({
-				phase: "error",
-				error
-			});
-		});
-		return () => {
-			alive = false;
-			kernel.destroy().then(() => {
-				if (ownsEngine) engine.destroy();
-			});
-		};
-	}, []);
-	if (boot.phase === "error") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: renderError ? renderError(boot.error) : null });
-	if (!boot.kernel) return null;
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(KernelCtx.Provider, {
-		value: boot.kernel,
-		children: boot.phase === "ready" ? children : fallback ?? null
-	});
-}
-const EmbedPDF = Viewer;
-const PageCtx = (0, react.createContext)(null);
-const PageProvider = PageCtx.Provider;
-function usePage() {
-	const c = (0, react.useContext)(PageCtx);
-	if (!c) throw new Error("usePage must be used inside <PageView> or a <Stage> page");
-	return c;
-}
-function makePageContext(documentId, view, pon, pageIndex, frame, transform, getRect, getViewDemand) {
-	return {
-		documentId,
-		view,
-		pon,
-		pageIndex,
-		frame,
-		transform,
-		...getViewDemand ? { getViewDemand } : {},
-		toContentPoint: (cx, cy) => {
-			const r = getRect();
-			return transform.viewToContent({
-				x: cx - r.left,
-				y: cy - r.top
-			});
-		},
-		toClientPoint: (p) => {
-			const r = getRect();
-			const v = transform.contentToView(p);
-			return {
-				x: r.left + v.x,
-				y: r.top + v.y
-			};
-		},
-		toClientRect: (rect) => {
-			const r = getRect();
-			const v = transform.contentToViewRect(rect);
-			return {
-				x: r.left + v.x,
-				y: r.top + v.y,
-				width: v.width,
-				height: v.height
-			};
-		}
-	};
-}
-//#endregion
-exports.DocumentGate = DocumentGate;
-exports.DocumentScope = DocumentScope;
-exports.EmbedPDF = EmbedPDF;
-exports.PageProvider = PageProvider;
-exports.Viewer = Viewer;
-exports.makePageContext = makePageContext;
-exports.shallowArray = shallowArray;
-exports.useActiveDocumentId = useActiveDocumentId;
-exports.useCapability = useCapability;
-exports.useCapabilityEvent = useCapabilityEvent;
-exports.useDocumentId = useDocumentId;
-exports.useDocumentStatus = useDocumentStatus;
-exports.useDocuments = useDocuments;
-exports.useKernel = useKernel;
-exports.useKernelValue = useKernelValue;
-exports.useOptionalCapability = useOptionalCapability;
-exports.useOptionalSelector = useOptionalSelector;
-exports.usePage = usePage;
-exports.useSelector = useSelector;
+});
+Object.defineProperty(exports, "mountWebFont", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_web.mountWebFont;
+	}
+});
+Object.defineProperty(exports, "saveFile", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_web.saveFile;
+	}
+});
+exports.shallowArray = require_runtime.shallowArray;
+exports.useActiveDocumentId = require_runtime.useActiveDocumentId;
+exports.useCapability = require_runtime.useCapability;
+exports.useCapabilityEvent = require_runtime.useCapabilityEvent;
+exports.useDocument = require_runtime.useDocument;
+exports.useDocumentId = require_runtime.useDocumentId;
+exports.useDocumentScope = require_runtime.useDocumentScope;
+exports.useDocuments = require_runtime.useDocuments;
+exports.useDocumentsEvent = require_runtime.useDocumentsEvent;
+exports.useDocumentsState = require_runtime.useDocumentsState;
+exports.useKernel = require_runtime.useKernel;
+exports.useKernelValue = require_runtime.useKernelValue;
+exports.useOptionalCapability = require_runtime.useOptionalCapability;
+exports.useOptionalSelector = require_runtime.useOptionalSelector;
+exports.usePage = require_runtime.usePage;
+exports.usePageList = require_runtime.usePageList;
+exports.useSelector = require_runtime.useSelector;
+exports.useViewerSettings = require_runtime.useViewerSettings;
+var _embedpdf_core = require("@embedpdf/core");
 Object.keys(_embedpdf_core).forEach(function(k) {
 	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,
@@ -330,5 +53,3 @@ Object.keys(_embedpdf_core).forEach(function(k) {
 		}
 	});
 });
-
-//# sourceMappingURL=runtime.cjs.map

package/dist/runtime.d.cts

@@ -1,3 +1,3 @@
-import { C as usePage, S as useOptionalSelector, _ as useDocumentStatus, a as EmbedPDF, b as useKernelValue, c as Viewer, f as shallowArray, g as useDocumentId, h as useCapabilityEvent, i as DocumentScopeProps, l as ViewerProps, m as useCapability, n as DocumentGateProps, o as PageContextValue, p as useActiveDocumentId, r as DocumentScope, s as PageProvider, t as DocumentGate, u as makePageContext, v as useDocuments, w as useSelector, x as useOptionalCapability, y as useKernel } from "./runtime-umHA_xHt.cjs";
+import { A as usePageList, C as useDocumentsEvent, D as useOptionalCapability, E as useKernelValue, M as useViewerSettings, N as EpdfTheme, O as useOptionalSelector, P as epdfTheme, S as useDocuments, T as useKernel, _ as useCapability, a as EmbedPDF, b as useDocumentId, c as PageContextValue, d as ViewerProps, f as makePageContext, g as useActiveDocumentId, h as shallowArray, i as DocumentScopeProps, j as useSelector, k as usePage, l as PageProvider, m as saveFile, n as DocumentGateProps, o as KernelProvider, p as mountWebFont, r as DocumentScope, s as KernelProviderProps, t as DocumentGate, u as Viewer, v as useCapabilityEvent, w as useDocumentsState, x as useDocumentScope, y as useDocument } from "./runtime-DBEBlpQV.cjs";
 export * from "@embedpdf/core";
-export { DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, PageContextValue, PageProvider, Viewer, ViewerProps, makePageContext, shallowArray, useActiveDocumentId, useCapability, useCapabilityEvent, useDocumentId, useDocumentStatus, useDocuments, useKernel, useKernelValue, useOptionalCapability, useOptionalSelector, usePage, useSelector };
+export { DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, type EpdfTheme, KernelProvider, KernelProviderProps, PageContextValue, PageProvider, Viewer, ViewerProps, epdfTheme, makePageContext, mountWebFont, saveFile, shallowArray, useActiveDocumentId, useCapability, useCapabilityEvent, useDocument, useDocumentId, useDocumentScope, useDocuments, useDocumentsEvent, useDocumentsState, useKernel, useKernelValue, useOptionalCapability, useOptionalSelector, usePage, usePageList, useSelector, useViewerSettings };

package/dist/runtime.d.ts

@@ -1,3 +1,3 @@
-import { C as usePage, S as useOptionalSelector, _ as useDocumentStatus, a as EmbedPDF, b as useKernelValue, c as Viewer, f as shallowArray, g as useDocumentId, h as useCapabilityEvent, i as DocumentScopeProps, l as ViewerProps, m as useCapability, n as DocumentGateProps, o as PageContextValue, p as useActiveDocumentId, r as DocumentScope, s as PageProvider, t as DocumentGate, u as makePageContext, v as useDocuments, w as useSelector, x as useOptionalCapability, y as useKernel } from "./runtime-DE76hlnl.js";
+import { A as usePageList, C as useDocumentsEvent, D as useOptionalCapability, E as useKernelValue, M as useViewerSettings, N as EpdfTheme, O as useOptionalSelector, P as epdfTheme, S as useDocuments, T as useKernel, _ as useCapability, a as EmbedPDF, b as useDocumentId, c as PageContextValue, d as ViewerProps, f as makePageContext, g as useActiveDocumentId, h as shallowArray, i as DocumentScopeProps, j as useSelector, k as usePage, l as PageProvider, m as saveFile, n as DocumentGateProps, o as KernelProvider, p as mountWebFont, r as DocumentScope, s as KernelProviderProps, t as DocumentGate, u as Viewer, v as useCapabilityEvent, w as useDocumentsState, x as useDocumentScope, y as useDocument } from "./runtime-V3MVMb91.js";
 export * from "@embedpdf/core";
-export { DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, PageContextValue, PageProvider, Viewer, ViewerProps, makePageContext, shallowArray, useActiveDocumentId, useCapability, useCapabilityEvent, useDocumentId, useDocumentStatus, useDocuments, useKernel, useKernelValue, useOptionalCapability, useOptionalSelector, usePage, useSelector };
+export { DocumentGate, DocumentGateProps, DocumentScope, DocumentScopeProps, EmbedPDF, type EpdfTheme, KernelProvider, KernelProviderProps, PageContextValue, PageProvider, Viewer, ViewerProps, epdfTheme, makePageContext, mountWebFont, saveFile, shallowArray, useActiveDocumentId, useCapability, useCapabilityEvent, useDocument, useDocumentId, useDocumentScope, useDocuments, useDocumentsEvent, useDocumentsState, useKernel, useKernelValue, useOptionalCapability, useOptionalSelector, usePage, usePageList, useSelector, useViewerSettings };