@embedpdf/core 1.5.0 → 2.0.0-next.1

package/dist/lib/base/base-plugin.d.ts

@@ -2,6 +2,7 @@ import { IPlugin } from '../types/plugin';
 import { PluginRegistry } from '../registry/plugin-registry';
 import { Action, CoreAction, CoreState, PluginStore, Store, StoreState } from '../store';
 import { Logger, PdfEngine } from '@embedpdf/models';
+import { DocumentState } from '../store/initial-state';
 export interface StateChangeHandler<TState> {
     (state: TState): void;
 }
@@ -17,6 +18,11 @@ export declare abstract class BasePlugin<TConfig = unknown, TCapability = unknow
     private debouncedTimeouts;
     private unsubscribeFromState;
     private unsubscribeFromCoreStore;
+    private unsubscribeFromStartLoadingDocument;
+    private unsubscribeFromSetDocumentLoaded;
+    private unsubscribeFromCloseDocument;
+    private unsubscribeFromSetScale;
+    private unsubscribeFromSetRotation;
     private _capability?;
     private readyPromise;
     private readyResolve;
@@ -96,6 +102,31 @@ export declare abstract class BasePlugin<TConfig = unknown, TCapability = unknow
      * @param newState New state
      */
     protected onCoreStoreUpdated(oldState: StoreState<CoreState>, newState: StoreState<CoreState>): void;
+    /**
+     * Called when a document is opened
+     * Override to initialize per-document state
+     * @param documentId The ID of the document that was opened
+     */
+    protected onDocumentLoadingStarted(documentId: string): void;
+    /**
+     * Called when a document is loaded
+     * @param documentId The ID of the document that is loaded
+     */
+    protected onDocumentLoaded(documentId: string): void;
+    /**
+     * Called when a document is closed
+     * Override to cleanup per-document state
+     * @param documentId The ID of the document that was closed
+     */
+    protected onDocumentClosed(documentId: string): void;
+    /**
+     * Called when the active document changes
+     * @param previousId The ID of the previous active document
+     * @param currentId The ID of the new active document
+     */
+    protected onActiveDocumentChanged(previousId: string | null, currentId: string | null): void;
+    protected onScaleChanged(documentId: string, scale: number): void;
+    protected onRotationChanged(documentId: string, rotation: number): void;
     /**
      * Cleanup method to be called when plugin is being destroyed
      */
@@ -112,4 +143,25 @@ export declare abstract class BasePlugin<TConfig = unknown, TCapability = unknow
      * Reset the ready state (useful for plugins that need to reinitialize)
      */
     protected resetReady(): void;
+    /**
+     * Get the active document ID
+     * @throws Error if no active document exists
+     */
+    protected getActiveDocumentId(): string;
+    /**
+     * Get the active document ID or null if none exists
+     */
+    protected getActiveDocumentIdOrNull(): string | null;
+    /**
+     * Get core document state for a specific document
+     * @param documentId Document ID (optional, defaults to active document)
+     * @returns Document state or null if not found
+     */
+    protected getCoreDocument(documentId?: string): DocumentState | null;
+    /**
+     * Get core document state for a specific document
+     * @param documentId Document ID (optional, defaults to active document)
+     * @throws Error if document not found
+     */
+    protected getCoreDocumentOrThrow(documentId?: string): DocumentState;
 }

package/dist/lib/index.d.ts

@@ -10,6 +10,7 @@ export * from './store/initial-state';
 export * from './store/selectors';
 export * from './utils/event-control';
 export * from './utils/eventing';
+export * from './utils/scoped-eventing';
 export * from './utils/math';
 export * from './utils/typed-object';
 export * from './plugin/builder';

package/dist/lib/registry/plugin-registry.d.ts

@@ -51,9 +51,13 @@ export declare class PluginRegistry {
      */
     initialize(): Promise<void>;
     /**
-     * Initialize a single plugin with all necessary checks
+     * Phase 2: Create instance and register capabilities
      */
-    private initializePlugin;
+    private instantiatePlugin;
+    /**
+     * Phase 3: Run the initialize method
+     */
+    private runPluginInitialization;
     getPluginConfig<TConfig>(pluginId: string): TConfig;
     private validateConfig;
     updatePluginConfig<TConfig>(pluginId: string, config: Partial<TConfig>): Promise<void>;

package/dist/lib/store/actions.d.ts

@@ -1,51 +1,142 @@
-import { PdfDocumentObject, PdfPageObject, Rotation } from '@embedpdf/models';
-export declare const LOAD_DOCUMENT = "LOAD_DOCUMENT";
+import { PdfDocumentObject, PdfErrorCode, PdfPageObject, Rotation } from '@embedpdf/models';
+export declare const START_LOADING_DOCUMENT = "START_LOADING_DOCUMENT";
+export declare const UPDATE_DOCUMENT_LOADING_PROGRESS = "UPDATE_DOCUMENT_LOADING_PROGRESS";
+export declare const SET_DOCUMENT_LOADED = "SET_DOCUMENT_LOADED";
+export declare const SET_DOCUMENT_ERROR = "SET_DOCUMENT_ERROR";
+export declare const RETRY_LOADING_DOCUMENT = "RETRY_LOADING_DOCUMENT";
+export declare const CLOSE_DOCUMENT = "CLOSE_DOCUMENT";
+export declare const SET_ACTIVE_DOCUMENT = "SET_ACTIVE_DOCUMENT";
+export declare const REORDER_DOCUMENTS = "REORDER_DOCUMENTS";
+export declare const MOVE_DOCUMENT = "MOVE_DOCUMENT";
 export declare const REFRESH_DOCUMENT = "REFRESH_DOCUMENT";
 export declare const REFRESH_PAGES = "REFRESH_PAGES";
-export declare const SET_DOCUMENT = "SET_DOCUMENT";
-export declare const SET_DOCUMENT_ERROR = "SET_DOCUMENT_ERROR";
+export declare const SET_PAGES = "SET_PAGES";
 export declare const SET_SCALE = "SET_SCALE";
 export declare const SET_ROTATION = "SET_ROTATION";
-export declare const SET_PAGES = "SET_PAGES";
-export declare const CORE_ACTION_TYPES: readonly ["LOAD_DOCUMENT", "REFRESH_DOCUMENT", "SET_DOCUMENT", "SET_DOCUMENT_ERROR", "SET_SCALE", "SET_ROTATION", "SET_PAGES"];
-export interface LoadDocumentAction {
-    type: typeof LOAD_DOCUMENT;
+export declare const SET_DEFAULT_SCALE = "SET_DEFAULT_SCALE";
+export declare const SET_DEFAULT_ROTATION = "SET_DEFAULT_ROTATION";
+export declare const CORE_ACTION_TYPES: readonly ["START_LOADING_DOCUMENT", "UPDATE_DOCUMENT_LOADING_PROGRESS", "SET_DOCUMENT_LOADED", "CLOSE_DOCUMENT", "SET_ACTIVE_DOCUMENT", "SET_DOCUMENT_ERROR", "RETRY_LOADING_DOCUMENT", "REFRESH_DOCUMENT", "REFRESH_PAGES", "SET_PAGES", "SET_SCALE", "SET_ROTATION", "SET_DEFAULT_SCALE", "SET_DEFAULT_ROTATION", "REORDER_DOCUMENTS", "MOVE_DOCUMENT"];
+export interface StartLoadingDocumentAction {
+    type: typeof START_LOADING_DOCUMENT;
+    payload: {
+        documentId: string;
+        name?: string;
+        scale?: number;
+        rotation?: Rotation;
+        passwordProvided?: boolean;
+        autoActivate?: boolean;
+    };
+}
+export interface UpdateDocumentLoadingProgressAction {
+    type: typeof UPDATE_DOCUMENT_LOADING_PROGRESS;
+    payload: {
+        documentId: string;
+        progress: number;
+    };
+}
+export interface SetDocumentLoadedAction {
+    type: typeof SET_DOCUMENT_LOADED;
+    payload: {
+        documentId: string;
+        document: PdfDocumentObject;
+    };
+}
+export interface SetDocumentErrorAction {
+    type: typeof SET_DOCUMENT_ERROR;
+    payload: {
+        documentId: string;
+        error: string;
+        errorCode?: PdfErrorCode;
+        errorDetails?: any;
+    };
+}
+export interface RetryLoadingDocumentAction {
+    type: typeof RETRY_LOADING_DOCUMENT;
+    payload: {
+        documentId: string;
+        passwordProvided?: boolean;
+    };
+}
+export interface CloseDocumentAction {
+    type: typeof CLOSE_DOCUMENT;
+    payload: {
+        documentId: string;
+        nextActiveDocumentId?: string | null;
+    };
+}
+export interface SetActiveDocumentAction {
+    type: typeof SET_ACTIVE_DOCUMENT;
+    payload: string | null;
+}
+export interface ReorderDocumentsAction {
+    type: typeof REORDER_DOCUMENTS;
+    payload: string[];
+}
+export interface MoveDocumentAction {
+    type: typeof MOVE_DOCUMENT;
+    payload: {
+        documentId: string;
+        toIndex: number;
+    };
 }
 export interface RefreshDocumentAction {
     type: typeof REFRESH_DOCUMENT;
-    payload: PdfDocumentObject;
+    payload: {
+        documentId: string;
+        document: PdfDocumentObject;
+    };
 }
 export interface RefreshPagesAction {
     type: typeof REFRESH_PAGES;
-    payload: number[];
-}
-export interface SetDocumentAction {
-    type: typeof SET_DOCUMENT;
-    payload: PdfDocumentObject;
+    payload: {
+        documentId: string;
+        pageIndexes: number[];
+    };
 }
-export interface SetDocumentErrorAction {
-    type: typeof SET_DOCUMENT_ERROR;
-    payload: string;
+export interface SetPagesAction {
+    type: typeof SET_PAGES;
+    payload: {
+        documentId: string;
+        pages: PdfPageObject[][];
+    };
 }
 export interface SetScaleAction {
     type: typeof SET_SCALE;
-    payload: number;
+    payload: {
+        documentId?: string;
+        scale: number;
+    };
 }
 export interface SetRotationAction {
     type: typeof SET_ROTATION;
-    payload: Rotation;
+    payload: {
+        documentId?: string;
+        rotation: Rotation;
+    };
 }
-export interface SetPagesAction {
-    type: typeof SET_PAGES;
-    payload: PdfPageObject[][];
+export interface SetDefaultScaleAction {
+    type: typeof SET_DEFAULT_SCALE;
+    payload: number;
+}
+export interface SetDefaultRotationAction {
+    type: typeof SET_DEFAULT_ROTATION;
+    payload: Rotation;
 }
-export type DocumentAction = LoadDocumentAction | RefreshDocumentAction | RefreshPagesAction | SetDocumentAction | SetDocumentErrorAction | SetScaleAction | SetRotationAction | SetPagesAction;
+export type DocumentAction = StartLoadingDocumentAction | UpdateDocumentLoadingProgressAction | SetDocumentLoadedAction | SetDocumentErrorAction | RetryLoadingDocumentAction | CloseDocumentAction | SetActiveDocumentAction | RefreshDocumentAction | RefreshPagesAction | SetPagesAction | SetScaleAction | SetRotationAction | SetDefaultScaleAction | SetDefaultRotationAction | ReorderDocumentsAction | MoveDocumentAction;
 export type CoreAction = DocumentAction;
-export declare const loadDocument: () => CoreAction;
-export declare const refreshDocument: (document: PdfDocumentObject) => CoreAction;
-export declare const refreshPages: (pages: number[]) => CoreAction;
-export declare const setDocument: (document: PdfDocumentObject) => CoreAction;
-export declare const setDocumentError: (error: string) => CoreAction;
-export declare const setScale: (scale: number) => CoreAction;
-export declare const setRotation: (rotation: Rotation) => CoreAction;
-export declare const setPages: (pages: PdfPageObject[][]) => CoreAction;
+export declare const startLoadingDocument: (documentId: string, name?: string, scale?: number, rotation?: Rotation, passwordProvided?: boolean, autoActivate?: boolean) => CoreAction;
+export declare const updateDocumentLoadingProgress: (documentId: string, progress: number) => CoreAction;
+export declare const setDocumentLoaded: (documentId: string, document: PdfDocumentObject) => CoreAction;
+export declare const setDocumentError: (documentId: string, error: string, errorCode?: PdfErrorCode, errorDetails?: any) => CoreAction;
+export declare const retryLoadingDocument: (documentId: string, passwordProvided?: boolean) => CoreAction;
+export declare const closeDocument: (documentId: string, nextActiveDocumentId?: string | null) => CoreAction;
+export declare const setActiveDocument: (documentId: string | null) => CoreAction;
+export declare const refreshDocument: (documentId: string, document: PdfDocumentObject) => CoreAction;
+export declare const refreshPages: (documentId: string, pageIndexes: number[]) => CoreAction;
+export declare const setPages: (documentId: string, pages: PdfPageObject[][]) => CoreAction;
+export declare const setScale: (scale: number, documentId?: string) => CoreAction;
+export declare const setRotation: (rotation: Rotation, documentId?: string) => CoreAction;
+export declare const setDefaultScale: (scale: number) => CoreAction;
+export declare const setDefaultRotation: (rotation: Rotation) => CoreAction;
+export declare const reorderDocuments: (order: string[]) => CoreAction;
+export declare const moveDocument: (documentId: string, toIndex: number) => CoreAction;

package/dist/lib/store/initial-state.d.ts

@@ -1,11 +1,27 @@
-import { PdfDocumentObject, PdfPageObject, Rotation } from '@embedpdf/models';
+import { PdfDocumentObject, PdfErrorCode, Rotation } from '@embedpdf/models';
 import { PluginRegistryConfig } from '../types/plugin';
-export interface CoreState {
+export type DocumentStatus = 'loading' | 'loaded' | 'error';
+export interface DocumentState {
+    id: string;
+    name?: string;
+    status: DocumentStatus;
+    loadingProgress?: number;
+    error: string | null;
+    errorCode?: PdfErrorCode;
+    errorDetails?: any;
+    passwordProvided?: boolean;
+    document: PdfDocumentObject | null;
     scale: number;
     rotation: Rotation;
-    document: PdfDocumentObject | null;
-    pages: PdfPageObject[][];
-    loading: boolean;
-    error: string | null;
+    pageRefreshVersions: Record<number, number>;
+    loadStartedAt: number;
+    loadedAt?: number;
+}
+export interface CoreState {
+    documents: Record<string, DocumentState>;
+    documentOrder: string[];
+    activeDocumentId: string | null;
+    defaultScale: number;
+    defaultRotation: Rotation;
 }
 export declare const initialCoreState: (config?: PluginRegistryConfig) => CoreState;

package/dist/lib/store/reducer-helpers.d.ts

@@ -0,0 +1,11 @@
+import { CoreState } from './initial-state';
+/**
+ * Calculate the next active document when closing a document.
+ * Returns the document to activate, or null if no documents remain.
+ */
+export declare function calculateNextActiveDocument(state: CoreState, closingDocumentId: string, explicitNext?: string | null): string | null;
+/**
+ * Reorder a document within the documentOrder array.
+ * Returns the new order, or null if the operation is invalid.
+ */
+export declare function moveDocumentInOrder(currentOrder: string[], documentId: string, toIndex: number): string[] | null;

package/dist/lib/store/selectors.d.ts

@@ -1,3 +1,21 @@
-import { CoreState } from './initial-state';
-import { PdfPageObjectWithRotatedSize } from '@embedpdf/models';
-export declare const getPagesWithRotatedSize: (state: CoreState) => PdfPageObjectWithRotatedSize[][];
+import { CoreState, DocumentState } from './initial-state';
+/**
+ * Get the active document state
+ */
+export declare const getActiveDocumentState: (state: CoreState) => DocumentState | null;
+/**
+ * Get document state by ID
+ */
+export declare const getDocumentState: (state: CoreState, documentId: string) => DocumentState | null;
+/**
+ * Get all document IDs
+ */
+export declare const getDocumentIds: (state: CoreState) => string[];
+/**
+ * Check if a document is loaded
+ */
+export declare const isDocumentLoaded: (state: CoreState, documentId: string) => boolean;
+/**
+ * Get the number of open documents
+ */
+export declare const getDocumentCount: (state: CoreState) => number;

package/dist/lib/types/plugin.d.ts

@@ -14,8 +14,8 @@ export interface BasePluginConfig {
     enabled?: boolean;
 }
 export interface PluginRegistryConfig {
-    rotation?: Rotation;
-    scale?: number;
+    defaultRotation?: Rotation;
+    defaultScale?: number;
     logger?: Logger;
 }
 export interface PluginManifest<TConfig = unknown> {

package/dist/lib/utils/event-control.d.ts

@@ -9,15 +9,50 @@ export interface ThrottleOptions extends BaseEventControlOptions {
     mode: 'throttle';
     throttleMode?: 'leading-trailing' | 'trailing';
 }
-export type EventControlOptions = DebounceOptions | ThrottleOptions;
+export interface KeyedDebounceOptions<T> extends BaseEventControlOptions {
+    mode: 'debounce';
+    keyExtractor: (data: T) => string | number;
+}
+export interface KeyedThrottleOptions<T> extends BaseEventControlOptions {
+    mode: 'throttle';
+    throttleMode?: 'leading-trailing' | 'trailing';
+    keyExtractor: (data: T) => string | number;
+}
+export type EventControlOptions<T = any> = DebounceOptions | ThrottleOptions | KeyedDebounceOptions<T> | KeyedThrottleOptions<T>;
 export declare class EventControl<T> {
     private handler;
     private options;
     private timeoutId?;
     private lastRun;
-    constructor(handler: EventHandler<T>, options: EventControlOptions);
+    constructor(handler: EventHandler<T>, options: DebounceOptions | ThrottleOptions);
     handle: (data: T) => void;
     private debounce;
     private throttle;
     destroy(): void;
 }
+/**
+ * Event control with independent debouncing/throttling per key.
+ * Useful when events carry a discriminator (like documentId) and
+ * you want to debounce/throttle each key's events independently.
+ *
+ * @example
+ * // Debounce viewport resize events independently per document
+ * const control = new KeyedEventControl(
+ *   (event) => recalcZoom(event.documentId),
+ *   { mode: 'debounce', wait: 150, keyExtractor: (e) => e.documentId }
+ * );
+ * control.handle(event); // Each documentId gets its own 150ms debounce
+ */
+export declare class KeyedEventControl<T> {
+    private handler;
+    private options;
+    private controls;
+    private readonly baseOptions;
+    constructor(handler: EventHandler<T>, options: KeyedDebounceOptions<T> | KeyedThrottleOptions<T>);
+    handle: (data: T) => void;
+    destroy(): void;
+}
+/**
+ * Type guard to check if options are keyed
+ */
+export declare function isKeyedOptions<T>(options: EventControlOptions<T>): options is KeyedDebounceOptions<T> | KeyedThrottleOptions<T>;

package/dist/lib/utils/eventing.d.ts

@@ -1,7 +1,7 @@
 import { EventControlOptions } from './event-control';
 export type Listener<T = any> = (value: T) => void;
 export type Unsubscribe = () => void;
-export type EventListener<T> = ((listener: Listener<T>) => Unsubscribe) | ((listener: Listener<T>, options?: EventControlOptions) => Unsubscribe);
+export type EventListener<T> = ((listener: Listener<T>) => Unsubscribe) | ((listener: Listener<T>, options?: EventControlOptions<T>) => Unsubscribe);
 export type EventHook<T = any> = EventListener<T>;
 export interface Emitter<T = any> {
     emit(value?: T): void;

package/dist/lib/utils/scoped-eventing.d.ts

@@ -0,0 +1,71 @@
+import { EventHook } from './eventing';
+/**
+ * A scoped behavior emitter that maintains separate cached values
+ * and listener sets per scope key.
+ *
+ * @typeParam TData - The scoped data type (without key context)
+ * @typeParam TGlobalEvent - The global event type (includes key context)
+ * @typeParam TKey - The key type (string, number, or both)
+ */
+export interface ScopedEmitter<TData = any, TGlobalEvent = {
+    key: string;
+    data: TData;
+}, TKey extends string | number = string | number> {
+    /**
+     * Emit an event for a specific scope key.
+     */
+    emit(key: TKey, data: TData): void;
+    /**
+     * Get a scoped event hook that only receives events for this key.
+     */
+    forScope(key: TKey): EventHook<TData>;
+    /**
+     * Global event hook that receives events from all scopes.
+     */
+    readonly onGlobal: EventHook<TGlobalEvent>;
+    /**
+     * Clear all scopes' caches and listeners
+     */
+    clear(): void;
+    /**
+     * Clear a specific scope's cache and listeners
+     */
+    clearScope(key: TKey): void;
+    /**
+     * Get the current cached value for a specific scope
+     */
+    getValue(key: TKey): TData | undefined;
+    /**
+     * Get all active scope keys
+     */
+    getScopes(): TKey[];
+}
+/**
+ * Creates a scoped emitter with optional caching behavior.
+ *
+ * @param toGlobalEvent - Transform function to convert (key, data) into a global event
+ * @param options - Configuration options
+ * @param options.cache - Whether to cache values per scope (default: true)
+ * @param options.equality - Equality function for cached values (default: arePropsEqual)
+ *
+ * @example
+ * ```typescript
+ * // With caching (stateful) - default behavior
+ * const window$ = createScopedEmitter<WindowState, WindowChangeEvent, string>(
+ *   (documentId, window) => ({ documentId, window })
+ * );
+ *
+ * // Without caching (transient events)
+ * const refreshPages$ = createScopedEmitter<number[], RefreshPagesEvent, string>(
+ *   (documentId, pages) => ({ documentId, pages }),
+ *   { cache: false }
+ * );
+ * ```
+ */
+export declare function createScopedEmitter<TData = any, TGlobalEvent = {
+    key: string;
+    data: TData;
+}, TKey extends string | number = string | number>(toGlobalEvent: (key: TKey, data: TData) => TGlobalEvent, options?: {
+    cache?: boolean;
+    equality?: (a: TData, b: TData) => boolean;
+}): ScopedEmitter<TData, TGlobalEvent, TKey>;

package/dist/preact/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("preact"),t=require("preact/hooks"),r=require("preact/jsx-runtime"),i=require("@embedpdf/core"),n=e.createContext({registry:null,isInitializing:!0,pluginsReady:!1});function s({plugins:n,children:s}){const{utilities:o,wrappers:u}=t.useMemo((()=>{const e=[],t=[];for(const r of n){const n=r.package;if(i.hasAutoMountElements(n)){const r=n.autoMountElements()||[];for(const i of r)"utility"===i.type?e.push(i.component):"wrapper"===i.type&&t.push(i.component)}}return{utilities:e,wrappers:t}}),[n]),l=u.reduce(((e,t)=>r.jsx(t,{children:e})),s);return r.jsxs(e.Fragment,{children:[l,o.map(((e,t)=>r.jsx(e,{},`utility-${t}`)))]})}function o(){const e=t.useContext(n);if(void 0===e)throw new Error("useCapability must be used within a PDFContext.Provider");const{registry:r,isInitializing:i}=e;if(i)return e;if(null===r)throw new Error("PDF registry failed to initialize properly");return e}function u(e){const{registry:t}=o();if(null===t)return{plugin:null,isLoading:!0,ready:new Promise((()=>{}))};const r=t.getPlugin(e);if(!r)throw new Error(`Plugin ${e} not found`);return{plugin:r,isLoading:!1,ready:r.ready()}}exports.EmbedPDF=function({engine:e,logger:o,onInitialized:u,plugins:l,children:a,autoMountDomElements:c=!0}){const[g,p]=t.useState(null),[d,f]=t.useState(!0),[y,h]=t.useState(!1),x=t.useRef(u);t.useEffect((()=>{x.current=u}),[u]),t.useEffect((()=>{const t=new i.PluginRegistry(e,{logger:o});t.registerPluginBatch(l);return(async()=>{var e;await t.initialize(),t.isDestroyed()||(await(null==(e=x.current)?void 0:e.call(x,t)),t.isDestroyed()||(t.pluginsReady().then((()=>{t.isDestroyed()||h(!0)})),p(t),f(!1)))})().catch(console.error),()=>{t.destroy(),p(null),f(!0),h(!1)}}),[e,l]);const w="function"==typeof a?a({registry:g,isInitializing:d,pluginsReady:y}):a;return r.jsx(n.Provider,{value:{registry:g,isInitializing:d,pluginsReady:y},children:y&&c?r.jsx(s,{plugins:l,children:w}):w})},exports.PDFContext=n,exports.useCapability=function(e){const{plugin:t,isLoading:r,ready:i}=u(e);if(!t)return{provides:null,isLoading:r,ready:i};if(!t.provides)throw new Error(`Plugin ${e} does not provide a capability`);return{provides:t.provides(),isLoading:r,ready:i}},exports.useCoreState=function(){const{registry:e}=o(),[r,n]=t.useState(null);return t.useEffect((()=>{if(!e)return;const t=e.getStore();n(t.getState().core);const r=t.subscribe(((e,r,s)=>{t.isCoreAction(e)&&!i.arePropsEqual(r.core,s.core)&&n(r.core)}));return()=>r()}),[e]),r},exports.usePlugin=u,exports.useRegistry=o,exports.useStoreState=function(){const{registry:e}=o(),[r,i]=t.useState(null);return t.useEffect((()=>{if(!e)return;i(e.getStore().getState());const t=e.getStore().subscribe(((e,t)=>{i(t)}));return()=>t()}),[e]),r};
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("preact"),t=require("preact/hooks"),n=require("preact/jsx-runtime"),r=require("@embedpdf/core"),i=e.createContext({registry:null,coreState:null,isInitializing:!0,pluginsReady:!1,activeDocumentId:null,activeDocument:null,documents:{},documentStates:[]});function o({plugins:i,children:o}){const{utilities:u,wrappers:s}=t.useMemo(()=>{const e=[],t=[];for(const n of i){const i=n.package;if(r.hasAutoMountElements(i)){const n=i.autoMountElements()||[];for(const r of n)"utility"===r.type?e.push(r.component):"wrapper"===r.type&&t.push(r.component)}}return{utilities:e,wrappers:t}},[i]),l=s.reduce((e,t)=>n.jsx(t,{children:e}),o);return n.jsxs(e.Fragment,{children:[l,u.map((e,t)=>n.jsx(e,{},`utility-${t}`))]})}function u(){const e=t.useContext(i);if(void 0===e)throw new Error("useCapability must be used within a PDFContext.Provider");const{registry:n,isInitializing:r}=e;if(r)return e;if(null===n)throw new Error("PDF registry failed to initialize properly");return e}function s(e){const{registry:t}=u();if(null===t)return{plugin:null,isLoading:!0,ready:new Promise(()=>{})};const n=t.getPlugin(e);if(!n)throw new Error(`Plugin ${e} not found`);return{plugin:n,isLoading:!1,ready:n.ready()}}function l(){const{coreState:e}=t.useContext(i);return e}exports.EmbedPDF=function({engine:e,logger:u,onInitialized:s,plugins:l,children:c,autoMountDomElements:a=!0}){const[d,p]=t.useState(null),[g,f]=t.useState(null),[y,m]=t.useState(!0),[S,v]=t.useState(!1),x=t.useRef(s);t.useEffect(()=>{x.current=s},[s]),t.useEffect(()=>{const t=new r.PluginRegistry(e,{logger:u});t.registerPluginBatch(l);let n;return(async()=>{var e;if(await t.initialize(),t.isDestroyed())return;const n=t.getStore();f(n.getState().core);const r=n.subscribe((e,t,r)=>{n.isCoreAction(e)&&t.core!==r.core&&f(t.core)});if(await(null==(e=x.current)?void 0:e.call(x,t)),!t.isDestroyed())return t.pluginsReady().then(()=>{t.isDestroyed()||v(!0)}),p(t),m(!1),r;r()})().then(e=>{n=e}).catch(console.error),()=>{null==n||n(),t.destroy(),p(null),f(null),m(!0),v(!1)}},[e,l]);const h=t.useMemo(()=>{const e=(null==g?void 0:g.activeDocumentId)??null,t=(null==g?void 0:g.documents)??{},n=(null==g?void 0:g.documentOrder)??[],r=e&&t[e]?t[e]:null,i=n.map(e=>t[e]).filter(e=>null!=e);return{registry:d,coreState:g,isInitializing:y,pluginsReady:S,activeDocumentId:e,activeDocument:r,documents:t,documentStates:i}},[d,g,y,S]),w="function"==typeof c?c(h):c;return n.jsx(i.Provider,{value:h,children:S&&a?n.jsx(o,{plugins:l,children:w}):w})},exports.PDFContext=i,exports.useCapability=function(e){const{plugin:t,isLoading:n,ready:r}=s(e);if(!t)return{provides:null,isLoading:n,ready:r};if(!t.provides)throw new Error(`Plugin ${e} does not provide a capability`);return{provides:t.provides(),isLoading:n,ready:r}},exports.useCoreState=l,exports.useDocumentState=function(e){const n=l();return t.useMemo(()=>n&&e?n.documents[e]??null:null,[n,e])},exports.usePlugin=s,exports.useRegistry=u,exports.useStoreState=function(){const{registry:e}=u(),[n,r]=t.useState(null);return t.useEffect(()=>{if(!e)return;r(e.getStore().getState());const t=e.getStore().subscribe((e,t)=>{r(t)});return()=>t()},[e]),n};
 //# sourceMappingURL=index.cjs.map

package/dist/preact/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../src/shared/context.ts","../../src/shared/components/auto-mount.tsx","../../src/shared/hooks/use-registry.ts","../../src/shared/hooks/use-plugin.ts","../../src/shared/components/embed-pdf.tsx","../../src/shared/hooks/use-capability.ts","../../src/shared/hooks/use-core-state.ts","../../src/shared/hooks/use-store-state.ts"],"sourcesContent":["import { createContext } from '@framework';\nimport type { PluginRegistry } from '@embedpdf/core';\n\nexport interface PDFContextState {\n  registry: PluginRegistry | null;\n  isInitializing: boolean;\n  pluginsReady: boolean;\n}\n\nexport const PDFContext = createContext<PDFContextState>({\n  registry: null,\n  isInitializing: true,\n  pluginsReady: false,\n});\n","import { Fragment, useMemo, ComponentType, ReactNode } from '@framework';\nimport { hasAutoMountElements } from '@embedpdf/core';\nimport type { PluginBatchRegistration, IPlugin } from '@embedpdf/core';\n\ninterface AutoMountProps {\n  plugins: PluginBatchRegistration<IPlugin<any>, any>[];\n  children: ReactNode;\n}\n\nexport function AutoMount({ plugins, children }: AutoMountProps) {\n  const { utilities, wrappers } = useMemo(() => {\n    // React-specific types for internal use\n    const utilities: ComponentType[] = [];\n    const wrappers: ComponentType<{ children: ReactNode }>[] = [];\n\n    for (const reg of plugins) {\n      const pkg = reg.package;\n      if (hasAutoMountElements(pkg)) {\n        const elements = pkg.autoMountElements() || [];\n\n        for (const element of elements) {\n          if (element.type === 'utility') {\n            utilities.push(element.component);\n          } else if (element.type === 'wrapper') {\n            // In React context, we know wrappers need children\n            wrappers.push(element.component);\n          }\n        }\n      }\n    }\n    return { utilities, wrappers };\n  }, [plugins]);\n\n  // React-specific wrapping logic\n  const wrappedContent = wrappers.reduce(\n    (content, Wrapper) => <Wrapper>{content}</Wrapper>,\n    children,\n  );\n\n  return (\n    <Fragment>\n      {wrappedContent}\n      {utilities.map((Utility, i) => (\n        <Utility key={`utility-${i}`} />\n      ))}\n    </Fragment>\n  );\n}\n","import { useContext } from '@framework';\nimport { PDFContext, PDFContextState } from '../context';\n\n/**\n * Hook to access the PDF registry.\n * @returns The PDF registry or null during initialization\n */\nexport function useRegistry(): PDFContextState {\n  const contextValue = useContext(PDFContext);\n\n  // Error if used outside of context\n  if (contextValue === undefined) {\n    throw new Error('useCapability must be used within a PDFContext.Provider');\n  }\n\n  const { registry, isInitializing } = contextValue;\n\n  // During initialization, return null instead of throwing an error\n  if (isInitializing) {\n    return contextValue;\n  }\n\n  // At this point, initialization is complete but registry is still null, which is unexpected\n  if (registry === null) {\n    throw new Error('PDF registry failed to initialize properly');\n  }\n\n  return contextValue;\n}\n","import type { BasePlugin } from '@embedpdf/core';\nimport { useRegistry } from './use-registry';\n\ntype PluginState<T extends BasePlugin> = {\n  plugin: T | null;\n  isLoading: boolean;\n  ready: Promise<void>;\n};\n\n/**\n * Hook to access a plugin.\n * @param pluginId The ID of the plugin to access\n * @returns The plugin or null during initialization\n * @example\n * // Get zoom plugin\n * const zoom = usePlugin<ZoomPlugin>(ZoomPlugin.id);\n */\nexport function usePlugin<T extends BasePlugin>(pluginId: T['id']): PluginState<T> {\n  const { registry } = useRegistry();\n\n  if (registry === null) {\n    return {\n      plugin: null,\n      isLoading: true,\n      ready: new Promise(() => {}),\n    };\n  }\n\n  const plugin = registry.getPlugin<T>(pluginId);\n\n  if (!plugin) {\n    throw new Error(`Plugin ${pluginId} not found`);\n  }\n\n  return {\n    plugin,\n    isLoading: false,\n    ready: plugin.ready(),\n  };\n}\n","import { useState, useEffect, useRef, ReactNode } from '@framework';\nimport { Logger, PdfEngine } from '@embedpdf/models';\nimport { PluginRegistry } from '@embedpdf/core';\nimport type { PluginBatchRegistrations } from '@embedpdf/core';\n\nimport { PDFContext, PDFContextState } from '../context';\nimport { AutoMount } from './auto-mount';\n\nexport type { PluginBatchRegistrations };\n\ninterface EmbedPDFProps {\n  /**\n   * The PDF engine to use for the PDF viewer.\n   */\n  engine: PdfEngine;\n  /**\n   * The logger to use for the PDF viewer.\n   */\n  logger?: Logger;\n  /**\n   * The callback to call when the PDF viewer is initialized.\n   */\n  onInitialized?: (registry: PluginRegistry) => Promise<void>;\n  /**\n   * The plugins to use for the PDF viewer.\n   */\n  plugins: PluginBatchRegistrations;\n  /**\n   * The children to render for the PDF viewer.\n   */\n  children: ReactNode | ((state: PDFContextState) => ReactNode);\n  /**\n   * Whether to auto-mount specific non-visual DOM elements from plugins.\n   * @default true\n   */\n  autoMountDomElements?: boolean;\n}\n\nexport function EmbedPDF({\n  engine,\n  logger,\n  onInitialized,\n  plugins,\n  children,\n  autoMountDomElements = true,\n}: EmbedPDFProps) {\n  const [registry, setRegistry] = useState<PluginRegistry | null>(null);\n  const [isInitializing, setIsInitializing] = useState<boolean>(true);\n  const [pluginsReady, setPluginsReady] = useState<boolean>(false);\n  const initRef = useRef<EmbedPDFProps['onInitialized']>(onInitialized);\n\n  useEffect(() => {\n    initRef.current = onInitialized; // update without triggering re-runs\n  }, [onInitialized]);\n\n  useEffect(() => {\n    const pdfViewer = new PluginRegistry(engine, { logger });\n    pdfViewer.registerPluginBatch(plugins);\n\n    const initialize = async () => {\n      await pdfViewer.initialize();\n      // if the registry is destroyed, don't do anything\n      if (pdfViewer.isDestroyed()) {\n        return;\n      }\n\n      /* always call the *latest* callback */\n      await initRef.current?.(pdfViewer);\n\n      // if the registry is destroyed, don't do anything\n      if (pdfViewer.isDestroyed()) {\n        return;\n      }\n\n      pdfViewer.pluginsReady().then(() => {\n        if (!pdfViewer.isDestroyed()) {\n          setPluginsReady(true);\n        }\n      });\n\n      // Provide the registry to children via context\n      setRegistry(pdfViewer);\n      setIsInitializing(false);\n    };\n\n    initialize().catch(console.error);\n\n    return () => {\n      pdfViewer.destroy();\n      setRegistry(null);\n      setIsInitializing(true);\n      setPluginsReady(false);\n    };\n  }, [engine, plugins]);\n\n  const content =\n    typeof children === 'function'\n      ? children({ registry, isInitializing, pluginsReady })\n      : children;\n\n  return (\n    <PDFContext.Provider value={{ registry, isInitializing, pluginsReady }}>\n      {pluginsReady && autoMountDomElements ? (\n        <AutoMount plugins={plugins}>{content}</AutoMount>\n      ) : (\n        content\n      )}\n    </PDFContext.Provider>\n  );\n}\n","import type { BasePlugin } from '@embedpdf/core';\nimport { usePlugin } from './use-plugin';\n\ntype CapabilityState<T extends BasePlugin> = {\n  provides: ReturnType<NonNullable<T['provides']>> | null;\n  isLoading: boolean;\n  ready: Promise<void>;\n};\n\n/**\n * Hook to access a plugin's capability.\n * @param pluginId The ID of the plugin to access\n * @returns The capability provided by the plugin or null during initialization\n * @example\n * // Get zoom capability\n * const zoom = useCapability<ZoomPlugin>(ZoomPlugin.id);\n */\nexport function useCapability<T extends BasePlugin>(pluginId: T['id']): CapabilityState<T> {\n  const { plugin, isLoading, ready } = usePlugin<T>(pluginId);\n\n  if (!plugin) {\n    return {\n      provides: null,\n      isLoading,\n      ready,\n    };\n  }\n\n  if (!plugin.provides) {\n    throw new Error(`Plugin ${pluginId} does not provide a capability`);\n  }\n\n  return {\n    provides: plugin.provides() as ReturnType<NonNullable<T['provides']>>,\n    isLoading,\n    ready,\n  };\n}\n","import { useState, useEffect } from '@framework';\nimport { CoreState, arePropsEqual } from '@embedpdf/core';\nimport { useRegistry } from './use-registry';\n\n/**\n * Hook that provides access to the current core state\n * and re-renders the component only when the core state changes\n */\nexport function useCoreState(): CoreState | null {\n  const { registry } = useRegistry();\n  const [coreState, setCoreState] = useState<CoreState | null>(null);\n\n  useEffect(() => {\n    if (!registry) return;\n\n    const store = registry.getStore();\n\n    // Get initial core state\n    setCoreState(store.getState().core);\n\n    // Create a single subscription that handles all core actions\n    const unsubscribe = store.subscribe((action, newState, oldState) => {\n      // Only update if it's a core action and the core state changed\n      if (store.isCoreAction(action) && !arePropsEqual(newState.core, oldState.core)) {\n        setCoreState(newState.core);\n      }\n    });\n\n    return () => unsubscribe();\n  }, [registry]);\n\n  return coreState;\n}\n","import { useState, useEffect } from '@framework';\nimport { CoreState, StoreState } from '@embedpdf/core';\nimport { useRegistry } from './use-registry';\n\n/**\n * Hook that provides access to the current global store state\n * and re-renders the component when the state changes\n */\nexport function useStoreState<T = CoreState>(): StoreState<T> | null {\n  const { registry } = useRegistry();\n  const [state, setState] = useState<StoreState<T> | null>(null);\n\n  useEffect(() => {\n    if (!registry) return;\n\n    // Get initial state\n    setState(registry.getStore().getState() as StoreState<T>);\n\n    // Subscribe to store changes\n    const unsubscribe = registry.getStore().subscribe((_action, newState) => {\n      setState(newState as StoreState<T>);\n    });\n\n    return () => unsubscribe();\n  }, [registry]);\n\n  return state;\n}\n"],"names":["PDFContext","createContext","registry","isInitializing","pluginsReady","AutoMount","plugins","children","utilities","wrappers","useMemo","reg","pkg","package","hasAutoMountElements","elements","autoMountElements","element","type","utilities2","push","component","wrappers2","wrappedContent","reduce","content","Wrapper","jsx","Fragment","map","Utility","i","useRegistry","contextValue","useContext","Error","usePlugin","pluginId","plugin","isLoading","ready","Promise","getPlugin","engine","logger","onInitialized","autoMountDomElements","setRegistry","useState","setIsInitializing","setPluginsReady","initRef","useRef","useEffect","current","pdfViewer","PluginRegistry","registerPluginBatch","async","initialize","isDestroyed","_a","call","then","catch","console","error","destroy","Provider","value","provides","coreState","setCoreState","store","getStore","getState","core","unsubscribe","subscribe","action","newState","oldState","isCoreAction","arePropsEqual","state","setState","_action"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../src/shared/context.ts","../../src/shared/components/auto-mount.tsx","../../src/shared/hooks/use-registry.ts","../../src/shared/hooks/use-plugin.ts","../../src/shared/hooks/use-core-state.ts","../../src/shared/components/embed-pdf.tsx","../../src/shared/hooks/use-capability.ts","../../src/shared/hooks/use-document-state.ts","../../src/shared/hooks/use-store-state.ts"],"sourcesContent":["import { createContext } from '@framework';\nimport type { CoreState, DocumentState, PluginRegistry } from '@embedpdf/core';\n\nexport interface PDFContextState {\n  registry: PluginRegistry | null;\n  coreState: CoreState | null;\n  isInitializing: boolean;\n  pluginsReady: boolean;\n\n  // Convenience accessors (always safe to use)\n  activeDocumentId: string | null;\n  activeDocument: DocumentState | null;\n  documents: Record<string, DocumentState>;\n  documentStates: DocumentState[];\n}\n\nexport const PDFContext = createContext<PDFContextState>({\n  registry: null,\n  coreState: null,\n  isInitializing: true,\n  pluginsReady: false,\n  activeDocumentId: null,\n  activeDocument: null,\n  documents: {},\n  documentStates: [],\n});\n","import { Fragment, useMemo, ComponentType, ReactNode } from '@framework';\nimport { hasAutoMountElements } from '@embedpdf/core';\nimport type { PluginBatchRegistration, IPlugin } from '@embedpdf/core';\n\ninterface AutoMountProps {\n  plugins: PluginBatchRegistration<IPlugin<any>, any>[];\n  children: ReactNode;\n}\n\nexport function AutoMount({ plugins, children }: AutoMountProps) {\n  const { utilities, wrappers } = useMemo(() => {\n    // React-specific types for internal use\n    const utilities: ComponentType[] = [];\n    const wrappers: ComponentType<{ children: ReactNode }>[] = [];\n\n    for (const reg of plugins) {\n      const pkg = reg.package;\n      if (hasAutoMountElements(pkg)) {\n        const elements = pkg.autoMountElements() || [];\n\n        for (const element of elements) {\n          if (element.type === 'utility') {\n            utilities.push(element.component);\n          } else if (element.type === 'wrapper') {\n            // In React context, we know wrappers need children\n            wrappers.push(element.component);\n          }\n        }\n      }\n    }\n    return { utilities, wrappers };\n  }, [plugins]);\n\n  // React-specific wrapping logic\n  const wrappedContent = wrappers.reduce(\n    (content, Wrapper) => <Wrapper>{content}</Wrapper>,\n    children,\n  );\n\n  return (\n    <Fragment>\n      {wrappedContent}\n      {utilities.map((Utility, i) => (\n        <Utility key={`utility-${i}`} />\n      ))}\n    </Fragment>\n  );\n}\n","import { useContext } from '@framework';\nimport { PDFContext, PDFContextState } from '../context';\n\n/**\n * Hook to access the PDF registry.\n * @returns The PDF registry or null during initialization\n */\nexport function useRegistry(): PDFContextState {\n  const contextValue = useContext(PDFContext);\n\n  // Error if used outside of context\n  if (contextValue === undefined) {\n    throw new Error('useCapability must be used within a PDFContext.Provider');\n  }\n\n  const { registry, isInitializing } = contextValue;\n\n  // During initialization, return null instead of throwing an error\n  if (isInitializing) {\n    return contextValue;\n  }\n\n  // At this point, initialization is complete but registry is still null, which is unexpected\n  if (registry === null) {\n    throw new Error('PDF registry failed to initialize properly');\n  }\n\n  return contextValue;\n}\n","import type { BasePlugin } from '@embedpdf/core';\nimport { useRegistry } from './use-registry';\n\ntype PluginState<T extends BasePlugin> = {\n  plugin: T | null;\n  isLoading: boolean;\n  ready: Promise<void>;\n};\n\n/**\n * Hook to access a plugin.\n * @param pluginId The ID of the plugin to access\n * @returns The plugin or null during initialization\n * @example\n * // Get zoom plugin\n * const zoom = usePlugin<ZoomPlugin>(ZoomPlugin.id);\n */\nexport function usePlugin<T extends BasePlugin>(pluginId: T['id']): PluginState<T> {\n  const { registry } = useRegistry();\n\n  if (registry === null) {\n    return {\n      plugin: null,\n      isLoading: true,\n      ready: new Promise(() => {}),\n    };\n  }\n\n  const plugin = registry.getPlugin<T>(pluginId);\n\n  if (!plugin) {\n    throw new Error(`Plugin ${pluginId} not found`);\n  }\n\n  return {\n    plugin,\n    isLoading: false,\n    ready: plugin.ready(),\n  };\n}\n","import { useContext } from '@framework';\nimport { CoreState } from '@embedpdf/core';\nimport { PDFContext } from '../context';\n\n/**\n * Hook that provides access to the current core state.\n *\n * Note: This reads from the context which is already subscribed to core state changes\n * in the EmbedPDF component, so there's no additional subscription overhead.\n */\nexport function useCoreState(): CoreState | null {\n  const { coreState } = useContext(PDFContext);\n  return coreState;\n}\n","import { useState, useEffect, useRef, useMemo, ReactNode } from '@framework';\nimport { Logger, PdfEngine } from '@embedpdf/models';\nimport { PluginRegistry, CoreState, DocumentState } from '@embedpdf/core';\nimport type { PluginBatchRegistrations } from '@embedpdf/core';\n\nimport { PDFContext, PDFContextState } from '../context';\nimport { AutoMount } from './auto-mount';\n\nexport type { PluginBatchRegistrations };\n\ninterface EmbedPDFProps {\n  /**\n   * The PDF engine to use for the PDF viewer.\n   */\n  engine: PdfEngine;\n  /**\n   * The logger to use for the PDF viewer.\n   */\n  logger?: Logger;\n  /**\n   * The callback to call when the PDF viewer is initialized.\n   */\n  onInitialized?: (registry: PluginRegistry) => Promise<void>;\n  /**\n   * The plugins to use for the PDF viewer.\n   */\n  plugins: PluginBatchRegistrations;\n  /**\n   * The children to render for the PDF viewer.\n   */\n  children: ReactNode | ((state: PDFContextState) => ReactNode);\n  /**\n   * Whether to auto-mount specific non-visual DOM elements from plugins.\n   * @default true\n   */\n  autoMountDomElements?: boolean;\n}\n\nexport function EmbedPDF({\n  engine,\n  logger,\n  onInitialized,\n  plugins,\n  children,\n  autoMountDomElements = true,\n}: EmbedPDFProps) {\n  const [registry, setRegistry] = useState<PluginRegistry | null>(null);\n  const [coreState, setCoreState] = useState<CoreState | null>(null);\n  const [isInitializing, setIsInitializing] = useState<boolean>(true);\n  const [pluginsReady, setPluginsReady] = useState<boolean>(false);\n  const initRef = useRef<EmbedPDFProps['onInitialized']>(onInitialized);\n\n  useEffect(() => {\n    initRef.current = onInitialized;\n  }, [onInitialized]);\n\n  useEffect(() => {\n    const pdfViewer = new PluginRegistry(engine, { logger });\n    pdfViewer.registerPluginBatch(plugins);\n\n    const initialize = async () => {\n      await pdfViewer.initialize();\n\n      if (pdfViewer.isDestroyed()) {\n        return;\n      }\n\n      const store = pdfViewer.getStore();\n      setCoreState(store.getState().core);\n\n      const unsubscribe = store.subscribe((action, newState, oldState) => {\n        // Only update if it's a core action and the core state changed\n        if (store.isCoreAction(action) && newState.core !== oldState.core) {\n          setCoreState(newState.core);\n        }\n      });\n\n      /* always call the *latest* callback */\n      await initRef.current?.(pdfViewer);\n\n      if (pdfViewer.isDestroyed()) {\n        unsubscribe();\n        return;\n      }\n\n      pdfViewer.pluginsReady().then(() => {\n        if (!pdfViewer.isDestroyed()) {\n          setPluginsReady(true);\n        }\n      });\n\n      // Provide the registry to children via context\n      setRegistry(pdfViewer);\n      setIsInitializing(false);\n\n      // Return cleanup function\n      return unsubscribe;\n    };\n\n    let cleanup: (() => void) | undefined;\n    initialize()\n      .then((unsub) => {\n        cleanup = unsub;\n      })\n      .catch(console.error);\n\n    return () => {\n      cleanup?.();\n      pdfViewer.destroy();\n      setRegistry(null);\n      setCoreState(null);\n      setIsInitializing(true);\n      setPluginsReady(false);\n    };\n  }, [engine, plugins]);\n\n  // Compute convenience accessors\n  const contextValue: PDFContextState = useMemo(() => {\n    const activeDocumentId = coreState?.activeDocumentId ?? null;\n    const documents = coreState?.documents ?? {};\n    const documentOrder = coreState?.documentOrder ?? [];\n\n    // Compute active document\n    const activeDocument =\n      activeDocumentId && documents[activeDocumentId] ? documents[activeDocumentId] : null;\n\n    // Compute open documents in order\n    const documentStates = documentOrder\n      .map((docId) => documents[docId])\n      .filter((doc): doc is DocumentState => doc !== null && doc !== undefined);\n\n    return {\n      registry,\n      coreState,\n      isInitializing,\n      pluginsReady,\n      // Convenience accessors (always safe to use)\n      activeDocumentId,\n      activeDocument,\n      documents,\n      documentStates,\n    };\n  }, [registry, coreState, isInitializing, pluginsReady]);\n\n  const content = typeof children === 'function' ? children(contextValue) : children;\n\n  return (\n    <PDFContext.Provider value={contextValue}>\n      {pluginsReady && autoMountDomElements ? (\n        <AutoMount plugins={plugins}>{content}</AutoMount>\n      ) : (\n        content\n      )}\n    </PDFContext.Provider>\n  );\n}\n","import type { BasePlugin } from '@embedpdf/core';\nimport { usePlugin } from './use-plugin';\n\ntype CapabilityState<T extends BasePlugin> = {\n  provides: ReturnType<NonNullable<T['provides']>> | null;\n  isLoading: boolean;\n  ready: Promise<void>;\n};\n\n/**\n * Hook to access a plugin's capability.\n * @param pluginId The ID of the plugin to access\n * @returns The capability provided by the plugin or null during initialization\n * @example\n * // Get zoom capability\n * const zoom = useCapability<ZoomPlugin>(ZoomPlugin.id);\n */\nexport function useCapability<T extends BasePlugin>(pluginId: T['id']): CapabilityState<T> {\n  const { plugin, isLoading, ready } = usePlugin<T>(pluginId);\n\n  if (!plugin) {\n    return {\n      provides: null,\n      isLoading,\n      ready,\n    };\n  }\n\n  if (!plugin.provides) {\n    throw new Error(`Plugin ${pluginId} does not provide a capability`);\n  }\n\n  return {\n    provides: plugin.provides() as ReturnType<NonNullable<T['provides']>>,\n    isLoading,\n    ready,\n  };\n}\n","import { useMemo } from '@framework';\nimport { DocumentState } from '@embedpdf/core';\nimport { useCoreState } from './use-core-state';\n\n/**\n * Hook that provides reactive access to a specific document's state from the core store.\n *\n * @param documentId The ID of the document to retrieve.\n * @returns The reactive DocumentState object or null if not found.\n */\nexport function useDocumentState(documentId: string | null): DocumentState | null {\n  const coreState = useCoreState();\n\n  const documentState = useMemo(() => {\n    if (!coreState || !documentId) return null;\n    return coreState.documents[documentId] ?? null;\n  }, [coreState, documentId]);\n\n  return documentState;\n}\n","import { useState, useEffect } from '@framework';\nimport { CoreState, StoreState } from '@embedpdf/core';\nimport { useRegistry } from './use-registry';\n\n/**\n * Hook that provides access to the current global store state\n * and re-renders the component when the state changes\n */\nexport function useStoreState<T = CoreState>(): StoreState<T> | null {\n  const { registry } = useRegistry();\n  const [state, setState] = useState<StoreState<T> | null>(null);\n\n  useEffect(() => {\n    if (!registry) return;\n\n    // Get initial state\n    setState(registry.getStore().getState() as StoreState<T>);\n\n    // Subscribe to store changes\n    const unsubscribe = registry.getStore().subscribe((_action, newState) => {\n      setState(newState as StoreState<T>);\n    });\n\n    return () => unsubscribe();\n  }, [registry]);\n\n  return state;\n}\n"],"names":["PDFContext","createContext","registry","coreState","isInitializing","pluginsReady","activeDocumentId","activeDocument","documents","documentStates","AutoMount","plugins","children","utilities","wrappers","useMemo","reg","pkg","package","hasAutoMountElements","elements","autoMountElements","element","type","push","component","wrappedContent","reduce","content","Wrapper","jsx","Fragment","map","Utility","i","useRegistry","contextValue","useContext","Error","usePlugin","pluginId","plugin","isLoading","ready","Promise","getPlugin","useCoreState","engine","logger","onInitialized","autoMountDomElements","setRegistry","useState","setCoreState","setIsInitializing","setPluginsReady","initRef","useRef","useEffect","current","pdfViewer","PluginRegistry","registerPluginBatch","cleanup","async","initialize","isDestroyed","store","getStore","getState","core","unsubscribe","subscribe","action","newState","oldState","isCoreAction","_a","call","then","unsub","catch","console","error","destroy","documentOrder","docId","filter","doc","Provider","value","provides","documentId","state","setState","_action"],"mappings":"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"}