@stll/folio-core 0.0.1-placeholder.0 → 0.1.1

package/dist/docx/sectionParser.js

@@ -0,0 +1,534 @@
+import { findChild, findChildren, getAttribute, getChildElements, getLocalName, parseBooleanElement, parseNumericAttribute } from "./xmlParser.js";
+import { BorderStyleSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
+import { parseFooterReference, parseHeaderReference } from "./headerFooterRefParser.js";
+import { parseEndnoteProperties, parseFootnoteProperties } from "./notePropertiesParser.js";
+//#region src/docx/sectionParser.ts
+const serializedSectionPropertyChildNames = /* @__PURE__ */ new Set([
+	"headerReference",
+	"footerReference",
+	"footnotePr",
+	"footnoteColumns",
+	"endnotePr",
+	"type",
+	"pgSz",
+	"pgMar",
+	"paperSrc",
+	"pgBorders",
+	"background",
+	"lnNumType",
+	"pgNumType",
+	"cols",
+	"formProt",
+	"vAlign",
+	"noEndnote",
+	"titlePg",
+	"textDirection",
+	"bidi",
+	"rtlGutter",
+	"docGrid",
+	"printerSettings",
+	"sectPrChange"
+]);
+const unserializedSectionPropertyChildNames = Symbol("unserializedSectionPropertyChildNames");
+function getUnserializedSectionPropertyChildNames(props) {
+	const descriptor = Object.getOwnPropertyDescriptor(props, unserializedSectionPropertyChildNames);
+	return Array.isArray(descriptor?.value) ? descriptor.value : void 0;
+}
+/**
+* Parse a color element/attribute for page borders/background
+*/
+function parseColorValue(colorStr, themeColor, themeTint, themeShade) {
+	if (!colorStr && !themeColor) return;
+	const color = {};
+	if (colorStr && colorStr !== "auto") color.rgb = colorStr;
+	else if (colorStr === "auto") color.auto = true;
+	const validatedThemeColor = narrowEnum(themeColor, ThemeColorSlotSchema);
+	if (validatedThemeColor) color.themeColor = validatedThemeColor;
+	if (themeTint) color.themeTint = themeTint;
+	if (themeShade) color.themeShade = themeShade;
+	return Object.keys(color).length > 0 ? color : void 0;
+}
+function parsePropertyChangeInfo(node) {
+	const rawId = getAttribute(node, "w", "id");
+	const parsedId = rawId ? Number.parseInt(rawId, 10) : 0;
+	const author = (getAttribute(node, "w", "author") ?? "").trim();
+	const date = (getAttribute(node, "w", "date") ?? "").trim();
+	const rsid = (getAttribute(node, "w", "rsid") ?? "").trim();
+	const info = {
+		id: Number.isInteger(parsedId) && parsedId >= 0 ? parsedId : 0,
+		author: author.length > 0 ? author : "Unknown"
+	};
+	if (date.length > 0) info.date = date;
+	if (rsid.length > 0) info.rsid = rsid;
+	return info;
+}
+/**
+* Parse a border element for page borders
+*/
+function parseBorderSpec(element) {
+	if (!element) return;
+	const rawStyle = getAttribute(element, "w", "val") ?? "none";
+	const border = { style: narrowEnum(rawStyle, BorderStyleSchema) ?? rawStyle };
+	const sz = parseNumericAttribute(element, "w", "sz");
+	if (sz !== void 0) border.size = sz;
+	const space = parseNumericAttribute(element, "w", "space");
+	if (space !== void 0) border.space = space;
+	const color = parseColorValue(getAttribute(element, "w", "color"), getAttribute(element, "w", "themeColor"), getAttribute(element, "w", "themeTint"), getAttribute(element, "w", "themeShade"));
+	if (color) border.color = color;
+	const shadow = getAttribute(element, "w", "shadow");
+	if (shadow === "1" || shadow === "true") border.shadow = true;
+	const frame = getAttribute(element, "w", "frame");
+	if (frame === "1" || frame === "true") border.frame = true;
+	const artRelationshipId = getAttribute(element, "w", "id")?.trim();
+	if (artRelationshipId) border.artRelationshipId = artRelationshipId;
+	const topLeftArtRelationshipId = getAttribute(element, "w", "topLeft")?.trim();
+	if (topLeftArtRelationshipId) border.topLeftArtRelationshipId = topLeftArtRelationshipId;
+	const topRightArtRelationshipId = getAttribute(element, "w", "topRight")?.trim();
+	if (topRightArtRelationshipId) border.topRightArtRelationshipId = topRightArtRelationshipId;
+	const bottomLeftArtRelationshipId = getAttribute(element, "w", "bottomLeft")?.trim();
+	if (bottomLeftArtRelationshipId) border.bottomLeftArtRelationshipId = bottomLeftArtRelationshipId;
+	const bottomRightArtRelationshipId = getAttribute(element, "w", "bottomRight")?.trim();
+	if (bottomRightArtRelationshipId) border.bottomRightArtRelationshipId = bottomRightArtRelationshipId;
+	return border;
+}
+/**
+* Parse page orientation
+*/
+function parseOrientation(orient) {
+	switch (orient) {
+		case "landscape": return "landscape";
+		case "portrait": return "portrait";
+		default: return;
+	}
+}
+/**
+* Parse section start type
+*/
+function parseSectionStart(type) {
+	switch (type) {
+		case "continuous": return "continuous";
+		case "nextPage": return "nextPage";
+		case "oddPage": return "oddPage";
+		case "evenPage": return "evenPage";
+		case "nextColumn": return "nextColumn";
+		default: return;
+	}
+}
+/**
+* Parse vertical alignment
+*/
+function parseVerticalAlign(align) {
+	switch (align) {
+		case "top": return "top";
+		case "center": return "center";
+		case "both": return "both";
+		case "bottom": return "bottom";
+		default: return;
+	}
+}
+function parseTextDirection(val) {
+	switch (val) {
+		case "lrTb":
+		case "tbRl":
+		case "btLr":
+		case "lrTbV":
+		case "tbRlV":
+		case "tbLrV":
+		case "tb":
+		case "rl":
+		case "lr":
+		case "tbV":
+		case "rlV":
+		case "lrV": return val;
+		default: return;
+	}
+}
+/**
+* Parse line number restart type
+*/
+function parseLineNumberRestart(restart) {
+	switch (restart) {
+		case "continuous": return "continuous";
+		case "newPage": return "newPage";
+		case "newSection": return "newSection";
+		default: return;
+	}
+}
+/**
+* Parse section properties (w:sectPr)
+*
+* @param sectPr - The w:sectPr element
+* @returns SectionProperties object
+*/
+function parseSectionProperties(sectPr) {
+	const props = {};
+	if (!sectPr) return props;
+	const unhandledChildNames = getChildElements(sectPr).map((child) => getLocalName(child.name ?? "")).filter((name) => !serializedSectionPropertyChildNames.has(name));
+	const addUnhandledChildName = (name) => {
+		if (!unhandledChildNames.includes(name)) unhandledChildNames.push(name);
+	};
+	const pgSz = findChild(sectPr, "w", "pgSz");
+	if (pgSz) {
+		const w = parseNumericAttribute(pgSz, "w", "w");
+		if (w !== void 0) props.pageWidth = w;
+		const h = parseNumericAttribute(pgSz, "w", "h");
+		if (h !== void 0) props.pageHeight = h;
+		const orientation = parseOrientation(getAttribute(pgSz, "w", "orient"));
+		if (orientation) props.orientation = orientation;
+	}
+	const pgMar = findChild(sectPr, "w", "pgMar");
+	if (pgMar) {
+		const top = parseNumericAttribute(pgMar, "w", "top");
+		if (top !== void 0) props.marginTop = top;
+		const bottom = parseNumericAttribute(pgMar, "w", "bottom");
+		if (bottom !== void 0) props.marginBottom = bottom;
+		const left = parseNumericAttribute(pgMar, "w", "left");
+		if (left !== void 0) props.marginLeft = left;
+		const right = parseNumericAttribute(pgMar, "w", "right");
+		if (right !== void 0) props.marginRight = right;
+		const header = parseNumericAttribute(pgMar, "w", "header");
+		if (header !== void 0) props.headerDistance = header;
+		const footer = parseNumericAttribute(pgMar, "w", "footer");
+		if (footer !== void 0) props.footerDistance = footer;
+		const gutter = parseNumericAttribute(pgMar, "w", "gutter");
+		if (gutter !== void 0) props.gutter = gutter;
+	}
+	const cols = findChild(sectPr, "w", "cols");
+	if (cols) {
+		const num = parseNumericAttribute(cols, "w", "num");
+		if (num !== void 0) props.columnCount = num;
+		const space = parseNumericAttribute(cols, "w", "space");
+		if (space !== void 0) props.columnSpace = space;
+		const equalWidth = getAttribute(cols, "w", "equalWidth");
+		if (equalWidth === "1" || equalWidth === "true") props.equalWidth = true;
+		else if (equalWidth === "0" || equalWidth === "false") props.equalWidth = false;
+		const sep = getAttribute(cols, "w", "sep");
+		if (sep === "1" || sep === "true") props.separator = true;
+		const colElements = findChildren(cols, "w", "col");
+		if (colElements.length > 0) {
+			props.columns = [];
+			for (const colEl of colElements) {
+				const column = {};
+				const colWidth = parseNumericAttribute(colEl, "w", "w");
+				if (colWidth !== void 0) column.width = colWidth;
+				const colSpace = parseNumericAttribute(colEl, "w", "space");
+				if (colSpace !== void 0) column.space = colSpace;
+				props.columns.push(column);
+			}
+			if (props.columnCount === void 0) props.columnCount = colElements.length;
+		}
+	}
+	const typeEl = findChild(sectPr, "w", "type");
+	if (typeEl) {
+		const sectionStart = parseSectionStart(getAttribute(typeEl, "w", "val"));
+		if (sectionStart) props.sectionStart = sectionStart;
+	}
+	const vAlign = findChild(sectPr, "w", "vAlign");
+	if (vAlign) {
+		const verticalAlign = parseVerticalAlign(getAttribute(vAlign, "w", "val"));
+		if (verticalAlign) props.verticalAlign = verticalAlign;
+	}
+	const textDirection = findChild(sectPr, "w", "textDirection");
+	if (textDirection) {
+		const textDirectionValue = parseTextDirection(getAttribute(textDirection, "w", "val"));
+		if (textDirectionValue) props.textDirection = textDirectionValue;
+		else addUnhandledChildName("textDirection");
+	}
+	const bidi = findChild(sectPr, "w", "bidi");
+	if (bidi) props.bidi = parseBooleanElement(bidi);
+	const headerRefs = findChildren(sectPr, "w", "headerReference");
+	if (headerRefs.length > 0) props.headerReferences = headerRefs.map((el) => parseHeaderReference(el));
+	const footerRefs = findChildren(sectPr, "w", "footerReference");
+	if (footerRefs.length > 0) props.footerReferences = footerRefs.map((el) => parseFooterReference(el));
+	const titlePg = findChild(sectPr, "w", "titlePg");
+	if (titlePg) props.titlePg = parseBooleanElement(titlePg);
+	const evenAndOddHeaders = findChild(sectPr, "w", "evenAndOddHeaders");
+	if (evenAndOddHeaders) props.evenAndOddHeaders = parseBooleanElement(evenAndOddHeaders);
+	const lnNumType = findChild(sectPr, "w", "lnNumType");
+	if (lnNumType) {
+		props.lineNumbers = {};
+		const start = parseNumericAttribute(lnNumType, "w", "start");
+		if (start !== void 0) props.lineNumbers.start = start;
+		const countBy = parseNumericAttribute(lnNumType, "w", "countBy");
+		if (countBy !== void 0) props.lineNumbers.countBy = countBy;
+		const distance = parseNumericAttribute(lnNumType, "w", "distance");
+		if (distance !== void 0) props.lineNumbers.distance = distance;
+		const restartValue = parseLineNumberRestart(getAttribute(lnNumType, "w", "restart"));
+		if (restartValue) props.lineNumbers.restart = restartValue;
+	}
+	const pgNumType = findChild(sectPr, "w", "pgNumType");
+	if (pgNumType) {
+		const pageNumbering = {};
+		const format = getAttribute(pgNumType, "w", "fmt");
+		if (format) pageNumbering.format = format;
+		const start = parseNumericAttribute(pgNumType, "w", "start");
+		if (start !== void 0) pageNumbering.start = start;
+		const chapterStyle = parseNumericAttribute(pgNumType, "w", "chapStyle");
+		if (chapterStyle !== void 0) pageNumbering.chapterStyle = chapterStyle;
+		const chapterSeparator = getAttribute(pgNumType, "w", "chapSep");
+		if (chapterSeparator) pageNumbering.chapterSeparator = chapterSeparator;
+		if (Object.keys(pageNumbering).length > 0) props.pageNumbering = pageNumbering;
+	}
+	const pgBorders = findChild(sectPr, "w", "pgBorders");
+	if (pgBorders) {
+		props.pageBorders = {};
+		const topBorder = parseBorderSpec(findChild(pgBorders, "w", "top"));
+		if (topBorder) props.pageBorders.top = topBorder;
+		const bottomBorder = parseBorderSpec(findChild(pgBorders, "w", "bottom"));
+		if (bottomBorder) props.pageBorders.bottom = bottomBorder;
+		const leftBorder = parseBorderSpec(findChild(pgBorders, "w", "left"));
+		if (leftBorder) props.pageBorders.left = leftBorder;
+		const rightBorder = parseBorderSpec(findChild(pgBorders, "w", "right"));
+		if (rightBorder) props.pageBorders.right = rightBorder;
+		const display = getAttribute(pgBorders, "w", "display");
+		if (display === "allPages" || display === "firstPage" || display === "notFirstPage") props.pageBorders.display = display;
+		const offsetFrom = getAttribute(pgBorders, "w", "offsetFrom");
+		if (offsetFrom === "page" || offsetFrom === "text") props.pageBorders.offsetFrom = offsetFrom;
+		const zOrder = getAttribute(pgBorders, "w", "zOrder");
+		if (zOrder === "front" || zOrder === "back") props.pageBorders.zOrder = zOrder;
+	}
+	const background = findChild(sectPr, "w", "background");
+	if (background) {
+		props.background = {};
+		const colorVal = getAttribute(background, "w", "color");
+		if (colorVal && colorVal !== "auto") props.background.color = { rgb: colorVal };
+		const backgroundThemeColor = narrowEnum(getAttribute(background, "w", "themeColor"), ThemeColorSlotSchema);
+		if (backgroundThemeColor) props.background.themeColor = backgroundThemeColor;
+		const themeTint = getAttribute(background, "w", "themeTint");
+		if (themeTint) props.background.themeTint = themeTint;
+		const themeShade = getAttribute(background, "w", "themeShade");
+		if (themeShade) props.background.themeShade = themeShade;
+	}
+	const footnotePr = findChild(sectPr, "w", "footnotePr");
+	if (footnotePr) {
+		const fnProps = parseFootnoteProperties(footnotePr);
+		if (Object.keys(fnProps).length > 0) props.footnotePr = fnProps;
+	}
+	const footnoteColumns = findChild(sectPr, "w15", "footnoteColumns");
+	if (footnoteColumns) {
+		const columns = parseNumericAttribute(footnoteColumns, "w", "val");
+		if (columns !== void 0) props.footnoteColumns = columns;
+	}
+	const endnotePr = findChild(sectPr, "w", "endnotePr");
+	if (endnotePr) {
+		const enProps = parseEndnoteProperties(endnotePr);
+		if (Object.keys(enProps).length > 0) props.endnotePr = enProps;
+	}
+	const formProt = findChild(sectPr, "w", "formProt");
+	if (formProt) props.formProtection = parseBooleanElement(formProt);
+	const noEndnote = findChild(sectPr, "w", "noEndnote");
+	if (noEndnote) props.noEndnote = parseBooleanElement(noEndnote);
+	const rtlGutter = findChild(sectPr, "w", "rtlGutter");
+	if (rtlGutter) props.rtlGutter = parseBooleanElement(rtlGutter);
+	const docGrid = findChild(sectPr, "w", "docGrid");
+	if (docGrid) {
+		props.docGrid = {};
+		const gridType = getAttribute(docGrid, "w", "type");
+		if (gridType === "default" || gridType === "lines" || gridType === "linesAndChars" || gridType === "snapToChars") props.docGrid.type = gridType;
+		const linePitch = parseNumericAttribute(docGrid, "w", "linePitch");
+		if (linePitch !== void 0) props.docGrid.linePitch = linePitch;
+		const charSpace = parseNumericAttribute(docGrid, "w", "charSpace");
+		if (charSpace !== void 0) props.docGrid.charSpace = charSpace;
+	}
+	const paperSrc = findChild(sectPr, "w", "paperSrc");
+	if (paperSrc) {
+		const first = parseNumericAttribute(paperSrc, "w", "first");
+		if (first !== void 0) props.paperSrcFirst = first;
+		const other = parseNumericAttribute(paperSrc, "w", "other");
+		if (other !== void 0) props.paperSrcOther = other;
+	}
+	const printerSettings = findChild(sectPr, "w", "printerSettings");
+	if (printerSettings) {
+		const relationshipId = getAttribute(printerSettings, "r", "id");
+		if (relationshipId) props.printerSettingsRelationshipId = relationshipId;
+	}
+	const propertyChanges = findChildren(sectPr, "w", "sectPrChange").map((changeElement) => {
+		const previousSectPr = findChild(changeElement, "w", "sectPr");
+		const change = {
+			type: "sectionPropertyChange",
+			info: parsePropertyChangeInfo(changeElement)
+		};
+		if (previousSectPr) change.previousProperties = parseSectionProperties(previousSectPr);
+		return change;
+	});
+	if (propertyChanges.length > 0) props.propertyChanges = propertyChanges;
+	Object.defineProperty(props, unserializedSectionPropertyChildNames, {
+		enumerable: true,
+		value: unhandledChildNames
+	});
+	return props;
+}
+/**
+* Get page width in pixels (96 DPI)
+*
+* @param props - Section properties
+* @param defaultWidth - Default width in twips (default: 12240 = 8.5 inches)
+* @returns Width in pixels
+*/
+function getPageWidthPixels(props, defaultWidth = 12240) {
+	const twips = props.pageWidth ?? defaultWidth;
+	return Math.round(twips / 1440 * 96);
+}
+/**
+* Get page height in pixels (96 DPI)
+*
+* @param props - Section properties
+* @param defaultHeight - Default height in twips (default: 15840 = 11 inches)
+* @returns Height in pixels
+*/
+function getPageHeightPixels(props, defaultHeight = 15840) {
+	const twips = props.pageHeight ?? defaultHeight;
+	return Math.round(twips / 1440 * 96);
+}
+/**
+* Get content width (page width minus margins) in pixels
+*
+* @param props - Section properties
+* @returns Content width in pixels
+*/
+function getContentWidthPixels(props) {
+	const pageWidth = props.pageWidth ?? 12240;
+	const marginLeft = props.marginLeft ?? 1440;
+	const marginRight = props.marginRight ?? 1440;
+	const twips = pageWidth - marginLeft - marginRight;
+	return Math.round(twips / 1440 * 96);
+}
+/**
+* Get content height (page height minus margins) in pixels
+*
+* @param props - Section properties
+* @returns Content height in pixels
+*/
+function getContentHeightPixels(props) {
+	const pageHeight = props.pageHeight ?? 15840;
+	const marginTop = props.marginTop ?? 1440;
+	const marginBottom = props.marginBottom ?? 1440;
+	const twips = pageHeight - marginTop - marginBottom;
+	return Math.round(twips / 1440 * 96);
+}
+/**
+* Get margins in pixels
+*
+* @param props - Section properties
+* @returns Object with all margins in pixels
+*/
+function getMarginsPixels(props) {
+	const twipsToPixels = (twips, defaultTwips) => Math.round((twips ?? defaultTwips) / 1440 * 96);
+	return {
+		top: twipsToPixels(props.marginTop, 1440),
+		bottom: twipsToPixels(props.marginBottom, 1440),
+		left: twipsToPixels(props.marginLeft, 1440),
+		right: twipsToPixels(props.marginRight, 1440),
+		header: twipsToPixels(props.headerDistance, 720),
+		footer: twipsToPixels(props.footerDistance, 720),
+		gutter: twipsToPixels(props.gutter, 0)
+	};
+}
+/**
+* Check if section has different first page header/footer
+*/
+function hasDifferentFirstPage(props) {
+	return props.titlePg === true;
+}
+/**
+* Check if section has different odd/even page headers/footers
+*/
+function hasDifferentOddEven(props) {
+	return props.evenAndOddHeaders === true;
+}
+/**
+* Get effective column count (minimum 1)
+*/
+function getColumnCount(props) {
+	return Math.max(1, props.columnCount ?? 1);
+}
+/**
+* Check if section is landscape
+*/
+function isLandscape(props) {
+	return props.orientation === "landscape";
+}
+/**
+* Check if section has page borders
+*/
+function hasPageBorders(props) {
+	if (!props.pageBorders) return false;
+	return !!(props.pageBorders.top || props.pageBorders.bottom || props.pageBorders.left || props.pageBorders.right);
+}
+/**
+* Check if section has line numbers
+*/
+function hasLineNumbers(props) {
+	return !!props.lineNumbers;
+}
+/**
+* Get default section properties (US Letter size, 1 inch margins)
+*/
+function getDefaultSectionProperties() {
+	return {
+		pageWidth: 12240,
+		pageHeight: 15840,
+		orientation: "portrait",
+		marginTop: 1440,
+		marginBottom: 1440,
+		marginLeft: 1440,
+		marginRight: 1440,
+		headerDistance: 720,
+		footerDistance: 720,
+		gutter: 0,
+		columnCount: 1,
+		columnSpace: 720,
+		equalWidth: true,
+		sectionStart: "nextPage",
+		verticalAlign: "top"
+	};
+}
+/**
+* Merge section properties (later values override earlier)
+*
+* @param base - Base properties
+* @param override - Override properties
+* @returns Merged properties
+*/
+function mergeSectionProperties(base, override) {
+	const result = { ...base };
+	if (override.pageWidth !== void 0) result.pageWidth = override.pageWidth;
+	if (override.pageHeight !== void 0) result.pageHeight = override.pageHeight;
+	if (override.orientation !== void 0) result.orientation = override.orientation;
+	if (override.marginTop !== void 0) result.marginTop = override.marginTop;
+	if (override.marginBottom !== void 0) result.marginBottom = override.marginBottom;
+	if (override.marginLeft !== void 0) result.marginLeft = override.marginLeft;
+	if (override.marginRight !== void 0) result.marginRight = override.marginRight;
+	if (override.headerDistance !== void 0) result.headerDistance = override.headerDistance;
+	if (override.footerDistance !== void 0) result.footerDistance = override.footerDistance;
+	if (override.gutter !== void 0) result.gutter = override.gutter;
+	if (override.columnCount !== void 0) result.columnCount = override.columnCount;
+	if (override.columnSpace !== void 0) result.columnSpace = override.columnSpace;
+	if (override.equalWidth !== void 0) result.equalWidth = override.equalWidth;
+	if (override.separator !== void 0) result.separator = override.separator;
+	if (override.columns !== void 0) result.columns = override.columns;
+	if (override.sectionStart !== void 0) result.sectionStart = override.sectionStart;
+	if (override.verticalAlign !== void 0) result.verticalAlign = override.verticalAlign;
+	if (override.textDirection !== void 0) result.textDirection = override.textDirection;
+	if (override.bidi !== void 0) result.bidi = override.bidi;
+	if (override.headerReferences !== void 0) result.headerReferences = override.headerReferences;
+	if (override.footerReferences !== void 0) result.footerReferences = override.footerReferences;
+	if (override.titlePg !== void 0) result.titlePg = override.titlePg;
+	if (override.evenAndOddHeaders !== void 0) result.evenAndOddHeaders = override.evenAndOddHeaders;
+	if (override.lineNumbers !== void 0) result.lineNumbers = override.lineNumbers;
+	if (override.pageNumbering !== void 0) result.pageNumbering = override.pageNumbering;
+	if (override.pageBorders !== void 0) result.pageBorders = override.pageBorders;
+	if (override.background !== void 0) result.background = override.background;
+	if (override.footnotePr !== void 0) result.footnotePr = override.footnotePr;
+	if (override.endnotePr !== void 0) result.endnotePr = override.endnotePr;
+	if (override.docGrid !== void 0) result.docGrid = override.docGrid;
+	if (override.paperSrcFirst !== void 0) result.paperSrcFirst = override.paperSrcFirst;
+	if (override.paperSrcOther !== void 0) result.paperSrcOther = override.paperSrcOther;
+	if (override.formProtection !== void 0) result.formProtection = override.formProtection;
+	if (override.noEndnote !== void 0) result.noEndnote = override.noEndnote;
+	if (override.rtlGutter !== void 0) result.rtlGutter = override.rtlGutter;
+	if (override.printerSettingsRelationshipId !== void 0) result.printerSettingsRelationshipId = override.printerSettingsRelationshipId;
+	return result;
+}
+//#endregion
+export { getColumnCount, getContentHeightPixels, getContentWidthPixels, getDefaultSectionProperties, getMarginsPixels, getPageHeightPixels, getPageWidthPixels, getUnserializedSectionPropertyChildNames, hasDifferentFirstPage, hasDifferentOddEven, hasLineNumbers, hasPageBorders, isLandscape, mergeSectionProperties, parseSectionProperties };

package/dist/docx/selectiveSave.d.ts

@@ -0,0 +1,25 @@
+import { document_d_exports } from "../types/document.js";
+
+//#region src/docx/selectiveSave.d.ts
+type SelectiveSaveOptions = {
+  /** Changed paragraph IDs to selectively patch */changedParaIds: Set<string>; /** Whether structural changes occurred (paragraph add/delete) */
+  structuralChange: boolean; /** Whether any changes affected paragraphs without paraId */
+  hasUntrackedChanges: boolean;
+  /**
+   * Maximum allowed `originalBuffer.byteLength` for the selective path. Above
+   * this size the function returns null and the caller falls back to full
+   * repack. Defaults to {@link DEFAULT_SELECTIVE_SAVE_MAX_BYTES}.
+   */
+  maxBytes?: number;
+};
+/**
+ * Attempt a selective save — patch only changed paragraphs in document.xml.
+ * Also updates comments, headers/footers, and core properties so that
+ * all document parts stay in sync even when only paragraphs are patched.
+ *
+ * Returns the saved ArrayBuffer, or null if selective save is not possible
+ * (caller should fall back to full repack).
+ */
+declare function attemptSelectiveSave(doc: document_d_exports.Document, originalBuffer: ArrayBuffer, options: SelectiveSaveOptions): Promise<ArrayBuffer | null>;
+//#endregion
+export { SelectiveSaveOptions, attemptSelectiveSave };