@stll/folio-core 0.61.0 → 0.63.0

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

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

@@ -7,7 +7,7 @@ import { SaveDiagnosticOptions } from "../saveDiagnostics.js";
  * @param body - The document body to serialize
  * @returns XML string for the body element (without body tags)
  */
-declare function serializeDocumentBody(body: document_d_exports.DocumentBody): string;
+export declare function serializeDocumentBody(body: document_d_exports.DocumentBody): string;
 /**
  * Serialize a complete Document to valid document.xml
  *
@@ -16,11 +16,11 @@ declare function serializeDocumentBody(body: document_d_exports.DocumentBody): s
  *   prefix only the source document bound keeps its URI
  * @returns Complete XML string for document.xml
  */
-type DocumentBodyAuthorityOptions = {
+export type DocumentBodyAuthorityOptions = {
   /** Canonical saves preserve trusted source blocks; default saves serialize the model. */
   bodyAuthority?: "canonical" | "model" | undefined;
 };
-declare function serializeDocument(doc: document_d_exports.Document, sourceBindings?: ReadonlyMap<string, string>, source?: SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
+export declare function serializeDocument(doc: document_d_exports.Document, sourceBindings?: ReadonlyMap<string, string>, source?: SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
   xml?: string | undefined;
 }): string;
 /**
@@ -29,41 +29,40 @@ declare function serializeDocument(doc: document_d_exports.Document, sourceBindi
  * @param body - The document body to serialize
  * @returns XML string for the w:body element
  */
-declare function serializeDocumentBodyElement(body: document_d_exports.DocumentBody): string;
+export declare function serializeDocumentBodyElement(body: document_d_exports.DocumentBody): string;
 /**
  * Check if document has any content
  */
-declare function hasDocumentContent(doc: document_d_exports.Document): boolean;
+export declare function hasDocumentContent(doc: document_d_exports.Document): boolean;
 /**
  * Check if document has sections
  */
-declare function hasDocumentSections(doc: document_d_exports.Document): boolean;
+export declare function hasDocumentSections(doc: document_d_exports.Document): boolean;
 /**
  * Check if document has section properties
  */
-declare function hasSectionProperties(doc: document_d_exports.Document): boolean;
+export declare function hasSectionProperties(doc: document_d_exports.Document): boolean;
 /**
  * Get document content count (paragraphs + tables)
  */
-declare function getDocumentContentCount(doc: document_d_exports.Document): number;
+export declare function getDocumentContentCount(doc: document_d_exports.Document): number;
 /**
  * Get paragraph count in document
  */
-declare function getDocumentParagraphCount(doc: document_d_exports.Document): number;
+export declare function getDocumentParagraphCount(doc: document_d_exports.Document): number;
 /**
  * Get table count in document
  */
-declare function getDocumentTableCount(doc: document_d_exports.Document): number;
+export declare function getDocumentTableCount(doc: document_d_exports.Document): number;
 /**
  * Create an empty document
  */
-declare function createEmptyDocument(): document_d_exports.Document;
+export declare function createEmptyDocument(): document_d_exports.Document;
 /**
  * Create a simple document with text content
  */
-declare function createSimpleDocument(paragraphs: {
+export declare function createSimpleDocument(paragraphs: {
   text: string;
   styleId?: string;
 }[]): document_d_exports.Document;
-//#endregion
-export { DocumentBodyAuthorityOptions, createEmptyDocument, createSimpleDocument, getDocumentContentCount, getDocumentParagraphCount, getDocumentTableCount, hasDocumentContent, hasDocumentSections, hasSectionProperties, serializeDocument, serializeDocumentBody, serializeDocumentBodyElement };
+//#endregion

package/dist/docx/serializer/documentSerializer.js

@@ -2,7 +2,7 @@ import { getDocumentSourceBaseline } from "../headerFooterVerbatim.js";
 import { buildDocumentBlockReplay, canReplayDocumentSource } from "../storyBlockReplay.js";
 import { serializeBlockCustomXml } from "./blockCustomXmlSerializer.js";
 import { serializeBlockSdt } from "./blockSdtSerializer.js";
-import { serializeBookmarkMarker } from "./markupRangeAttributes.js";
+import { serializeBookmarkMarker, serializeMoveRangeMarker } from "./markupRangeAttributes.js";
 import { serializeParagraph } from "./paragraphSerializer.js";
 import { serializePartElement } from "./partNamespaces.js";
 import { resetAutoIdCounter } from "./runSerializer.js";
@@ -12,6 +12,18 @@ import { escapeXmlAttribute } from "@stll/docx-core";
 import { themeColorToken } from "@stll/docx-core/model";
 //#region src/docx/serializer/documentSerializer.ts
 /**
+* Document Serializer - Serialize complete document.xml
+*
+* Converts Document objects back to valid document.xml OOXML format.
+* Combines all content (paragraphs, tables) with section properties
+* and proper namespace declarations.
+*
+* OOXML Reference:
+* - Document root: w:document
+* - Document body: w:body
+* - Section properties: w:sectPr
+*/
+/**
 * Prefixes document.xml declares whether or not the body uses them.
 *
 * A canonical `<w:sdtPr>` legitimately carries `<w16sdtdh:dataHash>` /
@@ -52,6 +64,10 @@ function serializeBlockContent(block) {
 		case "preservedBlock": return block.xml;
 		case "bookmarkStart":
 		case "bookmarkEnd": return serializeBookmarkMarker(block);
+		case "moveFromRangeStart":
+		case "moveFromRangeEnd":
+		case "moveToRangeStart":
+		case "moveToRangeEnd": return serializeMoveRangeMarker(block);
 		default: return block;
 	}
 }

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
 //#region src/docx/serializer/fontTableSerializer.d.ts
-declare const serializeFontTableXml: (fontTable: document_d_exports.FontTable) => string;
-//#endregion
-export { serializeFontTableXml };
+export declare const serializeFontTableXml: (fontTable: document_d_exports.FontTable) => string;
+//#endregion

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

@@ -7,6 +7,6 @@ type SerializeTextBody = (blocks: document_d_exports.ShapeTextBody["content"]) =
  *
  * Returns the paragraph's own content when it holds no lifted text box.
  */
-declare const writeGroupTextBoxesBack: (paragraph: document_d_exports.Paragraph, serializeTextBody: SerializeTextBody) => readonly document_d_exports.ParagraphContent[];
+export declare const writeGroupTextBoxesBack: (paragraph: document_d_exports.Paragraph, serializeTextBody: SerializeTextBody) => readonly document_d_exports.ParagraphContent[];
 //#endregion
-export { writeGroupTextBoxesBack };
+export {};

package/dist/docx/serializer/groupTextBoxWriteBack.js

@@ -13,10 +13,7 @@ const forEachRun = (content, onRun) => {
 		case "insertion":
 		case "deletion":
 		case "moveFrom":
-		case "moveTo":
-			forEachRun(item.content, onRun);
-			break;
-		default: break;
+		case "moveTo": forEachRun(item.content, onRun);
 	}
 };
 /** The same walk, rebuilding each container whose runs changed. */

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

@@ -13,6 +13,6 @@ import { SourcePart } from "./partNamespaces.js";
 type HeaderFooterSerializeOptions = SourcePart & SaveDiagnosticOptions & {
   originalBuffer?: ArrayBuffer | undefined;
 };
-declare function serializeHeaderFooter(hf: document_d_exports.HeaderFooter, source?: HeaderFooterSerializeOptions): string;
+export declare function serializeHeaderFooter(hf: document_d_exports.HeaderFooter, source?: HeaderFooterSerializeOptions): string;
 //#endregion
-export { serializeHeaderFooter };
+export {};

package/dist/docx/serializer/headerFooterSerializer.js

@@ -5,7 +5,7 @@ import { captureVerbatimXml } from "../verbatimCapture.js";
 import { getLocalName, parseXmlDocument } from "../xmlParser.js";
 import { serializeBlockCustomXml } from "./blockCustomXmlSerializer.js";
 import { serializeBlockSdt } from "./blockSdtSerializer.js";
-import { serializeBookmarkMarker } from "./markupRangeAttributes.js";
+import { serializeBookmarkMarker, serializeMoveRangeMarker } from "./markupRangeAttributes.js";
 import { serializeParagraph } from "./paragraphSerializer.js";
 import { serializePartElement } from "./partNamespaces.js";
 import { serializeTable } from "./tableSerializer.js";
@@ -47,6 +47,10 @@ function serializeBlock(block) {
 		case "preservedBlock": return block.xml;
 		case "bookmarkStart":
 		case "bookmarkEnd": return serializeBookmarkMarker(block);
+		case "moveFromRangeStart":
+		case "moveFromRangeEnd":
+		case "moveToRangeStart":
+		case "moveToRangeEnd": return serializeMoveRangeMarker(block);
 		default: return block;
 	}
 }

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

@@ -1,7 +1,8 @@
 import { document_d_exports } from "../../types/document.js";
+import { CopyOriginAncestorList } from "@stll/docx-core/ops";
 //#region src/docx/serializer/markupRangeAttributes.d.ts
-declare const markupRangeAttributes: (marker: document_d_exports.MarkupRangeMarker) => string[];
-declare const bookmarkRangeAttributes: (marker: document_d_exports.BookmarkRangeMarker) => string[];
+export declare const markupRangeAttributes: (marker: document_d_exports.MarkupRangeMarker, copyOriginAncestors?: CopyOriginAncestorList) => string[];
+export declare const bookmarkRangeAttributes: (marker: document_d_exports.BookmarkRangeMarker, copyOriginAncestors?: CopyOriginAncestorList) => string[];
 /**
  * One bookmark marker, wherever it stands.
  *
@@ -9,8 +10,12 @@ declare const bookmarkRangeAttributes: (marker: document_d_exports.BookmarkRange
  * child of `w:tbl`, so the four serializers share one writer: an attribute
  * added to `CT_Bookmark` reaches every level at once.
  */
-declare const serializeBookmarkMarker: (marker: document_d_exports.BookmarkStart | document_d_exports.BookmarkEnd) => string;
+export declare const serializeBookmarkMarker: (marker: document_d_exports.BookmarkStart | document_d_exports.BookmarkEnd) => string;
 /** `w:author` is required, so it is always written; `w:date` only when known. */
-declare const moveBookmarkAttributes: (marker: document_d_exports.MoveBookmarkMarker) => string[];
-//#endregion
-export { bookmarkRangeAttributes, markupRangeAttributes, moveBookmarkAttributes, serializeBookmarkMarker };
+export declare const moveBookmarkAttributes: (marker: document_d_exports.MoveFromRangeStart | document_d_exports.MoveToRangeStart) => string[];
+/**
+ * One move range marker, wherever it stands: a paragraph child or a block, so
+ * the serializers share one writer as they do for bookmarks.
+ */
+export declare const serializeMoveRangeMarker: (marker: document_d_exports.MoveFromRangeStart | document_d_exports.MoveFromRangeEnd | document_d_exports.MoveToRangeStart | document_d_exports.MoveToRangeEnd) => string;
+//#endregion

package/dist/docx/serializer/markupRangeAttributes.js

@@ -1,13 +1,27 @@
+import { serializeCopyOriginAncestors } from "../reviewResolutionProvenance.js";
 import { escapeXmlAttribute } from "@stll/docx-core";
 //#region src/docx/serializer/markupRangeAttributes.ts
+/**
+* Write the attributes of a range marker in schema order.
+*
+* The counterpart of `../markupRangeMarker.ts`: one writer per schema type, so
+* an attribute the model carries cannot be dropped by whichever marker forgot
+* to mention it. Attribute order follows the declaration order of
+* `CT_MarkupRange` → `CT_Bookmark` → `CT_MoveBookmark`.
+*/
 const attribute = (name, value) => `${name}="${escapeXmlAttribute(String(value))}"`;
-const markupRangeAttributes = (marker) => {
+const markupRangeAttributes = (marker, copyOriginAncestors) => {
 	const attributes = [attribute("w:id", marker.id)];
 	if (marker.displacedByCustomXml !== void 0) attributes.push(attribute("w:displacedByCustomXml", marker.displacedByCustomXml));
+	attributes.push(...copyOriginAttributes(copyOriginAncestors));
 	return attributes;
 };
-const bookmarkRangeAttributes = (marker) => {
-	const attributes = markupRangeAttributes(marker);
+const copyOriginAttributes = (value) => {
+	const encoded = serializeCopyOriginAncestors(value);
+	return encoded === void 0 ? [] : [attribute("folio:copyOriginAncestors", encoded)];
+};
+const bookmarkRangeAttributes = (marker, copyOriginAncestors) => {
+	const attributes = markupRangeAttributes(marker, copyOriginAncestors);
 	if (marker.colFirst !== void 0) attributes.push(attribute("w:colFirst", marker.colFirst));
 	if (marker.colLast !== void 0) attributes.push(attribute("w:colLast", marker.colLast));
 	attributes.push(attribute("w:name", marker.name));
@@ -20,13 +34,26 @@ const bookmarkRangeAttributes = (marker) => {
 * child of `w:tbl`, so the four serializers share one writer: an attribute
 * added to `CT_Bookmark` reaches every level at once.
 */
-const serializeBookmarkMarker = (marker) => marker.type === "bookmarkStart" ? `<w:bookmarkStart ${bookmarkRangeAttributes(marker).join(" ")}/>` : `<w:bookmarkEnd ${markupRangeAttributes(marker).join(" ")}/>`;
+const serializeBookmarkMarker = (marker) => marker.type === "bookmarkStart" ? `<w:bookmarkStart ${bookmarkRangeAttributes(marker, marker.copyOriginAncestors).join(" ")}/>` : `<w:bookmarkEnd ${markupRangeAttributes(marker, marker.copyOriginAncestors).join(" ")}/>`;
 /** `w:author` is required, so it is always written; `w:date` only when known. */
 const moveBookmarkAttributes = (marker) => {
-	const attributes = bookmarkRangeAttributes(marker);
+	const attributes = bookmarkRangeAttributes(marker, marker.copyOriginAncestors);
 	attributes.push(attribute("w:author", marker.author.trim() || "Unknown"));
 	if (marker.date !== void 0 && marker.date.trim().length > 0) attributes.push(attribute("w:date", marker.date.trim()));
 	return attributes;
 };
+/**
+* One move range marker, wherever it stands: a paragraph child or a block, so
+* the serializers share one writer as they do for bookmarks.
+*/
+const serializeMoveRangeMarker = (marker) => {
+	switch (marker.type) {
+		case "moveFromRangeStart":
+		case "moveToRangeStart": return `<w:${marker.type} ${moveBookmarkAttributes(marker).join(" ")}/>`;
+		case "moveFromRangeEnd":
+		case "moveToRangeEnd": return `<w:${marker.type} ${markupRangeAttributes(marker, marker.copyOriginAncestors).join(" ")}/>`;
+		default: return marker;
+	}
+};
 //#endregion
-export { bookmarkRangeAttributes, markupRangeAttributes, moveBookmarkAttributes, serializeBookmarkMarker };
+export { bookmarkRangeAttributes, markupRangeAttributes, moveBookmarkAttributes, serializeBookmarkMarker, serializeMoveRangeMarker };

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

@@ -6,19 +6,18 @@ import { document_d_exports } from "../../types/document.js";
  * @param footnotes - Notes to serialize (the model's normal footnotes).
  * @returns Complete footnotes.xml string.
  */
-declare function serializeFootnotes(footnotes: readonly document_d_exports.Footnote[]): string;
+export declare function serializeFootnotes(footnotes: readonly document_d_exports.Footnote[]): string;
 /**
  * Serialize endnotes to a complete word/endnotes.xml string.
  *
  * @param endnotes - Notes to serialize (the model's normal endnotes).
  * @returns Complete endnotes.xml string.
  */
-declare function serializeEndnotes(endnotes: readonly document_d_exports.Endnote[]): string;
+export declare function serializeEndnotes(endnotes: readonly document_d_exports.Endnote[]): string;
 /** Serialize a brand-new footnote part, including Word's required separators
  * and the automatic reference mark at the start of every normal note. */
-declare function serializeNewFootnotesPart(footnotes: readonly document_d_exports.Footnote[], document?: document_d_exports.Document): string;
+export declare function serializeNewFootnotesPart(footnotes: readonly document_d_exports.Footnote[], document?: document_d_exports.Document): string;
 /** Serialize a brand-new endnote part, including Word's required separators
  * and the automatic reference mark at the start of every normal note. */
-declare function serializeNewEndnotesPart(endnotes: readonly document_d_exports.Endnote[], document?: document_d_exports.Document): string;
-//#endregion
-export { serializeEndnotes, serializeFootnotes, serializeNewEndnotesPart, serializeNewFootnotesPart };
+export declare function serializeNewEndnotesPart(endnotes: readonly document_d_exports.Endnote[], document?: document_d_exports.Document): string;
+//#endregion

package/dist/docx/serializer/noteSerializer.js

@@ -1,12 +1,33 @@
 import { hasNoteReferenceMark } from "../noteReferenceMark.js";
 import { serializeBlockCustomXml } from "./blockCustomXmlSerializer.js";
 import { serializeBlockSdt } from "./blockSdtSerializer.js";
-import { serializeBookmarkMarker } from "./markupRangeAttributes.js";
+import { serializeBookmarkMarker, serializeMoveRangeMarker } from "./markupRangeAttributes.js";
 import { serializeParagraph } from "./paragraphSerializer.js";
 import { serializePartElement } from "./partNamespaces.js";
 import { serializeTable } from "./tableSerializer.js";
 import { noteUsesCustomMark } from "@stll/docx-core/ops";
 //#region src/docx/serializer/noteSerializer.ts
+/**
+* Footnote/Endnote Serializer - Serialize footnotes/endnotes back to OOXML XML
+*
+* Converts the parsed Footnote[] / Endnote[] model back into valid
+* word/footnotes.xml / word/endnotes.xml. Reuses the same paragraph, table,
+* and block-SDT serializers the document body and header/footer serializers
+* use, so note bodies round-trip the full block model (runs, tracked changes,
+* fields, content controls) instead of a flattened subset.
+*
+* OOXML Reference:
+* - Footnotes root: w:footnotes; each note: w:footnote[@w:id][@w:type]
+* - Endnotes root:  w:endnotes;  each note: w:endnote[@w:id][@w:type]
+*
+* The document model only retains the normal (content) notes: the separator /
+* continuationSeparator notes Word requires are dropped during parsing
+* (`getNormalFootnotes`). Callers therefore must NOT overwrite the whole part
+* with this output — it would lose those separators. The selective save path
+* uses this serializer only to extract the edited note paragraph by `paraId`
+* and splices it into the original part, keeping separators and unedited notes
+* byte-exact.
+*/
 const NOTE_BASELINE_PREFIXES = [
 	"wpc",
 	"mc",
@@ -50,6 +71,10 @@ function serializeBlock(block) {
 		case "preservedBlock": return block.xml;
 		case "bookmarkStart":
 		case "bookmarkEnd": return serializeBookmarkMarker(block);
+		case "moveFromRangeStart":
+		case "moveFromRangeEnd":
+		case "moveToRangeStart":
+		case "moveToRangeEnd": return serializeMoveRangeMarker(block);
 		default: return block;
 	}
 }