@docen/docx 0.3.5 → 0.4.0

package/dist/extensions/types.d.mts

@@ -1,5 +1,5 @@
 import { JSONContent } from "@tiptap/core";
-import { RunOptions } from "@office-open/docx";
+import { ParagraphChild, ParagraphOptions, RunOptions, SectionChild, StylesOptions } from "@office-open/docx";
 
 //#region src/extensions/types.d.ts
 declare module "@tiptap/core" {
@@ -16,17 +16,136 @@ declare module "@tiptap/core" {
      * Each node extension defines this to convert DOCX properties back to attrs.
      */
     parseDocx?: (opts: Record<string, unknown>) => Record<string, unknown>;
+    /**
+     * Declarative block parse rule: recognize a SectionChild shape this node
+     * owns and convert it to a JSONContent node. DocxManager walks every
+     * extension's rule (in docxExtensions declaration order) during resolve, so
+     * a custom block node plugs in by declaring this instead of forking
+     * DocxManager. `match` false → skipped; `convert` null after a positive
+     * match falls through to the next rule, then the paragraph/passthrough
+     * fallbacks.
+     */
+    parseDocxBlock?: ParseBlockRule;
+    /**
+     * Declarative inline parse rule: recognize a ParagraphChild shape this
+     * node/mark owns and convert it to inline content (a node, text[], or
+     * null to fall through). DocxManager walks every extension's rule during
+     * resolve, so a custom inline shape plugs in by declaring this instead of
+     * forking DocxManager. Used by both Node extensions (image/tab/wpsShape/…)
+     * and Mark containers (hyperlink/insertion/deletion, which yield text
+     * nodes carrying the mark).
+     */
+    parseDocxInline?: ParseInlineRule;
+    /**
+     * Declarative paragraph parse rule: recognize a paragraph subtype this node
+     * owns (heading/codeBlock) and convert it to a JSONContent node. DocxManager
+     * walks every extension's rule during resolve before the plain-paragraph
+     * fallback, so a custom paragraph subtype plugs in by declaring this instead
+     * of forking DocxManager. thematicBreak (→ horizontalRule) stays in the
+     * manager — it has no owning extension.
+     */
+    parseDocxParagraph?: ParseParagraphRule;
+    /**
+     * Declarative aggregator: claims consecutive paragraphs that belong to a
+     * composite structure (a list tree, a blockquote) and rebuilds them as
+     * nested JSONContent. DocxManager keeps a generic group-by-predicate loop;
+     * the rule contributes the predicate (belongs) + the builder (build). A
+     * custom composite plugs in by declaring this instead of forking DocxManager.
+     */
+    parseDocxAggregator?: ParseAggregatorRule;
+  }
+  interface ExtensionConfig<Options = any, Storage = any> {
+    /** Declarative aggregator on a plain Extension (e.g. a list-tree rebuilder
+     *  that spans bullet/ordered/task lists). See NodeConfig.parseDocxAggregator. */
+    parseDocxAggregator?: ParseAggregatorRule;
   }
   interface MarkConfig<Options = any, Storage = any> {
     /**
-     * DOCX serialization: mark attrs → RunOptions properties.
-     * Each mark extension defines this to contribute run-level properties.
+     * DOCX serialization: mark attrs → run-level properties (merged into the
+     * run's options). Each mark extension defines this to contribute rPr fields.
+     */
+    renderDocx?: (attrs: Record<string, unknown>) => Record<string, unknown>;
+    /**
+     * DOCX deserialization: RunOptions → mark attrs, or null when the run does
+     * not carry this mark (DocxManager then skips emitting it). Each mark
+     * extension defines this to extract its attrs from run properties.
      */
-    renderDocx?: (attrs: Record<string, unknown>) => Partial<RunOptions>;
+    parseDocx?: (opts: RunOptions) => Record<string, unknown> | null;
     /**
-     * DOCX deserialization: RunOptions → mark attrs.
-     * Each mark extension defines this to extract its attrs from run properties.
+     * Declarative inline parse rule (see NodeConfig.parseDocxInline). A Mark
+     * container such as hyperlink/insertion/deletion declares this to yield
+     * text nodes carrying the mark.
      */
-    parseDocx?: (opts: RunOptions) => Record<string, unknown>;
+    parseDocxInline?: ParseInlineRule;
   }
-}
+}
+/**
+ * Per-resolve façade handed to parse rules: read-only views over the
+ * DocumentOptions being resolved plus recursive entry points back into
+ * DocxManager — a table cell, a TOC entry, and a details body are themselves
+ * SectionChild[] block streams. Rule bodies must stay pure: getExtensionField
+ * binds no `this`, so a rule cannot read extension options/storage and reaches
+ * the manager only through this context.
+ */
+interface ResolveContext {
+  /** Walk a SectionChild[] block stream (a cell's children, a TOC's entries, a
+   *  details body) — regroups consecutive numbering paragraphs into lists. */
+  resolveBlockStream(children: SectionChild[]): JSONContent[];
+  /** Resolve one SectionChild (a TOC entry, a details body block). */
+  resolveBlock(child: SectionChild): JSONContent | null;
+  /** Resolve a paragraph's inline content (handles the bare-string/{text}
+   *  fallback office-open collapses a plain paragraph to). */
+  resolveInlineContent(para: ParagraphOptions): JSONContent[];
+  /** Walk a ParagraphChild[] inline stream (a hyperlink/track-change container's
+   *  child runs) — the inline counterpart of resolveBlockStream. */
+  resolveInlineChildren(children: (ParagraphChild | string)[]): JSONContent[];
+  /** Resolve a paragraph (a wpsShape text-box body block). */
+  resolveParagraph(para: ParagraphOptions | string): JSONContent;
+  /** Reflective node attrs parse (table/tableRow/tableHeader/tableCell/…) —
+   *  reuses the nodeParse registry so a block rule shares the attrs extraction
+   *  the inline/compile paths use. */
+  parseNodeAttrs(type: string, opts: Record<string, unknown>): Record<string, unknown>;
+  /** Resolve run-level marks (bold/italic/…) for a RunOptions — used by
+   *  code-block's resolveCodeBlock to recover inline marks on each run. */
+  resolveMarks(opts: RunOptions): JSONContent["marks"];
+  /** The document's styles.xml model. Table rules read tableStyles; paragraph
+   *  rules (Phase 2) will read paragraphStyles. */
+  readonly styles: StylesOptions | undefined;
+  /** Numbering reference → level-0 format/start, for classifying list paragraphs
+   *  (bullet vs ordered, start value). Read by the list aggregator. */
+  readonly numberingLookup: Map<string, {
+    format?: string;
+    start?: number;
+  }> | undefined;
+}
+/** A declarative block parse rule. `match` identifies the SectionChild shape
+ *  this node owns; `convert` builds the JSONContent node (null falls through to
+ *  the next rule). */
+interface ParseBlockRule {
+  match(child: SectionChild, ctx: ResolveContext): boolean;
+  convert(child: SectionChild, ctx: ResolveContext): JSONContent | null;
+}
+/** A declarative inline parse rule. `match` identifies the ParagraphChild
+ *  shape; `convert` builds inline content — a node, an array (hyperlink/
+ *  track-change yield text[]), or null to fall through to the next rule. */
+interface ParseInlineRule {
+  match(child: ParagraphChild, ctx: ResolveContext): boolean;
+  convert(child: ParagraphChild, ctx: ResolveContext): JSONContent | JSONContent[] | null;
+}
+/** A declarative paragraph parse rule. `match` identifies the paragraph
+ *  subtype; `convert` builds the JSONContent node (null falls through to the
+ *  next rule, then the plain-paragraph fallback). */
+interface ParseParagraphRule {
+  match(para: ParagraphOptions, ctx: ResolveContext): boolean;
+  convert(para: ParagraphOptions, ctx: ResolveContext): JSONContent | null;
+}
+/** A declarative aggregator rule. `belongs` is the predicate grouping
+ *  consecutive paragraphs into one composite; `build` turns the group into
+ *  JSONContent[] (e.g. a nested list tree, a blockquote). The manager runs the
+ *  generic group-by loop — the rule owns only the predicate + builder. */
+interface ParseAggregatorRule {
+  belongs(para: ParagraphOptions, ctx: ResolveContext): boolean;
+  build(group: ParagraphOptions[], ctx: ResolveContext): JSONContent[];
+}
+//#endregion
+export { ParseAggregatorRule, ParseBlockRule, ParseInlineRule, ParseParagraphRule, ResolveContext };

package/dist/extensions/utils.d.mts

@@ -1,2 +1,2 @@
-import { A as twipsToMm, C as shadingFromCss, D as sizeToCss, E as sizeFromCss, O as spacingFromElement, S as sectionMarginCss, T as shadingToCss, _ as renderTableCellStyles, a as bordersFromElement, b as resolvePageSize, c as cssToTwip, d as indentFromElement, f as lineSpacingToCss, g as renderRunStyles, h as renderParagraphStyles, i as attrNative, k as twipToCss, l as floatAnchorScope, m as renderBorderCSS, n as alignmentFromElement, o as characterSpacingFromCss, p as normalizeColorToHex, r as alignmentToCss, s as characterSpacingToCss, t as alignmentFromCss, u as floatingToStyles, v as resolveFontFamilyCss, w as shadingFromElement, x as sectionLinePitchCss, y as resolveFontName } from "../utils-BJwDQts7.mjs";
-export { alignmentFromCss, alignmentFromElement, alignmentToCss, attrNative, bordersFromElement, characterSpacingFromCss, characterSpacingToCss, cssToTwip, floatAnchorScope, floatingToStyles, indentFromElement, lineSpacingToCss, normalizeColorToHex, renderBorderCSS, renderParagraphStyles, renderRunStyles, renderTableCellStyles, resolveFontFamilyCss, resolveFontName, resolvePageSize, sectionLinePitchCss, sectionMarginCss, shadingFromCss, shadingFromElement, shadingToCss, sizeFromCss, sizeToCss, spacingFromElement, twipToCss, twipsToMm };
+import { A as twipToCss, C as shadingFromCss, D as sizeToCss, E as sizeFromCss, O as spacingFromElement, S as sectionMarginCss, T as shadingToCss, _ as renderTableCellStyles, a as bordersFromElement, b as resolvePageSize, c as cssToTwip, d as indentFromElement, f as lineSpacingToCss, g as renderRunStyles, h as renderParagraphStyles, i as attrNative, j as twipsToMm, k as tableFloatToCss, l as floatAnchorScope, m as renderBorderCSS, n as alignmentFromElement, o as characterSpacingFromCss, p as normalizeColorToHex, r as alignmentToCss, s as characterSpacingToCss, t as alignmentFromCss, u as floatingToStyles, v as resolveFontFamilyCss, w as shadingFromElement, x as sectionLinePitchCss, y as resolveFontName } from "../utils-CfwwOowz.mjs";
+export { alignmentFromCss, alignmentFromElement, alignmentToCss, attrNative, bordersFromElement, characterSpacingFromCss, characterSpacingToCss, cssToTwip, floatAnchorScope, floatingToStyles, indentFromElement, lineSpacingToCss, normalizeColorToHex, renderBorderCSS, renderParagraphStyles, renderRunStyles, renderTableCellStyles, resolveFontFamilyCss, resolveFontName, resolvePageSize, sectionLinePitchCss, sectionMarginCss, shadingFromCss, shadingFromElement, shadingToCss, sizeFromCss, sizeToCss, spacingFromElement, tableFloatToCss, twipToCss, twipsToMm };

package/dist/extensions/utils.mjs

@@ -282,6 +282,11 @@ function floatingToStyles(floating, src, width) {
 	if (wrapType === 0) {
 		styles.push("position:absolute");
 		if (hOff != null) styles.push(`left:${(hOff / EMU_PER_PX).toFixed(1)}px`);
+		else {
+			const hAlign = f.horizontalPosition?.align;
+			if (hAlign === "center") styles.push("left:50%", "transform:translateX(-50%)");
+			else if (hAlign === "right") styles.push("right:0");
+		}
 		if (vOff != null) styles.push(`top:${(vOff / EMU_PER_PX).toFixed(1)}px`);
 	} else if (wrapType !== 3 && hOff != null && width != null) {
 		const offPx = (hOff / EMU_PER_PX).toFixed(1);
@@ -325,6 +330,74 @@ function floatAnchorScope(floating) {
 	return "paragraph";
 }
 /**
+* Render a table's float anchor (w:tblpPr → TableFloatOptions) to CSS.
+*
+* Unlike a drawing's Floating (wp:anchor, EMU offsets, wrap types), a floating
+* table carries no wrap type — Word's "text wrapping" around a table is plain
+* CSS float with margins. Twips (not EMU) throughout: tblpX/Y and the fromText
+* gaps are dxa.
+*
+* Two render modes:
+*  - text-anchored wrap (horizontalAnchor=text) → CSS float + margins, so body
+*    text flows beside the table. tblpX → margin on the float side; fromText →
+*    the opposite side + top/bottom (mirrors floatingToStyles so the offset and
+*    the wrap gap never compete for the same margin edge).
+*  - page/margin anchor → position:absolute pinned to the page box, floating at
+*    the offset/alignment like Word's page-anchored table. .docen-page is
+*    position:relative and its padding box is the physical page (no border), so
+*    top:0/left:0 matches OOXML's page origin; symmetric page padding makes
+*    left:50% the content-box center too, so a margin anchor centers alike.
+*  - text-anchored center/inside/outside have no CSS float equivalent (and
+*    inside/outside need odd/even pages the editor lacks) → degraded to [].
+*    attrs still round-trip byte-faithful via renderDocx/parseDocx passthrough.
+*  - overlap (neverOverlap) has no CSS float equivalent; ignored.
+*/
+function tableFloatToCss(float) {
+	const f = float;
+	if (!f) return [];
+	const hAnchorPage = f.horizontalAnchor === "page" || f.horizontalAnchor === "margin";
+	const vAnchorPage = f.verticalAnchor === "page" || f.verticalAnchor === "margin";
+	if (hAnchorPage || vAnchorPage) {
+		const styles = ["position:absolute"];
+		if (vAnchorPage && f.absoluteVerticalPosition != null) {
+			const top = twipToCss(f.absoluteVerticalPosition);
+			if (top) styles.push(`top:${top}`);
+		}
+		if (hAnchorPage) {
+			const side = f.relativeHorizontalPosition;
+			if (f.absoluteHorizontalPosition != null) {
+				const left = twipToCss(f.absoluteHorizontalPosition);
+				if (left) styles.push(`left:${left}`);
+			} else if (side === "center") styles.push("left:50%", "transform:translateX(-50%)");
+			else if (side === "right") styles.push("right:0");
+			else styles.push("left:0");
+		}
+		return styles;
+	}
+	const side = f.relativeHorizontalPosition;
+	if (side === "center" || side === "inside" || side === "outside") return [];
+	const floatRight = side === "right";
+	const styles = [floatRight ? "float:right" : "float:left"];
+	if (f.absoluteHorizontalPosition != null) {
+		const off = twipToCss(f.absoluteHorizontalPosition);
+		if (off) styles.push(floatRight ? `margin-right:${off}` : `margin-left:${off}`);
+	}
+	const gapSide = floatRight ? f.leftFromText : f.rightFromText;
+	if (gapSide != null) {
+		const m = twipToCss(gapSide);
+		if (m) styles.push(floatRight ? `margin-left:${m}` : `margin-right:${m}`);
+	}
+	if (f.topFromText != null) {
+		const m = twipToCss(f.topFromText);
+		if (m) styles.push(`margin-top:${m}`);
+	}
+	if (f.bottomFromText != null) {
+		const m = twipToCss(f.bottomFromText);
+		if (m) styles.push(`margin-bottom:${m}`);
+	}
+	return styles;
+}
+/**
 * Compute all paragraph-level CSS styles from nested attrs.
 * Shared by Paragraph and Heading extensions for node-level renderHTML.
 * Attrs store office-open native values; mappers here convert to CSS.
@@ -505,4 +578,4 @@ function shadingFromElement(el) {
 	return shadingFromCss(el.style.backgroundColor || null);
 }
 //#endregion
-export { alignmentFromCss, alignmentFromElement, alignmentToCss, attrNative, bordersFromElement, characterSpacingFromCss, characterSpacingToCss, cssToTwip, floatAnchorScope, floatingToStyles, indentFromElement, lineSpacingToCss, normalizeColorToHex, renderBorderCSS, renderParagraphStyles, renderRunStyles, renderTableCellStyles, resolveFontFamilyCss, resolveFontName, resolvePageSize, sectionLinePitchCss, sectionMarginCss, shadingFromCss, shadingFromElement, shadingToCss, sizeFromCss, sizeToCss, spacingFromElement, twipToCss, twipsToMm };
+export { alignmentFromCss, alignmentFromElement, alignmentToCss, attrNative, bordersFromElement, characterSpacingFromCss, characterSpacingToCss, cssToTwip, floatAnchorScope, floatingToStyles, indentFromElement, lineSpacingToCss, normalizeColorToHex, renderBorderCSS, renderParagraphStyles, renderRunStyles, renderTableCellStyles, resolveFontFamilyCss, resolveFontName, resolvePageSize, sectionLinePitchCss, sectionMarginCss, shadingFromCss, shadingFromElement, shadingToCss, sizeFromCss, sizeToCss, spacingFromElement, tableFloatToCss, twipToCss, twipsToMm };

package/dist/extensions/wpg-group.d.mts

@@ -1,2 +1,2 @@
-import { C as renderWpsText, E as wpsShapeStyles, S as renderWpsInterior, T as wpsRotationVert, b as WpsShapeStandalone, v as WpgGroup, w as wpsInnerStyle, x as WpsShapeStyles, y as WpsData } from "../core-DC0_-WcE.mjs";
-export { WpgGroup, WpsData, WpsShapeStandalone, WpsShapeStyles, renderWpsInterior, renderWpsText, wpsInnerStyle, wpsRotationVert, wpsShapeStyles };
+import { A as WpgGroup, F as renderWpsInterior, I as renderWpsText, L as wpsInnerStyle, M as WpsShapeStandalone, N as WpsShapeStyles, P as parseDocxInline, R as wpsRotationVert, j as WpsData, z as wpsShapeStyles } from "../core-BqyLL84S.mjs";
+export { WpgGroup, WpsData, WpsShapeStandalone, WpsShapeStyles, parseDocxInline, renderWpsInterior, renderWpsText, wpsInnerStyle, wpsRotationVert, wpsShapeStyles };

package/dist/extensions/wpg-group.mjs

@@ -1,2 +1,2 @@
-import { d as renderWpsInterior, f as renderWpsText, h as wpsShapeStyles, m as wpsRotationVert, p as wpsInnerStyle, u as WpgGroup } from "../core-BnF8XhVE.mjs";
-export { WpgGroup, renderWpsInterior, renderWpsText, wpsInnerStyle, wpsRotationVert, wpsShapeStyles };
+import { C as renderWpsText, E as wpsShapeStyles, S as renderWpsInterior, T as wpsRotationVert, b as WpgGroup, w as wpsInnerStyle, x as parseDocxInline } from "../core-wNNPJiKr.mjs";
+export { WpgGroup, parseDocxInline, renderWpsInterior, renderWpsText, wpsInnerStyle, wpsRotationVert, wpsShapeStyles };

package/dist/extensions/wps-shape.d.mts

@@ -1,2 +1,2 @@
-import { _ as WpsShape } from "../core-DC0_-WcE.mjs";
-export { WpsShape };
+import { O as WpsShape, k as parseDocxInline } from "../core-BqyLL84S.mjs";
+export { WpsShape, parseDocxInline };

package/dist/extensions/wps-shape.mjs

@@ -1,2 +1,2 @@
-import { l as WpsShape } from "../core-BnF8XhVE.mjs";
-export { WpsShape };
+import { v as WpsShape, y as parseDocxInline } from "../core-wNNPJiKr.mjs";
+export { WpsShape, parseDocxInline };

package/dist/heading-Bwpa8iZY.d.mts

@@ -0,0 +1,24 @@
+import { ParseParagraphRule } from "./extensions/types.mjs";
+import { JSONContent } from "@tiptap/core";
+import { ParagraphOptions, StylesOptions } from "@office-open/docx";
+
+//#region src/extensions/heading.d.ts
+/** Heading level (1-9) for a paragraph, or undefined when it isn't a heading.
+ *  DOCX marks a heading several ways, checked in priority order:
+ *  1. office-open lifts a HeadingLevel pStyle ("Heading1".."Title") into `heading`.
+ *  2. An explicit `outlineLevel` (0-8 → 1-9) — Word's outline/TOC key off this
+ *     even without a heading pStyle; the Heading1-9 styles carry outlineLvl 0-8.
+ *  3. A pStyle that names a heading style: directly ("Heading7", which stays on
+ *     `style` because office-open's HeadingLevel type caps at 6), by localized
+ *     NAME ("heading 1"/"标题 1"), or via the `basedOn` chain (a custom style
+ *     "MyTitle" basedOn="Heading1"). `heading` and `style` carry the same pStyle.
+ *  `outlineLevel` is read loosely — office-open's public type omits the field
+ *  even though it round-trips (w:outlineLvl) at runtime. Pure (no `this`):
+ *  resolved + the document styles snapshot are all it reads. */
+declare function detectHeadingLevel(resolved: ParagraphOptions, styles: StylesOptions | undefined): number | undefined;
+declare const parseDocxParagraph: ParseParagraphRule;
+declare function renderDocx(node: JSONContent): Record<string, unknown>;
+declare function parseDocx(opts: Record<string, unknown>): Record<string, unknown>;
+declare const Heading: import("@tiptap/core").Node<import("@tiptap/extension-heading").HeadingOptions, any>;
+//#endregion
+export { renderDocx as a, parseDocxParagraph as i, detectHeadingLevel as n, parseDocx as r, Heading as t };

package/dist/index.d.mts

@@ -1,19 +1,23 @@
-import { A as TaskItem, F as Underline, M as Text, N as TextAlign, T as Superscript, 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, s as DetailsContent, t as Blockquote, u as Emoji, v as ListItem, w as Subscript, y as Mathematics } from "./tiptap-BKqn41uT.mjs";
+import { a as Subscript, i as Italic, n as Code, o as Superscript, r as Highlight, s as Underline, t as Bold } from "./marks-Dz9Vb22Q.mjs";
 import { n as createDocument, t as Document } from "./document-Cws7XTYL.mjs";
 import { t as Paragraph } from "./paragraph-D8mpHo_o.mjs";
-import { t as Heading } from "./heading-BvqBD2zX.mjs";
+import { t as Heading } from "./heading-Bwpa8iZY.mjs";
+import { r as Blockquote } from "./blockquote-D-1aSxEn.mjs";
 import { t as BulletList } from "./bullet-list-DF60pnSL.mjs";
 import { r as OrderedList } from "./ordered-list-DFAe-YEV.mjs";
-import { A as Image, D as PageBreak, E as wpsShapeStyles, F as ColumnBreak, I as CodeBlock, O as FormattingMarks, P as SectionBreak, _ as WpsShape, a as JSONContent, b as WpsShapeStandalone, c as DocxKit, d as tiptapMarkExtensions, f as tiptapNodeExtensions, g as Passthrough, h as InlinePassthrough, l as DocxKitOptions, m as TocField, p as Tab, t as AnyExtension, u as docxExtensions, v as WpgGroup, x as WpsShapeStyles } from "./core-DC0_-WcE.mjs";
-import { t as Table } from "./table-BFkfeRp9.mjs";
+import { A as WpgGroup, B as PageBreak, D as Passthrough, E as InlinePassthrough, H as FormattingMarks, K as Image, M as WpsShapeStandalone, N as WpsShapeStyles, O as WpsShape, Q as ColumnBreak, S as Tab, U as Deletion, W as Insertion, Z as SectionBreak, _ as Text, a as JSONContent, b as tiptapMarkExtensions, c as CodeBlockLowlight, d as Emoji, et as CodeBlock, f as HardBreak, g as TaskList, h as Mathematics, l as DocxKit, m as ListItem, p as HorizontalRule, t as AnyExtension, u as DocxKitOptions, v as TextAlign, w as TocField, x as tiptapNodeExtensions, y as docxExtensions, z as wpsShapeStyles } from "./core-BqyLL84S.mjs";
+import { a as DetailsSummaryBase, i as DetailsContentBase, r as Details } from "./details-DsJhDP5K.mjs";
+import { n as TaskItemBase } from "./task-item-CCAC4QLi.mjs";
+import { n as Mention } from "./mention-CkONDrw9.mjs";
+import { t as Table } from "./table-CdcjR6HD.mjs";
 import { t as TableRow } from "./table-row-kgzYkZlW.mjs";
 import { t as TableCell } from "./table-cell-D_FV4D2h.mjs";
 import { t as TableHeader } from "./table-header-KGQ2aEkP.mjs";
-import { t as Link } from "./link-BawPjQZR.mjs";
-import { t as Strike } from "./strike-BgWGvjKr.mjs";
-import { t as TextStyle } from "./text-style-BHdtXkMb.mjs";
-import { n as scrollContainerOf, t as scrollCaretToTop } from "./scroll-ZNeThJsJ.mjs";
-import { A as twipsToMm, S as sectionMarginCss, b as resolvePageSize, x as sectionLinePitchCss, y as resolveFontName } from "./utils-BJwDQts7.mjs";
+import { t as Link } from "./link-gUqW45mE.mjs";
+import { t as Strike } from "./strike-Brn9sWFy.mjs";
+import { t as TextStyle } from "./text-style-BzfcbufI.mjs";
+import { n as scrollContainerOf, t as scrollCaretToTop } from "./scroll-BARiZ5Gm.mjs";
+import { S as sectionMarginCss, b as resolvePageSize, j as twipsToMm, x as sectionLinePitchCss, y as resolveFontName } from "./utils-CfwwOowz.mjs";
 import { ImageFetchHandler, PrepareStep, fetchImageHandler, prepareDocument, prepareImages } from "./converters/prepare.mjs";
 import { DocxGenerateOptions, DocxManager, compileDocument, generateDOCX, generateDOCXStream, generateDOCXSync, parseDOCX, resolveDocument } from "./converters/docx.mjs";
 import { generateHTML, parseHTML } from "./converters/html.mjs";
@@ -153,6 +157,14 @@ interface HardBreakNode {
   type: "hardBreak";
   marks?: Mark[];
 }
+/** OOXML track-change metadata (w:ins / w:del). Mirrors office-open's
+ *  ChangedAttributesProperties: `id` is the w:id (number), `author`/`date` are
+ *  the revision author and timestamp. */
+interface TrackChangeAttrs {
+  id: number | null;
+  author: string | null;
+  date: string | null;
+}
 type Mark = {
   type: "bold";
 } | {
@@ -179,6 +191,12 @@ type Mark = {
 } | {
   type: "link";
   attrs?: LinkAttrs;
+} | {
+  type: "insertion";
+  attrs?: TrackChangeAttrs;
+} | {
+  type: "deletion";
+  attrs?: TrackChangeAttrs;
 };
 interface ParagraphNode extends TiptapJSONContent {
   type: "paragraph";
@@ -269,7 +287,7 @@ interface ImageNode extends TiptapJSONContent {
 /**
  * Drawing group (wpg) carried as an opaque blob — the full WpgGroupRunOptions
  * (pictures/shapes/nested groups + transform) round-trips verbatim. renderHTML
- * lays out every child at its transformed position (Word-style group rendering).
+ * lays out every child at its transformed position (Office-style group rendering).
  */
 interface WpgGroupNode extends TiptapJSONContent {
   type: "wpgGroup";
@@ -356,4 +374,4 @@ interface DetailsContentNode extends TiptapJSONContent {
 type InlineContent = TextNode | HardBreakNode | ImageNode | EmojiNode | PageBreakNode | ColumnBreakNode | TabNode | MentionNode | InlineMathNode | InlinePassthroughNode;
 type BlockNode = ParagraphNode | HeadingNode | BlockquoteNode | CodeBlockNode | HorizontalRuleNode | BulletListNode | OrderedListNode | TaskListNode | TableNode | WpsShapeNode | WpgGroupNode | DetailsNode | TocFieldNode | PassthroughNode | BlockMathNode;
 //#endregion
-export { type AlignmentType, type AnyExtension, type AttrNullable, type BlockMathNode, type BlockNode, Blockquote, type BlockquoteNode, Bold, type BookmarkOptions, type BorderOptions, type BordersOptions, BulletList, type BulletListNode, Code, CodeBlock, CodeBlockLowlight, type CodeBlockNode, ColumnBreak, type ColumnBreakNode, Details, DetailsContent, type DetailsContentNode, type DetailsNode, DetailsSummary, type DetailsSummaryNode, Document, type DocumentOptions, type DocxEditorOptions, type DocxGenerateOptions, DocxKit, DocxKitOptions, DocxManager, type DocxPatchContent, type DocxPatchOptions, Emoji, type EmojiAttrs, type EmojiNode, type EmphasisMarkType, type ExternalHyperlinkOptions, type Floating, type FontAttributesProperties, FormattingMarks, type FrameOptions, HardBreak, type HardBreakNode, type HeaderFooterSlots, Heading, type HeadingLevel, type HeadingNode, type HeightRule, Highlight, type HighlightColor, HorizontalRule, type HorizontalRuleNode, Image, type ImageAttrs, type ImageFetchHandler, type ImageNode, type ImageOptions, type IndentAttributesProperties, type InlineContent, type InlineMathNode, InlinePassthrough, type InlinePassthroughNode, type InternalHyperlinkOptions, Italic, type JSONContent, type LeaderType, type LevelParagraphStylePropertiesOptions, type LineRuleType, Link, type LinkAttrs, ListItem, type ListItemNode, type Margins, type Mark, type MathAttrs, type MathInput, Mathematics, type MediaTransformation, Mention, type MentionAttrs, type MentionNode, OrderedList, type OrderedListNode, PageBreak, type PageBreakNode, Paragraph, type ParagraphAttrs, type ParagraphChild, type ParagraphNode, type ParagraphOptions, type ParagraphPropertiesOptions, type ParagraphPropertiesOptionsBase, type ParagraphRunPropertiesOptions, type ParagraphStylePropertiesOptions, Passthrough, type PassthroughNode, type PrepareStep, type QuickStyleEntry, type RubyOptions, type RunOptions, type RunPropertiesOptions, type RunStylePropertiesOptions, SectionBreak, type SectionChild, type SectionOptions, type SectionPropertiesOptions, type ShadingAttributesProperties, type SpacingProperties, Strike, type StrikeAttrs, type StylesOptions, Subscript, Superscript, Tab, type TabNode, type TabStopDefinition, type TabStopPosition, type TabStopType, Table, type TableAttrs, type TableBordersOptions, TableCell, type TableCellAttrs, type TableCellBordersOptions, type TableCellNode, type TableCellOptions, type TableFloatOptions, TableHeader, type TableHeaderNode, type TableLayoutType, type TableLookOptions, type TableNode, type TableOptions, TableRow, type TableRowAttrs, type TableRowNode, type TableRowOptions, type TableRowPropertiesOptionsBase, type TableVerticalAlign, type TableWidthProperties, TaskItem, type TaskItemNode, TaskList, type TaskListNode, Text, TextAlign, type TextAlignmentType, type TextNode, TextStyle, type TextStyleAttrs, TocField, type TocFieldNode, Underline, type UnderlineType, type WidthType, WpgGroup, type WpgGroupNode, WpsShape, type WpsShapeNode, type WpsShapeStandalone, type WpsShapeStyles, compileDocument, convertMillimetersToTwip, createDocument, createDocxEditor, docxExtensions, effectiveRunProps, fetchImageHandler, generateDOCX, generateDOCXStream, generateDOCXSync, generateHTML, generateMarkdown, inlineStyles, parseDOCX, parseHTML, parseMarkdown, patchDOCX, prepareDocument, prepareImages, quickStyles, resolveDocument, resolveFontName, resolvePageSize, scrollCaretToTop, scrollContainerOf, sectionLinePitchCss, sectionMarginCss, sectionMarginDefaults, sectionPageSizeDefaults, stylesToCss, tiptapMarkExtensions, tiptapNodeExtensions, twipsToMm, wpsShapeStyles };
+export { type AlignmentType, type AnyExtension, type AttrNullable, type BlockMathNode, type BlockNode, Blockquote, type BlockquoteNode, Bold, type BookmarkOptions, type BorderOptions, type BordersOptions, BulletList, type BulletListNode, Code, CodeBlock, CodeBlockLowlight, type CodeBlockNode, ColumnBreak, type ColumnBreakNode, Deletion, Details, DetailsContentBase as DetailsContent, type DetailsContentNode, type DetailsNode, DetailsSummaryBase as DetailsSummary, type DetailsSummaryNode, Document, type DocumentOptions, type DocxEditorOptions, type DocxGenerateOptions, DocxKit, DocxKitOptions, DocxManager, type DocxPatchContent, type DocxPatchOptions, Emoji, type EmojiAttrs, type EmojiNode, type EmphasisMarkType, type ExternalHyperlinkOptions, type Floating, type FontAttributesProperties, FormattingMarks, type FrameOptions, HardBreak, type HardBreakNode, type HeaderFooterSlots, Heading, type HeadingLevel, type HeadingNode, type HeightRule, Highlight, type HighlightColor, HorizontalRule, type HorizontalRuleNode, Image, type ImageAttrs, type ImageFetchHandler, type ImageNode, type ImageOptions, type IndentAttributesProperties, type InlineContent, type InlineMathNode, InlinePassthrough, type InlinePassthroughNode, Insertion, type InternalHyperlinkOptions, Italic, type JSONContent, type LeaderType, type LevelParagraphStylePropertiesOptions, type LineRuleType, Link, type LinkAttrs, ListItem, type ListItemNode, type Margins, type Mark, type MathAttrs, type MathInput, Mathematics, type MediaTransformation, Mention, type MentionAttrs, type MentionNode, OrderedList, type OrderedListNode, PageBreak, type PageBreakNode, Paragraph, type ParagraphAttrs, type ParagraphChild, type ParagraphNode, type ParagraphOptions, type ParagraphPropertiesOptions, type ParagraphPropertiesOptionsBase, type ParagraphRunPropertiesOptions, type ParagraphStylePropertiesOptions, Passthrough, type PassthroughNode, type PrepareStep, type QuickStyleEntry, type RubyOptions, type RunOptions, type RunPropertiesOptions, type RunStylePropertiesOptions, SectionBreak, type SectionChild, type SectionOptions, type SectionPropertiesOptions, type ShadingAttributesProperties, type SpacingProperties, Strike, type StrikeAttrs, type StylesOptions, Subscript, Superscript, Tab, type TabNode, type TabStopDefinition, type TabStopPosition, type TabStopType, Table, type TableAttrs, type TableBordersOptions, TableCell, type TableCellAttrs, type TableCellBordersOptions, type TableCellNode, type TableCellOptions, type TableFloatOptions, TableHeader, type TableHeaderNode, type TableLayoutType, type TableLookOptions, type TableNode, type TableOptions, TableRow, type TableRowAttrs, type TableRowNode, type TableRowOptions, type TableRowPropertiesOptionsBase, type TableVerticalAlign, type TableWidthProperties, TaskItemBase as TaskItem, type TaskItemNode, TaskList, type TaskListNode, Text, TextAlign, type TextAlignmentType, type TextNode, TextStyle, type TextStyleAttrs, TocField, type TocFieldNode, type TrackChangeAttrs, Underline, type UnderlineType, type WidthType, WpgGroup, type WpgGroupNode, WpsShape, type WpsShapeNode, type WpsShapeStandalone, type WpsShapeStyles, compileDocument, convertMillimetersToTwip, createDocument, createDocxEditor, docxExtensions, effectiveRunProps, fetchImageHandler, generateDOCX, generateDOCXStream, generateDOCXSync, generateHTML, generateMarkdown, inlineStyles, parseDOCX, parseHTML, parseMarkdown, patchDOCX, prepareDocument, prepareImages, quickStyles, resolveDocument, resolveFontName, resolvePageSize, scrollCaretToTop, scrollContainerOf, sectionLinePitchCss, sectionMarginCss, sectionMarginDefaults, sectionPageSizeDefaults, stylesToCss, tiptapMarkExtensions, tiptapNodeExtensions, twipsToMm, wpsShapeStyles };

package/dist/index.mjs

@@ -1,13 +1,18 @@
-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 { resolveFontName, resolvePageSize, sectionLinePitchCss, sectionMarginCss, twipsToMm } from "./extensions/utils.mjs";
+import { effectiveRunProps, inlineStyles, quickStyles, stylesToCss } from "./converters/styles.mjs";
+import { Blockquote } from "./extensions/blockquote.mjs";
 import { BulletList } from "./extensions/bullet-list.mjs";
 import { CodeBlock } from "./extensions/code-block.mjs";
-import { C as ColumnBreak, S as FormattingMarks, _ as Tab, a as DocxKit, b as Passthrough, c as tiptapNodeExtensions, g as TocField, h as wpsShapeStyles, l as WpsShape, o as docxExtensions, s as tiptapMarkExtensions, u as WpgGroup, v as SectionBreak, x as PageBreak, y as InlinePassthrough } from "./core-BnF8XhVE.mjs";
-import { resolveFontName, resolvePageSize, sectionLinePitchCss, sectionMarginCss, twipsToMm } from "./extensions/utils.mjs";
+import { B as FormattingMarks, D as Deletion, E as wpsShapeStyles, F as Passthrough, I as PageBreak, N as SectionBreak, O as Insertion, P as InlinePassthrough, V as ColumnBreak, _ as tiptapNodeExtensions, a as CodeBlockLowlight, b as WpgGroup, c as HardBreak, d as Mathematics, f as TaskList, g as tiptapMarkExtensions, h as docxExtensions, j as Tab, k as TocField, l as HorizontalRule, m as TextAlign, o as DocxKit, p as Text, s as Emoji, u as ListItem, v as WpsShape } from "./core-wNNPJiKr.mjs";
+import { Details, DetailsContent as DetailsContentBase, DetailsSummary as DetailsSummaryBase } from "./extensions/details.mjs";
 import { Document, createDocument } from "./extensions/document.mjs";
 import { Heading } from "./extensions/heading.mjs";
 import { Image } from "./extensions/image.mjs";
 import { scrollCaretToTop, scrollContainerOf } from "./extensions/scroll.mjs";
 import { Link } from "./extensions/link.mjs";
+import { TaskItem as TaskItemBase } from "./extensions/task-item.mjs";
+import { Bold, Code, Highlight, Italic, Subscript, Superscript, Underline } from "./extensions/marks.mjs";
+import { Mention } from "./extensions/mention.mjs";
 import { OrderedList } from "./extensions/ordered-list.mjs";
 import { Paragraph } from "./extensions/paragraph.mjs";
 import { Strike } from "./extensions/strike.mjs";
@@ -18,11 +23,10 @@ import { TableRow } from "./extensions/table-row.mjs";
 import { TextStyle } from "./extensions/text-style.mjs";
 import { createDocxEditor } from "./editor.mjs";
 import { fetchImageHandler, prepareDocument, prepareImages } from "./converters/prepare.mjs";
-import { effectiveRunProps, inlineStyles, quickStyles, stylesToCss } from "./converters/styles.mjs";
 import { DocxManager, compileDocument, generateDOCX, generateDOCXStream, generateDOCXSync, parseDOCX, resolveDocument } from "./converters/docx.mjs";
 import { patchDOCX } from "./converters/patch.mjs";
 import { generateHTML, parseHTML } from "./converters/html.mjs";
 import { generateMarkdown, parseMarkdown } from "./converters/markdown.mjs";
 import { sectionMarginDefaults, sectionPageSizeDefaults } from "@office-open/docx";
 import { convertMillimetersToTwip } from "@office-open/core";
-export { Blockquote, Bold, BulletList, Code, CodeBlock, CodeBlockLowlight, ColumnBreak, Details, DetailsContent, DetailsSummary, Document, DocxKit, DocxManager, Emoji, FormattingMarks, HardBreak, Heading, Highlight, HorizontalRule, Image, InlinePassthrough, Italic, Link, ListItem, Mathematics, Mention, OrderedList, PageBreak, Paragraph, Passthrough, SectionBreak, Strike, Subscript, Superscript, Tab, Table, TableCell, TableHeader, TableRow, TaskItem, TaskList, Text, TextAlign, TextStyle, TocField, Underline, WpgGroup, WpsShape, compileDocument, convertMillimetersToTwip, createDocument, createDocxEditor, docxExtensions, effectiveRunProps, fetchImageHandler, generateDOCX, generateDOCXStream, generateDOCXSync, generateHTML, generateMarkdown, inlineStyles, parseDOCX, parseHTML, parseMarkdown, patchDOCX, prepareDocument, prepareImages, quickStyles, resolveDocument, resolveFontName, resolvePageSize, scrollCaretToTop, scrollContainerOf, sectionLinePitchCss, sectionMarginCss, sectionMarginDefaults, sectionPageSizeDefaults, stylesToCss, tiptapMarkExtensions, tiptapNodeExtensions, twipsToMm, wpsShapeStyles };
+export { Blockquote, Bold, BulletList, Code, CodeBlock, CodeBlockLowlight, ColumnBreak, Deletion, Details, DetailsContentBase as DetailsContent, DetailsSummaryBase as DetailsSummary, Document, DocxKit, DocxManager, Emoji, FormattingMarks, HardBreak, Heading, Highlight, HorizontalRule, Image, InlinePassthrough, Insertion, Italic, Link, ListItem, Mathematics, Mention, OrderedList, PageBreak, Paragraph, Passthrough, SectionBreak, Strike, Subscript, Superscript, Tab, Table, TableCell, TableHeader, TableRow, TaskItemBase as TaskItem, TaskList, Text, TextAlign, TextStyle, TocField, Underline, WpgGroup, WpsShape, compileDocument, convertMillimetersToTwip, createDocument, createDocxEditor, docxExtensions, effectiveRunProps, fetchImageHandler, generateDOCX, generateDOCXStream, generateDOCXSync, generateHTML, generateMarkdown, inlineStyles, parseDOCX, parseHTML, parseMarkdown, patchDOCX, prepareDocument, prepareImages, quickStyles, resolveDocument, resolveFontName, resolvePageSize, scrollCaretToTop, scrollContainerOf, sectionLinePitchCss, sectionMarginCss, sectionMarginDefaults, sectionPageSizeDefaults, stylesToCss, tiptapMarkExtensions, tiptapNodeExtensions, twipsToMm, wpsShapeStyles };

package/dist/{link-BawPjQZR.d.mts → link-gUqW45mE.d.mts}

@@ -1,6 +1,8 @@
+import { ParseInlineRule } from "./extensions/types.mjs";
 import { LinkOptions } from "@tiptap/extension-link";
 
 //#region src/extensions/link.d.ts
+declare const parseDocxInline: ParseInlineRule;
 declare const Link$1: import("@tiptap/core").Mark<LinkOptions, any>;
 //#endregion
-export { Link$1 as t };
+export { parseDocxInline as n, Link$1 as t };

package/dist/marks-Dz9Vb22Q.d.mts

@@ -0,0 +1,10 @@
+//#region src/extensions/marks.d.ts
+declare const Bold: import("@tiptap/core").Mark<import("@tiptap/extension-bold").BoldOptions, any>;
+declare const Italic: import("@tiptap/core").Mark<import("@tiptap/extension-italic").ItalicOptions, any>;
+declare const Underline: import("@tiptap/core").Mark<import("@tiptap/extension-underline").UnderlineOptions, any>;
+declare const Code: import("@tiptap/core").Mark<import("@tiptap/extension-code").CodeOptions, any>;
+declare const Highlight: import("@tiptap/core").Mark<import("@tiptap/extension-highlight").HighlightOptions, any>;
+declare const Subscript: import("@tiptap/core").Mark<import("@tiptap/extension-subscript").SubscriptExtensionOptions, any>;
+declare const Superscript: import("@tiptap/core").Mark<import("@tiptap/extension-superscript").SuperscriptExtensionOptions, any>;
+//#endregion
+export { Subscript as a, Italic as i, Code as n, Superscript as o, Highlight as r, Underline as s, Bold as t };

package/dist/{mention-BGLzLVYw.d.mts → mention-CkONDrw9.d.mts}

@@ -1,3 +1,5 @@
+import { ParseInlineRule } from "./extensions/types.mjs";
+
 //#region src/extensions/mention.d.ts
 /**
  * Mention extension — owns the DOCX expression of an inline mention.
@@ -19,5 +21,7 @@ declare function readMention(child: unknown): {
   id: string;
   label: string;
 };
+declare const parseDocxInline: ParseInlineRule;
+declare const Mention: import("@tiptap/core").Node<import("@tiptap/extension-mention").MentionOptions<any, import("@tiptap/extension-mention").MentionNodeAttrs>, any>;
 //#endregion
-export { readMention as i, createMention as n, isMention as r, MENTION_TAG as t };
+export { parseDocxInline as a, isMention as i, Mention as n, readMention as o, createMention as r, MENTION_TAG as t };

package/dist/{scroll-ZNeThJsJ.d.mts → scroll-BARiZ5Gm.d.mts}

@@ -5,14 +5,20 @@ import { EditorView } from "@tiptap/pm/view";
  * Scroll helpers shared by the editor and the docx engine's link-click handler,
  * so every "jump then scroll" path (outline heading, search result, find, TOC
  * Ctrl+Click, post-reflow caret follow) scrolls the SAME way — to the top of the
- * viewport, Word-style. ProseMirror's default `tr.scrollIntoView()` parks the
+ * viewport, Office-style. ProseMirror's default `tr.scrollIntoView()` parks the
  * caret at the bottom edge, which reads wrong for a page/heading/TOC jump.
  */
 /** Nearest scrollable ancestor of the editor surface (e.g. the docen-canvas). */
 declare function scrollContainerOf(view: EditorView): HTMLElement | null;
 /** Scroll the caret to the TOP of the viewport when it has left the visible area
- *  (Word-style page follow). No-op while the caret stays in view, so normal
- *  typing doesn't fight the user's scroll. Replaces PM's default scrollIntoView. */
+ *  (Office-style page follow). No-op while the caret stays in view, so normal
+ *  typing doesn't fight the user's scroll. Replaces PM's default scrollIntoView.
+ *
+ * Follows the caret's PAGE, not the caret itself: a caret near a page's bottom
+ * edge (e.g. after a select-all delete leaves the caret at the end of an
+ * otherwise-empty page) would otherwise park that page's lower half in view,
+ * which reads as "scrolled to the bottom." Anchoring on the page top keeps the
+ * page's start in view. Falls back to the caret position outside C-route. */
 declare function scrollCaretToTop(view: EditorView): void;
 //#endregion
 export { scrollContainerOf as n, scrollCaretToTop as t };

package/dist/strike-Brn9sWFy.d.mts

@@ -0,0 +1,16 @@
+//#region src/extensions/strike.d.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.
+ *
+ * Mark attribute-level renderHTML is delegated to the base Strike extension
+ * (renders `<s>`); only the DOCX flag needs custom handling.
+ */
+declare const Strike: import("@tiptap/core").Mark<import("@tiptap/extension-strike").StrikeOptions, any>;
+//#endregion
+export { Strike as t };

package/dist/table-CdcjR6HD.d.mts

@@ -0,0 +1,18 @@
+import { ParseBlockRule } from "./extensions/types.mjs";
+import { JSONContent } from "@tiptap/core";
+import { TableOptions } from "@office-open/docx";
+
+//#region src/extensions/table.d.ts
+declare function renderDocx(node: JSONContent): Partial<TableOptions>;
+declare function parseDocx(opts: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Declarative block parse rule: recognize a table SectionChild and rebuild it
+ * as a Tiptap table node (rows/cells with colspan/rowspan recovered, the table
+ * style's tblBorders/tblCellMar merged in, insideH/V grid lines pushed onto
+ * cells, gridAfter as trailing nil-bordered cells). DocxManager dispatches
+ * every SectionChild through this rule before the paragraph/passthrough
+ * fallbacks. */
+declare const parseDocxBlock: ParseBlockRule;
+declare const Table: import("@tiptap/core").Node<import("@tiptap/extension-table").TableOptions, any>;
+//#endregion
+export { renderDocx as i, parseDocx as n, parseDocxBlock as r, Table as t };

package/dist/{task-item-B0ntvQ1Y.d.mts → task-item-CCAC4QLi.d.mts}

@@ -1,3 +1,5 @@
+import { TaskItem as TaskItemBase } from "@tiptap/extension-task-item";
+
 //#region src/extensions/task-item.d.ts
 /**
  * TaskItem extension — owns the DOCX expression of a task-list checkbox.
@@ -22,4 +24,4 @@ declare function isTaskCheckbox(child: unknown): boolean;
 /** Read the checked state of a task checkbox SDT child (false if not one). */
 declare function readCheckboxState(child: unknown): boolean;
 //#endregion
-export { readCheckboxState as i, createTaskCheckbox as n, isTaskCheckbox as r, TASK_CHECKBOX_TAG as t };
+export { readCheckboxState as a, isTaskCheckbox as i, TaskItemBase as n, createTaskCheckbox as r, TASK_CHECKBOX_TAG as t };

package/dist/text-style-BzfcbufI.d.mts

@@ -0,0 +1,4 @@
+//#region src/extensions/text-style.d.ts
+declare const TextStyle: import("@tiptap/core").Mark<import("@tiptap/extension-text-style").TextStyleOptions, any>;
+//#endregion
+export { TextStyle as t };

package/dist/{utils-BJwDQts7.d.mts → utils-CfwwOowz.d.mts}

@@ -105,6 +105,30 @@ declare function floatingToStyles(floating: unknown, src?: string, width?: numbe
  * relevant for wrapNone (type 0); the float-based wraps stay inline.
  */
 declare function floatAnchorScope(floating: unknown): "paragraph" | "page";
+/**
+ * Render a table's float anchor (w:tblpPr → TableFloatOptions) to CSS.
+ *
+ * Unlike a drawing's Floating (wp:anchor, EMU offsets, wrap types), a floating
+ * table carries no wrap type — Word's "text wrapping" around a table is plain
+ * CSS float with margins. Twips (not EMU) throughout: tblpX/Y and the fromText
+ * gaps are dxa.
+ *
+ * Two render modes:
+ *  - text-anchored wrap (horizontalAnchor=text) → CSS float + margins, so body
+ *    text flows beside the table. tblpX → margin on the float side; fromText →
+ *    the opposite side + top/bottom (mirrors floatingToStyles so the offset and
+ *    the wrap gap never compete for the same margin edge).
+ *  - page/margin anchor → position:absolute pinned to the page box, floating at
+ *    the offset/alignment like Word's page-anchored table. .docen-page is
+ *    position:relative and its padding box is the physical page (no border), so
+ *    top:0/left:0 matches OOXML's page origin; symmetric page padding makes
+ *    left:50% the content-box center too, so a margin anchor centers alike.
+ *  - text-anchored center/inside/outside have no CSS float equivalent (and
+ *    inside/outside need odd/even pages the editor lacks) → degraded to [].
+ *    attrs still round-trip byte-faithful via renderDocx/parseDocx passthrough.
+ *  - overlap (neverOverlap) has no CSS float equivalent; ignored.
+ */
+declare function tableFloatToCss(float: unknown): string[];
 /**
  * Compute all paragraph-level CSS styles from nested attrs.
  * Shared by Paragraph and Heading extensions for node-level renderHTML.
@@ -134,4 +158,4 @@ declare function bordersFromElement(el: HTMLElement): BordersOptions | null;
 /** Parse background-color → OOXML shading. */
 declare function shadingFromElement(el: HTMLElement): ShadingAttributesProperties | null;
 //#endregion
-export { twipsToMm as A, shadingFromCss as C, sizeToCss as D, sizeFromCss as E, spacingFromElement as O, sectionMarginCss as S, shadingToCss as T, renderTableCellStyles as _, bordersFromElement as a, resolvePageSize as b, cssToTwip as c, indentFromElement as d, lineSpacingToCss as f, renderRunStyles as g, renderParagraphStyles as h, attrNative as i, twipToCss as k, floatAnchorScope as l, renderBorderCSS as m, alignmentFromElement as n, characterSpacingFromCss as o, normalizeColorToHex as p, alignmentToCss as r, characterSpacingToCss as s, alignmentFromCss as t, floatingToStyles as u, resolveFontFamilyCss as v, shadingFromElement as w, sectionLinePitchCss as x, resolveFontName as y };
+export { twipToCss as A, shadingFromCss as C, sizeToCss as D, sizeFromCss as E, spacingFromElement as O, sectionMarginCss as S, shadingToCss as T, renderTableCellStyles as _, bordersFromElement as a, resolvePageSize as b, cssToTwip as c, indentFromElement as d, lineSpacingToCss as f, renderRunStyles as g, renderParagraphStyles as h, attrNative as i, twipsToMm as j, tableFloatToCss as k, floatAnchorScope as l, renderBorderCSS as m, alignmentFromElement as n, characterSpacingFromCss as o, normalizeColorToHex as p, alignmentToCss as r, characterSpacingToCss as s, alignmentFromCss as t, floatingToStyles as u, resolveFontFamilyCss as v, shadingFromElement as w, sectionLinePitchCss as x, resolveFontName as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docen/docx",
-  "version": "0.3.5",
+  "version": "0.4.0",
   "description": "DOCX editor and converter powered by @office-open/docx with Tiptap editing layer, supporting bidirectional conversion between DOCX, HTML, and Markdown",
   "keywords": [
     "converter",