pdf-codec 1.6.0 → 1.7.0

package/dist/image/jpeg2000-errors.d.cts

@@ -0,0 +1,9 @@
+//#region src/image/jpeg2000-errors.d.ts
+declare class Jpeg2000ParseError extends Error {
+  constructor(message: string);
+}
+declare class Jpeg2000UnsupportedError extends Error {
+  constructor(message: string);
+}
+//#endregion
+export { Jpeg2000ParseError, Jpeg2000UnsupportedError };

package/dist/image/jpeg2000-errors.d.ts

@@ -0,0 +1,9 @@
+//#region src/image/jpeg2000-errors.d.ts
+declare class Jpeg2000ParseError extends Error {
+  constructor(message: string);
+}
+declare class Jpeg2000UnsupportedError extends Error {
+  constructor(message: string);
+}
+//#endregion
+export { Jpeg2000ParseError, Jpeg2000UnsupportedError };

package/dist/image/jpeg2000-errors.js

@@ -0,0 +1,15 @@
+//#region src/image/jpeg2000-errors.ts
+var Jpeg2000ParseError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "Jpeg2000ParseError";
+	}
+};
+var Jpeg2000UnsupportedError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "Jpeg2000UnsupportedError";
+	}
+};
+//#endregion
+export { Jpeg2000ParseError, Jpeg2000UnsupportedError };

package/dist/image/jpeg2000-t1.cjs

@@ -0,0 +1,254 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_image_jbig2_arith = require("./jbig2-arith.cjs");
+const require_image_jpeg2000_errors = require("./jpeg2000-errors.cjs");
+//#region src/image/jpeg2000-t1.ts
+const SIGN_CONTEXT_BASE = 9;
+const MAGNITUDE_REFINEMENT_NO_NEIGHBOURS = 14;
+const MAGNITUDE_REFINEMENT_WITH_NEIGHBOURS = 15;
+const MAGNITUDE_REFINEMENT_SUBSEQUENT = 16;
+const RUN_LENGTH_CONTEXT = 17;
+const UNIFORM_CONTEXT = 18;
+const CONTEXT_COUNT_BITS = 5;
+const STYLE_SELECTIVE_BYPASS = 1;
+const STYLE_RESET_CONTEXTS = 2;
+const STYLE_TERMINATE_ALL = 4;
+const STYLE_VERTICALLY_CAUSAL = 8;
+const STYLE_SEGMENTATION_SYMBOLS = 32;
+const SEGMENTATION_SYMBOL = 10;
+const STRIPE_HEIGHT = 4;
+const PASS_SIGNIFICANCE = 0;
+const PASS_REFINEMENT = 1;
+const PASS_CLEANUP = 2;
+function throwForUnsupportedStyle(style) {
+	if ((style & STYLE_SELECTIVE_BYPASS) !== 0) throw new require_image_jpeg2000_errors.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 require_image_jpeg2000_errors.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");
+}
+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;
+		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 === 1) {
+		if (secondary >= 1) return 7;
+		return diagonal >= 1 ? 6 : 5;
+	}
+	if (secondary === 2) return 4;
+	if (secondary === 1) return 3;
+	return diagonal >= 2 ? 2 : diagonal === 1 ? 1 : 0;
+}
+const SIGN_CONTEXT_TABLE = (() => {
+	const rows = [
+		[
+			1,
+			1,
+			4,
+			0
+		],
+		[
+			1,
+			0,
+			3,
+			0
+		],
+		[
+			1,
+			-1,
+			2,
+			0
+		],
+		[
+			0,
+			1,
+			1,
+			0
+		],
+		[
+			0,
+			0,
+			0,
+			0
+		],
+		[
+			0,
+			-1,
+			1,
+			1
+		],
+		[
+			-1,
+			1,
+			2,
+			1
+		],
+		[
+			-1,
+			0,
+			3,
+			1
+		],
+		[
+			-1,
+			-1,
+			4,
+			1
+		]
+	];
+	const table = new Array(9).fill(0);
+	for (const [horizontal, vertical, offset, xorBit] of rows) table[(horizontal + 1) * 3 + (vertical + 1)] = offset | xorBit << 3;
+	return table;
+})();
+const SIGN_XOR_FLAG = 8;
+function decodeJpeg2000CodeBlock(options) {
+	const { width, height, subband, zeroBitPlanes, maxBitPlanes, totalPasses, codeBlockStyle, data } = options;
+	throwForUnsupportedStyle(codeBlockStyle);
+	const values = new Int32Array(Math.max(width * height, 0));
+	const codedBitPlanes = maxBitPlanes - zeroBitPlanes;
+	if (width <= 0 || height <= 0 || codedBitPlanes <= 0 || totalPasses <= 0 || data.length === 0) return { values };
+	const stride = width + 2;
+	const cellCount = stride * (height + 2);
+	const significant = new Uint8Array(cellCount);
+	const negative = new Uint8Array(cellCount);
+	const codedThisPlane = new Uint8Array(cellCount);
+	const everRefined = new Uint8Array(cellCount);
+	const magnitude = new Int32Array(cellCount);
+	const lastCodedPlane = new Int32Array(cellCount);
+	const contexts = require_image_jbig2_arith.createArithContexts(CONTEXT_COUNT_BITS);
+	const resetContexts = () => {
+		contexts.fill(0);
+		contexts[0] = 8;
+		contexts[RUN_LENGTH_CONTEXT] = 6;
+		contexts[UNIFORM_CONTEXT] = 92;
+	};
+	resetContexts();
+	const mq = new require_image_jbig2_arith.MqDecoder(data, 0, data.length);
+	const verticallyCausal = (codeBlockStyle & STYLE_VERTICALLY_CAUSAL) !== 0;
+	const segmentationSymbols = (codeBlockStyle & STYLE_SEGMENTATION_SYMBOLS) !== 0;
+	const resetEachPass = (codeBlockStyle & STYLE_RESET_CONTEXTS) !== 0;
+	const at = (x, y) => (y + 1) * stride + (x + 1);
+	const belowVisible = (y, stripeEnd) => !verticallyCausal || y + 1 < stripeEnd;
+	const significanceContext = (x, y, stripeEnd) => {
+		const n = at(x, y);
+		const below = belowVisible(y, stripeEnd);
+		const horizontal = (significant[n - 1] ?? 0) + (significant[n + 1] ?? 0);
+		const vertical = (significant[n - stride] ?? 0) + (below ? significant[n + stride] ?? 0 : 0);
+		const diagonal = (significant[n - stride - 1] ?? 0) + (significant[n - stride + 1] ?? 0) + (below ? (significant[n + stride - 1] ?? 0) + (significant[n + stride + 1] ?? 0) : 0);
+		return zeroCodingContext(subband, horizontal, vertical, diagonal);
+	};
+	const neighbourhoodIsSignificant = (x, y, stripeEnd) => {
+		const n = at(x, y);
+		const below = belowVisible(y, stripeEnd);
+		return (significant[n - 1] ?? 0) + (significant[n + 1] ?? 0) + (significant[n - stride] ?? 0) + (below ? significant[n + stride] ?? 0 : 0) + ((significant[n - stride - 1] ?? 0) + (significant[n - stride + 1] ?? 0) + (below ? (significant[n + stride - 1] ?? 0) + (significant[n + stride + 1] ?? 0) : 0)) > 0;
+	};
+	const contribution = (cell) => (significant[cell] ?? 0) === 0 ? 0 : (negative[cell] ?? 0) === 1 ? -1 : 1;
+	const clampToUnit = (value) => value > 0 ? 1 : value < 0 ? -1 : 0;
+	const decodeSign = (x, y, stripeEnd) => {
+		const n = at(x, y);
+		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 decision = mq.decode(contexts, SIGN_CONTEXT_BASE + (packed & -9));
+		negative[n] = decision ^ ((packed & SIGN_XOR_FLAG) !== 0 ? 1 : 0);
+	};
+	const becomeSignificant = (x, y, plane, stripeEnd) => {
+		const n = at(x, y);
+		significant[n] = 1;
+		magnitude[n] = 1 << plane;
+		lastCodedPlane[n] = plane;
+		decodeSign(x, y, stripeEnd);
+	};
+	const significancePass = (plane) => {
+		for (let stripe = 0; stripe < height; stripe += STRIPE_HEIGHT) {
+			const stripeEnd = Math.min(stripe + STRIPE_HEIGHT, height);
+			for (let x = 0; x < width; x++) for (let y = stripe; y < stripeEnd; y++) {
+				const n = at(x, y);
+				if ((significant[n] ?? 0) === 1) continue;
+				const context = significanceContext(x, y, stripeEnd);
+				if (context === 0) continue;
+				if (mq.decode(contexts, context) === 1) becomeSignificant(x, y, plane, stripeEnd);
+				else lastCodedPlane[n] = plane;
+				codedThisPlane[n] = 1;
+			}
+		}
+	};
+	const refinementPass = (plane) => {
+		for (let stripe = 0; stripe < height; stripe += STRIPE_HEIGHT) {
+			const stripeEnd = Math.min(stripe + STRIPE_HEIGHT, height);
+			for (let x = 0; x < width; x++) for (let y = stripe; y < stripeEnd; y++) {
+				const n = at(x, y);
+				if ((significant[n] ?? 0) === 0 || (codedThisPlane[n] ?? 0) === 1) continue;
+				const context = (everRefined[n] ?? 0) === 1 ? MAGNITUDE_REFINEMENT_SUBSEQUENT : neighbourhoodIsSignificant(x, y, stripeEnd) ? MAGNITUDE_REFINEMENT_WITH_NEIGHBOURS : MAGNITUDE_REFINEMENT_NO_NEIGHBOURS;
+				if (mq.decode(contexts, context) === 1) magnitude[n] = (magnitude[n] ?? 0) | 1 << plane;
+				everRefined[n] = 1;
+				lastCodedPlane[n] = plane;
+			}
+		}
+	};
+	const cleanupPass = (plane) => {
+		for (let stripe = 0; stripe < height; stripe += STRIPE_HEIGHT) {
+			const stripeEnd = Math.min(stripe + STRIPE_HEIGHT, height);
+			const fullStripe = stripeEnd - stripe === STRIPE_HEIGHT;
+			for (let x = 0; x < width; x++) {
+				let y = stripe;
+				if (fullStripe && columnIsRunLengthEligible(x, stripe, stripeEnd)) {
+					if (mq.decode(contexts, RUN_LENGTH_CONTEXT) === 0) {
+						for (let row = stripe; row < stripeEnd; row++) lastCodedPlane[at(x, row)] = plane;
+						continue;
+					}
+					const firstSignificant = mq.decode(contexts, UNIFORM_CONTEXT) << 1 | mq.decode(contexts, UNIFORM_CONTEXT);
+					for (let row = stripe; row < stripe + firstSignificant; row++) lastCodedPlane[at(x, row)] = plane;
+					y = stripe + firstSignificant;
+					becomeSignificant(x, y, plane, stripeEnd);
+					y++;
+				}
+				for (; y < stripeEnd; y++) {
+					const n = at(x, y);
+					if ((codedThisPlane[n] ?? 0) === 1 || (significant[n] ?? 0) === 1) continue;
+					if (mq.decode(contexts, significanceContext(x, y, stripeEnd)) === 1) becomeSignificant(x, y, plane, stripeEnd);
+					else lastCodedPlane[n] = plane;
+				}
+			}
+		}
+		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 require_image_jpeg2000_errors.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`);
+		}
+		codedThisPlane.fill(0);
+	};
+	function columnIsRunLengthEligible(x, stripe, stripeEnd) {
+		for (let y = stripe; y < stripeEnd; y++) {
+			const n = at(x, y);
+			if ((significant[n] ?? 0) === 1 || (codedThisPlane[n] ?? 0) === 1) return false;
+			if (significanceContext(x, y, stripeEnd) !== 0) return false;
+		}
+		return true;
+	}
+	let plane = codedBitPlanes - 1;
+	let passType = PASS_CLEANUP;
+	for (let pass = 0; pass < totalPasses && plane >= 0; pass++) {
+		if (resetEachPass) resetContexts();
+		if (passType === PASS_SIGNIFICANCE) significancePass(plane);
+		else if (passType === PASS_REFINEMENT) refinementPass(plane);
+		else cleanupPass(plane);
+		passType++;
+		if (passType > PASS_CLEANUP) {
+			passType = PASS_SIGNIFICANCE;
+			plane--;
+		}
+	}
+	for (let y = 0; y < height; y++) for (let x = 0; x < width; x++) {
+		const n = at(x, y);
+		if ((significant[n] ?? 0) === 0) continue;
+		const reconstructed = 2 * (magnitude[n] ?? 0) + (1 << (lastCodedPlane[n] ?? 0));
+		values[y * width + x] = (negative[n] ?? 0) === 1 ? -reconstructed : reconstructed;
+	}
+	return { values };
+}
+//#endregion
+exports.decodeJpeg2000CodeBlock = decodeJpeg2000CodeBlock;

package/dist/image/jpeg2000-t1.d.cts

@@ -0,0 +1,18 @@
+//#region src/image/jpeg2000-t1.d.ts
+type Jpeg2000SubbandType = 'LL' | 'HL' | 'LH' | 'HH';
+interface Jpeg2000CodeBlockDecodeOptions {
+  readonly width: number;
+  readonly height: number;
+  readonly subband: Jpeg2000SubbandType;
+  readonly zeroBitPlanes: number;
+  readonly maxBitPlanes: number;
+  readonly totalPasses: number;
+  readonly codeBlockStyle: number;
+  readonly data: Uint8Array<ArrayBuffer>;
+}
+interface Jpeg2000CodeBlockResult {
+  readonly values: Int32Array;
+}
+declare function decodeJpeg2000CodeBlock(options: Jpeg2000CodeBlockDecodeOptions): Jpeg2000CodeBlockResult;
+//#endregion
+export { Jpeg2000CodeBlockDecodeOptions, Jpeg2000CodeBlockResult, Jpeg2000SubbandType, decodeJpeg2000CodeBlock };

package/dist/image/jpeg2000-t1.d.ts

@@ -0,0 +1,18 @@
+//#region src/image/jpeg2000-t1.d.ts
+type Jpeg2000SubbandType = 'LL' | 'HL' | 'LH' | 'HH';
+interface Jpeg2000CodeBlockDecodeOptions {
+  readonly width: number;
+  readonly height: number;
+  readonly subband: Jpeg2000SubbandType;
+  readonly zeroBitPlanes: number;
+  readonly maxBitPlanes: number;
+  readonly totalPasses: number;
+  readonly codeBlockStyle: number;
+  readonly data: Uint8Array<ArrayBuffer>;
+}
+interface Jpeg2000CodeBlockResult {
+  readonly values: Int32Array;
+}
+declare function decodeJpeg2000CodeBlock(options: Jpeg2000CodeBlockDecodeOptions): Jpeg2000CodeBlockResult;
+//#endregion
+export { Jpeg2000CodeBlockDecodeOptions, Jpeg2000CodeBlockResult, Jpeg2000SubbandType, decodeJpeg2000CodeBlock };

package/dist/image/jpeg2000-t1.js

@@ -0,0 +1,253 @@
+import { MqDecoder, createArithContexts } from "./jbig2-arith.js";
+import { Jpeg2000ParseError, Jpeg2000UnsupportedError } from "./jpeg2000-errors.js";
+//#region src/image/jpeg2000-t1.ts
+const SIGN_CONTEXT_BASE = 9;
+const MAGNITUDE_REFINEMENT_NO_NEIGHBOURS = 14;
+const MAGNITUDE_REFINEMENT_WITH_NEIGHBOURS = 15;
+const MAGNITUDE_REFINEMENT_SUBSEQUENT = 16;
+const RUN_LENGTH_CONTEXT = 17;
+const UNIFORM_CONTEXT = 18;
+const CONTEXT_COUNT_BITS = 5;
+const STYLE_SELECTIVE_BYPASS = 1;
+const STYLE_RESET_CONTEXTS = 2;
+const STYLE_TERMINATE_ALL = 4;
+const STYLE_VERTICALLY_CAUSAL = 8;
+const STYLE_SEGMENTATION_SYMBOLS = 32;
+const SEGMENTATION_SYMBOL = 10;
+const STRIPE_HEIGHT = 4;
+const PASS_SIGNIFICANCE = 0;
+const PASS_REFINEMENT = 1;
+const PASS_CLEANUP = 2;
+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");
+}
+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;
+		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 === 1) {
+		if (secondary >= 1) return 7;
+		return diagonal >= 1 ? 6 : 5;
+	}
+	if (secondary === 2) return 4;
+	if (secondary === 1) return 3;
+	return diagonal >= 2 ? 2 : diagonal === 1 ? 1 : 0;
+}
+const SIGN_CONTEXT_TABLE = (() => {
+	const rows = [
+		[
+			1,
+			1,
+			4,
+			0
+		],
+		[
+			1,
+			0,
+			3,
+			0
+		],
+		[
+			1,
+			-1,
+			2,
+			0
+		],
+		[
+			0,
+			1,
+			1,
+			0
+		],
+		[
+			0,
+			0,
+			0,
+			0
+		],
+		[
+			0,
+			-1,
+			1,
+			1
+		],
+		[
+			-1,
+			1,
+			2,
+			1
+		],
+		[
+			-1,
+			0,
+			3,
+			1
+		],
+		[
+			-1,
+			-1,
+			4,
+			1
+		]
+	];
+	const table = new Array(9).fill(0);
+	for (const [horizontal, vertical, offset, xorBit] of rows) table[(horizontal + 1) * 3 + (vertical + 1)] = offset | xorBit << 3;
+	return table;
+})();
+const SIGN_XOR_FLAG = 8;
+function decodeJpeg2000CodeBlock(options) {
+	const { width, height, subband, zeroBitPlanes, maxBitPlanes, totalPasses, codeBlockStyle, data } = options;
+	throwForUnsupportedStyle(codeBlockStyle);
+	const values = new Int32Array(Math.max(width * height, 0));
+	const codedBitPlanes = maxBitPlanes - zeroBitPlanes;
+	if (width <= 0 || height <= 0 || codedBitPlanes <= 0 || totalPasses <= 0 || data.length === 0) return { values };
+	const stride = width + 2;
+	const cellCount = stride * (height + 2);
+	const significant = new Uint8Array(cellCount);
+	const negative = new Uint8Array(cellCount);
+	const codedThisPlane = new Uint8Array(cellCount);
+	const everRefined = new Uint8Array(cellCount);
+	const magnitude = new Int32Array(cellCount);
+	const lastCodedPlane = new Int32Array(cellCount);
+	const contexts = createArithContexts(CONTEXT_COUNT_BITS);
+	const resetContexts = () => {
+		contexts.fill(0);
+		contexts[0] = 8;
+		contexts[RUN_LENGTH_CONTEXT] = 6;
+		contexts[UNIFORM_CONTEXT] = 92;
+	};
+	resetContexts();
+	const mq = new MqDecoder(data, 0, data.length);
+	const verticallyCausal = (codeBlockStyle & STYLE_VERTICALLY_CAUSAL) !== 0;
+	const segmentationSymbols = (codeBlockStyle & STYLE_SEGMENTATION_SYMBOLS) !== 0;
+	const resetEachPass = (codeBlockStyle & STYLE_RESET_CONTEXTS) !== 0;
+	const at = (x, y) => (y + 1) * stride + (x + 1);
+	const belowVisible = (y, stripeEnd) => !verticallyCausal || y + 1 < stripeEnd;
+	const significanceContext = (x, y, stripeEnd) => {
+		const n = at(x, y);
+		const below = belowVisible(y, stripeEnd);
+		const horizontal = (significant[n - 1] ?? 0) + (significant[n + 1] ?? 0);
+		const vertical = (significant[n - stride] ?? 0) + (below ? significant[n + stride] ?? 0 : 0);
+		const diagonal = (significant[n - stride - 1] ?? 0) + (significant[n - stride + 1] ?? 0) + (below ? (significant[n + stride - 1] ?? 0) + (significant[n + stride + 1] ?? 0) : 0);
+		return zeroCodingContext(subband, horizontal, vertical, diagonal);
+	};
+	const neighbourhoodIsSignificant = (x, y, stripeEnd) => {
+		const n = at(x, y);
+		const below = belowVisible(y, stripeEnd);
+		return (significant[n - 1] ?? 0) + (significant[n + 1] ?? 0) + (significant[n - stride] ?? 0) + (below ? significant[n + stride] ?? 0 : 0) + ((significant[n - stride - 1] ?? 0) + (significant[n - stride + 1] ?? 0) + (below ? (significant[n + stride - 1] ?? 0) + (significant[n + stride + 1] ?? 0) : 0)) > 0;
+	};
+	const contribution = (cell) => (significant[cell] ?? 0) === 0 ? 0 : (negative[cell] ?? 0) === 1 ? -1 : 1;
+	const clampToUnit = (value) => value > 0 ? 1 : value < 0 ? -1 : 0;
+	const decodeSign = (x, y, stripeEnd) => {
+		const n = at(x, y);
+		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 decision = mq.decode(contexts, SIGN_CONTEXT_BASE + (packed & -9));
+		negative[n] = decision ^ ((packed & SIGN_XOR_FLAG) !== 0 ? 1 : 0);
+	};
+	const becomeSignificant = (x, y, plane, stripeEnd) => {
+		const n = at(x, y);
+		significant[n] = 1;
+		magnitude[n] = 1 << plane;
+		lastCodedPlane[n] = plane;
+		decodeSign(x, y, stripeEnd);
+	};
+	const significancePass = (plane) => {
+		for (let stripe = 0; stripe < height; stripe += STRIPE_HEIGHT) {
+			const stripeEnd = Math.min(stripe + STRIPE_HEIGHT, height);
+			for (let x = 0; x < width; x++) for (let y = stripe; y < stripeEnd; y++) {
+				const n = at(x, y);
+				if ((significant[n] ?? 0) === 1) continue;
+				const context = significanceContext(x, y, stripeEnd);
+				if (context === 0) continue;
+				if (mq.decode(contexts, context) === 1) becomeSignificant(x, y, plane, stripeEnd);
+				else lastCodedPlane[n] = plane;
+				codedThisPlane[n] = 1;
+			}
+		}
+	};
+	const refinementPass = (plane) => {
+		for (let stripe = 0; stripe < height; stripe += STRIPE_HEIGHT) {
+			const stripeEnd = Math.min(stripe + STRIPE_HEIGHT, height);
+			for (let x = 0; x < width; x++) for (let y = stripe; y < stripeEnd; y++) {
+				const n = at(x, y);
+				if ((significant[n] ?? 0) === 0 || (codedThisPlane[n] ?? 0) === 1) continue;
+				const context = (everRefined[n] ?? 0) === 1 ? MAGNITUDE_REFINEMENT_SUBSEQUENT : neighbourhoodIsSignificant(x, y, stripeEnd) ? MAGNITUDE_REFINEMENT_WITH_NEIGHBOURS : MAGNITUDE_REFINEMENT_NO_NEIGHBOURS;
+				if (mq.decode(contexts, context) === 1) magnitude[n] = (magnitude[n] ?? 0) | 1 << plane;
+				everRefined[n] = 1;
+				lastCodedPlane[n] = plane;
+			}
+		}
+	};
+	const cleanupPass = (plane) => {
+		for (let stripe = 0; stripe < height; stripe += STRIPE_HEIGHT) {
+			const stripeEnd = Math.min(stripe + STRIPE_HEIGHT, height);
+			const fullStripe = stripeEnd - stripe === STRIPE_HEIGHT;
+			for (let x = 0; x < width; x++) {
+				let y = stripe;
+				if (fullStripe && columnIsRunLengthEligible(x, stripe, stripeEnd)) {
+					if (mq.decode(contexts, RUN_LENGTH_CONTEXT) === 0) {
+						for (let row = stripe; row < stripeEnd; row++) lastCodedPlane[at(x, row)] = plane;
+						continue;
+					}
+					const firstSignificant = mq.decode(contexts, UNIFORM_CONTEXT) << 1 | mq.decode(contexts, UNIFORM_CONTEXT);
+					for (let row = stripe; row < stripe + firstSignificant; row++) lastCodedPlane[at(x, row)] = plane;
+					y = stripe + firstSignificant;
+					becomeSignificant(x, y, plane, stripeEnd);
+					y++;
+				}
+				for (; y < stripeEnd; y++) {
+					const n = at(x, y);
+					if ((codedThisPlane[n] ?? 0) === 1 || (significant[n] ?? 0) === 1) continue;
+					if (mq.decode(contexts, significanceContext(x, y, stripeEnd)) === 1) becomeSignificant(x, y, plane, stripeEnd);
+					else lastCodedPlane[n] = plane;
+				}
+			}
+		}
+		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`);
+		}
+		codedThisPlane.fill(0);
+	};
+	function columnIsRunLengthEligible(x, stripe, stripeEnd) {
+		for (let y = stripe; y < stripeEnd; y++) {
+			const n = at(x, y);
+			if ((significant[n] ?? 0) === 1 || (codedThisPlane[n] ?? 0) === 1) return false;
+			if (significanceContext(x, y, stripeEnd) !== 0) return false;
+		}
+		return true;
+	}
+	let plane = codedBitPlanes - 1;
+	let passType = PASS_CLEANUP;
+	for (let pass = 0; pass < totalPasses && plane >= 0; pass++) {
+		if (resetEachPass) resetContexts();
+		if (passType === PASS_SIGNIFICANCE) significancePass(plane);
+		else if (passType === PASS_REFINEMENT) refinementPass(plane);
+		else cleanupPass(plane);
+		passType++;
+		if (passType > PASS_CLEANUP) {
+			passType = PASS_SIGNIFICANCE;
+			plane--;
+		}
+	}
+	for (let y = 0; y < height; y++) for (let x = 0; x < width; x++) {
+		const n = at(x, y);
+		if ((significant[n] ?? 0) === 0) continue;
+		const reconstructed = 2 * (magnitude[n] ?? 0) + (1 << (lastCodedPlane[n] ?? 0));
+		values[y * width + x] = (negative[n] ?? 0) === 1 ? -reconstructed : reconstructed;
+	}
+	return { values };
+}
+//#endregion
+export { decodeJpeg2000CodeBlock };