@stll/folio-core 0.4.0 → 0.6.0

package/dist/docx/footnoteParser.js

@@ -205,32 +205,6 @@ function isSeparatorEndnote(endnote) {
 	return endnote.noteType === "separator" || endnote.noteType === "continuationSeparator" || endnote.noteType === "continuationNotice";
 }
 /**
-* Get footnote number for display (excluding separators)
-* @param footnote - The footnote to get the number for
-* @param footnoteMap - The footnote map
-* @param startNumber - Starting number (default 1)
-* @returns The display number, or null for separator footnotes
-*/
-function getFootnoteDisplayNumber(footnote, footnoteMap, startNumber = 1) {
-	if (isSeparatorFootnote(footnote)) return null;
-	const index = footnoteMap.getNormalFootnotes().findIndex((fn) => fn.id === footnote.id);
-	if (index === -1) return null;
-	return startNumber + index;
-}
-/**
-* Get endnote number for display (excluding separators)
-* @param endnote - The endnote to get the number for
-* @param endnoteMap - The endnote map
-* @param startNumber - Starting number (default 1)
-* @returns The display number, or null for separator endnotes
-*/
-function getEndnoteDisplayNumber(endnote, endnoteMap, startNumber = 1) {
-	if (isSeparatorEndnote(endnote)) return null;
-	const index = endnoteMap.getNormalEndnotes().findIndex((en) => en.id === endnote.id);
-	if (index === -1) return null;
-	return startNumber + index;
-}
-/**
 * Create an empty footnote map
 */
 function createEmptyFootnoteMap() {
@@ -267,4 +241,4 @@ function mergeEndnoteMaps(...maps) {
 	return createEndnoteMap(byId, endnotes);
 }
 //#endregion
-export { createEmptyEndnoteMap, createEmptyFootnoteMap, getEndnoteDisplayNumber, getEndnoteText, getFootnoteDisplayNumber, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote, mergeEndnoteMaps, mergeFootnoteMaps, parseEndnoteProperties, parseEndnotes, parseFootnoteProperties, parseFootnotes };
+export { createEmptyEndnoteMap, createEmptyFootnoteMap, getEndnoteText, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote, mergeEndnoteMaps, mergeFootnoteMaps, parseEndnoteProperties, parseEndnotes, parseFootnoteProperties, parseFootnotes };

package/dist/docx/groupDrawingParser.d.ts

@@ -0,0 +1,8 @@
+import { document_d_exports } from "../types/document.js";
+import { XmlElement } from "./xmlParser.js";
+
+//#region src/docx/groupDrawingParser.d.ts
+/** Parse a WordprocessingGroup drawing into a safe SVG-backed image preview. */
+declare const parseGroupDrawing: (drawing: XmlElement) => document_d_exports.Image | null;
+//#endregion
+export { parseGroupDrawing };

package/dist/docx/groupDrawingParser.js

@@ -0,0 +1,131 @@
+import { findAllDeep, findChildByLocalName, findChildrenByLocalName, getAttribute, getLocalName, getTextContent, parseNumericAttribute } from "./xmlParser.js";
+import { emuToPixels } from "../utils/units.js";
+import { parseImage } from "./imageParser.js";
+//#region src/docx/groupDrawingParser.ts
+const HEX_COLOR = /^[0-9A-Fa-f]{6}$/u;
+const DEFAULT_TEXT_COLOR = "000000";
+const DEFAULT_FONT_HALF_POINTS = 22;
+const DEFAULT_LINE_WIDTH_EMU = 9525;
+const HALF_POINT_TO_EMU = 6350;
+const MAX_GROUP_SHAPES = 256;
+const MAX_PATH_COMMANDS = 1e4;
+const MAX_TEXT_CHARACTERS = 2e4;
+const MAX_SVG_CHARACTERS = 1e6;
+const escapeXml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
+const numericAttr = (element, name) => {
+	const direct = parseNumericAttribute(element, null, name);
+	if (direct !== void 0) return direct;
+	const wordValue = getAttribute(element, "w", name);
+	if (!wordValue) return 0;
+	const parsed = Number.parseInt(wordValue, 10);
+	return Number.isNaN(parsed) ? 0 : parsed;
+};
+const childTransform = (wsp) => {
+	const xfrm = findChildByLocalName(findChildByLocalName(wsp, "spPr"), "xfrm");
+	const off = findChildByLocalName(xfrm, "off");
+	const ext = findChildByLocalName(xfrm, "ext");
+	return {
+		x: numericAttr(off, "x"),
+		y: numericAttr(off, "y"),
+		width: numericAttr(ext, "cx"),
+		height: numericAttr(ext, "cy")
+	};
+};
+const colorFrom = (parent, fallback) => {
+	if (parent && getLocalName(parent.name ?? "") === "color") {
+		const value = getAttribute(parent, "w", "val");
+		if (value && HEX_COLOR.test(value)) return value.toUpperCase();
+	}
+	const value = getAttribute(findChildByLocalName(findChildByLocalName(parent, "solidFill"), "srgbClr"), null, "val");
+	if (value && HEX_COLOR.test(value)) return value.toUpperCase();
+	return fallback;
+};
+const wrapLine = (line, maxCharacters) => {
+	const words = line.trim().split(/\s+/u);
+	const lines = [];
+	let current = "";
+	for (const word of words) {
+		const candidate = current ? `${current} ${word}` : word;
+		if (current && candidate.length > maxCharacters) {
+			lines.push(current);
+			current = word;
+		} else current = candidate;
+	}
+	if (current) lines.push(current);
+	return lines;
+};
+const pathData = (path) => {
+	const commands = [];
+	for (const command of path.elements ?? []) {
+		if (commands.length >= MAX_PATH_COMMANDS) break;
+		if (command.type !== "element") continue;
+		const point = findChildByLocalName(command, "pt");
+		const x = numericAttr(point, "x");
+		const y = numericAttr(point, "y");
+		const name = command.name?.split(":").at(-1);
+		if (name === "moveTo") commands.push(`M ${x} ${y}`);
+		else if (name === "lnTo") commands.push(`L ${x} ${y}`);
+		else if (name === "quadBezTo") {
+			const points = findChildrenByLocalName(command, "pt");
+			if (points.length >= 2) commands.push(`Q ${numericAttr(points[0] ?? null, "x")} ${numericAttr(points[0] ?? null, "y")} ${numericAttr(points[1] ?? null, "x")} ${numericAttr(points[1] ?? null, "y")}`);
+		} else if (name === "cubicBezTo") {
+			const points = findChildrenByLocalName(command, "pt");
+			if (points.length >= 3) commands.push(`C ${numericAttr(points[0] ?? null, "x")} ${numericAttr(points[0] ?? null, "y")} ${numericAttr(points[1] ?? null, "x")} ${numericAttr(points[1] ?? null, "y")} ${numericAttr(points[2] ?? null, "x")} ${numericAttr(points[2] ?? null, "y")}`);
+		} else if (name === "close") commands.push("Z");
+	}
+	return commands.join(" ");
+};
+const renderGeometry = (wsp) => {
+	const { x, y, width, height } = childTransform(wsp);
+	if (width <= 0 || height <= 0) return "";
+	const spPr = findChildByLocalName(wsp, "spPr");
+	const fill = colorFrom(spPr, "none");
+	const line = findChildByLocalName(spPr, "ln");
+	const stroke = colorFrom(line, "none");
+	const strokeWidth = line ? parseNumericAttribute(line, null, "w") ?? DEFAULT_LINE_WIDTH_EMU : 0;
+	const paths = findAllDeep(findChildByLocalName(spPr, "custGeom"), "a", "path");
+	if (paths.length === 0) return `<rect x="${x}" y="${y}" width="${width}" height="${height}" fill="${fill === "none" ? "none" : `#${fill}`}" stroke="${stroke === "none" ? "none" : `#${stroke}`}" stroke-width="${strokeWidth}"/>`;
+	return paths.map((path) => {
+		const viewWidth = numericAttr(path, "w") || width;
+		const viewHeight = numericAttr(path, "h") || height;
+		const d = pathData(path);
+		if (!d) return "";
+		return `<path d="${d}" transform="translate(${x} ${y}) scale(${width / viewWidth} ${height / viewHeight})" fill="${fill === "none" ? "none" : `#${fill}`}" stroke="${stroke === "none" ? "none" : `#${stroke}`}" stroke-width="${strokeWidth}"/>`;
+	}).join("");
+};
+const renderTextBox = (wsp) => {
+	const { x, y, width, height } = childTransform(wsp);
+	if (width <= 0 || height <= 0) return "";
+	const paragraphs = findAllDeep(wsp, "w", "p");
+	const firstSize = findAllDeep(wsp, "w", "sz").at(0);
+	const halfPoints = numericAttr(firstSize ?? null, "val") || DEFAULT_FONT_HALF_POINTS;
+	const color = colorFrom(findAllDeep(wsp, "w", "color").at(0) ?? null, DEFAULT_TEXT_COLOR);
+	const fontSize = halfPoints * HALF_POINT_TO_EMU;
+	const maxCharacters = Math.max(1, Math.floor(width / (fontSize * .38)));
+	const lines = paragraphs.flatMap((paragraph) => wrapLine(getTextContent(paragraph).slice(0, MAX_TEXT_CHARACTERS), maxCharacters)).map(escapeXml);
+	if (lines.length === 0) return "";
+	const lineHeight = fontSize * 1.15;
+	const svgFontSize = 1e3;
+	const scale = fontSize / svgFontSize;
+	const lineStep = lineHeight / fontSize * svgFontSize;
+	return `<text x="0" y="${svgFontSize}" transform="translate(${x} ${y}) scale(${scale})" font-family="Arial, sans-serif" font-size="${svgFontSize}" fill="#${color}">${lines.map((line, index) => `<tspan x="0" dy="${index === 0 ? 0 : lineStep}">${line}</tspan>`).join("")}</text>`;
+};
+const createSvg = (group, width, height) => {
+	const content = findChildrenByLocalName(group, "wsp").slice(0, MAX_GROUP_SHAPES).map((wsp) => findChildByLocalName(wsp, "txbx") ? renderTextBox(wsp) : renderGeometry(wsp)).join("");
+	return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${width} ${height}" width="${emuToPixels(width)}" height="${emuToPixels(height)}">${content}</svg>`;
+};
+/** Parse a WordprocessingGroup drawing into a safe SVG-backed image preview. */
+const parseGroupDrawing = (drawing) => {
+	const group = findChildByLocalName(findAllDeep(drawing, "a", "graphicData").at(0) ?? null, "wgp");
+	if (!group) return null;
+	const image = parseImage(drawing, void 0, void 0);
+	if (!image || image.size.width <= 0 || image.size.height <= 0) return null;
+	const svg = createSvg(group, image.size.width, image.size.height);
+	if (svg.length > MAX_SVG_CHARACTERS) return null;
+	image.src = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
+	image.mimeType = "image/svg+xml";
+	image.filename = "wordprocessing-group.svg";
+	return image;
+};
+//#endregion
+export { parseGroupDrawing };

package/dist/docx/numberingParser.d.ts

@@ -39,7 +39,9 @@ declare function createNumberingMap(definitions: document_d_exports.NumberingDef
 declare function computeListRendering(numPr: {
   numId?: number;
   ilvl?: number;
-}, numbering: NumberingMap): document_d_exports.ListRendering | null;
+}, numbering: NumberingMap): (document_d_exports.ListRendering & {
+  levelStarts: number[];
+}) | null;
 /**
  * Format a number according to the specified format
  *

package/dist/docx/numberingParser.js

@@ -581,7 +581,12 @@ function computeListRendering(numPr, numbering) {
 	const level = numbering.getLevel(numId, ilvl);
 	if (!level) return null;
 	const levelNumFmts = [];
-	for (let i = 0; i <= ilvl; i += 1) levelNumFmts.push(level.isLgl ? "decimal" : numbering.getLevel(numId, i)?.numFmt ?? "decimal");
+	const levelStarts = [];
+	for (let i = 0; i <= ilvl; i += 1) {
+		const listLevel = numbering.getLevel(numId, i);
+		levelNumFmts.push(level.isLgl ? "decimal" : listLevel?.numFmt ?? "decimal");
+		levelStarts.push(listLevel?.start ?? 1);
+	}
 	const instance = numbering.getInstance(numId);
 	const overrideForLevel = instance?.levelOverrides?.find((override) => override.ilvl === ilvl);
 	const rendering = {
@@ -590,7 +595,8 @@ function computeListRendering(numPr, numbering) {
 		marker: level.lvlText,
 		isBullet: level.numFmt === "bullet",
 		numFmt: level.isLgl ? "decimal" : level.numFmt,
-		levelNumFmts
+		levelNumFmts,
+		levelStarts
 	};
 	if (level.isLgl) rendering.isLegal = true;
 	if (level.rPr?.hidden) rendering.markerHidden = true;

package/dist/docx/paragraphParser.js

@@ -436,7 +436,7 @@ function paragraphStartsWithRenderedPageBreak(node) {
 		return "continue";
 	};
 	const outcome = visit(node);
-	if (outcome === "forced") return true;
+	if (outcome === "forced") return sawRenderedPageBreak;
 	return outcome === "visible" && sawRenderedPageBreak;
 }
 function replaceLocalName(name, localName) {
@@ -949,13 +949,19 @@ function parseParagraph(node, styles, theme, numbering, rels = null, media = nul
 			const level = numbering.getLevel(numId, ilvl);
 			if (level) {
 				const levelNumFmts = [];
-				for (let levelIndex = 0; levelIndex <= ilvl; levelIndex += 1) levelNumFmts.push(level.isLgl ? "decimal" : numbering.getLevel(numId, levelIndex)?.numFmt ?? "decimal");
+				const levelStarts = [];
+				for (let levelIndex = 0; levelIndex <= ilvl; levelIndex += 1) {
+					const listLevel = numbering.getLevel(numId, levelIndex);
+					levelNumFmts.push(level.isLgl ? "decimal" : listLevel?.numFmt ?? "decimal");
+					levelStarts.push(listLevel?.start ?? 1);
+				}
 				const listRendering = {
 					level: ilvl,
 					numId,
 					marker: level.lvlText,
 					isBullet: level.numFmt === "bullet",
-					levelNumFmts
+					levelNumFmts,
+					levelStarts
 				};
 				const instance = numbering.getInstance(numId);
 				const overrideForLevel = instance?.levelOverrides?.find((override) => override.ilvl === ilvl);

package/dist/docx/runParser.js

@@ -1,6 +1,7 @@
 import { cloneWithXmlnsDeclarations, elementToXml, findChild, findChildren, getAttribute, getChildElements, getTextContent, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute } from "./xmlParser.js";
 import { EmphasisMarkSchema, FontThemeSchema, HighlightColorSchema, ShadingPatternSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum } from "./parserEnums.js";
 import { parseImage } from "./imageParser.js";
+import { parseGroupDrawing } from "./groupDrawingParser.js";
 import { parseShapeFromDrawing, shouldPreserveRawShapeDrawing } from "./shapeParser.js";
 import { parseVmlImageContent } from "./vmlImageParser.js";
 import { resolveThemeFontRef } from "./themeParser.js";
@@ -442,6 +443,12 @@ function parseInstrText(element) {
 *   `shapeParser.parseShapeFromDrawing` into a `ShapeContent`.
 */
 function parseDrawingContent(element, rels, media) {
+	const groupImage = parseGroupDrawing(element);
+	if (groupImage) return {
+		type: "drawing",
+		image: groupImage,
+		rawXml: elementToXml(element)
+	};
 	if (shouldPreserveRawShapeDrawing(element)) return {
 		type: "drawing",
 		image: {
@@ -550,7 +557,7 @@ function parseRunContents(runElement, rels, media, rootXmlns = {}) {
 				if (innerName === "drawing") {
 					const innerDrawing = parseDrawingContent(innerChild, rels, media);
 					if (innerDrawing) {
-						if (innerDrawing.type === "drawing" && !innerDrawing.image.src) innerDrawing.rawXml = elementToXml(child);
+						if (innerDrawing.type === "drawing" && (innerDrawing.rawXml !== void 0 || !innerDrawing.image.src)) innerDrawing.rawXml = elementToXml(child);
 						contents.push(innerDrawing);
 					}
 				} else if (innerName === "pict") {

package/dist/docx/selectiveXmlPatch.js

@@ -50,11 +50,8 @@ function findParagraphOffsets(xml, paraId) {
 						start,
 						end: tagEnd + 1
 					};
-					pos = tagEnd + 1;
-				} else {
-					depth++;
-					pos = tagEnd + 1;
-				}
+				} else depth++;
+				pos = tagEnd + 1;
 			} else pos = tagStart + 1;
 		} else if (xml.startsWith("</w:p>", tagStart)) {
 			depth--;
@@ -226,11 +223,8 @@ function scanElementRange(xml, start, openLiteral, closeTag) {
 					start,
 					end: tagEnd + 1
 				};
-				pos = tagEnd + 1;
-			} else {
-				depth++;
-				pos = tagEnd + 1;
-			}
+			} else depth++;
+			pos = tagEnd + 1;
 		} else if (xml.startsWith(closeTag, tagStart)) {
 			depth--;
 			if (depth === 0) return {

package/dist/docx/serializer/numberingSerializer.js

@@ -87,7 +87,9 @@ function serializeNum(instance) {
 * change detection and per-definition splicing, never to overwrite the part.
 */
 function serializeNumberingXml(numbering) {
-	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<w:numbering xmlns:w="${W_NS}">${numbering.abstractNums.map(serializeAbstractNum).join("")}${numbering.nums.map(serializeNum).join("")}</w:numbering>`;
+	const abstractNums = numbering.abstractNums.map(serializeAbstractNum).join("");
+	const nums = numbering.nums.map(serializeNum).join("");
+	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<w:numbering xmlns:w="${W_NS}">${abstractNums}${nums}</w:numbering>`;
 }
 //#endregion
 export { serializeNumberingXml };

package/dist/docx/settingsParser.d.ts

@@ -1,8 +1,11 @@
 import { document_d_exports } from "../types/document.js";
 
 //#region src/docx/settingsParser.d.ts
+type FolioDocumentSettings = document_d_exports.DocumentSettings & {
+  /** Swap left/right section margins on even physical pages. */mirrorMargins?: boolean;
+};
 /** OOXML default per §17.6.13 when `w:defaultTabStop` is absent. */
 declare const DEFAULT_TAB_STOP_TWIPS = 720;
-declare function parseSettings(xml: string | null): document_d_exports.DocumentSettings;
-type DocumentSettings = document_d_exports.DocumentSettings;
-export { DEFAULT_TAB_STOP_TWIPS, type DocumentSettings, parseSettings };
+declare function parseSettings(xml: string | null): FolioDocumentSettings;
+//#endregion
+export { DEFAULT_TAB_STOP_TWIPS, FolioDocumentSettings, parseSettings };

package/dist/docx/settingsParser.js

@@ -13,6 +13,8 @@ function parseSettings(xml) {
 	const settings = { defaultTabStop: parseDefaultTabStop(root) };
 	const evenAndOddHeaders = root ? findChild(root, "w", "evenAndOddHeaders") : null;
 	if (evenAndOddHeaders && parseBooleanElement(evenAndOddHeaders)) settings.evenAndOddHeaders = true;
+	const mirrorMargins = root ? findChild(root, "w", "mirrorMargins") : null;
+	if (mirrorMargins && parseBooleanElement(mirrorMargins)) settings.mirrorMargins = true;
 	const themeFontLangEl = root ? findChild(root, "w", "themeFontLang") : null;
 	const eastAsiaLang = themeFontLangEl ? getAttribute(themeFontLangEl, "w", "eastAsia") || void 0 : void 0;
 	const bidiLang = themeFontLangEl ? getAttribute(themeFontLangEl, "w", "bidi") || void 0 : void 0;

package/dist/docx/xmlParser.js

@@ -31,6 +31,7 @@ const fxpParserOptions = {
 	parseAttributeValue: false,
 	ignoreDeclaration: true,
 	ignorePiTags: true,
+	jPath: false,
 	processEntities: true,
 	htmlEntities: true
 };
@@ -65,15 +66,19 @@ function fxpNodeToElement(node) {
 		text: node[TEXT_KEY]
 	};
 	const attrs = node[ATTR_KEY];
-	for (const key of Object.keys(node)) {
+	for (const key in node) {
 		if (key === ATTR_KEY) continue;
 		const children = node[key];
 		const element = {
 			type: "element",
 			name: key
 		};
-		if (attrs && Object.keys(attrs).length > 0) element.attributes = attrs;
-		if (children.length > 0) element.elements = children.map(fxpNodeToElement);
+		if (attrs) element.attributes = attrs;
+		if (children.length > 0) {
+			const elements = [];
+			for (const child of children) elements.push(fxpNodeToElement(child));
+			element.elements = elements;
+		}
 		return element;
 	}
 	return { type: "element" };
@@ -84,7 +89,9 @@ function fxpNodeToElement(node) {
 * `{ elements: [...] }`.
 */
 function fxpToRootElement(nodes) {
-	return { elements: nodes.map(fxpNodeToElement) };
+	const elements = [];
+	for (const node of nodes) elements.push(fxpNodeToElement(node));
+	return { elements };
 }
 /**
 * Convert an XmlElement back into the fast-xml-parser preserveOrder format