reamkit 1.32.1 → 1.33.1

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

@@ -161,12 +161,14 @@ function parseProgram(bytes) {
 			const tok = lexer.nextToken();
 			if (tok.kind === "eof") return depth === 0 ? out : void 0;
 			if (tok.kind === "num") out.push(tok.value);
-			else if (tok.kind === "keyword") if (tok.value === "{") {
-				const inner = read(depth + 1);
-				if (!inner) return void 0;
-				out.push(inner);
-			} else if (tok.value === "}") return out;
-			else out.push(tok.value);
+			else if (tok.kind === "keyword") {
+				if (tok.value === "{") {
+					const inner = read(depth + 1);
+					if (!inner) return void 0;
+					out.push(inner);
+				} else if (tok.value === "}") return out;
+				else out.push(tok.value);
+			}
 		}
 	};
 	const top = read(0);
@@ -380,7 +382,6 @@ function run(program, stack, depth) {
 				}
 				break;
 			}
-			default: break;
 		}
 	}
 }

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

@@ -71,7 +71,7 @@ function tagTable(data, view) {
 	if (count === 0 || count > MAX_TAGS) return void 0;
 	const out = /* @__PURE__ */ new Map();
 	for (let i = 0; i < count; i++) {
-		const at = HEADER_SIZE + 4 + i * 12;
+		const at = 132 + i * 12;
 		if (at + 12 > data.length) break;
 		const offset = view.getUint32(at + 4);
 		const size = view.getUint32(at + 8);

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

@@ -235,7 +235,7 @@ function clippedUnitBox(ctm, clip) {
 		v1: Math.min(1, Math.max(0, v1))
 	};
 	if (!(cut.u1 - cut.u0 > CROPS) || !(cut.v1 - cut.v0 > CROPS)) return whole;
-	if (cut.u1 - cut.u0 > 1 - CROPS && cut.v1 - cut.v0 > 1 - CROPS) return whole;
+	if (cut.u1 - cut.u0 > .99 && cut.v1 - cut.v0 > .99) return whole;
 	return cut;
 }
 function matrixOf(file, dict) {

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

@@ -333,15 +333,16 @@ var MQDecoder = class {
 	}
 	/** BYTEIN (§E.3.4) — 0xFF is the marker escape, so it feeds a shorter byte. */
 	byteIn() {
-		if (this.byteAt(this.bp) === 255) if (this.byteAt(this.bp + 1) > 143) {
-			this.c = this.c + 65280 >>> 0;
-			this.ct = 8;
+		if (this.byteAt(this.bp) === 255) {
+			if (this.byteAt(this.bp + 1) > 143) {
+				this.c = this.c + 65280 >>> 0;
+				this.ct = 8;
+			} else {
+				this.bp++;
+				this.c = this.c + (this.byteAt(this.bp) << 9) >>> 0;
+				this.ct = 7;
+			}
 		} else {
-			this.bp++;
-			this.c = this.c + (this.byteAt(this.bp) << 9) >>> 0;
-			this.ct = 7;
-		}
-		else {
 			this.bp++;
 			this.c = this.c + (this.byteAt(this.bp) << 8) >>> 0;
 			this.ct = 8;
@@ -359,17 +360,18 @@ var MQDecoder = class {
 		const [qe, nmps, nlps, sw] = QE[i] ?? QE[0];
 		let d;
 		this.a = this.a - qe & 65535;
-		if ((this.c >>> 16 & 65535) < qe) if (this.a < qe) {
-			this.a = qe;
-			d = mps;
-			i = nmps;
+		if ((this.c >>> 16 & 65535) < qe) {
+			if (this.a < qe) {
+				this.a = qe;
+				d = mps;
+				i = nmps;
+			} else {
+				this.a = qe;
+				d = 1 - mps;
+				if (sw === 1) mps = 1 - mps;
+				i = nlps;
+			}
 		} else {
-			this.a = qe;
-			d = 1 - mps;
-			if (sw === 1) mps = 1 - mps;
-			i = nlps;
-		}
-		else {
 			this.c = this.c - (qe << 16) >>> 0;
 			if ((this.a & 32768) !== 0) return mps;
 			if (this.a < qe) {
@@ -474,9 +476,7 @@ function decodeGenericRegion(mq, cx, width, height, template, at, tpgdon, skip)
 				case 2:
 					ctx = px(x - 1, y) << 0 | px(x - 2, y) << 1 | px(x + (a[0]?.x ?? 2), y + (a[0]?.y ?? -1)) << 2 | px(x + 1, y - 1) << 3 | px(x, y - 1) << 4 | px(x - 1, y - 1) << 5 | px(x - 2, y - 1) << 6 | px(x + 1, y - 2) << 7 | px(x, y - 2) << 8 | px(x - 1, y - 2) << 9;
 					break;
-				default:
-					ctx = px(x - 1, y) << 0 | px(x - 2, y) << 1 | px(x - 3, y) << 2 | px(x - 4, y) << 3 | px(x + (a[0]?.x ?? 2), y + (a[0]?.y ?? -1)) << 4 | px(x + 1, y - 1) << 5 | px(x, y - 1) << 6 | px(x - 1, y - 1) << 7 | px(x - 2, y - 1) << 8 | px(x - 3, y - 1) << 9;
-					break;
+				default: ctx = px(x - 1, y) << 0 | px(x - 2, y) << 1 | px(x - 3, y) << 2 | px(x - 4, y) << 3 | px(x + (a[0]?.x ?? 2), y + (a[0]?.y ?? -1)) << 4 | px(x + 1, y - 1) << 5 | px(x, y - 1) << 6 | px(x - 1, y - 1) << 7 | px(x - 2, y - 1) << 8 | px(x - 3, y - 1) << 9;
 			}
 			bmp.data[y * width + x] = mq.decode(cx, ctx);
 		}
@@ -669,6 +669,7 @@ function buildHuffTable(lines) {
 }
 /** A most-significant-bit-first reader over a segment's data. */
 var BitReader = class {
+	d;
 	pos = 0;
 	bit = 0;
 	constructor(d) {
@@ -1755,6 +1756,7 @@ var OOB = Symbol("OOB");
 * needs a context set of its own.
 */
 var IntDecoder = class {
+	mq;
 	cx = newContexts(512);
 	constructor(mq) {
 		this.mq = mq;
@@ -1787,6 +1789,8 @@ var IntDecoder = class {
 };
 /** §A.3 — the symbol ID decoder, a fixed-width code down its own context tree. */
 var IdDecoder = class {
+	mq;
+	codeLen;
 	cx;
 	constructor(mq, codeLen) {
 		this.mq = mq;
@@ -1799,14 +1803,6 @@ var IdDecoder = class {
 		return prev - (1 << this.codeLen);
 	}
 };
-/** How a text region places each instance against the point it names (§6.4.5). */
-var Corner = /* @__PURE__ */ function(Corner) {
-	Corner[Corner["BottomLeft"] = 0] = "BottomLeft";
-	Corner[Corner["TopLeft"] = 1] = "TopLeft";
-	Corner[Corner["BottomRight"] = 2] = "BottomRight";
-	Corner[Corner["TopRight"] = 3] = "TopRight";
-	return Corner;
-}(Corner || {});
 /**
 * §6.4.5 — draw a text region: a run of strips, each holding instances of the
 * symbols in `symbols`, placed by running coordinates rather than absolute ones.
@@ -1875,12 +1871,12 @@ function decodeTextRegion(mq, symbols, p, stripsLog, lent) {
 			if (p.transposed) {
 				x = tt;
 				y = curS;
-				if (p.refCorner === Corner.BottomLeft || p.refCorner === Corner.BottomRight) {}
-				if (p.refCorner === Corner.TopRight || p.refCorner === Corner.BottomRight) x = tt - sw + 1;
+				if (p.refCorner === 0 || p.refCorner === 2) {}
+				if (p.refCorner === 3 || p.refCorner === 2) x = tt - sw + 1;
 			} else {
 				x = curS;
 				y = tt;
-				if (p.refCorner === Corner.BottomLeft || p.refCorner === Corner.BottomRight) y = tt - sh + 1;
+				if (p.refCorner === 0 || p.refCorner === 2) y = tt - sh + 1;
 			}
 			compose(bmp, sym, x, y, p.combOp);
 			curS += (p.transposed ? sh : sw) - 1;
@@ -1959,7 +1955,7 @@ function decodeSymbolDictionary(mq, input, newCount, exportCount, template, at,
 						height,
 						instances,
 						stripT: 0,
-						refCorner: Corner.TopLeft,
+						refCorner: 1,
 						transposed: false,
 						combOp: 0,
 						defPixel: 0,
@@ -2069,11 +2065,11 @@ function decodeTextRegionHuff(bits, data, symbols, p, stripsLog, t) {
 			if (p.transposed) {
 				x = tt;
 				y = curS;
-				if (p.refCorner === Corner.TopRight || p.refCorner === Corner.BottomRight) x = tt - sw + 1;
+				if (p.refCorner === 3 || p.refCorner === 2) x = tt - sw + 1;
 			} else {
 				x = curS;
 				y = tt;
-				if (p.refCorner === Corner.BottomLeft || p.refCorner === Corner.BottomRight) y = tt - sh + 1;
+				if (p.refCorner === 0 || p.refCorner === 2) y = tt - sh + 1;
 			}
 			compose(bmp, sym, x, y, p.combOp);
 			curS += (p.transposed ? sh : sw) - 1;
@@ -2114,7 +2110,7 @@ function aggregateSymbolHuff(bits, data, symbols, width, height, codeLen, refine
 			height,
 			instances: Math.max(1, instances),
 			stripT: 0,
-			refCorner: Corner.TopLeft,
+			refCorner: 1,
 			transposed: false,
 			combOp: 0,
 			defPixel: 0,
@@ -2307,6 +2303,7 @@ function decodeGrayScale(mq, data, mmr, template, at, width, height, bits, skip)
 	return values;
 }
 var Reader = class {
+	d;
 	pos = 0;
 	constructor(d) {
 		this.d = d;
@@ -2462,7 +2459,8 @@ function decodeJbig2(data, globals, width, height) {
 					const flags = r.u8();
 					page.defPixel = flags >> 2 & 1;
 					page.defCombOp = flags >> 3 & 3;
-					page.striped = (r.u16() & 32768) !== 0;
+					const striping = r.u16();
+					page.striped = (striping & 32768) !== 0;
 					if (pw > 0 && pw !== 4294967295 && ph > 0 && ph !== 4294967295) {
 						page.width = Math.min(pw, width);
 						page.height = Math.min(ph, height);
@@ -2750,4 +2748,4 @@ function decodeJbig2(data, globals, width, height) {
 	return packed;
 }
 //#endregion
-export { decodeJbig2 };
+export { MQDecoder, decodeGenericRegion, decodeJbig2, decodeRefinement, newContexts, startingContexts, symbolCodeLength };

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

@@ -138,7 +138,6 @@ function decode(bytes) {
 				p = decodeScan(bytes, segEnd, frame, scanComps, dcTables, acTables, quant, restartInterval);
 				continue;
 			}
-			default: break;
 		}
 		p = segEnd;
 	}
@@ -172,7 +171,7 @@ function readFrame(bytes, p) {
 			pred: 0,
 			blocksPerLine: 0,
 			blocksPerCol: 0,
-			plane: new Uint8ClampedArray(0),
+			plane: /* @__PURE__ */ new Uint8ClampedArray(0),
 			stride: 0
 		});
 	}
@@ -211,7 +210,7 @@ function readQuantTables(bytes, p, end, into) {
 		const pq = bytes[p] >> 4;
 		const tq = bytes[p] & 15;
 		p++;
-		const table = new Int32Array(64);
+		const table = /* @__PURE__ */ new Int32Array(64);
 		for (let i = 0; i < 64; i++) table[ZIGZAG[i]] = pq === 0 ? bytes[p + i] : be16(bytes, p + i * 2);
 		p += pq === 0 ? 64 : 128;
 		into[tq] = table;
@@ -235,9 +234,9 @@ function readHuffTables(bytes, p, end, dc, ac) {
 }
 /** §F.2.2.3 — the decoding tables, built from BITS and HUFFVAL. */
 function buildHuffTable(counts, values) {
-	const maxcode = new Int32Array(18).fill(-1);
-	const mincode = new Int32Array(18);
-	const valptr = new Int32Array(18);
+	const maxcode = (/* @__PURE__ */ new Int32Array(18)).fill(-1);
+	const mincode = /* @__PURE__ */ new Int32Array(18);
+	const valptr = /* @__PURE__ */ new Int32Array(18);
 	let code = 0;
 	let k = 0;
 	for (let l = 1; l <= 16; l++) {
@@ -271,10 +270,12 @@ function decodeScan(bytes, start, frame, scan, dcTables, acTables, quant, restar
 	const nextBit = () => {
 		if (bitCount === 0) {
 			let b = bytes[at++] ?? 0;
-			if (b === 255) if ((bytes[at] ?? 0) === 0) at++;
-			else {
-				at--;
-				b = 0;
+			if (b === 255) {
+				if ((bytes[at] ?? 0) === 0) at++;
+				else {
+					at--;
+					b = 0;
+				}
 			}
 			bitBuf = b;
 			bitCount = 8;
@@ -299,7 +300,7 @@ function decodeScan(bytes, start, frame, scan, dcTables, acTables, quant, restar
 		for (let i = 0; i < s; i++) v = v << 1 | nextBit();
 		return v < 1 << s - 1 ? v - (1 << s) + 1 : v;
 	};
-	const block = new Int32Array(64);
+	const block = /* @__PURE__ */ new Int32Array(64);
 	const decodeBlock = (comp, row, col) => {
 		block.fill(0);
 		const q = quant[comp.tq];
@@ -352,7 +353,7 @@ function decodeScan(bytes, start, frame, scan, dcTables, acTables, quant, restar
 }
 /** §A.3.3 — cos((2x+1)uπ/16) · C(u)/2, precomputed. */
 var COS = (() => {
-	const t = new Float32Array(64);
+	const t = /* @__PURE__ */ new Float32Array(64);
 	for (let u = 0; u < 8; u++) {
 		const c = u === 0 ? Math.SQRT1_2 : 1;
 		for (let x = 0; x < 8; x++) t[u * 8 + x] = c * Math.cos((2 * x + 1) * u * Math.PI / 16) / 2;
@@ -361,7 +362,7 @@ var COS = (() => {
 })();
 /** The separable 2-D inverse DCT of one block, levelshifted into `out`. */
 function idctBlock(block, out, offset, stride) {
-	const rows = new Float32Array(64);
+	const rows = /* @__PURE__ */ new Float32Array(64);
 	for (let y = 0; y < 8; y++) for (let x = 0; x < 8; x++) {
 		let sum = 0;
 		for (let u = 0; u < 8; u++) sum += COS[u * 8 + x] * block[y * 8 + u];

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

@@ -65,12 +65,13 @@ function reconstructByLayout(file, mode = "flow") {
 	const art = pages.map((page, i) => {
 		const raw = collectPageImages(file, page);
 		const images = placeImages(raw.images, shown[i]);
-		const lifted = collectPageVectors(file, page, images.map((img) => ({
+		const covered = images.map((img) => ({
 			minX: img.x,
 			minY: img.y,
 			maxX: img.x + img.widthPt,
 			maxY: img.y + img.heightPt
-		})));
+		}));
+		const lifted = collectPageVectors(file, page, covered);
 		return {
 			images,
 			imageLosses: raw.losses,
@@ -252,7 +253,8 @@ function reconstructByLayout(file, mode = "flow") {
 		};
 		/** A figure's parts in the order the page painted them, its words over its drawing. */
 		const figureMembers = (figure) => {
-			const drawn = [...joinLetters([...figure.vectors].sort((a, b) => compareOrder(a.orderKey, b.orderKey))).map((v) => ({
+			const painted = [...figure.vectors].sort((a, b) => compareOrder(a.orderKey, b.orderKey));
+			const drawn = [...joinLetters(painted).map((v) => ({
 				key: v.orderKey,
 				member: vectorMember(v)
 			})), ...figure.images.map((img) => ({
@@ -366,7 +368,7 @@ function reconstructByLayout(file, mode = "flow") {
 			if (cells.some((c) => c.lines.length === 0)) return void 0;
 			const top = Math.max(...cells.map((c) => c.lines[0].y));
 			const edge = above ?? {
-				y: Math.max(...cells.map((c) => c.lines[0].y + .8 * 1.2 * c.lines[0].fontSize)),
+				y: Math.max(...cells.map((c) => c.lines[0].y + .96 * c.lines[0].fontSize)),
 				lineHeight: 0
 			};
 			const starts = cells.map((c, k) => k === 0 ? left : c.cell.from);
@@ -1850,7 +1852,7 @@ function continuesLeader(prev, run, fontSize) {
 	const dots = prev.text.endsWith(".") && run.text.startsWith(".");
 	return (isLeader(prev.text) && prev.text === run.text || dots) && run.x - prev.endX < (run.fontSizePt || fontSize) * CELL_GAP_EM;
 }
-var LEADER_CHARS = new Set([
+var LEADER_CHARS = /* @__PURE__ */ new Set([
 	".",
 	"·",
 	"_",
@@ -2332,13 +2334,13 @@ function joinLines(lines) {
 /** §17.3.3.29 — the hyphen that is a PLACE a word may break, not a hyphen. */
 var SOFT_HYPHEN = "­";
 /** The hyphens that belong to the word they end. */
-var HYPHENS = new Set([
+var HYPHENS = /* @__PURE__ */ new Set([
 	"-",
 	"‐",
 	"‑"
 ]);
 /** The dashes, en and em, that belong to the words either side where closed up to them. */
-var DASHES = new Set(["–", "—"]);
+var DASHES = /* @__PURE__ */ new Set(["–", "—"]);
 /** How many lines' worth of indent still reads as a first line, not a placement. */
 var INDENT_LINES = 3;
 /** Where in the run of line starts the column's own left edge is looked for. */
@@ -3917,8 +3919,9 @@ function tableFrom(runs, gutters, edges, stepped) {
 	};
 	return [...above.map((row) => {
 		const y = Math.max(...row.map((r) => r.y));
+		const size = Math.max(...row.map((r) => r.fontSizePt || fontSize));
 		return {
-			el: paragraphFromRuns(lineOf(row, y, Math.max(...row.map((r) => r.fontSizePt || fontSize)), stepped).spans),
+			el: paragraphFromRuns(lineOf(row, y, size, stepped).spans),
 			top: y
 		};
 	}), {
@@ -4002,4 +4005,4 @@ var TABLE_ALIGNED_SHARE = .6;
 */
 var TABLE_CELL_FILL = .65;
 //#endregion
-export { FOOTER_PART, HEADER_PART, endedParagraph, footerBand, numberedFrom, numberingOf, pageTextEdges, reconstructByLayout, runningFoot, stepsBetweenWords };
+export { EVEN_FOOTER_PART, FOOTER_PART, HEADER_PART, drawnWords, endedParagraph, footerBand, numberedFrom, numberingOf, pageTextEdges, reconstructByLayout, runningFoot, stepsBetweenWords };

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

@@ -21,6 +21,7 @@ function hexVal(b) {
 * read and assign it directly.
 */
 var Lexer = class {
+	buf;
 	pos;
 	/**
 	* @param buf The PDF byte buffer to tokenize.
@@ -306,4 +307,4 @@ function latin1(bytes) {
 	return s;
 }
 //#endregion
-export { Lexer };
+export { Lexer, latin1 };

package/dist/esm/pdf-reader/math-rows.js

@@ -1,6 +1,6 @@
 //#region src/pdf-reader/math-rows.ts
 /** The brackets a matrix may be written in, opening → closing. */
-var BRACKETS = new Map([
+var BRACKETS = /* @__PURE__ */ new Map([
 	["(", ")"],
 	["[", "]"],
 	["{", "}"],
@@ -94,7 +94,7 @@ function matrixFrom(cluster) {
 			endChr: pair.close.text.trim(),
 			children: [inside.matrix]
 		});
-		used = new Set([
+		used = /* @__PURE__ */ new Set([
 			...used,
 			...inside.used,
 			pair.open,

package/dist/esm/pdf-reader/optional-content.js

@@ -90,4 +90,4 @@ function asArray(file, value) {
 	return r.slice(0, MAX_GROUPS).map((v) => file.resolve(v));
 }
 //#endregion
-export { hiddenProperties, hiddenXObject };
+export { hiddenByOc, hiddenGroups, hiddenProperties, hiddenXObject };

package/dist/esm/pdf-reader/page-numbers.js

@@ -164,4 +164,4 @@ function runOf(runs, page) {
 	return found;
 }
 //#endregion
-export { pageNumberingOf, runOf };
+export { numeralsIn, pageNumberingOf, runOf };

package/dist/esm/pdf-reader/pattern-tint.js

@@ -106,7 +106,7 @@ function sample(marks, cell) {
 			if (flat.some((m) => covers(m, px, py))) hit++;
 		}
 	}
-	return hit / (GRID * GRID);
+	return hit / 2304;
 }
 /** Whether one mark paints the point — inside its outline, or under its pen. */
 function covers(mark, px, py) {
@@ -182,7 +182,6 @@ function flatten(segs) {
 			]);
 			cx = sx;
 			cy = sy;
-			break;
 	}
 	return out;
 }

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

@@ -14,11 +14,15 @@ import { FlowDoc } from '../core/ir/flow.js';
  * @param filters  Decoders for `/Filter` names this reader does not implement
  *                 (§7.4); see {@link StreamFilters}.
  * @returns The reconstructed FlowDoc and its accumulated {@link Loss} report.
+ * @throws WrongPasswordError when the file is encrypted and the password opens
+ *         it neither as its user nor as its owner — none given included.
  *
  * Which of the two readings a file gets is the FILE's to decide and no
  * caller's: a page that is mostly marks is reproduced where it stands, one
  * that is mostly lines is re-set as a document, and the reader records which
- * it chose. There is no override — see the note on {@link readingOf}.
+ * it chose. There is no override — see the note on {@link readingOf}. A file
+ * kept as a page also carries its `flowing` reading, for the one medium that
+ * can keep no page: see {@link ReadResult.flowing}.
  */
 export declare function readPdf(bytes: Uint8Array, password?: string, filters?: StreamFilters): ReadResult<FlowDoc>;
 /**

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

@@ -4,6 +4,7 @@ import { extractPageText } from "./text.js";
 import { collectPageVectors } from "./vector.js";
 import { reconstructByLayout } from "./layout.js";
 import { reconstructTaggedPdf } from "./tagged.js";
+import { WrongPasswordError } from "../core/crypto/password-error.js";
 //#region src/pdf-reader/reader.ts
 function sniffPdf(bytes) {
 	const limit = Math.min(bytes.length - 5, 1024);
@@ -41,30 +42,53 @@ function endsLikePdf(bytes) {
 * @param filters  Decoders for `/Filter` names this reader does not implement
 *                 (§7.4); see {@link StreamFilters}.
 * @returns The reconstructed FlowDoc and its accumulated {@link Loss} report.
+* @throws WrongPasswordError when the file is encrypted and the password opens
+*         it neither as its user nor as its owner — none given included.
 *
 * Which of the two readings a file gets is the FILE's to decide and no
 * caller's: a page that is mostly marks is reproduced where it stands, one
 * that is mostly lines is re-set as a document, and the reader records which
-* it chose. There is no override — see the note on {@link readingOf}.
+* it chose. There is no override — see the note on {@link readingOf}. A file
+* kept as a page also carries its `flowing` reading, for the one medium that
+* can keep no page: see {@link ReadResult.flowing}.
 */
 function readPdf(bytes, password = "", filters = {}) {
 	const file = PdfFile.parse(bytes, password, filters);
+	if (file.passwordRefused) throw new WrongPasswordError(password === "" ? "This PDF needs a password to open — pass it as `password`" : "The password opens this PDF neither as its user nor as its owner");
+	const { reading, forText } = readingOf(file);
+	const read = readAs(file, reading);
+	if (!forText) return read;
+	return {
+		...read,
+		flowing: () => readAs(PdfFile.parse(bytes, password, filters), "flow", true)
+	};
+}
+/**
+* The file read the one way: the losses every reading reports, the reading's
+* own, and its reconstruction.
+*
+* @param file     The parsed file.
+* @param reading  Whether the words re-set as a document or stand where drawn.
+* @param reflowed Whether this is the flowing reading of a file the reader
+*                 keeps as a page, for a medium that places nothing.
+* @returns The reconstructed FlowDoc and its losses.
+*/
+function readAs(file, reading, reflowed = false) {
 	const losses = [];
 	if (file.encryptionUnsupported) losses.push({
 		severity: "dropped",
 		feature: FEATURES.text,
-		detail: "encrypted PDF — the user password was missing or incorrect, or the handler is unsupported"
+		detail: "encrypted PDF — its security handler is not supported, or its /Encrypt dictionary cannot be read, so its content cannot be decrypted"
 	});
 	for (const name of file.unknownFilters) losses.push({
 		severity: "dropped",
 		feature: FEATURES.text,
 		detail: `PDF stream filter /${name} is not supported; streams using it are unreadable`
 	});
-	const reading = readingOf(file);
 	losses.push({
 		severity: "degraded",
 		feature: FEATURES.text,
-		detail: reading === "positional" ? "PDF read as a PAGE (placed): its artwork outweighs its prose, so every line stands where its glyphs stand" : "PDF read as a DOCUMENT (flowing): its prose outweighs its artwork, so the words re-set and the artwork takes its turn in reading order"
+		detail: reflowed ? "PDF read as a DOCUMENT (flowing) for a medium that keeps only the text: the file is kept as a PAGE elsewhere for its drawn letters or its rules, which only a page can show where they stand" : reading === "positional" ? "PDF read as a PAGE (placed): its artwork outweighs its prose, so every line stands where its glyphs stand" : "PDF read as a DOCUMENT (flowing): its prose outweighs its artwork, so the words re-set and the artwork takes its turn in reading order"
 	});
 	const tagged = reading === "positional" ? void 0 : reconstructTaggedPdf(file);
 	const reconstruction = tagged ?? reconstructByLayout(file, reading);
@@ -94,7 +118,12 @@ function readPdf(bytes, password = "", filters = {}) {
 * folded into a report does not make the report a plan.
 *
 * A threshold is a guess, and this one is stated rather than hidden: the reader
-* records which reading it took and why, and the caller can name the other.
+* records which reading it took and why.
+*
+* A glyph the file names no character for is drawn, and counted as a mark like
+* any other path — it IS one, for every medium that has to place it; so is a
+* rule. Whether the page was a page for those alone is said as well: see
+* `forText`.
 */
 function readingOf(file) {
 	/**
@@ -112,14 +141,28 @@ function readingOf(file) {
 	const DRAWN = 2;
 	/** Below this many runs, an angle is a stamp or a watermark and not the page. */
 	const ENOUGH_TURNED = 8;
+	/**
+	* How many rules a page may have for each mark of other artwork and still be
+	* a ruled document: an estimate shades its heading row and its total, and a
+	* dozen shaded cells under eighty rules are a table's, not a drawing's.
+	*/
+	const RULES_PER_MARK = 4;
 	const ratios = [];
+	/** The same, the drawn letters left out. */
+	const artwork = [];
+	const ratioOf = (marks, lines) => marks < ENOUGH_MARKS ? 0 : lines > 0 ? marks / lines : DRAWN;
 	for (const page of file.pages()) {
 		let marks = 0;
+		let letters = 0;
+		let rules = 0;
 		let lines = 0;
 		let turned = 0;
 		let runs = 0;
 		try {
-			marks = collectPageVectors(file, page, []).vectors.length;
+			const vectors = collectPageVectors(file, page, []).vectors;
+			marks = vectors.length;
+			letters = vectors.filter((v) => v.glyph === true).length;
+			rules = vectors.filter(isRule).length;
 			const ys = /* @__PURE__ */ new Set();
 			for (const run of extractPageText(file, page)) {
 				ys.add(Math.round(run.y));
@@ -132,17 +175,41 @@ function readingOf(file) {
 		}
 		if (runs >= ENOUGH_TURNED && turned > runs * .5) {
 			ratios.push(DRAWN);
+			artwork.push(DRAWN);
 			continue;
 		}
-		if (marks < ENOUGH_MARKS) {
-			ratios.push(0);
-			continue;
-		}
-		ratios.push(lines > 0 ? marks / lines : DRAWN);
+		ratios.push(ratioOf(marks, lines));
+		const ruled = lines > 0 && marks - letters - rules < Math.max(ENOUGH_MARKS, rules / RULES_PER_MARK);
+		artwork.push(ruled ? 0 : ratioOf(marks - letters, lines));
 	}
-	if (ratios.length === 0) return "flow";
-	const sorted = [...ratios].sort((a, b) => a - b);
-	return (sorted[Math.floor(sorted.length / 2)] ?? 0) >= DRAWN ? "positional" : "flow";
+	const drawn = (rs) => {
+		const sorted = [...rs].sort((a, b) => a - b);
+		return (sorted[Math.floor(sorted.length / 2)] ?? 0) >= DRAWN;
+	};
+	if (!drawn(ratios)) return {
+		reading: "flow",
+		forText: false
+	};
+	return {
+		reading: "positional",
+		forText: !drawn(artwork)
+	};
+}
+/** Thinner than this a straight mark is a line, whatever it was drawn as. */
+var RULE_THICKNESS = 2.5;
+/** …and it is a rule rather than a dot or a tick from this long. */
+var RULE_LENGTH = 4;
+/**
+* Whether a painted path is a RULE: straight, along the page, a line thin
+* enough to be one — stroked as a line or filled as a hairline box, which is
+* how many producers draw a table's grid.
+*/
+function isRule(v) {
+	if (v.glyph === true || v.gradient !== void 0) return false;
+	if (v.segs.some((seg) => seg.op === "cubic")) return false;
+	const w = v.maxX - v.minX;
+	const h = v.maxY - v.minY;
+	return Math.min(w, h) <= RULE_THICKNESS && Math.max(w, h) >= RULE_LENGTH;
 }
 /**
 * The `pdfReader` adapter: a {@link DocumentReader} that sniffs the `%PDF-`
@@ -151,7 +218,7 @@ function readingOf(file) {
 var pdfReader = {
 	id: "pdf",
 	produces: "flow",
-	supports: new Set([
+	supports: /* @__PURE__ */ new Set([
 		FEATURES.text,
 		FEATURES.tables,
 		FEATURES.lists,
@@ -165,4 +232,4 @@ function isFilters(value) {
 	return typeof value === "object" && value !== null;
 }
 //#endregion
-export { pdfReader };
+export { pdfReader, readPdf };

package/dist/esm/pdf-reader/struct-tree.js

@@ -123,7 +123,7 @@ function allMcids(node) {
 * `Sub`), a formula (§14.8.4.5.5, which is set in a line as often as out of
 * one), and a list label, which is the start of its item's line.
 */
-var INLINE = new Set([
+var INLINE = /* @__PURE__ */ new Set([
 	"Span",
 	"Quote",
 	"Reference",

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

@@ -43,12 +43,13 @@ function reconstructTaggedPdf(file) {
 	const placedRuns = turned ? extracted.map((runs, i) => placeRuns(runs, shown[i])) : onSheets;
 	const vectorLosses = [];
 	const pageVectors = pages.map((page, i) => {
-		const lifted = collectPageVectors(file, page, collectPageImages(file, page).images.map((img) => ({
+		const covered = collectPageImages(file, page).images.map((img) => ({
 			minX: img.x,
 			minY: img.y,
 			maxX: img.x + img.widthPt,
 			maxY: img.y + img.heightPt
-		})));
+		}));
+		const lifted = collectPageVectors(file, page, covered);
 		vectorLosses.push(...lifted.losses);
 		return placeVectors(lifted.vectors, shown[i]);
 	});