reamkit 1.21.0 → 1.23.0

package/dist/esm/core/ole/escher-blip.js

@@ -0,0 +1,88 @@
+import { unzlibSync } from "fflate";
+//#region src/core/ole/escher-blip.ts
+var BLIP_EMF = 61466;
+var BLIP_WMF = 61467;
+var BLIP_PICT = 61468;
+var BLIP_JPEG = 61469;
+var BLIP_PNG = 61470;
+var BLIP_DIB = 61471;
+var BLIP_TIFF = 61481;
+var BLIP_JPEG_CMYK = 61482;
+var METAFILE_HEADER_BYTES = 34;
+var COMPRESSION_DEFLATE = 0;
+var TWO_UID_INSTANCES = new Set([
+	981,
+	535,
+	1347,
+	1761,
+	1763,
+	1961,
+	1765,
+	481
+]);
+/** The signatures of the rasters a blip may hold, for the scan fallback. */
+var RASTER_MAGICS = [
+	[
+		137,
+		80,
+		78,
+		71
+	],
+	[
+		255,
+		216,
+		255
+	],
+	[
+		71,
+		73,
+		70,
+		56
+	],
+	[66, 77]
+];
+/**
+* The picture bytes inside one Escher BLIP record — a raster as it stands, or a
+* metafile unpacked out of its header.
+*
+* @param type     The blip record type (`0xF01A`…`0xF02A`).
+* @param instance The record's `recInstance`, which says how many UIDs precede
+*                 the payload.
+* @param data     The record's body, without the 8-byte header.
+* @returns The bytes to hand the renderer, or `undefined` when the blip holds
+*          nothing this can read.
+*/
+function readEscherBlip(type, instance, data) {
+	if (type === BLIP_EMF || type === BLIP_WMF || type === BLIP_PICT) return readMetafileBlip(instance, data);
+	if (type === BLIP_JPEG || type === BLIP_PNG || type === BLIP_DIB || type === BLIP_TIFF || type === BLIP_JPEG_CMYK) return scanRaster(data);
+	return scanRaster(data);
+}
+function readMetafileBlip(instance, data) {
+	const uidBytes = TWO_UID_INSTANCES.has(instance) ? 32 : 16;
+	const head = uidBytes + METAFILE_HEADER_BYTES;
+	if (data.length < head) return void 0;
+	const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+	const uncompressed = view.getUint32(uidBytes, true);
+	const compressed = view.getUint32(uidBytes + 24, true);
+	const compression = data[uidBytes + 32];
+	const payload = data.subarray(head, Math.min(data.length, head + (compressed || Infinity)));
+	if (payload.length === 0) return void 0;
+	if (compression !== COMPRESSION_DEFLATE) return payload;
+	try {
+		const out = unzlibSync(payload, uncompressed > 0 ? { out: new Uint8Array(uncompressed) } : {});
+		return out.length > 0 ? out : void 0;
+	} catch {
+		return;
+	}
+}
+function scanRaster(data) {
+	const limit = Math.min(data.length, 80);
+	for (let off = 0; off < limit; off++) for (const magic of RASTER_MAGICS) if (matches(data, off, magic)) return data.subarray(off);
+}
+function matches(d, off, magic) {
+	if (off + magic.length > d.length) return false;
+	for (let i = 0; i < magic.length; i++) if (d[off + i] !== magic[i]) return false;
+	return true;
+}
+//#endregion
+export { readEscherBlip };

package/dist/esm/{pdf-reader → core}/png-encode.js

@@ -1,5 +1,5 @@
 import { zlibSync } from "fflate";
-//#region src/pdf-reader/png-encode.ts
+//#region src/core/png-encode.ts
 var COLOR_TYPE = {
 	gray: 0,
 	rgb: 2,

package/dist/esm/core/vector.d.ts

@@ -49,6 +49,11 @@ export interface GradientStop {
     readonly offset: number;
     /** Stop colour as 6-hex, no leading `#`. */
     readonly colorHex: string;
+    /**
+     * §20.1.2.3.1 `a:alpha` — how opaque THIS stop is, `0..1`; absent is opaque.
+     * The colour beside it is the stop's own, not composited over the paper.
+     */
+    readonly alpha?: number;
 }
 /**
  * A gradient fill — the format-agnostic vocabulary shared by the shape model

package/dist/esm/excel/print-model.js

@@ -101,7 +101,8 @@ var DIGIT_EM = [
 	[/^(arial|helvetica|liberation sans|arimo|arial unicode ms)$/i, 1139 / 2048],
 	[/^(times new roman|liberation serif|tinos)$/i, 1024 / 2048],
 	[/^(tahoma)$/i, 1118 / 2048],
-	[/^(verdana|dejavu sans)$/i, 1303 / 2048]
+	[/^(verdana|dejavu sans)$/i, 1303 / 2048],
+	[/* @__PURE__ */ new RegExp("^(新細明體|細明體|pmingliu|mingliu|標楷體|dfkai-sb|宋体|新宋体|simsun|nsimsun|黑体|simhei|微软雅黑|microsoft yahei|微軟正黑體|microsoft jhenghei|ＭＳ [Ｐ]?明朝|ＭＳ [Ｐ]?ゴシック|ms [p]?mincho|ms [p]?gothic|meiryo|メイリオ|游ゴシック|yu gothic|굴림체?|gulim(che)?|돋움체?|dotum(che)?|바탕체?|batang(che)?|맑은 고딕|malgun gothic)$", "iu"), 1024 / 2048]
 ];
 /**
 * §18.3.1.13 — the Maximum Digit Width, in twips, of the normal style's font.
@@ -1021,6 +1022,7 @@ function runPropsFromXf(xf, styles) {
 	if (font.strike) props.strike = true;
 	if (font.sizePt !== void 0) props.fontSizePt = halfPtToPt(Math.round(font.sizePt * 2));
 	if (font.colorHex) props.colorHex = font.colorHex;
+	if (font.name) props.fontFamily = { ascii: font.name };
 	return props;
 }
 function stackedVerticalContent(text, runProps, href) {

package/dist/esm/excel/sheet-shape-parser.js

@@ -1,6 +1,6 @@
 import { emuToPt, pt } from "../core/ir/units.js";
 import { poAttr, poChildren, poFirstChild, poIntAttr, poIs, poTag, poText } from "../core/po-helpers.js";
-import { applyColorMods, resolveColorNode } from "../core/drawingml/colors.js";
+import { placeholderColors, resolveColorNode } from "../core/drawingml/colors.js";
 import { parseFill, parseLine, parseShadow, parseXfrm, shadowFromOuterShdw } from "../word/drawing-parser.js";
 import { parseGeometry, parseTxBody } from "../pptx/slide-parser.js";
 import { parseXml } from "../pptx/pptx-reader.js";
@@ -387,17 +387,6 @@ function styleFill(sp, ns, colors, themeFillStyles) {
 	} : themed;
 }
 /**
-* §20.1.4.2.10 — inside a theme's style list, `phClr` stands for "the colour the
-* reference names". Every other colour resolves as it always did.
-*
-* @param colors The workbook's own resolver.
-* @param phHex  The colour the `a:fillRef` / `a:lnRef` carries.
-* @returns A resolver that answers `phClr` with that colour, transforms and all.
-*/
-function placeholderColors(colors, phHex) {
-	return (raw) => "scheme" in raw && raw.scheme === "phClr" ? applyColorMods(phHex, raw.mods ?? []) : colors(raw);
-}
-/**
 * The shadow `<xdr:style><a:effectRef>` names, if it names one.
 *
 * §20.1.4.2.8, the same mechanism as the fill and the outline beside it: a

package/dist/esm/excel/styles-parser.js

@@ -1,7 +1,7 @@
 import { INDEXED_COLORS } from "../core/indexed-colors.js";
 import { applyColorMods } from "../core/drawingml/colors.js";
-import { resolveInternalEntities } from "../core/opc/xml-entities.js";
 import { resolveAlternateContent } from "../core/opc/alternate-content.js";
+import { resolveInternalEntities } from "../core/opc/xml-entities.js";
 import { XMLParser } from "fast-xml-parser";
 //#region src/excel/styles-parser.ts
 var decoder = new TextDecoder("utf-8");

package/dist/esm/excel/xls/biff-reader.js

@@ -1,5 +1,6 @@
 import { pt } from "../../core/ir/units.js";
 import { ResourceStore } from "../../core/ir/resources.js";
+import { makeColWidthPt, makeRowHeightPt } from "../sheet-drawing.js";
 import { openCfb } from "../../core/ole/cfb.js";
 import { parseBiffChart } from "./biff-chart.js";
 import { buildBiffPalette, parseBiffStyles } from "./biff-styles.js";
@@ -333,7 +334,8 @@ function readSheet(wb, view, start, blips, resources, sharedStrings, chartData,
 		...pane ? { pane } : {}
 	};
 	const drawing = gatherDrawing(records, REC.MSODRAWING);
-	const images = drawing.length > 0 && blips.length > 0 ? buildImages(drawing, blips, resources) : [];
+	const place = anchorPlacer(grid);
+	const images = drawing.length > 0 && blips.length > 0 ? buildImages(drawing, blips, resources, place) : [];
 	const charts = [];
 	for (let i = 0; i < records.length; i++) {
 		if (records[i].type !== REC.BOF || readU16(records[i].data, 2) !== 32) continue;
@@ -361,7 +363,7 @@ function readSheet(wb, view, start, blips, resources, sharedStrings, chartData,
 		grid,
 		images,
 		charts,
-		shapes: drawing.length > 0 ? buildShapes(parseSheetShapes(drawing), gatherTxoTexts(records)) : [],
+		shapes: drawing.length > 0 ? buildShapes(parseSheetShapes(drawing), gatherTxoTexts(records), place) : [],
 		hyperlinks,
 		comments: parseComments(records)
 	};
@@ -1174,13 +1176,24 @@ function parseComments(records) {
 	}
 	return out;
 }
-function buildShapes(escherShapes, txoTexts) {
+function buildShapes(escherShapes, txoTexts, place) {
 	const out = [];
 	let textIdx = 0;
 	for (const s of escherShapes) {
 		const text = s.hasText ? txoTexts[textIdx++] ?? "" : "";
-		const { widthPt, heightPt } = anchorSize(s.anchor);
+		const { xPt, yPt, widthPt, heightPt } = place(s.anchor);
 		out.push({
+			float: {
+				wrap: "none",
+				posH: {
+					relativeFrom: "margin",
+					offsetPt: pt(xPt)
+				},
+				posV: {
+					relativeFrom: "margin",
+					offsetPt: pt(yPt)
+				}
+			},
 			width: pt(widthPt),
 			height: pt(heightPt),
 			geometry: {
@@ -1222,34 +1235,56 @@ function shapePreset(type) {
 		default: return "rect";
 	}
 }
-function buildImages(drawing, blips, resources) {
+function buildImages(drawing, blips, resources, place) {
 	const out = [];
 	for (const pic of parseSheetPictures(drawing)) {
 		const bytes = blips[pic.blipIndex - 1];
 		if (!bytes) continue;
-		const { widthPt, heightPt } = anchorSize(pic.anchor);
+		const { xPt, yPt, widthPt, heightPt } = place(pic.anchor);
 		out.push({
 			resourceId: resources.put(bytes),
 			widthPt,
-			heightPt
+			heightPt,
+			xPt,
+			yPt
 		});
 	}
 	return out;
 }
-function anchorSize(anchor) {
-	if (!anchor) return {
-		widthPt: 96,
-		heightPt: 72
+function anchorPlacer(grid) {
+	const colPt = makeColWidthPt(grid);
+	const rowPt = makeRowHeightPt(grid);
+	const before = (track) => {
+		const sums = [0];
+		return (index) => {
+			const n = Math.min(Math.max(Math.trunc(index), 0), MAX_ANCHOR_TRACKS);
+			while (sums.length <= n) sums.push(sums[sums.length - 1] + track(sums.length - 1));
+			return sums[n];
+		};
 	};
-	const DEFAULT_COL_PT = 48;
-	const DEFAULT_ROW_PT = 15;
-	const cols = anchor.col2 + anchor.dx2 / 1024 - (anchor.col1 + anchor.dx1 / 1024);
-	const rows = anchor.row2 + anchor.dy2 / 1024 - (anchor.row1 + anchor.dy1 / 1024);
-	return {
-		widthPt: Math.max(8, cols * DEFAULT_COL_PT),
-		heightPt: Math.max(8, rows * DEFAULT_ROW_PT)
+	const beforeCol = before(colPt);
+	const beforeRow = before(rowPt);
+	const at = (index, off, start, track) => start(index) + off / 1024 * track(index);
+	return (anchor) => {
+		if (!anchor) return {
+			xPt: 0,
+			yPt: 0,
+			widthPt: 96,
+			heightPt: 72
+		};
+		const x1 = at(anchor.col1, anchor.dx1, beforeCol, colPt);
+		const x2 = at(anchor.col2, anchor.dx2, beforeCol, colPt);
+		const y1 = at(anchor.row1, anchor.dy1, beforeRow, rowPt);
+		const y2 = at(anchor.row2, anchor.dy2, beforeRow, rowPt);
+		return {
+			xPt: x1,
+			yPt: y1,
+			widthPt: Math.max(1, x2 - x1),
+			heightPt: Math.max(1, y2 - y1)
+		};
 	};
 }
+var MAX_ANCHOR_TRACKS = 65536;
 function numCell(row, column, style, rawValue) {
 	return {
 		column,

package/dist/esm/excel/xls/biff-styles.d.ts

@@ -4,8 +4,11 @@ interface BiffRec {
     readonly data: Uint8Array;
 }
 /**
- * Build a palette-index → `"FFRRGGBB"` (8-hex ARGB, like the xlsx `rgb` attr)
- * resolver from the default 56-colour palette plus any `PALETTE` override.
+ * Build a palette-index → `"RRGGBB"` resolver from the default 56-colour palette
+ * plus any `PALETTE` override. Six hex digits, not the eight an xlsx `rgb`
+ * attribute carries: by the time styles are parsed the alpha is gone, and a
+ * colour that kept it was read from its first six characters — silver `C0C0C0`
+ * reaching the page as the pink `FFC0C0`.
  * `0x7FFF` / 64 / 65 are automatic or system colours → `undefined` (the renderer
  * default). Exported so the conditional-format reader (XLS-13) resolves its dxf
  * colours the same way.

package/dist/esm/excel/xls/biff-styles.js

@@ -116,8 +116,11 @@ var PALETTE56 = [
 	"333333"
 ];
 /**
-* Build a palette-index → `"FFRRGGBB"` (8-hex ARGB, like the xlsx `rgb` attr)
-* resolver from the default 56-colour palette plus any `PALETTE` override.
+* Build a palette-index → `"RRGGBB"` resolver from the default 56-colour palette
+* plus any `PALETTE` override. Six hex digits, not the eight an xlsx `rgb`
+* attribute carries: by the time styles are parsed the alpha is gone, and a
+* colour that kept it was read from its first six characters — silver `C0C0C0`
+* reaching the page as the pink `FFC0C0`.
 * `0x7FFF` / 64 / 65 are automatic or system colours → `undefined` (the renderer
 * default). Exported so the conditional-format reader (XLS-13) resolves its dxf
 * colours the same way.
@@ -130,8 +133,7 @@ function buildBiffPalette(records) {
 	for (const rec of records) if (rec.type === REC_PALETTE) applyPalette(rec.data, palette);
 	return (icv) => {
 		if (icv === 32767 || icv === 64 || icv === 65) return void 0;
-		const rgb = palette[icv];
-		return rgb ? `FF${rgb}` : void 0;
+		return palette[icv];
 	};
 }
 /**
@@ -252,11 +254,11 @@ function parseXf(d, color, internFill, internBorder) {
 	if (right) border.right = right;
 	if (top) border.top = top;
 	if (bottom) border.bottom = bottom;
-	const patternType = FILL_PATTERNS[brd3 >> 26 & 63];
+	const patternType = FILL_PATTERNS[brd3 >> 10 & 63];
 	let fill;
 	if (patternType && patternType !== "none") {
-		const fg = color(brd3 & 127);
-		const bg = color(brd3 >> 7 & 127);
+		const fg = color(brd3 >> 16 & 127);
+		const bg = color(brd3 >> 23 & 127);
 		fill = {
 			patternType,
 			...fg ? { fgColorHex: fg } : {},

package/dist/esm/excel/xls/escher.js

@@ -1,3 +1,4 @@
+import { readEscherBlip } from "../../core/ole/escher-blip.js";
 //#region src/excel/xls/escher.ts
 var FBT_BSTORE_CONTAINER = 61441;
 var FBT_BSE = 61447;
@@ -6,6 +7,7 @@ var FBT_OPT = 61451;
 var FBT_CLIENT_ANCHOR = 61456;
 var PROP_PIB = 260;
 var MAX_DEPTH = 24;
+var BSE_HEADER_BYTES = 36;
 function* records(d) {
 	let off = 0;
 	while (off + 8 <= d.length) {
@@ -37,7 +39,11 @@ function parseBlipStore(msoDrawingGroup) {
 	const store = findContainer(msoDrawingGroup, FBT_BSTORE_CONTAINER, 0);
 	if (!store) return [];
 	const out = [];
-	for (const r of records(store)) if (r.type === FBT_BSE) out.push(findImageBytes(r.data));
+	for (const r of records(store)) {
+		if (r.type !== FBT_BSE) continue;
+		const nested = [...records(r.data.subarray(BSE_HEADER_BYTES))][0];
+		out.push(nested ? readEscherBlip(nested.type, nested.instance, nested.data) ?? findImageBytes(r.data) : findImageBytes(r.data));
+	}
 	return out;
 }
 function findContainer(d, type, depth) {
@@ -74,6 +80,9 @@ function collectPictures(d, out, depth) {
 }
 var FBT_SP = 61450;
 var FBT_CLIENT_TEXTBOX = 61453;
+var FBT_SPGR_CONTAINER = 61443;
+var FBT_SPGR = 61449;
+var FBT_CHILD_ANCHOR = 61455;
 var PROP_FILL_COLOR = 385;
 var PROP_LINE_COLOR = 448;
 /**
@@ -86,30 +95,84 @@ function parseSheetShapes(msoDrawing) {
 	collectShapes(msoDrawing, out, 0);
 	return out;
 }
-function collectShapes(d, out, depth) {
+function collectShapes(d, out, depth, group) {
 	if (depth > MAX_DEPTH) return;
-	for (const r of records(d)) if (r.type === FBT_SP_CONTAINER) {
-		let shapeType = 0;
-		let hasText = false;
-		let pib;
-		let anchor;
-		let fill;
-		let line;
-		for (const child of records(r.data)) if (child.type === FBT_SP) shapeType = child.instance;
-		else if (child.type === FBT_OPT) {
-			pib = optProperty(child.data, child.instance, PROP_PIB);
-			fill = optColor(child.data, child.instance, PROP_FILL_COLOR);
-			line = optColor(child.data, child.instance, PROP_LINE_COLOR);
-		} else if (child.type === FBT_CLIENT_ANCHOR) anchor = parseAnchor(child.data);
-		else if (child.type === FBT_CLIENT_TEXTBOX) hasText = true;
-		if (pib === void 0 && shapeType !== 0) out.push({
-			shapeType,
-			hasText,
-			...anchor ? { anchor } : {},
-			...fill ? { fillColorHex: fill } : {},
-			...line ? { lineColorHex: line } : {}
-		});
-	} else if (r.isContainer) collectShapes(r.data, out, depth + 1);
+	for (const r of records(d)) {
+		if (r.type === FBT_SPGR_CONTAINER) {
+			collectShapes(r.data, out, depth + 1, groupFrame(r.data) ?? group);
+			continue;
+		}
+		if (r.type === FBT_SP_CONTAINER) {
+			let shapeType = 0;
+			let hasText = false;
+			let pib;
+			let anchor;
+			let fill;
+			let line;
+			for (const child of records(r.data)) if (child.type === FBT_SP) shapeType = child.instance;
+			else if (child.type === FBT_OPT) {
+				pib = optProperty(child.data, child.instance, PROP_PIB);
+				fill = optColor(child.data, child.instance, PROP_FILL_COLOR);
+				line = optColor(child.data, child.instance, PROP_LINE_COLOR);
+			} else if (child.type === FBT_CLIENT_ANCHOR) anchor = parseAnchor(child.data);
+			else if (child.type === FBT_CHILD_ANCHOR && group) anchor = childAnchor(child.data, group);
+			else if (child.type === FBT_CLIENT_TEXTBOX) hasText = true;
+			if (pib === void 0 && shapeType !== 0) out.push({
+				shapeType,
+				hasText,
+				...anchor ? { anchor } : {},
+				...fill ? { fillColorHex: fill } : {},
+				...line ? { lineColorHex: line } : {}
+			});
+		} else if (r.isContainer) collectShapes(r.data, out, depth + 1, group);
+	}
+}
+function groupFrame(spgrData) {
+	const sp = [...records(spgrData)].find((r) => r.type === FBT_SP_CONTAINER);
+	if (!sp) return void 0;
+	let box;
+	let anchor;
+	for (const child of records(sp.data)) if (child.type === FBT_SPGR && child.data.length >= 16) {
+		const x = i32(child.data, 0);
+		const y = i32(child.data, 4);
+		box = {
+			x,
+			y,
+			w: i32(child.data, 8) - x,
+			h: i32(child.data, 12) - y
+		};
+	} else if (child.type === FBT_CLIENT_ANCHOR) anchor = parseAnchor(child.data);
+	if (!box || !anchor || box.w <= 0 || box.h <= 0) return void 0;
+	return {
+		anchor,
+		...box
+	};
+}
+function childAnchor(d, g) {
+	if (d.length < 16) return void 0;
+	const from = (v, lo, hi, min, size) => lo + (v - min) / size * (hi - lo);
+	const x1 = g.anchor.col1 + g.anchor.dx1 / 1024;
+	const x2 = g.anchor.col2 + g.anchor.dx2 / 1024;
+	const y1 = g.anchor.row1 + g.anchor.dy1 / 1024;
+	const y2 = g.anchor.row2 + g.anchor.dy2 / 1024;
+	const cell = (v) => {
+		const whole = Math.max(0, Math.min(65535, Math.floor(v)));
+		return [whole, Math.max(0, Math.min(1023, Math.round((v - whole) * 1024)))];
+	};
+	const [col1, dx1] = cell(from(i32(d, 0), x1, x2, g.x, g.w));
+	const [row1, dy1] = cell(from(i32(d, 4), y1, y2, g.y, g.h));
+	const [col2, dx2] = cell(from(i32(d, 8), x1, x2, g.x, g.w));
+	const [row2, dy2] = cell(from(i32(d, 12), y1, y2, g.y, g.h));
+	return {
+		col1,
+		dx1,
+		row1,
+		dy1,
+		col2,
+		dx2,
+		row2,
+		dy2
+	};
 }
 function optColor(d, count, wantId) {
 	const v = optProperty(d, count, wantId);
@@ -179,6 +242,9 @@ function matches(d, off, magic) {
 	for (let i = 0; i < magic.length; i++) if (d[off + i] !== magic[i]) return false;
 	return true;
 }
+function i32(d, off) {
+	return u32(d, off) | 0;
+}
 function u16(d, off) {
 	return (d[off] ?? 0) | (d[off + 1] ?? 0) << 8;
 }

package/dist/esm/excel/xlsx-reader.d.ts

@@ -29,7 +29,7 @@ export declare function readXlsx(xlsx: Uint8Array, options?: ProjectSheetOptions
  */
 export declare function readXlsxToSheetDoc(xlsx: Uint8Array): SheetDoc;
 /**
- * The OOXML `.xlsx` {@link DocumentReader}: sniffs the OPC ZIP for
+ * The OOXML `.xlsx` {@link DocumentReader}: sniffs the OPC ZIP's directory for
  * `xl/workbook.xml` and reads it into a {@link SheetDoc}. The reader's native
  * tree is the SheetDoc; the facade/Ream project it to a {@link FlowDoc} for
  * rendering (E-SHEET SB1).

package/dist/esm/excel/xlsx-reader.js

@@ -1,7 +1,7 @@
 import { ResourceStore } from "../core/ir/resources.js";
 import { FEATURES } from "../core/ir/features.js";
 import { detectImageFormat } from "../core/images.js";
-import { bytesInclude, bytesIncludePartName } from "../core/bytes.js";
+import { bytesInclude, packageHasPart } from "../core/bytes.js";
 import { DEFAULT_THEME_PALETTE, makeColorResolver } from "../core/drawingml/colors.js";
 import { parseChart, withChartColorStyle } from "../core/drawingml/chart-parser.js";
 import { parseTheme, parseThemeEffectStyles, parseThemeFillStyles, parseThemeLineWidths } from "../core/drawingml/theme-parser.js";
@@ -651,7 +651,7 @@ function lighten(hex, amount) {
 	return `${hx(ch(16))}${hx(ch(8))}${hx(ch(0))}`;
 }
 /**
-* The OOXML `.xlsx` {@link DocumentReader}: sniffs the OPC ZIP for
+* The OOXML `.xlsx` {@link DocumentReader}: sniffs the OPC ZIP's directory for
 * `xl/workbook.xml` and reads it into a {@link SheetDoc}. The reader's native
 * tree is the SheetDoc; the facade/Ream project it to a {@link FlowDoc} for
 * rendering (E-SHEET SB1).
@@ -660,7 +660,7 @@ var xlsxReader = {
 	id: "xlsx",
 	produces: "sheet",
 	supports: new Set([FEATURES.text, FEATURES.tables]),
-	sniff: (bytes) => bytes[0] === 80 && bytes[1] === 75 && bytesIncludePartName(bytes, "xl/workbook.xml"),
+	sniff: (bytes) => bytes[0] === 80 && bytes[1] === 75 && packageHasPart(bytes, "xl/workbook.xml"),
 	read: (bytes) => ({
 		doc: readXlsxToSheetDoc(bytes),
 		losses: []

package/dist/esm/layout/page-doc.d.ts

@@ -17,6 +17,23 @@ export interface FontResource {
     /** Glyphs collected by the usage walk — the emit phase subsets to these. */
     readonly gids: ReadonlySet<number>;
 }
+/**
+ * The face a run asked for and the registry could not give — what the page has
+ * to draw itself. A font set carries only `regular` by contract, so a caller
+ * who supplies one file still asks for bold headings and italic quotes.
+ */
+export interface SyntheticFace {
+    /** No bold cut: the glyphs are stroked as well as filled. */
+    readonly bold?: true;
+    /** No italic cut: the glyphs are sheared. */
+    readonly italic?: true;
+    /**
+     * No condensed cut: the glyphs are set at this fraction of their advance
+     * (`Arial Narrow` is 82 % of Arial). Layout measures through it too — the
+     * squeeze decides where the line breaks, not just how it looks.
+     */
+    readonly widthScale?: number;
+}
 /** A run of text on a {@link Line}: the string plus its resolved font, size, width and link/tagging state. */
 export interface TextToken {
     readonly kind: 'text';
@@ -61,6 +78,8 @@ export interface TextToken {
     readonly highlight?: true;
     readonly resolvedRun: ResolvedRunProperties;
     readonly font: FontResource;
+    /** What the chosen face lacks and the emitter must fake (see {@link SyntheticFace}). */
+    readonly synthetic?: SyntheticFace;
     readonly fontSizePt: number;
     /**
      * §17.3.2.42 / §18.4.2 `vertAlign` — how far off the baseline this token
@@ -205,6 +224,19 @@ export interface MetafileDrawing {
         readonly y: number;
         readonly rotationDeg?: number;
     }>;
+    /**
+     * MS-EMF §2.3.1 — the bitmaps the picture blits into itself, each already a
+     * page resource of its own. `x`/`y` are the box's BOTTOM-left corner, in the
+     * same local frame as the shapes.
+     */
+    readonly images?: ReadonlyArray<{
+        readonly resourceName: string;
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+        readonly rotationDeg?: number;
+    }>;
 }
 export interface ImageResource {
     readonly resourceName: string;
@@ -220,6 +252,13 @@ export interface ImageResource {
      * turns these into the same primitives a chart is made of.
      */
     readonly metafile?: MetaPicture;
+    /**
+     * The resource name of each bitmap `metafile` blits, in the order its
+     * primitives hold them. A metafile draws its own pictures, and each is an
+     * ordinary image resource — entered under a key of its own, so the emitters
+     * embed and name it without knowing where it came from.
+     */
+    readonly metafileImages?: ReadonlyArray<string>;
 }
 /**
  * The fields every {@link PageItem} shares (ir-design §6, frozen at stage 6.4):
@@ -242,6 +281,24 @@ export interface PageItemBase {
      * is treated as an artifact. Ignored when not tagging.
      */
     readonly structId?: number;
+    /**
+     * §20.4.2.3 `@behindDoc` — the item is BEHIND the page's content: a
+     * watermark, a slide's backdrop. Such items paint before everything else, in
+     * their own order. Without that they rode the ordinary passes, where every
+     * shape paints after every image — so a slide's white backdrop covered the
+     * photograph the slide is made of (corpus: tdf156808, tdf157635, tdf156856).
+     */
+    readonly behind?: boolean;
+    /**
+     * The picture this item belongs to, when it is part of one. A metafile is a
+     * list of drawing orders, and text among them is BOTH over what came before
+     * and under what comes after: an embedded diagram writes a label, lays a
+     * panel over it and writes the label again, offset, as its own drop shadow.
+     * Painted in the ordinary passes — every shape, then every line — the buried
+     * copy would show through the panel. Items sharing this id are held out of
+     * those passes and painted together, in list order.
+     */
+    readonly pictureId?: number;
     /**
      * Tagged PDF: explicitly mark this item as a pagination artifact (running
      * header/footer, §14.8.2.2.2). Distinguishes header/footer text from
@@ -314,6 +371,19 @@ export interface ImageItem extends PageItemBase {
         readonly gain: number;
         readonly black: number;
     };
+    /**
+     * §20.1.8.4 `a:alphaModFix` — how opaque the picture is drawn, 0…1. A slide
+     * backed by a photograph at 70 % shows a pale wash of it, not the photograph.
+     */
+    readonly alpha?: number;
+    /**
+     * §20.1.8.23 `a:duotone` — the picture painted between two colours instead of
+     * its own: its dark end is the first, its light end the second.
+     */
+    readonly duotone?: {
+        readonly shadowHex: string;
+        readonly highlightHex: string;
+    };
     /** §20.1.7.6 — degrees clockwise about the box's centre. */
     readonly rotationDeg?: number;
     /** §20.1.7.6 — the picture drawn mirrored in its box. */
@@ -340,11 +410,18 @@ export interface ShapeItem extends PageItemBase {
 /** A positioned item on a laid-out page: a text line, border, fill, image, or vector shape. */
 export type PageItem = TextLineItem | BorderItem | FillItem | ImageItem | ShapeItem;
 export interface PagePaintPlan {
+    /** What sits behind the page's content, in its own order — painted first. */
+    readonly behind: ReadonlyArray<PageItem>;
     readonly fills: ReadonlyArray<FillItem>;
     readonly images: ReadonlyArray<ImageItem>;
     readonly borders: ReadonlyArray<BorderItem>;
     readonly shapes: ReadonlyArray<ShapeItem>;
     readonly lines: ReadonlyArray<TextLineItem>;
+    /**
+     * Pictures, each as its own list in the order the picture draws — one entry
+     * per {@link PageItemBase.pictureId}. They paint where the shape pass does.
+     */
+    readonly pictures: ReadonlyArray<ReadonlyArray<PageItem>>;
 }
 export declare function paintPlan(commands: ReadonlyArray<PageItem>): PagePaintPlan;
 export interface LaidOutDocument {