pdf-codec 1.3.0 → 1.4.0

package/dist/parse.cjs

@@ -0,0 +1,230 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_lexer = require("./lexer.cjs");
+const require_objects = require("./objects.cjs");
+//#region src/parse.ts
+function parseValue(reader, sink) {
+	const token = require_lexer.nextToken(reader);
+	if (token === void 0) return;
+	switch (token.kind) {
+		case "number": return parseNumberOrReference(reader, token.value);
+		case "name": return require_objects.pdfName(token.value);
+		case "literalString": return require_objects.pdfLiteralString(token.value);
+		case "hexString": return require_objects.pdfHexString(token.value);
+		case "arrayStart": return parseArrayBody(reader, sink);
+		case "dictStart": return parseDictOrStreamBody(reader, sink);
+		case "keyword": return parseKeywordValue(token.value, sink);
+		case "arrayEnd":
+		case "dictEnd":
+			sink({
+				code: "pdf/unexpected-delimiter",
+				severity: "warning",
+				message: `unexpected "${token.kind === "arrayEnd" ? "]" : ">>"}" where a value was expected`
+			});
+			return require_objects.pdfNull();
+	}
+}
+function parseKeywordValue(keyword, sink) {
+	if (keyword === "true") return require_objects.pdfBool(true);
+	if (keyword === "false") return require_objects.pdfBool(false);
+	if (keyword === "null") return require_objects.pdfNull();
+	sink({
+		code: "pdf/unexpected-keyword",
+		severity: "warning",
+		message: `unexpected keyword "${keyword}" where a value was expected`
+	});
+	return require_objects.pdfNull();
+}
+function parseNumberOrReference(reader, first) {
+	if (!Number.isInteger(first) || first < 0) return require_objects.pdfNum(first);
+	const mark = reader.mark();
+	const second = require_lexer.nextToken(reader);
+	if (second?.kind === "number" && Number.isInteger(second.value) && second.value >= 0) {
+		const third = require_lexer.nextToken(reader);
+		if (third?.kind === "keyword" && third.value === "R") return require_objects.pdfRef(first, second.value);
+	}
+	reader.reset(mark);
+	return require_objects.pdfNum(first);
+}
+function parseArrayBody(reader, sink) {
+	const items = [];
+	for (;;) {
+		const mark = reader.mark();
+		const token = require_lexer.nextToken(reader);
+		if (token === void 0) {
+			sink({
+				code: "pdf/unterminated-array",
+				severity: "warning",
+				message: "array not closed before end of input"
+			});
+			break;
+		}
+		if (token.kind === "arrayEnd") break;
+		reader.reset(mark);
+		const beforeOffset = reader.offset;
+		const value = parseValue(reader, sink);
+		if (value === void 0 || reader.offset === beforeOffset) break;
+		items.push(value);
+	}
+	return require_objects.pdfArray(items);
+}
+function parseDictOrStreamBody(reader, sink) {
+	const entries = /* @__PURE__ */ new Map();
+	for (;;) {
+		const token = require_lexer.nextToken(reader);
+		if (token === void 0) {
+			sink({
+				code: "pdf/unterminated-dict",
+				severity: "warning",
+				message: "dictionary not closed before end of input"
+			});
+			break;
+		}
+		if (token.kind === "dictEnd") break;
+		if (token.kind !== "name") {
+			sink({
+				code: "pdf/dict-key-not-name",
+				severity: "warning",
+				message: `expected a /Name dictionary key, found "${token.kind}"`
+			});
+			continue;
+		}
+		const value = parseValue(reader, sink);
+		if (value === void 0) {
+			sink({
+				code: "pdf/dict-missing-value",
+				severity: "warning",
+				message: `dictionary key "/${token.value}" has no value before end of input`
+			});
+			break;
+		}
+		entries.set(token.value, value);
+	}
+	const dict = require_objects.pdfDict(entries);
+	const afterDictMark = reader.mark();
+	const maybeStream = require_lexer.nextToken(reader);
+	if (maybeStream?.kind === "keyword" && maybeStream.value === "stream") return parseStreamBody(reader, sink, dict);
+	reader.reset(afterDictMark);
+	return dict;
+}
+function skipStreamDataStart(reader, sink) {
+	if (reader.peek() === 13) {
+		reader.next();
+		if (reader.peek() === 10) reader.next();
+		else sink({
+			code: "pdf/stream-bad-eol",
+			severity: "warning",
+			message: "stream keyword followed by a bare CR, not CRLF or LF as required"
+		});
+		return;
+	}
+	if (reader.peek() === 10) {
+		reader.next();
+		return;
+	}
+	sink({
+		code: "pdf/stream-bad-eol",
+		severity: "warning",
+		message: "stream keyword not followed by an end-of-line marker"
+	});
+}
+const ENDSTREAM_BYTES = new TextEncoder().encode("endstream");
+function parseStreamBody(reader, sink, dict) {
+	skipStreamDataStart(reader, sink);
+	const dataStart = reader.offset;
+	const lengthObj = require_objects.dictGet(dict, "Length");
+	let dataEnd = resolveDirectLength(reader, dataStart, lengthObj);
+	if (dataEnd === void 0) {
+		if (lengthObj !== void 0) sink({
+			code: "pdf/stream-length-invalid",
+			severity: "warning",
+			message: "stream /Length was missing, indirect, or did not land on \"endstream\"; falling back to a scan for \"endstream\""
+		});
+		const found = findEndstreamOffset(reader, dataStart);
+		if (found === void 0) {
+			sink({
+				code: "pdf/stream-unterminated",
+				severity: "warning",
+				message: "no \"endstream\" found before end of input; treating the remainder of the file as stream data"
+			});
+			dataEnd = reader.length;
+		} else dataEnd = trimTrailingStreamEol(reader, dataStart, found);
+	}
+	const raw = reader.slice(dataStart, dataEnd);
+	reader.seek(dataEnd);
+	reader.skipWhitespace();
+	const endTok = require_lexer.nextToken(reader);
+	if (endTok?.kind !== "keyword" || endTok.value !== "endstream") sink({
+		code: "pdf/missing-endstream",
+		severity: "warning",
+		message: "stream data was not followed by \"endstream\""
+	});
+	return require_objects.pdfStream(dict, raw);
+}
+function resolveDirectLength(reader, dataStart, lengthObj) {
+	if (lengthObj?.kind !== "number" || !Number.isInteger(lengthObj.value) || lengthObj.value < 0) return;
+	const candidateEnd = dataStart + lengthObj.value;
+	if (candidateEnd > reader.length || !looksLikeEndstreamAt(reader, candidateEnd)) return;
+	return candidateEnd;
+}
+function looksLikeEndstreamAt(reader, offset) {
+	const mark = reader.mark();
+	reader.seek(offset);
+	reader.skipWhitespace();
+	const matches = reader.matchKeyword("endstream");
+	reader.reset(mark);
+	return matches;
+}
+function findEndstreamOffset(reader, fromOffset) {
+	const haystack = reader.slice(fromOffset, reader.length);
+	outer: for (let i = 0; i <= haystack.length - ENDSTREAM_BYTES.length; i++) {
+		for (let j = 0; j < ENDSTREAM_BYTES.length; j++) if (haystack[i + j] !== ENDSTREAM_BYTES[j]) continue outer;
+		return fromOffset + i;
+	}
+}
+function trimTrailingStreamEol(reader, dataStart, endstreamOffset) {
+	const precedingTwo = reader.slice(Math.max(dataStart, endstreamOffset - 2), endstreamOffset);
+	if (precedingTwo.length >= 2 && precedingTwo[precedingTwo.length - 2] === 13 && precedingTwo[precedingTwo.length - 1] === 10) return endstreamOffset - 2;
+	if (precedingTwo.length >= 1 && (precedingTwo[precedingTwo.length - 1] === 10 || precedingTwo[precedingTwo.length - 1] === 13)) return endstreamOffset - 1;
+	return endstreamOffset;
+}
+function parseIndirectObject(reader, sink) {
+	const mark = reader.mark();
+	const numTok = require_lexer.nextToken(reader);
+	const genTok = require_lexer.nextToken(reader);
+	const objTok = require_lexer.nextToken(reader);
+	if (numTok?.kind !== "number" || genTok?.kind !== "number" || objTok?.kind !== "keyword" || objTok.value !== "obj") {
+		reader.reset(mark);
+		return;
+	}
+	const value = parseValue(reader, sink);
+	if (value === void 0) {
+		sink({
+			code: "pdf/object-missing-value",
+			severity: "warning",
+			message: `object ${String(numTok.value)} ${String(genTok.value)} has no value before end of input`
+		});
+		return {
+			num: numTok.value,
+			gen: genTok.value,
+			value: require_objects.pdfNull()
+		};
+	}
+	const endMark = reader.mark();
+	const endTok = require_lexer.nextToken(reader);
+	if (endTok?.kind !== "keyword" || endTok.value !== "endobj") {
+		sink({
+			code: "pdf/missing-endobj",
+			severity: "warning",
+			message: `object ${String(numTok.value)} ${String(genTok.value)} is missing its "endobj" keyword`
+		});
+		reader.reset(endMark);
+	}
+	return {
+		num: numTok.value,
+		gen: genTok.value,
+		value
+	};
+}
+//#endregion
+exports.parseIndirectObject = parseIndirectObject;
+exports.parseValue = parseValue;

package/dist/parse.d.cts

@@ -0,0 +1,13 @@
+import { ByteReader } from "./bytes/reader.cjs";
+import { PdfDiagnosticSink } from "./diagnostics.cjs";
+import { PdfObject } from "./objects.cjs";
+//#region src/parse.d.ts
+declare function parseValue(reader: ByteReader, sink: PdfDiagnosticSink): PdfObject | undefined;
+interface ParsedIndirectObject {
+  readonly num: number;
+  readonly gen: number;
+  readonly value: PdfObject;
+}
+declare function parseIndirectObject(reader: ByteReader, sink: PdfDiagnosticSink): ParsedIndirectObject | undefined;
+//#endregion
+export { ParsedIndirectObject, parseIndirectObject, parseValue };

package/dist/parse.d.ts

@@ -0,0 +1,13 @@
+import { ByteReader } from "./bytes/reader.js";
+import { PdfDiagnosticSink } from "./diagnostics.js";
+import { PdfObject } from "./objects.js";
+//#region src/parse.d.ts
+declare function parseValue(reader: ByteReader, sink: PdfDiagnosticSink): PdfObject | undefined;
+interface ParsedIndirectObject {
+  readonly num: number;
+  readonly gen: number;
+  readonly value: PdfObject;
+}
+declare function parseIndirectObject(reader: ByteReader, sink: PdfDiagnosticSink): ParsedIndirectObject | undefined;
+//#endregion
+export { ParsedIndirectObject, parseIndirectObject, parseValue };

package/dist/parse.js

@@ -0,0 +1,228 @@
+import { nextToken } from "./lexer.js";
+import { dictGet, pdfArray, pdfBool, pdfDict, pdfHexString, pdfLiteralString, pdfName, pdfNull, pdfNum, pdfRef, pdfStream } from "./objects.js";
+//#region src/parse.ts
+function parseValue(reader, sink) {
+	const token = nextToken(reader);
+	if (token === void 0) return;
+	switch (token.kind) {
+		case "number": return parseNumberOrReference(reader, token.value);
+		case "name": return pdfName(token.value);
+		case "literalString": return pdfLiteralString(token.value);
+		case "hexString": return pdfHexString(token.value);
+		case "arrayStart": return parseArrayBody(reader, sink);
+		case "dictStart": return parseDictOrStreamBody(reader, sink);
+		case "keyword": return parseKeywordValue(token.value, sink);
+		case "arrayEnd":
+		case "dictEnd":
+			sink({
+				code: "pdf/unexpected-delimiter",
+				severity: "warning",
+				message: `unexpected "${token.kind === "arrayEnd" ? "]" : ">>"}" where a value was expected`
+			});
+			return pdfNull();
+	}
+}
+function parseKeywordValue(keyword, sink) {
+	if (keyword === "true") return pdfBool(true);
+	if (keyword === "false") return pdfBool(false);
+	if (keyword === "null") return pdfNull();
+	sink({
+		code: "pdf/unexpected-keyword",
+		severity: "warning",
+		message: `unexpected keyword "${keyword}" where a value was expected`
+	});
+	return pdfNull();
+}
+function parseNumberOrReference(reader, first) {
+	if (!Number.isInteger(first) || first < 0) return pdfNum(first);
+	const mark = reader.mark();
+	const second = nextToken(reader);
+	if (second?.kind === "number" && Number.isInteger(second.value) && second.value >= 0) {
+		const third = nextToken(reader);
+		if (third?.kind === "keyword" && third.value === "R") return pdfRef(first, second.value);
+	}
+	reader.reset(mark);
+	return pdfNum(first);
+}
+function parseArrayBody(reader, sink) {
+	const items = [];
+	for (;;) {
+		const mark = reader.mark();
+		const token = nextToken(reader);
+		if (token === void 0) {
+			sink({
+				code: "pdf/unterminated-array",
+				severity: "warning",
+				message: "array not closed before end of input"
+			});
+			break;
+		}
+		if (token.kind === "arrayEnd") break;
+		reader.reset(mark);
+		const beforeOffset = reader.offset;
+		const value = parseValue(reader, sink);
+		if (value === void 0 || reader.offset === beforeOffset) break;
+		items.push(value);
+	}
+	return pdfArray(items);
+}
+function parseDictOrStreamBody(reader, sink) {
+	const entries = /* @__PURE__ */ new Map();
+	for (;;) {
+		const token = nextToken(reader);
+		if (token === void 0) {
+			sink({
+				code: "pdf/unterminated-dict",
+				severity: "warning",
+				message: "dictionary not closed before end of input"
+			});
+			break;
+		}
+		if (token.kind === "dictEnd") break;
+		if (token.kind !== "name") {
+			sink({
+				code: "pdf/dict-key-not-name",
+				severity: "warning",
+				message: `expected a /Name dictionary key, found "${token.kind}"`
+			});
+			continue;
+		}
+		const value = parseValue(reader, sink);
+		if (value === void 0) {
+			sink({
+				code: "pdf/dict-missing-value",
+				severity: "warning",
+				message: `dictionary key "/${token.value}" has no value before end of input`
+			});
+			break;
+		}
+		entries.set(token.value, value);
+	}
+	const dict = pdfDict(entries);
+	const afterDictMark = reader.mark();
+	const maybeStream = nextToken(reader);
+	if (maybeStream?.kind === "keyword" && maybeStream.value === "stream") return parseStreamBody(reader, sink, dict);
+	reader.reset(afterDictMark);
+	return dict;
+}
+function skipStreamDataStart(reader, sink) {
+	if (reader.peek() === 13) {
+		reader.next();
+		if (reader.peek() === 10) reader.next();
+		else sink({
+			code: "pdf/stream-bad-eol",
+			severity: "warning",
+			message: "stream keyword followed by a bare CR, not CRLF or LF as required"
+		});
+		return;
+	}
+	if (reader.peek() === 10) {
+		reader.next();
+		return;
+	}
+	sink({
+		code: "pdf/stream-bad-eol",
+		severity: "warning",
+		message: "stream keyword not followed by an end-of-line marker"
+	});
+}
+const ENDSTREAM_BYTES = new TextEncoder().encode("endstream");
+function parseStreamBody(reader, sink, dict) {
+	skipStreamDataStart(reader, sink);
+	const dataStart = reader.offset;
+	const lengthObj = dictGet(dict, "Length");
+	let dataEnd = resolveDirectLength(reader, dataStart, lengthObj);
+	if (dataEnd === void 0) {
+		if (lengthObj !== void 0) sink({
+			code: "pdf/stream-length-invalid",
+			severity: "warning",
+			message: "stream /Length was missing, indirect, or did not land on \"endstream\"; falling back to a scan for \"endstream\""
+		});
+		const found = findEndstreamOffset(reader, dataStart);
+		if (found === void 0) {
+			sink({
+				code: "pdf/stream-unterminated",
+				severity: "warning",
+				message: "no \"endstream\" found before end of input; treating the remainder of the file as stream data"
+			});
+			dataEnd = reader.length;
+		} else dataEnd = trimTrailingStreamEol(reader, dataStart, found);
+	}
+	const raw = reader.slice(dataStart, dataEnd);
+	reader.seek(dataEnd);
+	reader.skipWhitespace();
+	const endTok = nextToken(reader);
+	if (endTok?.kind !== "keyword" || endTok.value !== "endstream") sink({
+		code: "pdf/missing-endstream",
+		severity: "warning",
+		message: "stream data was not followed by \"endstream\""
+	});
+	return pdfStream(dict, raw);
+}
+function resolveDirectLength(reader, dataStart, lengthObj) {
+	if (lengthObj?.kind !== "number" || !Number.isInteger(lengthObj.value) || lengthObj.value < 0) return;
+	const candidateEnd = dataStart + lengthObj.value;
+	if (candidateEnd > reader.length || !looksLikeEndstreamAt(reader, candidateEnd)) return;
+	return candidateEnd;
+}
+function looksLikeEndstreamAt(reader, offset) {
+	const mark = reader.mark();
+	reader.seek(offset);
+	reader.skipWhitespace();
+	const matches = reader.matchKeyword("endstream");
+	reader.reset(mark);
+	return matches;
+}
+function findEndstreamOffset(reader, fromOffset) {
+	const haystack = reader.slice(fromOffset, reader.length);
+	outer: for (let i = 0; i <= haystack.length - ENDSTREAM_BYTES.length; i++) {
+		for (let j = 0; j < ENDSTREAM_BYTES.length; j++) if (haystack[i + j] !== ENDSTREAM_BYTES[j]) continue outer;
+		return fromOffset + i;
+	}
+}
+function trimTrailingStreamEol(reader, dataStart, endstreamOffset) {
+	const precedingTwo = reader.slice(Math.max(dataStart, endstreamOffset - 2), endstreamOffset);
+	if (precedingTwo.length >= 2 && precedingTwo[precedingTwo.length - 2] === 13 && precedingTwo[precedingTwo.length - 1] === 10) return endstreamOffset - 2;
+	if (precedingTwo.length >= 1 && (precedingTwo[precedingTwo.length - 1] === 10 || precedingTwo[precedingTwo.length - 1] === 13)) return endstreamOffset - 1;
+	return endstreamOffset;
+}
+function parseIndirectObject(reader, sink) {
+	const mark = reader.mark();
+	const numTok = nextToken(reader);
+	const genTok = nextToken(reader);
+	const objTok = nextToken(reader);
+	if (numTok?.kind !== "number" || genTok?.kind !== "number" || objTok?.kind !== "keyword" || objTok.value !== "obj") {
+		reader.reset(mark);
+		return;
+	}
+	const value = parseValue(reader, sink);
+	if (value === void 0) {
+		sink({
+			code: "pdf/object-missing-value",
+			severity: "warning",
+			message: `object ${String(numTok.value)} ${String(genTok.value)} has no value before end of input`
+		});
+		return {
+			num: numTok.value,
+			gen: genTok.value,
+			value: pdfNull()
+		};
+	}
+	const endMark = reader.mark();
+	const endTok = nextToken(reader);
+	if (endTok?.kind !== "keyword" || endTok.value !== "endobj") {
+		sink({
+			code: "pdf/missing-endobj",
+			severity: "warning",
+			message: `object ${String(numTok.value)} ${String(genTok.value)} is missing its "endobj" keyword`
+		});
+		reader.reset(endMark);
+	}
+	return {
+		num: numTok.value,
+		gen: genTok.value,
+		value
+	};
+}
+//#endregion
+export { parseIndirectObject, parseValue };

package/dist/predictors.cjs

@@ -0,0 +1,64 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_objects = require("./objects.cjs");
+const require_image_png_filter = require("./image/png-filter.cjs");
+//#region src/predictors.ts
+const DEFAULT_PREDICTOR = 1;
+const DEFAULT_COLORS = 1;
+const DEFAULT_BITS_PER_COMPONENT = 8;
+const DEFAULT_COLUMNS = 1;
+function readPredictorParams(parms) {
+	return {
+		predictor: require_objects.asNumber(parms ? require_objects.dictGet(parms, "Predictor") : void 0) ?? DEFAULT_PREDICTOR,
+		colors: require_objects.asNumber(parms ? require_objects.dictGet(parms, "Colors") : void 0) ?? DEFAULT_COLORS,
+		bitsPerComponent: require_objects.asNumber(parms ? require_objects.dictGet(parms, "BitsPerComponent") : void 0) ?? DEFAULT_BITS_PER_COMPONENT,
+		columns: require_objects.asNumber(parms ? require_objects.dictGet(parms, "Columns") : void 0) ?? DEFAULT_COLUMNS
+	};
+}
+function applyPredictor(data, params, sink) {
+	if (params.predictor <= 1) return data;
+	const bpp = Math.max(1, Math.ceil(params.colors * params.bitsPerComponent / 8));
+	const bytesPerRow = Math.ceil(params.colors * params.bitsPerComponent * params.columns / 8);
+	if (params.predictor === 2) return applyTiffPredictor(data, params, bytesPerRow, sink);
+	if (params.predictor >= 10) {
+		const height = bytesPerRow > 0 ? Math.floor(data.length / (bytesPerRow + 1)) : 0;
+		return require_image_png_filter.unfilterScanlines(data, height, bytesPerRow, bpp);
+	}
+	sink({
+		code: "pdf/unsupported-predictor",
+		severity: "warning",
+		message: `unsupported /Predictor value ${String(params.predictor)}; leaving data unpredicted`
+	});
+	return data;
+}
+function applyTiffPredictor(data, params, bytesPerRow, sink) {
+	if (params.bitsPerComponent !== 8 && params.bitsPerComponent !== 16) {
+		sink({
+			code: "pdf/unsupported-predictor",
+			severity: "warning",
+			message: `TIFF predictor with ${String(params.bitsPerComponent)}-bit components is not supported; leaving data unpredicted`
+		});
+		return data;
+	}
+	const out = new Uint8Array(data.length);
+	out.set(data);
+	const rowCount = bytesPerRow > 0 ? Math.floor(out.length / bytesPerRow) : 0;
+	const componentStride = params.bitsPerComponent === 16 ? 2 : 1;
+	const componentsPerPixel = params.colors;
+	for (let row = 0; row < rowCount; row++) {
+		const rowStart = row * bytesPerRow;
+		for (let component = componentsPerPixel; component * componentStride < bytesPerRow; component++) {
+			const i = rowStart + component * componentStride;
+			const prevI = i - componentsPerPixel * componentStride;
+			if (componentStride === 1) out[i] = (out[i] ?? 0) + (out[prevI] ?? 0) & 255;
+			else {
+				const sum = ((out[i] ?? 0) << 8 | (out[i + 1] ?? 0)) + ((out[prevI] ?? 0) << 8 | (out[prevI + 1] ?? 0)) & 65535;
+				out[i] = sum >> 8 & 255;
+				out[i + 1] = sum & 255;
+			}
+		}
+	}
+	return out;
+}
+//#endregion
+exports.applyPredictor = applyPredictor;
+exports.readPredictorParams = readPredictorParams;

package/dist/predictors.d.cts

@@ -0,0 +1,13 @@
+import { PdfDiagnosticSink } from "./diagnostics.cjs";
+import { PdfDict } from "./objects.cjs";
+//#region src/predictors.d.ts
+interface PredictorParams {
+  readonly predictor: number;
+  readonly colors: number;
+  readonly bitsPerComponent: number;
+  readonly columns: number;
+}
+declare function readPredictorParams(parms: PdfDict | undefined): PredictorParams;
+declare function applyPredictor(data: Uint8Array<ArrayBuffer>, params: PredictorParams, sink: PdfDiagnosticSink): Uint8Array<ArrayBuffer>;
+//#endregion
+export { PredictorParams, applyPredictor, readPredictorParams };

package/dist/predictors.d.ts

@@ -0,0 +1,13 @@
+import { PdfDiagnosticSink } from "./diagnostics.js";
+import { PdfDict } from "./objects.js";
+//#region src/predictors.d.ts
+interface PredictorParams {
+  readonly predictor: number;
+  readonly colors: number;
+  readonly bitsPerComponent: number;
+  readonly columns: number;
+}
+declare function readPredictorParams(parms: PdfDict | undefined): PredictorParams;
+declare function applyPredictor(data: Uint8Array<ArrayBuffer>, params: PredictorParams, sink: PdfDiagnosticSink): Uint8Array<ArrayBuffer>;
+//#endregion
+export { PredictorParams, applyPredictor, readPredictorParams };

package/dist/predictors.js

@@ -0,0 +1,62 @@
+import { asNumber, dictGet } from "./objects.js";
+import { unfilterScanlines } from "./image/png-filter.js";
+//#region src/predictors.ts
+const DEFAULT_PREDICTOR = 1;
+const DEFAULT_COLORS = 1;
+const DEFAULT_BITS_PER_COMPONENT = 8;
+const DEFAULT_COLUMNS = 1;
+function readPredictorParams(parms) {
+	return {
+		predictor: asNumber(parms ? dictGet(parms, "Predictor") : void 0) ?? DEFAULT_PREDICTOR,
+		colors: asNumber(parms ? dictGet(parms, "Colors") : void 0) ?? DEFAULT_COLORS,
+		bitsPerComponent: asNumber(parms ? dictGet(parms, "BitsPerComponent") : void 0) ?? DEFAULT_BITS_PER_COMPONENT,
+		columns: asNumber(parms ? dictGet(parms, "Columns") : void 0) ?? DEFAULT_COLUMNS
+	};
+}
+function applyPredictor(data, params, sink) {
+	if (params.predictor <= 1) return data;
+	const bpp = Math.max(1, Math.ceil(params.colors * params.bitsPerComponent / 8));
+	const bytesPerRow = Math.ceil(params.colors * params.bitsPerComponent * params.columns / 8);
+	if (params.predictor === 2) return applyTiffPredictor(data, params, bytesPerRow, sink);
+	if (params.predictor >= 10) {
+		const height = bytesPerRow > 0 ? Math.floor(data.length / (bytesPerRow + 1)) : 0;
+		return unfilterScanlines(data, height, bytesPerRow, bpp);
+	}
+	sink({
+		code: "pdf/unsupported-predictor",
+		severity: "warning",
+		message: `unsupported /Predictor value ${String(params.predictor)}; leaving data unpredicted`
+	});
+	return data;
+}
+function applyTiffPredictor(data, params, bytesPerRow, sink) {
+	if (params.bitsPerComponent !== 8 && params.bitsPerComponent !== 16) {
+		sink({
+			code: "pdf/unsupported-predictor",
+			severity: "warning",
+			message: `TIFF predictor with ${String(params.bitsPerComponent)}-bit components is not supported; leaving data unpredicted`
+		});
+		return data;
+	}
+	const out = new Uint8Array(data.length);
+	out.set(data);
+	const rowCount = bytesPerRow > 0 ? Math.floor(out.length / bytesPerRow) : 0;
+	const componentStride = params.bitsPerComponent === 16 ? 2 : 1;
+	const componentsPerPixel = params.colors;
+	for (let row = 0; row < rowCount; row++) {
+		const rowStart = row * bytesPerRow;
+		for (let component = componentsPerPixel; component * componentStride < bytesPerRow; component++) {
+			const i = rowStart + component * componentStride;
+			const prevI = i - componentsPerPixel * componentStride;
+			if (componentStride === 1) out[i] = (out[i] ?? 0) + (out[prevI] ?? 0) & 255;
+			else {
+				const sum = ((out[i] ?? 0) << 8 | (out[i + 1] ?? 0)) + ((out[prevI] ?? 0) << 8 | (out[prevI + 1] ?? 0)) & 65535;
+				out[i] = sum >> 8 & 255;
+				out[i + 1] = sum & 255;
+			}
+		}
+	}
+	return out;
+}
+//#endregion
+export { applyPredictor, readPredictorParams };