pdf-parser.js 5.2.26 → 5.2.28

package/dist/parse.d.cts

@@ -1,5 +1,5 @@
 import { PdfDiagnosticSink } from "./diagnostics.cjs";
-import { r as PdfObject } from "./objects-B7HdMeWS.cjs";
+import { r as PdfObject } from "./objects-e2RS3-yT.cjs";
 import { ByteReader } from "./bytes/reader.cjs";
 //#region src/parse.d.ts
 declare function parseValue(reader: ByteReader, sink: PdfDiagnosticSink): PdfObject | undefined;

package/dist/parse.d.ts

@@ -1,5 +1,5 @@
 import { PdfDiagnosticSink } from "./diagnostics.js";
-import { r as PdfObject } from "./objects-B7HdMeWS.js";
+import { r as PdfObject } from "./objects-e2RS3-yT.js";
 import { ByteReader } from "./bytes/reader.js";
 //#region src/parse.d.ts
 declare function parseValue(reader: ByteReader, sink: PdfDiagnosticSink): PdfObject | undefined;

package/dist/parse.js

@@ -109,10 +109,12 @@ function parseDictOrStreamBody(reader, sink) {
 	reader.reset(afterDictMark);
 	return dict;
 }
+const CARRIAGE_RETURN = 13;
+const LINE_FEED = 10;
 function skipStreamDataStart(reader, sink) {
-	if (reader.peek() === 13) {
+	if (reader.peek() === CARRIAGE_RETURN) {
 		reader.next();
-		if (reader.peek() === 10) reader.next();
+		if (reader.peek() === LINE_FEED) reader.next();
 		else sink({
 			code: "pdf/stream-bad-eol",
 			severity: "warning",
@@ -120,7 +122,7 @@ function skipStreamDataStart(reader, sink) {
 		});
 		return;
 	}
-	if (reader.peek() === 10) {
+	if (reader.peek() === LINE_FEED) {
 		reader.next();
 		return;
 	}
@@ -186,8 +188,8 @@ function findEndstreamOffset(reader, fromOffset) {
 }
 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;
+	if (precedingTwo.length >= 2 && precedingTwo[precedingTwo.length - 2] === CARRIAGE_RETURN && precedingTwo[precedingTwo.length - 1] === LINE_FEED) return endstreamOffset - 2;
+	if (precedingTwo.length >= 1 && (precedingTwo[precedingTwo.length - 1] === LINE_FEED || precedingTwo[precedingTwo.length - 1] === CARRIAGE_RETURN)) return endstreamOffset - 1;
 	return endstreamOffset;
 }
 function parseIndirectObject(reader, sink) {

package/dist/pdf-text.cjs

@@ -1,9 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/pdf-text.ts
+const UTF16BE_BOM_BYTE_0 = 254;
+const UTF16BE_BOM_BYTE_1 = 255;
+const BITS_PER_BYTE = 8;
 function decodePdfString(bytes) {
-	if (bytes.length >= 2 && bytes[0] === 254 && bytes[1] === 255) {
+	if (bytes.length >= 2 && bytes[0] === UTF16BE_BOM_BYTE_0 && bytes[1] === UTF16BE_BOM_BYTE_1) {
 		let out = "";
-		for (let i = 2; i + 1 < bytes.length; i += 2) out += String.fromCharCode((bytes[i] ?? 0) << 8 | (bytes[i + 1] ?? 0));
+		for (let i = 2; i + 1 < bytes.length; i += 2) out += String.fromCharCode((bytes[i] ?? 0) << BITS_PER_BYTE | (bytes[i + 1] ?? 0));
 		return out;
 	}
 	return Array.from(bytes, (b) => String.fromCharCode(b)).join("");

package/dist/pdf-text.js

@@ -1,8 +1,11 @@
 //#region src/pdf-text.ts
+const UTF16BE_BOM_BYTE_0 = 254;
+const UTF16BE_BOM_BYTE_1 = 255;
+const BITS_PER_BYTE = 8;
 function decodePdfString(bytes) {
-	if (bytes.length >= 2 && bytes[0] === 254 && bytes[1] === 255) {
+	if (bytes.length >= 2 && bytes[0] === UTF16BE_BOM_BYTE_0 && bytes[1] === UTF16BE_BOM_BYTE_1) {
 		let out = "";
-		for (let i = 2; i + 1 < bytes.length; i += 2) out += String.fromCharCode((bytes[i] ?? 0) << 8 | (bytes[i + 1] ?? 0));
+		for (let i = 2; i + 1 < bytes.length; i += 2) out += String.fromCharCode((bytes[i] ?? 0) << BITS_PER_BYTE | (bytes[i + 1] ?? 0));
 		return out;
 	}
 	return Array.from(bytes, (b) => String.fromCharCode(b)).join("");

package/dist/predictors.cjs

@@ -6,6 +6,11 @@ const DEFAULT_PREDICTOR = 1;
 const DEFAULT_COLORS = 1;
 const DEFAULT_BITS_PER_COMPONENT = 8;
 const DEFAULT_COLUMNS = 1;
+const BITS_PER_BYTE = 8;
+const BYTE_MASK = 255;
+const PNG_PREDICTOR_CODE_MIN = 10;
+const SIXTEEN_BIT_COMPONENT = 16;
+const SIXTEEN_BIT_SAMPLE_MASK = 65535;
 function readPredictorParams(parms) {
 	return {
 		predictor: require_objects.asNumber(parms ? require_objects.dictGet(parms, "Predictor") : void 0) ?? DEFAULT_PREDICTOR,
@@ -16,10 +21,10 @@ function readPredictorParams(parms) {
 }
 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);
+	const bpp = Math.max(1, Math.ceil(params.colors * params.bitsPerComponent / BITS_PER_BYTE));
+	const bytesPerRow = Math.ceil(params.colors * params.bitsPerComponent * params.columns / BITS_PER_BYTE);
 	if (params.predictor === 2) return applyTiffPredictor(data, params, bytesPerRow, sink);
-	if (params.predictor >= 10) {
+	if (params.predictor >= PNG_PREDICTOR_CODE_MIN) {
 		const height = bytesPerRow > 0 ? Math.floor(data.length / (bytesPerRow + 1)) : 0;
 		return require_image_png_filter.unfilterScanlines(data, height, bytesPerRow, bpp);
 	}
@@ -31,7 +36,7 @@ function applyPredictor(data, params, sink) {
 	return data;
 }
 function applyTiffPredictor(data, params, bytesPerRow, sink) {
-	if (params.bitsPerComponent !== 8 && params.bitsPerComponent !== 16) {
+	if (params.bitsPerComponent !== BITS_PER_BYTE && params.bitsPerComponent !== SIXTEEN_BIT_COMPONENT) {
 		sink({
 			code: "pdf/unsupported-predictor",
 			severity: "warning",
@@ -42,18 +47,18 @@ function applyTiffPredictor(data, params, bytesPerRow, sink) {
 	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 componentStride = params.bitsPerComponent === SIXTEEN_BIT_COMPONENT ? 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;
+			if (componentStride === 1) out[i] = (out[i] ?? 0) + (out[prevI] ?? 0) & BYTE_MASK;
 			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;
+				const sum = ((out[i] ?? 0) << BITS_PER_BYTE | (out[i + 1] ?? 0)) + ((out[prevI] ?? 0) << BITS_PER_BYTE | (out[prevI + 1] ?? 0)) & SIXTEEN_BIT_SAMPLE_MASK;
+				out[i] = sum >> BITS_PER_BYTE & BYTE_MASK;
+				out[i + 1] = sum & BYTE_MASK;
 			}
 		}
 	}

package/dist/predictors.d.cts

@@ -1,5 +1,5 @@
 import { PdfDiagnosticSink } from "./diagnostics.cjs";
-import { n as PdfDict } from "./objects-B7HdMeWS.cjs";
+import { n as PdfDict } from "./objects-e2RS3-yT.cjs";
 //#region src/predictors.d.ts
 interface PredictorParams {
   readonly predictor: number;

package/dist/predictors.d.ts

@@ -1,5 +1,5 @@
 import { PdfDiagnosticSink } from "./diagnostics.js";
-import { n as PdfDict } from "./objects-B7HdMeWS.js";
+import { n as PdfDict } from "./objects-e2RS3-yT.js";
 //#region src/predictors.d.ts
 interface PredictorParams {
   readonly predictor: number;

package/dist/predictors.js

@@ -5,6 +5,11 @@ const DEFAULT_PREDICTOR = 1;
 const DEFAULT_COLORS = 1;
 const DEFAULT_BITS_PER_COMPONENT = 8;
 const DEFAULT_COLUMNS = 1;
+const BITS_PER_BYTE = 8;
+const BYTE_MASK = 255;
+const PNG_PREDICTOR_CODE_MIN = 10;
+const SIXTEEN_BIT_COMPONENT = 16;
+const SIXTEEN_BIT_SAMPLE_MASK = 65535;
 function readPredictorParams(parms) {
 	return {
 		predictor: asNumber(parms ? dictGet(parms, "Predictor") : void 0) ?? DEFAULT_PREDICTOR,
@@ -15,10 +20,10 @@ function readPredictorParams(parms) {
 }
 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);
+	const bpp = Math.max(1, Math.ceil(params.colors * params.bitsPerComponent / BITS_PER_BYTE));
+	const bytesPerRow = Math.ceil(params.colors * params.bitsPerComponent * params.columns / BITS_PER_BYTE);
 	if (params.predictor === 2) return applyTiffPredictor(data, params, bytesPerRow, sink);
-	if (params.predictor >= 10) {
+	if (params.predictor >= PNG_PREDICTOR_CODE_MIN) {
 		const height = bytesPerRow > 0 ? Math.floor(data.length / (bytesPerRow + 1)) : 0;
 		return unfilterScanlines(data, height, bytesPerRow, bpp);
 	}
@@ -30,7 +35,7 @@ function applyPredictor(data, params, sink) {
 	return data;
 }
 function applyTiffPredictor(data, params, bytesPerRow, sink) {
-	if (params.bitsPerComponent !== 8 && params.bitsPerComponent !== 16) {
+	if (params.bitsPerComponent !== BITS_PER_BYTE && params.bitsPerComponent !== SIXTEEN_BIT_COMPONENT) {
 		sink({
 			code: "pdf/unsupported-predictor",
 			severity: "warning",
@@ -41,18 +46,18 @@ function applyTiffPredictor(data, params, bytesPerRow, sink) {
 	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 componentStride = params.bitsPerComponent === SIXTEEN_BIT_COMPONENT ? 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;
+			if (componentStride === 1) out[i] = (out[i] ?? 0) + (out[prevI] ?? 0) & BYTE_MASK;
 			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;
+				const sum = ((out[i] ?? 0) << BITS_PER_BYTE | (out[i + 1] ?? 0)) + ((out[prevI] ?? 0) << BITS_PER_BYTE | (out[prevI + 1] ?? 0)) & SIXTEEN_BIT_SAMPLE_MASK;
+				out[i] = sum >> BITS_PER_BYTE & BYTE_MASK;
+				out[i + 1] = sum & BYTE_MASK;
 			}
 		}
 	}

package/dist/raster.cjs

@@ -17,13 +17,16 @@ const require_read = require("./read.cjs");
 const require_glyf = require("./glyf.cjs");
 const require_glyf_contours = require("./glyf-contours.cjs");
 //#region src/raster.ts
+const PIXEL_ROUNDING_EPSILON = 1e-9;
+const POINTS_PER_INCH = 72;
+const EXTENT_ZERO_EPSILON = 1e-9;
 function regionPixels(extentPt, scale) {
-	return Math.max(1, Math.ceil(extentPt * scale - 1e-9));
+	return Math.max(1, Math.ceil(extentPt * scale - PIXEL_ROUNDING_EPSILON));
 }
 function renderPdfPage(pdfBytes, pageIndex, options, rasteriser) {
 	const sink = options.sink ?? require_diagnostics.NOOP_DIAGNOSTIC_SINK;
 	if (options.scale !== void 0 && options.dpi !== void 0) throw new Error("renderPdfPage accepts at most one of scale and dpi; they name the same factor in different units (dpi = 72 x scale)");
-	const scale = options.dpi !== void 0 ? options.dpi / 72 : options.scale;
+	const scale = options.dpi !== void 0 ? options.dpi / POINTS_PER_INCH : options.scale;
 	if (scale !== void 0 && !(scale > 0)) throw new Error(`renderPdfPage requires a positive scale factor (received scale ${options.scale}, dpi ${options.dpi})`);
 	const pixelsPerPt = scale ?? 1;
 	if (options.clipPt !== void 0 && (!(options.clipPt.widthPt > 0) || !(options.clipPt.heightPt > 0))) throw new Error("renderPdfPage clipPt must carry positive widthPt and heightPt; a zero-extent region has no pixels to render");
@@ -195,6 +198,7 @@ function drawRect(item, matrix, pixelsPerPt, rasteriser) {
 		stroke: strokeSpec(item.stroke, void 0, pixelsPerPt)
 	});
 }
+const ELLIPSE_QUADRANT_COUNT = 4;
 function drawEllipse(item, matrix, pixelsPerPt, rasteriser) {
 	const cx = item.xPt + item.widthPt / 2;
 	const cy = item.yPt + item.heightPt / 2;
@@ -224,8 +228,8 @@ function drawEllipse(item, matrix, pixelsPerPt, rasteriser) {
 	});
 	const start = transformed(cardinalPoints[0]);
 	const segments = [];
-	for (let i = 0; i < 4; i++) {
-		const end = transformed(cardinalPoints[(i + 1) % 4]);
+	for (let i = 0; i < ELLIPSE_QUADRANT_COUNT; i++) {
+		const end = transformed(cardinalPoints[(i + 1) % ELLIPSE_QUADRANT_COUNT]);
 		const c1 = transformed(controls[i * 2]);
 		const c2 = transformed(controls[i * 2 + 1]);
 		segments.push({
@@ -402,12 +406,13 @@ function drawImage(image, ctm, interpretToDeviceMatrix, rasteriser) {
 		matrix
 	});
 }
+const DASHED_STROKE_WIDTH_MULTIPLE = 3;
 function strokeSpec(stroke, style, pixelsPerPt) {
 	const widthPx = stroke.widthPt * pixelsPerPt;
 	if (style === "dashed") return {
 		color: stroke.color,
 		widthPx,
-		dashPx: [widthPx * 3, widthPx * 3]
+		dashPx: [widthPx * DASHED_STROKE_WIDTH_MULTIPLE, widthPx * DASHED_STROKE_WIDTH_MULTIPLE]
 	};
 	return {
 		color: stroke.color,
@@ -475,6 +480,7 @@ function flattenCubic(p0, c1, c2, p1) {
 	flatten(p0, c1, c2, p1, 0);
 	return points;
 }
+const CFF_HEADER_SIZE = 4;
 function openEmbeddedProgram(descriptorOwner, resolver) {
 	const descriptor = resolver.resolveDict(require_objects.dictGet(descriptorOwner, "FontDescriptor"));
 	if (descriptor === void 0) return { kind: "absent" };
@@ -482,7 +488,7 @@ function openEmbeddedProgram(descriptorOwner, resolver) {
 		const stream = resolver.resolve(require_objects.dictGet(descriptor, key));
 		if (stream?.kind !== "stream") continue;
 		const bytes = require_filters.decodeStream(stream.raw, stream.dict, require_diagnostics.NOOP_DIAGNOSTIC_SINK).bytes;
-		if (bytes[0] === 1 && bytes[1] === 0 && bytes[2] === 4) return { kind: "cff" };
+		if (bytes[0] === 1 && bytes[1] === 0 && bytes[2] === CFF_HEADER_SIZE) return { kind: "cff" };
 		const sfnt = require_sfnt.parseSfnt(bytes);
 		if (sfnt === void 0) continue;
 		if (sfnt.tables.has("CFF ")) return { kind: "cff" };
@@ -514,6 +520,7 @@ function resolveTextOutlineFace(fontResourceName, resources, resolver, fontResol
 	outlineFaces.set(fontDict, face);
 	return face;
 }
+const BITS_PER_BYTE = 8;
 function buildTextOutlineFace(fontDict, resolver, fontResolver, fontResourceName, resources, sink) {
 	const faceName = require_objects.asName(require_objects.dictGet(fontDict, "BaseFont")) ?? require_objects.asName(require_objects.dictGet(fontDict, "Subtype")) ?? "font";
 	const unavailable = (reason) => {
@@ -548,12 +555,12 @@ function buildTextOutlineFace(fontDict, resolver, fontResolver, fontResourceName
 		if (cidToGidMap?.kind === "stream") {
 			const decodedBytes = require_filters.decodeStream(cidToGidMap.raw, cidToGidMap.dict, require_diagnostics.NOOP_DIAGNOSTIC_SINK).bytes;
 			const entries = [];
-			for (let i = 0; i + 1 < decodedBytes.length; i += 2) entries.push(decodedBytes[i] << 8 | decodedBytes[i + 1]);
+			for (let i = 0; i + 1 < decodedBytes.length; i += 2) entries.push(decodedBytes[i] << BITS_PER_BYTE | decodedBytes[i + 1]);
 			return {
 				glyf: program.face.glyf,
 				unitsPerEm: program.face.unitsPerEm,
 				glyphIdOf: (codes, offset) => {
-					const cid = codes[offset] << 8 | codes[offset + 1];
+					const cid = codes[offset] << BITS_PER_BYTE | codes[offset + 1];
 					return entries[cid];
 				}
 			};
@@ -561,7 +568,7 @@ function buildTextOutlineFace(fontDict, resolver, fontResolver, fontResourceName
 		return {
 			glyf: program.face.glyf,
 			unitsPerEm: program.face.unitsPerEm,
-			glyphIdOf: (codes, offset) => codes[offset] << 8 | codes[offset + 1]
+			glyphIdOf: (codes, offset) => codes[offset] << BITS_PER_BYTE | codes[offset + 1]
 		};
 	}
 	if (subtype === "TrueType") {
@@ -585,6 +592,7 @@ function buildTextOutlineFace(fontDict, resolver, fontResolver, fontResourceName
 	}
 	return unavailable(`a font of subtype ${subtype ?? "(none)"} (a Type3 glyph-procedure font has no static outline at all)`);
 }
+const METRICS_PER_1000_SCALE = 1e3;
 function drawTextRun(item, fontResolver, resolver, outlineFaces, interpretToDeviceMatrix, rasteriser, sink) {
 	const face = resolveTextOutlineFace(item.fontResourceName, item.resources, resolver, fontResolver, outlineFaces, sink);
 	if (face === void 0) return;
@@ -597,10 +605,10 @@ function drawTextRun(item, fontResolver, resolver, outlineFaces, interpretToDevi
 		placements.push({
 			glyphId: face.glyphIdOf(item.codes, offset),
 			advance: cumulative,
-			positionX: (advance.vertical?.positionXPer1000 ?? 0) / 1e3,
-			positionY: (advance.vertical?.positionYPer1000 ?? 0) / 1e3
+			positionX: (advance.vertical?.positionXPer1000 ?? 0) / METRICS_PER_1000_SCALE,
+			positionY: (advance.vertical?.positionYPer1000 ?? 0) / METRICS_PER_1000_SCALE
 		});
-		cumulative += (advance.vertical?.displacementPer1000 ?? advance.widthPer1000) / 1e3 * item.sizePt;
+		cumulative += (advance.vertical?.displacementPer1000 ?? advance.widthPer1000) / METRICS_PER_1000_SCALE * item.sizePt;
 		offset += byteLength;
 	}
 	const startDeviceMatrix = require_matrix.multiplyMatrices(item.startMatrix, interpretToDeviceMatrix);
@@ -623,7 +631,7 @@ function drawTextRun(item, fontResolver, resolver, outlineFaces, interpretToDevi
 	});
 	const rawExtent = Math.hypot(rawEndPoint.x - startPoint.x, rawEndPoint.y - startPoint.y);
 	const actualExtent = Math.hypot(endPoint.x - startPoint.x, endPoint.y - startPoint.y);
-	const correction = rawExtent > 1e-9 ? actualExtent / rawExtent : 1;
+	const correction = rawExtent > EXTENT_ZERO_EPSILON ? actualExtent / rawExtent : 1;
 	const firstPlacement = placements[0];
 	const glyphScale = require_matrix.scaleMatrix(1 / face.unitsPerEm, 1 / face.unitsPerEm);
 	for (const placement of placements) {
@@ -646,10 +654,12 @@ function drawGlyphOutline(outline, glyphMatrix, color, rasteriser) {
 		}
 	});
 }
+const MIN_CONTOUR_POINTS = 3;
+const QUADRATIC_TO_CUBIC_CONTROL_FRACTION = 2 / 3;
 function glyphOutlineSubpaths(outline, matrix) {
 	const subpaths = [];
 	for (const contour of outline.contours) {
-		if (contour.length < 3) continue;
+		if (contour.length < MIN_CONTOUR_POINTS) continue;
 		const firstOn = contour.findIndex((point) => point.onCurve);
 		const contourPoints = contour.map((point) => ({
 			x: point.x,
@@ -674,10 +684,10 @@ function glyphOutlineSubpaths(outline, matrix) {
 			const p1 = require_matrix.applyMatrix(matrix, to);
 			segments.push({
 				kind: "cubic",
-				c1xPx: p0.x + 2 / 3 * (q.x - p0.x),
-				c1yPx: p0.y + 2 / 3 * (q.y - p0.y),
-				c2xPx: p1.x + 2 / 3 * (q.x - p1.x),
-				c2yPx: p1.y + 2 / 3 * (q.y - p1.y),
+				c1xPx: p0.x + QUADRATIC_TO_CUBIC_CONTROL_FRACTION * (q.x - p0.x),
+				c1yPx: p0.y + QUADRATIC_TO_CUBIC_CONTROL_FRACTION * (q.y - p0.y),
+				c2xPx: p1.x + QUADRATIC_TO_CUBIC_CONTROL_FRACTION * (q.x - p1.x),
+				c2yPx: p1.y + QUADRATIC_TO_CUBIC_CONTROL_FRACTION * (q.y - p1.y),
 				xPx: p1.x,
 				yPx: p1.y
 			});
@@ -765,6 +775,7 @@ function rotatedRectBounds(rect, matrix) {
 		maxY: Math.max(...ys)
 	};
 }
+const NEWLINE_BYTE = 10;
 function readPageContentBytes(page, resolver, sink) {
 	const contentsObj = resolver.resolve(require_objects.dictGet(page, "Contents"));
 	if (contentsObj?.kind === "stream") return require_filters.decodeStream(contentsObj.raw, contentsObj.dict, sink).bytes;
@@ -772,7 +783,7 @@ function readPageContentBytes(page, resolver, sink) {
 		const chunks = [];
 		for (const entry of contentsObj.items) {
 			const streamObj = resolver.resolve(entry);
-			if (streamObj?.kind === "stream") chunks.push(require_filters.decodeStream(streamObj.raw, streamObj.dict, sink).bytes, new Uint8Array([10]));
+			if (streamObj?.kind === "stream") chunks.push(require_filters.decodeStream(streamObj.raw, streamObj.dict, sink).bytes, new Uint8Array([NEWLINE_BYTE]));
 		}
 		return require_bytes_writer.concatBytes(chunks);
 	}

package/dist/raster.d.cts

@@ -1,6 +1,6 @@
 import { PdfDiagnosticSink } from "./diagnostics.cjs";
 import { r as Matrix } from "./matrix-B7_SBKQ5.cjs";
-import { n as GlyphOutline } from "./glyf-contours-BRpvd0rt.cjs";
+import { n as GlyphOutline } from "./glyf-contours-NHBpgks-.cjs";
 import { Color } from "document-schema.js";
 //#region src/raster.d.ts
 type RasterMatrix = readonly [number, number, number, number, number, number];
@@ -80,24 +80,24 @@ interface RenderPdfPageOptions {
   readonly sink?: PdfDiagnosticSink;
   readonly signal?: AbortSignal;
 }
-declare function renderPdfPage(pdfBytes: Uint8Array<ArrayBuffer>, pageIndex: number, options: RenderPdfPageOptions, rasteriser: PageRasteriser): Uint8Array<ArrayBuffer> | Promise<Uint8Array<ArrayBuffer>>;
-declare function flattenCubic(p0: {
+declare function renderPdfPage(pdfBytes: Uint8Array<ArrayBuffer>, pageIndex: number, options: RenderPdfPageOptions, rasteriser: Readonly<PageRasteriser>): Uint8Array<ArrayBuffer> | Promise<Uint8Array<ArrayBuffer>>;
+declare function flattenCubic(p0: Readonly<{
   x: number;
   y: number;
-}, c1: {
+}>, c1: Readonly<{
   x: number;
   y: number;
-}, c2: {
+}>, c2: Readonly<{
   x: number;
   y: number;
-}, p1: {
+}>, p1: Readonly<{
   x: number;
   y: number;
-}): readonly {
+}>): readonly {
   x: number;
   y: number;
 }[];
-declare function drawGlyphOutline(outline: GlyphOutline, glyphMatrix: Matrix, color: Color, rasteriser: PageRasteriser): void;
+declare function drawGlyphOutline(outline: GlyphOutline, glyphMatrix: Matrix, color: Readonly<Color>, rasteriser: Readonly<PageRasteriser>): void;
 declare function glyphOutlineSubpaths(outline: GlyphOutline, matrix: Matrix): readonly RasterSubpath[];
 //#endregion
 export { PageRasteriser, RasterDrawOp, RasterFillRectOp, RasterFillSpec, RasterImageOp, RasterMatrix, RasterPageGeometry, RasterPathOp, RasterPathSegment, RasterRegionPt, RasterStrokeSpec, RasterSubpath, RenderPdfPageOptions, drawGlyphOutline, flattenCubic, glyphOutlineSubpaths, renderPdfPage };

package/dist/raster.d.ts

@@ -1,6 +1,6 @@
 import { PdfDiagnosticSink } from "./diagnostics.js";
 import { r as Matrix } from "./matrix-B7_SBKQ5.js";
-import { n as GlyphOutline } from "./glyf-contours-C0epBNqP.js";
+import { n as GlyphOutline } from "./glyf-contours-B1PsI9oA.js";
 import { Color } from "document-schema.js";
 //#region src/raster.d.ts
 type RasterMatrix = readonly [number, number, number, number, number, number];
@@ -80,24 +80,24 @@ interface RenderPdfPageOptions {
   readonly sink?: PdfDiagnosticSink;
   readonly signal?: AbortSignal;
 }
-declare function renderPdfPage(pdfBytes: Uint8Array<ArrayBuffer>, pageIndex: number, options: RenderPdfPageOptions, rasteriser: PageRasteriser): Uint8Array<ArrayBuffer> | Promise<Uint8Array<ArrayBuffer>>;
-declare function flattenCubic(p0: {
+declare function renderPdfPage(pdfBytes: Uint8Array<ArrayBuffer>, pageIndex: number, options: RenderPdfPageOptions, rasteriser: Readonly<PageRasteriser>): Uint8Array<ArrayBuffer> | Promise<Uint8Array<ArrayBuffer>>;
+declare function flattenCubic(p0: Readonly<{
   x: number;
   y: number;
-}, c1: {
+}>, c1: Readonly<{
   x: number;
   y: number;
-}, c2: {
+}>, c2: Readonly<{
   x: number;
   y: number;
-}, p1: {
+}>, p1: Readonly<{
   x: number;
   y: number;
-}): readonly {
+}>): readonly {
   x: number;
   y: number;
 }[];
-declare function drawGlyphOutline(outline: GlyphOutline, glyphMatrix: Matrix, color: Color, rasteriser: PageRasteriser): void;
+declare function drawGlyphOutline(outline: GlyphOutline, glyphMatrix: Matrix, color: Readonly<Color>, rasteriser: Readonly<PageRasteriser>): void;
 declare function glyphOutlineSubpaths(outline: GlyphOutline, matrix: Matrix): readonly RasterSubpath[];
 //#endregion
 export { PageRasteriser, RasterDrawOp, RasterFillRectOp, RasterFillSpec, RasterImageOp, RasterMatrix, RasterPageGeometry, RasterPathOp, RasterPathSegment, RasterRegionPt, RasterStrokeSpec, RasterSubpath, RenderPdfPageOptions, drawGlyphOutline, flattenCubic, glyphOutlineSubpaths, renderPdfPage };

package/dist/raster.js

@@ -16,13 +16,16 @@ import { normalizeRotation, pageRotationTransform } from "./read.js";
 import { parseGlyf } from "./glyf.js";
 import { decodeGlyphOutline } from "./glyf-contours.js";
 //#region src/raster.ts
+const PIXEL_ROUNDING_EPSILON = 1e-9;
+const POINTS_PER_INCH = 72;
+const EXTENT_ZERO_EPSILON = 1e-9;
 function regionPixels(extentPt, scale) {
-	return Math.max(1, Math.ceil(extentPt * scale - 1e-9));
+	return Math.max(1, Math.ceil(extentPt * scale - PIXEL_ROUNDING_EPSILON));
 }
 function renderPdfPage(pdfBytes, pageIndex, options, rasteriser) {
 	const sink = options.sink ?? NOOP_DIAGNOSTIC_SINK;
 	if (options.scale !== void 0 && options.dpi !== void 0) throw new Error("renderPdfPage accepts at most one of scale and dpi; they name the same factor in different units (dpi = 72 x scale)");
-	const scale = options.dpi !== void 0 ? options.dpi / 72 : options.scale;
+	const scale = options.dpi !== void 0 ? options.dpi / POINTS_PER_INCH : options.scale;
 	if (scale !== void 0 && !(scale > 0)) throw new Error(`renderPdfPage requires a positive scale factor (received scale ${options.scale}, dpi ${options.dpi})`);
 	const pixelsPerPt = scale ?? 1;
 	if (options.clipPt !== void 0 && (!(options.clipPt.widthPt > 0) || !(options.clipPt.heightPt > 0))) throw new Error("renderPdfPage clipPt must carry positive widthPt and heightPt; a zero-extent region has no pixels to render");
@@ -194,6 +197,7 @@ function drawRect(item, matrix, pixelsPerPt, rasteriser) {
 		stroke: strokeSpec(item.stroke, void 0, pixelsPerPt)
 	});
 }
+const ELLIPSE_QUADRANT_COUNT = 4;
 function drawEllipse(item, matrix, pixelsPerPt, rasteriser) {
 	const cx = item.xPt + item.widthPt / 2;
 	const cy = item.yPt + item.heightPt / 2;
@@ -223,8 +227,8 @@ function drawEllipse(item, matrix, pixelsPerPt, rasteriser) {
 	});
 	const start = transformed(cardinalPoints[0]);
 	const segments = [];
-	for (let i = 0; i < 4; i++) {
-		const end = transformed(cardinalPoints[(i + 1) % 4]);
+	for (let i = 0; i < ELLIPSE_QUADRANT_COUNT; i++) {
+		const end = transformed(cardinalPoints[(i + 1) % ELLIPSE_QUADRANT_COUNT]);
 		const c1 = transformed(controls[i * 2]);
 		const c2 = transformed(controls[i * 2 + 1]);
 		segments.push({
@@ -401,12 +405,13 @@ function drawImage(image, ctm, interpretToDeviceMatrix, rasteriser) {
 		matrix
 	});
 }
+const DASHED_STROKE_WIDTH_MULTIPLE = 3;
 function strokeSpec(stroke, style, pixelsPerPt) {
 	const widthPx = stroke.widthPt * pixelsPerPt;
 	if (style === "dashed") return {
 		color: stroke.color,
 		widthPx,
-		dashPx: [widthPx * 3, widthPx * 3]
+		dashPx: [widthPx * DASHED_STROKE_WIDTH_MULTIPLE, widthPx * DASHED_STROKE_WIDTH_MULTIPLE]
 	};
 	return {
 		color: stroke.color,
@@ -474,6 +479,7 @@ function flattenCubic(p0, c1, c2, p1) {
 	flatten(p0, c1, c2, p1, 0);
 	return points;
 }
+const CFF_HEADER_SIZE = 4;
 function openEmbeddedProgram(descriptorOwner, resolver) {
 	const descriptor = resolver.resolveDict(dictGet(descriptorOwner, "FontDescriptor"));
 	if (descriptor === void 0) return { kind: "absent" };
@@ -481,7 +487,7 @@ function openEmbeddedProgram(descriptorOwner, resolver) {
 		const stream = resolver.resolve(dictGet(descriptor, key));
 		if (stream?.kind !== "stream") continue;
 		const bytes = decodeStream(stream.raw, stream.dict, NOOP_DIAGNOSTIC_SINK).bytes;
-		if (bytes[0] === 1 && bytes[1] === 0 && bytes[2] === 4) return { kind: "cff" };
+		if (bytes[0] === 1 && bytes[1] === 0 && bytes[2] === CFF_HEADER_SIZE) return { kind: "cff" };
 		const sfnt = parseSfnt(bytes);
 		if (sfnt === void 0) continue;
 		if (sfnt.tables.has("CFF ")) return { kind: "cff" };
@@ -513,6 +519,7 @@ function resolveTextOutlineFace(fontResourceName, resources, resolver, fontResol
 	outlineFaces.set(fontDict, face);
 	return face;
 }
+const BITS_PER_BYTE = 8;
 function buildTextOutlineFace(fontDict, resolver, fontResolver, fontResourceName, resources, sink) {
 	const faceName = asName(dictGet(fontDict, "BaseFont")) ?? asName(dictGet(fontDict, "Subtype")) ?? "font";
 	const unavailable = (reason) => {
@@ -547,12 +554,12 @@ function buildTextOutlineFace(fontDict, resolver, fontResolver, fontResourceName
 		if (cidToGidMap?.kind === "stream") {
 			const decodedBytes = decodeStream(cidToGidMap.raw, cidToGidMap.dict, NOOP_DIAGNOSTIC_SINK).bytes;
 			const entries = [];
-			for (let i = 0; i + 1 < decodedBytes.length; i += 2) entries.push(decodedBytes[i] << 8 | decodedBytes[i + 1]);
+			for (let i = 0; i + 1 < decodedBytes.length; i += 2) entries.push(decodedBytes[i] << BITS_PER_BYTE | decodedBytes[i + 1]);
 			return {
 				glyf: program.face.glyf,
 				unitsPerEm: program.face.unitsPerEm,
 				glyphIdOf: (codes, offset) => {
-					const cid = codes[offset] << 8 | codes[offset + 1];
+					const cid = codes[offset] << BITS_PER_BYTE | codes[offset + 1];
 					return entries[cid];
 				}
 			};
@@ -560,7 +567,7 @@ function buildTextOutlineFace(fontDict, resolver, fontResolver, fontResourceName
 		return {
 			glyf: program.face.glyf,
 			unitsPerEm: program.face.unitsPerEm,
-			glyphIdOf: (codes, offset) => codes[offset] << 8 | codes[offset + 1]
+			glyphIdOf: (codes, offset) => codes[offset] << BITS_PER_BYTE | codes[offset + 1]
 		};
 	}
 	if (subtype === "TrueType") {
@@ -584,6 +591,7 @@ function buildTextOutlineFace(fontDict, resolver, fontResolver, fontResourceName
 	}
 	return unavailable(`a font of subtype ${subtype ?? "(none)"} (a Type3 glyph-procedure font has no static outline at all)`);
 }
+const METRICS_PER_1000_SCALE = 1e3;
 function drawTextRun(item, fontResolver, resolver, outlineFaces, interpretToDeviceMatrix, rasteriser, sink) {
 	const face = resolveTextOutlineFace(item.fontResourceName, item.resources, resolver, fontResolver, outlineFaces, sink);
 	if (face === void 0) return;
@@ -596,10 +604,10 @@ function drawTextRun(item, fontResolver, resolver, outlineFaces, interpretToDevi
 		placements.push({
 			glyphId: face.glyphIdOf(item.codes, offset),
 			advance: cumulative,
-			positionX: (advance.vertical?.positionXPer1000 ?? 0) / 1e3,
-			positionY: (advance.vertical?.positionYPer1000 ?? 0) / 1e3
+			positionX: (advance.vertical?.positionXPer1000 ?? 0) / METRICS_PER_1000_SCALE,
+			positionY: (advance.vertical?.positionYPer1000 ?? 0) / METRICS_PER_1000_SCALE
 		});
-		cumulative += (advance.vertical?.displacementPer1000 ?? advance.widthPer1000) / 1e3 * item.sizePt;
+		cumulative += (advance.vertical?.displacementPer1000 ?? advance.widthPer1000) / METRICS_PER_1000_SCALE * item.sizePt;
 		offset += byteLength;
 	}
 	const startDeviceMatrix = multiplyMatrices(item.startMatrix, interpretToDeviceMatrix);
@@ -622,7 +630,7 @@ function drawTextRun(item, fontResolver, resolver, outlineFaces, interpretToDevi
 	});
 	const rawExtent = Math.hypot(rawEndPoint.x - startPoint.x, rawEndPoint.y - startPoint.y);
 	const actualExtent = Math.hypot(endPoint.x - startPoint.x, endPoint.y - startPoint.y);
-	const correction = rawExtent > 1e-9 ? actualExtent / rawExtent : 1;
+	const correction = rawExtent > EXTENT_ZERO_EPSILON ? actualExtent / rawExtent : 1;
 	const firstPlacement = placements[0];
 	const glyphScale = scaleMatrix(1 / face.unitsPerEm, 1 / face.unitsPerEm);
 	for (const placement of placements) {
@@ -645,10 +653,12 @@ function drawGlyphOutline(outline, glyphMatrix, color, rasteriser) {
 		}
 	});
 }
+const MIN_CONTOUR_POINTS = 3;
+const QUADRATIC_TO_CUBIC_CONTROL_FRACTION = 2 / 3;
 function glyphOutlineSubpaths(outline, matrix) {
 	const subpaths = [];
 	for (const contour of outline.contours) {
-		if (contour.length < 3) continue;
+		if (contour.length < MIN_CONTOUR_POINTS) continue;
 		const firstOn = contour.findIndex((point) => point.onCurve);
 		const contourPoints = contour.map((point) => ({
 			x: point.x,
@@ -673,10 +683,10 @@ function glyphOutlineSubpaths(outline, matrix) {
 			const p1 = applyMatrix(matrix, to);
 			segments.push({
 				kind: "cubic",
-				c1xPx: p0.x + 2 / 3 * (q.x - p0.x),
-				c1yPx: p0.y + 2 / 3 * (q.y - p0.y),
-				c2xPx: p1.x + 2 / 3 * (q.x - p1.x),
-				c2yPx: p1.y + 2 / 3 * (q.y - p1.y),
+				c1xPx: p0.x + QUADRATIC_TO_CUBIC_CONTROL_FRACTION * (q.x - p0.x),
+				c1yPx: p0.y + QUADRATIC_TO_CUBIC_CONTROL_FRACTION * (q.y - p0.y),
+				c2xPx: p1.x + QUADRATIC_TO_CUBIC_CONTROL_FRACTION * (q.x - p1.x),
+				c2yPx: p1.y + QUADRATIC_TO_CUBIC_CONTROL_FRACTION * (q.y - p1.y),
 				xPx: p1.x,
 				yPx: p1.y
 			});
@@ -764,6 +774,7 @@ function rotatedRectBounds(rect, matrix) {
 		maxY: Math.max(...ys)
 	};
 }
+const NEWLINE_BYTE = 10;
 function readPageContentBytes(page, resolver, sink) {
 	const contentsObj = resolver.resolve(dictGet(page, "Contents"));
 	if (contentsObj?.kind === "stream") return decodeStream(contentsObj.raw, contentsObj.dict, sink).bytes;
@@ -771,7 +782,7 @@ function readPageContentBytes(page, resolver, sink) {
 		const chunks = [];
 		for (const entry of contentsObj.items) {
 			const streamObj = resolver.resolve(entry);
-			if (streamObj?.kind === "stream") chunks.push(decodeStream(streamObj.raw, streamObj.dict, sink).bytes, new Uint8Array([10]));
+			if (streamObj?.kind === "stream") chunks.push(decodeStream(streamObj.raw, streamObj.dict, sink).bytes, new Uint8Array([NEWLINE_BYTE]));
 		}
 		return concatBytes(chunks);
 	}