@sythos/js_barcode_universal 1.5.7 → 1.5.9

package/src/{frameqr/detector.js → ts/frameqr/detector.ts}

@@ -4,7 +4,6 @@
  * MIT License
  *
  * Copyright (c) 2026 Sythos
- * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -30,7 +29,7 @@
  */
 
 /**
- * Detector for the non-certified FrameQR Code profile.
+ * Detector for the non-certified Sythos Canvas QR profile.
  *
  * The profile deliberately reuses QR Model 2 geometry. Finder localisation and
  * projective sampling therefore use the QR detector; the additional profile
@@ -99,7 +98,7 @@ function sameCandidate(left, right) {
 }
 
 /**
- * Detect FrameQR Code symbols in a binarized raster.
+ * Detect Sythos Canvas QR symbols in a binarized raster.
  *
  * @param {import('../core/bit-matrix.js').BitMatrix} binaryImage Set bit = dark.
  * @param {object} [options]

package/src/{frameqr/encoder.js → ts/frameqr/encoder.ts}

@@ -4,7 +4,6 @@
  * MIT License
  *
  * Copyright (c) 2026 Sythos
- * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -30,7 +29,7 @@
  */
 
 /**
- * FrameQR Code encoder.
+ * Sythos Canvas QR profile encoder.
  *
  * This encoder deliberately builds on this project's QR Code implementation
  * and then removes a conservatively bounded set of data modules for artwork.
@@ -69,7 +68,7 @@ function clearCanvas(matrix, modules) {
 
 /**
  * Encode a QR Code with a conservative artwork canvas according to the
- * non-certified FrameQR Code profile.
+ * non-certified Sythos Canvas QR profile.
  *
  * The profile forces QR H error correction and rejects a canvas whenever its
  * known codeword damage exceeds the per-block correction budget. When a
@@ -85,10 +84,10 @@ function clearCanvas(matrix, modules) {
  */
 export function encodeFrameQR(text, options = {}) {
   if (typeof text !== 'string') {
-    throw new EncodeError('FrameQR Code: text must be a string');
+    throw new EncodeError('Sythos Canvas QR: text must be a string');
   }
   if (options.ecc !== undefined && options.ecc !== 'H') {
-    throw new EncodeError('FrameQR Code: ecc is fixed to H for this profile');
+    throw new EncodeError('Sythos Canvas QR: ecc is fixed to H for this profile');
   }
 
   const qrOptions = {
@@ -124,7 +123,7 @@ export function encodeFrameQR(text, options = {}) {
       analysis = validateCanvasSpec(versionFor(matrix), canvas);
     } catch (error) {
       if (error instanceof EncodeError) throw error;
-      throw new EncodeError(`FrameQR Code: invalid canvas: ${error.message}`);
+      throw new EncodeError(`Sythos Canvas QR: invalid canvas: ${error.message}`);
     }
     if (!analysis.safe) {
       unsafeAnalysis = analysis;
@@ -137,13 +136,13 @@ export function encodeFrameQR(text, options = {}) {
   if (!selected) {
     if (unsafeAnalysis) {
       throw new EncodeError(
-        'FrameQR Code: canvas is not safe for the selected QR version; ' +
+        'Sythos Canvas QR: canvas is not safe for the selected QR version; ' +
         `it touches ${unsafeAnalysis.touchedCodewordCount} codewords and has ` +
         `a per-block correction budget of ${unsafeAnalysis.correctionBudgetPerBlock}`
       );
     }
     if (capacityError) throw capacityError;
-    throw new EncodeError('FrameQR Code: unable to select a QR version');
+    throw new EncodeError('Sythos Canvas QR: unable to select a QR version');
   }
 
   const { matrix, canvas } = selected;

package/src/{frameqr/index.js → ts/frameqr/index.ts}

@@ -4,7 +4,6 @@
  * MIT License
  *
  * Copyright (c) 2026 Sythos
- * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal

package/src/{frameqr/tables.js → ts/frameqr/tables.ts}

@@ -4,7 +4,6 @@
  * MIT License
  *
  * Copyright (c) 2026 Sythos
- * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -30,7 +29,7 @@
  */
 
 /**
- * Structural contract for FrameQR Code.
+ * Structural contract for the Sythos Canvas QR profile.
  *
  * DENSO WAVE's public material describes FrameQR(R) as a proprietary symbol
  * with a freely shaped canvas, dedicated generation/reading software and no
@@ -42,7 +41,7 @@
  * symbol at level H and clears a bounded group of data modules. Its worst-case
  * damage is calculated per Reed-Solomon block and must remain within the
  * standard QR correction radius. Function modules are never canvas modules.
- * This provides a deterministic, independently testable FrameQR Code profile, but
+ * This provides a deterministic, independently testable canvas QR profile, but
  * it is explicitly non-certified and not a substitute for proprietary FrameQR
  * generation or validation software.
  *
@@ -59,7 +58,7 @@ import {
 /** Public identity and compatibility boundary of the implementable profile. */
 export const FRAMEQR_PROFILE = Object.freeze({
   id: 'sythos-canvas-qr/1',
-  name: 'FrameQR Code',
+  name: 'Sythos Canvas QR profile',
   certified: false,
   densoFrameQrCompatible: false,
   baseSymbology: 'QR Code Model 2',
@@ -78,7 +77,7 @@ function oddAtMost(value, maximum) {
 
 function assertSymbolSize(symbolSize) {
   if (!Number.isInteger(symbolSize) || symbolSize < 21 || symbolSize > 177 || (symbolSize - 17) % 4 !== 0) {
-    throw new RangeError(`FrameQR Code: ${symbolSize} is not a QR Model 2 symbol size`);
+    throw new RangeError(`Frame QR profile: ${symbolSize} is not a QR Model 2 symbol size`);
   }
 }
 
@@ -96,12 +95,12 @@ function assertSymbolSize(symbolSize) {
 export function normalizeCanvasSpec(symbolSize, canvas = {}) {
   assertSymbolSize(symbolSize);
   if (canvas === null || typeof canvas !== 'object' || Array.isArray(canvas)) {
-    throw new TypeError('FrameQR Code: canvas must be an object');
+    throw new TypeError('Frame QR profile: canvas must be an object');
   }
 
   const shape = String(canvas.shape ?? 'square').toLowerCase();
   if (!FRAMEQR_CANVAS_SHAPES.includes(shape)) {
-    throw new RangeError(`FrameQR Code: unsupported canvas shape "${shape}"`);
+    throw new RangeError(`Frame QR profile: unsupported canvas shape "${shape}"`);
   }
 
   const defaultSize = oddAtMost(Math.max(3, Math.round(symbolSize * 0.17)), symbolSize - 16);
@@ -112,7 +111,7 @@ export function normalizeCanvasSpec(symbolSize, canvas = {}) {
   for (const [name, value] of [['width', requestedWidth], ['height', requestedHeight]]) {
     if (!Number.isFinite(Number(value)) || Number(value) < 1 || Number(value) > maximumDimension) {
       throw new RangeError(
-        `FrameQR Code: canvas ${name} must be between 1 and ${maximumDimension} modules`
+        `Frame QR profile: canvas ${name} must be between 1 and ${maximumDimension} modules`
       );
     }
   }
@@ -123,10 +122,10 @@ export function normalizeCanvasSpec(symbolSize, canvas = {}) {
   const angle = ((Number(canvas.angle ?? 0) % 360) + 360) % 360;
 
   if (![0, 90, 180, 270].includes(angle)) {
-    throw new RangeError('FrameQR Code: angle must be 0, 90, 180 or 270 degrees');
+    throw new RangeError('Frame QR profile: angle must be 0, 90, 180 or 270 degrees');
   }
   if (centerX < 8 || centerY < 8 || centerX >= symbolSize - 8 || centerY >= symbolSize - 8) {
-    throw new RangeError('FrameQR Code: canvas centre must remain inside the finder-pattern boundary');
+    throw new RangeError('Frame QR profile: canvas centre must remain inside the finder-pattern boundary');
   }
 
   return { shape, centerX, centerY, width, height, angle };
@@ -197,7 +196,7 @@ function codewordBlockMap(layout) {
  */
 export function analyzeCanvasDamage(version, canvas = {}) {
   if (!Number.isInteger(version) || version < 1 || version > 40) {
-    throw new RangeError(`FrameQR Code: version must be an integer 1-40, got ${version}`);
+    throw new RangeError(`Frame QR profile: version must be an integer 1-40, got ${version}`);
   }
   const symbolSize = versionSize(version);
   const spec = normalizeCanvasSpec(symbolSize, canvas);

package/src/{image/binarizer.js → ts/image/binarizer.ts}

@@ -23,7 +23,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  *
- * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  * SPDX-License-Identifier: MIT
  *
  * Original work. No code from any other barcode implementation.

package/src/{image/grid-sampler.js → ts/image/grid-sampler.ts}

@@ -23,7 +23,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  *
- * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  * SPDX-License-Identifier: MIT
  *
  * Original work. No code from any other barcode implementation.

package/src/{image/index.js → ts/image/index.ts}

@@ -23,7 +23,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  *
- * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  * SPDX-License-Identifier: MIT
  *
  * Original work. No code from any other barcode implementation.

package/src/{image/luminance.js → ts/image/luminance.ts}

@@ -23,7 +23,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  *
- * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  * SPDX-License-Identifier: MIT
  *
  * Original work. No code from any other barcode implementation.

package/src/{image/perspective.js → ts/image/perspective.ts}

@@ -23,7 +23,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  *
- * SPDX-FileCopyrightText: 2026 Sythos (https://www.sythos.net)
  * SPDX-License-Identifier: MIT
  *
  * Original work. No code from any other barcode implementation.

package/{typings → src/ts}/index.d.ts

@@ -248,7 +248,7 @@ export type DecodeResult = {
     /**
      * Camera-profile orientation in degrees.
      */
-    rotation?: 0 | 90 | 180 | 270;
+    rotation?: 0 | 45 | 90 | 135 | 180 | 225 | 270 | 315;
     /**
      * Camera-profile validation evidence.
      */
@@ -310,7 +310,7 @@ export type DecodeResult = {
  * @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.
@@ -360,4 +360,4 @@ export declare function decodeStrict(image: {
     height: number;
 }, options?: object): DecodeResult;
 /** Library version, matching package.json. */
-export declare const VERSION = "1.5.6";
+export declare const VERSION = "1.5.9";