@sythos/js_barcode_universal 1.5.3 → 1.5.5

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.3"></script>
-<script src="https://cdn.jsdelivr.net/npm/@sythos/js_barcode_universal@1.5.3"></script>
+<script src="https://unpkg.com/@sythos/js_barcode_universal@1.5.5"></script>
+<script src="https://cdn.jsdelivr.net/npm/@sythos/js_barcode_universal@1.5.5"></script>
 ```
 
 Pin the version for anything you ship; the unpinned form resolves to `latest` and will move under
@@ -196,6 +196,24 @@ 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 `[]`.
+
+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
@@ -407,6 +425,12 @@ the generic `ean2` and `ean5` format IDs. The image reader recognizes them only
 when attached to a validated EAN/UPC parent; use the composition helpers with
 an EAN/UPC base symbol.
 
+EAN-2 and EAN-5 are parent-bound supplements, never standalone image results. They may be
+listed with EAN-13, EAN-8, UPC-A, UPC-E or Bookland ISBN in `formats`: the parent remains valid
+without a supplement, and a valid requested supplement is exposed only through `result.addon`.
+If only `ean2` or `ean5` is requested, a validated EAN/UPC parent is still required and remains
+the returned `format`; an absent, malformed or unrequested supplement never rejects the parent.
+
 ### GS1 DataBar
 
 The `databar` subpath exposes original GS1 GTIN/AI codecs plus physical

package/bundle/sythos-barcode.esm.js

@@ -1,5 +1,5 @@
 /*!
- * Sythos Barcode Suite v1.5.3
+ * Sythos Barcode Suite v1.5.5
  *
  * MIT License
  *
@@ -3907,6 +3907,79 @@ const DECODERS = [
   ['codabar', decodeCodabar],
 ];
 
+const EAN_PARENT_FORMATS = new Set(['ean13', 'ean8', 'upca', 'upce', 'isbn']);
+const EAN_SUPPLEMENT_FORMATS = new Set(['ean2', 'ean5']);
+
+/** @param {string} format @returns {boolean} */
+function isEANParentFormat(format) {
+  return format === 'ean13' || format === 'ean8' || format === 'upca' || format === 'upce';
+}
+
+/**
+ * An ISBN is printed as a Bookland EAN-13, so its decoded parent remains
+ * `ean13` while an ISBN filter accepts only the Bookland prefixes.
+ *
+ * @param {{format:string, text:string}} result
+ * @param {Set<string>} enabled
+ * @returns {boolean}
+ */
+function isRequestedEANParent(result, enabled) {
+  if (enabled.has(result.format)) return true;
+  return result.format === 'ean13' && enabled.has('isbn') && /^97[89]/.test(result.text);
+}
+
+/** @param {object} result @returns {object} */
+function withoutEANAddon(result) {
+  const { addon, ...parent } = result;
+  void addon;
+  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.
  *
@@ -3915,16 +3988,20 @@ const DECODERS = [
  * @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;
     if (enabled.has(id)) return true;
     if (id === 'ean13' || id === 'ean8' || id === 'upca' || id === 'upce') {
-      return enabled.has('ean2') || enabled.has('ean5');
+      return enabled.has('ean2') || enabled.has('ean5') ||
+        (id === 'ean13' && enabled.has('isbn'));
     }
     if (id === 'code128') return enabled.has('gs1128');
     if (id === 'gs1databar14') return enabled.has('databar') || enabled.has('gs1-databar14');
@@ -3936,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;
@@ -3955,17 +4034,32 @@ 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
         }
         if (!result) continue;
         if (enabled) {
-          const addonRequested = enabled.has('ean2') || enabled.has('ean5');
-          const isEANBase = result.format === 'ean13' || result.format === 'ean8' ||
-            result.format === 'upca' || result.format === 'upce';
-          if (isEANBase && addonRequested) {
-            if (!result.addon || !enabled.has(result.addon.format)) continue;
+          if (isEANParentFormat(result.format)) {
+            const baseRequested = [...EAN_PARENT_FORMATS].some((format) => enabled.has(format));
+            const parentRequested = isRequestedEANParent(result, enabled);
+            if (baseRequested && !parentRequested) {
+              continue;
+            }
+            if (!baseRequested) {
+              // A supplement is never an independent barcode. When it is the
+              // only requested format, return its validated EAN/UPC parent.
+              if (!result.addon || !EAN_SUPPLEMENT_FORMATS.has(result.addon.format) ||
+                  !enabled.has(result.addon.format)) continue;
+            } else if (result.addon && !enabled.has(result.addon.format)) {
+              // Supplements are optional whenever a requested parent exists.
+              result = withoutEANAddon(result);
+            }
           } else if (result.format === 'gs1128') {
             if (!enabled.has('gs1128') && !enabled.has('code128')) continue;
           } else if (result.format === 'gs1databar14') {
@@ -3977,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 });
@@ -3985,7 +4093,27 @@ function decodeOneD(image, options = {}) {
     }
   }
 
-  return results;
+  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.
+  const eanRows = new Set(results
+    .filter((result) => isEANParentFormat(result.format))
+    .map((result) => result.row));
+  return eanRows.size === 0
+    ? results
+    : results.filter((result) => !eanRows.has(result.row) || isEANParentFormat(result.format));
 }
 
 /**
@@ -16573,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.
@@ -16593,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');
@@ -16738,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) {
@@ -16783,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,
@@ -16791,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;
 }
 
 /**
@@ -16813,7 +16987,7 @@ function decodeStrict(image, options) {
 }
 
 /** Library version, matching package.json. */
-const VERSION = '1.5.3';
+const VERSION = '1.5.5';
 
 __exports.listFormats = listFormats;
 __exports.encode = encode;

package/bundle/sythos-barcode.js

@@ -1,5 +1,5 @@
 /*!
- * Sythos Barcode Suite v1.5.3
+ * Sythos Barcode Suite v1.5.5
  *
  * MIT License
  *
@@ -3908,6 +3908,79 @@ const DECODERS = [
   ['codabar', decodeCodabar],
 ];
 
+const EAN_PARENT_FORMATS = new Set(['ean13', 'ean8', 'upca', 'upce', 'isbn']);
+const EAN_SUPPLEMENT_FORMATS = new Set(['ean2', 'ean5']);
+
+/** @param {string} format @returns {boolean} */
+function isEANParentFormat(format) {
+  return format === 'ean13' || format === 'ean8' || format === 'upca' || format === 'upce';
+}
+
+/**
+ * An ISBN is printed as a Bookland EAN-13, so its decoded parent remains
+ * `ean13` while an ISBN filter accepts only the Bookland prefixes.
+ *
+ * @param {{format:string, text:string}} result
+ * @param {Set<string>} enabled
+ * @returns {boolean}
+ */
+function isRequestedEANParent(result, enabled) {
+  if (enabled.has(result.format)) return true;
+  return result.format === 'ean13' && enabled.has('isbn') && /^97[89]/.test(result.text);
+}
+
+/** @param {object} result @returns {object} */
+function withoutEANAddon(result) {
+  const { addon, ...parent } = result;
+  void addon;
+  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.
  *
@@ -3916,16 +3989,20 @@ const DECODERS = [
  * @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;
     if (enabled.has(id)) return true;
     if (id === 'ean13' || id === 'ean8' || id === 'upca' || id === 'upce') {
-      return enabled.has('ean2') || enabled.has('ean5');
+      return enabled.has('ean2') || enabled.has('ean5') ||
+        (id === 'ean13' && enabled.has('isbn'));
     }
     if (id === 'code128') return enabled.has('gs1128');
     if (id === 'gs1databar14') return enabled.has('databar') || enabled.has('gs1-databar14');
@@ -3937,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;
@@ -3956,17 +4035,32 @@ 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
         }
         if (!result) continue;
         if (enabled) {
-          const addonRequested = enabled.has('ean2') || enabled.has('ean5');
-          const isEANBase = result.format === 'ean13' || result.format === 'ean8' ||
-            result.format === 'upca' || result.format === 'upce';
-          if (isEANBase && addonRequested) {
-            if (!result.addon || !enabled.has(result.addon.format)) continue;
+          if (isEANParentFormat(result.format)) {
+            const baseRequested = [...EAN_PARENT_FORMATS].some((format) => enabled.has(format));
+            const parentRequested = isRequestedEANParent(result, enabled);
+            if (baseRequested && !parentRequested) {
+              continue;
+            }
+            if (!baseRequested) {
+              // A supplement is never an independent barcode. When it is the
+              // only requested format, return its validated EAN/UPC parent.
+              if (!result.addon || !EAN_SUPPLEMENT_FORMATS.has(result.addon.format) ||
+                  !enabled.has(result.addon.format)) continue;
+            } else if (result.addon && !enabled.has(result.addon.format)) {
+              // Supplements are optional whenever a requested parent exists.
+              result = withoutEANAddon(result);
+            }
           } else if (result.format === 'gs1128') {
             if (!enabled.has('gs1128') && !enabled.has('code128')) continue;
           } else if (result.format === 'gs1databar14') {
@@ -3978,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 });
@@ -3986,7 +4094,27 @@ function decodeOneD(image, options = {}) {
     }
   }
 
-  return results;
+  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.
+  const eanRows = new Set(results
+    .filter((result) => isEANParentFormat(result.format))
+    .map((result) => result.row));
+  return eanRows.size === 0
+    ? results
+    : results.filter((result) => !eanRows.has(result.row) || isEANParentFormat(result.format));
 }
 
 /**
@@ -16574,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.
@@ -16594,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');
@@ -16739,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) {
@@ -16784,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,
@@ -16792,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;
 }
 
 /**
@@ -16814,7 +16988,7 @@ function decodeStrict(image, options) {
 }
 
 /** Library version, matching package.json. */
-const VERSION = '1.5.3';
+const VERSION = '1.5.5';
 
 __exports.listFormats = listFormats;
 __exports.encode = encode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sythos/js_barcode_universal",
-  "version": "1.5.3",
+  "version": "1.5.5",
   "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.3';
+export const VERSION = '1.5.5';

package/src/oned/reader.js

@@ -1142,6 +1142,79 @@ const DECODERS = [
   ['codabar', decodeCodabar],
 ];
 
+const EAN_PARENT_FORMATS = new Set(['ean13', 'ean8', 'upca', 'upce', 'isbn']);
+const EAN_SUPPLEMENT_FORMATS = new Set(['ean2', 'ean5']);
+
+/** @param {string} format @returns {boolean} */
+function isEANParentFormat(format) {
+  return format === 'ean13' || format === 'ean8' || format === 'upca' || format === 'upce';
+}
+
+/**
+ * An ISBN is printed as a Bookland EAN-13, so its decoded parent remains
+ * `ean13` while an ISBN filter accepts only the Bookland prefixes.
+ *
+ * @param {{format:string, text:string}} result
+ * @param {Set<string>} enabled
+ * @returns {boolean}
+ */
+function isRequestedEANParent(result, enabled) {
+  if (enabled.has(result.format)) return true;
+  return result.format === 'ean13' && enabled.has('isbn') && /^97[89]/.test(result.text);
+}
+
+/** @param {object} result @returns {object} */
+function withoutEANAddon(result) {
+  const { addon, ...parent } = result;
+  void addon;
+  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.
  *
@@ -1150,16 +1223,20 @@ const DECODERS = [
  * @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;
     if (enabled.has(id)) return true;
     if (id === 'ean13' || id === 'ean8' || id === 'upca' || id === 'upce') {
-      return enabled.has('ean2') || enabled.has('ean5');
+      return enabled.has('ean2') || enabled.has('ean5') ||
+        (id === 'ean13' && enabled.has('isbn'));
     }
     if (id === 'code128') return enabled.has('gs1128');
     if (id === 'gs1databar14') return enabled.has('databar') || enabled.has('gs1-databar14');
@@ -1171,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;
@@ -1190,17 +1269,32 @@ 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
         }
         if (!result) continue;
         if (enabled) {
-          const addonRequested = enabled.has('ean2') || enabled.has('ean5');
-          const isEANBase = result.format === 'ean13' || result.format === 'ean8' ||
-            result.format === 'upca' || result.format === 'upce';
-          if (isEANBase && addonRequested) {
-            if (!result.addon || !enabled.has(result.addon.format)) continue;
+          if (isEANParentFormat(result.format)) {
+            const baseRequested = [...EAN_PARENT_FORMATS].some((format) => enabled.has(format));
+            const parentRequested = isRequestedEANParent(result, enabled);
+            if (baseRequested && !parentRequested) {
+              continue;
+            }
+            if (!baseRequested) {
+              // A supplement is never an independent barcode. When it is the
+              // only requested format, return its validated EAN/UPC parent.
+              if (!result.addon || !EAN_SUPPLEMENT_FORMATS.has(result.addon.format) ||
+                  !enabled.has(result.addon.format)) continue;
+            } else if (result.addon && !enabled.has(result.addon.format)) {
+              // Supplements are optional whenever a requested parent exists.
+              result = withoutEANAddon(result);
+            }
           } else if (result.format === 'gs1128') {
             if (!enabled.has('gs1128') && !enabled.has('code128')) continue;
           } else if (result.format === 'gs1databar14') {
@@ -1212,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 });
@@ -1220,7 +1328,27 @@ export function decodeOneD(image, options = {}) {
     }
   }
 
-  return results;
+  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.
+  const eanRows = new Set(results
+    .filter((result) => isEANParentFormat(result.format))
+    .map((result) => result.row));
+  return eanRows.size === 0
+    ? results
+    : results.filter((result) => !eanRows.has(result.row) || isEANParentFormat(result.format));
 }
 
 /**