@embedpdf/plugin-form 2.15.0 → 3.0.0-next.0

package/dist/index.cjs

@@ -1,2 +1,1416 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/core"),t=require("@embedpdf/models"),o=require("@embedpdf/plugin-history"),n=require("@embedpdf/plugin-annotation"),i="form",a={id:i,name:"Form Plugin",version:"1.0.0",provides:["form"],requires:["interaction-manager"],optional:["history","annotation"],defaultConfig:{enabled:!0}},r="FORM/INIT_STATE",l="FORM/CLEANUP_STATE",s="FORM/SELECT_FIELD",d="FORM/DESELECT_FIELD";function c(e,t){return{type:s,payload:{documentId:e,annotationId:t}}}const u={selectedFieldId:null},f={documents:{}},h={annotationType:t.PdfAnnotationSubtype.WIDGET,create(o){const{pageIndex:i,onCommit:a,onPreview:r,getTool:l,pageSize:s}=o,[d,c]=n.useState(null),u=t=>({x:e.clamp(t.x,0,s.width),y:e.clamp(t.y,0,s.height)}),f=()=>{const e=l();return e?{...e.defaults,fontFamily:e.defaults.fontFamily??t.PdfStandardFont.Helvetica,fontSize:e.defaults.fontSize??12,fontColor:e.defaults.fontColor??"#000000",strokeColor:e.defaults.strokeColor??"#000000",color:e.defaults.color??"#FFFFFF",strokeWidth:e.defaults.strokeWidth??1,field:e.defaults.field}:null},h=(e,t)=>({origin:{x:Math.min(e.x,t.x),y:Math.min(e.y,t.y)},size:{width:Math.abs(e.x-t.x),height:Math.abs(e.y-t.y)}}),g=e=>{var o;const n=f(),a=`TextField_${t.uuidV4().slice(0,8)}`;return{...n,type:t.PdfAnnotationSubtype.WIDGET,id:t.uuidV4(),pageIndex:i,rect:e,created:new Date,fontFamily:n.fontFamily,fontSize:n.fontSize,fontColor:n.fontColor,strokeColor:n.strokeColor,color:n.color,strokeWidth:n.strokeWidth,field:{type:t.PDF_FORM_FIELD_TYPE.TEXTFIELD,flag:(null==(o=n.field)?void 0:o.flag)??t.PDF_FORM_FIELD_FLAG.NONE,name:a,alternateName:a,value:""}}},p=n.useClickDetector({getTool:l,onClickDetected:t=>{if(!f())return;const o=l(),n=null==o?void 0:o.clickBehavior;if(!(null==n?void 0:n.enabled))return;const{width:i,height:r}=n.defaultSize,d=e.clamp(t.x-i/2,0,s.width-i),c=e.clamp(t.y-r/2,0,s.height-r);a(g({origin:{x:d,y:c},size:{width:i,height:r}}))}}),F=e=>{const o=d();if(!o)return null;const n=f();if(!n)return null;const i=h(o,e);return{type:t.PdfAnnotationSubtype.WIDGET,bounds:i,data:{rect:i,...n}}};return{onPointerDown:(e,t)=>{var o;const n=u(e);c(n),p.onStart(n),r(F(n)),null==(o=t.setPointerCapture)||o.call(t)},onPointerMove:e=>{const t=u(e);p.onMove(t),d()&&p.hasMoved()&&r(F(t))},onPointerUp:(e,t)=>{var o;const n=d();if(!n)return;const i=u(e);if(p.hasMoved()){const e=h(n,i);e.size.width>5&&e.size.height>5&&a(g(e))}else p.onEnd(i);c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)},onPointerLeave:(e,t)=>{var o;c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)},onPointerCancel:(e,t)=>{var o;c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)}}}},g={annotationType:t.PdfAnnotationSubtype.WIDGET,create(o){const{pageIndex:i,onCommit:a,onPreview:r,getTool:l,pageSize:s}=o,[d,c]=n.useState(null),u=t=>({x:e.clamp(t.x,0,s.width),y:e.clamp(t.y,0,s.height)}),f=()=>{const e=l();return e?{...e.defaults,strokeColor:e.defaults.strokeColor??"#000000",color:e.defaults.color??"#FFFFFF",strokeWidth:e.defaults.strokeWidth??1,field:e.defaults.field}:null},h=(e,t)=>({origin:{x:Math.min(e.x,t.x),y:Math.min(e.y,t.y)},size:{width:Math.abs(e.x-t.x),height:Math.abs(e.y-t.y)}}),g=e=>{var o;const n=f(),a=`Checkbox_${t.uuidV4().slice(0,8)}`;return{...n,type:t.PdfAnnotationSubtype.WIDGET,id:t.uuidV4(),pageIndex:i,rect:e,created:new Date,strokeColor:n.strokeColor,color:n.color,strokeWidth:n.strokeWidth,exportValue:"Yes",field:{type:t.PDF_FORM_FIELD_TYPE.CHECKBOX,flag:(null==(o=n.field)?void 0:o.flag)??t.PDF_FORM_FIELD_FLAG.NONE,name:a,alternateName:a,value:"Off"}}},p=n.useClickDetector({getTool:l,onClickDetected:t=>{if(!f())return;const o=l(),n=null==o?void 0:o.clickBehavior;if(!(null==n?void 0:n.enabled))return;const{width:i,height:r}=n.defaultSize,d=e.clamp(t.x-i/2,0,s.width-i),c=e.clamp(t.y-r/2,0,s.height-r);a(g({origin:{x:d,y:c},size:{width:i,height:r}}))}}),F=e=>{const o=d();if(!o)return null;const n=f();if(!n)return null;const i=h(o,e);return{type:t.PdfAnnotationSubtype.WIDGET,bounds:i,data:{rect:i,...n}}};return{onPointerDown:(e,t)=>{var o;const n=u(e);c(n),p.onStart(n),r(F(n)),null==(o=t.setPointerCapture)||o.call(t)},onPointerMove:e=>{const t=u(e);p.onMove(t),d()&&p.hasMoved()&&r(F(t))},onPointerUp:(e,t)=>{var o;const n=d();if(!n)return;const i=u(e);if(p.hasMoved()){const e=h(n,i);e.size.width>5&&e.size.height>5&&a(g(e))}else p.onEnd(i);c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)},onPointerLeave:(e,t)=>{var o;c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)},onPointerCancel:(e,t)=>{var o;c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)}}}},p={annotationType:t.PdfAnnotationSubtype.WIDGET,create(o){const{pageIndex:i,onCommit:a,onPreview:r,getTool:l,pageSize:s}=o,[d,c]=n.useState(null),u=t=>({x:e.clamp(t.x,0,s.width),y:e.clamp(t.y,0,s.height)}),f=()=>{const e=l();return e?{...e.defaults,strokeColor:e.defaults.strokeColor??"#000000",color:e.defaults.color??"#FFFFFF",strokeWidth:e.defaults.strokeWidth??1,field:e.defaults.field}:null},h=(e,t)=>{const o=t.x-e.x,n=t.y-e.y,i=Math.max(Math.abs(o),Math.abs(n)),a=o<0?-i:i,r=n<0?-i:i;return{origin:{x:Math.min(e.x,e.x+a),y:Math.min(e.y,e.y+r)},size:{width:i,height:i}}},g=e=>{var o;const n=f(),a=`RadioButton_${t.uuidV4().slice(0,8)}`,r=t.uuidV4();return{...n,type:t.PdfAnnotationSubtype.WIDGET,id:r,pageIndex:i,rect:e,created:new Date,strokeColor:n.strokeColor,color:n.color,strokeWidth:n.strokeWidth,exportValue:r,field:{type:t.PDF_FORM_FIELD_TYPE.RADIOBUTTON,flag:(null==(o=n.field)?void 0:o.flag)??t.PDF_FORM_FIELD_FLAG.BUTTON_RADIO|t.PDF_FORM_FIELD_FLAG.BUTTON_NOTOGGLETOOFF,name:a,alternateName:a,value:"Off",options:[]}}},p=n.useClickDetector({getTool:l,onClickDetected:t=>{if(!f())return;const o=l(),n=null==o?void 0:o.clickBehavior;if(!(null==n?void 0:n.enabled))return;const{width:i,height:r}=n.defaultSize,d=e.clamp(t.x-i/2,0,s.width-i),c=e.clamp(t.y-r/2,0,s.height-r);a(g({origin:{x:d,y:c},size:{width:i,height:r}}))}}),F=e=>{const o=d();if(!o)return null;const n=f();if(!n)return null;const i=h(o,e);return{type:t.PdfAnnotationSubtype.WIDGET,bounds:i,data:{rect:i,...n}}};return{onPointerDown:(e,t)=>{var o;const n=u(e);c(n),p.onStart(n),r(F(n)),null==(o=t.setPointerCapture)||o.call(t)},onPointerMove:e=>{const t=u(e);p.onMove(t),d()&&p.hasMoved()&&r(F(t))},onPointerUp:(e,t)=>{var o;const n=d();if(!n)return;const i=u(e);if(p.hasMoved()){const e=h(n,i);e.size.width>5&&e.size.height>5&&a(g(e))}else p.onEnd(i);c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)},onPointerLeave:(e,t)=>{var o;c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)},onPointerCancel:(e,t)=>{var o;c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)}}}},F={annotationType:t.PdfAnnotationSubtype.WIDGET,create(o){const{pageIndex:i,onCommit:a,onPreview:r,getTool:l,pageSize:s}=o,[d,c]=n.useState(null),u=t=>({x:e.clamp(t.x,0,s.width),y:e.clamp(t.y,0,s.height)}),f=()=>{const e=l();return e?{...e.defaults,fontFamily:e.defaults.fontFamily??t.PdfStandardFont.Helvetica,fontSize:e.defaults.fontSize??12,fontColor:e.defaults.fontColor??"#000000",strokeColor:e.defaults.strokeColor??"#000000",color:e.defaults.color??"#FFFFFF",strokeWidth:e.defaults.strokeWidth??1,field:e.defaults.field}:null},h=(e,t)=>({origin:{x:Math.min(e.x,t.x),y:Math.min(e.y,t.y)},size:{width:Math.abs(e.x-t.x),height:Math.abs(e.y-t.y)}}),g=e=>{var o;const n=f(),a=`Combobox_${t.uuidV4().slice(0,8)}`;return{...n,type:t.PdfAnnotationSubtype.WIDGET,id:t.uuidV4(),pageIndex:i,rect:e,created:new Date,fontFamily:n.fontFamily,fontSize:n.fontSize,fontColor:n.fontColor,strokeColor:n.strokeColor,color:n.color,strokeWidth:n.strokeWidth,field:{type:t.PDF_FORM_FIELD_TYPE.COMBOBOX,flag:(null==(o=n.field)?void 0:o.flag)??t.PDF_FORM_FIELD_FLAG.NONE,name:a,alternateName:a,value:"",options:[{label:"Option 1",isSelected:!0},{label:"Option 2",isSelected:!1},{label:"Option 3",isSelected:!1}]}}},p=n.useClickDetector({getTool:l,onClickDetected:t=>{if(!f())return;const o=l(),n=null==o?void 0:o.clickBehavior;if(!(null==n?void 0:n.enabled))return;const{width:i,height:r}=n.defaultSize,d=e.clamp(t.x-i/2,0,s.width-i),c=e.clamp(t.y-r/2,0,s.height-r);a(g({origin:{x:d,y:c},size:{width:i,height:r}}))}}),F=e=>{const o=d();if(!o)return null;const n=f();if(!n)return null;const i=h(o,e);return{type:t.PdfAnnotationSubtype.WIDGET,bounds:i,data:{rect:i,...n}}};return{onPointerDown:(e,t)=>{var o;const n=u(e);c(n),p.onStart(n),r(F(n)),null==(o=t.setPointerCapture)||o.call(t)},onPointerMove:e=>{const t=u(e);p.onMove(t),d()&&p.hasMoved()&&r(F(t))},onPointerUp:(e,t)=>{var o;const n=d();if(!n)return;const i=u(e);if(p.hasMoved()){const e=h(n,i);e.size.width>5&&e.size.height>5&&a(g(e))}else p.onEnd(i);c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)},onPointerLeave:(e,t)=>{var o;c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)},onPointerCancel:(e,t)=>{var o;c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)}}}},m={annotationType:t.PdfAnnotationSubtype.WIDGET,create(o){const{pageIndex:i,onCommit:a,onPreview:r,getTool:l,pageSize:s}=o,[d,c]=n.useState(null),u=t=>({x:e.clamp(t.x,0,s.width),y:e.clamp(t.y,0,s.height)}),f=()=>{const e=l();return e?{...e.defaults,fontFamily:e.defaults.fontFamily??t.PdfStandardFont.Helvetica,fontSize:e.defaults.fontSize??12,fontColor:e.defaults.fontColor??"#000000",strokeColor:e.defaults.strokeColor??"#000000",color:e.defaults.color??"#FFFFFF",strokeWidth:e.defaults.strokeWidth??1,field:e.defaults.field}:null},h=(e,t)=>({origin:{x:Math.min(e.x,t.x),y:Math.min(e.y,t.y)},size:{width:Math.abs(e.x-t.x),height:Math.abs(e.y-t.y)}}),g=e=>{var o;const n=f(),a=`Listbox_${t.uuidV4().slice(0,8)}`;return{...n,type:t.PdfAnnotationSubtype.WIDGET,id:t.uuidV4(),pageIndex:i,rect:e,created:new Date,fontFamily:n.fontFamily,fontSize:n.fontSize,fontColor:n.fontColor,strokeColor:n.strokeColor,color:n.color,strokeWidth:n.strokeWidth,field:{type:t.PDF_FORM_FIELD_TYPE.LISTBOX,flag:(null==(o=n.field)?void 0:o.flag)??t.PDF_FORM_FIELD_FLAG.NONE,name:a,alternateName:a,value:"",options:[{label:"Option 1",isSelected:!0},{label:"Option 2",isSelected:!1},{label:"Option 3",isSelected:!1}]}}},p=n.useClickDetector({getTool:l,onClickDetected:t=>{if(!f())return;const o=l(),n=null==o?void 0:o.clickBehavior;if(!(null==n?void 0:n.enabled))return;const{width:i,height:r}=n.defaultSize,d=e.clamp(t.x-i/2,0,s.width-i),c=e.clamp(t.y-r/2,0,s.height-r);a(g({origin:{x:d,y:c},size:{width:i,height:r}}))}}),F=e=>{const o=d();if(!o)return null;const n=f();if(!n)return null;const i=h(o,e);return{type:t.PdfAnnotationSubtype.WIDGET,bounds:i,data:{rect:i,...n}}};return{onPointerDown:(e,t)=>{var o;const n=u(e);c(n),p.onStart(n),r(F(n)),null==(o=t.setPointerCapture)||o.call(t)},onPointerMove:e=>{const t=u(e);p.onMove(t),d()&&p.hasMoved()&&r(F(t))},onPointerUp:(e,t)=>{var o;const n=d();if(!n)return;const i=u(e);if(p.hasMoved()){const e=h(n,i);e.size.width>5&&e.size.height>5&&a(g(e))}else p.onEnd(i);c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)},onPointerLeave:(e,t)=>{var o;c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)},onPointerCancel:(e,t)=>{var o;c(null),r(null),p.reset(),null==(o=t.releasePointerCapture)||o.call(t)}}}},y=n.defineAnnotationTool({id:"formTextField",name:"Text Field",labelKey:"form.textfield",categories:["annotation","form"],matchScore:e=>{var o;if(e.type!==t.PdfAnnotationSubtype.WIDGET)return 0;return(null==(o=e.field)?void 0:o.type)===t.PDF_FORM_FIELD_TYPE.TEXTFIELD?10:0},interaction:{exclusive:!1,cursor:"crosshair",isDraggable:!0,isResizable:!0,isRotatable:!1,isGroupDraggable:!0,isGroupResizable:!1,isGroupRotatable:!1},defaults:{type:t.PdfAnnotationSubtype.WIDGET,fontFamily:t.PdfStandardFont.Helvetica,fontSize:12,fontColor:"#000000",strokeColor:"#000000",color:"#FFFFFF",strokeWidth:1,field:{flag:t.PDF_FORM_FIELD_FLAG.NONE,name:"TextField",alternateName:"TextField",value:"",type:t.PDF_FORM_FIELD_TYPE.TEXTFIELD}},behavior:{useAppearanceStream:!1},clickBehavior:{enabled:!0,defaultSize:{width:150,height:24}},pointerHandler:h}),I=n.defineAnnotationTool({id:"formCheckbox",name:"Checkbox",labelKey:"form.checkbox",categories:["annotation","form"],matchScore:e=>{var o;if(e.type!==t.PdfAnnotationSubtype.WIDGET)return 0;return(null==(o=e.field)?void 0:o.type)===t.PDF_FORM_FIELD_TYPE.CHECKBOX?10:0},interaction:{exclusive:!1,cursor:"crosshair",isDraggable:!0,isResizable:!0,isRotatable:!1,isGroupDraggable:!0,isGroupResizable:!1,isGroupRotatable:!1},defaults:{type:t.PdfAnnotationSubtype.WIDGET,strokeColor:"#000000",color:"#FFFFFF",strokeWidth:1,field:{flag:t.PDF_FORM_FIELD_FLAG.NONE,name:"Checkbox",alternateName:"Checkbox",value:"Off",type:t.PDF_FORM_FIELD_TYPE.CHECKBOX}},behavior:{useAppearanceStream:!1},clickBehavior:{enabled:!0,defaultSize:{width:20,height:20}},pointerHandler:g}),P=n.defineAnnotationTool({id:"formRadioButton",name:"Radio Button",labelKey:"form.radiobutton",categories:["annotation","form"],matchScore:e=>{var o;if(e.type!==t.PdfAnnotationSubtype.WIDGET)return 0;return(null==(o=e.field)?void 0:o.type)===t.PDF_FORM_FIELD_TYPE.RADIOBUTTON?10:0},interaction:{exclusive:!1,cursor:"crosshair",isDraggable:!0,isResizable:!0,isRotatable:!1,lockAspectRatio:!0,isGroupDraggable:!0,isGroupResizable:!1,isGroupRotatable:!1},defaults:{type:t.PdfAnnotationSubtype.WIDGET,strokeColor:"#000000",color:"#FFFFFF",strokeWidth:1,field:{flag:t.PDF_FORM_FIELD_FLAG.BUTTON_RADIO|t.PDF_FORM_FIELD_FLAG.BUTTON_NOTOGGLETOOFF,name:"RadioButton",alternateName:"RadioButton",value:"Off",type:t.PDF_FORM_FIELD_TYPE.RADIOBUTTON,options:[]}},behavior:{useAppearanceStream:!1},clickBehavior:{enabled:!0,defaultSize:{width:20,height:20}},pointerHandler:p}),D=n.defineAnnotationTool({id:"formCombobox",name:"Combo Box",labelKey:"form.combobox",categories:["annotation","form"],matchScore:e=>{var o;if(e.type!==t.PdfAnnotationSubtype.WIDGET)return 0;return(null==(o=e.field)?void 0:o.type)===t.PDF_FORM_FIELD_TYPE.COMBOBOX?10:0},interaction:{exclusive:!1,cursor:"crosshair",isDraggable:!0,isResizable:!0,isRotatable:!1,isGroupDraggable:!0,isGroupResizable:!1,isGroupRotatable:!1},defaults:{type:t.PdfAnnotationSubtype.WIDGET,fontFamily:t.PdfStandardFont.Helvetica,fontSize:12,fontColor:"#000000",strokeColor:"#000000",color:"#FFFFFF",strokeWidth:1,field:{flag:t.PDF_FORM_FIELD_FLAG.NONE,name:"ComboBox",alternateName:"ComboBox",value:"",type:t.PDF_FORM_FIELD_TYPE.COMBOBOX,options:[{label:"Option 1",isSelected:!0},{label:"Option 2",isSelected:!1},{label:"Option 3",isSelected:!1}]}},behavior:{useAppearanceStream:!1},clickBehavior:{enabled:!0,defaultSize:{width:200,height:40}},pointerHandler:F}),b=n.defineAnnotationTool({id:"formListbox",name:"List Box",labelKey:"form.listbox",categories:["annotation","form"],matchScore:e=>{var o;if(e.type!==t.PdfAnnotationSubtype.WIDGET)return 0;return(null==(o=e.field)?void 0:o.type)===t.PDF_FORM_FIELD_TYPE.LISTBOX?10:0},interaction:{exclusive:!1,cursor:"crosshair",isDraggable:!0,isResizable:!0,isRotatable:!1,isGroupDraggable:!0,isGroupResizable:!1,isGroupRotatable:!1},defaults:{type:t.PdfAnnotationSubtype.WIDGET,fontFamily:t.PdfStandardFont.Helvetica,fontSize:12,fontColor:"#000000",strokeColor:"#000000",color:"#FFFFFF",strokeWidth:1,field:{flag:t.PDF_FORM_FIELD_FLAG.NONE,name:"ListBox",alternateName:"ListBox",value:"",type:t.PDF_FORM_FIELD_TYPE.LISTBOX,options:[{label:"Option 1",isSelected:!0},{label:"Option 2",isSelected:!1},{label:"Option 3",isSelected:!1}]}},behavior:{useAppearanceStream:!1},clickBehavior:{enabled:!0,defaultSize:{width:150,height:150}},pointerHandler:m}),v=[y,I,P,D,b],x=class extends e.BasePlugin{constructor(t,n,i){var a,r;if(super(t,n),this.FORM_HISTORY_TOPIC="form-fields",this.annotation=null,this.history=null,this.state$=e.createScopedEmitter((e,t)=>({documentId:e,state:t})),this.fieldValueChange$=e.createScopedEmitter((e,t)=>t,{cache:!1}),this.formReady$=e.createScopedEmitter((e,t)=>({documentId:e,fields:t}),{cache:!1}),this.fieldGroupIndex=new Map,this.fieldNameIndex=new Map,this.orderedFieldIndex=new Map,this.propagationInProgress=new Set,this.annotation=(null==(a=n.getPlugin("annotation"))?void 0:a.provides())??null,this.history=(null==(r=n.getPlugin(o.HistoryPlugin.id))?void 0:r.provides())??null,this.annotation){for(const e of v)this.annotation.addTool(e);this.annotation.onAnnotationEvent(e=>this.handleAnnotationEvent(e))}}async initialize(){}onDocumentLoadingStarted(e){this.dispatch(function(e,t){return{type:r,payload:{documentId:e,state:t}}}(e,{...u}))}onDocumentClosed(e){this.dispatch(function(e){return{type:l,payload:e}}(e)),this.fieldGroupIndex.delete(e),this.fieldNameIndex.delete(e),this.orderedFieldIndex.delete(e),this.state$.clearScope(e),this.fieldValueChange$.clearScope(e),this.formReady$.clearScope(e)}onStoreUpdated(e,t){for(const o in t.documents){const n=e.documents[o],i=t.documents[o];n!==i&&this.state$.emit(o,i)}}buildCapability(){return{getPageFormAnnoWidgets:(e,t)=>this.getPageFormAnnoWidgets(e,t),setFormFieldValues:(e,t,o,n)=>this.setFormFieldValues(e,t,o,n),renameField:(e,t,o)=>this.renameFieldMethod(e,t,o),shareField:(e,t,o)=>this.shareFieldMethod(e,t,o),renderWidget:(e,t)=>this.renderWidget(e,t),selectField:(e,t)=>this.selectFieldMethod(e,t),deselectField:e=>this.deselectFieldMethod(e),getSelectedFieldId:e=>this.getSelectedFieldId(e),selectNextField:e=>this.selectNextFieldMethod(e),selectPreviousField:e=>this.selectPreviousFieldMethod(e),activateField:e=>this.activateFieldMethod(e),getState:e=>this.getDocumentState(e),getFieldGroup:(e,t)=>this.getFieldGroup(e,t),getFieldSiblings:(e,t)=>this.getFieldSiblings(e,t),getFormValues:e=>this.getFormValuesMethod(e),getFormFields:e=>this.getFormFieldsMethod(e),setFormValues:(e,t)=>this.setFormValuesMethod(e,t),forDocument:e=>this.createFormScope(e),onStateChange:this.state$.onGlobal,onFieldValueChange:this.fieldValueChange$.onGlobal,onFormReady:this.formReady$.onGlobal}}createFormScope(e){return{getPageFormAnnoWidgets:t=>this.getPageFormAnnoWidgets(t,e),setFormFieldValues:(t,o,n)=>this.setFormFieldValues(t,o,n,e),renameField:(t,o)=>this.renameFieldMethod(t,o,e),shareField:(t,o)=>this.shareFieldMethod(t,o,e),renderWidget:t=>this.renderWidget(t,e),selectField:t=>this.selectFieldMethod(t,e),deselectField:()=>this.deselectFieldMethod(e),getSelectedFieldId:()=>this.getSelectedFieldId(e),selectNextField:()=>this.selectNextFieldMethod(e),selectPreviousField:()=>this.selectPreviousFieldMethod(e),activateField:()=>this.activateFieldMethod(e),getState:()=>this.getDocumentState(e),getFieldGroup:t=>this.getFieldGroup(t,e),getFieldSiblings:t=>this.getFieldSiblings(t,e),getFormValues:()=>this.getFormValuesMethod(e),getFormFields:()=>this.getFormFieldsMethod(e),setFormValues:t=>this.setFormValuesMethod(t,e),onStateChange:this.state$.forScope(e),onFieldValueChange:this.fieldValueChange$.forScope(e),onFormReady:this.formReady$.forScope(e)}}handleAnnotationEvent(e){switch(e.type){case"loaded":this.buildFieldGroupIndex(e.documentId),this.formReady$.emit(e.documentId,this.getFormFieldsMethod(e.documentId));break;case"create":case"delete":if(e.annotation.type!==t.PdfAnnotationSubtype.WIDGET)break;this.buildFieldGroupIndex(e.documentId);break;case"update":{if(!e.committed)break;const o=e.annotation;if(o.type!==t.PdfAnnotationSubtype.WIDGET)break;if(this.propagationInProgress.has(o.id)){this.propagationInProgress.delete(o.id);break}const n=e.patch;this.buildFieldGroupIndex(e.documentId),this.propagateFieldLevelChanges(e.documentId,o,n);break}}}propagateFieldLevelChanges(e,t,o){if(!this.annotation||!o.field)return;const n=o.field,i=this.getFieldSiblings(t.id,e);if(0===i.length)return;const a=[];for(const r of i)this.propagationInProgress.add(r.annotationId),a.push({pageIndex:r.pageIndex,id:r.annotationId,patch:{field:{...n}}});this.annotation.forDocument(e).updateAnnotations(a)}buildFieldGroupIndex(e){if(!this.annotation)return;const o=this.annotation.forDocument(e).getState();if(!o)return;const n=new Map,i=[];for(const[l,s]of Object.entries(o.pages)){const e=Number(l);for(const a of s){const r=o.byUid[a];if(!r||r.object.type!==t.PdfAnnotationSubtype.WIDGET)continue;const l=r.object,s={annotationId:a,pageIndex:e};i.push({entry:s,widget:l});const d=this.getFieldKey(l.field);if(!d)continue;const c=n.get(d)??[];c.push(s),n.set(d,c)}}this.fieldGroupIndex.set(e,n);const a=new Map;for(const{entry:t,widget:l}of i){const e=l.field.name.trim();if(!e)continue;const o=a.get(e)??[];o.push(t),a.set(e,o)}this.fieldNameIndex.set(e,a);const r=i.filter(({widget:e})=>!(e.field.flag&t.PDF_FORM_FIELD_FLAG.READONLY));this.orderedFieldIndex.set(e,r.map(({entry:e})=>e))}getDocumentState(e){const t=e??this.getActiveDocumentId();return this.state.documents[t]??{...u}}getDocIndex(e){let t=this.fieldGroupIndex.get(e);return t||(t=new Map,this.fieldGroupIndex.set(e,t)),t}getFieldKey(e){if("number"==typeof e.fieldObjectId&&e.fieldObjectId>0)return`field:${e.fieldObjectId}`;const t=e.name.trim();return t?`legacy:${e.type}:${t}`:null}resolveWidgetAnnotation(e,o){if(!this.annotation)return null;const n=this.annotation.forDocument(o).getState(),i=null==n?void 0:n.byUid[e];return i&&i.object.type===t.PdfAnnotationSubtype.WIDGET?i.object:null}getFieldGroup(e,t){const o=t??this.getActiveDocumentId(),n=this.resolveWidgetAnnotation(e,o);if(!n)return[];const i=this.getFieldKey(n.field);return i?this.getDocIndex(o).get(i)??[{annotationId:n.id,pageIndex:n.pageIndex}]:[{annotationId:n.id,pageIndex:n.pageIndex}]}getFieldSiblings(e,t){return this.getFieldGroup(e,t).filter(t=>t.annotationId!==e)}getFormValuesMethod(e){const t=e??this.getActiveDocumentId(),o=this.fieldNameIndex.get(t);if(!o)return{};const n={};for(const[i,a]of o){const e=this.resolveWidgetAnnotation(a[0].annotationId,t);e&&(n[i]=e.field.value)}return n}getFormFieldsMethod(e){const o=e??this.getActiveDocumentId(),n=this.fieldNameIndex.get(o);if(!n)return[];const i=[];for(const[a,r]of n){const e=this.resolveWidgetAnnotation(r[0].annotationId,o);e&&i.push({name:a,type:e.field.type,value:e.field.value,readOnly:!!(e.field.flag&t.PDF_FORM_FIELD_FLAG.READONLY),..."options"in e.field&&e.field.options?{options:e.field.options}:{}})}return i}setFormValuesMethod(e,o){const n=o??this.getActiveDocumentId(),i=this.fieldNameIndex.get(n);if(!i)return t.PdfTaskHelper.reject({code:t.PdfErrorCode.NotFound,message:"no form fields indexed for this document"});const a=Object.entries(e);if(0===a.length)return t.PdfTaskHelper.resolve(!0);const r=new t.Task;let l=a.length,s=!1;const d=()=>{l--,0!==l||s||r.resolve(!0)};for(const[c,u]of a){const e=i.get(c);if(!e||0===e.length){d();continue}let o=e[0],a=this.resolveWidgetAnnotation(o.annotationId,n);if(a){if(a.field.type===t.PDF_FORM_FIELD_TYPE.RADIOBUTTON||a.field.type===t.PDF_FORM_FIELD_TYPE.CHECKBOX)for(const t of e){const e=this.resolveWidgetAnnotation(t.annotationId,n);if(e&&e.exportValue===u){a=e,o=t;break}}this.setFormFieldValues(o.pageIndex,a,this.buildImportField(a,u),n).wait(()=>d(),e=>{return t=e.reason,void(s||(s=!0,r.reject(t)));var t})}else d()}return r}buildImportField(e,o){const n=e.field;if((n.type===t.PDF_FORM_FIELD_TYPE.COMBOBOX||n.type===t.PDF_FORM_FIELD_TYPE.LISTBOX)&&"options"in n)return{...n,value:o,options:n.options.map(e=>({...e,isSelected:e.label===o}))};if(n.type===t.PDF_FORM_FIELD_TYPE.CHECKBOX){const t="Off"===o?"Off":e.exportValue??"Yes";return{...n,value:t}}return{...n,value:o}}isToggleField(e){return e.type===t.PDF_FORM_FIELD_TYPE.CHECKBOX||e.type===t.PDF_FORM_FIELD_TYPE.RADIOBUTTON}shouldRegenerateWidgetAppearances(e){return!this.isToggleField(e)}getFieldBatchTarget(e){const o=[...e.values()];return o.find(e=>this.isToggleField(e.widget.field)&&t.isWidgetChecked(e.widget))??o[0]}async readFieldWidgets(e,t,o,n){const i=new Set(t.map(e=>e.pageIndex)),a=new Set(t.map(e=>e.annotationId)),r=new Map;for(const l of i){const i=e.pages.find(e=>e.index===l);if(!i)continue;const s=t.filter(e=>e.pageIndex===l).map(e=>e.annotationId);n&&await o.run(()=>this.engine.regenerateWidgetAppearances(e,i,s));const d=await o.run(()=>this.engine.getPageAnnoWidgets(e,i));for(const e of d)a.has(e.id)&&r.set(e.id,{widget:e,pageIndex:l})}return r}syncFieldBatch(e,t,o={}){if(this.annotation){for(const[n,{widget:i,pageIndex:a}]of t)this.annotation.syncAnnotationObject(n,i,e),this.annotation.invalidatePageAppearances(a,e),o.emitFieldValueChanges&&this.fieldValueChange$.emit(e,{documentId:e,pageIndex:a,annotationId:n,widget:i});this.buildFieldGroupIndex(e)}}resolveWidgetPage(e,t,o){const n=this.resolveWidgetAnnotation(e,t);if(!n)return null;const i=o.pages.find(e=>e.index===n.pageIndex);return i?{widget:n,page:i}:null}getPageFormAnnoWidgets(e,o){const n=this.getCoreDocumentOrThrow(o).document;if(!n)return t.PdfTaskHelper.reject({code:t.PdfErrorCode.DocNotOpen,message:"document is not open"});const i=n.pages.find(t=>t.index===e);return i?this.engine.getPageAnnoWidgets(n,i):t.PdfTaskHelper.reject({code:t.PdfErrorCode.NotFound,message:"page does not exist"})}setFormFieldValues(e,o,n,i){const a=i??this.getActiveDocumentId(),r=this.getCoreDocumentOrThrow(a).document;if(!r)return t.PdfTaskHelper.reject({code:t.PdfErrorCode.DocNotOpen,message:"document is not open"});const l=r.pages.find(t=>t.index===e);if(!l)return t.PdfTaskHelper.reject({code:t.PdfErrorCode.NotFound,message:"page does not exist"});const s=new t.Task,d=new t.TaskSequence(s);return d.execute(async()=>{const e=this.getFieldGroup(o.id,a),t=await this.readFieldWidgets(r,e,d,!1);await d.run(()=>this.engine.setFormFieldState(r,l,o,n));const i=await this.readFieldWidgets(r,e,d,this.shouldRegenerateWidgetAppearances(n));let c=!0;const u=async e=>{const t=this.getFieldBatchTarget(e);if(!t)return;const o=r.pages.find(e=>e.index===t.pageIndex);if(o&&(await new Promise(e=>{this.engine.setFormFieldState(r,o,t.widget,t.widget.field).wait(()=>e(),()=>e())}),this.shouldRegenerateWidgetAppearances(t.widget.field)))for(const n of new Set([...e.values()].map(e=>e.pageIndex))){const t=r.pages.find(e=>e.index===n);if(!t)continue;const o=[...e.entries()].filter(([,e])=>e.pageIndex===n).map(([e])=>e);await new Promise(e=>{this.engine.regenerateWidgetAppearances(r,t,o).wait(()=>e(),()=>e())})}},f={execute:()=>{const e=c;c=!1,e?this.syncFieldBatch(a,i,{emitFieldValueChanges:!0}):u(i).then(()=>this.syncFieldBatch(a,i,{emitFieldValueChanges:!0}))},undo:()=>{u(t).then(()=>this.syncFieldBatch(a,t,{emitFieldValueChanges:!0}))}};this.history?this.history.forDocument(a).register(f,this.FORM_HISTORY_TOPIC):f.execute(),s.resolve(!0)},e=>({code:t.PdfErrorCode.Unknown,message:String(e)})),s}findConflictingFieldGroups(e,o,n){const i=new Map;if(!this.annotation)return i;const a=this.annotation.forDocument(n).getState();if(!a)return i;const r=(()=>{const e=this.resolveWidgetAnnotation(o,n);return e?this.getFieldKey(e.field):null})();for(const[l,s]of Object.entries(a.pages)){const o=Number(l);for(const n of s){const l=a.byUid[n];if(!l||l.object.type!==t.PdfAnnotationSubtype.WIDGET)continue;const s=l.object;if(s.field.name.trim()!==e)continue;const d=this.getFieldKey(s.field);d&&d!==r&&(i.has(d)||i.set(d,{entries:[],widget:s}),i.get(d).entries.push({annotationId:n,pageIndex:o}))}}return i}renameFieldMethod(e,o,n){const i=n??this.getActiveDocumentId(),a=o.trim();if(!a)return t.PdfTaskHelper.reject({code:t.PdfErrorCode.Unknown,message:"Field name must not be empty."});const r=this.getCoreDocumentOrThrow(i).document;if(!r)return t.PdfTaskHelper.reject({code:t.PdfErrorCode.DocNotOpen,message:"document is not open"});const l=this.resolveWidgetPage(e,i,r);if(!l)return t.PdfTaskHelper.reject({code:t.PdfErrorCode.NotFound,message:"widget annotation not found"});if(l.widget.field.name.trim()===a)return t.PdfTaskHelper.resolve({outcome:"no-op"});const s=this.findConflictingFieldGroups(a,e,i);if(s.size>0){if(s.size>1)return t.PdfTaskHelper.reject({code:t.PdfErrorCode.Unknown,message:"That field name is used by multiple fields. Choose a unique name."});const[,e]=[...s.entries()][0];return e.widget.field.type!==l.widget.field.type?t.PdfTaskHelper.reject({code:t.PdfErrorCode.Unknown,message:"That field name is already used by a different widget type."}):t.PdfTaskHelper.resolve({outcome:"conflict",targetAnnotationId:e.entries[0].annotationId,fieldName:a})}const d=new t.Task,c=new t.TaskSequence(d);return c.execute(async()=>{const t=this.getFieldGroup(e,i);await c.run(()=>this.engine.renameWidgetField(r,l.page,l.widget,a));const o=await this.readFieldWidgets(r,t,c,!1);this.syncFieldBatch(i,o),d.resolve({outcome:"renamed"})},e=>({code:t.PdfErrorCode.Unknown,message:String(e)})),d}shareFieldMethod(e,o,n){const i=n??this.getActiveDocumentId();if(e===o)return t.PdfTaskHelper.resolve(!0);const a=this.getCoreDocumentOrThrow(i).document;if(!a)return t.PdfTaskHelper.reject({code:t.PdfErrorCode.DocNotOpen,message:"document is not open"});const r=this.resolveWidgetPage(e,i,a),l=this.resolveWidgetPage(o,i,a);if(!r||!l)return t.PdfTaskHelper.reject({code:t.PdfErrorCode.NotFound,message:"widget annotation not found"});if(r.widget.field.type!==l.widget.field.type)return t.PdfTaskHelper.reject({code:t.PdfErrorCode.Unknown,message:"cannot share fields with different widget types"});if(r.widget.field.fieldObjectId&&l.widget.field.fieldObjectId&&r.widget.field.fieldObjectId===l.widget.field.fieldObjectId)return t.PdfTaskHelper.resolve(!0);const s=new Map;for(const t of this.getFieldGroup(e,i))s.set(t.annotationId,t);for(const t of this.getFieldGroup(o,i))s.set(t.annotationId,t);const d=[...s.values()],c=new t.Task,u=new t.TaskSequence(c);return u.execute(async()=>{await u.run(()=>this.engine.shareWidgetField(a,r.page,r.widget,l.page,l.widget));const e=await this.readFieldWidgets(a,d,u,this.shouldRegenerateWidgetAppearances(l.widget.field));this.syncFieldBatch(i,e),c.resolve(!0)},e=>({code:t.PdfErrorCode.Unknown,message:String(e)})),c}selectFieldMethod(e,t){const o=t??this.getActiveDocumentId();this.dispatch(c(o,e))}deselectFieldMethod(e){const t=e??this.getActiveDocumentId();this.dispatch(function(e){return{type:d,payload:e}}(t))}getSelectedFieldId(e){return this.getDocumentState(e).selectedFieldId}selectNextFieldMethod(e){const t=e??this.getActiveDocumentId(),o=this.orderedFieldIndex.get(t);if(!o||0===o.length)return;const n=this.getSelectedFieldId(t);let i=0;if(n){const e=o.findIndex(e=>e.annotationId===n);i=e>=0?(e+1)%o.length:0}const a=o[i];this.dispatch(c(t,a.annotationId))}selectPreviousFieldMethod(e){const t=e??this.getActiveDocumentId(),o=this.orderedFieldIndex.get(t);if(!o||0===o.length)return;const n=this.getSelectedFieldId(t);let i=o.length-1;if(n){const e=o.findIndex(e=>e.annotationId===n);i=e>=0?(e-1+o.length)%o.length:o.length-1}const a=o[i];this.dispatch(c(t,a.annotationId))}activateFieldMethod(e){const o=e??this.getActiveDocumentId(),n=this.getSelectedFieldId(o);if(!n)return;const i=this.resolveWidgetAnnotation(n,o);if(!i)return;const a=i.field;if(a.type===t.PDF_FORM_FIELD_TYPE.CHECKBOX){const e=t.isWidgetChecked(i)?"Off":i.exportValue??"Yes";this.setFormFieldValues(i.pageIndex,i,{...a,value:e},o)}else a.type===t.PDF_FORM_FIELD_TYPE.RADIOBUTTON&&!t.isWidgetChecked(i)&&i.exportValue&&this.setFormFieldValues(i.pageIndex,i,{...a,value:i.exportValue},o)}renderWidget(e,o){if(!this.annotation)return t.PdfTaskHelper.reject({code:t.PdfErrorCode.NotFound,message:"annotation plugin not found"});const n=o??this.getActiveDocumentId();return this.annotation.forDocument(n).renderAnnotation(e)}async destroy(){this.state$.clear(),this.fieldValueChange$.clear(),this.formReady$.clear(),super.destroy()}};x.id="form";let T=x;const S={manifest:a,create:(e,t)=>new T(i,e,t),reducer:(e=f,t)=>{switch(t.type){case r:return{...e,documents:{...e.documents,[t.payload.documentId]:t.payload.state}};case l:{const o=t.payload,{[o]:n,...i}=e.documents;return{...e,documents:i}}case s:{const{documentId:o,annotationId:n}=t.payload,i=e.documents[o];return i?{...e,documents:{...e.documents,[o]:{...i,selectedFieldId:n}}}:e}case d:{const o=t.payload,n=e.documents[o];return n?{...e,documents:{...e.documents,[o]:{...n,selectedFieldId:null}}}:e}default:return e}},initialState:f};exports.FORM_PLUGIN_ID=i,exports.FormPlugin=T,exports.FormPluginPackage=S,exports.formCheckboxTool=I,exports.formComboboxTool=D,exports.formListboxTool=b,exports.formRadioButtonTool=P,exports.formTextFieldTool=y,exports.formTools=v,exports.initialDocumentState=u,exports.initialState=f,exports.manifest=a;
-//# sourceMappingURL=index.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _embedpdf_core = require("@embedpdf/core");
+let _embedpdf_plugin_annotation = require("@embedpdf/plugin-annotation");
+let _embedpdf_plugin_annotation_internal = require("@embedpdf/plugin-annotation/internal");
+let _embedpdf_plugin_interaction = require("@embedpdf/plugin-interaction");
+let _embedpdf_core_acrojs = require("@embedpdf/core-acrojs");
+//#region src/core/model.ts
+const fieldKeyOf = (field) => field.fieldObjectNumber > 0 ? `obj:${field.fieldObjectNumber}` : `fqn:${field.name}`;
+const initialModel = () => ({
+	snapshot: null,
+	byKey: {},
+	byWidget: {},
+	writing: {},
+	geom: {},
+	seq: 0
+});
+function index(snapshot) {
+	const byKey = {};
+	const byWidget = {};
+	snapshot.fields.forEach((field, i) => {
+		byKey[fieldKeyOf(field)] = i;
+		for (const w of field.widgets) if (w.annotObjectNumber > 0) byWidget[w.annotObjectNumber] = i;
+	});
+	return {
+		byKey,
+		byWidget
+	};
+}
+function update(model, msg) {
+	switch (msg.t) {
+		case "snapshot": return {
+			...model,
+			snapshot: msg.snapshot,
+			...index(msg.snapshot),
+			writing: {},
+			seq: model.seq + 1
+		};
+		case "writeStart": return {
+			...model,
+			writing: {
+				...model.writing,
+				[msg.key]: true
+			},
+			seq: model.seq + 1
+		};
+		case "writeDone": {
+			if (!model.snapshot) return model;
+			const i = model.byKey[msg.key];
+			if (i === void 0) return model;
+			const fields = model.snapshot.fields.slice();
+			fields[i] = msg.field;
+			const { [msg.key]: _done, ...writing } = model.writing;
+			const snapshot = {
+				...model.snapshot,
+				fields
+			};
+			return {
+				...model,
+				snapshot,
+				...index(snapshot),
+				writing,
+				seq: model.seq + 1
+			};
+		}
+		case "writeFailed": {
+			const { [msg.key]: _failed, ...writing } = model.writing;
+			return {
+				...model,
+				writing,
+				seq: model.seq + 1
+			};
+		}
+		case "pageGeom": return {
+			...model,
+			geom: {
+				...model.geom,
+				[msg.pageObjectNumber]: msg.boxes
+			},
+			seq: model.seq + 1
+		};
+		case "clearGeom": {
+			if (msg.pageObjectNumber === void 0) return {
+				...model,
+				geom: {},
+				seq: model.seq + 1
+			};
+			const geom = { ...model.geom };
+			delete geom[msg.pageObjectNumber];
+			return {
+				...model,
+				geom,
+				seq: model.seq + 1
+			};
+		}
+	}
+}
+const fieldByKey = (model, key) => {
+	const i = model.byKey[key];
+	return i === void 0 ? null : model.snapshot?.fields[i] ?? null;
+};
+const fieldForWidget = (model, annotObjectNumber) => {
+	const i = model.byWidget[annotObjectNumber];
+	return i === void 0 ? null : model.snapshot?.fields[i] ?? null;
+};
+//#endregion
+//#region src/core/fill-items.ts
+const ZERO_BOX = {
+	x: 0,
+	y: 0,
+	width: 0,
+	height: 0
+};
+/**
+* Project ONE widget of a field into a fill control. `box` is supplied by the
+* caller: the page projection reads the model's widget geometry; a consumer
+* that already owns a live box (the annotation plane's RenderItem) passes it —
+* or nothing, when only the semantics matter. Null for families with no fill
+* control (signature/unknown: rendered by the annotation plane only).
+*/
+function projectWidget(model, field, annotObjectNumber, box = ZERO_BOX) {
+	const key = fieldKeyOf(field);
+	const base = {
+		key,
+		annotObjectNumber,
+		box,
+		disabled: field.flags.readOnly || model.writing[key] === true,
+		label: field.alternateName ?? field.name
+	};
+	switch (field.family) {
+		case "text": return {
+			...base,
+			control: "text",
+			value: field.value,
+			multiline: field.multiline,
+			password: field.password,
+			maxLength: field.maxLength,
+			comb: field.comb
+		};
+		case "checkbox": {
+			const toggle = field.widgets.find((w) => w.annotObjectNumber === annotObjectNumber);
+			return {
+				...base,
+				control: "toggle",
+				kind: "checkbox",
+				checked: field.checked,
+				onState: toggle && "onState" in toggle ? toggle.onState : "Yes"
+			};
+		}
+		case "radio": {
+			const toggle = field.widgets.find((w) => w.annotObjectNumber === annotObjectNumber);
+			return {
+				...base,
+				control: "toggle",
+				kind: "radio",
+				checked: toggle && "checked" in toggle ? toggle.checked : false,
+				onState: toggle && "onState" in toggle ? toggle.onState : ""
+			};
+		}
+		case "combobox": return {
+			...base,
+			control: "choice",
+			kind: "combo",
+			edit: field.edit,
+			multi: false,
+			options: field.options,
+			selected: field.value === "" ? [] : [field.value]
+		};
+		case "listbox": return {
+			...base,
+			control: "choice",
+			kind: "list",
+			edit: false,
+			multi: field.multiSelect,
+			options: field.options,
+			selected: field.selectedValues
+		};
+		case "pushbutton": return {
+			...base,
+			control: "button"
+		};
+		default: return null;
+	}
+}
+/**
+* Project one page's widgets into fill controls. Widgets whose geometry has
+* not arrived yet (or that are direct objects with no join key) are skipped —
+* the shell re-runs the projection when `pageGeom` lands.
+*/
+function fillItems(model, pageObjectNumber) {
+	const snapshot = model.snapshot;
+	const geom = model.geom[pageObjectNumber];
+	if (!snapshot || !geom) return [];
+	const items = [];
+	for (const field of snapshot.fields) for (const widget of field.widgets) {
+		if (widget.pageObjectNumber !== pageObjectNumber) continue;
+		const box = geom[widget.annotObjectNumber];
+		if (!box) continue;
+		const item = projectWidget(model, field, widget.annotObjectNumber, box);
+		if (item) items.push(item);
+	}
+	return items;
+}
+/**
+* Project a SINGLE widget by its annotation object number — the join the
+* annotation-plane render layer uses (it owns a live box already, so the
+* model's cached geometry is used only when it happens to be loaded; the
+* item's semantics never depend on it). Null while the snapshot hasn't
+* landed, or for families with no fill control.
+*/
+function fillItemForWidget(model, annotObjectNumber) {
+	const field = fieldForWidget(model, annotObjectNumber);
+	if (!field) return null;
+	const widget = field.widgets.find((w) => w.annotObjectNumber === annotObjectNumber);
+	if (!widget) return null;
+	const box = model.geom[widget.pageObjectNumber]?.[annotObjectNumber];
+	return projectWidget(model, field, annotObjectNumber, box);
+}
+//#endregion
+//#region src/mutationQueue.ts
+/** Small promise-tail queue: failures never poison later mutations. */
+function createSerialMutationQueue() {
+	let tail = Promise.resolve();
+	return (operation) => {
+		const result = tail.then(operation, operation);
+		tail = result.then(() => void 0, () => void 0);
+		return result;
+	};
+}
+//#endregion
+//#region src/scripting.ts
+const refKey = (ref) => ref.kind === "objectNumber" ? `obj:${ref.fieldObjectNumber}` : `fqn:${ref.name}`;
+const sameRef = (left, right) => refKey(left) === refKey(right);
+const cloneValue = (value) => Array.isArray(value) ? [...value] : value;
+const sameValue = (left, right) => Array.isArray(left) && Array.isArray(right) ? left.length === right.length && left.every((value, index) => value === right[index]) : left === right;
+function cloneFields(fields) {
+	return fields.map((field) => ({
+		...field,
+		ref: { ...field.ref },
+		value: cloneValue(field.value),
+		defaultValue: cloneValue(field.defaultValue),
+		...field.options ? { options: field.options.map((option) => ({ ...option })) } : {}
+	}));
+}
+function fieldByRef(fields, ref) {
+	return fields.find((field) => sameRef(field.ref, ref));
+}
+function snapshotField(snapshot, ref) {
+	return snapshot.fields.find((field) => sameRef(field.ref, ref));
+}
+function scriptValueFromFormValue(field, value) {
+	if (field.family === "text" && value.type === "text") return value.value;
+	if ((field.family === "checkbox" || field.family === "radio") && value.type === "toggle") return value.state ?? "Off";
+	if (field.family === "combobox" && value.type === "choice") return value.values[0] ?? "";
+	if (field.family === "listbox" && value.type === "choice") return [...value.values];
+	throw new Error(`Form value type '${value.type}' does not match field family '${field.family}'`);
+}
+function formValueFromScriptValue(field) {
+	switch (field.family) {
+		case "text": return {
+			type: "text",
+			value: String(field.value ?? "")
+		};
+		case "checkbox":
+		case "radio": return {
+			type: "toggle",
+			state: field.value === null || field.value === void 0 || String(field.value) === "Off" ? null : String(field.value)
+		};
+		case "combobox": return {
+			type: "choice",
+			values: Array.isArray(field.value) ? field.value.slice(0, 1) : [String(field.value ?? "")]
+		};
+		case "listbox": return {
+			type: "choice",
+			values: Array.isArray(field.value) ? [...field.value] : [String(field.value ?? "")]
+		};
+		default: return null;
+	}
+}
+function applyEffects(overlay, effects) {
+	for (const effect of effects) {
+		if (effect.kind === "reset") {
+			for (const ref of effect.refs) {
+				const field = fieldByRef(overlay.fields, ref);
+				if (!field) continue;
+				field.value = cloneValue(field.defaultValue);
+				overlay.resetKeys.add(refKey(ref));
+			}
+			continue;
+		}
+		const field = fieldByRef(overlay.fields, effect.ref);
+		if (!field) continue;
+		const key = refKey(effect.ref);
+		if (effect.kind === "setValue") {
+			field.value = scriptValueFromFormValue(field, effect.value);
+			overlay.resetKeys.delete(key);
+		} else if (effect.kind === "setDisplay") field.display = effect.display;
+		else overlay.appearances.set(key, {
+			ref: effect.ref,
+			text: effect.text
+		});
+	}
+}
+function canonicalEffects(overlay) {
+	const effects = [];
+	const resets = [];
+	for (const field of overlay.fields) {
+		const original = fieldByRef(overlay.original, field.ref);
+		if (!original) continue;
+		if (!sameValue(original.value, field.value)) {
+			const key = refKey(field.ref);
+			if (overlay.resetKeys.has(key) && sameValue(field.value, field.defaultValue)) resets.push(field.ref);
+			else {
+				const value = formValueFromScriptValue(field);
+				if (value) effects.push({
+					kind: "setValue",
+					ref: field.ref,
+					value
+				});
+			}
+		}
+		if (original.display !== field.display) effects.push({
+			kind: "setDisplay",
+			ref: field.ref,
+			display: field.display
+		});
+	}
+	if (resets.length > 0) effects.unshift({
+		kind: "reset",
+		refs: resets
+	});
+	effects.push(...Array.from(overlay.appearances.values(), ({ ref, text }) => ({
+		kind: "setAppearanceText",
+		ref,
+		text
+	})));
+	return effects;
+}
+function scriptError(message) {
+	return {
+		kind: "invalid-output",
+		message
+	};
+}
+function utf8Length(value) {
+	let length = 0;
+	for (let index = 0; index < value.length; index += 1) {
+		const code = value.charCodeAt(index);
+		if (code < 128) length += 1;
+		else if (code < 2048) length += 2;
+		else if (code >= 55296 && code <= 56319 && index + 1 < value.length) {
+			length += 4;
+			index += 1;
+		} else length += 3;
+	}
+	return length;
+}
+function seedFrom(documentId, sequence) {
+	let hash = 2166136261;
+	for (const char of `${documentId}:${sequence}`) {
+		hash ^= char.charCodeAt(0);
+		hash = Math.imul(hash, 16777619);
+	}
+	return hash >>> 0;
+}
+function resolvedIdentity(doc, config) {
+	const claims = doc.security.identity;
+	const supplied = typeof config.identity === "function" ? config.identity() : config.identity ?? {};
+	return {
+		name: supplied.name ?? claims?.display_name ?? claims?.user_id ?? "",
+		loginName: supplied.loginName ?? claims?.user_id ?? "",
+		corporation: supplied.corporation ?? claims?.group_id ?? "",
+		email: supplied.email ?? ""
+	};
+}
+function pageNumberFor(meta, field) {
+	const pon = field.widgets.find((widget) => widget.pageObjectNumber > 0)?.pageObjectNumber;
+	if (!meta || pon === void 0) return 0;
+	const index = meta.pages.findIndex((page) => page.pageObjectNumber === pon);
+	return Math.max(0, index);
+}
+function statusFromEffects(result) {
+	if (result.results.some(({ status }) => status === "failed" || status === "skipped")) return "failed";
+	if (result.results.some(({ status }) => status === "rejected")) return "failed";
+	return result.results.some(({ status }) => status === "applied") ? "applied" : "unchanged";
+}
+var FormScriptingController = class {
+	constructor(options) {
+		this.options = options;
+		this.sandboxPromise = null;
+		this.booted = false;
+		this.disposed = false;
+		this.sequence = 0;
+	}
+	dispose() {
+		if (this.disposed) return;
+		this.disposed = true;
+		this.sandboxPromise?.then((sandbox) => sandbox.dispose()).catch(() => void 0);
+	}
+	async commit(snapshot, ref, proposed) {
+		return this.transact(snapshot, ref, proposed);
+	}
+	/** Execute one originating widget's activation action (`/A`, including `/Next`). */
+	async activate(snapshot, ref, action) {
+		return this.transact(snapshot, ref, void 0, action);
+	}
+	/** Run lazy document boot plus the `/CO` chain without a user field change. */
+	async recalculate(snapshot) {
+		const target = snapshot.calculationOrder.find((ref) => ref !== null && snapshotField(snapshot, ref) !== void 0) ?? snapshot.fields[0]?.ref;
+		if (!target) return {
+			status: "unchanged",
+			scripted: true,
+			effectsResult: null,
+			uiEffects: [],
+			diagnostics: []
+		};
+		return this.transact(snapshot, target);
+	}
+	async transact(snapshot, ref, proposed, activation) {
+		if (this.disposed) throw new Error("Form scripting controller is disposed");
+		const target = snapshotField(snapshot, ref);
+		if (!target) return this.failed([], [], scriptError(`Form field '${refKey(ref)}' no longer exists`));
+		const original = (0, _embedpdf_core_acrojs.scriptFieldsFromSnapshot)(snapshot);
+		const overlay = {
+			original,
+			fields: cloneFields(original),
+			resetKeys: /* @__PURE__ */ new Set(),
+			appearances: /* @__PURE__ */ new Map()
+		};
+		const targetInput = fieldByRef(overlay.fields, ref);
+		if (!targetInput) return this.failed([], [], scriptError(`Form field '${refKey(ref)}' has no script view`));
+		const hasProposedValue = proposed !== void 0;
+		let proposedValue = cloneValue(targetInput.value);
+		if (proposed) try {
+			proposedValue = scriptValueFromFormValue(targetInput, proposed);
+		} catch (error) {
+			return this.failed([], [], scriptError(error instanceof Error ? error.message : String(error)));
+		}
+		const uiEffects = [];
+		const diagnostics = [];
+		const meta = this.options.document();
+		const nowMs = this.options.config.now?.() ?? Date.now();
+		const inputBase = {
+			document: {
+				id: this.options.doc.id,
+				fileName: this.options.config.fileName?.() ?? meta?.name ?? this.options.doc.id,
+				pageCount: meta?.pageCount ?? 0,
+				pageNumber: pageNumberFor(meta, target)
+			},
+			identity: resolvedIdentity(this.options.doc, this.options.config),
+			environment: {
+				nowMs,
+				utcOffsetMinutes: this.options.config.utcOffsetMinutes?.() ?? -new Date(nowMs).getTimezoneOffset(),
+				randomSeed: this.options.config.randomSeed?.() ?? seedFrom(this.options.doc.id, this.sequence++)
+			}
+		};
+		const budget = this.options.config.budget ?? _embedpdf_core_acrojs.DEFAULT_SCRIPT_BUDGET;
+		let executionMs = 0;
+		let aggregateOutputSize = 0;
+		const consume = (output, phase) => {
+			aggregateOutputSize += utf8Length(JSON.stringify(output));
+			uiEffects.push(...output.uiEffects.map((effect) => ({
+				...effect,
+				phase
+			})));
+			diagnostics.push(...output.diagnostics);
+			if (aggregateOutputSize > budget.maxOutputBytes) return {
+				kind: "budget",
+				message: `Form script transaction output exceeded ${budget.maxOutputBytes} bytes`
+			};
+			return output.error ?? null;
+		};
+		const remainingBudget = () => {
+			const remaining = budget.maxExecutionMs - executionMs;
+			return remaining <= 0 ? null : {
+				...budget,
+				maxExecutionMs: remaining
+			};
+		};
+		const run = async (kind, source, input) => {
+			const remaining = remainingBudget();
+			if (!remaining) return { error: {
+				kind: "budget",
+				message: "Form script transaction timed out"
+			} };
+			let output;
+			try {
+				const sandbox = await this.sandbox();
+				const startedAt = Date.now();
+				output = kind === "boot" ? sandbox.boot(source, input, remaining) : sandbox.run(source, input, remaining);
+				executionMs += Date.now() - startedAt;
+			} catch (error) {
+				return { error: scriptError(error instanceof Error ? error.message : String(error)) };
+			}
+			const error = consume(output, kind === "boot" ? "boot" : "user");
+			return error ? { error } : { output };
+		};
+		if (!this.booted) {
+			this.booted = true;
+			let sources = [];
+			let bootError = null;
+			try {
+				sources = (this.options.doc.actions ? await this.options.doc.actions.read() : null)?.nameTreeScripts.map(({ action }) => (0, _embedpdf_core_acrojs.javaScriptProgramFromActionTree)(action)) ?? [];
+			} catch (error) {
+				bootError = scriptError(error instanceof Error ? error.message : String(error));
+			}
+			if (!bootError && sources.length > 0) {
+				const boot = await run("boot", sources, {
+					...inputBase,
+					fields: overlay.fields,
+					event: { kind: "name-tree-boot" }
+				});
+				if (boot.error) bootError = boot.error;
+				else applyEffects(overlay, boot.output.formEffects);
+			}
+			if (bootError) diagnostics.push({
+				code: "script-error",
+				message: `Document boot script failed (continuing without it): ${bootError.message}`
+			});
+		}
+		const bootEffects = canonicalEffects(overlay);
+		if (activation) {
+			let program;
+			try {
+				program = (0, _embedpdf_core_acrojs.javaScriptProgramFromActionTree)(activation);
+			} catch (error) {
+				return this.failed(uiEffects, diagnostics, scriptError(error instanceof Error ? error.message : String(error)));
+			}
+			if (program) {
+				const activated = await run("run", program, {
+					...inputBase,
+					fields: overlay.fields,
+					event: {
+						kind: "widget-activate",
+						target: ref,
+						source: ref,
+						value: targetInput.value
+					}
+				});
+				if (activated.error) return this.failed(uiEffects, diagnostics, activated.error);
+				applyEffects(overlay, activated.output.formEffects);
+			}
+		}
+		if (!activation && hasProposedValue && target.actions?.keystroke && target.family === "text") {
+			let program;
+			try {
+				program = (0, _embedpdf_core_acrojs.javaScriptProgramFromActionTree)(target.actions.keystroke);
+			} catch (error) {
+				return this.failed(uiEffects, diagnostics, scriptError(error instanceof Error ? error.message : String(error)));
+			}
+			if (program) {
+				const oldValue = String(targetInput.value ?? "");
+				const key = await run("run", program, {
+					...inputBase,
+					fields: overlay.fields,
+					event: {
+						kind: "field-keystroke",
+						target: ref,
+						source: ref,
+						value: oldValue,
+						change: String(proposedValue ?? ""),
+						selStart: 0,
+						selEnd: oldValue.length,
+						willCommit: true
+					}
+				});
+				if (key.error) return this.failed(uiEffects, diagnostics, key.error);
+				if (!key.output.event.rc) return this.finishRejected(bootEffects, uiEffects, diagnostics);
+				applyEffects(overlay, key.output.formEffects);
+				const event = key.output.event;
+				const base = String(event.value ?? "");
+				proposedValue = base.slice(0, event.selStart) + event.change + base.slice(Math.max(event.selStart, event.selEnd));
+			}
+		}
+		if (!activation && hasProposedValue) {
+			targetInput.value = cloneValue(proposedValue);
+			overlay.resetKeys.delete(refKey(ref));
+		}
+		if (!activation && hasProposedValue && target.actions?.validate) {
+			let program;
+			try {
+				program = (0, _embedpdf_core_acrojs.javaScriptProgramFromActionTree)(target.actions.validate);
+			} catch (error) {
+				return this.failed(uiEffects, diagnostics, scriptError(error instanceof Error ? error.message : String(error)));
+			}
+			if (program) {
+				const validation = await run("run", program, {
+					...inputBase,
+					fields: overlay.fields,
+					event: {
+						kind: "field-validate",
+						target: ref,
+						source: ref,
+						value: proposedValue,
+						willCommit: true
+					}
+				});
+				if (validation.error) return this.failed(uiEffects, diagnostics, validation.error);
+				if (!validation.output.event.rc) return this.finishRejected(bootEffects, uiEffects, diagnostics);
+				targetInput.value = cloneValue(validation.output.event.value);
+				applyEffects(overlay, validation.output.formEffects);
+			}
+		}
+		const formatRefs = !activation && hasProposedValue ? [ref] : [];
+		for (const calculationRef of activation ? [] : snapshot.calculationOrder) {
+			if (!calculationRef) continue;
+			const calculated = snapshotField(snapshot, calculationRef);
+			const tree = calculated?.actions?.calculate;
+			if (!calculated || !tree) continue;
+			let program;
+			try {
+				program = (0, _embedpdf_core_acrojs.javaScriptProgramFromActionTree)(tree);
+			} catch (error) {
+				return this.failed(uiEffects, diagnostics, scriptError(error instanceof Error ? error.message : String(error)));
+			}
+			const calculatedInput = fieldByRef(overlay.fields, calculationRef);
+			if (program && calculatedInput) {
+				const calculation = await run("run", program, {
+					...inputBase,
+					fields: overlay.fields,
+					event: {
+						kind: "field-calculate",
+						target: calculationRef,
+						...hasProposedValue ? { source: ref } : {},
+						value: calculatedInput.value
+					}
+				});
+				if (calculation.error) return this.failed(uiEffects, diagnostics, calculation.error);
+				applyEffects(overlay, calculation.output.formEffects);
+			}
+			if (!formatRefs.some((candidate) => sameRef(candidate, calculationRef))) formatRefs.push(calculationRef);
+		}
+		for (const formatRef of formatRefs) {
+			const field = snapshotField(snapshot, formatRef);
+			const tree = field?.actions?.format;
+			const overlayField = fieldByRef(overlay.fields, formatRef);
+			if (!field || !tree || !overlayField) continue;
+			let program;
+			try {
+				program = (0, _embedpdf_core_acrojs.javaScriptProgramFromActionTree)(tree);
+			} catch (error) {
+				return this.failed(uiEffects, diagnostics, scriptError(error instanceof Error ? error.message : String(error)));
+			}
+			if (!program) continue;
+			const format = await run("run", program, {
+				...inputBase,
+				fields: overlay.fields,
+				event: {
+					kind: "field-format",
+					target: formatRef,
+					...hasProposedValue ? { source: ref } : {},
+					value: overlayField.value
+				}
+			});
+			if (format.error) return this.failed(uiEffects, diagnostics, format.error);
+			applyEffects(overlay, format.output.formEffects);
+		}
+		const effects = canonicalEffects(overlay);
+		if (effects.length + uiEffects.length > budget.maxEffects) return this.failed(uiEffects, diagnostics, {
+			kind: "budget",
+			message: `Form script transaction exceeded ${budget.maxEffects} effects`
+		});
+		if (effects.length === 0) return {
+			status: "unchanged",
+			scripted: true,
+			effectsResult: null,
+			uiEffects,
+			diagnostics
+		};
+		if (!this.options.doc.forms.applyEffects) return this.failed(uiEffects, diagnostics, scriptError("This engine does not support batched form effects"));
+		const effectsResult = await this.options.doc.forms.applyEffects(effects);
+		const status = statusFromEffects(effectsResult);
+		return {
+			status,
+			scripted: true,
+			effectsResult,
+			uiEffects,
+			diagnostics,
+			...status === "failed" ? { error: scriptError("One or more native form effects failed") } : {}
+		};
+	}
+	async sandbox() {
+		this.sandboxPromise ?? (this.sandboxPromise = this.options.sandboxFactory().then((sandbox) => {
+			if (this.disposed) sandbox.dispose();
+			return sandbox;
+		}));
+		return this.sandboxPromise;
+	}
+	failed(uiEffects, diagnostics, error) {
+		return {
+			status: "failed",
+			scripted: true,
+			effectsResult: null,
+			uiEffects,
+			diagnostics,
+			error
+		};
+	}
+	async finishRejected(bootEffects, uiEffects, diagnostics) {
+		if (bootEffects.length === 0) return {
+			status: "rejected",
+			scripted: true,
+			effectsResult: null,
+			uiEffects,
+			diagnostics
+		};
+		if (!this.options.doc.forms.applyEffects) return this.failed(uiEffects, diagnostics, scriptError("Batched form effects are unavailable"));
+		const effectsResult = await this.options.doc.forms.applyEffects(bootEffects);
+		if (statusFromEffects(effectsResult) === "failed") return this.failed(uiEffects, diagnostics, scriptError("A name-tree boot effect failed"));
+		return {
+			status: "rejected",
+			scripted: true,
+			effectsResult,
+			uiEffects,
+			diagnostics
+		};
+	}
+};
+function createFormScriptingController(options) {
+	return new FormScriptingController(options);
+}
+//#endregion
+//#region src/capability.ts
+/** PDF user-space rect (y-up) → content-space box (y-down, crop-relative). */
+const toBox = (rect, crop) => ({
+	x: rect.left - crop.left,
+	y: crop.top - rect.top,
+	width: rect.right - rect.left,
+	height: rect.top - rect.bottom
+});
+const sameAnnotationRef = (left, right) => {
+	if (left.kind !== right.kind || left.pageObjectNumber !== right.pageObjectNumber) return false;
+	if (left.kind === "objectNumber" && right.kind === "objectNumber") return left.annotObjectNumber === right.annotObjectNumber;
+	if (left.kind === "nm" && right.kind === "nm") return left.nm === right.nm;
+	return left.kind === "index" && right.kind === "index" && left.index === right.index && left.revision === right.revision;
+};
+/**
+* The form shell. Pure `update` runs here; the resulting model is dispatched
+* to the store; engine calls happen around it. Every read the frameworks do
+* goes through memoized projections keyed on `model.seq`.
+*/
+function createFormCapability(ctx, options = {}) {
+	const model = () => ctx.getState().model;
+	const apply = (msg) => {
+		ctx.dispatch({
+			type: "SET_MODEL",
+			model: update(model(), msg)
+		});
+	};
+	const refKeyOf = (key) => {
+		if (key.startsWith("obj:")) return {
+			kind: "objectNumber",
+			fieldObjectNumber: Number(key.slice(4))
+		};
+		return {
+			kind: "fqn",
+			name: key.slice(4)
+		};
+	};
+	const enqueueMutation = createSerialMutationQueue();
+	const scripting = options.scripting?.enabled && ctx.doc ? createFormScriptingController({
+		doc: ctx.doc,
+		document: () => ctx.document(),
+		config: options.scripting,
+		sandboxFactory: options.scripting.sandboxFactory ?? (() => import("@embedpdf/core-js-sandbox").then(({ createQuickJsSandbox }) => createQuickJsSandbox()))
+	}) : null;
+	if (scripting) ctx.cleanup(() => scripting.dispose());
+	let uiEffectProvider = null;
+	const surfaceScriptingResult = (result) => {
+		const observe = (callback) => {
+			if (!callback) return;
+			try {
+				callback();
+			} catch (error) {
+				globalThis.console?.error("[form] scripting observer failed:", error);
+			}
+		};
+		for (const effect of result.uiEffects) {
+			observe(options.scripting?.onUiEffect ? () => options.scripting.onUiEffect(effect) : void 0);
+			observe(uiEffectProvider ? () => uiEffectProvider(effect) : void 0);
+		}
+		for (const diagnostic of result.diagnostics) observe(options.scripting?.onDiagnostic ? () => options.scripting.onDiagnostic(diagnostic) : void 0);
+		if (result.error) observe(options.scripting?.onError ? () => options.scripting.onError(result.error) : void 0);
+	};
+	let refreshPromise = null;
+	const refresh = async (force = false) => {
+		const doc = ctx.doc;
+		if (!doc) return;
+		if (refreshPromise) {
+			await refreshPromise;
+			if (!force) return;
+		}
+		refreshPromise = doc.forms.list().then((snapshot) => apply({
+			t: "snapshot",
+			snapshot
+		})).finally(() => {
+			refreshPromise = null;
+		});
+		return refreshPromise;
+	};
+	const geomLoading = /* @__PURE__ */ new Set();
+	const ensureGeom = (pon) => {
+		const doc = ctx.doc;
+		if (!doc || geomLoading.has(pon) || model().geom[pon]) return;
+		const crop = ctx.document()?.pages.find((p) => p.pageObjectNumber === pon)?.boxes.crop;
+		if (!crop) return;
+		geomLoading.add(pon);
+		doc.page(pon).annotations.list().then(({ annotations }) => {
+			const boxes = {};
+			for (const dto of annotations) {
+				if (dto.subtype !== "widget") continue;
+				const objectNumber = dto.ref.kind === "objectNumber" ? dto.ref.annotObjectNumber : 0;
+				if (objectNumber > 0) boxes[objectNumber] = toBox(dto.rect, crop);
+			}
+			apply({
+				t: "pageGeom",
+				pageObjectNumber: pon,
+				boxes
+			});
+		}).finally(() => {
+			geomLoading.delete(pon);
+		});
+	};
+	const fillCache = /* @__PURE__ */ new Map();
+	const fillItems$1 = (pon) => {
+		const m = model();
+		const hit = fillCache.get(pon);
+		if (hit && hit.seq === m.seq) return hit.items;
+		const items = fillItems(m, pon);
+		fillCache.set(pon, {
+			seq: m.seq,
+			items
+		});
+		return items;
+	};
+	const fillItemCache = /* @__PURE__ */ new Map();
+	const fillItem = (annotObjectNumber) => {
+		const m = model();
+		const hit = fillItemCache.get(annotObjectNumber);
+		if (hit && hit.seq === m.seq) return hit.item;
+		const item = fillItemForWidget(m, annotObjectNumber);
+		fillItemCache.set(annotObjectNumber, {
+			seq: m.seq,
+			item
+		});
+		return item;
+	};
+	const commitValueNow = async (ref, value) => {
+		const doc = ctx.doc;
+		if (!doc) throw new Error("no document");
+		if (scripting) {
+			const result = await scripting.commit(await doc.forms.list(), ref, value);
+			surfaceScriptingResult(result);
+			if (result.effectsResult !== null) await refresh(true);
+			return result;
+		}
+		const result = await doc.forms.setValue(ref, value);
+		await refresh(true);
+		return {
+			status: result.changedWidgets.length > 0 ? "applied" : "unchanged",
+			scripted: false,
+			effectsResult: null,
+			uiEffects: [],
+			diagnostics: []
+		};
+	};
+	const write = (key, value) => enqueueMutation(async () => {
+		if (!ctx.doc) return;
+		apply({
+			t: "writeStart",
+			key
+		});
+		try {
+			const result = await commitValueNow(refKeyOf(key), value);
+			if (result.status === "rejected" || result.status === "failed") apply({
+				t: "writeFailed",
+				key
+			});
+			else if (result.effectsResult === null && result.scripted) apply({
+				t: "writeFailed",
+				key
+			});
+		} catch (err) {
+			apply({
+				t: "writeFailed",
+				key
+			});
+			throw err;
+		}
+	});
+	const can = (cap) => ctx.doc?.security.allows(cap) ?? false;
+	const annotationHost = ctx.tryGet(_embedpdf_plugin_annotation_internal.AnnotationToken);
+	const annotationActivation = async (ref) => {
+		const doc = ctx.doc;
+		if (!doc) return null;
+		const loaded = annotationHost?.get(ref);
+		if (loaded?.subtype === "widget") return loaded.actions?.activate ?? null;
+		const { annotations } = await doc.page(ref.pageObjectNumber).annotations.list();
+		const annotation = annotations.find((candidate) => sameAnnotationRef(candidate.ref, ref));
+		return annotation?.subtype === "widget" ? annotation.actions?.activate ?? null : null;
+	};
+	const activateWidgetNow = async (key, annotationRef) => {
+		const doc = ctx.doc;
+		if (!doc) throw new Error("no document");
+		if (!scripting) return {
+			status: "unchanged",
+			scripted: false,
+			effectsResult: null,
+			uiEffects: [],
+			diagnostics: []
+		};
+		const action = await annotationActivation(annotationRef);
+		if (!action) return {
+			status: "unchanged",
+			scripted: true,
+			effectsResult: null,
+			uiEffects: [],
+			diagnostics: []
+		};
+		const result = await scripting.activate(await doc.forms.list(), refKeyOf(key), action);
+		surfaceScriptingResult(result);
+		if (result.effectsResult !== null) await refresh(true);
+		return result;
+	};
+	const nudgeAnnotations = (pons) => {
+		if (!annotationHost) return;
+		for (const pon of new Set(pons)) annotationHost.reloadPage(pon);
+	};
+	/** Content-space box → PDF rect (inverse of `toBox`). */
+	const toPdfRect = (box, crop) => ({
+		left: box.x + crop.left,
+		top: crop.top - box.y,
+		right: box.x + crop.left + box.width,
+		bottom: crop.top - box.y - box.height
+	});
+	/** The page's content box (`{0,0,w,h}`), for page-bound placement math. */
+	const pageBox = (pon) => {
+		const crop = ctx.document()?.pages.find((p) => p.pageObjectNumber === pon)?.boxes.crop;
+		return crop ? {
+			x: 0,
+			y: 0,
+			width: crop.right - crop.left,
+			height: crop.top - crop.bottom
+		} : null;
+	};
+	/** Deterministic, collision-free auto-name: `text_1`, `text_2`, … counted
+	*  against the CURRENT snapshot (rename in the field panel). */
+	const autoName = (family) => {
+		const names = new Set((model().snapshot?.fields ?? []).map((f) => f.name));
+		let n = 1;
+		while (names.has(`${family}_${n}`)) n++;
+		return `${family}_${n}`;
+	};
+	const placeFieldNow = async (input) => {
+		const doc = ctx.doc;
+		const pon = input.pageObjectNumber;
+		const crop = ctx.document()?.pages.find((p) => p.pageObjectNumber === pon)?.boxes.crop;
+		if (!doc || !crop) throw new Error("[form] placeField: document/page not ready");
+		const page = pageBox(pon);
+		const x = Math.max(page.x, Math.min(input.box.x, page.width));
+		const y = Math.max(page.y, Math.min(input.box.y, page.height));
+		const box = {
+			x,
+			y,
+			width: Math.max(0, Math.min(input.box.x + input.box.width, page.width) - x),
+			height: Math.max(0, Math.min(input.box.y + input.box.height, page.height) - y)
+		};
+		if (box.width < 1 || box.height < 1) throw new Error("[form] placeField: degenerate box (size the box before placing)");
+		const { family, appearance } = input;
+		const name = autoName(family);
+		const placement = {
+			pageObjectNumber: pon,
+			rect: toPdfRect(box, crop),
+			...appearance ? { appearance } : {}
+		};
+		const draft = family === "radio" ? {
+			family,
+			name,
+			widgets: [{
+				...placement,
+				onState: "option1"
+			}]
+		} : family === "combobox" || family === "listbox" ? {
+			family,
+			name,
+			widget: placement,
+			options: [{
+				label: "Option 1",
+				value: "Option 1"
+			}, {
+				label: "Option 2",
+				value: "Option 2"
+			}]
+		} : {
+			family,
+			name,
+			widget: placement
+		};
+		const result = await doc.forms.createField(draft);
+		await refresh(true);
+		apply({
+			t: "clearGeom",
+			pageObjectNumber: pon
+		});
+		if (annotationHost) await annotationHost.reloadPage(pon);
+		const widget = result.field.widgets.find((w) => w.pageObjectNumber === pon) ?? null;
+		return {
+			field: result.field,
+			widget
+		};
+	};
+	const updateFieldNow = async (key, patch) => {
+		const doc = ctx.doc;
+		if (!doc) return;
+		await doc.forms.updateField(refKeyOf(key), patch);
+		await refresh(true);
+	};
+	const deleteFieldNow = async (key) => {
+		const doc = ctx.doc;
+		if (!doc) return;
+		const pons = fieldByKey(model(), key)?.widgets.map((w) => w.pageObjectNumber).filter((p) => p > 0) ?? [];
+		await doc.forms.deleteField(refKeyOf(key));
+		await refresh(true);
+		for (const pon of new Set(pons)) apply({
+			t: "clearGeom",
+			pageObjectNumber: pon
+		});
+		nudgeAnnotations(pons);
+	};
+	const detachWidgetNow = async (key, annotObjectNumber) => {
+		const doc = ctx.doc;
+		if (!doc) return;
+		const widget = fieldByKey(model(), key)?.widgets.find((w) => w.annotObjectNumber === annotObjectNumber);
+		await doc.forms.detachWidget(refKeyOf(key), {
+			annotObjectNumber,
+			pageObjectNumber: widget?.pageObjectNumber ?? 0
+		});
+		await refresh(true);
+		if (widget && widget.pageObjectNumber > 0) {
+			apply({
+				t: "clearGeom",
+				pageObjectNumber: widget.pageObjectNumber
+			});
+			nudgeAnnotations([widget.pageObjectNumber]);
+		}
+	};
+	refresh();
+	return {
+		snapshot: () => model().snapshot,
+		refresh,
+		fillItems: fillItems$1,
+		fillItem,
+		ensureGeom,
+		field: (key) => fieldByKey(model(), key),
+		fieldForWidget: (annotObjectNumber) => fieldForWidget(model(), annotObjectNumber),
+		setText: (key, value) => write(key, {
+			type: "text",
+			value
+		}),
+		toggle: (key, onState) => write(key, {
+			type: "toggle",
+			state: onState
+		}),
+		choose: (key, values) => write(key, {
+			type: "choice",
+			values
+		}),
+		reset: (key) => enqueueMutation(async () => {
+			const doc = ctx.doc;
+			if (!doc) return;
+			apply({
+				t: "writeStart",
+				key
+			});
+			try {
+				const result = await doc.forms.reset(refKeyOf(key));
+				apply({
+					t: "writeDone",
+					key,
+					field: result.field
+				});
+			} catch (err) {
+				apply({
+					t: "writeFailed",
+					key
+				});
+				throw err;
+			}
+		}),
+		commitValue: (ref, value) => enqueueMutation(() => commitValueNow(ref, value)),
+		activateWidget: (key, annotationRef) => enqueueMutation(() => activateWidgetNow(key, annotationRef)),
+		setUiEffectProvider: (provider) => {
+			uiEffectProvider = provider;
+		},
+		setValue: (ref, value) => enqueueMutation(async () => {
+			const doc = ctx.doc;
+			if (!doc) throw new Error("no document");
+			const result = await doc.forms.setValue(ref, value);
+			await refresh(true);
+			return result;
+		}),
+		exportData: async (format = "xfdf") => {
+			const doc = ctx.doc;
+			if (!doc) throw new Error("no document");
+			return doc.forms.exportData(format);
+		},
+		importData: (data, format) => enqueueMutation(async () => {
+			const doc = ctx.doc;
+			if (!doc) throw new Error("no document");
+			const result = await doc.forms.importData(data, format);
+			apply({
+				t: "snapshot",
+				snapshot: result.snapshot
+			});
+			return result;
+		}),
+		repair: (repairOptions) => enqueueMutation(async () => {
+			const doc = ctx.doc;
+			if (!doc) throw new Error("no document");
+			const result = await doc.forms.repair(repairOptions);
+			await refresh(true);
+			return result;
+		}),
+		placeField: (input) => enqueueMutation(() => placeFieldNow(input)),
+		pageBox,
+		updateField: (key, patch) => enqueueMutation(() => updateFieldNow(key, patch)),
+		deleteField: (key) => enqueueMutation(() => deleteFieldNow(key)),
+		detachWidget: (key, annotObjectNumber) => enqueueMutation(() => detachWidgetNow(key, annotObjectNumber)),
+		canFill: () => can("doc.forms.fill"),
+		canModify: () => can("doc.forms.modify")
+	};
+}
+//#endregion
+//#region src/effects.ts
+const STRUCTURAL = /* @__PURE__ */ new Set([
+	"form.fieldCreated",
+	"form.fieldUpdated",
+	"form.fieldDeleted",
+	"form.widgetAttached",
+	"form.widgetDetached",
+	"form.repaired"
+]);
+function registerFormEffects(ctx) {
+	const doc = ctx.doc;
+	if (!doc) return;
+	let refreshing = false;
+	const refresh = async () => {
+		if (refreshing) return;
+		refreshing = true;
+		try {
+			const snapshot = await doc.forms.list();
+			ctx.dispatch({
+				type: "SET_MODEL",
+				model: update(ctx.getState().model, {
+					t: "snapshot",
+					snapshot
+				})
+			});
+		} finally {
+			refreshing = false;
+		}
+	};
+	const unsubscribe = doc.events.subscribe((event) => {
+		if (!event.type.startsWith("form.")) return;
+		const structural = STRUCTURAL.has(event.type);
+		if (event.origin.kind !== "remote" && !structural) return;
+		if (structural) ctx.dispatch({
+			type: "SET_MODEL",
+			model: update(ctx.getState().model, { t: "clearGeom" })
+		});
+		refresh();
+	});
+	ctx.cleanup(unsubscribe);
+}
+//#endregion
+//#region src/tools.ts
+/** Palette tools keep widgets editable right after placement. */
+const PLACE_TAGS = ["form-place", "annotation-edit"];
+const FIELD_CHROME = {
+	interiorColor: "#ffffff",
+	color: "#6b7280",
+	strokeWidth: 1
+};
+const FORM_TOOLS = [
+	{
+		id: "form-text",
+		family: "text",
+		visualKind: "widget-text",
+		clickCreate: {
+			width: 160,
+			height: 24
+		},
+		defaults: {
+			...FIELD_CHROME,
+			fontSize: 12
+		},
+		cursor: "crosshair"
+	},
+	{
+		id: "form-checkbox",
+		family: "checkbox",
+		visualKind: "widget-toggle",
+		clickCreate: {
+			width: 18,
+			height: 18
+		},
+		defaults: FIELD_CHROME,
+		cursor: "crosshair"
+	},
+	{
+		id: "form-radio",
+		family: "radio",
+		visualKind: "widget-toggle",
+		clickCreate: {
+			width: 18,
+			height: 18
+		},
+		defaults: FIELD_CHROME,
+		cursor: "crosshair"
+	},
+	{
+		id: "form-combobox",
+		family: "combobox",
+		visualKind: "widget-choice",
+		clickCreate: {
+			width: 140,
+			height: 24
+		},
+		defaults: {
+			...FIELD_CHROME,
+			fontSize: 12
+		},
+		cursor: "crosshair"
+	},
+	{
+		id: "form-listbox",
+		family: "listbox",
+		visualKind: "widget-choice",
+		clickCreate: {
+			width: 140,
+			height: 72
+		},
+		defaults: {
+			...FIELD_CHROME,
+			fontSize: 12
+		},
+		cursor: "crosshair"
+	}
+];
+const FORM_TOOL_BY_ID = new Map(FORM_TOOLS.map((t) => [t.id, t]));
+//#endregion
+//#region src/handler.ts
+const rectFrom = (a, b) => ({
+	x: Math.min(a.x, b.x),
+	y: Math.min(a.y, b.y),
+	width: Math.abs(b.x - a.x),
+	height: Math.abs(b.y - a.y)
+});
+/**
+* Draw-to-place: drag a box (live placement preview through the annotation
+* plane's ghost pipeline) or just click (the tool's `clickCreate` policy,
+* resolved by the SAME `resolveClickPlacement` the annotation core uses) —
+* the commit creates field + widget through `doc.forms.placeField`, styled
+* from the tool's live defaults. The tool stays active for repeat placement
+* (v2 rubber-stamp feel) and the fresh widget is auto-selected.
+*
+* Gesture rules match the annotation handlers: page-anchored via the sample
+* projection (the box keeps sizing along the edge when the cursor overshoots
+* or crosses a gap), the UP sample is the final point, and a CLICK means
+* width AND height under the shared threshold — a thin 100×2 drag is a drag.
+*/
+function createPlaceHandler(form, interaction, annotation) {
+	let origin = null;
+	return {
+		id: "form-place",
+		priority: 95,
+		enabledFor: (t) => t.enables.has("form-place"),
+		onDown: (s) => {
+			if (!s.page || !FORM_TOOL_BY_ID.has(interaction.activeToolId())) return false;
+			if (!form.canModify()) return false;
+			origin = {
+				pon: s.page.pon,
+				start: s.page.point,
+				last: s.page.point
+			};
+			return true;
+		},
+		onMove: (s) => {
+			if (!origin) return;
+			const point = (0, _embedpdf_plugin_interaction.samplePointOn)(s, origin.pon);
+			if (!point) return;
+			origin.last = point;
+			const box = rectFrom(origin.start, point);
+			if (annotation) if (Math.max(box.width, box.height) >= _embedpdf_plugin_annotation.MIN_DRAG) annotation.setPlacementPreview(interaction.activeToolId(), origin.pon, box);
+			else annotation.clearPlacementPreview();
+		},
+		onUp: (s) => {
+			if (!origin) return;
+			const o = origin;
+			origin = null;
+			annotation?.clearPlacementPreview();
+			const toolId = interaction.activeToolId();
+			const tool = FORM_TOOL_BY_ID.get(toolId);
+			if (!tool) return;
+			const end = (0, _embedpdf_plugin_interaction.samplePointOn)(s, o.pon) ?? o.last;
+			const dragged = rectFrom(o.start, end);
+			const isClick = dragged.width < _embedpdf_plugin_annotation.MIN_DRAG && dragged.height < _embedpdf_plugin_annotation.MIN_DRAG;
+			const pageBox = form.pageBox(o.pon);
+			const box = isClick ? boxOfClick(o.start, tool.clickCreate, pageBox) : dragged;
+			form.placeField({
+				family: tool.family,
+				pageObjectNumber: o.pon,
+				box,
+				appearance: (0, _embedpdf_plugin_annotation.widgetAppearanceFromProps)(annotation ? annotation.currentDefaults(toolId) : tool.defaults)
+			}).then((placed) => {
+				if (!annotation || interaction.activeToolId() !== toolId) return;
+				const widget = placed.widget;
+				if (!widget || widget.annotObjectNumber <= 0) return;
+				annotation.select({
+					kind: "objectNumber",
+					annotObjectNumber: widget.annotObjectNumber,
+					pageObjectNumber: o.pon
+				});
+			}).catch((err) => {
+				globalThis.console?.error("[form] placeField failed:", err);
+			});
+		}
+	};
+}
+/** The click-create box through the SHARED placement layer (fields are boxes;
+*  the policy anchor + page clamp are exactly the annotation click's). */
+function boxOfClick(point, policy, pageBox) {
+	const placement = (0, _embedpdf_plugin_annotation.resolveClickPlacement)(point, policy, { pageBox: pageBox ?? void 0 });
+	return placement.kind === "box" ? placement.rect : {
+		x: point.x,
+		y: point.y,
+		width: policy.width,
+		height: policy.height
+	};
+}
+//#endregion
+//#region src/reducer.ts
+const initialFormState = () => ({ model: initialModel() });
+/** Dumb store: the pure core computes the next model; the shell dispatches it. */
+const formReducer = (state, action) => action.type === "SET_MODEL" ? { model: action.model } : state;
+//#endregion
+//#region src/types.ts
+const FormToken = (0, _embedpdf_core.createCapabilityToken)("form");
+//#endregion
+//#region src/form.plugin.ts
+/**
+* The form plugin: the FIELD plane. Document-scoped; requires the
+* interaction hub. Fill mode works with no annotation plugin at all —
+* geometry is read from the engine's widget DTOs. When the annotation
+* plugin IS present, a Behavior keeps widgets geometry-inert while the
+* active tool carries 'form-fill' (the built-in pointer/pan tools do, so
+* filling is the resting state) and stands the fill controls down under
+* every other tool — the single-active-tool hub IS the mode switch.
+* Design mode = the 'form-edit' / palette tools: no 'form-fill' tag, so
+* widgets become ordinary editable annotations.
+*/
+const formPlugin = (options = {}) => (0, _embedpdf_core.definePlugin)({
+	id: "form",
+	token: FormToken,
+	scope: "document",
+	requires: [_embedpdf_plugin_interaction.InteractionToken],
+	optional: [_embedpdf_plugin_annotation.AnnotationToken],
+	initialState: initialFormState,
+	reduce: formReducer,
+	capability: (ctx) => createFormCapability(ctx, options),
+	effects: registerFormEffects,
+	init: (ctx) => {
+		const interaction = ctx.get(_embedpdf_plugin_interaction.InteractionToken);
+		const form = ctx.get(FormToken);
+		interaction.registerTool({
+			id: "form-fill",
+			cursor: "default",
+			enables: /* @__PURE__ */ new Set(["form-fill", "link-nav"])
+		});
+		interaction.registerTool({
+			id: "form-edit",
+			cursor: "default",
+			enables: /* @__PURE__ */ new Set(["annotation-edit", "annotation-marquee"])
+		});
+		const annotation = ctx.tryGet(_embedpdf_plugin_annotation_internal.AnnotationToken);
+		for (const t of FORM_TOOLS) if (annotation) annotation.registerTool({
+			id: t.id,
+			subtype: t.visualKind,
+			cursor: t.cursor,
+			enables: [...PLACE_TAGS],
+			clickCreate: t.clickCreate,
+			defaults: t.defaults
+		});
+		else interaction.registerTool({
+			id: t.id,
+			cursor: t.cursor,
+			enables: new Set(PLACE_TAGS)
+		});
+		interaction.registerHandler(createPlaceHandler(form, interaction, annotation));
+		if (annotation) annotation.registerBehavior({
+			id: "form-widgets",
+			matches: (a) => a.subtype.startsWith("widget"),
+			engaged: () => interaction.activeTool()?.enables.has("form-fill") ?? false
+		});
+	}
+});
+//#endregion
+exports.FORM_TOOLS = FORM_TOOLS;
+exports.FORM_TOOL_BY_ID = FORM_TOOL_BY_ID;
+exports.FormScriptingController = FormScriptingController;
+exports.FormToken = FormToken;
+exports.createFormScriptingController = createFormScriptingController;
+exports.createSerialMutationQueue = createSerialMutationQueue;
+exports.fieldKeyOf = fieldKeyOf;
+exports.formPlugin = formPlugin;
+
+//# sourceMappingURL=index.cjs.map