@embedpdf/plugin-signature 2.15.0 → 3.0.0-next.13

package/dist/index.cjs

@@ -1,2 +1,498 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@embedpdf/core"),e=require("@embedpdf/models"),i=require("@embedpdf/plugin-annotation");var n=(t=>(t.SignatureOnly="signature-only",t.SignatureAndInitials="signature-and-initials",t))(n||{}),a=(t=>(t.Draw="draw",t.Type="type",t.Upload="upload",t))(a||{}),r=(t=>(t.Signature="signature",t.Initials="initials",t))(r||{});const o="signature",s={id:o,name:"Signature Plugin",version:"1.0.0",provides:["signature"],requires:["annotation"],optional:[],defaultConfig:{mode:n.SignatureOnly}},l="SIGNATURE/ADD_ENTRY",h="SIGNATURE/REMOVE_ENTRY";function c(t){return{type:l,payload:t}}function u(t){return{type:h,payload:t}}const g={annotationType:e.PdfAnnotationSubtype.STAMP,create(t){const{onPreview:n,onCommit:a,getTool:r,pageSize:o,pageRotation:s,getToolContext:l}=t;return{onPointerMove:t=>{const i=l();if(!(null==i?void 0:i.targetSize))return;const{width:a,height:r}=i.targetSize;n({type:e.PdfAnnotationSubtype.STAMP,bounds:{origin:{x:t.x-a/2,y:t.y-r/2},size:{width:a,height:r}},data:{rect:{origin:{x:t.x-a/2,y:t.y-r/2},size:{width:a,height:r}},ghostUrl:i.ghostUrl,pageRotation:s}})},onPointerDown:h=>{var c;const u=r(),g=l();if(!u||!(null==g?void 0:g.targetSize))return;const{width:d,height:p}=g.targetSize,m={origin:{x:h.x-d/2,y:h.y-p/2},size:{width:d,height:p}};let y={...u.defaults,rect:m,type:e.PdfAnnotationSubtype.STAMP,name:e.PdfAnnotationName.Custom,subject:"Signature",flags:u.defaults.flags??["print"],pageIndex:t.pageIndex,id:e.uuidV4(),created:new Date};(null==(c=u.behavior)?void 0:c.insertUpright)&&(y=i.applyInsertUpright(y,s,!1)),y=i.clampAnnotationToPage(y,o),a(y,{data:g.imageData}),n(null)},onPointerLeave:()=>{n(null)}}}};function d(t,e,i){const n=e.width/t.size.width,a=e.height/t.size.height,r=Math.min(n,a),o=t.size.width*r,s=t.size.height*r,l=i.x-o/2,h=i.y-s/2;return{inkList:t.inkList.map(t=>({points:t.points.map(t=>({x:t.x*r+l,y:t.y*r+h}))})),strokeWidth:Math.round(t.strokeWidth*r*10)/10}}const p={annotationType:e.PdfAnnotationSubtype.INK,create(t){const{onPreview:n,onCommit:a,getTool:r,pageSize:o,getToolContext:s}=t;return{onPointerMove:t=>{const i=s();if(!(null==i?void 0:i.inkData)||!(null==i?void 0:i.targetSize))return;const{inkList:a,strokeWidth:r}=d(i.inkData,i.targetSize,t),o=a.flatMap(t=>t.points);if(0===o.length)return;const l=e.expandRect({origin:{x:Math.min(...o.map(t=>t.x)),y:Math.min(...o.map(t=>t.y))},size:{width:Math.max(...o.map(t=>t.x))-Math.min(...o.map(t=>t.x)),height:Math.max(...o.map(t=>t.y))-Math.min(...o.map(t=>t.y))}},r/2);n({type:e.PdfAnnotationSubtype.INK,bounds:l,data:{rect:l,inkList:a,strokeWidth:r,strokeColor:i.inkData.strokeColor,opacity:.5}})},onPointerDown:l=>{const h=r(),c=s();if(!h||!(null==c?void 0:c.inkData)||!(null==c?void 0:c.targetSize))return;const{inkList:u,strokeWidth:g}=d(c.inkData,c.targetSize,l),p=u.flatMap(t=>t.points);if(0===p.length)return;const m=e.expandRect({origin:{x:Math.min(...p.map(t=>t.x)),y:Math.min(...p.map(t=>t.y))},size:{width:Math.max(...p.map(t=>t.x))-Math.min(...p.map(t=>t.x)),height:Math.max(...p.map(t=>t.y))-Math.min(...p.map(t=>t.y))}},g/2);let y={...h.defaults,inkList:u,rect:m,strokeWidth:g,strokeColor:c.inkData.strokeColor,opacity:1,type:e.PdfAnnotationSubtype.INK,subject:"Signature",flags:h.defaults.flags??["print"],pageIndex:t.pageIndex,id:e.uuidV4(),created:new Date};const f=y.rect;y=i.clampAnnotationToPage(y,o);const S=y.rect.origin.x-f.origin.x,v=y.rect.origin.y-f.origin.y;0===S&&0===v||(y={...y,inkList:y.inkList.map(t=>({points:t.points.map(t=>({x:t.x+S,y:t.y+v}))}))}),a(y),n(null)},onPointerLeave:()=>{n(null)}}}},m="signatureStamp",y="signatureInk",f=[i.defineAnnotationTool({id:m,name:"Signature Stamp",labelKey:"signature.stamp",categories:["annotation","signature","insert"],matchScore:()=>0,interaction:{exclusive:!0,cursor:"copy",isDraggable:!0,isResizable:!0,isRotatable:!1,lockAspectRatio:!0,isGroupDraggable:!0,isGroupResizable:!1,isGroupRotatable:!1},defaults:{type:e.PdfAnnotationSubtype.STAMP},behavior:{deactivateToolAfterCreate:!0,selectAfterCreate:!0,insertUpright:!0,useAppearanceStream:!0},pointerHandler:g}),i.defineAnnotationTool({id:y,name:"Signature Ink",labelKey:"signature.ink",categories:["annotation","signature","insert"],matchScore:t=>t.type===e.PdfAnnotationSubtype.INK&&"Signature"===t.subject?20:0,interaction:{exclusive:!0,cursor:"copy",isDraggable:!0,isResizable:!0,isRotatable:!1,lockAspectRatio:!0,isGroupDraggable:!0,isGroupResizable:!1,isGroupRotatable:!1},defaults:{type:e.PdfAnnotationSubtype.INK},behavior:{deactivateToolAfterCreate:!0,selectAfterCreate:!0},transform:i.patching.patchInk,pointerHandler:p})],S=class extends t.BasePlugin{constructor(e,i,n){var a;if(super(e,i),this.config=n,this.entries=new Map,this.entriesChange$=t.createEmitter(),this.activePlacement$=t.createScopedEmitter((t,e)=>({documentId:t,activePlacement:e})),this.annotation=null,this.toolChangeUnsubscribe=null,this.currentGhostUrl=null,this.annotation=(null==(a=i.getPlugin("annotation"))?void 0:a.provides())??null,this.annotation){for(const t of f)this.annotation.addTool(t);this.toolChangeUnsubscribe=this.annotation.onActiveToolChange(({documentId:t,tool:e})=>{(null==e?void 0:e.id)!==m&&(null==e?void 0:e.id)!==y&&(this.revokeGhostUrl(),this.activePlacement$.emit(t,null))})}}async initialize(){}buildCapability(){return{mode:this.config.mode,getEntries:()=>this.getEntries(),addEntry:t=>this.addEntry(t),removeEntry:t=>this.removeEntry(t),loadEntries:t=>this.loadEntries(t),exportEntries:()=>this.exportEntries(),onEntriesChange:this.entriesChange$.on,forDocument:t=>this.createSignatureScope(t),onActivePlacementChange:this.activePlacement$.onGlobal}}getEntries(){return Array.from(this.entries.values())}addEntry(t){const i=e.uuidV4(),n={...t,id:i,createdAt:Date.now()};return this.entries.set(i,n),this.dispatch(c(i)),this.emitEntriesChange(),i}removeEntry(t){this.entries.has(t)&&(this.entries.delete(t),this.dispatch(u(t)),this.emitEntriesChange())}loadEntries(t){for(const e of t)this.entries.set(e.id,e),this.dispatch(c(e.id));this.emitEntriesChange()}exportEntries(){return this.getEntries()}createSignatureScope(t){return{activateSignaturePlacement:e=>this.activatePlacement(t,e,r.Signature),activateInitialsPlacement:e=>this.activatePlacement(t,e,r.Initials),deactivatePlacement:()=>this.deactivatePlacement(t),getActivePlacement:()=>this.activePlacement$.getValue(t)??null,onActivePlacementChange:this.activePlacement$.forScope(t)}}activatePlacement(t,e,i){const n=this.entries.get(e);if(!n||!this.annotation)return;const o=i===r.Initials?n.initials:n.signature;if(o){if(this.revokeGhostUrl(),o.creationType===a.Draw){if(n.signature.creationType!==a.Draw)return;const t=this.config.defaultSize??{width:150,height:50},r=n.signature.inkData.size,s=Math.min(t.width/r.width,t.height/r.height),l={width:o.inkData.size.width*s,height:o.inkData.size.height*s};this.annotation.setActiveTool(y,{inkData:o.inkData,targetSize:l,entryId:e,kind:i})}else{if(!o.imageData)return;const t=URL.createObjectURL(new Blob([o.imageData],{type:o.imageMimeType??"image/png"}));this.currentGhostUrl=t;const r=this.config.defaultSize??{width:150,height:50};let s=r;if(o.imageSize){const t=n.signature.creationType!==a.Draw?n.signature.imageSize??o.imageSize:o.imageSize,e=Math.min(r.width/t.width,r.height/t.height);s={width:o.imageSize.width*e,height:o.imageSize.height*e}}this.annotation.setActiveTool(m,{imageData:o.imageData,ghostUrl:t,targetSize:s,entryId:e,kind:i})}this.activePlacement$.emit(t,{entryId:e,kind:i})}}deactivatePlacement(t){this.annotation&&(this.annotation.setActiveTool(null),this.revokeGhostUrl(),this.activePlacement$.emit(t,null))}revokeGhostUrl(){this.currentGhostUrl&&(URL.revokeObjectURL(this.currentGhostUrl),this.currentGhostUrl=null)}emitEntriesChange(){this.entriesChange$.emit(this.getEntries())}async destroy(){var t;this.revokeGhostUrl(),null==(t=this.toolChangeUnsubscribe)||t.call(this),this.entries.clear()}};S.id=o;let v=S;const x={entryIds:[]},A=(t=x,e)=>{switch(e.type){case l:return{...t,entryIds:[...t.entryIds,e.payload]};case h:return{...t,entryIds:t.entryIds.filter(t=>t!==e.payload)};default:return t}};function P(t){const e=new Uint8Array(t);let i="";for(let n=0;n<e.length;n++)i+=String.fromCharCode(e[n]);return btoa(i)}function b(t){const e=atob(t),i=new Uint8Array(e.length);for(let n=0;n<e.length;n++)i[n]=e.charCodeAt(n);return i.buffer}function k(t){if(t.creationType===a.Draw)return t;const{imageData:e,...i}=t;return{...i,imageData:e?P(e):void 0}}function T(t){if(t.creationType===a.Draw)return t;const{imageData:e,...i}=t;return{...i,imageData:e?b(e):void 0}}const D={manifest:s,create:(t,e)=>new v(o,t,e),reducer:A,initialState:x};exports.ADD_SIGNATURE_ENTRY=l,exports.REMOVE_SIGNATURE_ENTRY=h,exports.SIGNATURE_INK_TOOL_ID=y,exports.SIGNATURE_PLUGIN_ID=o,exports.SIGNATURE_STAMP_TOOL_ID=m,exports.SignatureCreationType=a,exports.SignatureFieldKind=r,exports.SignatureMode=n,exports.SignaturePlugin=v,exports.SignaturePluginPackage=D,exports.addSignatureEntry=c,exports.deserializeEntries=function(t){return t.map(t=>({id:t.id,createdAt:t.createdAt,signature:T(t.signature),...t.initials&&{initials:T(t.initials)}}))},exports.initialState=x,exports.manifest=s,exports.removeSignatureEntry=u,exports.serializeEntries=function(t){return t.map(t=>({id:t.id,createdAt:t.createdAt,signature:k(t.signature),...t.initials&&{initials:k(t.initials)}}))},exports.signatureReducer=A;
-//# sourceMappingURL=index.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_contract = require("./contract-CojqGdMH.cjs");
+let _embedpdf_core = require("@embedpdf/core");
+let _embedpdf_plugin_form_contract = require("@embedpdf/plugin-form/contract");
+let _embedpdf_plugin_interaction_contract = require("@embedpdf/plugin-interaction/contract");
+let _embedpdf_plugin_stamp_contract = require("@embedpdf/plugin-stamp/contract");
+let _embedpdf_plugin_annotation_contract = require("@embedpdf/plugin-annotation/contract");
+let _embedpdf_core_signature = require("@embedpdf/core-signature");
+let _embedpdf_engine_core_runtime = require("@embedpdf/engine-core/runtime");
+//#region src/blank-page.ts
+const OBJECTS = [
+	"<< /Type /Catalog /Pages 2 0 R >>",
+	"<< /Type /Pages /Kids [3 0 R] /Count 1 >>",
+	"<< /Type /Page /Parent 2 0 R /MediaBox [0 0 200 60] /Contents 4 0 R /Resources << >> >>",
+	`<< /Length 3 >>\nstream\nq Q\nendstream`
+];
+let cached = null;
+function blankPagePdf() {
+	if (cached) return new Uint8Array(cached);
+	let body = "%PDF-1.7\n";
+	const offsets = [];
+	OBJECTS.forEach((object, index) => {
+		offsets.push(body.length);
+		body += `${index + 1} 0 obj\n${object}\nendobj\n`;
+	});
+	const xref = body.length;
+	body += `xref\n0 ${OBJECTS.length + 1}\n0000000000 65535 f \n`;
+	for (const offset of offsets) body += `${String(offset).padStart(10, "0")} 00000 n \n`;
+	body += `trailer\n<< /Size ${OBJECTS.length + 1} /Root 1 0 R >>\nstartxref\n${xref}\n%%EOF\n`;
+	cached = new TextEncoder().encode(body);
+	return new Uint8Array(cached);
+}
+//#endregion
+//#region src/capability.ts
+const sameRef = (a, b) => a.kind === "objectNumber" && b.kind === "objectNumber" ? a.fieldObjectNumber === b.fieldObjectNumber : a.kind === "fqn" && b.kind === "fqn" ? a.name === b.name : false;
+const sameProtection = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+function createSignatureCapability(ctx, config = {}) {
+	const form = ctx.get(_embedpdf_plugin_form_contract.FormToken);
+	const changed = (0, _embedpdf_core.createEventHook)((error) => globalThis.console?.error("[signature] listener failed:", error));
+	ctx.cleanup(() => changed.dispose());
+	const state = () => ctx.getState();
+	const requireDoc = () => {
+		const doc = ctx.doc;
+		if (!doc) throw new Error("[signature] no document bound");
+		return doc;
+	};
+	const requireSignatures = () => {
+		const doc = requireDoc();
+		if (!doc.signatures) throw new Error("[signature] this engine does not implement signatures");
+		return {
+			doc,
+			signatures: doc.signatures
+		};
+	};
+	const stamp = () => ctx.tryGet(_embedpdf_plugin_stamp_contract.StampToken);
+	const documentId = () => {
+		const id = ctx.documentId;
+		if (!id) throw new Error("[signature] no document id");
+		return id;
+	};
+	const mode = () => config.mode ?? (config.signer ? "sign" : "visual");
+	const resolveSigner = async () => {
+		const signer = config.signer;
+		if (!signer) throw new Error("[signature] no signer configured (mode \"sign\" needs one)");
+		return typeof signer === "function" ? signer() : signer;
+	};
+	const allows = (cap) => ctx.doc?.security.allows(cap) ?? false;
+	const refresh = async () => {
+		const doc = ctx.doc;
+		if (!doc?.signatures) {
+			ctx.dispatch({
+				type: "SNAPSHOT",
+				snapshot: null
+			});
+			return null;
+		}
+		const before = state().snapshot?.protection ?? null;
+		const snapshot = await doc.signatures.list();
+		ctx.dispatch({
+			type: "SNAPSHOT",
+			snapshot
+		});
+		if (!sameProtection(before, snapshot.protection)) changed.emit({
+			type: "protectionChanged",
+			protection: snapshot.protection
+		});
+		return snapshot;
+	};
+	const validate = async (opts) => {
+		const doc = ctx.doc;
+		if (!doc?.signatures) return [];
+		const verdicts = await (0, _embedpdf_core_signature.validateSignatures)(doc, {
+			trust: config.trust ?? null,
+			at: opts?.at,
+			until: opts?.until ?? "working-copy"
+		});
+		const before = state().verdicts;
+		ctx.dispatch({
+			type: "VERDICTS",
+			verdicts
+		});
+		changed.emit({
+			type: "validated",
+			verdicts
+		});
+		for (const v of verdicts) {
+			if (v.modifications.basis !== "working-copy" || v.summary !== "invalid") continue;
+			const was = before?.find((b) => b.signature.index === v.signature.index);
+			if (was && was.summary === "invalid") continue;
+			changed.emit({
+				type: "invalidating",
+				field: v.signature.field,
+				detail: v.modifications.detail ?? ""
+			});
+		}
+		return verdicts;
+	};
+	let revalidateTimer = null;
+	const revalidateSoon = () => {
+		if (!state().snapshot?.signatures.some((s) => s.signed)) return;
+		if (revalidateTimer) clearTimeout(revalidateTimer);
+		revalidateTimer = setTimeout(() => {
+			revalidateTimer = null;
+			validate().catch((error) => globalThis.console?.error("[signature] re-validation failed:", error));
+		}, 300);
+	};
+	ctx.cleanup(() => {
+		if (revalidateTimer) clearTimeout(revalidateTimer);
+	});
+	const analyze = (input) => requireSignatures().signatures.analyze(input);
+	const signatureOf = (field) => {
+		const snapshot = state().snapshot;
+		if (!snapshot) return null;
+		if ("annotObjectNumber" in field) {
+			const byWidget = snapshot.signatures.find((s) => s.widget?.annotObjectNumber === field.annotObjectNumber);
+			if (byWidget) return byWidget;
+			const owner = form.fieldForWidget(field.annotObjectNumber);
+			return owner ? signatureOf(owner.ref) : null;
+		}
+		return snapshot.signatures.find((s) => field.kind === "fqn" ? s.fieldName === field.name : sameRef(s.field, field)) ?? null;
+	};
+	const verdictOf = (field) => {
+		const signature = signatureOf(field);
+		if (!signature) return null;
+		return state().verdicts?.find((v) => v.signature.index === signature.index) ?? null;
+	};
+	const bytesOf = async (source) => new Uint8Array((await (0, _embedpdf_engine_core_runtime.resolveBinarySource)(source)).bytes);
+	const markBytes = async (mark) => {
+		if ("assetId" in mark) {
+			const bytes = stamp()?.assetBytes(mark.assetId);
+			if (!bytes) throw new Error(`[signature] unknown mark '${mark.assetId}'`);
+			return bytes;
+		}
+		return bytesOf(mark.source);
+	};
+	const withBusy = async (work) => {
+		ctx.dispatch({
+			type: "BUSY",
+			busy: true
+		});
+		try {
+			return await work();
+		} finally {
+			ctx.dispatch({
+				type: "BUSY",
+				busy: false
+			});
+		}
+	};
+	const signField = (input) => withBusy(async () => {
+		const { doc } = requireSignatures();
+		const signer = await resolveSigner();
+		const subject = signer.kind === "raw" && signer.certificateChain[0] ? (0, _embedpdf_core_signature.certificateCommonName)(signer.certificateChain[0]) : null;
+		const attribution = {
+			...subject ? { name: subject } : {},
+			...input.attribution
+		};
+		const appearance = input.appearance ? await bytesOf(input.appearance) : await markBytes(input.mark);
+		const result = await (0, _embedpdf_core_signature.sign)(doc, {
+			field: input.field,
+			signer,
+			attribution,
+			certify: input.certify,
+			lock: input.lock,
+			appearance: {
+				pdf: appearance,
+				pageIndex: 0
+			}
+		});
+		if (state().target && sameRef(state().target, input.field)) setTarget(null);
+		await refresh();
+		validate().catch((error) => globalThis.console?.error("[signature] validation after signing failed:", error));
+		changed.emit({
+			type: "signed",
+			field: input.field,
+			result
+		});
+		return result;
+	});
+	const setAppearance = async (field, pdf) => {
+		const doc = requireDoc();
+		if (!doc.forms.setSignatureAppearance) throw new Error("[signature] this engine cannot draw into a signature field");
+		const signature = signatureOf(field);
+		if (signature?.signed) throw new Error(`[signature] '${signature.fieldName}' is signed`);
+		await doc.forms.setSignatureAppearance(field, {
+			pdf,
+			pageIndex: 0
+		});
+		await form.refresh();
+	};
+	const fillField = (field, mark) => withBusy(async () => {
+		await setAppearance(field, await markBytes(mark));
+		if (state().target && sameRef(state().target, field)) setTarget(null);
+		changed.emit({
+			type: "filled",
+			field
+		});
+	});
+	const clearField = (field) => withBusy(async () => {
+		await setAppearance(field, blankPagePdf());
+		changed.emit({
+			type: "cleared",
+			field
+		});
+	});
+	const placeMark = async (mark, target) => {
+		if (!("field" in target)) {
+			if ("assetId" in mark) {
+				const library = stamp();
+				if (!library) throw new Error("[signature] no stamp plugin to place an asset");
+				await library.placeAsset(documentId(), mark.assetId, target);
+			} else await ctx.get(_embedpdf_plugin_annotation_contract.AnnotationToken).placeStamp({ source: mark.source }, target);
+			return;
+		}
+		switch (mode()) {
+			case "sign":
+				if (config.allowCertify && !state().snapshot?.signatures.some((s) => s.signed)) {
+					changed.emit({
+						type: "ask",
+						field: target.field,
+						mark
+					});
+					return;
+				}
+				await signField({
+					field: target.field,
+					mark
+				});
+				return;
+			case "visual":
+				await fillField(target.field, mark);
+				return;
+			case "ask":
+				changed.emit({
+					type: "ask",
+					field: target.field,
+					mark
+				});
+				return;
+		}
+	};
+	const setTarget = (field) => {
+		const current = state().target;
+		if (current === field || current && field && sameRef(current, field)) return;
+		ctx.dispatch({
+			type: "TARGET",
+			field
+		});
+		changed.emit({
+			type: "target",
+			field
+		});
+	};
+	const doc = ctx.doc;
+	if (doc) {
+		const unsubscribe = doc.events.subscribe((event) => {
+			switch (event.type) {
+				case "signature.prepared":
+					ctx.dispatch({
+						type: "PENDING",
+						pending: {
+							signingId: event.signingId,
+							field: event.field
+						}
+					});
+					return;
+				case "signature.aborted":
+					ctx.dispatch({
+						type: "PENDING",
+						pending: null
+					});
+					return;
+				case "signature.completed":
+					ctx.dispatch({
+						type: "PENDING",
+						pending: null
+					});
+					return;
+				case "document.versioned":
+				case "stream.desynced":
+					refresh().then(() => validate()).catch((error) => globalThis.console?.error("[signature] refresh failed:", error));
+					return;
+				case "form.fieldCreated":
+				case "form.fieldDeleted":
+				case "form.widgetAttached":
+				case "form.widgetDetached":
+				case "form.imported":
+				case "form.repaired":
+					refresh().then(() => revalidateSoon()).catch((error) => globalThis.console?.error("[signature] refresh failed:", error));
+					return;
+				case "annotation.created":
+				case "annotation.updated":
+				case "annotation.deleted":
+				case "annotation.moved":
+				case "form.valueChanged":
+				case "form.fieldUpdated":
+				case "form.effectsApplied":
+					revalidateSoon();
+					return;
+				default: return;
+			}
+		});
+		ctx.cleanup(unsubscribe);
+	}
+	return {
+		snapshot: () => state().snapshot,
+		verdicts: () => state().verdicts,
+		protection: () => state().snapshot?.protection ?? null,
+		pending: () => state().pending,
+		target: () => state().target,
+		busy: () => state().busy,
+		mode,
+		signatureOf,
+		verdictOf,
+		canSign: () => allows("doc.sign") && config.signer != null,
+		canFill: () => allows("doc.forms.fill") && ctx.doc?.forms.setSignatureAppearance != null,
+		canCertify: () => config.allowCertify === true && allows("doc.sign.certify"),
+		signField,
+		fillField,
+		clearField,
+		placeMark,
+		setTarget,
+		inspect: (field) => changed.emit({
+			type: "inspect",
+			field
+		}),
+		refresh,
+		validate,
+		analyze,
+		revisionBytes: (revisionIndex) => requireSignatures().signatures.revisionBytes(revisionIndex),
+		onChanged: changed.on
+	};
+}
+//#endregion
+//#region src/handler.ts
+/**
+* The armed mark over a field. The annotation plugin places an armed stamp
+* on click (`annotation-place`, priority 95) and selects an existing
+* annotation under the pointer before that (`annotation-edit`, 100 — a
+* widget is an annotation). This handler sits above BOTH, enabled for the
+* armed stamp's tool only, and captures exactly when the armed asset is a
+* person's mark (a library of kind `signatures`) and the pointer is over a
+* signature field: then the destination decides — the mark goes INTO the
+* field (`placeMark` by mode) instead of onto the page. Everywhere else it
+* declines and the click stays a stamp placement, as in Preview.
+*/
+function createArmedMarkHandler(documentId, signature, form, stamp) {
+	return {
+		id: "signature:armed-mark-on-field",
+		priority: _embedpdf_plugin_annotation_contract.ANNOTATION_EDIT_PRIORITY + 1,
+		enabledFor: (tool) => tool.id === _embedpdf_plugin_annotation_contract.ARMED_STAMP_TOOL_ID,
+		onDown: (sample) => {
+			if (!sample.page) return false;
+			const armed = stamp.armedAsset(documentId);
+			if (!armed || stamp.library(armed.libraryId)?.kind !== "signatures") return false;
+			const hit = form.widgetAt(sample.page.pon, sample.page.point);
+			if (!hit || hit.field.family !== "signature") return false;
+			if (signature.signatureOf(hit.field.ref)?.signed || hit.field.valueEntry.kind !== "none") return true;
+			stamp.disarm(documentId);
+			signature.placeMark({ assetId: armed.id }, { field: hit.field.ref }).catch((error) => globalThis.console?.error("[signature] placing the mark failed:", error));
+			return true;
+		}
+	};
+}
+//#endregion
+//#region src/reducer.ts
+const initialSignatureState = () => ({
+	snapshot: null,
+	verdicts: null,
+	target: null,
+	pending: null,
+	busy: false
+});
+function signatureReducer(state, action) {
+	switch (action.type) {
+		case "SNAPSHOT": return {
+			...state,
+			snapshot: action.snapshot
+		};
+		case "VERDICTS": return {
+			...state,
+			verdicts: action.verdicts
+		};
+		case "TARGET": return {
+			...state,
+			target: action.field
+		};
+		case "PENDING": return {
+			...state,
+			pending: action.pending
+		};
+		case "BUSY": return {
+			...state,
+			busy: action.busy
+		};
+		default: return state;
+	}
+}
+//#endregion
+//#region src/signature.plugin.ts
+/**
+* The signature plugin — the ACT of signing, document-scoped. It owns no
+* mark: marks are stamp-library assets (or bytes the embedder brings), and
+* the mark IS the appearance the engine draws into the field. Signing goes
+* through `@embedpdf/core-signature` with the configured signer port; the
+* engine seals; on the cloud the server publishes the new version.
+*
+* With the interaction hub and the stamp plugin present, an armed mark from
+* a `signatures` library dropped over an unsigned signature field goes into
+* the field (sign / visual fill / ask, by mode) instead of onto the page.
+*/
+const signaturePlugin = (config = {}) => (0, _embedpdf_core.definePlugin)({
+	id: "signature",
+	token: require_contract.SignatureToken,
+	scope: "document",
+	requires: [_embedpdf_plugin_form_contract.FormToken],
+	optional: [
+		_embedpdf_plugin_interaction_contract.InteractionToken,
+		_embedpdf_plugin_stamp_contract.StampToken,
+		_embedpdf_plugin_annotation_contract.AnnotationToken
+	],
+	initialState: initialSignatureState,
+	reduce: signatureReducer,
+	capability: (ctx) => createSignatureCapability(ctx, config),
+	init: (ctx) => {
+		const signature = ctx.get(require_contract.SignatureToken);
+		signature.refresh().then((snapshot) => snapshot?.signatures.some((s) => s.signed) ? signature.validate() : null).catch((error) => globalThis.console?.error("[signature] initial read failed:", error));
+		const interaction = ctx.tryGet(_embedpdf_plugin_interaction_contract.InteractionToken);
+		const stamp = ctx.tryGet(_embedpdf_plugin_stamp_contract.StampToken);
+		if (interaction && stamp && ctx.documentId) ctx.cleanup(interaction.registerHandler(createArmedMarkHandler(ctx.documentId, signature, ctx.get(_embedpdf_plugin_form_contract.FormToken), stamp)));
+	}
+});
+//#endregion
+exports.INITIALS_MARK_NAME = require_contract.INITIALS_MARK_NAME;
+exports.SIGNATURES_LIBRARY_KIND = require_contract.SIGNATURES_LIBRARY_KIND;
+exports.SIGNATURE_MARK_NAME = require_contract.SIGNATURE_MARK_NAME;
+exports.SignatureToken = require_contract.SignatureToken;
+exports.createArmedMarkHandler = createArmedMarkHandler;
+Object.defineProperty(exports, "createTestSigner", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_core_signature.createTestSigner;
+	}
+});
+Object.defineProperty(exports, "indexedDbKeyStore", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_core_signature.indexedDbKeyStore;
+	}
+});
+exports.markRoleOf = require_contract.markRoleOf;
+Object.defineProperty(exports, "memoryKeyStore", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_core_signature.memoryKeyStore;
+	}
+});
+Object.defineProperty(exports, "personalSigner", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_core_signature.personalSigner;
+	}
+});
+Object.defineProperty(exports, "remoteSigner", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_core_signature.remoteSigner;
+	}
+});
+exports.signaturePlugin = signaturePlugin;
+Object.defineProperty(exports, "webCryptoSigner", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_core_signature.webCryptoSigner;
+	}
+});
+
+//# sourceMappingURL=index.cjs.map