@stll/folio-core 0.14.1 → 0.15.1

package/dist/docx/paragraphParser.js

@@ -1,5 +1,5 @@
 import { BorderStyleSchema, FrameWrapSchema, FrameXAlignSchema, FrameYAlignSchema, LineSpacingRuleSchema, ParagraphAlignmentSchema, ShadingPatternSchema, TabLeaderSchema, TabStopAlignmentSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
-import { elementToXml, findChild, findChildren, getAttribute, getChildElements, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute } from "./xmlParser.js";
+import { elementToXml, findChild, findChildren, getAttribute, getChildElements, getLocalName, mergeXmlnsDeclarations, parseBooleanElement, parseNumberingLevelAttribute, parseNumericAttribute } from "./xmlParser.js";
 import { parseRun, parseRunProperties } from "./runParser.js";
 import { parseFieldType } from "./fieldParser.js";
 import { isValidHexId } from "../utils/hexId.js";
@@ -100,7 +100,7 @@ function parseTabStops(tabs) {
 				alignment
 			};
 			const leader = narrowEnum(getAttribute(tab, "w", "leader"), TabLeaderSchema);
-			if (leader) tabStop.leader = leader;
+			if (leader && leader !== "none") tabStop.leader = leader;
 			result.push(tabStop);
 		}
 	}
@@ -335,7 +335,7 @@ function parseParagraphProperties(pPr, theme, styles) {
 				if (val !== void 0) formatting.numPr.numId = val;
 			}
 			if (ilvlEl) {
-				const val = parseNumericAttribute(ilvlEl, "w", "val");
+				const val = parseNumberingLevelAttribute(ilvlEl);
 				if (val !== void 0) formatting.numPr.ilvl = val;
 			}
 		}
@@ -368,14 +368,6 @@ function parseParagraphProperties(pPr, theme, styles) {
 	}
 	return Object.keys(formatting).length > 0 ? formatting : void 0;
 }
-/**
-* Get the local name of an element (without namespace prefix)
-*/
-function getLocalName(name) {
-	if (!name) return "";
-	const colonIndex = name.indexOf(":");
-	return colonIndex !== -1 ? name.slice(colonIndex + 1) : name;
-}
 const RENDERED_BREAK_INLINE_WRAPPERS = /* @__PURE__ */ new Set([
 	"hyperlink",
 	"smartTag",
@@ -398,9 +390,13 @@ const RENDERED_BREAK_NON_CONTENT_MARKERS = /* @__PURE__ */ new Set([
 	"commentReference",
 	"permStart",
 	"permEnd",
-	"rsidR"
+	"rsidR",
+	"sdtPr",
+	"sdtEndPr",
+	"smartTagPr"
 ]);
 const RENDERED_BREAK_VISIBLE_RUN_CONTENT = /* @__PURE__ */ new Set([
+	"AlternateContent",
 	"t",
 	"tab",
 	"br",
@@ -681,7 +677,11 @@ function parseSimpleField(node, styles, theme, rels, media, rootXmlns = {}) {
 	if (dirty === "1" || dirty === "true") field.dirty = true;
 	const inScopeXmlns = mergeXmlnsDeclarations(rootXmlns, node);
 	const children = getChildElements(node);
-	for (const child of children) if (getLocalName(child.name) === "r") field.content.push(parseRun(child, styles, theme, rels, media, inScopeXmlns));
+	for (const child of children) {
+		const localName = getLocalName(child.name);
+		if (localName === "r") field.content.push(parseRun(child, styles, theme, rels, media, inScopeXmlns));
+		else if (localName === "hyperlink") field.content.push(parseHyperlink(child, rels, styles, theme, media, inScopeXmlns));
+	}
 	return field;
 }
 /**
@@ -740,10 +740,23 @@ function parseParagraphContents(paraElement, styles, theme, _numbering, rels, me
 				if (inComplexField) {
 					if (instrText) complexFieldInstr += instrText;
 					if ((!complexFieldFormatting || Object.keys(complexFieldFormatting).length === 0) && run.formatting && Object.keys(run.formatting).length > 0) complexFieldFormatting = run.formatting;
+					let inFieldCodeRegion = !hasFieldBegin && !afterSeparator;
+					const fieldCodeContent = [];
+					for (const content of run.content) {
+						if (content.type === "fieldChar") {
+							inFieldCodeRegion = content.charType === "begin";
+							continue;
+						}
+						if (inFieldCodeRegion) fieldCodeContent.push(content);
+					}
+					if (fieldCodeContent.length > 0) complexFieldCodeRuns.push(fieldCodeContent.length === run.content.length ? run : {
+						...run,
+						content: fieldCodeContent
+					});
 					if (hasFieldSeparate) afterSeparator = true;
 					if (afterSeparator && !hasFieldEnd) {
 						if (!hasFieldSeparate) complexFieldResultRuns.push(run);
-					} else if (!afterSeparator && !hasFieldBegin) complexFieldCodeRuns.push(run);
+					}
 					if (hasFieldEnd) {
 						let resultRuns = complexFieldResultRuns;
 						if (resultRuns.length === 0 && !afterSeparator && endOriginalValue !== void 0) resultRuns = [{

package/dist/docx/paragraphTextBoxEnrichment.d.ts

@@ -3,7 +3,6 @@ import { NumberingMap } from "./numberingParser.js";
 import { StyleMap } from "./styleParser.js";
 import { XmlElement } from "./xmlParser.js";
 import { TableParserFn } from "./textBoxParser.js";
-
 //#region src/docx/paragraphTextBoxEnrichment.d.ts
 declare const enrichParagraphTextBoxes: (paragraph: document_d_exports.Paragraph, paraXml: XmlElement, 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, parseTable: TableParserFn) => void;
 //#endregion

package/dist/docx/paragraphTextBoxEnrichment.js

@@ -220,7 +220,8 @@ const scanRunForTextBoxDrawings = (xmlRun) => {
 			continue;
 		}
 		if (name === "pict") {
-			if (findDeep(el, "v", "textbox")) vmlTextBoxes.push(el);
+			if (findDeep(el, "v", "textbox")) if (findDeep(el, "v", "imagedata")) hasNonTextBoxContent = true;
+			else vmlTextBoxes.push(el);
 			else hasNonTextBoxContent = true;
 			continue;
 		}

package/dist/docx/paragraphTraversal.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/paragraphTraversal.d.ts
 type VisitDocxParagraphsInput = {
   documentBody: document_d_exports.DocumentBody;
@@ -8,12 +7,6 @@ type VisitDocxParagraphsInput = {
   footnotes?: readonly document_d_exports.Footnote[] | undefined;
   endnotes?: readonly document_d_exports.Endnote[] | undefined;
 };
-declare const visitDocxParagraphs: ({
-  documentBody,
-  headers,
-  footers,
-  footnotes,
-  endnotes
-}: VisitDocxParagraphsInput, visit: (paragraph: document_d_exports.Paragraph) => void) => void;
+declare const visitDocxParagraphs: ({ documentBody, headers, footers, footnotes, endnotes }: VisitDocxParagraphsInput, visit: (paragraph: document_d_exports.Paragraph) => void) => void;
 //#endregion
 export { visitDocxParagraphs };

package/dist/docx/parser.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { DocxInput } from "../utils/docxInput.js";
 import { DocxUnzipOptions } from "./unzip.js";
-
 //#region src/docx/parser.d.ts
 /**
  * Progress callback for tracking parsing stages
@@ -20,13 +19,21 @@ type MediaResolver = (file: document_d_exports.MediaFile) => Promise<string | nu
  * Parsing options
  */
 type ParseOptions = {
-  /** Progress callback for tracking parsing stages */onProgress?: ProgressCallback; /** Whether to preload fonts (default: true) */
-  preloadFonts?: boolean; /** Whether to parse headers/footers (default: true) */
-  parseHeadersFooters?: boolean; /** Whether to parse footnotes/endnotes (default: true) */
-  parseNotes?: boolean; /** Whether to detect template variables (default: true) */
-  detectVariables?: boolean; /** Password for Agile-encrypted .docx files (Office 2010+). */
-  password?: string | undefined; /** Security limits for DOCX ZIP extraction */
-  unzipLimits?: DocxUnzipOptions; /** Optional async hook to override display URLs for non-browser media. */
+  /** Progress callback for tracking parsing stages */
+  onProgress?: ProgressCallback;
+  /** Whether to preload fonts (default: true) */
+  preloadFonts?: boolean;
+  /** Whether to parse headers/footers (default: true) */
+  parseHeadersFooters?: boolean;
+  /** Whether to parse footnotes/endnotes (default: true) */
+  parseNotes?: boolean;
+  /** Whether to detect template variables (default: true) */
+  detectVariables?: boolean;
+  /** Password for Agile-encrypted .docx files (Office 2010+). */
+  password?: string | undefined;
+  /** Security limits for DOCX ZIP extraction */
+  unzipLimits?: DocxUnzipOptions;
+  /** Optional async hook to override display URLs for non-browser media. */
   mediaResolver?: MediaResolver;
 };
 /**

package/dist/docx/parser.js

@@ -10,12 +10,14 @@ import { detectDocxConformanceClass } from "./conformance.js";
 import { parseCoreProperties } from "./corePropertiesParser.js";
 import { extractAllTemplateVariables, parseDocumentBody } from "./documentParser.js";
 import { parseEndnotes, parseFootnotes } from "./footnoteParser.js";
+import { assignHeaderFooterVerbatimXml } from "./headerFooterVerbatim.js";
 import { parseFooter, parseHeader } from "./headerFooterParser.js";
 import { normalizeHeaderFooterReferences } from "./headerFooterReferenceNormalization.js";
 import { DocxModelValidationError, formatDocumentModelIssues, validateFolioDocumentModel } from "./modelValidation.js";
 import { extractMetafileRaster, isMetafileMimeType } from "./metafileRaster.js";
 import { parseFontTable } from "./fontTableParser.js";
 import { normalizeNumberingReferences } from "./numberingReferenceNormalization.js";
+import { normalizeRenderedPageBreakHints } from "./renderedPageBreakNormalization.js";
 import { parseSettings } from "./settingsParser.js";
 import { parseStylesPackage } from "./styleParser.js";
 import { normalizeTrackedMoveRanges } from "./trackedMoveRangeNormalization.js";
@@ -60,7 +62,8 @@ async function parseDocx(input, options = {}) {
 		onProgress("Extracting DOCX...", 0);
 		const raw = await timeStageAsync("unzip", () => unzipDocx(buffer, {
 			...unzipLimits,
-			password
+			password,
+			extractAllXml: false
 		}));
 		if (raw.wasEncrypted) warnings.push("Document was opened from password-protected storage; saving writes an unencrypted .docx file.");
 		warnings.push(...raw.warnings);
@@ -120,6 +123,13 @@ async function parseDocx(input, options = {}) {
 		onProgress("Parsing comments...", 75);
 		const comments = timeStage("comments", () => parseComments(raw.commentsXml, styles, theme, rels, media, raw.commentsExtensibleXml, raw.commentsExtendedXml));
 		if (comments.length > 0) documentBody.comments = comments;
+		normalizeRenderedPageBreakHints({
+			documentBody,
+			...headers !== void 0 ? { headers } : {},
+			...footers !== void 0 ? { footers } : {},
+			...footnotes !== void 0 ? { footnotes } : {},
+			...endnotes !== void 0 ? { endnotes } : {}
+		});
 		const commentReferenceNormalization = normalizeCommentReferences({
 			documentBody,
 			comments,
@@ -328,6 +338,7 @@ function parseHeadersAndFooters(raw, styles, theme, numbering, rels, media) {
 					watermark.imageTarget = imageRel.target;
 					watermark.imageTargetExternal = true;
 				} else watermark.imageTarget = resolveRelativePath(headerRelsPath, imageRel.target);
+				assignHeaderFooterVerbatimXml(header, headerXml);
 			}
 			headers.set(rId, header);
 		}

package/dist/docx/parserEnums.d.ts

@@ -1,5 +1,4 @@
 import * as v from "valibot";
-
 //#region src/docx/parserEnums.d.ts
 /**
  * Narrow a raw attribute string to a picklist member, or `undefined`
@@ -15,6 +14,7 @@ declare const HighlightColorSchema: v.PicklistSchema<readonly ["black", "blue",
 declare const TextEffectSchema: v.PicklistSchema<readonly ["none", "blinkBackground", "lights", "antsBlack", "antsRed", "shimmer", "sparkle"], undefined>;
 declare const EmphasisMarkSchema: v.PicklistSchema<readonly ["none", "dot", "comma", "circle", "underDot"], undefined>;
 declare const FontThemeSchema: v.PicklistSchema<readonly ["majorAscii", "majorHAnsi", "majorEastAsia", "majorBidi", "minorAscii", "minorHAnsi", "minorEastAsia", "minorBidi"], undefined>;
+declare const FontHintSchema: v.PicklistSchema<readonly ["default", "eastAsia", "cs"], undefined>;
 declare const ParagraphAlignmentSchema: v.PicklistSchema<readonly ["left", "center", "right", "both", "distribute", "mediumKashida", "highKashida", "lowKashida", "thaiDistribute"], undefined>;
 declare const LineSpacingRuleSchema: v.PicklistSchema<readonly ["auto", "exact", "atLeast"], undefined>;
 declare const TabStopAlignmentSchema: v.PicklistSchema<readonly ["left", "center", "right", "decimal", "bar", "clear", "num"], undefined>;
@@ -42,4 +42,4 @@ declare const ShapeTypeSchema: v.PicklistSchema<readonly ["rect", "roundRect", "
 declare const NumberFormatSchema: v.PicklistSchema<readonly ["decimal", "upperRoman", "lowerRoman", "upperLetter", "lowerLetter", "ordinal", "cardinalText", "ordinalText", "hex", "chicago", "ideographDigital", "japaneseCounting", "aiueo", "iroha", "decimalFullWidth", "decimalHalfWidth", "japaneseLegal", "japaneseDigitalTenThousand", "decimalEnclosedCircle", "decimalFullWidth2", "aiueoFullWidth", "irohaFullWidth", "decimalZero", "decimalZero3", "decimalZero4", "decimalZero5", "bullet", "ganada", "chosung", "decimalEnclosedFullstop", "decimalEnclosedParen", "decimalEnclosedCircleChinese", "ideographEnclosedCircle", "ideographTraditional", "ideographZodiac", "ideographZodiacTraditional", "taiwaneseCounting", "ideographLegalTraditional", "taiwaneseCountingThousand", "taiwaneseDigital", "chineseCounting", "chineseLegalSimplified", "chineseCountingThousand", "koreanDigital", "koreanCounting", "koreanLegal", "koreanDigital2", "vietnameseCounting", "russianLower", "russianUpper", "none", "numberInDash", "hebrew1", "hebrew2", "arabicAlpha", "arabicAbjad", "hindiVowels", "hindiConsonants", "hindiNumbers", "hindiCounting", "thaiLetters", "thaiNumbers", "thaiCounting"], undefined>;
 declare const LevelSuffixSchema: v.PicklistSchema<readonly ["tab", "space", "nothing"], undefined>;
 //#endregion
-export { BorderStyleSchema, ConditionalStyleTypeSchema, EmphasisMarkSchema, FieldTypeSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, FontThemeSchema, FrameWrapSchema, FrameXAlignSchema, FrameYAlignSchema, HighlightColorSchema, ImageHorizontalAlignmentSchema, ImageHorizontalRelativeToSchema, ImageVerticalAlignmentSchema, ImageVerticalRelativeToSchema, ImageWrapTextSchema, LevelSuffixSchema, LineSpacingRuleSchema, NumberFormatSchema, ParagraphAlignmentSchema, SdtLockSchema, ShadingPatternSchema, ShapeOutlineStyleSchema, ShapeTypeSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableCellTextDirectionSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum };
+export { BorderStyleSchema, ConditionalStyleTypeSchema, EmphasisMarkSchema, FieldTypeSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, FontHintSchema, FontThemeSchema, FrameWrapSchema, FrameXAlignSchema, FrameYAlignSchema, HighlightColorSchema, ImageHorizontalAlignmentSchema, ImageHorizontalRelativeToSchema, ImageVerticalAlignmentSchema, ImageVerticalRelativeToSchema, ImageWrapTextSchema, LevelSuffixSchema, LineSpacingRuleSchema, NumberFormatSchema, ParagraphAlignmentSchema, SdtLockSchema, ShadingPatternSchema, ShapeOutlineStyleSchema, ShapeTypeSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableCellTextDirectionSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum };

package/dist/docx/parserEnums.js

@@ -1,4 +1,4 @@
-import { BORDER_STYLE_VALUES, CONDITIONAL_STYLE_TYPE_VALUES, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, NUMBER_FORMAT_VALUES, PARAGRAPH_ALIGNMENT_VALUES, SDT_LOCK_VALUES, SHADING_PATTERN_VALUES, SHAPE_OUTLINE_STYLE_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_CELL_TEXT_DIRECTION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_EFFECT_VALUES, THEME_COLOR_SLOT_VALUES, UNDERLINE_STYLE_VALUES } from "../types/documentEnumValues.js";
+import { BORDER_STYLE_VALUES, CONDITIONAL_STYLE_TYPE_VALUES, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_HINT_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, NUMBER_FORMAT_VALUES, PARAGRAPH_ALIGNMENT_VALUES, SDT_LOCK_VALUES, SHADING_PATTERN_VALUES, SHAPE_OUTLINE_STYLE_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_CELL_TEXT_DIRECTION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_EFFECT_VALUES, THEME_COLOR_SLOT_VALUES, UNDERLINE_STYLE_VALUES } from "../types/documentEnumValues.js";
 import * as v from "valibot";
 //#region src/docx/parserEnums.ts
 /**
@@ -40,6 +40,7 @@ const HighlightColorSchema = v.picklist(HIGHLIGHT_COLOR_VALUES);
 const TextEffectSchema = v.picklist(TEXT_EFFECT_VALUES);
 const EmphasisMarkSchema = v.picklist(EMPHASIS_MARK_VALUES);
 const FontThemeSchema = v.picklist(FONT_THEME_VALUES);
+const FontHintSchema = v.picklist(FONT_HINT_VALUES);
 const ParagraphAlignmentSchema = v.picklist(PARAGRAPH_ALIGNMENT_VALUES);
 const LineSpacingRuleSchema = v.picklist(LINE_SPACING_RULE_VALUES);
 const TabStopAlignmentSchema = v.picklist(TAB_STOP_ALIGNMENT_VALUES);
@@ -67,4 +68,4 @@ const ShapeTypeSchema = v.picklist(SHAPE_TYPE_VALUES);
 const NumberFormatSchema = v.picklist(NUMBER_FORMAT_VALUES);
 const LevelSuffixSchema = v.picklist(LEVEL_SUFFIX_VALUES);
 //#endregion
-export { BorderStyleSchema, ConditionalStyleTypeSchema, EmphasisMarkSchema, FieldTypeSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, FontThemeSchema, FrameWrapSchema, FrameXAlignSchema, FrameYAlignSchema, HighlightColorSchema, ImageHorizontalAlignmentSchema, ImageHorizontalRelativeToSchema, ImageVerticalAlignmentSchema, ImageVerticalRelativeToSchema, ImageWrapTextSchema, LevelSuffixSchema, LineSpacingRuleSchema, NumberFormatSchema, ParagraphAlignmentSchema, SdtLockSchema, ShadingPatternSchema, ShapeOutlineStyleSchema, ShapeTypeSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableCellTextDirectionSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum };
+export { BorderStyleSchema, ConditionalStyleTypeSchema, EmphasisMarkSchema, FieldTypeSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, FontHintSchema, FontThemeSchema, FrameWrapSchema, FrameXAlignSchema, FrameYAlignSchema, HighlightColorSchema, ImageHorizontalAlignmentSchema, ImageHorizontalRelativeToSchema, ImageVerticalAlignmentSchema, ImageVerticalRelativeToSchema, ImageWrapTextSchema, LevelSuffixSchema, LineSpacingRuleSchema, NumberFormatSchema, ParagraphAlignmentSchema, SdtLockSchema, ShadingPatternSchema, ShapeOutlineStyleSchema, ShapeTypeSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableCellTextDirectionSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum };

package/dist/docx/relsParser.d.ts

@@ -1,4 +1,5 @@
 import { document_d_exports } from "../types/document.js";
+import "../types/index.js";
 //#region src/docx/relsParser.d.ts
 /**
  * Relationship type constants for common types

package/dist/docx/renderedPageBreakNormalization.d.ts

@@ -0,0 +1,12 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/docx/renderedPageBreakNormalization.d.ts
+type NormalizeRenderedPageBreakHintsInput = {
+  documentBody: document_d_exports.DocumentBody;
+  headers?: Map<string, document_d_exports.HeaderFooter>;
+  footers?: Map<string, document_d_exports.HeaderFooter>;
+  footnotes?: readonly document_d_exports.Footnote[];
+  endnotes?: readonly document_d_exports.Endnote[];
+};
+declare const normalizeRenderedPageBreakHints: ({ documentBody, headers, footers, footnotes, endnotes }: NormalizeRenderedPageBreakHintsInput) => void;
+//#endregion
+export { normalizeRenderedPageBreakHints };

package/dist/docx/renderedPageBreakNormalization.js

@@ -0,0 +1,59 @@
+import { visitDocxParagraphs } from "./paragraphTraversal.js";
+//#region src/docx/renderedPageBreakNormalization.ts
+const normalizeRenderedPageBreakHints = ({ documentBody, headers, footers, footnotes, endnotes }) => {
+	visitDocxParagraphs({
+		documentBody,
+		headers,
+		footers,
+		footnotes,
+		endnotes
+	}, (paragraph) => {
+		if (paragraph.renderedPageBreakBefore === true && !retainsLeadingRenderedPageBreak(paragraph.content)) delete paragraph.renderedPageBreakBefore;
+	});
+};
+const retainsLeadingRenderedPageBreak = (content) => {
+	const scan = { sawRenderedPageBreak: false };
+	for (const item of content) {
+		const result = scanParagraphContent(item, scan);
+		if (result !== void 0) return result;
+	}
+	return false;
+};
+const scanRun = (run, scan) => {
+	for (const content of run.content) {
+		if (content.type === "renderedPageBreak") {
+			scan.sawRenderedPageBreak = true;
+			continue;
+		}
+		return scan.sawRenderedPageBreak;
+	}
+};
+const scanHyperlink = (hyperlink, scan) => {
+	for (const child of hyperlink.children) {
+		if (child.type !== "run") continue;
+		const result = scanRun(child, scan);
+		if (result !== void 0) return result;
+	}
+};
+const scanInlineContent = (content, scan) => {
+	for (const child of content) {
+		const result = child.type === "run" ? scanRun(child, scan) : scanHyperlink(child, scan);
+		if (result !== void 0) return result;
+	}
+};
+const scanParagraphContent = (content, scan) => {
+	if (content.type === "run") return scanRun(content, scan);
+	if (content.type === "hyperlink") return scanHyperlink(content, scan);
+	if (content.type === "simpleField") return scanInlineContent(content.content, scan);
+	if (content.type === "insertion" || content.type === "deletion" || content.type === "moveFrom" || content.type === "moveTo") return scanInlineContent(content.content, scan);
+	if (content.type === "inlineSdt") {
+		for (const child of content.content) {
+			const result = scanParagraphContent(child, scan);
+			if (result !== void 0) return result;
+		}
+		return;
+	}
+	if (content.type === "complexField") return scan.sawRenderedPageBreak;
+};
+//#endregion
+export { normalizeRenderedPageBreakHints };

package/dist/docx/replyToComment.d.ts

@@ -1,10 +1,10 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/replyToComment.d.ts
 type CreateCommentReplyInput = {
   author: string;
   text: string;
-  initials?: string; /** ISO date; defaults to now. */
+  initials?: string;
+  /** ISO date; defaults to now. */
   date?: string;
 };
 /**

package/dist/docx/rezip.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { RawDocxContent } from "./unzip.js";
 import JSZip from "jszip";
-
 //#region src/docx/rezip.d.ts
 declare class DocxPackageFidelityError extends Error {
   constructor(message: string);
@@ -14,8 +13,11 @@ declare function findMaxRId(relsXml: string): number;
  * Options for repacking DOCX
  */
 type RepackOptions = {
-  /** Compression level (0-9, default: 6) */compressionLevel?: number; /** Whether to update modification date in docProps/core.xml */
-  updateModifiedDate?: boolean; /** Custom modifier name for lastModifiedBy */
+  /** Compression level (0-9, default: 6) */
+  compressionLevel?: number;
+  /** Whether to update modification date in docProps/core.xml */
+  updateModifiedDate?: boolean;
+  /** Custom modifier name for lastModifiedBy */
   modifiedBy?: string;
 };
 /**
@@ -125,10 +127,7 @@ declare function hasUnmaterializedHeaderFooter(doc: document_d_exports.Document)
 declare function hasModelDrivenPictureWatermark(doc: document_d_exports.Document): boolean;
 declare function collectHeaderFooterUpdates(doc: document_d_exports.Document): Map<string, string>;
 /** Update existing core-property values without synthesizing absent metadata. */
-declare function updateCoreProperties(corePropsXml: string, {
-  updateModifiedDate,
-  modifiedBy
-}: {
+declare function updateCoreProperties(corePropsXml: string, { updateModifiedDate, modifiedBy }: {
   updateModifiedDate?: boolean;
   modifiedBy?: string;
 }): string;