zedbar 0.2.2 → 0.2.4

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zedbar",
   "description": "Fast QR code and barcode scanner for Node.js, powered by WebAssembly",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "license": "LGPL-3.0-or-later",
   "repository": {
     "type": "git",

package/zedbar.d.ts

@@ -34,10 +34,17 @@ export class DecodeResult {
   readonly symbolType: string;
   /**
    * Raw decoded bytes.
+   *
+   * For 2D codes (QR, SQ), these are the original bytes as encoded
+   * in the barcode, before any text encoding or base64 conversion.
    */
   readonly data: Uint8Array;
   /**
-   * Decoded data as UTF-8 text, or null if not valid UTF-8.
+   * Decoded data as text, or null if not decodable as text.
+   *
+   * For 2D codes, the text is produced by detecting the encoding (UTF-8,
+   * Shift-JIS, Windows-1252, etc.) and converting to a UTF-8 string.
+   * For linear barcodes, the data is always ASCII text.
    */
   readonly text: string | undefined;
 }

package/zedbar.js

@@ -179,6 +179,9 @@ class DecodeResult {
     }
     /**
      * Raw decoded bytes.
+     *
+     * For 2D codes (QR, SQ), these are the original bytes as encoded
+     * in the barcode, before any text encoding or base64 conversion.
      * @returns {Uint8Array}
      */
     get data() {
@@ -188,7 +191,11 @@ class DecodeResult {
         return v1;
     }
     /**
-     * Decoded data as UTF-8 text, or null if not valid UTF-8.
+     * Decoded data as text, or null if not decodable as text.
+     *
+     * For 2D codes, the text is produced by detecting the encoding (UTF-8,
+     * Shift-JIS, Windows-1252, etc.) and converting to a UTF-8 string.
+     * For linear barcodes, the data is always ASCII text.
      * @returns {string | undefined}
      */
     get text() {