@docen/docx 0.3.1 → 0.3.2

package/dist/index.d.mts

@@ -1,14 +1,16 @@
 import { n as createDocument, t as Document } from "./document-BH1y4qHM.mjs";
-import { a as JSONContent, c as DocxKit, d as docxExtensions, f as tiptapMarkExtensions, l as DocxKitOptions, p as tiptapNodeExtensions, t as AnyExtension } from "./core-fBMCCj4D.mjs";
-import { i as prepareDocument, n as PrepareStep, o as prepareImages, r as fetchImageHandler, t as ImageFetchHandler } from "./prepare-CPAvcv6q.mjs";
-import { a as generateDOCX, c as parseDOCX, i as compileDocument, l as resolveDocument, n as DocxGenerateOptions, o as generateDOCXStream, r as DocxManager, s as generateDOCXSync } from "./docx-C5wyjI-0.mjs";
-import { n as parseHTML, t as generateHTML } from "./html-DCC_DSHv.mjs";
-import { n as parseMarkdown, t as generateMarkdown } from "./markdown-D0k0sRYS.mjs";
-import { n as DocxPatchOptions, r as patchDOCX, t as DocxPatchContent } from "./patch-Cdp5WKJz.mjs";
-import { a as inlineStyles, i as effectiveRunProps, n as StylesOptions, o as quickStyles, s as stylesToCss, t as QuickStyleEntry } from "./styles-ugspkrxz.mjs";
-import { n as createDocxEditor, t as DocxEditorOptions } from "./editor-DReY3Rb9.mjs";
+import { a as JSONContent, c as PageBreak, f as docxExtensions, l as DocxKit, m as tiptapNodeExtensions, p as tiptapMarkExtensions, t as AnyExtension, u as DocxKitOptions } from "./core-C9VunJ8o.mjs";
+import { b as sectionLinePitchCss, k as twipsToMm, v as resolveFontName, x as sectionMarginCss, y as resolvePageSize } from "./utils-D87vukzp.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";
+import { generateMarkdown, parseMarkdown } from "./converters/markdown.mjs";
+import { DocxPatchContent, DocxPatchOptions, patchDOCX } from "./converters/patch.mjs";
+import { QuickStyleEntry, StylesOptions, effectiveRunProps, inlineStyles, quickStyles, stylesToCss } from "./converters/styles.mjs";
+import { DocxEditorOptions, createDocxEditor } from "./editor.mjs";
 import { JSONContent as TiptapJSONContent } from "@tiptap/core";
-import { AlignmentType, BookmarkOptions, BorderOptions, BordersOptions, DocumentOptions, EmphasisMarkType, ExternalHyperlinkOptions, Floating, Floating as Floating$1, FontAttributesProperties, FrameOptions, HeadingLevel, HeightRule, HighlightColor, ImageChild, ImageOptions, ImageOptions as ImageOptions$1, IndentAttributesProperties, InternalHyperlinkOptions, LeaderType, LevelParagraphStylePropertiesOptions, LineRuleType, Margins, MathChild, MathInput, MediaTransformation, ParagraphChild, ParagraphOptions, ParagraphPropertiesOptions, ParagraphPropertiesOptionsBase, ParagraphRunPropertiesOptions, ParagraphStylePropertiesOptions, RubyOptions, RunOptions, RunPropertiesOptions, RunStylePropertiesOptions, SectionChild, SectionOptions, SectionPropertiesOptions, ShadingAttributesProperties, SpacingProperties, TabStopDefinition, TabStopPosition, TabStopType, TableBordersOptions, TableCellBordersOptions, TableCellOptions, TableFloatOptions, TableLayoutType, TableLookOptions, TableOptions, TableRowOptions, TableRowPropertiesOptionsBase, TableVerticalAlign, TableWidthProperties, TextAlignmentType, UnderlineType, WidthType } from "@office-open/docx";
+import { AlignmentType, BookmarkOptions, BorderOptions, BordersOptions, DocumentOptions, EmphasisMarkType, ExternalHyperlinkOptions, Floating, Floating as Floating$1, FontAttributesProperties, FrameOptions, HeadingLevel, HeightRule, HighlightColor, ImageOptions, ImageOptions as ImageOptions$1, IndentAttributesProperties, InternalHyperlinkOptions, LeaderType, LevelParagraphStylePropertiesOptions, LineRuleType, Margins, MathInput, MediaTransformation, ParagraphChild, ParagraphOptions, ParagraphPropertiesOptions, ParagraphPropertiesOptionsBase, ParagraphRunPropertiesOptions, ParagraphStylePropertiesOptions, RubyOptions, RunOptions, RunPropertiesOptions, RunStylePropertiesOptions, SectionChild, SectionOptions, SectionPropertiesOptions, SectionPropertiesOptions as SectionPropertiesOptions$1, ShadingAttributesProperties, SpacingProperties, TabStopDefinition, TabStopPosition, TabStopType, TableBordersOptions, TableCellBordersOptions, TableCellOptions, TableFloatOptions, TableLayoutType, TableLookOptions, TableOptions, TableRowOptions, TableRowPropertiesOptionsBase, TableVerticalAlign, TableWidthProperties, TextAlignmentType, UnderlineType, WidthType, sectionMarginDefaults, sectionPageSizeDefaults } from "@office-open/docx";
+import { convertMillimetersToTwip } from "@office-open/core";
 
 //#region src/types.d.ts
 /**
@@ -17,19 +19,44 @@ import { AlignmentType, BookmarkOptions, BorderOptions, BordersOptions, Document
  */
 type AttrNullable<T> = { [K in keyof T]-?: T[K] | null };
 /**
- * Paragraph and heading attrs — mirrors ParagraphPropertiesOptionsBase.
+ * Paragraph and heading attrs — mirrors ParagraphPropertiesOptionsBase, plus
+ * engine-only extras the office-open paragraph interface does not carry:
+ * styleId (OOXML pStyle, drives styles.xml CSS) and the section* attrs (OOXML
+ * sectPr lives on a section's last paragraph, so the engine hauls the section
+ * boundary + its header/footer slots on that paragraph).
  *
  * indent/spacing/border/run/frame are nested objects (matching office-open),
  * so one `indent` attr replaces 13 flattened indent attrs.
  */
-type ParagraphAttrs = AttrNullable<ParagraphPropertiesOptionsBase>;
+type ParagraphAttrs = AttrNullable<ParagraphPropertiesOptionsBase> & {
+  styleId: string | null;
+  sectionProperties: SectionPropertiesOptions$1 | null;
+  sectionHeaders: HeaderFooterSlots | null;
+  sectionFooters: HeaderFooterSlots | null;
+};
 /**
  * Text style mark attrs — mirrors RunStylePropertiesOptions.
  *
  * Omits properties handled by dedicated marks (bold, italic, strike,
  * doubleStrike, subScript, superScript). `size` is in POINTS.
  */
-type TextStyleAttrs = AttrNullable<Omit<RunStylePropertiesOptions, "bold" | "boldComplexScript" | "italic" | "italicComplexScript" | "strike" | "doubleStrike" | "subScript" | "superScript">>;
+type TextStyleAttrs = AttrNullable<Omit<RunStylePropertiesOptions, "bold" | "boldComplexScript" | "italic" | "italicComplexScript" | "strike" | "doubleStrike" | "subScript" | "superScript">> & {
+  /** Named character style id (OOXML rStyle). Engine-only extra. */styleId: string | null;
+};
+/**
+ * Mention node attrs (official @tiptap/extension-mention).
+ */
+interface MentionAttrs {
+  id: string | null;
+  label: string | null;
+}
+/**
+ * Mathematics node attrs (official @tiptap/extension-mathematics).
+ * Applies to both blockMath (block) and inlineMath (inline).
+ */
+interface MathAttrs {
+  latex: string;
+}
 /**
  * Link mark attrs.
  */
@@ -92,13 +119,11 @@ interface ImageAttrs {
   runPropertiesRawXml: string | null;
 }
 /**
- * Emoji node attrs.
- * `name` is the shortcode (base @tiptap/extension-emoji); `emoji` is the
- * resolved glyph cached for DOCX export (null when only the shortcode is known).
+ * Emoji node attrs. `name` is the shortcode (base @tiptap/extension-emoji); the
+ * glyph is resolved from the emoji dataset at DOCX-compile time.
  */
 interface EmojiAttrs {
   name: string | null;
-  emoji: string | null;
 }
 /**
  * Strike mark attrs.
@@ -145,7 +170,7 @@ type Mark = {
 interface ParagraphNode extends TiptapJSONContent {
   type: "paragraph";
   attrs?: ParagraphAttrs;
-  content?: Array<TextNode | HardBreakNode | ImageNode | EmojiNode>;
+  content?: InlineContent[];
 }
 interface HeadingNode extends TiptapJSONContent {
   type: "heading";
@@ -185,9 +210,7 @@ interface BulletListNode extends TiptapJSONContent {
 interface OrderedListNode extends TiptapJSONContent {
   type: "orderedList";
   attrs?: {
-    start?: number;
-    order?: number;
-    type?: string | null;
+    start?: number | null;
   };
   content?: Array<ListItemNode>;
 }
@@ -232,19 +255,55 @@ interface ImageNode extends TiptapJSONContent {
 }
 /**
  * Drawing group (wpg) carried as an opaque blob — the full WpgGroupRunOptions
- * (pictures/shapes/nested groups + transform) round-trips verbatim. The editor
- * doesn't model the group interior; renderHTML paints the first picture only.
+ * (pictures/shapes/nested groups + transform) round-trips verbatim. renderHTML
+ * lays out every child at its transformed position (Word-style group rendering).
  */
-interface ImageGroupNode extends TiptapJSONContent {
-  type: "imageGroup";
+interface WpgGroupNode extends TiptapJSONContent {
+  type: "wpgGroup";
   attrs?: {
     wpgGroup: Record<string, unknown> | null;
   };
 }
+/**
+ * Standalone floating text-box shape (wp:anchor > wps:wsp) carried as an opaque
+ * blob — the full WpsShapeRunOptions round-trips verbatim. Unlike the group's
+ * interior wps children, this shape floats on its own anchor and renders via the
+ * shared wps interior renderer.
+ */
+interface WpsShapeNode extends TiptapJSONContent {
+  type: "wpsShape";
+  attrs?: {
+    wpsShape: Record<string, unknown> | null;
+  };
+}
 interface EmojiNode extends TiptapJSONContent {
   type: "emoji";
   attrs?: EmojiAttrs;
 }
+interface PageBreakNode extends TiptapJSONContent {
+  type: "pageBreak";
+}
+interface ColumnBreakNode extends TiptapJSONContent {
+  type: "columnBreak";
+}
+interface MentionNode extends TiptapJSONContent {
+  type: "mention";
+  attrs?: MentionAttrs;
+}
+interface InlineMathNode extends TiptapJSONContent {
+  type: "inlineMath";
+  attrs?: MathAttrs;
+}
+interface BlockMathNode extends TiptapJSONContent {
+  type: "blockMath";
+  attrs?: MathAttrs;
+}
+interface PassthroughNode extends TiptapJSONContent {
+  type: "passthrough";
+  attrs?: {
+    data: string;
+  };
+}
 interface DetailsNode extends TiptapJSONContent {
   type: "details";
   content?: Array<DetailsSummaryNode | DetailsContentNode>;
@@ -257,7 +316,7 @@ interface DetailsContentNode extends TiptapJSONContent {
   type: "detailsContent";
   content?: Array<BlockNode>;
 }
-type InlineContent = TextNode | HardBreakNode;
-type BlockNode = ParagraphNode | HeadingNode | BlockquoteNode | CodeBlockNode | HorizontalRuleNode | BulletListNode | OrderedListNode | TaskListNode | TableNode | ImageNode | DetailsNode;
+type InlineContent = TextNode | HardBreakNode | ImageNode | EmojiNode | PageBreakNode | ColumnBreakNode | MentionNode | InlineMathNode;
+type BlockNode = ParagraphNode | HeadingNode | BlockquoteNode | CodeBlockNode | HorizontalRuleNode | BulletListNode | OrderedListNode | TaskListNode | TableNode | WpsShapeNode | WpgGroupNode | DetailsNode | PassthroughNode | BlockMathNode;
 //#endregion
-export { type AlignmentType, type AnyExtension, type AttrNullable, type BlockNode, type BlockquoteNode, type BookmarkOptions, type BorderOptions, type BordersOptions, type BulletListNode, type CodeBlockNode, type DetailsContentNode, type DetailsNode, type DetailsSummaryNode, Document, type DocumentOptions, type DocxEditorOptions, type DocxGenerateOptions, DocxKit, type DocxKitOptions, DocxManager, type DocxPatchContent, type DocxPatchOptions, type EmojiAttrs, type EmojiNode, type EmphasisMarkType, type ExternalHyperlinkOptions, type Floating, type FontAttributesProperties, type FrameOptions, type HardBreakNode, type HeaderFooterSlots, type HeadingLevel, type HeadingNode, type HeightRule, type HighlightColor, type HorizontalRuleNode, type ImageAttrs, type ImageChild, type ImageFetchHandler, type ImageGroupNode, type ImageNode, type ImageOptions, type IndentAttributesProperties, type InlineContent, type InternalHyperlinkOptions, type JSONContent, type LeaderType, type LevelParagraphStylePropertiesOptions, type LineRuleType, type LinkAttrs, type ListItemNode, type Margins, type Mark, type MathChild, type MathInput, type MediaTransformation, type OrderedListNode, type ParagraphAttrs, type ParagraphChild, type ParagraphNode, type ParagraphOptions, type ParagraphPropertiesOptions, type ParagraphPropertiesOptionsBase, type ParagraphRunPropertiesOptions, type ParagraphStylePropertiesOptions, type PrepareStep, type QuickStyleEntry, type RubyOptions, type RunOptions, type RunPropertiesOptions, type RunStylePropertiesOptions, type SectionChild, type SectionOptions, type SectionPropertiesOptions, type ShadingAttributesProperties, type SpacingProperties, type StrikeAttrs, type StylesOptions, type TabStopDefinition, type TabStopPosition, type TabStopType, type TableAttrs, type TableBordersOptions, type TableCellAttrs, type TableCellBordersOptions, type TableCellNode, type TableCellOptions, type TableFloatOptions, type TableHeaderNode, type TableLayoutType, type TableLookOptions, type TableNode, type TableOptions, type TableRowAttrs, type TableRowNode, type TableRowOptions, type TableRowPropertiesOptionsBase, type TableVerticalAlign, type TableWidthProperties, type TaskItemNode, type TaskListNode, type TextAlignmentType, type TextNode, type TextStyleAttrs, type UnderlineType, type WidthType, compileDocument, createDocument, createDocxEditor, docxExtensions, effectiveRunProps, fetchImageHandler, generateDOCX, generateDOCXStream, generateDOCXSync, generateHTML, generateMarkdown, inlineStyles, parseDOCX, parseHTML, parseMarkdown, patchDOCX, prepareDocument, prepareImages, quickStyles, resolveDocument, stylesToCss, tiptapMarkExtensions, tiptapNodeExtensions };
+export { type AlignmentType, type AnyExtension, type AttrNullable, type BlockMathNode, type BlockNode, type BlockquoteNode, type BookmarkOptions, type BorderOptions, type BordersOptions, type BulletListNode, type CodeBlockNode, type ColumnBreakNode, type DetailsContentNode, type DetailsNode, type DetailsSummaryNode, Document, type DocumentOptions, type DocxEditorOptions, type DocxGenerateOptions, DocxKit, type DocxKitOptions, DocxManager, type DocxPatchContent, type DocxPatchOptions, type EmojiAttrs, type EmojiNode, type EmphasisMarkType, type ExternalHyperlinkOptions, type Floating, type FontAttributesProperties, type FrameOptions, type HardBreakNode, type HeaderFooterSlots, type HeadingLevel, type HeadingNode, type HeightRule, type HighlightColor, type HorizontalRuleNode, type ImageAttrs, type ImageFetchHandler, type ImageNode, type ImageOptions, type IndentAttributesProperties, type InlineContent, type InlineMathNode, type InternalHyperlinkOptions, type JSONContent, type LeaderType, type LevelParagraphStylePropertiesOptions, type LineRuleType, type LinkAttrs, type ListItemNode, type Margins, type Mark, type MathAttrs, type MathInput, type MediaTransformation, type MentionAttrs, type MentionNode, type OrderedListNode, PageBreak, type PageBreakNode, type ParagraphAttrs, type ParagraphChild, type ParagraphNode, type ParagraphOptions, type ParagraphPropertiesOptions, type ParagraphPropertiesOptionsBase, type ParagraphRunPropertiesOptions, type ParagraphStylePropertiesOptions, type PassthroughNode, type PrepareStep, type QuickStyleEntry, type RubyOptions, type RunOptions, type RunPropertiesOptions, type RunStylePropertiesOptions, type SectionChild, type SectionOptions, type SectionPropertiesOptions, type ShadingAttributesProperties, type SpacingProperties, type StrikeAttrs, type StylesOptions, type TabStopDefinition, type TabStopPosition, type TabStopType, type TableAttrs, type TableBordersOptions, type TableCellAttrs, type TableCellBordersOptions, type TableCellNode, type TableCellOptions, type TableFloatOptions, type TableHeaderNode, type TableLayoutType, type TableLookOptions, type TableNode, type TableOptions, type TableRowAttrs, type TableRowNode, type TableRowOptions, type TableRowPropertiesOptionsBase, type TableVerticalAlign, type TableWidthProperties, type TaskItemNode, type TaskListNode, type TextAlignmentType, type TextNode, type TextStyleAttrs, type UnderlineType, type WidthType, type WpgGroupNode, type WpsShapeNode, compileDocument, convertMillimetersToTwip, createDocument, createDocxEditor, docxExtensions, effectiveRunProps, fetchImageHandler, generateDOCX, generateDOCXStream, generateDOCXSync, generateHTML, generateMarkdown, inlineStyles, parseDOCX, parseHTML, parseMarkdown, patchDOCX, prepareDocument, prepareImages, quickStyles, resolveDocument, resolveFontName, resolvePageSize, sectionLinePitchCss, sectionMarginCss, sectionMarginDefaults, sectionPageSizeDefaults, stylesToCss, tiptapMarkExtensions, tiptapNodeExtensions, twipsToMm };

package/dist/index.mjs

@@ -1,10 +1,13 @@
-import { a as DocxKit, c as tiptapMarkExtensions, l as tiptapNodeExtensions, s as docxExtensions } from "./core-DEqBHRzE.mjs";
-import { n as createDocument, t as Document } from "./document-CvTym-FM.mjs";
-import { t as createDocxEditor } from "./editor-Bf3CxQnY.mjs";
-import { i as prepareImages, n as prepareDocument, t as fetchImageHandler } from "./prepare-Bdk8Cjkf.mjs";
-import { a as generateDOCXSync, i as generateDOCXStream, n as compileDocument, o as parseDOCX, r as generateDOCX, s as resolveDocument, t as DocxManager } from "./docx-CONyAedl.mjs";
-import { t as patchDOCX } from "./patch-IZ13tXTu.mjs";
-import { n as parseHTML, t as generateHTML } from "./html-DedDWPoO.mjs";
-import { n as parseMarkdown, t as generateMarkdown } from "./markdown-BzJmRsBs.mjs";
-import { a as stylesToCss, i as quickStyles, n as effectiveRunProps, r as inlineStyles } from "./styles-QSX3RhxK.mjs";
-export { Document, DocxKit, DocxManager, compileDocument, createDocument, createDocxEditor, docxExtensions, effectiveRunProps, fetchImageHandler, generateDOCX, generateDOCXStream, generateDOCXSync, generateHTML, generateMarkdown, inlineStyles, parseDOCX, parseHTML, parseMarkdown, patchDOCX, prepareDocument, prepareImages, quickStyles, resolveDocument, stylesToCss, tiptapMarkExtensions, tiptapNodeExtensions };
+import { a as DocxKit, c as tiptapMarkExtensions, g as PageBreak, l as tiptapNodeExtensions, s as docxExtensions } from "./core-DT9IrTzN.mjs";
+import { Document, createDocument } from "./extensions/document.mjs";
+import { resolveFontName, resolvePageSize, sectionLinePitchCss, sectionMarginCss, twipsToMm } from "./extensions/utils.mjs";
+import { createDocxEditor } from "./editor.mjs";
+import { fetchImageHandler, prepareDocument, prepareImages } from "./converters/prepare.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 { effectiveRunProps, inlineStyles, quickStyles, stylesToCss } from "./converters/styles.mjs";
+import { sectionMarginDefaults, sectionPageSizeDefaults } from "@office-open/docx";
+import { convertMillimetersToTwip } from "@office-open/core";
+export { Document, DocxKit, DocxManager, PageBreak, compileDocument, convertMillimetersToTwip, createDocument, createDocxEditor, docxExtensions, effectiveRunProps, fetchImageHandler, generateDOCX, generateDOCXStream, generateDOCXSync, generateHTML, generateMarkdown, inlineStyles, parseDOCX, parseHTML, parseMarkdown, patchDOCX, prepareDocument, prepareImages, quickStyles, resolveDocument, resolveFontName, resolvePageSize, sectionLinePitchCss, sectionMarginCss, sectionMarginDefaults, sectionPageSizeDefaults, stylesToCss, tiptapMarkExtensions, tiptapNodeExtensions, twipsToMm };

package/dist/{tiptap-TErPjuNJ.d.mts → tiptap-pZsNPsvV.d.mts}

@@ -28,6 +28,4 @@ import { Subscript } from "@tiptap/extension-subscript";
 import { Superscript } from "@tiptap/extension-superscript";
 import { TextStyle } from "@tiptap/extension-text-style";
 import { TextAlign } from "@tiptap/extension-text-align";
-import { Dropcursor, Gapcursor, TrailingNode, UndoRedo } from "@tiptap/extensions";
-import { ListKeymap } from "@tiptap/extension-list";
-export { TableCell as A, UndoRedo as B, Mention as C, Subscript as D, Strike as E, Text as F, TextAlign as I, TextStyle as L, TableRow as M, TaskItem as N, Superscript as O, TaskList as P, TrailingNode as R, Mathematics as S, Paragraph as T, Image as _, CodeBlockLowlight as a, ListItem as b, DetailsSummary as c, Emoji as d, Gapcursor as f, HorizontalRule as g, Highlight as h, Code as i, TableHeader as j, Table as k, Document as l, Heading as m, Bold as n, Details as o, HardBreak as p, BulletList as r, DetailsContent as s, Blockquote as t, Dropcursor as u, Italic as v, OrderedList as w, ListKeymap as x, Link as y, Underline as z };
+export { TaskItem as A, Strike as C, TableCell as D, Table as E, Underline as F, Text as M, TextAlign as N, TableHeader as O, TextStyle as P, Paragraph as S, Superscript as T, Link as _, CodeBlockLowlight as a, Mention as b, DetailsSummary as c, HardBreak as d, Heading as f, Italic as g, Image as h, Code as i, TaskList as j, TableRow as k, Document as l, HorizontalRule as m, Bold as n, Details as o, Highlight as p, BulletList as r, DetailsContent as s, Blockquote as t, Emoji as u, ListItem as v, Subscript as w, OrderedList as x, Mathematics as y };

package/dist/utils-D87vukzp.d.mts

@@ -0,0 +1,128 @@
+import { BorderOptions, BordersOptions, IndentAttributesProperties, ShadingAttributesProperties, SpacingProperties } from "@office-open/docx";
+
+//#region src/extensions/utils.d.ts
+/** Normalize a CSS color value to hex (e.g., "red" → "#FF0000", "#ff0000" → "#FF0000").
+ *  Accepts a string (CSS name/hex or bare OOXML hex), or an OOXML ColorOptions
+ *  object ({ val, themeColor, themeTint, themeShade }) — the object form
+ *  resolves to its val (the RGB fallback Word stores alongside themeColor) for
+ *  CSS rendering. The themeColor/tint/shade are preserved verbatim in the attrs
+ *  and round-trip back to the DOCX (see text-style/paragraph parseDocx), so
+ *  theme semantics survive even though only val is rendered here. A pure theme
+ *  reference with no val (rare — Word usually stores both) would need theme.xml
+ *  to resolve and is left unset. */
+declare function normalizeColorToHex(color: unknown): string | undefined;
+/** Resolve a font value (string or OOXML rFonts { ascii, eastAsia, hAnsi, cs }) to a CSS family name. */
+declare function resolveFontName(font: unknown): string | null;
+/** Resolve a font value to a CSS font-family list with an eastAsia fallback.
+ *  Mirrors Word's per-Unicode-range font selection (MS-OE376): Basic Latin uses
+ *  the ascii font, CJK Ideographs use eastAsia. CSS can't split a run by range,
+ *  so list ascii first (it carries Basic Latin glyphs) then eastAsia — the
+ *  browser falls back to eastAsia for CJK chars the ascii font lacks. Without
+ *  this, CJK text renders in the ascii font (e.g. Times) instead of the
+ *  document's CJK font (e.g. SimSun). Use this for font-family rendering;
+ *  resolveFontName (single name) stays for UI/parse. */
+declare function resolveFontFamilyCss(font: unknown): string | null;
+/** CSS value (e.g., "18pt") → twip number. 1 pt = 20 twips, 1 px = 15 twips (96 DPI). */
+declare function cssToTwip(value: string | undefined): number | undefined;
+/** Twip value → CSS string (e.g., 360 → "18pt"). */
+declare function twipToCss(value: number | string | undefined): string | null;
+/** OOXML alignment → CSS text-align. */
+declare function alignmentToCss(alignment: string | null | undefined): string | null;
+/** CSS text-align → OOXML alignment. */
+declare function alignmentFromCss(css: string | null | undefined): string | null;
+/** Shading.fill → CSS background-color hex. */
+declare function shadingToCss(shading: ShadingAttributesProperties | null | undefined): string | null;
+/** CSS background-color → ShadingAttributesProperties (fill normalized to hex). */
+declare function shadingFromCss(css: string | null | undefined): ShadingAttributesProperties | null;
+declare function lineSpacingToCss(spacing: SpacingProperties | null | undefined, snapToGrid?: boolean | null): string | null;
+/** twips → mm (1 in = 1440 tw = 25.4 mm), 2dp string. */
+declare function twipsToMm(twips: number): string;
+/** Resolve a section's printable page dimensions (twips), honoring orientation.
+ *  A landscape section commonly stores portrait dims (w<h) with
+ *  `orientation: "landscape"` — swap width/height so width is the larger edge.
+ *  Falls back to the engine's default page size (@office-open/docx
+ *  `sectionPageSizeDefaults` = A4) when the size is absent or non-numeric — the
+ *  engine's `stringifySectionPropertiesXml` fills an empty sectPr the same way,
+ *  so edit-time geometry matches render/measure/generate/export. */
+declare function resolvePageSize(size: unknown): {
+  width: number;
+  height: number;
+};
+/** Page margin (twips) → CSS padding. Sides absent or non-numeric fall back to
+ *  the engine's default margins (@office-open/docx `sectionMarginDefaults`:
+ *  top/bottom 1440tw, left/right 1800tw — MS Office zh-CN "Normal"), matching
+ *  the page-size fallback above and the engine's empty-sectPr behavior. Margins
+ *  are left as-is: office-open returns them already rotated for a landscape
+ *  section. */
+declare function sectionMarginCss(margin: unknown): string;
+/** Document grid linePitch (twips) → container CSS line-height.
+ *  Per ECMA-376 snapToGrid, the grid linePitch is ADDED to each line (single-
+ *  line paragraphs inherit it). So the container line-height (inherited by
+ *  paragraphs without their own spacing) is the font's `normal` metric + the
+ *  grid pitch, set only when the grid type enables line-snapping (not
+ *  "default"). The --docen-line-pitch var carries the pitch so per-paragraph
+ *  lineSpacingToCss can add the same pitch; --docen-font-metric is injected per
+ *  paragraph by the editor; 1.2 is the fallback for static HTML export. */
+declare function sectionLinePitchCss(grid: unknown): string[];
+declare function sizeToCss(size: number | null | undefined): string | null;
+declare function sizeFromCss(css: string | null | undefined): number | null;
+declare function characterSpacingToCss(spacing: number | null | undefined): string | null;
+declare function characterSpacingFromCss(css: string | null | undefined): number | null;
+/** Render a BorderOptions to CSS string. OOXML border.size is in eighths of a point. */
+declare function renderBorderCSS(border: BorderOptions): string | null;
+/**
+ * Render a drawing's Floating anchor (wp:anchor) to CSS — shared by Image and
+ * WpgGroup so anchored drawings render consistently:
+ *  - wrapNone (type 0): position:absolute at the EMU offset (text does not flow
+ *    around it — "in front of text" / "behind text"); z-index lifts it above or
+ *    below the text layer per behindDocument.
+ *  - topAndBottom (3): float + clear:both.
+ *  - square/tight/through (1/2/4): with an hPos.offset, float:right pulled to
+ *    the offset via margin-right so text wraps beside it with no overlap;
+ *    otherwise float on the wrap side (tight/through add shape-outside, src).
+ * Wrap margins (wp:distT/B/L/R) are EMU, rendered as pt.
+ */
+declare function floatingToStyles(floating: unknown, src?: string, width?: number): string[];
+/**
+ * Where a wrapNone floating drawing's absolute top/left should resolve from.
+ *
+ * verticalPosition.relative (OOXML vRelativeFrom) defaults to "paragraph"
+ * (also "line"); "page"/"margin"/"column" scope to the page box. The drawing is
+ * position:absolute, so its offsetParent decides the origin: a
+ * paragraph-anchored drawing must sit inside a position:relative <p> (the editor
+ * CSS adds that via p:has([data-float-anchor])), otherwise top/left measure
+ * from the page top and the drawing floats over the heading/body instead of
+ * its own blank paragraph (verified on sample anchored drawing groups). Only
+ * relevant for wrapNone (type 0); the float-based wraps stay inline.
+ */
+declare function floatAnchorScope(floating: unknown): "paragraph" | "page";
+/**
+ * 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.
+ */
+declare function renderParagraphStyles(attrs: Record<string, unknown>, opts?: {
+  empty?: boolean;
+}): string[];
+/**
+ * Compute run-level CSS (font/size/color/weight/…) from office-open run attrs.
+ * Shared by text-style marks and the styles→CSS generator (stylesToCss).
+ */
+declare function renderRunStyles(attrs: Record<string, unknown>): string[];
+/**
+ * Compute table cell CSS styles from nested attrs.
+ * Shared by TableCell and TableHeader extensions.
+ */
+declare function renderTableCellStyles(attrs: Record<string, unknown>): string[];
+/** Parse text-align → OOXML alignment. */
+declare function alignmentFromElement(el: HTMLElement): string | null;
+/** Parse margin-left/right + text-indent → OOXML indent (twips). */
+declare function indentFromElement(el: HTMLElement): IndentAttributesProperties | null;
+/** Parse margin-top/bottom + line-height → OOXML spacing (twips). */
+declare function spacingFromElement(el: HTMLElement): SpacingProperties | null;
+/** Parse border-* → OOXML BordersOptions. */
+declare function bordersFromElement(el: HTMLElement): BordersOptions | null;
+/** Parse background-color → OOXML shading. */
+declare function shadingFromElement(el: HTMLElement): ShadingAttributesProperties | null;
+//#endregion
+export { shadingFromElement as C, spacingFromElement as D, sizeToCss as E, twipToCss as O, shadingFromCss as S, sizeFromCss as T, resolveFontFamilyCss as _, characterSpacingFromCss as a, sectionLinePitchCss as b, floatAnchorScope as c, lineSpacingToCss as d, normalizeColorToHex as f, renderTableCellStyles as g, renderRunStyles as h, bordersFromElement as i, twipsToMm as k, floatingToStyles as l, renderParagraphStyles as m, alignmentFromElement as n, characterSpacingToCss as o, renderBorderCSS as p, alignmentToCss as r, cssToTwip as s, alignmentFromCss as t, indentFromElement as u, resolveFontName as v, shadingToCss as w, sectionMarginCss as x, resolvePageSize as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docen/docx",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "DOCX editor and converter powered by @office-open/docx with Tiptap editing layer, supporting bidirectional conversion between DOCX, HTML, and Markdown",
   "keywords": [
     "converter",
@@ -59,46 +59,45 @@
     }
   },
   "dependencies": {
-    "@office-open/docx": "0.10.0",
-    "@tiptap/core": "3.22.5",
-    "@tiptap/extension-blockquote": "3.22.5",
-    "@tiptap/extension-bold": "3.22.5",
-    "@tiptap/extension-bullet-list": "3.22.5",
-    "@tiptap/extension-code": "3.22.5",
-    "@tiptap/extension-code-block": "3.22.5",
-    "@tiptap/extension-code-block-lowlight": "3.22.5",
-    "@tiptap/extension-details": "3.22.5",
-    "@tiptap/extension-document": "3.22.5",
-    "@tiptap/extension-emoji": "3.22.5",
-    "@tiptap/extension-hard-break": "3.22.5",
-    "@tiptap/extension-heading": "3.22.5",
-    "@tiptap/extension-highlight": "3.22.5",
-    "@tiptap/extension-horizontal-rule": "3.22.5",
-    "@tiptap/extension-image": "3.22.5",
-    "@tiptap/extension-italic": "3.22.5",
-    "@tiptap/extension-link": "3.22.5",
-    "@tiptap/extension-list": "3.22.5",
-    "@tiptap/extension-list-item": "3.22.5",
-    "@tiptap/extension-mathematics": "3.22.5",
-    "@tiptap/extension-mention": "3.22.5",
-    "@tiptap/extension-ordered-list": "3.22.5",
-    "@tiptap/extension-paragraph": "3.22.5",
-    "@tiptap/extension-strike": "3.22.5",
-    "@tiptap/extension-subscript": "3.22.5",
-    "@tiptap/extension-superscript": "3.22.5",
-    "@tiptap/extension-table": "3.22.5",
-    "@tiptap/extension-task-item": "3.22.5",
-    "@tiptap/extension-task-list": "3.22.5",
-    "@tiptap/extension-text": "3.22.5",
-    "@tiptap/extension-text-align": "3.22.5",
-    "@tiptap/extension-text-style": "3.22.5",
-    "@tiptap/extension-underline": "3.22.5",
-    "@tiptap/extensions": "3.22.5",
-    "@tiptap/html": "3.22.5",
-    "@tiptap/markdown": "3.22.5",
-    "@tiptap/pm": "3.22.5",
-    "@tiptap/suggestion": "3.22.5",
+    "@office-open/core": "0.10.7",
+    "@office-open/docx": "0.10.7",
+    "@tiptap/core": "3.27.1",
+    "@tiptap/extension-blockquote": "3.27.1",
+    "@tiptap/extension-bold": "3.27.1",
+    "@tiptap/extension-bullet-list": "3.27.1",
+    "@tiptap/extension-code": "3.27.1",
+    "@tiptap/extension-code-block": "3.27.1",
+    "@tiptap/extension-code-block-lowlight": "3.27.1",
+    "@tiptap/extension-details": "3.27.1",
+    "@tiptap/extension-document": "3.27.1",
+    "@tiptap/extension-emoji": "3.27.1",
+    "@tiptap/extension-hard-break": "3.27.1",
+    "@tiptap/extension-heading": "3.27.1",
+    "@tiptap/extension-highlight": "3.27.1",
+    "@tiptap/extension-horizontal-rule": "3.27.1",
+    "@tiptap/extension-image": "3.27.1",
+    "@tiptap/extension-italic": "3.27.1",
+    "@tiptap/extension-link": "3.27.1",
+    "@tiptap/extension-list-item": "3.27.1",
+    "@tiptap/extension-mathematics": "3.27.1",
+    "@tiptap/extension-mention": "3.27.1",
+    "@tiptap/extension-ordered-list": "3.27.1",
+    "@tiptap/extension-paragraph": "3.27.1",
+    "@tiptap/extension-strike": "3.27.1",
+    "@tiptap/extension-subscript": "3.27.1",
+    "@tiptap/extension-superscript": "3.27.1",
+    "@tiptap/extension-table": "3.27.1",
+    "@tiptap/extension-task-item": "3.27.1",
+    "@tiptap/extension-task-list": "3.27.1",
+    "@tiptap/extension-text": "3.27.1",
+    "@tiptap/extension-text-align": "3.27.1",
+    "@tiptap/extension-text-style": "3.27.1",
+    "@tiptap/extension-underline": "3.27.1",
+    "@tiptap/markdown": "3.27.1",
+    "@tiptap/pm": "3.27.1",
+    "@tiptap/suggestion": "3.27.1",
     "image-meta": "0.2.2",
+    "linkedom": "0.18.12",
     "lowlight": "3.3.0"
   },
   "scripts": {

package/dist/blockquote-Ky9xD_Q-.mjs

@@ -1,31 +0,0 @@
-import "./tiptap-D7pl4I5U.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_INDENT_LEFT as n, applyBlockquoteStyle as r, BLOCKQUOTE_BORDER as t };

package/dist/code-block-BgNjhADy.mjs

@@ -1,23 +0,0 @@
-import { a as CodeBlockLowlight } from "./tiptap-D7pl4I5U.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 { renderDocx as n, CodeBlock as t };