@docen/docx 0.3.0

package/dist/extensions/image.mjs

@@ -0,0 +1,201 @@
+import { Image as Image$1 } from "./tiptap.mjs";
+//#region src/extensions/image.ts
+/**
+* Custom Image extension with node-level renderHTML + renderDocx/parseDocx.
+*
+* Attrs:
+*  - src/alt/title/width/height: Tiptap structural names (kept verbatim so base
+*    image commands work).
+*  - rotation: editor display only (CSS transform) but also carried through DOCX
+*    via transformation.rotation (MediaTransformation.rotation).
+*  - floating/outline: nested office-open objects (Floating / OutlineOptions).
+*  - crop: nested office-open SourceRectangleOptions (srcRect).
+*  - display: editor-only display hint, no OOXML equivalent.
+*
+* DOCX round-trip is near-identity: renderDocx packs attrs into CoreImageOptions;
+* parseDocx unpacks them back. src is a data URL ↔ { type, data } base64.
+* Node-level renderHTML solves the style merge problem (rotation + floating).
+*/
+/**
+* Tiptap JSON image node → CoreImageOptions-shaped object.
+*
+* Returns `{ image: ImageOptions }` (structural wrapper) or null when no
+* embedded image data is available (external URLs need pre-fetching).
+* rotation is carried via transformation.rotation (not dropped).
+*/
+function renderDocx(node) {
+	const attrs = node.attrs ?? {};
+	const imageOpts = {};
+	const src = attrs.src;
+	if (src?.startsWith("data:image/")) {
+		const match = src.match(/^data:image\/([\w.+-]+);base64,(.+)$/);
+		if (match) {
+			imageOpts.type = match[1] === "jpeg" ? "jpg" : match[1];
+			const binary = atob(match[2]);
+			const bytes = new Uint8Array(binary.length);
+			for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+			imageOpts.data = bytes;
+		}
+	}
+	if (!imageOpts.data) return null;
+	const transformation = {
+		width: attrs.width ?? 600,
+		height: attrs.height ?? 400
+	};
+	const rotation = attrs.rotation;
+	if (rotation != null) transformation.rotation = rotation;
+	imageOpts.transformation = transformation;
+	const altText = {};
+	if (attrs.alt) altText.name = attrs.alt;
+	if (attrs.title) altText.description = attrs.title;
+	if (Object.keys(altText).length > 0) imageOpts.altText = altText;
+	if (attrs.floating) imageOpts.floating = attrs.floating;
+	if (attrs.crop) imageOpts.srcRect = attrs.crop;
+	if (attrs.outline) imageOpts.outline = attrs.outline;
+	return { image: imageOpts };
+}
+/**
+* ImageOptions-shaped object → Tiptap attrs.
+*
+* Near-identity unpack: transformation → width/height/rotation, altText → alt/title,
+* floating/srcRect(→crop)/outline passed through verbatim. src is reconstructed by
+* DocxManager from the image data bytes (kept out of parseDocx).
+*/
+function parseDocx(imageOpts) {
+	const opts = imageOpts ?? {};
+	const attrs = {};
+	const transformation = opts.transformation;
+	if (transformation) {
+		if (typeof transformation.width === "number") attrs.width = transformation.width;
+		if (typeof transformation.height === "number") attrs.height = transformation.height;
+		if (typeof transformation.rotation === "number") attrs.rotation = transformation.rotation;
+	}
+	const altText = opts.altText;
+	if (altText) {
+		if (altText.name) attrs.alt = altText.name;
+		if (altText.description) attrs.title = altText.description;
+	}
+	if (opts.floating) attrs.floating = opts.floating;
+	if (opts.srcRect) attrs.crop = opts.srcRect;
+	if (opts.outline) attrs.outline = opts.outline;
+	return attrs;
+}
+function renderCropAttrs(crop) {
+	const c = crop;
+	const leftPct = (c.left || 0) / 1e5;
+	const topPct = (c.top || 0) / 1e5;
+	const rightPct = (c.right || 0) / 1e5;
+	const bottomPct = (c.bottom || 0) / 1e5;
+	const visibleWidthPct = 1 - leftPct - rightPct;
+	const visibleHeightPct = 1 - topPct - bottomPct;
+	const posX = visibleWidthPct > 0 ? leftPct / visibleWidthPct * 100 : 0;
+	const posY = visibleHeightPct > 0 ? topPct / visibleHeightPct * 100 : 0;
+	return { style: `object-fit:cover;object-position:${posX.toFixed(2)}% ${posY.toFixed(2)}%` };
+}
+function renderImageStyles(attrs) {
+	const styles = [];
+	if (attrs.display) styles.push(`display:${attrs.display}`);
+	if (attrs.rotation) styles.push(`transform:rotate(${attrs.rotation}deg)`);
+	const f = attrs.floating;
+	if (f) {
+		styles.push(f.behindDocument ? "z-index:-1" : "z-index:1");
+		const wrapType = f.wrap?.type ?? 0;
+		if (wrapType === 0) styles.push("position:absolute");
+		else if (wrapType === 1) {
+			const align = f.horizontalPosition?.align;
+			if (align === "left" || align === "inside") styles.push("float:left");
+			else if (align === "right" || align === "outside") styles.push("float:right");
+			else styles.push("float:left");
+		} else if (wrapType === 2) {
+			styles.push("float:left");
+			styles.push("shape-outside:margin-box");
+		} else if (wrapType === 3) {
+			styles.push("display:block");
+			styles.push("clear:both");
+		} else styles.push("display:inline-block");
+		const m = f.margins;
+		if (m) {
+			if (m.top) styles.push(`margin-top:${(m.top * 96 / 1440).toFixed(1)}pt`);
+			if (m.bottom) styles.push(`margin-bottom:${(m.bottom * 96 / 1440).toFixed(1)}pt`);
+			if (m.left) styles.push(`margin-left:${(m.left * 96 / 1440).toFixed(1)}pt`);
+			if (m.right) styles.push(`margin-right:${(m.right * 96 / 1440).toFixed(1)}pt`);
+		}
+	}
+	if (attrs.crop) {
+		const cropAttrs = renderCropAttrs(attrs.crop);
+		styles.push(cropAttrs.style);
+	}
+	return styles;
+}
+const Image = Image$1.extend({
+	addAttributes() {
+		return {
+			...this.parent?.(),
+			display: {
+				default: null,
+				rendered: false,
+				parseHTML: () => this.options.inline ? "inline-block" : null
+			},
+			rotation: {
+				default: null,
+				rendered: false,
+				parseHTML: (element) => {
+					const match = (element.getAttribute("style") || "").match(/transform:\s*rotate\(([\d.]+)deg\)/);
+					return match ? parseFloat(match[1]) : null;
+				}
+			},
+			floating: {
+				default: null,
+				rendered: false,
+				parseHTML: (element) => {
+					const raw = element.getAttribute("data-floating");
+					if (!raw) return null;
+					try {
+						return JSON.parse(raw);
+					} catch {
+						return null;
+					}
+				}
+			},
+			outline: {
+				default: null,
+				rendered: false,
+				parseHTML: (element) => {
+					const raw = element.getAttribute("data-outline");
+					if (!raw) return null;
+					try {
+						return JSON.parse(raw);
+					} catch {
+						return null;
+					}
+				}
+			},
+			crop: {
+				default: null,
+				rendered: false,
+				parseHTML: (element) => {
+					const raw = element.getAttribute("data-crop");
+					if (!raw) return null;
+					try {
+						return JSON.parse(raw);
+					} catch {
+						return null;
+					}
+				}
+			}
+		};
+	},
+	renderHTML({ node, HTMLAttributes }) {
+		const styles = renderImageStyles(node.attrs);
+		const attrs = { ...HTMLAttributes };
+		if (styles.length > 0) attrs.style = styles.join(";");
+		if (node.attrs.floating) attrs["data-floating"] = JSON.stringify(node.attrs.floating);
+		if (node.attrs.outline) attrs["data-outline"] = JSON.stringify(node.attrs.outline);
+		if (node.attrs.crop) attrs["data-crop"] = JSON.stringify(node.attrs.crop);
+		return ["img", attrs];
+	},
+	renderDocx,
+	parseDocx
+});
+//#endregion
+export { Image, parseDocx, renderCropAttrs, renderDocx };

package/dist/extensions/index.d.mts

@@ -0,0 +1,2 @@
+import { c as StarterKit, d as docxExtensions, f as tiptapMarkExtensions, l as StarterKitOptions, p as tiptapNodeExtensions } from "../core-omBKMRtl.mjs";
+export { StarterKit, type StarterKitOptions, docxExtensions, tiptapMarkExtensions, tiptapNodeExtensions };

package/dist/extensions/index.mjs

@@ -0,0 +1,2 @@
+import { a as StarterKit, c as tiptapMarkExtensions, l as tiptapNodeExtensions, s as docxExtensions } from "../core-CFIQVRfx.mjs";
+export { StarterKit, docxExtensions, tiptapMarkExtensions, tiptapNodeExtensions };

package/dist/extensions/paragraph.d.mts

@@ -0,0 +1,2 @@
+import { n as parseDocx, r as renderDocx, t as Paragraph } from "../paragraph-fhEXtAN2.mjs";
+export { Paragraph, parseDocx, renderDocx };

package/dist/extensions/paragraph.mjs

@@ -0,0 +1,116 @@
+import { Paragraph as Paragraph$1 } from "./tiptap.mjs";
+import { alignmentFromElement, bordersFromElement, indentFromElement, renderParagraphStyles, shadingFromElement, spacingFromElement } from "./utils.mjs";
+//#region src/extensions/paragraph.ts
+/**
+* Paragraph extension with nested office-open attrs.
+*
+* Attrs mirror ParagraphPropertiesOptionsBase (alignment/indent/spacing/border/
+* shading/frame as nested objects + scalar OOXML properties). DOCX round-trip is
+* near-identity: renderDocx/parseDocx pass attrs through; CSS conversion happens
+* only in renderHTML via utils mappers.
+*/
+function renderDocx(node) {
+	const attrs = node.attrs ?? {};
+	const opts = {};
+	for (const [key, value] of Object.entries(attrs)) if (value !== null && value !== void 0) opts[key] = value;
+	return opts;
+}
+/** Structural/semantic keys expressed elsewhere (heading ext, list handling, run children). */
+const SKIP_KEYS = new Set([
+	"heading",
+	"style",
+	"bullet",
+	"numbering",
+	"run",
+	"children",
+	"text",
+	"thematicBreak"
+]);
+function parseDocx(opts) {
+	const resolved = typeof opts === "string" ? { text: opts } : opts;
+	const attrs = {};
+	for (const [key, value] of Object.entries(resolved)) {
+		if (SKIP_KEYS.has(key)) continue;
+		attrs[key] = value ?? null;
+	}
+	return attrs;
+}
+const attrNative = () => ({
+	default: null,
+	parseHTML: () => null,
+	rendered: false
+});
+const Paragraph = Paragraph$1.extend({
+	addAttributes() {
+		return {
+			...this.parent?.(),
+			alignment: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => alignmentFromElement(el)
+			},
+			indent: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => indentFromElement(el)
+			},
+			spacing: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => spacingFromElement(el)
+			},
+			shading: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => shadingFromElement(el)
+			},
+			border: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => bordersFromElement(el)
+			},
+			frame: attrNative(),
+			keepNext: attrNative(),
+			keepLines: attrNative(),
+			pageBreakBefore: attrNative(),
+			widowControl: attrNative(),
+			contextualSpacing: attrNative(),
+			bidirectional: attrNative(),
+			outlineLevel: attrNative(),
+			textDirection: attrNative(),
+			textAlignment: attrNative(),
+			suppressLineNumbers: attrNative(),
+			wordWrap: attrNative(),
+			overflowPunctuation: attrNative(),
+			autoSpaceEastAsianText: attrNative(),
+			suppressOverlap: attrNative(),
+			suppressAutoHyphens: attrNative(),
+			adjustRightInd: attrNative(),
+			snapToGrid: attrNative(),
+			mirrorIndents: attrNative(),
+			kinsoku: attrNative(),
+			topLinePunct: attrNative(),
+			autoSpaceDE: attrNative(),
+			textboxTightWrap: attrNative(),
+			rightTabStop: attrNative(),
+			leftTabStop: attrNative(),
+			divId: attrNative(),
+			tabStops: attrNative(),
+			cnfStyle: attrNative()
+		};
+	},
+	renderHTML({ node, HTMLAttributes }) {
+		const styles = renderParagraphStyles(node.attrs);
+		const attrs = { ...HTMLAttributes };
+		if (styles.length > 0) attrs.style = styles.join(";");
+		return [
+			"p",
+			attrs,
+			0
+		];
+	},
+	renderDocx,
+	parseDocx
+});
+//#endregion
+export { Paragraph, parseDocx, renderDocx };

package/dist/extensions/strike.d.mts

@@ -0,0 +1,2 @@
+import { n as parseDocx, r as renderDocx, t as Strike } from "../strike-BgWGvjKr.mjs";
+export { Strike, parseDocx, renderDocx };

package/dist/extensions/strike.mjs

@@ -0,0 +1,50 @@
+import { Strike as Strike$1 } from "./tiptap.mjs";
+//#region src/extensions/strike.ts
+/**
+* Strike mark extension with nested office-open attrs.
+*
+* OOXML represents strikethrough on a run via two mutually exclusive booleans:
+* `strike` (single) and `doubleStrike` (double). The mark itself is "single
+* strikethrough"; the `doubleStrike` attr flips it to double. DOCX round-trip
+* is near-identity for the doubleStrike flag; `strike` itself is implied by the
+* mark's presence and handled in renderDocx/parseDocx.
+*
+* Mark attribute-level renderHTML is delegated to the base Strike extension
+* (renders `<s>`); only the DOCX flag needs custom handling.
+*/
+/**
+* attrs → run properties.
+*
+* The mark presence itself means single strikethrough. When `doubleStrike` is
+* set, emit the OOXML double-strike flag instead (the two are mutually
+* exclusive in OOXML). DocxManager calls this with `mark.attrs`.
+*/
+function renderDocx(attrs) {
+	return attrs.doubleStrike ? { doubleStrike: true } : { strike: true };
+}
+/**
+* run properties → attrs.
+*
+* Only the `doubleStrike` flag needs to round-trip; single strike is implied by
+* the mark's existence. `strike` is structural/semantic (the mark) and skipped.
+*/
+function parseDocx(runOpts) {
+	return { doubleStrike: runOpts.doubleStrike ?? null };
+}
+const attrNative = () => ({
+	default: null,
+	parseHTML: () => null,
+	rendered: false
+});
+const Strike = Strike$1.extend({
+	addAttributes() {
+		return {
+			...this.parent?.(),
+			doubleStrike: attrNative()
+		};
+	},
+	renderDocx,
+	parseDocx
+});
+//#endregion
+export { Strike, parseDocx, renderDocx };

package/dist/extensions/table-cell.d.mts

@@ -0,0 +1,2 @@
+import { n as parseDocx, r as renderDocx, t as TableCell } from "../table-cell-D_FV4D2h.mjs";
+export { TableCell, parseDocx, renderDocx };

package/dist/extensions/table-cell.mjs

@@ -0,0 +1,112 @@
+import { TableCell as TableCell$1 } from "./tiptap.mjs";
+import { bordersFromElement, renderTableCellStyles, shadingFromElement } from "./utils.mjs";
+//#region src/extensions/table-cell.ts
+/**
+* Table cell extension with nested office-open attrs.
+*
+* Attrs mirror TableCellPropertiesOptionsBase (shading/margins/borders/width as
+* nested objects + scalar OOXML properties) plus the inherited Tiptap structural
+* names colspan/rowspan/colwidth/align (rendered: false for the OOXML-named ones).
+* DOCX round-trip is near-identity: renderDocx/parseDocx pass OOXML-native attrs
+* through and only map the Tiptap structural names colspan/rowspan/colwidth to
+* OOXML columnSpan/rowSpan/width. CSS conversion happens solely in renderHTML via
+* utils.renderTableCellStyles (consuming nested shading/verticalAlign/noWrap).
+*/
+/** Tiptap structural attrs expressed via OOXML structural fields, not passed through. */
+const SKIP_KEYS = new Set([
+	"colspan",
+	"rowspan",
+	"colwidth",
+	"children"
+]);
+function renderDocx(node) {
+	const attrs = node.attrs ?? {};
+	const opts = {};
+	const colspan = attrs.colspan;
+	if (colspan && colspan > 1) opts.columnSpan = colspan;
+	const rowspan = attrs.rowspan;
+	if (rowspan && rowspan > 1) opts.rowSpan = rowspan;
+	const colwidth = attrs.colwidth;
+	if (colwidth && colwidth.length > 0) {
+		const totalPx = colwidth.reduce((sum, w) => sum + (w || 0), 0);
+		if (totalPx > 0) opts.width = {
+			size: totalPx * 15,
+			type: "dxa"
+		};
+	}
+	for (const [key, value] of Object.entries(attrs)) {
+		if (SKIP_KEYS.has(key)) continue;
+		if (value !== null && value !== void 0) opts[key] = value;
+	}
+	return opts;
+}
+function parseDocx(opts) {
+	const resolved = typeof opts === "string" ? { text: opts } : opts;
+	const attrs = {};
+	if (resolved.columnSpan != null) attrs.colspan = resolved.columnSpan;
+	if (resolved.rowSpan != null) attrs.rowspan = resolved.rowSpan;
+	if (resolved.width) {
+		const twips = resolved.width.size ?? 0;
+		if (twips) attrs.colwidth = [Math.round(twips / 15)];
+	}
+	for (const [key, value] of Object.entries(resolved)) {
+		if (key === "columnSpan" || key === "rowSpan" || key === "width" || key === "children") continue;
+		attrs[key] = value ?? null;
+	}
+	return attrs;
+}
+const attrNative = () => ({
+	default: null,
+	parseHTML: () => null,
+	rendered: false
+});
+const TableCell = TableCell$1.extend({
+	addAttributes() {
+		return {
+			...this.parent?.(),
+			shading: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => shadingFromElement(el)
+			},
+			borders: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => bordersFromElement(el)
+			},
+			verticalAlign: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => el.style.verticalAlign || null
+			},
+			textDirection: attrNative(),
+			width: attrNative(),
+			margins: attrNative(),
+			noWrap: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => el.style.whiteSpace === "nowrap" ? true : null
+			},
+			verticalMerge: attrNative(),
+			horizontalMerge: attrNative(),
+			fitText: attrNative(),
+			hideMark: attrNative(),
+			headers: attrNative(),
+			cnfStyle: attrNative()
+		};
+	},
+	renderHTML({ node, HTMLAttributes }) {
+		const styles = renderTableCellStyles(node.attrs);
+		const attrs = { ...HTMLAttributes };
+		if (styles.length > 0) attrs.style = styles.join(";");
+		return [
+			"td",
+			attrs,
+			0
+		];
+	},
+	renderDocx,
+	parseDocx
+});
+//#endregion
+export { TableCell, parseDocx, renderDocx };

package/dist/extensions/table-header.d.mts

@@ -0,0 +1,2 @@
+import { n as parseDocx, r as renderDocx, t as TableHeader } from "../table-header-KGQ2aEkP.mjs";
+export { TableHeader, parseDocx, renderDocx };

package/dist/extensions/table-header.mjs

@@ -0,0 +1,112 @@
+import { TableHeader as TableHeader$1 } from "./tiptap.mjs";
+import { bordersFromElement, renderTableCellStyles, shadingFromElement } from "./utils.mjs";
+//#region src/extensions/table-header.ts
+/**
+* Table header extension with nested office-open attrs (mirrors TableCell).
+*
+* Attrs mirror TableCellPropertiesOptionsBase (shading/margins/borders/width as
+* nested objects + scalar OOXML properties) plus the inherited Tiptap structural
+* names colspan/rowspan/colwidth/align (rendered: false for the OOXML-named ones).
+* DOCX round-trip is near-identity: renderDocx/parseDocx pass OOXML-native attrs
+* through and only map the Tiptap structural names colspan/rowspan/colwidth to
+* OOXML columnSpan/rowSpan/width. CSS conversion happens solely in renderHTML via
+* utils.renderTableCellStyles (consuming nested shading/verticalAlign/noWrap).
+*/
+/** Tiptap structural attrs expressed via OOXML structural fields, not passed through. */
+const SKIP_KEYS = new Set([
+	"colspan",
+	"rowspan",
+	"colwidth",
+	"children"
+]);
+function renderDocx(node) {
+	const attrs = node.attrs ?? {};
+	const opts = {};
+	const colspan = attrs.colspan;
+	if (colspan && colspan > 1) opts.columnSpan = colspan;
+	const rowspan = attrs.rowspan;
+	if (rowspan && rowspan > 1) opts.rowSpan = rowspan;
+	const colwidth = attrs.colwidth;
+	if (colwidth && colwidth.length > 0) {
+		const totalPx = colwidth.reduce((sum, w) => sum + (w || 0), 0);
+		if (totalPx > 0) opts.width = {
+			size: totalPx * 15,
+			type: "dxa"
+		};
+	}
+	for (const [key, value] of Object.entries(attrs)) {
+		if (SKIP_KEYS.has(key)) continue;
+		if (value !== null && value !== void 0) opts[key] = value;
+	}
+	return opts;
+}
+function parseDocx(opts) {
+	const resolved = typeof opts === "string" ? { text: opts } : opts;
+	const attrs = {};
+	if (resolved.columnSpan != null) attrs.colspan = resolved.columnSpan;
+	if (resolved.rowSpan != null) attrs.rowspan = resolved.rowSpan;
+	if (resolved.width) {
+		const twips = resolved.width.size ?? 0;
+		if (twips) attrs.colwidth = [Math.round(twips / 15)];
+	}
+	for (const [key, value] of Object.entries(resolved)) {
+		if (key === "columnSpan" || key === "rowSpan" || key === "width" || key === "children") continue;
+		attrs[key] = value ?? null;
+	}
+	return attrs;
+}
+const attrNative = () => ({
+	default: null,
+	parseHTML: () => null,
+	rendered: false
+});
+const TableHeader = TableHeader$1.extend({
+	addAttributes() {
+		return {
+			...this.parent?.(),
+			shading: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => shadingFromElement(el)
+			},
+			borders: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => bordersFromElement(el)
+			},
+			verticalAlign: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => el.style.verticalAlign || null
+			},
+			textDirection: attrNative(),
+			width: attrNative(),
+			margins: attrNative(),
+			noWrap: {
+				default: null,
+				rendered: false,
+				parseHTML: (el) => el.style.whiteSpace === "nowrap" ? true : null
+			},
+			verticalMerge: attrNative(),
+			horizontalMerge: attrNative(),
+			fitText: attrNative(),
+			hideMark: attrNative(),
+			headers: attrNative(),
+			cnfStyle: attrNative()
+		};
+	},
+	renderHTML({ node, HTMLAttributes }) {
+		const styles = renderTableCellStyles(node.attrs);
+		const attrs = { ...HTMLAttributes };
+		if (styles.length > 0) attrs.style = styles.join(";");
+		return [
+			"th",
+			attrs,
+			0
+		];
+	},
+	renderDocx,
+	parseDocx
+});
+//#endregion
+export { TableHeader, parseDocx, renderDocx };

package/dist/extensions/table-row.d.mts

@@ -0,0 +1,2 @@
+import { n as parseDocx, r as renderDocx, t as TableRow } from "../table-row-kgzYkZlW.mjs";
+export { TableRow, parseDocx, renderDocx };