@docen/extensions 0.0.12 → 0.0.13

package/README.md

@@ -1,315 +1,315 @@
-# @docen/extensions
-
-![npm version](https://img.shields.io/npm/v/@docen/extensions)
-![npm downloads](https://img.shields.io/npm/dw/@docen/extensions)
-![npm license](https://img.shields.io/npm/l/@docen/extensions)
-
-> Curated collection of TipTap extensions with comprehensive TypeScript type definitions for Docen.
-
-## Features
-
-- 📦 **All-in-One Package** - All Docen-required extensions in a single dependency
-- 🔒 **Full Type Safety** - Comprehensive TypeScript definitions for all content nodes and marks
-- 🎯 **Curated Selection** - Only includes extensions actively used in Docen, no bloat
-- 📤 **Type Exports** - Direct access to all node types (DocumentNode, ParagraphNode, etc.)
-- 🚀 **Ready to Use** - Pre-configured extension arrays for blocks and marks
-
-## Installation
-
-```bash
-# Install with npm
-$ npm install @docen/extensions
-
-# Install with yarn
-$ yarn add @docen/extensions
-
-# Install with pnpm
-$ pnpm add @docen/extensions
-```
-
-## Quick Start
-
-```typescript
-import { tiptapExtensions, tiptapMarkExtensions } from "@docen/extensions";
-
-const editor = new Editor({
-  extensions: [
-    ...tiptapExtensions, // All block extensions
-    ...tiptapMarkExtensions, // All mark extensions
-  ],
-  content: "<p>Hello, world!</p>",
-});
-```
-
-## Exports
-
-### Extension Arrays
-
-**`tiptapExtensions`** - Block-level extensions:
-
-- Document - Root document node
-- Paragraph - Standard paragraphs
-- Heading - H1-H6 headings
-- Blockquote - Blockquote sections
-- CodeBlock - Code blocks with Lowlight syntax highlighting
-- HorizontalRule - Horizontal dividers
-- Image - Image embedding
-- Details - Collapsible details/summary sections
-- Table - Table containers
-- TableRow - Table rows
-- TableCell - Table body cells
-- TableHeader - Table header cells
-- BulletList - Unordered lists
-- OrderedList - Ordered lists with start support
-- ListItem - List item containers
-- TaskList - Task list containers
-- TaskItem - Task items with checkboxes
-
-**`tiptapMarkExtensions`** - Text formatting marks:
-
-- Bold - **Bold text**
-- Italic - _Italic text_
-- Underline - <u>Underlined text</u>
-- Strike - ~~Strikethrough text~~
-- Code - `Inline code`
-- Highlight - Text highlighting
-- Subscript - Sub~script~
-- Superscript - Super^script^
-- TextStyle - Text styling (colors, fonts, sizes)
-- Link - Hyperlinks with href, target, rel attributes
-
-### TypeScript Types
-
-This package exports comprehensive TypeScript types for type-safe development:
-
-```typescript
-import type {
-  // Root and document types
-  JSONContent,
-
-  // Block nodes
-  DocumentNode,
-  ParagraphNode,
-  HeadingNode,
-  BlockquoteNode,
-  CodeBlockNode,
-  HorizontalRuleNode,
-  ImageNode,
-  DetailsNode,
-
-  // List nodes
-  BulletListNode,
-  OrderedListNode,
-  ListItemNode,
-  TaskListNode,
-  TaskItemNode,
-
-  // Table nodes
-  TableNode,
-  TableRowNode,
-  TableCellNode,
-  TableHeaderNode,
-
-  // Text nodes
-  TextNode,
-  HardBreakNode,
-
-  // Type unions
-  BlockNode,
-  TextContent,
-} from "@docen/extensions";
-```
-
-### Type Definitions
-
-**Content Nodes:**
-
-```typescript
-// Paragraph with text alignment and spacing
-interface ParagraphNode {
-  type: "paragraph";
-  attrs?: {
-    textAlign?: "left" | "right" | "center" | "justify";
-    indentLeft?: number;
-    indentRight?: number;
-    indentFirstLine?: number;
-    spacingBefore?: number;
-    spacingAfter?: number;
-  };
-  content?: Array<TextContent>;
-}
-
-// Heading with level and spacing
-interface HeadingNode {
-  type: "heading";
-  attrs: {
-    level: 1 | 2 | 3 | 4 | 5 | 6;
-    indentLeft?: number;
-    indentRight?: number;
-    indentFirstLine?: number;
-    spacingBefore?: number;
-    spacingAfter?: number;
-  };
-  content?: Array<TextContent>;
-}
-
-// Table with colspan/rowspan
-interface TableCellNode {
-  type: "tableCell" | "tableHeader";
-  attrs?: {
-    colspan?: number;
-    rowspan?: number;
-    colwidth?: number[] | null;
-  };
-  content?: Array<ParagraphNode>;
-}
-
-// Image with attributes (extended from TipTap)
-interface ImageNode {
-  type: "image";
-  attrs?: {
-    src: string;
-    alt?: string | null;
-    title?: string | null;
-    width?: number | null;
-    height?: number | null;
-    rotation?: number; // Rotation in degrees (not in TipTap core)
-    floating?: ImageFloatingOptions; // Floating positioning options (not in TipTap core)
-    outline?: ImageOutlineOptions; // Border/outline options (not in TipTap core)
-  };
-}
-```
-
-**Text and Marks:**
-
-```typescript
-// Text node with marks
-interface TextNode {
-  type: "text";
-  text: string;
-  marks?: Array<Mark>;
-}
-
-// Mark with attributes
-interface Mark {
-  type:
-    | "bold"
-    | "italic"
-    | "underline"
-    | "strike"
-    | "code"
-    | "textStyle"
-    | "link"
-    | "highlight"
-    | "subscript"
-    | "superscript";
-  attrs?: {
-    // TextStyle attributes
-    color?: string;
-    backgroundColor?: string;
-    fontSize?: string;
-    fontFamily?: string;
-    lineHeight?: string;
-
-    // Link attributes
-    href?: string;
-    target?: string;
-    rel?: string;
-    class?: string | null;
-
-    // Other attributes
-    [key: string]: unknown;
-  };
-}
-```
-
-## Usage Examples
-
-### Type-Safe Content Creation
-
-```typescript
-import type { JSONContent, ParagraphNode } from "@docen/extensions";
-
-const doc: JSONContent = {
-  type: "doc",
-  content: [
-    {
-      type: "paragraph",
-      content: [
-        {
-          type: "text",
-          marks: [{ type: "bold" }],
-          text: "Hello, world!",
-        },
-      ],
-    },
-  ],
-};
-
-// Type narrowing with type guards
-function isParagraph(node: JSONContent): node is ParagraphNode {
-  return node.type === "paragraph";
-}
-```
-
-### Working with Tables
-
-```typescript
-import type { TableNode, TableCellNode } from "@docen/extensions";
-
-const table: TableNode = {
-  type: "table",
-  content: [
-    {
-      type: "tableRow",
-      content: [
-        {
-          type: "tableHeader",
-          attrs: { colspan: 2, rowspan: 1 },
-          content: [
-            {
-              type: "paragraph",
-              content: [{ type: "text", text: "Header" }],
-            },
-          ],
-        },
-      ],
-    },
-  ],
-};
-```
-
-### Custom Editor Setup
-
-```typescript
-import { Editor } from "@tiptap/core";
-import { tiptapExtensions } from "@docen/extensions";
-
-const editor = new Editor({
-  extensions: [
-    ...tiptapExtensions,
-    // Add your custom extensions here
-  ],
-});
-```
-
-## Import Paths
-
-This package provides two import paths for flexibility:
-
-```typescript
-// Main entry point - extensions and types
-import { tiptapExtensions, tiptapMarkExtensions } from "@docen/extensions";
-import type { JSONContent, ParagraphNode } from "@docen/extensions";
-
-// Types-only path for type definitions
-import type { JSONContent } from "@docen/extensions/types";
-```
-
-## Contributing
-
-Contributions are welcome! Please read our [Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/) and submit pull requests to the [main repository](https://github.com/DemoMacro/docen).
-
-## License
-
-- [MIT](LICENSE) &copy; [Demo Macro](https://imst.xyz/)
+# @docen/extensions
+
+![npm version](https://img.shields.io/npm/v/@docen/extensions)
+![npm downloads](https://img.shields.io/npm/dw/@docen/extensions)
+![npm license](https://img.shields.io/npm/l/@docen/extensions)
+
+> Curated collection of TipTap extensions with comprehensive TypeScript type definitions for Docen.
+
+## Features
+
+- 📦 **All-in-One Package** - All Docen-required extensions in a single dependency
+- 🔒 **Full Type Safety** - Comprehensive TypeScript definitions for all content nodes and marks
+- 🎯 **Curated Selection** - Only includes extensions actively used in Docen, no bloat
+- 📤 **Type Exports** - Direct access to all node types (DocumentNode, ParagraphNode, etc.)
+- 🚀 **Ready to Use** - Pre-configured extension arrays for blocks and marks
+
+## Installation
+
+```bash
+# Install with npm
+$ npm install @docen/extensions
+
+# Install with yarn
+$ yarn add @docen/extensions
+
+# Install with pnpm
+$ pnpm add @docen/extensions
+```
+
+## Quick Start
+
+```typescript
+import { tiptapExtensions, tiptapMarkExtensions } from "@docen/extensions";
+
+const editor = new Editor({
+  extensions: [
+    ...tiptapExtensions, // All block extensions
+    ...tiptapMarkExtensions, // All mark extensions
+  ],
+  content: "<p>Hello, world!</p>",
+});
+```
+
+## Exports
+
+### Extension Arrays
+
+**`tiptapExtensions`** - Block-level extensions:
+
+- Document - Root document node
+- Paragraph - Standard paragraphs
+- Heading - H1-H6 headings
+- Blockquote - Blockquote sections
+- CodeBlock - Code blocks with Lowlight syntax highlighting
+- HorizontalRule - Horizontal dividers
+- Image - Image embedding
+- Details - Collapsible details/summary sections
+- Table - Table containers
+- TableRow - Table rows
+- TableCell - Table body cells
+- TableHeader - Table header cells
+- BulletList - Unordered lists
+- OrderedList - Ordered lists with start support
+- ListItem - List item containers
+- TaskList - Task list containers
+- TaskItem - Task items with checkboxes
+
+**`tiptapMarkExtensions`** - Text formatting marks:
+
+- Bold - **Bold text**
+- Italic - _Italic text_
+- Underline - <u>Underlined text</u>
+- Strike - ~~Strikethrough text~~
+- Code - `Inline code`
+- Highlight - Text highlighting
+- Subscript - Sub~script~
+- Superscript - Super^script^
+- TextStyle - Text styling (colors, fonts, sizes)
+- Link - Hyperlinks with href, target, rel attributes
+
+### TypeScript Types
+
+This package exports comprehensive TypeScript types for type-safe development:
+
+```typescript
+import type {
+  // Root and document types
+  JSONContent,
+
+  // Block nodes
+  DocumentNode,
+  ParagraphNode,
+  HeadingNode,
+  BlockquoteNode,
+  CodeBlockNode,
+  HorizontalRuleNode,
+  ImageNode,
+  DetailsNode,
+
+  // List nodes
+  BulletListNode,
+  OrderedListNode,
+  ListItemNode,
+  TaskListNode,
+  TaskItemNode,
+
+  // Table nodes
+  TableNode,
+  TableRowNode,
+  TableCellNode,
+  TableHeaderNode,
+
+  // Text nodes
+  TextNode,
+  HardBreakNode,
+
+  // Type unions
+  BlockNode,
+  TextContent,
+} from "@docen/extensions";
+```
+
+### Type Definitions
+
+**Content Nodes:**
+
+```typescript
+// Paragraph with text alignment and spacing
+interface ParagraphNode {
+  type: "paragraph";
+  attrs?: {
+    textAlign?: "left" | "right" | "center" | "justify";
+    indentLeft?: number;
+    indentRight?: number;
+    indentFirstLine?: number;
+    spacingBefore?: number;
+    spacingAfter?: number;
+  };
+  content?: Array<TextContent>;
+}
+
+// Heading with level and spacing
+interface HeadingNode {
+  type: "heading";
+  attrs: {
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    indentLeft?: number;
+    indentRight?: number;
+    indentFirstLine?: number;
+    spacingBefore?: number;
+    spacingAfter?: number;
+  };
+  content?: Array<TextContent>;
+}
+
+// Table with colspan/rowspan
+interface TableCellNode {
+  type: "tableCell" | "tableHeader";
+  attrs?: {
+    colspan?: number;
+    rowspan?: number;
+    colwidth?: number[] | null;
+  };
+  content?: Array<ParagraphNode>;
+}
+
+// Image with attributes (extended from TipTap)
+interface ImageNode {
+  type: "image";
+  attrs?: {
+    src: string;
+    alt?: string | null;
+    title?: string | null;
+    width?: number | null;
+    height?: number | null;
+    rotation?: number; // Rotation in degrees (not in TipTap core)
+    floating?: ImageFloatingOptions; // Floating positioning options (not in TipTap core)
+    outline?: ImageOutlineOptions; // Border/outline options (not in TipTap core)
+  };
+}
+```
+
+**Text and Marks:**
+
+```typescript
+// Text node with marks
+interface TextNode {
+  type: "text";
+  text: string;
+  marks?: Array<Mark>;
+}
+
+// Mark with attributes
+interface Mark {
+  type:
+    | "bold"
+    | "italic"
+    | "underline"
+    | "strike"
+    | "code"
+    | "textStyle"
+    | "link"
+    | "highlight"
+    | "subscript"
+    | "superscript";
+  attrs?: {
+    // TextStyle attributes
+    color?: string;
+    backgroundColor?: string;
+    fontSize?: string;
+    fontFamily?: string;
+    lineHeight?: string;
+
+    // Link attributes
+    href?: string;
+    target?: string;
+    rel?: string;
+    class?: string | null;
+
+    // Other attributes
+    [key: string]: unknown;
+  };
+}
+```
+
+## Usage Examples
+
+### Type-Safe Content Creation
+
+```typescript
+import type { JSONContent, ParagraphNode } from "@docen/extensions";
+
+const doc: JSONContent = {
+  type: "doc",
+  content: [
+    {
+      type: "paragraph",
+      content: [
+        {
+          type: "text",
+          marks: [{ type: "bold" }],
+          text: "Hello, world!",
+        },
+      ],
+    },
+  ],
+};
+
+// Type narrowing with type guards
+function isParagraph(node: JSONContent): node is ParagraphNode {
+  return node.type === "paragraph";
+}
+```
+
+### Working with Tables
+
+```typescript
+import type { TableNode, TableCellNode } from "@docen/extensions";
+
+const table: TableNode = {
+  type: "table",
+  content: [
+    {
+      type: "tableRow",
+      content: [
+        {
+          type: "tableHeader",
+          attrs: { colspan: 2, rowspan: 1 },
+          content: [
+            {
+              type: "paragraph",
+              content: [{ type: "text", text: "Header" }],
+            },
+          ],
+        },
+      ],
+    },
+  ],
+};
+```
+
+### Custom Editor Setup
+
+```typescript
+import { Editor } from "@tiptap/core";
+import { tiptapExtensions } from "@docen/extensions";
+
+const editor = new Editor({
+  extensions: [
+    ...tiptapExtensions,
+    // Add your custom extensions here
+  ],
+});
+```
+
+## Import Paths
+
+This package provides two import paths for flexibility:
+
+```typescript
+// Main entry point - extensions and types
+import { tiptapExtensions, tiptapMarkExtensions } from "@docen/extensions";
+import type { JSONContent, ParagraphNode } from "@docen/extensions";
+
+// Types-only path for type definitions
+import type { JSONContent } from "@docen/extensions/types";
+```
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/) and submit pull requests to the [main repository](https://github.com/DemoMacro/docen).
+
+## License
+
+- [MIT](LICENSE) &copy; [Demo Macro](https://imst.xyz/)

package/dist/index.mjs

@@ -180,6 +180,41 @@ const Paragraph = Paragraph$1.extend({ addAttributes() {
 			default: null,
 			parseHTML: (element) => element.style.marginBottom || null,
 			renderHTML: (attributes) => attributes.spacingAfter ? { style: `margin-bottom: ${attributes.spacingAfter}` } : {}
+		},
+		shading: {
+			default: null,
+			parseHTML: (element) => {
+				const bg = element.style.backgroundColor;
+				if (!bg) return null;
+				return {
+					fill: bg.startsWith("#") ? bg : `#${bg}`,
+					type: "clear"
+				};
+			},
+			renderHTML: (attributes) => {
+				if (!attributes.shading?.fill) return {};
+				return { style: `background-color: ${attributes.shading.fill}` };
+			}
+		},
+		borderTop: {
+			default: null,
+			parseHTML: () => null,
+			renderHTML: () => ({})
+		},
+		borderBottom: {
+			default: null,
+			parseHTML: () => null,
+			renderHTML: () => ({})
+		},
+		borderLeft: {
+			default: null,
+			parseHTML: () => null,
+			renderHTML: () => ({})
+		},
+		borderRight: {
+			default: null,
+			parseHTML: () => null,
+			renderHTML: () => ({})
 		}
 	};
 } });

package/dist/types.d.mts

@@ -1,7 +1,220 @@
 import { JSONContent } from "@tiptap/core";
-import { IFloating, IHorizontalPositionOptions, IImageOptions, IVerticalPositionOptions } from "docx";
 
+//#region ../../node_modules/.pnpm/docx@9.6.1/node_modules/docx/dist/index.d.ts
+declare const CompoundLine: {
+  readonly SINGLE: "sng";
+  readonly DOUBLE: "dbl";
+  readonly THICK_THIN: "thickThin";
+  readonly THIN_THICK: "thinThick";
+  readonly TRI: "tri";
+};
+declare type CoreImageOptions = {
+  readonly transformation: IMediaTransformation;
+  readonly floating?: IFloating;
+  readonly altText?: DocPropertiesOptions;
+  readonly outline?: OutlineOptions;
+  readonly solidFill?: SolidFillOptions;
+};
+declare type DocPropertiesOptions = {
+  readonly name: string;
+  readonly description?: string;
+  readonly title?: string;
+  readonly id?: string;
+};
+declare const HorizontalPositionAlign: {
+  readonly CENTER: "center";
+  readonly INSIDE: "inside";
+  readonly LEFT: "left";
+  readonly OUTSIDE: "outside";
+  readonly RIGHT: "right";
+};
+declare const HorizontalPositionRelativeFrom: {
+  readonly CHARACTER: "character";
+  readonly COLUMN: "column";
+  readonly INSIDE_MARGIN: "insideMargin";
+  readonly LEFT_MARGIN: "leftMargin";
+  readonly MARGIN: "margin";
+  readonly OUTSIDE_MARGIN: "outsideMargin";
+  readonly PAGE: "page";
+  readonly RIGHT_MARGIN: "rightMargin";
+};
+declare type IDistance = {
+  readonly distT?: number;
+  readonly distB?: number;
+  readonly distL?: number;
+  readonly distR?: number;
+};
+declare type IFloating = {
+  readonly horizontalPosition: IHorizontalPositionOptions;
+  readonly verticalPosition: IVerticalPositionOptions;
+  readonly allowOverlap?: boolean;
+  readonly lockAnchor?: boolean;
+  readonly behindDocument?: boolean;
+  readonly layoutInCell?: boolean;
+  readonly margins?: IMargins;
+  readonly wrap?: ITextWrapping;
+  readonly zIndex?: number;
+};
+declare type IHorizontalPositionOptions = {
+  readonly relative?: (typeof HorizontalPositionRelativeFrom)[keyof typeof HorizontalPositionRelativeFrom];
+  readonly align?: (typeof HorizontalPositionAlign)[keyof typeof HorizontalPositionAlign];
+  readonly offset?: number;
+};
+declare type IImageOptions = (RegularImageOptions | SvgMediaOptions) & CoreImageOptions;
+declare type IMargins = {
+  readonly left?: number;
+  readonly bottom?: number;
+  readonly top?: number;
+  readonly right?: number;
+};
+declare type IMediaTransformation = {
+  readonly offset?: {
+    readonly top?: number;
+    readonly left?: number;
+  };
+  readonly width: number;
+  readonly height: number;
+  readonly flip?: {
+    readonly vertical?: boolean;
+    readonly horizontal?: boolean;
+  };
+  readonly rotation?: number;
+};
+declare type ITextWrapping = {
+  readonly type: (typeof TextWrappingType)[keyof typeof TextWrappingType];
+  readonly side?: (typeof TextWrappingSide)[keyof typeof TextWrappingSide];
+  readonly margins?: IDistance;
+};
+declare type IVerticalPositionOptions = {
+  readonly relative?: (typeof VerticalPositionRelativeFrom)[keyof typeof VerticalPositionRelativeFrom];
+  readonly align?: (typeof VerticalPositionAlign)[keyof typeof VerticalPositionAlign];
+  readonly offset?: number;
+};
+declare const LineCap: {
+  readonly ROUND: "rnd";
+  readonly SQUARE: "sq";
+  readonly FLAT: "flat";
+};
+declare type OutlineAttributes = {
+  readonly width?: number;
+  readonly cap?: keyof typeof LineCap;
+  readonly compoundLine?: keyof typeof CompoundLine;
+  readonly align?: keyof typeof PenAlignment;
+};
+declare type OutlineFillProperties = OutlineNoFill | OutlineSolidFill;
+declare type OutlineNoFill = {
+  readonly type: "noFill";
+};
+declare type OutlineOptions = OutlineAttributes & OutlineFillProperties;
+declare type OutlineRgbSolidFill = {
+  readonly type: "solidFill";
+  readonly solidFillType: "rgb";
+  readonly value: string;
+};
+declare type OutlineSchemeSolidFill = {
+  readonly type: "solidFill";
+  readonly solidFillType: "scheme";
+  readonly value: (typeof SchemeColor)[keyof typeof SchemeColor];
+};
+declare type OutlineSolidFill = OutlineRgbSolidFill | OutlineSchemeSolidFill;
+declare const PenAlignment: {
+  readonly CENTER: "ctr";
+  readonly INSET: "in";
+};
+declare type RegularImageOptions = {
+  readonly type: "jpg" | "png" | "gif" | "bmp";
+  readonly data: Buffer | string | Uint8Array | ArrayBuffer;
+};
+declare type RgbColorOptions = {
+  readonly type: "rgb";
+  readonly value: string;
+};
+declare const SchemeColor: {
+  readonly BG1: "bg1";
+  readonly TX1: "tx1";
+  readonly BG2: "bg2";
+  readonly TX2: "tx2";
+  readonly ACCENT1: "accent1";
+  readonly ACCENT2: "accent2";
+  readonly ACCENT3: "accent3";
+  readonly ACCENT4: "accent4";
+  readonly ACCENT5: "accent5";
+  readonly ACCENT6: "accent6";
+  readonly HLINK: "hlink";
+  readonly FOLHLINK: "folHlink";
+  readonly DK1: "dk1";
+  readonly LT1: "lt1";
+  readonly DK2: "dk2";
+  readonly LT2: "lt2";
+  readonly PHCLR: "phClr";
+};
+declare type SchemeColorOptions = {
+  readonly type: "scheme";
+  readonly value: (typeof SchemeColor)[keyof typeof SchemeColor];
+};
+declare type SolidFillOptions = RgbColorOptions | SchemeColorOptions;
+declare type SvgMediaOptions = {
+  readonly type: "svg";
+  readonly data: Buffer | string | Uint8Array | ArrayBuffer;
+  readonly fallback: RegularImageOptions;
+};
+declare const TextWrappingSide: {
+  readonly BOTH_SIDES: "bothSides";
+  readonly LEFT: "left";
+  readonly RIGHT: "right";
+  readonly LARGEST: "largest";
+};
+declare const TextWrappingType: {
+  readonly NONE: 0;
+  readonly SQUARE: 1;
+  readonly TIGHT: 2;
+  readonly TOP_AND_BOTTOM: 3;
+};
+declare const VerticalPositionAlign: {
+  readonly BOTTOM: "bottom";
+  readonly CENTER: "center";
+  readonly INSIDE: "inside";
+  readonly OUTSIDE: "outside";
+  readonly TOP: "top";
+};
+declare const VerticalPositionRelativeFrom: {
+  readonly BOTTOM_MARGIN: "bottomMargin";
+  readonly INSIDE_MARGIN: "insideMargin";
+  readonly LINE: "line";
+  readonly MARGIN: "margin";
+  readonly OUTSIDE_MARGIN: "outsideMargin";
+  readonly PAGE: "page";
+  readonly PARAGRAPH: "paragraph";
+  readonly TOP_MARGIN: "topMargin";
+};
+//#endregion
 //#region src/types.d.ts
+/**
+ * Border definition (compatible with docx.js BorderOptions)
+ * Used by paragraphs, table cells, and blockquotes
+ */
+interface Border {
+  /** Border color (hex without #, e.g., "FF0000" or "auto") */
+  color?: string;
+  /** Border size (eighth-points, 1/8 pt) */
+  size?: number;
+  /** Border style */
+  style?: "single" | "dashed" | "dotted" | "double" | "dotDash" | "dotDotDash" | "none";
+  /** Space between border and content (points) */
+  space?: number;
+}
+/**
+ * Shading definition (compatible with docx.js ShadingOptions)
+ * Used for paragraph and table cell background colors
+ */
+interface Shading {
+  /** Fill color (hex without #, e.g., "FF0000") */
+  fill?: string;
+  /** Pattern color (hex without #) */
+  color?: string;
+  /** Shading pattern type (e.g., "clear", "percent-10") */
+  type?: string;
+}
 type ImageFloatingOptions = {
   horizontalPosition: IHorizontalPositionOptions;
   verticalPosition: IVerticalPositionOptions;
@@ -44,6 +257,11 @@ interface ParagraphNode extends JSONContent {
     indentFirstLine?: string;
     spacingBefore?: string;
     spacingAfter?: string;
+    shading?: Shading;
+    borderTop?: Border;
+    borderBottom?: Border;
+    borderLeft?: Border;
+    borderRight?: Border;
   };
   content?: Array<TextNode | HardBreakNode | ImageNode>;
 }
@@ -57,6 +275,11 @@ interface HeadingNode extends JSONContent {
     spacingBefore?: string;
     spacingAfter?: string;
     textAlign?: "left" | "right" | "center" | "justify";
+    shading?: Shading;
+    borderTop?: Border;
+    borderBottom?: Border;
+    borderLeft?: Border;
+    borderRight?: Border;
   };
   content?: Array<TextNode | HardBreakNode>;
 }
@@ -102,11 +325,6 @@ interface TaskItemNode extends JSONContent {
   };
   content?: Array<ParagraphNode>;
 }
-interface TableCellBorder {
-  color?: string;
-  width?: number;
-  style?: "solid" | "dashed" | "dotted" | "double" | "none";
-}
 interface TableNode extends JSONContent {
   type: "table";
   attrs?: {
@@ -132,10 +350,10 @@ interface TableCellNode extends JSONContent {
     colwidth?: number[] | null;
     backgroundColor?: string | null;
     verticalAlign?: "top" | "middle" | "bottom" | null;
-    borderTop?: TableCellBorder | null;
-    borderBottom?: TableCellBorder | null;
-    borderLeft?: TableCellBorder | null;
-    borderRight?: TableCellBorder | null;
+    borderTop?: Border;
+    borderBottom?: Border;
+    borderLeft?: Border;
+    borderRight?: Border;
   };
   content?: Array<ParagraphNode>;
 }
@@ -147,10 +365,10 @@ interface TableHeaderNode extends JSONContent {
     colwidth?: number[] | null;
     backgroundColor?: string | null;
     verticalAlign?: "top" | "middle" | "bottom" | null;
-    borderTop?: TableCellBorder | null;
-    borderBottom?: TableCellBorder | null;
-    borderLeft?: TableCellBorder | null;
-    borderRight?: TableCellBorder | null;
+    borderTop?: Border;
+    borderBottom?: Border;
+    borderLeft?: Border;
+    borderRight?: Border;
   };
   content?: Array<ParagraphNode>;
 }
@@ -182,4 +400,4 @@ interface DetailsContentNode extends JSONContent {
 type TextContent = TextNode | HardBreakNode;
 type BlockNode = ParagraphNode | HeadingNode | BlockquoteNode | CodeBlockNode | HorizontalRuleNode | BulletListNode | OrderedListNode | TaskListNode | TableNode | ImageNode | DetailsNode;
 //#endregion
-export { BlockNode, BlockquoteNode, BulletListNode, CodeBlockNode, DetailsContentNode, DetailsNode, DetailsSummaryNode, DocumentNode, HardBreakNode, HeadingNode, HorizontalRuleNode, ImageFloatingOptions, ImageNode, ImageOutlineOptions, type JSONContent, ListItemNode, Mark, OrderedListNode, ParagraphNode, TableCellBorder, TableCellNode, TableHeaderNode, TableNode, TableRowNode, TaskItemNode, TaskListNode, TextContent, TextNode };
+export { BlockNode, BlockquoteNode, Border, BulletListNode, CodeBlockNode, DetailsContentNode, DetailsNode, DetailsSummaryNode, DocumentNode, HardBreakNode, HeadingNode, HorizontalRuleNode, ImageFloatingOptions, ImageNode, ImageOutlineOptions, type JSONContent, ListItemNode, Mark, OrderedListNode, ParagraphNode, Shading, TableCellNode, TableHeaderNode, TableNode, TableRowNode, TaskItemNode, TaskListNode, TextContent, TextNode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docen/extensions",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "Collection of TipTap extensions with TypeScript type definitions for Docen",
   "keywords": [
     "docen",
@@ -47,37 +47,42 @@
     }
   },
   "dependencies": {
-    "@tiptap/core": "3.20.1",
-    "@tiptap/extension-blockquote": "3.20.1",
-    "@tiptap/extension-bold": "3.20.1",
-    "@tiptap/extension-bullet-list": "3.20.1",
-    "@tiptap/extension-code": "3.20.1",
-    "@tiptap/extension-code-block-lowlight": "3.20.1",
-    "@tiptap/extension-details": "3.20.1",
-    "@tiptap/extension-document": "3.20.1",
-    "@tiptap/extension-emoji": "3.20.1",
-    "@tiptap/extension-hard-break": "3.20.1",
-    "@tiptap/extension-heading": "3.20.1",
-    "@tiptap/extension-highlight": "3.20.1",
-    "@tiptap/extension-horizontal-rule": "3.20.1",
-    "@tiptap/extension-image": "3.20.1",
-    "@tiptap/extension-italic": "3.20.1",
-    "@tiptap/extension-link": "3.20.1",
-    "@tiptap/extension-list-item": "3.20.1",
-    "@tiptap/extension-mathematics": "3.20.1",
-    "@tiptap/extension-mention": "3.20.1",
-    "@tiptap/extension-ordered-list": "3.20.1",
-    "@tiptap/extension-paragraph": "3.20.1",
-    "@tiptap/extension-strike": "3.20.1",
-    "@tiptap/extension-subscript": "3.20.1",
-    "@tiptap/extension-superscript": "3.20.1",
-    "@tiptap/extension-table": "3.20.1",
-    "@tiptap/extension-task-item": "3.20.1",
-    "@tiptap/extension-task-list": "3.20.1",
-    "@tiptap/extension-text": "3.20.1",
-    "@tiptap/extension-text-align": "3.20.1",
-    "@tiptap/extension-text-style": "3.20.1",
-    "@tiptap/extension-underline": "3.20.1",
+    "@tiptap/core": "3.20.0",
+    "@tiptap/extension-blockquote": "3.20.0",
+    "@tiptap/extension-bold": "3.20.0",
+    "@tiptap/extension-bullet-list": "3.20.0",
+    "@tiptap/extension-code": "3.20.0",
+    "@tiptap/extension-code-block": "3.20.0",
+    "@tiptap/extension-code-block-lowlight": "3.20.0",
+    "@tiptap/extension-details": "3.20.0",
+    "@tiptap/extension-document": "3.20.0",
+    "@tiptap/extension-emoji": "3.20.0",
+    "@tiptap/extension-hard-break": "3.20.0",
+    "@tiptap/extension-heading": "3.20.0",
+    "@tiptap/extension-highlight": "3.20.0",
+    "@tiptap/extension-horizontal-rule": "3.20.0",
+    "@tiptap/extension-image": "3.20.0",
+    "@tiptap/extension-italic": "3.20.0",
+    "@tiptap/extension-link": "3.20.0",
+    "@tiptap/extension-list": "3.20.0",
+    "@tiptap/extension-list-item": "3.20.0",
+    "@tiptap/extension-mathematics": "3.20.0",
+    "@tiptap/extension-mention": "3.20.0",
+    "@tiptap/extension-ordered-list": "3.20.0",
+    "@tiptap/extension-paragraph": "3.20.0",
+    "@tiptap/extension-strike": "3.20.0",
+    "@tiptap/extension-subscript": "3.20.0",
+    "@tiptap/extension-superscript": "3.20.0",
+    "@tiptap/extension-table": "3.20.0",
+    "@tiptap/extension-task-item": "3.20.0",
+    "@tiptap/extension-task-list": "3.20.0",
+    "@tiptap/extension-text": "3.20.0",
+    "@tiptap/extension-text-align": "3.20.0",
+    "@tiptap/extension-text-style": "3.20.0",
+    "@tiptap/extension-underline": "3.20.0",
+    "@tiptap/suggestion": "3.20.0"
+  },
+  "devDependencies": {
     "docx": "9.6.1"
   },
   "scripts": {