@embedpdf/plugin-annotation 3.0.0-next.11 → 3.0.0-next.12

package/dist/{capability-DBsr2D-L.js → capability-Bh_1PL5v.js}

@@ -1,4 +1,5 @@
 import { a as contentToPdfRect$1, c as insetPdfRectByRD, d as refKey, f as rotFromDTO, g as writableTarget, i as contentToPdfPoint, l as pdfToContentPoint$1, m as toPdfRotation, n as boxGeomFromDTO, o as cssToColor, p as styleFromDTO, r as colorToCss, s as fromPdfRotation, t as boxGeomFields, u as pdfToContentRect$1 } from "./seam-C4L_7rDt.js";
+import { n as previewBucket } from "./types-BvB1vUKb.js";
 import { CONTINUOUS_RENDER_POLICY, snapAppearanceScale } from "@embedpdf/core";
 import { ActionsToken, createHoverPump } from "@embedpdf/plugin-actions/contract";
 import { InteractionToken } from "@embedpdf/plugin-interaction/contract";
@@ -774,6 +775,15 @@ function buildTextItems(m, pon, view) {
 //#endregion
 //#region src/tools.ts
 /**
+* The tool `armStamp` activates — and the only tool an armed payload survives
+* onto (plus the legacy `annotation-stamp` tag, honoured for embedder configs
+* written before the tags were unified). Placement consults the armed payload
+* BEFORE the active tool's own `source` spec, so a payload must not outlive
+* its tool onto a sibling stamp preset: an `image` preset's click has to open
+* its own picker, not silently place whatever the stamp panel last armed.
+*/
+const ARMED_STAMP_TOOL_ID = "stamp";
+/**
 * The creation properties each known authoring kind actually consumes. This is
 * deliberately separate from the flat internal patch vocabulary: it gives tool
 * configuration precise compile-time and runtime validation while mixed-selection
@@ -1107,7 +1117,7 @@ const DEFAULT_TOOLS = [
 		}
 	},
 	{
-		id: "stamp",
+		id: ARMED_STAMP_TOOL_ID,
 		subtype: "stamp",
 		cursor: "copy",
 		enables: ["annotation-place", "annotation-edit"],
@@ -1565,6 +1575,14 @@ function createAnnotationCapability(ctx, config = {}) {
 	* rendered, never synced, and dies with the tool.
 	*/
 	let armedStamp = null;
+	/** Fixed bytes as a provider: the same image at every size. */
+	const fixedPreview = (bytes, mimeType) => {
+		const preview = {
+			bytes,
+			...mimeType ? { mimeType } : {}
+		};
+		return async () => preview;
+	};
 	/**
 	* The desired stamp size (PDF points) from sniffed bytes: the image's
 	* INTRINSIC pixel dimensions taken 1:1 as points (the v2 rule — keep the
@@ -1593,23 +1611,21 @@ function createAnnotationCapability(ctx, config = {}) {
 		const meta = sniffBinaryMetadata(resolved.bytes);
 		if (!meta) throw new Error("[annotation] stamp source must be PNG, JPEG, or single-page PDF bytes");
 		let preview = null;
-		if (input.preview) {
+		if (typeof input.preview === "function") preview = input.preview;
+		else if (input.preview) {
 			const p = await resolveBinarySource(input.preview);
-			preview = {
-				bytes: new Uint8Array(p.bytes),
-				mimeType: p.mimeType
-			};
-		} else if (meta.mimeType !== "application/pdf") preview = {
-			bytes: new Uint8Array(resolved.bytes),
-			mimeType: meta.mimeType
-		};
+			preview = fixedPreview(new Uint8Array(p.bytes), p.mimeType);
+		} else if (meta.mimeType !== "application/pdf") preview = fixedPreview(new Uint8Array(resolved.bytes), meta.mimeType);
 		armedStamp = {
 			source: input.source,
 			...desiredStampSize(meta, input.targetWidth, input.intrinsicSize),
-			preview
+			preview,
+			previewCache: /* @__PURE__ */ new Map(),
+			...input.name !== void 0 ? { name: input.name } : {},
+			...input.subject !== void 0 ? { subject: input.subject } : {}
 		};
 		ctx.dispatch({ type: "STAMP_ARM_CHANGED" });
-		ctx.tryGet(InteractionToken)?.activateTool("stamp");
+		ctx.tryGet(InteractionToken)?.activateTool(ARMED_STAMP_TOOL_ID);
 	};
 	const disarmStamp = () => {
 		if (!armedStamp) return;
@@ -1736,28 +1752,49 @@ function createAnnotationCapability(ctx, config = {}) {
 	*  emits the repository's box rotation fields — the engine bakes the tilted
 	*  /AP exactly as an interactively rotated stamp round-trips, and the fit uses
 	*  the ROTATED footprint. Returns false when the page/document isn't ready. */
-	const createStampAt = (pon, point, source, desired, rotCW = 0) => {
+	const createStampAt = (pon, point, source, desired, rotCW = 0, identity = {}) => {
 		const doc = ctx.doc;
 		const crop = cropOf(pon);
-		if (!doc || !crop) return false;
+		if (!doc || !crop) return null;
 		const box = fitStampBox(point, desired, {
 			width: crop.right - crop.left,
 			height: crop.top - crop.bottom
 		}, rotCW);
-		doc.page(pon).annotations.create({
+		return doc.page(pon).annotations.create({
 			subtype: "stamp",
 			...boxGeomFields(box, rotCW, crop),
 			source,
-			fit: "contain"
+			fit: "contain",
+			...identity.name !== void 0 ? { name: identity.name } : {},
+			...identity.subject !== void 0 ? { subject: identity.subject } : {}
 		}).then((res) => {
 			syncDTO(res.created, "baked");
 			apply({
 				t: "select",
 				ids: [refKey(res.created.ref)]
 			});
-		}, (err) => console.error("[annotation] stamp placement failed:", err));
+			return res.created.ref;
+		});
+	};
+	/** The click path's fire-and-forget wrapper: a rejected placement is logged,
+	*  never thrown into the gesture. */
+	const createStampAtSync = (pon, point, source, desired, rotCW = 0, identity = {}) => {
+		const placed = createStampAt(pon, point, source, desired, rotCW, identity);
+		if (!placed) return false;
+		placed.catch((err) => console.error("[annotation] stamp placement failed:", err));
 		return true;
 	};
+	/** Programmatic placement — the same law as a click, awaited. */
+	const placeStamp = async (input, placement) => {
+		const meta = sniffBinaryMetadata((await resolveBinarySource(input.source)).bytes);
+		if (!meta) throw new Error("[annotation] stamp source must be PNG, JPEG, or single-page PDF bytes");
+		const placed = createStampAt(placement.pageObjectNumber, placement.at, input.source, desiredStampSize(meta, placement.targetWidth ?? input.targetWidth, input.intrinsicSize), placement.rotation ?? 0, {
+			...input.name !== void 0 ? { name: input.name } : {},
+			...input.subject !== void 0 ? { subject: input.subject } : {}
+		});
+		if (!placed) throw new Error(`[annotation] cannot place a stamp on page ${placement.pageObjectNumber}: document or page not ready`);
+		return placed;
+	};
 	/** The active tool's upright counter-rotation for a click at `displayRotation`
 	*  (0 when the tool doesn't ask for upright, or the display isn't rotated). */
 	const uprightRotFor = (displayRotation) => {
@@ -1768,10 +1805,13 @@ function createAnnotationCapability(ctx, config = {}) {
 	const placeArmedStamp = (pon, point, displayRotation) => {
 		const armed = armedStamp;
 		if (!armed) return false;
-		return createStampAt(pon, point, armed.source, {
+		return createStampAtSync(pon, point, armed.source, {
 			width: armed.width,
 			height: armed.height
-		}, uprightRotFor(displayRotation));
+		}, uprightRotFor(displayRotation), {
+			...armed.name !== void 0 ? { name: armed.name } : {},
+			...armed.subject !== void 0 ? { subject: armed.subject } : {}
+		});
 	};
 	/** Sniff a stamp source (rejecting non-image bytes) and place it at its
 	*  intrinsic size (fit to the page in {@link createStampAt}); `targetWidth`
@@ -1782,7 +1822,7 @@ function createAnnotationCapability(ctx, config = {}) {
 			console.error("[annotation] stamp source must be PNG, JPEG, or single-page PDF bytes");
 			return;
 		}
-		createStampAt(pon, point, source, desiredStampSize(meta, targetWidth), rotCW);
+		createStampAtSync(pon, point, source, desiredStampSize(meta, targetWidth), rotCW);
 	};
 	/**
 	* Click-to-place: resolve the ACTIVE tool's source spec. Fixed `bytes` place
@@ -2532,6 +2572,7 @@ function createAnnotationCapability(ctx, config = {}) {
 			return res.created.ref;
 		},
 		armStamp,
+		placeStamp,
 		disarmStamp,
 		placeArmedStamp,
 		requestStampAt,
@@ -2545,7 +2586,20 @@ function createAnnotationCapability(ctx, config = {}) {
 			const g = ctx.getState().toolGhost;
 			return g && g.pon === pon ? g : null;
 		},
-		armedStampPreview: () => armedStamp?.preview ?? null,
+		armedStampPreview: (devicePixelWidth) => {
+			const armed = armedStamp;
+			if (!armed?.preview) return Promise.resolve(null);
+			const bucket = previewBucket(devicePixelWidth ?? 0);
+			let pending = armed.previewCache.get(bucket);
+			if (!pending) {
+				pending = armed.preview(bucket).catch((error) => {
+					console.error("[annotation] stamp ghost preview failed:", error);
+					return null;
+				});
+				armed.previewCache.set(bucket, pending);
+			}
+			return pending;
+		},
 		stampArmEpoch: () => ctx.getState().stampArmEpoch,
 		setFilePickerProvider: (provider) => {
 			filePickerProvider = provider;
@@ -3027,6 +3081,6 @@ function createAnnotationCapability(ctx, config = {}) {
 	};
 }
 //#endregion
-export { fromDTO as a, isTouchDirect as i, DEFAULT_TOOLS as n, toCreateDraft as o, buildToolRegistry as r, toPatch as s, createAnnotationCapability as t };
+export { isTouchDirect as a, toPatch as c, buildToolRegistry as i, ARMED_STAMP_TOOL_ID as n, fromDTO as o, DEFAULT_TOOLS as r, toCreateDraft as s, createAnnotationCapability as t };
 
-//# sourceMappingURL=capability-DBsr2D-L.js.map
+//# sourceMappingURL=capability-Bh_1PL5v.js.map