@embedpdf/plugin-stamp 3.0.0-next.12 → 3.0.0-next.14

package/dist/index.cjs

@@ -1,10 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_contract = require("./contract-C6CgKD69.cjs");
+const require_contract = require("./contract-T-v5KaYd.cjs");
 let _embedpdf_core = require("@embedpdf/core");
 let _embedpdf_engine_core_runtime = require("@embedpdf/engine-core/runtime");
 let _embedpdf_core_acrojs = require("@embedpdf/core-acrojs");
 let _embedpdf_plugin_actions_contract_host = require("@embedpdf/plugin-actions/contract/host");
 let _embedpdf_plugin_annotation_contract = require("@embedpdf/plugin-annotation/contract");
+let _embedpdf_plugin_annotation_contract_host = require("@embedpdf/plugin-annotation/contract/host");
 let _embedpdf_plugin_form_scripting = require("@embedpdf/plugin-form/scripting");
 //#region src/blank-library.ts
 /**
@@ -38,6 +39,51 @@ function blankLibraryPdf() {
 //#endregion
 //#region src/capability.ts
 const DEFAULT_PREVIEW_WIDTH = 256;
+/** `#rrggbb` → the engine's sRGB triplet. */
+const hexColor = (hex) => {
+	const m = /^#?([0-9a-f]{6})$/i.exec(hex.trim());
+	if (!m) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, `[stamp] mark color must be #rrggbb, got '${hex}'`);
+	const n = parseInt(m[1], 16);
+	return {
+		r: n >> 16 & 255,
+		g: n >> 8 & 255,
+		b: n & 255
+	};
+};
+/** An exact ArrayBuffer over a view (the engine's binary idiom). */
+const toArrayBuffer = (bytes) => {
+	const out = new ArrayBuffer(bytes.byteLength);
+	new Uint8Array(out).set(bytes);
+	return out;
+};
+/** The rect an ink mark occupies, padded by its stroke. */
+const inkBounds = (strokes, strokeWidth) => {
+	let left = Infinity;
+	let bottom = Infinity;
+	let right = -Infinity;
+	let top = -Infinity;
+	for (const stroke of strokes) for (const { x, y } of stroke) {
+		if (x < left) left = x;
+		if (x > right) right = x;
+		if (y < bottom) bottom = y;
+		if (y > top) top = y;
+	}
+	if (!Number.isFinite(left)) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "[stamp] an ink mark needs at least one point");
+	const pad = strokeWidth;
+	return {
+		left: left - pad,
+		bottom: bottom - pad,
+		right: right + pad,
+		top: top + pad
+	};
+};
+/** A generous box for typed text; the export crops to the glyphs. */
+const textBounds = (text, fontSize) => ({
+	left: 0,
+	bottom: 0,
+	right: Math.max(1, text.length) * fontSize * .75 + fontSize,
+	top: fontSize * 1.6
+});
 /** Session-unique ids. Assets are session-scoped for now (no persistence),
 *  so a timestamp + counter is enough — durable ids come with the store port. */
 let seq = 0;
@@ -129,6 +175,7 @@ function createStampCapability(ctx, config = {}) {
 		format: "png"
 	}));
 	const createLibrary = async (name, opts) => {
+		const kind = opts?.kind ?? "stamps";
 		const taken = new Set(Object.keys(ctx.getState().libraries));
 		const id = allocateId(opts?.id, "stamp-lib", taken);
 		const doc = await openAssetDocument(blankLibraryPdf());
@@ -136,7 +183,10 @@ function createStampCapability(ctx, config = {}) {
 		try {
 			requireCanonicalServices(doc);
 			await doc.metadata.update({ title: name });
-			await doc.pieceInfo.update(require_contract.STAMP_LIBRARY_PIECEINFO_APP, require_contract.stampLibraryPieceInfo(id, { categories: opts?.categories }));
+			await doc.pieceInfo.update(require_contract.STAMP_LIBRARY_PIECEINFO_APP, require_contract.stampLibraryPieceInfo(id, {
+				kind,
+				categories: opts?.categories
+			}));
 			bytes = await doc.download();
 		} finally {
 			await doc.close();
@@ -147,6 +197,7 @@ function createStampCapability(ctx, config = {}) {
 			library: {
 				id,
 				name,
+				kind,
 				assetIds: [],
 				...opts?.categories ? { categories: opts.categories } : {}
 			}
@@ -180,6 +231,7 @@ function createStampCapability(ctx, config = {}) {
 			if (!docMeta.title) await doc.metadata.update({ title: libraryName });
 			const libraryCategories = opts?.categories ?? entryStringArray(catalogEntries, "Categories");
 			const libraryLocale = entryString(catalogEntries, "Locale");
+			const libraryKind = opts?.libraryKind ?? require_contract.libraryKindFromPdfName(entryName(catalogEntries, "Kind"));
 			const registry = (layout.namedPages ?? []).filter((entry) => entry.target.kind === "page");
 			const hidden = (layout.namedPages ?? []).filter((entry) => entry.target.kind !== "page");
 			if (hidden.length > 0) globalThis.console?.warn(`[stamp] library '${libraryName}' carries ${hidden.length} hidden-template or dangling registration(s); they are not stamps and were ignored`);
@@ -220,6 +272,7 @@ function createStampCapability(ctx, config = {}) {
 				});
 			}
 			await doc.pieceInfo.update(require_contract.STAMP_LIBRARY_PIECEINFO_APP, require_contract.stampLibraryPieceInfo(libraryId, {
+				kind: libraryKind,
 				categories: libraryCategories,
 				locale: libraryLocale
 			}));
@@ -261,6 +314,7 @@ function createStampCapability(ctx, config = {}) {
 				library: {
 					id: libraryId,
 					name: libraryName,
+					kind: libraryKind,
 					...libraryLocale ? { locale: libraryLocale } : {},
 					categories: libraryCategories,
 					assetIds: []
@@ -292,9 +346,76 @@ function createStampCapability(ctx, config = {}) {
 		});
 		return imported.library.id;
 	};
+	/**
+	* A drawn or typed mark rendered to a one-page PDF: the annotation is
+	* authored on a scratch page and exported the way "stamp from selection"
+	* exports — a fresh page the size of the mark, paths kept as paths, the
+	* font subset-embedded. Self-contained and Acrobat-readable.
+	*/
+	const renderMark = async (mark) => {
+		const doc = await openAssetDocument(blankLibraryPdf());
+		try {
+			const scratch = (await doc.pages.list()).pages[0];
+			if (!scratch) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.Unknown, "[stamp] no scratch page");
+			const page = doc.page(scratch.pageObjectNumber);
+			if (!page.annotations.exportAppearance) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotImplemented, "[stamp] authoring a mark needs an asset engine that can export annotation appearances");
+			const color = hexColor(mark.color ?? "#1d2b53");
+			const created = mark.kind === "ink" ? await page.annotations.create({
+				subtype: "ink",
+				inkList: mark.strokes.map((stroke) => stroke.map(({ x, y }) => ({
+					x,
+					y
+				}))),
+				rect: inkBounds(mark.strokes, mark.strokeWidth ?? 2),
+				color,
+				strokeWidth: mark.strokeWidth ?? 2
+			}) : await page.annotations.create({
+				subtype: "free-text",
+				intent: "free-text",
+				contents: mark.text,
+				fontFamily: mark.fontFamily,
+				fontSize: mark.fontSize ?? 36,
+				textAlign: "left",
+				rect: textBounds(mark.text, mark.fontSize ?? 36),
+				fontColor: color,
+				strokeWidth: 0
+			});
+			return new Uint8Array(await page.annotations.exportAppearance([created.created.ref]));
+		} finally {
+			await doc.close();
+		}
+	};
+	/** One page of a PDF as a single-page PDF (a `pdf` mark with `pageIndex`). */
+	const extractPage = async (bytes, pageIndex) => {
+		const doc = await openAssetDocument(bytes);
+		try {
+			const layout = await doc.pages.list();
+			const page = layout.pages[pageIndex];
+			if (!page) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, `[stamp] the PDF has no page ${pageIndex} (${layout.pageCount} pages)`);
+			return await doc.pages.extract([page.pageObjectNumber]);
+		} finally {
+			await doc.close();
+		}
+	};
+	/** The bytes an asset is made from: the caller's `source`, or its `mark` authored into one. */
+	const resolveAssetSource = async (input) => {
+		if (input.source === void 0 === (input.mark === void 0)) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "[stamp] addAsset takes exactly one of `source` / `mark`");
+		if (input.source !== void 0) return (0, _embedpdf_engine_core_runtime.resolveBinarySource)(input.source);
+		const mark = input.mark;
+		switch (mark.kind) {
+			case "image": return (0, _embedpdf_engine_core_runtime.resolveBinarySource)(mark.source);
+			case "pdf": {
+				const resolved = await (0, _embedpdf_engine_core_runtime.resolveBinarySource)(mark.source);
+				if (mark.pageIndex === void 0) return resolved;
+				return { bytes: toArrayBuffer(await extractPage(new Uint8Array(resolved.bytes), mark.pageIndex)) };
+			}
+			case "ink":
+			case "text": return { bytes: toArrayBuffer(await renderMark(mark)) };
+		}
+	};
 	const addAsset = async (input) => {
 		if (input.libraryId && !ctx.getState().libraries[input.libraryId]) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotFound, `[stamp] unknown library '${input.libraryId}'`);
-		const resolved = await (0, _embedpdf_engine_core_runtime.resolveBinarySource)(input.source);
+		const resolved = await resolveAssetSource(input);
 		const meta = (0, _embedpdf_engine_core_runtime.sniffBinaryMetadata)(resolved.bytes);
 		if (!meta) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "[stamp] asset source must be PNG, JPEG, or single-page PDF bytes");
 		const isPdf = meta.mimeType === "application/pdf";
@@ -503,6 +624,43 @@ function createStampCapability(ctx, config = {}) {
 			});
 		});
 	};
+	const updateLibrary = async (id, patch) => {
+		if (!ctx.getState().libraries[id]) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotFound, `[stamp] unknown library '${id}'`);
+		return mutateLibrary(id, async () => {
+			const library = ctx.getState().libraries[id];
+			if (!library) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotFound, `[stamp] unknown library '${id}'`);
+			const canonicalBytes = libraryBinaries.get(id);
+			if (!canonicalBytes) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.Unknown, `[stamp] canonical bytes are missing for library '${id}'`);
+			const next = {
+				...library,
+				...patch.name !== void 0 ? { name: patch.name } : {},
+				...patch.categories !== void 0 ? { categories: patch.categories } : {}
+			};
+			const doc = await openAssetDocument(canonicalBytes);
+			let rewritten;
+			try {
+				requireCanonicalServices(doc);
+				if (next.name !== library.name) await doc.metadata.update({ title: next.name });
+				await doc.pieceInfo.update(require_contract.STAMP_LIBRARY_PIECEINFO_APP, require_contract.stampLibraryPieceInfo(id, {
+					kind: next.kind,
+					categories: next.categories,
+					locale: next.locale
+				}));
+				rewritten = await doc.download();
+			} finally {
+				await doc.close();
+			}
+			libraryBinaries.set(id, rewritten);
+			ctx.dispatch({
+				type: "LIBRARY_UPDATED",
+				library: next
+			});
+			libraryChanged.emit({
+				libraryId: id,
+				reason: "updated"
+			});
+		});
+	};
 	/**
 	* Form-backed stamps are executable templates only until placement. Work
 	* on an isolated copy so neither the canonical library nor its reusable
@@ -582,6 +740,20 @@ function createStampCapability(ctx, config = {}) {
 			...stampPayload(asset, placement, placement !== bin),
 			targetWidth: opts?.targetWidth
 		});
+		armedByDocument.set(documentId, assetId);
+	};
+	/** Which asset this plugin armed per document. The annotation plugin owns
+	*  the arm itself (a tool switch disarms it), so the answer is checked
+	*  against it and forgotten once it no longer holds one. */
+	const armedByDocument = /* @__PURE__ */ new Map();
+	const armedAsset = (documentId) => {
+		const assetId = armedByDocument.get(documentId);
+		if (assetId === void 0) return null;
+		if (!ctx.tryForDocument(_embedpdf_plugin_annotation_contract_host.AnnotationToken, documentId)?.hasArmedStamp()) {
+			armedByDocument.delete(documentId);
+			return null;
+		}
+		return ctx.getState().assets[assetId] ?? null;
 	};
 	/**
 	* Ghost renders, one per size bucket per asset, rendered lazily on the
@@ -652,9 +824,10 @@ function createStampCapability(ctx, config = {}) {
 		if (ownedAssetEngine) Promise.resolve(ownedAssetEngine).then((engine) => engine.destroy()).catch(() => {});
 	});
 	return {
-		libraries: () => {
+		libraries: (query) => {
 			const s = ctx.getState();
-			return s.libraryOrder.map((id) => s.libraries[id]).filter((l) => l != null);
+			const kinds = query?.kind === void 0 ? null : new Set(typeof query.kind === "string" ? [query.kind] : query.kind);
+			return s.libraryOrder.map((id) => s.libraries[id]).filter((l) => l != null && (kinds === null || kinds.has(l.kind)));
 		},
 		library: (id) => ctx.getState().libraries[id] ?? null,
 		assets: (libraryId) => {
@@ -671,6 +844,7 @@ function createStampCapability(ctx, config = {}) {
 		exportLibrary: (id) => libraryBinaries.get(id) ?? null,
 		onLibraryChanged: libraryChanged.on,
 		createLibrary,
+		updateLibrary,
 		importLibraryPdf,
 		addAsset,
 		addAssetFromAnnotations,
@@ -679,7 +853,11 @@ function createStampCapability(ctx, config = {}) {
 		removeLibrary,
 		armAsset,
 		placeAsset,
-		disarm: (documentId) => ctx.forDocument(_embedpdf_plugin_annotation_contract.AnnotationToken, documentId).disarmStamp()
+		disarm: (documentId) => {
+			armedByDocument.delete(documentId);
+			ctx.forDocument(_embedpdf_plugin_annotation_contract.AnnotationToken, documentId).disarmStamp();
+		},
+		armedAsset
 	};
 }
 //#endregion
@@ -701,6 +879,13 @@ const stampReducer = (state, action) => {
 			},
 			libraryOrder: [...state.libraryOrder, action.library.id]
 		};
+		case "LIBRARY_UPDATED": return state.libraries[action.library.id] ? {
+			...state,
+			libraries: {
+				...state.libraries,
+				[action.library.id]: action.library
+			}
+		} : state;
 		case "LIBRARY_REMOVED": {
 			const library = state.libraries[action.libraryId];
 			if (!library) return state;
@@ -851,12 +1036,15 @@ function persistStampLibraries(stamp, store, opts = {}) {
 	};
 }
 //#endregion
+exports.DEFAULT_LIBRARY_KIND = require_contract.DEFAULT_LIBRARY_KIND;
 exports.STAMP_LIBRARY_PIECEINFO_APP = require_contract.STAMP_LIBRARY_PIECEINFO_APP;
 exports.STAMP_PIECEINFO_APP = require_contract.STAMP_PIECEINFO_APP;
 exports.STAMP_PIECEINFO_VERSION = require_contract.STAMP_PIECEINFO_VERSION;
 exports.StampToken = require_contract.StampToken;
 exports.assetIdFor = require_contract.assetIdFor;
 exports.customStampName = require_contract.customStampName;
+exports.libraryKindFromPdfName = require_contract.libraryKindFromPdfName;
+exports.libraryKindToPdfName = require_contract.libraryKindToPdfName;
 exports.memoryStampStore = memoryStampStore;
 exports.parseStampKey = require_contract.parseStampKey;
 exports.persistStampLibraries = persistStampLibraries;