dwt 19.1.0 → 19.3.0

package/dist/types/Addon.OCRKit.d.ts

@@ -0,0 +1,117 @@
+import { DynamsoftEnumsDWT } from "./Dynamsoft.Enum";
+
+export interface OCRKit {
+    /**
+     * Return the OCR installation information.
+     */
+    GetInstalledOCRInfo(): Promise<OCRInfo>; 
+    /**
+     * Detect the page's orientation.
+     */
+    DetectPageOrientation(
+       index: number, 
+       settings?: {
+            detectionMode?: DynamsoftEnumsDWT.EnumDWT_PageOrientationDetectionMode | number
+       }
+    ): Promise<AngleInfo>;
+    /**
+     * Perform OCR on the specified image in the buffer.
+     * @param index Specify the image.
+     * @param settings.language Specify the language for recognition, such as: "en","fr","es","de","it" or "pt".
+     * @param settings.pageOrientation  Specify the page orientation.
+     * @param rects  Specify the OCR region, which can be multiple.
+     */
+    Recognize(
+        index: number,
+        options?: {
+            settings?: {
+                language?: string,   
+                pageOrientation?: DynamsoftEnumsDWT.EnumDWT_PageOrientation | number, 
+            }, 
+            rects?:Rect[]
+        }
+    ): Promise<OCRResult>; 
+    /**
+     * Save the OCR result as a file.
+     * @param indices Specify the image(s).
+     * @param path The path to save the file.
+     * @param format Specify the output format.
+     */
+    SaveToPath(indices: number[], 
+        outputFormat: DynamsoftEnumsDWT.EnumDWT_OCRKitOutputFormat | number, 
+        path: string): Promise<boolean>;
+    /**
+     * Save the OCR result as a blob.
+     * @param indices Specify the image(s).
+     * @param format Specify the output format.
+     */
+    SaveAsBlob(indices: number[], 
+        outputFormat:DynamsoftEnumsDWT.EnumDWT_OCRKitOutputFormat | number): Promise<Blob>;
+    /**
+     * Save the OCR result as a base64 string.
+     * @param indices Specify the image(s).
+     * @param format Specify the output format.
+     */
+    SaveAsBase64(indices: number[], 
+        outputFormat:DynamsoftEnumsDWT.EnumDWT_OCRKitOutputFormat | number): Promise<string>;
+
+}
+export interface OCRResult {
+    /**
+     * The imageId of the image which can be used to find the index.
+     */
+    imageID: string;   
+    /**
+     * The width and height of the image.
+     */
+    dimensions: {width: number; height: number}; 
+    /**
+     * The rotation angle of the page and its confidence level.
+     */
+    orientation: {value: number; confidence: number}; 
+    blocks:{
+        geometry: Rect;
+        lines: {
+            /**
+             * The region of the line.
+             */
+            geometry: Rect;
+            words?:{
+                /**
+                 * OCR result of the word.
+                 */
+                value: string; 
+                 /**
+                 * The confidence level of the OCR result of the word.
+                 */
+                confidence: number;  
+                 /**
+                 * The region of the word.
+                 */
+                geometry: Rect;
+            }[];
+        }[];	
+    }[];
+}
+export interface OCRInfo {
+    /**
+     * Return the OCR version.
+     */
+    version: string;    
+}
+export interface AngleInfo {
+    /**
+     * Return the page's orientation.
+     */
+    angle: DynamsoftEnumsDWT.EnumDWT_PageOrientation |number;
+    /**
+     * Return the confidence level of the page's orientation.
+     */
+    confidence:number; 
+}
+export interface Rect {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}

package/dist/types/Addon.OCRPro.d.ts

@@ -111,8 +111,8 @@ export interface OCRPro {
 }
 export interface Rect {
     left: number;
-    right: number;
     top: number;
+    right: number;
     bottom: number;
 }
 export interface OCRProResult {

package/dist/types/Addon.PDF.d.ts

@@ -160,6 +160,10 @@ export interface PDFWSettings {
      * When saving a PDF, you can set a password for protection.
      */
 	password?: string;
+    /**
+     * Specify the PDFA version. For example, 'pdf/a-1b' or "pdf/a-2b".
+     */
+    pdfaVersion?: string; 
 }
 export interface ReaderOptions {
     /**

package/dist/types/Dynamsoft.Enum.d.ts

@@ -64,6 +64,24 @@ export namespace DynamsoftEnumsDBR {
 }
 
 export namespace DynamsoftEnumsDWT {
+    /** OCR Page Orientation Detection Mode */
+    enum EnumDWT_PageOrientationDetectionMode  {
+        FAST = 0,
+        BALANCE = 1,
+        PRECISION = 2
+    }
+    enum EnumDWT_PageOrientation {
+        AUTO = -1,
+        ANGLE_0 = 0,
+        ANGLE_90 = 90,
+        ANGLE_180 = 180,
+        ANGLE_270 = 270
+    }
+    enum EnumDWT_OCRKitOutputFormat{
+        TEXT = 0,
+        PDF_PLAIN_TEXT = 1,
+        PDF_WITH_EXTRA_TEXTLAYER = 2
+    }
     /** OCR Languages */
     enum EnumDWT_OCRLanguage {
         OCRL_ENG = "eng",

package/dist/types/Dynamsoft.d.ts

@@ -487,6 +487,11 @@ export interface DWTPro {
 	 * Whether to check certificates issue in detail, default value is true.
      */
 	IfCheckCert: boolean;
+    /**
+     * Dynamsoft.DWT.EnableLocalNetworkMixedContent 
+	 * If enabled, the library will use HTTP to communicate with the service. The host must be localhost or 127.0.0.1. The default value is false.
+     */
+    EnableLocalNetworkMixedContent: boolean;
 }
 export interface DisplayInfo {
     loaderBarSource?: string;

package/dist/types/RemoteScan.d.ts

@@ -56,15 +56,15 @@ export interface RemoteScanObject {
 	/**
      * @param forceRefresh Default value: false.
      */
-	getDynamsoftService(forceRefresh?: boolean): Promise<ServiceInfo[]>;
+	getServices(forceRefresh?: boolean): Promise<ServiceInfo[]>;
 	/**
      * Set the default dynamsoftService for storing the data
      */
-	setDefaultDynamsoftService(serviceInfo:ServiceInfo):Promise<void>;
+	setDefaultService(serviceInfo:ServiceInfo):Promise<void>;
 	/**
      * Get the default dynamsoftService.
      */
-	getDefaultDynamsoftService():ServiceInfo|null;
+	getDefaultService():ServiceInfo|null;
 	/**
      * Get image(s) form dynamsoftService.
 	 * @param indices Specify the image(s).

package/dist/types/WebTwain.Acquire.d.ts

@@ -355,6 +355,10 @@ export interface WebTwainAcquire extends WebTwainEdit {
      * Return the value of the top edge of the current image frame (in Unit).
      */
     readonly ImageLayoutFrameTop: number;
+    /**
+     * Return the frame number of the current image.
+     */
+    readonly ImageLayoutFrameNumber: number;
     /**
      * Return the document number of the current image.
      */

package/dist/types/WebTwain.Buffer.d.ts

@@ -32,6 +32,10 @@ export interface WebTwainBuffer extends WebTwainIO {
      * @param tag The tag used as the filter.
      */
     FilterImagesByTag(tag: string): boolean;
+    /**
+     * Stop filtering images by tag. 
+     */
+    ClearFilter(): boolean;
     /**
      * Return the pixel bit depth of the specified image.
      * @param index Specify the image.

package/dist/types/WebTwain.Edit.d.ts

@@ -28,7 +28,7 @@ export interface WebTwainEdit extends WebTwainBuffer {
      * @param index Specify the image.
      * @param value Specify the value of contrast.
      */
-    ChangeContrastAsnyc(
+    ChangeContrastAsync(
         index: number,
         value: number
     ): Promise<boolean>;

package/dist/types/WebTwain.IO.d.ts

@@ -770,6 +770,7 @@ export interface WebTwainIO extends WebTwainUtil {
      */
     MaxUploadImageSize: number;
     /**
+     * @deprecated since version 19.3. This property will be removed in future versions. Use function `PrintEx` instead.
      * Export all image data in the buffer to a new browser window and use the browser's built-in print feature to print the image(s).
      * @param useOSPrintWindow Whether to use the print feature of the operating system instead.
      */
@@ -777,8 +778,9 @@ export interface WebTwainIO extends WebTwainUtil {
     /**
      * Export specified image data in the buffer to a new browser window and use the browser's built-in print feature to print the image(s).
      * @argument indices The indices of the converted images.
+     * @argument settings Configure the printing method.
      */
-    PrintEx(indices: number[]): boolean;
+    PrintEx(indices: number[], settings?: PrintSettings): boolean;
 	/**
 	 * @deprecated since version 18.5. This property will be removed in future versions. Use asynchronous function `SaveAsBMP` instead.
      * Save the specified image as a BMP file.
@@ -1195,3 +1197,7 @@ export interface MetaData{
   resolutionX: number;
   resolutionY: number;
 }
+export interface PrintSettings{
+  mode?: string;  //'browser' | 'os'
+  osPrintOptions?: { showPrintDialog?: boolean; };  
+}

package/dist/types/WebTwain.Viewer.d.ts

@@ -233,9 +233,9 @@ export interface DynamsoftViewer {
 		y: string;  //Default is "center", values: "top", "bottom", "center"
 	} 
     /**
-     * Whether the viewer removes the focus border after selecting with the Tab key.  Default value: true.
+     * Whether the viewer displays the focus border after selecting with the Tab key.  Default value: false.
      */
-    disableFocusOutline: boolean;  // default value: true
+    focusOutlineEnabled: boolean;  // default value: false
     /**
      * [Scope] Main viewer
      * [Description] Return the index of the next image of the currently selected image.
@@ -366,7 +366,7 @@ export interface DynamsoftViewer {
      * [Description] Create a Dynamsoft Viewer instance and bind it to the WebTwain instance.
      * @param element Specify an HTML element to create the viewer.
      */
-    bind(element: HTMLDivElement | HTMLElement): boolean;
+    bind(element: HTMLDivElement | HTMLElement | string): boolean;
     /**
      * [Scope] Main viewer
      * [Description] Show the viewer (Main viewer, ImageEditor, ThumbnailViewer, CustomElement).
@@ -741,11 +741,11 @@ export interface ThumbnailViewer {
     scrollDirection: string;
     /**
      * [Scope] Thumbnail viewer
-     * [Description] Set the margin between images & the margin between image and the viewer border). The default value is 10.
+     * [Description] Set the pageMargin between images & the margin between image and the viewer border). The default value is 10.
      * [Usage Notes] 'Invalid property value' will be reported when the specified value type is wrong or the parameter name is spelled incorrectly.
      * number in pixels, string in percentage
      */
-    margin: number | string;
+    pageMargin: number | string;
     /**
      * [Scope] Thumbnail viewer
      * [Description] Set the background of the entire thumbnail viewer. The default value is white.
@@ -816,14 +816,14 @@ export interface ThumbnailViewer {
      * [Usage Notes] 'Invalid property value' will be reported when the specified value type is wrong or the parameter name is spelled incorrectly.
      * Allow any CSS rules
      */
-    hoverBackground: string;
+    hoverPageBackground: string;
     /**
      * [Scope] Thumbnail viewer
      * [Description] Set the image border when the mouse is hovered.
      * [Usage Notes] 'Invalid property value' will be reported when the specified value type is wrong or the parameter name is spelled incorrectly.
      * Allow any CSS rules
      */
-    hoverBorder: string;
+    hoverPageBorder: string;
     /**
      * [Scope] Thumbnail viewer
      * [Description] Set the background when dragging the image. The default value is yellow.
@@ -837,14 +837,14 @@ export interface ThumbnailViewer {
      * [Usage Notes] 'Invalid property value' will be reported when the specified value type is wrong or the parameter name is spelled incorrectly.
      * Allow any CSS rules
      */
-    selectedImageBorder: string;
+    selectedPageBorder: string;
     /**
      * [Scope] Thumbnail viewer
      * [Description] Set the background of the selected image.
      * [Usage Notes] 'Invalid property value' will be reported when the specified value type is wrong or the parameter name is spelled incorrectly.
      * Allow any CSS rules
      */
-    selectedImageBackground: string;
+    selectedPageBackground: string;
 }
 export interface DocumentEditor {
 	 /**

package/dist/types/WebTwain.d.ts

@@ -3,6 +3,7 @@ import { WebTwainViewer } from "./WebTwain.Viewer";
 import { BarcodeReader } from "./Addon.BarcodeReader";
 import { OCR } from "./Addon.OCR";
 import { OCRPro } from "./Addon.OCRPro";
+import { OCRKit } from "./Addon.OCRKit";
 import { PDF } from "./Addon.PDF";
 import { Webcam } from "./Addon.Webcam";
 
@@ -50,6 +51,7 @@ export interface Addon {
     BarcodeReader: BarcodeReader;
     OCR: OCR;
     OCRPro: OCRPro;
+    OCRKit: OCRKit;
     PDF: PDF;
     Webcam: Webcam;
 }

package/dist/types/index.d.ts

@@ -1,9 +1,4 @@
 // Project: https://www.dynamsoft.com/products/webtwain_overview.aspx
-// Definitions by: Xiao Ling <https://github.com/yushulx>
-//                 Josh Hall <https://github.com/jbh>
-//                 Lincoln Hu <https://github.com/lincoln2018>
-//                 Tom Kent <https://github.com/Tom-Dynamsoft>
-//                 Dave Sueltenfuss <https://github.com/dsueltenfuss>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 3.1
 
@@ -13,7 +8,7 @@
 *
 * Copyright 2025, Dynamsoft Corporation
 * Author: Dynamsoft Support Team
-* Version: 19.0
+* Version: 19.2
 */
 import Dynamsoft from "./Dynamsoft";
 export default Dynamsoft;

package/dwt-openapi.yaml

@@ -4229,6 +4229,11 @@ components:
             will be locked, if the scanner is a twain source, the source will be
             opened automatically. Recommend to set it as false, avoid your
             papers may be scanned by others.
+        requestFocusForScanningUI:
+          type: boolean
+          default: true
+          description: >-
+            If true, the scanner UI will be brought to the top and get focus.
         scannerFailureTimeout:
           type: integer
           format: int32