@stll/folio-core 0.47.7 → 0.49.0

package/dist/docx/sectionParser.js

@@ -1,6 +1,6 @@
 import { NO_MODELLED_ATTRIBUTES, attributeRemainder } from "./attributeRemainder.js";
 import { parseBorderSpec } from "./borderParser.js";
-import { CAPTURE, dispatchChildren, keptUnless, sequencePositions } from "./containerChildren.js";
+import { CAPTURE, dispatchChildrenWithContext, keptUnless, sequencePositions } from "./containerChildren.js";
 import { parseFooterReference, parseHeaderReference } from "./headerFooterRefParser.js";
 import { parseEndnoteProperties, parseFootnoteProperties } from "./notePropertiesParser.js";
 import { NumberFormatSchema, TextDirectionSchema, narrowEnum } from "./parserEnums.js";
@@ -67,6 +67,165 @@ function parseLineNumberRestart(restart) {
 		default: return;
 	}
 }
+const SECTION_PROPERTY_HANDLERS = {
+	headerReference: (child, { headerRefs, context }) => {
+		const reference = parseHeaderReference(child, context);
+		if (reference) headerRefs.push(reference);
+	},
+	footerReference: (child, { footerRefs, context }) => {
+		const reference = parseFooterReference(child, context);
+		if (reference) footerRefs.push(reference);
+	},
+	footnotePr: (child, { props }) => {
+		const footnotePr = parseFootnoteProperties(child);
+		if (Object.keys(footnotePr).length > 0) {
+			props.footnotePr = footnotePr;
+			return;
+		}
+		return CAPTURE;
+	},
+	endnotePr: (child, { props }) => {
+		const endnotePr = parseEndnoteProperties(child);
+		if (Object.keys(endnotePr).length > 0) {
+			props.endnotePr = endnotePr;
+			return;
+		}
+		return CAPTURE;
+	},
+	type: (child, { props }) => {
+		const sectionStart = parseSectionStart(getAttribute(child, "w", "val"));
+		if (sectionStart) props.sectionStart = sectionStart;
+		return keptUnless(sectionStart !== void 0);
+	},
+	pgSz: (child, { props }) => {
+		const width = parseNumericAttribute(child, "w", "w");
+		if (width !== void 0) props.pageWidth = Math.min(width, MAX_PAGE_DIMENSION_TWIPS);
+		const height = parseNumericAttribute(child, "w", "h");
+		if (height !== void 0) props.pageHeight = Math.min(height, MAX_PAGE_DIMENSION_TWIPS);
+		const orientation = parseOrientation(getAttribute(child, "w", "orient"));
+		if (orientation) props.orientation = orientation;
+		return keptUnless(width !== void 0 || height !== void 0 || orientation !== void 0);
+	},
+	pgMar: (child, { props }) => {
+		const margins = [
+			["top", "marginTop"],
+			["bottom", "marginBottom"],
+			["left", "marginLeft"],
+			["right", "marginRight"],
+			["header", "headerDistance"],
+			["footer", "footerDistance"],
+			["gutter", "gutter"]
+		];
+		let taken = false;
+		for (const [attribute, field] of margins) {
+			const value = parseNumericAttribute(child, "w", attribute);
+			if (value !== void 0) {
+				props[field] = value;
+				taken = true;
+			}
+		}
+		return keptUnless(taken);
+	},
+	paperSrc: (child, { props }) => {
+		const first = parseNumericAttribute(child, "w", "first");
+		if (first !== void 0) props.paperSrcFirst = first;
+		const other = parseNumericAttribute(child, "w", "other");
+		if (other !== void 0) props.paperSrcOther = other;
+		return keptUnless(first !== void 0 || other !== void 0);
+	},
+	pgBorders: (child, { props, context }) => keptUnless(readPageBorders(props, child, context)),
+	lnNumType: (child, { props }) => {
+		const lineNumbers = {};
+		for (const [attribute, field] of [
+			["start", "start"],
+			["countBy", "countBy"],
+			["distance", "distance"]
+		]) {
+			const value = parseNumericAttribute(child, "w", attribute);
+			if (value !== void 0) lineNumbers[field] = value;
+		}
+		const restart = parseLineNumberRestart(getAttribute(child, "w", "restart"));
+		if (restart) lineNumbers.restart = restart;
+		if (Object.keys(lineNumbers).length === 0) return CAPTURE;
+		props.lineNumbers = lineNumbers;
+	},
+	pgNumType: (child, { props }) => {
+		const pageNumbering = {};
+		const format = narrowEnum(getAttribute(child, "w", "fmt"), NumberFormatSchema);
+		if (format) pageNumbering.format = format;
+		const start = parseNumericAttribute(child, "w", "start");
+		if (start !== void 0) pageNumbering.start = start;
+		const chapterStyle = parseNumericAttribute(child, "w", "chapStyle");
+		if (chapterStyle !== void 0) pageNumbering.chapterStyle = chapterStyle;
+		const chapterSeparator = getAttribute(child, "w", "chapSep");
+		if (chapterSeparator) pageNumbering.chapterSeparator = chapterSeparator;
+		if (Object.keys(pageNumbering).length === 0) return CAPTURE;
+		props.pageNumbering = pageNumbering;
+	},
+	cols: (child, { props }) => keptUnless(readColumns(props, child)),
+	formProt: (child, { props, context }) => {
+		props.formProtection = parseBooleanElement(child, "w", context);
+	},
+	vAlign: (child, { props }) => {
+		const verticalAlign = parseVerticalAlign(getAttribute(child, "w", "val"));
+		if (verticalAlign) props.verticalAlign = verticalAlign;
+		return keptUnless(verticalAlign !== void 0);
+	},
+	noEndnote: (child, { props, context }) => {
+		props.noEndnote = parseBooleanElement(child, "w", context);
+	},
+	titlePg: (child, { props, context }) => {
+		props.titlePg = parseBooleanElement(child, "w", context);
+	},
+	textDirection: (child, { props }) => {
+		const textDirection = narrowEnum(getAttribute(child, "w", "val"), TextDirectionSchema);
+		if (textDirection) props.textDirection = textDirection;
+		return keptUnless(textDirection !== void 0);
+	},
+	bidi: (child, { props, context }) => {
+		props.bidi = parseBooleanElement(child, "w", context);
+	},
+	rtlGutter: (child, { props, context }) => {
+		props.rtlGutter = parseBooleanElement(child, "w", context);
+	},
+	docGrid: (child, { props }) => {
+		const docGrid = {};
+		const gridType = getAttribute(child, "w", "type");
+		if (gridType === "default" || gridType === "lines" || gridType === "linesAndChars" || gridType === "snapToChars") docGrid.type = gridType;
+		const linePitch = parseNumericAttribute(child, "w", "linePitch");
+		if (linePitch !== void 0) docGrid.linePitch = linePitch;
+		const charSpace = parseNumericAttribute(child, "w", "charSpace");
+		if (charSpace !== void 0) docGrid.charSpace = charSpace;
+		props.docGrid = docGrid;
+	},
+	printerSettings: (child, { props }) => {
+		const relationshipId = getAttribute(child, "r", "id");
+		if (relationshipId) props.printerSettingsRelationshipId = relationshipId;
+		return keptUnless(Boolean(relationshipId));
+	},
+	sectPrChange: (child, { propertyChanges }) => {
+		const previousSectPr = findChild(child, "w", "sectPr");
+		const change = {
+			type: "sectionPropertyChange",
+			info: parsePropertyChangeInfo(child)
+		};
+		if (previousSectPr) change.previousProperties = parseSectionProperties(previousSectPr);
+		const previousReferences = parseSectionReferenceHistory(child);
+		if (previousReferences !== void 0) change.previousReferences = previousReferences;
+		propertyChanges.push(change);
+	}
+};
+const SECTION_PROPERTY_UNDECLARED = {
+	background: (child, { props, context }) => keptUnless(readBackground(props, child, context)),
+	evenAndOddHeaders: (child, { props, context }) => {
+		props.evenAndOddHeaders = parseBooleanElement(child, "w", context);
+	},
+	footnoteColumns: (child, { props }) => {
+		const columns = parseNumericAttribute(child, "w", "val");
+		if (columns !== void 0) props.footnoteColumns = columns;
+		return keptUnless(columns !== void 0);
+	}
+};
 /**
 * Parse section properties (w:sectPr)
 *
@@ -79,168 +238,18 @@ function parseSectionProperties(sectPr, context) {
 	const headerRefs = [];
 	const footerRefs = [];
 	const propertyChanges = [];
-	const preserved = dispatchChildren({
+	const preserved = dispatchChildrenWithContext({
 		element: sectPr,
 		container: "section-properties",
-		handlers: {
-			headerReference: (child) => {
-				const reference = parseHeaderReference(child, context);
-				if (reference) headerRefs.push(reference);
-			},
-			footerReference: (child) => {
-				const reference = parseFooterReference(child, context);
-				if (reference) footerRefs.push(reference);
-			},
-			footnotePr: (child) => {
-				const footnotePr = parseFootnoteProperties(child);
-				if (Object.keys(footnotePr).length > 0) {
-					props.footnotePr = footnotePr;
-					return;
-				}
-				return CAPTURE;
-			},
-			endnotePr: (child) => {
-				const endnotePr = parseEndnoteProperties(child);
-				if (Object.keys(endnotePr).length > 0) {
-					props.endnotePr = endnotePr;
-					return;
-				}
-				return CAPTURE;
-			},
-			type: (child) => {
-				const sectionStart = parseSectionStart(getAttribute(child, "w", "val"));
-				if (sectionStart) props.sectionStart = sectionStart;
-				return keptUnless(sectionStart !== void 0);
-			},
-			pgSz: (child) => {
-				const width = parseNumericAttribute(child, "w", "w");
-				if (width !== void 0) props.pageWidth = Math.min(width, MAX_PAGE_DIMENSION_TWIPS);
-				const height = parseNumericAttribute(child, "w", "h");
-				if (height !== void 0) props.pageHeight = Math.min(height, MAX_PAGE_DIMENSION_TWIPS);
-				const orientation = parseOrientation(getAttribute(child, "w", "orient"));
-				if (orientation) props.orientation = orientation;
-				return keptUnless(width !== void 0 || height !== void 0 || orientation !== void 0);
-			},
-			pgMar: (child) => {
-				const margins = [
-					["top", "marginTop"],
-					["bottom", "marginBottom"],
-					["left", "marginLeft"],
-					["right", "marginRight"],
-					["header", "headerDistance"],
-					["footer", "footerDistance"],
-					["gutter", "gutter"]
-				];
-				let taken = false;
-				for (const [attribute, field] of margins) {
-					const value = parseNumericAttribute(child, "w", attribute);
-					if (value !== void 0) {
-						props[field] = value;
-						taken = true;
-					}
-				}
-				return keptUnless(taken);
-			},
-			paperSrc: (child) => {
-				const first = parseNumericAttribute(child, "w", "first");
-				if (first !== void 0) props.paperSrcFirst = first;
-				const other = parseNumericAttribute(child, "w", "other");
-				if (other !== void 0) props.paperSrcOther = other;
-				return keptUnless(first !== void 0 || other !== void 0);
-			},
-			pgBorders: (child) => keptUnless(readPageBorders(props, child, context)),
-			lnNumType: (child) => {
-				const lineNumbers = {};
-				for (const [attribute, field] of [
-					["start", "start"],
-					["countBy", "countBy"],
-					["distance", "distance"]
-				]) {
-					const value = parseNumericAttribute(child, "w", attribute);
-					if (value !== void 0) lineNumbers[field] = value;
-				}
-				const restart = parseLineNumberRestart(getAttribute(child, "w", "restart"));
-				if (restart) lineNumbers.restart = restart;
-				if (Object.keys(lineNumbers).length === 0) return CAPTURE;
-				props.lineNumbers = lineNumbers;
-			},
-			pgNumType: (child) => {
-				const pageNumbering = {};
-				const format = narrowEnum(getAttribute(child, "w", "fmt"), NumberFormatSchema);
-				if (format) pageNumbering.format = format;
-				const start = parseNumericAttribute(child, "w", "start");
-				if (start !== void 0) pageNumbering.start = start;
-				const chapterStyle = parseNumericAttribute(child, "w", "chapStyle");
-				if (chapterStyle !== void 0) pageNumbering.chapterStyle = chapterStyle;
-				const chapterSeparator = getAttribute(child, "w", "chapSep");
-				if (chapterSeparator) pageNumbering.chapterSeparator = chapterSeparator;
-				if (Object.keys(pageNumbering).length === 0) return CAPTURE;
-				props.pageNumbering = pageNumbering;
-			},
-			cols: (child) => keptUnless(readColumns(props, child)),
-			formProt: (child) => {
-				props.formProtection = parseBooleanElement(child, "w", context);
-			},
-			vAlign: (child) => {
-				const verticalAlign = parseVerticalAlign(getAttribute(child, "w", "val"));
-				if (verticalAlign) props.verticalAlign = verticalAlign;
-				return keptUnless(verticalAlign !== void 0);
-			},
-			noEndnote: (child) => {
-				props.noEndnote = parseBooleanElement(child, "w", context);
-			},
-			titlePg: (child) => {
-				props.titlePg = parseBooleanElement(child, "w", context);
-			},
-			textDirection: (child) => {
-				const textDirection = narrowEnum(getAttribute(child, "w", "val"), TextDirectionSchema);
-				if (textDirection) props.textDirection = textDirection;
-				return keptUnless(textDirection !== void 0);
-			},
-			bidi: (child) => {
-				props.bidi = parseBooleanElement(child, "w", context);
-			},
-			rtlGutter: (child) => {
-				props.rtlGutter = parseBooleanElement(child, "w", context);
-			},
-			docGrid: (child) => {
-				const docGrid = {};
-				const gridType = getAttribute(child, "w", "type");
-				if (gridType === "default" || gridType === "lines" || gridType === "linesAndChars" || gridType === "snapToChars") docGrid.type = gridType;
-				const linePitch = parseNumericAttribute(child, "w", "linePitch");
-				if (linePitch !== void 0) docGrid.linePitch = linePitch;
-				const charSpace = parseNumericAttribute(child, "w", "charSpace");
-				if (charSpace !== void 0) docGrid.charSpace = charSpace;
-				props.docGrid = docGrid;
-			},
-			printerSettings: (child) => {
-				const relationshipId = getAttribute(child, "r", "id");
-				if (relationshipId) props.printerSettingsRelationshipId = relationshipId;
-				return keptUnless(Boolean(relationshipId));
-			},
-			sectPrChange: (child) => {
-				const previousSectPr = findChild(child, "w", "sectPr");
-				const change = {
-					type: "sectionPropertyChange",
-					info: parsePropertyChangeInfo(child)
-				};
-				if (previousSectPr) change.previousProperties = parseSectionProperties(previousSectPr);
-				const previousReferences = parseSectionReferenceHistory(child);
-				if (previousReferences !== void 0) change.previousReferences = previousReferences;
-				propertyChanges.push(change);
-			}
-		},
+		handlers: SECTION_PROPERTY_HANDLERS,
 		capturePosition: sequencePositions("section-properties", sectPr),
-		undeclared: {
-			background: (child) => keptUnless(readBackground(props, child, context)),
-			evenAndOddHeaders: (child) => {
-				props.evenAndOddHeaders = parseBooleanElement(child, "w", context);
-			},
-			footnoteColumns: (child) => {
-				const columns = parseNumericAttribute(child, "w", "val");
-				if (columns !== void 0) props.footnoteColumns = columns;
-				return keptUnless(columns !== void 0);
-			}
+		undeclared: SECTION_PROPERTY_UNDECLARED,
+		context: {
+			props,
+			headerRefs,
+			footerRefs,
+			propertyChanges,
+			context
 		}
 	});
 	if (preserved) props.preserved = preserved;

package/dist/docx/selectiveSaveFlags.d.ts

@@ -2,8 +2,11 @@
 /**
  * Selective Save Feature Flags
  *
- * Operational controls for the selective save path. Default values keep the
- * existing full-repack behavior in place so hosts opt in explicitly.
+ * Operational controls for the selective save path. Selective save is on by
+ * default: every save attempts it first and falls back to a full repack
+ * whenever the patch-safety checks refuse (structural changes, untracked
+ * changes, oversized buffers, or an unmodelled part). Hosts that need the
+ * previous behavior can opt back into full repacking on every save.
  *
  * - `selectiveSave` — gate the selective branch entirely.
  * - `selectiveSaveTripwire` — run selective + full and compare bytes for CI
@@ -13,7 +16,11 @@
  *   the dominant cost.
  */
 type FolioSelectiveSaveFlags = {
-  /** Enable the selective save path. Default: false (full repack only). */
+  /**
+   * Enable the selective save path. Default: true. A save always succeeds:
+   * when the patch-safety checks refuse, the caller falls back to a full
+   * repack automatically. Set to `false` to always full-repack.
+   */
   selectiveSave?: boolean;
   /**
    * Run selective save and full repack on every save, compare bytes, and emit

package/dist/docx/selectiveSaveFlags.js

@@ -2,7 +2,7 @@
 const DEFAULT_SELECTIVE_SAVE_MAX_BYTES = 100 * 1024 * 1024;
 function resolveSelectiveSaveFlags(flags) {
 	return {
-		selectiveSave: flags?.selectiveSave ?? false,
+		selectiveSave: flags?.selectiveSave ?? true,
 		selectiveSaveTripwire: flags?.selectiveSaveTripwire ?? false,
 		selectiveSaveMaxBytes: flags?.selectiveSaveMaxBytes ?? 104857600
 	};

package/dist/docx/selectiveXmlPatch.d.ts

@@ -54,22 +54,48 @@ type ParagraphOffsets = {
  * function would return null.
  */
 declare function buildParagraphOffsetIndex(xml: string): Map<string, ParagraphOffsets>;
-/** One `<w:p>` of a part: its byte range and the paraId its open tag carries. */
+/**
+ * The containers a `<w:p>` sits in, as far as a splice has to care.
+ *
+ * A paragraph is addressed inside one *story*: the main flow of the part (its
+ * body, table cells and block-level content controls included), or the text
+ * of a text box (`w:txbxContent`, DrawingML or VML). The two are separate
+ * ordinal spaces, because the model can legitimately represent a text box
+ * differently from the source (a VML box read as DrawingML, a box it cannot
+ * read at all) without that saying anything about the main flow.
+ *
+ * `mc:Fallback` is a copy of its `mc:Choice` for consumers that cannot read
+ * the Choice. The model reads the Choice and owns nothing in the Fallback, so
+ * a Fallback paragraph is never addressed: it is neither a splice target nor
+ * an ordinal, which is also the rule `ensureParaIds` stamps by.
+ */
+type ParagraphContainer = {
+  /** Inside `mc:Fallback`. */
+  inFallback: boolean;
+  /** Inside `mc:AlternateContent`, whose Fallback repeats this paragraph. */
+  inAlternateContent: boolean;
+  /** How many text-box stories (`w:txbxContent`) enclose the paragraph. */
+  textBoxDepth: number;
+  /** How many table cells (`w:tc`) enclose the paragraph. */
+  tableDepth: number;
+};
+/** One `<w:p>` of a part: its byte range, the paraId its open tag carries, and where it sits. */
 type ScannedParagraph = ParagraphOffsets & {
   paraId: string | undefined;
+  container: ParagraphContainer;
 };
 /**
  * Every `<w:p>` element of `xml`, in the document order of its opening tags,
- * with the `w14:paraId` that tag carries.
+ * with the `w14:paraId` that tag carries and the containers around it.
  *
- * Document order is what makes the array an ordinal space: the *n*th entry of
- * the source part and the *n*th entry of the model's serialization name the
- * same paragraph, which is the only way to address a paragraph the producer
- * gave no id. A `<w:p>` nested inside another (inside `mc:AlternateContent`,
- * a text box) is one entry of its own, exactly as
- * {@link countParagraphElements} counts it, so the two never disagree about
- * what an ordinal is. An unterminated paragraph keeps `end === start`: it
- * occupies its ordinal but no splice can be built from it.
+ * Document order is what makes the array an ordinal space: within one story
+ * (see {@link ParagraphContainer}), the *n*th paragraph of the source part and
+ * the *n*th paragraph of the model's serialization name the same paragraph,
+ * which is the only way to address a paragraph the producer gave no id. A
+ * `<w:p>` nested inside another (inside `mc:AlternateContent`, a text box) is
+ * one entry of its own, exactly as {@link countParagraphElements} counts it.
+ * An unterminated paragraph keeps `end === start`: it occupies its ordinal but
+ * no splice can be built from it.
  */
 declare function scanParagraphs(xml: string): ScannedParagraph[];
 /**
@@ -85,32 +111,26 @@ type PatchValidationResult = {
   safe: boolean;
   reason?: string;
 };
-type PatchSafetyOptions = {
-  /**
-   * Require the original and serialized XML to hold the same number of `<w:p>`
-   * elements. Guards document.xml against structural drift. Notes disable it:
-   * the model only retains the normal notes, so a serialized note part
-   * legitimately has fewer paragraphs than the original (which still carries
-   * the separator notes). See {@link buildPatchedNoteXml}.
-   */
-  checkParagraphCount?: boolean;
-};
 /**
- * Validate that a selective patch can be safely applied.
+ * Validate that a selective patch can be safely applied: every changed
+ * paragraph routes to exactly one region of the original part (see
+ * {@link routeChangedParagraphs} for what is refused and why).
  *
- * Checks:
- * - Every changed paraId routes to one region of the original XML, by its
- *   authored id or, when the producer wrote none, by its paragraph ordinal
- * - All changed paraIds exist in serialized XML (exactly once)
- * - Paragraph count matches between original and serialized (unless disabled)
+ * The rest of the part does not have to match the model's serialization. The
+ * splice keeps every unchanged byte of the source, so a paragraph the model
+ * represents differently elsewhere (a text box it re-reads, a Fallback it
+ * does not own) is simply kept as the source wrote it.
  */
-declare function validatePatchSafety(originalXml: string, serializedXml: string, changedIds: Set<string>, options?: PatchSafetyOptions): PatchValidationResult;
+declare function validatePatchSafety(originalXml: string, serializedXml: string, changedIds: Set<string>): PatchValidationResult;
 /**
  * Build a patched document.xml by splicing new paragraph XML into
  * the original at the correct offsets. Only changed paragraphs
  * are replaced; everything else is preserved byte-for-byte.
  *
- * Returns null if any step fails.
+ * Returns null when a changed paragraph cannot be routed (see
+ * {@link validatePatchSafety}) or {@link spliceXml} refuses the result; the
+ * caller then falls back to a full repack, whose parts are all re-serialized
+ * from one model.
  */
 declare function buildPatchedDocumentXml(originalXml: string, serializedXml: string, changedIds: Set<string>): string | null;
 /**
@@ -118,11 +138,13 @@ declare function buildPatchedDocumentXml(originalXml: string, serializedXml: str
  * splicing edited note paragraphs into the original, preserving unchanged
  * content byte-for-byte.
  *
- * Unlike {@link buildPatchedDocumentXml} this does NOT require the paragraph
- * counts to match: the document model only retains the normal notes, so the
- * serialized note XML omits the separator / continuationSeparator paragraphs
- * the original part still carries. Splicing by `paraId` keeps those separators
- * and every unedited note byte-exact while replacing only the edited ones.
+ * The routing is the document's: the model only retains the normal notes, so
+ * the serialized note XML omits the separator / continuationSeparator
+ * paragraphs the original part still carries, and splicing by `paraId` keeps
+ * those separators and every unedited note byte-exact while replacing only the
+ * edited ones. (An id-less note paragraph does not route here, because the
+ * separators misalign its story's ordinals; {@link buildPatchedNotePartXml}
+ * addresses it by note instead.)
  *
  * Returns null if any changed id is missing or ambiguous in either input, so
  * the caller can fall back to preserving the original part verbatim.
@@ -241,4 +263,4 @@ declare const patchNumberingDefinitions: ({ originalXml, baselineXml, currentXml
  */
 declare function appendNumberingDefs(xml: string, currentXml: string, added: ChangedNumberingDefs): string | null;
 //#endregion
-export { ChangedNumberingDefs, NotePartPatch, NotePartPatchRefusal, ParagraphOffsets, PatchSafetyOptions, PatchValidationResult, ScannedParagraph, XmlSplice, appendNumberingDefs, buildParagraphOffsetIndex, buildPatchedDocumentXml, buildPatchedNotePartXml, buildPatchedNoteXml, buildPatchedNumberingXml, collectAddedNumberingDefs, collectChangedNoteParaIds, collectChangedNumberingDefs, collectParaIds, countParagraphElements, extractParagraphXml, findParagraphOffsets, isXmlNameBoundary, patchNumberingDefinitions, scanParagraphs, spliceXml, validatePatchSafety };
+export { ChangedNumberingDefs, NotePartPatch, NotePartPatchRefusal, ParagraphContainer, ParagraphOffsets, PatchValidationResult, ScannedParagraph, XmlSplice, appendNumberingDefs, buildParagraphOffsetIndex, buildPatchedDocumentXml, buildPatchedNotePartXml, buildPatchedNoteXml, buildPatchedNumberingXml, collectAddedNumberingDefs, collectChangedNoteParaIds, collectChangedNumberingDefs, collectParaIds, countParagraphElements, extractParagraphXml, findParagraphOffsets, isXmlNameBoundary, patchNumberingDefinitions, scanParagraphs, spliceXml, validatePatchSafety };