@sythos/js_barcode_universal 1.3.1 → 1.5.0

package/src/databar/index.js

@@ -0,0 +1,69 @@
+/*!
+ * Sythos Barcode Suite
+ *
+ * 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
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ *
+ * Original work. No code from any other barcode implementation.
+ */
+
+/** Verified GS1 DataBar data-layer primitives. @module databar */
+
+export {
+  dataBarGtinTransmission,
+  decodeDataBar14GTIN,
+  decodeDataBarLimitedGTIN,
+  encodeDataBar14GTIN,
+  encodeDataBarLimitedGTIN,
+  gtinCheckDigit,
+  makeGTIN14,
+  normalizeGTIN,
+} from './codec.js';
+
+export {
+  GS1_SEPARATOR,
+  decodeGS1ElementString,
+  encodeGS1ElementString,
+  formatGS1Elements,
+  gs1AIInfo,
+  parseGS1ElementString,
+} from './gs1.js';
+
+export {
+  DATABAR14_VARIANTS,
+  DATABAR_LIMITED_VARIANT,
+  dataBar14GroupFor,
+  validateDataBarTables,
+} from './tables.js';
+
+export { encodeDataBar14 } from './encoder.js';
+export { decodeDataBar14, decodeDataBar14Scanline } from './decoder.js';
+export {
+  DATABAR14_CHECKSUM_WEIGHTS,
+  DATABAR14_FINDERS,
+  dataBar14CharacterWidths,
+  dataBar14ValueForWidths,
+  dataBarWidths,
+} from './patterns.js';

package/src/databar/patterns.js

@@ -0,0 +1,144 @@
+/*!
+ * Sythos Barcode Suite
+ *
+ * MIT License
+ *
+ * Copyright (c) 2026 Sythos
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * 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.
+ */
+
+/** Mathematical width construction for GS1 DataBar characters. @module databar/patterns */
+
+import { dataBar14GroupFor } from './tables.js';
+
+function combinations(n, r) {
+  if (n < r || r < 0) return 0;
+  if (r === 0 || n === r) return 1;
+  let result = 1;
+  const k = Math.min(r, n - r);
+  for (let i = 1; i <= k; i++) result = result * (n - k + i) / i;
+  return result;
+}
+
+/**
+ * Unrank one constrained positive composition.
+ *
+ * The rank is the GS1 DataBar symbol-character value inside its group. This
+ * implementation follows the combinatorial definition directly: it counts
+ * every remaining admissible suffix rather than storing third-party patterns.
+ */
+export function dataBarWidths(rank, modules, elements, maximumWidth, noNarrow) {
+  if (!Number.isInteger(rank) || rank < 0) throw new RangeError('GS1 DataBar width rank must be non-negative');
+  const widths = new Array(elements).fill(0);
+  let remaining = modules;
+  let narrowMask = 0;
+
+  for (let bar = 0; bar < elements - 1; bar++) {
+    let count = 0;
+    for (let width = 1; ; width++) {
+      narrowMask |= width === 1 ? 1 << bar : 0;
+      count = combinations(remaining - width - 1, elements - bar - 2);
+
+      if (noNarrow && narrowMask === 0 && remaining - width - (elements - bar - 1) >= elements - bar - 1) {
+        count -= combinations(remaining - width - (elements - bar), elements - bar - 2);
+      }
+
+      if (elements - bar - 1 > 1) {
+        let tooWide = 0;
+        for (let last = remaining - width - (elements - bar - 2); last > maximumWidth; last--) {
+          tooWide += combinations(remaining - width - last - 1, elements - bar - 3);
+        }
+        count -= tooWide * (elements - 1 - bar);
+      } else if (remaining - width > maximumWidth) {
+        count--;
+      }
+
+      if (rank < count) {
+        widths[bar] = width;
+        remaining -= width;
+        break;
+      }
+      rank -= count;
+      narrowMask &= ~(1 << bar);
+    }
+  }
+  widths[elements - 1] = remaining;
+  if (rank !== 0 || widths.some((width) => width < 1 || width > maximumWidth)) {
+    throw new RangeError('GS1 DataBar width rank exceeds its character group');
+  }
+  return widths;
+}
+
+/** Convert one DataBar-14 character value into its eight alternating widths. */
+export function dataBar14CharacterWidths(value, kind) {
+  const group = dataBar14GroupFor(value, kind);
+  const offset = value - group.gsum;
+  const outside = kind === 'outside';
+  const oddRank = outside ? Math.floor(offset / group.evenTotal) : offset % group.oddTotal;
+  const evenRank = outside ? offset % group.evenTotal : Math.floor(offset / group.oddTotal);
+  const odd = dataBarWidths(oddRank, group.oddModules, 4, group.oddWidest, !outside);
+  const even = dataBarWidths(evenRank, group.evenModules, 4, group.evenWidest, outside);
+  const result = [];
+  for (let i = 0; i < 4; i++) result.push(odd[i], even[i]);
+  return result;
+}
+
+const inverseCharacterMaps = new Map();
+
+/** Recover a character value from its canonical eight-width representation. */
+export function dataBar14ValueForWidths(widths, kind) {
+  if (!Array.isArray(widths) || widths.length !== 8 || widths.some((width) => !Number.isInteger(width) || width < 1)) {
+    throw new TypeError('GS1 DataBar character widths must contain eight positive integers');
+  }
+  if (kind !== 'outside' && kind !== 'inside') throw new RangeError(`Unknown GS1 DataBar character kind "${kind}"`);
+  let inverse = inverseCharacterMaps.get(kind);
+  if (!inverse) {
+    inverse = new Map();
+    const maximum = kind === 'outside' ? 2840 : 1596;
+    for (let value = 0; value <= maximum; value++) {
+      inverse.set(dataBar14CharacterWidths(value, kind).join(','), value);
+    }
+    inverseCharacterMaps.set(kind, inverse);
+  }
+  const value = inverse.get(widths.join(','));
+  if (value === undefined) throw new RangeError(`Invalid GS1 DataBar ${kind} character widths`);
+  return value;
+}
+
+/** Nine finder patterns, expressed as normative five-element widths. */
+export const DATABAR14_FINDERS = Object.freeze([
+  Object.freeze([3, 8, 2, 1, 1]), Object.freeze([3, 5, 5, 1, 1]),
+  Object.freeze([3, 3, 7, 1, 1]), Object.freeze([3, 1, 9, 1, 1]),
+  Object.freeze([2, 7, 4, 1, 1]), Object.freeze([2, 5, 6, 1, 1]),
+  Object.freeze([2, 3, 8, 1, 1]), Object.freeze([1, 5, 7, 1, 1]),
+  Object.freeze([1, 3, 9, 1, 1]),
+]);
+
+/** Weight sequence generated as powers of three modulo 79. */
+export const DATABAR14_CHECKSUM_WEIGHTS = Object.freeze(Array.from({ length: 32 }, (_, index) => {
+  let value = 1;
+  for (let i = 0; i < index; i++) value = (value * 3) % 79;
+  return value;
+}));

package/src/databar/tables.js

@@ -0,0 +1,125 @@
+/*!
+ * Sythos Barcode Suite
+ *
+ * MIT License
+ *
+ * Copyright (c) 2026 Sythos
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * 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.
+ */
+
+/**
+ * Static GS1 DataBar facts used by the GTIN compaction codec.
+ *
+ * The numbers in the DataBar-14 group tables are the public tables in
+ * ISO/IEC 24724:2011, clauses 5.2.2 and 5.2.3. They describe values, not a
+ * third-party implementation. Pattern construction deliberately belongs in
+ * the renderer/encoder layer so this module stays a small, auditable contract.
+ *
+ * @module databar/tables
+ */
+
+const group = (first, last, gsum, oddModules, evenModules, oddWidest, evenWidest, oddTotal, evenTotal) => Object.freeze({
+  first, last, gsum, oddModules, evenModules, oddWidest, evenWidest, oddTotal, evenTotal,
+});
+
+/** The four GTIN-only layouts sharing the DataBar-14 compaction rules. */
+export const DATABAR14_VARIANTS = Object.freeze({
+  omnidirectional: Object.freeze({ id: 'omnidirectional', rows: 1, modules: 96, checksumModulus: 79, pointOfSale: true }),
+  truncated: Object.freeze({ id: 'truncated', rows: 1, modules: 96, checksumModulus: 79, pointOfSale: false }),
+  stacked: Object.freeze({ id: 'stacked', rows: 2, modules: 50, checksumModulus: 79, pointOfSale: false }),
+  'stacked-omnidirectional': Object.freeze({ id: 'stacked-omnidirectional', rows: 2, modules: 50, checksumModulus: 79, pointOfSale: true }),
+});
+
+/** GS1 DataBar Limited is a distinct two-character symbology. */
+export const DATABAR_LIMITED_VARIANT = Object.freeze({
+  id: 'limited', rows: 1, checksumModulus: 89, pointOfSale: false,
+  permittedIndicatorDigits: Object.freeze([0, 1]),
+});
+
+/** (16,4) outside character groups, ISO/IEC 24724:2011 Table 1. */
+export const DATABAR14_OUTSIDE_GROUPS = Object.freeze([
+  group(0, 160, 0, 12, 4, 8, 1, 161, 1),
+  group(161, 960, 161, 10, 6, 6, 3, 80, 10),
+  group(961, 2014, 961, 8, 8, 4, 5, 31, 34),
+  group(2015, 2714, 2015, 6, 10, 3, 6, 10, 70),
+  group(2715, 2840, 2715, 4, 12, 1, 8, 1, 126),
+]);
+
+/** (15,4) inside character groups, ISO/IEC 24724:2011 Table 2. */
+export const DATABAR14_INSIDE_GROUPS = Object.freeze([
+  group(0, 335, 0, 5, 10, 2, 7, 4, 84),
+  group(336, 1035, 336, 7, 8, 4, 5, 20, 35),
+  group(1036, 1515, 1036, 9, 6, 6, 3, 48, 10),
+  group(1516, 1596, 1516, 11, 4, 8, 1, 81, 1),
+]);
+
+/** Number of values carried by an inside (15,4) character. */
+export const DATABAR14_INSIDE_RADIX = 1597;
+/** Number of values carried by one outside/inside character pair. */
+export const DATABAR14_PAIR_RADIX = 4537077;
+/** Stand-alone and composite DataBar-14 payload domain, including linkage. */
+export const DATABAR14_SYMBOL_LIMIT = 20000000000000n;
+
+/** GS1 DataBar Limited divides its 13 data digits into two character values. */
+export const DATABAR_LIMITED_PAIR_RADIX = 2013571;
+/** Offset that switches a DataBar Limited value from stand-alone to composite. */
+export const DATABAR_LIMITED_LINKAGE_OFFSET = 2015133531096n;
+/** DataBar Limited carries GTIN values whose first digit is zero or one. */
+export const DATABAR_LIMITED_DATA_LIMIT = 2000000000000n;
+
+/** Locate the value group that an outside or inside character belongs to. */
+export function dataBar14GroupFor(value, kind) {
+  if (!Number.isInteger(value)) throw new TypeError('GS1 DataBar character value must be an integer');
+  const groups = kind === 'outside' ? DATABAR14_OUTSIDE_GROUPS
+    : kind === 'inside' ? DATABAR14_INSIDE_GROUPS : null;
+  if (!groups) throw new RangeError(`Unknown GS1 DataBar character kind "${kind}"`);
+  const found = groups.find((entry) => value >= entry.first && value <= entry.last);
+  if (!found) throw new RangeError(`GS1 DataBar ${kind} character value ${value} is out of range`);
+  return found;
+}
+/** Check the independently represented table identities. */
+export function validateDataBarTables() {
+  const problems = [];
+  const validateGroups = (name, groups, expectedLast) => {
+    let next = 0;
+    for (const entry of groups) {
+      if (entry.first !== next) problems.push(`${name}: gap before ${entry.first}`);
+      if (entry.last < entry.first) problems.push(`${name}: inverted range ${entry.first}-${entry.last}`);
+      if (entry.oddTotal * entry.evenTotal !== entry.last - entry.first + 1) {
+        problems.push(`${name}: combination count mismatch at ${entry.first}`);
+      }
+      next = entry.last + 1;
+    }
+    if (next - 1 !== expectedLast) problems.push(`${name}: final value is ${next - 1}, expected ${expectedLast}`);
+  };
+  validateGroups('outside', DATABAR14_OUTSIDE_GROUPS, 2840);
+  validateGroups('inside', DATABAR14_INSIDE_GROUPS, 1596);
+  if (DATABAR14_PAIR_RADIX !== 2841 * DATABAR14_INSIDE_RADIX) problems.push('pair radix mismatch');
+  if (DATABAR14_SYMBOL_LIMIT !== 2n * 10000000000000n) problems.push('symbol limit mismatch');
+  if (DATABAR_LIMITED_LINKAGE_OFFSET !== BigInt(DATABAR_LIMITED_PAIR_RADIX) * 1000776n) {
+    problems.push('limited linkage offset mismatch');
+  }
+  return problems;
+}

package/src/datamatrix/decoder.js

@@ -23,6 +23,7 @@
  * 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/datamatrix/detector.js

@@ -23,6 +23,7 @@
  * 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/datamatrix/encoder.js

@@ -23,6 +23,7 @@
  * 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/datamatrix/index.js

@@ -23,6 +23,7 @@
  * 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/datamatrix/tables.js

@@ -23,6 +23,7 @@
  * 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/frameqr/decoder.js

@@ -4,6 +4,7 @@
  * 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
@@ -29,7 +30,7 @@
  */
 
 /**
- * Decoder for the Sythos Canvas QR profile.
+ * Decoder for FrameQR Code.
  *
  * This is intentionally not a DENSO FrameQR decoder. The profile is a QR
  * symbol with a bounded artwork reservation and an explicit `frameqr` marker.
@@ -87,7 +88,7 @@ function isExpectedProfile(profile) {
  * @returns {{canvas: object, damage: object}}
  */
 function validateCanvas(symbolSize, version, canvas) {
-  if (!isObject(canvas)) throw new FormatError('Sythos Canvas QR: canvas metadata is missing');
+  if (!isObject(canvas)) throw new FormatError('FrameQR Code: canvas metadata is missing');
 
   let normalized;
   try {
@@ -103,14 +104,14 @@ function validateCanvas(symbolSize, version, canvas) {
     }
   } catch (error) {
     if (error instanceof FormatError) throw error;
-    throw new FormatError(`Sythos Canvas QR: invalid canvas metadata: ${error.message}`);
+    throw new FormatError(`FrameQR Code: invalid canvas metadata: ${error.message}`);
   }
 
   let damage;
   try {
     damage = analyzeCanvasDamage(version, normalized);
   } catch (error) {
-    throw new FormatError(`Sythos Canvas QR: cannot analyse canvas damage: ${error.message}`);
+    throw new FormatError(`FrameQR Code: cannot analyse canvas damage: ${error.message}`);
   }
   return { canvas: normalized, damage };
 }
@@ -135,24 +136,24 @@ function resolveProfile(matrix, options) {
     const markerId = isObject(markerProfile) ? markerProfile.id : markerProfile;
     const suppliedId = isObject(suppliedProfile) ? suppliedProfile.id : suppliedProfile;
     if (markerId !== suppliedId) {
-      throw new FormatError('Sythos Canvas QR: matrix and requested profile markers disagree');
+      throw new FormatError('FrameQR Code: matrix and requested profile markers disagree');
     }
   }
   const profile = markerProfile ?? suppliedProfile;
 
   if (!isExpectedProfile(profile)) {
     throw new FormatError(
-      'Sythos Canvas QR: profile marker is missing or is not the Sythos Canvas QR profile'
+      'FrameQR Code: profile marker is missing or is not a FrameQR Code symbol'
     );
   }
   if (marker && marker.certified === true) {
     throw new FormatError(
-      'Sythos Canvas QR: certified FrameQR input is not supported by this profile decoder'
+      'FrameQR Code: certified FrameQR input is not supported by this profile decoder'
     );
   }
   if (!marker && !options.allowUnmarked) {
     throw new FormatError(
-      'Sythos Canvas QR: unmarked QR matrix rejected; provide a verified profile marker'
+      'FrameQR Code: unmarked QR matrix rejected; provide a verified profile marker'
     );
   }
 
@@ -160,7 +161,7 @@ function resolveProfile(matrix, options) {
   const canvas = options.canvas ?? markerCanvas;
   const version = (matrix.width - 17) / 4;
   if (!Number.isInteger(version) || version < 1 || version > 40) {
-    throw new FormatError(`Sythos Canvas QR: invalid QR symbol size ${matrix.width}`);
+    throw new FormatError(`FrameQR Code: invalid QR symbol size ${matrix.width}`);
   }
   const checked = validateCanvas(matrix.width, version, canvas);
   if (markerCanvas && options.canvas) {
@@ -168,11 +169,11 @@ function resolveProfile(matrix, options) {
     try {
       marked = normalizeCanvasSpec(matrix.width, markerCanvas);
     } catch (error) {
-      throw new FormatError(`Sythos Canvas QR: invalid marker canvas: ${error.message}`);
+      throw new FormatError(`FrameQR Code: invalid marker canvas: ${error.message}`);
     }
     const fields = ['shape', 'centerX', 'centerY', 'width', 'height', 'angle'];
     if (fields.some((field) => marked[field] !== checked.canvas[field])) {
-      throw new FormatError('Sythos Canvas QR: matrix and requested canvas metadata disagree');
+      throw new FormatError('FrameQR Code: matrix and requested canvas metadata disagree');
     }
   }
   return {
@@ -184,7 +185,7 @@ function resolveProfile(matrix, options) {
 }
 
 /**
- * Decode a Sythos Canvas QR matrix.
+ * Decode a FrameQR Code matrix.
  *
  * @param {import('../core/bit-matrix.js').BitMatrix} matrix
  *   Square QR modules, normally returned by `encodeFrameQR` or a FrameQR
@@ -204,11 +205,11 @@ function resolveProfile(matrix, options) {
  */
 export function decodeFrameQR(matrix, options = {}) {
   if (!matrix || !Number.isInteger(matrix.width) || !Number.isInteger(matrix.height)) {
-    throw new FormatError('Sythos Canvas QR: no matrix supplied');
+    throw new FormatError('FrameQR Code: no matrix supplied');
   }
   if (matrix.width !== matrix.height) {
     throw new FormatError(
-      `Sythos Canvas QR: symbol must be square, got ${matrix.width}x${matrix.height}`
+      `FrameQR Code: symbol must be square, got ${matrix.width}x${matrix.height}`
     );
   }
 
@@ -220,7 +221,7 @@ export function decodeFrameQR(matrix, options = {}) {
     // Preserve the original QR/RS error when possible, but give callers a
     // profile-specific context without exposing implementation details.
     if (error instanceof FormatError) {
-      throw new FormatError(`Sythos Canvas QR: payload is not recoverable: ${error.message}`);
+      throw new FormatError(`FrameQR Code: payload is not recoverable: ${error.message}`);
     }
     throw error;
   }

package/src/frameqr/detector.js

@@ -4,6 +4,7 @@
  * 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
@@ -29,7 +30,7 @@
  */
 
 /**
- * Detector for the non-certified Sythos Canvas QR profile.
+ * Detector for the non-certified FrameQR Code profile.
  *
  * The profile deliberately reuses QR Model 2 geometry. Finder localisation and
  * projective sampling therefore use the QR detector; the additional profile
@@ -98,7 +99,7 @@ function sameCandidate(left, right) {
 }
 
 /**
- * Detect Sythos Canvas QR symbols in a binarized raster.
+ * Detect FrameQR Code symbols in a binarized raster.
  *
  * @param {import('../core/bit-matrix.js').BitMatrix} binaryImage Set bit = dark.
  * @param {object} [options]

package/src/frameqr/encoder.js

@@ -4,6 +4,7 @@
  * 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
@@ -29,7 +30,7 @@
  */
 
 /**
- * Sythos Canvas QR profile encoder.
+ * FrameQR Code encoder.
  *
  * This encoder deliberately builds on this project's QR Code implementation
  * and then removes a conservatively bounded set of data modules for artwork.
@@ -68,7 +69,7 @@ function clearCanvas(matrix, modules) {
 
 /**
  * Encode a QR Code with a conservative artwork canvas according to the
- * non-certified Sythos Canvas QR profile.
+ * non-certified FrameQR Code 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
@@ -84,10 +85,10 @@ function clearCanvas(matrix, modules) {
  */
 export function encodeFrameQR(text, options = {}) {
   if (typeof text !== 'string') {
-    throw new EncodeError('Sythos Canvas QR: text must be a string');
+    throw new EncodeError('FrameQR Code: text must be a string');
   }
   if (options.ecc !== undefined && options.ecc !== 'H') {
-    throw new EncodeError('Sythos Canvas QR: ecc is fixed to H for this profile');
+    throw new EncodeError('FrameQR Code: ecc is fixed to H for this profile');
   }
 
   const qrOptions = {
@@ -123,7 +124,7 @@ export function encodeFrameQR(text, options = {}) {
       analysis = validateCanvasSpec(versionFor(matrix), canvas);
     } catch (error) {
       if (error instanceof EncodeError) throw error;
-      throw new EncodeError(`Sythos Canvas QR: invalid canvas: ${error.message}`);
+      throw new EncodeError(`FrameQR Code: invalid canvas: ${error.message}`);
     }
     if (!analysis.safe) {
       unsafeAnalysis = analysis;
@@ -136,13 +137,13 @@ export function encodeFrameQR(text, options = {}) {
   if (!selected) {
     if (unsafeAnalysis) {
       throw new EncodeError(
-        'Sythos Canvas QR: canvas is not safe for the selected QR version; ' +
+        'FrameQR Code: 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('Sythos Canvas QR: unable to select a QR version');
+    throw new EncodeError('FrameQR Code: unable to select a QR version');
   }
 
   const { matrix, canvas } = selected;

package/src/frameqr/index.js

@@ -4,6 +4,7 @@
  * 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