@docvyu/sdk 0.0.5 → 0.1.0

package/dist/esm/react/index.js

@@ -1 +1 @@
-import{jsx as e,jsxs as o}from"react/jsx-runtime";import{createContext as t,forwardRef as n,useRef as r,useState as a,useEffect as s,useCallback as l,useImperativeHandle as i,useContext as c}from"react";import{o as u,s as d,t as m,D as g,b as f}from"../DocvyuEditor-DlUB7weZ.js";const v=t({editor:null,isReady:!1,licenseInfo:null,selectionState:null,locale:"en",setLocale:()=>{},t:e=>e});function w(){const e=c(v);if(!e)throw new Error("useDocvyu must be used within a DocvyuEditorProvider");return e}const L=n(function(t,n){const{apiKey:c,licenseServerUrl:f,offlineMode:w,zoom:L,rulerUnit:y,locale:h,autoDetectLocale:b,customTranslations:S,onLocaleChange:D,className:p,style:E,onReady:z,onLoad:C,onSave:U,onSelectionChange:N,onLicenseChange:k,onUsageLimitExceeded:A,onError:F,wasmInit:I,EditorClass:M}=t,B=r(null),x=r(null),[R,P]=a(!1),[j,K]=a(null),[T,O]=a(null),[Z,$]=a(h||"en");s(()=>u(e=>{$(e),D?.(e)}),[D]);const q=l(e=>{d(e),$(e)},[]);s(()=>{if(B.current&&!x.current)return(async()=>{try{const e=new g({canvas:B.current,apiKey:c,licenseServerUrl:f,offlineMode:w,zoom:L,rulerUnit:y,locale:h,autoDetectLocale:b,customTranslations:S,onLocaleChange:D,onLoad:C,onSave:U,onSelectionChange:e=>{O(e),N?.(e)},onLicenseChange:e=>{K(e),k?.(e)},onUsageLimitExceeded:A}),o=await e.initialize(I,M);x.current=e,K(o),P(!0),z?.(e)}catch(e){F?.(e)}})(),()=>{x.current?.destroy(),x.current=null,P(!1)}},[]);const G=l(e=>{if(!x.current||!B.current)return;const o=B.current.getBoundingClientRect();x.current.handleMouseClick(e.clientX-o.left,e.clientY-o.top)},[]),H=l(e=>{if(!x.current||!B.current||1!==e.buttons)return;const o=B.current.getBoundingClientRect();x.current.handleMouseDrag(e.clientX-o.left,e.clientY-o.top)},[]);return s(()=>{const e=e=>{if(!x.current)return;if(e.ctrlKey||e.metaKey)switch(e.key.toLowerCase()){case"b":e.preventDefault();const o=x.current.getSelectionState();return void x.current.setBold(!o.bold);case"i":e.preventDefault();const t=x.current.getSelectionState();return void x.current.setItalic(!t.italic);case"u":e.preventDefault();const n=x.current.getSelectionState();return void x.current.setUnderline(!n.underline);case"s":return e.preventDefault(),void x.current.downloadDocument()}const o=new Set(["Backspace","Delete","Enter","ArrowLeft","ArrowRight","ArrowUp","ArrowDown"]);(1===e.key.length||o.has(e.key))&&(e.preventDefault(),x.current.handleKeyDown(e.key))};return window.addEventListener("keydown",e),()=>window.removeEventListener("keydown",e)},[]),i(n,()=>({editor:x.current,loadDocument:e=>{x.current?.loadDocument(e)},saveDocument:()=>x.current?.saveDocument()??null,downloadDocument:e=>{x.current?.downloadDocument(e)},setLocale:q,getLocale:()=>Z}),[R,Z,q]),e(v.Provider,{value:{editor:x.current,isReady:R,licenseInfo:j,selectionState:T,locale:Z,setLocale:q,t:m},children:o("div",{className:`docvyu-container ${p||""}`,style:E,children:[e("canvas",{ref:B,onMouseDown:G,onMouseMove:H,style:{display:"block"},"aria-label":m("accessibility.editorLabel")}),j?.watermark&&e("div",{className:"docvyu-watermark",children:m("watermark.poweredBy")})]})})});function y(){const{editor:e,selectionState:o}=w(),t=l(()=>{e&&o&&e.setBold(!o.bold)},[e,o]),n=l(()=>{e&&o&&e.setItalic(!o.italic)},[e,o]),r=l(()=>{e&&o&&e.setUnderline(!o.underline)},[e,o]),a=l(o=>{e?.setFontSize(o)},[e]),s=l(o=>{e?.setFontFamily(o)},[e]),i=l(o=>{e?.setFontColor(o)},[e]),c=l(o=>{e?.setAlignment(o)},[e]);return{state:o,toggleBold:t,toggleItalic:n,toggleUnderline:r,setFontSize:a,setFontFamily:s,setFontColor:i,setAlignment:c}}function h(){const{editor:e,selectionState:o}=w(),t=l(()=>{e&&o&&e.setBulletList(!o.hasBulletList)},[e,o]),n=l(()=>{e&&o&&e.setNumberedList(!o.hasNumberedList)},[e,o]),r=l(o=>{e?.setNumberedListFormat(o)},[e]),a=l(()=>{e?.removeNumbering()},[e]);return{hasBulletList:o?.hasBulletList??!1,hasNumberedList:o?.hasNumberedList??!1,numberingFormatId:o?.numberingFormatId,toggleBulletList:t,toggleNumberedList:n,setNumberingFormat:r,removeNumbering:a}}function b(){const{editor:e}=w();return{setMargins:l(o=>{e?.setMargins(o)},[e]),setPageSize:l(o=>{e?.setPageSize(o)},[e]),getPageSize:l(()=>e?.getPageSize()??"letter",[e])}}function S(){const{editor:e}=w(),[o,t]=a(1),n=l(o=>{e?.setZoom(o),t(o)},[e]),r=l(()=>{e?.zoomIn(),t(e?.getZoom()??1)},[e]),i=l(()=>{e?.zoomOut(),t(e?.getZoom()??1)},[e]);return s(()=>{e&&t(e.getZoom())},[e]),{zoom:o,setZoom:n,zoomIn:r,zoomOut:i}}function D(){const{locale:e,setLocale:o,t:t}=w(),[n]=a(f());return{locale:e,setLocale:o,t:t,availableLocales:n,isLocaleAvailable:e=>n.includes(e)}}export{L as DocvyuEditor,L as DocvyuEditorComponent,L as default,w as useDocvyu,D as useDocvyuI18n,y as useEditorFormatting,h as useEditorLists,b as useEditorPageSettings,S as useEditorZoom};
+import{jsx as e,jsxs as o}from"react/jsx-runtime";import{createContext as t,forwardRef as n,useRef as r,useState as a,useEffect as s,useCallback as l,useImperativeHandle as i,useContext as c}from"react";import{o as u,s as d,t as m,D as g,g as f}from"../DocvyuEditor-CDLqMpaq.js";const v=t({editor:null,isReady:!1,licenseInfo:null,selectionState:null,locale:"en",setLocale:()=>{},t:e=>e});function w(){const e=c(v);if(!e)throw new Error("useDocvyu must be used within a DocvyuEditorProvider");return e}const L=n(function(t,n){const{apiKey:c,licenseServerUrl:f,offlineMode:w,zoom:L,rulerUnit:y,locale:h,autoDetectLocale:S,customTranslations:b,onLocaleChange:D,className:p,style:E,onReady:z,onLoad:C,onSave:U,onSelectionChange:N,onLicenseChange:k,onUsageLimitExceeded:A,onError:F,wasmInit:I,EditorClass:M}=t,B=r(null),x=r(null),[R,P]=a(!1),[j,K]=a(null),[T,O]=a(null),[Z,$]=a(h||"en");s(()=>u(e=>{$(e),D?.(e)}),[D]);const q=l(e=>{d(e),$(e)},[]);s(()=>{if(B.current&&!x.current)return(async()=>{try{const e=new g({canvas:B.current,apiKey:c,licenseServerUrl:f,offlineMode:w,zoom:L,rulerUnit:y,locale:h,autoDetectLocale:S,customTranslations:b,onLocaleChange:D,onLoad:C,onSave:U,onSelectionChange:e=>{O(e),N?.(e)},onLicenseChange:e=>{K(e),k?.(e)},onUsageLimitExceeded:A}),o=await e.initialize(I,M);x.current=e,K(o),P(!0),z?.(e)}catch(e){F?.(e)}})(),()=>{x.current?.destroy(),x.current=null,P(!1)}},[]);const G=l(e=>{if(!x.current||!B.current)return;const o=B.current.getBoundingClientRect();x.current.handleMouseClick(e.clientX-o.left,e.clientY-o.top)},[]),H=l(e=>{if(!x.current||!B.current||1!==e.buttons)return;const o=B.current.getBoundingClientRect();x.current.handleMouseDrag(e.clientX-o.left,e.clientY-o.top)},[]);return s(()=>{const e=e=>{if(!x.current)return;if(e.ctrlKey||e.metaKey)switch(e.key.toLowerCase()){case"b":e.preventDefault();const o=x.current.getSelectionState();return void x.current.setBold(!o.bold);case"i":e.preventDefault();const t=x.current.getSelectionState();return void x.current.setItalic(!t.italic);case"u":e.preventDefault();const n=x.current.getSelectionState();return void x.current.setUnderline(!n.underline);case"s":return e.preventDefault(),void x.current.downloadDocument()}const o=new Set(["Backspace","Delete","Enter","ArrowLeft","ArrowRight","ArrowUp","ArrowDown"]);(1===e.key.length||o.has(e.key))&&(e.preventDefault(),x.current.handleKeyDown(e.key))};return window.addEventListener("keydown",e),()=>window.removeEventListener("keydown",e)},[]),i(n,()=>({editor:x.current,loadDocument:e=>{x.current?.loadDocument(e)},saveDocument:()=>x.current?.saveDocument()??null,downloadDocument:e=>{x.current?.downloadDocument(e)},setLocale:q,getLocale:()=>Z}),[R,Z,q]),e(v.Provider,{value:{editor:x.current,isReady:R,licenseInfo:j,selectionState:T,locale:Z,setLocale:q,t:m},children:o("div",{className:`docvyu-container ${p||""}`,style:E,children:[e("canvas",{ref:B,onMouseDown:G,onMouseMove:H,style:{display:"block"},"aria-label":m("accessibility.editorLabel")}),j?.watermark&&e("div",{className:"docvyu-watermark",children:m("watermark.poweredBy")})]})})});function y(){const{editor:e,selectionState:o}=w(),t=l(()=>{e&&o&&e.setBold(!o.bold)},[e,o]),n=l(()=>{e&&o&&e.setItalic(!o.italic)},[e,o]),r=l(()=>{e&&o&&e.setUnderline(!o.underline)},[e,o]),a=l(o=>{e?.setFontSize(o)},[e]),s=l(o=>{e?.setFontFamily(o)},[e]),i=l(o=>{e?.setFontColor(o)},[e]),c=l(o=>{e?.setAlignment(o)},[e]);return{state:o,toggleBold:t,toggleItalic:n,toggleUnderline:r,setFontSize:a,setFontFamily:s,setFontColor:i,setAlignment:c}}function h(){const{editor:e,selectionState:o}=w(),t=l(()=>{e&&o&&e.setBulletList(!o.hasBulletList)},[e,o]),n=l(()=>{e&&o&&e.setNumberedList(!o.hasNumberedList)},[e,o]),r=l(o=>{e?.setNumberedListFormat(o)},[e]),a=l(()=>{e?.removeNumbering()},[e]);return{hasBulletList:o?.hasBulletList??!1,hasNumberedList:o?.hasNumberedList??!1,numberingFormatId:o?.numberingFormatId,toggleBulletList:t,toggleNumberedList:n,setNumberingFormat:r,removeNumbering:a}}function S(){const{editor:e}=w();return{setMargins:l(o=>{e?.setMargins(o)},[e]),setPageSize:l(o=>{e?.setPageSize(o)},[e]),getPageSize:l(()=>e?.getPageSize()??"letter",[e])}}function b(){const{editor:e}=w(),[o,t]=a(1),n=l(o=>{e?.setZoom(o),t(o)},[e]),r=l(()=>{e?.zoomIn(),t(e?.getZoom()??1)},[e]),i=l(()=>{e?.zoomOut(),t(e?.getZoom()??1)},[e]);return s(()=>{e&&t(e.getZoom())},[e]),{zoom:o,setZoom:n,zoomIn:r,zoomOut:i}}function D(){const{locale:e,setLocale:o,t:t}=w(),[n]=a(f());return{locale:e,setLocale:o,t:t,availableLocales:n,isLocaleAvailable:e=>n.includes(e)}}export{L as DocvyuEditor,L as DocvyuEditorComponent,L as default,w as useDocvyu,D as useDocvyuI18n,y as useEditorFormatting,h as useEditorLists,S as useEditorPageSettings,b as useEditorZoom};

package/dist/types/app/DocvyuApp.d.ts

@@ -50,11 +50,21 @@ export declare class DocvyuApp {
     private editor;
     private currentFileName;
     private licenseInfo;
+    private copiedFormat;
+    private lastKnownSelectionFormat;
     private elements;
     private isMouseDown;
+    private isDraggingImage;
     private multiClickCount;
     private multiClickResetId;
     private readonly MULTI_CLICK_RESET_MS;
+    private boundHandleMouseDown;
+    private boundHandleMouseMove;
+    private boundHandleMouseUp;
+    private boundHandleKeyDown;
+    private boundHandleDocumentClick;
+    private boundHandleContextMenu;
+    private boundHandleScroll;
     constructor(config: DocvyuAppConfig);
     /**
      * Initialize the editor with WASM module
@@ -64,8 +74,14 @@ export declare class DocvyuApp {
     init(wasmInit: () => Promise<any>, EditorClass: any): Promise<void>;
     /**
      * Cache DOM element references
+     * Validates that critical elements exist and provides helpful error messages
      */
     private cacheElements;
+    /**
+     * Validates that critical DOM elements exist
+     * Throws descriptive errors if required elements are missing
+     */
+    private validateCriticalElements;
     /**
      * Attach all event listeners
      */
@@ -74,14 +90,30 @@ export declare class DocvyuApp {
      * Handle mouse down on canvas
      */
     private handleMouseDown;
+    /**
+     * Open a hyperlink URL
+     */
+    private openHyperlink;
     /**
      * Handle mouse move on canvas
      */
     private handleMouseMove;
+    /**
+     * Update hyperlink tooltip visibility and position
+     */
+    private updateHyperlinkTooltip;
+    /**
+     * Escape HTML characters for safe display
+     */
+    private escapeHtml;
     /**
      * Handle mouse up
      */
     private handleMouseUp;
+    /**
+     * Handle scroll events for viewport-aware rendering
+     */
+    private handleScroll;
     /**
      * Handle keyboard input
      */
@@ -110,6 +142,14 @@ export declare class DocvyuApp {
      * Handle document click to close popovers
      */
     private handleDocumentClick;
+    /**
+     * Handle right-click context menu
+     */
+    private handleContextMenu;
+    /**
+     * Handle context menu action clicks
+     */
+    private handleContextMenuAction;
     /**
      * Handle file selection
      */
@@ -118,6 +158,84 @@ export declare class DocvyuApp {
      * Toggle a text style
      */
     private toggleStyle;
+    private toggleStrikethrough;
+    /**
+     * Copy selected text to clipboard
+     */
+    private copyText;
+    /**
+     * Cut selected text to clipboard
+     */
+    private cutText;
+    /**
+     * Paste text from clipboard
+     */
+    private pasteText;
+    /**
+     * Copy format from current cursor position or start of selection
+     */
+    private copyFormat;
+    /**
+     * Apply copied format to current selection
+     */
+    private applyFormat;
+    /**
+     * Update format painter button state
+     */
+    private updateFormatPainterButton;
+    /**
+     * Fallback copy method for older browsers
+     */
+    private fallbackCopyToClipboard;
+    /**
+     * Check if search bar is currently visible
+     */
+    private isSearchBarVisible;
+    /**
+     * Show the search bar and focus the input
+     * @param showReplace Whether to show the replace row
+     */
+    private showSearchBar;
+    /**
+     * Hide the search bar and clear search
+     */
+    private hideSearchBar;
+    /**
+     * Perform search with the current query
+     */
+    private performSearch;
+    /**
+     * Navigate to next search match
+     */
+    private searchNext;
+    /**
+     * Navigate to previous search match
+     */
+    private searchPrevious;
+    /**
+     * Replace the current search match
+     */
+    private replaceCurrentMatch;
+    /**
+     * Replace all search matches
+     */
+    private replaceAllMatches;
+    /**
+     * Update search count display from editor state
+     */
+    private updateSearchCountFromState;
+    /**
+     * Update the search count display
+     */
+    private updateSearchCount;
+    /**
+     * Set up search bar event listeners
+     */
+    private setupSearchListeners;
+    /**
+     * Set status bar message
+     */
+    private setStatus;
     /**
      * Toggle a popover
      */
@@ -126,10 +244,71 @@ export declare class DocvyuApp {
      * Close all popovers
      */
     private closeAllPopovers;
+    /**
+     * Update numbering popover selection to highlight current format
+     */
+    private updateNumberingSelection;
+    /**
+     * Handle click on numbering format option
+     */
+    private handleNumberingFormatClick;
     /**
      * Apply margins from the popover inputs
      */
     private applyMargins;
+    /**
+     * Insert a table at the current cursor position
+     */
+    private insertTable;
+    /**
+     * Setup table grid event handlers
+     */
+    private setupTableGridEvents;
+    /**
+     * Trigger image file upload
+     */
+    private triggerImageUpload;
+    /**
+     * Insert an image from a file
+     */
+    private insertImage;
+    /**
+     * Scale the currently selected image by a factor
+     */
+    private scaleSelectedImage;
+    /**
+     * Reset image to its original scale (100%)
+     * Note: This doesn't restore original size, just sets current as baseline
+     */
+    private resetImageScale;
+    /**
+     * Show dialog for custom image dimensions
+     */
+    private showCustomImageScale;
+    /**
+     * Update image scale controls visibility based on cursor position
+     */
+    private updateImageScaleControls;
+    /**
+     * Set the wrap mode of the selected image
+     */
+    private setImageWrapMode;
+    /**
+     * Insert a comment at the current selection
+     */
+    private insertComment;
+    /**
+     * Toggle comments panel visibility
+     */
+    private toggleCommentsPanel;
+    /**
+     * Insert or edit header
+     */
+    private editHeader;
+    /**
+     * Insert or edit footer
+     */
+    private editFooter;
     /**
      * Update page size selection in popover
      */
@@ -187,5 +366,13 @@ export declare class DocvyuApp {
     /**
      * Destroy the app and clean up
      */
+    private promptInsertBookmark;
+    private acceptNextRevision;
+    private rejectNextRevision;
+    private updateRevisionCount;
+    private updateZoomDisplay;
+    private showDocumentProperties;
+    private showBookmarksPanel;
+    private showTocPanel;
     destroy(): void;
 }

package/dist/types/app/index.d.ts

@@ -4,5 +4,3 @@
  * Provides the complete DocvyuApp editor as a plug-and-play solution
  */
 export { DocvyuApp, type DocvyuAppConfig } from './DocvyuApp';
-export { generateEditorTemplate } from './template';
-export { editorStyles, injectStyles } from './styles';