@stll/folio-core 0.15.0 → 0.15.2

package/dist/docx/metadataPrivacy.d.ts

@@ -33,8 +33,6 @@ declare const PRIVATE_METADATA_PROPERTIES_BY_TRANSFORM: {
 };
 declare const resolveFolioDocumentPrivacyTransforms: (transforms: unknown) => FolioDocumentPrivacyTransform[];
 /** Rewrite selected package metadata fields without changing other package parts. */
-declare const rewriteDocxMetadataPrivacy: (buffer: ArrayBuffer, {
-  transforms
-}: FolioDocumentPrivacyOptions) => Promise<RewriteDocxMetadataPrivacyResult>;
+declare const rewriteDocxMetadataPrivacy: (buffer: ArrayBuffer, { transforms }: FolioDocumentPrivacyOptions) => Promise<RewriteDocxMetadataPrivacyResult>;
 //#endregion
 export { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentMetadataProperty, FolioDocumentPrivacyArchiveError, FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport, FolioDocumentPrivacyTransform, InvalidFolioDocumentPrivacyOptionsError, PRIVATE_METADATA_PROPERTIES_BY_TRANSFORM, RewriteDocxMetadataPrivacyResult, isFolioDocumentPrivacyTransform, resolveFolioDocumentPrivacyTransforms, rewriteDocxMetadataPrivacy };

package/dist/docx/modelValidation.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { ValidateDocumentModelIssue, ValidateDocumentModelResult } from "@stll/docx-core";
-
 //#region src/docx/modelValidation.d.ts
 declare class DocxModelValidationError extends Error {
   readonly issues: ValidateDocumentModelIssue[];

package/dist/docx/newImage.d.ts

@@ -0,0 +1,11 @@
+import { DrawingContent, RunContent } from "../types/content.js";
+//#region src/docx/newImage.d.ts
+/**
+ * A drawing needs a new package image part only when it is model-driven.
+ *
+ * Raw OOXML drawings can carry data-URL previews for browser rendering, but
+ * save replays their raw XML instead of serializing the preview image.
+ */
+declare const isNewDataUrlDrawing: (content: RunContent) => content is DrawingContent;
+//#endregion
+export { isNewDataUrlDrawing };

package/dist/docx/newImage.js

@@ -0,0 +1,11 @@
+//#region src/docx/newImage.ts
+const SYNTHETIC_IMAGE_RID_PREFIX = "rId_img_";
+/**
+* A drawing needs a new package image part only when it is model-driven.
+*
+* Raw OOXML drawings can carry data-URL previews for browser rendering, but
+* save replays their raw XML instead of serializing the preview image.
+*/
+const isNewDataUrlDrawing = (content) => content.type === "drawing" && !content.rawXml && content.image.src?.startsWith("data:") === true && (!content.image.rId || content.image.rId.startsWith(SYNTHETIC_IMAGE_RID_PREFIX));
+//#endregion
+export { isNewDataUrlDrawing };

package/dist/docx/normalizeBaseDirection.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/normalizeBaseDirection.d.ts
 /**
  * Return a copy of `doc` with `bidi` filled in for undecided RTL-led body

package/dist/docx/notePropertiesParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/notePropertiesParser.d.ts
 /**
  * Parse footnote properties from w:footnotePr element

package/dist/docx/numberingParser.d.ts

@@ -1,15 +1,19 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/numberingParser.d.ts
 /**
  * Map of rId to numbering definitions
  */
 type NumberingMap = {
-  definitions: document_d_exports.NumberingDefinitions; /** Get level info for a numId and ilvl */
-  getLevel: (numId: number, ilvl: number) => document_d_exports.ListLevel | null; /** Get the abstract numbering ID referenced by a numId */
-  getAbstractNumId: (numId: number) => number | null; /** Get abstract numbering by ID */
-  getAbstract: (abstractNumId: number) => document_d_exports.AbstractNumbering | null; /** Get the concrete numbering instance for a numId */
-  getInstance: (numId: number) => document_d_exports.NumberingInstance | null; /** Check if numId exists */
+  definitions: document_d_exports.NumberingDefinitions;
+  /** Get level info for a numId and ilvl */
+  getLevel: (numId: number, ilvl: number) => document_d_exports.ListLevel | null;
+  /** Get the abstract numbering ID referenced by a numId */
+  getAbstractNumId: (numId: number) => number | null;
+  /** Get abstract numbering by ID */
+  getAbstract: (abstractNumId: number) => document_d_exports.AbstractNumbering | null;
+  /** Get the concrete numbering instance for a numId */
+  getInstance: (numId: number) => document_d_exports.NumberingInstance | null;
+  /** Check if numId exists */
   hasNumbering: (numId: number) => boolean;
 };
 /**

package/dist/docx/numberingParser.js

@@ -1,4 +1,4 @@
-import { LevelSuffixSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
+import { FontHintSchema, LevelSuffixSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
 import { findChild, findChildren, getAttribute, parseBooleanElement, parseNumericAttribute, parseXmlDocument } from "./xmlParser.js";
 //#region src/docx/numberingParser.ts
 const NUMBER_FORMAT_MAP = {
@@ -468,11 +468,13 @@ function parseLevelRunProps(rPr) {
 		const hAnsi = getAttribute(rFontsEl, "w", "hAnsi");
 		const eastAsia = getAttribute(rFontsEl, "w", "eastAsia");
 		const cs = getAttribute(rFontsEl, "w", "cs");
+		const hint = narrowEnum(getAttribute(rFontsEl, "w", "hint"), FontHintSchema);
 		formatting.fontFamily = {
 			...ascii != null ? { ascii } : {},
 			...hAnsi != null ? { hAnsi } : {},
 			...eastAsia != null ? { eastAsia } : {},
-			...cs != null ? { cs } : {}
+			...cs != null ? { cs } : {},
+			...hint !== void 0 ? { hint } : {}
 		};
 	}
 	if (szEl) {

package/dist/docx/numberingReferenceNormalization.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
-
 //#region src/docx/numberingReferenceNormalization.d.ts
 type NormalizeNumberingReferencesInput = {
   documentBody: document_d_exports.DocumentBody;
@@ -13,13 +12,6 @@ type NormalizeNumberingReferencesInput = {
 type NormalizeNumberingReferencesResult = {
   removedMissingNumberingReferences: number;
 };
-declare const normalizeNumberingReferences: ({
-  documentBody,
-  numbering,
-  headers,
-  footers,
-  footnotes,
-  endnotes
-}: NormalizeNumberingReferencesInput) => NormalizeNumberingReferencesResult;
+declare const normalizeNumberingReferences: ({ documentBody, numbering, headers, footers, footnotes, endnotes }: NormalizeNumberingReferencesInput) => NormalizeNumberingReferencesResult;
 //#endregion
 export { normalizeNumberingReferences };

package/dist/docx/paragraphParser.d.ts

@@ -2,7 +2,6 @@ import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
 import { StyleMap } from "./styleParser.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/paragraphParser.d.ts
 /**
  * Parse paragraph formatting properties (w:pPr)

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, matchesName, 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,9 +677,16 @@ 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;
 }
+function hasRunPayloadElement(runElement) {
+	return getChildElements(runElement).some((child) => !matchesName(child, "w", "rPr"));
+}
 /**
 * Parse all content within a paragraph
 *
@@ -740,10 +743,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 = [{
@@ -776,7 +792,7 @@ function parseParagraphContents(paraElement, styles, theme, _numbering, rels, me
 						type: "commentReference",
 						id: commentReferenceId
 					});
-				} else contents.push(run);
+				} else if (run.content.length > 0 || hasRunPayloadElement(runElement)) contents.push(run);
 				break;
 			}
 			case "hyperlink":

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,19 +1,14 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/paragraphTraversal.d.ts
-type VisitDocxParagraphsInput = {
+type DocxParagraphSurfaces = {
   documentBody: document_d_exports.DocumentBody;
   headers?: Map<string, document_d_exports.HeaderFooter> | undefined;
   footers?: Map<string, document_d_exports.HeaderFooter> | undefined;
   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;
+/** Visit every run directly owned by a paragraph's inline-content tree. */
+declare const visitParagraphRuns: (paragraph: document_d_exports.Paragraph, visit: (run: document_d_exports.Run) => void) => void;
+declare const visitDocxParagraphs: ({ documentBody, headers, footers, footnotes, endnotes }: DocxParagraphSurfaces, visit: (paragraph: document_d_exports.Paragraph) => void) => void;
 //#endregion
-export { visitDocxParagraphs };
+export { DocxParagraphSurfaces, visitDocxParagraphs, visitParagraphRuns };

package/dist/docx/paragraphTraversal.js

@@ -1,17 +1,8 @@
 //#region src/docx/paragraphTraversal.ts
-const visitDocxParagraphs = ({ documentBody, headers, footers, footnotes, endnotes }, visit) => {
-	const seenParagraphs = /* @__PURE__ */ new WeakSet();
-	const visitParagraph = (paragraph) => {
-		if (seenParagraphs.has(paragraph)) return;
-		seenParagraphs.add(paragraph);
-		visit(paragraph);
-		for (const content of paragraph.content) visitParagraphContent(content);
-	};
+/** Visit every run directly owned by a paragraph's inline-content tree. */
+const visitParagraphRuns = (paragraph, visit) => {
 	const visitRun = (run) => {
-		for (const content of run.content) {
-			if (content.type !== "shape" || !content.shape.textBody) continue;
-			for (const block of content.shape.textBody.content) visitBlock(block);
-		}
+		visit(run);
 	};
 	const visitHyperlink = (hyperlink) => {
 		for (const child of hyperlink.children) if (child.type === "run") visitRun(child);
@@ -47,6 +38,22 @@ const visitDocxParagraphs = ({ documentBody, headers, footers, footnotes, endnot
 			for (const run of content.fieldResult) visitRun(run);
 		}
 	};
+	for (const content of paragraph.content) visitParagraphContent(content);
+};
+const visitDocxParagraphs = ({ documentBody, headers, footers, footnotes, endnotes }, visit) => {
+	const seenParagraphs = /* @__PURE__ */ new WeakSet();
+	const visitParagraph = (paragraph) => {
+		if (seenParagraphs.has(paragraph)) return;
+		seenParagraphs.add(paragraph);
+		visit(paragraph);
+		visitParagraphRuns(paragraph, visitRun);
+	};
+	const visitRun = (run) => {
+		for (const content of run.content) {
+			if (content.type !== "shape" || !content.shape.textBody) continue;
+			for (const block of content.shape.textBody.content) visitBlock(block);
+		}
+	};
 	const visitTable = (table) => {
 		for (const row of table.rows) for (const cell of row.cells) visitBlocks(cell.content);
 	};
@@ -73,4 +80,4 @@ const visitDocxParagraphs = ({ documentBody, headers, footers, footnotes, endnot
 	for (const comment of documentBody.comments ?? []) for (const paragraph of comment.content) visitParagraph(paragraph);
 };
 //#endregion
-export { visitDocxParagraphs };
+export { visitDocxParagraphs, visitParagraphRuns };

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

@@ -9,13 +9,16 @@ import { normalizeCommentReferences } from "./commentReferenceNormalization.js";
 import { detectDocxConformanceClass } from "./conformance.js";
 import { parseCoreProperties } from "./corePropertiesParser.js";
 import { extractAllTemplateVariables, parseDocumentBody } from "./documentParser.js";
+import { normalizeDrawingIds } from "./drawingIdNormalization.js";
 import { parseEndnotes, parseFootnotes } from "./footnoteParser.js";
+import { assignHeaderFooterVerbatimXml, refreshHeaderFooterVerbatimFingerprint } 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 +63,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 +124,22 @@ 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;
+		normalizeDrawingIds({
+			documentBody,
+			...headers !== void 0 ? { headers } : {},
+			...footers !== void 0 ? { footers } : {},
+			...footnotes !== void 0 ? { footnotes } : {},
+			...endnotes !== void 0 ? { endnotes } : {}
+		});
+		for (const header of headers?.values() ?? []) refreshHeaderFooterVerbatimFingerprint(header);
+		for (const footer of footers?.values() ?? []) refreshHeaderFooterVerbatimFingerprint(footer);
+		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 +348,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,10 +14,14 @@ 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>;
 declare const TabLeaderSchema: v.PicklistSchema<readonly ["none", "dot", "hyphen", "underscore", "heavy", "middleDot"], undefined>;
+declare const PositionalTabRelativeToSchema: v.PicklistSchema<readonly ["margin", "indent"], undefined>;
+declare const PositionalTabAlignmentSchema: v.PicklistSchema<readonly ["left", "center", "right"], undefined>;
+declare const PositionalTabLeaderSchema: v.PicklistSchema<readonly ["none", "dot", "hyphen", "underscore", "middleDot"], undefined>;
 declare const FrameXAlignSchema: v.PicklistSchema<readonly ["left", "center", "right", "inside", "outside"], undefined>;
 declare const FrameYAlignSchema: v.PicklistSchema<readonly ["top", "center", "bottom", "inside", "outside", "inline"], undefined>;
 declare const FrameWrapSchema: v.PicklistSchema<readonly ["around", "auto", "none", "notBeside", "through", "tight"], undefined>;
@@ -42,4 +45,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, PositionalTabAlignmentSchema, PositionalTabLeaderSchema, PositionalTabRelativeToSchema, 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, POSITIONAL_TAB_ALIGNMENT_VALUES, POSITIONAL_TAB_LEADER_VALUES, POSITIONAL_TAB_RELATIVE_TO_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,10 +40,14 @@ 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);
 const TabLeaderSchema = v.picklist(TAB_LEADER_VALUES);
+const PositionalTabRelativeToSchema = v.picklist(POSITIONAL_TAB_RELATIVE_TO_VALUES);
+const PositionalTabAlignmentSchema = v.picklist(POSITIONAL_TAB_ALIGNMENT_VALUES);
+const PositionalTabLeaderSchema = v.picklist(POSITIONAL_TAB_LEADER_VALUES);
 const FrameXAlignSchema = v.picklist(FRAME_X_ALIGN_VALUES);
 const FrameYAlignSchema = v.picklist(FRAME_Y_ALIGN_VALUES);
 const FrameWrapSchema = v.picklist(FRAME_WRAP_VALUES);
@@ -67,4 +71,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, PositionalTabAlignmentSchema, PositionalTabLeaderSchema, PositionalTabRelativeToSchema, 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;