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

package/dist/chunks/{super-editor.es-BQ6kZTNg.cjs → super-editor.es-BkxUKZfn.cjs}

@@ -14859,6 +14859,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 = {
@@ -26872,6 +26880,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);
@@ -26928,6 +26962,7 @@ function handleImageNode(node, params2, isAnchor) {
       size: size2,
       anchorData,
       isAnchor,
+      transformData,
       ...simplePos && {
         simplePos: {
           x: simplePos.attributes.x,
@@ -27079,6 +27114,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 {
@@ -27093,12 +27153,7 @@ const translateImageNode = (params2) => {
       },
       {
         name: "wp:effectExtent",
-        attributes: {
-          l: 0,
-          t: 0,
-          r: 0,
-          b: 0
-        }
+        attributes: effectExtentAttrs
       },
       {
         name: "wp:docPr",
@@ -27178,6 +27233,7 @@ const translateImageNode = (params2) => {
                     elements: [
                       {
                         name: "a:xfrm",
+                        attributes: xfrmAttrs,
                         elements: [
                           {
                             name: "a:ext",
@@ -31380,8 +31436,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);
@@ -42339,12 +42395,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
     };
@@ -42363,9 +42413,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 }) => {
@@ -42379,9 +42428,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 }) => {
@@ -49300,6 +49348,7 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
       return result;
     } catch (error) {
       this.emit("exception", { error, editor: this });
+      console.error(error);
     }
   }
   /**
@@ -49323,6 +49372,7 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
       this.converter.footerEditors.length = 0;
     } catch (error) {
       this.emit("exception", { error, editor: this });
+      console.error(error);
     }
   }
   /**
@@ -49911,6 +49961,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() {
@@ -49937,11 +49988,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"]
     };
   },
@@ -49950,10 +49996,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, ""),
@@ -49972,16 +50014,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 }) => {
@@ -49990,9 +50033,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 }) => {
@@ -50005,11 +50047,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"]
     };
   },
@@ -50018,10 +50055,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, ""),
@@ -50040,13 +50073,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 }) => {
@@ -50055,9 +50088,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 }) => {
@@ -50070,12 +50102,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,
@@ -50090,10 +50116,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,
@@ -50115,16 +50137,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 }) => {
@@ -50146,9 +50162,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 }) => {
@@ -50198,13 +50213,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 }) => {
@@ -50215,9 +50226,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 }) => {
@@ -50358,13 +50368,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: ""
@@ -50376,10 +50379,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,
@@ -50405,16 +50404,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 }) => {
@@ -50424,9 +50417,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 }) => {
@@ -50454,9 +50446,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 }) => {
@@ -50465,9 +50456,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 }) => {
@@ -50476,9 +50466,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 }) => {
@@ -50487,13 +50476,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 }) => {
@@ -50906,6 +50890,9 @@ function drawGapCursor(state2) {
 }
 const Gapcursor = Extension.create({
   name: "gapCursor",
+  addOptions() {
+    return {};
+  },
   addPmPlugins() {
     return [gapCursor()];
   },
@@ -51246,6 +51233,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 [];
@@ -51383,11 +51373,6 @@ const Document = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @private
-       * @category Attribute
-       * @param {Object} [attributes] - Internal document attributes
-       */
       attributes: {
         rendered: false,
         "aria-label": "Document node"
@@ -51399,10 +51384,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 }) => {
@@ -51419,9 +51404,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 }) => {
@@ -51433,13 +51417,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" }];
   },
@@ -51465,14 +51455,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"
@@ -51490,27 +51472,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,
@@ -51519,11 +51487,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
@@ -51535,10 +51498,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) => {
@@ -51657,9 +51619,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) => {
@@ -51678,8 +51656,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);
@@ -51956,7 +51937,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 }) => {
@@ -52245,6 +52226,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)];
   },
@@ -52253,11 +52237,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
        */
@@ -52268,16 +52251,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
        */
@@ -52305,13 +52284,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) => {
@@ -53019,12 +52994,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: {}
     };
@@ -53256,11 +53225,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]
     };
   },
@@ -53270,10 +53234,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 }) => {
@@ -53285,13 +53247,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 }) => {
@@ -53696,6 +53654,9 @@ const LineBreak = Node$1.create({
   selectable: false,
   content: "",
   atom: true,
+  addOptions() {
+    return {};
+  },
   parseDOM() {
     return [{ tag: "br" }];
   },
@@ -53704,17 +53665,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 }
     };
   },
@@ -53723,9 +53674,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 }) => {
@@ -53742,11 +53692,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",
@@ -53757,35 +53702,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 }
     };
   },
@@ -53811,9 +53736,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 }) => {
@@ -56203,17 +56127,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: {
@@ -56371,14 +56284,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);
@@ -56391,9 +56299,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);
@@ -56401,9 +56308,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 }) => {
@@ -56780,10 +56686,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;
@@ -56909,24 +56814,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) => {
@@ -56963,10 +56856,6 @@ const TableRow = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {number} [rowHeight] - Fixed row height in pixels
-       */
       rowHeight: {
         renderDOM({ rowHeight }) {
           if (!rowHeight) return {};
@@ -56974,11 +56863,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() {
@@ -56990,44 +56874,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 }
@@ -57054,24 +56924,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) => {
@@ -57086,10 +56944,6 @@ const TableCell = Node$1.create({
           };
         }
       },
-      /**
-       * @category Attribute
-       * @param {CellBackground} [background] - Cell background color configuration
-       */
       background: {
         renderDOM({ background }) {
           if (!background) return {};
@@ -57098,10 +56952,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 {};
@@ -57109,10 +56959,6 @@ const TableCell = Node$1.create({
           return { style: style2 };
         }
       },
-      /**
-       * @category Attribute
-       * @param {CellMargins} [cellMargins] - Internal cell padding
-       */
       cellMargins: {
         renderDOM({ cellMargins }) {
           if (!cellMargins) return {};
@@ -57125,10 +56971,6 @@ const TableCell = Node$1.create({
           return { style: style2 };
         }
       },
-      /**
-       * @category Attribute
-       * @param {CellBorders} [borders] - Cell border configuration
-       */
       borders: {
         default: () => createCellBorders(),
         renderDOM({ borders }) {
@@ -57143,20 +56985,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
@@ -59359,6 +59191,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",
@@ -59380,10 +59225,6 @@ const Image = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {string} [src] - Image source URL or path
-       */
       src: {
         default: null,
         renderDOM: ({ src }) => {
@@ -59392,95 +59233,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;`;
@@ -59488,51 +59309,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,
@@ -59558,18 +59386,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 }
@@ -59786,6 +59606,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;
@@ -59848,6 +59676,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;
@@ -60114,11 +59950,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
       }
@@ -60126,10 +59957,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 }) => {
@@ -60137,10 +59964,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 }) => {
@@ -60154,10 +59977,6 @@ const ContentBlock = Node$1.create({
           return { style: style2 };
         }
       },
-      /**
-       * @category Attribute
-       * @param {string} [background] - Background color for the block
-       */
       background: {
         default: null,
         renderDOM: (attrs) => {
@@ -60167,19 +59986,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
       }
@@ -60200,9 +60009,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 }) => {
@@ -60219,13 +60027,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'
        * })
@@ -60753,16 +60561,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,
@@ -60771,25 +60570,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 }
     };
   },
@@ -60804,10 +60587,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>'
@@ -60888,9 +60670,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 }) => {
@@ -60916,9 +60697,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);
@@ -60938,9 +60718,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);
@@ -60957,16 +60736,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' }
@@ -61016,11 +60789,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 }) => {
@@ -61043,9 +60815,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 }) => {
@@ -61069,11 +60840,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 }) => {
@@ -61167,7 +60937,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) => {
@@ -61246,9 +61016,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
        */
@@ -61270,10 +61039,6 @@ const Bold = Mark2.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {string} [value] - Bold weight value ('0' renders as normal)
-       */
       value: {
         default: null,
         renderDOM: (attrs) => {
@@ -61302,26 +61067,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)
     };
@@ -61356,25 +61118,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)
     };
@@ -61458,10 +61217,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,
@@ -61489,26 +61244,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)
     };
@@ -61541,9 +61293,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);
@@ -61551,9 +61302,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);
@@ -61561,9 +61311,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);
@@ -61583,11 +61332,6 @@ const Link = Mark2.create({
   inclusive: false,
   addOptions() {
     return {
-      /**
-       * Allowed URL protocols
-       * @type {string[]}
-       * @default ['http', 'https']
-       */
       protocols: ["http", "https"],
       htmlAttributes: {
         target: null,
@@ -61686,16 +61430,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'
        * })
@@ -61747,9 +61485,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 }) => {
@@ -61758,16 +61495,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();
@@ -65084,6 +64815,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,
@@ -67311,12 +67045,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} */
@@ -67332,13 +67065,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[]} */
@@ -67381,14 +67114,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} */
@@ -67650,6 +67382,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";