update to internal commit 00667657

DMGithubPublisher · DMGithubPublisher · commit 35a2bb9f2ada · 2025-10-16T09:46:28.000+08:00
diff --git a/_data/product_version.yml b/_data/product_version.yml
@@ -1,7 +1,7 @@
 useGroupedVersion: true
 
 version_info_list:
-  - value: latest version (3.0)
+  - value: latest version (3.1)
   - value: 2.1
   - value: 1.1
 
diff --git a/_includes/sidelist-apis.html b/_includes/sidelist-apis.html
@@ -150,9 +150,11 @@
                 <li><a href="{{ site.api }}interface/searchtextoptions.html" class="otherLinkColour">SearchTextOptions</a></li>
                 <li><a href="{{ site.api }}interface/updatedsource.html" class="otherLinkColour">UpdatedSource</a></li>
                 <li><a href="{{ site.api }}interface/updatedpdfsource.html" class="otherLinkColour">UpdatedPdfSource</a></li>
+                <li><a href="{{ site.api }}interface/ipagedata.html" class="otherLinkColour">IPageData</a></li>
                 <li><a href="{{ site.api }}interface/ipointerevent.html" class="otherLinkColour">IPointerEvent</a></li>
                 <li><a href="{{ site.api }}interface/iquadmodifiedevent.html" class="otherLinkColour">IQuadmodifiedEvent</a></li>
-                <li><a href="{{ site.api }}interface/ipagedata.html" class="otherLinkColour">IPageData</a></li>
+                <li><a href="{{ site.api }}interface/iundoredostatechangedevent.html" class="otherLinkColour">IUndoRedoStateChangedEvent</a></li>
+                <li><a href="{{ site.api }}interface/ipaginationchangedevent.html" class="otherLinkColour">IPaginationChangedEvent</a></li>
             </ul>
         </li>
         <li><a class="otherLinkColour">Enumerations & Types</a>
diff --git a/api/class/browseviewer.md b/api/class/browseviewer.md
@@ -87,12 +87,14 @@ Browse Viewer is used to display pages in multiple-mode, pages can be multiple s
 | [`currentIndexChanged`](#currentindexchanged) |
 | [`currentPageChanged`](#currentpagechanged)  |
 | [`selectedPagesChanged`](#selectedpageschanged) |
+| [`scroll`](#scroll) |
 | [`pagesDragged`](#pagesdragged)         |
 | [`pagesDropped`](#pagesdropped)         |
 | [`click`](#click)               |
 | [`dblclick`](#dbclick)            |
 | [`rightclick`](#rightclick)          |
 | [`visibilityChanged`](#visibilitychanged)                   |
+| [`paginationChanged`](#paginationchanged)                   |
 | [`pointerdown`](#pointerdown)                   |
 | [`pointermove`](#pointermove)                   |
 | [`pointerup`](#pointerup)                   |
@@ -113,7 +115,7 @@ new Dynamsoft.DDV.BrowseViewer(options?: BrowseViewerConstructorOptions);
 
 **Parameters**
 
-`options`: The constructor options for a `BrowseViewer` instance. Please refer to [`BrowseViewerConstructorOptions`]({{ site.api }}interface/browseviewerconstructoroptions.html).
+`options`: The constructor options for a `BrowseViewer` instance. Please refer to [`BrowseViewerConstructorOptions`](/api/interface/browseviewerconstructoroptions.md).
 
 **Code Snippet**
 
@@ -1142,7 +1144,7 @@ Triggered when current page is changed.
 
 #### selectedPagesChanged
 
-Trigeered when the page(s) is selected.
+Triggered when the page(s) is selected.
 
 ***Callback***
 
@@ -1158,6 +1160,10 @@ Trigeered when the page(s) is selected.
 
 `newPageUids[]`: The array of new selected pages uids.
 
+#### scroll
+
+Triggered when the viewer is scrolled. It will return the native event object.
+
 #### pagesDragged
 
 Triggered when page(s) is dragged.
@@ -1193,6 +1199,10 @@ Triggered when page(s) is dropped.
 
 Triggered when the viewer's visibility is changed. It will return an `isVisible` boolean value.
 
+#### paginationChanged
+
+Triggered when the viewer's current page number or the page count is changed. It will return an [`IPaginationChangedEvent`](/api/interface/ipaginationchangedevent.md) object.
+
 #### pointerdown
 
 Triggered when a pointer becomes active buttons state. It will return an [`IPointerEvent`](/api/interface/ipointerevent.md) object.
diff --git a/api/class/captureviewer.md b/api/class/captureviewer.md
@@ -85,6 +85,7 @@ Capture Viewer is used to control camera, play video stream, and capture the ima
 | [`dblclick`](#dblclick)     |
 | [`rightclick`](#rightclick) |
 | [`visibilityChanged`](#visibilitychanged) |
+| [`paginationChanged`](#paginationchanged)                   |
 
 ## Create and Destroy Instances
 
@@ -1050,6 +1051,10 @@ Triggered when the used camera is changed.
 
 `newDeviceId`: The new camera device id.
 
+#### paginationChanged
+
+Triggered when the viewer's current page number or the page count is changed. It will return an [`IPaginationChangedEvent`](/api/interface/ipaginationchangedevent.md) object.
+
 #### visibilityChanged
 
 Triggered when the viewer's visibility is changed. It will return an `isVisible` boolean value.
diff --git a/api/class/editviewer.md b/api/class/editviewer.md
@@ -73,6 +73,8 @@ Edit Viewer is used to edit the pages in document, such as, rotating, cropping,
 | [`setAnnotationDrawingStyle()`](#setannotationdrawingstyle) | Set the default drawing style of annotations by annotation type. |
 | [`selectAnnotations()`](#selectannotations)                 | Select the specified annotation(s) on the current page.          |
 | [`getSelectedAnnotations()`](#getselectedannotations)       | Get selected annotation(s).                                      |
+| [`getAnnotationDrawingStyle()`](#getannotationdrawingstyle)       | Get the annotation drawing style(s).                                      |
+
 
 **Edit Operations**
 
@@ -82,6 +84,7 @@ Edit Viewer is used to edit the pages in document, such as, rotating, cropping,
 | [`crop()`](#crop)                     | Crop the specified page(s) with the specified rectangle.                                                                           |
 | [`getCropRect()`](#getcroprect)       | Get the crop rectangular selection.                                                                                                |
 | [`setCropRect()`](#setcroprect)       | Set a crop rectangular selection on the current page. *This method is only available when [`toolMode`](#toolmode) is `crop` mode.* |
+| [`cropMode`](#cropmode)                     | Get the current mode for cropping: crop the current image or all the images                                    |
 | [`undo()`](#undo)                     | Undo the last editing operation.                                                                                                   |
 | [`redo()`](#redo)                     | Redo the last undo operation.                                                                                                      |
 | [`saveOperations()`](#saveoperations) | Save the edit operations in pages to document.                                                                                     |
@@ -122,19 +125,24 @@ Edit Viewer is used to edit the pages in document, such as, rotating, cropping,
 | [`cropRectDrawn`](#croprectdrawn)                           |
 | [`cropRectDeleted`](#croprectdeleted)                       |
 | [`cropRectModified`](#croprectmodified)                     |
+| [`annotationDrawingStyleChanged`](#annotationdrawingstylechanged)                     |
 | [`selectedAnnotationsChanged`](#selectedannotationschanged) |
 | [`click`](#click)                                           |
 | [`dblclick`](#dbclick)                                      |
 | [`rightclick`](#rightclick)                                 |
 | [`visibilityChanged`](#visibilitychanged)                   |
 | [`textUnselected`](#textunselected)                   |
 | [`textSelected`](#textselected)                   |
-| [`textSearchTriggered`](#textSearchtriggered)                   |
+| [`textSearchTriggered`](#textsearchtriggered)                   |
+| [`undoRedoStateChanged`](#undoredostatechanged)                   |
+| [`paginationChanged`](#paginationchanged)                   |
+| [`pointerdown`](#pointerdown)                   |
 | [`pointerdown`](#pointerdown)                   |
 | [`pointermove`](#pointermove)                   |
 | [`pointerup`](#pointerup)                   |
 | [`pageover`](#pageover)                   |
 | [`pageout`](#pageout)                   |
+| [`scroll`](#scroll) |
 
 ## Create and Destroy Instances
 
@@ -150,7 +158,7 @@ new Dynamsoft.DDV.EditViewer(options?: EditViewerConstructorOptions);
 
 **Parameters**
 
-`options`: The constructor options for an `EditViewer` instance. Please refer to [`EditViewerConstructorOptions`]({{ site.api }}interface/editviewerconstructoroptions.html).
+`options`: The constructor options for an `EditViewer` instance. Please refer to [`EditViewerConstructorOptions`](/api/interface/editviewerconstructoroptions.md).
 
 **Code Snippet**
 
@@ -943,6 +951,21 @@ const selectAnnots = editViewer.getSelectAnnotations();
  -80304     | No document opened.                                         | `[]`
  -80305     | There is no image in the current document.                  | `[]`
 
+### getAnnotationDrawingStyle()
+
+Get the annotation drawing style.
+
+**Syntax**
+
+```typescript
+getAnnotationDrawingStyle(): AnnotationDrawingStyleConfig;
+```
+
+**Return value**
+
+An [`AnnotationDrawingStyleConfig`](/api/interface/styleinterface/annotationdrawingstyleconfig.md) object.
+
+
 ## Display Control
 
 ### displayMode
@@ -1200,7 +1223,7 @@ crop(
 
 `rect`: Specify the rectangle. Please refer to [`Rect`]({{ site.api }}interface/rect.html).
 
-`indices`: Specify the indices of the pages to be cropped. If not set, the current page will be cropped.
+`indices`: Specify the indices of the pages to be cropped. If not set, it will crop based on [`cropMode`](#cropmode), which uses the current image if the mode is `current` and all the images if the mode is `all`.
 
 **Return Value**
 
@@ -1235,6 +1258,23 @@ editViewer.crop(rect, [0]); // Crop the first page
 
 If one of the points of the rectangle is out of page range, crop operation does not take effect in this page and report warning.
 
+
+### cropMode
+
+Get or set the current mode for cropping: crop the current image or all the images.
+
+**Syntax**
+
+```typescript
+cropMode: CropMode; 
+```
+
+It can be one of the two types. 
+
+```typescript
+type CropMode = "current" | "all";
+```
+
 ### getCropRect()
 
 Get the crop rectangular selection.
@@ -1739,6 +1779,10 @@ Triggered when the crop rectangular selection is modified.
 
 `newRect`: The new rectangle.
 
+#### annotationDrawingStyleChanged
+
+Triggered when the annotation drawing style is changed. It will return the old drawing style and the new drawing style of the selected annotation. See also [`AnnotationDrawingStyleConfig`](/api/interface/styleinterface/annotationdrawingstyleconfig.md).
+
 #### selectedAnnotationsChanged
 
 Triggered when selected annotation(s) is changed.
@@ -1769,6 +1813,16 @@ Triggered when text is unselected.
 
 Triggered when text search is performed. It will return an array of [`ITextSearchedInfo`](/api/interface/itextsearchedinfo.md).
 
+
+
+#### undoRedoStateChanged
+
+Triggered when the viewer's undo and redo state is changed. It will return an [`IUndoRedoStateChangedEvent`](/api/interface/iundoredostatechangedevent.md) object.
+
+#### paginationChanged
+
+Triggered when the viewer's current page number or the page count is changed. It will return an [`IPaginationChangedEvent`](/api/interface/ipaginationchangedevent.md) object.
+
 #### pointerdown
 
 Triggered when a pointer becomes active buttons state. It will return an [`IPointerEvent`](/api/interface/ipointerevent.md) object.
@@ -1789,6 +1843,10 @@ Triggered when a pointer is moved into a page's hit test boundaries. It will ret
 
 Triggered when a pointer is moved out of the hit test boundaries of a page. It will return an [`IPointerEvent`](/api/interface/ipointerevent.md) object.
 
+#### scroll
+
+Triggered when the viewer is scrolled. It will return the native event object.
+
 #### Mouse Events
 
 ##### click
diff --git a/api/class/perspectiveviewer.md b/api/class/perspectiveviewer.md
@@ -89,6 +89,7 @@ Perspective Viewer is used to do page boundaries manual adjustment & perspective
 | [`dblclick`](#dbclick)            |
 | [`rightclick`](#rightclick)          |
 | [`visibilityChanged`](#visibilitychanged)                   |
+| [`paginationChanged`](#paginationchanged)                   |
 | [`pointerdown`](#pointerdown)                   |
 | [`pointermove`](#pointermove)                   |
 | [`pointerup`](#pointerup)                   |
@@ -1083,6 +1084,9 @@ Triggered when current page is changed.
 
 Triggered when the quadrilateral selection is modified. Please refer to [`IQuadModifiedEvent`](/api/interface/iquadmodifiedevent.md).
 
+#### paginationChanged
+
+Triggered when the viewer's current page number or the page count is changed. It will return an [`IPaginationChangedEvent`](/api/interface/ipaginationchangedevent.md) object.
 
 #### visibilityChanged
 
diff --git a/api/interface/browseviewerconfig.md b/api/interface/browseviewerconfig.md
@@ -30,6 +30,7 @@ interface BrowseViewerConfig {
     scrollToLatest?: boolean;
     enableDragPage?: boolean;
     enableLoadSourceByDrag?: boolean;
+    enableAutoScrollForDragPages?: boolean;
     scrollDirection?: string;
 }
 ```
@@ -100,6 +101,13 @@ Enables loading files by dragging them into the Viewer.
 
 Default value: `true`
 
+### enableAutoScrollForDragPages
+
+Specify whether to enable auto scrolling when dragging pages if the cursor is around the edges of the viewer. 
+
+Default value: `true`
+
+
 ### scrollDirection
 
 Specify the scroll direction, supported values are `vertical`, `horizontal`.
diff --git a/api/interface/browseviewerconstructoroptions.md b/api/interface/browseviewerconstructoroptions.md
@@ -20,7 +20,7 @@ interface BrowseViewerConstructorOptions {
     keyboardInteractionConfig?: KeyboardInteractionConfig;
     viewerConfig?: BrowseViewerConfig;
     uiConfig?: UiConfig; 
-    groupUid?: string; 
+    groupUid?: string;
 }
 ```
 
@@ -36,7 +36,7 @@ This configures the use of keyboard shortcuts for the viewer - please see [`Keyb
 
 ### viewerConfig
 
-The configurations of viewer, please refer to [`BrowseViewerConfig`]({{ site.api }}interface/browseviewerconfig.html). If it is not specified, the [default configuration]({{ site.viewer }}viewerconfig.html#browseviewerconfig) will be applied.
+The configurations of viewer, please refer to [`BrowseViewerConfig`](/api/interface/browseviewerconfig.md). If it is not specified, the [default configuration]({{ site.viewer }}viewerconfig.html#browseviewerconfig) will be applied.
 
 ### uiConfig
 
diff --git a/api/interface/editviewerconfig.md b/api/interface/editviewerconfig.md
@@ -22,7 +22,8 @@ interface EditViewerConfig {
     quadSelectionStyle?: QuadSelectionStyle;
     enableLoadSourceByDrag?: boolean;
     enableMagnifier?: boolean;
-    enableSlide?: boolean; 
+    enableSlide?: boolean;
+    enableAutoScrollForTextSelection?: boolean;
     scrollToLatest?: boolean; 
     scrollDirection?: string; 
     minZoom?: number; 
@@ -56,7 +57,7 @@ Default value: `true`
 
 ### enableMagnifier
 
-Specifies whether or not to display a corner magnifier on the canvas. This feature is primarily used to provide a zoomed-in preview of the selected area for more precise adjustments.
+Specify whether or not to display a corner magnifier on the canvas. This feature is primarily used to provide a zoomed-in preview of the selected area for more precise adjustments.
 
 Default value: `true`
 
@@ -66,6 +67,12 @@ Specify whether allow to slide the pages.
 
 Default value: `true`
 
+### enableAutoScrollForTextSelection
+
+Specify whether to enable auto scrolling when selecting text if the cursor is around the edges of the viewer.
+
+Default value: `true`
+
 ### scrollToLatest
 
 Specify whether to scroll to latest page automatically when importing new pages.
diff --git a/api/interface/editviewerconstructoroptions.md b/api/interface/editviewerconstructoroptions.md
@@ -34,7 +34,7 @@ The container which is used to show the viewer. Its `id` or `HTMLElement` is acc
 
 ### viewerConfig
 
-The configurations of viewer, please refer to [`EditViewerConfig`]({{ site.api }}interface/editviewerconfig.html). If it is not specified, the [default configuration]({{ site.viewer }}viewerconfig.html#editviewerconfig) will be applied.
+The configurations of viewer, please refer to [`EditViewerConfig`](/api/interface/editviewerconfig.md). If it is not specified, the [default configuration]({{ site.viewer }}viewerconfig.html#editviewerconfig) will be applied.
 
 ### uiConfig
 
diff --git a/api/interface/ipaginationchangedevent.md b/api/interface/ipaginationchangedevent.md
@@ -0,0 +1,22 @@
+---
+layout: default-layout
+needAutoGenerateSidebar: true
+needGenerateH3Content: true
+noTitleIndex: true
+title: Dynamsoft Document Viewer API Reference - Interface IPointerEvent
+keywords: Documentation, Dynamsoft Document Viewer, API Reference, Interface IPaginationChangedEvent
+breadcrumbText: Interface IPaginationChangedEvent
+description: Dynamsoft Document Viewer Documentation API Reference Interface IPaginationChangedEvent Page
+---
+
+# IPaginationChangedEvent
+
+## Syntax
+
+```typescript
+export interface IPaginationChangedEvent {
+    currentPageNumber: number;
+    pageCount: number;
+}
+```
+
diff --git a/api/interface/iundoredostatechangedevent.md b/api/interface/iundoredostatechangedevent.md
@@ -0,0 +1,22 @@
+---
+layout: default-layout
+needAutoGenerateSidebar: true
+needGenerateH3Content: true
+noTitleIndex: true
+title: Dynamsoft Document Viewer API Reference - Interface IUndoRedoStateChangedEvent
+keywords: Documentation, Dynamsoft Document Viewer, API Reference, Interface IUndoRedoStateChangedEvent
+breadcrumbText: Interface IUndoRedoStateChangedEvent
+description: Dynamsoft Document Viewer Documentation API Reference Interface IUndoRedoStateChangedEvent Page
+---
+
+# IUndoRedoStateChangedEvent
+
+## Syntax
+
+```typescript
+export interface IUndoRedoStateChangedEvent {
+    undoCount: number;
+    redoCount: number;
+}
+```
+
diff --git a/introduction/index.md b/introduction/index.md
@@ -11,7 +11,7 @@ description: Powerful JavaScript PDF viewer & document viewer SDK. Integrate sea
 
 # Introduction to Dynamsoft Document Viewer
 
-Dynamsoft Document Viewer is a browser-based JavaScript SDK designed for viewing and editing images and PDFs. It provides a wide range of functionalities, including PDF annotation, page manipulation, image quality enhancement, and document saving.
+Dynamsoft Document Viewer is a browser-based JavaScript SDK designed for viewing and editing images and PDFs. It provides a wide range of functionalities, including PDF annotation, page manipulation, image quality enhancement, and document saving. To see it in action, please visit this [online demo](https://demo.dynamsoft.com/document-viewer/).
 
 ## Security
 
diff --git a/releasenotes/index.md b/releasenotes/index.md
