@stll/folio-core 0.62.0 → 0.63.1

package/dist/docx/runConsolidator.d.ts

@@ -7,34 +7,34 @@ import { formattingEquals, isTextOnlyRun, runsMergeable } from "@stll/docx-core/
  * @param runs - Array of runs to consolidate
  * @returns Consolidated array with fewer, larger runs
  */
-declare function consolidateRuns(runs: document_d_exports.Run[]): document_d_exports.Run[];
+export declare function consolidateRuns(runs: document_d_exports.Run[]): document_d_exports.Run[];
 /**
  * Consolidate runs within a paragraph content array
  *
  * This handles the full paragraph structure, consolidating runs while
  * preserving hyperlinks, bookmarks, and fields as merge boundaries.
  */
-declare function consolidateParagraphContent(content: document_d_exports.Hyperlink["children"]): document_d_exports.Hyperlink["children"];
-declare function consolidateParagraphContent(content: document_d_exports.ParagraphContent[]): document_d_exports.ParagraphContent[];
+export declare function consolidateParagraphContent(content: document_d_exports.Hyperlink["children"]): document_d_exports.Hyperlink["children"];
+export declare function consolidateParagraphContent(content: document_d_exports.ParagraphContent[]): document_d_exports.ParagraphContent[];
 /**
  * Consolidate all runs within a paragraph
  *
  * @param paragraph - Paragraph to consolidate
  * @returns New paragraph with consolidated runs
  */
-declare function consolidateParagraph(paragraph: document_d_exports.Paragraph): document_d_exports.Paragraph;
+export declare function consolidateParagraph(paragraph: document_d_exports.Paragraph): document_d_exports.Paragraph;
 /**
  * Get the number of runs in a paragraph (for debugging/metrics)
  */
-declare function countRuns(paragraph: document_d_exports.Paragraph): number;
+export declare function countRuns(paragraph: document_d_exports.Paragraph): number;
 /**
  * Calculate the consolidation ratio (reduction in number of runs)
  * Useful for debugging and metrics
  */
-declare function getConsolidationStats(originalParagraphs: document_d_exports.Paragraph[], consolidatedParagraphs: document_d_exports.Paragraph[]): {
+export declare function getConsolidationStats(originalParagraphs: document_d_exports.Paragraph[], consolidatedParagraphs: document_d_exports.Paragraph[]): {
   originalRunCount: number;
   consolidatedRunCount: number;
   reductionPercentage: number;
 };
 //#endregion
-export { consolidateParagraph, consolidateParagraphContent, consolidateRuns, countRuns, formattingEquals, getConsolidationStats, isTextOnlyRun, runsMergeable };
+export { formattingEquals, isTextOnlyRun, runsMergeable };

package/dist/docx/runConsolidator.js

@@ -3,6 +3,19 @@ import { runHoldsPayload } from "./runPayload.js";
 import { formattingEquals, isTextOnlyRun, mergeRunContent, runsMergeable, runsMergeable as runsMergeable$1 } from "@stll/docx-core/ops";
 //#region src/docx/runConsolidator.ts
 /**
+* Run Consolidator - Merge consecutive runs with identical formatting
+*
+* DOCX files often contain many small runs with the same formatting,
+* created by Word for various reasons (spell checking, revision tracking,
+* cursor positioning, etc.). This causes:
+* - 252+ tiny <span> elements instead of a few
+* - Poor editing UX (cursor jumps between spans)
+* - Performance issues
+*
+* This module provides utilities to consolidate runs with identical
+* formatting into single runs, reducing fragmentation.
+*/
+/**
 * Consolidate an array of runs by merging consecutive runs with identical formatting
 *
 * @param runs - Array of runs to consolidate

package/dist/docx/runParser.d.ts

@@ -13,7 +13,7 @@ import { StyleMap } from "./styleParser.js";
  * twice is written twice. Naming the owner states that once, at the call site
  * that knows it, instead of leaving it to whichever reader ran first.
  */
-declare const RUN_PROPERTY_OWNERS: {
+export declare const RUN_PROPERTY_OWNERS: {
   /** A `w:r`'s own properties: `Run.propertyChanges` reads the `w:rPrChange`. */
   readonly run: "run";
   /**
@@ -28,14 +28,14 @@ declare const RUN_PROPERTY_OWNERS: {
    */
   readonly standalone: "standalone";
 };
-type RunPropertyOwner = (typeof RUN_PROPERTY_OWNERS)[keyof typeof RUN_PROPERTY_OWNERS];
+export type RunPropertyOwner = (typeof RUN_PROPERTY_OWNERS)[keyof typeof RUN_PROPERTY_OWNERS];
 /**
  * `w:vertAlign` `baseline` is the reserved value that means "no vertical
  * offset", not a third offset beside `superscript` and `subscript`. It is
  * answered here because this module reads the slot, so a consumer deciding
  * whether a run sits on the baseline cannot drift from how it was parsed.
  */
-declare const isBaselineVertAlign: (vertAlign: document_d_exports.TextFormatting["vertAlign"]) => boolean;
+export declare const isBaselineVertAlign: (vertAlign: document_d_exports.TextFormatting["vertAlign"]) => boolean;
 /**
  * The one reader of a run property set (`w:rPr`).
  *
@@ -63,7 +63,7 @@ declare const isBaselineVertAlign: (vertAlign: document_d_exports.TextFormatting
  * means the owner carried no `w:rPr`, or a paragraph-mark carrier contained
  * only metadata owned by the paragraph. An authored empty set remains {}.
  */
-declare function parseRunProperties(rPr: XmlElement | null, theme: document_d_exports.Theme | null, owner: RunPropertyOwner): document_d_exports.TextFormatting | undefined;
+export declare function parseRunProperties(rPr: XmlElement | null, theme: document_d_exports.Theme | null, owner: RunPropertyOwner): document_d_exports.TextFormatting | undefined;
 /**
  * Parse a run element (w:r)
  *
@@ -77,48 +77,47 @@ declare function parseRunProperties(rPr: XmlElement | null, theme: document_d_ex
  *   on its own charges its previews to no package
  * @returns Parsed Run object
  */
-declare function parseRun(node: XmlElement, _styles: StyleMap | null, theme: document_d_exports.Theme | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, rootXmlns?: Record<string, string>, previews?: PreviewLedger): document_d_exports.Run;
+export declare function parseRun(node: XmlElement, _styles: StyleMap | null, theme: document_d_exports.Theme | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, rootXmlns?: Record<string, string>, previews?: PreviewLedger): document_d_exports.Run;
 /**
  * Get plain text from a run
  *
  * @param run - Parsed Run object
  * @returns Concatenated text content
  */
-declare function getRunText(run: document_d_exports.Run): string;
+export declare function getRunText(run: document_d_exports.Run): string;
 /**
  * Check if a run contains any actual content
  *
  * @param run - Parsed Run object
  * @returns true if run has visible content
  */
-declare function hasContent(run: document_d_exports.Run): boolean;
+export declare function hasContent(run: document_d_exports.Run): boolean;
 /**
  * Check if a run contains a drawing/image
  *
  * @param run - Parsed Run object
  * @returns true if run contains an image
  */
-declare function hasImage(run: document_d_exports.Run): boolean;
+export declare function hasImage(run: document_d_exports.Run): boolean;
 /**
  * Get all images from a run
  *
  * @param run - Parsed Run object
  * @returns Array of Image objects
  */
-declare function getImages(run: document_d_exports.Run): document_d_exports.Image[];
+export declare function getImages(run: document_d_exports.Run): document_d_exports.Image[];
 /**
  * Check if a run is part of a complex field
  *
  * @param run - Parsed Run object
  * @returns true if run contains field characters
  */
-declare function hasFieldChar(run: document_d_exports.Run): boolean;
+export declare function hasFieldChar(run: document_d_exports.Run): boolean;
 /**
  * Get field character type if present
  *
  * @param run - Parsed Run object
  * @returns Field character type or null
  */
-declare function getFieldCharType(run: document_d_exports.Run): "begin" | "separate" | "end" | null;
-//#endregion
-export { RUN_PROPERTY_OWNERS, RunPropertyOwner, getFieldCharType, getImages, getRunText, hasContent, hasFieldChar, hasImage, isBaselineVertAlign, parseRun, parseRunProperties };
+export declare function getFieldCharType(run: document_d_exports.Run): "begin" | "separate" | "end" | null;
+//#endregion

package/dist/docx/runParser.js

@@ -1,6 +1,7 @@
 import { parseHorizontalScalePercent } from "../utils/horizontalScale.js";
 import { sliceText } from "../utils/sliceText.js";
 import { NO_MODELLED_ATTRIBUTES, attributeRemainder } from "./attributeRemainder.js";
+import { parseChartPreview } from "./chartPreview.js";
 import { CAPTURE, dispatchChildrenWithContext, keptUnless, ownedElsewhere, sequencePositions } from "./containerChildren.js";
 import { parseDiagramPreview } from "./diagramPreview.js";
 import { parseFieldState } from "./fieldState.js";
@@ -21,7 +22,7 @@ import { resolveThemeFontRef } from "./themeParser.js";
 import { parsePropertyChangeInfo } from "./trackedChangeInfo.js";
 import { captureVerbatimXml } from "./verbatimCapture.js";
 import { parseVmlImageContent, shouldPreserveRawVmlPict } from "./vmlImageParser.js";
-import { WORDPROCESSINGML_NAMESPACE_URIS, cloneWithXmlnsDeclarations, findAllDeep, findChild, findChildren, getAttribute, getChildElements, getLocalName, getNamespaceUri, getTextContent, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute, parseOnOffAttribute, selectAlternateContentBranch } from "./xmlParser.js";
+import { WORDPROCESSINGML_NAMESPACE_URIS, cloneWithXmlnsDeclarations, findAllDeep, findChild, findChildren, getAttribute, getAttributeByNamespaceUri, getChildElements, getLocalName, getNamespaceUri, getTextContent, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute, parseOnOffAttribute, selectAlternateContentBranch } from "./xmlParser.js";
 import { DRAWING_RAW_XML_MODES } from "@stll/docx-core/model";
 //#region src/docx/runParser.ts
 /**
@@ -257,9 +258,9 @@ const readUnderline = (u, formatting) => {
 };
 /** @returns whether `w:lang` named a tag for any of the three scripts. */
 const readLanguage = (lang, formatting) => {
-	const val = truncateLanguageTag(getAttribute(lang, "w", "val") || void 0);
-	const eastAsia = truncateLanguageTag(getAttribute(lang, "w", "eastAsia") || void 0);
-	const bidi = truncateLanguageTag(getAttribute(lang, "w", "bidi") || void 0);
+	const val = truncateLanguageTag(getAttributeByNamespaceUri(lang, WORDPROCESSINGML_NAMESPACE_URIS, "val") || void 0);
+	const eastAsia = truncateLanguageTag(getAttributeByNamespaceUri(lang, WORDPROCESSINGML_NAMESPACE_URIS, "eastAsia") || void 0);
+	const bidi = truncateLanguageTag(getAttributeByNamespaceUri(lang, WORDPROCESSINGML_NAMESPACE_URIS, "bidi") || void 0);
 	if (!val && !eastAsia && !bidi) return false;
 	formatting.language = {
 		...val ? { val } : {},
@@ -609,6 +610,13 @@ function parseDrawingContent(element, rels, media, previews) {
 		rawXml: captureVerbatimXml(element),
 		rawXmlMode: DRAWING_RAW_XML_MODES.PRESERVE_ONLY
 	};
+	const chartImage = parseChartPreview(element, rels ?? void 0, media ?? void 0);
+	if (chartImage) return {
+		type: "drawing",
+		image: chartImage,
+		rawXml: captureVerbatimXml(element),
+		rawXmlMode: DRAWING_RAW_XML_MODES.PRESERVE_ONLY
+	};
 	if (shouldPreserveRawShapeDrawing(element)) return preserveOnlyDrawing(captureVerbatimXml(element));
 	const shape = parseShapeFromDrawing(element);
 	if (shape) return {
@@ -728,6 +736,20 @@ function parseRunContents(runElement, rels, media, previews, rootXmlns = {}) {
 						break;
 					}
 				}
+				const fallbackDrawing = fallbackEl ? getChildElements(fallbackEl).find((el) => getLocalName(el.name) === "drawing") : void 0;
+				const fallbackImage = fallbackDrawing ? parseImage(fallbackDrawing, rels ?? void 0, media ?? void 0) : null;
+				if (fallbackImage?.src && choiceEl) {
+					const choiceDrawing = getChildElements(choiceEl).find((el) => getLocalName(el.name) === "drawing");
+					const choiceImage = choiceDrawing ? parseImage(choiceDrawing, rels ?? void 0, media ?? void 0) : null;
+					if (choiceImage) fallbackImage.size = choiceImage.size;
+					contents.push({
+						type: "drawing",
+						image: fallbackImage,
+						rawXml: captureVerbatimXml(child),
+						rawXmlMode: DRAWING_RAW_XML_MODES.PRESERVE_ONLY
+					});
+					break;
+				}
 				const fallbackPict = fallbackEl ? getChildElements(fallbackEl).find((el) => getLocalName(el.name) === "pict") : void 0;
 				const fallbackVml = fallbackPict && !choiceTextBoxDrawing ? parseVmlImageContent(fallbackPict, rels, media, previews, rootXmlns) : null;
 				if (fallbackVml?.image.src) {
@@ -768,9 +790,7 @@ function parseRunContents(runElement, rels, media, previews, rootXmlns = {}) {
 				if (contents.length === contentsBeforeAlternate && !hasTextBoxBranch) contents.push(preserveOnlyDrawing(captureVerbatimXml(cloneWithXmlnsDeclarations(child, rootXmlns))));
 				break;
 			}
-			default:
-				contents.push(preserveRunChild(child));
-				break;
+			default: contents.push(preserveRunChild(child));
 		}
 	}
 	return contents;
@@ -818,9 +838,10 @@ function getRunText(run) {
 	let text = "";
 	for (const content of run.content) if (content.type === "text") text += content.text;
 	else if (content.type === "tab") text += "	";
-	else if (content.type === "break") if (content.breakType === "page") text += "\f";
-	else text += "\n";
-	else if (content.type === "softHyphen") text += "­";
+	else if (content.type === "break") {
+		if (content.breakType === "page") text += "\f";
+		else text += "\n";
+	} else if (content.type === "softHyphen") text += "­";
 	else if (content.type === "noBreakHyphen") text += "‑";
 	return text;
 }

package/dist/docx/runPayload.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/docx/runPayload.d.ts
-declare const runHoldsPayload: (run: document_d_exports.Run) => boolean;
-//#endregion
-export { runHoldsPayload };
+export declare const runHoldsPayload: (run: document_d_exports.Run) => boolean;
+//#endregion

package/dist/docx/runPropertyPresence.d.ts

@@ -1,11 +1,10 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
 //#region src/docx/runPropertyPresence.d.ts
-declare const EMPTY_RUN_PROPERTIES_ATTRIBUTE = "emptyRunProperties";
-declare const retainsEmptyRunProperties: (element: XmlElement) => boolean;
-declare const omitsPreviousRunProperties: (element: XmlElement) => boolean;
-declare const serializePreviousRunProperties: (properties: document_d_exports.TextFormatting | undefined) => string;
-declare const serializeEmptyRunProperties: (run: document_d_exports.Run) => string[];
-declare const isEmptyRunPropertiesAttribute: ({ namespace, name }: Pick<document_d_exports.PreservedAttribute, "namespace" | "name">) => boolean;
-//#endregion
-export { EMPTY_RUN_PROPERTIES_ATTRIBUTE, isEmptyRunPropertiesAttribute, omitsPreviousRunProperties, retainsEmptyRunProperties, serializeEmptyRunProperties, serializePreviousRunProperties };
+export declare const EMPTY_RUN_PROPERTIES_ATTRIBUTE = "emptyRunProperties";
+export declare const retainsEmptyRunProperties: (element: XmlElement) => boolean;
+export declare const omitsPreviousRunProperties: (element: XmlElement) => boolean;
+export declare const serializePreviousRunProperties: (properties: document_d_exports.TextFormatting | undefined) => string;
+export declare const serializeEmptyRunProperties: (run: document_d_exports.Run) => string[];
+export declare const isEmptyRunPropertiesAttribute: ({ namespace, name }: Pick<document_d_exports.PreservedAttribute, "namespace" | "name">) => boolean;
+//#endregion

package/dist/docx/saveDiagnostics.d.ts

@@ -1,7 +1,7 @@
 import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
 //#region src/docx/saveDiagnostics.d.ts
 /** Save diagnostics describe fidelity fallbacks without including document content. */
-type SaveDiagnostic = {
+export type SaveDiagnostic = {
   type: "sourceReplayMismatch";
   part: string;
 } | {
@@ -15,8 +15,7 @@ type SaveDiagnostic = {
   gap: typeof CANONICAL_GAP.resourceReplacement;
   part: string;
 };
-type SaveDiagnosticOptions = {
+export type SaveDiagnosticOptions = {
   onDiagnostic?: ((diagnostic: SaveDiagnostic) => void) | undefined;
 };
-//#endregion
-export { SaveDiagnostic, SaveDiagnosticOptions };
+//#endregion

package/dist/docx/sdtProperties.d.ts

@@ -8,9 +8,9 @@ import { XmlElement } from "./xmlParser.js";
  * any prefix, and the local name is what tells `w14:checkbox` from a run's
  * `w:color`, because `CT_SdtPr` declares neither name twice.
  */
-declare const preservedSdtChild: (preserved: document_d_exports.PreservedMarkup | undefined, localName: string) => string | undefined;
+export declare const preservedSdtChild: (preserved: document_d_exports.PreservedMarkup | undefined, localName: string) => string | undefined;
 /** The same set without that child, or `undefined` when nothing is left. */
-declare const withoutPreservedSdtChild: (preserved: document_d_exports.PreservedMarkup | undefined, localName: string) => document_d_exports.PreservedMarkup | undefined;
+export declare const withoutPreservedSdtChild: (preserved: document_d_exports.PreservedMarkup | undefined, localName: string) => document_d_exports.PreservedMarkup | undefined;
 /**
  * Whether one preserved child is the element that states the control kind.
  *
@@ -19,7 +19,7 @@ declare const withoutPreservedSdtChild: (preserved: document_d_exports.Preserved
  * code still gets one; and it is this child, not the whole set, that the
  * modelled interactive state is written back into.
  */
-declare const statesControlKind: (xml: string) => boolean;
+export declare const statesControlKind: (xml: string) => boolean;
 /**
  * Direct children of `w:sdt` that sit outside `w:sdtContent`, split by side.
  *
@@ -28,7 +28,7 @@ declare const statesControlKind: (xml: string) => boolean;
  * captured rather than mistaken for `w:sdtPr`, `w:sdtEndPr`, or
  * `w:sdtContent`.
  */
-declare const captureSdtSiblingMarkers: (sdt: XmlElement) => {
+export declare const captureSdtSiblingMarkers: (sdt: XmlElement) => {
   before: string;
   after: string;
 };
@@ -43,6 +43,5 @@ declare const captureSdtSiblingMarkers: (sdt: XmlElement) => {
  * outcome, because a map keyed by name cannot list the values a reader will
  * not admit.
  */
-declare function parseSdtProperties(sdtPr: XmlElement | null | undefined, sdtEndPr?: XmlElement | null | undefined): document_d_exports.SdtProperties;
-//#endregion
-export { captureSdtSiblingMarkers, parseSdtProperties, preservedSdtChild, statesControlKind, withoutPreservedSdtChild };
+export declare function parseSdtProperties(sdtPr: XmlElement | null | undefined, sdtEndPr?: XmlElement | null | undefined): document_d_exports.SdtProperties;
+//#endregion

package/dist/docx/sdtPropertiesPatch.d.ts

@@ -6,6 +6,5 @@ import { document_d_exports } from "../types/document.js";
  * Pure: returns a new string; the input is not modified. A kind the model
  * states nothing interactive about comes back unchanged.
  */
-declare const withModelledControlState: (xml: string, props: document_d_exports.SdtProperties) => string;
-//#endregion
-export { withModelledControlState };
+export declare const withModelledControlState: (xml: string, props: document_d_exports.SdtProperties) => string;
+//#endregion

package/dist/docx/sectionParser.d.ts

@@ -8,7 +8,7 @@ import { XmlElement } from "./xmlParser.js";
  * @param sectPr - The w:sectPr element
  * @returns SectionProperties object
  */
-declare function parseSectionProperties(sectPr: XmlElement | null, context?: ParseContext): document_d_exports.SectionProperties;
+export declare function parseSectionProperties(sectPr: XmlElement | null, context?: ParseContext): document_d_exports.SectionProperties;
 /**
  * Get page width in pixels (96 DPI)
  *
@@ -16,7 +16,7 @@ declare function parseSectionProperties(sectPr: XmlElement | null, context?: Par
  * @param defaultWidth - Default width in twips (default: 12240 = 8.5 inches)
  * @returns Width in pixels
  */
-declare function getPageWidthPixels(props: document_d_exports.SectionProperties, defaultWidth?: number): number;
+export declare function getPageWidthPixels(props: document_d_exports.SectionProperties, defaultWidth?: number): number;
 /**
  * Get page height in pixels (96 DPI)
  *
@@ -24,28 +24,28 @@ declare function getPageWidthPixels(props: document_d_exports.SectionProperties,
  * @param defaultHeight - Default height in twips (default: 15840 = 11 inches)
  * @returns Height in pixels
  */
-declare function getPageHeightPixels(props: document_d_exports.SectionProperties, defaultHeight?: number): number;
+export declare function getPageHeightPixels(props: document_d_exports.SectionProperties, defaultHeight?: number): number;
 /**
  * Get content width (page width minus margins) in pixels
  *
  * @param props - Section properties
  * @returns Content width in pixels
  */
-declare function getContentWidthPixels(props: document_d_exports.SectionProperties): number;
+export declare function getContentWidthPixels(props: document_d_exports.SectionProperties): number;
 /**
  * Get content height (page height minus margins) in pixels
  *
  * @param props - Section properties
  * @returns Content height in pixels
  */
-declare function getContentHeightPixels(props: document_d_exports.SectionProperties): number;
+export declare function getContentHeightPixels(props: document_d_exports.SectionProperties): number;
 /**
  * Get margins in pixels
  *
  * @param props - Section properties
  * @returns Object with all margins in pixels
  */
-declare function getMarginsPixels(props: document_d_exports.SectionProperties): {
+export declare function getMarginsPixels(props: document_d_exports.SectionProperties): {
   top: number;
   bottom: number;
   left: number;
@@ -57,31 +57,31 @@ declare function getMarginsPixels(props: document_d_exports.SectionProperties):
 /**
  * Check if section has different first page header/footer
  */
-declare function hasDifferentFirstPage(props: document_d_exports.SectionProperties): boolean;
+export declare function hasDifferentFirstPage(props: document_d_exports.SectionProperties): boolean;
 /**
  * Check if section has different odd/even page headers/footers
  */
-declare function hasDifferentOddEven(props: document_d_exports.SectionProperties): boolean;
+export declare function hasDifferentOddEven(props: document_d_exports.SectionProperties): boolean;
 /**
  * Get effective column count (minimum 1)
  */
-declare function getColumnCount(props: document_d_exports.SectionProperties): number;
+export declare function getColumnCount(props: document_d_exports.SectionProperties): number;
 /**
  * Check if section is landscape
  */
-declare function isLandscape(props: document_d_exports.SectionProperties): boolean;
+export declare function isLandscape(props: document_d_exports.SectionProperties): boolean;
 /**
  * Check if section has page borders
  */
-declare function hasPageBorders(props: document_d_exports.SectionProperties): boolean;
+export declare function hasPageBorders(props: document_d_exports.SectionProperties): boolean;
 /**
  * Check if section has line numbers
  */
-declare function hasLineNumbers(props: document_d_exports.SectionProperties): boolean;
+export declare function hasLineNumbers(props: document_d_exports.SectionProperties): boolean;
 /**
  * Get default section properties (US Letter size, 1 inch margins)
  */
-declare function getDefaultSectionProperties(): document_d_exports.SectionProperties;
+export declare function getDefaultSectionProperties(): document_d_exports.SectionProperties;
 /**
  * Merge section properties (later values override earlier)
  *
@@ -89,6 +89,5 @@ declare function getDefaultSectionProperties(): document_d_exports.SectionProper
  * @param override - Override properties
  * @returns Merged properties
  */
-declare function mergeSectionProperties(base: document_d_exports.SectionProperties, override: document_d_exports.SectionProperties): document_d_exports.SectionProperties;
-//#endregion
-export { getColumnCount, getContentHeightPixels, getContentWidthPixels, getDefaultSectionProperties, getMarginsPixels, getPageHeightPixels, getPageWidthPixels, hasDifferentFirstPage, hasDifferentOddEven, hasLineNumbers, hasPageBorders, isLandscape, mergeSectionProperties, parseSectionProperties };
+export declare function mergeSectionProperties(base: document_d_exports.SectionProperties, override: document_d_exports.SectionProperties): document_d_exports.SectionProperties;
+//#endregion

package/dist/docx/sectionReferenceHistory.d.ts

@@ -1,17 +1,18 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
+import { TaggedErrorClass } from "better-result";
 //#region src/docx/sectionReferenceHistory.d.ts
 type PreviousReferences = NonNullable<document_d_exports.SectionPropertyChange["previousReferences"]>;
-declare const InvalidSectionReferenceHistoryError_base: import("better-result").TaggedErrorClass<"InvalidSectionReferenceHistoryError">;
-declare class InvalidSectionReferenceHistoryError extends InvalidSectionReferenceHistoryError_base<{
+declare const InvalidSectionReferenceHistoryErrorBase: TaggedErrorClass<"InvalidSectionReferenceHistoryError">;
+export declare class InvalidSectionReferenceHistoryError extends InvalidSectionReferenceHistoryErrorBase<{
   message: string;
 }> {}
-declare const parseSectionReferenceHistory: (change: XmlElement) => PreviousReferences | undefined;
-declare const serializeSectionReferenceHistory: (references: PreviousReferences | undefined) => string;
-declare const sectionReferenceSelection: (properties: document_d_exports.SectionProperties) => PreviousReferences;
-declare const sectionReferenceHistory: ({ previous, target }: {
+export declare const parseSectionReferenceHistory: (change: XmlElement) => PreviousReferences | undefined;
+export declare const serializeSectionReferenceHistory: (references: PreviousReferences | undefined) => string;
+export declare const sectionReferenceSelection: (properties: document_d_exports.SectionProperties) => PreviousReferences;
+export declare const sectionReferenceHistory: ({ previous, target }: {
   previous: document_d_exports.SectionProperties;
   target: document_d_exports.SectionProperties;
 }) => PreviousReferences | undefined;
 //#endregion
-export { InvalidSectionReferenceHistoryError, parseSectionReferenceHistory, sectionReferenceHistory, sectionReferenceSelection, serializeSectionReferenceHistory };
+export {};

package/dist/docx/sectionReferenceHistory.js

@@ -5,7 +5,8 @@ import { escapeXmlAttribute } from "@stll/docx-core";
 //#region src/docx/sectionReferenceHistory.ts
 const SECTION_REFERENCE_HISTORY_NAMESPACE = "urn:stella:folio:section-reference-history:1";
 const HISTORY_NAMESPACES = /* @__PURE__ */ new Set([SECTION_REFERENCE_HISTORY_NAMESPACE]);
-var InvalidSectionReferenceHistoryError = class extends TaggedError("InvalidSectionReferenceHistoryError") {};
+const InvalidSectionReferenceHistoryErrorBase = TaggedError("InvalidSectionReferenceHistoryError");
+var InvalidSectionReferenceHistoryError = class extends InvalidSectionReferenceHistoryErrorBase {};
 const invalidHistory = () => {
 	throw new InvalidSectionReferenceHistoryError({ message: "Invalid section reference revision history." });
 };

package/dist/docx/selectedXmlIdentityScan.d.ts

@@ -1,10 +1,9 @@
 import { scanStreamingXmlElements } from "./streamingXmlParser.js";
 //#region src/docx/selectedXmlIdentityScan.d.ts
 /** Identity census follows the parser's first-Choice, otherwise-Fallback policy. */
-declare const scanSelectedStreamingXmlElements: (xml: string, visitor: Parameters<typeof scanStreamingXmlElements>[1]) => {
+export declare const scanSelectedStreamingXmlElements: (xml: string, visitor: Parameters<typeof scanStreamingXmlElements>[1]) => {
   status: "unsupported";
 } | {
   status: "scanned";
 };
-//#endregion
-export { scanSelectedStreamingXmlElements };
+//#endregion

package/dist/docx/selectiveSave.d.ts

@@ -2,7 +2,7 @@ import { document_d_exports } from "../types/document.js";
 import { SaveDiagnosticOptions } from "./saveDiagnostics.js";
 import { DocumentBodyAuthorityOptions } from "./serializer/documentSerializer.js";
 //#region src/docx/selectiveSave.d.ts
-type SelectiveSaveOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
+export type SelectiveSaveOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
   /** Changed paragraph IDs to selectively patch */
   changedParaIds: Set<string>;
   /** Whether paragraph membership, order, or block structure changed. */
@@ -16,6 +16,5 @@ type SelectiveSaveOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOptions
    */
   maxBytes?: number;
 };
-declare function attemptSelectiveSave(doc: document_d_exports.Document, originalBuffer: ArrayBuffer, options: SelectiveSaveOptions): Promise<ArrayBuffer | null>;
-//#endregion
-export { SelectiveSaveOptions, attemptSelectiveSave };
+export declare function attemptSelectiveSave(doc: document_d_exports.Document, originalBuffer: ArrayBuffer, options: SelectiveSaveOptions): Promise<ArrayBuffer | null>;
+//#endregion

package/dist/docx/selectiveSave.js

@@ -1,6 +1,6 @@
 import { decodeText, encodeUtf8 } from "../utils/textEncoding.js";
 import { parseCommentsExtended } from "./commentParser.js";
-import { withoutOrphanCommentRanges } from "./commentRangeIntegrity.js";
+import { withoutExhaustedComments, withoutOrphanCommentRanges } from "./commentRangeIntegrity.js";
 import { hasUnsynthesizedReplyRanges } from "./commentReplyMarkers.js";
 import { detectDocxConformanceClass } from "./conformance.js";
 import { validateFolioDocumentModel } from "./modelValidation.js";
@@ -183,6 +183,7 @@ const queueSettingsUpdates = async (zip, updates) => {
 	if (filtered.relsXml !== void 0) updates.set("word/_rels/settings.xml.rels", filtered.relsXml);
 };
 async function attemptSelectiveSave(doc, originalBuffer, options) {
+	doc = withoutExhaustedComments(doc);
 	const { changedParaIds, structuralChange, hasUntrackedChanges } = options;
 	const maxBytes = options.maxBytes ?? 104857600;
 	if (hasUntrackedChanges) return null;
@@ -240,7 +241,8 @@ async function attemptSelectiveSave(doc, originalBuffer, options) {
 			const originalBodyParaIds = structuralChange ? collectParaIds(originalDocXml) : void 0;
 			if (structuralChange && doc.package.numbering) {
 				const numberingFile = findZipEntryCaseInsensitive(zip, "word/numbering.xml");
-				const added = collectAddedNumberingDefs(numberingFile ? serializeNumberingXml(parseNumbering(await numberingFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }))).definitions) : "", serializeNumberingXml(doc.package.numbering));
+				const baselineNumbering = numberingFile ? serializeNumberingXml(parseNumbering(await numberingFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }))).definitions) : "";
+				const added = collectAddedNumberingDefs(baselineNumbering, serializeNumberingXml(doc.package.numbering));
 				if (added.abstractNums.size > 0 || added.nums.size > 0) return null;
 			}
 			const bodyChangedIds = /* @__PURE__ */ new Set();
@@ -315,7 +317,8 @@ async function attemptSelectiveSave(doc, originalBuffer, options) {
 			const lowerPath = path.toLowerCase();
 			return lowerPath.startsWith("word/") && (lowerPath.endsWith(".xml") || lowerPath.endsWith(".rels"));
 		})) {
-			if (detectDocxConformanceClass(await findZipEntryCaseInsensitive(zip, "word/document.xml")?.async("text") ?? null) === DOCX_CONFORMANCE_CLASSES.STRICT) return null;
+			const sourceDocumentXml = await findZipEntryCaseInsensitive(zip, "word/document.xml")?.async("text");
+			if (detectDocxConformanceClass(sourceDocumentXml ?? null) === DOCX_CONFORMANCE_CLASSES.STRICT) return null;
 		}
 		return await applyUpdatesToZip(zip, updates);
 	} catch {

package/dist/docx/selectiveSaveFlags.d.ts

@@ -15,7 +15,7 @@
  *   above this size, since holding them in memory plus the JSZip overhead is
  *   the dominant cost.
  */
-type FolioSelectiveSaveFlags = {
+export type FolioSelectiveSaveFlags = {
   /**
    * Enable the selective save path. Default: true. A save always succeeds:
    * when the patch-safety checks refuse, the caller falls back to a full
@@ -31,12 +31,11 @@ type FolioSelectiveSaveFlags = {
   /** Maximum original buffer size, in bytes, for which selective save is allowed. */
   selectiveSaveMaxBytes?: number;
 };
-declare const DEFAULT_SELECTIVE_SAVE_MAX_BYTES: number;
-type ResolvedSelectiveSaveFlags = {
+export declare const DEFAULT_SELECTIVE_SAVE_MAX_BYTES: number;
+export type ResolvedSelectiveSaveFlags = {
   selectiveSave: boolean;
   selectiveSaveTripwire: boolean;
   selectiveSaveMaxBytes: number;
 };
-declare function resolveSelectiveSaveFlags(flags: FolioSelectiveSaveFlags | undefined): ResolvedSelectiveSaveFlags;
-//#endregion
-export { DEFAULT_SELECTIVE_SAVE_MAX_BYTES, FolioSelectiveSaveFlags, ResolvedSelectiveSaveFlags, resolveSelectiveSaveFlags };
+export declare function resolveSelectiveSaveFlags(flags: FolioSelectiveSaveFlags | undefined): ResolvedSelectiveSaveFlags;
+//#endregion

package/dist/docx/selectiveSaveFlags.js

@@ -1,5 +1,5 @@
 //#region src/docx/selectiveSaveFlags.ts
-const DEFAULT_SELECTIVE_SAVE_MAX_BYTES = 100 * 1024 * 1024;
+const DEFAULT_SELECTIVE_SAVE_MAX_BYTES = 104857600;
 function resolveSelectiveSaveFlags(flags) {
 	return {
 		selectiveSave: flags?.selectiveSave ?? true,

package/dist/docx/selectiveSaveTripwire.d.ts

@@ -13,7 +13,7 @@
  * The diff ignores `docProps/core.xml` because both paths refresh
  * `dcterms:modified` with the current wall clock and would always disagree.
  */
-type TripwireResult = {
+export type TripwireResult = {
   kind: "match";
 } | {
   kind: "selective-skipped";
@@ -28,6 +28,5 @@ type TripwireResult = {
   selectiveSize: number;
   fullSize: number;
 };
-declare function compareSelectiveVsFull(selective: ArrayBuffer | null, full: ArrayBuffer): Promise<TripwireResult>;
-//#endregion
-export { TripwireResult, compareSelectiveVsFull };
+export declare function compareSelectiveVsFull(selective: ArrayBuffer | null, full: ArrayBuffer): Promise<TripwireResult>;
+//#endregion