@stll/folio-core 0.37.3 → 0.37.5

package/dist/docx/serializer/textFormattingSerializer.js

@@ -0,0 +1,142 @@
+import { HIGHLIGHT_COLOR_VALUES } from "../../types/documentEnumValues.js";
+import { isValidHexColor } from "../../utils/colorResolver.js";
+import { roundHorizontalScalePercentForSerialization } from "../../utils/horizontalScale.js";
+import { escapeXml, intAttr } from "./xmlUtils.js";
+//#region src/docx/serializer/textFormattingSerializer.ts
+const VALID_HIGHLIGHT_COLORS = new Set(HIGHLIGHT_COLOR_VALUES);
+/**
+* Serialize a color element (w:color)
+*/
+function serializeColorElement(color) {
+	if (!color) return "";
+	const { auto, rgb, themeColor, themeTint, themeShade } = color;
+	const attrs = [];
+	if (auto) attrs.push("w:val=\"auto\"");
+	else if (rgb && isValidHexColor(rgb)) attrs.push(`w:val="${escapeXml(rgb)}"`);
+	if (themeColor) attrs.push(`w:themeColor="${escapeXml(themeColor)}"`);
+	if (themeTint) attrs.push(`w:themeTint="${escapeXml(themeTint)}"`);
+	if (themeShade) attrs.push(`w:themeShade="${escapeXml(themeShade)}"`);
+	return attrs.length === 0 ? "" : `<w:color ${attrs.join(" ")}/>`;
+}
+/**
+* Serialize shading properties (w:shd)
+*/
+function serializeShading(shading) {
+	if (!shading) return "";
+	const { pattern, color, fill } = shading;
+	const attrs = [];
+	if (pattern) attrs.push(`w:val="${escapeXml(pattern)}"`);
+	else attrs.push("w:val=\"clear\"");
+	if (color) {
+		const { rgb, auto, themeColor: _themeColor, themeTint: _themeTint, themeShade: _themeShade } = color;
+		if (rgb && isValidHexColor(rgb)) attrs.push(`w:color="${escapeXml(rgb)}"`);
+		else if (auto) attrs.push("w:color=\"auto\"");
+	}
+	if (fill) {
+		const { rgb, auto, themeColor, themeTint, themeShade } = fill;
+		if (rgb && isValidHexColor(rgb)) attrs.push(`w:fill="${escapeXml(rgb)}"`);
+		else if (auto) attrs.push("w:fill=\"auto\"");
+		if (themeColor) attrs.push(`w:themeFill="${escapeXml(themeColor)}"`);
+		if (themeTint) attrs.push(`w:themeFillTint="${escapeXml(themeTint)}"`);
+		if (themeShade) attrs.push(`w:themeFillShade="${escapeXml(themeShade)}"`);
+	}
+	return attrs.length === 0 ? "" : `<w:shd ${attrs.join(" ")}/>`;
+}
+/**
+* Serialize text formatting properties to w:rPr XML
+*/
+function serializeTextFormatting(input) {
+	if (!input) return "";
+	const { bold, boldCs, italic, italicCs, underline, strike, doubleStrike, vertAlign, smallCaps, allCaps, hidden, color, highlight, shading, fontSize, fontSizeCs, fontFamily, language, spacing, position, scale, kerning, effect, emphasisMark, emboss, imprint, outline, shadow, rtl, cs, styleId } = input;
+	const parts = [];
+	if (styleId) parts.push(`<w:rStyle w:val="${escapeXml(styleId)}"/>`);
+	if (fontFamily) {
+		const { ascii, hAnsi, eastAsia, cs: complexScript, hint, asciiTheme, hAnsiTheme, eastAsiaTheme, csTheme } = fontFamily;
+		const fontAttrs = [];
+		if (ascii) fontAttrs.push(`w:ascii="${escapeXml(ascii)}"`);
+		if (hAnsi) fontAttrs.push(`w:hAnsi="${escapeXml(hAnsi)}"`);
+		if (eastAsia) fontAttrs.push(`w:eastAsia="${escapeXml(eastAsia)}"`);
+		if (complexScript) fontAttrs.push(`w:cs="${escapeXml(complexScript)}"`);
+		if (hint) fontAttrs.push(`w:hint="${escapeXml(hint)}"`);
+		if (asciiTheme) fontAttrs.push(`w:asciiTheme="${escapeXml(asciiTheme)}"`);
+		if (hAnsiTheme) fontAttrs.push(`w:hAnsiTheme="${escapeXml(hAnsiTheme)}"`);
+		if (eastAsiaTheme) fontAttrs.push(`w:eastAsiaTheme="${escapeXml(eastAsiaTheme)}"`);
+		if (csTheme) fontAttrs.push(`w:cstheme="${escapeXml(csTheme)}"`);
+		if (fontAttrs.length > 0) parts.push(`<w:rFonts ${fontAttrs.join(" ")}/>`);
+	}
+	if (bold === true) parts.push("<w:b/>");
+	else if (bold === false) parts.push("<w:b w:val=\"0\"/>");
+	if (boldCs === true) parts.push("<w:bCs/>");
+	else if (boldCs === false) parts.push("<w:bCs w:val=\"0\"/>");
+	if (italic === true) parts.push("<w:i/>");
+	else if (italic === false) parts.push("<w:i w:val=\"0\"/>");
+	if (italicCs === true) parts.push("<w:iCs/>");
+	else if (italicCs === false) parts.push("<w:iCs w:val=\"0\"/>");
+	if (allCaps === true) parts.push("<w:caps/>");
+	else if (allCaps === false) parts.push("<w:caps w:val=\"0\"/>");
+	if (smallCaps === true) parts.push("<w:smallCaps/>");
+	else if (smallCaps === false) parts.push("<w:smallCaps w:val=\"0\"/>");
+	if (strike === true) parts.push("<w:strike/>");
+	else if (strike === false) parts.push("<w:strike w:val=\"0\"/>");
+	if (doubleStrike === true) parts.push("<w:dstrike/>");
+	else if (doubleStrike === false) parts.push("<w:dstrike w:val=\"0\"/>");
+	if (outline === true) parts.push("<w:outline/>");
+	else if (outline === false) parts.push("<w:outline w:val=\"0\"/>");
+	if (shadow === true) parts.push("<w:shadow/>");
+	else if (shadow === false) parts.push("<w:shadow w:val=\"0\"/>");
+	if (emboss === true) parts.push("<w:emboss/>");
+	else if (emboss === false) parts.push("<w:emboss w:val=\"0\"/>");
+	if (imprint === true) parts.push("<w:imprint/>");
+	else if (imprint === false) parts.push("<w:imprint w:val=\"0\"/>");
+	if (hidden === true) parts.push("<w:vanish/>");
+	else if (hidden === false) parts.push("<w:vanish w:val=\"0\"/>");
+	const colorXml = serializeColorElement(color);
+	if (colorXml) parts.push(colorXml);
+	if (spacing !== void 0) parts.push(`<w:spacing w:val="${intAttr(spacing)}"/>`);
+	const horizontalScale = roundHorizontalScalePercentForSerialization(scale);
+	if (horizontalScale !== void 0) parts.push(`<w:w w:val="${intAttr(horizontalScale)}"/>`);
+	if (kerning !== void 0) parts.push(`<w:kern w:val="${intAttr(kerning)}"/>`);
+	if (position !== void 0) parts.push(`<w:position w:val="${intAttr(position)}"/>`);
+	if (fontSize !== void 0) parts.push(`<w:sz w:val="${intAttr(fontSize)}"/>`);
+	if (fontSizeCs !== void 0) parts.push(`<w:szCs w:val="${intAttr(fontSizeCs)}"/>`);
+	let customHighlightShadingXml = "";
+	if (highlight) {
+		if (VALID_HIGHLIGHT_COLORS.has(highlight)) parts.push(`<w:highlight w:val="${highlight}"/>`);
+		else if (!shading) {
+			const hex = highlight.replace(/^#/u, "");
+			if (/^[0-9a-fA-F]{6}$/u.test(hex)) customHighlightShadingXml = `<w:shd w:val="clear" w:color="auto" w:fill="${hex}"/>`;
+		}
+	}
+	if (underline) {
+		const { style, color: underlineColor } = underline;
+		const uAttrs = [`w:val="${style}"`];
+		if (underlineColor) {
+			const { rgb, themeColor, themeTint, themeShade, auto: _auto } = underlineColor;
+			if (rgb && isValidHexColor(rgb)) uAttrs.push(`w:color="${escapeXml(rgb)}"`);
+			if (themeColor) uAttrs.push(`w:themeColor="${escapeXml(themeColor)}"`);
+			if (themeTint) uAttrs.push(`w:themeTint="${escapeXml(themeTint)}"`);
+			if (themeShade) uAttrs.push(`w:themeShade="${escapeXml(themeShade)}"`);
+		}
+		parts.push(`<w:u ${uAttrs.join(" ")}/>`);
+	}
+	if (effect) parts.push(`<w:effect w:val="${effect}"/>`);
+	const shadingXml = serializeShading(shading) || customHighlightShadingXml;
+	if (shadingXml) parts.push(shadingXml);
+	if (vertAlign) parts.push(`<w:vertAlign w:val="${vertAlign}"/>`);
+	if (rtl === true) parts.push("<w:rtl/>");
+	else if (rtl === false) parts.push("<w:rtl w:val=\"0\"/>");
+	if (cs === true) parts.push("<w:cs/>");
+	else if (cs === false) parts.push("<w:cs w:val=\"0\"/>");
+	if (emphasisMark) parts.push(`<w:em w:val="${emphasisMark}"/>`);
+	if (language) {
+		const { val, eastAsia, bidi } = language;
+		const languageAttrs = [];
+		if (val) languageAttrs.push(`w:val="${escapeXml(val)}"`);
+		if (eastAsia) languageAttrs.push(`w:eastAsia="${escapeXml(eastAsia)}"`);
+		if (bidi) languageAttrs.push(`w:bidi="${escapeXml(bidi)}"`);
+		if (languageAttrs.length > 0) parts.push(`<w:lang ${languageAttrs.join(" ")}/>`);
+	}
+	return parts.length === 0 ? "" : `<w:rPr>${parts.join("")}</w:rPr>`;
+}
+//#endregion
+export { serializeShading, serializeTextFormatting };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { document_d_exports } from "./types/document.js";
-import { FolioContentBlock, FolioContentContainerPathEntry, FolioContentIdStability, FolioContentInlineBooleanProperty, FolioContentInlineFormatting, FolioContentInlineFormattingPatch, FolioContentLineSpacingRule, FolioContentParagraphAlignment, FolioContentParagraphSpacing, FolioContentRun, FolioContentSnapshot, FolioContentTableLocation } from "./compare/content-types.js";
+import { FolioContentBlock, FolioContentContainerPathEntry, FolioContentIdStability, FolioContentInlineBooleanProperty, FolioContentInlineFormatting, FolioContentInlineFormattingPatch, FolioContentLineSpacingRule, FolioContentParagraphAlignment, FolioContentParagraphKind, FolioContentParagraphSpacing, FolioContentRun, FolioContentSnapshot, FolioContentTableLocation } from "./compare/content-types.js";
 import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIBlockStructuralBoundary, FolioAIBlockTableLocation, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineBooleanProperty, FolioAIInlineFormatting, FolioAIInlineFormattingPatch, FolioAIParagraphSpacing, FolioAISignatureParty } from "./ai-edits/types.js";
 import { WORD_DIFF_GRANULARITIES, WordDiffGranularity, WordDiffNormalization, WordDiffOptions, WordDiffSegment, diffWordSegments } from "./ai-edits/word-diff.js";
 import { FolioAIEditApplyOutcome, FolioRevisionStamp, FolioWordDiffOptions, applyFolioAIEditOperations } from "./ai-edits/apply.js";
@@ -40,4 +40,4 @@ import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
 type Document = document_d_exports.Document;
 type DocxConformanceClass = document_d_exports.DocxConformanceClass;
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFormatRange, type CompareResult, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_CONTENT_COMPARISON_LIMITS, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, type FinalParagraphMarkRevision, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioBlockId, type FolioContentBlock, type FolioContentBlockProperty, type FolioContentComparison, type FolioContentComparisonError, type FolioContentComparisonEvent, type FolioContentComparisonLimit, FolioContentComparisonLimitError, type FolioContentContainerPathEntry, type FolioContentFormatRange, type FolioContentFormattingChange, type FolioContentIdStability, type FolioContentInlineBooleanProperty, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphSpacing, type FolioContentRun, type FolioContentSnapshot, type FolioContentStructuralChange, type FolioContentTableLocation, type FolioContentTextSegment, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type BlockRect, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, type CompareContentOptions, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFormatRange, type CompareResult, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_CONTENT_COMPARISON_LIMITS, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, type FinalParagraphMarkRevision, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioBlockId, type FolioContentBlock, type FolioContentBlockProperty, type FolioContentComparison, type FolioContentComparisonError, type FolioContentComparisonEvent, type FolioContentComparisonLimit, FolioContentComparisonLimitError, type FolioContentContainerPathEntry, type FolioContentFormatRange, type FolioContentFormattingChange, type FolioContentIdStability, type FolioContentInlineBooleanProperty, type FolioContentInlineFormatting, type FolioContentInlineFormattingPatch, type FolioContentLineSpacingRule, type FolioContentParagraphAlignment, type FolioContentParagraphFormattingPatch, type FolioContentParagraphKind, type FolioContentParagraphSpacing, type FolioContentRun, type FolioContentSnapshot, type FolioContentStructuralChange, type FolioContentTableLocation, type FolioContentTextSegment, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioContentComparisonError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareContent, compareDocx, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, currentFolioBlockId, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/internal/paragraphFormattingSerialization.d.ts

@@ -0,0 +1,23 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/internal/paragraphFormattingSerialization.d.ts
+type ExhaustiveFields<Source, Classified extends keyof Source> = Exclude<keyof Source, Classified> extends never ? Source : never;
+type ParagraphNumberingReference = document_d_exports.ParagraphFormatting["numPr"] | null;
+type ClassifiedParagraphFormattingField = "alignment" | "bidi" | "kinsoku" | "overflowPunctuation" | "spaceBefore" | "spaceAfter" | "lineSpacing" | "lineSpacingRule" | "snapToGrid" | "beforeAutospacing" | "afterAutospacing" | "spacingExplicit" | "indentLeft" | "indentRight" | "indentFirstLine" | "hangingIndent" | "borders" | "shading" | "tabs" | "keepNext" | "keepLines" | "widowControl" | "pageBreakBefore" | "contextualSpacing" | "numPr" | "numPrFromStyle" | "outlineLevel" | "styleId" | "frame" | "suppressLineNumbers" | "suppressAutoHyphens" | "runProperties" | "runInWithNext";
+type ExhaustiveParagraphFormatting = ExhaustiveFields<document_d_exports.ParagraphFormatting, ClassifiedParagraphFormattingField>;
+/** Compare numbering references by their emitted id and effective level. */
+declare const paragraphNumberingReferencesEqual: (left: ParagraphNumberingReference, right: ParagraphNumberingReference) => boolean;
+/** Whether resolved numbering still belongs to the paragraph's style tier. */
+declare const isStyleSourcedParagraphNumbering: (numPr: ParagraphNumberingReference, numPrFromStyle: ParagraphNumberingReference) => boolean;
+/** Exact fallback-emission instructions for the modeled part of `w:pPr`. */
+type ModeledParagraphFormattingEmission = Readonly<{
+  propertiesXml?: string;
+  paragraphMarkPropertiesInnerXml?: string;
+}>;
+/**
+ * Resolve paragraph formatting into its exact fallback `w:pPr` instructions.
+ * Every input field is classified here so parser capture fingerprints and the
+ * serializer cannot drift apart when paragraph formatting grows.
+ */
+declare const modelParagraphFormattingEmission: (input: ExhaustiveParagraphFormatting | undefined) => ModeledParagraphFormattingEmission;
+//#endregion
+export { ModeledParagraphFormattingEmission, isStyleSourcedParagraphNumbering, modelParagraphFormattingEmission, paragraphNumberingReferencesEqual };

package/dist/internal/paragraphFormattingSerialization.js

@@ -0,0 +1,157 @@
+import { serializeBorder } from "../docx/serializer/borderSerializer.js";
+import { serializeShading, serializeTextFormatting } from "../docx/serializer/textFormattingSerializer.js";
+import { escapeXml, intAttr } from "../docx/serializer/xmlUtils.js";
+//#region src/internal/paragraphFormattingSerialization.ts
+const modelParagraphNumberingReference = (reference) => {
+	if (!reference) return null;
+	const { numId, ilvl } = reference;
+	return {
+		...numId !== void 0 ? { numId } : {},
+		...ilvl !== void 0 ? { ilvl } : {}
+	};
+};
+/** Compare numbering references by their emitted id and effective level. */
+const paragraphNumberingReferencesEqual = (left, right) => {
+	const modeledLeft = modelParagraphNumberingReference(left);
+	const modeledRight = modelParagraphNumberingReference(right);
+	if (modeledLeft === null || modeledRight === null) return modeledLeft === null && modeledRight === null;
+	return modeledLeft.numId === modeledRight.numId && (modeledLeft.ilvl ?? 0) === (modeledRight.ilvl ?? 0);
+};
+/** Whether resolved numbering still belongs to the paragraph's style tier. */
+const isStyleSourcedParagraphNumbering = (numPr, numPrFromStyle) => numPr != null && numPrFromStyle != null && paragraphNumberingReferencesEqual(numPr, numPrFromStyle);
+const serializeToggle = (name, value) => {
+	if (value === true) return `<w:${name}/>`;
+	if (value === false) return `<w:${name} w:val="0"/>`;
+	return "";
+};
+const serializeParagraphBorders = (borders) => {
+	if (!borders) return "";
+	const { top, left, bottom, right, between, bar } = borders;
+	const parts = [
+		serializeBorder(top, "top"),
+		serializeBorder(left, "left"),
+		serializeBorder(bottom, "bottom"),
+		serializeBorder(right, "right"),
+		serializeBorder(between, "between"),
+		serializeBorder(bar, "bar")
+	].filter(Boolean);
+	return parts.length === 0 ? "" : `<w:pBdr>${parts.join("")}</w:pBdr>`;
+};
+const serializeTabStops = (tabs) => {
+	if (!tabs || tabs.length === 0) return "";
+	return `<w:tabs>${tabs.map((tab) => {
+		const { alignment, position, leader } = tab;
+		const attrs = [`w:val="${alignment}"`, `w:pos="${intAttr(position)}"`];
+		if (leader && leader !== "none") attrs.push(`w:leader="${leader}"`);
+		return `<w:tab ${attrs.join(" ")}/>`;
+	}).join("")}</w:tabs>`;
+};
+const serializeSpacing = (formatting) => {
+	const attrs = [];
+	if (formatting.spaceBefore !== void 0) attrs.push(`w:before="${intAttr(formatting.spaceBefore)}"`);
+	if (formatting.spaceAfter !== void 0) attrs.push(`w:after="${intAttr(formatting.spaceAfter)}"`);
+	if (formatting.lineSpacing !== void 0) attrs.push(`w:line="${intAttr(formatting.lineSpacing)}"`);
+	if (formatting.lineSpacingRule) attrs.push(`w:lineRule="${formatting.lineSpacingRule}"`);
+	if (formatting.beforeAutospacing !== void 0) attrs.push(`w:beforeAutospacing="${formatting.beforeAutospacing ? "1" : "0"}"`);
+	if (formatting.afterAutospacing !== void 0) attrs.push(`w:afterAutospacing="${formatting.afterAutospacing ? "1" : "0"}"`);
+	return attrs.length === 0 ? "" : `<w:spacing ${attrs.join(" ")}/>`;
+};
+const serializeIndentation = (formatting) => {
+	const attrs = [];
+	if (formatting.indentLeft !== void 0) attrs.push(`w:left="${intAttr(formatting.indentLeft)}"`);
+	if (formatting.indentRight !== void 0) attrs.push(`w:right="${intAttr(formatting.indentRight)}"`);
+	if (formatting.indentFirstLine !== void 0) {
+		const attribute = formatting.hangingIndent ? "hanging" : "firstLine";
+		const value = formatting.hangingIndent ? Math.abs(formatting.indentFirstLine) : formatting.indentFirstLine;
+		attrs.push(`w:${attribute}="${intAttr(value)}"`);
+	}
+	return attrs.length === 0 ? "" : `<w:ind ${attrs.join(" ")}/>`;
+};
+const serializeNumbering = (numPr) => {
+	const modeled = modelParagraphNumberingReference(numPr ?? null);
+	if (!modeled) return "";
+	const parts = [];
+	if (modeled.ilvl !== void 0) parts.push(`<w:ilvl w:val="${intAttr(modeled.ilvl)}"/>`);
+	if (modeled.numId !== void 0) parts.push(`<w:numId w:val="${intAttr(modeled.numId)}"/>`);
+	return parts.length === 0 ? "" : `<w:numPr>${parts.join("")}</w:numPr>`;
+};
+const serializeFrameProperties = (frame) => {
+	if (!frame) return "";
+	const { dropCap, lines, width, height, hSpace, vSpace, hAnchor, vAnchor, x, y, xAlign, yAlign, wrap } = frame;
+	const attrs = [];
+	if (dropCap) attrs.push(`w:dropCap="${dropCap}"`);
+	if (lines !== void 0) attrs.push(`w:lines="${intAttr(lines)}"`);
+	if (width !== void 0) attrs.push(`w:w="${intAttr(width)}"`);
+	if (height !== void 0) attrs.push(`w:h="${intAttr(height)}"`);
+	if (hSpace !== void 0) attrs.push(`w:hSpace="${intAttr(hSpace)}"`);
+	if (vSpace !== void 0) attrs.push(`w:vSpace="${intAttr(vSpace)}"`);
+	if (hAnchor) attrs.push(`w:hAnchor="${hAnchor}"`);
+	if (vAnchor) attrs.push(`w:vAnchor="${vAnchor}"`);
+	if (x !== void 0) attrs.push(`w:x="${x}"`);
+	if (y !== void 0) attrs.push(`w:y="${y}"`);
+	if (xAlign) attrs.push(`w:xAlign="${xAlign}"`);
+	if (yAlign) attrs.push(`w:yAlign="${yAlign}"`);
+	if (wrap) attrs.push(`w:wrap="${wrap}"`);
+	return attrs.length === 0 ? "" : `<w:framePr ${attrs.join(" ")}/>`;
+};
+const modelSpacingProvenance = (spacingExplicit) => {
+	if (spacingExplicit) {
+		const { before: _before, after: _after } = spacingExplicit;
+	}
+};
+const extractRunPropertiesInnerXml = (runPropertiesXml) => {
+	if (!runPropertiesXml.startsWith("<w:rPr>") || !runPropertiesXml.endsWith("</w:rPr>")) return "";
+	return runPropertiesXml.slice(7, -8);
+};
+/**
+* Resolve paragraph formatting into its exact fallback `w:pPr` instructions.
+* Every input field is classified here so parser capture fingerprints and the
+* serializer cannot drift apart when paragraph formatting grows.
+*/
+const modelParagraphFormattingEmission = (input) => {
+	if (!input) return {};
+	const { alignment, bidi, kinsoku, overflowPunctuation, spaceBefore, spaceAfter, lineSpacing, lineSpacingRule, snapToGrid, beforeAutospacing, afterAutospacing, spacingExplicit, indentLeft, indentRight, indentFirstLine, hangingIndent, borders, shading, tabs, keepNext, keepLines, widowControl, pageBreakBefore, contextualSpacing, numPr, numPrFromStyle, outlineLevel, styleId, frame, suppressLineNumbers, suppressAutoHyphens, runProperties, runInWithNext } = input;
+	modelSpacingProvenance(spacingExplicit);
+	const propertiesXml = [
+		styleId ? `<w:pStyle w:val="${escapeXml(styleId)}"/>` : "",
+		serializeToggle("keepNext", keepNext),
+		serializeToggle("keepLines", keepLines),
+		serializeToggle("pageBreakBefore", pageBreakBefore),
+		serializeFrameProperties(frame),
+		serializeToggle("widowControl", widowControl),
+		isStyleSourcedParagraphNumbering(numPr, numPrFromStyle) ? "" : serializeNumbering(numPr),
+		serializeToggle("suppressLineNumbers", suppressLineNumbers),
+		serializeParagraphBorders(borders),
+		serializeShading(shading),
+		serializeTabStops(tabs),
+		serializeToggle("suppressAutoHyphens", suppressAutoHyphens),
+		serializeToggle("kinsoku", kinsoku),
+		serializeToggle("overflowPunct", overflowPunctuation),
+		serializeToggle("bidi", bidi),
+		serializeToggle("snapToGrid", snapToGrid),
+		serializeSpacing({
+			spaceBefore,
+			spaceAfter,
+			lineSpacing,
+			lineSpacingRule,
+			beforeAutospacing,
+			afterAutospacing
+		}),
+		serializeIndentation({
+			indentLeft,
+			indentRight,
+			indentFirstLine,
+			hangingIndent
+		}),
+		serializeToggle("contextualSpacing", contextualSpacing),
+		alignment ? `<w:jc w:val="${alignment}"/>` : "",
+		outlineLevel !== void 0 ? `<w:outlineLvl w:val="${outlineLevel}"/>` : ""
+	].join("");
+	const paragraphMarkPropertiesInnerXml = `${extractRunPropertiesInnerXml(serializeTextFormatting(runProperties))}${runInWithNext === true ? "<w:specVanish/>" : ""}`;
+	const emission = {};
+	if (propertiesXml) emission.propertiesXml = propertiesXml;
+	if (paragraphMarkPropertiesInnerXml) emission.paragraphMarkPropertiesInnerXml = paragraphMarkPropertiesInnerXml;
+	return emission;
+};
+//#endregion
+export { isStyleSourcedParagraphNumbering, modelParagraphFormattingEmission, paragraphNumberingReferencesEqual };

package/dist/prosemirror/attrs/index.js

@@ -2,6 +2,7 @@ import { EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FONT_HINT_VALUES, FONT_THEME_V
 import { normalizeHorizontalScalePercent } from "../../utils/horizontalScale.js";
 import { isParagraphDirection } from "../paragraphDirection.js";
 import { COMPLEX_SCRIPT_RUN_PROPERTY_KEYS, RUN_FORMATTING_BOOLEAN_PROPERTIES, RUN_FORMATTING_VALUE_PROPERTIES, TRACKED_CHANGE_PROVENANCE_VALUES } from "../schema/marks.js";
+import { TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES } from "../schema/nodes.js";
 import { panic } from "better-result";
 import { DRAWING_RAW_XML_MODES, isOoxmlSymbolCharacter } from "@stll/docx-core/model";
 //#region src/prosemirror/attrs/index.ts
@@ -540,6 +541,7 @@ const readTextBoxAttrs = (node) => {
 	optionalOneOf(attrs, "_docxPlacement", "textBox.attrs._docxPlacement", issues, TEXT_BOX_DOCX_PLACEMENTS);
 	optionalString(attrs, "_docxGroupId", "textBox.attrs._docxGroupId", issues);
 	optionalString(attrs, "_docxAnchorId", "textBox.attrs._docxAnchorId", issues);
+	requiredTextBoxBodyContentState(attrs, issues);
 	optionalTextBoxTrackedChange(attrs, issues);
 	optionalTextBoxInlineSdts(attrs, issues);
 	return attrsResult(attrs, issues);
@@ -1203,6 +1205,17 @@ const optionalTextBoxTrackedChange = (attrs, issues) => {
 	requiredString(info, "author", "textBox.attrs._docxTrackedChange.info.author", issues);
 	optionalString(info, "date", "textBox.attrs._docxTrackedChange.info.date", issues);
 };
+const requiredTextBoxBodyContentState = (attrs, issues) => {
+	const value = attrs["_docxTextBodyContentState"];
+	if (!isRecord(value)) {
+		issues.push({
+			path: "textBox.attrs._docxTextBodyContentState",
+			message: "Expected an object."
+		});
+		return;
+	}
+	requiredOneOf(value, "type", "textBox.attrs._docxTextBodyContentState.type", issues, TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES);
+};
 const optionalTextBoxInlineSdts = (attrs, issues) => {
 	const value = attrs["_docxInlineSdts"];
 	if (value === void 0 || value === null) return;

package/dist/prosemirror/conversion/fromProseDoc.js

@@ -1,8 +1,8 @@
-import { numPrEqual } from "../../docx/numberingParser.js";
 import { PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, ParagraphPropertySourceValidationError, copyDocumentParagraphPropertySourceContract, copyDocumentParagraphPropertySources, copyParagraphPropertyCapture, copyParagraphPropertySource, decodeTableCellParagraphSourcePayload, getDocumentParagraphPropertySourceContract, getParagraphPropertySource, getParagraphPropertySourceCandidate, getParagraphPropertySourceToken, getParagraphPropertySourceTransferId, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, isParagraphPropertySourceToken, linkParagraphPropertySourceCandidate, paragraphPropertySourceBelongsToDocument, paragraphPropertySourceTokenMatchesContract, recreateProseNodeWithParagraphPropertySource, restoreTableCellsWithParagraphPropertySources, visitDocumentStoryParagraphs, visitTableCellParagraphPropertySourceBindings } from "../../docx/paragraphPropertySource.js";
 import { visitDocxParagraphs } from "../../docx/paragraphTraversal.js";
 import { ShapeOutlineStyleSchema, narrowEnum } from "../../docx/parserEnums.js";
 import { DATE_UTC_ATTRIBUTE } from "../../docx/trackedChangeInfo.js";
+import { isStyleSourcedParagraphNumbering, modelParagraphFormattingEmission, paragraphNumberingReferencesEqual } from "../../internal/paragraphFormattingSerialization.js";
 import { createStyleEngine } from "../../style-engine/styleEngine.js";
 import { OUTLINE_STYLE_CSS_ALIASES, normalizeShapeTextAnchor } from "../../types/documentEnumValues.js";
 import { canonicalJson } from "../../utils/canonicalJson.js";
@@ -106,9 +106,10 @@ const uniqueParagraphsById = (content, includeTransferIds = false) => {
 const restoreParagraphPropertySource = (paragraph, baseParagraph) => {
 	copyParagraphPropertySource(paragraph, baseParagraph);
 	const baseFormatting = baseParagraph.formatting;
-	if (!baseFormatting?.numPr || !baseFormatting.numPrFromStyle || !numPrEqual(baseFormatting.numPr, baseFormatting.numPrFromStyle)) return;
-	const { numPr, numPrFromStyle, ...authoredFormatting } = baseFormatting;
-	if (canonicalJson(paragraph.formatting ?? {}) !== canonicalJson(authoredFormatting)) return;
+	if (!baseFormatting) return;
+	const { numPr, numPrFromStyle } = baseFormatting;
+	if (!numPr || !numPrFromStyle || !isStyleSourcedParagraphNumbering(numPr, numPrFromStyle)) return;
+	if (canonicalJson(modelParagraphFormattingEmission(paragraph.formatting)) !== canonicalJson(modelParagraphFormattingEmission(baseFormatting))) return;
 	paragraph.formatting = {
 		...paragraph.formatting,
 		numPr,
@@ -777,15 +778,6 @@ const propertyChangeFromAttrs = (change) => {
 		...currentFormatting !== void 0 && { currentFormatting }
 	};
 };
-/**
-* Whether the paragraph's numbering still comes verbatim from its style —
-* serialize no direct `<w:numPr>` then. The moment a list command changes
-* `numPr` the values diverge and the numbering serializes as direct
-* formatting, so a stale provenance value can never swallow a user edit.
-*/
-function isStyleSourcedNumPr(attrs) {
-	return attrs.numPrFromStyle != null && attrs.numPr != null && numPrEqual(attrs.numPr, attrs.numPrFromStyle);
-}
 function assignBooleanToggle(result, attrs, orig, key) {
 	const value = attrs[key] ?? void 0;
 	if (value === (orig[key] ?? void 0)) return;
@@ -834,10 +826,10 @@ function paragraphAttrsToFormatting(attrs) {
 		else Reflect.deleteProperty(result, "lineSpacingRule");
 		if (directAlignment === void 0) Reflect.deleteProperty(result, "alignment");
 		else result.alignment = directAlignment;
-		if (isStyleSourcedNumPr(attrs)) {
+		if (isStyleSourcedParagraphNumbering(attrs.numPr, attrs.numPrFromStyle)) {
 			delete result.numPr;
 			delete result.numPrFromStyle;
-		} else if (attrs.numPr !== orig.numPr && !numPrEqual(attrs.numPr, orig.numPr)) {
+		} else if (attrs.numPr !== orig.numPr && !paragraphNumberingReferencesEqual(attrs.numPr, orig.numPr)) {
 			if (attrs.numPr) result.numPr = attrs.numPr;
 			else delete result.numPr;
 			delete result.numPrFromStyle;
@@ -874,7 +866,7 @@ function paragraphAttrsToFormatting(attrs) {
 	if (attrs.indentRight) f.indentRight = attrs.indentRight;
 	if (attrs.indentFirstLine) f.indentFirstLine = attrs.indentFirstLine;
 	if (attrs.hangingIndent) f.hangingIndent = attrs.hangingIndent;
-	if (attrs.numPr && !isStyleSourcedNumPr(attrs)) f.numPr = attrs.numPr;
+	if (attrs.numPr && !isStyleSourcedParagraphNumbering(attrs.numPr, attrs.numPrFromStyle)) f.numPr = attrs.numPr;
 	if (attrs.styleId) f.styleId = attrs.styleId;
 	if (attrs.borders) f.borders = attrs.borders;
 	if (attrs.shading) f.shading = attrs.shading;
@@ -2862,6 +2854,24 @@ function tableCellAttrsToFormatting(attrs) {
 	if (attrs.margins) f.margins = buildCellMarginsFromAttrs(attrs.margins);
 	return f;
 }
+const isUnchangedSourceEmptyPlaceholder = (blocks) => {
+	const paragraph = blocks.at(0);
+	if (blocks.length !== 1 || paragraph?.type !== "paragraph" || paragraph.content.length !== 0) return false;
+	return Object.keys(paragraph).every((key) => key === "type" || key === "content" || key === "paraId" || key === "textId");
+};
+const projectTextBoxBodyContent = (state, blocks) => {
+	switch (state.type) {
+		case "source-empty": return isUnchangedSourceEmptyPlaceholder(blocks) ? { type: "source-empty" } : {
+			type: "authored",
+			content: blocks
+		};
+		case "authored": return {
+			type: "authored",
+			content: blocks
+		};
+		default: return state;
+	}
+};
 /**
 * Convert a ProseMirror textBox node back to a Paragraph wrapping a ShapeContent run.
 * The text box content becomes a Shape with textBody.
@@ -2874,6 +2884,7 @@ function convertPMTextBox(node, styleResolver = null) {
 		if (child.type.name === "paragraph") childBlocks.push(convertPMParagraph(child, void 0, void 0, styleResolver));
 		else if (child.type.name === "table") childBlocks.push(convertPMTable(child, void 0, styleResolver));
 	});
+	const textBodyContent = projectTextBoxBodyContent(attrs._docxTextBodyContentState, childBlocks);
 	const shape = {
 		type: "shape",
 		shapeType: "textBox",
@@ -2882,10 +2893,7 @@ function convertPMTextBox(node, styleResolver = null) {
 			height: attrs.height ? pixelsToEmu(attrs.height) : 0
 		},
 		textBody: {
-			content: childBlocks.length > 0 ? childBlocks : [{
-				type: "paragraph",
-				content: []
-			}],
+			content: textBodyContent.type === "source-empty" ? [] : textBodyContent.content,
 			...attrs.autoFit !== void 0 ? { autoFit: attrs.autoFit } : {},
 			...attrs.textWrap !== void 0 ? { textWrap: attrs.textWrap } : {},
 			...verticalAlign !== void 0 ? { anchor: verticalAlign } : {},

package/dist/prosemirror/conversion/toProseDoc.js

@@ -2259,6 +2259,7 @@ function convertTextBox(textBox, styleResolver, options) {
 		_docxPlacement: options.placement,
 		_docxGroupId: options.groupId,
 		_docxAnchorId: options.anchorId,
+		_docxTextBodyContentState: textBox.content.length === 0 ? { type: "source-empty" } : { type: "authored" },
 		_docxTrackedChange: options.trackedChange,
 		_docxInlineSdts: options.inlineSdts.length > 0 ? options.inlineSdts : void 0
 	}, contentNodes);

package/dist/prosemirror/extensions/nodes/TextBoxExtension.d.ts

@@ -1,68 +1,7 @@
-import { document_d_exports } from "../../../types/document.js";
-import { OutlineStyleAttr } from "../../../types/documentEnumValues.js";
-import { ImagePositionAttrs, TextBoxAttrs as TextBoxAttrs$1 } from "../../schema/nodes.js";
+import { TextBoxAttrs as TextBoxAttrs$1 } from "../../schema/nodes.js";
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/TextBoxExtension.d.ts
-type TextBoxAttrs = {
-  /** Width in pixels */
-  width?: number;
-  /** Height in pixels */
-  height?: number;
-  /** Text fitting behavior */
-  autoFit?: document_d_exports.ShapeTextBody["autoFit"];
-  /** Horizontal text wrapping inside the box */
-  textWrap?: document_d_exports.ShapeTextBody["textWrap"];
-  /** Unique identifier */
-  textBoxId?: string;
-  /** Fill color as CSS color */
-  fillColor?: string;
-  /** Outline width in pixels */
-  outlineWidth?: number;
-  /** Outline color as CSS color */
-  outlineColor?: string;
-  /** Outline dash style, or `"none"` for an explicit no-outline. */
-  outlineStyle?: OutlineStyleAttr;
-  /** DrawingML rotation and/or flips, serialized as CSS transform functions. */
-  transform?: string;
-  /** Internal margin top in pixels */
-  marginTop?: number;
-  /** Internal margin bottom in pixels */
-  marginBottom?: number;
-  /** Internal margin left in pixels */
-  marginLeft?: number;
-  /** Internal margin right in pixels */
-  marginRight?: number;
-  /** Vertical text alignment */
-  verticalAlign?: string;
-  /** Display mode */
-  displayMode?: "inline" | "float" | "block";
-  /** CSS float direction */
-  cssFloat?: "left" | "right" | "none";
-  /** Wrap type */
-  wrapType?: document_d_exports.ImageWrap["type"];
-  /** OOXML wrapText direction for anchored text boxes (eigenpal #474). */
-  wrapText?: "bothSides" | "left" | "right" | "largest";
-  /** Wrap distance from top edge, in pixels (OOXML distT, EMU-converted). */
-  distTop?: number;
-  /** Wrap distance from bottom edge, in pixels. */
-  distBottom?: number;
-  /** Wrap distance from left edge, in pixels. */
-  distLeft?: number;
-  /** Wrap distance from right edge, in pixels. */
-  distRight?: number;
-  /** Position for floating/anchored text boxes. */
-  position?: ImagePositionAttrs;
-  /** Original DOCX placement hint for save-path reconstruction. */
-  _docxPlacement?: "standalone" | "inlineWithPrevious";
-  /** Original DOCX paragraph group for standalone text-box reconstruction. */
-  _docxGroupId?: string;
-  /** Inline anchor linking this block node to its source run position. */
-  _docxAnchorId?: string;
-  /** Original run-level revision wrapper for save-path reconstruction. */
-  _docxTrackedChange?: TextBoxAttrs$1["_docxTrackedChange"];
-  /** Original inline content-control ancestry for save-path reconstruction. */
-  _docxInlineSdts?: TextBoxAttrs$1["_docxInlineSdts"];
-};
+type TextBoxAttrs = TextBoxAttrs$1;
 declare const TextBoxExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
 //#endregion
 export { TextBoxAttrs, TextBoxExtension };

package/dist/prosemirror/extensions/nodes/TextBoxExtension.js

@@ -2,6 +2,13 @@ import { IMAGE_WRAP_TYPE_VALUES, normalizeShapeTextAnchor } from "../../../types
 import { expectTextBoxAttrs } from "../../attrs/index.js";
 import { createNodeExtension } from "../create.js";
 //#region src/prosemirror/extensions/nodes/TextBoxExtension.ts
+/**
+* TextBox Extension — editable text box node
+*
+* An isolating block node that contains paragraphs (and tables).
+* Rendered as a positioned container with optional fill, outline, and margins.
+* Supports inline and floating positioning.
+*/
 function parseTextBoxPosition(raw) {
 	if (!raw) return;
 	try {
@@ -60,6 +67,7 @@ const TextBoxExtension = createNodeExtension({
 			_docxPlacement: { default: null },
 			_docxGroupId: { default: null },
 			_docxAnchorId: { default: null },
+			_docxTextBodyContentState: { default: { type: "authored" } },
 			_docxTrackedChange: { default: null },
 			_docxInlineSdts: { default: null }
 		},
@@ -74,6 +82,7 @@ const TextBoxExtension = createNodeExtension({
 				const textWrap = parseTextBoxTextWrap(d["textWrap"]);
 				const verticalAlign = parseTextBoxVerticalAlign(d["verticalAlign"]);
 				return {
+					_docxTextBodyContentState: { type: "authored" },
 					...d["width"] ? { width: Number(d["width"]) } : {},
 					...d["height"] ? { height: Number(d["height"]) } : {},
 					...autoFit ? { autoFit } : {},