@stll/folio-core 0.62.0 → 0.63.0

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

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

@@ -18,7 +18,7 @@ type OwnedRunPropertyChild = readonly [name: DeclaredChild<"run-properties">, xm
 /**
  * Serialize shading properties (w:shd)
  */
-declare function serializeShading(shading: ExhaustiveShadingProperties | undefined): string;
+export declare function serializeShading(shading: ExhaustiveShadingProperties | undefined): string;
 /**
  * The single `w:rPr` writer.
  *
@@ -35,6 +35,6 @@ declare function serializeShading(shading: ExhaustiveShadingProperties | undefin
  *
  * @param owned children a sibling record holds; see {@link OwnedRunPropertyChild}
  */
-declare function serializeTextFormatting(input: ExhaustiveTextFormatting | undefined, owned?: readonly OwnedRunPropertyChild[]): string;
+export declare function serializeTextFormatting(input: ExhaustiveTextFormatting | undefined, owned?: readonly OwnedRunPropertyChild[]): string;
 //#endregion
-export { serializeShading, serializeTextFormatting };
+export {};

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

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

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

@@ -2,8 +2,8 @@ import { document_d_exports } from "../../types/document.js";
 //#region src/docx/serializer/trackedChangeAttributes.d.ts
 type SerializableTrackedChangeInfo = document_d_exports.TrackedChangeInfo | document_d_exports.PropertyChangeInfo;
 /** Normalized, unescaped attributes in schema order for an XML element or string serializer. */
-declare const trackedChangeAttributeEntries: (info: SerializableTrackedChangeInfo) => readonly (readonly [string, string])[];
-declare const trackedChangeAttributeRecord: (info: SerializableTrackedChangeInfo) => Record<string, string>;
-declare const serializeTrackedChangeAttributes: (info: SerializableTrackedChangeInfo) => string;
+export declare const trackedChangeAttributeEntries: (info: SerializableTrackedChangeInfo) => readonly (readonly [string, string])[];
+export declare const trackedChangeAttributeRecord: (info: SerializableTrackedChangeInfo) => Record<string, string>;
+export declare const serializeTrackedChangeAttributes: (info: SerializableTrackedChangeInfo) => string;
 //#endregion
-export { serializeTrackedChangeAttributes, trackedChangeAttributeEntries, trackedChangeAttributeRecord };
+export {};

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

@@ -14,7 +14,7 @@
  * `NaN`/`Infinity`/`null`/`undefined` collapse to `'0'` rather than leaking
  * literal `"NaN"` or `"Infinity"` into the XML.
  */
-declare function intAttr(value: number | undefined | null): string;
+export declare function intAttr(value: number | undefined | null): string;
 /**
  * Verify that `xml` parses to exactly one root element named `expectedLocalName`
  * (namespace prefix ignored). Used to gate raw XML snapshots — e.g. an SDT's
@@ -26,6 +26,5 @@ declare function intAttr(value: number | undefined | null): string;
  * sibling markup or close the enclosing `<w:sdt>` early. Callers should fall
  * back to a synthesized properties block when this returns `false`.
  */
-declare function isSingleWellFormedElement(xml: string, expectedLocalName: string): boolean;
-//#endregion
-export { intAttr, isSingleWellFormedElement };
+export declare function isSingleWellFormedElement(xml: string, expectedLocalName: string): boolean;
+//#endregion

package/dist/docx/server/applyDocxXmlPatchProposal.d.ts

@@ -2,9 +2,9 @@ import { DocxArchiveOptions } from "./boundedArchive.js";
 import { FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FolioDocxPreparedXmlReplacement, FolioDocxXmlPatchProposalEvaluation, FolioDocxXmlPatchProposalLimits } from "./evaluateDocxXmlPatchProposal.js";
 import { FOLIO_DOCX_CONFORMANCE_PROFILE, FolioDocxConformanceReport } from "./validateDocxConformance.js";
 //#region src/docx/server/applyDocxXmlPatchProposal.d.ts
-declare const FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION: 1;
-declare const FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE: "folio-xml-patch-application-v1";
-type ApplyDocxXmlPatchProposalArgs = {
+export declare const FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION: 1;
+export declare const FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE: "folio-xml-patch-application-v1";
+export type ApplyDocxXmlPatchProposalArgs = {
   readonly bytes: ArrayBuffer | Uint8Array;
   readonly proposal: unknown;
   /** Exact package paths authorized by the server-side caller. */
@@ -13,7 +13,7 @@ type ApplyDocxXmlPatchProposalArgs = {
   readonly archive?: DocxArchiveOptions;
   readonly limits?: FolioDocxXmlPatchProposalLimits;
 };
-type FolioDocxXmlPatchApplicationReceipt = {
+export type FolioDocxXmlPatchApplicationReceipt = {
   readonly version: typeof FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION;
   readonly profile: typeof FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE;
   readonly proposalProfile: typeof FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE;
@@ -28,7 +28,7 @@ type FolioDocxXmlPatchApplicationReceipt = {
   };
   readonly replacements: readonly [FolioDocxPreparedXmlReplacement, ...FolioDocxPreparedXmlReplacement[]];
 };
-type FolioDocxXmlPatchApplication = {
+export type FolioDocxXmlPatchApplication = {
   readonly version: typeof FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION;
   readonly profile: typeof FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE;
   readonly status: "proposal-rejected";
@@ -63,18 +63,18 @@ type FolioDocxXmlPatchApplication = {
   readonly bytes: Uint8Array;
 };
 declare const UnsupportedFolioDocxXmlPatchApplicationProfileError_base: import("better-result").TaggedErrorClass<"UnsupportedFolioDocxXmlPatchApplicationProfileError">;
-declare class UnsupportedFolioDocxXmlPatchApplicationProfileError extends UnsupportedFolioDocxXmlPatchApplicationProfileError_base<{
+export declare class UnsupportedFolioDocxXmlPatchApplicationProfileError extends UnsupportedFolioDocxXmlPatchApplicationProfileError_base<{
   message: string;
   profile: unknown;
 }> {}
 declare const FolioDocxXmlPatchApplicationError_base: import("better-result").TaggedErrorClass<"FolioDocxXmlPatchApplicationError">;
-declare class FolioDocxXmlPatchApplicationError extends FolioDocxXmlPatchApplicationError_base<{
+export declare class FolioDocxXmlPatchApplicationError extends FolioDocxXmlPatchApplicationError_base<{
   message: string;
   stage: "verify" | "load" | "replace" | "generate";
   part?: string;
   cause?: unknown;
 }> {}
 /** Apply a guarded XML proposal and return output only after full profile validation. */
-declare const applyDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, validationProfile, archive, limits }: ApplyDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchApplication>;
+export declare const applyDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, validationProfile, archive, limits }: ApplyDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchApplication>;
 //#endregion
-export { ApplyDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, FolioDocxXmlPatchApplicationReceipt, UnsupportedFolioDocxXmlPatchApplicationProfileError, applyDocxXmlPatchProposal };
+export {};

package/dist/docx/server/applyDocxXmlPatchProposal.js

@@ -4,8 +4,8 @@ import { FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, InvalidFolioDocxXmlPatchProposal
 import { FOLIO_DOCX_CONFORMANCE_PROFILE, validateDocxConformance } from "./validateDocxConformance.js";
 import { TaggedError, panic } from "better-result";
 import { createHash } from "node:crypto";
-import { writeZipPart } from "@stll/docx-core/zip";
 import JSZip from "jszip";
+import { writeZipPart } from "@stll/docx-core/zip";
 //#region src/docx/server/applyDocxXmlPatchProposal.ts
 const FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION = 1;
 const FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE = "folio-xml-patch-application-v1";

package/dist/docx/server/boundedArchive.d.ts

@@ -1,17 +1,17 @@
 import { XmlResourceLimits } from "../xmlResourceLimits.js";
 //#region src/docx/server/boundedArchive.d.ts
-declare const DOCX_MAX_ENTRY_BYTES: number;
-declare const DOCX_MAX_TOTAL_BYTES: number;
-declare const DOCX_MAX_ENTRIES = 4096;
-declare const DOCX_MAX_INPUT_BYTES: number;
+export declare const DOCX_MAX_ENTRY_BYTES: number;
+export declare const DOCX_MAX_TOTAL_BYTES: number;
+export declare const DOCX_MAX_ENTRIES = 4096;
+export declare const DOCX_MAX_INPUT_BYTES: number;
 declare const DocxArchiveError_base: import("better-result").TaggedErrorClass<"DocxArchiveError">;
 /** Error raised when a DOCX archive cannot be loaded within configured limits. */
-declare class DocxArchiveError extends DocxArchiveError_base<{
+export declare class DocxArchiveError extends DocxArchiveError_base<{
   message: string;
   reason: "load-failed" | "input-too-large" | "too-many-entries" | "entry-too-large" | "total-too-large" | "compression-ratio-exceeded" | "invalid-options";
   cause?: unknown;
 }> {}
-type DocxArchiveOptions = {
+export type DocxArchiveOptions = {
   maxInputBytes?: number;
   maxEntryBytes?: number;
   maxTotalBytes?: number;
@@ -35,20 +35,20 @@ type DocxArchiveOptions = {
    */
   xmlLimits?: Partial<XmlResourceLimits>;
 };
-type DocxArchiveEntry = {
+export type DocxArchiveEntry = {
   readonly path: string;
   readonly directory: boolean;
   readonly declaredUncompressedBytes: number | null;
 };
-type DocxArchiveReadOptions = {
+export type DocxArchiveReadOptions = {
   maxBytes?: number;
 };
-type DocxArchive = {
+export type DocxArchive = {
   entries: readonly string[];
   entryMetadata: readonly DocxArchiveEntry[];
   readEntryString: (path: string) => Promise<string | null>;
   readEntryUint8: (path: string, options?: DocxArchiveReadOptions) => Promise<Uint8Array | null>;
 };
-declare const loadDocxArchive: (bytes: ArrayBuffer | Uint8Array, options?: DocxArchiveOptions) => Promise<DocxArchive>;
+export declare const loadDocxArchive: (bytes: ArrayBuffer | Uint8Array, options?: DocxArchiveOptions) => Promise<DocxArchive>;
 //#endregion
-export { DOCX_MAX_ENTRIES, DOCX_MAX_ENTRY_BYTES, DOCX_MAX_INPUT_BYTES, DOCX_MAX_TOTAL_BYTES, DocxArchive, DocxArchiveEntry, DocxArchiveError, DocxArchiveOptions, DocxArchiveReadOptions, loadDocxArchive };
+export {};

package/dist/docx/server/boundedArchive.js

@@ -4,10 +4,10 @@ import { FOLIO_XML_RESOURCE_LIMITS, assertXmlResourceLimits, createXmlPackageBud
 import { TaggedError } from "better-result";
 import JSZip from "jszip";
 //#region src/docx/server/boundedArchive.ts
-const DOCX_MAX_ENTRY_BYTES = 128 * 1024 * 1024;
-const DOCX_MAX_TOTAL_BYTES = 256 * 1024 * 1024;
+const DOCX_MAX_ENTRY_BYTES = 134217728;
+const DOCX_MAX_TOTAL_BYTES = 268435456;
 const DOCX_MAX_ENTRIES = 4096;
-const DOCX_MAX_INPUT_BYTES = 50 * 1024 * 1024;
+const DOCX_MAX_INPUT_BYTES = 52428800;
 /** Error raised when a DOCX archive cannot be loaded within configured limits. */
 var DocxArchiveError = class extends TaggedError("DocxArchiveError") {};
 const readLimitError = ({ limit, path, maxEntryBytes, maxTotalBytes, maxCompressionRatio }) => {

package/dist/docx/server/build.d.ts

@@ -3,28 +3,28 @@ import { document_d_exports } from "../../types/document.js";
 import { ParagraphFormatting, TextFormatting } from "../../types/formatting.js";
 import { Hyperlink, Paragraph, ParagraphContent, Run, Table } from "../../types/content.js";
 //#region src/docx/server/build.d.ts
-declare const HEADING_LEVELS: readonly [1, 2, 3, 4, 5, 6];
-type HeadingLevel = (typeof HEADING_LEVELS)[number];
+export declare const HEADING_LEVELS: readonly [1, 2, 3, 4, 5, 6];
+export type HeadingLevel = (typeof HEADING_LEVELS)[number];
 declare const InvalidFolioReportBuilderOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioReportBuilderOptionsError">;
 /**
  * A builder received a value outside the model's domain (a zero `gridSpan`,
  * a negative column width, a reversed TOC range). Thrown at the boundary so
  * the invalid value never reaches the serializer.
  */
-declare class InvalidFolioReportBuilderOptionsError extends InvalidFolioReportBuilderOptionsError_base<{
+export declare class InvalidFolioReportBuilderOptionsError extends InvalidFolioReportBuilderOptionsError_base<{
   message: string;
   path: string;
 }> {}
-declare const run: (text: string, formatting?: TextFormatting) => Run;
-declare const paragraph: (content: string | ParagraphContent[], formatting?: ParagraphFormatting) => Paragraph;
+export declare const run: (text: string, formatting?: TextFormatting) => Run;
+export declare const paragraph: (content: string | ParagraphContent[], formatting?: ParagraphFormatting) => Paragraph;
 type HeadingOptions = {
   text: string;
   level: HeadingLevel;
 };
 /** A paragraph in the `Heading<level>` style. */
-declare const heading: ({ text, level }: HeadingOptions) => Paragraph;
+export declare const heading: ({ text, level }: HeadingOptions) => Paragraph;
 /** An empty paragraph carrying a hard page break. */
-declare const pageBreak: () => Paragraph;
+export declare const pageBreak: () => Paragraph;
 type HyperlinkTarget = {
   href: string;
   anchor?: never;
@@ -41,7 +41,7 @@ type HyperlinkOptions = HyperlinkTarget & {
  * An external (`href`) or in-document (`anchor`, a bookmark name) link. The
  * relationship for an external link is minted when the document is written.
  */
-declare const hyperlink: ({ text, formatting, tooltip, href, anchor }: HyperlinkOptions) => Hyperlink;
+export declare const hyperlink: ({ text, formatting, tooltip, href, anchor }: HyperlinkOptions) => Hyperlink;
 type BookmarkOptions = {
   name: string;
   content: ParagraphContent[];
@@ -53,8 +53,8 @@ type BookmarkOptions = {
   id?: number;
 };
 /** `content` wrapped in a named bookmark, the target of `hyperlink({ anchor })`. */
-declare const bookmark: ({ name, content, id }: BookmarkOptions) => ParagraphContent[];
-type TableCellSpec = string | {
+export declare const bookmark: ({ name, content, id }: BookmarkOptions) => ParagraphContent[];
+export type TableCellSpec = string | {
   content: Paragraph[];
   shading?: ShadingProperties;
   gridSpan?: number;
@@ -75,13 +75,13 @@ type TableOptions = {
  * plain paragraph; an object cell supplies its own paragraphs plus optional
  * shading and horizontal (`gridSpan`) or vertical (`vMerge`) merge.
  */
-declare const table: ({ header, rows, columnWidths, headerShading, repeatHeader }: TableOptions) => Table;
+export declare const table: ({ header, rows, columnWidths, headerShading, repeatHeader }: TableOptions) => Table;
 /**
  * Register an endnote on `doc` and return the reference run to place in body
  * text. Allocates the next free endnote id (Word reserves 0 and -1 for the
  * separator notes) and pushes the note into `doc.package.endnotes`.
  */
-declare const endnote: (doc: document_d_exports.Document, content: string | Paragraph[]) => Run;
+export declare const endnote: (doc: document_d_exports.Document, content: string | Paragraph[]) => Run;
 type TableOfContentsOptions = {
   /** Heading levels to include, `1 <= from <= to <= 9` (default 1-3). */
   levels?: {
@@ -98,6 +98,6 @@ type TableOfContentsOptions = {
  * table on open. Set `package.settings.updateFields` as well to have Word
  * recompute without prompting for each field.
  */
-declare const createTableOfContentsField: ({ levels, hyperlinks, placeholderText }?: TableOfContentsOptions) => Paragraph;
+export declare const createTableOfContentsField: ({ levels, hyperlinks, placeholderText }?: TableOfContentsOptions) => Paragraph;
 //#endregion
-export { HEADING_LEVELS, HeadingLevel, InvalidFolioReportBuilderOptionsError, TableCellSpec, bookmark, createTableOfContentsField, endnote, heading, hyperlink, pageBreak, paragraph, run, table };
+export {};

package/dist/docx/server/build.js

@@ -1,7 +1,7 @@
 import { mintBookmarkId, reserveBookmarkIds } from "../bookmarkIds.js";
 import { mintEndnoteId } from "../noteIds.js";
 import { TaggedError } from "better-result";
-import { assertValidOoxmlNumericId } from "@stll/docx-core";
+import { assertValidOoxmlNumericId, finalizeParagraphFormatting } from "@stll/docx-core";
 //#region src/docx/server/build.ts
 /**
 * Headless document builders.
@@ -72,11 +72,14 @@ const run = (text, formatting) => ({
 		text
 	}]
 });
-const paragraph = (content, formatting) => ({
-	type: "paragraph",
-	...formatting ? { formatting } : {},
-	content: typeof content === "string" ? [run(content)] : content
-});
+const paragraph = (content, formatting) => {
+	const finalizedFormatting = finalizeParagraphFormatting(formatting);
+	return {
+		type: "paragraph",
+		...finalizedFormatting === void 0 ? {} : { formatting: finalizedFormatting },
+		content: typeof content === "string" ? [run(content)] : content
+	};
+};
 /** A paragraph in the `Heading<level>` style. */
 const heading = ({ text, level }) => {
 	assertHeadingLevel(level);