@harbour-enterprises/superdoc 0.20.0-next.8 → 0.20.0-next.9

package/dist/chunks/{super-editor.es-sBfWb5tn.es.js → super-editor.es-DqX3Ipsk.es.js}

@@ -14842,6 +14842,14 @@ function ptToTwips(pt) {
   if (pt == null) return;
   return pt * 20;
 }
+function rotToDegrees(rot) {
+  if (rot == null) return;
+  return rot / 6e4;
+}
+function degreesToRot(degrees) {
+  if (degrees == null) return;
+  return degrees * 6e4;
+}
 const getTextIndentExportValue = (indent) => {
   const [value, unit] = parseSizeUnit(indent);
   const functionsMap = {
@@ -26855,6 +26863,32 @@ function handleImageNode(node, params2, isAnchor) {
   if (!picture || !picture.elements) return null;
   const blipFill = picture.elements.find((el) => el.name === "pic:blipFill");
   const blip = blipFill.elements.find((el) => el.name === "a:blip");
+  const spPr = picture.elements.find((el) => el.name === "pic:spPr");
+  let transformData = {};
+  if (spPr) {
+    const xfrm = spPr.elements.find((el) => el.name === "a:xfrm");
+    if (xfrm?.attributes) {
+      transformData = {
+        rotation: rotToDegrees(xfrm.attributes["rot"]),
+        verticalFlip: xfrm.attributes["flipV"] === "1",
+        horizontalFlip: xfrm.attributes["flipH"] === "1"
+      };
+    }
+  }
+  const effectExtent = node.elements.find((el) => el.name === "wp:effectExtent");
+  if (effectExtent) {
+    const sanitizeEmuValue = (value) => {
+      if (value === null || value === void 0) return 0;
+      const numeric = Number(value);
+      return Number.isFinite(numeric) ? numeric : 0;
+    };
+    transformData.sizeExtension = {
+      left: emuToPixels(sanitizeEmuValue(effectExtent.attributes["l"])),
+      top: emuToPixels(sanitizeEmuValue(effectExtent.attributes["t"])),
+      right: emuToPixels(sanitizeEmuValue(effectExtent.attributes["r"])),
+      bottom: emuToPixels(sanitizeEmuValue(effectExtent.attributes["b"]))
+    };
+  }
   const positionHTag = node.elements.find((el) => el.name === "wp:positionH");
   const positionH = positionHTag?.elements.find((el) => el.name === "wp:posOffset");
   const positionHValue = emuToPixels(positionH?.elements[0]?.text);
@@ -26911,6 +26945,7 @@ function handleImageNode(node, params2, isAnchor) {
       size: size2,
       anchorData,
       isAnchor,
+      transformData,
       ...simplePos && {
         simplePos: {
           x: simplePos.attributes.x,
@@ -27062,6 +27097,31 @@ const translateImageNode = (params2) => {
     distL: 0,
     distR: 0
   };
+  const xfrmAttrs = {};
+  const effectExtentAttrs = {
+    l: 0,
+    t: 0,
+    r: 0,
+    b: 0
+  };
+  const transformData = attrs.transformData;
+  if (transformData) {
+    if (transformData.rotation) {
+      xfrmAttrs.rot = degreesToRot(transformData.rotation);
+    }
+    if (transformData.verticalFlip) {
+      xfrmAttrs.flipV = "1";
+    }
+    if (transformData.horizontalFlip) {
+      xfrmAttrs.flipH = "1";
+    }
+    if (transformData.sizeExtension) {
+      effectExtentAttrs.l = pixelsToEmu(transformData.sizeExtension.left);
+      effectExtentAttrs.t = pixelsToEmu(transformData.sizeExtension.top);
+      effectExtentAttrs.r = pixelsToEmu(transformData.sizeExtension.right);
+      effectExtentAttrs.b = pixelsToEmu(transformData.sizeExtension.bottom);
+    }
+  }
   const drawingXmlns = "http://schemas.openxmlformats.org/drawingml/2006/main";
   const pictureXmlns = "http://schemas.openxmlformats.org/drawingml/2006/picture";
   return {
@@ -27076,12 +27136,7 @@ const translateImageNode = (params2) => {
       },
       {
         name: "wp:effectExtent",
-        attributes: {
-          l: 0,
-          t: 0,
-          r: 0,
-          b: 0
-        }
+        attributes: effectExtentAttrs
       },
       {
         name: "wp:docPr",
@@ -27161,6 +27216,7 @@ const translateImageNode = (params2) => {
                     elements: [
                       {
                         name: "a:xfrm",
+                        attributes: xfrmAttrs,
                         elements: [
                           {
                             name: "a:ext",
@@ -31363,8 +31419,8 @@ function addDefaultStylesIfMissing(styles) {
 }
 const importHeadersFooters = (docx, converter, mainEditor) => {
   const rels = docx["word/_rels/document.xml.rels"];
-  const relationships = rels.elements.find((el) => el.name === "Relationships");
-  const { elements } = relationships;
+  const relationships = rels?.elements.find((el) => el.name === "Relationships");
+  const { elements } = relationships || { elements: [] };
   const headerType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/header";
   const footerType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer";
   const headers = elements.filter((el) => el.attributes["Type"] === headerType);
@@ -42322,12 +42378,6 @@ const History = Extension.create({
   name: "history",
   addOptions() {
     return {
-      /**
-       * @typedef {Object} HistoryOptions
-       * @category Options
-       * @property {number} [depth=100] - Maximum undo/redo steps to remember
-       * @property {number} [newGroupDelay=500] - Milliseconds to wait before starting a new history group
-       */
       depth: 100,
       newGroupDelay: 500
     };
@@ -42346,9 +42396,8 @@ const History = Extension.create({
       /**
        * Undo the last action
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * undo()
+       * editor.commands.undo()
        * @note Groups changes within the newGroupDelay window
        */
       undo: () => ({ state: state2, dispatch, tr }) => {
@@ -42362,9 +42411,8 @@ const History = Extension.create({
       /**
        * Redo the last undone action
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * redo()
+       * editor.commands.redo()
        * @note Only available after an undo action
        */
       redo: () => ({ state: state2, dispatch, tr }) => {
@@ -49283,6 +49331,7 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
       return result;
     } catch (error) {
       this.emit("exception", { error, editor: this });
+      console.error(error);
     }
   }
   /**
@@ -49306,6 +49355,7 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
       this.converter.footerEditors.length = 0;
     } catch (error) {
       this.emit("exception", { error, editor: this });
+      console.error(error);
     }
   }
   /**
@@ -49894,6 +49944,7 @@ endCollaboration_fn = function() {
     if (this.options.ydoc) this.options.ydoc.destroy();
   } catch (error) {
     this.emit("exception", { error, editor: this });
+    console.error(error);
   }
 };
 validateDocumentInit_fn = function() {
@@ -49920,11 +49971,6 @@ const Color = Extension.create({
   name: "color",
   addOptions() {
     return {
-      /**
-       * @typedef {Object} ColorOptions
-       * @category Options
-       * @property {string[]} [types=['textStyle']] - Mark types to add color support to
-       */
       types: ["textStyle"]
     };
   },
@@ -49933,10 +49979,6 @@ const Color = Extension.create({
       {
         types: this.options.types,
         attributes: {
-          /**
-           * @category Attribute
-           * @param {ColorValue} [color] - Text color value
-           */
           color: {
             default: null,
             parseDOM: (el) => el.style.color?.replace(/['"]+/g, ""),
@@ -49955,16 +49997,17 @@ const Color = Extension.create({
        * Set text color
        * @category Command
        * @param {ColorValue} color - Color value to apply
-       * @returns {Function} Command function
        * @example
        * // Set to red using hex
-       * setColor('#ff0000')
+       * editor.commands.setColor('#ff0000')
        *
+       * @example
        * // Set using rgb
-       * setColor('rgb(255, 0, 0)')
+       * editor.commands.setColor('rgb(255, 0, 0)')
        *
+       * @example
        * // Set using named color
-       * setColor('blue')
+       * editor.commands.setColor('blue')
        * @note Preserves other text styling attributes
        */
       setColor: (color) => ({ chain }) => {
@@ -49973,9 +50016,8 @@ const Color = Extension.create({
       /**
        * Remove text color
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * unsetColor()
+       * editor.commands.unsetColor()
        * @note Removes color while preserving other text styles
        */
       unsetColor: () => ({ chain }) => {
@@ -49988,11 +50030,6 @@ const FontFamily = Extension.create({
   name: "fontFamily",
   addOptions() {
     return {
-      /**
-       * @typedef {Object} FontFamilyOptions
-       * @category Options
-       * @property {string[]} [types=['textStyle']] - Mark types to add font family support to
-       */
       types: ["textStyle"]
     };
   },
@@ -50001,10 +50038,6 @@ const FontFamily = Extension.create({
       {
         types: this.options.types,
         attributes: {
-          /**
-           * @category Attribute
-           * @param {FontFamilyValue} [fontFamily] - Font family for text
-           */
           fontFamily: {
             default: null,
             parseDOM: (el) => el.style.fontFamily?.replace(/['"]+/g, ""),
@@ -50023,13 +50056,13 @@ const FontFamily = Extension.create({
        * Set font family
        * @category Command
        * @param {FontFamilyValue} fontFamily - Font family to apply
-       * @returns {Function} Command function
        * @example
        * // Set to Arial
-       * setFontFamily('Arial')
+       * editor.commands.setFontFamily('Arial')
        *
+       * @example
        * // Set to serif font
-       * setFontFamily('Georgia, serif')
+       * editor.commands.setFontFamily('Georgia, serif')
        * @note Preserves other text styling attributes
        */
       setFontFamily: (fontFamily2) => ({ chain }) => {
@@ -50038,9 +50071,8 @@ const FontFamily = Extension.create({
       /**
        * Remove font family
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * unsetFontFamily()
+       * editor.commands.unsetFontFamily()
        * @note Reverts to default document font
        */
       unsetFontFamily: () => ({ chain }) => {
@@ -50053,12 +50085,6 @@ const FontSize = Extension.create({
   name: "fontSize",
   addOptions() {
     return {
-      /**
-       * @typedef {Object} FontSizeOptions
-       * @category Options
-       * @property {string[]} [types=['textStyle', 'tableCell']] - Node/mark types to add font size support to
-       * @property {FontSizeDefaults} [defaults] - Default size configuration
-       */
       types: ["textStyle", "tableCell"],
       defaults: {
         value: 12,
@@ -50073,10 +50099,6 @@ const FontSize = Extension.create({
       {
         types: this.options.types,
         attributes: {
-          /**
-           * @category Attribute
-           * @param {FontSizeValue} [fontSize] - Font size with unit
-           */
           fontSize: {
             default: null,
             parseDOM: (el) => el.style.fontSize,
@@ -50098,16 +50120,10 @@ const FontSize = Extension.create({
        * Set font size
        * @category Command
        * @param {FontSizeValue} fontSize - Size to apply (with optional unit)
-       * @returns {Function} Command function
        * @example
-       * // Set to 14pt
-       * setFontSize('14pt')
-       *
-       * // Set to 18px
-       * setFontSize('18px')
-       *
-       * // Set without unit (uses default)
-       * setFontSize(16)
+       * editor.commands.setFontSize('14pt')
+       * editor.commands.setFontSize('18px')
+       * editor.commands.setFontSize(16)
        * @note Automatically clamps to min/max values
        */
       setFontSize: (fontSize2) => ({ chain }) => {
@@ -50129,9 +50145,8 @@ const FontSize = Extension.create({
       /**
        * Remove font size
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * unsetFontSize()
+       * editor.commands.unsetFontSize()
        * @note Reverts to default document size
        */
       unsetFontSize: () => ({ chain }) => {
@@ -50181,13 +50196,9 @@ const TextAlign = Extension.create({
        * Set text alignment
        * @category Command
        * @param {string} alignment - Alignment value (left, center, right, justify)
-       * @returns {Function} Command function
        * @example
-       * // Set to center
-       * setTextAlign('center')
-       *
-       * // Set to justify
-       * setTextAlign('justify')
+       * editor.commands.setTextAlign('center')
+       * editor.commands.setTextAlign('justify')
        * @note Applies to all configured node types (heading, paragraph by default)
        */
       setTextAlign: (alignment2) => ({ commands: commands2 }) => {
@@ -50198,9 +50209,8 @@ const TextAlign = Extension.create({
       /**
        * Remove text alignment (reset to default)
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * unsetTextAlign()
+       * editor.commands.unsetTextAlign()
        * @note Resets alignment to the default value
        */
       unsetTextAlign: () => ({ commands: commands2 }) => {
@@ -50341,13 +50351,6 @@ const LineHeight = Extension.create({
   name: "lineHeight",
   addOptions() {
     return {
-      /**
-       * @typedef {Object} LineHeightOptions
-       * @category Options
-       * @property {string[]} [types=['heading', 'paragraph']] - Block types to add line height support to
-       * @property {Object} [defaults] - Default configuration
-       * @property {string} [defaults.unit=''] - Default unit for line height values
-       */
       types: ["heading", "paragraph"],
       defaults: {
         unit: ""
@@ -50359,10 +50362,6 @@ const LineHeight = Extension.create({
       {
         types: this.options.types,
         attributes: {
-          /**
-           * @category Attribute
-           * @param {LineHeightValue} [lineHeight] - Line height value
-           */
           lineHeight: {
             default: null,
             parseDOM: (el) => el.style.lineHeight,
@@ -50388,16 +50387,10 @@ const LineHeight = Extension.create({
        * Set line height for blocks
        * @category Command
        * @param {LineHeightValue} lineHeight - Line height to apply
-       * @returns {Function} Command function
        * @example
-       * // Set to 1.5x spacing
-       * setLineHeight(1.5)
-       *
-       * // Set to 24px spacing
-       * setLineHeight('24px')
-       *
-       * // Set to double spacing
-       * setLineHeight(2)
+       * editor.commands.setLineHeight(1.5)
+       * editor.commands.setLineHeight('24px')
+       * editor.commands.setLineHeight(2)
        * @note Applies to paragraphs and headings
        */
       setLineHeight: (lineHeight2) => ({ commands: commands2 }) => {
@@ -50407,9 +50400,8 @@ const LineHeight = Extension.create({
       /**
        * Remove line height
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * unsetLineHeight()
+       * editor.commands.unsetLineHeight()
        * @note Reverts to default line spacing
        */
       unsetLineHeight: () => ({ commands: commands2 }) => {
@@ -50437,9 +50429,8 @@ const FormatCommands = Extension.create({
       /**
        * Clear all formatting (nodes and marks)
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * clearFormat()
+       * editor.commands.clearFormat()
        * @note Removes all marks and resets nodes to default paragraph
        */
       clearFormat: () => ({ chain }) => {
@@ -50448,9 +50439,8 @@ const FormatCommands = Extension.create({
       /**
        * Clear only mark formatting
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * clearMarksFormat()
+       * editor.commands.clearMarksFormat()
        * @note Removes bold, italic, underline, colors, etc. but preserves block structure
        */
       clearMarksFormat: () => ({ chain }) => {
@@ -50459,9 +50449,8 @@ const FormatCommands = Extension.create({
       /**
        * Clear only node formatting
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * clearNodesFormat()
+       * editor.commands.clearNodesFormat()
        * @note Converts headings, lists, etc. to paragraphs but preserves text marks
        */
       clearNodesFormat: () => ({ chain }) => {
@@ -50470,13 +50459,8 @@ const FormatCommands = Extension.create({
       /**
        * Copy format from selection or apply copied format
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * // First call: copy format from selection
-       * copyFormat()
-       *
-       * // Second call: apply copied format to new selection
-       * copyFormat()
+       * editor.commands.copyFormat()
        * @note Works like format painter - first click copies, second click applies
        */
       copyFormat: () => ({ chain }) => {
@@ -50889,6 +50873,9 @@ function drawGapCursor(state2) {
 }
 const Gapcursor = Extension.create({
   name: "gapCursor",
+  addOptions() {
+    return {};
+  },
   addPmPlugins() {
     return [gapCursor()];
   },
@@ -51229,6 +51216,9 @@ function getCursorPositionRelativeToContainer(view, eventLocation) {
 const SlashMenuPluginKey = new PluginKey("slashMenu");
 const SlashMenu = Extension.create({
   name: "slashMenu",
+  addOptions() {
+    return {};
+  },
   addPmPlugins() {
     if (this.editor.options?.disableContextMenu) {
       return [];
@@ -51366,11 +51356,6 @@ const Document = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @private
-       * @category Attribute
-       * @param {Object} [attributes] - Internal document attributes
-       */
       attributes: {
         rendered: false,
         "aria-label": "Document node"
@@ -51382,10 +51367,10 @@ const Document = Node$1.create({
       /**
        * Get document statistics
        * @category Command
-       * @returns {Function} Command function
        * @example
        * // Get word and character count
-       * getDocumentStats()
+       * const stats = editor.commands.getDocumentStats()
+       * console.log(`${stats.words} words, ${stats.characters} characters`)
        * @note Returns word count, character count, and paragraph count
        */
       getDocumentStats: () => ({ editor }) => {
@@ -51402,9 +51387,8 @@ const Document = Node$1.create({
       /**
        * Clear entire document
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * clearDocument()
+       * editor.commands.clearDocument()
        * @note Replaces all content with an empty paragraph
        */
       clearDocument: () => ({ commands: commands2 }) => {
@@ -51416,13 +51400,19 @@ const Document = Node$1.create({
 const Text = Node$1.create({
   name: "text",
   group: "inline",
-  inline: true
+  inline: true,
+  addOptions() {
+    return {};
+  }
 });
 const RunItem = Node$1.create({
   name: "run",
   group: "inline",
   content: "text*",
   inline: true,
+  addOptions() {
+    return {};
+  },
   parseDOM() {
     return [{ tag: "run" }];
   },
@@ -51448,14 +51438,6 @@ const BulletList = Node$1.create({
   },
   addOptions() {
     return {
-      /**
-       * @typedef {Object} BulletListOptions
-       * @category Options
-       * @property {string} [itemTypeName='listItem'] - Name of the list item node type
-       * @property {Object} [htmlAttributes] - HTML attributes for the ul element
-       * @property {boolean} [keepMarks=true] - Whether to preserve marks when splitting
-       * @property {boolean} [keepAttributes=false] - Whether to preserve attributes when splitting
-       */
       itemTypeName: "listItem",
       htmlAttributes: {
         "aria-label": "Bullet list node"
@@ -51473,27 +51455,13 @@ const BulletList = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {string} [list-style-type='bullet'] - List style type for this list
-       */
       "list-style-type": {
         default: "bullet",
         rendered: false
       },
-      /**
-       * @private
-       * @category Attribute
-       * @param {string} [listId] - Internal list identifier for numbering
-       */
       listId: {
         rendered: false
       },
-      /**
-       * @private
-       * @category Attribute
-       * @param {string} [sdBlockId] - Internal block tracking ID
-       */
       sdBlockId: {
         default: null,
         keepOnSplit: false,
@@ -51502,11 +51470,6 @@ const BulletList = Node$1.create({
           return attrs.sdBlockId ? { "data-sd-block-id": attrs.sdBlockId } : {};
         }
       },
-      /**
-       * @private
-       * @category Attribute
-       * @param {Object} [attributes] - Additional attributes for the list
-       */
       attributes: {
         rendered: false,
         keepOnSplit: true
@@ -51518,10 +51481,9 @@ const BulletList = Node$1.create({
       /**
        * Toggle a bullet list at the current selection
        * @category Command
-       * @returns {Function} Command function
        * @example
        * // Toggle bullet list on selected text
-       * toggleBulletList()
+       * editor.commands.toggleBulletList()
        * @note Converts selected paragraphs to list items or removes list formatting
        */
       toggleBulletList: () => (params2) => {
@@ -51640,9 +51602,25 @@ const OrderedList = Node$1.create({
   },
   addCommands() {
     return {
+      /**
+       * Toggle ordered list formatting
+       * @category Command
+       * @example
+       * editor.commands.toggleOrderedList()
+       * @note Converts selection to ordered list or back to paragraphs
+       */
       toggleOrderedList: () => (params2) => {
         return toggleList(this.type)(params2);
       },
+      /**
+       * Restart list node numbering
+       * @category Command
+       * @param {Array} followingNodes - Nodes to restart
+       * @param {number} pos - Starting position
+       * @example
+       * editor.commands.restartListNodes(nodes, position)
+       * @note Resets list numbering for specified nodes
+       */
       restartListNodes: (followingNodes, pos) => ({ tr }) => {
         let currentNodePos = pos;
         const nodes = followingNodes.map((node) => {
@@ -51661,8 +51639,11 @@ const OrderedList = Node$1.create({
         return true;
       },
       /**
-       * Updates ordered list style type when sink or lift `listItem`.
-       * @example 1,2,3 -> a,b,c -> i,ii,iii -> 1,2,3 -> etc
+       * Update ordered list style type based on nesting level
+       * @category Command
+       * @example
+       * editor.commands.updateOrderedListStyleType()
+       * @note Cycles through decimal -> lowerAlpha -> lowerRoman based on depth
        */
       updateOrderedListStyleType: () => ({ dispatch, tr }) => {
         let list = findParentNode((node) => node.type.name === this.name)(tr.selection);
@@ -51939,7 +51920,7 @@ const CustomSelection = Extension.create({
        * @returns {Function} Command function
        * @example
        * // Restore selection after toolbar interaction
-       * restorePreservedSelection()
+       * editor.commands.restorePreservedSelection()
        * @note Used internally to maintain selection when interacting with toolbar
        */
       restorePreservedSelection: () => ({ tr, state: state2 }) => {
@@ -52228,6 +52209,9 @@ const LinkedStyles = Extension.create({
   name: "linkedStyles",
   priority: 1,
   // We need this plugin to run before the list plugins
+  addOptions() {
+    return {};
+  },
   addPmPlugins() {
     return [createLinkedStylesPlugin(this.editor)];
   },
@@ -52236,11 +52220,10 @@ const LinkedStyles = Extension.create({
       /**
        * Apply a linked style to the selected paragraphs
        * @category Command
-       * @param {Object} style - The style object to apply
-       * @returns {Function} Command function
+       * @param {LinkedStyle} style - The style object to apply
        * @example
        * const style = editor.helpers.linkedStyles.getStyleById('Heading1');
-       * setLinkedStyle(style);
+       * editor.commands.setLinkedStyle(style);
        * @note Clears existing formatting when applying a style
        * @note Works with custom selection preservation
        */
@@ -52251,16 +52234,12 @@ const LinkedStyles = Extension.create({
       /**
        * Toggle a linked style on the current selection
        * @category Command
-       * @param {Object} style - The linked style to apply (with id property)
+       * @param {LinkedStyle} style - The linked style to apply (with id property)
        * @param {string|null} [nodeType=null] - Node type to restrict toggle to (e.g., 'paragraph')
-       * @returns {Function} Command function
        * @example
-       * // Toggle a heading style
        * const style = editor.helpers.linkedStyles.getStyleById('Heading1');
-       * toggleLinkedStyle(style)
-       *
-       * // Toggle only on paragraph nodes
-       * toggleLinkedStyle(style, 'paragraph')
+       * editor.commands.toggleLinkedStyle(style)
+       * editor.commands.toggleLinkedStyle(style, 'paragraph')
        * @note If selection is empty, returns false
        * @note Removes style if already applied, applies it if not
        */
@@ -52288,13 +52267,9 @@ const LinkedStyles = Extension.create({
        * Apply a linked style by its ID
        * @category Command
        * @param {string} styleId - The style ID to apply (e.g., 'Heading1')
-       * @returns {Function} Command function
        * @example
-       * // Apply a heading style
-       * setStyleById('Heading1')
-       *
-       * // Apply a normal style
-       * setStyleById('Normal')
+       * editor.commands.setStyleById('Heading1')
+       * editor.commands.setStyleById('Normal')
        * @note Looks up the style from loaded Word styles
        */
       setStyleById: (styleId) => (params2) => {
@@ -53002,12 +52977,6 @@ const Paragraph = OxmlNode.create({
   inline: false,
   addOptions() {
     return {
-      /**
-       * @typedef {Object} HeadingOptions
-       * @category Options
-       * @property {number[]} [headingLevels=[1,2,3,4,5,6]] - Supported heading levels
-       * @property {Object} [htmlAttributes] - HTML attributes for paragraph elements
-       */
       headingLevels: [1, 2, 3, 4, 5, 6],
       htmlAttributes: {}
     };
@@ -53239,11 +53208,6 @@ const Heading = Extension.create({
   name: "heading",
   addOptions() {
     return {
-      /**
-       * @typedef {Object} HeadingOptions
-       * @category Options
-       * @property {number[]} [levels=[1,2,3,4,5,6]] - Supported heading levels
-       */
       levels: [1, 2, 3, 4, 5, 6]
     };
   },
@@ -53253,10 +53217,8 @@ const Heading = Extension.create({
        * Set a heading with specified level
        * @category Command
        * @param {HeadingAttributes} attributes - Heading attributes including level
-       * @returns {Function} Command function
        * @example
-       * // Set heading level 2
-       * setHeading({ level: 2 })
+       * editor.commands.setHeading({ level: 2 })
        * @note Converts current block to heading
        */
       setHeading: (attributes) => ({ commands: commands2 }) => {
@@ -53268,13 +53230,9 @@ const Heading = Extension.create({
        * Toggle between heading and paragraph
        * @category Command
        * @param {HeadingAttributes} attributes - Heading attributes including level
-       * @returns {Function} Command function
        * @example
-       * // Toggle heading level 1
-       * toggleHeading({ level: 1 })
-       *
-       * // Toggle heading level 3
-       * toggleHeading({ level: 3 })
+       * editor.commands.toggleHeading({ level: 1 })
+       * editor.commands.toggleHeading({ level: 3 })
        * @note Switches between heading and paragraph for the same level
        */
       toggleHeading: (attributes) => ({ commands: commands2 }) => {
@@ -53679,6 +53637,9 @@ const LineBreak = Node$1.create({
   selectable: false,
   content: "",
   atom: true,
+  addOptions() {
+    return {};
+  },
   parseDOM() {
     return [{ tag: "br" }];
   },
@@ -53687,17 +53648,7 @@ const LineBreak = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @private
-       * @category Attribute
-       * @param {string} [lineBreakType] - Type of line break - passthrough in this node
-       */
       lineBreakType: { rendered: false },
-      /**
-       * @private
-       * @category Attribute
-       * @param {string} [clear] - Clear attribute - passthrough in this node
-       */
       clear: { rendered: false }
     };
   },
@@ -53706,9 +53657,8 @@ const LineBreak = Node$1.create({
       /**
        * Insert a line break
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * insertLineBreak()
+       * editor.commands.insertLineBreak()
        * @note Creates a soft break within the same paragraph
        */
       insertLineBreak: () => ({ commands: commands2 }) => {
@@ -53725,11 +53675,6 @@ const HardBreak = Node$1.create({
   atom: true,
   addOptions() {
     return {
-      /**
-       * @typedef {Object} HardBreakOptions
-       * @category Options
-       * @property {Object} [htmlAttributes] - HTML attributes for the break element
-       */
       htmlAttributes: {
         contentEditable: "false",
         lineBreakType: "page",
@@ -53740,35 +53685,15 @@ const HardBreak = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @private
-       * @category Attribute
-       * @param {string} [pageBreakSource] - Source of the page break
-       */
       pageBreakSource: {
         rendered: false,
         default: null
       },
-      /**
-       * @private
-       * @category Attribute
-       * @param {string} [pageBreakType] - Type of page break
-       */
       pageBreakType: {
         default: null,
         rendered: false
       },
-      /**
-       * @private
-       * @category Attribute
-       * @param {string} [lineBreakType] - Type of line break - passthrough in this node
-       */
       lineBreakType: { rendered: false },
-      /**
-       * @private
-       * @category Attribute
-       * @param {string} [clear] - Clear attribute - passthrough in this node
-       */
       clear: { rendered: false }
     };
   },
@@ -53794,9 +53719,8 @@ const HardBreak = Node$1.create({
       /**
        * Insert a page break
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * insertPageBreak()
+       * editor.commands.insertPageBreak()
        * @note Forces content to start on a new page when printed
        */
       insertPageBreak: () => ({ commands: commands2 }) => {
@@ -56186,17 +56110,6 @@ const Table = Node$1.create({
   group: "block",
   isolating: true,
   tableRole: "table",
-  /**
-   * Table extension options
-   * @category Options
-   * @typedef {Object} TableOptions
-   * @property {Object} [htmlAttributes={'aria-label': 'Table node'}] - Default HTML attributes for all tables
-   * @property {boolean} [resizable=true] - Enable column resizing functionality
-   * @property {number} [handleWidth=5] - Width of resize handles in pixels
-   * @property {number} [cellMinWidth=10] - Minimum cell width constraint in pixels
-   * @property {boolean} [lastColumnResizable=true] - Allow resizing of the last column
-   * @property {boolean} [allowTableNodeSelection=false] - Enable selecting the entire table node
-   */
   addOptions() {
     return {
       htmlAttributes: {
@@ -56354,14 +56267,9 @@ const Table = Node$1.create({
        * Insert a new table into the document
        * @category Command
        * @param {TableConfig} [config] - Table configuration options
-       * @returns {Function} Command
        * @example
-       * // Using default values
-       * insertTable() // Creates 3x3 table without header
-       *
-       * // Using custom values
-       * insertTable({ rows: 3, cols: 3, withHeaderRow: true })
-       *
+       * editor.commands.insertTable()
+       * editor.commands.insertTable({ rows: 3, cols: 3, withHeaderRow: true })
        */
       insertTable: ({ rows = 3, cols = 3, withHeaderRow = false } = {}) => ({ tr, dispatch, editor }) => {
         const node = createTable(editor.schema, rows, cols, withHeaderRow);
@@ -56374,9 +56282,8 @@ const Table = Node$1.create({
       /**
        * Delete the entire table containing the cursor
        * @category Command
-       * @returns {Function} Command
        * @example
-       * deleteTable()
+       * editor.commands.deleteTable()
        */
       deleteTable: () => ({ state: state2, dispatch }) => {
         return deleteTable(state2, dispatch);
@@ -56384,9 +56291,8 @@ const Table = Node$1.create({
       /**
        * Add a column before the current column
        * @category Command
-       * @returns {Function} Command
        * @example
-       * addColumnBefore()
+       * editor.commands.addColumnBefore()
        * @note Preserves cell attributes from current column
        */
       addColumnBefore: () => ({ state: state2, dispatch, chain }) => {
@@ -56763,10 +56669,9 @@ const Table = Node$1.create({
        * Set background color for selected cells
        * @category Command
        * @param {string} value - Color value (hex with or without #)
-       * @returns {Function} Command
        * @example
-       * setCellBackground('#ff0000')
-       * setCellBackground('ff0000')
+       * editor.commands.setCellBackground('#ff0000')
+       * editor.commands.setCellBackground('ff0000')
        */
       setCellBackground: (value) => ({ editor, commands: commands2, dispatch }) => {
         const { selection } = editor.state;
@@ -56892,24 +56797,12 @@ const TableHeader = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {number} [colspan=1] - Number of columns this header spans
-       */
       colspan: {
         default: 1
       },
-      /**
-       * @category Attribute
-       * @param {number} [rowspan=1] - Number of rows this header spans
-       */
       rowspan: {
         default: 1
       },
-      /**
-       * @category Attribute
-       * @param {number[]} [colwidth] - Column widths array in pixels
-       */
       colwidth: {
         default: null,
         parseDOM: (element) => {
@@ -56946,10 +56839,6 @@ const TableRow = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {number} [rowHeight] - Fixed row height in pixels
-       */
       rowHeight: {
         renderDOM({ rowHeight }) {
           if (!rowHeight) return {};
@@ -56957,11 +56846,6 @@ const TableRow = Node$1.create({
           return { style: style2 };
         }
       },
-      /**
-       * Indicates that this row should not be split across pages when paginating/exporting.
-       * @category Attribute
-       * @param {boolean} [cantSplit]
-       */
       cantSplit: {
         default: false,
         parseDOM() {
@@ -56973,44 +56857,30 @@ const TableRow = Node$1.create({
         }
       },
       /**
-       * @category Attribute
-       * @param {TableRowProperties} [tableRowProperties] - Properties for the table row.
        * @see {@link https://ecma-international.org/publications-and-standards/standards/ecma-376/} "Fundamentals And Markup Language Reference", page 377-482
        */
       tableRowProperties: { rendered: false },
       /**
-       * @category Attribute
-       * @param {string} [rsidDel] - Unique identifier used to track the editing session when the row was deleted from the main document.
        * @see {@link https://ecma-international.org/publications-and-standards/standards/ecma-376/} "Fundamentals And Markup Language Reference", page 472
        */
       rsidDel: { rendered: false },
       /**
-       * @category Attribute
-       * @param {string} [rsidR] - Unique identifier used to track the editing session when the table row was added to the main document.
        * @see {@link https://ecma-international.org/publications-and-standards/standards/ecma-376/} "Fundamentals And Markup Language Reference", page 472
        */
       rsidR: { rendered: false },
       /**
-       * @category Attribute
-       * @param {string} [rsidRPr] - Unique identifier used to track the editing session when the glyph character representing the table row mark was last modified in the main document.
        * @see {@link https://ecma-international.org/publications-and-standards/standards/ecma-376/} "Fundamentals And Markup Language Reference", page 473
        */
       rsidRPr: { rendered: false },
       /**
-       * @category Attribute
-       * @param {string} [rsidTr] - Unique identifier used to track the editing session when the table row's properties were last modified in this document.
        * @see {@link https://ecma-international.org/publications-and-standards/standards/ecma-376/} "Fundamentals And Markup Language Reference", page 473
        */
       rsidTr: { rendered: false },
       /**
-       * @category Attribute
-       * @param {string} [paraId] - A randomly generated unique identifier for the table row.
        * @see {@link https://learn.microsoft.com/en-us/openspecs/office_standards/ms-docx/a0e7d2e2-2246-44c6-96e8-1cf009823615}
        */
       paraId: { rendered: false },
       /**
-       * @category Attribute
-       * @param {string} [textId] - A randomly generated unique identifier for the text of the table row.
        * @see {@link https://learn.microsoft.com/en-us/openspecs/office_standards/ms-docx/b7eeddec-7c50-47fb-88b6-1feec3ed832c}
        */
       textId: { rendered: false }
@@ -57037,24 +56907,12 @@ const TableCell = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {number} [colspan=1] - Number of columns this cell spans
-       */
       colspan: {
         default: 1
       },
-      /**
-       * @category Attribute
-       * @param {number} [rowspan=1] - Number of rows this cell spans
-       */
       rowspan: {
         default: 1
       },
-      /**
-       * @category Attribute
-       * @param {number[]} [colwidth=[100]] - Column widths array in pixels
-       */
       colwidth: {
         default: [100],
         parseDOM: (elem) => {
@@ -57069,10 +56927,6 @@ const TableCell = Node$1.create({
           };
         }
       },
-      /**
-       * @category Attribute
-       * @param {CellBackground} [background] - Cell background color configuration
-       */
       background: {
         renderDOM({ background }) {
           if (!background) return {};
@@ -57081,10 +56935,6 @@ const TableCell = Node$1.create({
           return { style: style2 };
         }
       },
-      /**
-       * @category Attribute
-       * @param {string} [verticalAlign] - Vertical content alignment (top, middle, bottom)
-       */
       verticalAlign: {
         renderDOM({ verticalAlign }) {
           if (!verticalAlign) return {};
@@ -57092,10 +56942,6 @@ const TableCell = Node$1.create({
           return { style: style2 };
         }
       },
-      /**
-       * @category Attribute
-       * @param {CellMargins} [cellMargins] - Internal cell padding
-       */
       cellMargins: {
         renderDOM({ cellMargins }) {
           if (!cellMargins) return {};
@@ -57108,10 +56954,6 @@ const TableCell = Node$1.create({
           return { style: style2 };
         }
       },
-      /**
-       * @category Attribute
-       * @param {CellBorders} [borders] - Cell border configuration
-       */
       borders: {
         default: () => createCellBorders(),
         renderDOM({ borders }) {
@@ -57126,20 +56968,10 @@ const TableCell = Node$1.create({
           return { style: style2 };
         }
       },
-      /**
-       * @private
-       * @category Attribute
-       * @param {string} [widthType='auto'] - Internal width type
-       */
       widthType: {
         default: "auto",
         rendered: false
       },
-      /**
-       * @private
-       * @category Attribute
-       * @param {string} [widthUnit='px'] - Internal width unit
-       */
       widthUnit: {
         default: "px",
         rendered: false
@@ -59342,6 +59174,19 @@ const findPreviousDomNodeWithClass = (view, pos, className) => {
   }
   return null;
 };
+const getRotationMargins = (w2, h2, angleDegrees) => {
+  const rad = angleDegrees * (Math.PI / 180);
+  const cos = Math.abs(Math.cos(rad));
+  const sin = Math.abs(Math.sin(rad));
+  const boundingWidth = w2 * cos + h2 * sin;
+  const boundingHeight = w2 * sin + h2 * cos;
+  const marginLeftRight = Math.round(Math.max(0, (boundingWidth - w2) / 2));
+  const marginTopBottom = Math.round(Math.max(0, (boundingHeight - h2) / 2));
+  return {
+    horizontal: marginLeftRight,
+    vertical: marginTopBottom
+  };
+};
 const Image = Node$1.create({
   name: "image",
   group: "inline",
@@ -59363,10 +59208,6 @@ const Image = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {string} [src] - Image source URL or path
-       */
       src: {
         default: null,
         renderDOM: ({ src }) => {
@@ -59375,95 +59216,75 @@ const Image = Node$1.create({
           };
         }
       },
-      /**
-       * @category Attribute
-       * @param {string} [alt='Uploaded picture'] - Alternative text for accessibility
-       */
       alt: {
         default: "Uploaded picture"
       },
-      /**
-       * @category Attribute
-       * @param {string} [id] - Image element ID
-       * @private
-       */
       id: { rendered: false },
-      /**
-       * @category Attribute
-       * @param {string} [title] - Image title/tooltip text
-       */
       title: {
         default: null
       },
-      /**
-       * @category Attribute
-       * @param {string} [rId] - Relationship ID for Word export
-       * @private
-       */
       rId: {
         default: null,
         rendered: false
       },
-      /**
-       * @category Attribute
-       * @param {Object} [originalPadding] - Original padding values from Word import
-       * @private
-       */
       originalPadding: {
         default: null,
         rendered: false
       },
-      /**
-       * @category Attribute
-       * @param {Object} [originalAttributes] - Original attributes from Word import
-       * @private
-       */
       originalAttributes: { rendered: false },
-      /**
-       * @category Attribute
-       * @param {boolean} [wrapTopAndBottom] - Wrap text above and below image
-       * @private
-       */
       wrapTopAndBottom: { rendered: false },
-      /**
-       * @category Attribute
-       * @param {Object} [anchorData] - Anchor positioning data for Word
-       * @private
-       */
       anchorData: {
         default: null,
         rendered: false
       },
+      isAnchor: { rendered: false },
       /**
        * @category Attribute
-       * @param {boolean} [isAnchor] - Whether image is anchored
+       * @param {Object} [transformData] - Transform data for image (turn and flip)
+       * @param {number} [transformData.rotation] - Turn angle in degrees
+       * @param {boolean} [transformData.verticalFlip] - Whether to flip vertically
+       * @param {boolean} [transformData.horizontalFlip] - Whether to flip horizontally
+       * @param {Object} [transformData.sizeExtension] - Size extension for image due to transformation
+       * @param {number} [transformData.sizeExtension.left] - Left size extension for image
+       * @param {number} [transformData.sizeExtension.top] - Top size extension for image
+       * @param {number} [transformData.sizeExtension.right] - Right size extension for image
+       * @param {number} [transformData.sizeExtension.bottom] - Bottom size extension for image
+       *
        * @private
        */
-      isAnchor: { rendered: false },
+      transformData: {
+        default: {},
+        renderDOM: ({ transformData }) => {
+          let style2 = "";
+          if (transformData?.rotation) {
+            style2 += `rotate(${Math.round(transformData.rotation)}deg) `;
+          }
+          if (transformData?.verticalFlip) {
+            style2 += "scaleY(-1) ";
+          }
+          if (transformData?.horizontalFlip) {
+            style2 += "scaleX(-1) ";
+          }
+          style2 = style2.trim();
+          if (style2.length > 0) {
+            return { style: `transform: ${style2};` };
+          }
+          return;
+        }
+      },
       /**
        * @category Attribute
        * @param {boolean} [simplePos] - Simple positioning flag
        * @private
        */
       simplePos: { rendered: false },
-      /**
-       * @category Attribute
-       * @param {string} [wrapText] - Text wrapping style
-       * @private
-       */
       wrapText: { rendered: false },
       extension: { rendered: false },
-      /**
-       * @category Attribute
-       * @param {Object} [size] - Image dimensions
-       * @param {number} [size.width] - Width in pixels
-       * @param {number} [size.height] - Height in pixels
-       */
       size: {
         default: {},
         renderDOM: ({ size: size2, extension }) => {
           let style2 = "";
-          const { width, height } = size2 ?? {};
+          let { width, height } = size2 ?? {};
           if (width) style2 += `width: ${width}px;`;
           if (height && ["emf", "wmf"].includes(extension))
             style2 += `height: ${height}px; border: 1px solid black; position: absolute;`;
@@ -59471,51 +59292,58 @@ const Image = Node$1.create({
           return { style: style2 };
         }
       },
-      /**
-       * @category Attribute
-       * @param {Object} [padding] - Image padding/margins
-       * @param {number} [padding.left] - Left padding in pixels
-       * @param {number} [padding.top] - Top padding in pixels
-       * @param {number} [padding.bottom] - Bottom padding in pixels
-       * @param {number} [padding.right] - Right padding in pixels
-       */
       padding: {
         default: {},
-        renderDOM: ({ padding, marginOffset }) => {
-          const { left: left2 = 0, top: top2 = 0, bottom: bottom2 = 0, right: right2 = 0 } = padding ?? {};
+        renderDOM: ({ size: size2 = {}, padding, marginOffset, transformData }) => {
+          let { left: left2 = 0, top: top2 = 0, bottom: bottom2 = 0, right: right2 = 0 } = padding ?? {};
+          const { rotation } = transformData ?? {};
+          const { height, width } = size2 ?? {};
+          if (rotation && height && width) {
+            const { horizontal, vertical } = getRotationMargins(width, height, rotation);
+            left2 += horizontal;
+            right2 += horizontal;
+            top2 += vertical;
+            bottom2 += vertical;
+          }
           let style2 = "";
-          if (left2 && !marginOffset?.left) style2 += `margin-left: ${left2}px;`;
-          if (top2 && !marginOffset?.top) style2 += `margin-top: ${top2}px;`;
+          if (left2 && marginOffset?.left == null) style2 += `margin-left: ${left2}px;`;
+          if (top2 && marginOffset?.top == null) style2 += `margin-top: ${top2}px;`;
           if (bottom2) style2 += `margin-bottom: ${bottom2}px;`;
           if (right2) style2 += `margin-right: ${right2}px;`;
           return { style: style2 };
         }
       },
-      /**
-       * @category Attribute
-       * @param {Object} [marginOffset] - Margin offset for anchored images
-       * @param {number} [marginOffset.left] - Left margin offset
-       * @param {number} [marginOffset.top] - Top margin offset
-       */
       marginOffset: {
         default: {},
-        renderDOM: ({ marginOffset, anchorData }) => {
+        renderDOM: ({ marginOffset, anchorData, transformData, size: size2 }) => {
+          const hasAnchorData = Boolean(anchorData);
+          const hasMarginOffsets = marginOffset?.left != null || marginOffset?.top != null;
+          if (!hasAnchorData && !hasMarginOffsets) return {};
           const relativeFromPageV = anchorData?.vRelativeFrom === "page";
           const maxMarginV = 500;
-          const { left: left2 = 0, top: top2 = 0 } = marginOffset ?? {};
+          const baseLeft = marginOffset?.left ?? 0;
+          const baseTop = marginOffset?.top ?? 0;
+          let rotationLeft = 0;
+          let rotationTop = 0;
+          const { rotation } = transformData ?? {};
+          const { height, width } = size2 ?? {};
+          if (rotation && height && width) {
+            const { horizontal, vertical } = getRotationMargins(width, height, rotation);
+            rotationLeft = horizontal;
+            rotationTop = vertical;
+          }
+          const left2 = baseLeft + rotationLeft;
+          const top2 = baseTop + rotationTop;
           let style2 = "";
           if (left2) style2 += `margin-left: ${left2}px;`;
           if (top2) {
             if (relativeFromPageV && top2 >= maxMarginV) style2 += `margin-top: ${maxMarginV}px;`;
             else style2 += `margin-top: ${top2}px;`;
           }
+          if (!style2) return {};
           return { style: style2 };
         }
       },
-      /**
-       * @category Attribute
-       * @param {string} [style] - Custom inline CSS styles
-       */
       style: {
         default: null,
         rendered: true,
@@ -59541,18 +59369,10 @@ const Image = Node$1.create({
       /**
        * Insert an image at the current position
        * @category Command
-       * @param {Object} options - Image attributes
-       * @param {string} options.src - Image source URL or data URI
-       * @param {string} [options.alt] - Alternative text
-       * @param {string} [options.title] - Image title
-       * @param {Object} [options.size] - Image dimensions
-       * @returns {Function} Command function
+       * @param {ImageInsertOptions} options - Image insertion options
        * @example
-       * // Insert an image from a URL
-       * setImage({ src: 'https://example.com/image.jpg' })
-       *
-       * // Insert a base64 encoded image
-       * setImage({
+       * editor.commands.setImage({ src: 'https://example.com/image.jpg' })
+       * editor.commands.setImage({
        *   src: 'data:image/png;base64,...',
        *   alt: 'Company logo',
        *   size: { width: 200 }
@@ -59769,6 +59589,14 @@ const PageNumber = Node$1.create({
   },
   addCommands() {
     return {
+      /**
+       * Insert an automatic page number
+       * @category Command
+       * @returns {Function} Command function
+       * @example
+       * editor.commands.addAutoPageNumber()
+       * @note Only works in header/footer contexts
+       */
       addAutoPageNumber: () => ({ tr, dispatch, state: state2, editor }) => {
         const { options } = editor;
         if (!options.isHeaderOrFooter) return false;
@@ -59831,6 +59659,14 @@ const TotalPageCount = Node$1.create({
   },
   addCommands() {
     return {
+      /**
+       * Insert total page count
+       * @category Command
+       * @returns {Function} Command function
+       * @example
+       * editor.commands.addTotalPageCount()
+       * @note Only works in header/footer contexts
+       */
       addTotalPageCount: () => ({ tr, dispatch, state: state2, editor }) => {
         const { options } = editor;
         if (!options.isHeaderOrFooter) return false;
@@ -60097,11 +59933,6 @@ const ContentBlock = Node$1.create({
   inline: true,
   addOptions() {
     return {
-      /**
-       * @typedef {Object} ContentBlockOptions
-       * @category Options
-       * @property {Object} [htmlAttributes] - HTML attributes for the block element
-       */
       htmlAttributes: {
         contenteditable: false
       }
@@ -60109,10 +59940,6 @@ const ContentBlock = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {boolean} [horizontalRule=false] - Whether this block is a horizontal rule
-       */
       horizontalRule: {
         default: false,
         renderDOM: ({ horizontalRule }) => {
@@ -60120,10 +59947,6 @@ const ContentBlock = Node$1.create({
           return { "data-horizontal-rule": "true" };
         }
       },
-      /**
-       * @category Attribute
-       * @param {ContentBlockSize} [size] - Size and position of the content block
-       */
       size: {
         default: null,
         renderDOM: ({ size: size2 }) => {
@@ -60137,10 +59960,6 @@ const ContentBlock = Node$1.create({
           return { style: style2 };
         }
       },
-      /**
-       * @category Attribute
-       * @param {string} [background] - Background color for the block
-       */
       background: {
         default: null,
         renderDOM: (attrs) => {
@@ -60150,19 +59969,9 @@ const ContentBlock = Node$1.create({
           };
         }
       },
-      /**
-       * @private
-       * @category Attribute
-       * @param {Object} [drawingContent] - Internal drawing data
-       */
       drawingContent: {
         rendered: false
       },
-      /**
-       * @private
-       * @category Attribute
-       * @param {Object} [attributes] - Additional internal attributes
-       */
       attributes: {
         rendered: false
       }
@@ -60183,9 +59992,8 @@ const ContentBlock = Node$1.create({
       /**
        * Insert a horizontal rule
        * @category Command
-       * @returns {Function} Command function
        * @example
-       * insertHorizontalRule()
+       * editor.commands.insertHorizontalRule()
        * @note Creates a visual separator between content sections
        */
       insertHorizontalRule: () => ({ commands: commands2 }) => {
@@ -60202,13 +60010,13 @@ const ContentBlock = Node$1.create({
        * Insert a content block
        * @category Command
        * @param {ContentBlockConfig} config - Block configuration
-       * @returns {Function} Command function
        * @example
        * // Insert a spacer block
-       * insertContentBlock({ size: { height: 20 } })
+       * editor.commands.insertContentBlock({ size: { height: 20 } })
        *
+       * @example
        * // Insert a colored divider
-       * insertContentBlock({
+       * editor.commands.insertContentBlock({
        *   size: { width: '50%', height: 3 },
        *   background: '#3b82f6'
        * })
@@ -60736,16 +60544,7 @@ const DocumentSection = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {number} [id] - Unique section identifier
-       */
       id: {},
-      /**
-       * @private
-       * @category Attribute
-       * @param {string} [sdBlockId] - Internal block tracking
-       */
       sdBlockId: {
         default: null,
         keepOnSplit: false,
@@ -60754,25 +60553,9 @@ const DocumentSection = Node$1.create({
           return attrs.sdBlockId ? { "data-sd-block-id": attrs.sdBlockId } : {};
         }
       },
-      /**
-       * @category Attribute
-       * @param {string} [title] - Section display label
-       */
       title: {},
-      /**
-       * @category Attribute
-       * @param {string} [description] - Section metadata
-       */
       description: {},
-      /**
-       * @category Attribute
-       * @param {string} [sectionType] - Business classification (e.g., 'legal', 'pricing')
-       */
       sectionType: {},
-      /**
-       * @category Attribute
-       * @param {boolean} [isLocked=false] - Lock state preventing edits
-       */
       isLocked: { default: false }
     };
   },
@@ -60787,10 +60570,9 @@ const DocumentSection = Node$1.create({
        * Create a lockable content section
        * @category Command
        * @param {SectionCreate} [options={}] - Section configuration
-       * @returns {Function} Command - true if created, false if position invalid
        * @example
-       * createDocumentSection({
-       *   id: 'legal-1',
+       * editor.commands.createDocumentSection({
+       *   id: 1,
        *   title: 'Terms & Conditions',
        *   isLocked: true,
        *   html: '<p>Legal content...</p>'
@@ -60871,9 +60653,8 @@ const DocumentSection = Node$1.create({
       /**
        * Remove section wrapper at cursor, preserving its content
        * @category Command
-       * @returns {Function} Command - true if removed, false if no section at position
        * @example
-       * removeSectionAtSelection()
+       * editor.commands.removeSectionAtSelection()
        * @note Content stays in document, only section wrapper is removed
        */
       removeSectionAtSelection: () => ({ tr, dispatch }) => {
@@ -60899,9 +60680,8 @@ const DocumentSection = Node$1.create({
        * Delete section and all its content
        * @category Command
        * @param {number} id - Section to delete
-       * @returns {Function} Command - true if deleted, false if ID doesn't exist
        * @example
-       * removeSectionById(123)
+       * editor.commands.removeSectionById(123)
        */
       removeSectionById: (id) => ({ tr, dispatch }) => {
         const sections = SectionHelpers.getAllSections(this.editor);
@@ -60921,9 +60701,8 @@ const DocumentSection = Node$1.create({
        * Lock section against edits
        * @category Command
        * @param {number} id - Section to lock
-       * @returns {Function} Command - true if locked, false if ID doesn't exist
        * @example
-       * lockSectionById(123)
+       * editor.commands.lockSectionById(123)
        */
       lockSectionById: (id) => ({ tr, dispatch }) => {
         const sections = SectionHelpers.getAllSections(this.editor);
@@ -60940,16 +60719,10 @@ const DocumentSection = Node$1.create({
        * Modify section attributes or content
        * @category Command
        * @param {SectionUpdate} options - Changes to apply
-       * @returns {Function} Command - true if updated, false if ID doesn't exist
        * @example
-       * // Toggle lock
-       * updateSectionById({ id: 123, attrs: { isLocked: false } })
-       *
-       * // Replace content
-       * updateSectionById({ id: 123, html: '<p>New content</p>' })
-       *
-       * // Both
-       * updateSectionById({
+       * editor.commands.updateSectionById({ id: 123, attrs: { isLocked: false } })
+       * editor.commands.updateSectionById({ id: 123, html: '<p>New content</p>' })
+       * editor.commands.updateSectionById({
        *   id: 123,
        *   html: '<p>Updated</p>',
        *   attrs: { title: 'New Title' }
@@ -60999,11 +60772,10 @@ const BlockNode = Extension.create({
        * Replace a block node by its ID with new content
        * @category Command
        * @param {string} id - The sdBlockId of the node to replace
-       * @param {Object} contentNode - The replacement ProseMirror node
-       * @returns {Function} Command function
+       * @param {ProseMirrorNode} contentNode - The replacement ProseMirror node
        * @example
        * const newParagraph = editor.schema.nodes.paragraph.create({}, editor.schema.text('New content'))
-       * replaceBlockNodeById('block-123', newParagraph)
+       * editor.commands.replaceBlockNodeById('block-123', newParagraph)
        * @note The replacement node should have the same type as the original
        */
       replaceBlockNodeById: (id, contentNode) => ({ dispatch, tr }) => {
@@ -61026,9 +60798,8 @@ const BlockNode = Extension.create({
        * Delete a block node by its ID
        * @category Command
        * @param {string} id - The sdBlockId of the node to delete
-       * @returns {Function} Command function
        * @example
-       * deleteBlockNodeById('block-123')
+       * editor.commands.deleteBlockNodeById('block-123')
        * @note Completely removes the node from the document
        */
       deleteBlockNodeById: (id) => ({ dispatch, tr }) => {
@@ -61052,11 +60823,10 @@ const BlockNode = Extension.create({
        * @category Command
        * @param {string} id - The sdBlockId of the node to update
        * @param {Object} attrs - Attributes to update
-       * @returns {Function} Command function
        * @example
-       * updateBlockNodeAttributes('block-123', { textAlign: 'center' })
+       * editor.commands.updateBlockNodeAttributes('block-123', { textAlign: 'center' })
        * @example
-       * updateBlockNodeAttributes('block-123', { indent: { left: 20 } })
+       * editor.commands.updateBlockNodeAttributes('block-123', { indent: { left: 20 } })
        * @note Merges new attributes with existing ones
        */
       updateBlockNodeAttributes: (id, attrs = {}) => ({ dispatch, tr }) => {
@@ -61150,7 +60920,7 @@ const BlockNode = Extension.create({
         key: BlockNodePluginKey,
         appendTransaction: (transactions, _oldState, newState) => {
           if (hasInitialized && !transactions.some((tr2) => tr2.docChanged)) return null;
-          if (hasInitialized && !checkForNewBlockNodesInTrs(transactions)) return null;
+          if (hasInitialized && !checkForNewBlockNodesInTrs([...transactions])) return null;
           const { tr } = newState;
           let changed = false;
           newState.doc.descendants((node, pos) => {
@@ -61229,9 +60999,8 @@ const TextStyle = Mark2.create({
       /**
        * Remove empty text style marks
        * @category Command
-       * @returns {Function} Command function - Removes mark if no attributes present
        * @example
-       * removeEmptyTextStyle()
+       * editor.commands.removeEmptyTextStyle()
        * @note Cleanup utility to prevent empty span elements
        * @note Automatically checks if any style attributes exist before removal
        */
@@ -61253,10 +61022,6 @@ const Bold = Mark2.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {string} [value] - Bold weight value ('0' renders as normal)
-       */
       value: {
         default: null,
         renderDOM: (attrs) => {
@@ -61285,26 +61050,23 @@ const Bold = Mark2.create({
       /**
        * Apply bold formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * setBold()
+       * editor.commands.setBold()
        * @note '0' renders as normal weight
        */
       setBold: () => ({ commands: commands2 }) => commands2.setMark(this.name),
       /**
        * Remove bold formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * unsetBold()
+       * editor.commands.unsetBold()
        */
       unsetBold: () => ({ commands: commands2 }) => commands2.unsetMark(this.name),
       /**
        * Toggle bold formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * toggleBold()
+       * editor.commands.toggleBold()
        */
       toggleBold: () => ({ commands: commands2 }) => commands2.toggleMark(this.name)
     };
@@ -61339,25 +61101,22 @@ const Italic = Mark2.create({
       /**
        * Apply italic formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * setItalic()
+       * editor.commands.setItalic()
        */
       setItalic: () => ({ commands: commands2 }) => commands2.setMark(this.name),
       /**
        * Remove italic formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * unsetItalic()
+       * editor.commands.unsetItalic()
        */
       unsetItalic: () => ({ commands: commands2 }) => commands2.unsetMark(this.name),
       /**
        * Toggle italic formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * toggleItalic()
+       * editor.commands.toggleItalic()
        */
       toggleItalic: () => ({ commands: commands2 }) => commands2.toggleMark(this.name)
     };
@@ -61441,10 +61200,6 @@ const Highlight = Mark2.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {string} [color] - Background color (CSS color value)
-       */
       color: {
         default: null,
         parseDOM: (element) => element.getAttribute("data-color") || element.style.backgroundColor,
@@ -61472,26 +61227,23 @@ const Highlight = Mark2.create({
        * Apply highlight with specified color
        * @category Command
        * @param {string} color - CSS color value
-       * @returns {Function} Command
        * @example
-       * setHighlight('#FFEB3B')
-       * setHighlight('rgba(255, 235, 59, 0.5)')
+       * editor.commands.setHighlight('#FFEB3B')
+       * editor.commands.setHighlight('rgba(255, 235, 59, 0.5)')
        */
       setHighlight: (color) => ({ commands: commands2 }) => commands2.setMark(this.name, { color }),
       /**
        * Remove highlight formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * unsetHighlight()
+       * editor.commands.unsetHighlight()
        */
       unsetHighlight: () => ({ commands: commands2 }) => commands2.unsetMark(this.name),
       /**
        * Toggle highlight formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * toggleHighlight()
+       * editor.commands.toggleHighlight()
        */
       toggleHighlight: () => ({ commands: commands2 }) => commands2.toggleMark(this.name)
     };
@@ -61524,9 +61276,8 @@ const Strike = Mark2.create({
       /**
        * Apply strikethrough formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * setStrike()
+       * editor.commands.setStrike()
        */
       setStrike: () => ({ commands: commands2 }) => {
         return commands2.setMark(this.name);
@@ -61534,9 +61285,8 @@ const Strike = Mark2.create({
       /**
        * Remove strikethrough formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * unsetStrike()
+       * editor.commands.unsetStrike()
        */
       unsetStrike: () => ({ commands: commands2 }) => {
         return commands2.unsetMark(this.name);
@@ -61544,9 +61294,8 @@ const Strike = Mark2.create({
       /**
        * Toggle strikethrough formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * toggleStrike()
+       * editor.commands.toggleStrike()
        */
       toggleStrike: () => ({ commands: commands2 }) => {
         return commands2.toggleMark(this.name);
@@ -61566,11 +61315,6 @@ const Link = Mark2.create({
   inclusive: false,
   addOptions() {
     return {
-      /**
-       * Allowed URL protocols
-       * @type {string[]}
-       * @default ['http', 'https']
-       */
       protocols: ["http", "https"],
       htmlAttributes: {
         target: null,
@@ -61669,16 +61413,10 @@ const Link = Mark2.create({
       /**
        * Create or update a link
        * @category Command
-       * @param {Object} options - Link configuration
-       * @param {string} [options.href] - URL for the link
-       * @param {string} [options.text] - Display text (uses selection if omitted)
-       * @returns {Function} Command - Creates link with underline
+       * @param {SetLinkOptions} [options] - Link configuration
        * @example
-       * // Link selected text
-       * setLink({ href: 'https://example.com' })
-       *
-       * // Link with custom text
-       * setLink({
+       * editor.commands.setLink({ href: 'https://example.com' })
+       * editor.commands.setLink({
        *   href: 'https://example.com',
        *   text: 'Visit Example'
        * })
@@ -61730,9 +61468,8 @@ const Link = Mark2.create({
       /**
        * Remove link and associated formatting
        * @category Command
-       * @returns {Function} Command - Removes link, underline, and color
        * @example
-       * unsetLink()
+       * editor.commands.unsetLink()
        * @note Also removes underline and text color
        */
       unsetLink: () => ({ chain }) => {
@@ -61741,16 +61478,10 @@ const Link = Mark2.create({
       /**
        * Toggle link on selection
        * @category Command
-       * @param {Object} [options] - Link configuration
-       * @param {string} [options.href] - URL for the link
-       * @param {string} [options.text] - Display text
-       * @returns {Function} Command - Creates link if href provided, removes otherwise
+       * @param {SetLinkOptions} [options] - Link configuration
        * @example
-       * // Add link
-       * toggleLink({ href: 'https://example.com' })
-       *
-       * // Remove link
-       * toggleLink()
+       * editor.commands.toggleLink({ href: 'https://example.com' })
+       * editor.commands.toggleLink()
        */
       toggleLink: ({ href, text } = {}) => ({ commands: commands2 }) => {
         if (!href) return commands2.unsetLink();
@@ -65067,6 +64798,9 @@ const Mentions = /* @__PURE__ */ _export_sfc(_sfc_main$g, [["__scopeId", "data-v
 const popoverPluginKey = new PluginKey("popoverPlugin");
 const PopoverPlugin = Extension.create({
   name: "popoverPlugin",
+  addOptions() {
+    return {};
+  },
   addPmPlugins() {
     const popover = new Plugin({
       key: popoverPluginKey,
@@ -67294,12 +67028,11 @@ const Search = Extension.create({
   addCommands() {
     return {
       /**
-       * Navigates to the first search match
+       * Navigate to the first search match
        * @category Command
-       * @returns {Function} - Command function
        * @example
-       * goToFirstMatch()
-       * @note Scrolls Editor to the first match of called search().
+       * editor.commands.goToFirstMatch()
+       * @note Scrolls editor to the first match from previous search
        */
       goToFirstMatch: () => (
         /** @returns {boolean} */
@@ -67315,13 +67048,13 @@ const Search = Extension.create({
         })
       ),
       /**
-       * Searches for the string match in Editor content
+       * Search for string matches in editor content
        * @category Command
        * @param {String|RegExp} patternInput - Search string or pattern
-       * @returns {Function} - Command function that returns matches
        * @example
-       * search('test string')
-       * @note Searches for the test string in the Editor content and returns an array of matches
+       * const matches = editor.commands.search('test string')
+       * const regexMatches = editor.commands.search(/test/i)
+       * @note Returns array of SearchMatch objects with positions and IDs
        */
       search: (patternInput) => (
         /** @returns {SearchMatch[]} */
@@ -67364,14 +67097,13 @@ const Search = Extension.create({
         })
       ),
       /**
-       * Navigates to the selected match
+       * Navigate to a specific search match
        * @category Command
-       * @param {SearchMatch} match Match at specific index
-       * @returns {Function} - Command function
+       * @param {SearchMatch} match - Match object to navigate to
        * @example
-       * const searchResult = search('test string')
-       * goToSearchResult(searchResult[3])
-       * @note Scrolls Editor to the fourth match of called search() and sets selection on it.
+       * const searchResults = editor.commands.search('test string')
+       * editor.commands.goToSearchResult(searchResults[3])
+       * @note Scrolls to match and selects it
        */
       goToSearchResult: (match) => (
         /** @returns {boolean} */
@@ -67633,6 +67365,9 @@ const nodeResizer = (nodeNames = ["image"], editor) => {
 };
 const NodeResizer = Extension.create({
   name: "nodeResizer",
+  addOptions() {
+    return {};
+  },
   addPmPlugins() {
     const isHeadless = this.editor.options.isHeadless;
     const hasDocument = typeof document !== "undefined";