pdf-codec 1.5.0 → 1.7.0

package/dist/image/jbig2.js

@@ -0,0 +1,332 @@
+import { decodeCcittFax } from "./ccitt.js";
+import { MqDecoder, createArithContexts } from "./jbig2-arith.js";
+import { Jbig2ParseError, Jbig2UnsupportedError } from "./jbig2-errors.js";
+import { combinationOperatorFromCode, combineBitmap, createBitmap, getPixel, packBitmapRows, unpackBitmapRows } from "./jbig2-bitmap.js";
+import { GENERIC_CONTEXT_BITS, NOMINAL_REFINEMENT_AT, REFINEMENT_CONTEXT_BITS, decodeGenericRegion, decodeRefinementRegion } from "./jbig2-generic.js";
+import { createTextArithContexts, decodeSymbolDictionary, decodeTextRegion, referenceCornerFromCode, symbolCodeLength } from "./jbig2-text.js";
+//#region src/image/jbig2.ts
+const SEGMENT_SYMBOL_DICTIONARY = 0;
+const SEGMENT_INTERMEDIATE_TEXT_REGION = 4;
+const SEGMENT_IMMEDIATE_TEXT_REGION = 6;
+const SEGMENT_IMMEDIATE_LOSSLESS_TEXT_REGION = 7;
+const SEGMENT_PATTERN_DICTIONARY = 16;
+const SEGMENT_INTERMEDIATE_HALFTONE_REGION = 20;
+const SEGMENT_IMMEDIATE_HALFTONE_REGION = 22;
+const SEGMENT_IMMEDIATE_LOSSLESS_HALFTONE_REGION = 23;
+const SEGMENT_INTERMEDIATE_GENERIC_REGION = 36;
+const SEGMENT_IMMEDIATE_GENERIC_REGION = 38;
+const SEGMENT_IMMEDIATE_LOSSLESS_GENERIC_REGION = 39;
+const SEGMENT_INTERMEDIATE_REFINEMENT_REGION = 40;
+const SEGMENT_IMMEDIATE_REFINEMENT_REGION = 42;
+const SEGMENT_IMMEDIATE_LOSSLESS_REFINEMENT_REGION = 43;
+const SEGMENT_PAGE_INFORMATION = 48;
+const SEGMENT_END_OF_PAGE = 49;
+const SEGMENT_END_OF_STRIPE = 50;
+const SEGMENT_END_OF_FILE = 51;
+const SEGMENT_PROFILES = 52;
+const SEGMENT_TABLES = 53;
+const SEGMENT_EXTENSION = 62;
+const UNKNOWN_DATA_LENGTH = 4294967295;
+const UNKNOWN_PAGE_HEIGHT = 4294967295;
+var ByteCursor = class {
+	data;
+	position;
+	constructor(data, start = 0) {
+		this.data = data;
+		this.position = start;
+	}
+	get remaining() {
+		return this.data.length - this.position;
+	}
+	uint8() {
+		const value = this.data[this.position];
+		if (value === void 0) throw new Jbig2ParseError("JBIG2 stream ended in the middle of a segment header");
+		this.position++;
+		return value;
+	}
+	uint16() {
+		return this.uint8() << 8 | this.uint8();
+	}
+	uint32() {
+		return (this.uint8() << 24 | this.uint8() << 16 | this.uint8() << 8 | this.uint8()) >>> 0;
+	}
+	int8() {
+		const value = this.uint8();
+		return value > 127 ? value - 256 : value;
+	}
+};
+function readSegmentHeader(cursor, dataLength) {
+	const number = cursor.uint32();
+	const flags = cursor.uint8();
+	const type = flags & 63;
+	const pageAssociationIsLong = (flags & 64) !== 0;
+	let referredCount = cursor.uint8() >> 5;
+	if (referredCount === 7) {
+		cursor.position -= 1;
+		referredCount = cursor.uint32() & 536870911;
+		cursor.position += Math.ceil((referredCount + 1) / 8);
+	}
+	const referredSize = number <= 256 ? 1 : number <= 65536 ? 2 : 4;
+	const referredTo = [];
+	for (let i = 0; i < referredCount; i++) referredTo.push(referredSize === 1 ? cursor.uint8() : referredSize === 2 ? cursor.uint16() : cursor.uint32());
+	const pageAssociation = pageAssociationIsLong ? cursor.uint32() : cursor.uint8();
+	const declaredLength = cursor.uint32();
+	if (declaredLength === UNKNOWN_DATA_LENGTH) throw new Jbig2UnsupportedError("JBIG2 segment declares an unknown data length (T.88 7.2.7), which this decoder does not scan for a terminator");
+	const dataStart = cursor.position;
+	const dataEnd = dataStart + declaredLength;
+	if (dataEnd > dataLength) throw new Jbig2ParseError(`JBIG2 segment ${String(number)} declares ${String(declaredLength)} bytes of data but only ${String(dataLength - dataStart)} remain`);
+	return {
+		number,
+		type,
+		referredTo,
+		pageAssociation,
+		dataStart,
+		dataEnd
+	};
+}
+function readRegionInfo(cursor) {
+	const width = cursor.uint32();
+	const height = cursor.uint32();
+	const x = cursor.uint32();
+	const y = cursor.uint32();
+	const flags = cursor.uint8();
+	const combinationOperator = combinationOperatorFromCode(flags & 7);
+	if (combinationOperator === void 0) throw new Jbig2ParseError(`JBIG2 region declares external combination operator ${String(flags & 7)}, outside the 0-4 range T.88 Table 12 defines`);
+	return {
+		width,
+		height,
+		x,
+		y,
+		combinationOperator
+	};
+}
+function readAtPixels(cursor, count) {
+	const at = [];
+	for (let i = 0; i < count; i++) at.push({
+		x: cursor.int8(),
+		y: cursor.int8()
+	});
+	return at;
+}
+var Jbig2Decoder = class {
+	options;
+	page;
+	exportedSymbols = /* @__PURE__ */ new Map();
+	constructor(options) {
+		this.options = options;
+	}
+	warn(message) {
+		this.options.onWarning?.(message);
+	}
+	run(data) {
+		const cursor = new ByteCursor(data);
+		while (cursor.remaining > 0) {
+			const header = readSegmentHeader(cursor, data.length);
+			this.handleSegment(header, data);
+			cursor.position = header.dataEnd;
+		}
+	}
+	handleSegment(header, data) {
+		const cursor = new ByteCursor(data, header.dataStart);
+		switch (header.type) {
+			case SEGMENT_PAGE_INFORMATION:
+				this.readPageInformation(cursor);
+				return;
+			case SEGMENT_SYMBOL_DICTIONARY:
+				this.exportedSymbols.set(header.number, this.readSymbolDictionary(header, cursor));
+				return;
+			case SEGMENT_IMMEDIATE_GENERIC_REGION:
+			case SEGMENT_IMMEDIATE_LOSSLESS_GENERIC_REGION:
+				this.readGenericRegion(cursor, header.dataEnd);
+				return;
+			case SEGMENT_IMMEDIATE_TEXT_REGION:
+			case SEGMENT_IMMEDIATE_LOSSLESS_TEXT_REGION:
+				this.readTextRegion(header, cursor);
+				return;
+			case SEGMENT_IMMEDIATE_REFINEMENT_REGION:
+			case SEGMENT_IMMEDIATE_LOSSLESS_REFINEMENT_REGION:
+				this.readRefinementRegion(cursor, header.dataEnd);
+				return;
+			case SEGMENT_END_OF_PAGE:
+			case SEGMENT_END_OF_STRIPE:
+			case SEGMENT_END_OF_FILE:
+			case SEGMENT_PROFILES:
+			case SEGMENT_EXTENSION: return;
+			case SEGMENT_INTERMEDIATE_GENERIC_REGION:
+			case SEGMENT_INTERMEDIATE_TEXT_REGION:
+			case SEGMENT_INTERMEDIATE_REFINEMENT_REGION:
+			case SEGMENT_INTERMEDIATE_HALFTONE_REGION: throw new Jbig2UnsupportedError(`JBIG2 segment ${String(header.number)} is an intermediate region (type ${String(header.type)}), which is retained in an auxiliary buffer rather than composed onto the page; auxiliary buffers are not implemented`);
+			case SEGMENT_PATTERN_DICTIONARY:
+			case SEGMENT_IMMEDIATE_HALFTONE_REGION:
+			case SEGMENT_IMMEDIATE_LOSSLESS_HALFTONE_REGION: throw new Jbig2UnsupportedError(`JBIG2 segment ${String(header.number)} is a halftone region or pattern dictionary (type ${String(header.type)}), which is not implemented`);
+			case SEGMENT_TABLES: throw new Jbig2UnsupportedError(`JBIG2 segment ${String(header.number)} is a custom Huffman table, which only the Huffman-coded region forms use; those are not implemented`);
+			default: throw new Jbig2UnsupportedError(`JBIG2 segment ${String(header.number)} has unrecognised type ${String(header.type)}`);
+		}
+	}
+	readPageInformation(cursor) {
+		const declaredWidth = cursor.uint32();
+		const declaredHeight = cursor.uint32();
+		cursor.uint32();
+		cursor.uint32();
+		const flags = cursor.uint8();
+		cursor.uint16();
+		const width = this.options.width ?? declaredWidth;
+		const declaredOrHintedHeight = declaredHeight === UNKNOWN_PAGE_HEIGHT ? this.options.height : this.options.height ?? declaredHeight;
+		if (declaredOrHintedHeight === void 0) throw new Jbig2UnsupportedError("JBIG2 page information declares an unknown height and the caller supplied none; a striped page with no known height is not resolvable from the page segments alone");
+		const defaultPixel = flags >> 2 & 1;
+		const defaultCombinationOperator = combinationOperatorFromCode(flags >> 3 & 3);
+		if (defaultCombinationOperator === void 0) throw new Jbig2ParseError("JBIG2 page information declares an unrecognised default combination operator");
+		this.page = {
+			bitmap: createBitmap(width, declaredOrHintedHeight, defaultPixel),
+			defaultCombinationOperator,
+			combinationOperatorOverridden: (flags & 64) !== 0
+		};
+	}
+	requirePage() {
+		if (this.page === void 0) throw new Jbig2ParseError("JBIG2 stream composed a region before any page information segment declared the page");
+		return this.page;
+	}
+	compose(region, bitmap) {
+		const page = this.requirePage();
+		combineBitmap(page.bitmap, bitmap, region.x, region.y, page.combinationOperatorOverridden ? region.combinationOperator : page.defaultCombinationOperator);
+	}
+	readGenericRegion(cursor, dataEnd) {
+		const region = readRegionInfo(cursor);
+		const flags = cursor.uint8();
+		const mmr = (flags & 1) !== 0;
+		const template = flags >> 1 & 3;
+		const tpgdon = (flags & 8) !== 0;
+		if ((flags & 16) !== 0) throw new Jbig2UnsupportedError("JBIG2 generic region sets EXTTEMPLATE, the twelve-adaptive-pixel template of T.88 Amendment 2, which is not implemented");
+		const at = mmr ? [] : readAtPixels(cursor, template === 0 ? 4 : 1);
+		const payload = cursor.position;
+		if (mmr) {
+			const fax = decodeCcittFax(cursor.data.subarray(payload, dataEnd), {
+				k: -1,
+				columns: region.width,
+				rows: region.height,
+				blackIs1: true,
+				onWarning: (message) => this.warn(message)
+			});
+			this.compose(region, unpackBitmapRows(fax.bytes, region.width, region.height));
+			return;
+		}
+		const mq = new MqDecoder(cursor.data, payload, dataEnd);
+		const contexts = createArithContexts(GENERIC_CONTEXT_BITS[template] ?? 16);
+		this.compose(region, decodeGenericRegion(region.width, region.height, {
+			template,
+			tpgdon,
+			at
+		}, mq, contexts));
+	}
+	readRefinementRegion(cursor, dataEnd) {
+		const region = readRegionInfo(cursor);
+		const flags = cursor.uint8();
+		const template = flags & 1;
+		const tpgron = (flags & 2) !== 0;
+		const at = template === 0 ? readAtPixels(cursor, 2) : [...NOMINAL_REFINEMENT_AT];
+		const page = this.requirePage();
+		const reference = createBitmap(region.width, region.height);
+		for (let y = 0; y < region.height; y++) for (let x = 0; x < region.width; x++) reference.data[y * region.width + x] = getPixel(page.bitmap, region.x + x, region.y + y);
+		const mq = new MqDecoder(cursor.data, cursor.position, dataEnd);
+		const contexts = createArithContexts(REFINEMENT_CONTEXT_BITS[template] ?? 13);
+		const refined = decodeRefinementRegion(region.width, region.height, {
+			template,
+			tpgron,
+			at,
+			reference,
+			dx: 0,
+			dy: 0
+		}, mq, contexts);
+		combineBitmap(page.bitmap, refined, region.x, region.y, region.combinationOperator);
+	}
+	readSymbolDictionary(header, cursor) {
+		const flags = cursor.uint16();
+		if ((flags & 1) !== 0) throw new Jbig2UnsupportedError("JBIG2 symbol dictionary is Huffman-coded (SDHUFF = 1); only the arithmetic form is implemented");
+		if ((flags & 256) !== 0 || (flags & 512) !== 0) throw new Jbig2UnsupportedError("JBIG2 symbol dictionary uses or retains a shared bitmap coding context (T.88 7.4.3.1.1 bits 8-9), which is not implemented");
+		const refinementAggregate = (flags & 2) !== 0;
+		const template = flags >> 10 & 3;
+		const refinementTemplate = flags >> 12 & 1;
+		const at = readAtPixels(cursor, template === 0 ? 4 : 1);
+		const refinementAt = refinementAggregate && refinementTemplate === 0 ? readAtPixels(cursor, 2) : [...NOMINAL_REFINEMENT_AT];
+		const exportedSymbolCount = cursor.uint32();
+		const newSymbolCount = cursor.uint32();
+		const inputSymbols = this.gatherSymbols(header.referredTo);
+		const symbolIdBits = symbolCodeLength(inputSymbols.length + newSymbolCount);
+		const mq = new MqDecoder(cursor.data, cursor.position, header.dataEnd);
+		const contexts = createTextArithContexts(template, refinementTemplate, symbolIdBits);
+		return decodeSymbolDictionary({
+			template,
+			at,
+			refinementAggregate,
+			refinementTemplate,
+			refinementAt,
+			newSymbolCount,
+			exportedSymbolCount,
+			inputSymbols
+		}, mq, contexts, symbolIdBits);
+	}
+	readTextRegion(header, cursor) {
+		const region = readRegionInfo(cursor);
+		const flags = cursor.uint16();
+		if ((flags & 1) !== 0) throw new Jbig2UnsupportedError("JBIG2 text region is Huffman-coded (SBHUFF = 1); only the arithmetic form is implemented");
+		const refine = (flags & 2) !== 0;
+		const stripSize = 1 << (flags >> 2 & 3);
+		const referenceCorner = referenceCornerFromCode(flags >> 4 & 3);
+		if (referenceCorner === void 0) throw new Jbig2ParseError("JBIG2 text region declares an unrecognised REFCORNER");
+		const transposed = (flags & 64) !== 0;
+		const combinationOperator = combinationOperatorFromCode(flags >> 7 & 3);
+		if (combinationOperator === void 0) throw new Jbig2ParseError("JBIG2 text region declares an unrecognised SBCOMBOP");
+		const defaultPixel = flags >> 9 & 1;
+		const dsOffset = flags << 17 >> 27 | 0;
+		const refinementTemplate = flags >> 15 & 1;
+		const refinementAt = refine && refinementTemplate === 0 ? readAtPixels(cursor, 2) : [...NOMINAL_REFINEMENT_AT];
+		const instanceCount = cursor.uint32();
+		const symbols = this.gatherSymbols(header.referredTo);
+		if (symbols.length === 0) throw new Jbig2ParseError("JBIG2 text region refers to no symbol dictionary, so it has no symbols to place");
+		const symbolIdBits = symbolCodeLength(symbols.length);
+		const mq = new MqDecoder(cursor.data, cursor.position, header.dataEnd);
+		const contexts = createTextArithContexts(0, refinementTemplate, symbolIdBits);
+		const params = {
+			width: region.width,
+			height: region.height,
+			instanceCount,
+			stripSize,
+			symbols,
+			defaultPixel,
+			combinationOperator,
+			transposed,
+			referenceCorner,
+			dsOffset,
+			refine,
+			refinementTemplate,
+			refinementAt
+		};
+		this.compose(region, decodeTextRegion(params, mq, contexts, symbolIdBits));
+	}
+	gatherSymbols(referredTo) {
+		const symbols = [];
+		for (const segmentNumber of referredTo) {
+			const exported = this.exportedSymbols.get(segmentNumber);
+			if (exported !== void 0) symbols.push(...exported);
+		}
+		return symbols;
+	}
+	finish() {
+		const page = this.requirePage();
+		const width = this.options.width ?? page.bitmap.width;
+		const height = this.options.height ?? page.bitmap.height;
+		return {
+			bytes: packBitmapRows(page.bitmap, width, height),
+			width,
+			height
+		};
+	}
+};
+function decodeJbig2Embedded(data, options = {}) {
+	const decoder = new Jbig2Decoder(options);
+	if (options.globals !== void 0) decoder.run(options.globals);
+	decoder.run(data);
+	return decoder.finish();
+}
+//#endregion
+export { decodeJbig2Embedded };

package/dist/image/jp2-boxes.cjs

@@ -0,0 +1,148 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_image_jpeg2000_errors = require("./jpeg2000-errors.cjs");
+//#region src/image/jp2-boxes.ts
+const BOX_HEADER_BYTES = 8;
+const BOX_LENGTH_EXTENDED = 1;
+const BOX_LENGTH_TO_END = 0;
+const BOX_SIGNATURE = 1783636e3;
+const BOX_JP2_HEADER = 1785737832;
+const BOX_IMAGE_HEADER = 1768449138;
+const BOX_COLOUR_SPECIFICATION = 1668246642;
+const BOX_PALETTE = 1885564018;
+const BOX_COMPONENT_MAPPING = 1668112752;
+const BOX_CHANNEL_DEFINITION = 1667523942;
+const BOX_CONTIGUOUS_CODESTREAM = 1785737827;
+const ENUMERATED_COLOUR_SPACES = /* @__PURE__ */ new Map([
+	[12, "cmyk"],
+	[14, "cielab"],
+	[16, "srgb"],
+	[17, "greyscale"],
+	[18, "sycc"],
+	[20, "e-srgb"],
+	[24, "rommrgb"]
+]);
+function looksLikeBareCodestream(data) {
+	return data.length >= 4 && data[0] === 255 && data[1] === 79 && data[2] === 255 && data[3] === 81;
+}
+function readUint32(data, offset) {
+	const b0 = data[offset];
+	const b1 = data[offset + 1];
+	const b2 = data[offset + 2];
+	const b3 = data[offset + 3];
+	if (b0 === void 0 || b1 === void 0 || b2 === void 0 || b3 === void 0) throw new require_image_jpeg2000_errors.Jpeg2000ParseError("JP2 box structure ended in the middle of a 32-bit field");
+	return b0 * 16777216 + (b1 << 16) + (b2 << 8) + b3;
+}
+function readBox(data, offset, limit) {
+	if (offset + BOX_HEADER_BYTES > limit) return;
+	const declaredLength = readUint32(data, offset);
+	const type = readUint32(data, offset + 4);
+	let payloadStart = offset + BOX_HEADER_BYTES;
+	let boxEnd;
+	if (declaredLength === BOX_LENGTH_EXTENDED) {
+		const high = readUint32(data, payloadStart);
+		const low = readUint32(data, payloadStart + 4);
+		payloadStart += 8;
+		boxEnd = high === 0 ? offset + low : limit;
+	} else if (declaredLength === BOX_LENGTH_TO_END) boxEnd = limit;
+	else boxEnd = offset + declaredLength;
+	if (boxEnd < payloadStart) throw new require_image_jpeg2000_errors.Jpeg2000ParseError(`a JP2 box declares a length (${String(declaredLength)}) shorter than its own header`);
+	return {
+		type,
+		payloadStart,
+		payloadEnd: Math.min(boxEnd, limit),
+		nextBoxStart: Math.min(boxEnd, limit)
+	};
+}
+function readImageHeader(data, start, end) {
+	if (end - start < 14) throw new require_image_jpeg2000_errors.Jpeg2000ParseError("the JP2 image header box is shorter than the 14 bytes ISO/IEC 15444-1 I.5.3.1 defines");
+	const height = readUint32(data, start);
+	const width = readUint32(data, start + 4);
+	const componentCount = (data[start + 8] ?? 0) << 8 | (data[start + 9] ?? 0);
+	const bpc = data[start + 10] ?? 0;
+	if (bpc === 255) return {
+		width,
+		height,
+		componentCount
+	};
+	return {
+		width,
+		height,
+		componentCount,
+		bitDepth: (bpc & 127) + 1,
+		signed: (bpc & 128) !== 0
+	};
+}
+function readChannelDefinitions(data, start, end) {
+	if (end - start < 2) return [];
+	const count = (data[start] ?? 0) << 8 | (data[start + 1] ?? 0);
+	const definitions = [];
+	for (let i = 0; i < count; i++) {
+		const entry = start + 2 + i * 6;
+		if (entry + 6 > end) break;
+		definitions.push({
+			channel: (data[entry] ?? 0) << 8 | (data[entry + 1] ?? 0),
+			type: (data[entry + 2] ?? 0) << 8 | (data[entry + 3] ?? 0),
+			association: (data[entry + 4] ?? 0) << 8 | (data[entry + 5] ?? 0)
+		});
+	}
+	return definitions;
+}
+function readJp2HeaderBox(data, start, end, into) {
+	let offset = start;
+	for (;;) {
+		const box = readBox(data, offset, end);
+		if (box === void 0 || box.nextBoxStart <= offset) return;
+		if (box.type === BOX_IMAGE_HEADER) into.imageHeader = readImageHeader(data, box.payloadStart, box.payloadEnd);
+		else if (box.type === BOX_COLOUR_SPECIFICATION && into.colourSpace === void 0 && into.iccProfile === void 0) readColourSpecification(data, box.payloadStart, box.payloadEnd, into);
+		else if (box.type === BOX_PALETTE || box.type === BOX_COMPONENT_MAPPING) into.hasPalette = true;
+		else if (box.type === BOX_CHANNEL_DEFINITION) into.channelDefinitions = readChannelDefinitions(data, box.payloadStart, box.payloadEnd);
+		offset = box.nextBoxStart;
+	}
+}
+function readColourSpecification(data, start, end, into) {
+	if (end - start < 3) return;
+	const method = data[start] ?? 0;
+	if (method === 1) {
+		if (end - start >= 7) into.colourSpace = ENUMERATED_COLOUR_SPACES.get(readUint32(data, start + 3));
+		return;
+	}
+	if (method === 2 && end - start > 3) into.iccProfile = data.subarray(start + 3, end);
+}
+function parseJp2Container(data) {
+	if (looksLikeBareCodestream(data)) return {
+		codestream: data,
+		hasBoxes: false,
+		channelDefinitions: []
+	};
+	const contents = {
+		hasPalette: false,
+		channelDefinitions: []
+	};
+	let codestream;
+	let offset = 0;
+	let sawSignature = false;
+	for (;;) {
+		const box = readBox(data, offset, data.length);
+		if (box === void 0 || box.nextBoxStart <= offset) break;
+		if (box.type === BOX_SIGNATURE) sawSignature = true;
+		else if (box.type === BOX_JP2_HEADER) readJp2HeaderBox(data, box.payloadStart, box.payloadEnd, contents);
+		else if (box.type === BOX_CONTIGUOUS_CODESTREAM && codestream === void 0) codestream = data.subarray(box.payloadStart, box.payloadEnd);
+		offset = box.nextBoxStart;
+	}
+	if (codestream === void 0) {
+		if (!sawSignature && data[0] !== 0) throw new require_image_jpeg2000_errors.Jpeg2000ParseError("the data is neither a bare JPEG 2000 codestream nor a JP2 file (no SOC marker and no JP2 signature box)");
+		throw new require_image_jpeg2000_errors.Jpeg2000ParseError("the JP2 file carries no contiguous codestream (jp2c) box");
+	}
+	if (contents.hasPalette) throw new require_image_jpeg2000_errors.Jpeg2000UnsupportedError("the JP2 file carries a palette (pclr/cmap) box, which this decoder does not apply");
+	return {
+		codestream,
+		hasBoxes: true,
+		channelDefinitions: contents.channelDefinitions,
+		...contents.imageHeader !== void 0 ? { imageHeader: contents.imageHeader } : {},
+		...contents.colourSpace !== void 0 ? { colourSpace: contents.colourSpace } : {},
+		...contents.iccProfile !== void 0 ? { iccProfile: contents.iccProfile } : {}
+	};
+}
+//#endregion
+exports.looksLikeBareCodestream = looksLikeBareCodestream;
+exports.parseJp2Container = parseJp2Container;

package/dist/image/jp2-boxes.d.cts

@@ -0,0 +1,26 @@
+//#region src/image/jp2-boxes.d.ts
+type Jp2ColourSpace = 'greyscale' | 'srgb' | 'sycc' | 'cmyk' | 'e-srgb' | 'rommrgb' | 'cielab';
+interface Jp2ImageHeader {
+  readonly width: number;
+  readonly height: number;
+  readonly componentCount: number;
+  readonly bitDepth?: number;
+  readonly signed?: boolean;
+}
+interface Jp2Container {
+  readonly codestream: Uint8Array<ArrayBuffer>;
+  readonly hasBoxes: boolean;
+  readonly imageHeader?: Jp2ImageHeader;
+  readonly colourSpace?: Jp2ColourSpace;
+  readonly iccProfile?: Uint8Array<ArrayBuffer>;
+  readonly channelDefinitions: readonly Jp2ChannelDefinition[];
+}
+interface Jp2ChannelDefinition {
+  readonly channel: number;
+  readonly type: number;
+  readonly association: number;
+}
+declare function looksLikeBareCodestream(data: Uint8Array<ArrayBuffer>): boolean;
+declare function parseJp2Container(data: Uint8Array<ArrayBuffer>): Jp2Container;
+//#endregion
+export { Jp2ChannelDefinition, Jp2ColourSpace, Jp2Container, Jp2ImageHeader, looksLikeBareCodestream, parseJp2Container };

package/dist/image/jp2-boxes.d.ts

@@ -0,0 +1,26 @@
+//#region src/image/jp2-boxes.d.ts
+type Jp2ColourSpace = 'greyscale' | 'srgb' | 'sycc' | 'cmyk' | 'e-srgb' | 'rommrgb' | 'cielab';
+interface Jp2ImageHeader {
+  readonly width: number;
+  readonly height: number;
+  readonly componentCount: number;
+  readonly bitDepth?: number;
+  readonly signed?: boolean;
+}
+interface Jp2Container {
+  readonly codestream: Uint8Array<ArrayBuffer>;
+  readonly hasBoxes: boolean;
+  readonly imageHeader?: Jp2ImageHeader;
+  readonly colourSpace?: Jp2ColourSpace;
+  readonly iccProfile?: Uint8Array<ArrayBuffer>;
+  readonly channelDefinitions: readonly Jp2ChannelDefinition[];
+}
+interface Jp2ChannelDefinition {
+  readonly channel: number;
+  readonly type: number;
+  readonly association: number;
+}
+declare function looksLikeBareCodestream(data: Uint8Array<ArrayBuffer>): boolean;
+declare function parseJp2Container(data: Uint8Array<ArrayBuffer>): Jp2Container;
+//#endregion
+export { Jp2ChannelDefinition, Jp2ColourSpace, Jp2Container, Jp2ImageHeader, looksLikeBareCodestream, parseJp2Container };

package/dist/image/jp2-boxes.js

@@ -0,0 +1,146 @@
+import { Jpeg2000ParseError, Jpeg2000UnsupportedError } from "./jpeg2000-errors.js";
+//#region src/image/jp2-boxes.ts
+const BOX_HEADER_BYTES = 8;
+const BOX_LENGTH_EXTENDED = 1;
+const BOX_LENGTH_TO_END = 0;
+const BOX_SIGNATURE = 1783636e3;
+const BOX_JP2_HEADER = 1785737832;
+const BOX_IMAGE_HEADER = 1768449138;
+const BOX_COLOUR_SPECIFICATION = 1668246642;
+const BOX_PALETTE = 1885564018;
+const BOX_COMPONENT_MAPPING = 1668112752;
+const BOX_CHANNEL_DEFINITION = 1667523942;
+const BOX_CONTIGUOUS_CODESTREAM = 1785737827;
+const ENUMERATED_COLOUR_SPACES = /* @__PURE__ */ new Map([
+	[12, "cmyk"],
+	[14, "cielab"],
+	[16, "srgb"],
+	[17, "greyscale"],
+	[18, "sycc"],
+	[20, "e-srgb"],
+	[24, "rommrgb"]
+]);
+function looksLikeBareCodestream(data) {
+	return data.length >= 4 && data[0] === 255 && data[1] === 79 && data[2] === 255 && data[3] === 81;
+}
+function readUint32(data, offset) {
+	const b0 = data[offset];
+	const b1 = data[offset + 1];
+	const b2 = data[offset + 2];
+	const b3 = data[offset + 3];
+	if (b0 === void 0 || b1 === void 0 || b2 === void 0 || b3 === void 0) throw new Jpeg2000ParseError("JP2 box structure ended in the middle of a 32-bit field");
+	return b0 * 16777216 + (b1 << 16) + (b2 << 8) + b3;
+}
+function readBox(data, offset, limit) {
+	if (offset + BOX_HEADER_BYTES > limit) return;
+	const declaredLength = readUint32(data, offset);
+	const type = readUint32(data, offset + 4);
+	let payloadStart = offset + BOX_HEADER_BYTES;
+	let boxEnd;
+	if (declaredLength === BOX_LENGTH_EXTENDED) {
+		const high = readUint32(data, payloadStart);
+		const low = readUint32(data, payloadStart + 4);
+		payloadStart += 8;
+		boxEnd = high === 0 ? offset + low : limit;
+	} else if (declaredLength === BOX_LENGTH_TO_END) boxEnd = limit;
+	else boxEnd = offset + declaredLength;
+	if (boxEnd < payloadStart) throw new Jpeg2000ParseError(`a JP2 box declares a length (${String(declaredLength)}) shorter than its own header`);
+	return {
+		type,
+		payloadStart,
+		payloadEnd: Math.min(boxEnd, limit),
+		nextBoxStart: Math.min(boxEnd, limit)
+	};
+}
+function readImageHeader(data, start, end) {
+	if (end - start < 14) throw new Jpeg2000ParseError("the JP2 image header box is shorter than the 14 bytes ISO/IEC 15444-1 I.5.3.1 defines");
+	const height = readUint32(data, start);
+	const width = readUint32(data, start + 4);
+	const componentCount = (data[start + 8] ?? 0) << 8 | (data[start + 9] ?? 0);
+	const bpc = data[start + 10] ?? 0;
+	if (bpc === 255) return {
+		width,
+		height,
+		componentCount
+	};
+	return {
+		width,
+		height,
+		componentCount,
+		bitDepth: (bpc & 127) + 1,
+		signed: (bpc & 128) !== 0
+	};
+}
+function readChannelDefinitions(data, start, end) {
+	if (end - start < 2) return [];
+	const count = (data[start] ?? 0) << 8 | (data[start + 1] ?? 0);
+	const definitions = [];
+	for (let i = 0; i < count; i++) {
+		const entry = start + 2 + i * 6;
+		if (entry + 6 > end) break;
+		definitions.push({
+			channel: (data[entry] ?? 0) << 8 | (data[entry + 1] ?? 0),
+			type: (data[entry + 2] ?? 0) << 8 | (data[entry + 3] ?? 0),
+			association: (data[entry + 4] ?? 0) << 8 | (data[entry + 5] ?? 0)
+		});
+	}
+	return definitions;
+}
+function readJp2HeaderBox(data, start, end, into) {
+	let offset = start;
+	for (;;) {
+		const box = readBox(data, offset, end);
+		if (box === void 0 || box.nextBoxStart <= offset) return;
+		if (box.type === BOX_IMAGE_HEADER) into.imageHeader = readImageHeader(data, box.payloadStart, box.payloadEnd);
+		else if (box.type === BOX_COLOUR_SPECIFICATION && into.colourSpace === void 0 && into.iccProfile === void 0) readColourSpecification(data, box.payloadStart, box.payloadEnd, into);
+		else if (box.type === BOX_PALETTE || box.type === BOX_COMPONENT_MAPPING) into.hasPalette = true;
+		else if (box.type === BOX_CHANNEL_DEFINITION) into.channelDefinitions = readChannelDefinitions(data, box.payloadStart, box.payloadEnd);
+		offset = box.nextBoxStart;
+	}
+}
+function readColourSpecification(data, start, end, into) {
+	if (end - start < 3) return;
+	const method = data[start] ?? 0;
+	if (method === 1) {
+		if (end - start >= 7) into.colourSpace = ENUMERATED_COLOUR_SPACES.get(readUint32(data, start + 3));
+		return;
+	}
+	if (method === 2 && end - start > 3) into.iccProfile = data.subarray(start + 3, end);
+}
+function parseJp2Container(data) {
+	if (looksLikeBareCodestream(data)) return {
+		codestream: data,
+		hasBoxes: false,
+		channelDefinitions: []
+	};
+	const contents = {
+		hasPalette: false,
+		channelDefinitions: []
+	};
+	let codestream;
+	let offset = 0;
+	let sawSignature = false;
+	for (;;) {
+		const box = readBox(data, offset, data.length);
+		if (box === void 0 || box.nextBoxStart <= offset) break;
+		if (box.type === BOX_SIGNATURE) sawSignature = true;
+		else if (box.type === BOX_JP2_HEADER) readJp2HeaderBox(data, box.payloadStart, box.payloadEnd, contents);
+		else if (box.type === BOX_CONTIGUOUS_CODESTREAM && codestream === void 0) codestream = data.subarray(box.payloadStart, box.payloadEnd);
+		offset = box.nextBoxStart;
+	}
+	if (codestream === void 0) {
+		if (!sawSignature && data[0] !== 0) throw new Jpeg2000ParseError("the data is neither a bare JPEG 2000 codestream nor a JP2 file (no SOC marker and no JP2 signature box)");
+		throw new Jpeg2000ParseError("the JP2 file carries no contiguous codestream (jp2c) box");
+	}
+	if (contents.hasPalette) throw new Jpeg2000UnsupportedError("the JP2 file carries a palette (pclr/cmap) box, which this decoder does not apply");
+	return {
+		codestream,
+		hasBoxes: true,
+		channelDefinitions: contents.channelDefinitions,
+		...contents.imageHeader !== void 0 ? { imageHeader: contents.imageHeader } : {},
+		...contents.colourSpace !== void 0 ? { colourSpace: contents.colourSpace } : {},
+		...contents.iccProfile !== void 0 ? { iccProfile: contents.iccProfile } : {}
+	};
+}
+//#endregion
+export { looksLikeBareCodestream, parseJp2Container };