@stll/folio-core 0.37.3 → 0.37.4

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

@@ -2862,6 +2862,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 +2892,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 +2901,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 } : {},

package/dist/prosemirror/schema/nodes.d.ts

@@ -488,6 +488,10 @@ type ShapeAttrs = {
 /**
  * Text box node attributes
  */
+declare const TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES: readonly ["source-empty", "authored"];
+type TextBoxTextBodyContentState = { [Type in (typeof TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES)[number]]: {
+  readonly type: Type;
+}; }[(typeof TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES)[number]];
 type TextBoxAttrs = {
   /** Width in pixels */
   width?: number;
@@ -543,6 +547,12 @@ type TextBoxAttrs = {
   _docxGroupId?: string;
   /** Inline anchor linking this block node to its source run position. */
   _docxAnchorId?: string;
+  /**
+   * Ownership of the schema-required placeholder paragraph. A source text
+   * body with no children needs one paragraph while it is editable, but that
+   * paragraph is not authored document content.
+   */
+  _docxTextBodyContentState: TextBoxTextBodyContentState;
   /** Original run-level revision wrapper for save-path reconstruction. */
   _docxTrackedChange?: {
     type: "insertion";
@@ -770,4 +780,4 @@ type TableCellAttrs = {
   _docxVMergeContinuationCells?: unknown;
 };
 //#endregion
-export { BlockSdtAttrs, BookmarkBoundaryAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, PageBreakRunAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs };
+export { BlockSdtAttrs, BookmarkBoundaryAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, PageBreakRunAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs, TextBoxTextBodyContentState };

package/dist/prosemirror/schema/nodes.js

@@ -0,0 +1,7 @@
+//#region src/prosemirror/schema/nodes.ts
+/**
+* Text box node attributes
+*/
+const TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES = Object.freeze(["source-empty", "authored"]);
+//#endregion
+export { TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.37.3",
+  "version": "0.37.4",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",