@sythos/js_barcode_universal 1.5.8 → 1.5.10

package/src/js/aztec/high-level.js

@@ -27,7 +27,6 @@
  *
  * Original work. No code from any other barcode implementation.
  */
-
 /**
  * Aztec high-level stream writer.
  *
@@ -44,22 +43,18 @@
  *
  * @module aztec/high-level
  */
-
 import { BitWriter } from '../core/bit-buffer.js';
 import { EncodeError } from '../core/errors.js';
-
 /** Aztec high-level table identifiers, exposed for decoder/API symmetry. */
 export const HIGH_LEVEL_MODE = Object.freeze({
-  UPPER: 0,
-  LOWER: 1,
-  DIGIT: 2,
-  MIXED: 3,
-  PUNCT: 4,
+    UPPER: 0,
+    LOWER: 1,
+    DIGIT: 2,
+    MIXED: 3,
+    PUNCT: 4,
 });
-
 /** Maximum number of bytes represented by one B/S escape. */
 export const MAX_BINARY_SHIFT = 2078;
-
 /**
  * Convert accepted public input to its encoded octets.
  *
@@ -68,78 +63,81 @@ export const MAX_BINARY_SHIFT = 2078;
  * @returns {Uint8Array}
  */
 export function aztecBytes(value, charset = 'utf-8') {
-  if (charset !== 'utf-8') throw new EncodeError(`Aztec: unsupported charset "${charset}"`);
-  if (typeof value === 'string') return new TextEncoder().encode(value);
-  if (value instanceof ArrayBuffer) return new Uint8Array(value);
-  if (ArrayBuffer.isView(value)) {
-    return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
-  }
-  throw new EncodeError('Aztec: value must be a string, ArrayBuffer, or byte view');
+    if (charset !== 'utf-8')
+        throw new EncodeError(`Aztec: unsupported charset "${charset}"`);
+    if (typeof value === 'string')
+        return new TextEncoder().encode(value);
+    if (value instanceof ArrayBuffer)
+        return new Uint8Array(value);
+    if (ArrayBuffer.isView(value)) {
+        return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+    }
+    throw new EncodeError('Aztec: value must be a string, ArrayBuffer, or byte view');
 }
-
 /** @param {number} byte @returns {number} UPPER-table value, or -1. */
 function upperValue(byte) {
-  if (byte === 0x20) return 1;
-  if (byte >= 0x41 && byte <= 0x5a) return byte - 0x41 + 2;
-  return -1;
+    if (byte === 0x20)
+        return 1;
+    if (byte >= 0x41 && byte <= 0x5a)
+        return byte - 0x41 + 2;
+    return -1;
 }
-
 /** Aztec's latch table, packed as `(bitCount << 16) | bits`. */
 const LATCH = Object.freeze([
-  [0, 327708, 327710, 327709, 656318],
-  [590318, 0, 327710, 327709, 656318],
-  [262158, 590300, 0, 590301, 932798],
-  [327709, 327708, 656322, 0, 327710],
-  [327711, 656380, 656382, 656381, 0],
+    [0, 327708, 327710, 327709, 656318],
+    [590318, 0, 327710, 327709, 656318],
+    [262158, 590300, 0, 590301, 932798],
+    [327709, 327708, 656322, 0, 327710],
+    [327711, 656380, 656382, 656381, 0],
 ]);
-
 /** @param {number} byte @returns {number} */
 function lowerValue(byte) {
-  if (byte === 0x20) return 1;
-  if (byte >= 0x61 && byte <= 0x7a) return byte - 0x61 + 2;
-  return -1;
+    if (byte === 0x20)
+        return 1;
+    if (byte >= 0x61 && byte <= 0x7a)
+        return byte - 0x61 + 2;
+    return -1;
 }
-
 /** @param {number} byte @returns {number} */
 function digitValue(byte) {
-  if (byte === 0x20) return 1;
-  if (byte >= 0x30 && byte <= 0x39) return byte - 0x30 + 2;
-  if (byte === 0x2c) return 12;
-  if (byte === 0x2e) return 13;
-  return -1;
+    if (byte === 0x20)
+        return 1;
+    if (byte >= 0x30 && byte <= 0x39)
+        return byte - 0x30 + 2;
+    if (byte === 0x2c)
+        return 12;
+    if (byte === 0x2e)
+        return 13;
+    return -1;
 }
-
 const PUNCT = new Map([
-  [0x0d, 1], [0x21, 6], [0x22, 7], [0x23, 8], [0x24, 9], [0x25, 10],
-  [0x26, 11], [0x27, 12], [0x28, 13], [0x29, 14], [0x2a, 15], [0x2b, 16],
-  [0x2c, 17], [0x2d, 18], [0x2e, 19], [0x2f, 20], [0x3a, 21], [0x3b, 22],
-  [0x3c, 23], [0x3d, 24], [0x3e, 25], [0x3f, 26], [0x5b, 27], [0x5d, 28],
-  [0x7b, 29], [0x7d, 30],
+    [0x0d, 1], [0x21, 6], [0x22, 7], [0x23, 8], [0x24, 9], [0x25, 10],
+    [0x26, 11], [0x27, 12], [0x28, 13], [0x29, 14], [0x2a, 15], [0x2b, 16],
+    [0x2c, 17], [0x2d, 18], [0x2e, 19], [0x2f, 20], [0x3a, 21], [0x3b, 22],
+    [0x3c, 23], [0x3d, 24], [0x3e, 25], [0x3f, 26], [0x5b, 27], [0x5d, 28],
+    [0x7b, 29], [0x7d, 30],
 ]);
-
 /** @param {number} byte @param {number} mode @returns {number} */
 function textValue(byte, mode) {
-  switch (mode) {
-    case HIGH_LEVEL_MODE.UPPER: return upperValue(byte);
-    case HIGH_LEVEL_MODE.LOWER: return lowerValue(byte);
-    case HIGH_LEVEL_MODE.DIGIT: return digitValue(byte);
-    case HIGH_LEVEL_MODE.PUNCT: return PUNCT.get(byte) ?? -1;
-    default: return -1;
-  }
+    switch (mode) {
+        case HIGH_LEVEL_MODE.UPPER: return upperValue(byte);
+        case HIGH_LEVEL_MODE.LOWER: return lowerValue(byte);
+        case HIGH_LEVEL_MODE.DIGIT: return digitValue(byte);
+        case HIGH_LEVEL_MODE.PUNCT: return PUNCT.get(byte) ?? -1;
+        default: return -1;
+    }
 }
-
 /** @param {BitWriter} writer @param {number} from @param {number} to */
 function latch(writer, from, to) {
-  if (from === to) return;
-  const packed = LATCH[from][to];
-  writer.put(packed & 0xffff, packed >>> 16);
+    if (from === to)
+        return;
+    const packed = LATCH[from][to];
+    writer.put(packed & 0xffff, packed >>> 16);
 }
-
 /** @param {number} mode @returns {number} */
 function characterWidth(mode) {
-  return mode === HIGH_LEVEL_MODE.DIGIT ? 4 : 5;
+    return mode === HIGH_LEVEL_MODE.DIGIT ? 4 : 5;
 }
-
 /**
  * Write an Aztec binary-shift segment while in UPPER mode.
  *
@@ -154,22 +152,23 @@ function characterWidth(mode) {
  * @param {number} length
  */
 export function writeBinaryShift(writer, bytes, start, length) {
-  let at = start;
-  let left = length;
-  while (left > 0) {
-    const count = Math.min(left, MAX_BINARY_SHIFT);
-    writer.put(31, 5); // UPPER B/S
-    if (count <= 31) writer.put(count, 5);
-    else {
-      writer.put(0, 5);
-      writer.put(count - 31, 11);
+    let at = start;
+    let left = length;
+    while (left > 0) {
+        const count = Math.min(left, MAX_BINARY_SHIFT);
+        writer.put(31, 5); // UPPER B/S
+        if (count <= 31)
+            writer.put(count, 5);
+        else {
+            writer.put(0, 5);
+            writer.put(count - 31, 11);
+        }
+        for (let i = 0; i < count; i++)
+            writer.put(bytes[at + i], 8);
+        at += count;
+        left -= count;
     }
-    for (let i = 0; i < count; i++) writer.put(bytes[at + i], 8);
-    at += count;
-    left -= count;
-  }
 }
-
 /**
  * Build a valid Aztec high-level bitstream.
  *
@@ -178,34 +177,40 @@ export function writeBinaryShift(writer, bytes, start, length) {
  * @returns {BitWriter}
  */
 export function encodeHighLevel(value, options = {}) {
-  const bytes = aztecBytes(value, options.charset ?? 'utf-8');
-  const writer = new BitWriter();
-  let mode = HIGH_LEVEL_MODE.UPPER;
-
-  for (let at = 0; at < bytes.length;) {
-    let bestMode = -1;
-    let bestValue = -1;
-    let bestCost = Number.POSITIVE_INFINITY;
-    for (const candidate of [HIGH_LEVEL_MODE.UPPER, HIGH_LEVEL_MODE.LOWER, HIGH_LEVEL_MODE.DIGIT, HIGH_LEVEL_MODE.PUNCT]) {
-      const value = textValue(bytes[at], candidate);
-      if (value < 0) continue;
-      const latchCost = candidate === mode ? 0 : LATCH[mode][candidate] >>> 16;
-      const cost = latchCost + characterWidth(candidate);
-      if (cost < bestCost) { bestCost = cost; bestMode = candidate; bestValue = value; }
-    }
-    if (bestMode >= 0) {
-      latch(writer, mode, bestMode);
-      writer.put(bestValue, characterWidth(bestMode));
-      mode = bestMode;
-      at++;
-    } else {
-      // B/S is defined from UPPER; the latch is retained after the shift.
-      latch(writer, mode, HIGH_LEVEL_MODE.UPPER);
-      mode = HIGH_LEVEL_MODE.UPPER;
-      const start = at;
-      while (at < bytes.length && ![HIGH_LEVEL_MODE.UPPER, HIGH_LEVEL_MODE.LOWER, HIGH_LEVEL_MODE.DIGIT, HIGH_LEVEL_MODE.PUNCT].some((m) => textValue(bytes[at], m) >= 0)) at++;
-      writeBinaryShift(writer, bytes, start, at - start);
+    const bytes = aztecBytes(value, options.charset ?? 'utf-8');
+    const writer = new BitWriter();
+    let mode = HIGH_LEVEL_MODE.UPPER;
+    for (let at = 0; at < bytes.length;) {
+        let bestMode = -1;
+        let bestValue = -1;
+        let bestCost = Number.POSITIVE_INFINITY;
+        for (const candidate of [HIGH_LEVEL_MODE.UPPER, HIGH_LEVEL_MODE.LOWER, HIGH_LEVEL_MODE.DIGIT, HIGH_LEVEL_MODE.PUNCT]) {
+            const value = textValue(bytes[at], candidate);
+            if (value < 0)
+                continue;
+            const latchCost = candidate === mode ? 0 : LATCH[mode][candidate] >>> 16;
+            const cost = latchCost + characterWidth(candidate);
+            if (cost < bestCost) {
+                bestCost = cost;
+                bestMode = candidate;
+                bestValue = value;
+            }
+        }
+        if (bestMode >= 0) {
+            latch(writer, mode, bestMode);
+            writer.put(bestValue, characterWidth(bestMode));
+            mode = bestMode;
+            at++;
+        }
+        else {
+            // B/S is defined from UPPER; the latch is retained after the shift.
+            latch(writer, mode, HIGH_LEVEL_MODE.UPPER);
+            mode = HIGH_LEVEL_MODE.UPPER;
+            const start = at;
+            while (at < bytes.length && ![HIGH_LEVEL_MODE.UPPER, HIGH_LEVEL_MODE.LOWER, HIGH_LEVEL_MODE.DIGIT, HIGH_LEVEL_MODE.PUNCT].some((m) => textValue(bytes[at], m) >= 0))
+                at++;
+            writeBinaryShift(writer, bytes, start, at - start);
+        }
     }
-  }
-  return writer;
+    return writer;
 }

package/src/js/aztec/index.js

@@ -27,19 +27,8 @@
  *
  * Original work. No code from any other barcode implementation.
  */
-
 /** Aztec Code entry points. @module aztec */
-
 export { encodeAztec } from './encoder.js';
 export { decodeAztec } from './decoder.js';
 export { detectAztec, detectAndDecodeAztec } from './detector.js';
-export {
-  AZTEC_COMPACT_LAYERS,
-  AZTEC_FULL_LAYERS,
-  AZTEC_LAYERS,
-  AZTEC_DEFAULT_ECC_PERCENT,
-  AZTEC_RS_GENERATOR_BASE,
-  aztecLayer,
-  aztecSymbolSize,
-  validateAztecTables,
-} from './tables.js';
+export { AZTEC_COMPACT_LAYERS, AZTEC_FULL_LAYERS, AZTEC_LAYERS, AZTEC_DEFAULT_ECC_PERCENT, AZTEC_RS_GENERATOR_BASE, aztecLayer, aztecSymbolSize, validateAztecTables, } from './tables.js';

package/src/js/aztec/tables.js

@@ -27,7 +27,6 @@
  *
  * Original work. No code from any other barcode implementation.
  */
-
 /**
  * Aztec Code layer geometry and Reed-Solomon parameters.
  *
@@ -41,103 +40,90 @@
  *
  * @module aztec/tables
  */
-
 import { GF16, GF64, GF256_AZTEC, GF1024, GF4096 } from '../core/galois-field.js';
-
 /** Reed-Solomon generator base defined for Aztec parameter and data fields. */
 export const AZTEC_RS_GENERATOR_BASE = 1;
-
 /** Minimum recommended error correction: 23 percent plus three codewords. */
 export const AZTEC_DEFAULT_ECC_PERCENT = 23;
 export const AZTEC_MIN_ECC_WORDS = 3;
-
 /** Word size selected solely by the number of layers. */
 export function wordSizeForLayers(layers) {
-  if (!Number.isInteger(layers) || layers < 1 || layers > 32) {
-    throw new RangeError(`Aztec: layers must be an integer from 1 to 32 (got ${layers})`);
-  }
-  if (layers <= 2) return 6;
-  if (layers <= 8) return 8;
-  if (layers <= 22) return 10;
-  return 12;
+    if (!Number.isInteger(layers) || layers < 1 || layers > 32) {
+        throw new RangeError(`Aztec: layers must be an integer from 1 to 32 (got ${layers})`);
+    }
+    if (layers <= 2)
+        return 6;
+    if (layers <= 8)
+        return 8;
+    if (layers <= 22)
+        return 10;
+    return 12;
 }
-
 /** Return the field used by Aztec codewords of `wordSize` bits. */
 export function fieldForWordSize(wordSize) {
-  switch (wordSize) {
-    case 4: return GF16; // Mode message only.
-    case 6: return GF64;
-    case 8: return GF256_AZTEC;
-    case 10: return GF1024;
-    case 12: return GF4096;
-    default: throw new RangeError(`Aztec: unsupported codeword size ${wordSize}`);
-  }
+    switch (wordSize) {
+        case 4: return GF16; // Mode message only.
+        case 6: return GF64;
+        case 8: return GF256_AZTEC;
+        case 10: return GF1024;
+        case 12: return GF4096;
+        default: throw new RangeError(`Aztec: unsupported codeword size ${wordSize}`);
+    }
 }
-
 /** Return the data field selected for a symbol with `layers` layers. */
 export function fieldForLayers(layers) {
-  return fieldForWordSize(wordSizeForLayers(layers));
+    return fieldForWordSize(wordSizeForLayers(layers));
 }
-
 /** Matrix side length, including Full-mode reference grid lines. */
 export function aztecSymbolSize(layers, compact = false) {
-  if (!Number.isInteger(layers) || layers < 1 || layers > (compact ? 4 : 32)) {
-    throw new RangeError(`Aztec: ${compact ? 'Compact' : 'Full'} layers out of range: ${layers}`);
-  }
-  if (compact) return 11 + 4 * layers;
-  const baseMatrixSize = 14 + 4 * layers;
-  return baseMatrixSize + 1 + 2 * Math.floor((baseMatrixSize / 2 - 1) / 15);
+    if (!Number.isInteger(layers) || layers < 1 || layers > (compact ? 4 : 32)) {
+        throw new RangeError(`Aztec: ${compact ? 'Compact' : 'Full'} layers out of range: ${layers}`);
+    }
+    if (compact)
+        return 11 + 4 * layers;
+    const baseMatrixSize = 14 + 4 * layers;
+    return baseMatrixSize + 1 + 2 * Math.floor((baseMatrixSize / 2 - 1) / 15);
 }
-
 function layer(layers, compact) {
-  const wordSize = wordSizeForLayers(layers);
-  const totalBits = ((compact ? 88 : 112) + 16 * layers) * layers;
-  const usableBits = totalBits - totalBits % wordSize;
-  const totalCodewords = usableBits / wordSize;
-  const baseMatrixSize = (compact ? 11 : 14) + 4 * layers;
-  return Object.freeze({
-    compact,
-    layers,
-    wordSize,
-    totalBits,
-    usableBits,
-    totalCodewords,
-    // Compact mode encodes the count in six bits and can therefore hold no
-    // more than 64 data codewords even where the ring itself is larger.
-    maxDataCodewords: compact ? Math.min(totalCodewords, 64) : totalCodewords,
-    baseMatrixSize,
-    symbolSize: aztecSymbolSize(layers, compact),
-    modeMessageDataWords: compact ? 2 : 4,
-    modeMessageWords: compact ? 7 : 10,
-    modeMessageBits: compact ? 28 : 40,
-    rsGeneratorBase: AZTEC_RS_GENERATOR_BASE,
-  });
+    const wordSize = wordSizeForLayers(layers);
+    const totalBits = ((compact ? 88 : 112) + 16 * layers) * layers;
+    const usableBits = totalBits - totalBits % wordSize;
+    const totalCodewords = usableBits / wordSize;
+    const baseMatrixSize = (compact ? 11 : 14) + 4 * layers;
+    return Object.freeze({
+        compact,
+        layers,
+        wordSize,
+        totalBits,
+        usableBits,
+        totalCodewords,
+        // Compact mode encodes the count in six bits and can therefore hold no
+        // more than 64 data codewords even where the ring itself is larger.
+        maxDataCodewords: compact ? Math.min(totalCodewords, 64) : totalCodewords,
+        baseMatrixSize,
+        symbolSize: aztecSymbolSize(layers, compact),
+        modeMessageDataWords: compact ? 2 : 4,
+        modeMessageWords: compact ? 7 : 10,
+        modeMessageBits: compact ? 28 : 40,
+        rsGeneratorBase: AZTEC_RS_GENERATOR_BASE,
+    });
 }
-
 /** Compact Aztec layers 1 through 4, in encoding preference order. */
-export const AZTEC_COMPACT_LAYERS = Object.freeze(
-  Array.from({ length: 4 }, (_, i) => layer(i + 1, true)),
-);
-
+export const AZTEC_COMPACT_LAYERS = Object.freeze(Array.from({ length: 4 }, (_, i) => layer(i + 1, true)));
 /** Full Aztec layers 1 through 32, in ascending layer order. */
-export const AZTEC_FULL_LAYERS = Object.freeze(
-  Array.from({ length: 32 }, (_, i) => layer(i + 1, false)),
-);
-
+export const AZTEC_FULL_LAYERS = Object.freeze(Array.from({ length: 32 }, (_, i) => layer(i + 1, false)));
 /** All allowed symbols. Compact entries precede Full entries for automatic selection. */
 export const AZTEC_LAYERS = Object.freeze([
-  ...AZTEC_COMPACT_LAYERS,
-  ...AZTEC_FULL_LAYERS,
+    ...AZTEC_COMPACT_LAYERS,
+    ...AZTEC_FULL_LAYERS,
 ]);
-
 /** Return one immutable layer record. */
 export function aztecLayer(layers, compact = false) {
-  if (!Number.isInteger(layers) || layers < 1 || layers > (compact ? 4 : 32)) {
-    throw new RangeError(`Aztec: ${compact ? 'Compact' : 'Full'} layers out of range: ${layers}`);
-  }
-  return (compact ? AZTEC_COMPACT_LAYERS : AZTEC_FULL_LAYERS)[layers - 1];
+    if (!Number.isInteger(layers) || layers < 1 || layers > (compact ? 4 : 32)) {
+        throw new RangeError(`Aztec: ${compact ? 'Compact' : 'Full'} layers out of range: ${layers}`);
+    }
+    return (compact ? AZTEC_COMPACT_LAYERS : AZTEC_FULL_LAYERS)[layers - 1];
 }
-
 /**
  * Calculate the minimum parity count for a data word count.
  *
@@ -146,65 +132,65 @@ export function aztecLayer(layers, compact = false) {
  * percentage would otherwise round to zero.
  */
 export function eccCodewordsFor(dataCodewords, eccPercent = AZTEC_DEFAULT_ECC_PERCENT) {
-  if (!Number.isInteger(dataCodewords) || dataCodewords < 0) {
-    throw new RangeError(`Aztec: data codewords must be a non-negative integer (got ${dataCodewords})`);
-  }
-  if (!Number.isFinite(eccPercent) || eccPercent < 0 || eccPercent > 100) {
-    throw new RangeError(`Aztec: ECC percent must be between 0 and 100 (got ${eccPercent})`);
-  }
-  return Math.ceil(dataCodewords * eccPercent / 100) + AZTEC_MIN_ECC_WORDS;
+    if (!Number.isInteger(dataCodewords) || dataCodewords < 0) {
+        throw new RangeError(`Aztec: data codewords must be a non-negative integer (got ${dataCodewords})`);
+    }
+    if (!Number.isFinite(eccPercent) || eccPercent < 0 || eccPercent > 100) {
+        throw new RangeError(`Aztec: ECC percent must be between 0 and 100 (got ${eccPercent})`);
+    }
+    return Math.ceil(dataCodewords * eccPercent / 100) + AZTEC_MIN_ECC_WORDS;
 }
-
 /**
  * Choose the first symbol which holds an already stuffed payload.
  *
  * `dataBits` must be a multiple of the candidate word size; callers which
  * start from high-level bits must stuff separately per candidate word size.
  */
-export function selectAztecLayer(dataBits, {
-  eccPercent = AZTEC_DEFAULT_ECC_PERCENT,
-  layers = null,
-  compact = null,
-} = {}) {
-  if (!Number.isInteger(dataBits) || dataBits < 0) {
-    throw new RangeError(`Aztec: data bits must be a non-negative integer (got ${dataBits})`);
-  }
-  if (compact !== null && typeof compact !== 'boolean') {
-    throw new TypeError('Aztec: compact must be true, false or null');
-  }
-
-  let candidates;
-  if (layers !== null) {
-    if (compact === null) throw new TypeError('Aztec: compact must be specified when layers is specified');
-    candidates = [aztecLayer(layers, compact)];
-  } else if (compact === null) {
-    candidates = AZTEC_LAYERS;
-  } else {
-    candidates = compact ? AZTEC_COMPACT_LAYERS : AZTEC_FULL_LAYERS;
-  }
-
-  for (const candidate of candidates) {
-    if (dataBits % candidate.wordSize !== 0) continue;
-    const dataCodewords = dataBits / candidate.wordSize;
-    const eccCodewords = eccCodewordsFor(dataCodewords, eccPercent);
-    if (dataCodewords <= candidate.maxDataCodewords &&
-        dataCodewords + eccCodewords <= candidate.totalCodewords) {
-      return Object.freeze({ ...candidate, dataCodewords, eccCodewords });
+export function selectAztecLayer(dataBits, { eccPercent = AZTEC_DEFAULT_ECC_PERCENT, layers = null, compact = null, } = {}) {
+    if (!Number.isInteger(dataBits) || dataBits < 0) {
+        throw new RangeError(`Aztec: data bits must be a non-negative integer (got ${dataBits})`);
     }
-  }
-
-  throw new RangeError('Aztec: payload and requested error correction do not fit an available symbol');
+    if (compact !== null && typeof compact !== 'boolean') {
+        throw new TypeError('Aztec: compact must be true, false or null');
+    }
+    let candidates;
+    if (layers !== null) {
+        if (compact === null)
+            throw new TypeError('Aztec: compact must be specified when layers is specified');
+        candidates = [aztecLayer(layers, compact)];
+    }
+    else if (compact === null) {
+        candidates = AZTEC_LAYERS;
+    }
+    else {
+        candidates = compact ? AZTEC_COMPACT_LAYERS : AZTEC_FULL_LAYERS;
+    }
+    for (const candidate of candidates) {
+        if (dataBits % candidate.wordSize !== 0)
+            continue;
+        const dataCodewords = dataBits / candidate.wordSize;
+        const eccCodewords = eccCodewordsFor(dataCodewords, eccPercent);
+        if (dataCodewords <= candidate.maxDataCodewords &&
+            dataCodewords + eccCodewords <= candidate.totalCodewords) {
+            return Object.freeze({ ...candidate, dataCodewords, eccCodewords });
+        }
+    }
+    throw new RangeError('Aztec: payload and requested error correction do not fit an available symbol');
 }
-
 /** Check static identities so table corruption fails explicitly in tests. */
 export function validateAztecTables() {
-  const issues = [];
-  for (const entry of AZTEC_LAYERS) {
-    if (entry.usableBits % entry.wordSize !== 0) issues.push(`${entry.compact ? 'C' : 'F'}${entry.layers}: unaligned usable bits`);
-    if (entry.totalCodewords !== entry.usableBits / entry.wordSize) issues.push(`${entry.compact ? 'C' : 'F'}${entry.layers}: codeword mismatch`);
-    if (entry.symbolSize !== aztecSymbolSize(entry.layers, entry.compact)) issues.push(`${entry.compact ? 'C' : 'F'}${entry.layers}: matrix size mismatch`);
-    if (entry.rsGeneratorBase !== AZTEC_RS_GENERATOR_BASE) issues.push(`${entry.compact ? 'C' : 'F'}${entry.layers}: generator base mismatch`);
-    if (entry.compact && entry.maxDataCodewords > 64) issues.push(`C${entry.layers}: Compact data-word limit exceeded`);
-  }
-  return issues;
+    const issues = [];
+    for (const entry of AZTEC_LAYERS) {
+        if (entry.usableBits % entry.wordSize !== 0)
+            issues.push(`${entry.compact ? 'C' : 'F'}${entry.layers}: unaligned usable bits`);
+        if (entry.totalCodewords !== entry.usableBits / entry.wordSize)
+            issues.push(`${entry.compact ? 'C' : 'F'}${entry.layers}: codeword mismatch`);
+        if (entry.symbolSize !== aztecSymbolSize(entry.layers, entry.compact))
+            issues.push(`${entry.compact ? 'C' : 'F'}${entry.layers}: matrix size mismatch`);
+        if (entry.rsGeneratorBase !== AZTEC_RS_GENERATOR_BASE)
+            issues.push(`${entry.compact ? 'C' : 'F'}${entry.layers}: generator base mismatch`);
+        if (entry.compact && entry.maxDataCodewords > 64)
+            issues.push(`C${entry.layers}: Compact data-word limit exceeded`);
+    }
+    return issues;
 }