@sythos/js_barcode_universal 1.5.7 → 1.5.9

package/src/index.js

@@ -28,7 +28,6 @@
  *
  * Original work. No code from any other barcode implementation.
  */
-
 /**
  * Sythos Barcode Suite — public API.
  *
@@ -45,57 +44,46 @@
  *
  * @module @sythos/js_barcode_universal
  */
-
-import { BitMatrix } from './core/bit-matrix.js';
-import { EncodeError, NotFoundError } from './core/errors.js';
-import { LuminanceSource } from './image/luminance.js';
-import { binarize } from './image/binarizer.js';
-import { ONED_FORMATS } from './oned/index.js';
-import { decodeOneD } from './oned/reader.js';
-import * as datamatrix from './datamatrix/index.js';
-import * as qr from './qr/index.js';
-import * as aztec from './aztec/index.js';
-import * as pdf417 from './pdf417/index.js';
-import * as micropdf417 from './micropdf417/index.js';
-import * as microqr from './microqr/index.js';
-import * as rmqr from './rmqr/index.js';
-import * as frameqr from './frameqr/index.js';
-import * as aztecRune from './aztecrune/index.js';
-import * as compactPdf417 from './compactpdf417/index.js';
-import * as databar from './databar/index.js';
-
+import { BitMatrix } from './js/core/bit-matrix.js';
+import { EncodeError, NotFoundError } from './js/core/errors.js';
+import { LuminanceSource } from './js/image/luminance.js';
+import { binarize } from './js/image/binarizer.js';
+import { ONED_FORMATS } from './js/oned/index.js';
+import { decodeOneD } from './js/oned/reader.js';
+import * as datamatrix from './js/datamatrix/index.js';
+import * as qr from './js/qr/index.js';
+import * as aztec from './js/aztec/index.js';
+import * as pdf417 from './js/pdf417/index.js';
+import * as micropdf417 from './js/micropdf417/index.js';
+import * as microqr from './js/microqr/index.js';
+import * as rmqr from './js/rmqr/index.js';
+import * as frameqr from './js/frameqr/index.js';
+import * as aztecRune from './js/aztecrune/index.js';
+import * as compactPdf417 from './js/compactpdf417/index.js';
+import * as databar from './js/databar/index.js';
 export { BitMatrix };
-export {
-  BarcodeError, EncodeError, NotFoundError, FormatError, ChecksumError,
-} from './core/errors.js';
-export { LuminanceSource } from './image/luminance.js';
-export { binarize, binarizeGlobal, binarizeHybrid } from './image/binarizer.js';
-export * from './oned/index.js';
-export { toSVG, toSVGDataURI } from './render/svg.js';
-export { toImageData, toCanvas } from './render/image-data.js';
-export { toPNG, toPNGDataURI } from './render/png.js';
-export { renderToCanvasAuto, isWebGL2Available } from './render/index.js';
-export { renderToCanvasAutoAsync, isWebGPUAvailable } from './render/index.js';
-export { encodeQR, decodeQR, detectQR, detectAndDecodeQR } from './qr/index.js';
-export {
-  encodeDataMatrix, decodeDataMatrix, detectDataMatrix, detectAndDecodeDataMatrix,
-} from './datamatrix/index.js';
-export { encodeAztec, decodeAztec, detectAztec, detectAndDecodeAztec } from './aztec/index.js';
-export * from './aztecrune/index.js';
-export { encodePDF417, decodePDF417, detectPDF417, detectAndDecodePDF417 } from './pdf417/index.js';
-export * from './compactpdf417/index.js';
-  // DataBar exports include both the verified GTIN/data layer and the
-  // Omnidirectional/Truncated physical image path.
-export * from './databar/index.js';
-export {
-  encodeMicroPDF417, decodeMicroPDF417, detectMicroPDF417, detectAndDecodeMicroPDF417,
-} from './micropdf417/index.js';
-export { encodeMicroQR, decodeMicroQR, detectMicroQR, detectAndDecodeMicroQR } from './microqr/index.js';
-export { encodeRMQR, decodeRMQR, detectRMQR, detectAndDecodeRMQR } from './rmqr/index.js';
-export {
-  encodeFrameQR, decodeFrameQR, detectFrameQR, detectAndDecodeFrameQR,
-} from './frameqr/index.js';
-
+export { BarcodeError, EncodeError, NotFoundError, FormatError, ChecksumError, } from './js/core/errors.js';
+export { LuminanceSource } from './js/image/luminance.js';
+export { binarize, binarizeGlobal, binarizeHybrid } from './js/image/binarizer.js';
+export * from './js/oned/index.js';
+export { toSVG, toSVGDataURI } from './js/render/svg.js';
+export { toImageData, toCanvas } from './js/render/image-data.js';
+export { toPNG, toPNGDataURI } from './js/render/png.js';
+export { renderToCanvasAuto, isWebGL2Available } from './js/render/index.js';
+export { renderToCanvasAutoAsync, isWebGPUAvailable } from './js/render/index.js';
+export { encodeQR, decodeQR, detectQR, detectAndDecodeQR } from './js/qr/index.js';
+export { encodeDataMatrix, decodeDataMatrix, detectDataMatrix, detectAndDecodeDataMatrix, } from './js/datamatrix/index.js';
+export { encodeAztec, decodeAztec, detectAztec, detectAndDecodeAztec } from './js/aztec/index.js';
+export * from './js/aztecrune/index.js';
+export { encodePDF417, decodePDF417, detectPDF417, detectAndDecodePDF417 } from './js/pdf417/index.js';
+export * from './js/compactpdf417/index.js';
+// DataBar exports include both the verified GTIN/data layer and the
+// Omnidirectional/Truncated physical image path.
+export * from './js/databar/index.js';
+export { encodeMicroPDF417, decodeMicroPDF417, detectMicroPDF417, detectAndDecodeMicroPDF417, } from './js/micropdf417/index.js';
+export { encodeMicroQR, decodeMicroQR, detectMicroQR, detectAndDecodeMicroQR } from './js/microqr/index.js';
+export { encodeRMQR, decodeRMQR, detectRMQR, detectAndDecodeRMQR } from './js/rmqr/index.js';
+export { encodeFrameQR, decodeFrameQR, detectFrameQR, detectAndDecodeFrameQR, } from './js/frameqr/index.js';
 /**
  * @typedef {object} FormatInfo
  * @property {string} id
@@ -105,7 +93,6 @@ export {
  * @property {'1D' | '2D'} kind
  * @property {'supplement'} [role]
  */
-
 // Writing and reading a format are separate capabilities that can land at
 // different times, so they are reported separately rather than collapsed into
 // one "supported" flag that would be wrong in one direction or the other.
@@ -116,9 +103,9 @@ export {
 // value.
 const qrPresent = qr.QR_PLACEHOLDER !== true;
 const qrCanEncode = qrPresent &&
-  typeof qr.encodeQR === 'function' && qr.QR_CAN_ENCODE !== false;
+    typeof qr.encodeQR === 'function' && qr.QR_CAN_ENCODE !== false;
 const qrCanDecode = qrPresent &&
-  typeof qr.detectAndDecodeQR === 'function' && qr.QR_CAN_DECODE !== false;
+    typeof qr.detectAndDecodeQR === 'function' && qr.QR_CAN_DECODE !== false;
 const dataMatrixCanEncode = typeof datamatrix.encodeDataMatrix === 'function';
 const dataMatrixCanDecode = typeof datamatrix.detectAndDecodeDataMatrix === 'function';
 const aztecCanEncode = typeof aztec.encodeAztec === 'function';
@@ -143,7 +130,6 @@ const compactPdf417CanEncode = typeof compactPdf417.encodeCompactPDF417 === 'fun
 const compactPdf417CanDecode = typeof compactPdf417.detectAndDecodeCompactPDF417 === 'function';
 const dataBarCanEncode = typeof databar.encodeDataBar14 === 'function';
 const dataBarCanDecode = typeof databar.decodeDataBar14Scanline === 'function';
-
 /**
  * Every format this build supports.
  *
@@ -155,96 +141,93 @@ const dataBarCanDecode = typeof databar.decodeDataBar14Scanline === 'function';
  * @returns {FormatInfo[]}
  */
 export function listFormats() {
-  const formats = Object.entries(ONED_FORMATS).map(([id, info]) => ({
-    id,
-    label: info.label,
-    canWrite: true,
-    canRead: info.readable,
-    kind: /** @type {'1D'} */ ('1D'),
-    ...(info.role ? { role: info.role } : {}),
-  }));
-
-  formats.push({
-    id: 'qr',
-    label: 'QR Code',
-    canWrite: qrCanEncode,
-    canRead: qrCanDecode,
-    kind: /** @type {'2D'} */ ('2D'),
-  });
-  formats.push({
-    id: 'datamatrix',
-    label: 'Data Matrix ECC 200',
-    canWrite: dataMatrixCanEncode,
-    canRead: dataMatrixCanDecode,
-    kind: /** @type {'2D'} */ ('2D'),
-  });
-  formats.push({
-    id: 'aztec',
-    label: 'Aztec Code',
-    canWrite: aztecCanEncode,
-    canRead: aztecCanDecode,
-    kind: /** @type {'2D'} */ ('2D'),
-  });
-  formats.push({
-    id: 'aztecrune',
-    label: 'Aztec Rune',
-    canWrite: aztecRuneCanEncode,
-    canRead: aztecRuneCanDecode,
-    kind: /** @type {'2D'} */ ('2D'),
-  });
-  formats.push({
-    id: 'pdf417',
-    label: 'PDF417',
-    canWrite: pdf417CanEncode,
-    canRead: pdf417CanDecode,
-    kind: /** @type {'2D'} */ ('2D'),
-  });
-  formats.push({
-    id: 'compactpdf417',
-    label: 'Compact PDF417',
-    canWrite: compactPdf417CanEncode,
-    canRead: compactPdf417CanDecode,
-    kind: /** @type {'2D'} */ ('2D'),
-  });
-  formats.push({
-    id: 'micropdf417',
-    label: 'MicroPDF417',
-    canWrite: microPdf417CanEncode,
-    canRead: microPdf417CanDecode,
-    kind: /** @type {'2D'} */ ('2D'),
-  });
-  formats.push({
-    id: 'microqr',
-    label: 'Micro QR Code',
-    canWrite: microQrCanEncode,
-    canRead: microQrCanDecode,
-    kind: /** @type {'2D'} */ ('2D'),
-  });
-  formats.push({
-    id: 'rmqr',
-    label: 'rMQR Code',
-    canWrite: rmqrCanEncode,
-    canRead: rmqrCanDecode,
-    kind: /** @type {'2D'} */ ('2D'),
-  });
-  formats.push({
-    id: 'frameqr',
-    label: 'FrameQR Code',
-    canWrite: frameQrCanEncode,
-    canRead: frameQrCanDecode,
-    kind: /** @type {'2D'} */ ('2D'),
-  });
-  formats.push({
-    id: 'gs1databar14',
-    label: 'GS1 DataBar Omnidirectional / Truncated',
-    canWrite: dataBarCanEncode,
-    canRead: dataBarCanDecode,
-    kind: /** @type {'1D'} */ ('1D'),
-  });
-
-  return formats;
+    const formats = Object.entries(ONED_FORMATS).map(([id, info]) => ({
+        id,
+        label: info.label,
+        canWrite: true,
+        canRead: info.readable,
+        kind: /** @type {'1D'} */ ('1D'),
+        ...(info.role ? { role: info.role } : {}),
+    }));
+    formats.push({
+        id: 'qr',
+        label: 'QR Code',
+        canWrite: qrCanEncode,
+        canRead: qrCanDecode,
+        kind: /** @type {'2D'} */ ('2D'),
+    });
+    formats.push({
+        id: 'datamatrix',
+        label: 'Data Matrix ECC 200',
+        canWrite: dataMatrixCanEncode,
+        canRead: dataMatrixCanDecode,
+        kind: /** @type {'2D'} */ ('2D'),
+    });
+    formats.push({
+        id: 'aztec',
+        label: 'Aztec Code',
+        canWrite: aztecCanEncode,
+        canRead: aztecCanDecode,
+        kind: /** @type {'2D'} */ ('2D'),
+    });
+    formats.push({
+        id: 'aztecrune',
+        label: 'Aztec Rune',
+        canWrite: aztecRuneCanEncode,
+        canRead: aztecRuneCanDecode,
+        kind: /** @type {'2D'} */ ('2D'),
+    });
+    formats.push({
+        id: 'pdf417',
+        label: 'PDF417',
+        canWrite: pdf417CanEncode,
+        canRead: pdf417CanDecode,
+        kind: /** @type {'2D'} */ ('2D'),
+    });
+    formats.push({
+        id: 'compactpdf417',
+        label: 'Compact PDF417',
+        canWrite: compactPdf417CanEncode,
+        canRead: compactPdf417CanDecode,
+        kind: /** @type {'2D'} */ ('2D'),
+    });
+    formats.push({
+        id: 'micropdf417',
+        label: 'MicroPDF417',
+        canWrite: microPdf417CanEncode,
+        canRead: microPdf417CanDecode,
+        kind: /** @type {'2D'} */ ('2D'),
+    });
+    formats.push({
+        id: 'microqr',
+        label: 'Micro QR Code',
+        canWrite: microQrCanEncode,
+        canRead: microQrCanDecode,
+        kind: /** @type {'2D'} */ ('2D'),
+    });
+    formats.push({
+        id: 'rmqr',
+        label: 'rMQR Code',
+        canWrite: rmqrCanEncode,
+        canRead: rmqrCanDecode,
+        kind: /** @type {'2D'} */ ('2D'),
+    });
+    formats.push({
+        id: 'frameqr',
+        label: 'Sythos Canvas QR profile',
+        canWrite: frameQrCanEncode,
+        canRead: frameQrCanDecode,
+        kind: /** @type {'2D'} */ ('2D'),
+    });
+    formats.push({
+        id: 'gs1databar14',
+        label: 'GS1 DataBar Omnidirectional / Truncated',
+        canWrite: dataBarCanEncode,
+        canRead: dataBarCanDecode,
+        kind: /** @type {'1D'} */ ('1D'),
+    });
+    return formats;
 }
-
 /**
  * Encode a payload into a barcode matrix.
  *
@@ -271,7 +254,7 @@ export function listFormats() {
  * @param {'auto'|'text'|'byte'|'numeric'} [options.compaction] PDF417 compaction mode.
  * @param {number} [options.eci] MicroPDF417 byte-compaction ECI assignment (3 or 26).
  * @param {number} [options.aspectRatio] Preferred MicroPDF417 symbol aspect ratio.
- * @param {object} [options.canvas] FrameQR Code artwork reservation.
+ * @param {object} [options.canvas] Sythos Canvas QR artwork reservation.
  * @param {'square'|'circle'|'diamond'} [options.canvas.shape] Canvas shape.
  * @param {number} [options.canvas.size] Odd canvas size in QR modules.
  * @param {number} [options.canvas.width] Canvas width in QR modules.
@@ -282,51 +265,48 @@ export function listFormats() {
  * @returns {BitMatrix}
  */
 export function encode(text, options = {}) {
-  const format = String(options.format ?? 'qr').toLowerCase();
-  const value = typeof text === 'number' ? String(text) : text;
-
-  if (format === 'qr' || format === 'qrcode') {
-    return qr.encodeQR(value, options);
-  }
-  if (format === 'datamatrix' || format === 'data-matrix') {
-    return datamatrix.encodeDataMatrix(value, options);
-  }
-  if (format === 'aztec' || format === 'aztec-code') {
-    return aztec.encodeAztec(value, options);
-  }
-  if (format === 'aztecrune' || format === 'aztec-rune' || format === 'rune') {
-    return aztecRune.encodeAztecRune(value, options);
-  }
-  if (format === 'pdf417' || format === 'pdf-417') {
-    return pdf417.encodePDF417(value, options);
-  }
-  if (format === 'compactpdf417' || format === 'compact-pdf417' || format === 'compact-pdf-417') {
-    return compactPdf417.encodeCompactPDF417(value, options);
-  }
-  if (format === 'micropdf417' || format === 'micro-pdf417' || format === 'micro-pdf-417') {
-    return micropdf417.encodeMicroPDF417(value, options);
-  }
-  if (format === 'microqr' || format === 'micro-qr') {
-    return microqr.encodeMicroQR(value, options);
-  }
-  if (format === 'rmqr' || format === 'r-mqr' || format === 'rectangular-micro-qr') {
-    return rmqr.encodeRMQR(value, options);
-  }
-  if (format === 'frameqr' || format === 'frame-qr' || format === 'canvas-qr') {
-    return frameqr.encodeFrameQR(value, options);
-  }
-  if (format === 'gs1databar14' || format === 'gs1-databar14' || format === 'databar') {
-    return databar.encodeDataBar14(value, options);
-  }
-
-  const entry = ONED_FORMATS[format];
-  if (!entry) {
-    const known = [...Object.keys(ONED_FORMATS), 'qr', 'datamatrix', 'aztec', 'aztecrune', 'pdf417', 'compactpdf417', 'micropdf417', 'microqr', 'rmqr', 'frameqr', 'gs1databar14'].join(', ');
-    throw new EncodeError(`Unknown format "${format}". Known formats: ${known}`);
-  }
-  return entry.encode(value, options);
+    const format = String(options.format ?? 'qr').toLowerCase();
+    const value = typeof text === 'number' ? String(text) : text;
+    if (format === 'qr' || format === 'qrcode') {
+        return qr.encodeQR(value, options);
+    }
+    if (format === 'datamatrix' || format === 'data-matrix') {
+        return datamatrix.encodeDataMatrix(value, options);
+    }
+    if (format === 'aztec' || format === 'aztec-code') {
+        return aztec.encodeAztec(value, options);
+    }
+    if (format === 'aztecrune' || format === 'aztec-rune' || format === 'rune') {
+        return aztecRune.encodeAztecRune(value, options);
+    }
+    if (format === 'pdf417' || format === 'pdf-417') {
+        return pdf417.encodePDF417(value, options);
+    }
+    if (format === 'compactpdf417' || format === 'compact-pdf417' || format === 'compact-pdf-417') {
+        return compactPdf417.encodeCompactPDF417(value, options);
+    }
+    if (format === 'micropdf417' || format === 'micro-pdf417' || format === 'micro-pdf-417') {
+        return micropdf417.encodeMicroPDF417(value, options);
+    }
+    if (format === 'microqr' || format === 'micro-qr') {
+        return microqr.encodeMicroQR(value, options);
+    }
+    if (format === 'rmqr' || format === 'r-mqr' || format === 'rectangular-micro-qr') {
+        return rmqr.encodeRMQR(value, options);
+    }
+    if (format === 'frameqr' || format === 'frame-qr' || format === 'canvas-qr') {
+        return frameqr.encodeFrameQR(value, options);
+    }
+    if (format === 'gs1databar14' || format === 'gs1-databar14' || format === 'databar') {
+        return databar.encodeDataBar14(value, options);
+    }
+    const entry = ONED_FORMATS[format];
+    if (!entry) {
+        const known = [...Object.keys(ONED_FORMATS), 'qr', 'datamatrix', 'aztec', 'aztecrune', 'pdf417', 'compactpdf417', 'micropdf417', 'microqr', 'rmqr', 'frameqr', 'gs1databar14'].join(', ');
+        throw new EncodeError(`Unknown format "${format}". Known formats: ${known}`);
+    }
+    return entry.encode(value, options);
 }
-
 /**
  * @typedef {object} DecodeResult
  * @property {string} text
@@ -344,13 +324,13 @@ export function encode(text, options = {}) {
  * @property {number} [rowHeight] PDF417 row height in modules.
  * @property {number} [variant] MicroPDF417 predefined variant number.
  * @property {number} [eccCodewords] MicroPDF417 fixed error-correction codewords.
- * @property {string} [profile] FrameQR Code profile identifier.
+ * @property {string} [profile] Sythos Canvas QR profile identifier.
  * @property {boolean} [certified] Whether the profile is certified by its originator.
- * @property {object} [canvas] Canvas reservation metadata for the FrameQR Code profile.
+ * @property {object} [canvas] Canvas reservation metadata for the Sythos profile.
  * @property {{format:'ean2'|'ean5', text:string, parity:string, checksum?:number}} [addon] Attached EAN/UPC supplement.
  * @property {number} [confidence] Camera-profile confidence from 0 to 1.
  * @property {{x:number,y:number,width:number,height:number}} [bounds] Camera-profile bounds in the scanned orientation.
- * @property {0|90|180|270} [rotation] Camera-profile orientation in degrees.
+ * @property {0|45|90|135|180|225|270|315} [rotation] Camera-profile orientation in degrees.
  * @property {{quietZone:boolean,checksum:boolean|null,rows:number|null,consistency:number|null}} [quality] Camera-profile validation evidence.
  * @property {boolean} [gs1] Whether the physical symbol is classified as GS1.
  * @property {string} [symbologyIdentifier] GS1 symbology identifier.
@@ -359,7 +339,6 @@ export function encode(text, options = {}) {
  * @property {string} [gtin] GS1 DataBar GTIN-14 payload.
  * @property {boolean} [linkage] GS1 DataBar linkage flag.
  */
-
 /**
  * Find and decode every barcode in an image.
  *
@@ -372,254 +351,420 @@ export function encode(text, options = {}) {
  * @param {string[]} [options.formats] Restrict to these format ids.
  * @param {boolean} [options.tryHarder] Retry inverted and rotated. Default true.
  * @param {'global'|'hybrid'|'auto'} [options.binarizer]
- * @param {'camera'} [options.profile] Opt-in strict camera profile for validated 1D reads.
- * @param {object} [options.frameqr] FrameQR Code detector options when
+ * @param {'camera'} [options.profile] Opt-in strict camera profile for validated reads.
+ * @param {object} [options.frameqr] Sythos Canvas QR detector options when
  *   the profile marker is not preserved through image rendering.
  * @returns {DecodeResult[]}
  */
 export function decode(image, options = {}) {
-  const { formats = null, tryHarder = true, binarizer = 'auto', profile = null } = options;
-  const want = formats ? new Set(formats.map((f) => f.toLowerCase())) : null;
-  const wantQR = !want || want.has('qr') || want.has('qrcode');
-  const wantDataMatrix = !want || want.has('datamatrix') || want.has('data-matrix');
-  const wantAztec = !want || want.has('aztec') || want.has('aztec-code');
-  const wantAztecRune = !want || want.has('aztecrune') || want.has('aztec-rune') || want.has('rune');
-  const wantPDF417 = !want || want.has('pdf417') || want.has('pdf-417');
-  const wantCompactPDF417 = !want || want.has('compactpdf417') || want.has('compact-pdf417') || want.has('compact-pdf-417');
-  const wantMicroPDF417 = !want || want.has('micropdf417') || want.has('micro-pdf417') || want.has('micro-pdf-417');
-  const wantMicroQR = !want || want.has('microqr') || want.has('micro-qr');
-  const wantRMQR = !want || want.has('rmqr') || want.has('r-mqr') || want.has('rectangular-micro-qr');
-  const wantFrameQR = !want || want.has('frameqr') || want.has('frame-qr') || want.has('canvas-qr');
-  const oneDAliases = new Set(['gs1databar14', 'databar', 'gs1-databar14']);
-  const wantOneD = !want || [...want].some((f) => f in ONED_FORMATS || oneDAliases.has(f));
-
-  const source = LuminanceSource.fromImageData(image);
-  const results = [];
-
-  // Light-on-dark symbols are common on screens and packaging, so a second
-  // inverted pass is worth the cost when the first finds nothing.
-  const passes = tryHarder ? [source, source.invert()] : [source];
-
-  for (const pass of passes) {
-    const bits = binarize(pass, binarizer);
-
-    if (wantQR && qrCanDecode) {
-      try {
-        for (const found of qr.detectAndDecodeQR(bits)) {
-          results.push({ ...found, format: 'qr' });
-        }
-      } catch {
-        /* no QR in this pass */
-      }
-    }
-
-    if (wantDataMatrix && dataMatrixCanDecode) {
-      // Hybrid thresholding can erase the interior of very large, perfectly
-      // uniform modules. In auto mode keep the local-threshold attempt, then
-      // retry Data Matrix once with the global threshold before giving up.
-      const dataMatrixBits = binarizer === 'auto' ? [bits, binarize(pass, 'global')] : [bits];
-      for (const candidateBits of dataMatrixBits) {
-        try {
-          const found = datamatrix.detectAndDecodeDataMatrix(candidateBits);
-          if (found) { results.push({ ...found, format: 'datamatrix' }); break; }
-        } catch {
-          /* no Data Matrix with this threshold */
+    const { formats = null, tryHarder = true, binarizer = 'auto', profile = null } = options;
+    const want = formats ? new Set(formats.map((f) => f.toLowerCase())) : null;
+    const wantQR = !want || want.has('qr') || want.has('qrcode');
+    const wantDataMatrix = !want || want.has('datamatrix') || want.has('data-matrix');
+    const wantAztec = !want || want.has('aztec') || want.has('aztec-code');
+    const wantAztecRune = !want || want.has('aztecrune') || want.has('aztec-rune') || want.has('rune');
+    const wantPDF417 = !want || want.has('pdf417') || want.has('pdf-417');
+    const wantCompactPDF417 = !want || want.has('compactpdf417') || want.has('compact-pdf417') || want.has('compact-pdf-417');
+    const wantMicroPDF417 = !want || want.has('micropdf417') || want.has('micro-pdf417') || want.has('micro-pdf-417');
+    const wantMicroQR = !want || want.has('microqr') || want.has('micro-qr');
+    const wantRMQR = !want || want.has('rmqr') || want.has('r-mqr') || want.has('rectangular-micro-qr');
+    const wantFrameQR = !want || want.has('frameqr') || want.has('frame-qr') || want.has('canvas-qr');
+    const oneDAliases = new Set(['gs1databar14', 'databar', 'gs1-databar14']);
+    const wantOneD = !want || [...want].some((f) => f in ONED_FORMATS || oneDAliases.has(f));
+    const wantTwoD = wantQR || wantDataMatrix || wantAztec || wantAztecRune || wantPDF417
+        || wantCompactPDF417 || wantMicroPDF417 || wantMicroQR || wantRMQR || wantFrameQR;
+    const source = LuminanceSource.fromImageData(image);
+    const results = [];
+    // Light-on-dark symbols are common on screens and packaging, so a second
+    // inverted pass is worth the cost when the first finds nothing.
+    const passes = tryHarder ? [source, source.invert()] : [source];
+    for (const pass of passes) {
+        const bits = binarize(pass, binarizer);
+        // Keep all two-dimensional detector calls in one helper so camera-only
+        // orientation retries use exactly the same validation path as the native
+        // orientation. Arbitrary-angle retries remain opt-in to the camera
+        // profile because resampling is intentionally not part of ordinary decode.
+        const readTwoD = (candidateBits, cameraRotation = 0, candidateSource = pass) => {
+            const before = results.length;
+            const add = (found, format) => {
+                if (!found)
+                    return;
+                const publicFound = { ...found, format };
+                if (profile === 'camera' && cameraRotation !== 0)
+                    publicFound.rotation = cameraRotation;
+                results.push(publicFound);
+            };
+            if (wantQR && qrCanDecode) {
+                try {
+                    for (const found of qr.detectAndDecodeQR(candidateBits))
+                        add(found, 'qr');
+                }
+                catch {
+                    /* no QR in this pass */
+                }
+            }
+            if (wantDataMatrix && dataMatrixCanDecode) {
+                // Hybrid thresholding can erase the interior of very large, perfectly
+                // uniform modules. In auto mode keep the local-threshold attempt, then
+                // retry Data Matrix once with the global threshold before giving up.
+                const dataMatrixBits = binarizer === 'auto'
+                    ? [candidateBits, binarize(candidateSource, 'global')]
+                    : [candidateBits];
+                for (const thresholdBits of dataMatrixBits) {
+                    try {
+                        const found = datamatrix.detectAndDecodeDataMatrix(thresholdBits);
+                        if (found) {
+                            add(found, 'datamatrix');
+                            break;
+                        }
+                    }
+                    catch {
+                        /* no Data Matrix with this threshold */
+                    }
+                }
+            }
+            if (wantAztec && aztecCanDecode) {
+                // The central bull's-eye is a small, high-contrast target. Hybrid
+                // thresholding can flatten it on clean rendered symbols, so mirror the
+                // Data Matrix global fallback in auto mode.
+                const aztecBits = binarizer === 'auto'
+                    ? [candidateBits, binarize(candidateSource, 'global')]
+                    : [candidateBits];
+                for (const thresholdBits of aztecBits) {
+                    try {
+                        const found = aztec.detectAndDecodeAztec(thresholdBits);
+                        if (found) {
+                            add(found, 'aztec');
+                            break;
+                        }
+                    }
+                    catch {
+                        /* no Aztec code with this threshold */
+                    }
+                }
+            }
+            if (wantAztecRune && aztecRuneCanDecode) {
+                try {
+                    const found = aztecRune.detectAndDecodeAztecRune(candidateBits);
+                    if (found)
+                        add(found, 'aztecrune');
+                }
+                catch {
+                    /* no Aztec Rune in this pass */
+                }
+            }
+            if (wantPDF417 && pdf417CanDecode) {
+                try {
+                    const found = pdf417.detectAndDecodePDF417(candidateBits);
+                    if (found)
+                        add(found, 'pdf417');
+                }
+                catch {
+                    /* no PDF417 in this pass */
+                }
+            }
+            if (wantCompactPDF417 && compactPdf417CanDecode) {
+                try {
+                    const found = compactPdf417.detectAndDecodeCompactPDF417(candidateBits);
+                    if (found)
+                        add(found, 'compactpdf417');
+                }
+                catch {
+                    /* no Compact PDF417 in this pass */
+                }
+            }
+            if (wantMicroPDF417 && microPdf417CanDecode) {
+                // MicroPDF417 detection measures runs across the whole raster. Hybrid
+                // thresholding can alter uniform modules near local-window boundaries,
+                // so retry the global threshold in auto mode as for the other 2D codes.
+                const microPdf417Bits = binarizer === 'auto'
+                    ? [candidateBits, binarize(candidateSource, 'global')]
+                    : [candidateBits];
+                for (const thresholdBits of microPdf417Bits) {
+                    try {
+                        const found = micropdf417.detectAndDecodeMicroPDF417(thresholdBits);
+                        if (found) {
+                            add(found, 'micropdf417');
+                            break;
+                        }
+                    }
+                    catch {
+                        /* no MicroPDF417 with this threshold */
+                    }
+                }
+            }
+            if (wantMicroQR && microQrCanDecode) {
+                try {
+                    for (const found of microqr.detectAndDecodeMicroQR(candidateBits))
+                        add(found, 'microqr');
+                }
+                catch {
+                    /* no Micro QR in this pass */
+                }
+            }
+            if (wantRMQR && rmqrCanDecode) {
+                try {
+                    const found = rmqr.detectAndDecodeRMQR(candidateBits);
+                    if (found)
+                        add(found, 'rmqr');
+                }
+                catch {
+                    /* no rMQR in this pass */
+                }
+            }
+            if (wantFrameQR && frameQrCanDecode) {
+                try {
+                    for (const found of frameqr.detectAndDecodeFrameQR(candidateBits, options.frameqr ?? {}))
+                        add(found, 'frameqr');
+                }
+                catch {
+                    /* no Sythos Canvas QR profile in this pass */
+                }
+            }
+            return results.length > before;
+        };
+        const twoDFound = readTwoD(bits);
+        if (profile === 'camera' && wantTwoD && !twoDFound) {
+            // Normalize a camera frame through the full eight-angle set only after
+            // the native orientation has failed. This preserves the fast path while
+            // limiting resampling to frames that need it.
+            const cameraRotations = [45, 90, 135, 180, 225, 270, 315];
+            for (const rotation of cameraRotations) {
+                const inverse = (360 - rotation) % 360;
+                const orientedSource = inverse % 90 === 0
+                    ? inverse === 0
+                        ? pass
+                        : inverse === 90
+                            ? pass.rotate90()
+                            : inverse === 180
+                                ? rotateLuminanceSourceByDegrees(pass, 180)
+                                : pass.rotate90().rotate90().rotate90()
+                    : rotateLuminanceSourceByDegrees(pass, inverse);
+                if (readTwoD(binarize(orientedSource, binarizer), rotation, orientedSource))
+                    break;
+            }
         }
-      }
-    }
-
-    if (wantAztec && aztecCanDecode) {
-      // The central bull's-eye is a small, high-contrast target. Hybrid
-      // thresholding can flatten it on clean rendered symbols, so mirror the
-      // Data Matrix global fallback in auto mode.
-      const aztecBits = binarizer === 'auto' ? [bits, binarize(pass, 'global')] : [bits];
-      for (const candidateBits of aztecBits) {
-        try {
-          const found = aztec.detectAndDecodeAztec(candidateBits);
-          if (found) { results.push({ ...found, format: 'aztec' }); break; }
-        } catch {
-          /* no Aztec code with this threshold */
-        }
-      }
-    }
-
-    if (wantAztecRune && aztecRuneCanDecode) {
-      try {
-        const found = aztecRune.detectAndDecodeAztecRune(bits);
-        if (found) results.push({ ...found, format: 'aztecrune' });
-      } catch {
-        /* no Aztec Rune in this pass */
-      }
-    }
-
-    if (wantPDF417 && pdf417CanDecode) {
-      try {
-        const found = pdf417.detectAndDecodePDF417(bits);
-        if (found) results.push({ ...found, format: 'pdf417' });
-      } catch {
-        /* no PDF417 in this pass */
-      }
-    }
-
-    if (wantCompactPDF417 && compactPdf417CanDecode) {
-      try {
-        const found = compactPdf417.detectAndDecodeCompactPDF417(bits);
-        if (found) results.push({ ...found, format: 'compactpdf417' });
-      } catch {
-        /* no Compact PDF417 in this pass */
-      }
-    }
-
-    if (wantMicroPDF417 && microPdf417CanDecode) {
-      // MicroPDF417 detection measures runs across the whole raster. Hybrid
-      // thresholding can alter uniform modules near local-window boundaries,
-      // so retry the global threshold in auto mode as for the other 2D codes.
-      const microPdf417Bits = binarizer === 'auto' ? [bits, binarize(pass, 'global')] : [bits];
-      for (const candidateBits of microPdf417Bits) {
-        try {
-          const found = micropdf417.detectAndDecodeMicroPDF417(candidateBits);
-          if (found) { results.push({ ...found, format: 'micropdf417' }); break; }
-        } catch {
-          /* no MicroPDF417 with this threshold */
-        }
-      }
-    }
-
-    if (wantMicroQR && microQrCanDecode) {
-      try {
-        for (const found of microqr.detectAndDecodeMicroQR(bits)) {
-          results.push({ ...found, format: 'microqr' });
+        if (wantOneD) {
+            const oneDFormats = want
+                ? [...want].filter((f) => f in ONED_FORMATS || oneDAliases.has(f))
+                : null;
+            const oneDPasses = [{ bits, rotation: 0 }];
+            // A linear symbol rotated away from the horizontal has no usable
+            // horizontal scanline. The strict camera profile adds normalized
+            // orientations only when the native orientation found no validated 1D
+            // result. Keep the two quarter-turns first: they are the established
+            // path and avoid paying for diagonal resampling on the common case.
+            const readOneD = (candidateBits, rotation) => decodeOneD(candidateBits, {
+                ...options, formats: oneDFormats, tryHarder, profile, cameraRotation: rotation,
+            });
+            let oneDResults = readOneD(bits, 0);
+            if (profile === 'camera' && oneDResults.length === 0) {
+                // `rotation` describes the supplied raster, clockwise from the
+                // canonical horizontal orientation. To normalize it, apply the
+                // inverse rotation.  Include 180 explicitly so the full eight-angle
+                // set still works when tryHarder is disabled (the normal reversed-row
+                // pass also handles it without a second raster transform).
+                const cameraRotations = [90, 270, 180, 45, 135, 225, 315];
+                for (const rotation of cameraRotations) {
+                    const inverse = (360 - rotation) % 360;
+                    const oriented = inverse % 90 === 0
+                        ? inverse === 0
+                            ? bits.clone()
+                            : inverse === 180
+                                ? (() => { const copy = bits.clone(); copy.rotate180(); return copy; })()
+                                : rotateBitMatrix90(bits, inverse === 90)
+                        : rotateBitMatrixByDegrees(bits, inverse);
+                    oneDPasses.push({ bits: oriented, rotation });
+                }
+                for (let i = 1; i < oneDPasses.length && oneDResults.length === 0; i++) {
+                    oneDResults = readOneD(oneDPasses[i].bits, oneDPasses[i].rotation);
+                }
+            }
+            for (const found of oneDResults) {
+                const { row, ...publicFound } = found;
+                void row;
+                if (publicFound.gs1) {
+                    const semanticText = publicFound.format === 'gs1databar14'
+                        ? `01${publicFound.gtin ?? publicFound.text}`
+                        : publicFound.text;
+                    try {
+                        publicFound.elements = databar.decodeGS1ElementString(semanticText);
+                    }
+                    catch (error) {
+                        publicFound.gs1ParseError = error instanceof Error ? error.message : String(error);
+                    }
+                }
+                results.push(publicFound);
+            }
         }
-      } catch {
-        /* no Micro QR in this pass */
-      }
+        if (results.length > 0)
+            break;
     }
-
-    if (wantRMQR && rmqrCanDecode) {
-      try {
-        const found = rmqr.detectAndDecodeRMQR(bits);
-        if (found) results.push({ ...found, format: 'rmqr' });
-      } catch {
-        /* no rMQR in this pass */
-      }
+    // De-duplicate: the same symbol is often read on several scan rows.
+    const seen = new Set();
+    const unique = results.filter((r) => {
+        const key = `${r.format}:${r.text}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+    // On large clean rasters, hybrid thresholding can erase otherwise uniform
+    // QR/PDF417 modules. Keep auto/hybrid as the primary strategy, then make one
+    // focused global retry only when the complete primary pass found nothing.
+    // This deliberately leaves an explicit global request single-pass.
+    const retryFormats = formats
+        ? formats.filter((format) => {
+            const id = String(format).toLowerCase();
+            return id === 'qr' || id === 'qrcode'
+                || id === 'pdf417' || id === 'pdf-417'
+                || id === 'compactpdf417' || id === 'compact-pdf417' || id === 'compact-pdf-417';
+        })
+        : ['qr', 'pdf417', 'compactpdf417'];
+    const shouldRetryGlobal = unique.length === 0
+        && (binarizer === 'auto' || binarizer === 'hybrid')
+        && retryFormats.length > 0;
+    if (!shouldRetryGlobal) {
+        return profile === 'camera'
+            ? unique.sort((a, b) => (b.confidence ?? 0) - (a.confidence ?? 0))
+            : unique;
     }
-
-    if (wantFrameQR && frameQrCanDecode) {
-      try {
-        for (const found of frameqr.detectAndDecodeFrameQR(bits, options.frameqr ?? {})) {
-          results.push({ ...found, format: 'frameqr' });
-        }
-      } catch {
-        /* no FrameQR Code in this pass */
-      }
-    }
-
-    if (wantOneD) {
-      const oneDFormats = want
-        ? [...want].filter((f) => f in ONED_FORMATS || oneDAliases.has(f))
-        : null;
-      const oneDPasses = [{ bits, rotation: 0 }];
-      // A linear symbol rotated by 90° has no usable horizontal scanline.
-      // The strict camera profile adds exactly two normalized orientations,
-      // only when the native orientation found no validated 1D result.
-      const readOneD = (candidateBits, rotation) => decodeOneD(candidateBits, {
-        ...options, formats: oneDFormats, tryHarder, profile, cameraRotation: rotation,
-      });
-      let oneDResults = readOneD(bits, 0);
-      if (profile === 'camera' && oneDResults.length === 0) {
-        oneDPasses.push(
-          { bits: rotateBitMatrix90(bits, false), rotation: 90 },
-          { bits: rotateBitMatrix90(bits, true), rotation: 270 },
-        );
-        for (let i = 1; i < oneDPasses.length && oneDResults.length === 0; i++) {
-          oneDResults = readOneD(oneDPasses[i].bits, oneDPasses[i].rotation);
-        }
-      }
-      for (const found of oneDResults) {
-        const { row, ...publicFound } = found;
-        void row;
-        if (publicFound.gs1) {
-          const semanticText = publicFound.format === 'gs1databar14'
-            ? `01${publicFound.gtin ?? publicFound.text}`
-            : publicFound.text;
-          try {
-            publicFound.elements = databar.decodeGS1ElementString(semanticText);
-          } catch (error) {
-            publicFound.gs1ParseError = error instanceof Error ? error.message : String(error);
-          }
-        }
-        results.push(publicFound);
-      }
-    }
-
-    if (results.length > 0) break;
-  }
-
-  // De-duplicate: the same symbol is often read on several scan rows.
-  const seen = new Set();
-  const unique = results.filter((r) => {
-    const key = `${r.format}:${r.text}`;
-    if (seen.has(key)) return false;
-    seen.add(key);
-    return true;
-  });
-
-  // On large clean rasters, hybrid thresholding can erase otherwise uniform
-  // QR/PDF417 modules. Keep auto/hybrid as the primary strategy, then make one
-  // focused global retry only when the complete primary pass found nothing.
-  // This deliberately leaves an explicit global request single-pass.
-  const retryFormats = formats
-    ? formats.filter((format) => {
-      const id = String(format).toLowerCase();
-      return id === 'qr' || id === 'qrcode'
-        || id === 'pdf417' || id === 'pdf-417'
-        || id === 'compactpdf417' || id === 'compact-pdf417' || id === 'compact-pdf-417';
-    })
-    : ['qr', 'pdf417', 'compactpdf417'];
-  const shouldRetryGlobal = unique.length === 0
-    && (binarizer === 'auto' || binarizer === 'hybrid')
-    && retryFormats.length > 0;
-
-  if (!shouldRetryGlobal) {
+    const fallback = decode(image, {
+        ...options,
+        formats: retryFormats,
+        binarizer: 'global',
+    });
+    const fallbackSeen = new Set();
+    const merged = [...unique, ...fallback].filter((r) => {
+        const key = `${r.format}:${r.text}`;
+        if (fallbackSeen.has(key))
+            return false;
+        fallbackSeen.add(key);
+        return true;
+    });
     return profile === 'camera'
-      ? unique.sort((a, b) => (b.confidence ?? 0) - (a.confidence ?? 0))
-      : unique;
-  }
-
-  const fallback = decode(image, {
-    ...options,
-    formats: retryFormats,
-    binarizer: 'global',
-  });
-  const fallbackSeen = new Set();
-  const merged = [...unique, ...fallback].filter((r) => {
-    const key = `${r.format}:${r.text}`;
-    if (fallbackSeen.has(key)) return false;
-    fallbackSeen.add(key);
-    return true;
-  });
-  return profile === 'camera'
-    ? merged.sort((a, b) => (b.confidence ?? 0) - (a.confidence ?? 0))
-    : merged;
+        ? merged.sort((a, b) => (b.confidence ?? 0) - (a.confidence ?? 0))
+        : merged;
 }
-
 /**
  * @param {BitMatrix} matrix
  * @param {boolean} clockwise
  * @returns {BitMatrix}
  */
 function rotateBitMatrix90(matrix, clockwise) {
-  const rotated = new BitMatrix(matrix.height, matrix.width);
-  for (let y = 0; y < matrix.height; y++) {
-    for (let x = 0; x < matrix.width; x++) {
-      if (!matrix.get(x, y)) continue;
-      if (clockwise) rotated.set(matrix.height - 1 - y, x);
-      else rotated.set(y, matrix.width - 1 - x);
+    const rotated = new BitMatrix(matrix.height, matrix.width);
+    for (let y = 0; y < matrix.height; y++) {
+        for (let x = 0; x < matrix.width; x++) {
+            if (!matrix.get(x, y))
+                continue;
+            if (clockwise)
+                rotated.set(matrix.height - 1 - y, x);
+            else
+                rotated.set(y, matrix.width - 1 - x);
+        }
+    }
+    return rotated;
+}
+/**
+ * Rotate a binarized raster by an arbitrary clockwise angle without changing
+ * the source matrix. This is intentionally used only by the strict camera
+ * profile: arbitrary-angle resampling is useful for linear symbols, but is
+ * too permissive to become a default retry for every detector.
+ *
+ * @param {BitMatrix} matrix
+ * @param {number} degrees Clockwise angle, normally one of 45/135/225/315.
+ * @returns {BitMatrix}
+ */
+function rotateBitMatrixByDegrees(matrix, degrees) {
+    const angle = ((degrees % 360) + 360) % 360;
+    if (angle === 0)
+        return matrix.clone();
+    if (angle === 90)
+        return rotateBitMatrix90(matrix, true);
+    if (angle === 180) {
+        const rotated = matrix.clone();
+        rotated.rotate180();
+        return rotated;
+    }
+    if (angle === 270)
+        return rotateBitMatrix90(matrix, false);
+    const radians = angle * Math.PI / 180;
+    const sin = Math.sin(radians);
+    const cos = Math.cos(radians);
+    const width = Math.ceil(Math.abs(matrix.width * cos) + Math.abs(matrix.height * sin));
+    const height = Math.ceil(Math.abs(matrix.width * sin) + Math.abs(matrix.height * cos));
+    const rotated = new BitMatrix(width, height);
+    const sourceCenterX = (matrix.width - 1) / 2;
+    const sourceCenterY = (matrix.height - 1) / 2;
+    const destinationCenterX = (width - 1) / 2;
+    const destinationCenterY = (height - 1) / 2;
+    // Inverse-map destination pixels into the source. Sampling the already
+    // binarized raster keeps the operation deterministic and leaves the caller's
+    // original image and threshold result untouched.
+    for (let y = 0; y < height; y++) {
+        const dy = y - destinationCenterY;
+        for (let x = 0; x < width; x++) {
+            const dx = x - destinationCenterX;
+            const sourceX = Math.round(cos * dx + sin * dy + sourceCenterX);
+            const sourceY = Math.round(-sin * dx + cos * dy + sourceCenterY);
+            if (sourceX >= 0 && sourceX < matrix.width && sourceY >= 0 && sourceY < matrix.height &&
+                matrix.get(sourceX, sourceY)) {
+                rotated.set(x, y);
+            }
+        }
+    }
+    return rotated;
+}
+/**
+ * Rotate the greyscale source before thresholding. Resampling luminance rather
+ * than an already-binarized matrix preserves module contrast at diagonal
+ * orientations and gives the format-specific detectors the same input quality
+ * as the native camera frame.
+ *
+ * @param {LuminanceSource} source
+ * @param {number} degrees Clockwise angle.
+ * @returns {LuminanceSource}
+ */
+function rotateLuminanceSourceByDegrees(source, degrees) {
+    const angle = ((degrees % 360) + 360) % 360;
+    if (angle === 0)
+        return source;
+    if (angle === 90)
+        return source.rotate90();
+    if (angle === 180)
+        return source.rotate90().rotate90();
+    if (angle === 270)
+        return source.rotate90().rotate90().rotate90();
+    const radians = angle * Math.PI / 180;
+    const sin = Math.sin(radians);
+    const cos = Math.cos(radians);
+    const width = Math.ceil(Math.abs(source.width * cos) + Math.abs(source.height * sin));
+    const height = Math.ceil(Math.abs(source.width * sin) + Math.abs(source.height * cos));
+    const rotated = new Uint8Array(width * height);
+    rotated.fill(255);
+    const sourceCenterX = (source.width - 1) / 2;
+    const sourceCenterY = (source.height - 1) / 2;
+    const destinationCenterX = (width - 1) / 2;
+    const destinationCenterY = (height - 1) / 2;
+    for (let y = 0; y < height; y++) {
+        const dy = y - destinationCenterY;
+        for (let x = 0; x < width; x++) {
+            const dx = x - destinationCenterX;
+            const sourceX = cos * dx + sin * dy + sourceCenterX;
+            const sourceY = -sin * dx + cos * dy + sourceCenterY;
+            if (sourceX >= 0 && sourceX < source.width && sourceY >= 0 && sourceY < source.height) {
+                const left = Math.floor(sourceX), top = Math.floor(sourceY);
+                const right = Math.min(source.width - 1, left + 1);
+                const bottom = Math.min(source.height - 1, top + 1);
+                const fx = sourceX - left, fy = sourceY - top;
+                const topValue = source.get(left, top) * (1 - fx) + source.get(right, top) * fx;
+                const bottomValue = source.get(left, bottom) * (1 - fx) + source.get(right, bottom) * fx;
+                rotated[y * width + x] = Math.round(topValue * (1 - fy) + bottomValue * fy);
+            }
+        }
     }
-  }
-  return rotated;
+    return LuminanceSource.fromGrey(rotated, width, height);
 }
-
 /**
  * Decode, or throw if nothing is found.
  *
@@ -628,10 +773,10 @@ function rotateBitMatrix90(matrix, clockwise) {
  * @returns {DecodeResult}
  */
 export function decodeStrict(image, options) {
-  const results = decode(image, options);
-  if (results.length === 0) throw new NotFoundError('No barcode found in image');
-  return results[0];
+    const results = decode(image, options);
+    if (results.length === 0)
+        throw new NotFoundError('No barcode found in image');
+    return results[0];
 }
-
 /** Library version, matching package.json. */
-export const VERSION = '1.5.7';
+export const VERSION = '1.5.9';