@stll/folio-core 0.62.0 → 0.63.0

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

@@ -3,15 +3,15 @@ import { XmlElement } from "./xmlParser.js";
 //#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<{
+export declare class InvalidSectionReferenceHistoryError extends InvalidSectionReferenceHistoryError_base<{
   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/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

package/dist/docx/selectiveXmlPatch.d.ts

@@ -8,7 +8,7 @@ import { XmlElement } from "./xmlParser.js";
  * (`<w:p\n  w14:paraId="…">`) is still recognized as the element rather than
  * mistaken for a longer-named sibling.
  */
-declare function isXmlNameBoundary(char: string | undefined): boolean;
+export declare function isXmlNameBoundary(char: string | undefined): boolean;
 /**
  * Find the exact string start and end offsets of a <w:p> element
  * identified by its w14:paraId attribute.
@@ -18,7 +18,7 @@ declare function isXmlNameBoundary(char: string | undefined): boolean;
  *
  * Returns null if paraId not found or appears more than once (ambiguous).
  */
-declare function findParagraphOffsets(xml: string, paraId: string): {
+export declare function findParagraphOffsets(xml: string, paraId: string): {
   start: number;
   end: number;
 } | null;
@@ -26,8 +26,8 @@ declare function findParagraphOffsets(xml: string, paraId: string): {
  * Extract the serialized XML for a specific paragraph by paraId
  * from a fully serialized document.xml string.
  */
-declare function extractParagraphXml(serializedXml: string, paraId: string): string | null;
-type ParagraphOffsets = {
+export declare function extractParagraphXml(serializedXml: string, paraId: string): string | null;
+export type ParagraphOffsets = {
   start: number;
   end: number;
 };
@@ -47,7 +47,7 @@ type ParagraphOffsets = {
  * omitted from the index, so a lookup misses exactly where the per-id
  * function would return null.
  */
-declare function buildParagraphOffsetIndex(xml: string): Map<string, ParagraphOffsets>;
+export declare function buildParagraphOffsetIndex(xml: string): Map<string, ParagraphOffsets>;
 /**
  * The containers a `<w:p>` sits in, as far as a splice has to care.
  *
@@ -63,7 +63,7 @@ declare function buildParagraphOffsetIndex(xml: string): Map<string, ParagraphOf
  * 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 = {
+export type ParagraphContainer = {
   /** Inside `mc:Fallback`. */
   inFallback: boolean;
   /** Inside `mc:AlternateContent`, whose Fallback repeats this paragraph. */
@@ -74,7 +74,7 @@ type ParagraphContainer = {
   tableDepth: number;
 };
 /** One `<w:p>` of a part: its byte range, the paraId its open tag carries, and where it sits. */
-type ScannedParagraph = ParagraphOffsets & {
+export type ScannedParagraph = ParagraphOffsets & {
   paraId: string | undefined;
   container: ParagraphContainer;
 };
@@ -91,17 +91,17 @@ type ScannedParagraph = ParagraphOffsets & {
  * An unterminated paragraph keeps `end === start`: it occupies its ordinal but
  * no splice can be built from it.
  */
-declare function scanParagraphs(xml: string): ScannedParagraph[];
+export declare function scanParagraphs(xml: string): ScannedParagraph[];
 /**
  * Count <w:p> elements in an XML string (top-level paragraph count).
  * Counts opening <w:p tags that are NOT self-closing.
  */
-declare function countParagraphElements(xml: string): number;
+export declare function countParagraphElements(xml: string): number;
 /**
  * Find all paraIds in an XML string and return counts (to detect duplicates).
  */
-declare function collectParaIds(xml: string): Map<string, number>;
-type PatchValidationResult = {
+export declare function collectParaIds(xml: string): Map<string, number>;
+export type PatchValidationResult = {
   safe: boolean;
   reason?: string;
 };
@@ -115,7 +115,7 @@ type PatchValidationResult = {
  * 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>): PatchValidationResult;
+export 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
@@ -126,7 +126,7 @@ declare function validatePatchSafety(originalXml: string, serializedXml: string,
  * 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;
+export declare function buildPatchedDocumentXml(originalXml: string, serializedXml: string, changedIds: Set<string>): string | null;
 /**
  * Build a patched note part (word/footnotes.xml / word/endnotes.xml) by
  * splicing edited note paragraphs into the original, preserving unchanged
@@ -143,9 +143,9 @@ declare function buildPatchedDocumentXml(originalXml: string, serializedXml: str
  * 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.
  */
-declare function buildPatchedNoteXml(originalXml: string, serializedXml: string, changedIds: Set<string>): string | null;
+export declare function buildPatchedNoteXml(originalXml: string, serializedXml: string, changedIds: Set<string>): string | null;
 /** One region of a part replaced by re-serialized XML. */
-type XmlSplice = {
+export type XmlSplice = {
   start: number;
   end: number;
   newXml: string;
@@ -163,7 +163,7 @@ type XmlSplice = {
  * regions are refused too: replacing an inner region moves the outer region's
  * end, so its original offsets cannot be applied to the resulting string.
  */
-declare const spliceXml: (xml: string, splices: readonly XmlSplice[]) => string | null;
+export declare const spliceXml: (xml: string, splices: readonly XmlSplice[]) => string | null;
 /**
  * A paragraph splice cannot change the owning part's root declarations. Refuse
  * fragments that inherit a prefix from the serialized root when the source
@@ -177,9 +177,9 @@ type SpliceNamespaceOptions = {
   originalRoot?: XmlElement;
   serializedRoot?: XmlElement;
 };
-declare const spliceSupportsRootNamespaces: ({ originalXml, serializedXml, fragments, originalRoot, serializedRoot }: SpliceNamespaceOptions) => boolean;
+export declare const spliceSupportsRootNamespaces: ({ originalXml, serializedXml, fragments, originalRoot, serializedRoot }: SpliceNamespaceOptions) => boolean;
 type NoteElementName = "footnote" | "endnote";
-declare const collectChangedNoteParaIds: (baselineXml: string, currentXml: string) => Set<string>;
+export declare const collectChangedNoteParaIds: (baselineXml: string, currentXml: string) => Set<string>;
 type BuildPatchedNotePartXmlOptions = {
   originalXml: string;
   baselineXml: string;
@@ -189,7 +189,7 @@ type BuildPatchedNotePartXmlOptions = {
   changedParaIds?: ReadonlySet<string>;
 };
 /** Why a note part could not be patched; see {@link NotePartPatch}. */
-type NotePartPatchRefusal =
+export type NotePartPatchRefusal =
 /** A note element, or a changed paragraph, was missing or ambiguous. */
 "unroutable-paragraph" |
 /** Even rewriting whole notes would leave a comment range with one half. */
@@ -200,7 +200,7 @@ type NotePartPatchRefusal =
  * the fall back to a full repack the document story takes when its own splice
  * is refused.
  */
-type NotePartPatch = {
+export type NotePartPatch = {
   type: "patched";
   xml: string;
 } | {
@@ -226,8 +226,8 @@ type NotePartPatch = {
  * result and the changed notes are rewritten whole instead — model content on
  * both sides of the range, with every other note still byte-exact.
  */
-declare function buildPatchedNotePartXml({ originalXml, baselineXml, serializedXml, replacementXml, elementName, changedParaIds }: BuildPatchedNotePartXmlOptions): NotePartPatch;
-type ChangedNumberingDefs = {
+export declare function buildPatchedNotePartXml({ originalXml, baselineXml, serializedXml, replacementXml, elementName, changedParaIds }: BuildPatchedNotePartXmlOptions): NotePartPatch;
+export type ChangedNumberingDefs = {
   abstractNums: Set<string>;
   nums: Set<string>;
 };
@@ -238,7 +238,7 @@ type ChangedNumberingDefs = {
  * added or removed relative to the original (which cannot be spliced by id) is
  * left out; both save paths defer those to the byte-exact original part.
  */
-declare function collectChangedNumberingDefs(baselineXml: string, currentXml: string): ChangedNumberingDefs;
+export declare function collectChangedNumberingDefs(baselineXml: string, currentXml: string): ChangedNumberingDefs;
 /**
  * Build a patched `word/numbering.xml` by splicing the changed `w:abstractNum` /
  * `w:num` definitions from `currentXml` (the model's serialization) into
@@ -246,21 +246,21 @@ declare function collectChangedNumberingDefs(baselineXml: string, currentXml: st
  * when nothing changed, or null when a changed id cannot be resolved uniquely
  * in either input (so the caller preserves the original part verbatim).
  */
-declare function buildPatchedNumberingXml(originalXml: string, currentXml: string, changed: ChangedNumberingDefs): string | null;
+export declare function buildPatchedNumberingXml(originalXml: string, currentXml: string, changed: ChangedNumberingDefs): string | null;
 /**
  * Numbering definitions present in `currentXml` (the model's serialization)
  * but absent from `baselineXml` (the re-parsed original): definitions a
  * transform minted. `collectChangedNumberingDefs` deliberately skips these
  * because they cannot be spliced by id; they are appended instead.
  */
-declare function collectAddedNumberingDefs(baselineXml: string, currentXml: string): ChangedNumberingDefs;
+export declare function collectAddedNumberingDefs(baselineXml: string, currentXml: string): ChangedNumberingDefs;
 type PatchNumberingDefinitionsOptions = {
   originalXml: string;
   baselineXml: string;
   currentXml: string;
 };
 /** Both save paths must write changed definitions and newly referenced instances together. */
-declare const patchNumberingDefinitions: ({ originalXml, baselineXml, currentXml }: PatchNumberingDefinitionsOptions) => string | null;
+export declare const patchNumberingDefinitions: ({ originalXml, baselineXml, currentXml }: PatchNumberingDefinitionsOptions) => string | null;
 /**
  * Append added `w:abstractNum` / `w:num` definitions from `currentXml` to
  * `xml`. ECMA-376 §17.9 orders every `w:abstractNum` before the first `w:num`,
@@ -271,6 +271,6 @@ declare const patchNumberingDefinitions: ({ originalXml, baselineXml, currentXml
  * format survives cloning. Returns null when an added id cannot be extracted
  * or the part has no `</w:numbering>`.
  */
-declare function appendNumberingDefs(xml: string, currentXml: string, added: ChangedNumberingDefs): string | null;
+export declare function appendNumberingDefs(xml: string, currentXml: string, added: ChangedNumberingDefs): string | null;
 //#endregion
-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, spliceSupportsRootNamespaces, spliceXml, validatePatchSafety };
+export {};

package/dist/docx/serializer/blockCustomXmlSerializer.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
 //#region src/docx/serializer/blockCustomXmlSerializer.d.ts
-declare const serializeBlockCustomXml: (block: document_d_exports.BlockCustomXml, serializeChild: (child: document_d_exports.BlockContent) => string) => string;
-//#endregion
-export { serializeBlockCustomXml };
+export declare const serializeBlockCustomXml: (block: document_d_exports.BlockCustomXml, serializeChild: (child: document_d_exports.BlockContent) => string) => string;
+//#endregion

package/dist/docx/serializer/blockSdtSerializer.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
 //#region src/docx/serializer/blockSdtSerializer.d.ts
-declare function serializeBlockSdt(blockSdt: document_d_exports.BlockSdt, serializeChild: (block: document_d_exports.BlockContent) => string): string;
-//#endregion
-export { serializeBlockSdt };
+export declare function serializeBlockSdt(blockSdt: document_d_exports.BlockSdt, serializeChild: (block: document_d_exports.BlockContent) => string): string;
+//#endregion

package/dist/docx/serializer/blockSdtSerializer.js

@@ -2,7 +2,8 @@ import { serializeSdtWrapper } from "./sdtPropertiesSerializer.js";
 //#region src/docx/serializer/blockSdtSerializer.ts
 function serializeBlockSdt(blockSdt, serializeChild) {
 	const props = blockSdt.properties;
-	return serializeSdtWrapper(props, blockSdt.content.map(serializeChild).join(""));
+	const contentXml = blockSdt.content.map(serializeChild).join("");
+	return serializeSdtWrapper(props, contentXml);
 }
 //#endregion
 export { serializeBlockSdt };

package/dist/docx/serializer/borderSerializer.d.ts

@@ -21,6 +21,6 @@ type ExhaustiveBorder = document_d_exports.ExhaustiveFields<document_d_exports.B
  * XML attributes; for valid documents these are enum/hex values, so escaping is
  * a no-op.
  */
-declare function serializeBorder(input: ExhaustiveBorder | undefined, elementName: string): string;
+export declare function serializeBorder(input: ExhaustiveBorder | undefined, elementName: string): string;
 //#endregion
-export { serializeBorder };
+export {};

package/dist/docx/serializer/borderSerializer.js

@@ -4,6 +4,14 @@ import { escapeXmlAttribute } from "@stll/docx-core";
 import { borderStyleToken, themeColorToken } from "@stll/docx-core/model";
 //#region src/docx/serializer/borderSerializer.ts
 /**
+* Shared single-border serializer for every `CT_Border` field — table borders
+* (`w:tblBorders`/`w:tcBorders`), paragraph borders (`w:pBdr`), and page borders
+* (`w:pgBorders`). The per-container helpers in the table/paragraph/section
+* serializers all delegate here so a border rule round-trips identically
+* everywhere; previously each carried its own copy and the same bug three times
+* (eigenpal/docx-editor#959).
+*/
+/**
 * Serialize a single border element (`<w:top .../>`, `<w:left .../>`, ...).
 *
 * `nil`/`none` mean "no border", but an *explicit* one overrides an inherited

package/dist/docx/serializer/commentSerializer.d.ts

@@ -2,9 +2,9 @@ import { document_d_exports } from "../../types/document.js";
 import { Comment } from "../../types/content.js";
 //#region src/docx/serializer/commentSerializer.d.ts
 /** An unrelated body edit must retain unmodelled duplicate comment definitions. */
-declare const canReplayCommentsPart: (document: document_d_exports.Document, sourceXml: string) => boolean;
+export declare const canReplayCommentsPart: (document: document_d_exports.Document, sourceXml: string) => boolean;
 /** An owned empty part survives deletion of its final thread. */
-declare const hasOwnedCommentsPart: (document: document_d_exports.Document) => boolean;
+export declare const hasOwnedCommentsPart: (document: document_d_exports.Document) => boolean;
 /**
  * What every comment part is written from: one ordered list of comment ids, and
  * the facts each id carries.
@@ -17,7 +17,7 @@ declare const hasOwnedCommentsPart: (document: document_d_exports.Document) => b
  * Positions cannot disagree if neither part has one: both walk `order` and look
  * every fact up by `w:id`, the only identity the package itself has.
  */
-type CommentPartPlan = {
+export type CommentPartPlan = {
   /** The `w:id`s to write, in order, each exactly once. */
   readonly order: readonly number[];
   readonly byId: ReadonlyMap<number, Comment>;
@@ -40,7 +40,7 @@ type CommentPartPlan = {
  * (comment id and text derived) so repeated saves mint the same id, and it
  * happens here rather than at each call site because both parts must see it.
  */
-declare const planCommentParts: (comments: readonly Comment[]) => CommentPartPlan;
+export declare const planCommentParts: (comments: readonly Comment[]) => CommentPartPlan;
 /**
  * Serialize a comment plan to comments.xml content. Returns a valid empty
  * `<w:comments/>` document for an empty plan so callers can overwrite an
@@ -48,13 +48,12 @@ declare const planCommentParts: (comments: readonly Comment[]) => CommentPartPla
  * comment — leaving the previous file in place would otherwise re-emit
  * the orphaned comment threads on every save.
  */
-declare function serializeComments({ order, byId }: CommentPartPlan, sourceBindings?: ReadonlyMap<string, string>): string;
+export declare function serializeComments({ order, byId }: CommentPartPlan, sourceBindings?: ReadonlyMap<string, string>): string;
 /**
  * Serialize `commentsExtended.xml` (`w15:commentsEx`) for reply threading and
  * resolved state, or `null` when no comment needs an entry (see
  * {@link buildCommentExtendedEntries}). This is the part that makes Word render
  * a comment as a REPLY rather than a separate top-level thread.
  */
-declare function serializeCommentsExtended(plan: CommentPartPlan): string | null;
-//#endregion
-export { CommentPartPlan, canReplayCommentsPart, hasOwnedCommentsPart, planCommentParts, serializeComments, serializeCommentsExtended };
+export declare function serializeCommentsExtended(plan: CommentPartPlan): string | null;
+//#endregion