@stll/folio-core 0.62.0 → 0.63.1

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;
@@ -347,7 +354,8 @@ function serializeComplexField(field) {
 	parts.push(`<w:r>${rPrXml}<w:fldChar w:fldCharType="end"/></w:r>`);
 	return parts.join("");
 }
-var UnrepresentableTrackedCaptureError = class extends TaggedError("UnrepresentableTrackedCaptureError") {};
+const UnrepresentableTrackedCaptureErrorBase = TaggedError("UnrepresentableTrackedCaptureError");
+var UnrepresentableTrackedCaptureError = class extends UnrepresentableTrackedCaptureErrorBase {};
 /**
 * Preserved markup inside a removal. Markup captured from a removal already
 * spells its text as deleted text. Markup captured outside one and put under
@@ -361,7 +369,8 @@ function serializeRemovedPreservedInline(item) {
 	if (item.foldedListNumber) throw new UnrepresentableTrackedCaptureError({ message: "A folded list-number field holds markup that cannot be written as deleted content." });
 	return item.xml;
 }
-var UnrepresentableTrackedFieldChildError = class extends TaggedError("UnrepresentableTrackedFieldChildError") {};
+const UnrepresentableTrackedFieldChildErrorBase = TaggedError("UnrepresentableTrackedFieldChildError");
+var UnrepresentableTrackedFieldChildError = class extends UnrepresentableTrackedFieldChildErrorBase {};
 const TRACKED_FIELD_CAPTURE_NAMES = new Set(TRACKED_RUN_WORDPROCESSING_CHILDREN);
 const replayableFieldDataXml = createCapturedXmlSanitizer({
 	allowedLocalNames: /* @__PURE__ */ new Set(["fldData"]),
@@ -433,7 +442,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 +452,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 +467,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)
@@ -547,7 +557,8 @@ const trackedChangeSegments = ({ tag, change }) => {
 	const attrs = serializeTrackedChangeAttributes(change.info) + serializeResolutionJoins(change.resolutionJoins);
 	return wrapTrackedInlineSegments(segments, (xml) => `<w:${tag} ${attrs}>${xml}</w:${tag}>`);
 };
-var UnrepresentableNestedHyperlinkError = class extends TaggedError("UnrepresentableNestedHyperlinkError") {};
+const UnrepresentableNestedHyperlinkErrorBase = TaggedError("UnrepresentableNestedHyperlinkError");
+var UnrepresentableNestedHyperlinkError = class extends UnrepresentableNestedHyperlinkErrorBase {};
 /** One exhaustive recursive owner for all containers inside a tracked revision. */
 const walkTrackedInlineContent = (content, disposition) => {
 	const segments = [];
@@ -699,10 +710,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 +807,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 +818,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

@@ -1,5 +1,7 @@
+import { TaggedErrorClass } from "better-result";
 import { OoxmlPrefix } from "@stll/docx-utils";
 //#region src/docx/serializer/partNamespaces.d.ts
+declare const UnboundNamespacePrefixErrorBase: TaggedErrorClass<"UnboundNamespacePrefixError">;
 /**
  * A namespace a rebuilt WordprocessingML part may declare.
  *
@@ -11,7 +13,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 +27,16 @@ 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>>;
-declare const UnboundNamespacePrefixError_base: import("better-result").TaggedErrorClass<"UnboundNamespacePrefixError">;
+export declare const OOXML_NAMESPACES: Readonly<Record<OoxmlNamespacePrefix, OoxmlNamespace>>;
 /** A rebuilt part uses a prefix that resolves to no namespace URI. */
-declare class UnboundNamespacePrefixError extends UnboundNamespacePrefixError_base<{
+export declare class UnboundNamespacePrefixError extends UnboundNamespacePrefixErrorBase<{
   message: string;
   partPath: string;
   prefixes: readonly string[];
@@ -46,13 +47,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 +74,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 {};

package/dist/docx/serializer/partNamespaces.js

@@ -17,6 +17,7 @@ import { OOXML_NS } from "@stll/docx-utils";
 * falling back to what the source part bound, and a prefix that resolves to
 * nothing fails the save instead of being written unbound.
 */
+const UnboundNamespacePrefixErrorBase = TaggedError("UnboundNamespacePrefixError");
 /**
 * Every namespace a rebuilt part can declare, in the order producers write them.
 *
@@ -176,7 +177,7 @@ const OOXML_NAMESPACES = {
 /** {@link OOXML_NAMESPACES} keyed for lookup by a prefix read out of markup. */
 const NAMESPACE_TABLE = new Map(Object.entries(OOXML_NAMESPACES));
 /** A rebuilt part uses a prefix that resolves to no namespace URI. */
-var UnboundNamespacePrefixError = class extends TaggedError("UnboundNamespacePrefixError") {};
+var UnboundNamespacePrefixError = class extends UnboundNamespacePrefixErrorBase {};
 const XMLNS_ATTRIBUTE_PREFIX = "xmlns:";
 /** Bound by the XML specification itself; never declared. */
 const RESERVED_PREFIX = "xml";

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

@@ -4,9 +4,9 @@ import { document_d_exports } from "../../types/document.js";
  * Reset the auto-incrementing ID counter. Call before each serialization pass
  * to keep IDs deterministic across saves.
  */
-declare function resetAutoIdCounter(): void;
+export declare function resetAutoIdCounter(): void;
 /** Serialize text body content for shapes/textboxes */
-declare function serializeShapeTextBody(blocks: Extract<document_d_exports.BlockContent, {
+export declare function serializeShapeTextBody(blocks: Extract<document_d_exports.BlockContent, {
   type: "paragraph" | "table";
 }>[]): string;
 /**
@@ -15,37 +15,36 @@ declare function serializeShapeTextBody(blocks: Extract<document_d_exports.Block
  * @param run - The run to serialize
  * @returns XML string for the run
  */
-declare function serializeRun(run: document_d_exports.Run): string;
+export declare function serializeRun(run: document_d_exports.Run): string;
 /**
  * Serialize multiple runs to OOXML XML
  *
  * @param runs - The runs to serialize
  * @returns XML string for all runs
  */
-declare function serializeRuns(runs: document_d_exports.Run[]): string;
+export declare function serializeRuns(runs: document_d_exports.Run[]): string;
 /**
  * Check if a run has formatting
  */
-declare function hasRunFormatting(run: document_d_exports.Run): boolean;
+export declare function hasRunFormatting(run: document_d_exports.Run): boolean;
 /**
  * Get plain text from a run (for comparison/debugging)
  */
-declare function getRunPlainText(run: document_d_exports.Run): string;
+export declare function getRunPlainText(run: document_d_exports.Run): string;
 /**
  * Create an empty run
  */
-declare function createEmptyRun(): document_d_exports.Run;
+export declare function createEmptyRun(): document_d_exports.Run;
 /**
  * Create a text run
  */
-declare function createTextRun(text: string, formatting?: document_d_exports.TextFormatting): document_d_exports.Run;
+export declare function createTextRun(text: string, formatting?: document_d_exports.TextFormatting): document_d_exports.Run;
 /**
  * Create a break run
  */
-declare function createBreakRun(breakType?: "page" | "column" | "textWrapping", formatting?: document_d_exports.TextFormatting): document_d_exports.Run;
+export declare function createBreakRun(breakType?: "page" | "column" | "textWrapping", formatting?: document_d_exports.TextFormatting): document_d_exports.Run;
 /**
  * Create a tab run
  */
-declare function createTabRun(formatting?: document_d_exports.TextFormatting): document_d_exports.Run;
-//#endregion
-export { createBreakRun, createEmptyRun, createTabRun, createTextRun, getRunPlainText, hasRunFormatting, resetAutoIdCounter, serializeRun, serializeRuns, serializeShapeTextBody };
+export declare function createTabRun(formatting?: document_d_exports.TextFormatting): document_d_exports.Run;
+//#endregion

package/dist/docx/serializer/runSerializer.js

@@ -10,7 +10,7 @@ import { serializeNonVisualDrawingNames } from "../nonVisualDrawingProps.js";
 import { serializeBoundaryJoins } from "../reviewResolutionProvenance.js";
 import { runHoldsPayload } from "../runPayload.js";
 import { serializeEmptyRunProperties, serializePreviousRunProperties } from "../runPropertyPresence.js";
-import { replayableShapeAlternateContent } from "../shapeAlternateContent.js";
+import { replayableShapeAlternateContent, synchronizedTextShapeAlternateContent } from "../shapeAlternateContent.js";
 import { requiredWrapPolygon, serializeWrapPolygon } from "../wrapPolygon.js";
 import { serializeParagraph } from "./paragraphSerializer.js";
 import { serializeTable } from "./tableSerializer.js";
@@ -549,7 +549,12 @@ function serializeRunContent(content) {
 		case "drawing":
 			if (content.rawXml && canReplayEditableImageRawXml(content)) return content.rawXml;
 			return serializeDrawingContent(content);
-		case "shape": return replayableShapeAlternateContent(content) ?? serializeShapeContent(content);
+		case "shape": {
+			const alternateContent = replayableShapeAlternateContent(content);
+			if (alternateContent !== void 0) return alternateContent;
+			const drawingXml = serializeShapeContent(content);
+			return synchronizedTextShapeAlternateContent(content, drawingXml) ?? drawingXml;
+		}
 		default: return "";
 	}
 }

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

@@ -9,7 +9,7 @@ import { document_d_exports } from "../../types/document.js";
  * a richText control that states nothing, the second is markup the schema does
  * not admit under `w:sdt` — and folio used to write the second for both.
  */
-declare const serializeSdtProperties: (props: document_d_exports.SdtProperties) => string;
+export declare const serializeSdtProperties: (props: document_d_exports.SdtProperties) => string;
 /**
  * `w:sdtEndPr`, replayed when the parse captured it and written from the
  * record otherwise.
@@ -17,10 +17,9 @@ declare const serializeSdtProperties: (props: document_d_exports.SdtProperties)
  * The record's presence is the element's: `<w:sdtEndPr/>` with no `w:rPr` is
  * what Word writes for most controls and differs from a missing element.
  */
-declare const serializeSdtEndProperties: (properties: document_d_exports.SdtProperties) => string;
+export declare const serializeSdtEndProperties: (properties: document_d_exports.SdtProperties) => string;
 /** `w:sdtPr` followed by `w:sdtEndPr`, in schema order. */
-declare const serializeSdtPropertyElements: (properties: document_d_exports.SdtProperties) => string;
+export declare const serializeSdtPropertyElements: (properties: document_d_exports.SdtProperties) => string;
 /** The one writer of an SDT wrapper at every content-model level. */
-declare const serializeSdtWrapper: (properties: document_d_exports.SdtProperties, contentXml: string) => string;
-//#endregion
-export { serializeSdtEndProperties, serializeSdtProperties, serializeSdtPropertyElements, serializeSdtWrapper };
+export declare const serializeSdtWrapper: (properties: document_d_exports.SdtProperties, contentXml: string) => string;
+//#endregion

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
 //#region src/docx/serializer/sectionPropertiesSerializer.d.ts
-declare function serializeSectionProperties(props: document_d_exports.SectionProperties | undefined): string;
-//#endregion
-export { serializeSectionProperties };
+export declare function serializeSectionProperties(props: document_d_exports.SectionProperties | undefined): string;
+//#endregion

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

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

package/dist/docx/serializer/settingsSerializer.js

@@ -13,18 +13,21 @@ const COMPAT_SETTING_URI = "http://schemas.microsoft.com/office/word";
 const MODERN_COMPAT_SETTINGS = ["enableOpenTypeFeatures", "doNotFlipMirrorIndents"];
 const FIRST_MODERN_COMPATIBILITY_MODE = 15;
 const compatSettingXml = (name, val) => `<w:compatSetting w:name="${name}" w:uri="${COMPAT_SETTING_URI}" w:val="${intAttr(val)}"/>`;
-const serializeCompat = (compatibilityMode) => {
-	if (compatibilityMode === void 0) return "";
-	const settings = [compatSettingXml("compatibilityMode", compatibilityMode)];
-	if (compatibilityMode >= FIRST_MODERN_COMPATIBILITY_MODE) for (const name of MODERN_COMPAT_SETTINGS) settings.push(compatSettingXml(name, 1));
-	return `<w:compat>${settings.join("")}</w:compat>`;
+const serializeCompat = (settings) => {
+	const compatSettings = [];
+	const compatibilityMode = settings.compatibilityMode;
+	if (compatibilityMode !== void 0) compatSettings.push(compatSettingXml("compatibilityMode", compatibilityMode));
+	if (compatibilityMode !== void 0 && compatibilityMode >= FIRST_MODERN_COMPATIBILITY_MODE) for (const name of MODERN_COMPAT_SETTINGS) compatSettings.push(compatSettingXml(name, 1));
+	const noColumnBalance = serializeOnOffElement(settings.noColumnBalance, "noColumnBalance");
+	if (compatSettings.length === 0 && noColumnBalance === "") return "";
+	return `<w:compat>${[...compatSettings, noColumnBalance].join("")}</w:compat>`;
 };
 const serializeSettingsXml = (settings) => {
 	const parts = [
 		`<w:defaultTabStop w:val="${intAttr(settings.defaultTabStop)}"/>`,
 		serializeOnOffElement(settings.evenAndOddHeaders, "evenAndOddHeaders"),
 		serializeOnOffElement(settings.updateFields, "updateFields"),
-		serializeCompat(settings.compatibilityMode)
+		serializeCompat(settings)
 	];
 	if (settings.themeFontLang) {
 		const attrs = [];

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

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../../types/document.js";
 //#region src/docx/serializer/stylesSerializer.d.ts
-declare const serializeStylesXml: (definitions: document_d_exports.StyleDefinitions) => string;
-declare const serializeStyle: (style: document_d_exports.Style) => string;
-//#endregion
-export { serializeStyle, serializeStylesXml };
+export declare const serializeStylesXml: (definitions: document_d_exports.StyleDefinitions) => string;
+export declare const serializeStyle: (style: document_d_exports.Style) => string;
+//#endregion

package/dist/docx/serializer/stylesSerializer.js

@@ -5,12 +5,15 @@ import { serializeTextFormatting } from "./textFormattingSerializer.js";
 import { escapeXmlAttribute, pushOnOffElement } from "@stll/docx-core";
 //#region src/docx/serializer/stylesSerializer.ts
 const serializeStylesXml = (definitions) => {
+	const docDefaults = serializeDocumentDefaults(definitions);
+	const latentStyles = serializeLatentStyles(definitions);
+	const styles = definitions.styles.map(serializeStyle).join("");
 	return "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n" + serializePartElement({
 		partPath: "word/styles.xml",
 		rootName: "w:styles",
 		baselinePrefixes: ["w"],
 		sourceBindings: void 0,
-		body: `${serializeDocumentDefaults(definitions)}${serializeLatentStyles(definitions)}${definitions.styles.map(serializeStyle).join("")}`
+		body: `${docDefaults}${latentStyles}${styles}`
 	});
 };
 const serializeDocumentDefaults = (definitions) => {

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

@@ -4,76 +4,76 @@ type ParagraphSerializer = (paragraph: document_d_exports.Paragraph) => string;
 /**
  * Serialize table formatting properties (w:tblPr)
  */
-declare function serializeTableFormatting(formatting: document_d_exports.TableFormatting | undefined, propertyChanges?: document_d_exports.TablePropertyChange[]): string;
+export declare function serializeTableFormatting(formatting: document_d_exports.TableFormatting | undefined, propertyChanges?: document_d_exports.TablePropertyChange[]): string;
 /**
  * Serialize table row formatting properties (w:trPr)
  */
-declare function serializeTableRowFormatting(formatting: document_d_exports.TableRowFormatting | undefined, propertyChanges?: document_d_exports.TableRowPropertyChange[], structuralChange?: document_d_exports.TableStructuralChangeInfo): string;
+export declare function serializeTableRowFormatting(formatting: document_d_exports.TableRowFormatting | undefined, propertyChanges?: document_d_exports.TableRowPropertyChange[], structuralChange?: document_d_exports.TableStructuralChangeInfo): string;
 /**
  * Serialize table cell formatting properties (w:tcPr)
  */
-declare function serializeTableCellFormatting(formatting: document_d_exports.TableCellFormatting | undefined, propertyChanges?: document_d_exports.TableCellPropertyChange[], structuralChange?: document_d_exports.TableStructuralChangeInfo): string;
+export declare function serializeTableCellFormatting(formatting: document_d_exports.TableCellFormatting | undefined, propertyChanges?: document_d_exports.TableCellPropertyChange[], structuralChange?: document_d_exports.TableStructuralChangeInfo): string;
 /**
  * Serialize a table cell (w:tc)
  */
-declare function serializeTableCell(cell: document_d_exports.TableCell, serializeParagraph: ParagraphSerializer): string;
+export declare function serializeTableCell(cell: document_d_exports.TableCell, serializeParagraph: ParagraphSerializer): string;
 /**
  * Serialize a table row (w:tr)
  */
-declare function serializeTableRow(row: document_d_exports.TableRow, serializeParagraph: ParagraphSerializer): string;
+export declare function serializeTableRow(row: document_d_exports.TableRow, serializeParagraph: ParagraphSerializer): string;
 /**
  * Serialize a table to OOXML XML (w:tbl)
  *
  * @param table - The table to serialize
  * @returns XML string for the table
  */
-declare function serializeTable(table: document_d_exports.Table, serializeParagraph: ParagraphSerializer): string;
+export declare function serializeTable(table: document_d_exports.Table, serializeParagraph: ParagraphSerializer): string;
 /**
  * Serialize multiple tables to OOXML XML
  *
  * @param tables - The tables to serialize
  * @returns XML string for all tables
  */
-declare function serializeTables(tables: document_d_exports.Table[], serializeParagraph: ParagraphSerializer): string;
+export declare function serializeTables(tables: document_d_exports.Table[], serializeParagraph: ParagraphSerializer): string;
 /**
  * Check if a table has any rows
  */
-declare function hasTableRows(table: document_d_exports.Table): boolean;
+export declare function hasTableRows(table: document_d_exports.Table): boolean;
 /**
  * Check if a table has formatting
  */
-declare function hasTableFormatting(table: document_d_exports.Table): boolean;
+export declare function hasTableFormatting(table: document_d_exports.Table): boolean;
 /**
  * Check if a row has any cells
  */
-declare function hasRowCells(row: document_d_exports.TableRow): boolean;
+export declare function hasRowCells(row: document_d_exports.TableRow): boolean;
 /**
  * Check if a row has formatting
  */
-declare function hasRowFormatting(row: document_d_exports.TableRow): boolean;
+export declare function hasRowFormatting(row: document_d_exports.TableRow): boolean;
 /**
  * Check if a cell has any content
  */
-declare function hasCellContent(cell: document_d_exports.TableCell): boolean;
+export declare function hasCellContent(cell: document_d_exports.TableCell): boolean;
 /**
  * Check if a cell has formatting
  */
-declare function hasCellFormatting(cell: document_d_exports.TableCell): boolean;
+export declare function hasCellFormatting(cell: document_d_exports.TableCell): boolean;
 /**
  * Get the number of columns in a table
  */
-declare function getTableColumnCount(table: document_d_exports.Table): number;
+export declare function getTableColumnCount(table: document_d_exports.Table): number;
 /**
  * Get the number of rows in a table
  */
-declare function getTableRowCount(table: document_d_exports.Table): number;
+export declare function getTableRowCount(table: document_d_exports.Table): number;
 /**
  * Create an empty table
  */
-declare function createEmptyTable(rows?: number, cols?: number): document_d_exports.Table;
+export declare function createEmptyTable(rows?: number, cols?: number): document_d_exports.Table;
 /**
  * Create a table cell with text content
  */
-declare function createTextCell(text: string, formatting?: document_d_exports.TableCellFormatting): document_d_exports.TableCell;
+export declare function createTextCell(text: string, formatting?: document_d_exports.TableCellFormatting): document_d_exports.TableCell;
 //#endregion
-export { createEmptyTable, createTextCell, getTableColumnCount, getTableRowCount, hasCellContent, hasCellFormatting, hasRowCells, hasRowFormatting, hasTableFormatting, hasTableRows, serializeTable, serializeTableCell, serializeTableCellFormatting, serializeTableFormatting, serializeTableRow, serializeTableRowFormatting, serializeTables };
+export {};

package/dist/docx/serializer/tableSerializer.js

@@ -10,7 +10,7 @@ import { OOXML_NAMESPACE_SCOPE, parseXml } from "../xmlParser.js";
 import { serializeBlockCustomXml } from "./blockCustomXmlSerializer.js";
 import { serializeBlockSdt } from "./blockSdtSerializer.js";
 import { serializeBorder } from "./borderSerializer.js";
-import { serializeBookmarkMarker } from "./markupRangeAttributes.js";
+import { serializeBookmarkMarker, serializeMoveRangeMarker } from "./markupRangeAttributes.js";
 import { serializeSdtWrapper } from "./sdtPropertiesSerializer.js";
 import { serializeTrackedChangeAttributes } from "./trackedChangeAttributes.js";
 import { intAttr } from "./xmlUtils.js";
@@ -19,6 +19,21 @@ import { themeColorToken } from "@stll/docx-core/model";
 import { serializeSequenceChildren } from "@stll/docx-core/schema";
 //#region src/docx/serializer/tableSerializer.ts
 /**
+* Table Serializer - Serialize tables to OOXML XML
+*
+* Converts Table objects back to <w:tbl> XML format for DOCX files.
+* Handles all table, row, and cell properties including merged cells.
+*
+* OOXML Reference:
+* - Table: w:tbl
+* - Table properties: w:tblPr
+* - Table grid: w:tblGrid
+* - Table row: w:tr
+* - Row properties: w:trPr
+* - Table cell: w:tc
+* - Cell properties: w:tcPr
+*/
+/**
 * The captured element with the revision children written back into it.
 *
 * The capture holds properties only, so a revision the model carries — a row
@@ -438,7 +453,8 @@ function serializeTableGrid(table) {
 	const columnWidths = table.columnWidths;
 	const gridSourceXml = table.formatting?.gridSourceXml;
 	if (gridSourceXml !== void 0) {
-		if (canonicalJson(parseTableGrid(parseXml(gridSourceXml, OOXML_NAMESPACE_SCOPE).elements?.[0] ?? null)) === canonicalJson(columnWidths)) return gridSourceXml;
+		const parsed = parseTableGrid(parseXml(gridSourceXml, OOXML_NAMESPACE_SCOPE).elements?.[0] ?? null);
+		if (canonicalJson(parsed) === canonicalJson(columnWidths)) return gridSourceXml;
 	}
 	const change = table.formatting?.gridChange;
 	const gridChange = change === void 0 ? "" : serializeTableGridChange(change);
@@ -507,6 +523,10 @@ function serializeCellContent(content, serializeParagraph) {
 			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;
 		}
 	};