@sythos/js_barcode_universal 1.5.4 → 1.5.6

package/README.md

@@ -118,8 +118,8 @@ The `unpkg` and `jsdelivr` fields point at the IIFE bundle, so a CDN needs no in
 
 ```html
 <script src="https://unpkg.com/@sythos/js_barcode_universal"></script>
-<script src="https://unpkg.com/@sythos/js_barcode_universal@1.5.4"></script>
-<script src="https://cdn.jsdelivr.net/npm/@sythos/js_barcode_universal@1.5.4"></script>
+<script src="https://unpkg.com/@sythos/js_barcode_universal@1.5.6"></script>
+<script src="https://cdn.jsdelivr.net/npm/@sythos/js_barcode_universal@1.5.6"></script>
 ```
 
 Pin the version for anything you ship; the unpinned form resolves to `latest` and will move under
@@ -196,6 +196,25 @@ for (const hit of decode(ctx.getImageData(0, 0, canvas.width, canvas.height))) {
 outcome for a camera loop, not an error, so the common case needs no `try`/`catch`. Use
 `decodeStrict` when absence really is a failure.
 
+### Strict camera profile
+
+For a live camera loop, opt into the stricter 1D policy:
+
+```js
+decode(frame, { formats, profile: 'camera', tryHarder: true })
+```
+
+The profile requires a compatible quiet zone and the same complete 1D symbol on at least two
+scan samples. It retries only the two quarter-turn orientations needed for 1D symbols when the
+native orientation has no validated read. Code 11 and MSI require a verified check digit in this
+profile; other formats retain their own structural and checksum validation. A frame without a
+validated barcode still returns `[]`. No partial, structurally inconsistent or low-confidence value is
+emitted to the caller.
+
+Camera-profile 1D results add `confidence` (0–1), `bounds`, `rotation`, and
+`quality: { quietZone, checksum, rows, consistency }`. `bounds` is reported in the raster
+orientation that was scanned; unavailable quality data is represented by `null` where applicable.
+
 ---
 
 ## Supported formats

package/bundle/sythos-barcode.esm.js

@@ -1,5 +1,5 @@
 /*!
- * Sythos Barcode Suite v1.5.4
+ * Sythos Barcode Suite v1.5.6
  *
  * MIT License
  *
@@ -3935,6 +3935,51 @@ function withoutEANAddon(result) {
   return parent;
 }
 
+/** @param {Uint8Array} row @returns {{x:number, width:number, quietZone:boolean}|null} */
+function cameraRowGeometry(row) {
+  let first = 0;
+  while (first < row.length && row[first] === 0) first++;
+  if (first === row.length) return null;
+  let last = row.length - 1;
+  while (last >= 0 && row[last] === 0) last--;
+  return {
+    x: first,
+    width: last - first + 1,
+    quietZone: first >= 2 && row.length - 1 - last >= 2,
+  };
+}
+
+/** @param {string} format @param {object} options @returns {boolean|null} */
+function checksumStatus(format, options) {
+  if (format === 'ean13' || format === 'ean8' || format === 'upca' || format === 'upce' ||
+      format === 'code93' || format === 'code128' || format === 'gs1128' ||
+      format === 'gs1databar14') return true;
+  if (format === 'code11' || format === 'msi' || format === 'code39') {
+    return options.profile === 'camera' || options.checkDigit === true ? true : null;
+  }
+  return null;
+}
+
+/** @param {object} result @param {object} geometry @param {Set<number>} rows @param {object} options @returns {object} */
+function cameraMetadata(result, geometry, rows, options) {
+  const checksum = checksumStatus(result.format, options);
+  const consistency = Math.min(1, rows.size / 3);
+  const confidence = Math.min(1, 0.4 + (geometry.quietZone ? 0.2 : 0) +
+    (checksum === true ? 0.2 : 0) + consistency * 0.2);
+  return {
+    ...result,
+    confidence,
+    bounds: {
+      x: geometry.x,
+      y: Math.min(...rows),
+      width: geometry.width,
+      height: Math.max(...rows) - Math.min(...rows) + 1,
+    },
+    rotation: options.cameraRotation ?? 0,
+    quality: { quietZone: geometry.quietZone, checksum, rows: rows.size, consistency },
+  };
+}
+
 /**
  * Read every linear symbol found in a binarized image.
  *
@@ -3943,10 +3988,13 @@ function withoutEANAddon(result) {
  * @param {string[]} [options.formats] Restrict to these format ids.
  * @param {number} [options.rows] How many horizontal slices to try.
  * @param {boolean} [options.tryHarder] Also scan reversed rows, for mirrored symbols.
+ * @param {'camera'} [options.profile] Require stable, quiet-zone-qualified reads.
+ * @param {0|90|180|270} [options.cameraRotation] Orientation already normalized by the caller.
  * @returns {Array<{format: string, text: string, row: number}>}
  */
 function decodeOneD(image, options = {}) {
-  const { formats = null, rows = 15, tryHarder = true } = options;
+  const { formats = null, rows = 15, tryHarder = true, profile = null } = options;
+  const cameraProfile = profile === 'camera';
   const enabled = formats ? new Set(formats) : null;
   const active = DECODERS.filter(([id]) => {
     if (!enabled) return true;
@@ -3965,13 +4013,15 @@ function decodeOneD(image, options = {}) {
   const seen = new Set();
   const height = image.height;
   const buffer = new Uint8Array(image.width);
+  const cameraCandidates = new Map();
 
   // Sample rows from the middle outward: symbols are usually centred, and the
   // middle of a linear barcode is the part least likely to be clipped.
   const middle = height >> 1;
-  const step = Math.max(1, Math.round(height / rows));
+  const sampleRows = cameraProfile ? Math.min(height, Math.max(rows, 48)) : rows;
+  const step = Math.max(1, Math.round(height / sampleRows));
 
-  for (let attempt = 0; attempt < rows; attempt++) {
+  for (let attempt = 0; attempt < sampleRows; attempt++) {
     const delta = Math.ceil(attempt / 2) * step * (attempt % 2 === 0 ? 1 : -1);
     const y = middle + delta;
     if (y < 0 || y >= height) continue;
@@ -3984,7 +4034,12 @@ function decodeOneD(image, options = {}) {
       for (const [id, decoder] of active) {
         let result = null;
         try {
-          result = decoder(scan, options);
+          // Code 11 and MSI checks are optional in their base standards, but
+          // a camera frame cannot safely promote their short unchecked forms.
+          const decoderOptions = cameraProfile && (id === 'code11' || id === 'msi')
+            ? { ...options, checkDigit: true }
+            : options;
+          result = decoder(scan, decoderOptions);
         } catch {
           result = null; // a malformed candidate is not an error
         }
@@ -4016,6 +4071,20 @@ function decodeOneD(image, options = {}) {
 
         const addonKey = result.addon ? `:${result.addon.format}:${result.addon.text}` : '';
         const key = `${result.format}:${result.text}${addonKey}`;
+        if (cameraProfile) {
+          const geometry = cameraRowGeometry(row);
+          // Do not promote partial row fragments from a camera frame.
+          if (!geometry || !geometry.quietZone) continue;
+          const candidate = cameraCandidates.get(key) ?? {
+            result,
+            geometry,
+            rows: new Set(),
+            rotation: ((options.cameraRotation ?? 0) + (pass ? 180 : 0)) % 360,
+          };
+          candidate.rows.add(y);
+          cameraCandidates.set(key, candidate);
+          continue;
+        }
         if (seen.has(key)) continue;
         seen.add(key);
         results.push({ ...result, row: y });
@@ -4024,6 +4093,18 @@ function decodeOneD(image, options = {}) {
     }
   }
 
+  if (cameraProfile) {
+    for (const candidate of cameraCandidates.values()) {
+      // A complete symbol must survive at least two nearby scan samples. This
+      // rejects isolated run coincidences without imposing a payload length.
+      if (candidate.rows.size < 2) continue;
+      results.push(cameraMetadata(candidate.result, candidate.geometry, candidate.rows, {
+        ...options,
+        cameraRotation: candidate.rotation,
+      }));
+    }
+  }
+
   // A valid EAN/UPC parent is substantially more constrained than a generic
   // narrow/wide candidate. Suppress competing interpretations of the same
   // scanline, while retaining symbols detected on other rows.
@@ -16620,6 +16701,10 @@ function encode(text, options = {}) {
  * @property {boolean} [certified] Whether the profile is certified by its originator.
  * @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 {{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.
  * @property {Array<{ai:string,value:string,fixed?:boolean}>} [elements] Parsed GS1 Application Identifier fields.
@@ -16640,12 +16725,13 @@ 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] Sythos Canvas QR detector options when
  *   the profile marker is not preserved through image rendering.
  * @returns {DecodeResult[]}
  */
 function decode(image, options = {}) {
-  const { formats = null, tryHarder = true, binarizer = 'auto' } = 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');
@@ -16785,7 +16871,24 @@ function decode(image, options = {}) {
       const oneDFormats = want
         ? [...want].filter((f) => f in ONED_FORMATS || oneDAliases.has(f))
         : null;
-      for (const found of decodeOneD(bits, { ...options, formats: oneDFormats, tryHarder })) {
+      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) {
@@ -16830,7 +16933,11 @@ function decode(image, options = {}) {
     && (binarizer === 'auto' || binarizer === 'hybrid')
     && retryFormats.length > 0;
 
-  if (!shouldRetryGlobal) return unique;
+  if (!shouldRetryGlobal) {
+    return profile === 'camera'
+      ? unique.sort((a, b) => (b.confidence ?? 0) - (a.confidence ?? 0))
+      : unique;
+  }
 
   const fallback = decode(image, {
     ...options,
@@ -16838,12 +16945,32 @@ function decode(image, options = {}) {
     binarizer: 'global',
   });
   const fallbackSeen = new Set();
-  return [...unique, ...fallback].filter((r) => {
+  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;
+}
+
+/**
+ * @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);
+    }
+  }
+  return rotated;
 }
 
 /**
@@ -16860,7 +16987,7 @@ function decodeStrict(image, options) {
 }
 
 /** Library version, matching package.json. */
-const VERSION = '1.5.4';
+const VERSION = '1.5.6';
 
 __exports.listFormats = listFormats;
 __exports.encode = encode;

package/bundle/sythos-barcode.js

@@ -1,5 +1,5 @@
 /*!
- * Sythos Barcode Suite v1.5.4
+ * Sythos Barcode Suite v1.5.6
  *
  * MIT License
  *
@@ -3936,6 +3936,51 @@ function withoutEANAddon(result) {
   return parent;
 }
 
+/** @param {Uint8Array} row @returns {{x:number, width:number, quietZone:boolean}|null} */
+function cameraRowGeometry(row) {
+  let first = 0;
+  while (first < row.length && row[first] === 0) first++;
+  if (first === row.length) return null;
+  let last = row.length - 1;
+  while (last >= 0 && row[last] === 0) last--;
+  return {
+    x: first,
+    width: last - first + 1,
+    quietZone: first >= 2 && row.length - 1 - last >= 2,
+  };
+}
+
+/** @param {string} format @param {object} options @returns {boolean|null} */
+function checksumStatus(format, options) {
+  if (format === 'ean13' || format === 'ean8' || format === 'upca' || format === 'upce' ||
+      format === 'code93' || format === 'code128' || format === 'gs1128' ||
+      format === 'gs1databar14') return true;
+  if (format === 'code11' || format === 'msi' || format === 'code39') {
+    return options.profile === 'camera' || options.checkDigit === true ? true : null;
+  }
+  return null;
+}
+
+/** @param {object} result @param {object} geometry @param {Set<number>} rows @param {object} options @returns {object} */
+function cameraMetadata(result, geometry, rows, options) {
+  const checksum = checksumStatus(result.format, options);
+  const consistency = Math.min(1, rows.size / 3);
+  const confidence = Math.min(1, 0.4 + (geometry.quietZone ? 0.2 : 0) +
+    (checksum === true ? 0.2 : 0) + consistency * 0.2);
+  return {
+    ...result,
+    confidence,
+    bounds: {
+      x: geometry.x,
+      y: Math.min(...rows),
+      width: geometry.width,
+      height: Math.max(...rows) - Math.min(...rows) + 1,
+    },
+    rotation: options.cameraRotation ?? 0,
+    quality: { quietZone: geometry.quietZone, checksum, rows: rows.size, consistency },
+  };
+}
+
 /**
  * Read every linear symbol found in a binarized image.
  *
@@ -3944,10 +3989,13 @@ function withoutEANAddon(result) {
  * @param {string[]} [options.formats] Restrict to these format ids.
  * @param {number} [options.rows] How many horizontal slices to try.
  * @param {boolean} [options.tryHarder] Also scan reversed rows, for mirrored symbols.
+ * @param {'camera'} [options.profile] Require stable, quiet-zone-qualified reads.
+ * @param {0|90|180|270} [options.cameraRotation] Orientation already normalized by the caller.
  * @returns {Array<{format: string, text: string, row: number}>}
  */
 function decodeOneD(image, options = {}) {
-  const { formats = null, rows = 15, tryHarder = true } = options;
+  const { formats = null, rows = 15, tryHarder = true, profile = null } = options;
+  const cameraProfile = profile === 'camera';
   const enabled = formats ? new Set(formats) : null;
   const active = DECODERS.filter(([id]) => {
     if (!enabled) return true;
@@ -3966,13 +4014,15 @@ function decodeOneD(image, options = {}) {
   const seen = new Set();
   const height = image.height;
   const buffer = new Uint8Array(image.width);
+  const cameraCandidates = new Map();
 
   // Sample rows from the middle outward: symbols are usually centred, and the
   // middle of a linear barcode is the part least likely to be clipped.
   const middle = height >> 1;
-  const step = Math.max(1, Math.round(height / rows));
+  const sampleRows = cameraProfile ? Math.min(height, Math.max(rows, 48)) : rows;
+  const step = Math.max(1, Math.round(height / sampleRows));
 
-  for (let attempt = 0; attempt < rows; attempt++) {
+  for (let attempt = 0; attempt < sampleRows; attempt++) {
     const delta = Math.ceil(attempt / 2) * step * (attempt % 2 === 0 ? 1 : -1);
     const y = middle + delta;
     if (y < 0 || y >= height) continue;
@@ -3985,7 +4035,12 @@ function decodeOneD(image, options = {}) {
       for (const [id, decoder] of active) {
         let result = null;
         try {
-          result = decoder(scan, options);
+          // Code 11 and MSI checks are optional in their base standards, but
+          // a camera frame cannot safely promote their short unchecked forms.
+          const decoderOptions = cameraProfile && (id === 'code11' || id === 'msi')
+            ? { ...options, checkDigit: true }
+            : options;
+          result = decoder(scan, decoderOptions);
         } catch {
           result = null; // a malformed candidate is not an error
         }
@@ -4017,6 +4072,20 @@ function decodeOneD(image, options = {}) {
 
         const addonKey = result.addon ? `:${result.addon.format}:${result.addon.text}` : '';
         const key = `${result.format}:${result.text}${addonKey}`;
+        if (cameraProfile) {
+          const geometry = cameraRowGeometry(row);
+          // Do not promote partial row fragments from a camera frame.
+          if (!geometry || !geometry.quietZone) continue;
+          const candidate = cameraCandidates.get(key) ?? {
+            result,
+            geometry,
+            rows: new Set(),
+            rotation: ((options.cameraRotation ?? 0) + (pass ? 180 : 0)) % 360,
+          };
+          candidate.rows.add(y);
+          cameraCandidates.set(key, candidate);
+          continue;
+        }
         if (seen.has(key)) continue;
         seen.add(key);
         results.push({ ...result, row: y });
@@ -4025,6 +4094,18 @@ function decodeOneD(image, options = {}) {
     }
   }
 
+  if (cameraProfile) {
+    for (const candidate of cameraCandidates.values()) {
+      // A complete symbol must survive at least two nearby scan samples. This
+      // rejects isolated run coincidences without imposing a payload length.
+      if (candidate.rows.size < 2) continue;
+      results.push(cameraMetadata(candidate.result, candidate.geometry, candidate.rows, {
+        ...options,
+        cameraRotation: candidate.rotation,
+      }));
+    }
+  }
+
   // A valid EAN/UPC parent is substantially more constrained than a generic
   // narrow/wide candidate. Suppress competing interpretations of the same
   // scanline, while retaining symbols detected on other rows.
@@ -16621,6 +16702,10 @@ function encode(text, options = {}) {
  * @property {boolean} [certified] Whether the profile is certified by its originator.
  * @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 {{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.
  * @property {Array<{ai:string,value:string,fixed?:boolean}>} [elements] Parsed GS1 Application Identifier fields.
@@ -16641,12 +16726,13 @@ 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] Sythos Canvas QR detector options when
  *   the profile marker is not preserved through image rendering.
  * @returns {DecodeResult[]}
  */
 function decode(image, options = {}) {
-  const { formats = null, tryHarder = true, binarizer = 'auto' } = 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');
@@ -16786,7 +16872,24 @@ function decode(image, options = {}) {
       const oneDFormats = want
         ? [...want].filter((f) => f in ONED_FORMATS || oneDAliases.has(f))
         : null;
-      for (const found of decodeOneD(bits, { ...options, formats: oneDFormats, tryHarder })) {
+      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) {
@@ -16831,7 +16934,11 @@ function decode(image, options = {}) {
     && (binarizer === 'auto' || binarizer === 'hybrid')
     && retryFormats.length > 0;
 
-  if (!shouldRetryGlobal) return unique;
+  if (!shouldRetryGlobal) {
+    return profile === 'camera'
+      ? unique.sort((a, b) => (b.confidence ?? 0) - (a.confidence ?? 0))
+      : unique;
+  }
 
   const fallback = decode(image, {
     ...options,
@@ -16839,12 +16946,32 @@ function decode(image, options = {}) {
     binarizer: 'global',
   });
   const fallbackSeen = new Set();
-  return [...unique, ...fallback].filter((r) => {
+  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;
+}
+
+/**
+ * @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);
+    }
+  }
+  return rotated;
 }
 
 /**
@@ -16861,7 +16988,7 @@ function decodeStrict(image, options) {
 }
 
 /** Library version, matching package.json. */
-const VERSION = '1.5.4';
+const VERSION = '1.5.6';
 
 __exports.listFormats = listFormats;
 __exports.encode = encode;

package/examples/read.html

@@ -180,12 +180,14 @@
     return true;
   }
 
-  function scanCanvas(canvas) {
+  function scanCanvas(canvas, profile) {
     var ctx = canvas.getContext('2d', { willReadFrequently: true });
     if (!ctx || !canvas.width || !canvas.height) return [];
     var image = ctx.getImageData(0, 0, canvas.width, canvas.height);
     try {
-      return B.decode(image, { tryHarder: true });
+      var options = { tryHarder: true };
+      if (profile) options.profile = profile;
+      return B.decode(image, options);
     } catch (e) {
       return [];
     }
@@ -325,7 +327,7 @@
       .drawImage(video, 0, 0, work.width, work.height);
 
     frames++;
-    var hits = scanCanvas(work);
+    var hits = scanCanvas(work, 'camera');
     if (hits.length) {
       show(hits, 'camera');
       stopCamera();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sythos/js_barcode_universal",
-  "version": "1.5.4",
+  "version": "1.5.6",
   "description": "Read and write barcodes in JavaScript with zero runtime dependencies. QR Code, Micro QR, rMQR, FrameQR Code, Aztec Code and Rune, PDF417 variants, GS1 DataBar Omnidirectional/Truncated, EAN supplements and one-dimensional formats.",
   "author": {
     "name": "Sythos",

package/src/index.js

@@ -348,6 +348,10 @@ export function encode(text, options = {}) {
  * @property {boolean} [certified] Whether the profile is certified by its originator.
  * @property {object} [canvas] Canvas reservation metadata for the FrameQR Code 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 {{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.
  * @property {Array<{ai:string,value:string,fixed?:boolean}>} [elements] Parsed GS1 Application Identifier fields.
@@ -368,12 +372,13 @@ 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
  *   the profile marker is not preserved through image rendering.
  * @returns {DecodeResult[]}
  */
 export function decode(image, options = {}) {
-  const { formats = null, tryHarder = true, binarizer = 'auto' } = 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');
@@ -513,7 +518,24 @@ export function decode(image, options = {}) {
       const oneDFormats = want
         ? [...want].filter((f) => f in ONED_FORMATS || oneDAliases.has(f))
         : null;
-      for (const found of decodeOneD(bits, { ...options, formats: oneDFormats, tryHarder })) {
+      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) {
@@ -558,7 +580,11 @@ export function decode(image, options = {}) {
     && (binarizer === 'auto' || binarizer === 'hybrid')
     && retryFormats.length > 0;
 
-  if (!shouldRetryGlobal) return unique;
+  if (!shouldRetryGlobal) {
+    return profile === 'camera'
+      ? unique.sort((a, b) => (b.confidence ?? 0) - (a.confidence ?? 0))
+      : unique;
+  }
 
   const fallback = decode(image, {
     ...options,
@@ -566,12 +592,32 @@ export function decode(image, options = {}) {
     binarizer: 'global',
   });
   const fallbackSeen = new Set();
-  return [...unique, ...fallback].filter((r) => {
+  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;
+}
+
+/**
+ * @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);
+    }
+  }
+  return rotated;
 }
 
 /**
@@ -588,4 +634,4 @@ export function decodeStrict(image, options) {
 }
 
 /** Library version, matching package.json. */
-export const VERSION = '1.5.4';
+export const VERSION = '1.5.6';

package/src/oned/reader.js

@@ -1170,6 +1170,51 @@ function withoutEANAddon(result) {
   return parent;
 }
 
+/** @param {Uint8Array} row @returns {{x:number, width:number, quietZone:boolean}|null} */
+function cameraRowGeometry(row) {
+  let first = 0;
+  while (first < row.length && row[first] === 0) first++;
+  if (first === row.length) return null;
+  let last = row.length - 1;
+  while (last >= 0 && row[last] === 0) last--;
+  return {
+    x: first,
+    width: last - first + 1,
+    quietZone: first >= 2 && row.length - 1 - last >= 2,
+  };
+}
+
+/** @param {string} format @param {object} options @returns {boolean|null} */
+function checksumStatus(format, options) {
+  if (format === 'ean13' || format === 'ean8' || format === 'upca' || format === 'upce' ||
+      format === 'code93' || format === 'code128' || format === 'gs1128' ||
+      format === 'gs1databar14') return true;
+  if (format === 'code11' || format === 'msi' || format === 'code39') {
+    return options.profile === 'camera' || options.checkDigit === true ? true : null;
+  }
+  return null;
+}
+
+/** @param {object} result @param {object} geometry @param {Set<number>} rows @param {object} options @returns {object} */
+function cameraMetadata(result, geometry, rows, options) {
+  const checksum = checksumStatus(result.format, options);
+  const consistency = Math.min(1, rows.size / 3);
+  const confidence = Math.min(1, 0.4 + (geometry.quietZone ? 0.2 : 0) +
+    (checksum === true ? 0.2 : 0) + consistency * 0.2);
+  return {
+    ...result,
+    confidence,
+    bounds: {
+      x: geometry.x,
+      y: Math.min(...rows),
+      width: geometry.width,
+      height: Math.max(...rows) - Math.min(...rows) + 1,
+    },
+    rotation: options.cameraRotation ?? 0,
+    quality: { quietZone: geometry.quietZone, checksum, rows: rows.size, consistency },
+  };
+}
+
 /**
  * Read every linear symbol found in a binarized image.
  *
@@ -1178,10 +1223,13 @@ function withoutEANAddon(result) {
  * @param {string[]} [options.formats] Restrict to these format ids.
  * @param {number} [options.rows] How many horizontal slices to try.
  * @param {boolean} [options.tryHarder] Also scan reversed rows, for mirrored symbols.
+ * @param {'camera'} [options.profile] Require stable, quiet-zone-qualified reads.
+ * @param {0|90|180|270} [options.cameraRotation] Orientation already normalized by the caller.
  * @returns {Array<{format: string, text: string, row: number}>}
  */
 export function decodeOneD(image, options = {}) {
-  const { formats = null, rows = 15, tryHarder = true } = options;
+  const { formats = null, rows = 15, tryHarder = true, profile = null } = options;
+  const cameraProfile = profile === 'camera';
   const enabled = formats ? new Set(formats) : null;
   const active = DECODERS.filter(([id]) => {
     if (!enabled) return true;
@@ -1200,13 +1248,15 @@ export function decodeOneD(image, options = {}) {
   const seen = new Set();
   const height = image.height;
   const buffer = new Uint8Array(image.width);
+  const cameraCandidates = new Map();
 
   // Sample rows from the middle outward: symbols are usually centred, and the
   // middle of a linear barcode is the part least likely to be clipped.
   const middle = height >> 1;
-  const step = Math.max(1, Math.round(height / rows));
+  const sampleRows = cameraProfile ? Math.min(height, Math.max(rows, 48)) : rows;
+  const step = Math.max(1, Math.round(height / sampleRows));
 
-  for (let attempt = 0; attempt < rows; attempt++) {
+  for (let attempt = 0; attempt < sampleRows; attempt++) {
     const delta = Math.ceil(attempt / 2) * step * (attempt % 2 === 0 ? 1 : -1);
     const y = middle + delta;
     if (y < 0 || y >= height) continue;
@@ -1219,7 +1269,12 @@ export function decodeOneD(image, options = {}) {
       for (const [id, decoder] of active) {
         let result = null;
         try {
-          result = decoder(scan, options);
+          // Code 11 and MSI checks are optional in their base standards, but
+          // a camera frame cannot safely promote their short unchecked forms.
+          const decoderOptions = cameraProfile && (id === 'code11' || id === 'msi')
+            ? { ...options, checkDigit: true }
+            : options;
+          result = decoder(scan, decoderOptions);
         } catch {
           result = null; // a malformed candidate is not an error
         }
@@ -1251,6 +1306,20 @@ export function decodeOneD(image, options = {}) {
 
         const addonKey = result.addon ? `:${result.addon.format}:${result.addon.text}` : '';
         const key = `${result.format}:${result.text}${addonKey}`;
+        if (cameraProfile) {
+          const geometry = cameraRowGeometry(row);
+          // Do not promote partial row fragments from a camera frame.
+          if (!geometry || !geometry.quietZone) continue;
+          const candidate = cameraCandidates.get(key) ?? {
+            result,
+            geometry,
+            rows: new Set(),
+            rotation: ((options.cameraRotation ?? 0) + (pass ? 180 : 0)) % 360,
+          };
+          candidate.rows.add(y);
+          cameraCandidates.set(key, candidate);
+          continue;
+        }
         if (seen.has(key)) continue;
         seen.add(key);
         results.push({ ...result, row: y });
@@ -1259,6 +1328,18 @@ export function decodeOneD(image, options = {}) {
     }
   }
 
+  if (cameraProfile) {
+    for (const candidate of cameraCandidates.values()) {
+      // A complete symbol must survive at least two nearby scan samples. This
+      // rejects isolated run coincidences without imposing a payload length.
+      if (candidate.rows.size < 2) continue;
+      results.push(cameraMetadata(candidate.result, candidate.geometry, candidate.rows, {
+        ...options,
+        cameraRotation: candidate.rotation,
+      }));
+    }
+  }
+
   // A valid EAN/UPC parent is substantially more constrained than a generic
   // narrow/wide candidate. Suppress competing interpretations of the same
   // scanline, while retaining symbols detected on other rows.