@embedpdf/plugin-stamp 2.14.4 → 3.0.0-next.0

package/dist/index.cjs

@@ -1,2 +1,591 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/core"),t=require("@embedpdf/models"),a=require("@embedpdf/plugin-annotation"),r="stamp",o={id:r,name:"Stamp Plugin",version:"1.0.0",provides:["stamp"],requires:["annotation"],optional:["i18n"],defaultConfig:{defaultLibrary:{id:"custom",name:"Custom Stamps",nameKey:"stamp.library.custom",categories:["custom","sidebar"]},manifests:[{url:"https://cdn.jsdelivr.net/npm/@embedpdf/default-stamps/{locale}/manifest.json",fallbackLocale:"en"}]}},n="STAMP/ADD_LIBRARY",i="STAMP/REMOVE_LIBRARY";function s(e){return{type:n,payload:e}}function l(e){return{type:i,payload:e}}const d={annotationType:t.PdfAnnotationSubtype.STAMP,create(e){const{onPreview:r,onCommit:o,getTool:n,pageSize:i,pageRotation:s,getToolContext:l}=e;return{onPointerMove:e=>{const a=l();if(!(null==a?void 0:a.stampSize))return;const{width:o,height:n}=a.stampSize;r({type:t.PdfAnnotationSubtype.STAMP,bounds:{origin:{x:e.x-o/2,y:e.y-n/2},size:{width:o,height:n}},data:{rect:{origin:{x:e.x-o/2,y:e.y-n/2},size:{width:o,height:n}},ghostUrl:a.ghostUrl,pageRotation:s}})},onPointerDown:d=>{var c;const m=n(),u=l();if(!m||!(null==u?void 0:u.stampSize))return;const{width:p,height:g}=u.stampSize,h={origin:{x:d.x-p/2,y:d.y-g/2},size:{width:p,height:g}};let f={...m.defaults,rect:h,type:t.PdfAnnotationSubtype.STAMP,name:u.stamp.name??m.defaults.name??t.PdfAnnotationName.Custom,subject:u.stamp.subject??m.defaults.subject??"Custom Stamp",flags:m.defaults.flags??["print"],pageIndex:e.pageIndex,id:t.uuidV4(),created:new Date};(null==(c=m.behavior)?void 0:c.insertUpright)&&(f=a.applyInsertUpright(f,s,!1)),f=a.clampAnnotationToPage(f,i),o(f,{appearance:u.appearance}),r(null)},onPointerLeave:()=>{r(null)}}}},c="rubberStamp",m=[a.defineAnnotationTool({id:c,name:"Rubber Stamp",labelKey:"stamp.rubberStamp",categories:["annotation","stamp","insert"],matchScore:()=>0,interaction:{exclusive:!0,cursor:"copy",isDraggable:!0,isResizable:!0,isRotatable:!1,lockAspectRatio:!0,isGroupDraggable:!0,isGroupResizable:!1,isGroupRotatable:!1},defaults:{type:t.PdfAnnotationSubtype.STAMP},behavior:{deactivateToolAfterCreate:!0,selectAfterCreate:!0,insertUpright:!0,useAppearanceStream:!0},pointerHandler:d})],u={Approved:t.PdfAnnotationName.Approved,Experimental:t.PdfAnnotationName.Experimental,NotApproved:t.PdfAnnotationName.NotApproved,AsIs:t.PdfAnnotationName.AsIs,Expired:t.PdfAnnotationName.Expired,NotForPublicRelease:t.PdfAnnotationName.NotForPublicRelease,Confidential:t.PdfAnnotationName.Confidential,Final:t.PdfAnnotationName.Final,Sold:t.PdfAnnotationName.Sold,Departmental:t.PdfAnnotationName.Departmental,ForComment:t.PdfAnnotationName.ForComment,TopSecret:t.PdfAnnotationName.TopSecret,Draft:t.PdfAnnotationName.Draft,ForPublicRelease:t.PdfAnnotationName.ForPublicRelease,Completed:t.PdfAnnotationName.Completed,Void:t.PdfAnnotationName.Void,PreliminaryResults:t.PdfAnnotationName.PreliminaryResults,InformationOnly:t.PdfAnnotationName.InformationOnly,Rejected:t.PdfAnnotationName.Rejected,Witness:t.PdfAnnotationName.Witness,InitialHere:t.PdfAnnotationName.InitialHere,SignHere:t.PdfAnnotationName.SignHere,Accepted:t.PdfAnnotationName.Accepted,Custom:t.PdfAnnotationName.Custom,Image:t.PdfAnnotationName.Image};const p=class extends e.BasePlugin{constructor(a,r,o){var n,i;if(super(a,r),this.config=o,this.instanceId=t.uuidV4(),this.libraries=new Map,this.libraryChange$=e.createEmitter(),this.activeStamp$=e.createScopedEmitter((e,t)=>({documentId:e,activeStamp:t})),this.managedManifests=[],this.annotation=null,this.i18n=null,this.localeUnsubscribe=null,this.toolChangeUnsubscribe=null,this.currentGhostUrl=null,this.annotation=(null==(n=r.getPlugin("annotation"))?void 0:n.provides())??null,this.annotation){for(const e of m)this.annotation.addTool(e);this.toolChangeUnsubscribe=this.annotation.onActiveToolChange(({documentId:e,tool:t})=>{(null==t?void 0:t.id)!==c&&(this.currentGhostUrl&&(URL.revokeObjectURL(this.currentGhostUrl),this.currentGhostUrl=null),this.activeStamp$.emit(e,null))})}this.i18n=(null==(i=r.getPlugin("i18n"))?void 0:i.provides())??null}async initialize(){if(this.config.libraries)for(const e of this.config.libraries)await this.loadLibraryInternal(e).toPromise();this.config.manifests&&this.config.manifests.length>0&&await this.initializeManifests()}buildCapability(){return{getLibraries:()=>this.getLibraries(),getStampsByCategory:e=>this.getStampsByCategory(e),renderStamp:(e,t,a,r)=>this.renderStamp(e,t,a,r),loadLibrary:e=>this.loadLibrary(e),loadLibraryFromManifest:e=>this.loadLibraryFromManifest(e),createNewLibrary:(e,t)=>this.createNewLibrary(e,t),addStampToLibrary:(e,t,a)=>this.addStampToLibrary(e,t,a),removeStampFromLibrary:(e,t)=>this.removeStampFromLibrary(e,t),updateStamp:(e,t,a)=>this.updateStamp(e,t,a),updateLibrary:(e,t)=>this.updateLibrary(e,t),removeLibrary:e=>this.removeLibrary(e),exportLibrary:e=>this.exportLibrary(e),forDocument:e=>this.createStampScope(e),onActiveStampChange:this.activeStamp$.onGlobal,onLibraryChange:this.libraryChange$.on}}getLibraries(){return Array.from(this.libraries.values())}getStampsByCategory(e){var t,a;const r=[];for(const o of this.libraries.values()){const n=(null==(t=o.categories)?void 0:t.includes(e))??!1;for(const t of o.stamps){const i=(null==(a=t.categories)?void 0:a.includes(e))??!1;(n||i)&&r.push({library:o,stamp:t})}}return r}renderStamp(e,a,r,o){const n=this.libraries.get(e);if(!n){const a=new t.Task;return a.reject({code:t.PdfErrorCode.NotFound,message:`Stamp library not found: ${e}`}),a}const i=n.document.pages[a];if(!i){const r=new t.Task;return r.reject({code:t.PdfErrorCode.NotFound,message:`Page ${a} not found in stamp library: ${e}`}),r}const s=r/i.size.width;return this.engine.renderPageRect(n.document,i,{origin:{x:0,y:0},size:i.size},{scaleFactor:s,dpr:o??1,withAnnotations:!0,rotation:i.rotation,transparentBackground:!0})}loadLibrary(e){return this.loadLibraryInternal(e)}createNewLibrary(e,a){const r=new t.Task,o=(null==a?void 0:a.id)??this.generateLibraryId(),n=this.getLibraryDocumentId(o);return this.engine.createDocument(n).wait(t=>{const n={id:o,name:e,nameKey:null==a?void 0:a.nameKey,document:t,stamps:[],categories:null==a?void 0:a.categories,readonly:(null==a?void 0:a.readonly)??!1};this.libraries.set(o,n),this.dispatch(s(o)),this.emitLibraryChange(),r.resolve(o)},t=>{this.logger.error("StampPlugin","CreateNewLibrary",`Failed to create library: ${e}`,t),r.fail(t)}),r}addStampToLibrary(e,a,r){const o=new t.Task,n=this.libraries.get(e);if(!n)return o.reject({code:t.PdfErrorCode.NotFound,message:`Stamp library not found: ${e}`}),o;if(n.readonly)return o.reject({code:t.PdfErrorCode.NotSupport,message:`Cannot add stamps to readonly library: ${e}`}),o;const i=`stamp-temp-${Date.now()}`;return this.engine.openDocumentBuffer({id:i,content:r}).wait(e=>{this.engine.importPages(n.document,e,[0]).wait(r=>{const i=r[0];n.document.pages.push(i),n.document.pageCount=n.document.pages.length;const s={...a,id:t.uuidV4(),pageIndex:i.index};n.stamps.push(s),this.engine.closeDocument(e).wait(()=>{this.emitLibraryChange(),o.resolve()},()=>{this.emitLibraryChange(),o.resolve()})},t=>{this.logger.error("StampPlugin","AddStampToLibrary","Failed to import page",t),this.engine.closeDocument(e).wait(()=>o.fail(t),()=>o.fail(t))})},e=>{this.logger.error("StampPlugin","AddStampToLibrary","Failed to open temp document",e),o.fail(e)}),o}createStampScope(e){return{createStampFromAnnotation:(t,a,r)=>this.createStampFromAnnotation(e,t,a,r),createStampFromAnnotations:(t,a,r)=>this.createStampFromAnnotations(e,t,a,r),activateStampPlacement:(t,a)=>this.activateStampPlacement(e,t,a),activateStampPlacementById:(t,a)=>this.activateStampPlacementById(e,t,a),getActiveStamp:()=>this.getActiveStamp(e),onActiveStampChange:this.activeStamp$.forScope(e)}}activateStampPlacementById(e,a,r){const o=new t.Task,n=this.libraries.get(a);if(!n)return o.reject({code:t.PdfErrorCode.NotFound,message:`Stamp library not found: ${a}`}),o;const i=n.stamps.find(e=>e.id===r);return i?this.activateStampPlacement(e,a,i):(o.reject({code:t.PdfErrorCode.NotFound,message:`Stamp ${r} not found in library: ${a}`}),o)}getActiveStamp(e){return this.activeStamp$.getValue(e)??null}activateStampPlacement(e,a,r){const o=new t.Task,n=this.libraries.get(a);if(!n)return o.reject({code:t.PdfErrorCode.NotFound,message:`Stamp library not found: ${a}`}),o;const i=n.document.pages[r.pageIndex];if(!i)return o.reject({code:t.PdfErrorCode.NotFound,message:`Page ${r.pageIndex} not found in library`}),o;const s=i.size;return this.engine.extractPages(n.document,[r.pageIndex]).wait(t=>{this.renderStamp(a,r.pageIndex,s.width,2).wait(n=>{var i;this.currentGhostUrl&&URL.revokeObjectURL(this.currentGhostUrl);const l=URL.createObjectURL(n);this.currentGhostUrl=l,null==(i=this.annotation)||i.setActiveTool(c,{appearance:t,ghostUrl:l,stampSize:s,libraryId:a,stamp:r}),this.activeStamp$.emit(e,{libraryId:a,stamp:r}),o.resolve()},e=>{this.logger.error("StampPlugin","ActivateStampPlacement","Failed to render stamp preview",e),o.fail(e)})},e=>{this.logger.error("StampPlugin","ActivateStampPlacement","Failed to extract stamp page",e),o.fail(e)}),o}createStampFromAnnotation(e,a,r,o){const n=new t.Task,i=this.getCoreDocument(e);if(!(null==i?void 0:i.document))return n.reject({code:t.PdfErrorCode.DocNotOpen,message:"document is not open"}),n;const s=i.document,l=s.pages[a.pageIndex];return l?(this.resolveTargetLibrary(o).wait(e=>{this.engine.exportAnnotationAppearanceAsPdf(s,l,a).wait(t=>{this.addStampToLibrary(e,r,t).wait(()=>n.resolve(),e=>n.fail(e))},e=>{this.logger.error("StampPlugin","CreateStampFromAnnotation","Failed to export annotation",e),n.fail(e)})},e=>n.fail(e)),n):(n.reject({code:t.PdfErrorCode.NotFound,message:`page ${a.pageIndex} not found`}),n)}createStampFromAnnotations(e,a,r,o){const n=new t.Task;if(0===a.length)return n.reject({code:t.PdfErrorCode.NotFound,message:"no annotations provided"}),n;const i=this.getCoreDocument(e);if(!(null==i?void 0:i.document))return n.reject({code:t.PdfErrorCode.DocNotOpen,message:"document is not open"}),n;const s=i.document,l=s.pages[a[0].pageIndex];return l?(this.resolveTargetLibrary(o).wait(e=>{this.engine.exportAnnotationsAppearanceAsPdf(s,l,a).wait(t=>{this.addStampToLibrary(e,r,t).wait(()=>n.resolve(),e=>n.fail(e))},e=>{this.logger.error("StampPlugin","CreateStampFromAnnotations","Failed to export annotations",e),n.fail(e)})},e=>n.fail(e)),n):(n.reject({code:t.PdfErrorCode.NotFound,message:`page ${a[0].pageIndex} not found`}),n)}resolveTargetLibrary(e){if(e&&this.libraries.has(e)){const a=new t.Task;return a.resolve(e),a}const a=this.config.defaultLibrary;if(!1===this.config.defaultLibrary||!a){const e=new t.Task;return e.reject({code:t.PdfErrorCode.NotSupport,message:"Default library creation is disabled"}),e}const r=a.id??"custom";if(this.libraries.has(r)){const e=new t.Task;return e.resolve(r),e}return this.createNewLibrary(a.name??"Custom Stamps",{id:r,nameKey:a.nameKey,categories:a.categories})}removeLibrary(e){const a=new t.Task,r=this.libraries.get(e);return r?(this.engine.closeDocument(r.document).wait(()=>{this.libraries.delete(e),this.dispatch(l(e)),this.emitLibraryChange(),a.resolve()},()=>{this.logger.warn("StampPlugin","RemoveLibrary",`Failed to close document for library: ${e}`),this.libraries.delete(e),this.dispatch(l(e)),this.emitLibraryChange(),a.resolve()}),a):(a.resolve(),a)}exportLibrary(e){const a=new t.Task,r=this.libraries.get(e);return r?(this.engine.saveAsCopy(r.document).wait(e=>{a.resolve({name:r.name,pdf:e,stamps:r.stamps,categories:r.categories})},t=>{this.logger.error("StampPlugin","ExportLibrary",`Failed to export library: ${e}`,t),a.fail(t)}),a):(a.reject({code:t.PdfErrorCode.NotFound,message:`Stamp library not found: ${e}`}),a)}loadLibraryInternal(e){const a=new t.Task,r=e.id??this.generateLibraryId(),o=this.getLibraryDocumentId(r);return("string"==typeof e.pdf?this.engine.openDocumentUrl({id:o,url:e.pdf}):this.engine.openDocumentBuffer({id:o,content:e.pdf})).wait(o=>{const n=e.stamps.map(e=>e.id?e:{...e,id:t.uuidV4()}),i={id:r,name:e.name,nameKey:e.nameKey,document:o,stamps:n,categories:e.categories,readonly:e.readonly??!1};this.libraries.set(r,i),this.dispatch(s(r)),this.emitLibraryChange(),a.resolve(r)},t=>{this.logger.error("StampPlugin","LoadLibrary",`Failed to load stamp library: ${e.name}`,t),a.fail(t)}),a}removeStampFromLibrary(e,a){const r=new t.Task,o=this.libraries.get(e);if(!o)return r.reject({code:t.PdfErrorCode.NotFound,message:`Stamp library not found: ${e}`}),r;if(o.readonly)return r.reject({code:t.PdfErrorCode.NotSupport,message:`Cannot remove stamps from readonly library: ${e}`}),r;const n=o.stamps.findIndex(e=>e.id===a);if(-1===n)return r.reject({code:t.PdfErrorCode.NotFound,message:`Stamp ${a} not found in library: ${e}`}),r;const i=o.stamps[n].pageIndex;return this.engine.deletePage(o.document,i).wait(()=>{o.stamps.splice(n,1),o.document.pages.splice(i,1),o.document.pageCount=o.document.pages.length;for(const e of o.stamps)e.pageIndex>i&&e.pageIndex--;for(let e=0;e<o.document.pages.length;e++)o.document.pages[e].index=e;this.emitLibraryChange(),r.resolve()},e=>{this.logger.error("StampPlugin","RemoveStampFromLibrary",`Failed to delete page for stamp ${a}`,e),r.fail(e)}),r}updateStamp(e,a,r){const o=new t.Task,n=this.libraries.get(e);if(!n)return o.reject({code:t.PdfErrorCode.NotFound,message:`Stamp library not found: ${e}`}),o;if(n.readonly)return o.reject({code:t.PdfErrorCode.NotSupport,message:`Cannot update stamps in readonly library: ${e}`}),o;const i=n.stamps.find(e=>e.id===a);return i?(Object.assign(i,r),this.emitLibraryChange(),o.resolve(),o):(o.reject({code:t.PdfErrorCode.NotFound,message:`Stamp ${a} not found in library: ${e}`}),o)}updateLibrary(e,a){const r=new t.Task,o=this.libraries.get(e);return o?o.readonly?(r.reject({code:t.PdfErrorCode.NotSupport,message:`Cannot update readonly library: ${e}`}),r):(void 0!==a.name&&(o.name=a.name),void 0!==a.nameKey&&(o.nameKey=a.nameKey),void 0!==a.categories&&(o.categories=a.categories),void 0!==a.readonly&&(o.readonly=a.readonly),this.emitLibraryChange(),r.resolve(),r):(r.reject({code:t.PdfErrorCode.NotFound,message:`Stamp library not found: ${e}`}),r)}loadLibraryFromManifest(e){return this.loadManifestUrl(e,!0)}async initializeManifests(){var e;const t=(null==(e=this.i18n)?void 0:e.getLocale())??"en";for(const a of this.config.manifests){const e=a.url.includes("{locale}"),r=e?t:"",o=a.url.replace("{locale}",r||t),n={source:a,localeAware:e,currentLocale:e?t:"",libraryId:null};this.managedManifests.push(n);try{const e=await this.loadManifestUrl(o,!0).toPromise();n.libraryId=e}catch{if(e&&a.fallbackLocale&&a.fallbackLocale!==t){const e=a.url.replace("{locale}",a.fallbackLocale);try{const t=await this.loadManifestUrl(e,!0).toPromise();n.libraryId=t,n.currentLocale=a.fallbackLocale}catch{this.logger.warn("StampPlugin","InitManifests",`Failed to load manifest (including fallback): ${a.url}`)}}else this.logger.warn("StampPlugin","InitManifests",`Failed to load manifest: ${o}`)}}this.i18n&&(this.localeUnsubscribe=this.i18n.onLocaleChange(e=>{this.handleLocaleChange(e.currentLocale)}))}async handleLocaleChange(e){for(const t of this.managedManifests){if(!t.localeAware||t.currentLocale===e)continue;if(t.libraryId){try{await this.removeLibrary(t.libraryId).toPromise()}catch{}t.libraryId=null}const a=t.source.url.replace("{locale}",e);try{const r=await this.loadManifestUrl(a,!0).toPromise();t.libraryId=r,t.currentLocale=e}catch{const a=t.source.fallbackLocale??"en";if(a!==e){const r=t.source.url.replace("{locale}",a);try{const e=await this.loadManifestUrl(r,!0).toPromise();t.libraryId=e,t.currentLocale=a}catch{this.logger.warn("StampPlugin","LocaleChange",`Failed to load manifest for locale ${e} (including fallback): ${t.source.url}`)}}else this.logger.warn("StampPlugin","LocaleChange",`Failed to load manifest for locale ${e}: ${t.source.url}`)}}}loadManifestUrl(e,a){const r=new t.Task;return fetch(e).then(e=>{if(!e.ok)throw new Error(`HTTP ${e.status}: ${e.statusText}`);return e.json()}).then(o=>{const n=this.resolveManifestPdfUrl(e,o.pdf),i=o.stamps.map(e=>{return{id:e.id??t.uuidV4(),pageIndex:e.pageIndex,name:(a=e.name,a?u[a]??t.PdfAnnotationName.Custom:t.PdfAnnotationName.Custom),subject:e.subject,subjectKey:e.subjectKey,label:e.label,categories:e.categories};var a}),s={id:o.id,name:o.name,nameKey:o.nameKey,pdf:n,stamps:i,categories:o.categories,readonly:a};this.loadLibraryInternal(s).wait(e=>r.resolve(e),e=>r.fail(e))}).catch(a=>{this.logger.error("StampPlugin","LoadManifest",`Failed to fetch manifest: ${e}`,a),r.reject({code:t.PdfErrorCode.NotFound,message:`Failed to load stamp manifest: ${e}`})}),r}resolveManifestPdfUrl(e,t){if(t.startsWith("http://")||t.startsWith("https://")||t.startsWith("/"))return t;return e.substring(0,e.lastIndexOf("/")+1)+t}generateLibraryId(){return t.uuidV4()}getLibraryDocumentId(e){return`stamp-doc-${this.instanceId}-${e}`}emitLibraryChange(){this.libraryChange$.emit(this.getLibraries())}async destroy(){this.currentGhostUrl&&(URL.revokeObjectURL(this.currentGhostUrl),this.currentGhostUrl=null),this.toolChangeUnsubscribe&&(this.toolChangeUnsubscribe(),this.toolChangeUnsubscribe=null),this.localeUnsubscribe&&(this.localeUnsubscribe(),this.localeUnsubscribe=null),this.activeStamp$.clear();const e=Array.from(this.libraries.values());for(const t of e)try{await this.engine.closeDocument(t.document).toPromise()}catch{}this.libraries.clear(),this.managedManifests.length=0,super.destroy()}};p.id=r;let g=p;const h={libraryIds:[]},f=(e=h,t)=>{switch(t.type){case n:return{...e,libraryIds:[...e.libraryIds,t.payload]};case i:return{...e,libraryIds:e.libraryIds.filter(e=>e!==t.payload)};default:return e}},b={manifest:o,create:(e,t)=>new g(r,e,t),reducer:f,initialState:h};exports.ADD_STAMP_LIBRARY=n,exports.REMOVE_STAMP_LIBRARY=i,exports.RUBBER_STAMP_TOOL_ID=c,exports.STAMP_PLUGIN_ID=r,exports.StampPlugin=g,exports.StampPluginPackage=b,exports.addStampLibrary=s,exports.initialState=h,exports.manifest=o,exports.removeStampLibrary=l,exports.stampReducer=f;
-//# sourceMappingURL=index.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _embedpdf_core = require("@embedpdf/core");
+let _embedpdf_engine_core_runtime = require("@embedpdf/engine-core/runtime");
+let _embedpdf_plugin_annotation = require("@embedpdf/plugin-annotation");
+let _embedpdf_plugin_form = require("@embedpdf/plugin-form");
+//#region src/capability.ts
+const DEFAULT_PREVIEW_WIDTH = 256;
+const LIBRARY_PIECEINFO_APP = "EMBD_StampLibrary";
+const STAMP_PIECEINFO_APP = "EMBD_Stamp";
+const STAMP_SCHEMA_VERSION = 1;
+/** 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;
+const uid = (prefix) => `${prefix}-${Date.now().toString(36)}-${(seq++).toString(36)}`;
+const entryString = (entries, key) => {
+	const entry = entries[key];
+	return entry?.type === "string" && entry.value.length > 0 ? entry.value : void 0;
+};
+const entryName = (entries, key) => {
+	const entry = entries[key];
+	return entry?.type === "name" && entry.value.length > 0 ? entry.value : void 0;
+};
+const entryStringArray = (entries, key) => {
+	const entry = entries[key];
+	return entry?.type === "string-array" ? [...entry.value] : void 0;
+};
+const kindToPdfName = (kind) => kind === "signature" ? "Signature" : kind === "initials" ? "Initials" : "Stamp";
+const kindFromPdfName = (name) => {
+	switch (name?.toLowerCase()) {
+		case "stamp": return "stamp";
+		case "signature": return "signature";
+		case "initials": return "initials";
+		default: return;
+	}
+};
+const metadataPatch = (id, name, kind, subject, categories) => ({
+	Version: STAMP_SCHEMA_VERSION,
+	Id: id,
+	Name: name,
+	Kind: { name: kindToPdfName(kind) },
+	Subject: subject ?? null,
+	Categories: categories ?? null
+});
+const libraryMetadataPatch = (id, name, categories) => ({
+	Version: STAMP_SCHEMA_VERSION,
+	Id: id,
+	Name: name,
+	Kind: { name: "StampLibrary" },
+	Categories: categories ?? null
+});
+function createStampCapability(ctx, config = {}) {
+	/** Binary sidecar of the serializable store: asset bytes + cached preview,
+	*  keyed by asset id. The reducer never sees these (kernel rule 1). */
+	const binaries = /* @__PURE__ */ new Map();
+	/** The durable source of truth for a canonical library. Asset PDFs above
+	*  are derived page extractions; this map owns the rewritten whole PDF. */
+	const libraryBinaries = /* @__PURE__ */ new Map();
+	/** Whole-PDF rewrites must be serialized per library or two concurrent
+	*  appends could both start from the same bytes and lose one page. */
+	const libraryMutationTails = /* @__PURE__ */ new Map();
+	const mutateLibrary = (libraryId, mutation) => {
+		const result = (libraryMutationTails.get(libraryId) ?? Promise.resolve()).then(mutation);
+		const tail = result.then(() => void 0, () => void 0);
+		libraryMutationTails.set(libraryId, tail);
+		return result.finally(() => {
+			if (libraryMutationTails.get(libraryId) === tail) libraryMutationTails.delete(libraryId);
+		});
+	};
+	let assetEngineRef = null;
+	const assetEngine = () => {
+		if (!assetEngineRef) {
+			const cfg = config.assetEngine;
+			assetEngineRef = !cfg ? ctx.engine : typeof cfg === "function" ? cfg() : cfg;
+		}
+		return assetEngineRef;
+	};
+	const openAssetDocument = async (bytes, identity) => {
+		try {
+			return await (await assetEngine()).open({
+				kind: "bytes",
+				id: uid("stamp-import"),
+				bytes
+			}, {
+				scope: ["*"],
+				...identity ? { identity } : {}
+			});
+		} catch (err) {
+			if (!config.assetEngine && _embedpdf_engine_core_runtime.EngineError.is(err, _embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg)) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotImplemented, "[stamp] importing a library PDF needs an engine that can open local bytes, and this viewer's engine cannot (cloud). Pass stampPlugin({ assetEngine: () => import('@embedpdf/engine').then((m) => m.createLocalEngine()) }) — it loads lazily, on first import.");
+			throw err;
+		}
+	};
+	/** Import-time preview render → bytes. The asset engine is local by
+	*  definition, so the image source is always inline bytes. */
+	const imageToPreview = (image) => {
+		if (image.source.kind !== "bytes") throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotImplemented, "[stamp] asset engine returned a URL-sourced render; asset engines must be local");
+		return {
+			bytes: image.source.bytes,
+			mimeType: image.contentType
+		};
+	};
+	const allocateId = (preferred, prefix, taken) => {
+		let id = preferred;
+		if (!id || taken.has(id)) do
+			id = uid(prefix);
+		while (taken.has(id));
+		taken.add(id);
+		return id;
+	};
+	const createLooseLibrary = (name) => {
+		const id = uid("stamp-lib");
+		ctx.dispatch({
+			type: "LIBRARY_ADDED",
+			library: {
+				id,
+				name,
+				storage: "loose",
+				assetIds: []
+			}
+		});
+		return id;
+	};
+	const importLibraryPdf = async (source, opts) => {
+		const resolved = await (0, _embedpdf_engine_core_runtime.resolveBinarySource)(source);
+		if ((0, _embedpdf_engine_core_runtime.sniffBinaryMetadata)(resolved.bytes)?.mimeType !== "application/pdf") throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "[stamp] importLibraryPdf needs PDF bytes (use addAsset for a raster image)");
+		const doc = await openAssetDocument(new Uint8Array(resolved.bytes));
+		let imported;
+		try {
+			if (!doc.pieceInfo || !doc.pages.extract) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotImplemented, "[stamp] canonical PDF libraries need an asset engine with pieceInfo and pages.extract");
+			const snapshot = await doc.pages.list();
+			if (snapshot.pageCount === 0) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "[stamp] a canonical stamp library PDF must contain at least one page");
+			const pages = snapshot.pages.map((layout) => {
+				const handle = doc.page(layout.pageObjectNumber);
+				if (!handle.pieceInfo) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotImplemented, "[stamp] canonical PDF libraries need page pieceInfo support");
+				return {
+					layout,
+					handle,
+					metadata: null
+				};
+			});
+			const catalogMetadata = await doc.pieceInfo.read(LIBRARY_PIECEINFO_APP);
+			for (const page of pages) page.metadata = await page.handle.pieceInfo.read(STAMP_PIECEINFO_APP);
+			const state = ctx.getState();
+			const takenLibraryIds = new Set(Object.keys(state.libraries));
+			const takenAssetIds = new Set(Object.keys(state.assets));
+			const catalogEntries = catalogMetadata?.entries ?? {};
+			const libraryId = allocateId(entryString(catalogEntries, "Id"), "stamp-lib", takenLibraryIds);
+			const libraryName = opts?.name ?? entryString(catalogEntries, "Name") ?? "Stamps";
+			const libraryCategories = opts?.categories ?? entryStringArray(catalogEntries, "Categories");
+			const descriptors = pages.map(({ layout, handle, metadata: pageMetadata }) => {
+				const entries = pageMetadata?.entries ?? {};
+				const id = allocateId(entryString(entries, "Id"), "stamp", takenAssetIds);
+				const kind = opts?.kind ?? kindFromPdfName(entryName(entries, "Kind")) ?? "stamp";
+				return {
+					handle,
+					asset: {
+						id,
+						libraryId,
+						kind,
+						name: opts?.assetName?.(layout.index) ?? entryString(entries, "Name") ?? `Stamp ${layout.index + 1}`,
+						size: {
+							width: layout.size.width,
+							height: layout.size.height
+						},
+						format: "pdf",
+						pageObjectNumber: layout.pageObjectNumber,
+						subject: entryString(entries, "Subject"),
+						categories: entryStringArray(entries, "Categories")
+					}
+				};
+			});
+			await doc.pieceInfo.update(LIBRARY_PIECEINFO_APP, libraryMetadataPatch(libraryId, libraryName, libraryCategories));
+			const assets = [];
+			for (const descriptor of descriptors) {
+				const { asset, handle } = descriptor;
+				await handle.pieceInfo.update(STAMP_PIECEINFO_APP, metadataPatch(asset.id, asset.name, asset.kind, asset.subject, asset.categories));
+				const bytes = await doc.pages.extract([asset.pageObjectNumber]);
+				const image = await handle.render.image({
+					viewport: {
+						kind: "width",
+						width: config.previewWidth ?? DEFAULT_PREVIEW_WIDTH
+					},
+					background: "transparent",
+					includeAnnotations: true,
+					format: "png"
+				});
+				assets.push({
+					asset,
+					bytes,
+					preview: imageToPreview(image)
+				});
+			}
+			imported = {
+				library: {
+					id: libraryId,
+					name: libraryName,
+					storage: "canonical-pdf",
+					categories: libraryCategories,
+					assetIds: []
+				},
+				canonicalBytes: await doc.download(),
+				assets
+			};
+		} finally {
+			await doc.close();
+		}
+		libraryBinaries.set(imported.library.id, imported.canonicalBytes);
+		ctx.dispatch({
+			type: "LIBRARY_ADDED",
+			library: imported.library
+		});
+		for (const { asset, bytes, preview } of imported.assets) {
+			binaries.set(asset.id, {
+				bytes,
+				preview
+			});
+			ctx.dispatch({
+				type: "ASSET_ADDED",
+				asset
+			});
+		}
+		return imported.library.id;
+	};
+	const addAsset = async (input) => {
+		const targetLibrary = input.libraryId ? ctx.getState().libraries[input.libraryId] ?? null : null;
+		if (input.libraryId && !targetLibrary) 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 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";
+		let suppliedPreview = null;
+		if (input.preview) {
+			const preview = await (0, _embedpdf_engine_core_runtime.resolveBinarySource)(input.preview);
+			suppliedPreview = {
+				bytes: new Uint8Array(preview.bytes),
+				mimeType: preview.mimeType ?? "image/png"
+			};
+		}
+		if (targetLibrary?.storage === "canonical-pdf") {
+			if (!isPdf) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "[stamp] raster assets cannot be appended to a canonical PDF library");
+			return mutateLibrary(targetLibrary.id, async () => {
+				const liveLibrary = ctx.getState().libraries[targetLibrary.id];
+				if (liveLibrary?.storage !== "canonical-pdf") throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotFound, `[stamp] canonical library '${targetLibrary.id}' no longer exists`);
+				const canonicalBytes = libraryBinaries.get(liveLibrary.id);
+				if (!canonicalBytes) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.Unknown, `[stamp] canonical bytes are missing for library '${liveLibrary.id}'`);
+				const assetId = uid("stamp");
+				const doc = await openAssetDocument(canonicalBytes);
+				let appended;
+				try {
+					if (!doc.pages.insert || !doc.pages.extract) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotImplemented, "[stamp] appending to a canonical library needs pages.insert and pages.extract");
+					const result = await doc.pages.insert(new Uint8Array(resolved.bytes));
+					if (result.insertedPageObjectNumbers.length !== 1) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "[stamp] a canonical library asset must be a single-page PDF");
+					const pageObjectNumber = result.insertedPageObjectNumbers[0];
+					const layout = result.layout.pages.find((candidate) => candidate.pageObjectNumber === pageObjectNumber);
+					const page = doc.page(pageObjectNumber);
+					if (!layout || !page.pieceInfo) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotImplemented, "[stamp] canonical PDF libraries need page layout and pieceInfo support");
+					const asset = {
+						id: assetId,
+						libraryId: liveLibrary.id,
+						kind: input.kind ?? "stamp",
+						name: input.name,
+						size: {
+							width: layout.size.width,
+							height: layout.size.height
+						},
+						format: "pdf",
+						pageObjectNumber,
+						subject: input.subject,
+						categories: input.categories
+					};
+					await page.pieceInfo.update(STAMP_PIECEINFO_APP, metadataPatch(asset.id, asset.name, asset.kind, asset.subject, asset.categories));
+					const bytes = await doc.pages.extract([pageObjectNumber]);
+					let preview = suppliedPreview;
+					if (!preview) preview = imageToPreview(await page.render.image({
+						viewport: {
+							kind: "width",
+							width: config.previewWidth ?? DEFAULT_PREVIEW_WIDTH
+						},
+						background: "transparent",
+						includeAnnotations: true,
+						format: "png"
+					}));
+					appended = {
+						asset,
+						bytes,
+						preview,
+						canonical: await doc.download()
+					};
+				} finally {
+					await doc.close();
+				}
+				libraryBinaries.set(liveLibrary.id, appended.canonical);
+				binaries.set(appended.asset.id, {
+					bytes: appended.bytes,
+					preview: appended.preview
+				});
+				ctx.dispatch({
+					type: "ASSET_ADDED",
+					asset: appended.asset
+				});
+				return appended.asset.id;
+			});
+		}
+		const size = input.size ?? ("width" in meta ? {
+			width: meta.width,
+			height: meta.height
+		} : null);
+		if (!size) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, "[stamp] a PDF asset needs `size` (its page size in points) — PDF bytes carry no sniffable dimensions");
+		let preview = suppliedPreview;
+		if (!preview && !isPdf) preview = {
+			bytes: new Uint8Array(resolved.bytes),
+			mimeType: meta.mimeType
+		};
+		const commitLooseAsset = (libraryId) => {
+			const asset = {
+				id: uid("stamp"),
+				libraryId,
+				kind: input.kind ?? "stamp",
+				name: input.name,
+				size,
+				format: isPdf ? "pdf" : meta.mimeType === "image/png" ? "png" : "jpeg",
+				subject: input.subject,
+				categories: input.categories
+			};
+			binaries.set(asset.id, {
+				bytes: new Uint8Array(resolved.bytes),
+				preview
+			});
+			ctx.dispatch({
+				type: "ASSET_ADDED",
+				asset
+			});
+			return asset.id;
+		};
+		if (!targetLibrary) return commitLooseAsset(createLooseLibrary(input.name));
+		return mutateLibrary(targetLibrary.id, async () => {
+			const liveLibrary = ctx.getState().libraries[targetLibrary.id];
+			if (liveLibrary?.storage !== "loose") throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotFound, `[stamp] loose library '${targetLibrary.id}' no longer exists`);
+			return commitLooseAsset(liveLibrary.id);
+		});
+	};
+	const dropLibrary = (id) => {
+		const library = ctx.getState().libraries[id];
+		if (library) for (const assetId of library.assetIds) binaries.delete(assetId);
+		libraryBinaries.delete(id);
+		ctx.dispatch({
+			type: "LIBRARY_REMOVED",
+			libraryId: id
+		});
+	};
+	const removeAsset = async (id) => {
+		const initialAsset = ctx.getState().assets[id];
+		if (!initialAsset) return;
+		return mutateLibrary(initialAsset.libraryId, async () => {
+			const asset = ctx.getState().assets[id];
+			if (!asset) return;
+			const library = ctx.getState().libraries[asset.libraryId];
+			if (library?.storage === "canonical-pdf") {
+				if (library.assetIds.length === 1) {
+					dropLibrary(library.id);
+					return;
+				}
+				if (asset.pageObjectNumber === void 0) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.Unknown, `[stamp] canonical asset '${id}' has no page object number`);
+				const canonicalBytes = libraryBinaries.get(library.id);
+				if (!canonicalBytes) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.Unknown, `[stamp] canonical bytes are missing for library '${library.id}'`);
+				const doc = await openAssetDocument(canonicalBytes);
+				let rewritten;
+				try {
+					await doc.pages.delete([asset.pageObjectNumber]);
+					rewritten = await doc.download();
+				} finally {
+					await doc.close();
+				}
+				libraryBinaries.set(library.id, rewritten);
+			}
+			binaries.delete(id);
+			ctx.dispatch({
+				type: "ASSET_REMOVED",
+				assetId: id
+			});
+		});
+	};
+	const removeLibrary = (id) => mutateLibrary(id, async () => dropLibrary(id));
+	const surfaceScriptingResult = (result) => {
+		try {
+			for (const effect of result.uiEffects) config.scripting?.onUiEffect?.(effect);
+			for (const diagnostic of result.diagnostics) config.scripting?.onDiagnostic?.(diagnostic);
+			if (result.error) config.scripting?.onError?.(result.error);
+		} catch (error) {
+			globalThis.console?.error("[stamp] scripting observer failed:", error);
+		}
+	};
+	/**
+	* Form-backed stamps are executable templates only until placement. Work
+	* on an isolated copy so neither the canonical library nor its reusable
+	* per-page extraction becomes target/user/time specific.
+	*/
+	const materializeForPlacement = async (documentId, asset, bin) => {
+		if (asset.format !== "pdf" || !config.scripting?.enabled) return bin;
+		const targetDoc = ctx.documentHandle(documentId);
+		const targetMeta = ctx.core().documents[documentId] ?? null;
+		if (!targetDoc || !targetMeta) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotFound, `[stamp] target document '${documentId}' is not open`);
+		const canonicalBytes = libraryBinaries.get(asset.libraryId);
+		const sourceBytes = canonicalBytes ?? bin.bytes;
+		const doc = await openAssetDocument(new Uint8Array(sourceBytes), targetDoc.security.identity);
+		let scripting = null;
+		try {
+			const layout = await doc.pages.list();
+			const selectedPage = asset.pageObjectNumber === void 0 ? layout.pageCount === 1 ? layout.pages[0] : void 0 : layout.pages.find(({ pageObjectNumber }) => pageObjectNumber === asset.pageObjectNumber);
+			if (!selectedPage) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.InvalidArg, canonicalBytes ? `[stamp] canonical page ${asset.pageObjectNumber ?? "unknown"} no longer exists` : "[stamp] a loose dynamic stamp asset must contain exactly one page");
+			const snapshot = await doc.forms.list();
+			if (!snapshot.fields.some((field) => field.widgets.some(({ pageObjectNumber }) => pageObjectNumber === selectedPage.pageObjectNumber))) return bin;
+			if (!doc.pages.flatten || !doc.pages.extract) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotImplemented, "[stamp] dynamic PDF stamps need an asset engine with pages.flatten and pages.extract");
+			const scriptingConfig = config.scripting;
+			scripting = (0, _embedpdf_plugin_form.createFormScriptingController)({
+				doc,
+				document: () => targetMeta,
+				config: scriptingConfig,
+				sandboxFactory: scriptingConfig.sandboxFactory ?? (() => import("@embedpdf/core-js-sandbox").then(({ createQuickJsSandbox }) => createQuickJsSandbox()))
+			});
+			const result = await scripting.recalculate(snapshot);
+			surfaceScriptingResult(result);
+			if (result.status === "failed") throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.Unknown, `[stamp] dynamic stamp scripting failed: ${result.error?.message ?? "native form effect failed"}`);
+			const pageObjectNumber = selectedPage.pageObjectNumber;
+			const failed = (await doc.pages.flatten([pageObjectNumber], "display")).results.find(({ status }) => status === "failed" || status === "skipped");
+			if (failed) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.Unknown, `[stamp] dynamic stamp flatten failed for page ${failed.pageObjectNumber}`);
+			const bytes = await doc.pages.extract([pageObjectNumber]);
+			const image = await doc.page(pageObjectNumber).render.image({
+				viewport: {
+					kind: "width",
+					width: config.previewWidth ?? DEFAULT_PREVIEW_WIDTH
+				},
+				background: "transparent",
+				includeAnnotations: false,
+				format: "png"
+			});
+			return {
+				bytes,
+				preview: imageToPreview(image)
+			};
+		} finally {
+			scripting?.dispose();
+			await doc.close();
+		}
+	};
+	const armAsset = async (documentId, assetId, opts) => {
+		const asset = ctx.getState().assets[assetId];
+		const bin = binaries.get(assetId);
+		if (!asset || !bin) throw new _embedpdf_engine_core_runtime.EngineError(_embedpdf_engine_core_runtime.EngineErrorCode.NotFound, `[stamp] unknown asset '${assetId}'`);
+		const placement = await materializeForPlacement(documentId, asset, bin);
+		await ctx.forDocument(_embedpdf_plugin_annotation.AnnotationToken, documentId).armStamp({
+			source: placement.bytes,
+			preview: placement.preview ? {
+				data: placement.preview.bytes,
+				mimeType: placement.preview.mimeType
+			} : void 0,
+			intrinsicSize: asset.size,
+			targetWidth: opts?.targetWidth
+		});
+	};
+	ctx.cleanup(() => {
+		binaries.clear();
+		libraryBinaries.clear();
+		libraryMutationTails.clear();
+		const ownedAssetEngine = typeof config.assetEngine === "function" ? assetEngineRef : null;
+		assetEngineRef = null;
+		if (ownedAssetEngine) Promise.resolve(ownedAssetEngine).then((engine) => engine.destroy()).catch(() => {});
+	});
+	return {
+		libraries: () => {
+			const s = ctx.getState();
+			return s.libraryOrder.map((id) => s.libraries[id]).filter((l) => l != null);
+		},
+		library: (id) => ctx.getState().libraries[id] ?? null,
+		assets: (libraryId) => {
+			const s = ctx.getState();
+			if (libraryId) {
+				const library = s.libraries[libraryId];
+				return library ? library.assetIds.map((id) => s.assets[id]).filter((a) => a != null) : [];
+			}
+			return s.libraryOrder.flatMap((lid) => (s.libraries[lid]?.assetIds ?? []).map((id) => s.assets[id]).filter((a) => a != null));
+		},
+		asset: (id) => ctx.getState().assets[id] ?? null,
+		assetPreview: (id) => binaries.get(id)?.preview ?? null,
+		assetBytes: (id) => binaries.get(id)?.bytes ?? null,
+		libraryBytes: (id) => libraryBinaries.get(id) ?? null,
+		importLibraryPdf,
+		addAsset,
+		removeAsset,
+		removeLibrary,
+		armAsset,
+		disarm: (documentId) => ctx.forDocument(_embedpdf_plugin_annotation.AnnotationToken, documentId).disarmStamp()
+	};
+}
+//#endregion
+//#region src/reducer.ts
+const initialStampState = () => ({
+	libraries: {},
+	libraryOrder: [],
+	assets: {}
+});
+/** Pure and serializable (kernel rule 1) — descriptors only; the bytes and
+*  previews live in the capability and never enter the store. */
+const stampReducer = (state, action) => {
+	switch (action.type) {
+		case "LIBRARY_ADDED": return {
+			...state,
+			libraries: {
+				...state.libraries,
+				[action.library.id]: action.library
+			},
+			libraryOrder: [...state.libraryOrder, action.library.id]
+		};
+		case "LIBRARY_REMOVED": {
+			const library = state.libraries[action.libraryId];
+			if (!library) return state;
+			const libraries = { ...state.libraries };
+			delete libraries[action.libraryId];
+			const assets = { ...state.assets };
+			for (const id of library.assetIds) delete assets[id];
+			return {
+				...state,
+				libraries,
+				libraryOrder: state.libraryOrder.filter((id) => id !== action.libraryId),
+				assets
+			};
+		}
+		case "ASSET_ADDED": {
+			const library = state.libraries[action.asset.libraryId];
+			if (!library) return state;
+			return {
+				...state,
+				assets: {
+					...state.assets,
+					[action.asset.id]: action.asset
+				},
+				libraries: {
+					...state.libraries,
+					[library.id]: {
+						...library,
+						assetIds: [...library.assetIds, action.asset.id]
+					}
+				}
+			};
+		}
+		case "ASSET_REMOVED": {
+			const asset = state.assets[action.assetId];
+			if (!asset) return state;
+			const assets = { ...state.assets };
+			delete assets[action.assetId];
+			const library = state.libraries[asset.libraryId];
+			return {
+				...state,
+				assets,
+				libraries: library ? {
+					...state.libraries,
+					[library.id]: {
+						...library,
+						assetIds: library.assetIds.filter((id) => id !== action.assetId)
+					}
+				} : state.libraries
+			};
+		}
+		default: return state;
+	}
+};
+//#endregion
+//#region src/types.ts
+const StampToken = (0, _embedpdf_core.createCapabilityToken)("stamp");
+//#endregion
+//#region src/stamp.plugin.ts
+/**
+* The stamp plugin. WORKSPACE-scoped: libraries are shared across every open
+* document; placement names its document explicitly (`armAsset(documentId, …)`)
+* and delegates to that document's annotation plugin — no hard `requires`,
+* because the annotation token is document-scoped and resolved lazily per
+* placement (a viewer without the annotation plugin fails at the arm call,
+* with the kernel's own missing-capability error).
+*/
+const stampPlugin = (config = {}) => (0, _embedpdf_core.definePlugin)({
+	id: "stamp",
+	token: StampToken,
+	scope: "workspace",
+	initialState: initialStampState,
+	reduce: stampReducer,
+	capability: (ctx) => createStampCapability(ctx, config)
+});
+//#endregion
+exports.StampToken = StampToken;
+exports.stampPlugin = stampPlugin;
+
+//# sourceMappingURL=index.cjs.map