Fix langs TS typing (#570)

docs/image-format.md

@@ -1,17 +1,18 @@
 # Image Format
 
-Support Format: **bmp, jpg, png, pbm**
+The main Tesseract.js functions (ex. recognize, detect) take an `image` parameter.  The image formats and data types supported are listed below. 
 
-The main Tesseract.js functions (ex. recognize, detect) take an `image` parameter, which should be something that is like an image. What's considered "image-like" differs depending on whether it is being run from the browser or through NodeJS.
+Support Image Formats: **bmp, jpg, png, pbm, webp**
 
-On a browser, an image can be:
+For browser and Node, supported data types are:
-- an `img` or `canvas` element
+ - string with base64 encoded image (fits `data:image\/([a-zA-Z]*);base64,([^"]*)` regexp)
-- a `File` object (from a file `<input>`)
+ - buffer
-- a `Blob` object
-- a path or URL to an accessible image
-- a base64 encoded image fits `data:image\/([a-zA-Z]*);base64,([^"]*)` regexp
 
-In Node.js, an image can be
+For browser only, supported data types are:
-- a path to a local image
+ - `File` or `Blob` object
-- a Buffer storing binary image 
+ - `img` or `canvas` element
-- a base64 encoded image fits `data:image\/([a-zA-Z]*);base64,([^"]*)` regexp
+
+For Node only, supported data types are:
+ - string containing a path to local image
+
+Note: images must be a supported image format **and** a supported data type.  For example, a buffer containing a png image is supported.  A buffer containing raw pixel data is not supported. 

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "tesseract.js",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "tesseract.js",
-      "version": "3.0.2",
+      "version": "3.0.3",
       "hasInstallScript": true,
       "license": "Apache-2.0",
       "dependencies": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "tesseract.js",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "Pure Javascript Multilingual OCR",
   "main": "src/index.js",
   "types": "src/index.d.ts",

src/constants/PSM.js

@@ -15,4 +15,5 @@ module.exports = {
   SINGLE_CHAR: '10',
   SPARSE_TEXT: '11',
   SPARSE_TEXT_OSD: '12',
+  RAW_LINE: '13',
 };

src/index.d.ts

@@ -19,8 +19,8 @@ declare namespace Tesseract {
     readText(path: string, jobId?: string): Promise<ConfigResult>
     removeText(path: string, jobId?: string): Promise<ConfigResult>
     FS(method: string, args: any[], jobId?: string): Promise<ConfigResult>
-    loadLanguage(langs?: string, jobId?: string): Promise<ConfigResult>
+    loadLanguage(langs?: string | Lang[], jobId?: string): Promise<ConfigResult>
-    initialize(langs?: string, oem?: OEM, jobId?: string): Promise<ConfigResult>
+    initialize(langs?: string | Lang[], oem?: OEM, jobId?: string): Promise<ConfigResult>
     setParameters(params: Partial<WorkerParams>, jobId?: string): Promise<ConfigResult>
     recognize(image: ImageLike, options?: Partial<RecognizeOptions>, jobId?: string): Promise<RecognizeResult>
     detect(image: ImageLike, jobId?: string): Promise<DetectResult>
@@ -28,6 +28,11 @@ declare namespace Tesseract {
     getPDF(title?: string, textonly?: boolean, jobId?: string):Promise<GetPDFResult>
   }
 
+  interface Lang {
+    code: string;
+    data: unknown;
+  }
+
   interface WorkerOptions {
     corePath: string
     langPath: string
@@ -84,13 +89,13 @@ declare namespace Tesseract {
     width: number
     height: number
   }
-  const enum OEM {
+  enum OEM {
     TESSERACT_ONLY,
     LSTM_ONLY,
     TESSERACT_LSTM_COMBINED,
     DEFAULT,
   }
-  const enum PSM {
+  enum PSM {
     OSD_ONLY = '0',
     AUTO_OSD = '1',
     AUTO_ONLY = '2',

src/worker-script/index.js

@@ -144,15 +144,7 @@ res) => {
     res.progress({ workerId, status: 'loaded language traineddata', progress: 1 });
     res.resolve(langs);
   } catch (err) {
-    if (isWebWorker && err instanceof DOMException) {
+    res.reject(err.toString());
-      /*
-       * For some reason google chrome throw DOMException in loadLang,
-       * while other browser is OK, for now we ignore this exception
-       * and hopefully to find the root cause one day.
-       */
-    } else {
-      res.reject(err.toString());
-    }
   }
 };