@embedpdf/viewer-chrome 3.0.0-next.11 → 3.0.0-next.12

package/dist/index.js

@@ -8,18 +8,20 @@ import { pageEditPlugin } from "@embedpdf/react/page-edit";
 import { InteractionToken, InteractionToken as InteractionToken$1, feedbackPlugin, interactionPlugin, useTool, useToolCursor, vibrationFeedback } from "@embedpdf/react/interaction";
 import { SelectionClipboard, SelectionHandles, SelectionLayer, SelectionMenu, SelectionToken, selectionPlugin } from "@embedpdf/react/selection";
 import { AnnotationLayer, AnnotationToken, AnnotationToken as AnnotationToken$1, annotationPlugin, refKey, useAnnotation, useAnnotationDefaults, useAnnotationSelected, useAnnotationSelection, useCommentThreads, useComments, useCommentsHydration, useFilePickerProvider, useSelectionFlags, useSelectionProps } from "@embedpdf/react/annotation";
+import { StampToken, indexedDbByteStore, persistStampLibraries, restoreStampLibraries, stampPlugin, useArmStampAsset, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries } from "@embedpdf/react/stamp";
 import { RedactionToken, RedactionToken as RedactionToken$1, redactionPlugin, usePendingRedactions, useRedaction } from "@embedpdf/react/redaction";
 import { actionsPlugin, useActionsUiAdapter } from "@embedpdf/react/actions";
 import { FormToken, formPlugin, formWidgetRenderer } from "@embedpdf/react/form";
 import { LinkLayer, linkPlugin } from "@embedpdf/react/link";
 import { SearchLayer, SearchToken, SearchToken as SearchToken$1, searchPlugin, useSearch, useSearchState, validateSearchQuery } from "@embedpdf/react/search";
-import { I18nToken, i18nPlugin, negotiateLocale, useT } from "@embedpdf/react/i18n";
+import { I18nToken, i18nPlugin, negotiateLocale, useLocale, useT } from "@embedpdf/react/i18n";
 import { CommandsToken, CommandsToken as CommandsToken$1, commandsPlugin, resolvedCommandsEqual, useCommand, useCommandShortcuts, useCommands } from "@embedpdf/react/commands";
 import { ShellToken, ShellToken as ShellToken$1, shellPlugin, useMenus, useSurface } from "@embedpdf/react/shell";
 import { Toolbar, addItem, chromeHelpers, chromeHelpers as chromeHelpers$1, custom, defineChrome, group, item, removeItems, replaceItem, useStripView, validateChrome, validateChrome as validateChrome$1 } from "@embedpdf/react/toolbar";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { Scrollbar } from "@embedpdf/react/scrollbar";
 import { AnnotationMenu } from "@embedpdf/react/annotation-menu";
+import { LOCALES, loadDefaultLibrary } from "@embedpdf/default-stamps/library";
 import { MetadataToken } from "@embedpdf/react/metadata";
 //#region src/config/stage.ts
 /**
@@ -34,24 +36,23 @@ const ThumbsStageToken = createCapabilityToken("stage-thumbs");
 //#endregion
 //#region src/config/demo-tools.plugin.ts
 /**
-* Example-only: register the insert / redact authoring tools as INERT
-* interaction tools. v3 doesn't yet ship signature or redaction plugins, but
-* this is a CHROME demo — its job is selection state and layout, not the
-* tool's effect. Registering them as real (behaviourless) tools lets every
-* tool button in every mode band go through the SAME path
-* (`InteractionToken.activateTool`), so `active` is uniform and honest: the
-* button really is the active tool; it just has no handler behind it.
+* Example-only: register the still-unimplemented authoring tools as INERT
+* interaction tools. v3 doesn't yet ship a signature plugin, but this is a
+* CHROME demo — its job is selection state and layout, not the tool's effect.
+* Registering them as real (behaviourless) tools lets every tool button in
+* every mode band go through the SAME path (`InteractionToken.activateTool`),
+* so `active` is uniform and honest: the button really is the active tool; it
+* just has no handler behind it.
 *
-* The annotate + shapes tools are NOT here — those are real tools the
-* annotation plugin registers (highlight, ink, square, circle, …) — and
-* neither are the form palette tools (the form plugin's draw-to-place).
+* Everything else in the Insert band is REAL now: stamps come from the stamp
+* plugin's libraries (armed by the stamps sidebar), and image/attachment are
+* the annotation plugin's click-then-pick tools. The annotate + shapes tools
+* were never here either — nor the form palette (the form plugin's
+* draw-to-place).
 */
 const INERT_TOOLS = [{
 	id: "signature",
 	cursor: "copy"
-}, {
-	id: "image",
-	cursor: "copy"
 }];
 const demoToolsPlugin = () => definePlugin({
 	id: "demo-tools",
@@ -146,6 +147,7 @@ const en = {
 				delete: "Delete",
 				group: "Group",
 				ungroup: "Ungroup",
+				stampFromSelection: "Make stamp",
 				strip: "Annotation actions"
 			},
 			selection: {
@@ -270,7 +272,23 @@ const en = {
 			redactApplying: "Applying…",
 			redactLabelTitle: "Redaction label",
 			redactLabelPlaceholder: "e.g. REDACTED",
-			redactLabelRepeat: "Repeat label across region"
+			redactLabelRepeat: "Repeat label across region",
+			stampsTitle: "Stamps",
+			stampsAll: "All stamps",
+			stampsLoading: "Loading stamps…",
+			stampsEmpty: "No stamps yet. Import a PDF to turn each of its pages into a stamp.",
+			stampsRemoveStamp: "Remove stamp",
+			stampsArmedHint: "Click a page to place the stamp.",
+			stampsImport: "Import PDF…",
+			stampsImporting: "Importing…",
+			stampsImportHint: "Import a PDF as a stamp library — each page becomes one stamp.",
+			stampsRemoveLibrary: "Remove library",
+			stampsExportLibrary: "Export library as PDF",
+			stampsCustomLibrary: "My stamps",
+			stampsCustomLabel: "Custom stamp",
+			stampsError: "The built-in stamps could not be loaded.",
+			stampsArmError: "That stamp could not be armed.",
+			stampsImportError: "That PDF could not be imported as a stamp library."
 		}
 	}
 };
@@ -287,7 +305,8 @@ const en = {
 */
 const ViewerConfigContext = createContext({
 	chrome: defaultChrome,
-	icons: {}
+	icons: {},
+	stamps: {}
 });
 const ViewerConfigProvider = ViewerConfigContext.Provider;
 function useChromeSchema() {
@@ -302,6 +321,9 @@ function useStripSchema(id) {
 function useCustomIcons() {
 	return useContext(ViewerConfigContext).icons;
 }
+function useStampsConfig() {
+	return useContext(ViewerConfigContext).stamps;
+}
 //#endregion
 //#region src/handle.ts
 function createViewerHandle(kernel) {
@@ -3441,6 +3463,310 @@ function SearchPanel() {
 	});
 }
 //#endregion
+//#region src/config/default-stamps.ts
+/**
+* The viewer's BUILT-IN stamp library: `@embedpdf/default-stamps`, the
+* standard rubber stamps as one Acrobat-compatible PDF per locale.
+*
+* Delivery: the library ships INSIDE whatever ships this viewer. The package
+* exposes each locale as a lazy ES module (`@embedpdf/default-stamps/library`),
+* so it travels through the module graph like any other code — every bundler
+* splits it into a chunk served from the app's own origin, the CDN snippet
+* carries it as a sibling chunk in its folder, and nothing is fetched from a
+* third party. `stamps.defaultLibrary` overrides that:
+*   - `false`          → no built-in library, no request (air-gapped);
+*   - a URL template   → exactly that (`{locale}` slot), for self-hosted copies.
+*
+* Loading is LAZY (first open of the stamps panel, never at boot) and
+* locale-aware: the chrome locale leads, the browser languages break ties
+* for the locales the chrome does not translate itself, and a locale change
+* while a default library is loaded swaps it for the new one. The file names
+* itself (`/Title`, `Id: embedpdf-standard`), so no overrides are passed.
+*/
+/** The built-in library's PieceInfo id — excluded from persistence (it is
+*  loaded again on every first open, in the locale of that moment). */
+const DEFAULT_LIBRARY_ID = "embedpdf-standard";
+/** Which shipped locale to show for the chrome's locale + the browser's. */
+function resolveStampsLocale(chromeLocale) {
+	return negotiateLocale(LOCALES, [chromeLocale, ...typeof navigator !== "undefined" ? navigator.languages ?? [] : []]) ?? "en";
+}
+const fetchBytes = async (url) => {
+	const response = await fetch(url);
+	if (!response.ok) throw new Error(`${url}: HTTP ${response.status}`);
+	return new Uint8Array(await response.arrayBuffer());
+};
+/** The library bytes for `locale`: your URL when you gave one, otherwise the
+*  copy that shipped with the viewer. Never anything else. */
+const defaultLibraryBytes = (locale, source) => source ? fetchBytes(source.replace("{locale}", locale)) : loadDefaultLibrary(locale);
+/** Per workspace: the locale the default library was last brought to, and
+*  the in-flight work — the panel mounts and unmounts with the sidebar, so
+*  this cannot live in component state. */
+const loads = /* @__PURE__ */ new WeakMap();
+/**
+* Bring the built-in library to `locale`. Idempotent per workspace and
+* locale; a locale change swaps the loaded default (remove, then import);
+* a default the user removed in this session stays removed — the locale is
+* recorded, nothing is re-added. An embedder that seeded a library under
+* the same id is left alone.
+*/
+function ensureDefaultLibrary(stamp, locale, source) {
+	if (source === false) return Promise.resolve();
+	const current = loads.get(stamp);
+	if (current?.locale === locale) return current.promise;
+	const run = async () => {
+		await current?.promise.catch(() => void 0);
+		const loaded = stamp.library(DEFAULT_LIBRARY_ID);
+		if (loaded?.locale === locale) return;
+		if (current && !loaded) return;
+		if (loaded) await stamp.removeLibrary(DEFAULT_LIBRARY_ID);
+		await stamp.importLibraryPdf(await defaultLibraryBytes(locale, source));
+	};
+	const promise = run();
+	loads.set(stamp, {
+		locale,
+		promise
+	});
+	return promise;
+}
+//#endregion
+//#region src/ui/stamps-panel.tsx
+/**
+* The stamps sidebar (right panel) — v2's rubber-stamp sidebar on v3 parts.
+* The stamp plugin owns the libraries, the asset bytes and the cached
+* previews; this panel is the PICKER over them:
+*
+*   a library <select> ("All stamps" + one per library, shown once there
+*   are two) → a two-column grid of thumbnails → click a stamp → `armAsset`
+*   arms the annotation plugin's stamp tool → hovering a page ghosts the
+*   exact placement → each click on a page places one.
+*
+* Deliberately NOT a file dialog: picking arbitrary image bytes is the Image
+* tool's job (a click-then-pick tool, `insert:add-image`). The stamp button
+* opens a library; a library is a set of reusable, named assets — the two
+* gestures are different, so they are different controls.
+*
+* The panel stays open while you place, so a stamp can be dropped on several
+* pages and swapped without a round trip through the toolbar. A command can
+* open it ON a library (`annotation:stamp-from-selection` → "My stamps")
+* through the surface's open props.
+*/
+const ALL = "all";
+/** The user's libraries live in the browser (IndexedDB): restored on first
+*  open, written on every change. The built-in set is never stored — it is
+*  fetched again next time, in the locale of that moment. */
+const store = typeof indexedDB === "undefined" ? null : indexedDbByteStore("embedpdf-stamps", { storeName: "libraries" });
+/** Restore runs ONCE per workspace — the panel mounts and unmounts with the
+*  sidebar, so the guard cannot live in component state. */
+const restored = /* @__PURE__ */ new WeakMap();
+const restoreOnce = (stamp) => {
+	let pending = restored.get(stamp);
+	if (!pending) {
+		pending = store ? restoreStampLibraries(stamp, store) : Promise.resolve();
+		restored.set(stamp, pending);
+	}
+	return pending;
+};
+function StampsPanel() {
+	const t = useT();
+	const stamp = useStamp();
+	const libraries = useStampLibraries();
+	const assets = useStampAssets();
+	const { armAsset } = useArmStampAsset();
+	const { activeToolId } = useTool();
+	const { locale } = useLocale();
+	const { defaultLibrary } = useStampsConfig();
+	const surface = useSurface("stamps");
+	const fileRef = useRef(null);
+	const [armedId, setArmedId] = useState(null);
+	const [busy, setBusy] = useState(null);
+	const [error, setError] = useState(null);
+	const [picked, setPicked] = useState(ALL);
+	const openedOn = surface.props?.libraryId;
+	useEffect(() => {
+		if (typeof openedOn === "string") setPicked(openedOn);
+	}, [openedOn]);
+	useEffect(() => {
+		let live = true;
+		setBusy("loading");
+		restoreOnce(stamp).then(() => ensureDefaultLibrary(stamp, resolveStampsLocale(locale), defaultLibrary)).catch((err) => {
+			console.error("[embedpdf] default stamps failed:", err);
+			if (live) setError(t("demo.stampsError"));
+		}).finally(() => live && setBusy(null));
+		return () => {
+			live = false;
+		};
+	}, [stamp, locale]);
+	useEffect(() => store ? persistStampLibraries(stamp, store, { except: [DEFAULT_LIBRARY_ID] }) : void 0, [stamp]);
+	useEffect(() => {
+		if (activeToolId !== "stamp") setArmedId(null);
+	}, [activeToolId]);
+	const arm = (asset) => {
+		setError(null);
+		setArmedId(asset.id);
+		armAsset(asset.id).catch((err) => {
+			console.error("[embedpdf] arm stamp failed:", err);
+			setArmedId(null);
+			setError(t("demo.stampsArmError"));
+		});
+	};
+	const importPdf = (file) => {
+		setError(null);
+		setBusy("importing");
+		stamp.importLibraryPdf(file, { name: file.name.replace(/\.pdf$/i, "") }).then((id) => setPicked(id)).catch((err) => {
+			console.error("[embedpdf] stamp library import failed:", err);
+			setError(t("demo.stampsImportError"));
+		}).finally(() => setBusy(null));
+	};
+	/** The library as the PDF it is — title, registry, artwork — for Acrobat
+	*  or another viewer. */
+	const exportPdf = (libraryId, name) => {
+		const bytes = stamp.exportLibrary(libraryId);
+		if (!bytes) return;
+		const blob = new Blob([bytes], { type: "application/pdf" });
+		const url = URL.createObjectURL(blob);
+		const a = document.createElement("a");
+		a.href = url;
+		a.download = `${name || "stamps"}.pdf`;
+		a.click();
+		URL.revokeObjectURL(url);
+	};
+	const selectedId = libraries.length === 1 ? libraries[0].id : libraries.some((library) => library.id === picked) ? picked : ALL;
+	const selected = selectedId === ALL ? null : libraries.find((l) => l.id === selectedId) ?? null;
+	const shown = selectedId === ALL ? assets : assets.filter((a) => a.libraryId === selectedId);
+	const isDefault = (libraryId) => libraryId === DEFAULT_LIBRARY_ID;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex min-h-0 flex-1 flex-col",
+		children: [
+			libraries.length > 0 && /* @__PURE__ */ jsxs("div", {
+				className: "border-border-subtle flex items-center gap-1 border-b p-2",
+				children: [libraries.length > 1 ? /* @__PURE__ */ jsxs("select", {
+					value: selectedId,
+					onChange: (event) => setPicked(event.target.value),
+					"aria-label": t("demo.stampsTitle"),
+					className: "border-border bg-surface text-fg min-w-0 flex-1 rounded border px-2 py-1.5 text-sm",
+					children: [/* @__PURE__ */ jsx("option", {
+						value: ALL,
+						children: t("demo.stampsAll")
+					}), libraries.map((library) => /* @__PURE__ */ jsx("option", {
+						value: library.id,
+						children: library.name
+					}, library.id))]
+				}) : /* @__PURE__ */ jsx("span", {
+					className: "text-fg-muted min-w-0 flex-1 truncate px-1 text-xs font-semibold uppercase tracking-wide",
+					children: libraries[0].name
+				}), selected && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: () => exportPdf(selected.id, selected.name),
+					title: t("demo.stampsExportLibrary"),
+					className: "text-fg-muted hover:text-fg grid h-7 w-7 shrink-0 place-items-center rounded",
+					children: /* @__PURE__ */ jsx(Icon, {
+						name: "download",
+						size: 14
+					})
+				}), !isDefault(selected.id) && /* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: () => void stamp.removeLibrary(selected.id),
+					title: t("demo.stampsRemoveLibrary"),
+					className: "text-fg-muted hover:text-fg grid h-7 w-7 shrink-0 place-items-center rounded",
+					children: /* @__PURE__ */ jsx(Icon, {
+						name: "trash",
+						size: 14
+					})
+				})] })]
+			}),
+			/* @__PURE__ */ jsx("div", {
+				className: "min-h-0 flex-1 overflow-y-auto p-3",
+				children: busy === "loading" && shown.length === 0 ? /* @__PURE__ */ jsxs("div", {
+					className: "flex flex-col items-center gap-3 px-4 py-10 text-center",
+					children: [/* @__PURE__ */ jsx("div", { className: "border-border-subtle border-t-accent h-6 w-6 animate-spin rounded-full border-2" }), /* @__PURE__ */ jsx("p", {
+						className: "text-fg-muted text-sm",
+						children: t("demo.stampsLoading")
+					})]
+				}) : shown.length === 0 ? /* @__PURE__ */ jsxs("div", {
+					className: "flex flex-col items-center gap-3 px-4 py-10 text-center",
+					children: [/* @__PURE__ */ jsx(Icon, {
+						name: "rubberStamp",
+						size: 32,
+						className: "text-fg-muted"
+					}), /* @__PURE__ */ jsx("p", {
+						className: "text-fg-muted text-sm",
+						children: t("demo.stampsEmpty")
+					})]
+				}) : /* @__PURE__ */ jsx("ul", {
+					className: "grid grid-cols-2 gap-3",
+					children: shown.map((asset) => /* @__PURE__ */ jsxs("li", {
+						className: "group relative",
+						children: [/* @__PURE__ */ jsx(StampAssetCell, {
+							asset,
+							armed: armedId === asset.id,
+							onArm: () => arm(asset)
+						}), !isDefault(asset.libraryId) && /* @__PURE__ */ jsx("button", {
+							type: "button",
+							onClick: () => void stamp.removeAsset(asset.id),
+							title: t("demo.stampsRemoveStamp"),
+							className: "bg-surface border-border text-fg-muted hover:text-fg absolute right-1 top-1 grid h-5 w-5 place-items-center rounded-full border opacity-0 shadow-sm focus:opacity-100 group-hover:opacity-100",
+							children: /* @__PURE__ */ jsx(Icon, {
+								name: "x",
+								size: 12
+							})
+						})]
+					}, asset.id))
+				})
+			}),
+			(error || armedId) && /* @__PURE__ */ jsx("div", {
+				className: `border-border-subtle shrink-0 border-t px-3 py-2 text-xs ${error ? "text-red-600" : "text-fg-muted"}`,
+				children: error ?? t("demo.stampsArmedHint")
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "border-border-subtle shrink-0 border-t p-3",
+				children: [/* @__PURE__ */ jsxs("button", {
+					type: "button",
+					disabled: busy != null,
+					onClick: () => fileRef.current?.click(),
+					title: t("demo.stampsImportHint"),
+					className: "border-border text-fg hover:bg-hover flex w-full items-center justify-center gap-2 rounded-md border px-3 py-1.5 text-sm disabled:opacity-40",
+					children: [/* @__PURE__ */ jsx(Icon, {
+						name: "rubberStampPlus",
+						size: 16
+					}), busy === "importing" ? t("demo.stampsImporting") : t("demo.stampsImport")]
+				}), /* @__PURE__ */ jsx("input", {
+					ref: fileRef,
+					type: "file",
+					accept: "application/pdf",
+					className: "hidden",
+					onChange: (e) => {
+						const file = e.currentTarget.files?.[0];
+						e.currentTarget.value = "";
+						if (file) importPdf(file);
+					}
+				})]
+			})
+		]
+	});
+}
+/** One grid cell: the plugin's cached preview through the object-URL hook
+*  (the DOM resource's lifetime belongs to the framework layer, not the
+*  store). Image only, as v2 — the artwork IS the label; the label is the
+*  tooltip for the curious. */
+function StampAssetCell({ asset, armed, onArm }) {
+	const url = useStampAssetPreviewUrl(asset.id);
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		onClick: onArm,
+		title: asset.label,
+		"aria-pressed": armed,
+		className: `flex aspect-square w-full items-center justify-center rounded-md border p-2 ${armed ? "border-accent bg-accent-light ring-accent ring-2" : "border-border-subtle hover:border-border hover:bg-hover"}`,
+		children: url ? /* @__PURE__ */ jsx("img", {
+			src: url,
+			alt: asset.label,
+			className: "max-h-full max-w-full object-contain"
+		}) : /* @__PURE__ */ jsx("span", {
+			className: "text-fg truncate text-sm",
+			children: asset.label
+		})
+	});
+}
+//#endregion
 //#region src/ui/panels.tsx
 /**
 * The static chrome around the toolbars: the left/right sidebars (shell
@@ -3534,10 +3860,11 @@ function RightSidebar() {
 	const comment = useSurface("comment");
 	const style = useSurface("annotation-style");
 	const redaction = useSurface("redaction");
-	const active = search.isOpen ? "search" : comment.isOpen ? "comment" : style.isOpen ? "style" : redaction.isOpen ? "redaction" : null;
+	const stamps = useSurface("stamps");
+	const active = search.isOpen ? "search" : comment.isOpen ? "comment" : style.isOpen ? "style" : redaction.isOpen ? "redaction" : stamps.isOpen ? "stamps" : null;
 	if (!active) return null;
-	const titleKey = active === "search" ? "demo.searchTitle" : active === "comment" ? "demo.commentsTitle" : active === "redaction" ? "demo.redactionTitle" : "demo.styleTitle";
-	const close = active === "search" ? search.close : active === "comment" ? comment.close : active === "redaction" ? redaction.close : style.close;
+	const titleKey = active === "search" ? "demo.searchTitle" : active === "comment" ? "demo.commentsTitle" : active === "redaction" ? "demo.redactionTitle" : active === "stamps" ? "demo.stampsTitle" : "demo.styleTitle";
+	const close = active === "search" ? search.close : active === "comment" ? comment.close : active === "redaction" ? redaction.close : active === "stamps" ? stamps.close : style.close;
 	return /* @__PURE__ */ jsxs("aside", {
 		className: "border-border-subtle bg-surface flex w-72 shrink-0 flex-col border-l",
 		children: [/* @__PURE__ */ jsxs("div", {
@@ -3554,7 +3881,7 @@ function RightSidebar() {
 					size: 16
 				})
 			})]
-		}), active === "style" ? /* @__PURE__ */ jsx(AnnotationStylePanel, {}) : active === "search" ? /* @__PURE__ */ jsx(SearchPanel, {}, documentId ?? "none") : active === "redaction" ? /* @__PURE__ */ jsx(RedactionPanel, {}) : /* @__PURE__ */ jsx(CommentsPanel, {}, documentId ?? "none")]
+		}), active === "style" ? /* @__PURE__ */ jsx(AnnotationStylePanel, {}) : active === "search" ? /* @__PURE__ */ jsx(SearchPanel, {}, documentId ?? "none") : active === "redaction" ? /* @__PURE__ */ jsx(RedactionPanel, {}) : active === "stamps" ? /* @__PURE__ */ jsx(StampsPanel, {}) : /* @__PURE__ */ jsx(CommentsPanel, {}, documentId ?? "none")]
 	});
 }
 function PageControls() {
@@ -3954,7 +4281,7 @@ function Shell() {
 * changing these props on a mounted viewer does not rebuild the workspace.
 */
 /** Lazy built-in packs — a strings override for one of these wraps its loader. */
-const BUILTIN_LOADERS = { es: () => import("./es-aQlZ3hcL.js").then((m) => m.es) };
+const BUILTIN_LOADERS = { es: () => import("./es-DT5ZoB99.js").then((m) => m.es) };
 const isDict = (v) => typeof v === "object" && v !== null;
 /**
 * Deep-merge `over` into `base` (immutably), expanding dotted keys —
@@ -3998,7 +4325,7 @@ function Booting() {
 		})
 	});
 }
-function FullViewer({ engine, initialDocuments, fallback, commands, icons, strings, locale = "auto", disabledCategories, chrome, theme, themeTarget, onViewer }) {
+function FullViewer({ engine, initialDocuments, fallback, commands, icons, strings, locale = "auto", disabledCategories, chrome, stamps, theme, themeTarget, onViewer }) {
 	const [resolved] = useState(() => {
 		const byId = new Map(defaultCommands.map((c) => [c.id, c]));
 		for (const c of commands ?? []) byId.set(c.id, c);
@@ -4029,6 +4356,7 @@ function FullViewer({ engine, initialDocuments, fallback, commands, icons, strin
 			commands: resolvedCommands,
 			chrome: resolvedChrome,
 			icons: icons ?? {},
+			stamps: stamps ?? {},
 			i18n: {
 				locales,
 				loaders,
@@ -4077,8 +4405,22 @@ function FullViewer({ engine, initialDocuments, fallback, commands, icons, strin
 				start: "none",
 				end: "open-arrow"
 			} }
+		}, {
+			id: "image",
+			extends: "stamp",
+			source: {
+				kind: "prompt",
+				accept: "image/png,image/jpeg"
+			}
 		}] }),
-		actionsPlugin({ javascript: { enabled: true } }),
+		stampPlugin(),
+		actionsPlugin({ javascript: {
+			enabled: true,
+			identity: {
+				name: "John Doe",
+				corporation: "Acme Inc"
+			}
+		} }),
 		formPlugin(),
 		linkPlugin(),
 		redactionPlugin(),
@@ -4113,6 +4455,6 @@ function FullViewer({ engine, initialDocuments, fallback, commands, icons, strin
 	});
 }
 //#endregion
-export { AnnotationToken, CommandsToken, DocumentsToken, FormToken, FullViewer, I18nToken, InteractionToken, MetadataToken, RedactionToken, SearchToken, SelectionToken, ShellToken, StageToken, addItem, chromeHelpers, createViewerHandle, custom, defaultChrome, defaultCommands, ICON_PATHS as defaultIcons, defineChrome, group, item, removeItems, replaceItem, themeConfigOf, validateChrome };
+export { AnnotationToken, CommandsToken, DocumentsToken, FormToken, FullViewer, I18nToken, InteractionToken, MetadataToken, RedactionToken, SearchToken, SelectionToken, ShellToken, StageToken, StampToken, addItem, chromeHelpers, createViewerHandle, custom, defaultChrome, defaultCommands, ICON_PATHS as defaultIcons, defineChrome, group, item, removeItems, replaceItem, themeConfigOf, validateChrome };
 
 //# sourceMappingURL=index.js.map