@docen/docx 0.3.0 → 0.3.2

package/dist/editor.mjs

@@ -1,13 +1,14 @@
-import { s as docxExtensions, t as Editor } from "./core-CFIQVRfx.mjs";
+import { s as docxExtensions, t as Editor } from "./core-DT9IrTzN.mjs";
 //#region src/editor.ts
 /**
 * Create a Tiptap editor configured for DOCX editing.
 */
 function createDocxEditor(options) {
 	const { element, extensions: extraExtensions = [], content, spellcheck = true, editable = true } = options;
+	const extraNames = new Set(extraExtensions.map((e) => e.name).filter(Boolean));
 	return new Editor({
 		element,
-		extensions: [...docxExtensions, ...extraExtensions],
+		extensions: [...docxExtensions.filter((e) => !extraNames.has(e.name)), ...extraExtensions],
 		content: content ?? {
 			type: "doc",
 			content: [{ type: "paragraph" }]

package/dist/extensions/blockquote.d.mts

@@ -0,0 +1,23 @@
+import { t as Blockquote } from "../tiptap-pZsNPsvV.mjs";
+
+//#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_BORDER, BLOCKQUOTE_INDENT_LEFT, Blockquote, applyBlockquoteStyle };

package/dist/extensions/blockquote.mjs

@@ -0,0 +1,31 @@
+import { Blockquote } from "./tiptap.mjs";
+//#region src/extensions/blockquote.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. */
+const BLOCKQUOTE_INDENT_LEFT = 720;
+/** Left border marking a blockquote. */
+const BLOCKQUOTE_BORDER = {
+	style: "single",
+	size: 18,
+	space: 12,
+	color: "CCCCCC"
+};
+/** Apply the blockquote signature (left indent + left border) to paragraph opts. */
+function applyBlockquoteStyle(paraObj) {
+	paraObj.indent = {
+		...paraObj.indent ?? {},
+		left: 720
+	};
+	paraObj.border = {
+		...paraObj.border ?? {},
+		left: BLOCKQUOTE_BORDER
+	};
+}
+//#endregion
+export { BLOCKQUOTE_BORDER, BLOCKQUOTE_INDENT_LEFT, Blockquote, applyBlockquoteStyle };

package/dist/extensions/code-block.d.mts

@@ -0,0 +1,19 @@
+import { a as JSONContent } from "../core-C9VunJ8o.mjs";
+
+//#region src/extensions/code-block.d.ts
+/**
+ * CodeBlock extension — CodeBlockLowlight with a DOCX renderDocx.
+ *
+ * DOCX has no dedicated code-block element. A code block maps to a single
+ * paragraph styled "Code" with a monospace run font. Inline marks (syntax-
+ * highlight tokens) and line breaks (`\n` → `<w:br/>`) are handled by
+ * DocxManager's shared inline-content compilation; resolveCodeBlock reassembles
+ * the text. This module owns only the paragraph-level style.
+ *
+ * `language` has no OOXML carrier and is intentionally dropped (known lossy).
+ */
+/** codeBlock node → paragraph properties (style "Code" + monospace font). */
+declare function renderDocx(_node: JSONContent): Record<string, unknown>;
+declare const CodeBlock: import("@tiptap/core").Node<import("@tiptap/extension-code-block-lowlight").CodeBlockLowlightOptions, any>;
+//#endregion
+export { CodeBlock, renderDocx };

package/dist/extensions/code-block.mjs

@@ -0,0 +1,23 @@
+import { CodeBlockLowlight } from "./tiptap.mjs";
+//#region src/extensions/code-block.ts
+/**
+* CodeBlock extension — CodeBlockLowlight with a DOCX renderDocx.
+*
+* DOCX has no dedicated code-block element. A code block maps to a single
+* paragraph styled "Code" with a monospace run font. Inline marks (syntax-
+* highlight tokens) and line breaks (`\n` → `<w:br/>`) are handled by
+* DocxManager's shared inline-content compilation; resolveCodeBlock reassembles
+* the text. This module owns only the paragraph-level style.
+*
+* `language` has no OOXML carrier and is intentionally dropped (known lossy).
+*/
+/** codeBlock node → paragraph properties (style "Code" + monospace font). */
+function renderDocx(_node) {
+	return {
+		style: "Code",
+		run: { font: "Consolas" }
+	};
+}
+const CodeBlock = CodeBlockLowlight.extend({ renderDocx });
+//#endregion
+export { CodeBlock, renderDocx };

package/dist/extensions/column-break.d.mts

@@ -0,0 +1,31 @@
+import { s as Node } from "../core-C9VunJ8o.mjs";
+
+//#region src/extensions/column-break.d.ts
+/**
+ * ColumnBreak — inline atom node for DOCX column breaks (`<w:br w:type="column"/>`).
+ *
+ * Sibling to PageBreak and HardBreak: all three render `<w:br>`, differing only
+ * by type. Inline (group "inline") to match the run-internal OOXML position,
+ * keeping a column break inside its paragraph on round-trip. Visual column
+ * layout (paged.js multi-column) is a future concern; the node preserves the
+ * break losslessly regardless.
+ *
+ * The DOCX payload (`{ columnBreak: true }`) is inlined in DocxManager — a
+ * one-liner with no per-node variance, so no extension helper for it.
+ *
+ * `setColumnBreak` only inserts the atom (no paragraph split): a column break
+ * does not start a new page, and there is no column layout to reflow yet, so
+ * the node is purely for round-trip fidelity until multi-column lands.
+ */
+declare const ColumnBreak: Node<any, any>;
+declare module "@tiptap/core" {
+  interface Commands<ReturnType> {
+    columnBreak: {
+      /** Insert a column break atom at the cursor (round-trip only until
+       *  multi-column layout lands). */
+      setColumnBreak: () => ReturnType;
+    };
+  }
+}
+//#endregion
+export { ColumnBreak };

package/dist/extensions/column-break.mjs

@@ -0,0 +1,2 @@
+import { v as ColumnBreak } from "../core-DT9IrTzN.mjs";
+export { ColumnBreak };

package/dist/extensions/details.d.mts

@@ -0,0 +1,19 @@
+import { c as DetailsSummary, o as Details, s as DetailsContent } from "../tiptap-pZsNPsvV.mjs";
+
+//#region src/extensions/details.d.ts
+/**
+ * Details extension — owns the DOCX expression of a collapsible details block.
+ *
+ * DOCX has no native collapsible region, but a block-level group-SDT is a
+ * reversible container. The details maps to one group-SDT tagged "docen-
+ * details"; the summary paragraph is marked with a fixed style so resolve can
+ * split it back out from the content paragraphs. Structure round-trips fully
+ * (summary + content); Word shows it expanded (no collapse) — an inherent
+ * DOCX limitation, not data loss.
+ */
+/** SDT tag marking a details group content control. */
+declare const DETAILS_TAG = "docen-details";
+/** Paragraph style marking the summary line within a details group-SDT. */
+declare const DETAILS_SUMMARY_STYLE = "DocenDetailsSummary";
+//#endregion
+export { DETAILS_SUMMARY_STYLE, DETAILS_TAG, Details, DetailsContent, DetailsSummary };

package/dist/extensions/details.mjs

@@ -0,0 +1,18 @@
+import { Details, DetailsContent, DetailsSummary } from "./tiptap.mjs";
+//#region src/extensions/details.ts
+/**
+* Details extension — owns the DOCX expression of a collapsible details block.
+*
+* DOCX has no native collapsible region, but a block-level group-SDT is a
+* reversible container. The details maps to one group-SDT tagged "docen-
+* details"; the summary paragraph is marked with a fixed style so resolve can
+* split it back out from the content paragraphs. Structure round-trips fully
+* (summary + content); Word shows it expanded (no collapse) — an inherent
+* DOCX limitation, not data loss.
+*/
+/** SDT tag marking a details group content control. */
+const DETAILS_TAG = "docen-details";
+/** Paragraph style marking the summary line within a details group-SDT. */
+const DETAILS_SUMMARY_STYLE = "DocenDetailsSummary";
+//#endregion
+export { DETAILS_SUMMARY_STYLE, DETAILS_TAG, Details, DetailsContent, DetailsSummary };

package/dist/extensions/document.d.mts

@@ -0,0 +1,2 @@
+import { n as createDocument, t as Document } from "../document-BH1y4qHM.mjs";
+export { Document, createDocument };

package/dist/extensions/document.mjs

@@ -0,0 +1,50 @@
+import { Document as Document$1 } from "./tiptap.mjs";
+//#region src/extensions/document.ts
+/**
+* Document extension carrying DOCX document-level data through the Tiptap JSON
+* for lossless round-trip (declared as attrs so editor setContent → getJSON
+* preserves them, not just the standalone converters):
+*
+* - `attrs.styles` — office-open `StylesOptions` (styles.xml: importedStyles /
+*   docDefaultsXml / latentStylesXml as raw XML).
+* - `attrs.core` — docProps/core.xml properties (title/creator/description/…,
+*   see DocxCoreProperties in converters/docx.ts).
+* - `attrs.sectionProperties` — the last section's page layout (page size/margin/
+*   orientation, columns, type, grid; intermediate sections carry theirs on
+*   sectionBreak nodes).
+*
+* None rendered to HTML — phase 2 applies styles via injected CSS.
+*
+* Factory form (`createDocument`): the editor layer needs a different top-level
+* content expression (`doc > page+` for the C-route editing schema) but the SAME
+* DOCX attrs. Building it via this factory keeps the Document definition in ONE
+* place (here) — the editor parameterizes only `content`, instead of `.extend`-
+* overriding this Document and re-stating the attrs. `Document` is the default
+* flat `doc > block+` shape used by the docx package itself.
+*/
+const attrNative = () => ({
+	default: null,
+	parseHTML: () => null,
+	rendered: false
+});
+function createDocument(content = "block+") {
+	return Document$1.extend({
+		content,
+		addAttributes() {
+			return {
+				...this.parent?.(),
+				styles: attrNative(),
+				core: attrNative(),
+				sectionProperties: attrNative(),
+				sectionHeaders: attrNative(),
+				sectionFooters: attrNative(),
+				background: attrNative(),
+				documentExtras: attrNative()
+			};
+		}
+	});
+}
+/** Default flat Document (`doc > block+`) — the DOCX round-trip shape. */
+const Document = createDocument();
+//#endregion
+export { Document, createDocument };

package/dist/extensions/extensions.d.mts

@@ -1,12 +1,12 @@
-import { B as UndoRedo, C as Mention, D as Subscript, F as Text, N as TaskItem, O as Superscript, P as TaskList, R as TrailingNode, S as Mathematics, a as CodeBlockLowlight, b as ListItem, c as DetailsSummary, d as Emoji, f as Gapcursor, g as HorizontalRule, h as Highlight, i as Code, l as Document, n as Bold, o as Details, p as HardBreak, r as BulletList, s as DetailsContent, t as Blockquote, u as Dropcursor, v as Italic, w as OrderedList, x as ListKeymap, y as Link, z as Underline } from "../tiptap-TErPjuNJ.mjs";
+import { A as TaskItem, F as Underline, M as Text, T as Superscript, _ as Link, a as CodeBlockLowlight, b as Mention, c as DetailsSummary, d as HardBreak, g as Italic, i as Code, j as TaskList, m as HorizontalRule, n as Bold, o as Details, p as Highlight, r as BulletList, s as DetailsContent, t as Blockquote, u as Emoji, v as ListItem, w as Subscript, x as OrderedList, y as Mathematics } from "../tiptap-pZsNPsvV.mjs";
+import { t as Document } from "../document-BH1y4qHM.mjs";
 import { t as Heading } from "../heading-BvqBD2zX.mjs";
-import { t as Image } from "../image-Ge1y6uam.mjs";
-import { t as Paragraph } from "../paragraph-fhEXtAN2.mjs";
+import { S as Image, _ as WpgGroup, d as TextAlign, f as docxExtensions, g as WpsShape, h as Passthrough, l as DocxKit, m as tiptapNodeExtensions, p as tiptapMarkExtensions, u as DocxKitOptions } from "../core-C9VunJ8o.mjs";
+import { t as Paragraph } from "../paragraph-D8mpHo_o.mjs";
 import { t as TableRow } from "../table-row-kgzYkZlW.mjs";
 import { t as Table } from "../table-BFkfeRp9.mjs";
 import { t as TableCell } from "../table-cell-D_FV4D2h.mjs";
 import { t as TableHeader } from "../table-header-KGQ2aEkP.mjs";
 import { t as Strike } from "../strike-BgWGvjKr.mjs";
 import { t as TextStyle } from "../text-style-BHdtXkMb.mjs";
-import { c as StarterKit, d as docxExtensions, f as tiptapMarkExtensions, l as StarterKitOptions, p as tiptapNodeExtensions, u as TextAlign } from "../core-omBKMRtl.mjs";
-export { Blockquote, Bold, BulletList, Code, CodeBlockLowlight, Details, DetailsContent, DetailsSummary, Document, Dropcursor, Emoji, Gapcursor, HardBreak, Heading, Highlight, HorizontalRule, Image, Italic, Link, ListItem, ListKeymap, Mathematics, Mention, OrderedList, Paragraph, StarterKit, StarterKitOptions, Strike, Subscript, Superscript, Table, TableCell, TableHeader, TableRow, TaskItem, TaskList, Text, TextAlign, TextStyle, TrailingNode, Underline, UndoRedo, docxExtensions, tiptapMarkExtensions, tiptapNodeExtensions };
+export { Blockquote, Bold, BulletList, Code, CodeBlockLowlight, Details, DetailsContent, DetailsSummary, Document, DocxKit, DocxKitOptions, Emoji, HardBreak, Heading, Highlight, HorizontalRule, Image, Italic, Link, ListItem, Mathematics, Mention, OrderedList, Paragraph, Passthrough, Strike, Subscript, Superscript, Table, TableCell, TableHeader, TableRow, TaskItem, TaskList, Text, TextAlign, TextStyle, Underline, WpgGroup, WpsShape, docxExtensions, tiptapMarkExtensions, tiptapNodeExtensions };

package/dist/extensions/extensions.mjs

@@ -1,4 +1,6 @@
-import { Blockquote, Bold, BulletList, Code, CodeBlockLowlight, Details, DetailsContent, DetailsSummary, Document, Dropcursor, Emoji, Gapcursor, HardBreak, Highlight, HorizontalRule, Italic, Link, ListItem, ListKeymap, Mathematics, Mention, OrderedList, Subscript, Superscript, TaskItem, TaskList, Text, TrailingNode, Underline, UndoRedo } from "./tiptap.mjs";
+import { Blockquote, Bold, BulletList, Code, CodeBlockLowlight, Details, DetailsContent, DetailsSummary, Emoji, HardBreak, Highlight, HorizontalRule, Italic, Link, ListItem, Mathematics, Mention, OrderedList, Subscript, Superscript, TaskItem, TaskList, Text, Underline } from "./tiptap.mjs";
+import { a as DocxKit, c as tiptapMarkExtensions, d as WpgGroup, h as Passthrough, l as tiptapNodeExtensions, o as TextAlign, s as docxExtensions, u as WpsShape } from "../core-DT9IrTzN.mjs";
+import { Document } from "./document.mjs";
 import { Heading } from "./heading.mjs";
 import { Image } from "./image.mjs";
 import { Paragraph } from "./paragraph.mjs";
@@ -8,5 +10,4 @@ import { TableCell } from "./table-cell.mjs";
 import { TableHeader } from "./table-header.mjs";
 import { TableRow } from "./table-row.mjs";
 import { TextStyle } from "./text-style.mjs";
-import { a as StarterKit, c as tiptapMarkExtensions, l as tiptapNodeExtensions, o as TextAlign, s as docxExtensions } from "../core-CFIQVRfx.mjs";
-export { Blockquote, Bold, BulletList, Code, CodeBlockLowlight, Details, DetailsContent, DetailsSummary, Document, Dropcursor, Emoji, Gapcursor, HardBreak, Heading, Highlight, HorizontalRule, Image, Italic, Link, ListItem, ListKeymap, Mathematics, Mention, OrderedList, Paragraph, StarterKit, Strike, Subscript, Superscript, Table, TableCell, TableHeader, TableRow, TaskItem, TaskList, Text, TextAlign, TextStyle, TrailingNode, Underline, UndoRedo, docxExtensions, tiptapMarkExtensions, tiptapNodeExtensions };
+export { Blockquote, Bold, BulletList, Code, CodeBlockLowlight, Details, DetailsContent, DetailsSummary, Document, DocxKit, Emoji, HardBreak, Heading, Highlight, HorizontalRule, Image, Italic, Link, ListItem, Mathematics, Mention, OrderedList, Paragraph, Passthrough, Strike, Subscript, Superscript, Table, TableCell, TableHeader, TableRow, TaskItem, TaskList, Text, TextAlign, TextStyle, Underline, WpgGroup, WpsShape, docxExtensions, tiptapMarkExtensions, tiptapNodeExtensions };

package/dist/extensions/formatting-marks.d.mts

@@ -0,0 +1,38 @@
+import { r as Extension } from "../core-C9VunJ8o.mjs";
+
+//#region src/extensions/formatting-marks.d.ts
+/**
+ * FormattingMarks — paints the non-printing paragraph mark via ProseMirror
+ * widget decorations.
+ *
+ * CSS `p::after { content: "…" }` does NOT work on a ProseMirror-managed
+ * paragraph: the view owns the DOM and the trailing-break kludge pushes the
+ * pseudo-element off the visible line, so the mark never appears (verified).
+ * Marijn Haverbeke endorses widget decorations for exactly this use case
+ * (https://discuss.prosemirror.net/t/1442). Each textblock gets a widget at its
+ * closing position (inside the textblock, so it stays on the content's line)
+ * holding a non-editable `<span class="docen-para-mark">`. `side: 1` keeps the
+ * mark to the right of a cursor resting at the paragraph end (the cursor always
+ * precedes its own paragraph mark).
+ *
+ * Glyph: a down-then-left return arrow (↲, U+21B2 "downwards arrow with tip
+ * leftwards" — the Enter-key glyph). Word/WPS use the pilcrow ¶ for paragraph
+ * marks; that down-then-left arrow is Word's line-break glyph — adopted here as
+ * the paragraph mark per the project's visual preference.
+ *
+ * Performance: the widget set is cached in plugin state and rebuilt only on a
+ * doc change or a marks toggle — NOT on every selectionUpdate. Without the
+ * cache, each caret move / selection re-traverses the whole document (one
+ * widget per textblock) and rebuilds the set, which costs 200ms+ on 1000-page
+ * documents. Pure selection transactions now reuse the cached set in O(1).
+ */
+declare const FormattingMarks: Extension<any, any>;
+declare module "@tiptap/core" {
+  interface Commands<ReturnType> {
+    formattingMarks: {
+      /** Toggle the non-printing paragraph marks on or off. */toggleFormattingMarks: () => ReturnType;
+    };
+  }
+}
+//#endregion
+export { FormattingMarks };

package/dist/extensions/formatting-marks.mjs

@@ -0,0 +1,2 @@
+import { _ as FormattingMarks } from "../core-DT9IrTzN.mjs";
+export { FormattingMarks };

package/dist/extensions/heading.mjs

@@ -28,13 +28,19 @@ const HEADING_PARSE_MAP = {
 	Heading6: 6,
 	Title: 1
 };
+/** Runtime-only attrs the TableOfContents extension injects on each heading
+*  (`id` / `data-toc-id`). They are regenerated on every load, so never persist
+*  them to DOCX — skip them in renderDocx. */
+const TOC_RUNTIME_KEYS = new Set(["id", "data-toc-id"]);
 function renderDocx(node) {
 	const attrs = node.attrs ?? {};
 	const opts = {};
 	const level = attrs.level;
-	if (level) opts.heading = HEADING_COMPILE_MAP[level] ?? "Heading1";
+	const styleId = attrs.styleId;
+	if (styleId) opts.heading = styleId;
+	else if (level) opts.heading = HEADING_COMPILE_MAP[level] ?? "Heading1";
 	for (const [key, value] of Object.entries(attrs)) {
-		if (key === "level") continue;
+		if (key === "level" || key === "styleId" || TOC_RUNTIME_KEYS.has(key)) continue;
 		if (value !== null && value !== void 0) opts[key] = value;
 	}
 	return opts;
@@ -56,7 +62,9 @@ function parseDocx(opts) {
 	if (resolved.heading) {
 		const level = HEADING_PARSE_MAP[resolved.heading];
 		if (level) attrs.level = level;
+		attrs.styleId = resolved.heading;
 	}
+	if (resolved.style) attrs.styleId = resolved.style;
 	for (const [key, value] of Object.entries(resolved)) {
 		if (SKIP_KEYS.has(key)) continue;
 		attrs[key] = value ?? null;
@@ -72,6 +80,13 @@ const Heading = Heading$1.extend({
 	addAttributes() {
 		return {
 			...this.parent?.(),
+			styleId: {
+				default: null,
+				parseHTML: (el) => {
+					const m = (el.getAttribute("class") || "").match(/(?:^|\s)docx-style-(\S+)/);
+					return m ? m[1] : null;
+				}
+			},
 			alignment: {
 				default: null,
 				rendered: false,
@@ -128,9 +143,15 @@ const Heading = Heading$1.extend({
 		};
 	},
 	renderHTML({ node, HTMLAttributes }) {
-		const styles = renderParagraphStyles(node.attrs);
+		let hasContent = false;
+		node.forEach?.((child) => {
+			if (child.isText || child.type?.name === "hardBreak" || child.type?.name === "image") hasContent = true;
+		});
+		const styles = renderParagraphStyles(node.attrs, { empty: !hasContent });
 		const level = node.attrs?.level ?? 1;
 		const attrs = { ...HTMLAttributes };
+		const styleId = node.attrs.styleId;
+		if (styleId) attrs.class = `docx-style-${styleId}`;
 		if (styles.length > 0) attrs.style = styles.join(";");
 		return [
 			`h${level}`,

package/dist/extensions/image.d.mts

@@ -1,2 +1,2 @@
-import { i as renderDocx, n as parseDocx, r as renderCropAttrs, t as Image } from "../image-Ge1y6uam.mjs";
-export { Image, parseDocx, renderCropAttrs, renderDocx };
+import { C as parseDocx, S as Image, T as renderDocx, w as renderCropAttrs, x as CropRenderContext } from "../core-C9VunJ8o.mjs";
+export { CropRenderContext, Image, parseDocx, renderCropAttrs, renderDocx };