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

package/dist/index.js

@@ -8,18 +8,23 @@ 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, StampToken as StampToken$1, 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 { FormToken, FormToken as FormToken$1, formPlugin, formWidgetRenderer } from "@embedpdf/react/form";
+import { INITIALS_MARK_NAME, SIGNATURES_LIBRARY_KIND, SIGNATURE_MARK_NAME, SignatureToken, createTestSigner, indexedDbKeyStore, memoryKeyStore, personalSigner, remoteSigner, signaturePlugin, useSignature, useSignatureEvent, useSignatureSnapshot, useSignatureTarget, useSignatureVerdicts, useSignerRows, webCryptoSigner } from "@embedpdf/react/signature";
 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 { ShellToken, ShellToken as ShellToken$1, shellPlugin, useMenus, useShell, 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 { LOCALES, loadDefaultLibrary } from "@embedpdf/default-stamps/library";
+import { mountWebFont } from "@embedpdf/web";
 import { AnnotationMenu } from "@embedpdf/react/annotation-menu";
+import { Anchored } from "@embedpdf/react/anchored";
 import { MetadataToken } from "@embedpdf/react/metadata";
 //#region src/config/stage.ts
 /**
@@ -34,24 +39,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 +150,7 @@ const en = {
 				delete: "Delete",
 				group: "Group",
 				ungroup: "Ungroup",
+				stampFromSelection: "Make stamp",
 				strip: "Annotation actions"
 			},
 			selection: {
@@ -171,7 +176,8 @@ const en = {
 				checkbox: "Checkbox",
 				radio: "Radio Button",
 				select: "Dropdown",
-				listbox: "List Box"
+				listbox: "List Box",
+				signature: "Signature Field"
 			},
 			redact: {
 				mark: "Mark for Redaction",
@@ -268,9 +274,91 @@ const en = {
 			redactConfirmCollateral: "{count} other annotations will also be removed.",
 			redactApply: "Apply",
 			redactApplying: "Applying…",
+			formatLabel: "Format",
 			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.",
+			quickStampsLabel: "Quick stamps",
+			signaturesTitle: "Signatures",
+			signaturesEmpty: "No signatures yet. Create one to sign with.",
+			signaturesNew: "New signature…",
+			signaturesArmedHint: "Click a signature field to sign it, or anywhere on a page to place the mark.",
+			signaturesTargetHint: "Pick a mark for the selected field.",
+			signaturesInDocument: "In this document",
+			signaturesNone: "This document has no signature fields.",
+			signaturesValidate: "Validate",
+			signaturesValidating: "Validating…",
+			signaturesSigned: "Signed",
+			signaturesUnsigned: "Unsigned",
+			signaturesRename: "Rename",
+			signaturesRemove: "Remove",
+			signaturesExport: "Export as PDF",
+			signaturesAddInitials: "Add initials",
+			signatureLabel: "Signature",
+			initialsLabel: "Initials",
+			makerTitle: "New signature",
+			makerName: "Name",
+			makerNamePlaceholder: "Your name",
+			makerDraw: "Draw",
+			makerType: "Type",
+			makerUpload: "Upload",
+			makerTypePlaceholder: "Type your name",
+			makerFont: "Font",
+			makerUploadHint: "Choose a PNG, JPEG, or one-page PDF",
+			makerClear: "Clear",
+			makerOptional: "(optional)",
+			makerSave: "Save",
+			makerSaving: "Saving…",
+			makerError: "The signature could not be saved.",
+			signTitle: "Sign this field",
+			signReason: "Reason",
+			signLocation: "Location",
+			signKind: "What may change afterwards",
+			signKindApproval: "Approval signature — form filling and more signatures stay valid",
+			signKindCertifyAnnotate: "Certify — allow comments, form filling and signatures",
+			signKindCertifyFill: "Certify — allow form filling and signatures only",
+			signKindCertifyLocked: "Certify — allow no changes",
+			signButton: "Sign",
+			signSigning: "Signing…",
+			signFill: "Place without signing",
+			signError: "The field could not be signed.",
+			inspectTitle: "Signature",
+			inspectSigner: "Signed by",
+			inspectReason: "Reason",
+			inspectLocation: "Location",
+			inspectTime: "Time",
+			inspectIntegrity: "Document",
+			inspectCryptography: "Signature",
+			inspectTrust: "Signer",
+			inspectChanges: "Changes since",
+			inspectDownload: "Download signed version",
+			verdictValid: "Valid",
+			verdictValidUntrusted: "Valid, signer not trusted",
+			verdictInvalid: "Invalid — modified after signing",
+			verdictWillInvalidate: "Valid, invalid once saved",
+			signaturesInvalidating: "This change will invalidate {field} when the document is saved. Undo it to keep the signature.",
+			verdictIndeterminate: "Could not be verified",
+			verdictUnchanged: "None",
+			verdictRestored: "Changed, then restored",
+			inspectLaterRevisions: "Revisions after signing",
+			verdictPermitted: "Permitted",
+			verdictForbidden: "Not permitted"
 		}
 	}
 };
@@ -287,7 +375,10 @@ const en = {
 */
 const ViewerConfigContext = createContext({
 	chrome: defaultChrome,
-	icons: {}
+	icons: {},
+	stamps: {},
+	signatures: {},
+	annotations: {}
 });
 const ViewerConfigProvider = ViewerConfigContext.Provider;
 function useChromeSchema() {
@@ -302,6 +393,15 @@ function useStripSchema(id) {
 function useCustomIcons() {
 	return useContext(ViewerConfigContext).icons;
 }
+function useStampsConfig() {
+	return useContext(ViewerConfigContext).stamps;
+}
+function useSignaturesConfig() {
+	return useContext(ViewerConfigContext).signatures;
+}
+function useAnnotationsConfig() {
+	return useContext(ViewerConfigContext).annotations;
+}
 //#endregion
 //#region src/handle.ts
 function createViewerHandle(kernel) {
@@ -907,6 +1007,166 @@ function ThemeProvider({ children, preference = "system", target }) {
 	});
 }
 //#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/stamp-store.tsx
+/**
+* The user's stamp libraries live in the browser (IndexedDB): restored ONCE
+* per workspace, written on every change, for as long as the viewer lives —
+* a signature made while the stamps sidebar is closed is persisted exactly
+* like a stamp imported while it is open. The built-in library is never
+* stored (it is fetched again next time, in the locale of that moment); the
+* panels that need it bring it in lazily through `ensureDefaultLibrary`.
+*
+* Mounted once in the Shell, workspace-scoped (the stamp plugin is).
+*/
+const store = typeof indexedDB === "undefined" ? null : indexedDbByteStore("embedpdf-stamps", { storeName: "libraries" });
+const restored = /* @__PURE__ */ new WeakMap();
+/** Bring the stored libraries back — once per workspace, whoever asks first. */
+const restoreStampLibrariesOnce = (stamp) => {
+	let pending = restored.get(stamp);
+	if (!pending) {
+		pending = store ? restoreStampLibraries(stamp, store) : Promise.resolve();
+		restored.set(stamp, pending);
+	}
+	return pending;
+};
+function StampLibraryStore() {
+	const stamp = useStamp();
+	useEffect(() => {
+		restoreStampLibrariesOnce(stamp);
+		return store ? persistStampLibraries(stamp, store, { except: [DEFAULT_LIBRARY_ID] }) : void 0;
+	}, [stamp]);
+	return null;
+}
+//#endregion
+//#region src/ui/quick-stamps.tsx
+/**
+* Quick marks in the toolbar: a row of stamp thumbnails that ARM on click —
+* the checkmark, the cross, whatever the embedder configured
+* (`stamps.toolbar`: asset ids, or one library's assets). The hover ghost and
+* the click placement are the annotation plugin's, exactly as from the
+* sidebar; only the picker moved. Renders nothing until the assets exist.
+* Lives in the workspace toolbar, so it reads the ACTIVE document's tool.
+*/
+function QuickStamps() {
+	const t = useT();
+	const stamp = useStamp();
+	const config = useStampsConfig();
+	const { locale } = useLocale();
+	const assets = useStampAssets();
+	const documentId = useDocumentId();
+	const { armAsset } = useArmStampAsset();
+	const activeToolId = useOptionalSelector(InteractionToken$1, (c) => c.activeToolId(), null);
+	const armedId = useOptionalSelector(StampToken$1, (c) => documentId ? c.armedAsset(documentId)?.id ?? null : null, null);
+	const ids = Array.isArray(config.toolbar) ? config.toolbar : config.toolbar && "library" in config.toolbar ? stamp.library(config.toolbar.library)?.assetIds ?? [] : [];
+	const wantsDefault = ids.some((id) => id.startsWith(`${DEFAULT_LIBRARY_ID}:`));
+	useEffect(() => {
+		if (!wantsDefault) return;
+		restoreStampLibrariesOnce(stamp).then(() => ensureDefaultLibrary(stamp, resolveStampsLocale(locale), config.defaultLibrary)).catch((err) => console.error("[embedpdf] quick stamps failed:", err));
+	}, [
+		stamp,
+		locale,
+		wantsDefault
+	]);
+	const shown = ids.map((id) => assets.find((a) => a.id === id)).filter((a) => !!a);
+	if (shown.length === 0 || !documentId) return null;
+	return /* @__PURE__ */ jsx("div", {
+		className: "flex items-center gap-1",
+		role: "group",
+		"aria-label": t("demo.quickStampsLabel"),
+		children: shown.map((asset) => /* @__PURE__ */ jsx(QuickStampButton, {
+			asset,
+			active: activeToolId === "stamp" && armedId === asset.id,
+			onArm: () => void armAsset(asset.id).catch((e) => console.error("[embedpdf] arm failed", e))
+		}, asset.id))
+	});
+}
+function QuickStampButton({ asset, active, onArm }) {
+	const url = useStampAssetPreviewUrl(asset.id);
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		onClick: onArm,
+		title: asset.label,
+		"aria-label": asset.label,
+		"aria-pressed": active || void 0,
+		className: buttonClass(active, true),
+		children: url ? /* @__PURE__ */ jsx("img", {
+			src: url,
+			alt: "",
+			className: "h-5 w-5 object-contain",
+			draggable: false
+		}) : /* @__PURE__ */ jsx("span", {
+			className: "text-xs",
+			children: asset.label
+		})
+	});
+}
+//#endregion
 //#region src/ui/menu.tsx
 /**
 * Menu rendering — a MenuSchema (a tree of command ids) rendered as rows.
@@ -1315,7 +1575,10 @@ function AppToolbar({ bar, className }) {
 			variant,
 			run
 		}),
-		renderCustom: { "zoom-controls": (variant) => variant === "inline" ? /* @__PURE__ */ jsx(ZoomControls, {}) : /* @__PURE__ */ jsx(ZoomButton, {}) },
+		renderCustom: {
+			"zoom-controls": (variant) => variant === "inline" ? /* @__PURE__ */ jsx(ZoomControls, {}) : /* @__PURE__ */ jsx(ZoomButton, {}),
+			"quick-stamps": () => /* @__PURE__ */ jsx(QuickStamps, {})
+		},
 		renderCollapsed: (view) => view.id === "modes" ? /* @__PURE__ */ jsx(CollapsedModes, { view }) : void 0,
 		renderGroupTrigger: (view) => /* @__PURE__ */ jsx(GroupTrigger, { view }),
 		renderSeparator: () => /* @__PURE__ */ jsx("span", { className: "bg-border h-6 w-px self-center" }),
@@ -1327,6 +1590,71 @@ function AppToolbar({ bar, className }) {
 	});
 }
 //#endregion
+//#region src/ui/annotation-fonts.tsx
+/**
+* The configured annotation fonts (`annotations.fonts`), loaded once per
+* viewer: fetch the bytes → register them on the viewer's engine under the
+* key (what a free-text `fontFamily` carries and what the engine embeds) →
+* mount the same bytes as a `@font-face` named by that key (what the plugin's
+* `cssFontFamily` emits for a registered font, so the live editor renders the
+* face the appearance stream will bake). The style panel lists a font only
+* once BOTH have happened — an offered key always resolves on write.
+*/
+const LoadedFontsContext = createContext([]);
+function AnnotationFontsProvider({ children }) {
+	const kernel = useKernel();
+	const { fonts } = useAnnotationsConfig();
+	const [loaded, setLoaded] = useState([]);
+	useEffect(() => {
+		const engineFonts = kernel.engine.fonts;
+		if (!fonts?.length || !engineFonts) return;
+		let cancelled = false;
+		const unmounts = [];
+		(async () => {
+			for (const font of fonts) try {
+				const response = await fetch(font.url);
+				if (!response.ok) throw new Error(`${font.url}: HTTP ${response.status}`);
+				const bytes = new Uint8Array(await response.arrayBuffer());
+				if (cancelled) return;
+				await engineFonts.register({
+					key: font.key,
+					familyName: font.familyName,
+					weight: font.weight,
+					italic: font.italic,
+					data: bytes
+				});
+				const unmount = await mountWebFont(font.key, bytes, {
+					weight: font.weight,
+					style: font.italic ? "italic" : "normal"
+				});
+				if (cancelled) {
+					unmount();
+					return;
+				}
+				unmounts.push(unmount);
+				setLoaded((prev) => prev.some((f) => f.key === font.key) ? prev : [...prev, {
+					key: font.key,
+					label: font.label
+				}]);
+			} catch (error) {
+				console.warn(`[embedpdf] annotation font "${font.key}" was not loaded:`, error);
+			}
+		})();
+		return () => {
+			cancelled = true;
+			for (const unmount of unmounts) unmount();
+		};
+	}, [kernel, fonts]);
+	return /* @__PURE__ */ jsx(LoadedFontsContext.Provider, {
+		value: loaded,
+		children
+	});
+}
+/** The configured fonts that are registered AND mounted, in config order. */
+function useAnnotationFonts() {
+	return useContext(LoadedFontsContext);
+}
+//#endregion
 //#region src/ui/link-editor.tsx
 /**
 * The link editor POPOVER — v2's "add a link" popup, reborn. It rides the
@@ -2312,12 +2640,17 @@ function LineEndingSelect({ side, value, onChange }) {
 	});
 }
 function FontFamilySelect({ value, onChange }) {
+	const configured = useAnnotationFonts();
+	const options = [...FONT_OPTIONS, ...configured.map((f) => ({
+		v: f.key,
+		label: f.label
+	}))];
 	return /* @__PURE__ */ jsx(DropdownShell, {
 		trigger: /* @__PURE__ */ jsx("span", {
 			className: "text-fg text-sm",
-			children: FONT_OPTIONS.find((o) => o.v === value)?.label ?? value
+			children: options.find((o) => o.v === value)?.label ?? value
 		}),
-		children: (close) => FONT_OPTIONS.map((o) => /* @__PURE__ */ jsx(OptionRow, {
+		children: (close) => options.map((o) => /* @__PURE__ */ jsx(OptionRow, {
 			selected: o.v === value,
 			onClick: () => {
 				onChange(o.v);
@@ -2329,17 +2662,33 @@ function FontFamilySelect({ value, onChange }) {
 }
 function FontSizeCombo({ value, onChange }) {
 	const [open, setOpen] = useState(false);
+	const rootRef = useOutsideClose(open, () => setOpen(false));
+	const [draft, setDraft] = useState(null);
+	const commit = () => {
+		if (draft === null) return;
+		const n = parseInt(draft, 10);
+		setDraft(null);
+		if (Number.isFinite(n) && n > 0 && n !== value) onChange(n);
+	};
 	return /* @__PURE__ */ jsxs("div", {
-		ref: useOutsideClose(open, () => setOpen(false)),
+		ref: rootRef,
 		className: "relative w-full",
 		children: [
 			/* @__PURE__ */ jsx("input", {
 				type: "number",
 				min: 1,
-				value,
-				onChange: (e) => {
-					const n = parseInt(e.target.value, 10);
-					if (Number.isFinite(n) && n > 0) onChange(n);
+				value: draft ?? value,
+				onChange: (e) => setDraft(e.target.value),
+				onBlur: commit,
+				onKeyDown: (e) => {
+					if (e.key === "Enter") {
+						e.preventDefault();
+						commit();
+						setOpen(false);
+					} else if (e.key === "Escape") {
+						setDraft(null);
+						setOpen(false);
+					}
 				},
 				onClick: () => setOpen(true),
 				className: "border-border bg-surface text-fg w-full rounded border px-2 py-1.5 pr-7 text-sm"
@@ -2360,6 +2709,7 @@ function FontSizeCombo({ value, onChange }) {
 				children: FONT_SIZES.map((sz) => /* @__PURE__ */ jsx(OptionRow, {
 					selected: sz === value,
 					onClick: () => {
+						setDraft(null);
 						onChange(sz);
 						setOpen(false);
 					},
@@ -2380,15 +2730,45 @@ function BlendModeSelect({ value, onChange }) {
 		}, mode.v))
 	});
 }
-function Toggle({ active, title, onClick, children }) {
+function Toggle({ active, title, onClick, keepFocus, children }) {
 	return /* @__PURE__ */ jsx("button", {
 		type: "button",
 		title,
 		onClick,
+		onMouseDown: keepFocus ? (e) => e.preventDefault() : void 0,
 		className: `flex h-9 w-9 items-center justify-center rounded border transition-colors ${active ? "border-accent bg-accent text-on-accent" : "border-border bg-surface text-fg hover:bg-hover"}`,
 		children
 	});
 }
+const isFormatSpec = (spec) => spec.key === "bold" || spec.key === "italic" || spec.key === "underline";
+/**
+* The format toggles a free-text kind declares, in one row. While the text
+* editor holds a range they read and write that range's runs (the plugin
+* routes `updateSelection`); otherwise the annotation's body. The buttons
+* keep focus in the editor so the range survives the click.
+*/
+function FormatToggles({ specs, values, mixed, onChange }) {
+	return /* @__PURE__ */ jsx(Field, {
+		label: useT()("demo.formatLabel", { fallback: "Format" }),
+		mixed: specs.some((s) => mixed.includes(s.key)),
+		children: /* @__PURE__ */ jsx("div", {
+			className: "flex gap-2",
+			children: specs.map((spec) => {
+				const active = values[spec.key] === true && !mixed.includes(spec.key);
+				return /* @__PURE__ */ jsx(Toggle, {
+					title: spec.label,
+					active,
+					keepFocus: true,
+					onClick: () => onChange({ [spec.key]: !active }),
+					children: /* @__PURE__ */ jsx(Icon, {
+						name: spec.key,
+						size: 18
+					})
+				}, spec.key);
+			})
+		})
+	});
+}
 function PropControl({ spec, value, mixed, onChange }) {
 	switch (spec.key) {
 		case "color":
@@ -2523,6 +2903,9 @@ function PropControl({ spec, value, mixed, onChange }) {
 				})
 			});
 		}
+		case "bold":
+		case "italic":
+		case "underline": return null;
 		case "blendMode": return /* @__PURE__ */ jsx(Field, {
 			label: spec.label,
 			mixed,
@@ -2570,7 +2953,12 @@ function AnnotationStylePanel() {
 				className: "text-fg-muted mb-4 text-[11px] font-semibold uppercase tracking-wide",
 				children: hasSel ? `${selected.length} selected` : `${activeToolId} defaults`
 			}),
-			specs.map((spec) => /* @__PURE__ */ jsx(PropControl, {
+			specs.map((spec) => spec.key === "bold" ? /* @__PURE__ */ jsx(FormatToggles, {
+				specs: specs.filter((s) => isFormatSpec(s)),
+				values,
+				mixed: hasSel ? sel.mixed : [],
+				onChange: write
+			}, "format") : /* @__PURE__ */ jsx(PropControl, {
 				spec,
 				value: values[spec.key],
 				mixed: hasSel && sel.mixed.includes(spec.key),
@@ -3441,6 +3829,515 @@ function SearchPanel() {
 	});
 }
 //#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";
+function StampsPanel() {
+	const t = useT();
+	const stamp = useStamp();
+	const { defaultLibrary, sidebar } = useStampsConfig();
+	const libraries = useStampLibraries({ kind: sidebar ?? ["stamps"] });
+	const assets = useStampAssets();
+	const { armAsset } = useArmStampAsset();
+	const { activeToolId } = useTool();
+	const { locale } = useLocale();
+	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");
+		restoreStampLibrariesOnce(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(() => {
+		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/signatures-panel.tsx
+/**
+* The signatures sidebar (right panel) — Preview's signature sheet on v3
+* parts. One row per PERSON: a stamp library of kind `signatures` holding a
+* full signature and, optionally, initials. Nothing is stored beyond the
+* file; rename/export/delete are the library verbs.
+*
+*   pick a mark → with a TARGET field ("sign here" was clicked, or a
+*   signature widget selected) the mark goes into that field by the
+*   plugin's mode; otherwise it ARMS — hover a page for the ghost, click a
+*   signature field to sign it, click anywhere else to drop it as a stamp.
+*
+* Below the people: the signature fields of THIS document, signed or not,
+* with their verdicts — click an unsigned one to target it, a signed one to
+* inspect it.
+*/
+const fieldLabel = (field) => field.kind === "fqn" ? field.name : `#${field.fieldObjectNumber}`;
+function SignaturesPanel() {
+	const t = useT();
+	const stamp = useStamp();
+	const signature = useSignature();
+	const config = useSignaturesConfig();
+	const rows = useSignerRows();
+	const { target, busy } = useSignatureTarget();
+	const { armAsset } = useArmStampAsset();
+	const { activeToolId } = useTool();
+	const maker = useSurface("signature-maker");
+	const [armedId, setArmedId] = useState(null);
+	const [error, setError] = useState(null);
+	const [invalidating, setInvalidating] = useState(null);
+	useSignatureEvent((event) => {
+		if (event.type === "invalidating") setInvalidating(signature.signatureOf(event.field)?.fieldName ?? fieldLabel(event.field));
+		else if (event.type === "validated" && !event.verdicts.some((v) => v.summary === "invalid" && v.modifications.basis === "working-copy")) setInvalidating(null);
+	});
+	useEffect(() => {
+		restoreStampLibrariesOnce(stamp);
+	}, [stamp]);
+	useEffect(() => {
+		if (activeToolId !== "stamp") setArmedId(null);
+	}, [activeToolId]);
+	const pick = (asset) => {
+		setError(null);
+		if (target) {
+			signature.placeMark({ assetId: asset.id }, { field: target }).catch((err) => {
+				console.error("[embedpdf] placing the mark failed:", err);
+				setError(t("demo.signError"));
+			});
+			return;
+		}
+		setArmedId(asset.id);
+		armAsset(asset.id).catch((err) => {
+			console.error("[embedpdf] arm mark failed:", err);
+			setArmedId(null);
+			setError(t("demo.stampsArmError"));
+		});
+	};
+	const canAddPerson = (config.libraries ?? "many") === "many" || rows.length === 0;
+	const wantsInitials = (config.kinds ?? ["signature", "initials"]).includes("initials");
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex min-h-0 flex-1 flex-col",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "min-h-0 flex-1 overflow-y-auto p-3",
+				children: [rows.length === 0 ? /* @__PURE__ */ jsxs("div", {
+					className: "flex flex-col items-center gap-3 px-4 py-8 text-center",
+					children: [/* @__PURE__ */ jsx(Icon, {
+						name: "signature",
+						size: 32,
+						className: "text-fg-muted"
+					}), /* @__PURE__ */ jsx("p", {
+						className: "text-fg-muted text-sm",
+						children: t("demo.signaturesEmpty")
+					})]
+				}) : /* @__PURE__ */ jsx("ul", {
+					className: "flex flex-col gap-3",
+					children: rows.map((row) => /* @__PURE__ */ jsx(SignerRowView, {
+						row,
+						armedId,
+						wantsInitials,
+						onPick: pick,
+						onAddInitials: () => maker.open({
+							exclusive: "modal",
+							props: { libraryId: row.libraryId }
+						})
+					}, row.libraryId))
+				}), /* @__PURE__ */ jsx(DocumentSignatures, {})]
+			}),
+			invalidating && /* @__PURE__ */ jsx("div", {
+				className: "border-border-subtle shrink-0 border-t px-3 py-2 text-xs text-amber-700",
+				children: t("demo.signaturesInvalidating", { params: { field: invalidating } })
+			}),
+			(error || target || 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 ?? (target ? busy ? t("demo.signSigning") : t("demo.signaturesTargetHint") : t("demo.signaturesArmedHint"))
+			}),
+			canAddPerson ? /* @__PURE__ */ jsx("div", {
+				className: "border-border-subtle shrink-0 border-t p-3",
+				children: /* @__PURE__ */ jsxs("button", {
+					type: "button",
+					onClick: () => maker.open({ exclusive: "modal" }),
+					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",
+					children: [/* @__PURE__ */ jsx(Icon, {
+						name: "plus",
+						size: 16
+					}), t("demo.signaturesNew")]
+				})
+			}) : null
+		]
+	});
+}
+function SignerRowView({ row, armedId, wantsInitials, onPick, onAddInitials }) {
+	const t = useT();
+	const stamp = useStamp();
+	const [renaming, setRenaming] = useState(null);
+	const exportPdf = () => {
+		const bytes = stamp.exportLibrary(row.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 = `${row.name || "signature"}.pdf`;
+		a.click();
+		URL.revokeObjectURL(url);
+	};
+	const commitRename = () => {
+		const name = renaming?.trim();
+		setRenaming(null);
+		if (name && name !== row.name) stamp.updateLibrary(row.libraryId, { name });
+	};
+	const iconButton = "text-fg-muted hover:text-fg grid h-6 w-6 shrink-0 place-items-center rounded";
+	return /* @__PURE__ */ jsxs("li", {
+		className: "border-border-subtle rounded-md border p-2",
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex items-center gap-1",
+			children: [
+				renaming !== null ? /* @__PURE__ */ jsx("input", {
+					autoFocus: true,
+					value: renaming,
+					onChange: (e) => setRenaming(e.target.value),
+					onBlur: commitRename,
+					onKeyDown: (e) => {
+						if (e.key === "Enter") commitRename();
+						if (e.key === "Escape") setRenaming(null);
+					},
+					className: "border-border bg-surface text-fg min-w-0 flex-1 rounded border px-1.5 py-0.5 text-sm"
+				}) : /* @__PURE__ */ jsx("span", {
+					className: "text-fg min-w-0 flex-1 truncate text-sm font-medium",
+					children: row.name
+				}),
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: () => setRenaming(row.name),
+					title: t("demo.signaturesRename"),
+					className: iconButton,
+					children: /* @__PURE__ */ jsx(Icon, {
+						name: "pencilMarker",
+						size: 13
+					})
+				}),
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: exportPdf,
+					title: t("demo.signaturesExport"),
+					className: iconButton,
+					children: /* @__PURE__ */ jsx(Icon, {
+						name: "download",
+						size: 13
+					})
+				}),
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: () => void stamp.removeLibrary(row.libraryId),
+					title: t("demo.signaturesRemove"),
+					className: iconButton,
+					children: /* @__PURE__ */ jsx(Icon, {
+						name: "trash",
+						size: 13
+					})
+				})
+			]
+		}), /* @__PURE__ */ jsxs("div", {
+			className: "mt-2 grid grid-cols-[2fr_1fr] gap-2",
+			children: [row.signatures.map((asset) => /* @__PURE__ */ jsx(MarkThumb, {
+				asset,
+				label: t("demo.signatureLabel"),
+				armed: armedId === asset.id,
+				onPick: () => onPick(asset)
+			}, asset.id)), wantsInitials ? row.initials ? /* @__PURE__ */ jsx(MarkThumb, {
+				asset: row.initials,
+				label: t("demo.initialsLabel"),
+				armed: armedId === row.initials.id,
+				onPick: () => onPick(row.initials)
+			}) : /* @__PURE__ */ jsx("button", {
+				type: "button",
+				onClick: onAddInitials,
+				title: t("demo.signaturesAddInitials"),
+				className: "border-border-subtle text-fg-muted hover:bg-hover flex h-16 items-center justify-center rounded-md border border-dashed text-xs",
+				children: /* @__PURE__ */ jsx(Icon, {
+					name: "plus",
+					size: 14
+				})
+			}) : null]
+		})]
+	});
+}
+function MarkThumb({ asset, label, armed, onPick }) {
+	const url = useStampAssetPreviewUrl(asset.id);
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		onClick: onPick,
+		title: label,
+		"aria-pressed": armed,
+		className: `flex h-16 items-center justify-center rounded-md border p-1 ${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: label,
+			className: "max-h-full max-w-full object-contain"
+		}) : /* @__PURE__ */ jsx("span", {
+			className: "text-fg-muted text-xs",
+			children: label
+		})
+	});
+}
+/** The signature fields of this document, with their state. */
+function DocumentSignatures() {
+	const t = useT();
+	const signature = useSignature();
+	const snapshot = useSignatureSnapshot();
+	const verdicts = useSignatureVerdicts();
+	const { target } = useSignatureTarget();
+	const [validating, setValidating] = useState(false);
+	const fields = snapshot?.signatures ?? [];
+	const verdictOf = (dto) => verdicts?.find((v) => v.signature.index === dto.index) ?? null;
+	const verdictLabel = (v) => !v ? t("demo.signaturesSigned") : v.summary === "valid" ? t("demo.verdictValid") : v.summary === "valid-untrusted" ? t("demo.verdictValidUntrusted") : v.summary === "indeterminate" ? t("demo.verdictIndeterminate") : v.modifications.basis === "working-copy" ? t("demo.verdictWillInvalidate") : t("demo.verdictInvalid");
+	const verdictTone = (v) => !v || v.summary === "indeterminate" ? "text-fg-muted" : v.summary === "invalid" ? v.modifications.basis === "working-copy" ? "text-amber-600" : "text-red-600" : v.summary === "valid-untrusted" ? "text-amber-600" : "text-green-600";
+	const isTarget = (dto) => !!target && (target.kind === "fqn" ? target.name === dto.fieldName : target.fieldObjectNumber === (dto.field.kind === "objectNumber" ? dto.field.fieldObjectNumber : -1));
+	const validate = () => {
+		setValidating(true);
+		signature.validate().finally(() => setValidating(false));
+	};
+	return /* @__PURE__ */ jsxs("div", {
+		className: "mt-4",
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex items-center justify-between",
+			children: [/* @__PURE__ */ jsx("span", {
+				className: "text-fg-muted text-xs font-semibold uppercase tracking-wide",
+				children: t("demo.signaturesInDocument")
+			}), fields.some((f) => f.signed) ? /* @__PURE__ */ jsx("button", {
+				type: "button",
+				disabled: validating,
+				onClick: validate,
+				className: "text-accent text-xs hover:underline disabled:opacity-60",
+				children: validating ? t("demo.signaturesValidating") : t("demo.signaturesValidate")
+			}) : null]
+		}), fields.length === 0 ? /* @__PURE__ */ jsx("p", {
+			className: "text-fg-muted mt-1 text-xs",
+			children: t("demo.signaturesNone")
+		}) : /* @__PURE__ */ jsx("ul", {
+			className: "mt-1 flex flex-col gap-1",
+			children: fields.map((dto) => {
+				const verdict = verdictOf(dto);
+				return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs("button", {
+					type: "button",
+					onClick: () => dto.signed ? signature.inspect(dto.field) : signature.setTarget(dto.field),
+					className: `hover:bg-hover flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-sm ${isTarget(dto) ? "bg-accent-light" : ""}`,
+					children: [
+						/* @__PURE__ */ jsx(Icon, {
+							name: dto.signed ? "check" : "signature",
+							size: 14,
+							className: dto.signed ? "text-green-600" : "text-fg-muted"
+						}),
+						/* @__PURE__ */ jsx("span", {
+							className: "text-fg min-w-0 flex-1 truncate",
+							children: dto.fieldName
+						}),
+						/* @__PURE__ */ jsx("span", {
+							className: `shrink-0 text-right text-xs ${dto.signed ? verdictTone(verdict) : "text-fg-muted"}`,
+							children: dto.signed ? verdictLabel(verdict) : t("demo.signaturesUnsigned")
+						})
+					]
+				}) }, dto.index);
+			})
+		})]
+	});
+}
+//#endregion
 //#region src/ui/panels.tsx
 /**
 * The static chrome around the toolbars: the left/right sidebars (shell
@@ -3534,10 +4431,12 @@ 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 signatures = useSurface("signatures");
+	const active = search.isOpen ? "search" : comment.isOpen ? "comment" : style.isOpen ? "style" : redaction.isOpen ? "redaction" : stamps.isOpen ? "stamps" : signatures.isOpen ? "signatures" : 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" : active === "signatures" ? "demo.signaturesTitle" : "demo.styleTitle";
+	const close = active === "search" ? search.close : active === "comment" ? comment.close : active === "redaction" ? redaction.close : active === "stamps" ? stamps.close : active === "signatures" ? signatures.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 +4453,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, {}) : active === "signatures" ? /* @__PURE__ */ jsx(SignaturesPanel, {}) : /* @__PURE__ */ jsx(CommentsPanel, {}, documentId ?? "none")]
 	});
 }
 function PageControls() {
@@ -3645,6 +4544,684 @@ function RedactConfirmModal() {
 	});
 }
 //#endregion
+//#region src/ui/sign-dialog.tsx
+/**
+* The sign dialog (`signature-sign` modal surface): a mark met a field and
+* the mode is `ask` — or a "sign here" flow wants the facts first. Shows
+* the mark as it will sit in the field, takes reason and location, offers
+* a certification when the config allows it, and either SEALS the field
+* (`signField`) or only draws the mark into it (`fillField`).
+*/
+function SignDialog() {
+	const t = useT();
+	const surface = useSurface("signature-sign");
+	const signature = useSignature();
+	const [reason, setReason] = useState("");
+	const [location, setLocation] = useState("");
+	const [signKind, setSignKind] = useState("approval");
+	const [busy, setBusy] = useState(null);
+	const [error, setError] = useState(null);
+	const field = surface.props?.field;
+	const mark = surface.props?.mark;
+	const preview = useStampAssetPreviewUrl(mark && "assetId" in mark ? mark.assetId : null);
+	if (!surface.isOpen || !field || !mark) return null;
+	const attribution = {
+		...reason.trim() ? { reason: reason.trim() } : {},
+		...location.trim() ? { location: location.trim() } : {}
+	};
+	const run = async (kind) => {
+		setBusy(kind);
+		setError(null);
+		try {
+			if (kind === "sign") await signature.signField({
+				field,
+				mark,
+				attribution,
+				...signKind !== "approval" && signature.canCertify() ? { certify: { permission: Number(signKind.slice(-1)) } } : {}
+			});
+			else await signature.fillField(field, mark);
+			surface.close();
+		} catch (err) {
+			setError(err instanceof Error ? err.message : String(err));
+		} finally {
+			setBusy(null);
+		}
+	};
+	const input = "border-border bg-surface text-fg w-full rounded border px-2 py-1.5 text-sm";
+	return /* @__PURE__ */ jsx("div", {
+		className: "fixed inset-0 z-50 grid place-items-center bg-black/40",
+		children: /* @__PURE__ */ jsxs("div", {
+			className: "border-border bg-surface w-96 rounded-lg border p-4 shadow-xl",
+			children: [
+				/* @__PURE__ */ jsx("h2", {
+					className: "text-fg text-base font-semibold",
+					children: t("demo.signTitle")
+				}),
+				/* @__PURE__ */ jsx("div", {
+					className: "border-border-subtle mt-3 flex h-24 items-center justify-center rounded-md border p-2",
+					children: preview ? /* @__PURE__ */ jsx("img", {
+						src: preview,
+						alt: "",
+						className: "max-h-full max-w-full object-contain"
+					}) : /* @__PURE__ */ jsx("span", {
+						className: "text-fg-muted text-sm",
+						children: t("demo.signatureLabel")
+					})
+				}),
+				/* @__PURE__ */ jsxs("label", {
+					className: "text-fg-muted mt-3 block text-xs",
+					children: [t("demo.signReason"), /* @__PURE__ */ jsx("input", {
+						value: reason,
+						onChange: (e) => setReason(e.target.value),
+						className: input
+					})]
+				}),
+				/* @__PURE__ */ jsxs("label", {
+					className: "text-fg-muted mt-2 block text-xs",
+					children: [t("demo.signLocation"), /* @__PURE__ */ jsx("input", {
+						value: location,
+						onChange: (e) => setLocation(e.target.value),
+						className: input
+					})]
+				}),
+				signature.canCertify() ? /* @__PURE__ */ jsxs("label", {
+					className: "text-fg-muted mt-3 block text-xs",
+					children: [t("demo.signKind"), /* @__PURE__ */ jsxs("select", {
+						value: signKind,
+						onChange: (e) => setSignKind(e.target.value),
+						className: input,
+						children: [
+							/* @__PURE__ */ jsx("option", {
+								value: "approval",
+								children: t("demo.signKindApproval")
+							}),
+							/* @__PURE__ */ jsx("option", {
+								value: "certify-3",
+								children: t("demo.signKindCertifyAnnotate")
+							}),
+							/* @__PURE__ */ jsx("option", {
+								value: "certify-2",
+								children: t("demo.signKindCertifyFill")
+							}),
+							/* @__PURE__ */ jsx("option", {
+								value: "certify-1",
+								children: t("demo.signKindCertifyLocked")
+							})
+						]
+					})]
+				}) : null,
+				error ? /* @__PURE__ */ jsx("p", {
+					className: "mt-2 text-sm text-red-600",
+					children: error
+				}) : null,
+				/* @__PURE__ */ jsxs("div", {
+					className: "mt-4 flex justify-end gap-2",
+					children: [
+						/* @__PURE__ */ jsx("button", {
+							type: "button",
+							disabled: busy != null,
+							onClick: surface.close,
+							className: "border-border text-fg hover:bg-hover rounded-md border px-3 py-1.5 text-sm",
+							children: t("demo.cancel")
+						}),
+						signature.canFill() ? /* @__PURE__ */ jsx("button", {
+							type: "button",
+							disabled: busy != null,
+							onClick: () => void run("fill"),
+							className: "border-border text-fg hover:bg-hover rounded-md border px-3 py-1.5 text-sm disabled:opacity-60",
+							children: t("demo.signFill")
+						}) : null,
+						signature.canSign() ? /* @__PURE__ */ jsx("button", {
+							type: "button",
+							disabled: busy != null,
+							onClick: () => void run("sign"),
+							className: "bg-accent text-on-accent rounded-md px-3 py-1.5 text-sm disabled:opacity-60",
+							children: busy === "sign" ? t("demo.signSigning") : t("demo.signButton")
+						}) : null
+					]
+				})
+			]
+		})
+	});
+}
+//#endregion
+//#region src/ui/signature-bridge.tsx
+/**
+* The signature plugin's UI intents → shell surfaces. The plugin owns the
+* act and says WHAT happened; the chrome decides WHAT OPENS:
+*
+*   target  (a "sign here" click)      → the signatures panel, right side
+*   ask     (mode 'ask' met a field)   → the sign dialog (modal)
+*   inspect (a signed field clicked)   → the validation popover
+*
+* Mounted once per document view; renders nothing.
+*/
+function SignatureBridge() {
+	const shell = useShell();
+	useSignatureEvent((event) => {
+		switch (event.type) {
+			case "target":
+				if (event.field) shell.open("signatures", { exclusive: "right" });
+				return;
+			case "ask":
+				shell.open("signature-sign", {
+					exclusive: "modal",
+					props: {
+						field: event.field,
+						mark: event.mark
+					}
+				});
+				return;
+			case "inspect":
+				shell.open("signature-inspector", { props: { field: event.field } });
+				return;
+			case "invalidating":
+				shell.open("signatures", { exclusive: "right" });
+				return;
+			default: return;
+		}
+	});
+	return null;
+}
+//#endregion
+//#region src/ui/signature-inspector.tsx
+/**
+* The validation popover (`signature-inspector` surface): what a signed
+* field's signature says and whether it holds — the four independent facts
+* (integrity, cryptography, trust, changes since) and the signer's claims,
+* anchored at the widget when its box is known, plus the signed revision as
+* a download (the exact bytes the signature covers). Mounted in the Stage
+* overlay so `<Anchored>` can project onto the page.
+*/
+const verdictKey = (v) => !v ? "demo.verdictIndeterminate" : v.summary === "valid" ? "demo.verdictValid" : v.summary === "valid-untrusted" ? "demo.verdictValidUntrusted" : v.summary === "invalid" ? v.modifications.basis === "working-copy" ? "demo.verdictWillInvalidate" : "demo.verdictInvalid" : "demo.verdictIndeterminate";
+/** A PDF date string (`D:YYYYMMDDHHmmSSZ` or with a zone offset) as a locale date; the raw text when it is not one. */
+const pdfDate = (raw) => {
+	const m = /^D:(\d{4})(\d{2})?(\d{2})?(\d{2})?(\d{2})?(\d{2})?(Z|[+-]\d{2}'?\d{2}'?)?/.exec(raw);
+	if (!m) return raw;
+	const [, y, mo = "01", d = "01", h = "00", mi = "00", s = "00", zone] = m;
+	const offset = !zone || zone === "Z" ? "Z" : `${zone[0]}${zone.slice(1, 3)}:${zone.slice(3).replace(/'/g, "") || "00"}`;
+	const date = /* @__PURE__ */ new Date(`${y}-${mo}-${d}T${h}:${mi}:${s}${offset}`);
+	return Number.isNaN(date.getTime()) ? raw : date.toLocaleString();
+};
+const tone = (summary) => summary === "valid" ? "text-green-600" : summary === "invalid" ? "text-red-600" : summary === "valid-untrusted" ? "text-amber-600" : "text-fg-muted";
+function SignatureInspector() {
+	const t = useT();
+	const surface = useSurface("signature-inspector");
+	const signature = useSignature();
+	const snapshot = useSignatureSnapshot();
+	const verdicts = useSignatureVerdicts();
+	const [validating, setValidating] = useState(false);
+	const field = surface.props?.field;
+	const dto = field ? signature.signatureOf(field) : null;
+	const verdict = field ? signature.verdictOf(field) : null;
+	const widget = dto?.widget ?? null;
+	const box = useSelector(FormToken$1, (c) => widget && widget.annotObjectNumber > 0 ? c.fillItem(widget.annotObjectNumber)?.box ?? null : null);
+	useEffect(() => {
+		if (!surface.isOpen || !dto?.signed || verdicts) return;
+		setValidating(true);
+		signature.validate().finally(() => setValidating(false));
+	}, [surface.isOpen, dto?.index]);
+	if (!surface.isOpen || !field || !dto || !snapshot) return null;
+	const revalidate = () => {
+		setValidating(true);
+		signature.validate().finally(() => setValidating(false));
+	};
+	const summary = verdict?.summary ?? null;
+	const modifications = verdict?.modifications.verdict ?? null;
+	const row = (label, value, className = "text-fg") => /* @__PURE__ */ jsxs("div", {
+		className: "flex items-baseline justify-between gap-3 text-xs",
+		children: [/* @__PURE__ */ jsx("span", {
+			className: "text-fg-muted",
+			children: label
+		}), /* @__PURE__ */ jsx("span", {
+			className: `text-right ${className}`,
+			children: value
+		})]
+	});
+	const card = /* @__PURE__ */ jsxs("div", {
+		className: "border-border bg-elevated w-72 rounded-lg border p-3 text-sm shadow-xl",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center justify-between",
+				children: [/* @__PURE__ */ jsx("span", {
+					className: "text-fg font-semibold",
+					children: t("demo.inspectTitle")
+				}), /* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: surface.close,
+					className: "text-fg-muted hover:bg-hover grid h-6 w-6 place-items-center rounded",
+					"aria-label": t("demo.cancel"),
+					children: /* @__PURE__ */ jsx(Icon, {
+						name: "x",
+						size: 14
+					})
+				})]
+			}),
+			/* @__PURE__ */ jsx("p", {
+				className: `mt-1 text-sm font-medium ${tone(summary)}`,
+				children: validating ? t("demo.signaturesValidating") : t(verdictKey(verdict))
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "mt-2 flex flex-col gap-1",
+				children: [
+					row(t("demo.inspectSigner"), dto.signer.name ?? "—"),
+					dto.signer.reason ? row(t("demo.inspectReason"), dto.signer.reason) : null,
+					dto.signer.location ? row(t("demo.inspectLocation"), dto.signer.location) : null,
+					dto.signer.claimedTime ? row(t("demo.inspectTime"), pdfDate(dto.signer.claimedTime)) : null
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "border-border-subtle mt-2 flex flex-col gap-1 border-t pt-2",
+				children: [
+					row(t("demo.inspectIntegrity"), verdict?.integrity ?? "—", tone(verdict?.integrity === "valid" ? "valid" : verdict?.integrity === "invalid" ? "invalid" : null)),
+					row(t("demo.inspectCryptography"), verdict?.cryptography ?? "—"),
+					row(t("demo.inspectTrust"), verdict?.trust ?? "—"),
+					row(t("demo.inspectChanges"), modifications === "unchanged" ? verdict?.modifications.undone ? t("demo.verdictRestored") : t("demo.verdictUnchanged") : modifications === "permitted" ? t("demo.verdictPermitted") : modifications === "forbidden" ? t("demo.verdictForbidden") : "—", modifications === "forbidden" ? "text-red-600" : "text-fg"),
+					verdict?.modifications.laterRevisions ? row(t("demo.inspectLaterRevisions"), String(verdict.modifications.laterRevisions)) : null
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "mt-3 flex justify-end gap-2",
+				children: [/* @__PURE__ */ jsx("button", {
+					type: "button",
+					disabled: validating,
+					onClick: revalidate,
+					className: "border-border text-fg hover:bg-hover rounded-md border px-2 py-1 text-xs disabled:opacity-60",
+					children: t("demo.signaturesValidate")
+				}), /* @__PURE__ */ jsx(DownloadRevision, { field })]
+			})
+		]
+	});
+	if (widget && widget.pageObjectNumber > 0 && box) return /* @__PURE__ */ jsx(Anchored, {
+		anchor: {
+			pon: widget.pageObjectNumber,
+			bounds: box
+		},
+		placement: "bottom",
+		gap: 8,
+		children: card
+	});
+	return /* @__PURE__ */ jsx("div", {
+		className: "absolute right-4 top-4 z-40",
+		children: card
+	});
+}
+/** The signed revision — the exact bytes the signature covers — as a file. */
+function DownloadRevision({ field }) {
+	const t = useT();
+	const signature = useSignature();
+	const dto = signature.signatureOf(field);
+	const [busy, setBusy] = useState(false);
+	if (!dto || dto.revisionIndex === null) return null;
+	const revisionIndex = dto.revisionIndex;
+	const run = async () => {
+		setBusy(true);
+		try {
+			const bytes = await signature.revisionBytes(revisionIndex);
+			const blob = new Blob([bytes], { type: "application/pdf" });
+			const url = URL.createObjectURL(blob);
+			const a = document.createElement("a");
+			a.href = url;
+			a.download = `${dto.fieldName}-signed.pdf`;
+			a.click();
+			URL.revokeObjectURL(url);
+		} catch (err) {
+			console.error("[embedpdf] signed revision download failed:", err);
+		} finally {
+			setBusy(false);
+		}
+	};
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		disabled: busy,
+		onClick: () => void run(),
+		className: "border-border text-fg hover:bg-hover rounded-md border px-2 py-1 text-xs disabled:opacity-60",
+		children: t("demo.inspectDownload")
+	});
+}
+//#endregion
+//#region src/ui/signature-maker.tsx
+/**
+* The mark maker (`signature-maker` modal surface): a person's signature and
+* initials, drawn, typed, or uploaded, saved as ONE library of kind
+* `signatures` — the file IS the person (Preview's model). Chrome code over
+* the stamp plugin's generic calls: `createLibrary` + `addAsset({ mark })`;
+* rename/export/delete are the library verbs. Opened on an existing library
+* (`props.libraryId`) it only adds the missing initials.
+*/
+const PAD = {
+	width: 360,
+	height: 120
+};
+const BUILTIN_FONTS = [{
+	key: "helvetica-oblique",
+	label: "Helvetica"
+}, {
+	key: "times-italic",
+	label: "Times"
+}];
+/** One pad: draw / type / upload, producing a `MarkSource` or null. */
+function MarkPad({ value, onChange, fonts, registerFont }) {
+	const t = useT();
+	const [tab, setTab] = useState("draw");
+	const [strokes, setStrokes] = useState([]);
+	const [text, setText] = useState("");
+	const [font, setFont] = useState(fonts[0]?.key ?? "helvetica-oblique");
+	const [fileName, setFileName] = useState(null);
+	const canvas = useRef(null);
+	const drawing = useRef(null);
+	useEffect(() => {
+		const el = canvas.current;
+		if (!el) return;
+		const dpr = window.devicePixelRatio || 1;
+		el.width = PAD.width * dpr;
+		el.height = PAD.height * dpr;
+		const ctx = el.getContext("2d");
+		if (!ctx) return;
+		ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+		ctx.clearRect(0, 0, PAD.width, PAD.height);
+		ctx.lineCap = "round";
+		ctx.lineJoin = "round";
+		ctx.lineWidth = 2.5;
+		ctx.strokeStyle = getComputedStyle(el).color || "#000";
+		for (const stroke of strokes) {
+			ctx.beginPath();
+			stroke.forEach((p, i) => i === 0 ? ctx.moveTo(p.x, p.y) : ctx.lineTo(p.x, p.y));
+			ctx.stroke();
+		}
+	}, [strokes, tab]);
+	const point = (e) => {
+		const r = e.currentTarget.getBoundingClientRect();
+		return {
+			x: e.clientX - r.left,
+			y: e.clientY - r.top
+		};
+	};
+	const commitStrokes = (next) => {
+		setStrokes(next);
+		onChange(next.length ? {
+			kind: "ink",
+			strokes: next,
+			color: "#000000",
+			strokeWidth: 2.5
+		} : null);
+	};
+	const commitText = async (next, key) => {
+		setText(next);
+		setFont(key);
+		if (!next.trim()) {
+			onChange(null);
+			return;
+		}
+		await registerFont(key);
+		onChange({
+			kind: "text",
+			text: next.trim(),
+			fontFamily: key,
+			color: "#000000",
+			fontSize: 36
+		});
+	};
+	const pickFile = (file) => {
+		setFileName(file.name);
+		onChange(file.type === "application/pdf" ? {
+			kind: "pdf",
+			source: file,
+			pageIndex: 0
+		} : {
+			kind: "image",
+			source: file
+		});
+	};
+	const tabClass = (id) => `rounded px-2 py-1 text-xs font-medium ${tab === id ? "bg-accent text-on-accent" : "text-fg-muted hover:bg-hover"}`;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex flex-col gap-2",
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex items-center gap-1",
+			children: [
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					className: tabClass("draw"),
+					onClick: () => setTab("draw"),
+					children: t("demo.makerDraw")
+				}),
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					className: tabClass("type"),
+					onClick: () => setTab("type"),
+					children: t("demo.makerType")
+				}),
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					className: tabClass("upload"),
+					onClick: () => setTab("upload"),
+					children: t("demo.makerUpload")
+				}),
+				/* @__PURE__ */ jsx("div", { className: "flex-1" }),
+				value ? /* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: () => {
+						commitStrokes([]);
+						setText("");
+						setFileName(null);
+						onChange(null);
+					},
+					className: "text-fg-muted hover:text-fg text-xs",
+					children: t("demo.makerClear")
+				}) : null
+			]
+		}), tab === "draw" ? /* @__PURE__ */ jsx("canvas", {
+			ref: canvas,
+			style: {
+				width: PAD.width,
+				height: PAD.height,
+				touchAction: "none"
+			},
+			className: "border-border-subtle bg-surface text-fg rounded-md border",
+			onPointerDown: (e) => {
+				e.currentTarget.setPointerCapture(e.pointerId);
+				drawing.current = [point(e)];
+				setStrokes((s) => [...s, drawing.current]);
+			},
+			onPointerMove: (e) => {
+				if (!drawing.current) return;
+				drawing.current.push(point(e));
+				setStrokes((s) => [...s.slice(0, -1), [...drawing.current]]);
+			},
+			onPointerUp: () => {
+				if (!drawing.current) return;
+				const done = drawing.current;
+				drawing.current = null;
+				setStrokes((s) => {
+					const next = [...s.slice(0, -1), done];
+					commitStrokes(next);
+					return next;
+				});
+			}
+		}) : tab === "type" ? /* @__PURE__ */ jsxs("div", {
+			className: "flex flex-col gap-2",
+			children: [/* @__PURE__ */ jsx("input", {
+				value: text,
+				placeholder: t("demo.makerTypePlaceholder"),
+				onChange: (e) => void commitText(e.target.value, font),
+				className: "border-border bg-surface text-fg w-full rounded border px-2 py-1.5 text-sm"
+			}), /* @__PURE__ */ jsxs("label", {
+				className: "text-fg-muted flex items-center gap-2 text-xs",
+				children: [t("demo.makerFont"), /* @__PURE__ */ jsx("select", {
+					value: font,
+					onChange: (e) => void commitText(text, e.target.value),
+					className: "border-border bg-surface text-fg rounded border px-2 py-1 text-xs",
+					children: fonts.map((f) => /* @__PURE__ */ jsx("option", {
+						value: f.key,
+						children: f.label
+					}, f.key))
+				})]
+			})]
+		}) : /* @__PURE__ */ jsxs("label", {
+			className: "border-border-subtle text-fg-muted hover:bg-hover flex h-24 cursor-pointer items-center justify-center rounded-md border border-dashed text-sm",
+			children: [fileName ?? t("demo.makerUploadHint"), /* @__PURE__ */ jsx("input", {
+				type: "file",
+				accept: "image/png,image/jpeg,application/pdf",
+				className: "hidden",
+				onChange: (e) => {
+					const file = e.currentTarget.files?.[0];
+					e.currentTarget.value = "";
+					if (file) pickFile(file);
+				}
+			})]
+		})]
+	});
+}
+function SignatureMakerModal() {
+	const t = useT();
+	const surface = useSurface("signature-maker");
+	const stamp = useStamp();
+	const kernel = useKernel();
+	const config = useSignaturesConfig();
+	const [name, setName] = useState("");
+	const [signatureMark, setSignatureMark] = useState(null);
+	const [initialsMark, setInitialsMark] = useState(null);
+	const [busy, setBusy] = useState(false);
+	const [error, setError] = useState(null);
+	const existingId = surface.props?.libraryId;
+	const existing = existingId ? stamp.library(existingId) : null;
+	const wantsInitials = (config.kinds ?? ["signature", "initials"]).includes("initials");
+	const fonts = [...(config.fonts ?? []).map((f) => ({
+		key: f.key,
+		label: f.label
+	})), ...BUILTIN_FONTS];
+	const registered = useRef(/* @__PURE__ */ new Set());
+	const registerFont = async (key) => {
+		const spec = config.fonts?.find((f) => f.key === key);
+		if (!spec || registered.current.has(key) || !kernel.engine.fonts) return;
+		const response = await fetch(spec.url);
+		if (!response.ok) throw new Error(`${spec.url}: HTTP ${response.status}`);
+		await kernel.engine.fonts.register({
+			key,
+			data: new Uint8Array(await response.arrayBuffer())
+		});
+		registered.current.add(key);
+	};
+	if (!surface.isOpen) return null;
+	const canSave = existing ? initialsMark != null : name.trim().length > 0 && signatureMark != null;
+	const save = async () => {
+		setBusy(true);
+		setError(null);
+		try {
+			if (existing) await stamp.addAsset({
+				libraryId: existing.id,
+				name: INITIALS_MARK_NAME,
+				label: t("demo.initialsLabel"),
+				mark: initialsMark
+			});
+			else {
+				const libraryId = await stamp.createLibrary(name.trim(), { kind: SIGNATURES_LIBRARY_KIND });
+				await stamp.addAsset({
+					libraryId,
+					name: SIGNATURE_MARK_NAME,
+					label: t("demo.signatureLabel"),
+					mark: signatureMark
+				});
+				if (initialsMark) await stamp.addAsset({
+					libraryId,
+					name: INITIALS_MARK_NAME,
+					label: t("demo.initialsLabel"),
+					mark: initialsMark
+				});
+			}
+			setName("");
+			setSignatureMark(null);
+			setInitialsMark(null);
+			surface.close();
+		} catch (err) {
+			console.error("[embedpdf] saving the signature failed:", err);
+			setError(t("demo.makerError"));
+		} finally {
+			setBusy(false);
+		}
+	};
+	return /* @__PURE__ */ jsx("div", {
+		className: "fixed inset-0 z-50 grid place-items-center bg-black/40",
+		children: /* @__PURE__ */ jsxs("div", {
+			className: "border-border bg-surface w-[26rem] rounded-lg border p-4 shadow-xl",
+			children: [
+				/* @__PURE__ */ jsxs("div", {
+					className: "flex items-center justify-between",
+					children: [/* @__PURE__ */ jsx("h2", {
+						className: "text-fg text-base font-semibold",
+						children: existing ? t("demo.signaturesAddInitials") : t("demo.makerTitle")
+					}), /* @__PURE__ */ jsx("button", {
+						type: "button",
+						onClick: surface.close,
+						className: "text-fg-muted hover:bg-hover grid h-7 w-7 place-items-center rounded-md",
+						"aria-label": t("demo.cancel"),
+						children: /* @__PURE__ */ jsx(Icon, {
+							name: "x",
+							size: 16
+						})
+					})]
+				}),
+				existing ? null : /* @__PURE__ */ jsxs("label", {
+					className: "text-fg-muted mt-3 block text-xs",
+					children: [t("demo.makerName"), /* @__PURE__ */ jsx("input", {
+						value: name,
+						placeholder: t("demo.makerNamePlaceholder"),
+						onChange: (e) => setName(e.target.value),
+						className: "border-border bg-surface text-fg mt-1 w-full rounded border px-2 py-1.5 text-sm"
+					})]
+				}),
+				existing ? null : /* @__PURE__ */ jsxs("div", {
+					className: "mt-3",
+					children: [/* @__PURE__ */ jsx("p", {
+						className: "text-fg mb-1 text-xs font-semibold uppercase tracking-wide",
+						children: t("demo.signatureLabel")
+					}), /* @__PURE__ */ jsx(MarkPad, {
+						value: signatureMark,
+						onChange: setSignatureMark,
+						fonts,
+						registerFont
+					})]
+				}),
+				wantsInitials ? /* @__PURE__ */ jsxs("div", {
+					className: "mt-3",
+					children: [/* @__PURE__ */ jsxs("p", {
+						className: "text-fg mb-1 text-xs font-semibold uppercase tracking-wide",
+						children: [t("demo.initialsLabel"), existing ? null : /* @__PURE__ */ jsx("span", {
+							className: "text-fg-muted ml-1 font-normal normal-case tracking-normal",
+							children: t("demo.makerOptional")
+						})]
+					}), /* @__PURE__ */ jsx(MarkPad, {
+						value: initialsMark,
+						onChange: setInitialsMark,
+						fonts,
+						registerFont
+					})]
+				}) : null,
+				error ? /* @__PURE__ */ jsx("p", {
+					className: "mt-2 text-sm text-red-600",
+					children: error
+				}) : null,
+				/* @__PURE__ */ jsxs("div", {
+					className: "mt-4 flex justify-end gap-2",
+					children: [/* @__PURE__ */ jsx("button", {
+						type: "button",
+						disabled: busy,
+						onClick: surface.close,
+						className: "border-border text-fg hover:bg-hover rounded-md border px-3 py-1.5 text-sm",
+						children: t("demo.cancel")
+					}), /* @__PURE__ */ jsx("button", {
+						type: "button",
+						disabled: busy || !canSave,
+						onClick: () => void save(),
+						className: "bg-accent text-on-accent rounded-md px-3 py-1.5 text-sm disabled:opacity-60",
+						children: busy ? t("demo.makerSaving") : t("demo.makerSave")
+					})]
+				})
+			]
+		})
+	});
+}
+//#endregion
 //#region src/ui/document-boot.tsx
 /**
 * Boot-state panes for the document area — what renders INSTEAD of the Stage
@@ -3886,9 +5463,10 @@ function Shell() {
 			className: "w-full"
 		})
 	});
-	return /* @__PURE__ */ jsxs("div", {
+	return /* @__PURE__ */ jsx(AnnotationFontsProvider, { children: /* @__PURE__ */ jsxs("div", {
 		className: "bg-app text-fg flex h-full flex-col",
 		children: [
+			/* @__PURE__ */ jsx(StampLibraryStore, {}),
 			(frame.header ?? true) && /* @__PURE__ */ jsx("slot", { name: "header" }),
 			(frame.tabs ?? "always") !== "never" && /* @__PURE__ */ jsx("slot", {
 				name: "tabs",
@@ -3908,6 +5486,7 @@ function Shell() {
 								overlay: /* @__PURE__ */ jsxs(Fragment$1, { children: [
 									/* @__PURE__ */ jsx(AnnotationStrip, {}),
 									/* @__PURE__ */ jsx(SelectionStrip, {}),
+									/* @__PURE__ */ jsx(SignatureInspector, {}),
 									/* @__PURE__ */ jsx(SelectionHandles, {}),
 									/* @__PURE__ */ jsx(Scrollbar, { axis: "y" }),
 									/* @__PURE__ */ jsx(Scrollbar, { axis: "x" })
@@ -3926,12 +5505,15 @@ function Shell() {
 						]
 					}),
 					/* @__PURE__ */ jsx(RightSidebar, {}),
-					/* @__PURE__ */ jsx(RedactConfirmModal, {})
+					/* @__PURE__ */ jsx(RedactConfirmModal, {}),
+					/* @__PURE__ */ jsx(SignatureBridge, {}),
+					/* @__PURE__ */ jsx(SignDialog, {}),
+					/* @__PURE__ */ jsx(SignatureMakerModal, {})
 				] })
 			}),
 			toolbarEdge === "bottom" && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(ModeBand, { edge: "bottom" }), toolbarBand] })
 		]
-	});
+	}) });
 }
 //#endregion
 //#region src/viewer.tsx
@@ -3954,7 +5536,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-sN6uqBgD.js").then((m) => m.es) };
 const isDict = (v) => typeof v === "object" && v !== null;
 /**
 * Deep-merge `over` into `base` (immutably), expanding dotted keys —
@@ -3998,7 +5580,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, signatures, annotations, 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 +5611,9 @@ function FullViewer({ engine, initialDocuments, fallback, commands, icons, strin
 			commands: resolvedCommands,
 			chrome: resolvedChrome,
 			icons: icons ?? {},
+			stamps: stamps ?? {},
+			signatures: signatures ?? {},
+			annotations: annotations ?? {},
 			i18n: {
 				locales,
 				loaders,
@@ -4077,9 +5662,29 @@ 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(),
+		signaturePlugin({
+			mode: resolved.signatures.mode,
+			signer: resolved.signatures.signer,
+			trust: resolved.signatures.trust,
+			allowCertify: resolved.signatures.allowCertify
+		}),
 		linkPlugin(),
 		redactionPlugin(),
 		searchPlugin(),
@@ -4113,6 +5718,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, SignatureToken, StageToken, StampToken, addItem, chromeHelpers, createTestSigner, createViewerHandle, custom, defaultChrome, defaultCommands, ICON_PATHS as defaultIcons, defineChrome, group, indexedDbKeyStore, item, memoryKeyStore, personalSigner, remoteSigner, removeItems, replaceItem, themeConfigOf, validateChrome, webCryptoSigner };
 
 //# sourceMappingURL=index.js.map