reamkit 1.33.1 → 1.34.0

package/dist/esm/core/fonts/families.d.ts

@@ -4,6 +4,10 @@ import { FlowDoc } from '../ir/flow.js';
  * The curated substitute families a document's text needs, always including the
  * sans default as the fallback for unstyled runs, math and chart labels.
  *
+ * §17.3.2.26 — a run names a family per slot, and the text decides which slots
+ * are drawn from (see {@link fontSlotOf}): the hAnsi family of a document all
+ * in ASCII is never asked for, and is not fetched.
+ *
  * @param flow The parsed document.
  * @returns One {@link FamilyKey} per distinct family the document names.
  */

package/dist/esm/core/fonts/families.js

@@ -1,33 +1,64 @@
 import { resolveFamilyKey } from "./remote-fonts.js";
+import { fontSlotOf } from "./scripts.js";
 //#region src/core/fonts/families.ts
+var SLOTS = [
+	"ascii",
+	"hAnsi",
+	"eastAsia",
+	"cs"
+];
 /**
 * The curated substitute families a document's text needs, always including the
 * sans default as the fallback for unstyled runs, math and chart labels.
 *
+* §17.3.2.26 — a run names a family per slot, and the text decides which slots
+* are drawn from (see {@link fontSlotOf}): the hAnsi family of a document all
+* in ASCII is never asked for, and is not fetched.
+*
 * @param flow The parsed document.
 * @returns One {@link FamilyKey} per distinct family the document names.
 */
 function familiesInFlow(flow) {
-	const names = /* @__PURE__ */ new Set();
-	const add = (name) => {
-		if (name !== void 0 && name.trim() !== "") names.add(name.trim().toLowerCase());
+	const names = {
+		ascii: /* @__PURE__ */ new Set(),
+		hAnsi: /* @__PURE__ */ new Set(),
+		eastAsia: /* @__PURE__ */ new Set(),
+		cs: /* @__PURE__ */ new Set()
+	};
+	const used = /* @__PURE__ */ new Set(["ascii"]);
+	const add = (props) => {
+		for (const slot of SLOTS) {
+			const name = props?.fontFamily?.[slot];
+			if (name !== void 0 && name.trim() !== "") names[slot].add(name.trim().toLowerCase());
+		}
+		if (props?.rtl === true) used.add("cs");
+	};
+	const read = (text) => {
+		for (const ch of text) {
+			if (used.size === SLOTS.length) return;
+			const cp = ch.codePointAt(0) ?? 0;
+			if (cp > 127) used.add(fontSlotOf(cp));
+		}
 	};
-	add(flow.styles.defaultRunProperties.fontFamily?.ascii);
+	add(flow.styles.defaultRunProperties);
 	for (const style of flow.styles.styles.values()) {
-		add(style.runProperties.fontFamily?.ascii);
-		add(style.paragraphProperties.runProperties?.fontFamily?.ascii);
-		add(style.tableLayer?.runProperties?.fontFamily?.ascii);
-		for (const c of style.tableConditions ?? []) add(c.layer.runProperties?.fontFamily?.ascii);
+		add(style.runProperties);
+		add(style.paragraphProperties.runProperties);
+		add(style.tableLayer?.runProperties);
+		for (const c of style.tableConditions ?? []) add(c.layer.runProperties);
 	}
-	for (const abstract of flow.numbering?.abstractNums.values() ?? []) for (const level of abstract.levels.values()) add(level.runProperties.fontFamily?.ascii);
+	for (const abstract of flow.numbering?.abstractNums.values() ?? []) for (const level of abstract.levels.values()) add(level.runProperties);
 	const shapeText = (shape) => {
 		if (shape.text) visit(shape.text.content);
 		for (const child of shape.children ?? []) shapeText(child.shape);
 	};
 	const visit = (elements) => {
 		for (const el of elements) if (el.kind === "paragraph") {
-			add(el.paragraph.properties.runProperties?.fontFamily?.ascii);
-			for (const run of el.paragraph.runs) add(run.properties.fontFamily?.ascii);
+			add(el.paragraph.properties.runProperties);
+			for (const run of el.paragraph.runs) {
+				add(run.properties);
+				read(run.text);
+			}
 		} else if (el.kind === "table") {
 			for (const row of el.table.rows) for (const cell of row.cells) visit(cell.content);
 			visit(el.table.overlay?.drawings ?? []);
@@ -39,7 +70,7 @@ function familiesInFlow(flow) {
 	for (const note of flow.endnotes?.values() ?? []) visit(note);
 	for (const comment of flow.comments?.values() ?? []) visit(comment.content);
 	const keys = /* @__PURE__ */ new Set(["arimo"]);
-	for (const name of names) keys.add(resolveFamilyKey(name));
+	for (const slot of used) for (const name of names[slot]) keys.add(resolveFamilyKey(name));
 	return keys;
 }
 //#endregion

package/dist/esm/core/fonts/provider.js

@@ -1,5 +1,6 @@
 import { fetchFontSet, resolveFamilyKey } from "./remote-fonts.js";
 import { pickVariant } from "../font/font-registry.js";
+import "../font/index.js";
 //#region src/core/fonts/provider.ts
 /** The shared `none` answer — a provider that cannot satisfy a request. */
 var NO_FONT = { kind: "none" };

package/dist/esm/core/fonts/remote-fonts.d.ts

@@ -5,13 +5,15 @@ export type FamilyKey = 'arimo' | 'tinos' | 'cousine' | 'carlito' | 'caladea';
  * A WRITING SYSTEM the curated five cannot draw at all. They are Latin families
  * — Greek, Cyrillic and Hebrew ride along, everything else is a notdef box —
  * and 2145 characters of the corpus fall outside them: Han, Kana, Hangul,
- * Arabic, the geometric symbols a form's checkbox is made of.
+ * Arabic, the geometric symbols a form's checkbox is made of. The scripts of
+ * India are outside them too, and a line of Hindi, Tamil or Bengali came out
+ * as a row of boxes.
  *
  * These are fetched only when a document actually holds such a character, and
  * only in the regular weight: Noto Sans SC is ten megabytes, and a bold run in
  * it is better stroked (see `SyntheticFace`) than downloaded four times over.
  */
-export type ScriptKey = 'jp' | 'kr' | 'sc' | 'arabic' | 'hebrew' | 'thai' | 'symbols1' | 'symbols2';
+export type ScriptKey = 'jp' | 'kr' | 'sc' | 'arabic' | 'hebrew' | 'thai' | 'devanagari' | 'bengali' | 'gurmukhi' | 'gujarati' | 'oriya' | 'tamil' | 'telugu' | 'kannada' | 'malayalam' | 'symbols1' | 'symbols2';
 /** Either kind of substitute — a Latin family or a per-script face. */
 export type SubstituteKey = FamilyKey | ScriptKey;
 /** Whether a substitute key names a writing system rather than a Latin family. */

package/dist/esm/core/fonts/remote-fonts.js

@@ -31,6 +31,42 @@ var SCRIPTS = {
 		pkg: "noto-sans-thai",
 		file: "NotoSansThai"
 	},
+	devanagari: {
+		pkg: "noto-sans-devanagari",
+		file: "NotoSansDevanagari"
+	},
+	bengali: {
+		pkg: "noto-sans-bengali",
+		file: "NotoSansBengali"
+	},
+	gurmukhi: {
+		pkg: "noto-sans-gurmukhi",
+		file: "NotoSansGurmukhi"
+	},
+	gujarati: {
+		pkg: "noto-sans-gujarati",
+		file: "NotoSansGujarati"
+	},
+	oriya: {
+		pkg: "noto-sans-oriya",
+		file: "NotoSansOriya"
+	},
+	tamil: {
+		pkg: "noto-sans-tamil",
+		file: "NotoSansTamil"
+	},
+	telugu: {
+		pkg: "noto-sans-telugu",
+		file: "NotoSansTelugu"
+	},
+	kannada: {
+		pkg: "noto-sans-kannada",
+		file: "NotoSansKannada"
+	},
+	malayalam: {
+		pkg: "noto-sans-malayalam",
+		file: "NotoSansMalayalam"
+	},
 	symbols1: {
 		pkg: "noto-sans-symbols",
 		file: "NotoSansSymbols"

package/dist/esm/core/fonts/scripts.d.ts

@@ -9,6 +9,25 @@ import { ScriptKey } from './remote-fonts.js';
  *                 {@link scriptsInFlow}); defaults to Simplified.
  */
 export declare function scriptForCodepoint(cp: number, hanFace?: ScriptKey): ScriptKey | undefined;
+/**
+ * §17.3.2.26 — the slot of `w:rFonts` a character is set in: `ascii`,
+ * `hAnsi` (high ANSI), `eastAsia` or `cs` (complex script).
+ */
+export type FontSlot = 'ascii' | 'hAnsi' | 'eastAsia' | 'cs';
+/**
+ * §17.3.2.26 — the slot of a run's fonts Word sets a character in: ASCII in
+ * `ascii`, East Asian text in `eastAsia`, complex script in `cs`, and the rest
+ * above ASCII — Cyrillic, Greek, accented Latin, curly quotes — in `hAnsi`. A
+ * `w:rtl` run is complex script whole (§17.3.2.30), its digits and Latin too.
+ *
+ * Measured in Word for Mac on a run whose ascii font is Verdana and whose
+ * hAnsi one is Courier New: "split" reports Verdana, "Кириллица" Courier New.
+ *
+ * @param cp  The code point.
+ * @param rtl Whether the run is right-to-left.
+ * @returns The slot.
+ */
+export declare function fontSlotOf(cp: number, rtl?: boolean): FontSlot;
 /**
  * The writing systems a document holds text in, beside the Latin one.
  *

package/dist/esm/core/fonts/scripts.js

@@ -20,6 +20,56 @@ var RANGES = [
 		2303,
 		"arabic"
 	],
+	[
+		2304,
+		2403,
+		"devanagari"
+	],
+	[
+		2406,
+		2431,
+		"devanagari"
+	],
+	[
+		2432,
+		2559,
+		"bengali"
+	],
+	[
+		2560,
+		2687,
+		"gurmukhi"
+	],
+	[
+		2688,
+		2815,
+		"gujarati"
+	],
+	[
+		2816,
+		2943,
+		"oriya"
+	],
+	[
+		2944,
+		3071,
+		"tamil"
+	],
+	[
+		3072,
+		3199,
+		"telugu"
+	],
+	[
+		3200,
+		3327,
+		"kannada"
+	],
+	[
+		3328,
+		3455,
+		"malayalam"
+	],
 	[
 		3584,
 		3711,
@@ -30,6 +80,11 @@ var RANGES = [
 		4607,
 		"kr"
 	],
+	[
+		7376,
+		7423,
+		"devanagari"
+	],
 	[
 		8592,
 		8703,
@@ -80,6 +135,11 @@ var RANGES = [
 		40959,
 		"han"
 	],
+	[
+		43232,
+		43263,
+		"devanagari"
+	],
 	[
 		44032,
 		55215,
@@ -125,6 +185,41 @@ function scriptForCodepoint(cp, hanFace = "sc") {
 		if (cp <= hi) return key === "han" ? hanFace : key;
 	}
 }
+/** The scripts Word sets in a run's complex-script font, `w:cs`. */
+var COMPLEX_SCRIPTS = /* @__PURE__ */ new Set([
+	"hebrew",
+	"arabic",
+	"thai",
+	"devanagari",
+	"bengali",
+	"gurmukhi",
+	"gujarati",
+	"oriya",
+	"tamil",
+	"telugu",
+	"kannada",
+	"malayalam"
+]);
+/**
+* §17.3.2.26 — the slot of a run's fonts Word sets a character in: ASCII in
+* `ascii`, East Asian text in `eastAsia`, complex script in `cs`, and the rest
+* above ASCII — Cyrillic, Greek, accented Latin, curly quotes — in `hAnsi`. A
+* `w:rtl` run is complex script whole (§17.3.2.30), its digits and Latin too.
+*
+* Measured in Word for Mac on a run whose ascii font is Verdana and whose
+* hAnsi one is Courier New: "split" reports Verdana, "Кириллица" Courier New.
+*
+* @param cp  The code point.
+* @param rtl Whether the run is right-to-left.
+* @returns The slot.
+*/
+function fontSlotOf(cp, rtl = false) {
+	if (rtl) return "cs";
+	if (cp <= 127) return "ascii";
+	const script = scriptForCodepoint(cp);
+	if (script !== void 0 && COMPLEX_SCRIPTS.has(script)) return "cs";
+	return script === "kr" || script === "jp" || script === "sc" ? "eastAsia" : "hAnsi";
+}
 /**
 * The writing systems a document holds text in, beside the Latin one.
 *
@@ -181,4 +276,4 @@ function scriptsInFlow(flow) {
 	};
 }
 //#endregion
-export { scriptForCodepoint, scriptsInFlow };
+export { fontSlotOf, scriptForCodepoint, scriptsInFlow };

package/dist/esm/core/numbering/apply.js

@@ -1,6 +1,6 @@
 import { pt } from "../ir/units.js";
 import { NumberingState, effectiveAbstract } from "./state.js";
-import { resolveParagraphProperties } from "../style-cascade/resolver.js";
+import { mergeRunPartial, resolveParagraphProperties } from "../style-cascade/resolver.js";
 import "../style-cascade/index.js";
 //#region src/core/numbering/apply.ts
 /** The height a picture bullet takes when neither the level nor the paragraph
@@ -36,6 +36,7 @@ function applyNumbering(body, numbering, styles) {
 		const pic = level?.picBullet;
 		const bulletCapPt = level?.runProperties.fontSizePt ?? p.properties.runProperties?.fontSizePt ?? DEFAULT_BULLET_HEIGHT_PT;
 		const bulletScale = pic ? Math.min(1, bulletCapPt / Math.max(1, pic.heightPt)) : 1;
+		const suffix = level?.suffix ?? "tab";
 		const markerRuns = pic ? [{
 			text: "",
 			properties: {},
@@ -45,18 +46,21 @@ function applyNumbering(body, numbering, styles) {
 				width: pt(pic.widthPt * bulletScale),
 				height: pt(pic.heightPt * bulletScale)
 			}
-		}, {
+		}, ...suffix === "tab" ? [{
 			text: "	",
 			properties: {},
 			listMarker: true
-		}] : [{
-			text: `${marker.replaceAll(SOFT_HYPHEN, "-")}\t`,
-			properties: {
-				...p.properties.runProperties,
-				...level?.runProperties
-			},
+		}] : []] : [{
+			text: `${marker.replaceAll(SOFT_HYPHEN, "-")}${suffix === "tab" ? "	" : ""}`,
+			properties: mergeRunPartial(p.properties.runProperties ?? {}, level?.runProperties ?? {}),
 			listMarker: true
 		}];
+		if (suffix === "space") markerRuns.push({
+			text: " ",
+			properties: markerRuns[0].properties,
+			listMarker: true,
+			listMarkerSpace: true
+		});
 		const newProps = mergeIndentFromLevel(p.properties, level?.paragraphProperties);
 		return {
 			...p,

package/dist/esm/core/style-cascade/index.d.ts

@@ -1,4 +1,4 @@
-export { EMPTY_STYLE_SHEET, resolveBodyStyles, resolveHeadersFootersStyles, resolveParagraphProperties, resolveRunProperties, } from './resolver.js';
+export { EMPTY_STYLE_SHEET, mergeRunPartial, resolveBodyStyles, resolveHeadersFootersStyles, resolveParagraphProperties, resolveRunProperties, } from './resolver.js';
 export type { ResolvedRunProperties, ResolvedParagraphProperties, } from './types.js';
 export { DEFAULT_RESOLVED_RUN, DEFAULT_RESOLVED_PARAGRAPH } from './types.js';
 export { resolveTableStyles } from './table.js';

package/dist/esm/core/style-cascade/index.js

@@ -1,4 +1,4 @@
 import { DEFAULT_RESOLVED_PARAGRAPH, DEFAULT_RESOLVED_RUN } from "./types.js";
-import { EMPTY_STYLE_SHEET, resolveBodyStyles, resolveHeadersFootersStyles, resolveParagraphProperties, resolveRunProperties } from "./resolver.js";
+import { EMPTY_STYLE_SHEET, mergeRunPartial, resolveBodyStyles, resolveHeadersFootersStyles, resolveParagraphProperties, resolveRunProperties } from "./resolver.js";
 import { resolveTableStyles } from "./table.js";
-export { DEFAULT_RESOLVED_PARAGRAPH, DEFAULT_RESOLVED_RUN, EMPTY_STYLE_SHEET, resolveBodyStyles, resolveHeadersFootersStyles, resolveParagraphProperties, resolveRunProperties, resolveTableStyles };
+export { DEFAULT_RESOLVED_PARAGRAPH, DEFAULT_RESOLVED_RUN, EMPTY_STYLE_SHEET, mergeRunPartial, resolveBodyStyles, resolveHeadersFootersStyles, resolveParagraphProperties, resolveRunProperties, resolveTableStyles };

package/dist/esm/core/style-cascade/resolver.d.ts

@@ -24,6 +24,15 @@ export declare function resolveRunProperties(runDirect: RunProperties, paragraph
  * @param sheet           The stylesheet supplying defaults and style chains.
  */
 export declare function resolveParagraphProperties(paragraphDirect: ParagraphProperties, sheet: StyleSheet): ResolvedParagraphProperties;
+/**
+ * Lay one layer of run properties over another (§17.7.2): each property the
+ * higher layer states wins, and each slot of its `w:rFonts` on its own.
+ *
+ * @param base     The lower layer.
+ * @param override The higher layer.
+ * @returns The two as one layer.
+ */
+export declare function mergeRunPartial(base: RunProperties, override: RunProperties): RunProperties;
 /**
  * Resolve the style cascade across an entire body so the tree carries final
  * effective run/paragraph properties (FlowDoc transform, ir-design stage 6).

package/dist/esm/core/style-cascade/resolver.js

@@ -131,7 +131,7 @@ function mergeRun(base, override) {
 		smallCaps: override.smallCaps ?? base.smallCaps,
 		fontSizePt: override.fontSizePt ?? base.fontSizePt,
 		colorHex: override.colorHex ?? base.colorHex,
-		fontFamily: override.fontFamily ?? base.fontFamily,
+		fontFamily: mergeFontFamily(base.fontFamily, override.fontFamily),
 		verticalAlign: override.verticalAlign ?? base.verticalAlign,
 		rtl: override.rtl ?? base.rtl,
 		...lang !== void 0 ? { lang } : {},
@@ -185,8 +185,36 @@ function mergePar(base, override) {
 		...beforeAuto !== void 0 ? { spacingBeforeAuto: beforeAuto } : {}
 	};
 }
+/**
+* Lay one layer of run properties over another (§17.7.2): each property the
+* higher layer states wins, and each slot of its `w:rFonts` on its own.
+*
+* @param base     The lower layer.
+* @param override The higher layer.
+* @returns The two as one layer.
+*/
 function mergeRunPartial(base, override) {
-	return copyDefined(base, override);
+	const out = copyDefined(base, override);
+	const fontFamily = mergeFontFamily(base.fontFamily, override.fontFamily);
+	return fontFamily === void 0 || fontFamily === out.fontFamily ? out : {
+		...out,
+		fontFamily
+	};
+}
+function mergeFontFamily(base, override) {
+	if (override === void 0) return base;
+	if (base === void 0) return override;
+	const ascii = override.ascii ?? base.ascii;
+	const hAnsi = override.hAnsi ?? base.hAnsi;
+	const eastAsia = override.eastAsia ?? base.eastAsia;
+	const cs = override.cs ?? base.cs;
+	if (ascii === override.ascii && hAnsi === override.hAnsi && eastAsia === override.eastAsia && cs === override.cs) return override;
+	return {
+		...ascii !== void 0 ? { ascii } : {},
+		...hAnsi !== void 0 ? { hAnsi } : {},
+		...eastAsia !== void 0 ? { eastAsia } : {},
+		...cs !== void 0 ? { cs } : {}
+	};
 }
 function mergeParPartial(base, override) {
 	const out = copyDefined(base, override);
@@ -291,4 +319,4 @@ function resolveHeadersFootersStyles(hf, sheet) {
 	return hf;
 }
 //#endregion
-export { EMPTY_STYLE_SHEET, resolveBodyStyles, resolveHeadersFootersStyles, resolveParagraphProperties, resolveRunProperties };
+export { EMPTY_STYLE_SHEET, mergeRunPartial, resolveBodyStyles, resolveHeadersFootersStyles, resolveParagraphProperties, resolveRunProperties };

package/dist/esm/core/style-cascade/table.js

@@ -1,3 +1,4 @@
+import { mergeRunPartial } from "./resolver.js";
 //#region src/core/style-cascade/table.ts
 /**
 * Apply table styles across a body (ECMA-376 §17.7.6): for each table, fold its
@@ -88,10 +89,7 @@ function applyLayerToCell(tableCell, layer, directBorders, pos) {
 		};
 		if (layer.runProperties) p.properties = {
 			...p.properties,
-			inheritedRun: {
-				...p.properties.inheritedRun,
-				...layer.runProperties
-			}
+			inheritedRun: mergeRunPartial(p.properties.inheritedRun ?? {}, layer.runProperties)
 		};
 	}
 }
@@ -170,10 +168,7 @@ function mergeLayer(base, override) {
 		} } : {},
 		...(override.indentPt ?? base.indentPt) !== void 0 ? { indentPt: override.indentPt ?? base.indentPt } : {},
 		...override.shading ?? base.shading ? { shading: override.shading ?? base.shading } : {},
-		...override.runProperties ?? base.runProperties ? { runProperties: {
-			...base.runProperties,
-			...definedOnly(override.runProperties ?? {})
-		} } : {},
+		...override.runProperties ?? base.runProperties ? { runProperties: mergeRunPartial(base.runProperties ?? {}, override.runProperties ?? {}) } : {},
 		...override.paragraphProperties ?? base.paragraphProperties ? { paragraphProperties: {
 			...base.paragraphProperties,
 			...definedOnly(override.paragraphProperties ?? {})

package/dist/esm/excel/xlsx-to-pdf.js

@@ -1,6 +1,7 @@
 import { fetchFontSet } from "../core/fonts/remote-fonts.js";
 import { FontRegistry } from "../core/font/font-registry.js";
 import { createFontMeasure } from "../core/font/measure.js";
+import "../core/font/index.js";
 import { signPdf } from "../pdf/signature.js";
 import { renderStyledPdf, renderStyledPdfEncrypted } from "../pdf/styled-page-renderer.js";
 import "../pdf/index.js";

package/dist/esm/index.js

@@ -2,6 +2,7 @@ import { fetchFontSet, resolveFamilyKey } from "./core/fonts/remote-fonts.js";
 import { parseTtf } from "./core/font/ttf-parser.js";
 import { subsetTtf } from "./core/font/ttf-subset.js";
 import { FontRegistry } from "./core/font/font-registry.js";
+import "./core/font/index.js";
 import { eighthPtToPt, emuToPt, halfPtToPt, inchToPt, mmToPt, pt, pxToPt, twipsToPt } from "./core/ir/units.js";
 import { ResourceStore } from "./core/ir/resources.js";
 import { FEATURES } from "./core/ir/features.js";

package/dist/esm/layout/line-paint.d.ts

@@ -28,10 +28,11 @@ export declare function lineVisualOrder(line: Line): Array<number>;
 export declare function computeJustifyExtra(line: Line): number;
 /**
  * Whether a line is ONE text matrix and a run of glyphs: nothing in it placed
- * on its own — a tab, a stretched space, a picture, a formula, a right-to-left
- * run, a rise, a faked italic — and nothing drawn beside its glyphs, a run's
- * shading, a highlight or a rule. Only such a line can be turned by its matrix
- * alone; any other is placed token by token in page space.
+ * on its own — a tab, a list marker's space, a stretched space, a picture, a
+ * formula, a right-to-left run, a rise, a faked italic — and nothing drawn
+ * beside its glyphs, a run's shading, a highlight or a rule. Only such a line
+ * can be turned by its matrix alone; any other is placed token by token in
+ * page space.
  *
  * @param line The laid-out line.
  * @returns True when a single text matrix sets the whole of it.

package/dist/esm/layout/line-paint.js

@@ -70,16 +70,17 @@ function computeJustifyExtra(line) {
 }
 /**
 * Whether a line is ONE text matrix and a run of glyphs: nothing in it placed
-* on its own — a tab, a stretched space, a picture, a formula, a right-to-left
-* run, a rise, a faked italic — and nothing drawn beside its glyphs, a run's
-* shading, a highlight or a rule. Only such a line can be turned by its matrix
-* alone; any other is placed token by token in page space.
+* on its own — a tab, a list marker's space, a stretched space, a picture, a
+* formula, a right-to-left run, a rise, a faked italic — and nothing drawn
+* beside its glyphs, a run's shading, a highlight or a rule. Only such a line
+* can be turned by its matrix alone; any other is placed token by token in
+* page space.
 *
 * @param line The laid-out line.
 * @returns True when a single text matrix sets the whole of it.
 */
 function settableInOneMatrix(line) {
-	return computeJustifyExtra(line) === 0 && line.tokens.every((t) => t.kind === "text" && t.tab !== true && t.bidiLevel % 2 === 0 && t.risePt === void 0 && t.synthetic?.italic !== true && t.highlight !== true && t.resolvedRun.shadingColorHex === void 0 && t.resolvedRun.underline === "none" && !t.resolvedRun.strike);
+	return computeJustifyExtra(line) === 0 && line.tokens.every((t) => t.kind === "text" && t.tab !== true && t.listMarkerSpace !== true && t.bidiLevel % 2 === 0 && t.risePt === void 0 && t.synthetic?.italic !== true && t.highlight !== true && t.resolvedRun.shadingColorHex === void 0 && t.resolvedRun.underline === "none" && !t.resolvedRun.strike);
 }
 /**
 * §14.1.2.10 — the wash a picture is drawn through, as the flat veil it is.

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

@@ -16,6 +16,11 @@ export interface FontResource {
     readonly measure: FontMeasure;
     /** Glyphs collected by the usage walk — the emit phase subsets to these. */
     readonly gids: ReadonlySet<number>;
+    /**
+     * The text of each collected glyph that no character maps to — a conjunct,
+     * a reph, a vowel sign's contextual form — for the PDF's /ToUnicode.
+     */
+    readonly glyphText?: ReadonlyMap<number, string>;
 }
 /**
  * The face a run asked for and the registry could not give — what the page has
@@ -60,11 +65,23 @@ export interface TextToken {
      * element separate from the item body.
      */
     readonly listMarker?: true;
+    /**
+     * §17.9.29 — the token is the space a list level's `w:suff="space"` puts
+     * after its marker: a gap of fixed width with nothing drawn in it, which a
+     * justified line does not stretch.
+     */
+    readonly listMarkerSpace?: true;
     /**
      * §17.3.3.1 — the token is the break of a `w:br w:type="column"`: what
      * follows it belongs in the next column.
      */
     readonly columnBreak?: true;
+    /**
+     * §17.3.3.1 — the token is a `w:br w:type="page"`: an empty mark of where it
+     * stands, and what follows it belongs on the next page. Layout takes it out
+     * of the line before the line is wrapped.
+     */
+    readonly pageBreak?: true;
     /**
      * §17.3.1.38 — the token IS a tab: its width is the distance to the stop it
      * advances to, resolved once the line is known, and its text is whatever
@@ -76,6 +93,15 @@ export interface TextToken {
      * fills a soft highlight behind it (E-COMMENTS CM2c).
      */
     readonly highlight?: true;
+    /**
+     * Per code point of `text`, the colour it is drawn in, where the token holds
+     * a syllable of the scripts of India that a run boundary cut: the syllable
+     * is shaped whole in the run it begins in, and each character keeps the
+     * colour of the run it was typed in. A glyph standing for several characters
+     * takes the colour of the first. Absent when every character takes
+     * `resolvedRun.colorHex`.
+     */
+    readonly charColorsHex?: ReadonlyArray<string>;
     readonly resolvedRun: ResolvedRunProperties;
     readonly font: FontResource;
     /** What the chosen face lacks and the emitter must fake (see {@link SyntheticFace}). */

package/dist/esm/layout/styled-layout.d.ts

@@ -2,7 +2,7 @@ import { BodyElement, Chart, Comment, DocumentInfo, Numbering, Section, SectionP
 import { FontRegistry } from '../core/font/index.js';
 import { SubstituteKey } from '../core/fonts/index.js';
 import { Hyphenator } from '../core/hyphenation/index.js';
-import { Pt, ResourceStore } from '../core/ir/index.js';
+import { Loss, Pt, ResourceStore } from '../core/ir/index.js';
 import { LaidOutDocument, PageItem } from './page-doc.js';
 import { AttachedFile } from '../pdf/embedded-file.js';
 import { SignaturePlaceholder } from '../pdf/signature.js';
@@ -221,6 +221,13 @@ export interface StyledRenderOptions {
      * signature.
      */
     readonly signaturePlaceholder?: SignaturePlaceholder;
+    /**
+     * Sink the layout writes its {@link Loss} entries into: the characters no
+     * face on hand has a glyph for, which the page draws as empty boxes (see
+     * `undrawnLoss`). The converter always supplies one and returns it with the
+     * output; omitted ⇒ the boxes are drawn all the same, and nothing says so.
+     */
+    readonly losses?: Array<Loss>;
 }
 export type { DocumentInfo } from '../core/document-model/index.js';
 /** A4 page width in points (the page-geometry fallback). */