reamkit 1.22.0 → 1.23.0

package/dist/esm/word/document-parser.d.ts

@@ -2,6 +2,7 @@ import { BodyElement, Comment, RunProperties, Section, SectionProperties, ShapeF
 import { ColorResolver } from '../core/drawingml/colors.js';
 import { Loss, ResourceId } from '../core/ir/index.js';
 import { PoNode } from '../core/po-helpers.js';
+import { ThemeFonts } from '../core/drawingml/theme-parser.js';
 import { ThemeStyles } from './drawing-parser.js';
 /**
  * Resolves a drawing relationship id to a content-addressed `ResourceId` —
@@ -57,6 +58,11 @@ export interface ParseContext {
      * the shadow a gallery-drawn shape wears.
      */
     readonly themeStyles?: ThemeStyles;
+    /**
+     * §20.1.4.1.16 — the theme's font scheme, for the typefaces a run names by
+     * slot (`w:asciiTheme="minorHAnsi"`) rather than by name.
+     */
+    readonly themeFonts?: ThemeFonts;
     /**
      * Sink for graceful-degradation notices (E-SMARTART SA3): a SmartArt with no
      * drawing override records a dropped-feature {@link Loss} rather than vanishing.
@@ -185,7 +191,7 @@ export declare function parseBodyElements(children: ReadonlyArray<PoNode>, ctx?:
  * @param sdt The `w:sdt` element.
  * @returns The properties, or `undefined` when the control states none.
  */
-export declare function sdtRunProperties(sdt: PoNode): RunProperties | undefined;
+export declare function sdtRunProperties(sdt: PoNode, themeFonts?: ThemeFonts): RunProperties | undefined;
 /**
  * Parse `footnotes.xml` / `endnotes.xml` (§17.11) into note content by id. The
  * separator / continuationSeparator / continuationNotice stubs (negative ids or

package/dist/esm/word/document-parser.js

@@ -425,7 +425,7 @@ function tryExtractDrawingFromParagraph(p, ctx) {
 	if (!vml && drawings.every((d) => poChildren(d).some((c) => poIs(c, "wp:anchor")))) return null;
 	const parseBody = (children) => parseBodyElements(children, ctx);
 	const pPrNode = poChildren(p).find((c) => poIs(c, "w:pPr"));
-	const paragraphProperties = pPrNode ? parseParagraphProperties(poElementToFlat(pPrNode), ctx.autoSpacingPt) : {};
+	const paragraphProperties = pPrNode ? parseParagraphProperties(poElementToFlat(pPrNode), ctx.autoSpacingPt, ctx.themeFonts) : {};
 	if (drawings.length === 0) {
 		const content = parseVmlPicture(vml, parseBody);
 		if (!content) return null;
@@ -536,7 +536,7 @@ function parseParagraph(p, ctx, extraBookmarks, anchored, sdtRunProps) {
 		if (bookmarkName !== void 0 && bookmarkName !== "" && bookmarkName !== "_GoBack") bookmarks.push(bookmarkName);
 	}
 	const pPr = poChildren(p).find((c) => poIs(c, "w:pPr"));
-	let properties = parseParagraphProperties(pPr ? poElementToFlat(pPr) : void 0, ctx.autoSpacingPt);
+	let properties = parseParagraphProperties(pPr ? poElementToFlat(pPr) : void 0, ctx.autoSpacingPt, ctx.themeFonts);
 	if (pPr && poChildren(pPr).some((c) => poIs(c, "w:sectPr"))) properties = {
 		...properties,
 		sectionBreak: true
@@ -773,7 +773,7 @@ function collectRuns(container, out, ctx, href, anchor, anchored, sdtRunProps) {
 					if (bookmark !== void 0 && bookmark !== "") childAnchor = bookmark;
 				}
 			}
-			const childProps = tag === "w:sdt" ? sdtRunProperties(child) ?? sdtRunProps : sdtRunProps;
+			const childProps = tag === "w:sdt" ? sdtRunProperties(child, ctx.themeFonts) ?? sdtRunProps : sdtRunProps;
 			collectRuns(child, out, ctx, childHref, childAnchor, anchored, childProps);
 		}
 	}
@@ -785,11 +785,11 @@ function collectRuns(container, out, ctx, href, anchor, anchored, sdtRunProps) {
 * @param sdt The `w:sdt` element.
 * @returns The properties, or `undefined` when the control states none.
 */
-function sdtRunProperties(sdt) {
+function sdtRunProperties(sdt, themeFonts) {
 	const sdtPr = poChildren(sdt).find((c) => poIs(c, "w:sdtPr"));
 	const rPr = sdtPr ? poChildren(sdtPr).find((c) => poIs(c, "w:rPr")) : void 0;
 	if (!rPr) return void 0;
-	const props = parseRunProperties(poElementToFlat(rPr));
+	const props = parseRunProperties(poElementToFlat(rPr), themeFonts);
 	return Object.keys(props).length > 0 ? props : void 0;
 }
 var WINGDINGS_TO_UNICODE = new Map([
@@ -870,7 +870,7 @@ function symbolChar(font, char) {
 }
 function parseRun(r, ctx, anchored) {
 	const rPr = poChildren(r).find((c) => poIs(c, "w:rPr"));
-	const properties = parseRunProperties(rPr ? poElementToFlat(rPr) : void 0);
+	const properties = parseRunProperties(rPr ? poElementToFlat(rPr) : void 0, ctx.themeFonts);
 	let text = "";
 	let pageBreak = false;
 	let columnBreak = false;

package/dist/esm/word/docx-reader.js

@@ -9,7 +9,7 @@ import { poFindDescendant } from "../core/po-helpers.js";
 import { 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, parseThemeBgFillStyles, parseThemeEffectStyles, parseThemeFillStyles, parseThemeLineWidths } from "../core/drawingml/theme-parser.js";
+import { parseTheme, parseThemeBgFillStyles, parseThemeEffectStyles, parseThemeFillStyles, parseThemeFonts, parseThemeLineWidths } from "../core/drawingml/theme-parser.js";
 import { isOoxmlRel } from "../core/opc/relationship-types.js";
 import { OpcPackage } from "../core/opc/package.js";
 import { parseCoreProperties } from "../core/opc/core-properties.js";
@@ -52,6 +52,7 @@ function readDocx(docx) {
 	const resolveColor = buildColorResolver(pkg, main.path);
 	const themeData = loadTheme(pkg, main.path);
 	const themeLineWidths = themeData ? parseThemeLineWidths(themeData) : void 0;
+	const themeFonts = themeData ? parseThemeFonts(themeData) : void 0;
 	const themeStyles = themeData ? {
 		fills: parseThemeFillStyles(themeData),
 		bgFills: parseThemeBgFillStyles(themeData),
@@ -68,6 +69,7 @@ function readDocx(docx) {
 		...settings.compatibilityMode === void 0 ? { autoSpacingPt: 14 } : {},
 		...themeLineWidths && themeLineWidths.length > 0 ? { themeLineWidths } : {},
 		...themeStyles ? { themeStyles } : {},
+		...themeFonts ? { themeFonts } : {},
 		resolveImage,
 		resolveHyperlink,
 		resolveDiagram: makeDiagramResolver(pkg, main.path, resources),
@@ -84,11 +86,12 @@ function readDocx(docx) {
 		endIndex: bodyIndexForBlock(blocks, s.endIndex)
 	}));
 	const stylesData = pkg.getPart(STYLES_PART);
-	const styles = stylesData ? parseStyles(stylesData) : EMPTY_STYLE_SHEET;
+	const styles = stylesData ? parseStyles(stylesData, themeFonts) : EMPTY_STYLE_SHEET;
 	const numberingData = pkg.getPart(NUMBERING_PART);
-	const numbering = numberingData ? parseNumbering(numberingData, makeImageResolver(pkg, resources, NUMBERING_PART)) : EMPTY_NUMBERING;
+	const numbering = numberingData ? parseNumbering(numberingData, makeImageResolver(pkg, resources, NUMBERING_PART), themeFonts) : EMPTY_NUMBERING;
 	const noteCtx = (part) => ({
 		resolveColor,
+		...themeFonts ? { themeFonts } : {},
 		resolveImage: makeImageResolver(pkg, resources, part),
 		resolveHyperlink: makeHyperlinkResolver(pkg, part)
 	});

package/dist/esm/word/docx-to-pdf.d.ts

@@ -38,10 +38,11 @@ export interface ConvertDocxOptions extends Omit<StyledRenderOptions, 'registry'
  */
 export declare function convertDocxToPdfSync(docx: Uint8Array, options: ConvertDocxOptions): Uint8Array;
 /**
- * The distinct curated font families the document references (scanning the
- * `w:ascii` of `styles.xml` + `document.xml`), always including the sans default
- * `'arimo'` as a fallback for unstyled runs / math / charts. The async path
- * fetches one substitute set per family so each run renders in the right one.
+ * The distinct curated font families the document references — the `w:ascii` of
+ * `styles.xml` + `document.xml`, and the theme slots they point at instead
+ * (§17.3.2.26) — always including the sans default `'arimo'` as a fallback for
+ * unstyled runs / math / charts. The async path fetches one substitute set per
+ * family so each run renders in the right one.
  *
  * @param docx The `.docx` bytes.
  * @returns The resolved {@link FamilyKey} set; just the default when the package
@@ -76,9 +77,9 @@ export declare function resolveDocxAutoFonts(docx: Uint8Array, options?: {
 }>;
 /**
  * Best-effort detection of the document's primary font family, used to choose a
- * substitute for auto-download. Prefers the document defaults' `w:ascii` font,
- * then falls back to the most frequent run font. A cheap regex over the XML — no
- * need to fully parse for this hint.
+ * substitute for auto-download. Prefers the document defaults' font — spelled
+ * out or pointed at in the theme — then falls back to the most frequent run
+ * font. A cheap regex over the XML: no need to fully parse for this hint.
  *
  * @param docx The `.docx` bytes.
  * @returns The detected family name, or `undefined` when none is found.

package/dist/esm/word/docx-to-pdf.js

@@ -3,12 +3,15 @@ import { FontRegistry } from "../core/font/font-registry.js";
 import { signPdf } from "../pdf/signature.js";
 import { renderStyledPdf, renderStyledPdfEncrypted } from "../pdf/styled-page-renderer.js";
 import "../pdf/index.js";
+import { parseThemeFonts } from "../core/drawingml/theme-parser.js";
 import { OpcPackage } from "../core/opc/package.js";
 import "../core/opc/index.js";
+import { resolveWordThemeFont } from "./theme-fonts.js";
 import { readDocx } from "./docx-reader.js";
 import { flowRenderOptions } from "../core/converter/project.js";
 //#region src/word/docx-to-pdf.ts
 var STYLES_PART = "word/styles.xml";
+var THEME_PART = "word/theme/theme1.xml";
 var MAIN_DOCUMENT_PART = "word/document.xml";
 /**
 * Synchronous one-shot conversion (requires `fonts`/`fontBytes`, no network).
@@ -49,10 +52,11 @@ function prepareDocxStyledRender(docx, options) {
 	};
 }
 /**
-* The distinct curated font families the document references (scanning the
-* `w:ascii` of `styles.xml` + `document.xml`), always including the sans default
-* `'arimo'` as a fallback for unstyled runs / math / charts. The async path
-* fetches one substitute set per family so each run renders in the right one.
+* The distinct curated font families the document references — the `w:ascii` of
+* `styles.xml` + `document.xml`, and the theme slots they point at instead
+* (§17.3.2.26) — always including the sans default `'arimo'` as a fallback for
+* unstyled runs / math / charts. The async path fetches one substitute set per
+* family so each run renders in the right one.
 *
 * @param docx The `.docx` bytes.
 * @returns The resolved {@link FamilyKey} set; just the default when the package
@@ -67,16 +71,30 @@ function detectDocxFamilyKeys(docx) {
 		return keys;
 	}
 	const decoder = new TextDecoder("utf-8");
-	const re = /<w:rFonts[^>]*\bw:ascii="([^"]+)"/g;
+	const themeFonts = docxThemeFonts(pkg);
+	const re = /<w:rFonts[^>]*?\bw:(ascii|asciiTheme)="([^"]+)"/g;
 	for (const part of [STYLES_PART, MAIN_DOCUMENT_PART]) {
 		const data = pkg.getPart(part);
 		if (!data) continue;
 		const xml = decoder.decode(data);
 		let m;
-		while ((m = re.exec(xml)) !== null) keys.add(resolveFamilyKey(m[1]));
+		while ((m = re.exec(xml)) !== null) {
+			const name = m[1] === "ascii" ? m[2] : resolveWordThemeFont(m[2], themeFonts);
+			if (name !== void 0) keys.add(resolveFamilyKey(name));
+		}
 	}
 	return keys;
 }
+/** §20.1.4.1.16 — the theme's font scheme, for the slots `w:rFonts` points at. */
+function docxThemeFonts(pkg) {
+	const data = pkg.getPart(THEME_PART);
+	if (!data) return void 0;
+	try {
+		return parseThemeFonts(data);
+	} catch {
+		return;
+	}
+}
 /**
 * One-shot .docx → PDF (auto-downloads a substitute font set when the caller
 * supplies none; zero network with `fonts`/`fontBytes`).
@@ -140,4 +158,4 @@ async function resolveDocxAutoFonts(docx, options = {}) {
 	};
 }
 //#endregion
-export { convertDocxToPdf, resolveDocxAutoFonts };
+export { convertDocxToPdf };

package/dist/esm/word/drawing-parser.js

@@ -1818,7 +1818,9 @@ function fillFromNode(child, resolveColor, resolveImage) {
 		const crop = parseSrcRect(poFindDescendant(child, "a:srcRect")) ?? fillRectCrop(child);
 		const rect = fillRectBox(child);
 		const duotone = blip ? duotoneOf(blip, resolveColor) : void 0;
-		const tiled = poChildren(child).some((c) => poIs(c, "a:tile"));
+		const tile = poChildren(child).find((c) => poIs(c, "a:tile"));
+		const tiled = tile !== void 0;
+		const tileScale = tile ? tileScaleOf(tile) : void 0;
 		const fixed = blip ? poChildren(blip).find((c) => poIs(c, "a:alphaModFix")) : void 0;
 		const amt = fixed ? poIntAttr(fixed, "amt") : void 0;
 		const alpha = amt === void 0 ? void 0 : Math.min(1, Math.max(0, amt / 1e5));
@@ -1826,6 +1828,7 @@ function fillFromNode(child, resolveColor, resolveImage) {
 			kind: "picture",
 			imageResource: resource,
 			...tiled ? { tiled: true } : {},
+			...tileScale ? { tileScale } : {},
 			...crop ? { imageCrop: crop } : {},
 			...rect ? { imageFillRect: rect } : {},
 			...duotone ? { duotone } : {},
@@ -1997,6 +2000,18 @@ function duotoneOf(blip, resolveColor) {
 * @returns The rect as fractions of the box, or `undefined` when every inset
 *          is zero or negative.
 */
+function tileScaleOf(tile) {
+	const pct = (name) => {
+		const v = poIntAttr(tile, name);
+		return v === void 0 || v <= 0 ? 1 : v / 1e5;
+	};
+	const sx = pct("sx");
+	const sy = pct("sy");
+	return sx === 1 && sy === 1 ? void 0 : {
+		sx,
+		sy
+	};
+}
 function fillRectBox(blipFill) {
 	const stretch = poChildren(blipFill).find((c) => poIs(c, "a:stretch"));
 	const rect = stretch ? poChildren(stretch).find((c) => poIs(c, "a:fillRect")) : void 0;
@@ -2047,14 +2062,15 @@ function shadowFromOuterShdw(shdw, resolveColor) {
 	const colorHex = colorNode ? resolveColorNode(colorNode, resolveColor) : void 0;
 	if (!colorHex) return void 0;
 	const alphaMod = colorNode ? readColorMods(colorNode).find((m) => m.kind === "alpha") : void 0;
+	const alpha = alphaMod ? alphaMod.val : 1;
 	const dist = emuToPt(poIntAttr(shdw, "dist") ?? 0);
 	const rad = (poIntAttr(shdw, "dir") ?? 0) / 6e4 * Math.PI / 180;
 	return {
 		dxPt: dist * Math.cos(rad),
 		dyPt: dist * Math.sin(rad),
 		blurPt: emuToPt(poIntAttr(shdw, "blurRad") ?? 0),
-		colorHex,
-		alpha: alphaMod ? alphaMod.val : 1
+		colorHex: alpha < 1 ? unblendWhite(colorHex, alpha) : colorHex,
+		alpha
 	};
 }
 /**
@@ -2203,25 +2219,21 @@ function colorFromContainer(parent, resolveColor) {
 /**
 * §20.1.2.3.1 — a gradient's stop transparencies, settled.
 *
-* A page paints a gradient at ONE transparency, so only a gradient whose every
-* stop is translucent can carry it: the strongest stop decides whether the
-* shape is there at all, which is the question a 7%-and-fading glow asks
-* (tdf123684's master draws one over a dark slide, and composited over the
-* paper instead it was an opaque white disc).
+* The resolver composites a translucent colour over the PAPER, because a solid
+* fill has nowhere else to put the transparency. A gradient does: its stops
+* become a luminosity soft mask of the same sweep (§11.6.5.2,
+* `buildGradientAlphaMask`), so each stop keeps its own alpha and its own
+* colour, and the mask decides what shows through.
 *
-* A gradient that mixes a translucent stop with an opaque one has no such
-* answer, so it keeps the colours the resolver already washed toward the paper
-* — an approximation, but the one that has always been drawn: smartart-simple's
-* cyan-to-purple sweep sets 75% on its purple end alone.
+* That means the washing has to be undone here, on every stop — including the
+* opaque ones, where undoing it is a no-op. It used to be undone only when
+* EVERY stop was translucent, on the reasoning that a page paints a gradient at
+* one transparency; the mask makes that false, and the cost of the old reading
+* was a band that should have been half-transparent over a blue slide drawn as
+* an opaque pale stripe (45541's layout fades the middle of its left rule to
+* 50 %).
 */
 function normalizeStopAlpha(stops) {
-	if (gradientAlpha(stops) === void 0) {
-		for (const [i, s] of stops.entries()) if (s.alpha !== void 0) stops[i] = {
-			offset: s.offset,
-			colorHex: s.colorHex
-		};
-		return;
-	}
 	for (const [i, s] of stops.entries()) stops[i] = {
 		...s,
 		colorHex: unblendWhite(s.colorHex, s.alpha ?? 1)

package/dist/esm/word/numbering-parser.d.ts

@@ -1,5 +1,6 @@
 import { Numbering } from '../core/document-model/index.js';
 import { ResourceId } from '../core/ir/index.js';
+import { ThemeFonts } from '../core/drawingml/theme-parser.js';
 /** The empty {@link Numbering} returned when a document has no `numbering.xml`. */
 export declare const EMPTY_NUMBERING: Numbering;
 /**
@@ -12,4 +13,4 @@ export declare const EMPTY_NUMBERING: Numbering;
  * @param data The raw `numbering.xml` bytes.
  * @returns The parsed numbering, or {@link EMPTY_NUMBERING} when the root is absent.
  */
-export declare function parseNumbering(data: Uint8Array, resolveImage?: (relId: string) => ResourceId | undefined): Numbering;
+export declare function parseNumbering(data: Uint8Array, resolveImage?: (relId: string) => ResourceId | undefined, themeFonts?: ThemeFonts): Numbering;

package/dist/esm/word/numbering-parser.js

@@ -56,7 +56,7 @@ var EMPTY_NUMBERING = {
 * @param data The raw `numbering.xml` bytes.
 * @returns The parsed numbering, or {@link EMPTY_NUMBERING} when the root is absent.
 */
-function parseNumbering(data, resolveImage) {
+function parseNumbering(data, resolveImage, themeFonts) {
 	const xml = decoder.decode(data);
 	const root = asElement(parser.parse(xml)["w:numbering"]);
 	if (!root) return EMPTY_NUMBERING;
@@ -69,7 +69,7 @@ function parseNumbering(data, resolveImage) {
 		if (!id) continue;
 		const levels = /* @__PURE__ */ new Map();
 		for (const lvlNode of asArray(el["w:lvl"])) {
-			const lvl = parseLevel(lvlNode, picBullets);
+			const lvl = parseLevel(lvlNode, picBullets, themeFonts);
 			if (lvl) levels.set(lvl.ilvl, lvl);
 		}
 		abstractNums.set(id, {
@@ -94,7 +94,7 @@ function parseNumbering(data, resolveImage) {
 			if (!Number.isFinite(ilvl)) continue;
 			const start = Number(getValVal(ovr["w:startOverride"]));
 			if (Number.isFinite(start)) startOverrides.set(ilvl, start);
-			const lvl = parseLevel(ovr["w:lvl"], picBullets);
+			const lvl = parseLevel(ovr["w:lvl"], picBullets, themeFonts);
 			if (lvl) levelOverrides.set(ilvl, lvl);
 		}
 		numInstances.set(numId, {
@@ -109,7 +109,7 @@ function parseNumbering(data, resolveImage) {
 		numInstances
 	};
 }
-function parseLevel(node, picBullets) {
+function parseLevel(node, picBullets, themeFonts) {
 	const lvlEl = asElement(node);
 	if (!lvlEl) return void 0;
 	const ilvlStr = getAttr(lvlEl, "ilvl");
@@ -131,8 +131,8 @@ function parseLevel(node, picBullets) {
 		lvlText,
 		...isLegal ? { isLegal: true } : {},
 		...picBullet ? { picBullet } : {},
-		paragraphProperties: parseParagraphProperties(lvlEl["w:pPr"]),
-		runProperties: parseRunProperties(lvlEl["w:rPr"])
+		paragraphProperties: parseParagraphProperties(lvlEl["w:pPr"], 0, themeFonts),
+		runProperties: parseRunProperties(lvlEl["w:rPr"], themeFonts)
 	};
 }
 function parsePicBullets(root, resolveImage) {

package/dist/esm/word/paragraph-properties.d.ts

@@ -1,4 +1,5 @@
 import { ParagraphProperties } from '../core/document-model/index.js';
+import { ThemeFonts } from '../core/drawingml/theme-parser.js';
 /**
  * §17.3.1.1/§17.3.1.3 — the gap `w:*Autospacing` asks the consumer for. Word's
  * own automatic value is HTML's 14pt, and only a document old enough to state
@@ -19,4 +20,4 @@ export declare const HTML_AUTO_SPACING_PT = 14;
  *   compatibility mode, and 0 (the default) for every Word 2007-or-later one.
  * @returns The extracted properties; an empty object when `pPr` is absent.
  */
-export declare function parseParagraphProperties(pPr: unknown, autoSpacingPt?: number): ParagraphProperties;
+export declare function parseParagraphProperties(pPr: unknown, autoSpacingPt?: number, themeFonts?: ThemeFonts): ParagraphProperties;

package/dist/esm/word/paragraph-properties.js

@@ -104,7 +104,7 @@ function parseFramePr(node) {
 *   compatibility mode, and 0 (the default) for every Word 2007-or-later one.
 * @returns The extracted properties; an empty object when `pPr` is absent.
 */
-function parseParagraphProperties(pPr, autoSpacingPt = 0) {
+function parseParagraphProperties(pPr, autoSpacingPt = 0, themeFonts) {
 	const el = asElement(pPr);
 	if (!el) return {};
 	const out = {};
@@ -197,7 +197,7 @@ function parseParagraphProperties(pPr, autoSpacingPt = 0) {
 		}
 	}
 	if ("w:rPr" in el) {
-		const rPr = parseRunProperties(el["w:rPr"]);
+		const rPr = parseRunProperties(el["w:rPr"], themeFonts);
 		if (Object.keys(rPr).length > 0) out.runProperties = rPr;
 	}
 	return out;

package/dist/esm/word/run-properties.d.ts

@@ -1,4 +1,5 @@
 import { RunProperties } from '../core/document-model/index.js';
+import { ThemeFonts } from '../core/drawingml/theme-parser.js';
 /**
  * Parse a run-properties element (`w:rPr`, ECMA-376 Part 1 §17.3.2) into the
  * typed {@link RunProperties}. Reads the character formatting the renderer needs:
@@ -6,7 +7,9 @@ import { RunProperties } from '../core/document-model/index.js';
  * font family map, vertical alignment, RTL, and language; sizes convert from
  * half-points to points and colours normalize to uppercase hex.
  *
- * @param rPr The flat-tree `w:rPr` element (or `undefined`/non-element).
+ * @param rPr        The flat-tree `w:rPr` element (or `undefined`/non-element).
+ * @param themeFonts The document theme's font scheme, for the fonts a run names
+ *                   by slot rather than by name (§17.3.2.26 `w:asciiTheme`).
  * @returns The parsed properties; an empty object when `rPr` is absent.
  */
-export declare function parseRunProperties(rPr: unknown): RunProperties;
+export declare function parseRunProperties(rPr: unknown, themeFonts?: ThemeFonts): RunProperties;

package/dist/esm/word/run-properties.js

@@ -1,5 +1,7 @@
 import { halfPtToPt, twipsToPt } from "../core/ir/units.js";
+import { resolveThemeFont } from "../core/drawingml/theme-parser.js";
 import { asElement, getAttr, getVal, parseHalfPointAttr, parseToggle } from "./xml-helpers.js";
+import { resolveWordThemeFont } from "./theme-fonts.js";
 import { shadingFillHex } from "./shading.js";
 //#region src/word/run-properties.ts
 var UNDERLINE_STYLES = new Set([
@@ -43,10 +45,12 @@ var HIGHLIGHT_COLORS = new Map([
 * font family map, vertical alignment, RTL, and language; sizes convert from
 * half-points to points and colours normalize to uppercase hex.
 *
-* @param rPr The flat-tree `w:rPr` element (or `undefined`/non-element).
+* @param rPr        The flat-tree `w:rPr` element (or `undefined`/non-element).
+* @param themeFonts The document theme's font scheme, for the fonts a run names
+*                   by slot rather than by name (§17.3.2.26 `w:asciiTheme`).
 * @returns The parsed properties; an empty object when `rPr` is absent.
 */
-function parseRunProperties(rPr) {
+function parseRunProperties(rPr, themeFonts) {
 	const el = asElement(rPr);
 	if (!el) return {};
 	const out = {};
@@ -90,7 +94,7 @@ function parseRunProperties(rPr) {
 		else if (v === "auto") out.colorHex = "000000";
 	}
 	if ("w:rFonts" in el) {
-		const ff = parseFontFamily(el["w:rFonts"]);
+		const ff = parseFontFamily(el["w:rFonts"], themeFonts);
 		if (ff) out.fontFamily = ff;
 	}
 	if ("w:vertAlign" in el) {
@@ -121,12 +125,13 @@ function parseRunProperties(rPr) {
 	}
 	return out;
 }
-function parseFontFamily(node) {
+function parseFontFamily(node, themeFonts) {
 	const ff = {};
-	const ascii = getAttr(node, "ascii");
-	const hAnsi = getAttr(node, "hAnsi");
-	const cs = getAttr(node, "cs");
-	const eastAsia = getAttr(node, "eastAsia");
+	const slot = (literal, theme) => resolveThemeFont(getAttr(node, literal), themeFonts) ?? resolveWordThemeFont(getAttr(node, theme), themeFonts);
+	const ascii = slot("ascii", "asciiTheme");
+	const hAnsi = slot("hAnsi", "hAnsiTheme");
+	const cs = slot("cs", "cstheme");
+	const eastAsia = slot("eastAsia", "eastAsiaTheme");
 	if (ascii) ff.ascii = ascii;
 	if (hAnsi) ff.hAnsi = hAnsi;
 	if (cs) ff.cs = cs;

package/dist/esm/word/styles-parser.d.ts

@@ -1,4 +1,5 @@
 import { StyleSheet } from '../core/document-model/index.js';
+import { ThemeFonts } from '../core/drawingml/theme-parser.js';
 /**
  * Parse `word/styles.xml` (ECMA-376 Part 1 §17.7) into a {@link StyleSheet}: the
  * document defaults (`w:docDefaults` run/paragraph properties) plus the named
@@ -9,4 +10,4 @@ import { StyleSheet } from '../core/document-model/index.js';
  * @param stylesXml The raw `styles.xml` bytes.
  * @returns The parsed stylesheet, or `EMPTY_STYLE_SHEET` when the root is absent.
  */
-export declare function parseStyles(stylesXml: Uint8Array): StyleSheet;
+export declare function parseStyles(stylesXml: Uint8Array, themeFonts?: ThemeFonts): StyleSheet;

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

@@ -32,7 +32,7 @@ var STYLE_TYPES = new Set([
 * @param stylesXml The raw `styles.xml` bytes.
 * @returns The parsed stylesheet, or `EMPTY_STYLE_SHEET` when the root is absent.
 */
-function parseStyles(stylesXml) {
+function parseStyles(stylesXml, themeFonts) {
 	const xml = decoder.decode(stylesXml);
 	const root = asElement(parser.parse(xml)["w:styles"]);
 	if (!root) return EMPTY_STYLE_SHEET;
@@ -41,9 +41,9 @@ function parseStyles(stylesXml) {
 	let defaultParagraphProperties = {};
 	if (docDefaults) {
 		const rPrDef = asElement(docDefaults["w:rPrDefault"]);
-		if (rPrDef) defaultRunProperties = parseRunProperties(rPrDef["w:rPr"]);
+		if (rPrDef) defaultRunProperties = parseRunProperties(rPrDef["w:rPr"], themeFonts);
 		const pPrDef = asElement(docDefaults["w:pPrDefault"]);
-		if (pPrDef) defaultParagraphProperties = parseParagraphProperties(pPrDef["w:pPr"]);
+		if (pPrDef) defaultParagraphProperties = parseParagraphProperties(pPrDef["w:pPr"], 0, themeFonts);
 	}
 	const styles = /* @__PURE__ */ new Map();
 	for (const s of asArray(root["w:style"])) {
@@ -61,9 +61,9 @@ function parseStyles(stylesXml) {
 			type,
 			...basedOnVal ? { basedOn: basedOnVal } : {},
 			isDefault,
-			runProperties: parseRunProperties(el["w:rPr"]),
-			paragraphProperties: parseParagraphProperties(el["w:pPr"]),
-			...type === "table" ? parseTableStyleParts(el) : {}
+			runProperties: parseRunProperties(el["w:rPr"], themeFonts),
+			paragraphProperties: parseParagraphProperties(el["w:pPr"], 0, themeFonts),
+			...type === "table" ? parseTableStyleParts(el, themeFonts) : {}
 		};
 		styles.set(id, style);
 	}
@@ -88,9 +88,9 @@ var CONDITION_TYPES = new Set([
 	"swCell",
 	"seCell"
 ]);
-function parseTableStyleParts(el) {
+function parseTableStyleParts(el, themeFonts) {
 	const out = {};
-	const base = parseTableStyleLayer(el);
+	const base = parseTableStyleLayer(el, themeFonts);
 	if (base) out.tableLayer = base;
 	const tblPr = asElement(el["w:tblPr"]);
 	if (tblPr) {
@@ -105,7 +105,7 @@ function parseTableStyleParts(el) {
 		if (!cond) continue;
 		const typeAttr = getAttr(cond, "type");
 		if (!typeAttr || !CONDITION_TYPES.has(typeAttr)) continue;
-		const layer = parseTableStyleLayer(cond);
+		const layer = parseTableStyleLayer(cond, themeFonts);
 		if (layer) conditions.push({
 			type: typeAttr,
 			layer
@@ -114,7 +114,7 @@ function parseTableStyleParts(el) {
 	if (conditions.length > 0) out.tableConditions = conditions;
 	return out;
 }
-function parseTableStyleLayer(el) {
+function parseTableStyleLayer(el, themeFonts) {
 	const tblPr = asElement(el["w:tblPr"]);
 	const tcPr = asElement(el["w:tcPr"]);
 	const borders = parseFlatBorders(tblPr ? asElement(tblPr["w:tblBorders"]) : void 0) ?? parseFlatBorders(tcPr ? asElement(tcPr["w:tcBorders"]) : void 0);
@@ -124,8 +124,8 @@ function parseTableStyleLayer(el) {
 	const indType = tblInd ? getAttr(tblInd, "type") : void 0;
 	const indentPt = indW !== void 0 && (indType === void 0 || indType === "dxa") ? twipsToPt(indW) : void 0;
 	const shading = parseFlatShading(tcPr ? tcPr["w:shd"] : void 0);
-	const runProperties = parseRunProperties(el["w:rPr"]);
-	const paragraphProperties = parseParagraphProperties(el["w:pPr"]);
+	const runProperties = parseRunProperties(el["w:rPr"], themeFonts);
+	const paragraphProperties = parseParagraphProperties(el["w:pPr"], 0, themeFonts);
 	const layer = {
 		...borders ? { borders } : {},
 		...cellMargins ? { cellMargins } : {},

package/dist/esm/word/table-parser.js

@@ -115,11 +115,11 @@ function parseTable(tbl, ctx = DEFAULT_PARSE_CONTEXT) {
 function poChildrenThroughSdt(node, tag) {
 	return childrenThroughSdt(node, tag).map((c) => c.node);
 }
-function childrenThroughSdt(node, tag) {
+function childrenThroughSdt(node, tag, themeFonts) {
 	const out = [];
 	for (const child of poChildren(node)) if (poIs(child, tag)) out.push({ node: child });
 	else if (poIs(child, "w:sdt")) {
-		const props = sdtRunProperties(child);
+		const props = sdtRunProperties(child, themeFonts);
 		for (const inner of poChildrenWith(poFirstChild(child, "w:sdtContent"), tag)) out.push({
 			node: inner,
 			...props ? { sdtRunProps: props } : {}
@@ -270,7 +270,7 @@ function isDeletedRow(tr) {
 function parseTableRow(tr, ctx) {
 	const properties = parseRowProperties(poFirstChild(tr, "w:trPr"));
 	const cells = [];
-	for (const { node, sdtRunProps } of childrenThroughSdt(tr, "w:tc")) cells.push(parseTableCell(node, ctx, sdtRunProps));
+	for (const { node, sdtRunProps } of childrenThroughSdt(tr, "w:tc", ctx.themeFonts)) cells.push(parseTableCell(node, ctx, sdtRunProps));
 	return {
 		properties,
 		cells

package/dist/esm/word/theme-fonts.d.ts

@@ -0,0 +1,10 @@
+import { ThemeFonts } from '../core/drawingml/theme-parser.js';
+/**
+ * Resolve a `w:rFonts` theme attribute to the typeface it stands for.
+ *
+ * @param value The attribute as written (`minorHAnsi`, `majorBidi`, …).
+ * @param fonts The theme's font scheme, when the part was read.
+ * @returns The typeface, or `undefined` for an unknown slot, a missing theme,
+ *          or a slot the theme leaves empty.
+ */
+export declare function resolveWordThemeFont(value: string | undefined, fonts: ThemeFonts | undefined): string | undefined;

package/dist/esm/word/theme-fonts.js

@@ -0,0 +1,28 @@
+//#region src/word/theme-fonts.ts
+var THEME_SLOTS = new Map([
+	["majorascii", ["major", "latin"]],
+	["majorhansi", ["major", "latin"]],
+	["majoreastasia", ["major", "ea"]],
+	["majorbidi", ["major", "cs"]],
+	["minorascii", ["minor", "latin"]],
+	["minorhansi", ["minor", "latin"]],
+	["minoreastasia", ["minor", "ea"]],
+	["minorbidi", ["minor", "cs"]]
+]);
+/**
+* Resolve a `w:rFonts` theme attribute to the typeface it stands for.
+*
+* @param value The attribute as written (`minorHAnsi`, `majorBidi`, …).
+* @param fonts The theme's font scheme, when the part was read.
+* @returns The typeface, or `undefined` for an unknown slot, a missing theme,
+*          or a slot the theme leaves empty.
+*/
+function resolveWordThemeFont(value, fonts) {
+	if (value === void 0 || !fonts) return void 0;
+	const slot = THEME_SLOTS.get(value.trim().toLowerCase());
+	if (!slot) return void 0;
+	const [which, script] = slot;
+	return fonts[which][script];
+}
+//#endregion
+export { resolveWordThemeFont };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reamkit",
-  "version": "1.22.0",
+  "version": "1.23.0",
   "description": "Ream — convert DOCX, XLSX, PPTX and PDF to PDF, SVG, HTML, DOCX and XLSX, built from scratch on the ECMA-376 and ISO 32000 specifications. Parse once, convert anywhere.",
   "license": "MIT",
   "author": "Alex Krassavin <info@reamkit.dev>",