@docen/docx 0.3.3 → 0.3.5

package/dist/blockquote-DY80QC06.d.mts

@@ -0,0 +1,21 @@
+//#region src/extensions/blockquote.d.ts
+/**
+ * Blockquote extension — owns the DOCX expression of a blockquote.
+ *
+ * DOCX has no blockquote element; the convention is a left indent plus a left
+ * border on each contained paragraph. This module owns that signature; the
+ * DocxManager walks the blockquote's child paragraphs and applies it to each.
+ */
+/** Left indent (twips, ~0.5 inch) marking a blockquote. */
+declare const BLOCKQUOTE_INDENT_LEFT = 720;
+/** Left border marking a blockquote. */
+declare const BLOCKQUOTE_BORDER: {
+  readonly style: "single";
+  readonly size: 18;
+  readonly space: 12;
+  readonly color: "CCCCCC";
+};
+/** Apply the blockquote signature (left indent + left border) to paragraph opts. */
+declare function applyBlockquoteStyle(paraObj: Record<string, unknown>): void;
+//#endregion
+export { BLOCKQUOTE_INDENT_LEFT as n, applyBlockquoteStyle as r, BLOCKQUOTE_BORDER as t };

package/dist/bullet-list-DF60pnSL.d.mts

@@ -0,0 +1,12 @@
+//#region src/extensions/bullet-list.d.ts
+/**
+ * BulletList — carries the source DOCX abstractNum reference (when the list came
+ * from parseDOCX) so the round-trip reuses the original numbering definition
+ * (custom bullet glyph/font/indent, e.g. a Wingdings marker) instead of
+ * regenerating the default. The `numbering` attr is DOCX-only (not rendered
+ * to HTML); lists created in the editor carry null and compile to the default
+ * bullet.
+ */
+declare const BulletList: import("@tiptap/core").Node<import("@tiptap/extension-bullet-list").BulletListOptions, any>;
+//#endregion
+export { BulletList as t };

package/dist/converters/docx.d.mts

@@ -1,4 +1,4 @@
-import { a as JSONContent } from "../core-DRaLI8nd.mjs";
+import { a as JSONContent } from "../core-DC0_-WcE.mjs";
 import { PrepareStep } from "./prepare.mjs";
 import { DocumentOptions, OutputByType, OutputType, PackerOptions, parseDocument } from "@office-open/docx";
 

package/dist/converters/docx.mjs

@@ -120,13 +120,16 @@ var DocxManager = class {
 		const core = docAttrs.core ?? void 0;
 		const background = docAttrs.background ?? void 0;
 		const documentExtras = docAttrs.documentExtras ?? void 0;
+		const origNumberingConfig = docAttrs.numbering?.config ?? [];
+		const regeneratedRefs = new Set(this.numberingConfigs.map((c) => c.reference));
+		const numberingConfig = [...origNumberingConfig.filter((c) => !regeneratedRefs.has(c.reference)), ...this.numberingConfigs];
 		return {
 			sections,
 			...styles ? { styles } : {},
 			...core,
 			...background ? { background } : {},
 			...documentExtras,
-			...this.numberingConfigs.length > 0 ? { numbering: { config: this.numberingConfigs } } : {}
+			...numberingConfig.length > 0 ? { numbering: { config: numberingConfig } } : {}
 		};
 	}
 	/** Assemble a SectionOptions from compiled children + optional layout/headers/footers. */
@@ -218,6 +221,7 @@ var DocxManager = class {
 		const attrs = {};
 		if (docOpts.styles) attrs.styles = docOpts.styles;
 		if (docOpts.background) attrs.background = docOpts.background;
+		if (docOpts.numbering) attrs.numbering = docOpts.numbering;
 		const core = extractCoreProperties(docOpts);
 		if (core) attrs.core = core;
 		const lastSection = sections[lastIndex];
@@ -339,6 +343,7 @@ var DocxManager = class {
 					compiledCells.push({
 						verticalMerge: "continue",
 						columnSpan: span.colspan,
+						...span.borders ? { borders: span.borders } : {},
 						children: [{ paragraph: "" }]
 					});
 					colIdx += span.colspan;
@@ -353,7 +358,8 @@ var DocxManager = class {
 						newSpans.push({
 							colStart: colIdx,
 							colspan: cs,
-							remainingRows: rs - 1
+							remainingRows: rs - 1,
+							borders: cell.borders
 						});
 					}
 					compiledCells.push(cell);
@@ -458,15 +464,20 @@ var DocxManager = class {
 		const items = [];
 		const isOrdered = node.type === "orderedList";
 		const isTask = node.type === "taskList";
+		const numbering = node.attrs?.numbering;
 		let ordered;
-		if (isOrdered) ordered = this.registerOrderedNumbering(node);
+		if (isOrdered && !numbering) ordered = this.registerOrderedNumbering(node);
 		for (const listItem of node.content ?? []) {
 			if (listItem.type !== "listItem" && listItem.type !== "taskItem") continue;
 			const checked = Boolean(listItem.attrs?.checked);
 			for (const child of listItem.content ?? []) if (child.type === "paragraph" || child.type === "heading") {
 				const para = child.type === "heading" ? this.compileHeadingNode(child) : this.compileParagraphNode(child);
 				const paraObj = typeof para === "string" ? { text: para } : para;
-				if (ordered) paraObj.numbering = {
+				if (numbering) paraObj.numbering = {
+					reference: numbering,
+					level
+				};
+				else if (ordered) paraObj.numbering = {
 					reference: ordered.reference,
 					instance: ordered.instance,
 					level
@@ -559,6 +570,17 @@ var DocxManager = class {
 			case "columnBreak":
 				children.push({ columnBreak: true });
 				break;
+			case "tab":
+				children.push({ tab: true });
+				break;
+			case "inlinePassthrough": {
+				const data = node.attrs?.data ?? "{}";
+				try {
+					const parsed = JSON.parse(data);
+					if (parsed) children.push(parsed);
+				} catch {}
+				break;
+			}
 			case "image": {
 				const imageRun = renderDocx$2(node);
 				if (imageRun) children.push(imageRun);
@@ -570,8 +592,18 @@ var DocxManager = class {
 				break;
 			}
 			case "wpsShape": {
-				const wpsShape = node.attrs?.wpsShape;
-				if (wpsShape) children.push({ wpsShape });
+				const geometry = node.attrs?.wpsShape ?? {};
+				const body = [];
+				for (const child of node.content ?? []) {
+					const compiled = this.compileSectionChild(child);
+					if (!compiled) continue;
+					const items = Array.isArray(compiled) ? compiled : [compiled];
+					for (const it of items) if (it && typeof it === "object" && "paragraph" in it) body.push(it.paragraph);
+				}
+				children.push({ wpsShape: {
+					...geometry,
+					children: body
+				} });
 				break;
 			}
 			case "mention":
@@ -858,10 +890,7 @@ var DocxManager = class {
 			if (cfg && cfg.format && cfg.format !== "bullet") {
 				kind = "ordered";
 				start = cfg.start;
-			} else {
-				kind = "bullet";
-				reference = void 0;
-			}
+			} else kind = "bullet";
 		} else if (bullet) {
 			kind = "bullet";
 			level = bullet.level ?? 0;
@@ -910,7 +939,10 @@ var DocxManager = class {
 					type: listType,
 					content: [newItem]
 				};
-				if (listType === "orderedList" && info.level === 0 && typeof info.start === "number" && info.start !== 1) newList.attrs = { start: info.start };
+				const listAttrs = {};
+				if (listType === "orderedList" && info.level === 0 && typeof info.start === "number" && info.start !== 1) listAttrs.start = info.start;
+				if (info.reference) listAttrs.numbering = info.reference;
+				if (Object.keys(listAttrs).length > 0) newList.attrs = listAttrs;
 				if (top) top.currentItem.content.push(newList);
 				else topLevel.push(newList);
 				stack.push({
@@ -1136,21 +1168,55 @@ var DocxManager = class {
 		return nodes;
 	}
 	resolveParagraphChild(child) {
+		if ("tab" in child) return { type: "tab" };
 		if ("text" in child || "children" in child || "break" in child) return this.resolveRun(child);
 		if ("image" in child) return this.resolveImage(child.image);
 		if ("wpgGroup" in child) return {
 			type: "wpgGroup",
 			attrs: { wpgGroup: child.wpgGroup }
 		};
-		if ("wpsShape" in child) return {
-			type: "wpsShape",
-			attrs: { wpsShape: child.wpsShape }
-		};
+		if ("wpsShape" in child) {
+			const ws = child.wpsShape;
+			const content = [];
+			if (ws?.children) for (const para of ws.children) {
+				if (typeof para !== "object" || para === null) {
+					const node = this.resolveParagraph(para);
+					if (node) content.push(node);
+					continue;
+				}
+				const defRPr = para.run ?? {};
+				const children = Array.isArray(para.children) ? para.children.map((c) => typeof c !== "object" || c === null ? {
+					...defRPr,
+					text: c
+				} : {
+					...defRPr,
+					...c
+				}) : void 0;
+				const node = this.resolveParagraph({
+					...para,
+					run: void 0,
+					...children ? { children } : {}
+				});
+				if (node) content.push(node);
+			}
+			if (content.length === 0) content.push({ type: "paragraph" });
+			const { children: _omit, ...geometry } = ws ?? {};
+			const node = {
+				type: "wpsShape",
+				content
+			};
+			const cleanGeometry = cleanAttrs(geometry);
+			if (Object.keys(cleanGeometry).length > 0) node.attrs = { wpsShape: cleanGeometry };
+			return node;
+		}
 		if ("sdt" in child) return this.resolveInlineSdt(child);
 		if ("hyperlink" in child) return this.resolveHyperlink(child.hyperlink);
 		if ("pageBreak" in child) return { type: "pageBreak" };
 		if ("columnBreak" in child) return { type: "columnBreak" };
-		return null;
+		return {
+			type: "inlinePassthrough",
+			attrs: { data: JSON.stringify(child) }
+		};
 	}
 	/** Resolve an inline SDT (mention carrier; other inline SDTs unsupported). */
 	resolveInlineSdt(child) {
@@ -1170,15 +1236,48 @@ var DocxManager = class {
 		if (opts.break && opts.text === void 0 && !opts.children) return { type: "hardBreak" };
 		const text = opts.text;
 		if (text === void 0 && !opts.children) return null;
-		if (opts.children && !text) {
-			const parts = [];
-			for (const c of opts.children) if (typeof c === "string") parts.push(c);
-			if (parts.length === 0) return null;
-			return {
-				type: "text",
-				text: parts.join(""),
-				marks: this.resolveMarks(opts)
+		if (opts.children) {
+			const marks = this.resolveMarks(opts);
+			const nodes = [];
+			let parts = [];
+			const flushText = () => {
+				if (parts.length > 0) {
+					const node = {
+						type: "text",
+						text: parts.join("")
+					};
+					if (marks) node.marks = marks;
+					nodes.push(node);
+					parts = [];
+				}
 			};
+			for (const c of opts.children) if (typeof c === "string") parts.push(c);
+			else if (c && typeof c === "object") {
+				if ("pageBreak" in c) {
+					flushText();
+					nodes.push({ type: "pageBreak" });
+				} else if ("columnBreak" in c) {
+					flushText();
+					nodes.push({ type: "columnBreak" });
+				} else if ("break" in c) {
+					flushText();
+					nodes.push({ type: "hardBreak" });
+				} else if ("tab" in c) {
+					flushText();
+					nodes.push({ type: "tab" });
+				}
+			}
+			flushText();
+			if (text !== void 0) {
+				const node = {
+					type: "text",
+					text,
+					marks
+				};
+				nodes.push(node);
+			}
+			if (nodes.length === 0) return null;
+			return nodes.length === 1 ? nodes[0] : nodes;
 		}
 		return {
 			type: "text",
@@ -1236,7 +1335,7 @@ var DocxManager = class {
 				type: "link",
 				attrs: {
 					href,
-					target: "_blank",
+					target: href.startsWith("#") ? null : "_blank",
 					rel: "noopener noreferrer nofollow",
 					class: null,
 					title: hyperlink.tooltip ?? null

package/dist/converters/html.d.mts

@@ -1,4 +1,4 @@
-import { a as JSONContent, i as Extensions } from "../core-DRaLI8nd.mjs";
+import { a as JSONContent, i as Extensions } from "../core-DC0_-WcE.mjs";
 import { ParseOptions } from "@tiptap/pm/model";
 
 //#region src/converters/html.d.ts

package/dist/converters/html.mjs

@@ -1,4 +1,4 @@
-import { s as docxExtensions } from "../core-B8ba_FNi.mjs";
+import { o as docxExtensions } from "../core-BnF8XhVE.mjs";
 import { sectionLinePitchCss, sectionMarginCss } from "../extensions/utils.mjs";
 import { getSchema } from "@tiptap/core";
 import { encodeBase64 } from "@office-open/core";

package/dist/converters/markdown.d.mts

@@ -1,4 +1,4 @@
-import { a as JSONContent } from "../core-DRaLI8nd.mjs";
+import { a as JSONContent } from "../core-DC0_-WcE.mjs";
 
 //#region src/converters/markdown.d.ts
 /**

package/dist/converters/markdown.mjs

@@ -1,4 +1,4 @@
-import { s as docxExtensions } from "../core-B8ba_FNi.mjs";
+import { o as docxExtensions } from "../core-BnF8XhVE.mjs";
 import { Markdown, MarkdownManager } from "@tiptap/markdown";
 //#region src/converters/markdown.ts
 const markdownManager = new MarkdownManager({ extensions: [...docxExtensions, Markdown] });

package/dist/converters/patch.d.mts

@@ -1,4 +1,4 @@
-import { a as JSONContent } from "../core-DRaLI8nd.mjs";
+import { a as JSONContent } from "../core-DC0_-WcE.mjs";
 import { PrepareStep } from "./prepare.mjs";
 import { OutputByType, OutputType, patchDocument } from "@office-open/docx";
 

package/dist/converters/prepare.d.mts

@@ -1,4 +1,4 @@
-import { a as JSONContent } from "../core-DRaLI8nd.mjs";
+import { a as JSONContent } from "../core-DC0_-WcE.mjs";
 
 //#region src/converters/prepare.d.ts
 /**

package/dist/converters/prepare.mjs

@@ -67,15 +67,12 @@ async function prepareDocument(json, steps = DEFAULT_STEPS) {
 }
 async function toDataUrl(src, handler) {
 	const data = await handler(src);
-	return `data:${{
-		jpg: "image/jpeg",
-		jpeg: "image/jpeg",
-		png: "image/png",
-		gif: "image/gif",
-		bmp: "image/bmp",
-		svg: "image/svg+xml",
-		webp: "image/webp"
-	}[src.split(".").pop()?.toLowerCase() ?? "png"] ?? "image/png"};base64,${encodeBase64(data)}`;
+	let mime = "image/png";
+	try {
+		const type = imageMeta(data).type;
+		if (type) mime = type === "jpg" ? "image/jpeg" : `image/${type}`;
+	} catch {}
+	return `data:${mime};base64,${encodeBase64(data)}`;
 }
 async function walkImages(node, handler) {
 	if (node.type === "image" && node.attrs) {

package/dist/{core-B8ba_FNi.mjs → core-BnF8XhVE.mjs}

@@ -1,13 +1,15 @@
-import { Blockquote, Bold, BulletList, Code, CodeBlockLowlight, Details, DetailsContent, DetailsSummary, Emoji, HardBreak, Highlight, HorizontalRule, Italic, Link, ListItem, Mathematics, Mention, OrderedList, Subscript, Superscript, TaskItem, TaskList, Text, TextAlign as TextAlign$1, Underline } from "./extensions/tiptap.mjs";
+import { Blockquote, Bold, Code, CodeBlockLowlight, Details, DetailsContent, DetailsSummary, Emoji, HardBreak, Highlight, HorizontalRule, Italic, ListItem, Mathematics, Mention, Subscript, Superscript, TaskItem, TaskList, Text, TextAlign, Underline } from "./extensions/tiptap.mjs";
 import "./extensions/blockquote.mjs";
+import { BulletList } from "./extensions/bullet-list.mjs";
 import { CodeBlock } from "./extensions/code-block.mjs";
 import "./extensions/details.mjs";
 import { attrNative, floatAnchorScope, floatingToStyles, normalizeColorToHex, renderRunStyles } from "./extensions/utils.mjs";
 import { Document } from "./extensions/document.mjs";
 import { Heading } from "./extensions/heading.mjs";
 import { Image } from "./extensions/image.mjs";
+import { Link } from "./extensions/link.mjs";
 import "./extensions/mention.mjs";
-import "./extensions/ordered-list.mjs";
+import { OrderedList } from "./extensions/ordered-list.mjs";
 import { Paragraph } from "./extensions/paragraph.mjs";
 import { Strike } from "./extensions/strike.mjs";
 import { Table } from "./extensions/table.mjs";
@@ -18,7 +20,6 @@ import "./extensions/task-item.mjs";
 import { TextStyle } from "./extensions/text-style.mjs";
 import { Editor, Extension, Mark, Node } from "@tiptap/core";
 import { all, createLowlight } from "lowlight";
-import { TextAlign } from "@tiptap/extension-text-align";
 import { Plugin, PluginKey, TextSelection } from "@tiptap/pm/state";
 import { Decoration, DecorationSet } from "@tiptap/pm/view";
 import { convertEmuToPixels, encodeBase64 } from "@office-open/core";
@@ -277,6 +278,46 @@ const Passthrough = Node.create({
 		];
 	}
 });
+/**
+* InlinePassthrough — inline atom carrying an opaque inline ParagraphChild that
+* has no native Tiptap representation (bookmarkStart/End, comment range markers,
+* proofErr, track-change markers, …). The full ParagraphChild rides in
+* `attrs.data` as JSON so DOCX→JSON→DOCX round-trips byte-faithful; the atom is
+* zero-width (bookmark/range markers carry no layout box), matching Word's
+* non-printing metadata. Mirrors the block-level Passthrough for inline children.
+*/
+const InlinePassthrough = Node.create({
+	name: "inlinePassthrough",
+	group: "inline",
+	inline: true,
+	atom: true,
+	addAttributes() {
+		return { data: {
+			default: "{}",
+			rendered: false,
+			parseHTML: (element) => element.getAttribute("data-inline-passthrough") ?? "{}"
+		} };
+	},
+	parseHTML() {
+		return [{ tag: "span[data-inline-passthrough]" }];
+	},
+	renderHTML({ node }) {
+		const data = node.attrs.data || "{}";
+		let bookmarkName;
+		try {
+			bookmarkName = JSON.parse(data).bookmarkStart?.name;
+		} catch {}
+		const attrs = {
+			"data-inline-passthrough": data,
+			contenteditable: "false"
+		};
+		if (bookmarkName) {
+			attrs.id = bookmarkName;
+			attrs.style = "display:inline-block;width:0;height:0;overflow:hidden;vertical-align:baseline";
+		} else attrs.style = "display:none";
+		return ["span", attrs];
+	}
+});
 //#endregion
 //#region src/extensions/section-break.ts
 /**
@@ -342,6 +383,35 @@ const SectionBreak = Extension.create({
 	}
 });
 //#endregion
+//#region src/extensions/tab.ts
+/**
+* Tab — an inline atom representing a DOCX `<w:r><w:tab/></w:r>` tab character.
+*
+* office-open parses `<w:tab/>` as `{ tab: true }` inside a run's children. The
+* resolve path turns that into this node so the tab is not lost: previously
+* `<w:tab/>` was dropped, which let `mergeTextNodes` collapse a TOC entry's title
+* and page number into adjacent text (no leader, no right alignment). The node is
+* zero-width, non-editable, and carries no text height — measure skips it the
+* same way it skips other inline atoms, so pagination is unaffected. It only
+* marks where a tab leader (e.g. a TOC's dotted leader) renders. compile turns it
+* back into `{ tab: true }`.
+*/
+const Tab = Node.create({
+	name: "tab",
+	group: "inline",
+	inline: true,
+	atom: true,
+	parseHTML() {
+		return [{ tag: "span.docx-tab" }];
+	},
+	renderHTML() {
+		return ["span", {
+			class: "docx-tab",
+			contenteditable: "false"
+		}];
+	}
+});
+//#endregion
 //#region src/extensions/toc-field.ts
 /**
 * TOC field (`tocField`) — a block container representing a DOCX table of
@@ -499,6 +569,35 @@ function renderWpsText(children) {
 		];
 	});
 }
+/** Inner style of a wps text-box: fill + outline + textbox insets (padding).
+*  Lives on the contentDOM (the editable interior). Never carries rotation or
+*  writing-mode — those go on the outer positioning wrapper (see
+*  wpsRotationVert), because transform/writing-mode on an editable region
+*  distort the caret rect and break CJK IME composition. */
+function wpsInnerStyle(data) {
+	const parts = [];
+	const fill = fillToCss(data.fill);
+	if (fill) parts.push(`background-color:${fill}`);
+	const outline = outlineToCss(data.outline);
+	if (outline) parts.push(outline);
+	const bp = data.bodyProperties;
+	if (bp) {
+		const ins = (v) => v != null ? `${(v / EMU_PER_PX).toFixed(1)}px` : "0px";
+		parts.push(`padding:${ins(bp.tIns)} ${ins(bp.rIns)} ${ins(bp.bIns)} ${ins(bp.lIns)}`);
+	}
+	return parts.join(";");
+}
+/** Rotation + writing-mode (text direction) for a wps shape. Lives on the
+*  positioning wrapper OUTSIDE the contentDOM. `rotationOverride` covers a
+*  group child whose rotation comes from the group transform, not bodyPr. */
+function wpsRotationVert(data, rotationOverride) {
+	const parts = [];
+	const rotation = rotationOverride ?? data.bodyProperties?.rotation;
+	if (rotation) parts.push(`transform:rotate(${rotation}deg)`);
+	const vert = data.bodyProperties?.vert;
+	if (vert && vert !== "horz") parts.push(`writing-mode:${vert === "vert270" ? "vertical-lr" : "vertical-rl"}`);
+	return parts.join(";");
+}
 /**
 * Render a wps shape's interior (fill/outline/insets/rotation/writing-mode + text
 * body) as a positioned div. Shared by the wpg group's inline wps children and
@@ -507,23 +606,18 @@ function renderWpsText(children) {
 * carries the placement — absolute group coords for a group child, the floating
 * anchor CSS for a standalone shape. `opts.rotation` overrides bodyPr rotation
 * (a group child's rotation may come from the group transform, not bodyPr).
+*
+* The wpg path merges placement + interior into ONE div (an atom has no
+* contentDOM, so rotation/writing-mode on the element is safe — no caret inside).
+* The editable wpsShape node instead splits these across two elements via
+* wpsShapeStyles (outer = position+rotation+vert, inner = contentDOM).
 */
 function renderWpsInterior(data, positionStyle, opts) {
-	const styles = [positionStyle];
-	const fill = fillToCss(data.fill);
-	if (fill) styles.push(`background-color:${fill}`);
-	const outline = outlineToCss(data.outline);
-	if (outline) styles.push(outline);
-	const bp = data.bodyProperties;
-	if (bp) {
-		const ins = (v) => v != null ? `${(v / EMU_PER_PX).toFixed(1)}px` : "0px";
-		styles.push(`padding:${ins(bp.tIns)} ${ins(bp.rIns)} ${ins(bp.bIns)} ${ins(bp.lIns)}`);
-	}
-	const rotation = opts?.rotation ?? bp?.rotation;
-	if (rotation) styles.push(`transform:rotate(${rotation}deg)`);
-	const vert = bp?.vert;
-	if (vert && vert !== "horz") styles.push(`writing-mode:${vert === "vert270" ? "vertical-lr" : "vertical-rl"}`);
-	const attrs = { style: styles.join(";") };
+	const attrs = { style: [
+		positionStyle,
+		wpsInnerStyle(data),
+		wpsRotationVert(data, opts?.rotation)
+	].filter(Boolean).join(";") };
 	if (opts?.attrs) Object.assign(attrs, opts.attrs);
 	return [
 		"div",
@@ -531,6 +625,37 @@ function renderWpsInterior(data, positionStyle, opts) {
 		...renderWpsText(data.children)
 	];
 }
+/** Two-element style split for an editable standalone wpsShape: `outer` for the
+*  positioning wrapper (dom), `inner` for the contentDOM. rotation/writing-mode
+*  stay on `outer` so the editable interior has a clean caret/IME rect. The
+*  geometry (EMU extent → px, floating anchor CSS) is computed here so the
+*  editor's NodeView and generateHTML render identically without re-deriving
+*  the engine's EMU/floating math. */
+function wpsShapeStyles(ws) {
+	const sizeStyle = `width:${ws.transformation?.width != null ? convertEmuToPixels(ws.transformation.width) : 0}px;height:${ws.transformation?.height != null ? convertEmuToPixels(ws.transformation.height) : 0}px;box-sizing:border-box;overflow:hidden`;
+	const rotVert = wpsRotationVert(ws);
+	let outer;
+	let paragraphAnchor = false;
+	if (ws.floating) {
+		outer = [
+			...floatingToStyles(ws.floating, void 0, ws.transformation?.width),
+			sizeStyle,
+			rotVert
+		].filter(Boolean).join(";");
+		paragraphAnchor = floatAnchorScope(ws.floating) === "paragraph";
+	} else outer = [
+		`display:inline-block;vertical-align:middle`,
+		sizeStyle,
+		rotVert
+	].filter(Boolean).join(";");
+	const anchor = ws.bodyProperties?.anchor;
+	const inner = `box-sizing:border-box;display:flex;flex-direction:column;justify-content:${anchor === "ctr" ? "center" : anchor === "b" ? "flex-end" : "flex-start"};height:100%;${wpsInnerStyle(ws)}`;
+	return {
+		outer,
+		inner,
+		paragraphAnchor
+	};
+}
 /** Render a wpg group (top-level or nested) as a positioned container.
 *  actualW/H are the group's real pixel size — top-level groups read them from
 *  transformation.width/height; nested groups receive the box their parent
@@ -550,7 +675,7 @@ function renderGroup(group, actualW, actualH, containerStyle, extraAttrs) {
 	const style = containerStyle ?? `position:relative;display:inline-block;vertical-align:middle;width:${actualW}px;height:${actualH}px`;
 	const children = (group.children ?? []).map((c) => renderChild(c, chOff, scaleX, scaleY)).filter((c) => Array.isArray(c) && c.length > 0);
 	const attrs = {
-		"data-wpg-group": "",
+		"data-wpg-group": JSON.stringify(group),
 		style
 	};
 	if (extraAttrs) Object.assign(attrs, extraAttrs);
@@ -597,6 +722,16 @@ const WpgGroup = Node.create({
 });
 //#endregion
 //#region src/extensions/wps-shape.ts
+/**
+* wpsShape — inline node carrying a standalone DOCX text-box shape
+* (wp:anchor > wps:wsp > wps:txbx; NOT inside a wpg group). The shape geometry
+* + styling (transformation/floating/fill/outline/bodyProperties) ride on
+* attrs.wpsShape; the editable text body is PM content (block+), one paragraph
+* per office-open ParagraphOptions. Unlike a group's interior wps children
+* (laid out in the group's coordinate space), this shape floats on its own
+* anchor. The engine node has no NodeView (UI-free); the editor layer extends
+* it with a two-element NodeView (outer placement/rotation, inner contentDOM).
+*/
 const attrWpsShape = () => ({
 	default: null,
 	rendered: false,
@@ -614,23 +749,35 @@ const WpsShape = Node.create({
 	name: "wpsShape",
 	group: "inline",
 	inline: true,
-	atom: true,
+	content: "block+",
+	isolating: true,
+	defining: true,
 	addAttributes() {
 		return { wpsShape: attrWpsShape() };
 	},
 	parseHTML() {
-		return [{ tag: "div[data-wps-shape]" }];
+		return [{
+			tag: "div[data-wps-shape]",
+			contentElement: "div"
+		}];
 	},
 	renderHTML({ node }) {
 		const ws = node.attrs.wpsShape ?? {};
-		const sizeStyle = `width:${ws.transformation?.width != null ? convertEmuToPixels(ws.transformation.width) : 0}px;height:${ws.transformation?.height != null ? convertEmuToPixels(ws.transformation.height) : 0}px;box-sizing:border-box`;
-		if (ws.floating) {
-			const pos = [...floatingToStyles(ws.floating, void 0, ws.transformation?.width), sizeStyle].join(";");
-			const attrs = { "data-wps-shape": "" };
-			if (floatAnchorScope(ws.floating) === "paragraph") attrs["data-float-anchor"] = "paragraph";
-			return renderWpsInterior(ws, pos, { attrs });
-		}
-		return renderWpsInterior(ws, `display:inline-block;vertical-align:middle;${sizeStyle}`, { attrs: { "data-wps-shape": "" } });
+		const { outer, inner, paragraphAnchor } = wpsShapeStyles(ws);
+		const attrs = {
+			"data-wps-shape": JSON.stringify(ws),
+			style: outer
+		};
+		if (paragraphAnchor) attrs["data-float-anchor"] = "paragraph";
+		return [
+			"div",
+			attrs,
+			[
+				"div",
+				{ style: inner },
+				0
+			]
+		];
 	}
 });
 //#endregion
@@ -642,8 +789,10 @@ const tiptapNodeExtensions = [
 	HardBreak,
 	PageBreak,
 	ColumnBreak,
+	Tab,
 	SectionBreak,
 	Passthrough,
+	InlinePassthrough,
 	TocField,
 	Blockquote,
 	OrderedList,
@@ -667,7 +816,7 @@ const tiptapNodeExtensions = [
 	TaskList,
 	TaskItem,
 	Heading,
-	TextAlign$1.configure({ types: ["heading", "paragraph"] })
+	TextAlign.configure({ types: ["heading", "paragraph"] })
 ];
 const tiptapMarkExtensions = [
 	Bold,
@@ -714,4 +863,4 @@ const DocxKit = Extension.create({
 	}
 });
 //#endregion
-export { PageBreak as _, DocxKit as a, tiptapMarkExtensions as c, WpgGroup as d, renderWpsInterior as f, Passthrough as g, SectionBreak as h, Node as i, tiptapNodeExtensions as l, TocField as m, Extension as n, TextAlign as o, renderWpsText as p, Mark as r, docxExtensions as s, Editor as t, WpsShape as u, FormattingMarks as v, ColumnBreak as y };
+export { ColumnBreak as C, FormattingMarks as S, Tab as _, DocxKit as a, Passthrough as b, tiptapNodeExtensions as c, renderWpsInterior as d, renderWpsText as f, TocField as g, wpsShapeStyles as h, Node as i, WpsShape as l, wpsRotationVert as m, Extension as n, docxExtensions as o, wpsInnerStyle as p, Mark as r, tiptapMarkExtensions as s, Editor as t, WpgGroup as u, SectionBreak as v, PageBreak as x, InlinePassthrough as y };