@stll/folio-core 0.62.0 → 0.63.0

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;
 	}
 }

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

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../../types/document.js";
 //#region src/docx/serializer/numberingSerializer.d.ts
 /** Serialize a complete `word/numbering.xml` part. */
-declare function serializeNumberingXml(numbering: document_d_exports.NumberingDefinitions): string;
-//#endregion
-export { serializeNumberingXml };
+export declare function serializeNumberingXml(numbering: document_d_exports.NumberingDefinitions): string;
+//#endregion

package/dist/docx/serializer/numberingSerializer.js

@@ -6,6 +6,20 @@ import { intAttr } from "./xmlUtils.js";
 import { escapeXmlAttribute, serializeOnOffElement } from "@stll/docx-core";
 import { serializeSequenceChildren } from "@stll/docx-core/schema";
 //#region src/docx/serializer/numberingSerializer.ts
+/**
+* Numbering Serializer - Serialize numbering definitions back to OOXML XML
+*
+* Converts the parsed {@link NumberingDefinitions} model (abstract numberings
+* and concrete numbering instances) back into `word/numbering.xml`.
+*
+* Every container writes its children in the order its content model declares
+* through the same generated sequence that its parser uses for capture
+* positions. Unmodelled markup therefore returns to its schema slot.
+*
+* Save paths still splice definitions rather than overwrite the whole part:
+* they compare this output with a re-serialization of the original model and
+* retain byte-exact source definitions that the editor did not change.
+*/
 /** Serialize one `w:lvl`. */
 function serializeLevel(level) {
 	let numFmtFormat = "";

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

@@ -1,35 +1,34 @@
 import { document_d_exports } from "../../types/document.js";
 //#region src/docx/serializer/paragraphSerializer.d.ts
-declare function serializeParagraphFormatting(formatting: document_d_exports.ParagraphFormatting | undefined, propertyChanges?: document_d_exports.ParagraphPropertyChange[], paragraphMarkChange?: document_d_exports.ParagraphMarkChange): string;
+export declare function serializeParagraphFormatting(formatting: document_d_exports.ParagraphFormatting | undefined, propertyChanges?: document_d_exports.ParagraphPropertyChange[], paragraphMarkChange?: document_d_exports.ParagraphMarkChange): string;
 /**
  * Serialize a paragraph to OOXML XML (w:p)
  *
  * @param paragraph - The paragraph to serialize
  * @returns XML string for the paragraph
  */
-declare function serializeParagraph(paragraph: document_d_exports.Paragraph): string;
+export declare function serializeParagraph(paragraph: document_d_exports.Paragraph): string;
 /**
  * Serialize multiple paragraphs to OOXML XML
  *
  * @param paragraphs - The paragraphs to serialize
  * @returns XML string for all paragraphs
  */
-declare function serializeParagraphs(paragraphs: document_d_exports.Paragraph[]): string;
+export declare function serializeParagraphs(paragraphs: document_d_exports.Paragraph[]): string;
 /**
  * Check if a paragraph has any content
  */
-declare function hasParagraphContent(paragraph: document_d_exports.Paragraph): boolean;
+export declare function hasParagraphContent(paragraph: document_d_exports.Paragraph): boolean;
 /**
  * Check if a paragraph has formatting
  */
-declare function hasParagraphFormatting(paragraph: document_d_exports.Paragraph): boolean;
+export declare function hasParagraphFormatting(paragraph: document_d_exports.Paragraph): boolean;
 /**
  * Create an empty paragraph
  */
-declare function createEmptyParagraph(formatting?: document_d_exports.ParagraphFormatting): document_d_exports.Paragraph;
+export declare function createEmptyParagraph(formatting?: document_d_exports.ParagraphFormatting): document_d_exports.Paragraph;
 /**
  * Create a paragraph with a single text run
  */
-declare function createTextParagraph(text: string, paragraphFormatting?: document_d_exports.ParagraphFormatting, textFormatting?: document_d_exports.TextFormatting): document_d_exports.Paragraph;
-//#endregion
-export { createEmptyParagraph, createTextParagraph, hasParagraphContent, hasParagraphFormatting, serializeParagraph, serializeParagraphFormatting, serializeParagraphs };
+export declare function createTextParagraph(text: string, paragraphFormatting?: document_d_exports.ParagraphFormatting, textFormatting?: document_d_exports.TextFormatting): document_d_exports.Paragraph;
+//#endregion

package/dist/docx/serializer/paragraphSerializer.js

@@ -10,7 +10,7 @@ import { toTransitionalNamespaceUri } from "../transitionalSpelling.js";
 import { captureVerbatimXml, createCapturedXmlSanitizer } from "../verbatimCapture.js";
 import { NAMESPACES, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, cloneElement, getChildElements, getLocalName, parseXml } from "../xmlParser.js";
 import { writeGroupTextBoxesBack } from "./groupTextBoxWriteBack.js";
-import { markupRangeAttributes, moveBookmarkAttributes, serializeBookmarkMarker } from "./markupRangeAttributes.js";
+import { markupRangeAttributes, serializeBookmarkMarker, serializeMoveRangeMarker } from "./markupRangeAttributes.js";
 import { serializeRun, serializeShapeTextBody } from "./runSerializer.js";
 import { serializeSdtWrapper } from "./sdtPropertiesSerializer.js";
 import { serializeSectionProperties } from "./sectionPropertiesSerializer.js";
@@ -18,7 +18,7 @@ import { serializeTextFormatting } from "./textFormattingSerializer.js";
 import { serializeTrackedChangeAttributes, trackedChangeAttributeRecord } from "./trackedChangeAttributes.js";
 import { TaggedError, panic } from "better-result";
 import { escapeXmlAttribute, escapeXmlText } from "@stll/docx-core";
-import { PARAGRAPH_MARK_CHANGE_KINDS } from "@stll/docx-core/model";
+import { PARAGRAPH_MARK_CHANGE_KINDS, finalizeParagraphFormatting as finalizeParagraphFormatting$1 } from "@stll/docx-core/model";
 import { SEQUENCE_CHILDREN } from "@stll/docx-core/schema";
 //#region src/docx/serializer/paragraphSerializer.ts
 /**
@@ -305,6 +305,13 @@ function serializeHyperlinkChild(child, disposition) {
 		case "run": return serializeInlineRun(child, disposition);
 		case "bookmarkStart": return serializeBookmarkMarker(child);
 		case "bookmarkEnd": return serializeBookmarkMarker(child);
+		case "commentRangeStart":
+		case "commentRangeEnd": return serializeParagraphContent(child, disposition);
+		case "commentReference": return serializeCommentReferenceRun(child.id);
+		case "moveFromRangeStart":
+		case "moveFromRangeEnd":
+		case "moveToRangeStart":
+		case "moveToRangeEnd": return serializeMoveRangeMarker(child);
 		case "inlineWrapper": return serializeParagraphContent(child, disposition);
 		case "preservedInline": return child.xml;
 		default: return child;
@@ -433,7 +440,7 @@ const trackedSimpleFieldContent = (field) => {
 */
 function serializeInlineSdt(sdt, disposition = "kept") {
 	const props = sdt.properties;
-	return serializeSdtWrapper(props, sdt.content.map((item) => {
+	const contentXml = sdt.content.map((item) => {
 		switch (item.type) {
 			case "run": return serializeInlineRun(item, disposition);
 			case "hyperlink": return serializeHyperlink(item, disposition);
@@ -443,10 +450,13 @@ function serializeInlineSdt(sdt, disposition = "kept") {
 			case "inlineWrapper": return serializeParagraphContent(item, disposition);
 			case "bookmarkStart": return serializeBookmarkMarker(item);
 			case "bookmarkEnd": return serializeBookmarkMarker(item);
-			case "moveFromRangeStart": return serializeMoveRangeStart("moveFromRangeStart", item);
-			case "moveFromRangeEnd": return `<w:moveFromRangeEnd ${markupRangeAttributes(item).join(" ")}/>`;
-			case "moveToRangeStart": return serializeMoveRangeStart("moveToRangeStart", item);
-			case "moveToRangeEnd": return `<w:moveToRangeEnd ${markupRangeAttributes(item).join(" ")}/>`;
+			case "commentRangeStart":
+			case "commentRangeEnd": return serializeParagraphContent(item, disposition);
+			case "commentReference": return serializeCommentReferenceRun(item.id);
+			case "moveFromRangeStart":
+			case "moveFromRangeEnd":
+			case "moveToRangeStart":
+			case "moveToRangeEnd": return serializeMoveRangeMarker(item);
 			case "insertion": return serializeTrackedChange("ins", item);
 			case "deletion": return serializeTrackedChange("del", item);
 			case "moveFrom": return serializeTrackedChange("moveFrom", item);
@@ -455,10 +465,8 @@ function serializeInlineSdt(sdt, disposition = "kept") {
 			case "preservedInline": return item.xml;
 			default: return item;
 		}
-	}).join(""));
-}
-function serializeMoveRangeStart(tag, marker) {
-	return `<w:${tag} ${moveBookmarkAttributes(marker).join(" ")}/>`;
+	}).join("");
+	return serializeSdtWrapper(props, contentXml);
 }
 /**
 * Serialize a tracked change wrapper (ins/del/moveFrom/moveTo)
@@ -699,10 +707,10 @@ function serializeParagraphContent(content, disposition = "kept") {
 		case "deletion": return serializeTrackedChange("del", content);
 		case "moveFrom": return serializeTrackedChange("moveFrom", content);
 		case "moveTo": return serializeTrackedChange("moveTo", content);
-		case "moveFromRangeStart": return serializeMoveRangeStart("moveFromRangeStart", content);
-		case "moveFromRangeEnd": return `<w:moveFromRangeEnd ${markupRangeAttributes(content).join(" ")}/>`;
-		case "moveToRangeStart": return serializeMoveRangeStart("moveToRangeStart", content);
-		case "moveToRangeEnd": return `<w:moveToRangeEnd ${markupRangeAttributes(content).join(" ")}/>`;
+		case "moveFromRangeStart":
+		case "moveFromRangeEnd":
+		case "moveToRangeStart":
+		case "moveToRangeEnd": return serializeMoveRangeMarker(content);
 		case "inlineWrapper": return serializeInlineWrapperMarkup(content, content.content.map((child) => serializeParagraphContent(child, disposition)).join(""));
 		case "mathEquation": return content.ommlXml || "";
 		case "preservedInline": return content.xml;
@@ -796,9 +804,10 @@ function hasParagraphFormatting(paragraph) {
 * Create an empty paragraph
 */
 function createEmptyParagraph(formatting) {
+	const finalizedFormatting = finalizeParagraphFormatting$1(formatting);
 	return {
 		type: "paragraph",
-		...formatting !== void 0 ? { formatting } : {},
+		...finalizedFormatting !== void 0 ? { formatting: finalizedFormatting } : {},
 		content: []
 	};
 }
@@ -806,9 +815,10 @@ function createEmptyParagraph(formatting) {
 * Create a paragraph with a single text run
 */
 function createTextParagraph(text, paragraphFormatting, textFormatting) {
+	const finalizedFormatting = finalizeParagraphFormatting$1(paragraphFormatting);
 	return {
 		type: "paragraph",
-		...paragraphFormatting !== void 0 ? { formatting: paragraphFormatting } : {},
+		...finalizedFormatting !== void 0 ? { formatting: finalizedFormatting } : {},
 		content: [{
 			type: "run",
 			...textFormatting !== void 0 ? { formatting: textFormatting } : {},

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

@@ -11,7 +11,7 @@ import { OoxmlPrefix } from "@stll/docx-utils";
  * that wrapper, so they stay out of the attribute, as mainstream producers
  * leave them.
  */
-type OoxmlNamespace = {
+export type OoxmlNamespace = {
   readonly uri: string;
   readonly ignorable: boolean;
 };
@@ -25,17 +25,17 @@ type PackagingPrefix = "ct" | "pr";
  * over the union: a member with no entry, or an entry with no member, does not
  * compile.
  */
-type OoxmlNamespacePrefix = Exclude<OoxmlPrefix, PackagingPrefix> | "cx" | "cx1" | "cx2" | "cx3" | "cx4" | "cx5" | "cx6" | "cx7" | "cx8" | "aink" | "am3d" | "oel" | "w10" | "w16" | "w16cex" | "w16cid" | "w16du" | "w16sdtdh" | "w16se" | "folio" | "wpi" | "wne";
+export type OoxmlNamespacePrefix = Exclude<OoxmlPrefix, PackagingPrefix> | "cx" | "cx1" | "cx2" | "cx3" | "cx4" | "cx5" | "cx6" | "cx7" | "cx8" | "aink" | "am3d" | "oel" | "w10" | "w16" | "w16cex" | "w16cid" | "w16du" | "w16sdtdh" | "w16se" | "folio" | "wpi" | "wne";
 /**
  * Every namespace a rebuilt part can declare, in the order producers write them.
  *
  * URIs shared with the parser are taken from its table rather than retyped, so
  * the two cannot drift.
  */
-declare const OOXML_NAMESPACES: Readonly<Record<OoxmlNamespacePrefix, OoxmlNamespace>>;
+export declare const OOXML_NAMESPACES: Readonly<Record<OoxmlNamespacePrefix, OoxmlNamespace>>;
 declare const UnboundNamespacePrefixError_base: import("better-result").TaggedErrorClass<"UnboundNamespacePrefixError">;
 /** A rebuilt part uses a prefix that resolves to no namespace URI. */
-declare class UnboundNamespacePrefixError extends UnboundNamespacePrefixError_base<{
+export declare class UnboundNamespacePrefixError extends UnboundNamespacePrefixError_base<{
   message: string;
   partPath: string;
   prefixes: readonly string[];
@@ -46,13 +46,13 @@ declare class UnboundNamespacePrefixError extends UnboundNamespacePrefixError_ba
  * Reused when the part is rebuilt so a producer-specific prefix that
  * {@link OOXML_NAMESPACES} does not know keeps the URI the document gave it.
  */
-declare const readRootNamespaceBindings: (partXml: string) => ReadonlyMap<string, string>;
+export declare const readRootNamespaceBindings: (partXml: string) => ReadonlyMap<string, string>;
 /** The part a rebuild replaces: where it lives, and what its root element bound. */
-type SourcePart = {
+export type SourcePart = {
   path: string;
   bindings: ReadonlyMap<string, string>;
 };
-type PartElementOptions = {
+export type PartElementOptions = {
   /** Package-relative path of the part, reported when a prefix is unbound. */
   partPath: string;
   /** Qualified name of the root element, for example `w:document`. */
@@ -73,6 +73,6 @@ type PartElementOptions = {
  * Wrap an assembled part body in a root element that declares every prefix the
  * part uses and lists the ignorable ones in `mc:Ignorable`.
  */
-declare const serializePartElement: ({ partPath, rootName, rootAttributes, baselinePrefixes, sourceBindings, body }: PartElementOptions) => string;
+export declare const serializePartElement: ({ partPath, rootName, rootAttributes, baselinePrefixes, sourceBindings, body }: PartElementOptions) => string;
 //#endregion
-export { OOXML_NAMESPACES, OoxmlNamespace, OoxmlNamespacePrefix, PartElementOptions, SourcePart, UnboundNamespacePrefixError, readRootNamespaceBindings, serializePartElement };
+export {};