reamkit 1.22.0 → 1.24.0

package/dist/esm/pdf/shading.js

@@ -284,14 +284,16 @@ function normalizeStops(stops) {
 		colorHex: "000000",
 		alpha: 1
 	}];
-	out[0] = {
-		...out[0],
+	const first = out[0];
+	if (first.offset > 0) out.unshift({
+		...first,
 		offset: 0
-	};
-	out[out.length - 1] = {
-		...out[out.length - 1],
+	});
+	const last = out[out.length - 1];
+	if (last.offset < 1) out.push({
+		...last,
 		offset: 1
-	};
+	});
 	return out;
 }
 function rgb01(hex) {

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

@@ -7,6 +7,7 @@ import { GLUE_SHRINK_RATIO } from "../layout/styled-layout.js";
 import { paintPlan } from "../layout/page-doc.js";
 import { emitClipPath, emitVectorShape, shadowBlurLayers } from "./vector-graphics.js";
 import { buildGradientAlphaMask, buildGradientPattern, shapeBbox } from "./shading.js";
+import { warpGlyphMatrix } from "../core/drawingml/text-warp.js";
 import { sanitizeHref } from "../core/links.js";
 import { embedAssociatedFile } from "./embedded-file.js";
 import { buildSrgbIccProfile } from "./icc-profile.js";
@@ -111,7 +112,11 @@ function assembleStyledPdf(laid, options, doc) {
 	if (!pdfaProfile) for (const page of renderedPages) {
 		const ph = page.height;
 		const plan = paintPlan(page.commands);
-		const shapesNeedingPatterns = [...plan.shapes, ...[...plan.behind, ...plan.pictures.flat()].filter((i) => i.type === "shape")];
+		const shapesNeedingPatterns = [...plan.shapes, ...[
+			...plan.behind,
+			...plan.pictures.flat(),
+			...plan.ordered.flat()
+		].filter((i) => i.type === "shape")];
 		for (const item of shapesNeedingPatterns) {
 			const gradient = item.shape.fillGradient;
 			if (!gradient) continue;
@@ -211,7 +216,11 @@ function assembleStyledPdf(laid, options, doc) {
 			wantAlpha(img.alpha);
 			wantDuotone(img, page.height);
 		}
-		for (const item of [...plan.behind, ...plan.pictures.flat()]) {
+		for (const item of [
+			...plan.behind,
+			...plan.pictures.flat(),
+			...plan.ordered.flat()
+		]) {
 			if (item.type === "image") {
 				wantAlpha(washVeil(item.wash)?.alpha);
 				wantAlpha(item.alpha);
@@ -621,6 +630,7 @@ var BORDER_DASHES = new Map([
 		2.5
 	]]
 ]);
+var FAUX_ITALIC_SHEAR = .2126;
 /** The PDF dash array for a border style; an empty string means a solid rule. */
 function dashPatternFor(style) {
 	const pattern = style !== void 0 ? BORDER_DASHES.get(style) : void 0;
@@ -642,6 +652,8 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 	let lastTc = 0;
 	let lastSize = -1;
 	let lastColor = "";
+	let lastFauxWidth = 0;
+	let lastTz = 100;
 	const switchFontIfNeeded = (tok) => {
 		const fontKey = tok.font.resourceName;
 		if (fontKey !== lastFont || tok.fontSizePt !== lastSize) {
@@ -649,6 +661,16 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 			lastFont = fontKey;
 			lastSize = tok.fontSizePt;
 		}
+		const fauxWidth = tok.synthetic?.bold === true ? tok.fontSizePt * .03 : 0;
+		if (fauxWidth !== lastFauxWidth) {
+			out.push(fauxWidth > 0 ? `2 Tr ${formatNumber(fauxWidth)} w` : "0 Tr");
+			lastFauxWidth = fauxWidth;
+		}
+		const tz = Math.round((tok.synthetic?.widthScale ?? 1) * 100);
+		if (tz !== lastTz) {
+			out.push(`${formatNumber(tz)} Tz`);
+			lastTz = tz;
+		}
 		const tc = tok.resolvedRun.letterSpacingPt ?? 0;
 		if (tc !== lastTc) {
 			out.push(`${formatNumber(tc)} Tc`);
@@ -670,6 +692,12 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 			const b = tok.drawBox;
 			const ox = x + (b?.dxPt ?? 0);
 			const oy = baselineY + (b?.dyPt ?? 0);
+			for (const img of meta.images ?? []) {
+				if (img.resourceName === "") continue;
+				out.push("q");
+				out.push(...placeImage(ox + img.x, oy + img.y, img.width, img.height, void 0, img.rotationDeg));
+				out.push(`/${img.resourceName} Do`, "Q");
+			}
 			for (const sh of meta.shapes) for (const op of emitVectorShape({
 				...sh,
 				transform: [
@@ -693,6 +721,8 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 				out.push("ET");
 			}
 			lastFont = "";
+			lastFauxWidth = 0;
+			lastTz = 100;
 			lastSize = -1;
 			lastColor = "";
 			return;
@@ -739,6 +769,8 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 			out.push("Q");
 		}
 		lastFont = "";
+		lastFauxWidth = 0;
+		lastTz = 100;
 		lastSize = -1;
 		lastColor = "";
 		lastTc = 0;
@@ -771,6 +803,8 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 			out.push("f");
 			out.push("Q");
 			lastFont = "";
+			lastFauxWidth = 0;
+			lastTz = 100;
 			lastSize = -1;
 			lastColor = "";
 		} else {
@@ -796,6 +830,8 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 			};
 			for (const op of emitVectorShape(shape)) out.push(op);
 			lastFont = "";
+			lastFauxWidth = 0;
+			lastTz = 100;
 			lastSize = -1;
 			lastColor = "";
 		}
@@ -813,6 +849,8 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 		out.push("q");
 		out.push(`${formatNumber(clip.x)} ${formatNumber(H - clip.y - clip.height)} ${formatNumber(clip.width)} ${formatNumber(clip.height)} re W n`);
 		lastFont = "";
+		lastFauxWidth = 0;
+		lastTz = 100;
 		lastSize = -1;
 		lastColor = "";
 		lastTc = 0;
@@ -825,6 +863,8 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 		}
 		out.push("Q");
 		lastFont = "";
+		lastFauxWidth = 0;
+		lastTz = 100;
 		lastSize = -1;
 		lastColor = "";
 		lastTc = 0;
@@ -977,6 +1017,35 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 			out.push("Q");
 		}
 		const hasRise = line.tokens.some((t) => t.kind === "text" && t.risePt !== void 0);
+		const hasFauxItalic = line.tokens.some((t) => t.kind === "text" && t.synthetic?.italic === true);
+		const warp = cmd.warp;
+		if (warp) {
+			if (!inBT) {
+				out.push("BT");
+				inBT = true;
+			}
+			let cursor = originX;
+			for (const tok of line.tokens) {
+				if (tok.kind !== "text" || tok.isSpace) {
+					cursor += tok.widthPt;
+					continue;
+				}
+				switchFontIfNeeded(tok);
+				const chars = [...tok.text];
+				const raw = chars.map((c) => tok.font.measure.textWidthPt(c, tok.fontSizePt));
+				const total = raw.reduce((a, b) => a + b, 0);
+				const k = total > 0 ? tok.widthPt / total : 1;
+				for (let i = 0; i < chars.length; i++) {
+					const adv = raw[i] * k;
+					const m = warpGlyphMatrix(warp, cursor, adv, cmd.baselineY);
+					cursor += adv;
+					if (!m) continue;
+					out.push(`${formatNumber(m[0])} ${formatNumber(-m[1])} ${formatNumber(m[2])} ${formatNumber(-m[3])} ${formatNumber(m[4])} ${formatNumber(H - m[5])} Tm`);
+					out.push(tok.font.measure.showText(chars[i]));
+				}
+			}
+			return;
+		}
 		if (rotationDeg !== 0 && !hasImageToken && !hasMathToken) {
 			if (!inBT) {
 				out.push("BT");
@@ -991,7 +1060,7 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 				switchFontIfNeeded(tok);
 				out.push(tok.font.measure.showText(tok.text));
 			}
-		} else if (extraPerSpace !== 0 || hasImageToken || hasMathToken || hasRtl || hasRise || hasTab) {
+		} else if (extraPerSpace !== 0 || hasImageToken || hasMathToken || hasRtl || hasRise || hasFauxItalic || hasTab) {
 			const order = hasRtl ? lineVisualOrder(line) : line.tokens.map((_, i) => i);
 			let x = originX;
 			for (const ti of order) {
@@ -1013,7 +1082,8 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 					inBT = true;
 				}
 				switchFontIfNeeded(tok);
-				out.push(`1 0 0 1 ${formatNumber(x)} ${formatNumber(baselineY + (tok.risePt ?? 0))} Tm`);
+				const slant = tok.synthetic?.italic === true ? FAUX_ITALIC_SHEAR : 0;
+				out.push(`1 0 ${formatNumber(slant)} 1 ${formatNumber(x)} ${formatNumber(baselineY + (tok.risePt ?? 0))} Tm`);
 				out.push(showToken(tok));
 				const tokenX0 = x;
 				x += tok.widthPt;
@@ -1071,6 +1141,7 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 		if (item.type === "shape") {
 			const t = item.shape.transform;
 			const fillAlpha = item.shape.fillAlpha;
+			const layer = item.shape.shadow ? shadowBlurLayers(item.shape.shadow) : void 0;
 			for (const op of emitVectorShape({
 				...item.shape,
 				transform: [
@@ -1081,7 +1152,7 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 					t[4],
 					H - t[5]
 				]
-			}, gradientNames?.get(item.shape), void 0, gradientMaskNames?.get(item.shape) ?? (fillAlpha !== void 0 && fillAlpha < 1 ? alphaStateNames?.get(Math.round(fillAlpha * 1e3) / 1e3) : void 0))) out.push(op);
+			}, gradientNames?.get(item.shape), layer && layer.alpha < 1 ? alphaStateNames?.get(Math.round(layer.alpha * 1e3) / 1e3) : void 0, gradientMaskNames?.get(item.shape) ?? (fillAlpha !== void 0 && fillAlpha < 1 ? alphaStateNames?.get(Math.round(fillAlpha * 1e3) / 1e3) : void 0))) out.push(op);
 			return;
 		}
 		if (item.type === "image") {
@@ -1254,6 +1325,7 @@ function emitPageContent(page, tagging, gradientNames, alphaStateNames, duotoneS
 		for (const item of run) emitInOrder(item);
 		if (tagging) out.push("EMC");
 	}
+	for (const run of plan.ordered) for (const item of run) emitInOrder(item);
 	emitLinesPass();
 	return {
 		content: encoder.encode(out.join("\n")),

package/dist/esm/pdf/vector-graphics.js

@@ -31,7 +31,7 @@ function shadowBlurLayers(shadow) {
 	const count = Math.min(8, Math.max(2, Math.round(shadow.blurPt / 2)));
 	return {
 		count,
-		alpha: shadow.alpha / count
+		alpha: 1 - Math.pow(1 - shadow.alpha, 1 / count)
 	};
 }
 function shadowBbox(shape) {

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

@@ -1,8 +1,8 @@
 import { PDF_NULL, PdfHexString, PdfName, PdfStream } from "../pdf/objects.js";
+import { encodePng } from "../core/png-encode.js";
 import { lzwDecodeMsb } from "../core/lzw.js";
 import { reversePredictor } from "./predictor.js";
 import { decodeCcitt } from "./ccitt.js";
-import { encodePng } from "./png-encode.js";
 import { unzlibSync } from "fflate";
 //#region src/pdf-reader/image-decode.ts
 var MAX_PIXELS = 4e7;

package/dist/esm/pptx/embedded-fonts.d.ts

@@ -0,0 +1,31 @@
+import { Loss } from '../core/ir/index.js';
+import { OpcPackage } from '../core/opc/index.js';
+import { PoNode } from '../core/po-helpers.js';
+import { FontRegistry } from '../core/font/index.js';
+/** What an `fntdata` part turned out to hold. */
+type FaceBytes = {
+    readonly kind: 'font';
+    readonly bytes: Uint8Array;
+} | {
+    readonly kind: 'compressed';
+} | {
+    readonly kind: 'unreadable';
+};
+/**
+ * Read one `fntdata` part: the font itself when the container stores it
+ * plainly, and what stopped it otherwise.
+ *
+ * @param data The part's bytes.
+ */
+export declare function readFntData(data: Uint8Array): FaceBytes;
+/**
+ * §19.2.1.13 — the fonts a deck embeds, by normalized family name.
+ *
+ * @param pkg      The opened `.pptx` package.
+ * @param presPath The presentation part's path (relationships resolve from it).
+ * @param pres     Its parsed `p:presentation` element.
+ * @param onLoss   Where a face that cannot be unpacked records itself.
+ * @returns The families whose faces were readable (empty when none were).
+ */
+export declare function loadPptxEmbeddedFonts(pkg: OpcPackage, presPath: string, pres: PoNode | undefined, onLoss: (loss: Loss) => void): Map<string, FontRegistry>;
+export {};

package/dist/esm/pptx/embedded-fonts.js

@@ -0,0 +1,104 @@
+import { FontRegistry } from "../core/font/font-registry.js";
+import { poAttr, poChildren, poIs } from "../core/po-helpers.js";
+//#region src/pptx/embedded-fonts.ts
+var REL_FONT = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/font";
+/** §19.2.1.13 — the four faces a `p:embeddedFont` may name, by element. */
+var VARIANTS = [
+	["p:regular", "regular"],
+	["p:bold", "bold"],
+	["p:italic", "italic"],
+	["p:boldItalic", "boldItalic"]
+];
+var EOT_VERSIONS = new Set([
+	65536,
+	131073,
+	131074
+]);
+var TTEMBED_TTCOMPRESSED = 4;
+var TTEMBED_XORENCRYPTDATA = 268435456;
+/**
+* Read one `fntdata` part: the font itself when the container stores it
+* plainly, and what stopped it otherwise.
+*
+* @param data The part's bytes.
+*/
+function readFntData(data) {
+	if (isSfnt(data)) return {
+		kind: "font",
+		bytes: data
+	};
+	if (data.length < 82) return { kind: "unreadable" };
+	const v = new DataView(data.buffer, data.byteOffset, data.byteLength);
+	const eotSize = v.getUint32(0, true);
+	const version = v.getUint32(8, true);
+	const flags = v.getUint32(12, true);
+	if (eotSize !== data.length || !EOT_VERSIONS.has(version)) return { kind: "unreadable" };
+	if ((flags & (TTEMBED_TTCOMPRESSED | TTEMBED_XORENCRYPTDATA)) !== 0) return { kind: "compressed" };
+	let at = 82;
+	for (let i = 0; i < 4; i++) {
+		if (at + 2 > data.length) return { kind: "unreadable" };
+		at += 2 + v.getUint16(at, true) + 2;
+	}
+	if (version !== 65536) {
+		if (at + 2 > data.length) return { kind: "unreadable" };
+		at += 2 + v.getUint16(at, true);
+		at = data.length - v.getUint32(4, true);
+	}
+	const bytes = data.subarray(at);
+	return isSfnt(bytes) ? {
+		kind: "font",
+		bytes
+	} : { kind: "unreadable" };
+}
+/**
+* §19.2.1.13 — the fonts a deck embeds, by normalized family name.
+*
+* @param pkg      The opened `.pptx` package.
+* @param presPath The presentation part's path (relationships resolve from it).
+* @param pres     Its parsed `p:presentation` element.
+* @param onLoss   Where a face that cannot be unpacked records itself.
+* @returns The families whose faces were readable (empty when none were).
+*/
+function loadPptxEmbeddedFonts(pkg, presPath, pres, onLoss) {
+	const out = /* @__PURE__ */ new Map();
+	const list = pres ? poChildren(pres).find((c) => poIs(c, "p:embeddedFontLst")) : void 0;
+	if (!list) return out;
+	const relById = new Map(pkg.getPartRelationships(presPath).map((r) => [r.id, r]));
+	for (const font of poChildren(list).filter((c) => poIs(c, "p:embeddedFont"))) {
+		const bytes = {};
+		let compressed = false;
+		for (const [tag, variant] of VARIANTS) {
+			const node = poChildren(font).find((c) => poIs(c, tag));
+			const rId = node ? poAttr(node, "r:id") : void 0;
+			const rel = rId !== void 0 ? relById.get(rId) : void 0;
+			if (!rel || rel.type !== REL_FONT) continue;
+			const part = pkg.resolveRelatedPart(presPath, rel);
+			if (!part) continue;
+			const face = readFntData(part.data);
+			if (face.kind === "compressed") compressed = true;
+			if (face.kind === "font") bytes[variant] = face.bytes;
+		}
+		const typeface = poChildren(font).find((c) => poIs(c, "p:font"));
+		const name = (typeface ? poAttr(typeface, "typeface") : void 0)?.trim() ?? "";
+		if (bytes.regular) try {
+			out.set(name.toLowerCase(), FontRegistry.fromBytes({
+				...bytes,
+				regular: bytes.regular
+			}));
+			continue;
+		} catch {}
+		if (compressed) onLoss({
+			feature: "font",
+			detail: `the deck embeds ${name || "a font"}, packed with MicroType Express (EOT TTEMBED_TTCOMPRESSED); it renders in a substitute`,
+			severity: "substituted"
+		});
+	}
+	return out;
+}
+function isSfnt(data) {
+	if (data.length < 4) return false;
+	const sig = (data[0] << 24 | data[1] << 16 | data[2] << 8 | data[3]) >>> 0;
+	return sig === 65536 || sig === 1330926671 || sig === 1953658213 || sig === 1953784678;
+}
+//#endregion
+export { loadPptxEmbeddedFonts };

package/dist/esm/pptx/placeholder-cascade.d.ts

@@ -1,7 +1,9 @@
 import { ParagraphProperties, RunProperties } from '../core/document-model/index.js';
 import { ColorResolver } from '../core/drawingml/colors.js';
+import { ThemeFonts } from '../core/drawingml/theme-parser.js';
 import { PoNode } from '../core/po-helpers.js';
 import { PlaceholderRef, ShapeBoxEmu } from './sp-helpers.js';
+import { Pt } from '../core/ir/index.js';
 /**
  * The placeholder cascade (PX2): the resolver a slide parser consults whenever a
  * slide placeholder shape (`p:sp` with a `p:ph`) lacks its own geometry or run
@@ -27,17 +29,32 @@ export interface PlaceholderCascade {
      */
     readonly anchorFor: (ph: PlaceholderRef) => 't' | 'ctr' | 'b' | undefined;
     /**
-     * The prototype's own `p:spPr`, for the properties a slide placeholder
-     * inherits rather than states: its fill, its outline, its geometry. The
-     * layout's before the master's.
+     * The prototypes' own `p:spPr`, nearest first — the layout's, then the
+     * master's — for the properties a slide placeholder inherits rather than
+     * states: its fill, its outline, its geometry.
+     *
+     * A CHAIN and not one node, because the inheritance is per property. The
+     * layout's prototype may state a box and nothing else, and the fill then
+     * comes from the master: tdf104015's title is red in every reader and was a
+     * bare outline here, because the layout's `p:spPr` existed and stopped the
+     * search.
      */
-    readonly shapePropsFor: (ph: PlaceholderRef) => PoNode | undefined;
+    readonly shapePropsFor: (ph: PlaceholderRef) => ReadonlyArray<PoNode>;
 }
 /** One level of a text style: how its paragraphs sit and how their runs read. */
 interface LevelStyle {
     readonly run: RunProperties;
     readonly paragraph: ParagraphProperties;
     readonly bullet?: LevelBullet;
+    /**
+     * §21.1.2.2.9/.10 — the space around the paragraph stated as a FRACTION of a
+     * line rather than a distance. A fraction of WHAT is only known once the
+     * levels have merged and the size is settled, so it travels this far raw.
+     */
+    readonly spacingPct?: {
+        readonly before?: number;
+        readonly after?: number;
+    };
 }
 /**
  * §21.1.2.4.4/.5/.6 — the bullet a level declares: none at all, a literal
@@ -78,8 +95,24 @@ export declare function parseBullet(pPr: PoNode | undefined, colors?: ColorResol
  * @param layoutTree The parsed `p:sldLayout` part.
  * @param masterTree The parsed `p:sldMaster` part, when present.
  * @param colors     The deck's colour resolver, for scheme colours in the text styles.
+ * @param deckDefaults The presentation's own default text style, as the floor.
+ * @param themeFonts The theme's font scheme, for the `+mn-lt` tokens.
+ */
+export declare function buildPlaceholderCascade(layoutTree: ReadonlyArray<PoNode>, masterTree: ReadonlyArray<PoNode> | undefined, colors: ColorResolver, deckDefaults?: ReadonlyArray<LevelStyle>, themeFonts?: ThemeFonts): PlaceholderCascade;
+/**
+ * §21.1.2.2.9/.10 — the space a paragraph states as a FRACTION of a line, in
+ * points.
+ *
+ * A "line" here is the paragraph's own text at its natural height, which is the
+ * size times the same 1.2 the layout gives an unstated line. A level that
+ * states the fraction and leaves the size to another level is resolved once
+ * they have merged, which is why this is not read where the fraction is.
+ *
+ * @param pct      The fraction, `0..n` (20% arrives as 0.2).
+ * @param sizePt   The paragraph's resolved font size.
+ * @returns The distance, or `undefined` when the size is not known.
  */
-export declare function buildPlaceholderCascade(layoutTree: ReadonlyArray<PoNode>, masterTree: ReadonlyArray<PoNode> | undefined, colors: ColorResolver, deckDefaults?: ReadonlyArray<LevelStyle>): PlaceholderCascade;
+export declare function spacingFromLineFraction(pct: number | undefined, sizePt: number | undefined): Pt | undefined;
 /**
  * `a:lstStyle` (or a `p:txStyles` family) → its nine levels. Shared by the
  * deck's default text style, the master's families and a prototype's own list,
@@ -90,5 +123,39 @@ export declare function buildPlaceholderCascade(layoutTree: ReadonlyArray<PoNode
  * @param prefix The level element prefix: `a:lvl` here, always.
  * @returns The nine levels, or an empty list when there is no such node.
  */
-export declare function parseLevelStyles(list: PoNode | undefined, colors: ColorResolver): Array<LevelStyle>;
+export declare function parseLevelStyles(list: PoNode | undefined, colors: ColorResolver, themeFonts?: ThemeFonts): Array<LevelStyle>;
+/**
+ * A level's paragraph shape — §21.1.2.2.7 `@algn`, `@marL`/`@indent`, and the
+ * space around and between its lines.
+ *
+ * Both spacings come in two spellings: `a:spcPts` is a distance (hundredths of
+ * a point) and `a:spcPct` a FRACTION of a line (thousandths of a percent). Only
+ * the distance was read, so a deck that spaces its bullets the usual way — by
+ * fraction — set them solid.
+ */
+export declare function pPrToParagraphProps(lvlPr: PoNode | undefined): ParagraphProperties;
+/**
+ * §21.1.2.2.5 `a:lnSpc` — the height of each line: a fraction of the natural
+ * one (`a:spcPct`) or a distance (`a:spcPts`).
+ *
+ * The model states a multiple the way §17.3.1.33 does — 12pt under the `auto`
+ * rule IS single — so a fraction needs no font size to express, which is why
+ * this resolves here and the paragraph SPACING has to wait for the size.
+ *
+ * @param pPr The paragraph properties (a level's or a paragraph's own).
+ * @returns The line spacing, or nothing when the node states none.
+ */
+export declare function lineSpacing(pPr: PoNode | undefined): ParagraphProperties;
+/**
+ * §21.1.2.2.9/.10 — the fraction of a line a paragraph puts before and after
+ * itself, when it states one. The distance form is read beside it; this is what
+ * the caller must still resolve against the size.
+ *
+ * @param pPr The paragraph properties.
+ * @returns The two fractions (`0..n`), each present only when stated.
+ */
+export declare function spacingFractions(pPr: PoNode | undefined): {
+    readonly before?: number;
+    readonly after?: number;
+} | undefined;
 export {};