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

package/dist/superdoc.umd.js

@@ -22584,6 +22584,14 @@
     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 = {
@@ -34597,6 +34605,32 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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);
@@ -34653,6 +34687,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         size: size2,
         anchorData,
         isAnchor,
+        transformData,
         ...simplePos && {
           simplePos: {
             x: simplePos.attributes.x,
@@ -34804,6 +34839,31 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       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 {
@@ -34818,12 +34878,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         },
         {
           name: "wp:effectExtent",
-          attributes: {
-            l: 0,
-            t: 0,
-            r: 0,
-            b: 0
-          }
+          attributes: effectExtentAttrs
         },
         {
           name: "wp:docPr",
@@ -34903,6 +34958,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
                       elements: [
                         {
                           name: "a:xfrm",
+                          attributes: xfrmAttrs,
                           elements: [
                             {
                               name: "a:ext",
@@ -39078,8 +39134,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   }
   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);
@@ -50037,12 +50093,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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
       };
@@ -50061,9 +50111,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -50077,9 +50126,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -56998,6 +57046,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         return result;
       } catch (error) {
         this.emit("exception", { error, editor: this });
+        console.error(error);
       }
     }
     /**
@@ -57021,6 +57070,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         this.converter.footerEditors.length = 0;
       } catch (error) {
         this.emit("exception", { error, editor: this });
+        console.error(error);
       }
     }
     /**
@@ -57609,6 +57659,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       if (this.options.ydoc) this.options.ydoc.destroy();
     } catch (error) {
       this.emit("exception", { error, editor: this });
+      console.error(error);
     }
   };
   validateDocumentInit_fn = function() {
@@ -57635,11 +57686,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     name: "color",
     addOptions() {
       return {
-        /**
-         * @typedef {Object} ColorOptions
-         * @category Options
-         * @property {string[]} [types=['textStyle']] - Mark types to add color support to
-         */
         types: ["textStyle"]
       };
     },
@@ -57648,10 +57694,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         {
           types: this.options.types,
           attributes: {
-            /**
-             * @category Attribute
-             * @param {ColorValue} [color] - Text color value
-             */
             color: {
               default: null,
               parseDOM: (el) => el.style.color?.replace(/['"]+/g, ""),
@@ -57670,16 +57712,17 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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 }) => {
@@ -57688,9 +57731,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * Remove text color
          * @category Command
-         * @returns {Function} Command function
          * @example
-         * unsetColor()
+         * editor.commands.unsetColor()
          * @note Removes color while preserving other text styles
          */
         unsetColor: () => ({ chain }) => {
@@ -57703,11 +57745,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     name: "fontFamily",
     addOptions() {
       return {
-        /**
-         * @typedef {Object} FontFamilyOptions
-         * @category Options
-         * @property {string[]} [types=['textStyle']] - Mark types to add font family support to
-         */
         types: ["textStyle"]
       };
     },
@@ -57716,10 +57753,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         {
           types: this.options.types,
           attributes: {
-            /**
-             * @category Attribute
-             * @param {FontFamilyValue} [fontFamily] - Font family for text
-             */
             fontFamily: {
               default: null,
               parseDOM: (el) => el.style.fontFamily?.replace(/['"]+/g, ""),
@@ -57738,13 +57771,13 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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 }) => {
@@ -57753,9 +57786,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * Remove font family
          * @category Command
-         * @returns {Function} Command function
          * @example
-         * unsetFontFamily()
+         * editor.commands.unsetFontFamily()
          * @note Reverts to default document font
          */
         unsetFontFamily: () => ({ chain }) => {
@@ -57768,12 +57800,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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,
@@ -57788,10 +57814,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         {
           types: this.options.types,
           attributes: {
-            /**
-             * @category Attribute
-             * @param {FontSizeValue} [fontSize] - Font size with unit
-             */
             fontSize: {
               default: null,
               parseDOM: (el) => el.style.fontSize,
@@ -57813,16 +57835,10 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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 }) => {
@@ -57844,9 +57860,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * Remove font size
          * @category Command
-         * @returns {Function} Command function
          * @example
-         * unsetFontSize()
+         * editor.commands.unsetFontSize()
          * @note Reverts to default document size
          */
         unsetFontSize: () => ({ chain }) => {
@@ -57896,13 +57911,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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 }) => {
@@ -57913,9 +57924,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -58056,13 +58066,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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: ""
@@ -58074,10 +58077,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         {
           types: this.options.types,
           attributes: {
-            /**
-             * @category Attribute
-             * @param {LineHeightValue} [lineHeight] - Line height value
-             */
             lineHeight: {
               default: null,
               parseDOM: (el) => el.style.lineHeight,
@@ -58103,16 +58102,10 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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 }) => {
@@ -58122,9 +58115,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * Remove line height
          * @category Command
-         * @returns {Function} Command function
          * @example
-         * unsetLineHeight()
+         * editor.commands.unsetLineHeight()
          * @note Reverts to default line spacing
          */
         unsetLineHeight: () => ({ commands: commands2 }) => {
@@ -58152,9 +58144,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -58163,9 +58154,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -58174,9 +58164,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -58185,13 +58174,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -58604,6 +58588,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   }
   const Gapcursor = Extension.create({
     name: "gapCursor",
+    addOptions() {
+      return {};
+    },
     addPmPlugins() {
       return [gapCursor()];
     },
@@ -58944,6 +58931,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   const SlashMenuPluginKey = new PluginKey("slashMenu");
   const SlashMenu = Extension.create({
     name: "slashMenu",
+    addOptions() {
+      return {};
+    },
     addPmPlugins() {
       if (this.editor.options?.disableContextMenu) {
         return [];
@@ -59081,11 +59071,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     addAttributes() {
       return {
-        /**
-         * @private
-         * @category Attribute
-         * @param {Object} [attributes] - Internal document attributes
-         */
         attributes: {
           rendered: false,
           "aria-label": "Document node"
@@ -59097,10 +59082,10 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -59117,9 +59102,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -59131,13 +59115,19 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   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" }];
     },
@@ -59163,14 +59153,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     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"
@@ -59188,27 +59170,13 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     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,
@@ -59217,11 +59185,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             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
@@ -59233,10 +59196,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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) => {
@@ -59355,9 +59317,25 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     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) => {
@@ -59376,8 +59354,11 @@ Please report this to https://github.com/markedjs/marked.`, e) {
           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);
@@ -59654,7 +59635,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * @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 }) => {
@@ -59943,6 +59924,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     name: "linkedStyles",
     priority: 1,
     // We need this plugin to run before the list plugins
+    addOptions() {
+      return {};
+    },
     addPmPlugins() {
       return [createLinkedStylesPlugin(this.editor)];
     },
@@ -59951,11 +59935,10 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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
          */
@@ -59966,16 +59949,12 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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
          */
@@ -60003,13 +59982,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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) => {
@@ -60717,12 +60692,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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: {}
       };
@@ -60954,11 +60923,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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]
       };
     },
@@ -60968,10 +60932,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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 }) => {
@@ -60983,13 +60945,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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 }) => {
@@ -61394,6 +61352,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     selectable: false,
     content: "",
     atom: true,
+    addOptions() {
+      return {};
+    },
     parseDOM() {
       return [{ tag: "br" }];
     },
@@ -61402,17 +61363,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     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 }
       };
     },
@@ -61421,9 +61372,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -61440,11 +61390,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     atom: true,
     addOptions() {
       return {
-        /**
-         * @typedef {Object} HardBreakOptions
-         * @category Options
-         * @property {Object} [htmlAttributes] - HTML attributes for the break element
-         */
         htmlAttributes: {
           contentEditable: "false",
           lineBreakType: "page",
@@ -61455,35 +61400,15 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     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 }
       };
     },
@@ -61509,9 +61434,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -63901,17 +63825,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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: {
@@ -64069,14 +63982,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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);
@@ -64089,9 +63997,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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);
@@ -64099,9 +64006,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -64478,10 +64384,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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;
@@ -64607,24 +64512,12 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     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) => {
@@ -64661,10 +64554,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     addAttributes() {
       return {
-        /**
-         * @category Attribute
-         * @param {number} [rowHeight] - Fixed row height in pixels
-         */
         rowHeight: {
           renderDOM({ rowHeight }) {
             if (!rowHeight) return {};
@@ -64672,11 +64561,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             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() {
@@ -64688,44 +64572,30 @@ Please report this to https://github.com/markedjs/marked.`, e) {
           }
         },
         /**
-         * @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 }
@@ -64752,24 +64622,12 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     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) => {
@@ -64784,10 +64642,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             };
           }
         },
-        /**
-         * @category Attribute
-         * @param {CellBackground} [background] - Cell background color configuration
-         */
         background: {
           renderDOM({ background }) {
             if (!background) return {};
@@ -64796,10 +64650,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             return { style: style2 };
           }
         },
-        /**
-         * @category Attribute
-         * @param {string} [verticalAlign] - Vertical content alignment (top, middle, bottom)
-         */
         verticalAlign: {
           renderDOM({ verticalAlign }) {
             if (!verticalAlign) return {};
@@ -64807,10 +64657,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             return { style: style2 };
           }
         },
-        /**
-         * @category Attribute
-         * @param {CellMargins} [cellMargins] - Internal cell padding
-         */
         cellMargins: {
           renderDOM({ cellMargins }) {
             if (!cellMargins) return {};
@@ -64823,10 +64669,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             return { style: style2 };
           }
         },
-        /**
-         * @category Attribute
-         * @param {CellBorders} [borders] - Cell border configuration
-         */
         borders: {
           default: () => createCellBorders(),
           renderDOM({ borders }) {
@@ -64841,20 +64683,10 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             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
@@ -67057,6 +66889,19 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     }
     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",
@@ -67078,10 +66923,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     addAttributes() {
       return {
-        /**
-         * @category Attribute
-         * @param {string} [src] - Image source URL or path
-         */
         src: {
           default: null,
           renderDOM: ({ src }) => {
@@ -67090,95 +66931,75 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             };
           }
         },
-        /**
-         * @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;`;
@@ -67186,51 +67007,58 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             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,
@@ -67256,18 +67084,10 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }
@@ -67484,6 +67304,14 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     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;
@@ -67546,6 +67374,14 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     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;
@@ -67812,11 +67648,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     inline: true,
     addOptions() {
       return {
-        /**
-         * @typedef {Object} ContentBlockOptions
-         * @category Options
-         * @property {Object} [htmlAttributes] - HTML attributes for the block element
-         */
         htmlAttributes: {
           contenteditable: false
         }
@@ -67824,10 +67655,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     addAttributes() {
       return {
-        /**
-         * @category Attribute
-         * @param {boolean} [horizontalRule=false] - Whether this block is a horizontal rule
-         */
         horizontalRule: {
           default: false,
           renderDOM: ({ horizontalRule }) => {
@@ -67835,10 +67662,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             return { "data-horizontal-rule": "true" };
           }
         },
-        /**
-         * @category Attribute
-         * @param {ContentBlockSize} [size] - Size and position of the content block
-         */
         size: {
           default: null,
           renderDOM: ({ size: size2 }) => {
@@ -67852,10 +67675,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             return { style: style2 };
           }
         },
-        /**
-         * @category Attribute
-         * @param {string} [background] - Background color for the block
-         */
         background: {
           default: null,
           renderDOM: (attrs) => {
@@ -67865,19 +67684,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             };
           }
         },
-        /**
-         * @private
-         * @category Attribute
-         * @param {Object} [drawingContent] - Internal drawing data
-         */
         drawingContent: {
           rendered: false
         },
-        /**
-         * @private
-         * @category Attribute
-         * @param {Object} [attributes] - Additional internal attributes
-         */
         attributes: {
           rendered: false
         }
@@ -67898,9 +67707,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -67917,13 +67725,13 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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'
          * })
@@ -68451,16 +68259,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     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,
@@ -68469,25 +68268,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
             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 }
       };
     },
@@ -68502,10 +68285,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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>'
@@ -68586,9 +68368,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -68614,9 +68395,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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);
@@ -68636,9 +68416,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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);
@@ -68655,16 +68434,10 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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' }
@@ -68714,11 +68487,10 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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 }) => {
@@ -68741,9 +68513,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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 }) => {
@@ -68767,11 +68538,10 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * @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 }) => {
@@ -68865,7 +68635,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
           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) => {
@@ -68944,9 +68714,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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
          */
@@ -68968,10 +68737,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     addAttributes() {
       return {
-        /**
-         * @category Attribute
-         * @param {string} [value] - Bold weight value ('0' renders as normal)
-         */
         value: {
           default: null,
           renderDOM: (attrs) => {
@@ -69000,26 +68765,23 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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)
       };
@@ -69054,25 +68816,22 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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)
       };
@@ -69156,10 +68915,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     },
     addAttributes() {
       return {
-        /**
-         * @category Attribute
-         * @param {string} [color] - Background color (CSS color value)
-         */
         color: {
           default: null,
           parseDOM: (element) => element.getAttribute("data-color") || element.style.backgroundColor,
@@ -69187,26 +68942,23 @@ Please report this to https://github.com/markedjs/marked.`, e) {
          * 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)
       };
@@ -69239,9 +68991,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * Apply strikethrough formatting
          * @category Command
-         * @returns {Function} Command
          * @example
-         * setStrike()
+         * editor.commands.setStrike()
          */
         setStrike: () => ({ commands: commands2 }) => {
           return commands2.setMark(this.name);
@@ -69249,9 +69000,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * Remove strikethrough formatting
          * @category Command
-         * @returns {Function} Command
          * @example
-         * unsetStrike()
+         * editor.commands.unsetStrike()
          */
         unsetStrike: () => ({ commands: commands2 }) => {
           return commands2.unsetMark(this.name);
@@ -69259,9 +69009,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * Toggle strikethrough formatting
          * @category Command
-         * @returns {Function} Command
          * @example
-         * toggleStrike()
+         * editor.commands.toggleStrike()
          */
         toggleStrike: () => ({ commands: commands2 }) => {
           return commands2.toggleMark(this.name);
@@ -69281,11 +69030,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     inclusive: false,
     addOptions() {
       return {
-        /**
-         * Allowed URL protocols
-         * @type {string[]}
-         * @default ['http', 'https']
-         */
         protocols: ["http", "https"],
         htmlAttributes: {
           target: null,
@@ -69384,16 +69128,10 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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'
          * })
@@ -69445,9 +69183,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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 }) => {
@@ -69456,16 +69193,10 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         /**
          * 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();
@@ -72782,6 +72513,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   const popoverPluginKey = new PluginKey("popoverPlugin");
   const PopoverPlugin = Extension.create({
     name: "popoverPlugin",
+    addOptions() {
+      return {};
+    },
     addPmPlugins() {
       const popover = new Plugin({
         key: popoverPluginKey,
@@ -75009,12 +74743,11 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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} */
@@ -75030,13 +74763,13 @@ Please report this to https://github.com/markedjs/marked.`, e) {
           })
         ),
         /**
-         * 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[]} */
@@ -75079,14 +74812,13 @@ Please report this to https://github.com/markedjs/marked.`, e) {
           })
         ),
         /**
-         * 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} */
@@ -75348,6 +75080,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   };
   const NodeResizer = Extension.create({
     name: "nodeResizer",
+    addOptions() {
+      return {};
+    },
     addPmPlugins() {
       const isHeadless = this.editor.options.isHeadless;
       const hasDocument = typeof document !== "undefined";