reamkit 1.26.0 → 1.28.0

package/dist/esm/pdf-reader/display.d.ts

@@ -17,7 +17,7 @@ export interface Display {
     };
 }
 /**
- * The {@link Display} a page's `/MediaBox` and `/Rotate` describe.
+ * The {@link Display} a page's shown box and `/Rotate` describe.
  *
  * `/Rotate` turns the page CLOCKWISE when shown, so the content turns with it —
  * counter-clockwise by the same amount as seen from the content's own frame,

package/dist/esm/pdf-reader/display.js

@@ -1,6 +1,6 @@
 //#region src/pdf-reader/display.ts
 /**
-* The {@link Display} a page's `/MediaBox` and `/Rotate` describe.
+* The {@link Display} a page's shown box and `/Rotate` describe.
 *
 * `/Rotate` turns the page CLOCKWISE when shown, so the content turns with it —
 * counter-clockwise by the same amount as seen from the content's own frame,
@@ -10,7 +10,7 @@
 * @returns Its size, its turn, and the map onto it.
 */
 function displayOf(page) {
-	const [x0, y0, x1, y1] = page.mediaBox;
+	const [x0, y0, x1, y1] = page.cropBox;
 	const left = Math.min(x0, x1);
 	const bottom = Math.min(y0, y1);
 	const w = Math.abs(x1 - x0);
@@ -66,7 +66,60 @@ function placeRuns(runs, d) {
 			endY: end.y,
 			...Math.abs(angle) > .5 ? { angleDeg: angle } : {}
 		};
-	});
+	}).filter((r) => shows(d, Math.min(r.x, r.endX), Math.min(r.y, r.endY) - r.fontSizePt * .25, Math.max(r.x, r.endX), Math.max(r.y, r.endY) + r.fontSizePt * .85)).map((r) => cropped(r, d));
+}
+/**
+* §14.11.2 — a run the crop's edge cuts through, as the letters it shows.
+*
+* A run that reaches into the shown page was kept whole, which is right where
+* the crop trims a hair and wrong where it trims a line: endchar.pdf is one
+* line of a poster, "LE HOLD-UP PLANÉTAIRE", cropped to the fourteen points
+* that hold its É. Every viewer shows that one letter. Reflowed, the whole
+* line was re-set into a column fourteen points wide and came back as four
+* pages of one letter each.
+*
+* A letter is kept where any part of it is inside, so a crop that shaves an
+* edge takes nothing. Where in the run each letter falls is estimated from the
+* run's own width, which is exact for a face set solid and near enough for one
+* that is not — the answer is a letter either way.
+*
+* @param run The run, already placed on the shown page.
+* @param d   The page's shown geometry.
+* @returns The run, or the part of it the page shows.
+*/
+function cropped(run, d) {
+	const from = Math.min(run.x, run.endX);
+	const to = Math.max(run.x, run.endX);
+	const chars = [...run.text];
+	if (from >= 0 && to <= d.width) return run;
+	if (run.angleDeg !== void 0 || chars.length < 2 || !(to > from)) return run;
+	const step = (to - from) / chars.length;
+	const first = Math.max(0, Math.floor((0 - from) / step));
+	const last = Math.min(chars.length - 1, Math.ceil((d.width - from) / step) - 1);
+	if (first > last) return run;
+	if (first === 0 && last === chars.length - 1) return run;
+	const backwards = run.endX < run.x;
+	const startX = from + first * step;
+	const endX = from + (last + 1) * step;
+	return {
+		...run,
+		text: chars.slice(first, last + 1).join(""),
+		x: backwards ? endX : startX,
+		endX: backwards ? startX : endX
+	};
+}
+/**
+* §14.11.2 — whether a box falls inside the region the page SHOWS.
+*
+* The crop box is the region "to which the contents of the page shall be
+* clipped", and a page cropped to less than its sheet is generally a page with
+* something outside the crop: freeculture.pdf carries a printer's slug —
+* "14773_07_347-348_r4jm.qxd 2/10/04 4:45 PM Page 347" — in the 42 points the
+* crop cuts off the top, and lifted with the rest it stood at the head of the
+* page and pushed the sheet taller to hold it.
+*/
+function shows(d, minX, minY, maxX, maxY) {
+	return maxX > 0 && minX < d.width && maxY > 0 && minY < d.height;
 }
 /**
 * The same pictures, placed on the shown page. A quarter turn swaps a picture's
@@ -89,14 +142,16 @@ function placeImages(images, d) {
 		const ys = corners.map((c) => c.y);
 		const minX = Math.min(...xs);
 		const minY = Math.min(...ys);
+		const turned = (img.rotationDeg ?? 0) + d.turnDeg;
 		return {
 			...img,
 			x: minX,
 			y: minY,
 			widthPt: Math.max(...xs) - minX,
-			heightPt: Math.max(...ys) - minY
+			heightPt: Math.max(...ys) - minY,
+			...Math.abs(turned) > .5 ? { rotationDeg: turned } : {}
 		};
-	});
+	}).filter((img) => shows(d, img.x, img.y, img.x + img.widthPt, img.y + img.heightPt));
 }
 /**
 * The same paths, placed on the shown page. A path is geometry, so every point
@@ -156,7 +211,7 @@ function placeVectors(vectors, d) {
 			maxX: Math.max(...xs),
 			maxY: Math.max(...ys)
 		};
-	});
+	}).filter((v) => shows(d, v.minX, v.minY, v.maxX, v.maxY));
 }
 //#endregion
 export { displayOf, placeImages, placeRuns, placeVectors };

package/dist/esm/pdf-reader/document.d.ts

@@ -5,6 +5,12 @@ export type Rectangle = readonly [number, number, number, number];
 export interface PdfPage {
     readonly dict: PdfDict;
     readonly mediaBox: Rectangle;
+    /**
+     * §14.11.2 `/CropBox` — the region of the page a viewer SHOWS, which is what
+     * a page's size means to anyone looking at it. Defaults to the media box and
+     * is clipped to it; inherited down the page tree like the media box is.
+     */
+    readonly cropBox: Rectangle;
     /**
      * §14.11.1 `/Rotate` — how far the page turns CLOCKWISE when it is shown,
      * normalised to 0, 90, 180 or 270 and inherited down the page tree.

package/dist/esm/pdf-reader/document.js

@@ -1,8 +1,10 @@
 import { PDF_NULL, PdfName, PdfRef, PdfStream } from "../pdf/objects.js";
+import { lzwDecodeMsb } from "../core/lzw.js";
 import { buildDecryptor } from "./decrypt.js";
 import { Lexer } from "./lexer.js";
 import { parseIndirectObject, parseObject } from "./parser.js";
 import { reversePredictor } from "./predictor.js";
+import { ascii85Decode, asciiHexDecode, runLengthDecode } from "./stream-filters.js";
 import { unzlibSync } from "fflate";
 //#region src/pdf-reader/document.ts
 var DEFAULT_MEDIA_BOX = [
@@ -162,6 +164,7 @@ var PdfFile = class PdfFile {
 		if (out.length >= MAX_PAGES || seen.has(node)) return;
 		seen.add(node);
 		const mediaBox = readRectangle(this.get(node, "MediaBox")) ?? inherited.mediaBox;
+		const cropBox = readRectangle(this.get(node, "CropBox")) ?? inherited.cropBox;
 		const resourcesVal = this.get(node, "Resources");
 		const resources = resourcesVal instanceof Map ? resourcesVal : inherited.resources;
 		const rotate = readRotate(this.get(node, "Rotate")) ?? inherited.rotate;
@@ -172,6 +175,7 @@ var PdfFile = class PdfFile {
 				const kidNode = this.resolve(kid);
 				if (kidNode instanceof Map) this.walkPageTree(kidNode, {
 					mediaBox,
+					cropBox,
 					resources,
 					rotate
 				}, out, seen);
@@ -179,9 +183,11 @@ var PdfFile = class PdfFile {
 			}
 			return;
 		}
+		const media = mediaBox ?? DEFAULT_MEDIA_BOX;
 		out.push({
 			dict: node,
-			mediaBox: mediaBox ?? DEFAULT_MEDIA_BOX,
+			mediaBox: media,
+			cropBox: shownBox(media, cropBox),
 			rotate: rotate ?? 0,
 			resources
 		});
@@ -215,7 +221,19 @@ var PdfFile = class PdfFile {
 				data = unzlibSync(data);
 				flate = true;
 			} catch {}
-			else if (this.filters[f.value]) {
+			else if (GENERAL_FILTERS[f.value]) {
+				data = GENERAL_FILTERS[f.value](data);
+				flate = true;
+			} else if (f.value === "LZWDecode" || f.value === "LZW") {
+				const parms = this.resolve(stream.dict.get("DecodeParms") ?? PDF_NULL);
+				const p = Array.isArray(parms) ? this.resolve(parms[0] ?? PDF_NULL) : parms;
+				const early = p instanceof Map ? this.resolve(p.get("EarlyChange") ?? PDF_NULL) : void 0;
+				data = lzwDecodeMsb(data, {
+					earlyChange: early === 0 ? 0 : 1,
+					limit: MAX_LZW_OUT
+				});
+				flate = true;
+			} else if (this.filters[f.value]) {
 				const decoded = runFilter(this.filters[f.value], data);
 				if (decoded) data = decoded;
 				else this.unknownFilters.add(f.value);
@@ -236,15 +254,18 @@ function runFilter(filter, data) {
 		return;
 	}
 }
+/** A decompressed LZW stream larger than this is a bomb, not a document. */
+var MAX_LZW_OUT = 1 << 28;
+/** §7.4.2–7.4.5 — the filters that are transport, whatever the stream holds. */
+var GENERAL_FILTERS = {
+	ASCIIHexDecode: asciiHexDecode,
+	AHx: asciiHexDecode,
+	ASCII85Decode: ascii85Decode,
+	A85: ascii85Decode,
+	RunLengthDecode: runLengthDecode,
+	RL: runLengthDecode
+};
 var PASSTHROUGH_FILTERS = new Set([
-	"LZWDecode",
-	"LZW",
-	"RunLengthDecode",
-	"RL",
-	"ASCII85Decode",
-	"A85",
-	"ASCIIHexDecode",
-	"AHx",
 	"DCTDecode",
 	"DCT",
 	"JPXDecode",
@@ -526,5 +547,29 @@ function lastIndexOfAscii(buf, needle) {
 	}
 	return -1;
 }
+/**
+* §14.11.2 — the box a viewer SHOWS: the crop box where there is one, clipped
+* to the media box, and the media box where there is not.
+*
+* A crop box that states nothing usable — zero-sized, or outside the sheet
+* altogether — is a crop box no viewer honours, and the media box stands.
+* bug1844576.pdf is 612×792 of paper cropped to 181×53.75, and read as its
+* media box the form on it arrived a fifth of the way down a letter page.
+*/
+function shownBox(media, crop) {
+	if (!crop) return media;
+	const [mx0, my0, mx1, my1] = media;
+	const [cx0, cy0, cx1, cy1] = crop;
+	const x0 = Math.max(Math.min(mx0, mx1), Math.min(cx0, cx1));
+	const y0 = Math.max(Math.min(my0, my1), Math.min(cy0, cy1));
+	const x1 = Math.min(Math.max(mx0, mx1), Math.max(cx0, cx1));
+	const y1 = Math.min(Math.max(my0, my1), Math.max(cy0, cy1));
+	return x1 - x0 > 1 && y1 - y0 > 1 ? [
+		x0,
+		y0,
+		x1,
+		y1
+	] : media;
+}
 //#endregion
 export { PdfFile };

package/dist/esm/pdf-reader/embedded-fonts.d.ts

@@ -1,5 +1,6 @@
 import { PdfDict } from '../pdf/objects.js';
 import { PdfFile, PdfPage } from './document.js';
+import { Loss } from '../core/ir/index.js';
 import { FontRegistry } from '../core/font/index.js';
 /**
  * Every embedded TrueType program the pages use, by the name a run will ask for
@@ -15,11 +16,19 @@ import { FontRegistry } from '../core/font/index.js';
  * (`/FontFile`) are different formats that the layout's parser does not take;
  * those keep their substitute.
  *
- * @param file  The owning file.
- * @param pages The pages whose fonts are wanted.
+ * And only one whose OUTLINES this pipeline can carry: a program with no
+ * `glyf`/`loca` cannot be subset, and a face offered here is one the writer
+ * will be asked to embed. bug1186827.pdf ships an OpenType/CFF program under
+ * `/FontFile2`, which parses like any other and then killed the whole
+ * conversion — "Subsetting requires a TrueType font with glyf+loca tables" —
+ * rather than losing one face.
+ *
+ * @param file   The owning file.
+ * @param pages  The pages whose fonts are wanted.
+ * @param losses Appended to for a face the page embeds and this cannot carry.
  * @returns Name → a one-face registry holding that program.
  */
-export declare function collectEmbeddedFonts(file: PdfFile, pages: ReadonlyArray<PdfPage>): Map<string, FontRegistry>;
+export declare function collectEmbeddedFonts(file: PdfFile, pages: ReadonlyArray<PdfPage>, losses?: Array<Loss>): Map<string, FontRegistry>;
 /**
  * The name a run set in `fontDict` will ask for: its `/BaseFont` without the
  * six-capital subset prefix (§9.6.4), lowercased.
@@ -29,3 +38,14 @@ export declare function collectEmbeddedFonts(file: PdfFile, pages: ReadonlyArray
  * @returns The name, or `undefined` when the font states none.
  */
 export declare function embeddedFontName(file: PdfFile, fontDict: PdfDict): string | undefined;
+/**
+ * Whether this font carries a program this pipeline can set the page in.
+ *
+ * Only `/FontFile2` is liftable, and a run in such a face is filed under the
+ * face's own name — so that name must be left exactly as it is. Every other
+ * face is SUBSTITUTED, and its name is free to say what it is.
+ *
+ * @param file     The document.
+ * @param fontDict The font dictionary.
+ */
+export declare function hasLiftableProgram(file: PdfFile, fontDict: PdfDict): boolean;

package/dist/esm/pdf-reader/embedded-fonts.js

@@ -1,5 +1,7 @@
+import { parseTtf } from "../core/font/ttf-parser.js";
 import { FontRegistry } from "../core/font/font-registry.js";
 import { PDF_NULL, PdfName, PdfStream } from "../pdf/objects.js";
+import { FEATURES } from "../core/ir/features.js";
 //#region src/pdf-reader/embedded-fonts.ts
 var MAX_FORM_DEPTH = 8;
 /**
@@ -16,11 +18,19 @@ var MAX_FORM_DEPTH = 8;
 * (`/FontFile`) are different formats that the layout's parser does not take;
 * those keep their substitute.
 *
-* @param file  The owning file.
-* @param pages The pages whose fonts are wanted.
+* And only one whose OUTLINES this pipeline can carry: a program with no
+* `glyf`/`loca` cannot be subset, and a face offered here is one the writer
+* will be asked to embed. bug1186827.pdf ships an OpenType/CFF program under
+* `/FontFile2`, which parses like any other and then killed the whole
+* conversion — "Subsetting requires a TrueType font with glyf+loca tables" —
+* rather than losing one face.
+*
+* @param file   The owning file.
+* @param pages  The pages whose fonts are wanted.
+* @param losses Appended to for a face the page embeds and this cannot carry.
 * @returns Name → a one-face registry holding that program.
 */
-function collectEmbeddedFonts(file, pages) {
+function collectEmbeddedFonts(file, pages, losses) {
 	const out = /* @__PURE__ */ new Map();
 	const seen = /* @__PURE__ */ new Set();
 	const visiting = /* @__PURE__ */ new Set();
@@ -32,6 +42,15 @@ function collectEmbeddedFonts(file, pages) {
 		const program = fontProgram(file, fontDict);
 		if (!program) return;
 		try {
+			const parsed = parseTtf(program);
+			if (!parsed.tables.has("glyf") || !parsed.tables.has("loca")) {
+				losses?.push({
+					severity: "degraded",
+					feature: FEATURES.text,
+					detail: `embedded font ${name} has no TrueType outlines (a CFF program under /FontFile2); its text is re-set in a substitute face`
+				});
+				return;
+			}
 			out.set(name, FontRegistry.fromBytes({ regular: program }));
 		} catch {}
 	};
@@ -73,6 +92,19 @@ function embeddedFontName(file, fontDict) {
 	const name = base.value.replace(/^[A-Z]{6}\+/u, "").trim();
 	return name.length > 0 ? name.toLowerCase() : void 0;
 }
+/**
+* Whether this font carries a program this pipeline can set the page in.
+*
+* Only `/FontFile2` is liftable, and a run in such a face is filed under the
+* face's own name — so that name must be left exactly as it is. Every other
+* face is SUBSTITUTED, and its name is free to say what it is.
+*
+* @param file     The document.
+* @param fontDict The font dictionary.
+*/
+function hasLiftableProgram(file, fontDict) {
+	return fontProgram(file, fontDict) !== void 0;
+}
 /** §9.9 `/FontFile2` — the TrueType program, off the font or its descendant. */
 function fontProgram(file, fontDict) {
 	const owner = descendant(file, fontDict) ?? fontDict;
@@ -91,4 +123,4 @@ function descendant(file, fontDict) {
 	return first instanceof Map ? first : void 0;
 }
 //#endregion
-export { collectEmbeddedFonts, embeddedFontName };
+export { collectEmbeddedFonts, embeddedFontName, hasLiftableProgram };

package/dist/esm/pdf-reader/encodings.d.ts

@@ -0,0 +1,25 @@
+/** One of the base encodings this reader has a table for (Annex D.2). */
+export type BaseEncodingName = 'StandardEncoding' | 'WinAnsiEncoding' | 'MacRomanEncoding';
+/**
+ * The glyph names of a base encoding, or `undefined` for a name this has no
+ * table for — `/MacExpertEncoding`, whose repertory no reader here can set.
+ *
+ * @param name The `/Encoding` or `/BaseEncoding` name, without the slash.
+ */
+export declare function baseEncodingTable(name: string): ReadonlyMap<number, string> | undefined;
+/** The encoding built into the standard Latin text faces (§9.6.2.2). */
+export declare function standardEncodingTable(): ReadonlyMap<number, string>;
+/**
+ * The name a `post` table's glyph-name index below 258 stands for.
+ *
+ * @param index The index as the table states it.
+ * @returns The name, or `undefined` for an index outside the standard order.
+ */
+export declare function macGlyphName(index: number): string | undefined;
+/**
+ * Whether a `/BaseFont` names one of the standard Latin faces, whose built-in
+ * encoding is StandardEncoding.
+ *
+ * @param baseFont The name as the font dictionary states it.
+ */
+export declare function isStandardLatinFace(baseFont: string): boolean;

package/dist/esm/pdf-reader/encodings.js

@@ -0,0 +1,110 @@
+//#region src/pdf-reader/encodings.ts
+/**
+* Code → glyph name, from names read in code order. `.` marks a code the
+* encoding leaves unused, and the rows are the spec's own — sixteen to a line,
+* so a row can be checked against Annex D at a glance.
+*/
+function table(start, ...rows) {
+	const out = /* @__PURE__ */ new Map();
+	let code = start;
+	for (const row of rows) for (const name of row.split(/\s+/u).filter(Boolean)) {
+		if (name !== ".") out.set(code, name);
+		code++;
+	}
+	return out;
+}
+var ASCII = table(32, "space exclam quotedbl numbersign dollar percent ampersand quotesingle parenleft parenright asterisk plus comma hyphen period slash", "zero one two three four five six seven eight nine colon semicolon less equal greater question", "at A B C D E F G H I J K L M N O", "P Q R S T U V W X Y Z bracketleft backslash bracketright asciicircum underscore", "grave a b c d e f g h i j k l m n o", "p q r s t u v w x y z braceleft bar braceright asciitilde .");
+/** Annex D.2 STD — the built-in encoding of the standard Latin text faces. */
+var STANDARD = new Map([
+	...ASCII,
+	...table(39, "quoteright"),
+	...table(96, "quoteleft"),
+	...table(160, ". exclamdown cent sterling fraction yen florin section currency quotesingle quotedblleft guillemotleft guilsinglleft guilsinglright fi fl", ". endash dagger daggerdbl periodcentered . paragraph bullet quotesinglbase quotedblbase quotedblright guillemotright ellipsis perthousand . questiondown", ". grave acute circumflex tilde macron breve dotaccent dieresis . ring cedilla . hungarumlaut ogonek caron", "emdash . . . . . . . . . . . . . . .", ". AE . ordfeminine . . . . Lslash Oslash OE ordmasculine . . . .", ". ae . . . dotlessi . . lslash oslash oe germandbls . . . .")
+]);
+var TABLES = {
+	StandardEncoding: STANDARD,
+	WinAnsiEncoding: new Map([...ASCII, ...table(128, "Euro . quotesinglbase florin quotedblbase ellipsis dagger daggerdbl circumflex perthousand Scaron guilsinglleft OE . Zcaron .", ". quoteleft quoteright quotedblleft quotedblright bullet endash emdash tilde trademark scaron guilsinglright oe . zcaron Ydieresis")]),
+	MacRomanEncoding: new Map([...ASCII, ...table(128, "Adieresis Aring Ccedilla Eacute Ntilde Odieresis Udieresis aacute agrave acircumflex adieresis atilde aring ccedilla eacute egrave", "ecircumflex edieresis iacute igrave icircumflex idieresis ntilde oacute ograve ocircumflex odieresis otilde uacute ugrave ucircumflex udieresis", "dagger degree cent sterling section bullet paragraph germandbls registered copyright trademark acute dieresis notequal AE Oslash", "infinity plusminus lessequal greaterequal yen mu partialdiff summation product pi integral ordfeminine ordmasculine Omega ae oslash", "questiondown exclamdown logicalnot radical florin approxequal Delta guillemotleft guillemotright ellipsis space Agrave Atilde Otilde OE oe", "endash emdash quotedblleft quotedblright quoteleft quoteright divide lozenge ydieresis Ydieresis fraction currency guilsinglleft guilsinglright fi fl", "daggerdbl periodcentered quotesinglbase quotedblbase perthousand Acircumflex Ecircumflex Aacute Edieresis Egrave Iacute Icircumflex Idieresis Igrave Oacute Ocircumflex", ". Ograve Uacute Ucircumflex Ugrave dotlessi circumflex tilde macron breve dotaccent ring cedilla hungarumlaut ogonek caron")])
+};
+/**
+* The glyph names of a base encoding, or `undefined` for a name this has no
+* table for — `/MacExpertEncoding`, whose repertory no reader here can set.
+*
+* @param name The `/Encoding` or `/BaseEncoding` name, without the slash.
+*/
+function baseEncodingTable(name) {
+	return name in TABLES ? TABLES[name] : void 0;
+}
+/** The encoding built into the standard Latin text faces (§9.6.2.2). */
+function standardEncodingTable() {
+	return STANDARD;
+}
+var STANDARD_LATIN_FACES = new Set([
+	"courier",
+	"courier-bold",
+	"courier-oblique",
+	"courier-boldoblique",
+	"helvetica",
+	"helvetica-bold",
+	"helvetica-oblique",
+	"helvetica-boldoblique",
+	"times-roman",
+	"times-bold",
+	"times-italic",
+	"times-bolditalic"
+]);
+var MAC_ORDER = `
+.notdef .null nonmarkingreturn space exclam quotedbl numbersign dollar
+percent ampersand quotesingle parenleft parenright asterisk plus comma
+hyphen period slash zero one two three four
+five six seven eight nine colon semicolon less
+equal greater question at A B C D
+E F G H I J K L
+M N O P Q R S T
+U V W X Y Z bracketleft backslash
+bracketright asciicircum underscore grave a b c d
+e f g h i j k l
+m n o p q r s t
+u v w x y z braceleft bar
+braceright asciitilde Adieresis Aring Ccedilla Eacute Ntilde Odieresis
+Udieresis aacute agrave acircumflex adieresis atilde aring ccedilla
+eacute egrave ecircumflex edieresis iacute igrave icircumflex idieresis
+ntilde oacute ograve ocircumflex odieresis otilde uacute ugrave
+ucircumflex udieresis dagger degree cent sterling section bullet
+paragraph germandbls registered copyright trademark acute dieresis notequal
+AE Oslash infinity plusminus lessequal greaterequal yen mu
+partialdiff summation product pi integral ordfeminine ordmasculine Omega
+ae oslash questiondown exclamdown logicalnot radical florin approxequal
+Delta guillemotleft guillemotright ellipsis nonbreakingspace Agrave Atilde Otilde
+OE oe endash emdash quotedblleft quotedblright quoteleft quoteright
+divide lozenge ydieresis Ydieresis fraction currency guilsinglleft guilsinglright
+fi fl daggerdbl periodcentered quotesinglbase quotedblbase perthousand Acircumflex
+Ecircumflex Aacute Edieresis Egrave Iacute Icircumflex Idieresis Igrave
+Oacute Ocircumflex apple Ograve Uacute Ucircumflex Ugrave dotlessi
+circumflex tilde macron breve dotaccent ring cedilla hungarumlaut
+ogonek caron Lslash lslash Scaron scaron Zcaron zcaron
+brokenbar Eth eth Yacute yacute Thorn thorn minus
+multiply onesuperior twosuperior threesuperior onehalf onequarter threequarters franc
+Gbreve gbreve Idotaccent Scedilla scedilla Cacute cacute Ccaron
+ccaron dcroat
+`.split(/\s+/u).filter(Boolean);
+/**
+* The name a `post` table's glyph-name index below 258 stands for.
+*
+* @param index The index as the table states it.
+* @returns The name, or `undefined` for an index outside the standard order.
+*/
+function macGlyphName(index) {
+	return MAC_ORDER[index];
+}
+/**
+* Whether a `/BaseFont` names one of the standard Latin faces, whose built-in
+* encoding is StandardEncoding.
+*
+* @param baseFont The name as the font dictionary states it.
+*/
+function isStandardLatinFace(baseFont) {
+	return STANDARD_LATIN_FACES.has(baseFont.trim().replace(/^[A-Za-z]{6}\+/u, "").toLowerCase());
+}
+//#endregion
+export { baseEncodingTable, isStandardLatinFace, macGlyphName, standardEncodingTable };

package/dist/esm/pdf-reader/flow-build.d.ts

@@ -1,10 +1,12 @@
-import { BodyElement, SectionProperties, TextOutline } from '../core/document-model/index.js';
+import { BodyElement, ParagraphProperties, Section, SectionProperties, TextOutline } from '../core/document-model/index.js';
 import { FlowDoc } from '../core/ir/flow.js';
 import { FontRegistry } from '../core/font/index.js';
 import { Loss, ResourceStore } from '../core/ir/index.js';
 import { PdfImage } from './images.js';
 import { PdfPage } from './document.js';
 import { PdfVector } from './vector.js';
+import { TextMarkup } from './annot-draw.js';
+import { TextRun } from './content.js';
 /**
  * A reconstruction's document plus the losses incurred reading it (e.g. an
  * undecodable image colour space) — surfaced through the reader's `LossReport`.
@@ -49,6 +51,14 @@ export interface TextSpan {
     readonly bold?: boolean;
     /** §9.8.1 — the face was a slanted one. */
     readonly italic?: boolean;
+    /**
+     * §17.3.2.42 — the glyphs stood OFF the baseline the line is set on, and
+     * smaller: a footnote mark, an exponent, an index. The page states it by
+     * placement, and a document by the property.
+     */
+    readonly script?: 'superscript' | 'subscript';
+    /** §12.5.6.10 — a text-markup annotation marks these words. */
+    readonly markup?: TextMarkup;
 }
 /**
  * Build a paragraph {@link BodyElement} from positioned {@link TextSpan}s,
@@ -56,13 +66,13 @@ export interface TextSpan {
  * survives as its own run) and squashing whitespace. With no hrefs this
  * collapses to a single run — the same shape {@link paragraphBlock} produces.
  */
-export declare function paragraphFromRuns(spans: ReadonlyArray<TextSpan>, outlineLevel?: number): BodyElement;
+export declare function paragraphFromRuns(spans: ReadonlyArray<TextSpan>, outlineLevel?: number, placement?: Pick<ParagraphProperties, 'alignment' | 'spacingBefore' | 'indentLeft' | 'indentFirstLine'>): BodyElement;
 /**
  * Store a {@link PdfImage}'s bytes (content-addressed dedup) and build the image
  * {@link BodyElement} that references them, sized in points from the placement
  * CTM. `alt` becomes the block's alt text when given.
  */
-export declare function imageBlock(image: PdfImage, resources: ResourceStore, alt?: string, frame?: PageFrame, zOrder?: number): BodyElement;
+export declare function imageBlock(image: PdfImage, resources: ResourceStore, alt?: string, frame?: PageFrame, zOrder?: number, behind?: boolean): BodyElement;
 /**
  * A line of text as an anchored box, standing where the page set it.
  *
@@ -100,7 +110,7 @@ export declare function dedupeLosses(losses: ReadonlyArray<Loss>): Array<Loss>;
  * a paragraph: 22060_A1_01_Plans.pdf is one A3 sheet of vectors, and stacking
  * its forty-nine paths one under another spilled it onto a second page.
  */
-export declare function shapeBlock(v: PdfVector, frame?: PageFrame, zOrder?: number): BodyElement;
+export declare function shapeBlock(v: PdfVector, frame?: PageFrame, zOrder?: number, behind?: boolean): BodyElement;
 /**
  * Derive the {@link SectionProperties} geometry from the source pages so a
  * reconstructed PDF re-renders at its real page size and orientation rather than
@@ -113,6 +123,10 @@ export declare function shapeBlock(v: PdfVector, frame?: PageFrame, zOrder?: num
  * `A4`. Returns `undefined` when there is no usable first-page box.
  */
 export declare function sectionFromPdfPages(pages: ReadonlyArray<PdfPage>): SectionProperties | undefined;
+export declare function withMeasuredMargins(section: SectionProperties | undefined, shown: ReadonlyArray<{
+    width: number;
+    height: number;
+}>, pageRuns: ReadonlyArray<ReadonlyArray<TextRun>>): SectionProperties | undefined;
 /**
  * Assemble the final {@link FlowDoc} for a reconstruction: the body elements
  * with their styles resolved against the empty style sheet, the lifted-image
@@ -120,4 +134,4 @@ export declare function sectionFromPdfPages(pages: ReadonlyArray<PdfPage>): Sect
  * both reconstruction paths (the tagged fast-path EP3 and the heuristic layout
  * path EP4).
  */
-export declare function buildFlowDoc(body: ReadonlyArray<BodyElement>, resources?: ResourceStore, section?: SectionProperties, embeddedFonts?: ReadonlyMap<string, FontRegistry>): FlowDoc;
+export declare function buildFlowDoc(body: ReadonlyArray<BodyElement>, resources?: ResourceStore, section?: SectionProperties, embeddedFonts?: ReadonlyMap<string, FontRegistry>, sections?: ReadonlyArray<Section>, headersFooters?: ReadonlyMap<string, ReadonlyArray<BodyElement>>): FlowDoc;