@stll/folio-core 0.47.7 → 0.49.0

package/dist/docx/drawingGroupChildren.js

@@ -0,0 +1,176 @@
+import { canonicalJson } from "../utils/canonicalJson.js";
+import { captureVerbatimXml } from "./verbatimCapture.js";
+import { findChildByLocalName, findDeep, getAttribute, getChildElements, getLocalName, parseNumericAttribute, parseXml } from "./xmlParser.js";
+//#region src/docx/drawingGroupChildren.ts
+/**
+* The text boxes of a DrawingML group (`wpg:wgp`), read as frames folio can lay
+* out, and written back into the group's authored XML.
+*
+* A group states a child coordinate space (`a:chOff` / `a:chExt`) that its
+* own frame (`a:off` / `a:ext`) maps onto, and every child's `a:xfrm` is in
+* that space; a nested `wpg:grpSp` repeats the mapping one level down
+* (ECMA-376 §20.1.7.5). Composing the mappings gives each `wps:wsp` a frame
+* in EMUs relative to the group's own top-left corner. Only the frame is
+* mapped: the text inside keeps its authored size and the body insets stay in
+* EMUs.
+*/
+/** `a:xfrm@rot` is in 60,000ths of a degree. */
+const ROTATION_UNITS_PER_DEGREE = 6e4;
+/** Deeper nesting than this is not a drawing anyone authored. */
+const MAX_GROUP_DEPTH = 16;
+const MAX_GROUP_TEXT_BOXES = 256;
+const numberAttribute = (element, name) => parseNumericAttribute(element, null, name) ?? 0;
+const onOffAttribute = (element, name) => {
+	const value = getAttribute(element, null, name);
+	return value === "1" || value === "true" || value === "on";
+};
+/** A `CT_GroupTransform2D` or `CT_Transform2D`; absent children read as zero. */
+const readTransform = (xfrm) => {
+	const offset = findChildByLocalName(xfrm, "off");
+	const extent = findChildByLocalName(xfrm, "ext");
+	const childOffset = findChildByLocalName(xfrm, "chOff");
+	const childExtent = findChildByLocalName(xfrm, "chExt");
+	return {
+		x: numberAttribute(offset, "x"),
+		y: numberAttribute(offset, "y"),
+		width: numberAttribute(extent, "cx"),
+		height: numberAttribute(extent, "cy"),
+		childX: numberAttribute(childOffset, "x"),
+		childY: numberAttribute(childOffset, "y"),
+		childWidth: numberAttribute(childExtent, "cx"),
+		childHeight: numberAttribute(childExtent, "cy"),
+		rotation: numberAttribute(xfrm, "rot") / ROTATION_UNITS_PER_DEGREE,
+		flipH: onOffAttribute(xfrm, "flipH"),
+		flipV: onOffAttribute(xfrm, "flipV")
+	};
+};
+const groupTransform = (group) => readTransform(findChildByLocalName(findChildByLocalName(group, "grpSpPr"), "xfrm"));
+const shapeTransform = (shape) => readTransform(findChildByLocalName(findChildByLocalName(shape, "spPr"), "xfrm"));
+/**
+* The top-level mapping: the group's child space stretched over the drawing's
+* extent. A missing or empty child extent means the child space is the
+* drawing's own.
+*/
+const rootMap = (group, width, height) => {
+	const transform = groupTransform(group);
+	const scaleX = transform.childWidth > 0 ? width / transform.childWidth : 1;
+	const scaleY = transform.childHeight > 0 ? height / transform.childHeight : 1;
+	return {
+		scaleX,
+		scaleY,
+		offsetX: -transform.childX * scaleX,
+		offsetY: -transform.childY * scaleY
+	};
+};
+/** A nested group's child space, mapped through its frame in the parent's space. */
+const nestedMap = (parent, transform) => {
+	const scaleX = transform.childWidth > 0 ? transform.width / transform.childWidth : 1;
+	const scaleY = transform.childHeight > 0 ? transform.height / transform.childHeight : 1;
+	return {
+		scaleX: parent.scaleX * scaleX,
+		scaleY: parent.scaleY * scaleY,
+		offsetX: parent.scaleX * (transform.x - transform.childX * scaleX) + parent.offsetX,
+		offsetY: parent.scaleY * (transform.y - transform.childY * scaleY) + parent.offsetY
+	};
+};
+const hasTextBox = (wsp) => findChildByLocalName(findChildByLocalName(wsp, "txbx"), "txbxContent") !== null;
+/**
+* Every `wps:wsp` with a text box in the group, nested groups included, with
+* its frame in EMUs from the group's top-left corner.
+*
+* A nested group that is rotated or flipped turns its children's frames into
+* something other than a rectangle in the drawing's axes, so its text boxes
+* are left out and stay with the preview.
+*/
+const collectGroupTextBoxes = (group, width, height) => {
+	const frames = [];
+	const visit = (container, map, path, depth) => {
+		for (const [index, child] of getChildElements(container).entries()) {
+			if (frames.length >= MAX_GROUP_TEXT_BOXES) return;
+			const localName = getLocalName(child.name ?? "");
+			if (localName === "grpSp" && depth < MAX_GROUP_DEPTH) {
+				const transform = groupTransform(child);
+				if (transform.rotation === 0 && !transform.flipH && !transform.flipV) visit(child, nestedMap(map, transform), [...path, index], depth + 1);
+				continue;
+			}
+			if (localName !== "wsp" || !hasTextBox(child)) continue;
+			const transform = shapeTransform(child);
+			const frameWidth = transform.width * map.scaleX;
+			const frameHeight = transform.height * map.scaleY;
+			if (!(frameWidth > 0 && frameHeight > 0)) continue;
+			frames.push({
+				path: [...path, index],
+				wsp: child,
+				x: transform.x * map.scaleX + map.offsetX,
+				y: transform.y * map.scaleY + map.offsetY,
+				width: frameWidth,
+				height: frameHeight,
+				rotation: transform.rotation,
+				flipH: transform.flipH,
+				flipV: transform.flipV
+			});
+		}
+	};
+	visit(group, rootMap(group, width, height), [], 0);
+	return frames;
+};
+/** Two FNV-1a passes with different offsets: a short, stable identity. */
+const fingerprint = (text) => {
+	let first = 2166136261;
+	let second = 16777619;
+	for (let index = 0; index < text.length; index += 1) {
+		const code = text.charCodeAt(index);
+		first = Math.imul(first ^ code, 16777619);
+		second = Math.imul(second ^ code, 96280213);
+	}
+	return `${(first >>> 0).toString(16).padStart(8, "0")}${(second >>> 0).toString(16).padStart(8, "0")}`;
+};
+/** Identity of a group drawing's authored XML. */
+const groupXmlFingerprint = (rawXml) => fingerprint(rawXml);
+/** Identity of a text box's content, compared on save to tell an edit. */
+const groupTextContentFingerprint = (content) => fingerprint(canonicalJson(content));
+/** The group a captured drawing carries; a Fallback branch holds none. */
+const findGroup = (root) => findDeep(root, "wpg", "wgp") ?? void 0;
+const childAtPath = (group, path) => {
+	let current = group;
+	for (const index of path) current = current ? getChildElements(current)[index] : void 0;
+	return current;
+};
+/**
+* The text box content element a path names, or undefined when the path does
+* not lead to a `wps:wsp` holding one.
+*/
+const textBoxContentAt = (group, path) => {
+	const wsp = childAtPath(group, path);
+	if (!wsp || getLocalName(wsp.name ?? "") !== "wsp") return;
+	return findChildByLocalName(findChildByLocalName(wsp, "txbx"), "txbxContent") ?? void 0;
+};
+/**
+* The captured group XML with each edited text box's content replaced, or
+* undefined when an edit names no text box in it.
+*
+* The replacement is written as a placeholder element and substituted after
+* the tree is serialized, so the new content is never reparsed and the rest
+* of the capture is written exactly as it was read.
+*/
+const replaceGroupTextBoxContent = (rawXml, edits) => {
+	const root = parseXml(rawXml);
+	const group = findGroup(root);
+	if (!group) return;
+	const replacements = /* @__PURE__ */ new Map();
+	for (const [index, edit] of edits.entries()) {
+		const content = textBoxContentAt(group, edit.path);
+		if (!content) return;
+		const placeholder = `folio-group-text-${index}-${fingerprint(rawXml)}`;
+		content.elements = [{
+			type: "element",
+			name: placeholder
+		}];
+		replacements.set(`<${placeholder}/>`, edit.contentXml || "<w:p/>");
+	}
+	let xml = (root.elements ?? []).map((element) => captureVerbatimXml(element)).join("");
+	for (const [placeholder, contentXml] of replacements) xml = xml.replace(placeholder, () => contentXml);
+	return xml;
+};
+//#endregion
+export { collectGroupTextBoxes, groupTextContentFingerprint, groupXmlFingerprint, readTransform, replaceGroupTextBoxContent };

package/dist/docx/drawingUtils.js

@@ -107,6 +107,7 @@ function parseFill(spPr) {
 function parseGradientFill(gradientFill) {
 	let type = "linear";
 	let angle;
+	let scaled;
 	const linear = findChildByLocalName(gradientFill, "lin");
 	if (linear) {
 		const authoredAngle = getAttribute(linear, null, "ang");
@@ -114,6 +115,7 @@ function parseGradientFill(gradientFill) {
 			const parsedAngle = Number.parseInt(authoredAngle, 10);
 			angle = Number.isNaN(parsedAngle) ? void 0 : parsedAngle / 6e4;
 		}
+		scaled = parseOnOffValue(getAttribute(linear, null, "scaled"), void 0, "a:lin@scaled");
 	}
 	const path = findChildByLocalName(gradientFill, "path");
 	if (path) {
@@ -139,6 +141,7 @@ function parseGradientFill(gradientFill) {
 		gradient: {
 			type,
 			...angle !== void 0 ? { angle } : {},
+			...scaled !== void 0 ? { scaled } : {},
 			stops
 		}
 	};

package/dist/docx/fieldParser.d.ts

@@ -64,6 +64,13 @@ declare function parseFieldInstruction(instruction: string): ParsedFieldInstruct
  * @returns Format string or undefined
  */
 declare function getFormatSwitch(instruction: ParsedFieldInstruction): string | undefined;
+/**
+ * Get the numeric picture switch value (\#), e.g. `0#` in `PAGE \# 0#`.
+ *
+ * @param instruction - Parsed instruction
+ * @returns Picture string or undefined
+ */
+declare function getNumericPictureSwitch(instruction: ParsedFieldInstruction): string | undefined;
 /**
  * Check if field has MERGEFORMAT switch (preserve formatting)
  *
@@ -237,4 +244,4 @@ declare function getMergeFields(fields: document_d_exports.Field[]): document_d_
  */
 declare function getMergeFieldNames(fields: document_d_exports.Field[]): string[];
 //#endregion
-export { ComplexFieldContext, ComplexFieldState, FieldSwitch, KNOWN_FIELD_TYPES, ParsedFieldInstruction, collectFields, computePageNumber, createComplexFieldContext, finalizeComplexField, formatDate, getFieldDisplayValue, getFieldsByType, getFormatSwitch, getMergeFieldNames, getMergeFields, getPageNumberFields, hasMergeFormat, isDateTimeField, isDocPropertyField, isHyperlinkField, isKnownFieldType, isMergeField, isPageNumberField, isReferenceField, isTocField, isTotalPagesField, parseFieldInstruction, parseFieldType, parseSimpleField, resetComplexFieldContext };
+export { ComplexFieldContext, ComplexFieldState, FieldSwitch, KNOWN_FIELD_TYPES, ParsedFieldInstruction, collectFields, computePageNumber, createComplexFieldContext, finalizeComplexField, formatDate, getFieldDisplayValue, getFieldsByType, getFormatSwitch, getMergeFieldNames, getMergeFields, getNumericPictureSwitch, getPageNumberFields, hasMergeFormat, isDateTimeField, isDocPropertyField, isHyperlinkField, isKnownFieldType, isMergeField, isPageNumberField, isReferenceField, isTocField, isTotalPagesField, parseFieldInstruction, parseFieldType, parseSimpleField, resetComplexFieldContext };

package/dist/docx/fieldParser.js

@@ -141,6 +141,15 @@ function getFormatSwitch(instruction) {
 	return instruction.switches.find((s) => s.switch === "*" || s.switch === "@")?.value;
 }
 /**
+* Get the numeric picture switch value (\#), e.g. `0#` in `PAGE \# 0#`.
+*
+* @param instruction - Parsed instruction
+* @returns Picture string or undefined
+*/
+function getNumericPictureSwitch(instruction) {
+	return instruction.switches.find((s) => s.switch === "#")?.value;
+}
+/**
 * Check if field has MERGEFORMAT switch (preserve formatting)
 *
 * @param instruction - Parsed instruction
@@ -345,16 +354,51 @@ function isTocField(field) {
 * @returns Formatted page number string
 */
 function computePageNumber(pageNumber, instruction, sectionFormat) {
+	const picture = instruction ? getNumericPictureSwitch(instruction) : void 0;
+	if (picture !== void 0) return applyNumericPicture(pageNumber, picture);
 	const format = instruction ? getFormatSwitch(instruction) : void 0;
 	if (!format || format.toUpperCase() === "MERGEFORMAT") return formatSectionPageNumber(pageNumber, sectionFormat);
+	const isLowercaseSwitch = format === format.toLowerCase();
 	switch (format.toUpperCase()) {
-		case "ROMAN": return toRoman(pageNumber);
-		case "ALPHABETIC": return toLetter(pageNumber);
+		case "ROMAN": {
+			const roman = toRoman(pageNumber);
+			return isLowercaseSwitch ? roman.toLowerCase() : roman;
+		}
+		case "ALPHABETIC": {
+			const letters = toLetter(pageNumber);
+			return isLowercaseSwitch ? letters.toLowerCase() : letters;
+		}
 		default: return String(pageNumber);
 	}
 }
 const formatSectionPageNumber = (pageNumber, format) => formatOoxmlCounter(pageNumber, format);
 /**
+* Apply a `\#` numeric picture (ECMA-376 §17.16.4.2) to an integer field
+* value. `0` is a mandatory digit placeholder that zero-pads once the value
+* runs out of digits; `#` is an optional placeholder that is left blank
+* instead; every other picture character (including a thousands separator)
+* is copied through literally. Placeholders line up with the value's digits
+* from the right; digits that reach past the leftmost placeholder are kept,
+* not truncated.
+*/
+function applyNumericPicture(value, picture) {
+	const negative = value < 0;
+	const digits = [...String(Math.trunc(Math.abs(value)))];
+	const pictureChars = [...picture];
+	const output = Array.from({ length: pictureChars.length });
+	let digitIndex = digits.length - 1;
+	for (let i = pictureChars.length - 1; i >= 0; i--) {
+		const char = pictureChars[i];
+		if (char === "0" || char === "#") if (digitIndex >= 0) {
+			output[i] = digits[digitIndex];
+			digitIndex--;
+		} else output[i] = char === "0" ? "0" : "";
+		else output[i] = char;
+	}
+	const overflow = digitIndex >= 0 ? digits.slice(0, digitIndex + 1).join("") : "";
+	return (negative ? "-" : "") + overflow + output.join("");
+}
+/**
 * Convert number to uppercase Roman numerals
 */
 function toRoman(num) {
@@ -555,4 +599,4 @@ function getMergeFieldNames(fields) {
 	}).filter((name) => !!name);
 }
 //#endregion
-export { KNOWN_FIELD_TYPES, collectFields, computePageNumber, createComplexFieldContext, finalizeComplexField, formatDate, getFieldDisplayValue, getFieldsByType, getFormatSwitch, getMergeFieldNames, getMergeFields, getPageNumberFields, hasMergeFormat, isDateTimeField, isDocPropertyField, isHyperlinkField, isKnownFieldType, isMergeField, isPageNumberField, isReferenceField, isTocField, isTotalPagesField, parseFieldInstruction, parseFieldType, parseSimpleField, resetComplexFieldContext };
+export { KNOWN_FIELD_TYPES, collectFields, computePageNumber, createComplexFieldContext, finalizeComplexField, formatDate, getFieldDisplayValue, getFieldsByType, getFormatSwitch, getMergeFieldNames, getMergeFields, getNumericPictureSwitch, getPageNumberFields, hasMergeFormat, isDateTimeField, isDocPropertyField, isHyperlinkField, isKnownFieldType, isMergeField, isPageNumberField, isReferenceField, isTocField, isTotalPagesField, parseFieldInstruction, parseFieldType, parseSimpleField, resetComplexFieldContext };

package/dist/docx/fontTableParser.js

@@ -1,5 +1,5 @@
 import { DERIVED_PART_ROOT_ATTRIBUTES, attributeRemainder } from "./attributeRemainder.js";
-import { CAPTURE, dispatchChildren } from "./containerChildren.js";
+import { CAPTURE, dispatchChildrenWithContext } from "./containerChildren.js";
 import { getAttribute, parseXmlDocument } from "./xmlParser.js";
 //#region src/docx/fontTableParser.ts
 const FONT_FAMILIES = [
@@ -22,14 +22,12 @@ const parseFontTable = (xml) => {
 	const root = parseXmlDocument(xml);
 	if (!root) return;
 	const fonts = [];
-	const preserved = dispatchChildren({
+	const preserved = dispatchChildrenWithContext({
 		element: root,
 		container: "w:fonts",
 		capturePosition: () => fonts.length,
-		handlers: { font: (element) => {
-			const font = parseFont(element);
-			if (font) fonts.push(font);
-		} }
+		handlers: FONT_TABLE_HANDLERS,
+		context: fonts
 	});
 	const preservedAttributes = attributeRemainder({
 		element: root,
@@ -45,31 +43,18 @@ const parseFontTable = (xml) => {
 const parseFont = (element) => {
 	const name = getAttribute(element, "w", "name");
 	if (!name) return;
-	const font = { name };
-	let modelled = 0;
-	const read = (key, value) => {
-		if (value === void 0) return;
-		font[key] = value;
-		modelled += 1;
+	const walk = {
+		font: { name },
+		modelled: 0
 	};
-	const preserved = dispatchChildren({
+	const preserved = dispatchChildrenWithContext({
 		element,
 		container: "w:font",
-		capturePosition: () => modelled,
-		handlers: {
-			altName: (child) => read("altName", value(child)),
-			panose1: (child) => read("panose1", value(child)),
-			charset: (child) => read("charset", charsetOf(child)),
-			family: (child) => read("family", narrow(value(child), FONT_FAMILIES)),
-			notTrueType: CAPTURE,
-			pitch: (child) => read("pitch", narrow(value(child), FONT_PITCHES)),
-			sig: (child) => read("sig", signatureOf(child)),
-			embedRegular: (child) => read("embedRegular", embedOf(child)),
-			embedBold: (child) => read("embedBold", embedOf(child)),
-			embedItalic: (child) => read("embedItalic", embedOf(child)),
-			embedBoldItalic: (child) => read("embedBoldItalic", embedOf(child))
-		}
+		capturePosition: () => walk.modelled,
+		handlers: FONT_HANDLERS,
+		context: walk
 	});
+	const { font } = walk;
 	if (preserved !== void 0) font.preserved = preserved;
 	const preservedAttributes = attributeRemainder({
 		element,
@@ -129,5 +114,27 @@ const signatureOf = (element) => {
 	return Object.keys(signature).length === 0 ? void 0 : signature;
 };
 const narrow = (carried, members) => members.find((member) => member === carried);
+const FONT_TABLE_HANDLERS = { font: (element, fonts) => {
+	const font = parseFont(element);
+	if (font) fonts.push(font);
+} };
+const read = (walk, key, carried) => {
+	if (carried === void 0) return;
+	walk.font[key] = carried;
+	walk.modelled += 1;
+};
+const FONT_HANDLERS = {
+	altName: (child, walk) => read(walk, "altName", value(child)),
+	panose1: (child, walk) => read(walk, "panose1", value(child)),
+	charset: (child, walk) => read(walk, "charset", charsetOf(child)),
+	family: (child, walk) => read(walk, "family", narrow(value(child), FONT_FAMILIES)),
+	notTrueType: CAPTURE,
+	pitch: (child, walk) => read(walk, "pitch", narrow(value(child), FONT_PITCHES)),
+	sig: (child, walk) => read(walk, "sig", signatureOf(child)),
+	embedRegular: (child, walk) => read(walk, "embedRegular", embedOf(child)),
+	embedBold: (child, walk) => read(walk, "embedBold", embedOf(child)),
+	embedItalic: (child, walk) => read(walk, "embedItalic", embedOf(child)),
+	embedBoldItalic: (child, walk) => read(walk, "embedBoldItalic", embedOf(child))
+};
 //#endregion
 export { parseFontTable };

package/dist/docx/footnoteParser.d.ts

@@ -1,6 +1,7 @@
 import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
 import { ParseContext } from "./parseContext.js";
+import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
 import { parseEndnoteProperties, parseFootnoteProperties } from "./notePropertiesParser.js";
 //#region src/docx/footnoteParser.d.ts
@@ -53,7 +54,7 @@ type EndnoteMap = {
  * @param media - Media files for images
  * @returns FootnoteMap with all footnotes
  */
-declare function parseFootnotes(footnotesXml: string | null, styles?: StyleMap | null, theme?: document_d_exports.Theme | null, numbering?: NumberingMap | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, context?: ParseContext): FootnoteMap;
+declare function parseFootnotes(footnotesXml: string | null, styles?: StyleMap | null, theme?: document_d_exports.Theme | null, numbering?: NumberingMap | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, context?: ParseContext, previews?: PreviewLedger): FootnoteMap;
 /**
  * Parse endnotes.xml
  *
@@ -65,7 +66,7 @@ declare function parseFootnotes(footnotesXml: string | null, styles?: StyleMap |
  * @param media - Media files for images
  * @returns EndnoteMap with all endnotes
  */
-declare function parseEndnotes(endnotesXml: string | null, styles?: StyleMap | null, theme?: document_d_exports.Theme | null, numbering?: NumberingMap | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, context?: ParseContext): EndnoteMap;
+declare function parseEndnotes(endnotesXml: string | null, styles?: StyleMap | null, theme?: document_d_exports.Theme | null, numbering?: NumberingMap | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, context?: ParseContext, previews?: PreviewLedger): EndnoteMap;
 /**
  * Get plain text content of a footnote.
  *

package/dist/docx/footnoteParser.js

@@ -1,6 +1,7 @@
 import { blockPlainText } from "./blockPlainText.js";
 import { parseEndnoteProperties, parseFootnoteProperties } from "./notePropertiesParser.js";
 import { parseParagraph } from "./paragraphParser.js";
+import { standalonePreviewLedger } from "./previewBudget.js";
 import { captureSdtSiblingMarkers, parseSdtProperties } from "./sdtProperties.js";
 import { parseTable } from "./tableParser.js";
 import { findChildren, findWordprocessingChild, getAttributes, getChildElements, getLocalName, parseXml } from "./xmlParser.js";
@@ -27,13 +28,13 @@ function parseNoteId(element) {
 	const parsed = Number.parseInt(id, 10);
 	return Number.isNaN(parsed) ? 0 : parsed;
 }
-function parseNoteBlockContent(element, styles, theme, numbering, rels, media) {
+function parseNoteBlockContent(element, styles, theme, numbering, rels, media, previews) {
 	const blocks = [];
 	for (const child of getChildElements(element)) {
 		const localName = getLocalName(child.name ?? "");
-		if (localName === "p") blocks.push(parseParagraph(child, styles, theme, numbering, rels));
+		if (localName === "p") blocks.push(parseParagraph(child, styles, theme, numbering, rels, media, { previews }));
 		else if (localName === "tbl") {
-			const table = parseTable(child, styles, theme, numbering, rels, media);
+			const table = parseTable(child, styles, theme, numbering, rels, media, { previews });
 			if (table) blocks.push(table);
 		} else if (localName === "sdt") {
 			const sdtPr = findWordprocessingChild(child, "sdtPr");
@@ -46,7 +47,7 @@ function parseNoteBlockContent(element, styles, theme, numbering, rels, media) {
 			blocks.push({
 				type: "blockSdt",
 				properties,
-				content: sdtContent ? parseNoteBlockContent(sdtContent, styles, theme, numbering, rels, media) : []
+				content: sdtContent ? parseNoteBlockContent(sdtContent, styles, theme, numbering, rels, media, previews) : []
 			});
 		}
 	}
@@ -55,12 +56,12 @@ function parseNoteBlockContent(element, styles, theme, numbering, rels, media) {
 /**
 * Parse a single footnote element (w:footnote)
 */
-function parseFootnote(element, styles, theme, numbering, rels, media) {
+function parseFootnote(element, styles, theme, numbering, rels, media, previews) {
 	return {
 		type: "footnote",
 		id: parseNoteId(element),
 		noteType: parseNoteType(getNoteAttribute(element, "type")),
-		content: parseNoteBlockContent(element, styles, theme, numbering, rels, media)
+		content: parseNoteBlockContent(element, styles, theme, numbering, rels, media, previews)
 	};
 }
 /**
@@ -74,7 +75,7 @@ function parseFootnote(element, styles, theme, numbering, rels, media) {
 * @param media - Media files for images
 * @returns FootnoteMap with all footnotes
 */
-function parseFootnotes(footnotesXml, styles = null, theme = null, numbering = null, rels = null, media = null, context) {
+function parseFootnotes(footnotesXml, styles = null, theme = null, numbering = null, rels = null, media = null, context, previews = standalonePreviewLedger()) {
 	const byId = /* @__PURE__ */ new Map();
 	const footnotes = [];
 	if (!footnotesXml) return createFootnoteMap(byId, footnotes);
@@ -82,13 +83,14 @@ function parseFootnotes(footnotesXml, styles = null, theme = null, numbering = n
 	if (!rootElement) return createFootnoteMap(byId, footnotes);
 	const footnoteElements = findChildren(rootElement, "w", "footnote");
 	for (const fnEl of footnoteElements) {
-		const footnote = parseFootnote(fnEl, styles, theme, numbering, rels, media);
+		const footnote = parseFootnote(fnEl, styles, theme, numbering, rels, media, previews);
 		if (byId.has(footnote.id)) {
 			context?.warn({
 				code: PARSE_WARNING_CODES.duplicateNoteId,
 				element: "w:footnote",
 				at: `w:id ${String(footnote.id)}`
 			});
+			previews.release(footnote);
 			continue;
 		}
 		byId.set(footnote.id, footnote);
@@ -123,12 +125,12 @@ function createFootnoteMap(byId, footnotes) {
 /**
 * Parse a single endnote element (w:endnote)
 */
-function parseEndnote(element, styles, theme, numbering, rels, media) {
+function parseEndnote(element, styles, theme, numbering, rels, media, previews) {
 	return {
 		type: "endnote",
 		id: parseNoteId(element),
 		noteType: parseNoteType(getNoteAttribute(element, "type")),
-		content: parseNoteBlockContent(element, styles, theme, numbering, rels, media)
+		content: parseNoteBlockContent(element, styles, theme, numbering, rels, media, previews)
 	};
 }
 /**
@@ -142,7 +144,7 @@ function parseEndnote(element, styles, theme, numbering, rels, media) {
 * @param media - Media files for images
 * @returns EndnoteMap with all endnotes
 */
-function parseEndnotes(endnotesXml, styles = null, theme = null, numbering = null, rels = null, media = null, context) {
+function parseEndnotes(endnotesXml, styles = null, theme = null, numbering = null, rels = null, media = null, context, previews = standalonePreviewLedger()) {
 	const byId = /* @__PURE__ */ new Map();
 	const endnotes = [];
 	if (!endnotesXml) return createEndnoteMap(byId, endnotes);
@@ -150,13 +152,14 @@ function parseEndnotes(endnotesXml, styles = null, theme = null, numbering = nul
 	if (!rootElement) return createEndnoteMap(byId, endnotes);
 	const endnoteElements = findChildren(rootElement, "w", "endnote");
 	for (const enEl of endnoteElements) {
-		const endnote = parseEndnote(enEl, styles, theme, numbering, rels, media);
+		const endnote = parseEndnote(enEl, styles, theme, numbering, rels, media, previews);
 		if (byId.has(endnote.id)) {
 			context?.warn({
 				code: PARSE_WARNING_CODES.duplicateNoteId,
 				element: "w:endnote",
 				at: `w:id ${String(endnote.id)}`
 			});
+			previews.release(endnote);
 			continue;
 		}
 		byId.set(endnote.id, endnote);

package/dist/docx/groupDrawingParser.d.ts

@@ -1,6 +1,13 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
+import { PreviewLedger } from "./previewBudget.js";
+import { GroupTextBoxFrame } from "./drawingGroupChildren.js";
 //#region src/docx/groupDrawingParser.d.ts
+/**
+ * The text boxes a group preview does not draw, which the paragraph parser
+ * lifts out as text boxes of their own. Undefined for any other image.
+ */
+declare const groupPreviewTextBoxes: (image: document_d_exports.Image) => readonly GroupTextBoxFrame[] | undefined;
 /**
  * Whether a `w:drawing` carries a WordprocessingGroup payload. A group this
  * module declines to rasterize has no editable projection either — the shape
@@ -8,6 +15,6 @@ import { XmlElement } from "./xmlParser.js";
  */
 declare const isGroupDrawing: (drawing: XmlElement) => boolean;
 /** Parse a WordprocessingGroup drawing into a safe SVG-backed image preview. */
-declare const parseGroupDrawing: (drawing: XmlElement, rels?: document_d_exports.RelationshipMap, media?: Map<string, document_d_exports.MediaFile>) => document_d_exports.Image | null;
+declare const parseGroupDrawing: (drawing: XmlElement, previews: PreviewLedger, rels?: document_d_exports.RelationshipMap, media?: Map<string, document_d_exports.MediaFile>) => document_d_exports.Image | null;
 //#endregion
-export { isGroupDrawing, parseGroupDrawing };
+export { groupPreviewTextBoxes, isGroupDrawing, parseGroupDrawing };