reamkit 1.15.4 → 1.17.0

package/dist/esm/pdf/styled-page-emitter.js

@@ -3,9 +3,9 @@ import { embedTtfFont } from "./cid-font.js";
 import { preparePdfEncryption } from "./encryption.js";
 import { reorderVisual } from "../core/bidi/algorithm.js";
 import { reverseByCodePoint } from "../core/bidi/index.js";
-import "../layout/styled-layout.js";
+import { GLUE_SHRINK_RATIO } from "../layout/styled-layout.js";
 import { paintPlan } from "../layout/page-doc.js";
-import { emitVectorShape } from "./vector-graphics.js";
+import { emitClipPath, emitVectorShape, shadowBlurLayers } from "./vector-graphics.js";
 import { buildGradientPattern, shapeBbox } from "./shading.js";
 import { sanitizeHref } from "../core/links.js";
 import { embedAssociatedFile } from "./embedded-file.js";
@@ -95,10 +95,32 @@ function assembleStyledPdf(laid, options, doc) {
 			gradientNames.set(item.shape, nm);
 		}
 	}
+	const alphaStateNames = /* @__PURE__ */ new Map();
+	const extGStateEntries = {};
+	const wantAlpha = (alpha) => {
+		if (alpha === void 0 || alpha >= 1) return;
+		const key = Math.round(alpha * 1e3) / 1e3;
+		if (alphaStateNames.has(key)) return;
+		const nm = `GSa${alphaStateNames.size}`;
+		alphaStateNames.set(key, nm);
+		extGStateEntries[nm] = dict({
+			ca: key,
+			CA: key
+		});
+	};
+	for (const page of renderedPages) {
+		const plan = paintPlan(page.commands);
+		for (const item of plan.shapes) {
+			const s = item.shape.shadow;
+			if (s) wantAlpha(shadowBlurLayers(s).alpha);
+		}
+		for (const line of plan.lines) for (const tok of line.line.tokens) if (tok.kind === "image" && tok.shadow) wantAlpha(shadowBlurLayers(tok.shadow).alpha);
+	}
 	const resourcesDict = dict({
 		Font: fontResourceDict,
 		...xobjectResourceDict ? { XObject: xobjectResourceDict } : {},
-		...Object.keys(patternEntries).length > 0 ? { Pattern: dict(patternEntries) } : {}
+		...Object.keys(patternEntries).length > 0 ? { Pattern: dict(patternEntries) } : {},
+		...Object.keys(extGStateEntries).length > 0 ? { ExtGState: dict(extGStateEntries) } : {}
 	});
 	let pdfaIccRef;
 	let transparencyGroup;
@@ -125,7 +147,7 @@ function assembleStyledPdf(laid, options, doc) {
 				tagFor: (structId) => builder.node(structId).type
 			};
 		}
-		const { content: contentBytes, links } = emitPageContent(page, pageTagging, gradientNames);
+		const { content: contentBytes, links } = emitPageContent(page, pageTagging, gradientNames, alphaStateNames);
 		const contentsRef = doc.add(stream({}, contentBytes));
 		const pageEntries = {
 			Type: name("Page"),
@@ -363,7 +385,8 @@ function defaultPageCtx() {
 			even: { commands: [] }
 		},
 		titlePg: false,
-		evenAndOddHeaders: false
+		evenAndOddHeaders: false,
+		continuous: false
 	};
 }
 function embedImageResources(doc, laid) {
@@ -374,10 +397,13 @@ function embedImageResources(doc, laid) {
 function embedFontResources(doc, laid, pdfaProfile) {
 	const cidSet = pdfaProfile?.part === 1;
 	const out = /* @__PURE__ */ new Map();
-	for (const [variant, res] of laid.fontResources) out.set(variant, embedTtfFont(doc, res.parsed, {
-		usedGids: res.gids,
-		cidSet
-	}));
+	for (const [variant, res] of laid.fontResources) {
+		if (res.gids.size === 0) continue;
+		out.set(variant, embedTtfFont(doc, res.parsed, {
+			usedGids: res.gids,
+			cidSet
+		}));
+	}
 	return out;
 }
 function buildFontResourceDict(resources, embedded) {
@@ -426,7 +452,40 @@ function emitTaggedRuns(out, cmds, tagging, body) {
 	}
 	close();
 }
-function emitPageContent(page, tagging, gradientNames) {
+/**
+* The dash array for a §18.18.3 / §17.18.2 border style, in points.
+*
+* A pattern is a pattern, not a weight: Word and Excel both draw the same
+* dashes on a hairline and on a 3pt rule, and both references agree on the
+* lengths — a `dashed` page border strokes `8 2.5` whether its `w:sz` is 4 or
+* 24. Scaling them by the width instead drew page-borders-export-case-2.docx's
+* half-point frame as a row of specks a quarter the length it should be.
+*/
+var BORDER_DASHES = new Map([
+	["dashed", [8, 2.5]],
+	["dashSmallGap", [3, 1]],
+	["dotted", [.5, 1]],
+	["dashDot", [
+		8,
+		2.5,
+		2.5,
+		2.5
+	]],
+	["dashDotDot", [
+		8,
+		2.5,
+		2.5,
+		2.5,
+		2.5,
+		2.5
+	]]
+]);
+/** The PDF dash array for a border style; an empty string means a solid rule. */
+function dashPatternFor(style) {
+	const pattern = style !== void 0 ? BORDER_DASHES.get(style) : void 0;
+	return pattern ? `[${pattern.map(formatNumber).join(" ")}]` : "";
+}
+function emitPageContent(page, tagging, gradientNames, alphaStateNames) {
 	const commands = page.commands;
 	const links = [];
 	if (commands.length === 0) return {
@@ -456,7 +515,18 @@ function emitPageContent(page, tagging, gradientNames) {
 	}
 	emitTaggedRuns(out, plan.images.filter((c) => c.imageResourceName !== ""), tagging, (img) => {
 		out.push("q");
-		out.push(`${formatNumber(img.width)} 0 0 ${formatNumber(img.height)} ${formatNumber(img.x)} ${formatNumber(H - img.y - img.height)} cm`);
+		if (img.clip) {
+			const t = img.clip.transform;
+			out.push(...emitClipPath(img.clip.paths, [
+				t[0],
+				-t[1],
+				t[2],
+				-t[3],
+				t[4],
+				H - t[5]
+			]));
+		}
+		out.push(...placeImage(img.x, H - img.y - img.height, img.width, img.height, img.crop, img.rotationDeg, img.flipH, img.flipV));
 		out.push(`/${img.imageResourceName} Do`);
 		out.push("Q");
 	});
@@ -464,14 +534,22 @@ function emitPageContent(page, tagging, gradientNames) {
 	if (borders.length > 0) {
 		if (tagging) out.push("/Artifact BMC");
 		out.push("q");
+		out.push("2 J");
 		let lastWidth = -1;
 		let lastColor = "";
+		let lastDash = "";
 		for (const b of borders) {
 			const width = b.borderSizePt;
 			const color = b.borderColorHex;
-			if (width !== lastWidth) {
-				out.push(`${formatNumber(width)} w`);
-				lastWidth = width;
+			const dash = dashPatternFor(b.borderStyle);
+			if (dash !== lastDash) {
+				out.push(dash === "" ? "[] 0 d 2 J" : `${dash} 0 d 0 J`);
+				lastDash = dash;
+			}
+			const strokeW = b.borderStyle === "double" ? Math.max(.25, width / 3) : width;
+			if (strokeW !== lastWidth) {
+				out.push(`${formatNumber(strokeW)} w`);
+				lastWidth = strokeW;
 			}
 			if (color !== lastColor) {
 				const [r, g, bl] = hexToRgb01(color);
@@ -482,23 +560,39 @@ function emitPageContent(page, tagging, gradientNames) {
 			const y = H - b.y - b.height;
 			const w = b.width;
 			const h = b.height;
-			switch (b.side) {
-				case "top":
-					out.push(`${formatNumber(x)} ${formatNumber(y + h)} m`);
-					out.push(`${formatNumber(x + w)} ${formatNumber(y + h)} l`);
-					break;
-				case "bottom":
-					out.push(`${formatNumber(x)} ${formatNumber(y)} m`);
-					out.push(`${formatNumber(x + w)} ${formatNumber(y)} l`);
-					break;
-				case "left":
-					out.push(`${formatNumber(x)} ${formatNumber(y)} m`);
-					out.push(`${formatNumber(x)} ${formatNumber(y + h)} l`);
-					break;
-				case "right":
-					out.push(`${formatNumber(x + w)} ${formatNumber(y)} m`);
-					out.push(`${formatNumber(x + w)} ${formatNumber(y + h)} l`);
-					break;
+			const [x1, y1, x2, y2, nx, ny] = b.side === "top" ? [
+				x,
+				y + h,
+				x + w,
+				y + h,
+				0,
+				1
+			] : b.side === "bottom" ? [
+				x,
+				y,
+				x + w,
+				y,
+				0,
+				1
+			] : b.side === "left" ? [
+				x,
+				y,
+				x,
+				y + h,
+				1,
+				0
+			] : [
+				x + w,
+				y,
+				x + w,
+				y + h,
+				1,
+				0
+			];
+			const offsets = b.borderStyle === "double" ? [-width / 3, width / 3] : [0];
+			for (const d of offsets) {
+				out.push(`${formatNumber(x1 + nx * d)} ${formatNumber(y1 + ny * d)} m`);
+				out.push(`${formatNumber(x2 + nx * d)} ${formatNumber(y2 + ny * d)} l`);
 			}
 			out.push("S");
 		}
@@ -519,12 +613,15 @@ function emitPageContent(page, tagging, gradientNames) {
 				H - t[5]
 			]
 		};
-		for (const op of emitVectorShape(shape, gradientNames?.get(sh.shape))) out.push(op);
+		const shadowLayer = sh.shape.shadow ? shadowBlurLayers(sh.shape.shadow) : void 0;
+		const alphaState = shadowLayer && shadowLayer.alpha < 1 ? alphaStateNames?.get(Math.round(shadowLayer.alpha * 1e3) / 1e3) : void 0;
+		for (const op of emitVectorShape(shape, gradientNames?.get(sh.shape), alphaState)) out.push(op);
 	});
 	const lines = plan.lines;
 	if (lines.length > 0) {
 		let inBT = false;
 		let lastFont = "";
+		let lastTc = 0;
 		let lastSize = -1;
 		let lastColor = "";
 		const switchFontIfNeeded = (tok) => {
@@ -534,6 +631,11 @@ function emitPageContent(page, tagging, gradientNames) {
 				lastFont = fontKey;
 				lastSize = tok.fontSizePt;
 			}
+			const tc = tok.resolvedRun.letterSpacingPt ?? 0;
+			if (tc !== lastTc) {
+				out.push(`${formatNumber(tc)} Tc`);
+				lastTc = tc;
+			}
 			if (tok.resolvedRun.colorHex !== lastColor) {
 				const [r, g, b] = hexToRgb01(tok.resolvedRun.colorHex);
 				out.push(`${formatNumber(r)} ${formatNumber(g)} ${formatNumber(b)} rg`);
@@ -546,13 +648,45 @@ function emitPageContent(page, tagging, gradientNames) {
 				out.push("ET");
 				inBT = false;
 			}
+			const shdw = tok.shadow;
+			if (shdw) {
+				const bx = tok.drawBox;
+				const [shr, shg, shb] = hexToRgb01(shdw.colorHex);
+				const layers = shadowBlurLayers(shdw);
+				const state = layers.alpha < 1 ? alphaStateNames?.get(Math.round(layers.alpha * 1e3) / 1e3) : void 0;
+				const sx = x + (bx?.dxPt ?? 0) + shdw.dxPt;
+				const sy = baselineY + (bx?.dyPt ?? 0) - shdw.dyPt;
+				const sw = bx?.widthPt ?? tok.widthPt;
+				const sh = bx?.heightPt ?? tok.heightPt;
+				out.push("q");
+				if (state) out.push(`/${state} gs`);
+				out.push(`${formatNumber(shr)} ${formatNumber(shg)} ${formatNumber(shb)} rg`);
+				for (let i = 0; i < layers.count; i++) {
+					const grow = layers.count > 1 ? -shdw.blurPt / 2 + (i + .5) * shdw.blurPt / layers.count : 0;
+					out.push(`${formatNumber(sx - grow)} ${formatNumber(sy - grow)} ${formatNumber(Math.max(sw + 2 * grow, 0))} ${formatNumber(Math.max(sh + 2 * grow, 0))} re`);
+					out.push("f");
+				}
+				out.push("Q");
+			}
 			out.push("q");
-			out.push(`${formatNumber(tok.widthPt)} 0 0 ${formatNumber(tok.heightPt)} ${formatNumber(x)} ${formatNumber(baselineY)} cm`);
+			const b = tok.drawBox;
+			out.push(...b ? placeImage(x + b.dxPt, baselineY + b.dyPt, b.widthPt, b.heightPt, tok.crop, tok.rotationDeg, tok.flipH, tok.flipV) : placeImage(x, baselineY, tok.widthPt, tok.heightPt, tok.crop, tok.rotationDeg, tok.flipH, tok.flipV));
 			out.push(`/${tok.imageResourceName} Do`);
 			out.push("Q");
+			const frame = tok.outline;
+			if (frame) {
+				const [fr, fg, fb] = hexToRgb01(frame.colorHex);
+				out.push("q");
+				out.push(`${formatNumber(frame.widthPt)} w`);
+				out.push(`${formatNumber(fr)} ${formatNumber(fg)} ${formatNumber(fb)} RG`);
+				out.push(`${formatNumber(x + (b?.dxPt ?? 0))} ${formatNumber(baselineY + (b?.dyPt ?? 0))} ${formatNumber(b?.widthPt ?? tok.widthPt)} ${formatNumber(b?.heightPt ?? tok.heightPt)} re`);
+				out.push("S");
+				out.push("Q");
+			}
 			lastFont = "";
 			lastSize = -1;
 			lastColor = "";
+			lastTc = 0;
 		};
 		const emitMathToken = (tok, originX, baselineY) => {
 			for (const it of tok.items) if (it.kind === "glyph") {
@@ -570,7 +704,7 @@ function emitPageContent(page, tagging, gradientNames) {
 					lastColor = "000000";
 				}
 				out.push(`1 0 0 1 ${formatNumber(originX + it.x)} ${formatNumber(baselineY + it.y)} Tm`);
-				out.push(`<${it.font.measure.encodeTextAsCidHex(it.text)}> Tj`);
+				out.push(it.font.measure.showText(it.text));
 			} else if (it.kind === "rule") {
 				if (inBT) {
 					out.push("ET");
@@ -611,10 +745,40 @@ function emitPageContent(page, tagging, gradientNames) {
 				lastColor = "";
 			}
 		};
+		const emitClipped = (cmd, body) => {
+			const clip = cmd.clip;
+			if (!clip) {
+				body(cmd);
+				return;
+			}
+			if (inBT) {
+				out.push("ET");
+				inBT = false;
+			}
+			out.push("q");
+			out.push(`${formatNumber(clip.x)} ${formatNumber(H - clip.y - clip.height)} ${formatNumber(clip.width)} ${formatNumber(clip.height)} re W n`);
+			lastFont = "";
+			lastSize = -1;
+			lastColor = "";
+			lastTc = 0;
+			out.push("BT");
+			inBT = true;
+			body(cmd);
+			if (inBT) {
+				out.push("ET");
+				inBT = false;
+			}
+			out.push("Q");
+			lastFont = "";
+			lastSize = -1;
+			lastColor = "";
+			lastTc = 0;
+		};
 		const emitOneLine = (cmd) => {
 			const line = cmd.line;
 			const originX = cmd.originX;
 			const baselineY = H - cmd.baselineY;
+			const rotationDeg = cmd.rotationDeg ?? 0;
 			const lineFs = line.maxFontSizePt || 12;
 			const linkAscent = Math.max(lineFs, line.mathAscentPt ?? 0);
 			const linkDescent = Math.max(lineFs * .2, line.mathDescentPt ?? 0);
@@ -660,10 +824,40 @@ function emitPageContent(page, tagging, gradientNames) {
 			const hasImageToken = line.tokens.some((t) => t.kind === "image");
 			const hasMathToken = line.tokens.some((t) => t.kind === "math");
 			const hasRtl = line.tokens.some((t) => t.bidiLevel % 2 === 1);
-			const encodeToken = (tok) => {
+			const hasTab = line.tokens.some((t) => t.kind === "text" && t.tab === true);
+			/** A text token carrying underline or strikethrough. */
+			const isDecorated = (tok) => tok.kind === "text" && (tok.resolvedRun.underline !== "none" || tok.resolvedRun.strike);
+			const showToken = (tok) => {
 				const text = tok.bidiLevel % 2 === 1 ? reverseByCodePoint(tok.text) : tok.text;
-				return tok.font.measure.encodeTextAsCidHex(text);
+				return tok.font.measure.showText(text);
 			};
+			if (line.tokens.some((t) => t.kind === "text" && t.resolvedRun.shadingColorHex)) {
+				if (inBT) {
+					out.push("ET");
+					inBT = false;
+				}
+				const shAscent = Math.max(lineFs, line.mathAscentPt ?? 0);
+				const shDescent = Math.max(lineFs * .2, line.mathDescentPt ?? 0);
+				out.push("q");
+				let sx = originX;
+				let painted = "";
+				for (const tok of line.tokens) {
+					const w = tok.widthPt + (tok.kind === "text" && tok.isSpace ? extraPerSpace : 0);
+					const hex = tok.kind === "text" ? tok.resolvedRun.shadingColorHex : void 0;
+					if (hex !== void 0) {
+						if (hex !== painted) {
+							if (painted !== "") out.push("f");
+							const [sr, sg, sb] = hexToRgb01(hex);
+							out.push(`${formatNumber(sr)} ${formatNumber(sg)} ${formatNumber(sb)} rg`);
+							painted = hex;
+						}
+						out.push(`${formatNumber(sx)} ${formatNumber(baselineY - shDescent)} ${formatNumber(w)} ${formatNumber(shAscent + shDescent)} re`);
+					}
+					sx += w;
+				}
+				if (painted !== "") out.push("f");
+				out.push("Q");
+			}
 			if (line.tokens.some((t) => t.kind === "text" && t.highlight === true)) {
 				if (inBT) {
 					out.push("ET");
@@ -683,7 +877,66 @@ function emitPageContent(page, tagging, gradientNames) {
 				out.push("f");
 				out.push("Q");
 			}
-			if (extraPerSpace > 0 || hasImageToken || hasMathToken || hasRtl) {
+			if (line.tokens.some(isDecorated)) {
+				if (inBT) {
+					out.push("ET");
+					inBT = false;
+				}
+				out.push("q");
+				let dx = originX;
+				for (const tok of line.tokens) {
+					const w = tok.widthPt + (tok.kind === "text" && tok.isSpace ? extraPerSpace : 0);
+					if (isDecorated(tok)) {
+						const thickness = Math.max(.4, tok.fontSizePt * .06);
+						const paint = (hex) => {
+							const [r, g, b] = hexToRgb01(hex);
+							out.push(`${formatNumber(r)} ${formatNumber(g)} ${formatNumber(b)} rg`);
+						};
+						paint(tok.resolvedRun.colorHex);
+						if (tok.resolvedRun.underline !== "none") {
+							if (tok.resolvedRun.underlineColorHex) paint(tok.resolvedRun.underlineColorHex);
+							const style = tok.resolvedRun.underline;
+							const t = style === "thick" || style === "dottedHeavy" || style === "dashHeavy" ? thickness * 2 : thickness;
+							const y = baselineY - tok.fontSizePt * .12 - t;
+							const dashed = style === "dotted" || style === "dottedHeavy" ? [t, t * 2] : style === "dash" || style === "dashHeavy" ? [t * 4, t * 3] : void 0;
+							if (dashed) {
+								out.push(`${formatNumber(t)} w`);
+								out.push(`[${dashed.map((n) => formatNumber(n)).join(" ")}] 0 d`);
+								const [r, g, b] = hexToRgb01(tok.resolvedRun.underlineColorHex ?? tok.resolvedRun.colorHex);
+								out.push(`${formatNumber(r)} ${formatNumber(g)} ${formatNumber(b)} RG`);
+								out.push(`${formatNumber(dx)} ${formatNumber(y + t / 2)} m ${formatNumber(dx + w)} ${formatNumber(y + t / 2)} l S`);
+								out.push("[] 0 d");
+							} else {
+								out.push(`${formatNumber(dx)} ${formatNumber(y)} ${formatNumber(w)} ${formatNumber(t)} re f`);
+								if (style === "double") out.push(`${formatNumber(dx)} ${formatNumber(y - t * 2)} ${formatNumber(w)} ${formatNumber(t)} re f`);
+							}
+							if (tok.resolvedRun.underlineColorHex) paint(tok.resolvedRun.colorHex);
+						}
+						if (tok.resolvedRun.strike) {
+							const y = baselineY + tok.fontSizePt * .26;
+							out.push(`${formatNumber(dx)} ${formatNumber(y)} ${formatNumber(w)} ${formatNumber(thickness)} re f`);
+						}
+					}
+					dx += w;
+				}
+				out.push("Q");
+			}
+			const hasRise = line.tokens.some((t) => t.kind === "text" && t.risePt !== void 0);
+			if (rotationDeg !== 0 && !hasImageToken && !hasMathToken) {
+				if (!inBT) {
+					out.push("BT");
+					inBT = true;
+				}
+				const rad = rotationDeg * Math.PI / 180;
+				const cos = formatNumber(Math.cos(rad));
+				const sin = formatNumber(Math.sin(rad));
+				out.push(`${cos} ${sin} ${formatNumber(-Math.sin(rad))} ${cos} ${formatNumber(originX)} ${formatNumber(baselineY)} Tm`);
+				for (const tok of line.tokens) {
+					if (tok.kind !== "text") continue;
+					switchFontIfNeeded(tok);
+					out.push(tok.font.measure.showText(tok.text));
+				}
+			} else if (extraPerSpace !== 0 || hasImageToken || hasMathToken || hasRtl || hasRise || hasTab) {
 				const order = hasRtl ? lineVisualOrder(line) : line.tokens.map((_, i) => i);
 				let x = originX;
 				for (const ti of order) {
@@ -705,8 +958,8 @@ function emitPageContent(page, tagging, gradientNames) {
 						inBT = true;
 					}
 					switchFontIfNeeded(tok);
-					out.push(`1 0 0 1 ${formatNumber(x)} ${formatNumber(baselineY)} Tm`);
-					out.push(`<${encodeToken(tok)}> Tj`);
+					out.push(`1 0 0 1 ${formatNumber(x)} ${formatNumber(baselineY + (tok.risePt ?? 0))} Tm`);
+					out.push(showToken(tok));
 					const tokenX0 = x;
 					x += tok.widthPt;
 					if (tok.isSpace) x += extraPerSpace;
@@ -723,8 +976,7 @@ function emitPageContent(page, tagging, gradientNames) {
 				for (const tok of line.tokens) {
 					if (tok.kind !== "text") continue;
 					switchFontIfNeeded(tok);
-					const hex = tok.font.measure.encodeTextAsCidHex(tok.text);
-					out.push(`<${hex}> Tj`);
+					out.push(tok.font.measure.showText(tok.text));
 					trackLink(tok.href, tok.anchor, tok.text, x, x + tok.widthPt);
 					x += tok.widthPt;
 				}
@@ -744,7 +996,7 @@ function emitPageContent(page, tagging, gradientNames) {
 				out.push(`/${tagging.tagFor(sid)} <</MCID ${mcid}>> BDC`);
 			} else if (cmd.artifact === "pagination") out.push("/Artifact <</Type /Pagination>> BDC");
 			else out.push("/Artifact BMC");
-			emitOneLine(cmd);
+			emitClipped(cmd, emitOneLine);
 			if (inBT) {
 				out.push("ET");
 				inBT = false;
@@ -754,7 +1006,7 @@ function emitPageContent(page, tagging, gradientNames) {
 		else {
 			out.push("BT");
 			inBT = true;
-			for (const cmd of lines) emitOneLine(cmd);
+			for (const cmd of lines) emitClipped(cmd, emitOneLine);
 			if (inBT) out.push("ET");
 		}
 	}
@@ -766,15 +1018,69 @@ function emitPageContent(page, tagging, gradientNames) {
 function lineVisualOrder(line) {
 	return reorderVisual(line.tokens.map((t) => t.bidiLevel));
 }
+/**
+* The operators that put an image XObject in a box — ISO 32000-1 §8.9.5.1: the
+* unit square scaled to the box and moved to `(x, y)`, its bottom-left corner.
+*
+* A `a:srcRect` crop (§20.1.8.55) cuts edges off the SOURCE and fits what is
+* left to the same box, so the picture is drawn larger than the box and the box
+* is made a clipping path. Ignored, ImageCrop.docx drew the whole mountain
+* where LibreOffice shows the peak.
+*
+* @returns The content-stream lines, to be pushed between `q` and the `Do`.
+*/
+function placeImage(x, y, width, height, crop, rotationDeg, flipH, flipV) {
+	const cm = (w, h, ox, oy) => `${formatNumber(w)} 0 0 ${formatNumber(h)} ${formatNumber(ox)} ${formatNumber(oy)} cm`;
+	const spin = rotationDeg ? [rotateAboutCm(x + width / 2, y + height / 2, -rotationDeg)] : [];
+	if (flipH === true || flipV === true) {
+		const sx = flipH === true ? -1 : 1;
+		const sy = flipV === true ? -1 : 1;
+		spin.push(`${formatNumber(sx)} 0 0 ${formatNumber(sy)} ${formatNumber(sx === -1 ? 2 * x + width : 0)} ${formatNumber(sy === -1 ? 2 * y + height : 0)} cm`);
+	}
+	if (!crop) return [...spin, cm(width, height, x, y)];
+	const kept = {
+		w: 1 - crop.left - crop.right,
+		h: 1 - crop.top - crop.bottom
+	};
+	const full = {
+		w: width / kept.w,
+		h: height / kept.h
+	};
+	return [
+		...spin,
+		`${formatNumber(x)} ${formatNumber(y)} ${formatNumber(width)} ${formatNumber(height)} re`,
+		"W",
+		"n",
+		cm(full.w, full.h, x - crop.left * full.w, y - crop.bottom * full.h)
+	];
+}
+/** A `cm` that turns the frame `deg` counter-clockwise about `(cx, cy)`. */
+function rotateAboutCm(cx, cy, deg) {
+	const rad = deg * Math.PI / 180;
+	const c = Math.cos(rad);
+	const s = Math.sin(rad);
+	return `${formatNumber(c)} ${formatNumber(s)} ${formatNumber(-s)} ${formatNumber(c)} ${formatNumber(cx - cx * c + cy * s)} ${formatNumber(cy - cx * s - cy * c)} cm`;
+}
 function computeJustifyExtra(line) {
-	if (line.resolved.alignment !== "both") return 0;
-	if (line.isLastInParagraph) return 0;
+	const alignment = line.resolved.alignment;
+	if (alignment !== "both" && alignment !== "distribute") return 0;
+	if (line.noJustify === true) return 0;
+	if (line.isLastInParagraph && alignment !== "distribute") return 0;
+	let last = line.tokens.length - 1;
+	while (last >= 0 && line.tokens[last].kind === "text" && line.tokens[last].isSpace) last--;
 	let spaces = 0;
-	for (const tok of line.tokens) if (tok.isSpace) spaces++;
+	let narrowest = Infinity;
+	let contentWidthPt = 0;
+	for (let i = 0; i <= last; i++) {
+		const tok = line.tokens[i];
+		contentWidthPt += tok.widthPt;
+		if (!tok.isSpace) continue;
+		spaces++;
+		if (tok.widthPt < narrowest) narrowest = tok.widthPt;
+	}
 	if (spaces === 0) return 0;
-	const extra = line.availableWidthPt - line.contentWidthPt;
-	if (extra <= 0) return 0;
-	return extra / spaces;
+	const extra = (line.availableWidthPt - contentWidthPt) / spaces;
+	return extra < 0 ? Math.max(extra, -narrowest * GLUE_SHRINK_RATIO) : extra;
 }
 function hexToRgb01(hex) {
 	return [

package/dist/esm/pdf/text-page-renderer.js

@@ -1,3 +1,4 @@
+import "./objects.js";
 import "./cid-font.js";
 import "./writer.js";
 new TextEncoder();

package/dist/esm/pdf/vector-graphics.d.ts

@@ -1,4 +1,4 @@
-import { VectorShape } from '../core/vector.js';
+import { VectorPath, VectorShape } from '../core/vector.js';
 export type { PathSegment, StrokeStyle, VectorPath, VectorShape } from '../core/vector.js';
 export { PathBuilder } from '../core/vector.js';
 /**
@@ -11,6 +11,35 @@ export { PathBuilder } from '../core/vector.js';
  * @param patternName When set, the fill is this named shading pattern from the
  *   page's `/Pattern` resources (a gradient, EP16b) rather than a solid colour;
  *   only used if the shape actually carries a `fillGradient`.
+ * @param alphaStateName When set, the shape's shadow is drawn first, under this
+ *   named `/ExtGState` (its constant alpha) from the page's resources.
  * @returns The content-stream operator lines.
  */
-export declare function emitVectorShape(shape: VectorShape, patternName?: string): Array<string>;
+/**
+ * §20.1.8.40 `blurRad` — how a blurred shadow is drawn: as `count` copies of
+ * the silhouette, each at `alpha` transparency, growing through the blur's
+ * width. Shared with the emitter that registers the /ExtGState for it, so the
+ * alpha it registers is the one the layers are drawn at.
+ *
+ * @param shadow The shadow (its `blurPt` and `alpha` are read).
+ * @returns The number of layers and the transparency of each.
+ */
+export declare function shadowBlurLayers(shadow: {
+    readonly blurPt: number;
+    readonly alpha: number;
+}): {
+    count: number;
+    alpha: number;
+};
+export declare function emitVectorShape(shape: VectorShape, patternName?: string, alphaStateName?: string): Array<string>;
+/**
+ * The operators that make `paths` the current CLIP, under `transform` — the
+ * same local→y-up-page matrix {@link emitVectorShape} takes. Emitted inside the
+ * caller's own `q`…`Q`, and followed by the inverse matrix so what comes after
+ * is back in page coordinates.
+ *
+ * @param paths     The clip outline, in the shape's local frame.
+ * @param transform The local→page matrix.
+ * @returns The operators: `cm`, the path, `W n`, and the inverse `cm`.
+ */
+export declare function emitClipPath(paths: ReadonlyArray<VectorPath>, transform: readonly [number, number, number, number, number, number]): Array<string>;