pdf-parser.js 5.2.26 → 5.2.28

package/dist/image/jpeg2000-t1.js

@@ -14,7 +14,9 @@ const STYLE_TERMINATE_ALL = 4;
 const STYLE_VERTICALLY_CAUSAL = 8;
 const STYLE_SEGMENTATION_SYMBOLS = 32;
 const SEGMENTATION_SYMBOL = 10;
+const SEGMENTATION_SYMBOL_MSB_SHIFT = 3;
 const STRIPE_HEIGHT = 4;
+const HEX_RADIX = 16;
 const PASS_SIGNIFICANCE = 0;
 const PASS_REFINEMENT = 1;
 const PASS_CLEANUP = 2;
@@ -22,25 +24,33 @@ function throwForUnsupportedStyle(style) {
 	if ((style & STYLE_SELECTIVE_BYPASS) !== 0) throw new Jpeg2000UnsupportedError("the code-block style enables selective arithmetic coding bypass (lazy mode), which splits a code-block into raw and arithmetically coded segments this decoder does not read");
 	if ((style & STYLE_TERMINATE_ALL) !== 0) throw new Jpeg2000UnsupportedError("the code-block style terminates the arithmetic coder on every coding pass, which splits a code-block into one segment per pass this decoder does not read");
 }
+const ZC_CONTEXT_3 = 3;
+const ZC_CONTEXT_4 = 4;
+const ZC_CONTEXT_5 = 5;
+const ZC_CONTEXT_6 = 6;
+const ZC_CONTEXT_7 = 7;
+const ZC_CONTEXT_8 = 8;
+const HH_DIAGONAL_NEIGHBOURS_HIGH = 3;
 function zeroCodingContext(subband, horizontal, vertical, diagonal) {
 	if (subband === "HH") {
 		const straight = horizontal + vertical;
-		if (diagonal >= 3) return 8;
-		if (diagonal === 2) return straight >= 1 ? 7 : 6;
-		if (diagonal === 1) return straight >= 2 ? 5 : straight === 1 ? 4 : 3;
+		if (diagonal >= HH_DIAGONAL_NEIGHBOURS_HIGH) return ZC_CONTEXT_8;
+		if (diagonal === 2) return straight >= 1 ? ZC_CONTEXT_7 : ZC_CONTEXT_6;
+		if (diagonal === 1) return straight >= 2 ? ZC_CONTEXT_5 : straight === 1 ? ZC_CONTEXT_4 : ZC_CONTEXT_3;
 		return straight >= 2 ? 2 : straight === 1 ? 1 : 0;
 	}
 	const primary = subband === "HL" ? vertical : horizontal;
 	const secondary = subband === "HL" ? horizontal : vertical;
-	if (primary === 2) return 8;
+	if (primary === 2) return ZC_CONTEXT_8;
 	if (primary === 1) {
-		if (secondary >= 1) return 7;
-		return diagonal >= 1 ? 6 : 5;
+		if (secondary >= 1) return ZC_CONTEXT_7;
+		return diagonal >= 1 ? ZC_CONTEXT_6 : ZC_CONTEXT_5;
 	}
-	if (secondary === 2) return 4;
-	if (secondary === 1) return 3;
+	if (secondary === 2) return ZC_CONTEXT_4;
+	if (secondary === 1) return ZC_CONTEXT_3;
 	return diagonal >= 2 ? 2 : diagonal === 1 ? 1 : 0;
 }
+const SIGN_CONTEXT_TABLE_ROW_STRIDE = 3;
 const SIGN_XOR_FLAG = 8;
 const SIGN_CONTEXT_TABLE = [
 	12,
@@ -101,7 +111,7 @@ function decodeJpeg2000CodeBlock(options) {
 		const below = belowVisible(y, stripeEnd);
 		const horizontal = clampToUnit(contribution(n - 1) + contribution(n + 1));
 		const vertical = clampToUnit(contribution(n - stride) + (below ? contribution(n + stride) : 0));
-		const packed = SIGN_CONTEXT_TABLE[(horizontal + 1) * 3 + (vertical + 1)] ?? 0;
+		const packed = SIGN_CONTEXT_TABLE[(horizontal + 1) * SIGN_CONTEXT_TABLE_ROW_STRIDE + (vertical + 1)] ?? 0;
 		const decision = mq.decode(contexts, SIGN_CONTEXT_BASE + (packed & -9));
 		negative[n] = decision ^ ((packed & SIGN_XOR_FLAG) !== 0 ? 1 : 0);
 	};
@@ -159,8 +169,8 @@ function decodeJpeg2000CodeBlock(options) {
 			}
 		}
 		if (segmentationSymbols) {
-			const symbol = mq.decode(contexts, UNIFORM_CONTEXT) << 3 | mq.decode(contexts, UNIFORM_CONTEXT) << 2 | mq.decode(contexts, UNIFORM_CONTEXT) << 1 | mq.decode(contexts, UNIFORM_CONTEXT);
-			if (symbol !== SEGMENTATION_SYMBOL) throw new Jpeg2000ParseError(`a cleanup pass ended with segmentation symbol 0x${symbol.toString(16)} rather than the 0xA ISO/IEC 15444-1 D.3.4 requires, so this code-block's coded data is corrupt`);
+			const symbol = mq.decode(contexts, UNIFORM_CONTEXT) << SEGMENTATION_SYMBOL_MSB_SHIFT | mq.decode(contexts, UNIFORM_CONTEXT) << 2 | mq.decode(contexts, UNIFORM_CONTEXT) << 1 | mq.decode(contexts, UNIFORM_CONTEXT);
+			if (symbol !== SEGMENTATION_SYMBOL) throw new Jpeg2000ParseError(`a cleanup pass ended with segmentation symbol 0x${symbol.toString(HEX_RADIX)} rather than the 0xA ISO/IEC 15444-1 D.3.4 requires, so this code-block's coded data is corrupt`);
 		}
 		codedThisPlane.fill(0);
 	};

package/dist/image/jpeg2000-t2.cjs

@@ -63,8 +63,9 @@ function bandCoordinate(componentCoordinate, levels, orientation) {
 	const half = 2 ** (levels - 1);
 	return Math.ceil((componentCoordinate - half * orientation) / (2 * half));
 }
+const SUBBANDS_PER_RESOLUTION_LEVEL = 3;
 function quantizationIndex(resolution, bandIndex) {
-	return resolution === 0 ? 0 : 3 * (resolution - 1) + bandIndex + 1;
+	return resolution === 0 ? 0 : SUBBANDS_PER_RESOLUTION_LEVEL * (resolution - 1) + bandIndex + 1;
 }
 function stepSizeFor(quantization, resolution, bandIndex) {
 	if (quantization.style === "derived") {
@@ -203,14 +204,20 @@ function buildTileGeometry(siz, tileX, tileY, codingPerComponent, quantizationPe
 function subbandGainLog2(type) {
 	return SUBBAND_GAIN_LOG2[type];
 }
+const CODING_PASSES_RANGE_3_5_BASE = 3;
+const CODING_PASSES_5_BIT_FIELD_WIDTH = 5;
+const CODING_PASSES_5_BIT_FIELD_ESCAPE = 31;
+const CODING_PASSES_RANGE_6_36_BASE = 6;
+const CODING_PASSES_RANGE_37_164_BASE = 37;
+const CODING_PASSES_7_BIT_FIELD_WIDTH = 7;
 function readCodingPasses(reader) {
 	if (reader.readBit() === 0) return 1;
 	if (reader.readBit() === 0) return 2;
 	const twoBit = reader.readBits(2);
-	if (twoBit < 3) return 3 + twoBit;
-	const fiveBit = reader.readBits(5);
-	if (fiveBit < 31) return 6 + fiveBit;
-	return 37 + reader.readBits(7);
+	if (twoBit < CODING_PASSES_RANGE_3_5_BASE) return CODING_PASSES_RANGE_3_5_BASE + twoBit;
+	const fiveBit = reader.readBits(CODING_PASSES_5_BIT_FIELD_WIDTH);
+	if (fiveBit < CODING_PASSES_5_BIT_FIELD_ESCAPE) return CODING_PASSES_RANGE_6_36_BASE + fiveBit;
+	return CODING_PASSES_RANGE_37_164_BASE + reader.readBits(CODING_PASSES_7_BIT_FIELD_WIDTH);
 }
 function buildPacketSequence(tile, order, layers) {
 	const maxResolutions = Math.max(...tile.components.map((component) => component.resolutions.length));

package/dist/image/jpeg2000-t2.js

@@ -62,8 +62,9 @@ function bandCoordinate(componentCoordinate, levels, orientation) {
 	const half = 2 ** (levels - 1);
 	return Math.ceil((componentCoordinate - half * orientation) / (2 * half));
 }
+const SUBBANDS_PER_RESOLUTION_LEVEL = 3;
 function quantizationIndex(resolution, bandIndex) {
-	return resolution === 0 ? 0 : 3 * (resolution - 1) + bandIndex + 1;
+	return resolution === 0 ? 0 : SUBBANDS_PER_RESOLUTION_LEVEL * (resolution - 1) + bandIndex + 1;
 }
 function stepSizeFor(quantization, resolution, bandIndex) {
 	if (quantization.style === "derived") {
@@ -202,14 +203,20 @@ function buildTileGeometry(siz, tileX, tileY, codingPerComponent, quantizationPe
 function subbandGainLog2(type) {
 	return SUBBAND_GAIN_LOG2[type];
 }
+const CODING_PASSES_RANGE_3_5_BASE = 3;
+const CODING_PASSES_5_BIT_FIELD_WIDTH = 5;
+const CODING_PASSES_5_BIT_FIELD_ESCAPE = 31;
+const CODING_PASSES_RANGE_6_36_BASE = 6;
+const CODING_PASSES_RANGE_37_164_BASE = 37;
+const CODING_PASSES_7_BIT_FIELD_WIDTH = 7;
 function readCodingPasses(reader) {
 	if (reader.readBit() === 0) return 1;
 	if (reader.readBit() === 0) return 2;
 	const twoBit = reader.readBits(2);
-	if (twoBit < 3) return 3 + twoBit;
-	const fiveBit = reader.readBits(5);
-	if (fiveBit < 31) return 6 + fiveBit;
-	return 37 + reader.readBits(7);
+	if (twoBit < CODING_PASSES_RANGE_3_5_BASE) return CODING_PASSES_RANGE_3_5_BASE + twoBit;
+	const fiveBit = reader.readBits(CODING_PASSES_5_BIT_FIELD_WIDTH);
+	if (fiveBit < CODING_PASSES_5_BIT_FIELD_ESCAPE) return CODING_PASSES_RANGE_6_36_BASE + fiveBit;
+	return CODING_PASSES_RANGE_37_164_BASE + reader.readBits(CODING_PASSES_7_BIT_FIELD_WIDTH);
 }
 function buildPacketSequence(tile, order, layers) {
 	const maxResolutions = Math.max(...tile.components.map((component) => component.resolutions.length));

package/dist/image/jpeg2000-tagtree.cjs

@@ -2,6 +2,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_image_jpeg2000_errors = require("./jpeg2000-errors.cjs");
 //#region src/image/jpeg2000-tagtree.ts
 const SENTINEL_VALUE = 2147483647;
+const STUFFING_TRIGGER_BYTE = 255;
+const MOST_SIGNIFICANT_BIT_MASK = 128;
+const STUFFED_BYTE_BIT_COUNT = 7;
+const BYTE_BIT_COUNT = 8;
 var PacketBitReader = class {
 	data;
 	end;
@@ -28,12 +32,12 @@ var PacketBitReader = class {
 	}
 	readBit() {
 		if (this.available === 0) {
-			const stuffed = this.previousByte === 255;
+			const stuffed = this.previousByte === STUFFING_TRIGGER_BYTE;
 			const byte = this.nextByte();
-			if (stuffed && (byte & 128) !== 0) throw new require_image_jpeg2000_errors.Jpeg2000ParseError("a packet header byte following 0xFF has its stuffed bit set, which ISO/IEC 15444-1 B.10.1 forbids");
+			if (stuffed && (byte & MOST_SIGNIFICANT_BIT_MASK) !== 0) throw new require_image_jpeg2000_errors.Jpeg2000ParseError("a packet header byte following 0xFF has its stuffed bit set, which ISO/IEC 15444-1 B.10.1 forbids");
 			this.buffer = byte;
 			this.previousByte = byte;
-			this.available = stuffed ? 7 : 8;
+			this.available = stuffed ? STUFFED_BYTE_BIT_COUNT : BYTE_BIT_COUNT;
 		}
 		this.available--;
 		return this.buffer >> this.available & 1;
@@ -44,7 +48,7 @@ var PacketBitReader = class {
 		return value;
 	}
 	alignToByte() {
-		if (this.previousByte === 255) this.nextByte();
+		if (this.previousByte === STUFFING_TRIGGER_BYTE) this.nextByte();
 		this.available = 0;
 		this.previousByte = 0;
 	}

package/dist/image/jpeg2000-tagtree.js

@@ -1,6 +1,10 @@
 import { Jpeg2000ParseError } from "./jpeg2000-errors.js";
 //#region src/image/jpeg2000-tagtree.ts
 const SENTINEL_VALUE = 2147483647;
+const STUFFING_TRIGGER_BYTE = 255;
+const MOST_SIGNIFICANT_BIT_MASK = 128;
+const STUFFED_BYTE_BIT_COUNT = 7;
+const BYTE_BIT_COUNT = 8;
 var PacketBitReader = class {
 	data;
 	end;
@@ -27,12 +31,12 @@ var PacketBitReader = class {
 	}
 	readBit() {
 		if (this.available === 0) {
-			const stuffed = this.previousByte === 255;
+			const stuffed = this.previousByte === STUFFING_TRIGGER_BYTE;
 			const byte = this.nextByte();
-			if (stuffed && (byte & 128) !== 0) throw new Jpeg2000ParseError("a packet header byte following 0xFF has its stuffed bit set, which ISO/IEC 15444-1 B.10.1 forbids");
+			if (stuffed && (byte & MOST_SIGNIFICANT_BIT_MASK) !== 0) throw new Jpeg2000ParseError("a packet header byte following 0xFF has its stuffed bit set, which ISO/IEC 15444-1 B.10.1 forbids");
 			this.buffer = byte;
 			this.previousByte = byte;
-			this.available = stuffed ? 7 : 8;
+			this.available = stuffed ? STUFFED_BYTE_BIT_COUNT : BYTE_BIT_COUNT;
 		}
 		this.available--;
 		return this.buffer >> this.available & 1;
@@ -43,7 +47,7 @@ var PacketBitReader = class {
 		return value;
 	}
 	alignToByte() {
-		if (this.previousByte === 255) this.nextByte();
+		if (this.previousByte === STUFFING_TRIGGER_BYTE) this.nextByte();
 		this.available = 0;
 		this.previousByte = 0;
 	}

package/dist/image/jpeg2000.cjs

@@ -29,6 +29,8 @@ function tileDefaults(main, tile) {
 	if (main.cod === void 0) throw new require_image_jpeg2000_errors.Jpeg2000ParseError("no COD marker defines a coding style for this codestream");
 	return main.cod;
 }
+const CODE_BLOCK_STYLE_TERMINATE_ON_EACH_PASS_BIT = 4;
+const MAX_SUPPORTED_COMPONENT_BIT_DEPTH = 31;
 function undecodableReason(codestream) {
 	const main = codestream.main;
 	const cod = main.cod;
@@ -46,7 +48,7 @@ function undecodableReason(codestream) {
 		for (const header of headers) {
 			const style = resolveCoding(main, header === main ? void 0 : header, c);
 			if ((style.codeBlockStyle & 1) !== 0) return "the code-block style enables selective arithmetic coding bypass, which this decoder does not read";
-			if ((style.codeBlockStyle & 4) !== 0) return "the code-block style terminates the arithmetic coder on every coding pass, which this decoder does not read";
+			if ((style.codeBlockStyle & CODE_BLOCK_STYLE_TERMINATE_ON_EACH_PASS_BIT) !== 0) return "the code-block style terminates the arithmetic coder on every coding pass, which this decoder does not read";
 		}
 	}
 	for (const part of codestream.tileParts) {
@@ -60,7 +62,7 @@ function undecodableReason(codestream) {
 	const first = codestream.siz.components[0];
 	if (first !== void 0) {
 		for (const size of codestream.siz.components) if (size.bitDepth !== first.bitDepth || size.signed !== first.signed) return "the codestream mixes component bit depths or signedness, which this decoder does not combine into one image";
-		if (first.bitDepth > 31) return `a component bit depth of ${String(first.bitDepth)} exceeds what this decoder's own 32-bit sample arithmetic can hold`;
+		if (first.bitDepth > MAX_SUPPORTED_COMPONENT_BIT_DEPTH) return `a component bit depth of ${String(first.bitDepth)} exceeds what this decoder's own 32-bit sample arithmetic can hold`;
 	}
 }
 function readJpeg2000Metadata(data) {
@@ -121,8 +123,9 @@ function concatTilePartData(codestream, tileIndex) {
 function halveTowardZero(value) {
 	return value < 0 ? -(-value >> 1) : value >> 1;
 }
+const MANTISSA_FIXED_POINT_SCALE = 2048;
 function quantizationStep(band, componentBitDepth) {
-	return 2 ** (componentBitDepth + require_image_jpeg2000_t2.subbandGainLog2(band.type) - band.stepSize.exponent) * (1 + band.stepSize.mantissa / 2048);
+	return 2 ** (componentBitDepth + require_image_jpeg2000_t2.subbandGainLog2(band.type) - band.stepSize.exponent) * (1 + band.stepSize.mantissa / MANTISSA_FIXED_POINT_SCALE);
 }
 function decodeSubbandBlocks(band, codeBlockStyle, data, place) {
 	for (const precinct of band.precincts) for (const block of precinct.codeBlocks) {
@@ -218,13 +221,14 @@ function decodeIrreversibleTileComponent(tile, componentIndex, componentBitDepth
 	}
 	return current;
 }
+const RCT_GREEN_RECOVERY_DIVISOR = 4;
 function inverseReversibleComponentTransform(planes) {
 	const y = planes[0];
 	const u = planes[1];
 	const v = planes[2];
 	if (y === void 0 || u === void 0 || v === void 0) return;
 	for (let i = 0; i < y.length; i++) {
-		const green = (y[i] ?? 0) - Math.floor(((u[i] ?? 0) + (v[i] ?? 0)) / 4);
+		const green = (y[i] ?? 0) - Math.floor(((u[i] ?? 0) + (v[i] ?? 0)) / RCT_GREEN_RECOVERY_DIVISOR);
 		const red = (v[i] ?? 0) + green;
 		const blue = (u[i] ?? 0) + green;
 		y[i] = red;
@@ -250,6 +254,7 @@ function inverseIrreversibleComponentTransform(planes) {
 		cr[i] = luma + ICT_BLUE_FROM_CB * blueDiff;
 	}
 }
+const MULTIPLE_COMPONENT_TRANSFORM_MIN_COMPONENTS = 3;
 function decodeJpeg2000(data, options = {}) {
 	const onWarning = options.onWarning ?? (() => void 0);
 	const container = require_image_jp2_boxes.parseJp2Container(data);
@@ -285,11 +290,11 @@ function decodeJpeg2000(data, options = {}) {
 		const tilePlanes = [];
 		if (defaults.transform === "reversible-5-3") {
 			const reversible = Array.from({ length: componentCount }, (_, c) => decodeReversibleTileComponent(geometry, c, tileData));
-			if (defaults.multipleComponentTransform && componentCount >= 3) inverseReversibleComponentTransform(reversible);
+			if (defaults.multipleComponentTransform && componentCount >= MULTIPLE_COMPONENT_TRANSFORM_MIN_COMPONENTS) inverseReversibleComponentTransform(reversible);
 			tilePlanes.push(...reversible);
 		} else {
 			const irreversible = Array.from({ length: componentCount }, (_, c) => decodeIrreversibleTileComponent(geometry, c, first.bitDepth, tileData));
-			if (defaults.multipleComponentTransform && componentCount >= 3) inverseIrreversibleComponentTransform(irreversible);
+			if (defaults.multipleComponentTransform && componentCount >= MULTIPLE_COMPONENT_TRANSFORM_MIN_COMPONENTS) inverseIrreversibleComponentTransform(irreversible);
 			tilePlanes.push(...irreversible);
 		}
 		for (let c = 0; c < componentCount; c++) {

package/dist/image/jpeg2000.js

@@ -28,6 +28,8 @@ function tileDefaults(main, tile) {
 	if (main.cod === void 0) throw new Jpeg2000ParseError("no COD marker defines a coding style for this codestream");
 	return main.cod;
 }
+const CODE_BLOCK_STYLE_TERMINATE_ON_EACH_PASS_BIT = 4;
+const MAX_SUPPORTED_COMPONENT_BIT_DEPTH = 31;
 function undecodableReason(codestream) {
 	const main = codestream.main;
 	const cod = main.cod;
@@ -45,7 +47,7 @@ function undecodableReason(codestream) {
 		for (const header of headers) {
 			const style = resolveCoding(main, header === main ? void 0 : header, c);
 			if ((style.codeBlockStyle & 1) !== 0) return "the code-block style enables selective arithmetic coding bypass, which this decoder does not read";
-			if ((style.codeBlockStyle & 4) !== 0) return "the code-block style terminates the arithmetic coder on every coding pass, which this decoder does not read";
+			if ((style.codeBlockStyle & CODE_BLOCK_STYLE_TERMINATE_ON_EACH_PASS_BIT) !== 0) return "the code-block style terminates the arithmetic coder on every coding pass, which this decoder does not read";
 		}
 	}
 	for (const part of codestream.tileParts) {
@@ -59,7 +61,7 @@ function undecodableReason(codestream) {
 	const first = codestream.siz.components[0];
 	if (first !== void 0) {
 		for (const size of codestream.siz.components) if (size.bitDepth !== first.bitDepth || size.signed !== first.signed) return "the codestream mixes component bit depths or signedness, which this decoder does not combine into one image";
-		if (first.bitDepth > 31) return `a component bit depth of ${String(first.bitDepth)} exceeds what this decoder's own 32-bit sample arithmetic can hold`;
+		if (first.bitDepth > MAX_SUPPORTED_COMPONENT_BIT_DEPTH) return `a component bit depth of ${String(first.bitDepth)} exceeds what this decoder's own 32-bit sample arithmetic can hold`;
 	}
 }
 function readJpeg2000Metadata(data) {
@@ -120,8 +122,9 @@ function concatTilePartData(codestream, tileIndex) {
 function halveTowardZero(value) {
 	return value < 0 ? -(-value >> 1) : value >> 1;
 }
+const MANTISSA_FIXED_POINT_SCALE = 2048;
 function quantizationStep(band, componentBitDepth) {
-	return 2 ** (componentBitDepth + subbandGainLog2(band.type) - band.stepSize.exponent) * (1 + band.stepSize.mantissa / 2048);
+	return 2 ** (componentBitDepth + subbandGainLog2(band.type) - band.stepSize.exponent) * (1 + band.stepSize.mantissa / MANTISSA_FIXED_POINT_SCALE);
 }
 function decodeSubbandBlocks(band, codeBlockStyle, data, place) {
 	for (const precinct of band.precincts) for (const block of precinct.codeBlocks) {
@@ -217,13 +220,14 @@ function decodeIrreversibleTileComponent(tile, componentIndex, componentBitDepth
 	}
 	return current;
 }
+const RCT_GREEN_RECOVERY_DIVISOR = 4;
 function inverseReversibleComponentTransform(planes) {
 	const y = planes[0];
 	const u = planes[1];
 	const v = planes[2];
 	if (y === void 0 || u === void 0 || v === void 0) return;
 	for (let i = 0; i < y.length; i++) {
-		const green = (y[i] ?? 0) - Math.floor(((u[i] ?? 0) + (v[i] ?? 0)) / 4);
+		const green = (y[i] ?? 0) - Math.floor(((u[i] ?? 0) + (v[i] ?? 0)) / RCT_GREEN_RECOVERY_DIVISOR);
 		const red = (v[i] ?? 0) + green;
 		const blue = (u[i] ?? 0) + green;
 		y[i] = red;
@@ -249,6 +253,7 @@ function inverseIrreversibleComponentTransform(planes) {
 		cr[i] = luma + ICT_BLUE_FROM_CB * blueDiff;
 	}
 }
+const MULTIPLE_COMPONENT_TRANSFORM_MIN_COMPONENTS = 3;
 function decodeJpeg2000(data, options = {}) {
 	const onWarning = options.onWarning ?? (() => void 0);
 	const container = parseJp2Container(data);
@@ -284,11 +289,11 @@ function decodeJpeg2000(data, options = {}) {
 		const tilePlanes = [];
 		if (defaults.transform === "reversible-5-3") {
 			const reversible = Array.from({ length: componentCount }, (_, c) => decodeReversibleTileComponent(geometry, c, tileData));
-			if (defaults.multipleComponentTransform && componentCount >= 3) inverseReversibleComponentTransform(reversible);
+			if (defaults.multipleComponentTransform && componentCount >= MULTIPLE_COMPONENT_TRANSFORM_MIN_COMPONENTS) inverseReversibleComponentTransform(reversible);
 			tilePlanes.push(...reversible);
 		} else {
 			const irreversible = Array.from({ length: componentCount }, (_, c) => decodeIrreversibleTileComponent(geometry, c, first.bitDepth, tileData));
-			if (defaults.multipleComponentTransform && componentCount >= 3) inverseIrreversibleComponentTransform(irreversible);
+			if (defaults.multipleComponentTransform && componentCount >= MULTIPLE_COMPONENT_TRANSFORM_MIN_COMPONENTS) inverseIrreversibleComponentTransform(irreversible);
 			tilePlanes.push(...irreversible);
 		}
 		for (let c = 0; c < componentCount; c++) {

package/dist/image/png-decode.cjs

@@ -4,30 +4,39 @@ const require_bytes_flate = require("../bytes/flate.cjs");
 const require_image_png_filter = require("./png-filter.cjs");
 const require_bytes_crc32 = require("../bytes/crc32.cjs");
 //#region src/image/png-decode.ts
+const PNG_SIGNATURE_HIGH_BIT_MARKER = 137;
+const PNG_SIGNATURE_P = 80;
+const PNG_SIGNATURE_N = 78;
+const PNG_SIGNATURE_G = 71;
+const PNG_SIGNATURE_CR = 13;
+const PNG_SIGNATURE_LF = 10;
 const PNG_SIGNATURE = [
-	137,
-	80,
-	78,
-	71,
-	13,
-	10,
+	PNG_SIGNATURE_HIGH_BIT_MARKER,
+	PNG_SIGNATURE_P,
+	PNG_SIGNATURE_N,
+	PNG_SIGNATURE_G,
+	PNG_SIGNATURE_CR,
+	PNG_SIGNATURE_LF,
 	26,
-	10
+	PNG_SIGNATURE_LF
 ];
 function requireDataView(bytes) {
 	return new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
 }
+const PNG_CHUNK_LENGTH_SIZE = 4;
+const PNG_CHUNK_CRC_SIZE = 4;
+const PNG_CHUNK_HEADER_SIZE = 8;
 function readChunks(bytes, onWarning) {
 	const chunks = [];
 	const view = requireDataView(bytes);
 	let offset = PNG_SIGNATURE.length;
-	while (offset + 8 <= bytes.length) {
+	while (offset + PNG_CHUNK_HEADER_SIZE <= bytes.length) {
 		const length = view.getUint32(offset);
-		const typeBytes = bytes.subarray(offset + 4, offset + 8);
+		const typeBytes = bytes.subarray(offset + PNG_CHUNK_LENGTH_SIZE, offset + PNG_CHUNK_HEADER_SIZE);
 		const type = new TextDecoder("latin1").decode(typeBytes);
-		const dataStart = offset + 8;
+		const dataStart = offset + PNG_CHUNK_HEADER_SIZE;
 		const dataEnd = dataStart + length;
-		if (dataEnd + 4 > bytes.length) throw new Error(`PNG chunk '${type}' declares a length that runs past the end of the file`);
+		if (dataEnd + PNG_CHUNK_CRC_SIZE > bytes.length) throw new Error(`PNG chunk '${type}' declares a length that runs past the end of the file`);
 		const data = bytes.subarray(dataStart, dataEnd);
 		if (onWarning !== void 0) {
 			if (view.getUint32(dataEnd) !== require_bytes_crc32.crc32(require_bytes_writer.concatBytes([typeBytes, data]))) onWarning(`PNG chunk '${type}' failed its CRC32 check`);
@@ -36,42 +45,53 @@ function readChunks(bytes, onWarning) {
 			type,
 			data
 		});
-		offset = dataEnd + 4;
+		offset = dataEnd + PNG_CHUNK_CRC_SIZE;
 		if (type === "IEND") break;
 	}
 	return chunks;
 }
+const IHDR_HEIGHT_OFFSET = 4;
 function parseIhdr(data) {
 	const view = requireDataView(data);
 	return {
 		width: view.getUint32(0),
-		height: view.getUint32(4),
+		height: view.getUint32(IHDR_HEIGHT_OFFSET),
 		bitDepth: data[8],
 		colorType: data[9],
 		interlace: data[12]
 	};
 }
+const PNG_COLOR_TYPE_GRAYSCALE = 0;
+const PNG_COLOR_TYPE_TRUECOLOR = 2;
+const PNG_COLOR_TYPE_INDEXED = 3;
+const PNG_COLOR_TYPE_GRAYSCALE_ALPHA = 4;
+const PNG_COLOR_TYPE_TRUECOLOR_ALPHA = 6;
+const PNG_CHANNELS_TRUECOLOR = 3;
+const PNG_CHANNELS_TRUECOLOR_ALPHA = 4;
 function channelsForColorType(colorType) {
-	if (colorType === 0) return 1;
-	if (colorType === 2) return 3;
-	if (colorType === 3) return 1;
-	if (colorType === 4) return 2;
-	if (colorType === 6) return 4;
+	if (colorType === PNG_COLOR_TYPE_GRAYSCALE) return 1;
+	if (colorType === PNG_COLOR_TYPE_TRUECOLOR) return PNG_CHANNELS_TRUECOLOR;
+	if (colorType === PNG_COLOR_TYPE_INDEXED) return 1;
+	if (colorType === PNG_COLOR_TYPE_GRAYSCALE_ALPHA) return 2;
+	if (colorType === PNG_COLOR_TYPE_TRUECOLOR_ALPHA) return PNG_CHANNELS_TRUECOLOR_ALPHA;
 	throw new Error(`unsupported PNG colour type: ${colorType}`);
 }
+const BITS_PER_BYTE = 8;
 function filterBpp(bitDepth, channels) {
-	return Math.max(1, Math.ceil(bitDepth * channels / 8));
+	return Math.max(1, Math.ceil(bitDepth * channels / BITS_PER_BYTE));
 }
+const PNG_BIT_DEPTH_16 = 16;
+const BYTE_INDEX_SHIFT = 3;
 function unpackRow(rowBytes, width, channels, bitDepth) {
 	const sampleCount = width * channels;
 	const samples = Array.from({ length: sampleCount });
-	if (bitDepth === 16) for (let i = 0; i < sampleCount; i++) samples[i] = rowBytes[i * 2];
+	if (bitDepth === PNG_BIT_DEPTH_16) for (let i = 0; i < sampleCount; i++) samples[i] = rowBytes[i * 2];
 	else {
 		const mask = (1 << bitDepth) - 1;
 		for (let i = 0; i < sampleCount; i++) {
 			const bitOffset = i * bitDepth;
-			const byteIndex = bitOffset >> 3;
-			const shift = 8 - bitDepth - (bitOffset & 7);
+			const byteIndex = bitOffset >> BYTE_INDEX_SHIFT;
+			const shift = BITS_PER_BYTE - bitDepth - (bitOffset & 7);
 			samples[i] = rowBytes[byteIndex] >> shift & mask;
 		}
 	}
@@ -80,18 +100,20 @@ function unpackRow(rowBytes, width, channels, bitDepth) {
 function readTrnsGrayValue(trns) {
 	return requireDataView(trns).getUint16(0);
 }
+const TRNS_RGB_BLUE_OFFSET = 4;
 function readTrnsRgbKey(trns) {
 	const view = requireDataView(trns);
 	return [
 		view.getUint16(0),
 		view.getUint16(2),
-		view.getUint16(4)
+		view.getUint16(TRNS_RGB_BLUE_OFFSET)
 	];
 }
+const MAX_BYTE_VALUE = 255;
 function scaleToByte(sample, bitDepth) {
-	if (bitDepth === 16) return sample;
+	if (bitDepth === PNG_BIT_DEPTH_16) return sample;
 	const maxSample = (1 << bitDepth) - 1;
-	return Math.round(sample * 255 / maxSample);
+	return Math.round(sample * MAX_BYTE_VALUE / maxSample);
 }
 function decodePng(bytes, options = {}) {
 	for (let i = 0; i < PNG_SIGNATURE.length; i++) if (bytes[i] !== PNG_SIGNATURE[i]) throw new Error("not a valid PNG file: bad signature");
@@ -102,23 +124,24 @@ function decodePng(bytes, options = {}) {
 	if (ihdr.interlace !== 0) throw new Error("Adam7-interlaced PNG images are not supported");
 	const channels = channelsForColorType(ihdr.colorType);
 	const bpp = filterBpp(ihdr.bitDepth, channels);
-	const bytesPerRow = Math.ceil(ihdr.width * channels * ihdr.bitDepth / 8);
+	const bytesPerRow = Math.ceil(ihdr.width * channels * ihdr.bitDepth / BITS_PER_BYTE);
 	const idatChunks = chunks.filter((c) => c.type === "IDAT").map((c) => c.data);
 	if (idatChunks.length === 0) throw new Error("PNG file has no IDAT chunks");
 	const compressed = require_bytes_writer.concatBytes(idatChunks);
 	const { bytes: inflated, recovered } = require_bytes_flate.inflateTolerant(compressed);
 	if (recovered && options.onWarning !== void 0) options.onWarning("PNG IDAT stream required tolerant recovery (truncated or malformed)");
 	const unfiltered = require_image_png_filter.unfilterScanlines(inflated, ihdr.height, bytesPerRow, bpp);
-	const palette = ihdr.colorType === 3 ? chunks.find((c) => c.type === "PLTE")?.data : void 0;
-	if (ihdr.colorType === 3 && palette === void 0) throw new Error("indexed-colour PNG has no PLTE chunk");
+	const palette = ihdr.colorType === PNG_COLOR_TYPE_INDEXED ? chunks.find((c) => c.type === "PLTE")?.data : void 0;
+	if (ihdr.colorType === PNG_COLOR_TYPE_INDEXED && palette === void 0) throw new Error("indexed-colour PNG has no PLTE chunk");
 	const trns = chunks.find((c) => c.type === "tRNS")?.data;
 	return buildRawImage(ihdr, channels, bytesPerRow, unfiltered, palette, trns);
 }
+const ALPHA_SAMPLE_INDEX_IN_RGBA = 3;
 function buildRawImage(ihdr, channels, bytesPerRow, unfiltered, palette, trns) {
 	const { width, height, bitDepth, colorType } = ihdr;
-	const outChannels = colorType === 0 || colorType === 4 ? 1 : 3;
+	const outChannels = colorType === 0 || colorType === PNG_COLOR_TYPE_GRAYSCALE_ALPHA ? 1 : PNG_CHANNELS_TRUECOLOR;
 	const data = new Uint8Array(width * height * outChannels);
-	const alpha = colorType === 4 || colorType === 6 || trns !== void 0 ? new Uint8Array(width * height).fill(255) : void 0;
+	const alpha = colorType === PNG_COLOR_TYPE_GRAYSCALE_ALPHA || colorType === PNG_COLOR_TYPE_TRUECOLOR_ALPHA || trns !== void 0 ? new Uint8Array(width * height).fill(MAX_BYTE_VALUE) : void 0;
 	const trnsGray = colorType === 0 && trns !== void 0 ? readTrnsGrayValue(trns) : void 0;
 	const trnsRgb = colorType === 2 && trns !== void 0 ? readTrnsRgbKey(trns) : void 0;
 	for (let y = 0; y < height; y++) {
@@ -131,7 +154,7 @@ function buildRawImage(ihdr, channels, bytesPerRow, unfiltered, palette, trns) {
 			if (colorType === 0) {
 				const g = samples[pixelBase];
 				data[outBase] = scaleToByte(g, bitDepth);
-				if (alpha !== void 0 && trnsGray !== void 0) alpha[alphaIndex] = g === trnsGray ? 0 : 255;
+				if (alpha !== void 0 && trnsGray !== void 0) alpha[alphaIndex] = g === trnsGray ? 0 : MAX_BYTE_VALUE;
 			} else if (colorType === 2) {
 				const r = samples[pixelBase];
 				const g = samples[pixelBase + 1];
@@ -141,15 +164,15 @@ function buildRawImage(ihdr, channels, bytesPerRow, unfiltered, palette, trns) {
 				data[outBase + 2] = b;
 				if (alpha !== void 0 && trnsRgb !== void 0) {
 					const [kr, kg, kb] = trnsRgb;
-					alpha[alphaIndex] = r === kr && g === kg && b === kb ? 0 : 255;
+					alpha[alphaIndex] = r === kr && g === kg && b === kb ? 0 : MAX_BYTE_VALUE;
 				}
-			} else if (colorType === 3) {
+			} else if (colorType === PNG_COLOR_TYPE_INDEXED) {
 				const index = samples[pixelBase];
-				data[outBase] = palette[index * 3];
-				data[outBase + 1] = palette[index * 3 + 1];
-				data[outBase + 2] = palette[index * 3 + 2];
-				if (alpha !== void 0 && trns !== void 0) alpha[alphaIndex] = index < trns.length ? trns[index] : 255;
-			} else if (colorType === 4) {
+				data[outBase] = palette[index * PNG_CHANNELS_TRUECOLOR];
+				data[outBase + 1] = palette[index * PNG_CHANNELS_TRUECOLOR + 1];
+				data[outBase + 2] = palette[index * PNG_CHANNELS_TRUECOLOR + 2];
+				if (alpha !== void 0 && trns !== void 0) alpha[alphaIndex] = index < trns.length ? trns[index] : MAX_BYTE_VALUE;
+			} else if (colorType === PNG_COLOR_TYPE_GRAYSCALE_ALPHA) {
 				const g = samples[pixelBase];
 				const a = samples[pixelBase + 1];
 				data[outBase] = scaleToByte(g, bitDepth);
@@ -158,7 +181,7 @@ function buildRawImage(ihdr, channels, bytesPerRow, unfiltered, palette, trns) {
 				data[outBase] = samples[pixelBase];
 				data[outBase + 1] = samples[pixelBase + 1];
 				data[outBase + 2] = samples[pixelBase + 2];
-				if (alpha !== void 0) alpha[alphaIndex] = samples[pixelBase + 3];
+				if (alpha !== void 0) alpha[alphaIndex] = samples[pixelBase + ALPHA_SAMPLE_INDEX_IN_RGBA];
 			}
 		}
 	}

package/dist/image/png-decode.d.cts

@@ -1,8 +1,9 @@
 //#region src/image/png-decode.d.ts
+type ImageChannels = 1 | 3;
 interface RawImage {
   readonly width: number;
   readonly height: number;
-  readonly channels: 1 | 3;
+  readonly channels: ImageChannels;
   readonly data: Uint8Array<ArrayBuffer>;
   readonly alpha?: Uint8Array<ArrayBuffer>;
 }
@@ -11,4 +12,4 @@ interface PngDecodeOptions {
 }
 declare function decodePng(bytes: Uint8Array<ArrayBuffer>, options?: PngDecodeOptions): RawImage;
 //#endregion
-export { PngDecodeOptions, RawImage, decodePng };
+export { ImageChannels, PngDecodeOptions, RawImage, decodePng };

package/dist/image/png-decode.d.ts

@@ -1,8 +1,9 @@
 //#region src/image/png-decode.d.ts
+type ImageChannels = 1 | 3;
 interface RawImage {
   readonly width: number;
   readonly height: number;
-  readonly channels: 1 | 3;
+  readonly channels: ImageChannels;
   readonly data: Uint8Array<ArrayBuffer>;
   readonly alpha?: Uint8Array<ArrayBuffer>;
 }
@@ -11,4 +12,4 @@ interface PngDecodeOptions {
 }
 declare function decodePng(bytes: Uint8Array<ArrayBuffer>, options?: PngDecodeOptions): RawImage;
 //#endregion
-export { PngDecodeOptions, RawImage, decodePng };
+export { ImageChannels, PngDecodeOptions, RawImage, decodePng };