js.documents 7.15.2 → 7.16.0

package/README.md

@@ -301,7 +301,7 @@ const { kind, value } = documentFromJson(
 // kind: 'DocumentTree' (here) | 'ContentDocument'
 ```
 
-`buildDocumentBytes` rebuilds any `DocumentFormat`'s bytes from a tree-form `DocumentTree` — it flattens once at the boundary and hands the flat form to the builders, whose signatures never changed. `'pdf'` rebuilds the pdf-codec view from the package's own frames+pages (`layoutDocumentFromPackage`, a mechanical inverse walking the flattened content and emitting `LayoutItem`s from each node's recorded placements; throwing if the package carries no `pages`), `'odf'` has no builder and throws, everything else rebuilds from the flattened `ContentDocument`. `layoutDocumentFromPackage` is exported too, for a caller wanting the rebuilt `LayoutDocument` without writing bytes. Two honest limits on the pdf rebuild, both structural properties of what a package records: a run's frames carry positions, not the wrap decisions that distributed its text across them, so a wrapped run re-renders once, whole, at its first recorded placement; and no font registry or positioned formula survives a bare package (a formula block's frame records where it sat while its glyphs render as nothing):
+`buildDocumentBytes` rebuilds any `DocumentFormat`'s bytes from a tree-form `DocumentTree` — it flattens once at the boundary and hands the flat form to the builders, whose signatures never changed. `'pdf'` rebuilds the pdf-codec view from the package's own frames+pages (`layoutDocumentFromPackage`, a mechanical inverse walking the flattened content and emitting `LayoutItem`s from each node's recorded placements; throwing if the package carries no `pages`), `'odf'` has no builder and throws, everything else rebuilds from the flattened `ContentDocument`. `layoutDocumentFromPackage` is exported too, for a caller wanting the rebuilt `LayoutDocument` without writing bytes. The pdf rebuild re-derives what the recorded data genuinely determines rather than approximating: a wrapped run's frames each carry the tight measured width of the fragment the original wrap placed there, so the rebuild re-wraps the run's text against each frame's own width through the same line-breaker and standard-14 metrics its re-render draws with, reproducing the original split wherever the original also drew through those metrics; and an embedded formula is re-typeset from its own recorded MathML at its recorded frame through the identical layoutFormula pipeline the original pass ran. One honest limit remains, a structural property of what a package records: no font registry survives a bare package, so text re-renders through the standard 14 (or the caller's write-option faces) rather than the source document's own embedded faces, and a formula whose source carried no MathML at all has nothing to re-typeset:
 
 ```ts
 import { buildDocumentBytes, docxToPdf } from "documents.js";

package/dist/convert/from-package.cjs

@@ -1,6 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_geometry = require("../model/geometry.cjs");
 const require_model_bytes = require("../model/bytes.cjs");
+const require_model_formula = require("../model/formula.cjs");
+const require_mathml_layout = require("../mathml/layout.cjs");
+const require_layout_text_layout = require("../layout/text-layout.cjs");
 const require_layout_shared = require("../layout/shared.cjs");
 require("../layout/sheets.cjs");
 const require_layout_drawing = require("../layout/drawing.cjs");
@@ -12,7 +15,11 @@ let pdf_codec = require("pdf-codec");
 function buildDocumentBytes(pkg, target) {
 	if (target === "pdf") {
 		if (pkg.pages === void 0) throw new Error("this DocumentTree has no pages -- only a package dumped from a <format>-to-pdf or pdf-to-<format> conversion carries them; a bridge conversion's own dump (e.g. odt-to-docx) never does, so 'pdf' is not a reachable target from it");
-		return (0, pdf_codec.writePdf)(layoutDocumentFromPackage(pkg));
+		const { document: layout, formulas, fonts } = packageToLayout(pkg);
+		return (0, pdf_codec.writePdf)(layout, formulas.length > 0 ? {
+			formulas,
+			fonts
+		} : { fonts });
 	}
 	if (require_convert_capability.READ_ONLY_FORMATS.has(target)) throw new Error(`'${target}' is a read-only format: it cannot be built from a DocumentTree, because there is no ContentDocument-to-${target} builder`);
 	const content = require_codecs_registry.DOCUMENT_FORMAT_CODECS[target].content;
@@ -23,35 +30,62 @@ function pageOfFrame(state, frame) {
 	return state.pages[frame.pageIndex];
 }
 function emitRun(state, run) {
-	const frame = run.frames?.[0];
-	if (frame === void 0) return;
-	const page = pageOfFrame(state, frame);
-	if (page === void 0) return;
+	const frames = run.frames ?? [];
 	const font = require_layout_shared.runFont(run);
 	const sizePt = run.sizePt ?? 18;
-	const textItem = {
-		kind: "text",
-		text: run.text,
-		xPt: frame.xPt,
-		yPt: frame.yPt,
-		font,
-		sizePt,
-		color: run.color ?? document_schema_js.COLOR_BLACK,
-		underline: run.underline
-	};
-	page.items.push(textItem);
-	if (run.hyperlink !== void 0) {
-		const link = {
+	const color = run.color ?? document_schema_js.COLOR_BLACK;
+	const placements = frames.filter((frame) => pageOfFrame(state, frame) !== void 0);
+	if (placements.length === 0) return;
+	const fragments = placements.length === 1 ? [run.text] : rederiveWrapFragments(run.text, font, sizePt, placements, state.measurer);
+	for (const [index, frame] of placements.entries()) {
+		const page = pageOfFrame(state, frame);
+		if (page === void 0) continue;
+		const text = index === placements.length - 1 ? fragments.slice(index).join(" ") : fragments[index];
+		if (text !== void 0 && text !== "") page.items.push({
+			kind: "text",
+			text,
+			xPt: frame.xPt,
+			yPt: frame.yPt,
+			font,
+			sizePt,
+			color,
+			underline: run.underline
+		});
+		if (run.hyperlink !== void 0) page.items.push({
 			kind: "link",
 			uri: run.hyperlink,
 			xPt: frame.xPt,
 			yPt: frame.yPt,
 			widthPt: frame.widthPt,
 			heightPt: frame.heightPt
-		};
-		page.items.push(link);
+		});
 	}
 }
+function rederiveWrapFragments(text, font, sizePt, frames, measurer) {
+	let atoms = require_layout_text_layout.atomizeForWrap([{
+		text,
+		font,
+		sizePt,
+		color: document_schema_js.COLOR_BLACK
+	}], measurer);
+	let remaining = text;
+	const fragments = [];
+	for (const frame of frames) {
+		if (remaining === "" || atoms.length === 0) break;
+		const { line, rest } = require_layout_text_layout.firstWrappedLineOf(atoms, measurer, frame.widthPt);
+		const consumed = line.fragments.map((f) => f.text).join("");
+		if (!remaining.startsWith(consumed)) return [text];
+		remaining = remaining.slice(consumed.length).trimStart();
+		fragments.push(consumed.trimEnd());
+		atoms = trimLeadingGlueAtoms(rest);
+	}
+	return fragments;
+}
+function trimLeadingGlueAtoms(atoms) {
+	let start = 0;
+	while (start < atoms.length && atoms[start]?.kind === "glue") start++;
+	return atoms.slice(start);
+}
 function emitParagraph(state, paragraph) {
 	for (const run of paragraph.runs) emitRun(state, run);
 }
@@ -166,16 +200,44 @@ function emitBlocks(state, blocks) {
 	for (const block of blocks) if (block.kind === "paragraph") emitParagraph(state, block);
 	else if (block.kind === "image") emitImageBlock(state, block, block.frames);
 	else if (block.kind === "table") emitTable(state, block);
+	else if (block.kind === "embeddedObject") emitEmbeddedObjectBlock(state, block);
+}
+function emitEmbeddedObjectBlock(state, block) {
+	const formula = require_model_formula.formulaOfBlock(block);
+	if (formula === void 0 || formula.mathml.length === 0) return;
+	const { metricsAt } = (0, pdf_codec.loadMathFont)();
+	for (const frame of block.frames ?? []) {
+		if (pageOfFrame(state, frame) === void 0) continue;
+		const sizePt = require_layout_shared.formulaSizePtForFrame(formula.mathml, frame, metricsAt);
+		const { box } = require_mathml_layout.layoutFormula(formula.mathml, {
+			metrics: metricsAt(sizePt),
+			sizePt,
+			color: document_schema_js.COLOR_BLACK
+		});
+		state.formulas.push({
+			pageIndex: frame.pageIndex,
+			xPt: frame.xPt,
+			yPt: frame.yPt,
+			box
+		});
+	}
 }
 function layoutDocumentFromPackage(pkg) {
+	return packageToLayout(pkg).document;
+}
+function packageToLayout(pkg) {
 	const pages = (pkg.pages ?? []).map((page) => ({
 		widthPt: page.widthPt,
 		heightPt: page.heightPt,
 		items: []
 	}));
+	const fonts = (0, pdf_codec.createFontRegistry)({});
 	const state = {
 		pages,
-		images: {}
+		images: {},
+		measurer: (0, pdf_codec.createFontMeasurer)(fonts),
+		fonts,
+		formulas: []
 	};
 	const content = (0, document_schema_js.flattenTree)(pkg);
 	if (content.kind === "wordprocessing") for (const section of content.sections) emitBlocks(state, section.blocks);
@@ -186,10 +248,14 @@ function layoutDocumentFromPackage(pkg) {
 		for (const shape of drawPage.shapes) emitBlocks(state, shape.blocks);
 	}
 	return {
-		formatVersion: pdf_codec.LAYOUT_FORMAT_VERSION,
-		metadata: content.metadata,
-		pages,
-		images: state.images
+		document: {
+			formatVersion: pdf_codec.LAYOUT_FORMAT_VERSION,
+			metadata: content.metadata,
+			pages,
+			images: state.images
+		},
+		formulas: state.formulas,
+		fonts: state.fonts
 	};
 }
 //#endregion

package/dist/convert/from-package.js

@@ -1,17 +1,24 @@
 import { flipY } from "../model/geometry.js";
 import { requireArrayBufferBytes } from "../model/bytes.js";
-import { pushCellBorderLines, registerImage, runFont } from "../layout/shared.js";
+import { formulaOfBlock } from "../model/formula.js";
+import { layoutFormula } from "../mathml/layout.js";
+import { atomizeForWrap, firstWrappedLineOf } from "../layout/text-layout.js";
+import { formulaSizePtForFrame, pushCellBorderLines, registerImage, runFont } from "../layout/shared.js";
 import "../layout/sheets.js";
 import { convertVector } from "../layout/drawing.js";
 import { READ_ONLY_FORMATS } from "./capability.js";
 import { DOCUMENT_FORMAT_CODECS } from "../codecs/registry.js";
 import { COLOR_BLACK, DEFAULT_LAYOUT_FONT, flattenTree, resolveCellFillColor } from "document-schema.js";
-import { LAYOUT_FORMAT_VERSION, writePdf } from "pdf-codec";
+import { LAYOUT_FORMAT_VERSION, createFontMeasurer, createFontRegistry, loadMathFont, writePdf } from "pdf-codec";
 //#region src/convert/from-package.ts
 function buildDocumentBytes(pkg, target) {
 	if (target === "pdf") {
 		if (pkg.pages === void 0) throw new Error("this DocumentTree has no pages -- only a package dumped from a <format>-to-pdf or pdf-to-<format> conversion carries them; a bridge conversion's own dump (e.g. odt-to-docx) never does, so 'pdf' is not a reachable target from it");
-		return writePdf(layoutDocumentFromPackage(pkg));
+		const { document: layout, formulas, fonts } = packageToLayout(pkg);
+		return writePdf(layout, formulas.length > 0 ? {
+			formulas,
+			fonts
+		} : { fonts });
 	}
 	if (READ_ONLY_FORMATS.has(target)) throw new Error(`'${target}' is a read-only format: it cannot be built from a DocumentTree, because there is no ContentDocument-to-${target} builder`);
 	const content = DOCUMENT_FORMAT_CODECS[target].content;
@@ -22,35 +29,62 @@ function pageOfFrame(state, frame) {
 	return state.pages[frame.pageIndex];
 }
 function emitRun(state, run) {
-	const frame = run.frames?.[0];
-	if (frame === void 0) return;
-	const page = pageOfFrame(state, frame);
-	if (page === void 0) return;
+	const frames = run.frames ?? [];
 	const font = runFont(run);
 	const sizePt = run.sizePt ?? 18;
-	const textItem = {
-		kind: "text",
-		text: run.text,
-		xPt: frame.xPt,
-		yPt: frame.yPt,
-		font,
-		sizePt,
-		color: run.color ?? COLOR_BLACK,
-		underline: run.underline
-	};
-	page.items.push(textItem);
-	if (run.hyperlink !== void 0) {
-		const link = {
+	const color = run.color ?? COLOR_BLACK;
+	const placements = frames.filter((frame) => pageOfFrame(state, frame) !== void 0);
+	if (placements.length === 0) return;
+	const fragments = placements.length === 1 ? [run.text] : rederiveWrapFragments(run.text, font, sizePt, placements, state.measurer);
+	for (const [index, frame] of placements.entries()) {
+		const page = pageOfFrame(state, frame);
+		if (page === void 0) continue;
+		const text = index === placements.length - 1 ? fragments.slice(index).join(" ") : fragments[index];
+		if (text !== void 0 && text !== "") page.items.push({
+			kind: "text",
+			text,
+			xPt: frame.xPt,
+			yPt: frame.yPt,
+			font,
+			sizePt,
+			color,
+			underline: run.underline
+		});
+		if (run.hyperlink !== void 0) page.items.push({
 			kind: "link",
 			uri: run.hyperlink,
 			xPt: frame.xPt,
 			yPt: frame.yPt,
 			widthPt: frame.widthPt,
 			heightPt: frame.heightPt
-		};
-		page.items.push(link);
+		});
 	}
 }
+function rederiveWrapFragments(text, font, sizePt, frames, measurer) {
+	let atoms = atomizeForWrap([{
+		text,
+		font,
+		sizePt,
+		color: COLOR_BLACK
+	}], measurer);
+	let remaining = text;
+	const fragments = [];
+	for (const frame of frames) {
+		if (remaining === "" || atoms.length === 0) break;
+		const { line, rest } = firstWrappedLineOf(atoms, measurer, frame.widthPt);
+		const consumed = line.fragments.map((f) => f.text).join("");
+		if (!remaining.startsWith(consumed)) return [text];
+		remaining = remaining.slice(consumed.length).trimStart();
+		fragments.push(consumed.trimEnd());
+		atoms = trimLeadingGlueAtoms(rest);
+	}
+	return fragments;
+}
+function trimLeadingGlueAtoms(atoms) {
+	let start = 0;
+	while (start < atoms.length && atoms[start]?.kind === "glue") start++;
+	return atoms.slice(start);
+}
 function emitParagraph(state, paragraph) {
 	for (const run of paragraph.runs) emitRun(state, run);
 }
@@ -165,16 +199,44 @@ function emitBlocks(state, blocks) {
 	for (const block of blocks) if (block.kind === "paragraph") emitParagraph(state, block);
 	else if (block.kind === "image") emitImageBlock(state, block, block.frames);
 	else if (block.kind === "table") emitTable(state, block);
+	else if (block.kind === "embeddedObject") emitEmbeddedObjectBlock(state, block);
+}
+function emitEmbeddedObjectBlock(state, block) {
+	const formula = formulaOfBlock(block);
+	if (formula === void 0 || formula.mathml.length === 0) return;
+	const { metricsAt } = loadMathFont();
+	for (const frame of block.frames ?? []) {
+		if (pageOfFrame(state, frame) === void 0) continue;
+		const sizePt = formulaSizePtForFrame(formula.mathml, frame, metricsAt);
+		const { box } = layoutFormula(formula.mathml, {
+			metrics: metricsAt(sizePt),
+			sizePt,
+			color: COLOR_BLACK
+		});
+		state.formulas.push({
+			pageIndex: frame.pageIndex,
+			xPt: frame.xPt,
+			yPt: frame.yPt,
+			box
+		});
+	}
 }
 function layoutDocumentFromPackage(pkg) {
+	return packageToLayout(pkg).document;
+}
+function packageToLayout(pkg) {
 	const pages = (pkg.pages ?? []).map((page) => ({
 		widthPt: page.widthPt,
 		heightPt: page.heightPt,
 		items: []
 	}));
+	const fonts = createFontRegistry({});
 	const state = {
 		pages,
-		images: {}
+		images: {},
+		measurer: createFontMeasurer(fonts),
+		fonts,
+		formulas: []
 	};
 	const content = flattenTree(pkg);
 	if (content.kind === "wordprocessing") for (const section of content.sections) emitBlocks(state, section.blocks);
@@ -185,10 +247,14 @@ function layoutDocumentFromPackage(pkg) {
 		for (const shape of drawPage.shapes) emitBlocks(state, shape.blocks);
 	}
 	return {
-		formatVersion: LAYOUT_FORMAT_VERSION,
-		metadata: content.metadata,
-		pages,
-		images: state.images
+		document: {
+			formatVersion: LAYOUT_FORMAT_VERSION,
+			metadata: content.metadata,
+			pages,
+			images: state.images
+		},
+		formulas: state.formulas,
+		fonts: state.fonts
 	};
 }
 //#endregion

package/dist/layout/text-layout.cjs

@@ -158,6 +158,68 @@ function buildEmptyLine(runs, measurer) {
 		descentPt: measurer.descenderAtSize(first.font, first.sizePt)
 	};
 }
+function atomizeForWrap(runs, measurer) {
+	return atomizeRuns(runs, measurer);
+}
+function firstWrappedLineOf(atoms, measurer, maxWidthPt, options = {}) {
+	const breakLongWords = options.breakLongWords ?? true;
+	const queue = [...atoms];
+	if (maxWidthPt <= 0) {
+		const all = queue.filter((a) => a.kind !== "break");
+		return {
+			line: all.length === 0 ? buildEmptyLine(dummyRunsOf(atoms), measurer) : buildLine(all, measurer),
+			rest: []
+		};
+	}
+	const current = [];
+	let currentWidth = 0;
+	while (queue.length > 0) {
+		const atom = queue[0];
+		if (atom.kind === "break") {
+			queue.shift();
+			break;
+		}
+		if (currentWidth + atom.widthPt <= maxWidthPt) {
+			current.push(atom);
+			currentWidth += atom.widthPt;
+			queue.shift();
+			continue;
+		}
+		if (current.length > 0) break;
+		if (atom.kind === "box" && breakLongWords) {
+			const { fit, rest } = splitBoxToWidth(atom, measurer, maxWidthPt);
+			current.push(fit);
+			currentWidth += fit.widthPt;
+			if (rest !== void 0) queue[0] = rest;
+			else queue.shift();
+			break;
+		}
+		current.push(atom);
+		currentWidth += atom.widthPt;
+		queue.shift();
+		break;
+	}
+	while (current.length > 0 && current[current.length - 1]?.kind === "glue") {
+		const removed = current.pop();
+		currentWidth -= removed?.widthPt ?? 0;
+	}
+	return {
+		line: current.length === 0 ? buildEmptyLine(dummyRunsOf(atoms), measurer) : buildLine(current, measurer),
+		rest: queue
+	};
+}
+function dummyRunsOf(atoms) {
+	for (const atom of atoms) if (atom.kind === "box" && atom.fragments[0] !== void 0) {
+		const f = atom.fragments[0];
+		return [{
+			text: f.text,
+			font: f.font,
+			sizePt: f.sizePt,
+			color: f.color
+		}];
+	}
+	return [];
+}
 function wrapRunsToWidth(runs, measurer, maxWidthPt, options = {}) {
 	const breakLongWords = options.breakLongWords ?? true;
 	if (maxWidthPt <= 0) {
@@ -213,4 +275,6 @@ function wrapRunsToWidth(runs, measurer, maxWidthPt, options = {}) {
 	return lines;
 }
 //#endregion
+exports.atomizeForWrap = atomizeForWrap;
+exports.firstWrappedLineOf = firstWrappedLineOf;
 exports.wrapRunsToWidth = wrapRunsToWidth;

package/dist/layout/text-layout.d.cts

@@ -11,6 +11,25 @@ interface SourcedWrappedLine extends Omit<WrappedLine, "fragments"> {
     readonly xOffsetPt: number;
   })[];
 }
+interface BoxAtom {
+  readonly kind: "box";
+  readonly fragments: readonly SourcedFragment[];
+  readonly widthPt: number;
+}
+interface GlueAtom {
+  readonly kind: "glue";
+  readonly widthPt: number;
+}
+interface BreakAtom {
+  readonly kind: "break";
+  readonly widthPt: 0;
+}
+type WrapAtom = BoxAtom | GlueAtom | BreakAtom;
+declare function atomizeForWrap(runs: readonly SourcedRun[], measurer: TextMeasurer): WrapAtom[];
+declare function firstWrappedLineOf(atoms: readonly WrapAtom[], measurer: TextMeasurer, maxWidthPt: number, options?: WrapOptions): {
+  line: SourcedWrappedLine;
+  rest: WrapAtom[];
+};
 declare function wrapRunsToWidth(runs: readonly SourcedRun[], measurer: TextMeasurer, maxWidthPt: number, options?: WrapOptions): SourcedWrappedLine[];
 //#endregion
-export { SourcedFragment, SourcedRun, SourcedWrappedLine, wrapRunsToWidth };
+export { SourcedFragment, SourcedRun, SourcedWrappedLine, WrapAtom, atomizeForWrap, firstWrappedLineOf, wrapRunsToWidth };

package/dist/layout/text-layout.d.ts

@@ -11,6 +11,25 @@ interface SourcedWrappedLine extends Omit<WrappedLine, "fragments"> {
     readonly xOffsetPt: number;
   })[];
 }
+interface BoxAtom {
+  readonly kind: "box";
+  readonly fragments: readonly SourcedFragment[];
+  readonly widthPt: number;
+}
+interface GlueAtom {
+  readonly kind: "glue";
+  readonly widthPt: number;
+}
+interface BreakAtom {
+  readonly kind: "break";
+  readonly widthPt: 0;
+}
+type WrapAtom = BoxAtom | GlueAtom | BreakAtom;
+declare function atomizeForWrap(runs: readonly SourcedRun[], measurer: TextMeasurer): WrapAtom[];
+declare function firstWrappedLineOf(atoms: readonly WrapAtom[], measurer: TextMeasurer, maxWidthPt: number, options?: WrapOptions): {
+  line: SourcedWrappedLine;
+  rest: WrapAtom[];
+};
 declare function wrapRunsToWidth(runs: readonly SourcedRun[], measurer: TextMeasurer, maxWidthPt: number, options?: WrapOptions): SourcedWrappedLine[];
 //#endregion
-export { SourcedFragment, SourcedRun, SourcedWrappedLine, wrapRunsToWidth };
+export { SourcedFragment, SourcedRun, SourcedWrappedLine, WrapAtom, atomizeForWrap, firstWrappedLineOf, wrapRunsToWidth };

package/dist/layout/text-layout.js

@@ -157,6 +157,68 @@ function buildEmptyLine(runs, measurer) {
 		descentPt: measurer.descenderAtSize(first.font, first.sizePt)
 	};
 }
+function atomizeForWrap(runs, measurer) {
+	return atomizeRuns(runs, measurer);
+}
+function firstWrappedLineOf(atoms, measurer, maxWidthPt, options = {}) {
+	const breakLongWords = options.breakLongWords ?? true;
+	const queue = [...atoms];
+	if (maxWidthPt <= 0) {
+		const all = queue.filter((a) => a.kind !== "break");
+		return {
+			line: all.length === 0 ? buildEmptyLine(dummyRunsOf(atoms), measurer) : buildLine(all, measurer),
+			rest: []
+		};
+	}
+	const current = [];
+	let currentWidth = 0;
+	while (queue.length > 0) {
+		const atom = queue[0];
+		if (atom.kind === "break") {
+			queue.shift();
+			break;
+		}
+		if (currentWidth + atom.widthPt <= maxWidthPt) {
+			current.push(atom);
+			currentWidth += atom.widthPt;
+			queue.shift();
+			continue;
+		}
+		if (current.length > 0) break;
+		if (atom.kind === "box" && breakLongWords) {
+			const { fit, rest } = splitBoxToWidth(atom, measurer, maxWidthPt);
+			current.push(fit);
+			currentWidth += fit.widthPt;
+			if (rest !== void 0) queue[0] = rest;
+			else queue.shift();
+			break;
+		}
+		current.push(atom);
+		currentWidth += atom.widthPt;
+		queue.shift();
+		break;
+	}
+	while (current.length > 0 && current[current.length - 1]?.kind === "glue") {
+		const removed = current.pop();
+		currentWidth -= removed?.widthPt ?? 0;
+	}
+	return {
+		line: current.length === 0 ? buildEmptyLine(dummyRunsOf(atoms), measurer) : buildLine(current, measurer),
+		rest: queue
+	};
+}
+function dummyRunsOf(atoms) {
+	for (const atom of atoms) if (atom.kind === "box" && atom.fragments[0] !== void 0) {
+		const f = atom.fragments[0];
+		return [{
+			text: f.text,
+			font: f.font,
+			sizePt: f.sizePt,
+			color: f.color
+		}];
+	}
+	return [];
+}
 function wrapRunsToWidth(runs, measurer, maxWidthPt, options = {}) {
 	const breakLongWords = options.breakLongWords ?? true;
 	if (maxWidthPt <= 0) {
@@ -212,4 +274,4 @@ function wrapRunsToWidth(runs, measurer, maxWidthPt, options = {}) {
 	return lines;
 }
 //#endregion
-export { wrapRunsToWidth };
+export { atomizeForWrap, firstWrappedLineOf, wrapRunsToWidth };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js.documents",
-  "version": "7.15.2",
+  "version": "7.16.0",
   "description": "Bidirectional docx/pptx <-> PDF conversion and a read+write editable OOXML document model, built on ooxml.js and Zod 4 codecs.",
   "type": "module",
   "repository": {