@embedpdf/core 2.15.0 → 3.0.0-next.0

package/dist/index.cjs

@@ -1,2 +1,864 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@embedpdf/models");class e{constructor(){this.dependencyGraph=new Map}addNode(t,e=[]){this.dependencyGraph.set(t,new Set(e))}hasCircularDependencies(){const t=new Set,e=new Set,i=s=>{t.add(s),e.add(s);const o=this.dependencyGraph.get(s)||new Set;for(const n of o)if(t.has(n)){if(e.has(n))return!0}else if(i(n))return!0;return e.delete(s),!1};for(const s of this.dependencyGraph.keys())if(!t.has(s)&&i(s))return!0;return!1}resolveLoadOrder(){if(this.hasCircularDependencies())throw new Error("Circular dependencies detected");const t=[],e=new Set,i=new Set,s=o=>{if(i.has(o))throw new Error("Circular dependency");if(e.has(o))return;i.add(o);const n=this.dependencyGraph.get(o)||new Set;for(const t of n)s(t);i.delete(o),e.add(o),t.push(o)};for(const o of this.dependencyGraph.keys())e.has(o)||s(o);return t}}class i extends Error{constructor(t){super(t),this.name="PluginRegistrationError"}}class s extends Error{constructor(t){super(t),this.name="PluginNotFoundError"}}class o extends Error{constructor(t){super(t),this.name="CircularDependencyError"}}class n extends Error{constructor(t){super(t),this.name="CapabilityNotFoundError"}}class r extends Error{constructor(t){super(t),this.name="CapabilityConflictError"}}class a extends Error{constructor(t){super(t),this.name="PluginInitializationError"}}class c extends Error{constructor(t){super(t),this.name="PluginConfigurationError"}}class u{constructor(t,e){this.store=t,this.pluginId=e}getState(){return this.store.getState().plugins[this.pluginId]}dispatch(t){return this.store.dispatchToPlugin(this.pluginId,t)}subscribeToState(t){return this.store.subscribeToPlugin(this.pluginId,(e,i,s)=>{t(e,i,s)})}onAction(t,e){return this.store.onAction(t,(t,i,s)=>{e(t,i.plugins[this.pluginId],s.plugins[this.pluginId])})}}const d="START_LOADING_DOCUMENT",l="UPDATE_DOCUMENT_LOADING_PROGRESS",h="SET_DOCUMENT_LOADED",g="SET_DOCUMENT_ERROR",p="RETRY_LOADING_DOCUMENT",m="CLOSE_DOCUMENT",f="SET_ACTIVE_DOCUMENT",y="REORDER_DOCUMENTS",S="MOVE_DOCUMENT",w="UPDATE_DOCUMENT_SECURITY",b="REFRESH_DOCUMENT",P="REFRESH_PAGES",E="SET_PAGES",D="SET_SCALE",v="SET_ROTATION",C="SET_DEFAULT_SCALE",I="SET_DEFAULT_ROTATION",R=[d,l,h,m,f,g,p,b,P,E,D,v,C,I,y,S,w];class A{constructor(t,e){this.initialCoreState=e,this.pluginReducers={},this.listeners=[],this.pluginListeners={},this.isDispatching=!1,this.state={core:e,plugins:{}},this.coreReducer=t}addPluginReducer(t,e,i){this.state.plugins[t]=i,this.pluginReducers[t]=e}dispatchToCore(t){if(!this.coreReducer)return this.getState();if(this.isDispatching)throw new Error("Reducers may not dispatch actions. To trigger cascading actions, dispatch from a listener callback instead.");const e=this.getState();try{this.isDispatching=!0,this.state.core=this.coreReducer(this.state.core,t)}finally{this.isDispatching=!1}return this.listeners.forEach(i=>{const s=this.getState();i(t,s,e)}),this.getState()}dispatchToPlugin(t,e,i=!0){if(this.isDispatching)throw new Error("Reducers may not dispatch actions. To trigger cascading actions, dispatch from a listener callback instead.");const s=this.getState(),o=this.pluginReducers[t];if(!o)return s.plugins[t];const n=s.plugins[t];try{this.isDispatching=!0;const i=o(n,e);this.state.plugins[t]=i}finally{this.isDispatching=!1}return i&&this.listeners.forEach(t=>{const i=this.getState();t(e,i,s)}),this.pluginListeners[t]&&this.pluginListeners[t].forEach(i=>{const s=this.getState().plugins[t];i(e,s,n)}),this.getState().plugins[t]}dispatch(t){if(this.isDispatching)throw new Error("Reducers may not dispatch actions. To trigger cascading actions, dispatch from a listener callback instead.");const e=this.getState();try{this.isDispatching=!0,this.isCoreAction(t)&&(this.state.core=this.coreReducer(this.state.core,t));for(const i in this.pluginReducers){const s=this.pluginReducers[i],o=e.plugins[i];s&&(this.state.plugins[i]=s(o,t))}}finally{this.isDispatching=!1}return this.listeners.forEach(i=>{const s=this.getState();i(t,s,e)}),this.getState()}getState(){if(this.isDispatching)throw new Error("You may not call store.getState() while the reducer is executing. The reducer has already received the state as an argument. Pass it down from the top reducer instead of reading it from the store.");return{core:{...this.state.core},plugins:{...this.state.plugins}}}subscribe(t){if(this.isDispatching)throw new Error("You may not call store.subscribe() while the reducer is executing. If you would like to be notified after the store has been updated, subscribe from a component and invoke store.getState() in the callback to access the latest state.");return this.listeners.push(t),()=>{if(this.isDispatching)throw new Error("You may not unsubscribe from a store listener while the reducer is executing.");this.listeners=this.listeners.filter(e=>e!==t)}}subscribeToPlugin(t,e){if(!(t in this.state.plugins))throw new Error(`Plugin state not found for plugin "${t}". Did you forget to call addPluginReducer?`);if(this.isDispatching)throw new Error("You may not call store.subscribeToPlugin() while the reducer is executing.");return this.pluginListeners[t]||(this.pluginListeners[t]=[]),this.pluginListeners[t].push(e),()=>{if(this.isDispatching)throw new Error("You may not unsubscribe from a store listener while the reducer is executing.");this.pluginListeners[t]=this.pluginListeners[t].filter(t=>t!==e),0===this.pluginListeners[t].length&&delete this.pluginListeners[t]}}onAction(t,e){return this.subscribe((i,s,o)=>{i.type===t&&e(i,s,o)})}getPluginStore(t){if(!(t in this.state.plugins))throw new Error(`Plugin state not found for plugin "${t}". Did you forget to call addPluginReducer?`);return new u(this,t)}isCoreAction(t){return R.includes(t.type)}destroy(){var t,e;this.listeners.length=0;for(const i in this.pluginListeners)null==(e=null==(t=this.pluginListeners[i])?void 0:t.splice)||e.call(t,0);this.pluginListeners={},this.pluginReducers={},this.state.plugins={},this.state.core={...this.initialCoreState}}}const T=e=>({documents:{},documentOrder:[],activeDocumentId:null,defaultScale:(null==e?void 0:e.defaultScale)??1,defaultRotation:(null==e?void 0:e.defaultRotation)??t.Rotation.Degree0,globalPermissions:null==e?void 0:e.permissions}),x={print:t.PdfPermissionFlag.Print,modifyContents:t.PdfPermissionFlag.ModifyContents,copyContents:t.PdfPermissionFlag.CopyContents,modifyAnnotations:t.PdfPermissionFlag.ModifyAnnotations,fillForms:t.PdfPermissionFlag.FillForms,extractForAccessibility:t.PdfPermissionFlag.ExtractForAccessibility,assembleDocument:t.PdfPermissionFlag.AssembleDocument,printHighQuality:t.PdfPermissionFlag.PrintHighQuality},F=[t.PdfPermissionFlag.Print,t.PdfPermissionFlag.ModifyContents,t.PdfPermissionFlag.CopyContents,t.PdfPermissionFlag.ModifyAnnotations,t.PdfPermissionFlag.FillForms,t.PdfPermissionFlag.ExtractForAccessibility,t.PdfPermissionFlag.AssembleDocument,t.PdfPermissionFlag.PrintHighQuality],O={[t.PdfPermissionFlag.Print]:"print",[t.PdfPermissionFlag.ModifyContents]:"modifyContents",[t.PdfPermissionFlag.CopyContents]:"copyContents",[t.PdfPermissionFlag.ModifyAnnotations]:"modifyAnnotations",[t.PdfPermissionFlag.FillForms]:"fillForms",[t.PdfPermissionFlag.ExtractForAccessibility]:"extractForAccessibility",[t.PdfPermissionFlag.AssembleDocument]:"assembleDocument",[t.PdfPermissionFlag.PrintHighQuality]:"printHighQuality"};function M(t,e){if(!t)return;if(e in t)return t[e];const i=O[e];return i&&i in t?t[i]:void 0}function _(e,i,s){var o;const n=e.documents[i],r=null==n?void 0:n.permissions,a=e.globalPermissions,c=(null==(o=null==n?void 0:n.document)?void 0:o.permissions)??t.PdfPermissionFlag.AllowAll,u=M(null==r?void 0:r.overrides,s);if(void 0!==u)return u;const d=M(null==a?void 0:a.overrides,s);if(void 0!==d)return d;return!((null==r?void 0:r.enforceDocumentPermissions)??(null==a?void 0:a.enforceDocumentPermissions)??!0)||0!==(c&s)}function L(t,e){return F.reduce((i,s)=>_(t,e,s)?i|s:i,0)}function N(t,e,i){const s=t.activeDocumentId;if(s!==e)return s;if(void 0!==i)return i&&t.documents[i]?i:null;const o=t.documentOrder.indexOf(e);return-1===o?null:o>0?t.documentOrder[o-1]:o<t.documentOrder.length-1?t.documentOrder[o+1]:null}const U=(t,e)=>{switch(e.type){case d:{const{documentId:i,name:s,scale:o,rotation:n,passwordProvided:r,autoActivate:a=!0,permissions:c}=e.payload,u={id:i,name:s,status:"loading",loadingProgress:0,error:null,document:null,scale:o??t.defaultScale,rotation:n??t.defaultRotation,passwordProvided:r??!1,pageRefreshVersions:{},permissions:c,loadStartedAt:Date.now()};return{...t,documents:{...t.documents,[i]:u},documentOrder:[...t.documentOrder,i],activeDocumentId:a||!t.activeDocumentId?i:t.activeDocumentId}}case l:{const{documentId:i,progress:s}=e.payload,o=t.documents[i];return o&&"loading"===o.status?{...t,documents:{...t.documents,[i]:{...o,loadingProgress:s}}}:t}case h:{const{documentId:i,document:s}=e.payload,o=t.documents[i];return o?{...t,documents:{...t.documents,[i]:{...o,status:"loaded",document:s,error:null,errorCode:void 0,errorDetails:void 0,passwordProvided:void 0,loadedAt:Date.now()}}}:t}case g:{const{documentId:i,error:s,errorCode:o,errorDetails:n}=e.payload,r=t.documents[i];return r?{...t,documents:{...t.documents,[i]:{...r,status:"error",error:s,errorCode:o,errorDetails:n}}}:t}case p:{const{documentId:i,passwordProvided:s}=e.payload,o=t.documents[i];return o&&"error"===o.status?{...t,documents:{...t.documents,[i]:{...o,status:"loading",loadingProgress:0,error:null,errorCode:void 0,errorDetails:void 0,passwordProvided:s??!1,loadStartedAt:Date.now()}}}:t}case m:{const{documentId:i,nextActiveDocumentId:s}=e.payload,{[i]:o,...n}=t.documents;return{...t,documents:n,documentOrder:t.documentOrder.filter(t=>t!==i),activeDocumentId:N(t,i,s)}}case S:{const{documentId:i,toIndex:s}=e.payload,o=function(t,e,i){const s=t.indexOf(e);if(-1===s)return null;if(i<0||i>=t.length)return null;if(s===i)return null;const o=[...t];return o.splice(s,1),o.splice(i,0,e),o}(t.documentOrder,i,s);return o?{...t,documentOrder:o}:t}case y:return{...t,documentOrder:e.payload};case f:return{...t,activeDocumentId:e.payload};case D:{const{scale:i,documentId:s}=e.payload,o=s??t.activeDocumentId;if(!o)return t;const n=t.documents[o];return n?{...t,documents:{...t.documents,[o]:{...n,scale:i}}}:t}case v:{const{rotation:i,documentId:s}=e.payload,o=s??t.activeDocumentId;if(!o)return t;const n=t.documents[o];return n?{...t,documents:{...t.documents,[o]:{...n,rotation:i}}}:t}case P:{const{documentId:i,pageIndexes:s}=e.payload,o=t.documents[i];if(!o)return t;const n={...o.pageRefreshVersions};for(const t of s)n[t]=(n[t]||0)+1;return{...t,documents:{...t.documents,[i]:{...o,pageRefreshVersions:n}}}}case w:{const{documentId:i,permissions:s,isOwnerUnlocked:o}=e.payload,n=t.documents[i];return(null==n?void 0:n.document)?{...t,documents:{...t.documents,[i]:{...n,document:{...n.document,permissions:s,isOwnerUnlocked:o}}}}:t}default:return t}};class k{constructor(t,e){this.handler=t,this.options=e,this.lastRun=0,this.handle=t=>{"debounce"===this.options.mode?this.debounce(t):this.throttle(t)}}debounce(t){this.timeoutId&&window.clearTimeout(this.timeoutId),this.timeoutId=window.setTimeout(()=>{this.handler(t),this.timeoutId=void 0},this.options.wait)}throttle(t){if("debounce"===this.options.mode)return;const e=Date.now(),i=this.options.throttleMode||"leading-trailing";e-this.lastRun>=this.options.wait&&("leading-trailing"===i&&this.handler(t),this.lastRun=e),this.timeoutId&&window.clearTimeout(this.timeoutId),this.timeoutId=window.setTimeout(()=>{this.handler(t),this.lastRun=Date.now(),this.timeoutId=void 0},this.options.wait-(e-this.lastRun))}destroy(){this.timeoutId&&window.clearTimeout(this.timeoutId)}}class z{constructor(t,e){this.handler=t,this.options=e,this.controls=new Map,this.handle=t=>{const e=String(this.options.keyExtractor(t));let i=this.controls.get(e);i||(i=new k(this.handler,this.baseOptions),this.controls.set(e,i)),i.handle(t)},this.baseOptions={mode:e.mode,wait:e.wait,..."throttle"===e.mode&&"throttleMode"in e?{throttleMode:e.throttleMode}:{}}}destroy(){for(const t of this.controls.values())t.destroy();this.controls.clear()}}function $(t){return"keyExtractor"in t}function G(t,e,i){if(t===e)return!0;if(null==t||null==e)return t===e;const s=typeof t;if(s!==typeof e)return!1;if("object"===s){i||(i=new Set);const s=function(t,e){return`${H(t)}__${H(e)}`}(t,e);if(i.has(s))return!0;i.add(s);const o=Array.isArray(t),n=Array.isArray(e);return o&&n?function(t,e,i){if(t.length!==e.length)return!1;const s=new Array(e.length).fill(!1);t:for(let o=0;o<t.length;o++){const n=t[o];for(let t=0;t<e.length;t++)if(!s[t]&&G(n,e[t],i)){s[t]=!0;continue t}return!1}return!0}(t,e,i):!o&&!n&&function(t,e,i){const s=Object.keys(t).sort(),o=Object.keys(e).sort();if(s.length!==o.length)return!1;for(let n=0;n<s.length;n++)if(s[n]!==o[n])return!1;for(const n of s){if(!G(t[n],e[n],i))return!1}return!0}(t,e,i)}return!1}let j=0;const q=new WeakMap;function H(t){return q.has(t)||q.set(t,++j),q.get(t)}class Y{constructor(t){this.autoMountElements=[],this.package=t}addUtility(t){return this.autoMountElements.push({component:t,type:"utility"}),this}addWrapper(t){return this.autoMountElements.push({component:t,type:"wrapper"}),this}build(){return{...this.package,autoMountElements:()=>this.autoMountElements}}}exports.ALL_PERMISSION_FLAGS=F,exports.ALL_PERMISSION_NAMES=["print","modifyContents","copyContents","modifyAnnotations","fillForms","extractForAccessibility","assembleDocument","printHighQuality"],exports.BasePlugin=class{constructor(t,e){if(this.id=t,this.registry=e,this.cooldownActions={},this.debouncedTimeouts={},this.unsubscribeFromState=null,this.unsubscribeFromCoreStore=null,this.unsubscribeFromStartLoadingDocument=null,this.unsubscribeFromSetDocumentLoaded=null,this.unsubscribeFromCloseDocument=null,this.unsubscribeFromSetScale=null,this.unsubscribeFromSetRotation=null,t!==this.constructor.id)throw new Error(`Plugin ID mismatch: ${t} !== ${this.constructor.id}`);this.engine=this.registry.getEngine(),this.logger=this.registry.getLogger(),this.coreStore=this.registry.getStore(),this.pluginStore=this.coreStore.getPluginStore(this.id),this.unsubscribeFromState=this.pluginStore.subscribeToState((t,e,i)=>{this.onStoreUpdated(i,e)}),this.unsubscribeFromCoreStore=this.coreStore.subscribe((t,e,i)=>{this.onCoreStoreUpdated(i,e),e.core.activeDocumentId!==i.core.activeDocumentId&&this.onActiveDocumentChanged(i.core.activeDocumentId,e.core.activeDocumentId)}),this.unsubscribeFromStartLoadingDocument=this.coreStore.onAction(d,t=>{this.onDocumentLoadingStarted(t.payload.documentId)}),this.unsubscribeFromSetDocumentLoaded=this.coreStore.onAction(h,t=>{this.onDocumentLoaded(t.payload.documentId)}),this.unsubscribeFromCloseDocument=this.coreStore.onAction(m,t=>{this.onDocumentClosed(t.payload.documentId)}),this.unsubscribeFromSetScale=this.coreStore.onAction(D,(t,e)=>{const i=t.payload.documentId??e.core.activeDocumentId;i&&this.onScaleChanged(i,t.payload.scale)}),this.unsubscribeFromSetRotation=this.coreStore.onAction(v,(t,e)=>{const i=t.payload.documentId??e.core.activeDocumentId;i&&this.onRotationChanged(i,t.payload.rotation)}),this.readyPromise=new Promise(t=>{this.readyResolve=t}),this.readyResolve()}provides(){if(!this._capability){const t=this.buildCapability();this._capability=Object.freeze(t)}return this._capability}get state(){return this.pluginStore.getState()}get coreState(){return this.coreStore.getState()}getState(){return this.pluginStore.getState()}getCoreState(){return this.coreStore.getState()}dispatchCoreAction(t){return this.coreStore.dispatchToCore(t)}dispatchToAllPlugins(t){return this.coreStore.dispatch(t)}dispatch(t){return this.pluginStore.dispatch(t)}cooldownDispatch(t,e=100){const i=Date.now();return i-(this.cooldownActions[t.type]||0)>=e&&(this.cooldownActions[t.type]=i,this.dispatch(t),!0)}debouncedDispatch(t,e=100){const i=t.type;this.debouncedTimeouts[i]&&clearTimeout(this.debouncedTimeouts[i]),this.debouncedTimeouts[i]=setTimeout(()=>{this.dispatch(t),delete this.debouncedTimeouts[i]},e)}cancelDebouncedDispatch(t){this.debouncedTimeouts[t]&&(clearTimeout(this.debouncedTimeouts[t]),delete this.debouncedTimeouts[t])}subscribe(t){return this.pluginStore.subscribeToState(t)}subscribeToCoreStore(t){return this.coreStore.subscribe(t)}onStoreUpdated(t,e){}onCoreStoreUpdated(t,e){}onDocumentLoadingStarted(t){}onDocumentLoaded(t){}onDocumentClosed(t){}onActiveDocumentChanged(t,e){}onScaleChanged(t,e){}onRotationChanged(t,e){}destroy(){Object.values(this.debouncedTimeouts).forEach(t=>{clearTimeout(t)}),this.debouncedTimeouts={},this.unsubscribeFromState&&(this.unsubscribeFromState(),this.unsubscribeFromState=null),this.unsubscribeFromCoreStore&&(this.unsubscribeFromCoreStore(),this.unsubscribeFromCoreStore=null),this.unsubscribeFromStartLoadingDocument&&(this.unsubscribeFromStartLoadingDocument(),this.unsubscribeFromStartLoadingDocument=null),this.unsubscribeFromSetDocumentLoaded&&(this.unsubscribeFromSetDocumentLoaded(),this.unsubscribeFromSetDocumentLoaded=null),this.unsubscribeFromCloseDocument&&(this.unsubscribeFromCloseDocument(),this.unsubscribeFromCloseDocument=null),this.unsubscribeFromSetScale&&(this.unsubscribeFromSetScale(),this.unsubscribeFromSetScale=null),this.unsubscribeFromSetRotation&&(this.unsubscribeFromSetRotation(),this.unsubscribeFromSetRotation=null)}ready(){return this.readyPromise}markReady(){this.readyResolve()}resetReady(){this.readyPromise=new Promise(t=>{this.readyResolve=t})}getActiveDocumentId(){const t=this.coreState.core.activeDocumentId;if(!t)throw new Error("No active document");return t}getActiveDocumentIdOrNull(){return this.coreState.core.activeDocumentId}getCoreDocument(t){const e=t??this.getActiveDocumentIdOrNull();return e?this.coreState.core.documents[e]??null:null}getCoreDocumentOrThrow(t){const e=this.getCoreDocument(t);if(!e)throw new Error(`Document not found: ${t??"active"}`);return e}getDocumentPermissions(e){const i=e??this.coreState.core.activeDocumentId;return i?L(this.coreState.core,i):t.PdfPermissionFlag.AllowAll}checkPermission(t,...e){const i=t??this.coreState.core.activeDocumentId;return!i||e.every(t=>_(this.coreState.core,i,t))}requirePermission(e,...i){const s=e??this.coreState.core.activeDocumentId;if(!s)return;const o=[];for(const t of i)_(this.coreState.core,s,t)||o.push(t);if(o.length>0){const e=L(this.coreState.core,s);throw new t.PermissionDeniedError(o,e)}}},exports.CLOSE_DOCUMENT=m,exports.CORE_ACTION_TYPES=R,exports.CapabilityConflictError=r,exports.CapabilityNotFoundError=n,exports.CircularDependencyError=o,exports.DependencyResolver=e,exports.EventControl=k,exports.KeyedEventControl=z,exports.MOVE_DOCUMENT=S,exports.PERMISSION_FLAG_TO_NAME=O,exports.PERMISSION_NAME_TO_FLAG=x,exports.PluginConfigurationError=c,exports.PluginInitializationError=a,exports.PluginNotFoundError=s,exports.PluginPackageBuilder=Y,exports.PluginRegistrationError=i,exports.PluginRegistry=class{constructor(i,s){this.plugins=new Map,this.manifests=new Map,this.capabilities=new Map,this.status=new Map,this.configurations=new Map,this.initPromise=null,this.pendingRegistrations=[],this.processingRegistrations=[],this.initialized=!1,this.isInitializing=!1,this.pluginsReadyPromise=null,this.destroyed=!1,this.resolver=new e,this.engine=i,this.initialCoreState=T(s),this.store=new A(U,this.initialCoreState),this.logger=(null==s?void 0:s.logger)??new t.NoopLogger}getLogger(){return this.logger}registerPlugin(t,e){if(this.initialized&&!this.isInitializing)throw new i("Cannot register plugins after initialization");this.validateManifest(t.manifest),this.store.addPluginReducer(t.manifest.id,t.reducer,"function"==typeof t.initialState?t.initialState(this.initialCoreState,{...t.manifest.defaultConfig,...e}):t.initialState),this.pendingRegistrations.push({package:t,config:e})}getStore(){return this.store}getEngine(){return this.engine}pluginsReady(){return this.pluginsReadyPromise||(this.pluginsReadyPromise=(async()=>{this.initialized||await this.initialize();const t=Array.from(this.plugins.values()).map(t=>"function"==typeof t.ready?t.ready():Promise.resolve());await Promise.all(t)})()),this.pluginsReadyPromise}async initialize(){if(this.destroyed)throw new i("Registry has been destroyed");return this.initPromise||(this.initPromise=(async()=>{if(this.initialized)throw new i("Registry is already initialized");this.isInitializing=!0;try{if(this.destroyed)return;for(;this.pendingRegistrations.length>0;){if(this.destroyed)return;this.processingRegistrations=[...this.pendingRegistrations],this.pendingRegistrations=[];for(const e of this.processingRegistrations){const t=new Set,i=[...e.package.manifest.requires,...e.package.manifest.optional];for(const e of i){const i=this.processingRegistrations.find(t=>t.package.manifest.provides.includes(e));i&&t.add(i.package.manifest.id)}this.resolver.addNode(e.package.manifest.id,[...t])}const t=this.resolver.resolveLoadOrder();for(const e of t){const t=this.processingRegistrations.find(t=>t.package.manifest.id===e);this.instantiatePlugin(t.package.manifest,t.package.create,t.config)}for(const e of t)await this.runPluginInitialization(e);this.processingRegistrations=[],this.resolver=new e}this.initialized=!0}catch(t){if(t instanceof Error)throw new o(`Failed to resolve plugin dependencies: ${t.message}`);throw t}finally{this.isInitializing=!1}})()),this.initPromise}instantiatePlugin(t,e,s){const o={...t.defaultConfig,...s};this.validateConfig(t.id,o,t.defaultConfig);const n=e(this,o);this.validatePlugin(n);for(const r of t.provides){if(this.capabilities.has(r))throw new i(`Capability ${r} is already provided by plugin ${this.capabilities.get(r)}`);this.capabilities.set(r,t.id)}this.plugins.set(t.id,n),this.manifests.set(t.id,t),this.status.set(t.id,"registered"),this.configurations.set(t.id,o)}async runPluginInitialization(t){const e=this.plugins.get(t);if(!e)return;const s=this.manifests.get(t),o=this.configurations.get(t);for(const r of s.requires)if(!this.capabilities.has(r))throw new i(`Missing required capability: ${r} for plugin ${t}`);this.logger.debug("PluginRegistry","InitializePlugin",`Initializing plugin ${t}`);try{e.initialize&&await e.initialize(o),this.status.set(t,"active"),this.logger.info("PluginRegistry","PluginInitialized",`Plugin ${t} initialized successfully`)}catch(n){throw this.status.set(t,"error"),this.logger.error("PluginRegistry","InitializationFailed",`Plugin ${t} initialization failed`,{error:n}),n}}getPluginConfig(t){const e=this.configurations.get(t);if(!e)throw new s(`Configuration for plugin ${t} not found`);return e}validateConfig(t,e,i){const s=Object.keys(i).filter(t=>!e.hasOwnProperty(t));if(s.length>0)throw new c(`Missing required configuration keys for plugin ${t}: ${s.join(", ")}`)}async updatePluginConfig(t,e){const i=this.getPlugin(t);if(!i)throw new s(`Plugin ${t} not found`);const o=this.manifests.get(t),n=this.configurations.get(t);if(!o||!n)throw new s(`Plugin ${t} not found`);const r={...n,...e};this.validateConfig(t,r,o.defaultConfig),this.configurations.set(t,r),i.initialize&&await i.initialize(r)}registerPluginBatch(t){for(const e of t)this.registerPlugin(e.package,e.config)}async unregisterPlugin(t){const e=this.plugins.get(t);if(!e)throw new s(`Plugin ${t} is not registered`);const o=this.manifests.get(t);if(!o)throw new s(`Manifest for plugin ${t} not found`);for(const[s,r]of this.manifests.entries()){if(s===t)continue;if([...r.requires,...r.optional].some(t=>o.provides.includes(t)))throw new i(`Cannot unregister plugin ${t}: plugin ${s} depends on it`)}try{e.destroy&&await e.destroy();for(const t of o.provides)this.capabilities.delete(t);this.plugins.delete(t),this.manifests.delete(t),this.status.delete(t)}catch(n){if(n instanceof Error)throw new Error(`Failed to unregister plugin ${t}: ${n.message}`);throw n}}getPlugin(t){const e=this.plugins.get(t);return e||null}getCapabilityProvider(t){const e=this.capabilities.get(t);return e?this.getPlugin(e):null}hasCapability(t){return this.capabilities.has(t)}getAllPlugins(){return Array.from(this.plugins.values())}getPluginStatus(t){const e=this.status.get(t);if(!e)throw new s(`Plugin ${t} not found`);return e}validatePlugin(t){if(!t.id)throw new i("Plugin must have an id")}validateManifest(t){if(!t.id)throw new i("Manifest must have an id");if(!t.name)throw new i("Manifest must have a name");if(!t.version)throw new i("Manifest must have a version");if(!Array.isArray(t.provides))throw new i("Manifest must have a provides array");if(!Array.isArray(t.requires))throw new i("Manifest must have a requires array");if(!Array.isArray(t.optional))throw new i("Manifest must have an optional array")}isDestroyed(){return this.destroyed}async destroy(){var t;if(this.destroyed)throw new i("Registry has already been destroyed");this.destroyed=!0;try{await this.initPromise}catch{}for(const e of Array.from(this.plugins.values()).reverse())await(null==(t=e.destroy)?void 0:t.call(e));this.store.destroy(),this.plugins.clear(),this.manifests.clear(),this.capabilities.clear(),this.status.clear(),this.pendingRegistrations.length=0,this.processingRegistrations.length=0}},exports.REFRESH_DOCUMENT=b,exports.REFRESH_PAGES=P,exports.REORDER_DOCUMENTS=y,exports.RETRY_LOADING_DOCUMENT=p,exports.SET_ACTIVE_DOCUMENT=f,exports.SET_DEFAULT_ROTATION=I,exports.SET_DEFAULT_SCALE=C,exports.SET_DOCUMENT_ERROR=g,exports.SET_DOCUMENT_LOADED=h,exports.SET_PAGES=E,exports.SET_ROTATION=v,exports.SET_SCALE=D,exports.START_LOADING_DOCUMENT=d,exports.UPDATE_DOCUMENT_LOADING_PROGRESS=l,exports.UPDATE_DOCUMENT_SECURITY=w,exports.arePropsEqual=G,exports.clamp=function(t,e,i){return t<e?e:t>i?i:t},exports.closeDocument=(t,e)=>({type:m,payload:{documentId:t,nextActiveDocumentId:e}}),exports.createBehaviorEmitter=function(t,e=G){const i=new Set,s=new Map;let o=t;const n=(t,e)=>{let n=t,r=()=>{};if(e){if($(e)){const i=new z(t,e);n=i.handle,r=()=>i.destroy()}else{const i=new k(t,e);n=i.handle,r=()=>i.destroy()}s.set(t,{wrapped:n,destroy:r})}return void 0!==o&&n(o),i.add(n),()=>{i.delete(n),r(),s.delete(t)}};return{get value(){return o},emit(t=void 0){void 0!==o&&e(o,t)||(o=t,(t=>{i.forEach(e=>e(t))})(t))},on:n,off(t){const e=s.get(t);e?(i.delete(e.wrapped),e.destroy(),s.delete(t)):i.delete(t)},clear(){i.clear(),s.forEach(t=>t.destroy()),s.clear()},select:(t,e=G)=>(i,s)=>{let r;if(void 0!==o){const e=t(o);r=e,i(e)}return n(s=>{const o=t(s);void 0!==r&&e(r,o)||(r=o,i(o))},s)}}},exports.createEmitter=function(){const t=new Set;return{emit:(e=void 0)=>t.forEach(t=>t(e)),on:e=>(t.add(e),()=>t.delete(e)),off:e=>t.delete(e),clear:()=>t.clear()}},exports.createPluginPackage=function(t){return new Y(t)},exports.createPluginRegistration=function(t,e){return{package:t,config:e}},exports.createScopedEmitter=function(t,e){const i=(null==e?void 0:e.cache)??!0,s=(null==e?void 0:e.equality)??G,o=new Map,n=new Map,r=new Map,a=new Set,c=new Map,u=t=>String(t);return{emit(e,r){const c=u(e);if(i){const t=o.get(c);if(void 0!==t&&s(t,r))return;o.set(c,r)}const d=n.get(c);d&&d.forEach(t=>t(r));const l=t(e,r);a.forEach(t=>t(l))},forScope(t){const e=u(t);return(t,s)=>{const a=(t=>{let e=n.get(t);return e||(e=new Set,n.set(t,e)),e})(e),c=(t=>{let e=r.get(t);return e||(e=new Map,r.set(t,e)),e})(e);let u=t,d=()=>{};if(s){if($(s)){const e=new z(t,s);u=e.handle,d=()=>e.destroy()}else{const e=new k(t,s);u=e.handle,d=()=>e.destroy()}c.set(t,{wrapped:u,destroy:d})}if(i){const t=o.get(e);void 0!==t&&u(t)}return a.add(u),()=>{a.delete(u),d(),c.delete(t),0===a.size&&n.delete(e),0===c.size&&r.delete(e)}}},onGlobal:(t,e)=>{let i=t,s=()=>{};if(e){if($(e)){const o=new z(t,e);i=o.handle,s=()=>o.destroy()}else{const o=new k(t,e);i=o.handle,s=()=>o.destroy()}c.set(t,{wrapped:i,destroy:s})}return a.add(i),()=>{a.delete(i),s(),c.delete(t)}},getValue:t=>i?o.get(u(t)):void 0,getScopes:()=>i?Array.from(o.keys()):Array.from(n.keys()),clearScope(t){const e=u(t);i&&o.delete(e);const s=n.get(e);s&&(s.clear(),n.delete(e));const a=r.get(e);a&&(a.forEach(t=>t.destroy()),a.clear(),r.delete(e))},clear(){i&&o.clear(),n.forEach(t=>t.clear()),n.clear(),r.forEach(t=>{t.forEach(t=>t.destroy()),t.clear()}),r.clear(),a.clear(),c.forEach(t=>t.destroy()),c.clear()}}},exports.enumEntries=function(t){return Object.entries(t).map(([t,e])=>{const i=Number(t);return[Number.isFinite(i)&&""!==t.trim()?i:t,e]})},exports.getActiveDocumentState=t=>t.activeDocumentId?t.documents[t.activeDocumentId]??null:null,exports.getDocumentCount=t=>Object.keys(t.documents).length,exports.getDocumentIds=t=>Object.keys(t.documents),exports.getDocumentState=(t,e)=>t.documents[e]??null,exports.getEffectivePermission=_,exports.getEffectivePermissions=L,exports.getPermissionOverride=M,exports.hasAutoMountElements=function(t){return"autoMountElements"in t&&"function"==typeof t.autoMountElements},exports.initialCoreState=T,exports.isDocumentLoaded=(t,e)=>!!t.documents[e],exports.isKeyedOptions=$,exports.moveDocument=(t,e)=>({type:S,payload:{documentId:t,toIndex:e}}),exports.refreshDocument=(t,e)=>({type:b,payload:{documentId:t,document:e}}),exports.refreshPages=(t,e)=>({type:P,payload:{documentId:t,pageIndexes:e}}),exports.reorderDocuments=t=>({type:y,payload:t}),exports.retryLoadingDocument=(t,e)=>({type:p,payload:{documentId:t,passwordProvided:e}}),exports.setActiveDocument=t=>({type:f,payload:t}),exports.setDefaultRotation=t=>({type:I,payload:t}),exports.setDefaultScale=t=>({type:C,payload:t}),exports.setDocumentError=(t,e,i,s)=>({type:g,payload:{documentId:t,error:e,errorCode:i,errorDetails:s}}),exports.setDocumentLoaded=(t,e)=>({type:h,payload:{documentId:t,document:e}}),exports.setPages=(t,e)=>({type:E,payload:{documentId:t,pages:e}}),exports.setRotation=(t,e)=>({type:v,payload:{rotation:t,documentId:e}}),exports.setScale=(t,e)=>({type:D,payload:{scale:t,documentId:e}}),exports.startLoadingDocument=(t,e,i,s,o,n,r)=>({type:d,payload:{documentId:t,name:e,scale:i,rotation:s,passwordProvided:o,autoActivate:n,permissions:r}}),exports.updateDocumentLoadingProgress=(t,e)=>({type:l,payload:{documentId:t,progress:e}}),exports.updateDocumentSecurity=(t,e,i)=>({type:w,payload:{documentId:t,permissions:e,isOwnerUnlocked:i}});
-//# sourceMappingURL=index.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _embedpdf_engine_core_runtime = require("@embedpdf/engine-core/runtime");
+//#region src/types.ts
+/** Kernel-emitted document-lifecycle actions; plugins may react via `onAction`. */
+const CORE_DOCUMENT_ADDED = "@@core/document-added";
+const CORE_DOCUMENT_REMOVED = "@@core/document-removed";
+const CORE_ACTIVE_CHANGED = "@@core/active-changed";
+const CORE_ORDER_CHANGED = "@@core/order-changed";
+/** A document's page registry was replaced by a mutation event (rotate/move/delete). */
+const CORE_DOCUMENT_PAGES_UPDATED = "@@core/document-pages-updated";
+/** A tab slot was reserved: `open()` was called; the document is loading. */
+const CORE_DOCUMENT_OPENING = "@@core/document-opening";
+/** The engine reports the document needs a password (`documents.unlock`). */
+const CORE_DOCUMENT_LOCKED = "@@core/document-locked";
+/** The open failed; the tab stays with `status: 'error'` until closed. */
+const CORE_DOCUMENT_OPEN_FAILED = "@@core/document-open-failed";
+/** Field-wise DocInfo equality — the ONE definition every adapter's reactive
+*  `docs` read keys on, so a new lifecycle field can never silently stop
+*  re-rendering one framework's tab bar. */
+const docInfoEquals = (a, b) => a.id === b.id && a.name === b.name && a.status === b.status && a.pageCount === b.pageCount && a.passwordProvided === b.passwordProvided;
+const docInfoListEquals = (a, b) => a === b || a.length === b.length && a.every((d, i) => docInfoEquals(d, b[i]));
+/** Built-in token for the document registry capability (provided by the kernel). */
+const DocumentsToken = { name: "documents" };
+//#endregion
+//#region src/store.ts
+function createStore(report = console.error) {
+	let core = {
+		documents: {},
+		pending: {},
+		order: [],
+		activeId: null
+	};
+	const slices = {};
+	const reducers = {};
+	const changeListeners = /* @__PURE__ */ new Set();
+	const actionListeners = /* @__PURE__ */ new Set();
+	const guarded = (fn) => {
+		try {
+			fn();
+		} catch (error) {
+			report(error);
+		}
+	};
+	let emitting = false;
+	let pending = false;
+	const emitChange = () => {
+		if (emitting) {
+			pending = true;
+			return;
+		}
+		emitting = true;
+		try {
+			do {
+				pending = false;
+				changeListeners.forEach((listener) => guarded(listener));
+			} while (pending);
+		} finally {
+			emitting = false;
+		}
+	};
+	const emitAction = (action) => actionListeners.forEach((listener) => guarded(() => listener(action)));
+	return {
+		registerSlice(key, reducer, initial) {
+			reducers[key] = reducer;
+			slices[key] = initial;
+		},
+		removeSlice(key) {
+			delete reducers[key];
+			delete slices[key];
+			emitChange();
+		},
+		getSlice: (key) => slices[key],
+		getCore: () => core,
+		getState: () => ({
+			core,
+			plugins: slices
+		}),
+		dispatchTo(key, action) {
+			const r = reducers[key];
+			if (!r) return;
+			const next = r(slices[key], action);
+			if (next !== slices[key]) {
+				slices[key] = next;
+				emitChange();
+			}
+			emitAction(action);
+		},
+		setCore(patch, action) {
+			core = {
+				...core,
+				...patch
+			};
+			emitChange();
+			emitAction(action);
+		},
+		subscribe(listener) {
+			changeListeners.add(listener);
+			return () => void changeListeners.delete(listener);
+		},
+		subscribeAction(listener) {
+			actionListeners.add(listener);
+			return () => void actionListeners.delete(listener);
+		},
+		destroy() {
+			core = {
+				documents: {},
+				pending: {},
+				order: [],
+				activeId: null
+			};
+			for (const key of Object.keys(slices)) delete slices[key];
+			for (const key of Object.keys(reducers)) delete reducers[key];
+			changeListeners.clear();
+			actionListeners.clear();
+		}
+	};
+}
+//#endregion
+//#region src/context.ts
+/** A plugin's slice key. Workspace plugins use their id; document-scoped plugins are per-document. */
+const sliceKey = (pluginId, documentId) => documentId ? `${pluginId}::${documentId}` : pluginId;
+/**
+* Build the context a plugin sees. When `session` is given the context is bound
+* to that document — `getState`/`dispatch` target its slice, `document()` returns
+* it, and `get()` resolves document-scoped capabilities for it.
+*/
+function createPluginContext(services, plugin, session) {
+	const { engine, store } = services;
+	const documentId = session?.id;
+	const key = sliceKey(plugin.id, documentId);
+	const ownScope = session?.scope ?? services.workspaceScope;
+	return {
+		id: plugin.id,
+		engine,
+		documentId,
+		doc: session ? session.handle : services.documentHandle(void 0),
+		documentHandle: (requestedDocumentId) => requestedDocumentId ? services.documentHandle(requestedDocumentId) : session ? session.handle : services.documentHandle(void 0),
+		getState: () => store.getSlice(key),
+		dispatch: (action) => store.dispatchTo(key, action),
+		subscribe: store.subscribe,
+		core: store.getCore,
+		document: () => {
+			if (session) return store.getCore().documents[session.id] ?? session.stagedMeta;
+			const id = store.getCore().activeId;
+			return id ? store.getCore().documents[id] ?? null : null;
+		},
+		get: (token) => services.resolveCapability(token, documentId),
+		forDocument: (token, otherDocumentId) => services.resolveCapability(token, otherDocumentId),
+		tryGet: (token) => services.tryResolveCapability(token, documentId),
+		cleanup: (teardown) => ownScope.defer(teardown)
+	};
+}
+/** A plugin context plus the side-effect primitives (watch / onAction / cleanup). */
+function createEffectContext(services, plugin, session) {
+	const { store } = services;
+	const ownScope = session?.scope ?? services.workspaceScope;
+	return {
+		...createPluginContext(services, plugin, session),
+		watch: (select, handler, isEqual = Object.is) => {
+			let previous = select();
+			const unsubscribe = store.subscribe(() => {
+				const next = select();
+				if (!isEqual(previous, next)) {
+					const prior = previous;
+					previous = next;
+					handler(next, prior);
+				}
+			});
+			ownScope.defer(unsubscribe);
+			return unsubscribe;
+		},
+		onAction: (type, handler) => {
+			const unsubscribe = store.subscribeAction((action) => {
+				if (action.type === type) handler(action);
+			});
+			ownScope.defer(unsubscribe);
+			return unsubscribe;
+		}
+	};
+}
+//#endregion
+//#region src/order.ts
+/**
+* Validate `requires` (fail fast) and topologically sort plugins so dependencies
+* are initialised before dependents.
+*/
+function planPlugins(plugins) {
+	const providerByToken = /* @__PURE__ */ new Map();
+	const scopeByToken = /* @__PURE__ */ new Map([[DocumentsToken, "workspace"]]);
+	for (const plugin of plugins) if (plugin.token && plugin.capability) {
+		providerByToken.set(plugin.token, plugin);
+		scopeByToken.set(plugin.token, plugin.scope ?? "workspace");
+	}
+	for (const plugin of plugins) for (const required of plugin.requires ?? []) if (required !== DocumentsToken && !providerByToken.has(required)) throw new Error(`Plugin "${plugin.id}" requires capability "${required.name}", which no plugin provides.`);
+	const ordered = [];
+	const status = /* @__PURE__ */ new Map();
+	const visit = (plugin) => {
+		const state = status.get(plugin.id);
+		if (state === "done") return;
+		if (state === "visiting") throw new Error(`Dependency cycle involving plugin "${plugin.id}".`);
+		status.set(plugin.id, "visiting");
+		for (const token of [...plugin.requires ?? [], ...plugin.optional ?? []]) {
+			const dependency = providerByToken.get(token);
+			if (dependency && dependency !== plugin) visit(dependency);
+		}
+		status.set(plugin.id, "done");
+		ordered.push(plugin);
+	};
+	for (const plugin of plugins) visit(plugin);
+	return {
+		ordered,
+		providerOf: (token) => providerByToken.get(token),
+		scopeOf: (token) => scopeByToken.get(token) ?? "workspace"
+	};
+}
+//#endregion
+//#region src/scope.ts
+/**
+* A lifecycle operation was cancelled — the tab was closed mid-open, or the
+* kernel was destroyed mid-start. NOT a failure: callers that race `open()`
+* against `close()` should treat this rejection as "the close won".
+*/
+var CancelledError = class extends Error {
+	constructor(what) {
+		super(`[kernel] cancelled: ${what}`);
+		this.name = "CancelledError";
+	}
+};
+const isCancelled = (error) => error instanceof CancelledError;
+function createScope(report) {
+	const teardowns = [];
+	let disposal = null;
+	return {
+		get disposed() {
+			return disposal !== null;
+		},
+		defer(teardown) {
+			if (disposal) disposal.then(() => Promise.resolve().then(teardown).catch(report));
+			else teardowns.push(teardown);
+		},
+		dispose() {
+			return disposal ?? (disposal = (async () => {
+				while (teardowns.length) try {
+					await teardowns.pop()();
+				} catch (error) {
+					report(error);
+				}
+			})());
+		}
+	};
+}
+//#endregion
+//#region src/kernel.ts
+/** The new page registry a document mutation carries, or null for events that
+*  don't change page structure (annotations, metadata). The snapshot is the
+*  same shape `pages.list()` returns, so callers swap it in directly. */
+function layoutFromEvent(event) {
+	switch (event.type) {
+		case "pages.moved":
+		case "pages.rotated":
+		case "pages.deleted":
+		case "pages.inserted": return event.layout;
+		default: return null;
+	}
+}
+const isDocumentScoped = (plugin) => plugin.scope === "document";
+const initialStateOf = (plugin) => typeof plugin.initialState === "function" ? plugin.initialState() : plugin.initialState ?? {};
+const reducerOf = (plugin) => plugin.reduce ?? ((state) => state);
+const toDocInfo = (meta) => ({
+	id: meta.id,
+	name: meta.name,
+	status: "ready",
+	pageCount: meta.pageCount
+});
+const pendingToDocInfo = (meta) => ({
+	id: meta.id,
+	name: meta.name,
+	status: meta.status,
+	pageCount: 0,
+	passwordProvided: meta.passwordProvided
+});
+/** The stable id an input implies, if it carries one ('bytes'/'layerBytes'/'id'). */
+const idOfInput = (input) => "id" in input && typeof input.id === "string" ? input.id : null;
+const passwordOfInput = (input) => "password" in input ? input.password : void 0;
+/** Engine rejections carry AbortError when close() aborts the live call;
+*  match structurally so test fakes with plain promises still work. */
+const isAbortLike = (error) => error instanceof Error && error.name === "AbortError";
+/**
+* Assemble a kernel from an engine + plugins.
+*
+*   planPlugins        — validate dependencies, order them
+*   resolveCapability  — workspace singletons, or per-document instances built lazily
+*   document lifecycle — one DocumentSession per document: transactional open
+*                        (publish-last), one idempotent close for every phase
+*   start / destroy    — explicit status machine; destroy closes everything
+*
+* The kernel closes every handle it opened; it never destroys the engine —
+* ownership follows acquisition, and the engine was handed in by the caller.
+*/
+function createKernel(opts) {
+	const { engine, plugins } = opts;
+	const report = opts.report ?? ((error) => console.error("[kernel]", error));
+	const store = createStore(report);
+	const plan = planPlugins(plugins);
+	const documentScopedPlugins = plan.ordered.filter(isDocumentScoped);
+	const workspaceCapabilities = /* @__PURE__ */ new Map();
+	const workspaceScope = createScope(report);
+	const sessions = /* @__PURE__ */ new Map();
+	let status = "created";
+	let startPromise = null;
+	let destroyPromise = null;
+	const guardUsable = (what) => {
+		if (status === "failed" || status === "destroying" || status === "destroyed") throw new Error(`[kernel] ${what} on a ${status} kernel`);
+	};
+	const checkpoint = (session) => {
+		if (session.cancel.signal.aborted) throw new CancelledError(`closed while opening: ${session.id}`);
+	};
+	/**
+	* Await an engine/network call under the session's cancellation:
+	*   - the call is retained so close() can abort real worker-side work
+	*     (`AbortablePromise`), and
+	*   - the await RACES the cancellation, so close()'s join never blocks on a
+	*     call that cannot be aborted (a plain-promise engine, a stuck fetch).
+	* When cancellation wins but the call later lands anyway, `onLateResult`
+	* routes the result into the session scope — whose late-defer rule runs it
+	* immediately after disposal — so a late-arriving resource cannot leak.
+	* (Plugin inits are deliberately NOT raced: they are first-party code that
+	* close() joins to completion; only unbounded external waits are raced.)
+	*/
+	async function engineCall(session, call, onLateResult) {
+		const abortable = call;
+		session.engineOp = typeof abortable.abort === "function" ? abortable : null;
+		const signal = session.cancel.signal;
+		let onAbort;
+		const cancellation = new Promise((_, reject) => {
+			onAbort = () => reject(new CancelledError(`closed while opening: ${session.id}`));
+			if (signal.aborted) onAbort();
+			else signal.addEventListener("abort", onAbort, { once: true });
+		});
+		try {
+			return await Promise.race([call, cancellation]);
+		} catch (error) {
+			if (isCancelled(error)) call.then((value) => {
+				if (onLateResult) session.scope.defer(() => onLateResult(value));
+			}, () => {});
+			throw error;
+		} finally {
+			if (onAbort) signal.removeEventListener("abort", onAbort);
+			session.engineOp = null;
+		}
+	}
+	function createSession(id, name) {
+		const session = {
+			id,
+			name,
+			phase: "opening",
+			handle: null,
+			stagedMeta: null,
+			scope: createScope(report),
+			operation: null,
+			engineOp: null,
+			cancel: new AbortController(),
+			capabilities: /* @__PURE__ */ new Map(),
+			close: () => closeSession(session)
+		};
+		return session;
+	}
+	/** One transition at a time per session (open, then possibly unlock). */
+	function beginOperation(session, run) {
+		if (session.operation) throw new Error(`[documents] "${session.id}" already has an active transition`);
+		const operation = run().finally(() => {
+			if (session.operation === operation) session.operation = null;
+		});
+		session.operation = operation;
+		return operation;
+	}
+	/** Atomic ticket → real-id reconciliation: the sessions map, the store slot,
+	*  order position, and activation all move together, or not at all. */
+	function rekeySession(session, nextId) {
+		const previousId = session.id;
+		if (previousId === nextId) return;
+		const core = store.getCore();
+		if (sessions.has(nextId) || core.documents[nextId] || core.pending[nextId]) throw new Error(`[documents] duplicate document id: ${nextId}`);
+		sessions.delete(previousId);
+		session.id = nextId;
+		sessions.set(nextId, session);
+		const slot = core.pending[previousId];
+		if (slot) {
+			const { [previousId]: _moved, ...pending } = core.pending;
+			store.setCore({
+				pending: {
+					...pending,
+					[nextId]: {
+						...slot,
+						id: nextId
+					}
+				},
+				order: core.order.map((id) => id === previousId ? nextId : id),
+				activeId: core.activeId === previousId ? nextId : core.activeId
+			}, { type: CORE_ORDER_CHANGED });
+		}
+	}
+	const closingSessions = /* @__PURE__ */ new WeakMap();
+	function closeSession(session) {
+		const inFlight = closingSessions.get(session);
+		if (inFlight) return inFlight;
+		const closing = (async () => {
+			session.phase = "closing";
+			unpublishSlot(session.id);
+			const reason = new CancelledError(`closed while opening: ${session.id}`);
+			session.cancel.abort(reason);
+			session.engineOp?.abort(reason);
+			await session.operation?.catch((error) => {
+				if (!isCancelled(error) && !isAbortLike(error)) report(error);
+			});
+			await session.scope.dispose();
+			if (sessions.get(session.id) === session) sessions.delete(session.id);
+		})();
+		closingSessions.set(session, closing);
+		return closing;
+	}
+	function nextActiveDocument(core, removedId) {
+		if (core.activeId !== removedId) return core.activeId;
+		const index = core.order.indexOf(removedId);
+		const remaining = core.order.filter((id) => id !== removedId);
+		return remaining.length === 0 ? null : remaining[Math.max(0, index - 1)] ?? remaining[0];
+	}
+	function publishPendingSlot(session, activate) {
+		const core = store.getCore();
+		store.setCore({
+			pending: {
+				...core.pending,
+				[session.id]: {
+					id: session.id,
+					name: session.name,
+					status: "loading"
+				}
+			},
+			order: [...core.order, session.id],
+			activeId: activate || core.activeId === null ? session.id : core.activeId
+		}, { type: CORE_DOCUMENT_OPENING });
+	}
+	function publishLocked(session, passwordProvided) {
+		const core = store.getCore();
+		store.setCore({ pending: {
+			...core.pending,
+			[session.id]: {
+				id: session.id,
+				name: session.name,
+				status: "locked",
+				passwordProvided
+			}
+		} }, { type: CORE_DOCUMENT_LOCKED });
+	}
+	function publishError(session, error) {
+		const core = store.getCore();
+		store.setCore({ pending: {
+			...core.pending,
+			[session.id]: {
+				id: session.id,
+				name: session.name,
+				status: "error",
+				error
+			}
+		} }, { type: CORE_DOCUMENT_OPEN_FAILED });
+	}
+	function unpublishSlot(id) {
+		const core = store.getCore();
+		if (!core.pending[id] && !core.documents[id]) return;
+		const { [id]: _pending, ...pending } = core.pending;
+		const { [id]: _document, ...documents } = core.documents;
+		store.setCore({
+			pending,
+			documents,
+			order: core.order.filter((other) => other !== id),
+			activeId: nextActiveDocument(core, id)
+		}, { type: CORE_DOCUMENT_REMOVED });
+	}
+	/** The ONE ready transition: swap the pending slot for the staged meta and
+	*  fire CORE_DOCUMENT_ADDED. Everything before this is unpublished and rolls
+	*  back by disposing the session scope; nothing after this can fail. */
+	function commitReady(session) {
+		session.phase = "ready";
+		const meta = session.stagedMeta;
+		const core = store.getCore();
+		const { [session.id]: _resolved, ...pending } = core.pending;
+		store.setCore({
+			documents: {
+				...core.documents,
+				[session.id]: meta
+			},
+			pending
+		}, { type: CORE_DOCUMENT_ADDED });
+	}
+	const sessionOf = (documentId) => {
+		const id = documentId ?? store.getCore().activeId;
+		return id ? sessions.get(id) ?? null : null;
+	};
+	/** The handle plugins may touch: bring-up or ready — never locked, never
+	*  a handle whose close already won. */
+	const documentHandle = (documentId) => {
+		const session = sessionOf(documentId);
+		if (!session) return null;
+		return session.phase === "bringup" || session.phase === "ready" ? session.handle : null;
+	};
+	function buildDocumentCapability(plugin, session) {
+		let capability = session.capabilities.get(plugin);
+		if (!capability) {
+			capability = plugin.capability(createPluginContext(services, plugin, session));
+			session.capabilities.set(plugin, capability);
+		}
+		return capability;
+	}
+	function resolveCapability(token, documentId) {
+		guardUsable(`capability("${token.name}")`);
+		const workspaceCapability = workspaceCapabilities.get(token);
+		if (workspaceCapability) return workspaceCapability;
+		const provider = plan.providerOf(token);
+		if (!provider) throw new Error(`No capability "${token.name}".`);
+		const id = documentId ?? store.getCore().activeId;
+		if (!id) throw new Error(`Capability "${token.name}" requires an active document.`);
+		const session = sessions.get(id);
+		if (!session) throw new Error(`Capability "${token.name}" unavailable: no document "${id}".`);
+		if (session.phase === "bringup" || session.phase === "ready") return buildDocumentCapability(provider, session);
+		const shown = session.phase === "opening" ? "loading" : session.phase;
+		throw new Error(`Capability "${token.name}" unavailable: document "${id}" is ${shown}.`);
+	}
+	/** Internal total resolver: bring-up counts, so a plugin's `ctx.tryGet`
+	*  works during its own document's init. */
+	function tryResolveInternal(token, documentId) {
+		if (status === "destroying" || status === "destroyed") return null;
+		const workspaceCapability = workspaceCapabilities.get(token);
+		if (workspaceCapability) return workspaceCapability;
+		const provider = plan.providerOf(token);
+		if (!provider) return null;
+		const session = sessionOf(documentId);
+		if (!session || session.phase !== "bringup" && session.phase !== "ready") return null;
+		return buildDocumentCapability(provider, session);
+	}
+	/** Public total resolver — see `Kernel.tryCapability`. `ready` only: the
+	*  null→instance flip at commit time IS the adapters' re-render signal. */
+	function tryResolveCapability(token, documentId) {
+		if (status === "destroying" || status === "destroyed") return null;
+		const workspaceCapability = workspaceCapabilities.get(token);
+		if (workspaceCapability) return workspaceCapability;
+		const provider = plan.providerOf(token);
+		if (!provider) return null;
+		const session = sessionOf(documentId);
+		if (!session || session.phase !== "ready") return null;
+		return buildDocumentCapability(provider, session);
+	}
+	const services = {
+		engine,
+		store,
+		workspaceScope,
+		resolveCapability,
+		tryResolveCapability: tryResolveInternal,
+		documentHandle
+	};
+	let ticketCounter = 0;
+	const nextTicket = () => `pending:${++ticketCounter}`;
+	/** Slices + event subscription + plugin inits + effect SETUP — every step's
+	*  release deferred into the session scope, every await followed by a
+	*  checkpoint. Runs entirely pre-commit: a failure anywhere rolls the whole
+	*  session back and the document was never `ready`. */
+	async function bringUp(session, snapshot) {
+		session.phase = "bringup";
+		let renderPolicy = _embedpdf_engine_core_runtime.CONTINUOUS_RENDER_POLICY;
+		try {
+			renderPolicy = await session.handle.render?.policy() ?? _embedpdf_engine_core_runtime.CONTINUOUS_RENDER_POLICY;
+		} catch {}
+		checkpoint(session);
+		session.stagedMeta = {
+			id: session.id,
+			name: session.name,
+			pageCount: snapshot.pageCount,
+			pages: snapshot.pages,
+			revision: 0,
+			renderPolicy
+		};
+		const unsubscribeEvents = session.handle.events.subscribe((event) => {
+			const layout = layoutFromEvent(event);
+			if (!layout) return;
+			const now = store.getCore();
+			const existing = now.documents[session.id];
+			if (!existing) return;
+			const updated = {
+				...existing,
+				pageCount: layout.pageCount,
+				pages: layout.pages,
+				revision: existing.revision + 1
+			};
+			store.setCore({ documents: {
+				...now.documents,
+				[session.id]: updated
+			} }, { type: CORE_DOCUMENT_PAGES_UPDATED });
+		});
+		session.scope.defer(unsubscribeEvents);
+		for (const plugin of documentScopedPlugins) {
+			const key = sliceKey(plugin.id, session.id);
+			store.registerSlice(key, reducerOf(plugin), initialStateOf(plugin));
+			session.scope.defer(() => store.removeSlice(key));
+		}
+		for (const plugin of documentScopedPlugins) {
+			await plugin.init?.(createPluginContext(services, plugin, session));
+			checkpoint(session);
+		}
+		for (const plugin of documentScopedPlugins) plugin.effects?.(createEffectContext(services, plugin, session));
+		checkpoint(session);
+	}
+	async function openDocument(input, options) {
+		guardUsable("documents.open()");
+		const { activate, name, ...engineOptions } = options ?? {};
+		const requestedId = typeof input === "function" ? nextTicket() : idOfInput(input) ?? nextTicket();
+		if (sessions.has(requestedId)) throw new Error(`[documents] document already open: ${requestedId}`);
+		const session = createSession(requestedId, name);
+		sessions.set(session.id, session);
+		publishPendingSlot(session, activate ?? true);
+		return beginOperation(session, async () => {
+			try {
+				const source = typeof input === "function" ? await engineCall(session, Promise.resolve(input(session.cancel.signal))) : input;
+				checkpoint(session);
+				const sourceId = idOfInput(source);
+				if (sourceId) rekeySession(session, sourceId);
+				const handle = await engineCall(session, engine.open(source, engineOptions), (late) => late.close());
+				session.handle = handle;
+				session.scope.defer(() => handle.close());
+				checkpoint(session);
+				if (handle.id !== session.id) rekeySession(session, handle.id);
+				if (handle.security?.passwordPrompt?.state === "required") {
+					const passwordProvided = "password" in engineOptions && engineOptions.password != null || passwordOfInput(source) != null;
+					session.phase = "locked";
+					publishLocked(session, passwordProvided);
+					return session.id;
+				}
+				const snapshot = await engineCall(session, handle.pages.list());
+				checkpoint(session);
+				await bringUp(session, snapshot);
+				commitReady(session);
+				return session.id;
+			} catch (error) {
+				if (isCancelled(error)) throw error;
+				if (session.phase === "closing" || isAbortLike(error)) throw new CancelledError(`closed while opening: ${session.id}`);
+				await session.scope.dispose();
+				session.phase = "error";
+				publishError(session, error);
+				throw error;
+			}
+		});
+	}
+	async function unlockDocument(id, input) {
+		guardUsable("documents.unlock()");
+		const session = sessions.get(id);
+		if (!session || session.phase !== "locked" || !session.handle) throw new Error(`[documents] document is not locked: ${id}`);
+		const handle = session.handle;
+		return beginOperation(session, async () => {
+			try {
+				await engineCall(session, handle.security.unlock({ password: input.password }));
+			} catch (error) {
+				if (session.phase === "closing" || isAbortLike(error)) throw new CancelledError(`closed while opening: ${session.id}`);
+				throw error;
+			}
+			checkpoint(session);
+			try {
+				const snapshot = await engineCall(session, handle.pages.list());
+				checkpoint(session);
+				await bringUp(session, snapshot);
+				commitReady(session);
+			} catch (error) {
+				if (isCancelled(error)) throw error;
+				if (session.phase === "closing" || isAbortLike(error)) throw new CancelledError(`closed while opening: ${session.id}`);
+				await session.scope.dispose();
+				session.phase = "error";
+				publishError(session, error);
+				throw error;
+			}
+		});
+	}
+	async function closeDocument(documentId) {
+		const session = sessions.get(documentId);
+		if (!session) return;
+		await session.close();
+	}
+	function reorder(next) {
+		store.setCore({ order: next }, { type: CORE_ORDER_CHANGED });
+	}
+	const documents = {
+		open: openDocument,
+		openAll: (docs) => {
+			guardUsable("documents.openAll()");
+			const activeIndex = Math.max(0, docs.findIndex((d) => d.active));
+			docs.forEach(({ source, active: _active, ...options }, index) => {
+				openDocument(source, {
+					...options,
+					activate: index === activeIndex
+				}).catch(() => {});
+			});
+		},
+		unlock: unlockDocument,
+		close: closeDocument,
+		closeAll: async () => {
+			for (const id of [...store.getCore().order]) await closeDocument(id);
+		},
+		setActive: (id) => {
+			const core = store.getCore();
+			if (core.documents[id] || core.pending[id]) store.setCore({ activeId: id }, { type: CORE_ACTIVE_CHANGED });
+		},
+		activeId: () => store.getCore().activeId,
+		list: () => store.getCore().order.map((id) => {
+			const core = store.getCore();
+			const meta = core.documents[id];
+			return meta ? toDocInfo(meta) : pendingToDocInfo(core.pending[id]);
+		}),
+		get: (id) => {
+			const core = store.getCore();
+			const meta = core.documents[id];
+			if (meta) return toDocInfo(meta);
+			const pending = core.pending[id];
+			return pending ? pendingToDocInfo(pending) : null;
+		},
+		has: (id) => {
+			const core = store.getCore();
+			return core.documents[id] !== void 0 || core.pending[id] !== void 0;
+		},
+		count: () => store.getCore().order.length,
+		order: () => [...store.getCore().order],
+		move: (id, toIndex) => {
+			const core = store.getCore();
+			if (!core.documents[id] && !core.pending[id]) return;
+			const without = core.order.filter((x) => x !== id);
+			const clamped = Math.max(0, Math.min(toIndex, without.length));
+			without.splice(clamped, 0, id);
+			reorder(without);
+		},
+		swap: (a, b) => {
+			const core = store.getCore();
+			const indexA = core.order.indexOf(a);
+			const indexB = core.order.indexOf(b);
+			if (indexA < 0 || indexB < 0) return;
+			const next = [...core.order];
+			next[indexA] = b;
+			next[indexB] = a;
+			reorder(next);
+		},
+		download: (id, opts) => {
+			const handle = documentHandle(id);
+			if (!handle) return Promise.reject(/* @__PURE__ */ new Error("[documents] no document to download"));
+			return handle.download(opts);
+		},
+		downloadLayer: (id) => {
+			const handle = documentHandle(id);
+			if (!handle) return Promise.reject(/* @__PURE__ */ new Error("[documents] no document to download"));
+			if (!handle.downloadLayer) return Promise.reject(/* @__PURE__ */ new Error("[documents] this engine cannot export a layer (open with a layer on the local engine)"));
+			return handle.downloadLayer();
+		}
+	};
+	workspaceCapabilities.set(DocumentsToken, documents);
+	for (const plugin of plan.ordered) if (!isDocumentScoped(plugin)) store.registerSlice(plugin.id, reducerOf(plugin), initialStateOf(plugin));
+	for (const plugin of plan.ordered) if (!isDocumentScoped(plugin) && plugin.token && plugin.capability) workspaceCapabilities.set(plugin.token, plugin.capability(createPluginContext(services, plugin)));
+	return {
+		engine,
+		documents,
+		capability: resolveCapability,
+		tryCapability: tryResolveCapability,
+		scopeOf: plan.scopeOf,
+		subscribe: store.subscribe,
+		getState: store.getState,
+		status: () => status,
+		start: () => {
+			if (status === "destroying" || status === "destroyed" || status === "failed") return Promise.reject(/* @__PURE__ */ new Error(`[kernel] start() on a ${status} kernel`));
+			return startPromise ?? (startPromise = (async () => {
+				status = "starting";
+				try {
+					for (const plugin of plan.ordered) {
+						if (status !== "starting") return;
+						if (!isDocumentScoped(plugin)) await plugin.init?.(createPluginContext(services, plugin));
+					}
+					if (status !== "starting") return;
+					for (const plugin of plan.ordered) if (!isDocumentScoped(plugin)) plugin.effects?.(createEffectContext(services, plugin));
+					status = "started";
+				} catch (error) {
+					status = "failed";
+					await workspaceScope.dispose();
+					workspaceCapabilities.clear();
+					throw error;
+				}
+			})());
+		},
+		destroy: () => {
+			return destroyPromise ?? (destroyPromise = (async () => {
+				const wasFailed = status === "failed";
+				status = "destroying";
+				await startPromise?.catch((error) => {
+					if (!isCancelled(error) && !wasFailed) report(error);
+				});
+				await Promise.allSettled([...sessions.values()].map((session) => session.close()));
+				sessions.clear();
+				await workspaceScope.dispose();
+				workspaceCapabilities.clear();
+				store.destroy();
+				status = "destroyed";
+			})());
+		}
+	};
+}
+//#endregion
+//#region src/index.ts
+/** Create a typed capability token. `name` is for debugging only. */
+function createCapabilityToken(name) {
+	return { name };
+}
+/** Identity helper that pins a plugin's generics. The real win is inference. */
+function definePlugin(def) {
+	return def;
+}
+//#endregion
+Object.defineProperty(exports, "AbortablePromise", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_engine_core_runtime.AbortablePromise;
+	}
+});
+Object.defineProperty(exports, "CONTINUOUS_RENDER_POLICY", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_engine_core_runtime.CONTINUOUS_RENDER_POLICY;
+	}
+});
+exports.CORE_ACTIVE_CHANGED = CORE_ACTIVE_CHANGED;
+exports.CORE_DOCUMENT_ADDED = CORE_DOCUMENT_ADDED;
+exports.CORE_DOCUMENT_LOCKED = CORE_DOCUMENT_LOCKED;
+exports.CORE_DOCUMENT_OPENING = CORE_DOCUMENT_OPENING;
+exports.CORE_DOCUMENT_OPEN_FAILED = CORE_DOCUMENT_OPEN_FAILED;
+exports.CORE_DOCUMENT_PAGES_UPDATED = CORE_DOCUMENT_PAGES_UPDATED;
+exports.CORE_DOCUMENT_REMOVED = CORE_DOCUMENT_REMOVED;
+exports.CORE_ORDER_CHANGED = CORE_ORDER_CHANGED;
+exports.CancelledError = CancelledError;
+exports.DocumentsToken = DocumentsToken;
+exports.createCapabilityToken = createCapabilityToken;
+exports.createKernel = createKernel;
+exports.definePlugin = definePlugin;
+exports.docInfoEquals = docInfoEquals;
+exports.docInfoListEquals = docInfoListEquals;
+exports.isCancelled = isCancelled;
+Object.defineProperty(exports, "snapAppearanceScale", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_engine_core_runtime.snapAppearanceScale;
+	}
+});
+Object.defineProperty(exports, "snapFullPageViewport", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_engine_core_runtime.snapFullPageViewport;
+	}
+});
+Object.defineProperty(exports, "snapTileScale", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_engine_core_runtime.snapTileScale;
+	}
+});
+
+//# sourceMappingURL=index.cjs.map